@12ui/design 0.2.57 → 0.2.59

package/dist/improve-core/improve-retain.d.ts

@@ -0,0 +1,121 @@
+/**
+ * WHAT AN IMPROVE RUN KEEPS. One module owns the answer, because the CLI, the
+ * /improve page, and the site-wide branch all have to ask it and all have to
+ * get the same one.
+ *
+ * WHY THIS EXISTS (owner, direct chat 2026-09-02, on a chargedesk.com run):
+ * "it's kind of retaining the wrong stuff. Obviously, I would expect the logo
+ * to be retained, or at least very similar, whereas it's keeping all of the
+ * title, the text, the icons, and stuff in the exact same place and just very
+ * slightly altering the background image… It's not giving me a new design."
+ *
+ * That was the shipped default doing exactly what it was told: improve pinned
+ * `layout` and `content` and excluded `assets`, so the geometry was frozen and
+ * the brand was the one thing licensed to change. The vocabulary was never
+ * wrong — the DEFAULT was inverted, and the four facets were invisible.
+ *
+ * THE CONTROL IS THE FACETS THEMSELVES (owner, same day): "I feel like it
+ * might be better to have retain toggles on the UI. So if we were to remove
+ * the layout toggle for example, it might resolve some of the problems?" So
+ * there is no invented ladder of level names between the visitor and the
+ * service — the four things the service already understands are the four
+ * things a visitor turns on and off, and `12ui improve --retain` is the same
+ * control on the command line.
+ */
+/** The same shape as the service's `CreateRetainPolicy`, restated here because
+ * improve-core may not import from the worker or the CLI. */
+export type ImproveRetainPolicy = {
+    include: string[];
+    exclude: string[];
+    notes?: string;
+    /**
+     * Improve's reference is always the caller's OWN page, never a design they
+     * liked, and the service reads this to decide what an EXCLUSION means: a
+     * prohibition against someone else's work, or a licence over your own. Every
+     * policy this module hands out declares it, so no improve request can reach
+     * the model as "do not reuse its actual content or text".
+     */
+    source?: 'inspiration' | 'subject';
+};
+/** The service's vocabulary, in the order the toggles read. */
+export declare const IMPROVE_RETAIN_FACETS: readonly ["layout", "content", "assets", "style"];
+export type ImproveRetainFacet = (typeof IMPROVE_RETAIN_FACETS)[number];
+/**
+ * Copy and brand kept; geometry and visual system free.
+ *
+ * The superseded default was the exact inverse — `include [layout, content]`,
+ * `exclude [style, assets]` — which pinned every element in place and licensed
+ * the logo to change. Keeping the product's own words and brand while freeing
+ * how the page is laid out and how it looks is what "improve" was always meant
+ * to mean.
+ */
+export declare const DEFAULT_IMPROVE_RETAIN: Readonly<ImproveRetainPolicy>;
+export declare const improveRetainKeeps: (retain: ImproveRetainPolicy, facet: ImproveRetainFacet) => boolean;
+/** Canonicalize a facet set into the policy the service hashes. */
+export declare const improveRetainFor: (facets: readonly ImproveRetainFacet[]) => ImproveRetainPolicy;
+/** Flip one toggle, returning a fresh canonical policy. */
+export declare const improveRetainToggled: (retain: ImproveRetainPolicy, facet: ImproveRetainFacet, keep: boolean) => ImproveRetainPolicy;
+/**
+ * THE STATE IMPROVE MUST NOT BE IN (owner, direct chat 2026-09-02): "maybe we
+ * just don't allow all 4 to be enabled at once? At least one gate must not be
+ * selected?"
+ *
+ * With every facet kept there is nothing left for an improvement to be. The
+ * measured behaviour on a photo-led page is a near no-op — an image edit handed
+ * a full conservation set returns its input (`.tmp/site-improve/polish-study`,
+ * chargedesk ink delta 4.6%) — so the request buys a paid call and returns the
+ * page it was given. The four facets are exhaustive, so "keep all four" is the
+ * one combination that cannot be honoured, and it is refused rather than
+ * charged for.
+ *
+ * Extra labels (`palette`, an unknown semantic note) do not enter into it: the
+ * question is only whether all four of the facets the toggles expose are held.
+ */
+export declare const improveRetainKeepsEverything: (retain: ImproveRetainPolicy) => boolean;
+/**
+ * The one sentence every surface says when it refuses. `copy` and `brand` are
+ * the words the toggles use AND accepted `--retain` aliases for `content` and
+ * `assets`, so the same sentence is true on the page and on the command line.
+ */
+export declare const IMPROVE_RETAIN_ALL_KEPT_REFUSAL = "At least one of layout, copy, brand, and style must be left free to change.";
+/**
+ * Whether this facet may still be switched on. Three kept is the ceiling, so
+ * the fourth box is the only one a page ever has to disable.
+ */
+export declare const improveRetainMayKeep: (retain: ImproveRetainPolicy, facet: ImproveRetainFacet) => boolean;
+/**
+ * A policy that arrived from outside this session — restored history, a link
+ * someone kept, a stored draft from before this rule — made usable. All four
+ * kept is not a request anything can honour, so it resolves to the default
+ * (copy + brand) rather than crashing a page or reaching a paid call.
+ */
+export declare const improveRetainResolved: (retain: ImproveRetainPolicy) => ImproveRetainPolicy;
+/**
+ * The service derives run mode from retain (layout retained → preserve
+ * structure), so a caller that sends a mode has to send the matching one or
+ * its request reads as a contradiction it did not intend.
+ */
+export declare const improveRetainMode: (retain: ImproveRetainPolicy) => "preserve-structure" | "inspiration";
+/**
+ * The toggle's own label. The owner named these in plain words, and they are
+ * the words both the page and `--help` use: a facet is called the same thing
+ * wherever a person meets it.
+ */
+export declare const improveRetainFacetLabel: (facet: ImproveRetainFacet) => string;
+/**
+ * What turning this one off licenses, for a hover or a help line.
+ *
+ * `style` says both halves, because "keep style" is the one facet a person
+ * reads as "change nothing" (owner, 2026-09-02: "Selecting all the options
+ * results in no changes?"). It keeps the style's IDENTITY — palette,
+ * typography voice, image treatment — and the page still gets polished.
+ */
+export declare const improveRetainFacetHint: (facet: ImproveRetainFacet) => string;
+/**
+ * The `12ui improve --retain` string that asks for exactly this. With nothing
+ * kept there is no positive list to write, so it uses the flag's own explicit
+ * exclusion spelling (`-layout,…`) rather than a word the parser would read as
+ * a label.
+ */
+export declare const improveRetainFlag: (retain: ImproveRetainPolicy) => string;
+//# sourceMappingURL=improve-retain.d.ts.map

package/dist/improve-core/improve-retain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"improve-retain.d.ts","sourceRoot":"","sources":["../../src/improve-core/improve-retain.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH;6DAC6D;AAC7D,MAAM,MAAM,mBAAmB,GAAG;IAChC,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;;;OAMG;IACH,MAAM,CAAC,EAAE,aAAa,GAAG,SAAS,CAAC;CACpC,CAAC;AAEF,+DAA+D;AAC/D,eAAO,MAAM,qBAAqB,mDAAoD,CAAC;AACvF,MAAM,MAAM,kBAAkB,GAAG,CAAC,OAAO,qBAAqB,CAAC,CAAC,MAAM,CAAC,CAAC;AAExE;;;;;;;;GAQG;AACH,eAAO,MAAM,sBAAsB,EAAE,QAAQ,CAAC,mBAAmB,CAIhE,CAAC;AAEF,eAAO,MAAM,kBAAkB,GAC7B,QAAQ,mBAAmB,EAC3B,OAAO,kBAAkB,KACxB,OAAyC,CAAC;AAE7C,mEAAmE;AACnE,eAAO,MAAM,gBAAgB,GAC3B,QAAQ,SAAS,kBAAkB,EAAE,KACpC,mBAOF,CAAC;AAEF,2DAA2D;AAC3D,eAAO,MAAM,oBAAoB,GAC/B,QAAQ,mBAAmB,EAC3B,OAAO,kBAAkB,EACzB,MAAM,OAAO,KACZ,mBAEF,CAAC;AAEF;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,4BAA4B,GAAI,QAAQ,mBAAmB,KAAG,OAE1E,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,+BAA+B,gFACmC,CAAC;AAEhF;;;GAGG;AACH,eAAO,MAAM,oBAAoB,GAC/B,QAAQ,mBAAmB,EAC3B,OAAO,kBAAkB,KACxB,OAGF,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,GAChC,QAAQ,mBAAmB,KAC1B,mBAMF,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,GAC5B,QAAQ,mBAAmB,KAC1B,oBAAoB,GAAG,aAEzB,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,uBAAuB,GAAI,OAAO,kBAAkB,KAAG,MAKnE,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,sBAAsB,GAAI,OAAO,kBAAkB,KAAG,MAKlE,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,GAAI,QAAQ,mBAAmB,KAAG,MAI/D,CAAC"}

package/dist/improve-core/improve-retain.js

@@ -0,0 +1,115 @@
+// GENERATED — do not edit. Copied verbatim from
+// packages/layerdoc/src/improve-core by scripts/sync-improve-core.mjs.
+/** The service's vocabulary, in the order the toggles read. */
+export const IMPROVE_RETAIN_FACETS = ['layout', 'content', 'assets', 'style'];
+/**
+ * Copy and brand kept; geometry and visual system free.
+ *
+ * The superseded default was the exact inverse — `include [layout, content]`,
+ * `exclude [style, assets]` — which pinned every element in place and licensed
+ * the logo to change. Keeping the product's own words and brand while freeing
+ * how the page is laid out and how it looks is what "improve" was always meant
+ * to mean.
+ */
+export const DEFAULT_IMPROVE_RETAIN = {
+    include: ['assets', 'content'],
+    exclude: ['layout', 'style'],
+    source: 'subject',
+};
+export const improveRetainKeeps = (retain, facet) => retain.include.includes(facet);
+/** Canonicalize a facet set into the policy the service hashes. */
+export const improveRetainFor = (facets) => {
+    const kept = new Set(facets);
+    return {
+        include: IMPROVE_RETAIN_FACETS.filter((facet) => kept.has(facet)).sort(),
+        exclude: IMPROVE_RETAIN_FACETS.filter((facet) => !kept.has(facet)).sort(),
+        source: 'subject',
+    };
+};
+/** Flip one toggle, returning a fresh canonical policy. */
+export const improveRetainToggled = (retain, facet, keep) => improveRetainFor(IMPROVE_RETAIN_FACETS.filter((entry) => (entry === facet ? keep : improveRetainKeeps(retain, entry))));
+/**
+ * THE STATE IMPROVE MUST NOT BE IN (owner, direct chat 2026-09-02): "maybe we
+ * just don't allow all 4 to be enabled at once? At least one gate must not be
+ * selected?"
+ *
+ * With every facet kept there is nothing left for an improvement to be. The
+ * measured behaviour on a photo-led page is a near no-op — an image edit handed
+ * a full conservation set returns its input (`.tmp/site-improve/polish-study`,
+ * chargedesk ink delta 4.6%) — so the request buys a paid call and returns the
+ * page it was given. The four facets are exhaustive, so "keep all four" is the
+ * one combination that cannot be honoured, and it is refused rather than
+ * charged for.
+ *
+ * Extra labels (`palette`, an unknown semantic note) do not enter into it: the
+ * question is only whether all four of the facets the toggles expose are held.
+ */
+export const improveRetainKeepsEverything = (retain) => (IMPROVE_RETAIN_FACETS.every((facet) => improveRetainKeeps(retain, facet)));
+/**
+ * The one sentence every surface says when it refuses. `copy` and `brand` are
+ * the words the toggles use AND accepted `--retain` aliases for `content` and
+ * `assets`, so the same sentence is true on the page and on the command line.
+ */
+export const IMPROVE_RETAIN_ALL_KEPT_REFUSAL = 'At least one of layout, copy, brand, and style must be left free to change.';
+/**
+ * Whether this facet may still be switched on. Three kept is the ceiling, so
+ * the fourth box is the only one a page ever has to disable.
+ */
+export const improveRetainMayKeep = (retain, facet) => (improveRetainKeeps(retain, facet)
+    || IMPROVE_RETAIN_FACETS.some((entry) => entry !== facet && !improveRetainKeeps(retain, entry)));
+/**
+ * A policy that arrived from outside this session — restored history, a link
+ * someone kept, a stored draft from before this rule — made usable. All four
+ * kept is not a request anything can honour, so it resolves to the default
+ * (copy + brand) rather than crashing a page or reaching a paid call.
+ */
+export const improveRetainResolved = (retain) => (improveRetainKeepsEverything(retain)
+    ? improveRetainFor(IMPROVE_RETAIN_FACETS.filter((facet) => improveRetainKeeps(DEFAULT_IMPROVE_RETAIN, facet)))
+    : retain);
+/**
+ * The service derives run mode from retain (layout retained → preserve
+ * structure), so a caller that sends a mode has to send the matching one or
+ * its request reads as a contradiction it did not intend.
+ */
+export const improveRetainMode = (retain) => (improveRetainKeeps(retain, 'layout') ? 'preserve-structure' : 'inspiration');
+/**
+ * The toggle's own label. The owner named these in plain words, and they are
+ * the words both the page and `--help` use: a facet is called the same thing
+ * wherever a person meets it.
+ */
+export const improveRetainFacetLabel = (facet) => {
+    if (facet === 'layout')
+        return 'Keep layout';
+    if (facet === 'content')
+        return 'Keep copy';
+    if (facet === 'assets')
+        return 'Keep brand';
+    return 'Keep style';
+};
+/**
+ * What turning this one off licenses, for a hover or a help line.
+ *
+ * `style` says both halves, because "keep style" is the one facet a person
+ * reads as "change nothing" (owner, 2026-09-02: "Selecting all the options
+ * results in no changes?"). It keeps the style's IDENTITY — palette,
+ * typography voice, image treatment — and the page still gets polished.
+ */
+export const improveRetainFacetHint = (facet) => {
+    if (facet === 'layout')
+        return 'Off: the page may be laid out again from scratch.';
+    if (facet === 'content')
+        return 'Off: the words may be rewritten, but no fact may be invented.';
+    if (facet === 'assets')
+        return 'Off: the logo, wordmark, and brand imagery may be replaced.';
+    return 'Off: a new palette, typography, and image treatment. On: those stay, and the page is still polished.';
+};
+/**
+ * The `12ui improve --retain` string that asks for exactly this. With nothing
+ * kept there is no positive list to write, so it uses the flag's own explicit
+ * exclusion spelling (`-layout,…`) rather than a word the parser would read as
+ * a label.
+ */
+export const improveRetainFlag = (retain) => (retain.include.length > 0
+    ? [...retain.include].sort().join(',')
+    : IMPROVE_RETAIN_FACETS.map((facet) => `-${facet}`).join(','));
+//# sourceMappingURL=improve-retain.js.map

package/dist/improve-core/improve-retain.js.map

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

package/dist/improve-core/improve-site-plan.d.ts

@@ -0,0 +1,75 @@
+import { type ImproveSiteShellChange, type ImproveSiteSharedShellRollup } from './improve-site-shell.js';
+import { type ImproveSiteTokenPatch, type ImproveSiteTokenRollup } from './improve-site-tokens.js';
+import type { ImproveArtifactMap } from './improve-artifacts.js';
+export type ImproveSitePageGate = 'passed' | 'blocked' | 'not-applicable' | 'failed';
+/**
+ * The site roll-up needs stable page facts and the paths a reader should be
+ * linked to; capture, branch, and conversion orchestration stay outside. Paths
+ * are opaque to the core — it hands each one to the caller's `relativePath` to
+ * be named, so a kit written to disk and a kit zipped in a browser read alike.
+ */
+export type ImproveSitePagePlan = {
+    id: string;
+    url: string;
+    gate: ImproveSitePageGate;
+    /** A branch failure has no polished target or implementation plan. */
+    failure?: {
+        code: string;
+        message: string;
+    };
+    polishedImagePath?: string;
+    targetHtmlPath?: string;
+    targetLayout?: 'document' | 'responsive' | 'fixed';
+    responsiveWarning?: string;
+    currentDomDocPath: string;
+    tokenPatchPath: string;
+    diffPath: string;
+    planPath: string;
+    coverage?: number;
+    matchedCount?: number;
+    addedCount?: number;
+    removedCount?: number;
+    sourceHints: string[];
+};
+export type ImproveSitePlanArtifacts = {
+    artifacts: ImproveArtifactMap;
+    pages: readonly ImproveSitePagePlan[];
+    tokens: ImproveSiteTokenRollup;
+    sharedShell: ImproveSiteSharedShellRollup;
+};
+export type ImproveSiteDiffFacts = {
+    coverage?: number;
+    matchedCount?: number;
+    addedCount?: number;
+    removedCount?: number;
+};
+/** How the core names a path it did not create: the caller decides. */
+export type ImproveSiteRelativePath = (file: string) => string;
+/** The counts a page plan's `diff.json` contributes to the page inventory. */
+export declare const parseImproveSiteDiffFacts: (text: string | undefined) => ImproveSiteDiffFacts;
+export declare const IMPROVE_SITE_PAGES_FILE = "pages.md";
+export declare const IMPROVE_SITE_APPLY_FILE = "APPLY.md";
+export declare const renderImproveSitePages: (args: {
+    pages: readonly ImproveSitePagePlan[];
+    relativePath: ImproveSiteRelativePath;
+}) => string;
+export declare const renderImproveSiteApply: (args: {
+    pages: readonly ImproveSitePagePlan[];
+    relativePath: ImproveSiteRelativePath;
+    repo?: string;
+    sourceUrl?: string;
+}) => string;
+/**
+ * The four free site-stage deliverables. Missing token or diff artifacts are
+ * expected for blocked pages and are shown honestly in `pages.md` rather than
+ * preventing the rest of the roll-up.
+ */
+export declare const planImproveSiteArtifacts: (args: {
+    pages: readonly ImproveSitePagePlan[];
+    tokenPatches: readonly ImproveSiteTokenPatch[];
+    shellChanges: readonly ImproveSiteShellChange[];
+    relativePath: ImproveSiteRelativePath;
+    repo?: string;
+    sourceUrl?: string;
+}) => ImproveSitePlanArtifacts;
+//# sourceMappingURL=improve-site-plan.d.ts.map

package/dist/improve-core/improve-site-plan.d.ts.map

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

package/dist/improve-core/improve-site-plan.js

@@ -0,0 +1,135 @@
+// GENERATED — do not edit. Copied verbatim from
+// packages/layerdoc/src/improve-core by scripts/sync-improve-core.mjs.
+import { detectImproveSiteSharedShell, renderImproveSiteSharedShell, IMPROVE_SITE_SHARED_SHELL_FILE, } from './improve-site-shell.js';
+import { mergeImproveSiteTokens, IMPROVE_SITE_TOKENS_FILE, } from './improve-site-tokens.js';
+const isRecord = (value) => (Boolean(value) && typeof value === 'object' && !Array.isArray(value));
+const markdownCell = (value) => value.replaceAll('|', '\\|').replaceAll('\n', ' ');
+const markdownLink = (relativePath, file, label) => (file ? `[${label}](${relativePath(file)})` : '—');
+/** The counts a page plan's `diff.json` contributes to the page inventory. */
+export const parseImproveSiteDiffFacts = (text) => {
+    if (!text)
+        return {};
+    const document = JSON.parse(text);
+    if (!isRecord(document))
+        return {};
+    const meta = isRecord(document.meta) ? document.meta : {};
+    return {
+        ...(typeof document.domCoverage === 'number' ? { coverage: document.domCoverage } : {}),
+        ...(typeof meta.matchedCount === 'number' ? { matchedCount: meta.matchedCount } : {}),
+        ...(typeof meta.addedCount === 'number' ? { addedCount: meta.addedCount } : {}),
+        ...(typeof meta.removedCount === 'number' ? { removedCount: meta.removedCount } : {}),
+    };
+};
+const formatCoverage = (coverage) => coverage === undefined
+    ? '—'
+    : `${(coverage * 100).toFixed(1)}%`;
+const formatFailure = (failure) => (failure ? markdownCell(`${failure.code}: ${failure.message}`) : '—');
+const formatTarget = (relativePath, page) => {
+    const link = markdownLink(relativePath, page.targetHtmlPath, page.targetLayout === 'fixed' ? 'fixed HTML' : 'target HTML');
+    if (!page.responsiveWarning)
+        return link;
+    return markdownCell(`${link} — ${page.responsiveWarning}`);
+};
+export const IMPROVE_SITE_PAGES_FILE = 'pages.md';
+export const IMPROVE_SITE_APPLY_FILE = 'APPLY.md';
+export const renderImproveSitePages = (args) => {
+    const lines = [
+        '# Pages', '',
+        '| Page | URL | Gate | Failure | Coverage | Matched | Added | Removed | Polished image | Target HTML | Plan |',
+        '| --- | --- | --- | --- | ---: | ---: | ---: | ---: | --- | --- | --- |',
+    ];
+    for (const page of args.pages) {
+        lines.push([
+            page.id,
+            markdownCell(page.url),
+            page.gate,
+            formatFailure(page.failure),
+            formatCoverage(page.coverage),
+            page.matchedCount ?? '—',
+            page.addedCount ?? '—',
+            page.removedCount ?? '—',
+            markdownLink(args.relativePath, page.polishedImagePath, 'polished.png'),
+            formatTarget(args.relativePath, page),
+            page.gate === 'failed' ? '—' : markdownLink(args.relativePath, page.planPath, 'annotated plan'),
+        ].join(' | ').replace(/^/u, '| ').replace(/$/u, ' |'));
+    }
+    lines.push('');
+    return lines.join('\n');
+};
+export const renderImproveSiteApply = (args) => {
+    const source = args.sourceUrl ?? args.pages[0]?.url ?? '<root-url>';
+    const lines = [
+        '# Apply the whole-site polish', '',
+        'Use this brief in order. The page plans are implementation evidence, not an invitation to invent a new product.', '',
+        '## 1. Apply tokens through the theme entry point', '',
+        `- Start with [tokens.css](${IMPROVE_SITE_TOKENS_FILE}). Apply its declarations through the repository's existing global token or theme entry point.`,
+        ...(args.repo ? [`- Repository supplied with \`--repo\`: \`${args.repo}\`. Prefer its existing theme ownership and avoid parallel token systems.`] : ['- No `--repo` was supplied. Identify the owning theme entry point before changing tokens.']),
+        '',
+        '## 2. Apply shared shell changes once', '',
+        `- Follow [shared-shell.md](${IMPROVE_SITE_SHARED_SHELL_FILE}) for repeated header, navigation, sidebar, and footer changes. Implement each shared item in its shared component once.`,
+        '- Do not repeat entries marked **shared — apply once** in page-specific residue.', '',
+        '## 3. Apply per-page residue in page order', '',
+    ];
+    for (const page of args.pages) {
+        if (page.gate === 'failed') {
+            const failure = page.failure
+                ? `${page.failure.code}: ${page.failure.message}`
+                : 'the branch service did not return a failure detail';
+            lines.push(`- **${page.id}** (${page.url}) — Skipped: its branch failed (${failure}). No polished target or per-page plan was produced; resolve the branch failure before applying this page.`);
+            continue;
+        }
+        const plan = markdownLink(args.relativePath, page.planPath, 'plan-annotated.md');
+        const state = page.gate === 'blocked'
+            ? 'Blocked: resolve the gate before applying page-specific changes.'
+            : page.gate === 'not-applicable'
+                ? 'Target-only: implement only the explicitly specified target changes.'
+                : 'Apply only the page-specific residue after tokens and shared shell work.';
+        lines.push(`- **${page.id}** (${page.url}) — ${plan}. ${state}`);
+        if (args.repo && page.sourceHints.length > 0) {
+            lines.push(`  - Repository hints: ${page.sourceHints.map((hint) => `\`${hint}\``).join(', ')}.`);
+        }
+    }
+    lines.push('', '## 4. Implement added-element specs with their assets', '');
+    lines.push('- In each annotated page plan, implement every `Added` specification exactly where it says to insert it. Copy or reference the declared asset at its listed destination; do not replace it with a placeholder.');
+    lines.push('', '## 5. Guardrails', '');
+    lines.push('- No invention: preserve the real content, data, copy, and controls shown by each current page.', '- No dead controls: retain behavior and wire every visible interactive control to its existing action.', '- No hardcoded identity: preserve configurable product, account, and route data instead of baking it into components.', '- Keep configurable data configurable: use the existing data and theme boundaries rather than duplicating literals.');
+    lines.push('', '## 6. Verify convergence', '');
+    lines.push('- Re-shoot every page at its captured viewport after implementation.', `- Apply this \`APPLY.md\`, then run \`12ui improve ${source} --scope site --out-dir <kit> --recheck\` against the kept targets and compare the residual drift before accepting the implementation.`, '- Treat a blocked page or a structural regression as unresolved even if a coverage metric improves.', '');
+    return lines.join('\n');
+};
+/**
+ * The four free site-stage deliverables. Missing token or diff artifacts are
+ * expected for blocked pages and are shown honestly in `pages.md` rather than
+ * preventing the rest of the roll-up.
+ */
+export const planImproveSiteArtifacts = (args) => {
+    const tokens = mergeImproveSiteTokens(args.tokenPatches);
+    const sharedShellChanges = detectImproveSiteSharedShell(args.shellChanges);
+    const sharedShell = {
+        changes: sharedShellChanges,
+        markdown: renderImproveSiteSharedShell(sharedShellChanges, args.relativePath),
+    };
+    return {
+        artifacts: {
+            files: {
+                [IMPROVE_SITE_TOKENS_FILE]: tokens.css,
+                [IMPROVE_SITE_SHARED_SHELL_FILE]: sharedShell.markdown,
+                [IMPROVE_SITE_PAGES_FILE]: renderImproveSitePages({
+                    pages: args.pages,
+                    relativePath: args.relativePath,
+                }),
+                [IMPROVE_SITE_APPLY_FILE]: renderImproveSiteApply({
+                    pages: args.pages,
+                    relativePath: args.relativePath,
+                    ...(args.repo ? { repo: args.repo } : {}),
+                    ...(args.sourceUrl ? { sourceUrl: args.sourceUrl } : {}),
+                }),
+            },
+            remove: [],
+        },
+        pages: args.pages,
+        tokens,
+        sharedShell,
+    };
+};
+//# sourceMappingURL=improve-site-plan.js.map

package/dist/improve-core/improve-site-plan.js.map

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

package/dist/improve-core/improve-site-shell.d.ts

@@ -0,0 +1,56 @@
+import type { LayerDelta } from './improve-layerdoc-types.js';
+/**
+ * Shared shell detection. The inputs are the strings a host happens to have —
+ * a page `diff.json` and its `current.domdoc.json` — so parsing them is policy
+ * and reading them is not.
+ */
+export type ImproveSiteShellSelectorKind = 'id' | 'testid' | 'class' | 'path';
+export type ImproveSiteShellChange = {
+    pageId: string;
+    selectorKind: ImproveSiteShellSelectorKind;
+    selector: string;
+    classSelector?: string;
+    tag?: string;
+    path?: string;
+    classList?: readonly string[];
+    content?: string;
+    deltas: readonly LayerDelta[];
+    impliedPadding?: readonly LayerDelta[];
+    planPath?: string;
+};
+export type ImproveSiteSharedShellChange = {
+    selectorKind: ImproveSiteShellSelectorKind;
+    selector: string;
+    content: string;
+    pages: string[];
+    changes: ImproveSiteShellChange[];
+};
+export type ImproveSiteSharedShellRollup = {
+    changes: ImproveSiteSharedShellChange[];
+    markdown: string;
+};
+/**
+ * Retains only changed, shell-region entries that recur on two or more distinct
+ * pages. The signature deliberately includes content so identical selector names
+ * do not merge unrelated navigation items.
+ */
+export declare const detectImproveSiteSharedShell: (changes: readonly ImproveSiteShellChange[]) => ImproveSiteSharedShellChange[];
+/** Alias matching the artifact name used by the site stage. */
+export declare const findImproveSiteSharedShell: (changes: readonly ImproveSiteShellChange[]) => ImproveSiteSharedShellChange[];
+export declare const renderImproveSiteSharedShell: (changes: readonly ImproveSiteSharedShellChange[], relativePath?: (file: string) => string) => string;
+export type ImproveSiteShellSource = {
+    pageId: string;
+    /** The page `diff.json` text; absent when that page never emitted one. */
+    diffText?: string;
+    /** The page `current.domdoc.json` text, which carries the DOM identities. */
+    currentDomDocText?: string;
+    planPath?: string;
+};
+/**
+ * Turns each page's settled plan JSON into shell-change candidates. A page with
+ * no diff contributes nothing — that is the normal shape of a blocked or failed
+ * page, not an error.
+ */
+export declare const parseImproveSiteShellChanges: (sources: readonly ImproveSiteShellSource[]) => ImproveSiteShellChange[];
+export declare const IMPROVE_SITE_SHARED_SHELL_FILE = "shared-shell.md";
+//# sourceMappingURL=improve-site-shell.d.ts.map

package/dist/improve-core/improve-site-shell.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"improve-site-shell.d.ts","sourceRoot":"","sources":["../../src/improve-core/improve-site-shell.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAE9D;;;;GAIG;AACH,MAAM,MAAM,4BAA4B,GAAG,IAAI,GAAG,QAAQ,GAAG,OAAO,GAAG,MAAM,CAAC;AAE9E,MAAM,MAAM,sBAAsB,GAAG;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,4BAA4B,CAAC;IAC3C,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,SAAS,UAAU,EAAE,CAAC;IAC9B,cAAc,CAAC,EAAE,SAAS,UAAU,EAAE,CAAC;IACvC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,4BAA4B,GAAG;IACzC,YAAY,EAAE,4BAA4B,CAAC;IAC3C,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,OAAO,EAAE,sBAAsB,EAAE,CAAC;CACnC,CAAC;AAEF,MAAM,MAAM,4BAA4B,GAAG;IACzC,OAAO,EAAE,4BAA4B,EAAE,CAAC;IACxC,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAgDF;;;;GAIG;AACH,eAAO,MAAM,4BAA4B,GACvC,SAAS,SAAS,sBAAsB,EAAE,KACzC,4BAA4B,EAwB9B,CAAC;AAEF,+DAA+D;AAC/D,eAAO,MAAM,0BAA0B,YA5B5B,SAAS,sBAAsB,EAAE,KACzC,4BAA4B,EA2BuC,CAAC;AAEvE,eAAO,MAAM,4BAA4B,GACvC,SAAS,SAAS,4BAA4B,EAAE,EAChD,eAAc,CAAC,IAAI,EAAE,MAAM,KAAK,MAAuB,KACtD,MAoBF,CAAC;AAGF,MAAM,MAAM,sBAAsB,GAAG;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,0EAA0E;IAC1E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,6EAA6E;IAC7E,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,4BAA4B,GACvC,SAAS,SAAS,sBAAsB,EAAE,KACzC,sBAAsB,EAiDvB,CAAC;AAEH,eAAO,MAAM,8BAA8B,oBAAoB,CAAC"}