@lobehub/ui 6.0.0-beta.1 → 6.0.0-beta.11

package/es/ProTable/hooks/useFetchData.mjs

@@ -0,0 +1,97 @@
+import { useCallback, useEffect, useRef, useState } from "react";
+//#region src/ProTable/hooks/useFetchData.ts
+const useFetchData = (options) => {
+	const [data, setData] = useState(options.defaultData ?? []);
+	const [loading, setLoading] = useState(false);
+	const latest = useRef(options);
+	latest.current = options;
+	const requestId = useRef(0);
+	const [enabled, setEnabled] = useState(!options.manual);
+	const [token, setToken] = useState(0);
+	const pending = useRef([]);
+	const updateLoading = (next) => {
+		setLoading(next);
+		latest.current.onLoadingChange?.(next);
+	};
+	const run = useCallback(async () => {
+		const opts = latest.current;
+		if (!opts.request) return;
+		const id = ++requestId.current;
+		updateLoading(true);
+		try {
+			const params = { ...opts.getParams() };
+			if (opts.paginated) {
+				params.current = opts.pageInfo.current;
+				params.pageSize = opts.pageInfo.pageSize;
+			}
+			const response = await opts.request(params, opts.sort, opts.filter) ?? { data: [] };
+			if (id !== requestId.current) return;
+			if (response.success === false) return;
+			const raw = response.data ?? [];
+			const next = opts.postData ? opts.postData(raw) : raw;
+			setData(next);
+			opts.setTotal(response.total ?? next.length);
+			opts.onLoad?.(next);
+			opts.onDataSourceChange?.(next);
+		} catch (error) {
+			if (id !== requestId.current) return;
+			if (opts.onRequestError) opts.onRequestError(error);
+			else console.error(error);
+		} finally {
+			if (id === requestId.current) updateLoading(false);
+			const resolvers = pending.current;
+			pending.current = [];
+			resolvers.forEach((resolve) => resolve());
+		}
+	}, []);
+	const { current, pageSize } = options.pageInfo;
+	useEffect(() => {
+		if (!enabled || !latest.current.request) return;
+		const delay = latest.current.debounceTime;
+		if (delay <= 0) {
+			run();
+			return;
+		}
+		const timer = setTimeout(() => void run(), delay);
+		return () => clearTimeout(timer);
+	}, [
+		enabled,
+		token,
+		options.depsKey,
+		current,
+		pageSize,
+		run
+	]);
+	useEffect(() => {
+		const { polling } = latest.current;
+		if (!polling || loading || !enabled) return;
+		const interval = typeof polling === "function" ? polling(data) : polling;
+		if (!interval) return;
+		const timer = setTimeout(() => void run(), Math.max(interval, 2e3));
+		return () => clearTimeout(timer);
+	}, [
+		data,
+		loading,
+		enabled,
+		options.polling,
+		run
+	]);
+	return {
+		data,
+		loading,
+		reload: useCallback(() => new Promise((resolve) => {
+			if (!latest.current.request) {
+				resolve();
+				return;
+			}
+			pending.current.push(resolve);
+			setEnabled(true);
+			setToken((value) => value + 1);
+		}), []),
+		setData
+	};
+};
+//#endregion
+export { useFetchData };
+
+//# sourceMappingURL=useFetchData.mjs.map

package/es/ProTable/hooks/useFetchData.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"useFetchData.mjs","names":[],"sources":["../../../src/ProTable/hooks/useFetchData.ts"],"sourcesContent":["import { useCallback, useEffect, useRef, useState } from 'react';\n\nimport type { SortOrder } from '@/Table/type';\n\nimport type {\n  ProTablePageInfo,\n  ProTableRequest,\n  ProTableRequestData,\n  ProTableRequestFilter,\n} from '../type';\n\ntype Filter = Record<string, (string | number | boolean)[] | null>;\n\nexport interface UseFetchDataOptions<T> {\n  debounceTime: number;\n  defaultData?: T[];\n  depsKey: string;\n  filter: Filter;\n  getParams: () => Record<string, any>;\n  manual: boolean;\n  onDataSourceChange?: (data: T[]) => void;\n  onLoad?: (data: T[]) => void;\n  onLoadingChange?: (loading: boolean) => void;\n  onRequestError?: (error: Error) => void;\n  pageInfo: ProTablePageInfo;\n  paginated: boolean;\n  polling?: number | ((data: T[]) => number);\n  postData?: (data: T[]) => T[];\n  request?: ProTableRequest<T, any>;\n  setTotal: (total: number) => void;\n  sort: Record<string, SortOrder>;\n}\n\nexport const useFetchData = <T>(options: UseFetchDataOptions<T>) => {\n  const [data, setData] = useState<T[]>(options.defaultData ?? []);\n  const [loading, setLoading] = useState(false);\n  const latest = useRef(options);\n  latest.current = options;\n  const requestId = useRef(0);\n  const [enabled, setEnabled] = useState(!options.manual);\n  const [token, setToken] = useState(0);\n  const pending = useRef<(() => void)[]>([]);\n\n  const updateLoading = (next: boolean) => {\n    setLoading(next);\n    latest.current.onLoadingChange?.(next);\n  };\n\n  const run = useCallback(async () => {\n    const opts = latest.current;\n    if (!opts.request) return;\n    const id = ++requestId.current;\n    updateLoading(true);\n    try {\n      const params: Record<string, any> = { ...opts.getParams() };\n      if (opts.paginated) {\n        params.current = opts.pageInfo.current;\n        params.pageSize = opts.pageInfo.pageSize;\n      }\n      // A `request` resolving `null` / `undefined` (e.g. an empty API body) is treated as empty data.\n      const response: Partial<ProTableRequestData<T>> = (await opts.request(\n        params as any,\n        opts.sort,\n        opts.filter as ProTableRequestFilter,\n      )) ?? { data: [] };\n      if (id !== requestId.current) return;\n      if (response.success === false) {\n        // Pro keeps the previous data when the request reports failure.\n        return;\n      }\n      const raw = response.data ?? [];\n      const next = opts.postData ? opts.postData(raw) : raw;\n      setData(next);\n      opts.setTotal(response.total ?? next.length);\n      opts.onLoad?.(next);\n      opts.onDataSourceChange?.(next);\n    } catch (error) {\n      if (id !== requestId.current) return;\n      if (opts.onRequestError) opts.onRequestError(error as Error);\n      else console.error(error);\n    } finally {\n      if (id === requestId.current) updateLoading(false);\n      const resolvers = pending.current;\n      pending.current = [];\n      resolvers.forEach((resolve) => resolve());\n    }\n  }, []);\n\n  const { current, pageSize } = options.pageInfo;\n  useEffect(() => {\n    if (!enabled || !latest.current.request) return;\n    const delay = latest.current.debounceTime;\n    if (delay <= 0) {\n      void run();\n      return;\n    }\n    const timer = setTimeout(() => void run(), delay);\n    return () => clearTimeout(timer);\n  }, [enabled, token, options.depsKey, current, pageSize, run]);\n\n  useEffect(() => {\n    const { polling } = latest.current;\n    if (!polling || loading || !enabled) return;\n    const interval = typeof polling === 'function' ? polling(data) : polling;\n    if (!interval) return;\n    const timer = setTimeout(() => void run(), Math.max(interval, 2000));\n    return () => clearTimeout(timer);\n  }, [data, loading, enabled, options.polling, run]);\n\n  const reload = useCallback(\n    () =>\n      new Promise<void>((resolve) => {\n        if (!latest.current.request) {\n          resolve();\n          return;\n        }\n        pending.current.push(resolve);\n        setEnabled(true);\n        setToken((value) => value + 1);\n      }),\n    [],\n  );\n\n  return { data, loading, reload, setData };\n};\n"],"mappings":";;AAiCA,MAAa,gBAAmB,YAAoC;CAClE,MAAM,CAAC,MAAM,WAAW,SAAc,QAAQ,eAAe,CAAC,CAAC;CAC/D,MAAM,CAAC,SAAS,cAAc,SAAS,KAAK;CAC5C,MAAM,SAAS,OAAO,OAAO;CAC7B,OAAO,UAAU;CACjB,MAAM,YAAY,OAAO,CAAC;CAC1B,MAAM,CAAC,SAAS,cAAc,SAAS,CAAC,QAAQ,MAAM;CACtD,MAAM,CAAC,OAAO,YAAY,SAAS,CAAC;CACpC,MAAM,UAAU,OAAuB,CAAC,CAAC;CAEzC,MAAM,iBAAiB,SAAkB;EACvC,WAAW,IAAI;EACf,OAAO,QAAQ,kBAAkB,IAAI;CACvC;CAEA,MAAM,MAAM,YAAY,YAAY;EAClC,MAAM,OAAO,OAAO;EACpB,IAAI,CAAC,KAAK,SAAS;EACnB,MAAM,KAAK,EAAE,UAAU;EACvB,cAAc,IAAI;EAClB,IAAI;GACF,MAAM,SAA8B,EAAE,GAAG,KAAK,UAAU,EAAE;GAC1D,IAAI,KAAK,WAAW;IAClB,OAAO,UAAU,KAAK,SAAS;IAC/B,OAAO,WAAW,KAAK,SAAS;GAClC;GAEA,MAAM,WAA6C,MAAM,KAAK,QAC5D,QACA,KAAK,MACL,KAAK,MACP,KAAM,EAAE,MAAM,CAAC,EAAE;GACjB,IAAI,OAAO,UAAU,SAAS;GAC9B,IAAI,SAAS,YAAY,OAEvB;GAEF,MAAM,MAAM,SAAS,QAAQ,CAAC;GAC9B,MAAM,OAAO,KAAK,WAAW,KAAK,SAAS,GAAG,IAAI;GAClD,QAAQ,IAAI;GACZ,KAAK,SAAS,SAAS,SAAS,KAAK,MAAM;GAC3C,KAAK,SAAS,IAAI;GAClB,KAAK,qBAAqB,IAAI;EAChC,SAAS,OAAO;GACd,IAAI,OAAO,UAAU,SAAS;GAC9B,IAAI,KAAK,gBAAgB,KAAK,eAAe,KAAc;QACtD,QAAQ,MAAM,KAAK;EAC1B,UAAU;GACR,IAAI,OAAO,UAAU,SAAS,cAAc,KAAK;GACjD,MAAM,YAAY,QAAQ;GAC1B,QAAQ,UAAU,CAAC;GACnB,UAAU,SAAS,YAAY,QAAQ,CAAC;EAC1C;CACF,GAAG,CAAC,CAAC;CAEL,MAAM,EAAE,SAAS,aAAa,QAAQ;CACtC,gBAAgB;EACd,IAAI,CAAC,WAAW,CAAC,OAAO,QAAQ,SAAS;EACzC,MAAM,QAAQ,OAAO,QAAQ;EAC7B,IAAI,SAAS,GAAG;GACd,IAAS;GACT;EACF;EACA,MAAM,QAAQ,iBAAiB,KAAK,IAAI,GAAG,KAAK;EAChD,aAAa,aAAa,KAAK;CACjC,GAAG;EAAC;EAAS;EAAO,QAAQ;EAAS;EAAS;EAAU;CAAG,CAAC;CAE5D,gBAAgB;EACd,MAAM,EAAE,YAAY,OAAO;EAC3B,IAAI,CAAC,WAAW,WAAW,CAAC,SAAS;EACrC,MAAM,WAAW,OAAO,YAAY,aAAa,QAAQ,IAAI,IAAI;EACjE,IAAI,CAAC,UAAU;EACf,MAAM,QAAQ,iBAAiB,KAAK,IAAI,GAAG,KAAK,IAAI,UAAU,GAAI,CAAC;EACnE,aAAa,aAAa,KAAK;CACjC,GAAG;EAAC;EAAM;EAAS;EAAS,QAAQ;EAAS;CAAG,CAAC;CAgBjD,OAAO;EAAE;EAAM;EAAS,QAdT,kBAEX,IAAI,SAAe,YAAY;GAC7B,IAAI,CAAC,OAAO,QAAQ,SAAS;IAC3B,QAAQ;IACR;GACF;GACA,QAAQ,QAAQ,KAAK,OAAO;GAC5B,WAAW,IAAI;GACf,UAAU,UAAU,QAAQ,CAAC;EAC/B,CAAC,GACH,CAAC,CAG0B;EAAG;CAAQ;AAC1C"}

package/es/ProTable/hooks/useFullscreen.mjs

@@ -0,0 +1,22 @@
+import { useEventCallback } from "../../hooks/useEventCallback.mjs";
+import { useEffect, useState } from "react";
+//#region src/ProTable/hooks/useFullscreen.ts
+const useFullscreen = (rootRef) => {
+	const [fullscreen, setFullscreen] = useState(false);
+	useEffect(() => {
+		if (typeof document === "undefined") return;
+		const sync = () => setFullscreen(document.fullscreenElement === rootRef.current);
+		document.addEventListener("fullscreenchange", sync);
+		return () => document.removeEventListener("fullscreenchange", sync);
+	}, [rootRef]);
+	return [fullscreen, useEventCallback(() => {
+		const node = rootRef.current;
+		if (!node || typeof document === "undefined") return;
+		if (document.fullscreenElement) document.exitFullscreen?.();
+		else node.requestFullscreen?.();
+	})];
+};
+//#endregion
+export { useFullscreen };
+
+//# sourceMappingURL=useFullscreen.mjs.map

package/es/ProTable/hooks/useFullscreen.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"useFullscreen.mjs","names":[],"sources":["../../../src/ProTable/hooks/useFullscreen.ts"],"sourcesContent":["import { type RefObject, useEffect, useState } from 'react';\n\nimport { useEventCallback } from '@/hooks/useEventCallback';\n\nexport const useFullscreen = (rootRef: RefObject<HTMLDivElement | null>) => {\n  const [fullscreen, setFullscreen] = useState(false);\n  useEffect(() => {\n    if (typeof document === 'undefined') return;\n    const sync = () => setFullscreen(document.fullscreenElement === rootRef.current);\n    document.addEventListener('fullscreenchange', sync);\n    return () => document.removeEventListener('fullscreenchange', sync);\n  }, [rootRef]);\n  const toggle = useEventCallback(() => {\n    const node = rootRef.current;\n    if (!node || typeof document === 'undefined') return;\n    if (document.fullscreenElement) void document.exitFullscreen?.();\n    else void node.requestFullscreen?.();\n  });\n  return [fullscreen, toggle] as const;\n};\n"],"mappings":";;;AAIA,MAAa,iBAAiB,YAA8C;CAC1E,MAAM,CAAC,YAAY,iBAAiB,SAAS,KAAK;CAClD,gBAAgB;EACd,IAAI,OAAO,aAAa,aAAa;EACrC,MAAM,aAAa,cAAc,SAAS,sBAAsB,QAAQ,OAAO;EAC/E,SAAS,iBAAiB,oBAAoB,IAAI;EAClD,aAAa,SAAS,oBAAoB,oBAAoB,IAAI;CACpE,GAAG,CAAC,OAAO,CAAC;CAOZ,OAAO,CAAC,YANO,uBAAuB;EACpC,MAAM,OAAO,QAAQ;EACrB,IAAI,CAAC,QAAQ,OAAO,aAAa,aAAa;EAC9C,IAAI,SAAS,mBAAmB,SAAc,iBAAiB;OAC1D,KAAU,oBAAoB;CACrC,CACyB,CAAC;AAC5B"}

package/es/ProTable/hooks/usePageInfo.mjs

@@ -0,0 +1,35 @@
+import { useEventCallback } from "../../hooks/useEventCallback.mjs";
+import { useMemo, useState } from "react";
+//#region src/ProTable/hooks/usePageInfo.ts
+const usePageInfo = (pagination) => {
+	const config = useMemo(() => pagination === false ? false : pagination ?? {}, [pagination]);
+	const [pageInfo, setPageInfoState] = useState(() => ({
+		current: config && (config.current ?? config.defaultCurrent) || 1,
+		pageSize: config && (config.pageSize ?? config.defaultPageSize) || 10,
+		total: 0
+	}));
+	const controlledCurrent = config ? config.current : void 0;
+	const controlledPageSize = config ? config.pageSize : void 0;
+	return {
+		config,
+		pageInfo: useMemo(() => ({
+			...pageInfo,
+			...controlledCurrent !== void 0 && { current: controlledCurrent },
+			...controlledPageSize !== void 0 && { pageSize: controlledPageSize }
+		}), [
+			pageInfo,
+			controlledCurrent,
+			controlledPageSize
+		]),
+		setPageInfo: useEventCallback((next) => setPageInfoState((prev) => {
+			return Object.entries(next).some(([key, value]) => prev[key] !== value) ? {
+				...prev,
+				...next
+			} : prev;
+		}))
+	};
+};
+//#endregion
+export { usePageInfo };
+
+//# sourceMappingURL=usePageInfo.mjs.map

package/es/ProTable/hooks/usePageInfo.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"usePageInfo.mjs","names":[],"sources":["../../../src/ProTable/hooks/usePageInfo.ts"],"sourcesContent":["import { useMemo, useState } from 'react';\n\nimport { useEventCallback } from '@/hooks/useEventCallback';\nimport type { TablePaginationConfig } from '@/Table/type';\n\nimport type { ProTablePageInfo } from '../type';\n\nexport const usePageInfo = (pagination: false | TablePaginationConfig | undefined) => {\n  const config = useMemo(\n    (): TablePaginationConfig | false => (pagination === false ? false : (pagination ?? {})),\n    [pagination],\n  );\n  const [pageInfo, setPageInfoState] = useState<ProTablePageInfo>(() => ({\n    current: (config && (config.current ?? config.defaultCurrent)) || 1,\n    pageSize: (config && (config.pageSize ?? config.defaultPageSize)) || 10,\n    total: 0,\n  }));\n  const controlledCurrent = config ? config.current : undefined;\n  const controlledPageSize = config ? config.pageSize : undefined;\n  const merged = useMemo(\n    (): ProTablePageInfo => ({\n      ...pageInfo,\n      ...(controlledCurrent !== undefined && { current: controlledCurrent }),\n      ...(controlledPageSize !== undefined && { pageSize: controlledPageSize }),\n    }),\n    [pageInfo, controlledCurrent, controlledPageSize],\n  );\n  const setPageInfo = useEventCallback((next: Partial<ProTablePageInfo>) =>\n    setPageInfoState((prev) => {\n      const changed = Object.entries(next).some(\n        ([key, value]) => prev[key as keyof ProTablePageInfo] !== value,\n      );\n      return changed ? { ...prev, ...next } : prev;\n    }),\n  );\n  return { config, pageInfo: merged, setPageInfo };\n};\n"],"mappings":";;;AAOA,MAAa,eAAe,eAA0D;CACpF,MAAM,SAAS,cACyB,eAAe,QAAQ,QAAS,cAAc,CAAC,GACrF,CAAC,UAAU,CACb;CACA,MAAM,CAAC,UAAU,oBAAoB,gBAAkC;EACrE,SAAU,WAAW,OAAO,WAAW,OAAO,mBAAoB;EAClE,UAAW,WAAW,OAAO,YAAY,OAAO,oBAAqB;EACrE,OAAO;CACT,EAAE;CACF,MAAM,oBAAoB,SAAS,OAAO,UAAU,KAAA;CACpD,MAAM,qBAAqB,SAAS,OAAO,WAAW,KAAA;CAiBtD,OAAO;EAAE;EAAQ,UAhBF,eACY;GACvB,GAAG;GACH,GAAI,sBAAsB,KAAA,KAAa,EAAE,SAAS,kBAAkB;GACpE,GAAI,uBAAuB,KAAA,KAAa,EAAE,UAAU,mBAAmB;EACzE,IACA;GAAC;GAAU;GAAmB;EAAkB,CAUlB;EAAG,aARf,kBAAkB,SACpC,kBAAkB,SAAS;GAIzB,OAHgB,OAAO,QAAQ,IAAI,CAAC,CAAC,MAClC,CAAC,KAAK,WAAW,KAAK,SAAmC,KAE/C,IAAI;IAAE,GAAG;IAAM,GAAG;GAAK,IAAI;EAC1C,CAAC,CAE0C;CAAE;AACjD"}

package/es/ProTable/hooks/useProColumns.mjs

@@ -0,0 +1,123 @@
+import ActionIcon from "../../ActionIcon/ActionIcon.mjs";
+import { getByPath, getProColumnKey, isEmptyValue, resolveValueEnum, resolveValueType, valueEnumToList } from "../utils.mjs";
+import { styles } from "../style.mjs";
+import { CopyableText, renderValue } from "../parts/renderValue.mjs";
+import { useMemo } from "react";
+import { jsx, jsxs } from "react/jsx-runtime";
+import { CircleHelp } from "lucide-react";
+//#region src/ProTable/hooks/useProColumns.tsx
+const orderOf = (state, key, index) => state[key]?.order ?? index;
+const sortedEntries = (columns, state) => columns.map((column, index) => ({
+	column,
+	index,
+	key: getProColumnKey(column, index)
+})).sort((a, b) => orderOf(state, a.key, a.index) - orderOf(state, b.key, b.index));
+const useProColumns = ({ actionRef, columnEmptyText, columns, copyLabel, current, pageSize, state }) => {
+	const tableColumns = useMemo(() => {
+		const offset = (current - 1) * pageSize;
+		const convert = (column, index, top) => {
+			const key = getProColumnKey(column, index);
+			const columnState = top ? state[key] : void 0;
+			if (column.hideInTable || columnState?.show === false) return null;
+			const { children, colSize: _colSize, copyable, disable: _disable, fieldProps, filters, formItemProps: _formItemProps, hideInForm: _hideInForm, hideInSearch: _hideInSearch, hideInSetting: _hideInSetting, hideInTable: _hideInTable, initialValue: _initialValue, onFilter, order: _order, render, renderFormItem: _renderFormItem, renderText, search: _search, sorter, title, tooltip: columnTooltip, valueEnum: _valueEnum, valueType: _valueType, ...rest } = column;
+			const titleNode = columnTooltip ? /* @__PURE__ */ jsxs("span", {
+				className: styles.titleTooltip,
+				children: [title, /* @__PURE__ */ jsx(ActionIcon, {
+					icon: CircleHelp,
+					size: "small",
+					title: columnTooltip
+				})]
+			}) : title;
+			if (children?.length) {
+				const childColumns = children.map((child, childIndex) => convert(child, childIndex, false)).filter((child) => child !== null);
+				return {
+					...rest,
+					children: childColumns,
+					key,
+					title: titleNode
+				};
+			}
+			const valueType = resolveValueType(column);
+			const staticEnum = typeof column.valueEnum === "function" ? void 0 : column.valueEnum;
+			const fixed = columnState?.fixed ?? rest.fixed;
+			return {
+				...rest,
+				...valueType === "option" && rest.align === void 0 && { align: "end" },
+				...(valueType === "index" || valueType === "indexBorder") && rest.width === void 0 && { width: 56 },
+				filters: filters === true ? valueEnumToList(staticEnum).map((item) => ({
+					text: item.text,
+					value: item.value
+				})) : filters || void 0,
+				fixed: fixed === "left" ? "start" : fixed === "right" ? "end" : fixed,
+				key,
+				onFilter: onFilter === true ? (value, record) => String(getByPath(record, column.dataIndex)) === String(value) : onFilter || void 0,
+				sorter: typeof sorter === "string" ? true : sorter,
+				title: titleNode,
+				render: (value, record, rowIndex) => {
+					const action = actionRef.current;
+					const text = renderText ? renderText(value, record, rowIndex, action) : value;
+					let dom = renderValue(text, {
+						emptyText: columnEmptyText === false ? null : columnEmptyText,
+						fieldProps,
+						rowIndex: offset + rowIndex,
+						valueEnum: resolveValueEnum(column, record),
+						valueType: resolveValueType(column, record)
+					});
+					if (copyable && !isEmptyValue(text)) dom = /* @__PURE__ */ jsx(CopyableText, {
+						label: copyLabel,
+						text: String(text),
+						children: dom
+					});
+					if (!render) return dom;
+					const result = render(dom, record, rowIndex, action, column);
+					if (valueType === "option" && Array.isArray(result)) return /* @__PURE__ */ jsx("div", {
+						className: styles.optionCell,
+						children: result
+					});
+					return result;
+				}
+			};
+		};
+		return sortedEntries(columns, state).map(({ column, index }) => convert(column, index, true)).filter((column) => column !== null);
+	}, [
+		actionRef,
+		columnEmptyText,
+		columns,
+		copyLabel,
+		current,
+		pageSize,
+		state
+	]);
+	return {
+		settingColumns: useMemo(() => {
+			const list = [];
+			sortedEntries(columns, state).forEach(({ column, key }) => {
+				if (column.hideInTable || column.hideInSetting) return;
+				const disable = state[key]?.disable ?? (typeof column.disable === "object" ? column.disable.checkbox : column.disable);
+				list.push({
+					disabled: !!disable,
+					key,
+					title: column.title ?? key
+				});
+			});
+			return list;
+		}, [columns, state]),
+		sortFieldOf: useMemo(() => {
+			const map = /* @__PURE__ */ new Map();
+			const walk = (list) => list.forEach((column, index) => {
+				if (column.children?.length) walk(column.children);
+				const key = getProColumnKey(column, index);
+				if (typeof column.sorter === "string") map.set(key, column.sorter);
+				else if (Array.isArray(column.dataIndex)) map.set(key, column.dataIndex.join("."));
+				else if (column.dataIndex !== void 0) map.set(key, String(column.dataIndex));
+			});
+			walk(columns);
+			return map;
+		}, [columns]),
+		tableColumns
+	};
+};
+//#endregion
+export { useProColumns };
+
+//# sourceMappingURL=useProColumns.mjs.map

package/es/ProTable/hooks/useProColumns.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"useProColumns.mjs","names":[],"sources":["../../../src/ProTable/hooks/useProColumns.tsx"],"sourcesContent":["import { CircleHelp } from 'lucide-react';\nimport { type ReactNode, type RefObject, useMemo } from 'react';\n\nimport ActionIcon from '@/ActionIcon';\nimport type { TableColumn } from '@/Table/type';\n\nimport type { SettingColumn } from '../parts/ColumnSetting';\nimport { CopyableText, renderValue } from '../parts/renderValue';\nimport { styles } from '../style';\nimport type { ProColumnType, ProTableActionType, ProTableColumnsStateMap } from '../type';\nimport {\n  getByPath,\n  getProColumnKey,\n  isEmptyValue,\n  resolveValueEnum,\n  resolveValueType,\n  valueEnumToList,\n} from '../utils';\n\ninterface ProColumnsOptions<T> {\n  actionRef: RefObject<ProTableActionType | undefined>;\n  columnEmptyText: ReactNode | false;\n  columns: ProColumnType<T>[];\n  copyLabel: string;\n  current: number;\n  pageSize: number;\n  state: ProTableColumnsStateMap;\n}\n\nconst orderOf = (state: ProTableColumnsStateMap, key: string, index: number) =>\n  state[key]?.order ?? index;\n\nconst sortedEntries = <T,>(columns: ProColumnType<T>[], state: ProTableColumnsStateMap) =>\n  columns\n    .map((column, index) => ({ column, index, key: getProColumnKey(column, index) }))\n    .sort((a, b) => orderOf(state, a.key, a.index) - orderOf(state, b.key, b.index));\n\nexport const useProColumns = <T,>({\n  actionRef,\n  columnEmptyText,\n  columns,\n  copyLabel,\n  current,\n  pageSize,\n  state,\n}: ProColumnsOptions<T>) => {\n  const tableColumns = useMemo(() => {\n    const offset = (current - 1) * pageSize;\n\n    const convert = (\n      column: ProColumnType<T>,\n      index: number,\n      top: boolean,\n    ): TableColumn<T> | null => {\n      const key = getProColumnKey(column, index);\n      const columnState = top ? state[key] : undefined;\n      if (column.hideInTable || columnState?.show === false) return null;\n\n      const {\n        children,\n        colSize: _colSize,\n        copyable,\n        disable: _disable,\n        fieldProps,\n        filters,\n        formItemProps: _formItemProps,\n        hideInForm: _hideInForm,\n        hideInSearch: _hideInSearch,\n        hideInSetting: _hideInSetting,\n        hideInTable: _hideInTable,\n        initialValue: _initialValue,\n        onFilter,\n        order: _order,\n        render,\n        renderFormItem: _renderFormItem,\n        renderText,\n        search: _search,\n        sorter,\n        title,\n        tooltip: columnTooltip,\n        valueEnum: _valueEnum,\n        valueType: _valueType,\n        ...rest\n      } = column;\n\n      const titleNode: ReactNode = columnTooltip ? (\n        <span className={styles.titleTooltip}>\n          {title}\n          <ActionIcon icon={CircleHelp} size=\"small\" title={columnTooltip} />\n        </span>\n      ) : (\n        title\n      );\n\n      if (children?.length) {\n        const childColumns = children\n          .map((child, childIndex) => convert(child, childIndex, false))\n          .filter((child): child is TableColumn<T> => child !== null);\n        return { ...(rest as any), children: childColumns, key, title: titleNode };\n      }\n\n      const valueType = resolveValueType(column);\n      const staticEnum = typeof column.valueEnum === 'function' ? undefined : column.valueEnum;\n      const fixed = columnState?.fixed ?? rest.fixed;\n      return {\n        ...(rest as any),\n        ...(valueType === 'option' && rest.align === undefined && { align: 'end' }),\n        ...((valueType === 'index' || valueType === 'indexBorder') &&\n          rest.width === undefined && { width: 56 }),\n        filters:\n          filters === true\n            ? valueEnumToList(staticEnum).map((item) => ({ text: item.text, value: item.value }))\n            : filters || undefined,\n        fixed: fixed === 'left' ? 'start' : fixed === 'right' ? 'end' : fixed,\n        key,\n        onFilter:\n          onFilter === true\n            ? (value: unknown, record: T) =>\n                String(getByPath(record, column.dataIndex)) === String(value)\n            : onFilter || undefined,\n        sorter: typeof sorter === 'string' ? true : sorter,\n        title: titleNode,\n        render: (value: any, record: T, rowIndex: number) => {\n          const action = actionRef.current;\n          const text = renderText ? renderText(value, record, rowIndex, action) : value;\n          let dom: ReactNode = renderValue(text, {\n            emptyText: columnEmptyText === false ? null : columnEmptyText,\n            fieldProps,\n            rowIndex: offset + rowIndex,\n            valueEnum: resolveValueEnum(column, record),\n            valueType: resolveValueType(column, record),\n          });\n          if (copyable && !isEmptyValue(text)) {\n            dom = (\n              <CopyableText label={copyLabel} text={String(text)}>\n                {dom}\n              </CopyableText>\n            );\n          }\n          if (!render) return dom;\n          const result = render(dom, record, rowIndex, action, column);\n          if (valueType === 'option' && Array.isArray(result)) {\n            return <div className={styles.optionCell}>{result}</div>;\n          }\n          return result;\n        },\n      } as TableColumn<T>;\n    };\n\n    return sortedEntries(columns, state)\n      .map(({ column, index }) => convert(column, index, true))\n      .filter((column): column is TableColumn<T> => column !== null);\n  }, [actionRef, columnEmptyText, columns, copyLabel, current, pageSize, state]);\n\n  const settingColumns = useMemo(() => {\n    const list: SettingColumn[] = [];\n    sortedEntries(columns, state).forEach(({ column, key }) => {\n      if (column.hideInTable || column.hideInSetting) return;\n      const disable =\n        state[key]?.disable ??\n        (typeof column.disable === 'object' ? column.disable.checkbox : column.disable);\n      list.push({ disabled: !!disable, key, title: column.title ?? key });\n    });\n    return list;\n  }, [columns, state]);\n\n  const sortFieldOf = useMemo(() => {\n    const map = new Map<string, string>();\n    const walk = (list: ProColumnType<T>[]) =>\n      list.forEach((column, index) => {\n        if (column.children?.length) walk(column.children);\n        const key = getProColumnKey(column, index);\n        if (typeof column.sorter === 'string') map.set(key, column.sorter);\n        else if (Array.isArray(column.dataIndex)) map.set(key, column.dataIndex.join('.'));\n        else if (column.dataIndex !== undefined) map.set(key, String(column.dataIndex));\n      });\n    walk(columns);\n    return map;\n  }, [columns]);\n\n  return { settingColumns, sortFieldOf, tableColumns };\n};\n"],"mappings":";;;;;;;;AA6BA,MAAM,WAAW,OAAgC,KAAa,UAC5D,MAAM,IAAI,EAAE,SAAS;AAEvB,MAAM,iBAAqB,SAA6B,UACtD,QACG,KAAK,QAAQ,WAAW;CAAE;CAAQ;CAAO,KAAK,gBAAgB,QAAQ,KAAK;AAAE,EAAE,CAAC,CAChF,MAAM,GAAG,MAAM,QAAQ,OAAO,EAAE,KAAK,EAAE,KAAK,IAAI,QAAQ,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC;AAEnF,MAAa,iBAAqB,EAChC,WACA,iBACA,SACA,WACA,SACA,UACA,YAC0B;CAC1B,MAAM,eAAe,cAAc;EACjC,MAAM,UAAU,UAAU,KAAK;EAE/B,MAAM,WACJ,QACA,OACA,QAC0B;GAC1B,MAAM,MAAM,gBAAgB,QAAQ,KAAK;GACzC,MAAM,cAAc,MAAM,MAAM,OAAO,KAAA;GACvC,IAAI,OAAO,eAAe,aAAa,SAAS,OAAO,OAAO;GAE9D,MAAM,EACJ,UACA,SAAS,UACT,UACA,SAAS,UACT,YACA,SACA,eAAe,gBACf,YAAY,aACZ,cAAc,eACd,eAAe,gBACf,aAAa,cACb,cAAc,eACd,UACA,OAAO,QACP,QACA,gBAAgB,iBAChB,YACA,QAAQ,SACR,QACA,OACA,SAAS,eACT,WAAW,YACX,WAAW,YACX,GAAG,SACD;GAEJ,MAAM,YAAuB,gBAC3B,qBAAC,QAAD;IAAM,WAAW,OAAO;IAAxB,UAAA,CACG,OACD,oBAAC,YAAD;KAAY,MAAM;KAAY,MAAK;KAAQ,OAAO;IAAgB,CAAA,CAC9D;GAEN,CAAA,IAAA;GAGF,IAAI,UAAU,QAAQ;IACpB,MAAM,eAAe,SAClB,KAAK,OAAO,eAAe,QAAQ,OAAO,YAAY,KAAK,CAAC,CAAC,CAC7D,QAAQ,UAAmC,UAAU,IAAI;IAC5D,OAAO;KAAE,GAAI;KAAc,UAAU;KAAc;KAAK,OAAO;IAAU;GAC3E;GAEA,MAAM,YAAY,iBAAiB,MAAM;GACzC,MAAM,aAAa,OAAO,OAAO,cAAc,aAAa,KAAA,IAAY,OAAO;GAC/E,MAAM,QAAQ,aAAa,SAAS,KAAK;GACzC,OAAO;IACL,GAAI;IACJ,GAAI,cAAc,YAAY,KAAK,UAAU,KAAA,KAAa,EAAE,OAAO,MAAM;IACzE,IAAK,cAAc,WAAW,cAAc,kBAC1C,KAAK,UAAU,KAAA,KAAa,EAAE,OAAO,GAAG;IAC1C,SACE,YAAY,OACR,gBAAgB,UAAU,CAAC,CAAC,KAAK,UAAU;KAAE,MAAM,KAAK;KAAM,OAAO,KAAK;IAAM,EAAE,IAClF,WAAW,KAAA;IACjB,OAAO,UAAU,SAAS,UAAU,UAAU,UAAU,QAAQ;IAChE;IACA,UACE,aAAa,QACR,OAAgB,WACf,OAAO,UAAU,QAAQ,OAAO,SAAS,CAAC,MAAM,OAAO,KAAK,IAC9D,YAAY,KAAA;IAClB,QAAQ,OAAO,WAAW,WAAW,OAAO;IAC5C,OAAO;IACP,SAAS,OAAY,QAAW,aAAqB;KACnD,MAAM,SAAS,UAAU;KACzB,MAAM,OAAO,aAAa,WAAW,OAAO,QAAQ,UAAU,MAAM,IAAI;KACxE,IAAI,MAAiB,YAAY,MAAM;MACrC,WAAW,oBAAoB,QAAQ,OAAO;MAC9C;MACA,UAAU,SAAS;MACnB,WAAW,iBAAiB,QAAQ,MAAM;MAC1C,WAAW,iBAAiB,QAAQ,MAAM;KAC5C,CAAC;KACD,IAAI,YAAY,CAAC,aAAa,IAAI,GAChC,MACE,oBAAC,cAAD;MAAc,OAAO;MAAW,MAAM,OAAO,IAAI;MAC9C,UAAA;KACW,CAAA;KAGlB,IAAI,CAAC,QAAQ,OAAO;KACpB,MAAM,SAAS,OAAO,KAAK,QAAQ,UAAU,QAAQ,MAAM;KAC3D,IAAI,cAAc,YAAY,MAAM,QAAQ,MAAM,GAChD,OAAO,oBAAC,OAAD;MAAK,WAAW,OAAO;MAAa,UAAA;KAAY,CAAA;KAEzD,OAAO;IACT;GACF;EACF;EAEA,OAAO,cAAc,SAAS,KAAK,CAAC,CACjC,KAAK,EAAE,QAAQ,YAAY,QAAQ,QAAQ,OAAO,IAAI,CAAC,CAAC,CACxD,QAAQ,WAAqC,WAAW,IAAI;CACjE,GAAG;EAAC;EAAW;EAAiB;EAAS;EAAW;EAAS;EAAU;CAAK,CAAC;CA4B7E,OAAO;EAAE,gBA1Bc,cAAc;GACnC,MAAM,OAAwB,CAAC;GAC/B,cAAc,SAAS,KAAK,CAAC,CAAC,SAAS,EAAE,QAAQ,UAAU;IACzD,IAAI,OAAO,eAAe,OAAO,eAAe;IAChD,MAAM,UACJ,MAAM,IAAI,EAAE,YACX,OAAO,OAAO,YAAY,WAAW,OAAO,QAAQ,WAAW,OAAO;IACzE,KAAK,KAAK;KAAE,UAAU,CAAC,CAAC;KAAS;KAAK,OAAO,OAAO,SAAS;IAAI,CAAC;GACpE,CAAC;GACD,OAAO;EACT,GAAG,CAAC,SAAS,KAAK,CAgBI;EAAG,aAdL,cAAc;GAChC,MAAM,sBAAM,IAAI,IAAoB;GACpC,MAAM,QAAQ,SACZ,KAAK,SAAS,QAAQ,UAAU;IAC9B,IAAI,OAAO,UAAU,QAAQ,KAAK,OAAO,QAAQ;IACjD,MAAM,MAAM,gBAAgB,QAAQ,KAAK;IACzC,IAAI,OAAO,OAAO,WAAW,UAAU,IAAI,IAAI,KAAK,OAAO,MAAM;SAC5D,IAAI,MAAM,QAAQ,OAAO,SAAS,GAAG,IAAI,IAAI,KAAK,OAAO,UAAU,KAAK,GAAG,CAAC;SAC5E,IAAI,OAAO,cAAc,KAAA,GAAW,IAAI,IAAI,KAAK,OAAO,OAAO,SAAS,CAAC;GAChF,CAAC;GACH,KAAK,OAAO;GACZ,OAAO;EACT,GAAG,CAAC,OAAO,CAEwB;EAAG;CAAa;AACrD"}

package/es/ProTable/hooks/useProLoading.mjs

@@ -0,0 +1,19 @@
+import { useDelayedFlag } from "./useDelayedFlag.mjs";
+//#region src/ProTable/hooks/useProLoading.ts
+const useProLoading = (loadingProp, fetching, hasRequest) => {
+	const config = typeof loadingProp === "object" ? loadingProp : void 0;
+	const { delay, ...spin } = config ?? {};
+	const raw = config === void 0 ? loadingProp ?? fetching : config.spinning ?? (hasRequest ? fetching : true);
+	const loading = useDelayedFlag(raw, delay);
+	return {
+		loading,
+		tableLoading: config ? {
+			...spin,
+			spinning: loading
+		} : loading
+	};
+};
+//#endregion
+export { useProLoading };
+
+//# sourceMappingURL=useProLoading.mjs.map

package/es/ProTable/hooks/useProLoading.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"useProLoading.mjs","names":[],"sources":["../../../src/ProTable/hooks/useProLoading.ts"],"sourcesContent":["import type { TableLoadingConfig } from '@/Table/type';\n\nimport type { ProTableProps } from '../type';\nimport { useDelayedFlag } from './useDelayedFlag';\n\nexport const useProLoading = (\n  loadingProp: ProTableProps['loading'],\n  fetching: boolean,\n  hasRequest: boolean,\n) => {\n  const config = typeof loadingProp === 'object' ? loadingProp : undefined;\n  const { delay, ...spin } = config ?? {};\n  const raw =\n    config === undefined\n      ? ((loadingProp as boolean | undefined) ?? fetching)\n      : (config.spinning ?? (hasRequest ? fetching : true));\n  const loading = useDelayedFlag(raw, delay);\n  const tableLoading: boolean | TableLoadingConfig = config\n    ? { ...spin, spinning: loading }\n    : loading;\n  return { loading, tableLoading };\n};\n"],"mappings":";;AAKA,MAAa,iBACX,aACA,UACA,eACG;CACH,MAAM,SAAS,OAAO,gBAAgB,WAAW,cAAc,KAAA;CAC/D,MAAM,EAAE,OAAO,GAAG,SAAS,UAAU,CAAC;CACtC,MAAM,MACJ,WAAW,KAAA,IACL,eAAuC,WACxC,OAAO,aAAa,aAAa,WAAW;CACnD,MAAM,UAAU,eAAe,KAAK,KAAK;CAIzC,OAAO;EAAE;EAAS,cAHiC,SAC/C;GAAE,GAAG;GAAM,UAAU;EAAQ,IAC7B;CAC2B;AACjC"}

package/es/ProTable/hooks/useProLocale.mjs

@@ -0,0 +1,22 @@
+import { useI18n } from "../../ConfigProvider/index.mjs";
+import { PRO_TABLE_LOCALE_EN_US, resolveProTableLocale } from "../locale.mjs";
+import { useMemo } from "react";
+//#region src/ProTable/hooks/useProLocale.ts
+const useProLocale = (localeProp) => {
+	const i18n = useI18n();
+	return {
+		locale: useMemo(() => ({
+			...resolveProTableLocale(i18n?.locale),
+			...localeProp
+		}), [i18n?.locale, localeProp]),
+		tableLocale: useMemo(() => {
+			if (!localeProp) return void 0;
+			const entries = Object.entries(localeProp).filter(([key]) => !(key in PRO_TABLE_LOCALE_EN_US));
+			return entries.length > 0 ? Object.fromEntries(entries) : void 0;
+		}, [localeProp])
+	};
+};
+//#endregion
+export { useProLocale };
+
+//# sourceMappingURL=useProLocale.mjs.map

package/es/ProTable/hooks/useProLocale.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"useProLocale.mjs","names":[],"sources":["../../../src/ProTable/hooks/useProLocale.ts"],"sourcesContent":["import { useMemo } from 'react';\n\nimport { useI18n } from '@/ConfigProvider';\nimport type { TableLocale } from '@/Table/type';\n\nimport { PRO_TABLE_LOCALE_EN_US, resolveProTableLocale } from '../locale';\nimport type { ProTableProps } from '../type';\n\nexport const useProLocale = (localeProp: ProTableProps['locale']) => {\n  const i18n = useI18n();\n  const locale = useMemo(\n    () => ({ ...resolveProTableLocale(i18n?.locale), ...localeProp }),\n    [i18n?.locale, localeProp],\n  );\n  const tableLocale = useMemo(() => {\n    if (!localeProp) return undefined;\n    const entries = Object.entries(localeProp).filter(([key]) => !(key in PRO_TABLE_LOCALE_EN_US));\n    return entries.length > 0 ? (Object.fromEntries(entries) as TableLocale) : undefined;\n  }, [localeProp]);\n  return { locale, tableLocale };\n};\n"],"mappings":";;;;AAQA,MAAa,gBAAgB,eAAwC;CACnE,MAAM,OAAO,QAAQ;CAUrB,OAAO;EAAE,QATM,eACN;GAAE,GAAG,sBAAsB,MAAM,MAAM;GAAG,GAAG;EAAW,IAC/D,CAAC,MAAM,QAAQ,UAAU,CAOb;EAAG,aALG,cAAc;GAChC,IAAI,CAAC,YAAY,OAAO,KAAA;GACxB,MAAM,UAAU,OAAO,QAAQ,UAAU,CAAC,CAAC,QAAQ,CAAC,SAAS,EAAE,OAAO,uBAAuB;GAC7F,OAAO,QAAQ,SAAS,IAAK,OAAO,YAAY,OAAO,IAAoB,KAAA;EAC7E,GAAG,CAAC,UAAU,CACa;CAAE;AAC/B"}

package/es/ProTable/hooks/useProRequest.mjs

@@ -0,0 +1,137 @@
+import { useEventCallback } from "../../hooks/useEventCallback.mjs";
+import { useFetchData } from "./useFetchData.mjs";
+import { getSearchFields, useSearchForm } from "./useSearchForm.mjs";
+import { useEffect, useImperativeHandle, useMemo, useRef, useState } from "react";
+//#region src/ProTable/hooks/useProRequest.ts
+const stableKey = (value) => {
+	try {
+		return JSON.stringify(value, (_key, item) => item instanceof Date ? item.toISOString() : item);
+	} catch {
+		return String(Math.random());
+	}
+};
+const useProRequest = ({ pageInfo, paginated, props, setPageInfo, sortFieldOf }) => {
+	const { beforeSearchSubmit, columns = [], dateFormatter = "string", debounceTime = 10, defaultData, form: formConfig, formRef, manualRequest = false, onChange, onDataSourceChange, onLoad, onLoadingChange, onRequestError, onReset, onSubmit, options, params, polling, postData, request } = props;
+	const [sort, setSort] = useState({});
+	const [filter, setFilter] = useState({});
+	const searchFields = useMemo(() => getSearchFields(columns), [columns]);
+	const [formParams, setFormParams] = useState({});
+	const [keyword, setKeyword] = useState(void 0);
+	const formReadyRef = useRef(false);
+	const applyFormValues = (formatted) => {
+		const next = beforeSearchSubmit ? beforeSearchSubmit(formatted) : formatted;
+		formReadyRef.current = true;
+		setFormParams(next);
+		setPageInfo({ current: 1 });
+		return next;
+	};
+	const handleSubmit = useEventCallback((formatted) => {
+		const next = applyFormValues(formatted);
+		onSubmit?.(next);
+		fetcher.reload();
+	});
+	const { form } = useSearchForm({
+		dateFormatter,
+		fields: searchFields,
+		initialValues: formConfig?.initialValues,
+		onSubmit: handleSubmit,
+		onValuesChange: formConfig?.onValuesChange,
+		validateOn: formConfig?.validateOn
+	});
+	const initialFormParams = useMemo(() => form.getFieldsFormatValue(), [form]);
+	const effectiveFormParams = formReadyRef.current ? formParams : initialFormParams;
+	useImperativeHandle(formRef, () => form, [form]);
+	const keywordName = options && typeof options.search === "object" ? options.search.name ?? "keyword" : "keyword";
+	const fetcher = useFetchData({
+		debounceTime,
+		defaultData,
+		depsKey: stableKey([
+			effectiveFormParams,
+			params,
+			keyword,
+			sort,
+			filter
+		]),
+		filter,
+		getParams: () => ({
+			...effectiveFormParams,
+			...params,
+			...keyword !== void 0 && keyword !== "" && { [keywordName]: keyword }
+		}),
+		manual: manualRequest,
+		onDataSourceChange,
+		onLoad,
+		onLoadingChange,
+		onRequestError,
+		pageInfo,
+		paginated,
+		polling,
+		postData,
+		request,
+		setTotal: (total) => setPageInfo({ total }),
+		sort
+	});
+	const paramsKey = stableKey(params);
+	const firstParamsRef = useRef(true);
+	useEffect(() => {
+		if (firstParamsRef.current) {
+			firstParamsRef.current = false;
+			return;
+		}
+		setPageInfo({ current: 1 });
+	}, [paramsKey, setPageInfo]);
+	const reload = useEventCallback(async (resetPageIndex) => {
+		if (resetPageIndex) setPageInfo({ current: 1 });
+		await fetcher.reload();
+	});
+	const reset = useEventCallback(() => {
+		form.resetFields();
+		applyFormValues(form.getFieldsFormatValue());
+		fetcher.reload();
+	});
+	const handleReset = useEventCallback(() => {
+		reset();
+		onReset?.();
+	});
+	const searchKeyword = useEventCallback((value) => {
+		setKeyword(value);
+		setPageInfo({ current: 1 });
+	});
+	const handleTableChange = useEventCallback((pagination, filters, sorter, extra) => {
+		if (extra.action === "sort") {
+			const next = {};
+			(Array.isArray(sorter) ? sorter : [sorter]).forEach((item) => {
+				if (!item.order || item.columnKey === void 0) return;
+				const columnKey = String(item.columnKey);
+				next[sortFieldOf.get(columnKey) ?? columnKey] = item.order;
+			});
+			setSort(next);
+		}
+		if (extra.action === "filter") {
+			const next = {};
+			Object.entries(filters).forEach(([columnKey, value]) => {
+				next[sortFieldOf.get(columnKey) ?? columnKey] = value;
+			});
+			setFilter(next);
+		}
+		onChange?.(pagination, filters, sorter, extra);
+	});
+	return {
+		fetcher,
+		form,
+		getSortFilter: useEventCallback(() => ({
+			filter,
+			sort
+		})),
+		handleReset,
+		handleTableChange,
+		reload,
+		reset,
+		searchFields,
+		searchKeyword
+	};
+};
+//#endregion
+export { useProRequest };
+
+//# sourceMappingURL=useProRequest.mjs.map

package/es/ProTable/hooks/useProRequest.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"useProRequest.mjs","names":[],"sources":["../../../src/ProTable/hooks/useProRequest.ts"],"sourcesContent":["import { type Ref, useEffect, useImperativeHandle, useMemo, useRef, useState } from 'react';\n\nimport { useEventCallback } from '@/hooks/useEventCallback';\nimport type {\n  SortOrder,\n  TableFilters,\n  TablePaginationConfig,\n  TableSorterResult,\n} from '@/Table/type';\n\nimport type { ProTableFormInstance, ProTablePageInfo, ProTableProps } from '../type';\nimport { useFetchData } from './useFetchData';\nimport { getSearchFields, useSearchForm } from './useSearchForm';\n\ntype Filter = Record<string, (string | number | boolean)[] | null>;\n\nconst stableKey = (value: unknown) => {\n  try {\n    return JSON.stringify(value, (_key, item) =>\n      item instanceof Date ? item.toISOString() : item,\n    );\n  } catch {\n    return String(Math.random());\n  }\n};\n\ninterface ProRequestOptions<T> {\n  pageInfo: ProTablePageInfo;\n  paginated: boolean;\n  props: ProTableProps<T, any>;\n  setPageInfo: (next: Partial<ProTablePageInfo>) => void;\n  sortFieldOf: Map<string, string>;\n}\n\nexport const useProRequest = <T>({\n  pageInfo,\n  paginated,\n  props,\n  setPageInfo,\n  sortFieldOf,\n}: ProRequestOptions<T>) => {\n  const {\n    beforeSearchSubmit,\n    columns = [],\n    dateFormatter = 'string',\n    debounceTime = 10,\n    defaultData,\n    form: formConfig,\n    formRef,\n    manualRequest = false,\n    onChange,\n    onDataSourceChange,\n    onLoad,\n    onLoadingChange,\n    onRequestError,\n    onReset,\n    onSubmit,\n    options,\n    params,\n    polling,\n    postData,\n    request,\n  } = props;\n\n  const [sort, setSort] = useState<Record<string, SortOrder>>({});\n  const [filter, setFilter] = useState<Filter>({});\n  const searchFields = useMemo(() => getSearchFields(columns), [columns]);\n  const [formParams, setFormParams] = useState<Record<string, any>>({});\n  const [keyword, setKeyword] = useState<string | undefined>(undefined);\n  const formReadyRef = useRef(false);\n\n  const applyFormValues = (formatted: Record<string, any>) => {\n    const next = beforeSearchSubmit ? beforeSearchSubmit(formatted) : formatted;\n    formReadyRef.current = true;\n    setFormParams(next);\n    setPageInfo({ current: 1 });\n    return next;\n  };\n\n  const handleSubmit = useEventCallback((formatted: Record<string, any>) => {\n    const next = applyFormValues(formatted);\n    onSubmit?.(next);\n    void fetcher.reload();\n  });\n\n  const { form } = useSearchForm({\n    dateFormatter,\n    fields: searchFields,\n    initialValues: formConfig?.initialValues,\n    onSubmit: handleSubmit,\n    onValuesChange: formConfig?.onValuesChange,\n    validateOn: formConfig?.validateOn,\n  });\n  const initialFormParams = useMemo(() => form.getFieldsFormatValue(), [form]);\n  const effectiveFormParams = formReadyRef.current ? formParams : initialFormParams;\n  useImperativeHandle(formRef as Ref<ProTableFormInstance>, () => form, [form]);\n\n  const keywordName =\n    options && typeof options.search === 'object' ? (options.search.name ?? 'keyword') : 'keyword';\n\n  const fetcher = useFetchData<T>({\n    debounceTime,\n    defaultData,\n    depsKey: stableKey([effectiveFormParams, params, keyword, sort, filter]),\n    filter,\n    getParams: () => ({\n      ...effectiveFormParams,\n      ...params,\n      ...(keyword !== undefined && keyword !== '' && { [keywordName]: keyword }),\n    }),\n    manual: manualRequest,\n    onDataSourceChange,\n    onLoad,\n    onLoadingChange,\n    onRequestError,\n    pageInfo,\n    paginated,\n    polling,\n    postData,\n    request,\n    setTotal: (total) => setPageInfo({ total }),\n    sort,\n  });\n\n  const paramsKey = stableKey(params);\n  const firstParamsRef = useRef(true);\n  useEffect(() => {\n    if (firstParamsRef.current) {\n      firstParamsRef.current = false;\n      return;\n    }\n    setPageInfo({ current: 1 });\n  }, [paramsKey, setPageInfo]);\n\n  const reload = useEventCallback(async (resetPageIndex?: boolean) => {\n    if (resetPageIndex) setPageInfo({ current: 1 });\n    await fetcher.reload();\n  });\n\n  const reset = useEventCallback(() => {\n    form.resetFields();\n    applyFormValues(form.getFieldsFormatValue());\n    void fetcher.reload();\n  });\n\n  const handleReset = useEventCallback(() => {\n    reset();\n    onReset?.();\n  });\n\n  const searchKeyword = useEventCallback((value: string | undefined) => {\n    setKeyword(value);\n    setPageInfo({ current: 1 });\n  });\n\n  const handleTableChange = useEventCallback(\n    (\n      pagination: TablePaginationConfig,\n      filters: TableFilters,\n      sorter: TableSorterResult<T> | TableSorterResult<T>[],\n      extra: Parameters<NonNullable<ProTableProps<T>['onChange']>>[3],\n    ) => {\n      if (extra.action === 'sort') {\n        const next: Record<string, SortOrder> = {};\n        (Array.isArray(sorter) ? sorter : [sorter]).forEach((item) => {\n          if (!item.order || item.columnKey === undefined) return;\n          const columnKey = String(item.columnKey);\n          next[sortFieldOf.get(columnKey) ?? columnKey] = item.order;\n        });\n        setSort(next);\n      }\n      if (extra.action === 'filter') {\n        const next: Filter = {};\n        Object.entries(filters).forEach(([columnKey, value]) => {\n          next[sortFieldOf.get(columnKey) ?? columnKey] = value;\n        });\n        setFilter(next);\n      }\n      onChange?.(pagination, filters, sorter, extra);\n    },\n  );\n\n  const getSortFilter = useEventCallback(() => ({ filter, sort }));\n\n  return {\n    fetcher,\n    form,\n    getSortFilter,\n    handleReset,\n    handleTableChange,\n    reload,\n    reset,\n    searchFields,\n    searchKeyword,\n  };\n};\n"],"mappings":"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"}

package/es/ProTable/hooks/useRowCache.mjs

@@ -0,0 +1,11 @@
+import { useCallback, useRef } from "react";
+//#region src/ProTable/hooks/useRowCache.ts
+const useRowCache = (rows, rowKey) => {
+	const cacheRef = useRef(/* @__PURE__ */ new Map());
+	rows.forEach((record, index) => cacheRef.current.set(typeof rowKey === "function" ? rowKey(record, index) : record[rowKey], record));
+	return useCallback((key) => cacheRef.current.get(key), []);
+};
+//#endregion
+export { useRowCache };
+
+//# sourceMappingURL=useRowCache.mjs.map

package/es/ProTable/hooks/useRowCache.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"useRowCache.mjs","names":[],"sources":["../../../src/ProTable/hooks/useRowCache.ts"],"sourcesContent":["import { type Key, useCallback, useRef } from 'react';\n\nexport const useRowCache = <T extends Record<string, any>>(\n  rows: readonly T[],\n  rowKey: string | ((record: T, index?: number) => Key),\n) => {\n  const cacheRef = useRef(new Map<Key, T>());\n  rows.forEach((record, index) =>\n    cacheRef.current.set(\n      typeof rowKey === 'function' ? rowKey(record, index) : record[rowKey],\n      record,\n    ),\n  );\n  return useCallback((key: Key) => cacheRef.current.get(key), []);\n};\n"],"mappings":";;AAEA,MAAa,eACX,MACA,WACG;CACH,MAAM,WAAW,uBAAO,IAAI,IAAY,CAAC;CACzC,KAAK,SAAS,QAAQ,UACpB,SAAS,QAAQ,IACf,OAAO,WAAW,aAAa,OAAO,QAAQ,KAAK,IAAI,OAAO,SAC9D,MACF,CACF;CACA,OAAO,aAAa,QAAa,SAAS,QAAQ,IAAI,GAAG,GAAG,CAAC,CAAC;AAChE"}