@salesforce/templates 66.1.1 → 66.2.0

package/lib/generators/projectGenerator.d.ts

@@ -2,7 +2,13 @@ import { ProjectOptions } from '../utils/types';
 import { BaseGenerator } from './baseGenerator';
 export default class ProjectGenerator extends BaseGenerator<ProjectOptions> {
     constructor(options: ProjectOptions);
+    /**
+     * Returns template path for primary; if it doesn't exist, returns fallback path.
+     * Used so react-b2e/react-b2x can omit shared files and fall back to standard.
+     */
+    private templatePathWithFallback;
     validateOptions(): void;
     generate(): Promise<void>;
+    private registerChange;
     private _createHuskyConfig;
 }

package/lib/generators/projectGenerator.js

@@ -11,7 +11,15 @@ const fs = require("fs");
 const promises_1 = require("node:fs/promises");
 const path = require("path");
 const utils_1 = require("../utils");
+const webappTemplateUtils_1 = require("../utils/webappTemplateUtils");
 const baseGenerator_1 = require("./baseGenerator");
+const VALID_PROJECT_TEMPLATES = [
+    'standard',
+    'empty',
+    'analytics',
+    'react-b2e',
+    'react-b2x',
+];
 const GITIGNORE = 'gitignore';
 const HUSKY_FOLDER = '.husky';
 const huskyhookarray = ['pre-commit'];
@@ -53,11 +61,26 @@ class ProjectGenerator extends baseGenerator_1.BaseGenerator {
         super(options);
         this.sourceRootWithPartialPath('project');
     }
+    /**
+     * Returns template path for primary; if it doesn't exist, returns fallback path.
+     * Used so react-b2e/react-b2x can omit shared files and fall back to standard.
+     */
+    templatePathWithFallback(primary, fallback) {
+        const primaryPath = this.templatePath(primary);
+        return fs.existsSync(primaryPath)
+            ? primaryPath
+            : this.templatePath(fallback);
+    }
     validateOptions() {
-        utils_1.CreateUtil.checkInputs(this.options.template);
+        utils_1.CreateUtil.checkInputs(this.options.projectname);
+        if (!VALID_PROJECT_TEMPLATES.includes(this.options.template)) {
+            throw new Error(`Invalid project template: ${this.options.template}. Valid options: ${VALID_PROJECT_TEMPLATES.join(', ')}`);
+        }
     }
     generate() {
         return tslib_1.__awaiter(this, void 0, void 0, function* () {
+            // Re-apply source root so customTemplatesRootPath (set in run()) is used when provided
+            this.sourceRootWithPartialPath('project');
             const { projectname, template, defaultpackagedir, manifest, ns, loginurl } = this.options;
             const folderlayout = [
                 this.outputdir,
@@ -70,8 +93,8 @@ class ProjectGenerator extends baseGenerator_1.BaseGenerator {
             const manifestFile = `${template}/Manifest.xml`;
             const soqlQueryFile = 'account.soql';
             const anonApexFile = 'hello.apex';
-            yield this.render(this.templatePath(scratchDefFile), this.destinationPath(path.join(this.outputdir, projectname, 'config', 'project-scratch-def.json')), { company: (process.env.USER || 'Demo') + ' company' });
-            yield this.render(this.templatePath(`${template}/README.md`), this.destinationPath(path.join(this.outputdir, projectname, 'README.md')), {});
+            yield this.render(this.templatePathWithFallback(scratchDefFile, 'standard/ScratchDef.json'), this.destinationPath(path.join(this.outputdir, projectname, 'config', 'project-scratch-def.json')), { company: (process.env.USER || 'Demo') + ' company' });
+            yield this.render(this.templatePathWithFallback(`${template}/README.md`, 'standard/README.md'), this.destinationPath(path.join(this.outputdir, projectname, 'README.md')), {});
             yield this.render(this.templatePath('sfdx-project.json'), this.destinationPath(path.join(this.outputdir, projectname, 'sfdx-project.json')), {
                 defaultpackagedir,
                 namespace: ns,
@@ -80,7 +103,7 @@ class ProjectGenerator extends baseGenerator_1.BaseGenerator {
                 name: projectname,
             });
             if (manifest === true) {
-                yield this.render(this.templatePath(manifestFile), this.destinationPath(path.join(this.outputdir, projectname, 'manifest', 'package.xml')), { apiversion: this.apiversion });
+                yield this.render(this.templatePathWithFallback(manifestFile, 'standard/Manifest.xml'), this.destinationPath(path.join(this.outputdir, projectname, 'manifest', 'package.xml')), { apiversion: this.apiversion });
             }
             if (template === 'standard') {
                 yield makeEmptyFolders(folderlayout, standardfolderarray);
@@ -131,8 +154,24 @@ class ProjectGenerator extends baseGenerator_1.BaseGenerator {
                     yield this.render(this.templatePath(file), this.destinationPath(path.join(this.outputdir, projectname, out)), {});
                 }
             }
+            if (webappTemplateUtils_1.BUILT_IN_FULL_TEMPLATES.has(template)) {
+                yield (0, webappTemplateUtils_1.generateBuiltInFullTemplate)(template, projectname, {
+                    templateDir: this.templatePath(template),
+                    projectDir: path.join(this.outputdir, projectname),
+                    defaultpackagedir,
+                    ns,
+                    loginurl,
+                    apiversion: this.apiversion,
+                    renderEjs: webappTemplateUtils_1.renderEjsFile,
+                    onFileCreated: (destPath) => this.registerChange(destPath),
+                });
+            }
         });
     }
+    registerChange(destPath) {
+        const relativePath = path.relative(process.cwd(), destPath);
+        this.changes.created.push(relativePath);
+    }
     _createHuskyConfig(projectRootDir) {
         return tslib_1.__awaiter(this, void 0, void 0, function* () {
             const huskyDirPath = path.join(projectRootDir, HUSKY_FOLDER);

package/lib/generators/projectGenerator.js.map

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

package/lib/templates/project/react-b2e/.a4drules/README.md

@@ -0,0 +1,35 @@
+# A4D Rules Index
+
+Rules in this folder guide the agent for this SFDX project. **Knowledge** (expert content) lives in the **local-expert MCP** repo (e.g. `local-expert-mcp`); rules here reference when to call which expert.
+
+## Always-apply rules (MUST follow)
+
+| File | Purpose |
+|------|--------|
+| **webapp.md** | Main web app rules: invoke local-expert MCP (`webapplications-design-system` + `webapplications`), no `node -e`, React/SFDX workflow; **replace default boilerplate**; **populate home page**; **frontend aesthetics**—avoid AI slop, follow design-system expert. |
+| **webapp-no-node-e.md** | No `node -e` for any file/config/shell work; use `replace_in_file` or `write_to_file` only. |
+| **a4d-webapp-generate.md** | Before `sf webapp generate`: call `get_expert_knowledge` with `webapplications-design-system` and `webapplications`; then run CLI. |
+| **webapp-ui-first.md** | Build UI (layout, components, styling) first; then implement business logic (APIs, state, handlers). |
+| **webapp-nav-and-placeholders.md** | **Build navigation into the app layout** (`appLayout.tsx`). Always update nav menu (app-specific items/labels) and placeholder name/design (header/nav/footer/title). Often missed—mandatory. |
+
+## Context-specific rules (by file pattern or topic)
+
+| File | Purpose |
+|------|--------|
+| **react.md** | React web app structure, shadcn/Tailwind, data access, security; edit `appLayout.tsx` when changing layout. |
+| **ui-layout.md** | When changing UI/nav/header/footer/sidebar/theme, always update `appLayout.tsx`. |
+| **code-quality.md** | ESLint, Prettier, import order, naming, lint/build before completion; no `node -e`. |
+| **build-validation.md** | `npm run build` must succeed from web app dir before completing. |
+| **typescript.md** | TypeScript strictness, return types, interfaces. |
+| **images.md** | Images: Unsplash default, CSP, alt text, error handling. |
+| **react_image_processing.md** | Image handling (Unsplash, CSP, accessibility) for React components. |
+| **graphql/** | GraphQL tools and knowledge (schemas, LDS guides). |
+
+## Knowledge repository (experts)
+
+Expert knowledge is served by the **local-expert MCP** (e.g. at `local-expert-mcp`). The agent must call **`get_expert_knowledge`** with the appropriate topic:
+
+- **webapplications-design-system** — Always use for web app UI/design work (design system, typography, color, motion).
+- **webapplications** — Use for app generation and structure; then call sub-topics as needed (e.g. `webapplications-best-practice`, `webapplications-feature-*`).
+
+See the MCP repo's **rule-expert-mcp.md** for full topic list and when to call which expert.

package/lib/templates/project/react-b2e/.a4drules/a4d-webapp-generate.md

@@ -0,0 +1,27 @@
+---
+description: A4D rule — call expert MCP (webapplications + webapplications-design-system) before sf webapp generate
+alwaysApply: true
+---
+
+# A4D Rule: Before `sf webapp generate`
+
+Before running **`sf webapp generate`**, you **must**:
+
+1. **Call the expert MCP** (`get_expert_knowledge`) with topic **`webapplications-design-system`** — always invoke this expert for UI/design direction.
+2. **Call the expert MCP** with topic **`webapplications`** to get generation and structure guidance.
+3. Follow the instructions from the MCP responses.
+4. Only after that, run `sf webapp generate` (e.g. `sf webapp generate -n <AppName> -t <template>`).
+
+**Webapp name (`-n` / `<AppName>`):** Must be **alphanumerical only**—no spaces, hyphens, underscores, or other special characters. Use only letters (A–Z, a–z) and digits (0–9). If the desired name has spaces or special characters, use a single alphanumeric word (e.g. `CoffeeBoutique` instead of `Coffee Boutique` or `coffee-boutique`).
+
+Do not run `sf webapp generate` without having invoked the expert MCP with **`webapplications-design-system`** and **`webapplications`** first.
+
+When modifying an existing web app (UI, layout, or new features), **always** call `get_expert_knowledge` with topic **`webapplications-design-system`** before making UI or design changes.
+
+**After generating (or when touching a new app):** Replace all default boilerplate content (e.g. "React App", "Vite + React", default document title in `index.html`, placeholder text in the shell) with the actual app name or user-facing copy. Do not leave generic template text in the UI or `<title>`.
+
+**Home page content:** Populate the home page (root route) with real, app-specific content (e.g. landing section, banners, tiles, hero, links to features). Never leave the home page as the default template or placeholder.
+
+**Navigation menu and placeholder name/design:** After generating or when delivering a web app, **you must** (1) **Edit the navigation menu** in `appLayout.tsx`: replace every default nav item and label with app-specific routes and names; do not leave template "Home"/"About" or placeholder links. (2) **Replace the placeholder app name** in the header, nav brand, footer, and `index.html` `<title>` with the actual app name. (3) **Update placeholder design** in the shell (header/footer/branding) so it is not the template default. See **webapp-nav-and-placeholders.md**. Agents often skip this—do not.
+
+Prioritize webapplications generation first, and then generate the metadata.

package/lib/templates/project/react-b2e/.a4drules/build-validation.md

@@ -0,0 +1,78 @@
+# AI Rule: Build Validation
+
+Build validation for successful deployments with minimal friction.
+
+## Targets
+- `force-app/main/default/webapplications/*/**/*`
+- `**/*.{js,ts,jsx,tsx}`
+
+## MANDATORY: Build Success
+
+**Before completing any coding session** (from the web app directory `force-app/main/default/webapplications/<appName>/`):
+```bash
+npm run build  # MUST succeed with no errors
+```
+
+## Quick Quality Checks
+Run from the web app directory (`force-app/main/default/webapplications/<appName>/`):
+```bash
+npm run lint   # ESLint; fix issues before completing
+npm run build  # Runs tsc -b && vite build; catches TypeScript and build issues
+```
+
+## Requirements
+
+**Must Pass:**
+- `npm run build` completes successfully
+- No TypeScript compilation errors
+- No critical ESLint errors
+
+**Can Be Warnings:**
+- ESLint warnings
+- Minor TypeScript warnings
+
+## Fix Commands (when available in the web app's package.json)
+```bash
+npm run lint         # Run ESLint (always available)
+# If your project adds Prettier/format scripts, use those before completing
+```
+
+## Workflow
+
+**During Development:**
+1. Write code with AI assistance
+2. Save frequently (auto-format on save)
+3. Check periodically: `npm run lint` (optional)
+
+**Before Completion:**
+1. Run `npm run build` from the web app directory
+2. If it fails: fix TypeScript/ESLint errors (run `npm run lint`), then retry build
+
+## Error Priority
+
+**Fix Immediately:**
+- TypeScript compilation errors
+- Import/export errors
+- Syntax errors
+
+**Fix When Convenient:**
+- ESLint warnings
+- Unused variables
+
+## Hard Requirements
+- Build must complete without errors
+- No broken imports
+- Basic TypeScript type safety
+
+## Key Commands (web app directory)
+```bash
+npm run start        # Start development server (vite)
+npm run build        # TypeScript + Vite build; check deployment readiness
+npm run lint         # Run ESLint
+```
+
+## Troubleshooting Import Errors
+```bash
+npm install          # Check missing dependencies
+# Verify file exists, case sensitivity, export/import match
+```

package/lib/templates/project/react-b2e/.a4drules/code-quality.md

@@ -0,0 +1,137 @@
+# AI Rule: Code Quality Standards
+
+Enforces ESLint, Prettier, and coding best practices for consistent, maintainable code.
+
+**Execution rule:** Do not use `node -e` for any file or config edits. Use `replace_in_file` or `write_to_file` only (see **webapp-no-node-e.md**).
+
+## Targets
+- `force-app/main/default/webapplications/*/**/*`
+- `**/*.{js,ts,jsx,tsx,json,md}`
+
+## MANDATORY Checks
+
+**Before completing code** (run from the web app directory `force-app/main/default/webapplications/<appName>/`):
+```bash
+npm run lint   # MUST result in: 0 errors (0 warnings preferred)
+npm run build  # MUST succeed (includes TypeScript check)
+```
+
+If your project adds Prettier, use a consistent config (e.g. `.prettierrc` with `semi`, `singleQuote`, `printWidth`, etc.) and run format checks before completing.
+
+## Lint / Fix
+
+```bash
+npm run lint   # Run ESLint (always available in the template web app)
+# Use your editor's format-on-save or add npm scripts for Prettier if desired
+```
+
+## Import Order (MANDATORY)
+```typescript
+// 1. React ecosystem
+import { useState, useEffect } from 'react';
+
+// 2. External libraries (alphabetical)
+import axios from 'axios';
+import clsx from 'clsx';
+
+// 3. UI components (alphabetical)
+import { Button } from '@/components/ui/button';
+import { Card } from '@/components/ui/card';
+
+// 4. Internal utilities (alphabetical)
+import { useAuth } from '../hooks/useAuth';
+import { formatDate } from '../utils/dateUtils';
+
+// 5. Relative imports
+import { ComponentA } from './ComponentA';
+
+// 6. Type imports (separate, at end)
+import type { User, ApiResponse } from '../types';
+```
+
+## Naming Conventions
+```typescript
+// PascalCase: Components, classes
+const UserProfile = () => {};
+const ApiClient = class {};
+
+// camelCase: Variables, functions, properties
+const userName = 'john';
+const fetchUserData = async () => {};
+
+// SCREAMING_SNAKE_CASE: Constants
+const API_BASE_URL = 'https://api.example.com';
+
+// kebab-case: Files
+// user-profile.tsx, api-client.ts
+```
+
+## React Component Structure
+```typescript
+interface ComponentProps {
+  // Props interface first
+}
+
+const Component: React.FC<ComponentProps> = ({ prop1, prop2 }) => {
+  // 1. Hooks
+  // 2. Computed values
+  // 3. Event handlers
+  // 4. JSX return
+
+  return <div />;
+};
+
+export default Component;
+```
+
+## JSX Standards
+```typescript
+// Self-closing tags
+<Button onClick={handleClick} />
+
+// Conditional rendering
+{isLoading && <Spinner />}
+{error ? <ErrorMessage error={error} /> : <Content />}
+
+// Lists with keys
+{items.map(item => <Item key={item.id} data={item} />)}
+```
+
+## Error Handling
+```typescript
+// Async functions with try-catch
+const fetchData = async (id: string): Promise<Data> => {
+  try {
+    const response = await api.get(`/data/${id}`);
+    return response.data;
+  } catch (error) {
+    console.error('Failed to fetch data:', error);
+    throw error;
+  }
+};
+```
+
+## Anti-Patterns (FORBIDDEN)
+```typescript
+// NEVER disable ESLint without justification
+// eslint-disable-next-line
+
+// NEVER mutate state directly
+state.items.push(newItem); // Wrong
+setItems(prev => [...prev, newItem]); // Correct
+
+// NEVER use magic numbers/strings
+setTimeout(() => {}, 5000); // Wrong
+const DEBOUNCE_DELAY = 5000; // Correct
+```
+
+## Quality Workflow
+
+**Before Committing:**
+1. `npm run lint` - 0 errors (and 0 warnings when possible)
+2. `npm run build` - Build must succeed (TypeScript + Vite)
+
+## Zero Tolerance Policy
+- ESLint errors: MUST be 0
+- ESLint warnings: MUST be 0 (fix when convenient)
+- TypeScript errors: MUST be 0 (enforced by `npm run build`)

package/lib/templates/project/react-b2e/.a4drules/graphql/tools/knowledge/lds-explore-graphql-schema.md

@@ -0,0 +1,227 @@
+# GraphQL Schema Reference
+
+This document provides guidance for AI agents working with the Salesforce GraphQL API schema in this project.
+
+## Schema File Location
+
+**The complete GraphQL schema is located at: `@schema.graphql`** (in the project root)
+
+> ⚠️ **Important**: The schema file is very large (~265,000+ lines). Do NOT read it entirely. Instead, use targeted searches to find specific types, fields, or operations.
+
+If the file is not present, generate it by running:
+```bash
+npm run graphql:get-schema
+```
+
+## Required Pre-Flight Check
+
+**BEFORE generating any GraphQL query, you MUST:**
+
+1. **Check if schema exists**: Look for `schema.graphql` in the project root
+2. **If schema is missing**: 
+   - Run `npm run graphql:get-schema` to download it
+   - Wait for the command to complete successfully
+   - Then proceed with schema exploration
+3. **If schema exists**: Proceed with targeted searches as described below
+
+> ⚠️ **DO NOT** generate GraphQL queries without first having access to the schema. Standard field assumptions may not match the target org's configuration.
+
+## Schema Structure Overview
+
+The schema follows the Salesforce GraphQL Wire Adapter pattern with these main entry points:
+
+### Query Entry Point
+```graphql
+type Query {
+  uiapi: UIAPI!
+}
+```
+
+### UIAPI Structure
+```graphql
+type UIAPI {
+  query: RecordQuery!           # For querying records
+  aggregate: RecordQueryAggregate!  # For aggregate queries
+  objectInfos: [ObjectInfo]     # For metadata
+  relatedListByName: RelatedListInfo
+}
+```
+
+### Mutation Entry Point
+```graphql
+type Mutation {
+  uiapi(input: UIAPIMutationsInput): UIAPIMutations!
+}
+```
+
+## How to Explore the Schema
+
+When you need to build a GraphQL query, use these search patterns:
+
+### 1. Find Available Fields for a Record Type
+Search for `type <ObjectName> implements Record` to find all queryable fields:
+```bash
+# Example: Find Account fields
+grep "^type Account implements Record" schema.graphql -A 50
+```
+
+### 2. Find Filter Options for a Record Type
+Search for `input <ObjectName>_Filter` to find filterable fields and operators:
+```bash
+# Example: Find Account filter options
+grep "^input Account_Filter" schema.graphql -A 30
+```
+
+### 3. Find OrderBy Options
+Search for `input <ObjectName>_OrderBy` for sorting options:
+```bash
+# Example: Find Account ordering options
+grep "^input Account_OrderBy" schema.graphql -A 20
+```
+
+### 4. Find Mutation Operations
+Search for operations in `UIAPIMutations`:
+```bash
+# Example: Find Account mutations
+grep "Account.*Create\|Account.*Update\|Account.*Delete" schema.graphql
+```
+
+### 5. Find Input Types for Mutations
+Search for `input <ObjectName>CreateInput` or `input <ObjectName>UpdateInput`:
+```bash
+# Example: Find Account create input
+grep "^input AccountCreateInput" schema.graphql -A 30
+```
+
+## Common Operator Types
+
+### StringOperators (for text fields)
+```graphql
+input StringOperators {
+  eq: String      # equals
+  ne: String      # not equals
+  like: String    # pattern matching (use % as wildcard)
+  lt: String      # less than
+  gt: String      # greater than
+  lte: String     # less than or equal
+  gte: String     # greater than or equal
+  in: [String]    # in list
+  nin: [String]   # not in list
+}
+```
+
+### OrderByClause
+```graphql
+input OrderByClause {
+  order: ResultOrder   # ASC or DESC
+  nulls: NullOrder     # FIRST or LAST
+}
+```
+
+## Query Pattern Examples
+
+### Basic Query Structure
+All record queries follow this pattern:
+```graphql
+query {
+  uiapi {
+    query {
+      <ObjectName>(
+        first: Int           # pagination limit
+        after: String        # pagination cursor
+        where: <Object>_Filter
+        orderBy: <Object>_OrderBy
+      ) {
+        edges {
+          node {
+            Id
+            <Field> { value }
+            # ... more fields
+          }
+        }
+      }
+    }
+  }
+}
+```
+
+### Example: Query Accounts with Filter
+```graphql
+query GetHighRevenueAccounts($minRevenue: Currency) {
+  uiapi {
+    query {
+      Account(
+        where: { AnnualRevenue: { gt: $minRevenue } }
+        orderBy: { AnnualRevenue: { order: DESC } }
+        first: 50
+      ) {
+        edges {
+          node {
+            Id
+            Name { value }
+            AnnualRevenue { value }
+            Industry { value }
+          }
+        }
+      }
+    }
+  }
+}
+```
+
+### Mutation Pattern
+```graphql
+mutation CreateAccount($input: AccountCreateInput!) {
+  uiapi(input: { AccountCreate: { input: $input } }) {
+    AccountCreate {
+      Record {
+        Id
+        Name { value }
+      }
+    }
+  }
+}
+```
+
+## Field Value Wrappers
+
+Salesforce GraphQL returns field values wrapped in typed objects:
+
+| Wrapper Type | Access Pattern |
+|-------------|----------------|
+| `StringValue` | `FieldName { value }` |
+| `IntValue` | `FieldName { value }` |
+| `BooleanValue` | `FieldName { value }` |
+| `DateTimeValue` | `FieldName { value displayValue }` |
+| `PicklistValue` | `FieldName { value displayValue }` |
+| `CurrencyValue` | `FieldName { value displayValue }` |
+
+## Agent Workflow for Building Queries
+
+**Pre-requisites (MANDATORY):**
+- [ ] Verified `schema.graphql` exists in project root
+- [ ] If missing, ran `npm run graphql:get-schema` and waited for completion
+- [ ] Confirmed connection to correct Salesforce org (if downloading fresh schema)
+
+**Workflow Steps:**
+
+1. **Identify the target object** (e.g., Account, Contact, Opportunity)
+2. **Search the schema** for the object type to discover available fields
+3. **Search for filter input** (`<Object>_Filter`) to understand filtering options
+4. **Search for orderBy input** (`<Object>_OrderBy`) for sorting capabilities
+5. **Build the query** following the patterns above
+6. **Validate field names** match exactly as defined in the schema (case-sensitive)
+
+## Tips for Agents
+
+- **Always verify field names** by searching the schema before generating queries
+- **Use grep/search** to explore the schema efficiently—never read the entire file
+- **Check relationships** by looking for `parentRelationship` and `childRelationship` comments in type definitions
+- **Look for Connection types** (e.g., `AccountConnection`) to understand pagination structure
+- **Custom objects** end with `__c` (e.g., `CustomObject__c`)
+- **Custom fields** also end with `__c` (e.g., `Custom_Field__c`)
+
+## Related Documentation
+
+- For generating mutations and queries, see `lds-generate-graphql-mutationquery.md`
+- For GraphQL best practices, see `lds-guide-graphql.md`