@salesforce/ui-bundle-features 1.117.2

package/dist/features.json

@@ -0,0 +1,137 @@
+{
+  "features": {
+    "authentication": {
+      "name": "Authentication",
+      "package": "@salesforce/ui-bundle-template-feature-react-authentication",
+      "shortDescription": "Complete user authentication system with login, registration, and password management",
+      "longDescription": "Complete user authentication system with login, registration, and password reset flows. Includes protected route guards, session management, and authentication context providers. Handles user state across the application with secure token storage and automatic session refresh. Features include: AuthContext for managing auth state, PrivateRoute component for protecting authenticated-only pages, authentication pages (Login, Register, Profile, Forgot Password, Reset Password, Change Password), and backend Apex classes for authentication handling.",
+      "keywords": [
+        "login",
+        "register",
+        "password reset",
+        "protected routes",
+        "auth",
+        "session",
+        "user management"
+      ],
+      "featureDependencies": [],
+      "packageDependencies": {
+        "@salesforce/sdk-data": "^1.56.1",
+        "@salesforce/ui-bundle": "^1.56.1",
+        "@tanstack/react-form": "^1.28.3",
+        "zod": "^4.3.6"
+      },
+      "copy": [
+        {
+          "from": "force-app/main/default/classes",
+          "to": "<sfdxRoot>/classes",
+          "description": "Apex authentication handler classes"
+        },
+        {
+          "from": "force-app/main/default/uiBundles/feature-react-authentication/src/features/authentication",
+          "to": "<uiBundleDir>/src/features/authentication",
+          "description": "Authentication components, context, and pages"
+        },
+        {
+          "from": "force-app/main/default/uiBundles/feature-react-authentication/src/routes.tsx",
+          "to": "<uiBundleDir>/src/features/authentication/__example__authentication-routes.tsx",
+          "description": "Example showing how to add authentication routes",
+          "integrationTarget": "src/routes.tsx"
+        }
+      ],
+      "features": [
+        "Checks authentication status via Salesforce Chatter API (/chatter/users/me)",
+        "Protects routes with automatic redirect to login",
+        "Supports return URL (retUrl) query parameter for post-login navigation",
+        "Session timeout with configurable duration",
+        "Password strength validation",
+        "Forgot password and reset password flows",
+        "User profile display",
+        "Change password functionality"
+      ],
+      "components": [
+        "AuthContext - React context for managing authentication state",
+        "PrivateRoute - Route protection for authenticated-only pages",
+        "AuthenticationRoute - Route layout that redirects authenticated users",
+        "Login - Login page component",
+        "Register - Registration page component",
+        "Profile - User profile page",
+        "ForgotPassword - Password recovery flow",
+        "ResetPassword - Password reset page",
+        "ChangePassword - Password change page"
+      ]
+    },
+    "object-search": {
+      "name": "Object Search",
+      "package": "@salesforce/ui-bundle-template-feature-object-search",
+      "shortDescription": "Configurable object search and detail pages with filtering, sorting, pagination, and GraphQL-powered queries",
+      "longDescription": "Configurable object search feature with filtering, sorting, pagination, and detail views powered by Salesforce GraphQL APIs. Provides a generic search service layer, reusable filter components (text, picklist, multi-select, numeric range, date, date range, boolean, search), sort controls, cursor-based pagination with configurable page size, and URL-synced search parameters. Includes an Account-based example implementation demonstrating search list pages, detail pages with collapsible sections, breadcrumb navigation, and dynamic picklist option fetching via aggregate groupBy queries. The filter system is configuration-driven — adding a new filterable field requires only a config entry, no component changes.",
+      "keywords": [
+        "search",
+        "filter",
+        "sort",
+        "object detail",
+        "GraphQL",
+        "pagination",
+        "account",
+        "picklist",
+        "date filter",
+        "numeric filter"
+      ],
+      "featureDependencies": [],
+      "packageDependencies": {
+        "@salesforce/sdk-data": "^1.56.1",
+        "@salesforce/ui-bundle": "^1.56.1",
+        "react-day-picker": "^9.14.0"
+      },
+      "copy": [
+        {
+          "from": "force-app/main/default/uiBundles/feature-object-search/src/features/object-search",
+          "to": "<uiBundleDir>/src/features/object-search",
+          "description": "Generic object search components, hooks, filter panel, sort controls, and utilities"
+        },
+        {
+          "from": "force-app/main/default/uiBundles/feature-object-search/src/routes.tsx",
+          "to": "<uiBundleDir>/src/features/object-search/__examples__/object-search-routes.tsx",
+          "description": "Example showing how to add object search and detail routes",
+          "integrationTarget": "src/routes.tsx"
+        }
+      ],
+      "features": [
+        "GraphQL-powered object search with configurable filters and sorting",
+        "Configuration-driven filter system — add fields via config, no component changes needed",
+        "Filter types: text, picklist, multi-select, numeric range, date, date range, boolean, search",
+        "Dynamic picklist options via aggregate groupBy queries",
+        "URL-synced search parameters for bookmarkable/shareable searches",
+        "Cursor-based pagination with configurable page size",
+        "Reusable search service layer for any Salesforce object",
+        "Record detail page with collapsible field sections",
+        "Breadcrumb navigation between list and detail views",
+        "Debounced text search input",
+        "Active filter chips with individual removal"
+      ],
+      "components": [
+        "ObjectSearchBar - Search input bar for quick keyword search with navigation",
+        "PaginationControls - Pagination with page navigation and configurable page size",
+        "FilterPanel - Sidebar panel rendering filter controls from config",
+        "ActiveFilters - Chip display of active filters with removal buttons",
+        "SortControl - Dropdown for selecting sort field and direction",
+        "TextFilter - Text input filter with debounced updates",
+        "SelectFilter - Single-select picklist filter",
+        "MultiSelectFilter - Multi-select picklist filter with checkboxes",
+        "NumericRangeFilter - Min/max numeric range filter",
+        "DateFilter - Single date filter with calendar picker",
+        "DateRangeFilter - Date range filter with start/end pickers",
+        "BooleanFilter - Boolean toggle filter",
+        "SearchFilter - Multi-field keyword search filter",
+        "ObjectBreadcrumb - Breadcrumb navigation for list/detail pages",
+        "useObjectSearchParams - Hook for URL-synced filter, sort, and pagination state",
+        "useAsyncData - Hook for async data fetching with loading/error states",
+        "objectSearchService - Generic GraphQL search and distinct value fetching",
+        "fieldUtils - Field value extraction, address formatting, and date/time formatting",
+        "filterUtils - URL serialization and GraphQL filter building for all filter types",
+        "sortUtils - GraphQL sort order building"
+      ]
+    }
+  }
+}

package/dist/file-copier.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Copyright (c) 2026, Salesforce, Inc.,
+ * All rights reserved.
+ * For full license text, see the LICENSE.txt file
+ */
+import type { CopyOperation, InstallationContext } from "./types.js";
+/**
+ * Execute all copy operations
+ */
+export declare function executeCopyOperations(operations: readonly CopyOperation[], packageName: string, context: InstallationContext): Promise<void>;
+/**
+ * Check if source path exists (for validation)
+ */
+export declare function validateSourcePath(sourcePath: string): boolean;
+//# sourceMappingURL=file-copier.d.ts.map

package/dist/file-copier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-copier.d.ts","sourceRoot":"","sources":["../src/file-copier.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAWH,OAAO,KAAK,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAErE;;GAEG;AACH,wBAAsB,qBAAqB,CAC1C,UAAU,EAAE,SAAS,aAAa,EAAE,EACpC,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,mBAAmB,GAC1B,OAAO,CAAC,IAAI,CAAC,CAqCf;AAuED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAE9D"}

package/dist/file-copier.js

@@ -0,0 +1,105 @@
+/**
+ * Copyright (c) 2026, Salesforce, Inc.,
+ * All rights reserved.
+ * For full license text, see the LICENSE.txt file
+ */
+import { cpSync, existsSync, mkdirSync } from "fs";
+import { dirname, join } from "path";
+import { collectConflicts, hasConflict, outputConflictError, resolveConflict, } from "./conflict-detector.js";
+import { resolvePath, resolveSourcePath } from "./placeholder-resolver.js";
+/**
+ * Execute all copy operations
+ */
+export async function executeCopyOperations(operations, packageName, context) {
+    const packagePath = join(context.uiBundleDir, "node_modules", packageName);
+    // Resolve all destination paths and source paths first
+    const logger = context.logger;
+    const resolvedOps = operations.map((op) => {
+        const destPath = resolvePath(op.to, context);
+        let sourcePath;
+        try {
+            sourcePath = resolveSourcePath(packagePath, op.from);
+        }
+        catch (error) {
+            logger.error(`Failed to resolve source path for: ${op.to}`);
+            throw error;
+        }
+        return {
+            from: op.from,
+            to: destPath,
+            sourcePath,
+            originalTo: op.to,
+            integrationTarget: op.integrationTarget,
+        };
+    });
+    // In error mode, collect all conflicts first before doing anything
+    if (context.conflictMode === "error") {
+        const conflicts = collectConflicts(resolvedOps);
+        if (conflicts.length > 0) {
+            outputConflictError(conflicts);
+            throw new Error("Installation stopped due to conflicts");
+        }
+    }
+    // Execute each copy operation
+    for (const op of resolvedOps) {
+        await executeCopyOperation(op, context);
+    }
+}
+/**
+ * Execute a single copy operation
+ */
+async function executeCopyOperation(op, context) {
+    const logger = context.logger;
+    const sourcePath = op.sourcePath;
+    const destPath = op.to;
+    logger.plain(`${context.dryRun ? "[DRY RUN] Would copy" : "Copying"}: ${op.originalTo}`);
+    logger.debug(`  From: ${sourcePath}`);
+    logger.debug(`  To: ${destPath}`);
+    // Check for conflicts
+    if (hasConflict(destPath)) {
+        const resolution = await resolveConflict(destPath, context);
+        if (resolution === "skip") {
+            logger.plain(`Skipping: ${op.originalTo} (resolution: skip)`);
+            return;
+        }
+        if (resolution === "cancel") {
+            throw new Error("Installation cancelled by user");
+        }
+        if (resolution === "overwrite") {
+            logger.plain(`Overwriting: ${op.originalTo}`);
+        }
+    }
+    if (context.dryRun) {
+        return;
+    }
+    // Ensure destination directory exists
+    const destDir = dirname(destPath);
+    mkdirSync(destDir, { recursive: true });
+    // Copy files using Node.js fs.cpSync (safe, no shell injection risk)
+    try {
+        cpSync(sourcePath, destPath, { recursive: true, force: true });
+        // Track example files for summary
+        if (destPath.includes("__example__") && op.integrationTarget) {
+            context.copiedExampleFiles.push({
+                file: destPath,
+                integrationTarget: op.integrationTarget,
+            });
+        }
+    }
+    catch (error) {
+        logger.error(`Failed to copy: ${op.originalTo}`);
+        logger.error(`  Source: ${sourcePath}`);
+        logger.error(`  Destination: ${destPath}`);
+        if (error instanceof Error) {
+            logger.error(`  Error: ${error.message}`);
+        }
+        throw new Error(`Copy operation failed for ${op.originalTo}`);
+    }
+}
+/**
+ * Check if source path exists (for validation)
+ */
+export function validateSourcePath(sourcePath) {
+    return existsSync(sourcePath);
+}
+//# sourceMappingURL=file-copier.js.map

package/dist/file-copier.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-copier.js","sourceRoot":"","sources":["../src/file-copier.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,IAAI,CAAC;AACnD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AACrC,OAAO,EACN,gBAAgB,EAChB,WAAW,EACX,mBAAmB,EACnB,eAAe,GACf,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAG3E;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAC1C,UAAoC,EACpC,WAAmB,EACnB,OAA4B;IAE5B,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,cAAc,EAAE,WAAW,CAAC,CAAC;IAE3E,uDAAuD;IACvD,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAE9B,MAAM,WAAW,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE;QACzC,MAAM,QAAQ,GAAG,WAAW,CAAC,EAAE,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;QAC7C,IAAI,UAAkB,CAAC;QACvB,IAAI,CAAC;YACJ,UAAU,GAAG,iBAAiB,CAAC,WAAW,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC;QACtD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,MAAM,CAAC,KAAK,CAAC,sCAAsC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;YAC5D,MAAM,KAAK,CAAC;QACb,CAAC;QACD,OAAO;YACN,IAAI,EAAE,EAAE,CAAC,IAAI;YACb,EAAE,EAAE,QAAQ;YACZ,UAAU;YACV,UAAU,EAAE,EAAE,CAAC,EAAE;YACjB,iBAAiB,EAAE,EAAE,CAAC,iBAAiB;SACvC,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,mEAAmE;IACnE,IAAI,OAAO,CAAC,YAAY,KAAK,OAAO,EAAE,CAAC;QACtC,MAAM,SAAS,GAAG,gBAAgB,CAAC,WAAW,CAAC,CAAC;QAChD,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC1B,mBAAmB,CAAC,SAAS,CAAC,CAAC;YAC/B,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;QAC1D,CAAC;IACF,CAAC;IAED,8BAA8B;IAC9B,KAAK,MAAM,EAAE,IAAI,WAAW,EAAE,CAAC;QAC9B,MAAM,oBAAoB,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;IACzC,CAAC;AACF,CAAC;AAED;;GAEG;AACH,KAAK,UAAU,oBAAoB,CAClC,EAMC,EACD,OAA4B;IAE5B,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAC9B,MAAM,UAAU,GAAG,EAAE,CAAC,UAAU,CAAC;IACjC,MAAM,QAAQ,GAAG,EAAE,CAAC,EAAE,CAAC;IAEvB,MAAM,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,sBAAsB,CAAC,CAAC,CAAC,SAAS,KAAK,EAAE,CAAC,UAAU,EAAE,CAAC,CAAC;IACzF,MAAM,CAAC,KAAK,CAAC,WAAW,UAAU,EAAE,CAAC,CAAC;IACtC,MAAM,CAAC,KAAK,CAAC,SAAS,QAAQ,EAAE,CAAC,CAAC;IAElC,sBAAsB;IACtB,IAAI,WAAW,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC3B,MAAM,UAAU,GAAG,MAAM,eAAe,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAE5D,IAAI,UAAU,KAAK,MAAM,EAAE,CAAC;YAC3B,MAAM,CAAC,KAAK,CAAC,aAAa,EAAE,CAAC,UAAU,qBAAqB,CAAC,CAAC;YAC9D,OAAO;QACR,CAAC;QAED,IAAI,UAAU,KAAK,QAAQ,EAAE,CAAC;YAC7B,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;QACnD,CAAC;QAED,IAAI,UAAU,KAAK,WAAW,EAAE,CAAC;YAChC,MAAM,CAAC,KAAK,CAAC,gBAAgB,EAAE,CAAC,UAAU,EAAE,CAAC,CAAC;QAC/C,CAAC;IACF,CAAC;IAED,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;QACpB,OAAO;IACR,CAAC;IAED,sCAAsC;IACtC,MAAM,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IAClC,SAAS,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAExC,qEAAqE;IACrE,IAAI,CAAC;QACJ,MAAM,CAAC,UAAU,EAAE,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QAE/D,kCAAkC;QAClC,IAAI,QAAQ,CAAC,QAAQ,CAAC,aAAa,CAAC,IAAI,EAAE,CAAC,iBAAiB,EAAE,CAAC;YAC9D,OAAO,CAAC,kBAAkB,CAAC,IAAI,CAAC;gBAC/B,IAAI,EAAE,QAAQ;gBACd,iBAAiB,EAAE,EAAE,CAAC,iBAAiB;aACvC,CAAC,CAAC;QACJ,CAAC;IACF,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAChB,MAAM,CAAC,KAAK,CAAC,mBAAmB,EAAE,CAAC,UAAU,EAAE,CAAC,CAAC;QACjD,MAAM,CAAC,KAAK,CAAC,aAAa,UAAU,EAAE,CAAC,CAAC;QACxC,MAAM,CAAC,KAAK,CAAC,kBAAkB,QAAQ,EAAE,CAAC,CAAC;QAC3C,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;YAC5B,MAAM,CAAC,KAAK,CAAC,YAAY,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QAC3C,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,6BAA6B,EAAE,CAAC,UAAU,EAAE,CAAC,CAAC;IAC/D,CAAC;AACF,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,UAAkB;IACpD,OAAO,UAAU,CAAC,UAAU,CAAC,CAAC;AAC/B,CAAC"}

package/dist/install-command.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Copyright (c) 2026, Salesforce, Inc.,
+ * All rights reserved.
+ * For full license text, see the LICENSE.txt file
+ */
+import type { CliOptions } from "./types.js";
+/**
+ * Main installation function
+ */
+export declare function install(featureName: string, options: CliOptions): Promise<void>;
+/**
+ * Get comprehensive help text for install command
+ */
+export declare function getInstallHelpText(): string;
+//# sourceMappingURL=install-command.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"install-command.d.ts","sourceRoot":"","sources":["../src/install-command.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AASH,OAAO,KAAK,EACX,UAAU,EAIV,MAAM,YAAY,CAAC;AAEpB;;GAEG;AACH,wBAAsB,OAAO,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAqHrF;AA+CD;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,CAwJ3C"}

package/dist/install-command.js

@@ -0,0 +1,314 @@
+/**
+ * Copyright (c) 2026, Salesforce, Inc.,
+ * All rights reserved.
+ * For full license text, see the LICENSE.txt file
+ */
+import { existsSync, readFileSync } from "fs";
+import { join, resolve } from "path";
+import { processFeatureOwnOperations, resolveFeatureDependencies } from "./dependency-resolver.js";
+import { getFeatureMetadataOrThrow } from "./feature-search.js";
+import { Logger } from "./logger.js";
+import { installPackage, isPackageInstalled } from "./package-manager.js";
+import { loadSchemaFromNodeModules } from "./schema-loader.js";
+/**
+ * Main installation function
+ */
+export async function install(featureName, options) {
+    // Create logger and installation context
+    const logger = new Logger(options.verbose || false);
+    const context = createContext(options, logger);
+    // Validate directories
+    if (!existsSync(context.sfdxSource)) {
+        throw new Error(`SFDX source directory not found: ${context.sfdxSource}`);
+    }
+    if (!existsSync(context.uiBundleDir)) {
+        throw new Error(`UI bundle directory not found: ${context.uiBundleDir}`);
+    }
+    // Log configuration
+    logger.info(`SFDX Source: ${context.sfdxSource}`);
+    logger.info(`UI Bundle Dir: ${context.uiBundleDir}`);
+    logger.info(`UI Bundle Name: ${context.uiBundleName}`);
+    if (context.dryRun) {
+        logger.info("DRY RUN MODE: No changes will be made");
+    }
+    if (Object.keys(context.conflictResolutions).length > 0) {
+        logger.info(`Loaded ${Object.keys(context.conflictResolutions).length} conflict resolutions`);
+    }
+    // Resolve feature name to package name (throws with suggestions if not found)
+    const feature = getFeatureMetadataOrThrow(featureName);
+    const packageName = feature.package;
+    const displayName = featureName;
+    // Install the main feature package (silently — logged inside feature section later)
+    if (!isPackageInstalled(packageName, context.uiBundleDir)) {
+        await installPackage(packageName, true, context.uiBundleDir, context.dryRun, context.verbose);
+    }
+    else {
+        logger.debug("Feature package already installed, skipping...");
+    }
+    // Mark as installed
+    context.installedFeatures.add(packageName);
+    if (context.dryRun) {
+        logger.info("[DRY RUN] Would load and process feature schema");
+    }
+    // Load the feature schema
+    const schema = loadSchemaFromNodeModules(packageName, context.uiBundleDir, context.logger);
+    if (!schema) {
+        logger.warn("No features.json found. Refer to README for manual instructions.");
+        logger.info(`Try: cat node_modules/${packageName}/README.md`);
+        return;
+    }
+    logger.debug("Feature schema:", JSON.stringify(schema, null, 2));
+    // Determine dependencies for summary
+    const deps = schema.featureDependencies ?? [];
+    // Log installation summary
+    logger.info(`Installing feature: ${displayName}`);
+    if (deps.length > 0) {
+        logger.info(`Dependencies: ${deps.join(", ")}`);
+    }
+    // Install feature dependencies (each gets its own section)
+    if (deps.length > 0) {
+        await resolveFeatureDependencies(deps, context);
+    }
+    // Open main feature section
+    logger.section(`Installing feature: ${displayName}`);
+    logger.plain(`Installing package: ${packageName}`);
+    // Process this feature's own package deps and copy operations
+    await processFeatureOwnOperations(schema, packageName, context);
+    logger.sectionEnd(`Feature installed: ${displayName}`);
+    // Success message
+    console.log();
+    if (deps.length === 1) {
+        logger.success(`Installed feature: ${displayName} (with dependency: ${deps[0]})`);
+    }
+    else if (deps.length > 1) {
+        logger.success(`Installed feature: ${displayName} (with dependencies: ${deps.join(", ")})`);
+    }
+    else {
+        logger.success(`Installed feature: ${displayName}`);
+    }
+    if (!context.dryRun) {
+        // Show example files that need integration
+        if (context.copiedExampleFiles.length > 0) {
+            console.log();
+            console.log("Example files copied (require manual integration):");
+            for (const exampleFile of context.copiedExampleFiles) {
+                const relativePath = exampleFile.file.replace(context.uiBundleDir + "/", "");
+                console.log(`  - ${relativePath}`);
+                if (exampleFile.integrationTarget) {
+                    console.log(`    → Integrate into: ${exampleFile.integrationTarget}`);
+                }
+            }
+        }
+        console.log();
+        console.log("Next steps:");
+        console.log("  1. Review copied files (including __example__ files)");
+        if (context.copiedExampleFiles.length > 0) {
+            console.log("  2. Integrate patterns from __example__ files into target files");
+            console.log("  3. Delete __example__ files after integration");
+            console.log("  4. Run: npm run build && npm run dev");
+            console.log("  5. Test the feature");
+        }
+        else {
+            console.log("  2. Run: npm run build && npm run dev");
+            console.log("  3. Test the feature");
+        }
+    }
+}
+/**
+ * Create installation context from CLI options
+ */
+function createContext(options, loggerInstance) {
+    const sfdxSource = resolve(options.sfdxSource || "force-app/main/default");
+    const uiBundleName = options.uiBundleDir;
+    const uiBundleDir = join(sfdxSource, "uiBundles", uiBundleName);
+    // Determine conflict mode
+    let conflictMode = options.onConflict || "prompt";
+    if (options.yes) {
+        conflictMode = "skip";
+    }
+    // Load conflict resolutions if provided
+    let conflictResolutions = {};
+    if (options.conflictResolution) {
+        const resolutionPath = resolve(options.conflictResolution);
+        if (!existsSync(resolutionPath)) {
+            throw new Error(`Conflict resolution file not found: ${resolutionPath}`);
+        }
+        try {
+            const content = readFileSync(resolutionPath, "utf-8");
+            conflictResolutions = JSON.parse(content);
+            loggerInstance.debug(`Loaded conflict resolutions from: ${resolutionPath}`);
+        }
+        catch (_error) {
+            throw new Error(`Failed to parse conflict resolution file: ${resolutionPath}`);
+        }
+    }
+    return {
+        sfdxSource,
+        uiBundleDir,
+        uiBundleName,
+        verbose: options.verbose || false,
+        dryRun: options.dryRun || false,
+        conflictMode: conflictMode,
+        conflictResolutions,
+        installedFeatures: new Set(),
+        copiedExampleFiles: [],
+        logger: loggerInstance,
+    };
+}
+/**
+ * Get comprehensive help text for install command
+ */
+export function getInstallHelpText() {
+    return `
+
+DESCRIPTION
+  Install a Salesforce UI bundle feature package with automatic dependency resolution,
+  file copying, and conflict management.
+
+DISCOVERING FEATURES
+  Before installing, discover what features are available:
+
+  List all features:
+    $ npx @salesforce/ui-bundle-features list
+
+  Search for features:
+    $ npx @salesforce/ui-bundle-features list --search "auth"
+
+  Get detailed information:
+    $ npx @salesforce/ui-bundle-features describe authentication
+
+  This tool automates the feature installation workflow by:
+  1. Resolving feature names to npm packages
+  2. Installing npm packages as dev dependencies
+  3. Recursively processing feature dependencies
+  4. Installing package dependencies
+  5. Copying files from the feature package to your project
+  6. Handling conflicts interactively or via configuration
+
+PREREQUISITES
+  - Run from within your UI bundle directory, or provide explicit paths
+  - Ensure package.json exists in the UI bundle directory
+  - Ensure feature packages include a features.json file
+
+WORKFLOW EXAMPLES
+
+  Basic installation (interactive):
+    $ npx @salesforce/ui-bundle-features install authentication \\
+        --ui-bundle-dir my-ui-bundle
+
+    The CLI will:
+    - Install the authentication feature package
+    - Process its dependencies (e.g., shadcn)
+    - Prompt for any file conflicts
+    - Copy all files including __example__ files
+
+  Installation with custom SFDX source:
+    $ npx @salesforce/ui-bundle-features install authentication \\
+        --ui-bundle-dir my-ui-bundle \\
+        --sfdx-source custom/sfdx/path
+
+  LLM-assisted workflow (RECOMMENDED for AI assistants):
+    1. Run with error mode to detect conflicts:
+       $ npx @salesforce/ui-bundle-features install authentication \\
+           --ui-bundle-dir my-ui-bundle \\
+           --on-conflict error
+
+    2. CLI outputs conflict list with instructions
+
+    3. Create conflict-resolution.json based on user preferences
+
+    4. Rerun with resolution file:
+       $ npx @salesforce/ui-bundle-features install authentication \\
+           --ui-bundle-dir my-ui-bundle \\
+           --conflict-resolution conflict-resolution.json
+
+  Dry run to preview changes:
+    $ npx @salesforce/ui-bundle-features install authentication \\
+        --ui-bundle-dir my-ui-bundle \\
+        --dry-run
+
+  Non-interactive installation (skip conflicts):
+    $ npx @salesforce/ui-bundle-features install authentication \\
+        --ui-bundle-dir my-ui-bundle \\
+        --yes
+
+FEATURE SCHEMA
+  Features must include a features.json file that defines:
+
+  - featureDependencies: Other features to install first
+  - packageDependencies: npm packages to add to dependencies
+  - packageDevDependencies: npm packages to add to devDependencies
+  - copy: Files/directories to copy from the package
+
+  Example:
+    {
+      "featureDependencies": ["shadcn"],
+      "packageDependencies": {
+        "@tanstack/react-form": "^1.28.3"
+      },
+      "copy": [
+        {
+          "from": "force-app/main/default/classes",
+          "to": "<sfdxSource>/classes",
+          "description": "Apex classes"
+        },
+        {
+          "from": "force-app/main/default/uiBundles/feature-auth/src/auth",
+          "to": "<uiBundleDir>/src/auth",
+          "description": "Auth components"
+        },
+        {
+          "from": "force-app/main/default/uiBundles/feature-auth/src/__example__app.tsx",
+          "to": "<uiBundleDir>/src/__example__app.tsx",
+          "description": "Integration example",
+          "integrationTarget": "src/app.tsx"
+        }
+      ]
+    }
+
+EXAMPLE FILES
+  Feature packages may include __example__ files (e.g., __example__routes.tsx)
+  that show how to integrate the feature into your existing code.
+
+  After installation:
+  1. Review the __example__ files
+  2. Manually integrate patterns into your actual files
+  3. Delete the __example__ files once integrated
+
+PATH RESOLUTION
+  Schema paths support these placeholders:
+
+  - <sfdxSource>/path → Resolves to <sfdx-source>/path
+    Example: <sfdxSource>/classes → force-app/main/default/classes
+
+  - <uiBundleDir>/path → Resolves to <sfdx-source>/uiBundles/<ui-bundle-dir>/path
+    Example: <uiBundleDir>/src/auth → force-app/main/default/uiBundles/my-ui-bundle/src/auth
+
+  Hint placeholders (for user/LLM guidance):
+  - Some "to" paths contain descriptive segments like <desired-page-with-search-input>
+    that are NOT resolved by the CLI. These are hints indicating the user or LLM
+    should choose an appropriate destination. The file will be copied with the
+    literal placeholder name; rename or relocate it to the intended target.
+
+  Legacy formats are also supported:
+  - force-app/main/default/classes → Treated as SFDX metadata
+  - <uiBundle> placeholder → Replaced with UI bundle name
+
+AFTER INSTALLATION
+  1. Review copied files, especially __example__ files
+  2. Integrate __example__ patterns into your code
+  3. Run: npm run build && npm run dev
+  4. Test the new feature
+  5. Delete __example__ files after integration
+
+TROUBLESHOOTING
+  - "SFDX source directory not found": Check --sfdx-source path
+  - "UI bundle directory not found": Check --ui-bundle-dir name and --sfdx-source path
+  - "No features.json found": Feature package doesn't support this tool
+  - Conflicts in error mode: Follow instructions to create conflict-resolution.json
+  - npm install failures: Check network and package availability
+
+For more information, see: .a4drules/uiBundles.md
+`;
+}
+//# sourceMappingURL=install-command.js.map

package/dist/install-command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"install-command.js","sourceRoot":"","sources":["../src/install-command.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,IAAI,CAAC;AAC9C,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AACrC,OAAO,EAAE,2BAA2B,EAAE,0BAA0B,EAAE,MAAM,0BAA0B,CAAC;AACnG,OAAO,EAAE,yBAAyB,EAAE,MAAM,qBAAqB,CAAC;AAChE,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1E,OAAO,EAAE,yBAAyB,EAAE,MAAM,oBAAoB,CAAC;AAQ/D;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,WAAmB,EAAE,OAAmB;IACrE,yCAAyC;IACzC,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,IAAI,KAAK,CAAC,CAAC;IACpD,MAAM,OAAO,GAAG,aAAa,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAE/C,uBAAuB;IACvB,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC;QACrC,MAAM,IAAI,KAAK,CAAC,oCAAoC,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC;IAC3E,CAAC;IAED,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,CAAC;QACtC,MAAM,IAAI,KAAK,CAAC,kCAAkC,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;IAC1E,CAAC;IAED,oBAAoB;IACpB,MAAM,CAAC,IAAI,CAAC,gBAAgB,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC;IAClD,MAAM,CAAC,IAAI,CAAC,kBAAkB,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;IACrD,MAAM,CAAC,IAAI,CAAC,mBAAmB,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;IAEvD,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;QACpB,MAAM,CAAC,IAAI,CAAC,uCAAuC,CAAC,CAAC;IACtD,CAAC;IAED,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,mBAAmB,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACzD,MAAM,CAAC,IAAI,CAAC,UAAU,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,mBAAmB,CAAC,CAAC,MAAM,uBAAuB,CAAC,CAAC;IAC/F,CAAC;IAED,8EAA8E;IAC9E,MAAM,OAAO,GAAG,yBAAyB,CAAC,WAAW,CAAC,CAAC;IACvD,MAAM,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC;IACpC,MAAM,WAAW,GAAG,WAAW,CAAC;IAEhC,oFAAoF;IACpF,IAAI,CAAC,kBAAkB,CAAC,WAAW,EAAE,OAAO,CAAC,WAAW,CAAC,EAAE,CAAC;QAC3D,MAAM,cAAc,CAAC,WAAW,EAAE,IAAI,EAAE,OAAO,CAAC,WAAW,EAAE,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;IAC/F,CAAC;SAAM,CAAC;QACP,MAAM,CAAC,KAAK,CAAC,gDAAgD,CAAC,CAAC;IAChE,CAAC;IAED,oBAAoB;IACpB,OAAO,CAAC,iBAAiB,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;IAE3C,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;QACpB,MAAM,CAAC,IAAI,CAAC,iDAAiD,CAAC,CAAC;IAChE,CAAC;IAED,0BAA0B;IAC1B,MAAM,MAAM,GAAG,yBAAyB,CAAC,WAAW,EAAE,OAAO,CAAC,WAAW,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IAE3F,IAAI,CAAC,MAAM,EAAE,CAAC;QACb,MAAM,CAAC,IAAI,CAAC,kEAAkE,CAAC,CAAC;QAChF,MAAM,CAAC,IAAI,CAAC,yBAAyB,WAAW,YAAY,CAAC,CAAC;QAC9D,OAAO;IACR,CAAC;IAED,MAAM,CAAC,KAAK,CAAC,iBAAiB,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IAEjE,qCAAqC;IACrC,MAAM,IAAI,GAAG,MAAM,CAAC,mBAAmB,IAAI,EAAE,CAAC;IAE9C,2BAA2B;IAC3B,MAAM,CAAC,IAAI,CAAC,uBAAuB,WAAW,EAAE,CAAC,CAAC;IAClD,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACrB,MAAM,CAAC,IAAI,CAAC,iBAAiB,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjD,CAAC;IAED,2DAA2D;IAC3D,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACrB,MAAM,0BAA0B,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACjD,CAAC;IAED,4BAA4B;IAC5B,MAAM,CAAC,OAAO,CAAC,uBAAuB,WAAW,EAAE,CAAC,CAAC;IACrD,MAAM,CAAC,KAAK,CAAC,uBAAuB,WAAW,EAAE,CAAC,CAAC;IAEnD,8DAA8D;IAC9D,MAAM,2BAA2B,CAAC,MAAM,EAAE,WAAW,EAAE,OAAO,CAAC,CAAC;IAEhE,MAAM,CAAC,UAAU,CAAC,sBAAsB,WAAW,EAAE,CAAC,CAAC;IAEvD,kBAAkB;IAClB,OAAO,CAAC,GAAG,EAAE,CAAC;IACd,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,MAAM,CAAC,OAAO,CAAC,sBAAsB,WAAW,sBAAsB,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IACnF,CAAC;SAAM,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC5B,MAAM,CAAC,OAAO,CAAC,sBAAsB,WAAW,wBAAwB,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC7F,CAAC;SAAM,CAAC;QACP,MAAM,CAAC,OAAO,CAAC,sBAAsB,WAAW,EAAE,CAAC,CAAC;IACrD,CAAC;IAED,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;QACrB,2CAA2C;QAC3C,IAAI,OAAO,CAAC,kBAAkB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC3C,OAAO,CAAC,GAAG,EAAE,CAAC;YACd,OAAO,CAAC,GAAG,CAAC,oDAAoD,CAAC,CAAC;YAClE,KAAK,MAAM,WAAW,IAAI,OAAO,CAAC,kBAAkB,EAAE,CAAC;gBACtD,MAAM,YAAY,GAAG,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,WAAW,GAAG,GAAG,EAAE,EAAE,CAAC,CAAC;gBAC7E,OAAO,CAAC,GAAG,CAAC,OAAO,YAAY,EAAE,CAAC,CAAC;gBACnC,IAAI,WAAW,CAAC,iBAAiB,EAAE,CAAC;oBACnC,OAAO,CAAC,GAAG,CAAC,yBAAyB,WAAW,CAAC,iBAAiB,EAAE,CAAC,CAAC;gBACvE,CAAC;YACF,CAAC;QACF,CAAC;QAED,OAAO,CAAC,GAAG,EAAE,CAAC;QACd,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;QAC3B,OAAO,CAAC,GAAG,CAAC,wDAAwD,CAAC,CAAC;QACtE,IAAI,OAAO,CAAC,kBAAkB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC3C,OAAO,CAAC,GAAG,CAAC,kEAAkE,CAAC,CAAC;YAChF,OAAO,CAAC,GAAG,CAAC,iDAAiD,CAAC,CAAC;YAC/D,OAAO,CAAC,GAAG,CAAC,wCAAwC,CAAC,CAAC;YACtD,OAAO,CAAC,GAAG,CAAC,uBAAuB,CAAC,CAAC;QACtC,CAAC;aAAM,CAAC;YACP,OAAO,CAAC,GAAG,CAAC,wCAAwC,CAAC,CAAC;YACtD,OAAO,CAAC,GAAG,CAAC,uBAAuB,CAAC,CAAC;QACtC,CAAC;IACF,CAAC;AACF,CAAC;AAED;;GAEG;AACH,SAAS,aAAa,CAAC,OAAmB,EAAE,cAAsB;IACjE,MAAM,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,UAAU,IAAI,wBAAwB,CAAC,CAAC;IAC3E,MAAM,YAAY,GAAG,OAAO,CAAC,WAAY,CAAC;IAC1C,MAAM,WAAW,GAAG,IAAI,CAAC,UAAU,EAAE,WAAW,EAAE,YAAY,CAAC,CAAC;IAEhE,0BAA0B;IAC1B,IAAI,YAAY,GAAG,OAAO,CAAC,UAAU,IAAI,QAAQ,CAAC;IAClD,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;QACjB,YAAY,GAAG,MAAM,CAAC;IACvB,CAAC;IAED,wCAAwC;IACxC,IAAI,mBAAmB,GAA0B,EAAE,CAAC;IACpD,IAAI,OAAO,CAAC,kBAAkB,EAAE,CAAC;QAChC,MAAM,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC,kBAAkB,CAAC,CAAC;QAC3D,IAAI,CAAC,UAAU,CAAC,cAAc,CAAC,EAAE,CAAC;YACjC,MAAM,IAAI,KAAK,CAAC,uCAAuC,cAAc,EAAE,CAAC,CAAC;QAC1E,CAAC;QAED,IAAI,CAAC;YACJ,MAAM,OAAO,GAAG,YAAY,CAAC,cAAc,EAAE,OAAO,CAAC,CAAC;YACtD,mBAAmB,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YAC1C,cAAc,CAAC,KAAK,CAAC,qCAAqC,cAAc,EAAE,CAAC,CAAC;QAC7E,CAAC;QAAC,OAAO,MAAM,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CAAC,6CAA6C,cAAc,EAAE,CAAC,CAAC;QAChF,CAAC;IACF,CAAC;IAED,OAAO;QACN,UAAU;QACV,WAAW;QACX,YAAY;QACZ,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,KAAK;QACjC,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,KAAK;QAC/B,YAAY,EAAE,YAA4B;QAC1C,mBAAmB;QACnB,iBAAiB,EAAE,IAAI,GAAG,EAAU;QACpC,kBAAkB,EAAE,EAAE;QACtB,MAAM,EAAE,cAAc;KACtB,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB;IACjC,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsJP,CAAC;AACF,CAAC"}

package/dist/list-command.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Copyright (c) 2026, Salesforce, Inc.,
+ * All rights reserved.
+ * For full license text, see the LICENSE.txt file
+ */
+/**
+ * List all available features
+ */
+export declare function listFeatures(options: {
+    verbose?: boolean;
+    search?: string;
+}): void;
+//# sourceMappingURL=list-command.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"list-command.d.ts","sourceRoot":"","sources":["../src/list-command.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH;;GAEG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE;IAAE,OAAO,CAAC,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAyElF"}