@salesforce/ui-bundle-features 1.117.2

package/LICENSE.txt

@@ -0,0 +1,82 @@
+Terms of Use
+
+Copyright 2026 Salesforce, Inc. All rights reserved.
+
+These Terms of Use govern the download, installation, and/or use of this
+software provided by Salesforce, Inc. ("Salesforce") (the "Software"), were
+last updated on April 15, 2025, and constitute a legally binding
+agreement between you and Salesforce. If you do not agree to these Terms of
+Use, do not install or use the Software.
+
+Salesforce grants you a worldwide, non-exclusive, no-charge, royalty-free
+copyright license to reproduce, prepare derivative works of, publicly
+display, publicly perform, sublicense, and distribute the Software and
+derivative works subject to these Terms. These Terms shall be included in
+all copies or substantial portions of the Software.
+
+Subject to the limited rights expressly granted hereunder, Salesforce
+reserves all rights, title, and interest in and to all intellectual
+property subsisting in the Software. No rights are granted to you hereunder
+other than as expressly set forth herein. Users residing in countries on
+the United States Office of Foreign Assets Control sanction list, or which
+are otherwise subject to a US export embargo, may not use the Software.
+
+Implementation of the Software may require development work, for which you
+are responsible. The Software may contain bugs, errors and
+incompatibilities and is made available on an AS IS basis without support,
+updates, or service level commitments.
+
+Salesforce reserves the right at any time to modify, suspend, or
+discontinue, the Software (or any part thereof) with or without notice. You
+agree that Salesforce shall not be liable to you or to any third party for
+any modification, suspension, or discontinuance.
+
+You agree to defend Salesforce against any claim, demand, suit or
+proceeding made or brought against Salesforce by a third party arising out
+of or accruing from (a) your use of the Software, and (b) any application
+you develop with the Software that infringes any copyright, trademark,
+trade secret, trade dress, patent, or other intellectual property right of
+any person or defames any person or violates their rights of publicity or
+privacy (each a "Claim Against Salesforce"), and will indemnify Salesforce
+from any damages, attorney fees, and costs finally awarded against
+Salesforce as a result of, or for any amounts paid by Salesforce under a
+settlement approved by you in writing of, a Claim Against Salesforce,
+provided Salesforce (x) promptly gives you written notice of the Claim
+Against Salesforce, (y) gives you sole control of the defense and
+settlement of the Claim Against Salesforce (except that you may not settle
+any Claim Against Salesforce unless it unconditionally releases Salesforce
+of all liability), and (z) gives you all reasonable assistance, at your
+expense.
+
+WITHOUT LIMITING THE GENERALITY OF THE FOREGOING, THE SOFTWARE IS NOT
+SUPPORTED AND IS PROVIDED "AS IS," WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED. IN NO EVENT SHALL SALESFORCE HAVE ANY LIABILITY FOR ANY DAMAGES,
+INCLUDING, BUT NOT LIMITED TO, DIRECT, INDIRECT, SPECIAL, INCIDENTAL,
+PUNITIVE, OR CONSEQUENTIAL DAMAGES, OR DAMAGES BASED ON LOST PROFITS, DATA,
+OR USE, IN CONNECTION WITH THE SOFTWARE, HOWEVER CAUSED AND WHETHER IN
+CONTRACT, TORT, OR UNDER ANY OTHER THEORY OF LIABILITY, WHETHER OR NOT YOU
+HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
+
+These Terms of Use shall be governed exclusively by the internal laws of
+the State of California, without regard to its conflicts of laws
+rules. Each party hereby consents to the exclusive jurisdiction of the
+state and federal courts located in San Francisco County, California to
+adjudicate any dispute arising out of or relating to these Terms of Use and
+the download, installation, and/or use of the Software. Except as expressly
+stated herein, these Terms of Use constitute the entire agreement between
+the parties, and supersede all prior and contemporaneous agreements,
+proposals, or representations, written or oral, concerning their subject
+matter. No modification, amendment, or waiver of any provision of these
+Terms of Use shall be effective unless it is by an update to these Terms of
+Use that Salesforce makes available, or is in writing and signed by the
+party against whom the modification, amendment, or waiver is to be
+asserted.
+
+Data Privacy: Salesforce may collect, process, and store device,
+system, and other information related to your use of the Software. This
+information includes, but is not limited to, IP address, user metrics, and
+other data ("Usage Data"). Salesforce may use Usage Data for analytics,
+product development, and marketing purposes. You acknowledge that files
+generated in conjunction with the Software may contain sensitive or
+confidential data, and you are solely responsible for anonymizing and
+protecting such data.

package/README.md

@@ -0,0 +1,153 @@
+# @salesforce/ui-bundle-features
+
+CLI tool for installing UI features into Salesforce UI Bundles.
+
+## Installation
+
+### Using npx (Recommended)
+
+```bash
+npx @salesforce/ui-bundle-features <command>
+```
+
+## Usage
+
+### List Available Features
+
+```bash
+npx @salesforce/ui-bundle-features list
+```
+
+Search for specific features:
+
+```bash
+npx @salesforce/ui-bundle-features list --search "auth"
+```
+
+### Describe a Feature
+
+Get detailed information about a specific feature:
+
+```bash
+npx @salesforce/ui-bundle-features describe authentication
+```
+
+This shows:
+
+- Full description
+- Dependencies (feature and npm packages)
+- Files that will be copied
+- Integration examples
+- Components and capabilities
+
+### Install a Feature
+
+```bash
+npx @salesforce/ui-bundle-features install <feature-name> --ui-bundle-dir <path>
+```
+
+Example:
+
+```bash
+npx @salesforce/ui-bundle-features install authentication --ui-bundle-dir my-ui-bundle
+```
+
+#### Installation Options
+
+- `--ui-bundle-dir <name>` - **Required**. UI Bundle name, resolves to `<sfdx-source>/uiBundles/<name>`
+- `--sfdx-source <path>` - Optional. SFDX source directory (default: `force-app/main/default`)
+- `--dry-run` - Preview changes without making them
+- `--verbose` or `-v` - Show detailed output
+- `--yes` or `-y` - Skip conflicts (non-destructive)
+- `--on-conflict <mode>` - Conflict resolution mode: `error`, `skip`, `overwrite`, or `prompt` (default)
+- `--conflict-resolution <file>` - JSON file with per-file conflict resolutions
+
+### Handling Conflicts
+
+The recommended workflow for LLMs and automated tools:
+
+1. **First, detect conflicts:**
+
+   ```bash
+   npx @salesforce/ui-bundle-features install authentication \
+     --ui-bundle-dir my-ui-bundle \
+     --on-conflict error
+   ```
+
+2. **If conflicts are detected**, create a resolution file:
+
+   ```json
+   {
+     "path/to/file1": "overwrite",
+     "path/to/file2": "skip",
+     "path/to/file3": "overwrite"
+   }
+   ```
+
+3. **Rerun with resolution file:**
+   ```bash
+   npx @salesforce/ui-bundle-features install authentication \
+     --ui-bundle-dir my-ui-bundle \
+     --conflict-resolution resolution.json
+   ```
+
+### Integration Examples
+
+After installation, the CLI will list any `__example__` files that need manual integration:
+
+```
+Example files to integrate:
+  src/__example__auth-app.tsx → Integrate into: src/app.tsx
+```
+
+For each example file:
+
+1. Read the example file to see the integration pattern
+2. Apply the pattern to your target file
+3. Delete the example file after integration
+
+## Available Features
+
+Run `npx @salesforce/ui-bundle-features list` to see all available features.
+
+Common features:
+
+- **authentication** - Complete auth system with login, registration, password reset
+- **shadcn** - UI component library based on shadcn/ui
+- **global-search** - Salesforce object search
+- **nav-menu** - Navigation menu layout
+- **charts** - Analytics charts with Recharts
+- **agentforce** - AI-powered conversation interface
+
+## Local Development
+
+### Building
+
+```bash
+npm run build
+```
+
+### Running locally
+
+```bash
+npm run dev -- <command>
+```
+
+Example:
+
+```bash
+npm run dev -- list
+npm run dev -- install authentication --ui-bundle-dir /path/to/ui-bundle
+```
+
+### Global install from local build
+
+```bash
+npm run build && npm link
+```
+
+Then use `ui-bundle-features <command>` directly without `npx`.
+
+## License
+
+SEE LICENSE IN LICENSE.txt

package/dist/aggregate-features.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Copyright (c) 2026, Salesforce, Inc.,
+ * All rights reserved.
+ * For full license text, see the LICENSE.txt file
+ */
+import type { FeaturesMetadata } from "./types.js";
+/**
+ * Aggregates individual feature.ts files from a base directory into a FeaturesMetadata object.
+ * Scans each subdirectory for a feature.ts file, imports it, and collects the metadata.
+ *
+ * @param featureBaseDir - The directory containing feature subdirectories
+ * @returns The aggregated features metadata
+ * @throws If duplicate feature keys are found
+ */
+export declare function aggregateFeatures(featureBaseDir: string): Promise<FeaturesMetadata>;
+//# sourceMappingURL=aggregate-features.d.ts.map

package/dist/aggregate-features.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"aggregate-features.d.ts","sourceRoot":"","sources":["../src/aggregate-features.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAyB,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAE1E;;;;;;;GAOG;AACH,wBAAsB,iBAAiB,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CA0BzF"}

package/dist/aggregate-features.js

@@ -0,0 +1,43 @@
+/**
+ * Copyright (c) 2026, Salesforce, Inc.,
+ * All rights reserved.
+ * For full license text, see the LICENSE.txt file
+ */
+var __rewriteRelativeImportExtension = (this && this.__rewriteRelativeImportExtension) || function (path, preserveJsx) {
+    if (typeof path === "string" && /^\.\.?\//.test(path)) {
+        return path.replace(/\.(tsx)$|((?:\.d)?)((?:\.[^./]+?)?)\.([cm]?)ts$/i, function (m, tsx, d, ext, cm) {
+            return tsx ? preserveJsx ? ".jsx" : ".js" : d && (!ext || !cm) ? m : (d + ext + "." + cm.toLowerCase() + "js");
+        });
+    }
+    return path;
+};
+import { existsSync, readdirSync } from "fs";
+import { join } from "path";
+/**
+ * Aggregates individual feature.ts files from a base directory into a FeaturesMetadata object.
+ * Scans each subdirectory for a feature.ts file, imports it, and collects the metadata.
+ *
+ * @param featureBaseDir - The directory containing feature subdirectories
+ * @returns The aggregated features metadata
+ * @throws If duplicate feature keys are found
+ */
+export async function aggregateFeatures(featureBaseDir) {
+    const featureDirs = readdirSync(featureBaseDir, { withFileTypes: true })
+        .filter((entry) => entry.isDirectory())
+        .map((entry) => entry.name);
+    const aggregated = { features: {} };
+    for (const dir of featureDirs) {
+        const featureTsPath = join(featureBaseDir, dir, "feature.ts");
+        if (!existsSync(featureTsPath)) {
+            continue;
+        }
+        const mod = (await import(__rewriteRelativeImportExtension(featureTsPath)));
+        const { key, ...metadata } = mod.default;
+        if (aggregated.features[key]) {
+            throw new Error(`Duplicate feature key "${key}" found in ${dir}/feature.ts`);
+        }
+        aggregated.features[key] = metadata;
+    }
+    return aggregated;
+}
+//# sourceMappingURL=aggregate-features.js.map

package/dist/aggregate-features.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"aggregate-features.js","sourceRoot":"","sources":["../src/aggregate-features.ts"],"names":[],"mappings":"AAAA;;;;GAIG;;;;;;;;;AAEH,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,IAAI,CAAC;AAC7C,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAG5B;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,cAAsB;IAC7D,MAAM,WAAW,GAAG,WAAW,CAAC,cAAc,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC;SACtE,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC;SACtC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAE7B,MAAM,UAAU,GAAqB,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC;IAEtD,KAAK,MAAM,GAAG,IAAI,WAAW,EAAE,CAAC;QAC/B,MAAM,aAAa,GAAG,IAAI,CAAC,cAAc,EAAE,GAAG,EAAE,YAAY,CAAC,CAAC;QAC9D,IAAI,CAAC,UAAU,CAAC,aAAa,CAAC,EAAE,CAAC;YAChC,SAAS;QACV,CAAC;QAED,MAAM,GAAG,GAAG,CAAC,MAAM,MAAM,kCAAC,aAAa,EAAC,CAEvC,CAAC;QACF,MAAM,EAAE,GAAG,EAAE,GAAG,QAAQ,EAAE,GAAG,GAAG,CAAC,OAAO,CAAC;QAEzC,IAAI,UAAU,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;YAC9B,MAAM,IAAI,KAAK,CAAC,0BAA0B,GAAG,cAAc,GAAG,aAAa,CAAC,CAAC;QAC9E,CAAC;QAED,UAAU,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,QAAQ,CAAC;IACrC,CAAC;IAED,OAAO,UAAU,CAAC;AACnB,CAAC"}

package/dist/cli.d.ts

@@ -0,0 +1,8 @@
+#!/usr/bin/env node
+/**
+ * Copyright (c) 2026, Salesforce, Inc.,
+ * All rights reserved.
+ * For full license text, see the LICENSE.txt file
+ */
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA;;;;GAIG"}

package/dist/cli.js

@@ -0,0 +1,71 @@
+#!/usr/bin/env node
+/**
+ * Copyright (c) 2026, Salesforce, Inc.,
+ * All rights reserved.
+ * For full license text, see the LICENSE.txt file
+ */
+import { readFileSync } from "fs";
+import { dirname, join } from "path";
+import { fileURLToPath } from "url";
+import { Command, Option } from "commander";
+import { describeFeature } from "./describe-command.js";
+import { getInstallHelpText, install } from "./install-command.js";
+import { listFeatures } from "./list-command.js";
+import { Logger } from "./logger.js";
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+const { version: cliVersion } = JSON.parse(readFileSync(join(__dirname, "..", "package.json"), "utf-8"));
+const program = new Command();
+// Configure main CLI
+program
+    .name("ui-bundle-features")
+    .description("Manage Salesforce UI bundle features")
+    .version(cliVersion);
+// Install command
+program
+    .command("install")
+    .description("Install a Salesforce UI bundle feature package")
+    .argument("<feature>", 'Feature name (e.g., "authentication", "shadcn") or npm package name')
+    .requiredOption("--ui-bundle-dir <name>", "UI bundle name, resolves to <sfdx-source>/uiBundles/<name>")
+    .option("--sfdx-source <path>", "SFDX source directory (default: force-app/main/default)", "force-app/main/default")
+    .option("-v, --verbose", "Enable verbose logging", false)
+    .option("--dry-run", "Show what would be done without making changes", false)
+    .option("-y, --yes", "Skip all prompts (auto-skip conflicts)", false)
+    .addOption(new Option("--on-conflict <mode>", "Conflict handling mode: prompt, error, skip, overwrite")
+    .choices(["prompt", "error", "skip", "overwrite"])
+    .default("prompt"))
+    .option("--conflict-resolution <file>", "Path to JSON file with conflict resolutions")
+    .addHelpText("after", getInstallHelpText())
+    .action(async (featureName, options) => {
+    try {
+        await install(featureName, options);
+    }
+    catch (error) {
+        const logger = new Logger(options.verbose || false);
+        if (error instanceof Error) {
+            logger.error(error.message, error);
+        }
+        else {
+            logger.error("Installation failed", error);
+        }
+        process.exit(1);
+    }
+});
+// List command
+program
+    .command("list")
+    .description("List all available features")
+    .option("-v, --verbose", "Show detailed information", false)
+    .option("--search <query>", "Search features by keyword")
+    .action((options) => {
+    listFeatures(options);
+});
+// Describe command
+program
+    .command("describe <feature>")
+    .description("Show detailed information about a specific feature")
+    .action((featureName) => {
+    describeFeature(featureName);
+});
+program.parse();
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/conflict-detector.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Copyright (c) 2026, Salesforce, Inc.,
+ * All rights reserved.
+ * For full license text, see the LICENSE.txt file
+ */
+import type { ConflictResolution, InstallationContext } from "./types.js";
+/**
+ * Check if a path already exists (file or directory)
+ * For directories, we don't consider them conflicts - only individual files
+ */
+export declare function hasConflict(path: string): boolean;
+/**
+ * Resolve a conflict based on the context's conflict mode
+ */
+export declare function resolveConflict(path: string, context: InstallationContext): Promise<ConflictResolution>;
+/**
+ * Collect all conflicts for error mode
+ * Returns a list of conflicting paths
+ *
+ * For directory operations, we need the source path to check individual files
+ */
+export declare function collectConflicts(operations: {
+    from: string;
+    to: string;
+    sourcePath: string;
+}[]): string[];
+/**
+ * Output error message with conflict list and instructions
+ */
+export declare function outputConflictError(conflicts: string[]): void;
+//# sourceMappingURL=conflict-detector.d.ts.map

package/dist/conflict-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conflict-detector.d.ts","sourceRoot":"","sources":["../src/conflict-detector.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,OAAO,KAAK,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAE1E;;;GAGG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAiBjD;AAED;;GAEG;AACH,wBAAsB,eAAe,CACpC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,mBAAmB,GAC1B,OAAO,CAAC,kBAAkB,CAAC,CA6B7B;AAwBD;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC/B,UAAU,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,EAAE,GAC5D,MAAM,EAAE,CASV;AAkDD;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,IAAI,CA8B7D"}

package/dist/conflict-detector.js

@@ -0,0 +1,153 @@
+/**
+ * Copyright (c) 2026, Salesforce, Inc.,
+ * All rights reserved.
+ * For full license text, see the LICENSE.txt file
+ */
+import { existsSync, readdirSync, statSync } from "fs";
+import { join } from "path";
+import inquirer from "inquirer";
+/**
+ * Check if a path already exists (file or directory)
+ * For directories, we don't consider them conflicts - only individual files
+ */
+export function hasConflict(path) {
+    if (!existsSync(path)) {
+        return false;
+    }
+    // If it's a file, it's a conflict
+    try {
+        const stats = statSync(path);
+        if (stats.isFile()) {
+            return true;
+        }
+        // If it's a directory, it's not a conflict - we can merge into it
+        return false;
+    }
+    catch (_error) {
+        // If we can't stat it, assume no conflict
+        return false;
+    }
+}
+/**
+ * Resolve a conflict based on the context's conflict mode
+ */
+export async function resolveConflict(path, context) {
+    // Check if we already have a resolution for this path
+    if (context.conflictResolutions[path]) {
+        return context.conflictResolutions[path];
+    }
+    const mode = context.conflictMode;
+    const logger = context.logger;
+    switch (mode) {
+        case "prompt":
+            return await promptForResolution(path);
+        case "error":
+            // In error mode, we don't resolve - just return 'cancel' to stop
+            return "cancel";
+        case "skip":
+            logger.debug(`Auto-skipping conflict: ${path}`);
+            return "skip";
+        case "overwrite":
+            logger.debug(`Auto-overwriting conflict: ${path}`);
+            return "overwrite";
+        default:
+            throw new Error(`Unknown conflict mode: ${mode}`);
+    }
+}
+/**
+ * Prompt user interactively for conflict resolution
+ */
+async function promptForResolution(path) {
+    console.warn(`[WARN] Destination already exists: ${path}`);
+    const answer = await inquirer.prompt([
+        {
+            type: "list",
+            name: "resolution",
+            message: `File/directory already exists: ${path}. What would you like to do?`,
+            choices: [
+                { name: "Skip (keep existing)", value: "skip" },
+                { name: "Overwrite (loses customizations)", value: "overwrite" },
+                { name: "Cancel installation", value: "cancel" },
+            ],
+        },
+    ]);
+    return answer.resolution;
+}
+/**
+ * Collect all conflicts for error mode
+ * Returns a list of conflicting paths
+ *
+ * For directory operations, we need the source path to check individual files
+ */
+export function collectConflicts(operations) {
+    const conflicts = [];
+    for (const op of operations) {
+        const fileConflicts = getConflictsForOperation(op.sourcePath, op.to);
+        conflicts.push(...fileConflicts);
+    }
+    return conflicts;
+}
+/**
+ * Get all conflicting files for a single copy operation
+ * Handles both file and directory copies
+ */
+function getConflictsForOperation(sourcePath, destPath) {
+    const conflicts = [];
+    // Check if destination exists
+    if (!existsSync(destPath)) {
+        return conflicts;
+    }
+    try {
+        const sourceStats = statSync(sourcePath);
+        const destStats = statSync(destPath);
+        // If source is a file and dest is a file, it's a conflict
+        if (sourceStats.isFile() && destStats.isFile()) {
+            conflicts.push(destPath);
+            return conflicts;
+        }
+        // If source is a directory and dest is a file, it's a conflict
+        if (sourceStats.isDirectory() && destStats.isFile()) {
+            conflicts.push(destPath);
+            return conflicts;
+        }
+        // If source is a directory and dest is a directory, check contents recursively
+        if (sourceStats.isDirectory() && destStats.isDirectory()) {
+            const sourceFiles = readdirSync(sourcePath);
+            for (const file of sourceFiles) {
+                const sourceFile = join(sourcePath, file);
+                const destFile = join(destPath, file);
+                // Recursively check for conflicts in subdirectories
+                const subConflicts = getConflictsForOperation(sourceFile, destFile);
+                conflicts.push(...subConflicts);
+            }
+        }
+    }
+    catch (_error) {
+        // If we can't stat, no conflict
+        return conflicts;
+    }
+    return conflicts;
+}
+/**
+ * Output error message with conflict list and instructions
+ */
+export function outputConflictError(conflicts) {
+    console.error("[ERROR] Conflicts detected during installation");
+    console.log("\nConflicts found:");
+    conflicts.forEach((path, index) => {
+        console.log(`${index + 1}. ${path} (${existsSync(path) ? "already exists" : "unknown"})`);
+    });
+    console.log("\nTo resolve, create a conflict resolution file:\n");
+    console.log("Example conflict-resolution.json:");
+    const exampleResolutions = {};
+    conflicts.forEach((path) => {
+        exampleResolutions[path] = "overwrite"; // or 'skip'
+    });
+    console.log(JSON.stringify(exampleResolutions, null, 2));
+    console.log("\nThen run:");
+    console.log("npx @salesforce/ui-bundle-features install <feature> --conflict-resolution conflict-resolution.json");
+    console.log("\nOr use automatic modes:");
+    console.log("npx @salesforce/ui-bundle-features install <feature> --on-conflict skip (keeps all existing files)");
+    console.log("npx @salesforce/ui-bundle-features install <feature> --on-conflict overwrite (replaces all files - destructive)");
+}
+//# sourceMappingURL=conflict-detector.js.map

package/dist/conflict-detector.js.map

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

package/dist/dependency-resolver.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Copyright (c) 2026, Salesforce, Inc.,
+ * All rights reserved.
+ * For full license text, see the LICENSE.txt file
+ */
+import type { FileCopySchema, InstallationContext } from "./types.js";
+/**
+ * Resolve and install feature dependencies recursively
+ * Follows the exact workflow: install package -> load schema -> recursively process
+ */
+export declare function resolveFeatureDependencies(dependencies: readonly string[], context: InstallationContext): Promise<void>;
+/**
+ * Process the "own" operations for a feature (package deps + copies),
+ * excluding recursive feature dependency resolution.
+ * Used by cli.ts for the main feature's section.
+ */
+export declare function processFeatureOwnOperations(schema: FileCopySchema, packageName: string, context: InstallationContext): Promise<void>;
+//# sourceMappingURL=dependency-resolver.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dependency-resolver.d.ts","sourceRoot":"","sources":["../src/dependency-resolver.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AASH,OAAO,KAAK,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEtE;;;GAGG;AACH,wBAAsB,0BAA0B,CAC/C,YAAY,EAAE,SAAS,MAAM,EAAE,EAC/B,OAAO,EAAE,mBAAmB,GAC1B,OAAO,CAAC,IAAI,CAAC,CAIf;AA+ED;;;;GAIG;AACH,wBAAsB,2BAA2B,CAChD,MAAM,EAAE,cAAc,EACtB,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,mBAAmB,GAC1B,OAAO,CAAC,IAAI,CAAC,CAcf"}