@salesforce/webapps-features-experimental 1.68.0

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.webappDir, "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":"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"}

package/dist/install-feature.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=install-feature.d.ts.map

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

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

package/dist/install-feature.js

@@ -0,0 +1,563 @@
+#!/usr/bin/env node
+/**
+ * Copyright (c) 2026, Salesforce, Inc.,
+ * All rights reserved.
+ * For full license text, see the LICENSE.txt file
+ */
+import { existsSync, readFileSync } from "fs";
+import { dirname, join, resolve } from "path";
+import { fileURLToPath } from "url";
+import { Command, Option } from "commander";
+import { processFeatureOwnOperations, resolveFeatureDependencies } from "./dependency-resolver.js";
+import { getAllFeatures, getFeatureMetadata, getFeatureNameFromPackage, isFeatureReady, resolveFeatureName, searchFeatures, suggestSimilarFeatures, } from "./feature-metadata.js";
+import { Logger } from "./logger.js";
+import { installPackage, isPackageInstalled } from "./package-manager.js";
+import { loadSchemaFromNodeModules } from "./schema-loader.js";
+import { extractWebappName } from "./utils.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("install-feature")
+    .description("Manage Salesforce webapp features")
+    .version(cliVersion);
+// Install command
+program
+    .command("install")
+    .description("Install a Salesforce webapp feature package")
+    .argument("<feature>", 'Feature name (e.g., "authentication", "shadcn") or npm package name')
+    .requiredOption("--webapp-dir <path>", "Webapp directory (e.g., force-app/main/default/webapplications/mywebapp)")
+    .option("--sfdx-root <path>", "SFDX metadata root 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();
+/**
+ * Main installation function
+ */
+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.sfdxRoot)) {
+        throw new Error(`SFDX root directory not found: ${context.sfdxRoot}`);
+    }
+    if (!existsSync(context.webappDir)) {
+        throw new Error(`Webapp directory not found: ${context.webappDir}`);
+    }
+    // Log configuration
+    logger.info(`SFDX Root: ${context.sfdxRoot}`);
+    logger.info(`Webapp Dir: ${context.webappDir}`);
+    logger.info(`Webapp Name: ${context.webappName}`);
+    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
+    const feature = getFeatureMetadata(featureName);
+    const packageName = feature?.package ?? featureName;
+    const displayName = feature ? featureName : packageName;
+    // Install the main feature package (silently — logged inside feature section later)
+    if (!isPackageInstalled(packageName, context.webappDir)) {
+        await installPackage(packageName, true, context.webappDir, 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.webappDir, 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.webappDir + "/", "");
+                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) {
+    // Resolve paths (webappDir is required, sfdxRoot has default)
+    const webappDir = resolve(options.webappDir);
+    const sfdxRoot = resolve(options.sfdxRoot || "force-app/main/default");
+    // Extract webapp name
+    const webappName = extractWebappName(webappDir);
+    // 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 {
+        sfdxRoot,
+        webappDir,
+        webappName,
+        verbose: options.verbose || false,
+        dryRun: options.dryRun || false,
+        conflictMode: conflictMode,
+        conflictResolutions,
+        installedFeatures: new Set(),
+        copiedExampleFiles: [],
+        logger: loggerInstance,
+    };
+}
+/**
+ * List all available features
+ */
+function listFeatures(options) {
+    const allFeatures = getAllFeatures();
+    let features = Object.entries(allFeatures);
+    // Filter by search query if provided
+    if (options.search) {
+        const searchResults = searchFeatures(options.search);
+        const searchNames = new Set(searchResults.map((f) => getFeatureNameFromPackage(f.package)).filter(Boolean));
+        features = features.filter(([name]) => searchNames.has(name));
+        console.log(`\nSearch results for "${options.search}":\n`);
+        if (features.length === 0) {
+            console.log("No features found.");
+            return;
+        }
+        // For search results, maintain the order from searchFeatures (sorted by relevance)
+        // Create a map of feature name to rank
+        const rankMap = new Map();
+        searchResults.forEach((f, index) => {
+            const name = getFeatureNameFromPackage(f.package);
+            if (name) {
+                rankMap.set(name, index);
+            }
+        });
+        // Sort by search relevance rank
+        features.sort((a, b) => {
+            const rankA = rankMap.get(a[0]) ?? 999;
+            const rankB = rankMap.get(b[0]) ?? 999;
+            return rankA - rankB;
+        });
+    }
+    else {
+        console.log("\nAvailable Features:\n");
+        if (features.length === 0) {
+            console.log("No features found.");
+            return;
+        }
+        // Sort by name alphabetically when not searching
+        features.sort((a, b) => a[1].name.localeCompare(b[1].name));
+    }
+    for (const [featureName, feature] of features) {
+        const ready = isFeatureReady(featureName);
+        const status = ready ? "✓" : "⚠";
+        const statusText = ready ? "" : " (schema pending)";
+        // Only show feature ID in parens if it differs from the name (ignoring case)
+        const displayName = feature.name.toLowerCase() === featureName.toLowerCase()
+            ? feature.name
+            : `${feature.name} (${featureName})`;
+        console.log(`${status} ${displayName}`);
+        if (options.verbose) {
+            console.log(`   ${feature.longDescription}`);
+            console.log(`   Package: ${feature.package}`);
+            if (feature.featureDependencies && feature.featureDependencies.length > 0) {
+                console.log(`   Dependencies: ${feature.featureDependencies.join(", ")}`);
+            }
+            console.log();
+        }
+        else {
+            console.log(`   ${feature.shortDescription}${statusText}`);
+            console.log();
+        }
+    }
+    console.log('Use "npx @salesforce/webapps-features-experimental describe <feature>" for detailed information');
+    console.log('Use "npx @salesforce/webapps-features-experimental install <feature>" to install a feature\n');
+}
+/**
+ * Describe a specific feature in detail
+ */
+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/webapps-features-experimental list" to see all features\n');
+        process.exit(1);
+    }
+    const feature = getFeatureMetadata(resolvedName);
+    const ready = isFeatureReady(resolvedName);
+    const statusText = ready ? "Ready" : "Schema Pending";
+    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("Status:", statusText);
+    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:");
+    if (ready) {
+        console.log(`  npx @salesforce/webapps-features-experimental install ${resolvedName} --webapp-dir <path>`);
+        console.log();
+        console.log("Example:");
+        console.log(`  npx @salesforce/webapps-features-experimental install ${resolvedName} \\`);
+        console.log("    --webapp-dir force-app/main/default/webapplications/mywebapp");
+    }
+    else {
+        console.log(`  This feature does not yet have a complete schema.`);
+        console.log(`  Manual installation may be required.`);
+    }
+    console.log();
+}
+/**
+ * Get comprehensive help text for install command
+ */
+function getInstallHelpText() {
+    return `
+
+DESCRIPTION
+  Install a Salesforce webapp 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/webapps-features-experimental list
+
+  Search for features:
+    $ npx @salesforce/webapps-features-experimental list --search "auth"
+
+  Get detailed information:
+    $ npx @salesforce/webapps-features-experimental 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 webapp directory, or provide explicit paths
+  - Ensure package.json exists in the webapp directory
+  - Ensure feature packages include a features.json file
+
+WORKFLOW EXAMPLES
+
+  Basic installation (interactive):
+    $ npx @salesforce/webapps-features-experimental install authentication \\
+        --webapp-dir force-app/main/default/webapplications/mywebapp
+
+    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 root:
+    $ npx @salesforce/webapps-features-experimental install authentication \\
+        --webapp-dir force-app/main/default/webapplications/mywebapp \\
+        --sfdx-root custom/sfdx/path
+
+  LLM-assisted workflow (RECOMMENDED for AI assistants):
+    1. Run with error mode to detect conflicts:
+       $ npx @salesforce/webapps-features-experimental install authentication \\
+           --webapp-dir force-app/main/default/webapplications/mywebapp \\
+           --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/webapps-features-experimental install authentication \\
+           --webapp-dir force-app/main/default/webapplications/mywebapp \\
+           --conflict-resolution conflict-resolution.json
+
+  Dry run to preview changes:
+    $ npx @salesforce/webapps-features-experimental install authentication \\
+        --webapp-dir force-app/main/default/webapplications/mywebapp \\
+        --dry-run
+
+  Non-interactive installation (skip conflicts):
+    $ npx @salesforce/webapps-features-experimental install authentication \\
+        --webapp-dir force-app/main/default/webapplications/mywebapp \\
+        --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": "<sfdxRoot>/classes",
+          "description": "Apex classes"
+        },
+        {
+          "from": "force-app/main/default/webapplications/feature-auth/src/auth",
+          "to": "<webappDir>/src/auth",
+          "description": "Auth components"
+        },
+        {
+          "from": "force-app/main/default/webapplications/feature-auth/src/__example__app.tsx",
+          "to": "<webappDir>/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:
+
+  - <sfdxRoot>/path → Resolves to --sfdx-root/path
+    Example: <sfdxRoot>/classes → force-app/main/default/classes
+
+  - <webappDir>/path → Resolves to --webapp-dir/path
+    Example: <webappDir>/src/auth → force-app/main/default/webapplications/mywebapp/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
+  - <webapp> placeholder → Replaced with webapp 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 root directory not found": Check --sfdx-root path
+  - "Webapp directory not found": Check --webapp-dir path or run from webapp dir
+  - "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/webapplications.md
+`;
+}
+//# sourceMappingURL=install-feature.js.map