@12ui/design 0.2.54 → 0.2.56

package/dist/improve-kit-status.js

@@ -0,0 +1,145 @@
+import { stat } from 'node:fs/promises';
+import path from 'node:path';
+import { IMPROVE_STAGES, improvePaths } from './improve-workspace.js';
+const isFile = async (file) => Boolean(await stat(file).then((entry) => entry.isFile()).catch(() => false));
+const isDirectory = async (file) => Boolean(await stat(file).then((entry) => entry.isDirectory()).catch(() => false));
+const stageState = (args) => {
+    const settled = args.record.stages[args.stage];
+    if (!settled) {
+        return IMPROVE_STAGES.indexOf(args.stage) > IMPROVE_STAGES.indexOf(args.requestedTo)
+            ? { stage: args.stage, state: 'not-requested', detail: 'outside the requested stage range' }
+            : { stage: args.stage, state: 'incomplete' };
+    }
+    if (settled.outcome === 'skipped') {
+        return { stage: args.stage, state: 'skipped', detail: 'a target was supplied' };
+    }
+    if (args.blocked) {
+        return {
+            stage: args.stage,
+            state: 'blocked',
+            detail: 'the coverage gate blocked the anchored plan; read `plan/GATE.md`',
+        };
+    }
+    if (!args.delivered)
+        return { stage: args.stage, state: 'incomplete', detail: 'recorded, but its files are not in the kit' };
+    if (args.stage === 'convert' && args.record.convert?.layout === 'fixed') {
+        return {
+            stage: 'convert',
+            state: 'fallback',
+            detail: args.record.convert.responsiveWarning ?? 'Responsive HTML was unavailable.',
+        };
+    }
+    return {
+        stage: args.stage,
+        state: settled.replayCount > 0 ? 'replayed' : 'settled',
+        ...(settled.replayCount > 0 ? { detail: `replayed ${settled.replayCount}×, bought once` } : {}),
+    };
+};
+export const IMPROVE_NO_APPROXIMATION_RULE = 'Do not approximate the design in CSS from the PNG'
+    + ' while a stage is incomplete; resume or convert first.';
+/**
+ * A recovery command is presented as copy-and-run, so it has to survive being
+ * pasted. Capture URLs carry query strings and `--out-dir` paths carry spaces;
+ * either one unquoted breaks the line or backgrounds it at the `&`.
+ */
+export const shellArg = (value) => (/^[A-Za-z0-9_./:=-]+$/u.test(value) ? value : `'${value.replace(/'/gu, "'\\''")}'`);
+export const improveRecoveryCommands = (args) => {
+    const runDir = shellArg(args.record.runDir);
+    const input = shellArg(args.record.input.value);
+    const design = shellArg(args.designImage);
+    return [
+        {
+            command: `12ui improve ${input} --out-dir ${runDir} --from convert`,
+            spends: 'resumes; settled stages replay',
+        },
+        { command: `12ui convert ${design} --output html`, spends: 'buys one conversion' },
+        // `--target` is documented against a URL input. Offering it for an image
+        // input would name a mode the CLI does not document.
+        ...(args.record.input.kind === 'url'
+            ? [{
+                    command: `12ui improve ${input} --target ${design}`,
+                    spends: 'buys one fused target conversion',
+                }]
+            : []),
+    ];
+};
+/** One indented, copy-pasteable line; the cost rides along as a shell comment. */
+export const improveRecoveryLine = (entry) => (`    ${entry.command}  # ${entry.spends}`);
+export const readImproveKitStatus = async (args) => {
+    const paths = improvePaths(args.record.runDir);
+    const requestedTo = args.requestedTo ?? IMPROVE_STAGES[IMPROVE_STAGES.length - 1];
+    const [winner, sourceImage, layerDoc, assets, plan, gate, stall] = await Promise.all([
+        isFile(paths.winnerImage),
+        isFile(paths.sourceImage),
+        isFile(paths.targetLayerDoc),
+        isDirectory(`${paths.targetLayerDoc}.assets`),
+        isFile(path.join(paths.planDir, 'plan-annotated.md')),
+        isFile(path.join(paths.planDir, 'GATE.md')),
+        isFile(path.join(paths.planDir, 'STALL.md')),
+    ]);
+    const recordedHtml = args.record.convert?.html;
+    const targetHtml = recordedHtml ? await isFile(recordedHtml) : await isFile(paths.targetHtml);
+    // Name a file that is actually here. A `--target <layerdoc>` kit never gets a
+    // winner.png, and a run that stalled before pick has only its capture.
+    const captured = args.record.capture?.sourceImage;
+    const designImage = winner
+        ? paths.winnerImage
+        : sourceImage
+            ? paths.sourceImage
+            : captured && await isFile(captured)
+                ? captured
+                : layerDoc && args.record.target?.kind === 'layerdoc'
+                    ? paths.targetLayerDoc
+                    : paths.winnerImage;
+    const designKind = designImage === paths.targetLayerDoc ? 'layerdoc' : 'image';
+    const delivered = {
+        capture: Boolean(args.record.capture),
+        draft: Boolean(args.record.draft),
+        pick: Boolean(args.record.pick),
+        convert: layerDoc,
+        plan: plan || gate,
+    };
+    const gateBlocked = gate && !plan;
+    const stages = IMPROVE_STAGES.map((stage) => stageState({
+        record: args.record,
+        stage,
+        requestedTo,
+        delivered: delivered[stage],
+        blocked: stage === 'plan' && gateBlocked,
+    }));
+    const targetMode = !layerDoc
+        ? 'none'
+        : args.record.convert?.layout === 'fixed'
+            ? 'fixed-layout fallback'
+            : targetHtml ? 'responsive HTML' : 'LayerDoc only';
+    // Only stages the caller actually asked for can be missing. `--to pick` is a
+    // finished run, not an incomplete one.
+    const owed = (stage) => (IMPROVE_STAGES.indexOf(stage) <= IMPROVE_STAGES.indexOf(requestedTo));
+    // A supplied `*.layerdoc.json` target buys no conversion, so it owes neither
+    // extracted assets nor target HTML: naming them missing would be a false alarm.
+    const suppliedDocument = args.record.target?.kind === 'layerdoc';
+    const convertOwed = owed('convert') && !suppliedDocument;
+    const missing = [
+        ...(!owed('convert') || layerDoc ? [] : ['no LayerDoc']),
+        ...(!convertOwed || assets ? [] : ['no assets']),
+        ...(!convertOwed || targetHtml ? [] : ['no target HTML']),
+        ...(!owed('plan') || plan || gate ? [] : ['no plan']),
+    ];
+    const complete = stages.every((entry) => entry.state !== 'incomplete') && missing.length === 0;
+    return {
+        stages,
+        complete,
+        gateBlocked,
+        missing,
+        targetMode,
+        present: { design: winner || sourceImage, layerDoc, assets, targetHtml, plan, gate, stall },
+        designImage,
+        designKind,
+        recovery: improveRecoveryCommands({ record: args.record, designImage }),
+    };
+};
+export const improveStageStatusLine = (status) => {
+    const label = status.state === 'incomplete' ? 'INCOMPLETE' : status.state;
+    return `${status.stage}: ${label}${status.detail ? ` — ${status.detail}` : ''}`;
+};
+//# sourceMappingURL=improve-kit-status.js.map

package/dist/improve-kit-status.js.map

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

package/dist/improve-options.d.ts

@@ -1,6 +1,7 @@
 import type { CreateRetainPolicy } from './branch-client.js';
 import { type CliFlags } from './cli-arguments.js';
 import { type ConversionModel } from './conversion-models.js';
+import { type ResponsiveConversionQuality } from './responsive-quality.js';
 import { type ImproveBootstrapAction } from './redesign-capture.js';
 import { type ImprovePaths, type ImproveStage } from './improve-workspace.js';
 export type ImproveOptions = {
@@ -17,8 +18,13 @@ export type ImproveOptions = {
     candidates: number;
     retain: CreateRetainPolicy;
     retainFlag: string;
-    pick: string;
+    /**
+     * The chosen candidate. Absent means nobody has chosen yet, which is a state
+     * the run stops in rather than a state it guesses its way out of.
+     */
+    pick?: string;
     conversionModel: ConversionModel;
+    responsiveQuality: ResponsiveConversionQuality;
     viewport: {
         width: number;
         height: number;
@@ -32,6 +38,12 @@ export type ImproveOptions = {
     repo?: string;
     planSourceConvert: boolean;
     dryRun: boolean;
+    /** The wait improve gives one half of a fused conversion before it stalls. */
+    convertStallSeconds: number;
+    /** Re-buy ONE conversion of the settled winner under a new key. */
+    fresh: boolean;
+    /** Re-buy the whole draw: new candidates, then a new pick. */
+    redraw: boolean;
 };
 export declare const parseImproveOptions: (args: {
     command: readonly string[];

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

@@ -1 +1 @@
-{"version":3,"file":"improve-options.d.ts","sourceRoot":"","sources":["../src/improve-options.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAC7D,OAAO,EAIL,KAAK,QAAQ,EACd,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EAAqB,KAAK,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAOjF,OAAO,EAAyB,KAAK,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAC3F,OAAO,EAKL,KAAK,YAAY,EACjB,KAAK,YAAY,EAClB,MAAM,wBAAwB,CAAC;AAEhC,MAAM,MAAM,cAAc,GAAG;IAC3B,KAAK,EAAE;QAAE,IAAI,EAAE,KAAK,GAAG,OAAO,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAChD,MAAM,CAAC,EAAE;QAAE,IAAI,EAAE,OAAO,GAAG,UAAU,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IACvD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,kBAAkB,CAAC;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,eAAe,EAAE,eAAe,CAAC;IACjC,QAAQ,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5C,QAAQ,EAAE,OAAO,CAAC;IAClB,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,SAAS,EAAE,sBAAsB,EAAE,CAAC;IACpC,KAAK,EAAE,YAAY,CAAC;IACpB,IAAI,EAAE,YAAY,CAAC;IACnB,EAAE,EAAE,YAAY,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,iBAAiB,EAAE,OAAO,CAAC;IAC3B,MAAM,EAAE,OAAO,CAAC;CACjB,CAAC;AAyDF,eAAO,MAAM,mBAAmB,GAAI,MAAM;IACxC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3B,KAAK,EAAE,QAAQ,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,KAAG,cA2FH,CAAC"}
+{"version":3,"file":"improve-options.d.ts","sourceRoot":"","sources":["../src/improve-options.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAC7D,OAAO,EAIL,KAAK,QAAQ,EACd,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EAAqB,KAAK,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACjF,OAAO,EAEL,KAAK,2BAA2B,EACjC,MAAM,yBAAyB,CAAC;AAWjC,OAAO,EAAkC,KAAK,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AACpG,OAAO,EAKL,KAAK,YAAY,EACjB,KAAK,YAAY,EAClB,MAAM,wBAAwB,CAAC;AAEhC,MAAM,MAAM,cAAc,GAAG;IAC3B,KAAK,EAAE;QAAE,IAAI,EAAE,KAAK,GAAG,OAAO,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAChD,MAAM,CAAC,EAAE;QAAE,IAAI,EAAE,OAAO,GAAG,UAAU,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IACvD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,kBAAkB,CAAC;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,eAAe,EAAE,eAAe,CAAC;IACjC,iBAAiB,EAAE,2BAA2B,CAAC;IAC/C,QAAQ,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5C,QAAQ,EAAE,OAAO,CAAC;IAClB,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,SAAS,EAAE,sBAAsB,EAAE,CAAC;IACpC,KAAK,EAAE,YAAY,CAAC;IACpB,IAAI,EAAE,YAAY,CAAC;IACnB,EAAE,EAAE,YAAY,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,iBAAiB,EAAE,OAAO,CAAC;IAC3B,MAAM,EAAE,OAAO,CAAC;IAChB,8EAA8E;IAC9E,mBAAmB,EAAE,MAAM,CAAC;IAC5B,mEAAmE;IACnE,KAAK,EAAE,OAAO,CAAC;IACf,8DAA8D;IAC9D,MAAM,EAAE,OAAO,CAAC;CACjB,CAAC;AAqGF,eAAO,MAAM,mBAAmB,GAAI,MAAM;IACxC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3B,KAAK,EAAE,QAAQ,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,KAAG,cA4HH,CAAC"}

package/dist/improve-options.js

@@ -3,10 +3,17 @@ import { booleanFlag, stringFlag, stringFlags, } from './cli-arguments.js';
 import { CliRefusal } from './cli-refusal.js';
 import { buildImproveConcept } from './improve-concept.js';
 import { isConversionModel } from './conversion-models.js';
+import { isResponsiveConversionQuality, } from './responsive-quality.js';
 import { DRAFT_CANDIDATE_COUNT, DRAFT_CANDIDATE_COUNT_MAXIMUM, DRAFT_CANDIDATE_COUNT_MINIMUM, } from './draft-run.js';
 import { parseDraftRetainFlag } from './draft-retain.js';
-import { parseImproveBootstrap } from './redesign-capture.js';
+import { improveConvertStallDefaultSeconds, improveConvertStallFloorSeconds, } from './improve-convert-resilience.js';
+import { httpUrl, parseImproveBootstrap } from './redesign-capture.js';
 import { IMPROVE_STAGES, improvePaths, improveSlug, isImproveStage, } from './improve-workspace.js';
+/**
+ * The floor is 2 and stays 2, and the refusal now says why: a draft draws
+ * ALTERNATIVES, and a draw of one is not a choice. The one-design mode already
+ * exists and is spelled `--target`, which skips draft and pick outright.
+ */
 const candidateCount = (flags) => {
     const value = stringFlag(flags, 'candidates');
     if (value === undefined)
@@ -16,7 +23,10 @@ const candidateCount = (flags) => {
         || count < DRAFT_CANDIDATE_COUNT_MINIMUM
         || count > DRAFT_CANDIDATE_COUNT_MAXIMUM) {
         throw new CliRefusal(`--candidates must be an integer between ${DRAFT_CANDIDATE_COUNT_MINIMUM}`
-            + ` and ${DRAFT_CANDIDATE_COUNT_MAXIMUM}`, 'improve_candidates_invalid');
+            + ` and ${DRAFT_CANDIDATE_COUNT_MAXIMUM}.`
+            + ' A draft draws alternatives to choose between, so the floor is'
+            + ` ${DRAFT_CANDIDATE_COUNT_MINIMUM}; to work from a single design you already have,`
+            + ' pass --target <image.png|layerdoc.json>, which skips draft and pick.', 'improve_candidates_invalid');
     }
     return count;
 };
@@ -27,6 +37,13 @@ const conversionModel = (flags) => {
     }
     return value;
 };
+const responsiveQuality = (flags) => {
+    const value = stringFlag(flags, 'responsive-quality')?.trim() ?? 'standard';
+    if (!isResponsiveConversionQuality(value)) {
+        throw new CliRefusal('--responsive-quality must be standard or pro', 'improve_responsive_quality_invalid');
+    }
+    return value;
+};
 const viewport = (flags) => {
     const value = stringFlag(flags, 'viewport')?.trim() ?? '1440x900';
     const match = value.match(/^(\d{2,5})x(\d{2,5})$/u);
@@ -37,6 +54,28 @@ const viewport = (flags) => {
     }
     return { width, height };
 };
+/**
+ * `--convert-stall-seconds` bounds how long improve waits on one half of a
+ * fused conversion. It refuses below the conversion's own typical wall for the
+ * model in play: a bound inside the typical window would fire the stall retry
+ * on a healthy run and buy the same design twice.
+ *
+ * The default obeys the same rule rather than sitting just above the floor —
+ * see `improveConvertStallDefaultSeconds`, which is model-aware.
+ */
+const convertStallSeconds = (flags, model) => {
+    const value = stringFlag(flags, 'convert-stall-seconds')?.trim();
+    if (value === undefined)
+        return improveConvertStallDefaultSeconds(model);
+    const seconds = Number(value);
+    const floor = improveConvertStallFloorSeconds(model);
+    if (!Number.isSafeInteger(seconds) || seconds < floor || seconds > 3_600) {
+        throw new CliRefusal(`--convert-stall-seconds must be an integer between ${floor} and 3600.`
+            + ` A ${model} conversion typically takes ${floor}s, and a bound inside that window`
+            + ' would abandon healthy work and buy it again.', 'improve_convert_stall_seconds_invalid');
+    }
+    return seconds;
+};
 const stageRange = (flags) => {
     const read = (flag, fallback) => {
         const value = stringFlag(flags, flag)?.trim();
@@ -59,15 +98,7 @@ export const parseImproveOptions = (args) => {
     if (!inputValue || args.command.length !== 2) {
         throw new CliRefusal('12ui improve accepts one URL or PNG, JPEG, or WebP path', 'improve_usage');
     }
-    const parsedUrl = (() => {
-        try {
-            const url = new URL(inputValue);
-            return /^https?:$/u.test(url.protocol) ? url.toString() : undefined;
-        }
-        catch {
-            return undefined;
-        }
-    })();
+    const parsedUrl = httpUrl(inputValue);
     const kind = parsedUrl ? 'url' : 'image';
     const value = parsedUrl ?? path.resolve(inputValue);
     if (kind === 'image' && !/\.(?:png|jpe?g|webp)$/iu.test(value)) {
@@ -78,11 +109,18 @@ export const parseImproveOptions = (args) => {
     const candidates = candidateCount(args.flags);
     const retainFlag = stringFlag(args.flags, 'retain')?.trim() ?? 'layout,content';
     const retain = parseDraftRetainFlag(retainFlag);
-    const pick = (stringFlag(args.flags, 'pick')?.trim() ?? 'a').toUpperCase();
-    if (!/^[A-P]$/u.test(pick) || pick.charCodeAt(0) - 64 > candidates) {
+    // No default. `--pick` used to default to A, and the convert stage ran
+    // unconditionally under the default `--to plan`, so a run bought a conversion
+    // of candidate A before any human had seen the draw. Notion's improve.json
+    // times the two four milliseconds apart. An absent pick now stops the run
+    // after draft and prints the command that resumes it.
+    const pickValue = stringFlag(args.flags, 'pick')?.trim();
+    const pick = pickValue?.toUpperCase();
+    if (pick !== undefined && (!/^[A-P]$/u.test(pick) || pick.charCodeAt(0) - 64 > candidates)) {
         throw new CliRefusal(`--pick must name one of A-${String.fromCharCode(64 + candidates)}`, 'improve_pick_invalid');
     }
     const conversion = conversionModel(args.flags);
+    const responsive = responsiveQuality(args.flags);
     const size = viewport(args.flags);
     const bootstrapValues = stringFlags(args.flags, 'bootstrap');
     const fullPage = booleanFlag(args.flags, 'full-page');
@@ -93,6 +131,10 @@ export const parseImproveOptions = (args) => {
         kind: /\.layerdoc\.json$/iu.test(targetValue) ? 'layerdoc' : 'image',
         value: path.resolve(targetValue),
     } : undefined;
+    const stallSeconds = convertStallSeconds(args.flags, conversion);
+    const fresh = booleanFlag(args.flags, 'fresh');
+    const redraw = booleanFlag(args.flags, 'redraw');
+    const range = stageRange(args.flags);
     if (target && target.kind === 'image' && !/\.(?:png|jpe?g|webp)$/iu.test(target.value)) {
         throw new CliRefusal('--target must be a PNG, JPEG, WebP, or *.layerdoc.json', 'improve_target_invalid');
     }
@@ -106,6 +148,23 @@ export const parseImproveOptions = (args) => {
         if (target.kind === 'layerdoc' && args.flags['convert-model'] !== undefined) {
             throw new CliRefusal('--convert-model does not apply to a LayerDoc --target', 'improve_target_flag_invalid');
         }
+        if (target.kind === 'layerdoc' && fresh) {
+            throw new CliRefusal('--fresh does not apply to a LayerDoc --target', 'improve_target_flag_invalid');
+        }
+        if (redraw) {
+            throw new CliRefusal('--redraw draws new candidates, and --target skips draft and pick entirely.'
+                + ' Drop one of them.', 'improve_target_flag_invalid');
+        }
+    }
+    // A redraw that never reaches the draft stage would print a reassuring
+    // summary over a record it had just emptied.
+    if (redraw && IMPROVE_STAGES.indexOf(range.from) > IMPROVE_STAGES.indexOf('draft')) {
+        throw new CliRefusal(`--redraw buys a new draw of candidates, so it has to run the draft stage;`
+            + ` --from ${range.from} starts after it. Use --from capture or --from draft.`, 'improve_redraw_range_invalid');
+    }
+    if (redraw && IMPROVE_STAGES.indexOf(range.to) < IMPROVE_STAGES.indexOf('pick')) {
+        throw new CliRefusal(`--redraw discards the settled pick, so it has to run at least as far as pick;`
+            + ` --to ${range.to} stops before it.`, 'improve_redraw_range_invalid');
     }
     if (kind === 'image') {
         const urlOnly = [
@@ -123,7 +182,6 @@ export const parseImproveOptions = (args) => {
     }
     const outDir = stringFlag(args.flags, 'out-dir')?.trim()
         ?? path.join(args.workspaceRoot ?? process.cwd(), `12ui-improve-${improveSlug(value)}`);
-    const range = stageRange(args.flags);
     return {
         input: { kind, value },
         ...(target ? { target } : {}),
@@ -132,8 +190,9 @@ export const parseImproveOptions = (args) => {
         candidates,
         retain,
         retainFlag,
-        pick,
+        ...(pick ? { pick } : {}),
         conversionModel: conversion,
+        responsiveQuality: responsive,
         viewport: size,
         fullPage,
         bootstrapValues,
@@ -143,6 +202,9 @@ export const parseImproveOptions = (args) => {
         ...(repoFlag ? { repo: path.resolve(repoFlag) } : {}),
         planSourceConvert,
         dryRun: booleanFlag(args.flags, 'dry-run'),
+        convertStallSeconds: stallSeconds,
+        fresh,
+        redraw,
     };
 };
 //# sourceMappingURL=improve-options.js.map

package/dist/improve-options.js.map

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

package/dist/improve-plan-annotated-render.d.ts

@@ -0,0 +1,33 @@
+import { type ImproveKitAssetIndex } from './improve-kit-assets.js';
+import { type SourceHint } from './improve-source-hints.js';
+import type { AddedElementSpec } from './improve-added-specs.js';
+import type { ImproveDomDiff } from './improve-dom-diff.js';
+import type { ImproveTokenPatch } from './improve-token-patch.js';
+import type { LayerDiffMatch } from './improve-layerdoc-types.js';
+/**
+ * `plan/plan-annotated.md`, readable in its first screen.
+ *
+ * The old shape opened with every token, one line each carrying up to 54
+ * selectors, and buried the hero raster layer under them. A lane that reads
+ * top-down met a wall of CSS variables before it ever learned there was a
+ * plate to copy. Order now follows what must happen: raster layers, tokens,
+ * matched changes, added elements, then a checklist for the commit.
+ */
+export type AnnotatedEntry = LayerDiffMatch & {
+    sourceHint: SourceHint;
+};
+export type ImprovePlanMode = 'dom-anchored' | 'layerdoc-anchored' | 'unanchored';
+/** Tokens shown inline; the rest stay in `token-patch.css`, which keeps them all. */
+export declare const IMPROVE_PLAN_TOKEN_LIMIT = 12;
+/** Selectors per token line. Fifty-four on one line is not a readable plan. */
+export declare const IMPROVE_PLAN_SELECTOR_LIMIT = 3;
+export declare const renderImproveAnnotatedPlan: (args: {
+    computed: ImproveDomDiff;
+    entries: readonly AnnotatedEntry[];
+    tokenPatch: ImproveTokenPatch;
+    addedSpecs: readonly AddedElementSpec[];
+    index: ImproveKitAssetIndex;
+    repo?: string;
+    mode: ImprovePlanMode;
+}) => string;
+//# sourceMappingURL=improve-plan-annotated-render.d.ts.map

package/dist/improve-plan-annotated-render.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"improve-plan-annotated-render.d.ts","sourceRoot":"","sources":["../src/improve-plan-annotated-render.ts"],"names":[],"mappings":"AACA,OAAO,EAIL,KAAK,oBAAoB,EAE1B,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EAA2B,KAAK,UAAU,EAAE,MAAM,2BAA2B,CAAC;AACrF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,KAAK,EAAY,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAE5E;;;;;;;;GAQG;AAEH,MAAM,MAAM,cAAc,GAAG,cAAc,GAAG;IAAE,UAAU,EAAE,UAAU,CAAA;CAAE,CAAC;AAEzE,MAAM,MAAM,eAAe,GAAG,cAAc,GAAG,mBAAmB,GAAG,YAAY,CAAC;AAElF,qFAAqF;AACrF,eAAO,MAAM,wBAAwB,KAAK,CAAC;AAE3C,+EAA+E;AAC/E,eAAO,MAAM,2BAA2B,IAAI,CAAC;AAyK7C,eAAO,MAAM,0BAA0B,GAAI,MAAM;IAC/C,QAAQ,EAAE,cAAc,CAAC;IACzB,OAAO,EAAE,SAAS,cAAc,EAAE,CAAC;IACnC,UAAU,EAAE,iBAAiB,CAAC;IAC9B,UAAU,EAAE,SAAS,gBAAgB,EAAE,CAAC;IACxC,KAAK,EAAE,oBAAoB,CAAC;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,eAAe,CAAC;CACvB,KAAG,MA2BH,CAAC"}

package/dist/improve-plan-annotated-render.js

@@ -0,0 +1,175 @@
+import { selectorLabel } from './improve-dom-anchor.js';
+import { formatImproveBounds, improveCarriedRasterLayers, improveFrameMappingLine, } from './improve-kit-assets.js';
+import { renderImproveRasterLayers } from './improve-raster-layers-section.js';
+import { formatImproveSourceHint } from './improve-source-hints.js';
+/** Tokens shown inline; the rest stay in `token-patch.css`, which keeps them all. */
+export const IMPROVE_PLAN_TOKEN_LIMIT = 12;
+/** Selectors per token line. Fifty-four on one line is not a readable plan. */
+export const IMPROVE_PLAN_SELECTOR_LIMIT = 3;
+const MODE_MEANING = {
+    'dom-anchored': 'every change below is anchored to a selector the live page really has.',
+    'layerdoc-anchored': 'changes come from comparing the source conversion\'s LayerDoc with the'
+        + ' target\'s; there are no page selectors, so placement is by bounds.',
+    unanchored: 'no source conversion was bought, so every target element is an independent'
+        + ' specification rather than a diff.',
+};
+const percent = (value) => `${(value * 100).toFixed(1)}%`;
+const header = (args) => [
+    '# Annotated implementation plan',
+    '',
+    '## How to read this plan',
+    '',
+    `- Mode: **${args.mode}** — ${MODE_MEANING[args.mode]}`,
+    `- Coverage ${percent(args.computed.domCoverage)} before-side:`
+        + ' the share of the existing interface\'s elements the target could be matched to.',
+    `- Coverage ${percent(args.computed.designCoverage)} target-side:`
+        + ' the share of the target\'s elements that matched something already there.',
+    `- Frame: ${improveFrameMappingLine({
+        frame: args.computed.beforeCanvas,
+        design: args.computed.targetCanvas,
+    })}`,
+    '- Precedence: assets → tokens → matched changes → added elements. Work them in that order.',
+    '- Skip an item only with a stated reason in your report; never skip a raster layer.',
+    `- Source repository: ${args.repo ? `\`${args.repo}\`` : 'not supplied; file hints are unresolved'}`,
+    '',
+];
+const tokens = (patch) => {
+    const lines = ['## Tokens — apply once', '', '- Apply `token-patch.css` through the existing global token or theme entry point.'];
+    if (patch.tokens.length === 0) {
+        lines.push('- No recurring CSS-capable delta reached the two-node threshold.', '');
+        return lines;
+    }
+    const shown = patch.tokens.slice(0, IMPROVE_PLAN_TOKEN_LIMIT);
+    lines.push(...shown.map((token) => {
+        const selectors = token.selectors.slice(0, IMPROVE_PLAN_SELECTOR_LIMIT).join(', ');
+        const rest = token.selectors.length - IMPROVE_PLAN_SELECTOR_LIMIT;
+        return `- \`${token.name}: ${token.value}\` — ${token.count} matched changes;`
+            + ` selectors: ${selectors}${rest > 0 ? ` and ${rest} more` : ''}.`;
+    }));
+    const remaining = patch.tokens.length - shown.length;
+    if (remaining > 0)
+        lines.push(`- … and ${remaining} more in \`token-patch.css\`, which keeps every token and every selector.`);
+    lines.push('');
+    return lines;
+};
+const changeText = (entry) => [
+    ...entry.deltas.map((delta) => `${delta.field} ${JSON.stringify(delta.before)}→${JSON.stringify(delta.after)}`),
+    ...(entry.impliedPadding ?? []).map((delta) => `${delta.field} ${delta.before}px→${delta.after}px (${delta.basis})`),
+].join(', ');
+const matchedChanges = (args) => {
+    const lines = ['## Matched changes', ''];
+    const changed = args.entries.filter((entry) => entry.changed || (entry.impliedPadding?.length ?? 0) > 0);
+    if (changed.length === 0) {
+        lines.push('_No actionable matched changes._', '');
+        return lines;
+    }
+    const label = (entry) => selectorLabel(args.computed.beforeLeaves[entry.beforeIndex]);
+    if (!args.repo) {
+        lines.push(...changed.map((entry) => (`- ${label(entry)} — ${formatImproveSourceHint(entry.sourceHint)}: ${changeText(entry)}`)), '');
+        return lines;
+    }
+    const byFile = new Map();
+    for (const entry of changed) {
+        const file = entry.sourceHint.relativePath ?? 'unresolved file';
+        byFile.set(file, [...byFile.get(file) ?? [], entry]);
+    }
+    const files = [...byFile.entries()].sort(([left], [right]) => ((left === 'unresolved file' ? 1 : 0) - (right === 'unresolved file' ? 1 : 0)
+        || right[1].length - left[1].length
+        || left.localeCompare(right)));
+    for (const [file, group] of files) {
+        lines.push(`### \`${file}\``, '');
+        lines.push(...group.map((entry) => (`- ${label(entry)} — ${formatImproveSourceHint(entry.sourceHint)}: ${changeText(entry)}`)), '');
+    }
+    return lines;
+};
+const addedBounds = (box) => (box
+    ? formatImproveBounds({ x: box[0] * 100, y: box[1] * 100, width: box[2] * 100, height: box[3] * 100 })
+    : 'bounds not declared');
+const addedElements = (args) => {
+    const lines = ['## Added elements — full target specs', ''];
+    if (args.addedSpecs.length === 0) {
+        lines.push('_None._', '');
+        return lines;
+    }
+    // A raster layer appears here as well as under "Raster layers to carry".
+    // Unlabelled, that reads as two work items over one asset, which is the
+    // duplicate defect pole: the same cutout placed twice.
+    const repeated = args.addedSpecs.some((spec) => args.rasterByIndex.has(spec.designIndex));
+    if (repeated) {
+        lines.push('Entries that name an asset above are the same item, specified in full. Place each asset once.', '');
+    }
+    lines.push(...args.addedSpecs.map((spec) => {
+        const raster = args.rasterByIndex.get(spec.designIndex);
+        const kind = raster?.kind ?? args.computed.targetLeaves[spec.designIndex]?.kind ?? 'layer';
+        const file = raster?.asset?.file ?? spec.asset?.destination;
+        const bounds = raster
+            ? formatImproveBounds(raster.bounds)
+            : addedBounds(args.computed.targetLeaves[spec.designIndex]?.box);
+        const prefix = raster
+            ? 'already listed under \'Raster layers to carry\' — full specification, place it once; '
+            : '';
+        return `- Added ${spec.designIndex} (${kind}): ${prefix}asset ${file ? `\`${file}\`` : 'none'};`
+            + ` ${bounds}.`;
+    }), '');
+    args.addedSpecs.forEach((spec) => lines.push(spec.markdown, ''));
+    return lines;
+};
+const checklist = (rasterLayers) => {
+    // The same list the section above printed, so the checklist cannot ask for a
+    // plate that section deliberately left out.
+    const carried = improveCarriedRasterLayers(rasterLayers);
+    return [
+        '## Before you commit',
+        '',
+        carried.length > 0
+            ? `- Every raster layer above is present in the page: ${carried
+                .map((layer) => `${layer.kind}${layer.asset ? ` (\`${layer.asset.id}\`)` : ''}`).join(', ')}.`
+            : '- Every raster layer above is present in the page.',
+        '- Tokens applied at the token layer, not per element.',
+        '- Screenshot the page and put it beside `winner.png`.',
+        '- No console errors.',
+        '- Real content, data, and controls intact.',
+        '',
+    ];
+};
+const guardrails = () => [
+    '## Implementation guardrails',
+    '',
+    '- Preserve all real content, data, and controls. Do not fabricate product features or copy.',
+    '- Never approximate an existing asset with CSS: if the LayerDoc declares a raster layer, ship its file.',
+    '- In Tailwind v4, verify arbitrary custom-property forms against the installed compiler before using them.',
+    '- Quote CSS `url(...)` values when paths contain punctuation or whitespace.',
+    '- Update the page content-security policy before introducing any data URI.',
+    '- Implement silently. Log only adapted or skipped items and the reason.',
+    '',
+];
+export const renderImproveAnnotatedPlan = (args) => {
+    const selectorByTargetIndex = new Map();
+    for (const entry of args.computed.result.matched) {
+        const leaf = args.computed.beforeLeaves[entry.beforeIndex];
+        if (leaf?.dom)
+            selectorByTargetIndex.set(entry.afterIndex, selectorLabel(leaf));
+    }
+    const rasterByIndex = new Map(args.index.rasterLayers.map((layer) => [layer.index, layer]));
+    return [
+        ...header({
+            computed: args.computed,
+            mode: args.mode,
+            ...(args.repo ? { repo: args.repo } : {}),
+        }),
+        ...renderImproveRasterLayers({
+            layers: args.index.rasterLayers,
+            placement: (layer) => selectorByTargetIndex.get(layer.index),
+        }),
+        ...tokens(args.tokenPatch),
+        ...matchedChanges({
+            computed: args.computed,
+            entries: args.entries,
+            ...(args.repo ? { repo: args.repo } : {}),
+        }),
+        ...addedElements({ addedSpecs: args.addedSpecs, computed: args.computed, rasterByIndex }),
+        ...checklist(args.index.rasterLayers),
+        ...guardrails(),
+    ].join('\n');
+};
+//# sourceMappingURL=improve-plan-annotated-render.js.map