@flighthq/tool-capture 0.2.0 → 0.2.1-next.423.3350e53

package/dist/functionalVerify.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"functionalVerify.d.ts","sourceRoot":"","sources":["../src/functionalVerify.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EACV,iBAAiB,EACjB,aAAa,EACb,cAAc,EACd,aAAa,EACb,OAAO,EACP,eAAe,EAChB,MAAM,iBAAiB,CAAC;AAEzB,eAAO,MAAM,iCAAiC,oBAAoB,CAAC;AAMnE,MAAM,MAAM,sBAAsB,GAAG,CAAC,OAAO,EAAE,QAAQ,CAAC,OAAO,CAAC,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAE1F,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,QAAQ,CAAC;IACf,KAAK,EAAE,iBAAiB,CAAC;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,IAAI,EAAE,aAAa,GAAG,IAAI,CAAC;CACnC;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,KAAK,CAAC;IACZ,KAAK,EAAE,cAAc,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,IAAI,EAAE,aAAa,GAAG,IAAI,CAAC;CACnC;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,OAAO,CAAC;IACd,KAAK,EAAE,aAAa,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,IAAI,EAAE,aAAa,GAAG,IAAI,CAAC;CACnC;AAED,MAAM,WAAW,oBAAoB;IACnC,YAAY,CAAC,EAAE,sBAAsB,CAAC;IACtC,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAED,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,QAAQ,CAAC;IACf,KAAK,EAAE,eAAe,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,IAAI,EAAE,aAAa,GAAG,IAAI,CAAC;CACnC;AAED,MAAM,MAAM,gBAAgB,GAAG,sBAAsB,GAAG,mBAAmB,GAAG,kBAAkB,GAAG,oBAAoB,CAAC;AAgBxH,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAenE;AAED,wBAAgB,wBAAwB,CAAC,CAAC,SAAS,gBAAgB,EAAE,MAAM,EAAE,CAAC,GAAG,CAAC,CAGjF;AAED,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,eAAe,EAAE,KAAK,SAAI,GAAG,IAAI,CAUpF;AAED,wBAAsB,qBAAqB,CAAC,UAAU,EAAE,oBAAoB,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA+B3G;AAED,wBAAsB,wBAAwB,IAAI,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAQxE"}

package/dist/functionalVerify.js

@@ -0,0 +1,140 @@
+import { createSurfaceFromWgpuRenderState, enableWgpuFrameCapture } from '@flighthq/render-wgpu';
+import { createSurface, createSurfaceFingerprint, createSurfaceFromImageSource, formatSurfaceFingerprint, getSurfaceCoverage, getSurfacePixel, } from '@flighthq/surface';
+export const FUNCTIONAL_VERIFICATION_IMAGE_KEY = '__ftRenderImage';
+const DEFAULT_MIN_COVERAGE = 0.0008;
+const BACKGROUND_CHANNEL_TOLERANCE = 6;
+const FINGERPRINT_GRID = 16;
+// Synchronously reads the registered webgl target's default framebuffer and publishes it for the capture
+// harness (sets __ftVerification + __ftRenderImage). Unlike runRenderVerification it does NOT wait for a
+// presented frame — so it MUST be called in the same task as the draw (right after presentGlScene in an
+// animation frame), while the drawing buffer is still valid. This is what lets an animated app read back
+// without preserveDrawingBuffer:true (which a wait-then-read would need, and which breaks on-screen
+// animation on some drivers). Returns true once a non-blank frame was published; the caller stops calling
+// it then, and retries on the next frame while it returns false.
+export function publishFunctionalRenderSync(render) {
+    const target = window.__ftTarget;
+    if (target?.kind !== 'webgl')
+        return false;
+    const surface = createSurfaceFromGlRenderState(target.state);
+    if (surface === null)
+        return false;
+    const background = getSurfacePixel(surface, 0, 0);
+    const coverage = getSurfaceCoverage(surface, background, BACKGROUND_CHANNEL_TOLERANCE);
+    if (coverage < DEFAULT_MIN_COVERAGE)
+        return false;
+    window.__ftVerification = {
+        render,
+        coverage,
+        fingerprint: formatSurfaceFingerprint(createSurfaceFingerprint(surface, FINGERPRINT_GRID)),
+    };
+    window.__ftRenderImage = encodeSurfaceToDataUrl(surface);
+    return true;
+}
+export function registerFunctionalTarget(target) {
+    window.__ftTarget = target;
+    return target;
+}
+export function registerWgpuFunctionalTarget(state, scale = 1) {
+    enableWgpuFrameCapture(state);
+    registerFunctionalTarget({
+        kind: 'webgpu',
+        state,
+        width: state.canvas.width,
+        height: state.canvas.height,
+        scale,
+        render: () => { },
+    });
+}
+export async function runRenderVerification(testModule, render) {
+    const result = { render, coverage: null, fingerprint: null };
+    window.__ftVerification = result;
+    if (render === 'dom') {
+        const target = window.__ftTarget;
+        if (target?.kind === 'dom') {
+            const element = target.state.element;
+            const hasContent = element.childElementCount > 0 || (element.textContent ?? '').trim() !== '';
+            if (!hasContent)
+                throw new Error(`[verify:${render}] blank render: no DOM output produced`);
+        }
+        return;
+    }
+    await waitForPresentedFrame();
+    const surface = await snapshotFunctionalRender();
+    if (surface === null)
+        return;
+    const background = getSurfacePixel(surface, 0, 0);
+    const coverage = getSurfaceCoverage(surface, background, BACKGROUND_CHANNEL_TOLERANCE);
+    result.coverage = coverage;
+    result.fingerprint = formatSurfaceFingerprint(createSurfaceFingerprint(surface, FINGERPRINT_GRID));
+    const minCoverage = testModule.minCoverage ?? DEFAULT_MIN_COVERAGE;
+    if (coverage < minCoverage) {
+        throw new Error(`[verify:${render}] blank render: coverage ${coverage.toFixed(5)} below ${minCoverage}`);
+    }
+    await testModule.assertRender?.(surface);
+    window.__ftRenderImage = encodeSurfaceToDataUrl(getFunctionalRenderImageSurface() ?? surface);
+}
+export async function snapshotFunctionalRender() {
+    const target = window.__ftTarget;
+    if (target?.kind === 'dom')
+        return null;
+    if (target?.kind === 'webgpu')
+        return createSurfaceFromWgpuRenderState(target.state);
+    const canvas = target ? target.state.canvas : findRenderCanvas();
+    if (canvas === null || canvas.width === 0 || canvas.height === 0)
+        return null;
+    if (target?.kind === 'webgl')
+        target.state.gl.finish();
+    return createSurfaceFromImageSource(canvas, canvas.width, canvas.height);
+}
+function getFunctionalRenderImageSurface() {
+    const target = window.__ftTarget;
+    if (target?.kind !== 'webgl')
+        return null;
+    return createSurfaceFromGlRenderState(target.state);
+}
+function createSurfaceFromGlRenderState(state) {
+    const canvas = state.canvas;
+    const width = canvas.width;
+    const height = canvas.height;
+    if (width === 0 || height === 0)
+        return null;
+    const gl = state.gl;
+    gl.finish();
+    gl.bindFramebuffer(gl.FRAMEBUFFER, null);
+    const bottomUp = new Uint8Array(width * height * 4);
+    gl.readPixels(0, 0, width, height, gl.RGBA, gl.UNSIGNED_BYTE, bottomUp);
+    const surface = createSurface(width, height);
+    const out = surface.data;
+    const rowBytes = width * 4;
+    for (let y = 0; y < height; y++) {
+        const srcRow = (height - 1 - y) * rowBytes;
+        const dstRow = y * rowBytes;
+        out.set(bottomUp.subarray(srcRow, srcRow + rowBytes), dstRow);
+    }
+    return surface;
+}
+function encodeSurfaceToDataUrl(surface) {
+    const canvas = document.createElement('canvas');
+    canvas.width = surface.width;
+    canvas.height = surface.height;
+    const ctx = canvas.getContext('2d');
+    if (ctx === null)
+        return '';
+    ctx.putImageData(new ImageData(new Uint8ClampedArray(surface.data), surface.width, surface.height), 0, 0);
+    return canvas.toDataURL('image/png');
+}
+function findRenderCanvas() {
+    let best = null;
+    for (const canvas of document.querySelectorAll('canvas')) {
+        if (best === null || canvas.width * canvas.height > best.width * best.height)
+            best = canvas;
+    }
+    return best;
+}
+function waitForPresentedFrame() {
+    const raf = window.__ftRealRequestAnimationFrame ?? window.requestAnimationFrame.bind(window);
+    return new Promise((resolve) => {
+        raf(() => raf(() => resolve()));
+    });
+}
+//# sourceMappingURL=functionalVerify.js.map

package/dist/functionalVerify.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"functionalVerify.js","sourceRoot":"","sources":["../src/functionalVerify.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -7,4 +7,6 @@ export * from './captureInterrupt';
 export * from './captureRenderTarget';
 export * from './captureServer';
 export * from './functionalScenes';
+export * from './functionalVerify';
+export * from './referenceCapture';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC;AACtC,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC;AACtC,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC"}

package/dist/index.js

@@ -7,4 +7,6 @@ export * from './captureInterrupt';
 export * from './captureRenderTarget';
 export * from './captureServer';
 export * from './functionalScenes';
+export * from './functionalVerify';
+export * from './referenceCapture';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC;AACtC,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC;AACtC,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC"}

package/dist/referenceCapture.d.ts

@@ -0,0 +1,31 @@
+import type { Entry } from './captureEntries.js';
+export interface ReferenceCaptureOptions {
+    /** The flight-reference checkout root (contains content/frameworks/…). */
+    checkoutDir: string;
+    /** The Flight monorepo root, passed to the dev server as FLIGHT_REPO so @flighthq/* resolve to source. */
+    repoRoot: string;
+    /** Only capture cases whose `framework/corpus/case` id contains this substring. */
+    filter?: string;
+    captureFrames?: number;
+    extraWait?: number;
+    updateBaseline?: boolean;
+    failOnError?: boolean;
+    /** Eyes mode: never fail closed on a blank render — emit a screenshot + diagnostics per case. */
+    observe?: boolean;
+    /** Output base; artifacts land at {outBase}/reference/{framework/corpus/case}/{renderer}/. */
+    outBase: string;
+    workerCount?: number;
+}
+export interface ReferenceCaptureResult {
+    captured: number;
+    changed: number;
+    failed: number;
+    aborted: boolean;
+}
+export declare function discoverReferenceEntries(checkoutDir: string): Entry[];
+export declare function runReferenceCapture(options: Readonly<ReferenceCaptureOptions>): Promise<ReferenceCaptureResult>;
+export declare function startReferenceDevServer(checkoutDir: string, repoRoot: string): Promise<{
+    url: string;
+    kill: () => void;
+}>;
+//# sourceMappingURL=referenceCapture.d.ts.map

package/dist/referenceCapture.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"referenceCapture.d.ts","sourceRoot":"","sources":["../src/referenceCapture.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AAMjD,MAAM,WAAW,uBAAuB;IACtC,0EAA0E;IAC1E,WAAW,EAAE,MAAM,CAAC;IACpB,0GAA0G;IAC1G,QAAQ,EAAE,MAAM,CAAC;IACjB,mFAAmF;IACnF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,iGAAiG;IACjG,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,8FAA8F;IAC9F,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;CAClB;AAKD,wBAAgB,wBAAwB,CAAC,WAAW,EAAE,MAAM,GAAG,KAAK,EAAE,CAuBrE;AAID,wBAAsB,mBAAmB,CAAC,OAAO,EAAE,QAAQ,CAAC,uBAAuB,CAAC,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAuDrH;AASD,wBAAgB,uBAAuB,CACrC,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,IAAI,CAAA;CAAE,CAAC,CAiC5C"}

package/dist/referenceCapture.js

@@ -0,0 +1,142 @@
+// The reference-subject capture driver: start flight-reference's Vite dev server (pointed at a Flight
+// checkout via FLIGHT_REPO), enumerate its framework/corpus/case routes, and drive
+// the shared captureEntry path with verify:true. This lives in tool-capture — beside the in-page
+// verifier (functionalVerify) and the capture core (captureEntry) — so BOTH ends of the reference
+// capture are contained in one package; scripts/reference-capture.ts is a thin CLI over runReferenceCapture.
+import { spawn } from 'node:child_process';
+import { existsSync, readdirSync } from 'node:fs';
+import { join, resolve } from 'node:path';
+import { launchBrowser } from './captureBrowser.js';
+import { routeSegment } from './captureEntries.js';
+import { captureParallel } from './captureEntry.js';
+import { formatSummaryCount, formatSummaryLine } from './captureFormat.js';
+import { installAbortHandler } from './captureInterrupt.js';
+// One capture Entry per flight-reference case: name = framework/corpus/case, and a `route` producing the
+// harness's `${framework}-tests/${corpus}/${case}/flight/${renderer}/` URL. Only cases with a Flight
+// implementation (flight/src/app.ts) are captured; every framework (openfl/starling/awayjs) is included.
+export function discoverReferenceEntries(checkoutDir) {
+    const frameworksDir = join(checkoutDir, 'content', 'frameworks');
+    const entries = [];
+    if (!existsSync(frameworksDir))
+        return entries;
+    for (const framework of readdirSync(frameworksDir, { withFileTypes: true })) {
+        if (!framework.isDirectory())
+            continue;
+        const frameworkDir = join(frameworksDir, framework.name);
+        for (const corpus of readdirSync(frameworkDir, { withFileTypes: true })) {
+            if (!corpus.isDirectory())
+                continue;
+            const corpusDir = join(frameworkDir, corpus.name);
+            for (const c of readdirSync(corpusDir, { withFileTypes: true })) {
+                if (!c.isDirectory() || c.name === '_shared')
+                    continue;
+                if (!existsSync(join(corpusDir, c.name, 'flight', 'src', 'app.ts')))
+                    continue;
+                const routePrefix = `${framework.name}-tests`;
+                entries.push({
+                    name: `${framework.name}/${corpus.name}/${c.name}`,
+                    renderers: ['webgl'],
+                    route: (renderer) => `${routePrefix}/${corpus.name}/${c.name}/flight/${routeSegment(renderer)}/`,
+                });
+            }
+        }
+    }
+    return entries.sort((a, b) => a.name.localeCompare(b.name));
+}
+// The full reference-capture session: enumerate, start the dev server, drive captureEntry (verify:true) in
+// parallel, then tear the server + browser down. Prints the same summary line as the monorepo capture.
+export async function runReferenceCapture(options) {
+    let entries = discoverReferenceEntries(options.checkoutDir);
+    if (options.filter)
+        entries = entries.filter((e) => e.name.includes(options.filter));
+    if (entries.length === 0)
+        throw new Error(`No reference cases found  filter="${options.filter ?? ''}"`);
+    console.log('Starting flight-reference Vite dev server…');
+    const server = await startReferenceDevServer(options.checkoutDir, options.repoRoot);
+    console.log(`Ready at ${server.url}\n`);
+    const { browser, context } = await launchBrowser({
+        captureFrames: options.captureFrames ?? 1,
+        verify: true,
+        observe: options.observe,
+    });
+    const isAborted = installAbortHandler();
+    let captured = 0;
+    let changed = 0;
+    let failed = 0;
+    try {
+        const result = await captureParallel({
+            context,
+            entries,
+            rendererFilter: [],
+            baseUrl: server.url,
+            tool: 'reference',
+            outBase: resolve(options.outBase),
+            root: options.checkoutDir,
+            updateBaseline: options.updateBaseline,
+            extraWait: options.extraWait,
+            captureFrames: options.captureFrames,
+            failOnError: options.failOnError,
+            observe: options.observe,
+            verify: true,
+            isAborted,
+            workerCount: options.workerCount ?? 4,
+        });
+        captured = result.captured;
+        changed = result.changed;
+        failed = result.failed;
+    }
+    finally {
+        await browser.close().catch(() => { });
+        server.kill();
+    }
+    console.log('\n' +
+        formatSummaryLine(failed > 0, [
+            formatSummaryCount(captured, 'captured', 'pass'),
+            formatSummaryCount(changed, 'changed', 'warn'),
+            formatSummaryCount(failed, 'failed', 'fail'),
+        ]));
+    console.log(`Output:   ${resolve(options.outBase)}/reference/`);
+    return { captured, changed, failed, aborted: isAborted() };
+}
+// Spawns flight-reference's Vite dev server in the checkout, resolving once it logs its Local URL.
+// FLIGHT_REPO points its @flighthq/* aliases at the Flight source. We deliberately do NOT set
+// FLIGHT_SDK_SOURCE: that flag excludes @flighthq/sdk from Vite's dep pre-bundling to serve it as raw
+// source over HMR (for actively editing SDK internals) — which makes a cold page transform the entire SDK
+// module graph (~1700 modules, tens of seconds) and blow past the capture's page timeout. Capture renders
+// once and only needs the built result, so the pre-bundled path (esbuild-bundling the same local source
+// once) is both correct and far faster here.
+export function startReferenceDevServer(checkoutDir, repoRoot) {
+    return new Promise((resolveUrl, reject) => {
+        const child = spawn('npx', ['vite', '--host', '0.0.0.0'], {
+            cwd: checkoutDir,
+            stdio: ['ignore', 'pipe', 'pipe'],
+            env: { ...process.env, FLIGHT_REPO: repoRoot },
+        });
+        let resolved = false;
+        const timeout = setTimeout(() => {
+            if (!resolved) {
+                resolved = true;
+                reject(new Error('flight-reference Vite dev server did not start within 60s'));
+            }
+        }, 60_000);
+        const ansi = new RegExp(String.fromCharCode(27) + '\\[[0-9;]*m', 'g');
+        const onData = (data) => {
+            const match = /Local:\s+(https?:\/\/\S+)/.exec(data.toString().replace(ansi, ''));
+            if (match && !resolved) {
+                resolved = true;
+                clearTimeout(timeout);
+                resolveUrl({ url: match[1].replace(/\/$/, ''), kill: () => child.kill('SIGTERM') });
+            }
+        };
+        child.stdout?.on('data', onData);
+        child.stderr?.on('data', onData);
+        child.on('error', (err) => {
+            if (!resolved) {
+                resolved = true;
+                clearTimeout(timeout);
+                reject(err);
+            }
+        });
+    });
+}
+//# sourceMappingURL=referenceCapture.js.map

package/dist/referenceCapture.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"referenceCapture.js","sourceRoot":"","sources":["../src/referenceCapture.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flighthq/tool-capture",
-  "version": "0.2.0",
+  "version": "0.2.1-next.423.3350e53",
   "repository": {
     "type": "git",
     "url": "https://github.com/flighthq/flight.git",
@@ -15,6 +15,9 @@
       "default": "./dist/index.js"
     }
   },
+  "bin": {
+    "tool-capture": "dist/bin.js"
+  },
   "files": [
     "dist",
     "src/**/*.test.ts",
@@ -32,6 +35,9 @@
     "clean:dist": "tsx ../../scripts/clean-package-dist.ts"
   },
   "dependencies": {
+    "@flighthq/render-wgpu": "0.2.1-next.423.3350e53",
+    "@flighthq/surface": "0.2.1-next.423.3350e53",
+    "@flighthq/types": "0.2.1-next.423.3350e53",
     "@playwright/test": "^1.50.0",
     "picocolors": "^1.1.1"
   },

package/src/captureEntry.test.ts

@@ -2,7 +2,112 @@ import { isAbsolute, join } from 'node:path';
 
 import { describe, expect, it } from 'vitest';
 
-import { captureEntry, captureParallel, getCaptureOutputPaths } from './captureEntry';
+import {
+  buildCaptureObserveDiagnostics,
+  captureEntry,
+  captureParallel,
+  captureUrl,
+  getCaptureOutputPaths,
+} from './captureEntry';
+
+describe('buildCaptureObserveDiagnostics', () => {
+  it('passes through the render facts and separates page exceptions from console/network errors', () => {
+    const d = buildCaptureObserveDiagnostics({
+      backend: 'webgl',
+      blank: true,
+      coverage: 0,
+      verifyPublished: false,
+      verifyTargetKind: 'webgl',
+      warmupFrames: 3,
+      logs: [
+        { level: 'pageerror', data: { msg: 'boom' } },
+        { level: 'error', channel: 'network', data: { msg: 'request failed' } },
+        { level: 'error', channel: 'console', data: { msg: 'console.error' } },
+        { level: 'info', data: { msg: 'ignored' } },
+      ],
+    });
+    expect(d).toEqual({
+      backend: 'webgl',
+      blank: true,
+      coverage: 0,
+      errorCount: 2,
+      pageErrorCount: 1,
+      verifyPublished: false,
+      verifyTargetKind: 'webgl',
+      warmupFrames: 3,
+    });
+  });
+
+  it('reports a clean non-blank observation with no errors', () => {
+    const d = buildCaptureObserveDiagnostics({
+      backend: 'webgl',
+      blank: false,
+      coverage: 0.42,
+      verifyPublished: true,
+      verifyTargetKind: 'webgl',
+      warmupFrames: 0,
+      logs: [],
+    });
+    expect(d.blank).toBe(false);
+    expect(d.coverage).toBe(0.42);
+    expect(d.pageErrorCount).toBe(0);
+    expect(d.errorCount).toBe(0);
+    expect(d.warmupFrames).toBe(0);
+  });
+
+  it('folds measured coverage into blank: an empty frame is blank even with no verify target', () => {
+    // A scene that registered no verify target (blank=false from the screenshot path) but drew nothing
+    // to the canvas (coverage 0) must still read as blank — the 2D-assets-never-loaded case.
+    const empty = buildCaptureObserveDiagnostics({
+      backend: 'webgl',
+      blank: false,
+      coverage: 0,
+      verifyPublished: false,
+      verifyTargetKind: null,
+      warmupFrames: 0,
+      logs: [],
+    });
+    expect(empty.blank).toBe(true);
+
+    // A frame with real content stays non-blank; a null coverage (unmeasured) does not force blank.
+    expect(
+      buildCaptureObserveDiagnostics({
+        backend: 'webgl',
+        blank: false,
+        coverage: 0.1,
+        verifyPublished: false,
+        verifyTargetKind: null,
+        warmupFrames: 0,
+        logs: [],
+      }).blank,
+    ).toBe(false);
+    expect(
+      buildCaptureObserveDiagnostics({
+        backend: 'webgl',
+        blank: false,
+        coverage: null,
+        verifyPublished: false,
+        verifyTargetKind: null,
+        warmupFrames: 0,
+        logs: [],
+      }).blank,
+    ).toBe(false);
+
+    // Measured pixels win over the verifier: a scene the verifier never published (blank=true) but
+    // whose canvas is clearly full (coverage 0.98) is NOT blank — the verify-publish false-positive.
+    expect(
+      buildCaptureObserveDiagnostics({
+        backend: 'webgl',
+        blank: true,
+        coverage: 0.98,
+        verifyPublished: false,
+        verifyTargetKind: 'webgl',
+        warmupFrames: 600,
+        logs: [],
+      }).blank,
+    ).toBe(false);
+  });
+});
 
 describe('captureEntry', () => {
   // Driving a page needs a live Playwright BrowserContext and server; that path is exercised end to end
@@ -18,6 +123,13 @@ describe('captureParallel', () => {
   });
 });
 
+describe('captureUrl', () => {
+  // Drives its own headless browser against a live URL; exercised end to end by the `observe` bin.
+  it('is a callable single-url observe pass', () => {
+    expect(typeof captureUrl).toBe('function');
+  });
+});
+
 describe('getCaptureOutputPaths', () => {
   it('derives the {outBase}/{tool}/{name}/{routeSegment}/… artifact layout', () => {
     const paths = getCaptureOutputPaths('out', 'functional', 'foo', 'flight:webgl');

package/src/functionalVerify.test.ts

@@ -0,0 +1,94 @@
+// @vitest-environment jsdom
+
+import type { DomRenderState } from '@flighthq/types';
+import { afterEach, describe, expect, it } from 'vitest';
+
+import type { FunctionalTarget } from './functionalVerify';
+import {
+  publishFunctionalRenderSync,
+  registerFunctionalTarget,
+  registerWgpuFunctionalTarget,
+  runRenderVerification,
+  snapshotFunctionalRender,
+} from './functionalVerify';
+
+// The verifier communicates through window globals; clear them between cases so state doesn't leak.
+interface VerificationWindowLike {
+  __ftTarget?: unknown;
+  __ftVerification?: unknown;
+  __ftRenderImage?: unknown;
+}
+
+afterEach(() => {
+  const w = window as unknown as VerificationWindowLike;
+  w.__ftTarget = undefined;
+  w.__ftVerification = undefined;
+  w.__ftRenderImage = undefined;
+});
+
+// A minimal DOM target — the only backend snapshot/verification handles without a real GPU context.
+function domTarget(element: HTMLElement): FunctionalTarget {
+  return {
+    kind: 'dom',
+    state: { element } as unknown as DomRenderState,
+    width: 10,
+    height: 10,
+    scale: 1,
+    render: () => {},
+  };
+}
+
+describe('publishFunctionalRenderSync', () => {
+  it('returns false when no target is registered', () => {
+    expect(publishFunctionalRenderSync('webgl')).toBe(false);
+  });
+
+  it('returns false for a non-webgl target and does not publish', () => {
+    registerFunctionalTarget(domTarget(document.createElement('div')));
+    expect(publishFunctionalRenderSync('webgl')).toBe(false);
+    expect((window as unknown as VerificationWindowLike).__ftRenderImage).toBeUndefined();
+  });
+});
+
+describe('registerFunctionalTarget', () => {
+  it('records the target on window and returns it', () => {
+    const target = domTarget(document.createElement('div'));
+    const returned = registerFunctionalTarget(target);
+    expect(returned).toBe(target);
+    expect((window as unknown as VerificationWindowLike).__ftTarget).toBe(target);
+  });
+});
+
+describe('registerWgpuFunctionalTarget', () => {
+  // Enabling wgpu frame capture needs a real WgpuRenderState; end-to-end coverage is the functional
+  // suite's job. Here we only assert the entry point is wired.
+  it('is a callable registrar', () => {
+    expect(typeof registerWgpuFunctionalTarget).toBe('function');
+  });
+});
+
+describe('runRenderVerification', () => {
+  it('throws on a blank DOM render (no elements or text)', async () => {
+    registerFunctionalTarget(domTarget(document.createElement('div')));
+    await expect(runRenderVerification({}, 'dom')).rejects.toThrow(/blank render/);
+  });
+
+  it('passes a DOM render that emitted content and records the verification', async () => {
+    const host = document.createElement('div');
+    host.appendChild(document.createElement('span'));
+    registerFunctionalTarget(domTarget(host));
+    await runRenderVerification({}, 'dom');
+    expect((window as unknown as VerificationWindowLike).__ftVerification).toMatchObject({ render: 'dom' });
+  });
+});
+
+describe('snapshotFunctionalRender', () => {
+  it('returns null for a DOM target', async () => {
+    registerFunctionalTarget(domTarget(document.createElement('div')));
+    expect(await snapshotFunctionalRender()).toBeNull();
+  });
+
+  it('returns null when no target and no canvas is present', async () => {
+    expect(await snapshotFunctionalRender()).toBeNull();
+  });
+});