@salesforce/webapp-template-app-react-sample-b2x-experimental 1.68.0 → 1.69.0

package/dist/force-app/main/default/webapplications/appreactsampleb2x/src/components/FiltersPanel.tsx

@@ -0,0 +1,375 @@
+/**
+ * FiltersPanel Component
+ *
+ * Displays a panel of filter inputs for refining search results.
+ * Supports both text inputs and select dropdowns based on filter affordance.
+ *
+ * @param filters - Array of filter definitions to display
+ * @param picklistValues - Record of picklist values keyed by field path
+ * @param loading - Whether filters are currently loading
+ * @param onApplyFilters - Callback when filters are applied, receives filter values object
+ *
+ * @remarks
+ * - Automatically initializes filter values from defaultValues
+ * - Shows loading skeleton while filters are being fetched
+ * - Supports "Apply Filters" and "Reset" actions
+ * - Uses TanStack Form for form state management (similar to Login page)
+ * - Uses FiltersForm wrapper for consistent UX/UI (similar to AuthForm pattern)
+ *
+ * @example
+ * ```tsx
+ * <FiltersPanel
+ *   filters={filters}
+ *   picklistValues={picklistValues}
+ *   loading={false}
+ *   onApplyFilters={(values) => applyFilters(values)}
+ * />
+ * ```
+ */
+import { useState, useMemo, useCallback, useEffect, useRef } from "react";
+import { Card, CardContent, CardHeader, CardTitle } from "./ui/card";
+import { Skeleton } from "./ui/skeleton";
+import { FiltersForm } from "./forms/filters-form";
+import { Field, FieldLabel, FieldDescription } from "./ui/field";
+import { useAppForm, validateRangeValues } from "../hooks/form";
+import type { Filter, FilterCriteria } from "../types/filters/filters";
+import type { PicklistValue } from "../types/filters/picklist";
+import { parseFilterValue } from "../utils/filterUtils";
+import { sanitizeFilterValue } from "../utils/sanitizationUtils";
+import { getFormValueByPath } from "../utils/formUtils";
+
+interface FiltersPanelProps {
+	filters: Filter[];
+	picklistValues: Record<string, PicklistValue[]>;
+	loading: boolean;
+	objectApiName: string;
+	onApplyFilters: (filterCriteria: FilterCriteria[]) => void;
+}
+
+export default function FiltersPanel({
+	filters,
+	picklistValues,
+	loading,
+	objectApiName,
+	onApplyFilters,
+}: FiltersPanelProps) {
+	const [submitError, setSubmitError] = useState<string | null>(null);
+	const [submitSuccess, setSubmitSuccess] = useState<string | null>(null);
+
+	const defaultValues = useMemo(() => {
+		if (!filters || !Array.isArray(filters)) {
+			return {};
+		}
+
+		const values: Record<string, string> = {};
+		filters.forEach((filter) => {
+			if (filter && filter.targetFieldPath) {
+				const affordance = filter.affordance?.toLowerCase() || "";
+
+				if (affordance === "range") {
+					const minFieldName = `${filter.targetFieldPath}_min`;
+					const maxFieldName = `${filter.targetFieldPath}_max`;
+
+					if (filter.defaultValues && filter.defaultValues.length >= 2) {
+						values[minFieldName] = filter.defaultValues[0] || "";
+						values[maxFieldName] = filter.defaultValues[1] || "";
+					} else {
+						values[minFieldName] = "";
+						values[maxFieldName] = "";
+					}
+				} else {
+					if (filter.defaultValues && filter.defaultValues.length > 0) {
+						values[filter.targetFieldPath] = filter.defaultValues[0];
+					} else {
+						values[filter.targetFieldPath] = "";
+					}
+				}
+			}
+		});
+		return values;
+	}, [filters]);
+
+	const form = useAppForm({
+		defaultValues,
+		onSubmit: async ({ value }) => {
+			setSubmitError(null);
+			setSubmitSuccess(null);
+			try {
+				const filterCriteria: FilterCriteria[] = [];
+
+				for (const filter of filters) {
+					if (!filter || !filter.targetFieldPath) {
+						continue;
+					}
+
+					const affordance = filter.affordance?.toLowerCase() || "";
+
+					if (affordance === "range") {
+						const minFieldName = `${filter.targetFieldPath}_min`;
+						const maxFieldName = `${filter.targetFieldPath}_max`;
+						const minValueRaw = value[minFieldName] || "";
+						const maxValueRaw = value[maxFieldName] || "";
+
+						const minValue = sanitizeFilterValue(minValueRaw);
+						const maxValue = sanitizeFilterValue(maxValueRaw);
+
+						if (minValue && maxValue) {
+							const rangeError = validateRangeValues(minValue, maxValue);
+							if (rangeError) {
+								setSubmitError(rangeError);
+								return;
+							}
+						}
+
+						if (minValue) {
+							const parsedMin = parseFilterValue(minValue);
+							if (parsedMin !== "") {
+								filterCriteria.push({
+									objectApiName,
+									fieldPath: filter.targetFieldPath,
+									operator: "gte",
+									values: [parsedMin],
+								});
+							}
+						}
+
+						if (maxValue) {
+							const parsedMax = parseFilterValue(maxValue);
+							if (parsedMax !== "") {
+								filterCriteria.push({
+									objectApiName,
+									fieldPath: filter.targetFieldPath,
+									operator: "lte",
+									values: [parsedMax],
+								});
+							}
+						}
+					} else {
+						const fieldValueRaw =
+							getFormValueByPath(value as Record<string, unknown>, filter.targetFieldPath) || "";
+						const fieldValue = sanitizeFilterValue(fieldValueRaw);
+
+						if (fieldValue) {
+							if (affordance === "select") {
+								filterCriteria.push({
+									objectApiName,
+									fieldPath: filter.targetFieldPath,
+									operator: "eq",
+									values: [fieldValue],
+								});
+							} else {
+								const likeValue = `%${fieldValue}%`;
+								filterCriteria.push({
+									objectApiName,
+									fieldPath: filter.targetFieldPath,
+									operator: "like",
+									values: [likeValue],
+								});
+							}
+						}
+					}
+				}
+
+				if (filterCriteria.length === 0) {
+					setSubmitSuccess("No filters applied. Showing all results.");
+				} else {
+					setSubmitSuccess("Filters applied successfully");
+				}
+
+				onApplyFilters(filterCriteria);
+			} catch (err) {
+				const errorMessage = err instanceof Error ? err.message : "Failed to apply filters";
+				setSubmitError(errorMessage);
+			}
+		},
+		onSubmitInvalid: () => {},
+	});
+
+	const previousDefaultValuesRef = useRef<Record<string, string>>({});
+	const previousLoadingRef = useRef<boolean>(true);
+
+	useEffect(() => {
+		const loadingJustCompleted = previousLoadingRef.current && !loading;
+		const defaultValuesChanged =
+			JSON.stringify(previousDefaultValuesRef.current) !== JSON.stringify(defaultValues);
+
+		if (loadingJustCompleted && defaultValues && Object.keys(defaultValues).length > 0) {
+			form.reset(defaultValues);
+			previousDefaultValuesRef.current = defaultValues;
+		} else if (defaultValuesChanged && !loading && Object.keys(defaultValues).length > 0) {
+			form.reset(defaultValues);
+			previousDefaultValuesRef.current = defaultValues;
+		}
+
+		previousLoadingRef.current = loading;
+	}, [loading, defaultValues]);
+
+	const handleSuccessDismiss = useCallback(() => {
+		setSubmitSuccess(null);
+	}, []);
+
+	const handleReset = useCallback(() => {
+		if (!filters || !Array.isArray(filters)) {
+			form.reset();
+			onApplyFilters([]);
+			setSubmitError(null);
+			setSubmitSuccess(null);
+			return;
+		}
+
+		const resetValues: Record<string, string> = {};
+		filters.forEach((filter) => {
+			if (filter && filter.targetFieldPath) {
+				const affordance = filter.affordance?.toLowerCase() || "";
+
+				if (affordance === "range") {
+					resetValues[`${filter.targetFieldPath}_min`] = "";
+					resetValues[`${filter.targetFieldPath}_max`] = "";
+				} else {
+					resetValues[filter.targetFieldPath] = "";
+				}
+			}
+		});
+		form.reset(resetValues);
+		onApplyFilters([]);
+		setSubmitError(null);
+		setSubmitSuccess(null);
+	}, [filters, onApplyFilters, form]);
+
+	if (loading) {
+		return (
+			<Card className="w-full" role="region" aria-label="Filters panel">
+				<CardHeader>
+					<CardTitle>Filters</CardTitle>
+				</CardHeader>
+				<CardContent
+					className="space-y-4"
+					role="status"
+					aria-live="polite"
+					aria-label="Loading filters"
+				>
+					<span className="sr-only">Loading filters</span>
+					{[1, 2, 3].map((i) => (
+						<div key={i} className="space-y-2" aria-hidden="true">
+							<Skeleton className="h-4 w-24" />
+							<Skeleton className="h-9 w-full" />
+						</div>
+					))}
+				</CardContent>
+			</Card>
+		);
+	}
+
+	if (!filters || !Array.isArray(filters) || filters.length === 0) {
+		return (
+			<Card className="w-full" role="region" aria-label="Filters panel">
+				<CardHeader>
+					<CardTitle>Filters</CardTitle>
+				</CardHeader>
+				<CardContent>
+					<p className="text-sm text-muted-foreground">No filters available</p>
+				</CardContent>
+			</Card>
+		);
+	}
+
+	return (
+		<form.AppForm>
+			<FiltersForm
+				title="Filters"
+				description="Refine your search results by applying filters"
+				error={submitError}
+				success={submitSuccess}
+				onSuccessDismiss={handleSuccessDismiss}
+				submit={{
+					text: "Apply Filters",
+					loadingText: "Applying filters…",
+				}}
+				reset={{
+					text: "Reset",
+					onReset: handleReset,
+				}}
+			>
+				{filters.map((filter) => {
+					if (!filter || !filter.targetFieldPath) {
+						return null;
+					}
+
+					const fieldPicklistValues = picklistValues[filter.targetFieldPath] || [];
+					const affordance = filter.affordance?.toLowerCase() || "";
+
+					if (affordance === "range") {
+						const minFieldName = `${filter.targetFieldPath}_min`;
+						const maxFieldName = `${filter.targetFieldPath}_max`;
+						const inputType = "text";
+						const placeholder =
+							filter.attributes?.placeholder === "null"
+								? undefined
+								: filter.attributes?.placeholder;
+
+						return (
+							<Field key={filter.targetFieldPath}>
+								<FieldLabel>{filter.label || filter.targetFieldPath}</FieldLabel>
+								{filter.helpMessage && <FieldDescription>{filter.helpMessage}</FieldDescription>}
+								<div
+									className="grid grid-cols-2 gap-3"
+									role="group"
+									aria-label={`${filter.label || filter.targetFieldPath} range filter`}
+								>
+									<form.AppField name={minFieldName}>
+										{(field) => (
+											<field.FilterRangeMinField
+												placeholder={placeholder || "Min"}
+												type={inputType}
+												aria-label={`${filter.label || filter.targetFieldPath} - Minimum`}
+											/>
+										)}
+									</form.AppField>
+									<form.AppField name={maxFieldName}>
+										{(field) => (
+											<field.FilterRangeMaxField
+												placeholder={placeholder || "Max"}
+												type={inputType}
+												aria-label={`${filter.label || filter.targetFieldPath} - Maximum`}
+											/>
+										)}
+									</form.AppField>
+								</div>
+							</Field>
+						);
+					}
+
+					if (affordance === "select") {
+						return (
+							<form.AppField key={filter.targetFieldPath} name={filter.targetFieldPath}>
+								{(field) => (
+									<field.FilterSelectField
+										label={filter.label || filter.targetFieldPath}
+										description={filter.helpMessage || undefined}
+										placeholder={filter.attributes?.placeholder || "Select..."}
+										options={fieldPicklistValues}
+									/>
+								)}
+							</form.AppField>
+						);
+					}
+
+					return (
+						<form.AppField key={filter.targetFieldPath} name={filter.targetFieldPath}>
+							{(field) => (
+								<field.FilterTextField
+									label={filter.label || filter.targetFieldPath}
+									description={filter.helpMessage || undefined}
+									placeholder={
+										filter.attributes?.placeholder ||
+										`Enter ${(filter.label || filter.targetFieldPath).toLowerCase()}`
+									}
+								/>
+							)}
+						</form.AppField>
+					);
+				})}
+			</FiltersForm>
+		</form.AppForm>
+	);
+}

package/dist/force-app/main/default/webapplications/appreactsampleb2x/src/components/LoadingFallback.tsx

@@ -0,0 +1,61 @@
+/**
+ * LoadingFallback Component
+ *
+ * Loading fallback component for Suspense boundaries.
+ * Displays a centered spinner while lazy-loaded components are being fetched.
+ *
+ * @remarks
+ * - Used with React Suspense for code splitting
+ * - Simple centered spinner design
+ * - Responsive and accessible
+ *
+ * @example
+ * ```tsx
+ * <Suspense fallback={<LoadingFallback />}>
+ *   <LazyComponent />
+ * </Suspense>
+ * ```
+ */
+import { cva, type VariantProps } from "class-variance-authority";
+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 LoadingFallbackProps 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;
+}
+
+export default function LoadingFallback({
+	contentMaxWidth = "sm",
+	loadingText = "Loading…",
+}: LoadingFallbackProps) {
+	return (
+		<div className="flex justify-center" role="status" aria-live="polite">
+			<Spinner className={spinnerVariants({ contentMaxWidth })} aria-hidden="true" />
+			<span className="sr-only">{loadingText}</span>
+		</div>
+	);
+}

package/dist/force-app/main/default/webapplications/appreactsampleb2x/src/components/PropertyListingCard.tsx

@@ -0,0 +1,164 @@
+/**
+ * ZENLEASE-style listing card: image carousel area, name + address, price by beds, amenities, Apply button.
+ */
+import { useNavigate } from "react-router";
+import { useCallback, useState } from "react";
+import { Button } from "@/components/ui/button";
+import type { SearchResultRecordData } from "@/types/search/searchResults";
+import { Heart } from "lucide-react";
+
+function fieldDisplay(
+	fields: Record<string, { value?: unknown; displayValue?: string | null }> | undefined,
+	apiName: string,
+): string | null {
+	const f = fields?.[apiName];
+	if (!f || typeof f !== "object") return null;
+	if (f.displayValue != null && f.displayValue !== "") return String(f.displayValue);
+	if (f.value != null) return typeof f.value === "object" ? null : String(f.value);
+	return null;
+}
+
+function formatPrice(val: string | number | null): string {
+	if (val == null) return "—";
+	const n = typeof val === "number" ? val : Number(val);
+	if (Number.isNaN(n)) return String(val);
+	return (
+		new Intl.NumberFormat("en-US", {
+			style: "currency",
+			currency: "USD",
+			maximumFractionDigits: 0,
+		}).format(n) + "+"
+	);
+}
+
+interface PropertyListingCardProps {
+	record: SearchResultRecordData;
+	imageUrl: string | null;
+	/** Property address (Address__c from Property__c) when available */
+	address?: string | null;
+}
+
+export default function PropertyListingCard({
+	record,
+	imageUrl,
+	address,
+}: PropertyListingCardProps) {
+	const navigate = useNavigate();
+	const [favorited, setFavorited] = useState(false);
+	const name = fieldDisplay(record.fields, "Name") ?? "Untitled";
+	const price = fieldDisplay(record.fields, "Listing_Price__c");
+	const propertyRef = fieldDisplay(record.fields, "Property__c");
+	const detailPath = `/property/${record.id}`;
+	const displayAddress = (address ?? propertyRef ?? "").trim().replace(/\n/g, ", ") || null;
+
+	const handleClick = useCallback(() => {
+		navigate(detailPath);
+	}, [navigate, detailPath]);
+
+	const handleKeyDown = useCallback(
+		(e: React.KeyboardEvent) => {
+			if (e.key === "Enter" || e.key === " ") {
+				e.preventDefault();
+				handleClick();
+			}
+		},
+		[handleClick],
+	);
+
+	const toggleFavorite = useCallback((e: React.MouseEvent) => {
+		e.stopPropagation();
+		setFavorited((v) => !v);
+	}, []);
+
+	return (
+		<article
+			className="cursor-pointer overflow-hidden rounded-2xl border border-border bg-card shadow-sm transition-all duration-200 hover:shadow-md focus-within:ring-2 focus-within:ring-primary focus-within:ring-offset-2"
+			onClick={handleClick}
+			onKeyDown={handleKeyDown}
+			role="button"
+			tabIndex={0}
+			aria-label={`View details for ${name}`}
+		>
+			{/* Image area with carousel affordances + Virtual Tours / Videos overlays */}
+			<div className="relative aspect-[16/10] w-full overflow-hidden rounded-t-2xl bg-muted">
+				{imageUrl ? (
+					<img src={imageUrl} alt="" className="h-full w-full object-cover" />
+				) : (
+					<div className="flex h-full items-center justify-center text-sm text-muted-foreground">
+						No image
+					</div>
+				)}
+				{/* Left/right carousel arrows (visual only for now) */}
+				<button
+					type="button"
+					className="absolute left-2 top-1/2 flex h-8 w-8 -translate-y-1/2 cursor-pointer items-center justify-center rounded-full bg-black/40 text-white transition-colors duration-200 hover:bg-black/60"
+					aria-label="Previous image"
+					onClick={(e) => e.stopPropagation()}
+				>
+					←
+				</button>
+				<button
+					type="button"
+					className="absolute right-2 top-1/2 flex h-8 w-8 -translate-y-1/2 cursor-pointer items-center justify-center rounded-full bg-black/40 text-white transition-colors duration-200 hover:bg-black/60"
+					aria-label="Next image"
+					onClick={(e) => e.stopPropagation()}
+				>
+					→
+				</button>
+				{/* Virtual Tours / Videos pills – purple per ZENLEASE screenshots */}
+				<div className="absolute left-2 top-2 flex flex-col gap-1">
+					<span className="rounded-full bg-violet-600 px-2 py-0.5 text-xs font-medium text-white">
+						Virtual Tours
+					</span>
+					<span className="rounded-full bg-violet-600/90 px-2 py-0.5 text-xs font-medium text-white">
+						Videos
+					</span>
+				</div>
+			</div>
+
+			<div className="p-3">
+				{/* Name + address row with favorite */}
+				<div className="mb-2 flex items-start justify-between gap-2">
+					<div className="min-w-0">
+						<h3 className="font-semibold text-foreground">{name}</h3>
+						{displayAddress && (
+							<p className="truncate text-sm text-muted-foreground">{displayAddress}</p>
+						)}
+					</div>
+					<button
+						type="button"
+						className="shrink-0 cursor-pointer rounded-xl p-1 text-muted-foreground transition-colors duration-200 hover:bg-muted hover:text-foreground"
+						aria-label={favorited ? "Remove from favorites" : "Add to favorites"}
+						onClick={toggleFavorite}
+					>
+						<Heart className={`h-5 w-5 ${favorited ? "fill-primary text-primary" : ""}`} />
+					</button>
+				</div>
+
+				{/* Price by beds – single price shown as main */}
+				<div className="mb-2 flex flex-wrap gap-3 text-sm">
+					{price != null && (
+						<span className="font-medium text-foreground">
+							{formatPrice(price)} <span className="font-normal text-muted-foreground">2 Beds</span>
+						</span>
+					)}
+				</div>
+
+				{/* Amenities line */}
+				<p className="mb-3 text-xs text-muted-foreground">View details for amenities</p>
+
+				{/* Apply – teal primary button */}
+				<Button
+					size="sm"
+					className="w-full cursor-pointer rounded-xl bg-primary transition-colors duration-200 hover:bg-primary/90"
+					onClick={(e) => {
+						e.stopPropagation();
+						navigate(`/application?listingId=${encodeURIComponent(record.id)}`);
+					}}
+				>
+					Apply
+				</Button>
+			</div>
+		</article>
+	);
+}