@vectoriox/iox-ui 5.62.1 → 5.64.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/harness-core/index.d.ts

@@ -1,5 +1,5 @@
 import { MotionId, MoodId, TintId, DensityId, DesignMotion, DesignChoices, DesignMode, StylePreset, ShapeId, AnimateId } from '@vectoriox/iox-ui/design-core';
-import { FactKey, PathIssue, JsonSchema, SiteTemplate, ShapeEntry, AiGenerationStage, AiStep, SitePlan, PlanEdit, PlanChange, SiteAudit } from '@vectoriox/iox-ui/generation-core';
+import { FactKey, PathIssue, PlainObject, JsonSchema, SiteTemplate, ShapeEntry, AiGenerationStage, AiStep, SitePlan, PlanEdit, PlanChange, SiteAudit } from '@vectoriox/iox-ui/generation-core';
 export { JsonSchema } from '@vectoriox/iox-ui/generation-core';
 
 declare const SPEC_HARNESS_SOURCE: {
@@ -2577,6 +2577,13 @@ declare function validateSiteAnalysis(value: unknown, ctx: AnalysisContext): Ana
 /** The name a provider shows the format under (`json_schema.name`). */
 declare const SITE_ANALYSIS_SCHEMA_NAME = "site_analysis";
 declare function siteAnalysisJsonSchema(): JsonSchema;
+/** A model's analysis (the wire) → the document, and the faults only the wire can have (a fact stated twice). Never repairs. */
+declare function analysisFromWire(wire: unknown): {
+    analysis: unknown;
+    issues: AnalysisIssue[];
+};
+/** The document → the wire (what a model writes). */
+declare function analysisToWire(analysis: SiteAnalysis): PlainObject;
 
 /**
  * What the PLAN prompt is given (AI plan rev 3 §3f "Retrieval, not the whole knowledge base"): the one matched
@@ -2801,7 +2808,7 @@ declare function validateSiteReading(value: unknown, ctx: {
     valid: boolean;
     issues: ReadingIssue[];
 };
-/** A valid reading's answer → `SiteReading` (the analysis alone answers `{ analysis }`). */
+/** A valid reading's answer → `SiteReading` (the analysis alone answers `{ analysis }`; the facts made a map again). */
 declare function decodeSiteReading(value: unknown, pictureCount: number): SiteReading;
 /** A reference picture as the server read it: its measured palette (and where it is). */
 interface MeasuredPicture {
@@ -2987,5 +2994,5 @@ type SiteAuditView = SiteAudit & {
     advice: LintFinding[];
 };
 
-export { ANIMATE_ADVICE_STEPS, AnalysisIssueCode, AnalysisLocale, AvoidCheck, BUSINESS_TYPES, BUSINESS_TYPE_IDS, BookingNeed, COPY_LENGTH_ORDER, CopyLength, GENERATION_LIMITS, HARNESS_SOURCE, LITTLE_MOVEMENT_AVOID, LITTLE_MOVEMENT_CAP, LintKind, MAX_ANALYSIS_MOODS, MAX_PIXEL_SAMPLES, MAX_READ_PICTURES, NEEDS, NEED_IDS, NeedSource, PALETTE_SIZE, PALETTE_THRESHOLDS, PictureRole, PlanChangeOutcome, PresetFit, RANK_WEIGHTS, READING_SHAPE, READ_ANIMATE, READ_WEIGHTS, RankReason, ReaderState, ReadingIssueCode, SITE_ANALYSIS_SCHEMA_NAME, SITE_READING_SCHEMA_NAME, SPEC_ANALYSIS_SHAPE, SPEC_BUSINESS_TYPES, SPEC_HARNESS_EXAMPLES, SPEC_HARNESS_SOURCE, SPEC_NEEDS, SPEC_STRUCTURES, SPEC_USER_AVOIDS, STRUCTURES, SiteReadRefusal, StyleReadGround, StyleReadHeadings, StyleReadMotion, StyleReadSourceKind, USER_AVOID_IDS, VoiceFormality, VoicePerson, addressesIn, analysisPromptContext, businessTypeById, calmerChoice, decodeSiteReading, inferNeeds, isLookRule, lintDesign, lookMatches, mapStyleRead, matchBusinessType, matchBusinessTypes, measurePalette, mergeStyleReads, motionAdvice, motionFor, normalizeAddress, oklchHue, paletteBrand, paletteGround, paletteSamples, pictureStyleRead, pixelSamples, presetDesign, presetHasSerifHeadings, presetLook, presetReason, rankStylePresets, rankWithReferences, readPalette, referenceSeed, seedPassesPreset, siteAnalysisJsonSchema, siteReadingJsonSchema, startingDesign, structureFor, userAvoidRule, validateSiteAnalysis, validateSiteReading, withoutAddress };
+export { ANIMATE_ADVICE_STEPS, AnalysisIssueCode, AnalysisLocale, AvoidCheck, BUSINESS_TYPES, BUSINESS_TYPE_IDS, BookingNeed, COPY_LENGTH_ORDER, CopyLength, GENERATION_LIMITS, HARNESS_SOURCE, LITTLE_MOVEMENT_AVOID, LITTLE_MOVEMENT_CAP, LintKind, MAX_ANALYSIS_MOODS, MAX_PIXEL_SAMPLES, MAX_READ_PICTURES, NEEDS, NEED_IDS, NeedSource, PALETTE_SIZE, PALETTE_THRESHOLDS, PictureRole, PlanChangeOutcome, PresetFit, RANK_WEIGHTS, READING_SHAPE, READ_ANIMATE, READ_WEIGHTS, RankReason, ReaderState, ReadingIssueCode, SITE_ANALYSIS_SCHEMA_NAME, SITE_READING_SCHEMA_NAME, SPEC_ANALYSIS_SHAPE, SPEC_BUSINESS_TYPES, SPEC_HARNESS_EXAMPLES, SPEC_HARNESS_SOURCE, SPEC_NEEDS, SPEC_STRUCTURES, SPEC_USER_AVOIDS, STRUCTURES, SiteReadRefusal, StyleReadGround, StyleReadHeadings, StyleReadMotion, StyleReadSourceKind, USER_AVOID_IDS, VoiceFormality, VoicePerson, addressesIn, analysisFromWire, analysisPromptContext, analysisToWire, businessTypeById, calmerChoice, decodeSiteReading, inferNeeds, isLookRule, lintDesign, lookMatches, mapStyleRead, matchBusinessType, matchBusinessTypes, measurePalette, mergeStyleReads, motionAdvice, motionFor, normalizeAddress, oklchHue, paletteBrand, paletteGround, paletteSamples, pictureStyleRead, pixelSamples, presetDesign, presetHasSerifHeadings, presetLook, presetReason, rankStylePresets, rankWithReferences, readPalette, referenceSeed, seedPassesPreset, siteAnalysisJsonSchema, siteReadingJsonSchema, startingDesign, structureFor, userAvoidRule, validateSiteAnalysis, validateSiteReading, withoutAddress };
 export type { AiGenerationView, AnalysisContext, AnalysisIssue, AnalysisValidation, AvoidRule, BusinessType, BusinessTypeMatch, CheckRule, ColourSample, FactRead, GenerationFileView, GenerationReadersView, GenerationStartRequest, GoodFit, LintFinding, LintSite, LookCondition, LookDesign, LookRule, MeasuredPicture, MotionBasis, MotionInput, MotionStart, NeedDef, NeedId, PaletteColour, PaletteReading, PictureStyle, PlanRevisionView, PromptContext, PromptContextOptions, PromptSection, RankInput, RankedPreset, ReadingIssue, ReferenceSeed, SiteAnalysis, SiteAuditView, SiteNeed, SiteReaderView, SiteReading, StartingDesign, StructureChoice, StructureId, StyleHints, StyleRead, UserAvoidId };

package/package.json

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

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/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;
+}

package/src/generation-core/validate-site-plan.ts

@@ -10,6 +10,7 @@ import {
     FACT_KEYS, GlobalSlot, PAGE_ARCHETYPES, SITE_NEED_IDS, PlanDataSourceMode, PlanDataSourceType, RelativeOp, REQUIRED_CONTENT_ROLES, SitePlan, SitePlanSourceKind,
     SITE_LOCALES, SITE_PLAN_VERSION,
 } from './site-plan.model';
+import { patternListGap } from './recipe-fields';
 import { SPEC_SITE_PLAN_SHAPE } from './site-spec.generated';
 import {
     isNonEmptyString, isPlainObject as isObject, PathIssue, PathIssueCollector, pathAt as at, PlainObject as Obj, requiredShapeKeys, ShapeEntry, shapeKeys,
@@ -187,7 +188,12 @@ function validateDesign(c: Collector, design: unknown): void {
     if (design['fonts'] !== undefined && !isObject(design['fonts'])) bad('fonts', 'must be an object');
 }
 
-interface ContentTypeInfo { fields: Set<string>; roles: Record<string, string>; }
+interface ContentTypeInfo {
+    fields: Set<string>;
+    /** The fields as a recipe's pickers read them (`recipe-fields`). */
+    described: Array<{ name: string; type?: string; controller?: string }>;
+    roles: Record<string, string>;
+}
 
 function validateContentTypes(c: Collector, list: unknown[]): Map<string, ContentTypeInfo> {
     const types = new Map<string, ContentTypeInfo>();
@@ -223,11 +229,13 @@ function validateContentTypes(c: Collector, list: unknown[]): Map<string, Conten
             }
         }
         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 });
+        else if (name) types.set(name, { fields: fieldSet, described: fields.filter(isObject).map(describeField), roles });
     });
     return types;
 }
 
+const describeField = (f: Obj) => ({ 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: Collector, roles: unknown, path: string, typeName: string | null, fields: Set<string>, fieldTypes: Map<unknown, unknown>): Record<string, string> {
     if (!isObject(roles)) { c.add(SitePlanIssueCode.Shape, path, 'must be an object (which field plays each role)'); return {}; }
@@ -396,6 +404,11 @@ function validatePages(c: Collector, list: unknown[], types: Map<string, Content
                     const src = sources.get(binding);
                     if (!src) 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) c.add(SitePlanIssueCode.Binding, `${sp}.binding`, `"${patternId}" repeats nothing — it takes no binding`);
 

package/src/harness-core/site-analysis.ts

@@ -1,6 +1,6 @@
 import { MOOD_IDS, MoodId } from '@vectoriox/iox-ui/design-core';
 import {
-    describeShapeKey, FACT_KEYS, FactKey, isPlainObject, jsonClosedObject, jsonListOf, jsonOneOf, JsonSchema, jsonShapedObject, jsonText,
+    describeShapeKey, FACT_KEYS, FactKey, isPlainObject, jsonListOf, jsonOneOf, JsonSchema, jsonShapedObject, jsonText,
     PathIssue, PathIssueCollector, pathAt, PlainObject, requiredShapeKeys, ShapeEntry, shapeKeys,
 } from '@vectoriox/iox-ui/generation-core';
 
@@ -187,6 +187,11 @@ export function validateSiteAnalysis(value: unknown, ctx: AnalysisContext): Anal
  * native strict modes accept (Anthropic `output_config.format`, OpenRouter `json_schema` + `strict`): every object
  * closes with `additionalProperties: false`; no length, count or number bounds (the gate checks those). The
  * schema is a hint the provider enforces; `validateSiteAnalysis` stays the gate.
+ *
+ * ONE difference from the document, the plan wire's rule "maps as lists" (vectoriox/iox-cms#47 — Claude refuses a
+ * grammar compiled too large, and a map of the five facts, each `{ value, quote }`, was 15 of the reading's 47
+ * properties): on the wire `facts` is a list `[{ fact, value, quote }]`, a stated fact once each. `analysisFromWire`
+ * makes it the map `validateSiteAnalysis` judges; `analysisToWire` is its inverse (fakes and specs write it).
  */
 
 export type { JsonSchema } from '@vectoriox/iox-ui/generation-core';
@@ -201,19 +206,26 @@ const listOf = jsonListOf;
 /** An object of `shape`: exactly its keys, its required ones required, each described by the table. */
 const shaped = (shape: string, properties: Record<string, JsonSchema>): JsonSchema => jsonShapedObject(SHAPE[shape], properties, shape);
 
-/** `{ [fact]: factRead }`: the closed fact keys, each optional — a fact the prompt does not state is left out. */
-function factsSchema(factRead: JsonSchema): JsonSchema {
-    return jsonClosedObject(Object.fromEntries(FACT_KEYS.map(key => [key, factRead])), [], describeShapeKey(SHAPE['analysis'], 'facts'));
-}
+/** A stated fact on the wire: which fact, then the document's `factRead` keys in the table's own words. */
+const FACT_LINE_SHAPE: ShapeEntry = {
+    fact: `${FACT_KEYS.map(k => `'${k}'`).join(' | ')} — which fact (site.facts), each at most once`,
+    ...SHAPE['factRead'],
+};
+
+/** The analysis as the wire carries it: `facts` a list of fact lines, described in the table's words. */
+const ANALYSIS_WIRE_SHAPE: ShapeEntry = {
+    ...SHAPE['analysis'],
+    facts: `factLine[] — ${describeShapeKey(SHAPE['analysis'], 'facts').replace(/^\{ \[fact\]: factRead \} — /, '')}`,
+};
 
 export function siteAnalysisJsonSchema(): JsonSchema {
-    const factRead = shaped('factRead', { value: text(), quote: text() });
-    return shaped('analysis', {
+    const factLine = jsonShapedObject(FACT_LINE_SHAPE, { fact: oneOf(FACT_KEYS), value: text(), quote: text() }, 'factLine');
+    return jsonShapedObject(ANALYSIS_WIRE_SHAPE, {
         businessType: oneOf(BUSINESS_TYPE_IDS),
         alternatives: listOf(oneOf(BUSINESS_TYPE_IDS)),
         business: shaped('business', { name: text(), audience: text() }),
         needs: listOf(shaped('need', { id: oneOf(NEED_IDS), from: oneOf(Object.values(NeedSource)), name: text() })),
-        facts: factsSchema(factRead),
+        facts: listOf(factLine),
         missingFacts: listOf(oneOf(FACT_KEYS)),
         voice: shaped('voice', {
             tone: text(),
@@ -225,5 +237,28 @@ export function siteAnalysisJsonSchema(): JsonSchema {
         avoid: listOf(oneOf(USER_AVOID_IDS)),
         hero: shaped('hero', { headline: text(), lead: text() }),
         locale: oneOf(Object.values(AnalysisLocale)),
+    }, 'analysis');
+}
+
+/** A model's analysis (the wire) → the document, and the faults only the wire can have (a fact stated twice). Never repairs. */
+export function analysisFromWire(wire: unknown): { analysis: unknown; issues: AnalysisIssue[] } {
+    if (!isPlainObject(wire)) return { analysis: wire, issues: [] };
+    if (!Array.isArray(wire['facts'])) return { analysis: wire, issues: [{ code: AnalysisIssueCode.Shape, path: 'facts', message: 'must be a list of { fact, value, quote }' }] };
+    const facts: PlainObject = {};
+    const issues: AnalysisIssue[] = [];
+    (wire['facts'] as unknown[]).forEach((line, i) => {
+        if (!isPlainObject(line) || typeof line['fact'] !== 'string') {
+            issues.push({ code: AnalysisIssueCode.Shape, path: `facts[${i}]`, message: 'must be { fact, value, quote }' });
+            return;
+        }
+        const { fact, ...read } = line;
+        if (fact in facts) issues.push({ code: AnalysisIssueCode.Duplicate, path: `facts[${i}].fact`, message: `"${fact}" is stated twice` });
+        else facts[fact as string] = read;
     });
+    return { analysis: { ...wire, facts }, issues };
+}
+
+/** The document → the wire (what a model writes). */
+export function analysisToWire(analysis: SiteAnalysis): PlainObject {
+    return { ...analysis, facts: Object.entries(analysis.facts).map(([fact, read]) => ({ fact, ...read })) };
 }