@12ui/design 0.2.53 → 0.2.55

package/dist/improve-options.js

@@ -0,0 +1,163 @@
+import path from 'node:path';
+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 { IMPROVE_STAGES, improvePaths, improveSlug, isImproveStage, } from './improve-workspace.js';
+const candidateCount = (flags) => {
+    const value = stringFlag(flags, 'candidates');
+    if (value === undefined)
+        return DRAFT_CANDIDATE_COUNT;
+    const count = Number(value);
+    if (!Number.isSafeInteger(count)
+        || 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');
+    }
+    return count;
+};
+const conversionModel = (flags) => {
+    const value = stringFlag(flags, 'convert-model')?.trim() ?? 'standard';
+    if (!isConversionModel(value)) {
+        throw new CliRefusal('--convert-model must be fast, standard, or pro', 'improve_model_invalid');
+    }
+    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);
+    const width = Number(match?.[1]);
+    const height = Number(match?.[2]);
+    if (!match || width < 320 || width > 7680 || height < 240 || height > 7680) {
+        throw new CliRefusal('--viewport must be WxH between 320x240 and 7680x7680', 'improve_viewport_invalid');
+    }
+    return { width, height };
+};
+const stageRange = (flags) => {
+    const read = (flag, fallback) => {
+        const value = stringFlag(flags, flag)?.trim();
+        if (!value)
+            return fallback;
+        if (!isImproveStage(value)) {
+            throw new CliRefusal(`--${flag} must be one of ${IMPROVE_STAGES.join(', ')}`, 'improve_stage_invalid');
+        }
+        return value;
+    };
+    const from = read('from', IMPROVE_STAGES[0]);
+    const to = read('to', IMPROVE_STAGES.at(-1));
+    if (IMPROVE_STAGES.indexOf(from) > IMPROVE_STAGES.indexOf(to)) {
+        throw new CliRefusal(`--from ${from} runs after --to ${to}; stages run ${IMPROVE_STAGES.join(' -> ')}`, 'improve_stage_range_invalid');
+    }
+    return { from, to };
+};
+export const parseImproveOptions = (args) => {
+    const inputValue = args.command[1]?.trim();
+    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 kind = parsedUrl ? 'url' : 'image';
+    const value = parsedUrl ?? path.resolve(inputValue);
+    if (kind === 'image' && !/\.(?:png|jpe?g|webp)$/iu.test(value)) {
+        throw new CliRefusal('Improve image input must be PNG, JPEG, or WebP', 'improve_image_invalid');
+    }
+    const directionValue = stringFlag(args.flags, 'direction');
+    const direction = directionValue?.replace(/\s+/gu, ' ').trim();
+    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) {
+        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');
+    const planSourceConvert = booleanFlag(args.flags, 'plan-source-convert');
+    const repoFlag = stringFlag(args.flags, 'repo')?.trim();
+    const targetValue = stringFlag(args.flags, 'target')?.trim();
+    const target = targetValue ? {
+        kind: /\.layerdoc\.json$/iu.test(targetValue) ? 'layerdoc' : 'image',
+        value: path.resolve(targetValue),
+    } : undefined;
+    const fresh = booleanFlag(args.flags, 'fresh');
+    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');
+    }
+    if (target) {
+        const generationFlags = ['direction', 'candidates', 'retain', 'pick']
+            .filter((flag) => args.flags[flag] !== undefined);
+        if (generationFlags.length > 0) {
+            throw new CliRefusal(`${generationFlags.map((flag) => `--${flag}`).join(', ')} cannot be combined with --target;`
+                + ' the supplied design skips draft and pick.', 'improve_target_flag_invalid');
+        }
+        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 (kind === 'image') {
+        const urlOnly = [
+            ...(bootstrapValues.length > 0 ? ['--bootstrap'] : []),
+            ...(fullPage ? ['--full-page'] : []),
+            ...(stringFlag(args.flags, 'viewport') ? ['--viewport'] : []),
+            ...(repoFlag ? ['--repo'] : []),
+        ];
+        if (urlOnly.length > 0) {
+            throw new CliRefusal(`${urlOnly.join(', ')} ${urlOnly.length === 1 ? 'applies' : 'apply'} to URL input`, 'improve_mode_flag_invalid');
+        }
+    }
+    else if (planSourceConvert) {
+        throw new CliRefusal('--plan-source-convert applies to image input', 'improve_mode_flag_invalid');
+    }
+    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 } : {}),
+        ...(direction ? { direction } : {}),
+        concept: buildImproveConcept(direction),
+        candidates,
+        retain,
+        retainFlag,
+        pick,
+        conversionModel: conversion,
+        responsiveQuality: responsive,
+        viewport: size,
+        fullPage,
+        bootstrapValues,
+        bootstrap: bootstrapValues.map(parseImproveBootstrap),
+        paths: improvePaths(outDir),
+        ...range,
+        ...(repoFlag ? { repo: path.resolve(repoFlag) } : {}),
+        planSourceConvert,
+        dryRun: booleanFlag(args.flags, 'dry-run'),
+        fresh,
+    };
+};
+//# sourceMappingURL=improve-options.js.map

package/dist/improve-options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"improve-options.js","sourceRoot":"","sources":["../src/improve-options.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAG7B,OAAO,EACL,WAAW,EACX,UAAU,EACV,WAAW,GAEZ,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAwB,MAAM,wBAAwB,CAAC;AACjF,OAAO,EACL,6BAA6B,GAE9B,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,qBAAqB,EACrB,6BAA6B,EAC7B,6BAA6B,GAC9B,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,EAAE,qBAAqB,EAA+B,MAAM,uBAAuB,CAAC;AAC3F,OAAO,EACL,cAAc,EACd,YAAY,EACZ,WAAW,EACX,cAAc,GAGf,MAAM,wBAAwB,CAAC;AA0BhC,MAAM,cAAc,GAAG,CAAC,KAAe,EAAU,EAAE;IACjD,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,EAAE,YAAY,CAAC,CAAC;IAC9C,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,qBAAqB,CAAC;IACtD,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAC5B,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC;WAC3B,KAAK,GAAG,6BAA6B;WACrC,KAAK,GAAG,6BAA6B,EAAE,CAAC;QAC3C,MAAM,IAAI,UAAU,CAClB,2CAA2C,6BAA6B,EAAE;cACxE,QAAQ,6BAA6B,EAAE,EACzC,4BAA4B,CAC7B,CAAC;IACJ,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC,CAAC;AAEF,MAAM,eAAe,GAAG,CAAC,KAAe,EAAmB,EAAE;IAC3D,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,EAAE,eAAe,CAAC,EAAE,IAAI,EAAE,IAAI,UAAU,CAAC;IACvE,IAAI,CAAC,iBAAiB,CAAC,KAAK,CAAC,EAAE,CAAC;QAC9B,MAAM,IAAI,UAAU,CAAC,gDAAgD,EAAE,uBAAuB,CAAC,CAAC;IAClG,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC,CAAC;AAEF,MAAM,iBAAiB,GAAG,CAAC,KAAe,EAA+B,EAAE;IACzE,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,EAAE,oBAAoB,CAAC,EAAE,IAAI,EAAE,IAAI,UAAU,CAAC;IAC5E,IAAI,CAAC,6BAA6B,CAAC,KAAK,CAAC,EAAE,CAAC;QAC1C,MAAM,IAAI,UAAU,CAClB,8CAA8C,EAC9C,oCAAoC,CACrC,CAAC;IACJ,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC,CAAC;AAEF,MAAM,QAAQ,GAAG,CAAC,KAAe,EAAqC,EAAE;IACtE,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,EAAE,UAAU,CAAC,EAAE,IAAI,EAAE,IAAI,UAAU,CAAC;IAClE,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,wBAAwB,CAAC,CAAC;IACpD,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IACjC,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IAClC,IAAI,CAAC,KAAK,IAAI,KAAK,GAAG,GAAG,IAAI,KAAK,GAAG,IAAI,IAAI,MAAM,GAAG,GAAG,IAAI,MAAM,GAAG,IAAI,EAAE,CAAC;QAC3E,MAAM,IAAI,UAAU,CAAC,sDAAsD,EAAE,0BAA0B,CAAC,CAAC;IAC3G,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;AAC3B,CAAC,CAAC;AAEF,MAAM,UAAU,GAAG,CAAC,KAAe,EAA4C,EAAE;IAC/E,MAAM,IAAI,GAAG,CAAC,IAAmB,EAAE,QAAsB,EAAgB,EAAE;QACzE,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,EAAE,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC;QAC9C,IAAI,CAAC,KAAK;YAAE,OAAO,QAAQ,CAAC;QAC5B,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,EAAE,CAAC;YAC3B,MAAM,IAAI,UAAU,CAAC,KAAK,IAAI,mBAAmB,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,uBAAuB,CAAC,CAAC;QACzG,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC,CAAC;IACF,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC;IAC7C,MAAM,EAAE,GAAG,IAAI,CAAC,IAAI,EAAE,cAAc,CAAC,EAAE,CAAC,CAAC,CAAC,CAAE,CAAC,CAAC;IAC9C,IAAI,cAAc,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,cAAc,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,CAAC;QAC9D,MAAM,IAAI,UAAU,CAClB,UAAU,IAAI,oBAAoB,EAAE,gBAAgB,cAAc,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,EACjF,6BAA6B,CAC9B,CAAC;IACJ,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC;AACtB,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,IAInC,EAAkB,EAAE;IACnB,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC;IAC3C,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC7C,MAAM,IAAI,UAAU,CAAC,yDAAyD,EAAE,eAAe,CAAC,CAAC;IACnG,CAAC;IACD,MAAM,SAAS,GAAG,CAAC,GAAG,EAAE;QACtB,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,UAAU,CAAC,CAAC;YAChC,OAAO,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;QACtE,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,SAAS,CAAC;QACnB,CAAC;IACH,CAAC,CAAC,EAAE,CAAC;IACL,MAAM,IAAI,GAAG,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC;IACzC,MAAM,KAAK,GAAG,SAAS,IAAI,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IACpD,IAAI,IAAI,KAAK,OAAO,IAAI,CAAC,yBAAyB,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QAC/D,MAAM,IAAI,UAAU,CAAC,gDAAgD,EAAE,uBAAuB,CAAC,CAAC;IAClG,CAAC;IACD,MAAM,cAAc,GAAG,UAAU,CAAC,IAAI,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC;IAC3D,MAAM,SAAS,GAAG,cAAc,EAAE,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IAC/D,MAAM,UAAU,GAAG,cAAc,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC9C,MAAM,UAAU,GAAG,UAAU,CAAC,IAAI,CAAC,KAAK,EAAE,QAAQ,CAAC,EAAE,IAAI,EAAE,IAAI,gBAAgB,CAAC;IAChF,MAAM,MAAM,GAAG,oBAAoB,CAAC,UAAU,CAAC,CAAC;IAChD,MAAM,IAAI,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,KAAK,EAAE,MAAM,CAAC,EAAE,IAAI,EAAE,IAAI,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC;IAC3E,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,EAAE,GAAG,UAAU,EAAE,CAAC;QACnE,MAAM,IAAI,UAAU,CAAC,6BAA6B,MAAM,CAAC,YAAY,CAAC,EAAE,GAAG,UAAU,CAAC,EAAE,EAAE,sBAAsB,CAAC,CAAC;IACpH,CAAC;IACD,MAAM,UAAU,GAAG,eAAe,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC/C,MAAM,UAAU,GAAG,iBAAiB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACjD,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAClC,MAAM,eAAe,GAAG,WAAW,CAAC,IAAI,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC;IAC7D,MAAM,QAAQ,GAAG,WAAW,CAAC,IAAI,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC;IACtD,MAAM,iBAAiB,GAAG,WAAW,CAAC,IAAI,CAAC,KAAK,EAAE,qBAAqB,CAAC,CAAC;IACzE,MAAM,QAAQ,GAAG,UAAU,CAAC,IAAI,CAAC,KAAK,EAAE,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC;IACxD,MAAM,WAAW,GAAG,UAAU,CAAC,IAAI,CAAC,KAAK,EAAE,QAAQ,CAAC,EAAE,IAAI,EAAE,CAAC;IAC7D,MAAM,MAAM,GAAG,WAAW,CAAC,CAAC,CAAC;QAC3B,IAAI,EAAE,qBAAqB,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,UAAmB,CAAC,CAAC,CAAC,OAAgB;QACtF,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC;KACjC,CAAC,CAAC,CAAC,SAAS,CAAC;IACd,MAAM,KAAK,GAAG,WAAW,CAAC,IAAI,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IAC/C,IAAI,MAAM,IAAI,MAAM,CAAC,IAAI,KAAK,OAAO,IAAI,CAAC,yBAAyB,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;QACvF,MAAM,IAAI,UAAU,CAAC,wDAAwD,EAAE,wBAAwB,CAAC,CAAC;IAC3G,CAAC;IACD,IAAI,MAAM,EAAE,CAAC;QACX,MAAM,eAAe,GAAG,CAAC,WAAW,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,CAAC;aAClE,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,SAAS,CAAC,CAAC;QACpD,IAAI,eAAe,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC/B,MAAM,IAAI,UAAU,CAClB,GAAG,eAAe,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,oCAAoC;kBAC1F,4CAA4C,EAC9C,6BAA6B,CAC9B,CAAC;QACJ,CAAC;QACD,IAAI,MAAM,CAAC,IAAI,KAAK,UAAU,IAAI,IAAI,CAAC,KAAK,CAAC,eAAe,CAAC,KAAK,SAAS,EAAE,CAAC;YAC5E,MAAM,IAAI,UAAU,CAAC,uDAAuD,EAAE,6BAA6B,CAAC,CAAC;QAC/G,CAAC;QACD,IAAI,MAAM,CAAC,IAAI,KAAK,UAAU,IAAI,KAAK,EAAE,CAAC;YACxC,MAAM,IAAI,UAAU,CAAC,+CAA+C,EAAE,6BAA6B,CAAC,CAAC;QACvG,CAAC;IACH,CAAC;IACD,IAAI,IAAI,KAAK,OAAO,EAAE,CAAC;QACrB,MAAM,OAAO,GAAG;YACd,GAAG,CAAC,eAAe,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YACtD,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YACpC,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YAC7D,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;SAChC,CAAC;QACF,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACvB,MAAM,IAAI,UAAU,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,eAAe,EAAE,2BAA2B,CAAC,CAAC;QACxI,CAAC;IACH,CAAC;SAAM,IAAI,iBAAiB,EAAE,CAAC;QAC7B,MAAM,IAAI,UAAU,CAAC,8CAA8C,EAAE,2BAA2B,CAAC,CAAC;IACpG,CAAC;IACD,MAAM,MAAM,GAAG,UAAU,CAAC,IAAI,CAAC,KAAK,EAAE,SAAS,CAAC,EAAE,IAAI,EAAE;WACnD,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,IAAI,OAAO,CAAC,GAAG,EAAE,EAAE,gBAAgB,WAAW,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAC1F,MAAM,KAAK,GAAG,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACrC,OAAO;QACL,KAAK,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE;QACtB,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC7B,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACnC,OAAO,EAAE,mBAAmB,CAAC,SAAS,CAAC;QACvC,UAAU;QACV,MAAM;QACN,UAAU;QACV,IAAI;QACJ,eAAe,EAAE,UAAU;QAC3B,iBAAiB,EAAE,UAAU;QAC7B,QAAQ,EAAE,IAAI;QACd,QAAQ;QACR,eAAe;QACf,SAAS,EAAE,eAAe,CAAC,GAAG,CAAC,qBAAqB,CAAC;QACrD,KAAK,EAAE,YAAY,CAAC,MAAM,CAAC;QAC3B,GAAG,KAAK;QACR,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACrD,iBAAiB;QACjB,MAAM,EAAE,WAAW,CAAC,IAAI,CAAC,KAAK,EAAE,SAAS,CAAC;QAC1C,KAAK;KACN,CAAC;AACJ,CAAC,CAAC"}

package/dist/improve-plan-annotator.d.ts

@@ -0,0 +1,14 @@
+import type { ImproveDomDiff } from './improve-dom-diff.js';
+export declare const writeImproveAnnotatedPlan: (args: {
+    computed: ImproveDomDiff;
+    targetDoc: unknown;
+    targetPath: string;
+    outDir: string;
+    repo?: string;
+    mode: "dom-anchored" | "layerdoc-anchored" | "unanchored";
+}) => Promise<{
+    planPath: string;
+    tokenPath: string;
+    artifacts: string[];
+}>;
+//# sourceMappingURL=improve-plan-annotator.d.ts.map

package/dist/improve-plan-annotator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"improve-plan-annotator.d.ts","sourceRoot":"","sources":["../src/improve-plan-annotator.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAoD5D,eAAO,MAAM,yBAAyB,GAAU,MAAM;IACpD,QAAQ,EAAE,cAAc,CAAC;IACzB,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,cAAc,GAAG,mBAAmB,GAAG,YAAY,CAAC;CAC3D,KAAG,OAAO,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,EAAE,CAAA;CAAE,CA+CvE,CAAC"}

package/dist/improve-plan-annotator.js

@@ -0,0 +1,80 @@
+import { mkdir, writeFile } from 'node:fs/promises';
+import path from 'node:path';
+import { buildImproveAddedElementSpecs } from './improve-added-specs.js';
+import { selectorLabel } from './improve-dom-anchor.js';
+import { formatImproveSourceHint, indexImproveSourceRepo, resolveImproveSourceHint, } from './improve-source-hints.js';
+import { buildImproveTokenPatch } from './improve-token-patch.js';
+const renderAnnotatedPlan = (args) => {
+    const lines = [
+        '# Annotated implementation plan', '',
+        `- Mode: **${args.mode}**`,
+        `- Coverage: ${(args.computed.domCoverage * 100).toFixed(1)}% before-side; ${(args.computed.designCoverage * 100).toFixed(1)}% target-side`,
+        `- Source repository: ${args.repo ? `\`${args.repo}\`` : 'not supplied; file hints are unresolved'}`, '',
+        '## Tokens — apply once', '',
+        '- Apply `token-patch.css` through the existing global token or theme entry point.',
+    ];
+    if (args.tokenPatch.tokens.length === 0) {
+        lines.push('- No recurring CSS-capable delta reached the two-node threshold.');
+    }
+    else {
+        lines.push(...args.tokenPatch.tokens.map((token) => (`- \`${token.name}: ${token.value}\` — ${token.count} matched changes; selectors: ${token.selectors.join(', ')}.`)));
+    }
+    lines.push('', '## Matched changes', '');
+    const changed = args.entries.filter((entry) => entry.changed || (entry.impliedPadding?.length ?? 0) > 0);
+    lines.push(...(changed.length > 0 ? changed.map((entry) => {
+        const leaf = args.computed.beforeLeaves[entry.beforeIndex];
+        const changes = [
+            ...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})`),
+        ];
+        return `- ${selectorLabel(leaf)} — ${formatImproveSourceHint(entry.sourceHint)}: ${changes.join(', ')}`;
+    }) : ['_No actionable matched changes._']));
+    lines.push('', '## Added elements — full target specs', '');
+    if (args.addedSpecs.length === 0)
+        lines.push('_None._');
+    else
+        args.addedSpecs.forEach((spec) => lines.push(spec.markdown, ''));
+    lines.push('## Implementation guardrails', '', '- Preserve all real content, data, and controls. Do not fabricate product features or copy.', '- 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.', '');
+    return lines.join('\n');
+};
+export const writeImproveAnnotatedPlan = async (args) => {
+    await mkdir(args.outDir, { recursive: true });
+    const sourceIndex = args.repo ? indexImproveSourceRepo(args.repo) : { files: [] };
+    const entries = args.computed.result.matched.map((entry) => ({
+        ...entry,
+        sourceHint: resolveImproveSourceHint(args.computed.beforeLeaves[entry.beforeIndex], sourceIndex, args.computed.beforeLeaves),
+    }));
+    const tokenPatch = buildImproveTokenPatch(entries, args.computed.beforeLeaves, args.computed.targetLeaves);
+    const addedSpecs = await buildImproveAddedElementSpecs({
+        targetDoc: args.targetDoc,
+        designPath: args.targetPath,
+        normalizedTarget: args.computed.targetLeaves,
+        before: args.computed.beforeLeaves,
+        canvas: args.computed.beforeCanvas,
+        diff: args.computed.result,
+        outDir: args.outDir,
+    });
+    const planPath = path.join(args.outDir, 'plan-annotated.md');
+    const tokenPath = path.join(args.outDir, 'token-patch.css');
+    await Promise.all([
+        writeFile(tokenPath, tokenPatch.css, 'utf8'),
+        writeFile(planPath, renderAnnotatedPlan({
+            computed: args.computed,
+            entries,
+            tokenPatch,
+            addedSpecs,
+            ...(args.repo ? { repo: args.repo } : {}),
+            mode: args.mode,
+        }), 'utf8'),
+    ]);
+    return {
+        planPath,
+        tokenPath,
+        artifacts: [
+            planPath,
+            tokenPath,
+            ...addedSpecs.flatMap((spec) => spec.asset?.path ? [spec.asset.path] : []),
+        ],
+    };
+};
+//# sourceMappingURL=improve-plan-annotator.js.map

package/dist/improve-plan-annotator.js.map

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

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

@@ -0,0 +1,23 @@
+import type { LayerDelta, LayerDiffResult, LayerLeaf } from './improve-layerdoc-types.js';
+export type RecurringDelta = LayerDelta & {
+    kind: string;
+    count: number;
+};
+export declare const aggregateRecurringDeltas: (matched: readonly LayerDiffResult["matched"][number][]) => RecurringDelta[];
+export declare const renderLayerChanges: (args: {
+    result: LayerDiffResult;
+    beforePath: string;
+    targetPath: string;
+    beforeDoc: unknown;
+    targetDoc: unknown;
+}) => string;
+export declare const renderDomChanges: (args: {
+    result: LayerDiffResult;
+    beforeLeaves: readonly LayerLeaf[];
+    beforePath: string;
+    targetPath: string;
+    domCoverage: number;
+    designCoverage: number;
+}) => string;
+export declare const leafPalette: (document: unknown) => string[];
+//# sourceMappingURL=improve-plan-render.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"improve-plan-render.d.ts","sourceRoot":"","sources":["../src/improve-plan-render.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AAQ1F,MAAM,MAAM,cAAc,GAAG,UAAU,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAE1E,eAAO,MAAM,wBAAwB,GACnC,SAAS,SAAS,eAAe,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,EAAE,KACrD,cAAc,EAahB,CAAC;AAEF,eAAO,MAAM,kBAAkB,GAAI,MAAM;IACvC,MAAM,EAAE,eAAe,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,EAAE,OAAO,CAAC;CACpB,KAAG,MA+BH,CAAC;AAEF,eAAO,MAAM,gBAAgB,GAAI,MAAM;IACrC,MAAM,EAAE,eAAe,CAAC;IACxB,YAAY,EAAE,SAAS,SAAS,EAAE,CAAC;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;CACxB,KAAG,MA2BH,CAAC;AAEF,eAAO,MAAM,WAAW,GAAI,UAAU,OAAO,KAAG,MAAM,EAEpD,CAAC"}

package/dist/improve-plan-render.js

@@ -0,0 +1,81 @@
+import { selectorLabel } from './improve-dom-anchor.js';
+import { flattenLayerDoc } from './improve-layerdoc-diff.js';
+const format = (value) => value === undefined
+    ? '∅'
+    : typeof value === 'string'
+        ? `\`${value}\``
+        : `\`${JSON.stringify(value)}\``;
+export const aggregateRecurringDeltas = (matched) => {
+    const groups = new Map();
+    for (const entry of matched) {
+        for (const delta of entry.deltas) {
+            const key = JSON.stringify([entry.kind, delta.field, delta.before, delta.after]);
+            const current = groups.get(key);
+            groups.set(key, current
+                ? { ...current, count: current.count + 1 }
+                : { kind: entry.kind, ...delta, count: 1 });
+        }
+    }
+    return [...groups.values()].filter((group) => group.count >= 2)
+        .sort((left, right) => right.count - left.count);
+};
+export const renderLayerChanges = (args) => {
+    const changed = args.result.matched.filter((entry) => entry.changed);
+    const lines = [
+        '# LayerDoc diff', '',
+        `- Before: \`${args.beforePath}\``,
+        `- Target: \`${args.targetPath}\``,
+        `- Match strategy: **${args.result.meta.matchStrategy}**`, '',
+        '## Summary', '',
+        `- ${args.result.meta.beforeLeafCount} leaves before, ${args.result.meta.afterLeafCount} leaves after`,
+        `- ${args.result.meta.matchedCount} matched (${args.result.meta.changedCount} changed)`,
+        `- ${args.result.meta.addedCount} added, ${args.result.meta.removedCount} removed`, '',
+        '## Global observations', '',
+    ];
+    const recurring = aggregateRecurringDeltas(args.result.matched);
+    lines.push(...(recurring.length > 0
+        ? recurring.map((delta) => `- ${delta.kind} ${delta.field}: ${format(delta.before)} → ${format(delta.after)} across ${delta.count} nodes`)
+        : ['_No recurring (2+ node) field changes._']));
+    lines.push('', '## Changed elements', '');
+    lines.push(...(changed.length > 0 ? changed.map((entry) => (`- **${entry.kind}** '${entry.after.content ?? entry.before.content ?? ''}'`
+        + `: ${entry.deltas.map((delta) => `${delta.field} ${format(delta.before)}→${format(delta.after)}`).join(', ')}`)) : ['_No changed elements._']));
+    lines.push('', '## Added', '');
+    lines.push(...(args.result.added.length > 0
+        ? args.result.added.map((leaf) => `- **${leaf.kind}** '${leaf.content ?? ''}'`)
+        : ['_None._']));
+    lines.push('', '## Removed', '');
+    lines.push(...(args.result.removed.length > 0
+        ? args.result.removed.map((leaf) => `- **${leaf.kind}** '${leaf.content ?? ''}'`)
+        : ['_None._']));
+    return `${lines.join('\n')}\n`;
+};
+export const renderDomChanges = (args) => {
+    const lines = [
+        '# Selector-anchored interface diff', '',
+        `- Before: \`${args.beforePath}\``,
+        `- Target: \`${args.targetPath}\``,
+        `- DOM-side coverage: **${(args.domCoverage * 100).toFixed(1)}%**`,
+        `- Design-side coverage: ${(args.designCoverage * 100).toFixed(1)}%`,
+        '- Coordinates were normalized fractionally; non-position lengths use the width ratio.', '',
+        '## Matched changes', '',
+    ];
+    const changed = args.result.matched.filter((entry) => entry.changed);
+    lines.push(...(changed.length > 0 ? changed.map((entry) => {
+        const implied = entry.impliedPadding ?? [];
+        return `- ${selectorLabel(args.beforeLeaves[entry.beforeIndex])}: ${[
+            ...entry.deltas.map((delta) => `${delta.field} ${format(delta.before)}→${format(delta.after)}`),
+            ...implied.map((delta) => `${delta.field} ${delta.before}px→${delta.after}px`),
+        ].join(', ')}`;
+    }) : ['_No changed matched elements._']));
+    lines.push('', '## Added elements', '');
+    lines.push(...(args.result.added.length > 0
+        ? args.result.added.map((entry) => `- **${entry.kind}** '${entry.content ?? ''}'`)
+        : ['_None._']));
+    lines.push('', '## Removed elements', '');
+    lines.push(...(args.result.removed.length > 0
+        ? args.result.removed.map((entry) => `- **${entry.kind}** '${entry.content ?? ''}'`)
+        : ['_None._']));
+    return `${lines.join('\n')}\n`;
+};
+export const leafPalette = (document) => [...new Set(flattenLayerDoc(document).map((leaf) => leaf.color).filter((value) => typeof value === 'string'))];
+//# sourceMappingURL=improve-plan-render.js.map

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

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

package/dist/improve-pricing-plan.d.ts

@@ -0,0 +1,20 @@
+import type { ConversionModel } from './conversion-models.js';
+import type { ImproveStage } from './improve-workspace.js';
+export type ImprovePlanStage = {
+    stage: ImproveStage;
+    paid: boolean;
+    wouldBuy: string;
+    priceCeilingUsd: number;
+};
+export declare const buildImprovePricingPlan: (args: {
+    inputKind: "url" | "image";
+    candidates: number;
+    conversionModel: ConversionModel;
+    planSourceConvert: boolean;
+    targetKind?: "image" | "layerdoc";
+}) => {
+    stages: ImprovePlanStage[];
+    priceCeilingUsdTotal: number;
+    pricingBasis: string;
+};
+//# sourceMappingURL=improve-pricing-plan.d.ts.map

package/dist/improve-pricing-plan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"improve-pricing-plan.d.ts","sourceRoot":"","sources":["../src/improve-pricing-plan.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAW3D,MAAM,MAAM,gBAAgB,GAAG;IAC7B,KAAK,EAAE,YAAY,CAAC;IACpB,IAAI,EAAE,OAAO,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,EAAE,MAAM,CAAC;CACzB,CAAC;AAEF,eAAO,MAAM,uBAAuB,GAAI,MAAM;IAC5C,SAAS,EAAE,KAAK,GAAG,OAAO,CAAC;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,eAAe,CAAC;IACjC,iBAAiB,EAAE,OAAO,CAAC;IAC3B,UAAU,CAAC,EAAE,OAAO,GAAG,UAAU,CAAC;CACnC,KAAG;IAAE,MAAM,EAAE,gBAAgB,EAAE,CAAC;IAAC,oBAAoB,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAiEnF,CAAC"}

package/dist/improve-pricing-plan.js

@@ -0,0 +1,72 @@
+/** Exact active catalog prices, expressed in dollars for CLI planning. */
+const CATALOG_USD = {
+    corpusSearch: 0.001,
+    hostedPlan: 0.001,
+    draftImage: 0.06,
+    responsiveStandard: 0.1,
+    convert: { fast: 0.05, standard: 0.45, pro: 0.9 },
+};
+export const buildImprovePricingPlan = (args) => {
+    const conversion = CATALOG_USD.convert[args.conversionModel];
+    const stages = [
+        {
+            stage: 'capture',
+            paid: false,
+            wouldBuy: args.inputKind === 'url'
+                ? 'nothing — one local Playwright capture and DOM extraction'
+                : 'nothing — one local source-image normalization',
+            priceCeilingUsd: 0,
+        },
+        args.targetKind ? {
+            stage: 'draft',
+            paid: false,
+            wouldBuy: 'nothing — skipped because --target supplies the design',
+            priceCeilingUsd: 0,
+        } : {
+            stage: 'draft',
+            paid: true,
+            wouldBuy: `1 corpus search, 1 hosted create plan, and ${args.candidates} draft image(s)`,
+            priceCeilingUsd: CATALOG_USD.corpusSearch
+                + CATALOG_USD.hostedPlan
+                + args.candidates * CATALOG_USD.draftImage,
+        },
+        args.targetKind ? {
+            stage: 'pick',
+            paid: false,
+            wouldBuy: 'nothing — skipped because --target is already the explicit design',
+            priceCeilingUsd: 0,
+        } : {
+            stage: 'pick',
+            paid: false,
+            wouldBuy: 'nothing — copies one already-materialized candidate',
+            priceCeilingUsd: 0,
+        },
+        args.targetKind === 'layerdoc' ? {
+            stage: 'convert',
+            paid: false,
+            wouldBuy: 'nothing — uses the supplied LayerDoc directly',
+            priceCeilingUsd: 0,
+        } : {
+            stage: 'convert',
+            paid: true,
+            wouldBuy: `1 ${args.conversionModel} conversion and 1 standard responsive export`,
+            priceCeilingUsd: conversion + CATALOG_USD.responsiveStandard,
+        },
+        {
+            stage: 'plan',
+            paid: args.inputKind === 'image' && args.planSourceConvert,
+            wouldBuy: args.inputKind === 'url'
+                ? 'nothing — local DOM-to-LayerDoc matching, gate, and annotation'
+                : args.planSourceConvert
+                    ? `1 ${args.conversionModel} source conversion; diff and annotation stay local`
+                    : 'nothing — an unanchored local target plan',
+            priceCeilingUsd: args.inputKind === 'image' && args.planSourceConvert ? conversion : 0,
+        },
+    ];
+    return {
+        stages,
+        priceCeilingUsdTotal: Number(stages.reduce((total, stage) => total + stage.priceCeilingUsd, 0).toFixed(6)),
+        pricingBasis: 'Active billing catalog unit prices; each value is a pre-dispatch ceiling.',
+    };
+};
+//# sourceMappingURL=improve-pricing-plan.js.map

package/dist/improve-pricing-plan.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"improve-pricing-plan.js","sourceRoot":"","sources":["../src/improve-pricing-plan.ts"],"names":[],"mappings":"AAGA,0EAA0E;AAC1E,MAAM,WAAW,GAAG;IAClB,YAAY,EAAE,KAAK;IACnB,UAAU,EAAE,KAAK;IACjB,UAAU,EAAE,IAAI;IAChB,kBAAkB,EAAE,GAAG;IACvB,OAAO,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,EAA4C;CAC5F,CAAC;AASF,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,IAMvC,EAAsF,EAAE;IACvF,MAAM,UAAU,GAAG,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;IAC7D,MAAM,MAAM,GAAuB;QACjC;YACE,KAAK,EAAE,SAAS;YAChB,IAAI,EAAE,KAAK;YACX,QAAQ,EAAE,IAAI,CAAC,SAAS,KAAK,KAAK;gBAChC,CAAC,CAAC,2DAA2D;gBAC7D,CAAC,CAAC,gDAAgD;YACpD,eAAe,EAAE,CAAC;SACnB;QACD,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC;YAChB,KAAK,EAAE,OAAO;YACd,IAAI,EAAE,KAAK;YACX,QAAQ,EAAE,wDAAwD;YAClE,eAAe,EAAE,CAAC;SACnB,CAAC,CAAC,CAAC;YACF,KAAK,EAAE,OAAO;YACd,IAAI,EAAE,IAAI;YACV,QAAQ,EAAE,8CAA8C,IAAI,CAAC,UAAU,iBAAiB;YACxF,eAAe,EAAE,WAAW,CAAC,YAAY;kBACrC,WAAW,CAAC,UAAU;kBACtB,IAAI,CAAC,UAAU,GAAG,WAAW,CAAC,UAAU;SAC7C;QACD,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC;YAChB,KAAK,EAAE,MAAM;YACb,IAAI,EAAE,KAAK;YACX,QAAQ,EAAE,mEAAmE;YAC7E,eAAe,EAAE,CAAC;SACnB,CAAC,CAAC,CAAC;YACF,KAAK,EAAE,MAAM;YACb,IAAI,EAAE,KAAK;YACX,QAAQ,EAAE,qDAAqD;YAC/D,eAAe,EAAE,CAAC;SACnB;QACD,IAAI,CAAC,UAAU,KAAK,UAAU,CAAC,CAAC,CAAC;YAC/B,KAAK,EAAE,SAAS;YAChB,IAAI,EAAE,KAAK;YACX,QAAQ,EAAE,+CAA+C;YACzD,eAAe,EAAE,CAAC;SACnB,CAAC,CAAC,CAAC;YACF,KAAK,EAAE,SAAS;YAChB,IAAI,EAAE,IAAI;YACV,QAAQ,EAAE,KAAK,IAAI,CAAC,eAAe,8CAA8C;YACjF,eAAe,EAAE,UAAU,GAAG,WAAW,CAAC,kBAAkB;SAC7D;QACD;YACE,KAAK,EAAE,MAAM;YACb,IAAI,EAAE,IAAI,CAAC,SAAS,KAAK,OAAO,IAAI,IAAI,CAAC,iBAAiB;YAC1D,QAAQ,EAAE,IAAI,CAAC,SAAS,KAAK,KAAK;gBAChC,CAAC,CAAC,gEAAgE;gBAClE,CAAC,CAAC,IAAI,CAAC,iBAAiB;oBACtB,CAAC,CAAC,KAAK,IAAI,CAAC,eAAe,oDAAoD;oBAC/E,CAAC,CAAC,2CAA2C;YACjD,eAAe,EAAE,IAAI,CAAC,SAAS,KAAK,OAAO,IAAI,IAAI,CAAC,iBAAiB,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;SACvF;KACF,CAAC;IACF,OAAO;QACL,MAAM;QACN,oBAAoB,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CACxC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,GAAG,KAAK,CAAC,eAAe,EAC/C,CAAC,CACF,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;QACb,YAAY,EAAE,2EAA2E;KAC1F,CAAC;AACJ,CAAC,CAAC"}

package/dist/improve-source-hints.d.ts

@@ -0,0 +1,31 @@
+import type { LayerLeaf } from './improve-layerdoc-types.js';
+/**
+ * Source hints are evidence, never certainty. Only src/ TSX, JSX, and CSS are
+ * indexed. Exact rendered class combinations rank above distinctive classes,
+ * identity attributes, literal text, and inherited ancestor evidence.
+ */
+type SourceFile = {
+    path: string;
+    relativePath: string;
+    extension: string;
+    lines: string[];
+    text: string;
+};
+export type SourceIndex = {
+    repo?: string;
+    files: SourceFile[];
+};
+export type SourceHint = {
+    confidence: 'high' | 'medium' | 'low' | 'unresolved';
+    evidence: string;
+    relativePath?: string;
+    line?: number;
+    sourceLine?: string;
+    candidateCount?: number;
+    ancestorDepth?: number;
+};
+export declare const indexImproveSourceRepo: (repoPath: string) => SourceIndex;
+export declare const resolveImproveSourceHint: (leaf: LayerLeaf | undefined, index: SourceIndex, leaves?: readonly LayerLeaf[]) => SourceHint;
+export declare const formatImproveSourceHint: (hint: SourceHint) => string;
+export {};
+//# sourceMappingURL=improve-source-hints.d.ts.map

package/dist/improve-source-hints.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"improve-source-hints.d.ts","sourceRoot":"","sources":["../src/improve-source-hints.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AAE7D;;;;GAIG;AAEH,KAAK,UAAU,GAAG;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,UAAU,EAAE,CAAA;CAAE,CAAC;AACjE,MAAM,MAAM,UAAU,GAAG;IACvB,UAAU,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,GAAG,YAAY,CAAC;IACrD,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,CAAC;AAiBF,eAAO,MAAM,sBAAsB,GAAI,UAAU,MAAM,KAAG,WAiBzD,CAAC;AA8FF,eAAO,MAAM,wBAAwB,GACnC,MAAM,SAAS,GAAG,SAAS,EAC3B,OAAO,WAAW,EAClB,SAAQ,SAAS,SAAS,EAAO,KAChC,UAuBF,CAAC;AAEF,eAAO,MAAM,uBAAuB,GAAI,MAAM,UAAU,KAAG,MAI1D,CAAC"}