@salesforce/templates 66.11.1 → 66.12.0

package/lib/templates/project/angularextapp/_p_/_m_/_w_/_a_/src/app/components/ui/select/select.ts

@@ -0,0 +1,72 @@
+/**
+ * Copyright (c) 2026, Salesforce, Inc.,
+ * All rights reserved.
+ * For full license text, see the LICENSE.txt file
+ */
+import {
+	booleanAttribute,
+	ChangeDetectionStrategy,
+	Component,
+	computed,
+	input,
+	model,
+} from '@angular/core';
+import { FormsModule } from '@angular/forms';
+import { MatFormFieldModule, type MatFormFieldAppearance } from '@angular/material/form-field';
+import { MatSelectModule } from '@angular/material/select';
+import type { AppFieldSize } from '../field-size';
+
+/** Shape of an option rendered in the dropdown. */
+export interface AppSelectOption {
+	value: string;
+	label: string;
+}
+
+/** Thin wrapper over Material's `mat-form-field` + `mat-select`. */
+@Component({
+	selector: 'app-select',
+	changeDetection: ChangeDetectionStrategy.OnPush,
+	imports: [FormsModule, MatFormFieldModule, MatSelectModule],
+	templateUrl: './select.html',
+	styleUrl: './select.scss',
+})
+export class SelectComponent {
+	/** Two-way bindable single-select value. Ignored when `multiple` is set. */
+	readonly value = model<string>('');
+
+	/** Two-way bindable multi-select values. Used only when `multiple` is `true`. */
+	readonly values = model<readonly string[]>([]);
+
+	/** Render checkbox options and allow more than one selection. */
+	readonly multiple = input(false, { transform: booleanAttribute });
+
+	readonly options = input<readonly AppSelectOption[]>([]);
+	readonly placeholder = input<string>('');
+	readonly label = input<string>('');
+	readonly disabled = input<boolean>(false);
+	readonly appearance = input<MatFormFieldAppearance>('outline');
+	/** Field height: `sm` = 24px, `default` = 32px, `lg` = 40px. */
+	readonly size = input<AppFieldSize>('default');
+
+	/** Value handed to `mat-select`: the `values` array when `multiple`, else `value`. */
+	protected readonly selection = computed(() => (this.multiple() ? this.values() : this.value()));
+
+	/** Multi-select trigger summary: the sole option's label, else "N selected". */
+	protected readonly multiTriggerLabel = computed(() => {
+		const selected = this.values();
+		if (selected.length === 1) {
+			const only = selected[0];
+			return this.options().find((o) => o.value === only)?.label ?? only;
+		}
+		return `${selected.length} selected`;
+	});
+
+	/** Single change handler — routes to the right model based on `multiple`. */
+	protected onSelectionChange(next: string | string[]): void {
+		if (this.multiple()) {
+			this.values.set((next as string[]) ?? []);
+		} else {
+			this.value.set((next as string) ?? '');
+		}
+	}
+}

package/lib/templates/project/angularextapp/_p_/_m_/_w_/_a_/src/app/components/ui/separator/separator.html

@@ -0,0 +1 @@
+<mat-divider role="presentation" [vertical]="isVertical()" [inset]="inset()" />

package/lib/templates/project/angularextapp/_p_/_m_/_w_/_a_/src/app/components/ui/separator/separator.scss

@@ -0,0 +1,23 @@
+/**
+ * Copyright (c) 2026, Salesforce, Inc.,
+ * All rights reserved.
+ * For full license text, see the LICENSE.txt file
+ */
+
+/*
+ * Material's `mat-divider` draws a full-height border for the vertical variant,
+ * so its element must fill the host. The host itself carries `self-stretch`
+ * (see component `hostClass`) to take the flex row's height; here we make the
+ * inner divider fill that height. Horizontal needs nothing extra — the divider
+ * is already `display:block; width:100%`.
+ */
+:host {
+	// A vertical divider is a zero-width line; keep it out of flex growth math.
+	&[data-orientation='vertical'] {
+		display: flex;
+	}
+}
+
+.mat-divider-vertical {
+	height: 100%;
+}

package/lib/templates/project/angularextapp/_p_/_m_/_w_/_a_/src/app/components/ui/separator/separator.ts

@@ -0,0 +1,56 @@
+/**
+ * Copyright (c) 2026, Salesforce, Inc.,
+ * All rights reserved.
+ * For full license text, see the LICENSE.txt file
+ */
+import {
+	booleanAttribute,
+	ChangeDetectionStrategy,
+	Component,
+	computed,
+	input,
+} from '@angular/core';
+import { MatDivider } from '@angular/material/divider';
+
+/** Layout axis of the separator line. */
+export type AppSeparatorOrientation = 'horizontal' | 'vertical';
+
+const BASE_CLASSES = 'shrink-0';
+const ORIENTATION_CLASSES: Record<AppSeparatorOrientation, string> = {
+	horizontal: 'block w-full',
+	vertical: 'self-stretch',
+};
+
+/**
+ * Divider built on Material's `mat-divider`. `decorative` (default) hides the
+ * host from assistive tech (`role="none"`); when false it exposes
+ * `role="separator"` + `aria-orientation`. The inner `mat-divider` is marked
+ * `role="presentation"` so it never announces a duplicate separator.
+ */
+@Component({
+	selector: 'app-separator',
+	changeDetection: ChangeDetectionStrategy.OnPush,
+	imports: [MatDivider],
+	templateUrl: './separator.html',
+	styleUrl: './separator.scss',
+	host: {
+		'data-slot': 'separator',
+		'[attr.data-orientation]': 'orientation()',
+		'[attr.role]': "decorative() ? 'none' : 'separator'",
+		'[attr.aria-orientation]':
+			"decorative() ? null : (orientation() === 'vertical' ? 'vertical' : 'horizontal')",
+		'[class]': 'hostClass()',
+	},
+})
+export class SeparatorComponent {
+	readonly orientation = input<AppSeparatorOrientation>('horizontal');
+	readonly decorative = input(true, { transform: booleanAttribute });
+	/** Adds Material's horizontal inset margin so the line doesn't run edge-to-edge. */
+	readonly inset = input(false, { transform: booleanAttribute });
+
+	protected readonly isVertical = computed(() => this.orientation() === 'vertical');
+
+	protected readonly hostClass = computed(
+		() => `${BASE_CLASSES} ${ORIENTATION_CLASSES[this.orientation()]}`,
+	);
+}

package/lib/templates/project/angularextapp/_p_/_m_/_w_/_a_/src/app/components/ui/skeleton/skeleton.html

@@ -0,0 +1 @@
+<ng-content />

package/lib/templates/project/angularextapp/_p_/_m_/_w_/_a_/src/app/components/ui/skeleton/skeleton.scss

@@ -0,0 +1,28 @@
+/**
+ * Copyright (c) 2026, Salesforce, Inc.,
+ * All rights reserved.
+ * For full license text, see the LICENSE.txt file
+ */
+
+/*
+ * The skeleton is a block by default so call sites only need to supply a width
+ * and height (`h-4 w-32`) — no `block` utility to repeat. The pulse lives here
+ * (rather than Tailwind's `animate-pulse`) so it can be switched off for users
+ * who ask for reduced motion.
+ */
+:host {
+	display: block;
+	animation: app-skeleton-pulse 2s cubic-bezier(0.4, 0, 0.6, 1) infinite;
+}
+
+@keyframes app-skeleton-pulse {
+	50% {
+		opacity: 0.5;
+	}
+}
+
+@media (prefers-reduced-motion: reduce) {
+	:host {
+		animation: none;
+	}
+}

package/lib/templates/project/angularextapp/_p_/_m_/_w_/_a_/src/app/components/ui/skeleton/skeleton.ts

@@ -0,0 +1,24 @@
+/**
+ * Copyright (c) 2026, Salesforce, Inc.,
+ * All rights reserved.
+ * For full license text, see the LICENSE.txt file
+ */
+import { ChangeDetectionStrategy, Component } from '@angular/core';
+
+/**
+ * Loading skeleton — a pulsing block sized by host `class` utilities (e.g.
+ * `class="h-4 w-32"`); it has no intrinsic size, so always set width/height.
+ * `aria-hidden`, so announce loading via the container's `aria-busy`.
+ */
+@Component({
+	selector: 'app-skeleton',
+	changeDetection: ChangeDetectionStrategy.OnPush,
+	templateUrl: './skeleton.html',
+	styleUrl: './skeleton.scss',
+	host: {
+		'data-slot': 'skeleton',
+		'aria-hidden': 'true',
+		class: 'bg-accent rounded-md',
+	},
+})
+export class SkeletonComponent {}

package/lib/templates/project/angularextapp/_p_/_m_/_w_/_a_/src/app/components/ui/spinner/spinner.ts

@@ -0,0 +1,35 @@
+/**
+ * Copyright (c) 2026, Salesforce, Inc.,
+ * All rights reserved.
+ * For full license text, see the LICENSE.txt file
+ */
+import { ChangeDetectionStrategy, Component, input } from '@angular/core';
+import { MatProgressSpinnerModule, ProgressSpinnerMode } from '@angular/material/progress-spinner';
+
+/**
+ * Thin wrapper over Material's `mat-progress-spinner`. Defaults to an
+ * indeterminate 24px spinner. `ariaLabel` names the `role="progressbar"`.
+ */
+@Component({
+	selector: 'app-spinner',
+	changeDetection: ChangeDetectionStrategy.OnPush,
+	imports: [MatProgressSpinnerModule],
+	template: `
+		<mat-progress-spinner
+			[mode]="mode()"
+			[diameter]="diameter()"
+			[value]="value()"
+			[attr.aria-label]="ariaLabel()"
+		/>
+	`,
+})
+export class SpinnerComponent {
+	readonly diameter = input<number>(24);
+	readonly mode = input<ProgressSpinnerMode>('indeterminate');
+
+	/** Progress value (0–100) used only when `mode` is `determinate`. */
+	readonly value = input<number>(0);
+
+	/** Accessible name announced by assistive tech. */
+	readonly ariaLabel = input<string>('Loading', { alias: 'aria-label' });
+}

package/lib/templates/project/angularextapp/_p_/_m_/_w_/_a_/src/app/features/authentication/auth/auth.guard.ts

@@ -0,0 +1,50 @@
+/**
+ * Copyright (c) 2026, Salesforce, Inc.,
+ * All rights reserved.
+ * For full license text, see the LICENSE.txt file
+ */
+import { inject } from "@angular/core";
+import { CanActivateFn, Router, UrlTree } from "@angular/router";
+import { AuthService } from "./auth.service";
+import { AUTH_REDIRECT_PARAM, ROUTES } from "../config/authentication.config";
+
+/**
+ * Route guard — the Angular analogue of the React `PrivateRoute` layout.
+ *
+ * Allows activation when the user is authenticated. Otherwise redirects to the
+ * login page with a `startUrl` query param capturing the requested destination,
+ * so the user is returned there after a successful login.
+ *
+ * Because `AuthService` runs its initial check on construction, the guard first
+ * awaits any in-flight `loading` state (equivalent to the React guard returning
+ * `null` while loading, then re-rendering once auth resolves). It resolves to a
+ * boolean `true` or a `UrlTree` redirect — never leaves the user on a blank
+ * screen.
+ */
+export const authGuard: CanActivateFn = async (route, state): Promise<boolean | UrlTree> => {
+	const authService = inject(AuthService);
+	const router = inject(Router);
+
+	// Wait for the initial auth check to settle before deciding. If a check is
+	// already resolved this returns immediately.
+	if (authService.loading()) {
+		await authService.checkAuth();
+	} else if (authService.user() === null && authService.error() !== null) {
+		// The prior check finished unauthenticated *because of an error* (e.g. a
+		// transient network failure), not a confirmed guest. Without this, a single
+		// failed initial check would poison protected-route access until a full page
+		// reload. Re-run the check on guard entry so recovery doesn't require reload.
+		await authService.checkAuth();
+	}
+
+	if (authService.isAuthenticated()) {
+		return true;
+	}
+
+	// Capture the current destination (path + query) to return to after login.
+	// `state.url` is already the resolved absolute URL for the attempted route.
+	const destination = state.url;
+	return router.createUrlTree([ROUTES.LOGIN.PATH], {
+		queryParams: { [AUTH_REDIRECT_PARAM]: destination },
+	});
+};

package/lib/templates/project/angularextapp/_p_/_m_/_w_/_a_/src/app/features/authentication/auth/auth.service.ts

@@ -0,0 +1,126 @@
+/**
+ * Copyright (c) 2026, Salesforce, Inc.,
+ * All rights reserved.
+ * For full license text, see the LICENSE.txt file
+ */
+import { computed, inject, Injectable, signal } from "@angular/core";
+import { DataClient } from "../../../api/data-client.service";
+import { API_ROUTES } from "../config/authentication.config";
+
+/** The authenticated user shape (mirrors the React `AuthContext` `User`). */
+export interface AuthUser {
+	readonly id: string;
+	readonly name: string;
+}
+
+// UI API version used for the Chatter current-user lookup. Mirrors the constant
+// baked into @salesforce/ui-bundle's getCurrentUser helper.
+const API_VERSION = "65.0";
+
+/**
+ * Angular signal-based replacement for the React `AuthProvider` / `useAuth`.
+ *
+ * `providedIn: 'root'` makes the service a single app-wide singleton, so it
+ * replaces the React context+provider wrapper without any `<AuthProvider>` in
+ * the tree (the coordinator-approved design). State is exposed as readonly
+ * signals; `isAuthenticated` is a computed mirror of `user !== null`.
+ *
+ * Authentication is checked on construction (equivalent to the React mount
+ * `useEffect`). `checkAuth()` re-runs the lookup on demand.
+ *
+ * The current-user lookup goes through the base app's `DataClient.fetch` to the
+ * Chatter `/users/me` endpoint — the exact call `@salesforce/ui-bundle`'s
+ * `getCurrentUser` makes — so the feature reuses the base app's existing
+ * `@salesforce/platform-sdk` dependency and adds no new package.
+ */
+@Injectable({ providedIn: "root" })
+export class AuthService {
+	// DataClient is provided by the base-angular-app; consumed via the
+	// `__inherit__` stub under app/api/ (patches-cli strips the prefix at compose
+	// so it resolves to the seeded base data-client.service.ts).
+	private readonly dataClient = inject(DataClient);
+
+	private readonly _user = signal<AuthUser | null>(null);
+	private readonly _loading = signal<boolean>(true);
+	private readonly _error = signal<string | null>(null);
+
+	/** The current authenticated user, or null when unauthenticated. */
+	readonly user = this._user.asReadonly();
+	/** True while the initial (or a manual) auth check is in flight. */
+	readonly loading = this._loading.asReadonly();
+	/** Error message from the most recent failed auth check, else null. */
+	readonly error = this._error.asReadonly();
+	/** Mirrors React `isAuthenticated = user !== null`. */
+	readonly isAuthenticated = computed(() => this._user() !== null);
+
+	constructor() {
+		// Kick off the initial check on construction (React mount `useEffect`).
+		void this.checkAuth();
+	}
+
+	/**
+	 * Fetches the current user and updates state. Mirrors the React `checkAuth`.
+	 */
+	async checkAuth(): Promise<void> {
+		this._loading.set(true);
+		this._error.set(null);
+		try {
+			const userData = await this.getCurrentUser();
+			this._user.set(userData);
+		} catch (err) {
+			console.error("Authentication failed", err);
+			this._error.set("Authentication failed");
+			this._user.set(null);
+		} finally {
+			this._loading.set(false);
+		}
+	}
+
+	/**
+	 * Returns the current user, throwing when unauthenticated. The Angular
+	 * analogue of the React `useUser()` hook — used by the Profile page which
+	 * only renders behind the auth guard.
+	 */
+	requireUser(): AuthUser {
+		const user = this._user();
+		if (!user) {
+			throw new Error("Authenticated context not established");
+		}
+		return user;
+	}
+
+	/**
+	 * Navigate to the server-side logout endpoint. Uses `replace` to prevent the
+	 * back button from returning to an authenticated session. Direct port of the
+	 * React `logout`.
+	 */
+	logout(startURL?: string): void {
+		const finalLogoutUrl = startURL
+			? `${API_ROUTES.LOGOUT}?startURL=${encodeURIComponent(startURL)}`
+			: API_ROUTES.LOGOUT;
+		window.location.replace(finalLogoutUrl);
+	}
+
+	/**
+	 * Fetches the current user via the Chatter `/users/me` endpoint. Reproduces
+	 * `@salesforce/ui-bundle`'s `getCurrentUser` so we don't add ui-bundle as a
+	 * dependency (base app only ships @salesforce/platform-sdk).
+	 */
+	private async getCurrentUser(): Promise<AuthUser> {
+		const response = await this.dataClient.fetch(
+			`/services/data/v${API_VERSION}/chatter/users/me`,
+			{
+				method: "GET",
+				headers: { Accept: "application/json" },
+			},
+		);
+		if (!response.ok) {
+			throw new Error(`Failed to fetch current user: HTTP ${response.status}`);
+		}
+		const data = (await response.json()) as { id?: string; name?: string };
+		if (!data?.id) {
+			throw new Error("Current user response missing id");
+		}
+		return { id: data.id, name: data.name || "User" };
+	}
+}

package/lib/templates/project/angularextapp/_p_/_m_/_w_/_a_/src/app/features/authentication/auth-form/auth-form.html

@@ -0,0 +1,34 @@
+<app-card-layout [title]="title()" [subtitle]="description()">
+	<div class="space-y-6">
+		@if (showAuthAlert()) {
+		<app-status-alert variant="info" message="You are already logged in." />
+		} @if (errorMessages().length > 0) { @if (errorMessages().length === 1) {
+		<app-status-alert variant="error" [message]="errorMessages()[0]" />
+		} @else {
+		<app-status-alert variant="error">
+			<ul>
+				@for (msg of errorMessages(); track msg) {
+				<li>{{ msg }}</li>
+				}
+			</ul>
+		</app-status-alert>
+		} } @if (success()) {
+		<app-status-alert variant="success" [message]="success()!" />
+		}
+
+		<form (ngSubmit)="onSubmit()">
+			<ng-content />
+			<app-submit-button
+				class="mt-6 block"
+				[label]="submitText()"
+				[loadingLabel]="submitLoadingText()"
+				[submitting]="submitting()"
+				[disabled]="isSubmitDisabled()"
+			/>
+		</form>
+
+		@if (footer(); as f) {
+		<app-footer-link [text]="f.text ?? ''" [to]="f.link" [linkText]="f.linkText" />
+		}
+	</div>
+</app-card-layout>

package/lib/templates/project/angularextapp/_p_/_m_/_w_/_a_/src/app/features/authentication/auth-form/auth-form.ts

@@ -0,0 +1,94 @@
+/**
+ * Copyright (c) 2026, Salesforce, Inc.,
+ * All rights reserved.
+ * For full license text, see the LICENSE.txt file
+ */
+import { ChangeDetectionStrategy, Component, computed, inject, input, output } from "@angular/core";
+import { FormsModule } from "@angular/forms";
+import { CardLayoutComponent } from "../card-layout/card-layout";
+import { StatusAlertComponent } from "../status-alert/status-alert";
+import { SubmitButtonComponent } from "../submit-button/submit-button";
+import { FooterLinkComponent } from "../footer-link/footer-link";
+import { AuthService } from "../auth/auth.service";
+
+/** Footer link descriptor for the auth form frame. */
+export interface AuthFormFooter {
+	text?: string;
+	link: string;
+	linkText: string;
+}
+
+/**
+ * Wrapper enforcing a consistent layout (card) and error/success alert
+ * positioning for all authentication forms — the Angular port of the React
+ * `AuthForm`.
+ *
+ * Auth-aware behavior (identical to React):
+ * - While auth state is loading, the submit button is disabled.
+ * - If the user is already authenticated and `showAlreadyLoggedIn` is true, an
+ *   info alert is shown and submit is disabled.
+ *
+ * The owning page holds the FormGroup and binds `[formGroup]` on the projected
+ * `<form>`; this component renders the frame, alerts, submit button, and footer.
+ * It emits `(submitted)` when the submit button is pressed so the page runs its
+ * submit handler. The page passes its submitting flag via `[submitting]` and any
+ * extra disabled condition via `[submitDisabled]`.
+ */
+@Component({
+	selector: "app-auth-form",
+	changeDetection: ChangeDetectionStrategy.OnPush,
+	imports: [
+		FormsModule,
+		CardLayoutComponent,
+		StatusAlertComponent,
+		SubmitButtonComponent,
+		FooterLinkComponent,
+	],
+	templateUrl: "./auth-form.html",
+})
+export class AuthFormComponent {
+	private readonly authService = inject(AuthService);
+
+	readonly title = input.required<string>();
+	readonly description = input<string>("");
+	/** Error message(s) to surface; empty/null hides the error alert. */
+	readonly error = input<string | string[] | null>(null);
+	/** Success message to surface; empty/null hides the success alert. */
+	readonly success = input<string | null>(null);
+	/** Whether to show the "already logged in" alert and disable submit. @default true */
+	readonly showAlreadyLoggedIn = input<boolean>(true);
+	readonly submitText = input.required<string>();
+	readonly submitLoadingText = input<string>("Submitting…");
+	/** True while the page's async submit is in flight. */
+	readonly submitting = input<boolean>(false);
+	/** Extra disabled condition from the page (e.g. success state). */
+	readonly submitDisabled = input<boolean>(false);
+	readonly footer = input<AuthFormFooter | null>(null);
+
+	/** Emitted when the submit button is pressed (page runs its handler). */
+	readonly submitted = output<void>();
+
+	protected readonly isAuthenticated = this.authService.isAuthenticated;
+	protected readonly loading = this.authService.loading;
+
+	/** Info alert shown when already authenticated on a public page. */
+	protected readonly showAuthAlert = computed(
+		() => this.showAlreadyLoggedIn() && this.isAuthenticated(),
+	);
+
+	/** Submit disabled when: caller says so, already-logged-in, or auth loading. */
+	protected readonly isSubmitDisabled = computed(
+		() => this.submitDisabled() || this.showAuthAlert() || this.loading(),
+	);
+
+	/** Normalizes the error input to an array for the template's list rendering. */
+	protected readonly errorMessages = computed<string[]>(() => {
+		const err = this.error();
+		if (!err) return [];
+		return Array.isArray(err) ? err : [err];
+	});
+
+	protected onSubmit(): void {
+		this.submitted.emit();
+	}
+}

package/lib/templates/project/angularextapp/_p_/_m_/_w_/_a_/src/app/features/authentication/auth-layout/auth-layout.html

@@ -0,0 +1,2 @@
+<app-session-timeout-validator />
+<app-layout />

package/lib/templates/project/angularextapp/_p_/_m_/_w_/_a_/src/app/features/authentication/auth-layout/auth-layout.ts

@@ -0,0 +1,30 @@
+/**
+ * Copyright (c) 2026, Salesforce, Inc.,
+ * All rights reserved.
+ * For full license text, see the LICENSE.txt file
+ */
+import { ChangeDetectionStrategy, Component } from "@angular/core";
+import { AppLayoutComponent } from "../../../components/layout/app-layout/app-layout";
+import { SessionTimeoutValidatorComponent } from "../session/session";
+
+/**
+ * Top-level app wrapper — the faithful Angular port of the React `AuthAppLayout`
+ * (`<AuthProvider><SessionTimeoutValidator/><AppLayout/></AuthProvider>`).
+ *
+ * There is no AuthProvider equivalent: `AuthService` is `providedIn: 'root'`, so
+ * auth state is app-wide automatically. This component renders the
+ * session-timeout validator (whose warning modal is thus available on every
+ * child route, exactly like React) followed by the base `app-layout`. Child
+ * routes render inside the base layout's own `<router-outlet />` post-compose.
+ *
+ * Wired as the top route node's `component` in `app.routes.ts`; the route-merger
+ * swaps the base layout node for this wrapper (the same element-swap object-search
+ * performs by repeating `component: AppLayoutComponent`).
+ */
+@Component({
+	selector: "app-auth-app-layout",
+	changeDetection: ChangeDetectionStrategy.OnPush,
+	imports: [SessionTimeoutValidatorComponent, AppLayoutComponent],
+	templateUrl: "./auth-layout.html",
+})
+export class AuthAppLayoutComponent {}

package/lib/templates/project/angularextapp/_p_/_m_/_w_/_a_/src/app/features/authentication/card-layout/card-layout.html

@@ -0,0 +1,16 @@
+<div class="p-4">
+	<app-card class="w-full">
+		@if (title() || subtitle()) {
+		<app-card-header>
+			@if (title()) {
+			<app-card-title>{{ title() }}</app-card-title>
+			} @if (subtitle()) {
+			<app-card-description>{{ subtitle() }}</app-card-description>
+			}
+		</app-card-header>
+		}
+		<app-card-content>
+			<ng-content />
+		</app-card-content>
+	</app-card>
+</div>

package/lib/templates/project/angularextapp/_p_/_m_/_w_/_a_/src/app/features/authentication/card-layout/card-layout.ts

@@ -0,0 +1,40 @@
+/**
+ * Copyright (c) 2026, Salesforce, Inc.,
+ * All rights reserved.
+ * For full license text, see the LICENSE.txt file
+ */
+import { ChangeDetectionStrategy, Component, input } from "@angular/core";
+import {
+	CardComponent,
+	CardContentComponent,
+	CardDescriptionComponent,
+	CardHeaderComponent,
+	CardTitleComponent,
+} from "../../../components/ui/card/card";
+
+/**
+ * Centered page shell for auth pages — a feature-owned composition over the base
+ * `app-card` ui primitives (not a base-template component). Renders a single
+ * `app-card` centered in the viewport with an optional title / subtitle header,
+ * and content-projects the page body.
+ *
+ * Consumed by the authentication login / register / reset pages as the
+ * `CenteredPageLayout` analogue's card frame. Tailwind utilities pass through
+ * via the host `class`.
+ */
+@Component({
+	selector: "app-card-layout",
+	changeDetection: ChangeDetectionStrategy.OnPush,
+	imports: [
+		CardComponent,
+		CardHeaderComponent,
+		CardTitleComponent,
+		CardDescriptionComponent,
+		CardContentComponent,
+	],
+	templateUrl: "./card-layout.html",
+})
+export class CardLayoutComponent {
+	readonly title = input<string>("");
+	readonly subtitle = input<string | null>(null);
+}