@vectoriox/iox-ui 5.63.0 → 5.65.0

package/fesm2022/vectoriox-iox-ui-generation-core.mjs

@@ -1,7 +1,7 @@
 import { NEW_NODE_STYLE_DEFAULTS, defaultElementStyleFor, elementStyleById, ownedTraitsOf, applyElementStyle, flavorPackById, parseHexColor, SPEC_AXES, EntranceParam, staggerDelay, LinkType, COLOR_SCHEMES, setColorScheme, resolveDesignChoices, ANIMATE_IDS, auditDesignContrast } from '@vectoriox/iox-ui/design-core';
 import { formPresetById, FORM_PRESETS, ControlType, FORM_NODE_TYPE, collectFormSpec, FIELD_NODE_TYPE } from '@vectoriox/iox-ui/forms-core';
 import { SEO_DESCRIPTION_MAX, SEO_TITLE_MAX } from '@vectoriox/iox-ui/seo-core';
-import { segmentedOptions, ITEM_OPEN_STATE, CardPart, CardRole, CardLayout, CARD_LAYOUTS, CARD_PARTS, BADGE_TONES, buildCardRecipe, findByRole, buildSegmentedRecipe, AccordionRole, buildAccordionRecipe, ACCORDION_WORDS, accordionItems, accordionQuestionOf, accordionAnswerOf, ACCORDION_BIND_PROP, pickAccordionAutoBinds, ACCORDION_CONTENT_LIMIT, buildTabsRecipe, TABS_WORDS, tabsTriggers, tabLabelNodeOf, TABS_LABEL_BIND_PROP, tabsPanels, tabPanelTextOf, TABS_TEXT_BIND_PROP, tabPanelImageOf, pickTabsAutoBinds, tabsListOf, tabsPanelsOf, TABS_CONTENT_LIMIT, TABS_IMAGE_BIND_PROP, buildCarouselRecipe, SLIDE_TYPE, buildLightboxRecipe, LIGHTBOX_LABEL, SLIDE_TO_ROW } from '@vectoriox/iox-ui/composite-core';
+import { pickTabsAutoBinds, pickAccordionAutoBinds, segmentedOptions, ITEM_OPEN_STATE, CardPart, CardRole, CardLayout, CARD_LAYOUTS, CARD_PARTS, BADGE_TONES, buildCardRecipe, findByRole, buildSegmentedRecipe, AccordionRole, buildAccordionRecipe, ACCORDION_WORDS, accordionItems, accordionQuestionOf, accordionAnswerOf, ACCORDION_BIND_PROP, ACCORDION_CONTENT_LIMIT, buildTabsRecipe, TABS_WORDS, tabsTriggers, tabLabelNodeOf, TABS_LABEL_BIND_PROP, tabsPanels, tabPanelTextOf, TABS_TEXT_BIND_PROP, tabPanelImageOf, tabsListOf, tabsPanelsOf, TABS_CONTENT_LIMIT, TABS_IMAGE_BIND_PROP, buildCarouselRecipe, SLIDE_TYPE, buildLightboxRecipe, LIGHTBOX_LABEL, SLIDE_TO_ROW } from '@vectoriox/iox-ui/composite-core';
 import { ELEMENT_ACTION_DESCRIPTORS, resolveActionAvailability } from '@vectoriox/iox-ui/actions-core';
 
 // GENERATED from iox-ai-guidance flavor-spec.v1.json — do not edit; re-run scripts/gen-flavor-spec.mjs
@@ -10752,6 +10752,31 @@ function jsonSchemaObjects(node, out = []) {
     return out;
 }
 
+const LIST_RECIPES = {
+    [PatternRecipe.Accordion]: { picks: f => ({ ...pickAccordionAutoBinds(f) }), required: ['question', 'answer'], needs: 'short-text field for the question and long-text field for the answer' },
+    [PatternRecipe.Tabs]: { picks: f => ({ ...pickTabsAutoBinds(f) }), required: ['label', 'text'], needs: 'short-text field for the tab and long-text field for its panel' },
+};
+/** The fields `recipe` binds from a listed type's `fields`, and what they lack. A recipe that lists nothing lacks nothing. */
+function recipeListBinds(recipe, fields) {
+    const spec = recipe ? LIST_RECIPES[recipe] : undefined;
+    if (!spec)
+        return { picks: {}, gap: null };
+    const picks = spec.picks(fields);
+    return { picks: picks, gap: spec.required.every(key => picks[key]) ? null : spec.needs };
+}
+const listsBinding = (src) => src === PatternDirective.Binding || src === PatternDirective.OptionalBinding;
+/** What a listed type with `fields` lacks for the pattern's recipes that repeat the section's binding — the first gap, or null. */
+function patternListGap(pattern, fields) {
+    for (const node of patternNodes(pattern)) {
+        if (!listsBinding(node.src))
+            continue;
+        const { gap } = recipeListBinds(node.recipe, fields);
+        if (gap)
+            return gap;
+    }
+    return null;
+}
+
 /**
  * The Site Plan validator — the gate in front of the composer. The wizard's plan and (later) the AI's
  * plan go through the SAME checks: an unknown pattern, a slot the pattern does not declare, a source
@@ -10972,10 +10997,11 @@ function validateContentTypes(c, list) {
         if (name && types.has(name))
             c.add(SitePlanIssueCode.Duplicate, `${path}.name`, `content type "${name}" is used twice`);
         else if (name)
-            types.set(name, { fields: fieldSet, roles });
+            types.set(name, { fields: fieldSet, described: fields.filter(isPlainObject).map(describeField), roles });
     });
     return types;
 }
+const describeField = (f) => ({ name: String(f['name']), type: typeof f['type'] === 'string' ? f['type'] : undefined, controller: typeof f['controller'] === 'string' ? f['controller'] : undefined });
 /** A content type's roles (L0-3): known roles only, each played by a field of the type; `title` always; `gallery` a list. */
 function validateRoles(c, roles, path, typeName, fields, fieldTypes) {
     if (!isPlainObject(roles)) {
@@ -11202,6 +11228,12 @@ function validatePages(c, list, types, sources, density) {
                         c.add(SitePlanIssueCode.UnknownDataSource, `${sp}.binding`, `no data source "${binding}"`);
                     else if (src.type !== PlanDataSourceType.Cms || src.mode !== PlanDataSourceMode.Query)
                         c.add(SitePlanIssueCode.Binding, `${sp}.binding`, `"${binding}" is not a list source`);
+                    else {
+                        const listed = src.contentType ? types.get(src.contentType) : undefined;
+                        const gap = listed ? patternListGap(pattern, listed.described) : null;
+                        if (gap)
+                            c.add(SitePlanIssueCode.Binding, `${sp}.binding`, `"${binding}" lists ${src.contentType}, which has no ${gap} — bind "${patternId}" to a list that has${patternNeedsBinding(pattern) ? '' : ', or to none'}`);
+                    }
                 }
             }
             else if (binding)
@@ -11627,11 +11659,23 @@ function makeKit(globals, rootId, newId) {
 }
 /** Point an opener's dialog actions at `dialogId` (a drawer rebuilt under a new id keeps its openers working). */
 function retarget(node, dialogId) {
-    for (const ix of node.interactions) {
+    for (const ix of (node.interactions ?? [])) {
         for (const a of ix.actions ?? [])
-            if (a.type === 'openDialog' || a.type === 'toggleDialog')
+            if (a.type === NavDialogAction.Open || a.type === NavDialogAction.Toggle)
                 a.target = dialogId;
     }
+    return asToggle(node);
+}
+/** The menu button and More are TOGGLES (a second click closes what the first opened): a part saved before that
+ *  rule opened only — kept through a change of shape, it toggles from then on. */
+function asToggle(node) {
+    for (const ix of (node.interactions ?? [])) {
+        if (ix.trigger !== CLICK)
+            continue;
+        for (const a of ix.actions ?? [])
+            if (a.type === NavDialogAction.Open)
+                a.type = NavDialogAction.Toggle;
+    }
     return node;
 }
 function part(kit, suffix, type, props, style, role, lay = {}) {
@@ -11644,6 +11688,13 @@ function part(kit, suffix, type, props, style, role, lay = {}) {
     Object.assign(node.styleProps, lay);
     return node;
 }
+/** The dialog actions a nav part runs on click. */
+var NavDialogAction;
+(function (NavDialogAction) {
+    NavDialogAction["Open"] = "openDialog";
+    NavDialogAction["Close"] = "closeDialog";
+    NavDialogAction["Toggle"] = "toggleDialog";
+})(NavDialogAction || (NavDialogAction = {}));
 function clickTo(kit, suffix, type, target) {
     return { id: kit.id(`${suffix}-click`), trigger: CLICK, actions: [{ type, target, duration: 0, delay: 0, easing: 'ease' }] };
 }
@@ -11675,10 +11726,14 @@ function iconNode(kit, suffix, iconClass) {
 function labelText(kit, suffix, words) {
     return part(kit, suffix, TEXT$1, { content: words, tag: 'span' }, 'button-label');
 }
+/** The menu button and the drawer's Close are ONE size — and the shared CSS pads the drawer like the header
+ *  (`.iox-role-nav-drawer` re-declares dialog-pad as nav-pad) — so the Close lands where the menu button is and
+ *  reads as the same button turned into an X. */
+const MENU_BUTTON_LAY = { width: '48px', height: '48px', alignItems: 'center', justifyContent: 'center' };
 function menuButton(kit, drawerId, at) {
-    const btn = part(kit, 'menu', BUTTON, { tag: 'button', ariaLabel: NAV_SHAPE_COPY.menu }, 'button-ghost', NavRole.MenuButton, { width: '48px', height: '48px', alignItems: 'center', justifyContent: 'center' });
+    const btn = part(kit, 'menu', BUTTON, { tag: 'button', ariaLabel: NAV_SHAPE_COPY.menu }, 'button-ghost', NavRole.MenuButton, { ...MENU_BUTTON_LAY });
     btn.children = [iconNode(kit, 'menu-icon', MENU_ICON)];
-    btn.interactions = [clickTo(kit, 'menu', 'openDialog', drawerId)];
+    btn.interactions = [clickTo(kit, 'menu', NavDialogAction.Toggle, drawerId)];
     phoneOnly(btn, at, 'inline-flex');
     return btn;
 }
@@ -11691,9 +11746,9 @@ function drawer(kit, root, pages, at) {
     }, 'dialog', NavRole.Drawer, { width: '86vw', maxWidth: '360px', display: 'flex', flexDirection: 'column', gap: '20px' });
     const brandWords = textOf(find([root], NavRole.Brand) ?? root) || NAV_PART_LABELS[NavRole.Root];
     const head = part(kit, 'drawer-head', CONTAINER, {}, 'box', NavRole.DrawerHead, { display: 'flex', justifyContent: 'space-between', alignItems: 'center', gap: '12px' });
-    const close = part(kit, 'drawer-close', BUTTON, { tag: 'button', ariaLabel: NAV_SHAPE_COPY.closeMenu }, 'button-ghost', NavRole.DrawerClose, { width: '44px', height: '44px', alignItems: 'center', justifyContent: 'center' });
+    const close = part(kit, 'drawer-close', BUTTON, { tag: 'button', ariaLabel: NAV_SHAPE_COPY.closeMenu }, 'button-ghost', NavRole.DrawerClose, { ...MENU_BUTTON_LAY });
     close.children = [iconNode(kit, 'drawer-close-icon', CLOSE_ICON)];
-    close.interactions = [clickTo(kit, 'drawer-close', 'closeDialog', dr.id)];
+    close.interactions = [clickTo(kit, 'drawer-close', NavDialogAction.Close, dr.id)];
     head.children = [part(kit, 'drawer-brand', HEADING, { content: brandWords, level: 'h3' }, 'h3'), close];
     const list = part(kit, 'drawer-links', CONTAINER, {}, 'box', NavRole.DrawerLinks, { display: 'flex', flexDirection: 'column', gap: '4px' });
     // Board 1: every page, Home first, at lead size (on each Link: a Link's own baseline font size would
@@ -11729,7 +11784,7 @@ const BAR_ITEM_LAY = {
 function moreItem(kit, drawerId) {
     const more = part(kit, 'bar-more', BUTTON, { tag: 'button' }, 'bottom-bar-item', NavRole.More, BAR_ITEM_LAY);
     more.children = [iconNode(kit, 'bar-more-icon', MORE_ICON), labelText(kit, 'bar-more-label', NAV_SHAPE_COPY.more)];
-    more.interactions = [clickTo(kit, 'bar-more', 'openDialog', drawerId)];
+    more.interactions = [clickTo(kit, 'bar-more', NavDialogAction.Toggle, drawerId)];
     return more;
 }
 /** Home first, then the header's pages: the header reaches Home through its brand, a phone menu names it. */
@@ -11839,7 +11894,7 @@ function planNavShape(globals, shape, options = {}, navId) {
         dr.props = { ...dr.props, closeAbove: at };
     // The menu button: Drawer only (Q4: with a bar, the phone header keeps only the brand).
     const existingMenu = removeRole(root, NavRole.MenuButton);
-    const menu = wantMenuButton ? (existingMenu ?? menuButton(kit, dr.id, at)) : null;
+    const menu = wantMenuButton ? (existingMenu ? asToggle(existingMenu) : menuButton(kit, dr.id, at)) : null;
     for (const p of phoneHiddenParts(root)) {
         moveDisplayOverride(p, at);
         hideAt(p, at);
@@ -12698,6 +12753,13 @@ function composeSegmented(pn, id) {
     applyLayout(root, pn);
     return root;
 }
+/** The content type a section binding lists, through its data source. */
+function boundContentType(binding, ctx) {
+    const source = ctx.plan.dataSources.find(d => d.alias === binding);
+    return source && 'contentType' in source ? ctx.plan.contentTypes.find(t => t.name === source.contentType) : undefined;
+}
+/** A type's fields as composite-core's pickers read them. */
+const fieldsOf = (type) => (type?.fields ?? []).map(f => ({ name: f.name, type: f.type, controller: f.controller }));
 /**
  * An Accordion (CC2) — the composite-core recipe stamped with this composer's factory. Manual (no section
  * binding): three items whose questions and answers are placeholders the studio rewrites (`ph: 'copy'`), never
@@ -12726,12 +12788,9 @@ function composeAccordion(pn, id, ctx) {
         }
         return root;
     }
-    const source = ctx.plan.dataSources.find(d => d.alias === binding);
-    const type = source && 'contentType' in source ? ctx.plan.contentTypes.find(t => t.name === source.contentType) : undefined;
-    const picks = pickAccordionAutoBinds((type?.fields ?? []).map(f => ({ name: f.name, type: f.type, controller: f.controller })));
-    if (!picks.question || !picks.answer) {
-        throw new ComposeError(`${id}: "${binding}" has no short-text field for the question and long-text field for the answer`);
-    }
+    const { picks, gap } = recipeListBinds(pn.recipe, fieldsOf(boundContentType(binding, ctx)));
+    if (gap)
+        throw new ComposeError(`${id}: "${binding}" has no ${gap}`);
     addBinding(root, { prop: 'source', source: binding, path: '' });
     setProp(root, 'limit', ACCORDION_CONTENT_LIMIT);
     const [template] = accordionItems(root);
@@ -12740,11 +12799,6 @@ function composeAccordion(pn, id, ctx) {
     addBinding(accordionAnswerOf(template), { prop: ACCORDION_BIND_PROP, source: binding, path: picks.answer });
     return root;
 }
-/** The content type a section binding lists, through its data source. */
-function boundContentType(binding, ctx) {
-    const source = ctx.plan.dataSources.find(d => d.alias === binding);
-    return source && 'contentType' in source ? ctx.plan.contentTypes.find(t => t.name === source.contentType) : undefined;
-}
 const TABS_ROOT_KEY = 'tabs';
 const TABS_HOLDER_KEYS = new Set(['list', 'panels']);
 /**
@@ -12783,11 +12837,9 @@ function composeTabs(pn, id, ctx) {
         }
         return root;
     }
-    const type = boundContentType(binding, ctx);
-    const picks = pickTabsAutoBinds((type?.fields ?? []).map(f => ({ name: f.name, type: f.type, controller: f.controller })));
-    if (!picks.label || !picks.text) {
-        throw new ComposeError(`${id}: "${binding}" has no short-text field for the tab and long-text field for its panel`);
-    }
+    const { picks, gap } = recipeListBinds(pn.recipe, fieldsOf(boundContentType(binding, ctx)));
+    if (gap)
+        throw new ComposeError(`${id}: "${binding}" has no ${gap}`);
     for (const holder of [tabsListOf(tree), tabsPanelsOf(tree)]) {
         addBinding(holder, { prop: 'source', source: binding, path: '' });
         setProp(holder, 'limit', TABS_CONTENT_LIMIT);
@@ -13380,6 +13432,85 @@ function buildStepFacts(plan, actions = {}) {
     };
 }
 
+/**
+ * What a plan reads but no model is asked to write (vectoriox/iox-cms#49): the data sources that follow from the pages
+ * alone. A per-item page whose sections read the NEXT item (`project.next`) needs a `$siblings.next` source of its route
+ * source — a fact of the pages, while data sources are the plan's STRUCTURE, asked first and fixed once accepted. Asking
+ * the structure for it made the pages' answer unfixable by construction (a re-ask of the pages cannot add a source), so
+ * it is derived, the same way for the plan wire's expansion (`expandPlanWire`) and for a sentence's page edits
+ * (`applyPlanEdits`). Pure and idempotent: a plan that already holds the source gains nothing; a source is derived only
+ * where it is valid by construction (its subject a single cms source of a type of the plan), so it never adds an issue
+ * at a structure path. Its siblings are walked within an unlimited list of the same type — the structure's first, else a
+ * derived one.
+ */
+const NEXT_SUFFIX = 'Next';
+const LIST_SUFFIX = 'All';
+/** The sources by alias, as the validator reads them (the first of an alias wins). */
+function sourceViews(list) {
+    const views = new Map();
+    for (const raw of list) {
+        if (isPlainObject(raw) && isNonEmptyString(raw['alias']) && !views.has(raw['alias']))
+            views.set(raw['alias'], raw);
+    }
+    return views;
+}
+const readsNext = (page) => Array.isArray(page['sections']) && page['sections'].some(s => {
+    const pattern = isPlainObject(s) && typeof s['pattern'] === 'string' ? patternById(s['pattern']) : undefined;
+    return !!pattern && patternScopes(pattern).has(BindScope.Next);
+});
+/** The alias itself, else the first of `<alias>2`, `<alias>3`… no source has. */
+function freeAlias(base, taken) {
+    let alias = base;
+    for (let n = 2; taken.has(alias); n++)
+        alias = `${base}${n}`;
+    return alias;
+}
+/** The unlimited list of `contentType` the plan holds (its first), or null. */
+function fullListOf(views, contentType) {
+    for (const [alias, s] of views) {
+        if (s.type === PlanDataSourceType.Cms && s.mode === PlanDataSourceMode.Query && s.contentType === contentType && s.limit === undefined)
+            return alias;
+    }
+    return null;
+}
+/**
+ * The data sources `plan` lacks and its pages need, in page order (appended after the plan's own). Tolerates any
+ * value: what is not a well-formed plan gains nothing, for the validator to judge as written.
+ */
+function derivedDataSources(plan) {
+    if (!isPlainObject(plan) || !Array.isArray(plan['dataSources']) || !Array.isArray(plan['pages']) || !Array.isArray(plan['contentTypes']))
+        return [];
+    const types = new Set(plan['contentTypes'].map(t => (isPlainObject(t) ? t['name'] : undefined)).filter(isNonEmptyString));
+    const views = sourceViews(plan['dataSources']);
+    const derived = [];
+    const add = (source) => { derived.push(source); views.set(source.alias, source); };
+    for (const page of plan['pages']) {
+        if (!isPlainObject(page) || !isNonEmptyString(page['routeSource']) || !readsNext(page))
+            continue;
+        const subject = page['routeSource'];
+        const route = views.get(subject);
+        if (!route || route.type !== PlanDataSourceType.Cms || route.mode !== PlanDataSourceMode.Single)
+            continue;
+        if (!isNonEmptyString(route.contentType) || !types.has(route.contentType) || nextSourceOf(views, subject))
+            continue;
+        let within = fullListOf(views, route.contentType);
+        if (!within) {
+            within = freeAlias(`${subject}${LIST_SUFFIX}`, views);
+            add({ alias: within, type: PlanDataSourceType.Cms, mode: PlanDataSourceMode.Query, contentType: route.contentType });
+        }
+        add({ alias: freeAlias(`${subject}${NEXT_SUFFIX}`, views), type: PlanDataSourceType.Relative, of: subject, op: RelativeOp.SiblingsNext, within });
+    }
+    return derived;
+}
+/** `plan` with the data sources its pages need appended (`derivedDataSources`); the same object when it lacks none. */
+function withDerivedSources(plan) {
+    const derived = derivedDataSources(plan);
+    if (!derived.length)
+        return plan;
+    const own = plan;
+    return { ...own, dataSources: [...own['dataSources'], ...derived] };
+}
+
 /**
  * The plan WIRE (AI plan M1-3, vectoriox/iox-cms#45, #47): what a model writes when it plans a site — a compact format
  * inside the Claude API's structured-output limits (≤ 24 optional parameters and ≤ 16 unions per request, and a compiled
@@ -13400,6 +13531,10 @@ function buildStepFacts(plan, actions = {}) {
  * - **What the model does not decide is not on the wire** (`PLAN_WIRE_DERIVED`): the look (the owner's pick), the run,
  *   the language (the reading's), the facts (the owner's own, verbatim), the version, the home page (the page at `/`).
  *   So the format is the same for every studio and every run — one compiled grammar, cached by the provider.
+ * - **What follows from the pages is derived, never asked** (`plan-derived.ts`, vectoriox/iox-cms#49): a per-item page
+ *   reading the next item gets its `$siblings.next` source — the structure, asked first and then fixed, cannot know the
+ *   pages need it, and the pages cannot add a source. `planToWire` writes every source the plan holds, a derived one
+ *   too (it is the plan's: a change's brief shows it, and a plan → wire → plan round trip stays exact).
  *
  * ONE source: every wire key names the plan keys it carries (`refs`) and is described in the plan table's own words, and
  * every plan key is either carried or derived (`planWireGaps()`); a key the plan shape gains breaks the builder until it
@@ -13444,7 +13579,7 @@ const WIRE_KEYS = {
     plan: {
         business: inPart(PlanPart.Structure, key('plan.business')),
         contentTypes: inPart(PlanPart.Structure, key('plan.contentTypes')),
-        dataSources: inPart(PlanPart.Structure, { refs: ['plan.dataSources'], text: 'dataSource[] — merged by alias into the org library' }),
+        dataSources: inPart(PlanPart.Structure, { refs: ['plan.dataSources'], text: "dataSource[] — merged by alias into the org library; a per-item page's $siblings.next source (what a section reading the next item needs) is added for you" }),
         pages: inPart(PlanPart.Pages, key('plan.pages')),
         globals: inPart(PlanPart.Pages, key('plan.globals')),
     },
@@ -13774,7 +13909,7 @@ function expandWireBusiness(wire, facts) {
  * A model's plan (its parts, on the wire) + what the generation decides (the look, the run, the language, the owner's
  * facts) → the Site Plan. Pure. Translates, never repairs: whatever an answer got wrong is still wrong, for
  * `validateSitePlan` — a part that is not an object is the result itself, a part not written yet leaves its keys out
- * (the validator then names them, at their own paths).
+ * (the validator then names them, at their own paths). What follows from the pages alone is added (`withDerivedSources`).
  */
 function expandPlanWire(parts, context) {
     const written = PLAN_PARTS.filter(part => parts[part] !== undefined).map(part => parts[part]);
@@ -13783,7 +13918,7 @@ function expandPlanWire(parts, context) {
         return odd;
     const wire = Object.assign({}, ...written);
     const { business, contentTypes, dataSources, pages, ...rest } = wire;
-    return {
+    return withDerivedSources({
         ...rest,
         version: SITE_PLAN_VERSION,
         source: { ...context.source },
@@ -13793,7 +13928,7 @@ function expandPlanWire(parts, context) {
         contentTypes: each(contentTypes, expandWireContentType),
         dataSources: each(dataSources, expandWireDataSource),
         pages: each(pages, expandWirePage),
-    };
+    });
 }
 // ── The plan → the wire ────────────────────────────────────────────────────────────────────────────────────────────
 function fieldToWire(field) {
@@ -14491,8 +14626,9 @@ const APPLY = {
 };
 /**
  * Apply a set of edits to a plan — all of them, or none (any issue refuses the set and returns the plan unchanged). The
- * sources only removed pages and sections read are dropped with them; sources nothing read before are kept.
- * The result still has to pass `validateSitePlan`.
+ * sources only removed pages and sections read are dropped with them; sources nothing read before are kept; the sources
+ * the pages now need and no model writes are derived (`derivedDataSources` — a page edit adding `project.next`, as the
+ * plan wire's expansion does, vectoriox/iox-cms#49). The result still has to pass `validateSitePlan`.
  */
 function applyPlanEdits(plan, edits) {
     const structure = validatePlanEdits(edits);
@@ -14511,7 +14647,11 @@ function applyPlanEdits(plan, edits) {
     for (const s of draft.dataSources)
         if (!dataSources.includes(s))
             changed.push({ kind: PlanChangeKind.DataSource, action: PlanChangeAction.Removed, name: s.alias });
-    return { plan: { ...plan, pages: draft.pages, contentTypes: draft.contentTypes, dataSources }, changed, issues: [] };
+    const edited = { ...plan, pages: draft.pages, contentTypes: draft.contentTypes, dataSources };
+    const derived = derivedDataSources(edited);
+    for (const s of derived)
+        changed.push({ kind: PlanChangeKind.DataSource, action: PlanChangeAction.Added, name: s.alias });
+    return { plan: derived.length ? { ...edited, dataSources: [...dataSources, ...derived] } : edited, changed, issues: [] };
 }
 // ── The format a model writes edits in ─────────────────────────────────────────────────────────────────
 /** Each part's answer format name. */
@@ -15297,5 +15437,5 @@ function addStockCredits(footer, credits) {
  * Generated bundle index. Do not edit.
  */
 
-export { ACTIVE_BUILD_STATUSES, AI_REFUSAL_NEXT, AI_REFUSAL_STATUS, AI_STEPS, AI_STEP_LABELS, AI_STEP_NEEDS, AI_STEP_PART_TOKENS, AI_STEP_TYPICAL_TOKENS, AiCallStatus, AiCapability, AiFeature, AiGenerationStage, AiKeyMode, AiLimit, AiNextKind, AiProviderId, AiRefusalCode, AiStep, BAR_ITEMS_MAX, BAR_ITEMS_MIN, BASELINE_ROLES, BUILD_STEPS, BaselineRole, BindScope, BuildNoticeCode, BuildStep, CONTENT_ROLE_MEANINGS, CREDITS_PER_USD, CardBindTarget, CheckSeverity, ComposeError, ComposeIssueCode, ContentRole, ContentTypeAction, CreatedKind, DANGLING_LINK_CODES, DEFAULT_PHONE_MENU_BREAKPOINT, DEFAULT_SITE_LOCALE, ENTRANCE_EASING, ENTRANCE_ORIGIN_LOOK, ENTRANCE_TRIGGER, EntrancePart, EntranceSide, FACT_KEYS, FINAL_GENERATION_STAGES, FINDING_SEVERITY, GRAMMAR_TOO_LARGE_MESSAGE, GlobalSlot, HEBREW_PREFIXES, JSON_SCHEMA_BANNED_KEYWORDS, JsonSchemaShapeError, KeptReason, NAV_PART_LABELS, NAV_SHAPE_COPY, NEUTRAL_STYLE_PROPS, NODE_BASELINES, NO_TOKENS, NavPagesSource, NavRole, NavShape, NavShapeError, PAGE_ARCHETYPES, PLAN_EDITS_ANSWER_SHAPES, PLAN_EDITS_PART_SCHEMA_NAMES, PLAN_EDIT_OP_PART, PLAN_EDIT_SHAPE, PLAN_EDIT_WIRE_KEYS, PLAN_PARTS, PLAN_PART_KEYS, PLAN_WIRE_DERIVED, PLAN_WIRE_PART_SCHEMA_NAMES, PLAN_WIRE_SHAPE, PRICING_PATTERN, PUBLISH_BLOCKING_PLACEHOLDERS, PageDataKind, PathIssueCollector, PatternDirective, PatternGlobalPosition, PatternOpens, PatternPlaceholder, PatternRecipe, PhoneMenuBreakpoint, PlaceholderKind, PlanChangeAction, PlanChangeKind, PlanDataSourceMode, PlanDataSourceType, PlanEditIssueCode, PlanEditOp, PlanEditsOutcome, PlanPart, PlanWireEntry, PlanWireShapeError, PlanWordIssueCode, PreflightRefusalCode, PublishRefusalCode, REQUIRED_CONTENT_ROLES, RelativeOp, SAMPLE_IMAGE_REF, SITE_CHECKS, SITE_FACT_LABELS, SITE_HEADER_PATTERN, SITE_LIBRARY, SITE_LOCALES, SITE_NEED_IDS, SITE_PATTERNS, SITE_PLAN_VERSION, SITE_TEMPLATES, SPEC_SITE_ARCHETYPES, SPEC_SITE_COPY_LENGTHS, SPEC_SITE_DENSITY_COPY, SPEC_SITE_FACTS, SPEC_SITE_LIBRARY, SPEC_SITE_LOCALES, SPEC_SITE_NEED_IDS, SPEC_SITE_PATTERNS, SPEC_SITE_PLAN_SHAPE, SPEC_SITE_REQUIRED_ROLES, SPEC_SITE_ROLES, SPEC_SITE_TEMPLATES, STOCK_FAMILIES, STOCK_PROVIDER_TERMS, STRICT_SCHEMA_BUDGET, STRICT_SCHEMA_LIMITS, STUDIO_TEMPLATE, SiteBuildKind, SiteBuildStatus, SiteCheckId, SiteFindingCode, SiteLocale, SitePlanError, SitePlanIssueCode, SitePlanSourceKind, SiteTemplateError, SiteTemplateId, StepState, StockProviderId, addBarItem, addStockCredits, aiStepParts, applyPlanEdits, applyStockPhotos, archetypeIssues, assertStyleSlots, assertValidSitePlan, auditSite, barIconForRoute, blocksPublish, buildKeys, buildStepFacts, builtHomePageId, composeNavHeader, composeSection, composeSite, contentTypePreviewFields, contentTypeToWire, copyLengthOf, costUsd, createSerializedNode, creditsOfUsd, dataSourceToWire, describePlanData, describeShapeKey, entranceAction, entranceInteraction, estimateStepCredits, expandPlanWire, expandWireContentType, expandWireDataSource, expandWireEdit, expandWireField, expandWirePage, expandWireSection, failedBuildStep, fieldToWire, findNavRoot, isActiveBuild, isNonEmptyString, isPlainObject, isRtlLocale, jsonAnyOf, jsonBoolean, jsonClosedObject, jsonInteger, jsonListOf, jsonOneOf, jsonSchemaKeywords, jsonSchemaObjects, jsonShapedObject, jsonText, modelCanDo, moveBarItem, navPages, navShapeBreakpoint, navShapeOf, nextSourceOf, nodeBindPaths, pageToWire, parsePatternPath, parseSampleImageRef, pathAt, patternById, patternHasForm, patternLinkSlots, patternManifest, patternNeedsBinding, patternNodes, patternOptionalParts, patternRoleNeeds, patternScopes, patternSlotBudgets, patternSlots, patternTakesBinding, phoneMenuPages, planEditOps, planEditToWire, planEditWireGaps, planEditWireKeys, planEditWireOps, planEditWireShape, planEditsFromWire, planEditsJsonSchema, planEditsToWire, planEntrances, planFromTemplate, planNavShape, planPartOfPath, planPartToWire, planStockPhotos, planToWire, planWireGaps, planWirePartJsonSchema, planWirePartShape, planWordIssues, publishRefusal, publishVerdict, releasedLayoutDefaults, removeBarItem, requiredAcknowledgements, requiredShapeKeys, roleField, routeMatches, routeParams, sampleImageRef, sectionEntrances, sectionPatternIds, sectionToWire, setStyleProps, shapeKeys, showcaseGlobals, showcasePages, showcasePlans, siteNavPages, slotBudget, stockCopyKey, stockCreditLine, stockCreditLines, stockCreditNode, stockCreditNodeId, stockSlots, strictSchemaComplexity, strictSchemaRefusal, typicalStepTokens, validatePlanEdits, validateSitePlan, walkSerialized, wireContentTypeJsonSchema, wireDataSourceJsonSchema, wireFieldJsonSchema, wirePageJsonSchema, wireSectionJsonSchema, wordPattern, writtenTexts };
+export { ACTIVE_BUILD_STATUSES, AI_REFUSAL_NEXT, AI_REFUSAL_STATUS, AI_STEPS, AI_STEP_LABELS, AI_STEP_NEEDS, AI_STEP_PART_TOKENS, AI_STEP_TYPICAL_TOKENS, AiCallStatus, AiCapability, AiFeature, AiGenerationStage, AiKeyMode, AiLimit, AiNextKind, AiProviderId, AiRefusalCode, AiStep, BAR_ITEMS_MAX, BAR_ITEMS_MIN, BASELINE_ROLES, BUILD_STEPS, BaselineRole, BindScope, BuildNoticeCode, BuildStep, CONTENT_ROLE_MEANINGS, CREDITS_PER_USD, CardBindTarget, CheckSeverity, ComposeError, ComposeIssueCode, ContentRole, ContentTypeAction, CreatedKind, DANGLING_LINK_CODES, DEFAULT_PHONE_MENU_BREAKPOINT, DEFAULT_SITE_LOCALE, ENTRANCE_EASING, ENTRANCE_ORIGIN_LOOK, ENTRANCE_TRIGGER, EntrancePart, EntranceSide, FACT_KEYS, FINAL_GENERATION_STAGES, FINDING_SEVERITY, GRAMMAR_TOO_LARGE_MESSAGE, GlobalSlot, HEBREW_PREFIXES, JSON_SCHEMA_BANNED_KEYWORDS, JsonSchemaShapeError, KeptReason, NAV_PART_LABELS, NAV_SHAPE_COPY, NEUTRAL_STYLE_PROPS, NODE_BASELINES, NO_TOKENS, NavPagesSource, NavRole, NavShape, NavShapeError, PAGE_ARCHETYPES, PLAN_EDITS_ANSWER_SHAPES, PLAN_EDITS_PART_SCHEMA_NAMES, PLAN_EDIT_OP_PART, PLAN_EDIT_SHAPE, PLAN_EDIT_WIRE_KEYS, PLAN_PARTS, PLAN_PART_KEYS, PLAN_WIRE_DERIVED, PLAN_WIRE_PART_SCHEMA_NAMES, PLAN_WIRE_SHAPE, PRICING_PATTERN, PUBLISH_BLOCKING_PLACEHOLDERS, PageDataKind, PathIssueCollector, PatternDirective, PatternGlobalPosition, PatternOpens, PatternPlaceholder, PatternRecipe, PhoneMenuBreakpoint, PlaceholderKind, PlanChangeAction, PlanChangeKind, PlanDataSourceMode, PlanDataSourceType, PlanEditIssueCode, PlanEditOp, PlanEditsOutcome, PlanPart, PlanWireEntry, PlanWireShapeError, PlanWordIssueCode, PreflightRefusalCode, PublishRefusalCode, REQUIRED_CONTENT_ROLES, RelativeOp, SAMPLE_IMAGE_REF, SITE_CHECKS, SITE_FACT_LABELS, SITE_HEADER_PATTERN, SITE_LIBRARY, SITE_LOCALES, SITE_NEED_IDS, SITE_PATTERNS, SITE_PLAN_VERSION, SITE_TEMPLATES, SPEC_SITE_ARCHETYPES, SPEC_SITE_COPY_LENGTHS, SPEC_SITE_DENSITY_COPY, SPEC_SITE_FACTS, SPEC_SITE_LIBRARY, SPEC_SITE_LOCALES, SPEC_SITE_NEED_IDS, SPEC_SITE_PATTERNS, SPEC_SITE_PLAN_SHAPE, SPEC_SITE_REQUIRED_ROLES, SPEC_SITE_ROLES, SPEC_SITE_TEMPLATES, STOCK_FAMILIES, STOCK_PROVIDER_TERMS, STRICT_SCHEMA_BUDGET, STRICT_SCHEMA_LIMITS, STUDIO_TEMPLATE, SiteBuildKind, SiteBuildStatus, SiteCheckId, SiteFindingCode, SiteLocale, SitePlanError, SitePlanIssueCode, SitePlanSourceKind, SiteTemplateError, SiteTemplateId, StepState, StockProviderId, addBarItem, addStockCredits, aiStepParts, applyPlanEdits, applyStockPhotos, archetypeIssues, assertStyleSlots, assertValidSitePlan, auditSite, barIconForRoute, blocksPublish, buildKeys, buildStepFacts, builtHomePageId, composeNavHeader, composeSection, composeSite, contentTypePreviewFields, contentTypeToWire, copyLengthOf, costUsd, createSerializedNode, creditsOfUsd, dataSourceToWire, derivedDataSources, describePlanData, describeShapeKey, entranceAction, entranceInteraction, estimateStepCredits, expandPlanWire, expandWireContentType, expandWireDataSource, expandWireEdit, expandWireField, expandWirePage, expandWireSection, failedBuildStep, fieldToWire, findNavRoot, isActiveBuild, isNonEmptyString, isPlainObject, isRtlLocale, jsonAnyOf, jsonBoolean, jsonClosedObject, jsonInteger, jsonListOf, jsonOneOf, jsonSchemaKeywords, jsonSchemaObjects, jsonShapedObject, jsonText, modelCanDo, moveBarItem, navPages, navShapeBreakpoint, navShapeOf, nextSourceOf, nodeBindPaths, pageToWire, parsePatternPath, parseSampleImageRef, pathAt, patternById, patternHasForm, patternLinkSlots, patternListGap, patternManifest, patternNeedsBinding, patternNodes, patternOptionalParts, patternRoleNeeds, patternScopes, patternSlotBudgets, patternSlots, patternTakesBinding, phoneMenuPages, planEditOps, planEditToWire, planEditWireGaps, planEditWireKeys, planEditWireOps, planEditWireShape, planEditsFromWire, planEditsJsonSchema, planEditsToWire, planEntrances, planFromTemplate, planNavShape, planPartOfPath, planPartToWire, planStockPhotos, planToWire, planWireGaps, planWirePartJsonSchema, planWirePartShape, planWordIssues, publishRefusal, publishVerdict, recipeListBinds, releasedLayoutDefaults, removeBarItem, requiredAcknowledgements, requiredShapeKeys, roleField, routeMatches, routeParams, sampleImageRef, sectionEntrances, sectionPatternIds, sectionToWire, setStyleProps, shapeKeys, showcaseGlobals, showcasePages, showcasePlans, siteNavPages, slotBudget, stockCopyKey, stockCreditLine, stockCreditLines, stockCreditNode, stockCreditNodeId, stockSlots, strictSchemaComplexity, strictSchemaRefusal, typicalStepTokens, validatePlanEdits, validateSitePlan, walkSerialized, wireContentTypeJsonSchema, wireDataSourceJsonSchema, wireFieldJsonSchema, wirePageJsonSchema, wireSectionJsonSchema, withDerivedSources, wordPattern, writtenTexts };
 //# sourceMappingURL=vectoriox-iox-ui-generation-core.mjs.map