chore: release 1.3.4

Author: Peter Stenger

README.md

@@ -306,7 +306,7 @@ Create a `.htmlmustache.jsonc` file in your project root to configure formatting
 ```
 
 The schema URL above tracks `main`. For release-pinned validation, replace
-`main` with a tag such as `v1.3.3`.
+`main` with a tag such as `v1.3.4`.
 
 ### Lint Rules
 
@@ -538,7 +538,7 @@ export const validators = defineTagValidators('pl-order-blocks', {
 });
 ```
 
-`element.children` contains one level of direct child HTML elements. Mustache sections are transparent, so children inside `{{#section}}...{{/section}}` are included. Child facades expose their tag and attributes, but their own `children` arrays are empty. `element.innerHtml` is present only when the validator opts into `options.includeInnerHtml`.
+`element.children` contains direct child HTML elements. Mustache sections are transparent, so children inside `{{#section}}...{{/section}}` are included. Child facades are populated recursively, so validators can inspect nested direct children from each child facade. `element.innerHtml` is present only when the validator opts into `options.includeInnerHtml`.
 
 `defineTagValidators(tagOrTags, rules)` is optional sugar for plugin authors. It lowercases the target tag or tags and expands each rule-map entry into an independent validator; rule-map keys are the exact rule ids used by `rules` config and inline disable comments. A rule can be a bare validation function or an object with `validate`, `severity`, and `options`.
 

js/linter/linter.test.ts

@@ -946,7 +946,7 @@ describe('createLinter validators hook', () => {
     expect(disabled.some((x) => x.ruleName === 'no-pl-card')).toBe(false);
   });
 
-  it('exposes one-level child facades with mustache-section flattening', async () => {
+  it('exposes direct child facades with mustache-section flattening', async () => {
     const handle = await createLinter({
       locateWasm: GRAMMAR_WASM_PATH,
       validators: [
@@ -958,10 +958,13 @@ describe('createLinter validators hook', () => {
             if (tags !== 'pl-item,pl-extra') {
               context.report({ element, message: `children:${tags}` });
             }
-            if (element.children[0]?.children.length !== 0) {
+            if (
+              element.children[0]?.childrenWithTag('span').length !== 1 ||
+              element.children[0]?.childrenWithTag('pl-extra').length !== 0
+            ) {
               context.report({
                 element,
-                message: 'children should be one-level',
+                message: 'child facade children mismatch',
               });
             }
           },
@@ -981,6 +984,35 @@ describe('createLinter validators hook', () => {
     expect(d.filter((x) => x.ruleName === 'child-tags')).toEqual([]);
   });
 
+  it('populates nested custom-tag child facades recursively', async () => {
+    const handle = await createLinter({
+      locateWasm: GRAMMAR_WASM_PATH,
+      validators: defineTagValidators('pl-order-blocks', {
+        'requires-group-answer'(element, context) {
+          for (const group of element.childrenWithTag('pl-block-group')) {
+            const answers = group.childrenWithTag('pl-answer');
+            if (answers.length === 0) {
+              context.reportElement(group, 'Group has no answers');
+            }
+          }
+        },
+      }),
+    });
+    const d = handle.lint(
+      '<pl-order-blocks><pl-block-group><pl-answer>One</pl-answer></pl-block-group></pl-order-blocks>',
+      {
+        customTags: [
+          { name: 'pl-order-blocks' },
+          { name: 'pl-block-group' },
+          { name: 'pl-answer' },
+        ],
+      },
+    );
+    expect(d.filter((x) => x.ruleName === 'requires-group-answer')).toEqual(
+      [],
+    );
+  });
+
   it('exposes innerHtml only when includeInnerHtml is set', async () => {
     const handle = await createLinter({
       locateWasm: GRAMMAR_WASM_PATH,

js/linter/tagValidatorRunner.ts

@@ -116,7 +116,7 @@ function buildFacade(
   for (const [name, info] of attributesByName) attributes[name] = info.value;
   const children = includeChildren
     ? collectDirectHtmlChildren(node)
-        .map((child) => buildFacade(child, includeInnerHtml, false))
+        .map((child) => buildFacade(child, includeInnerHtml, true))
         .filter((child): child is Facade => child !== null)
     : [];
   return {