@payloadcms/codemod 4.0.0-internal.4a8e202 → 4.0.0-internal.4c2ee12

package/dist/transforms/rename-experimental-table-feature/basic.output.js

@@ -0,0 +1,19 @@
+import { TableFeature, FixedToolbarFeature, lexicalEditor } from '@payloadcms/richtext-lexical';
+export const RichText = {
+    fields: [
+        {
+            name: 'content',
+            type: 'richText',
+            editor: lexicalEditor({
+                features: ({ defaultFeatures })=>[
+                        ...defaultFeatures,
+                        FixedToolbarFeature(),
+                        TableFeature()
+                    ]
+            })
+        }
+    ],
+    slug: 'richtext'
+};
+
+//# sourceMappingURL=basic.output.js.map

package/dist/transforms/rename-experimental-table-feature/basic.output.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/transforms/rename-experimental-table-feature/basic.output.ts"],"sourcesContent":["import type { CollectionConfig } from 'payload'\n\nimport { TableFeature, FixedToolbarFeature, lexicalEditor } from '@payloadcms/richtext-lexical'\n\nexport const RichText: CollectionConfig = {\n  fields: [\n    {\n      name: 'content',\n      type: 'richText',\n      editor: lexicalEditor({\n        features: ({ defaultFeatures }) => [\n          ...defaultFeatures,\n          FixedToolbarFeature(),\n          TableFeature(),\n        ],\n      }),\n    },\n  ],\n  slug: 'richtext',\n}\n"],"names":["TableFeature","FixedToolbarFeature","lexicalEditor","RichText","fields","name","type","editor","features","defaultFeatures","slug"],"mappings":"AAEA,SAASA,YAAY,EAAEC,mBAAmB,EAAEC,aAAa,QAAQ,+BAA8B;AAE/F,OAAO,MAAMC,WAA6B;IACxCC,QAAQ;QACN;YACEC,MAAM;YACNC,MAAM;YACNC,QAAQL,cAAc;gBACpBM,UAAU,CAAC,EAAEC,eAAe,EAAE,GAAK;2BAC9BA;wBACHR;wBACAD;qBACD;YACH;QACF;KACD;IACDU,MAAM;AACR,EAAC"}

package/dist/transforms/rename-experimental-table-feature/collision.input.js

@@ -0,0 +1,7 @@
+import { EXPERIMENTAL_TableFeature, TableFeature } from '@payloadcms/richtext-lexical';
+export const features = [
+    EXPERIMENTAL_TableFeature(),
+    TableFeature()
+];
+
+//# sourceMappingURL=collision.input.js.map

package/dist/transforms/rename-experimental-table-feature/collision.input.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/transforms/rename-experimental-table-feature/collision.input.ts"],"sourcesContent":["import { EXPERIMENTAL_TableFeature, TableFeature } from '@payloadcms/richtext-lexical'\n\nexport const features = [EXPERIMENTAL_TableFeature(), TableFeature()]\n"],"names":["EXPERIMENTAL_TableFeature","TableFeature","features"],"mappings":"AAAA,SAASA,yBAAyB,EAAEC,YAAY,QAAQ,+BAA8B;AAEtF,OAAO,MAAMC,WAAW;IAACF;IAA6BC;CAAe,CAAA"}

package/dist/transforms/rename-experimental-table-feature/index.d.ts

@@ -0,0 +1,3 @@
+import type { Transform } from '../../types.js';
+export declare const renameExperimentalTableFeature: Transform;
+//# sourceMappingURL=index.d.ts.map

package/dist/transforms/rename-experimental-table-feature/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/transforms/rename-experimental-table-feature/index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAM/C,eAAO,MAAM,8BAA8B,EAAE,SAkD5C,CAAA"}

package/dist/transforms/rename-experimental-table-feature/index.js

@@ -0,0 +1,50 @@
+import { Node } from 'ts-morph';
+const PACKAGE_NAME = '@payloadcms/richtext-lexical';
+const OLD_NAME = 'EXPERIMENTAL_TableFeature';
+const NEW_NAME = 'TableFeature';
+export const renameExperimentalTableFeature = {
+    name: 'rename-experimental-table-feature',
+    apply: ({ project })=>{
+        const filesChanged = new Set();
+        for (const file of project.getSourceFiles()){
+            for (const importDecl of file.getImportDeclarations()){
+                if (importDecl.getModuleSpecifierValue() !== PACKAGE_NAME) {
+                    continue;
+                }
+                const named = importDecl.getNamedImports();
+                const spec = named.find((specifier)=>specifier.getName() === OLD_NAME);
+                if (!spec) {
+                    continue;
+                }
+                // Skip if `TableFeature` is already imported here too, to avoid a collision.
+                const hasNewName = named.some((specifier)=>(specifier.getAliasNode()?.getText() ?? specifier.getName()) === NEW_NAME);
+                if (hasNewName) {
+                    continue;
+                }
+                if (spec.getAliasNode()) {
+                    // Aliased usages (`EXPERIMENTAL_TableFeature as Foo`) only reference the alias,
+                    // so the imported name can be swapped without touching call sites.
+                    spec.setName(NEW_NAME);
+                } else {
+                    // No alias: the imported name is also the local binding, so rename it to update
+                    // every call site (e.g. `EXPERIMENTAL_TableFeature()`) in the same pass.
+                    const nameNode = spec.getNameNode();
+                    // Always an Identifier in valid code: a string-literal import name requires an alias.
+                    if (!Node.isIdentifier(nameNode)) {
+                        continue;
+                    }
+                    nameNode.rename(NEW_NAME);
+                }
+                filesChanged.add(file.getFilePath());
+            }
+        }
+        return {
+            filesChanged: [
+                ...filesChanged
+            ]
+        };
+    },
+    description: 'Renames imports of `EXPERIMENTAL_TableFeature` from `@payloadcms/richtext-lexical` to `TableFeature` (the table feature is now stable) and updates all local usages.'
+};
+
+//# sourceMappingURL=index.js.map

package/dist/transforms/rename-experimental-table-feature/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/transforms/rename-experimental-table-feature/index.ts"],"sourcesContent":["import { Node } from 'ts-morph'\n\nimport type { Transform } from '../../types.js'\n\nconst PACKAGE_NAME = '@payloadcms/richtext-lexical'\nconst OLD_NAME = 'EXPERIMENTAL_TableFeature'\nconst NEW_NAME = 'TableFeature'\n\nexport const renameExperimentalTableFeature: Transform = {\n  name: 'rename-experimental-table-feature',\n  apply: ({ project }) => {\n    const filesChanged = new Set<string>()\n\n    for (const file of project.getSourceFiles()) {\n      for (const importDecl of file.getImportDeclarations()) {\n        if (importDecl.getModuleSpecifierValue() !== PACKAGE_NAME) {\n          continue\n        }\n\n        const named = importDecl.getNamedImports()\n        const spec = named.find((specifier) => specifier.getName() === OLD_NAME)\n        if (!spec) {\n          continue\n        }\n\n        // Skip if `TableFeature` is already imported here too, to avoid a collision.\n        const hasNewName = named.some(\n          (specifier) => (specifier.getAliasNode()?.getText() ?? specifier.getName()) === NEW_NAME,\n        )\n        if (hasNewName) {\n          continue\n        }\n\n        if (spec.getAliasNode()) {\n          // Aliased usages (`EXPERIMENTAL_TableFeature as Foo`) only reference the alias,\n          // so the imported name can be swapped without touching call sites.\n          spec.setName(NEW_NAME)\n        } else {\n          // No alias: the imported name is also the local binding, so rename it to update\n          // every call site (e.g. `EXPERIMENTAL_TableFeature()`) in the same pass.\n          const nameNode = spec.getNameNode()\n\n          // Always an Identifier in valid code: a string-literal import name requires an alias.\n          if (!Node.isIdentifier(nameNode)) {\n            continue\n          }\n\n          nameNode.rename(NEW_NAME)\n        }\n\n        filesChanged.add(file.getFilePath())\n      }\n    }\n\n    return { filesChanged: [...filesChanged] }\n  },\n  description:\n    'Renames imports of `EXPERIMENTAL_TableFeature` from `@payloadcms/richtext-lexical` to `TableFeature` (the table feature is now stable) and updates all local usages.',\n}\n"],"names":["Node","PACKAGE_NAME","OLD_NAME","NEW_NAME","renameExperimentalTableFeature","name","apply","project","filesChanged","Set","file","getSourceFiles","importDecl","getImportDeclarations","getModuleSpecifierValue","named","getNamedImports","spec","find","specifier","getName","hasNewName","some","getAliasNode","getText","setName","nameNode","getNameNode","isIdentifier","rename","add","getFilePath","description"],"mappings":"AAAA,SAASA,IAAI,QAAQ,WAAU;AAI/B,MAAMC,eAAe;AACrB,MAAMC,WAAW;AACjB,MAAMC,WAAW;AAEjB,OAAO,MAAMC,iCAA4C;IACvDC,MAAM;IACNC,OAAO,CAAC,EAAEC,OAAO,EAAE;QACjB,MAAMC,eAAe,IAAIC;QAEzB,KAAK,MAAMC,QAAQH,QAAQI,cAAc,GAAI;YAC3C,KAAK,MAAMC,cAAcF,KAAKG,qBAAqB,GAAI;gBACrD,IAAID,WAAWE,uBAAuB,OAAOb,cAAc;oBACzD;gBACF;gBAEA,MAAMc,QAAQH,WAAWI,eAAe;gBACxC,MAAMC,OAAOF,MAAMG,IAAI,CAAC,CAACC,YAAcA,UAAUC,OAAO,OAAOlB;gBAC/D,IAAI,CAACe,MAAM;oBACT;gBACF;gBAEA,6EAA6E;gBAC7E,MAAMI,aAAaN,MAAMO,IAAI,CAC3B,CAACH,YAAc,AAACA,CAAAA,UAAUI,YAAY,IAAIC,aAAaL,UAAUC,OAAO,EAAC,MAAOjB;gBAElF,IAAIkB,YAAY;oBACd;gBACF;gBAEA,IAAIJ,KAAKM,YAAY,IAAI;oBACvB,gFAAgF;oBAChF,mEAAmE;oBACnEN,KAAKQ,OAAO,CAACtB;gBACf,OAAO;oBACL,gFAAgF;oBAChF,yEAAyE;oBACzE,MAAMuB,WAAWT,KAAKU,WAAW;oBAEjC,sFAAsF;oBACtF,IAAI,CAAC3B,KAAK4B,YAAY,CAACF,WAAW;wBAChC;oBACF;oBAEAA,SAASG,MAAM,CAAC1B;gBAClB;gBAEAK,aAAasB,GAAG,CAACpB,KAAKqB,WAAW;YACnC;QACF;QAEA,OAAO;YAAEvB,cAAc;mBAAIA;aAAa;QAAC;IAC3C;IACAwB,aACE;AACJ,EAAC"}

package/dist/transforms/rename-experimental-table-feature/no-match.input.js

@@ -0,0 +1,9 @@
+import { FixedToolbarFeature, lexicalEditor } from '@payloadcms/richtext-lexical';
+export const editor = lexicalEditor({
+    features: ({ defaultFeatures })=>[
+            ...defaultFeatures,
+            FixedToolbarFeature()
+        ]
+});
+
+//# sourceMappingURL=no-match.input.js.map

package/dist/transforms/rename-experimental-table-feature/no-match.input.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/transforms/rename-experimental-table-feature/no-match.input.ts"],"sourcesContent":["import { FixedToolbarFeature, lexicalEditor } from '@payloadcms/richtext-lexical'\n\nexport const editor = lexicalEditor({\n  features: ({ defaultFeatures }) => [...defaultFeatures, FixedToolbarFeature()],\n})\n"],"names":["FixedToolbarFeature","lexicalEditor","editor","features","defaultFeatures"],"mappings":"AAAA,SAASA,mBAAmB,EAAEC,aAAa,QAAQ,+BAA8B;AAEjF,OAAO,MAAMC,SAASD,cAAc;IAClCE,UAAU,CAAC,EAAEC,eAAe,EAAE,GAAK;eAAIA;YAAiBJ;SAAsB;AAChF,GAAE"}

package/dist/upgrade/defaultTag.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Default Payload dist-tag when the caller did not pass --tag. Every package in
+ * the monorepo (this one included) is versioned and published in lockstep, so
+ * the dist-tag the codemod was invoked under (`npx @payloadcms/codemod@beta`)
+ * surfaces as its own version's prerelease id. Follow that train; fall back to
+ * canary for stable or local dev builds that carry no prerelease id.
+ */
+export declare function resolveDefaultTag(version?: string | undefined): string;
+//# sourceMappingURL=defaultTag.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"defaultTag.d.ts","sourceRoot":"","sources":["../../src/upgrade/defaultTag.ts"],"names":[],"mappings":"AAQA;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,GAAE,MAAM,GAAG,SAA4B,GAAG,MAAM,CAGxF"}

package/dist/upgrade/defaultTag.js

@@ -0,0 +1,25 @@
+import { readFileSync } from 'node:fs';
+import { dirname, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import semver from 'semver';
+/** Dist-tag used when neither --tag nor the running version implies one. */ const FALLBACK_TAG = 'canary';
+/**
+ * Default Payload dist-tag when the caller did not pass --tag. Every package in
+ * the monorepo (this one included) is versioned and published in lockstep, so
+ * the dist-tag the codemod was invoked under (`npx @payloadcms/codemod@beta`)
+ * surfaces as its own version's prerelease id. Follow that train; fall back to
+ * canary for stable or local dev builds that carry no prerelease id.
+ */ export function resolveDefaultTag(version = readOwnVersion()) {
+    const id = version ? semver.prerelease(version)?.[0] : undefined;
+    return typeof id === 'string' ? id : FALLBACK_TAG;
+}
+function readOwnVersion() {
+    try {
+        const pkgPath = resolve(dirname(fileURLToPath(import.meta.url)), '..', '..', 'package.json');
+        return JSON.parse(readFileSync(pkgPath, 'utf8')).version;
+    } catch  {
+        return undefined;
+    }
+}
+
+//# sourceMappingURL=defaultTag.js.map

package/dist/upgrade/defaultTag.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/upgrade/defaultTag.ts"],"sourcesContent":["import { readFileSync } from 'node:fs'\nimport { dirname, resolve } from 'node:path'\nimport { fileURLToPath } from 'node:url'\nimport semver from 'semver'\n\n/** Dist-tag used when neither --tag nor the running version implies one. */\nconst FALLBACK_TAG = 'canary'\n\n/**\n * Default Payload dist-tag when the caller did not pass --tag. Every package in\n * the monorepo (this one included) is versioned and published in lockstep, so\n * the dist-tag the codemod was invoked under (`npx @payloadcms/codemod@beta`)\n * surfaces as its own version's prerelease id. Follow that train; fall back to\n * canary for stable or local dev builds that carry no prerelease id.\n */\nexport function resolveDefaultTag(version: string | undefined = readOwnVersion()): string {\n  const id = version ? semver.prerelease(version)?.[0] : undefined\n  return typeof id === 'string' ? id : FALLBACK_TAG\n}\n\nfunction readOwnVersion(): string | undefined {\n  try {\n    const pkgPath = resolve(dirname(fileURLToPath(import.meta.url)), '..', '..', 'package.json')\n    return JSON.parse(readFileSync(pkgPath, 'utf8')).version as string\n  } catch {\n    return undefined\n  }\n}\n"],"names":["readFileSync","dirname","resolve","fileURLToPath","semver","FALLBACK_TAG","resolveDefaultTag","version","readOwnVersion","id","prerelease","undefined","pkgPath","url","JSON","parse"],"mappings":"AAAA,SAASA,YAAY,QAAQ,UAAS;AACtC,SAASC,OAAO,EAAEC,OAAO,QAAQ,YAAW;AAC5C,SAASC,aAAa,QAAQ,WAAU;AACxC,OAAOC,YAAY,SAAQ;AAE3B,0EAA0E,GAC1E,MAAMC,eAAe;AAErB;;;;;;CAMC,GACD,OAAO,SAASC,kBAAkBC,UAA8BC,gBAAgB;IAC9E,MAAMC,KAAKF,UAAUH,OAAOM,UAAU,CAACH,UAAU,CAAC,EAAE,GAAGI;IACvD,OAAO,OAAOF,OAAO,WAAWA,KAAKJ;AACvC;AAEA,SAASG;IACP,IAAI;QACF,MAAMI,UAAUV,QAAQD,QAAQE,cAAc,YAAYU,GAAG,IAAI,MAAM,MAAM;QAC7E,OAAOC,KAAKC,KAAK,CAACf,aAAaY,SAAS,SAASL,OAAO;IAC1D,EAAE,OAAM;QACN,OAAOI;IACT;AACF"}

package/dist/upgrade/detectPackageManager.d.ts

@@ -0,0 +1,8 @@
+import type { PackageManager } from './types.js';
+/**
+ * Map a project directory's lockfile to its package manager. `exists` is
+ * injectable so callers can test offline; it defaults to the real filesystem.
+ * pnpm is checked first, so it wins in a multi-lockfile repo.
+ */
+export declare function detectPackageManager(projectPath: string, exists?: (path: string) => boolean): PackageManager;
+//# sourceMappingURL=detectPackageManager.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"detectPackageManager.d.ts","sourceRoot":"","sources":["../../src/upgrade/detectPackageManager.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAUhD;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,WAAW,EAAE,MAAM,EACnB,MAAM,GAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAoB,GAC7C,cAAc,CAOhB"}

package/dist/upgrade/detectPackageManager.js

@@ -0,0 +1,38 @@
+import { existsSync } from 'node:fs';
+import { join } from 'node:path';
+const LOCKFILES = [
+    {
+        file: 'pnpm-lock.yaml',
+        pm: 'pnpm'
+    },
+    {
+        file: 'yarn.lock',
+        pm: 'yarn'
+    },
+    {
+        file: 'bun.lockb',
+        pm: 'bun'
+    },
+    {
+        file: 'bun.lock',
+        pm: 'bun'
+    },
+    {
+        file: 'package-lock.json',
+        pm: 'npm'
+    }
+];
+/**
+ * Map a project directory's lockfile to its package manager. `exists` is
+ * injectable so callers can test offline; it defaults to the real filesystem.
+ * pnpm is checked first, so it wins in a multi-lockfile repo.
+ */ export function detectPackageManager(projectPath, exists = existsSync) {
+    for (const { file, pm } of LOCKFILES){
+        if (exists(join(projectPath, file))) {
+            return pm;
+        }
+    }
+    return 'npm';
+}
+
+//# sourceMappingURL=detectPackageManager.js.map

package/dist/upgrade/detectPackageManager.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/upgrade/detectPackageManager.ts"],"sourcesContent":["import { existsSync } from 'node:fs'\nimport { join } from 'node:path'\n\nimport type { PackageManager } from './types.js'\n\nconst LOCKFILES: { file: string; pm: PackageManager }[] = [\n  { file: 'pnpm-lock.yaml', pm: 'pnpm' },\n  { file: 'yarn.lock', pm: 'yarn' },\n  { file: 'bun.lockb', pm: 'bun' },\n  { file: 'bun.lock', pm: 'bun' },\n  { file: 'package-lock.json', pm: 'npm' },\n]\n\n/**\n * Map a project directory's lockfile to its package manager. `exists` is\n * injectable so callers can test offline; it defaults to the real filesystem.\n * pnpm is checked first, so it wins in a multi-lockfile repo.\n */\nexport function detectPackageManager(\n  projectPath: string,\n  exists: (path: string) => boolean = existsSync,\n): PackageManager {\n  for (const { file, pm } of LOCKFILES) {\n    if (exists(join(projectPath, file))) {\n      return pm\n    }\n  }\n  return 'npm'\n}\n"],"names":["existsSync","join","LOCKFILES","file","pm","detectPackageManager","projectPath","exists"],"mappings":"AAAA,SAASA,UAAU,QAAQ,UAAS;AACpC,SAASC,IAAI,QAAQ,YAAW;AAIhC,MAAMC,YAAoD;IACxD;QAAEC,MAAM;QAAkBC,IAAI;IAAO;IACrC;QAAED,MAAM;QAAaC,IAAI;IAAO;IAChC;QAAED,MAAM;QAAaC,IAAI;IAAM;IAC/B;QAAED,MAAM;QAAYC,IAAI;IAAM;IAC9B;QAAED,MAAM;QAAqBC,IAAI;IAAM;CACxC;AAED;;;;CAIC,GACD,OAAO,SAASC,qBACdC,WAAmB,EACnBC,SAAoCP,UAAU;IAE9C,KAAK,MAAM,EAAEG,IAAI,EAAEC,EAAE,EAAE,IAAIF,UAAW;QACpC,IAAIK,OAAON,KAAKK,aAAaH,QAAQ;YACnC,OAAOC;QACT;IACF;IACA,OAAO;AACT"}

package/dist/upgrade/dispatch.d.ts

@@ -0,0 +1,38 @@
+import type { Agent, DispatchChoice } from './selectAgent.js';
+import { runUpgrade } from './index.js';
+type UpgradeFlags = Parameters<typeof runUpgrade>[0]['flags'];
+type RunDispatchArgs = {
+    agentFlag?: string;
+    path: string;
+    upgradeFlags: UpgradeFlags;
+};
+export type DispatchDeps = {
+    detectAgents: () => Agent[];
+    isInteractive: boolean;
+    promptChoice: (agents: Agent[]) => Promise<DispatchChoice>;
+    renderPrompt: () => string;
+    runMechanical: (args: {
+        flags: UpgradeFlags;
+        path: string;
+    }) => Promise<{
+        failed: boolean;
+    }>;
+    spawnAgent: (args: {
+        agent: Agent;
+        cwd: string;
+        promptFilePath: string;
+    }) => Promise<{
+        code: number;
+    }>;
+    writePromptFile: (contents: string) => string;
+};
+/**
+ * Bare `upgrade`: pick how to run the full v3 -> v4 upgrade. Hands the
+ * orchestration prompt to a detected coding agent, runs the mechanical slice
+ * here, or prints the prompt for manual use.
+ */
+export declare function runDispatch({ agentFlag, path, upgradeFlags }: RunDispatchArgs, deps?: DispatchDeps): Promise<{
+    failed: boolean;
+}>;
+export {};
+//# sourceMappingURL=dispatch.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dispatch.d.ts","sourceRoot":"","sources":["../../src/upgrade/dispatch.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AAE7D,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAKvC,KAAK,YAAY,GAAG,UAAU,CAAC,OAAO,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAA;AAE7D,KAAK,eAAe,GAAG;IACrB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,IAAI,EAAE,MAAM,CAAA;IACZ,YAAY,EAAE,YAAY,CAAA;CAC3B,CAAA;AAED,MAAM,MAAM,YAAY,GAAG;IACzB,YAAY,EAAE,MAAM,KAAK,EAAE,CAAA;IAC3B,aAAa,EAAE,OAAO,CAAA;IACtB,YAAY,EAAE,CAAC,MAAM,EAAE,KAAK,EAAE,KAAK,OAAO,CAAC,cAAc,CAAC,CAAA;IAC1D,YAAY,EAAE,MAAM,MAAM,CAAA;IAC1B,aAAa,EAAE,CAAC,IAAI,EAAE;QAAE,KAAK,EAAE,YAAY,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,KAAK,OAAO,CAAC;QAAE,MAAM,EAAE,OAAO,CAAA;KAAE,CAAC,CAAA;IAC5F,UAAU,EAAE,CAAC,IAAI,EAAE;QAAE,KAAK,EAAE,KAAK,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,cAAc,EAAE,MAAM,CAAA;KAAE,KAAK,OAAO,CAAC;QACnF,IAAI,EAAE,MAAM,CAAA;KACb,CAAC,CAAA;IACF,eAAe,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,MAAM,CAAA;CAC9C,CAAA;AAED;;;;GAIG;AACH,wBAAsB,WAAW,CAC/B,EAAE,SAAS,EAAE,IAAI,EAAE,YAAY,EAAE,EAAE,eAAe,EAClD,IAAI,GAAE,YAAoC,GACzC,OAAO,CAAC;IAAE,MAAM,EAAE,OAAO,CAAA;CAAE,CAAC,CAmC9B"}

package/dist/upgrade/dispatch.js

@@ -0,0 +1,132 @@
+/* eslint-disable no-console */ import * as p from '@clack/prompts';
+import { spawn } from 'node:child_process';
+import { mkdtempSync, writeFileSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join, resolve } from 'node:path';
+import { runUpgrade } from './index.js';
+import { renderUpgradePrompt } from './prompt.js';
+import { detectInstalledAgents, selectDispatch } from './selectAgent.js';
+import { resolveSelfCommand } from './selfCommand.js';
+/**
+ * Bare `upgrade`: pick how to run the full v3 -> v4 upgrade. Hands the
+ * orchestration prompt to a detected coding agent, runs the mechanical slice
+ * here, or prints the prompt for manual use.
+ */ export async function runDispatch({ agentFlag, path, upgradeFlags }, deps = defaultDispatchDeps()) {
+    const installed = deps.detectAgents();
+    let choice;
+    try {
+        choice = await selectDispatch({
+            agentFlag,
+            installed,
+            isInteractive: deps.isInteractive,
+            prompt: deps.promptChoice
+        });
+    } catch (err) {
+        console.error(err instanceof Error ? err.message : String(err));
+        return {
+            failed: true
+        };
+    }
+    if (choice.kind === 'run') {
+        return deps.runMechanical({
+            flags: upgradeFlags,
+            path
+        });
+    }
+    const promptText = deps.renderPrompt();
+    if (choice.kind === 'print') {
+        console.log(promptText);
+        return {
+            failed: false
+        };
+    }
+    const promptFilePath = deps.writePromptFile(promptText);
+    console.log(`Handing the upgrade prompt to ${choice.agent.label}...`);
+    const { code } = await deps.spawnAgent({
+        agent: choice.agent,
+        cwd: resolve(path),
+        promptFilePath
+    });
+    return {
+        failed: code !== 0
+    };
+}
+function defaultDispatchDeps() {
+    return {
+        detectAgents: detectInstalledAgents,
+        isInteractive: Boolean(process.stdin.isTTY && process.stdout.isTTY),
+        promptChoice: promptChoiceFromTerminal,
+        renderPrompt: ()=>renderUpgradePrompt({
+                command: resolveSelfCommand()
+            }),
+        runMechanical: (args)=>runUpgrade(args),
+        spawnAgent: spawnAgentInteractive,
+        writePromptFile: (contents)=>{
+            const dir = mkdtempSync(join(tmpdir(), 'payload-v4-upgrade-'));
+            const filePath = join(dir, 'prompt.md');
+            writeFileSync(filePath, contents);
+            return filePath;
+        }
+    };
+}
+/** Clack select: each installed agent, then run the slice or print the prompt. */ async function promptChoiceFromTerminal(agents) {
+    p.intro('Payload v3 -> v4 upgrade');
+    const selection = await p.select({
+        message: 'How do you want to run it?',
+        options: [
+            ...agents.map((agent)=>({
+                    hint: `hand the prompt to \`${agent.command}\``,
+                    label: agent.label,
+                    value: agent.id
+                })),
+            {
+                hint: 'pin versions, install, run the codemods now',
+                label: 'Run the mechanical steps',
+                value: 'run'
+            },
+            {
+                hint: 'run it yourself or paste it elsewhere',
+                label: 'Just print the prompt',
+                value: 'print'
+            }
+        ]
+    });
+    // Cancelling (Ctrl-C) falls back to printing the prompt so the user keeps it.
+    if (p.isCancel(selection)) {
+        return {
+            kind: 'print'
+        };
+    }
+    if (selection === 'run') {
+        return {
+            kind: 'run'
+        };
+    }
+    const agent = agents.find((a)=>a.id === selection);
+    return agent ? {
+        agent,
+        kind: 'agent'
+    } : {
+        kind: 'print'
+    };
+}
+/** Interactive agent session seeded with a one-line pointer to the prompt file. */ function spawnAgentInteractive({ agent, cwd, promptFilePath }) {
+    const launchPrompt = `Read ${promptFilePath} and follow it to upgrade this project from Payload v3 to v4.`;
+    return new Promise((resolveSpawn)=>{
+        const child = spawn(agent.command, [
+            launchPrompt
+        ], {
+            cwd,
+            shell: false,
+            stdio: 'inherit'
+        });
+        child.on('close', (code)=>resolveSpawn({
+                code: code ?? 1
+            }));
+        child.on('error', ()=>resolveSpawn({
+                code: 1
+            }));
+    });
+}
+
+//# sourceMappingURL=dispatch.js.map

package/dist/upgrade/dispatch.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/upgrade/dispatch.ts"],"sourcesContent":["/* eslint-disable no-console */\nimport * as p from '@clack/prompts'\nimport { spawn } from 'node:child_process'\nimport { mkdtempSync, writeFileSync } from 'node:fs'\nimport { tmpdir } from 'node:os'\nimport { join, resolve } from 'node:path'\n\nimport type { Agent, DispatchChoice } from './selectAgent.js'\n\nimport { runUpgrade } from './index.js'\nimport { renderUpgradePrompt } from './prompt.js'\nimport { detectInstalledAgents, selectDispatch } from './selectAgent.js'\nimport { resolveSelfCommand } from './selfCommand.js'\n\ntype UpgradeFlags = Parameters<typeof runUpgrade>[0]['flags']\n\ntype RunDispatchArgs = {\n  agentFlag?: string\n  path: string\n  upgradeFlags: UpgradeFlags\n}\n\nexport type DispatchDeps = {\n  detectAgents: () => Agent[]\n  isInteractive: boolean\n  promptChoice: (agents: Agent[]) => Promise<DispatchChoice>\n  renderPrompt: () => string\n  runMechanical: (args: { flags: UpgradeFlags; path: string }) => Promise<{ failed: boolean }>\n  spawnAgent: (args: { agent: Agent; cwd: string; promptFilePath: string }) => Promise<{\n    code: number\n  }>\n  writePromptFile: (contents: string) => string\n}\n\n/**\n * Bare `upgrade`: pick how to run the full v3 -> v4 upgrade. Hands the\n * orchestration prompt to a detected coding agent, runs the mechanical slice\n * here, or prints the prompt for manual use.\n */\nexport async function runDispatch(\n  { agentFlag, path, upgradeFlags }: RunDispatchArgs,\n  deps: DispatchDeps = defaultDispatchDeps(),\n): Promise<{ failed: boolean }> {\n  const installed = deps.detectAgents()\n\n  let choice: DispatchChoice\n  try {\n    choice = await selectDispatch({\n      agentFlag,\n      installed,\n      isInteractive: deps.isInteractive,\n      prompt: deps.promptChoice,\n    })\n  } catch (err) {\n    console.error(err instanceof Error ? err.message : String(err))\n    return { failed: true }\n  }\n\n  if (choice.kind === 'run') {\n    return deps.runMechanical({ flags: upgradeFlags, path })\n  }\n\n  const promptText = deps.renderPrompt()\n\n  if (choice.kind === 'print') {\n    console.log(promptText)\n    return { failed: false }\n  }\n\n  const promptFilePath = deps.writePromptFile(promptText)\n  console.log(`Handing the upgrade prompt to ${choice.agent.label}...`)\n  const { code } = await deps.spawnAgent({\n    agent: choice.agent,\n    cwd: resolve(path),\n    promptFilePath,\n  })\n  return { failed: code !== 0 }\n}\n\nfunction defaultDispatchDeps(): DispatchDeps {\n  return {\n    detectAgents: detectInstalledAgents,\n    isInteractive: Boolean(process.stdin.isTTY && process.stdout.isTTY),\n    promptChoice: promptChoiceFromTerminal,\n    renderPrompt: () => renderUpgradePrompt({ command: resolveSelfCommand() }),\n    runMechanical: (args) => runUpgrade(args),\n    spawnAgent: spawnAgentInteractive,\n    writePromptFile: (contents) => {\n      const dir = mkdtempSync(join(tmpdir(), 'payload-v4-upgrade-'))\n      const filePath = join(dir, 'prompt.md')\n      writeFileSync(filePath, contents)\n      return filePath\n    },\n  }\n}\n\n/** Clack select: each installed agent, then run the slice or print the prompt. */\nasync function promptChoiceFromTerminal(agents: Agent[]): Promise<DispatchChoice> {\n  p.intro('Payload v3 -> v4 upgrade')\n  const selection = await p.select({\n    message: 'How do you want to run it?',\n    options: [\n      ...agents.map((agent) => ({\n        hint: `hand the prompt to \\`${agent.command}\\``,\n        label: agent.label,\n        value: agent.id,\n      })),\n      {\n        hint: 'pin versions, install, run the codemods now',\n        label: 'Run the mechanical steps',\n        value: 'run',\n      },\n      {\n        hint: 'run it yourself or paste it elsewhere',\n        label: 'Just print the prompt',\n        value: 'print',\n      },\n    ],\n  })\n\n  // Cancelling (Ctrl-C) falls back to printing the prompt so the user keeps it.\n  if (p.isCancel(selection)) {\n    return { kind: 'print' }\n  }\n  if (selection === 'run') {\n    return { kind: 'run' }\n  }\n  const agent = agents.find((a) => a.id === selection)\n  return agent ? { agent, kind: 'agent' } : { kind: 'print' }\n}\n\n/** Interactive agent session seeded with a one-line pointer to the prompt file. */\nfunction spawnAgentInteractive({\n  agent,\n  cwd,\n  promptFilePath,\n}: {\n  agent: Agent\n  cwd: string\n  promptFilePath: string\n}): Promise<{ code: number }> {\n  const launchPrompt = `Read ${promptFilePath} and follow it to upgrade this project from Payload v3 to v4.`\n  return new Promise((resolveSpawn) => {\n    const child = spawn(agent.command, [launchPrompt], { cwd, shell: false, stdio: 'inherit' })\n    child.on('close', (code) => resolveSpawn({ code: code ?? 1 }))\n    child.on('error', () => resolveSpawn({ code: 1 }))\n  })\n}\n"],"names":["p","spawn","mkdtempSync","writeFileSync","tmpdir","join","resolve","runUpgrade","renderUpgradePrompt","detectInstalledAgents","selectDispatch","resolveSelfCommand","runDispatch","agentFlag","path","upgradeFlags","deps","defaultDispatchDeps","installed","detectAgents","choice","isInteractive","prompt","promptChoice","err","console","error","Error","message","String","failed","kind","runMechanical","flags","promptText","renderPrompt","log","promptFilePath","writePromptFile","agent","label","code","spawnAgent","cwd","Boolean","process","stdin","isTTY","stdout","promptChoiceFromTerminal","command","args","spawnAgentInteractive","contents","dir","filePath","agents","intro","selection","select","options","map","hint","value","id","isCancel","find","a","launchPrompt","Promise","resolveSpawn","child","shell","stdio","on"],"mappings":"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"}

package/dist/upgrade/index.d.ts

@@ -0,0 +1,25 @@
+import type { UpgradeDeps } from './types.js';
+import { runTransforms as defaultRunTransforms } from '../runner.js';
+export type UpgradeFlags = {
+    dry: boolean;
+    force: boolean;
+    /** Explicit --tag; when absent the default is derived from the running version. */
+    tag?: string;
+};
+type RunUpgradeArgs = {
+    flags: UpgradeFlags;
+    path: string;
+};
+type RunUpgradeOverrides = {
+    runTransforms?: typeof defaultRunTransforms;
+};
+/**
+ * Compose the upgrade pipeline: preflight -> resolve -> rewrite -> install ->
+ * verify -> transforms -> report. Install runs before transforms so a failed
+ * install aborts before any codemod touches source files.
+ */
+export declare function runUpgrade({ flags, path }: RunUpgradeArgs, deps?: UpgradeDeps, overrides?: RunUpgradeOverrides): Promise<{
+    failed: boolean;
+}>;
+export {};
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/upgrade/index.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAuC,WAAW,EAAE,MAAM,YAAY,CAAA;AAGlF,OAAO,EAAE,aAAa,IAAI,oBAAoB,EAAE,MAAM,cAAc,CAAA;AAepE,MAAM,MAAM,YAAY,GAAG;IACzB,GAAG,EAAE,OAAO,CAAA;IACZ,KAAK,EAAE,OAAO,CAAA;IACd,mFAAmF;IACnF,GAAG,CAAC,EAAE,MAAM,CAAA;CACb,CAAA;AAED,KAAK,cAAc,GAAG;IACpB,KAAK,EAAE,YAAY,CAAA;IACnB,IAAI,EAAE,MAAM,CAAA;CACb,CAAA;AAED,KAAK,mBAAmB,GAAG;IACzB,aAAa,CAAC,EAAE,OAAO,oBAAoB,CAAA;CAC5C,CAAA;AAmBD;;;;GAIG;AACH,wBAAsB,UAAU,CAC9B,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,cAAc,EAC/B,IAAI,GAAE,WAA2B,EACjC,SAAS,GAAE,mBAAwB,GAClC,OAAO,CAAC;IAAE,MAAM,EAAE,OAAO,CAAA;CAAE,CAAC,CA6F9B"}