@vectoriox/iox-ui 5.83.1 → 5.84.0

package/harness-core/index.d.ts

@@ -1,5 +1,5 @@
 import { MotionId, MoodId, TintId, DensityId, DesignMotion, DesignChoices, DesignMode, StylePreset, ShapeId, AnimateId } from '@vectoriox/iox-ui/design-core';
-import { FactKey, PathIssue, PlainObject, JsonSchema, SiteTemplate, ShapeEntry, AiGenerationStage, AiStep, SitePlan, PlanEdit, PlanChange, SiteAudit } from '@vectoriox/iox-ui/generation-core';
+import { FactKey, PictureWorld, PathIssue, PlainObject, JsonSchema, SiteTemplate, ShapeEntry, AiGenerationStage, AiStep, SitePlan, PlanEdit, PlanChange, PictureRefusal, AiRefusalCode, SiteAudit } from '@vectoriox/iox-ui/generation-core';
 export { JsonSchema } from '@vectoriox/iox-ui/generation-core';
 import { FrameSequence } from '@vectoriox/iox-ui/media-core';
 
@@ -157,6 +157,7 @@ declare const SPEC_BUSINESS_TYPES: readonly [{
         readonly between: "cinematic";
     };
     readonly ceiling: "expressive";
+    readonly world: "documentary";
     readonly imagery: "Your own photos only, large and uncropped; never stock.";
     readonly pages: readonly ["home", "work (collection)", "project (detail)", "about", "contact"];
     readonly needs: readonly ["collection", "detail", "about", "contact"];
@@ -220,6 +221,7 @@ declare const SPEC_BUSINESS_TYPES: readonly [{
         readonly between: "cinematic";
     };
     readonly ceiling: "expressive";
+    readonly world: "architectural";
     readonly imagery: "Wide, bright room shots; details of materials.";
     readonly pages: readonly ["home", "projects (collection)", "project (detail)", "services", "about", "contact"];
     readonly needs: readonly ["collection", "detail", "services", "about", "contact"];
@@ -284,6 +286,7 @@ declare const SPEC_BUSINESS_TYPES: readonly [{
         readonly between: "fade";
     };
     readonly ceiling: "expressive";
+    readonly world: "architectural";
     readonly imagery: "Large project photos and drawings.";
     readonly pages: readonly ["home", "projects (collection)", "project (detail)", "about", "contact"];
     readonly needs: readonly ["collection", "detail", "about", "contact"];
@@ -349,6 +352,7 @@ declare const SPEC_BUSINESS_TYPES: readonly [{
         readonly between: "slide";
     };
     readonly ceiling: "expressive";
+    readonly world: "hard-light";
     readonly imagery: "Case-study images of your own work.";
     readonly pages: readonly ["home", "work (collection)", "case study (detail)", "services", "about", "contact"];
     readonly needs: readonly ["collection", "detail", "services", "about", "contact"];
@@ -404,6 +408,7 @@ declare const SPEC_BUSINESS_TYPES: readonly [{
         readonly between: "fade";
     };
     readonly ceiling: "expressive";
+    readonly world: "drawing";
     readonly imagery: "Your pieces, photographed flat and true to colour.";
     readonly pages: readonly ["home", "works (collection)", "work (detail)", "about", "contact"];
     readonly needs: readonly ["collection", "about", "contact"];
@@ -461,6 +466,7 @@ declare const SPEC_BUSINESS_TYPES: readonly [{
         readonly between: "slide";
     };
     readonly ceiling: "expressive";
+    readonly world: "macro";
     readonly imagery: "Your pieces and hands at work; natural light.";
     readonly pages: readonly ["home", "pieces (collection)", "piece (detail)", "workshops", "about", "contact"];
     readonly needs: readonly ["collection", "detail", "about", "contact"];
@@ -517,6 +523,7 @@ declare const SPEC_BUSINESS_TYPES: readonly [{
         readonly between: "cinematic";
     };
     readonly ceiling: "expressive";
+    readonly world: "macro";
     readonly imagery: "Close-ups on a plain ground.";
     readonly pages: readonly ["home", "collection", "piece (detail)", "about", "contact"];
     readonly needs: readonly ["collection", "detail", "about", "contact"];
@@ -574,6 +581,7 @@ declare const SPEC_BUSINESS_TYPES: readonly [{
         readonly between: "slide";
     };
     readonly ceiling: "expressive";
+    readonly world: "low-key";
     readonly imagery: "Healed work, clean photos.";
     readonly pages: readonly ["home", "work (collection)", "artists", "faq", "contact"];
     readonly needs: readonly ["collection", "faq", "contact"];
@@ -630,6 +638,7 @@ declare const SPEC_BUSINESS_TYPES: readonly [{
         readonly between: "fade";
     };
     readonly ceiling: "standard";
+    readonly world: "high-key";
     readonly imagery: "Rooms, textures, hands; no faces needed.";
     readonly pages: readonly ["home", "treatments (services)", "prices", "about", "contact"];
     readonly needs: readonly ["services", "prices", "about", "contact"];
@@ -696,6 +705,7 @@ declare const SPEC_BUSINESS_TYPES: readonly [{
         readonly between: "fade";
     };
     readonly ceiling: "lively";
+    readonly world: "high-key";
     readonly imagery: "Your own before-and-after photos.";
     readonly pages: readonly ["home", "services", "prices", "gallery", "contact"];
     readonly needs: readonly ["services", "prices", "gallery", "contact"];
@@ -756,6 +766,7 @@ declare const SPEC_BUSINESS_TYPES: readonly [{
         readonly between: "fade";
     };
     readonly ceiling: "lively";
+    readonly world: "high-key";
     readonly imagery: "The room, real classes, daylight.";
     readonly pages: readonly ["home", "classes", "schedule", "teachers", "prices", "contact"];
     readonly needs: readonly ["prices", "contact"];
@@ -817,6 +828,7 @@ declare const SPEC_BUSINESS_TYPES: readonly [{
         readonly between: "slide";
     };
     readonly ceiling: "lively";
+    readonly world: "hard-light";
     readonly imagery: "Real people training; movement.";
     readonly pages: readonly ["home", "classes", "prices", "coaches", "contact"];
     readonly needs: readonly ["prices", "contact"];
@@ -874,6 +886,7 @@ declare const SPEC_BUSINESS_TYPES: readonly [{
         readonly between: "none";
     };
     readonly ceiling: "subtle";
+    readonly world: "documentary";
     readonly imagery: "A calm room, daylight; your portrait.";
     readonly pages: readonly ["home", "how I work", "about", "faq", "contact"];
     readonly needs: readonly ["collection", "about", "faq", "contact"];
@@ -935,6 +948,7 @@ declare const SPEC_BUSINESS_TYPES: readonly [{
         readonly between: "fade";
     };
     readonly ceiling: "subtle";
+    readonly world: "high-key";
     readonly imagery: "Your team and rooms; no stock doctors.";
     readonly pages: readonly ["home", "treatments (services)", "team", "faq", "contact"];
     readonly needs: readonly ["services", "team", "faq", "contact"];
@@ -997,6 +1011,7 @@ declare const SPEC_BUSINESS_TYPES: readonly [{
         readonly between: "fade";
     };
     readonly ceiling: "subtle";
+    readonly world: "high-key";
     readonly imagery: "Your clinic and team.";
     readonly pages: readonly ["home", "treatments", "team", "faq", "contact"];
     readonly needs: readonly ["services", "team", "faq", "contact"];
@@ -1057,6 +1072,7 @@ declare const SPEC_BUSINESS_TYPES: readonly [{
         readonly between: "fade";
     };
     readonly ceiling: "standard";
+    readonly world: "documentary";
     readonly imagery: "Real animals you treat (with permission).";
     readonly pages: readonly ["home", "services", "team", "faq", "contact"];
     readonly needs: readonly ["services", "team", "faq", "contact"];
@@ -1113,6 +1129,7 @@ declare const SPEC_BUSINESS_TYPES: readonly [{
         readonly between: "fade";
     };
     readonly ceiling: "expressive";
+    readonly world: "low-key";
     readonly imagery: "Your own food and room photos.";
     readonly pages: readonly ["home", "menu", "about", "contact"];
     readonly needs: readonly ["menu", "about", "contact"];
@@ -1176,6 +1193,7 @@ declare const SPEC_BUSINESS_TYPES: readonly [{
         readonly between: "slide";
     };
     readonly ceiling: "lively";
+    readonly world: "documentary";
     readonly imagery: "Your bakes and drinks, close up.";
     readonly pages: readonly ["home", "menu", "about", "contact"];
     readonly needs: readonly ["menu", "about", "contact"];
@@ -1236,6 +1254,7 @@ declare const SPEC_BUSINESS_TYPES: readonly [{
         readonly between: "cinematic";
     };
     readonly ceiling: "expressive";
+    readonly world: "nocturne";
     readonly imagery: "The cellar, the bar, the bottle.";
     readonly pages: readonly ["home", "menu or wines", "our story", "visit", "contact"];
     readonly needs: readonly ["menu", "visit", "contact"];
@@ -1296,6 +1315,7 @@ declare const SPEC_BUSINESS_TYPES: readonly [{
         readonly between: "slide";
     };
     readonly ceiling: "expressive";
+    readonly world: "high-key";
     readonly imagery: "Product photos on plain grounds; real people wearing them.";
     readonly pages: readonly ["home", "collection", "product (detail)", "about", "contact"];
     readonly needs: readonly ["collection", "detail", "about", "contact"];
@@ -1351,6 +1371,7 @@ declare const SPEC_BUSINESS_TYPES: readonly [{
         readonly between: "fade";
     };
     readonly ceiling: "lively";
+    readonly world: "macro";
     readonly imagery: "Your own arrangements in daylight.";
     readonly pages: readonly ["home", "flowers (collection)", "weddings and events", "about", "contact"];
     readonly needs: readonly ["collection", "about", "contact"];
@@ -1407,6 +1428,7 @@ declare const SPEC_BUSINESS_TYPES: readonly [{
         readonly between: "fade";
     };
     readonly ceiling: "expressive";
+    readonly world: "documentary";
     readonly imagery: "Pieces in real rooms and on plain grounds.";
     readonly pages: readonly ["home", "collection", "product (detail)", "about", "contact"];
     readonly needs: readonly ["collection", "detail", "about", "contact"];
@@ -1463,6 +1485,7 @@ declare const SPEC_BUSINESS_TYPES: readonly [{
         readonly between: "fade";
     };
     readonly ceiling: "standard";
+    readonly world: "architectural";
     readonly imagery: "Your portrait; diagrams over stock.";
     readonly pages: readonly ["home", "services", "case studies", "about", "contact"];
     readonly needs: readonly ["services", "about", "contact"];
@@ -1521,6 +1544,7 @@ declare const SPEC_BUSINESS_TYPES: readonly [{
         readonly between: "fade";
     };
     readonly ceiling: "standard";
+    readonly world: "documentary";
     readonly imagery: "Your portrait, working with people.";
     readonly pages: readonly ["home", "how it works", "programmes", "about", "contact"];
     readonly needs: readonly ["collection", "about", "contact"];
@@ -1573,6 +1597,7 @@ declare const SPEC_BUSINESS_TYPES: readonly [{
         readonly between: "none";
     };
     readonly ceiling: "subtle";
+    readonly world: "architectural";
     readonly imagery: "Your team; your office.";
     readonly pages: readonly ["home", "practice areas (services)", "team", "about", "contact"];
     readonly needs: readonly ["services", "team", "about", "contact"];
@@ -1636,6 +1661,7 @@ declare const SPEC_BUSINESS_TYPES: readonly [{
         readonly between: "slide";
     };
     readonly ceiling: "lively";
+    readonly world: "architectural";
     readonly imagery: "Your own property photos; never stock.";
     readonly pages: readonly ["home", "properties (collection)", "property (detail)", "about", "contact"];
     readonly needs: readonly ["collection", "detail", "about", "contact"];
@@ -1695,6 +1721,7 @@ declare const SPEC_BUSINESS_TYPES: readonly [{
         readonly between: "fade";
     };
     readonly ceiling: "standard";
+    readonly world: "documentary";
     readonly imagery: "Real people you help (with permission).";
     readonly pages: readonly ["home", "what we do", "stories", "get involved", "contact"];
     readonly needs: readonly ["contact"];
@@ -1747,6 +1774,7 @@ declare const SPEC_BUSINESS_TYPES: readonly [{
         readonly between: "cinematic";
     };
     readonly ceiling: "expressive";
+    readonly world: "nocturne";
     readonly imagery: "Real events at your venue.";
     readonly pages: readonly ["home", "spaces", "gallery", "faq", "contact"];
     readonly needs: readonly ["gallery", "faq", "contact"];
@@ -1806,6 +1834,7 @@ declare const SPEC_BUSINESS_TYPES: readonly [{
         readonly between: "cinematic";
     };
     readonly ceiling: "expressive";
+    readonly world: "documentary";
     readonly imagery: "Rooms, views, breakfast; your own photos.";
     readonly pages: readonly ["home", "rooms (collection)", "room (detail)", "about", "contact"];
     readonly needs: readonly ["collection", "detail", "about", "contact"];
@@ -1865,6 +1894,7 @@ declare const SPEC_BUSINESS_TYPES: readonly [{
         readonly between: "slide";
     };
     readonly ceiling: "lively";
+    readonly world: "documentary";
     readonly imagery: "Real classes (with permission).";
     readonly pages: readonly ["home", "classes", "prices", "about", "contact"];
     readonly needs: readonly ["prices", "about", "contact"];
@@ -2273,6 +2303,8 @@ interface BusinessType {
      *  so a type capped below it never gets one. Binds generated output only — the owner may choose any level. */
     readonly ceiling: DesignMotion['animate'];
     readonly imagery: string;
+    /** M7: the picture world a site's made pictures start in (generation-core `artDirectionFor`; contract site.pictureWorlds). */
+    readonly world: `${PictureWorld}`;
     readonly pages: ReadonlyArray<string>;
     /** The needs its page set implies, in page order (derived from `pages` at contract build). */
     readonly needs: ReadonlyArray<NeedId>;
@@ -2943,6 +2975,42 @@ interface PlanRevisionView {
     edits?: PlanEdit[];
     changed?: PlanChange[];
 }
+/** Why no picture can be made for this site right now (the Plan step says it instead of offering the switch). */
+declare enum PicturesUnavailable {
+    /** No slot is left after the owner's photos and the refusals. */
+    Nothing = "nothing",
+    /** The key in use has no model that makes pictures (a Claude key does not). */
+    NoModel = "no-model"
+}
+/**
+ * M7: the pictures a generation may have MADE, as the Plan step shows them before the owner says yes, and while they are
+ * made. `estimate` is the cost shown — every picture and its review plus the second tries (generation-core
+ * `estimatePictures`) — and the most the run may spend on them.
+ */
+interface GenerationPicturesView {
+    /** Pictures that would be made (after the owner's photos and the refusals). */
+    count: number;
+    /** The owner's photos that go first. */
+    own: number;
+    /** Slots no picture is made for, by why. */
+    refused: Partial<Record<`${PictureRefusal}`, number>>;
+    /** Credits — the cost shown and the run's ceiling. */
+    estimate: number;
+    /** One picture with its review, in credits. */
+    each: number;
+    rerolls: number;
+    /** The model that makes them, or null. */
+    model: string | null;
+    /** Why none can be made now — instead of the switch. A refusal code when credits or the plan say no. */
+    unavailable?: `${PicturesUnavailable}` | `${AiRefusalCode}`;
+    /** The owner said yes (Build with pictures): the run's progress. */
+    wanted?: boolean;
+    made?: number;
+    /** Slots whose review said no to every try — stock or the empty box stands in. */
+    failed?: number;
+    /** Credits the pictures have cost so far (the ledger). */
+    spent?: number;
+}
 interface AiGenerationView {
     _id: string;
     organization: string;
@@ -3001,6 +3069,16 @@ interface AiGenerationView {
             path: string;
         }>;
     };
+    /** M7: the pictures that may be made (on the Plan step) or are being made. Absent: no plan yet. */
+    pictures?: GenerationPicturesView;
+}
+/** `POST …/ai/generations/:id/build` (and `/auto`). */
+interface GenerationBuildRequest {
+    replaceGlobals?: boolean;
+    /** SC6b: the owner's film as pictures. */
+    film?: FrameSequence;
+    /** M7: make pictures for the site first (the cost shown on the Plan step). */
+    pictures?: boolean;
 }
 /** `POST …/ai/generations`. */
 interface GenerationStartRequest {
@@ -3052,5 +3130,5 @@ type SiteAuditView = SiteAudit & {
     advice: LintFinding[];
 };
 
-export { ANIMATE_ADVICE_STEPS, AnalysisIssueCode, AnalysisLocale, AvoidCheck, BUSINESS_TYPES, BUSINESS_TYPE_IDS, BookingNeed, COPY_LENGTH_ORDER, CopyLength, GENERATION_LIMITS, HARNESS_SOURCE, LITTLE_MOVEMENT_AVOID, LITTLE_MOVEMENT_CAP, LintKind, MAX_ANALYSIS_MOODS, MAX_PIXEL_SAMPLES, MAX_READ_PICTURES, NEEDS, NEED_IDS, NeedSource, PALETTE_SIZE, PALETTE_THRESHOLDS, PictureRole, PlanChangeOutcome, PresetFit, RANK_WEIGHTS, READING_SHAPE, READ_ANIMATE, READ_WEIGHTS, RankReason, ReaderState, ReadingIssueCode, SITE_ANALYSIS_SCHEMA_NAME, SITE_READING_SCHEMA_NAME, SPEC_ANALYSIS_SHAPE, SPEC_BUSINESS_TYPES, SPEC_HARNESS_EXAMPLES, SPEC_HARNESS_SOURCE, SPEC_NEEDS, SPEC_STRUCTURES, SPEC_USER_AVOIDS, STRUCTURES, SiteReadRefusal, StyleReadGround, StyleReadHeadings, StyleReadMotion, StyleReadSourceKind, USER_AVOID_IDS, VoiceFormality, VoicePerson, addressesIn, analysisFromWire, analysisPromptContext, analysisToWire, bestRankedPreset, 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, presetsByFlavor, 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, PresetFlavorGroup, PromptContext, PromptContextOptions, PromptSection, RankInput, RankedPreset, ReadingIssue, ReferenceSeed, SiteAnalysis, SiteAuditView, SiteNeed, SiteReaderView, SiteReading, StartingDesign, StructureChoice, StructureId, StyleHints, StyleRead, UserAvoidId };
+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, PicturesUnavailable, PlanChangeOutcome, PresetFit, RANK_WEIGHTS, READING_SHAPE, READ_ANIMATE, READ_WEIGHTS, RankReason, ReaderState, ReadingIssueCode, SITE_ANALYSIS_SCHEMA_NAME, SITE_READING_SCHEMA_NAME, SPEC_ANALYSIS_SHAPE, SPEC_BUSINESS_TYPES, SPEC_HARNESS_EXAMPLES, SPEC_HARNESS_SOURCE, SPEC_NEEDS, SPEC_STRUCTURES, SPEC_USER_AVOIDS, STRUCTURES, SiteReadRefusal, StyleReadGround, StyleReadHeadings, StyleReadMotion, StyleReadSourceKind, USER_AVOID_IDS, VoiceFormality, VoicePerson, addressesIn, analysisFromWire, analysisPromptContext, analysisToWire, bestRankedPreset, 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, presetsByFlavor, 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, GenerationBuildRequest, GenerationFileView, GenerationPicturesView, GenerationReadersView, GenerationStartRequest, GoodFit, LintFinding, LintSite, LookCondition, LookDesign, LookRule, MeasuredPicture, MotionBasis, MotionInput, MotionStart, NeedDef, NeedId, PaletteColour, PaletteReading, PictureStyle, PlanRevisionView, PresetFlavorGroup, PromptContext, PromptContextOptions, PromptSection, RankInput, RankedPreset, ReadingIssue, ReferenceSeed, SiteAnalysis, SiteAuditView, SiteNeed, SiteReaderView, SiteReading, StartingDesign, StructureChoice, StructureId, StyleHints, StyleRead, UserAvoidId };

package/package.json

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

package/src/generation-core/ai-run.ts

@@ -27,6 +27,8 @@ export 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',
 }
 
@@ -38,6 +40,7 @@ export const AI_STEP_LABELS: Readonly<Record<AiStep, string>> = {
     [AiStep.PlanSite]: 'Plan the site',
     [AiStep.ChangePlan]: 'Change the plan',
     [AiStep.MakePictures]: 'Make pictures',
+    [AiStep.CheckPictures]: 'Check pictures',
     [AiStep.NameStructures]: 'Name repeated structures',
 };
 
@@ -53,6 +56,7 @@ export const AI_STEP_NEEDS: Readonly<Record<AiStep, ReadonlyArray<AiCapability>>
     [AiStep.PlanSite]: [AiCapability.StructuredOutput],
     [AiStep.ChangePlan]: [AiCapability.StructuredOutput],
     [AiStep.MakePictures]: [AiCapability.ImageOutput],
+    [AiStep.CheckPictures]: [AiCapability.StructuredOutput, AiCapability.ImageInput],
     [AiStep.NameStructures]: [AiCapability.StructuredOutput],
 };
 
@@ -91,8 +95,12 @@ export const AI_STEP_TYPICAL_TOKENS: Readonly<Record<AiStep, AiTokenCounts>> = {
     [AiStep.ReadMessage]: { input: 8_800, output: 1_500, cacheWrite: 0, cacheRead: 0 },
     [AiStep.PlanSite]: partsTotal(AiStep.PlanSite),
     [AiStep.ChangePlan]: partsTotal(AiStep.ChangePlan),
-    // a 1 K picture is 1,120 image tokens (Google's figure for Nano Banana 2) — I-D4
-    [AiStep.MakePictures]: { input: 0, output: 0, cacheWrite: 0, cacheRead: 0, imageOutput: 1_120 },
+    // a 1 K picture is 1,120 image tokens (Google's figure for Nano Banana 2) — I-D4; the prompt (the art direction's
+    // preamble, the slot's subject, its frame and empty area) about 400 more in (M7)
+    [AiStep.MakePictures]: { input: 400, output: 0, cacheWrite: 0, cacheRead: 0, imageOutput: 1_120 },
+    // M7: one picture downscaled to 512 px (≈ 350 image tokens for Claude, ≈ 260 for Gemini) + the slot's question,
+    // and a short structured answer
+    [AiStep.CheckPictures]: { input: 1_200, output: 150, cacheWrite: 0, cacheRead: 0 },
     [AiStep.NameStructures]: { input: 80_000, output: 10_000, cacheWrite: 0, cacheRead: 0 },
 };
 

package/src/generation-core/art-direction.ts

@@ -0,0 +1,122 @@
+import { DesignChoices, parseHexColor, rgbToOklab } from '@vectoriox/iox-ui/design-core';
+
+import { SPEC_SITE_PICTURE_NEVER, SPEC_SITE_PICTURE_WORLDS } from './site-spec.generated';
+
+/**
+ * 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.
+ */
+
+export enum PictureWorld {
+    Documentary = 'documentary',
+    HighKey = 'high-key',
+    LowKey = 'low-key',
+    HardLight = 'hard-light',
+    Macro = 'macro',
+    Architectural = 'architectural',
+    Nocturne = 'nocturne',
+    Drawing = 'drawing',
+}
+
+export const PICTURE_WORLD_IDS: ReadonlyArray<PictureWorld> = Object.values(PictureWorld);
+
+/** One world as the contract writes it. */
+export 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;
+}
+
+export const PICTURE_WORLDS = SPEC_SITE_PICTURE_WORLDS as unknown as Readonly<Record<PictureWorld, PictureWorldSpec>>;
+
+/** What no picture of any site shows — every world adds its own after these. */
+export const PICTURE_NEVER: ReadonlyArray<string> = SPEC_SITE_PICTURE_NEVER;
+
+/** The art direction a plan carries (`plan.artDirection`): the world and its five parts as this site wears them. */
+export 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. */
+export const ART_DIRECTION_PARTS = ['medium', 'light', 'grade', 'texture', 'negative'] as const;
+
+export function isPictureWorld(value: unknown): value is PictureWorld {
+    return typeof value === 'string' && (PICTURE_WORLD_IDS as ReadonlyArray<string>).includes(value);
+}
+
+/** OKLCH hue bands (degrees, upper bound) → the word a grade says; below the chroma floor a brand is neutral. */
+const HUE_WORDS: ReadonlyArray<readonly [number, string]> = [
+    [12, 'rose'], [33, 'red'], [55, 'terracotta orange'], [80, 'warm amber'], [110, 'golden yellow'], [135, 'olive green'],
+    [170, 'green'], [215, 'teal'], [255, 'blue'], [285, 'deep blue'], [315, 'violet'], [345, 'plum'], [360, 'rose'],
+];
+const NEUTRAL_CHROMA = 0.04;
+const RADIANS_TO_DEGREES = 180 / Math.PI;
+const FULL_TURN = 360;
+
+/** The word for a brand colour's hue (`#9A4F2B` → "terracotta orange"), or null for a grey, a near-black or a bad value. */
+export function brandHueWord(seed: string | null | undefined): string | null {
+    const rgb = seed ? parseHexColor(seed) : null;
+    if (!rgb) return null;
+    const { a, b } = rgbToOklab(rgb);
+    if (Math.hypot(a, b) < NEUTRAL_CHROMA) return null;
+    const hue = (Math.atan2(b, a) * RADIANS_TO_DEGREES + FULL_TURN) % FULL_TURN;
+    return HUE_WORDS.find(([upTo]) => hue < upTo)?.[1] ?? 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.
+ */
+export function artDirectionFor(world: string | null | undefined, design: Pick<DesignChoices, 'mode' | 'seed'>): ArtDirection {
+    const start = isPictureWorld(world) ? world : PictureWorld.Documentary;
+    const moved = design.mode === 'dark' ? PICTURE_WORLDS[start].dark : start;
+    const id = isPictureWorld(moved) ? moved : start;
+    const spec = PICTURE_WORLDS[id];
+    const hue = brandHueWord(design.seed);
+    return {
+        world: id,
+        medium: spec.medium,
+        light: spec.light,
+        grade: hue ? `${spec.grade}, leaning toward ${hue} so the pictures sit with the brand` : spec.grade,
+        texture: spec.texture,
+        negative: [...PICTURE_NEVER, ...spec.negative],
+    };
+}
+
+/** The ONE preamble a site's every picture prompt opens with — the same words, in the same order, every time. */
+export function artDirectionPreamble(direction: ArtDirection): string {
+    const medium = direction.medium.charAt(0).toUpperCase() + direction.medium.slice(1);
+    return `${medium}. Light: ${direction.light}. Colour: ${direction.grade}. Texture: ${direction.texture}. Never: ${direction.negative.join('; ')}.`;
+}
+
+/** What is wrong with a value as an art direction — a path and a message each (`validateSitePlan` reports them). */
+export function artDirectionIssues(value: unknown): Array<{ path: string; message: string }> {
+    if (!value || typeof value !== 'object' || Array.isArray(value)) return [{ path: '', message: 'must be an object' }];
+    const v = value as Record<string, unknown>;
+    const issues: Array<{ path: string; message: string }> = [];
+    if (!isPictureWorld(v['world'])) issues.push({ path: 'world', message: `must be one of ${PICTURE_WORLD_IDS.join(', ')}` });
+    for (const part of ART_DIRECTION_PARTS.filter(p => p !== 'negative')) {
+        if (typeof v[part] !== 'string' || !(v[part] as string).trim()) issues.push({ path: part, message: 'must be words' });
+    }
+    const negative = v['negative'];
+    if (!Array.isArray(negative) || !negative.length || negative.some(n => typeof n !== 'string' || !n.trim())) {
+        issues.push({ path: 'negative', message: 'must list what no picture may show' });
+    }
+    return issues;
+}

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

@@ -51,6 +51,10 @@ export 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',
@@ -76,6 +80,8 @@ export const FINDING_SEVERITY: Readonly<Record<SiteFindingCode, CheckSeverity>>
     [SiteFindingCode.CopyPlaceholder]: CheckSeverity.Ask,
     [SiteFindingCode.SampleItems]: CheckSeverity.Ask,
     [SiteFindingCode.StockPhoto]: CheckSeverity.Ask,
+    [SiteFindingCode.MadePicture]: CheckSeverity.Ask,
+    [SiteFindingCode.PictureMissing]: CheckSeverity.Warn,
     [SiteFindingCode.NoPrivacyPage]: CheckSeverity.Ask,
     [SiteFindingCode.PrivacyPagePlaceholder]: CheckSeverity.Block,
     [SiteFindingCode.LowContrast]: CheckSeverity.Warn,
@@ -100,6 +106,8 @@ const CHECK_OF: Readonly<Record<SiteFindingCode, SiteCheckId>> = {
     [SiteFindingCode.CopyPlaceholder]: SiteCheckId.Facts,
     [SiteFindingCode.SampleItems]: SiteCheckId.Facts,
     [SiteFindingCode.StockPhoto]: SiteCheckId.Facts,
+    [SiteFindingCode.MadePicture]: SiteCheckId.Facts,
+    [SiteFindingCode.PictureMissing]: SiteCheckId.Facts,
     [SiteFindingCode.NoPrivacyPage]: SiteCheckId.Facts,
     [SiteFindingCode.PrivacyPagePlaceholder]: SiteCheckId.Facts,
     [SiteFindingCode.LowContrast]: SiteCheckId.Accessibility,
@@ -164,6 +172,10 @@ export interface SiteAuditSnapshot {
     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 }>;
+    /** 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 }>;
 }
 
 export interface SiteAuditOptions {
@@ -280,6 +292,8 @@ function checkFacts(ctx: Ctx, snapshot: SiteAuditSnapshot, pages: ReadonlyArray<
     }
     for (const s of snapshot.samples ?? []) add(ctx, SiteFindingCode.SampleItems, `"${s.label ?? s.id}" is a sample — replace or remove it.`, { nodeId: s.id });
     for (const s of (snapshot.stock ?? []).filter(inScope)) add(ctx, SiteFindingCode.StockPhoto, 'A stock photo stands in for one of yours.', { pageId: s.pageId, nodeId: s.nodeId, owner: s.owner });
+    for (const s of (snapshot.made ?? []).filter(inScope)) add(ctx, SiteFindingCode.MadePicture, 'A picture made with AI stands in for one of yours.', { pageId: s.pageId, nodeId: s.nodeId, owner: s.owner });
+    for (const s of (snapshot.missing ?? []).filter(inScope)) add(ctx, SiteFindingCode.PictureMissing, 'A picture could not be made for this spot — add one of yours.', { pageId: s.pageId, nodeId: s.nodeId, owner: s.owner });
     if (!personal) return;
     const privacy = snapshot.pages.find(p => PRIVACY_PAGE.test(p.route) || PRIVACY_PAGE.test(p.name));
     if (!privacy) return add(ctx, SiteFindingCode.NoPrivacyPage, 'A form asks for personal details, and the site has no privacy page saying what you do with them.');