@kamaalio/codemod-kit 0.0.25 → 0.0.27

package/dist/codemods/index.d.ts

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

package/dist/codemods/types.d.ts

@@ -1,11 +1,12 @@
 import type { Edit, Rule, SgNode, SgRoot } from '@ast-grep/napi';
 import type { NapiLang } from '@ast-grep/napi/types/lang.js';
 import type { Kinds, TypesMap } from '@ast-grep/napi/types/staticTypes.js';
-import type { Optional } from '../utils/type-utils.js';
+import type { types } from '@kamaalio/kamaal';
 export type Codemod = {
     name: string;
     languages: Set<NapiLang> | Array<NapiLang>;
-    transformer: (content: string, filename?: Optional<string>) => Promise<string>;
+    transformer: (content: string, filename?: types.Optional<string>) => Promise<string>;
+    postTransform?: (rootPath: string) => Promise<void>;
 };
 export type ModificationsReport = {
     changesApplied: number;
@@ -14,10 +15,10 @@ export type Modifications = {
     ast: SgRoot<TypesMap>;
     report: ModificationsReport;
     lang: NapiLang;
-    filename: Optional<string>;
+    filename: types.Optional<string>;
     history: Array<SgRoot<TypesMap>>;
 };
 export type FindAndReplaceConfig = {
     rule: Rule<TypesMap>;
-    transformer: ((node: SgNode<TypesMap, Kinds<TypesMap>>, rule: Rule<TypesMap>) => Optional<Edit | string> | Array<Edit | string>) | string;
+    transformer: ((node: SgNode<TypesMap, Kinds<TypesMap>>, rule: Rule<TypesMap>) => types.Optional<Edit | string> | Array<Edit | string>) | string;
 };

package/dist/codemods/utils.d.ts

@@ -1,7 +1,8 @@
 import { type Result } from 'neverthrow';
-import { type Edit, type SgRoot } from '@ast-grep/napi';
-import type { TypesMap } from '@ast-grep/napi/types/staticTypes.js';
+import { type Edit, type SgRoot, type SgNode } from '@ast-grep/napi';
+import type { Kinds, TypesMap } from '@ast-grep/napi/types/staticTypes.js';
 import type { NapiLang } from '@ast-grep/napi/types/lang.js';
+import { type types } from '@kamaalio/kamaal';
 import type { Codemod, FindAndReplaceConfig, Modifications } from './types.js';
 type RunCodemodHooks<C extends Codemod> = {
     targetFiltering?: (filepath: string, codemod: C) => boolean;
@@ -12,6 +13,7 @@ type RunCodemodOptions<C extends Codemod> = {
     hooks?: RunCodemodHooks<C>;
     log?: boolean;
     dry?: boolean;
+    rootPaths?: Array<string>;
 };
 export declare function runCodemods<C extends Codemod>(codemods: Array<C>, transformationPath: string, options?: RunCodemodOptions<C>): Promise<Record<string, Array<Result<{
     hasChanges: boolean;
@@ -21,6 +23,7 @@ export declare function runCodemod<C extends Codemod>(codemod: C, transformation
     hasChanges: boolean;
     content: string;
 }, Error>>>;
+export declare function traverseUp(node: SgNode<TypesMap, Kinds<TypesMap>>, until: (node: SgNode<TypesMap, Kinds<TypesMap>>) => boolean): types.Optional<SgNode<TypesMap, Kinds<TypesMap>>>;
 export declare function findAndReplaceConfigModifications(modifications: Modifications, config: Array<FindAndReplaceConfig>): Promise<Modifications>;
 export declare function findAndReplaceConfig(content: SgRoot<TypesMap>, lang: NapiLang, config: Array<FindAndReplaceConfig>): Promise<string>;
 export declare function findAndReplaceEdits(content: SgRoot<TypesMap>, rule: FindAndReplaceConfig['rule'], transformer: FindAndReplaceConfig['transformer']): Array<Edit>;

package/dist/index.cjs

@@ -33,13 +33,14 @@ var __webpack_require__ = {};
 var __webpack_exports__ = {};
 __webpack_require__.r(__webpack_exports__);
 __webpack_require__.d(__webpack_exports__, {
+    findAndReplace: ()=>findAndReplace,
+    findAndReplaceConfig: ()=>findAndReplaceConfig,
     commitEditModifications: ()=>commitEditModifications,
-    runCodemods: ()=>runCodemods,
     runCodemod: ()=>runCodemod,
-    findAndReplace: ()=>findAndReplace,
     findAndReplaceConfigModifications: ()=>findAndReplaceConfigModifications,
     findAndReplaceEdits: ()=>findAndReplaceEdits,
-    findAndReplaceConfig: ()=>findAndReplaceConfig
+    runCodemods: ()=>runCodemods,
+    traverseUp: ()=>traverseUp
 });
 const external_node_path_namespaceObject = require("node:path");
 var external_node_path_default = /*#__PURE__*/ __webpack_require__.n(external_node_path_namespaceObject);
@@ -88,7 +89,7 @@ async function runCodemods(codemods, transformationPath, options) {
     return results;
 }
 async function runCodemod(codemod, transformationPath, options) {
-    const { hooks, log: enableLogging, dry: runInDryMode } = defaultedOptions(options);
+    const { hooks, log: enableLogging, dry: runInDryMode, rootPaths } = defaultedOptions(options);
     await hooks.preCodemodRun(codemod);
     const globItems = await external_fast_glob_default().glob([
         '**/*'
@@ -106,7 +107,7 @@ async function runCodemod(codemod, transformationPath, options) {
     });
     if (0 === targets.length) return [];
     if (enableLogging) console.log(`\u{1F9C9} '${codemod.name}' targeting ${targets.length} ${1 === targets.length ? 'file' : 'files'} to transform, chill and grab some mat\xe9`);
-    return Promise.all(targets.map(async (filepath)=>{
+    const results = await Promise.all(targets.map(async (filepath)=>{
         const fullPath = external_node_path_default().join(transformationPath, filepath);
         try {
             const content = await promises_default().readFile(fullPath, {
@@ -130,6 +131,23 @@ async function runCodemod(codemod, transformationPath, options) {
             return (0, external_neverthrow_namespaceObject.err)(error);
         }
     }));
+    await Promise.all(rootPaths.map((rootPath)=>(codemod.postTransform ?? (async ()=>{}))(rootPath)));
+    return results;
+}
+function traverseUp(node, until) {
+    let current = node.parent();
+    if (null == current) return null;
+    while(null != current){
+        const next = current.parent();
+        if (null == next) break;
+        if (until(next)) {
+            current = next;
+            break;
+        }
+        current = next;
+    }
+    if (!until(current)) return null;
+    return current;
 }
 async function findAndReplaceConfigModifications(modifications, config) {
     let currentModifications = {
@@ -246,7 +264,8 @@ function defaultedOptions(options) {
     return {
         hooks: defaultedHooks(options?.hooks),
         log: options?.log ?? true,
-        dry: options?.dry ?? false
+        dry: options?.dry ?? false,
+        rootPaths: options?.rootPaths ?? []
     };
 }
 function defaultedHooks(hooks) {
@@ -266,6 +285,7 @@ exports.findAndReplaceConfigModifications = __webpack_exports__.findAndReplaceCo
 exports.findAndReplaceEdits = __webpack_exports__.findAndReplaceEdits;
 exports.runCodemod = __webpack_exports__.runCodemod;
 exports.runCodemods = __webpack_exports__.runCodemods;
+exports.traverseUp = __webpack_exports__.traverseUp;
 for(var __webpack_i__ in __webpack_exports__)if (-1 === [
     "commitEditModifications",
     "findAndReplace",
@@ -273,7 +293,8 @@ for(var __webpack_i__ in __webpack_exports__)if (-1 === [
     "findAndReplaceConfigModifications",
     "findAndReplaceEdits",
     "runCodemod",
-    "runCodemods"
+    "runCodemods",
+    "traverseUp"
 ].indexOf(__webpack_i__)) exports[__webpack_i__] = __webpack_exports__[__webpack_i__];
 Object.defineProperty(exports, '__esModule', {
     value: true

package/dist/index.d.ts

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

package/dist/index.js

@@ -42,7 +42,7 @@ async function runCodemods(codemods, transformationPath, options) {
     return results;
 }
 async function runCodemod(codemod, transformationPath, options) {
-    const { hooks, log: enableLogging, dry: runInDryMode } = defaultedOptions(options);
+    const { hooks, log: enableLogging, dry: runInDryMode, rootPaths } = defaultedOptions(options);
     await hooks.preCodemodRun(codemod);
     const globItems = await fast_glob.glob([
         '**/*'
@@ -60,7 +60,7 @@ async function runCodemod(codemod, transformationPath, options) {
     });
     if (0 === targets.length) return [];
     if (enableLogging) console.log(`\u{1F9C9} '${codemod.name}' targeting ${targets.length} ${1 === targets.length ? 'file' : 'files'} to transform, chill and grab some mat\xe9`);
-    return Promise.all(targets.map(async (filepath)=>{
+    const results = await Promise.all(targets.map(async (filepath)=>{
         const fullPath = node_path.join(transformationPath, filepath);
         try {
             const content = await promises.readFile(fullPath, {
@@ -84,6 +84,23 @@ async function runCodemod(codemod, transformationPath, options) {
             return err(error);
         }
     }));
+    await Promise.all(rootPaths.map((rootPath)=>(codemod.postTransform ?? (async ()=>{}))(rootPath)));
+    return results;
+}
+function traverseUp(node, until) {
+    let current = node.parent();
+    if (null == current) return null;
+    while(null != current){
+        const next = current.parent();
+        if (null == next) break;
+        if (until(next)) {
+            current = next;
+            break;
+        }
+        current = next;
+    }
+    if (!until(current)) return null;
+    return current;
 }
 async function findAndReplaceConfigModifications(modifications, config) {
     let currentModifications = {
@@ -200,7 +217,8 @@ function defaultedOptions(options) {
     return {
         hooks: defaultedHooks(options?.hooks),
         log: options?.log ?? true,
-        dry: options?.dry ?? false
+        dry: options?.dry ?? false,
+        rootPaths: options?.rootPaths ?? []
     };
 }
 function defaultedHooks(hooks) {
@@ -213,4 +231,4 @@ function defaultedHooks(hooks) {
         preCodemodRun
     };
 }
-export { commitEditModifications, findAndReplace, findAndReplaceConfig, findAndReplaceConfigModifications, findAndReplaceEdits, runCodemod, runCodemods };
+export { commitEditModifications, findAndReplace, findAndReplaceConfig, findAndReplaceConfigModifications, findAndReplaceEdits, runCodemod, runCodemods, traverseUp };

package/dist/utils/type-utils.d.ts

@@ -1,4 +1,3 @@
-export type Optional<T> = T | undefined | null;
 export type ReplaceObjectProperty<A extends Record<string, unknown>, K extends keyof A, B> = Omit<A, K> & {
     [P in K]: B;
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kamaalio/codemod-kit",
-  "version": "0.0.25",
+  "version": "0.0.27",
   "type": "module",
   "author": "Kamaal Farah",
   "license": "MIT",
@@ -20,7 +20,7 @@
   ],
   "dependencies": {
     "@ast-grep/napi": "^0.38.5",
-    "@kamaalio/kamaal": "^0.7.6",
+    "@kamaalio/kamaal": "^0.7.8",
     "fast-glob": "^3.3.3",
     "neverthrow": "^8.2.0"
   },