@lobehub/ui 6.0.0-beta.7 → 6.0.0-beta.9

package/es/Table/pipeline/useSelection.mjs

@@ -0,0 +1,302 @@
+import { useEventCallback } from "../../hooks/useEventCallback.mjs";
+import { SELECTION_ALL, SELECTION_INVERT, SELECTION_NONE, conductCheck, convertDataToEntities, flattenData, selectRange } from "./selectionUtils.mjs";
+import { useCallback, useEffect, useMemo, useRef, useState } from "react";
+//#region src/Table/pipeline/useSelection.ts
+const EMPTY_KEYS = [];
+const shallowEqual = (a, b) => {
+	if (a === b) return true;
+	if (!a || !b) return false;
+	const keysA = Object.keys(a);
+	if (keysA.length !== Object.keys(b).length) return false;
+	return keysA.every((key) => Object.is(a[key], b[key]));
+};
+const useStableCheckboxProps = (flattedData, getRowKey, getCheckboxProps) => {
+	const previous = useRef(/* @__PURE__ */ new Map());
+	return useMemo(() => {
+		const next = /* @__PURE__ */ new Map();
+		flattedData.forEach((record, index) => {
+			next.set(getRowKey(record, index), getCheckboxProps?.(record) || {});
+		});
+		const prev = previous.current;
+		if (prev.size === next.size && [...next].every(([key, props]) => prev.has(key) && shallowEqual(prev.get(key), props))) return prev;
+		previous.current = next;
+		return next;
+	}, [
+		flattedData,
+		getRowKey,
+		getCheckboxProps
+	]);
+};
+const useSelection = (config, rowSelection) => {
+	const { checkStrictly = true, defaultSelectedRowKeys, getCheckboxProps, hideSelectAll, onChange: onSelectionChange, onSelect, onSelectAll, onSelectInvert, onSelectMultiple, onSelectNone, preserveSelectedRowKeys, selectedRowKeys, selections, type: selectionType = "checkbox" } = rowSelection || {};
+	const { childrenColumnName, data, getRecordByKey, getRowKey, locale, pageData } = config;
+	const [innerKeys, setInnerKeys] = useState(defaultSelectedRowKeys || EMPTY_KEYS);
+	const mergedKeys = selectedRowKeys ?? innerKeys;
+	const prevIndexRef = useRef(null);
+	const preserveRecordsRef = useRef(/* @__PURE__ */ new Map());
+	const updatePreserveRecordsCache = useCallback((keys) => {
+		if (!preserveSelectedRowKeys) return;
+		const next = /* @__PURE__ */ new Map();
+		keys.forEach((key) => {
+			let record = getRecordByKey(key);
+			if (record === void 0 && preserveRecordsRef.current.has(key)) record = preserveRecordsRef.current.get(key);
+			next.set(key, record);
+		});
+		preserveRecordsRef.current = next;
+	}, [getRecordByKey, preserveSelectedRowKeys]);
+	useEffect(() => {
+		updatePreserveRecordsCache(mergedKeys);
+	}, [mergedKeys, updatePreserveRecordsCache]);
+	const flattedData = useMemo(() => flattenData(childrenColumnName, pageData), [childrenColumnName, pageData]);
+	const keyEntities = useMemo(() => {
+		if (checkStrictly) return null;
+		let convertData = data;
+		if (preserveSelectedRowKeys) {
+			const keySet = new Set(flattedData.map((record) => getRowKey(record)));
+			const preserved = [...preserveRecordsRef.current].filter(([key, record]) => !keySet.has(key) && record !== void 0).map(([, record]) => record);
+			convertData = [...convertData, ...preserved];
+		}
+		return convertDataToEntities(convertData, getRowKey, childrenColumnName);
+	}, [
+		data,
+		getRowKey,
+		checkStrictly,
+		childrenColumnName,
+		preserveSelectedRowKeys,
+		flattedData
+	]);
+	const checkboxPropsMap = useStableCheckboxProps(flattedData, getRowKey, getCheckboxProps);
+	const isCheckboxDisabled = useCallback((record) => {
+		const key = getRowKey(record);
+		const props = checkboxPropsMap.has(key) ? checkboxPropsMap.get(key) : getCheckboxProps?.(record);
+		return Boolean(props?.disabled);
+	}, [
+		checkboxPropsMap,
+		getRowKey,
+		getCheckboxProps
+	]);
+	const [derivedSelectedKeys, derivedHalfSelectedKeys] = useMemo(() => {
+		if (checkStrictly || !keyEntities) return [mergedKeys, []];
+		const { checkedKeys, halfCheckedKeys } = conductCheck(mergedKeys, true, keyEntities, isCheckboxDisabled);
+		return [checkedKeys, halfCheckedKeys];
+	}, [
+		mergedKeys,
+		checkStrictly,
+		keyEntities,
+		isCheckboxDisabled
+	]);
+	const selectedKeySet = useMemo(() => new Set(selectionType === "radio" ? derivedSelectedKeys.slice(0, 1) : derivedSelectedKeys), [derivedSelectedKeys, selectionType]);
+	const halfSelectedKeySet = useMemo(() => new Set(selectionType === "radio" ? [] : derivedHalfSelectedKeys), [derivedHalfSelectedKeys, selectionType]);
+	const enabled = Boolean(rowSelection);
+	const [prevEnabled, setPrevEnabled] = useState(enabled);
+	if (prevEnabled !== enabled) {
+		setPrevEnabled(enabled);
+		if (!enabled) setInnerKeys(EMPTY_KEYS);
+	}
+	const setSelectedKeys = (keys, method) => {
+		let availableKeys;
+		let records;
+		updatePreserveRecordsCache(keys);
+		if (preserveSelectedRowKeys) {
+			availableKeys = keys;
+			records = keys.map((key) => preserveRecordsRef.current.get(key));
+		} else {
+			availableKeys = [];
+			records = [];
+			keys.forEach((key) => {
+				const record = getRecordByKey(key);
+				if (record !== void 0) {
+					availableKeys.push(key);
+					records.push(record);
+				}
+			});
+		}
+		setInnerKeys(availableKeys);
+		onSelectionChange?.(availableKeys, records, { type: method });
+	};
+	const triggerSingleSelection = (key, selected, keys, event) => {
+		if (onSelect) {
+			const rows = keys.map((item) => getRecordByKey(item));
+			onSelect(getRecordByKey(key), selected, rows, event);
+		}
+		setSelectedKeys(keys, "single");
+	};
+	const recordKeys = useMemo(() => {
+		const keys = [];
+		flattedData.forEach((record, index) => {
+			const key = getRowKey(record, index);
+			if (!checkboxPropsMap.get(key)?.disabled) keys.push(key);
+		});
+		return keys;
+	}, [
+		flattedData,
+		getRowKey,
+		checkboxPropsMap
+	]);
+	const summary = useMemo(() => {
+		const checkedCurrentAll = recordKeys.every((key) => selectedKeySet.has(key));
+		const checkedCurrentSome = recordKeys.some((key) => selectedKeySet.has(key));
+		const disabledItems = [];
+		flattedData.forEach((record, index) => {
+			const key = getRowKey(record, index);
+			if (checkboxPropsMap.get(key)?.disabled) disabledItems.push(selectedKeySet.has(key));
+		});
+		const allDisabled = disabledItems.length > 0 && disabledItems.length === flattedData.length;
+		const allDisabledAndChecked = allDisabled && disabledItems.every(Boolean);
+		const allDisabledSomeChecked = allDisabled && disabledItems.some(Boolean);
+		return {
+			checked: allDisabled ? allDisabledAndChecked : flattedData.length > 0 && checkedCurrentAll,
+			disabled: flattedData.length === 0 || allDisabled,
+			indeterminate: allDisabled ? !allDisabledAndChecked && allDisabledSomeChecked : !checkedCurrentAll && checkedCurrentSome
+		};
+	}, [
+		recordKeys,
+		selectedKeySet,
+		flattedData,
+		getRowKey,
+		checkboxPropsMap
+	]);
+	const selectAll = useEventCallback(() => {
+		const keySet = new Set(selectedKeySet);
+		const checkedCurrentAll = recordKeys.every((key) => keySet.has(key));
+		const changeKeys = [];
+		if (checkedCurrentAll) recordKeys.forEach((key) => {
+			keySet.delete(key);
+			changeKeys.push(key);
+		});
+		else recordKeys.forEach((key) => {
+			if (!keySet.has(key)) {
+				keySet.add(key);
+				changeKeys.push(key);
+			}
+		});
+		const keys = [...keySet];
+		onSelectAll?.(!checkedCurrentAll, keys.map((key) => getRecordByKey(key)), changeKeys.map((key) => getRecordByKey(key)));
+		setSelectedKeys(keys, "all");
+		prevIndexRef.current = null;
+	});
+	const selectRadio = useEventCallback((key, event) => {
+		if (!selectedKeySet.has(key)) triggerSingleSelection(key, true, [key], event);
+	});
+	const toggleCheckbox = useEventCallback((key, checked, nativeEvent) => {
+		const keySet = new Set(selectedKeySet);
+		const shiftKey = Boolean(nativeEvent?.shiftKey);
+		const currentIndex = recordKeys.indexOf(key);
+		const isMultiple = selectedKeySet.size > 0 && recordKeys.some((item) => selectedKeySet.has(item));
+		if (shiftKey && checkStrictly && isMultiple) {
+			const { changedKeys, nextAnchor } = selectRange(prevIndexRef.current, currentIndex, recordKeys, keySet);
+			const keys = [...keySet];
+			onSelectMultiple?.(!checked, keys.map((item) => getRecordByKey(item)), changedKeys.map((item) => getRecordByKey(item)));
+			setSelectedKeys(keys, "multiple");
+			prevIndexRef.current = nextAnchor;
+			return;
+		}
+		if (checkStrictly || !keyEntities) {
+			const keys = checked ? derivedSelectedKeys.filter((item) => item !== key) : [...derivedSelectedKeys.filter((item) => item !== key), key];
+			triggerSingleSelection(key, !checked, keys, nativeEvent);
+		} else {
+			const { checkedKeys, halfCheckedKeys } = conductCheck([...derivedSelectedKeys, key], true, keyEntities, isCheckboxDisabled);
+			let nextKeys = checkedKeys;
+			if (checked) {
+				const tempKeySet = new Set(checkedKeys);
+				tempKeySet.delete(key);
+				nextKeys = conductCheck([...tempKeySet], {
+					checked: false,
+					halfCheckedKeys
+				}, keyEntities, isCheckboxDisabled).checkedKeys;
+			}
+			triggerSingleSelection(key, !checked, nextKeys, nativeEvent);
+		}
+		prevIndexRef.current = checked ? null : currentIndex;
+	});
+	const runPreset = useEventCallback((preset) => {
+		if (preset === "SELECT_ALL") {
+			const keys = [];
+			data.forEach((record, index) => {
+				const key = getRowKey(record, index);
+				if (!isCheckboxDisabled(record) || selectedKeySet.has(key)) keys.push(key);
+			});
+			setSelectedKeys(keys, "all");
+		} else if (preset === "SELECT_INVERT") {
+			const keySet = new Set(selectedKeySet);
+			pageData.forEach((record, index) => {
+				const key = getRowKey(record, index);
+				if (checkboxPropsMap.get(key)?.disabled) return;
+				if (keySet.has(key)) keySet.delete(key);
+				else keySet.add(key);
+			});
+			const keys = [...keySet];
+			onSelectInvert?.(keys);
+			setSelectedKeys(keys, "invert");
+		} else if (preset === "SELECT_NONE") {
+			onSelectNone?.();
+			setSelectedKeys([...selectedKeySet].filter((key) => checkboxPropsMap.get(key)?.disabled), "none");
+		}
+		prevIndexRef.current = null;
+	});
+	const runCustom = useEventCallback((item) => {
+		item.onSelect?.(recordKeys);
+		prevIndexRef.current = null;
+	});
+	const mergedSelections = useMemo(() => {
+		if (!selections || hideSelectAll || selectionType === "radio") return null;
+		return (selections === true ? [
+			SELECTION_ALL,
+			SELECTION_INVERT,
+			SELECTION_NONE
+		] : selections).map((selection, index) => {
+			if (selection === "SELECT_ALL") return {
+				key: "all",
+				onSelect: () => runPreset(SELECTION_ALL),
+				text: locale.selectionAll
+			};
+			if (selection === "SELECT_INVERT") return {
+				key: "invert",
+				onSelect: () => runPreset(SELECTION_INVERT),
+				text: locale.selectInvert
+			};
+			if (selection === "SELECT_NONE") return {
+				key: "none",
+				onSelect: () => runPreset(SELECTION_NONE),
+				text: locale.selectNone
+			};
+			return {
+				key: selection.key ?? index,
+				onSelect: () => runCustom(selection),
+				text: selection.text
+			};
+		});
+	}, [
+		selections,
+		hideSelectAll,
+		selectionType,
+		runPreset,
+		runCustom,
+		locale.selectionAll,
+		locale.selectInvert,
+		locale.selectNone
+	]);
+	const clear = useEventCallback(() => setSelectedKeys(EMPTY_KEYS, "none"));
+	return {
+		actions: useMemo(() => ({
+			clear,
+			selectAll,
+			selectRadio,
+			toggleCheckbox
+		}), [
+			clear,
+			selectAll,
+			selectRadio,
+			toggleCheckbox
+		]),
+		checkboxPropsMap,
+		halfSelectedKeySet,
+		mergedSelections,
+		selectedKeySet,
+		summary
+	};
+};
+//#endregion
+export { useSelection };
+
+//# sourceMappingURL=useSelection.mjs.map

package/es/Table/pipeline/useSelection.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"useSelection.mjs","names":[],"sources":["../../../src/Table/pipeline/useSelection.ts"],"sourcesContent":["import { type Key, useCallback, useEffect, useMemo, useRef, useState } from 'react';\n\nimport { useEventCallback } from '@/hooks/useEventCallback';\n\nimport type {\n  TableLocale,\n  TableRowSelection,\n  TableRowSelectionCheckboxProps,\n  TableRowSelectMethod,\n  TableSelectionItem,\n} from '../type';\nimport {\n  conductCheck,\n  convertDataToEntities,\n  flattenData,\n  SELECTION_ALL,\n  SELECTION_INVERT,\n  SELECTION_NONE,\n  type SelectionEntities,\n  selectRange,\n} from './selectionUtils';\n\nconst EMPTY_KEYS: Key[] = [];\n\nexport interface SelectionConfig<T> {\n  childrenColumnName: string;\n  data: readonly T[];\n  expandType: 'nest' | 'row' | null;\n  getRecordByKey: (key: Key) => T | undefined;\n  getRowKey: (record: T, index?: number) => Key;\n  locale: TableLocale;\n  pageData: readonly T[];\n}\n\nexport interface SelectionSummaryState {\n  checked: boolean;\n  disabled: boolean;\n  indeterminate: boolean;\n}\n\nexport interface MergedSelectionItem {\n  key: Key;\n  onSelect: () => void;\n  text: TableSelectionItem['text'];\n}\n\nexport interface SelectionActions {\n  clear: () => void;\n  selectAll: () => void;\n  selectRadio: (key: Key, event: Event) => void;\n  toggleCheckbox: (key: Key, checked: boolean, event: Event | undefined) => void;\n}\n\nconst shallowEqual = (a: object | undefined, b: object | undefined) => {\n  if (a === b) return true;\n  if (!a || !b) return false;\n  const keysA = Object.keys(a);\n  if (keysA.length !== Object.keys(b).length) return false;\n  return keysA.every((key) => Object.is((a as any)[key], (b as any)[key]));\n};\n\nconst useStableCheckboxProps = <T>(\n  flattedData: readonly T[],\n  getRowKey: (record: T, index?: number) => Key,\n  getCheckboxProps: TableRowSelection<T>['getCheckboxProps'],\n) => {\n  const previous = useRef<Map<Key, TableRowSelectionCheckboxProps>>(new Map());\n  return useMemo(() => {\n    const next = new Map<Key, TableRowSelectionCheckboxProps>();\n    flattedData.forEach((record, index) => {\n      next.set(getRowKey(record, index), getCheckboxProps?.(record) || {});\n    });\n    const prev = previous.current;\n    const same =\n      prev.size === next.size &&\n      [...next].every(([key, props]) => prev.has(key) && shallowEqual(prev.get(key), props));\n    if (same) return prev;\n    previous.current = next;\n    return next;\n  }, [flattedData, getRowKey, getCheckboxProps]);\n};\n\nexport const useSelection = <T>(\n  config: SelectionConfig<T>,\n  rowSelection: TableRowSelection<T> | undefined,\n) => {\n  const {\n    checkStrictly = true,\n    defaultSelectedRowKeys,\n    getCheckboxProps,\n    hideSelectAll,\n    onChange: onSelectionChange,\n    onSelect,\n    onSelectAll,\n    onSelectInvert,\n    onSelectMultiple,\n    onSelectNone,\n    preserveSelectedRowKeys,\n    selectedRowKeys,\n    selections,\n    type: selectionType = 'checkbox',\n  } = rowSelection || {};\n  const { childrenColumnName, data, getRecordByKey, getRowKey, locale, pageData } = config;\n\n  const [innerKeys, setInnerKeys] = useState<Key[]>(defaultSelectedRowKeys || EMPTY_KEYS);\n  const mergedKeys = selectedRowKeys ?? innerKeys;\n\n  const prevIndexRef = useRef<number | null>(null);\n\n  const preserveRecordsRef = useRef(new Map<Key, T | undefined>());\n  const updatePreserveRecordsCache = useCallback(\n    (keys: readonly Key[]) => {\n      if (!preserveSelectedRowKeys) return;\n      const next = new Map<Key, T | undefined>();\n      keys.forEach((key) => {\n        let record = getRecordByKey(key);\n        if (record === undefined && preserveRecordsRef.current.has(key)) {\n          record = preserveRecordsRef.current.get(key);\n        }\n        next.set(key, record);\n      });\n      preserveRecordsRef.current = next;\n    },\n    [getRecordByKey, preserveSelectedRowKeys],\n  );\n\n  useEffect(() => {\n    updatePreserveRecordsCache(mergedKeys);\n  }, [mergedKeys, updatePreserveRecordsCache]);\n\n  const flattedData = useMemo(\n    () => flattenData(childrenColumnName, pageData),\n    [childrenColumnName, pageData],\n  );\n\n  const keyEntities = useMemo((): SelectionEntities<T> | null => {\n    if (checkStrictly) return null;\n    let convertData = data;\n    if (preserveSelectedRowKeys) {\n      // Records kept from other pages join the tree, unless they are on this page already.\n      const keySet = new Set(flattedData.map((record) => getRowKey(record)));\n      const preserved = [...preserveRecordsRef.current]\n        .filter(([key, record]) => !keySet.has(key) && record !== undefined)\n        .map(([, record]) => record as T);\n      convertData = [...convertData, ...preserved];\n    }\n    return convertDataToEntities(convertData, getRowKey, childrenColumnName);\n  }, [data, getRowKey, checkStrictly, childrenColumnName, preserveSelectedRowKeys, flattedData]);\n\n  const checkboxPropsMap = useStableCheckboxProps(flattedData, getRowKey, getCheckboxProps);\n\n  const isCheckboxDisabled = useCallback(\n    (record: T) => {\n      const key = getRowKey(record);\n      const props = checkboxPropsMap.has(key)\n        ? checkboxPropsMap.get(key)\n        : getCheckboxProps?.(record);\n      return Boolean(props?.disabled);\n    },\n    [checkboxPropsMap, getRowKey, getCheckboxProps],\n  );\n\n  const [derivedSelectedKeys, derivedHalfSelectedKeys] = useMemo((): [Key[], Key[]] => {\n    if (checkStrictly || !keyEntities) return [mergedKeys, []];\n    const { checkedKeys, halfCheckedKeys } = conductCheck(\n      mergedKeys,\n      true,\n      keyEntities,\n      isCheckboxDisabled,\n    );\n    return [checkedKeys, halfCheckedKeys];\n  }, [mergedKeys, checkStrictly, keyEntities, isCheckboxDisabled]);\n\n  const selectedKeySet = useMemo(\n    () =>\n      new Set(selectionType === 'radio' ? derivedSelectedKeys.slice(0, 1) : derivedSelectedKeys),\n    [derivedSelectedKeys, selectionType],\n  );\n  const halfSelectedKeySet = useMemo(\n    () => new Set(selectionType === 'radio' ? [] : derivedHalfSelectedKeys),\n    [derivedHalfSelectedKeys, selectionType],\n  );\n\n  const enabled = Boolean(rowSelection);\n  const [prevEnabled, setPrevEnabled] = useState(enabled);\n  if (prevEnabled !== enabled) {\n    setPrevEnabled(enabled);\n    if (!enabled) setInnerKeys(EMPTY_KEYS);\n  }\n\n  const setSelectedKeys = (keys: Key[], method: TableRowSelectMethod) => {\n    let availableKeys: Key[];\n    let records: T[];\n    updatePreserveRecordsCache(keys);\n    if (preserveSelectedRowKeys) {\n      availableKeys = keys;\n      records = keys.map((key) => preserveRecordsRef.current.get(key) as T);\n    } else {\n      availableKeys = [];\n      records = [];\n      keys.forEach((key) => {\n        const record = getRecordByKey(key);\n        if (record !== undefined) {\n          availableKeys.push(key);\n          records.push(record);\n        }\n      });\n    }\n    setInnerKeys(availableKeys);\n    onSelectionChange?.(availableKeys, records, { type: method });\n  };\n\n  const triggerSingleSelection = (key: Key, selected: boolean, keys: Key[], event: Event) => {\n    if (onSelect) {\n      const rows = keys.map((item) => getRecordByKey(item) as T);\n      onSelect(getRecordByKey(key) as T, selected, rows, event);\n    }\n    setSelectedKeys(keys, 'single');\n  };\n\n  const recordKeys = useMemo(() => {\n    const keys: Key[] = [];\n    flattedData.forEach((record, index) => {\n      const key = getRowKey(record, index);\n      if (!checkboxPropsMap.get(key)?.disabled) keys.push(key);\n    });\n    return keys;\n  }, [flattedData, getRowKey, checkboxPropsMap]);\n\n  const summary = useMemo((): SelectionSummaryState => {\n    const checkedCurrentAll = recordKeys.every((key) => selectedKeySet.has(key));\n    const checkedCurrentSome = recordKeys.some((key) => selectedKeySet.has(key));\n    const disabledItems: boolean[] = [];\n    flattedData.forEach((record, index) => {\n      const key = getRowKey(record, index);\n      if (checkboxPropsMap.get(key)?.disabled) disabledItems.push(selectedKeySet.has(key));\n    });\n    const allDisabled = disabledItems.length > 0 && disabledItems.length === flattedData.length;\n    const allDisabledAndChecked = allDisabled && disabledItems.every(Boolean);\n    const allDisabledSomeChecked = allDisabled && disabledItems.some(Boolean);\n    return {\n      checked: allDisabled ? allDisabledAndChecked : flattedData.length > 0 && checkedCurrentAll,\n      disabled: flattedData.length === 0 || allDisabled,\n      indeterminate: allDisabled\n        ? !allDisabledAndChecked && allDisabledSomeChecked\n        : !checkedCurrentAll && checkedCurrentSome,\n    };\n  }, [recordKeys, selectedKeySet, flattedData, getRowKey, checkboxPropsMap]);\n\n  const selectAll = useEventCallback(() => {\n    const keySet = new Set(selectedKeySet);\n    const checkedCurrentAll = recordKeys.every((key) => keySet.has(key));\n    const changeKeys: Key[] = [];\n    if (checkedCurrentAll) {\n      recordKeys.forEach((key) => {\n        keySet.delete(key);\n        changeKeys.push(key);\n      });\n    } else {\n      recordKeys.forEach((key) => {\n        if (!keySet.has(key)) {\n          keySet.add(key);\n          changeKeys.push(key);\n        }\n      });\n    }\n    const keys = [...keySet];\n    onSelectAll?.(\n      !checkedCurrentAll,\n      keys.map((key) => getRecordByKey(key) as T),\n      changeKeys.map((key) => getRecordByKey(key) as T),\n    );\n    setSelectedKeys(keys, 'all');\n    prevIndexRef.current = null;\n  });\n\n  const selectRadio = useEventCallback((key: Key, event: Event) => {\n    if (!selectedKeySet.has(key)) triggerSingleSelection(key, true, [key], event);\n  });\n\n  const toggleCheckbox = useEventCallback(\n    (key: Key, checked: boolean, nativeEvent: Event | undefined) => {\n      const keySet = new Set(selectedKeySet);\n      const shiftKey = Boolean((nativeEvent as MouseEvent | undefined)?.shiftKey);\n      const currentIndex = recordKeys.indexOf(key);\n      const isMultiple =\n        selectedKeySet.size > 0 && recordKeys.some((item) => selectedKeySet.has(item));\n\n      if (shiftKey && checkStrictly && isMultiple) {\n        const { changedKeys, nextAnchor } = selectRange(\n          prevIndexRef.current,\n          currentIndex,\n          recordKeys,\n          keySet,\n        );\n        const keys = [...keySet];\n        onSelectMultiple?.(\n          !checked,\n          keys.map((item) => getRecordByKey(item) as T),\n          changedKeys.map((item) => getRecordByKey(item) as T),\n        );\n        setSelectedKeys(keys, 'multiple');\n        prevIndexRef.current = nextAnchor;\n        return;\n      }\n\n      if (checkStrictly || !keyEntities) {\n        const keys = checked\n          ? derivedSelectedKeys.filter((item) => item !== key)\n          : [...derivedSelectedKeys.filter((item) => item !== key), key];\n        triggerSingleSelection(key, !checked, keys, nativeEvent as Event);\n      } else {\n        const { checkedKeys, halfCheckedKeys } = conductCheck(\n          [...derivedSelectedKeys, key],\n          true,\n          keyEntities,\n          isCheckboxDisabled,\n        );\n        let nextKeys = checkedKeys;\n        if (checked) {\n          const tempKeySet = new Set(checkedKeys);\n          tempKeySet.delete(key);\n          nextKeys = conductCheck(\n            [...tempKeySet],\n            { checked: false, halfCheckedKeys },\n            keyEntities,\n            isCheckboxDisabled,\n          ).checkedKeys;\n        }\n        triggerSingleSelection(key, !checked, nextKeys, nativeEvent as Event);\n      }\n      prevIndexRef.current = checked ? null : currentIndex;\n    },\n  );\n\n  const runPreset = useEventCallback((preset: string) => {\n    if (preset === SELECTION_ALL) {\n      const keys: Key[] = [];\n      data.forEach((record, index) => {\n        const key = getRowKey(record, index);\n        if (!isCheckboxDisabled(record) || selectedKeySet.has(key)) keys.push(key);\n      });\n      setSelectedKeys(keys, 'all');\n    } else if (preset === SELECTION_INVERT) {\n      const keySet = new Set(selectedKeySet);\n      pageData.forEach((record, index) => {\n        const key = getRowKey(record, index);\n        if (checkboxPropsMap.get(key)?.disabled) return;\n        if (keySet.has(key)) keySet.delete(key);\n        else keySet.add(key);\n      });\n      const keys = [...keySet];\n      onSelectInvert?.(keys);\n      setSelectedKeys(keys, 'invert');\n    } else if (preset === SELECTION_NONE) {\n      onSelectNone?.();\n      setSelectedKeys(\n        [...selectedKeySet].filter((key) => checkboxPropsMap.get(key)?.disabled),\n        'none',\n      );\n    }\n    prevIndexRef.current = null;\n  });\n\n  const runCustom = useEventCallback((item: TableSelectionItem) => {\n    item.onSelect?.(recordKeys);\n    prevIndexRef.current = null;\n  });\n\n  const mergedSelections = useMemo((): MergedSelectionItem[] | null => {\n    if (!selections || hideSelectAll || selectionType === 'radio') return null;\n    const list =\n      selections === true ? [SELECTION_ALL, SELECTION_INVERT, SELECTION_NONE] : selections;\n    return list.map((selection, index) => {\n      if (selection === SELECTION_ALL) {\n        return { key: 'all', onSelect: () => runPreset(SELECTION_ALL), text: locale.selectionAll };\n      }\n      if (selection === SELECTION_INVERT) {\n        return {\n          key: 'invert',\n          onSelect: () => runPreset(SELECTION_INVERT),\n          text: locale.selectInvert,\n        };\n      }\n      if (selection === SELECTION_NONE) {\n        return { key: 'none', onSelect: () => runPreset(SELECTION_NONE), text: locale.selectNone };\n      }\n      return {\n        key: selection.key ?? index,\n        onSelect: () => runCustom(selection),\n        text: selection.text,\n      };\n    });\n  }, [\n    selections,\n    hideSelectAll,\n    selectionType,\n    runPreset,\n    runCustom,\n    locale.selectionAll,\n    locale.selectInvert,\n    locale.selectNone,\n  ]);\n\n  const clear = useEventCallback(() => setSelectedKeys(EMPTY_KEYS, 'none'));\n\n  const actions = useMemo(\n    (): SelectionActions => ({ clear, selectAll, selectRadio, toggleCheckbox }),\n    [clear, selectAll, selectRadio, toggleCheckbox],\n  );\n\n  return {\n    actions,\n    checkboxPropsMap,\n    halfSelectedKeySet,\n    mergedSelections,\n    selectedKeySet,\n    summary,\n  };\n};\n"],"mappings":"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"}

package/es/Table/pipeline/useSorter.mjs

@@ -0,0 +1,146 @@
+import { getColumnId, getColumnPos, isColumnGroup } from "./columnUtils.mjs";
+import { useMemo } from "react";
+//#region src/Table/pipeline/useSorter.ts
+const DEFAULT_SORT_DIRECTIONS = ["ascend", "descend"];
+const isPlainObject = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+const getMultiplePriority = (column) => {
+	const { sorter } = column;
+	return isPlainObject(sorter) && typeof sorter.multiple === "number" ? sorter.multiple : false;
+};
+const getSortFunction = (sorter) => {
+	if (typeof sorter === "function") return sorter;
+	if (isPlainObject(sorter) && typeof sorter.compare === "function") return sorter.compare;
+	return false;
+};
+const getNextSortOrder = (sortDirections, current) => {
+	if (!current) return sortDirections[0];
+	return sortDirections[sortDirections.indexOf(current) + 1];
+};
+const collectSortStates = (columns, init, parentPos) => {
+	const states = [];
+	const push = (column, pos, sortOrder) => states.push({
+		column,
+		key: getColumnId(column, pos),
+		multiplePriority: getMultiplePriority(column),
+		sortOrder
+	});
+	columns.forEach((column, index) => {
+		const pos = getColumnPos(index, parentPos);
+		if (isColumnGroup(column)) {
+			if ("sortOrder" in column) push(column, pos, column.sortOrder);
+			states.push(...collectSortStates(column.children, init, pos));
+		} else if (column.sorter) {
+			if ("sortOrder" in column) push(column, pos, column.sortOrder);
+			else if (init && column.defaultSortOrder) push(column, pos, column.defaultSortOrder);
+		}
+	});
+	return states;
+};
+const collectColumnMap = (columns, map = /* @__PURE__ */ new Map(), parentPos) => {
+	columns.forEach((column, index) => {
+		const pos = getColumnPos(index, parentPos);
+		map.set(getColumnId(column, pos), column);
+		if (isColumnGroup(column)) collectColumnMap(column.children, map, pos);
+	});
+	return map;
+};
+const mergeSortStates = (columns, innerStates) => {
+	const controlled = collectSortStates(columns, false);
+	if (controlled.length === 0) {
+		const columnMap = collectColumnMap(columns);
+		return innerStates.filter(({ key }) => columnMap.has(key)).map((state) => ({
+			...state,
+			column: columnMap.get(state.key)
+		}));
+	}
+	const result = [];
+	let valid = true;
+	let multipleMode = null;
+	const patch = (state) => result.push(valid ? state : {
+		...state,
+		sortOrder: null
+	});
+	for (const state of controlled) if (multipleMode === null) {
+		patch(state);
+		if (state.sortOrder) {
+			if (state.multiplePriority === false) valid = false;
+			else multipleMode = true;
+		}
+	} else if (multipleMode && state.multiplePriority !== false) patch(state);
+	else {
+		valid = false;
+		patch(state);
+	}
+	return result;
+};
+const getTriggeredSortStates = (current, next) => {
+	if (next.multiplePriority === false || !current.length || current[0].multiplePriority === false) return [next];
+	return [...current.filter(({ key }) => key !== next.key), next];
+};
+const stateToInfo = ({ column, key, sortOrder }) => ({
+	column,
+	columnKey: column.key ?? key,
+	field: column.dataIndex,
+	order: sortOrder ?? void 0
+});
+const getSorterInfo = (states) => {
+	const active = states.filter(({ sortOrder }) => sortOrder).map((state) => stateToInfo(state));
+	if (active.length === 0 && states.length) return {
+		...stateToInfo(states.at(-1)),
+		column: void 0,
+		columnKey: void 0,
+		field: void 0,
+		order: void 0
+	};
+	if (active.length <= 1) return active[0] ?? {};
+	const [first] = active;
+	for (const field of [
+		"column",
+		"columnKey",
+		"field",
+		"order"
+	]) Object.defineProperty(active, field, {
+		configurable: true,
+		enumerable: false,
+		value: first[field],
+		writable: true
+	});
+	return active;
+};
+const getSortTitleProps = (states) => {
+	const sortColumns = states.map(({ column, sortOrder }) => ({
+		column,
+		order: sortOrder
+	}));
+	return {
+		sortColumn: sortColumns[0]?.column,
+		sortColumns,
+		sortOrder: sortColumns[0]?.order
+	};
+};
+const sortData = (data, states, childrenColumnName = "children") => {
+	const running = states.filter(({ column, sortOrder }) => getSortFunction(column.sorter) && sortOrder).sort((a, b) => b.multiplePriority - a.multiplePriority);
+	if (running.length === 0) return [...data];
+	return [...data].sort((a, b) => {
+		for (const { column, sortOrder } of running) {
+			const result = getSortFunction(column.sorter)(a, b, sortOrder);
+			if (result !== 0) return sortOrder === "ascend" ? result : -result;
+		}
+		return 0;
+	}).map((record) => {
+		const children = record[childrenColumnName];
+		return Array.isArray(children) ? {
+			...record,
+			[childrenColumnName]: sortData(children, states, childrenColumnName)
+		} : record;
+	});
+};
+const useSorter = ({ childrenColumnName, data, sortStates }) => useMemo(() => sortData(data, sortStates, childrenColumnName), [
+	data,
+	sortStates,
+	childrenColumnName
+]);
+//#endregion
+export { DEFAULT_SORT_DIRECTIONS, collectSortStates, getMultiplePriority, getNextSortOrder, getSortFunction, getSortTitleProps, getSorterInfo, getTriggeredSortStates, mergeSortStates, sortData, useSorter };
+
+//# sourceMappingURL=useSorter.mjs.map

package/es/Table/pipeline/useSorter.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"useSorter.mjs","names":[],"sources":["../../../src/Table/pipeline/useSorter.ts"],"sourcesContent":["import { useMemo } from 'react';\n\nimport type {\n  SortOrder,\n  TableColumn,\n  TableColumnTitleProps,\n  TableColumnType,\n  TableCompareFn,\n  TableMultipleSorterResult,\n  TableSorterResult,\n} from '../type';\nimport { getColumnId, getColumnPos, isColumnGroup } from './columnUtils';\n\nexport interface SortState<T = any> {\n  column: TableColumn<T>;\n  key: string;\n  multiplePriority: number | false;\n  sortOrder: SortOrder | undefined;\n}\n\nexport const DEFAULT_SORT_DIRECTIONS: SortOrder[] = ['ascend', 'descend'];\n\nconst isPlainObject = (value: unknown): value is Record<string, unknown> =>\n  typeof value === 'object' && value !== null && !Array.isArray(value);\n\nexport const getMultiplePriority = (column: TableColumn<any>): number | false => {\n  const { sorter } = column;\n  return isPlainObject(sorter) && typeof sorter.multiple === 'number' ? sorter.multiple : false;\n};\n\nexport const getSortFunction = <T>(sorter: TableColumn<T>['sorter']): TableCompareFn<T> | false => {\n  if (typeof sorter === 'function') return sorter;\n  if (isPlainObject(sorter) && typeof sorter.compare === 'function') return sorter.compare;\n  return false;\n};\n\nexport const getNextSortOrder = (\n  sortDirections: readonly SortOrder[],\n  current: SortOrder | undefined,\n): SortOrder | undefined => {\n  if (!current) return sortDirections[0];\n  return sortDirections[sortDirections.indexOf(current) + 1];\n};\n\nexport const collectSortStates = <T>(\n  columns: readonly TableColumn<T>[],\n  init: boolean,\n  parentPos?: string,\n): SortState<T>[] => {\n  const states: SortState<T>[] = [];\n  const push = (column: TableColumn<T>, pos: string, sortOrder: SortOrder | undefined) =>\n    states.push({\n      column,\n      key: getColumnId(column, pos),\n      multiplePriority: getMultiplePriority(column),\n      sortOrder,\n    });\n\n  columns.forEach((column, index) => {\n    const pos = getColumnPos(index, parentPos);\n    if (isColumnGroup(column)) {\n      if ('sortOrder' in column) push(column, pos, column.sortOrder);\n      states.push(...collectSortStates(column.children, init, pos));\n    } else if (column.sorter) {\n      if ('sortOrder' in column) push(column, pos, column.sortOrder);\n      else if (init && column.defaultSortOrder) push(column, pos, column.defaultSortOrder);\n    }\n  });\n  return states;\n};\n\nconst collectColumnMap = <T>(\n  columns: readonly TableColumn<T>[],\n  map = new Map<string, TableColumn<T>>(),\n  parentPos?: string,\n) => {\n  columns.forEach((column, index) => {\n    const pos = getColumnPos(index, parentPos);\n    map.set(getColumnId(column, pos), column);\n    if (isColumnGroup(column)) collectColumnMap(column.children, map, pos);\n  });\n  return map;\n};\n\nexport const mergeSortStates = <T>(\n  columns: readonly TableColumn<T>[],\n  innerStates: readonly SortState<T>[],\n): SortState<T>[] => {\n  const controlled = collectSortStates(columns, false);\n\n  if (controlled.length === 0) {\n    // Drop states of removed columns and pick up the latest column objects (fresh comparators).\n    const columnMap = collectColumnMap(columns);\n    return innerStates\n      .filter(({ key }) => columnMap.has(key))\n      .map((state) => ({ ...state, column: columnMap.get(state.key)! }));\n  }\n\n  const result: SortState<T>[] = [];\n  let valid = true;\n  let multipleMode: boolean | null = null;\n  const patch = (state: SortState<T>) => result.push(valid ? state : { ...state, sortOrder: null });\n\n  for (const state of controlled) {\n    if (multipleMode === null) {\n      patch(state);\n      if (state.sortOrder) {\n        if (state.multiplePriority === false) valid = false;\n        else multipleMode = true;\n      }\n    } else if (multipleMode && state.multiplePriority !== false) {\n      patch(state);\n    } else {\n      valid = false;\n      patch(state);\n    }\n  }\n  return result;\n};\n\nexport const getTriggeredSortStates = <T>(\n  current: readonly SortState<T>[],\n  next: SortState<T>,\n): SortState<T>[] => {\n  if (next.multiplePriority === false || !current.length || current[0].multiplePriority === false) {\n    return [next];\n  }\n  return [...current.filter(({ key }) => key !== next.key), next];\n};\n\nconst stateToInfo = <T>({ column, key, sortOrder }: SortState<T>): TableSorterResult<T> => ({\n  column: column as TableColumnType<T>,\n  // antd reports `column.key`; the id fallback keeps dataIndex-only columns identifiable.\n  columnKey: column.key ?? key,\n  field: (column as TableColumnType<T>).dataIndex as TableSorterResult<T>['field'],\n  order: sortOrder ?? undefined,\n});\n\nexport const getSorterInfo = <T>(\n  states: readonly SortState<T>[],\n): TableSorterResult<T> | TableMultipleSorterResult<T> => {\n  const active = states.filter(({ sortOrder }) => sortOrder).map((state) => stateToInfo(state));\n\n  // antd keeps the last cleared column's other fields when nothing is sorted.\n  if (active.length === 0 && states.length) {\n    return {\n      ...stateToInfo(states.at(-1)!),\n      column: undefined,\n      columnKey: undefined,\n      field: undefined,\n      order: undefined,\n    };\n  }\n  if (active.length <= 1) return active[0] ?? {};\n  // Pre-5.61 code reads `sorter.order` / `sorter.columnKey` directly: expose the first entry's\n  // fields on the array too. Non-enumerable, so iteration, spread and equality see a plain array.\n  const [first] = active;\n  for (const field of ['column', 'columnKey', 'field', 'order'] as const) {\n    Object.defineProperty(active, field, {\n      configurable: true,\n      enumerable: false,\n      value: first[field],\n      writable: true,\n    });\n  }\n  return active as TableMultipleSorterResult<T>;\n};\n\nexport const getSortTitleProps = <T>(\n  states: readonly SortState<T>[],\n): Pick<TableColumnTitleProps<T>, 'sortColumn' | 'sortColumns' | 'sortOrder'> => {\n  const sortColumns = states.map(({ column, sortOrder }) => ({ column, order: sortOrder }));\n  return {\n    sortColumn: sortColumns[0]?.column,\n    sortColumns,\n    sortOrder: sortColumns[0]?.order,\n  };\n};\n\nexport const sortData = <T>(\n  data: readonly T[],\n  states: readonly SortState<T>[],\n  childrenColumnName = 'children',\n): T[] => {\n  const running = states\n    .filter(({ column, sortOrder }) => getSortFunction(column.sorter) && sortOrder)\n    .sort((a, b) => (b.multiplePriority as number) - (a.multiplePriority as number));\n  if (running.length === 0) return [...data];\n\n  return [...data]\n    .sort((a, b) => {\n      for (const { column, sortOrder } of running) {\n        const result = (getSortFunction(column.sorter) as TableCompareFn<T>)(a, b, sortOrder);\n        if (result !== 0) return sortOrder === 'ascend' ? result : -result;\n      }\n      return 0;\n    })\n    .map((record) => {\n      const children = (record as Record<string, unknown>)[childrenColumnName];\n      return Array.isArray(children)\n        ? { ...record, [childrenColumnName]: sortData(children as T[], states, childrenColumnName) }\n        : record;\n    });\n};\n\nexport const useSorter = <T>({\n  childrenColumnName,\n  data,\n  sortStates,\n}: {\n  childrenColumnName?: string;\n  data: readonly T[];\n  sortStates: readonly SortState<T>[];\n}) =>\n  useMemo(\n    () => sortData(data, sortStates, childrenColumnName),\n    [data, sortStates, childrenColumnName],\n  );\n"],"mappings":";;;AAoBA,MAAa,0BAAuC,CAAC,UAAU,SAAS;AAExE,MAAM,iBAAiB,UACrB,OAAO,UAAU,YAAY,UAAU,QAAQ,CAAC,MAAM,QAAQ,KAAK;AAErE,MAAa,uBAAuB,WAA6C;CAC/E,MAAM,EAAE,WAAW;CACnB,OAAO,cAAc,MAAM,KAAK,OAAO,OAAO,aAAa,WAAW,OAAO,WAAW;AAC1F;AAEA,MAAa,mBAAsB,WAAgE;CACjG,IAAI,OAAO,WAAW,YAAY,OAAO;CACzC,IAAI,cAAc,MAAM,KAAK,OAAO,OAAO,YAAY,YAAY,OAAO,OAAO;CACjF,OAAO;AACT;AAEA,MAAa,oBACX,gBACA,YAC0B;CAC1B,IAAI,CAAC,SAAS,OAAO,eAAe;CACpC,OAAO,eAAe,eAAe,QAAQ,OAAO,IAAI;AAC1D;AAEA,MAAa,qBACX,SACA,MACA,cACmB;CACnB,MAAM,SAAyB,CAAC;CAChC,MAAM,QAAQ,QAAwB,KAAa,cACjD,OAAO,KAAK;EACV;EACA,KAAK,YAAY,QAAQ,GAAG;EAC5B,kBAAkB,oBAAoB,MAAM;EAC5C;CACF,CAAC;CAEH,QAAQ,SAAS,QAAQ,UAAU;EACjC,MAAM,MAAM,aAAa,OAAO,SAAS;EACzC,IAAI,cAAc,MAAM,GAAG;GACzB,IAAI,eAAe,QAAQ,KAAK,QAAQ,KAAK,OAAO,SAAS;GAC7D,OAAO,KAAK,GAAG,kBAAkB,OAAO,UAAU,MAAM,GAAG,CAAC;EAC9D,OAAO,IAAI,OAAO,QAAQ;GACxB,IAAI,eAAe,QAAQ,KAAK,QAAQ,KAAK,OAAO,SAAS;QACxD,IAAI,QAAQ,OAAO,kBAAkB,KAAK,QAAQ,KAAK,OAAO,gBAAgB;EACrF;CACF,CAAC;CACD,OAAO;AACT;AAEA,MAAM,oBACJ,SACA,sBAAM,IAAI,IAA4B,GACtC,cACG;CACH,QAAQ,SAAS,QAAQ,UAAU;EACjC,MAAM,MAAM,aAAa,OAAO,SAAS;EACzC,IAAI,IAAI,YAAY,QAAQ,GAAG,GAAG,MAAM;EACxC,IAAI,cAAc,MAAM,GAAG,iBAAiB,OAAO,UAAU,KAAK,GAAG;CACvE,CAAC;CACD,OAAO;AACT;AAEA,MAAa,mBACX,SACA,gBACmB;CACnB,MAAM,aAAa,kBAAkB,SAAS,KAAK;CAEnD,IAAI,WAAW,WAAW,GAAG;EAE3B,MAAM,YAAY,iBAAiB,OAAO;EAC1C,OAAO,YACJ,QAAQ,EAAE,UAAU,UAAU,IAAI,GAAG,CAAC,CAAC,CACvC,KAAK,WAAW;GAAE,GAAG;GAAO,QAAQ,UAAU,IAAI,MAAM,GAAG;EAAG,EAAE;CACrE;CAEA,MAAM,SAAyB,CAAC;CAChC,IAAI,QAAQ;CACZ,IAAI,eAA+B;CACnC,MAAM,SAAS,UAAwB,OAAO,KAAK,QAAQ,QAAQ;EAAE,GAAG;EAAO,WAAW;CAAK,CAAC;CAEhG,KAAK,MAAM,SAAS,YAClB,IAAI,iBAAiB,MAAM;EACzB,MAAM,KAAK;EACX,IAAI,MAAM,WAAW;GACnB,IAAI,MAAM,qBAAqB,OAAO,QAAQ;QACzC,eAAe;EACtB;CACF,OAAO,IAAI,gBAAgB,MAAM,qBAAqB,OACpD,MAAM,KAAK;MACN;EACL,QAAQ;EACR,MAAM,KAAK;CACb;CAEF,OAAO;AACT;AAEA,MAAa,0BACX,SACA,SACmB;CACnB,IAAI,KAAK,qBAAqB,SAAS,CAAC,QAAQ,UAAU,QAAQ,EAAE,CAAC,qBAAqB,OACxF,OAAO,CAAC,IAAI;CAEd,OAAO,CAAC,GAAG,QAAQ,QAAQ,EAAE,UAAU,QAAQ,KAAK,GAAG,GAAG,IAAI;AAChE;AAEA,MAAM,eAAkB,EAAE,QAAQ,KAAK,iBAAqD;CAClF;CAER,WAAW,OAAO,OAAO;CACzB,OAAQ,OAA8B;CACtC,OAAO,aAAa,KAAA;AACtB;AAEA,MAAa,iBACX,WACwD;CACxD,MAAM,SAAS,OAAO,QAAQ,EAAE,gBAAgB,SAAS,CAAC,CAAC,KAAK,UAAU,YAAY,KAAK,CAAC;CAG5F,IAAI,OAAO,WAAW,KAAK,OAAO,QAChC,OAAO;EACL,GAAG,YAAY,OAAO,GAAG,EAAE,CAAE;EAC7B,QAAQ,KAAA;EACR,WAAW,KAAA;EACX,OAAO,KAAA;EACP,OAAO,KAAA;CACT;CAEF,IAAI,OAAO,UAAU,GAAG,OAAO,OAAO,MAAM,CAAC;CAG7C,MAAM,CAAC,SAAS;CAChB,KAAK,MAAM,SAAS;EAAC;EAAU;EAAa;EAAS;CAAO,GAC1D,OAAO,eAAe,QAAQ,OAAO;EACnC,cAAc;EACd,YAAY;EACZ,OAAO,MAAM;EACb,UAAU;CACZ,CAAC;CAEH,OAAO;AACT;AAEA,MAAa,qBACX,WAC+E;CAC/E,MAAM,cAAc,OAAO,KAAK,EAAE,QAAQ,iBAAiB;EAAE;EAAQ,OAAO;CAAU,EAAE;CACxF,OAAO;EACL,YAAY,YAAY,EAAE,EAAE;EAC5B;EACA,WAAW,YAAY,EAAE,EAAE;CAC7B;AACF;AAEA,MAAa,YACX,MACA,QACA,qBAAqB,eACb;CACR,MAAM,UAAU,OACb,QAAQ,EAAE,QAAQ,gBAAgB,gBAAgB,OAAO,MAAM,KAAK,SAAS,CAAC,CAC9E,MAAM,GAAG,MAAO,EAAE,mBAA+B,EAAE,gBAA2B;CACjF,IAAI,QAAQ,WAAW,GAAG,OAAO,CAAC,GAAG,IAAI;CAEzC,OAAO,CAAC,GAAG,IAAI,CAAC,CACb,MAAM,GAAG,MAAM;EACd,KAAK,MAAM,EAAE,QAAQ,eAAe,SAAS;GAC3C,MAAM,SAAU,gBAAgB,OAAO,MAAM,CAAC,CAAuB,GAAG,GAAG,SAAS;GACpF,IAAI,WAAW,GAAG,OAAO,cAAc,WAAW,SAAS,CAAC;EAC9D;EACA,OAAO;CACT,CAAC,CAAC,CACD,KAAK,WAAW;EACf,MAAM,WAAY,OAAmC;EACrD,OAAO,MAAM,QAAQ,QAAQ,IACzB;GAAE,GAAG;IAAS,qBAAqB,SAAS,UAAiB,QAAQ,kBAAkB;EAAE,IACzF;CACN,CAAC;AACL;AAEA,MAAa,aAAgB,EAC3B,oBACA,MACA,iBAMA,cACQ,SAAS,MAAM,YAAY,kBAAkB,GACnD;CAAC;CAAM;CAAY;AAAkB,CACvC"}

package/es/Table/pipeline/useTableLocale.mjs

@@ -0,0 +1,30 @@
+import { useTranslation } from "../../i18n/useTranslation.mjs";
+import table_default from "../../i18n/resources/en/table.mjs";
+import { useMemo } from "react";
+//#region src/Table/pipeline/useTableLocale.ts
+const useTableLocale = (locale) => {
+	const { t } = useTranslation(table_default);
+	return useMemo(() => ({
+		cancelSort: t("table.cancelSort"),
+		collapse: t("table.collapse"),
+		expand: t("table.expand"),
+		filterCheckAll: t("table.filterCheckAll"),
+		filterConfirm: t("table.filterConfirm"),
+		filterEmptyText: t("table.filterEmptyText"),
+		filterReset: t("table.filterReset"),
+		filterSearchPlaceholder: t("table.filterSearchPlaceholder"),
+		filterTitle: t("table.filterTitle"),
+		selectAll: t("table.selectAll"),
+		selectInvert: t("table.selectInvert"),
+		selectNone: t("table.selectNone"),
+		selectionAll: t("table.selectionAll"),
+		sortTitle: t("table.sortTitle"),
+		triggerAsc: t("table.triggerAsc"),
+		triggerDesc: t("table.triggerDesc"),
+		...locale
+	}), [t, locale]);
+};
+//#endregion
+export { useTableLocale };
+
+//# sourceMappingURL=useTableLocale.mjs.map

package/es/Table/pipeline/useTableLocale.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"useTableLocale.mjs","names":["tableMessages"],"sources":["../../../src/Table/pipeline/useTableLocale.ts"],"sourcesContent":["import { useMemo } from 'react';\n\nimport tableMessages from '@/i18n/resources/en/table';\nimport { useTranslation } from '@/i18n/useTranslation';\n\nimport type { TableLocale } from '../type';\n\nexport const useTableLocale = (locale: TableLocale | undefined) => {\n  const { t } = useTranslation(tableMessages);\n  return useMemo(\n    (): TableLocale => ({\n      cancelSort: t('table.cancelSort'),\n      collapse: t('table.collapse'),\n      expand: t('table.expand'),\n      filterCheckAll: t('table.filterCheckAll'),\n      filterConfirm: t('table.filterConfirm'),\n      filterEmptyText: t('table.filterEmptyText'),\n      filterReset: t('table.filterReset'),\n      filterSearchPlaceholder: t('table.filterSearchPlaceholder'),\n      filterTitle: t('table.filterTitle'),\n      selectAll: t('table.selectAll'),\n      selectInvert: t('table.selectInvert'),\n      selectNone: t('table.selectNone'),\n      selectionAll: t('table.selectionAll'),\n      sortTitle: t('table.sortTitle'),\n      triggerAsc: t('table.triggerAsc'),\n      triggerDesc: t('table.triggerDesc'),\n      ...locale,\n    }),\n    [t, locale],\n  );\n};\n"],"mappings":";;;;AAOA,MAAa,kBAAkB,WAAoC;CACjE,MAAM,EAAE,MAAM,eAAeA,aAAa;CAC1C,OAAO,eACe;EAClB,YAAY,EAAE,kBAAkB;EAChC,UAAU,EAAE,gBAAgB;EAC5B,QAAQ,EAAE,cAAc;EACxB,gBAAgB,EAAE,sBAAsB;EACxC,eAAe,EAAE,qBAAqB;EACtC,iBAAiB,EAAE,uBAAuB;EAC1C,aAAa,EAAE,mBAAmB;EAClC,yBAAyB,EAAE,+BAA+B;EAC1D,aAAa,EAAE,mBAAmB;EAClC,WAAW,EAAE,iBAAiB;EAC9B,cAAc,EAAE,oBAAoB;EACpC,YAAY,EAAE,kBAAkB;EAChC,cAAc,EAAE,oBAAoB;EACpC,WAAW,EAAE,iBAAiB;EAC9B,YAAY,EAAE,kBAAkB;EAChC,aAAa,EAAE,mBAAmB;EAClC,GAAG;CACL,IACA,CAAC,GAAG,MAAM,CACZ;AACF"}