Merge the nice work from Alexander Guz back into master

.git-blame-ignore-revs

@@ -0,0 +1,5 @@
+# https://docs.github.com/en/repositories/working-with-files/using-files/viewing-a-file#ignore-commits-in-the-blame-view
+# https://git-scm.com/docs/git-blame#Documentation/git-blame.txt---ignore-revs-fileltfilegt
+
+72c7e3f4e34d2ed474b1399f2a7ab427fb6f3b14
+d837112369c0193def1c27636da1b9a8df5c98f3

.gitattributes

@@ -0,0 +1,8 @@
+/.gitattributes       export-ignore
+/.github              export-ignore
+/.gitignore           export-ignore
+/.php_cs.dist         export-ignore
+/.infection.json.dist export-ignore
+/.phpunit.xml.dist    export-ignore
+/examples             export-ignore
+/tests                export-ignore

.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,5 @@
+- [ ] I've run the tests with `vendor/bin/phpunit`
+- [ ] None of the tests were found failing
+- [ ] I've seen the coverage report at `build/coverage/index.html`
+- [ ] Not a single line left uncovered by tests
+- [ ] Any coding standards issues were fixed with `vendor/bin/php-cs-fixer fix`

.github/dependabot.yml

@@ -0,0 +1,16 @@
+# To get started with Dependabot version updates, you'll need to specify which
+# package ecosystems to update and where the package manifests are located.
+# Please see the documentation for all configuration options:
+# https://docs.github.com/code-security/dependabot/dependabot-version-updates/configuration-options-for-the-dependabot.yml-file
+
+version: 2
+updates:
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    schedule:
+      interval: "monthly"
+
+  - package-ecosystem: "composer"
+    directory: "/"
+    schedule:
+      interval: "monthly"

.github/workflows/cs.yaml

@@ -0,0 +1,47 @@
+name: Code Style
+
+on:
+  push:
+    branches: [ master ]
+  pull_request:
+    branches: [ master ]
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+
+    strategy:
+      matrix:
+        php-version:
+          - '8.3'
+
+    name: PHP ${{ matrix.php-version }}
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Setup PHP
+        uses: shivammathur/setup-php@v2
+        with:
+          php-version: ${{ matrix.php-version }}
+          extensions:
+          coverage: pcov
+          tools: composer:v2
+
+      - name: Cache dependencies
+        uses: actions/cache@v4
+        with:
+          path: ~/.cache/composer
+          key: composer-${{ matrix.php-version }}-${{ hashFiles('**/composer.*') }}
+          restore-keys: |
+            composer-${{ matrix.php-version }}-
+            composer-
+
+      - name: Install dependencies
+        run: |
+          composer update --prefer-dist --no-interaction --no-progress ${{ matrix.dependencies }}
+
+      - name: Check code style
+        run: |
+          php vendor/bin/php-cs-fixer --using-cache=no --diff --dry-run --stop-on-violation --verbose fix
+

.github/workflows/mt.yaml

@@ -0,0 +1,50 @@
+name: Mutation Testing
+
+on:
+  push:
+    branches: [ master ]
+  pull_request:
+    branches: [ master ]
+
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+
+    strategy:
+      matrix:
+        php-version:
+          - '8.4'
+        dependencies: ['']
+
+    name: PHP ${{ matrix.php-version }} ${{ matrix.dependencies }}
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Setup PHP
+        uses: shivammathur/setup-php@v2
+        with:
+          php-version: ${{ matrix.php-version }}
+          extensions:
+          coverage: pcov
+          tools: composer:v2
+
+      - name: Cache dependencies
+        uses: actions/cache@v4
+        with:
+          path: ~/.cache/composer
+          key: composer-${{ matrix.php-version }}-${{ hashFiles('**/composer.*') }}
+          restore-keys: |
+            composer-${{ matrix.php-version }}-
+            composer-
+
+      - name: Install dependencies
+        run: |
+          composer update --prefer-dist --no-interaction --no-progress ${{ matrix.dependencies }}
+          composer dump-autoload --optimize
+
+      - name: Run mutation testing
+        run: |
+          php vendor/bin/infection --min-msi=80 --min-covered-msi=80 --threads=$(nproc) --no-progress
+

.github/workflows/tests.yaml

@@ -0,0 +1,61 @@
+# yamllint disable rule:line-length
+# yamllint disable rule:braces
+
+name: CI
+
+on:
+  pull_request:
+  push:
+    branches:
+      - master
+      - main
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+
+    strategy:
+      matrix:
+        php-version:
+          - '8.2'
+          - '8.3'
+          - '8.4'
+        include:
+          - { php-version: '8.2', dependencies: '--prefer-lowest', legend: 'with lowest dependencies' }
+
+    name: PHP ${{ matrix.php-version }} ${{ matrix.legend }}
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Setup PHP
+        uses: shivammathur/setup-php@v2
+        with:
+          php-version: ${{ matrix.php-version }}
+          coverage: pcov
+          tools: composer:v2
+
+      - name: Get composer cache directory
+        id: composer-cache
+        run: echo "::set-output name=dir::$(composer config cache-files-dir)"
+
+      - name: Cache dependencies
+        uses: actions/cache@v4
+        with:
+          path: ${{ steps.composer-cache.outputs.dir }}
+          key: composer-${{ runner.os }}-${{ matrix.php-version }}-${{ hashFiles('composer.*') }}-${{ matrix.composer-flags }}
+          restore-keys: |
+            composer-${{ runner.os }}-${{ matrix.php-version }}-${{ hashFiles('composer.*') }}-
+            composer-${{ runner.os }}-${{ matrix.php-version }}-
+            composer-${{ runner.os }}-
+            composer-
+
+      - name: Install dependencies
+        run: |
+          composer update --prefer-dist --no-interaction --no-progress ${{ matrix.dependencies }}
+          composer dump-autoload --optimize
+
+      - name: Run tests
+        run: |
+          php vendor/bin/phpunit --migrate-configuration || true
+          php vendor/bin/phpunit

.gitignore

@@ -1,3 +1,3 @@
-.idea/
+.?*
 vendor/
 composer.lock

.php-cs-fixer.dist.php

@@ -0,0 +1,62 @@
+<?php
+
+/*
+ * This file is part of the Liquid package.
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ *
+ * @package Liquid
+ */
+
+$header = <<<'EOF'
+This file is part of the Liquid package.
+
+For the full copyright and license information, please view the LICENSE
+file that was distributed with this source code.
+
+@package Liquid
+EOF;
+
+$config = new PhpCsFixer\Config();
+$config
+	->setParallelConfig(PhpCsFixer\Runner\Parallel\ParallelConfigFactory::detect())
+	->setRiskyAllowed(true)
+	->setRules([
+		'@PSR2' => true,
+		'psr_autoloading' => true,
+		'no_unreachable_default_argument_value' => true,
+		'no_useless_else' => true,
+		'no_useless_return' => true,
+		'phpdoc_add_missing_param_annotation' => true,
+		'phpdoc_order' => true,
+		'semicolon_after_instruction' => true,
+		'whitespace_after_comma_in_array' => true,
+		'header_comment' => ['header' => $header],
+		'php_unit_construct' => true,
+		'php_unit_dedicate_assert' => true,
+		'php_unit_dedicate_assert_internal_type' => true,
+		'php_unit_expectation' => true,
+		'php_unit_mock_short_will_return' => true,
+		'php_unit_mock' => true,
+		'php_unit_namespaced' => true,
+		'php_unit_no_expectation_annotation' => true,
+		"phpdoc_order_by_value" => ['annotations' => ['covers']],
+		'php_unit_set_up_tear_down_visibility' => true,
+		'php_unit_test_case_static_method_calls' => ['call_type' => 'this'],
+		'no_whitespace_in_blank_line' => true,
+		'nullable_type_declaration_for_default_null_value' => true,
+		'array_syntax' => ['syntax' => 'short'],
+		'trailing_comma_in_multiline' => ['elements' => ['arrays']],
+		'binary_operator_spaces' => ['default' => 'at_least_single_space'],
+	])
+	->setIndent("\t")
+	->setFinder(
+		PhpCsFixer\Finder::create()
+		->in(__DIR__)
+		->append([__FILE__])
+	)
+;
+
+
+return $config;