@payloadcms/codemod 4.0.0-internal.f11981a → 4.0.0-internal.f2a04f7

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (417) hide show
  1. package/README.md +97 -27
  2. package/dist/cli.d.ts.map +1 -1
  3. package/dist/cli.help.d.ts +4 -0
  4. package/dist/cli.help.d.ts.map +1 -0
  5. package/dist/cli.help.js +29 -0
  6. package/dist/cli.help.js.map +1 -0
  7. package/dist/cli.js +49 -27
  8. package/dist/cli.js.map +1 -1
  9. package/dist/cli.parseFlags.d.ts +15 -0
  10. package/dist/cli.parseFlags.d.ts.map +1 -1
  11. package/dist/cli.parseFlags.js +35 -2
  12. package/dist/cli.parseFlags.js.map +1 -1
  13. package/dist/registry.d.ts.map +1 -1
  14. package/dist/registry.js +23 -1
  15. package/dist/registry.js.map +1 -1
  16. package/dist/runbook/payload-v4-upgrade.md +55 -0
  17. package/dist/runbook/v4.mdx +2516 -0
  18. package/dist/transforms/add-override-access-true/basic.input.js +41 -0
  19. package/dist/transforms/add-override-access-true/basic.input.js.map +1 -0
  20. package/dist/transforms/add-override-access-true/basic.output.js +50 -0
  21. package/dist/transforms/add-override-access-true/basic.output.js.map +1 -0
  22. package/dist/transforms/add-override-access-true/comment-between-properties.input.js +11 -0
  23. package/dist/transforms/add-override-access-true/comment-between-properties.input.js.map +1 -0
  24. package/dist/transforms/add-override-access-true/comment-between-properties.output.js +12 -0
  25. package/dist/transforms/add-override-access-true/comment-between-properties.output.js.map +1 -0
  26. package/dist/transforms/add-override-access-true/index.d.ts +20 -0
  27. package/dist/transforms/add-override-access-true/index.d.ts.map +1 -0
  28. package/dist/transforms/add-override-access-true/index.js +208 -0
  29. package/dist/transforms/add-override-access-true/index.js.map +1 -0
  30. package/dist/transforms/add-override-access-true/javascript.input.d.ts +6 -0
  31. package/dist/transforms/add-override-access-true/javascript.input.d.ts.map +1 -0
  32. package/dist/transforms/add-override-access-true/javascript.input.js +24 -0
  33. package/dist/transforms/add-override-access-true/javascript.input.js.map +1 -0
  34. package/dist/transforms/add-override-access-true/javascript.output.d.ts +6 -0
  35. package/dist/transforms/add-override-access-true/javascript.output.d.ts.map +1 -0
  36. package/dist/transforms/add-override-access-true/javascript.output.js +26 -0
  37. package/dist/transforms/add-override-access-true/javascript.output.js.map +1 -0
  38. package/dist/transforms/add-override-access-true/non-matching.input.js +42 -0
  39. package/dist/transforms/add-override-access-true/non-matching.input.js.map +1 -0
  40. package/dist/transforms/add-override-access-true/non-matching.output.js +42 -0
  41. package/dist/transforms/add-override-access-true/non-matching.output.js.map +1 -0
  42. package/dist/transforms/add-override-access-true/single-line.input.js +13 -0
  43. package/dist/transforms/add-override-access-true/single-line.input.js.map +1 -0
  44. package/dist/transforms/add-override-access-true/single-line.output.js +17 -0
  45. package/dist/transforms/add-override-access-true/single-line.output.js.map +1 -0
  46. package/dist/transforms/add-override-access-true/trailing-comment.input.js +10 -0
  47. package/dist/transforms/add-override-access-true/trailing-comment.input.js.map +1 -0
  48. package/dist/transforms/add-override-access-true/trailing-comment.output.js +12 -0
  49. package/dist/transforms/add-override-access-true/trailing-comment.output.js.map +1 -0
  50. package/dist/transforms/migrate-admin-context-properties/basic.input.js +32 -0
  51. package/dist/transforms/migrate-admin-context-properties/basic.input.js.map +1 -0
  52. package/dist/transforms/migrate-admin-context-properties/basic.output.js +30 -0
  53. package/dist/transforms/migrate-admin-context-properties/basic.output.js.map +1 -0
  54. package/dist/transforms/migrate-admin-context-properties/index.d.ts +3 -0
  55. package/dist/transforms/migrate-admin-context-properties/index.d.ts.map +1 -0
  56. package/dist/transforms/migrate-admin-context-properties/index.js +302 -0
  57. package/dist/transforms/migrate-admin-context-properties/index.js.map +1 -0
  58. package/dist/transforms/migrate-admin-context-properties/no-match.input.js +30 -0
  59. package/dist/transforms/migrate-admin-context-properties/no-match.input.js.map +1 -0
  60. package/dist/transforms/migrate-admin-context-properties/no-match.output.js +30 -0
  61. package/dist/transforms/migrate-admin-context-properties/no-match.output.js.map +1 -0
  62. package/dist/transforms/migrate-aliased-exports/index.d.ts.map +1 -1
  63. package/dist/transforms/migrate-aliased-exports/index.js +6 -5
  64. package/dist/transforms/migrate-aliased-exports/index.js.map +1 -1
  65. package/dist/transforms/migrate-aliased-exports/request.input.js +6 -0
  66. package/dist/transforms/migrate-aliased-exports/request.input.js.map +1 -0
  67. package/dist/transforms/migrate-aliased-exports/request.output.js +5 -0
  68. package/dist/transforms/migrate-aliased-exports/request.output.js.map +1 -0
  69. package/dist/transforms/migrate-authorship-default/already-set.input.js +15 -0
  70. package/dist/transforms/migrate-authorship-default/already-set.input.js.map +1 -0
  71. package/dist/transforms/migrate-authorship-default/already-set.output.js +15 -0
  72. package/dist/transforms/migrate-authorship-default/already-set.output.js.map +1 -0
  73. package/dist/transforms/migrate-authorship-default/basic.input.js +16 -0
  74. package/dist/transforms/migrate-authorship-default/basic.input.js.map +1 -0
  75. package/dist/transforms/migrate-authorship-default/basic.output.js +18 -0
  76. package/dist/transforms/migrate-authorship-default/basic.output.js.map +1 -0
  77. package/dist/transforms/migrate-authorship-default/build-config.input.js +32 -0
  78. package/dist/transforms/migrate-authorship-default/build-config.input.js.map +1 -0
  79. package/dist/transforms/migrate-authorship-default/build-config.output.js +35 -0
  80. package/dist/transforms/migrate-authorship-default/build-config.output.js.map +1 -0
  81. package/dist/transforms/migrate-authorship-default/globals.input.js +16 -0
  82. package/dist/transforms/migrate-authorship-default/globals.input.js.map +1 -0
  83. package/dist/transforms/migrate-authorship-default/globals.output.js +17 -0
  84. package/dist/transforms/migrate-authorship-default/globals.output.js.map +1 -0
  85. package/dist/transforms/migrate-authorship-default/index.d.ts +11 -0
  86. package/dist/transforms/migrate-authorship-default/index.d.ts.map +1 -0
  87. package/dist/transforms/migrate-authorship-default/index.js +141 -0
  88. package/dist/transforms/migrate-authorship-default/index.js.map +1 -0
  89. package/dist/transforms/migrate-authorship-default/non-matching.input.js +18 -0
  90. package/dist/transforms/migrate-authorship-default/non-matching.input.js.map +1 -0
  91. package/dist/transforms/migrate-authorship-default/non-matching.output.js +18 -0
  92. package/dist/transforms/migrate-authorship-default/non-matching.output.js.map +1 -0
  93. package/dist/transforms/migrate-authorship-default/satisfies.input.js +11 -0
  94. package/dist/transforms/migrate-authorship-default/satisfies.input.js.map +1 -0
  95. package/dist/transforms/migrate-authorship-default/satisfies.output.js +13 -0
  96. package/dist/transforms/migrate-authorship-default/satisfies.output.js.map +1 -0
  97. package/dist/transforms/migrate-displayed-field-value-args/basic.input.js +4 -0
  98. package/dist/transforms/migrate-displayed-field-value-args/basic.input.js.map +1 -0
  99. package/dist/transforms/migrate-displayed-field-value-args/basic.output.js +8 -0
  100. package/dist/transforms/migrate-displayed-field-value-args/basic.output.js.map +1 -0
  101. package/dist/transforms/migrate-displayed-field-value-args/index.d.ts +3 -0
  102. package/dist/transforms/migrate-displayed-field-value-args/index.d.ts.map +1 -0
  103. package/dist/transforms/migrate-displayed-field-value-args/index.js +84 -0
  104. package/dist/transforms/migrate-displayed-field-value-args/index.js.map +1 -0
  105. package/dist/transforms/migrate-displayed-field-value-args/namespace.input.js +4 -0
  106. package/dist/transforms/migrate-displayed-field-value-args/namespace.input.js.map +1 -0
  107. package/dist/transforms/migrate-displayed-field-value-args/namespace.output.js +8 -0
  108. package/dist/transforms/migrate-displayed-field-value-args/namespace.output.js.map +1 -0
  109. package/dist/transforms/migrate-displayed-field-value-args/no-match.input.js +4 -0
  110. package/dist/transforms/migrate-displayed-field-value-args/no-match.input.js.map +1 -0
  111. package/dist/transforms/migrate-displayed-field-value-args/no-match.output.js +4 -0
  112. package/dist/transforms/migrate-displayed-field-value-args/no-match.output.js.map +1 -0
  113. package/dist/transforms/migrate-field-component-types/basic.input.js +8 -0
  114. package/dist/transforms/migrate-field-component-types/basic.input.js.map +1 -0
  115. package/dist/transforms/migrate-field-component-types/basic.output.js +8 -0
  116. package/dist/transforms/migrate-field-component-types/basic.output.js.map +1 -0
  117. package/dist/transforms/migrate-field-component-types/index.d.ts +3 -0
  118. package/dist/transforms/migrate-field-component-types/index.d.ts.map +1 -0
  119. package/dist/transforms/migrate-field-component-types/index.js +620 -0
  120. package/dist/transforms/migrate-field-component-types/index.js.map +1 -0
  121. package/dist/transforms/migrate-payload-request-creation/aliases.input.js +8 -0
  122. package/dist/transforms/migrate-payload-request-creation/aliases.input.js.map +1 -0
  123. package/dist/transforms/migrate-payload-request-creation/aliases.output.js +31 -0
  124. package/dist/transforms/migrate-payload-request-creation/aliases.output.js.map +1 -0
  125. package/dist/transforms/migrate-payload-request-creation/collision.input.js +9 -0
  126. package/dist/transforms/migrate-payload-request-creation/collision.input.js.map +1 -0
  127. package/dist/transforms/migrate-payload-request-creation/comments.input.js +9 -0
  128. package/dist/transforms/migrate-payload-request-creation/comments.input.js.map +1 -0
  129. package/dist/transforms/migrate-payload-request-creation/comments.output.js +34 -0
  130. package/dist/transforms/migrate-payload-request-creation/comments.output.js.map +1 -0
  131. package/dist/transforms/migrate-payload-request-creation/empty.input.js +5 -0
  132. package/dist/transforms/migrate-payload-request-creation/empty.input.js.map +1 -0
  133. package/dist/transforms/migrate-payload-request-creation/empty.output.js +7 -0
  134. package/dist/transforms/migrate-payload-request-creation/empty.output.js.map +1 -0
  135. package/dist/transforms/migrate-payload-request-creation/evaluation-order.input.js +10 -0
  136. package/dist/transforms/migrate-payload-request-creation/evaluation-order.input.js.map +1 -0
  137. package/dist/transforms/migrate-payload-request-creation/expression.input.js +8 -0
  138. package/dist/transforms/migrate-payload-request-creation/expression.input.js.map +1 -0
  139. package/dist/transforms/migrate-payload-request-creation/expression.output.js +8 -0
  140. package/dist/transforms/migrate-payload-request-creation/expression.output.js.map +1 -0
  141. package/dist/transforms/migrate-payload-request-creation/getters.input.js +52 -0
  142. package/dist/transforms/migrate-payload-request-creation/getters.input.js.map +1 -0
  143. package/dist/transforms/migrate-payload-request-creation/index.d.ts +3 -0
  144. package/dist/transforms/migrate-payload-request-creation/index.d.ts.map +1 -0
  145. package/dist/transforms/migrate-payload-request-creation/index.js +236 -0
  146. package/dist/transforms/migrate-payload-request-creation/index.js.map +1 -0
  147. package/dist/transforms/migrate-payload-request-creation/internal.input.js +6 -0
  148. package/dist/transforms/migrate-payload-request-creation/internal.input.js.map +1 -0
  149. package/dist/transforms/migrate-payload-request-creation/internal.output.js +6 -0
  150. package/dist/transforms/migrate-payload-request-creation/internal.output.js.map +1 -0
  151. package/dist/transforms/migrate-payload-request-creation/non-matching.input.js +5 -0
  152. package/dist/transforms/migrate-payload-request-creation/non-matching.input.js.map +1 -0
  153. package/dist/transforms/migrate-payload-request-creation/populated.input.js +7 -0
  154. package/dist/transforms/migrate-payload-request-creation/populated.input.js.map +1 -0
  155. package/dist/transforms/migrate-payload-request-creation/populated.output.js +30 -0
  156. package/dist/transforms/migrate-payload-request-creation/populated.output.js.map +1 -0
  157. package/dist/transforms/migrate-payload-request-creation/shadowed.input.js +7 -0
  158. package/dist/transforms/migrate-payload-request-creation/shadowed.input.js.map +1 -0
  159. package/dist/transforms/migrate-payload-request-creation/shadowed.output.js +9 -0
  160. package/dist/transforms/migrate-payload-request-creation/shadowed.output.js.map +1 -0
  161. package/dist/transforms/migrate-payload-request-creation/shorthand.input.js +12 -0
  162. package/dist/transforms/migrate-payload-request-creation/shorthand.input.js.map +1 -0
  163. package/dist/transforms/migrate-payload-request-creation/shorthand.output.js +12 -0
  164. package/dist/transforms/migrate-payload-request-creation/shorthand.output.js.map +1 -0
  165. package/dist/transforms/migrate-payload-request-creation/unsupported.input.js +9 -0
  166. package/dist/transforms/migrate-payload-request-creation/unsupported.input.js.map +1 -0
  167. package/dist/transforms/migrate-sharp-to-transformer/basic.input.js +28 -0
  168. package/dist/transforms/migrate-sharp-to-transformer/basic.input.js.map +1 -0
  169. package/dist/transforms/migrate-sharp-to-transformer/basic.output.js +39 -0
  170. package/dist/transforms/migrate-sharp-to-transformer/basic.output.js.map +1 -0
  171. package/dist/transforms/migrate-sharp-to-transformer/existing-transformers.input.js +27 -0
  172. package/dist/transforms/migrate-sharp-to-transformer/existing-transformers.input.js.map +1 -0
  173. package/dist/transforms/migrate-sharp-to-transformer/existing-transformers.output.js +33 -0
  174. package/dist/transforms/migrate-sharp-to-transformer/existing-transformers.output.js.map +1 -0
  175. package/dist/transforms/migrate-sharp-to-transformer/index.d.ts +3 -0
  176. package/dist/transforms/migrate-sharp-to-transformer/index.d.ts.map +1 -0
  177. package/dist/transforms/migrate-sharp-to-transformer/index.js +430 -0
  178. package/dist/transforms/migrate-sharp-to-transformer/index.js.map +1 -0
  179. package/dist/transforms/migrate-sharp-to-transformer/no-match.input.js +11 -0
  180. package/dist/transforms/migrate-sharp-to-transformer/no-match.input.js.map +1 -0
  181. package/dist/transforms/migrate-sharp-to-transformer/no-match.output.js +11 -0
  182. package/dist/transforms/migrate-sharp-to-transformer/no-match.output.js.map +1 -0
  183. package/dist/transforms/migrate-versions-default/index.js +5 -5
  184. package/dist/transforms/migrate-versions-default/index.js.map +1 -1
  185. package/dist/transforms/remove-default-locale-publish-option/all-value.input.js +13 -0
  186. package/dist/transforms/remove-default-locale-publish-option/all-value.input.js.map +1 -0
  187. package/dist/transforms/remove-default-locale-publish-option/basic.input.js +13 -0
  188. package/dist/transforms/remove-default-locale-publish-option/basic.input.js.map +1 -0
  189. package/dist/transforms/remove-default-locale-publish-option/basic.output.js +12 -0
  190. package/dist/transforms/remove-default-locale-publish-option/basic.output.js.map +1 -0
  191. package/dist/transforms/remove-default-locale-publish-option/dynamic.input.js +17 -0
  192. package/dist/transforms/remove-default-locale-publish-option/dynamic.input.js.map +1 -0
  193. package/dist/transforms/remove-default-locale-publish-option/index.d.ts +10 -0
  194. package/dist/transforms/remove-default-locale-publish-option/index.d.ts.map +1 -0
  195. package/dist/transforms/remove-default-locale-publish-option/index.js +103 -0
  196. package/dist/transforms/remove-default-locale-publish-option/index.js.map +1 -0
  197. package/dist/transforms/remove-default-locale-publish-option/no-match.input.js +10 -0
  198. package/dist/transforms/remove-default-locale-publish-option/no-match.input.js.map +1 -0
  199. package/dist/transforms/remove-default-locale-publish-option/no-match.output.js +10 -0
  200. package/dist/transforms/remove-default-locale-publish-option/no-match.output.js.map +1 -0
  201. package/dist/transforms/remove-default-locale-publish-option/reassigned.input.js +22 -0
  202. package/dist/transforms/remove-default-locale-publish-option/reassigned.input.js.map +1 -0
  203. package/dist/transforms/remove-default-locale-publish-option/shorthand.input.js +14 -0
  204. package/dist/transforms/remove-default-locale-publish-option/shorthand.input.js.map +1 -0
  205. package/dist/transforms/remove-default-locale-publish-option/shorthand.output.js +13 -0
  206. package/dist/transforms/remove-default-locale-publish-option/shorthand.output.js.map +1 -0
  207. package/dist/transforms/remove-publish-specific-locale/index.d.ts.map +1 -1
  208. package/dist/transforms/remove-publish-specific-locale/index.js.map +1 -1
  209. package/dist/transforms/remove-storage-always-insert-fields/aliased.input.js +11 -0
  210. package/dist/transforms/remove-storage-always-insert-fields/aliased.input.js.map +1 -0
  211. package/dist/transforms/remove-storage-always-insert-fields/aliased.output.js +10 -0
  212. package/dist/transforms/remove-storage-always-insert-fields/aliased.output.js.map +1 -0
  213. package/dist/transforms/remove-storage-always-insert-fields/basic.input.js +54 -0
  214. package/dist/transforms/remove-storage-always-insert-fields/basic.input.js.map +1 -0
  215. package/dist/transforms/remove-storage-always-insert-fields/basic.output.js +48 -0
  216. package/dist/transforms/remove-storage-always-insert-fields/basic.output.js.map +1 -0
  217. package/dist/transforms/remove-storage-always-insert-fields/index.d.ts +3 -0
  218. package/dist/transforms/remove-storage-always-insert-fields/index.d.ts.map +1 -0
  219. package/dist/transforms/remove-storage-always-insert-fields/index.js +75 -0
  220. package/dist/transforms/remove-storage-always-insert-fields/index.js.map +1 -0
  221. package/dist/transforms/remove-storage-always-insert-fields/no-match.input.js +27 -0
  222. package/dist/transforms/remove-storage-always-insert-fields/no-match.input.js.map +1 -0
  223. package/dist/transforms/remove-storage-always-insert-fields/no-match.output.js +27 -0
  224. package/dist/transforms/remove-storage-always-insert-fields/no-match.output.js.map +1 -0
  225. package/dist/transforms/remove-versions-true/index.js +4 -4
  226. package/dist/transforms/remove-versions-true/index.js.map +1 -1
  227. package/dist/transforms/rename-diff-value-props/basic.input.js +38 -0
  228. package/dist/transforms/rename-diff-value-props/basic.input.js.map +1 -0
  229. package/dist/transforms/rename-diff-value-props/basic.output.js +38 -0
  230. package/dist/transforms/rename-diff-value-props/basic.output.js.map +1 -0
  231. package/dist/transforms/rename-diff-value-props/index.d.ts +3 -0
  232. package/dist/transforms/rename-diff-value-props/index.d.ts.map +1 -0
  233. package/dist/transforms/rename-diff-value-props/index.js +328 -0
  234. package/dist/transforms/rename-diff-value-props/index.js.map +1 -0
  235. package/dist/transforms/rename-diff-value-props/no-match.input.js +8 -0
  236. package/dist/transforms/rename-diff-value-props/no-match.input.js.map +1 -0
  237. package/dist/transforms/rename-experimental-table-feature/alias.input.js +6 -0
  238. package/dist/transforms/rename-experimental-table-feature/alias.input.js.map +1 -0
  239. package/dist/transforms/rename-experimental-table-feature/alias.output.js +6 -0
  240. package/dist/transforms/rename-experimental-table-feature/alias.output.js.map +1 -0
  241. package/dist/transforms/rename-experimental-table-feature/basic.input.js +19 -0
  242. package/dist/transforms/rename-experimental-table-feature/basic.input.js.map +1 -0
  243. package/dist/transforms/rename-experimental-table-feature/basic.output.js +19 -0
  244. package/dist/transforms/rename-experimental-table-feature/basic.output.js.map +1 -0
  245. package/dist/transforms/rename-experimental-table-feature/collision.input.js +7 -0
  246. package/dist/transforms/rename-experimental-table-feature/collision.input.js.map +1 -0
  247. package/dist/transforms/rename-experimental-table-feature/index.d.ts +3 -0
  248. package/dist/transforms/rename-experimental-table-feature/index.d.ts.map +1 -0
  249. package/dist/transforms/rename-experimental-table-feature/index.js +50 -0
  250. package/dist/transforms/rename-experimental-table-feature/index.js.map +1 -0
  251. package/dist/transforms/rename-experimental-table-feature/no-match.input.js +9 -0
  252. package/dist/transforms/rename-experimental-table-feature/no-match.input.js.map +1 -0
  253. package/dist/upgrade/defaultTag.d.ts +9 -0
  254. package/dist/upgrade/defaultTag.d.ts.map +1 -0
  255. package/dist/upgrade/defaultTag.js +25 -0
  256. package/dist/upgrade/defaultTag.js.map +1 -0
  257. package/dist/upgrade/detectPackageManager.d.ts +8 -0
  258. package/dist/upgrade/detectPackageManager.d.ts.map +1 -0
  259. package/dist/upgrade/detectPackageManager.js +38 -0
  260. package/dist/upgrade/detectPackageManager.js.map +1 -0
  261. package/dist/upgrade/dispatch.d.ts +38 -0
  262. package/dist/upgrade/dispatch.d.ts.map +1 -0
  263. package/dist/upgrade/dispatch.js +132 -0
  264. package/dist/upgrade/dispatch.js.map +1 -0
  265. package/dist/upgrade/index.d.ts +25 -0
  266. package/dist/upgrade/index.d.ts.map +1 -0
  267. package/dist/upgrade/index.js +209 -0
  268. package/dist/upgrade/index.js.map +1 -0
  269. package/dist/upgrade/prompt.d.ts +14 -0
  270. package/dist/upgrade/prompt.d.ts.map +1 -0
  271. package/dist/upgrade/prompt.js +77 -0
  272. package/dist/upgrade/prompt.js.map +1 -0
  273. package/dist/upgrade/report.d.ts +21 -0
  274. package/dist/upgrade/report.d.ts.map +1 -0
  275. package/dist/upgrade/report.js +47 -0
  276. package/dist/upgrade/report.js.map +1 -0
  277. package/dist/upgrade/resolveVersions.d.ts +13 -0
  278. package/dist/upgrade/resolveVersions.d.ts.map +1 -0
  279. package/dist/upgrade/resolveVersions.js +55 -0
  280. package/dist/upgrade/resolveVersions.js.map +1 -0
  281. package/dist/upgrade/rewritePackageJson.d.ts +32 -0
  282. package/dist/upgrade/rewritePackageJson.d.ts.map +1 -0
  283. package/dist/upgrade/rewritePackageJson.js +164 -0
  284. package/dist/upgrade/rewritePackageJson.js.map +1 -0
  285. package/dist/upgrade/runInstall.d.ts +16 -0
  286. package/dist/upgrade/runInstall.d.ts.map +1 -0
  287. package/dist/upgrade/runInstall.js +17 -0
  288. package/dist/upgrade/runInstall.js.map +1 -0
  289. package/dist/upgrade/selectAgent.d.ts +45 -0
  290. package/dist/upgrade/selectAgent.d.ts.map +1 -0
  291. package/dist/upgrade/selectAgent.js +54 -0
  292. package/dist/upgrade/selectAgent.js.map +1 -0
  293. package/dist/upgrade/selfCommand.d.ts +13 -0
  294. package/dist/upgrade/selfCommand.d.ts.map +1 -0
  295. package/dist/upgrade/selfCommand.js +17 -0
  296. package/dist/upgrade/selfCommand.js.map +1 -0
  297. package/dist/upgrade/types.d.ts +47 -0
  298. package/dist/upgrade/types.d.ts.map +1 -0
  299. package/dist/upgrade/types.js +11 -0
  300. package/dist/upgrade/types.js.map +1 -0
  301. package/dist/utils/project.d.ts +10 -0
  302. package/dist/utils/project.d.ts.map +1 -0
  303. package/dist/utils/project.js +43 -0
  304. package/dist/utils/project.js.map +1 -0
  305. package/package.json +16 -12
  306. package/dist/cli.parseFlags.spec.d.ts +0 -2
  307. package/dist/cli.parseFlags.spec.d.ts.map +0 -1
  308. package/dist/cli.parseFlags.spec.js +0 -49
  309. package/dist/cli.parseFlags.spec.js.map +0 -1
  310. package/dist/runner.spec.d.ts +0 -2
  311. package/dist/runner.spec.d.ts.map +0 -1
  312. package/dist/runner.spec.js +0 -88
  313. package/dist/runner.spec.js.map +0 -1
  314. package/dist/transforms/example-noop/index.spec.d.ts +0 -2
  315. package/dist/transforms/example-noop/index.spec.d.ts.map +0 -1
  316. package/dist/transforms/example-noop/index.spec.js +0 -29
  317. package/dist/transforms/example-noop/index.spec.js.map +0 -1
  318. package/dist/transforms/globals-components-edit/index.spec.d.ts +0 -2
  319. package/dist/transforms/globals-components-edit/index.spec.d.ts.map +0 -1
  320. package/dist/transforms/globals-components-edit/index.spec.js +0 -37
  321. package/dist/transforms/globals-components-edit/index.spec.js.map +0 -1
  322. package/dist/transforms/migrate-after-operation-read/index.spec.d.ts +0 -2
  323. package/dist/transforms/migrate-after-operation-read/index.spec.d.ts.map +0 -1
  324. package/dist/transforms/migrate-after-operation-read/index.spec.js +0 -62
  325. package/dist/transforms/migrate-after-operation-read/index.spec.js.map +0 -1
  326. package/dist/transforms/migrate-aliased-exports/index.spec.d.ts +0 -2
  327. package/dist/transforms/migrate-aliased-exports/index.spec.d.ts.map +0 -1
  328. package/dist/transforms/migrate-aliased-exports/index.spec.js +0 -55
  329. package/dist/transforms/migrate-aliased-exports/index.spec.js.map +0 -1
  330. package/dist/transforms/migrate-azure-chunk-large-files/index.spec.d.ts +0 -2
  331. package/dist/transforms/migrate-azure-chunk-large-files/index.spec.d.ts.map +0 -1
  332. package/dist/transforms/migrate-azure-chunk-large-files/index.spec.js +0 -67
  333. package/dist/transforms/migrate-azure-chunk-large-files/index.spec.js.map +0 -1
  334. package/dist/transforms/migrate-block-references-to-blocks/index.spec.d.ts +0 -2
  335. package/dist/transforms/migrate-block-references-to-blocks/index.spec.d.ts.map +0 -1
  336. package/dist/transforms/migrate-block-references-to-blocks/index.spec.js +0 -45
  337. package/dist/transforms/migrate-block-references-to-blocks/index.spec.js.map +0 -1
  338. package/dist/transforms/migrate-build-script/index.spec.d.ts +0 -2
  339. package/dist/transforms/migrate-build-script/index.spec.d.ts.map +0 -1
  340. package/dist/transforms/migrate-build-script/index.spec.js +0 -81
  341. package/dist/transforms/migrate-build-script/index.spec.js.map +0 -1
  342. package/dist/transforms/migrate-db-types-subpath/index.spec.d.ts +0 -2
  343. package/dist/transforms/migrate-db-types-subpath/index.spec.d.ts.map +0 -1
  344. package/dist/transforms/migrate-db-types-subpath/index.spec.js +0 -46
  345. package/dist/transforms/migrate-db-types-subpath/index.spec.js.map +0 -1
  346. package/dist/transforms/migrate-disabled-fields/index.spec.d.ts +0 -2
  347. package/dist/transforms/migrate-disabled-fields/index.spec.d.ts.map +0 -1
  348. package/dist/transforms/migrate-disabled-fields/index.spec.js +0 -73
  349. package/dist/transforms/migrate-disabled-fields/index.spec.js.map +0 -1
  350. package/dist/transforms/migrate-document-title-context/index.spec.d.ts +0 -2
  351. package/dist/transforms/migrate-document-title-context/index.spec.d.ts.map +0 -1
  352. package/dist/transforms/migrate-document-title-context/index.spec.js +0 -86
  353. package/dist/transforms/migrate-document-title-context/index.spec.js.map +0 -1
  354. package/dist/transforms/migrate-force-select/index.spec.d.ts +0 -2
  355. package/dist/transforms/migrate-force-select/index.spec.d.ts.map +0 -1
  356. package/dist/transforms/migrate-force-select/index.spec.js +0 -107
  357. package/dist/transforms/migrate-force-select/index.spec.js.map +0 -1
  358. package/dist/transforms/migrate-hide-api-url/index.spec.d.ts +0 -2
  359. package/dist/transforms/migrate-hide-api-url/index.spec.d.ts.map +0 -1
  360. package/dist/transforms/migrate-hide-api-url/index.spec.js +0 -118
  361. package/dist/transforms/migrate-hide-api-url/index.spec.js.map +0 -1
  362. package/dist/transforms/migrate-import-export-hooks/index.spec.d.ts +0 -2
  363. package/dist/transforms/migrate-import-export-hooks/index.spec.d.ts.map +0 -1
  364. package/dist/transforms/migrate-import-export-hooks/index.spec.js +0 -65
  365. package/dist/transforms/migrate-import-export-hooks/index.spec.js.map +0 -1
  366. package/dist/transforms/migrate-list-view-select-api/index.spec.d.ts +0 -2
  367. package/dist/transforms/migrate-list-view-select-api/index.spec.d.ts.map +0 -1
  368. package/dist/transforms/migrate-list-view-select-api/index.spec.js +0 -37
  369. package/dist/transforms/migrate-list-view-select-api/index.spec.js.map +0 -1
  370. package/dist/transforms/migrate-next-generate-viewport-export/index.spec.d.ts +0 -2
  371. package/dist/transforms/migrate-next-generate-viewport-export/index.spec.d.ts.map +0 -1
  372. package/dist/transforms/migrate-next-generate-viewport-export/index.spec.js +0 -41
  373. package/dist/transforms/migrate-next-generate-viewport-export/index.spec.js.map +0 -1
  374. package/dist/transforms/migrate-next-subpath-exports/index.spec.d.ts +0 -2
  375. package/dist/transforms/migrate-next-subpath-exports/index.spec.d.ts.map +0 -1
  376. package/dist/transforms/migrate-next-subpath-exports/index.spec.js +0 -46
  377. package/dist/transforms/migrate-next-subpath-exports/index.spec.js.map +0 -1
  378. package/dist/transforms/migrate-slug-field/index.spec.d.ts +0 -2
  379. package/dist/transforms/migrate-slug-field/index.spec.d.ts.map +0 -1
  380. package/dist/transforms/migrate-slug-field/index.spec.js +0 -47
  381. package/dist/transforms/migrate-slug-field/index.spec.js.map +0 -1
  382. package/dist/transforms/migrate-storage-adapters-to-config/index.spec.d.ts +0 -2
  383. package/dist/transforms/migrate-storage-adapters-to-config/index.spec.d.ts.map +0 -1
  384. package/dist/transforms/migrate-storage-adapters-to-config/index.spec.js +0 -85
  385. package/dist/transforms/migrate-storage-adapters-to-config/index.spec.js.map +0 -1
  386. package/dist/transforms/migrate-versions-default/index.spec.d.ts +0 -2
  387. package/dist/transforms/migrate-versions-default/index.spec.d.ts.map +0 -1
  388. package/dist/transforms/migrate-versions-default/index.spec.js +0 -81
  389. package/dist/transforms/migrate-versions-default/index.spec.js.map +0 -1
  390. package/dist/transforms/remove-group-by-true/index.spec.d.ts +0 -2
  391. package/dist/transforms/remove-group-by-true/index.spec.d.ts.map +0 -1
  392. package/dist/transforms/remove-group-by-true/index.spec.js +0 -47
  393. package/dist/transforms/remove-group-by-true/index.spec.js.map +0 -1
  394. package/dist/transforms/remove-localize-status-config/index.spec.d.ts +0 -2
  395. package/dist/transforms/remove-localize-status-config/index.spec.d.ts.map +0 -1
  396. package/dist/transforms/remove-localize-status-config/index.spec.js +0 -38
  397. package/dist/transforms/remove-localize-status-config/index.spec.js.map +0 -1
  398. package/dist/transforms/remove-publish-specific-locale/index.spec.d.ts +0 -2
  399. package/dist/transforms/remove-publish-specific-locale/index.spec.d.ts.map +0 -1
  400. package/dist/transforms/remove-publish-specific-locale/index.spec.js +0 -47
  401. package/dist/transforms/remove-publish-specific-locale/index.spec.js.map +0 -1
  402. package/dist/transforms/remove-versions-true/index.spec.d.ts +0 -2
  403. package/dist/transforms/remove-versions-true/index.spec.d.ts.map +0 -1
  404. package/dist/transforms/remove-versions-true/index.spec.js +0 -38
  405. package/dist/transforms/remove-versions-true/index.spec.js.map +0 -1
  406. package/dist/transforms/rename-storage-adapters-to-storage/index.spec.d.ts +0 -2
  407. package/dist/transforms/rename-storage-adapters-to-storage/index.spec.d.ts.map +0 -1
  408. package/dist/transforms/rename-storage-adapters-to-storage/index.spec.js +0 -55
  409. package/dist/transforms/rename-storage-adapters-to-storage/index.spec.js.map +0 -1
  410. package/dist/transforms/rename-typescript-schema-to-json-schema/index.spec.d.ts +0 -2
  411. package/dist/transforms/rename-typescript-schema-to-json-schema/index.spec.d.ts.map +0 -1
  412. package/dist/transforms/rename-typescript-schema-to-json-schema/index.spec.js +0 -45
  413. package/dist/transforms/rename-typescript-schema-to-json-schema/index.spec.js.map +0 -1
  414. package/dist/utils/packageJson.spec.d.ts +0 -2
  415. package/dist/utils/packageJson.spec.d.ts.map +0 -1
  416. package/dist/utils/packageJson.spec.js +0 -41
  417. package/dist/utils/packageJson.spec.js.map +0 -1
package/README.md CHANGED
@@ -14,10 +14,67 @@ With no arguments, runs every registered transform against the current directory
14
14
 
15
15
  ### Flags
16
16
 
17
- - `--transform <name>` — run a single transform by name.
18
- - `--list` — print registered transforms.
19
- - `--dry` — analyze only; write nothing.
20
- - `--print` — print transformed sources to stdout instead of writing.
17
+ - `--transform <name>`: run a single transform by name.
18
+ - `--list`: print registered transforms.
19
+ - `--dry`: analyze only; write nothing.
20
+ - `--print`: print transformed sources to stdout instead of writing.
21
+ - `-h`, `--help`: print usage for all commands and exit. Works on any command, e.g. `upgrade run --help`.
22
+
23
+ ## `upgrade` command
24
+
25
+ The `upgrade` command has three verbs.
26
+
27
+ ### `upgrade` (pick how to run it)
28
+
29
+ `npx @payloadcms/codemod upgrade` is the entry point. It detects installed coding-agent CLIs
30
+ (`claude`, `codex`) and asks how you want to run the full v3 -> v4 upgrade, Next.js 16 included:
31
+
32
+ - Hand the orchestration prompt to a detected agent. The agent runs the whole sequence, calling
33
+ `upgrade run` for the mechanical slice as one step.
34
+ - Run the mechanical steps here, the same work as `upgrade run`.
35
+ - Just print the prompt to run it yourself or paste it elsewhere.
36
+
37
+ Pin an agent with `--agent <claude|codex>` to skip the picker. When there is no TTY (CI), it prints
38
+ the prompt instead of prompting.
39
+
40
+ ### `upgrade run` (mechanical slice)
41
+
42
+ `npx @payloadcms/codemod upgrade run` performs the deterministic v3 -> v4 slice against the current
43
+ directory (run it from your project root):
44
+
45
+ 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>`).
46
+ 2. Rewrites `package.json`: pins `payload` + every `@payloadcms/*` to that exact version in
47
+ lockstep, removes dependency overrides pinning them, converts their carets to exact, and writes
48
+ the TypeScript / `@types/node` / `engines.node` floors. The `@payloadcms/eslint-*` packages are
49
+ versioned independently, so they are set to `latest` rather than lockstep-pinned.
50
+ 3. Installs with your detected package manager.
51
+ 4. Runs every registered transform against the now-v4 tree.
52
+ 5. Prints a report and points you at the bundled runbook for the rest.
53
+
54
+ It does NOT upgrade Next.js. Payload v4 requires Next 16; run Next's own recommended agent
55
+ workflow (linked from the bundled runbook) to bump Next and migrate the code together. The report
56
+ prints the required Next target.
57
+
58
+ Flags:
59
+
60
+ - `--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`).
61
+ - `--dry`: preview the `package.json` changes and planned steps; write and install nothing.
62
+ - `--force`: skip the dirty-git-tree warning.
63
+
64
+ ### `upgrade prompt` (print the prompt)
65
+
66
+ `npx @payloadcms/codemod upgrade prompt` prints the orchestration prompt to stdout and exits. It is
67
+ offline and stateless: it writes nothing and makes no network calls. The text is project-agnostic,
68
+ so pipe it to any agent and run it from the project root. This is the same prompt the `upgrade`
69
+ picker hands off, minus the detection and spawn.
70
+
71
+ The prompt sequences the upgrade (mechanical slice via `upgrade run`, then Next.js via Next's own
72
+ codemods and agent workflow, then regeneration, judgment work, and verification) and points at the
73
+ bundled runbook and migration guide for detail rather than restating them.
74
+
75
+ The mechanical-slice command inside the prompt re-invokes this CLI. A published install emits
76
+ `npx @payloadcms/codemod`; a source checkout emits `node <bin>` so followers run the local build.
77
+ Set `PAYLOAD_CODEMOD_COMMAND` to override the emitted token.
21
78
 
22
79
  ## How it works
23
80
 
@@ -25,29 +82,42 @@ The tool loads your project via [ts-morph](https://ts-morph.com/), using your `t
25
82
 
26
83
  ## Transforms
27
84
 
28
- - `migrate-list-view-select-api` — Removes `admin.enableListViewSelectAPI` from Collection Configs. The List View's Select API is the default in v4.
29
- - `migrate-disabled-fields` — migrates `field.admin.disableListColumn`, `disableListFilter`, `disableGroupBy`, `disableBulkEdit` and their equivalents on `imageSize.admin` into the consolidated `disabled` object form.
30
- - `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.
31
- - `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.
32
- - `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.
33
- - `migrate-hide-api-url` — migrates `admin.hideAPIURL: true` to `admin.components.views.edit.api.tab.condition: () => false` on collection and global configs.
34
- - `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`.
35
- - `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`.
36
- - `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.
37
- - `rename-storage-adapters-to-storage` — renames the top-level `storageAdapters` config property to `storage`. Skips any object that already has a `storage` property. Run this if you previously ran `migrate-storage-adapters-to-config` and need to update the property name.
38
- - `migrate-azure-chunk-large-files` — removes the `chunkLargeFiles` option from `azureStorage` `clientUploads` config. Chunked client uploads are the default in v4, so the flag no longer exists; `clientUploads: { chunkLargeFiles: true }` collapses to `clientUploads: true`. Surfaces a note when `chunkLargeFiles: false` was removed, since v4 can no longer disable chunking (and its broader CORS requirements apply).
39
- - `migrate-import-export-hooks` — migrates the deprecated `toCSV` and `fromCSV` field options in `custom['plugin-import-export']` to `hooks.beforeExport` and `hooks.beforeImport`. If a `hooks` object already exists it is merged into; if `hooks.beforeExport`/`hooks.beforeImport` already exist the deprecated sibling is dropped without overwriting. Review argument shapes after migration: `beforeExport` uses `siblingData` (not `row`) and `data` is the top-level document (previously `doc`).
40
- - `migrate-db-types-subpath` — rewrites imports from the removed `/types` subpath exports of `@payloadcms/drizzle`, `@payloadcms/db-postgres`, `@payloadcms/db-sqlite`, `@payloadcms/db-vercel-postgres`, and `@payloadcms/db-d1-sqlite` to their main entry points. Also handles re-export declarations and `declare module` augmentations.
41
- - `migrate-next-subpath-exports` — rewrites imports, re-exports, and string-literal component paths from the removed `@payloadcms/next/client`, `@payloadcms/next/rsc`, and `@payloadcms/next/templates` subpaths to their canonical `@payloadcms/ui` or `@payloadcms/ui/rsc` sources. After running, regenerate the import map with `payload generate:importmap`.
42
- - `migrate-next-generate-viewport-export` — adds a `generateViewport` export to app router layout files that already use Payload's shared Next.js layout, preserving Next.js viewport behavior without touching custom viewport implementations.
43
- - `migrate-lexical-is-html-element` — rewrites imports of the removed `isHTMLElement` utility from `@payloadcms/richtext-lexical` (and `/client`) to its canonical source, `lexical`, splitting it out of mixed imports and merging into an existing `lexical` import when present. Surfaces a note reminding you that `lexical` is now a required dependency (`pnpm add lexical`).
44
- - `migrate-after-operation-read` — rewrites `operation === 'read'` checks inside collection `afterOperation` hooks to handle the `find` and `findByID` operations (the deprecated `'read'` value was removed). Handles `===`/`!==`/`==`/`!=` against a destructured (or aliased) or property-accessed `operation` argument. Leaves `beforeOperation` (which still uses `'read'`) untouched, and surfaces notes for non-inline hooks and `switch` statements that need manual review.
45
- - `migrate-versions-default` — adds `versions: false` to every `CollectionConfig` or `GlobalConfig` object that does not already have a `versions` property. Preserves the previous opt-in behaviour now that `versions` defaults to `true` for both collections and globals. Detects the three common annotation forms: `: CollectionConfig`, `satisfies GlobalConfig`, and `as CollectionConfig`.
46
- - `remove-versions-true` — removes the now-redundant `versions: true` property from `CollectionConfig` and `GlobalConfig` objects. Only removes the bare boolean `true`; object-form configs (e.g. `versions: { drafts: true }`) are left untouched.
47
- - `remove-group-by-true` — removes `admin.groupBy` from `CollectionConfig` objects. The experimental `groupBy` flag has been removed; groupBy is now an always-available per-user UI preference.
48
- - `rename-typescript-schema-to-json-schema` — renames the `typescriptSchema` field-config property to `jsonSchema` (it always accepted JSON Schema, not TypeScript). Skips any object that already defines a `jsonSchema` sibling and surfaces it as a note for manual review.
49
- - `migrate-build-script` — rewrites the `build` npm script in `package.json` from `next build` to `payload build`, so the Import Map (and types) are generated before the Next.js build. Matches the `next build` invocation only (leaves `next build-storybook` and the like untouched) and is a no-op when `build` is already `payload build`.
50
- - `migrate-slug-field` — converts the removed experimental `slugField()` helper (imported from `payload`) into the native `{ type: 'slug' }` field, mapping `useAsSlug`/`fieldToUse`, `slugify`, `required`, `localized`, `disableUnique` (→ `unique: false`), and `position` (→ `admin.position`), and dropping the obsolete `checkboxName`. Removes the now-unused `slugField` import. Calls using `overrides` (or other unrecognized options) are left in place with a note for manual migration.
85
+ - `migrate-list-view-select-api`: Removes `admin.enableListViewSelectAPI` from Collection Configs. The List View's Select API is the default in v4.
86
+ - `migrate-disabled-fields`: migrates `field.admin.disableListColumn`, `disableListFilter`, `disableGroupBy`, `disableBulkEdit` and their equivalents on `imageSize.admin` into the consolidated `disabled` object form.
87
+ - `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.
88
+ - `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.
89
+ - `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.
90
+ - `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.
91
+ - `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.
92
+ - `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.
93
+ - `migrate-hide-api-url`: migrates `admin.hideAPIURL: true` to `admin.components.views.edit.api.tab.condition: () => false` on collection and global configs.
94
+ - `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`.
95
+ - `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.
96
+ - `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.
97
+ - `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`.
98
+ - `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.
99
+ - `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.
100
+ - `rename-storage-adapters-to-storage`: renames the top-level `storageAdapters` config property to `storage`. Skips any object that already has a `storage` property. Run this if you previously ran `migrate-storage-adapters-to-config` and need to update the property name.
101
+ - `migrate-azure-chunk-large-files`: removes the `chunkLargeFiles` option from `azureStorage` `clientUploads` config. Chunked client uploads are the default in v4, so the flag no longer exists; `clientUploads: { chunkLargeFiles: true }` collapses to `clientUploads: true`. Surfaces a note when `chunkLargeFiles: false` was removed, since v4 can no longer disable chunking (and its broader CORS requirements apply).
102
+ - `remove-storage-always-insert-fields`: removes the obsolete `alwaysInsertFields` option from inline `cloudStoragePlugin`, `azureStorage`, `gcsStorage`, `r2Storage`, `s3Storage`, and `vercelBlobStorage` configs. The `prefix` field is now always inserted. Aliased named imports are supported; indirect or spread options must be updated manually.
103
+ - `migrate-import-export-hooks`: migrates the deprecated `toCSV` and `fromCSV` field options in `custom['plugin-import-export']` to `hooks.beforeExport` and `hooks.beforeImport`. If a `hooks` object already exists it is merged into; if `hooks.beforeExport`/`hooks.beforeImport` already exist the deprecated sibling is dropped without overwriting. Review argument shapes after migration: `beforeExport` uses `siblingData` (not `row`) and `data` is the top-level document (previously `doc`).
104
+ - `migrate-db-types-subpath`: rewrites imports from the removed `/types` subpath exports of `@payloadcms/drizzle`, `@payloadcms/db-postgres`, `@payloadcms/db-sqlite`, `@payloadcms/db-vercel-postgres`, and `@payloadcms/db-d1-sqlite` to their main entry points. Also handles re-export declarations and `declare module` augmentations.
105
+ - `migrate-next-subpath-exports`: rewrites imports, re-exports, and string-literal component paths from the removed `@payloadcms/next/client`, `@payloadcms/next/rsc`, and `@payloadcms/next/templates` subpaths to their canonical `@payloadcms/ui` or `@payloadcms/ui/rsc` sources. After running, regenerate the import map with `payload generate:importmap`.
106
+ - `migrate-next-generate-viewport-export`: adds a `generateViewport` export to app router layout files that already use Payload's shared Next.js layout, preserving Next.js viewport behavior without touching custom viewport implementations.
107
+ - `migrate-lexical-is-html-element`: rewrites imports of the removed `isHTMLElement` utility from `@payloadcms/richtext-lexical` (and `/client`) to its canonical source, `lexical`, splitting it out of mixed imports and merging into an existing `lexical` import when present. Surfaces a note reminding you that `lexical` is now a required dependency (`pnpm add lexical`).
108
+ - `migrate-after-operation-read`: rewrites `operation === 'read'` checks inside collection `afterOperation` hooks to handle the `find` and `findByID` operations (the deprecated `'read'` value was removed). Handles `===`/`!==`/`==`/`!=` against a destructured (or aliased) or property-accessed `operation` argument. Leaves `beforeOperation` (which still uses `'read'`) untouched, and surfaces notes for non-inline hooks and `switch` statements that need manual review.
109
+ - `migrate-versions-default`: adds `versions: false` to every `CollectionConfig` or `GlobalConfig` object that does not already have a `versions` property. Preserves the previous opt-in behaviour now that `versions` defaults to `true` for both collections and globals. Detects the three common annotation forms: `: CollectionConfig`, `satisfies GlobalConfig`, and `as CollectionConfig`.
110
+ - `migrate-authorship-default`: adds `authorship: false` to every `CollectionConfig` or `GlobalConfig` object that does not already have an `authorship` property. Preserves the previous behaviour now that authorship tracking (`createdBy` / `updatedBy`) is enabled by default for both collections and globals. Detects the three common annotation forms: `: CollectionConfig`, `satisfies GlobalConfig`, and `as CollectionConfig`.
111
+ - `remove-versions-true`: removes the now-redundant `versions: true` property from `CollectionConfig` and `GlobalConfig` objects. Only removes the bare boolean `true`; object-form configs (e.g. `versions: { drafts: true }`) are left untouched.
112
+ - `add-override-access-true`: adds an explicit `overrideAccess: true` to Local API calls (`payload.find(...)`, `req.payload.create(...)`, `payload.jobs.run()`, and the rest) that omit it, preserving the Payload 3 default of skipping access control now that Payload 4 changes the default to `false`. Detection is syntactic so it works on JavaScript projects with no `tsconfig.json`. Deliberately never touches internal operations such as `findOperation(...)`, where a missing value meant `false` and inserting `true` would disable access control. Skips `resetPassword` (no destructuring default to preserve), calls whose argument object contains a spread, and non-Payload receivers. Review each inserted `true` and switch to `false` wherever the operation acts on behalf of a user.
113
+ - `remove-group-by-true`: removes `admin.groupBy` from `CollectionConfig` objects. The experimental `groupBy` flag has been removed; groupBy is now an always-available per-user UI preference.
114
+ - `remove-default-locale-publish-option`: removes `localization.defaultLocalePublishOption` from Payload configs. The Admin UI Publish button now always defaults to publishing the active locale when localized fields exist, with "Publish all locales" available as a secondary dropdown option. Surfaces a note when the removed value was `'all'`, since that combination previously changed the default and now has no config equivalent.
115
+ - `remove-localize-status-config`: removes `localizeStatus: true` from `versions.drafts` objects and `experimental.localizeStatus: true` from the root Payload config. Per-locale status is now automatic when localization is configured and localized fields exist; an explicit `localizeStatus: false` opt-out is preserved.
116
+ - `remove-publish-specific-locale`: removes `publishSpecificLocale` from `payload.update()` and `payload.updateGlobal()` call-site options. If the options object lacks a `locale` the property is renamed to `locale` so the same value is preserved; otherwise it is dropped.
117
+ - `rename-typescript-schema-to-json-schema`: renames the `typescriptSchema` field-config property to `jsonSchema` (it always accepted JSON Schema, not TypeScript). Skips any object that already defines a `jsonSchema` sibling and surfaces it as a note for manual review.
118
+ - `migrate-build-script`: rewrites the `build` npm script in `package.json` from `next build` to `payload build`, so the Import Map (and types) are generated before the Next.js build. Matches the `next build` invocation only (leaves `next build-storybook` and the like untouched) and is a no-op when `build` is already `payload build`.
119
+ - `migrate-slug-field`: converts the removed experimental `slugField()` helper (imported from `payload`) into the native `{ type: 'slug' }` field, mapping `useAsSlug`/`fieldToUse`, `slugify`, `required`, `localized`, `disableUnique` (→ `unique: false`), and `position` (→ `admin.position`), and dropping the obsolete `checkboxName`. Removes the now-unused `slugField` import. Calls using `overrides` (or other unrecognized options) are left in place with a note for manual migration.
120
+ - `rename-experimental-table-feature`: renames imports of `EXPERIMENTAL_TableFeature` from `@payloadcms/richtext-lexical` to `TableFeature` (the table feature is now stable) and updates all local usages, e.g. `EXPERIMENTAL_TableFeature()` call sites.
51
121
 
52
122
  ## Contributing
53
123
 
package/dist/cli.d.ts.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAaA,wBAAsB,IAAI,CAAC,IAAI,GAAE,MAAM,EAA0B,GAAG,OAAO,CAAC,IAAI,CAAC,CA6DhF"}
1
+ {"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"}
@@ -0,0 +1,4 @@
1
+ export declare function renderHelp({ command }: {
2
+ command: string;
3
+ }): string;
4
+ //# sourceMappingURL=cli.help.d.ts.map
@@ -0,0 +1 @@
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"}
@@ -0,0 +1,29 @@
1
+ export function renderHelp({ command }) {
2
+ return `Usage:
3
+ ${command} [path] [options]
4
+ ${command} upgrade [run | prompt] [options]
5
+
6
+ Commands:
7
+ (none) Run transforms only against [path] (default: cwd)
8
+ upgrade Pick how to run the full v3 -> v4 upgrade
9
+ upgrade run Bump Payload deps, install, then run transforms in cwd
10
+ upgrade prompt Print the upgrade orchestration prompt
11
+
12
+ Transform options:
13
+ --transform <name> Run a single transform by name
14
+ --list Print registered transforms
15
+ --dry, --dry-run Analyze only; write nothing
16
+ --print Print transformed sources to stdout instead of writing
17
+
18
+ Upgrade options:
19
+ --agent <name> Coding agent to hand off to (claude, codex); skips the picker
20
+ --tag <dist-tag> Dist-tag to resolve Payload versions from
21
+ --dry, --dry-run Preview changes; write and install nothing
22
+ --force Skip the dirty-git-tree warning
23
+
24
+ General options:
25
+ -h, --help Show this help
26
+ `;
27
+ }
28
+
29
+ //# sourceMappingURL=cli.help.js.map
@@ -0,0 +1 @@
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 CHANGED
@@ -1,12 +1,59 @@
1
- /* eslint-disable no-console */ import { existsSync, writeFileSync } from 'node:fs';
1
+ /* eslint-disable no-console */ import { writeFileSync } from 'node:fs';
2
2
  import { resolve } from 'node:path';
3
- import { IndentationText, Project, QuoteKind } from 'ts-morph';
3
+ import { renderHelp } from './cli.help.js';
4
4
  import { parseFlags } from './cli.parseFlags.js';
5
5
  import { transforms as registry } from './registry.js';
6
6
  import { runTransforms } from './runner.js';
7
+ import { runDispatch } from './upgrade/dispatch.js';
8
+ import { runUpgrade } from './upgrade/index.js';
9
+ import { renderUpgradePrompt } from './upgrade/prompt.js';
10
+ import { resolveSelfCommand } from './upgrade/selfCommand.js';
7
11
  import { loadPackageJsons, serializePackageJson } from './utils/packageJson.js';
12
+ import { loadProject } from './utils/project.js';
8
13
  export async function main(argv = process.argv.slice(2)) {
9
14
  const flags = parseFlags(argv);
15
+ // Checked first so `--help` on any command prints usage instead of running it.
16
+ if (flags.help) {
17
+ console.log(renderHelp({
18
+ command: resolveSelfCommand()
19
+ }));
20
+ return;
21
+ }
22
+ if (flags.command === 'upgrade') {
23
+ if (flags.upgrade === 'prompt') {
24
+ console.log(renderUpgradePrompt({
25
+ command: resolveSelfCommand()
26
+ }));
27
+ return;
28
+ }
29
+ if (flags.upgrade === 'run') {
30
+ const { failed } = await runUpgrade({
31
+ flags: {
32
+ dry: flags.dry,
33
+ force: flags.force,
34
+ tag: flags.tag
35
+ },
36
+ path: flags.path
37
+ });
38
+ if (failed) {
39
+ process.exitCode = 1;
40
+ }
41
+ return;
42
+ }
43
+ const { failed } = await runDispatch({
44
+ agentFlag: flags.agent,
45
+ path: flags.path,
46
+ upgradeFlags: {
47
+ dry: flags.dry,
48
+ force: flags.force,
49
+ tag: flags.tag
50
+ }
51
+ });
52
+ if (failed) {
53
+ process.exitCode = 1;
54
+ }
55
+ return;
56
+ }
10
57
  if (flags.list) {
11
58
  printList();
12
59
  return;
@@ -71,31 +118,6 @@ function printList() {
71
118
  console.log(`${t.name} ${t.description}`);
72
119
  }
73
120
  }
74
- function loadProject(path) {
75
- const manipulationSettings = {
76
- indentationText: IndentationText.TwoSpaces,
77
- quoteKind: QuoteKind.Single,
78
- useTrailingCommas: true
79
- };
80
- const tsconfigPath = resolve(path, 'tsconfig.json');
81
- if (existsSync(tsconfigPath)) {
82
- return new Project({
83
- manipulationSettings,
84
- tsConfigFilePath: tsconfigPath
85
- });
86
- }
87
- const project = new Project({
88
- manipulationSettings
89
- });
90
- project.addSourceFilesAtPaths([
91
- `${path}/**/*.{ts,tsx,js,jsx}`,
92
- '!**/node_modules/**',
93
- '!**/dist/**',
94
- '!**/.next/**',
95
- '!**/build/**'
96
- ]);
97
- return project;
98
- }
99
121
  function snapshotProject(project) {
100
122
  return new Map(project.getSourceFiles().map((file)=>[
101
123
  file.getFilePath(),
package/dist/cli.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"sources":["../src/cli.ts"],"sourcesContent":["/* eslint-disable no-console */\nimport { existsSync, writeFileSync } from 'node:fs'\nimport { resolve } from 'node:path'\nimport { IndentationText, Project, QuoteKind } from 'ts-morph'\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 { loadPackageJsons, serializePackageJson } from './utils/packageJson.js'\n\nexport async function main(argv: string[] = process.argv.slice(2)): Promise<void> {\n const flags = parseFlags(argv)\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 loadProject(path: string): Project {\n const manipulationSettings = {\n indentationText: IndentationText.TwoSpaces,\n quoteKind: QuoteKind.Single,\n useTrailingCommas: true,\n }\n const tsconfigPath = resolve(path, 'tsconfig.json')\n if (existsSync(tsconfigPath)) {\n return new Project({ manipulationSettings, tsConfigFilePath: tsconfigPath })\n }\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\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":["existsSync","writeFileSync","resolve","IndentationText","Project","QuoteKind","parseFlags","transforms","registry","runTransforms","loadPackageJsons","serializePackageJson","main","argv","process","slice","flags","list","printList","selected","selectTransforms","transform","length","console","error","exitCode","project","loadProject","path","snapshot","snapshotProject","packageJsons","failed","results","map","data","changed","getSourceFiles","filter","file","get","getFilePath","getFullText","changedPackageJsons","pkg","originalText","print","log","dry","Promise","all","save","printSummary","available","name","t","description","manipulationSettings","indentationText","TwoSpaces","quoteKind","Single","useTrailingCommas","tsconfigPath","tsConfigFilePath","addSourceFilesAtPaths","Map","r","message","filesChanged","note","notes"],"mappings":"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"}
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 { 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":"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"}
@@ -1,9 +1,24 @@
1
+ export type CliCommand = 'upgrade';
2
+ /**
3
+ * The three `upgrade` verbs:
4
+ * - `dispatch` (bare `upgrade`): interactive picker to hand the orchestration
5
+ * prompt to a coding agent, or print it.
6
+ * - `run` (`upgrade run`): the deterministic mechanical slice.
7
+ * - `prompt` (`upgrade prompt`): print the orchestration prompt to stdout.
8
+ */
9
+ export type UpgradeSubcommand = 'dispatch' | 'prompt' | 'run';
1
10
  export type CliFlags = {
11
+ agent?: string;
12
+ command?: CliCommand;
2
13
  dry: boolean;
14
+ force: boolean;
15
+ help: boolean;
3
16
  list: boolean;
4
17
  path: string;
5
18
  print: boolean;
19
+ tag?: string;
6
20
  transform?: string;
21
+ upgrade?: UpgradeSubcommand;
7
22
  };
8
23
  export declare function parseFlags(argv: string[]): CliFlags;
9
24
  //# sourceMappingURL=cli.parseFlags.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"cli.parseFlags.d.ts","sourceRoot":"","sources":["../src/cli.parseFlags.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,QAAQ,GAAG;IACrB,GAAG,EAAE,OAAO,CAAA;IACZ,IAAI,EAAE,OAAO,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,OAAO,CAAA;IACd,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB,CAAA;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,QAAQ,CAoBnD"}
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,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"}
@@ -4,6 +4,9 @@ export function parseFlags(argv) {
4
4
  allowPositionals: true,
5
5
  args: argv,
6
6
  options: {
7
+ agent: {
8
+ type: 'string'
9
+ },
7
10
  dry: {
8
11
  type: 'boolean',
9
12
  default: false
@@ -12,6 +15,15 @@ export function parseFlags(argv) {
12
15
  type: 'boolean',
13
16
  default: false
14
17
  },
18
+ force: {
19
+ type: 'boolean',
20
+ default: false
21
+ },
22
+ help: {
23
+ type: 'boolean',
24
+ default: false,
25
+ short: 'h'
26
+ },
15
27
  list: {
16
28
  type: 'boolean',
17
29
  default: false
@@ -20,18 +32,39 @@ export function parseFlags(argv) {
20
32
  type: 'boolean',
21
33
  default: false
22
34
  },
35
+ tag: {
36
+ type: 'string'
37
+ },
23
38
  transform: {
24
39
  type: 'string'
25
40
  }
26
41
  }
27
42
  });
43
+ const isUpgrade = positionals[0] === 'upgrade';
44
+ const command = isUpgrade ? 'upgrade' : undefined;
45
+ const upgrade = isUpgrade ? resolveUpgradeVerb(positionals[1]) : undefined;
46
+ // The upgrade command always operates on the current directory; only the bare
47
+ // transform command takes a positional path.
48
+ const path = isUpgrade ? process.cwd() : positionals[0] ?? process.cwd();
28
49
  return {
50
+ agent: values.agent,
51
+ command,
29
52
  dry: Boolean(values.dry) || Boolean(values['dry-run']),
53
+ force: Boolean(values.force),
54
+ help: Boolean(values.help),
30
55
  list: Boolean(values.list),
31
- path: positionals[0] ?? process.cwd(),
56
+ path,
32
57
  print: Boolean(values.print),
33
- transform: values.transform
58
+ tag: values.tag,
59
+ transform: values.transform,
60
+ upgrade
34
61
  };
35
62
  }
63
+ function resolveUpgradeVerb(verb) {
64
+ if (verb === 'prompt' || verb === 'run') {
65
+ return verb;
66
+ }
67
+ return 'dispatch';
68
+ }
36
69
 
37
70
  //# sourceMappingURL=cli.parseFlags.js.map
@@ -1 +1 @@
1
- {"version":3,"sources":["../src/cli.parseFlags.ts"],"sourcesContent":["import { parseArgs } from 'node:util'\n\nexport type CliFlags = {\n dry: boolean\n list: boolean\n path: string\n print: boolean\n transform?: string\n}\n\nexport function parseFlags(argv: string[]): CliFlags {\n const { positionals, values } = parseArgs({\n allowPositionals: true,\n args: argv,\n options: {\n dry: { type: 'boolean', default: false },\n 'dry-run': { type: 'boolean', default: false },\n list: { type: 'boolean', default: false },\n print: { type: 'boolean', default: false },\n transform: { type: 'string' },\n },\n })\n\n return {\n dry: Boolean(values.dry) || Boolean(values['dry-run']),\n list: Boolean(values.list),\n path: positionals[0] ?? process.cwd(),\n print: Boolean(values.print),\n transform: values.transform,\n }\n}\n"],"names":["parseArgs","parseFlags","argv","positionals","values","allowPositionals","args","options","dry","type","default","list","print","transform","Boolean","path","process","cwd"],"mappings":"AAAA,SAASA,SAAS,QAAQ,YAAW;AAUrC,OAAO,SAASC,WAAWC,IAAc;IACvC,MAAM,EAAEC,WAAW,EAAEC,MAAM,EAAE,GAAGJ,UAAU;QACxCK,kBAAkB;QAClBC,MAAMJ;QACNK,SAAS;YACPC,KAAK;gBAAEC,MAAM;gBAAWC,SAAS;YAAM;YACvC,WAAW;gBAAED,MAAM;gBAAWC,SAAS;YAAM;YAC7CC,MAAM;gBAAEF,MAAM;gBAAWC,SAAS;YAAM;YACxCE,OAAO;gBAAEH,MAAM;gBAAWC,SAAS;YAAM;YACzCG,WAAW;gBAAEJ,MAAM;YAAS;QAC9B;IACF;IAEA,OAAO;QACLD,KAAKM,QAAQV,OAAOI,GAAG,KAAKM,QAAQV,MAAM,CAAC,UAAU;QACrDO,MAAMG,QAAQV,OAAOO,IAAI;QACzBI,MAAMZ,WAAW,CAAC,EAAE,IAAIa,QAAQC,GAAG;QACnCL,OAAOE,QAAQV,OAAOQ,KAAK;QAC3BC,WAAWT,OAAOS,SAAS;IAC7B;AACF"}
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 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"}
@@ -1 +1 @@
1
- {"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AA4B3C,eAAO,MAAM,UAAU,EAAE,SAAS,EA0BjC,CAAA"}
1
+ {"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 CHANGED
@@ -1,40 +1,58 @@
1
+ import { addOverrideAccessTrue } from './transforms/add-override-access-true/index.js';
1
2
  import { exampleNoop } from './transforms/example-noop/index.js';
2
3
  import { globalsComponentsEdit } from './transforms/globals-components-edit/index.js';
4
+ import { migrateAdminContextProperties } from './transforms/migrate-admin-context-properties/index.js';
3
5
  import { migrateAfterOperationRead } from './transforms/migrate-after-operation-read/index.js';
4
6
  import { migrateAliasedExports } from './transforms/migrate-aliased-exports/index.js';
7
+ import { migrateAuthorshipDefault } from './transforms/migrate-authorship-default/index.js';
5
8
  import { migrateAzureChunkLargeFiles } from './transforms/migrate-azure-chunk-large-files/index.js';
6
9
  import { migrateBlockReferencesToBlocks } from './transforms/migrate-block-references-to-blocks/index.js';
7
10
  import { migrateBuildScript } from './transforms/migrate-build-script/index.js';
8
11
  import { migrateDbTypesSubpath } from './transforms/migrate-db-types-subpath/index.js';
9
12
  import { migrateDisabledFields } from './transforms/migrate-disabled-fields/index.js';
13
+ import { migrateDisplayedFieldValueArgs } from './transforms/migrate-displayed-field-value-args/index.js';
10
14
  import { migrateDocumentTitleContext } from './transforms/migrate-document-title-context/index.js';
15
+ import { migrateFieldComponentTypes } from './transforms/migrate-field-component-types/index.js';
11
16
  import { migrateForceSelect } from './transforms/migrate-force-select/index.js';
12
17
  import { migrateHideAPIURL } from './transforms/migrate-hide-api-url/index.js';
13
18
  import { migrateImportExportHooks } from './transforms/migrate-import-export-hooks/index.js';
14
19
  import { migrateListViewSelectAPI } from './transforms/migrate-list-view-select-api/index.js';
15
20
  import { migrateNextGenerateViewportExport } from './transforms/migrate-next-generate-viewport-export/index.js';
16
21
  import { migrateNextSubpathExports } from './transforms/migrate-next-subpath-exports/index.js';
22
+ import { migratePayloadRequestCreation } from './transforms/migrate-payload-request-creation/index.js';
23
+ import { migrateSharpToTransformer } from './transforms/migrate-sharp-to-transformer/index.js';
17
24
  import { migrateSlugField } from './transforms/migrate-slug-field/index.js';
18
25
  import { migrateStorageAdaptersToConfig } from './transforms/migrate-storage-adapters-to-config/index.js';
19
26
  import { migrateVersionsDefault } from './transforms/migrate-versions-default/index.js';
27
+ import { removeDefaultLocalePublishOption } from './transforms/remove-default-locale-publish-option/index.js';
20
28
  import { removeGroupByTrue } from './transforms/remove-group-by-true/index.js';
21
29
  import { removeLocalizeStatusConfig } from './transforms/remove-localize-status-config/index.js';
22
30
  import { removePublishSpecificLocale } from './transforms/remove-publish-specific-locale/index.js';
31
+ import { removeStorageAlwaysInsertFields } from './transforms/remove-storage-always-insert-fields/index.js';
23
32
  import { removeVersionsTrue } from './transforms/remove-versions-true/index.js';
33
+ import { renameDiffValueProps } from './transforms/rename-diff-value-props/index.js';
34
+ import { renameExperimentalTableFeature } from './transforms/rename-experimental-table-feature/index.js';
24
35
  import { renameStorageAdaptersToStorage } from './transforms/rename-storage-adapters-to-storage/index.js';
25
36
  import { renameTypescriptSchemaToJsonSchema } from './transforms/rename-typescript-schema-to-json-schema/index.js';
26
37
  export const transforms = [
27
38
  exampleNoop,
39
+ addOverrideAccessTrue,
28
40
  migrateAfterOperationRead,
29
41
  migrateHideAPIURL,
30
42
  globalsComponentsEdit,
31
43
  migrateListViewSelectAPI,
32
44
  migrateDisabledFields,
45
+ migrateDisplayedFieldValueArgs,
33
46
  migrateForceSelect,
47
+ migrateFieldComponentTypes,
48
+ renameDiffValueProps,
34
49
  migrateAliasedExports,
50
+ migratePayloadRequestCreation,
51
+ migrateAdminContextProperties,
35
52
  migrateBlockReferencesToBlocks,
36
53
  migrateBuildScript,
37
54
  migrateDocumentTitleContext,
55
+ migrateSharpToTransformer,
38
56
  migrateStorageAdaptersToConfig,
39
57
  migrateAzureChunkLargeFiles,
40
58
  renameStorageAdaptersToStorage,
@@ -44,11 +62,15 @@ export const transforms = [
44
62
  migrateNextSubpathExports,
45
63
  migrateSlugField,
46
64
  migrateVersionsDefault,
65
+ migrateAuthorshipDefault,
66
+ removeDefaultLocalePublishOption,
47
67
  removeGroupByTrue,
48
68
  removeLocalizeStatusConfig,
49
69
  removeVersionsTrue,
50
70
  removePublishSpecificLocale,
51
- renameTypescriptSchemaToJsonSchema
71
+ removeStorageAlwaysInsertFields,
72
+ renameTypescriptSchemaToJsonSchema,
73
+ renameExperimentalTableFeature
52
74
  ];
53
75
 
54
76
  //# sourceMappingURL=registry.js.map