sovr-patch 0.2.0

package/dist/rules/inline-style/locate.js

@@ -0,0 +1,163 @@
+import path from "node:path";
+import { Node, SyntaxKind } from "ts-morph";
+/**
+ * Locate JSX `style={{ ... }}` attributes that contain properties
+ * matching the configured mappings.
+ *
+ * For each matching property-value pair in a style object, we create a hit.
+ * The hit covers the entire JsxAttribute node (style={{ ... }}) so that
+ * transform can decide whether to replace the whole attribute or just parts.
+ */
+export function locateInlineStyle(context) {
+    const results = [];
+    for (const sourceFile of context.loaded.sourceFiles) {
+        const filePath = path.relative(context.loaded.repoPath, sourceFile.getFilePath());
+        // Only scan TSX/JSX files
+        if (!filePath.endsWith(".tsx") && !filePath.endsWith(".jsx"))
+            continue;
+        // Find all JsxAttribute nodes named "style"
+        const jsxAttributes = sourceFile.getDescendantsOfKind(SyntaxKind.JsxAttribute);
+        for (const attr of jsxAttributes) {
+            const name = attr.getNameNode().getText();
+            if (name !== "style")
+                continue;
+            const initializer = attr.getInitializer();
+            if (!initializer)
+                continue;
+            // style={...} → the initializer is a JsxExpression
+            if (!Node.isJsxExpression(initializer))
+                continue;
+            const expression = initializer.getExpression();
+            if (!expression)
+                continue;
+            // style={{ ... }} → the expression is an ObjectLiteralExpression
+            if (!Node.isObjectLiteralExpression(expression))
+                continue;
+            const properties = expression.getProperties();
+            const matchAllStyles = context.config.matchAllStyles;
+            // In matchAllStyles mode (audit discovery), report ALL style attrs
+            // In map mode, only report style attrs with matching properties
+            const matchedMappings = [];
+            // Collect all literal properties for discovery
+            const allLiteralProps = [];
+            for (const prop of properties) {
+                if (!Node.isPropertyAssignment(prop))
+                    continue;
+                const propName = prop.getNameNode().getText();
+                const propInit = prop.getInitializer();
+                if (!propInit)
+                    continue;
+                let propValue;
+                if (Node.isStringLiteral(propInit)) {
+                    propValue = propInit.getLiteralText();
+                }
+                else if (Node.isNumericLiteral(propInit)) {
+                    propValue = propInit.getText();
+                }
+                else {
+                    // Skip non-literal values (expressions, variables, etc.)
+                    continue;
+                }
+                allLiteralProps.push({ propertyNode: prop, propertyName: propName, propertyValue: propValue });
+                // Check against mappings
+                let matched = false;
+                for (const mapping of context.config.mappings) {
+                    if (mapping.property === propName &&
+                        mapping.value.toLowerCase() === propValue.toLowerCase()) {
+                        matchedMappings.push({
+                            mapping,
+                            propertyNode: prop,
+                            propertyName: propName,
+                            propertyValue: propValue,
+                        });
+                        matched = true;
+                        break;
+                    }
+                }
+                // In matchAllStyles mode, add unmapped properties too
+                if (!matched && matchAllStyles) {
+                    matchedMappings.push({
+                        mapping: null,
+                        propertyNode: prop,
+                        propertyName: propName,
+                        propertyValue: propValue,
+                    });
+                }
+            }
+            // In map mode, skip if nothing matched
+            if (!matchAllStyles && matchedMappings.length === 0)
+                continue;
+            // In discovery mode, skip if no literal properties at all
+            if (matchAllStyles && allLiteralProps.length === 0)
+                continue;
+            const totalProperties = properties.length;
+            const mappedCount = matchedMappings.filter((m) => m.mapping !== null).length;
+            const allMatched = mappedCount === totalProperties;
+            // Determine severity
+            // - matchAllStyles with no mappings → ambiguous (discovery)
+            // - all properties mapped → safe
+            // - some properties mapped → ambiguous
+            let severity;
+            let reason;
+            if (matchAllStyles && mappedCount === 0) {
+                severity = "ambiguous";
+                reason = "inline-style-discovered";
+            }
+            else if (allMatched) {
+                severity = "safe";
+                reason = "inline-style-all-mapped";
+            }
+            else {
+                severity = "ambiguous";
+                reason = "inline-style-partial-mapped";
+            }
+            // Create a single hit for the entire style attribute
+            const attrStart = attr.getStart();
+            const attrEnd = attr.getEnd();
+            const lineStarts = sourceFile.compilerNode.getLineStarts();
+            const lineIndex = attr.getStartLineNumber() - 1;
+            const lineStart = lineStarts[lineIndex] ?? 0;
+            const column = attrStart - lineStart + 1;
+            results.push({
+                node: attr,
+                hit: {
+                    filePath,
+                    line: attr.getStartLineNumber(),
+                    column,
+                    sourceText: attr.getText(),
+                    severity,
+                    reason,
+                    start: attrStart,
+                    end: attrEnd,
+                    metadata: {
+                        kind: "inline-style",
+                        allMatched,
+                        totalProperties,
+                        matchedCount: mappedCount,
+                        classNames: matchedMappings
+                            .filter((m) => m.mapping !== null)
+                            .map((m) => m.mapping.className),
+                        matchedProperties: matchedMappings
+                            .filter((m) => m.mapping !== null)
+                            .map((m) => ({
+                            property: m.propertyName,
+                            value: m.propertyValue,
+                            className: m.mapping.className,
+                        })),
+                        discoveredProperties: matchAllStyles
+                            ? allLiteralProps.map((p) => ({
+                                property: p.propertyName,
+                                value: p.propertyValue,
+                            }))
+                            : undefined,
+                        unmatchedProperties: properties
+                            .filter((p) => !matchedMappings.some((m) => m.propertyNode === p))
+                            .map((p) => p.getText()),
+                    },
+                },
+            });
+        }
+    }
+    return results;
+}
+//# sourceMappingURL=locate.js.map

package/dist/rules/inline-style/locate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"locate.js","sourceRoot":"","sources":["../../../src/rules/inline-style/locate.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAI5C;;;;;;;GAOG;AACH,MAAM,UAAU,iBAAiB,CAC/B,OAAuC;IAEvC,MAAM,OAAO,GAAuB,EAAE,CAAC;IAEvC,KAAK,MAAM,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC;QACpD,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,EAAE,UAAU,CAAC,WAAW,EAAE,CAAC,CAAC;QAElF,0BAA0B;QAC1B,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC;YAAE,SAAS;QAEvE,4CAA4C;QAC5C,MAAM,aAAa,GAAG,UAAU,CAAC,oBAAoB,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC;QAE/E,KAAK,MAAM,IAAI,IAAI,aAAa,EAAE,CAAC;YACjC,MAAM,IAAI,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC,OAAO,EAAE,CAAC;YAC1C,IAAI,IAAI,KAAK,OAAO;gBAAE,SAAS;YAE/B,MAAM,WAAW,GAAG,IAAI,CAAC,cAAc,EAAE,CAAC;YAC1C,IAAI,CAAC,WAAW;gBAAE,SAAS;YAE3B,mDAAmD;YACnD,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,WAAW,CAAC;gBAAE,SAAS;YAEjD,MAAM,UAAU,GAAG,WAAW,CAAC,aAAa,EAAE,CAAC;YAC/C,IAAI,CAAC,UAAU;gBAAE,SAAS;YAE1B,iEAAiE;YACjE,IAAI,CAAC,IAAI,CAAC,yBAAyB,CAAC,UAAU,CAAC;gBAAE,SAAS;YAE1D,MAAM,UAAU,GAAG,UAAU,CAAC,aAAa,EAAE,CAAC;YAC9C,MAAM,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,cAAc,CAAC;YAErD,mEAAmE;YACnE,gEAAgE;YAChE,MAAM,eAAe,GAKhB,EAAE,CAAC;YAER,+CAA+C;YAC/C,MAAM,eAAe,GAIhB,EAAE,CAAC;YAER,KAAK,MAAM,IAAI,IAAI,UAAU,EAAE,CAAC;gBAC9B,IAAI,CAAC,IAAI,CAAC,oBAAoB,CAAC,IAAI,CAAC;oBAAE,SAAS;gBAE/C,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC,OAAO,EAAE,CAAC;gBAC9C,MAAM,QAAQ,GAAG,IAAI,CAAC,cAAc,EAAE,CAAC;gBACvC,IAAI,CAAC,QAAQ;oBAAE,SAAS;gBAExB,IAAI,SAAiB,CAAC;gBACtB,IAAI,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,EAAE,CAAC;oBACnC,SAAS,GAAG,QAAQ,CAAC,cAAc,EAAE,CAAC;gBACxC,CAAC;qBAAM,IAAI,IAAI,CAAC,gBAAgB,CAAC,QAAQ,CAAC,EAAE,CAAC;oBAC3C,SAAS,GAAG,QAAQ,CAAC,OAAO,EAAE,CAAC;gBACjC,CAAC;qBAAM,CAAC;oBACN,yDAAyD;oBACzD,SAAS;gBACX,CAAC;gBAED,eAAe,CAAC,IAAI,CAAC,EAAE,YAAY,EAAE,IAAI,EAAE,YAAY,EAAE,QAAQ,EAAE,aAAa,EAAE,SAAS,EAAE,CAAC,CAAC;gBAE/F,yBAAyB;gBACzB,IAAI,OAAO,GAAG,KAAK,CAAC;gBACpB,KAAK,MAAM,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;oBAC9C,IACE,OAAO,CAAC,QAAQ,KAAK,QAAQ;wBAC7B,OAAO,CAAC,KAAK,CAAC,WAAW,EAAE,KAAK,SAAS,CAAC,WAAW,EAAE,EACvD,CAAC;wBACD,eAAe,CAAC,IAAI,CAAC;4BACnB,OAAO;4BACP,YAAY,EAAE,IAAI;4BAClB,YAAY,EAAE,QAAQ;4BACtB,aAAa,EAAE,SAAS;yBACzB,CAAC,CAAC;wBACH,OAAO,GAAG,IAAI,CAAC;wBACf,MAAM;oBACR,CAAC;gBACH,CAAC;gBAED,sDAAsD;gBACtD,IAAI,CAAC,OAAO,IAAI,cAAc,EAAE,CAAC;oBAC/B,eAAe,CAAC,IAAI,CAAC;wBACnB,OAAO,EAAE,IAAI;wBACb,YAAY,EAAE,IAAI;wBAClB,YAAY,EAAE,QAAQ;wBACtB,aAAa,EAAE,SAAS;qBACzB,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;YAED,uCAAuC;YACvC,IAAI,CAAC,cAAc,IAAI,eAAe,CAAC,MAAM,KAAK,CAAC;gBAAE,SAAS;YAC9D,0DAA0D;YAC1D,IAAI,cAAc,IAAI,eAAe,CAAC,MAAM,KAAK,CAAC;gBAAE,SAAS;YAE7D,MAAM,eAAe,GAAG,UAAU,CAAC,MAAM,CAAC;YAC1C,MAAM,WAAW,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,KAAK,IAAI,CAAC,CAAC,MAAM,CAAC;YAC7E,MAAM,UAAU,GAAG,WAAW,KAAK,eAAe,CAAC;YAEnD,qBAAqB;YACrB,4DAA4D;YAC5D,iCAAiC;YACjC,uCAAuC;YACvC,IAAI,QAA8B,CAAC;YACnC,IAAI,MAAc,CAAC;YACnB,IAAI,cAAc,IAAI,WAAW,KAAK,CAAC,EAAE,CAAC;gBACxC,QAAQ,GAAG,WAAW,CAAC;gBACvB,MAAM,GAAG,yBAAyB,CAAC;YACrC,CAAC;iBAAM,IAAI,UAAU,EAAE,CAAC;gBACtB,QAAQ,GAAG,MAAM,CAAC;gBAClB,MAAM,GAAG,yBAAyB,CAAC;YACrC,CAAC;iBAAM,CAAC;gBACN,QAAQ,GAAG,WAAW,CAAC;gBACvB,MAAM,GAAG,6BAA6B,CAAC;YACzC,CAAC;YAED,qDAAqD;YACrD,MAAM,SAAS,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;YAClC,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;YAC9B,MAAM,UAAU,GAAG,UAAU,CAAC,YAAY,CAAC,aAAa,EAAE,CAAC;YAC3D,MAAM,SAAS,GAAG,IAAI,CAAC,kBAAkB,EAAE,GAAG,CAAC,CAAC;YAChD,MAAM,SAAS,GAAG,UAAU,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;YAC7C,MAAM,MAAM,GAAG,SAAS,GAAG,SAAS,GAAG,CAAC,CAAC;YAEzC,OAAO,CAAC,IAAI,CAAC;gBACX,IAAI,EAAE,IAAI;gBACV,GAAG,EAAE;oBACH,QAAQ;oBACR,IAAI,EAAE,IAAI,CAAC,kBAAkB,EAAE;oBAC/B,MAAM;oBACN,UAAU,EAAE,IAAI,CAAC,OAAO,EAAE;oBAC1B,QAAQ;oBACR,MAAM;oBACN,KAAK,EAAE,SAAS;oBAChB,GAAG,EAAE,OAAO;oBACZ,QAAQ,EAAE;wBACR,IAAI,EAAE,cAAc;wBACpB,UAAU;wBACV,eAAe;wBACf,YAAY,EAAE,WAAW;wBACzB,UAAU,EAAE,eAAe;6BACxB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,KAAK,IAAI,CAAC;6BACjC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAQ,CAAC,SAAS,CAAC;wBACnC,iBAAiB,EAAE,eAAe;6BAC/B,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,KAAK,IAAI,CAAC;6BACjC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;4BACX,QAAQ,EAAE,CAAC,CAAC,YAAY;4BACxB,KAAK,EAAE,CAAC,CAAC,aAAa;4BACtB,SAAS,EAAE,CAAC,CAAC,OAAQ,CAAC,SAAS;yBAChC,CAAC,CAAC;wBACL,oBAAoB,EAAE,cAAc;4BAClC,CAAC,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gCAC1B,QAAQ,EAAE,CAAC,CAAC,YAAY;gCACxB,KAAK,EAAE,CAAC,CAAC,aAAa;6BACvB,CAAC,CAAC;4BACL,CAAC,CAAC,SAAS;wBACb,mBAAmB,EAAE,UAAU;6BAC5B,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC;6BACjE,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;qBAC3B;iBACF;aACF,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/rules/inline-style/presets.js

@@ -0,0 +1,71 @@
+/**
+ * Inline Style Presets
+ *
+ * Presets provide predefined style → className mappings for common frameworks.
+ * Used in audit mode to give meaningful results without user-provided maps.
+ */
+/**
+ * tailwind-common preset — most frequently used Tailwind CSS utility classes
+ */
+const TAILWIND_COMMON = {
+    name: "tailwind-common",
+    description: "Common Tailwind CSS utility class mappings",
+    mappings: [
+        // Colors
+        { property: "color", value: "red", className: "text-red-500" },
+        { property: "color", value: "blue", className: "text-blue-500" },
+        { property: "color", value: "green", className: "text-green-500" },
+        { property: "color", value: "white", className: "text-white" },
+        { property: "color", value: "black", className: "text-black" },
+        { property: "color", value: "gray", className: "text-gray-500" },
+        { property: "color", value: "yellow", className: "text-yellow-500" },
+        // Background colors
+        { property: "backgroundColor", value: "red", className: "bg-red-500" },
+        { property: "backgroundColor", value: "blue", className: "bg-blue-500" },
+        { property: "backgroundColor", value: "green", className: "bg-green-500" },
+        { property: "backgroundColor", value: "white", className: "bg-white" },
+        { property: "backgroundColor", value: "black", className: "bg-black" },
+        { property: "backgroundColor", value: "gray", className: "bg-gray-500" },
+        // Display
+        { property: "display", value: "flex", className: "flex" },
+        { property: "display", value: "grid", className: "grid" },
+        { property: "display", value: "block", className: "block" },
+        { property: "display", value: "inline", className: "inline" },
+        { property: "display", value: "none", className: "hidden" },
+        { property: "display", value: "inline-block", className: "inline-block" },
+        // Font
+        { property: "fontWeight", value: "bold", className: "font-bold" },
+        { property: "fontWeight", value: "normal", className: "font-normal" },
+        { property: "fontStyle", value: "italic", className: "italic" },
+        // Text
+        { property: "textAlign", value: "center", className: "text-center" },
+        { property: "textAlign", value: "left", className: "text-left" },
+        { property: "textAlign", value: "right", className: "text-right" },
+        { property: "textDecoration", value: "underline", className: "underline" },
+        { property: "textDecoration", value: "none", className: "no-underline" },
+        // Position
+        { property: "position", value: "relative", className: "relative" },
+        { property: "position", value: "absolute", className: "absolute" },
+        { property: "position", value: "fixed", className: "fixed" },
+        { property: "position", value: "sticky", className: "sticky" },
+        // Overflow
+        { property: "overflow", value: "hidden", className: "overflow-hidden" },
+        { property: "overflow", value: "auto", className: "overflow-auto" },
+        { property: "overflow", value: "scroll", className: "overflow-scroll" },
+        // Cursor
+        { property: "cursor", value: "pointer", className: "cursor-pointer" },
+        { property: "cursor", value: "default", className: "cursor-default" },
+    ],
+};
+export const INLINE_STYLE_PRESETS = {
+    "tailwind-common": TAILWIND_COMMON,
+};
+export function getInlineStylePresetOrThrow(name) {
+    const preset = INLINE_STYLE_PRESETS[name];
+    if (!preset) {
+        const available = Object.keys(INLINE_STYLE_PRESETS).join(", ");
+        throw new Error(`inline-style: unknown preset "${name}". Available: ${available}`);
+    }
+    return preset;
+}
+//# sourceMappingURL=presets.js.map

package/dist/rules/inline-style/presets.js.map

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

package/dist/rules/inline-style/rule.js

@@ -0,0 +1,13 @@
+import { parseInlineStyleConfig } from "./schema.js";
+import { locateInlineStyle } from "./locate.js";
+import { classifyInlineStyle } from "./classify.js";
+import { transformInlineStyle } from "./transform.js";
+export const inlineStyleRule = {
+    name: "inline-style",
+    description: "Replace React inline style={{ ... }} attributes with className equivalents (e.g., Tailwind classes).",
+    parseConfig: parseInlineStyleConfig,
+    locate: locateInlineStyle,
+    classify: classifyInlineStyle,
+    transform: transformInlineStyle,
+};
+//# sourceMappingURL=rule.js.map

package/dist/rules/inline-style/rule.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rule.js","sourceRoot":"","sources":["../../../src/rules/inline-style/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,sGAAsG;IACxG,WAAW,EAAE,sBAAsB;IACnC,MAAM,EAAE,iBAAiB;IACzB,QAAQ,EAAE,mBAAmB;IAC7B,SAAS,EAAE,oBAAoB;CAChC,CAAC"}

package/dist/rules/inline-style/schema.js

@@ -0,0 +1,97 @@
+/**
+ * Inline Style to ClassName Rule — Dual Mode Schema
+ *
+ * RUN mode:  Requires --map (strict, produces patches)
+ * AUDIT mode: Zero-config (scans all style={{}} attributes), optional --preset
+ *
+ * Example (run):
+ *   sovr-patch run --rule inline-style --map "color:red=text-red" --repo ./web
+ *
+ * Example (audit):
+ *   sovr-patch audit --rule inline-style --repo ./web
+ *   sovr-patch audit --rule inline-style --preset tailwind-common --repo ./web
+ */
+import { getInlineStylePresetOrThrow } from "./presets.js";
+/**
+ * Parse CLI --map format: "property:value=className,..."
+ */
+function parseMapString(mapStr) {
+    const mappings = [];
+    for (const entry of mapStr.split(",")) {
+        const trimmed = entry.trim();
+        if (!trimmed)
+            continue;
+        const eqIdx = trimmed.indexOf("=");
+        if (eqIdx === -1) {
+            throw new Error(`inline-style: invalid map entry "${trimmed}". Expected "property:value=className".`);
+        }
+        const left = trimmed.slice(0, eqIdx);
+        const className = trimmed.slice(eqIdx + 1).trim();
+        const colonIdx = left.indexOf(":");
+        if (colonIdx === -1) {
+            throw new Error(`inline-style: invalid map entry "${trimmed}". Expected "property:value=className".`);
+        }
+        const property = left.slice(0, colonIdx).trim();
+        const value = left.slice(colonIdx + 1).trim();
+        if (!property || !value || !className) {
+            throw new Error(`inline-style: invalid map entry "${trimmed}". All parts must be non-empty.`);
+        }
+        mappings.push({ property, value, className });
+    }
+    return mappings;
+}
+/**
+ * Parse inline-style config from CLI input.
+ *
+ * Behavior depends on mode:
+ * - mode="run" (default for run command): map is REQUIRED
+ * - mode="audit" (default for audit command): map is optional, defaults to scanning all style attrs
+ */
+export function parseInlineStyleConfig(input) {
+    const mode = input.mode === "audit" ? "audit" : "run";
+    // Handle preset
+    const presetName = input.preset;
+    let presetMappings = [];
+    if (presetName) {
+        const preset = getInlineStylePresetOrThrow(presetName);
+        presetMappings = [...preset.mappings];
+    }
+    // Handle explicit mappings
+    let explicitMappings = [];
+    if (input.mappings && Array.isArray(input.mappings)) {
+        explicitMappings = input.mappings;
+    }
+    else if (input.map) {
+        const mapStr = String(input.map).trim();
+        if (mapStr) {
+            explicitMappings = parseMapString(mapStr);
+        }
+    }
+    // Merge preset + explicit mappings (explicit appended after preset)
+    const mergedMappings = [...presetMappings, ...explicitMappings];
+    if (mode === "run") {
+        // Run mode: mappings are required
+        if (mergedMappings.length === 0) {
+            throw new Error(`inline-style: "map" or "mappings" is required in run mode.\n` +
+                `CLI format: --map "color:red=text-red,backgroundColor:blue=bg-blue"\n` +
+                `Or use --preset tailwind-common`);
+        }
+        return {
+            mode: "run",
+            mappings: mergedMappings,
+            matchAllStyles: false,
+            removeEmptyStyle: input["remove-empty-style"] !== false,
+            preset: presetName,
+        };
+    }
+    // Audit mode: zero-config is OK
+    const matchAllStyles = mergedMappings.length === 0;
+    return {
+        mode: "audit",
+        mappings: mergedMappings,
+        matchAllStyles,
+        removeEmptyStyle: input["remove-empty-style"] !== false,
+        preset: presetName,
+    };
+}
+//# sourceMappingURL=schema.js.map

package/dist/rules/inline-style/schema.js.map

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

package/dist/rules/inline-style/transform.js

@@ -0,0 +1,52 @@
+/**
+ * Transform an inline-style hit into a className replacement.
+ *
+ * When all style properties are matched:
+ *   style={{ color: "red", backgroundColor: "blue" }}
+ *   → className="text-red bg-blue"
+ *
+ * When only some properties are matched (ambiguous, only if forced):
+ *   style={{ color: "red", padding: 10 }}
+ *   → className="text-red" style={{ padding: 10 }}
+ *   (This case is classified as ambiguous and normally skipped)
+ */
+export function transformInlineStyle(hit, context) {
+    const classNames = hit.metadata?.classNames;
+    const allMatched = Boolean(hit.metadata?.allMatched);
+    if (!classNames || classNames.length === 0) {
+        return null;
+    }
+    if (allMatched) {
+        // Full replacement: style={{ ... }} → className="..."
+        const classNameStr = classNames.join(" ");
+        const replacement = `className="${classNameStr}"`;
+        return {
+            filePath: hit.filePath,
+            start: hit.start,
+            end: hit.end,
+            before: hit.sourceText,
+            after: replacement,
+            ruleName: "inline-style",
+            reason: "full-style-to-class",
+        };
+    }
+    // Partial replacement: keep unmatched properties in style, add className
+    // This is classified as ambiguous, so normally won't reach here
+    const unmatchedProperties = hit.metadata?.unmatchedProperties;
+    if (!unmatchedProperties || unmatchedProperties.length === 0) {
+        return null;
+    }
+    const classNameStr = classNames.join(" ");
+    const remainingStyle = unmatchedProperties.join(", ");
+    const replacement = `className="${classNameStr}" style={{ ${remainingStyle} }}`;
+    return {
+        filePath: hit.filePath,
+        start: hit.start,
+        end: hit.end,
+        before: hit.sourceText,
+        after: replacement,
+        ruleName: "inline-style",
+        reason: "partial-style-to-class",
+    };
+}
+//# sourceMappingURL=transform.js.map

package/dist/rules/inline-style/transform.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transform.js","sourceRoot":"","sources":["../../../src/rules/inline-style/transform.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,oBAAoB,CAClC,GAAgB,EAChB,OAAuC;IAEvC,MAAM,UAAU,GAAG,GAAG,CAAC,QAAQ,EAAE,UAAkC,CAAC;IACpE,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;IAErD,IAAI,CAAC,UAAU,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC3C,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,UAAU,EAAE,CAAC;QACf,sDAAsD;QACtD,MAAM,YAAY,GAAG,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC1C,MAAM,WAAW,GAAG,cAAc,YAAY,GAAG,CAAC;QAElD,OAAO;YACL,QAAQ,EAAE,GAAG,CAAC,QAAQ;YACtB,KAAK,EAAE,GAAG,CAAC,KAAK;YAChB,GAAG,EAAE,GAAG,CAAC,GAAG;YACZ,MAAM,EAAE,GAAG,CAAC,UAAU;YACtB,KAAK,EAAE,WAAW;YAClB,QAAQ,EAAE,cAAc;YACxB,MAAM,EAAE,qBAAqB;SAC9B,CAAC;IACJ,CAAC;IAED,yEAAyE;IACzE,gEAAgE;IAChE,MAAM,mBAAmB,GAAG,GAAG,CAAC,QAAQ,EAAE,mBAA2C,CAAC;IACtF,IAAI,CAAC,mBAAmB,IAAI,mBAAmB,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC7D,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,YAAY,GAAG,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC1C,MAAM,cAAc,GAAG,mBAAmB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACtD,MAAM,WAAW,GAAG,cAAc,YAAY,cAAc,cAAc,KAAK,CAAC;IAEhF,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,wBAAwB;KACjC,CAAC;AACJ,CAAC"}

package/dist/rules/nullish-fallback/classify.js

@@ -0,0 +1,22 @@
+import { Node } from "ts-morph";
+export function classifyNullishFallback(located, _context) {
+    const node = located.node;
+    const hit = { ...located.hit };
+    // If already wrapped in ?? expression, mark as ambiguous
+    const parent = node.getParent();
+    if (parent && Node.isBinaryExpression(parent)) {
+        const op = parent.getOperatorToken().getText();
+        if (op === "??") {
+            return { ...hit, severity: "ambiguous", reason: "already-nullish-coalesced" };
+        }
+    }
+    // If on the left side of assignment, mark as unsafe
+    if (parent && Node.isBinaryExpression(parent)) {
+        const op = parent.getOperatorToken().getText();
+        if (op === "=" && parent.getLeft() === node) {
+            return { ...hit, severity: "unsafe", reason: "assignment-left-hand-side" };
+        }
+    }
+    return hit;
+}
+//# sourceMappingURL=classify.js.map

package/dist/rules/nullish-fallback/classify.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"classify.js","sourceRoot":"","sources":["../../../src/rules/nullish-fallback/classify.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;AAKhC,MAAM,UAAU,uBAAuB,CACrC,OAAyB,EACzB,QAA4C;IAE5C,MAAM,IAAI,GAAG,OAAO,CAAC,IAAY,CAAC;IAClC,MAAM,GAAG,GAAG,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IAE/B,yDAAyD;IACzD,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;IAChC,IAAI,MAAM,IAAI,IAAI,CAAC,kBAAkB,CAAC,MAAM,CAAC,EAAE,CAAC;QAC9C,MAAM,EAAE,GAAG,MAAM,CAAC,gBAAgB,EAAE,CAAC,OAAO,EAAE,CAAC;QAC/C,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC;YAChB,OAAO,EAAE,GAAG,GAAG,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,EAAE,2BAA2B,EAAE,CAAC;QAChF,CAAC;IACH,CAAC;IAED,oDAAoD;IACpD,IAAI,MAAM,IAAI,IAAI,CAAC,kBAAkB,CAAC,MAAM,CAAC,EAAE,CAAC;QAC9C,MAAM,EAAE,GAAG,MAAM,CAAC,gBAAgB,EAAE,CAAC,OAAO,EAAE,CAAC;QAC/C,IAAI,EAAE,KAAK,GAAG,IAAI,MAAM,CAAC,OAAO,EAAE,KAAK,IAAI,EAAE,CAAC;YAC5C,OAAO,EAAE,GAAG,GAAG,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,2BAA2B,EAAE,CAAC;QAC7E,CAAC;IACH,CAAC;IAED,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/rules/nullish-fallback/locate.js

@@ -0,0 +1,175 @@
+import path from "node:path";
+import { Node, 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;
+}
+/**
+ * Extract the full access chain from a PropertyAccessExpression.
+ */
+function extractAccessChain(node) {
+    const parts = [];
+    let current = node;
+    while (Node.isPropertyAccessExpression(current)) {
+        parts.unshift(current.getName());
+        current = current.getExpression();
+    }
+    if (Node.isIdentifier(current)) {
+        parts.unshift(current.getText());
+        return parts;
+    }
+    if (current.getKind() === SyntaxKind.ThisKeyword) {
+        parts.unshift("this");
+        return parts;
+    }
+    return null;
+}
+function parseTarget(target) {
+    return target.replace(/\?\./g, ".").split(".").map((x) => x.trim()).filter(Boolean);
+}
+function chainsMatch(chain, targetChain) {
+    if (chain.length !== targetChain.length)
+        return false;
+    return chain.every((item, index) => item === targetChain[index]);
+}
+/**
+ * Walk up from the matched node to find the outermost PropertyAccessExpression
+ * chain that contains this node as a sub-expression.
+ *
+ * For example, if we matched `data.result` inside `data.result?.data`,
+ * this returns the `data.result?.data` node.
+ *
+ * Returns null if the matched node is already the outermost access.
+ */
+function findOuterChain(matchedNode) {
+    let current = matchedNode.getParent();
+    let outermost = null;
+    while (current && Node.isPropertyAccessExpression(current)) {
+        outermost = current;
+        current = current.getParent();
+    }
+    return outermost;
+}
+/**
+ * Extract the "tail" part of the outer chain relative to the matched node.
+ *
+ * For `data.result?.data.items` where matched = `data.result`:
+ *   tail = "?.data.items"  (the raw text after the matched node)
+ */
+function extractTailText(matchedNode, outerNode) {
+    const outerText = outerNode.getText();
+    const matchedEnd = matchedNode.getEnd();
+    const outerStart = outerNode.getStart();
+    const tailOffset = matchedEnd - outerStart;
+    return outerText.slice(tailOffset);
+}
+/**
+ * Detect if the effective node (the node that will be replaced) is inside
+ * a binary expression with an operator that has higher precedence than ??.
+ *
+ * ?? has very low precedence (5). Most binary operators have higher precedence:
+ *   +, -, *, /, %, **, <, >, <=, >=, ==, ===, !=, !==, &, |, ^, <<, >>, >>>
+ *
+ * If so, we need to wrap the ?? expression in parentheses.
+ */
+function needsParentheses(effectiveNode) {
+    const parent = effectiveNode.getParent();
+    if (!parent)
+        return false;
+    // If parent is a BinaryExpression and the operator is NOT ?? or ??=
+    if (Node.isBinaryExpression(parent)) {
+        const op = parent.getOperatorToken().getText();
+        // ?? and ??= don't need extra parens
+        if (op === "??" || op === "??=")
+            return false;
+        // Assignment operators don't need parens (=, +=, -=, etc.)
+        if (op.endsWith("=") && op !== "==" && op !== "!=" && op !== "===" && op !== "!==" && op !== "<=" && op !== ">=") {
+            return false;
+        }
+        // All other binary operators have higher precedence than ??
+        return true;
+    }
+    // If parent is a ConditionalExpression (ternary), need parens
+    if (Node.isConditionalExpression(parent)) {
+        return true;
+    }
+    // Template literal expressions don't need parens
+    if (parent.getKind() === SyntaxKind.TemplateSpan) {
+        return false;
+    }
+    return false;
+}
+export function locateNullishFallback(context) {
+    const results = [];
+    const targetChain = parseTarget(context.config.target);
+    for (const sourceFile of context.loaded.sourceFiles) {
+        const nodes = sourceFile.getDescendantsOfKind(SyntaxKind.PropertyAccessExpression);
+        for (const node of nodes) {
+            const chain = extractAccessChain(node);
+            if (!chain)
+                continue;
+            if (!chainsMatch(chain, targetChain))
+                continue;
+            // Check if this matched node is part of a larger property access chain
+            const outerNode = findOuterChain(node);
+            if (outerNode) {
+                // The matched target is a sub-expression of a larger chain.
+                // We need to replace the ENTIRE outer chain with (target ?? fallback).tail
+                const tailText = extractTailText(node, outerNode);
+                // Convert optional chain tail (?.foo) to regular access (.foo)
+                // because after ?? fallback, the value is guaranteed non-nullish
+                const normalizedTail = tailText.replace(/\?\./g, ".");
+                // Check if the outer node needs parentheses due to operator precedence
+                const wrapParens = needsParentheses(outerNode);
+                results.push({
+                    node: outerNode,
+                    hit: {
+                        filePath: path.relative(context.loaded.repoPath, sourceFile.getFilePath()),
+                        line: node.getStartLineNumber(),
+                        column: getColumnFromNode(node),
+                        sourceText: outerNode.getText(),
+                        severity: "safe",
+                        reason: "nullish-target-in-chain",
+                        start: outerNode.getStart(),
+                        end: outerNode.getEnd(),
+                        metadata: {
+                            kind: "nullish-target-chain",
+                            accessChain: chain,
+                            matchedText: node.getText(),
+                            tailText: normalizedTail,
+                            needsParentheses: wrapParens,
+                        },
+                    },
+                });
+            }
+            else {
+                // The matched target is a standalone expression (no further chain)
+                // Check if it needs parentheses due to operator precedence
+                const wrapParens = needsParentheses(node);
+                results.push({
+                    node,
+                    hit: {
+                        filePath: path.relative(context.loaded.repoPath, sourceFile.getFilePath()),
+                        line: node.getStartLineNumber(),
+                        column: getColumnFromNode(node),
+                        sourceText: node.getText(),
+                        severity: "safe",
+                        reason: "nullish-target-match",
+                        start: node.getStart(),
+                        end: node.getEnd(),
+                        metadata: {
+                            kind: "nullish-target",
+                            accessChain: chain,
+                            needsParentheses: wrapParens,
+                        },
+                    },
+                });
+            }
+        }
+    }
+    return results;
+}
+//# sourceMappingURL=locate.js.map

package/dist/rules/nullish-fallback/locate.js.map

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