@vectoriox/iox-ui 5.55.0 → 5.56.1

package/generation-core/index.d.ts

@@ -1,4 +1,4 @@
-import { DesignChoices, AnimateId } from '@vectoriox/iox-ui/design-core';
+import { DesignChoices, AnimateId, DesignTokenLike } from '@vectoriox/iox-ui/design-core';
 
 declare const SPEC_SITE_PLAN_SHAPE: {
     readonly plan: {
@@ -2884,6 +2884,8 @@ declare enum BuildStep {
     Preflight = "preflight",
     ContentTypes = "content-types",
     SampleImages = "sample-images",
+    /** I2: the curated stock photos the plan's empty picture slots take, copied into the studio (never hot-linked). */
+    StockPhotos = "stock-photos",
     Items = "items",
     DataSources = "data-sources",
     Pages = "pages",
@@ -2903,6 +2905,8 @@ declare enum CreatedKind {
     /** Fields the build added to a content type it found (types are shared by every organization of a studio). */
     ContentTypeFields = "content-type-fields",
     SampleImage = "sample-image",
+    /** A stock photo copied into the studio's storage (`media/stock/…`), with its assets row. */
+    StockPhoto = "stock-photo",
     Item = "item",
     DataSource = "data-source",
     Page = "page",
@@ -2964,7 +2968,9 @@ declare enum BuildNoticeCode {
     /** Storage is not configured: sample items get the empty image box, and the run says so. */
     NoStorage = "no-storage",
     /** A content type the build reuses is not public in this studio: the site will not show its items. */
-    ContentTypeNotPublic = "content-type-not-public"
+    ContentTypeNotPublic = "content-type-not-public",
+    /** The stock library could not be read: the picture slots keep the empty box, and the run says so. */
+    StockUnavailable = "stock-unavailable"
 }
 interface BuildNotice {
     code: string;
@@ -3034,6 +3040,7 @@ declare const buildKeys: {
     readonly contentTypeFields: (name: string) => string;
     readonly item: (contentType: string, n: number) => string;
     readonly sampleImage: (n: number) => string;
+    readonly stockPhoto: (libraryKey: string) => string;
     readonly dataSource: (alias: string) => string;
     readonly page: (key: string) => string;
     readonly global: (nodeId: string) => string;
@@ -3473,5 +3480,217 @@ declare function wordPattern(word: string): RegExp;
 /** The words to avoid and the facts never given, in every written text of the plan. */
 declare function planWordIssues(plan: SitePlan, ctx: PlanWordContext): PlanWordIssue[];
 
-export { ACTIVE_BUILD_STATUSES, AI_REFUSAL_NEXT, AI_REFUSAL_STATUS, AI_STEPS, AI_STEP_LABELS, AI_STEP_NEEDS, AI_STEP_TYPICAL_TOKENS, AiCallStatus, AiCapability, AiGenerationStage, AiKeyMode, AiNextKind, AiProviderId, AiRefusalCode, AiStep, BAR_ITEMS_MAX, BAR_ITEMS_MIN, BASELINE_ROLES, BUILD_STEPS, BaselineRole, BindScope, BuildNoticeCode, BuildStep, CREDITS_PER_USD, CardBindTarget, ComposeError, ComposeIssueCode, ContentTypeAction, CreatedKind, DANGLING_LINK_CODES, DEFAULT_PHONE_MENU_BREAKPOINT, ENTRANCE_EASING, ENTRANCE_ORIGIN_LOOK, ENTRANCE_TRIGGER, EntrancePart, FACT_KEYS, FINAL_GENERATION_STAGES, GlobalSlot, JSON_SCHEMA_BANNED_KEYWORDS, JsonSchemaShapeError, KeptReason, NAV_PART_LABELS, NAV_SHAPE_COPY, NEUTRAL_STYLE_PROPS, NODE_BASELINES, NO_TOKENS, NavPagesSource, NavRole, NavShape, NavShapeError, PLAN_EDITS_ANSWER_SHAPE, PLAN_EDITS_SCHEMA_NAME, PLAN_EDIT_SHAPE, PRICING_PATTERN, PUBLISH_BLOCKING_PLACEHOLDERS, PageDataKind, PathIssueCollector, PatternDirective, PatternGlobalPosition, PatternOpens, PatternPlaceholder, PatternRecipe, PhoneMenuBreakpoint, PlaceholderKind, PlanChangeAction, PlanChangeKind, PlanDataSourceMode, PlanDataSourceType, PlanEditIssueCode, PlanEditOp, PlanEditsOutcome, PlanWordIssueCode, PreflightRefusalCode, RelativeOp, SAMPLE_IMAGE_REF, SITE_FACT_LABELS, SITE_HEADER_PATTERN, SITE_PATTERNS, SITE_PLAN_SCHEMA_NAME, SITE_PLAN_VERSION, SITE_TEMPLATES, SPEC_SITE_FACTS, SPEC_SITE_LIBRARY, SPEC_SITE_PATTERNS, SPEC_SITE_PLAN_SHAPE, SPEC_SITE_TEMPLATES, STUDIO_TEMPLATE, SiteBuildKind, SiteBuildStatus, SitePlanError, SitePlanIssueCode, SitePlanSourceKind, SitePlanWireKey, SiteTemplateError, SiteTemplateId, StepState, addBarItem, altSourceScopes, applyPlanEdits, assertStyleSlots, assertValidSitePlan, barIconForRoute, blocksPublish, buildKeys, buildStepFacts, builtHomePageId, composeNavHeader, composeSection, composeSite, contentTypeFromWire, contentTypeJsonSchema, costUsd, createSerializedNode, creditsOfUsd, dataSourceJsonSchema, describePlanData, describeShapeKey, entranceAction, entranceInteraction, estimateStepCredits, failedBuildStep, fieldJsonSchema, findNavRoot, isActiveBuild, isNonEmptyString, isPlainObject, jsonAnyOf, jsonBoolean, jsonClosedObject, jsonInteger, jsonListOf, jsonOneOf, jsonSchemaKeywords, jsonSchemaObjects, jsonShapedObject, jsonText, modelCanDo, moveBarItem, navPages, navShapeBreakpoint, navShapeOf, nextSourceOf, nodeBindPaths, pageJsonSchema, parseSampleImageRef, pathAt, patternById, patternNeedsBinding, patternNodes, patternOptionalParts, patternScopes, patternSlots, patternTakesBinding, phoneMenuPages, planEditsFromWire, planEditsJsonSchema, planFromTemplate, planNavShape, planWordIssues, releasedLayoutDefaults, removeBarItem, requiredShapeKeys, routeParams, sampleImageRef, sectionEntrances, sectionFromWire, sectionJsonSchema, sectionPatternIds, setStyleProps, shapeKeys, siteNavPages, sitePlanFromWire, sitePlanJsonSchema, sitePlanToWire, staggerDelay, validatePlanEdits, validateSitePlan, walkSerialized, wordPattern, writtenTexts };
-export type { AddBarItemResult, AiMeter, AiModelEntry, AiRefusal, AiTokenCounts, AiTokenPrice, BarItemsEditResult, BuildNotice, BuildStepError, BuildStepFacts, BuildStepRecord, CmsDataSourcePlan, ComposeContext, ComposeIssue, ComposedDataSource, ComposedItem, ComposedNavHeader, ComposedPage, ComposedPlaceholder, ComposedRoute, ComposedSection, ComposedSite, ContentFieldPlan, ContentSeedPlan, ContentTypePlan, CreateNodeOptions, CreatedRecord, DataSourcePlan, DynamicKeysAsList, EntranceAction, EntranceInteraction, EntranceSpec, FactKey, JsonSchema, NavHeaderInput, NavHeaderOptions, NavPage, NavShapeOptions, NavShapeResult, NodeBaseline, PageData, PageDataLine, PagePlan, PageSectionPlan, PathIssue, PatternNode, PlainObject, PlanChange, PlanEdit, PlanEditIssue, PlanEditResult, PlanEditsAnswer, PlanWordContext, PlanWordIssue, PreflightRefusal, RelativeDataSourcePlan, SectionEntrances, SectionInput, SectionOptions, SerializedBinding, SerializedNode, SerializedResponsive, ShapeEntry, ShapeIssueCodes, SiteBuildRun, SiteBusiness, SitePageRef, SitePattern, SitePlan, SitePlanIssue, SitePlanSchemaPin, SitePlanSource, SitePlanValidation, SiteTemplate, TemplatePlanInput, UndoKept, UndoPreview, UndoRecord, WrittenText };
+/**
+ * THE Publishable gate (AI plan §3e, M1-7): ONE pure function over a snapshot of a site — its pages, globals, the
+ * connectors' health, the look's token rows, what a build left to fill — run by the Publish dialog, the builder's
+ * Needs attention and the server on publish (iox-cms refuses with the same findings). Works on any site, generated
+ * or hand-built. Severity is decision D8: an unfilled fact, a policy placeholder or an action that points at nothing
+ * BLOCKS; samples, copy placeholders and stock photos ASK ("Publish anyway"); the rest WARN. Design advice
+ * (harness-core `lintDesign`) is not one of the eight — the caller adds it, and it never blocks.
+ */
+declare enum SiteCheckId {
+    Navigation = "navigation",
+    Forms = "forms",
+    Consent = "consent",
+    Seo = "seo",
+    Facts = "facts",
+    Accessibility = "accessibility",
+    Tokens = "tokens",
+    Actions = "actions"
+}
+/** The eight, in §3e's order. */
+declare const SITE_CHECKS: ReadonlyArray<SiteCheckId>;
+declare enum CheckSeverity {
+    Block = "block",
+    Ask = "ask",
+    Warn = "warn"
+}
+declare enum SiteFindingCode {
+    NoHeader = "no-header",
+    NoPhoneMenu = "no-phone-menu",
+    FormWithoutId = "form-without-id",
+    EmailNeedsMailer = "email-needs-mailer",
+    TrackerWithoutBanner = "tracker-without-banner",
+    NoTitle = "no-title",
+    NoDescription = "no-description",
+    UnfilledFact = "unfilled-fact",
+    CopyPlaceholder = "copy-placeholder",
+    SampleItems = "sample-items",
+    StockPhoto = "stock-photo",
+    NoPrivacyPage = "no-privacy-page",
+    PrivacyPagePlaceholder = "privacy-page-placeholder",
+    LowContrast = "low-contrast",
+    HeadingOrder = "heading-order",
+    ImageWithoutAlt = "image-without-alt",
+    LiteralColour = "literal-colour",
+    DeadLink = "dead-link",
+    DeadDialogTarget = "dead-dialog-target",
+    ActionNeedsConnector = "action-needs-connector"
+}
+/** Each finding's severity — one table (D8), never decided at a call site. */
+declare const FINDING_SEVERITY: Readonly<Record<SiteFindingCode, CheckSeverity>>;
+interface SiteFinding {
+    check: SiteCheckId;
+    severity: CheckSeverity;
+    code: SiteFindingCode;
+    /** In plain words, for the screen. */
+    message: string;
+    pageId?: string;
+    nodeId?: string;
+    /** The global slot (`header` / `footer`) when it is in a global. */
+    owner?: string;
+}
+interface SiteCheck {
+    id: SiteCheckId;
+    passed: boolean;
+    findings: SiteFinding[];
+}
+interface SiteAudit {
+    checks: SiteCheck[];
+    blocking: number;
+    asking: number;
+}
+/** A page as the gate reads it. */
+interface AuditPage {
+    id: string;
+    name: string;
+    route: string;
+    layout: ReadonlyArray<SerializedNode>;
+    seo?: unknown;
+}
+/** A placeholder a build left, and whether the node still shows it (the caller compares the node's text). */
+interface AuditPlaceholder extends ComposedPlaceholder {
+    pageId?: string;
+    filled: boolean;
+}
+interface SiteAuditSnapshot {
+    pages: ReadonlyArray<AuditPage>;
+    globals: ReadonlyArray<SerializedNode>;
+    /** Connector type → usable (configured or provided, and healthy). */
+    connectors: Readonly<Record<string, boolean>>;
+    /** Connector types that set a tracker (a consent category) and are configured. */
+    trackers?: ReadonlyArray<string>;
+    /** The look's token rows and the mode(s) the site wears. */
+    design?: {
+        rows: ReadonlyArray<DesignTokenLike>;
+        modes: ReadonlyArray<'light' | 'dark'>;
+    } | null;
+    placeholders?: ReadonlyArray<AuditPlaceholder>;
+    /** Sample items still in the site (`isSample`). */
+    samples?: ReadonlyArray<{
+        contentType: string;
+        id: string;
+        label?: string;
+    }>;
+    /** Stock photos a build placed that are still on the page. */
+    stock?: ReadonlyArray<{
+        nodeId: string;
+        pageId?: string;
+        owner?: string;
+    }>;
+}
+interface SiteAuditOptions {
+    /** Audit as if only this page were being published (its own page checks + every site-wide one). */
+    pageId?: string;
+}
+/** A route pattern (`/work/:slug`) matches a concrete path (`/work/blue-bowl`). */
+declare function routeMatches(pattern: string, path: string): boolean;
+/** Run the eight checks. `pageId` narrows the page checks to the page being published; site-wide ones always run. */
+declare function auditSite(snapshot: SiteAuditSnapshot, options?: SiteAuditOptions): SiteAudit;
+/** What a publish request must acknowledge: every ASK finding's code (a BLOCK cannot be acknowledged). */
+declare function requiredAcknowledgements(audit: SiteAudit): SiteFindingCode[];
+/** The publish verdict: blocked (never acknowledgeable), needs these acknowledgements, or free to go. */
+declare function publishVerdict(audit: SiteAudit, acknowledged?: ReadonlyArray<string>): {
+    ok: boolean;
+    blocked: boolean;
+    missing: SiteFindingCode[];
+};
+
+/**
+ * Stock photos in a built site (AI plan §3g / §3m, I2): a FREE picture from the platform's curated library, copied
+ * into the studio's own storage (never hot-linked), placed only in an EMPTY picture slot of a section that may show
+ * one — never the owner's work (a collection, a detail page, a gallery: what the nine portfolio types sell is theirs),
+ * never a person (testimonials, the team), never anywhere when the business type says `stock: false`. Its alt text is
+ * the provider's description of what it shows (never a claim), and the credit line its licence requires is placed in
+ * the footer. Pure: the build step does the copying.
+ */
+/** Where a stock photo comes from (the library's provider). */
+declare enum StockProviderId {
+    Magnific = "magnific"
+}
+/** What a picture's licence asks of the site that shows it. */
+interface StockCredit {
+    provider: `${StockProviderId}`;
+    /** The provider's id of the picture. */
+    resourceId: string;
+    /** The provider's page for it. */
+    sourceUrl: string;
+    /** The provider's own title — what the picture shows. */
+    title: string;
+    author: string;
+    /** `freemium` — the free licence (premium pictures never enter the library). */
+    licence: string;
+    licenceUrl: string;
+    /** The words the licence requires, and where they link. */
+    line: string;
+    lineUrl: string;
+}
+/** One picture of the platform library (`iox-stock/<type>/`), as its manifest lists it. */
+interface StockPhoto {
+    /** The library key (`spa/12345.jpg`) — the copy's file name is derived from it. */
+    key: string;
+    /** Where the build downloads it from (the platform bucket). */
+    url: string;
+    /** What it shows, in the provider's words — the alt text. Never a claim. */
+    alt: string;
+    width?: number;
+    height?: number;
+    credit: StockCredit;
+}
+/** The section families a stock photo may stand in for a picture in. */
+declare const STOCK_FAMILIES: ReadonlySet<string>;
+interface StockSlot {
+    /** The Image node the photo goes into. */
+    nodeId: string;
+    /** The page key it lives on. */
+    owner: string;
+    pattern: string;
+}
+/** The empty picture slots of a composed site a stock photo may fill, in page and section order. */
+declare function stockSlots(plan: SitePlan, composed: Pick<ComposedSite, 'pages' | 'placeholders'>): StockSlot[];
+interface StockPlacement extends StockSlot {
+    photo: StockPhoto;
+}
+/** Which photo goes where: the library's photos in order, one per slot, never twice; none when the type says no stock. */
+declare function planStockPhotos(slots: ReadonlyArray<StockSlot>, photos: ReadonlyArray<StockPhoto>, stockAllowed: boolean): StockPlacement[];
+/** A placed photo's copy in the studio's storage: the key the build writes it under. */
+declare function stockCopyKey(photo: Pick<StockPhoto, 'key'>): string;
+/** Put the studio's copy of each photo into its slot (src + the provider's alt). Returns the nodes changed. */
+declare function applyStockPhotos(trees: ReadonlyArray<SerializedNode>, placed: ReadonlyArray<{
+    nodeId: string;
+    url: string;
+    alt: string;
+}>): number;
+/** The credit lines a set of photos needs — one per distinct line (a free Magnific photo: "Designed by Magnific"). */
+declare function stockCreditLines(photos: ReadonlyArray<Pick<StockPhoto, 'credit'>>): Array<{
+    line: string;
+    url: string;
+}>;
+/** The footer node id of a credit line (stable — a build that runs twice finds it). */
+declare const stockCreditNodeId: (index: number) => string;
+/**
+ * The credit line, as the builder would create a Link (a plain node the owner may move or restyle): the licence's words,
+ * linking where it asks, opening in a new tab. Placed at the end of the footer — the place the licence names for a site.
+ */
+declare function stockCreditNode(index: number, credit: {
+    line: string;
+    url: string;
+}): SerializedNode;
+/** Append the credit lines to the footer root (once each). Returns how many it added. */
+declare function addStockCredits(footer: SerializedNode, credits: ReadonlyArray<{
+    line: string;
+    url: string;
+}>): number;
+
+export { ACTIVE_BUILD_STATUSES, AI_REFUSAL_NEXT, AI_REFUSAL_STATUS, AI_STEPS, AI_STEP_LABELS, AI_STEP_NEEDS, AI_STEP_TYPICAL_TOKENS, AiCallStatus, AiCapability, AiGenerationStage, AiKeyMode, AiNextKind, AiProviderId, AiRefusalCode, AiStep, BAR_ITEMS_MAX, BAR_ITEMS_MIN, BASELINE_ROLES, BUILD_STEPS, BaselineRole, BindScope, BuildNoticeCode, BuildStep, CREDITS_PER_USD, CardBindTarget, CheckSeverity, ComposeError, ComposeIssueCode, ContentTypeAction, CreatedKind, DANGLING_LINK_CODES, DEFAULT_PHONE_MENU_BREAKPOINT, ENTRANCE_EASING, ENTRANCE_ORIGIN_LOOK, ENTRANCE_TRIGGER, EntrancePart, FACT_KEYS, FINAL_GENERATION_STAGES, FINDING_SEVERITY, GlobalSlot, JSON_SCHEMA_BANNED_KEYWORDS, JsonSchemaShapeError, KeptReason, NAV_PART_LABELS, NAV_SHAPE_COPY, NEUTRAL_STYLE_PROPS, NODE_BASELINES, NO_TOKENS, NavPagesSource, NavRole, NavShape, NavShapeError, PLAN_EDITS_ANSWER_SHAPE, PLAN_EDITS_SCHEMA_NAME, PLAN_EDIT_SHAPE, PRICING_PATTERN, PUBLISH_BLOCKING_PLACEHOLDERS, PageDataKind, PathIssueCollector, PatternDirective, PatternGlobalPosition, PatternOpens, PatternPlaceholder, PatternRecipe, PhoneMenuBreakpoint, PlaceholderKind, PlanChangeAction, PlanChangeKind, PlanDataSourceMode, PlanDataSourceType, PlanEditIssueCode, PlanEditOp, PlanEditsOutcome, PlanWordIssueCode, PreflightRefusalCode, RelativeOp, SAMPLE_IMAGE_REF, SITE_CHECKS, SITE_FACT_LABELS, SITE_HEADER_PATTERN, SITE_PATTERNS, SITE_PLAN_SCHEMA_NAME, SITE_PLAN_VERSION, SITE_TEMPLATES, SPEC_SITE_FACTS, SPEC_SITE_LIBRARY, SPEC_SITE_PATTERNS, SPEC_SITE_PLAN_SHAPE, SPEC_SITE_TEMPLATES, STOCK_FAMILIES, STUDIO_TEMPLATE, SiteBuildKind, SiteBuildStatus, SiteCheckId, SiteFindingCode, SitePlanError, SitePlanIssueCode, SitePlanSourceKind, SitePlanWireKey, SiteTemplateError, SiteTemplateId, StepState, StockProviderId, addBarItem, addStockCredits, altSourceScopes, applyPlanEdits, applyStockPhotos, assertStyleSlots, assertValidSitePlan, auditSite, barIconForRoute, blocksPublish, buildKeys, buildStepFacts, builtHomePageId, composeNavHeader, composeSection, composeSite, contentTypeFromWire, contentTypeJsonSchema, costUsd, createSerializedNode, creditsOfUsd, dataSourceJsonSchema, describePlanData, describeShapeKey, entranceAction, entranceInteraction, estimateStepCredits, failedBuildStep, fieldJsonSchema, findNavRoot, isActiveBuild, isNonEmptyString, isPlainObject, jsonAnyOf, jsonBoolean, jsonClosedObject, jsonInteger, jsonListOf, jsonOneOf, jsonSchemaKeywords, jsonSchemaObjects, jsonShapedObject, jsonText, modelCanDo, moveBarItem, navPages, navShapeBreakpoint, navShapeOf, nextSourceOf, nodeBindPaths, pageJsonSchema, parseSampleImageRef, pathAt, patternById, patternNeedsBinding, patternNodes, patternOptionalParts, patternScopes, patternSlots, patternTakesBinding, phoneMenuPages, planEditsFromWire, planEditsJsonSchema, planFromTemplate, planNavShape, planStockPhotos, planWordIssues, publishVerdict, releasedLayoutDefaults, removeBarItem, requiredAcknowledgements, requiredShapeKeys, routeMatches, routeParams, sampleImageRef, sectionEntrances, sectionFromWire, sectionJsonSchema, sectionPatternIds, setStyleProps, shapeKeys, siteNavPages, sitePlanFromWire, sitePlanJsonSchema, sitePlanToWire, staggerDelay, stockCopyKey, stockCreditLines, stockCreditNode, stockCreditNodeId, stockSlots, validatePlanEdits, validateSitePlan, walkSerialized, wordPattern, writtenTexts };
+export type { AddBarItemResult, AiMeter, AiModelEntry, AiRefusal, AiTokenCounts, AiTokenPrice, AuditPage, AuditPlaceholder, BarItemsEditResult, BuildNotice, BuildStepError, BuildStepFacts, BuildStepRecord, CmsDataSourcePlan, ComposeContext, ComposeIssue, ComposedDataSource, ComposedItem, ComposedNavHeader, ComposedPage, ComposedPlaceholder, ComposedRoute, ComposedSection, ComposedSite, ContentFieldPlan, ContentSeedPlan, ContentTypePlan, CreateNodeOptions, CreatedRecord, DataSourcePlan, DynamicKeysAsList, EntranceAction, EntranceInteraction, EntranceSpec, FactKey, JsonSchema, NavHeaderInput, NavHeaderOptions, NavPage, NavShapeOptions, NavShapeResult, NodeBaseline, PageData, PageDataLine, PagePlan, PageSectionPlan, PathIssue, PatternNode, PlainObject, PlanChange, PlanEdit, PlanEditIssue, PlanEditResult, PlanEditsAnswer, PlanWordContext, PlanWordIssue, PreflightRefusal, RelativeDataSourcePlan, SectionEntrances, SectionInput, SectionOptions, SerializedBinding, SerializedNode, SerializedResponsive, ShapeEntry, ShapeIssueCodes, SiteAudit, SiteAuditOptions, SiteAuditSnapshot, SiteBuildRun, SiteBusiness, SiteCheck, SiteFinding, SitePageRef, SitePattern, SitePlan, SitePlanIssue, SitePlanSchemaPin, SitePlanSource, SitePlanValidation, SiteTemplate, StockCredit, StockPhoto, StockPlacement, StockSlot, TemplatePlanInput, UndoKept, UndoPreview, UndoRecord, WrittenText };

package/harness-core/index.d.ts

@@ -2954,5 +2954,23 @@ declare const GENERATION_LIMITS: {
     readonly sentenceChars: 500;
 };
 
-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, presetHasSerifHeadings, presetLook, presetReason, rankStylePresets, rankWithReferences, readPalette, referenceSeed, seedPassesPreset, siteAnalysisJsonSchema, siteReadingJsonSchema, 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, SiteNeed, SiteReaderView, SiteReading, StructureChoice, StructureId, StyleHints, StyleRead, UserAvoidId };
+/**
+ * The look a business STARTS from (AI plan §3d "Build with these", §3o, MO-D3) — ONE rule for the wizard's Design step
+ * (a Look pick) and the server's "Build with these": the preset at its defaults, Scrolling · How animated · Between
+ * pages started from the kind of business (and the references), the owner's own Motion choices kept, and — given
+ * references — the best-ranked style with the reference colour as its seed when that colour passes AA in every mode
+ * the style offers (`referenceSeed`). Pure.
+ */
+/** A preset for this business: its choices, Motion from the business (`motionFor`), what the owner already set kept. */
+declare function presetDesign(presetId: string, input: MotionInput | string | null, kept?: Partial<Pick<DesignChoices, 'scroll' | 'animate' | 'between' | 'motion'>>, read?: StyleRead | null): DesignChoices | null;
+interface StartingDesign {
+    presetId: string;
+    design: DesignChoices;
+    /** The reference colour was used as the seed (it passed AA in every mode the style offers). */
+    referenceColour: boolean;
+}
+/** The look a business starts from: its best-ranked style (with the references' boost), at its defaults. */
+declare function startingDesign(input: (RankInput & MotionInput) | string | null, read?: StyleRead | null): StartingDesign | null;
+
+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 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, SiteNeed, SiteReaderView, SiteReading, StartingDesign, StructureChoice, StructureId, StyleHints, StyleRead, UserAvoidId };

package/package.json

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