looply-cli 0.5.12 → 0.5.14

package/dist/visual-proof-scope.js

@@ -0,0 +1,205 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isUiFile = isUiFile;
+exports.touchedApps = touchedApps;
+exports.readRouter = readRouter;
+exports.pickRoutes = pickRoutes;
+const node_path_1 = require("node:path");
+const glob_1 = require("./glob");
+/**
+ * WHICH APPS A CHANGE TOUCHED, AND WHICH OF THEIR SCREENS TO SHOW.
+ *
+ * Pure: the changed paths, the ticket's words and the router's source text go
+ * in; a short ordered list of screens comes out. In order of how sure it is:
+ *
+ *   1. a configured route whose `when` matches a changed file;
+ *   2. a route whose page component IS a changed file, read from the app's router
+ *      (`<Route path="orders" element={<Orders />} />` and the import naming it);
+ *   3. a configured or routed screen whose name the ticket says ("the sidebar on
+ *      the dashboard" → dashboard);
+ *   4. the configured routes with no `when`, which a project lists as the screens
+ *      that show its shell — a sidebar or header change shows on all of them.
+ *
+ * Capped at `max_routes`. An app with no screen found shows its root.
+ */
+/** File types that change what a person sees. A change touching none of them shows nothing new. */
+const UI_FILE = /\.(tsx|jsx|vue|svelte|astro|html?|css|scss|sass|less|styl|svg|png|jpe?g|gif|webp|ico|woff2?|ttf|json|ts|js|mjs|cjs)$/i;
+/** Files that never change a screen, even inside an app folder. */
+const NOT_UI = /(^|\/)(__tests__|__mocks__|test|tests|e2e|spec)\/|\.(test|spec|stories)\.[a-z]+$|(^|\/)(package-lock\.json|tsconfig[^/]*\.json|vitest\.config\.[a-z]+|jest\.config\.[a-z]+|README[^/]*)$/i;
+function isUiFile(path) {
+    return UI_FILE.test(path) && !NOT_UI.test(path);
+}
+/** The apps a set of changed paths touches with UI files. */
+function touchedApps(cfg, changedPaths) {
+    if (!cfg.enabled)
+        return [];
+    const out = [];
+    for (const app of cfg.apps) {
+        const when = app.when.length > 0 ? app.when : ['**'];
+        const changed = changedPaths.filter((p) => isUiFile(p) && when.some((g) => (0, glob_1.matchesGlob)(p, g)));
+        if (changed.length > 0)
+            out.push({ app, changed });
+    }
+    return out;
+}
+/**
+ * The screens a React Router file declares, best effort. Reads `<Route path=… element={<X`
+ * (nested layout routes contribute their path), and resolves `X` through a static
+ * `import X from '…'`, `import { X } from '…'`, or `const X = lazy(() => import('…'))`
+ * (any wrapper whose argument is `() => import('…')`). Parameterised paths are left out:
+ * nobody can screenshot `orders/:id` without an id.
+ */
+function readRouter(source, routerPath) {
+    const imports = new Map();
+    const dir = node_path_1.posix.dirname(routerPath.replace(/\\/g, '/'));
+    const resolve = (spec) => (spec.startsWith('.') ? node_path_1.posix.normalize(node_path_1.posix.join(dir, spec)).replace(/\.(tsx?|jsx?)$/, '') : null);
+    for (const m of source.matchAll(/import\s+([A-Za-z_$][\w$]*)\s*(?:,\s*\{[^}]*\})?\s*from\s*['"]([^'"]+)['"]/g)) {
+        const r = resolve(m[2]);
+        if (r !== null)
+            imports.set(m[1], r);
+    }
+    for (const m of source.matchAll(/import\s*\{([^}]*)\}\s*from\s*['"]([^'"]+)['"]/g)) {
+        const r = resolve(m[2]);
+        if (r === null)
+            continue;
+        for (const part of m[1].split(',')) {
+            const name = part.trim().split(/\s+as\s+/).pop()?.trim();
+            if (name)
+                imports.set(name, r);
+        }
+    }
+    for (const m of source.matchAll(/(?:const|let|var)\s+([A-Za-z_$][\w$]*)\s*=\s*[\w$.]*\s*\(\s*\(\s*\)\s*=>\s*import\(\s*['"]([^'"]+)['"]\s*\)/g)) {
+        const r = resolve(m[2]);
+        if (r !== null)
+            imports.set(m[1], r);
+    }
+    const pages = [];
+    const stack = [];
+    for (const t of routeTags(source)) {
+        if (t.close) {
+            stack.pop();
+            continue;
+        }
+        const { attrs, selfClosing } = t;
+        const p = /\bpath\s*=\s*(?:"([^"]*)"|'([^']*)'|\{\s*['"]([^'"]*)['"]\s*\})/.exec(attrs);
+        const raw = p ? (p[1] ?? p[2] ?? p[3] ?? '') : '';
+        const own = raw.replace(/^\/+|\/+$/g, '');
+        const full = (raw.startsWith('/') ? own : [...stack, own].filter((s) => s !== '').join('/')).replace(/\/\*$/, '').replace(/^\*$/, '');
+        // Every component the element renders — `<RequireAuth><AppShell /></RequireAuth>` is AppShell's
+        // route as much as RequireAuth's — and the first one imported from this app names its module.
+        const el = /\belement\s*=\s*\{([\s\S]*)\}/.exec(attrs);
+        const names = el === null ? [] : [...el[1].matchAll(/<\s*([A-Z][\w$]*)/g)].map((x) => x[1]);
+        const shown = names.find((n) => imports.has(n)) ?? names[0];
+        if (shown !== undefined && !full.includes(':') && !full.includes('*')) {
+            pages.push({ path: full, component: shown, module: imports.get(shown) ?? null, layout: !selfClosing });
+        }
+        if (!selfClosing)
+            stack.push(raw.startsWith('/') ? own : [...stack, own].filter((s) => s !== '').join('/'));
+    }
+    return pages;
+}
+/**
+ * `<Route …>` / `<Route … />` / `</Route>` in source order. The attributes are read with
+ * brace depth tracked, because `element={<Orders />}` itself contains `/>`.
+ */
+function routeTags(source) {
+    const out = [];
+    const re = /<\/Route\s*>|<Route\b/g;
+    let m;
+    while ((m = re.exec(source)) !== null) {
+        if (m[0].startsWith('</')) {
+            out.push({ close: true });
+            continue;
+        }
+        let depth = 0;
+        let quote = null;
+        let i = m.index + m[0].length;
+        for (; i < source.length; i++) {
+            const c = source[i];
+            if (quote !== null) {
+                if (c === quote)
+                    quote = null;
+                continue;
+            }
+            if (c === '"' || c === "'" || c === '`')
+                quote = c;
+            else if (c === '{')
+                depth++;
+            else if (c === '}')
+                depth--;
+            else if (c === '>' && depth === 0)
+                break;
+        }
+        const attrs = source.slice(m.index + m[0].length, i);
+        out.push({ close: false, attrs, selfClosing: /\/\s*$/.test(attrs) });
+        re.lastIndex = i + 1;
+    }
+    return out;
+}
+const words = (s) => s
+    .toLowerCase()
+    .replace(/([a-z])([A-Z])/g, '$1 $2')
+    .split(/[^a-z0-9]+/)
+    .filter((w) => w.length >= 3);
+/** Does the ticket's wording name this screen? Every word of the screen's name or last path segment. */
+function named(goalWords, route) {
+    const last = route.path.split('/').filter(Boolean).pop() ?? '';
+    for (const cand of [route.name, last]) {
+        const ws = words(cand);
+        if (ws.length > 0 && ws.every((w) => goalWords.has(w) || goalWords.has(w.replace(/s$/, '')) || goalWords.has(`${w}s`)))
+            return true;
+    }
+    return false;
+}
+const stem = (p) => p.replace(/\\/g, '/').replace(/\.(tsx?|jsx?|vue|svelte)$/i, '').replace(/\/index$/, '');
+/** The screens to capture for one touched app. */
+function pickRoutes(input) {
+    const { app, changed } = input;
+    const chosen = [];
+    const why = [];
+    const add = (r, because) => {
+        if (chosen.length >= input.maxRoutes || chosen.some((c) => c.path === r.path))
+            return;
+        chosen.push(r);
+        why.push(`${r.name || r.path || 'home'}: ${because}`);
+    };
+    for (const r of app.routes) {
+        const hit = r.when.length > 0 ? changed.find((p) => r.when.some((g) => (0, glob_1.matchesGlob)(p, g))) : undefined;
+        if (hit !== undefined)
+            add(r, `configured for ${hit}`);
+    }
+    const routed = input.routerSource !== null && app.router !== null ? readRouter(input.routerSource, app.router) : [];
+    const changedStems = changed.map(stem);
+    const screens = routed.filter((p) => !p.layout);
+    for (const page of routed) {
+        const mod = page.module;
+        if (mod === null)
+            continue;
+        // The page module itself, a folder of that name, or a sibling like `Orders.parts.tsx`.
+        const hit = changedStems.find((c) => c === mod || c.startsWith(`${mod}/`) || ((0, node_path_1.dirname)(mod) !== '.' && c.startsWith(`${mod}.`)));
+        if (hit === undefined)
+            continue;
+        if (!page.layout) {
+            add({ path: page.path, name: page.component, when: [] }, `its page ${page.component} changed`);
+            continue;
+        }
+        // A shell changed: it is on every screen under it. The project's own screens first, then the first ones routed.
+        const under = (r) => page.path === '' || r.path === page.path || r.path.startsWith(`${page.path}/`);
+        const listed = app.routes.filter((r) => r.when.length === 0 && under(r));
+        const fallback = screens.filter((x) => x.path !== '' && under(x)).slice(0, 2).map((x) => ({ path: x.path, name: x.component, when: [] }));
+        for (const r of listed.length > 0 ? listed : fallback)
+            add(r, `${page.component}, shown on every screen under /${page.path}, changed`);
+    }
+    const goalWords = new Set(words(input.goalText));
+    for (const r of [...app.routes, ...screens.map((p) => ({ path: p.path, name: p.component, when: [] }))]) {
+        if (named(goalWords, r))
+            add(r, 'the ticket names it');
+    }
+    for (const r of app.routes)
+        if (r.when.length === 0)
+            add(r, 'a configured screen');
+    if (chosen.length === 0)
+        add({ path: '', name: 'home', when: [] }, 'the app’s first screen (nothing more specific was found)');
+    return { app, changed, routes: chosen, why };
+}
+//# sourceMappingURL=visual-proof-scope.js.map

package/dist/visual-proof-scope.js.map

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

package/dist/visual-proof-serve.d.ts

@@ -0,0 +1,11 @@
+export interface StaticSite {
+    /** `http://127.0.0.1:<port>` */
+    readonly origin: string;
+    close(): Promise<void>;
+}
+export declare function serveStatic(input: {
+    root: string;
+    mount: string;
+    spa: boolean;
+}): Promise<StaticSite>;
+//# sourceMappingURL=visual-proof-serve.d.ts.map

package/dist/visual-proof-serve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"visual-proof-serve.d.ts","sourceRoot":"","sources":["../src/visual-proof-serve.ts"],"names":[],"mappings":"AAwCA,MAAM,WAAW,UAAU;IACzB,gCAAgC;IAChC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED,wBAAsB,WAAW,CAAC,KAAK,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,OAAO,CAAA;CAAE,GAAG,OAAO,CAAC,UAAU,CAAC,CAoD3G"}

package/dist/visual-proof-serve.js

@@ -0,0 +1,100 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.serveStatic = serveStatic;
+const node_fs_1 = require("node:fs");
+const node_http_1 = require("node:http");
+const node_path_1 = require("node:path");
+/**
+ * LOOPLY'S OWN STATIC SERVER FOR A BUILT APP.
+ *
+ * The app was built in the sandbox; its output is plain files. Serving them is
+ * Looply's job, not the project's: no project script runs on the host to do it,
+ * so nothing the change wrote can reach the network or the disk from here.
+ *
+ *   - binds 127.0.0.1 on a free port, nothing else;
+ *   - serves only files under `root` (resolved through links), read-only, GET/HEAD;
+ *   - the app lives under `mount` (`/admin/`); an unknown path under it gets
+ *     `index.html` when `spa` (client-side routing), else 404;
+ *   - everything else is 404 — API calls never reach here, the browser answers them.
+ */
+const TYPES = {
+    '.html': 'text/html; charset=utf-8',
+    '.js': 'text/javascript; charset=utf-8',
+    '.mjs': 'text/javascript; charset=utf-8',
+    '.css': 'text/css; charset=utf-8',
+    '.json': 'application/json; charset=utf-8',
+    '.webmanifest': 'application/manifest+json',
+    '.svg': 'image/svg+xml',
+    '.png': 'image/png',
+    '.jpg': 'image/jpeg',
+    '.jpeg': 'image/jpeg',
+    '.gif': 'image/gif',
+    '.webp': 'image/webp',
+    '.ico': 'image/x-icon',
+    '.woff': 'font/woff',
+    '.woff2': 'font/woff2',
+    '.ttf': 'font/ttf',
+    '.txt': 'text/plain; charset=utf-8',
+    '.map': 'application/json',
+};
+async function serveStatic(input) {
+    if (!(0, node_fs_1.existsSync)(input.root) || !(0, node_fs_1.statSync)(input.root).isDirectory())
+        throw new Error(`the built app is not at ${input.root}`);
+    const root = (0, node_fs_1.realpathSync)(input.root);
+    const mount = input.mount.endsWith('/') ? input.mount : `${input.mount}/`;
+    const index = (0, node_path_1.join)(root, 'index.html');
+    const server = (0, node_http_1.createServer)((req, res) => {
+        const send = (code, body = '') => {
+            res.writeHead(code, { 'content-type': 'text/plain; charset=utf-8', 'cache-control': 'no-store' });
+            res.end(body);
+        };
+        if (req.method !== 'GET' && req.method !== 'HEAD')
+            return send(405);
+        let path;
+        try {
+            path = decodeURIComponent(new URL(req.url ?? '/', 'http://x').pathname);
+        }
+        catch {
+            return send(400);
+        }
+        if (path === mount.slice(0, -1))
+            path = mount;
+        if (!path.startsWith(mount))
+            return send(404);
+        const rel = path.slice(mount.length);
+        let file = (0, node_path_1.resolve)(root, rel === '' ? 'index.html' : rel);
+        if (file !== root && !file.startsWith(root + node_path_1.sep))
+            return send(404);
+        let ok = (0, node_fs_1.existsSync)(file) && (0, node_fs_1.statSync)(file).isFile();
+        if (ok) {
+            // A link inside the output must not lead out of it.
+            const real = (0, node_fs_1.realpathSync)(file);
+            if (real !== root && !real.startsWith(root + node_path_1.sep))
+                return send(404);
+            file = real;
+        }
+        else if (input.spa && (0, node_path_1.extname)(rel) === '' && (0, node_fs_1.existsSync)(index)) {
+            file = index;
+            ok = true;
+        }
+        if (!ok)
+            return send(404);
+        res.writeHead(200, { 'content-type': TYPES[(0, node_path_1.extname)(file).toLowerCase()] ?? 'application/octet-stream', 'cache-control': 'no-store' });
+        if (req.method === 'HEAD')
+            return res.end();
+        (0, node_fs_1.createReadStream)(file).pipe(res);
+    });
+    await new Promise((ok, fail) => {
+        server.once('error', fail);
+        server.listen(0, '127.0.0.1', () => ok());
+    });
+    const port = server.address().port;
+    return {
+        origin: `http://127.0.0.1:${port}`,
+        close: () => new Promise((ok) => {
+            server.closeAllConnections?.();
+            server.close(() => ok());
+        }),
+    };
+}
+//# sourceMappingURL=visual-proof-serve.js.map

package/dist/visual-proof-serve.js.map

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

package/dist/visual-proof-store.d.ts

@@ -0,0 +1,76 @@
+/**
+ * WHERE SCREENSHOTS ARE KEPT, AND HOW MUCH.
+ *
+ * Under the machine's workspaces folder (the one AutoRyn or `machine-settings.json`
+ * names — `D:\looply-home\workspaces` on the owner's PC), never the home drive:
+ *
+ *     <workspaces>/visual-proof/<project key>/<goal or "adhoc">/<head sha 12>/
+ *         manifest.json   frames/…jpg   sheets/…jpg
+ *
+ * The whole `visual-proof` folder is held under a cap (`visual_proof.max_mb`,
+ * default 2 GB). After each capture the oldest captures are deleted until it
+ * fits — never the one just made.
+ */
+export declare const PROOF_DIR = "visual-proof";
+export declare const MANIFEST = "manifest.json";
+export type Side = 'base' | 'head';
+export interface Shot {
+    readonly file: string;
+    readonly app: string;
+    readonly route: string;
+    readonly routeName: string;
+    readonly side: Side;
+    readonly viewport: string;
+    readonly theme: 'light' | 'dark';
+    readonly dir: 'ltr' | 'rtl';
+    readonly ok: boolean;
+    readonly because?: string;
+    /** Taken, but something the project said to wait for never appeared. */
+    readonly warning?: string;
+}
+export interface Sheet {
+    readonly file: string;
+    readonly app: string;
+    readonly route: string;
+    readonly label: string;
+    readonly bytes: number;
+}
+export interface ProofManifest {
+    readonly schema: 1;
+    readonly goalId: string | null;
+    readonly project: string;
+    readonly baseSha: string;
+    readonly headSha: string;
+    readonly createdAt: string;
+    readonly apps: ReadonlyArray<{
+        readonly name: string;
+        readonly routes: ReadonlyArray<{
+            path: string;
+            name: string;
+        }>;
+        readonly why: readonly string[];
+        readonly built: {
+            readonly base: string;
+            readonly head: string;
+        };
+    }>;
+    readonly shots: readonly Shot[];
+    readonly sheets: readonly Sheet[];
+    /** What could not be shown, in words. */
+    readonly notes: readonly string[];
+}
+export declare function projectKey(projectDir: string): string;
+export declare function captureDir(base: string, project: string, goalId: string | null, headSha: string): string;
+export declare function writeManifest(dir: string, m: ProofManifest): void;
+export declare function readManifest(dir: string): ProofManifest | null;
+/** The newest capture for a goal (any head), or for exactly `headSha` when given. */
+export declare function findCapture(base: string, project: string, goalId: string, headSha?: string): {
+    dir: string;
+    manifest: ProofManifest;
+} | null;
+/**
+ * Delete the oldest captures until the whole store fits in `maxMb`. Returns what was removed.
+ * A capture is a folder holding a manifest; `keep` is never removed.
+ */
+export declare function enforceCap(base: string, maxMb: number, keep: string | null): string[];
+//# sourceMappingURL=visual-proof-store.d.ts.map

package/dist/visual-proof-store.d.ts.map

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

package/dist/visual-proof-store.js

@@ -0,0 +1,117 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MANIFEST = exports.PROOF_DIR = void 0;
+exports.projectKey = projectKey;
+exports.captureDir = captureDir;
+exports.writeManifest = writeManifest;
+exports.readManifest = readManifest;
+exports.findCapture = findCapture;
+exports.enforceCap = enforceCap;
+const node_crypto_1 = require("node:crypto");
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+/**
+ * WHERE SCREENSHOTS ARE KEPT, AND HOW MUCH.
+ *
+ * Under the machine's workspaces folder (the one AutoRyn or `machine-settings.json`
+ * names — `D:\looply-home\workspaces` on the owner's PC), never the home drive:
+ *
+ *     <workspaces>/visual-proof/<project key>/<goal or "adhoc">/<head sha 12>/
+ *         manifest.json   frames/…jpg   sheets/…jpg
+ *
+ * The whole `visual-proof` folder is held under a cap (`visual_proof.max_mb`,
+ * default 2 GB). After each capture the oldest captures are deleted until it
+ * fits — never the one just made.
+ */
+exports.PROOF_DIR = 'visual-proof';
+exports.MANIFEST = 'manifest.json';
+function projectKey(projectDir) {
+    return (0, node_crypto_1.createHash)('sha256').update(projectDir.replace(/\\/g, '/').toLowerCase()).digest('hex').slice(0, 16);
+}
+function captureDir(base, project, goalId, headSha) {
+    const goal = goalId !== null && /^[A-Za-z0-9_-]{1,80}$/.test(goalId) ? goalId : 'adhoc';
+    return (0, node_path_1.join)(base, exports.PROOF_DIR, project, goal, headSha.slice(0, 12));
+}
+function writeManifest(dir, m) {
+    (0, node_fs_1.mkdirSync)(dir, { recursive: true });
+    const tmp = (0, node_path_1.join)(dir, `${exports.MANIFEST}.${process.pid}.tmp`);
+    (0, node_fs_1.writeFileSync)(tmp, `${JSON.stringify(m, null, 2)}\n`, 'utf8');
+    (0, node_fs_1.renameSync)(tmp, (0, node_path_1.join)(dir, exports.MANIFEST));
+}
+function readManifest(dir) {
+    try {
+        const m = JSON.parse((0, node_fs_1.readFileSync)((0, node_path_1.join)(dir, exports.MANIFEST), 'utf8'));
+        return m.schema === 1 && Array.isArray(m.shots) ? m : null;
+    }
+    catch {
+        return null;
+    }
+}
+/** The newest capture for a goal (any head), or for exactly `headSha` when given. */
+function findCapture(base, project, goalId, headSha) {
+    const goalDir = (0, node_path_1.join)(base, exports.PROOF_DIR, project, goalId);
+    if (!(0, node_fs_1.existsSync)(goalDir))
+        return null;
+    const dirs = (0, node_fs_1.readdirSync)(goalDir)
+        .filter((d) => headSha === undefined || d === headSha.slice(0, 12))
+        .map((d) => (0, node_path_1.join)(goalDir, d));
+    let best = null;
+    for (const dir of dirs) {
+        const manifest = readManifest(dir);
+        if (manifest === null)
+            continue;
+        const at = Date.parse(manifest.createdAt) || 0;
+        if (best === null || at > best.at)
+            best = { dir, manifest, at };
+    }
+    return best === null ? null : { dir: best.dir, manifest: best.manifest };
+}
+function sizeOf(path) {
+    let total = 0;
+    const st = (0, node_fs_1.statSync)(path, { throwIfNoEntry: false });
+    if (st === undefined)
+        return 0;
+    if (st.isFile())
+        return st.size;
+    if (!st.isDirectory())
+        return 0;
+    for (const e of (0, node_fs_1.readdirSync)(path))
+        total += sizeOf((0, node_path_1.join)(path, e));
+    return total;
+}
+/**
+ * Delete the oldest captures until the whole store fits in `maxMb`. Returns what was removed.
+ * A capture is a folder holding a manifest; `keep` is never removed.
+ */
+function enforceCap(base, maxMb, keep) {
+    const root = (0, node_path_1.join)(base, exports.PROOF_DIR);
+    if (!(0, node_fs_1.existsSync)(root))
+        return [];
+    const captures = [];
+    const walk = (dir, depth) => {
+        if ((0, node_fs_1.existsSync)((0, node_path_1.join)(dir, exports.MANIFEST))) {
+            captures.push({ dir, bytes: sizeOf(dir), at: (0, node_fs_1.statSync)((0, node_path_1.join)(dir, exports.MANIFEST)).mtimeMs });
+            return;
+        }
+        if (depth > 3)
+            return;
+        for (const e of (0, node_fs_1.readdirSync)(dir, { withFileTypes: true }))
+            if (e.isDirectory())
+                walk((0, node_path_1.join)(dir, e.name), depth + 1);
+    };
+    walk(root, 0);
+    let total = captures.reduce((n, c) => n + c.bytes, 0);
+    const limit = maxMb * 1024 * 1024;
+    const removed = [];
+    for (const c of captures.sort((a, b) => a.at - b.at)) {
+        if (total <= limit)
+            break;
+        if (keep !== null && c.dir === keep)
+            continue;
+        (0, node_fs_1.rmSync)(c.dir, { recursive: true, force: true });
+        total -= c.bytes;
+        removed.push(c.dir);
+    }
+    return removed;
+}
+//# sourceMappingURL=visual-proof-store.js.map

package/dist/visual-proof-store.js.map

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

package/dist/visual-proof.d.ts

@@ -0,0 +1,87 @@
+import type { CommandRunner } from './gate';
+import { type GitExec } from './git-driver';
+import { type CaptureEngine } from './visual-proof-browser';
+import { type ProofApp, type Viewport, type VisualProofConfig } from './visual-proof-config';
+import { type ProofManifest } from './visual-proof-store';
+/**
+ * BEFORE AND AFTER SCREENSHOTS OF A UI CHANGE.
+ *
+ * ─────────────────────────────────────────────────────────────────────────────
+ * Given a checkout, a base commit and a head commit:
+ *
+ *   1. the changed files decide which configured apps were touched (none: no proof,
+ *      and nothing is built — a change to the API is not a UI change);
+ *   2. for each, the screens to show (`visual-proof-scope.ts`);
+ *   3. each side is built IN THE SANDBOX, offline — in a throwaway checkout of
+ *      that commit with the project's `node_modules` carried in, exactly as a
+ *      machine checkout is provisioned — and its built folder is kept, by commit,
+ *      so the next goal on the same base does not build it again;
+ *   4. Looply serves each side's built folder itself and headless Chromium,
+ *      with no network, captures every screen at every width, light and dark, and
+ *      right-to-left when the app says how;
+ *   5. one contact sheet per screen and width puts BEFORE beside AFTER;
+ *   6. a manifest records what was shown and, in words, what could not be.
+ *
+ * A failure is never a gate. Nothing here decides whether work is kept: a proof
+ * that could not be made says why, and the goal goes on exactly as before.
+ */
+export interface ProofInput {
+    /** Where git runs and the head commit lives: the run's checkout or the project. */
+    readonly checkout: string;
+    /** The project's own folder, where fixtures and node_modules are found when the checkout lacks them. */
+    readonly projectDir: string;
+    readonly projectName: string;
+    readonly goalId: string | null;
+    readonly goalText: string;
+    /** A ref or sha; the proof compares against its merge base with `head`. */
+    readonly base: string;
+    readonly head: string;
+    readonly config: VisualProofConfig;
+    /** Folders carried into a throwaway checkout (`run.carry_into_checkouts`). */
+    readonly carry: readonly string[];
+    /** The machine's workspaces folder; screenshots go under it. */
+    readonly storeBase: string;
+}
+export interface ProofDeps {
+    readonly git: GitExec;
+    /** The sandboxed command runner for a tree (production: `makeUntrustedGateRunner`). */
+    buildRunner(treeDir: string): CommandRunner;
+    /** The browser (production: `launchEngine`). */
+    engine?(roots: readonly string[]): Promise<CaptureEngine>;
+    now(): number;
+    log(line: string): void;
+}
+export type ProofOutcome = {
+    readonly kind: 'not-ui';
+    readonly because: string;
+} | {
+    readonly kind: 'captured';
+    readonly dir: string;
+    readonly manifest: ProofManifest;
+} | {
+    readonly kind: 'failed';
+    readonly because: string;
+};
+/**
+ * One key per REPOSITORY, whichever checkout asks: its shared git directory. A run in a
+ * machine-made checkout and the daemon in the project's own folder find the same captures.
+ */
+export declare function repoKey(exec: GitExec, fallbackDir: string): Promise<string>;
+/**
+ * The variants one screen is shown in: every width in every theme, then right-to-left
+ * (light) at every width when the app says how to switch it.
+ */
+export declare function variantsFor(cfg: VisualProofConfig, app: ProofApp): Array<{
+    viewport: Viewport;
+    theme: 'light' | 'dark';
+    dir: 'ltr' | 'rtl';
+}>;
+export declare function storageFor(app: ProofApp, login: Readonly<Record<string, string>>, theme: 'light' | 'dark', dir: 'ltr' | 'rtl'): Record<string, string>;
+export declare function captureVisualProof(input: ProofInput, deps: ProofDeps): Promise<ProofOutcome>;
+/**
+ * The carried folders one app's build needs: its own `carry` when it names one; else, for a
+ * build that starts `cd <dir> &&`, only the carried folders under that directory (the admin's
+ * build needs `admin/node_modules`, not the API's); else all of them.
+ */
+export declare function carryFor(app: ProofApp, carry: readonly string[]): string[];
+//# sourceMappingURL=visual-proof.d.ts.map