@12ui/design 0.2.75 → 0.2.77

package/dist/scene/page-merge.js

@@ -0,0 +1,197 @@
+import { parseHTML } from 'linkedom';
+import { mediaQueryMatchesFrame } from './media-query.js';
+import { SceneArgumentError } from './numbers.js';
+import { emptyMediaDecisions, resolveMediaAtFrame, viewportUnitsToPx } from './page-css.js';
+import { classifyRef, cssImageRefs, cssImageRefsInRules, dropCssImages, isImageRef, srcsetUrls, } from './page-images.js';
+import { bandsShownAtFrame } from './responsive-bands.js';
+const GOOGLE_FONTS_STYLESHEET = /^https:\/\/fonts\.googleapis\.com\//iu;
+const REMOTE_URL = /^(?:[a-z][a-z0-9+.-]*:)?\/\//iu;
+/** Attributes that load a resource, per element; `srcset` lists several. */
+const RESOURCE_ATTRIBUTES = [
+    ['img[src]', 'src'], ['img[srcset]', 'srcset'], ['source[src]', 'src'], ['source[srcset]', 'srcset'],
+    ['video[poster]', 'poster'], ['input[src]', 'src'], ['image[href]', 'href'], ['use[href]', 'href'],
+];
+const isStylesheetLink = (element) => (element.tagName.toLowerCase() === 'link'
+    && (element.getAttribute('rel') ?? '').toLowerCase().split(/\s+/u).includes('stylesheet'));
+const describe = (element) => {
+    const tag = element.tagName.toLowerCase();
+    const id = element.getAttribute('id');
+    const className = (element.getAttribute('class') ?? '').trim().split(/\s+/u)[0];
+    const alt = element.getAttribute('alt')?.trim();
+    const name = id ? `<${tag}#${id}>` : className ? `<${tag}.${className}>` : `<${tag}>`;
+    return alt ? `${name} "${alt.length > 48 ? `${alt.slice(0, 47)}…` : alt}"` : name;
+};
+const elementRefs = (element, attribute) => {
+    const value = element.getAttribute(attribute) ?? '';
+    const values = attribute === 'srcset' ? srcsetUrls(value) : [value];
+    return values.map(classifyRef).filter((ref) => ref !== undefined);
+};
+/** Decides a `media` attribute at the frame: false removes the element, true drops the attribute. */
+const decideMediaAttribute = (element, frame, media) => {
+    const query = element.getAttribute('media');
+    if (query === null)
+        return;
+    const label = `<${element.tagName.toLowerCase()} media="${query}">`;
+    const applies = mediaQueryMatchesFrame(query, frame);
+    if (applies === true) {
+        media.applied.push(label);
+        element.removeAttribute('media');
+    }
+    else if (applies === false) {
+        media.removed.push(label);
+        element.remove();
+    }
+    else {
+        media.undecided.push(label);
+    }
+};
+export const mergePage = (input) => {
+    const { document } = parseHTML(input.html);
+    const all = (selector) => Array.from(document.querySelectorAll(selector));
+    const media = emptyMediaDecisions();
+    for (const element of all('style[media], link[media], picture > source[media]')) {
+        decideMediaAttribute(element, input.frame, media);
+    }
+    for (const style of all('style')) {
+        style.textContent = viewportUnitsToPx(resolveMediaAtFrame(style.textContent ?? '', input.frame, media), input.frame);
+    }
+    for (const element of all('[style]')) {
+        element.setAttribute('style', viewportUnitsToPx(element.getAttribute('style') ?? '', input.frame));
+    }
+    let bands;
+    if (input.engine === 'api') {
+        const decision = bandsShownAtFrame(all('style').map((style) => style.textContent ?? ''));
+        if (decision) {
+            const removed = [];
+            for (const band of all('.ly-band[data-ly-band]')) {
+                const name = band.getAttribute('data-ly-band') ?? '';
+                if (decision.removable(name)) {
+                    removed.push(name);
+                    band.remove();
+                }
+            }
+            bands = { shown: decision.shown, removed };
+        }
+    }
+    const removedScripts = [];
+    for (const script of all('body script[src]')) {
+        const source = script.getAttribute('src') ?? '';
+        if (REMOTE_URL.test(source.trim())) {
+            removedScripts.push(source);
+            script.remove();
+        }
+    }
+    const collectImages = () => {
+        const images = new Map();
+        const note = (ref, usedBy) => {
+            if (!isImageRef(ref))
+                return;
+            const entry = images.get(ref.ref) ?? {
+                ref: ref.ref, kind: ref.kind, value: ref.value, usedBy: [],
+                ...(input.boxes.has(ref.ref) ? { box: input.boxes.get(ref.ref) } : {}),
+            };
+            if (!entry.usedBy.includes(usedBy))
+                entry.usedBy.push(usedBy);
+            images.set(ref.ref, entry);
+        };
+        for (const [selector, attribute] of RESOURCE_ATTRIBUTES) {
+            for (const element of all(selector))
+                for (const ref of elementRefs(element, attribute))
+                    note(ref, describe(element));
+        }
+        for (const style of all('style')) {
+            for (const ref of cssImageRefsInRules(style.textContent ?? ''))
+                note(ref, ref.rule ? `css ${ref.rule}` : 'css');
+        }
+        for (const element of all('[style]')) {
+            for (const ref of cssImageRefs(element.getAttribute('style') ?? ''))
+                note(ref, `style of ${describe(element)}`);
+        }
+        return [...images.values()];
+    };
+    const before = collectImages();
+    const known = new Set(before.map((image) => image.ref));
+    const unknown = input.drop.filter((ref) => !known.has(ref));
+    if (unknown.length) {
+        throw new SceneArgumentError(`--drop names ${unknown.join(', ')}, which ${unknown.length === 1 ? 'is' : 'are'} not`
+            + ` an image of this page. Its images are: ${before.map((image) => image.ref).join(', ') || 'none'}.`);
+    }
+    const dropped = new Set(input.drop);
+    if (dropped.size) {
+        for (const [selector, attribute] of RESOURCE_ATTRIBUTES) {
+            for (const element of all(selector)) {
+                if (elementRefs(element, attribute).some((ref) => dropped.has(ref.ref)))
+                    element.remove();
+            }
+        }
+        for (const style of all('style'))
+            style.textContent = dropCssImages(style.textContent ?? '', dropped);
+        for (const element of all('[style]'))
+            element.setAttribute('style', dropCssImages(element.getAttribute('style') ?? '', dropped));
+    }
+    const images = collectImages();
+    const fonts = [];
+    const remote = new Set();
+    const files = new Set();
+    const headParts = [];
+    const notCarried = [];
+    for (const element of Array.from(document.head.children)) {
+        const tag = element.tagName.toLowerCase();
+        if (tag === 'style' || isStylesheetLink(element)) {
+            headParts.push(element.outerHTML);
+            continue;
+        }
+        if (tag === 'meta' || tag === 'title')
+            continue;
+        if (tag === 'link' && /preconnect|dns-prefetch/iu.test(element.getAttribute('rel') ?? ''))
+            continue;
+        notCarried.push(element.outerHTML.length > 120 ? `${element.outerHTML.slice(0, 119)}…` : element.outerHTML);
+    }
+    for (const link of all('link[href]').filter(isStylesheetLink)) {
+        const ref = classifyRef(link.getAttribute('href') ?? '');
+        if (ref?.kind === 'file')
+            files.add(ref.ref);
+        else if (ref?.kind === 'remote')
+            (GOOGLE_FONTS_STYLESHEET.test(ref.value) ? fonts.push(ref.value) : remote.add(ref.value));
+    }
+    for (const script of all('body script[src]')) {
+        const ref = classifyRef(script.getAttribute('src') ?? '');
+        if (ref?.kind === 'file')
+            files.add(ref.ref);
+    }
+    for (const [selector, attribute] of RESOURCE_ATTRIBUTES) {
+        for (const element of all(selector)) {
+            for (const ref of elementRefs(element, attribute)) {
+                if (ref.kind === 'file')
+                    files.add(ref.ref);
+                if (ref.kind === 'remote')
+                    remote.add(ref.value);
+            }
+        }
+    }
+    const cssTexts = [...all('style').map((style) => style.textContent ?? ''), ...all('[style]').map((element) => element.getAttribute('style') ?? '')];
+    for (const ref of cssTexts.flatMap(cssImageRefs)) {
+        if (ref.kind === 'file')
+            files.add(ref.ref);
+        if (ref.kind === 'remote')
+            remote.add(ref.value);
+    }
+    const bodyAttributes = Array.from(document.body.attributes);
+    if (bodyAttributes.length) {
+        notCarried.push(`<body ${bodyAttributes.map((attribute) => `${attribute.name}="${attribute.value}"`).join(' ')}>`);
+    }
+    return {
+        head: headParts.join('\n'),
+        body: document.body.innerHTML,
+        images,
+        dropped: [...dropped],
+        files: [...files],
+        fonts,
+        remote: [...remote],
+        removedScripts,
+        media,
+        ...(bands ? { bands } : {}),
+        notCarried,
+    };
+};
+//# sourceMappingURL=page-merge.js.map

package/dist/scene/page-merge.js.map

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

package/dist/scene/responsive-bands.d.ts

@@ -0,0 +1,19 @@
+/**
+ * The API engine's responsive page (`<meta name="responsive-band-assembly">`)
+ * carries one complete layout per band, `<div class="ly-band" data-ly-band=NAME>`.
+ * Its CSS hides every band (`.ly-band{display:none}`) and shows one per
+ * `@media` block (`.ly-band[data-ly-band="NAME"]{display:block}`). Once those
+ * blocks are decided at the source frame, the show rules that survive name the
+ * bands that paint at that frame; the rest can never paint in the scene.
+ *
+ * Removing a band needs both declared facts: the hide rule, and at least one
+ * surviving show rule. Without them every band stays (a band that is kept but
+ * hidden costs bytes; a band removed in error is a hole).
+ */
+export type BandDecision = {
+    shown: string[];
+    removable: (band: string) => boolean;
+};
+/** The bands the frame-decided CSS shows, or null when it does not prove which bands are hidden. */
+export declare const bandsShownAtFrame: (resolvedCss: readonly string[]) => BandDecision | null;
+//# sourceMappingURL=responsive-bands.d.ts.map

package/dist/scene/responsive-bands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"responsive-bands.d.ts","sourceRoot":"","sources":["../../src/scene/responsive-bands.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAKH,MAAM,MAAM,YAAY,GAAG;IAAE,KAAK,EAAE,MAAM,EAAE,CAAC;IAAC,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAA;CAAE,CAAC;AAErF,oGAAoG;AACpG,eAAO,MAAM,iBAAiB,GAAI,aAAa,SAAS,MAAM,EAAE,KAAG,YAAY,GAAG,IAMjF,CAAC"}

package/dist/scene/responsive-bands.js

@@ -0,0 +1,25 @@
+/**
+ * The API engine's responsive page (`<meta name="responsive-band-assembly">`)
+ * carries one complete layout per band, `<div class="ly-band" data-ly-band=NAME>`.
+ * Its CSS hides every band (`.ly-band{display:none}`) and shows one per
+ * `@media` block (`.ly-band[data-ly-band="NAME"]{display:block}`). Once those
+ * blocks are decided at the source frame, the show rules that survive name the
+ * bands that paint at that frame; the rest can never paint in the scene.
+ *
+ * Removing a band needs both declared facts: the hide rule, and at least one
+ * surviving show rule. Without them every band stays (a band that is kept but
+ * hidden costs bytes; a band removed in error is a hole).
+ */
+const HIDE_RULE = /\.ly-band\s*\{\s*display\s*:\s*none\b/iu;
+const SHOW_RULE = /\.ly-band\[data-ly-band\s*=\s*(["']?)([^"'\]\s]+)\1\s*\]\s*\{\s*display\s*:\s*(?!none\b)[a-z-]+/giu;
+/** The bands the frame-decided CSS shows, or null when it does not prove which bands are hidden. */
+export const bandsShownAtFrame = (resolvedCss) => {
+    const css = resolvedCss.join('\n');
+    if (!HIDE_RULE.test(css))
+        return null;
+    const shown = [...new Set([...css.matchAll(SHOW_RULE)].map((match) => match[2]))];
+    if (shown.length === 0)
+        return null;
+    return { shown, removable: (band) => !shown.includes(band) };
+};
+//# sourceMappingURL=responsive-bands.js.map

package/dist/scene/responsive-bands.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"responsive-bands.js","sourceRoot":"","sources":["../../src/scene/responsive-bands.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,MAAM,SAAS,GAAG,yCAAyC,CAAC;AAC5D,MAAM,SAAS,GAAG,oGAAoG,CAAC;AAIvH,oGAAoG;AACpG,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,WAA8B,EAAuB,EAAE;IACvF,MAAM,GAAG,GAAG,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACnC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IACtC,MAAM,KAAK,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,GAAG,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,CAAE,CAAC,CAAC,CAAC,CAAC;IACnF,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACpC,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;AAC/D,CAAC,CAAC"}

package/dist/scene/scene-index.d.ts

@@ -0,0 +1,10 @@
+export type StarterInsertion = {
+    html: string;
+    replaced: boolean;
+};
+export declare const insertIntoStarter: (starter: string, page: {
+    head: string;
+    body: string;
+    label: string;
+}, file: string) => StarterInsertion;
+//# sourceMappingURL=scene-index.d.ts.map

package/dist/scene/scene-index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scene-index.d.ts","sourceRoot":"","sources":["../../src/scene/scene-index.ts"],"names":[],"mappings":"AAqBA,MAAM,MAAM,gBAAgB,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAA;CAAE,CAAC;AAEnE,eAAO,MAAM,iBAAiB,GAAI,SAAS,MAAM,EAAE,MAAM;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,EAAE,MAAM,MAAM,KAAG,gBAyBtH,CAAC"}

package/dist/scene/scene-index.js

@@ -0,0 +1,43 @@
+import { SceneArgumentError } from './numbers.js';
+/**
+ * Puts a merged page into the scene's index.html as text, so nothing else in
+ * the starter is re-serialized: the page's styles go into <head> just before
+ * the starter's first <style> (so the starter's rules win where they overlap),
+ * and its body goes inside the empty `#stage`. Both are fenced with comments,
+ * and a later merge replaces exactly what an earlier one wrote.
+ */
+const HEAD_BEGIN = '<!-- 12ui scene merge: page head';
+const BODY_BEGIN = '<!-- 12ui scene merge: page body';
+const END = '<!-- 12ui scene merge: end -->';
+const escapeRegExp = (text) => text.replace(/[.*+?^${}()|[\]\\]/gu, '\\$&');
+const fenced = (begin) => new RegExp(`${escapeRegExp(begin)}[^>]*-->[\\s\\S]*?${escapeRegExp(END)}`, 'u');
+const STAGE = new RegExp(`(<div\\b[^>]*\\bid\\s*=\\s*(["']?)stage\\2(?=[\\s>/])[^>]*>)(\\s*(?:${escapeRegExp(BODY_BEGIN)}[^>]*-->[\\s\\S]*?${escapeRegExp(END)})?\\s*)</div>`, 'u');
+export const insertIntoStarter = (starter, page, file) => {
+    const stage = STAGE.exec(starter);
+    if (!stage) {
+        const hasStage = /\bid\s*=\s*["']?stage\b/u.test(starter);
+        throw new SceneArgumentError(hasStage
+            ? `#stage in ${file} already holds content that 12ui scene merge did not write. Merge into a fresh starter`
+                + ' (12ui scene init <new-dir>), or move that content out of #stage first.'
+            : `${file} has no <div id="stage">: merge needs the starter index.html from 12ui scene init.`);
+    }
+    const replaced = stage[3].includes(BODY_BEGIN);
+    const bodyBlock = `${BODY_BEGIN} from ${page.label} -->\n${page.body}\n${END}`;
+    const headBlock = `${HEAD_BEGIN} from ${page.label} -->\n${page.head}\n${END}\n`;
+    let html = `${starter.slice(0, stage.index)}${stage[1]}${bodyBlock}</div>${starter.slice(stage.index + stage[0].length)}`;
+    const previousHead = fenced(HEAD_BEGIN).exec(html);
+    if (previousHead) {
+        html = `${html.slice(0, previousHead.index)}${headBlock.trimEnd()}${html.slice(previousHead.index + previousHead[0].length)}`;
+    }
+    else {
+        const headEnd = html.search(/<\/head\s*>/iu);
+        const headStart = html.search(/<head\b[^>]*>/iu);
+        if (headEnd < 0 || headStart < 0)
+            throw new SceneArgumentError(`${file} has no <head>: merge needs the starter index.html from 12ui scene init.`);
+        const style = html.slice(headStart, headEnd).search(/<style\b/iu);
+        const at = style >= 0 ? headStart + style : headEnd;
+        html = `${html.slice(0, at)}${headBlock}${html.slice(at)}`;
+    }
+    return { html, replaced };
+};
+//# sourceMappingURL=scene-index.js.map

package/dist/scene/scene-index.js.map

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

package/dist/scene/scene-merge.d.ts

@@ -0,0 +1,29 @@
+import { type ConvertRunPage } from './convert-run.js';
+import { type MergedPage } from './page-merge.js';
+/**
+ * `12ui scene merge <convert-run> <scene-dir>`: joins the page a `12ui convert`
+ * run built to the scene. It reads the run by its recorded engine
+ * (convert-run.ts), makes the page ready for `#stage` (page-merge.ts), writes
+ * it into the scene's index.html (scene-index.ts) and copies the files the page
+ * loads beside it, keeping their paths. Every check runs before the first write.
+ */
+export type MergeReport = {
+    run: ConvertRunPage;
+    merged: MergedPage;
+    indexFile: string;
+    replaced: boolean;
+    copied: string[];
+    alreadyThere: string[];
+    missing: string[];
+};
+export declare const mergeConvertRun: (args: {
+    runDir: string;
+    sceneDir: string;
+    drop: readonly string[];
+}) => Promise<MergeReport>;
+/** The report printed by the verb: what was merged, the images to choose from, what is left to do. */
+export declare const formatMergeReport: (report: MergeReport, shown: {
+    run: string;
+    scene: string;
+}) => string[];
+//# sourceMappingURL=scene-merge.d.ts.map

package/dist/scene/scene-merge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scene-merge.d.ts","sourceRoot":"","sources":["../../src/scene/scene-merge.ts"],"names":[],"mappings":"AAGA,OAAO,EAAkB,KAAK,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAGvE,OAAO,EAAa,KAAK,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAG7D;;;;;;GAMG;AAEH,MAAM,MAAM,WAAW,GAAG;IACxB,GAAG,EAAE,cAAc,CAAC;IACpB,MAAM,EAAE,UAAU,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB,CAAC;AA8BF,eAAO,MAAM,eAAe,GAAU,MAAM;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAA;CAAE,KAAG,OAAO,CAAC,WAAW,CAoD9H,CAAC;AAIF,sGAAsG;AACtG,eAAO,MAAM,iBAAiB,GAAI,QAAQ,WAAW,EAAE,OAAO;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,KAAG,MAAM,EA6BpG,CAAC"}

package/dist/scene/scene-merge.js

@@ -0,0 +1,130 @@
+import { copyFile, mkdir, readFile, writeFile } from 'node:fs/promises';
+import path from 'node:path';
+import { readConvertRun } from './convert-run.js';
+import { SceneArgumentError } from './numbers.js';
+import { cssImageRefs, formatBox } from './page-images.js';
+import { mergePage } from './page-merge.js';
+import { insertIntoStarter } from './scene-index.js';
+const readBytes = async (file) => {
+    try {
+        return await readFile(file);
+    }
+    catch (error) {
+        if (['ENOENT', 'ENOTDIR', 'EISDIR'].includes(error.code ?? ''))
+            return undefined;
+        throw error;
+    }
+};
+const inside = (root, relative) => {
+    const resolved = path.resolve(root, relative);
+    return resolved.startsWith(`${path.resolve(root)}${path.sep}`) ? resolved : undefined;
+};
+/** The page's local files plus the files its local stylesheets load, as page-relative paths. */
+const filesToCopy = async (pageDir, files) => {
+    const all = new Set(files);
+    for (const file of files.filter((name) => name.toLowerCase().endsWith('.css'))) {
+        const source = inside(pageDir, file);
+        const css = source ? await readBytes(source) : undefined;
+        if (!css)
+            continue;
+        for (const ref of cssImageRefs(css.toString('utf8'))) {
+            if (ref.kind === 'file')
+                all.add(path.posix.normalize(path.posix.join(path.posix.dirname(file), ref.ref)));
+        }
+    }
+    return [...all];
+};
+export const mergeConvertRun = async (args) => {
+    const run = await readConvertRun(args.runDir);
+    const indexFile = path.join(path.resolve(args.sceneDir), 'index.html');
+    const starter = await readBytes(indexFile);
+    if (!starter)
+        throw new SceneArgumentError(`${indexFile} is missing: run 12ui scene init ${args.sceneDir} first.`);
+    const merged = mergePage({
+        html: await readFile(run.page, 'utf8'),
+        frame: run.frame,
+        engine: run.engine,
+        boxes: run.boxes,
+        drop: args.drop,
+    });
+    const label = `${path.relative(path.dirname(indexFile), run.page) || run.page} (${run.engine} engine)`;
+    const inserted = insertIntoStarter(starter.toString('utf8'), { head: merged.head, body: merged.body, label }, indexFile);
+    const pageDir = path.dirname(run.page);
+    const plan = [];
+    const alreadyThere = [];
+    const missing = [];
+    for (const relative of await filesToCopy(pageDir, merged.files)) {
+        const source = inside(pageDir, relative);
+        const target = inside(path.dirname(indexFile), relative);
+        const bytes = source ? await readBytes(source) : undefined;
+        if (!source || !target || !bytes) {
+            missing.push(relative);
+            continue;
+        }
+        const existing = await readBytes(target);
+        if (existing?.equals(bytes)) {
+            alreadyThere.push(relative);
+            continue;
+        }
+        if (existing) {
+            throw new SceneArgumentError(`The page loads ${relative}, and ${target} already exists with different content.`
+                + ' Merge writes nothing over a scene file: rename or move that file, then merge again.');
+        }
+        plan.push({ relative, source, target, bytes });
+    }
+    for (const file of plan) {
+        await mkdir(path.dirname(file.target), { recursive: true });
+        await copyFile(file.source, file.target);
+    }
+    await writeFile(indexFile, inserted.html);
+    return {
+        run,
+        merged,
+        indexFile,
+        replaced: inserted.replaced,
+        copied: plan.map((file) => file.relative),
+        alreadyThere,
+        missing,
+    };
+};
+const list = (values) => values.join(', ');
+/** The report printed by the verb: what was merged, the images to choose from, what is left to do. */
+export const formatMergeReport = (report, shown) => {
+    const { run, merged } = report;
+    const lines = [
+        `merged ${path.join(shown.run, path.relative(run.runDir, run.page))} (${run.engine} engine, ${run.frame.width}x${run.frame.height}`
+            + ` source frame) into ${path.join(shown.scene, 'index.html')}${report.replaced ? ', replacing the earlier merge' : ''}`,
+    ];
+    const { applied, removed, undecided } = merged.media;
+    if (applied.length || removed.length || undecided.length) {
+        lines.push(`  @media at ${run.frame.width}x${run.frame.height}: ${applied.length} apply (rules kept), ${removed.length} do not (removed)`
+            + `${undecided.length ? `, ${undecided.length} depend on the viewer (kept as written: ${list(undecided)})` : ''}`);
+    }
+    if (merged.bands) {
+        lines.push(`  responsive bands: kept ${list(merged.bands.shown)}${merged.bands.removed.length ? `, removed ${list(merged.bands.removed)}` : ''}`);
+    }
+    for (const script of merged.removedScripts)
+        lines.push(`  removed remote script ${script}`);
+    if (report.copied.length)
+        lines.push(`  copied beside index.html: ${list(report.copied)}`);
+    if (report.alreadyThere.length)
+        lines.push(`  already beside index.html: ${list(report.alreadyThere)}`);
+    if (report.missing.length)
+        lines.push(`  warning: the page loads files that are not in the run: ${list(report.missing)}`);
+    for (const element of merged.notCarried)
+        lines.push(`  not carried into the scene: ${element}`);
+    if (merged.dropped.length)
+        lines.push(`dropped: ${list(merged.dropped)}`);
+    lines.push(merged.images.length
+        ? `images (drop the ones the 3D scene replaces with --drop <image>,...; box is x0,y0,x1,y1 where the run declares it):`
+        : 'images: none');
+    for (const image of merged.images) {
+        lines.push(`  ${image.ref}${image.box ? `  box ${formatBox(image.box)}` : ''}  ${list(image.usedBy)}`);
+    }
+    for (const url of merged.fonts)
+        lines.push(`fonts: ${url}`);
+    for (const url of merged.remote)
+        lines.push(`remote (capture blocks it): ${url}`);
+    return lines;
+};
+//# sourceMappingURL=scene-merge.js.map

package/dist/scene/scene-merge.js.map

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

package/dist/scene/scene-verbs.d.ts

@@ -1,4 +1,4 @@
 /** The `12ui scene` verbs, named once for the dispatcher and the capability record. */
-export declare const SCENE_VERBS: readonly ["init", "solve", "ray", "project", "rect", "serve", "capture", "sheet", "blend", "colors", "rectify"];
+export declare const SCENE_VERBS: readonly ["init", "solve", "ray", "project", "rect", "serve", "capture", "sheet", "blend", "colors", "rectify", "merge"];
 export type SceneVerb = typeof SCENE_VERBS[number];
 //# sourceMappingURL=scene-verbs.d.ts.map

package/dist/scene/scene-verbs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"scene-verbs.d.ts","sourceRoot":"","sources":["../../src/scene/scene-verbs.ts"],"names":[],"mappings":"AAAA,uFAAuF;AACvF,eAAO,MAAM,WAAW,iHAEd,CAAC;AAEX,MAAM,MAAM,SAAS,GAAG,OAAO,WAAW,CAAC,MAAM,CAAC,CAAC"}
+{"version":3,"file":"scene-verbs.d.ts","sourceRoot":"","sources":["../../src/scene/scene-verbs.ts"],"names":[],"mappings":"AAAA,uFAAuF;AACvF,eAAO,MAAM,WAAW,0HAEd,CAAC;AAEX,MAAM,MAAM,SAAS,GAAG,OAAO,WAAW,CAAC,MAAM,CAAC,CAAC"}

package/dist/scene/scene-verbs.js

@@ -1,5 +1,5 @@
 /** The `12ui scene` verbs, named once for the dispatcher and the capability record. */
 export const SCENE_VERBS = [
-    'init', 'solve', 'ray', 'project', 'rect', 'serve', 'capture', 'sheet', 'blend', 'colors', 'rectify',
+    'init', 'solve', 'ray', 'project', 'rect', 'serve', 'capture', 'sheet', 'blend', 'colors', 'rectify', 'merge',
 ];
 //# sourceMappingURL=scene-verbs.js.map

package/dist/scene/scene-verbs.js.map

@@ -1 +1 @@
-{"version":3,"file":"scene-verbs.js","sourceRoot":"","sources":["../../src/scene/scene-verbs.ts"],"names":[],"mappings":"AAAA,uFAAuF;AACvF,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,SAAS;CAC5F,CAAC"}
+{"version":3,"file":"scene-verbs.js","sourceRoot":"","sources":["../../src/scene/scene-verbs.ts"],"names":[],"mappings":"AAAA,uFAAuF;AACvF,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,OAAO;CACrG,CAAC"}

package/dist/scene/serve-detach.d.ts

@@ -0,0 +1,23 @@
+/**
+ * `12ui scene serve --detach`: the server as its own detached process (a new
+ * session, no terminal, stdio in a log file), so it outlives the shell that
+ * launched it. An agent's tool shell ends, or kills its process group, when
+ * the command returns; a plain `serve ... &` died with it and the next capture
+ * met ERR_CONNECTION_REFUSED. The launcher returns only once the port answers
+ * with this child's pid, so a printed URL is a working URL.
+ */
+export type DetachedServer = {
+    url: string;
+    port: number;
+    pid: number;
+    logFile: string;
+};
+export type DetachOptions = {
+    directory: string;
+    port: number;
+    /** The command that runs a foreground server on `--port <port>`; argv[0] is the executable. */
+    command: (port: number) => string[];
+    readyTimeoutMs?: number;
+};
+export declare const startDetachedServer: (options: DetachOptions) => Promise<DetachedServer>;
+//# sourceMappingURL=serve-detach.d.ts.map

package/dist/scene/serve-detach.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serve-detach.d.ts","sourceRoot":"","sources":["../../src/scene/serve-detach.ts"],"names":[],"mappings":"AAUA;;;;;;;GAOG;AAEH,MAAM,MAAM,cAAc,GAAG;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAEzF,MAAM,MAAM,aAAa,GAAG;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,+FAA+F;IAC/F,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,EAAE,CAAC;IACpC,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,CAAC;AAqCF,eAAO,MAAM,mBAAmB,GAAU,SAAS,aAAa,KAAG,OAAO,CAAC,cAAc,CA4CxF,CAAC"}