@sfdc-webapps/cli 1.0.2

package/dist/commands/new-app-feature.js

@@ -0,0 +1,166 @@
+import { join } from 'path';
+import * as logger from '../utils/logger.js';
+import { getMonorepoRoot } from '../utils/paths.js';
+import { cpSync, existsSync, readFileSync, renameSync, rmSync, statSync, writeFileSync } from 'fs';
+import { validateAppOrFeatureName, ValidationError } from '../utils/validation.js';
+/**
+ * Create a new app or feature from the base-reference-app or base-feature template
+ *
+ * @param appOrFeatureName - Name of the app or feature (without "app-" or "feature-" prefix)
+ */
+export async function newAppOrFeatureCommand(appOrFeatureName, appOrFeatureType) {
+    let targetDir;
+    try {
+        logger.heading(`Creating new ${appOrFeatureType}: ${appOrFeatureName}`);
+        // Step 1: Validate feature name format
+        logger.info(`Validating ${appOrFeatureType} name...`);
+        validateAppOrFeatureName(appOrFeatureName);
+        // Step 2: Generate full feature name with prefix
+        const fullFeatureName = appOrFeatureName.startsWith(`${appOrFeatureType}-`)
+            ? appOrFeatureName
+            : `${appOrFeatureType}-${appOrFeatureName}`;
+        const rawName = fullFeatureName.replace(/^${appOrFeatureType}-/, '');
+        logger.success(`${appOrFeatureType} name validated: ${fullFeatureName}`);
+        // Step 3: Check if feature already exists
+        logger.info(`Checking if ${appOrFeatureType} already exists...`);
+        if (checkAppFeatureExists(fullFeatureName)) {
+            throw new ValidationError(`${appOrFeatureType} '${fullFeatureName}' already exists at packages/${fullFeatureName}.\nPlease choose a different name or remove the existing ${appOrFeatureType}.`);
+        }
+        logger.success('Feature name available');
+        // Step 4: Validate base feature template
+        logger.info('Validating base feature template...');
+        const baseAppOrFeaturePath = validateBaseAppOrFeature(appOrFeatureType);
+        logger.success('Base feature template validated');
+        // Step 5: Create target directory and copy
+        const monorepoRoot = getMonorepoRoot();
+        targetDir = join(monorepoRoot, 'packages', fullFeatureName);
+        logger.info(`Copying base feature template to packages/${fullFeatureName}...`);
+        cpSync(baseAppOrFeaturePath, targetDir, { recursive: true });
+        logger.success('Template copied');
+        // Step 6: Rename webApplications directory
+        logger.info('Renaming template directories...');
+        const templateName = appOrFeatureType === 'app' ? 'reference-app' : 'feature';
+        const oldWebAppPath = join(targetDir, `template/digitalExperiences/webApplications/base-${templateName}`);
+        const newWebAppPath = join(targetDir, 'template/digitalExperiences/webApplications', rawName);
+        if (existsSync(oldWebAppPath)) {
+            renameSync(oldWebAppPath, newWebAppPath);
+            logger.success(`Renamed: base-${templateName} → ${rawName}`);
+        }
+        // Step 7: Update package.json
+        logger.info('Updating package.json...');
+        const packageJsonPath = join(targetDir, 'package.json');
+        const packageJson = JSON.parse(readFileSync(packageJsonPath, 'utf-8'));
+        packageJson.name = fullFeatureName;
+        // Update scripts to reference new feature name
+        // Replace both "base-feature" and any existing "feature-*" patterns
+        const regexPattern = new RegExp(`base-${templateName}`, 'g');
+        if (packageJson.scripts) {
+            if (packageJson.scripts.dev) {
+                packageJson.scripts.dev = packageJson.scripts.dev
+                    .replace(regexPattern, fullFeatureName);
+            }
+            if (packageJson.scripts['test-patch']) {
+                packageJson.scripts['test-patch'] = packageJson.scripts['test-patch']
+                    .replace(regexPattern, fullFeatureName);
+            }
+            if (packageJson.scripts.watch) {
+                packageJson.scripts.watch = packageJson.scripts.watch
+                    .replace(regexPattern, fullFeatureName);
+            }
+        }
+        writeFileSync(packageJsonPath, JSON.stringify(packageJson, null, 2) + '\n');
+        logger.success('package.json updated');
+        // Step 8: Update tsconfig.app.json
+        logger.info('Updating tsconfig.app.json...');
+        const tsconfigAppPath = join(targetDir, 'tsconfig.app.json');
+        let tsconfigContent = readFileSync(tsconfigAppPath, 'utf-8');
+        // Replace the include path (handles both single and array format)
+        // tsconfigContent = tsconfigContent.replace(
+        //   /"include":\s*\[.*?\]/s,
+        //   `"include": ["template/digitalExperiences/webApplications/${rawName}"]`
+        // );
+        writeFileSync(tsconfigAppPath, tsconfigContent);
+        logger.success('tsconfig.app.json updated');
+        // Step 9: Success message
+        logger.heading('\n✓ Success');
+        logger.success(`Created feature: packages/${fullFeatureName}`);
+        logger.info('\nNext steps:');
+        logger.info(`  1. cd packages/${fullFeatureName}`);
+        logger.info('  2. Customize template files in template/ directory');
+        logger.info(`  3. Update feature.ts with ${appOrFeatureType} configuration`);
+        logger.info(`  4. Test with: yarn apply-patches packages/${fullFeatureName} packages/base-react-app test-app`);
+    }
+    catch (err) {
+        // Cleanup on failure
+        if (targetDir && existsSync(targetDir)) {
+            logger.info(`\nCleaning up partially created ${appOrFeatureType}...`);
+            rmSync(targetDir, { recursive: true, force: true });
+            logger.info('Cleanup complete');
+        }
+        // Handle different error types
+        if (err instanceof Error) {
+            // Handle permission errors
+            if (err.message.includes('EACCES')) {
+                logger.error(`\n✗ Permission denied. You do not have permission to create ${appOrFeatureType}s in the packages directory.`);
+                logger.info('Try running with appropriate permissions or check directory ownership.');
+                throw new ValidationError('Permission denied');
+            }
+            // Handle disk space errors
+            if (err.message.includes('ENOSPC')) {
+                logger.error(`\n✗ Not enough disk space to create ${appOrFeatureType}.`);
+                logger.info('Free up some disk space and try again.');
+                throw new ValidationError('Insufficient disk space');
+            }
+        }
+        // Log error if not already logged
+        const errorMessage = err instanceof Error ? err.message : String(err);
+        const skipLogging = err instanceof ValidationError;
+        if (!skipLogging) {
+            logger.error(`\n✗ Failed to create ${appOrFeatureType}: ${errorMessage}`);
+        }
+        else {
+            logger.error(`\n✗ ${errorMessage}`);
+        }
+        throw err;
+    }
+}
+/**
+ * Check if a feature already exists in the packages directory
+ */
+function checkAppFeatureExists(appOrFeatureName) {
+    const monorepoRoot = getMonorepoRoot();
+    const appOrFeaturePath = join(monorepoRoot, 'packages', appOrFeatureName);
+    return existsSync(appOrFeaturePath);
+}
+/**
+ * Validate that the base-feature and base-reference-app template exists and is valid
+ * Returns the absolute path to the base-feature or base-reference-app directory
+ */
+function validateBaseAppOrFeature(appOrFeatureType) {
+    const monorepoRoot = getMonorepoRoot();
+    const templateName = appOrFeatureType === 'app' ? 'reference-app' : 'feature';
+    const baseAppOrFeaturePath = join(monorepoRoot, `packages/base-${templateName}`);
+    if (!existsSync(baseAppOrFeaturePath)) {
+        throw new ValidationError(`Base ${templateName} template not found at packages/base-${templateName}.\nCannot create new ${appOrFeatureType}.`);
+    }
+    if (!statSync(baseAppOrFeaturePath).isDirectory()) {
+        throw new ValidationError(`Base ${templateName} template at packages/base-${templateName} is not a directory.`);
+    }
+    // Check critical files exist
+    const requiredFiles = [
+        'package.json',
+        'feature.ts',
+        'tsconfig.app.json',
+        'tsconfig.json',
+        'tsconfig.node.json',
+        'template'
+    ];
+    for (const file of requiredFiles) {
+        const filePath = join(baseAppOrFeaturePath, file);
+        if (!existsSync(filePath)) {
+            throw new ValidationError(`Base ${appOrFeatureType} template is incomplete.\nMissing required file: ${file}`);
+        }
+    }
+    return baseAppOrFeaturePath;
+}
+//# sourceMappingURL=new-app-feature.js.map

package/dist/commands/new-app-feature.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"new-app-feature.js","sourceRoot":"","sources":["../../src/commands/new-app-feature.ts"],"names":[],"mappings":"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"}

package/dist/commands/new-app.d.ts

@@ -0,0 +1 @@
+//# sourceMappingURL=new-app.d.ts.map

package/dist/commands/new-app.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"new-app.d.ts","sourceRoot":"","sources":["../../src/commands/new-app.ts"],"names":[],"mappings":""}

package/dist/commands/new-app.js

@@ -0,0 +1,2 @@
+"use strict";
+//# sourceMappingURL=new-app.js.map

package/dist/commands/new-app.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"new-app.js","sourceRoot":"","sources":["../../src/commands/new-app.ts"],"names":[],"mappings":""}

package/dist/commands/watch-patches.d.ts

@@ -0,0 +1,6 @@
+export declare function watchPatchesCommand(featurePath: string, appPath: string, targetDirName: string, options?: {
+    clean?: boolean;
+}): Promise<{
+    shutdown: () => Promise<void>;
+}>;
+//# sourceMappingURL=watch-patches.d.ts.map

package/dist/commands/watch-patches.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"watch-patches.d.ts","sourceRoot":"","sources":["../../src/commands/watch-patches.ts"],"names":[],"mappings":"AASA,wBAAsB,mBAAmB,CACvC,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,EACf,aAAa,EAAE,MAAM,EACrB,OAAO,GAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAA;CAAO,GAChC,OAAO,CAAC;IAAE,QAAQ,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CAAE,CAAC,CA8J5C"}

package/dist/commands/watch-patches.js

@@ -0,0 +1,152 @@
+import { watch } from 'turbowatch';
+import { join, relative, basename } from 'path';
+import { existsSync, cpSync, rmSync } from 'fs';
+import { applyPatchesCommand } from './apply-patches.js';
+import { validateAndResolveFeaturePath, validateAndResolveAppPath } from '../utils/validation.js';
+import { getMonorepoRoot, translatePathToBaseApp } from '../utils/paths.js';
+import { loadFeature } from '../core/patch-loader.js';
+import * as logger from '../utils/logger.js';
+export async function watchPatchesCommand(featurePath, appPath, targetDirName, options = {}) {
+    try {
+        logger.heading(`Starting watch mode for ${featurePath}...`);
+        // Step 1: Validate inputs
+        logger.info('Validating feature and app path...');
+        const featureDir = validateAndResolveFeaturePath(featurePath);
+        validateAndResolveAppPath(appPath);
+        logger.success('Validation passed');
+        // Step 2: Apply feature initially (with dependencies)
+        logger.info('Applying feature initially...');
+        await applyPatchesCommand(featurePath, appPath, {
+            targetDirName: targetDirName,
+            skipDependencyChanges: false,
+            clean: options.clean
+        });
+        logger.success('Initial feature applied successfully\n');
+        // Step 3: Load feature config to get template directory
+        const { templateDir } = await loadFeature(featureDir);
+        const watchPath = join(featureDir, templateDir);
+        // Resolve base app and target directory paths
+        const baseAppPath = validateAndResolveAppPath(appPath);
+        const monorepoRoot = getMonorepoRoot();
+        const targetDir = targetDirName ? join(monorepoRoot, targetDirName) : baseAppPath;
+        logger.info(`👁  Watching ${watchPath} for changes...`);
+        logger.info('   Press Ctrl+C to stop watching\n');
+        // Create feature application function
+        const applyPatches = async (changedPath) => {
+            try {
+                const relativePath = changedPath.replace(watchPath + '/', '');
+                logger.info(`📝 Change detected in ${relativePath}`);
+                logger.info('⟳  Re-applying feature...\n');
+                const startTime = Date.now();
+                await applyPatchesCommand(featurePath, appPath, {
+                    targetDirName: targetDirName,
+                    skipDependencyChanges: true,
+                    clean: options.clean
+                });
+                const elapsed = ((Date.now() - startTime) / 1000).toFixed(1);
+                logger.success(`\n✓ Feature re-applied successfully (${elapsed}s)`);
+                logger.info('👁  Watching for changes...\n');
+            }
+            catch (err) {
+                const errorMessage = err instanceof Error ? err.message : String(err);
+                // Only log if not already handled
+                const skipLogging = [
+                    'Path conflict - cannot proceed',
+                    'Delete validation failed - cannot proceed',
+                    'Inherit validation failed - cannot proceed',
+                    'Prepend validation failed - cannot proceed',
+                    'Append validation failed - cannot proceed',
+                    'Route deletion failed - cannot proceed'
+                ].includes(errorMessage);
+                if (!skipLogging) {
+                    logger.error(`\n✗ Failed to apply feature: ${errorMessage}`);
+                }
+                logger.info('   Fix the issue and save again to retry');
+                logger.info('👁  Watching for changes...\n');
+            }
+        };
+        // Handle file deletion - restore base app file if it exists, otherwise delete
+        const handleDeletion = async (deletedPath) => {
+            try {
+                const relativePath = deletedPath.replace(watchPath + '/', '');
+                logger.info(`🗑  Deletion detected in ${relativePath}`);
+                // Calculate paths
+                const relativeFromFeature = relative(watchPath, deletedPath);
+                const featureName = basename(featurePath);
+                // Translate the path to the base app structure
+                const translatedPath = translatePathToBaseApp(relativeFromFeature, featureName, baseAppPath);
+                const targetFilePath = join(targetDir, translatedPath);
+                const baseFilePath = join(baseAppPath, translatedPath);
+                // Check if file exists in base app
+                if (existsSync(baseFilePath)) {
+                    // Restore base app version
+                    cpSync(baseFilePath, targetFilePath);
+                    logger.success(`✓ Restored base app version of ${translatedPath}`);
+                }
+                else {
+                    // No base version, delete from target
+                    if (existsSync(targetFilePath)) {
+                        rmSync(targetFilePath);
+                        logger.success(`✓ Deleted ${translatedPath}`);
+                    }
+                }
+                logger.info('👁  Watching for changes...\n');
+            }
+            catch (err) {
+                logger.error(`\n✗ Failed to handle deletion: ${err instanceof Error ? err.message : String(err)}`);
+                logger.info('   Will retry on next file change');
+                logger.info('👁  Watching for changes...\n');
+            }
+        };
+        // Set up turbowatch watcher
+        const controller = await watch({
+            project: watchPath,
+            debounce: {
+                wait: 500
+            },
+            triggers: [
+                {
+                    expression: ['anyof', ['match', '*.tsx', 'basename'], ['match', '*.ts', 'basename'], ['match', '*.css', 'basename']],
+                    name: 'source-files',
+                    onChange: async ({ files }) => {
+                        for (const file of files) {
+                            // Check if file still exists to detect deletions
+                            if (!existsSync(file.name)) {
+                                await handleDeletion(file.name);
+                            }
+                            await applyPatches(file.name);
+                        }
+                    }
+                }
+            ]
+        });
+        // Handle graceful shutdown
+        const cleanup = async () => {
+            logger.info('\n🛑 Stopping watcher...');
+            await controller.shutdown();
+            logger.success('✓ Watch mode stopped');
+            process.exit(0);
+        };
+        process.on('SIGINT', cleanup);
+        process.on('SIGTERM', cleanup);
+        // Return controller for tests to use
+        return controller;
+    }
+    catch (err) {
+        // Only log error if it's not already been logged
+        const errorMessage = err instanceof Error ? err.message : String(err);
+        const skipLogging = [
+            'Path conflict - cannot proceed',
+            'Delete validation failed - cannot proceed',
+            'Inherit validation failed - cannot proceed',
+            'Prepend validation failed - cannot proceed',
+            'Append validation failed - cannot proceed',
+            'Route deletion failed - cannot proceed'
+        ].includes(errorMessage);
+        if (!skipLogging) {
+            logger.error(`\nWatch mode failed: ${errorMessage}`);
+        }
+        throw err;
+    }
+}
+//# sourceMappingURL=watch-patches.js.map

package/dist/commands/watch-patches.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"watch-patches.js","sourceRoot":"","sources":["../../src/commands/watch-patches.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAoB,MAAM,YAAY,CAAC;AACrD,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,MAAM,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,IAAI,CAAC;AAChD,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,6BAA6B,EAAE,yBAAyB,EAAE,MAAM,wBAAwB,CAAC;AAClG,OAAO,EAAE,eAAe,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAC5E,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,KAAK,MAAM,MAAM,oBAAoB,CAAC;AAE7C,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,WAAmB,EACnB,OAAe,EACf,aAAqB,EACrB,UAA+B,EAAE;IAEjC,IAAI,CAAC;QACH,MAAM,CAAC,OAAO,CAAC,2BAA2B,WAAW,KAAK,CAAC,CAAC;QAE5D,0BAA0B;QAC1B,MAAM,CAAC,IAAI,CAAC,oCAAoC,CAAC,CAAC;QAClD,MAAM,UAAU,GAAG,6BAA6B,CAAC,WAAW,CAAC,CAAC;QAC9D,yBAAyB,CAAC,OAAO,CAAC,CAAC;QACnC,MAAM,CAAC,OAAO,CAAC,mBAAmB,CAAC,CAAC;QAEpC,sDAAsD;QACtD,MAAM,CAAC,IAAI,CAAC,+BAA+B,CAAC,CAAC;QAC7C,MAAM,mBAAmB,CAAC,WAAW,EAAE,OAAO,EAAE;YAC9C,aAAa,EAAE,aAAa;YAC5B,qBAAqB,EAAE,KAAK;YAC5B,KAAK,EAAE,OAAO,CAAC,KAAK;SACrB,CAAC,CAAC;QACH,MAAM,CAAC,OAAO,CAAC,wCAAwC,CAAC,CAAC;QAEzD,wDAAwD;QACxD,MAAM,EAAE,WAAW,EAAE,GAAG,MAAM,WAAW,CAAC,UAAU,CAAC,CAAC;QACtD,MAAM,SAAS,GAAG,IAAI,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC;QAEhD,8CAA8C;QAC9C,MAAM,WAAW,GAAG,yBAAyB,CAAC,OAAO,CAAC,CAAC;QACvD,MAAM,YAAY,GAAG,eAAe,EAAE,CAAC;QACvC,MAAM,SAAS,GAAG,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,YAAY,EAAE,aAAa,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC;QAElF,MAAM,CAAC,IAAI,CAAC,gBAAgB,SAAS,iBAAiB,CAAC,CAAC;QACxD,MAAM,CAAC,IAAI,CAAC,oCAAoC,CAAC,CAAC;QAElD,sCAAsC;QACtC,MAAM,YAAY,GAAG,KAAK,EAAE,WAAmB,EAAE,EAAE;YACjD,IAAI,CAAC;gBACH,MAAM,YAAY,GAAG,WAAW,CAAC,OAAO,CAAC,SAAS,GAAG,GAAG,EAAE,EAAE,CAAC,CAAC;gBAC9D,MAAM,CAAC,IAAI,CAAC,yBAAyB,YAAY,EAAE,CAAC,CAAC;gBACrD,MAAM,CAAC,IAAI,CAAC,6BAA6B,CAAC,CAAC;gBAE3C,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;gBAC7B,MAAM,mBAAmB,CAAC,WAAW,EAAE,OAAO,EAAE;oBAC9C,aAAa,EAAE,aAAa;oBAC5B,qBAAqB,EAAE,IAAI;oBAC3B,KAAK,EAAE,OAAO,CAAC,KAAK;iBACrB,CAAC,CAAC;gBACH,MAAM,OAAO,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;gBAE7D,MAAM,CAAC,OAAO,CAAC,wCAAwC,OAAO,IAAI,CAAC,CAAC;gBACpE,MAAM,CAAC,IAAI,CAAC,+BAA+B,CAAC,CAAC;YAC/C,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,MAAM,YAAY,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;gBACtE,kCAAkC;gBAClC,MAAM,WAAW,GAAG;oBAClB,gCAAgC;oBAChC,2CAA2C;oBAC3C,4CAA4C;oBAC5C,4CAA4C;oBAC5C,2CAA2C;oBAC3C,wCAAwC;iBACzC,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC;gBAEzB,IAAI,CAAC,WAAW,EAAE,CAAC;oBACjB,MAAM,CAAC,KAAK,CAAC,gCAAgC,YAAY,EAAE,CAAC,CAAC;gBAC/D,CAAC;gBACD,MAAM,CAAC,IAAI,CAAC,0CAA0C,CAAC,CAAC;gBACxD,MAAM,CAAC,IAAI,CAAC,+BAA+B,CAAC,CAAC;YAC/C,CAAC;QACH,CAAC,CAAC;QAEF,8EAA8E;QAC9E,MAAM,cAAc,GAAG,KAAK,EAAE,WAAmB,EAAE,EAAE;YACnD,IAAI,CAAC;gBACH,MAAM,YAAY,GAAG,WAAW,CAAC,OAAO,CAAC,SAAS,GAAG,GAAG,EAAE,EAAE,CAAC,CAAC;gBAC9D,MAAM,CAAC,IAAI,CAAC,4BAA4B,YAAY,EAAE,CAAC,CAAC;gBAExD,kBAAkB;gBAClB,MAAM,mBAAmB,GAAG,QAAQ,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;gBAC7D,MAAM,WAAW,GAAG,QAAQ,CAAC,WAAW,CAAC,CAAC;gBAE1C,+CAA+C;gBAC/C,MAAM,cAAc,GAAG,sBAAsB,CAAC,mBAAmB,EAAE,WAAW,EAAE,WAAW,CAAC,CAAC;gBAC7F,MAAM,cAAc,GAAG,IAAI,CAAC,SAAS,EAAE,cAAc,CAAC,CAAC;gBACvD,MAAM,YAAY,GAAG,IAAI,CAAC,WAAW,EAAE,cAAc,CAAC,CAAC;gBAEvD,mCAAmC;gBACnC,IAAI,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;oBAC7B,2BAA2B;oBAC3B,MAAM,CAAC,YAAY,EAAE,cAAc,CAAC,CAAC;oBACrC,MAAM,CAAC,OAAO,CAAC,kCAAkC,cAAc,EAAE,CAAC,CAAC;gBACrE,CAAC;qBAAM,CAAC;oBACN,sCAAsC;oBACtC,IAAI,UAAU,CAAC,cAAc,CAAC,EAAE,CAAC;wBAC/B,MAAM,CAAC,cAAc,CAAC,CAAC;wBACvB,MAAM,CAAC,OAAO,CAAC,aAAa,cAAc,EAAE,CAAC,CAAC;oBAChD,CAAC;gBACH,CAAC;gBAED,MAAM,CAAC,IAAI,CAAC,+BAA+B,CAAC,CAAC;YAC/C,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,MAAM,CAAC,KAAK,CAAC,kCAAkC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;gBACnG,MAAM,CAAC,IAAI,CAAC,mCAAmC,CAAC,CAAC;gBACjD,MAAM,CAAC,IAAI,CAAC,+BAA+B,CAAC,CAAC;YAC/C,CAAC;QACH,CAAC,CAAC;QAEF,4BAA4B;QAC5B,MAAM,UAAU,GAAG,MAAM,KAAK,CAAC;YAC7B,OAAO,EAAE,SAAS;YAClB,QAAQ,EAAE;gBACR,IAAI,EAAE,GAAG;aACV;YACD,QAAQ,EAAE;gBACR;oBACE,UAAU,EAAE,CAAC,OAAO,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC;oBACpH,IAAI,EAAE,cAAc;oBACpB,QAAQ,EAAE,KAAK,EAAE,EAAE,KAAK,EAAe,EAAE,EAAE;wBACzC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;4BACzB,iDAAiD;4BACjD,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;gCAC3B,MAAM,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;4BAClC,CAAC;4BACD,MAAM,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;wBAChC,CAAC;oBACH,CAAC;iBACF;aACF;SACF,CAAC,CAAC;QAEH,2BAA2B;QAC3B,MAAM,OAAO,GAAG,KAAK,IAAI,EAAE;YACzB,MAAM,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAC;YACxC,MAAM,UAAU,CAAC,QAAQ,EAAE,CAAC;YAC5B,MAAM,CAAC,OAAO,CAAC,sBAAsB,CAAC,CAAC;YACvC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC,CAAC;QAEF,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAC9B,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QAE/B,qCAAqC;QACrC,OAAO,UAAU,CAAC;IAEpB,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,iDAAiD;QACjD,MAAM,YAAY,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACtE,MAAM,WAAW,GAAG;YAClB,gCAAgC;YAChC,2CAA2C;YAC3C,4CAA4C;YAC5C,4CAA4C;YAC5C,2CAA2C;YAC3C,wCAAwC;SACzC,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC;QAEzB,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,MAAM,CAAC,KAAK,CAAC,wBAAwB,YAAY,EAAE,CAAC,CAAC;QACvD,CAAC;QACD,MAAM,GAAG,CAAC;IACZ,CAAC;AACH,CAAC"}

package/dist/core/dependency-resolver.d.ts

@@ -0,0 +1,40 @@
+import { type FeatureConfig } from './patch-loader.js';
+/**
+ * Represents a resolved feature with its configuration
+ */
+export type ResolvedFeature = {
+    featurePath: string;
+    featureDir: string;
+    config: FeatureConfig;
+};
+/**
+ * Result of dependency resolution
+ */
+export type DependencyResolutionResult = {
+    orderedFeatures: ResolvedFeature[];
+    dependencyGraph: Map<string, string[]>;
+};
+/**
+ * Base error for dependency resolution failures
+ */
+export declare class DependencyResolutionError extends Error {
+    constructor(message: string);
+}
+/**
+ * Error thrown when a circular dependency is detected
+ */
+export declare class CircularDependencyError extends DependencyResolutionError {
+    cycle: string[];
+    constructor(cycle: string[]);
+}
+/**
+ * Resolve all dependencies for a feature recursively
+ * Returns features in dependency order (dependencies first, main feature last)
+ *
+ * @param featurePath - Path to the main feature
+ * @returns Resolution result with ordered features and dependency graph
+ * @throws CircularDependencyError if circular dependencies are detected
+ * @throws DependencyResolutionError if a dependency cannot be loaded
+ */
+export declare function resolveDependencies(featurePath: string): Promise<DependencyResolutionResult>;
+//# sourceMappingURL=dependency-resolver.d.ts.map

package/dist/core/dependency-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dependency-resolver.d.ts","sourceRoot":"","sources":["../../src/core/dependency-resolver.ts"],"names":[],"mappings":"AAEA,OAAO,EAAe,KAAK,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAGpE;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,aAAa,CAAC;CACvB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,0BAA0B,GAAG;IACvC,eAAe,EAAE,eAAe,EAAE,CAAC;IACnC,eAAe,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;CACxC,CAAC;AAEF;;GAEG;AACH,qBAAa,yBAA0B,SAAQ,KAAK;gBACtC,OAAO,EAAE,MAAM;CAI5B;AAED;;GAEG;AACH,qBAAa,uBAAwB,SAAQ,yBAAyB;IACjD,KAAK,EAAE,MAAM,EAAE;gBAAf,KAAK,EAAE,MAAM,EAAE;CAKnC;AAyFD;;;;;;;;GAQG;AACH,wBAAsB,mBAAmB,CACvC,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,0BAA0B,CAAC,CAiCrC"}

package/dist/core/dependency-resolver.js

@@ -0,0 +1,122 @@
+import { join, isAbsolute } from 'path';
+import { validateAndResolveFeaturePath } from '../utils/validation.js';
+import { loadFeature } from './patch-loader.js';
+import { getMonorepoRoot } from '../utils/paths.js';
+/**
+ * Base error for dependency resolution failures
+ */
+export class DependencyResolutionError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'DependencyResolutionError';
+    }
+}
+/**
+ * Error thrown when a circular dependency is detected
+ */
+export class CircularDependencyError extends DependencyResolutionError {
+    cycle;
+    constructor(cycle) {
+        const cycleStr = cycle.join(' → ');
+        super(`Circular dependency detected:\n  ${cycleStr}\n\nPlease remove one of these dependencies to break the cycle.`);
+        this.cycle = cycle;
+        this.name = 'CircularDependencyError';
+    }
+}
+/**
+ * Normalize a feature path to an absolute path for consistent comparison
+ *
+ * @param featurePath - Relative or absolute feature path
+ * @returns Absolute path to the feature
+ */
+function normalizePath(featurePath) {
+    // If already absolute, return as-is
+    if (isAbsolute(featurePath)) {
+        return featurePath;
+    }
+    // If relative, resolve from monorepo root
+    return join(getMonorepoRoot(), featurePath);
+}
+/**
+ * Recursively resolve dependencies using depth-first search with post-order traversal
+ *
+ * @param featurePath - Path to the feature to resolve
+ * @param visited - Set of features currently being processed (for cycle detection)
+ * @param resolved - Set of features that have been fully processed
+ * @param result - Accumulator for ordered features
+ * @param dependencyGraph - Map of feature paths to their dependencies
+ * @param dependencyChain - Current chain of dependencies (for error messages)
+ */
+async function resolveDependenciesRecursive(featurePath, visited, resolved, result, dependencyGraph, dependencyChain) {
+    const normalizedPath = normalizePath(featurePath);
+    // Skip if already resolved (handles diamond dependencies)
+    if (resolved.has(normalizedPath)) {
+        return;
+    }
+    // Circular dependency detection
+    if (visited.has(normalizedPath)) {
+        const cycle = [...dependencyChain, featurePath];
+        throw new CircularDependencyError(cycle);
+    }
+    // Mark as visiting
+    visited.add(normalizedPath);
+    dependencyChain.push(featurePath);
+    try {
+        // Validate and load feature
+        const featureDir = validateAndResolveFeaturePath(featurePath);
+        const config = await loadFeature(featureDir);
+        // Store in dependency graph for debugging
+        dependencyGraph.set(normalizedPath, config.dependencies);
+        // Recursively resolve dependencies (depth-first)
+        for (const depPath of config.dependencies) {
+            await resolveDependenciesRecursive(depPath, visited, resolved, result, dependencyGraph, [...dependencyChain] // Pass copy for independent error messages
+            );
+        }
+        // Post-order: add after all dependencies are resolved
+        result.push({
+            featurePath,
+            featureDir,
+            config
+        });
+        // Mark as resolved
+        resolved.add(normalizedPath);
+    }
+    finally {
+        // Clean up visiting state
+        visited.delete(normalizedPath);
+        dependencyChain.pop();
+    }
+}
+/**
+ * Resolve all dependencies for a feature recursively
+ * Returns features in dependency order (dependencies first, main feature last)
+ *
+ * @param featurePath - Path to the main feature
+ * @returns Resolution result with ordered features and dependency graph
+ * @throws CircularDependencyError if circular dependencies are detected
+ * @throws DependencyResolutionError if a dependency cannot be loaded
+ */
+export async function resolveDependencies(featurePath) {
+    const visited = new Set();
+    const resolved = new Set();
+    const result = [];
+    const dependencyGraph = new Map();
+    const dependencyChain = [];
+    try {
+        await resolveDependenciesRecursive(featurePath, visited, resolved, result, dependencyGraph, dependencyChain);
+        return {
+            orderedFeatures: result,
+            dependencyGraph
+        };
+    }
+    catch (err) {
+        // Re-throw our custom errors as-is
+        if (err instanceof DependencyResolutionError) {
+            throw err;
+        }
+        // Wrap other errors
+        const message = err instanceof Error ? err.message : String(err);
+        throw new DependencyResolutionError(`Failed to resolve dependencies: ${message}`);
+    }
+}
+//# sourceMappingURL=dependency-resolver.js.map

package/dist/core/dependency-resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dependency-resolver.js","sourceRoot":"","sources":["../../src/core/dependency-resolver.ts"],"names":[],"mappings":"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"}

package/dist/core/file-operations.d.ts

@@ -0,0 +1,37 @@
+export declare class FileOperationError extends Error {
+    constructor(message: string);
+}
+/**
+ * Apply a file from patch to target, optionally merging with base
+ *
+ * @param patchFilePath - Full path to the patch file from the feature
+ * @param baseFilePath - Full path to the original base app file (used for merging)
+ * @param targetFilePath - Full path to where the result should be written
+ * @param relativeTargetPath - Relative path for logging (e.g. "src/routes.tsx")
+ * @param shouldMerge - If true, merges patch with base using route merge strategy
+ */
+export declare function applyFile(patchFilePath: string, baseFilePath: string, targetFilePath: string, relativeTargetPath: string, shouldMerge?: boolean): Promise<void>;
+/**
+ * Delete a file or directory from the target app
+ *
+ * @param targetFilePath - Full path to the file/directory to delete
+ * @param relativeTargetPath - Relative path for logging (e.g. "src/routes.tsx")
+ */
+export declare function deleteFile(targetFilePath: string, relativeTargetPath: string): Promise<void>;
+/**
+ * Prepend content from a feature file to the beginning of a target file
+ *
+ * @param featureFilePath - Full path to the feature file with content to prepend
+ * @param targetFilePath - Full path to the target file to prepend to
+ * @param relativeTargetPath - Relative path for logging (e.g. "src/styles/global.css")
+ */
+export declare function prependToFile(featureFilePath: string, targetFilePath: string, relativeTargetPath: string): Promise<void>;
+/**
+ * Append content from a feature file to the end of a target file
+ *
+ * @param featureFilePath - Full path to the feature file with content to append
+ * @param targetFilePath - Full path to the target file to append to
+ * @param relativeTargetPath - Relative path for logging (e.g. "src/styles/global.css")
+ */
+export declare function appendToFile(featureFilePath: string, targetFilePath: string, relativeTargetPath: string): Promise<void>;
+//# sourceMappingURL=file-operations.d.ts.map

package/dist/core/file-operations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-operations.d.ts","sourceRoot":"","sources":["../../src/core/file-operations.ts"],"names":[],"mappings":"AAOA,qBAAa,kBAAmB,SAAQ,KAAK;gBAC/B,OAAO,EAAE,MAAM;CAI5B;AA4CD;;;;;;;;GAQG;AACH,wBAAsB,SAAS,CAC7B,aAAa,EAAE,MAAM,EACrB,YAAY,EAAE,MAAM,EACpB,cAAc,EAAE,MAAM,EACtB,kBAAkB,EAAE,MAAM,EAC1B,WAAW,GAAE,OAAe,GAC3B,OAAO,CAAC,IAAI,CAAC,CA2Ef;AAED;;;;;GAKG;AACH,wBAAsB,UAAU,CAC9B,cAAc,EAAE,MAAM,EACtB,kBAAkB,EAAE,MAAM,GACzB,OAAO,CAAC,IAAI,CAAC,CAef;AAED;;;;;;GAMG;AACH,wBAAsB,aAAa,CACjC,eAAe,EAAE,MAAM,EACvB,cAAc,EAAE,MAAM,EACtB,kBAAkB,EAAE,MAAM,GACzB,OAAO,CAAC,IAAI,CAAC,CAiCf;AAED;;;;;;GAMG;AACH,wBAAsB,YAAY,CAChC,eAAe,EAAE,MAAM,EACvB,cAAc,EAAE,MAAM,EACtB,kBAAkB,EAAE,MAAM,GACzB,OAAO,CAAC,IAAI,CAAC,CAiCf"}