@salesforce/ui-bundle-template-feature-angular-language-switcher 12.5.4

package/dist/README.md

@@ -0,0 +1,77 @@
+# 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.
+
+## Web app: install, build, and dev server
+
+From the **SFDX project root** (this directory), run:
+
+```bash
+npm run sf-project-setup
+```
+
+This installs dependencies in the UI Bundle, builds it, and starts the Vite dev server. Use this after cloning or extracting the project.
+
+## Set up the org
+
+`npm run setup` configures a target org from this project in one command: it logs in
+(a required precondition — auto-skipped if the org is already connected), deploys
+metadata, assigns permission sets, imports sample data, refreshes the GraphQL
+schema/types, and builds the UI Bundle. When `--target-org` is omitted it uses your
+default org or, in an interactive terminal, prompts you to pick one.
+
+```bash
+npm run setup -- --target-org <alias>     # or omit --target-org to use the default / pick
+```
+
+Setup does **not** start the dev server. Once the org is set up, use `dev:preview` to
+refresh the GraphQL types against the org and launch the Vite dev server on its own:
+
+```bash
+npm run dev:preview
+```
+
+### Setup configuration (`scripts/org-setup.config.json`)
+
+`org-setup.config.json` controls which steps run and how. Every top-level section is
+optional; an absent section hides its step. It is validated against a shared schema
+at build/CI time and again at the start of every `npm run setup`, so a malformed
+config fails fast rather than misbehaving.
+
+```jsonc
+{
+  "permsetAssignments": {
+    "assignments": {
+      "My_Access": { "assignee": "currentUser" }
+    }
+  },
+  "role": { "assignee": "currentUser", "roleName": "Admin" },
+  "selfRegistration": {
+    "selfRegProfile": "My Prospect Profile",
+    "accountName": "My Self-Registration"
+  }
+}
+```
+
+When a `selfRegistration` section is present, setup runs a **license pre-check**
+before configuring self-registration: it derives the required `UserLicense` from the
+configured `selfRegProfile` (matched on the stable `LicenseDefinitionKey`, not the
+display name) and, if the org lacks that license or has no available seats, **warns
+and skips** self-registration instead of reporting success — so prospect login can't
+silently fail on an under-provisioned org. No separate license field is configured;
+the requirement always follows the profile the flow assigns.
+
+## 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/eslint.config.js

@@ -0,0 +1,7 @@
+/**
+ * ESLint 9 flat config for LWC and Aura.
+ * @see https://github.com/salesforce/eslint-config-lwc
+ */
+const lwcConfig = require("@salesforce/eslint-config-lwc");
+
+module.exports = [...lwcConfig.configs.recommended];

package/dist/force-app/main/default/uiBundles/feature-angular-language-switcher/.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/force-app/main/default/uiBundles/feature-angular-language-switcher/.graphqlrc.yml

@@ -0,0 +1,2 @@
+schema: '../../../../../schema.graphql'
+documents: 'src/**/*.{graphql,ts}'

package/dist/force-app/main/default/uiBundles/feature-angular-language-switcher/.postcssrc.json

@@ -0,0 +1,5 @@
+{
+  "plugins": {
+    "@tailwindcss/postcss": {}
+  }
+}

package/dist/force-app/main/default/uiBundles/feature-angular-language-switcher/.prettierignore

@@ -0,0 +1,8 @@
+node_modules
+dist
+.angular
+coverage
+*.min.js
+*.min.css
+*.map
+package-lock.json

package/dist/force-app/main/default/uiBundles/feature-angular-language-switcher/.prettierrc

@@ -0,0 +1,12 @@
+{
+  "printWidth": 100,
+  "singleQuote": true,
+  "overrides": [
+    {
+      "files": "*.html",
+      "options": {
+        "parser": "angular"
+      }
+    }
+  ]
+}

package/dist/force-app/main/default/uiBundles/feature-angular-language-switcher/CHANGELOG.md

@@ -0,0 +1,4 @@
+# Change Log
+
+All notable changes to this project will be documented in this file.
+See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.

package/dist/force-app/main/default/uiBundles/feature-angular-language-switcher/README.md

@@ -0,0 +1,85 @@
+# Base Angular App
+
+Base Angular App is a template application that demonstrates how to build an Angular UI Bundle on the Salesforce platform with the Angular CLI, TypeScript, Tailwind, Spartan NG (shadcn/ui for Angular), and the Salesforce UI Bundle SDK. It provides a minimal shell (home, 404), routing with standalone components and signals, so feature apps can extend it via the patches pipeline.
+
+This UI Bundle lives inside an SFDX project. The project root is the directory that contains `force-app/` and `sfdx-project.json`. Run the commands in the sections below from the paths indicated.
+
+## Table of contents
+
+- [Run (development)](#run-development)
+- [Build](#build)
+- [Deploy](#deploy)
+- [Test](#test)
+- [Lint](#lint)
+
+## Run (development)
+
+From the UI Bundle directory (`force-app/main/default/uiBundles/base-angular-app`):
+
+```bash
+npm install
+npm run dev
+```
+
+This starts the Salesforce Angular dev server (`sf-angular-serve`).
+
+## Build
+
+From the UI Bundle directory:
+
+```bash
+npm install
+npm run build
+```
+
+The production build is written to `dist/` inside the UI Bundle folder. Use `npm run watch` to rebuild on change in development mode. Deploy using the steps in [Deploy](#deploy).
+
+## Deploy
+
+From the **SFDX project root** (the directory that contains `force-app/`):
+
+1. Build the UI Bundle:
+
+   ```bash
+   cd force-app/main/default/uiBundles/base-angular-app && npm install && npm run build && cd -
+   ```
+
+2. Deploy the UI Bundle only:
+
+   ```bash
+   sf project deploy start --source-dir force-app/main/default/ui-bundles --target-org <alias>
+   ```
+
+   Or deploy all metadata:
+
+   ```bash
+   sf project deploy start --source-dir force-app --target-org <alias>
+   ```
+
+   Replace `<alias>` with your target org alias.
+
+## Test
+
+From the UI Bundle directory:
+
+```bash
+npm install
+npm run test
+```
+
+This runs the unit test suite via `ng test`. For end-to-end tests:
+
+```bash
+npm run build:e2e
+npm run e2e
+```
+
+This builds with E2E asset rewrites and runs Playwright against the static build. Ensure Chromium is installed (`npx playwright install chromium` if needed).
+
+## Lint
+
+From the UI Bundle directory:
+
+```bash
+npm run lint
+```

package/dist/force-app/main/default/uiBundles/feature-angular-language-switcher/angular.json

@@ -0,0 +1,98 @@
+{
+  "$schema": "./node_modules/@angular/cli/lib/config/schema.json",
+  "version": 1,
+  "cli": {
+    "packageManager": "npm",
+    "analytics": false,
+    "cache": {
+      "enabled": false
+    }
+  },
+  "newProjectRoot": "projects",
+  "projects": {
+    "feature-angular-language-switcher": {
+      "projectType": "application",
+      "schematics": {
+        "@schematics/angular:component": {
+          "style": "css"
+        }
+      },
+      "root": "",
+      "sourceRoot": "src",
+      "prefix": "app",
+      "architect": {
+        "build": {
+          "builder": "@angular-builders/custom-esbuild:application",
+          "options": {
+            "outputPath": {
+              "base": "dist",
+              "browser": ""
+            },
+            "deployUrl": "./",
+            "browser": "src/main.ts",
+            "tsConfig": "tsconfig.app.json",
+            "assets": [
+              {
+                "glob": "**/*",
+                "input": "public"
+              }
+            ],
+            "styles": ["src/styles.css"],
+            "plugins": []
+          },
+          "configurations": {
+            "production": {
+              "plugins": ["./esbuild/api-version.mjs"],
+              "budgets": [
+                {
+                  "type": "anyComponentStyle",
+                  "maximumWarning": "4kB",
+                  "maximumError": "8kB"
+                }
+              ],
+              "outputHashing": "all",
+              "optimization": {
+                "scripts": true,
+                "styles": {
+                  "minify": true,
+                  "inlineCritical": false
+                }
+              }
+            },
+            "development": {
+              "plugins": ["./esbuild/graphql-codegen.mjs"],
+              "optimization": false,
+              "extractLicenses": false,
+              "sourceMap": true
+            }
+          },
+          "defaultConfiguration": "production"
+        },
+        "serve": {
+          "builder": "@angular-builders/custom-esbuild:dev-server",
+          "options": {
+            "middlewares": ["./middleware/html.mjs", "./middleware/proxy.mjs"]
+          },
+          "configurations": {
+            "production": {
+              "buildTarget": "feature-angular-language-switcher:build:production"
+            },
+            "development": {
+              "buildTarget": "feature-angular-language-switcher:build:development"
+            }
+          },
+          "defaultConfiguration": "development"
+        },
+        "test": {
+          "builder": "@angular/build:unit-test"
+        },
+        "lint": {
+          "builder": "@angular-eslint/builder:lint",
+          "options": {
+            "lintFilePatterns": ["src/**/*.ts", "src/**/*.html", "src/**/*.graphql"]
+          }
+        }
+      }
+    }
+  }
+}

package/dist/force-app/main/default/uiBundles/feature-angular-language-switcher/codegen.yml

@@ -0,0 +1,95 @@
+schema: '../../../../../schema.graphql'
+documents: 'src/**/*.{graphql,ts}'
+generates:
+  src/app/api/graphql-operations-types.ts:
+    plugins:
+      - 'graphql-codegen-typescript-operation-types'
+      - 'typescript-operations'
+    config:
+      onlyOperationTypes: true
+      skipTypename: true
+      preResolveTypes: true
+      scalars:
+        # String-serialized scalars
+        JSON:
+          input: 'string'
+          output: 'string'
+        Date:
+          input: 'string'
+          output: 'string'
+        DateTime:
+          input: 'string'
+          output: 'string'
+        Time:
+          input: 'string'
+          output: 'string'
+        Email:
+          input: 'string'
+          output: 'string'
+        Url:
+          input: 'string'
+          output: 'string'
+        PhoneNumber:
+          input: 'string'
+          output: 'string'
+        Picklist:
+          input: 'string'
+          output: 'string'
+        MultiPicklist:
+          input: 'string'
+          output: 'string'
+        TextArea:
+          input: 'string'
+          output: 'string'
+        LongTextArea:
+          input: 'string'
+          output: 'string'
+        RichTextArea:
+          input: 'string'
+          output: 'string'
+        EncryptedString:
+          input: 'string'
+          output: 'string'
+        Base64:
+          input: 'string'
+          output: 'string'
+        IdOrRef:
+          input: 'string'
+          output: 'string'
+        # BigDecimal-serialized scalars (accepts number or string, returns number)
+        Currency:
+          input: 'number | string'
+          output: 'number'
+        BigDecimal:
+          input: 'number | string'
+          output: 'number'
+        Double:
+          input: 'number | string'
+          output: 'number'
+        Percent:
+          input: 'number | string'
+          output: 'number'
+        Longitude:
+          input: 'number | string'
+          output: 'number'
+        Latitude:
+          input: 'number | string'
+          output: 'number'
+        # Integer-like scalars
+        Long:
+          input: 'number'
+          output: 'number'
+        BigInteger:
+          input: 'number'
+          output: 'number'
+        Short:
+          input: 'number'
+          output: 'number'
+        Byte:
+          input: 'number'
+          output: 'number'
+        Char:
+          input: 'number'
+          output: 'number'
+overwrite: true
+ignoreNoDocuments: true

package/dist/force-app/main/default/uiBundles/feature-angular-language-switcher/components.json

@@ -0,0 +1,6 @@
+{
+  "$schema": "node_modules/@spartan-ng/cli/src/generators/ui/schema.json",
+  "componentsPath": "src/app/shared",
+  "importAlias": "@spartan-ng/styles",
+  "style": "nova"
+}

package/dist/force-app/main/default/uiBundles/feature-angular-language-switcher/e2e/app.spec.ts

@@ -0,0 +1,15 @@
+import { test, expect } from '@playwright/test';
+
+test.describe('base-angular-app', () => {
+	test('home page loads and shows welcome content', async ({ page }) => {
+		await page.goto('/');
+		await expect(page.getByRole('heading', { name: 'Home' })).toBeVisible();
+		await expect(page.getByText('Welcome to your Angular application.')).toBeVisible();
+	});
+
+	test('not found route shows 404', async ({ page }) => {
+		await page.goto('/non-existent-route');
+		await expect(page.getByRole('heading', { name: '404' })).toBeVisible();
+		await expect(page.getByText('Page not found')).toBeVisible();
+	});
+});

package/dist/force-app/main/default/uiBundles/feature-angular-language-switcher/esbuild/api-version.mjs

@@ -0,0 +1,17 @@
+/**
+ * Build-time substitution of `__SF_API_VERSION__` (production + main app code in dev).
+ *
+ * Resolves the connected org's API version (from `sf` CLI session) once at
+ * builder startup and injects it via esbuild's `define`. Falls back to "65.0"
+ * if no session is available — matches @salesforce/platform-sdk's default.
+ *
+ * In `ng serve`, this plugin runs on the application esbuild pass but does NOT
+ * reach Vite's optimizeDeps prebundle of node_modules. `scripts/dev.mjs` covers
+ * that gap by passing the same value via `ng serve --define`.
+ *
+ * Referenced from angular.json: architect.build.options.plugins[].
+ */
+import { createApiVersionPlugin } from '@salesforce/angular-plugin-ui-bundle';
+
+const { plugin } = await createApiVersionPlugin();
+export default plugin;

package/dist/force-app/main/default/uiBundles/feature-angular-language-switcher/esbuild/graphql-codegen.mjs

@@ -0,0 +1,13 @@
+/**
+ * GraphQL Codegen esbuild plugin — runs codegen on build start.
+ *
+ * Resolves GraphQL operations into typed TypeScript at build time using the
+ * project's `codegen.yml` configuration. Re-runs on every rebuild during
+ * `ng serve` so generated types stay in sync with schema/document changes.
+ *
+ * Referenced from angular.json: architect.build.options.plugins[].
+ */
+import { createGraphQLCodegenPlugin } from '@salesforce/angular-plugin-ui-bundle';
+
+const plugin = createGraphQLCodegenPlugin();
+export default plugin;

package/dist/force-app/main/default/uiBundles/feature-angular-language-switcher/eslint-plugin-angular-graphql.js

@@ -0,0 +1,148 @@
+/**
+ * eslint-plugin-angular-graphql.js
+ *
+ * Custom ESLint plugin with composite processor that enables BOTH:
+ * - Angular inline template linting (processInlineTemplates)
+ * - GraphQL tagged template literal linting (@graphql-eslint processor)
+ *
+ * ESLint only allows one processor per file type. This plugin calls both
+ * processors under the hood, returning the source code only once to avoid
+ * duplicate TypeScript lint messages.
+ *
+ * Usage:
+ *   import { createPlugin } from './eslint-plugin-angular-graphql.js';
+ *   const plugin = createPlugin({ schemaPath: '/absolute/path/to/schema.graphql' });
+ *
+ * Safety assumptions (verified against source):
+ * - Neither processor clones source messages in postprocess (object identity dedup works)
+ * - gql tags do not appear inside inline template strings (autofix ranges non-overlapping)
+ * - Both processors store internal state keyed by filePath (or derived from it)
+ */
+import { existsSync } from 'node:fs';
+import angular from 'angular-eslint';
+import graphqlPlugin from '@graphql-eslint/eslint-plugin';
+
+const angularProcessor = angular.processInlineTemplates;
+const graphqlProcessor = graphqlPlugin.processor;
+
+// Track block counts per file for postprocess message routing
+const blockCountsMap = new Map();
+
+const compositeProcessor = {
+	meta: {
+		name: 'angular-graphql/composite',
+		version: '1.0.0',
+	},
+	supportsAutofix: true,
+
+	preprocess(code, filePath) {
+		// Call both preprocessors — this populates their internal state maps
+		// Angular returns: [source, ...htmlBlocks] (source FIRST)
+		const angularResult = angularProcessor.preprocess(code, filePath);
+		// GraphQL returns: [...gqlBlocks, source] (source LAST)
+		const graphqlResult = graphqlProcessor.preprocess(code, filePath);
+
+		// Extract blocks (excluding source) from each
+		const htmlBlocks = angularResult.length > 1 ? angularResult.slice(1) : [];
+		const gqlBlocks = graphqlResult.length > 1 ? graphqlResult.slice(0, -1) : [];
+
+		// Store counts for postprocess routing
+		blockCountsMap.set(filePath, {
+			gqlCount: gqlBlocks.length,
+			htmlCount: htmlBlocks.length,
+		});
+
+		// Return unified: [gqlBlocks..., htmlBlocks..., source]
+		// Source appears exactly ONCE at the end
+		return [...gqlBlocks, ...htmlBlocks, code];
+	},
+
+	postprocess(messages, filePath) {
+		const { gqlCount, htmlCount } = blockCountsMap.get(filePath) || { gqlCount: 0, htmlCount: 0 };
+		blockCountsMap.delete(filePath);
+
+		const sourceIndex = gqlCount + htmlCount;
+		const sourceMessages = messages[sourceIndex] || [];
+
+		// Short-circuit: neither processor extracted blocks
+		if (gqlCount === 0 && htmlCount === 0) {
+			return sourceMessages;
+		}
+
+		// Short-circuit: only Angular had blocks
+		if (gqlCount === 0) {
+			const angularMessages = [sourceMessages, ...messages.slice(0, htmlCount)];
+			return angularProcessor.postprocess(angularMessages, filePath);
+		}
+
+		// Short-circuit: only GraphQL had blocks
+		if (htmlCount === 0) {
+			const gqlMessages = [...messages.slice(0, gqlCount), sourceMessages];
+			return graphqlProcessor.postprocess(gqlMessages, filePath);
+		}
+
+		// Both had blocks — route to each postprocess and merge
+		// GraphQL expects: [gqlBlock0Msgs, ..., gqlBlockNMsgs, sourceMessages]
+		const gqlInput = [...messages.slice(0, gqlCount), sourceMessages];
+		const gqlResult = graphqlProcessor.postprocess(gqlInput, filePath);
+
+		// Angular expects: [sourceMessages, htmlBlock0Msgs, ..., htmlBlockMMsgs]
+		const angularInput = [sourceMessages, ...messages.slice(gqlCount, gqlCount + htmlCount)];
+		const angularResult = angularProcessor.postprocess(angularInput, filePath);
+
+		// Deduplicate source messages (both postprocessors pass them through by reference)
+		const sourceSet = new Set(sourceMessages);
+		const gqlOnly = gqlResult.filter((m) => !sourceSet.has(m));
+
+		// angularResult = [...sourceMessages, ...adjustedHtmlMessages]
+		// gqlOnly = [...adjustedGqlMessages] (source messages filtered out)
+		return [...angularResult, ...gqlOnly].sort((a, b) => a.line - b.line || a.column - b.column);
+	},
+};
+
+/**
+ * Factory: pass schemaPath, get back a plugin with configs ready to spread.
+ * - If schema exists → composite processor (Angular + GraphQL) + GraphQL rules
+ * - If no schema → Angular-only inline template processor, no GraphQL rules
+ */
+export function createPlugin({ schemaPath } = {}) {
+	const schemaExists = !!(schemaPath && existsSync(schemaPath));
+
+	const configs = [
+		{
+			files: ['**/*.ts'],
+			processor: schemaExists ? compositeProcessor : angularProcessor,
+		},
+		...(schemaExists
+			? [
+					{
+						files: ['**/*.graphql'],
+						languageOptions: {
+							parser: graphqlPlugin.parser,
+							parserOptions: {
+								graphQLConfig: {
+									schema: schemaPath,
+									documents: 'src/**/*.ts',
+								},
+							},
+						},
+						plugins: {
+							'@graphql-eslint': graphqlPlugin,
+						},
+						rules: {
+							'@graphql-eslint/no-anonymous-operations': 'error',
+							'@graphql-eslint/no-duplicate-fields': 'error',
+							'@graphql-eslint/known-fragment-names': 'error',
+							'@graphql-eslint/no-undefined-variables': 'error',
+							'@graphql-eslint/no-unused-variables': 'error',
+						},
+					},
+				]
+			: []),
+	];
+
+	return {
+		meta: { name: 'eslint-plugin-angular-graphql', version: '1.0.0' },
+		configs,
+	};
+}