Fix compilation of complex path with hash argument

Author: theodorejb

src/Compiler.php

@@ -188,8 +188,11 @@ private function BlockStatement(BlockStatement $block): string
             return $this->compileInvertedSection($block, $var, $escapedName);
         }
 
-        // Non-simple path with params: invoke as a dynamic block helper call
-        if ($block->params) {
+        // Non-simple path with params or hash: invoke as a dynamic block helper call
+        if ($block->params || $block->hash !== null) {
+            if ($this->context->options->knownHelpersOnly) {
+                $this->throwKnownHelpersOnly((string) $block->path->original);
+            }
             return $this->compileDynamicBlockHelper($block, (string) $block->path->original, $var);
         }
 
@@ -294,7 +297,7 @@ private function compileBlockHelper(BlockStatement $block, string $name): string
         $fnProgram = $block->program ?? $block->inverse;
         assert($fnProgram !== null);
 
-        // Inline if/unless as ternary — eliminates hbbch dispatch and HelperOptions allocation.
+        // Inline if/unless as ternary — eliminates helper dispatch and HelperOptions allocation.
         // Safe because if/unless don't change scope, so $cx and $in are already correct.
         // Negate for 'unless' in a normal block, or 'if' in an inverted block (swapped semantics).
         if ($this->canInlineConditional($block, $name, $fnProgram->blockParams)) {

tests/ErrorTest.php

@@ -256,6 +256,16 @@ public static function errorProvider(): array
                 'options' => new Options(knownHelpers: ['if' => false], knownHelpersOnly: true),
                 'expected' => 'You specified knownHelpersOnly, but used the unknown helper if',
             ],
+            'knownHelpersOnly rejects multi-segment path with hash' => [
+                'template' => '{{#obj.fn prop=val}}BODY{{/obj.fn}}',
+                'options' => new Options(knownHelpersOnly: true),
+                'expected' => 'You specified knownHelpersOnly, but used the unknown helper obj.fn',
+            ],
+            'knownHelpersOnly rejects depth path with hash' => [
+                'template' => '{{#../flag prop=val}}BODY{{/../flag}}',
+                'options' => new Options(knownHelpersOnly: true),
+                'expected' => 'You specified knownHelpersOnly, but used the unknown helper ../flag',
+            ],
             'unknown decorator throws' => [
                 'template' => '{{#*help me}}{{/help}}',
                 'expected' => 'Unknown decorator: "help"',

tests/RegressionTest.php

@@ -1957,6 +1957,15 @@ public static function sectionProvider(): array
                 ],
                 'expected' => 'x:BODY',
             ],
+            'complex path with hash passes hash to closure via HelperOptions' => [
+                'template' => '{{#obj.fn prop="x"}}BODY{{/obj.fn}}',
+                'data' => [
+                    'obj' => [
+                        'fn' => fn(HelperOptions $options) => $options->hash['prop'] . ':' . $options->fn(),
+                    ],
+                ],
+                'expected' => 'x:BODY',
+            ],
             'lambda at complex path in inverted block is called with no arguments' => [
                 'template' => '{{^obj.fn}}BODY{{/obj.fn}}',
                 'data' => [