@salesforce/webapp-template-app-react-byo-experimental 1.3.3

package/LICENSE.txt

@@ -0,0 +1,82 @@
+Terms of Use
+
+Copyright 2026 Salesforce, Inc. All rights reserved.
+
+These Terms of Use govern the download, installation, and/or use of this
+software provided by Salesforce, Inc. ("Salesforce") (the "Software"), were
+last updated on April 15, 2025, and constitute a legally binding
+agreement between you and Salesforce. If you do not agree to these Terms of
+Use, do not install or use the Software.
+
+Salesforce grants you a worldwide, non-exclusive, no-charge, royalty-free
+copyright license to reproduce, prepare derivative works of, publicly
+display, publicly perform, sublicense, and distribute the Software and
+derivative works subject to these Terms. These Terms shall be included in
+all copies or substantial portions of the Software.
+
+Subject to the limited rights expressly granted hereunder, Salesforce
+reserves all rights, title, and interest in and to all intellectual
+property subsisting in the Software. No rights are granted to you hereunder
+other than as expressly set forth herein. Users residing in countries on
+the United States Office of Foreign Assets Control sanction list, or which
+are otherwise subject to a US export embargo, may not use the Software.
+
+Implementation of the Software may require development work, for which you
+are responsible. The Software may contain bugs, errors and
+incompatibilities and is made available on an AS IS basis without support,
+updates, or service level commitments.
+
+Salesforce reserves the right at any time to modify, suspend, or
+discontinue, the Software (or any part thereof) with or without notice. You
+agree that Salesforce shall not be liable to you or to any third party for
+any modification, suspension, or discontinuance.
+
+You agree to defend Salesforce against any claim, demand, suit or
+proceeding made or brought against Salesforce by a third party arising out
+of or accruing from (a) your use of the Software, and (b) any application
+you develop with the Software that infringes any copyright, trademark,
+trade secret, trade dress, patent, or other intellectual property right of
+any person or defames any person or violates their rights of publicity or
+privacy (each a "Claim Against Salesforce"), and will indemnify Salesforce
+from any damages, attorney fees, and costs finally awarded against
+Salesforce as a result of, or for any amounts paid by Salesforce under a
+settlement approved by you in writing of, a Claim Against Salesforce,
+provided Salesforce (x) promptly gives you written notice of the Claim
+Against Salesforce, (y) gives you sole control of the defense and
+settlement of the Claim Against Salesforce (except that you may not settle
+any Claim Against Salesforce unless it unconditionally releases Salesforce
+of all liability), and (z) gives you all reasonable assistance, at your
+expense.
+
+WITHOUT LIMITING THE GENERALITY OF THE FOREGOING, THE SOFTWARE IS NOT
+SUPPORTED AND IS PROVIDED "AS IS," WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED. IN NO EVENT SHALL SALESFORCE HAVE ANY LIABILITY FOR ANY DAMAGES,
+INCLUDING, BUT NOT LIMITED TO, DIRECT, INDIRECT, SPECIAL, INCIDENTAL,
+PUNITIVE, OR CONSEQUENTIAL DAMAGES, OR DAMAGES BASED ON LOST PROFITS, DATA,
+OR USE, IN CONNECTION WITH THE SOFTWARE, HOWEVER CAUSED AND WHETHER IN
+CONTRACT, TORT, OR UNDER ANY OTHER THEORY OF LIABILITY, WHETHER OR NOT YOU
+HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
+
+These Terms of Use shall be governed exclusively by the internal laws of
+the State of California, without regard to its conflicts of laws
+rules. Each party hereby consents to the exclusive jurisdiction of the
+state and federal courts located in San Francisco County, California to
+adjudicate any dispute arising out of or relating to these Terms of Use and
+the download, installation, and/or use of the Software. Except as expressly
+stated herein, these Terms of Use constitute the entire agreement between
+the parties, and supersede all prior and contemporaneous agreements,
+proposals, or representations, written or oral, concerning their subject
+matter. No modification, amendment, or waiver of any provision of these
+Terms of Use shall be effective unless it is by an update to these Terms of
+Use that Salesforce makes available, or is in writing and signed by the
+party against whom the modification, amendment, or waiver is to be
+asserted.
+
+Data Privacy: Salesforce may collect, process, and store device,
+system, and other information related to your use of the Software. This
+information includes, but is not limited to, IP address, user metrics, and
+other data ("Usage Data"). Salesforce may use Usage Data for analytics,
+product development, and marketing purposes. You acknowledge that files
+generated in conjunction with the Software may contain sensitive or
+confidential data, and you are solely responsible for anonymizing and
+protecting such data.

package/dist/.a4drules/build-validation.md

@@ -0,0 +1,81 @@
+# 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:**
+```bash
+npm run build  # MUST succeed with no errors
+```
+
+## Quick Quality Checks
+```bash
+npm run format:check  # Auto-fixable
+npm run lint          # Most issues auto-fixable
+tsc -b               # Catches major issues
+```
+
+## Requirements
+
+**Must Pass:**
+- `npm run build` completes successfully
+- No TypeScript compilation errors
+- No critical ESLint errors
+
+**Can Be Warnings:**
+- ESLint warnings
+- Prettier formatting issues
+- Minor TypeScript warnings
+
+## Auto-Fix Commands
+```bash
+npm run fix-all      # Fix formatting + linting
+npm run format       # Fix Prettier issues
+npm run lint:fix     # Fix ESLint issues
+```
+
+## 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`
+2. If fails: Run `npm run fix-all`, fix TypeScript errors, retry build
+
+## Error Priority
+
+**Fix Immediately:**
+- TypeScript compilation errors
+- Import/export errors
+- Syntax errors
+
+**Fix When Convenient:**
+- ESLint warnings
+- Prettier formatting
+- Unused variables
+
+## Hard Requirements
+- Build must complete without errors
+- No broken imports
+- Basic TypeScript type safety
+
+## Key Commands
+```bash
+npm run dev          # Start development
+npm run build        # Check deployment readiness
+npm run fix-all      # Fix common issues
+```
+
+## Troubleshooting Import Errors
+```bash
+npm install          # Check missing dependencies
+# Verify file exists, case sensitivity, export/import match
+```

package/dist/.a4drules/code-quality.md

@@ -0,0 +1,150 @@
+# AI Rule: Code Quality Standards
+
+Enforces ESLint, Prettier, and coding best practices for consistent, maintainable code.
+
+## Targets
+- `force-app/main/default/webapplications/*/**/*`
+- `**/*.{js,ts,jsx,tsx,json,md}`
+
+## MANDATORY Checks
+
+**Before writing code:**
+```bash
+npm run lint         # MUST result in: 0 problems (0 errors, 0 warnings)
+npm run format:check # MUST result in: All matched files use Prettier code style!
+```
+
+## Prettier Config (.prettierrc)
+```json
+{
+  "semi": true,
+  "trailingComma": "es5",
+  "singleQuote": true,
+  "printWidth": 80,
+  "tabWidth": 2,
+  "useTabs": false,
+  "bracketSpacing": true,
+  "arrowParens": "avoid",
+  "endOfLine": "lf"
+}
+```
+
+## Auto-Fix Commands
+```bash
+npm run fix-all      # Fix formatting + linting (recommended)
+npm run format       # Fix Prettier issues
+npm run lint:fix     # Fix ESLint issues
+```
+
+## 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 check-all` - All checks must pass
+2. `npm run fix-all` - Auto-fix issues if needed
+3. `npm run build` - Build must succeed
+
+## Zero Tolerance Policy
+- ESLint errors: MUST be 0
+- ESLint warnings: MUST be 0
+- Prettier violations: MUST be 0
+- TypeScript errors: MUST be 0

package/dist/.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`