@invarn/cibuild 2.2.1 → 2.2.3

package/dist/src/yaml/steps/structural-facts.d.ts

@@ -224,9 +224,25 @@ export type AppearanceFact = {
     kind: 'element_extra';
     elementId: string;
 };
+/**
+ * A reference-shaped snapshot of the render's OWN appearance — the element-id
+ * set plus per-element text/colors it produced. Persisted in the structural
+ * block so a later no-Figma render can use it as the `previous_render` baseline
+ * (the colors/text/ids to diff against), mirroring how Signal B's geometry
+ * baseline reuses the previous render's persisted `geometry`. text/color are
+ * present only for the elements that exposed them.
+ */
+export interface AppearanceRendered {
+    elementIds: string[];
+    text?: TextSource;
+    color?: ColorSource;
+}
 export interface StructuralAppearance {
     baseline: AppearanceBaseline;
     facts: AppearanceFact[];
+    /** The render's own appearance, persisted as the baseline source for the next
+     *  no-Figma render. Present whenever Signal C ran. */
+    rendered?: AppearanceRendered;
 }
 /**
  * The reference side of the appearance diff, passed into `buildStructuralBlock`.
@@ -242,7 +258,52 @@ export interface AppearanceReference {
      *  previous render's text on `previous_render`). When supplied, copy facts are
      *  derived against the render's per-node text. Absent → presence facts only. */
     text?: TextSource;
+    /** Reference fill/text color per element id (Figma `fills` on the figma
+     *  baseline; the previous render's colors on `previous_render`). When supplied,
+     *  color facts are derived against the render's per-node colors. */
+    color?: ColorSource;
 }
+/** The per-screen reference params the runner assembles an `AppearanceReference`
+ *  from (the slices of `params.reference_*` for one screen). */
+export interface AppearanceReferenceParams {
+    /** Per-screen `reference_geometry` (design/baseline geometry). Its keys seed
+     *  the element-id set. */
+    refGeom?: ReferenceGeometry | null;
+    /** Per-screen `reference_text` (text per element id). */
+    refText?: TextSource | null;
+    /** Per-screen `reference_color` (fill/text color per element id). */
+    refColor?: ColorSource | null;
+    baseline: AppearanceBaseline;
+}
+/**
+ * Assemble the `AppearanceReference` from a screen's reference params. Issue 05
+ * decouples the appearance container from `reference_geometry`: the reference is
+ * built when ANY of geometry / text / color is present, with `elementIds` = the
+ * UNION of their keys (geometry first, then text, then color — deduped, order
+ * preserved). So a run carrying `reference_color` but no `reference_geometry` now
+ * yields a reference (→ color facts), while a geometry-only run is byte-identical
+ * to before (color/text keys are a subset). `text`/`color` are attached only when
+ * present. No reference of any kind → null (no appearance container).
+ */
+export declare function buildAppearanceReferenceFromParams(params: AppearanceReferenceParams): AppearanceReference | null;
+/**
+ * Map a previous catalog render's persisted appearance snapshot
+ * (`StructuralAppearance.rendered` — element ids + per-element colors) into the
+ * `previous_render` AppearanceReference the next render diffs against. The
+ * no-Figma drift path: the colors/ids the next render compares itself to are the
+ * LAST render's, so a diverging fill surfaces as a regression (drift), marked
+ * `baseline: 'previous_render'`, distinct from a design divergence.
+ *
+ * Pure (no I/O) — the testable core the thin catalog-fetch adapter wraps,
+ * mirroring how the geometry baseline reuses the previous render's persisted
+ * `geometry`. `color` is carried only when the previous render exposed colors;
+ * a previous render with no extractable color yields a presence-only reference
+ * (element ids, no color). A genuinely absent previous render (no snapshot) →
+ * null, so the next render carries no appearance container, exactly as before.
+ * Issue 01 carries the color channels; the previous render's `text` (copy) is a
+ * later slice's concern and is intentionally not mapped here.
+ */
+export declare function appearanceReferenceFromPreviousRender(previous: AppearanceRendered | null | undefined): AppearanceReference | null;
 /**
  * Element-presence facts from the set difference of the rendered element-id set
  * and the reference element-id set, keyed on the stable element id shared with
@@ -275,6 +336,42 @@ export type TextSource = Record<string, string | undefined>;
  * separately-wired concern.
  */
 export declare function deriveCopyFacts(rendered: TextSource, reference: TextSource): AppearanceFact[];
+/** CIELAB triple [L, a, b]. */
+export type Lab = [number, number, number];
+/** One element's rendered/reference colors, by channel. A missing channel is
+ *  "no color signal" for that element/channel — never a divergence. */
+export interface ElementColors {
+    fill?: string;
+    text?: string;
+}
+export type ColorSource = Record<string, ElementColors>;
+/**
+ * Convert an sRGB hex string to CIELAB (D65). White → ~[100,0,0], black → L 0.
+ * Returns [0,0,0] for an unparseable string so a malformed color never throws
+ * (the deriver guards on signal presence separately).
+ */
+export declare function hexToLab(hex: string): Lab;
+/**
+ * CIEDE2000 colour-difference ΔE00 between two CIELAB colours (kL=kC=kH=1).
+ * Implements Sharma, Wu & Dalal (2005); validated against their supplementary
+ * test data. Pure and symmetric; identical colours give 0.
+ */
+export declare function ciede2000(lab1: Lab, lab2: Lab): number;
+/**
+ * Color facts from the per-element, per-channel comparison of rendered vs
+ * reference color, keyed on the stable element id shared with Signal B. For each
+ * element/channel the REFERENCE declares a color for and the render also exposes
+ * one: identical color → no fact; any divergence → a `color` fact carrying the
+ * channel (fill vs text), both hex values, and the CIEDE2000 ΔE as the metric.
+ * Fill and text are distinct channels, so a correct background with a wrong text
+ * color and the reverse are separate facts, never collapsed. A missing rendered
+ * or reference color for a channel is no signal → no fact.
+ *
+ * Pure and platform-agnostic; order-independent and deterministic (output sorted
+ * by element id then channel, fill before text). Measurement only — significance
+ * is a later, separately-wired concern.
+ */
+export declare function deriveColorFacts(rendered: ColorSource, reference: ColorSource): AppearanceFact[];
 /**
  * Assemble the inline `structural` block (ADR-0004): Signal-A facts always, plus
  * the Signal-B geometry block when `referenceGeometry` is supplied. Size (w/h)
@@ -361,5 +458,9 @@ export declare function getGeometryStageInternals(): {
     }) => ReviewScaffold;
     derivePresenceFacts: (renderedIds: Iterable<string>, referenceIds: Iterable<string>) => AppearanceFact[];
     deriveCopyFacts: (rendered: TextSource, reference: TextSource) => AppearanceFact[];
+    deriveColorFacts: (rendered: ColorSource, reference: ColorSource) => AppearanceFact[];
+    buildAppearanceReferenceFromParams: (params: AppearanceReferenceParams) => AppearanceReference | null;
+    ciede2000: (lab1: Lab, lab2: Lab) => number;
+    hexToLab: (hex: string) => Lab;
 };
 //# sourceMappingURL=structural-facts.d.ts.map

package/dist/src/yaml/steps/structural-facts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"structural-facts.d.ts","sourceRoot":"","sources":["../../../../src/yaml/steps/structural-facts.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"structural-facts.d.ts","sourceRoot":"","sources":["../../../../src/yaml/steps/structural-facts.ts"],"names":[],"mappings":"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"}

package/dist/src/yaml/steps/structural-facts.test.js

@@ -8,7 +8,7 @@
  * overflowing voucher tag; the deriver must surface the bottom clip as a
  * fact so it is never again skipped by eye.
  */
-import { deriveStructuralFacts, derivePresenceFacts, deriveCopyFacts, diffKeyGeometry, buildStructuralBlock, buildReviewScaffold, getStructuralFactsStageInternals, getGeometryStageInternals, } from './structural-facts.js';
+import { deriveStructuralFacts, derivePresenceFacts, deriveCopyFacts, deriveColorFacts, ciede2000, hexToLab, diffKeyGeometry, buildStructuralBlock, buildReviewScaffold, appearanceReferenceFromPreviousRender, buildAppearanceReferenceFromParams, getStructuralFactsStageInternals, getGeometryStageInternals, } from './structural-facts.js';
 // 200x400 canvas in px for all fixtures unless noted.
 const CANVAS = { left: 0, top: 0, right: 200, bottom: 400 };
 describe('deriveStructuralFacts — containment', () => {
@@ -518,6 +518,92 @@ describe('derivePresenceFacts — set difference over element ids', () => {
         ]);
     });
 });
+describe('ciede2000 — CIEDE2000 ΔE against the Sharma supplementary test data', () => {
+    // Canonical test vectors from Sharma, Wu & Dalal, "The CIEDE2000 Color-
+    // Difference Formula: Implementation Notes, Supplementary Test Data, and
+    // Mathematical Observations" (2005). Each row: Lab1, Lab2, expected ΔE00.
+    // These exercise the hue-discontinuity and high-chroma edge cases an
+    // incorrect implementation gets wrong.
+    const SHARMA = [
+        [[50, 2.6772, -79.7751], [50, 0, -82.7485], 2.0425],
+        [[50, 3.1571, -77.2803], [50, 0, -82.7485], 2.8615],
+        [[50, 2.8361, -74.02], [50, 0, -82.7485], 3.4412],
+        [[50, -1.3802, -84.2814], [50, 0, -82.7485], 1.0],
+        [[50, -1.1848, -84.8006], [50, 0, -82.7485], 1.0],
+        [[50, 0, 0], [50, -1, 2], 2.3669],
+        [[50, 2.49, -0.001], [50, -2.49, 0.0009], 7.1792],
+        [[50, 2.49, -0.001], [50, -2.49, 0.0011], 7.2195],
+        [[50, -0.001, 2.49], [50, 0.0009, -2.49], 4.8045],
+        [[50, 2.5, 0], [50, 0, -2.5], 4.3065],
+        [[50, 2.5, 0], [73, 25, -18], 27.1492],
+        [[50, 2.5, 0], [50, 3.1736, 0.5854], 1.0],
+        [[60.2574, -34.0099, 36.2677], [60.4626, -34.1751, 39.4387], 1.2644],
+        [[63.0109, -31.0961, -5.8663], [62.8187, -29.7946, -4.0864], 1.263],
+        [[22.7233, 20.0904, -46.694], [23.0331, 14.973, -42.5619], 2.0373],
+        [[90.8027, -2.0831, 1.441], [91.1528, -1.6435, 0.0447], 1.4441],
+        [[2.0776, 0.0795, -1.135], [0.9033, -0.0636, -0.5514], 0.9082],
+    ];
+    for (const [lab1, lab2, expected] of SHARMA) {
+        test(`ΔE(${lab1.join(',')} ; ${lab2.join(',')}) ≈ ${expected}`, () => {
+            expect(ciede2000(lab1, lab2)).toBeCloseTo(expected, 4);
+        });
+    }
+    test('identical colors have ΔE 0 and the metric is symmetric', () => {
+        expect(ciede2000([42, 7, -13], [42, 7, -13])).toBe(0);
+        expect(ciede2000([50, 2.5, 0], [73, 25, -18])).toBeCloseTo(ciede2000([73, 25, -18], [50, 2.5, 0]), 10);
+    });
+});
+describe('hexToLab — sRGB hex → CIELAB (D65)', () => {
+    test('white maps to L≈100, a≈0, b≈0', () => {
+        const [L, a, b] = hexToLab('#ffffff');
+        expect(L).toBeCloseTo(100, 3);
+        expect(a).toBeCloseTo(0, 3);
+        expect(b).toBeCloseTo(0, 3);
+    });
+    test('black maps to L≈0', () => {
+        const [L] = hexToLab('#000000');
+        expect(L).toBeCloseTo(0, 3);
+    });
+    test('accepts hex with or without a leading # and is case-insensitive', () => {
+        expect(hexToLab('FFFFFF')).toEqual(hexToLab('#ffffff'));
+    });
+});
+describe('deriveColorFacts — rendered vs reference color per element/channel', () => {
+    test('matching colors produce no fact', () => {
+        expect(deriveColorFacts({ card: { fill: '#ff0000', text: '#000000' } }, { card: { fill: '#ff0000', text: '#000000' } })).toEqual([]);
+        // case-insensitive match
+        expect(deriveColorFacts({ card: { fill: '#FF0000' } }, { card: { fill: '#ff0000' } })).toEqual([]);
+    });
+    test('a fill divergence yields one fill-channel fact with the correct ΔE', () => {
+        const facts = deriveColorFacts({ card: { fill: '#ff0000' } }, { card: { fill: '#00ff00' } });
+        expect(facts).toHaveLength(1);
+        expect(facts[0]).toMatchObject({ kind: 'color', elementId: 'card', channel: 'fill', rendered: '#ff0000', reference: '#00ff00' });
+        expect(facts[0].deltaE).toBeCloseTo(ciede2000(hexToLab('#ff0000'), hexToLab('#00ff00')), 10);
+    });
+    test('fill and text are distinct channels — a wrong text color does not collapse with a correct fill', () => {
+        const facts = deriveColorFacts({ card: { fill: '#ffffff', text: '#111111' } }, { card: { fill: '#ffffff', text: '#000000' } });
+        expect(facts).toHaveLength(1);
+        expect(facts[0]).toMatchObject({ kind: 'color', elementId: 'card', channel: 'text', rendered: '#111111', reference: '#000000' });
+    });
+    test('both channels diverging yield two facts, fill before text', () => {
+        const facts = deriveColorFacts({ card: { fill: '#ff0000', text: '#111111' } }, { card: { fill: '#00ff00', text: '#000000' } });
+        expect(facts.map((f) => f.channel)).toEqual(['fill', 'text']);
+    });
+    test('an element/channel with no color signal produces no fact', () => {
+        // reference declares a fill the render never exposes → no signal → no fact
+        expect(deriveColorFacts({ card: {} }, { card: { fill: '#ff0000' } })).toEqual([]);
+        // render has a color the reference never declared → no reference signal → no fact
+        expect(deriveColorFacts({ card: { text: '#abcdef' } }, { card: { fill: '#ff0000' } })).toEqual([]);
+        // element absent from the reference entirely → no fact
+        expect(deriveColorFacts({ extra: { fill: '#ff0000' } }, {})).toEqual([]);
+    });
+    test('result is order-independent and deterministic (sorted by element id)', () => {
+        const a = deriveColorFacts({ b: { fill: '#ff0000' }, a: { fill: '#000000' } }, { a: { fill: '#ffffff' }, b: { fill: '#ff0000' } });
+        const b = deriveColorFacts({ a: { fill: '#000000' }, b: { fill: '#ff0000' } }, { b: { fill: '#ff0000' }, a: { fill: '#ffffff' } });
+        expect(a).toEqual(b);
+        expect(a.map((f) => f.elementId)).toEqual(['a']);
+    });
+});
 describe('deriveCopyFacts — rendered vs reference text per element', () => {
     test('identical text produces no fact', () => {
         expect(deriveCopyFacts({ title: '5 EUR off' }, { title: '5 EUR off' })).toEqual([]);
@@ -572,6 +658,7 @@ describe('buildStructuralBlock — appearance container (Signal C, additive)', (
                 { kind: 'element_extra', elementId: 'copy' },
                 { kind: 'element_extra', elementId: 'node-1' },
             ],
+            rendered: { elementIds: ['banner', 'copy', 'node-1', 'voucher'] },
         });
         // Additive: the existing Signal A facts and Signal B geometry are untouched.
         expect(block.facts).toEqual(buildStructuralBlock(HUB_PROMO_DUMP, HUB_PROMO_REFERENCE, 2).facts);
@@ -582,7 +669,11 @@ describe('buildStructuralBlock — appearance container (Signal C, additive)', (
             baseline: 'figma',
             elementIds: ['node-1', 'banner', 'voucher', 'copy'],
         });
-        expect(block.appearance).toEqual({ baseline: 'figma', facts: [] });
+        expect(block.appearance).toEqual({
+            baseline: 'figma',
+            facts: [],
+            rendered: { elementIds: ['banner', 'copy', 'node-1', 'voucher'] },
+        });
     });
     // A dump whose per-node `text` (Signal C render-side enrichment) drives the
     // copy-fact comparison: `title` renders the wrong string, `cta` renders no
@@ -610,6 +701,7 @@ describe('buildStructuralBlock — appearance container (Signal C, additive)', (
                 { kind: 'text_missing', elementId: 'cta', reference: 'Shop now' },
                 { kind: 'text_mismatch', elementId: 'title', rendered: '5 EUR', reference: '5 EUR off' },
             ],
+            rendered: { elementIds: ['cta', 'debugOverlay', 'title'], text: { title: '5 EUR' } },
         });
     });
     test('an appearanceReference without text → presence only (issue-01 behavior unchanged)', () => {
@@ -617,7 +709,245 @@ describe('buildStructuralBlock — appearance container (Signal C, additive)', (
             baseline: 'figma',
             elementIds: ['title', 'cta', 'debugOverlay'],
         });
-        expect(block.appearance).toEqual({ baseline: 'figma', facts: [] });
+        expect(block.appearance).toEqual({
+            baseline: 'figma',
+            facts: [],
+            rendered: { elementIds: ['cta', 'debugOverlay', 'title'], text: { title: '5 EUR' } },
+        });
+    });
+    // A dump whose per-node fill/text colors (Signal C render-side enrichment)
+    // drive the color-fact comparison: `card` renders the wrong fill, correct text.
+    const COLOR_DUMP = {
+        canvas: { left: 0, top: 0, right: 200, bottom: 400 },
+        nodes: [
+            { id: 'card', bounds: { left: 0, top: 0, right: 100, bottom: 40 }, parentId: null, clipsChildren: false, fillColor: '#ff0000', textColor: '#000000' },
+        ],
+    };
+    test('with reference color → color facts are appended after presence/copy facts', () => {
+        const block = buildStructuralBlock(COLOR_DUMP, null, 2, undefined, {
+            baseline: 'figma',
+            elementIds: ['card'],
+            color: { card: { fill: '#00ff00', text: '#000000' } },
+        });
+        expect(block.appearance?.baseline).toBe('figma');
+        expect(block.appearance?.facts).toEqual([
+            {
+                kind: 'color',
+                elementId: 'card',
+                channel: 'fill',
+                rendered: '#ff0000',
+                reference: '#00ff00',
+                deltaE: ciede2000(hexToLab('#ff0000'), hexToLab('#00ff00')),
+            },
+        ]);
+    });
+    test('an appearanceReference without color → no color facts (presence only)', () => {
+        const block = buildStructuralBlock(COLOR_DUMP, null, 2, undefined, {
+            baseline: 'figma',
+            elementIds: ['card'],
+        });
+        expect(block.appearance).toEqual({
+            baseline: 'figma',
+            facts: [],
+            rendered: { elementIds: ['card'], color: { card: { fill: '#ff0000', text: '#000000' } } },
+        });
+    });
+    // ---- Signal C no-Figma baseline (issue 04) ----
+    test('the appearance container persists a rendered snapshot (the baseline source for the next render)', () => {
+        // The snapshot captures THIS render's own element ids + text + colors so a
+        // later no-Figma render can diff against it. Text/color are present only for
+        // the nodes that expose them.
+        const block = buildStructuralBlock(COPY_DUMP, null, 2, undefined, {
+            baseline: 'figma',
+            elementIds: ['title', 'cta'],
+        });
+        expect(block.appearance?.rendered).toEqual({
+            elementIds: ['cta', 'debugOverlay', 'title'],
+            text: { title: '5 EUR' },
+        });
+    });
+    test('a previous_render baseline marks the facts as regressions (drift), derivers unchanged', () => {
+        // The same derivers run; only the reference source + baseline marking differ.
+        // Reference here is the *previous render*'s ids/text/color.
+        const block = buildStructuralBlock(COLOR_DUMP, null, 2, undefined, {
+            baseline: 'previous_render',
+            elementIds: ['card'],
+            color: { card: { fill: '#00ff00' } },
+        });
+        expect(block.appearance?.baseline).toBe('previous_render');
+        expect(block.appearance?.facts).toEqual([
+            {
+                kind: 'color',
+                elementId: 'card',
+                channel: 'fill',
+                rendered: '#ff0000',
+                reference: '#00ff00',
+                deltaE: ciede2000(hexToLab('#ff0000'), hexToLab('#00ff00')),
+            },
+        ]);
+    });
+    test('a previous_render baseline diffs presence against the previous element-id set', () => {
+        // COLOR_DUMP renders only `card`; the previous render had `card` + `legacyBadge`.
+        const block = buildStructuralBlock(COLOR_DUMP, null, 2, undefined, {
+            baseline: 'previous_render',
+            elementIds: ['card', 'legacyBadge'],
+        });
+        expect(block.appearance).toMatchObject({
+            baseline: 'previous_render',
+            facts: [{ kind: 'element_missing', elementId: 'legacyBadge' }],
+        });
+    });
+    test('no appearanceReference (neither Figma nor previous render) → no container, no rendered snapshot', () => {
+        const block = buildStructuralBlock(COLOR_DUMP, null, 2);
+        expect(block.appearance).toBeUndefined();
+    });
+});
+// ---- Signal C: previous-render → AppearanceReference mapper (issue 01) ----
+//
+// The no-Figma drift path: a previous catalog render persisted its own
+// appearance snapshot (`appearance.rendered`: element ids + per-element colors).
+// This pure mapper turns that snapshot into the `previous_render`
+// AppearanceReference the next render diffs against — the colors/ids to compare,
+// marked as drift (regression vs the last render), not a design divergence. It is
+// the testable core the thin catalog-fetch adapter wraps; no I/O here.
+describe('appearanceReferenceFromPreviousRender — previous render snapshot → reference', () => {
+    test('a previous render with per-element fill colors → a previous_render reference carrying color + ids', () => {
+        const previous = {
+            elementIds: ['banner', 'voucher'],
+            color: { banner: { fill: '#fff0ee' } },
+        };
+        expect(appearanceReferenceFromPreviousRender(previous)).toEqual({
+            baseline: 'previous_render',
+            elementIds: ['banner', 'voucher'],
+            color: { banner: { fill: '#fff0ee' } },
+        });
+    });
+    test('a previous render with no extractable color → a presence-only reference (ids, no color)', () => {
+        const previous = { elementIds: ['banner', 'voucher'] };
+        expect(appearanceReferenceFromPreviousRender(previous)).toEqual({
+            baseline: 'previous_render',
+            elementIds: ['banner', 'voucher'],
+        });
+    });
+    test('an empty color map is treated as no color signal (presence-only)', () => {
+        const previous = { elementIds: ['banner'], color: {} };
+        expect(appearanceReferenceFromPreviousRender(previous)).toEqual({
+            baseline: 'previous_render',
+            elementIds: ['banner'],
+        });
+    });
+    test('a genuinely absent previous render → null (no appearance container downstream)', () => {
+        expect(appearanceReferenceFromPreviousRender(null)).toBeNull();
+        expect(appearanceReferenceFromPreviousRender(undefined)).toBeNull();
+        expect(appearanceReferenceFromPreviousRender({})).toBeNull();
+    });
+    test('fed into buildStructuralBlock, a drifted fill produces a previous_render color fact (the tracer)', () => {
+        // The render now paints the banner the wrong fill (#1e88e5); the previous
+        // render painted #fff0ee. The mapper turns that previous snapshot into the
+        // drift reference, and the assembled block carries one fill color fact with a
+        // large positive ΔE — exactly the blue-banner divergence, proven through the
+        // public interface (the e2e proves the same on a real render).
+        const driftedDump = {
+            canvas: { left: 0, top: 0, right: 686, bottom: 282 },
+            nodes: [
+                { id: 'banner', bounds: { left: 0, top: 0, right: 686, bottom: 282 }, parentId: null, clipsChildren: false, fillColor: '#1e88e5' },
+            ],
+        };
+        const previous = { elementIds: ['banner'], color: { banner: { fill: '#fff0ee' } } };
+        const reference = appearanceReferenceFromPreviousRender(previous);
+        const block = buildStructuralBlock(driftedDump, null, 2, undefined, reference);
+        expect(block.appearance?.baseline).toBe('previous_render');
+        const colorFacts = (block.appearance?.facts ?? []).filter((f) => f.kind === 'color');
+        expect(colorFacts).toEqual([
+            {
+                kind: 'color',
+                elementId: 'banner',
+                channel: 'fill',
+                rendered: '#1e88e5',
+                reference: '#fff0ee',
+                deltaE: ciede2000(hexToLab('#1e88e5'), hexToLab('#fff0ee')),
+            },
+        ]);
+        expect(colorFacts[0].kind === 'color' && colorFacts[0].deltaE).toBeGreaterThan(10);
+    });
+});
+// ---- Signal C: build the appearance reference from run params (issue 05) ----
+//
+// The runner builds the appearanceReference from the per-screen reference_geometry
+// / reference_text / reference_color params. Issue 05 decouples the container from
+// reference_geometry: it is assembled when ANY of the three is present, with
+// elementIds = the UNION of their keys, so a run with reference_color but no
+// reference_geometry still emits color facts.
+describe('buildAppearanceReferenceFromParams — union of geometry/text/color ids', () => {
+    test('color only (no geometry) → a reference carrying color, ids from the color keys', () => {
+        const ref = buildAppearanceReferenceFromParams({
+            refColor: { banner: { fill: '#fff0ee' } },
+            baseline: 'previous_render',
+        });
+        expect(ref).toEqual({
+            baseline: 'previous_render',
+            elementIds: ['banner'],
+            color: { banner: { fill: '#fff0ee' } },
+        });
+    });
+    test('geometry only → ids from the geometry keys, no text/color attached', () => {
+        const ref = buildAppearanceReferenceFromParams({
+            refGeom: { banner: { w: 343, h: 96 }, voucher: { w: 81, h: 81 } },
+            baseline: 'figma',
+        });
+        expect(ref).toEqual({ baseline: 'figma', elementIds: ['banner', 'voucher'] });
+    });
+    test('geometry + color (color ids ⊆ geometry ids) → ids unchanged (additive, no regression)', () => {
+        const ref = buildAppearanceReferenceFromParams({
+            refGeom: { banner: { w: 343, h: 96 }, voucher: { w: 81, h: 81 } },
+            refColor: { banner: { fill: '#fff0ee' } },
+            baseline: 'figma',
+        });
+        expect(ref).toEqual({
+            baseline: 'figma',
+            elementIds: ['banner', 'voucher'],
+            color: { banner: { fill: '#fff0ee' } },
+        });
+    });
+    test('text + color, no geometry → union ids, both attached', () => {
+        const ref = buildAppearanceReferenceFromParams({
+            refText: { copy: 'Get 5 € off' },
+            refColor: { banner: { fill: '#fff0ee' } },
+            baseline: 'previous_render',
+        });
+        expect(ref).toEqual({
+            baseline: 'previous_render',
+            elementIds: ['copy', 'banner'],
+            text: { copy: 'Get 5 € off' },
+            color: { banner: { fill: '#fff0ee' } },
+        });
+    });
+    test('none present → null (no appearance container)', () => {
+        expect(buildAppearanceReferenceFromParams({ baseline: 'figma' })).toBeNull();
+        expect(buildAppearanceReferenceFromParams({ baseline: 'figma', refGeom: {}, refColor: {}, refText: {} })).toBeNull();
+    });
+    test('fed into buildStructuralBlock, a color-only reference still emits the color fact', () => {
+        const dump = {
+            canvas: { left: 0, top: 0, right: 686, bottom: 282 },
+            nodes: [
+                { id: 'banner', bounds: { left: 0, top: 0, right: 686, bottom: 282 }, parentId: null, clipsChildren: false, fillColor: '#1e88e5' },
+            ],
+        };
+        const ref = buildAppearanceReferenceFromParams({
+            refColor: { banner: { fill: '#fff0ee' } },
+            baseline: 'previous_render',
+        });
+        const block = buildStructuralBlock(dump, null, 2, undefined, ref);
+        expect(block.appearance?.facts).toEqual([
+            {
+                kind: 'color',
+                elementId: 'banner',
+                channel: 'fill',
+                rendered: '#1e88e5',
+                reference: '#fff0ee',
+                deltaE: ciede2000(hexToLab('#1e88e5'), hexToLab('#fff0ee')),
+            },
+        ]);
     });
 });
 describe('embedded geometry stage parity', () => {
@@ -676,6 +1006,59 @@ describe('embedded geometry stage parity', () => {
         };
         expect(embedded.buildStructuralBlock(dumpWithText, null, 2, undefined, appearanceReference)).toEqual(buildStructuralBlock(dumpWithText, null, 2, undefined, appearanceReference));
     });
+    test('embedded ciede2000 + hexToLab match the module (Signal C)', () => {
+        const labCases = [
+            [[50, 2.6772, -79.7751], [50, 0, -82.7485]],
+            [[50, 2.5, 0], [73, 25, -18]],
+            [[60.2574, -34.0099, 36.2677], [60.4626, -34.1751, 39.4387]],
+        ];
+        for (const [a, b] of labCases) {
+            expect(embedded.ciede2000(a, b)).toBeCloseTo(ciede2000(a, b), 12);
+        }
+        for (const hex of ['#ffffff', '#000000', '#ff0000', '#3a7bd5', 'abcdef']) {
+            expect(embedded.hexToLab(hex)).toEqual(hexToLab(hex));
+        }
+    });
+    test('embedded buildAppearanceReferenceFromParams matches the module (Signal C, issue 05)', () => {
+        const cases = [
+            { refColor: { banner: { fill: '#fff0ee' } }, baseline: 'previous_render' },
+            { refGeom: { banner: { w: 343, h: 96 }, voucher: { w: 81, h: 81 } }, baseline: 'figma' },
+            { refGeom: { banner: { w: 343 } }, refColor: { banner: { fill: '#fff0ee' } }, baseline: 'figma' },
+            { refText: { copy: 'Get 5 € off' }, refColor: { banner: { fill: '#fff0ee' } }, baseline: 'previous_render' },
+            { refGeom: { banner: { w: 1 } }, refText: { copy: 'x' }, refColor: { logo: { fill: '#000000' } }, baseline: 'figma' },
+            { baseline: 'figma' },
+            { refGeom: {}, refText: {}, refColor: {}, baseline: 'figma' },
+        ];
+        for (const c of cases) {
+            expect(embedded.buildAppearanceReferenceFromParams(c)).toEqual(buildAppearanceReferenceFromParams(c));
+        }
+    });
+    test('embedded deriveColorFacts matches the module (Signal C)', () => {
+        const cases = [
+            [{ card: { fill: '#ff0000' } }, { card: { fill: '#ff0000' } }],
+            [{ card: { fill: '#ff0000' } }, { card: { fill: '#00ff00' } }],
+            [{ card: { fill: '#ffffff', text: '#111111' } }, { card: { fill: '#ffffff', text: '#000000' } }],
+            [{ card: {} }, { card: { fill: '#ff0000' } }],
+            [{ extra: { fill: '#ff0000' } }, {}],
+        ];
+        for (const [rendered, reference] of cases) {
+            expect(embedded.deriveColorFacts(rendered, reference)).toEqual(deriveColorFacts(rendered, reference));
+        }
+    });
+    test('embedded buildStructuralBlock matches the module with an appearanceReference carrying color', () => {
+        const dumpWithColor = {
+            canvas: { left: 0, top: 0, right: 200, bottom: 400 },
+            nodes: [
+                { id: 'card', bounds: { left: 0, top: 0, right: 100, bottom: 40 }, parentId: null, clipsChildren: false, fillColor: '#ff0000', textColor: '#000000' },
+            ],
+        };
+        const appearanceReference = {
+            baseline: 'figma',
+            elementIds: ['card'],
+            color: { card: { fill: '#00ff00', text: '#000000' } },
+        };
+        expect(embedded.buildStructuralBlock(dumpWithColor, null, 2, undefined, appearanceReference)).toEqual(buildStructuralBlock(dumpWithColor, null, 2, undefined, appearanceReference));
+    });
     const parityCases = [
         { name: 'factsOnly', dump: HUB_PROMO_DUMP, ref: null },
         { name: 'withGeometry', dump: HUB_PROMO_DUMP, ref: HUB_PROMO_REFERENCE },

package/dist/src/yaml/steps/ui-fidelity-render-android.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ui-fidelity-render-android.d.ts","sourceRoot":"","sources":["../../../../src/yaml/steps/ui-fidelity-render-android.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgDG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AACxD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAKpE,sDAAsD;AACtD,MAAM,WAAW,6BAA6B;IAC5C;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACxB;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;GAGG;AACH,eAAO,MAAM,mBAAmB,yBAAyB,CAAC;AAE1D,gFAAgF;AAChF,eAAO,MAAM,wBAAwB,mBAAmB,CAAC;AAEzD,4DAA4D;AAC5D,eAAO,MAAM,gBAAgB,0BAA0B,CAAC;AAExD;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEvD;AAED,8EAA8E;AAC9E,MAAM,WAAW,yBAAyB;IACxC,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;CACpB;AA0wBD;;;GAGG;AACH,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,yBAAyB,GAAG,MAAM,CAYrF;AAED;;;GAGG;AACH,qBAAa,mCAAoC,SAAQ,gBAAgB;IACvE,yBAAyB,CACvB,OAAO,EAAE,6BAA6B,EACtC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC5B,OAAO,EAAE,QAAQ,GAChB,qBAAqB,EAAE;IAepB,OAAO,CACX,MAAM,EAAE,6BAA6B,EACrC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC5B,OAAO,EAAE,QAAQ,GAChB,OAAO,CAAC,OAAO,CAAC;CAgBpB"}
+{"version":3,"file":"ui-fidelity-render-android.d.ts","sourceRoot":"","sources":["../../../../src/yaml/steps/ui-fidelity-render-android.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgDG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AACxD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAKpE,sDAAsD;AACtD,MAAM,WAAW,6BAA6B;IAC5C;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACxB;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;GAGG;AACH,eAAO,MAAM,mBAAmB,yBAAyB,CAAC;AAE1D,gFAAgF;AAChF,eAAO,MAAM,wBAAwB,mBAAmB,CAAC;AAEzD,4DAA4D;AAC5D,eAAO,MAAM,gBAAgB,0BAA0B,CAAC;AAExD;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEvD;AAED,8EAA8E;AAC9E,MAAM,WAAW,yBAAyB;IACxC,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;CACpB;AA8xBD;;;GAGG;AACH,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,yBAAyB,GAAG,MAAM,CAYrF;AAED;;;GAGG;AACH,qBAAa,mCAAoC,SAAQ,gBAAgB;IACvE,yBAAyB,CACvB,OAAO,EAAE,6BAA6B,EACtC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC5B,OAAO,EAAE,QAAQ,GAChB,qBAAqB,EAAE;IAepB,OAAO,CACX,MAAM,EAAE,6BAA6B,EACrC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC5B,OAAO,EAAE,QAAQ,GAChB,OAAO,CAAC,OAAO,CAAC;CAgBpB"}