@wootsup/yt-builder-mcp 1.2.0 → 1.3.0

package/dist/tools/elements/handlers.js

@@ -19,8 +19,8 @@ import { detailResult, tableResult } from '@getimo/mcp-toolkit';
 import { z } from 'zod';
 import { encodeElementPath, encodeTemplateId } from '../../client.js';
 import { RestError } from '../../errors.js';
-import { ELEMENTS_COMPACT_COLUMNS, ELEMENTS_TABLE_COLUMNS, buildElementDetail, mapElementRow, } from '../format/elements-format.js';
-import { DEFAULT_FIELDS_ELEMENT_LIST, projectFields, projectionFeedback, projectedFieldsEcho, } from '../sparse-fields.js';
+import { ELEMENTS_COMPACT_COLUMNS, ELEMENTS_TABLE_COLUMNS, buildElementDetail, extractBinding, mapElementRow, } from '../format/elements-format.js';
+import { DEFAULT_FIELDS_ELEMENT_LIST, projectFields, projectionFeedback, projectionWarning, projectedFieldsEcho, } from '../sparse-fields.js';
 import { errorResult, structuredResult, } from '../tool-builder.js';
 // ─── outputSchemas (Wave G.2 §4) ─────────────────────────────────────
 export const ELEMENT_LIST_OUTPUT_SCHEMA = z.object({
@@ -59,6 +59,19 @@ export const ELEMENT_LIST_OUTPUT_SCHEMA = z.object({
             .optional()
             .describe('True when this element is dynamically bound to a data ' +
             'source. Use `element_get_binding` for the full mapping.'),
+        // F88: surface the binding so leaf field-mappings are readable
+        // back without dumping the props tree. Present only on bound rows.
+        source: z
+            .unknown()
+            .optional()
+            .describe('Raw binding object when bound (e.g. `{query:{name:"#parent"},' +
+            'props:{content:{name:"field.x"}}}`). Copy back into ' +
+            '`element_bind_source`. Present only when `has_binding` is true.'),
+        binding_summary: z
+            .string()
+            .optional()
+            .describe('Compact one-line binding: `<query> ← <el>:<field>, …`. ' +
+            'Present only when bound.'),
     })
         .passthrough()),
     total: z.number(),
@@ -72,6 +85,10 @@ export const ELEMENT_LIST_OUTPUT_SCHEMA = z.object({
     // table columns. See sparse-fields.ts::projectionFeedback.
     available_fields: z.array(z.string()).optional(),
     unknown_fields: z.array(z.string()).optional(),
+    // F23 (2026-06-10): the LOUD unknown-projection warning also rides in
+    // structuredContent — hosts that surface structuredContent (not the
+    // text leg) to the model would otherwise never see it.
+    projection_warning: z.string().optional(),
 });
 export const ELEMENT_GET_OUTPUT_SCHEMA = z.object({
     template_id: z.string(),
@@ -80,6 +97,11 @@ export const ELEMENT_GET_OUTPUT_SCHEMA = z.object({
     label: z.string().optional(),
     props: z.record(z.string(), z.unknown()).optional(),
     children_count: z.number(),
+    // F88 (2026-06-10): when the element is bound, surface the raw binding
+    // object + a compact summary so a leaf's field-mappings are readable back
+    // (the props tree no longer has to be eyeballed). Present only when bound.
+    source: z.unknown().optional(),
+    binding_summary: z.string().optional(),
 });
 // ─── element_list ────────────────────────────────────────────────────
 /**
@@ -165,6 +187,17 @@ export async function handleElementList({ client }, { template_id, fields, root_
             qs.set('limit', String(limit));
         if (typeof cursor === 'string' && cursor !== '')
             qs.set('cursor', cursor);
+        // F13 (2026-06-09): when the caller projects a nested `props.*`
+        // field, ask the REST plugin to attach the full props map per row
+        // (ElementOps::listOnTemplate honours `include=props`). The default
+        // row carries only `props_summary` (key names), which the row
+        // mapper drops — so without this opt-in the nested path would have
+        // nothing to project against. Mirrors page_get_layout flat-mode,
+        // which always carries props.
+        const wantsNestedProps = Array.isArray(fields) &&
+            fields.some((f) => f === 'props' || f.startsWith('props.'));
+        if (wantsNestedProps)
+            qs.set('include', 'props');
         const query = qs.toString();
         const data = await client.get(`/pages/${encodeTemplateId(template_id)}/elements${query !== '' ? `?${query}` : ''}`);
         // Paginated envelope uses `items`; flat shape uses `elements`.
@@ -202,9 +235,9 @@ export async function handleElementList({ client }, { template_id, fields, root_
         const items = projectFields(mapped, fields, DEFAULT_FIELDS_ELEMENT_LIST);
         const echo = projectedFieldsEcho(fields, DEFAULT_FIELDS_ELEMENT_LIST);
         const feedback = projectionFeedback(mapped, fields);
-        const unknownNote = feedback !== undefined && feedback.unknown_fields.length > 0
-            ? ` (unknown fields ignored: ${feedback.unknown_fields.join(', ')}; available: ${feedback.available_fields.join(', ')})`
-            : '';
+        // F23 (2026-06-09): the loud text-leg warning is built by the
+        // shared helper so every read tool surfaces the identical signal.
+        const unknownNote = projectionWarning(feedback);
         // N-01 (Audit v4): when the caller passes an explicit narrow
         // `fields[]`, render the text table from the projected (slim)
         // rows with `full` detail (8000 chars) so the WHOLE node list
@@ -235,6 +268,7 @@ export async function handleElementList({ client }, { template_id, fields, root_
             ...(feedback !== undefined ? {
                 available_fields: [...feedback.available_fields],
                 unknown_fields: [...feedback.unknown_fields],
+                ...(unknownNote.trim() !== '' ? { projection_warning: unknownNote.trim() } : {}),
             } : {}),
         });
     }
@@ -257,17 +291,47 @@ export async function handleElementGet({ client }, { template_id, element_path }
                 ? data.type
                 : '';
         const label = typeof data.label === 'string' ? data.label : undefined;
-        const propsRaw = data.props;
+        // Cluster C3 (back-compat defense-in-depth): older deployed plugins
+        // serialize an EMPTY props map as a JSON array `[]` (PHP
+        // `json_encode([])`). The fixed producer emits `{}`, but a client
+        // talking to an un-upgraded host still receives `[]`. The
+        // `element_get` outputSchema declares `props` as a `z.record(...)`
+        // (object), so emitting the raw `[]` into structuredContent makes
+        // the host reject the response with -32602 ("expected record,
+        // received array"). Normalize a ZERO-LENGTH array into an empty
+        // object. A NON-empty array is genuinely invalid (no plugin emits
+        // a populated array for props) — leave it untouched so schema
+        // validation surfaces the real error instead of masking it.
+        const propsRaw = Array.isArray(data.props) && data.props.length === 0
+            ? {}
+            : data.props;
         const props = propsRaw !== null && typeof propsRaw === 'object'
             ? propsRaw
             : undefined;
         const children = Array.isArray(data.children) ? data.children : [];
+        // F88: read the top-level binding carriers too. element_get returns
+        // the raw node under `element` plus the flattened top-level keys; the
+        // leaf #parent binding lives in `props.source`, but a container's
+        // binding may live in the top-level `source` / `source_extended`. Pass
+        // them through so the binding is surfaced + readable back.
+        const rawElement = data.element !== null && typeof data.element === 'object' && !Array.isArray(data.element)
+            ? data.element
+            : {};
+        const topSource = data.source ?? rawElement.source;
+        const topSourceExtended = data.source_extended ?? rawElement.source_extended;
+        const binding = extractBinding({
+            ...(props !== undefined ? { props } : {}),
+            ...(topSource !== undefined ? { source: topSource } : {}),
+            ...(topSourceExtended !== undefined ? { source_extended: topSourceExtended } : {}),
+        });
         const toolkitResult = detailResult(buildElementDetail({
             path: element_path,
             element_type: elementType,
             label,
             props,
             children: children,
+            ...(topSource !== undefined ? { source: topSource } : {}),
+            ...(topSourceExtended !== undefined ? { source_extended: topSourceExtended } : {}),
         }));
         return structuredResult(toolkitResult, {
             template_id,
@@ -276,6 +340,9 @@ export async function handleElementGet({ client }, { template_id, element_path }
             ...(label !== undefined ? { label } : {}),
             ...(props !== undefined ? { props } : {}),
             children_count: children.length,
+            ...(binding !== null
+                ? { source: binding.source, binding_summary: binding.binding_summary }
+                : {}),
         });
     }
     catch (e) {
@@ -288,5 +355,5 @@ export async function handleElementGet({ client }, { template_id, element_path }
     }
 }
 // Re-export write handlers so callers can import from this barrel.
-export { handleElementAdd, handleElementClone, handleElementDelete, handleElementMove, handleElementUpdateSettings, } from './handlers-write.js';
+export { handleElementAdd, handleElementClone, handleElementDelete, handleElementMove, handleElementUpdateSettings, handleScaffoldSection, } from './handlers-write.js';
 //# sourceMappingURL=handlers.js.map

package/dist/tools/elements/handlers.js.map

@@ -1 +1 @@
-{"version":3,"file":"handlers.js","sourceRoot":"","sources":["../../../src/tools/elements/handlers.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"handlers.js","sourceRoot":"","sources":["../../../src/tools/elements/handlers.ts"],"names":[],"mappings":"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"}

package/dist/tools/elements/layout-hierarchy-rules.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Layout hierarchy grammar — TypeScript mirror of the PHP
+ * `WootsUp\BuilderMcp\Elements\LayoutHierarchyRules` constant.
+ *
+ * YOOtheme Pro renders a layout tree with a FIXED structural skeleton:
+ *
+ *     root (layout) ⊃ section ⊃ row ⊃ column ⊃ {content | container}
+ *
+ * Content elements hung directly on the root / in a bare section / in a
+ * bare row do NOT render. This grammar (derived from REAL ab-Werk layouts —
+ * live-dumped from joomla-dev5 article:2 "The Club", YT 5.0.22) is the
+ * single source of truth shared by:
+ *   • the PHP per-element + bulk guards (server-side enforcement)
+ *   • the `scaffold_section` tool (builds a VALID section→row→column hull)
+ *
+ * Conservatism contract: REJECT ONLY what is positively known invalid (a
+ * child not allowed under a STRICT parent — section/row/root). Every other
+ * parent (column, fragment, multi-item containers, unknown 3rd-party) is
+ * PERMISSIVE. A false-positive that blocks a legitimate layout is strictly
+ * worse than a let-through edge case.
+ *
+ * The PHP and TS tables MUST stay in lock-step — both files carry a
+ * pin-test that fails if the grammar drifts.
+ *
+ * @license MIT
+ */
+/**
+ * The ONLY element-type allowed as a DIRECT child of the layout root.
+ * Live-verified: every root child on article:2 is a `section`.
+ */
+export declare const ROOT_ALLOWED: readonly string[];
+/**
+ * STRICT structural parents and their EXHAUSTIVE allowed-child set.
+ * `column` is deliberately ABSENT — it is the permissive content host.
+ */
+export declare const STRICT_PARENTS: Readonly<Record<string, readonly string[]>>;
+/**
+ * Return the exhaustive allowed-child list for `parentType`, or null when
+ * `parentType` is NOT a strict structural parent (= permissive).
+ */
+export declare function allowedChildrenOf(parentType: string): readonly string[] | null;
+/**
+ * Is `childType` a valid DIRECT child of the layout root? Permissive for the
+ * empty type and for unknown / fragment types.
+ */
+export declare function isAllowedRootChild(childType: string): boolean;
+/**
+ * Is `childType` a valid child of `parentType`? Strict parents enforce
+ * their allow-list; every other parent is permissive.
+ */
+export declare function isAllowedChild(parentType: string, childType: string): boolean;
+/** Is `type` one of the STRICT structural parents (section / row)? */
+export declare function isStructuralParent(type: string): boolean;
+/**
+ * Is `childType` a type the STATIC grammar can positively reason about WITHOUT
+ * the live YT element-registry? True for the closed grammar (`section` + every
+ * KNOWN-non-section type); false for unknown / 3rd-party / `fragment` types
+ * (which stay degrade-permissive). Mirror of the PHP
+ * `LayoutHierarchyRules::isStaticallyDecidableChild`.
+ */
+export declare function isStaticallyDecidableChild(childType: string): boolean;
+//# sourceMappingURL=layout-hierarchy-rules.d.ts.map

package/dist/tools/elements/layout-hierarchy-rules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"layout-hierarchy-rules.d.ts","sourceRoot":"","sources":["../../../src/tools/elements/layout-hierarchy-rules.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH;;;GAGG;AACH,eAAO,MAAM,YAAY,EAAE,SAAS,MAAM,EAA+B,CAAC;AAE1E;;;GAGG;AACH,eAAO,MAAM,cAAc,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC,CAGrE,CAAC;AAEH;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,GAAG,IAAI,CAI9E;AAgED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAQ7D;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAM7E;AAED,sEAAsE;AACtE,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAExD;AAED;;;;;;GAMG;AACH,wBAAgB,0BAA0B,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAQrE"}

package/dist/tools/elements/layout-hierarchy-rules.js

@@ -0,0 +1,154 @@
+/**
+ * Layout hierarchy grammar — TypeScript mirror of the PHP
+ * `WootsUp\BuilderMcp\Elements\LayoutHierarchyRules` constant.
+ *
+ * YOOtheme Pro renders a layout tree with a FIXED structural skeleton:
+ *
+ *     root (layout) ⊃ section ⊃ row ⊃ column ⊃ {content | container}
+ *
+ * Content elements hung directly on the root / in a bare section / in a
+ * bare row do NOT render. This grammar (derived from REAL ab-Werk layouts —
+ * live-dumped from joomla-dev5 article:2 "The Club", YT 5.0.22) is the
+ * single source of truth shared by:
+ *   • the PHP per-element + bulk guards (server-side enforcement)
+ *   • the `scaffold_section` tool (builds a VALID section→row→column hull)
+ *
+ * Conservatism contract: REJECT ONLY what is positively known invalid (a
+ * child not allowed under a STRICT parent — section/row/root). Every other
+ * parent (column, fragment, multi-item containers, unknown 3rd-party) is
+ * PERMISSIVE. A false-positive that blocks a legitimate layout is strictly
+ * worse than a let-through edge case.
+ *
+ * The PHP and TS tables MUST stay in lock-step — both files carry a
+ * pin-test that fails if the grammar drifts.
+ *
+ * @license MIT
+ */
+/**
+ * The ONLY element-type allowed as a DIRECT child of the layout root.
+ * Live-verified: every root child on article:2 is a `section`.
+ */
+export const ROOT_ALLOWED = Object.freeze(['section']);
+/**
+ * STRICT structural parents and their EXHAUSTIVE allowed-child set.
+ * `column` is deliberately ABSENT — it is the permissive content host.
+ */
+export const STRICT_PARENTS = Object.freeze({
+    section: Object.freeze(['row']),
+    row: Object.freeze(['column']),
+});
+/**
+ * Return the exhaustive allowed-child list for `parentType`, or null when
+ * `parentType` is NOT a strict structural parent (= permissive).
+ */
+export function allowedChildrenOf(parentType) {
+    return Object.prototype.hasOwnProperty.call(STRICT_PARENTS, parentType)
+        ? (STRICT_PARENTS[parentType] ?? null)
+        : null;
+}
+/**
+ * The closed set of KNOWN element-types that are NOT a `section` and are
+ * therefore invalid as a DIRECT root child. `fragment` is DELIBERATELY
+ * excluded (YT5 permissive wrapper). Built from the inner structural types,
+ * the canonical content leaves, and the multi-item containers + their items.
+ */
+const KNOWN_NON_SECTION_TYPES = new Set([
+    // Inner structural types — never valid on the root.
+    'row',
+    'column',
+    'layout',
+    // Canonical content leaves (YT 4.5.33 built-ins).
+    'text',
+    'headline',
+    'image',
+    'html',
+    'icon',
+    'alert',
+    'code',
+    'countdown',
+    'divider',
+    'overlay',
+    'panel',
+    'quotation',
+    'totop',
+    'video',
+    'spacer',
+    // Multi-item containers + their `*_item` children (mirrors ItemContainerMap).
+    'accordion',
+    'accordion_item',
+    'button',
+    'button_item',
+    'description_list',
+    'description_list_item',
+    'gallery',
+    'gallery_item',
+    'grid',
+    'grid_item',
+    'list',
+    'list_item',
+    'map',
+    'map_item',
+    'nav',
+    'nav_item',
+    'overlay-slider',
+    'overlay-slider_item',
+    'panel-slider',
+    'panel-slider_item',
+    'popover',
+    'popover_item',
+    'slideshow',
+    'slideshow_item',
+    'social',
+    'social_item',
+    'subnav',
+    'subnav_item',
+    'switcher',
+    'switcher_item',
+    'table',
+    'table_item',
+]);
+/**
+ * Is `childType` a valid DIRECT child of the layout root? Permissive for the
+ * empty type and for unknown / fragment types.
+ */
+export function isAllowedRootChild(childType) {
+    if (childType === '') {
+        return true;
+    }
+    if (ROOT_ALLOWED.includes(childType)) {
+        return true;
+    }
+    return !KNOWN_NON_SECTION_TYPES.has(childType);
+}
+/**
+ * Is `childType` a valid child of `parentType`? Strict parents enforce
+ * their allow-list; every other parent is permissive.
+ */
+export function isAllowedChild(parentType, childType) {
+    const allowed = allowedChildrenOf(parentType);
+    if (allowed === null) {
+        return true;
+    }
+    return allowed.includes(childType);
+}
+/** Is `type` one of the STRICT structural parents (section / row)? */
+export function isStructuralParent(type) {
+    return Object.prototype.hasOwnProperty.call(STRICT_PARENTS, type);
+}
+/**
+ * Is `childType` a type the STATIC grammar can positively reason about WITHOUT
+ * the live YT element-registry? True for the closed grammar (`section` + every
+ * KNOWN-non-section type); false for unknown / 3rd-party / `fragment` types
+ * (which stay degrade-permissive). Mirror of the PHP
+ * `LayoutHierarchyRules::isStaticallyDecidableChild`.
+ */
+export function isStaticallyDecidableChild(childType) {
+    if (childType === '') {
+        return false;
+    }
+    if (ROOT_ALLOWED.includes(childType)) {
+        return true;
+    }
+    return KNOWN_NON_SECTION_TYPES.has(childType);
+}
+//# sourceMappingURL=layout-hierarchy-rules.js.map

package/dist/tools/elements/layout-hierarchy-rules.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"layout-hierarchy-rules.js","sourceRoot":"","sources":["../../../src/tools/elements/layout-hierarchy-rules.ts"],"names":[],"mappings":"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"}

package/dist/tools/format/elements-format.d.ts

@@ -14,6 +14,35 @@ export declare const ELEMENTS_COMPACT_COLUMNS: readonly TableColumn[];
  * `has_binding` from the SAME logic element_list uses — one SSoT.
  */
 export declare function hasSourceBinding(node: unknown): boolean;
+/**
+ * F88 (2026-06-10): the resolved binding for an element, made READABLE.
+ *
+ * element_get / element_list historically surfaced only `has_binding`
+ * (a boolean) — so after binding a leaf (`props.content → field.x`) the
+ * agent could see THAT it was bound but not WHAT to. There was no
+ * top-level `source` projection, so the binding never appeared in
+ * `available_fields` and was unreadable without dumping the whole props
+ * tree. `extractBinding` finds the carrier slot (the same precedence
+ * BindingSerializer / hasSourceBinding use) and returns the raw binding
+ * object plus a compact human/agent-readable summary.
+ */
+export interface ExtractedBinding {
+    /** Which slot carried the binding: `source` / `props.source` / `source_extended`. */
+    readonly carrier: 'source' | 'props.source' | 'source_extended';
+    /** The raw binding object — copy straight back into element_bind_source. */
+    readonly source: unknown;
+    /** Compact one-line summary: query name + bound leaf fields. */
+    readonly binding_summary: string;
+}
+/**
+ * Find the binding carrier on a node and return the raw binding object +
+ * a compact summary, or `null` when the node carries no binding. Carrier
+ * precedence mirrors `hasSourceBinding` (YT-Pro canonical `node.source`
+ * first, then the pre-1.1.13 `props.source` slot, then the YT4
+ * `source_extended` cache). A bare non-empty string source (legacy
+ * pre-F-13 user data) is surfaced too so it stays readable.
+ */
+export declare function extractBinding(node: Record<string, unknown>): ExtractedBinding | null;
 /**
  * Maps an `/elements` row to the table shape.
  *
@@ -21,6 +50,9 @@ export declare function hasSourceBinding(node: unknown): boolean;
  *   `label`, older emit `title` as the human-readable name).
  * - `has_binding` honours an explicit boolean from the REST plugin, else
  *   derives from `props.source` presence.
+ * - F88: when a binding carrier is present, surface the raw `source`
+ *   object + a compact `binding_summary` so leaf field-bindings are
+ *   readable back (and appear in `available_fields`).
  */
 export declare function mapElementRow(input: Record<string, unknown>): Record<string, unknown>;
 interface ElementChildLike {
@@ -32,6 +64,9 @@ export declare function buildElementDetail(payload: {
     props?: unknown;
     children?: ElementChildLike[];
     label?: string;
+    /** F88: top-level carriers so the Binding group reads them too. */
+    source?: unknown;
+    source_extended?: unknown;
 }): {
     groups: DetailGroup[];
     title?: string;

package/dist/tools/format/elements-format.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"elements-format.d.ts","sourceRoot":"","sources":["../../../src/tools/format/elements-format.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAOpE,eAAO,MAAM,sBAAsB,EAAE,SAAS,WAAW,EAKxD,CAAC;AAEF,mEAAmE;AACnE,eAAO,MAAM,wBAAwB,EAAE,SAAS,WAAW,EAG1D,CAAC;AA+CF;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CA+BvD;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAqBrF;AAID,UAAU,gBAAgB;IACtB,IAAI,CAAC,EAAE,OAAO,CAAC;CAClB;AAoBD,wBAAgB,kBAAkB,CAAC,OAAO,EAAE;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,QAAQ,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB,GAAG;IAAE,MAAM,EAAE,WAAW,EAAE,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CA4C5C"}
+{"version":3,"file":"elements-format.d.ts","sourceRoot":"","sources":["../../../src/tools/format/elements-format.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAOpE,eAAO,MAAM,sBAAsB,EAAE,SAAS,WAAW,EAKxD,CAAC;AAEF,mEAAmE;AACnE,eAAO,MAAM,wBAAwB,EAAE,SAAS,WAAW,EAG1D,CAAC;AA+CF;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CA+BvD;AAED;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,gBAAgB;IAC7B,qFAAqF;IACrF,QAAQ,CAAC,OAAO,EAAE,QAAQ,GAAG,cAAc,GAAG,iBAAiB,CAAC;IAChE,4EAA4E;IAC5E,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,gEAAgE;IAChE,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;CACpC;AAgCD;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,gBAAgB,GAAG,IAAI,CA+BrF;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAmDrF;AAID,UAAU,gBAAgB;IACtB,IAAI,CAAC,EAAE,OAAO,CAAC;CAClB;AAoBD,wBAAgB,kBAAkB,CAAC,OAAO,EAAE;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,QAAQ,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,mEAAmE;IACnE,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,eAAe,CAAC,EAAE,OAAO,CAAC;CAC7B,GAAG;IAAE,MAAM,EAAE,WAAW,EAAE,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAsE5C"}

package/dist/tools/format/elements-format.js

@@ -102,6 +102,75 @@ export function hasSourceBinding(node) {
     }
     return false;
 }
+/**
+ * Build the compact `binding_summary` string for a structured binding
+ * object: `<query.name> ← <el>:<field>, <el>:<field>, …`. A binding with
+ * no `props` field-mappings (e.g. a bare iterating query on a container)
+ * summarises to just the query name. Inherit-only bindings (no query
+ * name) lead with `#inherit`.
+ */
+function summarizeBinding(src) {
+    if (src === null || typeof src !== 'object')
+        return String(src);
+    const obj = src;
+    const query = obj.query;
+    const queryName = query !== null && typeof query === 'object' && typeof query.name === 'string'
+        ? query.name
+        : '';
+    const leaves = [];
+    const props = obj.props;
+    if (props !== null && typeof props === 'object') {
+        for (const el of Object.keys(props)) {
+            const v = props[el];
+            if (v !== null && typeof v === 'object') {
+                const name = v.name;
+                leaves.push(`${el}:${typeof name === 'string' ? name : '?'}`);
+            }
+        }
+    }
+    const head = queryName !== '' ? queryName : '#inherit';
+    return leaves.length > 0 ? `${head} ← ${leaves.join(', ')}` : head;
+}
+/**
+ * Find the binding carrier on a node and return the raw binding object +
+ * a compact summary, or `null` when the node carries no binding. Carrier
+ * precedence mirrors `hasSourceBinding` (YT-Pro canonical `node.source`
+ * first, then the pre-1.1.13 `props.source` slot, then the YT4
+ * `source_extended` cache). A bare non-empty string source (legacy
+ * pre-F-13 user data) is surfaced too so it stays readable.
+ */
+export function extractBinding(node) {
+    // (1) top-level node.source — YT-Pro canonical.
+    if ('source' in node) {
+        const src = node.source;
+        if (typeof src === 'string' && src.length > 0) {
+            return { carrier: 'source', source: src, binding_summary: src };
+        }
+        if (isStructuredBinding(src)) {
+            return { carrier: 'source', source: src, binding_summary: summarizeBinding(src) };
+        }
+    }
+    // (2) props.source — pre-1.1.13 writer slot (the leaf #parent shape lives here).
+    const props = node.props;
+    if (props !== null && typeof props === 'object' && 'source' in props) {
+        const src = props.source;
+        if (typeof src === 'string' && src.length > 0) {
+            return { carrier: 'props.source', source: src, binding_summary: src };
+        }
+        if (isStructuredBinding(src)) {
+            return { carrier: 'props.source', source: src, binding_summary: summarizeBinding(src) };
+        }
+    }
+    // (3) node.source_extended — YT4 cached/expanded.
+    if ('source_extended' in node && isStructuredBinding(node.source_extended)) {
+        return {
+            carrier: 'source_extended',
+            source: node.source_extended,
+            binding_summary: summarizeBinding(node.source_extended),
+        };
+    }
+    return null;
+}
 /**
  * Maps an `/elements` row to the table shape.
  *
@@ -109,6 +178,9 @@ export function hasSourceBinding(node) {
  *   `label`, older emit `title` as the human-readable name).
  * - `has_binding` honours an explicit boolean from the REST plugin, else
  *   derives from `props.source` presence.
+ * - F88: when a binding carrier is present, surface the raw `source`
+ *   object + a compact `binding_summary` so leaf field-bindings are
+ *   readable back (and appear in `available_fields`).
  */
 export function mapElementRow(input) {
     const label = asString(input.label) !== ''
@@ -119,13 +191,39 @@ export function mapElementRow(input) {
     // F-06: derive relative path by stripping `/templates/<id>/layout` prefix
     // so the LLM table column shows uniquely-identifying suffix.
     const relPath = path.replace(/^\/templates\/[^/]+\/layout/, '') || '/';
-    return {
+    const row = {
         path,
         rel_path: relPath,
         element_type: asString(input.element_type),
         label,
         has_binding: explicitBinding ?? hasSourceBinding(input),
     };
+    // F13 (2026-06-09): preserve the row's `props` object when the REST
+    // plugin attached it (it does so only on `include=props`, see
+    // ElementOps::listOnTemplate). Keeping `props` lets the sparse-fields
+    // helper project nested paths (`fields:["props.content"]`) — the same
+    // capability page_get_layout flat-mode already has (flattenLayout keeps
+    // props). Without this the nested path landed in `unknown_fields` and
+    // the value never surfaced. A zero-length array (PHP `json_encode([])`
+    // on an empty map from an un-upgraded host) is normalised to `{}` so
+    // the shape stays an object, mirroring the element_get C3 defense.
+    if (Array.isArray(input.props) && input.props.length === 0) {
+        row.props = {};
+    }
+    else if (input.props !== null &&
+        typeof input.props === 'object' &&
+        !Array.isArray(input.props)) {
+        row.props = input.props;
+    }
+    // F88: surface the resolved binding so leaf field-mappings are readable
+    // back. Only emitted when a carrier is actually present — keeps unbound
+    // rows byte-identical (and out of `available_fields`).
+    const binding = extractBinding(input);
+    if (binding !== null) {
+        row.source = binding.source;
+        row.binding_summary = binding.binding_summary;
+    }
+    return row;
 }
 function summarizeProps(props) {
     if (props === null || typeof props !== 'object')
@@ -149,6 +247,17 @@ function listChildTypes(children) {
 }
 export function buildElementDetail(payload) {
     const children = Array.isArray(payload.children) ? payload.children : [];
+    // F88: resolve the binding from whichever carrier is present so a bound
+    // leaf surfaces a dedicated Binding group (query + leaf field mappings)
+    // instead of hiding the source inside the Props-keys summary.
+    const bindingNode = {
+        ...(payload.props !== null && typeof payload.props === 'object' && !Array.isArray(payload.props)
+            ? { props: payload.props }
+            : {}),
+        ...(payload.source !== undefined ? { source: payload.source } : {}),
+        ...(payload.source_extended !== undefined ? { source_extended: payload.source_extended } : {}),
+    };
+    const binding = extractBinding(bindingNode);
     return {
         title: `Element ${payload.path}`,
         groups: [
@@ -168,6 +277,20 @@ export function buildElementDetail(payload) {
                     { key: 'keys', label: 'Keys', value: summarizeProps(payload.props) },
                 ],
             },
+            // F88: Binding group — only when the element actually carries a
+            // source. Surfaces the carrier slot + the compact summary so the
+            // agent can read back leaf field-mappings without a props dump.
+            ...(binding !== null
+                ? [
+                    {
+                        label: 'Binding',
+                        entries: [
+                            { key: 'carrier', label: 'Carrier', value: binding.carrier, format: 'code' },
+                            { key: 'summary', label: 'Summary', value: binding.binding_summary },
+                        ],
+                    },
+                ]
+                : []),
             {
                 label: 'Children',
                 entries: [