@salesforce/templates 66.5.4 → 66.5.6

package/lib/templates/project/reactb2x/_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/reactb2x/_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/reactb2x/_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 };
-}

package/lib/templates/project/reactb2x/_p_/_m_/_w_/_a_/src/_f_/_gs_/hooks/useRecordDetailLayout.ts

@@ -1,137 +0,0 @@
-import { useState, useEffect, useRef } from "react";
-import { objectDetailService } from "../api/objectDetailService";
-import type { LayoutResponse } from "../types/recordDetail/recordDetail";
-import type { ObjectInfoResult } from "../types/objectInfo/objectInfo";
-import type { GraphQLRecordNode } from "../api/recordListGraphQLService";
-
-export interface UseRecordDetailLayoutReturn {
-	layout: LayoutResponse | null;
-	record: GraphQLRecordNode | null;
-	objectMetadata: ObjectInfoResult | null;
-	loading: boolean;
-	error: string | null;
-}
-
-export interface UseRecordDetailLayoutParams {
-	objectApiName: string | null;
-	recordId: string | null;
-	recordTypeId?: string | null;
-	initialData?: {
-		layout: LayoutResponse;
-		record: GraphQLRecordNode;
-		objectMetadata: ObjectInfoResult;
-	} | null;
-}
-
-const MAX_CACHE_SIZE = 50;
-const CACHE_TTL_MS = 5 * 60 * 1000;
-
-type CacheEntry = {
-	layout: LayoutResponse;
-	record: GraphQLRecordNode;
-	objectMetadata: ObjectInfoResult;
-	cachedAt: number;
-};
-
-export function useRecordDetailLayout({
-	objectApiName,
-	recordId,
-	recordTypeId = null,
-	initialData = null,
-}: UseRecordDetailLayoutParams): UseRecordDetailLayoutReturn {
-	const [layout, setLayout] = useState<LayoutResponse | null>(initialData?.layout ?? null);
-	const [record, setRecord] = useState<GraphQLRecordNode | null>(initialData?.record ?? null);
-	const [objectMetadata, setObjectMetadata] = useState<ObjectInfoResult | null>(
-		initialData?.objectMetadata ?? null,
-	);
-	const [loading, setLoading] = useState(!initialData);
-	const [error, setError] = useState<string | null>(null);
-
-	const cacheKey =
-		objectApiName && recordId ? `${objectApiName}:${recordId}:${recordTypeId ?? "default"}` : null;
-	const cacheRef = useRef<Map<string, CacheEntry>>(new Map());
-
-	useEffect(() => {
-		if (!objectApiName || !recordId) {
-			setError("Invalid object or record ID");
-			setLoading(false);
-			return;
-		}
-
-		if (
-			initialData?.layout != null &&
-			initialData?.record != null &&
-			initialData?.objectMetadata != null
-		) {
-			return;
-		}
-
-		const cached = cacheRef.current.get(cacheKey!);
-		const now = Date.now();
-		if (cached && now - cached.cachedAt < CACHE_TTL_MS) {
-			setLayout(cached.layout);
-			setRecord(cached.record);
-			setObjectMetadata(cached.objectMetadata);
-			setLoading(false);
-			setError(null);
-			return;
-		}
-
-		let isCancelled = false;
-
-		const fetchDetail = async () => {
-			setLoading(true);
-			setError(null);
-
-			try {
-				const {
-					layout: layoutData,
-					record: recordData,
-					objectMetadata: objectMetadataData,
-				} = await objectDetailService.getRecordDetail(
-					objectApiName,
-					recordId,
-					recordTypeId ?? undefined,
-				);
-
-				if (isCancelled) return;
-
-				const cache = cacheRef.current;
-				if (cache.size >= MAX_CACHE_SIZE) {
-					const firstKey = cache.keys().next().value;
-					if (firstKey != null) cache.delete(firstKey);
-				}
-				cache.set(cacheKey!, {
-					layout: layoutData,
-					record: recordData,
-					objectMetadata: objectMetadataData,
-					cachedAt: Date.now(),
-				});
-				setLayout(layoutData);
-				setRecord(recordData);
-				setObjectMetadata(objectMetadataData);
-			} catch (err) {
-				if (isCancelled) return;
-				setError("Failed to load record details");
-			} finally {
-				if (!isCancelled) {
-					setLoading(false);
-				}
-			}
-		};
-
-		fetchDetail();
-
-		return () => {
-			isCancelled = true;
-		};
-	}, [objectApiName, recordId, recordTypeId, cacheKey, initialData]);
-
-	return {
-		layout,
-		record,
-		objectMetadata,
-		loading,
-		error,
-	};
-}