@vectoriox/iox-ui 5.62.0 → 5.63.0

package/fesm2022/vectoriox-iox-ui-harness-core.mjs

@@ -1,5 +1,5 @@
 import { MOOD_IDS, MOOD_LABELS, STYLE_PRESETS, flavorPackById, parseFontFamilies, SPEC_AXES, parseHexColor, rgbToOklab, presetChoices, toHexColor, stylePresetById, resolveTokenValues, designTokenRows, wcagContrastRatio, auditDesignContrast } from '@vectoriox/iox-ui/design-core';
-import { shapeKeys, requiredShapeKeys, PathIssueCollector, isPlainObject, pathAt, FACT_KEYS, jsonText, jsonOneOf, jsonListOf, jsonShapedObject, jsonClosedObject, describeShapeKey, SPEC_SITE_LIBRARY, patternById, SITE_FACT_LABELS, HEBREW_PREFIXES, SITE_TEMPLATES, STUDIO_TEMPLATE, jsonInteger } from '@vectoriox/iox-ui/generation-core';
+import { shapeKeys, requiredShapeKeys, PathIssueCollector, isPlainObject, pathAt, FACT_KEYS, jsonText, jsonOneOf, jsonListOf, jsonShapedObject, describeShapeKey, SPEC_SITE_LIBRARY, patternById, SITE_FACT_LABELS, HEBREW_PREFIXES, SITE_TEMPLATES, STUDIO_TEMPLATE, jsonInteger } from '@vectoriox/iox-ui/generation-core';
 
 // GENERATED from iox-ai-guidance flavor-spec.v1.json — do not edit; re-run scripts/gen-flavor-spec.mjs
 // (npm run gen:flavor-spec). The JSON is itself generated by iox-ai-guidance
@@ -3912,18 +3912,24 @@ const oneOf = jsonOneOf;
 const listOf = jsonListOf;
 /** An object of `shape`: exactly its keys, its required ones required, each described by the table. */
 const shaped = (shape, properties) => 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) {
-    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 = {
+    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 = {
+    ...SHAPE['analysis'],
+    facts: `factLine[] — ${describeShapeKey(SHAPE['analysis'], 'facts').replace(/^\{ \[fact\]: factRead \} — /, '')}`,
+};
 function siteAnalysisJsonSchema() {
-    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(),
@@ -3935,7 +3941,32 @@ function siteAnalysisJsonSchema() {
         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. */
+function analysisFromWire(wire) {
+    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 = {};
+    const issues = [];
+    wire['facts'].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] = read;
     });
+    return { analysis: { ...wire, facts }, issues };
+}
+/** The document → the wire (what a model writes). */
+function analysisToWire(analysis) {
+    return { ...analysis, facts: Object.entries(analysis.facts).map(([fact, read]) => ({ fact, ...read })) };
 }
 
 var PresetFit;
@@ -4665,25 +4696,32 @@ function validatePictures(c, raw, count) {
     c.oneOf(style, 'shape', Object.keys(SPEC_AXES.shapes), 'pictures.style');
     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, prompt) {
+    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`. */
 function validateSiteReading(value, ctx) {
-    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 = analysis.issues.map(i => ({ ...i, path: pathAt('analysis', i.path) }));
+    const issues = 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). */
 function decodeSiteReading(value, pictureCount) {
     if (pictureCount <= 0)
-        return { analysis: value };
-    return value;
+        return { analysis: analysisFromWire(value).analysis };
+    const reading = value;
+    return { ...reading, analysis: analysisFromWire(reading.analysis).analysis };
 }
 /** The liked pictures as a StyleRead: their palettes measured together, what the model saw of them. */
 function pictureStyleRead(pictures, style) {
@@ -4842,5 +4880,5 @@ function startingDesign(input, read = null) {
  * Generated bundle index. Do not edit.
  */
 
-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 };
 //# sourceMappingURL=vectoriox-iox-ui-harness-core.mjs.map