@wootsup/yt-builder-mcp 1.1.6 → 1.2.0

package/dist/tools/inspection.js

@@ -0,0 +1,401 @@
+/**
+ * Element-type inspection tools.
+ *
+ *   yootheme_builder_element_types_list
+ *      → catalogue of available element types (tableResult — Wave G.2)
+ *   yootheme_builder_element_type_get_schema
+ *      → field schema for a single element type (detailResult — Wave G.2)
+ *
+ * @license MIT
+ */
+import { detailResult, tableResult } from '@getimo/mcp-toolkit';
+import { z } from 'zod';
+import { TYPES_COMPACT_COLUMNS, TYPES_TABLE_COLUMNS, buildTypeSchemaDetail, flattenTypesPayload, mapTypeRow, } from './format/inspection-format.js';
+import { SITE_ID_SCHEMA } from './shared-schemas.js';
+import { resolveSiteOrError } from './pool-resolve-helper.js';
+import { defineTool, errorResult, readOnly, structuredResult, withSiteMeta, } from './tool-builder.js';
+import { DEFAULT_FIELDS_TYPES_LIST, FIELDS, projectFields, projectedFieldsEcho, projectionFeedback, } from './sparse-fields.js';
+import { ITEM_CHILDREN_OF_CONTAINER } from './multi-items/item-container-map.js';
+// ─── outputSchemas (Wave G.2 §4) ─────────────────────────────────────
+const TYPES_LIST_OUTPUT_SCHEMA = z.object({
+    items: z.array(z.record(z.string(), z.unknown())),
+    total: z.number(),
+    projected_fields: z.array(z.string()).optional(),
+    // F-004 fix (2026-05-25 exhaustive audit): see sparse-fields::projectionFeedback.
+    available_fields: z.array(z.string()).optional(),
+    unknown_fields: z.array(z.string()).optional(),
+});
+const TYPE_SCHEMA_OUTPUT_SCHEMA = z.object({
+    name: z.string(),
+    label: z.string().optional(),
+    origin: z.string().optional(),
+    // The REST endpoint returns `fields` as a list of {name,type,label?}
+    // field descriptors — each `name` is a valid prop key for element_add /
+    // _update_settings.
+    fields: z.array(z.record(z.string(), z.unknown())).optional(),
+    field_count: z.number(),
+    // Wave-6 R3 (2026-05-29): binding contract annotation. Surfaces the
+    // Multi-Items binding pattern for container types (grid/slider/switcher/
+    // list/accordion/gallery/panel/overlay), and identifies content-binding
+    // prop keys for leaf types (headline/text/button/image). Cold-AI #4 had
+    // to reverse-engineer this from inspect_multi_items_binding + page
+    // layout — this annotation eliminates that step.
+    binding_contract: z
+        .object({
+        kind: z.enum(['container', 'item', 'leaf', 'none']),
+        pattern: z.string(),
+        child_type: z.string().optional(),
+        child_required: z.boolean().optional(),
+        binding_target_props: z.array(z.string()).optional(),
+        minimal_layout: z.record(z.string(), z.unknown()).optional(),
+        set_via_tool: z.string().optional(),
+        discover_source_tool: z.string().optional(),
+        // Wave-7 (2026-05-29): explicit anti-patterns. Cold-AI #5 misread
+        // the minimal_layout and produced `props.source` nesting instead of
+        // sibling — YT-Pro silently ignored the binding and rendered 0 rows.
+        do_not: z.array(z.string()).optional(),
+    })
+        .optional(),
+});
+// Wave-6 R3 (2026-05-29): Binding-contract derivation.
+//
+// Container types are the Multi-Items hosts — when bound to a source they
+// clone their *_item child once per source row. The binding LIVES on the
+// child item, not the container.
+//
+// Wave-13 A5 (2026-05-31): the canonical 16-pair map lives in
+// `multi-items/item-container-map.ts` (TypeScript mirror of the PHP
+// `ItemContainerMap` constant, pinned via Joomla/WP cross-platform tests).
+// Re-aliased here as CONTAINER_TO_ITEM_TYPE so the binding-contract derivation
+// always agrees with the rest of the surface. The previous inline 10-entry
+// map had drifted (missing button/description_list/nav/popover/social/subnav/
+// table; routed `slider`/`panel`/`overlay` to non-existent item types).
+//
+// Leaf types (headline, text, image) cannot host Multi-Items but they DO
+// accept per-prop source bindings (e.g. `content` of a headline maps to a
+// single source field). We surface the canonical prop keys below so the
+// agent knows which keys to bind without guessing.
+const CONTAINER_TO_ITEM_TYPE = ITEM_CHILDREN_OF_CONTAINER;
+const ITEM_TO_CONTAINER_TYPE = Object.fromEntries(Object.entries(CONTAINER_TO_ITEM_TYPE).map(([k, v]) => [v, k]));
+/** Canonical binding-target props per leaf type. Empty array → leaf type has no clear single-field binding. */
+const LEAF_BINDING_TARGETS = {
+    headline: ['content', 'title_dynamic'],
+    text: ['content'],
+    button: ['content', 'link'],
+    image: ['image'],
+    icon: ['icon'],
+    quote: ['content'],
+    subtitle: ['content'],
+};
+function deriveBindingContract(elementType) {
+    const itemType = CONTAINER_TO_ITEM_TYPE[elementType];
+    if (itemType !== undefined) {
+        return {
+            kind: 'container',
+            pattern: `Multi-Items: bind on the CHILD (${itemType}) — NOT this container — ` +
+                `to clone N times per source row. **Use yootheme_builder_element_bind_source — ` +
+                `do NOT hand-author the source shape via element_update_settings({props:{source}}).** ` +
+                `The bind tool emits the canonical YT-Pro shape where \`source\` sits as a ` +
+                `SIBLING of \`props\`/\`children\` on the *_item, never nested inside \`props\`. ` +
+                `Use yootheme_builder_inspect_multi_items_binding to confirm where the binding ` +
+                `currently lives if a template renders 1 container with N children stacked vs ` +
+                `N siblings.`,
+            child_type: itemType,
+            child_required: true,
+            // Wave-7 (2026-05-29): canonical shape verified against
+            // page:3315/3252/3361 working pages on dev.wootsup.com.
+            // `source` is a SIBLING of `props`/`children`, NOT a nested key
+            // under `props`. The `*_item` element holds the binding; the
+            // container has NO `source` of its own. Cold-AI #5 inverted this
+            // and got silent-render-failure (page:3366).
+            minimal_layout: {
+                type: elementType,
+                // No `source` here — container is bare.
+                children: [
+                    {
+                        type: itemType,
+                        // `props` stays minimal — settings only.
+                        props: {},
+                        // `source` is a SIBLING of `props` / `children`.
+                        source: {
+                            query: {
+                                name: '<source_name from yootheme_builder_sources_list>',
+                            },
+                            props: {
+                                title: {
+                                    name: '<source_field>',
+                                    filters: [],
+                                },
+                                content: {
+                                    name: '<source_field>',
+                                    filters: [],
+                                },
+                            },
+                        },
+                        children: [],
+                    },
+                ],
+            },
+            set_via_tool: 'yootheme_builder_element_bind_source — REQUIRED. Hand-authoring source ' +
+                'via element_update_settings is rejected (props-schema does not include source).',
+            discover_source_tool: 'apimapper_yootheme_binding_for_flow({ flow_id }) — returns ready-to-paste binding shapes.',
+            do_not: [
+                `Do NOT set \`source\` on the container (${elementType}) itself — only on the *_item child.`,
+                `Do NOT nest \`source\` under \`props\` on the ${itemType} — it must be a sibling of props.`,
+                'Do NOT call element_update_settings with {source} or {source_extended} — those keys are not in the props schema and will be rejected.',
+                'Do NOT add child leaves (headline/text) under the *_item with their own \`source\` and \`${builder.source}\` placeholders — that pattern is UI-only and never resolves in stored layouts.',
+                'Do NOT use the SINGULAR wrapper flow name (`apiMapperFlow<Id>`) on the *_item — use the top-level `*List` name (`apiMapperFlow<Id>List`), the canonical Multi-Items target that clones once per source row (this is exactly `apimapper_yootheme_binding_for_flow.source_name_list`). The `*List` name on the *_item is CORRECT.',
+            ],
+        };
+    }
+    const containerType = ITEM_TO_CONTAINER_TYPE[elementType];
+    if (containerType !== undefined) {
+        return {
+            kind: 'item',
+            pattern: `Multi-Items child of "${containerType}". Bindings on this element are ` +
+                `cloned once per source row. **Use yootheme_builder_element_bind_source — ` +
+                `do NOT hand-author the source via element_update_settings.** The source must ` +
+                `be set on THIS element (as a SIBLING of \`props\`/\`children\`, not nested ` +
+                `inside \`props\`), not on the parent ${containerType}.`,
+            set_via_tool: 'yootheme_builder_element_bind_source — REQUIRED. Hand-authoring source ' +
+                'via element_update_settings is rejected (props-schema does not include source).',
+            discover_source_tool: 'apimapper_yootheme_binding_for_flow({ flow_id })',
+            do_not: [
+                `Do NOT set \`source\` on the parent ${containerType} — only on this ${elementType}.`,
+                'Do NOT nest `source` under `props` — it must be a sibling of `props`/`children`.',
+                'Do NOT call element_update_settings with {source} or {source_extended} — use element_bind_source.',
+                'Do NOT add child leaves with their own per-prop `source` + `${builder.source}` placeholders.',
+            ],
+        };
+    }
+    const leafTargets = LEAF_BINDING_TARGETS[elementType];
+    if (leafTargets !== undefined) {
+        return {
+            kind: 'leaf',
+            pattern: `Leaf element — supports single-field source bindings on the prop keys ` +
+                `listed in \`binding_target_props\`. NOT a Multi-Items host.`,
+            binding_target_props: [...leafTargets],
+            set_via_tool: 'yootheme_builder_element_bind_source',
+            discover_source_tool: 'apimapper_yootheme_binding_for_flow({ flow_id })',
+        };
+    }
+    return {
+        kind: 'none',
+        pattern: 'No standard binding contract known for this element type. Inspect the ' +
+            '`fields` list above and bind ad-hoc via yootheme_builder_element_bind_source.',
+    };
+}
+export function buildInspectionTools(pool) {
+    return [
+        defineTool({
+            name: 'yootheme_builder_element_types_list',
+            description: 'List element types registered on this site (built-ins + ' +
+                'YOOessentials/uEssentials extras). Names feed `element_type` of ' +
+                'element_add. Pass `fields[]` to narrow each row. ' +
+                'Operates on the default site unless site_id is provided.',
+            inputSchema: {
+                site_id: SITE_ID_SCHEMA,
+                fields: FIELDS,
+            },
+            outputSchema: TYPES_LIST_OUTPUT_SCHEMA,
+            annotations: readOnly('List Element Types'),
+            handler: async ({ site_id, fields }) => {
+                const r = await resolveSiteOrError(pool, site_id);
+                if (!r.ok)
+                    return r.error;
+                const { client: siteClient, site } = r;
+                try {
+                    const data = await siteClient.get('/element-types');
+                    const flat = flattenTypesPayload(data);
+                    const mapped = flat.map(mapTypeRow);
+                    const mappedRecords = mapped;
+                    const items = projectFields(mappedRecords, fields, DEFAULT_FIELDS_TYPES_LIST);
+                    const echo = projectedFieldsEcho(fields, DEFAULT_FIELDS_TYPES_LIST);
+                    const feedback = projectionFeedback(mappedRecords, fields);
+                    const unknownNote = feedback !== undefined && feedback.unknown_fields.length > 0
+                        ? ` (unknown fields ignored: ${feedback.unknown_fields.join(', ')}; available: ${feedback.available_fields.join(', ')})`
+                        : '';
+                    const toolkitResult = tableResult(mappedRecords, {
+                        columns: [...TYPES_TABLE_COLUMNS],
+                        compactColumns: [...TYPES_COMPACT_COLUMNS],
+                        header: (count) => `${String(count)} element types${unknownNote}`,
+                        footer: 'Use yootheme_builder_element_type_get_schema <name> for fields.',
+                    });
+                    return withSiteMeta(structuredResult(toolkitResult, {
+                        items,
+                        total: items.length,
+                        ...(echo !== undefined ? { projected_fields: [...echo] } : {}),
+                        ...(feedback !== undefined ? {
+                            available_fields: [...feedback.available_fields],
+                            unknown_fields: [...feedback.unknown_fields],
+                        } : {}),
+                    }), site);
+                }
+                catch (e) {
+                    return withSiteMeta(errorResult({
+                        error: e,
+                        context: { site_id: site.id },
+                        hint: 'Run yootheme_builder_diagnose to verify auth.',
+                    }), site);
+                }
+            },
+        }),
+        buildElementTypeGetSchemaTool(pool),
+    ];
+}
+/**
+ * F-203 follow-up (Audit 2026-05-26 reviewer Gap 2): factored out of
+ * `buildInspectionTools` so the shape + refined ZodObject pair lives in
+ * one place. The SDK's pre-handler validator honours the top-level
+ * `.refine()` on `TYPE_SCHEMA_REFINED` and raises
+ * JSON-RPC `-32602 InvalidParams` when violated — hosts see the
+ * failure BEFORE the handler ever runs. The raw shape stays for
+ * handler-type inference (see `inputSchema`).
+ */
+function buildElementTypeGetSchemaTool(pool) {
+    const TYPE_SCHEMA_SHAPE = {
+        site_id: SITE_ID_SCHEMA,
+        // 1.0.1 cross-tool parameter naming alignment: every other
+        // tool in this domain uses `element_type` (element_add,
+        // element_update_settings, element_list rows). This tool
+        // originally shipped with `type_name`; we accept BOTH for
+        // backward-compatibility but the canonical key going
+        // forward is `element_type`.
+        element_type: z
+            .string()
+            .min(1)
+            .optional()
+            .describe('Element type name (e.g. "headline", "text", "grid"). Use ' +
+            'yootheme_builder_element_types_list to discover.'),
+        type_name: z
+            .string()
+            .min(1)
+            .optional()
+            .describe('DEPRECATED alias of `element_type` — use `element_type` ' +
+            'instead. Kept for 1.0.x backward-compatibility; will be ' +
+            'removed in a future major.'),
+    };
+    const TYPE_SCHEMA_REFINED = z
+        .object(TYPE_SCHEMA_SHAPE)
+        .refine((args) => (typeof args.element_type === 'string' && args.element_type !== '') ||
+        (typeof args.type_name === 'string' && args.type_name !== ''), {
+        message: 'Provide either `element_type` (canonical) or ' +
+            '`type_name` (deprecated alias).',
+    });
+    return defineTool({
+        name: 'yootheme_builder_element_type_get_schema',
+        description: '**Call before every `element_add` / `_update_settings`** — unknown ' +
+            'prop keys are silently dropped server-side, so guessing fails ' +
+            'quietly. Returns `{name,type,label?}` field descriptors. Use ' +
+            '`element_type`; `type_name` is DEPRECATED. ' +
+            'Operates on the default site unless site_id is provided.',
+        inputSchema: TYPE_SCHEMA_SHAPE,
+        // F-203 follow-up: the refined object is what the SDK actually
+        // validates. The raw shape above stays for handler-type inference.
+        inputObjectSchema: TYPE_SCHEMA_REFINED,
+        outputSchema: TYPE_SCHEMA_OUTPUT_SCHEMA,
+        annotations: readOnly('Get Element Type Schema'),
+        handler: async (args) => {
+            // Defensive re-assert of the refine — should never fire when
+            // reached through the SDK (the boundary rejects with -32602
+            // first), but in-process tests bypass the SDK and call the
+            // handler directly, so the structured error path stays
+            // reachable for unit-test coverage.
+            const typeNameInput = typeof args.element_type === 'string' && args.element_type !== ''
+                ? args.element_type
+                : typeof args.type_name === 'string'
+                    ? args.type_name
+                    : '';
+            if (typeNameInput === '') {
+                return errorResult({
+                    error: new Error('Provide either `element_type` (canonical) or ' +
+                        '`type_name` (deprecated alias).'),
+                    context: { site_id: typeof args.site_id === 'string' ? args.site_id : null },
+                    hint: 'Pass `element_type` (e.g. "headline"). Use ' +
+                        'yootheme_builder_element_types_list to discover valid values.',
+                });
+            }
+            const type_name = typeNameInput;
+            const r = await resolveSiteOrError(pool, typeof args.site_id === 'string' ? args.site_id : undefined);
+            if (!r.ok)
+                return r.error;
+            const { client: siteClient, site } = r;
+            try {
+                const data = await siteClient.get(`/element-types/${encodeURIComponent(type_name)}/schema`);
+                // The REST endpoint nests the type schema under `schema`:
+                // {type_name, schema:{name,label,origin,has_children,fields:[…]}}.
+                // Fall back to the top-level object for older backends.
+                const schema = data.schema !== null && typeof data.schema === 'object'
+                    ? data.schema
+                    : data;
+                const name = typeof schema.name === 'string' ? schema.name : type_name;
+                const label = typeof schema.label === 'string' ? schema.label : undefined;
+                const origin = typeof schema.origin === 'string' ? schema.origin : undefined;
+                // `fields` is a list of {name,type,label?} field descriptors.
+                const fields = Array.isArray(schema.fields)
+                    ? schema.fields
+                    : undefined;
+                const fieldCount = fields !== undefined ? fields.length : 0;
+                // Wave-6 R3 (2026-05-29): attach a binding contract so
+                // the agent doesn't have to reverse-engineer the
+                // Multi-Items pattern from layout + inspection probes.
+                const bindingContract = deriveBindingContract(name);
+                const toolkitResult = detailResult(buildTypeSchemaDetail({
+                    name,
+                    label,
+                    origin,
+                    fields,
+                    ...(bindingContract !== undefined
+                        ? {
+                            bindingContract: {
+                                kind: bindingContract.kind,
+                                pattern: bindingContract.pattern,
+                                ...(bindingContract.child_type !== undefined
+                                    ? { child_type: bindingContract.child_type }
+                                    : {}),
+                                ...(bindingContract.binding_target_props !== undefined
+                                    ? {
+                                        binding_target_props: bindingContract.binding_target_props,
+                                    }
+                                    : {}),
+                                ...(bindingContract.set_via_tool !== undefined
+                                    ? { set_via_tool: bindingContract.set_via_tool }
+                                    : {}),
+                                ...(bindingContract.discover_source_tool !== undefined
+                                    ? {
+                                        discover_source_tool: bindingContract.discover_source_tool,
+                                    }
+                                    : {}),
+                                ...(bindingContract.do_not !== undefined
+                                    ? { do_not: bindingContract.do_not }
+                                    : {}),
+                                ...(bindingContract.minimal_layout !== undefined
+                                    ? { minimal_layout: bindingContract.minimal_layout }
+                                    : {}),
+                            },
+                        }
+                        : {}),
+                }));
+                return withSiteMeta(structuredResult(toolkitResult, {
+                    name,
+                    ...(label !== undefined ? { label } : {}),
+                    ...(origin !== undefined ? { origin } : {}),
+                    ...(fields !== undefined ? { fields } : {}),
+                    field_count: fieldCount,
+                    ...(bindingContract !== undefined
+                        ? { binding_contract: bindingContract }
+                        : {}),
+                }), site);
+            }
+            catch (e) {
+                return withSiteMeta(errorResult({
+                    error: e,
+                    context: { element_type: type_name, site_id: site.id },
+                    hint: 'Verify element_type via yootheme_builder_element_types_list — names ' +
+                        'are case-sensitive.',
+                }), site);
+            }
+        },
+    });
+}
+//# sourceMappingURL=inspection.js.map

package/dist/tools/inspection.js.map

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

package/dist/tools/layout-flatten.d.ts

@@ -0,0 +1,75 @@
+/**
+ * Layout-flatten helper — depth-first walk that turns a nested YOOtheme
+ * layout tree into a flat array of `{ path, parent_path, depth,
+ * element_type, props }` records.
+ *
+ * Used by `yootheme_builder_page_get_layout` when called with
+ * `flat: true`. Per Design §4.4.1:
+ *
+ *   - Walk-order: depth-first, parent BEFORE children, original child
+ *     order preserved (no sort).
+ *   - `path` uses JSON-Pointer-style notation rooted at `/layout/<key>`
+ *     and descends via `/children/<index>` segments. The root segments
+ *     mirror the keys the REST plugin produces (string keys "0","1",…
+ *     when the top-level layout is an object; numeric indices when it
+ *     happens to be an array).
+ *   - `parent_path` is `null` for top-level entries.
+ *   - The emitted record's `children` field is REMOVED — children become
+ *     their own emitted entries with their own `path`. Keeping the nested
+ *     array would defeat the purpose of flattening.
+ *   - Non-object children are skipped silently but their index is
+ *     preserved in the parent's child-numbering (the next valid sibling
+ *     keeps its original index).
+ *
+ * Pure function — no I/O, no client dependency. Test-covered in
+ * `tests/tools/layout-flatten.test.ts`.
+ *
+ * @license MIT
+ */
+/** A single emitted record in the flattened layout. */
+export interface FlatElement {
+    /** JSON-Pointer-style path, e.g. "/layout/0/children/2". */
+    path: string;
+    /**
+     * Path with the `/layout` prefix stripped, e.g. "/0/children/2".
+     * N-01 (Audit v4): mirrors the `rel_path` column element_list emits
+     * so `fields:["rel_path",...]` projection works on the flat layout.
+     */
+    rel_path: string;
+    /** Path of the parent element, or `null` for top-level entries. */
+    parent_path: string | null;
+    /** 0-based depth (top-level entries have depth 0). */
+    depth: number;
+    /** Element type string (the `type` field on the YT node, "" if missing). */
+    element_type: string;
+    /**
+     * True iff the node carries a source-binding. N-01 (Audit v4):
+     * derived via the same `hasSourceBinding` SSoT element_list uses,
+     * or an explicit REST-plugin boolean when present.
+     */
+    has_binding: boolean;
+    /** Element props (passthrough; `undefined` when the node has none). */
+    props?: Record<string, unknown>;
+    /**
+     * Children intentionally absent — see file-header. Kept in the type
+     * so consumers can confirm the field is `undefined` rather than
+     * assume it exists.
+     */
+    children?: undefined;
+    /**
+     * Allow passthrough of any other top-level fields the REST plugin
+     * may add in future (e.g. `label`, `has_binding`, `name`). The
+     * walker preserves these verbatim so projection via `pickFields`
+     * downstream stays meaningful.
+     */
+    [extra: string]: unknown;
+}
+/**
+ * Flatten a YOOtheme nested layout tree.
+ *
+ * @param layout - The top-level layout container. Accepts either an
+ *   object keyed by stringified indices ("0","1",…) or an actual array.
+ *   Returns `[]` for empty input or anything that isn't iterable.
+ */
+export declare function flattenLayout(layout: unknown): FlatElement[];
+//# sourceMappingURL=layout-flatten.d.ts.map

package/dist/tools/layout-flatten.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"layout-flatten.d.ts","sourceRoot":"","sources":["../../src/tools/layout-flatten.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAIH,uDAAuD;AACvD,MAAM,WAAW,WAAW;IACxB,4DAA4D;IAC5D,IAAI,EAAE,MAAM,CAAC;IACb;;;;OAIG;IACH,QAAQ,EAAE,MAAM,CAAC;IACjB,mEAAmE;IACnE,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,sDAAsD;IACtD,KAAK,EAAE,MAAM,CAAC;IACd,4EAA4E;IAC5E,YAAY,EAAE,MAAM,CAAC;IACrB;;;;OAIG;IACH,WAAW,EAAE,OAAO,CAAC;IACrB,uEAAuE;IACvE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC;;;;OAIG;IACH,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB;;;;;OAKG;IACH,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;CAC5B;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,OAAO,GAAG,WAAW,EAAE,CAmB5D"}

package/dist/tools/layout-flatten.js

@@ -0,0 +1,107 @@
+/**
+ * Layout-flatten helper — depth-first walk that turns a nested YOOtheme
+ * layout tree into a flat array of `{ path, parent_path, depth,
+ * element_type, props }` records.
+ *
+ * Used by `yootheme_builder_page_get_layout` when called with
+ * `flat: true`. Per Design §4.4.1:
+ *
+ *   - Walk-order: depth-first, parent BEFORE children, original child
+ *     order preserved (no sort).
+ *   - `path` uses JSON-Pointer-style notation rooted at `/layout/<key>`
+ *     and descends via `/children/<index>` segments. The root segments
+ *     mirror the keys the REST plugin produces (string keys "0","1",…
+ *     when the top-level layout is an object; numeric indices when it
+ *     happens to be an array).
+ *   - `parent_path` is `null` for top-level entries.
+ *   - The emitted record's `children` field is REMOVED — children become
+ *     their own emitted entries with their own `path`. Keeping the nested
+ *     array would defeat the purpose of flattening.
+ *   - Non-object children are skipped silently but their index is
+ *     preserved in the parent's child-numbering (the next valid sibling
+ *     keeps its original index).
+ *
+ * Pure function — no I/O, no client dependency. Test-covered in
+ * `tests/tools/layout-flatten.test.ts`.
+ *
+ * @license MIT
+ */
+import { hasSourceBinding } from './format/elements-format.js';
+/**
+ * Flatten a YOOtheme nested layout tree.
+ *
+ * @param layout - The top-level layout container. Accepts either an
+ *   object keyed by stringified indices ("0","1",…) or an actual array.
+ *   Returns `[]` for empty input or anything that isn't iterable.
+ */
+export function flattenLayout(layout) {
+    const out = [];
+    if (layout === null || typeof layout !== 'object') {
+        return out;
+    }
+    // Iterate top-level entries in insertion order. For arrays this gives
+    // numeric indices; for objects keyed by "0","1",… it gives the same
+    // ordering YT serialises.
+    const entries = Array.isArray(layout)
+        ? layout.map((v, i) => [String(i), v])
+        : Object.entries(layout);
+    for (const [key, node] of entries) {
+        walk(node, `/layout/${key}`, null, 0, out);
+    }
+    return out;
+}
+/**
+ * Depth-first walker. Emits the node, then recurses into its children.
+ * Skips non-object nodes silently while preserving child-index numbering.
+ */
+function walk(node, path, parentPath, depth, out) {
+    if (node === null || typeof node !== 'object' || Array.isArray(node)) {
+        return;
+    }
+    const obj = node;
+    const elementType = typeof obj.type === 'string' ? obj.type : '';
+    const props = obj.props !== null && typeof obj.props === 'object' && !Array.isArray(obj.props)
+        ? obj.props
+        : undefined;
+    // N-01: derive the projection-relevant fields up-front so a
+    // `fields:["rel_path","has_binding",...]` projection finds them.
+    // `rel_path` strips the `/layout` prefix; `has_binding` honours an
+    // explicit REST boolean else derives via the shared SSoT.
+    const relPath = path.replace(/^\/layout/, '') || '/';
+    const hasBinding = typeof obj.has_binding === 'boolean'
+        ? obj.has_binding
+        : hasSourceBinding(obj);
+    // Build a passthrough shallow-clone WITHOUT the children field. We
+    // copy every other top-level key so future REST additions (label,
+    // …) survive the flatten.
+    const emitted = {
+        path,
+        rel_path: relPath,
+        parent_path: parentPath,
+        depth,
+        element_type: elementType,
+        has_binding: hasBinding,
+    };
+    for (const [k, v] of Object.entries(obj)) {
+        if (k === 'children' || k === 'type' || k === 'props' || k === 'has_binding') {
+            continue;
+        }
+        emitted[k] = v;
+    }
+    if (props !== undefined)
+        emitted.props = props;
+    out.push(emitted);
+    const children = obj.children;
+    if (Array.isArray(children)) {
+        for (let i = 0; i < children.length; i++) {
+            const child = children[i];
+            if (child === null || typeof child !== 'object' || Array.isArray(child)) {
+                // Skip non-object children; their index is preserved in
+                // the next sibling's path.
+                continue;
+            }
+            walk(child, `${path}/children/${String(i)}`, path, depth + 1, out);
+        }
+    }
+}
+//# sourceMappingURL=layout-flatten.js.map

package/dist/tools/layout-flatten.js.map

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

package/dist/tools/multi-items/builders.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Multi-Items tool builders.
+ *
+ * Surfaces two tools that operate on the YT-Pro Multi-Items binding
+ * pattern (container ↔ `*_item` pairings — see
+ * `./item-container-map.ts`):
+ *
+ *   yootheme_builder_inspect_multi_items_binding
+ *     → Reports the binding level (none/container/item), the matching
+ *       container/item pair, and whether legacy implode directives are
+ *       attached. Surfaces a `recommended_fix` when the binding sits on
+ *       the container level.
+ *
+ *   yootheme_builder_clean_implode_directives
+ *     → Removes every `props.source.props.*.implode` directive from
+ *       the addressed element. Returns the audit log + new etag.
+ *
+ * @license MIT
+ */
+import type { ClientPool } from '../../sites/client-pool.js';
+import { type AnyToolDefinition } from '../tool-builder.js';
+export declare function buildMultiItemsTools(pool: ClientPool): readonly AnyToolDefinition[];
+//# sourceMappingURL=builders.d.ts.map

package/dist/tools/multi-items/builders.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"builders.d.ts","sourceRoot":"","sources":["../../../src/tools/multi-items/builders.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAIH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAG7D,OAAO,EAKH,KAAK,iBAAiB,EACzB,MAAM,oBAAoB,CAAC;AAY5B,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,UAAU,GAAG,SAAS,iBAAiB,EAAE,CAgEnF"}