@salesforce/ui-bundle-template-app-react-template-b2x 11.18.0 → 11.20.0

package/dist/force-app/main/default/uiBundles/reactexternalapp/src/features/object-search/components/filters/NumericRangeFilter.tsx

@@ -1,171 +0,0 @@
-import { useId, useState } from "react";
-import { Input } from "../../../../components/ui/input";
-
-import { useFilterField } from "../FilterContext";
-import { useDebouncedCallback } from "../../hooks/useDebouncedCallback";
-import { FilterFieldWrapper } from "./FilterFieldWrapper";
-import type { ActiveFilterValue } from "../../utils/filterUtils";
-
-interface NumericRangeFilterProps extends Omit<React.ComponentProps<"div">, "onChange"> {
-	field: string;
-	label: string;
-	helpText?: string;
-	min?: number;
-	max?: number;
-}
-
-export function NumericRangeFilter({
-	field,
-	label,
-	helpText,
-	min,
-	max,
-	className,
-	...props
-}: NumericRangeFilterProps) {
-	const { value, onChange } = useFilterField(field);
-	return (
-		<NumericRangeFilterInputs
-			field={field}
-			label={label}
-			helpText={helpText}
-			value={value}
-			onChange={onChange}
-			min={min}
-			max={max}
-			className={className}
-			{...props}
-		/>
-	);
-}
-
-interface NumericRangeFilterInputsProps extends Omit<React.ComponentProps<"div">, "onChange"> {
-	field: string;
-	label: string;
-	helpText?: string;
-	value: ActiveFilterValue | undefined;
-	onChange: (value: ActiveFilterValue | undefined) => void;
-	min?: number;
-	max?: number;
-	minInputProps?: React.ComponentProps<typeof Input>;
-	maxInputProps?: React.ComponentProps<typeof Input>;
-}
-
-export function NumericRangeFilterInputs({
-	field,
-	label,
-	helpText,
-	value,
-	onChange,
-	min: boundMin,
-	max: boundMax,
-	className,
-	...props
-}: NumericRangeFilterInputsProps) {
-	const errorId = useId();
-	const [localMin, setLocalMin] = useState(value?.min ?? "");
-	const [localMax, setLocalMax] = useState(value?.max ?? "");
-
-	const externalMin = value?.min ?? "";
-	const externalMax = value?.max ?? "";
-	const [prevExternalMin, setPrevExternalMin] = useState(externalMin);
-	const [prevExternalMax, setPrevExternalMax] = useState(externalMax);
-	if (prevExternalMin !== externalMin) {
-		setPrevExternalMin(externalMin);
-		setLocalMin(externalMin);
-	}
-	if (prevExternalMax !== externalMax) {
-		setPrevExternalMax(externalMax);
-		setLocalMax(externalMax);
-	}
-
-	const isOutOfBounds = (v: string) => {
-		if (v === "") return false;
-		const n = Number(v);
-		return (boundMin != null && n < boundMin) || (boundMax != null && n > boundMax);
-	};
-	const minOutOfBounds = isOutOfBounds(localMin);
-	const maxOutOfBounds = isOutOfBounds(localMax);
-	const isRangeInverted = localMin !== "" && localMax !== "" && Number(localMin) > Number(localMax);
-	const hasError = minOutOfBounds || maxOutOfBounds || isRangeInverted;
-
-	const debouncedOnChange = useDebouncedCallback((min: string, max: string) => {
-		if (!min && !max) {
-			onChange(undefined);
-			return;
-		}
-		const minNum = min !== "" ? Number(min) : null;
-		const maxNum = max !== "" ? Number(max) : null;
-		if (minNum != null && maxNum != null && minNum > maxNum) return;
-		if (
-			minNum != null &&
-			((boundMin != null && minNum < boundMin) || (boundMax != null && minNum > boundMax))
-		)
-			return;
-		if (
-			maxNum != null &&
-			((boundMin != null && maxNum < boundMin) || (boundMax != null && maxNum > boundMax))
-		)
-			return;
-		onChange({ field, label, type: "numeric" as const, min, max });
-	});
-
-	const boundsLabel =
-		boundMin != null && boundMax != null
-			? `${boundMin}–${boundMax}`
-			: boundMin != null
-				? `${boundMin} or more`
-				: boundMax != null
-					? `${boundMax} or less`
-					: null;
-
-	const errorMessage = isRangeInverted
-		? "Min must not exceed max"
-		: (minOutOfBounds || maxOutOfBounds) && boundsLabel
-			? `Value must be between ${boundsLabel}`
-			: undefined;
-
-	return (
-		<FilterFieldWrapper
-			label={label}
-			helpText={helpText}
-			error={errorMessage}
-			errorId={errorId}
-			className={className}
-			{...props}
-		>
-			<div className="flex gap-2">
-				<Input
-					type="number"
-					placeholder="Min"
-					value={localMin}
-					min={boundMin}
-					max={boundMax}
-					onChange={(e) => {
-						const v = e.target.value;
-						setLocalMin(v);
-						debouncedOnChange(v, localMax);
-					}}
-					aria-label={`${label} minimum`}
-					aria-invalid={hasError || undefined}
-					aria-describedby={hasError ? errorId : undefined}
-				/>
-				<Input
-					type="number"
-					placeholder="Max"
-					value={localMax}
-					min={boundMin}
-					max={boundMax}
-					onChange={(e) => {
-						const v = e.target.value;
-						setLocalMax(v);
-						debouncedOnChange(localMin, v);
-					}}
-					aria-label={`${label} maximum`}
-					aria-invalid={hasError || undefined}
-					aria-describedby={hasError ? errorId : undefined}
-				/>
-			</div>
-		</FilterFieldWrapper>
-	);
-}

package/dist/force-app/main/default/uiBundles/reactexternalapp/src/features/object-search/components/filters/SearchFilter.tsx

@@ -1,52 +0,0 @@
-import { useState } from "react";
-
-import { SearchBar } from "../SearchBar";
-import { useFilterField } from "../FilterContext";
-import { FilterFieldWrapper } from "./FilterFieldWrapper";
-import { useDebouncedCallback } from "../../hooks/useDebouncedCallback";
-
-interface SearchFilterProps extends Omit<React.ComponentProps<"div">, "onChange"> {
-	field: string;
-	label: string;
-	placeholder?: string;
-}
-
-export function SearchFilter({
-	field,
-	label,
-	placeholder,
-	className,
-	...props
-}: SearchFilterProps) {
-	const { value, onChange } = useFilterField(field);
-	const [localValue, setLocalValue] = useState(value?.value ?? "");
-
-	const externalValue = value?.value ?? "";
-	const [prevExternalValue, setPrevExternalValue] = useState(externalValue);
-	if (prevExternalValue !== externalValue) {
-		setPrevExternalValue(externalValue);
-		setLocalValue(externalValue);
-	}
-
-	const debouncedOnChange = useDebouncedCallback((v: string) => {
-		if (v) {
-			onChange({ field, label, type: "search", value: v });
-		} else {
-			onChange(undefined);
-		}
-	});
-
-	return (
-		<FilterFieldWrapper label={label} htmlFor={`filter-${field}`} className={className} {...props}>
-			<SearchBar
-				value={localValue}
-				handleChange={(v) => {
-					setLocalValue(v);
-					debouncedOnChange(v);
-				}}
-				placeholder={placeholder}
-				inputProps={{ id: `filter-${field}` }}
-			/>
-		</FilterFieldWrapper>
-	);
-}

package/dist/force-app/main/default/uiBundles/reactexternalapp/src/features/object-search/components/filters/SelectFilter.tsx

@@ -1,97 +0,0 @@
-import {
-	Select,
-	SelectContent,
-	SelectItem,
-	SelectTrigger,
-	SelectValue,
-} from "../../../../components/ui/select";
-import { cn } from "../../../../lib/utils";
-import { useFilterField } from "../FilterContext";
-import { FilterFieldWrapper } from "./FilterFieldWrapper";
-import type { ActiveFilterValue } from "../../utils/filterUtils";
-
-const ALL_VALUE = "__all__";
-
-interface SelectFilterProps extends Omit<React.ComponentProps<"div">, "onChange"> {
-	field: string;
-	label: string;
-	options: Array<{ value: string; label: string }>;
-	helpText?: string;
-}
-
-export function SelectFilter({
-	field,
-	label,
-	options,
-	helpText,
-	className,
-	...props
-}: SelectFilterProps) {
-	const { value, onChange } = useFilterField(field);
-	return (
-		<FilterFieldWrapper
-			label={label}
-			htmlFor={`filter-${field}`}
-			helpText={helpText}
-			className={className}
-			{...props}
-		>
-			<SelectFilterControl
-				field={field}
-				label={label}
-				options={options}
-				value={value}
-				onChange={onChange}
-			/>
-		</FilterFieldWrapper>
-	);
-}
-
-interface SelectFilterControlProps {
-	field: string;
-	label: string;
-	options: Array<{ value: string; label: string }>;
-	value: ActiveFilterValue | undefined;
-	onChange: (value: ActiveFilterValue | undefined) => void;
-	triggerProps?: React.ComponentProps<typeof SelectTrigger>;
-	contentProps?: React.ComponentProps<typeof SelectContent>;
-}
-
-export function SelectFilterControl({
-	field,
-	label,
-	options,
-	value,
-	onChange,
-	triggerProps,
-	contentProps,
-}: SelectFilterControlProps) {
-	return (
-		<Select
-			value={value?.value ?? ALL_VALUE}
-			onValueChange={(v) => {
-				if (v === ALL_VALUE) {
-					onChange(undefined);
-				} else {
-					onChange({ field, label, type: "picklist", value: v });
-				}
-			}}
-		>
-			<SelectTrigger
-				id={`filter-${field}`}
-				{...triggerProps}
-				className={cn("w-full", triggerProps?.className)}
-			>
-				<SelectValue placeholder={`Select ${label.toLowerCase()}`} />
-			</SelectTrigger>
-			<SelectContent {...contentProps}>
-				<SelectItem value={ALL_VALUE}>All</SelectItem>
-				{options.map((opt) => (
-					<SelectItem key={opt.value} value={opt.value}>
-						{opt.label}
-					</SelectItem>
-				))}
-			</SelectContent>
-		</Select>
-	);
-}

package/dist/force-app/main/default/uiBundles/reactexternalapp/src/features/object-search/components/filters/TextFilter.tsx

@@ -1,93 +0,0 @@
-import { useState } from "react";
-import { Input } from "../../../../components/ui/input";
-import { cn } from "../../../../lib/utils";
-import { useFilterField } from "../FilterContext";
-import { FilterFieldWrapper } from "./FilterFieldWrapper";
-import { useDebouncedCallback } from "../../hooks/useDebouncedCallback";
-import type { ActiveFilterValue } from "../../utils/filterUtils";
-
-interface TextFilterProps extends Omit<React.ComponentProps<"div">, "onChange"> {
-	field: string;
-	label: string;
-	placeholder?: string;
-	helpText?: string;
-}
-
-export function TextFilter({
-	field,
-	label,
-	placeholder,
-	helpText,
-	className,
-	...props
-}: TextFilterProps) {
-	const { value, onChange } = useFilterField(field);
-	return (
-		<FilterFieldWrapper
-			label={label}
-			htmlFor={`filter-${field}`}
-			helpText={helpText}
-			className={className}
-			{...props}
-		>
-			<TextFilterInput
-				field={field}
-				label={label}
-				placeholder={placeholder}
-				value={value}
-				onChange={onChange}
-			/>
-		</FilterFieldWrapper>
-	);
-}
-
-interface TextFilterInputProps extends Omit<
-	React.ComponentProps<typeof Input>,
-	"onChange" | "value"
-> {
-	field: string;
-	label: string;
-	value: ActiveFilterValue | undefined;
-	onChange: (value: ActiveFilterValue | undefined) => void;
-}
-
-export function TextFilterInput({
-	field,
-	label,
-	value,
-	onChange,
-	className,
-	...props
-}: TextFilterInputProps) {
-	const [localValue, setLocalValue] = useState(value?.value ?? "");
-
-	const externalValue = value?.value ?? "";
-	const [prevExternalValue, setPrevExternalValue] = useState(externalValue);
-	if (prevExternalValue !== externalValue) {
-		setPrevExternalValue(externalValue);
-		setLocalValue(externalValue);
-	}
-
-	const debouncedOnChange = useDebouncedCallback((v: string) => {
-		if (v) {
-			onChange({ field, label, type: "text", value: v });
-		} else {
-			onChange(undefined);
-		}
-	});
-
-	return (
-		<Input
-			id={`filter-${field}`}
-			type="text"
-			placeholder={props.placeholder ?? `Filter by ${label.toLowerCase()}...`}
-			value={localValue}
-			onChange={(e) => {
-				setLocalValue(e.target.value);
-				debouncedOnChange(e.target.value);
-			}}
-			className={cn(className)}
-			{...props}
-		/>
-	);
-}

package/dist/force-app/main/default/uiBundles/reactexternalapp/src/features/object-search/hooks/useDebouncedCallback.ts

@@ -1,34 +0,0 @@
-import { useCallback, useEffect, useRef } from "react";
-import { debounce, FILTER_DEBOUNCE_MS } from "../utils/debounce";
-
-/**
- * Returns a stable debounced wrapper around the provided callback.
- *
- * The wrapper always invokes the *latest* version of `fn` (via a ref),
- * so the debounce timer is never reset when `fn` changes — only when
- * the caller invokes the returned function again.
- *
- * @param fn - The callback to debounce.
- * @param delay - Debounce delay in ms. Defaults to `FILTER_DEBOUNCE_MS`.
- */
-export function useDebouncedCallback<T extends (...args: any[]) => void>(
-	fn: T,
-	delay: number = FILTER_DEBOUNCE_MS,
-): (...args: Parameters<T>) => void {
-	const fnRef = useRef(fn);
-	const debouncedRef = useRef<((...args: any[]) => void) | null>(null);
-
-	useEffect(() => {
-		fnRef.current = fn;
-	});
-
-	useEffect(() => {
-		debouncedRef.current = debounce((...args: any[]) => {
-			fnRef.current(...(args as Parameters<T>));
-		}, delay);
-	}, [delay]);
-
-	return useCallback((...args: Parameters<T>) => {
-		debouncedRef.current?.(...args);
-	}, []);
-}

package/dist/force-app/main/default/uiBundles/reactexternalapp/src/features/object-search/hooks/useObjectSearchParams.ts

@@ -1,254 +0,0 @@
-import { useCallback, useEffect, useMemo, useRef, useState } from "react";
-import { useSearchParams } from "react-router";
-import type { FilterFieldConfig, ActiveFilterValue } from "../utils/filterUtils";
-import type { SortFieldConfig, SortState } from "../utils/sortUtils";
-import { filtersToSearchParams, searchParamsToFilters, buildFilter } from "../utils/filterUtils";
-import { buildOrderBy } from "../utils/sortUtils";
-import { debounce } from "../utils/debounce";
-
-/** How long to wait before flushing local state changes to the URL. */
-const URL_SYNC_DEBOUNCE_MS = 300;
-
-export interface PaginationConfig {
-	defaultPageSize: number;
-	validPageSizes: number[];
-}
-
-export interface UseObjectSearchParamsReturn<TFilter, TOrderBy> {
-	filters: {
-		active: ActiveFilterValue[];
-		set: (field: string, value: ActiveFilterValue | undefined) => void;
-		remove: (field: string) => void;
-	};
-	sort: {
-		current: SortState | null;
-		set: (sort: SortState | null) => void;
-	};
-	query: { where: TFilter; orderBy: TOrderBy };
-	pagination: {
-		pageSize: number;
-		pageIndex: number;
-		afterCursor: string | undefined;
-		setPageSize: (size: number) => void;
-		goToNextPage: (cursor: string) => void;
-		goToPreviousPage: () => void;
-	};
-	resetAll: () => void;
-}
-
-/**
- * Manages filter, sort, and cursor-based pagination state for an object search page.
- *
- * ## State model
- * Local React state is the primary driver for instant UI updates.
- * URL search params act as the durable source of truth so that a page
- * refresh or shared link restores the same view. Changes are synced to
- * the URL via a debounced write (300 ms) to avoid excessive history entries.
- *
- * ## Return shape
- * Returns memoized groups so each group's reference is stable unless its
- * contents change — safe to pass directly as props to `React.memo` children.
- *
- * - `filters`    — active filter values + set/remove callbacks
- * - `sort`       — current sort state + set callback
- * - `query`      — derived `where` / `orderBy` objects ready for the API
- * - `pagination` — page size, page index, cursor, and navigation callbacks
- * - `resetAll`   — clears all filters, sort, and pagination in one call
- */
-export function useObjectSearchParams<TFilter, TOrderBy>(
-	filterConfigs: FilterFieldConfig[],
-	_sortConfigs?: SortFieldConfig[],
-	paginationConfig?: PaginationConfig,
-) {
-	const defaultPageSize = paginationConfig?.defaultPageSize ?? 10;
-	const validPageSizes = useMemo(
-		() => paginationConfig?.validPageSizes ?? [defaultPageSize],
-		[paginationConfig?.validPageSizes, defaultPageSize],
-	);
-	const [searchParams, setSearchParams] = useSearchParams();
-
-	// Seed local state from URL on initial load
-	const initial = useMemo(
-		() => searchParamsToFilters(searchParams, filterConfigs),
-		// Only run on mount — local state takes over after that, no deps needed
-		// eslint-disable-next-line react-hooks/exhaustive-deps
-		[],
-	);
-
-	const [filters, setFilters] = useState<ActiveFilterValue[]>(initial.filters);
-	const [sort, setLocalSort] = useState<SortState | null>(initial.sort);
-
-	// Pagination — cursor-based with a stack to support "previous page" navigation.
-	const getValidPageSize = useCallback(
-		(size: number) => (validPageSizes.includes(size) ? size : defaultPageSize),
-		[validPageSizes, defaultPageSize],
-	);
-
-	const [pageSize, setPageSizeState] = useState<number>(
-		getValidPageSize(initial.pageSize ?? defaultPageSize),
-	);
-	const [pageIndex, setPageIndex] = useState(initial.pageIndex);
-	const [afterCursor, setAfterCursor] = useState<string | undefined>(undefined);
-	const cursorStackRef = useRef<string[]>([]);
-
-	// Debounced URL sync — keeps URL in sync without blocking the UI
-	const syncToUrl = useCallback(
-		(
-			nextFilters: ActiveFilterValue[],
-			nextSort: SortState | null,
-			nextPageSize?: number,
-			nextPageIndex?: number,
-		) => {
-			const params = filtersToSearchParams(nextFilters, nextSort, nextPageSize, nextPageIndex);
-			setSearchParams(params, { replace: true });
-		},
-		[setSearchParams],
-	);
-
-	const debouncedSyncRef = useRef(debounce(syncToUrl, URL_SYNC_DEBOUNCE_MS));
-	useEffect(() => {
-		debouncedSyncRef.current = debounce(syncToUrl, URL_SYNC_DEBOUNCE_MS);
-	}, [syncToUrl]);
-
-	// Snapshot ref — lets callbacks read the latest state without being
-	// recreated on every render (avoids infinite useCallback chains).
-	const stateRef = useRef({ filters, sort, pageSize, pageIndex });
-	useEffect(() => {
-		stateRef.current = { filters, sort, pageSize, pageIndex };
-	});
-
-	// Any filter/sort change resets pagination to the first page.
-	const resetPagination = useCallback(() => {
-		setPageIndex(0);
-		setAfterCursor(undefined);
-		cursorStackRef.current = [];
-	}, []);
-
-	// -- Filter callbacks -------------------------------------------------------
-
-	const setFilter = useCallback(
-		(field: string, value: ActiveFilterValue | undefined) => {
-			const { sort: s, pageSize: ps } = stateRef.current;
-			setFilters((prev) => {
-				const next = prev.filter((f) => f.field !== field);
-				if (value) next.push(value);
-				debouncedSyncRef.current(next, s, ps);
-				return next;
-			});
-			resetPagination();
-		},
-		[resetPagination],
-	);
-
-	const removeFilter = useCallback(
-		(field: string) => {
-			const { sort: s, pageSize: ps } = stateRef.current;
-			setFilters((prev) => {
-				const next = prev.filter((f) => f.field !== field);
-				debouncedSyncRef.current(next, s, ps);
-				return next;
-			});
-			resetPagination();
-		},
-		[resetPagination],
-	);
-
-	// -- Sort callback ----------------------------------------------------------
-
-	const setSort = useCallback(
-		(nextSort: SortState | null) => {
-			const { filters: f, pageSize: ps } = stateRef.current;
-			setLocalSort(nextSort);
-			debouncedSyncRef.current(f, nextSort, ps);
-			resetPagination();
-		},
-		[resetPagination],
-	);
-
-	// -- Reset ------------------------------------------------------------------
-
-	const resetAll = useCallback(() => {
-		setFilters([]);
-		setLocalSort(null);
-		resetPagination();
-		syncToUrl([], null, defaultPageSize, 0);
-		setPageSizeState(defaultPageSize);
-	}, [syncToUrl, resetPagination, defaultPageSize]);
-
-	// -- Pagination callbacks ---------------------------------------------------
-	// Uses a cursor stack to track visited pages. "Next" pushes the current
-	// endCursor onto the stack; "Previous" pops it to restore the prior cursor.
-
-	const goToNextPage = useCallback((endCursor: string) => {
-		cursorStackRef.current = [...cursorStackRef.current, endCursor];
-		setAfterCursor(endCursor);
-		setPageIndex((prev) => {
-			const nextIndex = prev + 1;
-			const { filters: f, sort: s, pageSize: ps } = stateRef.current;
-			debouncedSyncRef.current(f, s, ps, nextIndex);
-			return nextIndex;
-		});
-	}, []);
-
-	const goToPreviousPage = useCallback(() => {
-		const stack = cursorStackRef.current;
-		const next = stack.slice(0, -1);
-		cursorStackRef.current = next;
-		setAfterCursor(next.length > 0 ? next[next.length - 1] : undefined);
-		setPageIndex((prev) => {
-			const nextIndex = Math.max(0, prev - 1);
-			const { filters: f, sort: s, pageSize: ps } = stateRef.current;
-			debouncedSyncRef.current(f, s, ps, nextIndex);
-			return nextIndex;
-		});
-	}, []);
-
-	const setPageSize = useCallback(
-		(newSize: number) => {
-			const validated = getValidPageSize(newSize);
-			const { filters: f, sort: s } = stateRef.current;
-			setPageSizeState(validated);
-			resetPagination();
-			debouncedSyncRef.current(f, s, validated);
-		},
-		[resetPagination, getValidPageSize],
-	);
-
-	// -- Derived query objects ---------------------------------------------------
-	// Translate local filter/sort state into API-ready `where` and `orderBy`.
-
-	const where = useMemo(
-		() => buildFilter<TFilter>(filters, filterConfigs),
-		[filters, filterConfigs],
-	);
-
-	const orderBy = useMemo(() => buildOrderBy<TOrderBy>(sort), [sort]);
-
-	// -- Memoized return groups -------------------------------------------------
-	// Each group is individually memoized so its object reference stays stable
-	// unless the contained values change. This makes it safe to pass a group
-	// (e.g. `pagination`) directly as props to a React.memo child without
-	// causing unnecessary re-renders.
-
-	const filtersGroup = useMemo(
-		() => ({ active: filters, set: setFilter, remove: removeFilter }),
-		[filters, setFilter, removeFilter],
-	);
-
-	const sortGroup = useMemo(() => ({ current: sort, set: setSort }), [sort, setSort]);
-
-	const query = useMemo(() => ({ where, orderBy }), [where, orderBy]);
-
-	const pagination = useMemo(
-		() => ({ pageSize, pageIndex, afterCursor, setPageSize, goToNextPage, goToPreviousPage }),
-		[pageSize, pageIndex, afterCursor, setPageSize, goToNextPage, goToPreviousPage],
-	);
-
-	return {
-		filters: filtersGroup,
-		sort: sortGroup,
-		query,
-		pagination,
-		resetAll,
-	};
-}