@salesforce/webapp-template-cli-experimental 1.43.0 → 1.44.0

package/README.md

@@ -19,14 +19,14 @@ npm run build --workspace=@salesforce/webapp-template-cli-experimental
 npm run apply-patches -- <feature-path> <app-path> <target-dir>
 
 # Examples:
-# Apply navigation-menu patches to my-app (using base-react-app as reference)
-npm run apply-patches -- packages/feature/feature-react-nav-menu packages/base-app/base-react-app my-app
+# Apply shadcn UI patches to my-app (using base-react-app as reference)
+npm run apply-patches -- packages/template/feature/feature-react-shadcn packages/template/base-app/base-react-app my-app
 
 # Skip dependency installation
-npm run apply-patches -- packages/feature/feature-react-nav-menu packages/base-app/base-react-app my-app --skip-dependency-changes
+npm run apply-patches -- packages/template/feature/feature-react-shadcn packages/template/base-app/base-react-app my-app --skip-dependency-changes
 
 # Reset target directory to base app state before applying (preserves node_modules)
-npm run apply-patches -- packages/feature/feature-react-nav-menu packages/base-app/base-react-app my-app --reset
+npm run apply-patches -- packages/template/feature/feature-react-shadcn packages/template/base-app/base-react-app my-app --reset
 ```
 
 ### Direct usage
@@ -141,9 +141,9 @@ The CLI tool:
 ### Example: Apply feature patches to create a new app
 
 ```bash
-$ npm run apply-patches -- packages/feature/feature-react-nav-menu packages/base-app/base-react-app my-app
+$ npm run apply-patches -- packages/template/feature/feature-react-shadcn packages/template/base-app/base-react-app my-app
 
-Applying patches: packages/feature-react-nav-menu → my-app
+Applying patches: packages/template/feature/feature-react-shadcn → my-app
 ℹ Validating paths...
 ✓ Validation passed
 ℹ Creating target directory my-app...
@@ -153,17 +153,14 @@ Resolving Dependencies
 ℹ No dependencies to resolve
 
 
-Applying: packages/feature-react-nav-menu
+Applying: packages/template/feature/feature-react-shadcn
 ℹ Discovering files...
-ℹ Found 6 file(s)
+ℹ Found 14 file(s)
 ℹ Validating paths...
 ✓ Paths validated
-✓ Added webapplications/feature-react-nav-menu/src/navigationMenu.tsx
-✓ Added webapplications/feature-react-nav-menu/src/appLayout.tsx
-✓ Added webapplications/feature-react-nav-menu/src/routes.tsx
-✓ Added webapplications/feature-react-nav-menu/src/router-utils.tsx
-✓ Added webapplications/feature-react-nav-menu/src/about.tsx
-✓ Added webapplications/feature-react-nav-menu/src/new.tsx
+✓ Added webapplications/feature-react-shadcn/src/components/ui/button.tsx
+✓ Added webapplications/feature-react-shadcn/src/components/ui/card.tsx
+...
 
 Installing dependencies
 ℹ Installing dependencies...
@@ -249,9 +246,9 @@ export default feature;
 import type { Feature } from "../cli/src/types.js";
 
 const feature: Feature = {
-  // This feature depends on navigation-menu feature
-  // navigation-menu will be applied first, then this feature
-  dependencies: ["packages/feature/feature-react-nav-menu"],
+  // This feature depends on shadcn UI feature
+  // shadcn will be applied first, then this feature
+  dependencies: ["packages/template/feature/feature-react-shadcn"],
   packageJson: {
     dependencies: {
       "some-package": "^1.0.0",
@@ -284,7 +281,7 @@ export default feature;
 **Notes:**
 
 - `templateDir`: All files in this directory will be discovered and applied to the target app
-- `webAppName`: Used to construct the default route path and organize files. Defaults to the feature directory name (e.g., `feature-react-nav-menu` → `feature-react-nav-menu`)
+- `webAppName`: Used to construct the default route path and organize files. Defaults to the feature directory name (e.g., `feature-react-shadcn` → `feature-react-shadcn`)
 - `routeFilePath`: Must be a path relative to `templateDir`. If not specified, defaults to `webapplications/<webAppName>/src/routes.tsx`
 
 ## Path Mappings
@@ -293,10 +290,10 @@ Path mappings allow features to use simplified directory structures that are aut
 
 ### Default Behavior (Enabled by Default)
 
-By default, all features automatically get the `webApp` mapping, which transforms web application files into the proper nested structure. For example, in `feature-react-nav-menu`:
+By default, all features automatically get the `webApp` mapping, which transforms web application files into the proper nested structure. For example, in `feature-react-shadcn`:
 
 ```
-template/webApp/src/app.tsx → dist/webapplications/feature-react-nav-menu/src/app.tsx
+template/webApp/src/app.tsx → dist/webapplications/feature-react-shadcn/src/app.tsx
 ```
 
 This simplifies feature templates by removing the repetitive nested directory structure.
@@ -304,12 +301,12 @@ This simplifies feature templates by removing the repetitive nested directory st
 **Important**: Only files under `webApp/` get the nested structure. SFDX metadata types (like `classes/`, `triggers/`, `objects/`, `lwc/`, etc.) are placed at root level:
 
 ```
-feature-react-nav-menu/template/
+feature-react-shadcn/template/
 ├── webApp/
 │   └── src/
-│       └── app.tsx          → dist/webapplications/feature-react-nav-menu/src/app.tsx
+│       └── app.tsx          → dist/webapplications/feature-react-shadcn/src/app.tsx
 └── classes/
-    └── NavMenu.cls          → dist/classes/NavMenu.cls (root level)
+    └── MyClass.cls          → dist/classes/MyClass.cls (root level)
 ```
 
 ### Using the Default Mapping
@@ -506,26 +503,26 @@ Application order: C → B → A (dependencies first)
 
 The CLI builds a complete dependency graph and applies features in topological order.
 
-### Example: Building on Navigation Features
+### Example: Building on Shared UI Features
 
 ```typescript
-// packages/feature/feature-react-nav-menu/feature.ts
+// packages/template/feature/feature-react-shadcn/feature.ts
 import type { Feature } from "../../../cli/src/types.js";
 
 const feature: Feature = {
-  // Navigation menu has no dependencies
+  // Shadcn UI has no dependencies
 };
 
 export default feature;
 ```
 
 ```typescript
-// packages/feature/feature-admin-dashboard/feature.ts
+// packages/template/feature/feature-admin-dashboard/feature.ts
 import type { Feature } from "../../../cli/src/types.js";
 
 const feature: Feature = {
-  // Admin dashboard builds on top of navigation menu
-  dependencies: ["packages/feature/feature-react-nav-menu"],
+  // Admin dashboard builds on top of shadcn UI
+  dependencies: ["packages/template/feature/feature-react-shadcn"],
 };
 
 export default feature;
@@ -533,10 +530,10 @@ export default feature;
 
 When you apply `feature-admin-dashboard`:
 
-1. CLI resolves `feature-react-nav-menu` as a dependency
-2. Applies `feature-react-nav-menu` first (navigation menu files and routes)
+1. CLI resolves `feature-react-shadcn` as a dependency
+2. Applies `feature-react-shadcn` first (UI components)
 3. Applies `feature-admin-dashboard` second (dashboard files and routes)
-4. Result: App has both navigation menu and admin dashboard
+4. Result: App has both shared UI and admin dashboard
 
 ### Nested Dependencies
 
@@ -577,11 +574,11 @@ When multiple features modify the same file:
 Example:
 
 ```
-feature-react-nav-menu provides: src/appLayout.tsx
+feature-react-shadcn provides: src/appLayout.tsx
 feature-custom-app also provides: src/appLayout.tsx
 
 When applying feature-custom-app:
-1. navigation-menu's appLayout.tsx is applied
+1. shadcn's appLayout.tsx is applied
 2. custom-app's appLayout.tsx overwrites it
 3. Final result: custom-app's version is used
 ```
@@ -638,7 +635,7 @@ Routes accumulate across all features, preserving routes from base app and all d
 
 Dependency paths can be:
 
-- **Relative to monorepo root**: `'packages/feature/feature-react-nav-menu'`
+- **Relative to monorepo root**: `'packages/template/feature/feature-react-shadcn'`
 - **Absolute paths**: `'/absolute/path/to/feature'`
 
 The CLI normalizes and resolves all paths consistently.
@@ -1534,7 +1531,7 @@ You can set default options for all projects in `nx.json`:
 
 #### `build-dist-app`
 
-Builds the application in the dist folder by running `npm ci` and `npm run build`. This executor is useful for building feature apps after patches have been applied.
+Builds the application in the dist folder by running `npm ci` (or `npm install` when no `package-lock.json` exists) and `npm run build`. This executor is useful for building feature apps after patches have been applied.
 
 **Usage in `package.json`:**
 
@@ -1594,7 +1591,7 @@ nx run-many -t build test
 
 2. **build-dist-app executor**:
    - Locates the built application in `dist/force-app/main/default/webapplications/<project-name>/`
-   - Runs `npm ci` to install dependencies
+   - Runs `npm ci` to install dependencies (or `npm install` when no `package-lock.json` exists)
    - Runs `npm run build` to build the application
    - Suitable for CI/CD pipelines and automated testing
 

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

@@ -9,7 +9,8 @@ export interface BuildDistAppExecutorResult {
 /**
  * Nx executor for building the application in the dist folder
  *
- * This executor navigates to the project's dist folder and runs npm ci followed by npm run build.
+ * This executor navigates to the project's dist folder and runs npm ci (or npm install when
+ * no package-lock.json exists) followed by npm run build.
  *
  * @param options - Executor options
  * @param context - Nx executor context

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

@@ -1 +1 @@
-{"version":3,"file":"executor.d.ts","sourceRoot":"","sources":["../../../../src/nx-plugin/executors/build-dist-app/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;;;;;;;;GAQG;AACH,wBAA8B,WAAW,CACxC,OAAO,EAAE,2BAA2B,EACpC,OAAO,EAAE,eAAe,GACtB,OAAO,CAAC,0BAA0B,CAAC,CA6BrC"}
+{"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;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,CAkCrC"}

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

@@ -4,13 +4,15 @@
  * For full license text, see the LICENSE.txt file
  */
 import { execSync } from "child_process";
+import { existsSync } from "fs";
 import { join } from "path";
 import { logger } from "@nx/devkit";
 import { createProjectPaths } from "../utils";
 /**
  * Nx executor for building the application in the dist folder
  *
- * This executor navigates to the project's dist folder and runs npm ci followed by npm run build.
+ * This executor navigates to the project's dist folder and runs npm ci (or npm install when
+ * no package-lock.json exists) followed by npm run build.
  *
  * @param options - Executor options
  * @param context - Nx executor context
@@ -25,13 +27,19 @@ export default async function runExecutor(options, context) {
         // Build absolute path to the web app
         const targetPath = join(context.root, projectPaths.webApp);
         logger.info(`Building application in ${targetPath}...`);
-        const options = { cwd: targetPath, stdio: "inherit", env: process.env };
-        // Execute npm ci
-        logger.info("Running npm ci...");
-        execSync("npm ci", options);
+        const execOptions = { cwd: targetPath, stdio: "inherit", env: process.env };
+        const hasLockfile = existsSync(join(targetPath, "package-lock.json"));
+        if (hasLockfile) {
+            logger.info("Running npm ci...");
+            execSync("npm ci", execOptions);
+        }
+        else {
+            logger.info("No package-lock.json found; running npm install...");
+            execSync("npm install", execOptions);
+        }
         // Execute npm run build
         logger.info("Running npm run build...");
-        execSync("npm run build", options);
+        execSync("npm run build", execOptions);
         logger.info("Build completed successfully");
         return { success: true };
     }

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

@@ -1 +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,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,EAAwB,MAAM,EAAE,MAAM,YAAY,CAAC;AAE1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAS9C;;;;;;;;GAQG;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,qCAAqC;QACrC,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,YAAY,CAAC,MAAM,CAAC,CAAC;QAE3D,MAAM,CAAC,IAAI,CAAC,2BAA2B,UAAU,KAAK,CAAC,CAAC;QAExD,MAAM,OAAO,GAAoB,EAAE,GAAG,EAAE,UAAU,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC;QAEzF,iBAAiB;QACjB,MAAM,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;QACjC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAE5B,wBAAwB;QACxB,MAAM,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAC;QACxC,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC,CAAC;QAEnC,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"}
+{"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,MAAM,IAAI,CAAC;AAChC,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,EAAwB,MAAM,EAAE,MAAM,YAAY,CAAC;AAE1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAS9C;;;;;;;;;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,qCAAqC;QACrC,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,YAAY,CAAC,MAAM,CAAC,CAAC;QAE3D,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,MAAM,WAAW,GAAG,UAAU,CAAC,IAAI,CAAC,UAAU,EAAE,mBAAmB,CAAC,CAAC,CAAC;QACtE,IAAI,WAAW,EAAE,CAAC;YACjB,MAAM,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;YACjC,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;QACjC,CAAC;aAAM,CAAC;YACP,MAAM,CAAC,IAAI,CAAC,oDAAoD,CAAC,CAAC;YAClE,QAAQ,CAAC,aAAa,EAAE,WAAW,CAAC,CAAC;QACtC,CAAC;QAED,wBAAwB;QACxB,MAAM,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAC;QACxC,QAAQ,CAAC,eAAe,EAAE,WAAW,CAAC,CAAC;QAEvC,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/executors.json

@@ -13,7 +13,7 @@
     "build-dist-app": {
       "implementation": "./src/nx-plugin/executors/build-dist-app/executor.ts",
       "schema": "./src/nx-plugin/executors/build-dist-app/schema.json",
-      "description": "Builds the application in the dist folder by running npm ci and npm run build"
+      "description": "Builds the application in the dist folder by running npm ci (or npm install when no package-lock.json) and npm run build"
     },
     "dev-server": {
       "implementation": "./src/nx-plugin/executors/dev-server/executor.ts",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@salesforce/webapp-template-cli-experimental",
-  "version": "1.43.0",
+  "version": "1.44.0",
   "description": "CLI tool for applying feature patches to base apps",
   "license": "SEE LICENSE IN LICENSE.txt",
   "type": "module",
@@ -45,5 +45,5 @@
     "typescript": "~5.9.3",
     "vitest": "^4.0.17"
   },
-  "gitHead": "6987ff60e5d99e64b34cbe2383e54cda1727e151"
+  "gitHead": "00f5b3b58d400b13a1b1130d11f571c2e1366cb4"
 }