@payloadcms/codemod 4.0.0-internal.3ed7230 → 4.0.0-internal.44ac9c8

package/dist/transforms/migrate-sharp-to-transformer/index.js

@@ -0,0 +1,280 @@
+import { Node, SyntaxKind } from 'ts-morph';
+const TRANSFORMER_MODULE = '@payloadcms/transformer-sharp';
+const TRANSFORMER_NAME = 'sharpTransformer';
+const IDENTIFIER_PATTERN = /^[A-Z_$][\w$]*$/i;
+const RESERVED_WORDS = new Set([
+    'await',
+    'break',
+    'case',
+    'catch',
+    'class',
+    'const',
+    'continue',
+    'debugger',
+    'default',
+    'delete',
+    'do',
+    'else',
+    'enum',
+    'export',
+    'extends',
+    'false',
+    'finally',
+    'for',
+    'function',
+    'if',
+    'implements',
+    'import',
+    'in',
+    'instanceof',
+    'interface',
+    'let',
+    'new',
+    'null',
+    'package',
+    'private',
+    'protected',
+    'public',
+    'return',
+    'static',
+    'super',
+    'switch',
+    'this',
+    'throw',
+    'true',
+    'try',
+    'typeof',
+    'var',
+    'void',
+    'while',
+    'with',
+    'yield'
+]);
+/** Whether `value` can be used as a plain (unquoted, non-bracketed) object literal key. */ function isSafePlainObjectKey(value) {
+    return IDENTIFIER_PATTERN.test(value) && !RESERVED_WORDS.has(value);
+}
+/** Fields moved from a collection's `upload` object into `sharpTransformer({ collections })`. */ const MOVED_UPLOAD_FIELDS = [
+    'constructorOptions',
+    'formatOptions',
+    'resizeOptions',
+    'trimOptions',
+    'withMetadata',
+    'imageSizes',
+    'crop',
+    'focalPoint'
+];
+const findBuildConfigLocalNames = (file)=>{
+    const localNames = new Set();
+    for (const importDecl of file.getImportDeclarations()){
+        if (importDecl.getModuleSpecifierValue() !== 'payload') {
+            continue;
+        }
+        for (const spec of importDecl.getNamedImports()){
+            if (spec.getName() === 'buildConfig') {
+                localNames.add(spec.getAliasNode()?.getText() ?? spec.getName());
+            }
+        }
+    }
+    return localNames;
+};
+function ensureSharpTransformerImport(sourceFile) {
+    const existing = sourceFile.getImportDeclarations().find((decl)=>decl.getModuleSpecifierValue() === TRANSFORMER_MODULE);
+    if (!existing) {
+        const otherImports = sourceFile.getImportDeclarations();
+        const fileOmitsSemicolonsOnImports = otherImports.length > 0 && otherImports.every((decl)=>!decl.getText().endsWith(';'));
+        const insertedImport = sourceFile.addImportDeclaration({
+            moduleSpecifier: TRANSFORMER_MODULE,
+            namedImports: [
+                TRANSFORMER_NAME
+            ]
+        });
+        // ts-morph always appends a semicolon; strip it when the file's other imports don't use them.
+        if (fileOmitsSemicolonsOnImports) {
+            const insertedImportText = insertedImport.getText();
+            if (insertedImportText.endsWith(';')) {
+                insertedImport.replaceWithText(insertedImportText.slice(0, -1));
+            }
+        }
+        return;
+    }
+    const alreadyImported = existing.getNamedImports().some((named)=>named.getName() === TRANSFORMER_NAME);
+    if (!alreadyImported) {
+        existing.addNamedImport(TRANSFORMER_NAME);
+    }
+}
+/**
+ * Extracts Sharp-owned fields off one collection's `upload` object literal into
+ * a `<slug>: { ... }` entry text for the `sharpTransformer({ collections })` map.
+ * Returns `undefined` when the collection has nothing to migrate.
+ */ function extractCollectionSharpEntry({ collectionObj, filePath, notes }) {
+    const slugProp = collectionObj.getProperty('slug');
+    const slugAssignment = slugProp?.asKind(SyntaxKind.PropertyAssignment);
+    const slugInitializer = slugAssignment?.getInitializer();
+    if (!slugInitializer) {
+        return undefined;
+    }
+    const uploadProp = collectionObj.getProperty('upload');
+    if (!uploadProp || !Node.isPropertyAssignment(uploadProp)) {
+        return undefined;
+    }
+    const uploadObj = uploadProp.getInitializerIfKind(SyntaxKind.ObjectLiteralExpression);
+    if (!uploadObj) {
+        if (uploadProp.getInitializer()?.getKind() !== SyntaxKind.TrueKeyword) {
+            notes.push(`${filePath}: collection ${slugInitializer.getText()}'s \`upload\` option is not an inline object — check it for Sharp-specific fields (resizeOptions/imageSizes/formatOptions/trimOptions/constructorOptions/withMetadata/crop/focalPoint) manually.`);
+        }
+        return undefined;
+    }
+    const uploadHasSpread = uploadObj.getProperties().some((prop)=>Node.isSpreadAssignment(prop));
+    if (uploadHasSpread) {
+        notes.push(`${filePath}: collection ${slugInitializer.getText()}'s \`upload\` object contains a spread — Sharp-specific fields (resizeOptions/imageSizes/formatOptions/trimOptions/constructorOptions/withMetadata/crop/focalPoint) hidden inside it need manual review.`);
+    }
+    const movedTexts = [];
+    for (const name of MOVED_UPLOAD_FIELDS){
+        const prop = uploadObj.getProperty(name);
+        if (prop && Node.isPropertyAssignment(prop)) {
+            movedTexts.push(prop.print());
+            prop.remove();
+        }
+    }
+    if (movedTexts.length === 0) {
+        return undefined;
+    }
+    // Avoid leaving `upload: {\n}` spread across two lines once every property moves out.
+    if (uploadObj.getProperties().length === 0) {
+        uploadObj.replaceWithText('{}');
+    }
+    const slugLiteralValue = Node.isStringLiteral(slugInitializer) ? slugInitializer.getLiteralValue() : undefined;
+    const keyText = slugLiteralValue !== undefined && isSafePlainObjectKey(slugLiteralValue) ? slugLiteralValue : `[${slugInitializer.getText()}]`;
+    return `${keyText}: { ${movedTexts.join(', ')} }`;
+}
+/**
+ * Builds every `<slug>: { ... }` entry for a `buildConfig({ collections })` array,
+ * skipping (and, for a present `sharp` signal, noting) entries that aren't inline
+ * object literals or whose `collections` array isn't statically analyzable.
+ */ function extractSharpCollectionEntries({ configObj, filePath, notes }) {
+    const collectionsProp = configObj.getProperty('collections');
+    if (!collectionsProp || !Node.isPropertyAssignment(collectionsProp)) {
+        return [];
+    }
+    const arrayLiteral = collectionsProp.getInitializerIfKind(SyntaxKind.ArrayLiteralExpression);
+    if (!arrayLiteral) {
+        notes.push(`${filePath}: \`collections\` isn't an inline array — check each collection for Sharp-specific \`upload\` fields (resizeOptions/imageSizes/formatOptions/trimOptions/constructorOptions/withMetadata/crop/focalPoint) and move them into \`sharpTransformer({ collections })\` manually.`);
+        return [];
+    }
+    const entries = [];
+    for (const el of arrayLiteral.getElements()){
+        if (!Node.isObjectLiteralExpression(el)) {
+            notes.push(`${filePath}: a collection in \`collections\` is defined externally — check it for Sharp-specific \`upload\` fields and move them into \`sharpTransformer({ collections })\` manually.`);
+            continue;
+        }
+        const entry = extractCollectionSharpEntry({
+            collectionObj: el,
+            filePath,
+            notes
+        });
+        if (entry) {
+            entries.push(entry);
+        }
+    }
+    return entries;
+}
+function findSharpTransformerCall(transformersArray) {
+    return transformersArray.getElements().find((el)=>{
+        if (!Node.isCallExpression(el)) {
+            return false;
+        }
+        const callee = el.getExpression();
+        return Node.isIdentifier(callee) && callee.getText() === TRANSFORMER_NAME;
+    });
+}
+export const migrateSharpToTransformer = {
+    name: 'migrate-sharp-to-transformer',
+    apply: ({ project })=>{
+        const filesChanged = new Set();
+        const notes = [];
+        for (const sourceFile of project.getSourceFiles()){
+            const buildConfigLocalNames = findBuildConfigLocalNames(sourceFile);
+            if (buildConfigLocalNames.size === 0) {
+                continue;
+            }
+            const calls = sourceFile.getDescendantsOfKind(SyntaxKind.CallExpression).filter((call)=>{
+                const expr = call.getExpression();
+                return Node.isIdentifier(expr) && buildConfigLocalNames.has(expr.getText());
+            });
+            for (const call of calls){
+                const [arg] = call.getArguments();
+                const configObj = arg?.asKind(SyntaxKind.ObjectLiteralExpression);
+                if (!configObj) {
+                    notes.push(`${sourceFile.getFilePath()}: \`buildConfig\` argument is not an inline object literal — check it manually for a top-level \`sharp\` dependency and per-collection Sharp-specific \`upload\` options.`);
+                    continue;
+                }
+                const uploadProp = configObj.getProperty('upload');
+                const uploadObj = uploadProp?.asKind(SyntaxKind.PropertyAssignment)?.getInitializerIfKind(SyntaxKind.ObjectLiteralExpression);
+                const existingTransformersProp = uploadObj?.getProperty('transformers');
+                const existingTransformersArray = existingTransformersProp?.asKind(SyntaxKind.PropertyAssignment)?.getInitializerIfKind(SyntaxKind.ArrayLiteralExpression);
+                if (existingTransformersArray && findSharpTransformerCall(existingTransformersArray)) {
+                    // Already migrated, but a leftover `sharp` property would fail a later
+                    // type-check with no signal from this codemod — flag it here.
+                    if (configObj.getProperty('sharp')) {
+                        notes.push(`${sourceFile.getFilePath()}: a top-level \`sharp\` property remains even though \`sharpTransformer\` is already registered — move any value you still need into the existing \`sharpTransformer\` call, then remove \`sharp\` manually.`);
+                    }
+                    continue;
+                }
+                const sharpProp = configObj.getProperty('sharp');
+                let sharpExpressionText;
+                if (sharpProp && Node.isPropertyAssignment(sharpProp)) {
+                    sharpExpressionText = sharpProp.getInitializer()?.getText();
+                } else if (sharpProp && Node.isShorthandPropertyAssignment(sharpProp)) {
+                    sharpExpressionText = sharpProp.getName();
+                }
+                // Remove `sharp` before extracting collection entries — later removals
+                // shift node positions, and ts-morph node references taken before a
+                // sibling removal can go stale.
+                sharpProp?.remove();
+                const collectionEntries = extractSharpCollectionEntries({
+                    configObj,
+                    filePath: sourceFile.getFilePath(),
+                    notes
+                });
+                if (!sharpExpressionText && collectionEntries.length === 0) {
+                    continue;
+                }
+                const transformerArgs = [];
+                if (sharpExpressionText) {
+                    transformerArgs.push(sharpExpressionText === 'sharp' ? 'sharp' : `sharp: ${sharpExpressionText}`);
+                }
+                if (collectionEntries.length > 0) {
+                    transformerArgs.push(`collections: { ${collectionEntries.join(', ')} }`);
+                }
+                const transformerCallText = `${TRANSFORMER_NAME}({ ${transformerArgs.join(', ')} })`;
+                if (existingTransformersArray) {
+                    existingTransformersArray.addElement(transformerCallText);
+                } else if (uploadObj) {
+                    uploadObj.addPropertyAssignment({
+                        name: 'transformers',
+                        initializer: `[${transformerCallText}]`
+                    });
+                } else if (uploadProp) {
+                    notes.push(`${sourceFile.getFilePath()}: \`upload\` isn't an inline object — add \`transformers: [${transformerCallText}]\` to it manually.`);
+                } else {
+                    configObj.addPropertyAssignment({
+                        name: 'upload',
+                        initializer: `{ transformers: [${transformerCallText}] }`
+                    });
+                }
+                ensureSharpTransformerImport(sourceFile);
+                filesChanged.add(sourceFile.getFilePath());
+            }
+        }
+        if (filesChanged.size > 0) {
+            notes.push(`Install the new dependency this migration relies on: pnpm add @payloadcms/transformer-sharp`);
+        }
+        return {
+            filesChanged: Array.from(filesChanged),
+            notes: notes.length ? notes : undefined
+        };
+    },
+    description: 'Move 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`.'
+};
+
+//# sourceMappingURL=index.js.map

package/dist/transforms/migrate-sharp-to-transformer/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/transforms/migrate-sharp-to-transformer/index.ts"],"sourcesContent":["import type { ArrayLiteralExpression, ObjectLiteralExpression, SourceFile } from 'ts-morph'\n\nimport { Node, SyntaxKind } from 'ts-morph'\n\nimport type { Transform } from '../../types.js'\n\nconst TRANSFORMER_MODULE = '@payloadcms/transformer-sharp'\nconst TRANSFORMER_NAME = 'sharpTransformer'\n\nconst IDENTIFIER_PATTERN = /^[A-Z_$][\\w$]*$/i\nconst RESERVED_WORDS = new Set([\n  'await',\n  'break',\n  'case',\n  'catch',\n  'class',\n  'const',\n  'continue',\n  'debugger',\n  'default',\n  'delete',\n  'do',\n  'else',\n  'enum',\n  'export',\n  'extends',\n  'false',\n  'finally',\n  'for',\n  'function',\n  'if',\n  'implements',\n  'import',\n  'in',\n  'instanceof',\n  'interface',\n  'let',\n  'new',\n  'null',\n  'package',\n  'private',\n  'protected',\n  'public',\n  'return',\n  'static',\n  'super',\n  'switch',\n  'this',\n  'throw',\n  'true',\n  'try',\n  'typeof',\n  'var',\n  'void',\n  'while',\n  'with',\n  'yield',\n])\n\n/** Whether `value` can be used as a plain (unquoted, non-bracketed) object literal key. */\nfunction isSafePlainObjectKey(value: string): boolean {\n  return IDENTIFIER_PATTERN.test(value) && !RESERVED_WORDS.has(value)\n}\n\n/** Fields moved from a collection's `upload` object into `sharpTransformer({ collections })`. */\nconst MOVED_UPLOAD_FIELDS = [\n  'constructorOptions',\n  'formatOptions',\n  'resizeOptions',\n  'trimOptions',\n  'withMetadata',\n  'imageSizes',\n  'crop',\n  'focalPoint',\n]\n\nconst findBuildConfigLocalNames = (file: SourceFile): Set<string> => {\n  const localNames = new Set<string>()\n\n  for (const importDecl of file.getImportDeclarations()) {\n    if (importDecl.getModuleSpecifierValue() !== 'payload') {\n      continue\n    }\n    for (const spec of importDecl.getNamedImports()) {\n      if (spec.getName() === 'buildConfig') {\n        localNames.add(spec.getAliasNode()?.getText() ?? spec.getName())\n      }\n    }\n  }\n\n  return localNames\n}\n\nfunction ensureSharpTransformerImport(sourceFile: SourceFile): void {\n  const existing = sourceFile\n    .getImportDeclarations()\n    .find((decl) => decl.getModuleSpecifierValue() === TRANSFORMER_MODULE)\n\n  if (!existing) {\n    const otherImports = sourceFile.getImportDeclarations()\n    const fileOmitsSemicolonsOnImports =\n      otherImports.length > 0 && otherImports.every((decl) => !decl.getText().endsWith(';'))\n\n    const insertedImport = sourceFile.addImportDeclaration({\n      moduleSpecifier: TRANSFORMER_MODULE,\n      namedImports: [TRANSFORMER_NAME],\n    })\n\n    // ts-morph always appends a semicolon; strip it when the file's other imports don't use them.\n    if (fileOmitsSemicolonsOnImports) {\n      const insertedImportText = insertedImport.getText()\n      if (insertedImportText.endsWith(';')) {\n        insertedImport.replaceWithText(insertedImportText.slice(0, -1))\n      }\n    }\n\n    return\n  }\n\n  const alreadyImported = existing\n    .getNamedImports()\n    .some((named) => named.getName() === TRANSFORMER_NAME)\n\n  if (!alreadyImported) {\n    existing.addNamedImport(TRANSFORMER_NAME)\n  }\n}\n\n/**\n * Extracts Sharp-owned fields off one collection's `upload` object literal into\n * a `<slug>: { ... }` entry text for the `sharpTransformer({ collections })` map.\n * Returns `undefined` when the collection has nothing to migrate.\n */\nfunction extractCollectionSharpEntry({\n  collectionObj,\n  filePath,\n  notes,\n}: {\n  collectionObj: ObjectLiteralExpression\n  filePath: string\n  notes: string[]\n}): string | undefined {\n  const slugProp = collectionObj.getProperty('slug')\n  const slugAssignment = slugProp?.asKind(SyntaxKind.PropertyAssignment)\n  const slugInitializer = slugAssignment?.getInitializer()\n\n  if (!slugInitializer) {\n    return undefined\n  }\n\n  const uploadProp = collectionObj.getProperty('upload')\n  if (!uploadProp || !Node.isPropertyAssignment(uploadProp)) {\n    return undefined\n  }\n\n  const uploadObj = uploadProp.getInitializerIfKind(SyntaxKind.ObjectLiteralExpression)\n  if (!uploadObj) {\n    if (uploadProp.getInitializer()?.getKind() !== SyntaxKind.TrueKeyword) {\n      notes.push(\n        `${filePath}: collection ${slugInitializer.getText()}'s \\`upload\\` option is not an inline object — check it for Sharp-specific fields (resizeOptions/imageSizes/formatOptions/trimOptions/constructorOptions/withMetadata/crop/focalPoint) manually.`,\n      )\n    }\n    return undefined\n  }\n\n  const uploadHasSpread = uploadObj.getProperties().some((prop) => Node.isSpreadAssignment(prop))\n  if (uploadHasSpread) {\n    notes.push(\n      `${filePath}: collection ${slugInitializer.getText()}'s \\`upload\\` object contains a spread — Sharp-specific fields (resizeOptions/imageSizes/formatOptions/trimOptions/constructorOptions/withMetadata/crop/focalPoint) hidden inside it need manual review.`,\n    )\n  }\n\n  const movedTexts: string[] = []\n  for (const name of MOVED_UPLOAD_FIELDS) {\n    const prop = uploadObj.getProperty(name)\n    if (prop && Node.isPropertyAssignment(prop)) {\n      movedTexts.push(prop.print())\n      prop.remove()\n    }\n  }\n\n  if (movedTexts.length === 0) {\n    return undefined\n  }\n\n  // Avoid leaving `upload: {\\n}` spread across two lines once every property moves out.\n  if (uploadObj.getProperties().length === 0) {\n    uploadObj.replaceWithText('{}')\n  }\n\n  const slugLiteralValue = Node.isStringLiteral(slugInitializer)\n    ? slugInitializer.getLiteralValue()\n    : undefined\n  const keyText =\n    slugLiteralValue !== undefined && isSafePlainObjectKey(slugLiteralValue)\n      ? slugLiteralValue\n      : `[${slugInitializer.getText()}]`\n\n  return `${keyText}: { ${movedTexts.join(', ')} }`\n}\n\n/**\n * Builds every `<slug>: { ... }` entry for a `buildConfig({ collections })` array,\n * skipping (and, for a present `sharp` signal, noting) entries that aren't inline\n * object literals or whose `collections` array isn't statically analyzable.\n */\nfunction extractSharpCollectionEntries({\n  configObj,\n  filePath,\n  notes,\n}: {\n  configObj: ObjectLiteralExpression\n  filePath: string\n  notes: string[]\n}): string[] {\n  const collectionsProp = configObj.getProperty('collections')\n  if (!collectionsProp || !Node.isPropertyAssignment(collectionsProp)) {\n    return []\n  }\n\n  const arrayLiteral = collectionsProp.getInitializerIfKind(SyntaxKind.ArrayLiteralExpression)\n  if (!arrayLiteral) {\n    notes.push(\n      `${filePath}: \\`collections\\` isn't an inline array — check each collection for Sharp-specific \\`upload\\` fields (resizeOptions/imageSizes/formatOptions/trimOptions/constructorOptions/withMetadata/crop/focalPoint) and move them into \\`sharpTransformer({ collections })\\` manually.`,\n    )\n    return []\n  }\n\n  const entries: string[] = []\n\n  for (const el of arrayLiteral.getElements()) {\n    if (!Node.isObjectLiteralExpression(el)) {\n      notes.push(\n        `${filePath}: a collection in \\`collections\\` is defined externally — check it for Sharp-specific \\`upload\\` fields and move them into \\`sharpTransformer({ collections })\\` manually.`,\n      )\n      continue\n    }\n\n    const entry = extractCollectionSharpEntry({ collectionObj: el, filePath, notes })\n    if (entry) {\n      entries.push(entry)\n    }\n  }\n\n  return entries\n}\n\nfunction findSharpTransformerCall(transformersArray: ArrayLiteralExpression) {\n  return transformersArray.getElements().find((el) => {\n    if (!Node.isCallExpression(el)) {\n      return false\n    }\n    const callee = el.getExpression()\n    return Node.isIdentifier(callee) && callee.getText() === TRANSFORMER_NAME\n  })\n}\n\nexport const migrateSharpToTransformer: Transform = {\n  name: 'migrate-sharp-to-transformer',\n  apply: ({ project }) => {\n    const filesChanged = new Set<string>()\n    const notes: string[] = []\n\n    for (const sourceFile of project.getSourceFiles()) {\n      const buildConfigLocalNames = findBuildConfigLocalNames(sourceFile)\n      if (buildConfigLocalNames.size === 0) {\n        continue\n      }\n\n      const calls = sourceFile.getDescendantsOfKind(SyntaxKind.CallExpression).filter((call) => {\n        const expr = call.getExpression()\n        return Node.isIdentifier(expr) && buildConfigLocalNames.has(expr.getText())\n      })\n\n      for (const call of calls) {\n        const [arg] = call.getArguments()\n        const configObj = arg?.asKind(SyntaxKind.ObjectLiteralExpression)\n        if (!configObj) {\n          notes.push(\n            `${sourceFile.getFilePath()}: \\`buildConfig\\` argument is not an inline object literal — check it manually for a top-level \\`sharp\\` dependency and per-collection Sharp-specific \\`upload\\` options.`,\n          )\n          continue\n        }\n\n        const uploadProp = configObj.getProperty('upload')\n        const uploadObj = uploadProp\n          ?.asKind(SyntaxKind.PropertyAssignment)\n          ?.getInitializerIfKind(SyntaxKind.ObjectLiteralExpression)\n        const existingTransformersProp = uploadObj?.getProperty('transformers')\n        const existingTransformersArray = existingTransformersProp\n          ?.asKind(SyntaxKind.PropertyAssignment)\n          ?.getInitializerIfKind(SyntaxKind.ArrayLiteralExpression)\n\n        if (existingTransformersArray && findSharpTransformerCall(existingTransformersArray)) {\n          // Already migrated, but a leftover `sharp` property would fail a later\n          // type-check with no signal from this codemod — flag it here.\n          if (configObj.getProperty('sharp')) {\n            notes.push(\n              `${sourceFile.getFilePath()}: a top-level \\`sharp\\` property remains even though \\`sharpTransformer\\` is already registered — move any value you still need into the existing \\`sharpTransformer\\` call, then remove \\`sharp\\` manually.`,\n            )\n          }\n          continue\n        }\n\n        const sharpProp = configObj.getProperty('sharp')\n        let sharpExpressionText: string | undefined\n        if (sharpProp && Node.isPropertyAssignment(sharpProp)) {\n          sharpExpressionText = sharpProp.getInitializer()?.getText()\n        } else if (sharpProp && Node.isShorthandPropertyAssignment(sharpProp)) {\n          sharpExpressionText = sharpProp.getName()\n        }\n\n        // Remove `sharp` before extracting collection entries — later removals\n        // shift node positions, and ts-morph node references taken before a\n        // sibling removal can go stale.\n        sharpProp?.remove()\n\n        const collectionEntries = extractSharpCollectionEntries({\n          configObj,\n          filePath: sourceFile.getFilePath(),\n          notes,\n        })\n\n        if (!sharpExpressionText && collectionEntries.length === 0) {\n          continue\n        }\n\n        const transformerArgs: string[] = []\n        if (sharpExpressionText) {\n          transformerArgs.push(\n            sharpExpressionText === 'sharp' ? 'sharp' : `sharp: ${sharpExpressionText}`,\n          )\n        }\n        if (collectionEntries.length > 0) {\n          transformerArgs.push(`collections: { ${collectionEntries.join(', ')} }`)\n        }\n\n        const transformerCallText = `${TRANSFORMER_NAME}({ ${transformerArgs.join(', ')} })`\n\n        if (existingTransformersArray) {\n          existingTransformersArray.addElement(transformerCallText)\n        } else if (uploadObj) {\n          uploadObj.addPropertyAssignment({\n            name: 'transformers',\n            initializer: `[${transformerCallText}]`,\n          })\n        } else if (uploadProp) {\n          notes.push(\n            `${sourceFile.getFilePath()}: \\`upload\\` isn't an inline object — add \\`transformers: [${transformerCallText}]\\` to it manually.`,\n          )\n        } else {\n          configObj.addPropertyAssignment({\n            name: 'upload',\n            initializer: `{ transformers: [${transformerCallText}] }`,\n          })\n        }\n\n        ensureSharpTransformerImport(sourceFile)\n        filesChanged.add(sourceFile.getFilePath())\n      }\n    }\n\n    if (filesChanged.size > 0) {\n      notes.push(\n        `Install the new dependency this migration relies on: pnpm add @payloadcms/transformer-sharp`,\n      )\n    }\n\n    return { filesChanged: Array.from(filesChanged), notes: notes.length ? notes : undefined }\n  },\n  description:\n    'Move 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`.',\n}\n"],"names":["Node","SyntaxKind","TRANSFORMER_MODULE","TRANSFORMER_NAME","IDENTIFIER_PATTERN","RESERVED_WORDS","Set","isSafePlainObjectKey","value","test","has","MOVED_UPLOAD_FIELDS","findBuildConfigLocalNames","file","localNames","importDecl","getImportDeclarations","getModuleSpecifierValue","spec","getNamedImports","getName","add","getAliasNode","getText","ensureSharpTransformerImport","sourceFile","existing","find","decl","otherImports","fileOmitsSemicolonsOnImports","length","every","endsWith","insertedImport","addImportDeclaration","moduleSpecifier","namedImports","insertedImportText","replaceWithText","slice","alreadyImported","some","named","addNamedImport","extractCollectionSharpEntry","collectionObj","filePath","notes","slugProp","getProperty","slugAssignment","asKind","PropertyAssignment","slugInitializer","getInitializer","undefined","uploadProp","isPropertyAssignment","uploadObj","getInitializerIfKind","ObjectLiteralExpression","getKind","TrueKeyword","push","uploadHasSpread","getProperties","prop","isSpreadAssignment","movedTexts","name","print","remove","slugLiteralValue","isStringLiteral","getLiteralValue","keyText","join","extractSharpCollectionEntries","configObj","collectionsProp","arrayLiteral","ArrayLiteralExpression","entries","el","getElements","isObjectLiteralExpression","entry","findSharpTransformerCall","transformersArray","isCallExpression","callee","getExpression","isIdentifier","migrateSharpToTransformer","apply","project","filesChanged","getSourceFiles","buildConfigLocalNames","size","calls","getDescendantsOfKind","CallExpression","filter","call","expr","arg","getArguments","getFilePath","existingTransformersProp","existingTransformersArray","sharpProp","sharpExpressionText","isShorthandPropertyAssignment","collectionEntries","transformerArgs","transformerCallText","addElement","addPropertyAssignment","initializer","Array","from","description"],"mappings":"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"}

package/dist/transforms/migrate-sharp-to-transformer/no-match.input.js

@@ -0,0 +1,11 @@
+import { buildConfig } from 'payload';
+export default buildConfig({
+    collections: [
+        {
+            slug: 'posts',
+            fields: []
+        }
+    ]
+});
+
+//# sourceMappingURL=no-match.input.js.map

package/dist/transforms/migrate-sharp-to-transformer/no-match.input.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/transforms/migrate-sharp-to-transformer/no-match.input.ts"],"sourcesContent":["import { buildConfig } from 'payload'\n\nexport default buildConfig({\n  collections: [\n    {\n      slug: 'posts',\n      fields: [],\n    },\n  ],\n})\n"],"names":["buildConfig","collections","slug","fields"],"mappings":"AAAA,SAASA,WAAW,QAAQ,UAAS;AAErC,eAAeA,YAAY;IACzBC,aAAa;QACX;YACEC,MAAM;YACNC,QAAQ,EAAE;QACZ;KACD;AACH,GAAE"}

package/dist/transforms/migrate-sharp-to-transformer/no-match.output.js

@@ -0,0 +1,11 @@
+import { buildConfig } from 'payload';
+export default buildConfig({
+    collections: [
+        {
+            slug: 'posts',
+            fields: []
+        }
+    ]
+});
+
+//# sourceMappingURL=no-match.output.js.map

package/dist/transforms/migrate-sharp-to-transformer/no-match.output.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/transforms/migrate-sharp-to-transformer/no-match.output.ts"],"sourcesContent":["import { buildConfig } from 'payload'\n\nexport default buildConfig({\n  collections: [\n    {\n      slug: 'posts',\n      fields: [],\n    },\n  ],\n})\n"],"names":["buildConfig","collections","slug","fields"],"mappings":"AAAA,SAASA,WAAW,QAAQ,UAAS;AAErC,eAAeA,YAAY;IACzBC,aAAa;QACX;YACEC,MAAM;YACNC,QAAQ,EAAE;QACZ;KACD;AACH,GAAE"}

package/dist/transforms/migrate-versions-default/index.js

@@ -1,4 +1,4 @@
-import { Node, SyntaxKind } from 'ts-morph';
+import { Node } from 'ts-morph';
 const VERSIONED_CONFIG_TYPE_NAMES = new Set([
     'CollectionConfig',
     'GlobalConfig',
@@ -69,8 +69,8 @@ const isVersionedConfigTypeName = (typeText)=>{
         return undefined;
     }
     // Form 2: { ... } satisfies CollectionConfig
-    if (node.getKind() === SyntaxKind.SatisfiesExpression) {
-        const typeNode = node.getTypeNode?.();
+    if (Node.isSatisfiesExpression(node)) {
+        const typeNode = node.getTypeNode();
         if (!typeNode) {
             return undefined;
         }
@@ -78,8 +78,8 @@ const isVersionedConfigTypeName = (typeText)=>{
         if (!isVersionedConfigTypeName(typeText)) {
             return undefined;
         }
-        const expr = node.getExpression?.();
-        if (expr && Node.isObjectLiteralExpression(expr)) {
+        const expr = node.getExpression();
+        if (Node.isObjectLiteralExpression(expr)) {
             return expr;
         }
         return undefined;

package/dist/transforms/migrate-versions-default/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/transforms/migrate-versions-default/index.ts"],"sourcesContent":["import { Node, SyntaxKind } from 'ts-morph'\n\nimport type { Transform } from '../../types.js'\n\nconst VERSIONED_CONFIG_TYPE_NAMES = new Set([\n  'CollectionConfig',\n  'GlobalConfig',\n  'SanitizedCollectionConfig',\n  'SanitizedGlobalConfig',\n])\n\nconst isVersionedConfigTypeName = (typeText: string): boolean => {\n  const baseName = typeText.replace(/<.*>$/, '').trim()\n  return VERSIONED_CONFIG_TYPE_NAMES.has(baseName)\n}\n\n/**\n * Finds object literals typed as CollectionConfig or GlobalConfig and adds\n * `versions: false` if the property is absent. Covers three annotation forms:\n *   const X: CollectionConfig = { ... }\n *   { ... } satisfies GlobalConfig\n *   { ... } as CollectionConfig\n */\nexport const migrateVersionsDefault: Transform = {\n  name: 'migrate-versions-default',\n  apply: ({ project }) => {\n    const filesChanged = new Set<string>()\n\n    for (const sourceFile of project.getSourceFiles()) {\n      let mutated = false\n\n      sourceFile.forEachDescendant((node) => {\n        const objectLiteral = resolveVersionedConfigObject(node)\n        if (!objectLiteral) {\n          return\n        }\n\n        if (objectLiteral.getProperty('versions')) {\n          return\n        }\n\n        objectLiteral.addPropertyAssignment({\n          name: 'versions',\n          initializer: 'false',\n        })\n\n        mutated = true\n      })\n\n      if (mutated) {\n        filesChanged.add(sourceFile.getFilePath())\n      }\n    }\n\n    return { filesChanged: [...filesChanged] }\n  },\n  description:\n    'Add `versions: false` to CollectionConfig and GlobalConfig objects that do not already have a versions property, preserving the previous opt-in behaviour after versions became enabled by default.',\n}\n\n/**\n * Given a node, returns its ObjectLiteralExpression if the node represents a\n * CollectionConfig- or GlobalConfig-typed value in one of the three recognised forms.\n * Returns undefined for everything else.\n */\nconst resolveVersionedConfigObject = (node: Node) => {\n  // Form 1: const X: CollectionConfig = { ... }\n  if (Node.isVariableDeclaration(node)) {\n    const typeNode = node.getTypeNode()\n    if (!typeNode) {\n      return undefined\n    }\n    const typeText = typeNode.getText().trim()\n    if (!isVersionedConfigTypeName(typeText)) {\n      return undefined\n    }\n    const initializer = node.getInitializer()\n    if (initializer && Node.isObjectLiteralExpression(initializer)) {\n      return initializer\n    }\n    return undefined\n  }\n\n  // Form 2: { ... } satisfies CollectionConfig\n  if (node.getKind() === SyntaxKind.SatisfiesExpression) {\n    const typeNode = (node as any).getTypeNode?.()\n    if (!typeNode) {\n      return undefined\n    }\n    const typeText = typeNode.getText().trim()\n    if (!isVersionedConfigTypeName(typeText)) {\n      return undefined\n    }\n    const expr = (node as any).getExpression?.()\n    if (expr && Node.isObjectLiteralExpression(expr)) {\n      return expr\n    }\n    return undefined\n  }\n\n  // Form 3: { ... } as CollectionConfig\n  if (Node.isAsExpression(node)) {\n    const typeNode = node.getTypeNode()\n    if (!typeNode) {\n      return undefined\n    }\n    const typeText = typeNode.getText().trim()\n    if (!isVersionedConfigTypeName(typeText)) {\n      return undefined\n    }\n    const expr = node.getExpression()\n    if (Node.isObjectLiteralExpression(expr)) {\n      return expr\n    }\n    return undefined\n  }\n\n  return undefined\n}\n"],"names":["Node","SyntaxKind","VERSIONED_CONFIG_TYPE_NAMES","Set","isVersionedConfigTypeName","typeText","baseName","replace","trim","has","migrateVersionsDefault","name","apply","project","filesChanged","sourceFile","getSourceFiles","mutated","forEachDescendant","node","objectLiteral","resolveVersionedConfigObject","getProperty","addPropertyAssignment","initializer","add","getFilePath","description","isVariableDeclaration","typeNode","getTypeNode","undefined","getText","getInitializer","isObjectLiteralExpression","getKind","SatisfiesExpression","expr","getExpression","isAsExpression"],"mappings":"AAAA,SAASA,IAAI,EAAEC,UAAU,QAAQ,WAAU;AAI3C,MAAMC,8BAA8B,IAAIC,IAAI;IAC1C;IACA;IACA;IACA;CACD;AAED,MAAMC,4BAA4B,CAACC;IACjC,MAAMC,WAAWD,SAASE,OAAO,CAAC,SAAS,IAAIC,IAAI;IACnD,OAAON,4BAA4BO,GAAG,CAACH;AACzC;AAEA;;;;;;CAMC,GACD,OAAO,MAAMI,yBAAoC;IAC/CC,MAAM;IACNC,OAAO,CAAC,EAAEC,OAAO,EAAE;QACjB,MAAMC,eAAe,IAAIX;QAEzB,KAAK,MAAMY,cAAcF,QAAQG,cAAc,GAAI;YACjD,IAAIC,UAAU;YAEdF,WAAWG,iBAAiB,CAAC,CAACC;gBAC5B,MAAMC,gBAAgBC,6BAA6BF;gBACnD,IAAI,CAACC,eAAe;oBAClB;gBACF;gBAEA,IAAIA,cAAcE,WAAW,CAAC,aAAa;oBACzC;gBACF;gBAEAF,cAAcG,qBAAqB,CAAC;oBAClCZ,MAAM;oBACNa,aAAa;gBACf;gBAEAP,UAAU;YACZ;YAEA,IAAIA,SAAS;gBACXH,aAAaW,GAAG,CAACV,WAAWW,WAAW;YACzC;QACF;QAEA,OAAO;YAAEZ,cAAc;mBAAIA;aAAa;QAAC;IAC3C;IACAa,aACE;AACJ,EAAC;AAED;;;;CAIC,GACD,MAAMN,+BAA+B,CAACF;IACpC,8CAA8C;IAC9C,IAAInB,KAAK4B,qBAAqB,CAACT,OAAO;QACpC,MAAMU,WAAWV,KAAKW,WAAW;QACjC,IAAI,CAACD,UAAU;YACb,OAAOE;QACT;QACA,MAAM1B,WAAWwB,SAASG,OAAO,GAAGxB,IAAI;QACxC,IAAI,CAACJ,0BAA0BC,WAAW;YACxC,OAAO0B;QACT;QACA,MAAMP,cAAcL,KAAKc,cAAc;QACvC,IAAIT,eAAexB,KAAKkC,yBAAyB,CAACV,cAAc;YAC9D,OAAOA;QACT;QACA,OAAOO;IACT;IAEA,6CAA6C;IAC7C,IAAIZ,KAAKgB,OAAO,OAAOlC,WAAWmC,mBAAmB,EAAE;QACrD,MAAMP,WAAW,AAACV,KAAaW,WAAW;QAC1C,IAAI,CAACD,UAAU;YACb,OAAOE;QACT;QACA,MAAM1B,WAAWwB,SAASG,OAAO,GAAGxB,IAAI;QACxC,IAAI,CAACJ,0BAA0BC,WAAW;YACxC,OAAO0B;QACT;QACA,MAAMM,OAAO,AAAClB,KAAamB,aAAa;QACxC,IAAID,QAAQrC,KAAKkC,yBAAyB,CAACG,OAAO;YAChD,OAAOA;QACT;QACA,OAAON;IACT;IAEA,sCAAsC;IACtC,IAAI/B,KAAKuC,cAAc,CAACpB,OAAO;QAC7B,MAAMU,WAAWV,KAAKW,WAAW;QACjC,IAAI,CAACD,UAAU;YACb,OAAOE;QACT;QACA,MAAM1B,WAAWwB,SAASG,OAAO,GAAGxB,IAAI;QACxC,IAAI,CAACJ,0BAA0BC,WAAW;YACxC,OAAO0B;QACT;QACA,MAAMM,OAAOlB,KAAKmB,aAAa;QAC/B,IAAItC,KAAKkC,yBAAyB,CAACG,OAAO;YACxC,OAAOA;QACT;QACA,OAAON;IACT;IAEA,OAAOA;AACT"}
+{"version":3,"sources":["../../../src/transforms/migrate-versions-default/index.ts"],"sourcesContent":["import { Node } from 'ts-morph'\n\nimport type { Transform } from '../../types.js'\n\nconst VERSIONED_CONFIG_TYPE_NAMES = new Set([\n  'CollectionConfig',\n  'GlobalConfig',\n  'SanitizedCollectionConfig',\n  'SanitizedGlobalConfig',\n])\n\nconst isVersionedConfigTypeName = (typeText: string): boolean => {\n  const baseName = typeText.replace(/<.*>$/, '').trim()\n  return VERSIONED_CONFIG_TYPE_NAMES.has(baseName)\n}\n\n/**\n * Finds object literals typed as CollectionConfig or GlobalConfig and adds\n * `versions: false` if the property is absent. Covers three annotation forms:\n *   const X: CollectionConfig = { ... }\n *   { ... } satisfies GlobalConfig\n *   { ... } as CollectionConfig\n */\nexport const migrateVersionsDefault: Transform = {\n  name: 'migrate-versions-default',\n  apply: ({ project }) => {\n    const filesChanged = new Set<string>()\n\n    for (const sourceFile of project.getSourceFiles()) {\n      let mutated = false\n\n      sourceFile.forEachDescendant((node) => {\n        const objectLiteral = resolveVersionedConfigObject(node)\n        if (!objectLiteral) {\n          return\n        }\n\n        if (objectLiteral.getProperty('versions')) {\n          return\n        }\n\n        objectLiteral.addPropertyAssignment({\n          name: 'versions',\n          initializer: 'false',\n        })\n\n        mutated = true\n      })\n\n      if (mutated) {\n        filesChanged.add(sourceFile.getFilePath())\n      }\n    }\n\n    return { filesChanged: [...filesChanged] }\n  },\n  description:\n    'Add `versions: false` to CollectionConfig and GlobalConfig objects that do not already have a versions property, preserving the previous opt-in behaviour after versions became enabled by default.',\n}\n\n/**\n * Given a node, returns its ObjectLiteralExpression if the node represents a\n * CollectionConfig- or GlobalConfig-typed value in one of the three recognised forms.\n * Returns undefined for everything else.\n */\nconst resolveVersionedConfigObject = (node: Node) => {\n  // Form 1: const X: CollectionConfig = { ... }\n  if (Node.isVariableDeclaration(node)) {\n    const typeNode = node.getTypeNode()\n    if (!typeNode) {\n      return undefined\n    }\n    const typeText = typeNode.getText().trim()\n    if (!isVersionedConfigTypeName(typeText)) {\n      return undefined\n    }\n    const initializer = node.getInitializer()\n    if (initializer && Node.isObjectLiteralExpression(initializer)) {\n      return initializer\n    }\n    return undefined\n  }\n\n  // Form 2: { ... } satisfies CollectionConfig\n  if (Node.isSatisfiesExpression(node)) {\n    const typeNode = node.getTypeNode()\n    if (!typeNode) {\n      return undefined\n    }\n    const typeText = typeNode.getText().trim()\n    if (!isVersionedConfigTypeName(typeText)) {\n      return undefined\n    }\n    const expr = node.getExpression()\n    if (Node.isObjectLiteralExpression(expr)) {\n      return expr\n    }\n    return undefined\n  }\n\n  // Form 3: { ... } as CollectionConfig\n  if (Node.isAsExpression(node)) {\n    const typeNode = node.getTypeNode()\n    if (!typeNode) {\n      return undefined\n    }\n    const typeText = typeNode.getText().trim()\n    if (!isVersionedConfigTypeName(typeText)) {\n      return undefined\n    }\n    const expr = node.getExpression()\n    if (Node.isObjectLiteralExpression(expr)) {\n      return expr\n    }\n    return undefined\n  }\n\n  return undefined\n}\n"],"names":["Node","VERSIONED_CONFIG_TYPE_NAMES","Set","isVersionedConfigTypeName","typeText","baseName","replace","trim","has","migrateVersionsDefault","name","apply","project","filesChanged","sourceFile","getSourceFiles","mutated","forEachDescendant","node","objectLiteral","resolveVersionedConfigObject","getProperty","addPropertyAssignment","initializer","add","getFilePath","description","isVariableDeclaration","typeNode","getTypeNode","undefined","getText","getInitializer","isObjectLiteralExpression","isSatisfiesExpression","expr","getExpression","isAsExpression"],"mappings":"AAAA,SAASA,IAAI,QAAQ,WAAU;AAI/B,MAAMC,8BAA8B,IAAIC,IAAI;IAC1C;IACA;IACA;IACA;CACD;AAED,MAAMC,4BAA4B,CAACC;IACjC,MAAMC,WAAWD,SAASE,OAAO,CAAC,SAAS,IAAIC,IAAI;IACnD,OAAON,4BAA4BO,GAAG,CAACH;AACzC;AAEA;;;;;;CAMC,GACD,OAAO,MAAMI,yBAAoC;IAC/CC,MAAM;IACNC,OAAO,CAAC,EAAEC,OAAO,EAAE;QACjB,MAAMC,eAAe,IAAIX;QAEzB,KAAK,MAAMY,cAAcF,QAAQG,cAAc,GAAI;YACjD,IAAIC,UAAU;YAEdF,WAAWG,iBAAiB,CAAC,CAACC;gBAC5B,MAAMC,gBAAgBC,6BAA6BF;gBACnD,IAAI,CAACC,eAAe;oBAClB;gBACF;gBAEA,IAAIA,cAAcE,WAAW,CAAC,aAAa;oBACzC;gBACF;gBAEAF,cAAcG,qBAAqB,CAAC;oBAClCZ,MAAM;oBACNa,aAAa;gBACf;gBAEAP,UAAU;YACZ;YAEA,IAAIA,SAAS;gBACXH,aAAaW,GAAG,CAACV,WAAWW,WAAW;YACzC;QACF;QAEA,OAAO;YAAEZ,cAAc;mBAAIA;aAAa;QAAC;IAC3C;IACAa,aACE;AACJ,EAAC;AAED;;;;CAIC,GACD,MAAMN,+BAA+B,CAACF;IACpC,8CAA8C;IAC9C,IAAIlB,KAAK2B,qBAAqB,CAACT,OAAO;QACpC,MAAMU,WAAWV,KAAKW,WAAW;QACjC,IAAI,CAACD,UAAU;YACb,OAAOE;QACT;QACA,MAAM1B,WAAWwB,SAASG,OAAO,GAAGxB,IAAI;QACxC,IAAI,CAACJ,0BAA0BC,WAAW;YACxC,OAAO0B;QACT;QACA,MAAMP,cAAcL,KAAKc,cAAc;QACvC,IAAIT,eAAevB,KAAKiC,yBAAyB,CAACV,cAAc;YAC9D,OAAOA;QACT;QACA,OAAOO;IACT;IAEA,6CAA6C;IAC7C,IAAI9B,KAAKkC,qBAAqB,CAAChB,OAAO;QACpC,MAAMU,WAAWV,KAAKW,WAAW;QACjC,IAAI,CAACD,UAAU;YACb,OAAOE;QACT;QACA,MAAM1B,WAAWwB,SAASG,OAAO,GAAGxB,IAAI;QACxC,IAAI,CAACJ,0BAA0BC,WAAW;YACxC,OAAO0B;QACT;QACA,MAAMK,OAAOjB,KAAKkB,aAAa;QAC/B,IAAIpC,KAAKiC,yBAAyB,CAACE,OAAO;YACxC,OAAOA;QACT;QACA,OAAOL;IACT;IAEA,sCAAsC;IACtC,IAAI9B,KAAKqC,cAAc,CAACnB,OAAO;QAC7B,MAAMU,WAAWV,KAAKW,WAAW;QACjC,IAAI,CAACD,UAAU;YACb,OAAOE;QACT;QACA,MAAM1B,WAAWwB,SAASG,OAAO,GAAGxB,IAAI;QACxC,IAAI,CAACJ,0BAA0BC,WAAW;YACxC,OAAO0B;QACT;QACA,MAAMK,OAAOjB,KAAKkB,aAAa;QAC/B,IAAIpC,KAAKiC,yBAAyB,CAACE,OAAO;YACxC,OAAOA;QACT;QACA,OAAOL;IACT;IAEA,OAAOA;AACT"}

package/dist/transforms/remove-default-locale-publish-option/all-value.input.js

@@ -0,0 +1,13 @@
+import { buildConfig } from 'payload';
+export default buildConfig({
+    localization: {
+        defaultLocale: 'en',
+        defaultLocalePublishOption: 'all',
+        locales: [
+            'en',
+            'es'
+        ]
+    }
+});
+
+//# sourceMappingURL=all-value.input.js.map

package/dist/transforms/remove-default-locale-publish-option/all-value.input.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/transforms/remove-default-locale-publish-option/all-value.input.ts"],"sourcesContent":["import { buildConfig } from 'payload'\n\nexport default buildConfig({\n  localization: {\n    defaultLocale: 'en',\n    defaultLocalePublishOption: 'all',\n    locales: ['en', 'es'],\n  },\n})\n"],"names":["buildConfig","localization","defaultLocale","defaultLocalePublishOption","locales"],"mappings":"AAAA,SAASA,WAAW,QAAQ,UAAS;AAErC,eAAeA,YAAY;IACzBC,cAAc;QACZC,eAAe;QACfC,4BAA4B;QAC5BC,SAAS;YAAC;YAAM;SAAK;IACvB;AACF,GAAE"}

package/dist/transforms/remove-default-locale-publish-option/basic.input.js

@@ -0,0 +1,13 @@
+import { buildConfig } from 'payload';
+export default buildConfig({
+    localization: {
+        defaultLocale: 'en',
+        defaultLocalePublishOption: 'active',
+        locales: [
+            'en',
+            'es'
+        ]
+    }
+});
+
+//# sourceMappingURL=basic.input.js.map

package/dist/transforms/remove-default-locale-publish-option/basic.input.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/transforms/remove-default-locale-publish-option/basic.input.ts"],"sourcesContent":["import { buildConfig } from 'payload'\n\nexport default buildConfig({\n  localization: {\n    defaultLocale: 'en',\n    defaultLocalePublishOption: 'active',\n    locales: ['en', 'es'],\n  },\n})\n"],"names":["buildConfig","localization","defaultLocale","defaultLocalePublishOption","locales"],"mappings":"AAAA,SAASA,WAAW,QAAQ,UAAS;AAErC,eAAeA,YAAY;IACzBC,cAAc;QACZC,eAAe;QACfC,4BAA4B;QAC5BC,SAAS;YAAC;YAAM;SAAK;IACvB;AACF,GAAE"}

package/dist/transforms/remove-default-locale-publish-option/basic.output.js

@@ -0,0 +1,12 @@
+import { buildConfig } from 'payload';
+export default buildConfig({
+    localization: {
+        defaultLocale: 'en',
+        locales: [
+            'en',
+            'es'
+        ]
+    }
+});
+
+//# sourceMappingURL=basic.output.js.map

package/dist/transforms/remove-default-locale-publish-option/basic.output.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/transforms/remove-default-locale-publish-option/basic.output.ts"],"sourcesContent":["import { buildConfig } from 'payload'\n\nexport default buildConfig({\n  localization: {\n    defaultLocale: 'en',\n    locales: ['en', 'es'],\n  },\n})\n"],"names":["buildConfig","localization","defaultLocale","locales"],"mappings":"AAAA,SAASA,WAAW,QAAQ,UAAS;AAErC,eAAeA,YAAY;IACzBC,cAAc;QACZC,eAAe;QACfC,SAAS;YAAC;YAAM;SAAK;IACvB;AACF,GAAE"}

package/dist/transforms/remove-default-locale-publish-option/dynamic.input.js

@@ -0,0 +1,17 @@
+import { buildConfig } from 'payload';
+const localization = createLocalization();
+export default buildConfig({
+    localization
+});
+function createLocalization() {
+    return {
+        defaultLocale: 'en',
+        defaultLocalePublishOption: 'all',
+        locales: [
+            'en',
+            'es'
+        ]
+    };
+}
+
+//# sourceMappingURL=dynamic.input.js.map

package/dist/transforms/remove-default-locale-publish-option/dynamic.input.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/transforms/remove-default-locale-publish-option/dynamic.input.ts"],"sourcesContent":["import { buildConfig } from 'payload'\n\nconst localization = createLocalization()\n\nexport default buildConfig({ localization })\n\nfunction createLocalization() {\n  return {\n    defaultLocale: 'en',\n    defaultLocalePublishOption: 'all',\n    locales: ['en', 'es'],\n  }\n}\n"],"names":["buildConfig","localization","createLocalization","defaultLocale","defaultLocalePublishOption","locales"],"mappings":"AAAA,SAASA,WAAW,QAAQ,UAAS;AAErC,MAAMC,eAAeC;AAErB,eAAeF,YAAY;IAAEC;AAAa,GAAE;AAE5C,SAASC;IACP,OAAO;QACLC,eAAe;QACfC,4BAA4B;QAC5BC,SAAS;YAAC;YAAM;SAAK;IACvB;AACF"}

package/dist/transforms/remove-default-locale-publish-option/index.d.ts

@@ -0,0 +1,10 @@
+import type { Transform } from '../../types.js';
+/**
+ * Removes `defaultLocalePublishOption` from `localization` config objects.
+ *
+ * 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 option. The config property is no longer needed.
+ */
+export declare const removeDefaultLocalePublishOption: Transform;
+//# sourceMappingURL=index.d.ts.map

package/dist/transforms/remove-default-locale-publish-option/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/transforms/remove-default-locale-publish-option/index.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAE/C;;;;;;GAMG;AACH,eAAO,MAAM,gCAAgC,EAAE,SA0E9C,CAAA"}

package/dist/transforms/remove-default-locale-publish-option/index.js

@@ -0,0 +1,103 @@
+import { Node, SyntaxKind, VariableDeclarationKind } from 'ts-morph';
+/**
+ * Removes `defaultLocalePublishOption` from `localization` config objects.
+ *
+ * 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 option. The config property is no longer needed.
+ */ export const removeDefaultLocalePublishOption = {
+    name: 'remove-default-locale-publish-option',
+    apply: ({ project })=>{
+        const filesChanged = new Set();
+        const notes = new Set();
+        for (const sourceFile of project.getSourceFiles()){
+            const localizationProperties = [
+                ...sourceFile.getDescendantsOfKind(SyntaxKind.PropertyAssignment).filter((property)=>property.getName() === 'localization'),
+                ...sourceFile.getDescendantsOfKind(SyntaxKind.ShorthandPropertyAssignment).filter((property)=>property.getName() === 'localization')
+            ];
+            for (const localizationProperty of localizationProperties){
+                const localizationResolution = resolveLocalizationObject({
+                    property: localizationProperty
+                });
+                if (localizationResolution.isUnresolved) {
+                    notes.add(`${sourceFile.getFilePath()}: 'localization' uses a value that cannot be resolved safely — migrate manually by removing 'localization.defaultLocalePublishOption' if it is present.`);
+                    continue;
+                }
+                const localizationObject = localizationResolution.object;
+                if (!localizationObject) {
+                    continue;
+                }
+                if (localizationObject.getProperties().some((property)=>Node.isSpreadAssignment(property))) {
+                    notes.add(`${sourceFile.getFilePath()}: 'localization' includes a spread — migrate manually by removing 'localization.defaultLocalePublishOption' if it is present in the spread value.`);
+                }
+                const defaultLocalePublishOption = localizationObject.getProperty('defaultLocalePublishOption');
+                if (!defaultLocalePublishOption || !Node.isPropertyAssignment(defaultLocalePublishOption)) {
+                    continue;
+                }
+                const initializer = defaultLocalePublishOption.getInitializer();
+                if (initializer && Node.isStringLiteral(initializer) && initializer.getLiteralValue() === 'all') {
+                    notes.add(`${sourceFile.getFilePath()}: 'localization.defaultLocalePublishOption' was set to 'all' — the Admin UI Publish button now defaults to publishing only the active locale instead. Use the "Publish all locales" option in the Publish button dropdown to publish every locale at once.`);
+                }
+                defaultLocalePublishOption.remove();
+                filesChanged.add(sourceFile.getFilePath());
+            }
+        }
+        return {
+            filesChanged: Array.from(filesChanged),
+            ...notes.size > 0 ? {
+                notes: Array.from(notes)
+            } : {}
+        };
+    },
+    description: 'Remove 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.'
+};
+function resolveLocalizationObject({ property }) {
+    if (Node.isPropertyAssignment(property)) {
+        return resolveLocalizationInitializer({
+            initializer: property.getInitializer()
+        });
+    }
+    const variableDeclaration = property.getValueSymbol()?.getDeclarations().find(Node.isVariableDeclaration);
+    return resolveLocalizationVariable({
+        variableDeclaration
+    });
+}
+function resolveLocalizationInitializer({ initializer }) {
+    if (!initializer) {
+        return {
+            isUnresolved: true
+        };
+    }
+    if (Node.isObjectLiteralExpression(initializer)) {
+        return {
+            isUnresolved: false,
+            object: initializer
+        };
+    }
+    if (initializer.getKind() === SyntaxKind.FalseKeyword) {
+        return {
+            isUnresolved: false
+        };
+    }
+    if (Node.isIdentifier(initializer)) {
+        const variableDeclaration = initializer.getDefinitions().map((definition)=>definition.getDeclarationNode()).find(Node.isVariableDeclaration);
+        return resolveLocalizationVariable({
+            variableDeclaration
+        });
+    }
+    return {
+        isUnresolved: true
+    };
+}
+function resolveLocalizationVariable({ variableDeclaration }) {
+    if (!variableDeclaration || variableDeclaration.getVariableStatement()?.getDeclarationKind() !== VariableDeclarationKind.Const) {
+        return {
+            isUnresolved: true
+        };
+    }
+    return resolveLocalizationInitializer({
+        initializer: variableDeclaration.getInitializer()
+    });
+}
+
+//# sourceMappingURL=index.js.map