@12ui/design 0.2.56 → 0.2.58

package/dist/{improve-plan-annotated-render.js → improve-core/improve-plan-annotated-render.js}

@@ -1,7 +1,12 @@
+// GENERATED — do not edit. Copied verbatim from
+// packages/layerdoc/src/improve-core by scripts/sync-improve-core.mjs.
 import { selectorLabel } from './improve-dom-anchor.js';
-import { formatImproveBounds, improveCarriedRasterLayers, improveFrameMappingLine, } from './improve-kit-assets.js';
+import { improveLowOverlapNote } from './improve-dom-gate.js';
+import { formatImproveBounds, improveCarriedRasterLayers, improveFrameMappingLine, } from './improve-kit-asset-model.js';
 import { renderImproveRasterLayers } from './improve-raster-layers-section.js';
+import { improveVectorKeeps, renderImproveVectorKeeps, } from './improve-plan-vector-keep.js';
 import { formatImproveSourceHint } from './improve-source-hints.js';
+import { fontTokenName } from './improve-token-patch.js';
 /** Tokens shown inline; the rest stay in `token-patch.css`, which keeps them all. */
 export const IMPROVE_PLAN_TOKEN_LIMIT = 12;
 /** Selectors per token line. Fifty-four on one line is not a readable plan. */
@@ -14,27 +19,43 @@ const MODE_MEANING = {
         + ' specification rather than a diff.',
 };
 const percent = (value) => `${(value * 100).toFixed(1)}%`;
-const header = (args) => [
-    '# Annotated implementation plan',
-    '',
-    '## How to read this plan',
-    '',
-    `- Mode: **${args.mode}** — ${MODE_MEANING[args.mode]}`,
-    `- Coverage ${percent(args.computed.domCoverage)} before-side:`
-        + ' the share of the existing interface\'s elements the target could be matched to.',
-    `- Coverage ${percent(args.computed.designCoverage)} target-side:`
-        + ' the share of the target\'s elements that matched something already there.',
-    `- Frame: ${improveFrameMappingLine({
-        frame: args.computed.beforeCanvas,
-        design: args.computed.targetCanvas,
-    })}`,
-    '- Precedence: assets → tokens → matched changes → added elements. Work them in that order.',
-    '- Skip an item only with a stated reason in your report; never skip a raster layer.',
-    `- Source repository: ${args.repo ? `\`${args.repo}\`` : 'not supplied; file hints are unresolved'}`,
-    '',
-];
+const header = (args) => {
+    const lowOverlap = improveLowOverlapNote(args.computed.gate);
+    return [
+        '# Annotated implementation plan',
+        '',
+        '## How to read this plan',
+        '',
+        `- Mode: **${args.mode}** — ${MODE_MEANING[args.mode]}`,
+        `- Coverage ${percent(args.computed.domCoverage)} before-side:`
+            + ' the share of the existing interface\'s elements the target could be matched to.',
+        `- Coverage ${percent(args.computed.designCoverage)} target-side:`
+            + ' the share of the target\'s elements that matched something already there.',
+        ...(lowOverlap ? [`- ${lowOverlap}`] : []),
+        `- Frame: ${improveFrameMappingLine({
+            frame: args.computed.beforeCanvas,
+            design: args.computed.targetCanvas,
+        })}`,
+        '- Precedence: assets → tokens → matched changes → added elements. Work them in that order.',
+        '- Skip an item only with a stated reason in your report; never skip a raster layer.',
+        `- Source repository: ${args.repo ? `\`${args.repo}\`` : 'not supplied; file hints are unresolved'}`,
+        '',
+    ];
+};
+/**
+ * The design's font, named as a fact rather than fetched (F23).
+ *
+ * The token patch used to open with a Google Fonts `@import`, which is a
+ * network dependency and a CSP hazard the repository never asked for. The plan
+ * says which family the design uses and leaves the loading to whatever the
+ * repository already does.
+ */
+export const improveFontLines = (fonts) => fonts.map(({ family, weights }) => (`- Fonts: **${family}** (weights ${weights.join(', ')}), declared as \`${fontTokenName(family)}\``
+    + ' — the patch imports nothing. Load the family the way this repository already loads fonts:'
+    + ' self-host it, or add it to the existing loader.'));
 const tokens = (patch) => {
     const lines = ['## Tokens — apply once', '', '- Apply `token-patch.css` through the existing global token or theme entry point.'];
+    lines.push(...improveFontLines(patch.fontLoads));
     if (patch.tokens.length === 0) {
         lines.push('- No recurring CSS-capable delta reached the two-node threshold.', '');
         return lines;
@@ -98,6 +119,14 @@ const addedElements = (args) => {
     if (repeated) {
         lines.push('Entries that name an asset above are the same item, specified in full. Place each asset once.', '');
     }
+    // Two files per icon, and which one a lane reaches for decides whether the
+    // icon renders in its colour or black (F30).
+    if (args.addedSpecs.some((spec) => spec.asset?.inline)) {
+        lines.push('Icon assets come as a pair. `<name>.svg` carries the design\'s declared colour and is the'
+            + ' one to reference as an `<img>`, `background-image`, or `url()`;'
+            + ' `<name>-inline.svg` paints with `currentColor` and works only inlined in the markup or'
+            + ' as a `mask-image` whose call site sets the colour. Each spec below names its own pair.', '');
+    }
     lines.push(...args.addedSpecs.map((spec) => {
         const raster = args.rasterByIndex.get(spec.designIndex);
         const kind = raster?.kind ?? args.computed.targetLeaves[spec.designIndex]?.kind ?? 'layer';
@@ -114,13 +143,19 @@ const addedElements = (args) => {
     args.addedSpecs.forEach((spec) => lines.push(spec.markdown, ''));
     return lines;
 };
-const checklist = (rasterLayers) => {
+const checklist = (rasterLayers, keeps = []) => {
     // The same list the section above printed, so the checklist cannot ask for a
-    // plate that section deliberately left out.
-    const carried = improveCarriedRasterLayers(rasterLayers);
+    // plate that section deliberately left out — a kept vector included (F37).
+    const kept = new Set(keeps.map((keep) => keep.index));
+    const carried = improveCarriedRasterLayers(rasterLayers)
+        .filter((layer) => !kept.has(layer.index));
     return [
         '## Before you commit',
         '',
+        ...(keeps.length > 0
+            ? [`- Every vector node above is still an element, not an image: ${keeps
+                    .map((keep) => keep.selector).join(', ')}.`]
+            : []),
         carried.length > 0
             ? `- Every raster layer above is present in the page: ${carried
                 .map((layer) => `${layer.kind}${layer.asset ? ` (\`${layer.asset.id}\`)` : ''}`).join(', ')}.`
@@ -145,12 +180,24 @@ const guardrails = () => [
 ];
 export const renderImproveAnnotatedPlan = (args) => {
     const selectorByTargetIndex = new Map();
+    const domByTargetIndex = new Map();
     for (const entry of args.computed.result.matched) {
         const leaf = args.computed.beforeLeaves[entry.beforeIndex];
-        if (leaf?.dom)
-            selectorByTargetIndex.set(entry.afterIndex, selectorLabel(leaf));
+        if (!leaf?.dom)
+            continue;
+        selectorByTargetIndex.set(entry.afterIndex, selectorLabel(leaf));
+        domByTargetIndex.set(entry.afterIndex, leaf.dom);
     }
-    const rasterByIndex = new Map(args.index.rasterLayers.map((layer) => [layer.index, layer]));
+    const rasterLayers = args.index.rasterLayers;
+    // A cutout must never be placed over a node the page already draws as a
+    // vector (F37). The anchor's tag is a declared fact of the capture, so this
+    // arbitrates on evidence rather than on a guess about the design.
+    const keeps = improveVectorKeeps({
+        layers: args.index.rasterLayers,
+        anchor: (layer) => domByTargetIndex.get(layer.index),
+        label: (layer) => selectorByTargetIndex.get(layer.index),
+    });
+    const rasterByIndex = new Map(rasterLayers.map((layer) => [layer.index, layer]));
     return [
         ...header({
             computed: args.computed,
@@ -158,9 +205,11 @@ export const renderImproveAnnotatedPlan = (args) => {
             ...(args.repo ? { repo: args.repo } : {}),
         }),
         ...renderImproveRasterLayers({
-            layers: args.index.rasterLayers,
+            layers: rasterLayers,
             placement: (layer) => selectorByTargetIndex.get(layer.index),
+            exclude: new Set(keeps.map((keep) => keep.index)),
         }),
+        ...renderImproveVectorKeeps(keeps),
         ...tokens(args.tokenPatch),
         ...matchedChanges({
             computed: args.computed,
@@ -168,7 +217,7 @@ export const renderImproveAnnotatedPlan = (args) => {
             ...(args.repo ? { repo: args.repo } : {}),
         }),
         ...addedElements({ addedSpecs: args.addedSpecs, computed: args.computed, rasterByIndex }),
-        ...checklist(args.index.rasterLayers),
+        ...checklist(rasterLayers, keeps),
         ...guardrails(),
     ].join('\n');
 };

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

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

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

@@ -0,0 +1,34 @@
+import { type AddedElementSpec, type ImproveAssetResolver } from './improve-added-specs.js';
+import { type AnnotatedEntry, type ImprovePlanMode } from './improve-plan-annotated-render.js';
+import { type ImproveTokenPatch } from './improve-token-patch.js';
+import type { ImproveArtifactMap, ImproveDescribePath } from './improve-artifacts.js';
+import type { ImproveDomDiff } from './improve-dom-diff.js';
+import { type ImproveKitAssetIndex } from './improve-kit-asset-model.js';
+export type { AnnotatedEntry, ImprovePlanMode };
+export declare const IMPROVE_ANNOTATED_PLAN_FILE = "plan-annotated.md";
+export declare const IMPROVE_TOKEN_PATCH_FILE = "token-patch.css";
+/**
+ * The plan half of a passing gate: the token patch, the annotated plan, and the
+ * SVG assets its added-element specs reference. Source hints arrive resolved
+ * because indexing a repository is a host capability, not a policy.
+ */
+export declare const planImproveAnnotatedArtifacts: (args: {
+    computed: ImproveDomDiff;
+    targetDoc: unknown;
+    entries: readonly AnnotatedEntry[];
+    describePath: ImproveDescribePath;
+    resolveAsset?: ImproveAssetResolver;
+    /**
+     * The kit's assets on disk, when the host has a filesystem to read them from.
+     * Without it the plan still names every raster layer the target declares —
+     * it just says their files are not in this kit.
+     */
+    index?: ImproveKitAssetIndex;
+    repo?: string;
+    mode: ImprovePlanMode;
+}) => {
+    artifacts: ImproveArtifactMap;
+    tokenPatch: ImproveTokenPatch;
+    addedSpecs: AddedElementSpec[];
+};
+//# sourceMappingURL=improve-plan-annotator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"improve-plan-annotator.d.ts","sourceRoot":"","sources":["../../src/improve-core/improve-plan-annotator.ts"],"names":[],"mappings":"AAGA,OAAO,EAEL,KAAK,gBAAgB,EACrB,KAAK,oBAAoB,EAC1B,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAEL,KAAK,cAAc,EACnB,KAAK,eAAe,EACrB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EAA0B,KAAK,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC1F,OAAO,KAAK,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AACtF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAEL,KAAK,oBAAoB,EAC1B,MAAM,8BAA8B,CAAC;AAEtC,YAAY,EAAE,cAAc,EAAE,eAAe,EAAE,CAAC;AAEhD,eAAO,MAAM,2BAA2B,sBAAsB,CAAC;AAC/D,eAAO,MAAM,wBAAwB,oBAAoB,CAAC;AAE1D;;;;GAIG;AACH,eAAO,MAAM,6BAA6B,GAAI,MAAM;IAClD,QAAQ,EAAE,cAAc,CAAC;IACzB,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,EAAE,SAAS,cAAc,EAAE,CAAC;IACnC,YAAY,EAAE,mBAAmB,CAAC;IAClC,YAAY,CAAC,EAAE,oBAAoB,CAAC;IACpC;;;;OAIG;IACH,KAAK,CAAC,EAAE,oBAAoB,CAAC;IAC7B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,eAAe,CAAC;CACvB,KAAG;IACF,SAAS,EAAE,kBAAkB,CAAC;IAC9B,UAAU,EAAE,iBAAiB,CAAC;IAC9B,UAAU,EAAE,gBAAgB,EAAE,CAAC;CA0ChC,CAAC"}

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

@@ -0,0 +1,52 @@
+// GENERATED — do not edit. Copied verbatim from
+// packages/layerdoc/src/improve-core by scripts/sync-improve-core.mjs.
+import { buildImproveAddedElementSpecs, } from './improve-added-specs.js';
+import { renderImproveAnnotatedPlan, } from './improve-plan-annotated-render.js';
+import { buildImproveTokenPatch } from './improve-token-patch.js';
+import { improveRasterLayersOfDocument, } from './improve-kit-asset-model.js';
+export const IMPROVE_ANNOTATED_PLAN_FILE = 'plan-annotated.md';
+export const IMPROVE_TOKEN_PATCH_FILE = 'token-patch.css';
+/**
+ * The plan half of a passing gate: the token patch, the annotated plan, and the
+ * SVG assets its added-element specs reference. Source hints arrive resolved
+ * because indexing a repository is a host capability, not a policy.
+ */
+export const planImproveAnnotatedArtifacts = (args) => {
+    const tokenPatch = buildImproveTokenPatch(args.entries, args.computed.beforeLeaves, args.computed.targetLeaves);
+    const added = buildImproveAddedElementSpecs({
+        targetDoc: args.targetDoc,
+        normalizedTarget: args.computed.targetLeaves,
+        before: args.computed.beforeLeaves,
+        canvas: args.computed.beforeCanvas,
+        diff: args.computed.result,
+        describePath: args.describePath,
+        ...(args.resolveAsset ? { resolveAsset: args.resolveAsset } : {}),
+    });
+    const index = args.index ?? {
+        assets: [],
+        rasterLayers: improveRasterLayersOfDocument(args.targetDoc),
+        layerDocPresent: true,
+        manifestPresent: false,
+    };
+    return {
+        artifacts: {
+            files: {
+                [IMPROVE_ANNOTATED_PLAN_FILE]: renderImproveAnnotatedPlan({
+                    computed: args.computed,
+                    entries: args.entries,
+                    tokenPatch,
+                    addedSpecs: added.specs,
+                    index,
+                    ...(args.repo ? { repo: args.repo } : {}),
+                    mode: args.mode,
+                }),
+                [IMPROVE_TOKEN_PATCH_FILE]: tokenPatch.css,
+                ...added.files,
+            },
+            remove: [],
+        },
+        tokenPatch,
+        addedSpecs: added.specs,
+    };
+};
+//# sourceMappingURL=improve-plan-annotator.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"improve-plan-annotator.js","sourceRoot":"","sources":["../../src/improve-core/improve-plan-annotator.ts"],"names":[],"mappings":"AAAA,gDAAgD;AAChD,uEAAuE;AAEvE,OAAO,EACL,6BAA6B,GAG9B,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,0BAA0B,GAG3B,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EAAE,sBAAsB,EAA0B,MAAM,0BAA0B,CAAC;AAG1F,OAAO,EACL,6BAA6B,GAE9B,MAAM,8BAA8B,CAAC;AAItC,MAAM,CAAC,MAAM,2BAA2B,GAAG,mBAAmB,CAAC;AAC/D,MAAM,CAAC,MAAM,wBAAwB,GAAG,iBAAiB,CAAC;AAE1D;;;;GAIG;AACH,MAAM,CAAC,MAAM,6BAA6B,GAAG,CAAC,IAc7C,EAIC,EAAE;IACF,MAAM,UAAU,GAAG,sBAAsB,CACvC,IAAI,CAAC,OAAO,EACZ,IAAI,CAAC,QAAQ,CAAC,YAAY,EAC1B,IAAI,CAAC,QAAQ,CAAC,YAAY,CAC3B,CAAC;IACF,MAAM,KAAK,GAAG,6BAA6B,CAAC;QAC1C,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,gBAAgB,EAAE,IAAI,CAAC,QAAQ,CAAC,YAAY;QAC5C,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,YAAY;QAClC,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,YAAY;QAClC,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,MAAM;QAC1B,YAAY,EAAE,IAAI,CAAC,YAAY;QAC/B,GAAG,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,IAAI,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAClE,CAAC,CAAC;IACH,MAAM,KAAK,GAAyB,IAAI,CAAC,KAAK,IAAI;QAChD,MAAM,EAAE,EAAE;QACV,YAAY,EAAE,6BAA6B,CAAC,IAAI,CAAC,SAAS,CAAC;QAC3D,eAAe,EAAE,IAAI;QACrB,eAAe,EAAE,KAAK;KACvB,CAAC;IACF,OAAO;QACL,SAAS,EAAE;YACT,KAAK,EAAE;gBACL,CAAC,2BAA2B,CAAC,EAAE,0BAA0B,CAAC;oBACxD,QAAQ,EAAE,IAAI,CAAC,QAAQ;oBACvB,OAAO,EAAE,IAAI,CAAC,OAAO;oBACrB,UAAU;oBACV,UAAU,EAAE,KAAK,CAAC,KAAK;oBACvB,KAAK;oBACL,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;oBACzC,IAAI,EAAE,IAAI,CAAC,IAAI;iBAChB,CAAC;gBACF,CAAC,wBAAwB,CAAC,EAAE,UAAU,CAAC,GAAG;gBAC1C,GAAG,KAAK,CAAC,KAAK;aACf;YACD,MAAM,EAAE,EAAE;SACX;QACD,UAAU;QACV,UAAU,EAAE,KAAK,CAAC,KAAK;KACxB,CAAC;AACJ,CAAC,CAAC"}

package/dist/{improve-plan-render.d.ts → improve-core/improve-plan-render.d.ts}

@@ -1,4 +1,4 @@
-import type { LayerDelta, LayerDiffResult, LayerLeaf } from './improve-layerdoc-types.js';
+import type { ImproveGate, LayerDelta, LayerDiffResult, LayerLeaf } from './improve-layerdoc-types.js';
 export type RecurringDelta = LayerDelta & {
     kind: string;
     count: number;
@@ -18,6 +18,7 @@ export declare const renderDomChanges: (args: {
     targetPath: string;
     domCoverage: number;
     designCoverage: number;
+    gate?: ImproveGate;
 }) => string;
 export declare const leafPalette: (document: unknown) => string[];
 //# sourceMappingURL=improve-plan-render.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"improve-plan-render.d.ts","sourceRoot":"","sources":["../../src/improve-core/improve-plan-render.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AAQvG,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;IACvB,IAAI,CAAC,EAAE,WAAW,CAAC;CACpB,KAAG,MA8BH,CAAC;AAEF,eAAO,MAAM,WAAW,GAAI,UAAU,OAAO,KAAG,MAAM,EAEpD,CAAC"}

package/dist/{improve-plan-render.js → improve-core/improve-plan-render.js}

@@ -1,4 +1,7 @@
+// GENERATED — do not edit. Copied verbatim from
+// packages/layerdoc/src/improve-core by scripts/sync-improve-core.mjs.
 import { selectorLabel } from './improve-dom-anchor.js';
+import { improveLowOverlapNote } from './improve-dom-gate.js';
 import { flattenLayerDoc } from './improve-layerdoc-diff.js';
 const format = (value) => value === undefined
     ? '∅'
@@ -50,13 +53,16 @@ export const renderLayerChanges = (args) => {
     return `${lines.join('\n')}\n`;
 };
 export const renderDomChanges = (args) => {
+    const lowOverlap = args.gate ? improveLowOverlapNote(args.gate) : undefined;
     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.', '',
+        '- Coordinates were normalized fractionally; non-position lengths use the width ratio.',
+        ...(lowOverlap ? ['', `> ${lowOverlap}`] : []),
+        '',
         '## Matched changes', '',
     ];
     const changed = args.result.matched.filter((entry) => entry.changed);

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

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

package/dist/improve-core/improve-plan-vector-keep.d.ts

@@ -0,0 +1,29 @@
+import { type ImproveRasterLayer } from './improve-kit-asset-model.js';
+import type { DomLeafIdentity } from './improve-layerdoc-types.js';
+export type ImproveVectorKeep = {
+    /** The target layer index the cutout would have replaced. */
+    index: number;
+    kind: string;
+    name: string;
+    /** The label the plan prints for the anchored node. */
+    selector: string;
+    tag: string;
+    /** The asset that stays in the kit as a reference, when one exists. */
+    assetFile?: string;
+    bounds: ImproveRasterLayer['bounds'];
+};
+export declare const isImproveVectorAnchor: (dom: DomLeafIdentity | undefined) => boolean;
+/**
+ * The layers a plan must keep as vectors, given what each one anchors to.
+ * `anchor` supplies the matched live node and `label` renders it consistently
+ * with the rest of the implementation plan.
+ */
+export declare const improveVectorKeeps: (args: {
+    layers: readonly ImproveRasterLayer[];
+    anchor: (layer: ImproveRasterLayer) => DomLeafIdentity | undefined;
+    label: (layer: ImproveRasterLayer) => string | undefined;
+}) => ImproveVectorKeep[];
+export declare const IMPROVE_VECTOR_KEEP_TITLE = "Vector nodes to keep \u2014 do not replace with a raster";
+/** The section that replaces a contradictory raster-carriage instruction. */
+export declare const renderImproveVectorKeeps: (keeps: readonly ImproveVectorKeep[]) => string[];
+//# sourceMappingURL=improve-plan-vector-keep.d.ts.map

package/dist/improve-core/improve-plan-vector-keep.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"improve-plan-vector-keep.d.ts","sourceRoot":"","sources":["../../src/improve-core/improve-plan-vector-keep.ts"],"names":[],"mappings":"AAGA,OAAO,EAAuB,KAAK,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAC5F,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAkBnE,MAAM,MAAM,iBAAiB,GAAG;IAC9B,6DAA6D;IAC7D,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,uDAAuD;IACvD,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,uEAAuE;IACvE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,kBAAkB,CAAC,QAAQ,CAAC,CAAC;CACtC,CAAC;AAEF,eAAO,MAAM,qBAAqB,GAAI,KAAK,eAAe,GAAG,SAAS,KAAG,OAExE,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,GAAI,MAAM;IACvC,MAAM,EAAE,SAAS,kBAAkB,EAAE,CAAC;IACtC,MAAM,EAAE,CAAC,KAAK,EAAE,kBAAkB,KAAK,eAAe,GAAG,SAAS,CAAC;IACnE,KAAK,EAAE,CAAC,KAAK,EAAE,kBAAkB,KAAK,MAAM,GAAG,SAAS,CAAC;CAC1D,KAAG,iBAAiB,EAiBpB,CAAC;AAEF,eAAO,MAAM,yBAAyB,6DAAwD,CAAC;AAE/F,6EAA6E;AAC7E,eAAO,MAAM,wBAAwB,GAAI,OAAO,SAAS,iBAAiB,EAAE,KAAG,MAAM,EAqBpF,CAAC"}

package/dist/improve-core/improve-plan-vector-keep.js

@@ -0,0 +1,68 @@
+// GENERATED — do not edit. Copied verbatim from
+// packages/layerdoc/src/improve-core by scripts/sync-improve-core.mjs.
+import { formatImproveBounds } from './improve-kit-asset-model.js';
+/**
+ * The one module that decides when a plan must NOT swap declared vector
+ * structure for a raster cutout (F37; CLAUDE.md item 8, and the owner rule that
+ * raster-for-structure is a regression, not a fix).
+ *
+ * The DOM extraction records the anchored node's tag and the diff records which
+ * target layer matched it. A structural raster layer on an svg/use/symbol is
+ * therefore an evidence-backed keep, never a guess about the design.
+ */
+/** Elements that ARE vector structure. An `<img>` is a raster slot, not one. */
+const VECTOR_TAGS = new Set(['svg', 'use', 'symbol']);
+/** Layer kinds whose whole job is to be a mark. */
+const STRUCTURAL_KINDS = new Set(['logo', 'icon', 'mark', 'glyph', 'emblem']);
+export const isImproveVectorAnchor = (dom) => (Boolean(dom?.tag && VECTOR_TAGS.has(dom.tag.toLowerCase())));
+/**
+ * The layers a plan must keep as vectors, given what each one anchors to.
+ * `anchor` supplies the matched live node and `label` renders it consistently
+ * with the rest of the implementation plan.
+ */
+export const improveVectorKeeps = (args) => {
+    const keeps = [];
+    for (const layer of args.layers) {
+        if (!STRUCTURAL_KINDS.has(layer.kind.toLowerCase()))
+            continue;
+        const dom = args.anchor(layer);
+        if (!isImproveVectorAnchor(dom))
+            continue;
+        keeps.push({
+            index: layer.index,
+            kind: layer.kind,
+            name: layer.name,
+            selector: args.label(layer) ?? `\`${dom?.selector ?? 'the matched node'}\``,
+            tag: (dom?.tag ?? 'svg').toLowerCase(),
+            ...(layer.asset ? { assetFile: layer.asset.file } : {}),
+            bounds: layer.bounds,
+        });
+    }
+    return keeps;
+};
+export const IMPROVE_VECTOR_KEEP_TITLE = 'Vector nodes to keep — do not replace with a raster';
+/** The section that replaces a contradictory raster-carriage instruction. */
+export const renderImproveVectorKeeps = (keeps) => {
+    if (keeps.length === 0)
+        return [];
+    return [
+        `## ${IMPROVE_VECTOR_KEEP_TITLE}`,
+        '',
+        'The target cuts these as rasters, and the page already draws them as vectors. Keep the'
+            + ' existing element and restyle it — colour, size, stroke, position — to match the target.'
+            + ' Shipping the cutout over a live `<svg>` trades declared structure for pixels, which is a'
+            + ' regression however the target looks.',
+        '',
+        ...keeps.flatMap((keep) => [
+            `- **${keep.kind}** — ${keep.name}`,
+            `  - Keep: ${keep.selector} — the page renders this as \`<${keep.tag}>\`.`,
+            `  - Restyle to: ${formatImproveBounds(keep.bounds)}`,
+            keep.assetFile
+                ? `  - Reference only: \`${keep.assetFile}\` — read it for colour and proportion.`
+                    + ' Do not place it.'
+                : '  - No cutout was extracted for it; the target describes it in the matched changes.',
+        ]),
+        '',
+    ];
+};
+//# sourceMappingURL=improve-plan-vector-keep.js.map

package/dist/improve-core/improve-plan-vector-keep.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"improve-plan-vector-keep.js","sourceRoot":"","sources":["../../src/improve-core/improve-plan-vector-keep.ts"],"names":[],"mappings":"AAAA,gDAAgD;AAChD,uEAAuE;AAEvE,OAAO,EAAE,mBAAmB,EAA2B,MAAM,8BAA8B,CAAC;AAG5F;;;;;;;;GAQG;AAEH,gFAAgF;AAChF,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC;AAEtD,mDAAmD;AACnD,MAAM,gBAAgB,GAAG,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC;AAe9E,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,GAAgC,EAAW,EAAE,CAAC,CAClF,OAAO,CAAC,GAAG,EAAE,GAAG,IAAI,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC,CAC5D,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,IAIlC,EAAuB,EAAE;IACxB,MAAM,KAAK,GAAwB,EAAE,CAAC;IACtC,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;QAChC,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;YAAE,SAAS;QAC9D,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC/B,IAAI,CAAC,qBAAqB,CAAC,GAAG,CAAC;YAAE,SAAS;QAC1C,KAAK,CAAC,IAAI,CAAC;YACT,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,QAAQ,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,EAAE,QAAQ,IAAI,kBAAkB,IAAI;YAC3E,GAAG,EAAE,CAAC,GAAG,EAAE,GAAG,IAAI,KAAK,CAAC,CAAC,WAAW,EAAE;YACtC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACvD,MAAM,EAAE,KAAK,CAAC,MAAM;SACrB,CAAC,CAAC;IACL,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,yBAAyB,GAAG,qDAAqD,CAAC;AAE/F,6EAA6E;AAC7E,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,KAAmC,EAAY,EAAE;IACxF,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAClC,OAAO;QACL,MAAM,yBAAyB,EAAE;QACjC,EAAE;QACF,wFAAwF;cACtF,0FAA0F;cAC1F,2FAA2F;cAC3F,uCAAuC;QACzC,EAAE;QACF,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;YACzB,OAAO,IAAI,CAAC,IAAI,QAAQ,IAAI,CAAC,IAAI,EAAE;YACnC,aAAa,IAAI,CAAC,QAAQ,kCAAkC,IAAI,CAAC,GAAG,MAAM;YAC1E,mBAAmB,mBAAmB,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE;YACrD,IAAI,CAAC,SAAS;gBACZ,CAAC,CAAC,yBAAyB,IAAI,CAAC,SAAS,yCAAyC;sBAChF,mBAAmB;gBACrB,CAAC,CAAC,qFAAqF;SAC1F,CAAC;QACF,EAAE;KACH,CAAC;AACJ,CAAC,CAAC"}

package/dist/{improve-raster-layers-section.d.ts → improve-core/improve-raster-layers-section.d.ts}

@@ -1,4 +1,4 @@
-import { type ImproveRasterLayer } from './improve-kit-assets.js';
+import { type ImproveRasterLayer } from './improve-kit-asset-model.js';
 /**
  * "Raster layers to carry" — the section that has to come first.
  *
@@ -17,5 +17,13 @@ export declare const renderImproveRasterLayers: (args: {
     layers: readonly ImproveRasterLayer[];
     /** Where the layer lands in the page, when the diff anchored it to a selector. */
     placement?: (layer: ImproveRasterLayer) => string | undefined;
+    /**
+     * Target-layer indexes this section must NOT print: they anchor to vector
+     * structure the page already has, and `improve-plan-vector-keep.ts` renders
+     * them as keeps instead (F37). They are filtered here, beside the alternate
+     * backdrop, for the same reason — "never skip one" binds every line this
+     * prints, so a layer the plan does not want carried must not appear under it.
+     */
+    exclude?: ReadonlySet<number>;
 }) => string[];
 //# sourceMappingURL=improve-raster-layers-section.d.ts.map

package/dist/improve-core/improve-raster-layers-section.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"improve-raster-layers-section.d.ts","sourceRoot":"","sources":["../../src/improve-core/improve-raster-layers-section.ts"],"names":[],"mappings":"AAGA,OAAO,EAIL,KAAK,kBAAkB,EACxB,MAAM,8BAA8B,CAAC;AAEtC;;;;;;;;;;;;GAYG;AAEH,eAAO,MAAM,4BAA4B,2BAA2B,CAAC;AAErE,eAAO,MAAM,yBAAyB,GAAI,MAAM;IAC9C,MAAM,EAAE,SAAS,kBAAkB,EAAE,CAAC;IACtC,kFAAkF;IAClF,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,kBAAkB,KAAK,MAAM,GAAG,SAAS,CAAC;IAC9D;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;CAC/B,KAAG,MAAM,EAmCT,CAAC"}

package/dist/{improve-raster-layers-section.js → improve-core/improve-raster-layers-section.js}

@@ -1,4 +1,6 @@
-import { formatImproveBounds, improveCarriedRasterLayers, isImproveAlternateBackdrop, } from './improve-kit-assets.js';
+// GENERATED — do not edit. Copied verbatim from
+// packages/layerdoc/src/improve-core by scripts/sync-improve-core.mjs.
+import { formatImproveBounds, improveCarriedRasterLayers, isImproveAlternateBackdrop, } from './improve-kit-asset-model.js';
 /**
  * "Raster layers to carry" — the section that has to come first.
  *
@@ -21,7 +23,8 @@ export const renderImproveRasterLayers = (args) => {
             + ' Never redraw one of these in CSS, and never skip one.',
         '',
     ];
-    const layers = improveCarriedRasterLayers(args.layers);
+    const layers = improveCarriedRasterLayers(args.layers)
+        .filter((layer) => !args.exclude?.has(layer.index));
     if (layers.length === 0) {
         lines.push('_The target LayerDoc declares no raster layer._', '');
         return lines;

package/dist/improve-core/improve-raster-layers-section.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"improve-raster-layers-section.js","sourceRoot":"","sources":["../../src/improve-core/improve-raster-layers-section.ts"],"names":[],"mappings":"AAAA,gDAAgD;AAChD,uEAAuE;AAEvE,OAAO,EACL,mBAAmB,EACnB,0BAA0B,EAC1B,0BAA0B,GAE3B,MAAM,8BAA8B,CAAC;AAEtC;;;;;;;;;;;;GAYG;AAEH,MAAM,CAAC,MAAM,4BAA4B,GAAG,wBAAwB,CAAC;AAErE,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,IAYzC,EAAY,EAAE;IACb,MAAM,KAAK,GAAG;QACZ,MAAM,4BAA4B,EAAE;QACpC,EAAE;QACF,oEAAoE;cAClE,wDAAwD;QAC1D,EAAE;KACH,CAAC;IACF,MAAM,MAAM,GAAG,0BAA0B,CAAC,IAAI,CAAC,MAAM,CAAC;SACnD,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;IACtD,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxB,KAAK,CAAC,IAAI,CAAC,iDAAiD,EAAE,EAAE,CAAC,CAAC;QAClE,OAAO,KAAK,CAAC;IACf,CAAC;IACD,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC,KAAK,CAAC,CAAC;QAC1C,KAAK,CAAC,IAAI,CACR,OAAO,KAAK,CAAC,IAAI,QAAQ,KAAK,CAAC,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,EAAE,EAAE,EAC3E,KAAK,CAAC,KAAK;YACT,CAAC,CAAC,gBAAgB,KAAK,CAAC,KAAK,CAAC,IAAI,QAAQ,KAAK,CAAC,KAAK,CAAC,SAAS,EAAE;YACjE,CAAC,CAAC,gGAAgG,EACpG,eAAe,mBAAmB,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,EAClD,iBAAiB,SAAS,IAAI,4CAA4C,EAAE,EAC5E,GAAG,CAAC,GAAG,EAAE;YACP,MAAM,UAAU,GAAG,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,0BAA0B,CAAC,KAAK,CAAC,CAAC,CAAC;YAC1F,OAAO,UAAU,CAAC,MAAM,GAAG,CAAC;gBAC1B,CAAC,CAAC,CAAC,uBAAuB,UAAU;yBACjC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,KAAK,CAAC,IAAI,OAAO,KAAK,CAAC,SAAS,GAAG,CAAC;yBACxD,IAAI,CAAC,IAAI,CAAC,yBAAyB,CAAC;gBACvC,CAAC,CAAC,EAAE,CAAC;QACT,CAAC,CAAC,EAAE,CACL,CAAC;IACJ,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,OAAO,KAAK,CAAC;AACf,CAAC,CAAC"}

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

@@ -0,0 +1,6 @@
+export declare class ImproveRefusal extends Error {
+    readonly code: string;
+    constructor(message: string, code: string, options?: ErrorOptions);
+}
+export declare const isImproveRefusal: (error: unknown) => error is ImproveRefusal;
+//# sourceMappingURL=improve-refusal.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"improve-refusal.d.ts","sourceRoot":"","sources":["../../src/improve-core/improve-refusal.ts"],"names":[],"mappings":"AAiBA,qBAAa,cAAe,SAAQ,KAAK;IACvC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;gBAEV,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY;CAQlE;AAED,eAAO,MAAM,gBAAgB,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,cAE1D,CAAC"}

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

@@ -0,0 +1,27 @@
+// GENERATED — do not edit. Copied verbatim from
+// packages/layerdoc/src/improve-core by scripts/sync-improve-core.mjs.
+/**
+ * A refusal is the plan core declining to build an artifact, with nothing
+ * started and nothing bought.
+ *
+ * The core cannot throw the CLI's `CliRefusal` — it has no CLI to depend on,
+ * and the same functions run in the browser — so it throws this instead and
+ * carries the same closed-vocabulary `code`. `packages/12ui` translates it back
+ * into `CliRefusal` at its boundary so the run journal's `error_class` is
+ * unchanged; the web surfaces the message and the code directly.
+ */
+/** Journal `error_class` slugs are lowercase, underscored, and short. */
+const REFUSAL_CODE = /^[a-z][a-z0-9_]{0,63}$/u;
+export class ImproveRefusal extends Error {
+    code;
+    constructor(message, code, options) {
+        super(message, options);
+        this.name = 'ImproveRefusal';
+        if (!REFUSAL_CODE.test(code)) {
+            throw new TypeError(`Invalid refusal code: ${code}`);
+        }
+        this.code = code;
+    }
+}
+export const isImproveRefusal = (error) => (error instanceof ImproveRefusal);
+//# sourceMappingURL=improve-refusal.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"improve-refusal.js","sourceRoot":"","sources":["../../src/improve-core/improve-refusal.ts"],"names":[],"mappings":"AAAA,gDAAgD;AAChD,uEAAuE;AAEvE;;;;;;;;;GASG;AAEH,yEAAyE;AACzE,MAAM,YAAY,GAAG,yBAAyB,CAAC;AAE/C,MAAM,OAAO,cAAe,SAAQ,KAAK;IAC9B,IAAI,CAAS;IAEtB,YAAY,OAAe,EAAE,IAAY,EAAE,OAAsB;QAC/D,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACxB,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;QAC7B,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YAC7B,MAAM,IAAI,SAAS,CAAC,yBAAyB,IAAI,EAAE,CAAC,CAAC;QACvD,CAAC;QACD,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;CACF;AAED,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,KAAc,EAA2B,EAAE,CAAC,CAC3E,KAAK,YAAY,cAAc,CAChC,CAAC"}