@kamaalio/codemod-kit 0.0.17 → 0.0.18

package/README.md

@@ -137,36 +137,49 @@ const result = await findAndReplaceConfig(ast, 'javascript', [
 ]);
 ```
 
-### `findAndReplaceConfigEdits(content, lang, config)`
+### `findAndReplaceConfigModifications(modifications, config)`
 
-A utility function for applying multiple find-and-replace operations sequentially and returning the edit history.
+A utility function for applying multiple find-and-replace operations sequentially on a `Modifications` object.
 
-- `content`: An `SgRoot<TypesMap>` object representing the parsed AST.
-- `lang`: A `NapiLang` value specifying the language for re-parsing after each transformation.
+- `modifications`: A `Modifications` object containing the AST, language, and transformation history.
 - `config`: An array of objects containing `rule` and `transformer` pairs to apply sequentially.
 
-Returns an array of objects containing the AST content and edits for each transformation step.
+Returns a `Promise<Modifications>` with the updated AST, accumulated edit count, and transformation history.
 
 ```typescript
-import { findAndReplaceConfigEdits } from '@kamaalio/codemod-kit';
+import { findAndReplaceConfigModifications } from '@kamaalio/codemod-kit';
 import { parseAsync } from '@ast-grep/napi';
 
 const code = `
 function oldFunction() {
   return "hello";
 }
+const value = 42;
 `;
 
 const ast = await parseAsync('javascript', code);
-const editsHistory = await findAndReplaceConfigEdits(ast, 'javascript', [
+const initialModifications = {
+  ast,
+  lang: 'javascript' as const,
+  filename: 'example.js',
+  report: { changesApplied: 0 },
+  history: [ast],
+};
+
+const result = await findAndReplaceConfigModifications(initialModifications, [
   {
     rule: { pattern: 'function oldFunction() { $$$ }' },
     transformer: node => 'function newFunction() { return "hello world"; }',
   },
+  {
+    rule: { pattern: 'const value = $VAL' },
+    transformer: node => 'const value = 100',
+  },
 ]);
 
-// Each element contains { content: SgRoot, edits: Edit[] }
-// Useful for tracking transformation history or debugging
+// result.ast contains the final transformed AST
+// result.report.changesApplied contains the total number of edits applied
+// result.history contains the transformation history
 ```
 
 ### `Codemod`

package/dist/codemods/index.d.ts

@@ -1,2 +1,2 @@
-export { runCodemods, runCodemod, commitEditModifications, findAndReplace, findAndReplaceEdits, findAndReplaceConfig, findAndReplaceConfigEdits, } from './utils.js';
+export { runCodemods, runCodemod, commitEditModifications, findAndReplace, findAndReplaceEdits, findAndReplaceConfig, findAndReplaceConfigModifications, } from './utils.js';
 export type { Codemod, Modifications } from './types.js';

package/dist/codemods/utils.d.ts

@@ -22,13 +22,10 @@ export declare function runCodemod<C extends Codemod>(codemod: C, transformation
     hasChanges: boolean;
     content: string;
 }, Error>>>;
-export declare function findAndReplaceConfigEdits(content: SgRoot<TypesMap>, lang: NapiLang, config: Array<{
+export declare function findAndReplaceConfigModifications(modifications: Modifications, config: Array<{
     rule: Rule<TypesMap>;
     transformer: (node: SgNode<TypesMap, Kinds<TypesMap>>) => Optional<string>;
-}>): Promise<Array<{
-    content: SgRoot<TypesMap>;
-    edits: Array<Edit>;
-}>>;
+}>): Promise<Modifications>;
 export declare function findAndReplaceConfig(content: SgRoot<TypesMap>, lang: NapiLang, config: Array<{
     rule: Rule<TypesMap>;
     transformer: (node: SgNode<TypesMap, Kinds<TypesMap>>) => Optional<string>;

package/dist/index.cjs

@@ -34,11 +34,11 @@ var __webpack_exports__ = {};
 __webpack_require__.r(__webpack_exports__);
 __webpack_require__.d(__webpack_exports__, {
     commitEditModifications: ()=>commitEditModifications,
-    findAndReplaceConfigEdits: ()=>findAndReplaceConfigEdits,
+    runCodemods: ()=>runCodemods,
     runCodemod: ()=>runCodemod,
     findAndReplace: ()=>findAndReplace,
+    findAndReplaceConfigModifications: ()=>findAndReplaceConfigModifications,
     findAndReplaceEdits: ()=>findAndReplaceEdits,
-    runCodemods: ()=>runCodemods,
     findAndReplaceConfig: ()=>findAndReplaceConfig
 });
 const external_node_path_namespaceObject = require("node:path");
@@ -131,6 +131,16 @@ async function runCodemod(codemod, transformationPath, options) {
         }
     }));
 }
+async function findAndReplaceConfigModifications(modifications, config) {
+    let currentModifications = {
+        ...modifications
+    };
+    for (const { rule, transformer } of config){
+        const edits = findAndReplaceEdits(currentModifications.ast, rule, transformer);
+        currentModifications = await commitEditModifications(edits, currentModifications);
+    }
+    return currentModifications;
+}
 async function findAndReplaceConfigEdits(content, lang, config) {
     let currentContent = content;
     const editsAndContent = [];
@@ -200,7 +210,7 @@ function defaultedHooks(hooks) {
 exports.commitEditModifications = __webpack_exports__.commitEditModifications;
 exports.findAndReplace = __webpack_exports__.findAndReplace;
 exports.findAndReplaceConfig = __webpack_exports__.findAndReplaceConfig;
-exports.findAndReplaceConfigEdits = __webpack_exports__.findAndReplaceConfigEdits;
+exports.findAndReplaceConfigModifications = __webpack_exports__.findAndReplaceConfigModifications;
 exports.findAndReplaceEdits = __webpack_exports__.findAndReplaceEdits;
 exports.runCodemod = __webpack_exports__.runCodemod;
 exports.runCodemods = __webpack_exports__.runCodemods;
@@ -208,7 +218,7 @@ for(var __webpack_i__ in __webpack_exports__)if (-1 === [
     "commitEditModifications",
     "findAndReplace",
     "findAndReplaceConfig",
-    "findAndReplaceConfigEdits",
+    "findAndReplaceConfigModifications",
     "findAndReplaceEdits",
     "runCodemod",
     "runCodemods"

package/dist/index.d.ts

@@ -1 +1 @@
-export { runCodemods, runCodemod, commitEditModifications, findAndReplace, findAndReplaceEdits, findAndReplaceConfig, findAndReplaceConfigEdits, type Codemod, type Modifications, } from './codemods/index.js';
+export { runCodemods, runCodemod, commitEditModifications, findAndReplace, findAndReplaceEdits, findAndReplaceConfig, findAndReplaceConfigModifications, type Codemod, type Modifications, } from './codemods/index.js';

package/dist/index.js

@@ -85,6 +85,16 @@ async function runCodemod(codemod, transformationPath, options) {
         }
     }));
 }
+async function findAndReplaceConfigModifications(modifications, config) {
+    let currentModifications = {
+        ...modifications
+    };
+    for (const { rule, transformer } of config){
+        const edits = findAndReplaceEdits(currentModifications.ast, rule, transformer);
+        currentModifications = await commitEditModifications(edits, currentModifications);
+    }
+    return currentModifications;
+}
 async function findAndReplaceConfigEdits(content, lang, config) {
     let currentContent = content;
     const editsAndContent = [];
@@ -151,4 +161,4 @@ function defaultedHooks(hooks) {
         preCodemodRun
     };
 }
-export { commitEditModifications, findAndReplace, findAndReplaceConfig, findAndReplaceConfigEdits, findAndReplaceEdits, runCodemod, runCodemods };
+export { commitEditModifications, findAndReplace, findAndReplaceConfig, findAndReplaceConfigModifications, findAndReplaceEdits, runCodemod, runCodemods };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kamaalio/codemod-kit",
-  "version": "0.0.17",
+  "version": "0.0.18",
   "type": "module",
   "author": "Kamaal Farah",
   "license": "MIT",