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

package/dist/force-app/main/default/webapplications/appreactbyo/src/components/auth/private-route.tsx

@@ -0,0 +1,36 @@
+import { Navigate, Outlet, useLocation } from "react-router";
+import { useAuth } from "../../context/AuthContext";
+import { AUTH_REDIRECT_PARAM, ROUTES } from "../../utils/authenticationConfig";
+import { LoadingPage } from "../layout/loading-page";
+
+/**
+ * [Dev Note] Route Guard:
+ * Renders the child route (Outlet) if the user is authenticated.
+ * Otherwise, redirects to Login with a 'startUrl' parameter so the user can be
+ * returned to this page after successful login.
+ */
+export default function PrivateRoute() {
+	const { isAuthenticated, loading } = useAuth();
+	const location = useLocation();
+
+	if (loading) return <LoadingPage contentMaxWidth="md" />;
+
+	if (!isAuthenticated) {
+		const searchParams = new URLSearchParams();
+
+		// [Dev Note] Capture current location to return after login
+		const destination = location.pathname + location.search;
+		searchParams.set(AUTH_REDIRECT_PARAM, destination);
+		return (
+			<Navigate // Navigate accepts an object to safely construct the URL
+				to={{
+					pathname: ROUTES.LOGIN.PATH,
+					search: searchParams.toString(),
+				}}
+				replace
+			/>
+		);
+	}
+
+	return <Outlet />;
+}

package/dist/force-app/main/default/webapplications/appreactbyo/src/components/footers/footer-link.tsx

@@ -0,0 +1,36 @@
+import { Link } from "react-router";
+import { cn } from "../../lib/utils";
+
+interface FooterLinkProps extends Omit<React.ComponentProps<typeof Link>, "children"> {
+	/** Link text prefix (e.g., "Don't have an account?") */
+	text?: string;
+	/** Link label (e.g., "Sign up") */
+	linkText: string;
+}
+
+/**
+ * Footer link component.
+ */
+export function FooterLink({ text, to, linkText, className, ...props }: FooterLinkProps) {
+	return (
+		<p className={cn("w-full text-center text-sm text-muted-foreground", className)}>
+			{text && (
+				<>
+					{text}
+					{/* Robustness: Explicit space ensures formatting tools don't strip it */}
+					{"\u00A0"}
+				</>
+			)}
+			<Link
+				to={to}
+				className={cn(
+					"font-medium underline hover:text-primary transition-colors",
+					"focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring",
+				)}
+				{...props}
+			>
+				{linkText}
+			</Link>
+		</p>
+	);
+}

package/dist/force-app/main/default/webapplications/appreactbyo/src/components/forms/auth-form.tsx

@@ -0,0 +1,79 @@
+import { FieldGroup } from "../ui/field";
+import { StatusAlert } from "../alerts/status-alert";
+import { FooterLink } from "../footers/footer-link";
+import { SubmitButton } from "./submit-button";
+import { CardLayout } from "../layout/card-layout";
+import { useFormContext } from "../../hooks/form";
+import { useId } from "react";
+
+/**
+ * [Dev Note] A wrapper component that enforces consistent layout (Card) and error/success alert positioning
+ * for all authentication forms.
+ */
+interface AuthFormProps extends Omit<React.ComponentProps<"form">, "onSubmit"> {
+	title: string;
+	description: string;
+	error?: React.ReactNode;
+	success?: React.ReactNode;
+	submit: {
+		text: string;
+		loadingText?: string;
+	};
+	footer?: {
+		text?: string;
+		link: string;
+		linkText: string;
+	};
+}
+
+/**
+ * [Dev Note] Standardized Authentication Layout:
+ * Wraps the specific logic of Login/Register forms with a consistent visual frame (Card),
+ * title, and error alert placement. Extends form element props for flexibility.
+ * This ensures all auth-related pages look and behave similarly.
+ */
+export function AuthForm({
+	id: providedId,
+	title,
+	description,
+	error,
+	success,
+	children,
+	submit,
+	footer,
+	...props
+}: AuthFormProps) {
+	const form = useFormContext();
+	const generatedId = useId();
+	const id = providedId ?? generatedId;
+
+	return (
+		<CardLayout title={title} description={description}>
+			<div className="space-y-6">
+				{/* [Dev Note] Global form error alert (e.g. "Invalid Credentials") */}
+				{error && <StatusAlert variant="error">{error}</StatusAlert>}
+				{success && <StatusAlert variant="success">{success}</StatusAlert>}
+
+				<form
+					id={id}
+					onSubmit={(e) => {
+						e.preventDefault();
+						e.stopPropagation();
+						form.handleSubmit();
+					}}
+					{...props}
+				>
+					<FieldGroup>{children}</FieldGroup>
+					<SubmitButton
+						form={id}
+						label={submit.text}
+						loadingLabel={submit.loadingText}
+						className="mt-6"
+					/>
+				</form>
+				{/* [Dev Note] Navigation links (e.g. "Forgot Password?") */}
+				{footer && <FooterLink text={footer.text} to={footer.link} linkText={footer.linkText} />}
+			</div>
+		</CardLayout>
+	);
+}

package/dist/force-app/main/default/webapplications/appreactbyo/src/components/forms/submit-button.tsx

@@ -0,0 +1,49 @@
+import { Button } from "../ui/button";
+import { Spinner } from "../ui/spinner";
+import { cn } from "../../lib/utils";
+import { useFormContext } from "../../hooks/form";
+
+interface SubmitButtonProps extends Omit<React.ComponentProps<typeof Button>, "type" | "disabled"> {
+	/** Button text when not submitting */
+	label: string;
+	/** Button text while submitting */
+	loadingLabel?: string;
+	/** Form id to associate with (for buttons outside form element) */
+	form?: string;
+}
+
+const isSubmittingSelector = (state: { isSubmitting: boolean }) => state.isSubmitting;
+
+/**
+ * Submit button that subscribes to form submission state.
+ * UX Best Practice:
+ * 1. Disables interaction immediately upon click (via isLoading) to prevent
+ * accidental double-submissions which can cause race conditions in Auth APIs.
+ * 2. Provides immediate visual feedback (Spinner) because Auth calls (e.g. hashing passwords,
+ * generating sessions) can have variable latency.
+ */
+export function SubmitButton({
+	label,
+	loadingLabel = "Submitting…",
+	className,
+	form: formId,
+	...props
+}: SubmitButtonProps) {
+	const form = useFormContext();
+	return (
+		<form.Subscribe selector={isSubmittingSelector}>
+			{(isSubmitting: boolean) => (
+				<Button
+					type="submit"
+					form={formId}
+					className={cn("w-full", className)}
+					disabled={isSubmitting}
+					{...props}
+				>
+					{isSubmitting && <Spinner className="mr-2" aria-hidden="true" />}
+					{isSubmitting ? loadingLabel : label}
+				</Button>
+			)}
+		</form.Subscribe>
+	);
+}

package/dist/force-app/main/default/webapplications/appreactbyo/src/components/layout/card-layout.tsx

@@ -0,0 +1,23 @@
+import { Card, CardContent, CardDescription, CardHeader, CardTitle } from "../ui/card";
+
+interface CardLayoutProps {
+	title: string;
+	description?: string;
+	children: React.ReactNode;
+}
+
+/**
+ * Card layout component for authentication pages.
+ * Provides CardHeader with title and optional description, and CardContent.
+ */
+export function CardLayout({ title, description, children }: CardLayoutProps) {
+	return (
+		<Card>
+			<CardHeader>
+				<CardTitle className="text-2xl">{title}</CardTitle>
+				{description && <CardDescription>{description}</CardDescription>}
+			</CardHeader>
+			<CardContent>{children}</CardContent>
+		</Card>
+	);
+}

package/dist/force-app/main/default/webapplications/appreactbyo/src/components/layout/centered-page-layout.tsx

@@ -0,0 +1,73 @@
+import { cva, type VariantProps } from "class-variance-authority";
+import { cn } from "../../lib/utils";
+
+/**
+ * Variant styles for the content container's maximum width.
+ * Controls the maximum width of the inner content area within the page layout.
+ */
+const contentContainerVariants = cva("w-full", {
+	variants: {
+		contentMaxWidth: {
+			sm: "max-w-sm",
+			md: "max-w-md",
+			lg: "max-w-lg",
+		},
+	},
+	defaultVariants: {
+		contentMaxWidth: "sm",
+	},
+});
+
+/**
+ * Props for the CenteredPageLayout component.
+ */
+interface CenteredPageLayoutProps
+	extends React.ComponentProps<"div">,
+		VariantProps<typeof contentContainerVariants> {
+	/** The content to be displayed within the page layout */
+	children: React.ReactNode;
+	/**
+	 * Maximum width of the content container.
+	 * @default "sm"
+	 */
+	contentMaxWidth?: "sm" | "md" | "lg";
+	/**
+	 * Optional page title. If provided, will render a <title> component that React will place in the document head.
+	 */
+	title?: string;
+}
+
+/**
+ * CenteredPageLayout component that provides consistent page structure and spacing.
+ *
+ * This component creates a full-viewport-height container that centers its content
+ * both horizontally and vertically. The inner content area has a configurable maximum width
+ * to prevent content from becoming too wide on large screens.
+ *
+ * @example
+ * ```tsx
+ * <CenteredPageLayout contentMaxWidth="md">
+ *   <YourPageContent />
+ * </CenteredPageLayout>
+ * ```
+ */
+export function CenteredPageLayout({
+	contentMaxWidth,
+	className,
+	children,
+	title,
+	...props
+}: CenteredPageLayoutProps) {
+	return (
+		<>
+			{title && <title>{title}</title>}
+			<main
+				className={cn("flex min-h-svh w-full items-center justify-center p-6 md:p-10", className)}
+				data-slot="page-layout"
+				{...props}
+			>
+				<div className={contentContainerVariants({ contentMaxWidth })}>{children}</div>
+			</main>
+		</>
+	);
+}

package/dist/force-app/main/default/webapplications/appreactbyo/src/components/layout/loading-page.tsx

@@ -0,0 +1,46 @@
+import { cva, type VariantProps } from "class-variance-authority";
+import { CenteredPageLayout } from "./centered-page-layout";
+import { Spinner } from "../ui/spinner";
+
+/**
+ * Spinner size variants based on content width.
+ */
+const spinnerVariants = cva("", {
+	variants: {
+		contentMaxWidth: {
+			sm: "size-6",
+			md: "size-8",
+			lg: "size-10",
+		},
+	},
+	defaultVariants: {
+		contentMaxWidth: "sm",
+	},
+});
+
+interface LoadingPageProps extends VariantProps<typeof spinnerVariants> {
+	/**
+	 * Maximum width of the content container. Also scales the spinner size.
+	 * @default "sm"
+	 */
+	contentMaxWidth?: "sm" | "md" | "lg";
+	/**
+	 * Accessible label for screen readers.
+	 * @default "Loading…"
+	 */
+	loadingText?: string;
+}
+
+/**
+ * Full-page loading indicator with centered spinner.
+ */
+export function LoadingPage({ contentMaxWidth, loadingText = "Loading…" }: LoadingPageProps) {
+	return (
+		<CenteredPageLayout contentMaxWidth={contentMaxWidth}>
+			<div className="flex justify-center" role="status" aria-live="polite">
+				<Spinner className={spinnerVariants({ contentMaxWidth })} aria-hidden="true" />
+				<span className="sr-only">{loadingText}</span>
+			</div>
+		</CenteredPageLayout>
+	);
+}

package/dist/force-app/main/default/webapplications/appreactbyo/src/components/ui/alert.tsx

@@ -0,0 +1,65 @@
+import { cva, type VariantProps } from "class-variance-authority";
+
+import { cn } from "../../lib/utils";
+
+const alertVariants = cva(
+	"relative w-full rounded-lg border px-4 py-3 text-sm grid has-[>svg]:grid-cols-[calc(var(--spacing)*4)_1fr] grid-cols-[0_1fr] has-[>svg]:gap-x-3 gap-y-0.5 items-start [&>svg]:size-4 [&>svg]:translate-y-0.5 [&>svg]:text-current",
+	{
+		variants: {
+			variant: {
+				default: "bg-card text-card-foreground",
+				destructive:
+					"text-destructive bg-card [&>svg]:text-current *:data-[slot=alert-description]:text-destructive/90",
+			},
+		},
+		defaultVariants: {
+			variant: "default",
+		},
+	},
+);
+
+function Alert({
+	className,
+	variant,
+	role,
+	...props
+}: React.ComponentProps<"div"> & VariantProps<typeof alertVariants>) {
+	return (
+		<div
+			data-slot="alert"
+			role={role ?? (variant === "destructive" ? "alert" : "status")}
+			className={cn(alertVariants({ variant }), className)}
+			{...props}
+		/>
+	);
+}
+
+// Maintenance/A11y: Added 'asChild' pattern or a simple 'as' prop
+// to allow rendering semantic headings (h1-h6).
+interface AlertTitleProps extends React.ComponentProps<"div"> {
+	as?: "h1" | "h2" | "h3" | "h4" | "h5" | "h6" | "div" | "p";
+}
+function AlertTitle({ className, as: Component = "div", ...props }: AlertTitleProps) {
+	return (
+		<div
+			data-slot="alert-title"
+			className={cn("col-start-2 line-clamp-1 min-h-4 font-medium tracking-tight", className)}
+			{...props}
+		/>
+	);
+}
+
+function AlertDescription({ className, ...props }: React.ComponentProps<"div">) {
+	return (
+		<div
+			data-slot="alert-description"
+			className={cn(
+				"col-start-2 grid justify-items-start gap-1 text-sm [&_p]:leading-relaxed",
+				className,
+			)}
+			{...props}
+		/>
+	);
+}
+
+export { Alert, AlertTitle, AlertDescription };

package/dist/force-app/main/default/webapplications/appreactbyo/src/components/ui/button.tsx

@@ -0,0 +1,56 @@
+import * as React from "react";
+import { Slot } from "@radix-ui/react-slot";
+import { cva, type VariantProps } from "class-variance-authority";
+
+import { cn } from "../../lib/utils";
+
+const buttonVariants = cva(
+	"inline-flex items-center justify-center gap-2 whitespace-nowrap rounded-md text-sm font-medium transition-all disabled:pointer-events-none disabled:opacity-50 [&_svg]:pointer-events-none [&_svg:not([class*='size-'])]:size-4 shrink-0 [&_svg]:shrink-0 outline-none focus-visible:border-ring focus-visible:ring-ring/50 focus-visible:ring-[3px] aria-invalid:ring-destructive/20 dark:aria-invalid:ring-destructive/40 aria-invalid:border-destructive cursor-pointer",
+	{
+		variants: {
+			variant: {
+				default: "bg-primary text-primary-foreground shadow-xs hover:bg-primary/90",
+				destructive:
+					"bg-destructive text-white shadow-xs hover:bg-destructive/90 focus-visible:ring-destructive/20 dark:focus-visible:ring-destructive/40 dark:bg-destructive/60",
+				outline:
+					"border bg-background shadow-xs hover:bg-accent hover:text-accent-foreground dark:bg-input/30 dark:border-input dark:hover:bg-input/50",
+				secondary: "bg-secondary text-secondary-foreground shadow-xs hover:bg-secondary/80",
+				ghost: "hover:bg-accent hover:text-accent-foreground dark:hover:bg-accent/50",
+				link: "text-primary underline-offset-4 hover:underline",
+			},
+			size: {
+				default: "h-9 px-4 py-2 has-[>svg]:px-3",
+				sm: "h-8 rounded-md gap-1.5 px-3 has-[>svg]:px-2.5",
+				lg: "h-10 rounded-md px-6 has-[>svg]:px-4",
+				icon: "size-9",
+			},
+		},
+		defaultVariants: {
+			variant: "default",
+			size: "default",
+		},
+	},
+);
+
+function Button({
+	className,
+	variant,
+	size,
+	asChild = false,
+	...props
+}: React.ComponentProps<"button"> &
+	VariantProps<typeof buttonVariants> & {
+		asChild?: boolean;
+	}) {
+	const Comp = asChild ? Slot : "button";
+
+	return (
+		<Comp
+			data-slot="button"
+			className={cn(buttonVariants({ variant, size, className }))}
+			{...props}
+		/>
+	);
+}
+
+export { Button, buttonVariants };

package/dist/force-app/main/default/webapplications/appreactbyo/src/components/ui/card.tsx

@@ -0,0 +1,77 @@
+import { cn } from "../../lib/utils";
+
+function Card({ className, ...props }: React.ComponentProps<"div">) {
+	return (
+		<div
+			data-slot="card"
+			className={cn(
+				"bg-card text-card-foreground flex flex-col gap-6 rounded-xl border py-6 shadow-sm",
+				className,
+			)}
+			{...props}
+		/>
+	);
+}
+
+function CardHeader({ className, ...props }: React.ComponentProps<"div">) {
+	return (
+		<div
+			data-slot="card-header"
+			className={cn(
+				"@container/card-header grid auto-rows-min grid-rows-[auto_auto] items-start gap-1.5 px-6 has-data-[slot=card-action]:grid-cols-[1fr_auto] [.border-b]:pb-6",
+				className,
+			)}
+			{...props}
+		/>
+	);
+}
+
+function CardTitle({
+	className,
+	as: Component = "h3",
+	...props
+}: React.ComponentProps<"div"> & { as?: any }) {
+	return (
+		<Component
+			data-slot="card-title"
+			className={cn("leading-none font-semibold tracking-tight", className)}
+			{...props}
+		/>
+	);
+}
+
+function CardDescription({ className, ...props }: React.ComponentProps<"div">) {
+	return (
+		<div
+			data-slot="card-description"
+			className={cn("text-muted-foreground text-sm", className)}
+			{...props}
+		/>
+	);
+}
+
+function CardAction({ className, ...props }: React.ComponentProps<"div">) {
+	return (
+		<div
+			data-slot="card-action"
+			className={cn("col-start-2 row-span-2 row-start-1 self-start justify-self-end", className)}
+			{...props}
+		/>
+	);
+}
+
+function CardContent({ className, ...props }: React.ComponentProps<"div">) {
+	return <div data-slot="card-content" className={cn("px-6", className)} {...props} />;
+}
+
+function CardFooter({ className, ...props }: React.ComponentProps<"div">) {
+	return (
+		<div
+			data-slot="card-footer"
+			className={cn("flex items-center px-6 [.border-t]:pt-6", className)}
+			{...props}
+		/>
+	);
+}
+
+export { Card, CardHeader, CardFooter, CardTitle, CardAction, CardDescription, CardContent };

package/dist/force-app/main/default/webapplications/appreactbyo/src/components/ui/field.tsx

@@ -0,0 +1,111 @@
+import * as React from "react";
+
+import { cn } from "../../lib/utils";
+import { Label } from "./label";
+
+function Field({
+	className,
+	orientation = "vertical",
+	...props
+}: React.ComponentProps<"div"> & {
+	orientation?: "horizontal" | "vertical";
+}) {
+	return (
+		<div
+			data-slot="field"
+			data-orientation={orientation}
+			className={cn(
+				"grid gap-2",
+				orientation === "horizontal" && "flex flex-wrap items-center gap-x-3 gap-y-1.5",
+				className,
+			)}
+			{...props}
+		/>
+	);
+}
+
+function FieldLabel({ className, ...props }: React.ComponentProps<typeof Label>) {
+	return (
+		<Label
+			data-slot="field-label"
+			className={cn(
+				"data-[disabled]:opacity-50 group-data-[disabled]:opacity-50 peer-disabled:opacity-50",
+				className,
+			)}
+			{...props}
+		/>
+	);
+}
+
+function FieldDescription({ className, ...props }: React.ComponentProps<"p">) {
+	return (
+		<p
+			data-slot="field-description"
+			className={cn("text-muted-foreground text-sm", className)}
+			{...props}
+		/>
+	);
+}
+
+function FieldError({
+	className,
+	errors,
+	...props
+}: React.ComponentProps<"p"> & { errors?: (Error | undefined | null)[] }) {
+	const errorMessages = errors?.filter(Boolean).map((e) => e?.message);
+
+	if (!errorMessages?.length) {
+		return null;
+	}
+
+	return (
+		<p
+			data-slot="field-error"
+			className={cn("text-destructive text-sm", className)}
+			aria-live="polite"
+			{...props}
+		>
+			{errorMessages.join(", ")}
+		</p>
+	);
+}
+
+function FieldGroup({ className, ...props }: React.ComponentProps<"div">) {
+	return <div data-slot="field-group" className={cn("grid gap-6", className)} {...props} />;
+}
+
+function FieldSet({ className, ...props }: React.ComponentProps<"fieldset">) {
+	return <fieldset data-slot="field-set" className={cn("grid gap-4", className)} {...props} />;
+}
+
+function FieldLegend({ className, ...props }: React.ComponentProps<"legend">) {
+	return (
+		<legend
+			data-slot="field-legend"
+			className={cn("text-foreground font-medium leading-none", className)}
+			{...props}
+		/>
+	);
+}
+
+function FieldSeparator({ className, ...props }: React.ComponentProps<"div">) {
+	return (
+		<div
+			data-slot="field-separator"
+			role="separator"
+			className={cn("bg-border -mx-6 h-px", className)}
+			{...props}
+		/>
+	);
+}
+
+export {
+	Field,
+	FieldDescription,
+	FieldError,
+	FieldGroup,
+	FieldLabel,
+	FieldLegend,
+	FieldSeparator,
+	FieldSet,
+};