@payloadcms/codemod 4.0.0-internal.44ac9c8 → 4.0.0-internal.4a6b4c3

package/README.md

@@ -18,6 +18,7 @@ With no arguments, runs every registered transform against the current directory
 - `--list`: print registered transforms.
 - `--dry`: analyze only; write nothing.
 - `--print`: print transformed sources to stdout instead of writing.
+- `-h`, `--help`: print usage for all commands and exit. Works on any command, e.g. `upgrade run --help`.
 
 ## `upgrade` command
 
@@ -41,7 +42,7 @@ the prompt instead of prompting.
 `npx @payloadcms/codemod upgrade run` performs the deterministic v3 -> v4 slice against the current
 directory (run it from your project root):
 
-1. Resolves the current Payload version from the npm registry, using the dist-tag this CLI was installed under (`beta` if run as `@payloadcms/codemod@beta`, else `canary`; override with `--tag <dist-tag>`).
+1. Resolves the current Payload version from the npm registry, using the dist-tag this CLI was installed under (its own prerelease id, else `beta`; override with `--tag <dist-tag>`).
 2. Rewrites `package.json`: pins `payload` + every `@payloadcms/*` to that exact version in
    lockstep, removes dependency overrides pinning them, converts their carets to exact, and writes
    the TypeScript / `@types/node` / `engines.node` floors. The `@payloadcms/eslint-*` packages are
@@ -56,7 +57,7 @@ prints the required Next target.
 
 Flags:
 
-- `--tag <dist-tag>`: dist-tag to resolve Payload versions from. Defaults to the dist-tag this CLI was installed under (`beta` when run as `@payloadcms/codemod@beta`, else `canary`).
+- `--tag <dist-tag>`: dist-tag to resolve Payload versions from. Defaults to the dist-tag this CLI was installed under (its own prerelease id, else `beta`).
 - `--dry`: preview the `package.json` changes and planned steps; write and install nothing.
 - `--force`: skip the dirty-git-tree warning.
 
@@ -83,13 +84,16 @@ The tool loads your project via [ts-morph](https://ts-morph.com/), using your `t
 
 - `migrate-list-view-select-api`: Removes `admin.enableListViewSelectAPI` from Collection Configs. The List View's Select API is the default in v4.
 - `migrate-disabled-fields`: migrates `field.admin.disableListColumn`, `disableListFilter`, `disableGroupBy`, `disableBulkEdit` and their equivalents on `imageSize.admin` into the consolidated `disabled` object form.
+- `migrate-displayed-field-value-args`: converts direct `getDisplayedFieldValue(cellData, field, i18n)` calls imported from `@payloadcms/ui/utilities/getDisplayedFieldValue` to the object argument form. Handles named, aliased, and namespace imports. Indirect references and unsupported argument shapes are reported for manual migration.
 - `globals-components-edit`: Globals: rename `admin.components.elements` to `admin.components.edit` and hoist `Description` to top-level `admin.components.Description` to match Collection conventions.
 - `migrate-force-select`: migrates `forceSelect: { ... }` on Collection/Global configs to a `select` function that augments the caller's `select` when present and returns `undefined` (preserving full-document reads) when not. Shallow values become a spread (`{ ...select, ... }`); nested values use `deepMergeSimple` from `payload/shared` (auto-imported) to preserve the previous deep-merge semantics. Non-literal values, sibling `select` already present, and unsupported member kinds are surfaced as notes for manual review.
 - `migrate-field-component-types`: replaces field component aliases—including concrete fields, canonical generics, labels, descriptions, errors, diffs, and block row labels—with the corresponding props types wrapped in `React.FC`. Generic arguments are preserved. Explicit class components, re-exports, namespace references, and inline imports are left unchanged with notes for manual migration.
+- `rename-diff-value-props`: renames the `comparisonValue` and `versionValue` props read by custom Diff components to `valueFrom` and `valueTo`. Detects components whose props are typed with a Diff type imported from `payload`, in either the v3 component form (`TextFieldDiffClientComponent`) or the props form (`TextFieldDiffClientProps`), including same-file type aliases and interfaces built from one. Renames destructured props (along with the local variables they declare, unless the new name is already taken), `props.comparisonValue` and `props['comparisonValue']` reads, and `TextFieldDiffClientProps['comparisonValue']` indexed access types. Untyped components are not detected; remaining old prop names in property positions (e.g. JSX attributes passed to other components) are surfaced as notes in files that import a Diff type.
 - `migrate-block-references-to-blocks`: renames blocks field `blockReferences` configs to `blocks`, and removes a sibling `blocks: []` placeholder when present. If a non-empty `blocks` sibling already exists, the transform leaves the field untouched and surfaces a note for manual review.
 - `migrate-hide-api-url`: migrates `admin.hideAPIURL: true` to `admin.components.views.edit.api.tab.condition: () => false` on collection and global configs.
 - `migrate-aliased-exports`: rewrites imports of types and utilities that used to be re-exported from `@payloadcms/ui` and `@payloadcms/next/utilities` to their canonical sources in `payload` / `payload/shared`.
 - `migrate-payload-request-creation`: renames named request-helper and admin-context imports from `payload` and `payload/internal`. Calls migrate only with a plain identifier payload and either `{}` or an initialized local `const` options identifier whose type exposes all seven old option properties (or is `any`). The generated argument captures payload first and forwards only `context`, `depth`, `fallbackLocale`, `locale`, `req`, `urlSuffix`, and `user` through getters, preserving inherited getters, read order, and async rejection behavior. Existing `CreateLocalReqOptions` named imports from `payload` become options-only usages of `Omit<CreatePayloadRequestArgs, 'payload'>`; relative/private imports of that internal type require manual migration. Unsupported shapes, type usages, and collisions leave the affected binding unchanged with notes.
+- `migrate-admin-context-properties`: rewrites reads of `headers` and `languageCode`, removed from `AdminContext` in v4, to `req.headers` and `req.i18n.language` (`i18n.language` on `PartialAdminContext`). Covers `initAdminContext()` results (property access, destructures, and `const` bindings), parameters and variables typed as `AdminContext`, and `Pick<AdminContext, ...>` and `AdminContext['...']` types. Drops both arguments from `getRootLayoutData()` calls, then drops destructured bindings that are no longer read. Element access such as `context['headers']` and `Pick` types that only pick removed properties are left unchanged with notes. Run after `migrate-payload-request-creation`; the default run order handles this.
 - `migrate-document-title-context`: migrates `title` and `setDocumentTitle` destructured from `useDocumentInfo()` to `useDocumentTitle()`. They were removed from `DocumentInfoContext` in v4 and now live on `DocumentTitleContext`.
 - `migrate-sharp-to-transformer`: moves a top-level `sharp` dependency and per-collection Sharp-specific `upload` options (`resizeOptions`, `imageSizes`, `formatOptions`, `trimOptions`, `constructorOptions`, `withMetadata`, `crop`, `focalPoint`) into `sharpTransformer({ collections })`, registered under `upload.transformers`. Appends to an existing `transformers` array instead of overwriting it, and no-ops if a `sharpTransformer` call is already present. **Limitations:** only inline `buildConfig({...})` object literals and inline collection/`upload` object literals are migrated; a dynamic `collections` array, an externally-defined collection, or a non-inline `upload` object are left untouched with a note for manual review. A collection's `upload` object built from a spread (e.g. `upload: { ...sharedUploadConfig }`) is noted for manual review, since Sharp-specific fields hidden inside the spread aren't visible to the transform and are left un-migrated. Surfaces a note reminding you to install `@payloadcms/transformer-sharp` (`pnpm add @payloadcms/transformer-sharp`). The transform preserves AST structure but does not re-format output. Run `prettier --write` (or your project's formatter) after applying.
 - `migrate-storage-adapters-to-config`: moves storage adapter factory calls (`s3Storage`, `gcsStorage`, `azureStorage`, `r2Storage`, `vercelBlobStorage`) from `plugins` to the new top-level `storage` array. Removes `plugins` if it becomes empty after the move. **Limitations:** aliased imports (e.g. `import { s3Storage as myS3 }`) are not detected; rename any aliases to the canonical factory name before running, or migrate those calls manually. The transform preserves AST structure but does not re-format output. Run `prettier --write` (or your project's formatter) after applying.

package/dist/cli.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAmBA,wBAAsB,IAAI,CAAC,IAAI,GAAE,MAAM,EAA0B,GAAG,OAAO,CAAC,IAAI,CAAC,CAyFhF"}
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAoBA,wBAAsB,IAAI,CAAC,IAAI,GAAE,MAAM,EAA0B,GAAG,OAAO,CAAC,IAAI,CAAC,CA+FhF"}

package/dist/cli.help.d.ts

@@ -0,0 +1,4 @@
+export declare function renderHelp({ command }: {
+    command: string;
+}): string;
+//# sourceMappingURL=cli.help.d.ts.map

package/dist/cli.help.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.help.d.ts","sourceRoot":"","sources":["../src/cli.help.ts"],"names":[],"mappings":"AAAA,wBAAgB,UAAU,CAAC,EAAE,OAAO,EAAE,EAAE;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CA0BnE"}

package/dist/cli.help.js

@@ -0,0 +1,29 @@
+export function renderHelp({ command }) {
+    return `Usage:
+  ${command} [path] [options]
+  ${command} upgrade [run | prompt] [options]
+
+Commands:
+  (none)              Run transforms only against [path] (default: cwd)
+  upgrade             Pick how to run the full v3 -> v4 upgrade
+  upgrade run         Bump Payload deps, install, then run transforms in cwd
+  upgrade prompt      Print the upgrade orchestration prompt
+
+Transform options:
+  --transform <name>  Run a single transform by name
+  --list              Print registered transforms
+  --dry, --dry-run    Analyze only; write nothing
+  --print             Print transformed sources to stdout instead of writing
+
+Upgrade options:
+  --agent <name>      Coding agent to hand off to (claude, codex); skips the picker
+  --tag <dist-tag>    Dist-tag to resolve Payload versions from
+  --dry, --dry-run    Preview changes; write and install nothing
+  --force             Skip the dirty-git-tree warning
+
+General options:
+  -h, --help          Show this help
+`;
+}
+
+//# sourceMappingURL=cli.help.js.map

package/dist/cli.help.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/cli.help.ts"],"sourcesContent":["export function renderHelp({ command }: { command: string }): string {\n  return `Usage:\n  ${command} [path] [options]\n  ${command} upgrade [run | prompt] [options]\n\nCommands:\n  (none)              Run transforms only against [path] (default: cwd)\n  upgrade             Pick how to run the full v3 -> v4 upgrade\n  upgrade run         Bump Payload deps, install, then run transforms in cwd\n  upgrade prompt      Print the upgrade orchestration prompt\n\nTransform options:\n  --transform <name>  Run a single transform by name\n  --list              Print registered transforms\n  --dry, --dry-run    Analyze only; write nothing\n  --print             Print transformed sources to stdout instead of writing\n\nUpgrade options:\n  --agent <name>      Coding agent to hand off to (claude, codex); skips the picker\n  --tag <dist-tag>    Dist-tag to resolve Payload versions from\n  --dry, --dry-run    Preview changes; write and install nothing\n  --force             Skip the dirty-git-tree warning\n\nGeneral options:\n  -h, --help          Show this help\n`\n}\n"],"names":["renderHelp","command"],"mappings":"AAAA,OAAO,SAASA,WAAW,EAAEC,OAAO,EAAuB;IACzD,OAAO,CAAC;EACR,EAAEA,QAAQ;EACV,EAAEA,QAAQ;;;;;;;;;;;;;;;;;;;;;;AAsBZ,CAAC;AACD"}

package/dist/cli.js

@@ -1,5 +1,6 @@
 /* eslint-disable no-console */ import { writeFileSync } from 'node:fs';
 import { resolve } from 'node:path';
+import { renderHelp } from './cli.help.js';
 import { parseFlags } from './cli.parseFlags.js';
 import { transforms as registry } from './registry.js';
 import { runTransforms } from './runner.js';
@@ -11,6 +12,13 @@ import { loadPackageJsons, serializePackageJson } from './utils/packageJson.js';
 import { loadProject } from './utils/project.js';
 export async function main(argv = process.argv.slice(2)) {
     const flags = parseFlags(argv);
+    // Checked first so `--help` on any command prints usage instead of running it.
+    if (flags.help) {
+        console.log(renderHelp({
+            command: resolveSelfCommand()
+        }));
+        return;
+    }
     if (flags.command === 'upgrade') {
         if (flags.upgrade === 'prompt') {
             console.log(renderUpgradePrompt({

package/dist/cli.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/cli.ts"],"sourcesContent":["import type { Project } from 'ts-morph'\n\n/* eslint-disable no-console */\nimport { writeFileSync } from 'node:fs'\nimport { resolve } from 'node:path'\n\nimport type { TransformRunResult } from './runner.js'\nimport type { Transform } from './types.js'\n\nimport { parseFlags } from './cli.parseFlags.js'\nimport { transforms as registry } from './registry.js'\nimport { runTransforms } from './runner.js'\nimport { runDispatch } from './upgrade/dispatch.js'\nimport { runUpgrade } from './upgrade/index.js'\nimport { renderUpgradePrompt } from './upgrade/prompt.js'\nimport { resolveSelfCommand } from './upgrade/selfCommand.js'\nimport { loadPackageJsons, serializePackageJson } from './utils/packageJson.js'\nimport { loadProject } from './utils/project.js'\n\nexport async function main(argv: string[] = process.argv.slice(2)): Promise<void> {\n  const flags = parseFlags(argv)\n\n  if (flags.command === 'upgrade') {\n    if (flags.upgrade === 'prompt') {\n      console.log(renderUpgradePrompt({ command: resolveSelfCommand() }))\n      return\n    }\n\n    if (flags.upgrade === 'run') {\n      const { failed } = await runUpgrade({\n        flags: { dry: flags.dry, force: flags.force, tag: flags.tag },\n        path: flags.path,\n      })\n      if (failed) {\n        process.exitCode = 1\n      }\n      return\n    }\n\n    const { failed } = await runDispatch({\n      agentFlag: flags.agent,\n      path: flags.path,\n      upgradeFlags: { dry: flags.dry, force: flags.force, tag: flags.tag },\n    })\n    if (failed) {\n      process.exitCode = 1\n    }\n    return\n  }\n\n  if (flags.list) {\n    printList()\n    return\n  }\n\n  const selected = selectTransforms(registry, flags.transform)\n  if (selected.length === 0) {\n    console.error(`No transforms matched${flags.transform ? ` \"${flags.transform}\"` : ''}.`)\n    process.exitCode = 1\n    return\n  }\n\n  const project = loadProject(resolve(flags.path))\n  const snapshot = snapshotProject(project)\n\n  const packageJsons = loadPackageJsons(resolve(flags.path))\n\n  const { failed, results } = await runTransforms({\n    // Shares the same `data` reference, so transform mutations are visible\n    // below for change detection (do not clone here).\n    packageJsons: packageJsons.map(({ data, path }) => ({ data, path })),\n    project,\n    transforms: selected,\n  })\n\n  const changed = project\n    .getSourceFiles()\n    .filter((file) => snapshot.get(file.getFilePath()) !== file.getFullText())\n\n  const changedPackageJsons = packageJsons.filter(\n    (pkg) => serializePackageJson(pkg.data, pkg.originalText) !== pkg.originalText,\n  )\n\n  if (flags.print) {\n    if (changed.length === 0 && changedPackageJsons.length === 0) {\n      console.log('(no files changed)')\n    } else {\n      for (const file of changed) {\n        console.log(`// ${file.getFilePath()}`)\n        console.log(file.getFullText())\n      }\n      for (const pkg of changedPackageJsons) {\n        console.log(`// ${pkg.path}`)\n        console.log(serializePackageJson(pkg.data, pkg.originalText))\n      }\n    }\n  } else if (!flags.dry) {\n    await Promise.all(changed.map((file) => file.save()))\n    for (const pkg of changedPackageJsons) {\n      writeFileSync(pkg.path, serializePackageJson(pkg.data, pkg.originalText))\n    }\n  }\n\n  printSummary(results)\n\n  if (failed) {\n    process.exitCode = 1\n  }\n}\n\nfunction selectTransforms(available: Transform[], name: string | undefined): Transform[] {\n  if (!name) {\n    return available\n  }\n  return available.filter((t) => t.name === name)\n}\n\nfunction printList(): void {\n  if (registry.length === 0) {\n    console.log('No transforms registered.')\n    return\n  }\n  for (const t of registry) {\n    console.log(`${t.name}  ${t.description}`)\n  }\n}\n\nfunction snapshotProject(project: Project): Map<string, string> {\n  return new Map(project.getSourceFiles().map((file) => [file.getFilePath(), file.getFullText()]))\n}\n\nfunction printSummary(results: TransformRunResult[]): void {\n  console.log('')\n  console.log('Codemod summary:')\n  for (const r of results) {\n    if (r.error) {\n      console.log(`  [FAIL] ${r.name} — ${r.error.message}`)\n      continue\n    }\n    console.log(`  [ok] ${r.name} — ${r.filesChanged.length} file(s) changed`)\n    for (const note of r.notes ?? []) {\n      console.log(`      note: ${note}`)\n    }\n  }\n}\n"],"names":["writeFileSync","resolve","parseFlags","transforms","registry","runTransforms","runDispatch","runUpgrade","renderUpgradePrompt","resolveSelfCommand","loadPackageJsons","serializePackageJson","loadProject","main","argv","process","slice","flags","command","upgrade","console","log","failed","dry","force","tag","path","exitCode","agentFlag","agent","upgradeFlags","list","printList","selected","selectTransforms","transform","length","error","project","snapshot","snapshotProject","packageJsons","results","map","data","changed","getSourceFiles","filter","file","get","getFilePath","getFullText","changedPackageJsons","pkg","originalText","print","Promise","all","save","printSummary","available","name","t","description","Map","r","message","filesChanged","note","notes"],"mappings":"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"}
+{"version":3,"sources":["../src/cli.ts"],"sourcesContent":["import type { Project } from 'ts-morph'\n\n/* eslint-disable no-console */\nimport { writeFileSync } from 'node:fs'\nimport { resolve } from 'node:path'\n\nimport type { TransformRunResult } from './runner.js'\nimport type { Transform } from './types.js'\n\nimport { renderHelp } from './cli.help.js'\nimport { parseFlags } from './cli.parseFlags.js'\nimport { transforms as registry } from './registry.js'\nimport { runTransforms } from './runner.js'\nimport { runDispatch } from './upgrade/dispatch.js'\nimport { runUpgrade } from './upgrade/index.js'\nimport { renderUpgradePrompt } from './upgrade/prompt.js'\nimport { resolveSelfCommand } from './upgrade/selfCommand.js'\nimport { loadPackageJsons, serializePackageJson } from './utils/packageJson.js'\nimport { loadProject } from './utils/project.js'\n\nexport async function main(argv: string[] = process.argv.slice(2)): Promise<void> {\n  const flags = parseFlags(argv)\n\n  // Checked first so `--help` on any command prints usage instead of running it.\n  if (flags.help) {\n    console.log(renderHelp({ command: resolveSelfCommand() }))\n    return\n  }\n\n  if (flags.command === 'upgrade') {\n    if (flags.upgrade === 'prompt') {\n      console.log(renderUpgradePrompt({ command: resolveSelfCommand() }))\n      return\n    }\n\n    if (flags.upgrade === 'run') {\n      const { failed } = await runUpgrade({\n        flags: { dry: flags.dry, force: flags.force, tag: flags.tag },\n        path: flags.path,\n      })\n      if (failed) {\n        process.exitCode = 1\n      }\n      return\n    }\n\n    const { failed } = await runDispatch({\n      agentFlag: flags.agent,\n      path: flags.path,\n      upgradeFlags: { dry: flags.dry, force: flags.force, tag: flags.tag },\n    })\n    if (failed) {\n      process.exitCode = 1\n    }\n    return\n  }\n\n  if (flags.list) {\n    printList()\n    return\n  }\n\n  const selected = selectTransforms(registry, flags.transform)\n  if (selected.length === 0) {\n    console.error(`No transforms matched${flags.transform ? ` \"${flags.transform}\"` : ''}.`)\n    process.exitCode = 1\n    return\n  }\n\n  const project = loadProject(resolve(flags.path))\n  const snapshot = snapshotProject(project)\n\n  const packageJsons = loadPackageJsons(resolve(flags.path))\n\n  const { failed, results } = await runTransforms({\n    // Shares the same `data` reference, so transform mutations are visible\n    // below for change detection (do not clone here).\n    packageJsons: packageJsons.map(({ data, path }) => ({ data, path })),\n    project,\n    transforms: selected,\n  })\n\n  const changed = project\n    .getSourceFiles()\n    .filter((file) => snapshot.get(file.getFilePath()) !== file.getFullText())\n\n  const changedPackageJsons = packageJsons.filter(\n    (pkg) => serializePackageJson(pkg.data, pkg.originalText) !== pkg.originalText,\n  )\n\n  if (flags.print) {\n    if (changed.length === 0 && changedPackageJsons.length === 0) {\n      console.log('(no files changed)')\n    } else {\n      for (const file of changed) {\n        console.log(`// ${file.getFilePath()}`)\n        console.log(file.getFullText())\n      }\n      for (const pkg of changedPackageJsons) {\n        console.log(`// ${pkg.path}`)\n        console.log(serializePackageJson(pkg.data, pkg.originalText))\n      }\n    }\n  } else if (!flags.dry) {\n    await Promise.all(changed.map((file) => file.save()))\n    for (const pkg of changedPackageJsons) {\n      writeFileSync(pkg.path, serializePackageJson(pkg.data, pkg.originalText))\n    }\n  }\n\n  printSummary(results)\n\n  if (failed) {\n    process.exitCode = 1\n  }\n}\n\nfunction selectTransforms(available: Transform[], name: string | undefined): Transform[] {\n  if (!name) {\n    return available\n  }\n  return available.filter((t) => t.name === name)\n}\n\nfunction printList(): void {\n  if (registry.length === 0) {\n    console.log('No transforms registered.')\n    return\n  }\n  for (const t of registry) {\n    console.log(`${t.name}  ${t.description}`)\n  }\n}\n\nfunction snapshotProject(project: Project): Map<string, string> {\n  return new Map(project.getSourceFiles().map((file) => [file.getFilePath(), file.getFullText()]))\n}\n\nfunction printSummary(results: TransformRunResult[]): void {\n  console.log('')\n  console.log('Codemod summary:')\n  for (const r of results) {\n    if (r.error) {\n      console.log(`  [FAIL] ${r.name} — ${r.error.message}`)\n      continue\n    }\n    console.log(`  [ok] ${r.name} — ${r.filesChanged.length} file(s) changed`)\n    for (const note of r.notes ?? []) {\n      console.log(`      note: ${note}`)\n    }\n  }\n}\n"],"names":["writeFileSync","resolve","renderHelp","parseFlags","transforms","registry","runTransforms","runDispatch","runUpgrade","renderUpgradePrompt","resolveSelfCommand","loadPackageJsons","serializePackageJson","loadProject","main","argv","process","slice","flags","help","console","log","command","upgrade","failed","dry","force","tag","path","exitCode","agentFlag","agent","upgradeFlags","list","printList","selected","selectTransforms","transform","length","error","project","snapshot","snapshotProject","packageJsons","results","map","data","changed","getSourceFiles","filter","file","get","getFilePath","getFullText","changedPackageJsons","pkg","originalText","print","Promise","all","save","printSummary","available","name","t","description","Map","r","message","filesChanged","note","notes"],"mappings":"AAEA,6BAA6B,GAC7B,SAASA,aAAa,QAAQ,UAAS;AACvC,SAASC,OAAO,QAAQ,YAAW;AAKnC,SAASC,UAAU,QAAQ,gBAAe;AAC1C,SAASC,UAAU,QAAQ,sBAAqB;AAChD,SAASC,cAAcC,QAAQ,QAAQ,gBAAe;AACtD,SAASC,aAAa,QAAQ,cAAa;AAC3C,SAASC,WAAW,QAAQ,wBAAuB;AACnD,SAASC,UAAU,QAAQ,qBAAoB;AAC/C,SAASC,mBAAmB,QAAQ,sBAAqB;AACzD,SAASC,kBAAkB,QAAQ,2BAA0B;AAC7D,SAASC,gBAAgB,EAAEC,oBAAoB,QAAQ,yBAAwB;AAC/E,SAASC,WAAW,QAAQ,qBAAoB;AAEhD,OAAO,eAAeC,KAAKC,OAAiBC,QAAQD,IAAI,CAACE,KAAK,CAAC,EAAE;IAC/D,MAAMC,QAAQf,WAAWY;IAEzB,+EAA+E;IAC/E,IAAIG,MAAMC,IAAI,EAAE;QACdC,QAAQC,GAAG,CAACnB,WAAW;YAAEoB,SAASZ;QAAqB;QACvD;IACF;IAEA,IAAIQ,MAAMI,OAAO,KAAK,WAAW;QAC/B,IAAIJ,MAAMK,OAAO,KAAK,UAAU;YAC9BH,QAAQC,GAAG,CAACZ,oBAAoB;gBAAEa,SAASZ;YAAqB;YAChE;QACF;QAEA,IAAIQ,MAAMK,OAAO,KAAK,OAAO;YAC3B,MAAM,EAAEC,MAAM,EAAE,GAAG,MAAMhB,WAAW;gBAClCU,OAAO;oBAAEO,KAAKP,MAAMO,GAAG;oBAAEC,OAAOR,MAAMQ,KAAK;oBAAEC,KAAKT,MAAMS,GAAG;gBAAC;gBAC5DC,MAAMV,MAAMU,IAAI;YAClB;YACA,IAAIJ,QAAQ;gBACVR,QAAQa,QAAQ,GAAG;YACrB;YACA;QACF;QAEA,MAAM,EAAEL,MAAM,EAAE,GAAG,MAAMjB,YAAY;YACnCuB,WAAWZ,MAAMa,KAAK;YACtBH,MAAMV,MAAMU,IAAI;YAChBI,cAAc;gBAAEP,KAAKP,MAAMO,GAAG;gBAAEC,OAAOR,MAAMQ,KAAK;gBAAEC,KAAKT,MAAMS,GAAG;YAAC;QACrE;QACA,IAAIH,QAAQ;YACVR,QAAQa,QAAQ,GAAG;QACrB;QACA;IACF;IAEA,IAAIX,MAAMe,IAAI,EAAE;QACdC;QACA;IACF;IAEA,MAAMC,WAAWC,iBAAiB/B,UAAUa,MAAMmB,SAAS;IAC3D,IAAIF,SAASG,MAAM,KAAK,GAAG;QACzBlB,QAAQmB,KAAK,CAAC,CAAC,qBAAqB,EAAErB,MAAMmB,SAAS,GAAG,CAAC,EAAE,EAAEnB,MAAMmB,SAAS,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC;QACvFrB,QAAQa,QAAQ,GAAG;QACnB;IACF;IAEA,MAAMW,UAAU3B,YAAYZ,QAAQiB,MAAMU,IAAI;IAC9C,MAAMa,WAAWC,gBAAgBF;IAEjC,MAAMG,eAAehC,iBAAiBV,QAAQiB,MAAMU,IAAI;IAExD,MAAM,EAAEJ,MAAM,EAAEoB,OAAO,EAAE,GAAG,MAAMtC,cAAc;QAC9C,uEAAuE;QACvE,kDAAkD;QAClDqC,cAAcA,aAAaE,GAAG,CAAC,CAAC,EAAEC,IAAI,EAAElB,IAAI,EAAE,GAAM,CAAA;gBAAEkB;gBAAMlB;YAAK,CAAA;QACjEY;QACApC,YAAY+B;IACd;IAEA,MAAMY,UAAUP,QACbQ,cAAc,GACdC,MAAM,CAAC,CAACC,OAAST,SAASU,GAAG,CAACD,KAAKE,WAAW,QAAQF,KAAKG,WAAW;IAEzE,MAAMC,sBAAsBX,aAAaM,MAAM,CAC7C,CAACM,MAAQ3C,qBAAqB2C,IAAIT,IAAI,EAAES,IAAIC,YAAY,MAAMD,IAAIC,YAAY;IAGhF,IAAItC,MAAMuC,KAAK,EAAE;QACf,IAAIV,QAAQT,MAAM,KAAK,KAAKgB,oBAAoBhB,MAAM,KAAK,GAAG;YAC5DlB,QAAQC,GAAG,CAAC;QACd,OAAO;YACL,KAAK,MAAM6B,QAAQH,QAAS;gBAC1B3B,QAAQC,GAAG,CAAC,CAAC,GAAG,EAAE6B,KAAKE,WAAW,IAAI;gBACtChC,QAAQC,GAAG,CAAC6B,KAAKG,WAAW;YAC9B;YACA,KAAK,MAAME,OAAOD,oBAAqB;gBACrClC,QAAQC,GAAG,CAAC,CAAC,GAAG,EAAEkC,IAAI3B,IAAI,EAAE;gBAC5BR,QAAQC,GAAG,CAACT,qBAAqB2C,IAAIT,IAAI,EAAES,IAAIC,YAAY;YAC7D;QACF;IACF,OAAO,IAAI,CAACtC,MAAMO,GAAG,EAAE;QACrB,MAAMiC,QAAQC,GAAG,CAACZ,QAAQF,GAAG,CAAC,CAACK,OAASA,KAAKU,IAAI;QACjD,KAAK,MAAML,OAAOD,oBAAqB;YACrCtD,cAAcuD,IAAI3B,IAAI,EAAEhB,qBAAqB2C,IAAIT,IAAI,EAAES,IAAIC,YAAY;QACzE;IACF;IAEAK,aAAajB;IAEb,IAAIpB,QAAQ;QACVR,QAAQa,QAAQ,GAAG;IACrB;AACF;AAEA,SAASO,iBAAiB0B,SAAsB,EAAEC,IAAwB;IACxE,IAAI,CAACA,MAAM;QACT,OAAOD;IACT;IACA,OAAOA,UAAUb,MAAM,CAAC,CAACe,IAAMA,EAAED,IAAI,KAAKA;AAC5C;AAEA,SAAS7B;IACP,IAAI7B,SAASiC,MAAM,KAAK,GAAG;QACzBlB,QAAQC,GAAG,CAAC;QACZ;IACF;IACA,KAAK,MAAM2C,KAAK3D,SAAU;QACxBe,QAAQC,GAAG,CAAC,GAAG2C,EAAED,IAAI,CAAC,EAAE,EAAEC,EAAEC,WAAW,EAAE;IAC3C;AACF;AAEA,SAASvB,gBAAgBF,OAAgB;IACvC,OAAO,IAAI0B,IAAI1B,QAAQQ,cAAc,GAAGH,GAAG,CAAC,CAACK,OAAS;YAACA,KAAKE,WAAW;YAAIF,KAAKG,WAAW;SAAG;AAChG;AAEA,SAASQ,aAAajB,OAA6B;IACjDxB,QAAQC,GAAG,CAAC;IACZD,QAAQC,GAAG,CAAC;IACZ,KAAK,MAAM8C,KAAKvB,QAAS;QACvB,IAAIuB,EAAE5B,KAAK,EAAE;YACXnB,QAAQC,GAAG,CAAC,CAAC,SAAS,EAAE8C,EAAEJ,IAAI,CAAC,GAAG,EAAEI,EAAE5B,KAAK,CAAC6B,OAAO,EAAE;YACrD;QACF;QACAhD,QAAQC,GAAG,CAAC,CAAC,OAAO,EAAE8C,EAAEJ,IAAI,CAAC,GAAG,EAAEI,EAAEE,YAAY,CAAC/B,MAAM,CAAC,gBAAgB,CAAC;QACzE,KAAK,MAAMgC,QAAQH,EAAEI,KAAK,IAAI,EAAE,CAAE;YAChCnD,QAAQC,GAAG,CAAC,CAAC,YAAY,EAAEiD,MAAM;QACnC;IACF;AACF"}

package/dist/cli.parseFlags.d.ts

@@ -12,6 +12,7 @@ export type CliFlags = {
     command?: CliCommand;
     dry: boolean;
     force: boolean;
+    help: boolean;
     list: boolean;
     path: string;
     print: boolean;

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

@@ -1 +1 @@
-{"version":3,"file":"cli.parseFlags.d.ts","sourceRoot":"","sources":["../src/cli.parseFlags.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,UAAU,GAAG,SAAS,CAAA;AAElC;;;;;;GAMG;AACH,MAAM,MAAM,iBAAiB,GAAG,UAAU,GAAG,QAAQ,GAAG,KAAK,CAAA;AAE7D,MAAM,MAAM,QAAQ,GAAG;IACrB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,OAAO,CAAC,EAAE,UAAU,CAAA;IACpB,GAAG,EAAE,OAAO,CAAA;IACZ,KAAK,EAAE,OAAO,CAAA;IACd,IAAI,EAAE,OAAO,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,OAAO,CAAA;IACd,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,OAAO,CAAC,EAAE,iBAAiB,CAAA;CAC5B,CAAA;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,QAAQ,CAmCnD"}
+{"version":3,"file":"cli.parseFlags.d.ts","sourceRoot":"","sources":["../src/cli.parseFlags.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,UAAU,GAAG,SAAS,CAAA;AAElC;;;;;;GAMG;AACH,MAAM,MAAM,iBAAiB,GAAG,UAAU,GAAG,QAAQ,GAAG,KAAK,CAAA;AAE7D,MAAM,MAAM,QAAQ,GAAG;IACrB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,OAAO,CAAC,EAAE,UAAU,CAAA;IACpB,GAAG,EAAE,OAAO,CAAA;IACZ,KAAK,EAAE,OAAO,CAAA;IACd,IAAI,EAAE,OAAO,CAAA;IACb,IAAI,EAAE,OAAO,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,OAAO,CAAA;IACd,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,OAAO,CAAC,EAAE,iBAAiB,CAAA;CAC5B,CAAA;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,QAAQ,CAqCnD"}

package/dist/cli.parseFlags.js

@@ -19,6 +19,11 @@ export function parseFlags(argv) {
                 type: 'boolean',
                 default: false
             },
+            help: {
+                type: 'boolean',
+                default: false,
+                short: 'h'
+            },
             list: {
                 type: 'boolean',
                 default: false
@@ -46,6 +51,7 @@ export function parseFlags(argv) {
         command,
         dry: Boolean(values.dry) || Boolean(values['dry-run']),
         force: Boolean(values.force),
+        help: Boolean(values.help),
         list: Boolean(values.list),
         path,
         print: Boolean(values.print),

package/dist/cli.parseFlags.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/cli.parseFlags.ts"],"sourcesContent":["import { parseArgs } from 'node:util'\n\nexport type CliCommand = 'upgrade'\n\n/**\n * The three `upgrade` verbs:\n * - `dispatch` (bare `upgrade`): interactive picker to hand the orchestration\n *   prompt to a coding agent, or print it.\n * - `run` (`upgrade run`): the deterministic mechanical slice.\n * - `prompt` (`upgrade prompt`): print the orchestration prompt to stdout.\n */\nexport type UpgradeSubcommand = 'dispatch' | 'prompt' | 'run'\n\nexport type CliFlags = {\n  agent?: string\n  command?: CliCommand\n  dry: boolean\n  force: boolean\n  list: boolean\n  path: string\n  print: boolean\n  tag?: string\n  transform?: string\n  upgrade?: UpgradeSubcommand\n}\n\nexport function parseFlags(argv: string[]): CliFlags {\n  const { positionals, values } = parseArgs({\n    allowPositionals: true,\n    args: argv,\n    options: {\n      agent: { type: 'string' },\n      dry: { type: 'boolean', default: false },\n      'dry-run': { type: 'boolean', default: false },\n      force: { type: 'boolean', default: false },\n      list: { type: 'boolean', default: false },\n      print: { type: 'boolean', default: false },\n      tag: { type: 'string' },\n      transform: { type: 'string' },\n    },\n  })\n\n  const isUpgrade = positionals[0] === 'upgrade'\n  const command = isUpgrade ? 'upgrade' : undefined\n  const upgrade = isUpgrade ? resolveUpgradeVerb(positionals[1]) : undefined\n  // The upgrade command always operates on the current directory; only the bare\n  // transform command takes a positional path.\n  const path = isUpgrade ? process.cwd() : (positionals[0] ?? process.cwd())\n\n  return {\n    agent: values.agent,\n    command,\n    dry: Boolean(values.dry) || Boolean(values['dry-run']),\n    force: Boolean(values.force),\n    list: Boolean(values.list),\n    path,\n    print: Boolean(values.print),\n    tag: values.tag,\n    transform: values.transform,\n    upgrade,\n  }\n}\n\nfunction resolveUpgradeVerb(verb: string | undefined): UpgradeSubcommand {\n  if (verb === 'prompt' || verb === 'run') {\n    return verb\n  }\n  return 'dispatch'\n}\n"],"names":["parseArgs","parseFlags","argv","positionals","values","allowPositionals","args","options","agent","type","dry","default","force","list","print","tag","transform","isUpgrade","command","undefined","upgrade","resolveUpgradeVerb","path","process","cwd","Boolean","verb"],"mappings":"AAAA,SAASA,SAAS,QAAQ,YAAW;AA0BrC,OAAO,SAASC,WAAWC,IAAc;IACvC,MAAM,EAAEC,WAAW,EAAEC,MAAM,EAAE,GAAGJ,UAAU;QACxCK,kBAAkB;QAClBC,MAAMJ;QACNK,SAAS;YACPC,OAAO;gBAAEC,MAAM;YAAS;YACxBC,KAAK;gBAAED,MAAM;gBAAWE,SAAS;YAAM;YACvC,WAAW;gBAAEF,MAAM;gBAAWE,SAAS;YAAM;YAC7CC,OAAO;gBAAEH,MAAM;gBAAWE,SAAS;YAAM;YACzCE,MAAM;gBAAEJ,MAAM;gBAAWE,SAAS;YAAM;YACxCG,OAAO;gBAAEL,MAAM;gBAAWE,SAAS;YAAM;YACzCI,KAAK;gBAAEN,MAAM;YAAS;YACtBO,WAAW;gBAAEP,MAAM;YAAS;QAC9B;IACF;IAEA,MAAMQ,YAAYd,WAAW,CAAC,EAAE,KAAK;IACrC,MAAMe,UAAUD,YAAY,YAAYE;IACxC,MAAMC,UAAUH,YAAYI,mBAAmBlB,WAAW,CAAC,EAAE,IAAIgB;IACjE,8EAA8E;IAC9E,6CAA6C;IAC7C,MAAMG,OAAOL,YAAYM,QAAQC,GAAG,KAAMrB,WAAW,CAAC,EAAE,IAAIoB,QAAQC,GAAG;IAEvE,OAAO;QACLhB,OAAOJ,OAAOI,KAAK;QACnBU;QACAR,KAAKe,QAAQrB,OAAOM,GAAG,KAAKe,QAAQrB,MAAM,CAAC,UAAU;QACrDQ,OAAOa,QAAQrB,OAAOQ,KAAK;QAC3BC,MAAMY,QAAQrB,OAAOS,IAAI;QACzBS;QACAR,OAAOW,QAAQrB,OAAOU,KAAK;QAC3BC,KAAKX,OAAOW,GAAG;QACfC,WAAWZ,OAAOY,SAAS;QAC3BI;IACF;AACF;AAEA,SAASC,mBAAmBK,IAAwB;IAClD,IAAIA,SAAS,YAAYA,SAAS,OAAO;QACvC,OAAOA;IACT;IACA,OAAO;AACT"}
+{"version":3,"sources":["../src/cli.parseFlags.ts"],"sourcesContent":["import { parseArgs } from 'node:util'\n\nexport type CliCommand = 'upgrade'\n\n/**\n * The three `upgrade` verbs:\n * - `dispatch` (bare `upgrade`): interactive picker to hand the orchestration\n *   prompt to a coding agent, or print it.\n * - `run` (`upgrade run`): the deterministic mechanical slice.\n * - `prompt` (`upgrade prompt`): print the orchestration prompt to stdout.\n */\nexport type UpgradeSubcommand = 'dispatch' | 'prompt' | 'run'\n\nexport type CliFlags = {\n  agent?: string\n  command?: CliCommand\n  dry: boolean\n  force: boolean\n  help: boolean\n  list: boolean\n  path: string\n  print: boolean\n  tag?: string\n  transform?: string\n  upgrade?: UpgradeSubcommand\n}\n\nexport function parseFlags(argv: string[]): CliFlags {\n  const { positionals, values } = parseArgs({\n    allowPositionals: true,\n    args: argv,\n    options: {\n      agent: { type: 'string' },\n      dry: { type: 'boolean', default: false },\n      'dry-run': { type: 'boolean', default: false },\n      force: { type: 'boolean', default: false },\n      help: { type: 'boolean', default: false, short: 'h' },\n      list: { type: 'boolean', default: false },\n      print: { type: 'boolean', default: false },\n      tag: { type: 'string' },\n      transform: { type: 'string' },\n    },\n  })\n\n  const isUpgrade = positionals[0] === 'upgrade'\n  const command = isUpgrade ? 'upgrade' : undefined\n  const upgrade = isUpgrade ? resolveUpgradeVerb(positionals[1]) : undefined\n  // The upgrade command always operates on the current directory; only the bare\n  // transform command takes a positional path.\n  const path = isUpgrade ? process.cwd() : (positionals[0] ?? process.cwd())\n\n  return {\n    agent: values.agent,\n    command,\n    dry: Boolean(values.dry) || Boolean(values['dry-run']),\n    force: Boolean(values.force),\n    help: Boolean(values.help),\n    list: Boolean(values.list),\n    path,\n    print: Boolean(values.print),\n    tag: values.tag,\n    transform: values.transform,\n    upgrade,\n  }\n}\n\nfunction resolveUpgradeVerb(verb: string | undefined): UpgradeSubcommand {\n  if (verb === 'prompt' || verb === 'run') {\n    return verb\n  }\n  return 'dispatch'\n}\n"],"names":["parseArgs","parseFlags","argv","positionals","values","allowPositionals","args","options","agent","type","dry","default","force","help","short","list","print","tag","transform","isUpgrade","command","undefined","upgrade","resolveUpgradeVerb","path","process","cwd","Boolean","verb"],"mappings":"AAAA,SAASA,SAAS,QAAQ,YAAW;AA2BrC,OAAO,SAASC,WAAWC,IAAc;IACvC,MAAM,EAAEC,WAAW,EAAEC,MAAM,EAAE,GAAGJ,UAAU;QACxCK,kBAAkB;QAClBC,MAAMJ;QACNK,SAAS;YACPC,OAAO;gBAAEC,MAAM;YAAS;YACxBC,KAAK;gBAAED,MAAM;gBAAWE,SAAS;YAAM;YACvC,WAAW;gBAAEF,MAAM;gBAAWE,SAAS;YAAM;YAC7CC,OAAO;gBAAEH,MAAM;gBAAWE,SAAS;YAAM;YACzCE,MAAM;gBAAEJ,MAAM;gBAAWE,SAAS;gBAAOG,OAAO;YAAI;YACpDC,MAAM;gBAAEN,MAAM;gBAAWE,SAAS;YAAM;YACxCK,OAAO;gBAAEP,MAAM;gBAAWE,SAAS;YAAM;YACzCM,KAAK;gBAAER,MAAM;YAAS;YACtBS,WAAW;gBAAET,MAAM;YAAS;QAC9B;IACF;IAEA,MAAMU,YAAYhB,WAAW,CAAC,EAAE,KAAK;IACrC,MAAMiB,UAAUD,YAAY,YAAYE;IACxC,MAAMC,UAAUH,YAAYI,mBAAmBpB,WAAW,CAAC,EAAE,IAAIkB;IACjE,8EAA8E;IAC9E,6CAA6C;IAC7C,MAAMG,OAAOL,YAAYM,QAAQC,GAAG,KAAMvB,WAAW,CAAC,EAAE,IAAIsB,QAAQC,GAAG;IAEvE,OAAO;QACLlB,OAAOJ,OAAOI,KAAK;QACnBY;QACAV,KAAKiB,QAAQvB,OAAOM,GAAG,KAAKiB,QAAQvB,MAAM,CAAC,UAAU;QACrDQ,OAAOe,QAAQvB,OAAOQ,KAAK;QAC3BC,MAAMc,QAAQvB,OAAOS,IAAI;QACzBE,MAAMY,QAAQvB,OAAOW,IAAI;QACzBS;QACAR,OAAOW,QAAQvB,OAAOY,KAAK;QAC3BC,KAAKb,OAAOa,GAAG;QACfC,WAAWd,OAAOc,SAAS;QAC3BI;IACF;AACF;AAEA,SAASC,mBAAmBK,IAAwB;IAClD,IAAIA,SAAS,YAAYA,SAAS,OAAO;QACvC,OAAOA;IACT;IACA,OAAO;AACT"}

package/dist/registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AAoC3C,eAAO,MAAM,UAAU,EAAE,SAAS,EAkCjC,CAAA"}
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AAuC3C,eAAO,MAAM,UAAU,EAAE,SAAS,EAqCjC,CAAA"}

package/dist/registry.js

@@ -1,6 +1,7 @@
 import { addOverrideAccessTrue } from './transforms/add-override-access-true/index.js';
 import { exampleNoop } from './transforms/example-noop/index.js';
 import { globalsComponentsEdit } from './transforms/globals-components-edit/index.js';
+import { migrateAdminContextProperties } from './transforms/migrate-admin-context-properties/index.js';
 import { migrateAfterOperationRead } from './transforms/migrate-after-operation-read/index.js';
 import { migrateAliasedExports } from './transforms/migrate-aliased-exports/index.js';
 import { migrateAuthorshipDefault } from './transforms/migrate-authorship-default/index.js';
@@ -9,6 +10,7 @@ import { migrateBlockReferencesToBlocks } from './transforms/migrate-block-refer
 import { migrateBuildScript } from './transforms/migrate-build-script/index.js';
 import { migrateDbTypesSubpath } from './transforms/migrate-db-types-subpath/index.js';
 import { migrateDisabledFields } from './transforms/migrate-disabled-fields/index.js';
+import { migrateDisplayedFieldValueArgs } from './transforms/migrate-displayed-field-value-args/index.js';
 import { migrateDocumentTitleContext } from './transforms/migrate-document-title-context/index.js';
 import { migrateFieldComponentTypes } from './transforms/migrate-field-component-types/index.js';
 import { migrateForceSelect } from './transforms/migrate-force-select/index.js';
@@ -28,6 +30,7 @@ import { removeLocalizeStatusConfig } from './transforms/remove-localize-status-
 import { removePublishSpecificLocale } from './transforms/remove-publish-specific-locale/index.js';
 import { removeStorageAlwaysInsertFields } from './transforms/remove-storage-always-insert-fields/index.js';
 import { removeVersionsTrue } from './transforms/remove-versions-true/index.js';
+import { renameDiffValueProps } from './transforms/rename-diff-value-props/index.js';
 import { renameExperimentalTableFeature } from './transforms/rename-experimental-table-feature/index.js';
 import { renameStorageAdaptersToStorage } from './transforms/rename-storage-adapters-to-storage/index.js';
 import { renameTypescriptSchemaToJsonSchema } from './transforms/rename-typescript-schema-to-json-schema/index.js';
@@ -39,10 +42,13 @@ export const transforms = [
     globalsComponentsEdit,
     migrateListViewSelectAPI,
     migrateDisabledFields,
+    migrateDisplayedFieldValueArgs,
     migrateForceSelect,
     migrateFieldComponentTypes,
+    renameDiffValueProps,
     migrateAliasedExports,
     migratePayloadRequestCreation,
+    migrateAdminContextProperties,
     migrateBlockReferencesToBlocks,
     migrateBuildScript,
     migrateDocumentTitleContext,

package/dist/registry.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/registry.ts"],"sourcesContent":["import type { Transform } from './types.js'\n\nimport { addOverrideAccessTrue } from './transforms/add-override-access-true/index.js'\nimport { exampleNoop } from './transforms/example-noop/index.js'\nimport { globalsComponentsEdit } from './transforms/globals-components-edit/index.js'\nimport { migrateAfterOperationRead } from './transforms/migrate-after-operation-read/index.js'\nimport { migrateAliasedExports } from './transforms/migrate-aliased-exports/index.js'\nimport { migrateAuthorshipDefault } from './transforms/migrate-authorship-default/index.js'\nimport { migrateAzureChunkLargeFiles } from './transforms/migrate-azure-chunk-large-files/index.js'\nimport { migrateBlockReferencesToBlocks } from './transforms/migrate-block-references-to-blocks/index.js'\nimport { migrateBuildScript } from './transforms/migrate-build-script/index.js'\nimport { migrateDbTypesSubpath } from './transforms/migrate-db-types-subpath/index.js'\nimport { migrateDisabledFields } from './transforms/migrate-disabled-fields/index.js'\nimport { migrateDocumentTitleContext } from './transforms/migrate-document-title-context/index.js'\nimport { migrateFieldComponentTypes } from './transforms/migrate-field-component-types/index.js'\nimport { migrateForceSelect } from './transforms/migrate-force-select/index.js'\nimport { migrateHideAPIURL } from './transforms/migrate-hide-api-url/index.js'\nimport { migrateImportExportHooks } from './transforms/migrate-import-export-hooks/index.js'\nimport { migrateListViewSelectAPI } from './transforms/migrate-list-view-select-api/index.js'\nimport { migrateNextGenerateViewportExport } from './transforms/migrate-next-generate-viewport-export/index.js'\nimport { migrateNextSubpathExports } from './transforms/migrate-next-subpath-exports/index.js'\nimport { migratePayloadRequestCreation } from './transforms/migrate-payload-request-creation/index.js'\nimport { migrateSharpToTransformer } from './transforms/migrate-sharp-to-transformer/index.js'\nimport { migrateSlugField } from './transforms/migrate-slug-field/index.js'\nimport { migrateStorageAdaptersToConfig } from './transforms/migrate-storage-adapters-to-config/index.js'\nimport { migrateVersionsDefault } from './transforms/migrate-versions-default/index.js'\nimport { removeDefaultLocalePublishOption } from './transforms/remove-default-locale-publish-option/index.js'\nimport { removeGroupByTrue } from './transforms/remove-group-by-true/index.js'\nimport { removeLocalizeStatusConfig } from './transforms/remove-localize-status-config/index.js'\nimport { removePublishSpecificLocale } from './transforms/remove-publish-specific-locale/index.js'\nimport { removeStorageAlwaysInsertFields } from './transforms/remove-storage-always-insert-fields/index.js'\nimport { removeVersionsTrue } from './transforms/remove-versions-true/index.js'\nimport { renameExperimentalTableFeature } from './transforms/rename-experimental-table-feature/index.js'\nimport { renameStorageAdaptersToStorage } from './transforms/rename-storage-adapters-to-storage/index.js'\nimport { renameTypescriptSchemaToJsonSchema } from './transforms/rename-typescript-schema-to-json-schema/index.js'\n\nexport const transforms: Transform[] = [\n  exampleNoop,\n  addOverrideAccessTrue,\n  migrateAfterOperationRead,\n  migrateHideAPIURL,\n  globalsComponentsEdit,\n  migrateListViewSelectAPI,\n  migrateDisabledFields,\n  migrateForceSelect,\n  migrateFieldComponentTypes,\n  migrateAliasedExports,\n  migratePayloadRequestCreation,\n  migrateBlockReferencesToBlocks,\n  migrateBuildScript,\n  migrateDocumentTitleContext,\n  migrateSharpToTransformer,\n  migrateStorageAdaptersToConfig,\n  migrateAzureChunkLargeFiles,\n  renameStorageAdaptersToStorage,\n  migrateImportExportHooks,\n  migrateDbTypesSubpath,\n  migrateNextGenerateViewportExport,\n  migrateNextSubpathExports,\n  migrateSlugField,\n  migrateVersionsDefault,\n  migrateAuthorshipDefault,\n  removeDefaultLocalePublishOption,\n  removeGroupByTrue,\n  removeLocalizeStatusConfig,\n  removeVersionsTrue,\n  removePublishSpecificLocale,\n  removeStorageAlwaysInsertFields,\n  renameTypescriptSchemaToJsonSchema,\n  renameExperimentalTableFeature,\n]\n"],"names":["addOverrideAccessTrue","exampleNoop","globalsComponentsEdit","migrateAfterOperationRead","migrateAliasedExports","migrateAuthorshipDefault","migrateAzureChunkLargeFiles","migrateBlockReferencesToBlocks","migrateBuildScript","migrateDbTypesSubpath","migrateDisabledFields","migrateDocumentTitleContext","migrateFieldComponentTypes","migrateForceSelect","migrateHideAPIURL","migrateImportExportHooks","migrateListViewSelectAPI","migrateNextGenerateViewportExport","migrateNextSubpathExports","migratePayloadRequestCreation","migrateSharpToTransformer","migrateSlugField","migrateStorageAdaptersToConfig","migrateVersionsDefault","removeDefaultLocalePublishOption","removeGroupByTrue","removeLocalizeStatusConfig","removePublishSpecificLocale","removeStorageAlwaysInsertFields","removeVersionsTrue","renameExperimentalTableFeature","renameStorageAdaptersToStorage","renameTypescriptSchemaToJsonSchema","transforms"],"mappings":"AAEA,SAASA,qBAAqB,QAAQ,iDAAgD;AACtF,SAASC,WAAW,QAAQ,qCAAoC;AAChE,SAASC,qBAAqB,QAAQ,gDAA+C;AACrF,SAASC,yBAAyB,QAAQ,qDAAoD;AAC9F,SAASC,qBAAqB,QAAQ,gDAA+C;AACrF,SAASC,wBAAwB,QAAQ,mDAAkD;AAC3F,SAASC,2BAA2B,QAAQ,wDAAuD;AACnG,SAASC,8BAA8B,QAAQ,2DAA0D;AACzG,SAASC,kBAAkB,QAAQ,6CAA4C;AAC/E,SAASC,qBAAqB,QAAQ,iDAAgD;AACtF,SAASC,qBAAqB,QAAQ,gDAA+C;AACrF,SAASC,2BAA2B,QAAQ,uDAAsD;AAClG,SAASC,0BAA0B,QAAQ,sDAAqD;AAChG,SAASC,kBAAkB,QAAQ,6CAA4C;AAC/E,SAASC,iBAAiB,QAAQ,6CAA4C;AAC9E,SAASC,wBAAwB,QAAQ,oDAAmD;AAC5F,SAASC,wBAAwB,QAAQ,qDAAoD;AAC7F,SAASC,iCAAiC,QAAQ,8DAA6D;AAC/G,SAASC,yBAAyB,QAAQ,qDAAoD;AAC9F,SAASC,6BAA6B,QAAQ,yDAAwD;AACtG,SAASC,yBAAyB,QAAQ,qDAAoD;AAC9F,SAASC,gBAAgB,QAAQ,2CAA0C;AAC3E,SAASC,8BAA8B,QAAQ,2DAA0D;AACzG,SAASC,sBAAsB,QAAQ,iDAAgD;AACvF,SAASC,gCAAgC,QAAQ,6DAA4D;AAC7G,SAASC,iBAAiB,QAAQ,6CAA4C;AAC9E,SAASC,0BAA0B,QAAQ,sDAAqD;AAChG,SAASC,2BAA2B,QAAQ,uDAAsD;AAClG,SAASC,+BAA+B,QAAQ,4DAA2D;AAC3G,SAASC,kBAAkB,QAAQ,6CAA4C;AAC/E,SAASC,8BAA8B,QAAQ,0DAAyD;AACxG,SAASC,8BAA8B,QAAQ,2DAA0D;AACzG,SAASC,kCAAkC,QAAQ,gEAA+D;AAElH,OAAO,MAAMC,aAA0B;IACrChC;IACAD;IACAG;IACAW;IACAZ;IACAc;IACAN;IACAG;IACAD;IACAR;IACAe;IACAZ;IACAC;IACAG;IACAS;IACAE;IACAhB;IACAyB;IACAhB;IACAN;IACAQ;IACAC;IACAG;IACAE;IACAlB;IACAmB;IACAC;IACAC;IACAG;IACAF;IACAC;IACAI;IACAF;CACD,CAAA"}
+{"version":3,"sources":["../src/registry.ts"],"sourcesContent":["import type { Transform } from './types.js'\n\nimport { addOverrideAccessTrue } from './transforms/add-override-access-true/index.js'\nimport { exampleNoop } from './transforms/example-noop/index.js'\nimport { globalsComponentsEdit } from './transforms/globals-components-edit/index.js'\nimport { migrateAdminContextProperties } from './transforms/migrate-admin-context-properties/index.js'\nimport { migrateAfterOperationRead } from './transforms/migrate-after-operation-read/index.js'\nimport { migrateAliasedExports } from './transforms/migrate-aliased-exports/index.js'\nimport { migrateAuthorshipDefault } from './transforms/migrate-authorship-default/index.js'\nimport { migrateAzureChunkLargeFiles } from './transforms/migrate-azure-chunk-large-files/index.js'\nimport { migrateBlockReferencesToBlocks } from './transforms/migrate-block-references-to-blocks/index.js'\nimport { migrateBuildScript } from './transforms/migrate-build-script/index.js'\nimport { migrateDbTypesSubpath } from './transforms/migrate-db-types-subpath/index.js'\nimport { migrateDisabledFields } from './transforms/migrate-disabled-fields/index.js'\nimport { migrateDisplayedFieldValueArgs } from './transforms/migrate-displayed-field-value-args/index.js'\nimport { migrateDocumentTitleContext } from './transforms/migrate-document-title-context/index.js'\nimport { migrateFieldComponentTypes } from './transforms/migrate-field-component-types/index.js'\nimport { migrateForceSelect } from './transforms/migrate-force-select/index.js'\nimport { migrateHideAPIURL } from './transforms/migrate-hide-api-url/index.js'\nimport { migrateImportExportHooks } from './transforms/migrate-import-export-hooks/index.js'\nimport { migrateListViewSelectAPI } from './transforms/migrate-list-view-select-api/index.js'\nimport { migrateNextGenerateViewportExport } from './transforms/migrate-next-generate-viewport-export/index.js'\nimport { migrateNextSubpathExports } from './transforms/migrate-next-subpath-exports/index.js'\nimport { migratePayloadRequestCreation } from './transforms/migrate-payload-request-creation/index.js'\nimport { migrateSharpToTransformer } from './transforms/migrate-sharp-to-transformer/index.js'\nimport { migrateSlugField } from './transforms/migrate-slug-field/index.js'\nimport { migrateStorageAdaptersToConfig } from './transforms/migrate-storage-adapters-to-config/index.js'\nimport { migrateVersionsDefault } from './transforms/migrate-versions-default/index.js'\nimport { removeDefaultLocalePublishOption } from './transforms/remove-default-locale-publish-option/index.js'\nimport { removeGroupByTrue } from './transforms/remove-group-by-true/index.js'\nimport { removeLocalizeStatusConfig } from './transforms/remove-localize-status-config/index.js'\nimport { removePublishSpecificLocale } from './transforms/remove-publish-specific-locale/index.js'\nimport { removeStorageAlwaysInsertFields } from './transforms/remove-storage-always-insert-fields/index.js'\nimport { removeVersionsTrue } from './transforms/remove-versions-true/index.js'\nimport { renameDiffValueProps } from './transforms/rename-diff-value-props/index.js'\nimport { renameExperimentalTableFeature } from './transforms/rename-experimental-table-feature/index.js'\nimport { renameStorageAdaptersToStorage } from './transforms/rename-storage-adapters-to-storage/index.js'\nimport { renameTypescriptSchemaToJsonSchema } from './transforms/rename-typescript-schema-to-json-schema/index.js'\n\nexport const transforms: Transform[] = [\n  exampleNoop,\n  addOverrideAccessTrue,\n  migrateAfterOperationRead,\n  migrateHideAPIURL,\n  globalsComponentsEdit,\n  migrateListViewSelectAPI,\n  migrateDisabledFields,\n  migrateDisplayedFieldValueArgs,\n  migrateForceSelect,\n  migrateFieldComponentTypes,\n  renameDiffValueProps,\n  migrateAliasedExports,\n  migratePayloadRequestCreation,\n  migrateAdminContextProperties,\n  migrateBlockReferencesToBlocks,\n  migrateBuildScript,\n  migrateDocumentTitleContext,\n  migrateSharpToTransformer,\n  migrateStorageAdaptersToConfig,\n  migrateAzureChunkLargeFiles,\n  renameStorageAdaptersToStorage,\n  migrateImportExportHooks,\n  migrateDbTypesSubpath,\n  migrateNextGenerateViewportExport,\n  migrateNextSubpathExports,\n  migrateSlugField,\n  migrateVersionsDefault,\n  migrateAuthorshipDefault,\n  removeDefaultLocalePublishOption,\n  removeGroupByTrue,\n  removeLocalizeStatusConfig,\n  removeVersionsTrue,\n  removePublishSpecificLocale,\n  removeStorageAlwaysInsertFields,\n  renameTypescriptSchemaToJsonSchema,\n  renameExperimentalTableFeature,\n]\n"],"names":["addOverrideAccessTrue","exampleNoop","globalsComponentsEdit","migrateAdminContextProperties","migrateAfterOperationRead","migrateAliasedExports","migrateAuthorshipDefault","migrateAzureChunkLargeFiles","migrateBlockReferencesToBlocks","migrateBuildScript","migrateDbTypesSubpath","migrateDisabledFields","migrateDisplayedFieldValueArgs","migrateDocumentTitleContext","migrateFieldComponentTypes","migrateForceSelect","migrateHideAPIURL","migrateImportExportHooks","migrateListViewSelectAPI","migrateNextGenerateViewportExport","migrateNextSubpathExports","migratePayloadRequestCreation","migrateSharpToTransformer","migrateSlugField","migrateStorageAdaptersToConfig","migrateVersionsDefault","removeDefaultLocalePublishOption","removeGroupByTrue","removeLocalizeStatusConfig","removePublishSpecificLocale","removeStorageAlwaysInsertFields","removeVersionsTrue","renameDiffValueProps","renameExperimentalTableFeature","renameStorageAdaptersToStorage","renameTypescriptSchemaToJsonSchema","transforms"],"mappings":"AAEA,SAASA,qBAAqB,QAAQ,iDAAgD;AACtF,SAASC,WAAW,QAAQ,qCAAoC;AAChE,SAASC,qBAAqB,QAAQ,gDAA+C;AACrF,SAASC,6BAA6B,QAAQ,yDAAwD;AACtG,SAASC,yBAAyB,QAAQ,qDAAoD;AAC9F,SAASC,qBAAqB,QAAQ,gDAA+C;AACrF,SAASC,wBAAwB,QAAQ,mDAAkD;AAC3F,SAASC,2BAA2B,QAAQ,wDAAuD;AACnG,SAASC,8BAA8B,QAAQ,2DAA0D;AACzG,SAASC,kBAAkB,QAAQ,6CAA4C;AAC/E,SAASC,qBAAqB,QAAQ,iDAAgD;AACtF,SAASC,qBAAqB,QAAQ,gDAA+C;AACrF,SAASC,8BAA8B,QAAQ,2DAA0D;AACzG,SAASC,2BAA2B,QAAQ,uDAAsD;AAClG,SAASC,0BAA0B,QAAQ,sDAAqD;AAChG,SAASC,kBAAkB,QAAQ,6CAA4C;AAC/E,SAASC,iBAAiB,QAAQ,6CAA4C;AAC9E,SAASC,wBAAwB,QAAQ,oDAAmD;AAC5F,SAASC,wBAAwB,QAAQ,qDAAoD;AAC7F,SAASC,iCAAiC,QAAQ,8DAA6D;AAC/G,SAASC,yBAAyB,QAAQ,qDAAoD;AAC9F,SAASC,6BAA6B,QAAQ,yDAAwD;AACtG,SAASC,yBAAyB,QAAQ,qDAAoD;AAC9F,SAASC,gBAAgB,QAAQ,2CAA0C;AAC3E,SAASC,8BAA8B,QAAQ,2DAA0D;AACzG,SAASC,sBAAsB,QAAQ,iDAAgD;AACvF,SAASC,gCAAgC,QAAQ,6DAA4D;AAC7G,SAASC,iBAAiB,QAAQ,6CAA4C;AAC9E,SAASC,0BAA0B,QAAQ,sDAAqD;AAChG,SAASC,2BAA2B,QAAQ,uDAAsD;AAClG,SAASC,+BAA+B,QAAQ,4DAA2D;AAC3G,SAASC,kBAAkB,QAAQ,6CAA4C;AAC/E,SAASC,oBAAoB,QAAQ,gDAA+C;AACpF,SAASC,8BAA8B,QAAQ,0DAAyD;AACxG,SAASC,8BAA8B,QAAQ,2DAA0D;AACzG,SAASC,kCAAkC,QAAQ,gEAA+D;AAElH,OAAO,MAAMC,aAA0B;IACrCnC;IACAD;IACAI;IACAY;IACAd;IACAgB;IACAP;IACAC;IACAG;IACAD;IACAkB;IACA3B;IACAgB;IACAlB;IACAK;IACAC;IACAI;IACAS;IACAE;IACAjB;IACA2B;IACAjB;IACAP;IACAS;IACAC;IACAG;IACAE;IACAnB;IACAoB;IACAC;IACAC;IACAG;IACAF;IACAC;IACAK;IACAF;CACD,CAAA"}

package/dist/runbook/payload-v4-upgrade.md

@@ -19,11 +19,11 @@ while the v3 packages are still installed:
 
 ## 1. Next.js 16
 
-Payload v4 requires Next 16. The command did not touch Next. Run Next's own recommended agent
+Payload v4 requires Next 16.4 or higher. The command did not touch Next. Run Next's own recommended agent
 workflow, which bumps Next + React and migrates the code as one unit:
 <https://nextjs.org/docs/app/guides/upgrading/version-16#use-an-ai-agent-recommended>
 
-Keep the resulting Next version within `>=16.2.6 <17` (the exact target is printed in the
+Keep the resulting Next version within `>=16.4.0 <17` (the exact target is printed in the
 upgrade report), since Next's `upgrade latest` may point past 16 in future.
 
 ## 2. Regenerate generated files