Update readme and changelog

Author: theodorejb

CHANGELOG.md

@@ -3,6 +3,18 @@ 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.2.0] Frame API - 2026-03-27
+
+### Added
+- `Handlebars::createFrame()`: creates a child `@data` frame inheriting fields from a parent frame,
+  equivalent to `Handlebars.createFrame()` in Handlebars.js.
+
+### Fixed
+- Block param path lookups and literal path lookups (e.g. `{{"foo"}}`, `{{#"foo"}}`) in `strict`
+  mode no longer incorrectly throw when the key exists but its value is `null`.
+- Inline partials defined inside an `{{else}}` block no longer leak into the surrounding scope.
+
+
 ## [1.1.0] Dynamic Partial Resolution - 2026-03-26
 
 ### Added

README.md

@@ -154,10 +154,10 @@ echo $template(['my_var' => null], $runtimeOptions); // Not equal
   (e.g. `{{#helper as |a b|}}` produces `2`).
 
 * `scope` (`mixed`): The current evaluation context (equivalent to `this` in a Handlebars.js helper).
-  Can be reassigned inside a helper to change the context passed to `fn()`.
 
-* `data` (`array`): The current `@data` frame. Contains `@`-prefixed private variables such as
-  `root`, `index`, `key`, `first`, `last`, and `_parent`. Can be read or modified inside a helper.
+* `data` (`array`): The current `@data` frame. `root` is always present and refers to the top-level
+  context. `index`, `key`, `first`, and `last` are set by `{{#each}}` blocks. Can be read or modified
+  inside a helper.
 
 ### HelperOptions Methods
 
@@ -177,7 +177,7 @@ echo $template(['my_var' => null], $runtimeOptions); // Not equal
   remainder of the render. The closure must be produced by `Handlebars::compile`.
 
 > [!NOTE]  
-> `isset($options->fn)` and `isset($options->inverse)` return true if the helper was called as a block,
+> `isset($options->fn)` and `isset($options->inverse)` return `true` if the helper was called as a block,
 > and `false` for inline helper calls.
 
 ## Hooks
@@ -220,7 +220,15 @@ When a helper is executed in a `{{{ }}}` expression, the original return value w
 
 Helpers may return a `DevTheorem\Handlebars\SafeString` instance to prevent escaping the return value.
 When constructing the string that will be marked as safe, any external content should be properly escaped
-using the `Handlebars::escapeExpression()` method to avoid potential security concerns.
+using the `Handlebars::escapeExpression()` method to prevent XSS vulnerabilities.
+
+## Data Frames
+
+Block helpers that inject `@`-prefixed variables should create a child data frame using
+`Handlebars::createFrame($options->data)`, add their variables to it, and pass it to `fn()` or `inverse()`
+via the `data` key (e.g. `$options->fn($context, ['data' => $frame])`). This mirrors `Handlebars.createFrame()`
+in Handlebars.js, isolating the helper's variables to avoid corrupting the state of any parents
+(while still inheriting parent variables such as `@root`).
 
 ## Missing Features