multiclone 0.0.0-stage → 0.2.0

package/dist/compare/image.js.map

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

package/dist/compare/probes.js

@@ -0,0 +1,129 @@
+/**
+ * Structure of a page for compare. Sections come from `[data-mc-section]` when the page has them
+ * (the rebuild), otherwise from `known` (the captured sections of the original) or landmarks.
+ * Self-contained (runs in the page).
+ */
+export function structureForCompare(known, helpers) {
+    const query = (selector) => {
+        try {
+            return document.querySelector(selector);
+        }
+        catch {
+            return null;
+        }
+    };
+    const textOf = (el) => (el instanceof HTMLElement ? el.innerText : el.textContent)
+        .replace(/\s+/g, ' ')
+        .trim()
+        .slice(0, 2000);
+    const fontsOf = (el) => {
+        const fonts = new Set();
+        const walker = document.createTreeWalker(el, NodeFilter.SHOW_TEXT);
+        let count = 0;
+        for (let node = walker.nextNode(); node && count < 400; node = walker.nextNode()) {
+            const parent = node.parentElement;
+            if (!parent || !node.textContent?.trim())
+                continue;
+            count++;
+            const style = getComputedStyle(parent);
+            fonts.add(`${(style.fontFamily.split(',')[0] ?? '').replace(/["']/g, '').trim()} ${style.fontWeight}`);
+        }
+        return [...fonts].sort();
+    };
+    const box = (el) => {
+        const rect = el.getBoundingClientRect();
+        return [
+            Math.round(rect.left),
+            Math.round(rect.top + window.scrollY),
+            Math.round(rect.width),
+            Math.round(rect.height),
+        ];
+    };
+    const describe = (el, key, label) => {
+        const [, top, , height] = box(el);
+        const heading = el.querySelector('h1, h2, h3, [role=heading]');
+        return {
+            key,
+            label: label !== '' ? label : (heading?.textContent.trim().slice(0, 80) ?? '') || key,
+            top,
+            height,
+            text: textOf(el),
+            fonts: fontsOf(el),
+        };
+    };
+    let sections = [];
+    const tagged = Array.from(document.querySelectorAll('[data-mc-section]'));
+    if (tagged.length) {
+        sections = tagged.map((el) => {
+            const key = el.getAttribute('data-mc-section') ?? '';
+            return describe(el, key, key.replace(/^\d+-/, ''));
+        });
+    }
+    else {
+        for (const item of known) {
+            const el = query(item.path.split(' >>> ')[0] ?? '');
+            if (el)
+                sections.push(describe(el, item.key, item.label));
+        }
+        if (!sections.length) {
+            const blocks = Array.from(document.querySelectorAll('header, main > *, section, footer')).filter((el) => el.getBoundingClientRect().height > 120);
+            sections = blocks
+                .slice(0, 40)
+                .map((el, index) => describe(el, `block-${String(index + 1)}`, ''));
+        }
+    }
+    const outline = [];
+    const walk = (el, depth) => {
+        if (depth > 3)
+            return;
+        for (const child of Array.from(el.children)) {
+            if (/^(SCRIPT|STYLE|LINK|META|NOSCRIPT|TEMPLATE)$/.test(child.tagName))
+                continue;
+            if (child.getBoundingClientRect().height < 8)
+                continue;
+            outline.push(`${'  '.repeat(depth)}${child.tagName.toLowerCase()}`);
+            walk(child, depth + 1);
+        }
+    };
+    walk(document.body, 0);
+    const boxes = Array.from(document.querySelectorAll('h1, h2, h3, [data-mc-section], header, footer, nav, button, img, video, canvas'))
+        .slice(0, 300)
+        .map((el) => ({
+        path: helpers.path(el),
+        key: el.textContent.trim().slice(0, 40) || el.tagName.toLowerCase(),
+        box: box(el),
+    }));
+    return {
+        pageHeight: Math.max(document.documentElement.scrollHeight, document.body.scrollHeight),
+        sections: sections.sort((a, b) => a.top - b.top),
+        fonts: fontsOf(document.body),
+        outline: outline.slice(0, 400),
+        boxes,
+    };
+}
+/** Samples computed values of tracked elements. Self-contained. */
+export function sampleTracks(arg) {
+    const out = {};
+    for (const track of arg.tracks) {
+        const query = (selector) => {
+            try {
+                return document.querySelector(selector);
+            }
+            catch {
+                return null;
+            }
+        };
+        const el = query(arg.clone ? `[data-mc-track="${track.id}"]` : (track.path.split(' >>> ')[0] ?? ''));
+        if (!el)
+            continue;
+        const style = getComputedStyle(el);
+        const values = {};
+        for (const prop of track.props) {
+            values[prop] =
+                prop === 'text' ? el.textContent.trim().slice(0, 80) : style.getPropertyValue(prop);
+        }
+        out[track.id] = values;
+    }
+    return out;
+}
+//# sourceMappingURL=probes.js.map

package/dist/compare/probes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"probes.js","sourceRoot":"","sources":["../../src/compare/probes.ts"],"names":[],"mappings":"AAYA;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CACjC,KAA8D,EAC9D,OAAsB;IAEtB,MAAM,KAAK,GAAG,CAAC,QAAgB,EAAkB,EAAE;QACjD,IAAI,CAAC;YACH,OAAO,QAAQ,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;QAC1C,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC,CAAC;IACF,MAAM,MAAM,GAAG,CAAC,EAAW,EAAU,EAAE,CACrC,CAAC,EAAE,YAAY,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,WAAW,CAAC;SACxD,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC;SACpB,IAAI,EAAE;SACN,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;IACpB,MAAM,OAAO,GAAG,CAAC,EAAW,EAAY,EAAE;QACxC,MAAM,KAAK,GAAG,IAAI,GAAG,EAAU,CAAC;QAChC,MAAM,MAAM,GAAG,QAAQ,CAAC,gBAAgB,CAAC,EAAE,EAAE,UAAU,CAAC,SAAS,CAAC,CAAC;QACnE,IAAI,KAAK,GAAG,CAAC,CAAC;QACd,KAAK,IAAI,IAAI,GAAG,MAAM,CAAC,QAAQ,EAAE,EAAE,IAAI,IAAI,KAAK,GAAG,GAAG,EAAE,IAAI,GAAG,MAAM,CAAC,QAAQ,EAAE,EAAE,CAAC;YACjF,MAAM,MAAM,GAAG,IAAI,CAAC,aAAa,CAAC;YAClC,IAAI,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,EAAE;gBAAE,SAAS;YACnD,KAAK,EAAE,CAAC;YACR,MAAM,KAAK,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAC;YACvC,KAAK,CAAC,GAAG,CACP,GAAG,CAAC,KAAK,CAAC,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,IAAI,KAAK,CAAC,UAAU,EAAE,CAC5F,CAAC;QACJ,CAAC;QACD,OAAO,CAAC,GAAG,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC;IAC3B,CAAC,CAAC;IACF,MAAM,GAAG,GAAG,CAAC,EAAW,EAAoC,EAAE;QAC5D,MAAM,IAAI,GAAG,EAAE,CAAC,qBAAqB,EAAE,CAAC;QACxC,OAAO;YACL,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC;YACrB,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,GAAG,MAAM,CAAC,OAAO,CAAC;YACrC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC;YACtB,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC;SACxB,CAAC;IACJ,CAAC,CAAC;IACF,MAAM,QAAQ,GAAG,CAAC,EAAW,EAAE,GAAW,EAAE,KAAa,EAAkB,EAAE;QAC3E,MAAM,CAAC,EAAE,GAAG,EAAE,AAAD,EAAG,MAAM,CAAC,GAAG,GAAG,CAAC,EAAE,CAAC,CAAC;QAClC,MAAM,OAAO,GAAG,EAAE,CAAC,aAAa,CAAC,4BAA4B,CAAC,CAAC;QAC/D,OAAO;YACL,GAAG;YACH,KAAK,EAAE,KAAK,KAAK,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,WAAW,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,EAAE,CAAC,IAAI,GAAG;YACrF,GAAG;YACH,MAAM;YACN,IAAI,EAAE,MAAM,CAAC,EAAE,CAAC;YAChB,KAAK,EAAE,OAAO,CAAC,EAAE,CAAC;SACnB,CAAC;IACJ,CAAC,CAAC;IACF,IAAI,QAAQ,GAAqB,EAAE,CAAC;IACpC,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,gBAAgB,CAAC,mBAAmB,CAAC,CAAC,CAAC;IAC1E,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;QAClB,QAAQ,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE;YAC3B,MAAM,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,iBAAiB,CAAC,IAAI,EAAE,CAAC;YACrD,OAAO,QAAQ,CAAC,EAAE,EAAE,GAAG,EAAE,GAAG,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;QACrD,CAAC,CAAC,CAAC;IACL,CAAC;SAAM,CAAC;QACN,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,MAAM,EAAE,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;YACpD,IAAI,EAAE;gBAAE,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;QAC5D,CAAC;QACD,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC;YACrB,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,CACvB,QAAQ,CAAC,gBAAgB,CAAC,mCAAmC,CAAC,CAC/D,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,qBAAqB,EAAE,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC;YAC1D,QAAQ,GAAG,MAAM;iBACd,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC;iBACZ,GAAG,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,EAAE,CAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,MAAM,CAAC,KAAK,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC;QACxE,CAAC;IACH,CAAC;IACD,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,MAAM,IAAI,GAAG,CAAC,EAAW,EAAE,KAAa,EAAQ,EAAE;QAChD,IAAI,KAAK,GAAG,CAAC;YAAE,OAAO;QACtB,KAAK,MAAM,KAAK,IAAI,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC5C,IAAI,8CAA8C,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC;gBAAE,SAAS;YACjF,IAAI,KAAK,CAAC,qBAAqB,EAAE,CAAC,MAAM,GAAG,CAAC;gBAAE,SAAS;YACvD,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;YACpE,IAAI,CAAC,KAAK,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC;QACzB,CAAC;IACH,CAAC,CAAC;IACF,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;IACvB,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CACtB,QAAQ,CAAC,gBAAgB,CACvB,gFAAgF,CACjF,CACF;SACE,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC;SACb,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;QACZ,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QACtB,GAAG,EAAE,EAAE,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,WAAW,EAAE;QACnE,GAAG,EAAE,GAAG,CAAC,EAAE,CAAC;KACb,CAAC,CAAC,CAAC;IACN,OAAO;QACL,UAAU,EAAE,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,eAAe,CAAC,YAAY,EAAE,QAAQ,CAAC,IAAI,CAAC,YAAY,CAAC;QACvF,QAAQ,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,GAAG,CAAC;QAChD,KAAK,EAAE,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC;QAC7B,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC;QAC9B,KAAK;KACN,CAAC;AACJ,CAAC;AAED,mEAAmE;AACnE,MAAM,UAAU,YAAY,CAAC,GAG5B;IACC,MAAM,GAAG,GAA2C,EAAE,CAAC;IACvD,KAAK,MAAM,KAAK,IAAI,GAAG,CAAC,MAAM,EAAE,CAAC;QAC/B,MAAM,KAAK,GAAG,CAAC,QAAgB,EAAkB,EAAE;YACjD,IAAI,CAAC;gBACH,OAAO,QAAQ,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;YAC1C,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,IAAI,CAAC;YACd,CAAC;QACH,CAAC,CAAC;QACF,MAAM,EAAE,GAAG,KAAK,CACd,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,mBAAmB,KAAK,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CACnF,CAAC;QACF,IAAI,CAAC,EAAE;YAAE,SAAS;QAClB,MAAM,KAAK,GAAG,gBAAgB,CAAC,EAAE,CAAC,CAAC;QACnC,MAAM,MAAM,GAA2B,EAAE,CAAC;QAC1C,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;YAC/B,MAAM,CAAC,IAAI,CAAC;gBACV,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC;QACxF,CAAC;QACD,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC;IACzB,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/compare/report.js

@@ -0,0 +1,99 @@
+const escape = (value) => value.replace(/[&<>"']/g, (char) => `&#${String(char.charCodeAt(0))};`);
+const pct = (value) => `${(value * 100).toFixed(1)}%`;
+export function renderCompareHtml(input) {
+    const parts = Object.entries(input.parts)
+        .map(([name, value]) => `<li><strong>${escape(name)}</strong> ${value === null ? 'not compared' : pct(value)}</li>`)
+        .join('');
+    const c = input.completeness;
+    const completeness = `${String(c.framesCompared)} frames compared, ${String(c.framesSkipped)} skipped · ${String(c.sectionsPaired)} sections paired, ${String(c.sectionsMissing)} missing, ${String(c.sectionsExtra)} extra · ${String(c.dimensionMismatches)} size mismatches`;
+    const heights = input.heights
+        .map((h) => {
+        const delta = h.clone - h.original;
+        return `<li>${escape(h.viewport)}: original ${String(h.original)}px, clone ${String(h.clone)}px (${delta >= 0 ? '+' : ''}${String(delta)})</li>`;
+    })
+        .join('');
+    const sections = input.sections
+        .map((s) => {
+        const detail = s.status === 'paired'
+            ? `pixels ${s.pixel === null ? 'n/a' : pct(s.pixel)} · text ${pct(s.text)} · fonts ${pct(s.fonts)} · height ${String(s.height?.original ?? 0)} → ${String(s.height?.clone ?? 0)}px`
+            : s.status === 'missing'
+                ? 'missing from the clone'
+                : 'only in the clone';
+        const fonts = s.missingFonts.length
+            ? `<br><small>Missing fonts: ${escape(s.missingFonts.join(', '))}</small>`
+            : '';
+        const img = s.file
+            ? `<img src="${escape(s.file)}" alt="Section ${escape(s.label)}" loading="lazy">`
+            : '';
+        return `<figure class="${s.status}"><figcaption><strong>${escape(s.viewport)} · ${escape(s.label || s.key)}</strong> — ${s.status === 'extra' ? '' : `${String(s.score)}/100 · `}${detail}${fonts}</figcaption>${img}</figure>`;
+    })
+        .join('\n');
+    const structure = input.structure
+        .map((s) => {
+        const drift = s.drift
+            .map((d) => `<li>${escape(d.key)}: ${String(d.original)} → ${String(d.clone)}px (${d.clone - d.original >= 0 ? '+' : ''}${String(d.clone - d.original)})</li>`)
+            .join('');
+        const fonts = s.missingFonts.length
+            ? `<p>Fonts on the original but not the clone: ${escape(s.missingFonts.join(', '))}</p>`
+            : '';
+        return `<h3>${escape(s.viewport)} — outline ${pct(s.outline)}</h3>${fonts}<ul>${drift}</ul>`;
+    })
+        .join('');
+    const motion = [...input.motion]
+        .sort((a, b) => b.error - a.error)
+        .map((m) => `<tr><td>${escape(m.id)}</td><td>${m.missing ? 'not tagged' : pct(1 - m.error)}</td><td>${escape(Object.entries(m.props)
+        .map(([prop, error]) => `${prop} ${pct(1 - error)}`)
+        .join(', '))}</td><td><code>${escape(m.path)}</code></td></tr>`)
+        .join('');
+    const hovers = [...input.hovers]
+        .sort((a, b) => b.error - a.error)
+        .map((h) => `<tr><td>${escape(h.key)}</td><td>${h.missing ? 'not tagged' : pct(1 - h.error)}</td><td>${escape(Object.entries(h.props)
+        .map(([prop, v]) => `${prop}: ${v.original} vs ${v.clone ?? '—'}`)
+        .join('; '))}</td><td><code>${escape(h.path)}</code></td></tr>`)
+        .join('');
+    const intro = input.intro
+        .map((i) => `<figure><figcaption><strong>${escape(i.viewport)} @ ${String(i.ms)}ms</strong> — ${pct(1 - i.mismatch)} match</figcaption><img src="${escape(i.file)}" alt="Intro at ${String(i.ms)}ms" loading="lazy"></figure>`)
+        .join('\n');
+    const frames = input.frames
+        .map((frame) => `<figure>
+  <figcaption><strong>${escape(frame.viewport)} @ ${String(frame.y)}px</strong> — ${pct(1 - frame.mismatch)} match
+  (original scrolled to ${String(frame.originalY)}, clone to ${String(frame.cloneY)}${frame.dimensionMismatch ? ', sizes differ' : ''})</figcaption>
+  <img src="${escape(frame.file)}" alt="Original, clone and diff at ${String(frame.y)}px" loading="lazy">
+</figure>`)
+        .join('\n');
+    const table = (head, rows) => rows
+        ? `<table><thead>${head}</thead><tbody>${rows}</tbody></table>`
+        : '<p>Nothing compared.</p>';
+    return `<!doctype html>
+<html lang="en"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1">
+<title>multiclone — ${String(input.score)}/100</title>
+<style>
+body{font:15px/1.5 system-ui,sans-serif;margin:0;padding:32px;background:#0b0b0f;color:#eee}
+h1{font-size:28px;margin:0 0 8px}h2{margin-top:48px;border-top:1px solid #333;padding-top:24px}
+.score{font-size:64px;font-weight:700}figure{margin:24px 0}img{max-width:100%;border:1px solid #333;display:block}
+figcaption{margin-bottom:8px;color:#bbb}a{color:#9cf}.missing figcaption{color:#f88}.extra figcaption{color:#fc8}
+table{border-collapse:collapse;width:100%}td,th{border-bottom:1px solid #222;padding:6px 8px;text-align:left;vertical-align:top}
+code{font-size:12px;color:#aaa;word-break:break-all}
+</style></head><body>
+<h1>multiclone comparison</h1>
+<div class="score">${String(input.score)}<small>/100</small></div>
+<p>Left: <a href="${escape(input.original)}">original</a> · Middle: <a href="${escape(input.clone)}">clone</a> · Right: differing pixels in pink.</p>
+<p>${completeness}</p>
+<ul>${parts}</ul>
+<ul>${heights}</ul>
+<h2>Sections</h2>
+${sections || '<p>No sections found.</p>'}
+<h2>Structure</h2>
+${structure}
+<h2>Scroll motion</h2>
+${table('<tr><th>Track</th><th>Match</th><th>Per property</th><th>Original element</th></tr>', motion)}
+<h2>Hover states</h2>
+${table('<tr><th>Element</th><th>Match</th><th>Hovered values</th><th>Original element</th></tr>', hovers)}
+<h2>Intro</h2>
+${intro || '<p>Not recorded (use --intro).</p>'}
+<h2>Frames</h2>
+${frames}
+</body></html>
+`;
+}
+//# sourceMappingURL=report.js.map

package/dist/compare/report.js.map

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

package/dist/compare/session.js

@@ -0,0 +1,139 @@
+import { launchBrowser } from '../core/chrome.js';
+import { sleep } from '../core/files.js';
+import { log } from '../core/log.js';
+import { Page } from '../core/page.js';
+import { INTRO_MS, pickFrames } from '../capture/collectors/intro.js';
+import { diffStates, readStates, STATE_PROPS } from '../capture/hooks/styles.js';
+import { sampleTracks, structureForCompare } from './probes.js';
+/** Records the intro by screencasting from navigation, falling back to nothing on failure. */
+async function recordIntro(page, url) {
+    const frames = [];
+    const cdp = page.cdp;
+    let started = 0;
+    const off = cdp.on('Page.screencastFrame', (params) => {
+        const sessionId = params.sessionId;
+        frames.push({ t: Date.now() - started, png: Buffer.from(params.data, 'base64') });
+        void cdp.send('Page.screencastFrameAck', { sessionId }).catch(() => undefined);
+    });
+    try {
+        await cdp.send('Page.startScreencast', { format: 'png', everyNthFrame: 1 });
+        started = Date.now();
+        await page.goto(url, 0);
+        const last = INTRO_MS.at(-1) ?? 4000;
+        await sleep(Math.max(0, last + 200 - (Date.now() - started)));
+    }
+    catch {
+        return [];
+    }
+    finally {
+        off();
+        await cdp.send('Page.stopScreencast').catch(() => undefined);
+    }
+    return pickFrames(frames, INTRO_MS).flatMap((frame, index) => frame ? [{ ms: INTRO_MS[index] ?? 0, png: frame.png }] : []);
+}
+/** One browser pass over a page at one viewport: everything compare needs, in a fixed order. */
+export async function runSession(request) {
+    const browser = await launchBrowser(request.signal === undefined ? {} : { signal: request.signal });
+    try {
+        const page = new Page(browser.cdp, browser.version);
+        await page.init();
+        await page.setViewport(request.viewport);
+        log(`  ${request.clone ? 'clone   ' : 'original'} ${request.url} @ ${request.viewport.name}`);
+        const intro = request.intro ? await recordIntro(page, request.url) : [];
+        if (!request.intro)
+            await page.goto(request.url, 0);
+        await page.settle(request.settleMs, request.signal);
+        await page.autoScroll(request.viewport, 30_000);
+        await page.jumpTo(0);
+        await sleep(500);
+        const structure = await page.runWith(structureForCompare, request.knownSections);
+        const maxScroll = await page.maxScroll();
+        const tracks = {};
+        const offsets = [...new Set(request.tracks.flatMap((track) => track.offsets))]
+            .sort((a, b) => a - b)
+            .slice(0, 120);
+        if (request.tracks.length) {
+            const wanted = request.tracks.map((track) => ({
+                id: track.id,
+                path: track.path,
+                props: track.props,
+            }));
+            const deadline = Date.now() + 90_000;
+            for (const y of offsets) {
+                if (Date.now() > deadline)
+                    break;
+                await page.scrollTo(y, request.viewport, 6_000);
+                await sleep(250);
+                const values = await page
+                    .run(sampleTracks, { tracks: wanted, clone: request.clone })
+                    .catch(() => ({}));
+                for (const [id, props] of Object.entries(values)) {
+                    const track = (tracks[id] ??= {});
+                    for (const [prop, value] of Object.entries(props))
+                        (track[prop] ??= []).push([y, value]);
+                }
+            }
+        }
+        const frames = [];
+        for (const offset of request.offsets) {
+            const y = request.relative ? Math.round(offset * maxScroll) : offset;
+            const actualY = await page.scrollTo(y, request.viewport, 10_000);
+            await sleep(900);
+            const png = await page.screenshot().catch(() => null);
+            if (png)
+                frames.push({ y, actualY, png });
+        }
+        const hovers = {};
+        const hoverDeadline = Date.now() + 60_000;
+        for (const hover of request.hovers.slice(0, 40)) {
+            if (Date.now() > hoverDeadline)
+                break;
+            const rest = await page.run(readStates, {
+                selector: hover.selector,
+                props: [...STATE_PROPS],
+                maxDescendants: 30,
+            });
+            if (!rest)
+                continue;
+            const rect = await page.evaluate(`(() => { const el = document.querySelector(${JSON.stringify(hover.selector)}); if (!el) return null; el.scrollIntoView({ block: 'center' }); const r = el.getBoundingClientRect(); return { x: r.left, y: r.top, w: r.width, h: r.height }; })()`);
+            if (!rect)
+                continue;
+            await sleep(300);
+            await page.pointer(rect.x + rect.w / 2, rect.y + rect.h / 2);
+            await sleep(600);
+            const active = await page.run(readStates, {
+                selector: hover.selector,
+                props: [...STATE_PROPS],
+                maxDescendants: 30,
+            });
+            await page.pointer(1, 1);
+            await sleep(300);
+            if (active)
+                hovers[hover.key] = diffStates(rest, active);
+        }
+        await page.jumpTo(0).catch(() => 0);
+        await sleep(500);
+        let full = null;
+        try {
+            full = (await page.fullPageScreenshot()).png;
+        }
+        catch {
+            full = null;
+        }
+        return {
+            url: request.url,
+            viewport: request.viewport.name,
+            maxScroll,
+            structure,
+            full,
+            frames,
+            intro,
+            tracks,
+            hovers,
+        };
+    }
+    finally {
+        await browser.close();
+    }
+}
+//# sourceMappingURL=session.js.map

package/dist/compare/session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.js","sourceRoot":"","sources":["../../src/compare/session.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACzC,OAAO,EAAE,GAAG,EAAE,MAAM,gBAAgB,CAAC;AACrC,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AACvC,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,gCAAgC,CAAC;AACtE,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAEjF,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAuB,MAAM,aAAa,CAAC;AA8CrF,8FAA8F;AAC9F,KAAK,UAAU,WAAW,CAAC,IAAU,EAAE,GAAW;IAChD,MAAM,MAAM,GAAiC,EAAE,CAAC;IAChD,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC;IACrB,IAAI,OAAO,GAAG,CAAC,CAAC;IAChB,MAAM,GAAG,GAAG,GAAG,CAAC,EAAE,CAAC,sBAAsB,EAAE,CAAC,MAAM,EAAE,EAAE;QACpD,MAAM,SAAS,GAAG,MAAM,CAAC,SAAmB,CAAC;QAC7C,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,IAAc,EAAE,QAAQ,CAAC,EAAE,CAAC,CAAC;QAC5F,KAAK,GAAG,CAAC,IAAI,CAAC,yBAAyB,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;IACjF,CAAC,CAAC,CAAC;IACH,IAAI,CAAC;QACH,MAAM,GAAG,CAAC,IAAI,CAAC,sBAAsB,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,EAAE,CAAC,EAAE,CAAC,CAAC;QAC5E,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACrB,MAAM,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;QACxB,MAAM,IAAI,GAAG,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC;QACrC,MAAM,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,GAAG,GAAG,GAAG,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAChE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;YAAS,CAAC;QACT,GAAG,EAAE,CAAC;QACN,MAAM,GAAG,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;IAC/D,CAAC;IACD,OAAO,UAAU,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CAC3D,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAC5D,CAAC;AACJ,CAAC;AAED,gGAAgG;AAChG,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,OAAuB;IACtD,MAAM,OAAO,GAAG,MAAM,aAAa,CACjC,OAAO,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAC/D,CAAC;IACF,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;QACpD,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;QAClB,MAAM,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QACzC,GAAG,CAAC,KAAK,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,UAAU,IAAI,OAAO,CAAC,GAAG,MAAM,OAAO,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;QAC9F,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,WAAW,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACxE,IAAI,CAAC,OAAO,CAAC,KAAK;YAAE,MAAM,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;QACpD,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;QACpD,MAAM,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QAChD,MAAM,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QACrB,MAAM,KAAK,CAAC,GAAG,CAAC,CAAC;QACjB,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,mBAAmB,EAAE,OAAO,CAAC,aAAa,CAAC,CAAC;QACjF,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,SAAS,EAAE,CAAC;QAEzC,MAAM,MAAM,GAAuD,EAAE,CAAC;QACtE,MAAM,OAAO,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;aAC3E,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC;aACrB,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;QACjB,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;YAC1B,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;gBAC5C,EAAE,EAAE,KAAK,CAAC,EAAE;gBACZ,IAAI,EAAE,KAAK,CAAC,IAAI;gBAChB,KAAK,EAAE,KAAK,CAAC,KAAK;aACnB,CAAC,CAAC,CAAC;YACJ,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,MAAM,CAAC;YACrC,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;gBACxB,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,QAAQ;oBAAE,MAAM;gBACjC,MAAM,IAAI,CAAC,QAAQ,CAAC,CAAC,EAAE,OAAO,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;gBAChD,MAAM,KAAK,CAAC,GAAG,CAAC,CAAC;gBACjB,MAAM,MAAM,GAAG,MAAM,IAAI;qBACtB,GAAG,CAAC,YAAY,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC;qBAC3D,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;gBACrB,KAAK,MAAM,CAAC,EAAE,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;oBACjD,MAAM,KAAK,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,CAAC;oBAClC,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC;wBAAE,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC;gBAC3F,CAAC;YACH,CAAC;QACH,CAAC;QAED,MAAM,MAAM,GAAkD,EAAE,CAAC;QACjE,KAAK,MAAM,MAAM,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;YACrC,MAAM,CAAC,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;YACrE,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,CAAC,EAAE,OAAO,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;YACjE,MAAM,KAAK,CAAC,GAAG,CAAC,CAAC;YACjB,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,UAAU,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;YACtD,IAAI,GAAG;gBAAE,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,CAAC;QAC5C,CAAC;QAED,MAAM,MAAM,GAAqE,EAAE,CAAC;QACpF,MAAM,aAAa,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,MAAM,CAAC;QAC1C,KAAK,MAAM,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC;YAChD,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,aAAa;gBAAE,MAAM;YACtC,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,UAAU,EAAE;gBACtC,QAAQ,EAAE,KAAK,CAAC,QAAQ;gBACxB,KAAK,EAAE,CAAC,GAAG,WAAW,CAAC;gBACvB,cAAc,EAAE,EAAE;aACnB,CAAC,CAAC;YACH,IAAI,CAAC,IAAI;gBAAE,SAAS;YACpB,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,QAAQ,CAC9B,8CAA8C,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,QAAQ,CAAC,sKAAsK,CACnP,CAAC;YACF,IAAI,CAAC,IAAI;gBAAE,SAAS;YACpB,MAAM,KAAK,CAAC,GAAG,CAAC,CAAC;YACjB,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,GAAG,CAAC,EAAE,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;YAC7D,MAAM,KAAK,CAAC,GAAG,CAAC,CAAC;YACjB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,UAAU,EAAE;gBACxC,QAAQ,EAAE,KAAK,CAAC,QAAQ;gBACxB,KAAK,EAAE,CAAC,GAAG,WAAW,CAAC;gBACvB,cAAc,EAAE,EAAE;aACnB,CAAC,CAAC;YACH,MAAM,IAAI,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;YACzB,MAAM,KAAK,CAAC,GAAG,CAAC,CAAC;YACjB,IAAI,MAAM;gBAAE,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,UAAU,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QAC3D,CAAC;QAED,MAAM,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC;QACpC,MAAM,KAAK,CAAC,GAAG,CAAC,CAAC;QACjB,IAAI,IAAI,GAAkB,IAAI,CAAC;QAC/B,IAAI,CAAC;YACH,IAAI,GAAG,CAAC,MAAM,IAAI,CAAC,kBAAkB,EAAE,CAAC,CAAC,GAAG,CAAC;QAC/C,CAAC;QAAC,MAAM,CAAC;YACP,IAAI,GAAG,IAAI,CAAC;QACd,CAAC;QACD,OAAO;YACL,GAAG,EAAE,OAAO,CAAC,GAAG;YAChB,QAAQ,EAAE,OAAO,CAAC,QAAQ,CAAC,IAAI;YAC/B,SAAS;YACT,SAAS;YACT,IAAI;YACJ,MAAM;YACN,KAAK;YACL,MAAM;YACN,MAAM;SACP,CAAC;IACJ,CAAC;YAAS,CAAC;QACT,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC;IACxB,CAAC;AACH,CAAC"}

package/dist/compare/shoot.js

@@ -0,0 +1,62 @@
+import { join, resolve } from 'node:path';
+import { launchBrowser } from '../core/chrome.js';
+import { sleep, writeBytes } from '../core/files.js';
+import { log } from '../core/log.js';
+import { Page, spreadPositions } from '../core/page.js';
+/**
+ * Screenshots a page at fixed scroll offsets per viewport, scrolling like a real visitor. Never
+ * fails as a whole once the page opened: a slow load, a stuck scroll or a failed shot becomes a
+ * warning and the run returns whatever it got.
+ */
+export async function shoot(options) {
+    const browser = await launchBrowser();
+    const sets = [];
+    try {
+        const page = new Page(browser.cdp, browser.version);
+        await page.init();
+        for (const viewport of options.viewports) {
+            log(`  shoot ${options.url} @ ${viewport.name}`);
+            const warnings = [];
+            await page.setViewport(viewport);
+            const { loaded } = await page.goto(options.url, 0);
+            if (!loaded)
+                warnings.push(`${viewport.name}: page did not finish loading in 30s; shot anyway`);
+            await page.settle(options.settleMs ?? 5000);
+            const maxScroll = await page.maxScroll().catch(() => 0);
+            const pageHeight = await page.pageHeight().catch(() => 0);
+            const raw = options.positions ?? spreadPositions(maxScroll, options.count ?? 6);
+            const positions = options.relative ? raw.map((p) => Math.round(p * maxScroll)) : raw;
+            const shots = [];
+            const probes = [];
+            for (const y of positions) {
+                const actualY = await page.scrollTo(y, viewport, 10_000).catch(() => {
+                    warnings.push(`${viewport.name}: scroll to ${String(y)} failed`);
+                    return -1;
+                });
+                await sleep(700);
+                if (options.probe) {
+                    const value = await page.evaluate(options.probe).catch((error) => ({
+                        error: error instanceof Error ? error.message : String(error),
+                    }));
+                    probes.push({ y, value });
+                }
+                const png = await page.screenshot().catch(() => null);
+                if (!png) {
+                    warnings.push(`${viewport.name}: screenshot at ${String(y)} failed`);
+                    continue;
+                }
+                shots.push({ y, actualY, png });
+                if (options.out) {
+                    const name = `${options.prefix ?? 'shot'}-${viewport.name}-${y}.png`;
+                    await writeBytes(join(resolve(options.out), name), png);
+                }
+            }
+            sets.push({ url: options.url, viewport, pageHeight, maxScroll, shots, probes, warnings });
+        }
+    }
+    finally {
+        await browser.close();
+    }
+    return sets;
+}
+//# sourceMappingURL=shoot.js.map

package/dist/compare/shoot.js.map

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

package/dist/contracts/catalog.js

@@ -0,0 +1,29 @@
+import { analyzeTool } from './tools/analyze.js';
+import { captureTool } from './tools/capture.js';
+import { compareTool, shootTool } from './tools/compare.js';
+import { doctorTool } from './tools/doctor.js';
+import { inspectTool } from './tools/inspect.js';
+import { guideTool, setupTool } from './tools/method.js';
+import { serveMirrorTool, stopMirrorTool } from './tools/mirror.js';
+import { assetsTool, scaffoldTool } from './tools/project.js';
+import { draftTool, startTool, statusTool, stopTool } from './tools/session.js';
+/** Every public tool, in the order shown in help and MCP listings. */
+export const CATALOG = [
+    guideTool,
+    setupTool,
+    startTool,
+    statusTool,
+    stopTool,
+    captureTool,
+    analyzeTool,
+    inspectTool,
+    serveMirrorTool,
+    stopMirrorTool,
+    scaffoldTool,
+    draftTool,
+    assetsTool,
+    shootTool,
+    compareTool,
+    doctorTool,
+];
+//# sourceMappingURL=catalog.js.map

package/dist/contracts/catalog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.js","sourceRoot":"","sources":["../../src/contracts/catalog.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACpE,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAC9D,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAGhF,sEAAsE;AACtE,MAAM,CAAC,MAAM,OAAO,GAA2B;IAC7C,SAAS;IACT,SAAS;IACT,SAAS;IACT,UAAU;IACV,QAAQ;IACR,WAAW;IACX,WAAW;IACX,WAAW;IACX,eAAe;IACf,cAAc;IACd,YAAY;IACZ,SAAS;IACT,UAAU;IACV,SAAS;IACT,WAAW;IACX,UAAU;CACX,CAAC"}

package/dist/contracts/context.js

@@ -0,0 +1,19 @@
+/** Mirrors started by this process, so MCP can stop them and the CLI can close them on exit. */
+export class MirrorRegistry {
+    #mirrors = new Map();
+    add(mirror) {
+        this.#mirrors.set(mirror.url, mirror);
+    }
+    urls() {
+        return [...this.#mirrors.keys()].sort();
+    }
+    async stop(url) {
+        const targets = url === undefined ? this.urls() : [url];
+        for (const target of targets) {
+            await this.#mirrors.get(target)?.close();
+            this.#mirrors.delete(target);
+        }
+        return targets;
+    }
+}
+//# sourceMappingURL=context.js.map

package/dist/contracts/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/contracts/context.ts"],"names":[],"mappings":"AAEA,gGAAgG;AAChG,MAAM,OAAO,cAAc;IAChB,QAAQ,GAAG,IAAI,GAAG,EAAkB,CAAC;IAE9C,GAAG,CAAC,MAAc;QAChB,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IACxC,CAAC;IAED,IAAI;QACF,OAAO,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAC1C,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,GAAY;QACrB,MAAM,OAAO,GAAG,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;QACxD,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;YAC7B,MAAM,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC;YACzC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAC/B,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;CACF"}

package/dist/contracts/fields.js

@@ -0,0 +1,16 @@
+import { z } from 'zod';
+export const viewportsField = z
+    .string()
+    .optional()
+    .describe('Comma list of desktop, mobile, name:WIDTHxHEIGHT, or auto (adds one per major CSS breakpoint). Default desktop,mobile.');
+export const positionsField = z
+    .array(z.number().nonnegative())
+    .optional()
+    .describe('Scroll offsets in px (fractions 0–1 with relative). Comma list on the CLI.');
+export const settleField = z
+    .number()
+    .int()
+    .min(0)
+    .optional()
+    .describe('Extra wait in ms after the page looks settled.');
+//# sourceMappingURL=fields.js.map

package/dist/contracts/fields.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fields.js","sourceRoot":"","sources":["../../src/contracts/fields.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC;KAC5B,MAAM,EAAE;KACR,QAAQ,EAAE;KACV,QAAQ,CACP,wHAAwH,CACzH,CAAC;AAEJ,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC;KAC5B,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,WAAW,EAAE,CAAC;KAC/B,QAAQ,EAAE;KACV,QAAQ,CAAC,4EAA4E,CAAC,CAAC;AAE1F,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC;KACzB,MAAM,EAAE;KACR,GAAG,EAAE;KACL,GAAG,CAAC,CAAC,CAAC;KACN,QAAQ,EAAE;KACV,QAAQ,CAAC,gDAAgD,CAAC,CAAC"}

package/dist/contracts/tools/analyze.js

@@ -0,0 +1,38 @@
+import { z } from 'zod';
+import { analyze } from '../../analyze/analyze.js';
+import { ok } from '../../domain/result.js';
+import { RunFolder } from '../../store/run.js';
+import { renderSummary, runSummary } from '../../store/summary.js';
+import { defineTool } from '../types.js';
+export const analyzeTool = defineTool({
+    name: 'analyze',
+    title: 'Re-run analysis on a capture',
+    description: 'Rebuild section bundles, tokens, code split, animation extraction and REPORT.md for an existing capture folder, in an isolated worker with heap and time limits.',
+    input: z.object({
+        run: z.string().describe('Capture folder.'),
+        timeoutMs: z.number().int().min(10_000).default(300_000),
+        maxHeapMb: z.number().int().min(256).max(16_384).default(2048),
+    }),
+    cli: { command: 'analyze', positionals: ['run'] },
+    readOnly: false,
+    openWorld: false,
+    run: async (input, context) => {
+        const opened = await RunFolder.open(input.run);
+        if (!opened.ok)
+            return opened;
+        const result = await analyze({
+            dir: opened.value.dir,
+            timeoutMs: input.timeoutMs,
+            maxHeapMb: input.maxHeapMb,
+            signal: context.signal,
+        });
+        if (!result.ok)
+            return result;
+        const reopened = await RunFolder.open(input.run);
+        if (!reopened.ok)
+            return reopened;
+        const summary = await runSummary(reopened.value);
+        return ok({ data: { ...summary, analysis: result.value }, text: renderSummary(summary) });
+    },
+});
+//# sourceMappingURL=analyze.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"analyze.js","sourceRoot":"","sources":["../../../src/contracts/tools/analyze.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AACnD,OAAO,EAAE,EAAE,EAAE,MAAM,wBAAwB,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACnE,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,MAAM,CAAC,MAAM,WAAW,GAAG,UAAU,CAAC;IACpC,IAAI,EAAE,SAAS;IACf,KAAK,EAAE,8BAA8B;IACrC,WAAW,EACT,kKAAkK;IACpK,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC;QACd,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,iBAAiB,CAAC;QAC3C,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC;QACxD,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC;KAC/D,CAAC;IACF,GAAG,EAAE,EAAE,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,CAAC,KAAK,CAAC,EAAE;IACjD,QAAQ,EAAE,KAAK;IACf,SAAS,EAAE,KAAK;IAChB,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;QAC5B,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC/C,IAAI,CAAC,MAAM,CAAC,EAAE;YAAE,OAAO,MAAM,CAAC;QAC9B,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC;YAC3B,GAAG,EAAE,MAAM,CAAC,KAAK,CAAC,GAAG;YACrB,SAAS,EAAE,KAAK,CAAC,SAAS;YAC1B,SAAS,EAAE,KAAK,CAAC,SAAS;YAC1B,MAAM,EAAE,OAAO,CAAC,MAAM;SACvB,CAAC,CAAC;QACH,IAAI,CAAC,MAAM,CAAC,EAAE;YAAE,OAAO,MAAM,CAAC;QAC9B,MAAM,QAAQ,GAAG,MAAM,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACjD,IAAI,CAAC,QAAQ,CAAC,EAAE;YAAE,OAAO,QAAQ,CAAC;QAClC,MAAM,OAAO,GAAG,MAAM,UAAU,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QACjD,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE,GAAG,OAAO,EAAE,QAAQ,EAAE,MAAM,CAAC,KAAK,EAAE,EAAE,IAAI,EAAE,aAAa,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAC5F,CAAC;CACF,CAAC,CAAC"}