@invarn/cibuild 2.4.6 → 2.4.7

package/dist/src/commands/fidelity-trim.test.js

@@ -49,7 +49,7 @@ describe('handleFidelityTrimCommand', () => {
             const status = handleFidelityTrimCommand([input, out]);
             expect(status).toBe(0);
             const printed = stdout.mock.calls.map((c) => String(c[0])).join('');
-            expect(printed).toBe('TRIMDIMS 30 40 0 0 100 80\n');
+            expect(printed).toBe('TRIMDIMS 30 40 0 0 100 80 10 20\n');
             expect(stderr).not.toHaveBeenCalled();
         }
         finally {

package/dist/src/yaml/steps/render-post-processor.d.ts

@@ -42,11 +42,14 @@
 export declare const RENDER_SCRIPT_TRIM_STAGE: string;
 /** A rendered/reference/source dimension pair in pixels, as TRIMDIMS reports. */
 export type TrimDimsPair = [number, number];
-/** Parsed TRIMDIMS line: rendered (trimmed) / reference / pre-trim source px. */
+/** Parsed TRIMDIMS line: rendered (trimmed) / reference / pre-trim source px,
+ *  plus the crop origin within the source — null when the helper predates it
+ *  (unknown, never assumed zero). */
 export interface TrimDims {
     rendered: TrimDimsPair;
     reference: TrimDimsPair;
     source: TrimDimsPair;
+    offset: TrimDimsPair | null;
 }
 /** How the stage will spawn the fidelity-trim helper. */
 export interface TrimHelperInvocation {

package/dist/src/yaml/steps/render-post-processor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"render-post-processor.d.ts","sourceRoot":"","sources":["../../../../src/yaml/steps/render-post-processor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAMH;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,wBAAwB,EAAE,MA+JtC,CAAC;AAEF,iFAAiF;AACjF,MAAM,MAAM,YAAY,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAE5C,iFAAiF;AACjF,MAAM,WAAW,QAAQ;IACvB,QAAQ,EAAE,YAAY,CAAC;IACvB,SAAS,EAAE,YAAY,CAAC;IACxB,MAAM,EAAE,YAAY,CAAC;CACtB;AAED,yDAAyD;AACzD,MAAM,WAAW,oBAAoB;IACnC,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,sBAAsB;IACrC,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI,CAAC;IAC/C,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;IAChC,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,oBAAoB,CAAC;IAC3D,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG;QAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;CAC1F;AAED;;;;;;;;GAQG;AACH,wBAAgB,yBAAyB,CAAC,SAAS,CAAC,EAAE;IACpD,EAAE,CAAC,EAAE,OAAO,CAAC;IACb,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,EAAE,CAAC,EAAE,OAAO,CAAC;IACb,EAAE,CAAC,EAAE,OAAO,CAAC;IACb,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB,GAAG,sBAAsB,CAkBzB;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,GAAG,IAAI,CAqBhD"}
+{"version":3,"file":"render-post-processor.d.ts","sourceRoot":"","sources":["../../../../src/yaml/steps/render-post-processor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAMH;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,wBAAwB,EAAE,MAkLtC,CAAC;AAEF,iFAAiF;AACjF,MAAM,MAAM,YAAY,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAE5C;;qCAEqC;AACrC,MAAM,WAAW,QAAQ;IACvB,QAAQ,EAAE,YAAY,CAAC;IACvB,SAAS,EAAE,YAAY,CAAC;IACxB,MAAM,EAAE,YAAY,CAAC;IACrB,MAAM,EAAE,YAAY,GAAG,IAAI,CAAC;CAC7B;AAED,yDAAyD;AACzD,MAAM,WAAW,oBAAoB;IACnC,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,sBAAsB;IACrC,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI,CAAC;IAC/C,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;IAChC,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,oBAAoB,CAAC;IAC3D,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG;QAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;CAC1F;AAED;;;;;;;;GAQG;AACH,wBAAgB,yBAAyB,CAAC,SAAS,CAAC,EAAE;IACpD,EAAE,CAAC,EAAE,OAAO,CAAC;IACb,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,EAAE,CAAC,EAAE,OAAO,CAAC;IACb,EAAE,CAAC,EAAE,OAAO,CAAC;IACb,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB,GAAG,sBAAsB,CAkBzB;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,GAAG,IAAI,CAqBhD"}

package/dist/src/yaml/steps/render-post-processor.js

@@ -49,8 +49,10 @@ function roundTwo(value) {
   return Math.round(value * 100) / 100;
 }
 
-// Parse the helper's "TRIMDIMS <rW> <rH> <refW> <refH> <srcW> <srcH>" line
-// (rendered/reference/source px; last one wins).
+// Parse the helper's "TRIMDIMS <rW> <rH> <refW> <refH> <srcW> <srcH>
+// [<offX> <offY>]" line (rendered/reference/source px + the crop origin;
+// last one wins). The origin is null on a 6-number line — an old helper may
+// well have trimmed something, so an absent origin means UNKNOWN, never zero.
 function parseTrimDims(stdout) {
   var lines = String(stdout || '').split('\n');
   for (var i = lines.length - 1; i >= 0; i--) {
@@ -61,10 +63,19 @@ function parseTrimDims(stdout) {
         Number(parts[4]), Number(parts[5]), Number(parts[6]),
       ];
       if (nums.every(function (n) { return Number.isFinite(n); })) {
+        var offset = null;
+        if (parts.length >= 9) {
+          var offX = Number(parts[7]);
+          var offY = Number(parts[8]);
+          if (Number.isFinite(offX) && Number.isFinite(offY)) {
+            offset = [offX, offY];
+          }
+        }
         return {
           rendered: [nums[0], nums[1]],
           reference: [nums[2], nums[3]],
           source: [nums[4], nums[5]],
+          offset: offset,
         };
       }
     }
@@ -189,6 +200,14 @@ function trimRenderedImage(entry, renderedPath) {
       // before and after the fix).
       source_px: dims.source,
     };
+    // The crop origin, when the helper reported one: where the trimmed image
+    // sits inside the source raster. The dashboard subtracts it to place the
+    // layout dump's window-space geometry on the trimmed bytes; omitted (not
+    // null) when unknown, so a pre-offset helper's dimensions keep their old
+    // shape exactly.
+    if (dims.offset !== null) {
+      entry.dimensions.trim_offset_px = dims.offset;
+    }
     // Surface how much margin was removed -- a no-op (source == rendered) means
     // the view fills an opaque canvas with no transparent or uniform margin.
     log(

package/dist/src/yaml/steps/render-post-processor.test.js

@@ -18,8 +18,25 @@ describe('dimension reporting (TRIMDIMS parsing)', () => {
             rendered: [320, 640],
             reference: [160, 320],
             source: [400, 800],
+            // A 6-number line is the pre-offset helper — the origin is unknown, not
+            // zero: an old binary may well have trimmed something.
+            offset: null,
         });
     });
+    test('parses the crop origin from an 8-number TRIMDIMS line', () => {
+        const dims = parseTrimDims('TRIMDIMS 320 640 160 320 400 800 40 77\n');
+        expect(dims).toEqual({
+            rendered: [320, 640],
+            reference: [160, 320],
+            source: [400, 800],
+            offset: [40, 77],
+        });
+    });
+    test('a non-numeric origin degrades to offset null, never to garbage', () => {
+        const dims = parseTrimDims('TRIMDIMS 320 640 160 320 400 800 x y\n');
+        expect(dims?.offset).toBeNull();
+        expect(dims?.rendered).toEqual([320, 640]);
+    });
     test('returns null when no TRIMDIMS line is present', () => {
         expect(parseTrimDims('rendered HomeView\nsome other log line\n')).toBeNull();
         expect(parseTrimDims('')).toBeNull();
@@ -35,6 +52,7 @@ describe('dimension reporting (TRIMDIMS parsing)', () => {
             rendered: [320, 640],
             reference: [160, 320],
             source: [400, 800],
+            offset: null,
         });
     });
     test('returns null for a truncated or non-numeric TRIMDIMS line', () => {

package/dist/src/yaml/steps/trim-align.d.ts

@@ -78,8 +78,10 @@ export interface TrimAlignResult {
  * The helper entry point, argv-compatible with the retired Swift helper:
  * `[in.png, out.png]` or `[in.png, out.png, aligned.png, reference.png]`.
  * Crops the input to its content bounding box, optionally writes a
- * reference-sized aligned copy (best-effort), and reports a TRIMDIMS line.
- * Same exit codes, same stdout/stderr shape as the Swift helper.
+ * reference-sized aligned copy (best-effort), and reports a TRIMDIMS line
+ * (`TRIMDIMS <rW> <rH> <refW> <refH> <srcW> <srcH> <offX> <offY>` — the crop
+ * origin appended 2026-08-01, older consumers ignore it). Same exit codes,
+ * same stdout/stderr shape as the Swift helper.
  */
 export declare function runTrimAlign(argv: string[]): TrimAlignResult;
 //# sourceMappingURL=trim-align.d.ts.map

package/dist/src/yaml/steps/trim-align.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"trim-align.d.ts","sourceRoot":"","sources":["../../../../src/yaml/steps/trim-align.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAGH,OAAO,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC;AAE5B,0DAA0D;AAC1D,MAAM,WAAW,UAAU;IACzB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,+CAA+C;AAC/C,eAAO,MAAM,eAAe,KAAK,CAAC;AAClC,eAAO,MAAM,oBAAoB,KAAK,CAAC;AACvC,eAAO,MAAM,oBAAoB,KAAK,CAAC;AACvC,eAAO,MAAM,sBAAsB,KAAK,CAAC;AA0BzC;;;;;;;;;;;;;GAaG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,MAAM,GAAG,UAAU,EACzB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,GACb,UAAU,GAAG,IAAI,CAkGnB;AAED,+EAA+E;AAC/E,wBAAgB,SAAS,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,UAAU,GAAG,GAAG,CAOxD;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,MAAM,CAAC,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,GAAG,GAAG,IAAI,CAyE1E;AAED,uEAAuE;AACvE,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,eAAe,CA6E5D"}
+{"version":3,"file":"trim-align.d.ts","sourceRoot":"","sources":["../../../../src/yaml/steps/trim-align.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAGH,OAAO,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC;AAE5B,0DAA0D;AAC1D,MAAM,WAAW,UAAU;IACzB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,+CAA+C;AAC/C,eAAO,MAAM,eAAe,KAAK,CAAC;AAClC,eAAO,MAAM,oBAAoB,KAAK,CAAC;AACvC,eAAO,MAAM,oBAAoB,KAAK,CAAC;AACvC,eAAO,MAAM,sBAAsB,KAAK,CAAC;AA0BzC;;;;;;;;;;;;;GAaG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,MAAM,GAAG,UAAU,EACzB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,GACb,UAAU,GAAG,IAAI,CAkGnB;AAED,+EAA+E;AAC/E,wBAAgB,SAAS,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,UAAU,GAAG,GAAG,CAOxD;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,MAAM,CAAC,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,GAAG,GAAG,IAAI,CAyE1E;AAED,uEAAuE;AACvE,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,eAAe,CA8F5D"}

package/dist/src/yaml/steps/trim-align.js

@@ -266,8 +266,10 @@ export function fitPad(src, width, height) {
  * The helper entry point, argv-compatible with the retired Swift helper:
  * `[in.png, out.png]` or `[in.png, out.png, aligned.png, reference.png]`.
  * Crops the input to its content bounding box, optionally writes a
- * reference-sized aligned copy (best-effort), and reports a TRIMDIMS line.
- * Same exit codes, same stdout/stderr shape as the Swift helper.
+ * reference-sized aligned copy (best-effort), and reports a TRIMDIMS line
+ * (`TRIMDIMS <rW> <rH> <refW> <refH> <srcW> <srcH> <offX> <offY>` — the crop
+ * origin appended 2026-08-01, older consumers ignore it). Same exit codes,
+ * same stdout/stderr shape as the Swift helper.
  */
 export function runTrimAlign(argv) {
     if (argv.length < 2) {
@@ -338,10 +340,27 @@ export function runTrimAlign(argv) {
             }
         }
     }
-    // Report: rendered (trimmed) px, reference px (0 0 when unavailable), then
-    // the pre-trim source px so the caller can log how much margin was removed.
+    // Report: rendered (trimmed) px, reference px (0 0 when unavailable), the
+    // pre-trim source px (how much margin was removed), then the CROP ORIGIN —
+    // where the trimmed image's top-left sits inside the source. The origin is
+    // what lets a consumer place source-coordinate geometry (the layout dump's
+    // window-space bounds) onto the trimmed bytes; without it every finding
+    // spotlight drew shifted by exactly this offset on the first padded
+    // wrappers (the 2026-08-01 diagnosis). Appended, never inserted: TRIMDIMS
+    // parsers require >= 7 fields and ignore extras, so an old parser reading a
+    // new line (and a new parser reading an old 6-number line) both degrade
+    // safely to "origin unknown".
     const stdout = 'TRIMDIMS ' +
-        [box.width, box.height, referenceWidth, referenceHeight, image.width, image.height].join(' ') +
+        [
+            box.width,
+            box.height,
+            referenceWidth,
+            referenceHeight,
+            image.width,
+            image.height,
+            box.x,
+            box.y,
+        ].join(' ') +
         '\n';
     return { status: 0, stdout, stderr: '' };
 }

package/dist/src/yaml/steps/trim-align.test.js

@@ -72,8 +72,11 @@ describe('runTrimAlign — trim', () => {
         // The crop is a raw pixel copy of the content region.
         expect(pixelAt(out, 0, 0)).toEqual([255, 0, 0, 255]);
         expect(pixelAt(out, 59, 39)).toEqual([255, 0, 0, 255]);
-        // TRIMDIMS: rendered (trimmed) px, reference px (0 0 without one), source px.
-        expect(result.stdout.trim()).toBe('TRIMDIMS 60 40 0 0 200 200');
+        // TRIMDIMS: rendered (trimmed) px, reference px (0 0 without one), source
+        // px, then the crop origin — where the trimmed image sits in the source.
+        // The origin is what lets a consumer place source-coordinate geometry on
+        // the trimmed bytes (the 2026-08-01 spotlight diagnosis).
+        expect(result.stdout.trim()).toBe('TRIMDIMS 60 40 0 0 200 200 30 50');
     });
     test('crops an opaque uniform-background wrapper to its content card', () => {
         const dir = scene();
@@ -115,7 +118,7 @@ describe('runTrimAlign — trim', () => {
         // content — the opaque box (the whole image) is kept, exit 0.
         expect(result.status).toBe(0);
         expect(pngSize(out)).toEqual({ width: 64, height: 48 });
-        expect(result.stdout.trim()).toBe('TRIMDIMS 64 48 0 0 64 48');
+        expect(result.stdout.trim()).toBe('TRIMDIMS 64 48 0 0 64 48 0 0');
     });
     test('is a no-op crop when content touches every edge', () => {
         const dir = scene();
@@ -150,7 +153,7 @@ describe('runTrimAlign — aligned output', () => {
         // reference-sized canvas (preserving aspect) for a 1:1 overlay.
         expect(pngSize(out)).toEqual({ width: 60, height: 40 });
         expect(pngSize(aligned)).toEqual({ width: 100, height: 50 });
-        expect(result.stdout.trim()).toBe('TRIMDIMS 60 40 100 50 200 200');
+        expect(result.stdout.trim()).toBe('TRIMDIMS 60 40 100 50 200 200 30 50');
     });
     test('fits a wide render into a square reference without distortion (transparent letterbox)', () => {
         const dir = scene();
@@ -222,7 +225,7 @@ describe('runTrimAlign — aligned output', () => {
         const result = runTrimAlign([input, out, aligned, join(dir, 'nope.png')]);
         expect(result.status).toBe(0);
         expect(existsSync(aligned)).toBe(false);
-        expect(result.stdout.trim()).toBe('TRIMDIMS 50 30 0 0 100 100');
+        expect(result.stdout.trim()).toBe('TRIMDIMS 50 30 0 0 100 100 10 10');
     });
 });
 // ---- failure contract ------------------------------------------------------------

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

@@ -73,7 +73,7 @@ const FAKE_CI_LINES = [
     "      printf '\\x89PNG\\r\\n\\x1a\\n' > \"$aligned_png\"",
     '      printf \'aligned:%s\' "$(basename "$in_png")" >> "$aligned_png"',
     '    fi',
-    '    echo "TRIMDIMS 320 640 160 320 400 800"',
+    '    echo "TRIMDIMS 320 640 160 320 400 800 40 77"',
     '    exit 0 ;;',
     '  *) exit 0 ;;',
     'esac',
@@ -328,6 +328,10 @@ describe('android render runtime — render + trim (happy path)', () => {
             reference_px: [160, 320],
             // the fake helper's TRIMDIMS pre-trim source px (fields 5-6)
             source_px: [400, 800],
+            // …and the crop origin (fields 7-8): where the trimmed image sits in the
+            // source, so geometry captured in window coordinates can be placed on
+            // the trimmed bytes (the 2026-08-01 spotlight diagnosis).
+            trim_offset_px: [40, 77],
         });
         expect(isPng(artifact(project, 'ui-fidelity/rendered/XProof.png'))).toBe(true);
         expect(isPng(artifact(project, 'ui-fidelity/aligned/XProof.png'))).toBe(true);

package/package.json

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