@vectoriox/iox-ui 5.56.0 → 5.57.0

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

@@ -1,4 +1,4 @@
-import { MOOD_IDS, MOOD_LABELS, STYLE_PRESETS, flavorPackById, parseFontFamilies, SPEC_AXES, parseHexColor, rgbToOklab, presetChoices, toHexColor, stylePresetById, auditDesignContrast, designTokenRows } from '@vectoriox/iox-ui/design-core';
+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, 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
@@ -4518,6 +4518,15 @@ function readPalette(samples) {
     return { palette, ground: paletteGround(palette), ...(brand ? { brand } : {}) };
 }
 
+/** The raw colour's ratio against the preset's own page ground, in its first mode — shown, never decisive. */
+function rawRatioOf(presetId, hex) {
+    const preset = stylePresetById(presetId);
+    const choices = preset ? presetChoices(preset.id, preset.modes[0]) : null;
+    if (!preset || !choices)
+        return null;
+    const ground = resolveTokenValues(designTokenRows(choices), preset.modes[0])['page-bg'];
+    return ground && parseHexColor(ground) ? Math.round(wcagContrastRatio(hex, ground) * 100) / 100 : null;
+}
 /** Every mode `presetId` offers passes the audit with `seed`. */
 function seedPassesPreset(presetId, seed) {
     const preset = stylePresetById(presetId);
@@ -4536,9 +4545,10 @@ function referenceSeed(read, presetId) {
         return null;
     const reference = read?.brand && parseHexColor(read.brand) ? read.brand : null;
     if (!reference)
-        return { seed: preset.seed, reference: null, used: false, failsIn: [] };
+        return { seed: preset.seed, reference: null, used: false, failsIn: [], rawRatio: null };
     const { passes, failsIn } = seedPassesPreset(preset.id, reference);
-    return passes ? { seed: reference, reference, used: true, failsIn: [] } : { seed: preset.seed, reference, used: false, failsIn };
+    const rawRatio = rawRatioOf(preset.id, reference);
+    return passes ? { seed: reference, reference, used: true, failsIn: [], rawRatio } : { seed: preset.seed, reference, used: false, failsIn, rawRatio };
 }
 
 /**
@@ -4795,24 +4805,28 @@ const GENERATION_LIMITS = {
  * references — the best-ranked style with the reference colour as its seed when that colour passes AA in every mode
  * the style offers (`referenceSeed`). Pure.
  */
-/** A preset for this business: its choices, Motion from the business (`motionFor`), what the owner already set kept. */
+/**
+ * A preset for this business: its choices, Motion from the business (`motionFor`), the references' colour as its seed
+ * when that colour passes AA in every mode the preset offers (`referenceSeed` — judged as used), and what the owner
+ * already set kept. The ONE rule for a Look pick and for Build with these.
+ */
 function presetDesign(presetId, input, kept = {}, read = null) {
     const base = presetChoices(presetId);
     if (!base)
         return null;
-    const motionInput = typeof input === 'string' || input === null ? { businessType: input } : input;
+    const motionInput = typeof input === 'object' && input !== null ? input : { businessType: input };
     const start = motionFor(motionInput, presetId, read);
-    return { ...base, scroll: start.scroll, animate: start.animate, between: start.between, ...kept };
+    const seed = referenceSeed(read, presetId);
+    return { ...base, ...(seed?.used ? { seed: seed.seed } : {}), scroll: start.scroll, animate: start.animate, between: start.between, ...kept };
 }
 /** The look a business starts from: its best-ranked style (with the references' boost), at its defaults. */
 function startingDesign(input, read = null) {
-    const rankInput = typeof input === 'string' || input === null ? { businessType: input } : input;
+    const rankInput = typeof input === 'object' && input !== null ? input : { businessType: input };
     const top = rankWithReferences(rankInput, read)[0];
     const design = top ? presetDesign(top.id, rankInput, {}, read) : null;
     if (!top || !design)
         return null;
-    const seed = referenceSeed(read, top.id);
-    return seed?.used ? { presetId: top.id, design: { ...design, seed: seed.seed }, referenceColour: true } : { presetId: top.id, design, referenceColour: false };
+    return { presetId: top.id, design, referenceColour: !!referenceSeed(read, top.id)?.used };
 }
 
 /**