@12ui/design 0.2.48 → 0.2.49

package/dist/redesign-brand-asset-inventory.js

@@ -0,0 +1,318 @@
+import { createHash } from 'node:crypto';
+import { mkdir, writeFile } from 'node:fs/promises';
+import path from 'node:path';
+import sharp from 'sharp';
+/**
+ * Brand assets are evidence collected while the original page is still open.
+ * They are deliberately local capture artifacts: no asset is guessed from a
+ * logo name, and no later stage has to revisit an already-captured site.
+ */
+export const REDESIGN_MAX_BRAND_ASSET_CANDIDATES = 24;
+export const REDESIGN_MAX_NATIVE_BRAND_ASSET_BYTES = 5 * 1024 * 1024;
+const hashBytes = (bytes) => createHash('sha256').update(bytes).digest('hex');
+const dimensionsOf = async (bytes, fallback) => {
+    try {
+        const metadata = await sharp(bytes, { animated: false, failOn: 'warning' }).metadata();
+        if (metadata.width && metadata.height)
+            return { width: metadata.width, height: metadata.height };
+    }
+    catch {
+        // A source can still be useful evidence even when its media parser does not know its canvas.
+    }
+    return {
+        width: Math.max(1, Math.round(fallback[2])),
+        height: Math.max(1, Math.round(fallback[3])),
+    };
+};
+const mediaTypeFromUrl = (sourceUrl) => {
+    const pathname = (() => {
+        try {
+            return new URL(sourceUrl).pathname.toLowerCase();
+        }
+        catch {
+            return '';
+        }
+    })();
+    if (/\.svg$/u.test(pathname))
+        return 'image/svg+xml';
+    if (/\.png$/u.test(pathname))
+        return 'image/png';
+    if (/\.jpe?g$/u.test(pathname))
+        return 'image/jpeg';
+    if (/\.webp$/u.test(pathname))
+        return 'image/webp';
+    if (/\.gif$/u.test(pathname))
+        return 'image/gif';
+    if (/\.avif$/u.test(pathname))
+        return 'image/avif';
+    return 'application/octet-stream';
+};
+const fileExtensionFor = (mediaType) => {
+    const normalized = mediaType.toLowerCase().split(';', 1)[0];
+    if (normalized === 'image/svg+xml')
+        return 'svg';
+    if (normalized === 'image/png')
+        return 'png';
+    if (normalized === 'image/jpeg')
+        return 'jpg';
+    if (normalized === 'image/webp')
+        return 'webp';
+    if (normalized === 'image/gif')
+        return 'gif';
+    if (normalized === 'image/avif')
+        return 'avif';
+    return 'bin';
+};
+const isSameOriginFile = (documentUrl, sourceUrl) => {
+    try {
+        const document = new URL(documentUrl);
+        const source = new URL(sourceUrl);
+        if (document.protocol === 'file:' && source.protocol === 'file:')
+            return true;
+        return document.origin !== 'null' && document.origin === source.origin;
+    }
+    catch {
+        return false;
+    }
+};
+const candidatePath = (inventoryId, mediaType, directory) => (path.resolve(directory, `${inventoryId}.${fileExtensionFor(mediaType)}`));
+/**
+ * Finds all potentially brand-bearing painted nodes in the site's own chrome.
+ * This runs in the already-open page so computed CSS and document-coordinate
+ * geometry are facts from the exact page captured in the screenshot.
+ */
+export const collectRedesignBrandAssetCandidates = async (page) => page.evaluate((maximum) => {
+    const isRootLink = (node) => {
+        const anchor = node.closest('a[href]');
+        const href = anchor?.getAttribute('href');
+        if (!href)
+            return false;
+        // `setContent()` fixtures have an opaque about:blank origin but still
+        // express the same root-link intent as a live document.
+        if (/^\/(?:[?#].*)?$/u.test(href.trim()))
+            return true;
+        try {
+            const url = new URL(href, location.href);
+            return url.origin === location.origin && url.pathname === '/';
+        }
+        catch {
+            return false;
+        }
+    };
+    const isBrandScope = (node) => (node.closest('header, nav, [class*="logo" i]') !== null || isRootLink(node));
+    const domPath = (node) => {
+        const segments = [];
+        let current = node;
+        while (current && current !== document.documentElement) {
+            const tag = current.localName.toLowerCase();
+            if (current.id) {
+                segments.unshift(`${tag}#${current.id}`);
+                break;
+            }
+            let ordinal = 1;
+            let sibling = current.previousElementSibling;
+            while (sibling) {
+                if (sibling.localName === current.localName)
+                    ordinal += 1;
+                sibling = sibling.previousElementSibling;
+            }
+            segments.unshift(`${tag}:nth-of-type(${ordinal})`);
+            current = current.parentElement;
+        }
+        return `html > ${segments.join(' > ')}`;
+    };
+    const sourceFromBackground = (backgroundImage) => {
+        const match = /url\(\s*(['"]?)(.*?)\1\s*\)/u.exec(backgroundImage);
+        if (!match?.[2])
+            return null;
+        try {
+            return new URL(match[2], location.href).href;
+        }
+        catch {
+            return null;
+        }
+    };
+    const scoped = new Set();
+    for (const node of Array.from(document.querySelectorAll('header, header *, nav, nav *, [class*="logo" i], [class*="logo" i] *, a, a *'))) {
+        if (isBrandScope(node))
+            scoped.add(node);
+    }
+    const result = [];
+    for (const node of scoped) {
+        if (result.length >= maximum)
+            break;
+        const rect = node.getBoundingClientRect();
+        if (rect.width < 1 || rect.height < 1)
+            continue;
+        const captureBox = [
+            rect.left + window.scrollX,
+            rect.top + window.scrollY,
+            rect.width,
+            rect.height,
+        ];
+        const path = domPath(node);
+        if (node instanceof HTMLImageElement) {
+            const source = node.currentSrc || node.src;
+            result.push({
+                kind: 'img',
+                domPath: path,
+                captureBox,
+                documentUrl: location.href,
+                sourceUrl: source || null,
+                inlineSvg: null,
+            });
+            continue;
+        }
+        if (node instanceof SVGElement && !node.parentElement?.closest('svg')) {
+            result.push({
+                kind: 'inline-svg',
+                domPath: path,
+                captureBox,
+                documentUrl: location.href,
+                sourceUrl: null,
+                inlineSvg: new XMLSerializer().serializeToString(node),
+            });
+            continue;
+        }
+        const backgroundImage = getComputedStyle(node).backgroundImage;
+        if (backgroundImage && backgroundImage !== 'none') {
+            result.push({
+                kind: 'css-background',
+                domPath: path,
+                captureBox,
+                documentUrl: location.href,
+                sourceUrl: sourceFromBackground(backgroundImage),
+                inlineSvg: null,
+            });
+        }
+    }
+    return result;
+}, REDESIGN_MAX_BRAND_ASSET_CANDIDATES);
+const fetchSameOriginAsset = async (page, sourceUrl) => page.evaluate(async (args) => {
+    try {
+        const response = await fetch(args.sourceUrl, { credentials: 'include' });
+        if (!response.ok)
+            return null;
+        const announcedLength = Number(response.headers.get('content-length'));
+        if (Number.isFinite(announcedLength) && announcedLength > args.maximumBytes)
+            return null;
+        const bytes = new Uint8Array(await response.arrayBuffer());
+        if (bytes.byteLength > args.maximumBytes)
+            return null;
+        let binary = '';
+        for (let start = 0; start < bytes.length; start += 0x8000) {
+            binary += String.fromCharCode(...bytes.subarray(start, start + 0x8000));
+        }
+        return {
+            bytesBase64: btoa(binary),
+            mediaType: response.headers.get('content-type'),
+            finalUrl: response.url,
+        };
+    }
+    catch {
+        return null;
+    }
+}, { sourceUrl, maximumBytes: REDESIGN_MAX_NATIVE_BRAND_ASSET_BYTES });
+const captureFallbackCrop = async (args) => {
+    const bytesPath = candidatePath(args.inventoryId, 'image/png', args.assetsDir);
+    const capture = sharp(args.captureImagePath, { animated: false, failOn: 'warning' });
+    const metadata = await capture.metadata();
+    if (!metadata.width || !metadata.height) {
+        throw new Error(`Captured page ${args.captureImagePath} has no raster dimensions`);
+    }
+    const left = Math.max(0, Math.floor(args.candidate.captureBox[0]));
+    const top = Math.max(0, Math.floor(args.candidate.captureBox[1]));
+    const right = Math.min(metadata.width, Math.ceil(args.candidate.captureBox[0] + args.candidate.captureBox[2]));
+    const bottom = Math.min(metadata.height, Math.ceil(args.candidate.captureBox[1] + args.candidate.captureBox[3]));
+    if (right <= left || bottom <= top) {
+        throw new Error(`Brand candidate ${args.inventoryId} falls outside the captured page frame`);
+    }
+    const bytes = await sharp(args.captureImagePath, { animated: false, failOn: 'warning' })
+        .extract({ left, top, width: right - left, height: bottom - top })
+        .png()
+        .toBuffer();
+    await writeFile(bytesPath, bytes);
+    const dimensions = await dimensionsOf(bytes, args.candidate.captureBox);
+    return {
+        inventoryId: args.inventoryId,
+        pageId: args.pageId,
+        domPath: args.candidate.domPath,
+        captureBox: args.candidate.captureBox,
+        bytesPath,
+        sha256: hashBytes(bytes),
+        mediaType: 'image/png',
+        ...dimensions,
+        sourceUrl: args.candidate.sourceUrl,
+        source: 'screenshot-crop',
+        inlineSvg: false,
+    };
+};
+/**
+ * Freezes a page's brand candidates before its browser closes. Same-origin
+ * files retain their original bytes; inline SVG retains markup; every painted
+ * asset that cannot safely be read natively becomes a PNG crop of the exact
+ * screenshot coordinates recorded in the inventory.
+ */
+export const captureRedesignBrandAssetInventory = async (args) => {
+    await mkdir(args.assetsDir, { recursive: true });
+    const candidates = args.candidates ?? await collectRedesignBrandAssetCandidates(args.page);
+    const entries = [];
+    for (const [index, candidate] of candidates.entries()) {
+        const inventoryId = `${args.pageId}-brand-${String(index + 1).padStart(2, '0')}`;
+        if (candidate.kind === 'inline-svg' && candidate.inlineSvg) {
+            const bytes = Buffer.from(candidate.inlineSvg, 'utf8');
+            const bytesPath = candidatePath(inventoryId, 'image/svg+xml', args.assetsDir);
+            await writeFile(bytesPath, bytes);
+            const dimensions = await dimensionsOf(bytes, candidate.captureBox);
+            entries.push({
+                inventoryId,
+                pageId: args.pageId,
+                domPath: candidate.domPath,
+                captureBox: candidate.captureBox,
+                bytesPath,
+                sha256: hashBytes(bytes),
+                mediaType: 'image/svg+xml',
+                ...dimensions,
+                sourceUrl: null,
+                source: 'inline-svg',
+                inlineSvg: true,
+            });
+            continue;
+        }
+        if (candidate.sourceUrl && isSameOriginFile(candidate.documentUrl, candidate.sourceUrl)) {
+            const fetched = await fetchSameOriginAsset(args.page, candidate.sourceUrl);
+            const finishedSameOrigin = fetched !== null && isSameOriginFile(candidate.documentUrl, fetched.finalUrl);
+            if (finishedSameOrigin && fetched) {
+                const bytes = Buffer.from(fetched.bytesBase64, 'base64');
+                const mediaType = fetched.mediaType?.split(';', 1)[0].trim() || mediaTypeFromUrl(candidate.sourceUrl);
+                const bytesPath = candidatePath(inventoryId, mediaType, args.assetsDir);
+                await writeFile(bytesPath, bytes);
+                const dimensions = await dimensionsOf(bytes, candidate.captureBox);
+                entries.push({
+                    inventoryId,
+                    pageId: args.pageId,
+                    domPath: candidate.domPath,
+                    captureBox: candidate.captureBox,
+                    bytesPath,
+                    sha256: hashBytes(bytes),
+                    mediaType,
+                    // Dimensions follow the frozen source bytes, not CSS density or layout size.
+                    ...dimensions,
+                    sourceUrl: candidate.sourceUrl,
+                    source: 'same-origin-file',
+                    inlineSvg: false,
+                });
+                continue;
+            }
+        }
+        entries.push(await captureFallbackCrop({
+            candidate,
+            pageId: args.pageId,
+            inventoryId,
+            assetsDir: args.assetsDir,
+            captureImagePath: args.captureImagePath,
+        }));
+    }
+    return entries;
+};
+//# sourceMappingURL=redesign-brand-asset-inventory.js.map

package/dist/redesign-brand-asset-inventory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"redesign-brand-asset-inventory.js","sourceRoot":"","sources":["../src/redesign-brand-asset-inventory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B;;;;GAIG;AAEH,MAAM,CAAC,MAAM,mCAAmC,GAAG,EAAE,CAAC;AACtD,MAAM,CAAC,MAAM,qCAAqC,GAAG,CAAC,GAAG,IAAI,GAAG,IAAI,CAAC;AAqDrE,MAAM,SAAS,GAAG,CAAC,KAAiB,EAAU,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAElG,MAAM,YAAY,GAAG,KAAK,EAAE,KAAiB,EAAE,QAA4B,EAA8C,EAAE;IACzH,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,KAAK,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC;QACvF,IAAI,QAAQ,CAAC,KAAK,IAAI,QAAQ,CAAC,MAAM;YAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC;IACnG,CAAC;IAAC,MAAM,CAAC;QACP,6FAA6F;IAC/F,CAAC;IACD,OAAO;QACL,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;QAC3C,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;KAC7C,CAAC;AACJ,CAAC,CAAC;AAEF,MAAM,gBAAgB,GAAG,CAAC,SAAiB,EAAU,EAAE;IACrD,MAAM,QAAQ,GAAG,CAAC,GAAG,EAAE;QACrB,IAAI,CAAC;YACH,OAAO,IAAI,GAAG,CAAC,SAAS,CAAC,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC;QACnD,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,EAAE,CAAC;QACZ,CAAC;IACH,CAAC,CAAC,EAAE,CAAC;IACL,IAAI,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC;QAAE,OAAO,eAAe,CAAC;IACrD,IAAI,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC;QAAE,OAAO,WAAW,CAAC;IACjD,IAAI,WAAW,CAAC,IAAI,CAAC,QAAQ,CAAC;QAAE,OAAO,YAAY,CAAC;IACpD,IAAI,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC;QAAE,OAAO,YAAY,CAAC;IACnD,IAAI,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC;QAAE,OAAO,WAAW,CAAC;IACjD,IAAI,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC;QAAE,OAAO,YAAY,CAAC;IACnD,OAAO,0BAA0B,CAAC;AACpC,CAAC,CAAC;AAEF,MAAM,gBAAgB,GAAG,CAAC,SAAiB,EAAU,EAAE;IACrD,MAAM,UAAU,GAAG,SAAS,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC5D,IAAI,UAAU,KAAK,eAAe;QAAE,OAAO,KAAK,CAAC;IACjD,IAAI,UAAU,KAAK,WAAW;QAAE,OAAO,KAAK,CAAC;IAC7C,IAAI,UAAU,KAAK,YAAY;QAAE,OAAO,KAAK,CAAC;IAC9C,IAAI,UAAU,KAAK,YAAY;QAAE,OAAO,MAAM,CAAC;IAC/C,IAAI,UAAU,KAAK,WAAW;QAAE,OAAO,KAAK,CAAC;IAC7C,IAAI,UAAU,KAAK,YAAY;QAAE,OAAO,MAAM,CAAC;IAC/C,OAAO,KAAK,CAAC;AACf,CAAC,CAAC;AAEF,MAAM,gBAAgB,GAAG,CAAC,WAAmB,EAAE,SAAiB,EAAW,EAAE;IAC3E,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,WAAW,CAAC,CAAC;QACtC,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,SAAS,CAAC,CAAC;QAClC,IAAI,QAAQ,CAAC,QAAQ,KAAK,OAAO,IAAI,MAAM,CAAC,QAAQ,KAAK,OAAO;YAAE,OAAO,IAAI,CAAC;QAC9E,OAAO,QAAQ,CAAC,MAAM,KAAK,MAAM,IAAI,QAAQ,CAAC,MAAM,KAAK,MAAM,CAAC,MAAM,CAAC;IACzE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC,CAAC;AAEF,MAAM,aAAa,GAAG,CAAC,WAAmB,EAAE,SAAiB,EAAE,SAAiB,EAAU,EAAE,CAAC,CAC3F,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,GAAG,WAAW,IAAI,gBAAgB,CAAC,SAAS,CAAC,EAAE,CAAC,CACzE,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,mCAAmC,GAAG,KAAK,EACtD,IAA4B,EACW,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,OAAe,EAAE,EAAE;IAU5E,MAAM,UAAU,GAAG,CAAC,IAAa,EAAW,EAAE;QAC5C,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QACvC,MAAM,IAAI,GAAG,MAAM,EAAE,YAAY,CAAC,MAAM,CAAC,CAAC;QAC1C,IAAI,CAAC,IAAI;YAAE,OAAO,KAAK,CAAC;QACxB,sEAAsE;QACtE,wDAAwD;QACxD,IAAI,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;YAAE,OAAO,IAAI,CAAC;QACtD,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,IAAI,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC;YACzC,OAAO,GAAG,CAAC,MAAM,KAAK,QAAQ,CAAC,MAAM,IAAI,GAAG,CAAC,QAAQ,KAAK,GAAG,CAAC;QAChE,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC,CAAC;IAEF,MAAM,YAAY,GAAG,CAAC,IAAa,EAAW,EAAE,CAAC,CAC/C,IAAI,CAAC,OAAO,CAAC,gCAAgC,CAAC,KAAK,IAAI,IAAI,UAAU,CAAC,IAAI,CAAC,CAC5E,CAAC;IAEF,MAAM,OAAO,GAAG,CAAC,IAAa,EAAU,EAAE;QACxC,MAAM,QAAQ,GAAa,EAAE,CAAC;QAC9B,IAAI,OAAO,GAAmB,IAAI,CAAC;QACnC,OAAO,OAAO,IAAI,OAAO,KAAK,QAAQ,CAAC,eAAe,EAAE,CAAC;YACvD,MAAM,GAAG,GAAG,OAAO,CAAC,SAAS,CAAC,WAAW,EAAE,CAAC;YAC5C,IAAI,OAAO,CAAC,EAAE,EAAE,CAAC;gBACf,QAAQ,CAAC,OAAO,CAAC,GAAG,GAAG,IAAI,OAAO,CAAC,EAAE,EAAE,CAAC,CAAC;gBACzC,MAAM;YACR,CAAC;YACD,IAAI,OAAO,GAAG,CAAC,CAAC;YAChB,IAAI,OAAO,GAAG,OAAO,CAAC,sBAAsB,CAAC;YAC7C,OAAO,OAAO,EAAE,CAAC;gBACf,IAAI,OAAO,CAAC,SAAS,KAAK,OAAO,CAAC,SAAS;oBAAE,OAAO,IAAI,CAAC,CAAC;gBAC1D,OAAO,GAAG,OAAO,CAAC,sBAAsB,CAAC;YAC3C,CAAC;YACD,QAAQ,CAAC,OAAO,CAAC,GAAG,GAAG,gBAAgB,OAAO,GAAG,CAAC,CAAC;YACnD,OAAO,GAAG,OAAO,CAAC,aAAa,CAAC;QAClC,CAAC;QACD,OAAO,UAAU,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;IAC1C,CAAC,CAAC;IAEF,MAAM,oBAAoB,GAAG,CAAC,eAAuB,EAAiB,EAAE;QACtE,MAAM,KAAK,GAAG,8BAA8B,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;QACnE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;YAAE,OAAO,IAAI,CAAC;QAC7B,IAAI,CAAC;YACH,OAAO,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC;QAC/C,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC,CAAC;IAEF,MAAM,MAAM,GAAG,IAAI,GAAG,EAAW,CAAC;IAClC,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,gBAAgB,CACrD,8EAA8E,CAC/E,CAAC,EAAE,CAAC;QACH,IAAI,YAAY,CAAC,IAAI,CAAC;YAAE,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC3C,CAAC;IAED,MAAM,MAAM,GAAgB,EAAE,CAAC;IAC/B,KAAK,MAAM,IAAI,IAAI,MAAM,EAAE,CAAC;QAC1B,IAAI,MAAM,CAAC,MAAM,IAAI,OAAO;YAAE,MAAM;QACpC,MAAM,IAAI,GAAI,IAAoB,CAAC,qBAAqB,EAAE,CAAC;QAC3D,IAAI,IAAI,CAAC,KAAK,GAAG,CAAC,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC;YAAE,SAAS;QAChD,MAAM,UAAU,GAAqC;YACnD,IAAI,CAAC,IAAI,GAAG,MAAM,CAAC,OAAO;YAC1B,IAAI,CAAC,GAAG,GAAG,MAAM,CAAC,OAAO;YACzB,IAAI,CAAC,KAAK;YACV,IAAI,CAAC,MAAM;SACZ,CAAC;QACF,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;QAC3B,IAAI,IAAI,YAAY,gBAAgB,EAAE,CAAC;YACrC,MAAM,MAAM,GAAG,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,GAAG,CAAC;YAC3C,MAAM,CAAC,IAAI,CAAC;gBACV,IAAI,EAAE,KAAK;gBACX,OAAO,EAAE,IAAI;gBACb,UAAU;gBACV,WAAW,EAAE,QAAQ,CAAC,IAAI;gBAC1B,SAAS,EAAE,MAAM,IAAI,IAAI;gBACzB,SAAS,EAAE,IAAI;aAChB,CAAC,CAAC;YACH,SAAS;QACX,CAAC;QACD,IAAI,IAAI,YAAY,UAAU,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YACtE,MAAM,CAAC,IAAI,CAAC;gBACV,IAAI,EAAE,YAAY;gBAClB,OAAO,EAAE,IAAI;gBACb,UAAU;gBACV,WAAW,EAAE,QAAQ,CAAC,IAAI;gBAC1B,SAAS,EAAE,IAAI;gBACf,SAAS,EAAE,IAAI,aAAa,EAAE,CAAC,iBAAiB,CAAC,IAAI,CAAC;aACvD,CAAC,CAAC;YACH,SAAS;QACX,CAAC;QACD,MAAM,eAAe,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAC,eAAe,CAAC;QAC/D,IAAI,eAAe,IAAI,eAAe,KAAK,MAAM,EAAE,CAAC;YAClD,MAAM,CAAC,IAAI,CAAC;gBACV,IAAI,EAAE,gBAAgB;gBACtB,OAAO,EAAE,IAAI;gBACb,UAAU;gBACV,WAAW,EAAE,QAAQ,CAAC,IAAI;gBAC1B,SAAS,EAAE,oBAAoB,CAAC,eAAe,CAAC;gBAChD,SAAS,EAAE,IAAI;aAChB,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC,EAAE,mCAAmC,CAAC,CAAC;AAExC,MAAM,oBAAoB,GAAG,KAAK,EAChC,IAA4B,EAC5B,SAAiB,EACY,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,IAAiD,EAAE,EAAE;IAC1G,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,SAAS,EAAE,EAAE,WAAW,EAAE,SAAS,EAAE,CAAC,CAAC;QACzE,IAAI,CAAC,QAAQ,CAAC,EAAE;YAAE,OAAO,IAAI,CAAC;QAC9B,MAAM,eAAe,GAAG,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC,CAAC;QACvE,IAAI,MAAM,CAAC,QAAQ,CAAC,eAAe,CAAC,IAAI,eAAe,GAAG,IAAI,CAAC,YAAY;YAAE,OAAO,IAAI,CAAC;QACzF,MAAM,KAAK,GAAG,IAAI,UAAU,CAAC,MAAM,QAAQ,CAAC,WAAW,EAAE,CAAC,CAAC;QAC3D,IAAI,KAAK,CAAC,UAAU,GAAG,IAAI,CAAC,YAAY;YAAE,OAAO,IAAI,CAAC;QACtD,IAAI,MAAM,GAAG,EAAE,CAAC;QAChB,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,KAAK,CAAC,MAAM,EAAE,KAAK,IAAI,MAAM,EAAE,CAAC;YAC1D,MAAM,IAAI,MAAM,CAAC,YAAY,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,CAAC,CAAC,CAAC;QAC1E,CAAC;QACD,OAAO;YACL,WAAW,EAAE,IAAI,CAAC,MAAM,CAAC;YACzB,SAAS,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC;YAC/C,QAAQ,EAAE,QAAQ,CAAC,GAAG;SACvB,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC,EAAE,EAAE,SAAS,EAAE,YAAY,EAAE,qCAAqC,EAAE,CAAC,CAAC;AAEvE,MAAM,mBAAmB,GAAG,KAAK,EAAE,IAMlC,EAA6C,EAAE;IAC9C,MAAM,SAAS,GAAG,aAAa,CAAC,IAAI,CAAC,WAAW,EAAE,WAAW,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;IAC/E,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,gBAAgB,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC;IACrF,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,QAAQ,EAAE,CAAC;IAC1C,IAAI,CAAC,QAAQ,CAAC,KAAK,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC;QACxC,MAAM,IAAI,KAAK,CAAC,iBAAiB,IAAI,CAAC,gBAAgB,2BAA2B,CAAC,CAAC;IACrF,CAAC;IACD,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACnE,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAClE,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,CAC9C,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC,CAAC,CAC5D,CAAC,CAAC;IACH,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC,IAAI,CAChD,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC,CAAC,CAC5D,CAAC,CAAC;IACH,IAAI,KAAK,IAAI,IAAI,IAAI,MAAM,IAAI,GAAG,EAAE,CAAC;QACnC,MAAM,IAAI,KAAK,CAAC,mBAAmB,IAAI,CAAC,WAAW,wCAAwC,CAAC,CAAC;IAC/F,CAAC;IACD,MAAM,KAAK,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,gBAAgB,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;SACrF,OAAO,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,KAAK,GAAG,IAAI,EAAE,MAAM,EAAE,MAAM,GAAG,GAAG,EAAE,CAAC;SACjE,GAAG,EAAE;SACL,QAAQ,EAAE,CAAC;IACd,MAAM,SAAS,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;IAClC,MAAM,UAAU,GAAG,MAAM,YAAY,CAAC,KAAK,EAAE,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;IACxE,OAAO;QACL,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO;QAC/B,UAAU,EAAE,IAAI,CAAC,SAAS,CAAC,UAAU;QACrC,SAAS;QACT,MAAM,EAAE,SAAS,CAAC,KAAK,CAAC;QACxB,SAAS,EAAE,WAAW;QACtB,GAAG,UAAU;QACb,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,SAAS;QACnC,MAAM,EAAE,iBAAiB;QACzB,SAAS,EAAE,KAAK;KACjB,CAAC;AACJ,CAAC,CAAC;AAEF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,kCAAkC,GAAG,KAAK,EAAE,IAQxD,EAA+C,EAAE;IAChD,MAAM,KAAK,CAAC,IAAI,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACjD,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,IAAI,MAAM,mCAAmC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC3F,MAAM,OAAO,GAAuC,EAAE,CAAC;IACvD,KAAK,MAAM,CAAC,KAAK,EAAE,SAAS,CAAC,IAAI,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC;QACtD,MAAM,WAAW,GAAG,GAAG,IAAI,CAAC,MAAM,UAAU,MAAM,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC;QACjF,IAAI,SAAS,CAAC,IAAI,KAAK,YAAY,IAAI,SAAS,CAAC,SAAS,EAAE,CAAC;YAC3D,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;YACvD,MAAM,SAAS,GAAG,aAAa,CAAC,WAAW,EAAE,eAAe,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;YAC9E,MAAM,SAAS,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;YAClC,MAAM,UAAU,GAAG,MAAM,YAAY,CAAC,KAAK,EAAE,SAAS,CAAC,UAAU,CAAC,CAAC;YACnE,OAAO,CAAC,IAAI,CAAC;gBACX,WAAW;gBACX,MAAM,EAAE,IAAI,CAAC,MAAM;gBACnB,OAAO,EAAE,SAAS,CAAC,OAAO;gBAC1B,UAAU,EAAE,SAAS,CAAC,UAAU;gBAChC,SAAS;gBACT,MAAM,EAAE,SAAS,CAAC,KAAK,CAAC;gBACxB,SAAS,EAAE,eAAe;gBAC1B,GAAG,UAAU;gBACb,SAAS,EAAE,IAAI;gBACf,MAAM,EAAE,YAAY;gBACpB,SAAS,EAAE,IAAI;aAChB,CAAC,CAAC;YACH,SAAS;QACX,CAAC;QAED,IAAI,SAAS,CAAC,SAAS,IAAI,gBAAgB,CAAC,SAAS,CAAC,WAAW,EAAE,SAAS,CAAC,SAAS,CAAC,EAAE,CAAC;YACxF,MAAM,OAAO,GAAG,MAAM,oBAAoB,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;YAC3E,MAAM,kBAAkB,GAAG,OAAO,KAAK,IAAI,IAAI,gBAAgB,CAAC,SAAS,CAAC,WAAW,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;YACzG,IAAI,kBAAkB,IAAI,OAAO,EAAE,CAAC;gBAClC,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;gBACzD,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,EAAE,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,IAAI,gBAAgB,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;gBACtG,MAAM,SAAS,GAAG,aAAa,CAAC,WAAW,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;gBACxE,MAAM,SAAS,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;gBAClC,MAAM,UAAU,GAAG,MAAM,YAAY,CAAC,KAAK,EAAE,SAAS,CAAC,UAAU,CAAC,CAAC;gBACnE,OAAO,CAAC,IAAI,CAAC;oBACX,WAAW;oBACX,MAAM,EAAE,IAAI,CAAC,MAAM;oBACnB,OAAO,EAAE,SAAS,CAAC,OAAO;oBAC1B,UAAU,EAAE,SAAS,CAAC,UAAU;oBAChC,SAAS;oBACT,MAAM,EAAE,SAAS,CAAC,KAAK,CAAC;oBACxB,SAAS;oBACT,6EAA6E;oBAC7E,GAAG,UAAU;oBACb,SAAS,EAAE,SAAS,CAAC,SAAS;oBAC9B,MAAM,EAAE,kBAAkB;oBAC1B,SAAS,EAAE,KAAK;iBACjB,CAAC,CAAC;gBACH,SAAS;YACX,CAAC;QACH,CAAC;QAED,OAAO,CAAC,IAAI,CAAC,MAAM,mBAAmB,CAAC;YACrC,SAAS;YACT,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,WAAW;YACX,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,gBAAgB,EAAE,IAAI,CAAC,gBAAgB;SACxC,CAAC,CAAC,CAAC;IACN,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC,CAAC"}

package/dist/redesign-capture.d.ts

@@ -0,0 +1,57 @@
+import { type RedesignBrandAssetInventoryEntry } from './redesign-brand-asset-inventory.js';
+import type { RedesignCapturedPageRecord } from './redesign-workspace.js';
+/**
+ * Stage 1: full-height screenshots of a target site's key pages.
+ *
+ * Discovery reads one page's HTML over `fetch` and keeps same-origin links
+ * found in `nav`/`header`/`footer` (where a site states its own key pages),
+ * falling back to the whole document when none of those hold a link. It never
+ * launches a browser: link discovery is free and must stay that way so
+ * `--dry-run` can report a page count without paying for a screenshot.
+ *
+ * Screenshotting is the one real Playwright dependency in this package (every
+ * other stage buys through the hosted API). `capturePage` is injected so
+ * tests exercise the stage's plumbing — file layout, hashing, the record —
+ * without a real browser or network call; the default implementation is only
+ * reached in production.
+ */
+export declare const REDESIGN_DEFAULT_MAX_PAGES = 5;
+/**
+ * Same-origin URLs a caller would call this site's key pages: the homepage
+ * first, then links found in navigational chrome, deduplicated by pathname
+ * and capped at `maxPages`.
+ */
+export declare const discoverRedesignPageUrls: (args: {
+    url: string;
+    maxPages?: number;
+    fetchHtml?: (url: string) => Promise<string>;
+}) => Promise<string[]>;
+export type RedesignCapturePageResult = {
+    width: number;
+    height: number;
+    /** Frozen while the page is open, before its browser context is discarded. */
+    brandAssetInventory?: RedesignBrandAssetInventoryEntry[];
+};
+/** Capture-stage page record. The workspace record can carry this subtype unchanged. */
+export type RedesignCapturedPageWithBrandAssetInventory = RedesignCapturedPageRecord & {
+    brandAssetInventory: RedesignBrandAssetInventoryEntry[];
+};
+export type RedesignCaptureDependencies = {
+    /**
+     * Injectable browser boundary. Test callers can return a frozen inventory
+     * directly, so capture-stage record plumbing has no browser dependency.
+     */
+    capturePage?: (args: {
+        url: string;
+        outFile: string;
+        pageId: string;
+        brandAssetInventoryDir: string;
+    }) => Promise<RedesignCapturePageResult>;
+};
+/** Full-height screenshots of every discovered URL, written into `outDir`. */
+export declare const captureRedesignPages: (args: {
+    urls: readonly string[];
+    outDir: string;
+    dependencies?: RedesignCaptureDependencies;
+}) => Promise<RedesignCapturedPageWithBrandAssetInventory[]>;
+//# sourceMappingURL=redesign-capture.d.ts.map

package/dist/redesign-capture.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"redesign-capture.d.ts","sourceRoot":"","sources":["../src/redesign-capture.ts"],"names":[],"mappings":"AAOA,OAAO,EAGL,KAAK,gCAAgC,EAEtC,MAAM,qCAAqC,CAAC;AAC7C,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,yBAAyB,CAAC;AAE1E;;;;;;;;;;;;;;GAcG;AAEH,eAAO,MAAM,0BAA0B,IAAI,CAAC;AAyB5C;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,GAAU,MAAM;IACnD,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;CAC9C,KAAG,OAAO,CAAC,MAAM,EAAE,CA6BnB,CAAC;AAEF,MAAM,MAAM,yBAAyB,GAAG;IACtC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,8EAA8E;IAC9E,mBAAmB,CAAC,EAAE,gCAAgC,EAAE,CAAC;CAC1D,CAAC;AAEF,wFAAwF;AACxF,MAAM,MAAM,2CAA2C,GAAG,0BAA0B,GAAG;IACrF,mBAAmB,EAAE,gCAAgC,EAAE,CAAC;CACzD,CAAC;AAEF,MAAM,MAAM,2BAA2B,GAAG;IACxC;;;OAGG;IACH,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE;QACnB,GAAG,EAAE,MAAM,CAAC;QACZ,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,EAAE,MAAM,CAAC;QACf,sBAAsB,EAAE,MAAM,CAAC;KAChC,KAAK,OAAO,CAAC,yBAAyB,CAAC,CAAC;CAC1C,CAAC;AA8DF,8EAA8E;AAC9E,eAAO,MAAM,oBAAoB,GAAU,MAAM;IAC/C,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,2BAA2B,CAAC;CAC5C,KAAG,OAAO,CAAC,2CAA2C,EAAE,CA0CxD,CAAC"}

package/dist/redesign-capture.js

@@ -0,0 +1,181 @@
+import { createHash } from 'node:crypto';
+import { mkdir, readFile, stat } from 'node:fs/promises';
+import path from 'node:path';
+import { parseHTML } from 'linkedom';
+import { resolvePrototypeBrowserProvisioning } from './prototype-browsers.js';
+import { captureRedesignBrandAssetInventory, collectRedesignBrandAssetCandidates, } from './redesign-brand-asset-inventory.js';
+/**
+ * Stage 1: full-height screenshots of a target site's key pages.
+ *
+ * Discovery reads one page's HTML over `fetch` and keeps same-origin links
+ * found in `nav`/`header`/`footer` (where a site states its own key pages),
+ * falling back to the whole document when none of those hold a link. It never
+ * launches a browser: link discovery is free and must stay that way so
+ * `--dry-run` can report a page count without paying for a screenshot.
+ *
+ * Screenshotting is the one real Playwright dependency in this package (every
+ * other stage buys through the hosted API). `capturePage` is injected so
+ * tests exercise the stage's plumbing — file layout, hashing, the record —
+ * without a real browser or network call; the default implementation is only
+ * reached in production.
+ */
+export const REDESIGN_DEFAULT_MAX_PAGES = 5;
+const CAPTURE_VIEWPORT = { width: 1440, height: 900 };
+const NAVIGATION_SELECTORS = ['nav', 'header', 'footer'];
+const pageId = (url, index) => {
+    const pathname = (() => {
+        try {
+            return new URL(url).pathname;
+        }
+        catch {
+            return `page-${index}`;
+        }
+    })();
+    const slug = pathname
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/gu, '-')
+        .replace(/^-+|-+$/gu, '');
+    return slug || 'home';
+};
+const defaultFetchHtml = async (url) => {
+    const response = await fetch(url, { redirect: 'follow' });
+    if (!response.ok)
+        throw new Error(`${url} returned HTTP ${response.status}`);
+    return response.text();
+};
+/**
+ * Same-origin URLs a caller would call this site's key pages: the homepage
+ * first, then links found in navigational chrome, deduplicated by pathname
+ * and capped at `maxPages`.
+ */
+export const discoverRedesignPageUrls = async (args) => {
+    const maxPages = args.maxPages ?? REDESIGN_DEFAULT_MAX_PAGES;
+    const origin = new URL(args.url);
+    const html = await (args.fetchHtml ?? defaultFetchHtml)(args.url);
+    const { document } = parseHTML(html);
+    const scopes = NAVIGATION_SELECTORS
+        .flatMap((selector) => Array.from(document.querySelectorAll(selector)));
+    const anchors = (scopes.length > 0 ? scopes : [document])
+        .flatMap((scope) => Array.from(scope.querySelectorAll('a[href]')));
+    const seen = new Set([origin.pathname || '/']);
+    const urls = [origin.toString()];
+    for (const anchor of anchors) {
+        if (urls.length >= maxPages)
+            break;
+        const href = anchor.getAttribute('href');
+        if (!href || href.startsWith('#') || href.startsWith('mailto:') || href.startsWith('tel:'))
+            continue;
+        const resolved = (() => {
+            try {
+                return new URL(href, origin);
+            }
+            catch {
+                return null;
+            }
+        })();
+        if (!resolved || resolved.origin !== origin.origin)
+            continue;
+        const key = resolved.pathname || '/';
+        if (seen.has(key))
+            continue;
+        seen.add(key);
+        urls.push(resolved.toString());
+    }
+    return urls.slice(0, maxPages);
+};
+const validateBrandAssetInventory = async (args) => {
+    const resolvedAssetsDir = path.resolve(args.assetsDir);
+    for (const entry of args.inventory) {
+        if (entry.pageId !== args.pageId) {
+            throw new Error(`Brand asset ${entry.inventoryId} belongs to ${entry.pageId}, not capture page ${args.pageId}`);
+        }
+        if (!entry.inventoryId.startsWith(`${args.pageId}-`)) {
+            throw new Error(`Brand asset ${entry.inventoryId} must be namespaced by capture page ${args.pageId}`);
+        }
+        if (args.seenIds.has(entry.inventoryId)) {
+            throw new Error(`Duplicate brand asset inventoryId ${entry.inventoryId} in this redesign capture`);
+        }
+        const resolvedBytesPath = path.resolve(entry.bytesPath);
+        if (!path.isAbsolute(entry.bytesPath) || path.dirname(resolvedBytesPath) !== resolvedAssetsDir) {
+            throw new Error(`Brand asset ${entry.inventoryId} bytesPath must be directly inside ${resolvedAssetsDir}`);
+        }
+        const frozenBytes = await readFile(resolvedBytesPath);
+        if (createHash('sha256').update(frozenBytes).digest('hex') !== entry.sha256) {
+            throw new Error(`Brand asset ${entry.inventoryId} sha256 does not match its frozen bytes`);
+        }
+        args.seenIds.add(entry.inventoryId);
+    }
+};
+const realCapturePage = async (args) => {
+    const provisioning = await resolvePrototypeBrowserProvisioning();
+    process.env.PLAYWRIGHT_BROWSERS_PATH = provisioning.browsersPath;
+    const { chromium } = await import('@playwright/test');
+    const browser = await chromium.launch();
+    try {
+        const page = await browser.newPage({ viewport: CAPTURE_VIEWPORT });
+        await page.goto(args.url, { waitUntil: 'networkidle' });
+        const brandAssetCandidates = await collectRedesignBrandAssetCandidates(page);
+        await page.screenshot({ path: args.outFile, fullPage: true });
+        const dimensions = await page.evaluate(() => ({
+            width: document.documentElement.scrollWidth,
+            height: document.documentElement.scrollHeight,
+        }));
+        const brandAssetInventory = await captureRedesignBrandAssetInventory({
+            page: page,
+            pageId: args.pageId,
+            assetsDir: args.brandAssetInventoryDir,
+            candidates: brandAssetCandidates,
+            captureImagePath: args.outFile,
+        });
+        return { ...dimensions, brandAssetInventory };
+    }
+    finally {
+        await browser.close();
+    }
+};
+/** Full-height screenshots of every discovered URL, written into `outDir`. */
+export const captureRedesignPages = async (args) => {
+    await mkdir(args.outDir, { recursive: true });
+    const capture = args.dependencies?.capturePage ?? realCapturePage;
+    const used = new Set();
+    const usedBrandAssetIds = new Set();
+    const pages = [];
+    for (const [index, url] of args.urls.entries()) {
+        let id = pageId(url, index);
+        while (used.has(id))
+            id = `${id}-${index}`;
+        used.add(id);
+        const outFile = path.join(args.outDir, `${id}.png`);
+        const brandAssetInventoryDir = path.join(args.outDir, 'brand-assets');
+        // The injection boundary can freeze bytes itself, so make the durable
+        // assets directory available before handing control to either implementation.
+        await mkdir(brandAssetInventoryDir, { recursive: true });
+        const captureResult = await capture({
+            url,
+            outFile,
+            pageId: id,
+            brandAssetInventoryDir,
+        });
+        const brandAssetInventory = captureResult.brandAssetInventory ?? [];
+        await validateBrandAssetInventory({
+            pageId: id,
+            inventory: brandAssetInventory,
+            seenIds: usedBrandAssetIds,
+            assetsDir: brandAssetInventoryDir,
+        });
+        const bytes = await readFile(outFile);
+        const info = await stat(outFile);
+        pages.push({
+            id,
+            url,
+            path: outFile,
+            sha256: createHash('sha256').update(bytes).digest('hex'),
+            bytes: info.size,
+            width: captureResult.width,
+            height: captureResult.height,
+            brandAssetInventory,
+        });
+    }
+    return pages;
+};
+//# sourceMappingURL=redesign-capture.js.map

package/dist/redesign-capture.js.map

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

package/dist/redesign-pinned-asset.d.ts

@@ -0,0 +1,20 @@
+import type { RedesignBrandAssetInventoryEntry } from './redesign-brand-asset-inventory.js';
+import type { RedesignPinnedAssetRecord } from './redesign-workspace.js';
+export type RedesignCapturedAssetInventory = {
+    id: string;
+    /** Optional for records written before capture inventory existed. */
+    brandAssetInventory?: readonly RedesignBrandAssetInventoryEntry[];
+};
+/**
+ * Converts a planner's durable choice into the exact capture evidence it
+ * named. There is deliberately no nearest-match fallback: an absent or
+ * ambiguous choice must not turn into a pin for another asset.
+ */
+export declare const resolveRedesignPinnedAsset: (args: {
+    pinnedAssetChoice: {
+        inventoryId: string;
+        reason: string;
+    } | null;
+    pages: readonly RedesignCapturedAssetInventory[];
+}) => RedesignPinnedAssetRecord | null;
+//# sourceMappingURL=redesign-pinned-asset.d.ts.map

package/dist/redesign-pinned-asset.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"redesign-pinned-asset.d.ts","sourceRoot":"","sources":["../src/redesign-pinned-asset.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gCAAgC,EAAE,MAAM,qCAAqC,CAAC;AAC5F,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,yBAAyB,CAAC;AAEzE,MAAM,MAAM,8BAA8B,GAAG;IAC3C,EAAE,EAAE,MAAM,CAAC;IACX,qEAAqE;IACrE,mBAAmB,CAAC,EAAE,SAAS,gCAAgC,EAAE,CAAC;CACnE,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,0BAA0B,GAAI,MAAM;IAC/C,iBAAiB,EAAE;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAClE,KAAK,EAAE,SAAS,8BAA8B,EAAE,CAAC;CAClD,KAAG,yBAAyB,GAAG,IA2B/B,CAAC"}

package/dist/redesign-pinned-asset.js

@@ -0,0 +1,35 @@
+/**
+ * Converts a planner's durable choice into the exact capture evidence it
+ * named. There is deliberately no nearest-match fallback: an absent or
+ * ambiguous choice must not turn into a pin for another asset.
+ */
+export const resolveRedesignPinnedAsset = (args) => {
+    const choice = args.pinnedAssetChoice;
+    if (choice === null)
+        return null;
+    const matches = args.pages.flatMap((page) => (page.brandAssetInventory ?? [])
+        .filter((asset) => asset.inventoryId === choice.inventoryId)
+        .map((asset) => ({ page, asset })));
+    if (matches.length !== 1) {
+        throw new Error(matches.length === 0
+            ? `Hosted plan chose unknown brand asset ${choice.inventoryId}.`
+            : `Hosted plan chose ambiguous brand asset ${choice.inventoryId}.`);
+    }
+    const { page, asset } = matches[0];
+    if (asset.pageId !== page.id) {
+        throw new Error(`Captured brand asset ${asset.inventoryId} belongs to ${asset.pageId}, not ${page.id}.`);
+    }
+    return {
+        inventoryId: asset.inventoryId,
+        pageId: asset.pageId,
+        sourceUrl: asset.sourceUrl,
+        inlineSvg: asset.inlineSvg,
+        bytesPath: asset.bytesPath,
+        sha256: asset.sha256,
+        mediaType: asset.mediaType,
+        width: asset.width,
+        height: asset.height,
+        captureBox: [...asset.captureBox],
+    };
+};
+//# sourceMappingURL=redesign-pinned-asset.js.map