Implement Handlebars tokenizer

This should produce the exact same tokens for any template as the Handlebars JS implementation.

Author: theodorejb

.gitattributes

@@ -0,0 +1,2 @@
+/.github/     export-ignore
+/test/        export-ignore

.github/workflows/php.yml

@@ -0,0 +1,36 @@
+name: PHP Composer
+on: [push, pull_request]
+jobs:
+  build:
+    name: Run tests on ${{ matrix.php }}
+    runs-on: ubuntu-latest
+
+    strategy:
+      matrix:
+        php: [ '8.2', '8.3', '8.4' ]
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      # Docs: https://github.com/shivammathur/setup-php
+      - name: Setup PHP
+        uses: shivammathur/setup-php@v2
+        with:
+          php-version: ${{ matrix.php }}
+
+      - name: Setup problem matchers for PHPUnit
+        run: echo "::add-matcher::${{ runner.tool_cache }}/phpunit.json"
+
+      - name: Validate composer.json and composer.lock
+        run: composer validate --strict
+
+      - name: Install Composer dependencies
+        run: composer install --no-progress
+
+      - name: Run PHPUnit
+        run: composer test
+
+      - name: Perform static analysis
+        run: composer analyze -- --error-format=github
+        if: ${{ matrix.php == '8.4' }}

.gitignore

@@ -0,0 +1,4 @@
+.idea/
+.phpunit.result.cache
+.php-cs-fixer.cache
+vendor/

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Theodore Brown
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

README.md

@@ -0,0 +1,15 @@
+# handlebars.php
+
+Parse and render [Handlebars](https://handlebarsjs.com) templates with PHP.
+
+## Installation
+
+`composer require devtheorem/handlebars.php`
+
+## Usage
+
+Todo
+
+## Author
+
+Theodore Brown

composer.json

@@ -0,0 +1,37 @@
+{
+    "name": "devtheorem/handlebars.php",
+    "description": "Minimal templating on steroids.",
+    "type": "library",
+    "license": "MIT",
+    "authors": [
+        {
+            "name": "Theodore Brown",
+            "email": "theodorejb@outlook.com"
+        }
+    ],
+    "require": {
+        "php": ">=8.2"
+    },
+    "require-dev": {
+        "jbboehr/handlebars-spec": "dev-master",
+        "phpstan/phpstan": "^2.1",
+        "phpunit/phpunit": "^11.5"
+    },
+    "autoload": {
+        "psr-4": {
+            "DevTheorem\\Handlebars\\": "src/"
+        }
+    },
+    "autoload-dev": {
+        "psr-4": {
+            "DevTheorem\\Handlebars\\Test\\": "test/"
+        }
+    },
+    "scripts": {
+        "analyze": "phpstan analyze src --level 10",
+        "test": "vendor/bin/phpunit test"
+    },
+    "config": {
+        "sort-packages": true
+    }
+}