@salesforce/ui-bundle-features 1.117.2

package/dist/dependency-resolver.js

@@ -0,0 +1,96 @@
+/**
+ * Copyright (c) 2026, Salesforce, Inc.,
+ * All rights reserved.
+ * For full license text, see the LICENSE.txt file
+ */
+import { getFeatureMetadata } from "./feature-metadata.js";
+import { executeCopyOperations } from "./file-copier.js";
+import { installPackage, installPackageDependencies, isPackageInstalled, } from "./package-manager.js";
+/**
+ * Resolve and install feature dependencies recursively
+ * Follows the exact workflow: install package -> load schema -> recursively process
+ */
+export async function resolveFeatureDependencies(dependencies, context) {
+    for (const dependency of dependencies) {
+        await installFeatureDependency(dependency, context);
+    }
+}
+/**
+ * Install a single feature dependency with section-delimited output
+ */
+async function installFeatureDependency(featureName, context) {
+    const logger = context.logger;
+    // Resolve feature name to package name
+    // Dependencies are defined statically by feature authors, not user input.
+    // If a dependency is not found, it indicates a bug in the CLI or feature definition.
+    const feature = getFeatureMetadata(featureName);
+    if (!feature) {
+        throw new Error(`Internal error: feature dependency "${featureName}" not found in the feature registry. ` +
+            `This is a bug in the features CLI — please report it.`);
+    }
+    const packageName = feature.package;
+    const displayName = featureName;
+    // Check if already installed
+    if (context.installedFeatures.has(packageName)) {
+        logger.debug(`Feature dependency already installed: ${packageName}`);
+        return;
+    }
+    // Step 1: Install the package (before opening section, so npm output is suppressed)
+    if (!isPackageInstalled(packageName, context.uiBundleDir)) {
+        await installPackage(packageName, true, context.uiBundleDir, context.dryRun, context.verbose);
+    }
+    else {
+        logger.debug(`Package already in node_modules: ${packageName}`);
+    }
+    // Mark as installed to prevent duplicate processing
+    context.installedFeatures.add(packageName);
+    if (context.dryRun) {
+        logger.info(`[DRY RUN] Would process feature dependency schema: ${packageName}`);
+        return;
+    }
+    // Step 2: Build schema from feature metadata
+    const schema = {
+        featureDependencies: feature.featureDependencies,
+        packageDependencies: feature.packageDependencies,
+        packageDevDependencies: feature.packageDevDependencies,
+        copy: feature.copy,
+    };
+    logger.debug(`Processing schema for dependency: ${packageName}`);
+    // Step 3: Install sub-dependencies first (they get their own sections)
+    if (schema.featureDependencies && schema.featureDependencies.length > 0) {
+        await resolveFeatureDependencies(schema.featureDependencies, context);
+    }
+    // Step 4: Open section for THIS dependency
+    logger.section(`Installing dependency: ${displayName}`);
+    logger.plain(`Installing package: ${packageName}`);
+    // Step 5: Install package dependencies (inside section)
+    if (schema.packageDependencies || schema.packageDevDependencies) {
+        logger.blank();
+        await installPackageDependencies(schema, context);
+    }
+    // Step 6: Execute copy operations (inside section)
+    if (schema.copy && schema.copy.length > 0) {
+        logger.blank();
+        await executeCopyOperations(schema.copy, packageName, context);
+    }
+    logger.sectionEnd(`Dependency installed: ${displayName}`);
+}
+/**
+ * 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 async function processFeatureOwnOperations(schema, packageName, context) {
+    const logger = context.logger;
+    // Install packageDependencies
+    if (schema.packageDependencies || schema.packageDevDependencies) {
+        logger.blank();
+        await installPackageDependencies(schema, context);
+    }
+    // Execute copy operations
+    if (schema.copy && schema.copy.length > 0) {
+        logger.blank();
+        await executeCopyOperations(schema.copy, packageName, context);
+    }
+}
+//# sourceMappingURL=dependency-resolver.js.map

package/dist/dependency-resolver.js.map

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

package/dist/describe-command.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Copyright (c) 2026, Salesforce, Inc.,
+ * All rights reserved.
+ * For full license text, see the LICENSE.txt file
+ */
+/**
+ * Describe a specific feature in detail
+ */
+export declare function describeFeature(featureName: string): void;
+//# sourceMappingURL=describe-command.d.ts.map

package/dist/describe-command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"describe-command.d.ts","sourceRoot":"","sources":["../src/describe-command.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AASH;;GAEG;AACH,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CA4HzD"}

package/dist/describe-command.js

@@ -0,0 +1,119 @@
+/**
+ * Copyright (c) 2026, Salesforce, Inc.,
+ * All rights reserved.
+ * For full license text, see the LICENSE.txt file
+ */
+import { getAllFeatures, getFeatureMetadata, resolveFeatureName, suggestSimilarFeatures, } from "./feature-metadata.js";
+/**
+ * Describe a specific feature in detail
+ */
+export function describeFeature(featureName) {
+    const resolvedName = resolveFeatureName(featureName);
+    if (!resolvedName) {
+        console.error(`\nFeature not found: ${featureName}\n`);
+        const suggestions = suggestSimilarFeatures(featureName);
+        if (suggestions.length > 0) {
+            console.log("Did you mean?");
+            for (const s of suggestions) {
+                console.log(`  - ${s}`);
+            }
+        }
+        else {
+            console.log("Available features:");
+            const allFeatures = getAllFeatures();
+            for (const [name] of Object.entries(allFeatures)) {
+                console.log(`  - ${name}`);
+            }
+        }
+        console.log('\nUse "npx @salesforce/ui-bundle-features list" to see all features\n');
+        process.exit(1);
+    }
+    const feature = getFeatureMetadata(resolvedName);
+    console.log("\n" + "=".repeat(80));
+    console.log(`${feature.name}`);
+    console.log("=".repeat(80));
+    console.log();
+    console.log("Description:");
+    console.log(`  ${feature.longDescription}`);
+    console.log();
+    console.log("Package:", feature.package);
+    console.log();
+    if (feature.keywords && feature.keywords.length > 0) {
+        console.log("Keywords:", feature.keywords.join(", "));
+        console.log();
+    }
+    if (feature.featureDependencies && feature.featureDependencies.length > 0) {
+        console.log("Feature Dependencies:");
+        for (const dep of feature.featureDependencies) {
+            const depMeta = getFeatureMetadata(dep);
+            console.log(`  - ${dep}${depMeta ? ` (${depMeta.package})` : ""}`);
+        }
+        console.log();
+    }
+    if (feature.packageDependencies && Object.keys(feature.packageDependencies).length > 0) {
+        console.log("Package Dependencies:");
+        for (const [pkg, version] of Object.entries(feature.packageDependencies)) {
+            console.log(`  - ${pkg}@${version}`);
+        }
+        console.log();
+    }
+    if (feature.packageDevDependencies && Object.keys(feature.packageDevDependencies).length > 0) {
+        console.log("Package Dev Dependencies:");
+        for (const [pkg, version] of Object.entries(feature.packageDevDependencies)) {
+            console.log(`  - ${pkg}@${version}`);
+        }
+        console.log();
+    }
+    if (feature.copy && feature.copy.length > 0) {
+        const regularCopies = feature.copy.filter((op) => !op.integrationTarget);
+        const exampleFiles = feature.copy.filter((op) => op.integrationTarget);
+        if (regularCopies.length > 0) {
+            console.log("Copy Operations:");
+            for (const op of regularCopies) {
+                console.log(`  - ${op.from} → ${op.to}`);
+                if (op.description) {
+                    console.log(`    ${op.description}`);
+                }
+            }
+            console.log();
+        }
+        if (exampleFiles.length > 0) {
+            console.log("Integration Examples:");
+            console.log("  These __example__ files show how to integrate the feature:");
+            console.log();
+            for (const op of exampleFiles) {
+                console.log(`  - ${op.to.split("/").pop()}`);
+                if (op.description) {
+                    console.log(`    ${op.description}`);
+                }
+                if (op.integrationTarget) {
+                    console.log(`    Review and integrate patterns into: ${op.integrationTarget}`);
+                    console.log(`    Then delete the example file`);
+                }
+            }
+            console.log();
+        }
+    }
+    if (feature.features && feature.features.length > 0) {
+        console.log("Features:");
+        for (const item of feature.features) {
+            console.log(`  - ${item}`);
+        }
+        console.log();
+    }
+    if (feature.components && feature.components.length > 0) {
+        console.log("Components:");
+        for (const component of feature.components) {
+            console.log(`  - ${component}`);
+        }
+        console.log();
+    }
+    console.log("Installation:");
+    console.log(`  npx @salesforce/ui-bundle-features install ${resolvedName} --ui-bundle-dir <path>`);
+    console.log();
+    console.log("Example:");
+    console.log(`  npx @salesforce/ui-bundle-features install ${resolvedName} \\`);
+    console.log("    --ui-bundle-dir force-app/main/default/uiBundles/my-ui-bundle");
+    console.log();
+}
+//# sourceMappingURL=describe-command.js.map

package/dist/describe-command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"describe-command.js","sourceRoot":"","sources":["../src/describe-command.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACN,cAAc,EACd,kBAAkB,EAClB,kBAAkB,EAClB,sBAAsB,GACtB,MAAM,uBAAuB,CAAC;AAE/B;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,WAAmB;IAClD,MAAM,YAAY,GAAG,kBAAkB,CAAC,WAAW,CAAC,CAAC;IAErD,IAAI,CAAC,YAAY,EAAE,CAAC;QACnB,OAAO,CAAC,KAAK,CAAC,wBAAwB,WAAW,IAAI,CAAC,CAAC;QACvD,MAAM,WAAW,GAAG,sBAAsB,CAAC,WAAW,CAAC,CAAC;QACxD,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC5B,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;YAC7B,KAAK,MAAM,CAAC,IAAI,WAAW,EAAE,CAAC;gBAC7B,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;YACzB,CAAC;QACF,CAAC;aAAM,CAAC;YACP,OAAO,CAAC,GAAG,CAAC,qBAAqB,CAAC,CAAC;YACnC,MAAM,WAAW,GAAG,cAAc,EAAE,CAAC;YACrC,KAAK,MAAM,CAAC,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,CAAC;gBAClD,OAAO,CAAC,GAAG,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC;YAC5B,CAAC;QACF,CAAC;QACD,OAAO,CAAC,GAAG,CAAC,uEAAuE,CAAC,CAAC;QACrF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACjB,CAAC;IAED,MAAM,OAAO,GAAG,kBAAkB,CAAC,YAAY,CAAE,CAAC;IAElD,OAAO,CAAC,GAAG,CAAC,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;IACnC,OAAO,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;IAC/B,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;IAC5B,OAAO,CAAC,GAAG,EAAE,CAAC;IAEd,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;IAC5B,OAAO,CAAC,GAAG,CAAC,KAAK,OAAO,CAAC,eAAe,EAAE,CAAC,CAAC;IAC5C,OAAO,CAAC,GAAG,EAAE,CAAC;IAEd,OAAO,CAAC,GAAG,CAAC,UAAU,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;IACzC,OAAO,CAAC,GAAG,EAAE,CAAC;IAEd,IAAI,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACrD,OAAO,CAAC,GAAG,CAAC,WAAW,EAAE,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QACtD,OAAO,CAAC,GAAG,EAAE,CAAC;IACf,CAAC;IAED,IAAI,OAAO,CAAC,mBAAmB,IAAI,OAAO,CAAC,mBAAmB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC3E,OAAO,CAAC,GAAG,CAAC,uBAAuB,CAAC,CAAC;QACrC,KAAK,MAAM,GAAG,IAAI,OAAO,CAAC,mBAAmB,EAAE,CAAC;YAC/C,MAAM,OAAO,GAAG,kBAAkB,CAAC,GAAG,CAAC,CAAC;YACxC,OAAO,CAAC,GAAG,CAAC,OAAO,GAAG,GAAG,OAAO,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACpE,CAAC;QACD,OAAO,CAAC,GAAG,EAAE,CAAC;IACf,CAAC;IAED,IAAI,OAAO,CAAC,mBAAmB,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,mBAAmB,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxF,OAAO,CAAC,GAAG,CAAC,uBAAuB,CAAC,CAAC;QACrC,KAAK,MAAM,CAAC,GAAG,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,mBAAmB,CAAC,EAAE,CAAC;YAC1E,OAAO,CAAC,GAAG,CAAC,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC,CAAC;QACtC,CAAC;QACD,OAAO,CAAC,GAAG,EAAE,CAAC;IACf,CAAC;IAED,IAAI,OAAO,CAAC,sBAAsB,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,sBAAsB,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC9F,OAAO,CAAC,GAAG,CAAC,2BAA2B,CAAC,CAAC;QACzC,KAAK,MAAM,CAAC,GAAG,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,sBAAsB,CAAC,EAAE,CAAC;YAC7E,OAAO,CAAC,GAAG,CAAC,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC,CAAC;QACtC,CAAC;QACD,OAAO,CAAC,GAAG,EAAE,CAAC;IACf,CAAC;IAED,IAAI,OAAO,CAAC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC7C,MAAM,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,iBAAiB,CAAC,CAAC;QACzE,MAAM,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,iBAAiB,CAAC,CAAC;QAEvE,IAAI,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC9B,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC;YAChC,KAAK,MAAM,EAAE,IAAI,aAAa,EAAE,CAAC;gBAChC,OAAO,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC,IAAI,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;gBACzC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;oBACpB,OAAO,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC;gBACtC,CAAC;YACF,CAAC;YACD,OAAO,CAAC,GAAG,EAAE,CAAC;QACf,CAAC;QAED,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC7B,OAAO,CAAC,GAAG,CAAC,uBAAuB,CAAC,CAAC;YACrC,OAAO,CAAC,GAAG,CAAC,8DAA8D,CAAC,CAAC;YAC5E,OAAO,CAAC,GAAG,EAAE,CAAC;YACd,KAAK,MAAM,EAAE,IAAI,YAAY,EAAE,CAAC;gBAC/B,OAAO,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;gBAC7C,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;oBACpB,OAAO,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC;gBACtC,CAAC;gBACD,IAAI,EAAE,CAAC,iBAAiB,EAAE,CAAC;oBAC1B,OAAO,CAAC,GAAG,CAAC,2CAA2C,EAAE,CAAC,iBAAiB,EAAE,CAAC,CAAC;oBAC/E,OAAO,CAAC,GAAG,CAAC,kCAAkC,CAAC,CAAC;gBACjD,CAAC;YACF,CAAC;YACD,OAAO,CAAC,GAAG,EAAE,CAAC;QACf,CAAC;IACF,CAAC;IAED,IAAI,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACrD,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QACzB,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;YACrC,OAAO,CAAC,GAAG,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC;QAC5B,CAAC;QACD,OAAO,CAAC,GAAG,EAAE,CAAC;IACf,CAAC;IAED,IAAI,OAAO,CAAC,UAAU,IAAI,OAAO,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACzD,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;QAC3B,KAAK,MAAM,SAAS,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;YAC5C,OAAO,CAAC,GAAG,CAAC,OAAO,SAAS,EAAE,CAAC,CAAC;QACjC,CAAC;QACD,OAAO,CAAC,GAAG,EAAE,CAAC;IACf,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;IAC7B,OAAO,CAAC,GAAG,CACV,gDAAgD,YAAY,yBAAyB,CACrF,CAAC;IACF,OAAO,CAAC,GAAG,EAAE,CAAC;IACd,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IACxB,OAAO,CAAC,GAAG,CAAC,gDAAgD,YAAY,KAAK,CAAC,CAAC;IAC/E,OAAO,CAAC,GAAG,CAAC,mEAAmE,CAAC,CAAC;IACjF,OAAO,CAAC,GAAG,EAAE,CAAC;AACf,CAAC"}

package/dist/feature-metadata.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Copyright (c) 2026, Salesforce, Inc.,
+ * All rights reserved.
+ * For full license text, see the LICENSE.txt file
+ */
+import type { FeatureMetadata } from "./types.js";
+/**
+ * Get all available features
+ */
+export declare function getAllFeatures(): Record<string, FeatureMetadata>;
+/**
+ * Resolve a feature name to its canonical (registry) key, matching case-insensitively.
+ * Returns the canonical key or null if no match is found.
+ */
+export declare function resolveFeatureName(featureName: string): string | null;
+/**
+ * Get metadata for a specific feature (case-insensitive).
+ */
+export declare function getFeatureMetadata(featureName: string): FeatureMetadata | null;
+/**
+ * Suggest similar feature names for a given input.
+ * Uses prefix matching and Levenshtein distance.
+ * Returns up to `max` suggestions sorted by relevance.
+ */
+export declare function suggestSimilarFeatures(input: string, max?: number): string[];
+/**
+ * Get feature name from package name
+ */
+export declare function getFeatureNameFromPackage(packageName: string): string | null;
+//# sourceMappingURL=feature-metadata.d.ts.map

package/dist/feature-metadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"feature-metadata.d.ts","sourceRoot":"","sources":["../src/feature-metadata.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,OAAO,KAAK,EAAE,eAAe,EAAoB,MAAM,YAAY,CAAC;AAsCpE;;GAEG;AACH,wBAAgB,cAAc,IAAI,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAGhE;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAcrE;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI,CAK9E;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,SAAI,GAAG,MAAM,EAAE,CA0BvE;AAyBD;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAU5E"}

package/dist/feature-metadata.js

@@ -0,0 +1,136 @@
+/**
+ * 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";
+// Get the directory name for ES modules
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+let metadataCache = null;
+/**
+ * Load the features metadata from features.json
+ */
+function loadMetadata() {
+    if (metadataCache) {
+        return metadataCache;
+    }
+    // Check __dirname first (works for both src/ via tsx and dist/ when compiled),
+    // then fall back to dist/ (for dev/test when running from src/).
+    const candidates = [
+        join(__dirname, "features.json"),
+        join(__dirname, "..", "dist", "features.json"),
+    ];
+    for (const metadataPath of candidates) {
+        try {
+            const content = readFileSync(metadataPath, "utf-8");
+            metadataCache = JSON.parse(content);
+            return metadataCache;
+        }
+        catch {
+            // Try next candidate
+        }
+    }
+    throw new Error(`Failed to load features.json: not found in ${candidates.join(", ")}. Run "npm run build" first.`);
+}
+/**
+ * Get all available features
+ */
+export function getAllFeatures() {
+    const metadata = loadMetadata();
+    return metadata.features;
+}
+/**
+ * Resolve a feature name to its canonical (registry) key, matching case-insensitively.
+ * Returns the canonical key or null if no match is found.
+ */
+export function resolveFeatureName(featureName) {
+    const metadata = loadMetadata();
+    // Exact match first
+    if (metadata.features[featureName]) {
+        return featureName;
+    }
+    // Case-insensitive match
+    const lower = featureName.toLowerCase();
+    for (const key of Object.keys(metadata.features)) {
+        if (key.toLowerCase() === lower) {
+            return key;
+        }
+    }
+    return null;
+}
+/**
+ * Get metadata for a specific feature (case-insensitive).
+ */
+export function getFeatureMetadata(featureName) {
+    const resolved = resolveFeatureName(featureName);
+    if (!resolved)
+        return null;
+    const metadata = loadMetadata();
+    return metadata.features[resolved] || null;
+}
+/**
+ * Suggest similar feature names for a given input.
+ * Uses prefix matching and Levenshtein distance.
+ * Returns up to `max` suggestions sorted by relevance.
+ */
+export function suggestSimilarFeatures(input, max = 3) {
+    const allFeatures = getAllFeatures();
+    const names = Object.keys(allFeatures);
+    const lower = input.toLowerCase();
+    const scored = names.map((name) => {
+        const nameLower = name.toLowerCase();
+        // Prefix match: input is a prefix of the feature name or vice versa
+        if (nameLower.startsWith(lower) || lower.startsWith(nameLower)) {
+            return { name, distance: 0 };
+        }
+        // Substring match: input appears within the feature name
+        if (nameLower.includes(lower)) {
+            return { name, distance: 1 };
+        }
+        return { name, distance: levenshtein(lower, nameLower) };
+    });
+    scored.sort((a, b) => a.distance - b.distance);
+    // Only suggest features within a reasonable edit distance
+    const maxDistance = Math.max(3, Math.floor(input.length / 2));
+    return scored
+        .filter((s) => s.distance <= maxDistance)
+        .slice(0, max)
+        .map((s) => s.name);
+}
+/**
+ * Simple Levenshtein distance between two strings.
+ */
+function levenshtein(a, b) {
+    const m = a.length;
+    const n = b.length;
+    const dp = Array.from({ length: m + 1 }, () => Array(n + 1).fill(0));
+    for (let i = 0; i <= m; i++)
+        dp[i][0] = i;
+    for (let j = 0; j <= n; j++)
+        dp[0][j] = j;
+    for (let i = 1; i <= m; i++) {
+        for (let j = 1; j <= n; j++) {
+            dp[i][j] =
+                a[i - 1] === b[j - 1]
+                    ? dp[i - 1][j - 1]
+                    : 1 + Math.min(dp[i - 1][j], dp[i][j - 1], dp[i - 1][j - 1]);
+        }
+    }
+    return dp[m][n];
+}
+/**
+ * Get feature name from package name
+ */
+export function getFeatureNameFromPackage(packageName) {
+    const allFeatures = getAllFeatures();
+    for (const [featureName, feature] of Object.entries(allFeatures)) {
+        if (feature.package === packageName) {
+            return featureName;
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=feature-metadata.js.map

package/dist/feature-metadata.js.map

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

package/dist/feature-search.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 { FeatureMetadata } from "./types.js";
+/**
+ * Search features by keyword with scoring and ranking
+ */
+export declare function searchFeatures(query: string): FeatureMetadata[];
+/**
+ * Get feature metadata or throw a descriptive error with search suggestions.
+ * Use this when a feature MUST exist (e.g., install commands).
+ */
+export declare function getFeatureMetadataOrThrow(featureName: string): Readonly<FeatureMetadata>;
+//# sourceMappingURL=feature-search.d.ts.map

package/dist/feature-search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"feature-search.d.ts","sourceRoot":"","sources":["../src/feature-search.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAuGlD;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,eAAe,EAAE,CA2B/D;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,WAAW,EAAE,MAAM,GAAG,QAAQ,CAAC,eAAe,CAAC,CAuBxF"}

package/dist/feature-search.js

@@ -0,0 +1,140 @@
+/**
+ * Copyright (c) 2026, Salesforce, Inc.,
+ * All rights reserved.
+ * For full license text, see the LICENSE.txt file
+ */
+import { getAllFeatures, getFeatureMetadata, suggestSimilarFeatures } from "./feature-metadata.js";
+/**
+ * Score a feature against search terms
+ * @internal
+ */
+function scoreFeature(feature, terms, originalQuery) {
+    let score = 0;
+    const matchedFields = [];
+    const matchedTerms = new Set();
+    // Prepare searchable text fields (lowercase for case-insensitive matching)
+    const nameLower = feature.name.toLowerCase();
+    const shortDescLower = feature.shortDescription.toLowerCase();
+    const longDescLower = feature.longDescription.toLowerCase();
+    const keywordsLower = feature.keywords.map((k) => k.toLowerCase());
+    const featuresLower = (feature.features || []).map((f) => f.toLowerCase());
+    const componentsLower = (feature.components || []).map((c) => c.toLowerCase());
+    // Check for exact feature name match (highest priority)
+    if (nameLower === originalQuery) {
+        score += 1000;
+        matchedFields.push("name (exact)");
+        terms.forEach((t) => matchedTerms.add(t));
+    }
+    // Check each search term
+    for (const term of terms) {
+        // Name match (partial)
+        if (nameLower.includes(term)) {
+            score += 500;
+            matchedFields.push(`name: "${term}"`);
+            matchedTerms.add(term);
+        }
+        // Exact keyword match
+        if (keywordsLower.some((kw) => kw === term)) {
+            score += 400;
+            matchedFields.push(`keyword: "${term}"`);
+            matchedTerms.add(term);
+        }
+        else if (keywordsLower.some((kw) => kw.includes(term))) {
+            // Partial keyword match (less weight)
+            score += 300;
+            matchedFields.push(`keyword partial: "${term}"`);
+            matchedTerms.add(term);
+        }
+        // Short description match
+        if (shortDescLower.includes(term)) {
+            score += 300;
+            matchedFields.push(`short description: "${term}"`);
+            matchedTerms.add(term);
+        }
+        // Components match
+        const matchingComponent = componentsLower.find((c) => c.includes(term));
+        if (matchingComponent) {
+            score += 250;
+            matchedFields.push(`component: "${term}"`);
+            matchedTerms.add(term);
+        }
+        // Features/capabilities match
+        const matchingFeature = featuresLower.find((f) => f.includes(term));
+        if (matchingFeature) {
+            score += 200;
+            matchedFields.push(`feature: "${term}"`);
+            matchedTerms.add(term);
+        }
+        // Long description match
+        if (longDescLower.includes(term)) {
+            score += 100;
+            matchedFields.push(`long description: "${term}"`);
+            matchedTerms.add(term);
+        }
+    }
+    // Bonus: Term coverage (rewards matching more search terms)
+    score += matchedTerms.size * 100;
+    // Bonus: Phrase match (all terms appear consecutively as a phrase)
+    const allText = [
+        nameLower,
+        shortDescLower,
+        longDescLower,
+        ...keywordsLower,
+        ...featuresLower,
+        ...componentsLower,
+    ].join(" ");
+    if (allText.includes(originalQuery)) {
+        score += 200;
+        matchedFields.push("phrase match");
+    }
+    return { score, matchedFields };
+}
+/**
+ * Search features by keyword with scoring and ranking
+ */
+export function searchFeatures(query) {
+    const allFeatures = getAllFeatures();
+    // Parse query into search terms (split on whitespace)
+    const terms = query.toLowerCase().trim().split(/\s+/);
+    const originalQuery = query.toLowerCase().trim();
+    // Score each feature
+    const scoredResults = [];
+    for (const feature of Object.values(allFeatures)) {
+        const result = scoreFeature(feature, terms, originalQuery);
+        // Only include features that have at least one match (score > 0)
+        if (result.score > 0) {
+            scoredResults.push({
+                feature,
+                score: result.score,
+            });
+        }
+    }
+    // Sort by score descending (highest score first)
+    scoredResults.sort((a, b) => b.score - a.score);
+    // Return just the features (maintains backwards compatibility)
+    return scoredResults.map((r) => r.feature);
+}
+/**
+ * Get feature metadata or throw a descriptive error with search suggestions.
+ * Use this when a feature MUST exist (e.g., install commands).
+ */
+export function getFeatureMetadataOrThrow(featureName) {
+    const feature = getFeatureMetadata(featureName);
+    if (feature) {
+        return feature;
+    }
+    const searchResults = searchFeatures(featureName);
+    if (searchResults.length > 0) {
+        const suggestions = searchResults
+            .slice(0, 5)
+            .map((f) => `  - ${f.name}: ${f.shortDescription}`)
+            .join("\n");
+        throw new Error(`Feature "${featureName}" not found. Did you mean one of these?\n${suggestions}`);
+    }
+    const similar = suggestSimilarFeatures(featureName);
+    if (similar.length > 0) {
+        throw new Error(`Feature "${featureName}" not found. Similar features: ${similar.join(", ")}`);
+    }
+    throw new Error(`Feature "${featureName}" not found. Use "list" to see available features.`);
+}
+//# sourceMappingURL=feature-search.js.map

package/dist/feature-search.js.map

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