@invarn/cibuild 2.9.6 → 2.9.8

package/dist/src/yaml/steps/ui-fidelity-preview.d.ts

@@ -1,134 +0,0 @@
-/**
- * Local ui-fidelity render preview.
- *
- * Runs the EXACT same render path the runner uses -- the generated
- * `ui-fidelity-render` node script in `package_source: "inputs"` mode (harness
- * synthesis, asset-catalog compile, content trim, reference alignment, dimension
- * reporting) -- but locally, against a SwiftPM package the caller already has on
- * disk. This lets an agent eyeball the wrapper in seconds before dispatching a
- * remote run, so the remote pass becomes a one-shot authoritative render rather
- * than the inner loop of an iterate cycle.
- *
- * It is a faithful mirror, not a re-implementation: the package directory is
- * archived to a temp `package.tar.gz` and fed through the same
- * `generateRenderScript` output, so the target is auto-discovered, the archive
- * is validated, and the produced rendered/aligned images and dimensions match
- * what a remote run would produce on the same toolchain.
- */
-/** One wrapper view to render, paired with the reference image to align to. */
-export interface UiFidelityPreviewScreen {
-    /** Wrapper view type name (e.g. the public, parameterless `XProof`). */
-    screen: string;
-    /** Path to the reference image; copied into the inputs by basename. */
-    reference: string;
-}
-export interface UiFidelityPreviewOptions {
-    /**
-     * Local SwiftPM package directory to render. Archived to a temp
-     * package.tar.gz and rendered in inputs mode. Mutually exclusive with
-     * packageArchive.
-     */
-    packagePath?: string;
-    /**
-     * A prebuilt package.tar.gz to render as-is (preview the exact artifact a
-     * remote run would receive). Mutually exclusive with packagePath.
-     */
-    packageArchive?: string;
-    /** Screens to render, each mapped to a reference image path. */
-    screens: UiFidelityPreviewScreen[];
-    /**
-     * SPM library target to import. Auto-discovered from the shipped manifest
-     * when omitted (the package must declare exactly one library product).
-     */
-    target?: string;
-    /** Render size in device points, "<width>x<height>" (default 393x852). */
-    renderSize?: string;
-    /** Display scale (default 2). */
-    scale?: number | string;
-    /** Directory to receive the artifacts; a temp dir is used when omitted. */
-    outDir?: string;
-    /**
-     * Extra entries prepended to PATH for the render child process, so callers
-     * (and tests) can supply a specific swift/xcrun/tar toolchain. Optional.
-     */
-    toolchainPath?: string;
-}
-export interface UiFidelityPreviewDimensions {
-    rendered_px: [number, number];
-    logical_pt: [number, number];
-    reference_px: [number, number] | null;
-    /**
-     * The PRE-TRIM raster in px -- what the renderer PAINTED before cropping to
-     * content. The gate's frame-fill check reads it to tell a wrapper that never
-     * reached its design frame (a real defect) from one that filled the frame in a
-     * UNIFORM colour, whose own padding the trim then cropped back off (not a
-     * defect). Absent on renders produced before this shipped: absence makes no
-     * statement and the check falls back to the post-trim extent.
-     */
-    source_px?: [number, number];
-}
-export interface UiFidelityPreviewScreenResult {
-    screen: string;
-    /** "rendered" when the screen rendered; otherwise "render_failed". */
-    status: string;
-    error: {
-        code: string;
-        message: string;
-    } | null;
-    /** Absolute path to the (per-screen) reference copy, or null. */
-    referenceImagePath: string | null;
-    /** Absolute path to the trimmed rendered image, or null. */
-    renderedImagePath: string | null;
-    /** Absolute path to the reference-aligned image, or null. */
-    alignedImagePath: string | null;
-    dimensions: UiFidelityPreviewDimensions | null;
-    /**
-     * Advisory warning (never a failure) when the rendered aspect ratio diverges
-     * sharply from the reference's — the early signal that several states were
-     * stacked into one composable. Null when in tolerance or not comparable.
-     */
-    aspectWarning: string | null;
-}
-export interface UiFidelityPreviewResult {
-    /** Always "inputs": the preview mirrors a shipped-package remote run. */
-    packageSource: 'inputs';
-    /** Per-build package error (archive/target validation), or null. */
-    buildError: {
-        code: string;
-        message: string;
-    } | null;
-    /** One entry per requested screen, in request order. */
-    screens: UiFidelityPreviewScreenResult[];
-    /** Absolute path to the artifacts directory holding the images. */
-    artifactsDir: string;
-    /** True only when every screen rendered and there was no build error. */
-    ok: boolean;
-}
-/** Shape of the protocol-result.json the render script writes. */
-/** One screen as the render script writes it into protocol-result.json. */
-export interface RawPreviewScreen {
-    screen: string;
-    status: string;
-    error: {
-        code: string;
-        message: string;
-    } | null;
-    reference_image_path: string | null;
-    rendered_image_path: string | null;
-    aligned_image_path?: string | null;
-    dimensions?: UiFidelityPreviewDimensions | null;
-}
-/**
- * Map one raw render-script screen to a preview result, resolving image paths
- * and attaching the aspect-ratio warning. Shared by the iOS and Android preview
- * engines so the two paths produce identical result shapes and warnings.
- */
-export declare function buildPreviewScreenResult(raw: RawPreviewScreen, artifactsDir: string): UiFidelityPreviewScreenResult;
-/**
- * Render the requested screens locally and return the produced image paths and
- * dimensions. Throws only on caller errors (bad options) or when the render
- * script could not run at all; per-screen and per-build render failures are
- * reported in the returned result (mirroring the remote result document).
- */
-export declare function renderUiFidelityPreview(options: UiFidelityPreviewOptions): UiFidelityPreviewResult;
-//# sourceMappingURL=ui-fidelity-preview.d.ts.map

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

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

package/dist/src/yaml/steps/ui-fidelity-preview.js

@@ -1,173 +0,0 @@
-/**
- * Local ui-fidelity render preview.
- *
- * Runs the EXACT same render path the runner uses -- the generated
- * `ui-fidelity-render` node script in `package_source: "inputs"` mode (harness
- * synthesis, asset-catalog compile, content trim, reference alignment, dimension
- * reporting) -- but locally, against a SwiftPM package the caller already has on
- * disk. This lets an agent eyeball the wrapper in seconds before dispatching a
- * remote run, so the remote pass becomes a one-shot authoritative render rather
- * than the inner loop of an iterate cycle.
- *
- * It is a faithful mirror, not a re-implementation: the package directory is
- * archived to a temp `package.tar.gz` and fed through the same
- * `generateRenderScript` output, so the target is auto-discovered, the archive
- * is validated, and the produced rendered/aligned images and dimensions match
- * what a remote run would produce on the same toolchain.
- */
-import { spawnSync } from 'node:child_process';
-import { copyFileSync, existsSync, mkdirSync, mkdtempSync, readFileSync, statSync, writeFileSync, } from 'node:fs';
-import { tmpdir } from 'node:os';
-import { basename, join, resolve } from 'node:path';
-import { DEFAULT_RENDER_SIZE, DEFAULT_SCALE, generateRenderScript, parseRenderSize, parseScale, } from './ui-fidelity-render.js';
-import { evaluateAspectRatio, formatAspectRatioWarning, } from './fidelity-aspect-guard.js';
-import { resolveCliJsPath } from './render-post-processor.js';
-function runTar(args, pathPrepend) {
-    const env = pathPrepend
-        ? { ...process.env, PATH: pathPrepend + ':' + (process.env.PATH ?? '') }
-        : process.env;
-    const result = spawnSync('tar', args, { encoding: 'utf-8', env, maxBuffer: 64 * 1024 * 1024 });
-    if (result.status !== 0) {
-        const detail = (result.stderr || result.error?.message || '').toString().trim();
-        throw new Error(`failed to archive the package (tar exited ${result.status}): ${detail}`);
-    }
-}
-/** Resolve an artifact-relative path to absolute, or null. */
-function absOrNull(artifactsDir, relative) {
-    return typeof relative === 'string' && relative !== '' ? resolve(artifactsDir, relative) : null;
-}
-/**
- * Map one raw render-script screen to a preview result, resolving image paths
- * and attaching the aspect-ratio warning. Shared by the iOS and Android preview
- * engines so the two paths produce identical result shapes and warnings.
- */
-export function buildPreviewScreenResult(raw, artifactsDir) {
-    const dimensions = raw.dimensions ?? null;
-    const aspect = evaluateAspectRatio(dimensions?.rendered_px ?? null, dimensions?.reference_px ?? null);
-    return {
-        screen: raw.screen,
-        status: raw.status,
-        error: raw.error ?? null,
-        referenceImagePath: absOrNull(artifactsDir, raw.reference_image_path),
-        renderedImagePath: absOrNull(artifactsDir, raw.rendered_image_path),
-        alignedImagePath: absOrNull(artifactsDir, raw.aligned_image_path),
-        dimensions,
-        aspectWarning: formatAspectRatioWarning(raw.screen, aspect),
-    };
-}
-/**
- * Render the requested screens locally and return the produced image paths and
- * dimensions. Throws only on caller errors (bad options) or when the render
- * script could not run at all; per-screen and per-build render failures are
- * reported in the returned result (mirroring the remote result document).
- */
-export function renderUiFidelityPreview(options) {
-    if (!options || typeof options !== 'object') {
-        throw new Error('renderUiFidelityPreview: options are required');
-    }
-    const hasDir = typeof options.packagePath === 'string' && options.packagePath !== '';
-    const hasArchive = typeof options.packageArchive === 'string' && options.packageArchive !== '';
-    if (hasDir === hasArchive) {
-        throw new Error('renderUiFidelityPreview: provide exactly one of packagePath or packageArchive');
-    }
-    if (!Array.isArray(options.screens) || options.screens.length === 0) {
-        throw new Error('renderUiFidelityPreview: at least one screen is required');
-    }
-    const { width, height } = parseRenderSize(options.renderSize ?? DEFAULT_RENDER_SIZE);
-    const scale = parseScale(options.scale ?? DEFAULT_SCALE);
-    const workDir = mkdtempSync(join(tmpdir(), 'ui-fidelity-preview-'));
-    const inputsDir = join(workDir, '.ci', 'inputs');
-    mkdirSync(inputsDir, { recursive: true });
-    // Stage references by basename and build the screens -> basename map, exactly
-    // as a remote caller would pass params.screens.
-    const screensParam = {};
-    for (const entry of options.screens) {
-        if (!entry || typeof entry.screen !== 'string' || entry.screen === '') {
-            throw new Error('renderUiFidelityPreview: each screen needs a non-empty screen name');
-        }
-        if (typeof entry.reference !== 'string' || entry.reference === '') {
-            throw new Error(`renderUiFidelityPreview: screen ${entry.screen} needs a reference path`);
-        }
-        if (!existsSync(entry.reference) || !statSync(entry.reference).isFile()) {
-            throw new Error(`renderUiFidelityPreview: reference for ${entry.screen} not found: ${entry.reference}`);
-        }
-        const base = basename(entry.reference);
-        copyFileSync(entry.reference, join(inputsDir, base));
-        screensParam[entry.screen] = base;
-    }
-    const archivePath = join(inputsDir, 'package.tar.gz');
-    if (hasArchive) {
-        const src = options.packageArchive;
-        if (!existsSync(src) || !statSync(src).isFile()) {
-            throw new Error(`renderUiFidelityPreview: packageArchive not found: ${src}`);
-        }
-        copyFileSync(src, archivePath);
-    }
-    else {
-        const dir = options.packagePath;
-        if (!existsSync(dir) || !statSync(dir).isDirectory()) {
-            throw new Error(`renderUiFidelityPreview: packagePath is not a directory: ${dir}`);
-        }
-        // Archive with Package.swift at the archive root; exclude build/VCS noise so
-        // the upload stays lean and matches what a careful caller would ship.
-        runTar([
-            '--exclude',
-            '.build',
-            '--exclude',
-            '.git',
-            '--exclude',
-            '.DS_Store',
-            '-czf',
-            archivePath,
-            '-C',
-            dir,
-            '.',
-        ], options.toolchainPath);
-    }
-    // The standard params.json the render script reads: screen -> reference basename.
-    writeFileSync(join(inputsDir, 'params.json'), JSON.stringify({ screens: screensParam }, null, 2) + '\n');
-    const artifactsDir = options.outDir ? resolve(options.outDir) : join(workDir, '.ci', 'artifacts');
-    mkdirSync(artifactsDir, { recursive: true });
-    const config = {
-        packagePath: null,
-        target: options.target ?? null,
-        width,
-        height,
-        scale,
-        packageSource: 'inputs',
-    };
-    const script = generateRenderScript(config);
-    const env = {
-        ...process.env,
-        CIBUILD_ARTIFACTS_DIR: artifactsDir,
-    };
-    if (options.toolchainPath) {
-        env.PATH = options.toolchainPath + ':' + (process.env.PATH ?? '');
-    }
-    // Hand the script this installation's CLI entrypoint so its trim stage can
-    // spawn `fidelity-trim` without a ci on PATH (library callers like the
-    // Invarn CLI). Never override an explicitly-set entrypoint.
-    if (!env.CIBUILD_CLI_JS) {
-        const cliJs = resolveCliJsPath();
-        if (cliJs !== null)
-            env.CIBUILD_CLI_JS = cliJs;
-    }
-    const run = spawnSync('node', ['-e', script], {
-        cwd: workDir,
-        env,
-        encoding: 'utf-8',
-        maxBuffer: 32 * 1024 * 1024,
-    });
-    const resultPath = join(artifactsDir, 'protocol-result.json');
-    if (!existsSync(resultPath)) {
-        const detail = ((run.stdout || '') + '\n' + (run.stderr || '')).trim();
-        throw new Error(`renderUiFidelityPreview: render script produced no result document` +
-            (detail ? `:\n${detail}` : ''));
-    }
-    const raw = JSON.parse(readFileSync(resultPath, 'utf-8'));
-    const screens = (raw.screens || []).map((s) => buildPreviewScreenResult(s, artifactsDir));
-    const buildError = raw.error ?? null;
-    const ok = buildError === null && screens.length > 0 && screens.every((s) => s.status === 'rendered');
-    return { packageSource: 'inputs', buildError, screens, artifactsDir, ok };
-}
-//# sourceMappingURL=ui-fidelity-preview.js.map

package/dist/src/yaml/steps/ui-fidelity-preview.test.d.ts

@@ -1,11 +0,0 @@
-/**
- * Tests for the local ui-fidelity render preview engine.
- *
- * Validation and result-shaping run with a PATH-shimmed fake `swift`/`xcrun`
- * (the engine spawns the real generated render script, which spawns the
- * toolchain). The CoreGraphics render itself is covered by an opt-in
- * real-toolchain test, gated on CIBUILD_UI_FIDELITY_REAL_SWIFT, since the fake
- * toolchain cannot exercise the actual pixel render/trim.
- */
-export {};
-//# sourceMappingURL=ui-fidelity-preview.test.d.ts.map

package/dist/src/yaml/steps/ui-fidelity-preview.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"ui-fidelity-preview.test.d.ts","sourceRoot":"","sources":["../../../../src/yaml/steps/ui-fidelity-preview.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG"}

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

@@ -1,210 +0,0 @@
-/**
- * Tests for the local ui-fidelity render preview engine.
- *
- * Validation and result-shaping run with a PATH-shimmed fake `swift`/`xcrun`
- * (the engine spawns the real generated render script, which spawns the
- * toolchain). The CoreGraphics render itself is covered by an opt-in
- * real-toolchain test, gated on CIBUILD_UI_FIDELITY_REAL_SWIFT, since the fake
- * toolchain cannot exercise the actual pixel render/trim.
- */
-import { describe, expect, test, afterAll } from '@jest/globals';
-import { chmodSync, existsSync, mkdtempSync, readFileSync, rmSync, writeFileSync, } from 'node:fs';
-import { tmpdir } from 'node:os';
-import { dirname, join, resolve } from 'node:path';
-import { fileURLToPath } from 'node:url';
-import { renderUiFidelityPreview, buildPreviewScreenResult, } from './ui-fidelity-preview.js';
-const FIXTURE_PACKAGE = resolve(dirname(fileURLToPath(import.meta.url)), '../../../test/fixtures/ui-fidelity-package');
-const PNG_MAGIC = Buffer.from([0x89, 0x50, 0x4e, 0x47, 0x0d, 0x0a, 0x1a, 0x0a]);
-// A real, decodable 1x1 transparent PNG, used as the reference for the
-// real-toolchain test so the aligned step has something to read.
-const ONE_BY_ONE_PNG = Buffer.from('iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAAC0lEQVR42mNkYPhfDwAChwGA60e6kgAAAABJRU5ErkJggg==', 'base64');
-const tempDirs = [];
-afterAll(() => {
-    for (const dir of tempDirs) {
-        try {
-            rmSync(dir, { recursive: true, force: true });
-        }
-        catch {
-            // best effort
-        }
-    }
-});
-function tempDir(prefix) {
-    const dir = mkdtempSync(join(tmpdir(), prefix));
-    tempDirs.push(dir);
-    return dir;
-}
-// Compact fake toolchain: enough of `swift`/`xcrun` for the inputs-mode render
-// script to discover the target, "build", "render" a PNG stub, and "trim" it.
-const FAKE_SWIFT = [
-    '#!/bin/bash',
-    'cmd="$1"; shift',
-    'case "$cmd" in',
-    '  package)',
-    '    printf \'{"name":"shipped","products":[{"name":"FixtureViews","type":{"library":["automatic"]}}]}\\n\'',
-    '    exit 0 ;;',
-    '  build)',
-    '    while [ $# -gt 0 ]; do case "$1" in --show-bin-path) echo "$PWD/.build/debug"; exit 0 ;; *) shift ;; esac; done',
-    '    exit 0 ;;',
-    '  run)',
-    '    pos=()',
-    '    while [ $# -gt 0 ]; do case "$1" in --package-path) shift 2 ;; --skip-build) shift ;; *) pos+=("$1"); shift ;; esac; done',
-    '    out="${pos[1]}"',
-    "    printf '\\x89PNG\\r\\n\\x1a\\n' > \"$out\"; printf 'fake-render' >> \"$out\"",
-    '    exit 0 ;;',
-    '  *) exit 0 ;;',
-    'esac',
-].join('\n');
-const FAKE_XCRUN = ['#!/bin/bash', 'exit 0'].join('\n');
-// Fake `ci` covering the shared trim stage's `ci fidelity-trim` invocation.
-const FAKE_CI = [
-    '#!/bin/bash',
-    'case "$1" in',
-    '  fidelity-trim)',
-    '    out_png="$3"; aligned_png="$4"',
-    "    printf '\\x89PNG\\r\\n\\x1a\\n' > \"$out_png\"; printf 'trimmed' >> \"$out_png\"",
-    '    if [ -n "$aligned_png" ]; then printf \'\\x89PNG\\r\\n\\x1a\\n\' > "$aligned_png"; printf \'aligned\' >> "$aligned_png"; fi',
-    '    echo "TRIMDIMS 320 640 160 320 400 800"',
-    '    exit 0 ;;',
-    '  *) exit 0 ;;',
-    'esac',
-].join('\n');
-function fakeToolchain() {
-    const bin = tempDir('ui-fidelity-fakebin-');
-    const swiftPath = join(bin, 'swift');
-    writeFileSync(swiftPath, FAKE_SWIFT + '\n');
-    chmodSync(swiftPath, 0o755);
-    const xcrunPath = join(bin, 'xcrun');
-    writeFileSync(xcrunPath, FAKE_XCRUN + '\n');
-    chmodSync(xcrunPath, 0o755);
-    const ciPath = join(bin, 'ci');
-    writeFileSync(ciPath, FAKE_CI + '\n');
-    chmodSync(ciPath, 0o755);
-    return bin;
-}
-function writeReference() {
-    const dir = tempDir('ui-fidelity-ref-');
-    const ref = join(dir, 'reference.png');
-    writeFileSync(ref, Buffer.concat([PNG_MAGIC, Buffer.from('ref')]));
-    return ref;
-}
-function isPng(filePath) {
-    return readFileSync(filePath).subarray(0, PNG_MAGIC.length).equals(PNG_MAGIC);
-}
-describe('renderUiFidelityPreview — option validation', () => {
-    test('requires exactly one of packagePath or packageArchive', () => {
-        expect(() => renderUiFidelityPreview({ screens: [] })).toThrow(/exactly one/);
-        expect(() => renderUiFidelityPreview({
-            packagePath: FIXTURE_PACKAGE,
-            packageArchive: '/tmp/x.tar.gz',
-            screens: [{ screen: 'HomeView', reference: writeReference() }],
-        })).toThrow(/exactly one/);
-    });
-    test('requires at least one screen', () => {
-        expect(() => renderUiFidelityPreview({ packagePath: FIXTURE_PACKAGE, screens: [] })).toThrow(/at least one screen/);
-    });
-    test('rejects a missing reference image', () => {
-        expect(() => renderUiFidelityPreview({
-            packagePath: FIXTURE_PACKAGE,
-            screens: [{ screen: 'HomeView', reference: '/no/such/reference.png' }],
-        })).toThrow(/reference for HomeView not found/);
-    });
-});
-describe('buildPreviewScreenResult — aspect-ratio warning wiring', () => {
-    function rawScreen(rendered, reference) {
-        return {
-            screen: 'PromoBanner',
-            status: 'rendered',
-            error: null,
-            reference_image_path: 'references/PromoBanner.png',
-            rendered_image_path: 'rendered/PromoBanner.png',
-            aligned_image_path: 'aligned/PromoBanner.png',
-            dimensions: {
-                rendered_px: rendered,
-                logical_pt: [rendered[0] / 2, rendered[1] / 2],
-                reference_px: reference,
-            },
-        };
-    }
-    test('attaches a warning when a stacked render diverges from its reference', () => {
-        const result = buildPreviewScreenResult(rawScreen([880, 400], [952, 200]), '/tmp/art');
-        expect(result.aspectWarning).toMatch(/divergence/);
-        expect(result.aspectWarning).toContain('PromoBanner');
-    });
-    test('leaves no warning when the render matches the reference aspect ratio', () => {
-        const result = buildPreviewScreenResult(rawScreen([720, 1280], [360, 640]), '/tmp/art');
-        expect(result.aspectWarning).toBeNull();
-    });
-    test('leaves no warning when there is no reference to compare', () => {
-        const result = buildPreviewScreenResult(rawScreen([720, 1280], null), '/tmp/art');
-        expect(result.aspectWarning).toBeNull();
-    });
-});
-describe('renderUiFidelityPreview — fake toolchain', () => {
-    test('archives the package, renders in inputs mode, and returns image paths + dims', () => {
-        const result = renderUiFidelityPreview({
-            packagePath: FIXTURE_PACKAGE,
-            screens: [{ screen: 'HomeView', reference: writeReference() }],
-            toolchainPath: fakeToolchain(),
-        });
-        expect(result.packageSource).toBe('inputs');
-        expect(result.buildError).toBeNull();
-        expect(result.ok).toBe(true);
-        expect(result.screens).toHaveLength(1);
-        const [screen] = result.screens;
-        expect(screen.screen).toBe('HomeView');
-        expect(screen.status).toBe('rendered');
-        expect(screen.error).toBeNull();
-        // Paths are absolute and point at real files the caller can read.
-        expect(screen.renderedImagePath && isPng(screen.renderedImagePath)).toBe(true);
-        expect(screen.alignedImagePath && isPng(screen.alignedImagePath)).toBe(true);
-        expect(screen.referenceImagePath && isPng(screen.referenceImagePath)).toBe(true);
-        expect(screen.dimensions).toEqual({
-            rendered_px: [320, 640],
-            logical_pt: [160, 320],
-            reference_px: [160, 320],
-            // the fake helper's TRIMDIMS pre-trim source px (fields 5-6)
-            source_px: [400, 800],
-        });
-    });
-    test('writes images under the requested outDir', () => {
-        const outDir = tempDir('ui-fidelity-out-');
-        const result = renderUiFidelityPreview({
-            packagePath: FIXTURE_PACKAGE,
-            screens: [{ screen: 'HomeView', reference: writeReference() }],
-            outDir,
-            toolchainPath: fakeToolchain(),
-        });
-        expect(result.artifactsDir).toBe(resolve(outDir));
-        expect(result.screens[0].renderedImagePath?.startsWith(resolve(outDir))).toBe(true);
-        expect(existsSync(join(outDir, 'ui-fidelity', 'rendered', 'HomeView.png'))).toBe(true);
-    });
-});
-// Opt-in: renders the fixture with the real Swift toolchain and asserts the
-// content trim actually crops below the forced device canvas. Requires macOS
-// with Xcode; skipped unless explicitly requested.
-describe('renderUiFidelityPreview — real toolchain', () => {
-    const realTest = process.env.CIBUILD_UI_FIDELITY_REAL_SWIFT === '1' ? test : test.skip;
-    realTest('renders the fixture and trims the filled canvas down to its content', () => {
-        const refDir = tempDir('ui-fidelity-realref-');
-        const reference = join(refDir, 'reference.png');
-        writeFileSync(reference, ONE_BY_ONE_PNG);
-        const result = renderUiFidelityPreview({
-            packagePath: FIXTURE_PACKAGE,
-            screens: [{ screen: 'HomeView', reference }],
-            renderSize: '393x852',
-            scale: 2,
-        });
-        expect(result.ok).toBe(true);
-        const [screen] = result.screens;
-        expect(screen.status).toBe('rendered');
-        expect(screen.renderedImagePath && isPng(screen.renderedImagePath)).toBe(true);
-        // HomeView fills the canvas with a uniform translucent background and a
-        // little text; the content trim must crop well below the 786x1704 (@2x)
-        // device canvas to the text region.
-        const [rw, rh] = screen.dimensions.rendered_px;
-        expect(rw).toBeLessThan(786);
-        expect(rh).toBeLessThan(1704);
-    }, 600_000);
-});
-//# sourceMappingURL=ui-fidelity-preview.test.js.map