sovr-patch 0.2.0

package/dist/patch/preview.js

@@ -0,0 +1,48 @@
+import path from "node:path";
+import { createTwoFilesPatch } from "diff";
+import { detectOverlaps } from "./overlap.js";
+function groupByFile(patches) {
+    const map = new Map();
+    for (const patch of patches) {
+        const list = map.get(patch.filePath) ?? [];
+        list.push(patch);
+        map.set(patch.filePath, list);
+    }
+    return map;
+}
+function applyPatchesToText(original, patches) {
+    const sorted = [...patches].sort((a, b) => b.start - a.start);
+    let next = original;
+    for (const patch of sorted) {
+        next = next.slice(0, patch.start) + patch.after + next.slice(patch.end);
+    }
+    return next;
+}
+export function previewPatchedFiles(loaded, patches) {
+    const previews = new Map();
+    const grouped = groupByFile(patches);
+    for (const [filePath, filePatches] of grouped.entries()) {
+        detectOverlaps(filePatches);
+        const absolute = path.resolve(loaded.repoPath, filePath);
+        const sourceFile = loaded.project.getSourceFile(absolute);
+        if (!sourceFile)
+            throw new Error(`source file not found: ${filePath}`);
+        const before = sourceFile.getFullText();
+        const after = applyPatchesToText(before, filePatches);
+        previews.set(filePath, { before, after });
+    }
+    return previews;
+}
+export function buildDiffFromPreview(previewMap) {
+    const changedFiles = [];
+    let diffText = "";
+    for (const [filePath, preview] of previewMap.entries()) {
+        if (preview.before === preview.after)
+            continue;
+        changedFiles.push(filePath);
+        diffText += createTwoFilesPatch(filePath, filePath, preview.before, preview.after, "before", "after");
+        diffText += "\n";
+    }
+    return { changedFiles, diffText };
+}
+//# sourceMappingURL=preview.js.map

package/dist/patch/preview.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"preview.js","sourceRoot":"","sources":["../../src/patch/preview.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,mBAAmB,EAAE,MAAM,MAAM,CAAC;AAE3C,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAE9C,SAAS,WAAW,CAAC,OAAkB;IACrC,MAAM,GAAG,GAAG,IAAI,GAAG,EAAqB,CAAC;IAEzC,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,MAAM,IAAI,GAAG,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;QAC3C,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACjB,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;IAChC,CAAC;IAED,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,kBAAkB,CAAC,QAAgB,EAAE,OAAkB;IAC9D,MAAM,MAAM,GAAG,CAAC,GAAG,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC;IAC9D,IAAI,IAAI,GAAG,QAAQ,CAAC;IAEpB,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC1E,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,mBAAmB,CACjC,MAAqB,EACrB,OAAkB;IAElB,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAuB,CAAC;IAChD,MAAM,OAAO,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC;IAErC,KAAK,MAAM,CAAC,QAAQ,EAAE,WAAW,CAAC,IAAI,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC;QACxD,cAAc,CAAC,WAAW,CAAC,CAAC;QAE5B,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;QACzD,MAAM,UAAU,GAAG,MAAM,CAAC,OAAO,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;QAC1D,IAAI,CAAC,UAAU;YAAE,MAAM,IAAI,KAAK,CAAC,0BAA0B,QAAQ,EAAE,CAAC,CAAC;QAEvE,MAAM,MAAM,GAAG,UAAU,CAAC,WAAW,EAAE,CAAC;QACxC,MAAM,KAAK,GAAG,kBAAkB,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;QAEtD,QAAQ,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;IAC5C,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,UAAoC;IACvE,MAAM,YAAY,GAAa,EAAE,CAAC;IAClC,IAAI,QAAQ,GAAG,EAAE,CAAC;IAElB,KAAK,MAAM,CAAC,QAAQ,EAAE,OAAO,CAAC,IAAI,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC;QACvD,IAAI,OAAO,CAAC,MAAM,KAAK,OAAO,CAAC,KAAK;YAAE,SAAS;QAE/C,YAAY,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAE5B,QAAQ,IAAI,mBAAmB,CAC7B,QAAQ,EACR,QAAQ,EACR,OAAO,CAAC,MAAM,EACd,OAAO,CAAC,KAAK,EACb,QAAQ,EACR,OAAO,CACR,CAAC;QACF,QAAQ,IAAI,IAAI,CAAC;IACnB,CAAC;IAED,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,CAAC;AACpC,CAAC"}

package/dist/rules/design-token/classify.js

@@ -0,0 +1,16 @@
+/**
+ * Design token classification.
+ *
+ * In run mode (with map): all hits are "safe" — we have a known token mapping.
+ * In audit mode (matchAllHex): mapped hits are "safe", unmapped are "ambiguous".
+ * The severity is already set by locate based on whether a token mapping exists.
+ */
+export function classifyDesignToken(located, _context) {
+    // Severity is pre-set by locate:
+    // - "safe" if tokenName exists (hex-color-mapped)
+    // - "ambiguous" if no token mapping (hex-color-unmapped, audit discovery)
+    return {
+        ...located.hit,
+    };
+}
+//# sourceMappingURL=classify.js.map

package/dist/rules/design-token/classify.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"classify.js","sourceRoot":"","sources":["../../../src/rules/design-token/classify.ts"],"names":[],"mappings":"AAKA;;;;;;GAMG;AACH,MAAM,UAAU,mBAAmB,CACjC,OAAyB,EACzB,QAAwC;IAExC,iCAAiC;IACjC,kDAAkD;IAClD,0EAA0E;IAC1E,OAAO;QACL,GAAG,OAAO,CAAC,GAAG;KACf,CAAC;AACJ,CAAC"}

package/dist/rules/design-token/locate.js

@@ -0,0 +1,113 @@
+import path from "node:path";
+import { SyntaxKind } from "ts-morph";
+function getColumnFromNode(node) {
+    const sourceFile = node.getSourceFile();
+    const lineStarts = sourceFile.compilerNode.getLineStarts();
+    const lineIndex = node.getStartLineNumber() - 1;
+    const lineStart = lineStarts[lineIndex] ?? 0;
+    return node.getStart() - lineStart + 1;
+}
+/**
+ * Normalize a hex color to lowercase 6-digit format.
+ * #FFF → #ffffff
+ * #ff0000 → #ff0000
+ * #FF0000 → #ff0000
+ */
+function normalizeHex(hex) {
+    const clean = hex.toLowerCase().trim();
+    if (/^#[0-9a-f]{3}$/.test(clean)) {
+        // Expand shorthand: #abc → #aabbcc
+        return `#${clean[1]}${clean[1]}${clean[2]}${clean[2]}${clean[3]}${clean[3]}`;
+    }
+    return clean;
+}
+/**
+ * Scan all string literals in source files for hex color values
+ * that match entries in the design token map.
+ *
+ * Matches patterns like:
+ *   "#ff0000"
+ *   '#FF0000'
+ *   `color: #ff0000`  (template literal parts)
+ *   "background-color: #ff0000; color: #00ff00"  (multiple in one string)
+ */
+export function locateDesignToken(context) {
+    const results = [];
+    // Build normalized lookup map (empty in all-hex audit mode)
+    const normalizedMap = new Map();
+    for (const [hex, token] of Object.entries(context.config.map)) {
+        normalizedMap.set(normalizeHex(hex), token);
+    }
+    const matchAllHex = context.config.matchAllHex;
+    for (const sourceFile of context.loaded.sourceFiles) {
+        const filePath = path.relative(context.loaded.repoPath, sourceFile.getFilePath());
+        // Scan StringLiteral nodes
+        const stringNodes = sourceFile.getDescendantsOfKind(SyntaxKind.StringLiteral);
+        for (const node of stringNodes) {
+            const text = node.getLiteralText();
+            scanTextForHexColors(node, text, filePath, normalizedMap, results, context, matchAllHex);
+        }
+        // Scan NoSubstitutionTemplateLiteral nodes
+        const templateNodes = sourceFile.getDescendantsOfKind(SyntaxKind.NoSubstitutionTemplateLiteral);
+        for (const node of templateNodes) {
+            const text = node.getLiteralText();
+            scanTextForHexColors(node, text, filePath, normalizedMap, results, context, matchAllHex);
+        }
+        // Scan TemplateHead, TemplateMiddle, TemplateTail for template literals with expressions
+        for (const kind of [SyntaxKind.TemplateHead, SyntaxKind.TemplateMiddle, SyntaxKind.TemplateTail]) {
+            const nodes = sourceFile.getDescendantsOfKind(kind);
+            for (const node of nodes) {
+                // Template parts have getLiteralText via their specific types
+                const fullText = node.getText();
+                // Strip template delimiters: `...${  or }...${  or }...`
+                const text = fullText.replace(/^[`}]/, "").replace(/[$`]$/, "").replace(/\$\{$/, "");
+                scanTextForHexColors(node, text, filePath, normalizedMap, results, context, matchAllHex);
+            }
+        }
+    }
+    return results;
+}
+function scanTextForHexColors(node, text, filePath, normalizedMap, results, context, matchAllHex) {
+    const hexPattern = /#[0-9a-fA-F]{3,8}\b/g;
+    let match;
+    while ((match = hexPattern.exec(text)) !== null) {
+        const rawHex = match[0];
+        const normalized = normalizeHex(rawHex);
+        // In matchAllHex mode (audit discovery), match everything
+        // In map mode, only match hex values present in the map
+        const token = normalizedMap.get(normalized);
+        if (!matchAllHex && !token)
+            continue;
+        // Determine severity based on mode
+        // - If we have a token mapping → safe (can auto-fix)
+        // - If matchAllHex with no mapping → "unmapped" (discovery hit, no auto-fix)
+        const hasMappedToken = !!token;
+        const severity = hasMappedToken ? "safe" : "ambiguous";
+        const reason = hasMappedToken ? "hex-color-mapped" : "hex-color-unmapped";
+        const nodeText = node.getText();
+        const nodeStart = node.getStart();
+        const quoteOffset = nodeText.indexOf(text);
+        const hexOffsetInNode = quoteOffset + match.index;
+        results.push({
+            node,
+            hit: {
+                filePath,
+                line: node.getStartLineNumber(),
+                column: getColumnFromNode(node),
+                sourceText: rawHex,
+                severity,
+                reason,
+                start: nodeStart + hexOffsetInNode,
+                end: nodeStart + hexOffsetInNode + rawHex.length,
+                metadata: {
+                    kind: "hex-to-token",
+                    rawHex,
+                    normalizedHex: normalized,
+                    tokenName: token ?? null,
+                    fullNodeText: nodeText,
+                },
+            },
+        });
+    }
+}
+//# sourceMappingURL=locate.js.map

package/dist/rules/design-token/locate.js.map

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

package/dist/rules/design-token/presets.js

@@ -0,0 +1,53 @@
+/**
+ * Design Token Presets
+ *
+ * Presets provide predefined hex → token mappings for common design systems.
+ * Used in audit mode to give meaningful results without user-provided maps.
+ */
+/**
+ * sovr-core preset — common UI colors used in the SOVR design system
+ */
+const SOVR_CORE = {
+    name: "sovr-core",
+    description: "SOVR design system core color tokens",
+    map: {
+        "#00ff94": "--sovr-primary",
+        "#ff0000": "--sovr-danger",
+        "#ff4444": "--sovr-danger-light",
+        "#00ff00": "--sovr-success",
+        "#0066cc": "--sovr-info",
+        "#ffaa00": "--sovr-warning",
+        "#ffffff": "--sovr-white",
+        "#000000": "--sovr-black",
+        "#333333": "--sovr-text",
+        "#666666": "--sovr-text-muted",
+        "#999999": "--sovr-text-subtle",
+        "#f5f5f5": "--sovr-bg-light",
+        "#e0e0e0": "--sovr-border",
+        "#1a1a1a": "--sovr-bg-dark",
+        "#2d2d2d": "--sovr-surface",
+    },
+};
+/**
+ * all-hex preset — matches ANY hex color found in the codebase.
+ * Used in audit mode to discover the full scope of hardcoded colors.
+ * Does not provide token names (uses placeholder).
+ */
+const ALL_HEX = {
+    name: "all-hex",
+    description: "Match all hex colors (audit discovery mode)",
+    map: {}, // Empty map signals "match everything" in audit mode
+};
+export const PRESETS = {
+    "sovr-core": SOVR_CORE,
+    "all-hex": ALL_HEX,
+};
+export function getPresetOrThrow(name) {
+    const preset = PRESETS[name];
+    if (!preset) {
+        const available = Object.keys(PRESETS).join(", ");
+        throw new Error(`design-token: unknown preset "${name}". Available: ${available}`);
+    }
+    return preset;
+}
+//# sourceMappingURL=presets.js.map

package/dist/rules/design-token/presets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"presets.js","sourceRoot":"","sources":["../../../src/rules/design-token/presets.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAQH;;GAEG;AACH,MAAM,SAAS,GAAsB;IACnC,IAAI,EAAE,WAAW;IACjB,WAAW,EAAE,sCAAsC;IACnD,GAAG,EAAE;QACH,SAAS,EAAE,gBAAgB;QAC3B,SAAS,EAAE,eAAe;QAC1B,SAAS,EAAE,qBAAqB;QAChC,SAAS,EAAE,gBAAgB;QAC3B,SAAS,EAAE,aAAa;QACxB,SAAS,EAAE,gBAAgB;QAC3B,SAAS,EAAE,cAAc;QACzB,SAAS,EAAE,cAAc;QACzB,SAAS,EAAE,aAAa;QACxB,SAAS,EAAE,mBAAmB;QAC9B,SAAS,EAAE,oBAAoB;QAC/B,SAAS,EAAE,iBAAiB;QAC5B,SAAS,EAAE,eAAe;QAC1B,SAAS,EAAE,gBAAgB;QAC3B,SAAS,EAAE,gBAAgB;KAC5B;CACF,CAAC;AAEF;;;;GAIG;AACH,MAAM,OAAO,GAAsB;IACjC,IAAI,EAAE,SAAS;IACf,WAAW,EAAE,6CAA6C;IAC1D,GAAG,EAAE,EAAE,EAAE,qDAAqD;CAC/D,CAAC;AAEF,MAAM,CAAC,MAAM,OAAO,GAAsC;IACxD,WAAW,EAAE,SAAS;IACtB,SAAS,EAAE,OAAO;CACnB,CAAC;AAEF,MAAM,UAAU,gBAAgB,CAAC,IAAY;IAC3C,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7B,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAClD,MAAM,IAAI,KAAK,CACb,iCAAiC,IAAI,iBAAiB,SAAS,EAAE,CAClE,CAAC;IACJ,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/rules/design-token/rule.js

@@ -0,0 +1,13 @@
+import { parseDesignTokenConfig } from "./schema.js";
+import { locateDesignToken } from "./locate.js";
+import { classifyDesignToken } from "./classify.js";
+import { transformDesignToken } from "./transform.js";
+export const designTokenRule = {
+    name: "design-token",
+    description: "Replace hardcoded hex color values with CSS custom property references (design tokens).",
+    parseConfig: parseDesignTokenConfig,
+    locate: locateDesignToken,
+    classify: classifyDesignToken,
+    transform: transformDesignToken,
+};
+//# sourceMappingURL=rule.js.map

package/dist/rules/design-token/rule.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rule.js","sourceRoot":"","sources":["../../../src/rules/design-token/rule.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAEtD,MAAM,CAAC,MAAM,eAAe,GAAsC;IAChE,IAAI,EAAE,cAAc;IACpB,WAAW,EACT,yFAAyF;IAC3F,WAAW,EAAE,sBAAsB;IACnC,MAAM,EAAE,iBAAiB;IACzB,QAAQ,EAAE,mBAAmB;IAC7B,SAAS,EAAE,oBAAoB;CAChC,CAAC"}

package/dist/rules/design-token/schema.js

@@ -0,0 +1,84 @@
+/**
+ * Design Token Migration Rule — Dual Mode Schema
+ *
+ * RUN mode:  Requires --map (strict, produces patches)
+ * AUDIT mode: Zero-config (scans all hex colors), optional --preset for known tokens
+ *
+ * Example (run):
+ *   sovr-patch run --rule design-token --map "#ff0000:--danger,#00ff00:--success" --repo ./web
+ *
+ * Example (audit):
+ *   sovr-patch audit --rule design-token --repo ./web
+ *   sovr-patch audit --rule design-token --preset sovr-core --repo ./web
+ */
+import { getPresetOrThrow } from "./presets.js";
+/**
+ * Parse CLI map string format: "#ff0000:--danger,#00ff00:--success"
+ */
+function parseMapString(mapStr) {
+    const map = {};
+    for (const pair of mapStr.split(",")) {
+        const [hex, token] = pair.split(":").map((s) => s.trim());
+        if (!hex || !token) {
+            throw new Error(`design-token: invalid map entry "${pair}". Expected "hex:token".`);
+        }
+        map[hex.toLowerCase()] = token;
+    }
+    return map;
+}
+/**
+ * Parse config input into DesignTokenConfig.
+ *
+ * Behavior depends on mode:
+ * - mode="run" (default for run command): map is REQUIRED
+ * - mode="audit" (default for audit command): map is optional, defaults to all-hex scan
+ */
+export function parseDesignTokenConfig(input) {
+    const mode = input.mode === "audit" ? "audit" : "run";
+    // Handle preset
+    const presetName = input.preset;
+    let presetMap = {};
+    if (presetName) {
+        const preset = getPresetOrThrow(presetName);
+        presetMap = { ...preset.map };
+    }
+    // Handle explicit map
+    let explicitMap = {};
+    const mapRaw = input.map;
+    if (mapRaw && typeof mapRaw === "object") {
+        for (const [key, value] of Object.entries(mapRaw)) {
+            explicitMap[key.toLowerCase()] = String(value);
+        }
+    }
+    else if (mapRaw) {
+        const mapStr = String(mapRaw).trim();
+        if (mapStr) {
+            explicitMap = parseMapString(mapStr);
+        }
+    }
+    // Merge preset + explicit map (explicit wins)
+    const mergedMap = { ...presetMap, ...explicitMap };
+    if (mode === "run") {
+        // Run mode: map is required
+        if (Object.keys(mergedMap).length === 0) {
+            throw new Error(`design-token: "map" is required in run mode. Provide as --map "#ff0000:--danger,#00ff00:--success" or use --preset sovr-core`);
+        }
+        return {
+            mode: "run",
+            map: mergedMap,
+            matchAllHex: false,
+            preset: presetName,
+        };
+    }
+    // Audit mode: zero-config is OK
+    // If no map and no preset, or preset is "all-hex", scan everything
+    const isAllHex = presetName === "all-hex" ||
+        (Object.keys(mergedMap).length === 0 && !presetName);
+    return {
+        mode: "audit",
+        map: mergedMap,
+        matchAllHex: isAllHex,
+        preset: presetName ?? (isAllHex ? "all-hex" : undefined),
+    };
+}
+//# sourceMappingURL=schema.js.map

package/dist/rules/design-token/schema.js.map

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

package/dist/rules/design-token/transform.js

@@ -0,0 +1,27 @@
+/**
+ * Transform a hex color hit into a design token reference.
+ *
+ * The hit's start/end point directly to the hex value within the string literal,
+ * so we just replace the hex with var(--token-name).
+ *
+ * Examples:
+ *   "#ff0000" → "var(--sovr-danger)"
+ *   "color: #ff0000" → "color: var(--sovr-danger)"
+ */
+export function transformDesignToken(hit, context) {
+    const tokenName = String(hit.metadata?.tokenName ?? "");
+    if (!tokenName) {
+        return null;
+    }
+    const replacement = `var(${tokenName})`;
+    return {
+        filePath: hit.filePath,
+        start: hit.start,
+        end: hit.end,
+        before: hit.sourceText,
+        after: replacement,
+        ruleName: "design-token",
+        reason: "hex-to-token",
+    };
+}
+//# sourceMappingURL=transform.js.map

package/dist/rules/design-token/transform.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transform.js","sourceRoot":"","sources":["../../../src/rules/design-token/transform.ts"],"names":[],"mappings":"AAIA;;;;;;;;;GASG;AACH,MAAM,UAAU,oBAAoB,CAClC,GAAgB,EAChB,OAAuC;IAEvC,MAAM,SAAS,GAAG,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,SAAS,IAAI,EAAE,CAAC,CAAC;IAExD,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,WAAW,GAAG,OAAO,SAAS,GAAG,CAAC;IAExC,OAAO;QACL,QAAQ,EAAE,GAAG,CAAC,QAAQ;QACtB,KAAK,EAAE,GAAG,CAAC,KAAK;QAChB,GAAG,EAAE,GAAG,CAAC,GAAG;QACZ,MAAM,EAAE,GAAG,CAAC,UAAU;QACtB,KAAK,EAAE,WAAW;QAClB,QAAQ,EAAE,cAAc;QACxB,MAAM,EAAE,cAAc;KACvB,CAAC;AACJ,CAAC"}

package/dist/rules/field-rename/classify.js

@@ -0,0 +1,77 @@
+import { Node } from "ts-morph";
+// ─── Context detectors ──────────────────────────────────────────
+function isDeleteContext(node) {
+    const parent = node.getParent();
+    return parent != null && Node.isDeleteExpression(parent);
+}
+function isAssignmentLhs(node) {
+    const parent = node.getParent();
+    if (!parent || !Node.isBinaryExpression(parent))
+        return false;
+    const operator = parent.getOperatorToken().getText();
+    if (operator !== "=")
+        return false;
+    return parent.getLeft() === node;
+}
+function isComputedLikeContext(node) {
+    const parent = node.getParent();
+    if (!parent)
+        return false;
+    if (Node.isElementAccessExpression(parent))
+        return true;
+    if (Node.isComputedPropertyName(parent))
+        return true;
+    return false;
+}
+function isDestructureContext(node) {
+    let current = node;
+    while (current) {
+        if (Node.isBindingElement(current))
+            return true;
+        if (Node.isObjectBindingPattern(current))
+            return true;
+        current = current.getParent();
+    }
+    return false;
+}
+function nodeHasOptionalChain(node) {
+    let current = node;
+    while (Node.isPropertyAccessExpression(current)) {
+        if (current.hasQuestionDotToken()) {
+            return true;
+        }
+        current = current.getExpression();
+    }
+    return false;
+}
+// ─── Classify ───────────────────────────────────────────────────
+export function classifyFieldRename(located, _context) {
+    const node = located.node;
+    const hit = { ...located.hit };
+    const kind = String(hit.metadata?.kind ?? "");
+    // Property keys, type fields, and shorthand are already classified in locate
+    if (kind === "property-key" || kind === "type-field" || kind === "shorthand") {
+        return hit;
+    }
+    // Value references need additional classification
+    if (kind === "value-ref") {
+        if (isDeleteContext(node)) {
+            return { ...hit, severity: "unsafe", reason: "delete-expression" };
+        }
+        if (isAssignmentLhs(node)) {
+            return { ...hit, severity: "unsafe", reason: "assignment-left-hand-side" };
+        }
+        if (isComputedLikeContext(node)) {
+            return { ...hit, severity: "ambiguous", reason: "computed-or-element-access-context" };
+        }
+        if (isDestructureContext(node)) {
+            return { ...hit, severity: "ambiguous", reason: "destructuring-context" };
+        }
+        if (Node.isPropertyAccessExpression(node) && nodeHasOptionalChain(node)) {
+            return { ...hit, severity: "safe", reason: "optional-chain-access" };
+        }
+        return { ...hit, severity: "safe", reason: "direct-property-access" };
+    }
+    return hit;
+}
+//# sourceMappingURL=classify.js.map

package/dist/rules/field-rename/classify.js.map

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