@12ui/design 0.2.56 → 0.2.57

package/dist/improve-icon-svg.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Icon SVGs a lane can actually ship (F30).
+ *
+ * The corpus glyph a LayerDoc carries in `iconSvg` paints with
+ * `currentColor`, which resolves against the *referencing* document. Written
+ * to `plan/assets/` and used the way the kit README tells a lane to use an
+ * asset — an external `<img>`, a `background-image`, a `url()` — there is no
+ * inherited colour, so every planned accent collapsed to black: two wave-2
+ * lanes shipped black icons on a dark rail before catching it at the
+ * screenshot step, and both invented CSS masks independently.
+ *
+ * The colour is not a guess: the icon layer declares it (`color`), so the
+ * plan writes that colour into an `<img>`-safe file and keeps the
+ * `currentColor` original beside it as `-inline.svg` for the inline and mask
+ * uses where inheriting is the point. When the design declares no colour
+ * there is nothing to plumb, so only the inline variant is written and the
+ * spec says so rather than shipping a file that renders black.
+ */
+/** The declared colour of an icon layer, or nothing when none is usable. */
+export declare const improveDeclaredIconColor: (value: unknown) => string | undefined;
+export type ImproveIconSvgFile = {
+    /** File name inside `plan/assets/`. */
+    name: string;
+    svg: string;
+    /** `img` is safe as an external file; `inline` needs a colour at the call site. */
+    usage: 'img' | 'inline';
+};
+export type ImproveIconSvgVariants = {
+    files: ImproveIconSvgFile[];
+    /** The file the Added spec names as the asset. */
+    primary: ImproveIconSvgFile;
+    /** The `currentColor` sibling, when one was written. */
+    inline?: ImproveIconSvgFile;
+    color?: string;
+    /** One sentence for the spec and the plan: which file goes where. */
+    note: string;
+};
+/**
+ * The files to write for one icon layer. `stem` is the asset name without its
+ * extension, e.g. `added-014-user`.
+ */
+export declare const improveIconSvgVariants: (args: {
+    svg: string;
+    color: unknown;
+    stem: string;
+}) => ImproveIconSvgVariants;
+//# sourceMappingURL=improve-icon-svg.d.ts.map

package/dist/improve-icon-svg.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"improve-icon-svg.d.ts","sourceRoot":"","sources":["../src/improve-icon-svg.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAaH,4EAA4E;AAC5E,eAAO,MAAM,wBAAwB,GAAI,OAAO,OAAO,KAAG,MAAM,GAAG,SAKlE,CAAC;AAMF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,uCAAuC;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,mFAAmF;IACnF,KAAK,EAAE,KAAK,GAAG,QAAQ,CAAC;CACzB,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG;IACnC,KAAK,EAAE,kBAAkB,EAAE,CAAC;IAC5B,kDAAkD;IAClD,OAAO,EAAE,kBAAkB,CAAC;IAC5B,wDAAwD;IACxD,MAAM,CAAC,EAAE,kBAAkB,CAAC;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,qEAAqE;IACrE,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,sBAAsB,GAAI,MAAM;IAC3C,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,OAAO,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd,KAAG,sBAsCH,CAAC"}

package/dist/improve-icon-svg.js

@@ -0,0 +1,83 @@
+/**
+ * Icon SVGs a lane can actually ship (F30).
+ *
+ * The corpus glyph a LayerDoc carries in `iconSvg` paints with
+ * `currentColor`, which resolves against the *referencing* document. Written
+ * to `plan/assets/` and used the way the kit README tells a lane to use an
+ * asset — an external `<img>`, a `background-image`, a `url()` — there is no
+ * inherited colour, so every planned accent collapsed to black: two wave-2
+ * lanes shipped black icons on a dark rail before catching it at the
+ * screenshot step, and both invented CSS masks independently.
+ *
+ * The colour is not a guess: the icon layer declares it (`color`), so the
+ * plan writes that colour into an `<img>`-safe file and keeps the
+ * `currentColor` original beside it as `-inline.svg` for the inline and mask
+ * uses where inheriting is the point. When the design declares no colour
+ * there is nothing to plumb, so only the inline variant is written and the
+ * spec says so rather than shipping a file that renders black.
+ */
+/**
+ * Hex, functional, or a bare CSS ident. The pattern excludes quotes, angle
+ * brackets and ampersands, so a value that passes is safe in an attribute.
+ */
+const COLOR_FORM = /^(?:#[0-9a-f]{3,8}|(?:rgba?|hsla?|hwb|lab|lch|oklab|oklch|color)\([-0-9a-z%.,/ ]*\)|[a-z]{3,20})$/iu;
+/** Names that inherit or paint nothing: they cannot colour a standalone file. */
+const UNUSABLE = new Set([
+    'currentcolor', 'inherit', 'initial', 'unset', 'revert', 'revert-layer', 'transparent', 'none',
+]);
+/** The declared colour of an icon layer, or nothing when none is usable. */
+export const improveDeclaredIconColor = (value) => {
+    if (typeof value !== 'string')
+        return undefined;
+    const trimmed = value.trim();
+    if (!trimmed || !COLOR_FORM.test(trimmed))
+        return undefined;
+    return UNUSABLE.has(trimmed.toLowerCase()) ? undefined : trimmed;
+};
+/** Separate literals: a `/g/` regex carries `lastIndex` between `test` calls. */
+const HAS_CURRENT_COLOR = /currentcolor/iu;
+const EVERY_CURRENT_COLOR = /currentcolor/giu;
+/**
+ * The files to write for one icon layer. `stem` is the asset name without its
+ * extension, e.g. `added-014-user`.
+ */
+export const improveIconSvgVariants = (args) => {
+    const svg = args.svg.trim();
+    const color = improveDeclaredIconColor(args.color);
+    const imgName = `${args.stem}.svg`;
+    const inlineName = `${args.stem}-inline.svg`;
+    if (!HAS_CURRENT_COLOR.test(svg)) {
+        const primary = { name: imgName, svg, usage: 'img' };
+        return {
+            files: [primary],
+            primary,
+            ...(color ? { color } : {}),
+            note: `\`${imgName}\` carries its own colours: it is safe as an \`<img>\`, a`
+                + ' `background-image`, or inlined.',
+        };
+    }
+    if (!color) {
+        const primary = { name: inlineName, svg, usage: 'inline' };
+        return {
+            files: [primary],
+            primary,
+            inline: primary,
+            note: `The design declares no colour for this icon, so only \`${inlineName}\` is written and`
+                + ' it paints with `currentColor`. Inline it, or use it as a `mask-image` with a token'
+                + ' colour — as an external `<img>` it renders black.',
+        };
+    }
+    const img = { name: imgName, svg: svg.replace(EVERY_CURRENT_COLOR, color), usage: 'img' };
+    const inline = { name: inlineName, svg, usage: 'inline' };
+    return {
+        files: [img, inline],
+        primary: img,
+        inline,
+        color,
+        note: `Use \`${imgName}\` for an external \`<img>\`, \`background-image\`, or \`url()\`:`
+            + ` its fill and stroke are the design's declared \`${color}\`. Use \`${inlineName}\``
+            + ' (`currentColor`) only inlined in the markup or as a `mask-image` where the call site'
+            + ' sets the colour.',
+    };
+};
+//# sourceMappingURL=improve-icon-svg.js.map

package/dist/improve-icon-svg.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"improve-icon-svg.js","sourceRoot":"","sources":["../src/improve-icon-svg.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH;;;GAGG;AACH,MAAM,UAAU,GAAG,qGAAqG,CAAC;AAEzH,iFAAiF;AACjF,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC;IACvB,cAAc,EAAE,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM;CAC/F,CAAC,CAAC;AAEH,4EAA4E;AAC5E,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,KAAc,EAAsB,EAAE;IAC7E,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAC;IAChD,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAC7B,IAAI,CAAC,OAAO,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC;QAAE,OAAO,SAAS,CAAC;IAC5D,OAAO,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC;AACnE,CAAC,CAAC;AAEF,iFAAiF;AACjF,MAAM,iBAAiB,GAAG,gBAAgB,CAAC;AAC3C,MAAM,mBAAmB,GAAG,iBAAiB,CAAC;AAqB9C;;;GAGG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,IAItC,EAA0B,EAAE;IAC3B,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;IAC5B,MAAM,KAAK,GAAG,wBAAwB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACnD,MAAM,OAAO,GAAG,GAAG,IAAI,CAAC,IAAI,MAAM,CAAC;IACnC,MAAM,UAAU,GAAG,GAAG,IAAI,CAAC,IAAI,aAAa,CAAC;IAC7C,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QACjC,MAAM,OAAO,GAAuB,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;QACzE,OAAO;YACL,KAAK,EAAE,CAAC,OAAO,CAAC;YAChB,OAAO;YACP,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC3B,IAAI,EAAE,KAAK,OAAO,2DAA2D;kBACzE,kCAAkC;SACvC,CAAC;IACJ,CAAC;IACD,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,OAAO,GAAuB,EAAE,IAAI,EAAE,UAAU,EAAE,GAAG,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC;QAC/E,OAAO;YACL,KAAK,EAAE,CAAC,OAAO,CAAC;YAChB,OAAO;YACP,MAAM,EAAE,OAAO;YACf,IAAI,EAAE,0DAA0D,UAAU,mBAAmB;kBACzF,qFAAqF;kBACrF,oDAAoD;SACzD,CAAC;IACJ,CAAC;IACD,MAAM,GAAG,GAAuB,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,GAAG,CAAC,OAAO,CAAC,mBAAmB,EAAE,KAAK,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;IAC9G,MAAM,MAAM,GAAuB,EAAE,IAAI,EAAE,UAAU,EAAE,GAAG,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC;IAC9E,OAAO;QACL,KAAK,EAAE,CAAC,GAAG,EAAE,MAAM,CAAC;QACpB,OAAO,EAAE,GAAG;QACZ,MAAM;QACN,KAAK;QACL,IAAI,EAAE,SAAS,OAAO,mEAAmE;cACrF,oDAAoD,KAAK,aAAa,UAAU,IAAI;cACpF,uFAAuF;cACvF,mBAAmB;KACxB,CAAC;AACJ,CAAC,CAAC"}

package/dist/improve-kit-ignore.d.ts

@@ -0,0 +1,32 @@
+export declare const IMPROVE_GITIGNORE_PATTERN = ".improve/";
+export declare const IMPROVE_GITIGNORE_COMMENT = "# 12ui improve kits: candidates, captures and targets are not source";
+export type ImproveKitIgnoreState = 
+/** This run appended the rule to the repository root `.gitignore`. */
+'ignored'
+/** Some pattern already ignored the out-dir; nothing was written. */
+ | 'already-ignored'
+/** Inside a repository, not ignored, and not a kit directory this may claim. */
+ | 'not-ignored';
+export type ImproveKitIgnore = {
+    state: ImproveKitIgnoreState;
+    /** The out-dir relative to the repository root, in POSIX form. */
+    relativeOutDir: string;
+};
+/**
+ * Decide, and where it is safe, act. Returns `undefined` when the out-dir is not
+ * inside a git working tree — the common case, and the one where the CLI has
+ * nothing to say.
+ *
+ * Only the repository ROOT `.gitignore` is ever written, only by appending, and
+ * only when the out-dir is named `.improve` or lives under one. Anything else
+ * gets the advisory line instead: guessing a pattern for an arbitrary directory
+ * could ignore a lane's source.
+ */
+export declare const ensureImproveKitIgnored: (args: {
+    outDir: string;
+}) => Promise<ImproveKitIgnore | undefined>;
+/** The one line a run prints when the kit is committable and nobody said so. */
+export declare const improveKitIgnoreNote: (kit: ImproveKitIgnore | undefined) => string | undefined;
+/** The same fact, in the kit's own status block. */
+export declare const improveKitIgnoreStatusLine: (kit: ImproveKitIgnore | undefined) => string | undefined;
+//# sourceMappingURL=improve-kit-ignore.d.ts.map

package/dist/improve-kit-ignore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"improve-kit-ignore.d.ts","sourceRoot":"","sources":["../src/improve-kit-ignore.ts"],"names":[],"mappings":"AAwBA,eAAO,MAAM,yBAAyB,cAAc,CAAC;AACrD,eAAO,MAAM,yBAAyB,yEACkC,CAAC;AAEzE,MAAM,MAAM,qBAAqB;AAC/B,sEAAsE;AACpE,SAAS;AACX,qEAAqE;GACnE,iBAAiB;AACnB,gFAAgF;GAC9E,aAAa,CAAC;AAElB,MAAM,MAAM,gBAAgB,GAAG;IAC7B,KAAK,EAAE,qBAAqB,CAAC;IAC7B,kEAAkE;IAClE,cAAc,EAAE,MAAM,CAAC;CACxB,CAAC;AAmDF;;;;;;;;;GASG;AACH,eAAO,MAAM,uBAAuB,GAAU,MAAM;IAClD,MAAM,EAAE,MAAM,CAAC;CAChB,KAAG,OAAO,CAAC,gBAAgB,GAAG,SAAS,CAmBvC,CAAC;AAEF,gFAAgF;AAChF,eAAO,MAAM,oBAAoB,GAAI,KAAK,gBAAgB,GAAG,SAAS,KAAG,MAAM,GAAG,SAKjF,CAAC;AAEF,oDAAoD;AACpD,eAAO,MAAM,0BAA0B,GAAI,KAAK,gBAAgB,GAAG,SAAS,KAAG,MAAM,GAAG,SAMvF,CAAC"}

package/dist/improve-kit-ignore.js

@@ -0,0 +1,111 @@
+import { execFile } from 'node:child_process';
+import { readFile, stat, writeFile } from 'node:fs/promises';
+import path from 'node:path';
+import { promisify } from 'node:util';
+/**
+ * Keep the kit out of the repository's history (F17).
+ *
+ * `--out-dir .improve/<surface>` puts winner PNGs, every candidate, the capture
+ * sources and the whole target asset tree inside the repo being improved — about
+ * 100 MB of paid artifacts. Nothing said not to commit them, so one wave-2 lane's
+ * `git add -A` swept 102 kit files (100.8 MiB) into a seed commit, and the other
+ * three lanes each invented the same `.gitignore` rule for themselves. A rule
+ * four readers have to invent is a rule the tool owes them.
+ *
+ * The kit stays advisory: it appends one line when the out-dir is unambiguously a
+ * kit directory, says so plainly when it is not, and never fails the run.
+ */
+const execFileAsync = promisify(execFile);
+/** The directory name that makes an out-dir unambiguously a kit, not source. */
+const IMPROVE_KIT_DIRECTORY = '.improve';
+export const IMPROVE_GITIGNORE_PATTERN = '.improve/';
+export const IMPROVE_GITIGNORE_COMMENT = '# 12ui improve kits: candidates, captures and targets are not source';
+const exists = async (file) => (stat(file).then(() => true).catch(() => false));
+/**
+ * The repository the out-dir actually sits in, which is not necessarily
+ * `--repo`: a lane can point `--repo` at a package and write the kit above it.
+ * A `.git` file (worktree, submodule) counts exactly like a `.git` directory.
+ */
+const repositoryRoot = async (from) => {
+    let directory = path.resolve(from);
+    for (;;) {
+        if (await exists(path.join(directory, '.git')))
+            return directory;
+        const parent = path.dirname(directory);
+        if (parent === directory)
+            return undefined;
+        directory = parent;
+    }
+};
+const LITERAL_PATTERNS = new Set(['.improve', '.improve/', '/.improve', '/.improve/']);
+/** The fallback when git cannot be run at all: does the root file say it already? */
+const literallyIgnored = async (gitignore) => {
+    const text = await readFile(gitignore, 'utf8').catch(() => '');
+    return text.split('\n').some((line) => LITERAL_PATTERNS.has(line.trim()));
+};
+/** `true`/`false` from git itself; `undefined` when git could not answer. */
+const gitIgnores = async (root, relative) => {
+    try {
+        await execFileAsync('git', ['check-ignore', '-q', '--', relative], { cwd: root });
+        return true;
+    }
+    catch (error) {
+        return error.code === 1 ? false : undefined;
+    }
+};
+const appendRule = async (gitignore) => {
+    const existing = await readFile(gitignore, 'utf8').catch(() => undefined);
+    const separator = existing === undefined || existing.length === 0
+        ? ''
+        : existing.endsWith('\n') ? '\n' : '\n\n';
+    await writeFile(gitignore, `${existing ?? ''}${separator}${IMPROVE_GITIGNORE_COMMENT}\n${IMPROVE_GITIGNORE_PATTERN}\n`, 'utf8');
+};
+/**
+ * Decide, and where it is safe, act. Returns `undefined` when the out-dir is not
+ * inside a git working tree — the common case, and the one where the CLI has
+ * nothing to say.
+ *
+ * Only the repository ROOT `.gitignore` is ever written, only by appending, and
+ * only when the out-dir is named `.improve` or lives under one. Anything else
+ * gets the advisory line instead: guessing a pattern for an arbitrary directory
+ * could ignore a lane's source.
+ */
+export const ensureImproveKitIgnored = async (args) => {
+    try {
+        const outDir = path.resolve(args.outDir);
+        const root = await repositoryRoot(outDir);
+        if (!root || root === outDir)
+            return undefined;
+        const relative = path.relative(root, outDir).split(path.sep).join('/');
+        if (!relative || relative.startsWith('../'))
+            return undefined;
+        const gitignore = path.join(root, '.gitignore');
+        const ignored = await gitIgnores(root, relative) ?? await literallyIgnored(gitignore);
+        if (ignored)
+            return { state: 'already-ignored', relativeOutDir: relative };
+        if (!relative.split('/').includes(IMPROVE_KIT_DIRECTORY)) {
+            return { state: 'not-ignored', relativeOutDir: relative };
+        }
+        await appendRule(gitignore);
+        return { state: 'ignored', relativeOutDir: relative };
+    }
+    catch {
+        // Advisory work never sinks a run that has already spent money.
+        return undefined;
+    }
+};
+/** The one line a run prints when the kit is committable and nobody said so. */
+export const improveKitIgnoreNote = (kit) => (kit?.state === 'not-ignored'
+    ? 'The kit is inside the repository and is not git-ignored;'
+        + ` add ${kit.relativeOutDir}/ to .gitignore before committing.`
+    : undefined);
+/** The same fact, in the kit's own status block. */
+export const improveKitIgnoreStatusLine = (kit) => {
+    if (!kit)
+        return undefined;
+    return kit.state === 'not-ignored'
+        ? `Kit: not git-ignored — see the note; add \`${kit.relativeOutDir}/\` to .gitignore`
+            + ' before committing.'
+        : 'Kit: git-ignored via .gitignore.';
+};
+//# sourceMappingURL=improve-kit-ignore.js.map

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

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

package/dist/improve-kit-readme.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"improve-kit-readme.d.ts","sourceRoot":"","sources":["../src/improve-kit-readme.ts"],"names":[],"mappings":"AAGA,OAAO,EAOL,KAAK,oBAAoB,EAC1B,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAKL,KAAK,gBAAgB,EACtB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EAAgB,KAAK,aAAa,EAAE,KAAK,YAAY,EAAE,MAAM,wBAAwB,CAAC;AA+N7F,eAAO,MAAM,mBAAmB,GAAI,MAAM;IACxC,MAAM,EAAE,aAAa,CAAC;IACtB,MAAM,EAAE,gBAAgB,CAAC;IACzB,KAAK,EAAE,oBAAoB,CAAC;CAC7B,KAAG,MAkBQ,CAAC;AAEb,eAAO,MAAM,kBAAkB,GAC7B,QAAQ,aAAa,EACrB,UAAS;IAAE,WAAW,CAAC,EAAE,YAAY,CAAA;CAAO,KAC3C,OAAO,CAAC,MAAM,CAQhB,CAAC"}
+{"version":3,"file":"improve-kit-readme.d.ts","sourceRoot":"","sources":["../src/improve-kit-readme.ts"],"names":[],"mappings":"AAGA,OAAO,EAOL,KAAK,oBAAoB,EAC1B,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAOL,KAAK,gBAAgB,EACtB,MAAM,yBAAyB,CAAC;AAIjC,OAAO,EAAgB,KAAK,aAAa,EAAE,KAAK,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAwT7F,eAAO,MAAM,mBAAmB,GAAI,MAAM;IACxC,MAAM,EAAE,aAAa,CAAC;IACtB,MAAM,EAAE,gBAAgB,CAAC;IACzB,KAAK,EAAE,oBAAoB,CAAC;CAC7B,KAAG,MAmBQ,CAAC;AAEb,eAAO,MAAM,kBAAkB,GAC7B,QAAQ,aAAa,EACrB,UAAS;IAAE,WAAW,CAAC,EAAE,YAAY,CAAA;CAAO,KAC3C,OAAO,CAAC,MAAM,CAQhB,CAAC"}

package/dist/improve-kit-readme.js

@@ -1,7 +1,9 @@
 import { writeFile } from 'node:fs/promises';
 import path from 'node:path';
 import { IMPROVE_ASSET_ROLE_COPY, IMPROVE_SCRIM_MAX_OPACITY_PCT, improveFrameMappingLine, readImproveKitAssets, } from './improve-kit-assets.js';
-import { IMPROVE_NO_APPROXIMATION_RULE, improveRecoveryLine, improveStageStatusLine, readImproveKitStatus, } from './improve-kit-status.js';
+import { IMPROVE_AWAITING_PICK_RULE, IMPROVE_NO_APPROXIMATION_RULE, improveAwaitingPick, improveRecoveryLine, improveStageStatusLine, readImproveKitStatus, } from './improve-kit-status.js';
+import { improveCapturedUrlLine } from './improve-capture-redirect.js';
+import { improveKitIgnoreStatusLine } from './improve-kit-ignore.js';
 import { improveAbandonedLines } from './improve-reset.js';
 import { improvePaths } from './improve-workspace.js';
 /**
@@ -20,10 +22,33 @@ const ROLE_GLOSSARY = [
     { role: 'upscaled-region', pattern: 'upscaled-region-N' },
     { role: 'source-crop', pattern: 'crop-N' },
 ];
+/**
+ * One sentence, wherever a resolved `plan/STALL.md` sits under this README.
+ *
+ * Freshdesk shipped a settled plan whose README said "settled" and whose
+ * STALL.md said "INCOMPLETE — no plan"; nothing in the kit said which was
+ * current (F21). The file is replaced when the stage settles, and the README
+ * says what it now is instead of pointing at it as a live stall.
+ */
+const improveResolvedStallLines = (status) => (status.present.stallResolved
+    ? ['', '`plan/STALL.md` records an earlier stall in this kit that has since resolved.'
+            + ' The plan and target here are current.']
+    : []);
 const statusSection = (args) => {
     const lines = ['## Status', ''];
     lines.push(...args.status.stages.map((stage) => `- ${improveStageStatusLine(stage)}`));
     lines.push(`- Target: ${args.status.targetMode}`);
+    // The page this kit is actually about, whenever it is not the page that was
+    // asked for (F27). It goes in the status block, above everything a reader
+    // would otherwise act on, because every artifact below describes it.
+    const captured = improveCapturedUrlLine(args.record);
+    if (captured)
+        lines.push(`- ${captured}`);
+    // Where the kit sits relative to the repository being improved, because a
+    // committed kit is 100 MB of paid artifacts in someone's history (F17).
+    const ignore = improveKitIgnoreStatusLine(args.record.kitIgnore);
+    if (ignore)
+        lines.push(`- ${ignore}`);
     lines.push(...improveAbandonedLines(args.record));
     if (args.status.complete) {
         lines.push('', ...(args.status.gateBlocked
@@ -31,12 +56,32 @@ const statusSection = (args) => {
                     + ' and `token-patch.css`. Read `plan/GATE.md` before touching code; the target, its assets'
                     + ' and the raster layers it names are all still here.']
             : args.record.convert?.layout === 'fixed'
-                ? ['Convert fell back: the target HTML is fixed-layout, not responsive.'
-                        + ' The LayerDoc and its assets are the full-quality source of truth.']
-                : ['Every requested stage settled. The kit is complete.']), '');
+                // The event, not just the outcome (F8): a lane that watched a silent
+                // wait needs the kit to confirm the responsive export stalled, and
+                // `plan/STALL.md` is where the timings and the collect-it-later
+                // command live.
+                ? ['Responsive export stalled; the plan was built from the fixed-layout fallback.'
+                        + ' The target HTML is fixed-layout, not responsive, and the LayerDoc and its assets'
+                        + ' are the full-quality source of truth.',
+                    ...(args.status.present.stall
+                        ? ['', 'See `plan/STALL.md` for what stalled, how long it waited, and how to collect'
+                                + ' the responsive export later if it completes.']
+                        : [])]
+                // A complete kit that still has a STALL.md stalled once and then
+                // settled. Saying only "the kit is complete" left the reader to
+                // adjudicate this README against a file that said INCOMPLETE (F21).
+                : ['Every requested stage settled. The kit is complete.',
+                    ...improveResolvedStallLines(args.status)]), '');
         return lines;
     }
-    lines.push('', `This kit is INCOMPLETE: ${args.status.missing.join(', ')}.`, ...(args.status.present.stall ? ['', 'See `plan/STALL.md` for what the run was waiting on.'] : []), '', 'Recovery, in order — the first resumes and replays every settled stage:', '', ...args.status.recovery.map(improveRecoveryLine), '', IMPROVE_NO_APPROXIMATION_RULE, '');
+    lines.push('', `This kit is INCOMPLETE: ${args.status.missing.join(', ')}.`, ...(args.status.present.stall && !args.status.present.stallResolved
+        ? ['', 'See `plan/STALL.md` for what the run was waiting on.']
+        : improveResolvedStallLines(args.status)), '', 
+    // A never-picked kit has one recovery, and it is not a resume: heading it
+    // "the first resumes" over a single `--from pick` line reads as a stall.
+    ...(improveAwaitingPick(args.record)
+        ? [IMPROVE_AWAITING_PICK_RULE, '', 'Recovery — pick a candidate; convert and plan run from there:']
+        : ['Recovery, in order — the first resumes and replays every settled stage:']), '', ...args.status.recovery.map(improveRecoveryLine), '', IMPROVE_NO_APPROXIMATION_RULE, '');
     return lines;
 };
 const startHere = (args) => {
@@ -62,9 +107,11 @@ const startHere = (args) => {
             ? []
             : [args.status.gateBlocked
                     ? 'Run the recovery above first: the steps below assume a target this kit has not finished.'
-                    : hasAssets
-                        ? 'Run the recovery above first: steps 3 and 4 need a plan this kit does not have yet.'
-                        : 'Run the recovery above first: steps 2 to 4 need a target this kit does not have yet.', '']),
+                    : improveAwaitingPick(args.record)
+                        ? 'Pick a candidate first (command above); steps 2 to 4 need the target that the pick produces.'
+                        : hasAssets
+                            ? 'Run the recovery above first: steps 3 and 4 need a plan this kit does not have yet.'
+                            : 'Run the recovery above first: steps 2 to 4 need a target this kit does not have yet.', '']),
         // The frame a bound belongs to, before the first step that places anything:
         // a lane read these percentages as `winner.png` pixels and placed short.
         improveFrameMappingLine({
@@ -72,9 +119,14 @@ const startHere = (args) => {
             ...(args.index.canvas ? { design: args.index.canvas } : {}),
         }),
         '',
-        args.status.designKind === 'layerdoc'
-            ? `1. Open \`${design}\`. The supplied target document is the design.`
-            : `1. Open \`${design}\`. It is the design.`,
+        // A never-picked kit has no winner, so `design` is the capture. Calling
+        // that "the design" is the same wrong turn the recovery block used to make.
+        improveAwaitingPick(args.record)
+            ? '1. Open the candidate PNGs in `candidates/` and pick one (command above).'
+                + ' `capture/source.png` is the page as it is today, not the design.'
+            : args.status.designKind === 'layerdoc'
+                ? `1. Open \`${design}\`. The supplied target document is the design.`
+                : `1. Open \`${design}\`. It is the design.`,
         '2. Copy the files the assets table below marks ship into the repository;'
             + ' the rest are references and alternates.',
         ...planSteps,
@@ -103,6 +155,12 @@ const assetsSection = (args) => {
         ...ROLE_GLOSSARY.map(({ role, pattern }) => `- ${IMPROVE_ASSET_ROLE_COPY[role].label}`
             + ` (\`${pattern}\`): ${IMPROVE_ASSET_ROLE_COPY[role].instruction}`),
         `- \`${design}\`: ${IMPROVE_ASSET_ROLE_COPY.design.instruction}`,
+        // F30: the single `currentColor` file the plan used to write rendered black
+        // in every external form this README recommends.
+        '- Icons (`plan/assets/added-*.svg`): reference `<name>.svg` — it carries the design\'s'
+            + ' declared colour and is safe as an `<img>`, `background-image`, or `url()`; its'
+            + ' `<name>-inline.svg` sibling paints with `currentColor` and is for inlining in the markup'
+            + ' or masking with a token colour.',
         '',
     ];
     if (args.index.assets.length === 0) {
@@ -156,8 +214,39 @@ const anatomy = (record) => [
     '',
     '- Apply the plan in the owning repository, then verify behavior and screenshots there. This kit never applies code.',
     '- Re-run from `pick` with another `--pick` slot to reuse capture and candidates; settled paid stages replay.',
+    // A magic-link triple is a live credential and this file sits in the working
+    // tree (F31), so the kit says what it holds and what a re-capture needs.
+    ...(record.bootstrap.length > 0
+        ? ['- This kit captured with `--bootstrap`. `improve.json` keeps only the redacted triple'
+                + ` (${record.bootstrap.map((value) => `\`${value}\``).join(', ')}) and its sha256 — the live`
+                + ' value, session token included, is stored nowhere. A re-capture needs `--bootstrap` passed'
+                + ' again.']
+        : []),
     '',
 ];
+/**
+ * The design's font, and whose job it is to load it (F23).
+ *
+ * `plan/token-patch.css` used to open with a hosted Google Fonts `@import`,
+ * and this README makes applying that patch step 3 of "Start here" — so the
+ * one step a lane is told to apply wholesale was also the step that added a
+ * third-party network dependency to a repository that declared none. The patch
+ * names the family; loading it is the repository's own decision.
+ */
+const fontsSection = (record) => {
+    const fonts = record.plan?.fonts ?? [];
+    if (fonts.length === 0)
+        return [];
+    return [
+        '## Fonts',
+        '',
+        ...fonts.map(({ family, weights }) => (`- ${family} (weights ${weights.join(', ')}). \`plan/token-patch.css\` declares it as a`
+            + ' token and imports nothing. Load the family the way this repository already loads fonts'
+            + ' — self-host it, or add it to the existing loader — or keep the current family and skip'
+            + ' the token.')),
+        '',
+    ];
+};
 const fixedLayoutSection = (record) => (record.convert?.layout === 'fixed'
     ? [
         '## Fixed-layout target',
@@ -183,6 +272,7 @@ export const renderImproveReadme = (args) => [
     ...startHere(args),
     ...assetsSection(args),
     ...guardrails(),
+    ...fontsSection(args.record),
     ...fixedLayoutSection(args.record),
     ...anatomy(args.record),
 ].join('\n');

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

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

package/dist/improve-kit-stall.d.ts

@@ -3,14 +3,26 @@ import { type ImproveKitStatus } from './improve-kit-status.js';
 import { type ImproveResumeConversion } from './improve-convert-resilience.js';
 import { type RunJournalEntry } from './run-journal.js';
 import { type ImproveRecord, type ImproveStage } from './improve-workspace.js';
-/** A run that ran out of patience and a run somebody killed read differently. */
-export type ImproveStallKind = 'stalled' | 'stopped';
+/**
+ * A run that ran out of patience, a run somebody killed, and a run that
+ * recovered read differently.
+ *
+ * `fallback` is the third: the responsive export stalled and improve derived
+ * fixed-layout HTML free from the settled LayerDoc, so the kit is complete and
+ * the plan was built — but something DID stall, and F8 (wave-2, 2026-09-03)
+ * found that nothing said so anywhere a lane looks. No STALL.md exists in any
+ * of the six wave-2 kits, including the two that fell back. A recovered run is
+ * not a clean run, and this file is where the difference gets written down.
+ */
+export type ImproveStallKind = 'stalled' | 'stopped' | 'fallback';
 export type ImproveStallFacts = {
     stage: ImproveStage;
     kind: ImproveStallKind;
     hostedRunId?: string;
     waitedSeconds?: number;
     typicalSeconds?: number;
+    /** The published bound the wait ran against, when the caller knows it. */
+    boundSeconds?: number;
     serviceStage?: string;
     /** The conversion the first recovery command will attach to, if the kit knows one. */
     resume?: ImproveResumeConversion;
@@ -51,6 +63,40 @@ export declare const renderImproveStall: (args: {
     status: ImproveKitStatus;
     index: ImproveKitAssetIndex;
 }) => string;
+/**
+ * The same file, for the run that recovered.
+ *
+ * The facts come off the durable record rather than out of an error, because
+ * there is no error: the responsive export stalled, the free derivation took
+ * over, and the run went on to build a plan. A kit written before
+ * `responsiveStall` existed records the fallback but not its timings, so this
+ * writes what it has and never invents a number.
+ */
+export declare const writeImproveFallbackStall: (args: {
+    record: ImproveRecord;
+    requestedTo?: ImproveStage;
+}) => Promise<string | undefined>;
+/**
+ * The stall this kit recorded is over, so the file that recorded it stops
+ * saying the kit is INCOMPLETE (F21).
+ *
+ * Freshdesk's `--from convert` resume settled at 18:56:41Z and wrote a whole
+ * plan; the `plan/STALL.md` from 18:48:17Z survived beside it, still saying
+ * "this run was stopped", "no plan", and "resume or convert first" — directly
+ * contradicting the README above it, which said the plan was settled. A reader
+ * opening that kit cold got two mutually exclusive statuses and no way to tell
+ * which was current.
+ *
+ * The file is REPLACED rather than deleted: it is the durable record that this
+ * kit stalled once, which is worth keeping, and a README that links to it must
+ * not link to nothing. Its mtime is when the stall was written, which is the
+ * one timestamp neither the record nor the journal keeps.
+ */
+export declare const resolveImproveStall: (args: {
+    record: ImproveRecord;
+    status: ImproveKitStatus;
+    now?: Date;
+}) => Promise<string | undefined>;
 /**
  * Write `plan/STALL.md`, creating `plan/` when the plan stage never ran.
  * Returns the file so the caller can journal it as an artifact.

package/dist/improve-kit-stall.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"improve-kit-stall.d.ts","sourceRoot":"","sources":["../src/improve-kit-stall.ts"],"names":[],"mappings":"AAIA,OAAO,EAAwB,KAAK,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAC1F,OAAO,EAIL,KAAK,gBAAgB,EACtB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAIL,KAAK,uBAAuB,EAC7B,MAAM,iCAAiC,CAAC;AAGzC,OAAO,EAAkB,KAAK,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACxE,OAAO,EAAgB,KAAK,aAAa,EAAE,KAAK,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAe7F,iFAAiF;AACjF,MAAM,MAAM,gBAAgB,GAAG,SAAS,GAAG,SAAS,CAAC;AAErD,MAAM,MAAM,iBAAiB,GAAG;IAC9B,KAAK,EAAE,YAAY,CAAC;IACpB,IAAI,EAAE,gBAAgB,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,sFAAsF;IACtF,MAAM,CAAC,EAAE,uBAAuB,CAAC;IACjC,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,GAAU,MAAM;IACnD,MAAM,EAAE,aAAa,CAAC;IACtB,KAAK,EAAE,YAAY,CAAC;IACpB,KAAK,EAAE,OAAO,CAAC;IACf,IAAI,CAAC,EAAE,gBAAgB,CAAC;IACxB;;;;;OAKG;IACH,OAAO,CAAC,EAAE,SAAS,eAAe,EAAE,CAAC;IACrC;;;;;;;;;OASG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB,KAAG,OAAO,CAAC,iBAAiB,CAgC5B,CAAC;AAgDF,eAAO,MAAM,kBAAkB,GAAI,MAAM;IACvC,MAAM,EAAE,aAAa,CAAC;IACtB,KAAK,EAAE,iBAAiB,CAAC;IACzB,MAAM,EAAE,gBAAgB,CAAC;IACzB,KAAK,EAAE,oBAAoB,CAAC;CAC7B,KAAG,MAoCH,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,uBAAuB,GAAU,MAAM;IAClD,MAAM,EAAE,aAAa,CAAC;IACtB,KAAK,EAAE,YAAY,CAAC;IACpB,KAAK,EAAE,OAAO,CAAC;IACf,WAAW,CAAC,EAAE,YAAY,CAAC;IAC3B,IAAI,CAAC,EAAE,gBAAgB,CAAC;IACxB,kFAAkF;IAClF,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB,KAAG,OAAO,CAAC,MAAM,CAoBjB,CAAC"}
+{"version":3,"file":"improve-kit-stall.d.ts","sourceRoot":"","sources":["../src/improve-kit-stall.ts"],"names":[],"mappings":"AAIA,OAAO,EAAwB,KAAK,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAC1F,OAAO,EAML,KAAK,gBAAgB,EACtB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAIL,KAAK,uBAAuB,EAC7B,MAAM,iCAAiC,CAAC;AAGzC,OAAO,EAAkB,KAAK,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACxE,OAAO,EAAgB,KAAK,aAAa,EAAE,KAAK,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAe7F;;;;;;;;;;GAUG;AACH,MAAM,MAAM,gBAAgB,GAAG,SAAS,GAAG,SAAS,GAAG,UAAU,CAAC;AAElE,MAAM,MAAM,iBAAiB,GAAG;IAC9B,KAAK,EAAE,YAAY,CAAC;IACpB,IAAI,EAAE,gBAAgB,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,0EAA0E;IAC1E,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,sFAAsF;IACtF,MAAM,CAAC,EAAE,uBAAuB,CAAC;IACjC,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,GAAU,MAAM;IACnD,MAAM,EAAE,aAAa,CAAC;IACtB,KAAK,EAAE,YAAY,CAAC;IACpB,KAAK,EAAE,OAAO,CAAC;IACf,IAAI,CAAC,EAAE,gBAAgB,CAAC;IACxB;;;;;OAKG;IACH,OAAO,CAAC,EAAE,SAAS,eAAe,EAAE,CAAC;IACrC;;;;;;;;;OASG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB,KAAG,OAAO,CAAC,iBAAiB,CAgC5B,CAAC;AA6EF,eAAO,MAAM,kBAAkB,GAAI,MAAM;IACvC,MAAM,EAAE,aAAa,CAAC;IACtB,KAAK,EAAE,iBAAiB,CAAC;IACzB,MAAM,EAAE,gBAAgB,CAAC;IACzB,KAAK,EAAE,oBAAoB,CAAC;CAC7B,KAAG,MAoEH,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,yBAAyB,GAAU,MAAM;IACpD,MAAM,EAAE,aAAa,CAAC;IACtB,WAAW,CAAC,EAAE,YAAY,CAAC;CAC5B,KAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAyB7B,CAAC;AAMF;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,mBAAmB,GAAU,MAAM;IAC9C,MAAM,EAAE,aAAa,CAAC;IACtB,MAAM,EAAE,gBAAgB,CAAC;IACzB,GAAG,CAAC,EAAE,IAAI,CAAC;CACZ,KAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAgC7B,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,uBAAuB,GAAU,MAAM;IAClD,MAAM,EAAE,aAAa,CAAC;IACtB,KAAK,EAAE,YAAY,CAAC;IACpB,KAAK,EAAE,OAAO,CAAC;IACf,WAAW,CAAC,EAAE,YAAY,CAAC;IAC3B,IAAI,CAAC,EAAE,gBAAgB,CAAC;IACxB,kFAAkF;IAClF,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB,KAAG,OAAO,CAAC,MAAM,CAoBjB,CAAC"}