@payloadcms/codemod 4.0.0-internal.f05c47f → 4.0.0-internal.f15737c

package/dist/upgrade/rewritePackageJson.js

@@ -0,0 +1,164 @@
+import semver from 'semver';
+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, placeholdersSkipped } = pinPayloadPackages(data, resolved.payloadVersion);
+    const overridesRemoved = removePayloadOverrides(data);
+    const floorsWritten = writeFloors(data, resolved);
+    return {
+        floorsWritten,
+        overridesRemoved,
+        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;
+            }
+            deps[name] = version;
+            pinned.push(name);
+        }
+    }
+    return {
+        pinnedPayload: pinned,
+        placeholdersSkipped: skipped
+    };
+}
+function removePayloadOverrides(data) {
+    const removed = [];
+    const pnpm = data.pnpm;
+    if (isRecord(pnpm) && isRecord(pnpm.overrides)) {
+        pruneOverrideBlock(pnpm.overrides, 'pnpm.overrides', removed);
+        if (Object.keys(pnpm.overrides).length === 0) {
+            delete pnpm.overrides;
+        }
+        if (Object.keys(pnpm).length === 0) {
+            delete data.pnpm;
+        }
+    }
+    for (const key of [
+        'overrides',
+        'resolutions'
+    ]){
+        const block = data[key];
+        if (isRecord(block)) {
+            pruneOverrideBlock(block, key, removed);
+            if (Object.keys(block).length === 0) {
+                delete data[key];
+            }
+        }
+    }
+    return removed;
+}
+function pruneOverrideBlock(block, label, removed) {
+    for (const name of Object.keys(block)){
+        if (isPayloadPackage(name)) {
+            delete block[name];
+            removed.push(`${label}.${name}`);
+        }
+    }
+}
+function writeFloors(data, resolved) {
+    const written = [];
+    if (writeDepFloor({
+        name: 'typescript',
+        data,
+        floor: resolved.typescript
+    })) {
+        written.push('typescript');
+    }
+    if (writeDepFloor({
+        name: '@types/node',
+        data,
+        floor: resolved.typesNode
+    })) {
+        written.push('@types/node');
+    }
+    const engines = isRecord(data.engines) ? data.engines : {};
+    if (engines.node === undefined || isBelowFloor({
+        floor: resolved.enginesNode,
+        spec: engines.node
+    })) {
+        engines.node = resolved.enginesNode;
+        data.engines = engines;
+        written.push('engines.node');
+    }
+    return written;
+}
+/**
+ * Raise a dep to `floor` wherever it already lives, else add it to devDependencies.
+ * Placeholder specs, non-semver specs (e.g. `latest`), and ranges already at or
+ * above the floor are left as-is. Returns whether the dep was written.
+ */ function writeDepFloor({ name, data, floor }) {
+    for (const field of DEP_FIELDS){
+        const deps = data[field];
+        if (!isRecord(deps) || !(name in deps)) {
+            continue;
+        }
+        const spec = deps[name];
+        if (isPlaceholderSpec(spec) || !isBelowFloor({
+            floor,
+            spec
+        })) {
+            return false;
+        }
+        deps[name] = floor;
+        return true;
+    }
+    const devDeps = isRecord(data.devDependencies) ? data.devDependencies : {};
+    devDeps[name] = floor;
+    data.devDependencies = devDeps;
+    return true;
+}
+/** True only when `spec` is a semver range whose lowest version is below the floor's. */ function isBelowFloor({ floor, spec }) {
+    if (typeof spec !== 'string' || !semver.validRange(spec)) {
+        return false;
+    }
+    const specMin = semver.minVersion(spec);
+    const floorMin = semver.minVersion(floor);
+    if (!specMin || !floorMin) {
+        return false;
+    }
+    return semver.lt(specMin, floorMin);
+}
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+
+//# sourceMappingURL=rewritePackageJson.js.map

package/dist/upgrade/rewritePackageJson.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/upgrade/rewritePackageJson.ts"],"sourcesContent":["import semver from 'semver'\n\nimport 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  if (writeDepFloor({ name: 'typescript', data, floor: resolved.typescript })) {\n    written.push('typescript')\n  }\n  if (writeDepFloor({ name: '@types/node', data, floor: resolved.typesNode })) {\n    written.push('@types/node')\n  }\n\n  const engines = isRecord(data.engines) ? data.engines : {}\n  if (\n    engines.node === undefined ||\n    isBelowFloor({ floor: resolved.enginesNode, spec: engines.node })\n  ) {\n    engines.node = resolved.enginesNode\n    data.engines = engines\n    written.push('engines.node')\n  }\n\n  return written\n}\n\n/**\n * Raise a dep to `floor` wherever it already lives, else add it to devDependencies.\n * Placeholder specs, non-semver specs (e.g. `latest`), and ranges already at or\n * above the floor are left as-is. Returns whether the dep was written.\n */\nfunction writeDepFloor({\n  name,\n  data,\n  floor,\n}: {\n  data: Record<string, unknown>\n  floor: string\n  name: string\n}): boolean {\n  for (const field of DEP_FIELDS) {\n    const deps = data[field]\n    if (!isRecord(deps) || !(name in deps)) {\n      continue\n    }\n    const spec = deps[name]\n    if (isPlaceholderSpec(spec) || !isBelowFloor({ floor, spec })) {\n      return false\n    }\n    deps[name] = floor\n    return true\n  }\n  const devDeps = isRecord(data.devDependencies) ? data.devDependencies : {}\n  devDeps[name] = floor\n  data.devDependencies = devDeps\n  return true\n}\n\n/** True only when `spec` is a semver range whose lowest version is below the floor's. */\nfunction isBelowFloor({ floor, spec }: { floor: string; spec: unknown }): boolean {\n  if (typeof spec !== 'string' || !semver.validRange(spec)) {\n    return false\n  }\n  const specMin = semver.minVersion(spec)\n  const floorMin = semver.minVersion(floor)\n  if (!specMin || !floorMin) {\n    return false\n  }\n  return semver.lt(specMin, floorMin)\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === 'object' && value !== null && !Array.isArray(value)\n}\n"],"names":["semver","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","writeDepFloor","floor","typescript","typesNode","engines","node","undefined","isBelowFloor","enginesNode","devDeps","devDependencies","validRange","specMin","minVersion","floorMin","lt","value","Array","isArray"],"mappings":"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"}

package/dist/upgrade/runInstall.d.ts

@@ -0,0 +1,16 @@
+import type { PackageManager, Spawn } from './types.js';
+type RunInstallArgs = {
+    packageManager: PackageManager;
+    path: string;
+    spawn: Spawn;
+};
+/**
+ * Install dependencies with the detected package manager. `install` is the same
+ * subcommand across pnpm/npm/yarn/bun. Corepack's interactive download prompt is
+ * disabled so a non-interactive run cannot hang and abort the install.
+ */
+export declare function runInstall({ packageManager, path, spawn, }: RunInstallArgs): Promise<{
+    code: number;
+}>;
+export {};
+//# sourceMappingURL=runInstall.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"runInstall.d.ts","sourceRoot":"","sources":["../../src/upgrade/runInstall.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AAEvD,KAAK,cAAc,GAAG;IACpB,cAAc,EAAE,cAAc,CAAA;IAC9B,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,KAAK,CAAA;CACb,CAAA;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,EACzB,cAAc,EACd,IAAI,EACJ,KAAK,GACN,EAAE,cAAc,GAAG,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAK5C"}

package/dist/upgrade/runInstall.js

@@ -0,0 +1,17 @@
+/**
+ * Install dependencies with the detected package manager. `install` is the same
+ * subcommand across pnpm/npm/yarn/bun. Corepack's interactive download prompt is
+ * disabled so a non-interactive run cannot hang and abort the install.
+ */ export function runInstall({ packageManager, path, spawn }) {
+    return spawn(packageManager, [
+        'install'
+    ], {
+        cwd: path,
+        env: {
+            ...process.env,
+            COREPACK_ENABLE_DOWNLOAD_PROMPT: '0'
+        }
+    });
+}
+
+//# sourceMappingURL=runInstall.js.map

package/dist/upgrade/runInstall.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/upgrade/runInstall.ts"],"sourcesContent":["import type { PackageManager, Spawn } from './types.js'\n\ntype RunInstallArgs = {\n  packageManager: PackageManager\n  path: string\n  spawn: Spawn\n}\n\n/**\n * Install dependencies with the detected package manager. `install` is the same\n * subcommand across pnpm/npm/yarn/bun. Corepack's interactive download prompt is\n * disabled so a non-interactive run cannot hang and abort the install.\n */\nexport function runInstall({\n  packageManager,\n  path,\n  spawn,\n}: RunInstallArgs): Promise<{ code: number }> {\n  return spawn(packageManager, ['install'], {\n    cwd: path,\n    env: { ...process.env, COREPACK_ENABLE_DOWNLOAD_PROMPT: '0' },\n  })\n}\n"],"names":["runInstall","packageManager","path","spawn","cwd","env","process","COREPACK_ENABLE_DOWNLOAD_PROMPT"],"mappings":"AAQA;;;;CAIC,GACD,OAAO,SAASA,WAAW,EACzBC,cAAc,EACdC,IAAI,EACJC,KAAK,EACU;IACf,OAAOA,MAAMF,gBAAgB;QAAC;KAAU,EAAE;QACxCG,KAAKF;QACLG,KAAK;YAAE,GAAGC,QAAQD,GAAG;YAAEE,iCAAiC;QAAI;IAC9D;AACF"}

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

@@ -0,0 +1,47 @@
+/** Minimal shape of an npm registry packument we read. */
+export type RegistryPackument = {
+    'dist-tags'?: Record<string, string>;
+    versions?: Record<string, {
+        engines?: Record<string, string>;
+        peerDependencies?: Record<string, string>;
+    }>;
+};
+export type FetchRegistry = (packageName: string) => Promise<RegistryPackument>;
+export type Spawn = (command: string, args: string[], options: {
+    cwd: string;
+    env: NodeJS.ProcessEnv;
+}) => Promise<{
+    code: number;
+}>;
+export type PackageManager = 'bun' | 'npm' | 'pnpm' | 'yarn';
+/** Target versions the command resolves. Only some are written; see `written`. */
+export type ResolvedVersions = {
+    /** Copied verbatim into engines.node. */
+    enginesNode: string;
+    /** Newest patch within @payloadcms/next's peer range. REPORT ONLY, never written. */
+    nextTarget: null | string;
+    /** Exact canary, applied in lockstep to payload + every @payloadcms/*. */
+    payloadVersion: string;
+    /** TypeScript floor (guide-sourced constant). */
+    typescript: string;
+    /** Newest @types/node patch within the Node major. */
+    typesNode: string;
+};
+export type UpgradeDeps = {
+    exists: (path: string) => boolean;
+    fetchRegistry: FetchRegistry;
+    spawn: Spawn;
+};
+/**
+ * TypeScript floor for Payload v4. Nothing machine-readable declares it, so it
+ * lives here, sourced from the v4 migration guide prose. Bump alongside the guide.
+ */
+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

@@ -0,0 +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;AAEpE;;;GAGG;AACH,eAAO,MAAM,6BAA6B,mBAAmB,CAAA"}

package/dist/upgrade/types.js

@@ -0,0 +1,11 @@
+/** Minimal shape of an npm registry packument we read. */ /**
+ * TypeScript floor for Payload v4. Nothing machine-readable declares it, so it
+ * 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

@@ -0,0 +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\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/dist/utils/project.d.ts

@@ -0,0 +1,10 @@
+import { Project } from 'ts-morph';
+/**
+ * Load a ts-morph Project rooted at `path`, using its tsconfig.json if present.
+ *
+ * Falls back to globbing when the tsconfig resolves no source files (e.g. a
+ * solution-style config with only `references`), so transforms never silently
+ * run against an empty project.
+ */
+export declare function loadProject(path: string): Project;
+//# sourceMappingURL=project.d.ts.map

package/dist/utils/project.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project.d.ts","sourceRoot":"","sources":["../../src/utils/project.ts"],"names":[],"mappings":"AAEA,OAAO,EAAmB,OAAO,EAAa,MAAM,UAAU,CAAA;AAQ9D;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAgBjD"}

package/dist/utils/project.js

@@ -0,0 +1,43 @@
+import { existsSync } from 'node:fs';
+import { resolve } from 'node:path';
+import { IndentationText, Project, QuoteKind } from 'ts-morph';
+const manipulationSettings = {
+    indentationText: IndentationText.TwoSpaces,
+    quoteKind: QuoteKind.Single,
+    useTrailingCommas: true
+};
+/**
+ * Load a ts-morph Project rooted at `path`, using its tsconfig.json if present.
+ *
+ * Falls back to globbing when the tsconfig resolves no source files (e.g. a
+ * solution-style config with only `references`), so transforms never silently
+ * run against an empty project.
+ */ export function loadProject(path) {
+    const tsconfigPath = resolve(path, 'tsconfig.json');
+    if (existsSync(tsconfigPath)) {
+        const project = new Project({
+            manipulationSettings,
+            tsConfigFilePath: tsconfigPath
+        });
+        if (project.getSourceFiles().length > 0) {
+            return project;
+        }
+        console.warn(`Warning: ${tsconfigPath} resolved no source files. Falling back to globbing ${path}.`);
+    }
+    return loadProjectFromGlob(path);
+}
+function loadProjectFromGlob(path) {
+    const project = new Project({
+        manipulationSettings
+    });
+    project.addSourceFilesAtPaths([
+        `${path}/**/*.{ts,tsx,js,jsx}`,
+        '!**/node_modules/**',
+        '!**/dist/**',
+        '!**/.next/**',
+        '!**/build/**'
+    ]);
+    return project;
+}
+
+//# sourceMappingURL=project.js.map

package/dist/utils/project.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utils/project.ts"],"sourcesContent":["import { existsSync } from 'node:fs'\nimport { resolve } from 'node:path'\nimport { IndentationText, Project, QuoteKind } from 'ts-morph'\n\nconst manipulationSettings = {\n  indentationText: IndentationText.TwoSpaces,\n  quoteKind: QuoteKind.Single,\n  useTrailingCommas: true,\n}\n\n/**\n * Load a ts-morph Project rooted at `path`, using its tsconfig.json if present.\n *\n * Falls back to globbing when the tsconfig resolves no source files (e.g. a\n * solution-style config with only `references`), so transforms never silently\n * run against an empty project.\n */\nexport function loadProject(path: string): Project {\n  const tsconfigPath = resolve(path, 'tsconfig.json')\n\n  if (existsSync(tsconfigPath)) {\n    const project = new Project({ manipulationSettings, tsConfigFilePath: tsconfigPath })\n\n    if (project.getSourceFiles().length > 0) {\n      return project\n    }\n\n    console.warn(\n      `Warning: ${tsconfigPath} resolved no source files. Falling back to globbing ${path}.`,\n    )\n  }\n\n  return loadProjectFromGlob(path)\n}\n\nfunction loadProjectFromGlob(path: string): Project {\n  const project = new Project({ manipulationSettings })\n  project.addSourceFilesAtPaths([\n    `${path}/**/*.{ts,tsx,js,jsx}`,\n    '!**/node_modules/**',\n    '!**/dist/**',\n    '!**/.next/**',\n    '!**/build/**',\n  ])\n  return project\n}\n"],"names":["existsSync","resolve","IndentationText","Project","QuoteKind","manipulationSettings","indentationText","TwoSpaces","quoteKind","Single","useTrailingCommas","loadProject","path","tsconfigPath","project","tsConfigFilePath","getSourceFiles","length","console","warn","loadProjectFromGlob","addSourceFilesAtPaths"],"mappings":"AAAA,SAASA,UAAU,QAAQ,UAAS;AACpC,SAASC,OAAO,QAAQ,YAAW;AACnC,SAASC,eAAe,EAAEC,OAAO,EAAEC,SAAS,QAAQ,WAAU;AAE9D,MAAMC,uBAAuB;IAC3BC,iBAAiBJ,gBAAgBK,SAAS;IAC1CC,WAAWJ,UAAUK,MAAM;IAC3BC,mBAAmB;AACrB;AAEA;;;;;;CAMC,GACD,OAAO,SAASC,YAAYC,IAAY;IACtC,MAAMC,eAAeZ,QAAQW,MAAM;IAEnC,IAAIZ,WAAWa,eAAe;QAC5B,MAAMC,UAAU,IAAIX,QAAQ;YAAEE;YAAsBU,kBAAkBF;QAAa;QAEnF,IAAIC,QAAQE,cAAc,GAAGC,MAAM,GAAG,GAAG;YACvC,OAAOH;QACT;QAEAI,QAAQC,IAAI,CACV,CAAC,SAAS,EAAEN,aAAa,oDAAoD,EAAED,KAAK,CAAC,CAAC;IAE1F;IAEA,OAAOQ,oBAAoBR;AAC7B;AAEA,SAASQ,oBAAoBR,IAAY;IACvC,MAAME,UAAU,IAAIX,QAAQ;QAAEE;IAAqB;IACnDS,QAAQO,qBAAqB,CAAC;QAC5B,GAAGT,KAAK,qBAAqB,CAAC;QAC9B;QACA;QACA;QACA;KACD;IACD,OAAOE;AACT"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@payloadcms/codemod",
-  "version": "4.0.0-internal.f05c47f",
+  "version": "4.0.0-internal.f15737c",
   "description": "Codemods for migrating Payload projects across versions.",
   "homepage": "https://payloadcms.com",
   "repository": {
@@ -29,20 +29,24 @@
     "README.md"
   ],
   "dependencies": {
-    "ts-morph": "^21.0.1"
+    "@clack/prompts": "1.2.0",
+    "semver": "^7.8.5",
+    "ts-morph": "^28.0.0"
   },
   "devDependencies": {
     "@swc/core": "1.15.3",
     "@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"
   },
   "scripts": {
-    "build": "pnpm typecheck && pnpm build:swc",
+    "build": "pnpm typecheck && pnpm build:swc && pnpm build:copy-docs",
+    "build:copy-docs": "node scripts/copy-migration-guide.mjs",
     "build:swc": "swc ./src -d ./dist --config-file .swcrc --strip-leading-paths",
     "clean": "rimraf -g {dist,*.tsbuildinfo}",
     "lint": "eslint .",

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,49 +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({
-            dry: false,
-            list: false,
-            path: process.cwd(),
-            print: false,
-            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);
-    });
-});
-
-//# 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      dry: false,\n      list: false,\n      path: process.cwd(),\n      print: false,\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"],"names":["describe","expect","it","parseFlags","toEqual","dry","list","path","process","cwd","print","transform","undefined","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,KAAK;YACLC,MAAM;YACNC,MAAMC,QAAQC,GAAG;YACjBC,OAAO;YACPC,WAAWC;QACb;IACF;IAEAV,GAAG,yBAAyB;QAC1BD,OAAOE,WAAW;YAAC;SAAQ,EAAEI,IAAI,EAAEM,IAAI,CAAC;IAC1C;IAEAX,GAAG,gBAAgB;QACjBD,OAAOE,WAAW;YAAC;YAAS;YAAS;SAAU,GAAGW,aAAa,CAAC;YAC9DT,KAAK;YACLE,MAAM;YACNG,OAAO;QACT;IACF;IAEAR,GAAG,sBAAsB;QACvBD,OAAOE,WAAW;YAAC;YAAe;SAAsB,GAAGW,aAAa,CAAC;YACvEH,WAAW;QACb;IACF;IAEAT,GAAG,iBAAiB;QAClBD,OAAOE,WAAW;YAAC;SAAS,EAAEG,IAAI,EAAEO,IAAI,CAAC;IAC3C;IAEAX,GAAG,0CAA0C;QAC3CD,OAAOE,WAAW;YAAC;SAAY,EAAEE,GAAG,EAAEQ,IAAI,CAAC;IAC7C;AACF"}

package/dist/runner.spec.d.ts

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