@salesforce/webapp-template-cli-experimental 1.3.3

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

@@ -0,0 +1,55 @@
+export declare class FileOperationError extends Error {
+    constructor(message: string);
+}
+/**
+ * Process webApplication meta.xml file: replace template parameters and rename
+ * @param targetFilePath - Full path to the target file
+ * @param appName - Application name to use for masterLabel and filename
+ * @returns New file path if file was renamed, or original path
+ */
+export declare function processWebApplicationMetaFile(targetFilePath: string, appName: string): string;
+/**
+ * Copy site-container template into target force-app/main/default, replacing
+ * template params (appName, siteName, siteName1, siteNameLower, etc.) and path
+ * placeholders (__siteName__, __siteName1__) in directory and file names.
+ *
+ * @param templateRoot - Path to template-site-container/force-app/main/default
+ * @param targetForceAppDefault - Path to target's force-app/main/default
+ * @param appName - Application name (used as site name base)
+ */
+export declare function copySiteContainerTemplate(templateRoot: string, targetForceAppDefault: string, appName: string): void;
+/**
+ * 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
+ * @param appName - Application name for template processing (optional)
+ */
+export declare function applyFile(patchFilePath: string, baseFilePath: string, targetFilePath: string, relativeTargetPath: string, shouldMerge?: boolean, appName?: string): 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":"AAqBA,qBAAa,kBAAmB,SAAQ,KAAK;gBAChC,OAAO,EAAE,MAAM;CAI3B;AAgGD;;;;;GAKG;AACH,wBAAgB,6BAA6B,CAAC,cAAc,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAmC7F;AAED;;;;;;;;GAQG;AACH,wBAAgB,yBAAyB,CACxC,YAAY,EAAE,MAAM,EACpB,qBAAqB,EAAE,MAAM,EAC7B,OAAO,EAAE,MAAM,GACb,IAAI,CAyCN;AAED;;;;;;;;;GASG;AACH,wBAAsB,SAAS,CAC9B,aAAa,EAAE,MAAM,EACrB,YAAY,EAAE,MAAM,EACpB,cAAc,EAAE,MAAM,EACtB,kBAAkB,EAAE,MAAM,EAC1B,WAAW,UAAQ,EACnB,OAAO,CAAC,EAAE,MAAM,GACd,OAAO,CAAC,IAAI,CAAC,CAiGf;AAED;;;;;GAKG;AACH,wBAAsB,UAAU,CAC/B,cAAc,EAAE,MAAM,EACtB,kBAAkB,EAAE,MAAM,GACxB,OAAO,CAAC,IAAI,CAAC,CAef;AAED;;;;;;GAMG;AACH,wBAAsB,aAAa,CAClC,eAAe,EAAE,MAAM,EACvB,cAAc,EAAE,MAAM,EACtB,kBAAkB,EAAE,MAAM,GACxB,OAAO,CAAC,IAAI,CAAC,CA6Bf;AAED;;;;;;GAMG;AACH,wBAAsB,YAAY,CACjC,eAAe,EAAE,MAAM,EACvB,cAAc,EAAE,MAAM,EACtB,kBAAkB,EAAE,MAAM,GACxB,OAAO,CAAC,IAAI,CAAC,CA6Bf"}

package/dist/core/file-operations.js

@@ -0,0 +1,350 @@
+/**
+ * Copyright (c) 2026, Salesforce, Inc.,
+ * All rights reserved.
+ * For full license text, see the LICENSE.txt file
+ */
+import { readFileSync, readdirSync, existsSync, mkdirSync, writeFileSync, rmSync, statSync, renameSync, } from "fs";
+import { dirname, extname, basename, join } from "path";
+import * as logger from "../utils/logger.js";
+import { mergeRoutes } from "../utils/route-merger.js";
+const _INHERIT_PREFIX = "__inherit__";
+export class FileOperationError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "FileOperationError";
+    }
+}
+/**
+ * Fix import paths by removing __inherit__ prefix from import/require statements
+ *
+ * Examples:
+ * - import { x } from './__inherit__routes' -> import { x } from './routes'
+ * - import x from '../__inherit__routes.tsx' -> import x from '../routes.tsx'
+ * - require('./__inherit__file') -> require('./file')
+ *
+ * @param content - File content to process
+ * @returns Content with fixed import paths
+ */
+function fixInheritImportPaths(content) {
+    // Match import/export statements with __inherit__ in the path
+    // Handles: import ... from '...__inherit__...'
+    //          export ... from '...__inherit__...'
+    //          import('...__inherit__...')
+    //          require('...__inherit__...')
+    // Pattern explanation:
+    // (from\s+|import\(|require\() - matches 'from ', 'import(', or 'require('
+    // (['"`]) - captures opening quote
+    // ([^'"`]*) - captures path before __inherit__
+    // __inherit__ - the prefix to remove
+    // ([^'"`]*) - captures rest of path
+    // \2 - matches same quote type as opening
+    return content.replace(/(from\s+|import\(|require\()(['"`])([^'"`]*)__inherit__([^'"`]*)\2/g, (match, prefix, quote, before, after) => {
+        return `${prefix}${quote}${before}${after}${quote}`;
+    });
+}
+/**
+ * Check if file is a JS/TS file that may contain imports
+ */
+function isJavaScriptFile(filePath) {
+    const ext = extname(filePath);
+    return [".js", ".jsx", ".ts", ".tsx", ".mjs", ".cjs"].includes(ext);
+}
+/**
+ * Check if file is a webApplication meta.xml file that needs template processing.
+ * Accepts both _webapplication.webapplication-meta.xml and _webapplication.webApplication-meta.xml (case variation).
+ */
+function isWebApplicationMetaFile(filePath) {
+    const fileName = basename(filePath);
+    return fileName.toLowerCase() === "_webapplication.webapplication-meta.xml";
+}
+/**
+ * Check if file is a site-container metadata file that needs template parameter replacement
+ * (digitalExperienceConfigs, digitalExperiences, networks, sites under force-app/main/default)
+ */
+function isSiteContainerMetaFile(filePath) {
+    const normalized = filePath.replace(/\\/g, "/");
+    return (normalized.includes("/digitalExperienceConfigs/") ||
+        normalized.includes("/digitalExperiences/") ||
+        normalized.includes("/networks/") ||
+        normalized.includes("/sites/"));
+}
+/**
+ * Replace site-container template parameters with values derived from app name.
+ * Uses <%= appName %>, <%= urlPathPrefixVForceSite %>, <%= appSpace %>,
+ * <%= siteName %>, <%= siteName1 %>, <%= siteNameLower %> (siteName = appName, siteName1 = appName + "1", siteNameLower = appName.toLowerCase()).
+ */
+function replaceSiteContainerParams(content, appName) {
+    const urlPathPrefixVForceSite = `${appName}vforcesite`;
+    const appSpace = `c/${appName}`;
+    const siteName = appName;
+    const siteName1 = `${appName}1`;
+    const siteNameLower = appName.toLowerCase();
+    return content
+        .replace(/<%= appName %>/g, appName)
+        .replace(/<%= urlPathPrefixVForceSite %>/g, urlPathPrefixVForceSite)
+        .replace(/<%= appSpace %>/g, appSpace)
+        .replace(/<%= siteName %>/g, siteName)
+        .replace(/<%= siteName1 %>/g, siteName1)
+        .replace(/<%= siteNameLower %>/g, siteNameLower);
+}
+/** Translate placeholder path segments to actual site name values (handles dir names and filenames like __siteName1__.digitalExperienceConfig). */
+function translateSiteContainerPathSegment(segment, siteName, siteName1) {
+    return segment.replace(/__siteName1__/g, siteName1).replace(/__siteName__/g, siteName);
+}
+/**
+ * Process webApplication meta.xml file: replace template parameters and rename
+ * @param targetFilePath - Full path to the target file
+ * @param appName - Application name to use for masterLabel and filename
+ * @returns New file path if file was renamed, or original path
+ */
+export function processWebApplicationMetaFile(targetFilePath, appName) {
+    if (!isWebApplicationMetaFile(targetFilePath)) {
+        return targetFilePath;
+    }
+    // Read the file content
+    let content = readFileSync(targetFilePath, "utf-8");
+    // Replace template parameters
+    content = content.replace(/<%= masterLabel %>/g, appName);
+    // Write the updated content
+    writeFileSync(targetFilePath, content, "utf-8");
+    // Rename the file from _webapplication.*-meta.xml to <appName>.webapplication-meta.xml
+    const targetDir = dirname(targetFilePath);
+    const newFileName = `${appName}.webapplication-meta.xml`;
+    const newFilePath = join(targetDir, newFileName);
+    // If the new file already exists, update it with the new content
+    if (existsSync(newFilePath)) {
+        const existingContent = readFileSync(newFilePath, "utf-8");
+        if (existingContent !== content) {
+            // Content is different, update it
+            writeFileSync(newFilePath, content, "utf-8");
+        }
+        // Delete the old file regardless
+        rmSync(targetFilePath, { force: true });
+        return newFilePath;
+    }
+    // Rename the file
+    renameSync(targetFilePath, newFilePath);
+    logger.info(`Renamed ${basename(targetFilePath)} to ${newFileName}`);
+    return newFilePath;
+}
+/**
+ * Copy site-container template into target force-app/main/default, replacing
+ * template params (appName, siteName, siteName1, siteNameLower, etc.) and path
+ * placeholders (__siteName__, __siteName1__) in directory and file names.
+ *
+ * @param templateRoot - Path to template-site-container/force-app/main/default
+ * @param targetForceAppDefault - Path to target's force-app/main/default
+ * @param appName - Application name (used as site name base)
+ */
+export function copySiteContainerTemplate(templateRoot, targetForceAppDefault, appName) {
+    if (!existsSync(templateRoot)) {
+        return;
+    }
+    const siteName = appName;
+    const siteName1 = `${appName}1`;
+    function translateRelativePath(relativePath) {
+        return relativePath
+            .split("/")
+            .map((seg) => translateSiteContainerPathSegment(seg, siteName, siteName1))
+            .join("/");
+    }
+    function walk(dir, base = "") {
+        const entries = readdirSync(dir, { withFileTypes: true });
+        for (const entry of entries) {
+            const relativePath = base ? `${base}/${entry.name}` : entry.name;
+            const targetRelativePath = translateRelativePath(relativePath);
+            const srcPath = join(dir, entry.name);
+            const destPath = join(targetForceAppDefault, targetRelativePath);
+            if (entry.isDirectory()) {
+                if (!existsSync(destPath)) {
+                    mkdirSync(destPath, { recursive: true });
+                }
+                walk(srcPath, relativePath);
+            }
+            else {
+                let content = readFileSync(srcPath, "utf-8");
+                content = replaceSiteContainerParams(content, appName);
+                if (!existsSync(dirname(destPath))) {
+                    mkdirSync(dirname(destPath), { recursive: true });
+                }
+                writeFileSync(destPath, content, "utf-8");
+                logger.info(`Site container: ${targetRelativePath}`);
+            }
+        }
+    }
+    walk(templateRoot);
+}
+/**
+ * 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
+ * @param appName - Application name for template processing (optional)
+ */
+export async function applyFile(patchFilePath, baseFilePath, targetFilePath, relativeTargetPath, shouldMerge = false, appName) {
+    if (!existsSync(patchFilePath)) {
+        throw new FileOperationError(`Patch file not found: ${patchFilePath}`);
+    }
+    // Read the patch content
+    let patchContent = readFileSync(patchFilePath, "utf-8");
+    // Fix __inherit__ import paths for JS/TS files
+    if (isJavaScriptFile(patchFilePath)) {
+        patchContent = fixInheritImportPaths(patchContent);
+    }
+    // Replace site-container template params before merge/write so comparisons use final content
+    if (appName && isSiteContainerMetaFile(targetFilePath)) {
+        patchContent = replaceSiteContainerParams(patchContent, appName);
+    }
+    if (shouldMerge) {
+        // Merge strategy - merge patch with base, write to target
+        if (!existsSync(baseFilePath)) {
+            throw new FileOperationError(`Base file not found: ${baseFilePath}. Merge requires base file to exist.`);
+        }
+        // Merge patch with base (note: mergeRoutes reads files internally, so we write fixed content to temp)
+        let mergedContent = mergeRoutes(patchFilePath, baseFilePath);
+        // Fix imports in merged content
+        if (isJavaScriptFile(targetFilePath)) {
+            mergedContent = fixInheritImportPaths(mergedContent);
+        }
+        // Replace site-container template params in merged output when applicable
+        if (appName && isSiteContainerMetaFile(targetFilePath)) {
+            mergedContent = replaceSiteContainerParams(mergedContent, appName);
+        }
+        // Check if target already has this content
+        if (existsSync(targetFilePath)) {
+            const existingContent = readFileSync(targetFilePath, "utf-8");
+            if (existingContent === mergedContent) {
+                logger.info(`Skipped ${relativeTargetPath} (content unchanged after merge)`);
+                return;
+            }
+        }
+        // Ensure target directory exists
+        const targetDirPath = dirname(targetFilePath);
+        if (!existsSync(targetDirPath)) {
+            mkdirSync(targetDirPath, { recursive: true });
+        }
+        writeFileSync(targetFilePath, mergedContent, "utf-8");
+        logger.success(`Merged ${relativeTargetPath}`);
+    }
+    else {
+        // Add/Update strategy - copy patch to target
+        const targetExists = existsSync(targetFilePath);
+        if (targetExists) {
+            const existingContent = readFileSync(targetFilePath, "utf-8");
+            if (existingContent === patchContent) {
+                logger.info(`Skipped ${relativeTargetPath} (content unchanged)`);
+                return;
+            }
+        }
+        // Ensure target directory exists
+        const targetDirPath = dirname(targetFilePath);
+        if (!existsSync(targetDirPath)) {
+            mkdirSync(targetDirPath, { recursive: true });
+        }
+        // Write the file
+        writeFileSync(targetFilePath, patchContent, "utf-8");
+        // Process webApplication meta.xml file if needed
+        if (appName && isWebApplicationMetaFile(targetFilePath)) {
+            const newFilePath = processWebApplicationMetaFile(targetFilePath, appName);
+            // Update relativeTargetPath for logging if file was renamed
+            if (newFilePath !== targetFilePath) {
+                const newRelativePath = relativeTargetPath.replace(/_webapplication\.webapplication-meta\.xml$/i, `${appName}.webapplication-meta.xml`);
+                logger.success(`Added ${newRelativePath}`);
+                return;
+            }
+        }
+        if (targetExists) {
+            logger.success(`Updated ${relativeTargetPath}`);
+        }
+        else {
+            logger.success(`Added ${relativeTargetPath}`);
+        }
+    }
+}
+/**
+ * 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 async function deleteFile(targetFilePath, relativeTargetPath) {
+    if (!existsSync(targetFilePath)) {
+        logger.info(`Skipped deleting ${relativeTargetPath} (does not exist)`);
+        return;
+    }
+    const stat = statSync(targetFilePath);
+    if (stat.isDirectory()) {
+        rmSync(targetFilePath, { recursive: true, force: true });
+        logger.success(`Deleted directory ${relativeTargetPath}`);
+    }
+    else {
+        rmSync(targetFilePath, { force: true });
+        logger.success(`Deleted ${relativeTargetPath}`);
+    }
+}
+/**
+ * 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 async function prependToFile(featureFilePath, targetFilePath, relativeTargetPath) {
+    if (!existsSync(featureFilePath)) {
+        throw new FileOperationError(`Feature file not found: ${featureFilePath}`);
+    }
+    if (!existsSync(targetFilePath)) {
+        throw new FileOperationError(`Target file not found: ${targetFilePath}`);
+    }
+    // Read both files
+    let featureContent = readFileSync(featureFilePath, "utf-8");
+    const targetContent = readFileSync(targetFilePath, "utf-8");
+    // Fix __inherit__ imports in feature content if it's a JS/TS file
+    if (isJavaScriptFile(featureFilePath)) {
+        featureContent = fixInheritImportPaths(featureContent);
+    }
+    // Prepend feature content to target content
+    const newContent = featureContent + "\n" + targetContent;
+    // Check if content would actually change
+    if (targetContent === newContent) {
+        logger.info(`Skipped ${relativeTargetPath} (content unchanged after prepend)`);
+        return;
+    }
+    writeFileSync(targetFilePath, newContent, "utf-8");
+    logger.success(`Prepended to ${relativeTargetPath}`);
+}
+/**
+ * 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 async function appendToFile(featureFilePath, targetFilePath, relativeTargetPath) {
+    if (!existsSync(featureFilePath)) {
+        throw new FileOperationError(`Feature file not found: ${featureFilePath}`);
+    }
+    if (!existsSync(targetFilePath)) {
+        throw new FileOperationError(`Target file not found: ${targetFilePath}`);
+    }
+    // Read both files
+    const targetContent = readFileSync(targetFilePath, "utf-8");
+    let featureContent = readFileSync(featureFilePath, "utf-8");
+    // Fix __inherit__ imports in feature content if it's a JS/TS file
+    if (isJavaScriptFile(featureFilePath)) {
+        featureContent = fixInheritImportPaths(featureContent);
+    }
+    // Append feature content to target content
+    const newContent = targetContent + "\n" + featureContent;
+    // Check if content would actually change
+    if (targetContent === newContent) {
+        logger.info(`Skipped ${relativeTargetPath} (content unchanged after append)`);
+        return;
+    }
+    writeFileSync(targetFilePath, newContent, "utf-8");
+    logger.success(`Appended to ${relativeTargetPath}`);
+}
+//# sourceMappingURL=file-operations.js.map

package/dist/core/file-operations.js.map

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

package/dist/core/package-json-merger.d.ts

@@ -0,0 +1,31 @@
+import type { PackageJsonDependencies } from "../types.js";
+export declare class PackageJsonMergeError extends Error {
+    constructor(message: string);
+}
+/**
+ * Build package specs array from dependencies object
+ * @param dependencies - Object mapping package names to versions
+ * @returns Array of package specs in format "package@version"
+ */
+export declare function buildPackageSpecs(dependencies: Record<string, string>): string[];
+/**
+ * Build npm install command for package specs
+ * @param packageSpecs - Array of package specs
+ * @param isDev - Whether these are dev dependencies
+ * @returns npm install command string
+ */
+export declare function buildInstallCommand(packageSpecs: string[], isDev: boolean): string;
+/**
+ * Execute npm install command (extracted for testability)
+ * @param command - npm install command to execute
+ * @param cwd - Working directory
+ */
+export declare function executeNpmInstall(command: string, cwd: string): void;
+/**
+ * Install dependencies using npm
+ * @param targetDir - Base directory containing webapplications/<app-name>, or direct path to web app directory if webAppDirPath is provided
+ * @param patchDependencies - Dependencies to install from feature patches
+ * @param webAppDirPath - Optional direct path to the web application directory
+ */
+export declare function mergePackageJson(targetDir: string, patchDependencies: PackageJsonDependencies, webAppDirPath?: string): Promise<string[]>;
+//# sourceMappingURL=package-json-merger.d.ts.map

package/dist/core/package-json-merger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"package-json-merger.d.ts","sourceRoot":"","sources":["../../src/core/package-json-merger.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AAI3D,qBAAa,qBAAsB,SAAQ,KAAK;gBACnC,OAAO,EAAE,MAAM;CAI3B;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,EAAE,CAOhF;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,YAAY,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,OAAO,GAAG,MAAM,CAIlF;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CASpE;AAmCD;;;;;GAKG;AACH,wBAAsB,gBAAgB,CACrC,SAAS,EAAE,MAAM,EACjB,iBAAiB,EAAE,uBAAuB,EAC1C,aAAa,CAAC,EAAE,MAAM,GACpB,OAAO,CAAC,MAAM,EAAE,CAAC,CAwEnB"}

package/dist/core/package-json-merger.js

@@ -0,0 +1,149 @@
+/**
+ * Copyright (c) 2026, Salesforce, Inc.,
+ * All rights reserved.
+ * For full license text, see the LICENSE.txt file
+ */
+import { execSync } from "child_process";
+import { existsSync, readFileSync, writeFileSync } from "fs";
+import { join } from "path";
+import * as logger from "../utils/logger.js";
+import { getWebApplicationPath } from "../utils/validation.js";
+export class PackageJsonMergeError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "PackageJsonMergeError";
+    }
+}
+/**
+ * Build package specs array from dependencies object
+ * @param dependencies - Object mapping package names to versions
+ * @returns Array of package specs in format "package@version"
+ */
+export function buildPackageSpecs(dependencies) {
+    return Object.entries(dependencies)
+        .filter(([, version]) => {
+        // Filter out wildcard versions and workspace protocol (npm doesn't support workspace:)
+        return version !== "*" && !version.startsWith("workspace:");
+    })
+        .map(([name, version]) => `${name}@${version}`);
+}
+/**
+ * Build npm install command for package specs
+ * @param packageSpecs - Array of package specs
+ * @param isDev - Whether these are dev dependencies
+ * @returns npm install command string
+ */
+export function buildInstallCommand(packageSpecs, isDev) {
+    const devFlag = isDev ? "--save-dev" : "--save";
+    // Use --no-workspaces to avoid workspace protocol issues when installing in dist directories
+    return `npm install ${devFlag} ${packageSpecs.join(" ")} --prefer-dedupe --no-workspaces`;
+}
+/**
+ * Execute npm install command (extracted for testability)
+ * @param command - npm install command to execute
+ * @param cwd - Working directory
+ */
+export function executeNpmInstall(command, cwd) {
+    execSync(command, {
+        cwd,
+        stdio: "inherit",
+        env: {
+            ...process.env,
+            ESBUILD_BINARY_PATH: "", // Force esbuild to use the version from package-lock.json
+        },
+    });
+}
+/**
+ * Replace workspace:* dependencies with * to avoid npm workspace protocol errors
+ * npm doesn't support workspace: protocol, so we replace it with * which we filter out
+ */
+function replaceWorkspaceDependencies(packageJsonPath) {
+    const packageJson = JSON.parse(readFileSync(packageJsonPath, "utf-8"));
+    let modified = false;
+    // Replace workspace:* in dependencies
+    if (packageJson.dependencies) {
+        for (const [key, value] of Object.entries(packageJson.dependencies)) {
+            if (typeof value === "string" && value.startsWith("workspace:")) {
+                packageJson.dependencies[key] = "*";
+                modified = true;
+            }
+        }
+    }
+    // Replace workspace:* in devDependencies
+    if (packageJson.devDependencies) {
+        for (const [key, value] of Object.entries(packageJson.devDependencies)) {
+            if (typeof value === "string" && value.startsWith("workspace:")) {
+                packageJson.devDependencies[key] = "*";
+                modified = true;
+            }
+        }
+    }
+    if (modified) {
+        writeFileSync(packageJsonPath, JSON.stringify(packageJson, null, 2) + "\n");
+    }
+}
+/**
+ * Install dependencies using npm
+ * @param targetDir - Base directory containing webapplications/<app-name>, or direct path to web app directory if webAppDirPath is provided
+ * @param patchDependencies - Dependencies to install from feature patches
+ * @param webAppDirPath - Optional direct path to the web application directory
+ */
+export async function mergePackageJson(targetDir, patchDependencies, webAppDirPath) {
+    // Get the web application directory where package.json is located
+    const webAppDir = webAppDirPath || getWebApplicationPath(targetDir);
+    const packageJsonPath = join(webAppDir, "package.json");
+    if (!existsSync(packageJsonPath)) {
+        throw new PackageJsonMergeError(`package.json not found at '${packageJsonPath}'. Expected in web application directory.`);
+    }
+    // Replace workspace:* dependencies before installing to avoid npm errors
+    replaceWorkspaceDependencies(packageJsonPath);
+    try {
+        const changes = [];
+        // Install dependencies
+        if (patchDependencies.dependencies) {
+            const packageSpecs = buildPackageSpecs(patchDependencies.dependencies);
+            if (packageSpecs.length > 0) {
+                logger.info(`Installing ${packageSpecs.length} dependency/dependencies...`);
+                packageSpecs.forEach((spec) => logger.info(`  ${spec}`));
+                try {
+                    const command = buildInstallCommand(packageSpecs, false);
+                    executeNpmInstall(command, webAppDir);
+                    changes.push(...packageSpecs);
+                }
+                catch (err) {
+                    throw new PackageJsonMergeError(`Failed to install dependencies: ${err instanceof Error ? err.message : String(err)}`);
+                }
+            }
+        }
+        // Install devDependencies
+        if (patchDependencies.devDependencies) {
+            const packageSpecs = buildPackageSpecs(patchDependencies.devDependencies);
+            if (packageSpecs.length > 0) {
+                logger.info(`Installing ${packageSpecs.length} dev dependency/dependencies...`);
+                packageSpecs.forEach((spec) => logger.info(`  ${spec}`));
+                try {
+                    const command = buildInstallCommand(packageSpecs, true);
+                    executeNpmInstall(command, webAppDir);
+                    changes.push(...packageSpecs.map((spec) => `${spec} (dev)`));
+                }
+                catch (err) {
+                    throw new PackageJsonMergeError(`Failed to install dev dependencies: ${err instanceof Error ? err.message : String(err)}`);
+                }
+            }
+        }
+        if (changes.length > 0) {
+            logger.success(`Installed ${changes.length} dependency change(s)`);
+        }
+        else {
+            logger.info("No new dependencies to install");
+        }
+        return changes;
+    }
+    catch (err) {
+        if (err instanceof PackageJsonMergeError) {
+            throw err;
+        }
+        throw new PackageJsonMergeError(`Failed to install dependencies: ${err instanceof Error ? err.message : String(err)}`);
+    }
+}
+//# sourceMappingURL=package-json-merger.js.map

package/dist/core/package-json-merger.js.map

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

package/dist/core/patch-loader.d.ts

@@ -0,0 +1,18 @@
+import type { Feature, PathMappings } from "../types.js";
+export declare class FeatureLoadError extends Error {
+    constructor(message: string);
+}
+export interface FeatureConfig {
+    features: Feature[];
+    templateDir: string;
+    webAppName: string;
+    routeFilePath: string;
+    dependencies: string[];
+    pathMappings: PathMappings;
+    siteContainer: boolean;
+}
+/**
+ * Load features from a feature's feature.ts file
+ */
+export declare function loadFeature(featurePath: string): Promise<FeatureConfig>;
+//# sourceMappingURL=patch-loader.d.ts.map

package/dist/core/patch-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"patch-loader.d.ts","sourceRoot":"","sources":["../../src/core/patch-loader.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEzD,qBAAa,gBAAiB,SAAQ,KAAK;gBAC9B,OAAO,EAAE,MAAM;CAI3B;AAED,MAAM,WAAW,aAAa;IAC7B,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,YAAY,EAAE,YAAY,CAAC;IAC3B,aAAa,EAAE,OAAO,CAAC;CACvB;AAcD;;GAEG;AACH,wBAAsB,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAmG7E"}