@salesforce/webapp-template-feature-react-nav-menu-experimental 1.3.4

package/dist/.a4drules/typescript.md

@@ -0,0 +1,224 @@
+# AI Rule: TypeScript Standards
+
+Enforces strict TypeScript standards for type-safe React applications.
+
+## Targets
+- `**/*.ts`
+- `**/*.tsx`
+
+## MANDATORY Configuration
+- `strict: true` - Enable all strict type checking
+- `noUncheckedIndexedAccess: true` - Prevent unsafe array/object access
+- `noUnusedLocals: true` - Report unused variables
+- `noUnusedParameters: true` - Report unused parameters
+
+## Function Return Types (REQUIRED)
+```typescript
+// Always specify return types
+function fetchUserData(id: string): Promise<User> {
+  return api.get(`/users/${id}`);
+}
+
+const calculateTotal = (items: Item[]): number => {
+  return items.reduce((sum, item) => sum + item.price, 0);
+};
+```
+
+## Interface Definitions (REQUIRED)
+```typescript
+// Data structures
+interface User {
+  id: string;
+  name: string;
+  email: string;
+  createdAt: Date;
+}
+
+// React component props
+interface ButtonProps {
+  variant: 'primary' | 'secondary';
+  onClick: () => void;
+  disabled?: boolean;
+  children: React.ReactNode;
+}
+
+export const Button: React.FC<ButtonProps> = ({ variant, onClick, disabled, children }) => {
+  // Implementation
+};
+```
+
+## Type Safety Rules
+
+### Never Use `any`
+```typescript
+// FORBIDDEN
+const data: any = await fetchData();
+
+// REQUIRED: Proper typing
+interface ApiResponse {
+  data: User[];
+  status: 'success' | 'error';
+}
+const response: ApiResponse = await fetchData();
+
+// ACCEPTABLE: Unknown when type is truly unknown
+const parseJson = (input: string): unknown => JSON.parse(input);
+```
+
+### Null Safety
+```typescript
+// Handle null/undefined explicitly
+interface UserProfile {
+  user: User | null;
+  loading: boolean;
+  error: string | null;
+}
+
+// Use optional chaining and nullish coalescing
+const displayName = user?.name ?? 'Anonymous';
+const avatarUrl = user?.profile?.avatar ?? '/default-avatar.png';
+```
+
+## React TypeScript Patterns
+
+### Event Handlers
+```typescript
+const handleSubmit = (event: React.FormEvent<HTMLFormElement>): void => {
+  event.preventDefault();
+};
+
+const handleInputChange = (event: React.ChangeEvent<HTMLInputElement>): void => {
+  setInputValue(event.target.value);
+};
+
+const handleClick = (event: React.MouseEvent<HTMLButtonElement>): void => {
+  console.log('Button clicked');
+};
+```
+
+### State and Hooks
+```typescript
+// Type useState properly
+const [user, setUser] = useState<User | null>(null);
+const [loading, setLoading] = useState<boolean>(false);
+const [errors, setErrors] = useState<string[]>([]);
+
+// Type custom hooks
+interface UseApiResult<T> {
+  data: T | null;
+  loading: boolean;
+  error: string | null;
+  refetch: () => Promise<void>;
+}
+
+function useApi<T>(url: string): UseApiResult<T> {
+  const [data, setData] = useState<T | null>(null);
+  const [loading, setLoading] = useState<boolean>(false);
+  const [error, setError] = useState<string | null>(null);
+
+  return { data, loading, error, refetch };
+}
+```
+
+## API Types
+
+### Salesforce Records
+```typescript
+interface SalesforceRecord {
+  Id: string;
+  attributes: { type: string; url: string };
+}
+
+interface Account extends SalesforceRecord {
+  Name: { value: string };
+  Industry?: { value: string | null };
+}
+
+// Type API functions
+async function fetchAccount(id: string): Promise<Account> {
+  const response = await axios.get<Account>(`/services/data/v62.0/ui-api/records/${id}`);
+  return response.data;
+}
+```
+
+### GraphQL
+```typescript
+interface GraphQLResponse<T> {
+  data: T;
+  errors?: Array<{ message: string; locations?: Array<{ line: number; column: number }> }>;
+}
+
+async function executeGraphQL<T>(query: string, variables?: Record<string, unknown>): Promise<T> {
+  const response = await axios.post<GraphQLResponse<T>>('/services/data/v62.0/graphql', {
+    query,
+    variables,
+  });
+
+  if (response.data.errors?.length) {
+    throw new Error(response.data.errors.map(e => e.message).join('; '));
+  }
+
+  return response.data.data;
+}
+```
+
+## Error Handling Types
+```typescript
+interface ApiError {
+  message: string;
+  status: number;
+  code?: string;
+}
+
+class CustomError extends Error {
+  constructor(message: string, public readonly status: number, public readonly code?: string) {
+    super(message);
+    this.name = 'CustomError';
+  }
+}
+```
+
+## Anti-Patterns (FORBIDDEN)
+
+### Type Assertions
+```typescript
+// FORBIDDEN: Unsafe assertions
+const user = data as User;
+
+// REQUIRED: Type guards
+function isUser(obj: unknown): obj is User {
+  return typeof obj === 'object' && obj !== null && typeof (obj as User).id === 'string';
+}
+
+if (isUser(data)) {
+  console.log(data.name); // Now safely typed
+}
+```
+
+### Missing Return Types
+```typescript
+// FORBIDDEN: No return type
+const fetchData = async (id: string) => {
+  return await api.get(`/data/${id}`);
+};
+
+// REQUIRED: Explicit return type
+const fetchData = async (id: string): Promise<ApiResponse> => {
+  return await api.get(`/data/${id}`);
+};
+```
+
+## Quality Checklist
+Before completing TypeScript code:
+1. All functions have explicit return types
+2. All interfaces are properly defined
+3. No `any` types used (use `unknown` if necessary)
+4. Null/undefined handling is explicit
+5. React components are properly typed
+6. API calls have proper type definitions
+7. `tsc -b` compiles without errors
+
+## Enforcement
+- TypeScript errors MUST be fixed before any commit
+- NEVER disable TypeScript strict mode
+- Code reviews MUST check for proper typing

package/dist/.forceignore

@@ -0,0 +1,15 @@
+# List files or directories below to ignore them when running force:source:push, force:source:pull, and force:source:status
+# More information: https://developer.salesforce.com/docs/atlas.en-us.sfdx_dev.meta/sfdx_dev/sfdx_dev_exclude_source.htm
+#
+
+package.xml
+
+# LWC configuration files
+**/jsconfig.json
+**/.eslintrc.json
+
+# LWC Jest
+**/__tests__/**
+
+node_modules/
+.DS_Store

package/dist/.husky/pre-commit

@@ -0,0 +1,4 @@
+#!/bin/sh
+. "$(dirname "$0")/_/husky.sh"
+
+npm run precommit

package/dist/.prettierignore

@@ -0,0 +1,11 @@
+# List files or directories below to ignore them when running prettier
+# More information: https://prettier.io/docs/en/ignore.html
+#
+
+**/staticresources/**
+.localdevserver
+.sfdx
+.sf
+.vscode
+
+coverage/

package/dist/.prettierrc

@@ -0,0 +1,17 @@
+{
+  "trailingComma": "none",
+  "plugins": [
+    "prettier-plugin-apex",
+    "@prettier/plugin-xml"
+  ],
+  "overrides": [
+    {
+      "files": "**/lwc/**/*.html",
+      "options": { "parser": "lwc" }
+    },
+    {
+      "files": "*.{cmp,page,component}",
+      "options": { "parser": "html" }
+    }
+  ]
+}

package/dist/CHANGELOG.md

@@ -0,0 +1,19 @@
+# Change Log
+
+All notable changes to this project will be documented in this file.
+See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
+
+## [1.3.4](https://github.com/salesforce-experience-platform-emu/webapps/compare/v1.3.3...v1.3.4) (2026-01-31)
+
+**Note:** Version bump only for package @salesforce/webapp-template-base-sfdx-project-experimental
+
+
+
+
+
+## [1.3.3](https://github.com/salesforce-experience-platform-emu/webapps/compare/v1.3.2...v1.3.3) (2026-01-30)
+
+
+### Bug Fixes
+
+* enabling npm publish for template packages ([#47](https://github.com/salesforce-experience-platform-emu/webapps/issues/47)) ([a8274f6](https://github.com/salesforce-experience-platform-emu/webapps/commit/a8274f606a2636c1fbdeade58f88a6797a12981e))

package/dist/README.md

@@ -0,0 +1,18 @@
+# Salesforce DX Project: Next Steps
+
+Now that you’ve created a Salesforce DX project, what’s next? Here are some documentation resources to get you started.
+
+## How Do You Plan to Deploy Your Changes?
+
+Do you want to deploy a set of changes, or create a self-contained application? Choose a [development model](https://developer.salesforce.com/tools/vscode/en/user-guide/development-models).
+
+## Configure Your Salesforce DX Project
+
+The `sfdx-project.json` file contains useful configuration information for your project. See [Salesforce DX Project Configuration](https://developer.salesforce.com/docs/atlas.en-us.sfdx_dev.meta/sfdx_dev/sfdx_dev_ws_config.htm) in the _Salesforce DX Developer Guide_ for details about this file.
+
+## Read All About It
+
+- [Salesforce Extensions Documentation](https://developer.salesforce.com/tools/vscode/)
+- [Salesforce CLI Setup Guide](https://developer.salesforce.com/docs/atlas.en-us.sfdx_setup.meta/sfdx_setup/sfdx_setup_intro.htm)
+- [Salesforce DX Developer Guide](https://developer.salesforce.com/docs/atlas.en-us.sfdx_dev.meta/sfdx_dev/sfdx_dev_intro.htm)
+- [Salesforce CLI Command Reference](https://developer.salesforce.com/docs/atlas.en-us.sfdx_cli_reference.meta/sfdx_cli_reference/cli_reference.htm)

package/dist/config/project-scratch-def.json

@@ -0,0 +1,13 @@
+{
+  "orgName": "My Saleforce Org",
+  "edition": "Developer",
+  "features": ["EnableSetPasswordInApi"],
+  "settings": {
+    "lightningExperienceSettings": {
+      "enableS1DesktopEnabled": true
+    },
+    "mobileSettings": {
+      "enableS1EncryptedStoragePref2": false
+    }
+  }
+}

package/dist/force-app/main/default/webapplications/feature-react-nav-menu/.prettierignore

@@ -0,0 +1,9 @@
+node_modules
+dist
+build
+.vite
+coverage
+*.min.js
+*.min.css
+*.map
+package-lock.json

package/dist/force-app/main/default/webapplications/feature-react-nav-menu/.prettierrc

@@ -0,0 +1,11 @@
+{
+  "semi": true,
+  "trailingComma": "es5",
+  "singleQuote": true,
+  "printWidth": 80,
+  "tabWidth": 2,
+  "useTabs": false,
+  "bracketSpacing": true,
+  "arrowParens": "avoid",
+  "endOfLine": "lf"
+}

package/dist/force-app/main/default/webapplications/feature-react-nav-menu/eslint.config.js

@@ -0,0 +1,113 @@
+import js from '@eslint/js';
+import tseslint from '@typescript-eslint/eslint-plugin';
+import tsparser from '@typescript-eslint/parser';
+import react from 'eslint-plugin-react';
+import reactHooks from 'eslint-plugin-react-hooks';
+import reactRefresh from 'eslint-plugin-react-refresh';
+import globals from 'globals';
+
+export default [
+  // Global ignores
+  {
+    ignores: ['build/**/*', 'dist/**/*', 'coverage/**/*'],
+  },
+  // Config files and build tools (first to avoid inheritance)
+  {
+    files: ['*.config.{js,ts}', 'vite.config.ts'],
+    languageOptions: {
+      parser: tsparser,
+      parserOptions: {
+        ecmaVersion: 'latest',
+        sourceType: 'module',
+      },
+      globals: {
+        ...globals.node,
+        __dirname: 'readonly',
+        process: 'readonly',
+      },
+    },
+    plugins: {
+      '@typescript-eslint': tseslint,
+    },
+    rules: {
+      '@typescript-eslint/no-var-requires': 'off',
+    },
+  },
+  // Main TypeScript/React files
+  {
+    files: ['**/*.{ts,tsx}'],
+    ignores: [
+      'coverage',
+      'dist',
+      'node_modules',
+      'build',
+      '*.config.{js,ts}',
+      'vite.config.ts',
+    ],
+    languageOptions: {
+      ecmaVersion: 2020,
+      sourceType: 'module',
+      parser: tsparser,
+      parserOptions: {
+        ecmaFeatures: {
+          jsx: true,
+        },
+        ecmaVersion: 'latest',
+        sourceType: 'module',
+        project: './tsconfig.json',
+      },
+      globals: {
+        ...globals.browser,
+        JSX: 'readonly',
+      },
+    },
+    plugins: {
+      react,
+      'react-hooks': reactHooks,
+      'react-refresh': reactRefresh,
+      '@typescript-eslint': tseslint,
+    },
+    rules: {
+      ...js.configs.recommended.rules,
+      ...tseslint.configs.recommended.rules,
+      ...react.configs.recommended.rules,
+      ...reactHooks.configs.recommended.rules,
+      'react/react-in-jsx-scope': 'off',
+      'react/prop-types': 'off',
+      'react/jsx-no-comment-textnodes': 'off',
+      'react/no-unescaped-entities': 'off',
+      '@typescript-eslint/no-unused-vars': [
+        'error',
+        { argsIgnorePattern: '^_' },
+      ],
+      '@typescript-eslint/explicit-function-return-type': 'off',
+      '@typescript-eslint/explicit-module-boundary-types': 'off',
+      '@typescript-eslint/no-explicit-any': 'off',
+    },
+    settings: {
+      react: {
+        version: 'detect',
+      },
+    },
+  },
+  // Test files
+  {
+    files: [
+      '**/*.test.{ts,tsx}',
+      '**/test/**/*.{ts,tsx}',
+      'src/test/**/*.{ts,tsx}',
+    ],
+    languageOptions: {
+      parser: tsparser,
+      globals: {
+        ...globals.browser,
+        ...globals.node,
+        global: 'writable',
+        JSX: 'readonly',
+      },
+    },
+    rules: {
+      '@typescript-eslint/no-explicit-any': 'off',
+    },
+  },
+];

package/dist/force-app/main/default/webapplications/feature-react-nav-menu/feature-react-nav-menu.webapplication-meta.xml

@@ -0,0 +1,7 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<WebApplication xmlns="http://soap.sforce.com/2006/04/metadata">
+    <masterLabel>feature-react-nav-menu</masterLabel>
+    <description>A Salesforce web application.</description>
+    <isActive>true</isActive>
+    <version>1</version>
+</WebApplication>

package/dist/force-app/main/default/webapplications/feature-react-nav-menu/index.html

@@ -0,0 +1,13 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <link rel="icon" type="image/svg+xml" href="/vite.svg" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>Welcome to React App</title>
+  </head>
+  <body>
+    <div id="root"></div>
+    <script type="module" src="/src/app.tsx"></script>
+  </body>
+</html>

package/dist/force-app/main/default/webapplications/feature-react-nav-menu/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "base-react-app",
+  "private": true,
+  "version": "1.0.0",
+  "type": "module",
+  "scripts": {
+    "dev": "vite",
+    "build": "tsc -b && vite build",
+    "lint": "eslint .",
+    "preview": "vite preview",
+    "test": "vitest"
+  },
+  "dependencies": {
+    "@salesforce/webapp-experimental": "*",
+    "@tailwindcss/vite": "^4.1.17",
+    "react": "^19.2.0",
+    "react-dom": "^19.2.0",
+    "react-router": "^7.10.1",
+    "tailwindcss": "^4.1.17"
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.39.1",
+    "@salesforce/vite-plugin-webapp-experimental": "*",
+    "@testing-library/jest-dom": "^6.6.3",
+    "@testing-library/react": "^16.1.0",
+    "@testing-library/user-event": "^14.5.2",
+    "@types/node": "^24.10.1",
+    "@types/react": "^19.2.5",
+    "@types/react-dom": "^19.2.3",
+    "@vitejs/plugin-react": "^5.1.1",
+    "@vitest/ui": "^4.0.17",
+    "eslint": "^9.39.1",
+    "eslint-plugin-react-hooks": "^7.0.1",
+    "eslint-plugin-react-refresh": "^0.4.24",
+    "globals": "^16.5.0",
+    "jsdom": "^25.0.1",
+    "typescript": "~5.9.3",
+    "typescript-eslint": "^8.46.4",
+    "vite": "^7.2.4",
+    "vitest": "^4.0.17"
+  }
+}

package/dist/force-app/main/default/webapplications/feature-react-nav-menu/src/api/graphql-operations-types.ts

@@ -0,0 +1,127 @@
+export type Maybe<T> = T | null;
+export type InputMaybe<T> = Maybe<T>;
+export type Exact<T extends { [key: string]: unknown }> = {
+  [K in keyof T]: T[K];
+};
+export type MakeOptional<T, K extends keyof T> = Omit<T, K> & {
+  [SubKey in K]?: Maybe<T[SubKey]>;
+};
+export type MakeMaybe<T, K extends keyof T> = Omit<T, K> & {
+  [SubKey in K]: Maybe<T[SubKey]>;
+};
+export type MakeEmpty<
+  T extends { [key: string]: unknown },
+  K extends keyof T,
+> = { [_ in K]?: never };
+export type Incremental<T> =
+  | T
+  | {
+      [P in keyof T]?: P extends ' $fragmentName' | '__typename' ? T[P] : never;
+    };
+/** All built-in and custom scalars, mapped to their actual values */
+export type Scalars = {
+  ID: { input: string; output: string };
+  String: { input: string; output: string };
+  Boolean: { input: boolean; output: boolean };
+  Int: { input: number; output: number };
+  Float: { input: number; output: number };
+  Base64: { input: any; output: any };
+  /** An arbitrary precision signed decimal */
+  BigDecimal: { input: any; output: any };
+  /** An arbitrary precision signed integer */
+  BigInteger: { input: any; output: any };
+  /** An 8-bit signed integer */
+  Byte: { input: any; output: any };
+  /** A UTF-16 code unit; a character on Unicode's BMP */
+  Char: { input: any; output: any };
+  Currency: { input: any; output: any };
+  Date: { input: any; output: any };
+  DateTime: { input: any; output: any };
+  Double: { input: any; output: any };
+  Email: { input: any; output: any };
+  EncryptedString: { input: any; output: any };
+  /** Can be set to an ID or a Reference to the result of another mutation operation. */
+  IdOrRef: { input: any; output: any };
+  JSON: { input: any; output: any };
+  Latitude: { input: any; output: any };
+  /** A 64-bit signed integer */
+  Long: { input: any; output: any };
+  LongTextArea: { input: any; output: any };
+  Longitude: { input: any; output: any };
+  MultiPicklist: { input: any; output: any };
+  Percent: { input: any; output: any };
+  PhoneNumber: { input: any; output: any };
+  Picklist: { input: any; output: any };
+  RichTextArea: { input: any; output: any };
+  /** A 16-bit signed integer */
+  Short: { input: any; output: any };
+  TextArea: { input: any; output: any };
+  Time: { input: any; output: any };
+  Url: { input: any; output: any };
+};
+
+export enum DataType {
+  Address = 'ADDRESS',
+  Anytype = 'ANYTYPE',
+  Base64 = 'BASE64',
+  Boolean = 'BOOLEAN',
+  Combobox = 'COMBOBOX',
+  Complexvalue = 'COMPLEXVALUE',
+  Currency = 'CURRENCY',
+  Date = 'DATE',
+  Datetime = 'DATETIME',
+  Double = 'DOUBLE',
+  Email = 'EMAIL',
+  Encryptedstring = 'ENCRYPTEDSTRING',
+  Int = 'INT',
+  Json = 'JSON',
+  Junctionidlist = 'JUNCTIONIDLIST',
+  Location = 'LOCATION',
+  Long = 'LONG',
+  Multipicklist = 'MULTIPICKLIST',
+  Percent = 'PERCENT',
+  Phone = 'PHONE',
+  Picklist = 'PICKLIST',
+  Reference = 'REFERENCE',
+  String = 'STRING',
+  Textarea = 'TEXTAREA',
+  Time = 'TIME',
+  Url = 'URL',
+}
+
+export enum FieldExtraTypeInfo {
+  ExternalLookup = 'EXTERNAL_LOOKUP',
+  ImageUrl = 'IMAGE_URL',
+  IndirectLookup = 'INDIRECT_LOOKUP',
+  Personname = 'PERSONNAME',
+  Plaintextarea = 'PLAINTEXTAREA',
+  Richtextarea = 'RICHTEXTAREA',
+  SwitchablePersonname = 'SWITCHABLE_PERSONNAME',
+}
+
+export enum ResultOrder {
+  Asc = 'ASC',
+  Desc = 'DESC',
+}
+
+export type GetHighRevenueAccountsQueryVariables = Exact<{
+  minRevenue?: InputMaybe<Scalars['Currency']['input']>;
+}>;
+
+export type GetHighRevenueAccountsQuery = {
+  uiapi: {
+    query: {
+      Account?: {
+        edges?: Array<{
+          node?: {
+            Id: string;
+            Name?: { value?: string | null } | null;
+            AnnualRevenue?: { value?: any | null } | null;
+            Industry?: { value?: any | null } | null;
+            Website?: { value?: any | null } | null;
+          } | null;
+        } | null> | null;
+      } | null;
+    };
+  };
+};

package/dist/force-app/main/default/webapplications/feature-react-nav-menu/src/api/utils/query/highRevenueAccountsQuery.graphql

@@ -0,0 +1,29 @@
+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
+            }
+            Website {
+              value
+            }
+          }
+        }
+      }
+    }
+  }
+}