@wootsup/yt-builder-mcp 1.0.1 → 1.1.0

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":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAyC/D;;;;;;GAMG;AACH,MAAM,UAAU,aAAa,CAAC,MAAe;IACzC,MAAM,GAAG,GAAkB,EAAE,CAAC;IAE9B,IAAI,MAAM,KAAK,IAAI,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;QAChD,OAAO,GAAG,CAAC;IACf,CAAC;IAED,sEAAsE;IACtE,oEAAoE;IACpE,0BAA0B;IAC1B,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;QACjC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAqB,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QACzD,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,MAAiC,CAAC,CAAC;IAExD,KAAK,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,OAAO,EAAE,CAAC;QAChC,IAAI,CAAC,IAAI,EAAE,WAAW,GAAG,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC;IAC/C,CAAC;IAED,OAAO,GAAG,CAAC;AACf,CAAC;AAED;;;GAGG;AACH,SAAS,IAAI,CACT,IAAa,EACb,IAAY,EACZ,UAAyB,EACzB,KAAa,EACb,GAAkB;IAElB,IAAI,IAAI,KAAK,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QACnE,OAAO;IACX,CAAC;IACD,MAAM,GAAG,GAAG,IAA+B,CAAC;IAE5C,MAAM,WAAW,GAAG,OAAO,GAAG,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;IACjE,MAAM,KAAK,GACP,GAAG,CAAC,KAAK,KAAK,IAAI,IAAI,OAAO,GAAG,CAAC,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC;QAC5E,CAAC,CAAE,GAAG,CAAC,KAAiC;QACxC,CAAC,CAAC,SAAS,CAAC;IAEpB,4DAA4D;IAC5D,iEAAiE;IACjE,mEAAmE;IACnE,0DAA0D;IAC1D,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC,IAAI,GAAG,CAAC;IACrD,MAAM,UAAU,GACZ,OAAO,GAAG,CAAC,WAAW,KAAK,SAAS;QAChC,CAAC,CAAC,GAAG,CAAC,WAAW;QACjB,CAAC,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC;IAEhC,mEAAmE;IACnE,kEAAkE;IAClE,0BAA0B;IAC1B,MAAM,OAAO,GAAgB;QACzB,IAAI;QACJ,QAAQ,EAAE,OAAO;QACjB,WAAW,EAAE,UAAU;QACvB,KAAK;QACL,YAAY,EAAE,WAAW;QACzB,WAAW,EAAE,UAAU;KAC1B,CAAC;IACF,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QACvC,IAAI,CAAC,KAAK,UAAU,IAAI,CAAC,KAAK,MAAM,IAAI,CAAC,KAAK,OAAO,IAAI,CAAC,KAAK,aAAa,EAAE,CAAC;YAC3E,SAAS;QACb,CAAC;QACD,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IACnB,CAAC;IACD,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,CAAC,KAAK,GAAG,KAAK,CAAC;IAC/C,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAElB,MAAM,QAAQ,GAAG,GAAG,CAAC,QAAQ,CAAC;IAC9B,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC1B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACvC,MAAM,KAAK,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;YAC1B,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;gBACtE,wDAAwD;gBACxD,2BAA2B;gBAC3B,SAAS;YACb,CAAC;YACD,IAAI,CAAC,KAAK,EAAE,GAAG,IAAI,aAAa,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,IAAI,EAAE,KAAK,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC;QACvE,CAAC;IACL,CAAC;AACL,CAAC"}

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;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAG7D,OAAO,EAKH,KAAK,iBAAiB,EACzB,MAAM,oBAAoB,CAAC;AAW5B,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,UAAU,GAAG,SAAS,iBAAiB,EAAE,CAgDnF"}

package/dist/tools/multi-items/builders.js

@@ -0,0 +1,69 @@
+/**
+ * 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 { withSiteRetry } from '../pool-resolve-helper.js';
+import { ELEMENT_PATH, ETAG, SITE_ID_SCHEMA, TEMPLATE_ID } from '../shared-schemas.js';
+import { defineTool, mutating, readOnly, withSiteMeta, } from '../tool-builder.js';
+import { CLEAN_IMPLODE_OUTPUT_SCHEMA, handleCleanImplodeDirectives, } from './clean-implode-handler.js';
+import { INSPECT_MULTI_ITEMS_OUTPUT_SCHEMA, handleInspectMultiItemsBinding, } from './inspect-handler.js';
+export function buildMultiItemsTools(pool) {
+    // W6.3 — per-handler resolveSiteOrError. The handlers consume a
+    // single-field `MultiItemsHandlerDeps`, so we synthesise it inline
+    // with the resolved client.
+    return [
+        defineTool({
+            name: 'yootheme_builder_inspect_multi_items_binding',
+            description: 'Reports Multi-Items binding state: container/item pair (grid↔grid_item, ' +
+                'slideshow↔slideshow_item, …), current binding level (none|container|item), ' +
+                'and a recommended_fix when the binding sits on the container instead of the child. ' +
+                'Operates on the default site unless site_id is provided.',
+            inputSchema: {
+                site_id: SITE_ID_SCHEMA,
+                template_id: TEMPLATE_ID,
+                element_path: ELEMENT_PATH,
+            },
+            outputSchema: INSPECT_MULTI_ITEMS_OUTPUT_SCHEMA,
+            annotations: readOnly('Inspect Multi-Items Binding'),
+            handler: async ({ site_id, ...rest }) => withSiteRetry(pool, site_id, async (client, site) => {
+                const deps = { client };
+                return withSiteMeta(await handleInspectMultiItemsBinding(deps, rest), site);
+            }),
+        }),
+        defineTool({
+            name: 'yootheme_builder_clean_implode_directives',
+            description: 'Strips `props.source.props.*.implode` directives from an element binding. ' +
+                'Returns audit log + new ETag. Idempotent (cleaned_count: 0 when nothing to ' +
+                'remove). Requires ETag. ' +
+                'Operates on the default site unless site_id is provided.',
+            inputSchema: {
+                site_id: SITE_ID_SCHEMA,
+                template_id: TEMPLATE_ID,
+                element_path: ELEMENT_PATH,
+                etag: ETAG,
+            },
+            outputSchema: CLEAN_IMPLODE_OUTPUT_SCHEMA,
+            annotations: mutating('Clean Implode Directives'),
+            handler: async ({ site_id, ...rest }) => withSiteRetry(pool, site_id, async (client, site) => {
+                const deps = { client };
+                return withSiteMeta(await handleCleanImplodeDirectives(deps, rest), site);
+            }),
+        }),
+    ];
+}
+//# sourceMappingURL=builders.js.map

package/dist/tools/multi-items/builders.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"builders.js","sourceRoot":"","sources":["../../../src/tools/multi-items/builders.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAGH,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,IAAI,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACvF,OAAO,EACH,UAAU,EACV,QAAQ,EACR,QAAQ,EACR,YAAY,GAEf,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACH,2BAA2B,EAC3B,4BAA4B,GAC/B,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACH,iCAAiC,EACjC,8BAA8B,GAEjC,MAAM,sBAAsB,CAAC;AAE9B,MAAM,UAAU,oBAAoB,CAAC,IAAgB;IACjD,gEAAgE;IAChE,mEAAmE;IACnE,4BAA4B;IAC5B,OAAO;QACH,UAAU,CAAC;YACP,IAAI,EAAE,8CAA8C;YACpD,WAAW,EACP,0EAA0E;gBAC1E,6EAA6E;gBAC7E,qFAAqF;gBACrF,0DAA0D;YAC9D,WAAW,EAAE;gBACT,OAAO,EAAE,cAAc;gBACvB,WAAW,EAAE,WAAW;gBACxB,YAAY,EAAE,YAAY;aAC7B;YACD,YAAY,EAAE,iCAAiC;YAC/C,WAAW,EAAE,QAAQ,CAAC,6BAA6B,CAAC;YACpD,OAAO,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,GAAG,IAAI,EAAE,EAAE,EAAE,CACpC,aAAa,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE;gBAChD,MAAM,IAAI,GAA0B,EAAE,MAAM,EAAE,CAAC;gBAC/C,OAAO,YAAY,CAAC,MAAM,8BAA8B,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,IAAI,CAAC,CAAC;YAChF,CAAC,CAAC;SACT,CAAC;QAEF,UAAU,CAAC;YACP,IAAI,EAAE,2CAA2C;YACjD,WAAW,EACP,4EAA4E;gBAC5E,6EAA6E;gBAC7E,0BAA0B;gBAC1B,0DAA0D;YAC9D,WAAW,EAAE;gBACT,OAAO,EAAE,cAAc;gBACvB,WAAW,EAAE,WAAW;gBACxB,YAAY,EAAE,YAAY;gBAC1B,IAAI,EAAE,IAAI;aACb;YACD,YAAY,EAAE,2BAA2B;YACzC,WAAW,EAAE,QAAQ,CAAC,0BAA0B,CAAC;YACjD,OAAO,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,GAAG,IAAI,EAAE,EAAE,EAAE,CACpC,aAAa,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE;gBAChD,MAAM,IAAI,GAA0B,EAAE,MAAM,EAAE,CAAC;gBAC/C,OAAO,YAAY,CAAC,MAAM,4BAA4B,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,IAAI,CAAC,CAAC;YAC9E,CAAC,CAAC;SACT,CAAC;KACL,CAAC;AACN,CAAC"}

package/dist/tools/multi-items/clean-implode-handler.d.ts

@@ -0,0 +1,28 @@
+/**
+ * `clean_implode_directives` handler — strip `props.source.props.*.implode`
+ * directives from an element binding via REST round-trip.
+ *
+ * @license MIT
+ */
+import { z } from 'zod';
+import { type RestClient } from '../../client.js';
+import { type ToolResult } from '../tool-builder.js';
+export declare const CLEAN_IMPLODE_OUTPUT_SCHEMA: z.ZodObject<{
+    template_id: z.ZodString;
+    element_path: z.ZodString;
+    cleaned_count: z.ZodNumber;
+    removed_directives: z.ZodArray<z.ZodObject<{
+        prop_name: z.ZodString;
+        directive: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    }, z.core.$strip>>;
+    new_etag: z.ZodString;
+}, z.core.$strip>;
+export interface CleanImplodeHandlerDeps {
+    readonly client: RestClient;
+}
+export declare function handleCleanImplodeDirectives({ client }: CleanImplodeHandlerDeps, { template_id, element_path, etag, }: {
+    template_id: string;
+    element_path: string;
+    etag: string;
+}): Promise<ToolResult>;
+//# sourceMappingURL=clean-implode-handler.d.ts.map

package/dist/tools/multi-items/clean-implode-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clean-implode-handler.d.ts","sourceRoot":"","sources":["../../../src/tools/multi-items/clean-implode-handler.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAqB,KAAK,UAAU,EAAE,MAAM,iBAAiB,CAAC;AACrE,OAAO,EAA6C,KAAK,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAEhG,eAAO,MAAM,2BAA2B;;;;;;;;;iBAWtC,CAAC;AAEH,MAAM,WAAW,uBAAuB;IACpC,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;CAC/B;AAED,wBAAsB,4BAA4B,CAC9C,EAAE,MAAM,EAAE,EAAE,uBAAuB,EACnC,EACI,WAAW,EACX,YAAY,EACZ,IAAI,GACP,EAAE;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC/D,OAAO,CAAC,UAAU,CAAC,CAsBrB"}

package/dist/tools/multi-items/clean-implode-handler.js

@@ -0,0 +1,40 @@
+/**
+ * `clean_implode_directives` handler — strip `props.source.props.*.implode`
+ * directives from an element binding via REST round-trip.
+ *
+ * @license MIT
+ */
+import { z } from 'zod';
+import { encodeElementPath } from '../../client.js';
+import { errorResult, jsonResult, structuredResult } from '../tool-builder.js';
+export const CLEAN_IMPLODE_OUTPUT_SCHEMA = z.object({
+    template_id: z.string(),
+    element_path: z.string(),
+    cleaned_count: z.number(),
+    removed_directives: z.array(z.object({
+        prop_name: z.string(),
+        directive: z.record(z.string(), z.unknown()),
+    })),
+    new_etag: z.string(),
+});
+export async function handleCleanImplodeDirectives({ client }, { template_id, element_path, etag, }) {
+    const encoded = encodeElementPath(element_path);
+    try {
+        const data = await client.post(`/pages/${encodeURIComponent(template_id)}/elements/${encoded}/multi-items/clean-implode`, { body: {}, etag });
+        // The REST endpoint returns the canonical CLEAN_IMPLODE_OUTPUT_SCHEMA
+        // shape ({template_id, element_path, cleaned_count, removed_directives,
+        // new_etag}) — pass it through as structuredContent so the declared
+        // outputSchema is satisfied (a tool with an outputSchema MUST emit
+        // structuredContent, else the MCP SDK rejects with -32602).
+        return structuredResult(jsonResult(data), data);
+    }
+    catch (e) {
+        return errorResult({
+            error: e,
+            context: { template_id, element_path },
+            hint: 'On 412 refresh via yootheme_builder_get_etag and retry. On 404 verify the ' +
+                'element_path via yootheme_builder_element_list.',
+        });
+    }
+}
+//# sourceMappingURL=clean-implode-handler.js.map

package/dist/tools/multi-items/clean-implode-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"clean-implode-handler.js","sourceRoot":"","sources":["../../../src/tools/multi-items/clean-implode-handler.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,iBAAiB,EAAmB,MAAM,iBAAiB,CAAC;AACrE,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,gBAAgB,EAAmB,MAAM,oBAAoB,CAAC;AAEhG,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,CAAC,MAAM,CAAC;IAChD,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;IACvB,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE;IACxB,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE;IACzB,kBAAkB,EAAE,CAAC,CAAC,KAAK,CACvB,CAAC,CAAC,MAAM,CAAC;QACL,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;QACrB,SAAS,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC;KAC/C,CAAC,CACL;IACD,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;CACvB,CAAC,CAAC;AAMH,MAAM,CAAC,KAAK,UAAU,4BAA4B,CAC9C,EAAE,MAAM,EAA2B,EACnC,EACI,WAAW,EACX,YAAY,EACZ,IAAI,GACsD;IAE9D,MAAM,OAAO,GAAG,iBAAiB,CAAC,YAAY,CAAC,CAAC;IAChD,IAAI,CAAC;QACD,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,IAAI,CAC1B,UAAU,kBAAkB,CAAC,WAAW,CAAC,aAAa,OAAO,4BAA4B,EACzF,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,CACrB,CAAC;QACF,sEAAsE;QACtE,wEAAwE;QACxE,oEAAoE;QACpE,mEAAmE;QACnE,4DAA4D;QAC5D,OAAO,gBAAgB,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,CAAC;IACpD,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACT,OAAO,WAAW,CAAC;YACf,KAAK,EAAE,CAAC;YACR,OAAO,EAAE,EAAE,WAAW,EAAE,YAAY,EAAE;YACtC,IAAI,EACA,4EAA4E;gBAC5E,iDAAiD;SACxD,CAAC,CAAC;IACP,CAAC;AACL,CAAC"}

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

@@ -0,0 +1,18 @@
+/**
+ * Multi-Items tool barrel — public entry-point for the YT-Pro
+ * Multi-Items binding pattern tools.
+ *
+ *   yootheme_builder_inspect_multi_items_binding
+ *     → Report the Multi-Items binding state for an element.
+ *
+ *   yootheme_builder_clean_implode_directives
+ *     → Remove legacy implode directives from an element binding.
+ *
+ * The canonical container ↔ item map lives in `./item-container-map.ts`
+ * (mirror of `WootsUp\BuilderMcp\Elements\ItemContainerMap`).
+ *
+ * @license MIT
+ */
+export { buildMultiItemsTools } from './builders.js';
+export { ITEM_CHILDREN_OF_CONTAINER, containerOf, isContainer, isItem, itemOf, } from './item-container-map.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/multi-items/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EACH,0BAA0B,EAC1B,WAAW,EACX,WAAW,EACX,MAAM,EACN,MAAM,GACT,MAAM,yBAAyB,CAAC"}

package/dist/tools/multi-items/index.js

@@ -0,0 +1,18 @@
+/**
+ * Multi-Items tool barrel — public entry-point for the YT-Pro
+ * Multi-Items binding pattern tools.
+ *
+ *   yootheme_builder_inspect_multi_items_binding
+ *     → Report the Multi-Items binding state for an element.
+ *
+ *   yootheme_builder_clean_implode_directives
+ *     → Remove legacy implode directives from an element binding.
+ *
+ * The canonical container ↔ item map lives in `./item-container-map.ts`
+ * (mirror of `WootsUp\BuilderMcp\Elements\ItemContainerMap`).
+ *
+ * @license MIT
+ */
+export { buildMultiItemsTools } from './builders.js';
+export { ITEM_CHILDREN_OF_CONTAINER, containerOf, isContainer, isItem, itemOf, } from './item-container-map.js';
+//# sourceMappingURL=index.js.map

package/dist/tools/multi-items/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/multi-items/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EACH,0BAA0B,EAC1B,WAAW,EACX,WAAW,EACX,MAAM,EACN,MAAM,GACT,MAAM,yBAAyB,CAAC"}

package/dist/tools/multi-items/inspect-handler.d.ts

@@ -0,0 +1,41 @@
+/**
+ * `inspect_multi_items_binding` handler — surfaces Multi-Items binding
+ * state on an element via REST round-trip.
+ *
+ * Companion of the PHP `MultiItemsInspector` — see
+ * src/modules/builder-source-binding/src/MultiItemsInspector.php
+ * for the report shape.
+ *
+ * @license MIT
+ */
+import { z } from 'zod';
+import { type RestClient } from '../../client.js';
+import { type ToolResult } from '../tool-builder.js';
+export declare const INSPECT_MULTI_ITEMS_OUTPUT_SCHEMA: z.ZodObject<{
+    template_id: z.ZodString;
+    report: z.ZodObject<{
+        element_path: z.ZodString;
+        element_type: z.ZodString;
+        is_container: z.ZodBoolean;
+        is_item: z.ZodBoolean;
+        container_type: z.ZodNullable<z.ZodString>;
+        item_type: z.ZodNullable<z.ZodString>;
+        current_binding_level: z.ZodEnum<{
+            none: "none";
+            container: "container";
+            item: "item";
+        }>;
+        has_implode_directives: z.ZodBoolean;
+        warning: z.ZodOptional<z.ZodString>;
+        recommended_fix: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    etag: z.ZodString;
+}, z.core.$strip>;
+export interface MultiItemsHandlerDeps {
+    readonly client: RestClient;
+}
+export declare function handleInspectMultiItemsBinding({ client }: MultiItemsHandlerDeps, { template_id, element_path }: {
+    template_id: string;
+    element_path: string;
+}): Promise<ToolResult>;
+//# sourceMappingURL=inspect-handler.d.ts.map

package/dist/tools/multi-items/inspect-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inspect-handler.d.ts","sourceRoot":"","sources":["../../../src/tools/multi-items/inspect-handler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAqB,KAAK,UAAU,EAAE,MAAM,iBAAiB,CAAC;AACrE,OAAO,EAA6C,KAAK,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAEhG,eAAO,MAAM,iCAAiC;;;;;;;;;;;;;;;;;;;iBAe5C,CAAC;AAEH,MAAM,WAAW,qBAAqB;IAClC,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;CAC/B;AAED,wBAAsB,8BAA8B,CAChD,EAAE,MAAM,EAAE,EAAE,qBAAqB,EACjC,EAAE,WAAW,EAAE,YAAY,EAAE,EAAE;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,GAC7E,OAAO,CAAC,UAAU,CAAC,CAqBrB"}

package/dist/tools/multi-items/inspect-handler.js

@@ -0,0 +1,50 @@
+/**
+ * `inspect_multi_items_binding` handler — surfaces Multi-Items binding
+ * state on an element via REST round-trip.
+ *
+ * Companion of the PHP `MultiItemsInspector` — see
+ * src/modules/builder-source-binding/src/MultiItemsInspector.php
+ * for the report shape.
+ *
+ * @license MIT
+ */
+import { z } from 'zod';
+import { encodeElementPath } from '../../client.js';
+import { errorResult, jsonResult, structuredResult } from '../tool-builder.js';
+export const INSPECT_MULTI_ITEMS_OUTPUT_SCHEMA = z.object({
+    template_id: z.string(),
+    report: z.object({
+        element_path: z.string(),
+        element_type: z.string(),
+        is_container: z.boolean(),
+        is_item: z.boolean(),
+        container_type: z.string().nullable(),
+        item_type: z.string().nullable(),
+        current_binding_level: z.enum(['none', 'container', 'item']),
+        has_implode_directives: z.boolean(),
+        warning: z.string().optional(),
+        recommended_fix: z.string().optional(),
+    }),
+    etag: z.string(),
+});
+export async function handleInspectMultiItemsBinding({ client }, { template_id, element_path }) {
+    const encoded = encodeElementPath(element_path);
+    try {
+        const data = await client.get(`/pages/${encodeURIComponent(template_id)}/elements/${encoded}/multi-items/inspect`);
+        // The REST endpoint already returns the canonical
+        // {template_id, report, etag} shape — pass it through as
+        // structuredContent so the declared outputSchema is satisfied
+        // (a tool with an outputSchema MUST emit structuredContent, else
+        // the MCP SDK rejects the call with -32602).
+        return structuredResult(jsonResult(data), data);
+    }
+    catch (e) {
+        return errorResult({
+            error: e,
+            context: { template_id, element_path },
+            hint: 'Verify element_path via yootheme_builder_element_list. Paths are JSON-Pointer ' +
+                'style ("/templates/<id>/layout/children/0").',
+        });
+    }
+}
+//# sourceMappingURL=inspect-handler.js.map

package/dist/tools/multi-items/inspect-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inspect-handler.js","sourceRoot":"","sources":["../../../src/tools/multi-items/inspect-handler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,iBAAiB,EAAmB,MAAM,iBAAiB,CAAC;AACrE,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,gBAAgB,EAAmB,MAAM,oBAAoB,CAAC;AAEhG,MAAM,CAAC,MAAM,iCAAiC,GAAG,CAAC,CAAC,MAAM,CAAC;IACtD,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;IACvB,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;QACb,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE;QACxB,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE;QACxB,YAAY,EAAE,CAAC,CAAC,OAAO,EAAE;QACzB,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE;QACpB,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QACrC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QAChC,qBAAqB,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,WAAW,EAAE,MAAM,CAAC,CAAC;QAC5D,sBAAsB,EAAE,CAAC,CAAC,OAAO,EAAE;QACnC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QAC9B,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;KACzC,CAAC;IACF,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;CACnB,CAAC,CAAC;AAMH,MAAM,CAAC,KAAK,UAAU,8BAA8B,CAChD,EAAE,MAAM,EAAyB,EACjC,EAAE,WAAW,EAAE,YAAY,EAAiD;IAE5E,MAAM,OAAO,GAAG,iBAAiB,CAAC,YAAY,CAAC,CAAC;IAChD,IAAI,CAAC;QACD,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,GAAG,CACzB,UAAU,kBAAkB,CAAC,WAAW,CAAC,aAAa,OAAO,sBAAsB,CACtF,CAAC;QACF,kDAAkD;QAClD,yDAAyD;QACzD,8DAA8D;QAC9D,iEAAiE;QACjE,6CAA6C;QAC7C,OAAO,gBAAgB,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,CAAC;IACpD,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACT,OAAO,WAAW,CAAC;YACf,KAAK,EAAE,CAAC;YACR,OAAO,EAAE,EAAE,WAAW,EAAE,YAAY,EAAE;YACtC,IAAI,EACA,gFAAgF;gBAChF,8CAA8C;SACrD,CAAC,CAAC;IACP,CAAC;AACL,CAAC"}

package/dist/tools/multi-items/item-container-map.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Multi-Items pattern — TypeScript mirror of the PHP
+ * `WootsUp\BuilderMcp\Elements\ItemContainerMap` constant.
+ *
+ * YT-Pro 4.5.33+ implements `SourceTransform::repeatSource` which
+ * clones the *source-bearing element* N-times as siblings inside its
+ * parent. For "1 container with N children" the binding MUST live on
+ * the `*_item` child element, NEVER on the container.
+ *
+ * The PHP and TS maps MUST stay in lock-step — both files carry a
+ * pin-test that fails if the canonical pairings drift.
+ *
+ * @license MIT
+ */
+/**
+ * Live-verified against `themes/yootheme/packages/builder/elements/
+ * *_item/` on YT-Pro 4.5.33 (dev server, 2026-05-22). 16 pairs total.
+ *
+ * NB: There is NO `slider` / `slider_item` pair on YT-Pro 4.5.33 — the
+ * YT slider/carousel widgets render via `slideshow`, `overlay-slider`,
+ * and `panel-slider`.
+ */
+export declare const ITEM_CHILDREN_OF_CONTAINER: Readonly<Record<string, string>>;
+/**
+ * Surface the `*_item` child type for a known container, or null when
+ * the input is not a known multi-item container.
+ */
+export declare function itemOf(containerType: string): string | null;
+/**
+ * Surface the container type for a known `*_item`, or null otherwise.
+ */
+export declare function containerOf(itemType: string): string | null;
+/**
+ * `true` when $type is one of the multi-item-capable containers.
+ */
+export declare function isContainer(type: string): boolean;
+/**
+ * `true` when $type is a `*_item` child of a multi-item container.
+ */
+export declare function isItem(type: string): boolean;
+//# sourceMappingURL=item-container-map.d.ts.map

package/dist/tools/multi-items/item-container-map.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"item-container-map.d.ts","sourceRoot":"","sources":["../../../src/tools/multi-items/item-container-map.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH;;;;;;;GAOG;AACH,eAAO,MAAM,0BAA0B,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAiBtE,CAAC;AAEH;;;GAGG;AACH,wBAAgB,MAAM,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAI3D;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAO3D;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEjD;AAED;;GAEG;AACH,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAE5C"}

package/dist/tools/multi-items/item-container-map.js

@@ -0,0 +1,73 @@
+/**
+ * Multi-Items pattern — TypeScript mirror of the PHP
+ * `WootsUp\BuilderMcp\Elements\ItemContainerMap` constant.
+ *
+ * YT-Pro 4.5.33+ implements `SourceTransform::repeatSource` which
+ * clones the *source-bearing element* N-times as siblings inside its
+ * parent. For "1 container with N children" the binding MUST live on
+ * the `*_item` child element, NEVER on the container.
+ *
+ * The PHP and TS maps MUST stay in lock-step — both files carry a
+ * pin-test that fails if the canonical pairings drift.
+ *
+ * @license MIT
+ */
+/**
+ * Live-verified against `themes/yootheme/packages/builder/elements/
+ * *_item/` on YT-Pro 4.5.33 (dev server, 2026-05-22). 16 pairs total.
+ *
+ * NB: There is NO `slider` / `slider_item` pair on YT-Pro 4.5.33 — the
+ * YT slider/carousel widgets render via `slideshow`, `overlay-slider`,
+ * and `panel-slider`.
+ */
+export const ITEM_CHILDREN_OF_CONTAINER = Object.freeze({
+    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',
+});
+/**
+ * Surface the `*_item` child type for a known container, or null when
+ * the input is not a known multi-item container.
+ */
+export function itemOf(containerType) {
+    return Object.prototype.hasOwnProperty.call(ITEM_CHILDREN_OF_CONTAINER, containerType)
+        ? ITEM_CHILDREN_OF_CONTAINER[containerType]
+        : null;
+}
+/**
+ * Surface the container type for a known `*_item`, or null otherwise.
+ */
+export function containerOf(itemType) {
+    for (const [container, item] of Object.entries(ITEM_CHILDREN_OF_CONTAINER)) {
+        if (item === itemType) {
+            return container;
+        }
+    }
+    return null;
+}
+/**
+ * `true` when $type is one of the multi-item-capable containers.
+ */
+export function isContainer(type) {
+    return Object.prototype.hasOwnProperty.call(ITEM_CHILDREN_OF_CONTAINER, type);
+}
+/**
+ * `true` when $type is a `*_item` child of a multi-item container.
+ */
+export function isItem(type) {
+    return Object.values(ITEM_CHILDREN_OF_CONTAINER).includes(type);
+}
+//# sourceMappingURL=item-container-map.js.map

package/dist/tools/multi-items/item-container-map.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"item-container-map.js","sourceRoot":"","sources":["../../../src/tools/multi-items/item-container-map.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAqC,MAAM,CAAC,MAAM,CAAC;IACtF,SAAS,EAAE,gBAAgB;IAC3B,MAAM,EAAE,aAAa;IACrB,gBAAgB,EAAE,uBAAuB;IACzC,OAAO,EAAE,cAAc;IACvB,IAAI,EAAE,WAAW;IACjB,IAAI,EAAE,WAAW;IACjB,GAAG,EAAE,UAAU;IACf,GAAG,EAAE,UAAU;IACf,gBAAgB,EAAE,qBAAqB;IACvC,cAAc,EAAE,mBAAmB;IACnC,OAAO,EAAE,cAAc;IACvB,SAAS,EAAE,gBAAgB;IAC3B,MAAM,EAAE,aAAa;IACrB,MAAM,EAAE,aAAa;IACrB,QAAQ,EAAE,eAAe;IACzB,KAAK,EAAE,YAAY;CACtB,CAAC,CAAC;AAEH;;;GAGG;AACH,MAAM,UAAU,MAAM,CAAC,aAAqB;IACxC,OAAO,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,0BAA0B,EAAE,aAAa,CAAC;QAClF,CAAC,CAAE,0BAA0B,CAAC,aAAa,CAAY;QACvD,CAAC,CAAC,IAAI,CAAC;AACf,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,QAAgB;IACxC,KAAK,MAAM,CAAC,SAAS,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,0BAA0B,CAAC,EAAE,CAAC;QACzE,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;YACpB,OAAO,SAAS,CAAC;QACrB,CAAC;IACL,CAAC;IACD,OAAO,IAAI,CAAC;AAChB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,IAAY;IACpC,OAAO,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,0BAA0B,EAAE,IAAI,CAAC,CAAC;AAClF,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,MAAM,CAAC,IAAY;IAC/B,OAAO,MAAM,CAAC,MAAM,CAAC,0BAA0B,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;AACpE,CAAC"}

package/dist/tools/pages/builders.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Page-tool builders — pure `defineTool` factory list.
+ *
+ * Split out of `src/tools/pages.ts` (Round-2 R2-A2-CRIT1). Handler
+ * bodies live in `./handlers-read.ts` (pages_list, page_get_layout,
+ * page_get_schema, get_etag) and `./handlers-write.ts` (page_save,
+ * page_publish — 3-phase progress contract).
+ *
+ * @license MIT
+ */
+import type { ClientPool } from '../../sites/client-pool.js';
+import { type AnyToolDefinition } from '../tool-builder.js';
+export declare function buildPagesTools(pool: ClientPool): readonly AnyToolDefinition[];
+//# sourceMappingURL=builders.d.ts.map

package/dist/tools/pages/builders.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"builders.d.ts","sourceRoot":"","sources":["../../../src/tools/pages/builders.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAI7D,OAAO,EAKH,KAAK,iBAAiB,EACzB,MAAM,oBAAoB,CAAC;AA6B5B,wBAAgB,eAAe,CAAC,IAAI,EAAE,UAAU,GAAG,SAAS,iBAAiB,EAAE,CA2H9E"}