multiclone 0.0.0-stage → 0.2.0

package/dist/contracts/tools/session.js

@@ -0,0 +1,195 @@
+import { existsSync } from 'node:fs';
+import { readdir } from 'node:fs/promises';
+import { join, resolve } from 'node:path';
+import { z } from 'zod';
+import { ok, err, mcError } from '../../domain/result.js';
+import { generateDraft } from '../../project/draft.js';
+import { sessionStatus, startSession, stopSession } from '../../session/session.js';
+import { defineTool } from '../types.js';
+/** Short, capped summary for agents; everything else is in .multiclone/session.json. */
+export function summarize(state) {
+    const lines = [];
+    lines.push(`multiclone ${state.phase} — ${state.url} (${state.scope})`);
+    if (state.links.progress)
+        lines.push(`  progress: ${state.links.progress}`);
+    if (state.links.clone)
+        lines.push(`  clone:    ${state.links.clone}`);
+    if (state.links.mirror)
+        lines.push(`  original: ${state.links.mirror} (offline mirror)`);
+    lines.push(`  project:  ${state.project}`);
+    const pages = state.pages
+        .slice(0, 12)
+        .map((page) => `    ${page.route}  ${page.status}${page.sections === undefined ? '' : ` (${String(page.sections)} sections)`}${page.error ? ` — ${page.error.slice(0, 120)}` : ''}`);
+    lines.push(`  pages:`, ...pages);
+    if (state.pages.length > 12)
+        lines.push(`    … ${String(state.pages.length - 12)} more`);
+    const running = state.steps.filter((step) => step.status === 'running').map((step) => step.name);
+    if (running.length)
+        lines.push(`  now: ${running.join(', ')}`);
+    lines.push(`  deep pass: ${state.deep.status}${state.deep.note ? ` (${state.deep.note})` : ''}`);
+    if (state.warnings.length) {
+        lines.push(`  warnings (${String(state.warnings.length)}):`);
+        for (const warning of state.warnings.slice(-5))
+            lines.push(`    - ${warning.slice(0, 160)}`);
+    }
+    if (state.error)
+        lines.push(`  error: ${state.error.slice(0, 300)}`);
+    lines.push(nextHint(state));
+    return lines.join('\n');
+}
+function nextHint(state) {
+    if (state.phase === 'failed' || state.phase === 'stopped')
+        return 'Next: fix the error above, then `multiclone start` again (it resumes).';
+    if (state.phase !== 'ready')
+        return 'Next: `multiclone status --wait draft` to block until the first draft is live.';
+    return `Next: polish ${state.project}/src/sections (one folder per page), compare with \`multiclone compare\`. The deep pass adds motion and hover data to the capture folders when done.`;
+}
+const scopeField = z
+    .enum(['landing', 'pages', 'site'])
+    .optional()
+    .describe('What to clone. Ask the user first: landing (the URL only), pages (the URL plus `pages`) or site (the URL plus pages linked from its navigation).');
+export const startTool = defineTool({
+    name: 'start',
+    title: 'Start cloning a website',
+    description: 'The fast path. Ask the user the scope first (landing page, specific pages, or the whole site), then call this. Starts a background session and returns within seconds with a progress link to show the user. The session runs a quick capture (1–2 min), creates the React project, writes a first draft (one component per section, real text, media and fonts), serves the clone and an offline copy of the original, then captures the other pages and a deep pass (motion, hovers) in the background. Re-running resumes; finished captures are reused. Follow with `status`.',
+    input: z.object({
+        url: z.url().describe('Page to clone (the landing page).'),
+        scope: scopeField,
+        pages: z
+            .array(z.string())
+            .optional()
+            .describe('Paths or URLs to clone besides the URL (scope pages).'),
+        maxPages: z
+            .number()
+            .int()
+            .min(1)
+            .max(30)
+            .optional()
+            .describe('Page limit for scope site, landing page included (default 8).'),
+        dir: z.string().optional().describe('Workspace folder (default ./multiclone-<host>).'),
+        deep: z
+            .boolean()
+            .default(true)
+            .describe('Run the deep pass (motion, hovers, coverage) after the draft.'),
+        fresh: z.boolean().default(false).describe('Capture again instead of reusing captures.'),
+        clonePort: z.number().int().min(1024).max(65535).optional(),
+        mirrorPort: z.number().int().min(1024).max(65535).optional(),
+        progressPort: z.number().int().min(1024).max(65535).optional(),
+        headed: z.boolean().default(false).describe('Show the Chrome window.'),
+    }),
+    cli: { command: 'start', positionals: ['url'] },
+    readOnly: false,
+    openWorld: true,
+    run: async (input) => {
+        const state = await startSession({
+            url: input.url,
+            deep: input.deep,
+            fresh: input.fresh,
+            headless: !input.headed,
+            ...(input.scope === undefined ? {} : { scope: input.scope }),
+            ...(input.pages === undefined ? {} : { pages: input.pages }),
+            ...(input.maxPages === undefined ? {} : { maxPages: input.maxPages }),
+            ...(input.dir === undefined ? {} : { dir: input.dir }),
+            ...(input.clonePort === undefined ? {} : { clonePort: input.clonePort }),
+            ...(input.mirrorPort === undefined ? {} : { mirrorPort: input.mirrorPort }),
+            ...(input.progressPort === undefined ? {} : { progressPort: input.progressPort }),
+        });
+        return ok({ data: state, text: `${summarize(state)}\nShow the user the progress link now.` });
+    },
+});
+export const statusTool = defineTool({
+    name: 'status',
+    title: 'Session status',
+    description: 'Where a `start` session is: phase, links (progress, clone, offline original), pages and their sections, the deep pass, warnings. wait=draft blocks until the first draft is live (or timeout); wait=pages until every page is drafted; wait=deep until the deep pass ends.',
+    input: z.object({
+        dir: z
+            .string()
+            .optional()
+            .describe('Workspace folder (default: the one in the current folder).'),
+        wait: z.enum(['draft', 'pages', 'deep']).optional(),
+        timeout: z.number().int().min(1).max(1800).default(240).describe('Seconds to wait at most.'),
+    }),
+    cli: { command: 'status', positionals: ['dir'] },
+    readOnly: true,
+    openWorld: false,
+    run: async (input) => {
+        const workspace = await findWorkspace(input.dir);
+        if (!workspace)
+            return err(noSession());
+        const wait = input.wait ?? null;
+        const state = await sessionStatus(workspace, wait, input.timeout * 1000);
+        if (!state)
+            return err(noSession());
+        return ok({ data: state, text: summarize(state) });
+    },
+});
+export const stopTool = defineTool({
+    name: 'stop',
+    title: 'Stop a session',
+    description: 'Stop a `start` session and its servers (clone, mirror, progress). Files stay.',
+    input: z.object({ dir: z.string().optional() }),
+    cli: { command: 'stop', positionals: ['dir'] },
+    readOnly: false,
+    openWorld: false,
+    run: async (input) => {
+        const workspace = await findWorkspace(input.dir);
+        if (!workspace)
+            return err(noSession());
+        const state = await stopSession(workspace);
+        if (!state)
+            return err(noSession());
+        return ok({ data: state, text: `Stopped. Project kept at ${state.project}.` });
+    },
+});
+export const draftTool = defineTool({
+    name: 'draft',
+    title: 'Write a first draft from a capture',
+    description: 'Turn a capture into React components in a scaffolded project: one component and CSS module per section with the real text, links, media and fonts, a page that composes them, and a route. Layout is approximated from the captured computed styles (flex and grid kept, sizes relative); motion and interactions are left to the agent. `start` runs this for you.',
+    input: z.object({
+        capture: z.string().describe('Capture folder.'),
+        project: z.string().describe('Scaffolded project folder.'),
+        route: z.string().default('/').describe('Path this page answers on in the clone.'),
+        overwrite: z
+            .boolean()
+            .default(false)
+            .describe('Replace an earlier draft of this route, discarding edits.'),
+    }),
+    cli: { command: 'draft', positionals: ['capture', 'project'] },
+    readOnly: false,
+    openWorld: false,
+    run: async (input) => {
+        const result = await generateDraft({
+            capture: input.capture,
+            project: input.project,
+            route: input.route,
+            overwrite: input.overwrite,
+        });
+        const list = result.sections
+            .slice(0, 30)
+            .map((section) => `  ${section.file}${section.truncated ? ' (truncated)' : ''}`);
+        return ok({
+            data: result,
+            text: [
+                `Drafted ${result.route} → ${result.page} (${String(result.sections.length)} sections)`,
+                ...list,
+                ...result.warnings.slice(0, 5).map((warning) => `  ! ${warning}`),
+            ].join('\n'),
+        });
+    },
+});
+function noSession() {
+    return mcError('not-found', 'No multiclone session here.', 'Run `multiclone start <url>` first, or pass the workspace folder.');
+}
+/** The given folder, or the single multiclone-* workspace (or one) in the current folder. */
+async function findWorkspace(dir) {
+    if (dir !== undefined)
+        return resolve(dir);
+    if (existsSync(join('.multiclone', 'session.json')))
+        return resolve('.');
+    const candidates = (await readdir('.').catch(() => []))
+        .filter((name) => name.startsWith('multiclone-') && existsSync(join(name, '.multiclone', 'session.json')))
+        .sort();
+    const first = candidates[0];
+    return first === undefined ? null : resolve(first);
+}
+//# sourceMappingURL=session.js.map

package/dist/contracts/tools/session.js.map

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

package/dist/contracts/types.js

@@ -0,0 +1,20 @@
+import { z } from 'zod';
+import { err, mcError } from '../domain/result.js';
+export function defineTool(contract) {
+    return {
+        name: contract.name,
+        title: contract.title,
+        description: contract.description,
+        input: contract.input,
+        cli: contract.cli,
+        readOnly: contract.readOnly,
+        openWorld: contract.openWorld,
+        run: async (raw, context) => {
+            const parsed = contract.input.safeParse(raw);
+            if (!parsed.success)
+                return err(mcError('invalid-input', z.prettifyError(parsed.error)));
+            return contract.run(parsed.data, context);
+        },
+    };
+}
+//# sourceMappingURL=types.js.map

package/dist/contracts/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/contracts/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,GAAG,EAAE,OAAO,EAAe,MAAM,qBAAqB,CAAC;AAkDhE,MAAM,UAAU,UAAU,CACxB,QAA6B;IAE7B,OAAO;QACL,IAAI,EAAE,QAAQ,CAAC,IAAI;QACnB,KAAK,EAAE,QAAQ,CAAC,KAAK;QACrB,WAAW,EAAE,QAAQ,CAAC,WAAW;QACjC,KAAK,EAAE,QAAQ,CAAC,KAAK;QACrB,GAAG,EAAE,QAAQ,CAAC,GAAG;QACjB,QAAQ,EAAE,QAAQ,CAAC,QAAQ;QAC3B,SAAS,EAAE,QAAQ,CAAC,SAAS;QAC7B,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,OAAO,EAAE,EAAE;YAC1B,MAAM,MAAM,GAAG,QAAQ,CAAC,KAAK,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;YAC7C,IAAI,CAAC,MAAM,CAAC,OAAO;gBAAE,OAAO,GAAG,CAAC,OAAO,CAAC,eAAe,EAAE,CAAC,CAAC,aAAa,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;YACzF,OAAO,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAC5C,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/core/cdp.js

@@ -0,0 +1,146 @@
+export class CdpError extends Error {
+    method;
+    constructor(method, message) {
+        super(`${method}: ${message}`);
+        this.method = method;
+        this.name = 'CdpError';
+    }
+}
+/** Minimal Chrome DevTools Protocol client over the global WebSocket, with flat sessions. */
+export class CdpClient {
+    socket;
+    sessionId = undefined;
+    nextId = 0;
+    pending = new Map();
+    listeners = new Map();
+    closed = false;
+    /** Bytes received over the socket, for protocol budgets. */
+    receivedBytes = 0;
+    constructor(socket) {
+        this.socket = socket;
+        socket.addEventListener('message', (event) => {
+            this.receivedBytes += event.data.length;
+            this.dispatch(JSON.parse(event.data));
+        });
+        socket.addEventListener('close', () => {
+            this.closed = true;
+            for (const [id, entry] of this.pending) {
+                clearTimeout(entry.timer);
+                entry.reject(new CdpError(entry.method, 'connection closed'));
+                this.pending.delete(id);
+            }
+        });
+    }
+    static async connect(url) {
+        const socket = new WebSocket(url);
+        await new Promise((resolve, reject) => {
+            socket.addEventListener('open', () => {
+                resolve();
+            });
+            socket.addEventListener('error', () => {
+                reject(new Error(`Could not connect to Chrome at ${url}`));
+            });
+        });
+        return new CdpClient(socket);
+    }
+    get isClosed() {
+        return this.closed;
+    }
+    send(method, params = {}, timeoutMs = 60_000) {
+        return this.sendTo(method, params, { timeoutMs });
+    }
+    sendTo(method, params, options) {
+        if (this.closed)
+            return Promise.reject(new CdpError(method, 'connection closed'));
+        const id = ++this.nextId;
+        const timeoutMs = options.timeoutMs ?? 60_000;
+        return new Promise((resolve, reject) => {
+            const timer = setTimeout(() => {
+                this.pending.delete(id);
+                reject(new CdpError(method, `timed out after ${String(timeoutMs)}ms`));
+            }, timeoutMs);
+            this.pending.set(id, {
+                method,
+                resolve: (value) => {
+                    resolve(value);
+                },
+                reject,
+                timer,
+            });
+            const message = { id, method, params };
+            if (options.sessionId !== undefined)
+                message.sessionId = options.sessionId;
+            this.socket.send(JSON.stringify(message));
+        });
+    }
+    /** Listens on the root session only. */
+    on(method, listener) {
+        return this.onAny(method, (params, sessionId) => {
+            if (sessionId === undefined)
+                listener(params);
+        });
+    }
+    /** Listens across the root and every attached child session. */
+    onAny(method, listener) {
+        let set = this.listeners.get(method);
+        if (!set) {
+            set = new Set();
+            this.listeners.set(method, set);
+        }
+        set.add(listener);
+        return () => set.delete(listener);
+    }
+    /** A session view that routes commands and events to one attached child target. */
+    session(sessionId) {
+        return {
+            sessionId,
+            send: (method, params = {}, timeoutMs) => this.sendTo(method, params, {
+                sessionId,
+                ...(timeoutMs === undefined ? {} : { timeoutMs }),
+            }),
+            on: (method, listener) => this.onAny(method, (params, from) => {
+                if (from === sessionId)
+                    listener(params);
+            }),
+        };
+    }
+    waitFor(method, timeoutMs) {
+        return new Promise((resolve) => {
+            const timer = setTimeout(() => {
+                off();
+                resolve(false);
+            }, timeoutMs);
+            const off = this.on(method, () => {
+                clearTimeout(timer);
+                off();
+                resolve(true);
+            });
+        });
+    }
+    close() {
+        this.closed = true;
+        this.socket.close();
+    }
+    dispatch(message) {
+        if (message.id !== undefined) {
+            const entry = this.pending.get(message.id);
+            if (!entry)
+                return;
+            this.pending.delete(message.id);
+            clearTimeout(entry.timer);
+            if (message.error)
+                entry.reject(new CdpError(entry.method, message.error.message));
+            else
+                entry.resolve(message.result);
+            return;
+        }
+        if (!message.method)
+            return;
+        const set = this.listeners.get(message.method);
+        if (!set)
+            return;
+        for (const listener of set)
+            listener(message.params ?? {}, message.sessionId);
+    }
+}
+//# sourceMappingURL=cdp.js.map

package/dist/core/cdp.js.map

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

package/dist/core/chrome.js

@@ -0,0 +1,185 @@
+import { spawn } from 'node:child_process';
+import { existsSync } from 'node:fs';
+import { mkdir, mkdtemp, readFile, rm } from 'node:fs/promises';
+import { tmpdir } from 'node:os';
+import { join, resolve } from 'node:path';
+import { mcError, TaggedError } from '../domain/result.js';
+import { CdpClient } from './cdp.js';
+import { sleep } from './files.js';
+const CANDIDATES = {
+    darwin: [
+        '/Applications/Google Chrome.app/Contents/MacOS/Google Chrome',
+        '/Applications/Chromium.app/Contents/MacOS/Chromium',
+        '/Applications/Google Chrome Canary.app/Contents/MacOS/Google Chrome Canary',
+        '/Applications/Microsoft Edge.app/Contents/MacOS/Microsoft Edge',
+        '/Applications/Brave Browser.app/Contents/MacOS/Brave Browser',
+    ],
+    linux: [
+        '/usr/bin/google-chrome',
+        '/usr/bin/google-chrome-stable',
+        '/usr/bin/chromium',
+        '/usr/bin/chromium-browser',
+        '/snap/bin/chromium',
+        '/usr/bin/microsoft-edge',
+    ],
+    win32: [
+        'C:\\Program Files\\Google\\Chrome\\Application\\chrome.exe',
+        'C:\\Program Files (x86)\\Google\\Chrome\\Application\\chrome.exe',
+        'C:\\Program Files (x86)\\Microsoft\\Edge\\Application\\msedge.exe',
+    ],
+};
+export function findChrome() {
+    const override = process.env.MULTICLONE_CHROME ?? process.env.CHROME_PATH;
+    if (override)
+        return existsSync(override) ? override : null;
+    return (CANDIDATES[process.platform] ?? []).find((path) => existsSync(path)) ?? null;
+}
+/** Chrome flags that keep rendering faithful and hide the obvious automation tells. */
+export function chromeArgs(profile, options) {
+    const size = options.windowSize ?? { width: 1440, height: 900 };
+    const args = [
+        `--user-data-dir=${profile}`,
+        '--remote-debugging-port=0',
+        '--no-first-run',
+        '--no-default-browser-check',
+        '--disable-background-timer-throttling',
+        '--disable-renderer-backgrounding',
+        '--disable-backgrounding-occluded-windows',
+        '--disable-blink-features=AutomationControlled',
+        '--disable-features=Translate,MediaRouter,OptimizationHints',
+        '--hide-scrollbars',
+        '--mute-audio',
+        '--autoplay-policy=no-user-gesture-required',
+        // Software GL keeps WebGL/canvas sites rendering in headless mode.
+        '--use-angle=swiftshader',
+        '--enable-unsafe-swiftshader',
+        `--window-size=${String(size.width)},${String(size.height)}`,
+    ];
+    if (options.headless !== false)
+        args.unshift('--headless=new');
+    args.push('about:blank');
+    return args;
+}
+/** Every Chrome this process started, so exit and signal handlers can reap them. */
+const live = new Set();
+let hooksInstalled = false;
+function killTree(child) {
+    if (child.pid === undefined || child.exitCode !== null)
+        return;
+    try {
+        // Negative pid kills the whole process group: GPU, renderer and utility helpers too.
+        if (process.platform === 'win32')
+            child.kill('SIGKILL');
+        else
+            process.kill(-child.pid, 'SIGKILL');
+    }
+    catch {
+        child.kill('SIGKILL');
+    }
+}
+function installExitHooks() {
+    if (hooksInstalled)
+        return;
+    hooksInstalled = true;
+    process.on('exit', () => {
+        for (const child of live)
+            killTree(child);
+    });
+    for (const signal of ['SIGINT', 'SIGTERM', 'SIGHUP']) {
+        process.once(signal, () => {
+            for (const child of live)
+                killTree(child);
+            if (process.listenerCount(signal) === 0)
+                process.exit(130);
+        });
+    }
+}
+/** Launches a supervised Chrome (own process group, deadline, abort) and attaches to its page. */
+export async function launchBrowser(options = {}) {
+    const executable = findChrome();
+    if (!executable) {
+        throw new TaggedError(mcError('chrome-missing', 'Chrome was not found.', 'Install Google Chrome or set MULTICLONE_CHROME to a Chromium binary.'));
+    }
+    options.signal?.throwIfAborted();
+    installExitHooks();
+    const keepProfile = options.profile !== undefined;
+    const profile = keepProfile
+        ? resolve(options.profile ?? '')
+        : await mkdtemp(join(tmpdir(), 'multiclone-'));
+    if (keepProfile)
+        await mkdir(profile, { recursive: true });
+    const child = spawn(executable, chromeArgs(profile, options), {
+        stdio: 'ignore',
+        detached: process.platform !== 'win32',
+    });
+    live.add(child);
+    child.once('exit', () => live.delete(child));
+    let closed = false;
+    const teardown = async () => {
+        if (closed)
+            return;
+        closed = true;
+        clearTimeout(deadline);
+        options.signal?.removeEventListener('abort', onAbort);
+        killTree(child);
+        live.delete(child);
+        await sleep(150);
+        // DevTools rewrites this file on every start; stale copies confuse a reused profile.
+        if (keepProfile)
+            await rm(join(profile, 'DevToolsActivePort'), { force: true });
+        else
+            await rm(profile, { recursive: true, force: true }).catch(() => undefined);
+    };
+    const onAbort = () => void teardown();
+    options.signal?.addEventListener('abort', onAbort, { once: true });
+    const deadline = setTimeout(() => void teardown(), options.deadlineMs ?? 30 * 60_000);
+    deadline.unref();
+    try {
+        if (keepProfile)
+            await rm(join(profile, 'DevToolsActivePort'), { force: true });
+        const port = await readDevtoolsPort(profile, child);
+        let page;
+        for (let attempt = 0; attempt < 50 && !page; attempt++) {
+            const targets = (await fetch(`http://127.0.0.1:${String(port)}/json/list`).then((r) => r.json()));
+            page = targets.find((target) => target.type === 'page');
+            if (!page)
+                await sleep(100);
+        }
+        if (!page)
+            throw new TaggedError(mcError('chrome-launch', 'Chrome exposed no page target.'));
+        const versionInfo = (await fetch(`http://127.0.0.1:${String(port)}/json/version`).then((r) => r.json()));
+        const cdp = await CdpClient.connect(page.webSocketDebuggerUrl);
+        return {
+            cdp,
+            version: versionInfo.Browser,
+            headless: options.headless !== false,
+            close: async () => {
+                cdp.close();
+                await teardown();
+            },
+        };
+    }
+    catch (error) {
+        await teardown();
+        throw error;
+    }
+}
+async function readDevtoolsPort(profile, child) {
+    const file = join(profile, 'DevToolsActivePort');
+    for (let attempt = 0; attempt < 150; attempt++) {
+        if (child.exitCode !== null) {
+            throw new TaggedError(mcError('chrome-launch', `Chrome exited with code ${String(child.exitCode)}.`, 'A persistent --profile may already be open in another Chrome window.'));
+        }
+        try {
+            const [port] = (await readFile(file, 'utf8')).split('\n');
+            if (port)
+                return Number(port);
+        }
+        catch {
+            // Not written yet.
+        }
+        await sleep(100);
+    }
+    throw new TaggedError(mcError('timeout', 'Chrome did not open a DevTools port within 15s.'));
+}
+//# sourceMappingURL=chrome.js.map

package/dist/core/chrome.js.map

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

package/dist/core/files.js

@@ -0,0 +1,31 @@
+import { createHash } from 'node:crypto';
+import { mkdir, readFile, writeFile } from 'node:fs/promises';
+import { dirname } from 'node:path';
+export async function ensureDir(path) {
+    await mkdir(path, { recursive: true });
+}
+export async function writeJson(path, value) {
+    await ensureDir(dirname(path));
+    await writeFile(path, `${JSON.stringify(value, null, 2)}\n`);
+}
+export async function readJson(path) {
+    return JSON.parse(await readFile(path, 'utf8'));
+}
+export async function writeBytes(path, data) {
+    await ensureDir(dirname(path));
+    await writeFile(path, data);
+}
+export function sha1(input) {
+    return createHash('sha1').update(input).digest('hex');
+}
+export function sha256(input) {
+    return createHash('sha256').update(input).digest('hex');
+}
+/** Filesystem-safe folder name for a URL, e.g. `www.shopify.com-editions-fall2026`. */
+export function slugForUrl(url) {
+    const parsed = new URL(url);
+    const path = parsed.pathname.replace(/\/+$/, '').replace(/[^a-zA-Z0-9]+/g, '-');
+    return `${parsed.hostname}${path}`.replace(/-+$/, '').slice(0, 80);
+}
+export const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+//# sourceMappingURL=files.js.map

package/dist/core/files.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"files.js","sourceRoot":"","sources":["../../src/core/files.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC9D,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,IAAY;IAC1C,MAAM,KAAK,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;AACzC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,IAAY,EAAE,KAAc;IAC1D,MAAM,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;IAC/B,MAAM,SAAS,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;AAC/D,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAI,IAAY;IAC5C,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAM,CAAC;AACvD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,IAAY,EAAE,IAAyB;IACtE,MAAM,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;IAC/B,MAAM,SAAS,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;AAC9B,CAAC;AAED,MAAM,UAAU,IAAI,CAAC,KAA0B;IAC7C,OAAO,UAAU,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AACxD,CAAC;AAED,MAAM,UAAU,MAAM,CAAC,KAA0B;IAC/C,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC1D,CAAC;AAED,uFAAuF;AACvF,MAAM,UAAU,UAAU,CAAC,GAAW;IACpC,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;IAC5B,MAAM,IAAI,GAAG,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,gBAAgB,EAAE,GAAG,CAAC,CAAC;IAChF,OAAO,GAAG,MAAM,CAAC,QAAQ,GAAG,IAAI,EAAE,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AACrE,CAAC;AAED,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC,EAAU,EAAiB,EAAE,CACjD,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC"}

package/dist/core/inpage.js

@@ -0,0 +1,24 @@
+import { stablePathOf } from '../domain/paths.js';
+/**
+ * Source of the helper object. `stablePathOf` is self-contained, so its text runs in the page with
+ * DOM accessors plugged in.
+ */
+export const IN_PAGE_HELPERS = `(() => {
+  const stablePathOf = ${stablePathOf.toString()};
+  const access = {
+    parent: (el) => el.parentElement,
+    shadowHost: (el) => {
+      const root = el.parentNode;
+      return root && root.nodeType === 11 && root.host ? root.host : null;
+    },
+    tag: (el) => el.tagName,
+    id: (el) => el.getAttribute('id'),
+    siblings: (el) => el.parentNode ? Array.from(el.parentNode.children) : [el],
+    uniqueId: (el, id) => {
+      const root = el.getRootNode();
+      try { return root.querySelectorAll('#' + CSS.escape(id)).length === 1; } catch { return false; }
+    },
+  };
+  return { path: (el) => stablePathOf(el, access) };
+})()`;
+//# sourceMappingURL=inpage.js.map