@motif-js/migrate 2.0.0

package/README.md

@@ -0,0 +1,66 @@
+# @motif-js/migrate
+
+> Codemod toolkit for motif-js.
+
+Rewrites v1 motif-js import specifiers to their v2 names in every file under a given path.
+
+## Use
+
+```sh
+# In your project root, with v1 imports:
+npx @motif-js/migrate rename-v2
+
+# Or point at a subtree:
+npx @motif-js/migrate rename-v2 src/
+
+# Preview without writing:
+npx @motif-js/migrate rename-v2 --dry-run
+```
+
+## What it does
+
+| Before                             | After               |
+| ---------------------------------- | ------------------- |
+| `@motif-js/react-web`              | `@motif-js/react`   |
+| `@motif-js/react` (aggregator)     | `motif-js`          |
+| `@motif-js/react-native`           | (unchanged)         |
+| `@motif-js/react/server`           | (unchanged subpath) |
+| `@motif-js/react/tanstack-virtual` | (unchanged subpath) |
+
+Covers every form an import specifier appears in:
+
+- `import { X } from '…'` (named, default, namespace, type-only)
+- `import('…')` (dynamic)
+- `require('…')` (CommonJS)
+- `dependencies` / `peerDependencies` / etc. keys in `package.json`
+- Code fences in `.md` / `.mdx`
+
+## Files scanned by default
+
+```
+**/*.{ts,tsx,js,jsx,mjs,cjs,md,mdx,json}
+```
+
+Skips: `node_modules`, `dist`, `.next`, `.vorge`, `.turbo`, `.cache`, `build`, `out`, `coverage`, `__visual__`.
+
+## Programmatic API
+
+```ts
+import { applyRenameV2, needsRenameV2 } from '@motif-js/migrate';
+
+const src = `import { Box } from '@motif-js/react-web';`;
+if (needsRenameV2(src)) {
+  const out = applyRenameV2(src);
+  // → `import { Box } from '@motif-js/react';`
+}
+```
+
+`applyRenameV2` is a string-in, string-out function. Pass any kind of file content — TypeScript, JavaScript, MDX, JSON — it matches import specifier strings, not parsed AST nodes.
+
+## Docs
+
+<https://usemotif.dev/migrating/v1-to-v2>
+
+## License
+
+[MIT](../../LICENSE)

package/bin/cli.js

@@ -0,0 +1,11 @@
+#!/usr/bin/env node
+import { argv, exit } from 'node:process';
+import { main } from '../dist/cli.js';
+
+main(argv.slice(2)).then(
+  (code) => exit(code),
+  (err) => {
+    process.stderr.write(`${err instanceof Error ? (err.stack ?? err.message) : String(err)}\n`);
+    exit(1);
+  },
+);

package/dist/chunk-SSSWTBUF.js

@@ -0,0 +1,16 @@
+// src/transforms/rename-v2.ts
+var SOURCE_PATTERN = /@motif-js\/react-web|@motif-js\/react(?![-\w/])/g;
+function replaceSource(match) {
+  if (match === "@motif-js/react-web") return "@motif-js/react";
+  return "motif-js";
+}
+function applyRenameV2(source) {
+  return source.replace(SOURCE_PATTERN, replaceSource);
+}
+function needsRenameV2(source) {
+  return /@motif-js\/react-web|@motif-js\/react(?![-\w/])/.test(source);
+}
+
+export { applyRenameV2, needsRenameV2 };
+//# sourceMappingURL=chunk-SSSWTBUF.js.map
+//# sourceMappingURL=chunk-SSSWTBUF.js.map

package/dist/chunk-SSSWTBUF.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/transforms/rename-v2.ts"],"names":[],"mappings":";AA8CA,IAAM,cAAA,GAAiB,kDAAA;AAEvB,SAAS,cAAc,KAAA,EAAuB;AAC5C,EAAA,IAAI,KAAA,KAAU,uBAAuB,OAAO,iBAAA;AAG5C,EAAA,OAAO,UAAA;AACT;AAgBO,SAAS,cAAc,MAAA,EAAwB;AACpD,EAAA,OAAO,MAAA,CAAO,OAAA,CAAQ,cAAA,EAAgB,aAAa,CAAA;AACrD;AAOO,SAAS,cAAc,MAAA,EAAyB;AAIrD,EAAA,OAAO,iDAAA,CAAkD,KAAK,MAAM,CAAA;AACtE","file":"chunk-SSSWTBUF.js","sourcesContent":["/**\n * `rename-v2` codemod: rewrite v1 motif-js import specifiers to their\n * v2 names.\n *\n * | v1                       | v2                  |\n * |--------------------------|---------------------|\n * | `@motif-js/react-web`    | `@motif-js/react`   |\n * | `@motif-js/react`        | `motif-js`          |\n * | `@motif-js/react-native` | `@motif-js/react-native` (unchanged) |\n *\n * Touches only **import specifier strings** inside source files —\n * import statements, `require()` calls, dynamic `import()`, and the\n * dependency keys of `package.json`. Comments and string literals\n * elsewhere are left alone.\n *\n * ## Sequencing trap\n *\n * The two rewrites overlap. If we naively replace `@motif-js/react` →\n * `motif-js` first, then `@motif-js/react-web` → `@motif-js/react`,\n * the first pass already destroyed every `@motif-js/react` occurrence\n * — including the `@motif-js/react` part of `@motif-js/react-web`,\n * leaving garbage like `motif-js-web`.\n *\n * The safe order is the opposite: `@motif-js/react-web` →\n * `@motif-js/react` FIRST, then `@motif-js/react` → `motif-js`. After\n * step one, every occurrence of `@motif-js/react` in the file refers\n * to the v2 DOM bindings (just renamed from react-web), and step two\n * can safely promote any *other* `@motif-js/react` references (the\n * v1 aggregator) up to `motif-js`.\n *\n * That's still wrong, because step two would clobber the\n * just-renamed `@motif-js/react` references too. So in practice we\n * use a one-pass single regex with alternation that matches whichever\n * of the two source names appears at the call site:\n *\n *   /@motif-js\\/react-web|@motif-js\\/react(?![-\\w/])/g\n *\n * — for each match, decide the replacement based on the matched text.\n * react-web → @motif-js/react, bare react → motif-js. The negative\n * lookahead `(?![-\\w/])` on the bare-react branch ensures we don't\n * catch react-web / react-native / react-foo (the `-` exclusion) or\n * the `@motif-js/react/server` and `@motif-js/react/tanstack-virtual`\n * subpaths (the `/` exclusion). Those subpath exports still belong\n * to the renamed DOM bindings package and must survive untouched.\n */\n\nconst SOURCE_PATTERN = /@motif-js\\/react-web|@motif-js\\/react(?![-\\w/])/g;\n\nfunction replaceSource(match: string): string {\n  if (match === '@motif-js/react-web') return '@motif-js/react';\n  // The other branch of the alternation. Anchored with negative\n  // lookahead so it can only be the bare aggregator name.\n  return 'motif-js';\n}\n\n/**\n * Apply the rename-v2 transform to a source string. The matching is\n * applied to the **entire** text, regardless of file kind — that's\n * intentional. Import-specifier strings have a unique enough shape\n * (the leading `@motif-js/` namespace) that false positives in prose\n * are rare. For `.md` / `.mdx` / `.json` files this lets the same\n * transform handle install snippets, code fences, and the\n * `dependencies` keys of package.json without separate parsers.\n *\n * If the input is `package.json`, sub-path imports like\n * `@motif-js/react/server` survive (the lookahead spares them) — the\n * `/server` and `/tanstack-virtual` exports still belong to the\n * renamed DOM bindings package.\n */\nexport function applyRenameV2(source: string): string {\n  return source.replace(SOURCE_PATTERN, replaceSource);\n}\n\n/**\n * Convenience predicate: does the source contain anything the\n * transform would change? Used to skip the write step for unaffected\n * files (saves filesystem churn + leaves mtimes alone).\n */\nexport function needsRenameV2(source: string): boolean {\n  // `SOURCE_PATTERN` is `g`-flagged, so reuse via `.test()` would mutate\n  // its `.lastIndex` and corrupt later calls. Build a fresh non-global\n  // regex per check.\n  return /@motif-js\\/react-web|@motif-js\\/react(?![-\\w/])/.test(source);\n}\n"]}

package/dist/cli.cjs

@@ -0,0 +1,131 @@
+#!/usr/bin/env node
+'use strict';
+
+var promises = require('fs/promises');
+var path = require('path');
+var process = require('process');
+var fg = require('fast-glob');
+
+function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
+
+var fg__default = /*#__PURE__*/_interopDefault(fg);
+
+// src/transforms/rename-v2.ts
+var SOURCE_PATTERN = /@motif-js\/react-web|@motif-js\/react(?![-\w/])/g;
+function replaceSource(match) {
+  if (match === "@motif-js/react-web") return "@motif-js/react";
+  return "motif-js";
+}
+function applyRenameV2(source) {
+  return source.replace(SOURCE_PATTERN, replaceSource);
+}
+function needsRenameV2(source) {
+  return /@motif-js\/react-web|@motif-js\/react(?![-\w/])/.test(source);
+}
+
+// src/cli.ts
+var DEFAULT_GLOBS = [
+  "**/*.{ts,tsx,js,jsx,mjs,cjs,md,mdx,json}",
+  "!**/node_modules/**",
+  "!**/dist/**",
+  "!**/.next/**",
+  "!**/.vorge/**",
+  "!**/.turbo/**",
+  "!**/.cache/**",
+  "!**/build/**",
+  "!**/out/**",
+  "!**/coverage/**",
+  "!**/__visual__/**"
+];
+var HELP = `motif-js-migrate \u2014 codemod toolkit for motif-js
+
+Usage:
+  motif-js-migrate rename-v2 [path]   Rewrite v1 motif-js import specifiers
+                                      to their v2 names in every file under
+                                      [path] (default: cwd).
+  motif-js-migrate --help             Show this message.
+
+Flags:
+  --dry-run     Print the files that would change without writing them.
+
+Rename map:
+  @motif-js/react-web    \u2192  @motif-js/react
+  @motif-js/react        \u2192  motif-js
+  @motif-js/react-native \u2192  (unchanged)
+
+Subpath imports (@motif-js/react/server, @motif-js/react/tanstack-virtual)
+stay on @motif-js/react.
+`;
+function parseArgs(argv) {
+  let command = null;
+  let path = ".";
+  let dryRun = false;
+  let help = false;
+  let positionalIndex = 0;
+  for (const arg of argv) {
+    if (arg === "--help" || arg === "-h") {
+      help = true;
+    } else if (arg === "--dry-run") {
+      dryRun = true;
+    } else if (arg.startsWith("--")) {
+      process.stderr.write(`unknown flag: ${arg}
+`);
+      process.exit(2);
+    } else if (positionalIndex === 0) {
+      command = arg;
+      positionalIndex++;
+    } else if (positionalIndex === 1) {
+      path = arg;
+      positionalIndex++;
+    } else {
+      process.stderr.write(`unexpected positional argument: ${arg}
+`);
+      process.exit(2);
+    }
+  }
+  return { command, path, dryRun, help };
+}
+async function runRenameV2(rootArg, dryRun) {
+  const root = path.resolve(rootArg);
+  const files = await fg__default.default(DEFAULT_GLOBS, { cwd: root, absolute: true, dot: false });
+  let changed = 0;
+  for (const absPath of files) {
+    const src = await promises.readFile(absPath, "utf8");
+    if (!needsRenameV2(src)) continue;
+    const out = applyRenameV2(src);
+    if (out === src) continue;
+    const rel = path.relative(root, absPath);
+    if (dryRun) {
+      process.stdout.write(`would change: ${rel}
+`);
+    } else {
+      await promises.writeFile(absPath, out, "utf8");
+      process.stdout.write(`changed: ${rel}
+`);
+    }
+    changed++;
+  }
+  process.stdout.write(
+    `${dryRun ? "would change" : "changed"} ${changed} file${changed === 1 ? "" : "s"}.
+`
+  );
+  return 0;
+}
+async function main(argv) {
+  const args = parseArgs(argv);
+  if (args.help || args.command === null) {
+    process.stdout.write(HELP);
+    return 0;
+  }
+  if (args.command === "rename-v2") {
+    return runRenameV2(args.path, args.dryRun);
+  }
+  process.stderr.write(`unknown command: ${args.command}
+`);
+  process.stderr.write(HELP);
+  return 2;
+}
+
+exports.main = main;
+//# sourceMappingURL=cli.cjs.map
+//# sourceMappingURL=cli.cjs.map

package/dist/cli.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/transforms/rename-v2.ts","../src/cli.ts"],"names":["stderr","exit","resolve","fg","readFile","relative","stdout","writeFile"],"mappings":"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","file":"cli.cjs","sourcesContent":["/**\n * `rename-v2` codemod: rewrite v1 motif-js import specifiers to their\n * v2 names.\n *\n * | v1                       | v2                  |\n * |--------------------------|---------------------|\n * | `@motif-js/react-web`    | `@motif-js/react`   |\n * | `@motif-js/react`        | `motif-js`          |\n * | `@motif-js/react-native` | `@motif-js/react-native` (unchanged) |\n *\n * Touches only **import specifier strings** inside source files —\n * import statements, `require()` calls, dynamic `import()`, and the\n * dependency keys of `package.json`. Comments and string literals\n * elsewhere are left alone.\n *\n * ## Sequencing trap\n *\n * The two rewrites overlap. If we naively replace `@motif-js/react` →\n * `motif-js` first, then `@motif-js/react-web` → `@motif-js/react`,\n * the first pass already destroyed every `@motif-js/react` occurrence\n * — including the `@motif-js/react` part of `@motif-js/react-web`,\n * leaving garbage like `motif-js-web`.\n *\n * The safe order is the opposite: `@motif-js/react-web` →\n * `@motif-js/react` FIRST, then `@motif-js/react` → `motif-js`. After\n * step one, every occurrence of `@motif-js/react` in the file refers\n * to the v2 DOM bindings (just renamed from react-web), and step two\n * can safely promote any *other* `@motif-js/react` references (the\n * v1 aggregator) up to `motif-js`.\n *\n * That's still wrong, because step two would clobber the\n * just-renamed `@motif-js/react` references too. So in practice we\n * use a one-pass single regex with alternation that matches whichever\n * of the two source names appears at the call site:\n *\n *   /@motif-js\\/react-web|@motif-js\\/react(?![-\\w/])/g\n *\n * — for each match, decide the replacement based on the matched text.\n * react-web → @motif-js/react, bare react → motif-js. The negative\n * lookahead `(?![-\\w/])` on the bare-react branch ensures we don't\n * catch react-web / react-native / react-foo (the `-` exclusion) or\n * the `@motif-js/react/server` and `@motif-js/react/tanstack-virtual`\n * subpaths (the `/` exclusion). Those subpath exports still belong\n * to the renamed DOM bindings package and must survive untouched.\n */\n\nconst SOURCE_PATTERN = /@motif-js\\/react-web|@motif-js\\/react(?![-\\w/])/g;\n\nfunction replaceSource(match: string): string {\n  if (match === '@motif-js/react-web') return '@motif-js/react';\n  // The other branch of the alternation. Anchored with negative\n  // lookahead so it can only be the bare aggregator name.\n  return 'motif-js';\n}\n\n/**\n * Apply the rename-v2 transform to a source string. The matching is\n * applied to the **entire** text, regardless of file kind — that's\n * intentional. Import-specifier strings have a unique enough shape\n * (the leading `@motif-js/` namespace) that false positives in prose\n * are rare. For `.md` / `.mdx` / `.json` files this lets the same\n * transform handle install snippets, code fences, and the\n * `dependencies` keys of package.json without separate parsers.\n *\n * If the input is `package.json`, sub-path imports like\n * `@motif-js/react/server` survive (the lookahead spares them) — the\n * `/server` and `/tanstack-virtual` exports still belong to the\n * renamed DOM bindings package.\n */\nexport function applyRenameV2(source: string): string {\n  return source.replace(SOURCE_PATTERN, replaceSource);\n}\n\n/**\n * Convenience predicate: does the source contain anything the\n * transform would change? Used to skip the write step for unaffected\n * files (saves filesystem churn + leaves mtimes alone).\n */\nexport function needsRenameV2(source: string): boolean {\n  // `SOURCE_PATTERN` is `g`-flagged, so reuse via `.test()` would mutate\n  // its `.lastIndex` and corrupt later calls. Build a fresh non-global\n  // regex per check.\n  return /@motif-js\\/react-web|@motif-js\\/react(?![-\\w/])/.test(source);\n}\n","#!/usr/bin/env node\n/**\n * `motif-js-migrate` CLI.\n *\n * Usage:\n *   motif-js-migrate rename-v2 [path] [--dry-run]\n *   motif-js-migrate --help\n *\n * Default path is the current working directory. The transform walks\n * matching files via fast-glob, applies `applyRenameV2`, and writes\n * back any file whose content changed.\n */\n\nimport { readFile, writeFile } from 'node:fs/promises';\nimport { relative, resolve } from 'node:path';\nimport { exit, stderr, stdout } from 'node:process';\nimport fg from 'fast-glob';\nimport { applyRenameV2, needsRenameV2 } from './transforms/rename-v2.js';\n\ninterface ParsedArgs {\n  readonly command: string | null;\n  readonly path: string;\n  readonly dryRun: boolean;\n  readonly help: boolean;\n}\n\nconst DEFAULT_GLOBS: string[] = [\n  '**/*.{ts,tsx,js,jsx,mjs,cjs,md,mdx,json}',\n  '!**/node_modules/**',\n  '!**/dist/**',\n  '!**/.next/**',\n  '!**/.vorge/**',\n  '!**/.turbo/**',\n  '!**/.cache/**',\n  '!**/build/**',\n  '!**/out/**',\n  '!**/coverage/**',\n  '!**/__visual__/**',\n];\n\nconst HELP = `motif-js-migrate — codemod toolkit for motif-js\n\nUsage:\n  motif-js-migrate rename-v2 [path]   Rewrite v1 motif-js import specifiers\n                                      to their v2 names in every file under\n                                      [path] (default: cwd).\n  motif-js-migrate --help             Show this message.\n\nFlags:\n  --dry-run     Print the files that would change without writing them.\n\nRename map:\n  @motif-js/react-web    →  @motif-js/react\n  @motif-js/react        →  motif-js\n  @motif-js/react-native →  (unchanged)\n\nSubpath imports (@motif-js/react/server, @motif-js/react/tanstack-virtual)\nstay on @motif-js/react.\n`;\n\nfunction parseArgs(argv: readonly string[]): ParsedArgs {\n  let command: string | null = null;\n  let path = '.';\n  let dryRun = false;\n  let help = false;\n  let positionalIndex = 0;\n  for (const arg of argv) {\n    if (arg === '--help' || arg === '-h') {\n      help = true;\n    } else if (arg === '--dry-run') {\n      dryRun = true;\n    } else if (arg.startsWith('--')) {\n      stderr.write(`unknown flag: ${arg}\\n`);\n      exit(2);\n    } else if (positionalIndex === 0) {\n      command = arg;\n      positionalIndex++;\n    } else if (positionalIndex === 1) {\n      path = arg;\n      positionalIndex++;\n    } else {\n      stderr.write(`unexpected positional argument: ${arg}\\n`);\n      exit(2);\n    }\n  }\n  return { command, path, dryRun, help };\n}\n\nasync function runRenameV2(rootArg: string, dryRun: boolean): Promise<number> {\n  const root = resolve(rootArg);\n  const files = await fg(DEFAULT_GLOBS, { cwd: root, absolute: true, dot: false });\n  let changed = 0;\n  for (const absPath of files) {\n    const src = await readFile(absPath, 'utf8');\n    if (!needsRenameV2(src)) continue;\n    const out = applyRenameV2(src);\n    if (out === src) continue;\n    const rel = relative(root, absPath);\n    if (dryRun) {\n      stdout.write(`would change: ${rel}\\n`);\n    } else {\n      await writeFile(absPath, out, 'utf8');\n      stdout.write(`changed: ${rel}\\n`);\n    }\n    changed++;\n  }\n  stdout.write(\n    `${dryRun ? 'would change' : 'changed'} ${changed} file${changed === 1 ? '' : 's'}.\\n`,\n  );\n  return 0;\n}\n\nexport async function main(argv: readonly string[]): Promise<number> {\n  const args = parseArgs(argv);\n  if (args.help || args.command === null) {\n    stdout.write(HELP);\n    return 0;\n  }\n  if (args.command === 'rename-v2') {\n    return runRenameV2(args.path, args.dryRun);\n  }\n  stderr.write(`unknown command: ${args.command}\\n`);\n  stderr.write(HELP);\n  return 2;\n}\n"]}

package/dist/cli.d.cts

@@ -0,0 +1,15 @@
+#!/usr/bin/env node
+/**
+ * `motif-js-migrate` CLI.
+ *
+ * Usage:
+ *   motif-js-migrate rename-v2 [path] [--dry-run]
+ *   motif-js-migrate --help
+ *
+ * Default path is the current working directory. The transform walks
+ * matching files via fast-glob, applies `applyRenameV2`, and writes
+ * back any file whose content changed.
+ */
+declare function main(argv: readonly string[]): Promise<number>;
+
+export { main };

package/dist/cli.d.ts

@@ -0,0 +1,15 @@
+#!/usr/bin/env node
+/**
+ * `motif-js-migrate` CLI.
+ *
+ * Usage:
+ *   motif-js-migrate rename-v2 [path] [--dry-run]
+ *   motif-js-migrate --help
+ *
+ * Default path is the current working directory. The transform walks
+ * matching files via fast-glob, applies `applyRenameV2`, and writes
+ * back any file whose content changed.
+ */
+declare function main(argv: readonly string[]): Promise<number>;
+
+export { main };

package/dist/cli.js

@@ -0,0 +1,112 @@
+#!/usr/bin/env node
+import { needsRenameV2, applyRenameV2 } from './chunk-SSSWTBUF.js';
+import { readFile, writeFile } from 'fs/promises';
+import { resolve, relative } from 'path';
+import { stdout, stderr, exit } from 'process';
+import fg from 'fast-glob';
+
+var DEFAULT_GLOBS = [
+  "**/*.{ts,tsx,js,jsx,mjs,cjs,md,mdx,json}",
+  "!**/node_modules/**",
+  "!**/dist/**",
+  "!**/.next/**",
+  "!**/.vorge/**",
+  "!**/.turbo/**",
+  "!**/.cache/**",
+  "!**/build/**",
+  "!**/out/**",
+  "!**/coverage/**",
+  "!**/__visual__/**"
+];
+var HELP = `motif-js-migrate \u2014 codemod toolkit for motif-js
+
+Usage:
+  motif-js-migrate rename-v2 [path]   Rewrite v1 motif-js import specifiers
+                                      to their v2 names in every file under
+                                      [path] (default: cwd).
+  motif-js-migrate --help             Show this message.
+
+Flags:
+  --dry-run     Print the files that would change without writing them.
+
+Rename map:
+  @motif-js/react-web    \u2192  @motif-js/react
+  @motif-js/react        \u2192  motif-js
+  @motif-js/react-native \u2192  (unchanged)
+
+Subpath imports (@motif-js/react/server, @motif-js/react/tanstack-virtual)
+stay on @motif-js/react.
+`;
+function parseArgs(argv) {
+  let command = null;
+  let path = ".";
+  let dryRun = false;
+  let help = false;
+  let positionalIndex = 0;
+  for (const arg of argv) {
+    if (arg === "--help" || arg === "-h") {
+      help = true;
+    } else if (arg === "--dry-run") {
+      dryRun = true;
+    } else if (arg.startsWith("--")) {
+      stderr.write(`unknown flag: ${arg}
+`);
+      exit(2);
+    } else if (positionalIndex === 0) {
+      command = arg;
+      positionalIndex++;
+    } else if (positionalIndex === 1) {
+      path = arg;
+      positionalIndex++;
+    } else {
+      stderr.write(`unexpected positional argument: ${arg}
+`);
+      exit(2);
+    }
+  }
+  return { command, path, dryRun, help };
+}
+async function runRenameV2(rootArg, dryRun) {
+  const root = resolve(rootArg);
+  const files = await fg(DEFAULT_GLOBS, { cwd: root, absolute: true, dot: false });
+  let changed = 0;
+  for (const absPath of files) {
+    const src = await readFile(absPath, "utf8");
+    if (!needsRenameV2(src)) continue;
+    const out = applyRenameV2(src);
+    if (out === src) continue;
+    const rel = relative(root, absPath);
+    if (dryRun) {
+      stdout.write(`would change: ${rel}
+`);
+    } else {
+      await writeFile(absPath, out, "utf8");
+      stdout.write(`changed: ${rel}
+`);
+    }
+    changed++;
+  }
+  stdout.write(
+    `${dryRun ? "would change" : "changed"} ${changed} file${changed === 1 ? "" : "s"}.
+`
+  );
+  return 0;
+}
+async function main(argv) {
+  const args = parseArgs(argv);
+  if (args.help || args.command === null) {
+    stdout.write(HELP);
+    return 0;
+  }
+  if (args.command === "rename-v2") {
+    return runRenameV2(args.path, args.dryRun);
+  }
+  stderr.write(`unknown command: ${args.command}
+`);
+  stderr.write(HELP);
+  return 2;
+}
+
+export { main };
+//# sourceMappingURL=cli.js.map
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/cli.ts"],"names":[],"mappings":"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","file":"cli.js","sourcesContent":["#!/usr/bin/env node\n/**\n * `motif-js-migrate` CLI.\n *\n * Usage:\n *   motif-js-migrate rename-v2 [path] [--dry-run]\n *   motif-js-migrate --help\n *\n * Default path is the current working directory. The transform walks\n * matching files via fast-glob, applies `applyRenameV2`, and writes\n * back any file whose content changed.\n */\n\nimport { readFile, writeFile } from 'node:fs/promises';\nimport { relative, resolve } from 'node:path';\nimport { exit, stderr, stdout } from 'node:process';\nimport fg from 'fast-glob';\nimport { applyRenameV2, needsRenameV2 } from './transforms/rename-v2.js';\n\ninterface ParsedArgs {\n  readonly command: string | null;\n  readonly path: string;\n  readonly dryRun: boolean;\n  readonly help: boolean;\n}\n\nconst DEFAULT_GLOBS: string[] = [\n  '**/*.{ts,tsx,js,jsx,mjs,cjs,md,mdx,json}',\n  '!**/node_modules/**',\n  '!**/dist/**',\n  '!**/.next/**',\n  '!**/.vorge/**',\n  '!**/.turbo/**',\n  '!**/.cache/**',\n  '!**/build/**',\n  '!**/out/**',\n  '!**/coverage/**',\n  '!**/__visual__/**',\n];\n\nconst HELP = `motif-js-migrate — codemod toolkit for motif-js\n\nUsage:\n  motif-js-migrate rename-v2 [path]   Rewrite v1 motif-js import specifiers\n                                      to their v2 names in every file under\n                                      [path] (default: cwd).\n  motif-js-migrate --help             Show this message.\n\nFlags:\n  --dry-run     Print the files that would change without writing them.\n\nRename map:\n  @motif-js/react-web    →  @motif-js/react\n  @motif-js/react        →  motif-js\n  @motif-js/react-native →  (unchanged)\n\nSubpath imports (@motif-js/react/server, @motif-js/react/tanstack-virtual)\nstay on @motif-js/react.\n`;\n\nfunction parseArgs(argv: readonly string[]): ParsedArgs {\n  let command: string | null = null;\n  let path = '.';\n  let dryRun = false;\n  let help = false;\n  let positionalIndex = 0;\n  for (const arg of argv) {\n    if (arg === '--help' || arg === '-h') {\n      help = true;\n    } else if (arg === '--dry-run') {\n      dryRun = true;\n    } else if (arg.startsWith('--')) {\n      stderr.write(`unknown flag: ${arg}\\n`);\n      exit(2);\n    } else if (positionalIndex === 0) {\n      command = arg;\n      positionalIndex++;\n    } else if (positionalIndex === 1) {\n      path = arg;\n      positionalIndex++;\n    } else {\n      stderr.write(`unexpected positional argument: ${arg}\\n`);\n      exit(2);\n    }\n  }\n  return { command, path, dryRun, help };\n}\n\nasync function runRenameV2(rootArg: string, dryRun: boolean): Promise<number> {\n  const root = resolve(rootArg);\n  const files = await fg(DEFAULT_GLOBS, { cwd: root, absolute: true, dot: false });\n  let changed = 0;\n  for (const absPath of files) {\n    const src = await readFile(absPath, 'utf8');\n    if (!needsRenameV2(src)) continue;\n    const out = applyRenameV2(src);\n    if (out === src) continue;\n    const rel = relative(root, absPath);\n    if (dryRun) {\n      stdout.write(`would change: ${rel}\\n`);\n    } else {\n      await writeFile(absPath, out, 'utf8');\n      stdout.write(`changed: ${rel}\\n`);\n    }\n    changed++;\n  }\n  stdout.write(\n    `${dryRun ? 'would change' : 'changed'} ${changed} file${changed === 1 ? '' : 's'}.\\n`,\n  );\n  return 0;\n}\n\nexport async function main(argv: readonly string[]): Promise<number> {\n  const args = parseArgs(argv);\n  if (args.help || args.command === null) {\n    stdout.write(HELP);\n    return 0;\n  }\n  if (args.command === 'rename-v2') {\n    return runRenameV2(args.path, args.dryRun);\n  }\n  stderr.write(`unknown command: ${args.command}\\n`);\n  stderr.write(HELP);\n  return 2;\n}\n"]}

package/dist/index.cjs

@@ -0,0 +1,23 @@
+'use strict';
+
+// src/transforms/rename-v2.ts
+var SOURCE_PATTERN = /@motif-js\/react-web|@motif-js\/react(?![-\w/])/g;
+function replaceSource(match) {
+  if (match === "@motif-js/react-web") return "@motif-js/react";
+  return "motif-js";
+}
+function applyRenameV2(source) {
+  return source.replace(SOURCE_PATTERN, replaceSource);
+}
+function needsRenameV2(source) {
+  return /@motif-js\/react-web|@motif-js\/react(?![-\w/])/.test(source);
+}
+
+// src/index.ts
+var PACKAGE_NAME = "@motif-js/migrate";
+
+exports.PACKAGE_NAME = PACKAGE_NAME;
+exports.applyRenameV2 = applyRenameV2;
+exports.needsRenameV2 = needsRenameV2;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/transforms/rename-v2.ts","../src/index.ts"],"names":[],"mappings":";;;AA8CA,IAAM,cAAA,GAAiB,kDAAA;AAEvB,SAAS,cAAc,KAAA,EAAuB;AAC5C,EAAA,IAAI,KAAA,KAAU,uBAAuB,OAAO,iBAAA;AAG5C,EAAA,OAAO,UAAA;AACT;AAgBO,SAAS,cAAc,MAAA,EAAwB;AACpD,EAAA,OAAO,MAAA,CAAO,OAAA,CAAQ,cAAA,EAAgB,aAAa,CAAA;AACrD;AAOO,SAAS,cAAc,MAAA,EAAyB;AAIrD,EAAA,OAAO,iDAAA,CAAkD,KAAK,MAAM,CAAA;AACtE;;;AC3EO,IAAM,YAAA,GAAe","file":"index.cjs","sourcesContent":["/**\n * `rename-v2` codemod: rewrite v1 motif-js import specifiers to their\n * v2 names.\n *\n * | v1                       | v2                  |\n * |--------------------------|---------------------|\n * | `@motif-js/react-web`    | `@motif-js/react`   |\n * | `@motif-js/react`        | `motif-js`          |\n * | `@motif-js/react-native` | `@motif-js/react-native` (unchanged) |\n *\n * Touches only **import specifier strings** inside source files —\n * import statements, `require()` calls, dynamic `import()`, and the\n * dependency keys of `package.json`. Comments and string literals\n * elsewhere are left alone.\n *\n * ## Sequencing trap\n *\n * The two rewrites overlap. If we naively replace `@motif-js/react` →\n * `motif-js` first, then `@motif-js/react-web` → `@motif-js/react`,\n * the first pass already destroyed every `@motif-js/react` occurrence\n * — including the `@motif-js/react` part of `@motif-js/react-web`,\n * leaving garbage like `motif-js-web`.\n *\n * The safe order is the opposite: `@motif-js/react-web` →\n * `@motif-js/react` FIRST, then `@motif-js/react` → `motif-js`. After\n * step one, every occurrence of `@motif-js/react` in the file refers\n * to the v2 DOM bindings (just renamed from react-web), and step two\n * can safely promote any *other* `@motif-js/react` references (the\n * v1 aggregator) up to `motif-js`.\n *\n * That's still wrong, because step two would clobber the\n * just-renamed `@motif-js/react` references too. So in practice we\n * use a one-pass single regex with alternation that matches whichever\n * of the two source names appears at the call site:\n *\n *   /@motif-js\\/react-web|@motif-js\\/react(?![-\\w/])/g\n *\n * — for each match, decide the replacement based on the matched text.\n * react-web → @motif-js/react, bare react → motif-js. The negative\n * lookahead `(?![-\\w/])` on the bare-react branch ensures we don't\n * catch react-web / react-native / react-foo (the `-` exclusion) or\n * the `@motif-js/react/server` and `@motif-js/react/tanstack-virtual`\n * subpaths (the `/` exclusion). Those subpath exports still belong\n * to the renamed DOM bindings package and must survive untouched.\n */\n\nconst SOURCE_PATTERN = /@motif-js\\/react-web|@motif-js\\/react(?![-\\w/])/g;\n\nfunction replaceSource(match: string): string {\n  if (match === '@motif-js/react-web') return '@motif-js/react';\n  // The other branch of the alternation. Anchored with negative\n  // lookahead so it can only be the bare aggregator name.\n  return 'motif-js';\n}\n\n/**\n * Apply the rename-v2 transform to a source string. The matching is\n * applied to the **entire** text, regardless of file kind — that's\n * intentional. Import-specifier strings have a unique enough shape\n * (the leading `@motif-js/` namespace) that false positives in prose\n * are rare. For `.md` / `.mdx` / `.json` files this lets the same\n * transform handle install snippets, code fences, and the\n * `dependencies` keys of package.json without separate parsers.\n *\n * If the input is `package.json`, sub-path imports like\n * `@motif-js/react/server` survive (the lookahead spares them) — the\n * `/server` and `/tanstack-virtual` exports still belong to the\n * renamed DOM bindings package.\n */\nexport function applyRenameV2(source: string): string {\n  return source.replace(SOURCE_PATTERN, replaceSource);\n}\n\n/**\n * Convenience predicate: does the source contain anything the\n * transform would change? Used to skip the write step for unaffected\n * files (saves filesystem churn + leaves mtimes alone).\n */\nexport function needsRenameV2(source: string): boolean {\n  // `SOURCE_PATTERN` is `g`-flagged, so reuse via `.test()` would mutate\n  // its `.lastIndex` and corrupt later calls. Build a fresh non-global\n  // regex per check.\n  return /@motif-js\\/react-web|@motif-js\\/react(?![-\\w/])/.test(source);\n}\n","/**\n * @motif-js/migrate — codemod toolkit for motif-js.\n *\n * Programmatic API. The CLI in `./cli.ts` is the primary surface for\n * end users; this module is the importable shape for anyone running\n * the transforms from their own tooling.\n */\n\nexport const PACKAGE_NAME = '@motif-js/migrate';\n\nexport { applyRenameV2, needsRenameV2 } from './transforms/rename-v2.js';\n"]}

package/dist/index.d.cts

@@ -0,0 +1,77 @@
+/**
+ * `rename-v2` codemod: rewrite v1 motif-js import specifiers to their
+ * v2 names.
+ *
+ * | v1                       | v2                  |
+ * |--------------------------|---------------------|
+ * | `@motif-js/react-web`    | `@motif-js/react`   |
+ * | `@motif-js/react`        | `motif-js`          |
+ * | `@motif-js/react-native` | `@motif-js/react-native` (unchanged) |
+ *
+ * Touches only **import specifier strings** inside source files —
+ * import statements, `require()` calls, dynamic `import()`, and the
+ * dependency keys of `package.json`. Comments and string literals
+ * elsewhere are left alone.
+ *
+ * ## Sequencing trap
+ *
+ * The two rewrites overlap. If we naively replace `@motif-js/react` →
+ * `motif-js` first, then `@motif-js/react-web` → `@motif-js/react`,
+ * the first pass already destroyed every `@motif-js/react` occurrence
+ * — including the `@motif-js/react` part of `@motif-js/react-web`,
+ * leaving garbage like `motif-js-web`.
+ *
+ * The safe order is the opposite: `@motif-js/react-web` →
+ * `@motif-js/react` FIRST, then `@motif-js/react` → `motif-js`. After
+ * step one, every occurrence of `@motif-js/react` in the file refers
+ * to the v2 DOM bindings (just renamed from react-web), and step two
+ * can safely promote any *other* `@motif-js/react` references (the
+ * v1 aggregator) up to `motif-js`.
+ *
+ * That's still wrong, because step two would clobber the
+ * just-renamed `@motif-js/react` references too. So in practice we
+ * use a one-pass single regex with alternation that matches whichever
+ * of the two source names appears at the call site:
+ *
+ *   /@motif-js\/react-web|@motif-js\/react(?![-\w/])/g
+ *
+ * — for each match, decide the replacement based on the matched text.
+ * react-web → @motif-js/react, bare react → motif-js. The negative
+ * lookahead `(?![-\w/])` on the bare-react branch ensures we don't
+ * catch react-web / react-native / react-foo (the `-` exclusion) or
+ * the `@motif-js/react/server` and `@motif-js/react/tanstack-virtual`
+ * subpaths (the `/` exclusion). Those subpath exports still belong
+ * to the renamed DOM bindings package and must survive untouched.
+ */
+/**
+ * Apply the rename-v2 transform to a source string. The matching is
+ * applied to the **entire** text, regardless of file kind — that's
+ * intentional. Import-specifier strings have a unique enough shape
+ * (the leading `@motif-js/` namespace) that false positives in prose
+ * are rare. For `.md` / `.mdx` / `.json` files this lets the same
+ * transform handle install snippets, code fences, and the
+ * `dependencies` keys of package.json without separate parsers.
+ *
+ * If the input is `package.json`, sub-path imports like
+ * `@motif-js/react/server` survive (the lookahead spares them) — the
+ * `/server` and `/tanstack-virtual` exports still belong to the
+ * renamed DOM bindings package.
+ */
+declare function applyRenameV2(source: string): string;
+/**
+ * Convenience predicate: does the source contain anything the
+ * transform would change? Used to skip the write step for unaffected
+ * files (saves filesystem churn + leaves mtimes alone).
+ */
+declare function needsRenameV2(source: string): boolean;
+
+/**
+ * @motif-js/migrate — codemod toolkit for motif-js.
+ *
+ * Programmatic API. The CLI in `./cli.ts` is the primary surface for
+ * end users; this module is the importable shape for anyone running
+ * the transforms from their own tooling.
+ */
+declare const PACKAGE_NAME = "@motif-js/migrate";
+
+export { PACKAGE_NAME, applyRenameV2, needsRenameV2 };

package/dist/index.d.ts

@@ -0,0 +1,77 @@
+/**
+ * `rename-v2` codemod: rewrite v1 motif-js import specifiers to their
+ * v2 names.
+ *
+ * | v1                       | v2                  |
+ * |--------------------------|---------------------|
+ * | `@motif-js/react-web`    | `@motif-js/react`   |
+ * | `@motif-js/react`        | `motif-js`          |
+ * | `@motif-js/react-native` | `@motif-js/react-native` (unchanged) |
+ *
+ * Touches only **import specifier strings** inside source files —
+ * import statements, `require()` calls, dynamic `import()`, and the
+ * dependency keys of `package.json`. Comments and string literals
+ * elsewhere are left alone.
+ *
+ * ## Sequencing trap
+ *
+ * The two rewrites overlap. If we naively replace `@motif-js/react` →
+ * `motif-js` first, then `@motif-js/react-web` → `@motif-js/react`,
+ * the first pass already destroyed every `@motif-js/react` occurrence
+ * — including the `@motif-js/react` part of `@motif-js/react-web`,
+ * leaving garbage like `motif-js-web`.
+ *
+ * The safe order is the opposite: `@motif-js/react-web` →
+ * `@motif-js/react` FIRST, then `@motif-js/react` → `motif-js`. After
+ * step one, every occurrence of `@motif-js/react` in the file refers
+ * to the v2 DOM bindings (just renamed from react-web), and step two
+ * can safely promote any *other* `@motif-js/react` references (the
+ * v1 aggregator) up to `motif-js`.
+ *
+ * That's still wrong, because step two would clobber the
+ * just-renamed `@motif-js/react` references too. So in practice we
+ * use a one-pass single regex with alternation that matches whichever
+ * of the two source names appears at the call site:
+ *
+ *   /@motif-js\/react-web|@motif-js\/react(?![-\w/])/g
+ *
+ * — for each match, decide the replacement based on the matched text.
+ * react-web → @motif-js/react, bare react → motif-js. The negative
+ * lookahead `(?![-\w/])` on the bare-react branch ensures we don't
+ * catch react-web / react-native / react-foo (the `-` exclusion) or
+ * the `@motif-js/react/server` and `@motif-js/react/tanstack-virtual`
+ * subpaths (the `/` exclusion). Those subpath exports still belong
+ * to the renamed DOM bindings package and must survive untouched.
+ */
+/**
+ * Apply the rename-v2 transform to a source string. The matching is
+ * applied to the **entire** text, regardless of file kind — that's
+ * intentional. Import-specifier strings have a unique enough shape
+ * (the leading `@motif-js/` namespace) that false positives in prose
+ * are rare. For `.md` / `.mdx` / `.json` files this lets the same
+ * transform handle install snippets, code fences, and the
+ * `dependencies` keys of package.json without separate parsers.
+ *
+ * If the input is `package.json`, sub-path imports like
+ * `@motif-js/react/server` survive (the lookahead spares them) — the
+ * `/server` and `/tanstack-virtual` exports still belong to the
+ * renamed DOM bindings package.
+ */
+declare function applyRenameV2(source: string): string;
+/**
+ * Convenience predicate: does the source contain anything the
+ * transform would change? Used to skip the write step for unaffected
+ * files (saves filesystem churn + leaves mtimes alone).
+ */
+declare function needsRenameV2(source: string): boolean;
+
+/**
+ * @motif-js/migrate — codemod toolkit for motif-js.
+ *
+ * Programmatic API. The CLI in `./cli.ts` is the primary surface for
+ * end users; this module is the importable shape for anyone running
+ * the transforms from their own tooling.
+ */
+declare const PACKAGE_NAME = "@motif-js/migrate";
+
+export { PACKAGE_NAME, applyRenameV2, needsRenameV2 };

package/dist/index.js

@@ -0,0 +1,8 @@
+export { applyRenameV2, needsRenameV2 } from './chunk-SSSWTBUF.js';
+
+// src/index.ts
+var PACKAGE_NAME = "@motif-js/migrate";
+
+export { PACKAGE_NAME };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"names":[],"mappings":";;;AAQO,IAAM,YAAA,GAAe","file":"index.js","sourcesContent":["/**\n * @motif-js/migrate — codemod toolkit for motif-js.\n *\n * Programmatic API. The CLI in `./cli.ts` is the primary surface for\n * end users; this module is the importable shape for anyone running\n * the transforms from their own tooling.\n */\n\nexport const PACKAGE_NAME = '@motif-js/migrate';\n\nexport { applyRenameV2, needsRenameV2 } from './transforms/rename-v2.js';\n"]}

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "@motif-js/migrate",
+  "version": "2.0.0",
+  "description": "Codemod toolkit for motif-js. Run `npx @motif-js/migrate rename-v2 <path>` to rewrite v1 import specifiers to their v2 names.",
+  "homepage": "https://github.com/foo-stack/motif-js/tree/main/packages/migrate#readme",
+  "bugs": "https://github.com/foo-stack/motif-js/issues",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/foo-stack/motif-js.git",
+    "directory": "packages/migrate"
+  },
+  "bin": {
+    "motif-js-migrate": "./bin/cli.js"
+  },
+  "files": [
+    "bin",
+    "dist",
+    "src"
+  ],
+  "type": "module",
+  "sideEffects": false,
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsup",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "clean": "rm -rf dist .turbo *.tsbuildinfo"
+  },
+  "dependencies": {
+    "fast-glob": "^3.3.2"
+  },
+  "devDependencies": {
+    "@types/node": "^25.6.0",
+    "tsup": "^8.5.1",
+    "typescript": "^6.0.3",
+    "vitest": "^4.1.5"
+  }
+}

package/src/cli.ts

@@ -0,0 +1,125 @@
+#!/usr/bin/env node
+/**
+ * `motif-js-migrate` CLI.
+ *
+ * Usage:
+ *   motif-js-migrate rename-v2 [path] [--dry-run]
+ *   motif-js-migrate --help
+ *
+ * Default path is the current working directory. The transform walks
+ * matching files via fast-glob, applies `applyRenameV2`, and writes
+ * back any file whose content changed.
+ */
+
+import { readFile, writeFile } from 'node:fs/promises';
+import { relative, resolve } from 'node:path';
+import { exit, stderr, stdout } from 'node:process';
+import fg from 'fast-glob';
+import { applyRenameV2, needsRenameV2 } from './transforms/rename-v2.js';
+
+interface ParsedArgs {
+  readonly command: string | null;
+  readonly path: string;
+  readonly dryRun: boolean;
+  readonly help: boolean;
+}
+
+const DEFAULT_GLOBS: string[] = [
+  '**/*.{ts,tsx,js,jsx,mjs,cjs,md,mdx,json}',
+  '!**/node_modules/**',
+  '!**/dist/**',
+  '!**/.next/**',
+  '!**/.vorge/**',
+  '!**/.turbo/**',
+  '!**/.cache/**',
+  '!**/build/**',
+  '!**/out/**',
+  '!**/coverage/**',
+  '!**/__visual__/**',
+];
+
+const HELP = `motif-js-migrate — codemod toolkit for motif-js
+
+Usage:
+  motif-js-migrate rename-v2 [path]   Rewrite v1 motif-js import specifiers
+                                      to their v2 names in every file under
+                                      [path] (default: cwd).
+  motif-js-migrate --help             Show this message.
+
+Flags:
+  --dry-run     Print the files that would change without writing them.
+
+Rename map:
+  @motif-js/react-web    →  @motif-js/react
+  @motif-js/react        →  motif-js
+  @motif-js/react-native →  (unchanged)
+
+Subpath imports (@motif-js/react/server, @motif-js/react/tanstack-virtual)
+stay on @motif-js/react.
+`;
+
+function parseArgs(argv: readonly string[]): ParsedArgs {
+  let command: string | null = null;
+  let path = '.';
+  let dryRun = false;
+  let help = false;
+  let positionalIndex = 0;
+  for (const arg of argv) {
+    if (arg === '--help' || arg === '-h') {
+      help = true;
+    } else if (arg === '--dry-run') {
+      dryRun = true;
+    } else if (arg.startsWith('--')) {
+      stderr.write(`unknown flag: ${arg}\n`);
+      exit(2);
+    } else if (positionalIndex === 0) {
+      command = arg;
+      positionalIndex++;
+    } else if (positionalIndex === 1) {
+      path = arg;
+      positionalIndex++;
+    } else {
+      stderr.write(`unexpected positional argument: ${arg}\n`);
+      exit(2);
+    }
+  }
+  return { command, path, dryRun, help };
+}
+
+async function runRenameV2(rootArg: string, dryRun: boolean): Promise<number> {
+  const root = resolve(rootArg);
+  const files = await fg(DEFAULT_GLOBS, { cwd: root, absolute: true, dot: false });
+  let changed = 0;
+  for (const absPath of files) {
+    const src = await readFile(absPath, 'utf8');
+    if (!needsRenameV2(src)) continue;
+    const out = applyRenameV2(src);
+    if (out === src) continue;
+    const rel = relative(root, absPath);
+    if (dryRun) {
+      stdout.write(`would change: ${rel}\n`);
+    } else {
+      await writeFile(absPath, out, 'utf8');
+      stdout.write(`changed: ${rel}\n`);
+    }
+    changed++;
+  }
+  stdout.write(
+    `${dryRun ? 'would change' : 'changed'} ${changed} file${changed === 1 ? '' : 's'}.\n`,
+  );
+  return 0;
+}
+
+export async function main(argv: readonly string[]): Promise<number> {
+  const args = parseArgs(argv);
+  if (args.help || args.command === null) {
+    stdout.write(HELP);
+    return 0;
+  }
+  if (args.command === 'rename-v2') {
+    return runRenameV2(args.path, args.dryRun);
+  }
+  stderr.write(`unknown command: ${args.command}\n`);
+  stderr.write(HELP);
+  return 2;
+}

package/src/index.ts

@@ -0,0 +1,11 @@
+/**
+ * @motif-js/migrate — codemod toolkit for motif-js.
+ *
+ * Programmatic API. The CLI in `./cli.ts` is the primary surface for
+ * end users; this module is the importable shape for anyone running
+ * the transforms from their own tooling.
+ */
+
+export const PACKAGE_NAME = '@motif-js/migrate';
+
+export { applyRenameV2, needsRenameV2 } from './transforms/rename-v2.js';

package/src/transforms/rename-v2.test.ts

@@ -0,0 +1,153 @@
+import { describe, expect, it } from 'vitest';
+import { applyRenameV2, needsRenameV2 } from './rename-v2.js';
+
+describe('applyRenameV2', () => {
+  it('rewrites a named import from @motif-js/react-web to @motif-js/react', () => {
+    expect(applyRenameV2(`import { Box } from '@motif-js/react-web';`)).toBe(
+      `import { Box } from '@motif-js/react';`,
+    );
+  });
+
+  it('rewrites a named import from @motif-js/react (v1 aggregator) to motif-js', () => {
+    expect(applyRenameV2(`import { Box } from '@motif-js/react';`)).toBe(
+      `import { Box } from 'motif-js';`,
+    );
+  });
+
+  it('leaves @motif-js/react-native untouched', () => {
+    expect(applyRenameV2(`import { Box } from '@motif-js/react-native';`)).toBe(
+      `import { Box } from '@motif-js/react-native';`,
+    );
+  });
+
+  it('leaves @motif-js/react/server (subpath) untouched', () => {
+    expect(applyRenameV2(`import '@motif-js/react/server';`)).toBe(
+      `import '@motif-js/react/server';`,
+    );
+  });
+
+  it('rewrites @motif-js/react-web/server to @motif-js/react/server', () => {
+    expect(applyRenameV2(`import '@motif-js/react-web/server';`)).toBe(
+      `import '@motif-js/react/server';`,
+    );
+  });
+
+  it('handles both renames in the same file in one pass', () => {
+    const src = [
+      `import { Box } from '@motif-js/react-web';`,
+      `import { Portal } from '@motif-js/react';`,
+      `import '@motif-js/react-web/server';`,
+    ].join('\n');
+    const expected = [
+      `import { Box } from '@motif-js/react';`,
+      `import { Portal } from 'motif-js';`,
+      `import '@motif-js/react/server';`,
+    ].join('\n');
+    expect(applyRenameV2(src)).toBe(expected);
+  });
+
+  it('handles double-quoted imports', () => {
+    expect(applyRenameV2(`import { Box } from "@motif-js/react-web";`)).toBe(
+      `import { Box } from "@motif-js/react";`,
+    );
+  });
+
+  it('handles dynamic import() calls', () => {
+    expect(applyRenameV2(`await import('@motif-js/react-web/server');`)).toBe(
+      `await import('@motif-js/react/server');`,
+    );
+  });
+
+  it('handles CommonJS require() calls', () => {
+    expect(applyRenameV2(`const { Box } = require('@motif-js/react-web');`)).toBe(
+      `const { Box } = require('@motif-js/react');`,
+    );
+  });
+
+  it('handles type-only imports', () => {
+    expect(applyRenameV2(`import type { BoxProps } from '@motif-js/react';`)).toBe(
+      `import type { BoxProps } from 'motif-js';`,
+    );
+  });
+
+  it('handles aliased named imports', () => {
+    expect(applyRenameV2(`import { Box as MotifBox } from '@motif-js/react-web';`)).toBe(
+      `import { Box as MotifBox } from '@motif-js/react';`,
+    );
+  });
+
+  it('handles multi-line imports', () => {
+    const src = `import {\n  Box,\n  Stack,\n} from '@motif-js/react-web';`;
+    const expected = `import {\n  Box,\n  Stack,\n} from '@motif-js/react';`;
+    expect(applyRenameV2(src)).toBe(expected);
+  });
+
+  it('rewrites package.json dependency keys', () => {
+    const src = JSON.stringify(
+      {
+        dependencies: {
+          '@motif-js/react-web': 'workspace:*',
+          '@motif-js/react': 'workspace:*',
+          '@motif-js/react-native': 'workspace:*',
+        },
+      },
+      null,
+      2,
+    );
+    const out = applyRenameV2(src);
+    const parsed = JSON.parse(out) as { dependencies: Record<string, string> };
+    expect(parsed.dependencies).toEqual({
+      '@motif-js/react': 'workspace:*',
+      'motif-js': 'workspace:*',
+      '@motif-js/react-native': 'workspace:*',
+    });
+  });
+
+  it('leaves unrelated packages alone', () => {
+    const src = [
+      `import { useState } from 'react';`,
+      `import { render } from 'react-dom';`,
+      `import { reactify } from 'some-other-lib';`,
+      `import './styles/react.css';`,
+    ].join('\n');
+    expect(applyRenameV2(src)).toBe(src);
+  });
+
+  it('matches inside markdown / mdx code fences', () => {
+    const src = [
+      '## Install',
+      '',
+      '```sh',
+      'yarn add @motif-js/react',
+      '```',
+      '',
+      '```tsx',
+      `import { Box } from '@motif-js/react';`,
+      '```',
+    ].join('\n');
+    const out = applyRenameV2(src);
+    expect(out).toContain('yarn add motif-js');
+    expect(out).toContain(`import { Box } from 'motif-js';`);
+  });
+});
+
+describe('needsRenameV2', () => {
+  it('returns true for files containing v1 specifiers', () => {
+    expect(needsRenameV2(`import { Box } from '@motif-js/react-web';`)).toBe(true);
+    expect(needsRenameV2(`import { Box } from '@motif-js/react';`)).toBe(true);
+  });
+
+  it('returns false for files with only v2 / unrelated specifiers', () => {
+    expect(needsRenameV2(`import { Box } from 'motif-js';`)).toBe(false);
+    expect(needsRenameV2(`import { Box } from '@motif-js/react-native';`)).toBe(false);
+    expect(needsRenameV2(`import { Box } from '@motif-js/react/server';`)).toBe(false);
+    expect(needsRenameV2(`import { useState } from 'react';`)).toBe(false);
+  });
+
+  it('does NOT mutate its own regex (.lastIndex) across calls', () => {
+    const src = `import { Box } from '@motif-js/react-web';`;
+    expect(needsRenameV2(src)).toBe(true);
+    expect(needsRenameV2(src)).toBe(true);
+    expect(needsRenameV2(src)).toBe(true);
+  });
+});

package/src/transforms/rename-v2.ts

@@ -0,0 +1,84 @@
+/**
+ * `rename-v2` codemod: rewrite v1 motif-js import specifiers to their
+ * v2 names.
+ *
+ * | v1                       | v2                  |
+ * |--------------------------|---------------------|
+ * | `@motif-js/react-web`    | `@motif-js/react`   |
+ * | `@motif-js/react`        | `motif-js`          |
+ * | `@motif-js/react-native` | `@motif-js/react-native` (unchanged) |
+ *
+ * Touches only **import specifier strings** inside source files —
+ * import statements, `require()` calls, dynamic `import()`, and the
+ * dependency keys of `package.json`. Comments and string literals
+ * elsewhere are left alone.
+ *
+ * ## Sequencing trap
+ *
+ * The two rewrites overlap. If we naively replace `@motif-js/react` →
+ * `motif-js` first, then `@motif-js/react-web` → `@motif-js/react`,
+ * the first pass already destroyed every `@motif-js/react` occurrence
+ * — including the `@motif-js/react` part of `@motif-js/react-web`,
+ * leaving garbage like `motif-js-web`.
+ *
+ * The safe order is the opposite: `@motif-js/react-web` →
+ * `@motif-js/react` FIRST, then `@motif-js/react` → `motif-js`. After
+ * step one, every occurrence of `@motif-js/react` in the file refers
+ * to the v2 DOM bindings (just renamed from react-web), and step two
+ * can safely promote any *other* `@motif-js/react` references (the
+ * v1 aggregator) up to `motif-js`.
+ *
+ * That's still wrong, because step two would clobber the
+ * just-renamed `@motif-js/react` references too. So in practice we
+ * use a one-pass single regex with alternation that matches whichever
+ * of the two source names appears at the call site:
+ *
+ *   /@motif-js\/react-web|@motif-js\/react(?![-\w/])/g
+ *
+ * — for each match, decide the replacement based on the matched text.
+ * react-web → @motif-js/react, bare react → motif-js. The negative
+ * lookahead `(?![-\w/])` on the bare-react branch ensures we don't
+ * catch react-web / react-native / react-foo (the `-` exclusion) or
+ * the `@motif-js/react/server` and `@motif-js/react/tanstack-virtual`
+ * subpaths (the `/` exclusion). Those subpath exports still belong
+ * to the renamed DOM bindings package and must survive untouched.
+ */
+
+const SOURCE_PATTERN = /@motif-js\/react-web|@motif-js\/react(?![-\w/])/g;
+
+function replaceSource(match: string): string {
+  if (match === '@motif-js/react-web') return '@motif-js/react';
+  // The other branch of the alternation. Anchored with negative
+  // lookahead so it can only be the bare aggregator name.
+  return 'motif-js';
+}
+
+/**
+ * Apply the rename-v2 transform to a source string. The matching is
+ * applied to the **entire** text, regardless of file kind — that's
+ * intentional. Import-specifier strings have a unique enough shape
+ * (the leading `@motif-js/` namespace) that false positives in prose
+ * are rare. For `.md` / `.mdx` / `.json` files this lets the same
+ * transform handle install snippets, code fences, and the
+ * `dependencies` keys of package.json without separate parsers.
+ *
+ * If the input is `package.json`, sub-path imports like
+ * `@motif-js/react/server` survive (the lookahead spares them) — the
+ * `/server` and `/tanstack-virtual` exports still belong to the
+ * renamed DOM bindings package.
+ */
+export function applyRenameV2(source: string): string {
+  return source.replace(SOURCE_PATTERN, replaceSource);
+}
+
+/**
+ * Convenience predicate: does the source contain anything the
+ * transform would change? Used to skip the write step for unaffected
+ * files (saves filesystem churn + leaves mtimes alone).
+ */
+export function needsRenameV2(source: string): boolean {
+  // `SOURCE_PATTERN` is `g`-flagged, so reuse via `.test()` would mutate
+  // its `.lastIndex` and corrupt later calls. Build a fresh non-global
+  // regex per check.
+  return /@motif-js\/react-web|@motif-js\/react(?![-\w/])/.test(source);
+}