What's Changed

• Minimum PHP version is now 8.2.0
• Added support for Laravel 12
• Dropped support for Laravel 9
• Updated dev dependencies

• Improves parsing of component attribute echo values

• Adds license to composer.json - thanks @vintagesucks !

Contributors

• @vintagesucks

• Restores support for PHP 8.1

This release adds a few new helper methods:

• toDocument() on DocumentParser simplifies the process of converting an existing DocumentParser to a Document instance
  • toDocument will resolve structures on the document by default. To prevent this, simply supply false when calling (i.e., toDocument(false))
• parseTemplate on DocumentParser parses the input like the existing parse method, but will return the DocumentParser instance instead of a node array

New AttributeCompiler

The AttributeCompiler is a new compiler service that can be used to compile attributes/parameters on a parsed ComponentNode. The AttributeCompiler implementation will use the core Laravel compiler for content that contains interpolated values.

Usage:

<?php
use Stillat\BladeParser\Parser\DocumentParser;
use Stillat\BladeParser\Compiler\CompilerServices\AttributeCompiler;
$template = <<<'TEMPLATE'
<prefix:component
 parameter="content"
 :binding="$theVariable"
/>
TEMPLATE;
$params = (new DocumentParser)
 ->onlyParseComponents()
 ->registerCustomComponentTags(['prefix'])
 ->parseTemplate($template)
 ->toDocument()
 ->getComponents()
 ->first()
 ->parameters;
$compiler = new AttributeCompiler;
$result = $compiler->compile($params);

After compilation, $result would contain the following:

['parameter'=>'content','binding'=>$theVariable]

• Bumps the minimum PHP version to 8.2
• Migrates the test suite to Pest
• Code cleanup/formatting 🧹
• Improves parsing of HTML fragments and attributes/parameters

• Adds new helper methods to determine the type of an EchoNode
  • EchoNode::isRaw(), EchoNode::isTriple(), and EchoNode::isRegular()

• Improves validation of @parent directive. Thanks @ernix 🥳

Contributors

• @ernix

• Corrects an issue with directory cleanup #29 (thanks @ernix !)

Contributors

• @ernix

• Updates dependencies to allow Laravel 11
• Refactors some tests