@juxtapose/core 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Magic Factory LLC
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,17 @@
+# @juxtapose/core
+
+Platform-agnostic capture, diff, baseline and analysis core for juxtapose.
+
+Part of [juxtapose](https://github.com/juxtapose-dev/juxtapose), visual
+regression testing for component workbenches.
+
+**You probably don't need to install this directly.** Use
+[`@juxtapose/cli`](https://www.npmjs.com/package/@juxtapose/cli) for the
+command line, or
+[`@juxtapose/storybook`](https://www.npmjs.com/package/@juxtapose/storybook)
+to review diffs inside Storybook. This package is a building block those
+depend on.
+
+Full documentation: https://github.com/juxtapose-dev/juxtapose
+
+MIT © Magic Factory LLC

package/dist/agent/handoff.d.ts

@@ -0,0 +1,30 @@
+import type { ChangedRegion, DiffStatus, Viewport } from '../types.js';
+export interface HandoffPayload {
+    storyId: string;
+    storyTitle: string;
+    status: DiffStatus;
+    mismatchPercent: number;
+    mismatchPixels: number;
+    changedRegions: ChangedRegion[];
+    viewport: Viewport;
+    /** Absolute path to the story's source file, when known. */
+    componentPath: string;
+    /** Absolute path to the machine-readable sidecar for this diff. */
+    diffDataPath?: string;
+    images: {
+        baseline?: string;
+        current?: string;
+        diff?: string;
+    };
+    /** So a session running in the wrong repo can detect the mismatch. */
+    projectRoot: string;
+}
+export declare function buildHandoffPrompt(p: HandoffPayload): string;
+/**
+ * Describe a region in language a model reasons about well.
+ *
+ * Raw coordinates are precise but hard to reason over; "top-left, 2.3% of the
+ * viewport" carries the spatial meaning that actually drives the judgement.
+ * Both are given.
+ */
+export declare function describeRegion(r: ChangedRegion, viewport: Viewport): string;

package/dist/agent/handoff.js

@@ -0,0 +1,121 @@
+// Turn a failing story into a prompt an agent can act on.
+//
+// The central bet, inherited from the original tool and worth restating:
+// send STRUCTURED DATA, not screenshots. `mismatchPercent: 3.72` and a box at
+// (412, 88) are exact; an LLM's spatial reasoning over a PNG is probabilistic
+// and costs 10-50x the tokens. Images are listed last, as a fallback.
+//
+// Pure function. No I/O, no clipboard — string in, string out, so it is
+// trivially testable and callable from both the CLI and a server.
+export function buildHandoffPrompt(p) {
+    const lines = [];
+    lines.push(`# Visual change: ${p.storyTitle}`);
+    lines.push('');
+    lines.push(`Story \`${p.storyId}\` is **${p.status}**.`);
+    lines.push('');
+    if (p.status === 'new') {
+        lines.push('This story has no baseline yet — nothing to compare against. Decide whether', 'the rendered output is correct, then either approve it to establish the', 'baseline or fix the component first.', '', ...actions(p, { approveVerb: 'establish this as the baseline' }));
+        return lines.join('\n');
+    }
+    if (p.status === 'stale') {
+        lines.push('The baseline for this story was approved on a commit that is not an ancestor', 'of HEAD — most likely a branch that never merged. The pixels may well match;', 'the provenance is what is in question.', '', 'Re-run the capture first. If it then passes, re-approve to re-anchor the', 'baseline to the current history.', '', ...actions(p, { approveVerb: 're-anchor the baseline' }));
+        return lines.join('\n');
+    }
+    if (p.diffDataPath) {
+        lines.push(`Read \`${p.diffDataPath}\` for the full machine-readable diff.`, '');
+    }
+    lines.push('## What changed');
+    lines.push('');
+    lines.push('```json');
+    lines.push(JSON.stringify({
+        storyId: p.storyId,
+        mismatchPercent: round(p.mismatchPercent),
+        mismatchPixels: p.mismatchPixels,
+        viewport: p.viewport,
+        regionCount: p.changedRegions.length,
+    }, null, 2));
+    lines.push('```');
+    lines.push('');
+    if (p.changedRegions.length > 0) {
+        lines.push('## Where it changed');
+        lines.push('');
+        for (const r of p.changedRegions.slice(0, MAX_REGIONS)) {
+            lines.push(`- ${describeRegion(r, p.viewport)}`);
+        }
+        if (p.changedRegions.length > MAX_REGIONS) {
+            lines.push(`- …and ${p.changedRegions.length - MAX_REGIONS} more (see the diff data file)`);
+        }
+        lines.push('');
+    }
+    lines.push('## Assessment');
+    lines.push('');
+    lines.push(magnitudeHint(p.mismatchPercent));
+    lines.push('');
+    lines.push(...actions(p, { approveVerb: 'accept the new rendering' }));
+    if (p.images.baseline || p.images.current || p.images.diff) {
+        lines.push('');
+        lines.push('## Images (inspect only if the data above is insufficient)');
+        lines.push('');
+        if (p.images.baseline)
+            lines.push(`- baseline: \`${p.images.baseline}\``);
+        if (p.images.current)
+            lines.push(`- current: \`${p.images.current}\``);
+        if (p.images.diff)
+            lines.push(`- diff overlay: \`${p.images.diff}\``);
+    }
+    lines.push('');
+    lines.push('---');
+    lines.push(`Generated for \`${p.projectRoot}\`. If your session is rooted elsewhere, stop — this prompt is for a different repository.`);
+    return lines.join('\n');
+}
+const MAX_REGIONS = 12;
+function actions(p, opts) {
+    const out = ['## What to do', ''];
+    if (p.componentPath) {
+        out.push(`1. Inspect the component: \`${p.componentPath}\``, `2. Check recent history: \`git log -p -- ${p.componentPath}\``, '3. Decide: intentional change, or regression?');
+    }
+    else {
+        out.push('1. Locate the component behind this story.', '2. Check its recent history for an explanation.', '3. Decide: intentional change, or regression?');
+    }
+    out.push('', `- **Intentional** → \`jux approve --story ${p.storyId}\` to ${opts.approveVerb}.`, '- **Regression** → propose a fix. Do not apply it without confirmation.');
+    return out;
+}
+/**
+ * Describe a region in language a model reasons about well.
+ *
+ * Raw coordinates are precise but hard to reason over; "top-left, 2.3% of the
+ * viewport" carries the spatial meaning that actually drives the judgement.
+ * Both are given.
+ */
+export function describeRegion(r, viewport) {
+    const areaPct = ((r.width * r.height) / (viewport.width * viewport.height)) * 100;
+    const cx = r.x + r.width / 2;
+    const cy = r.y + r.height / 2;
+    const vertical = cy < viewport.height / 3
+        ? 'top'
+        : cy > (viewport.height * 2) / 3
+            ? 'bottom'
+            : 'middle';
+    const horizontal = cx < viewport.width / 3 ? 'left' : cx > (viewport.width * 2) / 3 ? 'right' : 'center';
+    return `(${r.x}, ${r.y}) ${r.width}×${r.height}px — ${vertical}-${horizontal}, ${round(areaPct)}% of viewport`;
+}
+/**
+ * Calibrate the agent's suspicion to the size of the change.
+ *
+ * Without this, agents treat a 0.02% antialiasing shift and a 40% layout
+ * collapse as equally alarming.
+ */
+function magnitudeHint(pct) {
+    if (pct < 0.1) {
+        return 'Under 0.1% — consistent with sub-pixel antialiasing noise. Usually safe to approve, but confirm the changed regions are not on meaningful content.';
+    }
+    if (pct < 1) {
+        return 'Under 1% — a small, localized change. Check whether the component or its tokens were recently touched.';
+    }
+    if (pct < 10) {
+        return 'Between 1% and 10% — a substantive visual change. Investigate before approving.';
+    }
+    return 'Over 10% — a large change, possibly a layout break or a failed render. Investigate carefully; do not approve without understanding the cause.';
+}
+const round = (n) => Math.round(n * 100) / 100;
+//# sourceMappingURL=handoff.js.map

package/dist/agent/handoff.js.map

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

package/dist/analysis/affected.d.ts

@@ -0,0 +1,19 @@
+import type { StoryManifest } from '../types.js';
+export interface AffectedOptions {
+    projectRoot: string;
+    /** Directories whose contents invalidate everything, from the platform
+     *  adapter (`.storybook`, `.ladle`, …). */
+    configDirs: string[];
+    /** Built workbench dir, for locating the Vite manifest. Omit for dev-server
+     *  mode, where no manifest exists on disk. */
+    buildDir?: string;
+    /** Explicit file list, bypassing git. Used by the HMR path and by tests. */
+    changedFiles?: string[];
+}
+export interface AffectedResult {
+    stories: StoryManifest[];
+    /** Why this set was chosen — surfaced in the report so a full run is never
+     *  mysterious. */
+    reason: 'no-baseline' | 'config-changed' | 'dependency-changed' | 'graph-walk' | 'no-match-fallback' | 'git-unavailable' | 'no-changes';
+}
+export declare function resolveAffected(stories: StoryManifest[], sinceCommit: string | null, opts: AffectedOptions): Promise<AffectedResult>;

package/dist/analysis/affected.js

@@ -0,0 +1,132 @@
+// Which stories does a change actually affect?
+//
+// Capturing 700 stories when 3 changed is the difference between a check
+// developers wait for and one they route around. But the failure modes are
+// asymmetric and that shapes every decision here:
+//
+//   false positive → a few seconds of wasted capture
+//   false negative → a visual regression ships
+//
+// So every uncertain path escalates to a full run. This module is deliberately
+// eager to give up.
+import { execFileSync } from 'node:child_process';
+import { readFile } from 'node:fs/promises';
+import path from 'node:path';
+const LOCKFILES = new Set([
+    'package.json',
+    'package-lock.json',
+    'yarn.lock',
+    'pnpm-lock.yaml',
+    'bun.lockb',
+]);
+export async function resolveAffected(stories, sinceCommit, opts) {
+    // No point of comparison — everything is affected.
+    if (sinceCommit === null && !opts.changedFiles) {
+        return { stories, reason: 'no-baseline' };
+    }
+    const changed = opts.changedFiles ?? gitChangedFiles(sinceCommit, opts.projectRoot);
+    if (changed === null)
+        return { stories, reason: 'git-unavailable' };
+    if (changed.length === 0)
+        return { stories: [], reason: 'no-changes' };
+    for (const file of changed) {
+        const base = file.split('/').pop() ?? file;
+        if (LOCKFILES.has(base) && !file.includes('/')) {
+            return { stories, reason: 'dependency-changed' };
+        }
+        if (opts.configDirs.some((dir) => file === dir || file.startsWith(dir + '/'))) {
+            return { stories, reason: 'config-changed' };
+        }
+    }
+    const manifest = opts.buildDir ? await loadViteManifest(opts.buildDir) : null;
+    if (!manifest) {
+        // Without a bundler graph we can't prove what's unaffected. Say so rather
+        // than guessing with filename heuristics.
+        return { stories, reason: 'no-match-fallback' };
+    }
+    const affected = walkDependents(buildReverseGraph(manifest), changed);
+    const matched = stories.filter((s) => {
+        const rel = toPosixRelative(opts.projectRoot, s.componentPath);
+        return affected.has(rel);
+    });
+    // Files changed but nothing matched — the change is outside the graph we
+    // know about. Could be a public asset, a global stylesheet, a util the
+    // manifest didn't record. Capture everything.
+    if (matched.length === 0)
+        return { stories, reason: 'no-match-fallback' };
+    return { stories: matched, reason: 'graph-walk' };
+}
+/**
+ * Build `imported → importers` from Vite's manifest.
+ *
+ * Vite's `imports[]` holds chunk keys, not source paths, so resolving an edge
+ * means mapping key → src first.
+ */
+function buildReverseGraph(manifest) {
+    const keyToSrc = new Map();
+    for (const [key, entry] of Object.entries(manifest)) {
+        if (entry.src)
+            keyToSrc.set(key, entry.src);
+    }
+    const reverse = new Map();
+    for (const entry of Object.values(manifest)) {
+        const importer = entry.src;
+        if (!importer)
+            continue;
+        for (const key of [...(entry.imports ?? []), ...(entry.dynamicImports ?? [])]) {
+            const imported = keyToSrc.get(key) ?? key;
+            let set = reverse.get(imported);
+            if (!set)
+                reverse.set(imported, (set = new Set()));
+            set.add(importer);
+        }
+    }
+    return reverse;
+}
+/** Transitive dependents, including the seeds themselves — a changed story
+ *  file is its own story's entry point. */
+function walkDependents(reverse, seeds) {
+    const seen = new Set();
+    const stack = [...seeds];
+    while (stack.length > 0) {
+        const file = stack.pop();
+        if (seen.has(file))
+            continue;
+        seen.add(file);
+        for (const dependent of reverse.get(file) ?? []) {
+            if (!seen.has(dependent))
+                stack.push(dependent);
+        }
+    }
+    return seen;
+}
+async function loadViteManifest(buildDir) {
+    for (const rel of ['.vite/manifest.json', 'manifest.json']) {
+        try {
+            return JSON.parse(await readFile(path.join(buildDir, rel), 'utf8'));
+        }
+        catch {
+            // try next
+        }
+    }
+    return null;
+}
+function gitChangedFiles(sinceCommit, cwd) {
+    try {
+        const out = execFileSync('git', ['diff', '--name-only', `${sinceCommit}..HEAD`], {
+            cwd,
+            encoding: 'utf8',
+        });
+        return out
+            .split('\n')
+            .map((s) => s.trim())
+            .filter(Boolean);
+    }
+    catch {
+        return null;
+    }
+}
+function toPosixRelative(root, abs) {
+    return path.relative(root, abs).split(path.sep).join('/');
+}
+//# sourceMappingURL=affected.js.map

package/dist/analysis/affected.js.map

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

package/dist/baseline/git-store.d.ts

@@ -0,0 +1,26 @@
+import type { ApprovalMeta, BaselineManifest, BaselineStore } from '../types.js';
+export interface GitStoreOptions {
+    projectRoot: string;
+    /** Where baseline images live, relative to projectRoot. */
+    dir?: string;
+}
+export declare class GitBaselineStore implements BaselineStore {
+    private readonly imageDir;
+    private readonly manifestPath;
+    constructor(opts: GitStoreOptions);
+    private imagePath;
+    get(storyId: string): Promise<Buffer | null>;
+    put(storyId: string, image: Buffer, meta: ApprovalMeta): Promise<void>;
+    remove(storyId: string): Promise<void>;
+    readManifest(): Promise<BaselineManifest>;
+    writeManifest(manifest: BaselineManifest): Promise<void>;
+}
+/**
+ * Make a story id safe as a single path segment.
+ *
+ * Story ids come from the platform and are usually kebab-case, but that is an
+ * assumption, not a guarantee — the original tool interpolated them raw into
+ * S3 keys and file paths. A `/` or `..` in an id would escape the baseline
+ * directory, so encode anything outside a conservative allowlist.
+ */
+export declare function encodeStoryId(storyId: string): string;

package/dist/baseline/git-store.js

@@ -0,0 +1,95 @@
+// Git-backed baseline store — the default.
+//
+// Baselines are WebP files committed under .juxtapose/baselines/. No bucket to
+// provision, no credentials, and the tool does something useful the moment it
+// is installed.
+//
+// Three properties fall out of this that a bucket does not give you:
+//   - Approving a baseline is a reviewable diff in the PR that changed it.
+//   - Branches get correct baselines by construction: checking out a branch
+//     checks out its baselines. No branch-keyed prefixes, no fallback-to-main.
+//   - Reverting a bad approval is `git revert`.
+//
+// The cost is repo size. WebP at quality 90 keeps a 1280x800 story around
+// 30-60KB; a 700-story suite is tens of megabytes. Real, but tolerable, and
+// the S3 store exists for suites where it isn't.
+import { readFile, writeFile, mkdir, rm } from 'node:fs/promises';
+import { existsSync } from 'node:fs';
+import path from 'node:path';
+import { hashImage } from './status.js';
+const MANIFEST_NAME = 'juxtapose.manifest.json';
+const EMPTY = { version: 1, baselines: {} };
+export class GitBaselineStore {
+    imageDir;
+    manifestPath;
+    constructor(opts) {
+        this.imageDir = path.join(opts.projectRoot, opts.dir ?? '.juxtapose/baselines');
+        this.manifestPath = path.join(opts.projectRoot, MANIFEST_NAME);
+    }
+    imagePath(storyId) {
+        return path.join(this.imageDir, `${encodeStoryId(storyId)}.webp`);
+    }
+    async get(storyId) {
+        try {
+            return await readFile(this.imagePath(storyId));
+        }
+        catch {
+            return null;
+        }
+    }
+    async put(storyId, image, meta) {
+        await mkdir(this.imageDir, { recursive: true });
+        await writeFile(this.imagePath(storyId), image);
+        const manifest = await this.readManifest();
+        manifest.baselines[storyId] = { ...meta, hash: hashImage(image) };
+        await this.writeManifest(manifest);
+    }
+    async remove(storyId) {
+        await rm(this.imagePath(storyId), { force: true });
+        const manifest = await this.readManifest();
+        delete manifest.baselines[storyId];
+        await this.writeManifest(manifest);
+    }
+    async readManifest() {
+        if (!existsSync(this.manifestPath))
+            return structuredClone(EMPTY);
+        try {
+            const parsed = JSON.parse(await readFile(this.manifestPath, 'utf8'));
+            if (parsed?.version !== 1 || typeof parsed.baselines !== 'object') {
+                return structuredClone(EMPTY);
+            }
+            return parsed;
+        }
+        catch {
+            // A corrupt manifest means every story reads as `new`, which is loud and
+            // recoverable. Throwing here would block the run entirely.
+            return structuredClone(EMPTY);
+        }
+    }
+    async writeManifest(manifest) {
+        // Sort keys so the committed file produces a minimal, readable git diff —
+        // the whole point of storing baselines in the repo.
+        const sorted = { version: 1, baselines: {} };
+        for (const id of Object.keys(manifest.baselines).sort()) {
+            sorted.baselines[id] = manifest.baselines[id];
+        }
+        await writeFile(this.manifestPath, JSON.stringify(sorted, null, 2) + '\n');
+    }
+}
+/**
+ * Make a story id safe as a single path segment.
+ *
+ * Story ids come from the platform and are usually kebab-case, but that is an
+ * assumption, not a guarantee — the original tool interpolated them raw into
+ * S3 keys and file paths. A `/` or `..` in an id would escape the baseline
+ * directory, so encode anything outside a conservative allowlist.
+ */
+export function encodeStoryId(storyId) {
+    // `.` is deliberately NOT in the allowlist. Escaping only separators would
+    // leave `..` intact, which cannot traverse without a `/` but still yields
+    // filenames that read as relative paths — a trap for anything downstream
+    // that joins, splits, or normalizes them. Encoding every dot makes the
+    // result inert by construction rather than by argument.
+    return storyId.replace(/[^a-zA-Z0-9_-]/g, (c) => '%' + c.charCodeAt(0).toString(16).padStart(2, '0'));
+}
+//# sourceMappingURL=git-store.js.map

package/dist/baseline/git-store.js.map

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

package/dist/baseline/status.d.ts

@@ -0,0 +1,22 @@
+import type { BaselineManifest, DiffStatus } from '../types.js';
+export type BaselineStatus = 'pass' | 'new' | 'changed' | 'stale';
+/** Hash the stored representation, not an intermediate.
+ *
+ *  Always the WebP bytes — never the PNG. The WebP is what gets persisted, so
+ *  hashing it means the hash is reproducible from stored artifacts alone. */
+export declare function hashImage(webp: Buffer): string;
+export interface AncestryCheck {
+    /** True if `commit` is an ancestor of HEAD. */
+    isAncestor(commit: string): boolean;
+}
+/**
+ * Resolve one story's status against the manifest.
+ *
+ * `stale` is the subtle one: a baseline approved on a branch that never merged
+ * is not a valid baseline for HEAD, even though the bytes match. Without this
+ * check, an abandoned branch's approvals silently become the truth.
+ */
+export declare function resolveStatus(storyId: string, webp: Buffer, manifest: BaselineManifest, ancestry?: AncestryCheck): BaselineStatus;
+/** Map baseline status onto the reported diff status. Single definition —
+ *  the original had this mapping written out in three places. */
+export declare function toDiffStatus(status: BaselineStatus): DiffStatus;

package/dist/baseline/status.js

@@ -0,0 +1,49 @@
+// Pass/fail authority.
+//
+// A story passes if its captured bytes hash to the same value the manifest
+// recorded at approval time. Byte-exact — there is no threshold to hide behind,
+// which is why capture determinism gets the attention it does elsewhere in this
+// package.
+//
+// This module MUST NOT write to disk. It is called once per story per run and
+// is the hot path on a green run.
+import { createHash } from 'node:crypto';
+/** Hash the stored representation, not an intermediate.
+ *
+ *  Always the WebP bytes — never the PNG. The WebP is what gets persisted, so
+ *  hashing it means the hash is reproducible from stored artifacts alone. */
+export function hashImage(webp) {
+    return createHash('sha256').update(webp).digest('hex');
+}
+/**
+ * Resolve one story's status against the manifest.
+ *
+ * `stale` is the subtle one: a baseline approved on a branch that never merged
+ * is not a valid baseline for HEAD, even though the bytes match. Without this
+ * check, an abandoned branch's approvals silently become the truth.
+ */
+export function resolveStatus(storyId, webp, manifest, ancestry) {
+    const entry = manifest.baselines[storyId];
+    if (!entry)
+        return 'new';
+    if (entry.hash !== hashImage(webp))
+        return 'changed';
+    if (ancestry && !ancestry.isAncestor(entry.commit))
+        return 'stale';
+    return 'pass';
+}
+/** Map baseline status onto the reported diff status. Single definition —
+ *  the original had this mapping written out in three places. */
+export function toDiffStatus(status) {
+    switch (status) {
+        case 'pass':
+            return 'pass';
+        case 'changed':
+            return 'fail';
+        case 'stale':
+            return 'stale';
+        case 'new':
+            return 'new';
+    }
+}
+//# sourceMappingURL=status.js.map

package/dist/baseline/status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.js","sourceRoot":"","sources":["../../src/baseline/status.ts"],"names":[],"mappings":"AAAA,uBAAuB;AACvB,EAAE;AACF,2EAA2E;AAC3E,gFAAgF;AAChF,gFAAgF;AAChF,WAAW;AACX,EAAE;AACF,8EAA8E;AAC9E,kCAAkC;AAElC,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAKzC;;;6EAG6E;AAC7E,MAAM,UAAU,SAAS,CAAC,IAAY;IACpC,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AACzD,CAAC;AAOD;;;;;;GAMG;AACH,MAAM,UAAU,aAAa,CAC3B,OAAe,EACf,IAAY,EACZ,QAA0B,EAC1B,QAAwB;IAExB,MAAM,KAAK,GAAG,QAAQ,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IAC1C,IAAI,CAAC,KAAK;QAAE,OAAO,KAAK,CAAC;IACzB,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS,CAAC,IAAI,CAAC;QAAE,OAAO,SAAS,CAAC;IACrD,IAAI,QAAQ,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,KAAK,CAAC,MAAM,CAAC;QAAE,OAAO,OAAO,CAAC;IACnE,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;iEACiE;AACjE,MAAM,UAAU,YAAY,CAAC,MAAsB;IACjD,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,MAAM;YACT,OAAO,MAAM,CAAC;QAChB,KAAK,SAAS;YACZ,OAAO,MAAM,CAAC;QAChB,KAAK,OAAO;YACV,OAAO,OAAO,CAAC;QACjB,KAAK,KAAK;YACR,OAAO,KAAK,CAAC;IACjB,CAAC;AACH,CAAC"}

package/dist/capture/capture.d.ts

@@ -0,0 +1,32 @@
+import type { Page } from 'playwright';
+import type { Platform } from '../platform.js';
+import type { Snapshot, StoryManifest, Viewport } from '../types.js';
+export interface CaptureDeps {
+    platform: Platform;
+    baseUrl: string;
+    /** WebP encode effort, 0-6. Higher is smaller and slower. Capture is
+     *  browser-bound, so 0 is the right default — the bytes are transient. */
+    webpEffort?: number;
+    /**
+     * Reuse a warm page and switch stories over the platform's channel instead
+     * of navigating. Roughly 4x faster per story.
+     *
+     * OFF BY DEFAULT, and that is a deliberate, measured decision rather than
+     * caution. A warm switch does not reproduce a cold load's pixels exactly:
+     * the previous story leaves residue — retained style and layout state,
+     * settled transitions, a different paint history — and the same story
+     * captured warm differs from the same story captured cold by a handful of
+     * antialiased pixels.
+     *
+     * Each path is internally stable. They just disagree with each other. Under
+     * a byte-exact hash that makes a story's verdict depend on where it happened
+     * to land in the shuffled work queue, which is to say: random. Measured on a
+     * 16-story suite, 1-4 stories failed per run purely from queue order.
+     *
+     * The speed is real and worth having, so this is not abandoned — see the
+     * tracking issue. But correctness is not negotiable against it, and a
+     * visual test that cries wolf is worse than a slow one.
+     */
+    warmSwitch?: boolean;
+}
+export declare function captureStory(page: Page, story: StoryManifest, deps: CaptureDeps, viewport: Viewport): Promise<Snapshot | null>;