@salesforce/ui-bundle-features 1.117.2

package/dist/list-command.js

@@ -0,0 +1,71 @@
+/**
+ * Copyright (c) 2026, Salesforce, Inc.,
+ * All rights reserved.
+ * For full license text, see the LICENSE.txt file
+ */
+import { getAllFeatures, getFeatureNameFromPackage } from "./feature-metadata.js";
+import { searchFeatures } from "./feature-search.js";
+/**
+ * List all available features
+ */
+export 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) {
+        // 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(`${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}`);
+            console.log();
+        }
+    }
+    console.log('Use "npx @salesforce/ui-bundle-features describe <feature>" for detailed information');
+    console.log('Use "npx @salesforce/ui-bundle-features install <feature>" to install a feature\n');
+}
+//# sourceMappingURL=list-command.js.map

package/dist/list-command.js.map

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

package/dist/logger.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Copyright (c) 2026, Salesforce, Inc.,
+ * All rights reserved.
+ * For full license text, see the LICENSE.txt file
+ */
+export declare class Logger {
+    private verbose;
+    constructor(verbose?: boolean);
+    /**
+     * Log info message
+     */
+    info(message: string, ...args: unknown[]): void;
+    /**
+     * Log warning message
+     */
+    warn(message: string, ...args: unknown[]): void;
+    /**
+     * Log error message with optional stack trace in verbose mode
+     */
+    error(message: string, error?: Error): void;
+    /**
+     * Log debug message (only in verbose mode)
+     */
+    debug(message: string, ...args: unknown[]): void;
+    /**
+     * Log success message
+     */
+    success(message: string, ...args: unknown[]): void;
+    /**
+     * Log a section header (e.g. ── Installing dependency: shadcn ──────)
+     * Prints two blank lines before the header for visual separation.
+     */
+    section(title: string): void;
+    /**
+     * Log a section footer (e.g. ── Dependency installed: shadcn ──────)
+     * Prints one blank line before the footer.
+     */
+    sectionEnd(title: string): void;
+    /**
+     * Log a plain indented message (no prefix) for use inside sections.
+     */
+    plain(message: string): void;
+    /**
+     * Print a blank line.
+     */
+    blank(): void;
+}
+//# sourceMappingURL=logger.d.ts.map

package/dist/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,qBAAa,MAAM;IAClB,OAAO,CAAC,OAAO,CAAU;gBAEb,OAAO,UAAQ;IAI3B;;OAEG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAI/C;;OAEG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAI/C;;OAEG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK,GAAG,IAAI;IAO3C;;OAEG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAMhD;;OAEG;IACH,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAIlD;;;OAGG;IACH,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAS5B;;;OAGG;IACH,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAQ/B;;OAEG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAI5B;;OAEG;IACH,KAAK,IAAI,IAAI;CAGb"}

package/dist/logger.js

@@ -0,0 +1,82 @@
+/**
+ * Copyright (c) 2026, Salesforce, Inc.,
+ * All rights reserved.
+ * For full license text, see the LICENSE.txt file
+ */
+export class Logger {
+    verbose;
+    constructor(verbose = false) {
+        this.verbose = verbose;
+    }
+    /**
+     * Log info message
+     */
+    info(message, ...args) {
+        console.log(`[INFO] ${message}`, ...args);
+    }
+    /**
+     * Log warning message
+     */
+    warn(message, ...args) {
+        console.warn(`[WARN] ${message}`, ...args);
+    }
+    /**
+     * Log error message with optional stack trace in verbose mode
+     */
+    error(message, error) {
+        console.error(`[ERROR] ${message}`);
+        if (error && this.verbose && error.stack) {
+            console.error(error.stack);
+        }
+    }
+    /**
+     * Log debug message (only in verbose mode)
+     */
+    debug(message, ...args) {
+        if (this.verbose) {
+            console.log(`[DEBUG] ${message}`, ...args);
+        }
+    }
+    /**
+     * Log success message
+     */
+    success(message, ...args) {
+        console.log(`[SUCCESS] ${message}`, ...args);
+    }
+    /**
+     * Log a section header (e.g. ── Installing dependency: shadcn ──────)
+     * Prints two blank lines before the header for visual separation.
+     */
+    section(title) {
+        const prefix = `── ${title} `;
+        const remaining = Math.max(3, 56 - prefix.length);
+        const line = "─".repeat(remaining);
+        console.log();
+        console.log();
+        console.log(`${prefix}${line}`);
+    }
+    /**
+     * Log a section footer (e.g. ── Dependency installed: shadcn ──────)
+     * Prints one blank line before the footer.
+     */
+    sectionEnd(title) {
+        const prefix = `── ${title} `;
+        const remaining = Math.max(3, 56 - prefix.length);
+        const line = "─".repeat(remaining);
+        console.log();
+        console.log(`${prefix}${line}`);
+    }
+    /**
+     * Log a plain indented message (no prefix) for use inside sections.
+     */
+    plain(message) {
+        console.log(`  ${message}`);
+    }
+    /**
+     * Print a blank line.
+     */
+    blank() {
+        console.log();
+    }
+}
+//# sourceMappingURL=logger.js.map

package/dist/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,OAAO,MAAM;IACV,OAAO,CAAU;IAEzB,YAAY,OAAO,GAAG,KAAK;QAC1B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACxB,CAAC;IAED;;OAEG;IACH,IAAI,CAAC,OAAe,EAAE,GAAG,IAAe;QACvC,OAAO,CAAC,GAAG,CAAC,UAAU,OAAO,EAAE,EAAE,GAAG,IAAI,CAAC,CAAC;IAC3C,CAAC;IAED;;OAEG;IACH,IAAI,CAAC,OAAe,EAAE,GAAG,IAAe;QACvC,OAAO,CAAC,IAAI,CAAC,UAAU,OAAO,EAAE,EAAE,GAAG,IAAI,CAAC,CAAC;IAC5C,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,OAAe,EAAE,KAAa;QACnC,OAAO,CAAC,KAAK,CAAC,WAAW,OAAO,EAAE,CAAC,CAAC;QACpC,IAAI,KAAK,IAAI,IAAI,CAAC,OAAO,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;YAC1C,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAC5B,CAAC;IACF,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,OAAe,EAAE,GAAG,IAAe;QACxC,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YAClB,OAAO,CAAC,GAAG,CAAC,WAAW,OAAO,EAAE,EAAE,GAAG,IAAI,CAAC,CAAC;QAC5C,CAAC;IACF,CAAC;IAED;;OAEG;IACH,OAAO,CAAC,OAAe,EAAE,GAAG,IAAe;QAC1C,OAAO,CAAC,GAAG,CAAC,aAAa,OAAO,EAAE,EAAE,GAAG,IAAI,CAAC,CAAC;IAC9C,CAAC;IAED;;;OAGG;IACH,OAAO,CAAC,KAAa;QACpB,MAAM,MAAM,GAAG,MAAM,KAAK,GAAG,CAAC;QAC9B,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;QAClD,MAAM,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QACnC,OAAO,CAAC,GAAG,EAAE,CAAC;QACd,OAAO,CAAC,GAAG,EAAE,CAAC;QACd,OAAO,CAAC,GAAG,CAAC,GAAG,MAAM,GAAG,IAAI,EAAE,CAAC,CAAC;IACjC,CAAC;IAED;;;OAGG;IACH,UAAU,CAAC,KAAa;QACvB,MAAM,MAAM,GAAG,MAAM,KAAK,GAAG,CAAC;QAC9B,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;QAClD,MAAM,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QACnC,OAAO,CAAC,GAAG,EAAE,CAAC;QACd,OAAO,CAAC,GAAG,CAAC,GAAG,MAAM,GAAG,IAAI,EAAE,CAAC,CAAC;IACjC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,OAAe;QACpB,OAAO,CAAC,GAAG,CAAC,KAAK,OAAO,EAAE,CAAC,CAAC;IAC7B,CAAC;IAED;;OAEG;IACH,KAAK;QACJ,OAAO,CAAC,GAAG,EAAE,CAAC;IACf,CAAC;CACD"}

package/dist/package-manager.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Copyright (c) 2026, Salesforce, Inc.,
+ * All rights reserved.
+ * For full license text, see the LICENSE.txt file
+ */
+import type { FileCopySchema, InstallationContext } from "./types.js";
+/**
+ * Install a single npm package and ensure it's saved to package.json.
+ * npm output is suppressed by default; shown on verbose or error.
+ */
+export declare function installPackage(packageName: string, isDev: boolean, uiBundleDir: string, dryRun?: boolean, verbose?: boolean): Promise<void>;
+/**
+ * Install package dependencies from schema.
+ * Merges dependencies into package.json and runs npm install with a spinner.
+ */
+export declare function installPackageDependencies(schema: FileCopySchema, context: InstallationContext): Promise<void>;
+/**
+ * Check if a package is already installed and listed in package.json
+ * This ensures the package won't be removed by subsequent npm install commands
+ */
+export declare function isPackageInstalled(packageName: string, uiBundleDir: string): boolean;
+//# sourceMappingURL=package-manager.d.ts.map

package/dist/package-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"package-manager.d.ts","sourceRoot":"","sources":["../src/package-manager.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,OAAO,KAAK,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAkCtE;;;GAGG;AACH,wBAAsB,cAAc,CACnC,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,OAAO,EACd,WAAW,EAAE,MAAM,EACnB,MAAM,UAAQ,EACd,OAAO,UAAQ,GACb,OAAO,CAAC,IAAI,CAAC,CAkBf;AAED;;;GAGG;AACH,wBAAsB,0BAA0B,CAC/C,MAAM,EAAE,cAAc,EACtB,OAAO,EAAE,mBAAmB,GAC1B,OAAO,CAAC,IAAI,CAAC,CAoGf;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAoBpF"}

package/dist/package-manager.js

@@ -0,0 +1,172 @@
+/**
+ * Copyright (c) 2026, Salesforce, Inc.,
+ * All rights reserved.
+ * For full license text, see the LICENSE.txt file
+ */
+import { spawn } from "child_process";
+import { existsSync, readFileSync, writeFileSync } from "fs";
+import { join } from "path";
+import { Logger } from "./logger.js";
+const fallbackLogger = new Logger();
+/**
+ * Run an npm command asynchronously, capturing output.
+ * Returns stdout on success; throws with captured output on failure.
+ */
+function runNpm(args, cwd) {
+    return new Promise((resolve, reject) => {
+        const child = spawn("npm", args, {
+            cwd,
+            stdio: "pipe",
+        });
+        let stdout = "";
+        let stderr = "";
+        child.stdout.on("data", (data) => {
+            stdout += data.toString();
+        });
+        child.stderr.on("data", (data) => {
+            stderr += data.toString();
+        });
+        child.on("close", (code) => {
+            if (code !== 0) {
+                reject(new Error(`npm ${args.join(" ")} failed (exit code ${code}):\n${stderr}\n${stdout}`));
+            }
+            else {
+                resolve(stdout);
+            }
+        });
+    });
+}
+/**
+ * Install a single npm package and ensure it's saved to package.json.
+ * npm output is suppressed by default; shown on verbose or error.
+ */
+export async function installPackage(packageName, isDev, uiBundleDir, dryRun = false, verbose = false) {
+    if (dryRun) {
+        return;
+    }
+    const saveFlag = isDev ? "--save-dev" : "--save";
+    try {
+        const output = await runNpm(["install", saveFlag, packageName], uiBundleDir);
+        if (verbose && output.trim()) {
+            console.log(output);
+        }
+    }
+    catch (error) {
+        if (error instanceof Error) {
+            console.error(error.message);
+        }
+        throw new Error(`Failed to install package: ${packageName}`);
+    }
+}
+/**
+ * Install package dependencies from schema.
+ * Merges dependencies into package.json and runs npm install with a spinner.
+ */
+export async function installPackageDependencies(schema, context) {
+    const logger = context.logger;
+    const packageJsonPath = join(context.uiBundleDir, "package.json");
+    if (!existsSync(packageJsonPath)) {
+        throw new Error(`package.json not found in: ${context.uiBundleDir}`);
+    }
+    // Read current package.json
+    const packageJsonContent = readFileSync(packageJsonPath, "utf-8");
+    const packageJson = JSON.parse(packageJsonContent);
+    let hasChanges = false;
+    // Merge regular dependencies
+    if (schema.packageDependencies) {
+        packageJson.dependencies = packageJson.dependencies || {};
+        for (const [pkg, version] of Object.entries(schema.packageDependencies)) {
+            const currentVersion = packageJson.dependencies[pkg];
+            if (!currentVersion) {
+                logger.plain(`${context.dryRun ? "[DRY RUN] Would add" : "Adding"} dependency: ${pkg}@${version}`);
+                if (!context.dryRun) {
+                    packageJson.dependencies[pkg] = version;
+                    hasChanges = true;
+                }
+            }
+            else if (currentVersion === "*") {
+                logger.plain(`${context.dryRun ? "[DRY RUN] Would update" : "Updating"} dependency: ${pkg} from * to ${version}`);
+                if (!context.dryRun) {
+                    packageJson.dependencies[pkg] = version;
+                    hasChanges = true;
+                }
+            }
+            else {
+                logger.debug(`Dependency already exists: ${pkg}@${currentVersion}`);
+            }
+        }
+    }
+    // Merge dev dependencies
+    if (schema.packageDevDependencies) {
+        packageJson.devDependencies = packageJson.devDependencies || {};
+        for (const [pkg, version] of Object.entries(schema.packageDevDependencies)) {
+            const currentVersion = packageJson.devDependencies[pkg];
+            if (!currentVersion) {
+                logger.plain(`${context.dryRun ? "[DRY RUN] Would add" : "Adding"} dev dependency: ${pkg}@${version}`);
+                if (!context.dryRun) {
+                    packageJson.devDependencies[pkg] = version;
+                    hasChanges = true;
+                }
+            }
+            else if (currentVersion === "*") {
+                logger.plain(`${context.dryRun ? "[DRY RUN] Would update" : "Updating"} dev dependency: ${pkg} from * to ${version}`);
+                if (!context.dryRun) {
+                    packageJson.devDependencies[pkg] = version;
+                    hasChanges = true;
+                }
+            }
+            else {
+                logger.debug(`Dev dependency already exists: ${pkg}@${currentVersion}`);
+            }
+        }
+    }
+    if (!hasChanges) {
+        logger.debug("No new dependencies to install");
+        return;
+    }
+    if (context.dryRun) {
+        return;
+    }
+    // Write updated package.json
+    writeFileSync(packageJsonPath, JSON.stringify(packageJson, null, 2) + "\n", "utf-8");
+    // Run npm install with spinner
+    const { default: ora } = await import("ora");
+    const spinner = ora({ text: "Running npm install...", indent: 2 }).start();
+    try {
+        const output = await runNpm(["install"], context.uiBundleDir);
+        spinner.succeed("npm install complete");
+        if (context.verbose && output.trim()) {
+            console.log(output);
+        }
+    }
+    catch (error) {
+        spinner.fail("npm install failed");
+        if (error instanceof Error) {
+            console.error(error.message);
+        }
+        throw error;
+    }
+}
+/**
+ * Check if a package is already installed and listed in package.json
+ * This ensures the package won't be removed by subsequent npm install commands
+ */
+export function isPackageInstalled(packageName, uiBundleDir) {
+    const packageJsonPath = join(uiBundleDir, "package.json");
+    if (!existsSync(packageJsonPath)) {
+        return false;
+    }
+    try {
+        const packageJsonContent = readFileSync(packageJsonPath, "utf-8");
+        const packageJson = JSON.parse(packageJsonContent);
+        // Check both dependencies and devDependencies
+        const inDependencies = packageJson.dependencies?.[packageName] !== undefined;
+        const inDevDependencies = packageJson.devDependencies?.[packageName] !== undefined;
+        return inDependencies || inDevDependencies;
+    }
+    catch (error) {
+        fallbackLogger.error("Failed to read package.json", error);
+        return false;
+    }
+}
+//# sourceMappingURL=package-manager.js.map

package/dist/package-manager.js.map

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

package/dist/placeholder-resolver.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Copyright (c) 2026, Salesforce, Inc.,
+ * All rights reserved.
+ * For full license text, see the LICENSE.txt file
+ */
+import type { InstallationContext } from "./types.js";
+/**
+ * Resolve a schema path to an actual file system path
+ *
+ * Supports three placeholder formats:
+ * 1. <sfdxSource>/path → resolves to context.sfdxSource/path
+ * 2. <uiBundleDir>/path → resolves to context.uiBundleDir/path
+ * 3. <uiBundle> → replaced with context.uiBundleName (legacy)
+ *
+ * For backward compatibility, also handles paths without placeholders:
+ * - force-app/main/default/... → treated as SFDX metadata
+ * - Other paths → treated as relative to uiBundleDir
+ */
+export declare function resolvePath(schemaPath: string, context: InstallationContext): string;
+/**
+ * Resolve source path from package, trying multiple possible locations
+ * Returns the first path that exists, or throws an error with all attempted paths
+ */
+export declare function resolveSourcePath(packagePath: string, schemaFrom: string): string;
+//# sourceMappingURL=placeholder-resolver.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"placeholder-resolver.d.ts","sourceRoot":"","sources":["../src/placeholder-resolver.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAGtD;;;;;;;;;;;GAWG;AACH,wBAAgB,WAAW,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,mBAAmB,GAAG,MAAM,CAsCpF;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAwBjF"}

package/dist/placeholder-resolver.js

@@ -0,0 +1,78 @@
+/**
+ * Copyright (c) 2026, Salesforce, Inc.,
+ * All rights reserved.
+ * For full license text, see the LICENSE.txt file
+ */
+import { existsSync } from "fs";
+import { join } from "path";
+import { hasUIBundlePlaceholder, isSfdxMetadataPath } from "./utils.js";
+/**
+ * Resolve a schema path to an actual file system path
+ *
+ * Supports three placeholder formats:
+ * 1. <sfdxSource>/path → resolves to context.sfdxSource/path
+ * 2. <uiBundleDir>/path → resolves to context.uiBundleDir/path
+ * 3. <uiBundle> → replaced with context.uiBundleName (legacy)
+ *
+ * For backward compatibility, also handles paths without placeholders:
+ * - force-app/main/default/... → treated as SFDX metadata
+ * - Other paths → treated as relative to uiBundleDir
+ */
+export function resolvePath(schemaPath, context) {
+    // Handle <sfdxSource> placeholder
+    if (schemaPath.startsWith("<sfdxSource>")) {
+        const relativePath = schemaPath.replace(/^<sfdxSource>\/?/, "");
+        return relativePath ? join(context.sfdxSource, relativePath) : context.sfdxSource;
+    }
+    // Handle <uiBundleDir> placeholder
+    if (schemaPath.startsWith("<uiBundleDir>")) {
+        const relativePath = schemaPath.replace(/^<uiBundleDir>\/?/, "");
+        return relativePath ? join(context.uiBundleDir, relativePath) : context.uiBundleDir;
+    }
+    // === Backward compatibility for legacy path formats ===
+    // Handle SFDX metadata paths (legacy format: force-app/main/default/...)
+    if (isSfdxMetadataPath(schemaPath)) {
+        const relativePath = schemaPath.replace(/^force-app\/main\/default\//, "");
+        return join(context.sfdxSource, relativePath);
+    }
+    // Handle UI bundle paths with <uiBundle> placeholder (legacy format)
+    if (hasUIBundlePlaceholder(schemaPath)) {
+        const withName = schemaPath.replace(/<uiBundle>/g, context.uiBundleName);
+        // Strip 'force-app/main/default/uiBundles/{uiBundleName}/' prefix
+        const prefix = `force-app/main/default/uiBundles/${context.uiBundleName}/`;
+        if (withName.startsWith(prefix)) {
+            const relativePath = withName.substring(prefix.length);
+            return join(context.uiBundleDir, relativePath);
+        }
+        // If no prefix, just join with uiBundleDir
+        return join(context.uiBundleDir, withName);
+    }
+    // Default: treat as relative to uiBundleDir
+    return join(context.uiBundleDir, schemaPath);
+}
+/**
+ * Resolve source path from package, trying multiple possible locations
+ * Returns the first path that exists, or throws an error with all attempted paths
+ */
+export function resolveSourcePath(packagePath, schemaFrom) {
+    // Try multiple possible locations in order of likelihood
+    const possiblePaths = [
+        join(packagePath, "dist", schemaFrom), // Built packages often have dist/
+        join(packagePath, schemaFrom), // Some packages don't have dist/
+    ];
+    // Return the first path that exists
+    for (const path of possiblePaths) {
+        if (existsSync(path)) {
+            return path;
+        }
+    }
+    // None found - throw descriptive error
+    const error = new Error(`Source path not found in package. Tried:\n${possiblePaths.map((p) => `  - ${p}`).join("\n")}\n\n` +
+        `This usually means:\n` +
+        `  1. The package hasn't been built (run npm run build in the package)\n` +
+        `  2. The "from" path in features.json is incorrect\n` +
+        `  3. The package structure doesn't match expectations`);
+    error.name = "SourcePathNotFoundError";
+    throw error;
+}
+//# sourceMappingURL=placeholder-resolver.js.map

package/dist/placeholder-resolver.js.map

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

package/dist/schema-loader.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Copyright (c) 2026, Salesforce, Inc.,
+ * All rights reserved.
+ * For full license text, see the LICENSE.txt file
+ */
+import { Logger } from "./logger.js";
+import type { FileCopySchema } from "./types.js";
+/**
+ * Load and validate a feature schema from a package directory
+ * Tries multiple locations: root and dist/ directory
+ */
+export declare function loadSchema(packagePath: string, logger?: Logger): FileCopySchema | null;
+/**
+ * Load schema from node_modules OR from local features.json metadata
+ */
+export declare function loadSchemaFromNodeModules(packageName: string, uiBundleDir: string, logger?: Logger): FileCopySchema | null;
+//# sourceMappingURL=schema-loader.d.ts.map

package/dist/schema-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-loader.d.ts","sourceRoot":"","sources":["../src/schema-loader.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAiBjD;;;GAGG;AACH,wBAAgB,UAAU,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI,CA2BtF;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CACxC,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,EACnB,MAAM,CAAC,EAAE,MAAM,GACb,cAAc,GAAG,IAAI,CA6BvB"}

package/dist/schema-loader.js

@@ -0,0 +1,82 @@
+/**
+ * Copyright (c) 2026, Salesforce, Inc.,
+ * All rights reserved.
+ * For full license text, see the LICENSE.txt file
+ */
+import { existsSync, readFileSync } from "fs";
+import { join } from "path";
+import { z } from "zod";
+import { getFeatureMetadata, getFeatureNameFromPackage } from "./feature-metadata.js";
+import { Logger } from "./logger.js";
+// Zod schema for validation
+const CopyOperationSchema = z.object({
+    from: z.string(),
+    to: z.string(),
+    description: z.string().optional(),
+    integrationTarget: z.string().optional(),
+});
+const FileCopySchemaValidator = z.object({
+    featureDependencies: z.array(z.string()).optional(),
+    packageDependencies: z.record(z.string()).optional(),
+    packageDevDependencies: z.record(z.string()).optional(),
+    copy: z.array(CopyOperationSchema).optional(),
+});
+/**
+ * Load and validate a feature schema from a package directory
+ * Tries multiple locations: root and dist/ directory
+ */
+export function loadSchema(packagePath, logger) {
+    const log = logger ?? new Logger();
+    const possibleLocations = [
+        join(packagePath, "features.json"),
+        join(packagePath, "dist", "features.json"),
+    ];
+    for (const schemaPath of possibleLocations) {
+        if (existsSync(schemaPath)) {
+            try {
+                const content = readFileSync(schemaPath, "utf-8");
+                const parsed = JSON.parse(content);
+                // Validate with Zod
+                const validated = FileCopySchemaValidator.parse(parsed);
+                log.debug(`Loaded schema from: ${schemaPath}`);
+                return validated;
+            }
+            catch (error) {
+                log.error(`Failed to parse schema at ${schemaPath}:`, error);
+                throw new Error(`Invalid schema format in ${schemaPath}`);
+            }
+        }
+    }
+    log.debug(`No features.json found in: ${packagePath}`);
+    return null;
+}
+/**
+ * Load schema from node_modules OR from local features.json metadata
+ */
+export function loadSchemaFromNodeModules(packageName, uiBundleDir, logger) {
+    const log = logger ?? new Logger();
+    // First, try to get schema from local features.json metadata
+    const featureName = getFeatureNameFromPackage(packageName);
+    if (featureName) {
+        const metadata = getFeatureMetadata(featureName);
+        if (metadata) {
+            // Check if metadata has schema information
+            if (metadata.copy ||
+                metadata.packageDependencies ||
+                metadata.packageDevDependencies ||
+                metadata.featureDependencies) {
+                log.debug(`Using schema from local features.json for: ${packageName}`);
+                return {
+                    featureDependencies: metadata.featureDependencies,
+                    packageDependencies: metadata.packageDependencies,
+                    packageDevDependencies: metadata.packageDevDependencies,
+                    copy: metadata.copy,
+                };
+            }
+        }
+    }
+    // Fallback: try to load from node_modules (for packages with their own features.json)
+    const packagePath = join(uiBundleDir, "node_modules", packageName);
+    return loadSchema(packagePath, log);
+}
+//# sourceMappingURL=schema-loader.js.map

package/dist/schema-loader.js.map

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