@salesforce/ui-bundle-template-cli 1.117.2

package/dist/core/package-json-merger.js

@@ -0,0 +1,104 @@
+/**
+ * Copyright (c) 2026, Salesforce, Inc.,
+ * All rights reserved.
+ * For full license text, see the LICENSE.txt file
+ */
+import { existsSync, readFileSync, writeFileSync } from "fs";
+import { join } from "path";
+import * as logger from "../utils/logger";
+import { getUIBundlePath } from "../utils/validation";
+export class PackageJsonMergeError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "PackageJsonMergeError";
+    }
+}
+/**
+ * Build package specs array from dependencies object
+ * @param dependencies - Object mapping package names to versions
+ * @returns Array of package specs in format "package@version"
+ */
+export function buildPackageSpecs(dependencies) {
+    return Object.entries(dependencies)
+        .filter(([, version]) => {
+        // Filter out wildcard versions and workspace protocol (npm doesn't support workspace:)
+        return version !== "*" && !version.startsWith("workspace:");
+    })
+        .map(([name, version]) => `${name}@${version}`);
+}
+/**
+ * Replace workspace:* dependencies with * to avoid npm workspace protocol errors
+ * npm doesn't support workspace: protocol, so we replace it with * which we filter out
+ */
+function replaceWorkspaceDependencies(packageJsonPath) {
+    const packageJson = JSON.parse(readFileSync(packageJsonPath, "utf-8"));
+    let modified = false;
+    // Replace workspace:* in dependencies
+    if (packageJson.dependencies) {
+        for (const [key, value] of Object.entries(packageJson.dependencies)) {
+            if (typeof value === "string" && value.startsWith("workspace:")) {
+                packageJson.dependencies[key] = "*";
+                modified = true;
+            }
+        }
+    }
+    // Replace workspace:* in devDependencies
+    if (packageJson.devDependencies) {
+        for (const [key, value] of Object.entries(packageJson.devDependencies)) {
+            if (typeof value === "string" && value.startsWith("workspace:")) {
+                packageJson.devDependencies[key] = "*";
+                modified = true;
+            }
+        }
+    }
+    if (modified) {
+        writeFileSync(packageJsonPath, JSON.stringify(packageJson, null, 2) + "\n");
+    }
+}
+/**
+ * Merge patch dependencies into package.json without running npm install.
+ * The build-dist-app executor handles the actual npm install.
+ * @param targetDir - Base directory containing uiBundles/<app-name>, or direct path to UI bundle directory if uiBundleDirPath is provided
+ * @param patchDependencies - Dependencies to merge from feature patches
+ * @param uiBundleDirPath - Optional direct path to the UI bundle directory
+ */
+export async function mergePackageJson(targetDir, patchDependencies, uiBundleDirPath) {
+    const uiBundleDir = uiBundleDirPath || getUIBundlePath(targetDir);
+    const packageJsonPath = join(uiBundleDir, "package.json");
+    if (!existsSync(packageJsonPath)) {
+        throw new PackageJsonMergeError(`package.json not found at '${packageJsonPath}'. Expected in UI bundle directory.`);
+    }
+    replaceWorkspaceDependencies(packageJsonPath);
+    const packageJson = JSON.parse(readFileSync(packageJsonPath, "utf-8"));
+    const changes = [];
+    if (patchDependencies.dependencies) {
+        const packageSpecs = buildPackageSpecs(patchDependencies.dependencies);
+        if (packageSpecs.length > 0) {
+            logger.info(`Merging ${packageSpecs.length} dependency/dependencies into package.json...`);
+            packageSpecs.forEach((spec) => logger.info(`  ${spec}`));
+            packageJson.dependencies = { ...packageJson.dependencies, ...patchDependencies.dependencies };
+            changes.push(...packageSpecs);
+        }
+    }
+    if (patchDependencies.devDependencies) {
+        const packageSpecs = buildPackageSpecs(patchDependencies.devDependencies);
+        if (packageSpecs.length > 0) {
+            logger.info(`Merging ${packageSpecs.length} dev dependency/dependencies into package.json...`);
+            packageSpecs.forEach((spec) => logger.info(`  ${spec}`));
+            packageJson.devDependencies = {
+                ...packageJson.devDependencies,
+                ...patchDependencies.devDependencies,
+            };
+            changes.push(...packageSpecs.map((spec) => `${spec} (dev)`));
+        }
+    }
+    if (changes.length > 0) {
+        writeFileSync(packageJsonPath, JSON.stringify(packageJson, null, 2) + "\n");
+        logger.success(`Merged ${changes.length} dependency change(s) into package.json`);
+    }
+    else {
+        logger.info("No new dependencies to merge");
+    }
+    return changes;
+}
+//# sourceMappingURL=package-json-merger.js.map

package/dist/core/package-json-merger.js.map

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

package/dist/core/patch-loader.d.ts

@@ -0,0 +1,18 @@
+import type { Patch, PathMappings } from "../types";
+export declare class PatchLoadError extends Error {
+    constructor(message: string);
+}
+export interface PatchConfig {
+    patches: Patch[];
+    templateDir: string;
+    uiBundleName: string;
+    routeFilePath: string;
+    dependencies: string[];
+    pathMappings: PathMappings;
+    siteContainer: boolean;
+}
+/**
+ * Load patches from a patch's patches.ts file
+ */
+export declare function loadPatch(patchPath: string): Promise<PatchConfig>;
+//# sourceMappingURL=patch-loader.d.ts.map

package/dist/core/patch-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"patch-loader.d.ts","sourceRoot":"","sources":["../../src/core/patch-loader.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAEpD,qBAAa,cAAe,SAAQ,KAAK;gBAC5B,OAAO,EAAE,MAAM;CAI3B;AAED,MAAM,WAAW,WAAW;IAC3B,OAAO,EAAE,KAAK,EAAE,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,YAAY,EAAE,YAAY,CAAC;IAC3B,aAAa,EAAE,OAAO,CAAC;CACvB;AAcD;;GAEG;AACH,wBAAsB,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAmGvE"}

package/dist/core/patch-loader.js

@@ -0,0 +1,115 @@
+/**
+ * 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 { pathToFileURL } from "url";
+export class PatchLoadError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "PatchLoadError";
+    }
+}
+/**
+ * Extract patch name from patch path
+ * Examples:
+ * - 'packages/feature-navigation-menu' -> 'feature-navigation-menu'
+ * - '/absolute/path/to/feature-name' -> 'feature-name'
+ * - 'packages/reference-app-vibe-coding-starter' -> 'reference-app-vibe-coding-starter'
+ */
+function extractPatchName(patchPath) {
+    const parts = patchPath.split("/");
+    return parts[parts.length - 1];
+}
+/**
+ * Load patches from a patch's patches.ts file
+ */
+export async function loadPatch(patchPath) {
+    const patchesFilePath = join(patchPath, "patches.ts");
+    if (!existsSync(patchesFilePath)) {
+        throw new PatchLoadError(`No patches.ts found in patch path '${patchPath}'`);
+    }
+    try {
+        // Convert to file URL for dynamic import
+        const patchPathUrl = pathToFileURL(patchesFilePath).href;
+        const module = await import(patchPathUrl);
+        // Require default export
+        if (!module.default) {
+            throw new PatchLoadError(`patches.ts must have a default export (array or object) in ${patchesFilePath}`);
+        }
+        // Helper to check if a value looks like a patch object
+        // Checks if value is a plain object (not array, not null) that matches Patch structure
+        // Accepts any value from dynamic import (module.default is typed as any) and narrows to Patch type
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any -- module.default from dynamic import is typed as any
+        const isPatchLike = (value) => {
+            return value !== null && typeof value === "object" && !Array.isArray(value);
+        };
+        let patches;
+        if (Array.isArray(module.default)) {
+            patches = module.default;
+        }
+        else if (isPatchLike(module.default)) {
+            patches = [module.default];
+        }
+        else {
+            throw new PatchLoadError(`Default export must be a Patch object or Patch[] array in ${patchesFilePath}`);
+        }
+        // Extract patch name from path for constructing defaults
+        const patchName = extractPatchName(patchPath);
+        // Extract configuration from patches (with defaults)
+        // Default to SFDX structure: src/force-app/main/default/uiBundles/{name}
+        let templateDir = "src";
+        let uiBundleName = patchName; // Default to patch name
+        let routeFilePath;
+        let dependencies = [];
+        let pathMappings = {}; // Default: enabled with no custom mappings
+        let siteContainer = false;
+        // Check if any patch specifies custom configuration
+        for (const patch of patches) {
+            if (patch.templateDir) {
+                templateDir = patch.templateDir;
+            }
+            if (patch.uiBundleName) {
+                uiBundleName = patch.uiBundleName;
+            }
+            if (patch.routeFilePath) {
+                routeFilePath = patch.routeFilePath;
+            }
+            if (patch.dependencies) {
+                // Merge dependencies from all patches
+                dependencies = [...new Set([...dependencies, ...patch.dependencies])];
+            }
+            if (patch.pathMappings) {
+                // If any patch specifies pathMappings, use it
+                // Last one wins if multiple patches specify it
+                pathMappings = patch.pathMappings;
+            }
+            if (patch.siteContainer) {
+                siteContainer = true;
+            }
+        }
+        // Set default routeFilePath if not explicitly provided
+        // Default to SFDX structure path
+        if (!routeFilePath) {
+            routeFilePath = `force-app/main/default/uiBundles/${uiBundleName}/src/routes.tsx`;
+        }
+        return {
+            patches,
+            templateDir,
+            uiBundleName,
+            routeFilePath,
+            dependencies,
+            pathMappings,
+            siteContainer,
+        };
+    }
+    catch (err) {
+        if (err instanceof PatchLoadError) {
+            throw err;
+        }
+        throw new PatchLoadError(`Failed to load patch from ${patchesFilePath}: ${err instanceof Error ? err.message : String(err)}`);
+    }
+}
+//# sourceMappingURL=patch-loader.js.map

package/dist/core/patch-loader.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,95 @@
+#!/usr/bin/env node
+/*
+ * Copyright (c) 2026, Salesforce, Inc.,
+ * All rights reserved.
+ * For full license text, see the LICENSE.txt file
+ */
+import { readFileSync } from "fs";
+import { join, dirname } from "path";
+import { fileURLToPath } from "url";
+import { Command } from "commander";
+import { applyPatchesCommand } from "./commands/apply-patches";
+import { newAppOrFeatureCommand } from "./commands/new-app-feature";
+// Get package.json for version info
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const packageJsonPath = join(__dirname, "../package.json");
+const packageJson = JSON.parse(readFileSync(packageJsonPath, "utf-8"));
+const program = new Command();
+program
+    .name("apply-patches")
+    .description("CLI tool for applying feature patches to base apps")
+    .version(packageJson.version);
+program
+    .command("apply-patches")
+    .description("Apply feature patches to an app")
+    .argument("<feature-path>", "Path to the feature (e.g., packages/template/feature/feature-navigation-menu)")
+    .argument("<app-path>", "Path to the app (e.g., packages/template/base-app/base-react-app or my-app)")
+    .argument("<target-dir>", "Target directory to copy app to before applying patches")
+    .option("--skip-dependency-changes", "Skip installing dependencies from package.json")
+    .option("--reset", "Reset target directory to base app state before applying patches (preserves node_modules)")
+    .action(async (featurePath, appPath, targetDir, options) => {
+    try {
+        await applyPatchesCommand(featurePath, appPath, {
+            targetDirName: targetDir,
+            skipDependencyChanges: options.skipDependencyChanges,
+            reset: options.reset,
+        });
+        process.exit(0);
+    }
+    catch (_err) {
+        process.exit(1);
+    }
+});
+program
+    .command("watch-patches")
+    .description("Watch feature template directory and auto-apply patches on changes")
+    .argument("<feature-path>", "Path to the feature (e.g., packages/template/feature/feature-navigation-menu)")
+    .argument("<app-path>", "Path to the app (e.g., packages/template/base-app/base-react-app or my-app)")
+    .argument("<target-dir>", "Target directory to apply patches to")
+    .action(async (featurePath, appPath, targetDir) => {
+    try {
+        // Dynamic import to avoid loading turbowatch when not needed
+        const { watchPatchesCommand } = await import("./commands/watch-patches");
+        await watchPatchesCommand(featurePath, appPath, targetDir);
+    }
+    catch (_err) {
+        process.exit(1);
+    }
+});
+program
+    .command("new-feature")
+    .description("Create a new feature package from the base-feature template")
+    .argument("<feature-name>", 'Name of the feature (will be prefixed with "feature-")')
+    .action(async (featureName) => {
+    try {
+        await newAppOrFeatureCommand(featureName, "feature");
+        process.exit(0);
+    }
+    catch (_err) {
+        process.exit(1);
+    }
+});
+program
+    .command("new-app")
+    .description("Create a new reference app package from the base-reference-app template")
+    .argument("<app-name>", 'Name of the app (will be prefixed with "app-")')
+    .action(async (appName) => {
+    try {
+        await newAppOrFeatureCommand(appName, "app");
+        process.exit(0);
+    }
+    catch (_err) {
+        process.exit(1);
+    }
+});
+// If no command specified, default to apply-patches
+if (process.argv.length > 2 && !process.argv[2].startsWith("-")) {
+    // If first argument is not a recognized command, treat as apply-patches command
+    const args = process.argv.slice(2);
+    const knownCommands = ["apply-patches", "watch-patches", "new-feature", "new-app"];
+    if (!knownCommands.includes(args[0]) && !args[0].startsWith("-")) {
+        process.argv.splice(2, 0, "apply-patches");
+    }
+}
+program.parse(process.argv);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/nx-plugin/executors/apply-patches/executor.d.ts

@@ -0,0 +1,20 @@
+import { type ExecutorContext } from "@nx/devkit";
+import type { ApplyPatchesExecutorOptions } from "./schema";
+/**
+ * Result of the executor
+ */
+export interface ApplyPatchesExecutorResult {
+    success: boolean;
+}
+/**
+ * Nx executor for applying template patches
+ *
+ * This executor wraps the apply-patches CLI command and automatically determines paths
+ * based on the Nx project configuration.
+ *
+ * @param options - Executor options
+ * @param context - Nx executor context
+ * @returns Executor result with success status
+ */
+export default function runExecutor(options: ApplyPatchesExecutorOptions, context: ExecutorContext): Promise<ApplyPatchesExecutorResult>;
+//# sourceMappingURL=executor.d.ts.map

package/dist/nx-plugin/executors/apply-patches/executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"executor.d.ts","sourceRoot":"","sources":["../../../../src/nx-plugin/executors/apply-patches/executor.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,KAAK,eAAe,EAAU,MAAM,YAAY,CAAC;AAC1D,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,UAAU,CAAC;AAG5D;;GAEG;AACH,MAAM,WAAW,0BAA0B;IAC1C,OAAO,EAAE,OAAO,CAAC;CACjB;AAED;;;;;;;;;GASG;AACH,wBAA8B,WAAW,CACxC,OAAO,EAAE,2BAA2B,EACpC,OAAO,EAAE,eAAe,GACtB,OAAO,CAAC,0BAA0B,CAAC,CAmErC"}

package/dist/nx-plugin/executors/apply-patches/executor.js

@@ -0,0 +1,77 @@
+/**
+ * Copyright (c) 2026, Salesforce, Inc.,
+ * All rights reserved.
+ * For full license text, see the LICENSE.txt file
+ */
+import { execSync } from "child_process";
+import { join } from "path";
+import { logger } from "@nx/devkit";
+import { createProjectPaths } from "../utils";
+/**
+ * Nx executor for applying template patches
+ *
+ * This executor wraps the apply-patches CLI command and automatically determines paths
+ * based on the Nx project configuration.
+ *
+ * @param options - Executor options
+ * @param context - Nx executor context
+ * @returns Executor result with success status
+ */
+export default async function runExecutor(options, context) {
+    try {
+        const projectPaths = createProjectPaths(context);
+        if (!projectPaths) {
+            return { success: false };
+        }
+        // Get workspace root (absolute path)
+        const workspaceRoot = context.root;
+        // Build paths for CLI command
+        const featurePath = projectPaths.root;
+        const baseAppPath = options.baseAppPath || "packages/template/base-app/base-react-app";
+        const outputPath = projectPaths.dist;
+        logger.info(`Applying patches for ${context.projectName}...`);
+        logger.info(`  Feature path: ${featurePath}`);
+        logger.info(`  Base app: ${baseAppPath}`);
+        logger.info(`  Output: ${outputPath}`);
+        // Execute the CLI command via npx tsx (compiled dist has ESM resolution issues with Node)
+        const cliPath = "packages/template/patches-cli/src/index.ts";
+        // Build command with arguments
+        let command = `npx tsx ${cliPath} apply-patches ${featurePath} ${baseAppPath} ${outputPath}`;
+        // Add flags
+        if (options.reset !== false) {
+            command += " --reset";
+        }
+        if (options.skipDependencyChanges) {
+            command += " --skip-dependency-changes";
+        }
+        logger.info(`  Executing: ${command}`);
+        execSync(command, {
+            cwd: workspaceRoot,
+            stdio: "inherit",
+            env: process.env,
+        });
+        // Type-check the generated dist app
+        const uiBundleAbsPath = join(workspaceRoot, projectPaths.uiBundle);
+        const execOptions = {
+            cwd: uiBundleAbsPath,
+            stdio: "inherit",
+            env: process.env,
+        };
+        logger.info("Running type check on generated dist app...");
+        execSync("npx tsc --noEmit", execOptions);
+        // Clean up node_modules to prevent it from being cached
+        const nodeModulesPath = join(projectPaths.uiBundle, "node_modules");
+        logger.info(`\n\nRemoving ${nodeModulesPath} to exclude from Nx cache...`);
+        execSync(`rm -rf "${nodeModulesPath}"`, {
+            cwd: workspaceRoot,
+            stdio: "inherit",
+        });
+        return { success: true };
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        logger.error(`Failed to apply patches: ${errorMessage}`);
+        return { success: false };
+    }
+}
+//# sourceMappingURL=executor.js.map

package/dist/nx-plugin/executors/apply-patches/executor.js.map

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

package/dist/nx-plugin/executors/build-dist-app/executor.d.ts

@@ -0,0 +1,20 @@
+import { type ExecutorContext } from "@nx/devkit";
+import type { BuildDistAppExecutorOptions } from "./schema";
+/**
+ * Result of the executor
+ */
+export interface BuildDistAppExecutorResult {
+    success: boolean;
+}
+/**
+ * Nx executor for building the application in the dist folder
+ *
+ * This executor navigates to the project's dist folder and runs npm install (no lockfile),
+ * installs internal @salesforce packages from workspace via file:, then npm run build.
+ *
+ * @param options - Executor options
+ * @param context - Nx executor context
+ * @returns Executor result with success status
+ */
+export default function runExecutor(options: BuildDistAppExecutorOptions, context: ExecutorContext): Promise<BuildDistAppExecutorResult>;
+//# sourceMappingURL=executor.d.ts.map

package/dist/nx-plugin/executors/build-dist-app/executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"executor.d.ts","sourceRoot":"","sources":["../../../../src/nx-plugin/executors/build-dist-app/executor.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,KAAK,eAAe,EAAU,MAAM,YAAY,CAAC;AAC1D,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,UAAU,CAAC;AAiB5D;;GAEG;AACH,MAAM,WAAW,0BAA0B;IAC1C,OAAO,EAAE,OAAO,CAAC;CACjB;AAED;;;;;;;;;GASG;AACH,wBAA8B,WAAW,CACxC,OAAO,EAAE,2BAA2B,EACpC,OAAO,EAAE,eAAe,GACtB,OAAO,CAAC,0BAA0B,CAAC,CA4DrC"}

package/dist/nx-plugin/executors/build-dist-app/executor.js

@@ -0,0 +1,88 @@
+/**
+ * Copyright (c) 2026, Salesforce, Inc.,
+ * All rights reserved.
+ * For full license text, see the LICENSE.txt file
+ */
+import { execSync } from "child_process";
+import { existsSync, readFileSync } from "fs";
+import { join } from "path";
+import { logger } from "@nx/devkit";
+import { createProjectPaths } from "../utils";
+const NO_PACKAGE_LOCK = "--package-lock=false";
+/** Workspace-relative paths for internal @salesforce packages to install from file (not template/app/feature packages). */
+const INTERNAL_PACKAGE_PATHS = [
+    "packages/sdk/sdk-core",
+    "packages/sdk/sdk-data",
+    "packages/sdk/sdk-chat",
+    "packages/sdk/sdk-lightning",
+    "packages/sdk/sdk-view",
+    "packages/ui-bundle",
+    "packages/vite-plugin-ui-bundle",
+    "packages/agentforceConversationClient",
+];
+/**
+ * Nx executor for building the application in the dist folder
+ *
+ * This executor navigates to the project's dist folder and runs npm install (no lockfile),
+ * installs internal @salesforce packages from workspace via file:, then npm run build.
+ *
+ * @param options - Executor options
+ * @param context - Nx executor context
+ * @returns Executor result with success status
+ */
+export default async function runExecutor(options, context) {
+    try {
+        const projectPaths = createProjectPaths(context);
+        if (!projectPaths) {
+            return { success: false };
+        }
+        // Build absolute path to the UI Bundle
+        const targetPath = join(context.root, projectPaths.uiBundle);
+        logger.info(`Building application in ${targetPath}...`);
+        const execOptions = { cwd: targetPath, stdio: "inherit", env: process.env };
+        // Collect all valid internal @salesforce packages to install from workspace
+        const fileInstalls = [];
+        for (const relPath of INTERNAL_PACKAGE_PATHS) {
+            const pkgPath = join(context.root, relPath);
+            const pkgJsonPath = join(pkgPath, "package.json");
+            if (!existsSync(pkgJsonPath))
+                continue;
+            const distPath = join(pkgPath, "dist");
+            if (!existsSync(distPath))
+                continue;
+            let name;
+            try {
+                name = JSON.parse(readFileSync(pkgJsonPath, "utf8")).name;
+            }
+            catch {
+                continue;
+            }
+            if (!name || !name.startsWith("@salesforce/"))
+                continue;
+            fileInstalls.push(`${name}@file:${pkgPath}`);
+        }
+        // Single npm install: package.json deps + local @salesforce packages (no lockfile for publish-safe dist)
+        const installArgs = [NO_PACKAGE_LOCK, ...fileInstalls].filter(Boolean);
+        logger.info(fileInstalls.length > 0
+            ? `Running npm install with ${fileInstalls.length} local @salesforce packages...`
+            : "Running npm install (no package lock)...");
+        execSync(`npm install ${installArgs.join(" ")}`, execOptions);
+        // Lint the dist app before building to catch issues early
+        logger.info("Running lint on dist app...");
+        execSync("npm run lint", execOptions);
+        // Execute npm run build
+        logger.info("Running npm run build...");
+        execSync("npm run build", execOptions);
+        // Type-check the dist app after build
+        logger.info("Running type check on dist app...");
+        execSync("npx tsc --noEmit", execOptions);
+        logger.info("Build completed successfully");
+        return { success: true };
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        logger.error(`Failed to build dist app: ${errorMessage}`);
+        return { success: false };
+    }
+}
+//# sourceMappingURL=executor.js.map

package/dist/nx-plugin/executors/build-dist-app/executor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"executor.js","sourceRoot":"","sources":["../../../../src/nx-plugin/executors/build-dist-app/executor.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,QAAQ,EAAwB,MAAM,eAAe,CAAC;AAC/D,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,IAAI,CAAC;AAC9C,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,EAAwB,MAAM,EAAE,MAAM,YAAY,CAAC;AAE1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAE9C,MAAM,eAAe,GAAG,sBAAsB,CAAC;AAE/C,2HAA2H;AAC3H,MAAM,sBAAsB,GAAG;IAC9B,uBAAuB;IACvB,uBAAuB;IACvB,uBAAuB;IACvB,4BAA4B;IAC5B,uBAAuB;IACvB,oBAAoB;IACpB,gCAAgC;IAChC,uCAAuC;CACvC,CAAC;AASF;;;;;;;;;GASG;AACH,MAAM,CAAC,OAAO,CAAC,KAAK,UAAU,WAAW,CACxC,OAAoC,EACpC,OAAwB;IAExB,IAAI,CAAC;QACJ,MAAM,YAAY,GAAG,kBAAkB,CAAC,OAAO,CAAC,CAAC;QACjD,IAAI,CAAC,YAAY,EAAE,CAAC;YACnB,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;QAC3B,CAAC;QAED,uCAAuC;QACvC,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,YAAY,CAAC,QAAQ,CAAC,CAAC;QAE7D,MAAM,CAAC,IAAI,CAAC,2BAA2B,UAAU,KAAK,CAAC,CAAC;QAExD,MAAM,WAAW,GAAoB,EAAE,GAAG,EAAE,UAAU,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC;QAE7F,4EAA4E;QAC5E,MAAM,YAAY,GAAa,EAAE,CAAC;QAClC,KAAK,MAAM,OAAO,IAAI,sBAAsB,EAAE,CAAC;YAC9C,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;YAC5C,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC;YAClD,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC;gBAAE,SAAS;YACvC,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;YACvC,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC;gBAAE,SAAS;YACpC,IAAI,IAAwB,CAAC;YAC7B,IAAI,CAAC;gBACJ,IAAI,GAAI,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,WAAW,EAAE,MAAM,CAAC,CAAuB,CAAC,IAAI,CAAC;YAClF,CAAC;YAAC,MAAM,CAAC;gBACR,SAAS;YACV,CAAC;YACD,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,cAAc,CAAC;gBAAE,SAAS;YACxD,YAAY,CAAC,IAAI,CAAC,GAAG,IAAI,SAAS,OAAO,EAAE,CAAC,CAAC;QAC9C,CAAC;QAED,yGAAyG;QACzG,MAAM,WAAW,GAAG,CAAC,eAAe,EAAE,GAAG,YAAY,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QACvE,MAAM,CAAC,IAAI,CACV,YAAY,CAAC,MAAM,GAAG,CAAC;YACtB,CAAC,CAAC,4BAA4B,YAAY,CAAC,MAAM,gCAAgC;YACjF,CAAC,CAAC,0CAA0C,CAC7C,CAAC;QACF,QAAQ,CAAC,eAAe,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,WAAW,CAAC,CAAC;QAE9D,0DAA0D;QAC1D,MAAM,CAAC,IAAI,CAAC,6BAA6B,CAAC,CAAC;QAC3C,QAAQ,CAAC,cAAc,EAAE,WAAW,CAAC,CAAC;QAEtC,wBAAwB;QACxB,MAAM,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAC;QACxC,QAAQ,CAAC,eAAe,EAAE,WAAW,CAAC,CAAC;QAEvC,sCAAsC;QACtC,MAAM,CAAC,IAAI,CAAC,mCAAmC,CAAC,CAAC;QACjD,QAAQ,CAAC,kBAAkB,EAAE,WAAW,CAAC,CAAC;QAE1C,MAAM,CAAC,IAAI,CAAC,8BAA8B,CAAC,CAAC;QAC5C,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IAC1B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAChB,MAAM,YAAY,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC5E,MAAM,CAAC,KAAK,CAAC,6BAA6B,YAAY,EAAE,CAAC,CAAC;QAC1D,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;IAC3B,CAAC;AACF,CAAC"}

package/dist/nx-plugin/executors/dev-server/executor.d.ts

@@ -0,0 +1,20 @@
+import { type ExecutorContext } from "@nx/devkit";
+import type { DevServerExecutorOptions } from "./schema";
+/**
+ * Result of the executor
+ */
+export interface DevServerExecutorResult {
+    success: boolean;
+}
+/**
+ * Nx executor for starting the dev server
+ *
+ * This executor starts a Vite dev server for the UI Bundle.
+ * It runs npm install first, then starts the dev server asynchronously.
+ *
+ * @param options - Executor options
+ * @param context - Nx executor context
+ * @returns Async generator yielding executor results
+ */
+export default function runExecutor(options: DevServerExecutorOptions, context: ExecutorContext): AsyncGenerator<DevServerExecutorResult>;
+//# sourceMappingURL=executor.d.ts.map

package/dist/nx-plugin/executors/dev-server/executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"executor.d.ts","sourceRoot":"","sources":["../../../../src/nx-plugin/executors/dev-server/executor.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,KAAK,eAAe,EAAU,MAAM,YAAY,CAAC;AAC1D,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,UAAU,CAAC;AAGzD;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACvC,OAAO,EAAE,OAAO,CAAC;CACjB;AAED;;;;;;;;;GASG;AACH,wBAA+B,WAAW,CACzC,OAAO,EAAE,wBAAwB,EACjC,OAAO,EAAE,eAAe,GACtB,cAAc,CAAC,uBAAuB,CAAC,CA0CzC"}