@vectoriox/iox-ui 5.63.0 → 5.65.0

package/generation-core/index.d.ts

@@ -1,5 +1,6 @@
 import { AnimateId, DesignChoices, DesignTokenLike } from '@vectoriox/iox-ui/design-core';
 import { SeoRawDoc } from '@vectoriox/iox-ui/seo-core';
+import { ContentFieldLike } from '@vectoriox/iox-ui/composite-core';
 
 declare const SPEC_SITE_PLAN_SHAPE: {
     readonly plan: {
@@ -5744,6 +5745,10 @@ declare function buildStepFacts(plan: SitePlan, actions?: Readonly<Record<string
  * - **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
@@ -5827,7 +5832,7 @@ type PlanWireParts = Partial<Record<PlanPart, unknown>>;
  * 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`).
  */
 declare function expandPlanWire(parts: PlanWireParts, context: PlanWireContext): SitePlan | unknown;
 declare function fieldToWire(field: ContentFieldPlan): PlainObject;
@@ -6025,6 +6030,24 @@ declare enum AiCallStatus {
     Interrupted = "interrupted"
 }
 
+interface RecipeListBinds<T> {
+    picks: T;
+    /** What the fields lack (the recipe's `needs`), or null when they fill it. */
+    gap: string | null;
+}
+/** The fields `recipe` binds from a listed type's `fields`, and what they lack. A recipe that lists nothing lacks nothing. */
+declare function recipeListBinds<T = Readonly<Record<string, string | null>>>(recipe: string | undefined, fields: ReadonlyArray<ContentFieldLike>): RecipeListBinds<T>;
+/** What a listed type with `fields` lacks for the pattern's recipes that repeat the section's binding — the first gap, or null. */
+declare function patternListGap(pattern: SitePattern, fields: ReadonlyArray<ContentFieldLike>): string | 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.
+ */
+declare function derivedDataSources(plan: unknown): DataSourcePlan[];
+/** `plan` with the data sources its pages need appended (`derivedDataSources`); the same object when it lacks none. */
+declare function withDerivedSources<T>(plan: T): T;
+
 /**
  * What a structured-output request costs the provider's grammar compiler, counted the way the Claude API counts it
  * (platform.claude.com/docs/en/build-with-claude/structured-outputs, "Schema complexity limits", read 2026-10-27):
@@ -6234,8 +6257,9 @@ declare function validatePlanEdits(edits: unknown): {
 };
 /**
  * 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`.
  */
 declare function applyPlanEdits(plan: SitePlan, edits: ReadonlyArray<PlanEdit>): PlanEditResult;
 /** Each part's answer format name. */
@@ -6554,5 +6578,5 @@ declare function stockCreditNode(index: number, credit: StockLink): SerializedNo
 /** Append the credit lines to the footer root (once each). Returns how many it added. */
 declare function addStockCredits(footer: SerializedNode, credits: ReadonlyArray<StockLink>): number;
 
-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 type { AddBarItemResult, AiEntitlementsView, AiMeter, AiModelEntry, AiRefusal, AiTokenCounts, AiTokenPrice, AuditPage, AuditPlaceholder, BarItemsEditResult, BuildNotice, BuildStepError, BuildStepFacts, BuildStepRecord, CmsDataSourcePlan, ComposeContext, ComposeIssue, ComposedDataSource, ComposedItem, ComposedNavHeader, ComposedPage, ComposedPlaceholder, ComposedRoute, ComposedSection, ComposedSite, ContentFieldPlan, ContentRoles, ContentSeedPlan, ContentTypePlan, CreateNodeOptions, CreatedRecord, DataSourcePlan, DynamicKeysAsList, EntranceAction, EntranceActionOptions, EntranceInteraction, EntranceMark, EntranceSpec, EntranceStamp, FactKey, JsonSchema, NavHeaderInput, NavHeaderOptions, NavPage, NavShapeOptions, NavShapeResult, NodeBaseline, PageArchetype, PageArchetypeId, PageArchetypeSlot, PageData, PageDataLine, PagePlan, PageSectionPlan, PageSeoPlan, PathIssue, PatternManifestEntry, PatternNode, PatternPath, PatternRoleNeed, PlainObject, PlanChange, PlanEdit, PlanEditIssue, PlanEditResult, PlanEditsAnswer, PlanEntrancesInput, PlanWireContext, PlanWireParts, PlanWordContext, PlanWordIssue, PreflightRefusal, PublishRefusal, RelativeDataSourcePlan, SectionEntrances, SectionInput, SectionOptions, SerializedBinding, SerializedNode, SerializedResponsive, ShapeEntry, ShapeIssueCodes, ShowcaseInput, SiteAudit, SiteAuditOptions, SiteAuditSnapshot, SiteBuildRun, SiteBusiness, SiteCheck, SiteFinding, SiteNeedId, SitePageRef, SitePattern, SitePlan, SitePlanIssue, SitePlanSource, SitePlanValidation, SiteTemplate, StockCredit, StockLink, StockPhoto, StockPlacement, StockProviderTerms, StockSlot, StrictSchemaComplexity, StrictSchemaRefusal, TemplatePlanInput, UndoKept, UndoPreview, UndoRecord, WireOptions, WrittenText };
+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 };
+export type { AddBarItemResult, AiEntitlementsView, AiMeter, AiModelEntry, AiRefusal, AiTokenCounts, AiTokenPrice, AuditPage, AuditPlaceholder, BarItemsEditResult, BuildNotice, BuildStepError, BuildStepFacts, BuildStepRecord, CmsDataSourcePlan, ComposeContext, ComposeIssue, ComposedDataSource, ComposedItem, ComposedNavHeader, ComposedPage, ComposedPlaceholder, ComposedRoute, ComposedSection, ComposedSite, ContentFieldPlan, ContentRoles, ContentSeedPlan, ContentTypePlan, CreateNodeOptions, CreatedRecord, DataSourcePlan, DynamicKeysAsList, EntranceAction, EntranceActionOptions, EntranceInteraction, EntranceMark, EntranceSpec, EntranceStamp, FactKey, JsonSchema, NavHeaderInput, NavHeaderOptions, NavPage, NavShapeOptions, NavShapeResult, NodeBaseline, PageArchetype, PageArchetypeId, PageArchetypeSlot, PageData, PageDataLine, PagePlan, PageSectionPlan, PageSeoPlan, PathIssue, PatternManifestEntry, PatternNode, PatternPath, PatternRoleNeed, PlainObject, PlanChange, PlanEdit, PlanEditIssue, PlanEditResult, PlanEditsAnswer, PlanEntrancesInput, PlanWireContext, PlanWireParts, PlanWordContext, PlanWordIssue, PreflightRefusal, PublishRefusal, RecipeListBinds, RelativeDataSourcePlan, SectionEntrances, SectionInput, SectionOptions, SerializedBinding, SerializedNode, SerializedResponsive, ShapeEntry, ShapeIssueCodes, ShowcaseInput, SiteAudit, SiteAuditOptions, SiteAuditSnapshot, SiteBuildRun, SiteBusiness, SiteCheck, SiteFinding, SiteNeedId, SitePageRef, SitePattern, SitePlan, SitePlanIssue, SitePlanSource, SitePlanValidation, SiteTemplate, StockCredit, StockLink, StockPhoto, StockPlacement, StockProviderTerms, StockSlot, StrictSchemaComplexity, StrictSchemaRefusal, TemplatePlanInput, UndoKept, UndoPreview, UndoRecord, WireOptions, WrittenText };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vectoriox/iox-ui",
-  "version": "5.63.0",
+  "version": "5.65.0",
   "peerDependencies": {
     "@angular/common": ">=20.0.0",
     "@angular/core": ">=20.0.0",

package/src/actions-core/dialog-motion.ts

@@ -0,0 +1,104 @@
+/**
+ * How a dialog LEAVES (CC1 follow-up — the drawer that vanished). Opening is pure CSS (`@starting-style`
+ * in the shared `iox-design.css`); closing needs one beat of script, because `dialog.close()` drops the
+ * top layer at once and only some browsers can hold it for a transition (`overlay … allow-discrete`).
+ *
+ * The ONE exit every renderer runs: mark the element closing (`data-iox-closing` — the shared CSS gives it
+ * its closed look: the drawer back off its edge, the scrim clear), wait for the transitions that started,
+ * then finish. Reduced motion (or a stub with no animations) finishes now. Framework-free: the engine's
+ * every close path (actions, the X, the backdrop, Esc, the close-above watcher) and the builder canvas's
+ * stage share it.
+ */
+
+export const DIALOG_CLOSING_ATTRIBUTE = 'data-iox-closing';
+
+/** Longest an exit may hold the element before it finishes anyway — a transition that never ends (a
+ *  value that did not change, a tab in the background) must not leave a dialog half-closed. */
+export const DIALOG_EXIT_TIMEOUT_MS = 700;
+
+export interface ExitAnimationLike {
+    finished: Promise<unknown>;
+    effect?: { getComputedTiming?: () => { endTime?: number | null } } | null;
+}
+
+export interface ExitMotionElement {
+    setAttribute(name: string, value: string): void;
+    removeAttribute(name: string): void;
+    hasAttribute(name: string): boolean;
+    getAnimations?: (options?: { subtree?: boolean }) => ExitAnimationLike[];
+}
+
+export interface DialogElementLike extends ExitMotionElement {
+    open: boolean;
+    close(): void;
+}
+
+export interface ExitMotionOptions {
+    /** False under reduced motion: finish at once (the caller asks `motionAllowed()`). */
+    animate: boolean;
+    timeoutMs?: number;
+}
+
+/** True while an exit is running on the element (a second close waits on it; an open cancels it). */
+export function isExiting(el: ExitMotionElement | null | undefined): boolean {
+    return !!el?.hasAttribute(DIALOG_CLOSING_ATTRIBUTE);
+}
+
+/** Stop an exit that is running (the dialog was opened again mid-close): it stays open. */
+export function cancelExit(el: ExitMotionElement | null | undefined): void {
+    el?.removeAttribute(DIALOG_CLOSING_ATTRIBUTE);
+}
+
+const finite = (a: ExitAnimationLike) => {
+    const end = a.effect?.getComputedTiming?.().endTime;
+    return end === undefined || end === null || Number.isFinite(end);
+};
+
+/**
+ * Run the exit: mark the element, wait for its finite animations (its subtree's too — the drawer's links,
+ * the `::backdrop`) or the timeout. Resolves TRUE when the exit completed and the caller should finish
+ * (close / remove), FALSE when it was cancelled meanwhile. The mark stays on until the caller finishes.
+ */
+export async function runExitMotion(el: ExitMotionElement, options: ExitMotionOptions): Promise<boolean> {
+    el.setAttribute(DIALOG_CLOSING_ATTRIBUTE, '');
+    if (!options.animate) return true;
+    // Reading the animations flushes style, so the transitions the mark just started are in the list.
+    const running = (el.getAnimations?.({ subtree: true }) ?? []).filter(finite);
+    if (running.length) {
+        const timeout = options.timeoutMs ?? DIALOG_EXIT_TIMEOUT_MS;
+        let timer: ReturnType<typeof setTimeout> | undefined;
+        await Promise.race([
+            Promise.all(running.map(a => a.finished.catch(() => undefined))),
+            new Promise<void>(resolve => { timer = setTimeout(resolve, timeout); }),
+        ]);
+        if (timer !== undefined) clearTimeout(timer);
+    }
+    return isExiting(el);
+}
+
+const pending = new WeakMap<object, Promise<void>>();
+
+/**
+ * Close a live `<dialog>` with its exit motion. A second call while it is closing joins the first; an open
+ * in between (`cancelExit`) keeps it open. The dialog's own `close` event still fires once, after the
+ * motion — so whatever a runtime does on close (restart the page scroll, sync the openers, return focus)
+ * happens when the dialog is really gone.
+ */
+export function closeDialogAnimated(el: DialogElementLike, options: ExitMotionOptions): Promise<void> {
+    if (!el.open) return Promise.resolve();
+    const running = pending.get(el);
+    if (running && isExiting(el)) return running;
+    const done = runExitMotion(el, options).then(finish => {
+        pending.delete(el);
+        if (!finish) return;
+        if (el.open) el.close();
+        cancelExit(el);
+    });
+    pending.set(el, done);
+    return done;
+}
+
+/** True when a toggle should CLOSE the dialog: it is open and not already on its way out. */
+export function dialogTogglesClosed(el: Pick<DialogElementLike, 'open' | 'hasAttribute'>): boolean {
+    return el.open && !el.hasAttribute(DIALOG_CLOSING_ATTRIBUTE);
+}

package/src/actions-core/public-api.ts

@@ -12,3 +12,4 @@ export * from './action.model';
 export * from './availability';
 export * from './element-actions';
 export * from './dialog-opener';
+export * from './dialog-motion';

package/src/generation-core/compose-site.ts

@@ -4,9 +4,9 @@ import { FormPresetDef, FormPresetField, formPresetById } from '@vectoriox/iox-u
 import {
     ACCORDION_BIND_PROP, ACCORDION_CONTENT_LIMIT, ACCORDION_WORDS, accordionAnswerOf, accordionItems, accordionQuestionOf, AccordionRole,
     buildAccordionRecipe, buildCardRecipe, buildCarouselRecipe, buildLightboxRecipe, CardLayout, CardPart, CardRole, CARD_LAYOUTS, CARD_PARTS, CompositeNode,
-    CompositeNodeSpec, findByRole, LIGHTBOX_LABEL, pickAccordionAutoBinds, pickTabsAutoBinds, SLIDE_TO_ROW, SLIDE_TYPE, buildTabsRecipe, tabLabelNodeOf,
+    AccordionAutoBinds, CompositeNodeSpec, findByRole, LIGHTBOX_LABEL, SLIDE_TO_ROW, SLIDE_TYPE, buildTabsRecipe, tabLabelNodeOf,
     tabPanelImageOf, tabPanelTextOf, tabsListOf, tabsPanels, tabsPanelsOf, tabsTriggers, TABS_CONTENT_LIMIT, TABS_IMAGE_BIND_PROP, TABS_LABEL_BIND_PROP,
-    TABS_TEXT_BIND_PROP, TABS_WORDS, BadgeTone, BADGE_TONES, buildSegmentedRecipe, CardWords, ITEM_OPEN_STATE, segmentedOptions,
+    TABS_TEXT_BIND_PROP, TABS_WORDS, TabsAutoBinds, BadgeTone, BADGE_TONES, buildSegmentedRecipe, CardWords, ITEM_OPEN_STATE, segmentedOptions,
 } from '@vectoriox/iox-ui/composite-core';
 
 import { EntranceMark, EntrancePart, planEntrances } from './entrances';
@@ -14,6 +14,7 @@ import { NODE_BASELINES } from './node-baselines.generated';
 import {
     BindScope, CardBindTarget, parsePatternPath, PatternDirective, PatternNode, PatternOpens, PatternPlaceholder, PatternRecipe, SitePattern, patternById,
 } from './patterns';
+import { recipeListBinds } from './recipe-fields';
 import { assertStyleSlots, ComposeError, createSerializedNode, SerializedBinding, SerializedNode, setStyleProps, walkSerialized } from './serialized-node';
 import {
     ContentRole, ContentTypePlan, DataSourcePlan, DEFAULT_SITE_LOCALE, FactKey, FACT_KEYS, GlobalSlot, isRtlLocale, PagePlan, PageSectionPlan, PlanDataSourceMode,
@@ -838,6 +839,15 @@ function composeSegmented(pn: PatternNode, id: string): SerializedNode {
     return root;
 }
 
+/** The content type a section binding lists, through its data source. */
+function boundContentType(binding: string, ctx: Ctx): ContentTypePlan | undefined {
+    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: ContentTypePlan | undefined) => (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
@@ -864,26 +874,17 @@ function composeAccordion(pn: PatternNode, id: string, ctx: Ctx): SerializedNode
         }
         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<AccordionAutoBinds>(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 as CompositeNode);
     delete template.itemKey;
-    addBinding(accordionQuestionOf(template) as SerializedNode, { prop: ACCORDION_BIND_PROP, source: binding, path: picks.question });
-    addBinding(accordionAnswerOf(template) as SerializedNode, { prop: ACCORDION_BIND_PROP, source: binding, path: picks.answer });
+    addBinding(accordionQuestionOf(template) as SerializedNode, { prop: ACCORDION_BIND_PROP, source: binding, path: picks.question! });
+    addBinding(accordionAnswerOf(template) as SerializedNode, { 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: string, ctx: Ctx): ContentTypePlan | undefined {
-    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: ReadonlySet<string> = new Set(['list', 'panels']);
@@ -920,11 +921,8 @@ function composeTabs(pn: PatternNode, id: string, ctx: Ctx): SerializedNode {
         }
         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<TabsAutoBinds>(pn.recipe, fieldsOf(boundContentType(binding, ctx)));
+    if (gap) throw new ComposeError(`${id}: "${binding}" has no ${gap}`);
     for (const holder of [tabsListOf(tree), tabsPanelsOf(tree)] as SerializedNode[]) {
         addBinding(holder, { prop: 'source', source: binding, path: '' });
         setProp(holder, 'limit', TABS_CONTENT_LIMIT);
@@ -933,12 +931,12 @@ function composeTabs(pn: PatternNode, id: string, ctx: Ctx): SerializedNode {
     const [panel] = tabsPanels(tree);
     delete tab.itemKey;
     delete panel.itemKey;
-    addBinding(tabLabelNodeOf(tab) as SerializedNode, { prop: TABS_LABEL_BIND_PROP, source: binding, path: picks.label });
-    addBinding(tabPanelTextOf(panel) as SerializedNode, { prop: TABS_TEXT_BIND_PROP, source: binding, path: picks.text });
+    addBinding(tabLabelNodeOf(tab) as SerializedNode, { prop: TABS_LABEL_BIND_PROP, source: binding, path: picks.label! });
+    addBinding(tabPanelTextOf(panel) as SerializedNode, { prop: TABS_TEXT_BIND_PROP, source: binding, path: picks.text! });
     const image = tabPanelImageOf(panel) as SerializedNode | undefined;
     if (image && picks.image) {
         addBinding(image, { prop: TABS_IMAGE_BIND_PROP, source: binding, path: picks.image });
-        addBinding(image, { prop: 'alt', source: binding, path: picks.label });
+        addBinding(image, { prop: 'alt', source: binding, path: picks.label! });
     }
     return root;
 }

package/src/generation-core/nav-shape.ts

@@ -252,8 +252,18 @@ function makeKit(globals: ReadonlyArray<SerializedNode>, rootId: string, newId?:
 
 /** Point an opener's dialog actions at `dialogId` (a drawer rebuilt under a new id keeps its openers working). */
 function retarget(node: SerializedNode, dialogId: string): SerializedNode {
-    for (const ix of node.interactions as Array<{ actions?: Array<{ type?: string; target?: string }> }>) {
-        for (const a of ix.actions ?? []) if (a.type === 'openDialog' || a.type === 'toggleDialog') a.target = dialogId;
+    for (const ix of (node.interactions ?? []) as Array<{ actions?: Array<{ type?: string; target?: string }> }>) {
+        for (const a of ix.actions ?? []) 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: SerializedNode): SerializedNode {
+    for (const ix of (node.interactions ?? []) as Array<{ trigger?: string; actions?: Array<{ type?: string }> }>) {
+        if (ix.trigger !== CLICK) continue;
+        for (const a of ix.actions ?? []) if (a.type === NavDialogAction.Open) a.type = NavDialogAction.Toggle;
     }
     return node;
 }
@@ -267,7 +277,14 @@ function part(kit: Kit, suffix: string, type: string, props: Record<string, unkn
     return node;
 }
 
-function clickTo(kit: Kit, suffix: string, type: 'openDialog' | 'closeDialog', target: string) {
+/** The dialog actions a nav part runs on click. */
+enum NavDialogAction {
+    Open = 'openDialog',
+    Close = 'closeDialog',
+    Toggle = 'toggleDialog',
+}
+
+function clickTo(kit: Kit, suffix: string, type: NavDialogAction, target: string) {
     return { id: kit.id(`${suffix}-click`), trigger: CLICK, actions: [{ type, target, duration: 0, delay: 0, easing: 'ease' }] };
 }
 
@@ -302,11 +319,15 @@ function labelText(kit: Kit, suffix: string, words: string): SerializedNode {
     return part(kit, suffix, TEXT, { 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: Kit, drawerId: string, at: string): SerializedNode {
-    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;
 }
@@ -322,10 +343,9 @@ function drawer(kit: Kit, root: SerializedNode, pages: NavPage[], at: string): S
     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' });
@@ -364,7 +384,7 @@ const BAR_ITEM_LAY = {
 function moreItem(kit: Kit, drawerId: string): SerializedNode {
     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;
 }
 
@@ -472,7 +492,7 @@ export function planNavShape(globals: ReadonlyArray<SerializedNode>, shape: NavS
 
     // 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); }
     centerBrandAt(root, at, wantBar);

package/src/generation-core/plan-derived.ts

@@ -0,0 +1,84 @@
+import { BindScope, patternById, patternScopes } from './patterns';
+import { DataSourcePlan, PlanDataSourceMode, PlanDataSourceType, RelativeOp } from './site-plan.model';
+import { isNonEmptyString, isPlainObject, PlainObject } from './shape-check';
+import { nextSourceOf } from './validate-site-plan';
+
+/**
+ * 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';
+
+interface SourceView { type: string; mode?: string; contentType?: string; limit?: unknown; of?: string; op?: string; }
+
+/** The sources by alias, as the validator reads them (the first of an alias wins). */
+function sourceViews(list: ReadonlyArray<unknown>): Map<string, SourceView> {
+    const views = new Map<string, SourceView>();
+    for (const raw of list) {
+        if (isPlainObject(raw) && isNonEmptyString(raw['alias']) && !views.has(raw['alias'])) views.set(raw['alias'], raw as unknown as SourceView);
+    }
+    return views;
+}
+
+const readsNext = (page: PlainObject) => 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: string, taken: ReadonlyMap<string, unknown>): string {
+    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: ReadonlyMap<string, SourceView>, contentType: string): string | null {
+    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.
+ */
+export function derivedDataSources(plan: unknown): DataSourcePlan[] {
+    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: DataSourcePlan[] = [];
+    const add = (source: DataSourcePlan) => { 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. */
+export function withDerivedSources<T>(plan: T): T {
+    const derived = derivedDataSources(plan);
+    if (!derived.length) return plan;
+    const own = plan as unknown as PlainObject;
+    return { ...own, dataSources: [...(own['dataSources'] as unknown[]), ...derived] } as T;
+}

package/src/generation-core/plan-edits.ts

@@ -2,6 +2,7 @@ import {
     jsonAnyOf, jsonInteger, jsonListOf, jsonOneOf, JsonSchema, jsonShapedObject, jsonText,
 } from './json-schema';
 import { patternById, patternOptionalParts, patternSlots, patternTakesBinding } from './patterns';
+import { derivedDataSources } from './plan-derived';
 import {
     contentTypeToWire, dataSourceToWire, expandWireContentType, expandWireDataSource, expandWireField, expandWirePage, expandWireSection, fieldToWire,
     pageToWire, PLAN_PARTS, PlanPart, PlanWireShapeError, sectionPatternIds, sectionToWire, wireContentTypeJsonSchema, wireDataSourceJsonSchema,
@@ -367,8 +368,9 @@ const APPLY: Readonly<Record<`${PlanEditOp}`, 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`.
  */
 export function applyPlanEdits(plan: SitePlan, edits: ReadonlyArray<PlanEdit>): PlanEditResult {
     const structure = validatePlanEdits(edits);
@@ -384,8 +386,11 @@ export function applyPlanEdits(plan: SitePlan, edits: ReadonlyArray<PlanEdit>):
     const added = new Set(changed.filter(ch => ch.kind === PlanChangeKind.DataSource).map(ch => ch.name));
     const dataSources = draft.dataSources.filter(s => after.has(s.alias) || !before.has(s.alias) || added.has(s.alias));
     for (const s of draft.dataSources) if (!dataSources.includes(s)) changed.push({ kind: PlanChangeKind.DataSource, action: PlanChangeAction.Removed, name: s.alias });
+    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: { ...plan, pages: draft.pages, contentTypes: draft.contentTypes, dataSources }, changed, issues: [] };
+    return { plan: derived.length ? { ...edited, dataSources: [...dataSources, ...derived] } : edited, changed, issues: [] };
 }
 
 // ── The format a model writes edits in ─────────────────────────────────────────────────────────────────

package/src/generation-core/plan-wire.ts

@@ -3,6 +3,7 @@ import { FORM_PRESETS } from '@vectoriox/iox-ui/forms-core';
 
 import { describeShapeKey, jsonAnyOf, jsonBoolean, jsonInteger, jsonListOf, jsonOneOf, JsonSchema, jsonShapedObject, jsonText } from './json-schema';
 import { patternLinkSlots, patternOptionalParts, patternSlots, PatternGlobalPosition, SITE_PATTERNS } from './patterns';
+import { withDerivedSources } from './plan-derived';
 import {
     ContentFieldPlan, ContentTypePlan, DataSourcePlan, FactKey, GlobalSlot, PAGE_ARCHETYPES, PagePlan, PageSectionPlan, PlanDataSourceMode, PlanDataSourceType,
     RelativeOp, SITE_NEED_IDS, SITE_PLAN_VERSION, SitePlan, SitePlanSource, SiteLocale,
@@ -30,6 +31,10 @@ import { isPlainObject, PlainObject, ShapeEntry, shapeKeys } from './shape-check
  * - **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
@@ -91,7 +96,7 @@ const WIRE_KEYS: Readonly<Record<`${PlanWireEntry}`, Readonly<Record<string, Wir
     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')),
     },
@@ -465,7 +470,7 @@ export type PlanWireParts = Partial<Record<PlanPart, unknown>>;
  * 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`).
  */
 export function expandPlanWire(parts: PlanWireParts, context: PlanWireContext): SitePlan | unknown {
     const written = PLAN_PARTS.filter(part => parts[part] !== undefined).map(part => parts[part]);
@@ -473,7 +478,7 @@ export function expandPlanWire(parts: PlanWireParts, context: PlanWireContext):
     if (odd !== undefined) return odd;
     const wire: PlainObject = Object.assign({}, ...(written as PlainObject[]));
     const { business, contentTypes, dataSources, pages, ...rest } = wire;
-    return {
+    return withDerivedSources({
         ...rest,
         version: SITE_PLAN_VERSION,
         source: { ...context.source },
@@ -483,7 +488,7 @@ export function expandPlanWire(parts: PlanWireParts, context: PlanWireContext):
         contentTypes: each(contentTypes, expandWireContentType),
         dataSources: each(dataSources, expandWireDataSource),
         pages: each(pages, expandWirePage),
-    };
+    });
 }
 
 // ── The plan → the wire ────────────────────────────────────────────────────────────────────────────────────────────

package/src/generation-core/public-api.ts

@@ -27,6 +27,8 @@ export * from './plan-data';
 export * from './showcase';
 export * from './site-build-run';
 export * from './ai-run';
+export * from './recipe-fields';
+export * from './plan-derived';
 export * from './plan-wire';
 export * from './strict-schema';
 export * from './plan-edits';

package/src/generation-core/recipe-fields.ts

@@ -0,0 +1,49 @@
+import { ContentFieldLike, pickAccordionAutoBinds, pickTabsAutoBinds } from '@vectoriox/iox-ui/composite-core';
+
+import { PatternDirective, patternNodes, PatternRecipe, SitePattern } from './patterns';
+
+/**
+ * The fields a recipe repeating a section's list binds (Accordion, Tabs — R3's From content): composite-core's pickers,
+ * the builder switch's rule, decide them. ONE rule for the composer (which binds them) and the gate (which refuses,
+ * at the section's `binding`, a list whose type cannot fill the recipe — vectoriox/iox-cms#49: it used to surface only
+ * as the composer's error at the plan's root, where the pages part could not tell which section to change).
+ */
+
+interface ListRecipe {
+    picks(fields: ReadonlyArray<ContentFieldLike>): Readonly<Record<string, string | null>>;
+    /** The picks the recipe cannot go without. */
+    required: ReadonlyArray<string>;
+    /** What the listed type must have, in words. */
+    needs: string;
+}
+
+const LIST_RECIPES: Readonly<Partial<Record<`${PatternRecipe}`, ListRecipe>>> = {
+    [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' },
+};
+
+export interface RecipeListBinds<T> {
+    picks: T;
+    /** What the fields lack (the recipe's `needs`), or null when they fill it. */
+    gap: string | null;
+}
+
+/** The fields `recipe` binds from a listed type's `fields`, and what they lack. A recipe that lists nothing lacks nothing. */
+export function recipeListBinds<T = Readonly<Record<string, string | null>>>(recipe: string | undefined, fields: ReadonlyArray<ContentFieldLike>): RecipeListBinds<T> {
+    const spec = recipe ? LIST_RECIPES[recipe as `${PatternRecipe}`] : undefined;
+    if (!spec) return { picks: {} as T, gap: null };
+    const picks = spec.picks(fields);
+    return { picks: picks as unknown as T, gap: spec.required.every(key => picks[key]) ? null : spec.needs };
+}
+
+const listsBinding = (src: string | undefined) => 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. */
+export function patternListGap(pattern: SitePattern, fields: ReadonlyArray<ContentFieldLike>): string | null {
+    for (const node of patternNodes(pattern)) {
+        if (!listsBinding(node.src)) continue;
+        const { gap } = recipeListBinds(node.recipe, fields);
+        if (gap) return gap;
+    }
+    return null;
+}