@aurum-grid/migrate 0.0.0-stage → 0.2.0

package/LICENSE.md

@@ -0,0 +1,24 @@
+# Aurum Grid Commercial License (draft template)
+
+> This is a starting-point template, not legal advice. Have a lawyer review it before you sell licences.
+
+Copyright (c) 2026 the Aurum Grid authors. All rights reserved.
+
+## 1. Evaluation
+You may install and use Aurum Grid ("the Software") free of charge for **30 days** to evaluate it. During and after
+evaluation the Software runs unmodified; after 30 days without a valid licence key it displays an
+"unlicensed" watermark and console notice.
+
+## 2. Annual developer licence
+A licence costs **USD 50 per developer per year**. Each licensed developer may use the Software to build an
+unlimited number of applications and deploy them to an unlimited number of end users. The licence key must be
+renewed every year to keep receiving updates and to keep the watermark removed in newly built versions.
+
+## 3. Restrictions
+You may not: (a) redistribute the Software as a standalone component library or competing product;
+(b) remove, alter or circumvent the licence checks or watermark; (c) share licence keys between developers
+beyond the purchased seat count.
+
+## 4. No warranty
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR
+ANY CLAIM, DAMAGES OR OTHER LIABILITY ARISING FROM THE USE OF THE SOFTWARE.

package/README.md

@@ -1,3 +1,7 @@
-# Temporary Holding Version
+# @aurum-grid/migrate
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Aurum Grid migration codemods for AG Grid applications.
+
+Part of **Aurum Grid** — the enterprise data grid. See the main documentation: https://github.com/YOUR_ORG/aurum-grid#readme
+
+Licensing: 30-day evaluation, then $50 per developer per year. See LICENSE.md.

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/cli.js

@@ -0,0 +1,46 @@
+#!/usr/bin/env node
+import { readdirSync, readFileSync, statSync, writeFileSync } from 'node:fs';
+import { join, extname, relative } from 'node:path';
+import { migrateSource } from './index.js';
+const args = process.argv.slice(2);
+const write = args.includes('--write');
+const root = args.find((a) => !a.startsWith('--')) ?? '.';
+const EXT = new Set(['.ts', '.tsx', '.js', '.jsx', '.mjs', '.vue', '.css', '.scss']);
+const SKIP = new Set(['node_modules', 'dist', 'build', '.git', '.next', 'coverage']);
+function* walk(dir) {
+    for (const name of readdirSync(dir)) {
+        if (SKIP.has(name))
+            continue;
+        const p = join(dir, name);
+        const st = statSync(p);
+        if (st.isDirectory())
+            yield* walk(p);
+        else if (EXT.has(extname(name)))
+            yield p;
+    }
+}
+let files = 0;
+let changed = 0;
+let warns = 0;
+for (const file of statSync(root).isDirectory() ? walk(root) : [root]) {
+    files++;
+    const src = readFileSync(file, 'utf8');
+    if (!/ag-grid|AgGrid|ag-theme|gridOptions\.api|columnApi/.test(src))
+        continue;
+    const res = migrateSource(src);
+    const rel = relative(process.cwd(), file);
+    if (res.changed) {
+        changed++;
+        console.log(`\n${write ? '✔ updated' : '• would update'} ${rel}`);
+        for (const c of res.changes)
+            console.log(`  L${c.line}: ${c.before}\n     → ${c.after}`);
+        if (write)
+            writeFileSync(file, res.code);
+    }
+    for (const w of res.warnings) {
+        warns++;
+        console.log(`  ⚠ ${rel}:${w.line} ${w.message}`);
+    }
+}
+console.log(`\nScanned ${files} files · ${changed} ${write ? 'updated' : 'to update'} · ${warns} warnings${write ? '' : '\nRun again with --write to apply.'}`);
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Source-to-source migration from AG Grid to Aurum Grid.
+ * Conservative: rewrites imports and well-known identifiers, and reports
+ * anything that needs a human look instead of guessing.
+ */
+export interface MigrationChange {
+    line: number;
+    rule: string;
+    before: string;
+    after: string;
+}
+export interface MigrationWarning {
+    line: number;
+    message: string;
+}
+export interface MigrationResult {
+    code: string;
+    changes: MigrationChange[];
+    warnings: MigrationWarning[];
+    changed: boolean;
+}
+export declare function migrateSource(code: string): MigrationResult;

package/dist/index.js

@@ -0,0 +1,63 @@
+/**
+ * Source-to-source migration from AG Grid to Aurum Grid.
+ * Conservative: rewrites imports and well-known identifiers, and reports
+ * anything that needs a human look instead of guessing.
+ */
+const IMPORT_MAP = [
+    [/(['"])ag-grid-community\/styles\/ag-grid\.css\1/g, `$1@aurum-grid/core/styles.css$1`],
+    [/(['"])ag-grid-community\/styles\/ag-theme-[\w-]+\.css\1/g, `$1@aurum-grid/core/styles.css$1`],
+    [/(['"])@ag-grid-community\/(core|client-side-row-model|all-modules)\1/g, `$1@aurum-grid/core$1`],
+    [/(['"])@ag-grid-enterprise\/[\w-]+\1/g, `$1@aurum-grid/enterprise$1`],
+    [/(['"])ag-grid-community\1/g, `$1@aurum-grid/core$1`],
+    [/(['"])ag-grid-enterprise\1/g, `$1@aurum-grid/enterprise$1`],
+    [/(['"])ag-grid-react\1/g, `$1@aurum-grid/react$1`],
+    [/(['"])ag-grid-vue3\1/g, `$1@aurum-grid/vue$1`],
+    [/(['"])ag-charts-(community|enterprise)\1/g, `$1@aurum-grid/charts$1`],
+];
+const IDENT_MAP = [
+    [/\bAgGridReact\b/g, 'AurumGrid', 'react-component'],
+    [/\bAgGridVue\b/g, 'AurumGrid', 'vue-component'],
+    [/\bGridOptions\b/g, 'GridOptions', 'types'],
+    [/\bnew\s+Grid\s*\(/g, 'createGrid(', 'new-grid'],
+    [/\bgridOptions\.api\b/g, 'gridApi', 'grid-options-api'],
+    [/\bgridOptions\.columnApi\b/g, 'gridApi', 'column-api'],
+    [/\bcolumnApi\.(getColumnState|applyColumnState|setColumnVisible|setColumnsVisible|autoSizeAllColumns|autoSizeColumns|getAllDisplayedColumns)\b/g, 'gridApi.$1', 'column-api'],
+    [/\bsetColumnVisible\(\s*([^,]+),/g, 'setColumnsVisible([$1],', 'set-column-visible'],
+    [/\bsetQuickFilter\(/g, 'setQuickFilter(', 'quick-filter'],
+    [/\bag-theme-(alpine|quartz|balham|material)(-dark)?\b/g, 'aurum-grid-host', 'theme-class'],
+];
+const WARN_PATTERNS = [
+    [/\bModuleRegistry\.register(Modules)?\s*\(\s*\[?\s*(AllCommunityModule|ClientSideRowModelModule)/, 'Community modules are built in to @aurum-grid/core — this registration can be removed.'],
+    [/\bserverSideDatasource\b|\browModelType:\s*['"]serverSide['"]/, "Aurum Grid's server-side model is the infinite row model plus createServerSideDatasource(); server-side grouping is not yet supported."],
+    [/\bfillHandle\b|\benableFillHandle\b/, 'Fill handle is not supported yet.'],
+    [/\bframeworkComponents\b/, "Use `components` and the adapter's reactCellRenderer()/vueCellRenderer() wrappers."],
+    [/\bcellRendererFramework\b/, 'Wrap the component with reactCellRenderer(Component) and pass it as cellRenderer.'],
+    [/\benableCharts\b|\bcreateRangeChart\b/, 'Use @aurum-grid/charts createGridChart(grid, el, {...}) for integrated charts.'],
+    [/\bthemeQuartz\b|\bthemeAlpine\b|\bthemeBalham\b/, "Theming API objects aren't supported; pass theme: 'light' | 'dark' | 'material' | 'fluent' | 'bootstrap' | 'high-contrast' | 'aurum' | 'ivory'."],
+    [/\bLicenseManager\.setLicenseKey\b/, 'Aurum Grid also uses LicenseManager.setLicenseKey — replace the key with your Aurum Grid license key.'],
+];
+export function migrateSource(code) {
+    const changes = [];
+    const warnings = [];
+    const lines = code.split('\n');
+    const out = lines.map((line, idx) => {
+        let next = line;
+        for (const [re, rep] of IMPORT_MAP)
+            next = next.replace(re, rep);
+        for (const [re, rep] of IDENT_MAP)
+            next = next.replace(re, rep);
+        if (next !== line)
+            changes.push({ line: idx + 1, rule: 'rewrite', before: line.trim(), after: next.trim() });
+        for (const [re, msg] of WARN_PATTERNS)
+            if (re.test(line))
+                warnings.push({ line: idx + 1, message: msg });
+        return next;
+    });
+    let result = out.join('\n');
+    if (/\bcreateGrid\(/.test(result) && !/\bcreateGrid\b[^(]/.test(result.replace(/createGrid\(/g, '')) && !/import[^;]*\bcreateGrid\b/.test(result)) {
+        // `new Grid(...)` was rewritten: make sure createGrid is imported
+        result = result.replace(/import\s*\{([^}]*)\}\s*from\s*(['"])@aurum-grid\/core\2/, (m, names, q) => /\bcreateGrid\b/.test(names) ? m : `import {${names.replace(/\bGrid\b\s*,?/, '').trim() ? ` ${names.replace(/\bGrid\b\s*,?\s*/, '').trim()}, createGrid ` : ' createGrid '}} from ${q}@aurum-grid/core${q}`);
+    }
+    return { code: result, changes, warnings, changed: result !== code };
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/package.json

@@ -1,6 +1,34 @@
 {
   "name": "@aurum-grid/migrate",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.2.0",
+  "description": "Aurum Grid migration codemods for AG Grid applications.",
+  "license": "SEE LICENSE IN LICENSE.md",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "bin": {
+    "aurum-grid-migrate": "./dist/cli.js"
+  },
+  "files": [
+    "dist",
+    "LICENSE.md",
+    "README.md"
+  ],
+  "dependencies": {},
+  "devDependencies": {
+    "@types/node": "^22.8.6"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit"
+  }
 }