@vectoriox/iox-ui 5.51.0 → 5.53.0

package/src/design-core/flavor-spec.generated.ts

@@ -1695,6 +1695,7 @@ export const SPEC_STYLE_PRESETS = [
       "Minimalism & Swiss Style"
     ],
     "blurb": "Clean, light and easy to read. Says \"you are in good hands\".",
+    "blurbHe": "נקי, בהיר וקל לקריאה. אומר \"אתם בידיים טובות\".",
     "slice": true
   },
   {
@@ -1727,6 +1728,7 @@ export const SPEC_STYLE_PRESETS = [
       "Swiss Modernism 2.0"
     ],
     "blurb": "Black on white, a strict grid, nothing extra.",
+    "blurbHe": "שחור על לבן, גריד קפדני, בלי שום תוספות.",
     "slice": true
   },
   {
@@ -1757,6 +1759,7 @@ export const SPEC_STYLE_PRESETS = [
       "Trust & Authority (landing)"
     ],
     "blurb": "Navy, plain type, firm edges. Serious without being cold.",
+    "blurbHe": "כחול כהה, אותיות פשוטות ופינות חדות. רציני, אבל לא קר.",
     "slice": true
   },
   {
@@ -1788,6 +1791,7 @@ export const SPEC_STYLE_PRESETS = [
       "Accessible & Ethical"
     ],
     "blurb": "Bright, soft and reassuring, with rounded buttons.",
+    "blurbHe": "בהיר, רך ומרגיע, עם כפתורים מעוגלים.",
     "slice": false
   },
   {
@@ -1820,6 +1824,7 @@ export const SPEC_STYLE_PRESETS = [
       "Editorial Grid / Magazine"
     ],
     "blurb": "White walls and a quiet serif. The work does the talking.",
+    "blurbHe": "קירות לבנים וסריף שקט. העבודות מדברות בעד עצמן.",
     "slice": true
   },
   {
@@ -1851,6 +1856,7 @@ export const SPEC_STYLE_PRESETS = [
       "Nature Distilled"
     ],
     "blurb": "Cream paper, terracotta and a soft serif, like a good magazine.",
+    "blurbHe": "נייר בצבע שמנת, טרקוטה וסריף רך, כמו מגזין טוב.",
     "slice": true
   },
   {
@@ -1882,6 +1888,7 @@ export const SPEC_STYLE_PRESETS = [
       "Nature Distilled"
     ],
     "blurb": "Rose-tinted cream, a fine serif and slow, gentle motion.",
+    "blurbHe": "שמנת בגוון ורוד, סריף עדין ותנועה איטית ורכה.",
     "slice": true
   },
   {
@@ -1914,6 +1921,7 @@ export const SPEC_STYLE_PRESETS = [
       "Liquid Glass (luxury rows, without the glass)"
     ],
     "blurb": "Bronze on warm white. Expensive, never loud.",
+    "blurbHe": "ברונזה על לבן חם. יוקרתי, אבל אף פעם לא צעקני.",
     "slice": false
   },
   {
@@ -1945,6 +1953,7 @@ export const SPEC_STYLE_PRESETS = [
       "Vibrant & Block-based"
     ],
     "blurb": "A night out: dark rooms, one bright colour, lively motion.",
+    "blurbHe": "יציאה בלילה: חללים כהים, צבע בוהק אחד ותנועה תוססת.",
     "slice": false
   },
   {
@@ -1976,6 +1985,7 @@ export const SPEC_STYLE_PRESETS = [
       "Brutalism"
     ],
     "blurb": "Black, sharp and orange. A shop with attitude.",
+    "blurbHe": "שחור, חד וכתום. עסק עם אופי.",
     "slice": false
   },
   {
@@ -2008,6 +2018,7 @@ export const SPEC_STYLE_PRESETS = [
       "Minimalism & Swiss Style"
     ],
     "blurb": "Pictures on black, like a darkened gallery.",
+    "blurbHe": "תמונות על רקע שחור, כמו בגלריה חשוכה.",
     "slice": true
   },
   {
@@ -2040,6 +2051,7 @@ export const SPEC_STYLE_PRESETS = [
       "Minimalism & Swiss Style"
     ],
     "blurb": "Dark, precise and modern, for people who build things.",
+    "blurbHe": "כהה, מדויק ועכשווי, לאנשים שבונים דברים.",
     "slice": false
   },
   {
@@ -2071,6 +2083,7 @@ export const SPEC_STYLE_PRESETS = [
       "Soft UI Evolution"
     ],
     "blurb": "Frosted panels over a soft teal light. Fresh and calm.",
+    "blurbHe": "משטחי זכוכית חלבית על אור טורקיז רך. רענן ורגוע.",
     "slice": true
   },
   {
@@ -2101,6 +2114,7 @@ export const SPEC_STYLE_PRESETS = [
       "Glassmorphism"
     ],
     "blurb": "Sea-blue glass and big photos. Makes people want to go.",
+    "blurbHe": "זכוכית בכחול של ים ותמונות גדולות. מעורר חשק לנסוע.",
     "slice": false
   },
   {
@@ -2132,6 +2146,7 @@ export const SPEC_STYLE_PRESETS = [
       "Spatial UI (VisionOS)"
     ],
     "blurb": "Grey glass and lots of space around your pictures.",
+    "blurbHe": "זכוכית אפורה והרבה מרחב סביב התמונות שלכם.",
     "slice": true
   },
   {
@@ -2162,6 +2177,7 @@ export const SPEC_STYLE_PRESETS = [
       "Vibrant & Block-based"
     ],
     "blurb": "Warm coral and bouncy buttons. Full of energy.",
+    "blurbHe": "אלמוג חם וכפתורים קופצניים. מלא אנרגיה.",
     "slice": false
   },
   {
@@ -2193,6 +2209,7 @@ export const SPEC_STYLE_PRESETS = [
       "Soft UI Evolution"
     ],
     "blurb": "Berry red, round shapes, a cheerful headline face.",
+    "blurbHe": "אדום פירות יער, צורות עגולות ופונט כותרות עליז.",
     "slice": true
   },
   {
@@ -2224,6 +2241,7 @@ export const SPEC_STYLE_PRESETS = [
       "Organic Biophilic"
     ],
     "blurb": "Leaf green and soft, open shapes. Welcoming to everyone.",
+    "blurbHe": "ירוק עלים וצורות רכות ופתוחות. מזמין את כולם.",
     "slice": false
   },
   {
@@ -2254,6 +2272,7 @@ export const SPEC_STYLE_PRESETS = [
       "Vibrant & Block-based"
     ],
     "blurb": "Teal, chunky and playful. Made for families.",
+    "blurbHe": "טורקיז, צורות שמנמנות והרבה שובבות. נועד למשפחות.",
     "slice": false
   },
   {
@@ -2285,6 +2304,7 @@ export const SPEC_STYLE_PRESETS = [
       "Organic Biophilic"
     ],
     "blurb": "Dusty rose and soft lavender light. A celebration.",
+    "blurbHe": "ורוד עתיק ואור לבנדר רך. תחושה של חגיגה.",
     "slice": true
   },
   {
@@ -2316,6 +2336,7 @@ export const SPEC_STYLE_PRESETS = [
       "Vibrant & Block-based"
     ],
     "blurb": "Thick outlines and orange. Proud of what you make.",
+    "blurbHe": "קווי מתאר עבים וכתום. גאים במה שאתם יוצרים.",
     "slice": true
   },
   {
@@ -2348,6 +2369,7 @@ export const SPEC_STYLE_PRESETS = [
       "Vibrant & Block-based"
     ],
     "blurb": "Pink, heavy type, poster energy.",
+    "blurbHe": "ורוד, אותיות כבדות, אנרגיה של פוסטר.",
     "slice": false
   },
   {
@@ -2379,6 +2401,7 @@ export const SPEC_STYLE_PRESETS = [
       "Anti-Polish / Raw Aesthetic"
     ],
     "blurb": "Electric blue and an odd, wide face. Made by hand, on purpose.",
+    "blurbHe": "כחול חשמלי ופונט רחב ומשונה. נראה כמו עבודת יד, ובכוונה.",
     "slice": false
   },
   {
@@ -2410,6 +2433,7 @@ export const SPEC_STYLE_PRESETS = [
       "Flat Design"
     ],
     "blurb": "Green and bright, like a market stall in the morning.",
+    "blurbHe": "ירוק ובהיר, כמו דוכן בשוק בבוקר.",
     "slice": false
   }
 ] as const;

package/src/design-core/style-presets.ts

@@ -21,8 +21,11 @@ export type PresetMode = Exclude<DesignMode, 'auto'>;
 
 export interface StylePreset {
     readonly id: string;
+    /** A proper name — never translated. */
     readonly name: string;
     readonly blurb: string;
+    /** The blurb in Hebrew (2026-10-25). */
+    readonly blurbHe: string;
     readonly flavorId: string;
     readonly seed: string;
     readonly tint: TintId;

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

@@ -0,0 +1,205 @@
+/**
+ * The AI pipeline's WIRE vocabulary (AI plan §3c, §3n, M0): what iox-cms's `ai` API answers and what every client
+ * of it reads — the steps a model works on, who pays (IOX credits or the studio's own key), a model of the vetted
+ * list with its price per token class, the one cost → credits rule (1 credit = 1 US cent of what the AI cost, D4),
+ * the refusals (board 11) and a generation's stages. ONE definition: iox-cms meters and refuses with it, the
+ * Settings ▸ AI screen and the wizard show it. Pure types, enums and helpers; no transport, no prices typed here.
+ */
+
+export enum AiProviderId {
+    Anthropic = 'anthropic',
+    OpenRouter = 'openrouter',
+}
+
+/** Who pays: the platform's credits, or the studio's own provider key (metered for display, never charged). */
+export enum AiKeyMode {
+    Platform = 'platform',
+    Own = 'own',
+}
+
+/** The steps a model works on (board 9's rows), in screen order. */
+export enum AiStep {
+    ReadMessage = 'read',
+    PlanSite = 'plan',
+    ChangePlan = 'change',
+    MakePictures = 'pictures',
+    NameStructures = 'scan',
+}
+
+export const AI_STEPS: ReadonlyArray<AiStep> = Object.values(AiStep);
+
+/** What a model must be able to do for a step to run on it. */
+export enum AiCapability {
+    StructuredOutput = 'structured-output',
+    ImageInput = 'image-input',
+    ImageOutput = 'image-output',
+}
+
+export const AI_STEP_NEEDS: Readonly<Record<AiStep, ReadonlyArray<AiCapability>>> = {
+    [AiStep.ReadMessage]: [AiCapability.StructuredOutput, AiCapability.ImageInput],
+    [AiStep.PlanSite]: [AiCapability.StructuredOutput],
+    [AiStep.ChangePlan]: [AiCapability.StructuredOutput],
+    [AiStep.MakePictures]: [AiCapability.ImageOutput],
+    [AiStep.NameStructures]: [AiCapability.StructuredOutput],
+};
+
+/** Tokens a typical use of a step reads and writes (plan §3d "Where credits go") — what a shown estimate is made of. */
+export const AI_STEP_TYPICAL_TOKENS: Readonly<Record<AiStep, AiTokenCounts>> = {
+    [AiStep.ReadMessage]: { input: 8_800, output: 1_500, cacheWrite: 0, cacheRead: 0 },
+    [AiStep.PlanSite]: { input: 12_000, output: 7_000, cacheWrite: 0, cacheRead: 0 },
+    [AiStep.ChangePlan]: { input: 6_000, output: 500, cacheWrite: 0, cacheRead: 0 },
+    [AiStep.MakePictures]: { input: 1_120, output: 0, cacheWrite: 0, cacheRead: 0 },
+    [AiStep.NameStructures]: { input: 80_000, output: 10_000, cacheWrite: 0, cacheRead: 0 },
+};
+
+/** Tokens by the class a provider prices them in. */
+export interface AiTokenCounts {
+    input: number;
+    output: number;
+    /** Written to the prompt cache (priced above input). */
+    cacheWrite: number;
+    /** Read from the prompt cache (priced well below input). */
+    cacheRead: number;
+}
+
+/** US dollars per million tokens, per class. A class without a price is priced as input. */
+export interface AiTokenPrice {
+    input: number;
+    output: number;
+    cacheWrite?: number;
+    cacheRead?: number;
+}
+
+/** A model of the vetted list (served by the control plane with the entitlements, §3n) — its price travels with it. */
+export interface AiModelEntry {
+    id: string;
+    provider: `${AiProviderId}`;
+    label: string;
+    /** The steps it may be chosen for. */
+    steps: ReadonlyArray<`${AiStep}`>;
+    /** The steps it is the default for (board 9's "recommended"). */
+    recommendedFor?: ReadonlyArray<`${AiStep}`>;
+    capabilities: ReadonlyArray<`${AiCapability}`>;
+    /** Null when the provider reports each call's cost itself and the list carries no price. */
+    price: AiTokenPrice | null;
+    /** Kept so old ledger rows still name it; never offered, and a studio's choice of it falls back to the default. */
+    retired?: boolean;
+}
+
+/** 1 credit = 1 US cent of what the AI actually cost (decision D4). */
+export const CREDITS_PER_USD = 100;
+const TOKENS_PER_PRICE_UNIT = 1_000_000;
+const CREDIT_PRECISION = 1e6;
+
+export const NO_TOKENS: Readonly<AiTokenCounts> = Object.freeze({ input: 0, output: 0, cacheWrite: 0, cacheRead: 0 });
+
+/** What `tokens` cost at `price`, in US dollars. */
+export function costUsd(tokens: AiTokenCounts, price: AiTokenPrice): number {
+    const perToken = (perMillion: number | undefined, fallback: number) => (perMillion ?? fallback) / TOKENS_PER_PRICE_UNIT;
+    return tokens.input * perToken(price.input, 0)
+        + tokens.output * perToken(price.output, 0)
+        + tokens.cacheWrite * perToken(price.cacheWrite, price.input)
+        + tokens.cacheRead * perToken(price.cacheRead, price.input);
+}
+
+/** Dollars → credits, kept to a millionth of a credit (a short read costs a fraction of one). */
+export function creditsOfUsd(usd: number): number {
+    return Math.round(usd * CREDITS_PER_USD * CREDIT_PRECISION) / CREDIT_PRECISION;
+}
+
+/** The credits a typical use of `step` costs on a model of `price` — never typed, always computed (§3d). */
+export function estimateStepCredits(step: AiStep, price: AiTokenPrice, tokens: AiTokenCounts = AI_STEP_TYPICAL_TOKENS[step]): number {
+    return creditsOfUsd(costUsd(tokens, price));
+}
+
+/** Can `model` do `step`? The step's needs against the model's capabilities. */
+export function modelCanDo(model: Pick<AiModelEntry, 'capabilities'>, step: AiStep): boolean {
+    return AI_STEP_NEEDS[step].every(need => model.capabilities.includes(need));
+}
+
+/** Why AI did not run (board 11). The server refuses with these BEFORE any model call. */
+export enum AiRefusalCode {
+    NotInPlan = 'ai.notInPlan',
+    OutOfCredits = 'ai.outOfCredits',
+    CapReached = 'ai.capReached',
+    NotConnected = 'ai.notConnected',
+    KeyInvalid = 'ai.keyInvalid',
+    PlanUnknown = 'ai.planUnknown',
+}
+
+/** The HTTP status each refusal answers with (board 11). */
+export const AI_REFUSAL_STATUS: Readonly<Record<AiRefusalCode, number>> = {
+    [AiRefusalCode.NotInPlan]: 403,
+    [AiRefusalCode.OutOfCredits]: 402,
+    [AiRefusalCode.CapReached]: 402,
+    [AiRefusalCode.NotConnected]: 409,
+    [AiRefusalCode.KeyInvalid]: 409,
+    [AiRefusalCode.PlanUnknown]: 503,
+};
+
+/** What a refusal offers next. */
+export enum AiNextKind {
+    /** Ask IOX (a prefilled email to the operator, until a plan can be bought — D2). */
+    Contact = 'contact',
+    /** Open Settings ▸ AI. */
+    Settings = 'settings',
+    /** Try again later, or with less. */
+    Retry = 'retry',
+}
+
+export const AI_REFUSAL_NEXT: Readonly<Record<AiRefusalCode, AiNextKind>> = {
+    [AiRefusalCode.NotInPlan]: AiNextKind.Contact,
+    [AiRefusalCode.OutOfCredits]: AiNextKind.Contact,
+    [AiRefusalCode.CapReached]: AiNextKind.Retry,
+    [AiRefusalCode.NotConnected]: AiNextKind.Settings,
+    [AiRefusalCode.KeyInvalid]: AiNextKind.Settings,
+    [AiRefusalCode.PlanUnknown]: AiNextKind.Retry,
+};
+
+export interface AiRefusal {
+    code: AiRefusalCode;
+    planName?: string;
+    /** Credits left this period (platform credits only). */
+    remaining?: number;
+    /** What the refused call would have cost, about. */
+    estimate?: number;
+    next: { kind: AiNextKind; href?: string };
+}
+
+/** The studio's AI credits this period (the connector's meter, E4). `allowance: null` = unlimited. */
+export interface AiMeter {
+    used: number;
+    allowance: number | null;
+    remaining: number | null;
+    periodStart: string;
+    periodEnd: string;
+}
+
+/** A generation's stages (§3d). The runner works while `task` is set; otherwise the owner has the next move. */
+export enum AiGenerationStage {
+    Reading = 'reading',
+    Analysis = 'analysis',
+    Design = 'design',
+    Plan = 'plan',
+    Build = 'build',
+    Done = 'done',
+    Failed = 'failed',
+    Cancelled = 'cancelled',
+}
+
+/** The stages nothing advances any more. */
+export const FINAL_GENERATION_STAGES: ReadonlyArray<AiGenerationStage> = [AiGenerationStage.Done, AiGenerationStage.Failed, AiGenerationStage.Cancelled];
+
+/** How one model call ended — a ledger row's status. */
+export enum AiCallStatus {
+    /** Written before the call: a reservation at the estimate until the call settles. */
+    Started = 'started',
+    Ok = 'ok',
+    /** The answer came back and the shared validator refused it (with a path). */
+    Invalid = 'invalid',
+    /** The model declined (a provider refusal) — charged what the provider reports. */
+    Refused = 'refused',
+    Error = 'error',
+    /** The process died during the call: charged at the estimate, since what it cost was never reported. */
+    Interrupted = 'interrupted',
+}

package/src/generation-core/public-api.ts

@@ -24,3 +24,4 @@ export * from './nav-shape';
 export * from './entrances';
 export * from './plan-data';
 export * from './site-build-run';
+export * from './ai-run';

package/src/harness-core/business-types.ts

@@ -90,6 +90,8 @@ export const isLookRule = (rule: AvoidRule): rule is LookRule => 'when' in rule;
 export interface GoodFit {
     readonly preset: string;
     readonly reason: string;
+    /** The reason in Hebrew (2026-10-25). */
+    readonly reasonHe: string;
 }
 
 export interface BusinessType {