@payloadcms/codemod 4.0.0-internal.2f0d313 → 4.0.0-internal.31ba7ee

package/dist/upgrade/rewritePackageJson.js

@@ -2,45 +2,62 @@ const DEP_FIELDS = [
     'dependencies',
     'devDependencies'
 ];
+/** Any protocol-prefixed specifier (`workspace:*`, `catalog:`, `link:`, `file:`, `npm:`, a URL). */ const PLACEHOLDER_SPEC = /^[a-z][a-z0-9+.-]*:/i;
 export const isPayloadPackage = (name)=>name === 'payload' || name.startsWith('@payloadcms/');
 /**
  * The `@payloadcms/eslint-*` packages are versioned independently of the core
  * payload packages, so they are tracked on `latest` rather than lockstep-pinned.
  */ export const isPayloadEslintPackage = (name)=>name.startsWith('@payloadcms/eslint');
+/**
+ * A dependency whose version is resolved by the package manager, not a semver
+ * range: `workspace:*`, `catalog:`, `link:`, `file:`, `npm:` aliases, URLs.
+ * Overwriting one with an exact version would break the link, so it is left as-is.
+ */ export const isPlaceholderSpec = (spec)=>typeof spec === 'string' && PLACEHOLDER_SPEC.test(spec);
 /**
  * Mutate `data` in place for a v4 upgrade: exact-pin payload packages, drop
  * payload dependency overrides, and write the toolchain floors. Never touches
  * next/react — the Next.js upgrade is delegated to Next's own workflow.
  * Returns a summary for the report. Idempotent.
  */ export function rewritePackageJson({ data, resolved }) {
-    const pinnedPayload = pinPayloadPackages(data, resolved.payloadVersion);
+    const { pinnedPayload, placeholdersSkipped } = pinPayloadPackages(data, resolved.payloadVersion);
     const overridesRemoved = removePayloadOverrides(data);
     const floorsWritten = writeFloors(data, resolved);
     return {
         floorsWritten,
         overridesRemoved,
-        pinnedPayload
+        pinnedPayload,
+        placeholdersSkipped
     };
 }
 function pinPayloadPackages(data, version) {
     const pinned = [];
+    const skipped = [];
     for (const field of DEP_FIELDS){
         const deps = data[field];
         if (!isRecord(deps)) {
             continue;
         }
         for (const name of Object.keys(deps)){
+            if (!isPayloadPackage(name)) {
+                continue;
+            }
+            // A workspace/catalog/link spec resolves itself; pinning it breaks the link.
+            if (isPlaceholderSpec(deps[name])) {
+                skipped.push(name);
+                continue;
+            }
             if (isPayloadEslintPackage(name)) {
                 deps[name] = 'latest';
                 continue;
             }
-            if (isPayloadPackage(name)) {
-                deps[name] = version;
-                pinned.push(name);
-            }
+            deps[name] = version;
+            pinned.push(name);
         }
     }
-    return pinned;
+    return {
+        pinnedPayload: pinned,
+        placeholdersSkipped: skipped
+    };
 }
 function removePayloadOverrides(data) {
     const removed = [];

package/dist/upgrade/rewritePackageJson.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/upgrade/rewritePackageJson.ts"],"sourcesContent":["import type { ResolvedVersions } from './types.js'\n\ntype RewriteArgs = {\n  data: Record<string, unknown>\n  resolved: ResolvedVersions\n}\n\nexport type RewriteSummary = {\n  floorsWritten: string[]\n  overridesRemoved: string[]\n  pinnedPayload: string[]\n}\n\nconst DEP_FIELDS = ['dependencies', 'devDependencies'] as const\n\nexport const isPayloadPackage = (name: string): boolean =>\n  name === 'payload' || name.startsWith('@payloadcms/')\n\n/**\n * The `@payloadcms/eslint-*` packages are versioned independently of the core\n * payload packages, so they are tracked on `latest` rather than lockstep-pinned.\n */\nexport const isPayloadEslintPackage = (name: string): boolean =>\n  name.startsWith('@payloadcms/eslint')\n\n/**\n * Mutate `data` in place for a v4 upgrade: exact-pin payload packages, drop\n * payload dependency overrides, and write the toolchain floors. Never touches\n * next/react — the Next.js upgrade is delegated to Next's own workflow.\n * Returns a summary for the report. Idempotent.\n */\nexport function rewritePackageJson({ data, resolved }: RewriteArgs): RewriteSummary {\n  const pinnedPayload = pinPayloadPackages(data, resolved.payloadVersion)\n  const overridesRemoved = removePayloadOverrides(data)\n  const floorsWritten = writeFloors(data, resolved)\n  return { floorsWritten, overridesRemoved, pinnedPayload }\n}\n\nfunction pinPayloadPackages(data: Record<string, unknown>, version: string): string[] {\n  const pinned: string[] = []\n  for (const field of DEP_FIELDS) {\n    const deps = data[field]\n    if (!isRecord(deps)) {\n      continue\n    }\n    for (const name of Object.keys(deps)) {\n      if (isPayloadEslintPackage(name)) {\n        deps[name] = 'latest'\n        continue\n      }\n      if (isPayloadPackage(name)) {\n        deps[name] = version\n        pinned.push(name)\n      }\n    }\n  }\n  return pinned\n}\n\nfunction removePayloadOverrides(data: Record<string, unknown>): string[] {\n  const removed: string[] = []\n\n  const pnpm = data.pnpm\n  if (isRecord(pnpm) && isRecord(pnpm.overrides)) {\n    pruneOverrideBlock(pnpm.overrides, 'pnpm.overrides', removed)\n    if (Object.keys(pnpm.overrides).length === 0) {\n      delete pnpm.overrides\n    }\n    if (Object.keys(pnpm).length === 0) {\n      delete data.pnpm\n    }\n  }\n\n  for (const key of ['overrides', 'resolutions'] as const) {\n    const block = data[key]\n    if (isRecord(block)) {\n      pruneOverrideBlock(block, key, removed)\n      if (Object.keys(block).length === 0) {\n        delete data[key]\n      }\n    }\n  }\n\n  return removed\n}\n\nfunction pruneOverrideBlock(\n  block: Record<string, unknown>,\n  label: string,\n  removed: string[],\n): void {\n  for (const name of Object.keys(block)) {\n    if (isPayloadPackage(name)) {\n      delete block[name]\n      removed.push(`${label}.${name}`)\n    }\n  }\n}\n\nfunction writeFloors(data: Record<string, unknown>, resolved: ResolvedVersions): string[] {\n  const written: string[] = []\n  pinDep(data, 'typescript', resolved.typescript)\n  pinDep(data, '@types/node', resolved.typesNode)\n  written.push('typescript', '@types/node')\n\n  const engines = isRecord(data.engines) ? data.engines : {}\n  engines.node = resolved.enginesNode\n  data.engines = engines\n  written.push('engines.node')\n\n  return written\n}\n\n/** Update a dep wherever it already lives, else add it to devDependencies. */\nfunction pinDep(data: Record<string, unknown>, name: string, version: string): void {\n  for (const field of DEP_FIELDS) {\n    const deps = data[field]\n    if (isRecord(deps) && name in deps) {\n      deps[name] = version\n      return\n    }\n  }\n  const devDeps = isRecord(data.devDependencies) ? data.devDependencies : {}\n  devDeps[name] = version\n  data.devDependencies = devDeps\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === 'object' && value !== null && !Array.isArray(value)\n}\n"],"names":["DEP_FIELDS","isPayloadPackage","name","startsWith","isPayloadEslintPackage","rewritePackageJson","data","resolved","pinnedPayload","pinPayloadPackages","payloadVersion","overridesRemoved","removePayloadOverrides","floorsWritten","writeFloors","version","pinned","field","deps","isRecord","Object","keys","push","removed","pnpm","overrides","pruneOverrideBlock","length","key","block","label","written","pinDep","typescript","typesNode","engines","node","enginesNode","devDeps","devDependencies","value","Array","isArray"],"mappings":"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"}
+{"version":3,"sources":["../../src/upgrade/rewritePackageJson.ts"],"sourcesContent":["import type { ResolvedVersions } from './types.js'\n\ntype RewriteArgs = {\n  data: Record<string, unknown>\n  resolved: ResolvedVersions\n}\n\nexport type RewriteSummary = {\n  floorsWritten: string[]\n  overridesRemoved: string[]\n  pinnedPayload: string[]\n  placeholdersSkipped: string[]\n}\n\nconst DEP_FIELDS = ['dependencies', 'devDependencies'] as const\n\n/** Any protocol-prefixed specifier (`workspace:*`, `catalog:`, `link:`, `file:`, `npm:`, a URL). */\nconst PLACEHOLDER_SPEC = /^[a-z][a-z0-9+.-]*:/i\n\nexport const isPayloadPackage = (name: string): boolean =>\n  name === 'payload' || name.startsWith('@payloadcms/')\n\n/**\n * The `@payloadcms/eslint-*` packages are versioned independently of the core\n * payload packages, so they are tracked on `latest` rather than lockstep-pinned.\n */\nexport const isPayloadEslintPackage = (name: string): boolean =>\n  name.startsWith('@payloadcms/eslint')\n\n/**\n * A dependency whose version is resolved by the package manager, not a semver\n * range: `workspace:*`, `catalog:`, `link:`, `file:`, `npm:` aliases, URLs.\n * Overwriting one with an exact version would break the link, so it is left as-is.\n */\nexport const isPlaceholderSpec = (spec: unknown): boolean =>\n  typeof spec === 'string' && PLACEHOLDER_SPEC.test(spec)\n\n/**\n * Mutate `data` in place for a v4 upgrade: exact-pin payload packages, drop\n * payload dependency overrides, and write the toolchain floors. Never touches\n * next/react — the Next.js upgrade is delegated to Next's own workflow.\n * Returns a summary for the report. Idempotent.\n */\nexport function rewritePackageJson({ data, resolved }: RewriteArgs): RewriteSummary {\n  const { pinnedPayload, placeholdersSkipped } = pinPayloadPackages(data, resolved.payloadVersion)\n  const overridesRemoved = removePayloadOverrides(data)\n  const floorsWritten = writeFloors(data, resolved)\n  return { floorsWritten, overridesRemoved, pinnedPayload, placeholdersSkipped }\n}\n\nfunction pinPayloadPackages(\n  data: Record<string, unknown>,\n  version: string,\n): { pinnedPayload: string[]; placeholdersSkipped: string[] } {\n  const pinned: string[] = []\n  const skipped: string[] = []\n  for (const field of DEP_FIELDS) {\n    const deps = data[field]\n    if (!isRecord(deps)) {\n      continue\n    }\n    for (const name of Object.keys(deps)) {\n      if (!isPayloadPackage(name)) {\n        continue\n      }\n      // A workspace/catalog/link spec resolves itself; pinning it breaks the link.\n      if (isPlaceholderSpec(deps[name])) {\n        skipped.push(name)\n        continue\n      }\n      if (isPayloadEslintPackage(name)) {\n        deps[name] = 'latest'\n        continue\n      }\n      deps[name] = version\n      pinned.push(name)\n    }\n  }\n  return { pinnedPayload: pinned, placeholdersSkipped: skipped }\n}\n\nfunction removePayloadOverrides(data: Record<string, unknown>): string[] {\n  const removed: string[] = []\n\n  const pnpm = data.pnpm\n  if (isRecord(pnpm) && isRecord(pnpm.overrides)) {\n    pruneOverrideBlock(pnpm.overrides, 'pnpm.overrides', removed)\n    if (Object.keys(pnpm.overrides).length === 0) {\n      delete pnpm.overrides\n    }\n    if (Object.keys(pnpm).length === 0) {\n      delete data.pnpm\n    }\n  }\n\n  for (const key of ['overrides', 'resolutions'] as const) {\n    const block = data[key]\n    if (isRecord(block)) {\n      pruneOverrideBlock(block, key, removed)\n      if (Object.keys(block).length === 0) {\n        delete data[key]\n      }\n    }\n  }\n\n  return removed\n}\n\nfunction pruneOverrideBlock(\n  block: Record<string, unknown>,\n  label: string,\n  removed: string[],\n): void {\n  for (const name of Object.keys(block)) {\n    if (isPayloadPackage(name)) {\n      delete block[name]\n      removed.push(`${label}.${name}`)\n    }\n  }\n}\n\nfunction writeFloors(data: Record<string, unknown>, resolved: ResolvedVersions): string[] {\n  const written: string[] = []\n  pinDep(data, 'typescript', resolved.typescript)\n  pinDep(data, '@types/node', resolved.typesNode)\n  written.push('typescript', '@types/node')\n\n  const engines = isRecord(data.engines) ? data.engines : {}\n  engines.node = resolved.enginesNode\n  data.engines = engines\n  written.push('engines.node')\n\n  return written\n}\n\n/** Update a dep wherever it already lives, else add it to devDependencies. */\nfunction pinDep(data: Record<string, unknown>, name: string, version: string): void {\n  for (const field of DEP_FIELDS) {\n    const deps = data[field]\n    if (isRecord(deps) && name in deps) {\n      deps[name] = version\n      return\n    }\n  }\n  const devDeps = isRecord(data.devDependencies) ? data.devDependencies : {}\n  devDeps[name] = version\n  data.devDependencies = devDeps\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === 'object' && value !== null && !Array.isArray(value)\n}\n"],"names":["DEP_FIELDS","PLACEHOLDER_SPEC","isPayloadPackage","name","startsWith","isPayloadEslintPackage","isPlaceholderSpec","spec","test","rewritePackageJson","data","resolved","pinnedPayload","placeholdersSkipped","pinPayloadPackages","payloadVersion","overridesRemoved","removePayloadOverrides","floorsWritten","writeFloors","version","pinned","skipped","field","deps","isRecord","Object","keys","push","removed","pnpm","overrides","pruneOverrideBlock","length","key","block","label","written","pinDep","typescript","typesNode","engines","node","enginesNode","devDeps","devDependencies","value","Array","isArray"],"mappings":"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"}

package/dist/upgrade/selectAgent.d.ts

@@ -0,0 +1,45 @@
+export type AgentId = 'claude' | 'codex';
+export type Agent = {
+    /** Executable expected on PATH. */
+    command: string;
+    id: AgentId;
+    /** Human label shown in the picker. */
+    label: string;
+};
+/** Coding agents the dispatcher can hand the orchestration prompt to. */
+export declare const AGENTS: Agent[];
+/**
+ * Hand the prompt to `agent`, run the mechanical slice here, or print the
+ * prompt to stdout for manual use.
+ */
+export type DispatchChoice = {
+    agent: Agent;
+    kind: 'agent';
+} | {
+    kind: 'print';
+} | {
+    kind: 'run';
+};
+export type SelectDispatchArgs = {
+    /** Value of `--agent`, if the user pinned one. */
+    agentFlag?: string;
+    /** Agents found on PATH. */
+    installed: Agent[];
+    /** Both stdin and stdout are a TTY, so a picker can run. */
+    isInteractive: boolean;
+    /** Interactive picker; only called when a choice is genuinely needed. */
+    prompt: (agents: Agent[]) => Promise<DispatchChoice>;
+};
+/**
+ * Decide how to dispatch the upgrade, kept pure so the branching is unit-tested
+ * without a terminal. `--agent` wins and is strict (unknown or not-installed
+ * throws). A non-interactive session falls back to printing the prompt. Any TTY
+ * opens the picker, which offers running the mechanical slice or printing even
+ * when no agent is installed.
+ */
+export declare function selectDispatch({ agentFlag, installed, isInteractive, prompt, }: SelectDispatchArgs): Promise<DispatchChoice>;
+/** Filter the registry down to agents whose command resolves on PATH. */
+export declare function detectInstalledAgents(isAvailable?: (command: string) => boolean): Agent[];
+/** Cross-platform PATH probe using the OS command locator. */
+export declare function isCommandAvailable(command: string): boolean;
+//# sourceMappingURL=selectAgent.d.ts.map

package/dist/upgrade/selectAgent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"selectAgent.d.ts","sourceRoot":"","sources":["../../src/upgrade/selectAgent.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,OAAO,GAAG,QAAQ,GAAG,OAAO,CAAA;AAExC,MAAM,MAAM,KAAK,GAAG;IAClB,mCAAmC;IACnC,OAAO,EAAE,MAAM,CAAA;IACf,EAAE,EAAE,OAAO,CAAA;IACX,uCAAuC;IACvC,KAAK,EAAE,MAAM,CAAA;CACd,CAAA;AAED,yEAAyE;AACzE,eAAO,MAAM,MAAM,EAAE,KAAK,EAGzB,CAAA;AAED;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG;IAAE,KAAK,EAAE,KAAK,CAAC;IAAC,IAAI,EAAE,OAAO,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,KAAK,CAAA;CAAE,CAAA;AAElG,MAAM,MAAM,kBAAkB,GAAG;IAC/B,kDAAkD;IAClD,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,4BAA4B;IAC5B,SAAS,EAAE,KAAK,EAAE,CAAA;IAClB,4DAA4D;IAC5D,aAAa,EAAE,OAAO,CAAA;IACtB,yEAAyE;IACzE,MAAM,EAAE,CAAC,MAAM,EAAE,KAAK,EAAE,KAAK,OAAO,CAAC,cAAc,CAAC,CAAA;CACrD,CAAA;AAED;;;;;;GAMG;AACH,wBAAsB,cAAc,CAAC,EACnC,SAAS,EACT,SAAS,EACT,aAAa,EACb,MAAM,GACP,EAAE,kBAAkB,GAAG,OAAO,CAAC,cAAc,CAAC,CAqB9C;AAED,yEAAyE;AACzE,wBAAgB,qBAAqB,CACnC,WAAW,GAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAA4B,GAC7D,KAAK,EAAE,CAET;AAED,8DAA8D;AAC9D,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAI3D"}

package/dist/upgrade/selectAgent.js

@@ -0,0 +1,54 @@
+import { spawnSync } from 'node:child_process';
+/** Coding agents the dispatcher can hand the orchestration prompt to. */ export const AGENTS = [
+    {
+        id: 'claude',
+        command: 'claude',
+        label: 'Claude Code'
+    },
+    {
+        id: 'codex',
+        command: 'codex',
+        label: 'Codex'
+    }
+];
+/**
+ * Decide how to dispatch the upgrade, kept pure so the branching is unit-tested
+ * without a terminal. `--agent` wins and is strict (unknown or not-installed
+ * throws). A non-interactive session falls back to printing the prompt. Any TTY
+ * opens the picker, which offers running the mechanical slice or printing even
+ * when no agent is installed.
+ */ export async function selectDispatch({ agentFlag, installed, isInteractive, prompt }) {
+    if (agentFlag) {
+        const known = AGENTS.find((a)=>a.id === agentFlag);
+        if (!known) {
+            throw new Error(`Unknown agent "${agentFlag}". Supported: ${AGENTS.map((a)=>a.id).join(', ')}.`);
+        }
+        if (!installed.some((a)=>a.id === known.id)) {
+            throw new Error(`Agent "${agentFlag}" is not installed (command "${known.command}" not found).`);
+        }
+        return {
+            agent: known,
+            kind: 'agent'
+        };
+    }
+    if (!isInteractive) {
+        return {
+            kind: 'print'
+        };
+    }
+    return prompt(installed);
+}
+/** Filter the registry down to agents whose command resolves on PATH. */ export function detectInstalledAgents(isAvailable = isCommandAvailable) {
+    return AGENTS.filter((agent)=>isAvailable(agent.command));
+}
+/** Cross-platform PATH probe using the OS command locator. */ export function isCommandAvailable(command) {
+    const locator = process.platform === 'win32' ? 'where' : 'which';
+    const result = spawnSync(locator, [
+        command
+    ], {
+        stdio: 'ignore'
+    });
+    return result.status === 0;
+}
+
+//# sourceMappingURL=selectAgent.js.map

package/dist/upgrade/selectAgent.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/upgrade/selectAgent.ts"],"sourcesContent":["import { spawnSync } from 'node:child_process'\n\nexport type AgentId = 'claude' | 'codex'\n\nexport type Agent = {\n  /** Executable expected on PATH. */\n  command: string\n  id: AgentId\n  /** Human label shown in the picker. */\n  label: string\n}\n\n/** Coding agents the dispatcher can hand the orchestration prompt to. */\nexport const AGENTS: Agent[] = [\n  { id: 'claude', command: 'claude', label: 'Claude Code' },\n  { id: 'codex', command: 'codex', label: 'Codex' },\n]\n\n/**\n * Hand the prompt to `agent`, run the mechanical slice here, or print the\n * prompt to stdout for manual use.\n */\nexport type DispatchChoice = { agent: Agent; kind: 'agent' } | { kind: 'print' } | { kind: 'run' }\n\nexport type SelectDispatchArgs = {\n  /** Value of `--agent`, if the user pinned one. */\n  agentFlag?: string\n  /** Agents found on PATH. */\n  installed: Agent[]\n  /** Both stdin and stdout are a TTY, so a picker can run. */\n  isInteractive: boolean\n  /** Interactive picker; only called when a choice is genuinely needed. */\n  prompt: (agents: Agent[]) => Promise<DispatchChoice>\n}\n\n/**\n * Decide how to dispatch the upgrade, kept pure so the branching is unit-tested\n * without a terminal. `--agent` wins and is strict (unknown or not-installed\n * throws). A non-interactive session falls back to printing the prompt. Any TTY\n * opens the picker, which offers running the mechanical slice or printing even\n * when no agent is installed.\n */\nexport async function selectDispatch({\n  agentFlag,\n  installed,\n  isInteractive,\n  prompt,\n}: SelectDispatchArgs): Promise<DispatchChoice> {\n  if (agentFlag) {\n    const known = AGENTS.find((a) => a.id === agentFlag)\n    if (!known) {\n      throw new Error(\n        `Unknown agent \"${agentFlag}\". Supported: ${AGENTS.map((a) => a.id).join(', ')}.`,\n      )\n    }\n    if (!installed.some((a) => a.id === known.id)) {\n      throw new Error(\n        `Agent \"${agentFlag}\" is not installed (command \"${known.command}\" not found).`,\n      )\n    }\n    return { agent: known, kind: 'agent' }\n  }\n\n  if (!isInteractive) {\n    return { kind: 'print' }\n  }\n\n  return prompt(installed)\n}\n\n/** Filter the registry down to agents whose command resolves on PATH. */\nexport function detectInstalledAgents(\n  isAvailable: (command: string) => boolean = isCommandAvailable,\n): Agent[] {\n  return AGENTS.filter((agent) => isAvailable(agent.command))\n}\n\n/** Cross-platform PATH probe using the OS command locator. */\nexport function isCommandAvailable(command: string): boolean {\n  const locator = process.platform === 'win32' ? 'where' : 'which'\n  const result = spawnSync(locator, [command], { stdio: 'ignore' })\n  return result.status === 0\n}\n"],"names":["spawnSync","AGENTS","id","command","label","selectDispatch","agentFlag","installed","isInteractive","prompt","known","find","a","Error","map","join","some","agent","kind","detectInstalledAgents","isAvailable","isCommandAvailable","filter","locator","process","platform","result","stdio","status"],"mappings":"AAAA,SAASA,SAAS,QAAQ,qBAAoB;AAY9C,uEAAuE,GACvE,OAAO,MAAMC,SAAkB;IAC7B;QAAEC,IAAI;QAAUC,SAAS;QAAUC,OAAO;IAAc;IACxD;QAAEF,IAAI;QAASC,SAAS;QAASC,OAAO;IAAQ;CACjD,CAAA;AAmBD;;;;;;CAMC,GACD,OAAO,eAAeC,eAAe,EACnCC,SAAS,EACTC,SAAS,EACTC,aAAa,EACbC,MAAM,EACa;IACnB,IAAIH,WAAW;QACb,MAAMI,QAAQT,OAAOU,IAAI,CAAC,CAACC,IAAMA,EAAEV,EAAE,KAAKI;QAC1C,IAAI,CAACI,OAAO;YACV,MAAM,IAAIG,MACR,CAAC,eAAe,EAAEP,UAAU,cAAc,EAAEL,OAAOa,GAAG,CAAC,CAACF,IAAMA,EAAEV,EAAE,EAAEa,IAAI,CAAC,MAAM,CAAC,CAAC;QAErF;QACA,IAAI,CAACR,UAAUS,IAAI,CAAC,CAACJ,IAAMA,EAAEV,EAAE,KAAKQ,MAAMR,EAAE,GAAG;YAC7C,MAAM,IAAIW,MACR,CAAC,OAAO,EAAEP,UAAU,6BAA6B,EAAEI,MAAMP,OAAO,CAAC,aAAa,CAAC;QAEnF;QACA,OAAO;YAAEc,OAAOP;YAAOQ,MAAM;QAAQ;IACvC;IAEA,IAAI,CAACV,eAAe;QAClB,OAAO;YAAEU,MAAM;QAAQ;IACzB;IAEA,OAAOT,OAAOF;AAChB;AAEA,uEAAuE,GACvE,OAAO,SAASY,sBACdC,cAA4CC,kBAAkB;IAE9D,OAAOpB,OAAOqB,MAAM,CAAC,CAACL,QAAUG,YAAYH,MAAMd,OAAO;AAC3D;AAEA,4DAA4D,GAC5D,OAAO,SAASkB,mBAAmBlB,OAAe;IAChD,MAAMoB,UAAUC,QAAQC,QAAQ,KAAK,UAAU,UAAU;IACzD,MAAMC,SAAS1B,UAAUuB,SAAS;QAACpB;KAAQ,EAAE;QAAEwB,OAAO;IAAS;IAC/D,OAAOD,OAAOE,MAAM,KAAK;AAC3B"}

package/dist/upgrade/selfCommand.d.ts

@@ -0,0 +1,13 @@
+type ResolveSelfCommandArgs = {
+    argv1?: string;
+    override?: string;
+};
+/**
+ * The command a follower types to re-invoke this CLI. A published install lives
+ * under node_modules and is reached with npx; a source checkout is reached with
+ * `node <bin>` so local testing runs the local build, not a published version.
+ * `PAYLOAD_CODEMOD_COMMAND` overrides both.
+ */
+export declare function resolveSelfCommand({ argv1, override, }?: ResolveSelfCommandArgs): string;
+export {};
+//# sourceMappingURL=selfCommand.d.ts.map

package/dist/upgrade/selfCommand.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"selfCommand.d.ts","sourceRoot":"","sources":["../../src/upgrade/selfCommand.ts"],"names":[],"mappings":"AAEA,KAAK,sBAAsB,GAAG;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB,CAAA;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,EACjC,KAAuB,EACvB,QAA8C,GAC/C,GAAE,sBAA2B,GAAG,MAAM,CAQtC"}

package/dist/upgrade/selfCommand.js

@@ -0,0 +1,17 @@
+import { resolve } from 'node:path';
+/**
+ * The command a follower types to re-invoke this CLI. A published install lives
+ * under node_modules and is reached with npx; a source checkout is reached with
+ * `node <bin>` so local testing runs the local build, not a published version.
+ * `PAYLOAD_CODEMOD_COMMAND` overrides both.
+ */ export function resolveSelfCommand({ argv1 = process.argv[1], override = process.env.PAYLOAD_CODEMOD_COMMAND } = {}) {
+    if (override) {
+        return override;
+    }
+    if (argv1 && !argv1.includes('node_modules')) {
+        return `node ${resolve(argv1)}`;
+    }
+    return 'npx @payloadcms/codemod';
+}
+
+//# sourceMappingURL=selfCommand.js.map

package/dist/upgrade/selfCommand.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/upgrade/selfCommand.ts"],"sourcesContent":["import { resolve } from 'node:path'\n\ntype ResolveSelfCommandArgs = {\n  argv1?: string\n  override?: string\n}\n\n/**\n * The command a follower types to re-invoke this CLI. A published install lives\n * under node_modules and is reached with npx; a source checkout is reached with\n * `node <bin>` so local testing runs the local build, not a published version.\n * `PAYLOAD_CODEMOD_COMMAND` overrides both.\n */\nexport function resolveSelfCommand({\n  argv1 = process.argv[1],\n  override = process.env.PAYLOAD_CODEMOD_COMMAND,\n}: ResolveSelfCommandArgs = {}): string {\n  if (override) {\n    return override\n  }\n  if (argv1 && !argv1.includes('node_modules')) {\n    return `node ${resolve(argv1)}`\n  }\n  return 'npx @payloadcms/codemod'\n}\n"],"names":["resolve","resolveSelfCommand","argv1","process","argv","override","env","PAYLOAD_CODEMOD_COMMAND","includes"],"mappings":"AAAA,SAASA,OAAO,QAAQ,YAAW;AAOnC;;;;;CAKC,GACD,OAAO,SAASC,mBAAmB,EACjCC,QAAQC,QAAQC,IAAI,CAAC,EAAE,EACvBC,WAAWF,QAAQG,GAAG,CAACC,uBAAuB,EACvB,GAAG,CAAC,CAAC;IAC5B,IAAIF,UAAU;QACZ,OAAOA;IACT;IACA,IAAIH,SAAS,CAACA,MAAMM,QAAQ,CAAC,iBAAiB;QAC5C,OAAO,CAAC,KAAK,EAAER,QAAQE,QAAQ;IACjC;IACA,OAAO;AACT"}

package/dist/upgrade/types.d.ts

@@ -39,4 +39,9 @@ export type UpgradeDeps = {
 export declare const TS_FLOOR = "6.0.3";
 /** Path (relative to dist/) of the bundled runbook the command points users to. */
 export declare const RUNBOOK_RELATIVE_PATH = "runbook/payload-v4-upgrade.md";
+/**
+ * Path (relative to dist/) of the bundled migration guide. Present only when the
+ * monorepo copy was available at build time; the report points at it when it exists.
+ */
+export declare const MIGRATION_GUIDE_RELATIVE_PATH = "runbook/v4.mdx";
 //# sourceMappingURL=types.d.ts.map

package/dist/upgrade/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/upgrade/types.ts"],"names":[],"mappings":"AAAA,0DAA0D;AAC1D,MAAM,MAAM,iBAAiB,GAAG;IAC9B,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACpC,QAAQ,CAAC,EAAE,MAAM,CACf,MAAM,EACN;QACE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;QAChC,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAC1C,CACF,CAAA;CACF,CAAA;AAED,MAAM,MAAM,aAAa,GAAG,CAAC,WAAW,EAAE,MAAM,KAAK,OAAO,CAAC,iBAAiB,CAAC,CAAA;AAE/E,MAAM,MAAM,KAAK,GAAG,CAClB,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC,UAAU,CAAA;CAAE,KAC7C,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAAA;AAE9B,MAAM,MAAM,cAAc,GAAG,KAAK,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,CAAA;AAE5D,kFAAkF;AAClF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,yCAAyC;IACzC,WAAW,EAAE,MAAM,CAAA;IACnB,qFAAqF;IACrF,UAAU,EAAE,IAAI,GAAG,MAAM,CAAA;IACzB,0EAA0E;IAC1E,cAAc,EAAE,MAAM,CAAA;IACtB,iDAAiD;IACjD,UAAU,EAAE,MAAM,CAAA;IAClB,sDAAsD;IACtD,SAAS,EAAE,MAAM,CAAA;CAClB,CAAA;AAED,MAAM,MAAM,WAAW,GAAG;IACxB,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAA;IACjC,aAAa,EAAE,aAAa,CAAA;IAC5B,KAAK,EAAE,KAAK,CAAA;CACb,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,QAAQ,UAAU,CAAA;AAE/B,mFAAmF;AACnF,eAAO,MAAM,qBAAqB,kCAAkC,CAAA"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/upgrade/types.ts"],"names":[],"mappings":"AAAA,0DAA0D;AAC1D,MAAM,MAAM,iBAAiB,GAAG;IAC9B,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACpC,QAAQ,CAAC,EAAE,MAAM,CACf,MAAM,EACN;QACE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;QAChC,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAC1C,CACF,CAAA;CACF,CAAA;AAED,MAAM,MAAM,aAAa,GAAG,CAAC,WAAW,EAAE,MAAM,KAAK,OAAO,CAAC,iBAAiB,CAAC,CAAA;AAE/E,MAAM,MAAM,KAAK,GAAG,CAClB,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC,UAAU,CAAA;CAAE,KAC7C,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAAA;AAE9B,MAAM,MAAM,cAAc,GAAG,KAAK,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,CAAA;AAE5D,kFAAkF;AAClF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,yCAAyC;IACzC,WAAW,EAAE,MAAM,CAAA;IACnB,qFAAqF;IACrF,UAAU,EAAE,IAAI,GAAG,MAAM,CAAA;IACzB,0EAA0E;IAC1E,cAAc,EAAE,MAAM,CAAA;IACtB,iDAAiD;IACjD,UAAU,EAAE,MAAM,CAAA;IAClB,sDAAsD;IACtD,SAAS,EAAE,MAAM,CAAA;CAClB,CAAA;AAED,MAAM,MAAM,WAAW,GAAG;IACxB,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAA;IACjC,aAAa,EAAE,aAAa,CAAA;IAC5B,KAAK,EAAE,KAAK,CAAA;CACb,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,QAAQ,UAAU,CAAA;AAE/B,mFAAmF;AACnF,eAAO,MAAM,qBAAqB,kCAAkC,CAAA;AAEpE;;;GAGG;AACH,eAAO,MAAM,6BAA6B,mBAAmB,CAAA"}

package/dist/upgrade/types.js

@@ -3,5 +3,9 @@
  * lives here, sourced from the v4 migration guide prose. Bump alongside the guide.
  */ export const TS_FLOOR = '6.0.3';
 /** Path (relative to dist/) of the bundled runbook the command points users to. */ export const RUNBOOK_RELATIVE_PATH = 'runbook/payload-v4-upgrade.md';
+/**
+ * Path (relative to dist/) of the bundled migration guide. Present only when the
+ * monorepo copy was available at build time; the report points at it when it exists.
+ */ export const MIGRATION_GUIDE_RELATIVE_PATH = 'runbook/v4.mdx';
 
 //# sourceMappingURL=types.js.map

package/dist/upgrade/types.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/upgrade/types.ts"],"sourcesContent":["/** Minimal shape of an npm registry packument we read. */\nexport type RegistryPackument = {\n  'dist-tags'?: Record<string, string>\n  versions?: Record<\n    string,\n    {\n      engines?: Record<string, string>\n      peerDependencies?: Record<string, string>\n    }\n  >\n}\n\nexport type FetchRegistry = (packageName: string) => Promise<RegistryPackument>\n\nexport type Spawn = (\n  command: string,\n  args: string[],\n  options: { cwd: string; env: NodeJS.ProcessEnv },\n) => Promise<{ code: number }>\n\nexport type PackageManager = 'bun' | 'npm' | 'pnpm' | 'yarn'\n\n/** Target versions the command resolves. Only some are written; see `written`. */\nexport type ResolvedVersions = {\n  /** Copied verbatim into engines.node. */\n  enginesNode: string\n  /** Newest patch within @payloadcms/next's peer range. REPORT ONLY, never written. */\n  nextTarget: null | string\n  /** Exact canary, applied in lockstep to payload + every @payloadcms/*. */\n  payloadVersion: string\n  /** TypeScript floor (guide-sourced constant). */\n  typescript: string\n  /** Newest @types/node patch within the Node major. */\n  typesNode: string\n}\n\nexport type UpgradeDeps = {\n  exists: (path: string) => boolean\n  fetchRegistry: FetchRegistry\n  spawn: Spawn\n}\n\n/**\n * TypeScript floor for Payload v4. Nothing machine-readable declares it, so it\n * lives here, sourced from the v4 migration guide prose. Bump alongside the guide.\n */\nexport const TS_FLOOR = '6.0.3'\n\n/** Path (relative to dist/) of the bundled runbook the command points users to. */\nexport const RUNBOOK_RELATIVE_PATH = 'runbook/payload-v4-upgrade.md'\n"],"names":["TS_FLOOR","RUNBOOK_RELATIVE_PATH"],"mappings":"AAAA,wDAAwD,GA0CxD;;;CAGC,GACD,OAAO,MAAMA,WAAW,QAAO;AAE/B,iFAAiF,GACjF,OAAO,MAAMC,wBAAwB,gCAA+B"}
+{"version":3,"sources":["../../src/upgrade/types.ts"],"sourcesContent":["/** Minimal shape of an npm registry packument we read. */\nexport type RegistryPackument = {\n  'dist-tags'?: Record<string, string>\n  versions?: Record<\n    string,\n    {\n      engines?: Record<string, string>\n      peerDependencies?: Record<string, string>\n    }\n  >\n}\n\nexport type FetchRegistry = (packageName: string) => Promise<RegistryPackument>\n\nexport type Spawn = (\n  command: string,\n  args: string[],\n  options: { cwd: string; env: NodeJS.ProcessEnv },\n) => Promise<{ code: number }>\n\nexport type PackageManager = 'bun' | 'npm' | 'pnpm' | 'yarn'\n\n/** Target versions the command resolves. Only some are written; see `written`. */\nexport type ResolvedVersions = {\n  /** Copied verbatim into engines.node. */\n  enginesNode: string\n  /** Newest patch within @payloadcms/next's peer range. REPORT ONLY, never written. */\n  nextTarget: null | string\n  /** Exact canary, applied in lockstep to payload + every @payloadcms/*. */\n  payloadVersion: string\n  /** TypeScript floor (guide-sourced constant). */\n  typescript: string\n  /** Newest @types/node patch within the Node major. */\n  typesNode: string\n}\n\nexport type UpgradeDeps = {\n  exists: (path: string) => boolean\n  fetchRegistry: FetchRegistry\n  spawn: Spawn\n}\n\n/**\n * TypeScript floor for Payload v4. Nothing machine-readable declares it, so it\n * lives here, sourced from the v4 migration guide prose. Bump alongside the guide.\n */\nexport const TS_FLOOR = '6.0.3'\n\n/** Path (relative to dist/) of the bundled runbook the command points users to. */\nexport const RUNBOOK_RELATIVE_PATH = 'runbook/payload-v4-upgrade.md'\n\n/**\n * Path (relative to dist/) of the bundled migration guide. Present only when the\n * monorepo copy was available at build time; the report points at it when it exists.\n */\nexport const MIGRATION_GUIDE_RELATIVE_PATH = 'runbook/v4.mdx'\n"],"names":["TS_FLOOR","RUNBOOK_RELATIVE_PATH","MIGRATION_GUIDE_RELATIVE_PATH"],"mappings":"AAAA,wDAAwD,GA0CxD;;;CAGC,GACD,OAAO,MAAMA,WAAW,QAAO;AAE/B,iFAAiF,GACjF,OAAO,MAAMC,wBAAwB,gCAA+B;AAEpE;;;CAGC,GACD,OAAO,MAAMC,gCAAgC,iBAAgB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@payloadcms/codemod",
-  "version": "4.0.0-internal.2f0d313",
+  "version": "4.0.0-internal.31ba7ee",
   "description": "Codemods for migrating Payload projects across versions.",
   "homepage": "https://payloadcms.com",
   "repository": {
@@ -29,6 +29,7 @@
     "README.md"
   ],
   "dependencies": {
+    "@clack/prompts": "1.2.0",
     "semver": "^7.8.5",
     "ts-morph": "^21.0.1"
   },
@@ -37,8 +38,8 @@
     "@types/node": "24.12.3",
     "@types/semver": "^7.7.1",
     "rimraf": "6.0.1",
-    "typescript": "6.0.3",
-    "vitest": "4.1.6"
+    "typescript": "npm:@typescript/typescript6@6.0.2",
+    "vitest": "5.0.1"
   },
   "engines": {
     "node": ">=24.15.0"

package/dist/cli.parseFlags.spec.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=cli.parseFlags.spec.d.ts.map

package/dist/cli.parseFlags.spec.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"cli.parseFlags.spec.d.ts","sourceRoot":"","sources":["../src/cli.parseFlags.spec.ts"],"names":[],"mappings":""}

package/dist/cli.parseFlags.spec.js

@@ -1,121 +0,0 @@
-import { describe, expect, it } from 'vitest';
-import { parseFlags } from './cli.parseFlags.js';
-describe('parseFlags', ()=>{
-    it('defaults path to cwd when no positional arg is given', ()=>{
-        expect(parseFlags([])).toEqual({
-            command: undefined,
-            dry: false,
-            emitPrompt: false,
-            force: false,
-            list: false,
-            path: process.cwd(),
-            print: false,
-            tag: undefined,
-            transform: undefined
-        });
-    });
-    it('reads positional path', ()=>{
-        expect(parseFlags([
-            './src'
-        ]).path).toBe('./src');
-    });
-    it('parses flags', ()=>{
-        expect(parseFlags([
-            './src',
-            '--dry',
-            '--print'
-        ])).toMatchObject({
-            dry: true,
-            path: './src',
-            print: true
-        });
-    });
-    it('parses --transform', ()=>{
-        expect(parseFlags([
-            '--transform',
-            'rename-slate-export'
-        ])).toMatchObject({
-            transform: 'rename-slate-export'
-        });
-    });
-    it('parses --list', ()=>{
-        expect(parseFlags([
-            '--list'
-        ]).list).toBe(true);
-    });
-    it('treats --dry-run as an alias for --dry', ()=>{
-        expect(parseFlags([
-            '--dry-run'
-        ]).dry).toBe(true);
-    });
-    it('parses the upgrade subcommand with default path', ()=>{
-        expect(parseFlags([
-            'upgrade'
-        ])).toMatchObject({
-            command: 'upgrade',
-            path: process.cwd()
-        });
-    });
-    it('parses upgrade with path, tag, force, and dry', ()=>{
-        expect(parseFlags([
-            'upgrade',
-            './app',
-            '--tag',
-            'latest',
-            '--force',
-            '--dry'
-        ])).toMatchObject({
-            command: 'upgrade',
-            dry: true,
-            force: true,
-            path: './app',
-            tag: 'latest'
-        });
-    });
-    it('parses `upgrade prompt` with default path', ()=>{
-        expect(parseFlags([
-            'upgrade',
-            'prompt'
-        ])).toMatchObject({
-            command: 'upgrade',
-            emitPrompt: true,
-            path: process.cwd()
-        });
-    });
-    it('parses `upgrade prompt <path>` with tag', ()=>{
-        expect(parseFlags([
-            'upgrade',
-            'prompt',
-            './app',
-            '--tag',
-            'latest'
-        ])).toMatchObject({
-            command: 'upgrade',
-            emitPrompt: true,
-            path: './app',
-            tag: 'latest'
-        });
-    });
-    it('leaves emitPrompt false for a plain upgrade run', ()=>{
-        expect(parseFlags([
-            'upgrade',
-            './app'
-        ])).toMatchObject({
-            command: 'upgrade',
-            emitPrompt: false,
-            path: './app'
-        });
-    });
-    it('leaves command undefined for a bare path invocation', ()=>{
-        expect(parseFlags([
-            './src',
-            '--dry'
-        ])).toMatchObject({
-            command: undefined,
-            dry: true,
-            path: './src'
-        });
-    });
-});
-
-//# sourceMappingURL=cli.parseFlags.spec.js.map

package/dist/cli.parseFlags.spec.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/cli.parseFlags.spec.ts"],"sourcesContent":["import { describe, expect, it } from 'vitest'\n\nimport { parseFlags } from './cli.parseFlags.js'\n\ndescribe('parseFlags', () => {\n  it('defaults path to cwd when no positional arg is given', () => {\n    expect(parseFlags([])).toEqual({\n      command: undefined,\n      dry: false,\n      emitPrompt: false,\n      force: false,\n      list: false,\n      path: process.cwd(),\n      print: false,\n      tag: undefined,\n      transform: undefined,\n    })\n  })\n\n  it('reads positional path', () => {\n    expect(parseFlags(['./src']).path).toBe('./src')\n  })\n\n  it('parses flags', () => {\n    expect(parseFlags(['./src', '--dry', '--print'])).toMatchObject({\n      dry: true,\n      path: './src',\n      print: true,\n    })\n  })\n\n  it('parses --transform', () => {\n    expect(parseFlags(['--transform', 'rename-slate-export'])).toMatchObject({\n      transform: 'rename-slate-export',\n    })\n  })\n\n  it('parses --list', () => {\n    expect(parseFlags(['--list']).list).toBe(true)\n  })\n\n  it('treats --dry-run as an alias for --dry', () => {\n    expect(parseFlags(['--dry-run']).dry).toBe(true)\n  })\n\n  it('parses the upgrade subcommand with default path', () => {\n    expect(parseFlags(['upgrade'])).toMatchObject({\n      command: 'upgrade',\n      path: process.cwd(),\n    })\n  })\n\n  it('parses upgrade with path, tag, force, and dry', () => {\n    expect(parseFlags(['upgrade', './app', '--tag', 'latest', '--force', '--dry'])).toMatchObject({\n      command: 'upgrade',\n      dry: true,\n      force: true,\n      path: './app',\n      tag: 'latest',\n    })\n  })\n\n  it('parses `upgrade prompt` with default path', () => {\n    expect(parseFlags(['upgrade', 'prompt'])).toMatchObject({\n      command: 'upgrade',\n      emitPrompt: true,\n      path: process.cwd(),\n    })\n  })\n\n  it('parses `upgrade prompt <path>` with tag', () => {\n    expect(parseFlags(['upgrade', 'prompt', './app', '--tag', 'latest'])).toMatchObject({\n      command: 'upgrade',\n      emitPrompt: true,\n      path: './app',\n      tag: 'latest',\n    })\n  })\n\n  it('leaves emitPrompt false for a plain upgrade run', () => {\n    expect(parseFlags(['upgrade', './app'])).toMatchObject({\n      command: 'upgrade',\n      emitPrompt: false,\n      path: './app',\n    })\n  })\n\n  it('leaves command undefined for a bare path invocation', () => {\n    expect(parseFlags(['./src', '--dry'])).toMatchObject({\n      command: undefined,\n      dry: true,\n      path: './src',\n    })\n  })\n})\n"],"names":["describe","expect","it","parseFlags","toEqual","command","undefined","dry","emitPrompt","force","list","path","process","cwd","print","tag","transform","toBe","toMatchObject"],"mappings":"AAAA,SAASA,QAAQ,EAAEC,MAAM,EAAEC,EAAE,QAAQ,SAAQ;AAE7C,SAASC,UAAU,QAAQ,sBAAqB;AAEhDH,SAAS,cAAc;IACrBE,GAAG,wDAAwD;QACzDD,OAAOE,WAAW,EAAE,GAAGC,OAAO,CAAC;YAC7BC,SAASC;YACTC,KAAK;YACLC,YAAY;YACZC,OAAO;YACPC,MAAM;YACNC,MAAMC,QAAQC,GAAG;YACjBC,OAAO;YACPC,KAAKT;YACLU,WAAWV;QACb;IACF;IAEAJ,GAAG,yBAAyB;QAC1BD,OAAOE,WAAW;YAAC;SAAQ,EAAEQ,IAAI,EAAEM,IAAI,CAAC;IAC1C;IAEAf,GAAG,gBAAgB;QACjBD,OAAOE,WAAW;YAAC;YAAS;YAAS;SAAU,GAAGe,aAAa,CAAC;YAC9DX,KAAK;YACLI,MAAM;YACNG,OAAO;QACT;IACF;IAEAZ,GAAG,sBAAsB;QACvBD,OAAOE,WAAW;YAAC;YAAe;SAAsB,GAAGe,aAAa,CAAC;YACvEF,WAAW;QACb;IACF;IAEAd,GAAG,iBAAiB;QAClBD,OAAOE,WAAW;YAAC;SAAS,EAAEO,IAAI,EAAEO,IAAI,CAAC;IAC3C;IAEAf,GAAG,0CAA0C;QAC3CD,OAAOE,WAAW;YAAC;SAAY,EAAEI,GAAG,EAAEU,IAAI,CAAC;IAC7C;IAEAf,GAAG,mDAAmD;QACpDD,OAAOE,WAAW;YAAC;SAAU,GAAGe,aAAa,CAAC;YAC5Cb,SAAS;YACTM,MAAMC,QAAQC,GAAG;QACnB;IACF;IAEAX,GAAG,iDAAiD;QAClDD,OAAOE,WAAW;YAAC;YAAW;YAAS;YAAS;YAAU;YAAW;SAAQ,GAAGe,aAAa,CAAC;YAC5Fb,SAAS;YACTE,KAAK;YACLE,OAAO;YACPE,MAAM;YACNI,KAAK;QACP;IACF;IAEAb,GAAG,6CAA6C;QAC9CD,OAAOE,WAAW;YAAC;YAAW;SAAS,GAAGe,aAAa,CAAC;YACtDb,SAAS;YACTG,YAAY;YACZG,MAAMC,QAAQC,GAAG;QACnB;IACF;IAEAX,GAAG,2CAA2C;QAC5CD,OAAOE,WAAW;YAAC;YAAW;YAAU;YAAS;YAAS;SAAS,GAAGe,aAAa,CAAC;YAClFb,SAAS;YACTG,YAAY;YACZG,MAAM;YACNI,KAAK;QACP;IACF;IAEAb,GAAG,mDAAmD;QACpDD,OAAOE,WAAW;YAAC;YAAW;SAAQ,GAAGe,aAAa,CAAC;YACrDb,SAAS;YACTG,YAAY;YACZG,MAAM;QACR;IACF;IAEAT,GAAG,uDAAuD;QACxDD,OAAOE,WAAW;YAAC;YAAS;SAAQ,GAAGe,aAAa,CAAC;YACnDb,SAASC;YACTC,KAAK;YACLI,MAAM;QACR;IACF;AACF"}

package/dist/runner.spec.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=runner.spec.d.ts.map

package/dist/runner.spec.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"runner.spec.d.ts","sourceRoot":"","sources":["../src/runner.spec.ts"],"names":[],"mappings":""}

package/dist/runner.spec.js

@@ -1,88 +0,0 @@
-import { Project } from 'ts-morph';
-import { describe, expect, it } from 'vitest';
-import { runTransforms } from './runner.js';
-function makeProject(files) {
-    const project = new Project({
-        useInMemoryFileSystem: true
-    });
-    for (const [path, contents] of Object.entries(files)){
-        project.createSourceFile(path, contents);
-    }
-    return project;
-}
-describe('runTransforms', ()=>{
-    it('applies each transform in order and aggregates results', async ()=>{
-        const project = makeProject({
-            'a.ts': 'export const a = 1'
-        });
-        const t1 = {
-            name: 't1',
-            apply: ()=>({
-                    filesChanged: [
-                        'a.ts'
-                    ]
-                }),
-            description: ''
-        };
-        const t2 = {
-            name: 't2',
-            apply: ()=>({
-                    filesChanged: [],
-                    notes: [
-                        'nothing to do'
-                    ]
-                }),
-            description: ''
-        };
-        const result = await runTransforms({
-            project,
-            transforms: [
-                t1,
-                t2
-            ]
-        });
-        expect(result.results.map((r)=>r.name)).toEqual([
-            't1',
-            't2'
-        ]);
-        expect(result.results[0].filesChanged).toEqual([
-            'a.ts'
-        ]);
-        expect(result.failed).toBe(false);
-    });
-    it('continues past a throwing transform and marks the run failed', async ()=>{
-        const project = makeProject({
-            'a.ts': 'export const a = 1'
-        });
-        const boom = {
-            name: 'boom',
-            apply: ()=>{
-                throw new Error('kaboom');
-            },
-            description: ''
-        };
-        const ok = {
-            name: 'ok',
-            apply: ()=>({
-                    filesChanged: []
-                }),
-            description: ''
-        };
-        const result = await runTransforms({
-            project,
-            transforms: [
-                boom,
-                ok
-            ]
-        });
-        expect(result.failed).toBe(true);
-        expect(result.results.map((r)=>r.name)).toEqual([
-            'boom',
-            'ok'
-        ]);
-        expect(result.results[0].error).toBeInstanceOf(Error);
-        expect(result.results[1].error).toBeUndefined();
-    });
-});
-
-//# sourceMappingURL=runner.spec.js.map

package/dist/runner.spec.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/runner.spec.ts"],"sourcesContent":["import { Project } from 'ts-morph'\nimport { describe, expect, it } from 'vitest'\n\nimport type { Transform } from './types.js'\n\nimport { runTransforms } from './runner.js'\n\nfunction makeProject(files: Record<string, string>): Project {\n  const project = new Project({ useInMemoryFileSystem: true })\n  for (const [path, contents] of Object.entries(files)) {\n    project.createSourceFile(path, contents)\n  }\n  return project\n}\n\ndescribe('runTransforms', () => {\n  it('applies each transform in order and aggregates results', async () => {\n    const project = makeProject({ 'a.ts': 'export const a = 1' })\n\n    const t1: Transform = {\n      name: 't1',\n      apply: () => ({ filesChanged: ['a.ts'] }),\n      description: '',\n    }\n    const t2: Transform = {\n      name: 't2',\n      apply: () => ({ filesChanged: [], notes: ['nothing to do'] }),\n      description: '',\n    }\n\n    const result = await runTransforms({\n      project,\n      transforms: [t1, t2],\n    })\n\n    expect(result.results.map((r) => r.name)).toEqual(['t1', 't2'])\n    expect(result.results[0]!.filesChanged).toEqual(['a.ts'])\n    expect(result.failed).toBe(false)\n  })\n\n  it('continues past a throwing transform and marks the run failed', async () => {\n    const project = makeProject({ 'a.ts': 'export const a = 1' })\n\n    const boom: Transform = {\n      name: 'boom',\n      apply: () => {\n        throw new Error('kaboom')\n      },\n      description: '',\n    }\n    const ok: Transform = {\n      name: 'ok',\n      apply: () => ({ filesChanged: [] }),\n      description: '',\n    }\n\n    const result = await runTransforms({\n      project,\n      transforms: [boom, ok],\n    })\n\n    expect(result.failed).toBe(true)\n    expect(result.results.map((r) => r.name)).toEqual(['boom', 'ok'])\n    expect(result.results[0]!.error).toBeInstanceOf(Error)\n    expect(result.results[1]!.error).toBeUndefined()\n  })\n})\n"],"names":["Project","describe","expect","it","runTransforms","makeProject","files","project","useInMemoryFileSystem","path","contents","Object","entries","createSourceFile","t1","name","apply","filesChanged","description","t2","notes","result","transforms","results","map","r","toEqual","failed","toBe","boom","Error","ok","error","toBeInstanceOf","toBeUndefined"],"mappings":"AAAA,SAASA,OAAO,QAAQ,WAAU;AAClC,SAASC,QAAQ,EAAEC,MAAM,EAAEC,EAAE,QAAQ,SAAQ;AAI7C,SAASC,aAAa,QAAQ,cAAa;AAE3C,SAASC,YAAYC,KAA6B;IAChD,MAAMC,UAAU,IAAIP,QAAQ;QAAEQ,uBAAuB;IAAK;IAC1D,KAAK,MAAM,CAACC,MAAMC,SAAS,IAAIC,OAAOC,OAAO,CAACN,OAAQ;QACpDC,QAAQM,gBAAgB,CAACJ,MAAMC;IACjC;IACA,OAAOH;AACT;AAEAN,SAAS,iBAAiB;IACxBE,GAAG,0DAA0D;QAC3D,MAAMI,UAAUF,YAAY;YAAE,QAAQ;QAAqB;QAE3D,MAAMS,KAAgB;YACpBC,MAAM;YACNC,OAAO,IAAO,CAAA;oBAAEC,cAAc;wBAAC;qBAAO;gBAAC,CAAA;YACvCC,aAAa;QACf;QACA,MAAMC,KAAgB;YACpBJ,MAAM;YACNC,OAAO,IAAO,CAAA;oBAAEC,cAAc,EAAE;oBAAEG,OAAO;wBAAC;qBAAgB;gBAAC,CAAA;YAC3DF,aAAa;QACf;QAEA,MAAMG,SAAS,MAAMjB,cAAc;YACjCG;YACAe,YAAY;gBAACR;gBAAIK;aAAG;QACtB;QAEAjB,OAAOmB,OAAOE,OAAO,CAACC,GAAG,CAAC,CAACC,IAAMA,EAAEV,IAAI,GAAGW,OAAO,CAAC;YAAC;YAAM;SAAK;QAC9DxB,OAAOmB,OAAOE,OAAO,CAAC,EAAE,CAAEN,YAAY,EAAES,OAAO,CAAC;YAAC;SAAO;QACxDxB,OAAOmB,OAAOM,MAAM,EAAEC,IAAI,CAAC;IAC7B;IAEAzB,GAAG,gEAAgE;QACjE,MAAMI,UAAUF,YAAY;YAAE,QAAQ;QAAqB;QAE3D,MAAMwB,OAAkB;YACtBd,MAAM;YACNC,OAAO;gBACL,MAAM,IAAIc,MAAM;YAClB;YACAZ,aAAa;QACf;QACA,MAAMa,KAAgB;YACpBhB,MAAM;YACNC,OAAO,IAAO,CAAA;oBAAEC,cAAc,EAAE;gBAAC,CAAA;YACjCC,aAAa;QACf;QAEA,MAAMG,SAAS,MAAMjB,cAAc;YACjCG;YACAe,YAAY;gBAACO;gBAAME;aAAG;QACxB;QAEA7B,OAAOmB,OAAOM,MAAM,EAAEC,IAAI,CAAC;QAC3B1B,OAAOmB,OAAOE,OAAO,CAACC,GAAG,CAAC,CAACC,IAAMA,EAAEV,IAAI,GAAGW,OAAO,CAAC;YAAC;YAAQ;SAAK;QAChExB,OAAOmB,OAAOE,OAAO,CAAC,EAAE,CAAES,KAAK,EAAEC,cAAc,CAACH;QAChD5B,OAAOmB,OAAOE,OAAO,CAAC,EAAE,CAAES,KAAK,EAAEE,aAAa;IAChD;AACF"}

package/dist/transforms/example-noop/index.spec.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=index.spec.d.ts.map

package/dist/transforms/example-noop/index.spec.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.spec.d.ts","sourceRoot":"","sources":["../../../src/transforms/example-noop/index.spec.ts"],"names":[],"mappings":""}

package/dist/transforms/example-noop/index.spec.js

@@ -1,29 +0,0 @@
-import { readFile } from 'node:fs/promises';
-import { dirname, join } from 'node:path';
-import { fileURLToPath } from 'node:url';
-import { describe, expect, it } from 'vitest';
-import { runTransform } from '../../utils/test-helpers.js';
-import { exampleNoop } from './index.js';
-const here = dirname(fileURLToPath(import.meta.url));
-const fixture = (name)=>readFile(join(here, name), 'utf8');
-describe('example-noop', ()=>{
-    it('leaves matching input unchanged', async ()=>{
-        const input = await fixture('basic.input.ts');
-        const output = await fixture('basic.output.ts');
-        const result = await runTransform({
-            source: input,
-            transform: exampleNoop
-        });
-        expect(result).toBe(output);
-    });
-    it('is idempotent', async ()=>{
-        const output = await fixture('basic.output.ts');
-        const result = await runTransform({
-            source: output,
-            transform: exampleNoop
-        });
-        expect(result).toBe(output);
-    });
-});
-
-//# sourceMappingURL=index.spec.js.map