sovr-patch 0.2.0

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

@@ -0,0 +1,13 @@
+import { parseNullishFallbackConfig } from "./schema.js";
+import { locateNullishFallback } from "./locate.js";
+import { classifyNullishFallback } from "./classify.js";
+import { transformNullishFallback } from "./transform.js";
+export const nullishFallbackRule = {
+    name: "nullish-fallback",
+    description: "Inject ?? fallback for repeated property access targets.",
+    parseConfig: parseNullishFallbackConfig,
+    locate: locateNullishFallback,
+    classify: classifyNullishFallback,
+    transform: transformNullishFallback,
+};
+//# sourceMappingURL=rule.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"rule.js","sourceRoot":"","sources":["../../../src/rules/nullish-fallback/rule.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,0BAA0B,EAAE,MAAM,aAAa,CAAC;AACzD,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC;AACxD,OAAO,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAC;AAI1D,MAAM,CAAC,MAAM,mBAAmB,GAA0C;IACxE,IAAI,EAAE,kBAAkB;IACxB,WAAW,EAAE,0DAA0D;IACvE,WAAW,EAAE,0BAA0B;IACvC,MAAM,EAAE,qBAAqB;IAC7B,QAAQ,EAAE,uBAAuB;IACjC,SAAS,EAAE,wBAAwB;CACpC,CAAC"}

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

@@ -0,0 +1,10 @@
+export function parseNullishFallbackConfig(input) {
+    const target = String(input.target ?? "").trim();
+    const fallback = String(input.fallback ?? "").trim();
+    if (!target)
+        throw new Error(`nullish-fallback: "target" is required`);
+    if (!fallback)
+        throw new Error(`nullish-fallback: "fallback" is required`);
+    return { target, fallback };
+}
+//# sourceMappingURL=schema.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../../src/rules/nullish-fallback/schema.ts"],"names":[],"mappings":"AAKA,MAAM,UAAU,0BAA0B,CACxC,KAA8B;IAE9B,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IACjD,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAErD,IAAI,CAAC,MAAM;QAAE,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC;IACvE,IAAI,CAAC,QAAQ;QAAE,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC;IAE3E,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;AAC9B,CAAC"}

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

@@ -0,0 +1,49 @@
+export function transformNullishFallback(hit, context) {
+    const kind = String(hit.metadata?.kind ?? "");
+    const fallback = context.config.fallback;
+    const wrapParens = Boolean(hit.metadata?.needsParentheses);
+    if (kind === "nullish-target-chain") {
+        // The matched target is part of a larger chain.
+        // e.g., data.result?.data  where target = "data.result"
+        //
+        // We replace the ENTIRE outer chain:
+        //   Before: data.result?.data
+        //   After:  (data.result ?? '').data
+        const matchedText = String(hit.metadata?.matchedText ?? "");
+        const tailText = String(hit.metadata?.tailText ?? "");
+        let after = `(${matchedText} ?? ${fallback})${tailText}`;
+        // If the chain is inside a binary expression (e.g., x?.y > 100),
+        // wrap the entire replacement in parentheses
+        if (wrapParens) {
+            after = `(${after})`;
+        }
+        return {
+            filePath: hit.filePath,
+            start: hit.start,
+            end: hit.end,
+            before: hit.sourceText,
+            after,
+            ruleName: "nullish-fallback",
+            reason: "inject-nullish-fallback-chain",
+        };
+    }
+    // Standalone target (no further chain after it)
+    // e.g., data.result  →  data.result ?? ''
+    //
+    // If inside a binary expression (e.g., plan.yearlyPrice > 100),
+    // wrap in parentheses: (plan.yearlyPrice ?? 0) > 100
+    let after = `${hit.sourceText} ?? ${fallback}`;
+    if (wrapParens) {
+        after = `(${after})`;
+    }
+    return {
+        filePath: hit.filePath,
+        start: hit.start,
+        end: hit.end,
+        before: hit.sourceText,
+        after,
+        ruleName: "nullish-fallback",
+        reason: "inject-nullish-fallback",
+    };
+}
+//# sourceMappingURL=transform.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"transform.js","sourceRoot":"","sources":["../../../src/rules/nullish-fallback/transform.ts"],"names":[],"mappings":"AAIA,MAAM,UAAU,wBAAwB,CACtC,GAAgB,EAChB,OAA2C;IAE3C,MAAM,IAAI,GAAG,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,IAAI,IAAI,EAAE,CAAC,CAAC;IAC9C,MAAM,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC;IACzC,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE,gBAAgB,CAAC,CAAC;IAE3D,IAAI,IAAI,KAAK,sBAAsB,EAAE,CAAC;QACpC,gDAAgD;QAChD,wDAAwD;QACxD,EAAE;QACF,qCAAqC;QACrC,8BAA8B;QAC9B,qCAAqC;QACrC,MAAM,WAAW,GAAG,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,WAAW,IAAI,EAAE,CAAC,CAAC;QAC5D,MAAM,QAAQ,GAAG,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,QAAQ,IAAI,EAAE,CAAC,CAAC;QAEtD,IAAI,KAAK,GAAG,IAAI,WAAW,OAAO,QAAQ,IAAI,QAAQ,EAAE,CAAC;QAEzD,iEAAiE;QACjE,6CAA6C;QAC7C,IAAI,UAAU,EAAE,CAAC;YACf,KAAK,GAAG,IAAI,KAAK,GAAG,CAAC;QACvB,CAAC;QAED,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;YACL,QAAQ,EAAE,kBAAkB;YAC5B,MAAM,EAAE,+BAA+B;SACxC,CAAC;IACJ,CAAC;IAED,gDAAgD;IAChD,0CAA0C;IAC1C,EAAE;IACF,gEAAgE;IAChE,qDAAqD;IACrD,IAAI,KAAK,GAAG,GAAG,GAAG,CAAC,UAAU,OAAO,QAAQ,EAAE,CAAC;IAC/C,IAAI,UAAU,EAAE,CAAC;QACf,KAAK,GAAG,IAAI,KAAK,GAAG,CAAC;IACvB,CAAC;IAED,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;QACL,QAAQ,EAAE,kBAAkB;QAC5B,MAAM,EAAE,yBAAyB;KAClC,CAAC;AACJ,CAAC"}

package/dist/rules/registry.js

@@ -0,0 +1,21 @@
+import { fieldRenameRule } from "./field-rename/rule.js";
+import { nullishFallbackRule } from "./nullish-fallback/rule.js";
+import { designTokenRule } from "./design-token/rule.js";
+import { inlineStyleRule } from "./inline-style/rule.js";
+export function createRuleRegistry() {
+    const registry = new Map();
+    registry.set(fieldRenameRule.name, fieldRenameRule);
+    registry.set(nullishFallbackRule.name, nullishFallbackRule);
+    registry.set(designTokenRule.name, designTokenRule);
+    registry.set(inlineStyleRule.name, inlineStyleRule);
+    return registry;
+}
+export function getRuleOrThrow(registry, name) {
+    const rule = registry.get(name);
+    if (!rule) {
+        const available = [...registry.keys()].join(", ");
+        throw new Error(`unknown rule: "${name}". Available rules: ${available}`);
+    }
+    return rule;
+}
+//# sourceMappingURL=registry.js.map

package/dist/rules/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/rules/registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAGzD,MAAM,UAAU,kBAAkB;IAChC,MAAM,QAAQ,GAAiB,IAAI,GAAG,EAAE,CAAC;IAEzC,QAAQ,CAAC,GAAG,CAAC,eAAe,CAAC,IAAI,EAAE,eAAe,CAAC,CAAC;IACpD,QAAQ,CAAC,GAAG,CAAC,mBAAmB,CAAC,IAAI,EAAE,mBAAmB,CAAC,CAAC;IAC5D,QAAQ,CAAC,GAAG,CAAC,eAAe,CAAC,IAAI,EAAE,eAAe,CAAC,CAAC;IACpD,QAAQ,CAAC,GAAG,CAAC,eAAe,CAAC,IAAI,EAAE,eAAe,CAAC,CAAC;IAEpD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,QAAsB,EAAE,IAAY;IACjE,MAAM,IAAI,GAAG,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAChC,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,MAAM,SAAS,GAAG,CAAC,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAClD,MAAM,IAAI,KAAK,CAAC,kBAAkB,IAAI,uBAAuB,SAAS,EAAE,CAAC,CAAC;IAC5E,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/rules/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/rules/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/rules/types.ts"],"names":[],"mappings":""}

package/license.json

@@ -0,0 +1,13 @@
+{
+  "email": "test@test.com",
+  "plan": "full-engine",
+  "rules": [
+    "field-rename",
+    "nullish-fallback",
+    "design-token",
+    "inline-style"
+  ],
+  "exp": "2027-03-07T11:22:52.007Z",
+  "iat": "2026-03-07T11:22:52.007Z",
+  "signature": "fIcH07l6gQyFuhidadMK5w+7SGN+Y39SOe5965PbtRi8kye3JIfpk3yHPcGW0dyMm3DO6obhoJnLi/kFMJ84Bg=="
+}

package/package.json

@@ -0,0 +1,64 @@
+{
+  "name": "sovr-patch",
+  "version": "0.2.0",
+  "description": "Rule-driven TypeScript migration engine. AST-powered scanning, safe patches, tsc verification.",
+  "type": "module",
+  "bin": {
+    "sovr-patch": "./dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "dev": "tsx src/index.ts",
+    "list-rules": "tsx src/index.ts list-rules",
+    "demo": "tsx scripts/demo.ts",
+    "demo:apply": "tsx scripts/demo.ts --apply",
+    "trial:field-rename": "tsx src/index.ts run --rule field-rename --from \"config.baseUrl\" --to \"config.endpoint\" --repo ./fixtures/demo-repo-baseurl --report",
+    "trial:field-rename:apply": "tsx src/index.ts run --rule field-rename --from \"config.baseUrl\" --to \"config.endpoint\" --repo ./fixtures/demo-repo-baseurl --apply --report",
+    "test:scan": "tsx scripts/test-scan.ts",
+    "test:rewrite": "tsx scripts/test-rewrite.ts",
+    "test:safe-apply": "tsx scripts/test-safe-apply.ts",
+    "test": "npm run test:scan && npm run test:rewrite && npm run test:safe-apply",
+    "test:engine": "tsx scripts/test-engine.ts",
+    "test:nullish-chain": "tsx scripts/test-nullish-chain.ts",
+    "test:nullish-precedence": "tsx scripts/test-nullish-precedence.ts",
+    "test:destructuring": "tsx scripts/test-destructuring.ts",
+    "test:design-token": "tsx scripts/test-design-token.ts",
+    "test:inline-style": "tsx scripts/test-inline-style.ts",
+    "test:all": "npm run test && npm run test:engine && npm run test:nullish-chain && npm run test:nullish-precedence && npm run test:destructuring && npm run test:design-token && npm run test:inline-style",
+    "ci": "tsx scripts/ci-gate.ts"
+  },
+  "dependencies": {
+    "diff": "^7.0.0",
+    "ts-morph": "^25.0.0",
+    "typescript": "^5.9.2"
+  },
+  "devDependencies": {
+    "@types/diff": "^7.0.2",
+    "@types/node": "^24.3.0",
+    "tsx": "^4.19.2",
+    "vitest": "^4.0.18"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "keywords": [
+    "codemod",
+    "typescript",
+    "migration",
+    "ast",
+    "patch",
+    "sovr",
+    "rule-engine"
+  ],
+  "license": "BSL-1.1",
+  "files": [
+    "dist",
+    "LICENSE",
+    "README.md"
+  ],
+  "author": "SOVR",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/xie38388/sovr-patch"
+  }
+}