@invarn/cibuild 2.2.7 → 2.2.9

package/dist/src/yaml/fidelity-input-digest.d.ts

@@ -0,0 +1,37 @@
+export interface PackageFile {
+    /** POSIX, package-relative path. Part of the digest so a rename is a change. */
+    path: string;
+    /** File contents. */
+    bytes: Buffer;
+}
+/**
+ * Compute the input digest for one render package: its source files plus the
+ * reference image the screen is judged against. Files are folded in sorted by
+ * path so iteration order can't affect the result; each is folded in as its git
+ * blob id (see the module header) so the digest is reproducible from a Git Trees
+ * listing with no blob content. The path is length-prefixed and the blob id is
+ * fixed-width, so boundaries are unambiguous.
+ */
+export declare function sourceDigest(packageFiles: PackageFile[], referenceBytes: Buffer | null): string;
+/**
+ * True when a render package is self-contained — no Gradle script reaches
+ * outside the package root. Render packages are hermetic by construction; this
+ * guard fails a non-hermetic package OUT of the cacheable set (its digest is not
+ * emitted / not trusted for skip) so a change in an external module it depends
+ * on can never replay a stale verdict. Pure: a function of the package files
+ * only, so a dispatch-time caller can apply the identical check.
+ */
+export declare function isHermeticPackage(packageFiles: PackageFile[]): boolean;
+/**
+ * Runtime twin of {@link sourceDigest}, spliced into the self-contained render
+ * script that runs on the macOS runner (which cannot import this module). It
+ * walks the built package directory, reads the paired reference, and computes
+ * the identical digest — a parity test pins it to `sourceDigest` so the twin
+ * cannot drift.
+ *
+ * Exposes `computeSourceDigest(projectRoot, referencePath)`. Build outputs and
+ * VCS/tooling dirs are excluded so they never perturb the content key. Reads
+ * are best-effort: an unreadable reference folds in as "absent", never throws.
+ */
+export declare const RENDER_SCRIPT_SOURCE_DIGEST_STAGE: string;
+//# sourceMappingURL=fidelity-input-digest.d.ts.map

package/dist/src/yaml/fidelity-input-digest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fidelity-input-digest.d.ts","sourceRoot":"","sources":["../../../src/yaml/fidelity-input-digest.ts"],"names":[],"mappings":"AAiCA,MAAM,WAAW,WAAW;IAC1B,gFAAgF;IAChF,IAAI,EAAE,MAAM,CAAC;IACb,qBAAqB;IACrB,KAAK,EAAE,MAAM,CAAC;CACf;AAuBD;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAC1B,YAAY,EAAE,WAAW,EAAE,EAC3B,cAAc,EAAE,MAAM,GAAG,IAAI,GAC5B,MAAM,CAoBR;AAwBD;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,YAAY,EAAE,WAAW,EAAE,GAAG,OAAO,CAOtE;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,iCAAiC,EAAE,MAiF/C,CAAC"}

package/dist/src/yaml/fidelity-input-digest.js

@@ -0,0 +1,208 @@
+/**
+ * Deterministic per-package input digest.
+ *
+ * A content key over a render package's inputs — the committed wrapper source
+ * files plus the paired reference image — so a consumer can tell when a render
+ * would be byte-identical to one already produced and skip re-rendering. Pure:
+ * a function of the input bytes only, never of absolute paths, timestamps, or
+ * commit ids, so the same inputs yield the same digest on any machine or
+ * branch.
+ *
+ * Scope: package-local inputs. Render packages are self-contained by
+ * construction — a parameterless wrapper that reproduces one screen from
+ * hardcoded fixtures, shipped with every dependency version pinned inline and
+ * its own assets vendored — so the package IS its own dependency closure and a
+ * package-local content key already invalidates on anything that can shift the
+ * render. (A package that escapes its own root — an `includeBuild`, an external
+ * `project(":…")` dependency, or a shared version catalog — would break that
+ * property; such a package is not safely cacheable and is caught by a separate
+ * hermeticity guard rather than folded into this digest.)
+ *
+ * Digest basis: each file is folded in as its **git blob id**
+ * (`sha1("blob " + byteLength + "\0" + content)`) rather than its raw bytes.
+ * That is the exact id the GitHub Git Trees API returns for a committed file, so
+ * a caller holding only a tree listing — a webhook dispatch with no checkout —
+ * can reproduce this digest from `(path, blobSha)` pairs WITHOUT fetching any
+ * blob content. The framing is: sha256 over, for each file sorted by path,
+ * `len(path) ‖ path ‖ blobSha(content)`, then the reference folded last as
+ * `blobSha(reference)` (or a presence-distinct `len(0xffffffff)` marker when
+ * there is no reference). `blobSha` is a fixed 20 bytes, so file boundaries stay
+ * unambiguous with only the path length-prefixed.
+ */
+import { createHash } from 'crypto';
+/** 4-byte big-endian length prefix, so concatenated fields can't alias
+ *  (`["ab","c"]` must not hash equal to `["a","bc"]`). */
+function len(n) {
+    const b = Buffer.allocUnsafe(4);
+    b.writeUInt32BE(n >>> 0, 0);
+    return b;
+}
+/**
+ * Git blob object id for a file's content: `sha1("blob " + len + "\0" + bytes)`.
+ * The identical id the GitHub Git Trees API returns for the committed blob, so a
+ * dispatch-time caller can read it from a tree listing instead of hashing bytes
+ * it never fetched. Returned as 20 raw bytes (folded straight into the digest).
+ */
+function gitBlobSha(bytes) {
+    const h = createHash('sha1');
+    h.update(`blob ${bytes.length}\0`);
+    h.update(bytes);
+    return h.digest();
+}
+/**
+ * Compute the input digest for one render package: its source files plus the
+ * reference image the screen is judged against. Files are folded in sorted by
+ * path so iteration order can't affect the result; each is folded in as its git
+ * blob id (see the module header) so the digest is reproducible from a Git Trees
+ * listing with no blob content. The path is length-prefixed and the blob id is
+ * fixed-width, so boundaries are unambiguous.
+ */
+export function sourceDigest(packageFiles, referenceBytes) {
+    const sorted = [...packageFiles].sort((a, b) => a.path < b.path ? -1 : a.path > b.path ? 1 : 0);
+    const h = createHash('sha256');
+    for (const file of sorted) {
+        const pathBytes = Buffer.from(file.path, 'utf8');
+        h.update(len(pathBytes.length));
+        h.update(pathBytes);
+        h.update(gitBlobSha(file.bytes));
+    }
+    // Reference is folded in as its blob id, with a presence-distinct marker so
+    // "no reference" differs from "empty reference".
+    if (referenceBytes === null) {
+        h.update(len(0xffffffff));
+    }
+    else {
+        h.update(gitBlobSha(referenceBytes));
+    }
+    return h.digest('hex');
+}
+/**
+ * A Gradle build script — the only files that can reach outside the package
+ * root (source files and assets can mention `..` in prose without affecting the
+ * build graph).
+ */
+function isGradleScript(path) {
+    return path.endsWith('.gradle') || path.endsWith('.gradle.kts');
+}
+/**
+ * Tokens by which a Gradle script reaches outside its own package root and so
+ * breaks the "package is its own dependency closure" invariant this digest
+ * relies on:
+ *   - `includeBuild` — a composite/included build (another whole build).
+ *   - `projectDir`   — a module relocated to a directory outside the layout.
+ *   - `../`          — any parent-path reference (external file, script, or
+ *                      version catalog).
+ * Biased toward over-detection: a false positive only forces a re-render (safe),
+ * whereas a miss would let a shared external change replay a stale verdict.
+ */
+const GRADLE_ESCAPE = /includeBuild|projectDir|\.\.\//;
+/**
+ * True when a render package is self-contained — no Gradle script reaches
+ * outside the package root. Render packages are hermetic by construction; this
+ * guard fails a non-hermetic package OUT of the cacheable set (its digest is not
+ * emitted / not trusted for skip) so a change in an external module it depends
+ * on can never replay a stale verdict. Pure: a function of the package files
+ * only, so a dispatch-time caller can apply the identical check.
+ */
+export function isHermeticPackage(packageFiles) {
+    for (const file of packageFiles) {
+        if (isGradleScript(file.path) && GRADLE_ESCAPE.test(file.bytes.toString('utf8'))) {
+            return false;
+        }
+    }
+    return true;
+}
+/**
+ * Runtime twin of {@link sourceDigest}, spliced into the self-contained render
+ * script that runs on the macOS runner (which cannot import this module). It
+ * walks the built package directory, reads the paired reference, and computes
+ * the identical digest — a parity test pins it to `sourceDigest` so the twin
+ * cannot drift.
+ *
+ * Exposes `computeSourceDigest(projectRoot, referencePath)`. Build outputs and
+ * VCS/tooling dirs are excluded so they never perturb the content key. Reads
+ * are best-effort: an unreadable reference folds in as "absent", never throws.
+ */
+export const RENDER_SCRIPT_SOURCE_DIGEST_STAGE = String.raw `
+// ---- source-digest stage: deterministic package input content key ----
+function __fidLen(n) {
+  var b = Buffer.allocUnsafe(4);
+  b.writeUInt32BE(n >>> 0, 0);
+  return b;
+}
+var __FID_SKIP_DIRS = { build: 1, '.gradle': 1, '.git': 1, '.idea': 1, 'node_modules': 1, DerivedData: 1 };
+function __fidCollectPackageFiles(root) {
+  var fs = require('fs');
+  var path = require('path');
+  var out = [];
+  function walk(dir, rel) {
+    var names;
+    try { names = fs.readdirSync(dir); } catch (e) { return; }
+    names.sort();
+    for (var i = 0; i < names.length; i++) {
+      var name = names[i];
+      var full = path.join(dir, name);
+      var relPath = rel ? rel + '/' + name : name;
+      var st;
+      try { st = fs.statSync(full); } catch (e) { continue; }
+      if (st.isDirectory()) {
+        if (__FID_SKIP_DIRS[name]) continue;
+        walk(full, relPath);
+      } else if (st.isFile()) {
+        out.push({ path: relPath, bytes: fs.readFileSync(full) });
+      }
+    }
+  }
+  walk(root, '');
+  return out;
+}
+function __fidBlobSha(bytes) {
+  var crypto = require('crypto');
+  var h = crypto.createHash('sha1');
+  h.update('blob ' + bytes.length + '\0');
+  h.update(bytes);
+  return h.digest();
+}
+function __fidSourceDigest(files, referenceBytes) {
+  var crypto = require('crypto');
+  var sorted = files.slice().sort(function (a, b) {
+    return a.path < b.path ? -1 : a.path > b.path ? 1 : 0;
+  });
+  var h = crypto.createHash('sha256');
+  for (var i = 0; i < sorted.length; i++) {
+    var pathBytes = Buffer.from(sorted[i].path, 'utf8');
+    h.update(__fidLen(pathBytes.length));
+    h.update(pathBytes);
+    h.update(__fidBlobSha(sorted[i].bytes));
+  }
+  if (referenceBytes === null || referenceBytes === undefined) {
+    h.update(__fidLen(0xffffffff));
+  } else {
+    h.update(__fidBlobSha(referenceBytes));
+  }
+  return h.digest('hex');
+}
+function computeSourceDigest(projectRoot, referencePath) {
+  var fs = require('fs');
+  var files = __fidCollectPackageFiles(projectRoot);
+  var ref = null;
+  try { if (referencePath) ref = fs.readFileSync(referencePath); } catch (e) { ref = null; }
+  return __fidSourceDigest(files, ref);
+}
+// Twin of isHermeticPackage: a package is cacheable only when no Gradle script
+// reaches outside its own root (includeBuild / projectDir / a parent path).
+var __FID_GRADLE_ESCAPE = /includeBuild|projectDir|\.\.\//;
+function __fidIsGradleScript(p) {
+  return p.slice(-7) === '.gradle' || p.slice(-11) === '.gradle.kts';
+}
+function __fidIsHermetic(files) {
+  for (var i = 0; i < files.length; i++) {
+    if (__fidIsGradleScript(files[i].path) &&
+        __FID_GRADLE_ESCAPE.test(files[i].bytes.toString('utf8'))) {
+      return false;
+    }
+  }
+  return true;
+}
+`;
+//# sourceMappingURL=fidelity-input-digest.js.map

package/dist/src/yaml/fidelity-input-digest.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=fidelity-input-digest.test.d.ts.map

package/dist/src/yaml/fidelity-input-digest.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fidelity-input-digest.test.d.ts","sourceRoot":"","sources":["../../../src/yaml/fidelity-input-digest.test.ts"],"names":[],"mappings":""}

package/dist/src/yaml/fidelity-input-digest.test.js

@@ -0,0 +1,167 @@
+/**
+ * Unit tests for the deterministic per-package input digest.
+ *
+ * The digest is the content key the dashboard matches on to decide whether a
+ * render would be identical to one it already has — so it must be a pure
+ * function of the package's input bytes (wrapper source + reference), stable
+ * across machines/branches, and never derived from paths-as-location, mtimes,
+ * or commit ids.
+ */
+import { describe, test, expect } from '@jest/globals';
+import { createHash } from 'crypto';
+import { createRequire } from 'module';
+import { sourceDigest, isHermeticPackage, RENDER_SCRIPT_SOURCE_DIGEST_STAGE, } from './fidelity-input-digest.js';
+function f(path, content) {
+    return { path, bytes: Buffer.from(content, 'utf8') };
+}
+/** Git blob object id: sha1('blob <len>\0<content>') — the SAME id the GitHub
+ *  Git Trees API returns for a committed file. The digest is defined over these
+ *  ids so a caller with only a tree listing (no blob content) can reproduce it. */
+function gitBlobSha(bytes) {
+    const h = createHash('sha1');
+    h.update(`blob ${bytes.length}\0`);
+    h.update(bytes);
+    return h.digest('hex');
+}
+/** 4-byte big-endian length prefix — mirrors the module-private `len`. */
+function len(n) {
+    const b = Buffer.allocUnsafe(4);
+    b.writeUInt32BE(n >>> 0, 0);
+    return b;
+}
+/** Extract the runner-side twin from the spliced stage source so a parity test
+ *  can pin it to the pure function. `require` is injected because the stage
+ *  runs in the runner's CJS scope, not this ESM test module. */
+const require = createRequire(import.meta.url);
+const twin = new Function('require', RENDER_SCRIPT_SOURCE_DIGEST_STAGE +
+    '\nreturn { __fidSourceDigest: __fidSourceDigest, __fidIsHermetic: __fidIsHermetic };')(require);
+describe('sourceDigest', () => {
+    test('is deterministic: identical inputs produce the same 64-hex digest', () => {
+        const files = [f('Proof.kt', 'fun Proof() {}'), f('build.gradle.kts', 'plugins {}')];
+        const ref = Buffer.from('reference-image-bytes');
+        const first = sourceDigest(files, ref);
+        expect(first).toMatch(/^[0-9a-f]{64}$/);
+        expect(sourceDigest(files, ref)).toBe(first);
+    });
+    test('changes when any package file byte changes', () => {
+        const ref = Buffer.from('ref');
+        const before = sourceDigest([f('Proof.kt', 'fun Proof() {}')], ref);
+        const after = sourceDigest([f('Proof.kt', 'fun Proof() { Box() }')], ref);
+        expect(after).not.toBe(before);
+    });
+    test('changes when only the reference image changes', () => {
+        const files = [f('Proof.kt', 'fun Proof() {}')];
+        const withA = sourceDigest(files, Buffer.from('reference-A'));
+        const withB = sourceDigest(files, Buffer.from('reference-B'));
+        expect(withB).not.toBe(withA);
+    });
+    test('is independent of file iteration order', () => {
+        const ref = Buffer.from('ref');
+        const a = f('a.kt', 'A');
+        const b = f('b.kt', 'B');
+        expect(sourceDigest([a, b], ref)).toBe(sourceDigest([b, a], ref));
+    });
+    test('is unambiguous across file boundaries (path/content cannot alias)', () => {
+        const ref = Buffer.from('ref');
+        // Same concatenated bytes, different split: must not collide.
+        const split = sourceDigest([f('ab', 'x'), f('', 'y')], ref);
+        const joined = sourceDigest([f('a', 'bxy')], ref);
+        expect(split).not.toBe(joined);
+    });
+    test('is reconstructible from git blob shas alone (dashboard tree-API parity)', () => {
+        // The dashboard computes this SAME digest at webhook time from a Git Trees
+        // API listing — which carries each committed file's blob sha but NOT its
+        // content. Pin the exact framing so that reconstruction (path + blob sha,
+        // no bytes) reproduces the digest byte-for-byte.
+        const files = [f('b.kt', 'B'), f('a.kt', 'A')];
+        const ref = Buffer.from('reference-image-bytes');
+        const sorted = [...files].sort((x, y) => (x.path < y.path ? -1 : x.path > y.path ? 1 : 0));
+        const h = createHash('sha256');
+        for (const file of sorted) {
+            const p = Buffer.from(file.path, 'utf8');
+            h.update(len(p.length));
+            h.update(p);
+            h.update(Buffer.from(gitBlobSha(file.bytes), 'hex'));
+        }
+        h.update(Buffer.from(gitBlobSha(ref), 'hex'));
+        expect(sourceDigest(files, ref)).toBe(h.digest('hex'));
+    });
+    test('matches the cross-consumer golden vector (pins the wire format)', () => {
+        // A fixed known-answer vector shared verbatim with the dashboard's
+        // dispatch-time digest, so the two implementations cannot drift apart
+        // silently. If this changes, the dashboard golden must change in lockstep.
+        const files = [f('a.kt', 'A'), f('proof/build.gradle.kts', 'plugins {}')];
+        expect(sourceDigest(files, Buffer.from('ref-bytes'))).toBe('7fc57f481eb011299d34824e0a506345d15e96946e345beac882f26adab47374');
+        expect(sourceDigest(files, null)).toBe('2596ecea7f591c23f9397707a92b008dabedbd1fd4acc0efb2440849e97ddd3c');
+    });
+    test('folds a null reference in with a presence-distinct marker (not a blob sha)', () => {
+        const files = [f('a.kt', 'A')];
+        const sorted = files;
+        const h = createHash('sha256');
+        for (const file of sorted) {
+            const p = Buffer.from(file.path, 'utf8');
+            h.update(len(p.length));
+            h.update(p);
+            h.update(Buffer.from(gitBlobSha(file.bytes), 'hex'));
+        }
+        h.update(len(0xffffffff));
+        expect(sourceDigest(files, null)).toBe(h.digest('hex'));
+    });
+});
+describe('isHermeticPackage', () => {
+    const hermetic = [
+        f('settings.gradle.kts', 'rootProject.name = "p"\ninclude(":proof")\n'),
+        f('build.gradle.kts', 'plugins { id("com.android.library") version "8.13.2" }'),
+        f('proof/build.gradle.kts', 'dependencies { implementation("androidx.compose.ui:ui") }'),
+        f('proof/src/main/kotlin/Proof.kt', 'fun Proof() {}'),
+    ];
+    test('accepts a self-contained package with everything pinned inline', () => {
+        expect(isHermeticPackage(hermetic)).toBe(true);
+    });
+    test('rejects a composite build (includeBuild reaches another build)', () => {
+        const files = [...hermetic, f('settings.gradle.kts', 'includeBuild("../design-system")')];
+        expect(isHermeticPackage(files)).toBe(false);
+    });
+    test('rejects a module relocated outside the root via projectDir', () => {
+        const files = [
+            f('settings.gradle.kts', 'include(":ds")\nproject(":ds").projectDir = file("../ds")'),
+        ];
+        expect(isHermeticPackage(files)).toBe(false);
+    });
+    test('rejects a parent-path escape (external file / version catalog)', () => {
+        const files = [
+            f('settings.gradle.kts', 'versionCatalogs { create("libs") { from(files("../gradle/libs.versions.toml")) } }'),
+        ];
+        expect(isHermeticPackage(files)).toBe(false);
+    });
+    test('ignores escape tokens outside Gradle scripts (only build scripts can escape)', () => {
+        // A source file or asset mentioning "../" is not a build-graph escape.
+        const files = [
+            f('settings.gradle.kts', 'include(":proof")'),
+            f('proof/src/main/kotlin/Doc.kt', '// see ../design-system for the original'),
+        ];
+        expect(isHermeticPackage(files)).toBe(true);
+    });
+});
+describe('runtime twin parity', () => {
+    const files = [f('Proof.kt', 'fun Proof() { Box() }'), f('build.gradle.kts', 'plugins {}')];
+    test('the spliced runner-side digest matches the pure sourceDigest (with reference)', () => {
+        const ref = Buffer.from('reference-image-bytes');
+        expect(twin.__fidSourceDigest(files, ref)).toBe(sourceDigest(files, ref));
+    });
+    test('the spliced runner-side digest matches the pure sourceDigest (no reference)', () => {
+        expect(twin.__fidSourceDigest(files, null)).toBe(sourceDigest(files, null));
+    });
+    test('the spliced runner-side hermeticity check matches isHermeticPackage', () => {
+        const hermetic = [
+            f('settings.gradle.kts', 'include(":proof")'),
+            f('proof/src/main/kotlin/Doc.kt', '// mentions ../elsewhere harmlessly'),
+        ];
+        const escaping = [f('settings.gradle', 'includeBuild("../other")')];
+        expect(twin.__fidIsHermetic(hermetic)).toBe(isHermeticPackage(hermetic));
+        expect(twin.__fidIsHermetic(escaping)).toBe(isHermeticPackage(escaping));
+        expect(twin.__fidIsHermetic(hermetic)).toBe(true);
+        expect(twin.__fidIsHermetic(escaping)).toBe(false);
+    });
+});
+//# sourceMappingURL=fidelity-input-digest.test.js.map

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

@@ -77,7 +77,71 @@ export type StructuralFact = {
         height: number;
     };
     ratio: number;
+} | {
+    /** Composition runs only (design-frame anchor): the captured wrapper
+     *  root's dp size differs from the declared design frame — an authoring
+     *  problem with the wrapper, never a defect of the screen. While this
+     *  fact is present, placement facts are withheld for the State
+     *  (`StructuralBlock.placement`), so a mis-sized root can never
+     *  masquerade as placement drift. */
+    kind: 'frame_mismatch';
+    declared: {
+        w: number;
+        h: number;
+    };
+    captured: {
+        w: number;
+        h: number;
+    };
+    deltas: Array<{
+        dimension: 'w' | 'h';
+        delta: number;
+    }>;
 };
+/** The declared design frame for one screen (design px, treated 1:1 with dp —
+ *  same convention as `ReferenceGeometry`). Composition runs declare one per
+ *  State via `params.reference_frame`; component runs never pass it. */
+export interface ReferenceFrame {
+    w: number;
+    h: number;
+}
+/** One member root whose position on the surface diverges from the design
+ *  frame beyond tolerance (composition runs only): `expected` is the declared
+ *  design x/y (design px, 1:1 dp), `actual` the rendered root-space dp —
+ *  directly comparable because the root is frame-sized (asserted). Only the
+ *  out-of-tolerance dimensions appear in `deltas`. */
+export interface PlacementFact {
+    elementId: string;
+    expected: {
+        x: number;
+        y: number;
+    };
+    actual: {
+        x: number;
+        y: number;
+    };
+    deltas: Array<{
+        dimension: 'x' | 'y';
+        delta: number;
+    }>;
+}
+/** Placement drift at or below this many dp is sub-pixel/rounding noise, not
+ *  a misplacement — same reasoning as the size-delta floor. */
+export declare const DEFAULT_PLACEMENT_TOLERANCE_DP = 2;
+/** Placement-fact gate for one State (composition runs only): present when a
+ *  design frame was declared and asserted against the captured root. When the
+ *  root mis-matches the frame, placement facts are WITHHELD (`withheld: true`,
+ *  with the reason, no `facts`) — the placement deriver must not compute drift
+ *  against a wrongly-sized canvas. When the root matches, `facts` carries the
+ *  tolerance-banded member-root x/y divergences (empty = placement holds). */
+export interface StructuralPlacement {
+    withheld: boolean;
+    reason?: 'frame_mismatch';
+    facts?: PlacementFact[];
+}
+/** Captured-root vs declared-frame tolerance (dp): sub-pixel rounding must not
+ *  read as a mis-sized wrapper root. */
+export declare const DEFAULT_FRAME_TOLERANCE_DP = 1;
 export interface DeriveStructuralFactsOptions {
     /** Edge excesses / overlaps at or below this many px are ignored, so that
      *  exact-touching layout edges don't read as overflow or overlap. */
@@ -192,6 +256,8 @@ export interface StructuralBlock {
     facts: StructuralFact[];
     geometry?: StructuralGeometry;
     appearance?: StructuralAppearance;
+    /** Composition runs only — see `StructuralPlacement`. */
+    placement?: StructuralPlacement;
 }
 /** Which reference the appearance facts were diffed against. `previous_render`
  *  facts are regressions/drift, NOT design divergences (the no-Figma path). */
@@ -381,7 +447,7 @@ export declare function deriveColorFacts(rendered: ColorSource, reference: Color
 export declare function buildStructuralBlock(dump: LayoutDump, referenceGeometry?: ReferenceGeometry | null, density?: number, options?: {
     sizeTolerancePx?: number;
     overhangTolerancePx?: number;
-}, appearanceReference?: AppearanceReference | null): StructuralBlock;
+}, appearanceReference?: AppearanceReference | null, referenceFrame?: ReferenceFrame | null): StructuralBlock;
 export interface ReviewRow {
     element: string;
     rendered: string | null;
@@ -451,7 +517,7 @@ export declare function getGeometryStageInternals(): {
     buildStructuralBlock: (dump: LayoutDump, referenceGeometry?: ReferenceGeometry | null, density?: number, options?: {
         sizeTolerancePx?: number;
         overhangTolerancePx?: number;
-    }, appearanceReference?: AppearanceReference | null) => StructuralBlock;
+    }, appearanceReference?: AppearanceReference | null, referenceFrame?: ReferenceFrame | null) => StructuralBlock;
     buildReviewScaffold: (structural: {
         facts?: StructuralFact[];
         geometry?: StructuralGeometry | null;

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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"}