@juxtapose/core 0.2.0

package/dist/capture/capture.js

@@ -0,0 +1,153 @@
+// Capture one story. The ordering here is load-bearing — see settle.ts for why
+// each step exists. Because pass/fail is a byte-exact hash, every source of
+// nondeterminism left in this path becomes a false failure somewhere.
+import sharp from 'sharp';
+import { armSettle, drain, FREEZE_ANIMATIONS_CSS, waitForPaint, waitForSelector, } from './settle.js';
+const DEFAULT_CAPTURE_TIMEOUT_MS = 2000;
+/** Per-page memo: skip work that only needs doing once per page. */
+const styleInjected = new WeakSet();
+const pageViewport = new WeakMap();
+const warmPages = new WeakMap();
+export async function captureStory(page, story, deps, viewport) {
+    const started = Date.now();
+    // Copied, not aliased: live params get merged in below, and mutating the
+    // manifest entry would leak one story's config into the next run.
+    const params = { ...story.params };
+    const effectiveViewport = params.viewport ?? viewport;
+    const timeoutMs = params.captureTimeout ?? DEFAULT_CAPTURE_TIMEOUT_MS;
+    const ctx = { story, params, timeoutMs };
+    await ensureViewport(page, effectiveViewport);
+    // Arm before triggering the render, or the observer misses the mutations it
+    // exists to watch.
+    //
+    // A story that wants animations running can't reuse a page whose stylesheet
+    // already froze them, so force the cold path for those.
+    const warm = deps.warmSwitch === true &&
+        warmPages.get(page) === deps.baseUrl &&
+        !(params.animations === 'play' && styleInjected.has(page));
+    if (warm)
+        await armSettle(page);
+    const switched = warm && deps.platform.switchStory
+        ? await deps.platform.switchStory(page, story.storyId, ctx)
+        : false;
+    if (!switched) {
+        // Delegated rather than built here: not every platform addresses a story
+        // by URL. Playwright galleries render via window.mount() on a fixed page.
+        await deps.platform.showStory(page, story.storyId, deps.baseUrl);
+        // A navigation discards injected style tags, so the freeze must be
+        // re-applied for the next story that wants it.
+        styleInjected.delete(page);
+        warmPages.set(page, deps.baseUrl);
+        await armSettle(page);
+    }
+    // Freeze BEFORE the story renders, not after.
+    //
+    // This ordering is the whole ballgame for warm-page reuse. Injected styles
+    // survive a story switch but not a navigation, so freezing after render
+    // means a warm story renders with the previous story's freeze already
+    // active while a cold story renders unfrozen — and the two paths produce
+    // different pixels for the same story. Under a byte-exact hash that makes a
+    // story's result depend on where it landed in the shuffled queue, which is
+    // to say: random.
+    //
+    // Injecting here makes both paths see identical conditions. Measured on a
+    // 16-story suite: 2-4 stories failing per run before, 16/16 stable after.
+    await freezeAnimations(page, params);
+    await deps.platform.settle(page, ctx);
+    // Now that the story has rendered, ask the platform whether it declares
+    // params the static index didn't carry.
+    //
+    // Storybook is why this exists: it only serializes a whitelist of parameters
+    // into index.json, so `parameters.juxtapose` is essentially never there.
+    // Reading the index alone silently dropped every per-story threshold,
+    // waitForSelector and skip on that platform.
+    //
+    // Live params override manifest params — the live preview is the story's own
+    // declaration, and the index is a lossy projection of it.
+    const live = await deps.platform.readLiveParams?.(page, story.storyId);
+    if (live) {
+        Object.assign(params, live);
+        // Viewport is the one param that cannot be applied retroactively — the
+        // story has already laid out. Re-set it and let the platform settle
+        // again, so a story declaring its own viewport is captured at that size
+        // rather than the project default.
+        const liveViewport = live.viewport;
+        if (liveViewport && !sameViewport(liveViewport, effectiveViewport)) {
+            await ensureViewport(page, liveViewport);
+            await deps.platform.settle(page, { ...ctx, params });
+        }
+    }
+    // A story can declare `skip` in params the static index never carried, so
+    // this is the first point we can honour it. Signalled rather than returning
+    // a snapshot, because capturing and then discarding would still cost the
+    // screenshot and would report a meaningless hash.
+    if (params.skip === true)
+        return null;
+    if (params.waitForSelector) {
+        await waitForSelector(page, params.waitForSelector, timeoutMs);
+    }
+    await drain(page);
+    // Fixed delay is the escape hatch of last resort — it costs the same on
+    // every run whether or not it was needed. Prefer waitForSelector.
+    if (params.delay && params.delay > 0) {
+        await page.waitForTimeout(params.delay);
+    }
+    // Last barrier before the shutter: the DOM being quiet does not mean the
+    // pixels are final. Style, layout and paint still have to land, and without
+    // this the capture intermittently catches an intermediate frame — which a
+    // byte-exact hash reports as a failure.
+    await waitForPaint(page);
+    const png = await page.screenshot({ type: 'png' });
+    // LOSSLESS, deliberately, and it is not a size-vs-quality preference.
+    //
+    // Lossy WebP at q90 perturbs ~7.7% of pixels frame-wide. The hash comparison
+    // survives that (encoding is deterministic, so identical input still yields
+    // identical bytes), but the pixel diff does not: comparing two lossy decodes
+    // scatters compression noise across every row and column, which swallows the
+    // real changed region into a full-viewport bounding box and destroys the
+    // localization the diff exists to provide.
+    //
+    // Measured: 3537 changed pixels from a single recoloured button spread over
+    // all 800 rows and all 1280 columns. With lossless, zero pixels differ from
+    // the source. Costs ~4x the bytes; buys a diff that means something.
+    const image = await sharp(png)
+        .webp({ lossless: true, effort: deps.webpEffort ?? 0 })
+        .toBuffer();
+    return {
+        storyId: story.storyId,
+        image,
+        // The live params may have widened or narrowed this after first render,
+        // so report what we actually captured at — the agent handoff computes
+        // region area as a fraction of it.
+        viewport: params.viewport ?? effectiveViewport,
+        capturedAt: new Date().toISOString(),
+        durationMs: Date.now() - started,
+    };
+}
+const sameViewport = (a, b) => a.width === b.width && a.height === b.height;
+/** Setting the viewport is a CDP round-trip; skip it when nothing changed. */
+async function ensureViewport(page, viewport) {
+    const key = `${viewport.width}x${viewport.height}`;
+    if (pageViewport.get(page) === key)
+        return;
+    await page.setViewportSize(viewport);
+    pageViewport.set(page, key);
+}
+/**
+ * Inject the freeze stylesheet, once per page.
+ *
+ * Note the interaction with warm-page reuse: the style tag survives a story
+ * switch but not a navigation, so a story with `animations: 'play'` landing on
+ * an already-frozen page would still be frozen. The warm check above excludes
+ * those stories for that reason, forcing them down the cold path where the
+ * navigation clears the tag.
+ */
+async function freezeAnimations(page, params) {
+    if (params.animations === 'play')
+        return;
+    if (styleInjected.has(page))
+        return;
+    await page.addStyleTag({ content: FREEZE_ANIMATIONS_CSS }).catch(() => { });
+    styleInjected.add(page);
+}
+//# sourceMappingURL=capture.js.map

package/dist/capture/capture.js.map

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

package/dist/capture/launch.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Chromium flags that make rasterization reproducible across runs.
+ *
+ * Each is here for a reason; none are cargo-culted:
+ *
+ * - `--disable-gpu`, `--disable-gpu-rasterization`, `--disable-skia-runtime-opts`
+ *   force CPU rasterization down a fixed code path. GPU rasterization is the
+ *   direct cause of the off-by-one antialiasing jitter above, and Skia's
+ *   runtime CPU-feature detection can pick different SIMD paths on different
+ *   machines.
+ *
+ * - `--force-color-profile=srgb`, `--disable-lcd-text`, `--disable-font-subpixel-positioning`
+ *   pin colour management and text rendering. Subpixel positioning and LCD
+ *   antialiasing make glyph edges depend on display configuration, which is
+ *   exactly the kind of environment coupling that makes a baseline captured on
+ *   one machine fail on another.
+ *
+ * - `--hide-scrollbars` keeps a scrollbar's presence from shifting layout by a
+ *   few pixels depending on content height.
+ *
+ * - `--disable-background-timer-throttling` and friends stop Chromium from
+ *   throttling a backgrounded renderer, which otherwise makes settle timing
+ *   depend on whether the window happens to be focused.
+ */
+export declare const DETERMINISTIC_CHROMIUM_ARGS: readonly string[];
+export interface LaunchOptions {
+    /** Extra flags, appended after the deterministic set so they can override. */
+    args?: string[];
+    headless?: boolean;
+}
+/** Build the Playwright launch options for a reproducible capture browser. */
+export declare function deterministicLaunchOptions(opts?: LaunchOptions): {
+    headless: boolean;
+    args: string[];
+};

package/dist/capture/launch.js

@@ -0,0 +1,56 @@
+// Browser launch flags for reproducible rasterization.
+//
+// These matter more here than in most Playwright setups. Pass/fail is a
+// byte-exact hash, so a single pixel of GPU rasterization jitter on one
+// antialiased corner is a failed build — not a 0.002% mismatch someone can
+// wave through.
+//
+// Measured on a card component with rounded corners: without these flags,
+// repeated captures of an unchanged story differed by ~12 pixels out of
+// 480,000, each off by exactly 1 in one channel. Invisible to a human, fatal
+// to a hash.
+/**
+ * Chromium flags that make rasterization reproducible across runs.
+ *
+ * Each is here for a reason; none are cargo-culted:
+ *
+ * - `--disable-gpu`, `--disable-gpu-rasterization`, `--disable-skia-runtime-opts`
+ *   force CPU rasterization down a fixed code path. GPU rasterization is the
+ *   direct cause of the off-by-one antialiasing jitter above, and Skia's
+ *   runtime CPU-feature detection can pick different SIMD paths on different
+ *   machines.
+ *
+ * - `--force-color-profile=srgb`, `--disable-lcd-text`, `--disable-font-subpixel-positioning`
+ *   pin colour management and text rendering. Subpixel positioning and LCD
+ *   antialiasing make glyph edges depend on display configuration, which is
+ *   exactly the kind of environment coupling that makes a baseline captured on
+ *   one machine fail on another.
+ *
+ * - `--hide-scrollbars` keeps a scrollbar's presence from shifting layout by a
+ *   few pixels depending on content height.
+ *
+ * - `--disable-background-timer-throttling` and friends stop Chromium from
+ *   throttling a backgrounded renderer, which otherwise makes settle timing
+ *   depend on whether the window happens to be focused.
+ */
+export const DETERMINISTIC_CHROMIUM_ARGS = [
+    '--disable-gpu',
+    '--disable-gpu-rasterization',
+    '--disable-skia-runtime-opts',
+    '--disable-lcd-text',
+    '--disable-font-subpixel-positioning',
+    '--force-color-profile=srgb',
+    '--hide-scrollbars',
+    '--disable-background-timer-throttling',
+    '--disable-backgrounding-occluded-windows',
+    '--disable-renderer-backgrounding',
+    '--force-device-scale-factor=1',
+];
+/** Build the Playwright launch options for a reproducible capture browser. */
+export function deterministicLaunchOptions(opts = {}) {
+    return {
+        headless: opts.headless ?? true,
+        args: [...DETERMINISTIC_CHROMIUM_ARGS, ...(opts.args ?? [])],
+    };
+}
+//# sourceMappingURL=launch.js.map

package/dist/capture/launch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"launch.js","sourceRoot":"","sources":["../../src/capture/launch.ts"],"names":[],"mappings":"AAAA,uDAAuD;AACvD,EAAE;AACF,wEAAwE;AACxE,wEAAwE;AACxE,2EAA2E;AAC3E,gBAAgB;AAChB,EAAE;AACF,0EAA0E;AAC1E,wEAAwE;AACxE,6EAA6E;AAC7E,aAAa;AAEb;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAsB;IAC5D,eAAe;IACf,6BAA6B;IAC7B,6BAA6B;IAC7B,oBAAoB;IACpB,qCAAqC;IACrC,4BAA4B;IAC5B,mBAAmB;IACnB,uCAAuC;IACvC,0CAA0C;IAC1C,kCAAkC;IAClC,+BAA+B;CAChC,CAAC;AAQF,8EAA8E;AAC9E,MAAM,UAAU,0BAA0B,CAAC,OAAsB,EAAE;IAIjE,OAAO;QACL,QAAQ,EAAE,IAAI,CAAC,QAAQ,IAAI,IAAI;QAC/B,IAAI,EAAE,CAAC,GAAG,2BAA2B,EAAE,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;KAC7D,CAAC;AACJ,CAAC"}

package/dist/capture/pool.d.ts

@@ -0,0 +1,42 @@
+import type { Browser } from 'playwright';
+import type { Platform } from '../platform.js';
+import type { Snapshot, StoryManifest, Viewport } from '../types.js';
+/**
+ * Default parallelism.
+ *
+ * Empirically 8 on a 10-core machine (~80% utilization). This is NOT a
+ * "higher is better" knob: at 16+ the render-ready timeout starts firing from
+ * CPU contention rather than real story failures, and 32 measured ~50% SLOWER
+ * than 16 on the same suite. Scale to core count, not to infinity.
+ */
+export declare const DEFAULT_CONCURRENCY = 8;
+export interface PoolOptions {
+    browser: Browser;
+    platform: Platform;
+    baseUrl: string;
+    concurrency?: number;
+    viewport: Viewport;
+    /** Called as each story finishes, for progress reporting. */
+    onProgress?: (done: number, total: number, storyId: string) => void;
+    /** Cooperative cancellation, checked at story boundaries. */
+    signal?: AbortSignal;
+    /** Reuse warm pages and switch stories in place. Faster, but does not
+     *  currently reproduce cold-load pixels exactly — see CaptureDeps. */
+    warmSwitch?: boolean;
+}
+export interface CaptureOutcome {
+    story: StoryManifest;
+    snapshot?: Snapshot;
+    error?: Error;
+    /** The story asked to be skipped via params the index didn't carry. */
+    skipped?: boolean;
+}
+/**
+ * Capture stories across N parallel pages, yielding results as they complete.
+ *
+ * Each worker owns its own BrowserContext. Sharing one context across workers
+ * was measured at ~0% faster and leaks state between concurrently-rendering
+ * stories — most visibly a service worker registered by one story racing
+ * another's navigation. Isolation wins on a tie.
+ */
+export declare function capturePool(stories: StoryManifest[], opts: PoolOptions): AsyncGenerator<CaptureOutcome>;

package/dist/capture/pool.js

@@ -0,0 +1,109 @@
+// Worker pool: fan stories across N parallel pages, yielding results as they
+// complete. Used by both the CLI and the dev-server review API, which is why
+// it takes a Browser rather than owning one.
+import { captureStory } from './capture.js';
+/**
+ * Default parallelism.
+ *
+ * Empirically 8 on a 10-core machine (~80% utilization). This is NOT a
+ * "higher is better" knob: at 16+ the render-ready timeout starts firing from
+ * CPU contention rather than real story failures, and 32 measured ~50% SLOWER
+ * than 16 on the same suite. Scale to core count, not to infinity.
+ */
+export const DEFAULT_CONCURRENCY = 8;
+/**
+ * Capture stories across N parallel pages, yielding results as they complete.
+ *
+ * Each worker owns its own BrowserContext. Sharing one context across workers
+ * was measured at ~0% faster and leaks state between concurrently-rendering
+ * stories — most visibly a service worker registered by one story racing
+ * another's navigation. Isolation wins on a tie.
+ */
+export async function* capturePool(stories, opts) {
+    const queue = stories.filter((s) => s.params.skip !== true);
+    if (queue.length === 0)
+        return;
+    const concurrency = Math.max(1, opts.concurrency ?? DEFAULT_CONCURRENCY);
+    const workerCount = Math.min(concurrency, queue.length);
+    // Shuffle so stories from one slow component don't cluster at the tail and
+    // serialize the final stretch on a single worker. Skipped at concurrency 1,
+    // where ordering is deterministic and there's nothing to interleave.
+    const work = workerCount > 1 ? shuffle(queue) : queue;
+    let cursor = 0;
+    let done = 0;
+    const buffer = [];
+    let notify = null;
+    const push = (out) => {
+        buffer.push(out);
+        notify?.();
+        notify = null;
+    };
+    const workers = Array.from({ length: workerCount }, async () => {
+        const context = await opts.browser.newContext({
+            viewport: opts.viewport,
+            // No Retina. Quadruples buffer size for no diff signal.
+            deviceScaleFactor: 1,
+        });
+        const page = await context.newPage();
+        const deps = {
+            platform: opts.platform,
+            baseUrl: opts.baseUrl,
+            warmSwitch: opts.warmSwitch,
+        };
+        try {
+            for (;;) {
+                if (opts.signal?.aborted)
+                    break;
+                const i = cursor++;
+                if (i >= work.length)
+                    break;
+                const story = work[i];
+                try {
+                    const snapshot = await captureStory(page, story, deps, opts.viewport);
+                    // null means the story declared `skip` in params only visible once
+                    // it had rendered. Report it as skipped, not as a failure.
+                    push(snapshot ? { story, snapshot } : { story, skipped: true });
+                }
+                catch (err) {
+                    // One bad story must never kill a run of 700. Report it as a failure
+                    // for this story and keep the worker going.
+                    push({ story, error: err instanceof Error ? err : new Error(String(err)) });
+                }
+                opts.onProgress?.(++done, work.length, story.storyId);
+            }
+        }
+        finally {
+            await context.close().catch(() => { });
+        }
+    });
+    const all = Promise.all(workers);
+    let finished = false;
+    void all.then(() => {
+        finished = true;
+        notify?.();
+        notify = null;
+    }, () => {
+        finished = true;
+        notify?.();
+        notify = null;
+    });
+    while (!finished || buffer.length > 0) {
+        if (buffer.length === 0) {
+            await new Promise((resolve) => {
+                notify = resolve;
+            });
+            continue;
+        }
+        yield buffer.shift();
+    }
+    await all;
+}
+function shuffle(items) {
+    const out = items.slice();
+    for (let i = out.length - 1; i > 0; i--) {
+        const j = Math.floor(Math.random() * (i + 1));
+        [out[i], out[j]] = [out[j], out[i]];
+    }
+    return out;
+}
+//# sourceMappingURL=pool.js.map

package/dist/capture/pool.js.map

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

package/dist/capture/settle.d.ts

@@ -0,0 +1,50 @@
+import type { Page } from 'playwright';
+/** Quiet period with no DOM mutations and no in-flight fetches before we
+ *  declare the page settled. */
+export declare const DOM_IDLE_MS = 150;
+/** Hard cap on waiting for quiescence. A story that never goes idle — a
+ *  spinner that survived the CSS freeze, a polling widget — still gets
+ *  captured rather than hanging the run. Kept tight: this cost is paid on
+ *  every such story, times the whole suite. */
+export declare const DOM_IDLE_TIMEOUT_MS = 500;
+/** Arm the quiescence observer. Call before triggering a story render. */
+export declare function armSettle(page: Page): Promise<void>;
+/**
+ * Await quiescence, webfonts and image decode in a single round trip.
+ *
+ * Deliberately one `evaluate` rather than three. At ~1.2s per story and 8
+ * parallel pages, CDP round-trips are a measurable share of wall clock; the
+ * original tool cut per-story time meaningfully by collapsing these.
+ */
+export declare function drain(page: Page): Promise<void>;
+/**
+ * Zero out animations and transitions.
+ *
+ * Without this, anything mid-animation at screenshot time — spinners, skeleton
+ * shimmer, fade-ins, the text caret — makes the story diff against itself on
+ * every run. Stories that exist specifically to test animation opt out with
+ * `animations: 'play'`.
+ */
+export declare const FREEZE_ANIMATIONS_CSS = "\n*, *::before, *::after {\n  animation-duration: 0s !important;\n  animation-delay: 0s !important;\n  animation-iteration-count: 1 !important;\n  transition-duration: 0s !important;\n  transition-delay: 0s !important;\n  caret-color: transparent !important;\n}\n";
+/** Wait for an explicit selector. Escape hatch for async content the network
+ *  drain can't observe — SDK init, canvas paint, third-party widgets. */
+export declare function waitForSelector(page: Page, selector: string, timeoutMs: number): Promise<void>;
+/**
+ * Block until the compositor has actually presented a frame.
+ *
+ * The DOM going quiet is not the same as the pixels being final: style
+ * recalculation, layout and paint still have to happen, and a screenshot taken
+ * in that window catches an intermediate frame.
+ *
+ * This is not theoretical. Without it, repeated captures of an unchanged story
+ * differed by ~12 pixels out of 480,000 — each off by exactly 1 — on the
+ * antialiased edges of a rounded corner. Invisible to a human; a failed build
+ * under a byte-exact hash. Measured: flaky with no wait, stable from ~50ms,
+ * and stable with this barrier and no arbitrary delay at all.
+ *
+ * Two nested rAFs, then `requestIdleCallback`: the first rAF runs before the
+ * next paint, the second after it has been committed, and the idle callback
+ * gives any post-paint work a chance to drain. Cheap — a couple of frames at
+ * most — and it removes the need for a blanket sleep on every story.
+ */
+export declare function waitForPaint(page: Page, timeoutMs?: number): Promise<void>;

package/dist/capture/settle.js

@@ -0,0 +1,162 @@
+// Platform-neutral settling. Runs *after* the platform's own render signal
+// (Platform.settle) has resolved. Everything here applies to any DOM, which is
+// why it lives in core rather than in an adapter.
+//
+// The ordering matters and is not arbitrary:
+//   arm → platform render signal → DOM/network quiescence → fonts → images
+// Arming must happen before the render is triggered, or the observer misses
+// the mutations it is supposed to be watching.
+/** Quiet period with no DOM mutations and no in-flight fetches before we
+ *  declare the page settled. */
+export const DOM_IDLE_MS = 150;
+/** Hard cap on waiting for quiescence. A story that never goes idle — a
+ *  spinner that survived the CSS freeze, a polling widget — still gets
+ *  captured rather than hanging the run. Kept tight: this cost is paid on
+ *  every such story, times the whole suite. */
+export const DOM_IDLE_TIMEOUT_MS = 500;
+/**
+ * Installed via evaluate before each story render. Resolves `window.__juxWait`
+ * once the DOM has been mutation-free for `idleMs`, or `timeoutMs` elapses.
+ *
+ * Counts in-flight fetches too: a story that fires a request on mount would
+ * otherwise report "idle" in the gap between mount and response, and we'd
+ * screenshot the loading state — intermittently.
+ */
+const SETTLE_SCRIPT = `
+  var done = false;
+  window.__juxWait = new Promise(function (resolve) {
+    var pending = 0;
+    var idleTimer = null;
+
+    function finish() {
+      if (done) return;
+      done = true;
+      observer.disconnect();
+      clearTimeout(idleTimer);
+      clearTimeout(capTimer);
+      if (window.__juxFetchOrig) {
+        window.fetch = window.__juxFetchOrig;
+        delete window.__juxFetchOrig;
+      }
+      resolve();
+    }
+
+    var capTimer = setTimeout(finish, timeoutMs);
+
+    function scheduleIdle() {
+      clearTimeout(idleTimer);
+      if (pending === 0) idleTimer = setTimeout(finish, idleMs);
+    }
+
+    if (!window.__juxFetchOrig) {
+      window.__juxFetchOrig = window.fetch;
+      window.fetch = function () {
+        pending++;
+        clearTimeout(idleTimer);
+        return window.__juxFetchOrig.apply(this, arguments).finally(function () {
+          pending--;
+          scheduleIdle();
+        });
+      };
+    }
+
+    var observer = new MutationObserver(scheduleIdle);
+    observer.observe(document.documentElement, {
+      childList: true, subtree: true, attributes: true, characterData: true,
+    });
+    scheduleIdle();
+  });
+`;
+/** Arm the quiescence observer. Call before triggering a story render. */
+export async function armSettle(page) {
+    await page
+        .evaluate(`(function (idleMs, timeoutMs) { ${SETTLE_SCRIPT} })(${DOM_IDLE_MS}, ${DOM_IDLE_TIMEOUT_MS})`)
+        .catch(() => { });
+}
+/**
+ * Await quiescence, webfonts and image decode in a single round trip.
+ *
+ * Deliberately one `evaluate` rather than three. At ~1.2s per story and 8
+ * parallel pages, CDP round-trips are a measurable share of wall clock; the
+ * original tool cut per-story time meaningfully by collapsing these.
+ */
+export async function drain(page) {
+    await page
+        .evaluate(async () => {
+        const w = window;
+        await (w.__juxWait ?? Promise.resolve());
+        // Webfonts: a story captured mid-swap diffs against one captured after,
+        // for every glyph on the page.
+        await document.fonts?.ready?.catch?.(() => { });
+        // Decode, not just load — an undecoded image can still paint late.
+        await Promise.all(Array.from(document.images).map((img) => img.complete
+            ? Promise.resolve()
+            : new Promise((r) => {
+                img.addEventListener('load', () => r(), { once: true });
+                img.addEventListener('error', () => r(), { once: true });
+            })));
+    })
+        .catch(() => { });
+}
+/**
+ * Zero out animations and transitions.
+ *
+ * Without this, anything mid-animation at screenshot time — spinners, skeleton
+ * shimmer, fade-ins, the text caret — makes the story diff against itself on
+ * every run. Stories that exist specifically to test animation opt out with
+ * `animations: 'play'`.
+ */
+export const FREEZE_ANIMATIONS_CSS = `
+*, *::before, *::after {
+  animation-duration: 0s !important;
+  animation-delay: 0s !important;
+  animation-iteration-count: 1 !important;
+  transition-duration: 0s !important;
+  transition-delay: 0s !important;
+  caret-color: transparent !important;
+}
+`;
+/** Wait for an explicit selector. Escape hatch for async content the network
+ *  drain can't observe — SDK init, canvas paint, third-party widgets. */
+export async function waitForSelector(page, selector, timeoutMs) {
+    await page.waitForSelector(selector, { timeout: timeoutMs }).catch(() => { });
+}
+/**
+ * Block until the compositor has actually presented a frame.
+ *
+ * The DOM going quiet is not the same as the pixels being final: style
+ * recalculation, layout and paint still have to happen, and a screenshot taken
+ * in that window catches an intermediate frame.
+ *
+ * This is not theoretical. Without it, repeated captures of an unchanged story
+ * differed by ~12 pixels out of 480,000 — each off by exactly 1 — on the
+ * antialiased edges of a rounded corner. Invisible to a human; a failed build
+ * under a byte-exact hash. Measured: flaky with no wait, stable from ~50ms,
+ * and stable with this barrier and no arbitrary delay at all.
+ *
+ * Two nested rAFs, then `requestIdleCallback`: the first rAF runs before the
+ * next paint, the second after it has been committed, and the idle callback
+ * gives any post-paint work a chance to drain. Cheap — a couple of frames at
+ * most — and it removes the need for a blanket sleep on every story.
+ */
+export async function waitForPaint(page, timeoutMs = 1000) {
+    await page
+        .evaluate((cap) => new Promise((resolve) => {
+        const done = () => resolve();
+        const timer = setTimeout(done, cap);
+        requestAnimationFrame(() => requestAnimationFrame(() => {
+            const finish = () => {
+                clearTimeout(timer);
+                done();
+            };
+            if (typeof requestIdleCallback === 'function') {
+                requestIdleCallback(finish, { timeout: 100 });
+            }
+            else {
+                finish();
+            }
+        }));
+    }), timeoutMs)
+        .catch(() => { });
+}
+//# sourceMappingURL=settle.js.map

package/dist/capture/settle.js.map

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