@12ui/design 0.2.52 → 0.2.54

package/dist/improve-added-specs.js

@@ -0,0 +1,162 @@
+import { mkdir, readFile, readdir, stat, writeFile } from 'node:fs/promises';
+import path from 'node:path';
+import { insertionAnchor, selectorLabel, domPx } from './improve-dom-anchor.js';
+/** Flatten target leaves while retaining group ancestry for sibling placement. */
+export const flattenImproveHierarchy = (document) => {
+    const layers = document && typeof document === 'object' && 'layers' in document
+        && Array.isArray(document.layers) ? document.layers : [];
+    const output = [];
+    const visit = (nodes, parents) => {
+        nodes.forEach((node, index) => {
+            if (!node || typeof node !== 'object')
+                return;
+            const leaf = node;
+            if (leaf.kind === 'group' && Array.isArray(leaf.children)) {
+                visit(leaf.children, [...parents, `${leaf.name ?? 'group'}[${index}]`]);
+            }
+            else
+                output.push({ leaf, parentPath: parents });
+        });
+    };
+    visit(layers, []);
+    return output;
+};
+const commonDepth = (left, right) => {
+    let index = 0;
+    while (index < left.length && left[index] === right[index])
+        index += 1;
+    return index;
+};
+const insertionFor = (args) => {
+    const target = args.normalizedTarget[args.designIndex];
+    const siblings = args.diff.matched.filter((entry) => args.before[entry.beforeIndex]?.dom)
+        .map((entry) => ({
+        entry,
+        depth: commonDepth(args.hierarchy[args.designIndex]?.parentPath ?? [], args.hierarchy[entry.afterIndex]?.parentPath ?? []),
+        distance: target?.box && args.normalizedTarget[entry.afterIndex]?.box
+            ? Math.hypot(target.box[0] - args.normalizedTarget[entry.afterIndex].box[0], target.box[1] - args.normalizedTarget[entry.afterIndex].box[1])
+            : Number.POSITIVE_INFINITY,
+    }))
+        .sort((left, right) => right.depth - left.depth || left.distance - right.distance);
+    const sibling = siblings[0];
+    if (sibling) {
+        const siblingBox = args.normalizedTarget[sibling.entry.afterIndex]?.box;
+        const relation = target?.box && siblingBox
+            && (target.box[1] < siblingBox[1] || (target.box[1] === siblingBox[1] && target.box[0] < siblingBox[0]))
+            ? 'before'
+            : 'after';
+        return `${relation} ${selectorLabel(args.before[sibling.entry.beforeIndex])}`;
+    }
+    if (target?.box) {
+        const fallback = insertionAnchor(target.box, args.before);
+        if (fallback.container >= 0)
+            return `inside ${selectorLabel(args.before[fallback.container])}`;
+    }
+    return 'unresolved — no matched parent or sibling selector';
+};
+const shown = (value, suffix = '') => value === undefined || value === null || value === ''
+    ? 'not specified'
+    : `${typeof value === 'object' ? JSON.stringify(value) : String(value)}${suffix}`;
+const exists = async (file) => Boolean(await stat(file).then(() => true).catch(() => false));
+const artifactIds = (leaf) => {
+    const artifacts = leaf.artifacts;
+    if (!artifacts || typeof artifacts !== 'object' || Array.isArray(artifacts))
+        return [];
+    const preference = ['cutout', 'region2x', 'crop'];
+    return Object.entries(artifacts).flatMap(([name, value]) => (value && typeof value === 'object' && !Array.isArray(value)
+        && typeof value.artifactId === 'string'
+        ? [{ name, id: value.artifactId }]
+        : [])).sort((left, right) => {
+        const leftIndex = preference.indexOf(left.name);
+        const rightIndex = preference.indexOf(right.name);
+        return (leftIndex < 0 ? preference.length : leftIndex)
+            - (rightIndex < 0 ? preference.length : rightIndex);
+    }).map((entry) => entry.id);
+};
+const rasterAsset = async (leaf, designPath) => {
+    const ids = artifactIds(leaf);
+    if (ids.length === 0)
+        return undefined;
+    const directory = `${designPath}.assets`;
+    const manifest = await readFile(path.join(directory, 'manifest.json'), 'utf8')
+        .then((raw) => JSON.parse(raw))
+        .catch(() => ({ artifacts: [] }));
+    for (const id of ids) {
+        const declared = manifest.artifacts?.find((entry) => entry.id === id)?.localPath;
+        const declaredPath = declared
+            ? (path.isAbsolute(declared) ? declared : path.resolve(directory, declared))
+            : undefined;
+        if (declaredPath && await exists(declaredPath)) {
+            return {
+                kind: `extracted artifact ${id}`,
+                path: declaredPath,
+                destination: `src/assets/design/${path.basename(declaredPath)}`,
+                resolvable: true,
+            };
+        }
+        const fallback = await readdir(directory)
+            .then((names) => names.find((name) => name.startsWith(`${id}-`)))
+            .catch(() => undefined);
+        if (fallback) {
+            const assetPath = path.resolve(directory, fallback);
+            return {
+                kind: `extracted artifact ${id}`,
+                path: assetPath,
+                destination: `src/assets/design/${fallback}`,
+                resolvable: true,
+            };
+        }
+    }
+    return { kind: `unresolved extracted artifact (${ids.join(', ')})`, resolvable: false };
+};
+export const buildImproveAddedElementSpecs = async (args) => {
+    const hierarchy = flattenImproveHierarchy(args.targetDoc);
+    const matched = new Set(args.diff.matched.map((entry) => entry.afterIndex));
+    const specs = [];
+    for (const [designIndex, entry] of hierarchy.entries()) {
+        if (matched.has(designIndex))
+            continue;
+        const leaf = entry.leaf;
+        let asset = await rasterAsset(leaf, args.designPath);
+        if (typeof leaf.iconSvg === 'string' && leaf.iconSvg.trim()) {
+            const assetDir = path.join(args.outDir, 'assets');
+            const name = `added-${String(designIndex).padStart(3, '0')}-${(leaf.content ?? 'icon')
+                .toLowerCase().replace(/[^a-z0-9]+/gu, '-').replace(/^-+|-+$/gu, '') || 'icon'}.svg`;
+            await mkdir(assetDir, { recursive: true });
+            const assetPath = path.join(assetDir, name);
+            await writeFile(assetPath, `${leaf.iconSvg.trim()}\n`, 'utf8');
+            asset = {
+                kind: 'inline iconSvg materialized as SVG',
+                path: assetPath,
+                destination: `src/assets/design/${name}`,
+                resolvable: true,
+            };
+        }
+        const insertion = insertionFor({
+            designIndex,
+            hierarchy,
+            normalizedTarget: args.normalizedTarget,
+            before: args.before,
+            diff: args.diff,
+        });
+        const markdown = [
+            `### Added ${designIndex}: ${leaf.kind ?? 'layer'} — ${shown(leaf.content)}`,
+            '',
+            `- Kind: \`${leaf.kind ?? 'layer'}\``,
+            `- Content: ${shown(leaf.content)}`,
+            `- Box: target-design px ${shown(leaf.box)}; DOM-frame px ${shown(domPx(args.normalizedTarget[designIndex]?.box, args.canvas))}`,
+            `- Insert: ${insertion}`,
+            `- Typography: font-family ${shown(leaf.googleFontFamily)}; font-size ${shown(leaf.fontSizePx, leaf.fontSizePx === undefined ? '' : 'px')}; fitted-font-size ${shown(leaf.fittedFontSizePx, leaf.fittedFontSizePx === undefined ? '' : 'px')}; font-weight ${shown(leaf.fontWeight)}; color ${shown(leaf.color)}; align ${shown(leaf.align)}`,
+            `- Style map: \`${JSON.stringify(leaf.style ?? {})}\``,
+            `- Visual fields: surface ${shown(leaf.surface)}; opacity ${shown(leaf.opacity)}; rotation ${shown(leaf.rotationDeg, leaf.rotationDeg === undefined ? '' : 'deg')}`,
+            asset?.path
+                ? `- Asset: ${asset.kind}; absolute path \`${asset.path}\`; suggested destination \`${asset.destination}\`; resolvable: yes`
+                : asset
+                    ? `- Asset: ${asset.kind}; absolute path unresolved; suggested destination unresolved; resolvable: no`
+                    : '- Asset: none referenced by the target node',
+        ].join('\n');
+        specs.push({ designIndex, insertion, markdown, ...(asset ? { asset } : {}) });
+    }
+    return specs;
+};
+//# sourceMappingURL=improve-added-specs.js.map

package/dist/improve-added-specs.js.map

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

package/dist/improve-concept.d.ts

@@ -0,0 +1,10 @@
+/**
+ * F9 found that detailed, style-anchored direction reliably beats a vague
+ * "make it better" instruction. Naming an empty or thin region as the defect
+ * did the opposite: the image model filled it with invented product content.
+ */
+export declare const IMPROVE_NO_INVENTION_CLAUSE = "Keep all real content, data, and controls; invent nothing.";
+/** The real steering limit after reserving room for the mandatory harness. */
+export declare const IMPROVE_DIRECTION_MAX_CHARACTERS: number;
+export declare const buildImproveConcept: (direction?: string) => string;
+//# sourceMappingURL=improve-concept.d.ts.map

package/dist/improve-concept.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"improve-concept.d.ts","sourceRoot":"","sources":["../src/improve-concept.ts"],"names":[],"mappings":"AAGA;;;;GAIG;AACH,eAAO,MAAM,2BAA2B,+DAA+D,CAAC;AAexG,8EAA8E;AAC9E,eAAO,MAAM,gCAAgC,QAAuD,CAAC;AAIrG,eAAO,MAAM,mBAAmB,GAAI,YAAY,MAAM,KAAG,MA2BxD,CAAC"}

package/dist/improve-concept.js

@@ -0,0 +1,45 @@
+import { CliRefusal } from './cli-refusal.js';
+import { MAX_CONCEPT_CHARACTERS, readConceptValue } from './concept-input.js';
+/**
+ * F9 found that detailed, style-anchored direction reliably beats a vague
+ * "make it better" instruction. Naming an empty or thin region as the defect
+ * did the opposite: the image model filled it with invented product content.
+ */
+export const IMPROVE_NO_INVENTION_CLAUSE = 'Keep all real content, data, and controls; invent nothing.';
+const IMPROVE_BASE_DIRECTION = [
+    'Improve this existing product interface into a polished, production-ready version while preserving its product identity and working structure.',
+    'Strengthen visual hierarchy, section rhythm, spacing, alignment, typography, control affordances, surface treatment, and restrained color.',
+    'Use a coherent, style-anchored system with precise rhythm, legible type, purposeful states, subtle borders, and depth only where it clarifies hierarchy.',
+].join(' ');
+const DIRECTION_PREFIX = 'Direction: ';
+const RESERVED_CONCEPT_CHARACTERS = [
+    IMPROVE_BASE_DIRECTION,
+    DIRECTION_PREFIX,
+    IMPROVE_NO_INVENTION_CLAUSE,
+].join('\n\n').length;
+/** The real steering limit after reserving room for the mandatory harness. */
+export const IMPROVE_DIRECTION_MAX_CHARACTERS = MAX_CONCEPT_CHARACTERS - RESERVED_CONCEPT_CHARACTERS;
+const FABRICATION_TRIGGER = /\b(?:empty|emptiness|underfilled|under-filled|thin[ -]content|lack of content|missing content|dead space|blank (?:area|region|half|section))\b/iu;
+export const buildImproveConcept = (direction) => {
+    const steering = direction?.replace(/\s+/gu, ' ').trim() ?? '';
+    if ([...steering].length > IMPROVE_DIRECTION_MAX_CHARACTERS) {
+        throw new CliRefusal(`--direction accepts at most ${IMPROVE_DIRECTION_MAX_CHARACTERS} characters because improve`
+            + ` reserves the rest of the ${MAX_CONCEPT_CHARACTERS}-character concept for its style and`
+            + ' no-invention guardrails.', 'improve_direction_too_long');
+    }
+    if (FABRICATION_TRIGGER.test(steering)) {
+        throw new CliRefusal('--direction must describe the intended style and hierarchy, not emptiness or thin content;'
+            + ' naming a content void invites fabricated UI.', 'improve_direction_emptiness');
+    }
+    const concept = [
+        IMPROVE_BASE_DIRECTION,
+        ...(steering ? [`${DIRECTION_PREFIX}${steering}`] : []),
+        IMPROVE_NO_INVENTION_CLAUSE,
+    ].join('\n\n');
+    return readConceptValue({
+        value: concept,
+        flag: '--direction',
+        trimHint: 'Keep the intended hierarchy, rhythm, typography, surfaces, color, controls, and mood.',
+    });
+};
+//# sourceMappingURL=improve-concept.js.map

package/dist/improve-concept.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"improve-concept.js","sourceRoot":"","sources":["../src/improve-concept.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAE9E;;;;GAIG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAG,4DAA4D,CAAC;AAExG,MAAM,sBAAsB,GAAG;IAC7B,gJAAgJ;IAChJ,4IAA4I;IAC5I,0JAA0J;CAC3J,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAEZ,MAAM,gBAAgB,GAAG,aAAa,CAAC;AACvC,MAAM,2BAA2B,GAAG;IAClC,sBAAsB;IACtB,gBAAgB;IAChB,2BAA2B;CAC5B,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC;AAEtB,8EAA8E;AAC9E,MAAM,CAAC,MAAM,gCAAgC,GAAG,sBAAsB,GAAG,2BAA2B,CAAC;AAErG,MAAM,mBAAmB,GAAG,kJAAkJ,CAAC;AAE/K,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,SAAkB,EAAU,EAAE;IAChE,MAAM,QAAQ,GAAG,SAAS,EAAE,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC;IAC/D,IAAI,CAAC,GAAG,QAAQ,CAAC,CAAC,MAAM,GAAG,gCAAgC,EAAE,CAAC;QAC5D,MAAM,IAAI,UAAU,CAClB,+BAA+B,gCAAgC,6BAA6B;cAC1F,6BAA6B,sBAAsB,sCAAsC;cACzF,2BAA2B,EAC7B,4BAA4B,CAC7B,CAAC;IACJ,CAAC;IACD,IAAI,mBAAmB,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;QACvC,MAAM,IAAI,UAAU,CAClB,4FAA4F;cAC1F,+CAA+C,EACjD,6BAA6B,CAC9B,CAAC;IACJ,CAAC;IACD,MAAM,OAAO,GAAG;QACd,sBAAsB;QACtB,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,GAAG,gBAAgB,GAAG,QAAQ,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACvD,2BAA2B;KAC5B,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACf,OAAO,gBAAgB,CAAC;QACtB,KAAK,EAAE,OAAO;QACd,IAAI,EAAE,aAAa;QACnB,QAAQ,EAAE,uFAAuF;KAClG,CAAC,CAAC;AACL,CAAC,CAAC"}

package/dist/improve-delivery-stages.d.ts

@@ -0,0 +1,16 @@
+import type { ImproveOptions } from './improve-options.js';
+import { type ImproveCommandDependencies } from './improve-stage-shared.js';
+import { type ImproveRecord } from './improve-workspace.js';
+export declare const runImproveConvertStage: (args: {
+    record: ImproveRecord;
+    options: ImproveOptions;
+    dependencies: ImproveCommandDependencies;
+    price: number;
+}) => Promise<ImproveRecord>;
+export declare const runImprovePlanStage: (args: {
+    record: ImproveRecord;
+    options: ImproveOptions;
+    dependencies: ImproveCommandDependencies;
+    price: number;
+}) => Promise<ImproveRecord>;
+//# sourceMappingURL=improve-delivery-stages.d.ts.map

package/dist/improve-delivery-stages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"improve-delivery-stages.d.ts","sourceRoot":"","sources":["../src/improve-delivery-stages.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAG3D,OAAO,EAGL,KAAK,0BAA0B,EAChC,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EAAsB,KAAK,aAAa,EAAE,MAAM,wBAAwB,CAAC;AA+BhF,eAAO,MAAM,sBAAsB,GAAU,MAAM;IACjD,MAAM,EAAE,aAAa,CAAC;IACtB,OAAO,EAAE,cAAc,CAAC;IACxB,YAAY,EAAE,0BAA0B,CAAC;IACzC,KAAK,EAAE,MAAM,CAAC;CACf,KAAG,OAAO,CAAC,aAAa,CA0ExB,CAAC;AA6FF,eAAO,MAAM,mBAAmB,GAAU,MAAM;IAC9C,MAAM,EAAE,aAAa,CAAC;IACtB,OAAO,EAAE,cAAc,CAAC;IACxB,YAAY,EAAE,0BAA0B,CAAC;IACzC,KAAK,EAAE,MAAM,CAAC;CACf,KAAG,OAAO,CAAC,aAAa,CA6DxB,CAAC"}

package/dist/improve-delivery-stages.js

@@ -0,0 +1,259 @@
+import { copyFile, cp, mkdir, readFile, stat, writeFile } from 'node:fs/promises';
+import path from 'node:path';
+import sharp from 'sharp';
+import { runConversionCommand } from './cli-convert-command.js';
+import { CliRefusal } from './cli-refusal.js';
+import { prepareOutputDirectory } from './cli-output-paths.js';
+import { writeImproveDomDiff } from './improve-dom-diff.js';
+import { evaluateImproveGate } from './improve-dom-gate.js';
+import { normalizeLayerDoc } from './improve-dom-scale.js';
+import { canvasOfDoc, diffLayerDocs, flattenLayerDoc } from './improve-layerdoc-diff.js';
+import { writeImproveAnnotatedPlan } from './improve-plan-annotator.js';
+import { renderLayerChanges } from './improve-plan-render.js';
+import { improveSha256, noteImproveStage, } from './improve-stage-shared.js';
+import { writeImproveRecord } from './improve-workspace.js';
+const runConvert = async (args) => {
+    const artifacts = [];
+    const purchaseIds = [];
+    const collector = {
+        note: (facts) => {
+            artifacts.push(...(facts.artifacts ?? []));
+            purchaseIds.push(...(facts.purchased ?? []));
+            args.journal?.note(facts);
+        },
+        heartbeat: (progress) => { args.journal?.heartbeat(progress); },
+    };
+    await args.runner(['convert', args.input], {
+        output: args.output,
+        model: args.model,
+        'out-dir': args.outDir,
+        'idempotency-key': args.key,
+        quiet: true,
+    }, collector, { writeResult: () => undefined });
+    return { artifacts: [...new Set(artifacts)], purchaseIds: [...new Set(purchaseIds)] };
+};
+export const runImproveConvertStage = async (args) => {
+    if (args.record.convert)
+        return noteImproveStage({
+            record: args.record, stage: 'convert', priceCeilingUsd: args.price, replayed: true, write: true,
+        });
+    if (!args.record.pick && !args.record.target)
+        throw new Error('Cannot convert before pick');
+    await prepareOutputDirectory(args.options.paths.targetDir);
+    if (args.record.target?.kind === 'layerdoc') {
+        const bytes = await readFile(args.record.target.value);
+        canvasOfDoc(JSON.parse(bytes.toString('utf8')));
+        await copyFile(args.record.target.value, args.options.paths.targetLayerDoc);
+        const assetSource = `${args.record.target.value}.assets`;
+        if ((await stat(assetSource).catch(() => undefined))?.isDirectory()) {
+            await cp(assetSource, `${args.options.paths.targetLayerDoc}.assets`, { recursive: true });
+        }
+        let record = {
+            ...args.record,
+            target: { ...args.record.target, sha256: improveSha256(bytes) },
+            convert: {
+                layerDoc: args.options.paths.targetLayerDoc,
+                html: '',
+                artifacts: [args.options.paths.targetLayerDoc],
+                purchaseIds: [],
+            },
+        };
+        record = await noteImproveStage({
+            record, stage: 'convert', priceCeilingUsd: args.price, replayed: false, write: false,
+        });
+        await writeImproveRecord(args.options.paths.record, record);
+        return record;
+    }
+    let input = args.record.pick?.imagePath;
+    let inputSha = args.record.pick?.sha256;
+    let recordBeforeConvert = args.record;
+    if (args.record.target?.kind === 'image') {
+        const bytes = await readFile(args.record.target.value);
+        const image = sharp(bytes, { animated: false, failOn: 'warning' });
+        const metadata = await image.metadata();
+        if (!metadata.width || !metadata.height || !['png', 'jpeg', 'webp'].includes(metadata.format ?? '')) {
+            throw new CliRefusal('--target image is not a usable PNG, JPEG, or WebP', 'improve_target_invalid');
+        }
+        await image.png().toFile(args.options.paths.winnerImage);
+        input = args.options.paths.winnerImage;
+        inputSha = improveSha256(bytes);
+        recordBeforeConvert = { ...args.record, target: { ...args.record.target, sha256: inputSha } };
+    }
+    if (!input || !inputSha)
+        throw new Error('Improve has no design image to convert');
+    const converted = await runConvert({
+        input,
+        outDir: args.options.paths.targetDir,
+        output: 'html',
+        model: args.record.conversionModel,
+        key: `improve-target:v1:${inputSha}:${args.record.conversionModel}`,
+        runner: args.dependencies.runConvert ?? runConversionCommand,
+        journal: args.dependencies.journal,
+    });
+    for (const expected of [args.options.paths.targetLayerDoc, args.options.paths.targetHtml]) {
+        if (!(await stat(expected).catch(() => undefined))?.isFile()) {
+            throw new Error(`Improve conversion completed without ${expected}`);
+        }
+    }
+    let record = {
+        ...recordBeforeConvert,
+        convert: {
+            layerDoc: args.options.paths.targetLayerDoc,
+            html: args.options.paths.targetHtml,
+            artifacts: converted.artifacts,
+            purchaseIds: converted.purchaseIds,
+        },
+    };
+    record = await noteImproveStage({
+        record, stage: 'convert', priceCeilingUsd: args.price, replayed: false, write: false,
+    });
+    await writeImproveRecord(args.options.paths.record, record);
+    return record;
+};
+const syntheticLayerDiff = (beforeDoc, targetDoc) => {
+    const beforeCanvas = canvasOfDoc(beforeDoc);
+    const targetCanvas = canvasOfDoc(targetDoc);
+    const normalizedBefore = normalizeLayerDoc(beforeDoc);
+    const normalizedTarget = normalizeLayerDoc(targetDoc, beforeCanvas.width / targetCanvas.width);
+    const beforeLeaves = flattenLayerDoc(normalizedBefore);
+    const targetLeaves = flattenLayerDoc(normalizedTarget);
+    const result = diffLayerDocs(normalizedBefore, normalizedTarget);
+    const coverage = result.meta.plausibleMatchedCount / Math.max(beforeLeaves.length, 1);
+    return {
+        result,
+        beforeLeaves,
+        targetLeaves,
+        beforeCanvas,
+        targetCanvas,
+        lengthScale: beforeCanvas.width / targetCanvas.width,
+        domCoverage: coverage,
+        designCoverage: result.meta.plausibleMatchedCount / Math.max(targetLeaves.length, 1),
+        gate: evaluateImproveGate(1, 0),
+        markdown: '',
+    };
+};
+const writeImagePlan = async (args) => {
+    const targetDoc = JSON.parse(await readFile(args.options.paths.targetLayerDoc, 'utf8'));
+    let record = args.record;
+    let computed;
+    let mode;
+    const artifacts = [];
+    if (args.record.planSourceConvert) {
+        if (!record.sourceConvert) {
+            await prepareOutputDirectory(args.options.paths.sourceConversionDir);
+            const source = await runConvert({
+                input: args.options.paths.sourceImage,
+                outDir: args.options.paths.sourceConversionDir,
+                output: 'layerdoc',
+                model: record.conversionModel,
+                key: `improve-source:v1:${record.capture?.sha256}:${record.conversionModel}`,
+                runner: args.dependencies.runConvert ?? runConversionCommand,
+                journal: args.dependencies.journal,
+            });
+            const sourceLayerDoc = path.join(args.options.paths.sourceConversionDir, 'source.layerdoc.json');
+            record = { ...record, sourceConvert: { layerDoc: sourceLayerDoc, ...source } };
+            await writeImproveRecord(args.options.paths.record, record);
+        }
+        const beforeDoc = JSON.parse(await readFile(record.sourceConvert.layerDoc, 'utf8'));
+        computed = syntheticLayerDiff(beforeDoc, targetDoc);
+        mode = 'layerdoc-anchored';
+        const diffPath = path.join(args.options.paths.planDir, 'diff.json');
+        const changesPath = path.join(args.options.paths.planDir, 'changes.md');
+        await Promise.all([
+            writeFile(diffPath, `${JSON.stringify({
+                generatedAt: new Date().toISOString(), before: record.sourceConvert.layerDoc,
+                after: args.options.paths.targetLayerDoc, mode, ...computed.result,
+            }, null, 2)}\n`, 'utf8'),
+            writeFile(changesPath, renderLayerChanges({
+                result: computed.result,
+                beforePath: record.sourceConvert.layerDoc,
+                targetPath: args.options.paths.targetLayerDoc,
+                beforeDoc,
+                targetDoc,
+            }), 'utf8'),
+        ]);
+        artifacts.push(diffPath, changesPath);
+    }
+    else {
+        const empty = { version: 2, canvas: canvasOfDoc(targetDoc), layers: [] };
+        computed = syntheticLayerDiff(empty, targetDoc);
+        mode = 'unanchored';
+        const diffPath = path.join(args.options.paths.planDir, 'diff.json');
+        const changesPath = path.join(args.options.paths.planDir, 'changes.md');
+        await Promise.all([
+            writeFile(diffPath, `${JSON.stringify({
+                generatedAt: new Date().toISOString(), mode, after: args.options.paths.targetLayerDoc,
+                note: 'Target-only plan; no source conversion was purchased.', ...computed.result,
+            }, null, 2)}\n`, 'utf8'),
+            writeFile(changesPath, '# Target-only improve plan\n\nNo source conversion was purchased. Every target element is an unanchored implementation specification.\n', 'utf8'),
+        ]);
+        artifacts.push(diffPath, changesPath);
+    }
+    return { computed, mode, artifacts, record };
+};
+export const runImprovePlanStage = async (args) => {
+    if (args.record.plan)
+        return noteImproveStage({
+            record: args.record, stage: 'plan', priceCeilingUsd: args.price, replayed: true, write: true,
+        });
+    if (!args.record.convert)
+        throw new Error('Cannot plan before convert');
+    await mkdir(args.options.paths.planDir, { recursive: true });
+    const targetDoc = JSON.parse(await readFile(args.options.paths.targetLayerDoc, 'utf8'));
+    let record = args.record;
+    let mode;
+    let gate;
+    let artifacts;
+    if (args.options.input.kind === 'url') {
+        const diff = await writeImproveDomDiff({
+            beforePath: args.options.paths.currentDomDoc,
+            targetPath: args.options.paths.targetLayerDoc,
+            outDir: args.options.paths.planDir,
+        });
+        mode = 'dom-anchored';
+        gate = diff.gate.passed ? 'passed' : 'blocked';
+        artifacts = [...diff.artifacts];
+        if (diff.gate.passed) {
+            const annotated = await writeImproveAnnotatedPlan({
+                computed: diff,
+                targetDoc,
+                targetPath: args.options.paths.targetLayerDoc,
+                outDir: args.options.paths.planDir,
+                ...(args.record.repo ? { repo: args.record.repo } : {}),
+                mode,
+            });
+            artifacts.push(...annotated.artifacts);
+        }
+    }
+    else {
+        const imagePlan = await writeImagePlan({ record, options: args.options, dependencies: args.dependencies });
+        record = imagePlan.record;
+        mode = imagePlan.mode;
+        gate = 'not-applicable';
+        artifacts = [...imagePlan.artifacts];
+        const annotated = await writeImproveAnnotatedPlan({
+            computed: imagePlan.computed,
+            targetDoc,
+            targetPath: args.options.paths.targetLayerDoc,
+            outDir: args.options.paths.planDir,
+            mode,
+        });
+        artifacts.push(...annotated.artifacts);
+    }
+    record = {
+        ...record,
+        plan: {
+            mode,
+            gate,
+            artifacts: [...new Set(artifacts)],
+            ...(record.sourceConvert ? { sourceLayerDoc: record.sourceConvert.layerDoc } : {}),
+            purchaseIds: record.sourceConvert?.purchaseIds ?? [],
+        },
+    };
+    record = await noteImproveStage({
+        record, stage: 'plan', priceCeilingUsd: args.price, replayed: false, write: false,
+    });
+    await writeImproveRecord(args.options.paths.record, record);
+    return record;
+};
+//# sourceMappingURL=improve-delivery-stages.js.map

package/dist/improve-delivery-stages.js.map

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

package/dist/improve-dom-anchor.d.ts

@@ -0,0 +1,18 @@
+import type { ImpliedPaddingDelta, LayerBox, LayerDiffMatch, LayerLeaf } from './improve-layerdoc-types.js';
+export declare const selectorLabel: (leaf: LayerLeaf | undefined) => string;
+export declare const containment: (inner: LayerBox | undefined, outer: LayerBox | undefined) => number;
+export declare const confidentMatches: (matched: readonly LayerDiffMatch[], before: readonly LayerLeaf[], after: readonly LayerLeaf[], minimumIou?: number) => Set<number>;
+export declare const insertionAnchor: (box: LayerBox, before: readonly LayerLeaf[]) => {
+    container: number;
+    after?: number;
+    before?: number;
+};
+export declare const impliedPaddingDeltas: (matched: readonly LayerDiffMatch[], before: readonly LayerLeaf[], after: readonly LayerLeaf[], canvas: {
+    width: number;
+    height: number;
+}, confident: ReadonlySet<number>) => Map<number, ImpliedPaddingDelta[]>;
+export declare const domPx: (box: LayerBox | undefined, canvas: {
+    width: number;
+    height: number;
+}) => LayerBox | undefined;
+//# sourceMappingURL=improve-dom-anchor.d.ts.map

package/dist/improve-dom-anchor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"improve-dom-anchor.d.ts","sourceRoot":"","sources":["../src/improve-dom-anchor.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,mBAAmB,EACnB,QAAQ,EACR,cAAc,EACd,SAAS,EACV,MAAM,6BAA6B,CAAC;AAErC,eAAO,MAAM,aAAa,GAAI,MAAM,SAAS,GAAG,SAAS,KAAG,MAQ3D,CAAC;AAIF,eAAO,MAAM,WAAW,GAAI,OAAO,QAAQ,GAAG,SAAS,EAAE,OAAO,QAAQ,GAAG,SAAS,KAAG,MAKtF,CAAC;AAEF,eAAO,MAAM,gBAAgB,GAC3B,SAAS,SAAS,cAAc,EAAE,EAClC,QAAQ,SAAS,SAAS,EAAE,EAC5B,OAAO,SAAS,SAAS,EAAE,EAC3B,mBAAgB,KACf,GAAG,CAAC,MAAM,CAcZ,CAAC;AAEF,eAAO,MAAM,eAAe,GAC1B,KAAK,QAAQ,EACb,QAAQ,SAAS,SAAS,EAAE,KAC3B;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CA6BtD,CAAC;AAEF,eAAO,MAAM,oBAAoB,GAC/B,SAAS,SAAS,cAAc,EAAE,EAClC,QAAQ,SAAS,SAAS,EAAE,EAC5B,OAAO,SAAS,SAAS,EAAE,EAC3B,QAAQ;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,EACzC,WAAW,WAAW,CAAC,MAAM,CAAC,KAC7B,GAAG,CAAC,MAAM,EAAE,mBAAmB,EAAE,CA0CnC,CAAC;AAEF,eAAO,MAAM,KAAK;;;0BAAgB,CAAC"}