@gridstorm/codemod 0.1.2

package/README.md

@@ -0,0 +1,37 @@
+# @gridstorm/codemod
+
+CLI tool to automatically migrate your codebase from AG Grid to GridStorm.
+
+## Install
+
+```bash
+npm install -g @gridstorm/codemod
+```
+
+## Usage
+
+```bash
+# Migrate a directory
+gridstorm-codemod ./src
+
+# Dry run (preview changes without writing)
+gridstorm-codemod ./src --dry-run
+
+# Target specific file patterns
+gridstorm-codemod ./src --include "**/*.tsx"
+```
+
+## What It Transforms
+
+- AG Grid import paths to GridStorm equivalents
+- Component props and configuration options
+- Column definition API differences
+- Event handler signatures
+
+## Documentation
+
+[Migration Guide](https://grid-data-analytics-explorer.vercel.app//docs/migration) | [Codemod Reference](https://grid-data-analytics-explorer.vercel.app//docs/codemod)
+
+## License
+
+MIT

package/dist/cli.js

@@ -0,0 +1,585 @@
+#!/usr/bin/env node
+
+// src/cli.ts
+import { Command } from "commander";
+import { glob } from "glob";
+import chalk from "chalk";
+import fs from "fs";
+import path from "path";
+
+// src/transforms/ag-grid-to-gridstorm.ts
+import jscodeshift from "jscodeshift";
+
+// src/transforms/import-map.ts
+var PACKAGE_MAP = {
+  // AG Grid community packages
+  "ag-grid-react": "@gridstorm/react",
+  "ag-grid-community": "@gridstorm/core",
+  "ag-grid-enterprise": "@gridstorm/core",
+  // AG Grid scoped packages
+  "@ag-grid-community/react": "@gridstorm/react",
+  "@ag-grid-community/core": "@gridstorm/core",
+  "@ag-grid-community/client-side-row-model": "@gridstorm/core",
+  "@ag-grid-community/csv-export": "@gridstorm/core",
+  "@ag-grid-community/infinite-row-model": "@gridstorm/core",
+  "@ag-grid-community/styles": "@gridstorm/theme-default",
+  // AG Grid enterprise scoped packages
+  "@ag-grid-enterprise/all-modules": "@gridstorm/core",
+  "@ag-grid-enterprise/core": "@gridstorm/core",
+  "@ag-grid-enterprise/row-grouping": "@gridstorm/plugin-grouping",
+  "@ag-grid-enterprise/range-selection": "@gridstorm/plugin-selection",
+  "@ag-grid-enterprise/clipboard": "@gridstorm/plugin-clipboard",
+  "@ag-grid-enterprise/rich-select": "@gridstorm/plugin-editing",
+  "@ag-grid-enterprise/side-bar": "@gridstorm/core",
+  "@ag-grid-enterprise/status-bar": "@gridstorm/core",
+  "@ag-grid-enterprise/master-detail": "@gridstorm/core",
+  "@ag-grid-enterprise/excel-export": "@gridstorm/core",
+  "@ag-grid-enterprise/charts": "@gridstorm/core",
+  "@ag-grid-enterprise/set-filter": "@gridstorm/plugin-filtering",
+  "@ag-grid-enterprise/multi-filter": "@gridstorm/plugin-filtering",
+  "@ag-grid-enterprise/column-tool-panel": "@gridstorm/core",
+  "@ag-grid-enterprise/filter-tool-panel": "@gridstorm/plugin-filtering",
+  "@ag-grid-enterprise/menu": "@gridstorm/plugin-context-menu",
+  "@ag-grid-enterprise/server-side-row-model": "@gridstorm/core",
+  "@ag-grid-enterprise/viewport-row-model": "@gridstorm/core"
+};
+var NAMED_EXPORT_MAP = {
+  // Component renames
+  "AgGridReact": { name: "GridStorm", from: "@gridstorm/react" },
+  "AgGridColumn": { name: "GridStorm", from: "@gridstorm/react" },
+  // Type renames — core types
+  "ColDef": { name: "ColumnDef", from: "@gridstorm/core" },
+  "ColGroupDef": { name: "ColumnDef", from: "@gridstorm/core" },
+  "GridApi": { name: "GridApi", from: "@gridstorm/core" },
+  "ColumnApi": { name: "GridApi", from: "@gridstorm/core" },
+  "GridReadyEvent": { name: "GridReadyEvent", from: "@gridstorm/core" },
+  "GridOptions": { name: "GridConfig", from: "@gridstorm/core" },
+  "ICellRendererParams": { name: "CellRendererProps", from: "@gridstorm/core" },
+  "ICellRendererComp": { name: "CellRendererFn", from: "@gridstorm/core" },
+  "ICellEditorParams": { name: "CellEditorParams", from: "@gridstorm/core" },
+  "ValueGetterParams": { name: "ValueGetterParams", from: "@gridstorm/core" },
+  "ValueSetterParams": { name: "ValueSetterParams", from: "@gridstorm/core" },
+  "ValueFormatterParams": { name: "ValueFormatterParams", from: "@gridstorm/core" },
+  "ValueParserParams": { name: "ValueParserParams", from: "@gridstorm/core" },
+  "SortDirection": { name: "SortDirection", from: "@gridstorm/core" },
+  "RowNode": { name: "RowNode", from: "@gridstorm/core" },
+  "IRowNode": { name: "RowNode", from: "@gridstorm/core" },
+  "Column": { name: "ColumnState", from: "@gridstorm/core" },
+  // Selection types
+  "SelectionChangedEvent": { name: "SelectionState", from: "@gridstorm/core" },
+  "RowSelectedEvent": { name: "SelectionState", from: "@gridstorm/core" },
+  // Filter types
+  "IFilterParams": { name: "FilterModel", from: "@gridstorm/core" },
+  "FilterModel": { name: "FilterModel", from: "@gridstorm/core" },
+  // Sort types
+  "SortModelItem": { name: "SortModelItem", from: "@gridstorm/core" },
+  // Module to Plugin renames (these are value imports, not just types)
+  "ClientSideRowModelModule": { name: "/* ClientSideRowModelModule is built into GridStorm core */", from: "@gridstorm/core" },
+  "AllCommunityModules": { name: "/* AllCommunityModules \u2014 install individual @gridstorm plugins instead */", from: "@gridstorm/core" },
+  "ModuleRegistry": { name: "/* ModuleRegistry \u2014 GridStorm uses plugins prop, not module registry */", from: "@gridstorm/core" }
+};
+var CSS_IMPORTS_TO_REMOVE = [
+  "ag-grid-community/styles/ag-grid.css",
+  "ag-grid-community/styles/ag-theme-alpine.css",
+  "ag-grid-community/styles/ag-theme-alpine-dark.css",
+  "ag-grid-community/styles/ag-theme-balham.css",
+  "ag-grid-community/styles/ag-theme-balham-dark.css",
+  "ag-grid-community/styles/ag-theme-material.css",
+  "ag-grid-community/dist/styles/ag-grid.css",
+  "ag-grid-community/dist/styles/ag-theme-alpine.css",
+  "ag-grid-community/dist/styles/ag-theme-balham.css",
+  "ag-grid-community/dist/styles/ag-theme-material.css",
+  "@ag-grid-community/styles/ag-grid.css",
+  "@ag-grid-community/styles/ag-theme-alpine.css",
+  "@ag-grid-community/styles/ag-theme-balham.css",
+  "@ag-grid-community/styles/ag-theme-material.css",
+  "@ag-grid-community/core/dist/styles/ag-grid.css",
+  "@ag-grid-community/core/dist/styles/ag-theme-alpine.css",
+  "@ag-grid-community/core/dist/styles/ag-theme-balham.css",
+  "@ag-grid-community/core/dist/styles/ag-theme-material.css"
+];
+var GRIDSTORM_THEME_IMPORT = "@gridstorm/theme-default/dist/tokens.css";
+
+// src/transforms/prop-map.ts
+var PROP_MAP = {
+  // Core prop renames
+  "columnDefs": "columns",
+  "modules": "plugins"
+  // These are the same but listed for completeness / documentation
+  // 'rowData': 'rowData',
+  // 'defaultColDef': 'defaultColDef',
+  // 'getRowId': 'getRowId',
+  // 'onGridReady': 'onGridReady',
+  // 'rowHeight': 'rowHeight',
+  // 'headerHeight': 'headerHeight',
+  // 'rowSelection': 'rowSelection',
+  // 'pagination': 'pagination',
+  // 'paginationPageSize': 'paginationPageSize',
+  // 'animateRows': 'animateRows',
+};
+var THEME_CLASS_MAP = {
+  "ag-theme-alpine": "light",
+  "ag-theme-alpine-dark": "dark",
+  "ag-theme-alpine-auto-dark": "dark",
+  "ag-theme-balham": "light",
+  "ag-theme-balham-dark": "dark",
+  "ag-theme-balham-auto-dark": "dark",
+  "ag-theme-material": "light",
+  "ag-theme-material-dark": "dark",
+  "ag-theme-quartz": "light",
+  "ag-theme-quartz-dark": "dark",
+  "ag-theme-quartz-auto-dark": "dark"
+};
+var MODULE_TO_PLUGIN_MAP = {
+  "ClientSideRowModelModule": {
+    plugin: null,
+    package: null,
+    note: "Built into @gridstorm/core \u2014 remove this module"
+  },
+  "InfiniteRowModelModule": {
+    plugin: null,
+    package: null,
+    note: "Coming soon in GridStorm \u2014 not yet available"
+  },
+  "CsvExportModule": {
+    plugin: null,
+    package: null,
+    note: "Coming soon in GridStorm \u2014 not yet available"
+  },
+  "RowGroupingModule": {
+    plugin: "GroupingPlugin",
+    package: "@gridstorm/plugin-grouping",
+    note: "Free in GridStorm (no enterprise license needed)"
+  },
+  "RangeSelectionModule": {
+    plugin: "SelectionPlugin",
+    package: "@gridstorm/plugin-selection",
+    note: "Provides row and range selection"
+  },
+  "ClipboardModule": {
+    plugin: "ClipboardPlugin",
+    package: "@gridstorm/plugin-clipboard",
+    note: "Copy/paste support"
+  },
+  "RichSelectModule": {
+    plugin: "EditingPlugin",
+    package: "@gridstorm/plugin-editing",
+    note: "Cell editing with rich editors"
+  },
+  "SetFilterModule": {
+    plugin: "FilteringPlugin",
+    package: "@gridstorm/plugin-filtering",
+    note: "Includes set filter and other filter types"
+  },
+  "MultiFilterModule": {
+    plugin: "FilteringPlugin",
+    package: "@gridstorm/plugin-filtering",
+    note: "Multi-filter is part of FilteringPlugin"
+  },
+  "MenuModule": {
+    plugin: "ContextMenuPlugin",
+    package: "@gridstorm/plugin-context-menu",
+    note: "Context menu support"
+  },
+  "ColumnsToolPanelModule": {
+    plugin: null,
+    package: null,
+    note: "Coming soon in GridStorm \u2014 not yet available"
+  },
+  "FiltersToolPanelModule": {
+    plugin: "FilteringPlugin",
+    package: "@gridstorm/plugin-filtering",
+    note: "Filter panel is part of FilteringPlugin"
+  },
+  "SideBarModule": {
+    plugin: null,
+    package: null,
+    note: "Coming soon in GridStorm \u2014 not yet available"
+  },
+  "StatusBarModule": {
+    plugin: null,
+    package: null,
+    note: "Coming soon in GridStorm \u2014 not yet available"
+  },
+  "MasterDetailModule": {
+    plugin: null,
+    package: null,
+    note: "Coming soon in GridStorm \u2014 not yet available"
+  },
+  "ExcelExportModule": {
+    plugin: null,
+    package: null,
+    note: "Coming soon in GridStorm \u2014 not yet available"
+  },
+  "ServerSideRowModelModule": {
+    plugin: null,
+    package: null,
+    note: "Coming soon in GridStorm \u2014 not yet available"
+  },
+  "ViewportRowModelModule": {
+    plugin: null,
+    package: null,
+    note: "Coming soon in GridStorm \u2014 not yet available"
+  },
+  "SparklinesModule": {
+    plugin: null,
+    package: null,
+    note: "Coming soon in GridStorm \u2014 not yet available"
+  },
+  "GridChartsModule": {
+    plugin: null,
+    package: null,
+    note: "Coming soon in GridStorm \u2014 not yet available"
+  },
+  "AllCommunityModules": {
+    plugin: null,
+    package: null,
+    note: "Install individual @gridstorm/plugin-* packages instead"
+  },
+  "AllEnterpriseModules": {
+    plugin: null,
+    package: null,
+    note: "Install individual @gridstorm/plugin-* packages instead"
+  }
+};
+
+// src/transforms/ag-grid-to-gridstorm.ts
+function transformAgGridToGridStorm(source, filePath) {
+  const changes = [];
+  const j = jscodeshift.withParser(detectParser(filePath));
+  let root;
+  try {
+    root = j(source);
+  } catch (_err) {
+    return { code: source, changes: [] };
+  }
+  rewriteImports(j, root, changes);
+  replaceCssImports(j, root, changes);
+  renameJsxComponents(j, root, changes);
+  renameJsxProps(j, root, changes);
+  renameTypeReferences(j, root, changes);
+  convertThemeClasses(j, root, changes);
+  addModuleToPluginComments(j, root, changes);
+  renameColDefAnnotations(j, root, changes);
+  const output = root.toSource({ quote: "single" });
+  return { code: output, changes };
+}
+function detectParser(filePath) {
+  if (filePath.endsWith(".tsx")) return "tsx";
+  if (filePath.endsWith(".ts")) return "ts";
+  if (filePath.endsWith(".jsx")) return "babel";
+  return "babel";
+}
+function rewriteImports(j, root, changes) {
+  root.find(j.ImportDeclaration).forEach((path2) => {
+    const sourceValue = path2.node.source.value;
+    if (PACKAGE_MAP[sourceValue]) {
+      const newPackage = PACKAGE_MAP[sourceValue];
+      changes.push(`Import: "${sourceValue}" \u2192 "${newPackage}"`);
+      path2.node.source = j.literal(newPackage);
+    }
+    const specifiers = path2.node.specifiers;
+    if (!specifiers) return;
+    for (const specifier of specifiers) {
+      if (specifier.type === "ImportSpecifier" && specifier.imported) {
+        const importedName = specifier.imported.type === "Identifier" ? specifier.imported.name : void 0;
+        if (importedName && NAMED_EXPORT_MAP[importedName]) {
+          const mapping = NAMED_EXPORT_MAP[importedName];
+          const newName = mapping.name;
+          if (newName.startsWith("/*")) {
+            continue;
+          }
+          if (newName !== importedName) {
+            changes.push(`Import specifier: "${importedName}" \u2192 "${newName}"`);
+            if (specifier.local && specifier.local.name === importedName) {
+              specifier.local = j.identifier(newName);
+            }
+            specifier.imported = j.identifier(newName);
+          }
+          if (mapping.from) {
+            path2.node.source = j.literal(mapping.from);
+          }
+        }
+      }
+    }
+  });
+}
+function replaceCssImports(j, root, changes) {
+  let removedCss = false;
+  root.find(j.ImportDeclaration).forEach((path2) => {
+    const sourceValue = path2.node.source.value;
+    if (CSS_IMPORTS_TO_REMOVE.includes(sourceValue)) {
+      changes.push(`Removed CSS import: "${sourceValue}"`);
+      j(path2).remove();
+      removedCss = true;
+    }
+  });
+  if (removedCss) {
+    const hasThemeImport = root.find(j.ImportDeclaration).filter((path2) => path2.node.source.value === GRIDSTORM_THEME_IMPORT).length > 0;
+    if (!hasThemeImport) {
+      const themeImport = j.importDeclaration([], j.literal(GRIDSTORM_THEME_IMPORT));
+      const body = root.find(j.Program).get("body");
+      const imports = root.find(j.ImportDeclaration);
+      if (imports.length > 0) {
+        const lastImport = imports.at(-1);
+        lastImport.insertAfter(themeImport);
+      } else {
+        body.unshift(themeImport);
+      }
+      changes.push(`Added CSS import: "${GRIDSTORM_THEME_IMPORT}"`);
+    }
+  }
+}
+function renameJsxComponents(j, root, changes) {
+  root.find(j.JSXIdentifier, { name: "AgGridReact" }).forEach((path2) => {
+    changes.push("Component: <AgGridReact> \u2192 <GridStorm>");
+    path2.node.name = "GridStorm";
+  });
+  root.find(j.JSXIdentifier, { name: "AgGridColumn" }).forEach((path2) => {
+    changes.push("Component: <AgGridColumn> \u2192 removed (use columns prop)");
+    path2.node.name = "GridStorm";
+  });
+  root.find(j.Identifier, { name: "AgGridReact" }).forEach((path2) => {
+    if (path2.parent.node.type === "ImportSpecifier" || path2.parent.node.type === "ImportDefaultSpecifier") {
+      return;
+    }
+    path2.node.name = "GridStorm";
+  });
+}
+function renameJsxProps(j, root, changes) {
+  root.find(j.JSXAttribute).forEach((path2) => {
+    const attrName = path2.node.name;
+    if (attrName.type !== "JSXIdentifier") return;
+    const propName = attrName.name;
+    if (PROP_MAP[propName]) {
+      const newPropName = PROP_MAP[propName];
+      changes.push(`Prop: "${propName}" \u2192 "${newPropName}"`);
+      attrName.name = newPropName;
+    }
+  });
+}
+function renameTypeReferences(j, root, changes) {
+  try {
+    root.find(j.TSTypeReference).forEach((path2) => {
+      const typeName = path2.node.typeName;
+      if (typeName.type === "Identifier" && NAMED_EXPORT_MAP[typeName.name]) {
+        const mapping = NAMED_EXPORT_MAP[typeName.name];
+        if (!mapping.name.startsWith("/*") && mapping.name !== typeName.name) {
+          changes.push(`Type: "${typeName.name}" \u2192 "${mapping.name}"`);
+          typeName.name = mapping.name;
+        }
+      }
+    });
+  } catch (_err) {
+  }
+}
+function convertThemeClasses(j, root, changes) {
+  root.find(j.JSXAttribute, { name: { name: "className" } }).forEach((path2) => {
+    const value = path2.node.value;
+    if (!value) return;
+    if (value.type === "StringLiteral" || value.type === "Literal" && typeof value.value === "string") {
+      const classValue = value.value;
+      for (const [agClass, gsTheme] of Object.entries(THEME_CLASS_MAP)) {
+        if (classValue.includes(agClass)) {
+          const remainingClasses = classValue.replace(agClass, "").trim().replace(/\s+/g, " ");
+          changes.push(`Theme: className="${agClass}" \u2192 data-theme="${gsTheme}"`);
+          if (remainingClasses) {
+            value.value = remainingClasses;
+            const parentAttrs = path2.parent.node.attributes;
+            if (parentAttrs && Array.isArray(parentAttrs)) {
+              parentAttrs.push(
+                j.jsxAttribute(
+                  j.jsxIdentifier("data-theme"),
+                  j.literal(gsTheme)
+                )
+              );
+            }
+          } else {
+            path2.node.name = j.jsxIdentifier("data-theme");
+            value.value = gsTheme;
+          }
+          break;
+        }
+      }
+    }
+    if (value.type === "JSXExpressionContainer") {
+      const expr = value.expression;
+      if (expr.type === "TemplateLiteral") {
+        for (const quasi of expr.quasis) {
+          const raw = quasi.value.raw;
+          for (const [agClass, gsTheme] of Object.entries(THEME_CLASS_MAP)) {
+            if (raw.includes(agClass)) {
+              changes.push(`Theme: template className containing "${agClass}" \u2014 manual conversion needed to data-theme="${gsTheme}"`);
+              quasi.value.raw = raw.replace(agClass, `/* TODO: use data-theme="${gsTheme}" instead */`);
+              quasi.value.cooked = quasi.value.raw;
+              break;
+            }
+          }
+        }
+      }
+    }
+  });
+}
+function addModuleToPluginComments(j, root, changes) {
+  for (const [moduleName, pluginInfo] of Object.entries(MODULE_TO_PLUGIN_MAP)) {
+    root.find(j.Identifier, { name: moduleName }).forEach((path2) => {
+      if (path2.parent.node.type === "ImportSpecifier" || path2.parent.node.type === "ImportDefaultSpecifier") {
+        return;
+      }
+      if (pluginInfo.plugin) {
+        changes.push(
+          `Module \u2192 Plugin: ${moduleName} \u2192 ${pluginInfo.plugin}() from "${pluginInfo.package}" (${pluginInfo.note})`
+        );
+      } else {
+        changes.push(
+          `Module removal: ${moduleName} \u2014 ${pluginInfo.note}`
+        );
+      }
+      if (!path2.node.comments) {
+        path2.node.comments = [];
+      }
+      path2.node.comments.push(
+        j.commentLine(
+          ` TODO [gridstorm-codemod]: ${pluginInfo.plugin ? `Replace with ${pluginInfo.plugin}() from "${pluginInfo.package}"` : pluginInfo.note}`,
+          false,
+          true
+        )
+      );
+    });
+  }
+}
+function renameColDefAnnotations(j, root, changes) {
+  try {
+    root.find(j.Identifier, { name: "ColDef" }).forEach((path2) => {
+      if (path2.parent.node.type === "ImportSpecifier" || path2.parent.node.type === "ImportDefaultSpecifier") {
+        return;
+      }
+      if (path2.parent.node.type === "TSTypeReference" || path2.parent.node.type === "TSQualifiedName") {
+        return;
+      }
+      path2.node.name = "ColumnDef";
+      changes.push('Type reference: "ColDef" \u2192 "ColumnDef"');
+    });
+  } catch (_err) {
+  }
+  try {
+    root.find(j.Identifier, { name: "ColGroupDef" }).forEach((path2) => {
+      if (path2.parent.node.type === "ImportSpecifier" || path2.parent.node.type === "ImportDefaultSpecifier") {
+        return;
+      }
+      path2.node.name = "ColumnDef";
+      changes.push('Type reference: "ColGroupDef" \u2192 "ColumnDef"');
+    });
+  } catch (_err) {
+  }
+}
+
+// src/cli.ts
+var program = new Command();
+program.name("gridstorm-codemod").description("Codemod CLI to migrate from AG Grid to GridStorm").version("0.1.0").argument("<path>", "Path to source directory or file to transform").option("--from <framework>", "Source framework", "ag-grid").option("--dry-run", "Show changes without writing files", false).option("--verbose", "Show detailed transformation logs", false).action(async (targetPath, options) => {
+  const resolvedPath = path.resolve(targetPath);
+  if (!fs.existsSync(resolvedPath)) {
+    console.error(chalk.red(`Error: Path "${resolvedPath}" does not exist.`));
+    process.exit(1);
+  }
+  if (options.from !== "ag-grid") {
+    console.error(chalk.red(`Error: Unsupported source framework "${options.from}". Only "ag-grid" is supported.`));
+    process.exit(1);
+  }
+  console.log(chalk.blue("\n  GridStorm Codemod"));
+  console.log(chalk.blue("  \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n"));
+  console.log(`  Source:    ${chalk.cyan(options.from)}`);
+  console.log(`  Path:      ${chalk.cyan(resolvedPath)}`);
+  console.log(`  Dry run:   ${options.dryRun ? chalk.yellow("yes") : "no"}`);
+  console.log("");
+  const files = await findSourceFiles(resolvedPath);
+  if (files.length === 0) {
+    console.log(chalk.yellow("  No source files found."));
+    process.exit(0);
+  }
+  console.log(`  Found ${chalk.cyan(String(files.length))} source file(s) to scan.
+`);
+  let totalChanged = 0;
+  let totalChanges = 0;
+  for (const filePath of files) {
+    const result = processFile(filePath, options);
+    if (result.changed) {
+      totalChanged++;
+      totalChanges += result.changes.length;
+      console.log(`  ${chalk.green("MODIFIED")} ${path.relative(resolvedPath, filePath)}`);
+      if (options.verbose) {
+        for (const change of result.changes) {
+          console.log(`    ${chalk.gray(">")} ${change}`);
+        }
+        console.log("");
+      }
+      if (!options.dryRun) {
+        fs.writeFileSync(filePath, result.transformed, "utf-8");
+      }
+    } else if (options.verbose) {
+      console.log(`  ${chalk.gray("SKIPPED")}  ${path.relative(resolvedPath, filePath)}`);
+    }
+  }
+  console.log("");
+  console.log(chalk.blue("  \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500"));
+  console.log(`  Files modified:  ${chalk.cyan(String(totalChanged))} / ${files.length}`);
+  console.log(`  Total changes:   ${chalk.cyan(String(totalChanges))}`);
+  if (options.dryRun) {
+    console.log(chalk.yellow("\n  Dry run mode \u2014 no files were written."));
+    console.log(chalk.yellow("  Run without --dry-run to apply changes.\n"));
+  } else {
+    console.log(chalk.green("\n  Migration complete.\n"));
+    console.log("  Next steps:");
+    console.log("  1. Review the changes and fix any manual migration items");
+    console.log("  2. Install GridStorm packages: npm install @gridstorm/core @gridstorm/react");
+    console.log("  3. Install plugins you need (e.g., @gridstorm/plugin-sorting)");
+    console.log("  4. Remove AG Grid packages: npm uninstall ag-grid-community ag-grid-react");
+    console.log("  5. Run your test suite to verify the migration");
+    console.log(`  6. See the full migration guide at ${chalk.cyan("https://gridstorm.dev/guides/migration-from-ag-grid")}
+`);
+  }
+});
+async function findSourceFiles(targetPath) {
+  const stat = fs.statSync(targetPath);
+  if (stat.isFile()) {
+    return [targetPath];
+  }
+  const pattern = "**/*.{ts,tsx,js,jsx,mjs,cjs}";
+  const files = await glob(pattern, {
+    cwd: targetPath,
+    absolute: true,
+    ignore: [
+      "**/node_modules/**",
+      "**/dist/**",
+      "**/build/**",
+      "**/.next/**",
+      "**/.nuxt/**",
+      "**/coverage/**"
+    ]
+  });
+  return files.sort();
+}
+function processFile(filePath, options) {
+  const original = fs.readFileSync(filePath, "utf-8");
+  if (!hasAgGridReferences(original)) {
+    return {
+      filePath,
+      changed: false,
+      original,
+      transformed: original,
+      changes: []
+    };
+  }
+  const { code: transformed, changes } = transformAgGridToGridStorm(original, filePath);
+  return {
+    filePath,
+    changed: transformed !== original,
+    original,
+    transformed,
+    changes
+  };
+}
+function hasAgGridReferences(source) {
+  return source.includes("ag-grid") || source.includes("AgGridReact") || source.includes("@ag-grid") || source.includes("ag-theme-");
+}
+program.parse();

package/package.json

@@ -0,0 +1,59 @@
+{
+  "name": "@gridstorm/codemod",
+  "version": "0.1.2",
+  "description": "Codemod CLI to migrate from AG Grid to GridStorm",
+  "type": "module",
+  "bin": {
+    "gridstorm-codemod": "./dist/cli.js"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch"
+  },
+  "files": [
+    "dist",
+    "LICENSE.md"
+  ],
+  "sideEffects": false,
+  "publishConfig": {
+    "access": "public"
+  },
+  "license": "MIT",
+  "keywords": [
+    "gridstorm",
+    "ag-grid",
+    "codemod",
+    "migration"
+  ],
+  "dependencies": {
+    "jscodeshift": "^17.0.0",
+    "glob": "^11.0.0",
+    "chalk": "^5.3.0",
+    "commander": "^12.0.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.5.0",
+    "tsup": "^8.5.0",
+    "@types/jscodeshift": "^0.12.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/007krcs/grid-data.git",
+    "directory": "packages/codemod"
+  },
+  "bugs": {
+    "url": "https://github.com/007krcs/grid-data/issues"
+  },
+  "homepage": "https://grid-data-analytics-explorer.vercel.app/",
+  "author": {
+    "name": "GridStorm",
+    "url": "https://grid-data-analytics-explorer.vercel.app/"
+  },
+  "funding": {
+    "type": "github",
+    "url": "https://github.com/sponsors/gridstorm"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}