@payloadcms/figma 0.0.1-alpha.6 → 0.0.1-alpha.60

package/dist/utils/payload-config-ast.js

@@ -20,15 +20,18 @@ import * as log from './log.js';
     log.debug(`Found import from: ${payloadImport.getModuleSpecifierValue()}`);
     const moduleSpecifier = payloadImport.getModuleSpecifierValue();
     const namedImports = payloadImport.getNamedImports();
-    // Check if buildConfig is imported
-    const buildConfigImport = namedImports.find((ni)=>ni.getName() === 'buildConfig');
+    // Determine which function name to look for based on the import source
+    // - From 'payload': look for buildConfig (needs migration)
+    // - From '@payloadcms/figma': look for buildFigmaConfig (already migrated)
+    const expectedFunctionName = moduleSpecifier === 'payload' ? 'buildConfig' : 'buildFigmaConfig';
+    const buildConfigImport = namedImports.find((ni)=>ni.getName() === expectedFunctionName);
     if (!buildConfigImport) {
         result.hasBuildConfig = false;
         return result;
     }
     // Check for alias and get the actual name used in code
     const aliasNode = buildConfigImport.getAliasNode();
-    const buildConfigName = aliasNode ? aliasNode.getText() : 'buildConfig';
+    const buildConfigName = aliasNode ? aliasNode.getText() : expectedFunctionName;
     if (aliasNode) {
         result.hasAlias = true;
     }
@@ -109,6 +112,15 @@ import * as log from './log.js';
             }
         }
     }
+    // Check for sharp property
+    const sharpProperty = configArg.getProperty('sharp');
+    if (sharpProperty) {
+        // Find the import source for sharp
+        const sharpImport = imports.find((imp)=>imp.getModuleSpecifierValue() === 'sharp' || imp.getNamedImports().some((ni)=>ni.getName() === 'sharp'));
+        result.sharpProperty = {
+            importSource: sharpImport?.getModuleSpecifierValue() || 'sharp'
+        };
+    }
     // Check for figma property
     const figmaProperty = configArg.getProperty('figma');
     if (figmaProperty) {
@@ -240,7 +252,16 @@ import * as log from './log.js';
             modified = true;
         }
     }
-    // 4. Update buildConfig import
+    // 4. Remove sharp property
+    if (detection.sharpProperty) {
+        const sharpProperty = configArg.getProperty('sharp');
+        if (sharpProperty) {
+            sharpProperty.remove();
+            changes.push('Removed sharp property');
+            modified = true;
+        }
+    }
+    // 5. Update buildConfig import
     if (detection.needsImportChange) {
         if (payloadImport) {
             if (detection.hasOtherPayloadImports) {
@@ -258,19 +279,38 @@ import * as log from './log.js';
                 sourceFile.addImportDeclaration({
                     moduleSpecifier: '@payloadcms/figma',
                     namedImports: [
-                        'buildConfig'
+                        'buildFigmaConfig'
                     ]
                 });
+                // Rename all usages of 'buildConfig' to 'buildFigmaConfig'
+                const identifiers = sourceFile.getDescendantsOfKind(SyntaxKind.Identifier);
+                identifiers.forEach((identifier)=>{
+                    if (identifier.getText() === 'buildConfig') {
+                        identifier.replaceWithText('buildFigmaConfig');
+                    }
+                });
                 changes.push('Split buildConfig import to @payloadcms/figma');
             } else {
-                // Replace entire import
+                // Replace entire import: change module specifier and rename all references
+                const buildConfigImport = payloadImport.getNamedImports().find((ni)=>ni.getName() === 'buildConfig');
+                if (buildConfigImport) {
+                    // Change the import name
+                    buildConfigImport.setName('buildFigmaConfig');
+                    // Find and rename all usages of 'buildConfig' in the file
+                    const identifiers = sourceFile.getDescendantsOfKind(SyntaxKind.Identifier);
+                    identifiers.forEach((identifier)=>{
+                        if (identifier.getText() === 'buildConfig') {
+                            identifier.replaceWithText('buildFigmaConfig');
+                        }
+                    });
+                }
                 payloadImport.setModuleSpecifier('@payloadcms/figma');
                 changes.push('Changed buildConfig import to @payloadcms/figma');
             }
             modified = true;
         }
     }
-    // 5. Remove orphaned imports
+    // 6. Remove orphaned imports
     // Re-fetch imports after each removal to avoid stale references
     if (detection.dbProperty) {
         const currentImports = sourceFile.getImportDeclarations();
@@ -290,6 +330,15 @@ import * as log from './log.js';
             modified = true;
         }
     }
+    if (detection.sharpProperty) {
+        const currentImports = sourceFile.getImportDeclarations();
+        const sharpImport = currentImports.find((imp)=>imp.getModuleSpecifierValue() === 'sharp');
+        if (sharpImport) {
+            sharpImport.remove();
+            changes.push('Removed sharp import');
+            modified = true;
+        }
+    }
     return {
         changes,
         modified
@@ -301,15 +350,15 @@ import * as log from './log.js';
  */ export function addFigmaProperty(sourceFile, config) {
     const changes = [];
     let modified = false;
-    // Find buildConfig call
+    // Find buildFigmaConfig call (this function is only used with Figma configs)
     const callExpressions = sourceFile.getDescendantsOfKind(SyntaxKind.CallExpression);
     const buildConfigCall = callExpressions.find((ce)=>{
         const expr = ce.getExpression();
         const text = expr.getText();
-        return text === 'buildConfig' || text.endsWith('.buildConfig');
+        return text === 'buildFigmaConfig' || text.endsWith('.buildFigmaConfig');
     });
     if (!buildConfigCall) {
-        log.debug('No buildConfig call found');
+        log.debug('No buildFigmaConfig call found');
         return {
             changes: [],
             modified: false
@@ -336,15 +385,14 @@ import * as log from './log.js';
         };
     }
     // Add figma property
+    // contentSystemId is resolved automatically by buildFigmaConfig from env vars or bootstrap cache.
+    // useContentSystem defaults to true, so we only generate it when explicitly false.
+    const figmaObj = config.useContentSystem === false ? `{\nuseContentSystem: false,\n}` : '{}';
     configArg.addPropertyAssignment({
         name: 'figma',
-        initializer: `{
-    region: '${config.region}',
-    tenantId: '${config.tenantId}',
-    useContentSystem: ${config.useContentSystem},
-  }`
+        initializer: figmaObj
     });
-    changes.push(`Added figma property (region: ${config.region}, tenantId: ${config.tenantId}, useContentSystem: ${config.useContentSystem})`);
+    changes.push(`Added figma property (contentSystemId: ${config.contentSystemId})`);
     modified = true;
     return {
         changes,
@@ -352,60 +400,42 @@ import * as log from './log.js';
     };
 }
 /**
- * Read figma configuration from payload.config.ts
- * Returns the figma object if it exists, null otherwise
- */ export function readFigmaConfig(sourceFile) {
-    // Find buildConfig call
+ * Remove the contentSystemId property from figma config object.
+ * Used during upgrade migration — contentSystemId is now resolved from bootstrap data.
+ *
+ * @returns true if the property was found and removed
+ */ export function removeFigmaContentSystemId(sourceFile) {
     const callExpressions = sourceFile.getDescendantsOfKind(SyntaxKind.CallExpression);
     const buildConfigCall = callExpressions.find((ce)=>{
         const expr = ce.getExpression();
         const text = expr.getText();
-        return text === 'buildConfig' || text.endsWith('.buildConfig');
+        return text === 'buildFigmaConfig' || text.endsWith('.buildFigmaConfig');
     });
     if (!buildConfigCall) {
-        log.debug('No buildConfig call found');
-        return null;
+        return false;
     }
-    // Get config object argument
     const configArg = buildConfigCall.getArguments()[0];
     if (!configArg || !Node.isObjectLiteralExpression(configArg)) {
-        log.debug('buildConfig argument is not an object literal');
-        return null;
+        return false;
     }
-    // Find figma property
     const figmaProperty = configArg.getProperty('figma');
     if (!figmaProperty || !Node.isPropertyAssignment(figmaProperty)) {
-        log.debug('No figma property found in buildConfig');
-        return null;
+        return false;
     }
-    // Get initializer (the object value)
     const initializer = figmaProperty.getInitializer();
     if (!initializer || !Node.isObjectLiteralExpression(initializer)) {
-        log.debug('figma property is not an object literal');
-        return null;
-    }
-    // Extract values
-    const regionProp = initializer.getProperty('region');
-    const tenantIdProp = initializer.getProperty('tenantId');
-    const useContentSystemProp = initializer.getProperty('useContentSystem');
-    if (!regionProp || !tenantIdProp) {
-        log.debug('Missing required figma properties (region or tenantId)');
-        return null;
-    }
-    // Extract string values (remove quotes)
-    const region = Node.isPropertyAssignment(regionProp) ? regionProp.getInitializer()?.getText().replace(/['"]/g, '') : undefined;
-    const tenantId = Node.isPropertyAssignment(tenantIdProp) ? tenantIdProp.getInitializer()?.getText().replace(/['"]/g, '') : undefined;
-    const useContentSystem = Node.isPropertyAssignment(useContentSystemProp) ? useContentSystemProp.getInitializer()?.getText() === 'true' : true // Default to true if not specified
-    ;
-    if (!region || !tenantId) {
-        log.debug('Could not extract region or tenantId values');
-        return null;
+        return false;
     }
-    return {
-        region,
-        tenantId,
-        useContentSystem
-    };
+    const contentSystemIdProp = initializer.getProperty('contentSystemId');
+    if (!contentSystemIdProp) {
+        return false;
+    }
+    contentSystemIdProp.remove();
+    // Collapse empty object to avoid ts-morph whitespace artifacts
+    if (initializer.getProperties().length === 0) {
+        initializer.replaceWithText('{}');
+    }
+    return true;
 }
 
 //# sourceMappingURL=payload-config-ast.js.map

package/dist/utils/payload-config-finder.d.ts

@@ -1,6 +1,6 @@
 /**
- * Find the Payload config file using Payload's built-in finder
- * Changes to project directory temporarily and restores afterward
+ * Find the Payload config file using Payload's built-in finder when available,
+ * with fallback to simple file search for npx environments where payload isn't installed.
  *
  * @param projectPath - Absolute path to project directory
  * @returns Absolute path to config file, or null if not found

package/dist/utils/payload-config-finder.js

@@ -1,26 +1,65 @@
-import { findConfig } from 'payload/node';
+import fs from 'fs/promises';
+import path from 'path';
+import * as log from './log.js';
+// Standard Payload config file names in priority order
+const CONFIG_FILES = [
+    'payload.config.ts',
+    'payload.config.js',
+    'src/payload.config.ts',
+    'src/payload.config.js'
+];
 /**
- * Find the Payload config file using Payload's built-in finder
- * Changes to project directory temporarily and restores afterward
+ * Find the Payload config file using Payload's built-in finder when available,
+ * with fallback to simple file search for npx environments where payload isn't installed.
  *
  * @param projectPath - Absolute path to project directory
  * @returns Absolute path to config file, or null if not found
  */ export async function findPayloadConfig(projectPath) {
+    // First, try using Payload's official config finder (if payload is installed)
+    const configFromPayload = await findConfigWithPayload(projectPath);
+    if (configFromPayload) {
+        return configFromPayload;
+    }
+    // Fallback: Simple file search for standard config locations
+    // This works when running via npx before payload is installed
+    log.debug('Payload not available, using fallback config finder');
+    return findConfigFallback(projectPath);
+}
+/**
+ * Try to find config using Payload's findConfig function.
+ * Returns null if payload is not installed (dynamic import fails).
+ */ async function findConfigWithPayload(projectPath) {
     const originalCwd = process.cwd();
     try {
+        // Dynamic import - will fail gracefully if payload is not installed
+        const { findConfig } = await import('payload/node');
         // findConfig requires being in the project directory
         process.chdir(projectPath);
-        // Use Payload's official config finder
         const configPath = findConfig();
-        // Wrap in Promise.resolve to satisfy async requirement
-        return await Promise.resolve(configPath || null);
-    } catch  {
-        // Config not found or error occurred
+        return configPath || null;
+    } catch (error) {
+        // payload not installed or other error - return null to use fallback
+        log.debug(`Could not use Payload findConfig: ${error instanceof Error ? error.message : 'unknown'}`);
         return null;
     } finally{
-        // Always restore original working directory
         process.chdir(originalCwd);
     }
 }
+/**
+ * Fallback config finder that checks standard locations.
+ * Used when payload is not installed (e.g., running via npx).
+ */ async function findConfigFallback(projectPath) {
+    for (const configFile of CONFIG_FILES){
+        const fullPath = path.join(projectPath, configFile);
+        try {
+            await fs.access(fullPath);
+            log.debug(`Found config at: ${fullPath}`);
+            return fullPath;
+        } catch  {
+        // File doesn't exist, try next
+        }
+    }
+    return null;
+}
 
 //# sourceMappingURL=payload-config-finder.js.map

package/dist/utils/payload-config-modifier.d.ts

@@ -15,5 +15,5 @@ export declare function ensurePayloadFigmaConfig(projectPath: string, packageMan
 /**
  * Display manual configuration instructions
  */
-export declare function displayManualInstructions(reason: string): void;
+export declare function displayManualInstructions(reason: string, packageManager?: PackageManager): void;
 //# sourceMappingURL=payload-config-modifier.d.ts.map

package/dist/utils/payload-config-modifier.js

@@ -1,11 +1,13 @@
 import pc from 'picocolors';
-import { Project } from 'ts-morph';
+import { IndentationText, Project } from 'ts-morph';
 import { formatFile } from './formatter.js';
 import * as log from './log.js';
+import { getAddCommand, getRunCommand } from './package-manager.js';
 import { addFigmaProperty, applyModifications, detectRequiredChanges } from './payload-config-ast.js';
 import { findPayloadConfig } from './payload-config-finder.js';
-import { checkPackageInstalled, installPackage, uninstallPackage } from './payload-package-check.js';
+import { checkPackageInstalled, getPayloadVersion, installPackage, uninstallPackage } from './payload-package-check.js';
 import { runTypeScriptCheck } from './typescript-validator.js';
+import { getOwnVersion } from './version-check.js';
 /**
  * Main orchestrator for payload config modification
  * Checks package, detects needed changes, applies modifications
@@ -27,12 +29,16 @@ import { runTypeScriptCheck } from './typescript-validator.js';
             };
         }
         log.debug(`Found config file: ${configPath}`);
+        // Get payload version to pin @payloadcms/* dependencies
+        const payloadVersion = await getPayloadVersion(projectPath);
+        log.debug(`Detected payload version: ${payloadVersion || 'unknown'}`);
         // 2. Check/install @payloadcms/figma package
         const isInstalled = await checkPackageInstalled(projectPath, '@payloadcms/figma');
         if (!isInstalled) {
             log.debug('@payloadcms/figma not installed, attempting installation...');
             try {
-                await installPackage(projectPath, '@payloadcms/figma', packageManager);
+                const figmaVersion = await getOwnVersion();
+                await installPackage(projectPath, '@payloadcms/figma', packageManager, figmaVersion);
                 changes.push('Installed @payloadcms/figma');
                 modified = true;
                 log.debug('@payloadcms/figma installed successfully');
@@ -51,6 +57,10 @@ import { runTypeScriptCheck } from './typescript-validator.js';
         // 3. Parse config with ts-morph
         log.debug('Parsing config file with ts-morph...');
         const project = new Project({
+            manipulationSettings: {
+                indentationText: IndentationText.TwoSpaces,
+                useTrailingCommas: true
+            },
             skipAddingFilesFromTsConfig: true
         });
         const sourceFile = project.addSourceFileAtPath(configPath);
@@ -101,15 +111,64 @@ import { runTypeScriptCheck } from './typescript-validator.js';
         }
         // Save file if any modifications were made
         if (modified) {
+            sourceFile.formatText({
+                indentSize: 2,
+                tabSize: 2
+            });
             await sourceFile.save();
             log.debug('Config file saved');
-            // 7. Uninstall orphaned packages
+            // 7. Handle package management
             const packagesToUninstall = [];
+            // Uninstall db adapter (buildFigmaConfig provides its own)
             if (detection.dbProperty) {
                 packagesToUninstall.push(detection.dbProperty.importSource);
             }
-            if (detection.editorProperty?.isDefault) {
-                packagesToUninstall.push(detection.editorProperty.importSource);
+            // Uninstall sharp (Figma infrastructure handles image processing)
+            if (detection.sharpProperty) {
+                packagesToUninstall.push('sharp');
+            }
+            // Ensure lexical is installed if user doesn't have a custom editor
+            // (buildFigmaConfig uses lexicalEditor() as default)
+            if (!detection.editorProperty) {
+                log.debug('No editor property detected - will ensure lexical is installed for default editor');
+            } else if (detection.editorProperty.isDefault) {
+                log.debug('Default lexicalEditor() detected - will ensure lexical is installed');
+            } else {
+                log.debug(`Custom editor detected (${detection.editorProperty.importSource}) - skipping lexical installation`);
+            }
+            if (!detection.editorProperty || detection.editorProperty.isDefault) {
+                log.debug('Checking if @payloadcms/richtext-lexical is installed...');
+                const hasLexical = await checkPackageInstalled(projectPath, '@payloadcms/richtext-lexical');
+                if (!hasLexical) {
+                    log.debug('@payloadcms/richtext-lexical not found, installing...');
+                    try {
+                        await installPackage(projectPath, '@payloadcms/richtext-lexical', packageManager, payloadVersion);
+                        changes.push('Installed @payloadcms/richtext-lexical (default editor)');
+                        log.debug('Successfully installed @payloadcms/richtext-lexical');
+                    } catch (error) {
+                        log.debug(`Failed to install @payloadcms/richtext-lexical: ${error instanceof Error ? error.message : 'Unknown error'}`);
+                        // Don't fail on install error - user can install manually if needed
+                        warnings.push('Could not install @payloadcms/richtext-lexical - you may need to install it manually');
+                    }
+                } else {
+                    log.debug('@payloadcms/richtext-lexical already installed, skipping');
+                }
+            }
+            // Ensure cloud-storage is installed (required peer dependency for buildFigmaConfig)
+            log.debug('Checking if @payloadcms/plugin-cloud-storage is installed...');
+            const hasCloudStorage = await checkPackageInstalled(projectPath, '@payloadcms/plugin-cloud-storage');
+            if (!hasCloudStorage) {
+                log.debug('@payloadcms/plugin-cloud-storage not found, installing...');
+                try {
+                    await installPackage(projectPath, '@payloadcms/plugin-cloud-storage', packageManager, payloadVersion);
+                    changes.push('Installed @payloadcms/plugin-cloud-storage');
+                    log.debug('Successfully installed @payloadcms/plugin-cloud-storage');
+                } catch (error) {
+                    log.debug(`Failed to install @payloadcms/plugin-cloud-storage: ${error instanceof Error ? error.message : 'Unknown error'}`);
+                    warnings.push('Could not install @payloadcms/plugin-cloud-storage - you may need to install it manually');
+                }
+            } else {
+                log.debug('@payloadcms/plugin-cloud-storage already installed, skipping');
             }
             if (packagesToUninstall.length > 0) {
                 log.debug(`Uninstalling ${packagesToUninstall.length} orphaned packages...`);
@@ -135,7 +194,7 @@ import { runTypeScriptCheck } from './typescript-validator.js';
             log.debug('Running TypeScript validation...');
             const tsResult = await runTypeScriptCheck(projectPath, packageManager);
             if (!tsResult.success && tsResult.errors.length > 0) {
-                warnings.push("TypeScript validation found issues - run 'pnpm build' for details");
+                warnings.push(`TypeScript validation found issues - run '${getRunCommand(packageManager)} build' for details`);
                 log.debug(`TypeScript validation found ${tsResult.errors.length} issues`);
             }
         } else {
@@ -163,10 +222,10 @@ import { runTypeScriptCheck } from './typescript-validator.js';
 }
 /**
  * Display manual configuration instructions
- */ export function displayManualInstructions(reason) {
+ */ export function displayManualInstructions(reason, packageManager = 'npm') {
     const leftLineWrap = (message)=>{
         // Add '┌  ' prefix to first line, '│  ' to subsequent lines, and '└  ' to last line
-        return message.split('\n').map((line, index, arr)=>{
+        return message.split(/\r?\n/).map((line, index, arr)=>{
             if (index === 0) {
                 return `${pc.dim('┌  ')}${line}`;
             } else if (index === arr.length - 1) {
@@ -185,7 +244,7 @@ ${pc.bold('Required changes:')}
 
 1. Replace buildConfig import:
    ${pc.dim('- FROM: ')}${pc.cyan("import { buildConfig } from 'payload'")}
-   ${pc.dim('- TO:   ')}${pc.cyan("import { buildConfig } from '@payloadcms/figma'")}
+   ${pc.dim('- TO:   ')}${pc.cyan("import { buildFigmaConfig } from '@payloadcms/figma'")}
 
 2. Remove these properties from buildConfig():
    • db
@@ -193,7 +252,7 @@ ${pc.bold('Required changes:')}
    • editor (if using default lexicalEditor())
 
 3. Install package:
-   ${pc.cyan('pnpm add @payloadcms/figma')}
+   ${pc.cyan(`${getAddCommand(packageManager)} @payloadcms/figma`)}
 
 Then run: ${pc.cyan('npx @payloadcms/figma init')}`);
     // eslint-disable-next-line no-console

package/dist/utils/payload-package-check.d.ts

@@ -3,13 +3,24 @@ import type { PackageManager } from './package-manager.js';
  * Check if a package is installed in dependencies (not devDependencies)
  */
 export declare function checkPackageInstalled(projectPath: string, packageName: string): Promise<boolean>;
+/**
+ * Get the payload version from project's package.json (without range specifiers)
+ * Returns the clean version number (e.g., "3.71.1") or undefined if not found
+ */
+export declare function getPayloadVersion(projectPath: string): Promise<string | undefined>;
 /**
  * Install a package as a production dependency
+ * @param version - Version to install (without caret). Defaults to 'latest'.
  */
-export declare function installPackage(projectPath: string, packageName: string, packageManager: PackageManager): Promise<void>;
+export declare function installPackage(projectPath: string, packageName: string, packageManager: PackageManager, version?: string): Promise<void>;
 /**
  * Uninstall a package
  * Does not throw on failure - orphaned package is better than broken config
  */
 export declare function uninstallPackage(projectPath: string, packageName: string, packageManager: PackageManager): Promise<void>;
+/**
+ * Run an npm script from package.json
+ * Does not throw on failure - logs warning and continues
+ */
+export declare function runScript(projectPath: string, scriptName: string, packageManager: PackageManager): Promise<boolean>;
 //# sourceMappingURL=payload-package-check.d.ts.map

package/dist/utils/payload-package-check.js

@@ -1,4 +1,4 @@
-import { spawn } from 'child_process';
+import spawn from 'cross-spawn';
 import fs from 'fs/promises';
 import path from 'path';
 import * as log from './log.js';
@@ -18,14 +18,34 @@ import * as log from './log.js';
         return false;
     }
 }
+/**
+ * Get the payload version from project's package.json (without range specifiers)
+ * Returns the clean version number (e.g., "3.71.1") or undefined if not found
+ */ export async function getPayloadVersion(projectPath) {
+    try {
+        const pkgJsonPath = path.join(projectPath, 'package.json');
+        const pkgJsonContent = await fs.readFile(pkgJsonPath, 'utf-8');
+        const pkgJson = JSON.parse(pkgJsonContent);
+        const rawVersion = pkgJson.dependencies?.payload || pkgJson.devDependencies?.payload;
+        if (!rawVersion) {
+            return undefined;
+        }
+        // Strip range specifiers (^, ~, >=, etc.) to get clean version
+        return rawVersion.replace(/^[\^~>=<]+/, '');
+    } catch  {
+        return undefined;
+    }
+}
 /**
  * Install a package as a production dependency
- */ export async function installPackage(projectPath, packageName, packageManager) {
+ * @param version - Version to install (without caret). Defaults to 'latest'.
+ */ export async function installPackage(projectPath, packageName, packageManager, version = 'latest') {
     return new Promise((resolve, reject)=>{
         const command = packageManager;
+        const packageSpec = packageName.endsWith('.tgz') ? packageName : `${packageName}@${version}`;
         const args = [
             'add',
-            packageName
+            packageSpec
         ];
         // npm uses 'install' instead of 'add'
         if (packageManager === 'npm') {
@@ -35,7 +55,6 @@ import * as log from './log.js';
         let stderr = '';
         const child = spawn(command, args, {
             cwd: projectPath,
-            shell: true,
             stdio: 'pipe'
         });
         // Capture stderr for debug logging
@@ -79,7 +98,6 @@ import * as log from './log.js';
         log.debug(`Running: ${command} ${args.join(' ')} in ${projectPath}`);
         const child = spawn(command, args, {
             cwd: projectPath,
-            shell: true,
             stdio: 'pipe'
         });
         child.on('close', (code)=>{
@@ -93,5 +111,45 @@ import * as log from './log.js';
         });
     });
 }
+/**
+ * Run an npm script from package.json
+ * Does not throw on failure - logs warning and continues
+ */ export async function runScript(projectPath, scriptName, packageManager) {
+    return new Promise((resolve)=>{
+        const command = packageManager;
+        // yarn doesn't need 'run' prefix, but it works with it too
+        const args = [
+            'run',
+            scriptName
+        ];
+        log.debug(`Running script: ${command} ${args.join(' ')} in ${projectPath}`);
+        let stderr = '';
+        const child = spawn(command, args, {
+            cwd: projectPath,
+            stdio: 'pipe'
+        });
+        if (child.stderr) {
+            child.stderr.on('data', (data)=>{
+                stderr += data.toString();
+            });
+        }
+        child.on('error', (error)=>{
+            log.debug(`Failed to run script ${scriptName}: ${error.message}`);
+            resolve(false);
+        });
+        child.on('close', (code)=>{
+            if (code === 0) {
+                log.debug(`Successfully ran script: ${scriptName}`);
+                resolve(true);
+            } else {
+                log.debug(`Script ${scriptName} failed (exit code: ${code})`);
+                if (stderr) {
+                    log.debug(`stderr: ${stderr}`);
+                }
+                resolve(false);
+            }
+        });
+    });
+}
 
 //# sourceMappingURL=payload-package-check.js.map

package/dist/utils/project.d.ts

@@ -2,6 +2,7 @@
  * Project detection and scaffolding utilities
  */
 import type { ProjectInfo } from '../types/config.js';
+import type { PackageManager } from './package-manager.js';
 /**
  * Detect if current directory has a Payload project
  *
@@ -22,7 +23,7 @@ export declare function validatePayloadVersion(version: string): boolean;
  * @param projectPath - Path where to create the project
  * @param projectName - Name for the project
  */
-export declare function scaffoldProject(projectPath: string, projectName: string): Promise<void>;
+export declare function scaffoldProject(projectPath: string, projectName: string, packageManager?: PackageManager): Promise<void>;
 /**
  * Initialize git repository after all setup is complete
  *
@@ -38,7 +39,7 @@ export declare function initializeGitRepo(projectPath: string): void;
  * @param packageManager - Package manager to use
  * @returns Promise that resolves when installation completes
  */
-export declare function installDependencies(projectPath: string, packageManager?: 'npm' | 'pnpm' | 'yarn'): Promise<void>;
+export declare function installDependencies(projectPath: string, packageManager?: PackageManager): Promise<void>;
 /**
  * Check if required dependencies are installed
  *