progress

Author: theodorejb

CHANGELOG.md

@@ -3,17 +3,72 @@ All notable changes to this project will be documented in this file.
 
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 
-## [1.0.0] AST Compiler - 2026-03-16
+## [1.0.0] AST Compiler - 2026-03-20
+
+
+### Added
+- Support for nested inline partials.
+- Lambda support for data variables and helper arguments.
+- `helperMissing` and `blockHelperMissing` hooks: handle calls to unknown helpers with the same API as in Handlebars.js, replacing the old `helperResolver` option.
+- `assumeObjects` compile option.
+- `knownHelpers` compile option (optimizes known helper execution, and allows disabling individual built-in helpers).
+- Support for deprecated `{{person/firstname}}` path expressions (please don't use in new code, though).
+
+### Changed
+- Replaced `helperResolver` option with `helperMissing` and `blockHelperMissing` hooks (the same API as in Handlebars.js).
+- Exceptions thrown by custom helpers are no longer caught and re-thrown, so the original exception can now be caught in your own code for easier debugging (https://github.com/devtheorem/php-handlebars/issues/13).
+- Updated various error messages to align with those output by Handlebars.js.
+
+### Removed
+- `helpers` compile option. All helpers must now be passed at runtime when executing the template (just like in Handlebars.js). This can significantly reduce compile time, since PHP files no longer have to be read and tokenized to extract helper functions. It also enables sharing helper closures across multiple templates, and removes limitations on what they can access and do.
+- Internal `Context` argument that was previously passed to the `partialResolver` closure. Now only the partial name is passed.
+
+### Fixed
+- Fatal error with deeply nested `else if` using custom helper (https://github.com/devtheorem/php-handlebars/issues/2).
+- Incorrect rendering of float values (https://github.com/devtheorem/php-handlebars/issues/11).
+- Support for `@partial-block` in conditions.
+- Support for `@partial-block` in nested partials (https://github.com/zordius/lightncandy/issues/292).
+- Ability to precompile partials and pass them at runtime (https://github.com/zordius/lightncandy/issues/341).
+- Fatal error when a string parameter to a partial includes curly braces (https://github.com/zordius/lightncandy/issues/316).
+- Behavior when modifying root context in a custom helper (https://github.com/zordius/lightncandy/issues/350).
+- Escaping of block params and partial names.
+- Numerous other bugs related to scoping, depth-relative paths, block params, inverted block helpers, and section iteration.
+
+
+Double-check every LightnCandy and PHP Handlebars issue where I left a comment, to see if any need to be updated following the helpers changes.
+
+
+Comment with fixed after release:
+- https://github.com/zordius/lightncandy/issues/350
+- https://github.com/zordius/lightncandy/issues/292
+- https://github.com/zordius/lightncandy/issues/341
+
+
+[Valid use for Lightncandy::prepare()](https://github.com/zordius/lightncandy/issues/346)
+- Comment that PHP Handlebars supports compile() method just like Handlebars.js
+
+
+[SafeString fails with FLAG\_EXTHELPER | FLAG\_BESTPERFORMANCE](https://github.com/zordius/lightncandy/issues/354)
+- Comment suggesting to try PHP Handlebars, which can often outperform LightnCandy without needing any special flags.
+
+
+https://github.com/zordius/lightncandy/issues/342
+https://github.com/zordius/lightncandy/issues/228
+
+
+[Unable to resolve partial when using sub expression and partial resolver](https://github.com/devtheorem/php-handlebars/issues/5)
+- Maybe comment with approach using helper rather than partial?
+
+
+Old: to review
 
 ### Added
-- Rewrote the parser and compiler using a proper AST, based on the same lexical analysis and grammar specification used by Handlebars.js. This eliminates a large class of edge cases and parsing bugs that the old regex-based approach failed to handle correctly.
-- `helperMissing` and `blockHelperMissing` hooks: register these as runtime helpers to handle calls to unknown helpers, replacing the old `helperResolver` option.
+- Rewrote the parser and compiler to use an AST, with the same lexical analysis and grammar specification as Handlebars.js. This eliminates a large class of edge cases and parsing bugs that the old regex-based approach failed to handle correctly.
+
 - `assumeObjects` compile option: intermediate path segments are required to exist, but terminal segments may be absent. Produces leaner compiled output than full strict mode.
 - `knownHelpers` compile option: tells the compiler which helpers will be registered at runtime, enabling more efficient code generation. `knownHelpersOnly` now works as in Handlebars.js — unknown helpers are dropped entirely rather than emitting a dynamic fallback.
-- Precompiled partial support: the `partials` runtime option now accepts `Closure` values in addition to template strings, so partials can be pre-compiled once and reused across renders.
+- Precompiled partial support: the `partials` runtime option now accepts `Closure` values (created via `Handlebars::compile()`), so partials can be pre-compiled once and reused across renders.
 - Lambda support for data variables: when a value in the render context is a `Closure`, it is now invoked with the current scope and its return value used, matching Handlebars.js lambda semantics.
-- Scoped path syntax (`{{./value}}`, `{{this/value}}`) now correctly bypasses block params and helper lookup, resolving directly from the current context.
-- Block statements with pathed or depth-relative paths and explicit params (e.g. `{{#../helper param}}`) are now compiled correctly.
 
 ### Changed
 - All helpers must now be passed at render time via the `helpers` key in the options array. The `helpers` compile option on `Options` has been removed. This matches Handlebars.js behavior, allows helper closures to be shared across templates, and eliminates the overhead of reading and tokenizing PHP helper files at compile time.