@invarn/cibuild 2.2.0 → 2.2.2

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`.
@@ -238,6 +254,14 @@ export interface StructuralAppearance {
 export interface AppearanceReference {
     baseline: AppearanceBaseline;
     elementIds: string[];
+    /** Reference text per element id (Figma `characters` on the figma baseline; the
+     *  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;
 }
 /**
  * Element-presence facts from the set difference of the rendered element-id set
@@ -252,6 +276,61 @@ export interface AppearanceReference {
  * separately-wired concern.
  */
 export declare function derivePresenceFacts(renderedIds: Iterable<string>, referenceIds: Iterable<string>): AppearanceFact[];
+/** Per-element text content, keyed on the stable element id (rendered text from
+ *  the layout dump's per-node `text`; reference text from the Figma node tree's
+ *  `characters`). A missing or empty string means "no text signal for that
+ *  element," which the deriver treats as absence, never a divergence. */
+export type TextSource = Record<string, string | undefined>;
+/**
+ * Copy/text facts from the per-element comparison of rendered text vs reference
+ * text, keyed on the stable element id shared with Signal B. For each element the
+ * REFERENCE declares text for: identical text → no fact; a different rendered
+ * string → `text_mismatch` (both strings attached); empty/absent rendered text →
+ * `text_missing`. An element with no reference text signal produces no fact —
+ * absence of a signal is never reported as a divergence, so a rendered string the
+ * reference never declared is silent.
+ *
+ * Pure and platform-agnostic; order-independent and deterministic (output sorted
+ * by element id). The deriver reports facts only; significance is a later,
+ * 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)
@@ -337,5 +416,9 @@ export declare function getGeometryStageInternals(): {
         geometry?: StructuralGeometry | null;
     }) => ReviewScaffold;
     derivePresenceFacts: (renderedIds: Iterable<string>, referenceIds: Iterable<string>) => AppearanceFact[];
+    deriveCopyFacts: (rendered: TextSource, reference: TextSource) => AppearanceFact[];
+    deriveColorFacts: (rendered: ColorSource, reference: ColorSource) => AppearanceFact[];
+    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, diffKeyGeometry, buildStructuralBlock, buildReviewScaffold, getStructuralFactsStageInternals, getGeometryStageInternals, } from './structural-facts.js';
+import { deriveStructuralFacts, derivePresenceFacts, deriveCopyFacts, deriveColorFacts, ciede2000, hexToLab, diffKeyGeometry, buildStructuralBlock, buildReviewScaffold, 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,125 @@ 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([]);
+    });
+    test('differing text yields text_mismatch with both strings', () => {
+        expect(deriveCopyFacts({ title: '5 EUR' }, { title: '5 EUR off' })).toEqual([{ kind: 'text_mismatch', elementId: 'title', rendered: '5 EUR', reference: '5 EUR off' }]);
+    });
+    test('reference text with empty/absent render yields text_missing', () => {
+        // absent render entry
+        expect(deriveCopyFacts({}, { cta: 'Shop now' })).toEqual([
+            { kind: 'text_missing', elementId: 'cta', reference: 'Shop now' },
+        ]);
+        // empty-string render entry counts as no rendered text
+        expect(deriveCopyFacts({ cta: '' }, { cta: 'Shop now' })).toEqual([
+            { kind: 'text_missing', elementId: 'cta', reference: 'Shop now' },
+        ]);
+    });
+    test('an element with no reference text produces no fact (absence of signal is not a divergence)', () => {
+        // render has text the reference never declared → no fact (no reference signal)
+        expect(deriveCopyFacts({ debugLabel: 'x' }, {})).toEqual([]);
+        // reference declares an empty string → no signal → no fact regardless of render
+        expect(deriveCopyFacts({ note: 'hi' }, { note: '' })).toEqual([]);
+    });
+    test('result is order-independent and deterministic (sorted by element id)', () => {
+        const a = deriveCopyFacts({ b: 'r', a: 'wrong' }, { a: 'right', b: 'r', c: 'gone' });
+        const b = deriveCopyFacts({ a: 'wrong', b: 'r' }, { c: 'gone', b: 'r', a: 'right' });
+        expect(a).toEqual(b);
+        expect(a).toEqual([
+            { kind: 'text_mismatch', elementId: 'a', rendered: 'wrong', reference: 'right' },
+            { kind: 'text_missing', elementId: 'c', reference: 'gone' },
+        ]);
+    });
+});
 describe('buildStructuralBlock — appearance container (Signal C, additive)', () => {
     test('no appearanceReference → no appearance container; facts + geometry unchanged', () => {
         const withC = buildStructuralBlock(HUB_PROMO_DUMP, HUB_PROMO_REFERENCE, 2);
@@ -539,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);
@@ -549,7 +669,137 @@ 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
+    // text, and `debugOverlay` is an extra element absent from the reference.
+    const COPY_DUMP = {
+        canvas: { left: 0, top: 0, right: 200, bottom: 400 },
+        nodes: [
+            { id: 'title', bounds: { left: 0, top: 0, right: 100, bottom: 20 }, parentId: null, clipsChildren: false, text: '5 EUR' },
+            { id: 'cta', bounds: { left: 0, top: 30, right: 100, bottom: 50 }, parentId: null, clipsChildren: false },
+            { id: 'debugOverlay', bounds: { left: 0, top: 60, right: 100, bottom: 80 }, parentId: null, clipsChildren: false },
+        ],
+    };
+    test('with reference text → copy facts are appended after presence facts', () => {
+        const block = buildStructuralBlock(COPY_DUMP, null, 2, undefined, {
+            baseline: 'figma',
+            elementIds: ['title', 'cta'],
+            text: { title: '5 EUR off', cta: 'Shop now' },
+        });
+        expect(block.appearance).toEqual({
+            baseline: 'figma',
+            facts: [
+                // presence first (debugOverlay is rendered but not in the reference)
+                { kind: 'element_extra', elementId: 'debugOverlay' },
+                // then copy (sorted by id: cta missing, title mismatched)
+                { 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)', () => {
+        const block = buildStructuralBlock(COPY_DUMP, null, 2, undefined, {
+            baseline: 'figma',
+            elementIds: ['title', 'cta', 'debugOverlay'],
+        });
+        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();
     });
 });
 describe('embedded geometry stage parity', () => {
@@ -579,6 +829,74 @@ describe('embedded geometry stage parity', () => {
         const appearanceReference = { baseline: 'figma', elementIds: ['banner', 'voucher'] };
         expect(embedded.buildStructuralBlock(HUB_PROMO_DUMP, HUB_PROMO_REFERENCE, 2, undefined, appearanceReference)).toEqual(buildStructuralBlock(HUB_PROMO_DUMP, HUB_PROMO_REFERENCE, 2, undefined, appearanceReference));
     });
+    test('embedded deriveCopyFacts matches the module (Signal C)', () => {
+        const cases = [
+            [{ title: 'a' }, { title: 'a' }],
+            [{ title: 'a' }, { title: 'b' }],
+            [{}, { cta: 'Shop now' }],
+            [{ cta: '' }, { cta: 'Shop now' }],
+            [{ debugLabel: 'x' }, {}],
+            [{ note: 'hi' }, { note: '' }],
+            [{ b: 'r', a: 'wrong' }, { a: 'right', b: 'r', c: 'gone' }],
+        ];
+        for (const [rendered, reference] of cases) {
+            expect(embedded.deriveCopyFacts(rendered, reference)).toEqual(deriveCopyFacts(rendered, reference));
+        }
+    });
+    test('embedded buildStructuralBlock matches the module with an appearanceReference carrying text', () => {
+        const dumpWithText = {
+            canvas: { left: 0, top: 0, right: 200, bottom: 400 },
+            nodes: [
+                { id: 'title', bounds: { left: 0, top: 0, right: 100, bottom: 20 }, parentId: null, clipsChildren: false, text: '5 EUR' },
+                { id: 'cta', bounds: { left: 0, top: 30, right: 100, bottom: 50 }, parentId: null, clipsChildren: false },
+            ],
+        };
+        const appearanceReference = {
+            baseline: 'figma',
+            elementIds: ['title', 'cta'],
+            text: { title: '5 EUR off', cta: 'Shop now' },
+        };
+        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 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;AA8vBD;;;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"}

package/dist/src/yaml/steps/ui-fidelity-render-android.js

@@ -95,6 +95,18 @@ var buildError = null;
 // read by the structural assembler. Null when the run declared none → Signal B
 // is skipped and the structural block carries facts only.
 var referenceGeometry = null;
+// params.reference_text (Signal C: Figma characters per element id per screen),
+// set in main() and read by the structural assembler. Null when none declared →
+// the appearance container carries presence facts only (no copy facts).
+var referenceText = null;
+// params.reference_color (Signal C: Figma fills per element id per screen, as
+// { fill, text } hex), set in main() and read by the structural assembler. Null
+// when none declared → no color facts.
+var referenceColor = null;
+// params.reference_baseline (Signal C: 'figma' (default) or 'previous_render').
+// Marks whether the appearance reference is the design (divergences) or the
+// previous catalog render (regressions/drift, the no-Figma path).
+var referenceBaseline = null;
 
 function log(message) {
   console.log('[ui-fidelity-render-android] ' + message);
@@ -607,7 +619,7 @@ function renderScreens(renderable, projectRoot) {
         // geometry deltas vs reference_geometry) onto the screen entry, so the
         // judge reads the signals from protocol-result.json without fetching
         // artifacts. CONFIG.scale is the render density (dp = px / scale).
-        assembleStructural(entry, layoutSource, referenceGeometry, CONFIG.scale);
+        assembleStructural(entry, layoutSource, referenceGeometry, CONFIG.scale, referenceText, referenceColor, referenceBaseline);
       }
     });
   } finally {
@@ -673,6 +685,26 @@ function main() {
     !Array.isArray(params.reference_geometry)
       ? params.reference_geometry
       : null;
+  // Signal-C copy reference: { "<Screen>": { "<elementId>": "<text>" } } — the
+  // Figma characters mapped to element ids. Absent → presence facts only.
+  referenceText =
+    params.reference_text &&
+    typeof params.reference_text === 'object' &&
+    !Array.isArray(params.reference_text)
+      ? params.reference_text
+      : null;
+  // Signal-C color reference: { "<Screen>": { "<elementId>": { fill, text } } } —
+  // the Figma fills mapped to element ids. Absent → no color facts.
+  referenceColor =
+    params.reference_color &&
+    typeof params.reference_color === 'object' &&
+    !Array.isArray(params.reference_color)
+      ? params.reference_color
+      : null;
+  // Signal-C baseline marker: 'previous_render' when the appearance reference was
+  // sourced from the previous catalog render (no-Figma drift path), else 'figma'.
+  referenceBaseline =
+    params.reference_baseline === 'previous_render' ? 'previous_render' : 'figma';
 
   var screens = Object.keys(params.screens);
   currentEntries = screens.map(function (screen) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@invarn/cibuild",
-  "version": "2.2.0",
+  "version": "2.2.2",
   "description": "CI Build CLI — local pipeline orchestration and validation",
   "type": "module",
   "main": "dist/cli.cjs",