@vectoriox/iox-ui 5.83.0 → 5.84.0

package/generation-core/index.d.ts

@@ -1,5 +1,5 @@
 import { FrameSequence } from '@vectoriox/iox-ui/media-core';
-import { AnimateId, DesignChoices, DesignTokenLike } from '@vectoriox/iox-ui/design-core';
+import { DesignChoices, AnimateId, DesignTokenLike } from '@vectoriox/iox-ui/design-core';
 import { SeoRawDoc } from '@vectoriox/iox-ui/seo-core';
 import { ContentFieldLike } from '@vectoriox/iox-ui/composite-core';
 
@@ -15,10 +15,19 @@ declare const SPEC_SITE_PLAN_SHAPE: {
         readonly pages: "page[]";
         readonly globals: "globals";
         readonly "film?": "film — the owner's film as pictures (SC6b), set by the build and placed by placeFilm; never a model's";
+        readonly "artDirection?": "artDirection — what every picture made for the site shares (M7): set by the generation from the business type and the look (generation-core artDirectionFor); never a model's";
     };
     readonly film: {
         readonly sequence: "object — a media-core FrameSequence: where the numbered pictures live, how many, their size";
     };
+    readonly artDirection: {
+        readonly world: "string — a site.pictureWorlds id";
+        readonly medium: "string — the picture's medium and lens";
+        readonly light: "string — its light";
+        readonly grade: "string — its colour grade";
+        readonly texture: "string — its texture";
+        readonly negative: "string[] — what no picture of the site may show (site.pictureNever, then the world's own)";
+    };
     readonly sourceTemplate: {
         readonly kind: "'template'";
         readonly templateId: "string";
@@ -4735,6 +4744,81 @@ declare const SPEC_SITE_LIBRARY: readonly [{
     readonly family: "footer";
     readonly composed: true;
 }];
+declare const SPEC_SITE_PICTURE_WORLDS: {
+    readonly documentary: {
+        readonly label: "Documentary";
+        readonly medium: "an unposed documentary photograph, 35mm lens, natural eye-level framing";
+        readonly light: "available natural light, soft and directional";
+        readonly grade: "true-to-life colour with gentle contrast";
+        readonly texture: "fine natural grain and real, lived-in surfaces";
+        readonly negative: readonly ["staged poses", "a studio backdrop"];
+        readonly dark: "low-key";
+    };
+    readonly "high-key": {
+        readonly label: "High-key";
+        readonly medium: "a bright editorial photograph, 50mm lens, a clean composition with generous air";
+        readonly light: "soft, even daylight from a large window; few, pale shadows";
+        readonly grade: "a light, airy palette with lifted whites and low contrast";
+        readonly texture: "smooth surfaces and crisp, gentle detail";
+        readonly negative: readonly ["harsh shadows", "dark corners"];
+        readonly dark: "low-key";
+    };
+    readonly "low-key": {
+        readonly label: "Low-key";
+        readonly medium: "a moody photograph, 50mm lens at a wide aperture, shallow depth of field";
+        readonly light: "one warm, low light source; most of the frame falls into deep shadow";
+        readonly grade: "rich blacks with warm, glowing highlights";
+        readonly texture: "a soft haze in the air and a gentle film grain";
+        readonly negative: readonly ["flat lighting", "a bright background"];
+        readonly dark: "low-key";
+    };
+    readonly "hard-light": {
+        readonly label: "Hard light";
+        readonly medium: "a graphic photograph, 35mm lens, bold and simple shapes";
+        readonly light: "hard, direct sunlight with crisp, long cast shadows";
+        readonly grade: "saturated colour and punchy contrast";
+        readonly texture: "sharp edges and clean planes";
+        readonly negative: readonly ["haze", "muddy colour"];
+        readonly dark: "low-key";
+    };
+    readonly macro: {
+        readonly label: "Macro";
+        readonly medium: "a close-up macro photograph, 100mm macro lens, a very shallow plane of focus";
+        readonly light: "soft side light raking across the surface";
+        readonly grade: "natural colour with rich mid-tones";
+        readonly texture: "tactile surface detail — grain, fibre, glaze, crumb";
+        readonly negative: readonly ["a wide view", "clutter in focus"];
+        readonly dark: "low-key";
+    };
+    readonly architectural: {
+        readonly label: "Architectural";
+        readonly medium: "an architectural photograph, 24mm tilt-shift lens, straight verticals and a calm composition";
+        readonly light: "calm, diffuse daylight";
+        readonly grade: "neutral, precise colour with balanced contrast";
+        readonly texture: "clean lines and crisp materials — stone, wood, glass, plaster";
+        readonly negative: readonly ["converging verticals", "wide-angle distortion"];
+        readonly dark: "nocturne";
+    };
+    readonly nocturne: {
+        readonly label: "Nocturne";
+        readonly medium: "a night photograph, 35mm lens";
+        readonly light: "practical lights only — lamps, candles, a warm window — against the dark";
+        readonly grade: "deep blue-black shadows with warm pools of light";
+        readonly texture: "soft bokeh and a light haze";
+        readonly negative: readonly ["daylight", "flash"];
+        readonly dark: "nocturne";
+    };
+    readonly drawing: {
+        readonly label: "Drawing";
+        readonly medium: "a hand-made illustration, ink and watercolour wash on paper";
+        readonly light: "flat and even, never photographic";
+        readonly grade: "a limited palette of two or three colours";
+        readonly texture: "visible paper grain and brush strokes";
+        readonly negative: readonly ["photographic realism", "a 3D rendering"];
+        readonly dark: "drawing";
+    };
+};
+declare const SPEC_SITE_PICTURE_NEVER: readonly ["text, letters or numbers", "logos, brand names or signage", "a watermark", "a recognisable face", "borders or frames", "distorted hands or objects"];
 
 /** What an untouched node of one registered type saves as (`NODE_BASELINES`, generated from the live
  *  iox-builder configs) — the builder serializer's flat `props` / `styleProps`, the trait names it has a
@@ -4779,6 +4863,68 @@ declare const BASELINE_ROLES: Readonly<Record<string, Readonly<Record<string, Ba
  *  trait saves when nobody sets it — what a composed node of that type starts from. */
 declare function releasedLayoutDefaults(type: string): Record<string, unknown>;
 
+/**
+ * A site's ART DIRECTION (premium-components M7, premium sites PS4): what every picture made for the site shares, so its
+ * pictures read as one photographer's and never as a stock pool. A closed WORLD (the contract's `site.pictureWorlds`)
+ * gives the five parts — medium, light, grade, texture and a negative list — and ONE preamble built from them is carried
+ * VERBATIM at the head of every picture prompt of the site (`artDirectionPreamble`).
+ *
+ * Decided here, not by a model: the world is the business type's (harness-core `BusinessType.world`), a dark look moves it
+ * to the world's `dark`, and the brand's hue joins the grade. Zero tokens, the same site always gets the same direction,
+ * and the quality lever — each world's wording — is written once in the contract, as the proof sites' briefs were.
+ */
+declare enum PictureWorld {
+    Documentary = "documentary",
+    HighKey = "high-key",
+    LowKey = "low-key",
+    HardLight = "hard-light",
+    Macro = "macro",
+    Architectural = "architectural",
+    Nocturne = "nocturne",
+    Drawing = "drawing"
+}
+declare const PICTURE_WORLD_IDS: ReadonlyArray<PictureWorld>;
+/** One world as the contract writes it. */
+interface PictureWorldSpec {
+    readonly label: string;
+    readonly medium: string;
+    readonly light: string;
+    readonly grade: string;
+    readonly texture: string;
+    readonly negative: ReadonlyArray<string>;
+    /** Where a dark look's pictures go. */
+    readonly dark: string;
+}
+declare const PICTURE_WORLDS: Readonly<Record<PictureWorld, PictureWorldSpec>>;
+/** What no picture of any site shows — every world adds its own after these. */
+declare const PICTURE_NEVER: ReadonlyArray<string>;
+/** The art direction a plan carries (`plan.artDirection`): the world and its five parts as this site wears them. */
+interface ArtDirection {
+    readonly world: `${PictureWorld}`;
+    readonly medium: string;
+    readonly light: string;
+    readonly grade: string;
+    readonly texture: string;
+    readonly negative: ReadonlyArray<string>;
+}
+/** The five parts every art direction must carry, in the order the preamble says them. */
+declare const ART_DIRECTION_PARTS: readonly ["medium", "light", "grade", "texture", "negative"];
+declare function isPictureWorld(value: unknown): value is PictureWorld;
+/** The word for a brand colour's hue (`#9A4F2B` → "terracotta orange"), or null for a grey, a near-black or a bad value. */
+declare function brandHueWord(seed: string | null | undefined): string | null;
+/**
+ * The site's art direction: the business type's world (moved to its `dark` world when the look is dark), its five parts,
+ * the brand's hue in the grade, PICTURE_NEVER before the world's own negatives. An unknown world is documentary.
+ */
+declare function artDirectionFor(world: string | null | undefined, design: Pick<DesignChoices, 'mode' | 'seed'>): ArtDirection;
+/** The ONE preamble a site's every picture prompt opens with — the same words, in the same order, every time. */
+declare function artDirectionPreamble(direction: ArtDirection): string;
+/** What is wrong with a value as an art direction — a path and a message each (`validateSitePlan` reports them). */
+declare function artDirectionIssues(value: unknown): Array<{
+    path: string;
+    message: string;
+}>;
+
 /**
  * The Site Plan (contract `site.planShape`, `SPEC_SITE_PLAN_SHAPE`: every key typed and explained, and the
  * validator reads its key lists from it) — the ONE document the website wizard writes
@@ -4996,6 +5142,9 @@ interface SitePlan {
     readonly globals: Readonly<Record<`${GlobalSlot}`, string>>;
     /** SC6b: the owner's film as pictures, set by the build and placed by `placeFilm` — never a model's. */
     readonly film?: PlanFilm;
+    /** M7: what every picture made for the site shares (a world and its five parts) — set by the generation from the
+     *  business type and the look (`artDirectionFor`), never a model's. */
+    readonly artDirection?: ArtDirection;
 }
 /** SC6b: the owner's film — the numbered pictures the wizard's browser made of their video (media-core). */
 interface PlanFilm {
@@ -5633,7 +5782,9 @@ declare enum SitePlanIssueCode {
     SceneBudget = "scene-budget",
     /** SC6b: the owner's film — pictures that cannot play, too few to play smoothly, or a film's pattern on a plan with
      *  no film (or twice). Set by the build, never by a model. */
-    Film = "film"
+    Film = "film",
+    /** M7: the art direction is not a picture world with its five parts. Set by the generation, never by a model. */
+    ArtDirection = "art-direction"
 }
 type SitePlanIssue = PathIssue<SitePlanIssueCode>;
 interface SitePlanValidation {
@@ -6173,7 +6324,10 @@ declare enum BuildNoticeCode {
     StockUnavailable = "stock-unavailable",
     /** The stock library was read but holds no photo for this kind of business (never built, or reviewed down to
      *  none): the picture slots keep the empty box, and the run says so (I2.1 — never silently). */
-    StockMissing = "stock-missing"
+    StockMissing = "stock-missing",
+    /** M7: a picture made for the site was refused by its review twice (or its second try did not fit the cost shown):
+     *  stock or the empty box stands in, and the run says so. */
+    PictureFallback = "picture-fallback"
 }
 interface BuildNotice {
     code: string;
@@ -6425,6 +6579,8 @@ declare enum AiStep {
     PlanSite = "plan",
     ChangePlan = "planEdit",
     MakePictures = "image",
+    /** M7: a small vision model looks at each made picture against its slot (one structured answer). */
+    CheckPictures = "imageReview",
     NameStructures = "scanNaming"
 }
 declare const AI_STEPS: ReadonlyArray<AiStep>;
@@ -6940,6 +7096,10 @@ declare enum SiteFindingCode {
     CopyPlaceholder = "copy-placeholder",
     SampleItems = "sample-items",
     StockPhoto = "stock-photo",
+    /** M7: a picture made with AI for the site still stands where one of the studio's own could. */
+    MadePicture = "made-picture",
+    /** M7: a picture the build could not make (its review said no twice) and nothing stood in for: an empty box. */
+    PictureMissing = "picture-missing",
     NoPrivacyPage = "no-privacy-page",
     PrivacyPagePlaceholder = "privacy-page-placeholder",
     LowContrast = "low-contrast",
@@ -7011,6 +7171,18 @@ interface SiteAuditSnapshot {
         pageId?: string;
         owner?: string;
     }>;
+    /** M7: pictures made with AI that are still on the page. */
+    made?: ReadonlyArray<{
+        nodeId: string;
+        pageId?: string;
+        owner?: string;
+    }>;
+    /** M7: picture slots the build could not make a picture for, still empty. */
+    missing?: 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). */
@@ -7273,13 +7445,24 @@ type StockPlacement<T extends StockTarget = StockTarget> = T & {
 interface StockPlanOptions {
     /** The business type's imagery line (harness-core `BusinessType.imagery`) — its words count for every slot. */
     imagery?: string;
-}
+    /**
+     * M7 (premium sites PS4): the SITE the photos are chosen for (its organization). Among the photos that answer a slot
+     * nearly as well as the best (`STOCK_SEED_MARGIN`), the seed decides — so two sites of the same kind of business stop
+     * opening on the same hero, and the same site always gets the same photos. No seed: the library's order decides.
+     */
+    seed?: string;
+    /** M7: library keys other sites of this studio already show — chosen only when no photo they do not show fits. */
+    avoid?: ReadonlyArray<string>;
+}
+/** How far below the best score a photo may be and still be the seed's choice (one word of the plan's, about). */
+declare const STOCK_SEED_MARGIN = 2;
 /**
  * Which photo goes where (I2.1). Slots choose in intent order (the hero first, list items last; page order within),
  * each taking the best-scoring photo that FITS its shape (`stockFits`) and is not already on its page (or among its
  * type's samples) — a photo no slot has taken yet always before one another page shows. Ties go to the library's
- * order. A slot nothing fits keeps its empty box (a sample its abstract picture). None at all when the type says no
- * stock, and never a photo the review rejected or flagged. Returned in the slots' order.
+ * order — or, with a `seed` (M7), the site's own pick among those nearly as good, and another site's photos (`avoid`) only
+ * when nothing fresh fits. A slot nothing fits keeps its empty box (a sample its abstract picture). None at all when the
+ * type says no stock, and never a photo the review rejected or flagged. Returned in the slots' order.
  */
 declare function planStockPhotos<T extends StockTarget>(slots: ReadonlyArray<T>, photos: ReadonlyArray<StockPhoto>, stockAllowed: boolean, opts?: StockPlanOptions): Array<StockPlacement<T>>;
 /** A placed photo's copy in the studio's storage: the key the build writes it under. */
@@ -7360,5 +7543,215 @@ declare function filmOfPlan(plan: Pick<SitePlan, 'film'>): {
     heightVh: number;
 } | null;
 
-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, FILM_PATTERN, FINAL_GENERATION_STAGES, FINDING_SEVERITY, FilmUnplaced, 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, SCENE_LEVEL, SCENE_OTHER_PAGES, SHOWCASE_FILM, 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, filmOfPlan, filmPlacement, 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, placeFilm, 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, showcaseScenes, 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, FilmPlacement, FilmTarget, JsonSchema, NavHeaderInput, NavHeaderOptions, NavPage, NavShapeOptions, NavShapeResult, NodeBaseline, OwnPhotoPlacement, PageArchetype, PageArchetypeId, PageArchetypeSlot, PageData, PageDataLine, PagePlan, PageSectionPlan, PageSeoPlan, PathIssue, PatternManifestEntry, PatternManifestOptions, PatternNode, PatternPath, PatternRoleNeed, PatternTrack, PlacedFilm, PlainObject, PlanChange, PlanEdit, PlanEditIssue, PlanEditResult, PlanEditsAnswer, PlanEntrancesInput, PlanFilm, 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 };
+/**
+ * Pictures MADE for a site (premium-components M7, AI plan I3, premium sites PS4) — pure and deterministic: which picture
+ * slots of a composed site get a made picture, the prompt each is asked with (the site's ONE art direction first,
+ * verbatim, then what the slot is about, its frame and — where words sit over it — the part of the frame left calm for
+ * them), what the whole set costs before anything is asked, how a vision model's look at each picture is judged, and how
+ * dark the scrim under the words must be for the picture actually made. iox-cms makes, reviews and stores the pictures;
+ * the wizard shows the count and the cost from the same functions.
+ *
+ * The order of who fills a slot never changes: the OWNER's photos first (`planOwnPhotos`), then — only when the owner
+ * opted in — a made picture where one may stand, then stock where the business type allows it, else the empty box.
+ */
+/** Why a slot never gets a made picture — said to the owner, never silently skipped. */
+declare enum PictureRefusal {
+    /** The business sells its own work (a photographer, a maker): a made picture would pass as it. */
+    OwnWork = "own-work",
+    /** A product, a dish, a piece the business offers: a made one would show a thing it does not sell. */
+    Product = "product",
+    /** Where to find the business: a made picture would fake a real place. */
+    RealPlace = "real-place",
+    /** More slots than one site makes pictures for (`MAX_SITE_PICTURES`): the rest keep stock or the empty box. */
+    Limit = "limit"
+}
+/** The section families whose picture is a real place (the contact / visit section). */
+declare const PICTURE_REAL_PLACE_FAMILIES: ReadonlySet<string>;
+/** The most pictures one site is made — a ceiling on what one build may spend on pictures. */
+declare const MAX_SITE_PICTURES = 12;
+/** Which edge of the frame the words sit at. */
+declare enum WordsEdge {
+    Top = "top",
+    Bottom = "bottom"
+}
+/** The part of the frame words sit over — left calm in the picture, measured once it is made. */
+interface WordsArea {
+    edge: `${WordsEdge}`;
+    /** The share of the frame's height (0–1). */
+    share: number;
+}
+/** A scrim with no height of its own (it wraps its words) covers about this much of the frame. */
+declare const WORDS_AREA_DEFAULT_SHARE = 0.45;
+/** The frames an image model is asked for (`image_config.aspect_ratio`), as width / height. */
+declare const PICTURE_ASPECTS: Readonly<Record<string, number>>;
+/** A slot that fills its box (a Scene's picture, a full-bleed band) is made wide: a phone crops its middle. */
+declare const FILL_ASPECT = "16:9";
+/** One picture a site may be made: the slot it fills and everything its prompt and review read. */
+interface PictureSlot {
+    /** Stable across runs: `page:<owner>:<nodeId>` (a section's picture) or `item:<type>:<index>:<field>`. */
+    key: string;
+    target: StockTarget;
+    intent: `${StockIntent}`;
+    /** The frame asked of the model (`PICTURE_ASPECTS`). */
+    ratio: string;
+    /** The section family it is in (`hero`, `story`…) — empty for an item. */
+    family: string;
+    /** What the section says, in the plan's own words (its slots) — what the picture is about. */
+    text: string;
+    /** Where the words sit over it, when they do. */
+    wordsArea?: WordsArea;
+    /** The node holding those words (a `media-scrim` box) — its scrim is chosen for the picture made. */
+    scrimNodeId?: string;
+}
+/** What a site's pictures will be. */
+interface PicturePlan {
+    /** The owner's photos and where each goes — always first. */
+    own: OwnPhotoPlacement[];
+    /** The slots a picture is made for, the hero first. */
+    make: PictureSlot[];
+    /** The slots no picture is made for, and why (stock or the empty box fills them). */
+    refused: Array<{
+        key: string;
+        reason: PictureRefusal;
+    }>;
+}
+interface PicturePlanOptions {
+    /** The owner's own photos (urls), in order. */
+    ownPhotos?: ReadonlyArray<string>;
+    /** The business type's rule (harness-core `BusinessType.stock`): where stock may not stand in for the work, no made
+     *  picture may either. */
+    stockAllowed: boolean;
+    max?: number;
+}
+/** The ONE list of picture slots a build fills — its composed sections' empty pictures, then its sample items'. */
+declare function pictureTargets(plan: SitePlan, composed: Pick<ComposedSite, 'pages' | 'placeholders' | 'items'>): StockTarget[];
+/** A slot's stable key. */
+declare function pictureSlotKey(target: StockTarget): string;
+/** The nearest frame a model is asked for (by the ratio of ratios); a slot with no shape fills its box. */
+declare function pictureAspect(aspect: number | undefined): string;
+/**
+ * The words over a picture: a picture laid ABSOLUTE in its box whose sibling wears `media-scrim` (a Scene's stage, a
+ * full-bleed band) carries the words that box holds. The area is the scrim's: its height when it says one, else
+ * `WORDS_AREA_DEFAULT_SHARE`, at the edge it is pinned to.
+ */
+declare function wordsOverPicture(node: SerializedNode, parent: SerializedNode | undefined): {
+    area: WordsArea;
+    scrimNodeId: string;
+} | null;
+/** Why `target` never gets a made picture, or null. */
+declare function pictureRefusalOf(target: StockTarget, stockAllowed: boolean): PictureRefusal | null;
+/**
+ * Which slots get a made picture: the owner's photos take theirs first (the same `planOwnPhotos` the build places them
+ * with), then each slot left — the hero first, page order within — gets one unless it is refused (the work, a product,
+ * a real place) or the site already has `max`. Pure: the wizard's count, the generation's run and the build agree.
+ */
+declare function planPictures(plan: SitePlan, composed: Pick<ComposedSite, 'pages' | 'placeholders' | 'items'>, opts: PicturePlanOptions): PicturePlan;
+/** The empty part a slot's words sit over, said to the model: where, how much, and what it must look like. */
+declare function emptyAreaPhrase(area: WordsArea): string;
+/** The frame, said plainly. */
+declare function frameWords(ratio: string): string;
+interface PicturePromptContext {
+    /** The kind of business, in words a prompt can carry ("a café or bakery") — never its name (it would be drawn). */
+    business: string;
+}
+/**
+ * The prompt a picture is asked with: the site's preamble VERBATIM, what the slot is about (its intent, then the
+ * section's own words), its frame, the empty part the words need — and nothing else. The same slot of the same plan
+ * is always asked the same words.
+ */
+declare function picturePrompt(slot: PictureSlot, direction: ArtDirection, context: PicturePromptContext): string;
+/** One picture in this many may be made a second time (a review said no) — paid for in the estimate shown. */
+declare const PICTURE_REROLL_EVERY = 6;
+/** How many second tries a set of `count` pictures has, shown and paid for up front. */
+declare function pictureRerolls(count: number): number;
+interface PicturesEstimate {
+    count: number;
+    /** Second tries included in the total. */
+    rerolls: number;
+    /** One picture, in credits. */
+    picture: number;
+    /** One review of a picture, in credits. */
+    review: number;
+    /** What the owner is shown and the most the run may spend: every picture and its review, plus the second tries. */
+    total: number;
+}
+/**
+ * The cost shown before the owner says yes (I-D4): each picture and its review at the vetted list's prices, plus one
+ * second try (a picture and its review) for every `PICTURE_REROLL_EVERY` pictures. The run never spends past `total` —
+ * a second try that would cross it is not made — so the shown cost is a ceiling met exactly when every try is used.
+ */
+declare function estimatePictures(count: number, prices: {
+    image: AiTokenPrice;
+    review: AiTokenPrice;
+}): PicturesEstimate;
+/** The structured answer's name (`output.name`). */
+declare const PICTURE_REVIEW_FORMAT = "picture_review";
+/** What a vision model says of one picture against its slot. */
+interface PictureReview {
+    subject: boolean;
+    calmArea: boolean;
+    clean: boolean;
+    anatomy: boolean;
+    alt: string;
+    note: string;
+}
+/** The review's shape, each key in the words the model reads (every key required: no optional parameter). */
+declare const PICTURE_REVIEW_SHAPE: Readonly<Record<keyof PictureReview, string>>;
+/** The review's strict format: 6 properties, all required, closed — well inside every structured-output limit. */
+declare function pictureReviewJsonSchema(): JsonSchema;
+/** What is wrong with an answer as a review — the gate the call service holds it to. */
+declare function pictureReviewIssues(value: unknown): Array<{
+    code: string;
+    path: string;
+    message: string;
+}>;
+/** A picture is used when it shows the subject, is clean and whole — and, where words sit over it, leaves them room. */
+declare function pictureReviewPasses(review: PictureReview, slot: Pick<PictureSlot, 'wordsArea'>): boolean;
+/** How strong the scrim under a picture's words is, weakest first. `Soft` is the element style's own gradient. */
+declare enum ScrimLevel {
+    Soft = "soft",
+    Firm = "firm",
+    Full = "full"
+}
+declare const SCRIM_LEVELS: ReadonlyArray<ScrimLevel>;
+/** What each level writes on the scrim node (`backgroundColor`, token references only) — `null`: the style's own. */
+declare const SCRIM_BACKGROUND: Readonly<Record<ScrimLevel, string | null>>;
+/** The least share of the scrim's own strength under the first line of words, at each level (the gradient's ramp). */
+declare const SCRIM_COVER: Readonly<Record<ScrimLevel, number>>;
+/** WCAG AA for body text — the words over a picture include a lead and a button label, never only a headline. */
+declare const PICTURE_TEXT_CONTRAST = 4.5;
+/** The light of a picture's words area: its darkest and lightest few percent (relative luminance, 0–1), and its mean. */
+interface AreaLuminance {
+    low: number;
+    high: number;
+    mean: number;
+}
+/**
+ * The light of the part of a picture its words sit over (RGBA bytes, row by row) — read across the whole width (a laptop)
+ * and in the middle third (a phone's crop of a wide picture); the darker low and the lighter high of the two.
+ */
+declare function areaLuminance(rgba: ArrayLike<number>, width: number, height: number, area: WordsArea): AreaLuminance;
+interface ScrimChoice {
+    level: ScrimLevel;
+    /** The worst contrast the words have over the picture at that level. */
+    contrast: number;
+}
+/**
+ * The weakest scrim under which the words reach AA over the picture made: the scrim's own colour (`--iox-media-scrim`,
+ * as the look writes it) at its least strength under the words, over the area's darkest and lightest, against the ink
+ * (`--iox-media-scrim-ink`). `Full` when nothing weaker does — the contract already holds a full scrim over white to AA.
+ */
+declare function chooseScrim(area: AreaLuminance, colours: {
+    scrim: string;
+    ink: string;
+}, minContrast?: number): ScrimChoice;
+/** Set each chosen scrim on its node (`Soft` leaves the element style's own). Returns the nodes changed. */
+declare function applyPictureScrims(trees: ReadonlyArray<SerializedNode>, chosen: ReadonlyArray<{
+    nodeId: string;
+    level: `${ScrimLevel}`;
+}>): number;
+/** The relative luminance of a CSS colour (for a review sheet or a log), or null. */
+declare function luminanceOf(colour: string): number | null;
+
+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, ART_DIRECTION_PARTS, 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, FILL_ASPECT, FILM_PATTERN, FINAL_GENERATION_STAGES, FINDING_SEVERITY, FilmUnplaced, GRAMMAR_TOO_LARGE_MESSAGE, GlobalSlot, HEBREW_PREFIXES, JSON_SCHEMA_BANNED_KEYWORDS, JsonSchemaShapeError, KeptReason, MAX_SITE_PICTURES, NAV_PART_LABELS, NAV_SHAPE_COPY, NEUTRAL_STYLE_PROPS, NODE_BASELINES, NO_TOKENS, NavPagesSource, NavRole, NavShape, NavShapeError, PAGE_ARCHETYPES, PICTURE_ASPECTS, PICTURE_NEVER, PICTURE_REAL_PLACE_FAMILIES, PICTURE_REROLL_EVERY, PICTURE_REVIEW_FORMAT, PICTURE_REVIEW_SHAPE, PICTURE_TEXT_CONTRAST, PICTURE_WORLDS, PICTURE_WORLD_IDS, 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, PictureRefusal, PictureWorld, PlaceholderKind, PlanChangeAction, PlanChangeKind, PlanDataSourceMode, PlanDataSourceType, PlanEditIssueCode, PlanEditOp, PlanEditsOutcome, PlanPart, PlanWireEntry, PlanWireShapeError, PlanWordIssueCode, PreflightRefusalCode, PublishRefusalCode, REQUIRED_CONTENT_ROLES, RelativeOp, SAMPLE_IMAGE_REF, SCENE_LEVEL, SCENE_OTHER_PAGES, SCRIM_BACKGROUND, SCRIM_COVER, SCRIM_LEVELS, SHOWCASE_FILM, 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_PICTURE_NEVER, SPEC_SITE_PICTURE_WORLDS, 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_SEED_MARGIN, STOCK_SUBJECT_WORDS, STRICT_SCHEMA_BUDGET, STRICT_SCHEMA_LIMITS, STUDIO_TEMPLATE, ScrimLevel, SiteBuildKind, SiteBuildStatus, SiteCheckId, SiteFindingCode, SiteLocale, SitePlanError, SitePlanIssueCode, SitePlanSourceKind, SiteTemplateError, SiteTemplateId, StepState, StockIntent, StockOrientation, StockProviderId, StockReviewFlag, StockReviewVerdict, StockSlotKind, StockSubject, WORDS_AREA_DEFAULT_SHARE, WordsEdge, addBarItem, addStockCredits, aiStepParts, applyOwnPhotoGalleries, applyPictureScrims, applyPlanEdits, applyStockItemPhotos, applyStockPhotos, archetypeIssues, areaLuminance, artDirectionFor, artDirectionIssues, artDirectionPreamble, aspectRatioOf, assertStyleSlots, assertValidSitePlan, auditSite, barIconForRoute, blocksPublish, brandHueWord, buildKeys, buildStepFacts, builtHomePageId, chooseScrim, composeNavHeader, composeSection, composeSite, contentTypePreviewFields, contentTypeToWire, copyLengthOf, costUsd, createSerializedNode, creditsOfUsd, dataSourceToWire, derivedDataSources, describePlanData, describeShapeKey, emptyAreaPhrase, entranceAction, entranceInteraction, estimatePictures, estimateStepCredits, expandPlanWire, expandWireContentType, expandWireDataSource, expandWireEdit, expandWireField, expandWirePage, expandWireSection, failedBuildStep, fieldToWire, filmOfPlan, filmPlacement, findNavRoot, frameWords, isActiveBuild, isNonEmptyString, isPictureWorld, isPlainObject, isRtlLocale, jsonAnyOf, jsonBoolean, jsonClosedObject, jsonInteger, jsonListOf, jsonOneOf, jsonSchemaKeywords, jsonSchemaObjects, jsonShapedObject, jsonText, luminanceOf, 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, pictureAspect, picturePrompt, pictureRefusalOf, pictureRerolls, pictureReviewIssues, pictureReviewJsonSchema, pictureReviewPasses, pictureSlotKey, pictureTargets, placeFilm, planEditOps, planEditToWire, planEditWireGaps, planEditWireKeys, planEditWireOps, planEditWireShape, planEditsFromWire, planEditsJsonSchema, planEditsToWire, planEntrances, planFromTemplate, planNavShape, planOwnPhotos, planPartOfPath, planPartToWire, planPictures, 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, showcaseScenes, 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, wordsOverPicture, writtenTexts };
+export type { AddBarItemResult, AiEntitlementsView, AiMeter, AiModelEntry, AiRefusal, AiTokenCounts, AiTokenPrice, AreaLuminance, ArtDirection, 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, FilmPlacement, FilmTarget, JsonSchema, NavHeaderInput, NavHeaderOptions, NavPage, NavShapeOptions, NavShapeResult, NodeBaseline, OwnPhotoPlacement, PageArchetype, PageArchetypeId, PageArchetypeSlot, PageData, PageDataLine, PagePlan, PageSectionPlan, PageSeoPlan, PathIssue, PatternManifestEntry, PatternManifestOptions, PatternNode, PatternPath, PatternRoleNeed, PatternTrack, PicturePlan, PicturePlanOptions, PicturePromptContext, PictureReview, PictureSlot, PictureWorldSpec, PicturesEstimate, PlacedFilm, PlainObject, PlanChange, PlanEdit, PlanEditIssue, PlanEditResult, PlanEditsAnswer, PlanEntrancesInput, PlanFilm, PlanWireContext, PlanWireParts, PlanWordContext, PlanWordIssue, PreflightRefusal, PublishRefusal, RecipeListBinds, RelativeDataSourcePlan, ScrimChoice, 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, WordsArea, WrittenText };