@vectoriox/iox-ui 5.67.0 → 5.69.0

package/generation-core/index.d.ts

@@ -69,6 +69,7 @@ declare const SPEC_SITE_PLAN_SHAPE: {
         readonly count: "integer ≥ 0";
         readonly sample: "boolean — items are flagged isSample";
         readonly isPublished: "boolean";
+        readonly "perItem?": "per field, one string per sample: real content that wins over the template";
         readonly "[field]?": "the field's value — strings are templates: {n} = the item's 1-based number, {sampleImage:n} / {sampleImage:n+k} = a bundled sample image";
     };
     readonly cmsDataSource: {
@@ -3624,11 +3625,11 @@ declare const SPEC_SITE_TEMPLATES: {
             }, {
                 readonly name: "cover";
                 readonly type: "string";
-                readonly controller: "image";
+                readonly controller: "media";
             }, {
                 readonly name: "gallery";
                 readonly type: "array";
-                readonly controller: "mediaList";
+                readonly controller: "gallery";
             }, {
                 readonly name: "year";
                 readonly type: "string";
@@ -3793,7 +3794,7 @@ declare const SPEC_SITE_TEMPLATES: {
             }, {
                 readonly name: "photo";
                 readonly type: "string";
-                readonly controller: "image";
+                readonly controller: "media";
             }, {
                 readonly name: "price";
                 readonly type: "string";
@@ -3985,7 +3986,7 @@ declare const SPEC_SITE_TEMPLATES: {
             }, {
                 readonly name: "photo";
                 readonly type: "string";
-                readonly controller: "image";
+                readonly controller: "media";
             }];
             readonly seed: {
                 readonly count: 6;
@@ -4336,6 +4337,28 @@ interface SiteBusiness {
     readonly tagline?: string;
     readonly facts?: Readonly<Partial<Record<FactKey, string>>>;
 }
+/** How a content field is edited: the closed list a plan chooses from. */
+declare enum ContentFieldControl {
+    Text = "text",
+    Textarea = "textarea",
+    /** One picture. `image` is the deprecated name of this control. */
+    Media = "media",
+    /** A list of pictures. */
+    Gallery = "gallery",
+    /** A list of words. */
+    List = "list",
+    Number = "number",
+    Switch = "switch"
+}
+/** How a field is stored. The schema editor's and the item editor's own list: anything else renders no input. */
+declare enum ContentFieldType {
+    String = "string",
+    Number = "number",
+    Boolean = "boolean",
+    Array = "array"
+}
+/** ONE rule: how a field is stored follows from how it is edited, so a plan never has to say. */
+declare const FIELD_TYPE_OF_CONTROL: Readonly<Record<ContentFieldControl, ContentFieldType>>;
 interface ContentFieldPlan {
     readonly name: string;
     readonly type: string;
@@ -4349,6 +4372,8 @@ interface ContentSeedPlan {
     readonly count: number;
     readonly sample: boolean;
     readonly isPublished: boolean;
+    /** Per field, one value per sample: real content where the items are about a subject anyone can know. Wins over the field's template. */
+    readonly perItem?: Readonly<Record<string, ReadonlyArray<string>>>;
     readonly [field: string]: unknown;
 }
 /** The part a field plays (contract `site.roles`, AI plan L0-3): what a pattern binds instead of a field name, so one
@@ -6677,6 +6702,19 @@ interface StockItemSlot extends StockNeed {
     field: string;
 }
 type StockTarget = StockSlot | StockItemSlot;
+/** Where the owner's photo goes: a slot of a composed section or the image field of a sample item. */
+type OwnPhotoPlacement = (Pick<StockSlot, 'nodeId' | 'owner'> | {
+    item: Pick<StockItemSlot, 'contentType' | 'index' | 'field'>;
+}) & {
+    url: string;
+};
+/** The owner's photos, in order, come before any stock or sample picture: sections never repeat one, and sample items go round again. */
+declare function planOwnPhotos(slots: ReadonlyArray<StockTarget>, urls: ReadonlyArray<string>): {
+    placements: OwnPhotoPlacement[];
+    rest: StockTarget[];
+};
+/** Each marked sample's gallery shows the owner's photos instead of bundled samples, each list starting where the last one stopped. */
+declare function applyOwnPhotoGalleries(plan: Pick<SitePlan, 'contentTypes'>, items: Readonly<Record<string, ReadonlyArray<Record<string, unknown>>>>, urls: ReadonlyArray<string>): number;
 /** Where a photo may not appear twice: one page; one content type's samples (a list shows them together). */
 declare function stockGroupOf(target: StockTarget): string;
 /**
@@ -6735,5 +6773,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_FAMILY_INTENTS, STOCK_INTENT_ORDER, STOCK_INTENT_SUBJECTS, STOCK_ITEM_ASPECT, STOCK_MIN_KEPT, STOCK_PROVIDER_TERMS, STOCK_SUBJECT_WORDS, STRICT_SCHEMA_BUDGET, STRICT_SCHEMA_LIMITS, STUDIO_TEMPLATE, SiteBuildKind, SiteBuildStatus, SiteCheckId, SiteFindingCode, SiteLocale, SitePlanError, SitePlanIssueCode, SitePlanSourceKind, SiteTemplateError, SiteTemplateId, StepState, StockIntent, StockOrientation, StockProviderId, StockReviewFlag, StockReviewVerdict, StockSlotKind, StockSubject, addBarItem, addStockCredits, aiStepParts, applyPlanEdits, applyStockItemPhotos, applyStockPhotos, archetypeIssues, aspectRatioOf, 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, orientationOfRatio, 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, scoreStockPhoto, sectionEntrances, sectionPatternIds, sectionToWire, setStyleProps, shapeKeys, showcaseGlobals, showcasePages, showcasePlans, siteNavPages, slotBudget, stockCopyKey, stockCreditLine, stockCreditLines, stockCreditNode, stockCreditNodeId, stockFits, stockGroupOf, stockItemSlots, stockKept, stockPhotoRatio, stockPhotoSubject, stockPhotoUsable, stockPhotoWords, stockSlots, stockWord, stockWords, 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, StockItemSlot, StockLink, StockNeed, StockPhoto, StockPhotoTraits, StockPlacement, StockPlanOptions, StockProviderTerms, StockReview, StockSlot, StockTarget, 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, ContentFieldControl, ContentFieldType, ContentRole, ContentTypeAction, CreatedKind, DANGLING_LINK_CODES, DEFAULT_PHONE_MENU_BREAKPOINT, DEFAULT_SITE_LOCALE, ENTRANCE_EASING, ENTRANCE_ORIGIN_LOOK, ENTRANCE_TRIGGER, EntrancePart, EntranceSide, FACT_KEYS, FIELD_TYPE_OF_CONTROL, 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_FAMILY_INTENTS, STOCK_INTENT_ORDER, STOCK_INTENT_SUBJECTS, STOCK_ITEM_ASPECT, STOCK_MIN_KEPT, STOCK_PROVIDER_TERMS, STOCK_SUBJECT_WORDS, STRICT_SCHEMA_BUDGET, STRICT_SCHEMA_LIMITS, STUDIO_TEMPLATE, SiteBuildKind, SiteBuildStatus, SiteCheckId, SiteFindingCode, SiteLocale, SitePlanError, SitePlanIssueCode, SitePlanSourceKind, SiteTemplateError, SiteTemplateId, StepState, StockIntent, StockOrientation, StockProviderId, StockReviewFlag, StockReviewVerdict, StockSlotKind, StockSubject, addBarItem, addStockCredits, aiStepParts, applyOwnPhotoGalleries, applyPlanEdits, applyStockItemPhotos, applyStockPhotos, archetypeIssues, aspectRatioOf, 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, orientationOfRatio, 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, planOwnPhotos, planPartOfPath, planPartToWire, planStockPhotos, planToWire, planWireGaps, planWirePartJsonSchema, planWirePartShape, planWordIssues, publishRefusal, publishVerdict, recipeListBinds, releasedLayoutDefaults, removeBarItem, requiredAcknowledgements, requiredShapeKeys, roleField, routeMatches, routeParams, sampleImageRef, scoreStockPhoto, sectionEntrances, sectionPatternIds, sectionToWire, setStyleProps, shapeKeys, showcaseGlobals, showcasePages, showcasePlans, siteNavPages, slotBudget, stockCopyKey, stockCreditLine, stockCreditLines, stockCreditNode, stockCreditNodeId, stockFits, stockGroupOf, stockItemSlots, stockKept, stockPhotoRatio, stockPhotoSubject, stockPhotoUsable, stockPhotoWords, stockSlots, stockWord, stockWords, 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, OwnPhotoPlacement, 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, StockItemSlot, StockLink, StockNeed, StockPhoto, StockPhotoTraits, StockPlacement, StockPlanOptions, StockProviderTerms, StockReview, StockSlot, StockTarget, StrictSchemaComplexity, StrictSchemaRefusal, TemplatePlanInput, UndoKept, UndoPreview, UndoRecord, WireOptions, WrittenText };

package/package.json

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

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

@@ -16,7 +16,7 @@ import {
 } from './patterns';
 import { recipeListBinds } from './recipe-fields';
 import { assertStyleSlots, ComposeError, createSerializedNode, SerializedBinding, SerializedNode, setStyleProps, walkSerialized } from './serialized-node';
-import {
+import { SitePlanSourceKind, ContentFieldControl, ContentFieldPlan,
     ContentRole, ContentTypePlan, DataSourcePlan, DEFAULT_SITE_LOCALE, FactKey, FACT_KEYS, GlobalSlot, isRtlLocale, PagePlan, PageSectionPlan, PlanDataSourceMode,
     PlanDataSourceType, RelativeOp, roleField, SiteLocale, SitePlan, SitePlanSource, SITE_FACT_LABELS, SiteBusiness,
 } from './site-plan.model';
@@ -1087,13 +1087,32 @@ function expandSeedValue(value: unknown, n: number): unknown {
         .replace(SAMPLE_IMAGE_TEMPLATE, (_m, plus?: string) => sampleImageRef(n + (plus ? Number(plus) : 0)));
 }
 
-function composeItems(type: ContentTypePlan): ComposedItem[] {
+/** An AI plan's sample always has something to edit: a field it left empty gets a marked placeholder, never an invented fact. A template's blanks are deliberate. */
+function defaultSeed(type: ContentTypePlan, field: ContentFieldPlan): unknown {
+    const word = field.name.replace(/([a-z0-9])([A-Z])/g, '$1 $2').replace(/[_-]+/g, ' ').toLowerCase();
+    const defaults: Partial<Record<ContentFieldControl, unknown>> = {
+        [ContentFieldControl.Text]: word === 'slug' ? `sample-${type.name}-{n}`.toLowerCase() : `Sample ${word} {n}`,
+        [ContentFieldControl.Textarea]: `Sample ${word}: two lines the studio replaces.`,
+        [ContentFieldControl.Media]: '{sampleImage:n}',
+        [ContentFieldControl.Gallery]: ['{sampleImage:n}', '{sampleImage:n+1}', '{sampleImage:n+2}'],
+        [ContentFieldControl.List]: [`Sample ${word} {n}`],
+    };
+    return defaults[field.controller as ContentFieldControl];
+}
+
+function composeItems(type: ContentTypePlan, fillEmpty: boolean): ComposedItem[] {
     const seed = type.seed;
     if (!seed) return [];
     const items: ComposedItem[] = [];
     for (let n = 1; n <= seed.count; n++) {
         const item: Record<string, unknown> = {};
-        for (const field of type.fields) if (field.name in seed) item[field.name] = expandSeedValue(seed[field.name], n);
+        for (const field of type.fields) {
+            const given = seed[field.name];
+            const empty = !(field.name in seed) || given === '' || (Array.isArray(given) && !given.length);
+            const own = seed.perItem?.[field.name]?.[n - 1];
+            const value = own || (empty && fillEmpty ? defaultSeed(type, field) : given);
+            if (value !== undefined) item[field.name] = expandSeedValue(value, n);
+        }
         items.push({ ...item, isPublished: seed.isPublished, isSample: seed.sample });
     }
     return items;
@@ -1155,7 +1174,7 @@ export function composeSite(plan: SitePlan, context: ComposeContext): ComposedSi
         business: clone(plan.business),
         design,
         schemas: clone(plan.contentTypes) as ContentTypePlan[],
-        items: Object.fromEntries(plan.contentTypes.map(t => [t.name, composeItems(t)])),
+        items: Object.fromEntries(plan.contentTypes.map(t => [t.name, composeItems(t, plan.source.kind === SitePlanSourceKind.Ai)])),
         dataSources: plan.dataSources.map(composeDataSource),
         pages,
         globals,

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

@@ -4,7 +4,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 {
+import { ContentFieldControl, FIELD_TYPE_OF_CONTROL,
     ContentFieldPlan, ContentTypePlan, DataSourcePlan, FactKey, GlobalSlot, PAGE_ARCHETYPES, PagePlan, PageSectionPlan, PlanDataSourceMode, PlanDataSourceType,
     RelativeOp, SITE_NEED_IDS, SITE_PLAN_VERSION, SitePlan, SitePlanSource, SiteLocale,
 } from './site-plan.model';
@@ -117,8 +117,7 @@ const WIRE_KEYS: Readonly<Record<`${PlanWireEntry}`, Readonly<Record<string, Wir
     },
     field: {
         name: key('field.name'),
-        type: key('field.type'),
-        controller: key('field.controller'),
+        controller: { refs: ['field.controller'], text: `one of ${Object.values(ContentFieldControl).join(', ')} — how the field is edited (gallery is a list of pictures, list a list of words); how it is stored follows from this` },
         required: { refs: ['field.required'], text: 'boolean — the field must be filled', none: 'false' },
         note: key('field.note', "''"),
     },
@@ -126,11 +125,12 @@ const WIRE_KEYS: Readonly<Record<`${PlanWireEntry}`, Readonly<Record<string, Wir
         count: key('seed.count'),
         sample: key('seed.sample'),
         isPublished: key('seed.isPublished'),
-        values: { refs: ['seed.[field]'], text: "seedValue[] — one per field: the samples' value for it" },
+        values: { refs: ['seed.[field]'], text: "seedValue[] — one per field, for EVERY field: the samples' value for it, with {n} for the sample's number and {sampleImage:n} for a picture, words a person replaces" },
     },
     seedValue: {
         field: { refs: ['seed.[field]'], text: 'string — a field of the type' },
         value: { refs: ['seed.[field]'], text: `string | string[] — ${describeShapeKey(PLAN_SHAPE['seed'], '[field]')} (a list for an array field)` },
+        each: { refs: ['seed.perItem'], text: 'string[] — one value per sample, in order, when each sample has its own content', none: '[]' },
     },
     dataSource: {
         alias: { refs: ['cmsDataSource.alias', 'relativeDataSource.alias'] },
@@ -185,6 +185,7 @@ const WIRE_KEYS: Readonly<Record<`${PlanWireEntry}`, Readonly<Record<string, Wir
 
 /** The plan keys the model does not write, and where the expander takes each from. */
 export const PLAN_WIRE_DERIVED: Readonly<Record<string, string>> = {
+    'field.type': 'follows from the field\'s control (FIELD_TYPE_OF_CONTROL)',
     'plan.version': `always '${SITE_PLAN_VERSION}'`,
     'plan.source': 'this run (the context)',
     'plan.locale': "the reading's language (the context)",
@@ -260,7 +261,7 @@ const sectionPatterns = () => sectionPatternIds().map(id => SITE_PATTERNS[id]);
 const globalIds = (position: `${PatternGlobalPosition}`) => Object.entries(SITE_PATTERNS).filter(([, p]) => p.global === position).map(([id]) => id);
 
 export function wireFieldJsonSchema(): JsonSchema {
-    return shaped(PlanWireEntry.Field, { name: jsonText(), type: jsonText(), controller: jsonText(), required: jsonBoolean(), note: jsonText() });
+    return shaped(PlanWireEntry.Field, { name: jsonText(), controller: jsonOneOf(Object.values(ContentFieldControl)), required: jsonBoolean(), note: jsonText() });
 }
 
 /** What an object of the wire travels without when its children are written as their own entries (a plan edit's). */
@@ -284,7 +285,7 @@ const shapedAs = (entry: `${PlanWireEntry}`, options: WireOptions, properties: R
 };
 
 export function wireContentTypeJsonSchema(options: WireOptions = {}): JsonSchema {
-    const value = shaped(PlanWireEntry.SeedValue, { field: jsonText(), value: jsonAnyOf([jsonText(), jsonListOf(jsonText())]) });
+    const value = shaped(PlanWireEntry.SeedValue, { field: jsonText(), value: jsonAnyOf([jsonText(), jsonListOf(jsonText())]), each: jsonListOf(jsonText()) });
     return shapedAs(PlanWireEntry.ContentType, options, {
         name: jsonText(),
         label: jsonText(),
@@ -400,7 +401,8 @@ const each = (list: unknown, expand: (v: unknown) => unknown) => (Array.isArray(
 export function expandWireField(wire: unknown): ContentFieldPlan | unknown {
     if (!isPlainObject(wire)) return wire;
     const { required, note, ...rest } = wire;
-    return { ...rest, ...optional('required', required, v => v === undefined || v === false), ...optional('note', note) };
+    const type = FIELD_TYPE_OF_CONTROL[rest['controller'] as ContentFieldControl];
+    return { ...rest, ...(type ? { type } : {}), ...optional('required', required, v => v === undefined || v === false), ...optional('note', note) };
 }
 
 export function expandWireContentType(wire: unknown, options: WireOptions = {}): ContentTypePlan | unknown {
@@ -411,8 +413,16 @@ export function expandWireContentType(wire: unknown, options: WireOptions = {}):
     if (!isPlainObject(seed)) return seed === undefined ? out : { ...out, seed };
     const { values, ...fixed } = seed;
     if (fixed['count'] === 0 && emptyList(values)) return out;
-    const map = listToMap(values ?? [], 'field', 'value');
-    return { ...out, seed: isPlainObject(map) ? { ...fixed, ...map } : { ...fixed, values } };
+    const perItem: Record<string, unknown> = {};
+    const plain = Array.isArray(values) ? values.map(row => {
+        if (!isPlainObject(row)) return row;
+        const { each, ...rest } = row;
+        if (Array.isArray(each) && each.length) perItem[String(rest['field'])] = each;
+        return rest;
+    }) : values;
+    const map = listToMap(plain ?? [], 'field', 'value');
+    const items = Object.keys(perItem).length ? { perItem } : {};
+    return { ...out, seed: isPlainObject(map) ? { ...fixed, ...items, ...map } : { ...fixed, values } };
 }
 
 export function expandWireDataSource(wire: unknown): DataSourcePlan | unknown {
@@ -494,16 +504,16 @@ export function expandPlanWire(parts: PlanWireParts, context: PlanWireContext):
 // ── The plan → the wire ────────────────────────────────────────────────────────────────────────────────────────────
 
 export function fieldToWire(field: ContentFieldPlan): PlainObject {
-    return { name: field.name, type: field.type, controller: field.controller, required: field.required ?? false, note: field.note ?? NONE };
+    return { name: field.name, controller: field.controller, required: field.required ?? false, note: field.note ?? NONE };
 }
 
 export function contentTypeToWire(type: ContentTypePlan, options: WireOptions = {}): PlainObject {
     const played = type.roles as Readonly<Record<string, string | undefined>>;
     const roles = ROLE_KEYS.filter(role => played[role]).map(role => ({ role, field: played[role] }));
-    const { count = 0, sample = false, isPublished = false, ...values } = type.seed ?? {};
+    const { count = 0, sample = false, isPublished = false, perItem = {}, ...values } = type.seed ?? {};
     return {
         name: type.name, label: type.label, roles, ...(options.children === false ? {} : { fields: type.fields.map(fieldToWire) }),
-        seed: { count, sample, isPublished, values: mapToList(values, 'field', 'value') },
+        seed: { count, sample, isPublished, values: mapToList(values, 'field', 'value').map(row => ({ ...row, each: perItem[String(row['field'])] ?? [] })) },
     };
 }
 

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

@@ -45,7 +45,9 @@ export function writtenTexts(plan: SitePlan): WrittenText[] {
     });
     plan.contentTypes?.forEach((type, t) => {
         add(`contentTypes[${t}].label`, type.label);
-        for (const [field, value] of Object.entries(type.seed ?? {})) {
+        const { perItem, ...seed }: Record<string, unknown> & { perItem?: Readonly<Record<string, ReadonlyArray<string>>> } = type.seed ?? {};
+        for (const [field, list] of Object.entries(perItem ?? {})) list.forEach((v, k) => add(`contentTypes[${t}].seed.perItem.${field}[${k}]`, v));
+        for (const [field, value] of Object.entries(seed)) {
             const values = Array.isArray(value) ? value : [value];
             values.forEach((v, k) => add(`contentTypes[${t}].seed.${field}${Array.isArray(value) ? `[${k}]` : ''}`, v));
         }

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

@@ -32,6 +32,39 @@ export interface SiteBusiness {
     readonly facts?: Readonly<Partial<Record<FactKey, string>>>;
 }
 
+/** How a content field is edited: the closed list a plan chooses from. */
+export enum ContentFieldControl {
+    Text = 'text',
+    Textarea = 'textarea',
+    /** One picture. `image` is the deprecated name of this control. */
+    Media = 'media',
+    /** A list of pictures. */
+    Gallery = 'gallery',
+    /** A list of words. */
+    List = 'list',
+    Number = 'number',
+    Switch = 'switch',
+}
+
+/** How a field is stored. The schema editor's and the item editor's own list: anything else renders no input. */
+export enum ContentFieldType {
+    String = 'string',
+    Number = 'number',
+    Boolean = 'boolean',
+    Array = 'array',
+}
+
+/** ONE rule: how a field is stored follows from how it is edited, so a plan never has to say. */
+export const FIELD_TYPE_OF_CONTROL: Readonly<Record<ContentFieldControl, ContentFieldType>> = {
+    [ContentFieldControl.Text]: ContentFieldType.String,
+    [ContentFieldControl.Textarea]: ContentFieldType.String,
+    [ContentFieldControl.Media]: ContentFieldType.String,
+    [ContentFieldControl.Gallery]: ContentFieldType.Array,
+    [ContentFieldControl.List]: ContentFieldType.Array,
+    [ContentFieldControl.Number]: ContentFieldType.Number,
+    [ContentFieldControl.Switch]: ContentFieldType.Boolean,
+};
+
 export interface ContentFieldPlan {
     readonly name: string;
     readonly type: string;
@@ -46,6 +79,8 @@ export interface ContentSeedPlan {
     readonly count: number;
     readonly sample: boolean;
     readonly isPublished: boolean;
+    /** Per field, one value per sample: real content where the items are about a subject anyone can know. Wins over the field's template. */
+    readonly perItem?: Readonly<Record<string, ReadonlyArray<string>>>;
     readonly [field: string]: unknown;
 }
 

package/src/generation-core/site-spec.generated.ts

@@ -69,6 +69,7 @@ export const SPEC_SITE_PLAN_SHAPE = {
     "count": "integer ≥ 0",
     "sample": "boolean — items are flagged isSample",
     "isPublished": "boolean",
+    "perItem?": "per field, one string per sample: real content that wins over the template",
     "[field]?": "the field's value — strings are templates: {n} = the item's 1-based number, {sampleImage:n} / {sampleImage:n+k} = a bundled sample image"
   },
   "cmsDataSource": {
@@ -4248,12 +4249,12 @@ export const SPEC_SITE_TEMPLATES = {
           {
             "name": "cover",
             "type": "string",
-            "controller": "image"
+            "controller": "media"
           },
           {
             "name": "gallery",
             "type": "array",
-            "controller": "mediaList"
+            "controller": "gallery"
           },
           {
             "name": "year",
@@ -4466,7 +4467,7 @@ export const SPEC_SITE_TEMPLATES = {
           {
             "name": "photo",
             "type": "string",
-            "controller": "image"
+            "controller": "media"
           },
           {
             "name": "price",
@@ -4702,7 +4703,7 @@ export const SPEC_SITE_TEMPLATES = {
           {
             "name": "photo",
             "type": "string",
-            "controller": "image"
+            "controller": "media"
           }
         ],
         "seed": {

package/src/generation-core/stock-photos.ts

@@ -122,6 +122,43 @@ export interface StockItemSlot extends StockNeed {
 
 export type StockTarget = StockSlot | StockItemSlot;
 
+/** Where the owner's photo goes: a slot of a composed section or the image field of a sample item. */
+export type OwnPhotoPlacement = (Pick<StockSlot, 'nodeId' | 'owner'> | { item: Pick<StockItemSlot, 'contentType' | 'index' | 'field'> }) & { url: string };
+
+/** The owner's photos, in order, come before any stock or sample picture: sections never repeat one, and sample items go round again. */
+export function planOwnPhotos(slots: ReadonlyArray<StockTarget>, urls: ReadonlyArray<string>): { placements: OwnPhotoPlacement[]; rest: StockTarget[] } {
+    if (!urls.length) return { placements: [], rest: [...slots] };
+    const placements: OwnPhotoPlacement[] = [];
+    const rest: StockTarget[] = [];
+    let next = 0;
+    for (const slot of slots) {
+        if (slot.kind === StockSlotKind.Section) {
+            if (next < urls.length) placements.push({ nodeId: slot.nodeId, owner: slot.owner, url: urls[next++] });
+            else rest.push(slot);
+        } else {
+            placements.push({ item: { contentType: slot.contentType, index: slot.index, field: slot.field }, url: urls[next++ % urls.length] });
+        }
+    }
+    return { placements, rest };
+}
+
+/** Each marked sample's gallery shows the owner's photos instead of bundled samples, each list starting where the last one stopped. */
+export function applyOwnPhotoGalleries(plan: Pick<SitePlan, 'contentTypes'>, items: Readonly<Record<string, ReadonlyArray<Record<string, unknown>>>>, urls: ReadonlyArray<string>): number {
+    if (!urls.length) return 0;
+    let changed = 0;
+    for (const type of plan.contentTypes) {
+        const field = roleField(type, ContentRole.Gallery);
+        if (!field) continue;
+        (items[type.name] ?? []).forEach((item, index) => {
+            const list = item[field];
+            if (!item['isSample'] || !Array.isArray(list)) return;
+            item[field] = list.map((value, i) => (parseSampleImageRef(value) === null ? value : urls[(index + i) % urls.length]));
+            changed++;
+        });
+    }
+    return changed;
+}
+
 /** Where a photo may not appear twice: one page; one content type's samples (a list shows them together). */
 export function stockGroupOf(target: StockTarget): string {
     return target.kind === StockSlotKind.Section ? `page:${target.owner}` : `items:${target.contentType}`;

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

@@ -6,7 +6,7 @@ import {
     BindScope, patternById, patternHasForm, patternLinkSlots, patternNeedsBinding, patternOptionalParts, patternRoleNeeds, patternTakesBinding, patternScopes,
     patternSlots, PatternGlobalPosition, slotBudget,
 } from './patterns';
-import {
+import { ContentFieldControl, FIELD_TYPE_OF_CONTROL,
     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';
@@ -103,6 +103,7 @@ const ROLE_KEYS = shapeKeys(SHAPE['roles']);
 const PAGE_SEO_KEYS = shapeKeys(SHAPE['pageSeo']);
 const ARRAY_TYPE = 'array';
 const FIELD_KEYS = shapeKeys(SHAPE['field']);
+const SLUG_FIELD = 'slug';
 const SEED_FIXED_KEYS = shapeKeys(SHAPE['seed']);
 const CMS_SOURCE_KEYS = shapeKeys(SHAPE['cmsDataSource']);
 const RELATIVE_SOURCE_KEYS = shapeKeys(SHAPE['relativeDataSource']);
@@ -208,8 +209,11 @@ function validateContentTypes(c: Collector, list: unknown[]): Map<string, Conten
             const fp = `${path}.fields[${j}]`;
             if (!isObject(f)) { c.add(SitePlanIssueCode.Shape, fp, 'must be an object'); return null; }
             c.keys(f, FIELD_KEYS, fp);
-            c.string(f, 'type', fp);
-            c.string(f, 'controller', fp);
+            const control = c.string(f, 'controller', fp);
+            const stored = c.string(f, 'type', fp);
+            const expected = control ? FIELD_TYPE_OF_CONTROL[control as ContentFieldControl] : undefined;
+            if (control && !expected) c.add(SitePlanIssueCode.Shape, `${fp}.controller`, `"${control}" is not a field control (${Object.values(ContentFieldControl).join(', ')})`);
+            if (expected && stored && stored !== expected) c.add(SitePlanIssueCode.Shape, `${fp}.type`, `a ${control} field is stored as ${expected}, not "${stored}"`);
             c.boolean(f, 'required', fp);
             return c.string(f, 'name', fp);
         });
@@ -223,6 +227,16 @@ function validateContentTypes(c: Collector, list: unknown[]): Map<string, Conten
             else {
                 if (!Number.isInteger(seed['count']) || (seed['count'] as number) < 0) c.add(SitePlanIssueCode.Shape, `${path}.seed.count`, 'must be a whole number');
                 for (const key of ['sample', 'isPublished']) if (typeof seed[key] !== 'boolean') c.add(SitePlanIssueCode.Shape, `${path}.seed.${key}`, 'must be a boolean');
+                const perItem = seed['perItem'];
+                if (perItem !== undefined) {
+                    if (!isObject(perItem)) c.add(SitePlanIssueCode.Shape, `${path}.seed.perItem`, 'must be an object');
+                    else for (const [field, list] of Object.entries(perItem)) {
+                        const at = `${path}.seed.perItem.${field}`;
+                        if (!fieldSet.has(field)) c.add(SitePlanIssueCode.UnknownField, at, `"${field}" is not a field of ${name}`);
+                        else if (!Array.isArray(list) || list.length !== seed['count'] || list.some(v => typeof v !== 'string')) c.add(SitePlanIssueCode.Shape, at, `must be ${String(seed['count'])} strings, one per sample`);
+                        else if (field === SLUG_FIELD && new Set(list).size !== list.length) c.add(SitePlanIssueCode.Shape, at, 'each sample needs its own slug');
+                    }
+                }
                 for (const key of Object.keys(seed)) {
                     if (!SEED_FIXED_KEYS.includes(key) && !fieldSet.has(key)) c.add(SitePlanIssueCode.UnknownField, `${path}.seed.${key}`, `"${key}" is not a field of ${name}`);
                 }

package/src/seo-core/schema.ts

@@ -72,7 +72,7 @@ export function buildSeoSchemaProperties(): Record<string, unknown> {
                 image: {
                     type: 'string',
                     label: 'OG Image',
-                    controller: { type: 'image' },
+                    controller: { type: 'media' },
                 },
             },
         },
@@ -102,7 +102,7 @@ export function buildSeoSchemaProperties(): Record<string, unknown> {
                 image: {
                     type: 'string',
                     label: 'Twitter Image',
-                    controller: { type: 'image' },
+                    controller: { type: 'media' },
                 },
             },
         },