@salesforce/webapp-template-cli-experimental 1.3.3

package/dist/utils/path-mappings.d.ts

@@ -0,0 +1,94 @@
+/**
+ * Copyright (c) 2026, Salesforce, Inc.,
+ * All rights reserved.
+ * For full license text, see the LICENSE.txt file
+ */
+import { type PathMapping, type PathMappings } from "../types.js";
+/**
+ * Get default path mappings for a feature
+ * Maps webApp → webapplications/<featureName> (old format for path translation)
+ * Note: This still uses the old format because translatePathToTargetApp will convert it to SFDX format
+ *
+ * @param featureName - The name of the feature (e.g., 'feature-react-nav-menu')
+ * @returns Array containing the default path mapping
+ *
+ * @example
+ * getDefaultPathMappings('feature-nav')
+ * // Returns: [{ from: 'webApp', to: 'webapplications/feature-nav' }]
+ */
+export declare function getDefaultPathMappings(featureName: string): PathMapping[];
+/**
+ * Check if path mappings are enabled for a feature
+ * Default: true (enabled by default, opt-out)
+ *
+ * @param pathMappings - The path mappings configuration from the feature
+ * @returns true if mappings are enabled (default), false if explicitly disabled
+ *
+ * @example
+ * arePathMappingsEnabled(undefined) // Returns: true (default enabled)
+ * arePathMappingsEnabled({ enabled: false }) // Returns: false
+ * arePathMappingsEnabled({ enabled: true }) // Returns: true
+ * arePathMappingsEnabled({ mappings: [...] }) // Returns: true (enabled by default)
+ */
+export declare function arePathMappingsEnabled(pathMappings?: PathMappings): boolean;
+/**
+ * Get the effective path mappings for a feature
+ * Returns custom mappings if provided, otherwise default mappings
+ *
+ * @param featureName - The name of the feature
+ * @param pathMappings - The path mappings configuration from the feature
+ * @returns Array of path mappings to apply (empty if disabled)
+ *
+ * @example
+ * // Default behavior (no config)
+ * getEffectivePathMappings('feature-nav', undefined)
+ * // Returns: [{ from: 'webApp', to: 'webapplications/feature-nav' }]
+ *
+ * // Disabled
+ * getEffectivePathMappings('feature-nav', { enabled: false })
+ * // Returns: []
+ *
+ * // Custom mappings
+ * getEffectivePathMappings('feature-nav', { mappings: [{ from: 'web', to: 'custom/path' }] })
+ * // Returns: [{ from: 'web', to: 'custom/path' }]
+ */
+export declare function getEffectivePathMappings(featureName: string, pathMappings?: PathMappings): PathMapping[];
+/**
+ * Apply path mappings to a template file path
+ *
+ * This function transforms simplified paths (e.g., "webApp/src/app.tsx") into
+ * their full target paths (e.g., "webapplications/feature-name/src/app.tsx")
+ * based on the provided mappings.
+ *
+ * The function checks each mapping in order and applies the first one that matches.
+ * If no mapping matches, the path is returned unchanged (backwards compatibility).
+ *
+ * @param templatePath - Path relative to template directory (e.g., "webApp/src/app.tsx")
+ * @param mappings - Array of path mappings to apply
+ * @returns Transformed path with mapping applied
+ *
+ * @example
+ * // Apply default webApp mapping
+ * applyPathMappings('webApp/src/app.tsx', [{
+ *   from: 'webApp',
+ *   to: 'webapplications/feature-react-nav-menu'
+ * }])
+ * // Returns: 'webapplications/feature-react-nav-menu/src/app.tsx'
+ *
+ * @example
+ * // Backwards compatibility - old paths pass through
+ * applyPathMappings('webapplications/feature-react-nav-menu/src/app.tsx', [...])
+ * // Returns: 'webapplications/feature-react-nav-menu/src/app.tsx'
+ *
+ * @example
+ * // No mappings - path unchanged
+ * applyPathMappings('webApp/src/app.tsx', [])
+ * // Returns: 'webApp/src/app.tsx'
+ *
+ * @example
+ * // No match - path unchanged
+ * applyPathMappings('src/app.tsx', [{ from: 'webApp', to: '...' }])
+ * // Returns: 'src/app.tsx'
+ */
+export declare function applyPathMappings(templatePath: string, mappings: PathMapping[]): string;
+//# sourceMappingURL=path-mappings.d.ts.map

package/dist/utils/path-mappings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"path-mappings.d.ts","sourceRoot":"","sources":["../../src/utils/path-mappings.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,KAAK,WAAW,EAAE,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AAElE;;;;;;;;;;;GAWG;AACH,wBAAgB,sBAAsB,CAAC,WAAW,EAAE,MAAM,GAAG,WAAW,EAAE,CAOzE;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,sBAAsB,CAAC,YAAY,CAAC,EAAE,YAAY,GAAG,OAAO,CAS3E;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,wBAAwB,CACvC,WAAW,EAAE,MAAM,EACnB,YAAY,CAAC,EAAE,YAAY,GACzB,WAAW,EAAE,CAaf;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,wBAAgB,iBAAiB,CAAC,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE,GAAG,MAAM,CA4BvF"}

package/dist/utils/path-mappings.js

@@ -0,0 +1,139 @@
+/**
+ * Get default path mappings for a feature
+ * Maps webApp → webapplications/<featureName> (old format for path translation)
+ * Note: This still uses the old format because translatePathToTargetApp will convert it to SFDX format
+ *
+ * @param featureName - The name of the feature (e.g., 'feature-react-nav-menu')
+ * @returns Array containing the default path mapping
+ *
+ * @example
+ * getDefaultPathMappings('feature-nav')
+ * // Returns: [{ from: 'webApp', to: 'webapplications/feature-nav' }]
+ */
+export function getDefaultPathMappings(featureName) {
+    return [
+        {
+            from: "webApp",
+            to: `webapplications/${featureName}`,
+        },
+    ];
+}
+/**
+ * Check if path mappings are enabled for a feature
+ * Default: true (enabled by default, opt-out)
+ *
+ * @param pathMappings - The path mappings configuration from the feature
+ * @returns true if mappings are enabled (default), false if explicitly disabled
+ *
+ * @example
+ * arePathMappingsEnabled(undefined) // Returns: true (default enabled)
+ * arePathMappingsEnabled({ enabled: false }) // Returns: false
+ * arePathMappingsEnabled({ enabled: true }) // Returns: true
+ * arePathMappingsEnabled({ mappings: [...] }) // Returns: true (enabled by default)
+ */
+export function arePathMappingsEnabled(pathMappings) {
+    // If pathMappings is undefined, default to enabled
+    if (!pathMappings)
+        return true;
+    // If pathMappings.enabled is explicitly set, use that value
+    if (pathMappings.enabled !== undefined)
+        return pathMappings.enabled;
+    // Otherwise, enabled by default
+    return true;
+}
+/**
+ * Get the effective path mappings for a feature
+ * Returns custom mappings if provided, otherwise default mappings
+ *
+ * @param featureName - The name of the feature
+ * @param pathMappings - The path mappings configuration from the feature
+ * @returns Array of path mappings to apply (empty if disabled)
+ *
+ * @example
+ * // Default behavior (no config)
+ * getEffectivePathMappings('feature-nav', undefined)
+ * // Returns: [{ from: 'webApp', to: 'webapplications/feature-nav' }]
+ *
+ * // Disabled
+ * getEffectivePathMappings('feature-nav', { enabled: false })
+ * // Returns: []
+ *
+ * // Custom mappings
+ * getEffectivePathMappings('feature-nav', { mappings: [{ from: 'web', to: 'custom/path' }] })
+ * // Returns: [{ from: 'web', to: 'custom/path' }]
+ */
+export function getEffectivePathMappings(featureName, pathMappings) {
+    // If disabled, return empty array (no mappings)
+    if (!arePathMappingsEnabled(pathMappings)) {
+        return [];
+    }
+    // If custom mappings provided, use those
+    if (pathMappings?.mappings && pathMappings.mappings.length > 0) {
+        return pathMappings.mappings;
+    }
+    // Otherwise, use default mappings
+    return getDefaultPathMappings(featureName);
+}
+/**
+ * Apply path mappings to a template file path
+ *
+ * This function transforms simplified paths (e.g., "webApp/src/app.tsx") into
+ * their full target paths (e.g., "webapplications/feature-name/src/app.tsx")
+ * based on the provided mappings.
+ *
+ * The function checks each mapping in order and applies the first one that matches.
+ * If no mapping matches, the path is returned unchanged (backwards compatibility).
+ *
+ * @param templatePath - Path relative to template directory (e.g., "webApp/src/app.tsx")
+ * @param mappings - Array of path mappings to apply
+ * @returns Transformed path with mapping applied
+ *
+ * @example
+ * // Apply default webApp mapping
+ * applyPathMappings('webApp/src/app.tsx', [{
+ *   from: 'webApp',
+ *   to: 'webapplications/feature-react-nav-menu'
+ * }])
+ * // Returns: 'webapplications/feature-react-nav-menu/src/app.tsx'
+ *
+ * @example
+ * // Backwards compatibility - old paths pass through
+ * applyPathMappings('webapplications/feature-react-nav-menu/src/app.tsx', [...])
+ * // Returns: 'webapplications/feature-react-nav-menu/src/app.tsx'
+ *
+ * @example
+ * // No mappings - path unchanged
+ * applyPathMappings('webApp/src/app.tsx', [])
+ * // Returns: 'webApp/src/app.tsx'
+ *
+ * @example
+ * // No match - path unchanged
+ * applyPathMappings('src/app.tsx', [{ from: 'webApp', to: '...' }])
+ * // Returns: 'src/app.tsx'
+ */
+export function applyPathMappings(templatePath, mappings) {
+    // If no mappings, return path as-is (backwards compatibility)
+    if (mappings.length === 0) {
+        return templatePath;
+    }
+    // Try each mapping in order (first match wins)
+    for (const mapping of mappings) {
+        const fromPrefix = mapping.from + "/";
+        // Check if path starts with the mapping's "from" prefix
+        if (templatePath.startsWith(fromPrefix)) {
+            // Replace prefix with "to" prefix
+            const remainder = templatePath.substring(fromPrefix.length);
+            return mapping.to + "/" + remainder;
+        }
+        // Also handle exact match (no trailing slash)
+        if (templatePath === mapping.from) {
+            return mapping.to;
+        }
+    }
+    // No mapping matched, return original path
+    // This handles both:
+    // 1. Old-style full paths (webapplications/...)
+    // 2. Other paths that don't use the mapping shorthand
+    return templatePath;
+}
+//# sourceMappingURL=path-mappings.js.map

package/dist/utils/path-mappings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"path-mappings.js","sourceRoot":"","sources":["../../src/utils/path-mappings.ts"],"names":[],"mappings":"AAOA;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,sBAAsB,CAAC,WAAmB;IACzD,OAAO;QACN;YACC,IAAI,EAAE,QAAQ;YACd,EAAE,EAAE,mBAAmB,WAAW,EAAE;SACpC;KACD,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,sBAAsB,CAAC,YAA2B;IACjE,mDAAmD;IACnD,IAAI,CAAC,YAAY;QAAE,OAAO,IAAI,CAAC;IAE/B,4DAA4D;IAC5D,IAAI,YAAY,CAAC,OAAO,KAAK,SAAS;QAAE,OAAO,YAAY,CAAC,OAAO,CAAC;IAEpE,gCAAgC;IAChC,OAAO,IAAI,CAAC;AACb,CAAC;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,wBAAwB,CACvC,WAAmB,EACnB,YAA2B;IAE3B,gDAAgD;IAChD,IAAI,CAAC,sBAAsB,CAAC,YAAY,CAAC,EAAE,CAAC;QAC3C,OAAO,EAAE,CAAC;IACX,CAAC;IAED,yCAAyC;IACzC,IAAI,YAAY,EAAE,QAAQ,IAAI,YAAY,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAChE,OAAO,YAAY,CAAC,QAAQ,CAAC;IAC9B,CAAC;IAED,kCAAkC;IAClC,OAAO,sBAAsB,CAAC,WAAW,CAAC,CAAC;AAC5C,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,MAAM,UAAU,iBAAiB,CAAC,YAAoB,EAAE,QAAuB;IAC9E,8DAA8D;IAC9D,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC3B,OAAO,YAAY,CAAC;IACrB,CAAC;IAED,+CAA+C;IAC/C,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAChC,MAAM,UAAU,GAAG,OAAO,CAAC,IAAI,GAAG,GAAG,CAAC;QAEtC,wDAAwD;QACxD,IAAI,YAAY,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;YACzC,kCAAkC;YAClC,MAAM,SAAS,GAAG,YAAY,CAAC,SAAS,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;YAC5D,OAAO,OAAO,CAAC,EAAE,GAAG,GAAG,GAAG,SAAS,CAAC;QACrC,CAAC;QAED,8CAA8C;QAC9C,IAAI,YAAY,KAAK,OAAO,CAAC,IAAI,EAAE,CAAC;YACnC,OAAO,OAAO,CAAC,EAAE,CAAC;QACnB,CAAC;IACF,CAAC;IAED,2CAA2C;IAC3C,qBAAqB;IACrB,gDAAgD;IAChD,sDAAsD;IACtD,OAAO,YAAY,CAAC;AACrB,CAAC"}

package/dist/utils/paths.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Find the monorepo root by searching upward for package.json with workspaces
+ */
+export declare function getMonorepoRoot(): string;
+/**
+ * Get the features directory path
+ */
+export declare function getFeaturesDir(): string;
+/**
+ * Get the directory path for a specific feature
+ */
+export declare function getFeatureDir(featureName: string): string;
+/**
+ * Resolve a file path within a feature
+ */
+export declare function resolveFeatureFile(featureName: string, filePath: string): string;
+/**
+ * Get the SFDX project template path
+ */
+export declare function getSfdxProjectTemplatePath(): string;
+/**
+ * Get the site-container template path (force-app/main/default with digitalExperienceConfigs, etc.)
+ */
+export declare function getSiteContainerTemplatePath(): string;
+/**
+ * Get the web application path in SFDX structure
+ * Structure: force-app/main/default/webapplications/<appName>
+ */
+export declare function getSfdxWebApplicationPath(targetDir: string, appName: string): string;
+/**
+ * Translate a feature file path to the corresponding base app path
+ * Replaces feature name with base app name in the nested structure
+ *
+ * Handles multiple formats:
+ * 1. SFDX path: "force-app/main/default/webapplications/feature-simple/src/routes.tsx"
+ *    → "force-app/main/default/webapplications/base-app/src/routes.tsx" (SFDX structure)
+ *    → "webapplications/base-app/src/routes.tsx" (legacy structure)
+ * 2. Full path: "webapplications/feature-simple/src/routes.tsx"
+ *    → "webapplications/base-app/src/routes.tsx"
+ * 3. WebApp path: "webApp/src/routes.tsx"
+ *    → "webapplications/base-app/src/routes.tsx"
+ * 4. Other SFDX paths: "classes/NavMenu.cls"
+ *    → "classes/NavMenu.cls" (unchanged, stays at root)
+ */
+export declare function translatePathToBaseApp(featurePath: string, featureName: string, baseAppPath: string): string;
+/**
+ * Translate a feature file path to use a target app name in SFDX structure
+ * Replaces feature name with target app name in the nested structure
+ *
+ * Handles multiple formats:
+ * 1. SFDX path: "force-app/main/default/webapplications/feature-simple/src/routes.tsx"
+ *    → "force-app/main/default/webapplications/target-app/src/routes.tsx"
+ * 2. Full path: "webapplications/feature-simple/src/routes.tsx"
+ *    → "force-app/main/default/webapplications/target-app/src/routes.tsx"
+ * 3. WebApp path: "webApp/src/routes.tsx"
+ *    → "force-app/main/default/webapplications/target-app/src/routes.tsx"
+ * 4. Other SFDX paths: "classes/NavMenu.cls"
+ *    → "force-app/main/default/classes/NavMenu.cls" (moved to SFDX structure)
+ */
+export declare function translatePathToTargetApp(featurePath: string, featureName: string, targetAppName: string): string;
+//# sourceMappingURL=paths.d.ts.map

package/dist/utils/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../src/utils/paths.ts"],"names":[],"mappings":"AASA;;GAEG;AACH,wBAAgB,eAAe,IAAI,MAAM,CAiBxC;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAEzD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEhF;AAED;;GAEG;AACH,wBAAgB,0BAA0B,IAAI,MAAM,CAEnD;AAED;;GAEG;AACH,wBAAgB,4BAA4B,IAAI,MAAM,CAWrD;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAEpF;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,sBAAsB,CACrC,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,GACjB,MAAM,CAoDR;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,wBAAwB,CACvC,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,EACnB,aAAa,EAAE,MAAM,GACnB,MAAM,CAwCR"}

package/dist/utils/paths.js

@@ -0,0 +1,178 @@
+/**
+ * Copyright (c) 2026, Salesforce, Inc.,
+ * All rights reserved.
+ * For full license text, see the LICENSE.txt file
+ */
+import { existsSync, readFileSync } from "fs";
+import { join, dirname, basename } from "path";
+import { fileURLToPath } from "url";
+/**
+ * Find the monorepo root by searching upward for package.json with workspaces
+ */
+export function getMonorepoRoot() {
+    let currentDir = dirname(fileURLToPath(import.meta.url));
+    while (currentDir !== "/") {
+        const packageJsonPath = join(currentDir, "package.json");
+        if (existsSync(packageJsonPath)) {
+            const packageJson = JSON.parse(readFileSync(packageJsonPath, "utf-8"));
+            if (packageJson.workspaces) {
+                return currentDir;
+            }
+        }
+        currentDir = dirname(currentDir);
+    }
+    throw new Error("Could not find monorepo root (package.json with workspaces)");
+}
+/**
+ * Get the features directory path
+ */
+export function getFeaturesDir() {
+    return join(getMonorepoRoot(), "packages", "template", "feature");
+}
+/**
+ * Get the directory path for a specific feature
+ */
+export function getFeatureDir(featureName) {
+    return join(getFeaturesDir(), featureName);
+}
+/**
+ * Resolve a file path within a feature
+ */
+export function resolveFeatureFile(featureName, filePath) {
+    return join(getFeatureDir(featureName), filePath);
+}
+/**
+ * Get the SFDX project template path
+ */
+export function getSfdxProjectTemplatePath() {
+    return join(getMonorepoRoot(), "packages", "template", "template", "template-sfdx-project");
+}
+/**
+ * Get the site-container template path (force-app/main/default with digitalExperienceConfigs, etc.)
+ */
+export function getSiteContainerTemplatePath() {
+    return join(getMonorepoRoot(), "packages", "template", "template", "template-site-container", "force-app", "main", "default");
+}
+/**
+ * Get the web application path in SFDX structure
+ * Structure: force-app/main/default/webapplications/<appName>
+ */
+export function getSfdxWebApplicationPath(targetDir, appName) {
+    return join(targetDir, "force-app", "main", "default", "webapplications", appName);
+}
+/**
+ * Translate a feature file path to the corresponding base app path
+ * Replaces feature name with base app name in the nested structure
+ *
+ * Handles multiple formats:
+ * 1. SFDX path: "force-app/main/default/webapplications/feature-simple/src/routes.tsx"
+ *    → "force-app/main/default/webapplications/base-app/src/routes.tsx" (SFDX structure)
+ *    → "webapplications/base-app/src/routes.tsx" (legacy structure)
+ * 2. Full path: "webapplications/feature-simple/src/routes.tsx"
+ *    → "webapplications/base-app/src/routes.tsx"
+ * 3. WebApp path: "webApp/src/routes.tsx"
+ *    → "webapplications/base-app/src/routes.tsx"
+ * 4. Other SFDX paths: "classes/NavMenu.cls"
+ *    → "classes/NavMenu.cls" (unchanged, stays at root)
+ */
+export function translatePathToBaseApp(featurePath, featureName, baseAppPath) {
+    // Extract base app name from base app path (last directory component)
+    const baseAppName = basename(baseAppPath);
+    const sfdxPrefix = "force-app/main/default/";
+    const webAppPrefix = "webapplications/";
+    // Check for SFDX structure path
+    if (featurePath.startsWith(sfdxPrefix + webAppPrefix)) {
+        // SFDX path format: force-app/main/default/webapplications/<feature-name>/...
+        const remainder = featurePath.substring((sfdxPrefix + webAppPrefix).length);
+        if (remainder.startsWith(featureName + "/")) {
+            // Replace feature name with base app name
+            const pathAfterFeatureName = remainder.substring(featureName.length + 1);
+            // Check if base app uses SFDX structure
+            if (existsSync(join(baseAppPath, "src", "force-app"))) {
+                // Base app uses SFDX structure - include src/ prefix
+                return `src/${sfdxPrefix}${webAppPrefix}${baseAppName}/${pathAfterFeatureName}`;
+            }
+            else {
+                // Base app uses legacy structure
+                return `${webAppPrefix}${baseAppName}/${pathAfterFeatureName}`;
+            }
+        }
+    }
+    // Pattern: webapplications/<feature-name>/...
+    if (featurePath.startsWith(webAppPrefix)) {
+        // Full path format - remove prefix to get: <feature-name>/...
+        const remainder = featurePath.substring(webAppPrefix.length);
+        // Check if it starts with the feature name
+        if (remainder.startsWith(featureName + "/")) {
+            // Replace feature name with base app name
+            const pathAfterFeatureName = remainder.substring(featureName.length + 1);
+            // Match base app structure (SFDX vs legacy)
+            if (existsSync(join(baseAppPath, "src", "force-app"))) {
+                return `src/${sfdxPrefix}${webAppPrefix}${baseAppName}/${pathAfterFeatureName}`;
+            }
+            return `${webAppPrefix}${baseAppName}/${pathAfterFeatureName}`;
+        }
+    }
+    else if (featurePath.startsWith("webApp/")) {
+        // WebApp path - strip webApp/ prefix and add full webapplications path
+        const pathAfterWebApp = featurePath.substring("webApp/".length);
+        if (existsSync(join(baseAppPath, "src", "force-app"))) {
+            return `src/${sfdxPrefix}${webAppPrefix}${baseAppName}/${pathAfterWebApp}`;
+        }
+        return `${webAppPrefix}${baseAppName}/${pathAfterWebApp}`;
+    }
+    // All other paths (SFDX metadata, etc.) - return as is (stays at root level)
+    return featurePath;
+}
+/**
+ * Translate a feature file path to use a target app name in SFDX structure
+ * Replaces feature name with target app name in the nested structure
+ *
+ * Handles multiple formats:
+ * 1. SFDX path: "force-app/main/default/webapplications/feature-simple/src/routes.tsx"
+ *    → "force-app/main/default/webapplications/target-app/src/routes.tsx"
+ * 2. Full path: "webapplications/feature-simple/src/routes.tsx"
+ *    → "force-app/main/default/webapplications/target-app/src/routes.tsx"
+ * 3. WebApp path: "webApp/src/routes.tsx"
+ *    → "force-app/main/default/webapplications/target-app/src/routes.tsx"
+ * 4. Other SFDX paths: "classes/NavMenu.cls"
+ *    → "force-app/main/default/classes/NavMenu.cls" (moved to SFDX structure)
+ */
+export function translatePathToTargetApp(featurePath, featureName, targetAppName) {
+    const sfdxPrefix = "force-app/main/default/";
+    const webAppPrefix = "webapplications/";
+    // Check for SFDX structure path (already has force-app prefix)
+    if (featurePath.startsWith(sfdxPrefix + webAppPrefix)) {
+        // SFDX path format: force-app/main/default/webapplications/<feature-name>/...
+        const remainder = featurePath.substring((sfdxPrefix + webAppPrefix).length);
+        if (remainder.startsWith(featureName + "/")) {
+            // Replace feature name with target app name
+            const pathAfterFeatureName = remainder.substring(featureName.length + 1);
+            return `${sfdxPrefix}${webAppPrefix}${targetAppName}/${pathAfterFeatureName}`;
+        }
+    }
+    // Pattern: webapplications/<feature-name>/...
+    if (featurePath.startsWith(webAppPrefix)) {
+        // Full path format - remove prefix to get: <feature-name>/...
+        const remainder = featurePath.substring(webAppPrefix.length);
+        // Check if it starts with the feature name
+        if (remainder.startsWith(featureName + "/")) {
+            // Replace feature name with target app name and add SFDX prefix
+            const pathAfterFeatureName = remainder.substring(featureName.length + 1);
+            return `${sfdxPrefix}${webAppPrefix}${targetAppName}/${pathAfterFeatureName}`;
+        }
+    }
+    else if (featurePath.startsWith("webApp/")) {
+        // WebApp path - strip webApp/ prefix and add full SFDX webapplications path
+        const pathAfterWebApp = featurePath.substring("webApp/".length);
+        return `${sfdxPrefix}${webAppPrefix}${targetAppName}/${pathAfterWebApp}`;
+    }
+    // All other paths (SFDX metadata, etc.) - move to SFDX structure
+    // e.g., "classes/NavMenu.cls" → "force-app/main/default/classes/NavMenu.cls"
+    // But skip if already has SFDX prefix
+    if (featurePath.startsWith(sfdxPrefix)) {
+        return featurePath;
+    }
+    return `${sfdxPrefix}${featurePath}`;
+}
+//# sourceMappingURL=paths.js.map

package/dist/utils/paths.js.map

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

package/dist/utils/route-merger.d.ts

@@ -0,0 +1,107 @@
+import { Project } from "ts-morph";
+/**
+ * Route Merging Strategy: Replace-Matching with Deep Children Merge
+ *
+ * This function merges React Router routes from a feature into a base app using
+ * a "replace-matching" strategy with intelligent children array merging.
+ *
+ * ## How It Works:
+ *
+ * 1. **Top-Level Routes:**
+ *    - Routes with the SAME path → Merge their children arrays
+ *    - Routes with DIFFERENT paths → Add feature route to result
+ *
+ * 2. **Children Array Merging (when parent paths match):**
+ *    - Index routes (`index: true`) → Feature replaces base if both exist
+ *    - Named routes (`path: 'about'`) → Feature replaces base if paths match
+ *    - New routes → Added to children array
+ *    - Preserves base routes not in feature
+ *
+ * 3. **Route Deletion:**
+ *    - Routes with path starting with `__delete__` are deletion markers
+ *    - The route with matching path (without prefix) is removed from result
+ *    - Example: `{ path: '__delete__new' }` removes the route with `path: 'new'`
+ *
+ * 4. **Recursion:**
+ *    - Applies same logic to nested children arrays
+ *
+ * ## Example:
+ *
+ * **Base App Routes:**
+ * ```typescript
+ * [{
+ *   path: '/',
+ *   element: <AppLayout />,
+ *   children: [
+ *     { index: true, element: <Home /> }
+ *   ]
+ * }]
+ * ```
+ *
+ * **Feature Routes:**
+ * ```typescript
+ * [{
+ *   path: '/',
+ *   element: <AppLayout />,
+ *   children: [
+ *     { path: 'about', element: <About /> },
+ *     { path: 'contact', element: <Contact /> }
+ *   ]
+ * }]
+ * ```
+ *
+ * **Merged Result:**
+ * ```typescript
+ * [{
+ *   path: '/',
+ *   element: <AppLayout />,  // Uses feature's element
+ *   children: [
+ *     { index: true, element: <Home /> },       // Preserved from base
+ *     { path: 'about', element: <About /> },    // Added from feature
+ *     { path: 'contact', element: <Contact /> } // Added from feature
+ *   ]
+ * }]
+ * ```
+ *
+ * ## Deletion Example:
+ *
+ * **Base/Previous Routes:**
+ * ```typescript
+ * [{
+ *   path: '/',
+ *   children: [
+ *     { path: 'home', element: <Home /> },
+ *     { path: 'about', element: <About /> },
+ *     { path: 'new', element: <New /> }
+ *   ]
+ * }]
+ * ```
+ *
+ * **Feature Routes (deleting 'new'):**
+ * ```typescript
+ * [{
+ *   path: '/',
+ *   children: [
+ *     { path: '__delete__new', element: <></> }
+ *   ]
+ * }]
+ * ```
+ *
+ * **Merged Result:**
+ * ```typescript
+ * [{
+ *   path: '/',
+ *   children: [
+ *     { path: 'home', element: <Home /> },   // Preserved
+ *     { path: 'about', element: <About /> }  // Preserved
+ *     // 'new' route removed
+ *   ]
+ * }]
+ * ```
+ *
+ * @param featurePath - Path to the feature's routes.tsx file
+ * @param targetPath - Path to the base app's routes.tsx file
+ * @returns The merged routes source code
+ */
+export declare function mergeRoutes(featurePath: string, targetPath: string, project?: Project): string;
+//# sourceMappingURL=route-merger.d.ts.map

package/dist/utils/route-merger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"route-merger.d.ts","sourceRoot":"","sources":["../../src/utils/route-merger.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,OAAO,EAAiD,MAAM,UAAU,CAAC;AAkBlF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuGG;AACH,wBAAgB,WAAW,CAAC,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,MAAM,CA0D9F"}