@salesforce/templates 66.5.5 → 66.6.0

package/lib/templates/project/reactb2e/_p_/_m_/_w_/_a_/src/_f_/_gs_/constants.ts

@@ -1,39 +0,0 @@
-/**
- * Application-wide Constants
- *
- * Defines constants used throughout the global search feature.
- */
-
-/**
- * Object API names to search across in the global search feature.
- * Currently supports single object search.
- *
- * @remarks
- * - Array of Salesforce object API names
- * - First element is used as the primary search object
- * - Can be extended to support multiple objects in the future
- *
- * @example
- * ```tsx
- * const objectApiName = OBJECT_API_NAMES[0]; // 'Account'
- * ```
- */
-export const OBJECT_API_NAMES = ["Account"] as const;
-
-/** Fallback title when record display name cannot be resolved (e.g. before load or no name field). */
-export const DEFAULT_DETAIL_PAGE_TITLE = "Untitled";
-
-/**
- * Default page size for search results pagination.
- * This should match one of the values in PAGE_SIZE_OPTIONS from paginationUtils.
- *
- * @remarks
- * - Default value is 20 (second option in PAGE_SIZE_OPTIONS)
- * - Can be changed by user via pagination controls
- *
- * @example
- * ```tsx
- * const [pageSize, setPageSize] = useState(DEFAULT_PAGE_SIZE);
- * ```
- */
-export const DEFAULT_PAGE_SIZE = 20;

package/lib/templates/project/reactb2e/_p_/_m_/_w_/_a_/src/_f_/_gs_/filters/FilterInput.tsx

@@ -1,55 +0,0 @@
-/**
- * FilterInput Component
- *
- * Renders a text input field for filter values.
- * Used for filters that don't have a picklist (affordance !== 'select').
- *
- * @param filter - Filter definition containing field path, label, and attributes
- * @param value - Current filter input value
- * @param onChange - Callback when input value changes
- *
- * @remarks
- * - Displays filter label or field path as the label
- * - Shows placeholder text from filter attributes or generates default
- * - Displays help message if available
- *
- * @example
- * ```tsx
- * <FilterInput
- *   filter={textFilter}
- *   value={filterValue}
- *   onChange={(value) => setFilterValue(value)}
- * />
- * ```
- */
-import { Input } from "../../../components/ui/input";
-import { Field, FieldLabel, FieldDescription } from "../../../components/ui/field";
-import type { Filter } from "../types/filters/filters";
-
-interface FilterInputProps {
-	filter: Filter;
-	value: string;
-	onChange: (value: string) => void;
-}
-
-export default function FilterInput({ filter, value, onChange }: FilterInputProps) {
-	return (
-		<Field>
-			<FieldLabel htmlFor={filter.targetFieldPath}>
-				{filter.label || filter.targetFieldPath}
-			</FieldLabel>
-			<Input
-				id={filter.targetFieldPath}
-				type="text"
-				value={value}
-				onChange={(e: React.ChangeEvent<HTMLInputElement>) => onChange(e.target.value)}
-				placeholder={
-					filter.attributes?.placeholder ||
-					`Enter ${(filter.label || filter.targetFieldPath).toLowerCase()}`
-				}
-				aria-label={filter.label || filter.targetFieldPath}
-			/>
-			{filter.helpMessage && <FieldDescription>{filter.helpMessage}</FieldDescription>}
-		</Field>
-	);
-}

package/lib/templates/project/reactb2e/_p_/_m_/_w_/_a_/src/_f_/_gs_/filters/FilterSelect.tsx

@@ -1,72 +0,0 @@
-/**
- * FilterSelect Component
- *
- * Renders a dropdown select field for filter values with picklist options.
- * Used for filters with affordance === 'select'.
- *
- * @param filter - Filter definition containing field path, label, and attributes
- * @param value - Currently selected filter value
- * @param options - Array of picklist values to display as options
- * @param onChange - Callback when selection changes
- *
- * @remarks
- * - Filters out invalid options (null/undefined values)
- * - Displays option label if available, otherwise uses value
- * - Shows placeholder from filter attributes or default "Select..."
- *
- * @example
- * ```tsx
- * <FilterSelect
- *   filter={selectFilter}
- *   value={selectedValue}
- *   options={picklistOptions}
- *   onChange={(value) => setSelectedValue(value)}
- * />
- * ```
- */
-import {
-	Select,
-	SelectContent,
-	SelectItem,
-	SelectTrigger,
-	SelectValue,
-} from "../../../components/ui/select";
-import { Field, FieldLabel, FieldDescription } from "../../../components/ui/field";
-import type { Filter } from "../types/filters/filters";
-import type { PicklistValue } from "../types/filters/picklist";
-
-interface FilterSelectProps {
-	filter: Filter;
-	value: string;
-	options: PicklistValue[];
-	onChange: (value: string) => void;
-}
-
-export default function FilterSelect({ filter, value, options, onChange }: FilterSelectProps) {
-	return (
-		<Field>
-			<FieldLabel htmlFor={filter.targetFieldPath}>
-				{filter.label || filter.targetFieldPath}
-			</FieldLabel>
-			<Select value={value} onValueChange={onChange}>
-				<SelectTrigger
-					id={filter.targetFieldPath}
-					aria-label={filter.label || filter.targetFieldPath}
-				>
-					<SelectValue placeholder={filter.attributes?.placeholder || "Select..."} />
-				</SelectTrigger>
-				<SelectContent>
-					{options.map((option) => {
-						if (!option || !option.value) return null;
-						return (
-							<SelectItem key={option.value} value={option.value}>
-								{option.label || option.value}
-							</SelectItem>
-						);
-					})}
-				</SelectContent>
-			</Select>
-			{filter.helpMessage && <FieldDescription>{filter.helpMessage}</FieldDescription>}
-		</Field>
-	);
-}

package/lib/templates/project/reactb2e/_p_/_m_/_w_/_a_/src/_f_/_gs_/hooks/form.tsx

@@ -1,209 +0,0 @@
-import { useId } from "react";
-import { createFormHookContexts, createFormHook } from "@tanstack/react-form";
-import {
-	Field,
-	FieldDescription,
-	FieldError,
-	FieldLabel,
-} from "../../../components/ui/field";
-import { Input } from "../../../components/ui/input";
-import {
-	Select,
-	SelectContent,
-	SelectItem,
-	SelectTrigger,
-	SelectValue,
-} from "../../../components/ui/select";
-import { cn } from "../../../lib/utils";
-import type { PicklistValue } from "../types/filters/picklist";
-import { getUniqueErrors } from "../utils/formUtils";
-
-export type { FormError } from "../utils/formUtils";
-export { validateRangeValues } from "../utils/formUtils";
-
-export const { fieldContext, formContext, useFieldContext, useFormContext } =
-	createFormHookContexts();
-
-interface FilterTextFieldProps extends Omit<
-	React.ComponentProps<typeof Input>,
-	"name" | "value" | "onBlur" | "onChange" | "aria-invalid"
-> {
-	label: string;
-	description?: React.ReactNode;
-	placeholder?: string;
-}
-
-function FilterTextField({
-	label,
-	id: providedId,
-	description,
-	placeholder,
-	type = "text",
-	...props
-}: FilterTextFieldProps) {
-	const field = useFieldContext<string>();
-	const generatedId = useId();
-	const id = providedId ?? generatedId;
-	const descriptionId = `${id}-description`;
-	const errorId = `${id}-error`;
-	const isInvalid = field.state.meta.isTouched && field.state.meta.errors.length > 0;
-
-	const uniqueErrors = getUniqueErrors(field.state.meta.errors);
-
-	return (
-		<Field data-invalid={isInvalid}>
-			<FieldLabel htmlFor={id}>{label}</FieldLabel>
-			{description && <FieldDescription id={descriptionId}>{description}</FieldDescription>}
-			<Input
-				id={id}
-				name={field.name as string}
-				type={type}
-				value={field.state.value ?? ""}
-				onBlur={field.handleBlur}
-				onChange={(e: React.ChangeEvent<HTMLInputElement>) => field.handleChange(e.target.value)}
-				placeholder={placeholder}
-				aria-invalid={isInvalid}
-				aria-describedby={cn(description && descriptionId, isInvalid && errorId)}
-				{...props}
-			/>
-			{isInvalid && uniqueErrors.length > 0 && <FieldError errors={uniqueErrors} />}
-		</Field>
-	);
-}
-
-interface FilterSelectFieldProps {
-	label: string;
-	id?: string;
-	description?: React.ReactNode;
-	placeholder?: string;
-	options: PicklistValue[];
-}
-
-function FilterSelectField({
-	label,
-	id: providedId,
-	description,
-	placeholder = "Select...",
-	options,
-}: FilterSelectFieldProps) {
-	const field = useFieldContext<string>();
-	const generatedId = useId();
-	const id = providedId ?? generatedId;
-	const descriptionId = `${id}-description`;
-	const errorId = `${id}-error`;
-	const isInvalid = field.state.meta.isTouched && field.state.meta.errors.length > 0;
-
-	const uniqueErrors = getUniqueErrors(field.state.meta.errors);
-
-	return (
-		<Field data-invalid={isInvalid}>
-			<FieldLabel htmlFor={id}>{label}</FieldLabel>
-			{description && <FieldDescription id={descriptionId}>{description}</FieldDescription>}
-			<Select value={field.state.value ?? ""} onValueChange={(value) => field.handleChange(value)}>
-				<SelectTrigger
-					id={id}
-					aria-invalid={isInvalid}
-					aria-describedby={cn(description && descriptionId, isInvalid && errorId)}
-				>
-					<SelectValue placeholder={placeholder} />
-				</SelectTrigger>
-				<SelectContent>
-					{options.map((option) => {
-						if (!option || !option.value) return null;
-						return (
-							<SelectItem key={option.value} value={option.value}>
-								{option.label || option.value}
-							</SelectItem>
-						);
-					})}
-				</SelectContent>
-			</Select>
-			{isInvalid && uniqueErrors.length > 0 && <FieldError errors={uniqueErrors} />}
-		</Field>
-	);
-}
-
-interface FilterRangeFieldProps extends Omit<
-	React.ComponentProps<typeof Input>,
-	"name" | "value" | "onBlur" | "onChange" | "aria-invalid"
-> {
-	label?: string;
-	description?: React.ReactNode;
-	placeholder?: string;
-}
-
-function FilterRangeFieldBase({
-	label,
-	id: providedId,
-	description,
-	placeholder,
-	type = "text",
-	...props
-}: FilterRangeFieldProps) {
-	const field = useFieldContext<string>();
-	const generatedId = useId();
-	const id = providedId ?? generatedId;
-	const descriptionId = `${id}-description`;
-	const errorId = `${id}-error`;
-	const isInvalid = field.state.meta.isTouched && field.state.meta.errors.length > 0;
-
-	const uniqueErrors = getUniqueErrors(field.state.meta.errors);
-
-	return (
-		<div>
-			{label && <FieldLabel htmlFor={id}>{label}</FieldLabel>}
-			{description && <FieldDescription id={descriptionId}>{description}</FieldDescription>}
-			<Input
-				id={id}
-				name={field.name as string}
-				type={type}
-				value={field.state.value ?? ""}
-				onBlur={field.handleBlur}
-				onChange={(e: React.ChangeEvent<HTMLInputElement>) => field.handleChange(e.target.value)}
-				placeholder={placeholder}
-				aria-invalid={isInvalid}
-				aria-describedby={cn(description && descriptionId, isInvalid && errorId)}
-				{...props}
-			/>
-			{isInvalid && uniqueErrors.length > 0 && <FieldError errors={uniqueErrors} />}
-		</div>
-	);
-}
-
-interface FilterRangeMinFieldProps extends Omit<
-	React.ComponentProps<typeof Input>,
-	"name" | "value" | "onBlur" | "onChange" | "aria-invalid"
-> {
-	label?: string;
-	description?: React.ReactNode;
-	placeholder?: string;
-}
-
-interface FilterRangeMaxFieldProps extends Omit<
-	React.ComponentProps<typeof Input>,
-	"name" | "value" | "onBlur" | "onChange" | "aria-invalid"
-> {
-	label?: string;
-	description?: React.ReactNode;
-	placeholder?: string;
-}
-
-function FilterRangeMinField({ placeholder = "Min", ...props }: FilterRangeMinFieldProps) {
-	return <FilterRangeFieldBase placeholder={placeholder} {...props} />;
-}
-
-function FilterRangeMaxField({ placeholder = "Max", ...props }: FilterRangeMaxFieldProps) {
-	return <FilterRangeFieldBase placeholder={placeholder} {...props} />;
-}
-
-export const { useAppForm } = createFormHook({
-	fieldContext,
-	formContext,
-	fieldComponents: {
-		FilterTextField,
-		FilterSelectField,
-		FilterRangeMinField,
-		FilterRangeMaxField,
-	},
-	formComponents: {},
-});

package/lib/templates/project/reactb2e/_p_/_m_/_w_/_a_/src/_f_/_gs_/hooks/useObjectInfoBatch.ts

@@ -1,65 +0,0 @@
-/**
- * useObjectInfoBatch
- *
- * Fetches object metadata (label, labelPlural, fields, etc.) for the given object API names.
- * Uses the shared cache in objectInfoService so List, Home, and Detail views reuse one request.
- */
-
-import { useState, useEffect, useRef } from "react";
-import { objectInfoService } from "../api/objectInfoService";
-import type { ObjectInfoResult } from "../types/objectInfo/objectInfo";
-
-export interface UseObjectInfoBatchResult {
-	/** Object metadata in the same order as the requested objectApiNames. */
-	objectInfos: ObjectInfoResult[];
-	loading: boolean;
-	error: string | null;
-}
-
-/**
- * Fetches batch object info for the given object API names. Results are cached;
- * multiple callers (List, Home, Detail) share the same request.
- *
- * @param objectApiNames - Array of object API names (e.g. OBJECT_API_NAMES)
- * @returns objectInfos (same order as input), loading, error
- */
-export function useObjectInfoBatch(objectApiNames: string[]): UseObjectInfoBatchResult {
-	const [state, setState] = useState<UseObjectInfoBatchResult>({
-		objectInfos: [],
-		loading: objectApiNames.length > 0,
-		error: null,
-	});
-	const isCancelled = useRef(false);
-
-	useEffect(() => {
-		isCancelled.current = false;
-		const names = objectApiNames.filter(Boolean);
-		if (names.length === 0) {
-			setState({ objectInfos: [], loading: false, error: null });
-			return;
-		}
-		setState((s) => ({ ...s, loading: true, error: null }));
-		objectInfoService
-			.getObjectInfoBatch(names.join(","))
-			.then((res) => {
-				if (isCancelled.current) return;
-				const objectInfos = names
-					.map((apiName) => res.results?.find((r) => r.result?.ApiName === apiName)?.result)
-					.filter((r) => r != null) as ObjectInfoResult[];
-				setState({ objectInfos, loading: false, error: null });
-			})
-			.catch((err) => {
-				if (isCancelled.current) return;
-				setState({
-					objectInfos: [],
-					loading: false,
-					error: err instanceof Error ? err.message : (err as string),
-				});
-			});
-		return () => {
-			isCancelled.current = true;
-		};
-	}, [objectApiNames.join(",")]);
-
-	return state;
-}

package/lib/templates/project/reactb2e/_p_/_m_/_w_/_a_/src/_f_/_gs_/hooks/useObjectSearchData.ts

@@ -1,174 +0,0 @@
-/**
- * Object Search Data Hooks
- *
- * - useObjectListMetadata: single source for list-view metadata (filters → columns + picklists). Use in list pages to avoid duplicate state and API calls.
- * - useObjectColumns / useObjectFilters: thin wrappers over useObjectListMetadata for backward compatibility.
- * - getSharedFilters: module-level deduplication for getObjectListFilters across hook instances.
- */
-
-import { useState, useEffect } from "react";
-import { objectInfoService } from "../api/objectInfoService";
-import type { Column } from "../types/search/searchResults";
-import type { Filter } from "../types/filters/filters";
-import type { PicklistValue } from "../types/filters/picklist";
-
-// --- Shared filters cache (deduplicates getObjectListFilters across useObjectColumns + useObjectFilters) ---
-const sharedFiltersCache = new Map<string, Filter[]>();
-const sharedFiltersInFlight = new Map<string, Promise<Filter[]>>();
-
-function getSharedFilters(objectApiName: string): Promise<Filter[]> {
-	const cached = sharedFiltersCache.get(objectApiName);
-	if (cached) return Promise.resolve(cached);
-	const inFlight = sharedFiltersInFlight.get(objectApiName);
-	if (inFlight) return inFlight;
-	const promise = objectInfoService
-		.getObjectListFilters(objectApiName)
-		.then((filters) => {
-			sharedFiltersCache.set(objectApiName, filters);
-			sharedFiltersInFlight.delete(objectApiName);
-			return filters;
-		})
-		.catch((err) => {
-			sharedFiltersInFlight.delete(objectApiName);
-			throw err;
-		});
-	sharedFiltersInFlight.set(objectApiName, promise);
-	return promise;
-}
-
-// --- Shared Types ---
-export interface FiltersData {
-	filters: Filter[];
-	picklistValues: Record<string, PicklistValue[]>;
-	loading: boolean;
-	error: string | null;
-}
-
-/**
- * Derives column definitions from filter definitions for list/result UI.
- */
-function filtersToColumns(filters: Filter[]): Column[] {
-	return filters.map((f) => ({
-		fieldApiName: f.targetFieldPath,
-		label: f.label,
-		searchable: true,
-		sortable: true,
-	}));
-}
-
-export interface ObjectListMetadata {
-	columns: Column[];
-	filters: Filter[];
-	picklistValues: Record<string, PicklistValue[]>;
-	loading: boolean;
-	error: string | null;
-}
-
-/**
- * Single hook for list-view metadata: filters (shared API), derived columns, and picklist values.
- * Use this in list/search pages to avoid duplicate useObjectColumns + useObjectFilters and duplicate state.
- */
-export function useObjectListMetadata(objectApiName: string | null): ObjectListMetadata {
-	const [state, setState] = useState<{
-		columns: Column[];
-		filters: Filter[];
-		picklistValues: Record<string, PicklistValue[]>;
-		loading: boolean;
-		error: string | null;
-	}>({
-		columns: [],
-		filters: [],
-		picklistValues: {},
-		loading: true,
-		error: null,
-	});
-
-	useEffect(() => {
-		if (!objectApiName) {
-			setState((s) => ({ ...s, loading: false, error: "Invalid object" }));
-			return;
-		}
-
-		let isCancelled = false;
-
-		const run = async () => {
-			setState((s) => ({ ...s, loading: true, error: null }));
-			try {
-				const filters = await getSharedFilters(objectApiName!);
-				if (isCancelled) return;
-
-				const selectFilters = filters.filter((f) => f.affordance?.toLowerCase() === "select");
-				const picklistPromises = selectFilters.map((f) =>
-					objectInfoService
-						.getPicklistValues(objectApiName!, f.targetFieldPath)
-						.then((values) => ({ fieldPath: f.targetFieldPath, values }))
-						.catch(() => ({ fieldPath: f.targetFieldPath, values: [] as PicklistValue[] })),
-				);
-				const picklistResults = await Promise.all(picklistPromises);
-				if (isCancelled) return;
-
-				const picklistValues: Record<string, PicklistValue[]> = {};
-				picklistResults.forEach(({ fieldPath, values }) => {
-					picklistValues[fieldPath] = values;
-				});
-
-				setState({
-					columns: filtersToColumns(filters),
-					filters,
-					picklistValues,
-					loading: false,
-					error: null,
-				});
-			} catch (err) {
-				if (isCancelled) return;
-				setState((s) => ({
-					...s,
-					columns: [],
-					filters: [],
-					picklistValues: {},
-					loading: false,
-					error: "Failed to load list metadata",
-				}));
-			}
-		};
-
-		run();
-		return () => {
-			isCancelled = true;
-		};
-	}, [objectApiName]);
-
-	return state;
-}
-
-/**
- * Hook: useObjectColumns
- * Thin wrapper over useObjectListMetadata for backward compatibility.
- */
-export function useObjectColumns(objectApiName: string | null) {
-	const { columns, loading, error } = useObjectListMetadata(objectApiName);
-	return {
-		columns: objectApiName ? columns : [],
-		columnsLoading: loading,
-		columnsError: error,
-	};
-}
-
-/**
- * Hook: useObjectFilters
- * Thin wrapper over useObjectListMetadata for backward compatibility.
- */
-export function useObjectFilters(objectApiName: string | null) {
-	const { filters, picklistValues, loading, error } = useObjectListMetadata(objectApiName);
-	const filtersData: Record<string, FiltersData> = objectApiName
-		? {
-				[objectApiName]: {
-					filters,
-					picklistValues,
-					loading,
-					error,
-				},
-			}
-		: {};
-	return { filtersData };
-}