@wootsup/yt-builder-mcp 1.1.0 → 1.1.5

package/dist/tools/layout-flatten.js

@@ -1,107 +0,0 @@
-/**
- * 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

@@ -1 +0,0 @@
-{"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

@@ -1,23 +0,0 @@
-/**
- * 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

@@ -1 +0,0 @@
-{"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

@@ -1,69 +0,0 @@
-/**
- * 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

@@ -1 +0,0 @@
-{"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

@@ -1,28 +0,0 @@
-/**
- * `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

@@ -1 +0,0 @@
-{"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

@@ -1,40 +0,0 @@
-/**
- * `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

@@ -1 +0,0 @@
-{"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

@@ -1,18 +0,0 @@
-/**
- * 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

@@ -1 +0,0 @@
-{"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

@@ -1,18 +0,0 @@
-/**
- * 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

@@ -1 +0,0 @@
-{"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

@@ -1,41 +0,0 @@
-/**
- * `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

@@ -1 +0,0 @@
-{"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

@@ -1,50 +0,0 @@
-/**
- * `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

@@ -1 +0,0 @@
-{"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

@@ -1,41 +0,0 @@
-/**
- * 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

@@ -1 +0,0 @@
-{"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

@@ -1,73 +0,0 @@
-/**
- * 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

@@ -1 +0,0 @@
-{"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

@@ -1,14 +0,0 @@
-/**
- * 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

@@ -1 +0,0 @@
-{"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"}