@wootsup/yt-builder-mcp 1.11.0 → 2.0.0

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

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

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

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

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

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

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

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

package/dist/tools/elements/schema-validation.d.ts

@@ -1,96 +0,0 @@
-/**
- * Finding B3 — schema-driven write validation for element props.
- *
- * The static `COMMON_PROP_TYPOS` map + `RESERVED_BINDING_KEYS` set in
- * `./handlers-write.ts` only catch a small fixed set of known mistakes. An
- * unknown prop key that is NOT in those tables slips through, the PHP backend
- * silently drops it, and the element renders empty with no signal to the agent
- * (Glöckle B3).
- *
- * This module adds a LIVE cross-check against the element-type's real schema:
- * the authoritative prop keys are `fields[].name` from
- * `GET /element-types/<type>/schema` — the same source the B1
- * `yootheme_builder_element_type_get_schema` tool surfaces (see
- * `../inspection.ts`). When the schema is KNOWN and a key is SURELY unknown,
- * the write is hard-rejected with a Levenshtein `did_you_mean` suggestion.
- *
- * Additive-before-breaking (the plugin is live 1.6.x): every uncertainty —
- * schema fetch failure, unknown schema shape, empty field list — falls THROUGH
- * to the prior behaviour. A schema fetch must NEVER crash the write.
- *
- * @license MIT
- */
-import type { RestClient } from '../../client.js';
-import { type ToolResult } from '../tool-builder.js';
-/**
- * MCP-side mirror of `Inspector::knownAcceptedButHiddenFields`
- * (`src/modules/builder-inspection/src/Inspector.php`). YT-Pro accepts these
- * props at runtime even though the UI-tab `fieldset` omits them. The PHP
- * `schema()` endpoint already post-merges them into `fields[]`, so a current
- * (1.6.x) plugin schema covers them. This mirror is DEFENSE-IN-DEPTH: against
- * an older plugin whose schema predates that merge, it keeps a genuinely
- * runtime-accepted prop from being false-positive hard-rejected. Keep in sync
- * with the PHP list (deliberately small + ground-truthed).
- */
-export declare const RUNTIME_ACCEPTED_HIDDEN_PROPS: Readonly<Record<string, readonly string[]>>;
-/**
- * Levenshtein edit distance — small pure function (keys are short). Index
- * access is guarded with `?? 0` to satisfy `noUncheckedIndexedAccess`; the
- * row is fully populated at every access so the fallback never fires.
- */
-export declare function levenshtein(a: string, b: string): number;
-/**
- * Closest real field name for `key`, or `undefined` when nothing is close
- * enough to suggest. Threshold (pinned in tests): `min(max(2, floor(0.4 ·
- * key.length)), key.length - 1)` — always tolerate 1–2 char typos and
- * proportionally more on longer keys, but a suggestion must be CLOSER than the
- * whole key length (M1 clamp), so a wholly-different word is never "suggested".
- */
-export declare function nearestFieldName(key: string, fields: readonly string[]): string | undefined;
-/**
- * PAGES_LIBRARY_MEDIA-27 — suggest real field names for an unknown key,
- * combining TWO signals so an obviously-intended key is never missed:
- *
- *   1. PREFIX / SUBSTRING match — a `title` key on a headline should suggest
- *      `title_element` / `title_style` / `title_color`, but char-Levenshtein to
- *      each of those is 6-8 (well over the typo threshold), so the pure-distance
- *      `nearestFieldName` returns nothing. When the unknown key (≥ 3 chars) is a
- *      prefix of — or a substring of — a real field, surface EVERY such field
- *      regardless of edit distance: these are the concrete keys the caller most
- *      likely meant.
- *   2. Levenshtein nearest — the general single/double-char typo case.
- *
- * Prefix matches lead (they are the strongest signal), then substring matches,
- * then the Levenshtein nearest if not already covered. De-duplicated, order
- * preserved. Returns `[]` when nothing is close.
- */
-export declare function suggestFieldNames(key: string, fields: readonly string[]): string[];
-/**
- * Pull `fields[].name` out of the element-type schema response. Mirrors the
- * envelope handling in `../inspection.ts`: the type schema nests under
- * `schema`, with a top-level fallback for older backends.
- *
- * @returns the field-name list (possibly empty), or `null` when the response
- *   carries no `fields` array at all (unknown schema shape → treat as unknown).
- */
-export declare function extractSchemaFieldNames(data: unknown): string[] | null;
-/**
- * Best-effort fetch of an element-type's real prop keys. ANY failure (network,
- * non-2xx, unknown shape) resolves to `null` so the caller falls through to the
- * prior behaviour — a schema fetch must never break the write.
- */
-export declare function fetchSchemaFieldNames(client: RestClient, elementType: string): Promise<string[] | null>;
-/**
- * Validate `props` against the element-type's LIVE schema. Returns an
- * `errorResult` ONLY when the schema is surely known (non-empty field list) AND
- * at least one prop key is surely unknown; otherwise `null` (pass / fall
- * through). Reserved binding keys are skipped here — their dedicated guard runs
- * first and keeps priority.
- */
-export declare function validatePropsAgainstLiveSchema(opts: {
-    readonly client: RestClient;
-    readonly elementType: string;
-    readonly props: Record<string, unknown> | undefined;
-    readonly reservedKeys: ReadonlySet<string>;
-}): Promise<ToolResult | null>;
-//# sourceMappingURL=schema-validation.d.ts.map

package/dist/tools/elements/schema-validation.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"schema-validation.d.ts","sourceRoot":"","sources":["../../../src/tools/elements/schema-validation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAe,KAAK,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAElE;;;;;;;;;GASG;AACH,eAAO,MAAM,6BAA6B,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC,CAErF,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAqBxD;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC5B,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,SAAS,MAAM,EAAE,GAC1B,MAAM,GAAG,SAAS,CAkBpB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,iBAAiB,CAC7B,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,SAAS,MAAM,EAAE,GAC1B,MAAM,EAAE,CAmBV;AAED;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,EAAE,GAAG,IAAI,CAiBtE;AAED;;;;GAIG;AACH,wBAAsB,qBAAqB,CACvC,MAAM,EAAE,UAAU,EAClB,WAAW,EAAE,MAAM,GACpB,OAAO,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,CAS1B;AAED;;;;;;GAMG;AACH,wBAAsB,8BAA8B,CAAC,IAAI,EAAE;IACvD,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAC5B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;IACpD,QAAQ,CAAC,YAAY,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;CAC9C,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAiE7B"}

package/dist/tools/elements/schema-validation.js

@@ -1,249 +0,0 @@
-/**
- * Finding B3 — schema-driven write validation for element props.
- *
- * The static `COMMON_PROP_TYPOS` map + `RESERVED_BINDING_KEYS` set in
- * `./handlers-write.ts` only catch a small fixed set of known mistakes. An
- * unknown prop key that is NOT in those tables slips through, the PHP backend
- * silently drops it, and the element renders empty with no signal to the agent
- * (Glöckle B3).
- *
- * This module adds a LIVE cross-check against the element-type's real schema:
- * the authoritative prop keys are `fields[].name` from
- * `GET /element-types/<type>/schema` — the same source the B1
- * `yootheme_builder_element_type_get_schema` tool surfaces (see
- * `../inspection.ts`). When the schema is KNOWN and a key is SURELY unknown,
- * the write is hard-rejected with a Levenshtein `did_you_mean` suggestion.
- *
- * Additive-before-breaking (the plugin is live 1.6.x): every uncertainty —
- * schema fetch failure, unknown schema shape, empty field list — falls THROUGH
- * to the prior behaviour. A schema fetch must NEVER crash the write.
- *
- * @license MIT
- */
-import { errorResult } from '../tool-builder.js';
-/**
- * MCP-side mirror of `Inspector::knownAcceptedButHiddenFields`
- * (`src/modules/builder-inspection/src/Inspector.php`). YT-Pro accepts these
- * props at runtime even though the UI-tab `fieldset` omits them. The PHP
- * `schema()` endpoint already post-merges them into `fields[]`, so a current
- * (1.6.x) plugin schema covers them. This mirror is DEFENSE-IN-DEPTH: against
- * an older plugin whose schema predates that merge, it keeps a genuinely
- * runtime-accepted prop from being false-positive hard-rejected. Keep in sync
- * with the PHP list (deliberately small + ground-truthed).
- */
-export const RUNTIME_ACCEPTED_HIDDEN_PROPS = {
-    button: ['content', 'link'],
-};
-/**
- * Levenshtein edit distance — small pure function (keys are short). Index
- * access is guarded with `?? 0` to satisfy `noUncheckedIndexedAccess`; the
- * row is fully populated at every access so the fallback never fires.
- */
-export function levenshtein(a, b) {
-    const m = a.length;
-    const n = b.length;
-    if (m === 0)
-        return n;
-    if (n === 0)
-        return m;
-    const row = [];
-    for (let j = 0; j <= n; j++)
-        row.push(j);
-    for (let i = 1; i <= m; i++) {
-        let prevDiag = row[0] ?? 0; // distance at (i-1, 0)
-        row[0] = i;
-        for (let j = 1; j <= n; j++) {
-            const above = row[j] ?? 0; // (i-1, j), before overwrite
-            const cost = a.charCodeAt(i - 1) === b.charCodeAt(j - 1) ? 0 : 1;
-            const deletion = above + 1;
-            const insertion = (row[j - 1] ?? 0) + 1;
-            const substitution = prevDiag + cost;
-            row[j] = Math.min(deletion, insertion, substitution);
-            prevDiag = above;
-        }
-    }
-    return row[n] ?? 0;
-}
-/**
- * Closest real field name for `key`, or `undefined` when nothing is close
- * enough to suggest. Threshold (pinned in tests): `min(max(2, floor(0.4 ·
- * key.length)), key.length - 1)` — always tolerate 1–2 char typos and
- * proportionally more on longer keys, but a suggestion must be CLOSER than the
- * whole key length (M1 clamp), so a wholly-different word is never "suggested".
- */
-export function nearestFieldName(key, fields) {
-    let best;
-    let bestDist = Infinity;
-    for (const field of fields) {
-        const d = levenshtein(key, field);
-        if (d < bestDist) {
-            bestDist = d;
-            best = field;
-        }
-    }
-    if (best === undefined)
-        return undefined;
-    // M1: additionally clamp to STRICTLY less than the key length. A suggestion
-    // must be CLOSER than the whole key — otherwise any very short key would
-    // "match" any other same-length field (`xy` → `id`, distance 2 == length 2).
-    // For longer keys the `key.length - 1` clamp is a no-op; `max(2, …)` keeps
-    // catching 1–2 char typos.
-    const threshold = Math.min(Math.max(2, Math.floor(key.length * 0.4)), key.length - 1);
-    return bestDist <= threshold ? best : undefined;
-}
-/**
- * PAGES_LIBRARY_MEDIA-27 — suggest real field names for an unknown key,
- * combining TWO signals so an obviously-intended key is never missed:
- *
- *   1. PREFIX / SUBSTRING match — a `title` key on a headline should suggest
- *      `title_element` / `title_style` / `title_color`, but char-Levenshtein to
- *      each of those is 6-8 (well over the typo threshold), so the pure-distance
- *      `nearestFieldName` returns nothing. When the unknown key (≥ 3 chars) is a
- *      prefix of — or a substring of — a real field, surface EVERY such field
- *      regardless of edit distance: these are the concrete keys the caller most
- *      likely meant.
- *   2. Levenshtein nearest — the general single/double-char typo case.
- *
- * Prefix matches lead (they are the strongest signal), then substring matches,
- * then the Levenshtein nearest if not already covered. De-duplicated, order
- * preserved. Returns `[]` when nothing is close.
- */
-export function suggestFieldNames(key, fields) {
-    const out = [];
-    const push = (name) => {
-        if (!out.includes(name))
-            out.push(name);
-    };
-    if (key.length >= 3) {
-        // Prefix matches first (`title` → `title_element`, `title_style`, …).
-        for (const field of fields) {
-            if (field !== key && field.startsWith(key))
-                push(field);
-        }
-        // Then substring matches (`color` → `title_color`, `bg_color`).
-        for (const field of fields) {
-            if (field !== key && field.includes(key))
-                push(field);
-        }
-    }
-    // Then the edit-distance nearest for the general typo case.
-    const near = nearestFieldName(key, fields);
-    if (near !== undefined)
-        push(near);
-    return out;
-}
-/**
- * Pull `fields[].name` out of the element-type schema response. Mirrors the
- * envelope handling in `../inspection.ts`: the type schema nests under
- * `schema`, with a top-level fallback for older backends.
- *
- * @returns the field-name list (possibly empty), or `null` when the response
- *   carries no `fields` array at all (unknown schema shape → treat as unknown).
- */
-export function extractSchemaFieldNames(data) {
-    if (data === null || typeof data !== 'object')
-        return null;
-    const obj = data;
-    const schema = obj.schema !== null && typeof obj.schema === 'object'
-        ? obj.schema
-        : obj;
-    const fields = schema.fields;
-    if (!Array.isArray(fields))
-        return null;
-    const names = [];
-    for (const field of fields) {
-        if (field !== null && typeof field === 'object') {
-            const name = field.name;
-            if (typeof name === 'string' && name !== '')
-                names.push(name);
-        }
-    }
-    return names;
-}
-/**
- * Best-effort fetch of an element-type's real prop keys. ANY failure (network,
- * non-2xx, unknown shape) resolves to `null` so the caller falls through to the
- * prior behaviour — a schema fetch must never break the write.
- */
-export async function fetchSchemaFieldNames(client, elementType) {
-    try {
-        const data = await client.get(`/element-types/${encodeURIComponent(elementType)}/schema`);
-        return extractSchemaFieldNames(data);
-    }
-    catch {
-        return null;
-    }
-}
-/**
- * Validate `props` against the element-type's LIVE schema. Returns an
- * `errorResult` ONLY when the schema is surely known (non-empty field list) AND
- * at least one prop key is surely unknown; otherwise `null` (pass / fall
- * through). Reserved binding keys are skipped here — their dedicated guard runs
- * first and keeps priority.
- */
-export async function validatePropsAgainstLiveSchema(opts) {
-    const { client, elementType, props, reservedKeys } = opts;
-    if (props === undefined || props === null)
-        return null;
-    const keys = Object.keys(props);
-    if (keys.length === 0)
-        return null;
-    const fieldNames = await fetchSchemaFieldNames(client, elementType);
-    // null = schema unknown / fetch failed; [] = present-but-empty. Both are
-    // "uncertain" → never hard-reject.
-    if (fieldNames === null || fieldNames.length === 0)
-        return null;
-    // Accepted set = live schema fields ∪ the runtime-accepted-hidden mirror.
-    const accepted = new Set(fieldNames);
-    for (const extra of RUNTIME_ACCEPTED_HIDDEN_PROPS[elementType] ?? []) {
-        accepted.add(extra);
-    }
-    const unknownKeys = [];
-    for (const key of keys) {
-        if (reservedKeys.has(key))
-            continue; // dedicated guard owns these
-        if (accepted.has(key))
-            continue;
-        unknownKeys.push(key);
-    }
-    if (unknownKeys.length === 0)
-        return null;
-    // did_you_mean only for keys with a genuinely-close real field. Never
-    // fabricate a suggestion (a wholly-different key gets no `did_you_mean`).
-    // PAGES_LIBRARY_MEDIA-27: prefix/substring matches join the Levenshtein
-    // nearest, so `title` on a headline now suggests title_element/title_style/
-    // title_color instead of returning nothing.
-    const didYouMean = {};
-    const suggestionParts = [];
-    let firstNear;
-    for (const key of unknownKeys) {
-        const suggestions = suggestFieldNames(key, fieldNames);
-        if (suggestions.length > 0) {
-            didYouMean[key] = suggestions;
-            suggestionParts.push(`\`${key}\` → ${suggestions.map((s) => `\`${s}\``).join('/')}`);
-            if (firstNear === undefined)
-                firstNear = suggestions[0];
-        }
-    }
-    const hasSuggestions = suggestionParts.length > 0;
-    const unknownList = unknownKeys.map((k) => `\`${k}\``).join(', ');
-    return errorResult({
-        error: new Error(`Unknown prop key(s) for element type \`${elementType}\`: ${unknownList}. ` +
-            (hasSuggestions ? `Did you mean ${suggestionParts.join(', ')}? ` : '') +
-            `These keys are not in the element's live schema (fields[].name), so YT-Pro ` +
-            `silently drops them server-side and the element would render empty. ` +
-            `Call yootheme_builder_element_type_get_schema({ element_type: "${elementType}" }) ` +
-            `for the canonical prop keys.`),
-        context: {
-            element_type: elementType,
-            unknown_prop_keys: unknownKeys,
-            ...(hasSuggestions ? { did_you_mean: didYouMean } : {}),
-            valid_prop_keys: fieldNames,
-        },
-        hint: `Re-try with a canonical prop key` +
-            (firstNear !== undefined ? ` (e.g. \`${firstNear}\`)` : '') +
-            `, or fetch the schema first: ` +
-            `yootheme_builder_element_type_get_schema({ element_type: "${elementType}" }).`,
-    });
-}
-//# sourceMappingURL=schema-validation.js.map

package/dist/tools/elements/schema-validation.js.map

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