@vectoriox/iox-ui 5.62.1 → 5.63.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, JsonSchema, SiteTemplate, ShapeEntry, AiGenerationStage, AiStep, SitePlan, PlanEdit, PlanChange, SiteAudit } from '@vectoriox/iox-ui/generation-core';
+import { FactKey, PathIssue, PlainObject, JsonSchema, SiteTemplate, ShapeEntry, AiGenerationStage, AiStep, SitePlan, PlanEdit, PlanChange, SiteAudit } from '@vectoriox/iox-ui/generation-core';
 export { JsonSchema } from '@vectoriox/iox-ui/generation-core';
 
 declare const SPEC_HARNESS_SOURCE: {
@@ -2577,6 +2577,13 @@ declare function validateSiteAnalysis(value: unknown, ctx: AnalysisContext): Ana
 /** The name a provider shows the format under (`json_schema.name`). */
 declare const SITE_ANALYSIS_SCHEMA_NAME = "site_analysis";
 declare function siteAnalysisJsonSchema(): JsonSchema;
+/** A model's analysis (the wire) → the document, and the faults only the wire can have (a fact stated twice). Never repairs. */
+declare function analysisFromWire(wire: unknown): {
+    analysis: unknown;
+    issues: AnalysisIssue[];
+};
+/** The document → the wire (what a model writes). */
+declare function analysisToWire(analysis: SiteAnalysis): PlainObject;
 
 /**
  * What the PLAN prompt is given (AI plan rev 3 §3f "Retrieval, not the whole knowledge base"): the one matched
@@ -2801,7 +2808,7 @@ declare function validateSiteReading(value: unknown, ctx: {
     valid: boolean;
     issues: ReadingIssue[];
 };
-/** A valid reading's answer → `SiteReading` (the analysis alone answers `{ analysis }`). */
+/** A valid reading's answer → `SiteReading` (the analysis alone answers `{ analysis }`; the facts made a map again). */
 declare function decodeSiteReading(value: unknown, pictureCount: number): SiteReading;
 /** A reference picture as the server read it: its measured palette (and where it is). */
 interface MeasuredPicture {
@@ -2987,5 +2994,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, analysisPromptContext, businessTypeById, calmerChoice, decodeSiteReading, inferNeeds, isLookRule, lintDesign, lookMatches, mapStyleRead, matchBusinessType, matchBusinessTypes, measurePalette, mergeStyleReads, motionAdvice, motionFor, normalizeAddress, oklchHue, paletteBrand, paletteGround, paletteSamples, pictureStyleRead, pixelSamples, presetDesign, presetHasSerifHeadings, presetLook, presetReason, rankStylePresets, rankWithReferences, readPalette, referenceSeed, seedPassesPreset, siteAnalysisJsonSchema, siteReadingJsonSchema, startingDesign, structureFor, userAvoidRule, validateSiteAnalysis, validateSiteReading, withoutAddress };
+export { 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, businessTypeById, calmerChoice, decodeSiteReading, inferNeeds, isLookRule, lintDesign, lookMatches, mapStyleRead, matchBusinessType, matchBusinessTypes, measurePalette, mergeStyleReads, motionAdvice, motionFor, normalizeAddress, oklchHue, paletteBrand, paletteGround, paletteSamples, pictureStyleRead, pixelSamples, presetDesign, presetHasSerifHeadings, presetLook, presetReason, rankStylePresets, rankWithReferences, readPalette, referenceSeed, seedPassesPreset, siteAnalysisJsonSchema, siteReadingJsonSchema, startingDesign, structureFor, userAvoidRule, validateSiteAnalysis, validateSiteReading, withoutAddress };
 export type { AiGenerationView, AnalysisContext, AnalysisIssue, AnalysisValidation, AvoidRule, BusinessType, BusinessTypeMatch, CheckRule, ColourSample, FactRead, GenerationFileView, GenerationReadersView, GenerationStartRequest, GoodFit, LintFinding, LintSite, LookCondition, LookDesign, LookRule, MeasuredPicture, MotionBasis, MotionInput, MotionStart, NeedDef, NeedId, PaletteColour, PaletteReading, PictureStyle, PlanRevisionView, PromptContext, PromptContextOptions, PromptSection, RankInput, RankedPreset, ReadingIssue, ReferenceSeed, SiteAnalysis, SiteAuditView, SiteNeed, SiteReaderView, SiteReading, StartingDesign, StructureChoice, StructureId, StyleHints, StyleRead, UserAvoidId };

package/package.json

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

package/src/harness-core/site-analysis.ts

@@ -1,6 +1,6 @@
 import { MOOD_IDS, MoodId } from '@vectoriox/iox-ui/design-core';
 import {
-    describeShapeKey, FACT_KEYS, FactKey, isPlainObject, jsonClosedObject, jsonListOf, jsonOneOf, JsonSchema, jsonShapedObject, jsonText,
+    describeShapeKey, FACT_KEYS, FactKey, isPlainObject, jsonListOf, jsonOneOf, JsonSchema, jsonShapedObject, jsonText,
     PathIssue, PathIssueCollector, pathAt, PlainObject, requiredShapeKeys, ShapeEntry, shapeKeys,
 } from '@vectoriox/iox-ui/generation-core';
 
@@ -187,6 +187,11 @@ export function validateSiteAnalysis(value: unknown, ctx: AnalysisContext): Anal
  * native strict modes accept (Anthropic `output_config.format`, OpenRouter `json_schema` + `strict`): every object
  * closes with `additionalProperties: false`; no length, count or number bounds (the gate checks those). The
  * schema is a hint the provider enforces; `validateSiteAnalysis` stays the gate.
+ *
+ * ONE difference from the document, the plan wire's rule "maps as lists" (vectoriox/iox-cms#47 — Claude refuses a
+ * grammar compiled too large, and a map of the five facts, each `{ value, quote }`, was 15 of the reading's 47
+ * properties): on the wire `facts` is a list `[{ fact, value, quote }]`, a stated fact once each. `analysisFromWire`
+ * makes it the map `validateSiteAnalysis` judges; `analysisToWire` is its inverse (fakes and specs write it).
  */
 
 export type { JsonSchema } from '@vectoriox/iox-ui/generation-core';
@@ -201,19 +206,26 @@ const listOf = jsonListOf;
 /** An object of `shape`: exactly its keys, its required ones required, each described by the table. */
 const shaped = (shape: string, properties: Record<string, JsonSchema>): JsonSchema => jsonShapedObject(SHAPE[shape], properties, shape);
 
-/** `{ [fact]: factRead }`: the closed fact keys, each optional — a fact the prompt does not state is left out. */
-function factsSchema(factRead: JsonSchema): JsonSchema {
-    return jsonClosedObject(Object.fromEntries(FACT_KEYS.map(key => [key, factRead])), [], describeShapeKey(SHAPE['analysis'], 'facts'));
-}
+/** A stated fact on the wire: which fact, then the document's `factRead` keys in the table's own words. */
+const FACT_LINE_SHAPE: ShapeEntry = {
+    fact: `${FACT_KEYS.map(k => `'${k}'`).join(' | ')} — which fact (site.facts), each at most once`,
+    ...SHAPE['factRead'],
+};
+
+/** The analysis as the wire carries it: `facts` a list of fact lines, described in the table's words. */
+const ANALYSIS_WIRE_SHAPE: ShapeEntry = {
+    ...SHAPE['analysis'],
+    facts: `factLine[] — ${describeShapeKey(SHAPE['analysis'], 'facts').replace(/^\{ \[fact\]: factRead \} — /, '')}`,
+};
 
 export function siteAnalysisJsonSchema(): JsonSchema {
-    const factRead = shaped('factRead', { value: text(), quote: text() });
-    return shaped('analysis', {
+    const factLine = jsonShapedObject(FACT_LINE_SHAPE, { fact: oneOf(FACT_KEYS), value: text(), quote: text() }, 'factLine');
+    return jsonShapedObject(ANALYSIS_WIRE_SHAPE, {
         businessType: oneOf(BUSINESS_TYPE_IDS),
         alternatives: listOf(oneOf(BUSINESS_TYPE_IDS)),
         business: shaped('business', { name: text(), audience: text() }),
         needs: listOf(shaped('need', { id: oneOf(NEED_IDS), from: oneOf(Object.values(NeedSource)), name: text() })),
-        facts: factsSchema(factRead),
+        facts: listOf(factLine),
         missingFacts: listOf(oneOf(FACT_KEYS)),
         voice: shaped('voice', {
             tone: text(),
@@ -225,5 +237,28 @@ export function siteAnalysisJsonSchema(): JsonSchema {
         avoid: listOf(oneOf(USER_AVOID_IDS)),
         hero: shaped('hero', { headline: text(), lead: text() }),
         locale: oneOf(Object.values(AnalysisLocale)),
+    }, 'analysis');
+}
+
+/** A model's analysis (the wire) → the document, and the faults only the wire can have (a fact stated twice). Never repairs. */
+export function analysisFromWire(wire: unknown): { analysis: unknown; issues: AnalysisIssue[] } {
+    if (!isPlainObject(wire)) return { analysis: wire, issues: [] };
+    if (!Array.isArray(wire['facts'])) return { analysis: wire, issues: [{ code: AnalysisIssueCode.Shape, path: 'facts', message: 'must be a list of { fact, value, quote }' }] };
+    const facts: PlainObject = {};
+    const issues: AnalysisIssue[] = [];
+    (wire['facts'] as unknown[]).forEach((line, i) => {
+        if (!isPlainObject(line) || typeof line['fact'] !== 'string') {
+            issues.push({ code: AnalysisIssueCode.Shape, path: `facts[${i}]`, message: 'must be { fact, value, quote }' });
+            return;
+        }
+        const { fact, ...read } = line;
+        if (fact in facts) issues.push({ code: AnalysisIssueCode.Duplicate, path: `facts[${i}].fact`, message: `"${fact}" is stated twice` });
+        else facts[fact as string] = read;
     });
+    return { analysis: { ...wire, facts }, issues };
+}
+
+/** The document → the wire (what a model writes). */
+export function analysisToWire(analysis: SiteAnalysis): PlainObject {
+    return { ...analysis, facts: Object.entries(analysis.facts).map(([fact, read]) => ({ fact, ...read })) };
 }

package/src/harness-core/site-reading.ts

@@ -6,7 +6,7 @@ import {
 
 import { paletteSamples, readPalette } from './palette';
 import { StyleRead, StyleReadGround, StyleReadHeadings, StyleReadSourceKind } from './rank';
-import { AnalysisIssue, MAX_ANALYSIS_MOODS, SiteAnalysis, siteAnalysisJsonSchema, validateSiteAnalysis } from './site-analysis';
+import { AnalysisIssue, analysisFromWire, MAX_ANALYSIS_MOODS, SiteAnalysis, siteAnalysisJsonSchema, validateSiteAnalysis } from './site-analysis';
 
 /**
  * The READING call (AI plan §3d step 1, §3k R2, M1-1): ONE `text.fast` call reads the owner's words AND the pictures
@@ -129,23 +129,32 @@ function validatePictures(c: Collector, raw: unknown, count: number): void {
     c.oneOf(style, 'density', Object.keys(SPEC_AXES.densities), 'pictures.style');
 }
 
+/** The analysis on the wire, judged as the document it becomes: the wire's own faults, then `validateSiteAnalysis`'s. */
+function analysisIssues(wire: unknown, prompt: string): AnalysisIssue[] {
+    const read = analysisFromWire(wire);
+    return [...read.issues, ...validateSiteAnalysis(read.analysis, { prompt }).issues];
+}
+
 /** The reading's gate: the analysis by `validateSiteAnalysis` (paths under `analysis.` when pictures came too), the pictures by `READING_SHAPE`. */
 export function validateSiteReading(value: unknown, ctx: { prompt: string; pictureCount: number }): { valid: boolean; issues: ReadingIssue[] } {
-    if (ctx.pictureCount <= 0) return validateSiteAnalysis(value, { prompt: ctx.prompt });
+    if (ctx.pictureCount <= 0) {
+        const issues = analysisIssues(value, ctx.prompt);
+        return { valid: issues.length === 0, issues };
+    }
     const c = new Collector();
     const reading = c.object(value, 'reading', '');
     if (!reading) return { valid: false, issues: c.issues };
-    const analysis = validateSiteAnalysis(reading['analysis'], { prompt: ctx.prompt });
-    const issues: ReadingIssue[] = analysis.issues.map(i => ({ ...i, path: pathAt('analysis', i.path) }));
+    const issues: ReadingIssue[] = analysisIssues(reading['analysis'], ctx.prompt).map(i => ({ ...i, path: pathAt('analysis', i.path) }));
     validatePictures(c, reading['pictures'], ctx.pictureCount);
     issues.push(...c.issues);
     return { valid: issues.length === 0, issues };
 }
 
-/** A valid reading's answer → `SiteReading` (the analysis alone answers `{ analysis }`). */
+/** A valid reading's answer → `SiteReading` (the analysis alone answers `{ analysis }`; the facts made a map again). */
 export function decodeSiteReading(value: unknown, pictureCount: number): SiteReading {
-    if (pictureCount <= 0) return { analysis: value as SiteAnalysis };
-    return value as SiteReading;
+    if (pictureCount <= 0) return { analysis: analysisFromWire(value).analysis as SiteAnalysis };
+    const reading = value as SiteReading;
+    return { ...reading, analysis: analysisFromWire(reading.analysis).analysis as SiteAnalysis };
 }
 
 // ── Readings → ONE StyleRead ───────────────────────────────────────────────────────────────────────────