@superad/ui 0.1.1

package/es/Table/react/useTableCellEvents.mjs

@@ -0,0 +1,32 @@
+"use client";
+import { handleTableCellClick } from "../vtable/interaction.mjs";
+import { refreshRowSeriesHover } from "../canvas/rowSeries.mjs";
+//#region src/Table/react/useTableCellEvents.ts
+const useTableCellEvents = ({ applyHint, hintAtCell, lastRowSeriesHoverRef, tableRef }) => {
+	const onClickCell = (args) => {
+		const table = tableRef.current;
+		if (table != null) handleTableCellClick(table, args);
+		applyHint(null);
+	};
+	const onMouseEnterCell = (args) => {
+		hintAtCell(args.col, args.row);
+	};
+	const onMouseMoveCell = (args) => {
+		const table = tableRef.current;
+		if (table != null) {
+			const previous = lastRowSeriesHoverRef.current;
+			lastRowSeriesHoverRef.current = args.row;
+			refreshRowSeriesHover(table, previous, args.row);
+		}
+		hintAtCell(args.col, args.row);
+	};
+	return {
+		onClickCell,
+		onMouseEnterCell,
+		onMouseMoveCell
+	};
+};
+//#endregion
+export { useTableCellEvents };
+
+//# sourceMappingURL=useTableCellEvents.mjs.map

package/es/Table/react/useTableCellEvents.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"useTableCellEvents.mjs","names":[],"sources":["../../../src/Table/react/useTableCellEvents.ts"],"sourcesContent":["'use client';\n\nimport type { ListTable as ListTableInstance } from '@visactor/vtable';\nimport type { RefObject } from 'react';\n\nimport { refreshRowSeriesHover } from '../canvas/rowSeries';\nimport { type CellEditHint, handleTableCellClick } from '../vtable/interaction';\n\nexport const useTableCellEvents = ({\n  applyHint,\n  hintAtCell,\n  lastRowSeriesHoverRef,\n  tableRef,\n}: {\n  applyHint: (hint: CellEditHint | null) => void;\n  hintAtCell: (col: number, row: number) => void;\n  lastRowSeriesHoverRef: RefObject<number | null>;\n  tableRef: RefObject<ListTableInstance | null>;\n}) => {\n  const onClickCell = (args: { col: number; row: number }) => {\n    const table = tableRef.current;\n    if (table != null) handleTableCellClick(table, args);\n    applyHint(null);\n  };\n\n  const onMouseEnterCell = (args: { col: number; row: number }) => {\n    hintAtCell(args.col, args.row);\n  };\n\n  const onMouseMoveCell = (args: { col: number; row: number }) => {\n    const table = tableRef.current;\n    if (table != null) {\n      const previous = lastRowSeriesHoverRef.current;\n      lastRowSeriesHoverRef.current = args.row;\n      refreshRowSeriesHover(table, previous, args.row);\n    }\n    hintAtCell(args.col, args.row);\n  };\n\n  return { onClickCell, onMouseEnterCell, onMouseMoveCell };\n};\n"],"mappings":";;;;AAQA,MAAa,sBAAsB,EACjC,WACA,YACA,uBACA,eAMI;CACJ,MAAM,eAAe,SAAuC;EAC1D,MAAM,QAAQ,SAAS;EACvB,IAAI,SAAS,MAAM,qBAAqB,OAAO,IAAI;EACnD,UAAU,IAAI;CAChB;CAEA,MAAM,oBAAoB,SAAuC;EAC/D,WAAW,KAAK,KAAK,KAAK,GAAG;CAC/B;CAEA,MAAM,mBAAmB,SAAuC;EAC9D,MAAM,QAAQ,SAAS;EACvB,IAAI,SAAS,MAAM;GACjB,MAAM,WAAW,sBAAsB;GACvC,sBAAsB,UAAU,KAAK;GACrC,sBAAsB,OAAO,UAAU,KAAK,GAAG;EACjD;EACA,WAAW,KAAK,KAAK,KAAK,GAAG;CAC/B;CAEA,OAAO;EAAE;EAAa;EAAkB;CAAgB;AAC1D"}

package/es/Table/react/useTableColumnSettings.mjs

@@ -0,0 +1,107 @@
+"use client";
+import { useEffect, useMemo, useRef, useState } from "react";
+//#region src/Table/react/useTableColumnSettings.ts
+const getColumnField = (column) => typeof column.field === "string" ? column.field : void 0;
+const getColumnTitle = (column) => {
+	const field = getColumnField(column) ?? "";
+	return typeof column.title === "string" ? column.title : field;
+};
+const sameStringArray = (left, right) => left.length === right.length && left.every((item, index) => item === right[index]);
+const useTableColumnSettings = ({ columns, onColumnOrderChange, onColumnVisibilityChange }) => {
+	const [hiddenFields, setHiddenFields] = useState([]);
+	const [columnOrder, setColumnOrder] = useState([]);
+	const [columnSettingsOpen, setColumnSettingsOpen] = useState(false);
+	const columnSettingsRef = useRef(null);
+	const columnEntries = useMemo(() => (columns ?? []).flatMap((column) => {
+		const field = getColumnField(column);
+		if (field == null) return [];
+		return [{
+			field,
+			title: getColumnTitle(column)
+		}];
+	}), [columns]);
+	const columnFields = useMemo(() => columnEntries.map((entry) => entry.field), [columnEntries]);
+	useEffect(() => {
+		setColumnOrder((previous) => {
+			const kept = previous.filter((field) => columnFields.includes(field));
+			const added = columnFields.filter((field) => kept.includes(field) === false);
+			const next = [...kept, ...added];
+			return sameStringArray(previous, next) ? previous : next;
+		});
+		setHiddenFields((previous) => {
+			const next = previous.filter((field) => columnFields.includes(field));
+			return sameStringArray(previous, next) ? previous : next;
+		});
+	}, [columnFields]);
+	useEffect(() => {
+		if (columnSettingsOpen === false) return;
+		const onPointerDown = (event) => {
+			if (columnSettingsRef.current?.contains(event.target)) return;
+			setColumnSettingsOpen(false);
+		};
+		document.addEventListener("pointerdown", onPointerDown, true);
+		return () => document.removeEventListener("pointerdown", onPointerDown, true);
+	}, [columnSettingsOpen]);
+	const orderedEntries = useMemo(() => {
+		if (columnOrder.length === 0) return columnEntries;
+		const byField = new Map(columnEntries.map((entry) => [entry.field, entry]));
+		return columnOrder.flatMap((field) => {
+			const entry = byField.get(field);
+			return entry ? [entry] : [];
+		});
+	}, [columnEntries, columnOrder]);
+	const visibleColumns = useMemo(() => {
+		if (columns == null) return void 0;
+		const order = columnOrder.length > 0 ? columnOrder : columnFields;
+		const orderMap = new Map(order.map((field, index) => [field, index]));
+		return columns.map((column, index) => ({
+			column,
+			index
+		})).filter(({ column }) => {
+			const field = getColumnField(column);
+			return field == null || hiddenFields.includes(field) === false;
+		}).sort((left, right) => {
+			const leftField = getColumnField(left.column);
+			const rightField = getColumnField(right.column);
+			return (leftField == null ? left.index : orderMap.get(leftField) ?? left.index) - (rightField == null ? right.index : orderMap.get(rightField) ?? right.index);
+		}).map(({ column }) => column);
+	}, [
+		columnFields,
+		columnOrder,
+		columns,
+		hiddenFields
+	]);
+	const moveColumn = (field, direction) => {
+		const order = columnOrder.length > 0 ? columnOrder : columnFields;
+		const index = order.indexOf(field);
+		const nextIndex = index + direction;
+		if (index < 0 || nextIndex < 0 || nextIndex >= order.length) return;
+		const next = [...order];
+		[next[index], next[nextIndex]] = [next[nextIndex] ?? field, next[index] ?? field];
+		setColumnOrder(next);
+		onColumnOrderChange?.(next);
+	};
+	const toggleColumnVisibility = (field) => {
+		const hidden = hiddenFields.includes(field);
+		const visibleCount = columnEntries.length - hiddenFields.length;
+		if (hidden === false && visibleCount <= 1) return;
+		const next = hidden ? hiddenFields.filter((item) => item !== field) : [...hiddenFields, field];
+		setHiddenFields(next);
+		onColumnVisibilityChange?.(field, hidden);
+	};
+	return {
+		columnEntries,
+		columnSettingsOpen,
+		columnSettingsRef,
+		hiddenFields,
+		moveColumn,
+		orderedEntries,
+		setColumnSettingsOpen,
+		toggleColumnVisibility,
+		visibleColumns
+	};
+};
+//#endregion
+export { useTableColumnSettings };
+
+//# sourceMappingURL=useTableColumnSettings.mjs.map

package/es/Table/react/useTableColumnSettings.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"useTableColumnSettings.mjs","names":[],"sources":["../../../src/Table/react/useTableColumnSettings.ts"],"sourcesContent":["'use client';\n\nimport { useEffect, useMemo, useRef, useState } from 'react';\n\nimport type { TableColumnInput } from '../type';\n\nexport interface TableColumnEntry {\n  field: string;\n  title: string;\n}\n\nconst getColumnField = (column: { field?: unknown }): string | undefined =>\n  typeof column.field === 'string' ? column.field : undefined;\n\nconst getColumnTitle = (column: { field?: unknown; title?: unknown }): string => {\n  const field = getColumnField(column) ?? '';\n  return typeof column.title === 'string' ? column.title : field;\n};\n\nconst sameStringArray = (left: string[], right: string[]): boolean =>\n  left.length === right.length && left.every((item, index) => item === right[index]);\n\nexport const useTableColumnSettings = ({\n  columns,\n  onColumnOrderChange,\n  onColumnVisibilityChange,\n}: {\n  columns?: TableColumnInput[];\n  onColumnOrderChange?: (fields: string[]) => void;\n  onColumnVisibilityChange?: (field: string, visible: boolean) => void;\n}) => {\n  const [hiddenFields, setHiddenFields] = useState<string[]>([]);\n  const [columnOrder, setColumnOrder] = useState<string[]>([]);\n  const [columnSettingsOpen, setColumnSettingsOpen] = useState(false);\n  const columnSettingsRef = useRef<HTMLDivElement>(null);\n\n  const columnEntries = useMemo(\n    () =>\n      (columns ?? []).flatMap((column) => {\n        const field = getColumnField(column as { field?: unknown });\n        if (field == null) return [];\n\n        return [{ field, title: getColumnTitle(column as { field?: unknown; title?: unknown }) }];\n      }),\n    [columns],\n  );\n  const columnFields = useMemo(() => columnEntries.map((entry) => entry.field), [columnEntries]);\n\n  useEffect(() => {\n    setColumnOrder((previous) => {\n      const kept = previous.filter((field) => columnFields.includes(field));\n      const added = columnFields.filter((field) => kept.includes(field) === false);\n      const next = [...kept, ...added];\n      return sameStringArray(previous, next) ? previous : next;\n    });\n    setHiddenFields((previous) => {\n      const next = previous.filter((field) => columnFields.includes(field));\n      return sameStringArray(previous, next) ? previous : next;\n    });\n  }, [columnFields]);\n\n  useEffect(() => {\n    if (columnSettingsOpen === false) return;\n\n    const onPointerDown = (event: PointerEvent) => {\n      if (columnSettingsRef.current?.contains(event.target as Node)) return;\n      setColumnSettingsOpen(false);\n    };\n\n    document.addEventListener('pointerdown', onPointerDown, true);\n    return () => document.removeEventListener('pointerdown', onPointerDown, true);\n  }, [columnSettingsOpen]);\n\n  const orderedEntries = useMemo(() => {\n    if (columnOrder.length === 0) return columnEntries;\n\n    const byField = new Map(columnEntries.map((entry) => [entry.field, entry]));\n    return columnOrder.flatMap((field) => {\n      const entry = byField.get(field);\n      return entry ? [entry] : [];\n    });\n  }, [columnEntries, columnOrder]);\n\n  const visibleColumns = useMemo(() => {\n    if (columns == null) return undefined;\n\n    const order = columnOrder.length > 0 ? columnOrder : columnFields;\n    const orderMap = new Map(order.map((field, index) => [field, index]));\n\n    return (\n      columns\n        // 原始下标要在 filter 之前取，否则拿到的是过滤后的位置。\n        .map((column, index) => ({ column, index }))\n        .filter(({ column }) => {\n          const field = getColumnField(column as { field?: unknown });\n          return field == null || hiddenFields.includes(field) === false;\n        })\n        .sort((left, right) => {\n          const leftField = getColumnField(left.column as { field?: unknown });\n          const rightField = getColumnField(right.column as { field?: unknown });\n          // 没有 field 的列进不了 columnOrder，用**原始下标**当键。早先这里对含无 field 的一对\n          // 直接返回 0，于是那种列能挡住任何列跨过去：用户点了「‹」，表纹丝不动，也没有反馈。\n          const leftKey = leftField == null ? left.index : (orderMap.get(leftField) ?? left.index);\n          const rightKey =\n            rightField == null ? right.index : (orderMap.get(rightField) ?? right.index);\n\n          return leftKey - rightKey;\n        })\n        .map(({ column }) => column)\n    );\n  }, [columnFields, columnOrder, columns, hiddenFields]);\n\n  const moveColumn = (field: string, direction: -1 | 1) => {\n    const order = columnOrder.length > 0 ? columnOrder : columnFields;\n    const index = order.indexOf(field);\n    const nextIndex = index + direction;\n\n    if (index < 0 || nextIndex < 0 || nextIndex >= order.length) return;\n\n    const next = [...order];\n    [next[index], next[nextIndex]] = [next[nextIndex] ?? field, next[index] ?? field];\n    setColumnOrder(next);\n    onColumnOrderChange?.(next);\n  };\n\n  const toggleColumnVisibility = (field: string) => {\n    const hidden = hiddenFields.includes(field);\n    const visibleCount = columnEntries.length - hiddenFields.length;\n\n    if (hidden === false && visibleCount <= 1) return;\n\n    const next = hidden ? hiddenFields.filter((item) => item !== field) : [...hiddenFields, field];\n    setHiddenFields(next);\n    onColumnVisibilityChange?.(field, hidden);\n  };\n\n  return {\n    columnEntries,\n    columnSettingsOpen,\n    columnSettingsRef,\n    hiddenFields,\n    moveColumn,\n    orderedEntries,\n    setColumnSettingsOpen,\n    toggleColumnVisibility,\n    visibleColumns,\n  };\n};\n"],"mappings":"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"}

package/es/Table/react/useTableEditorSync.mjs

@@ -0,0 +1,41 @@
+"use client";
+import { getEditCell, getEditingEditor } from "../vtable/vtableAdapter.mjs";
+import { resolveTreeTextOffset } from "../vtable/interaction.mjs";
+import { useCallback, useEffect, useRef } from "react";
+//#region src/Table/react/useTableEditorSync.ts
+const useTableEditorSync = ({ tableRef }) => {
+	const syncEditorPosition = useCallback(() => {
+		const table = tableRef.current;
+		const editor = getEditingEditor(table);
+		const editCell = getEditCell(table);
+		if (table?.getCellRange == null || table.getCellRangeRelativeRect == null || editor?.adjustPosition == null || editCell == null) return;
+		const rect = table.getCellRangeRelativeRect(table.getCellRange(editCell.col, editCell.row));
+		const treeOffset = resolveTreeTextOffset(table, editCell.col, editCell.row);
+		const width = rect.width + (editCell.col === (table.colCount ?? 1) - 1 ? -1 : 1);
+		editor.adjustPosition({
+			height: rect.height + (editCell.row === (table.rowCount ?? 1) - 1 ? -1 : 1),
+			left: rect.left + treeOffset,
+			top: rect.top,
+			width: Math.max(0, width - treeOffset)
+		});
+	}, [tableRef]);
+	const frameRef = useRef(void 0);
+	const scheduleEditorSync = useCallback(() => {
+		if (frameRef.current != null) cancelAnimationFrame(frameRef.current);
+		frameRef.current = requestAnimationFrame(() => {
+			frameRef.current = void 0;
+			syncEditorPosition();
+		});
+	}, [syncEditorPosition]);
+	useEffect(() => () => {
+		if (frameRef.current != null) cancelAnimationFrame(frameRef.current);
+	}, []);
+	return {
+		scheduleEditorSync,
+		syncEditorPosition
+	};
+};
+//#endregion
+export { useTableEditorSync };
+
+//# sourceMappingURL=useTableEditorSync.mjs.map

package/es/Table/react/useTableEditorSync.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"useTableEditorSync.mjs","names":[],"sources":["../../../src/Table/react/useTableEditorSync.ts"],"sourcesContent":["'use client';\n\nimport type { ListTable as ListTableInstance } from '@visactor/vtable';\nimport { type RefObject, useCallback, useEffect, useRef } from 'react';\n\nimport { resolveTreeTextOffset } from '../vtable/interaction';\nimport { getEditCell, getEditingEditor } from '../vtable/vtableAdapter';\n\nexport const useTableEditorSync = ({\n  tableRef,\n}: {\n  tableRef: RefObject<ListTableInstance | null>;\n}) => {\n  const syncEditorPosition = useCallback(() => {\n    const table = tableRef.current as\n      | (ListTableInstance & {\n          colCount?: number;\n          editorManager?: { editCell?: { col: number; row: number }; editingEditor?: unknown };\n          getCellRange?: (col: number, row: number) => unknown;\n          getCellRangeRelativeRect?: (range: unknown) => {\n            height: number;\n            left: number;\n            top: number;\n            width: number;\n          };\n        })\n      | null;\n    const editor = getEditingEditor(table) as\n      | {\n          adjustPosition?: (rect: {\n            height: number;\n            left: number;\n            top: number;\n            width: number;\n          }) => void;\n        }\n      | undefined;\n    const editCell = getEditCell(table);\n\n    if (\n      table?.getCellRange == null ||\n      table.getCellRangeRelativeRect == null ||\n      editor?.adjustPosition == null ||\n      editCell == null\n    ) {\n      return;\n    }\n\n    const rect = table.getCellRangeRelativeRect(table.getCellRange(editCell.col, editCell.row));\n    const treeOffset = resolveTreeTextOffset(table, editCell.col, editCell.row);\n    const width = rect.width + (editCell.col === (table.colCount ?? 1) - 1 ? -1 : 1);\n\n    editor.adjustPosition({\n      height: rect.height + (editCell.row === (table.rowCount ?? 1) - 1 ? -1 : 1),\n      left: rect.left + treeOffset,\n      top: rect.top,\n      width: Math.max(0, width - treeOffset),\n    });\n  }, [tableRef]);\n\n  // 句柄必须留着：回调会在下一帧打到 table 上，而那一帧到来之前表可能已经被 release()\n  // （容器塌成 0、组件卸载）。不取消的话 syncEditorPosition 的四道守卫全过不去 ——\n  // release() 不会把 editingEditor / editCell 置空 —— 于是在 null 的 internalProps 上取属性。\n  const frameRef = useRef<number | undefined>(undefined);\n\n  const scheduleEditorSync = useCallback(() => {\n    if (frameRef.current != null) cancelAnimationFrame(frameRef.current);\n    frameRef.current = requestAnimationFrame(() => {\n      frameRef.current = undefined;\n      syncEditorPosition();\n    });\n  }, [syncEditorPosition]);\n\n  useEffect(\n    () => () => {\n      if (frameRef.current != null) cancelAnimationFrame(frameRef.current);\n    },\n    [],\n  );\n\n  return { scheduleEditorSync, syncEditorPosition };\n};\n"],"mappings":";;;;;AAQA,MAAa,sBAAsB,EACjC,eAGI;CACJ,MAAM,qBAAqB,kBAAkB;EAC3C,MAAM,QAAQ,SAAS;EAavB,MAAM,SAAS,iBAAiB,KAAK;EAUrC,MAAM,WAAW,YAAY,KAAK;EAElC,IACE,OAAO,gBAAgB,QACvB,MAAM,4BAA4B,QAClC,QAAQ,kBAAkB,QAC1B,YAAY,MAEZ;EAGF,MAAM,OAAO,MAAM,yBAAyB,MAAM,aAAa,SAAS,KAAK,SAAS,GAAG,CAAC;EAC1F,MAAM,aAAa,sBAAsB,OAAO,SAAS,KAAK,SAAS,GAAG;EAC1E,MAAM,QAAQ,KAAK,SAAS,SAAS,SAAS,MAAM,YAAY,KAAK,IAAI,KAAK;EAE9E,OAAO,eAAe;GACpB,QAAQ,KAAK,UAAU,SAAS,SAAS,MAAM,YAAY,KAAK,IAAI,KAAK;GACzE,MAAM,KAAK,OAAO;GAClB,KAAK,KAAK;GACV,OAAO,KAAK,IAAI,GAAG,QAAQ,UAAU;EACvC,CAAC;CACH,GAAG,CAAC,QAAQ,CAAC;CAKb,MAAM,WAAW,OAA2B,KAAA,CAAS;CAErD,MAAM,qBAAqB,kBAAkB;EAC3C,IAAI,SAAS,WAAW,MAAM,qBAAqB,SAAS,OAAO;EACnE,SAAS,UAAU,4BAA4B;GAC7C,SAAS,UAAU,KAAA;GACnB,mBAAmB;EACrB,CAAC;CACH,GAAG,CAAC,kBAAkB,CAAC;CAEvB,sBACc;EACV,IAAI,SAAS,WAAW,MAAM,qBAAqB,SAAS,OAAO;CACrE,GACA,CAAC,CACH;CAEA,OAAO;EAAE;EAAoB;CAAmB;AAClD"}

package/es/Table/react/useTableHoverHint.mjs

@@ -0,0 +1,62 @@
+"use client";
+import { getEditingEditor, isTableReleased } from "../vtable/vtableAdapter.mjs";
+import { hintFromClientPoint, placeEditHint, resolveEditHint, sameEditHint } from "../vtable/interaction.mjs";
+import { useCallback, useEffect, useState } from "react";
+//#region src/Table/react/useTableHoverHint.ts
+const useTableHoverHint = ({ box, isClient, rootRef, tableRef }) => {
+	const [hint, setHint] = useState(null);
+	const applyHint = useCallback((next) => {
+		setHint((prev) => sameEditHint(prev, next) ? prev : next);
+	}, []);
+	const hintAtCell = (col, row) => {
+		const table = tableRef.current;
+		const host = rootRef.current;
+		if (table == null || host == null) return;
+		if (getEditingEditor(table)) {
+			applyHint(null);
+			return;
+		}
+		applyHint(placeEditHint(resolveEditHint(table, col, row), table.getElement(), host));
+	};
+	useEffect(() => {
+		const node = rootRef.current;
+		if (node == null || isClient === false || box.width <= 0 || box.height <= 0) {
+			applyHint(null);
+			return;
+		}
+		const onMove = (event) => {
+			const table = tableRef.current;
+			if (table == null || isTableReleased(table) || getEditingEditor(table)) {
+				applyHint(null);
+				return;
+			}
+			applyHint(hintFromClientPoint(table, node, event.clientX, event.clientY));
+		};
+		const onLeave = (event) => {
+			if (event.relatedTarget && node.contains(event.relatedTarget)) return;
+			applyHint(null);
+		};
+		node.addEventListener("pointermove", onMove, true);
+		node.addEventListener("pointerleave", onLeave);
+		return () => {
+			node.removeEventListener("pointermove", onMove, true);
+			node.removeEventListener("pointerleave", onLeave);
+		};
+	}, [
+		box.height,
+		box.width,
+		isClient,
+		rootRef,
+		tableRef
+	]);
+	return {
+		applyHint,
+		hint,
+		hintAtCell,
+		setHint
+	};
+};
+//#endregion
+export { useTableHoverHint };
+
+//# sourceMappingURL=useTableHoverHint.mjs.map

package/es/Table/react/useTableHoverHint.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"useTableHoverHint.mjs","names":[],"sources":["../../../src/Table/react/useTableHoverHint.ts"],"sourcesContent":["'use client';\n\nimport type { ListTable as ListTableInstance } from '@visactor/vtable';\nimport { type RefObject, useCallback, useEffect, useState } from 'react';\n\nimport {\n  type CellEditHint,\n  hintFromClientPoint,\n  placeEditHint,\n  resolveEditHint,\n  sameEditHint,\n} from '../vtable/interaction';\nimport { getEditingEditor, isTableReleased } from '../vtable/vtableAdapter';\n\nexport const useTableHoverHint = ({\n  box,\n  isClient,\n  rootRef,\n  tableRef,\n}: {\n  box: { height: number; width: number };\n  isClient: boolean;\n  rootRef: RefObject<HTMLDivElement | null>;\n  tableRef: RefObject<ListTableInstance | null>;\n}) => {\n  const [hint, setHint] = useState<CellEditHint | null>(null);\n\n  // 稳定引用：Table 侧要在 options 变化时用它清掉悬浮框，依赖数组需要一个不每次重建的函数。\n  const applyHint = useCallback((next: CellEditHint | null) => {\n    setHint((prev) => (sameEditHint(prev, next) ? prev : next));\n  }, []);\n\n  const hintAtCell = (col: number, row: number) => {\n    const table = tableRef.current;\n    const host = rootRef.current;\n    if (table == null || host == null) return;\n    // 编辑浮层自己带 1px 环。hover 框也有描边，编辑时再跟手画一层就是双框。\n    if (getEditingEditor(table)) {\n      applyHint(null);\n      return;\n    }\n    applyHint(placeEditHint(resolveEditHint(table, col, row), table.getElement(), host));\n  };\n\n  useEffect(() => {\n    const node = rootRef.current;\n    // 门槛必须与 <ListTable> 的渲染门一致（宽和高都 > 0）：只判宽度时，容器高度为 0 会让表\n    // 卸载而监听器还挂着，pointermove 打到一个已 release 的实例上就是 TypeError。\n    if (node == null || isClient === false || box.width <= 0 || box.height <= 0) {\n      // 容器塌成 0×0 时 <ListTable> 会卸载、pointermove 监听也在这里被摘掉 —— 于是**没有\n      // 任何一次 pointermove 会来清 hint**，而 hint 浮层没有和 <ListTable> 一样的渲染门：\n      // 它会停在旧坐标上，铅笔按钮还拿已释放的实例去 startEditCell（下面 onMove 里那条\n      // 清理正是为此写的，但这条路根本走不到）。\n      applyHint(null);\n      return;\n    }\n\n    const onMove = (event: PointerEvent) => {\n      const table = tableRef.current;\n      // 表被拆掉（release）时要**清掉**旧 hint 而不是直接 return：hint 浮层没有和\n      // <ListTable> 一样的渲染门，留着它就悬在旧坐标上，而它的铅笔按钮会拿这个已释放的\n      // 实例去 startEditCell。\n      if (table == null || isTableReleased(table) || getEditingEditor(table)) {\n        applyHint(null);\n        return;\n      }\n      applyHint(hintFromClientPoint(table, node, event.clientX, event.clientY));\n    };\n    const onLeave = (event: PointerEvent) => {\n      if (event.relatedTarget && node.contains(event.relatedTarget as Node)) return;\n      applyHint(null);\n    };\n\n    node.addEventListener('pointermove', onMove, true);\n    node.addEventListener('pointerleave', onLeave);\n    return () => {\n      node.removeEventListener('pointermove', onMove, true);\n      node.removeEventListener('pointerleave', onLeave);\n    };\n  }, [box.height, box.width, isClient, rootRef, tableRef]);\n\n  return { applyHint, hint, hintAtCell, setHint };\n};\n"],"mappings":";;;;;AAcA,MAAa,qBAAqB,EAChC,KACA,UACA,SACA,eAMI;CACJ,MAAM,CAAC,MAAM,WAAW,SAA8B,IAAI;CAG1D,MAAM,YAAY,aAAa,SAA8B;EAC3D,SAAS,SAAU,aAAa,MAAM,IAAI,IAAI,OAAO,IAAK;CAC5D,GAAG,CAAC,CAAC;CAEL,MAAM,cAAc,KAAa,QAAgB;EAC/C,MAAM,QAAQ,SAAS;EACvB,MAAM,OAAO,QAAQ;EACrB,IAAI,SAAS,QAAQ,QAAQ,MAAM;EAEnC,IAAI,iBAAiB,KAAK,GAAG;GAC3B,UAAU,IAAI;GACd;EACF;EACA,UAAU,cAAc,gBAAgB,OAAO,KAAK,GAAG,GAAG,MAAM,WAAW,GAAG,IAAI,CAAC;CACrF;CAEA,gBAAgB;EACd,MAAM,OAAO,QAAQ;EAGrB,IAAI,QAAQ,QAAQ,aAAa,SAAS,IAAI,SAAS,KAAK,IAAI,UAAU,GAAG;GAK3E,UAAU,IAAI;GACd;EACF;EAEA,MAAM,UAAU,UAAwB;GACtC,MAAM,QAAQ,SAAS;GAIvB,IAAI,SAAS,QAAQ,gBAAgB,KAAK,KAAK,iBAAiB,KAAK,GAAG;IACtE,UAAU,IAAI;IACd;GACF;GACA,UAAU,oBAAoB,OAAO,MAAM,MAAM,SAAS,MAAM,OAAO,CAAC;EAC1E;EACA,MAAM,WAAW,UAAwB;GACvC,IAAI,MAAM,iBAAiB,KAAK,SAAS,MAAM,aAAqB,GAAG;GACvE,UAAU,IAAI;EAChB;EAEA,KAAK,iBAAiB,eAAe,QAAQ,IAAI;EACjD,KAAK,iBAAiB,gBAAgB,OAAO;EAC7C,aAAa;GACX,KAAK,oBAAoB,eAAe,QAAQ,IAAI;GACpD,KAAK,oBAAoB,gBAAgB,OAAO;EAClD;CACF,GAAG;EAAC,IAAI;EAAQ,IAAI;EAAO;EAAU;EAAS;CAAQ,CAAC;CAEvD,OAAO;EAAE;EAAW;EAAM;EAAY;CAAQ;AAChD"}

package/es/Table/react/useTableKeyboard.mjs

@@ -0,0 +1,41 @@
+"use client";
+import { getStateManager, isTableReleased } from "../vtable/vtableAdapter.mjs";
+import { clearCascadeSelection, isCascadeSelectionTable, selectAllSeriesRows, toggleSeriesRow } from "../vtable/seriesSelection.mjs";
+import { isTableEditing } from "../vtable/interaction.mjs";
+//#region src/Table/react/useTableKeyboard.ts
+const useTableKeyboard = ({ columnSettingsRef, tableRef }) => {
+	const handleKeyDown = (event) => {
+		const table = tableRef.current;
+		const target = event.target;
+		if (table == null || isTableReleased(table) || isTableEditing(table) || target.closest("input, textarea, [contenteditable=\"true\"]") || columnSettingsRef.current?.contains(target)) return;
+		const headerRows = table.columnHeaderLevelCount ?? 1;
+		const rowCount = table.rowCount ?? 1;
+		const selectedRanges = getStateManager(table)?.select?.ranges ?? [];
+		if (event.key === "Escape") {
+			const cascade = isCascadeSelectionTable(table);
+			if (selectedRanges.length === 0 && cascade === false) return;
+			event.stopPropagation();
+			table.clearSelected?.();
+			if (cascade) clearCascadeSelection(table);
+			return;
+		}
+		if ((event.key === "a" || event.key === "A") && (event.ctrlKey || event.metaKey)) {
+			if (selectAllSeriesRows(table) === false) return;
+			event.preventDefault();
+			event.stopPropagation();
+			return;
+		}
+		if ((event.key === "x" || event.key === "X") && event.ctrlKey === false && event.metaKey === false && event.altKey === false) {
+			const row = getStateManager(table)?.select?.cellPos?.row ?? -1;
+			if (row < headerRows || row >= rowCount) return;
+			event.preventDefault();
+			event.stopPropagation();
+			toggleSeriesRow(table, row, event.shiftKey);
+		}
+	};
+	return handleKeyDown;
+};
+//#endregion
+export { useTableKeyboard };
+
+//# sourceMappingURL=useTableKeyboard.mjs.map

package/es/Table/react/useTableKeyboard.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"useTableKeyboard.mjs","names":[],"sources":["../../../src/Table/react/useTableKeyboard.ts"],"sourcesContent":["'use client';\n\nimport type { ListTable as ListTableInstance } from '@visactor/vtable';\nimport type { KeyboardEvent, RefObject } from 'react';\n\nimport { isTableEditing } from '../vtable/interaction';\nimport {\n  clearCascadeSelection,\n  isCascadeSelectionTable,\n  selectAllSeriesRows,\n  toggleSeriesRow,\n} from '../vtable/seriesSelection';\nimport { getStateManager, isTableReleased } from '../vtable/vtableAdapter';\n\nexport const useTableKeyboard = ({\n  columnSettingsRef,\n  tableRef,\n}: {\n  columnSettingsRef: RefObject<HTMLDivElement | null>;\n  tableRef: RefObject<ListTableInstance | null>;\n}) => {\n  const handleKeyDown = (event: KeyboardEvent<HTMLDivElement>) => {\n    const table = tableRef.current;\n    const target = event.target as HTMLElement;\n\n    if (\n      table == null ||\n      // `release()` 会把 `internalProps` 置 null，而下面每个按键路径都要读\n      // `columnHeaderLevelCount` / `rowCount` —— 那些 getter 直接抛 TypeError。\n      // （表被拆掉时 canvas 一并消失、焦点回到 body，理论上收不到事件；但这条守卫与\n      // useTableSelectionInfo / a11y 那几处保持同一口径，成本是一次属性读。）\n      isTableReleased(table) ||\n      isTableEditing(table) ||\n      target.closest('input, textarea, [contenteditable=\"true\"]') ||\n      columnSettingsRef.current?.contains(target)\n    ) {\n      return;\n    }\n\n    const headerRows = table.columnHeaderLevelCount ?? 1;\n    const rowCount = table.rowCount ?? 1;\n    const selectedRanges = getStateManager(table)?.select?.ranges ?? [];\n\n    // 三条通路都必须走 seriesSelection，不能自己拼区间：级联模式下选中态的真身是\n    // `stateManager.checkedState`（复选框勾选、底部「已选 N 行」、selectionActions 都读它），\n    // 而 `clearSelected` / `selectCells` 只动 `select.ranges`。只写 ranges 的后果是行高亮了\n    // 却一个勾都没有、计数为 0，并且下一次 `syncCascadeSelectionRanges` 会把高亮抹掉。\n    if (event.key === 'Escape') {\n      const cascade = isCascadeSelectionTable(table);\n      if (selectedRanges.length === 0 && cascade === false) return;\n      event.stopPropagation();\n      table.clearSelected?.();\n      if (cascade) clearCascadeSelection(table);\n      return;\n    }\n\n    if ((event.key === 'a' || event.key === 'A') && (event.ctrlKey || event.metaKey)) {\n      // 先做再看结果：没体行可全选时必须放行，不能把浏览器的全选键吞掉。\n      if (selectAllSeriesRows(table) === false) return;\n      event.preventDefault();\n      event.stopPropagation();\n      return;\n    }\n\n    if (\n      (event.key === 'x' || event.key === 'X') &&\n      event.ctrlKey === false &&\n      event.metaKey === false &&\n      event.altKey === false\n    ) {\n      const row = getStateManager(table)?.select?.cellPos?.row ?? -1;\n\n      if (row < headerRows || row >= rowCount) return;\n      event.preventDefault();\n      event.stopPropagation();\n      // 与鼠标点行号列是同一个入口，级联模式下它会翻复选框。\n      toggleSeriesRow(table, row, event.shiftKey);\n    }\n  };\n\n  return handleKeyDown;\n};\n"],"mappings":";;;;;AAcA,MAAa,oBAAoB,EAC/B,mBACA,eAII;CACJ,MAAM,iBAAiB,UAAyC;EAC9D,MAAM,QAAQ,SAAS;EACvB,MAAM,SAAS,MAAM;EAErB,IACE,SAAS,QAKT,gBAAgB,KAAK,KACrB,eAAe,KAAK,KACpB,OAAO,QAAQ,6CAA2C,KAC1D,kBAAkB,SAAS,SAAS,MAAM,GAE1C;EAGF,MAAM,aAAa,MAAM,0BAA0B;EACnD,MAAM,WAAW,MAAM,YAAY;EACnC,MAAM,iBAAiB,gBAAgB,KAAK,CAAC,EAAE,QAAQ,UAAU,CAAC;EAMlE,IAAI,MAAM,QAAQ,UAAU;GAC1B,MAAM,UAAU,wBAAwB,KAAK;GAC7C,IAAI,eAAe,WAAW,KAAK,YAAY,OAAO;GACtD,MAAM,gBAAgB;GACtB,MAAM,gBAAgB;GACtB,IAAI,SAAS,sBAAsB,KAAK;GACxC;EACF;EAEA,KAAK,MAAM,QAAQ,OAAO,MAAM,QAAQ,SAAS,MAAM,WAAW,MAAM,UAAU;GAEhF,IAAI,oBAAoB,KAAK,MAAM,OAAO;GAC1C,MAAM,eAAe;GACrB,MAAM,gBAAgB;GACtB;EACF;EAEA,KACG,MAAM,QAAQ,OAAO,MAAM,QAAQ,QACpC,MAAM,YAAY,SAClB,MAAM,YAAY,SAClB,MAAM,WAAW,OACjB;GACA,MAAM,MAAM,gBAAgB,KAAK,CAAC,EAAE,QAAQ,SAAS,OAAO;GAE5D,IAAI,MAAM,cAAc,OAAO,UAAU;GACzC,MAAM,eAAe;GACrB,MAAM,gBAAgB;GAEtB,gBAAgB,OAAO,KAAK,MAAM,QAAQ;EAC5C;CACF;CAEA,OAAO;AACT"}

package/es/Table/react/useTableRenderState.mjs

@@ -0,0 +1,194 @@
+"use client";
+import { useI18n } from "../../ConfigProvider/index.mjs";
+import { createTableTheme, isOpaqueColor, resolveGroupFill, resolveTableCanvasPalette } from "../canvas/theme.mjs";
+import { resolveTableI18n } from "../core/tableI18n.mjs";
+import { getScenegraph, isTableReleased, updateCellContentRange } from "../vtable/vtableAdapter.mjs";
+import { createSuperadAntdTheme } from "../../styles/theme/antdTheme.mjs";
+import { computeTableHeight, parsePxSize, toCssSize } from "../core/size.mjs";
+import { createTableOption } from "../vtable/option.mjs";
+import { sameRenderInputs } from "./sameRenderInputs.mjs";
+import { useTheme } from "antd-style";
+import { useEffect, useMemo, useRef } from "react";
+//#region src/Table/react/useTableRenderState.ts
+const useTableRenderState = ({ autoFillWidth, autoHeight, columns, editable, emptyText, frozenColCount, groupBy, groupTitleColors, groupTitleStyle, headerRowHeight, height, hover, measuredContentHeight, option, records, rowDrag, rowHeight, showHeader, showRowIndex, showRowSelection, showVerticalBorder, size, style, tableRef, theme, tree, treeExpandLevel, treeIndent, width }) => {
+	const themeTokens = useTheme();
+	const { colorBgContainer, colorBorderSecondary, colorFillQuaternary, colorFillSecondary, colorFillTertiary, colorInfo, colorPrimary, colorSplit, colorSuccess, colorText, colorTextQuaternary, colorTextSecondary, colorTextTertiary, fontFamily, isDarkMode } = themeTokens;
+	/** 送给编辑器 root 的主题。不传的话那边是全新 root、没有父级 context，一律退回 antd 默认。 */
+	const editorTheme = useMemo(() => {
+		return {
+			components: createSuperadAntdTheme({
+				appearance: isDarkMode ? "dark" : "light",
+				neutralColor: themeTokens.neutralColor,
+				primaryColor: themeTokens.primaryColor
+			}).components,
+			token: themeTokens
+		};
+	}, [isDarkMode, themeTokens]);
+	const token = useMemo(() => ({
+		colorBgContainer,
+		colorBorderSecondary,
+		colorFillQuaternary,
+		colorFillSecondary,
+		colorFillTertiary,
+		colorInfo,
+		colorPrimary,
+		colorSplit,
+		colorSuccess,
+		colorText,
+		colorTextQuaternary,
+		colorTextSecondary,
+		colorTextTertiary,
+		fontFamily,
+		isDarkMode
+	}), [
+		colorBgContainer,
+		colorBorderSecondary,
+		colorFillQuaternary,
+		colorFillSecondary,
+		colorFillTertiary,
+		colorInfo,
+		colorPrimary,
+		colorSplit,
+		colorSuccess,
+		colorText,
+		colorTextQuaternary,
+		colorTextSecondary,
+		colorTextTertiary,
+		fontFamily,
+		isDarkMode
+	]);
+	const baseTheme = useMemo(() => createTableTheme(token, { showVerticalBorder }), [showVerticalBorder, token]);
+	/** Column-level style beats the table theme, which beats the built-in theme. */
+	const groupTitleStyleMerged = useMemo(() => ({
+		...baseTheme.groupTitleStyle,
+		...theme?.groupTitleStyle,
+		...groupTitleStyle
+	}), [
+		baseTheme,
+		groupTitleStyle,
+		theme
+	]);
+	const stickyGroupBackground = useMemo(() => {
+		const background = groupTitleStyleMerged?.bgColor;
+		if (typeof background === "string" && background && isOpaqueColor(background)) return background;
+		return resolveGroupFill({ isDarkMode: token.isDarkMode });
+	}, [groupTitleStyleMerged, token]);
+	const { locale, t } = useI18n();
+	const i18n = useMemo(() => resolveTableI18n(locale, (key) => t(key)), [locale, t]);
+	const optionInputs = {
+		autoFillWidth: autoFillWidth ?? true,
+		columns,
+		editable,
+		emptyText,
+		i18n,
+		frozenColCount,
+		groupBy,
+		groupTitleColors,
+		headerRowHeight,
+		hover,
+		option,
+		records,
+		rowDrag,
+		rowHeight,
+		showHeader,
+		showRowIndex,
+		showRowSelection,
+		showVerticalBorder,
+		size,
+		theme: {
+			...baseTheme,
+			...theme,
+			groupTitleStyle: groupTitleStyleMerged
+		},
+		token,
+		tree,
+		treeExpandLevel,
+		treeIndent,
+		/**
+		* 送给编辑器的主题。编辑器渲染在 `createRoot` 起的**独立 React root** 里，React context 不跨
+		* root —— 那边不显式传 theme 就退回 antd 默认（主色是 `#1677ff` 的蓝，而本项目是 `#222222`）。
+		* 与 palette 同一条通道：写进 `customConfig`，主题一变随 option 重建一起更新。
+		*/
+		editorTheme
+	};
+	/**
+	* 按**内容**复用上一次的 option 对象，而不是按引用 memo。
+	*
+	* 使用方写 `columns={[...]}` / `records={rows.map(...)}` 时每次渲染都是新数组，`useMemo`
+	* 的引用比较必然失效 → 新 option 里全是新建的函数与编辑器实例 → react-vtable 的
+	* `isEqual` 对非纯对象直接返回 false → 每次父组件渲染都走一遍 `updateOption`（整表重建：
+	* 重新编译列、重建数据源、9 个事件解绑重绑）。按内容认出来就能让引用保持稳定，
+	* `updateOption` 完全不会发生。
+	*
+	* 在渲染期写 ref 是 `useMemo` 本身的实现方式，这里只是把判据从引用换成内容。
+	*/
+	const optionRef = useRef(void 0);
+	const mergedOption = (() => {
+		const previous = optionRef.current;
+		if (previous != null && sameRenderInputs(previous.inputs, optionInputs)) return previous.value;
+		const value = createTableOption(optionInputs);
+		optionRef.current = {
+			inputs: optionInputs,
+			value
+		};
+		return value;
+	})();
+	useEffect(() => {
+		const table = tableRef.current;
+		if (table == null || isTableReleased(table)) return;
+		table.__superadPalette = resolveTableCanvasPalette(token);
+		table.__superadTheme = editorTheme;
+		table.__superadI18n = i18n;
+		const scenegraph = getScenegraph(table);
+		const headerRows = table.columnHeaderLevelCount ?? 1;
+		const startRow = Math.max(headerRows, scenegraph.proxy?.rowStart ?? headerRows);
+		const endRow = Math.min((table.rowCount ?? 1) - 1, scenegraph.proxy?.rowEnd ?? startRow + 40);
+		const endCol = (table.colCount ?? 1) - 1;
+		if (headerRows > 0) updateCellContentRange(table, 0, 0, endCol, headerRows - 1);
+		if (endRow >= startRow) updateCellContentRange(table, 0, startRow, endCol, endRow);
+		scenegraph.updateNextFrame?.();
+	}, [
+		editorTheme,
+		i18n,
+		mergedOption,
+		tableRef,
+		token
+	]);
+	const dataContentHeight = useMemo(() => computeTableHeight({
+		groupBy,
+		headerRowHeight: parsePxSize(headerRowHeight),
+		records,
+		rowHeight: parsePxSize(rowHeight),
+		showHeader,
+		size,
+		tree
+	}), [
+		groupBy,
+		headerRowHeight,
+		records,
+		rowHeight,
+		showHeader,
+		size,
+		tree
+	]);
+	/**
+	* 引擎实测优先：按数据算只在首帧成立（那时还没有引擎实例，SSR 也要有个值），一旦用户折叠过，
+	* 行数就只有引擎知道了。见 `useTableVTableEvents` 里 `onHierarchyChange` 的注释。
+	*/
+	const contentHeight = measuredContentHeight ?? dataContentHeight;
+	const resolvedHeight = autoHeight !== false && typeof height === "number" && records?.length ? Math.min(height, contentHeight) : height ?? contentHeight;
+	return {
+		mergedOption,
+		rootStyle: {
+			height: toCssSize(resolvedHeight),
+			width: toCssSize(width ?? "100%"),
+			...style
+		},
+		stickyGroupBackground,
+		token
+	};
+};
+//#endregion
+export { useTableRenderState };
+
+//# sourceMappingURL=useTableRenderState.mjs.map

package/es/Table/react/useTableRenderState.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"useTableRenderState.mjs","names":[],"sources":["../../../src/Table/react/useTableRenderState.ts"],"sourcesContent":["'use client';\n\nimport type { ListTable as ListTableInstance } from '@visactor/vtable';\nimport type { ThemeConfig } from 'antd';\nimport { useTheme } from 'antd-style';\nimport { type CSSProperties, type RefObject, useEffect, useMemo, useRef } from 'react';\n\nimport { useI18n } from '@/ConfigProvider';\nimport type { NeutralColors, PrimaryColors } from '@/styles/customTheme';\nimport { createSuperadAntdTheme } from '@/styles/theme/antdTheme';\n\nimport {\n  createTableTheme,\n  isOpaqueColor,\n  resolveGroupFill,\n  resolveTableCanvasPalette,\n  type TableToken,\n} from '../canvas/theme';\nimport { computeTableHeight, parsePxSize, toCssSize } from '../core/size';\nimport { resolveTableI18n, type TableI18n } from '../core/tableI18n';\nimport type { TableProps } from '../type';\nimport { createTableOption } from '../vtable/option';\nimport { getScenegraph, isTableReleased, updateCellContentRange } from '../vtable/vtableAdapter';\nimport { sameRenderInputs } from './sameRenderInputs';\n\ntype RenderStateProps = Pick<\n  TableProps,\n  | 'autoFillWidth'\n  | 'autoHeight'\n  | 'editable'\n  | 'emptyText'\n  | 'frozenColCount'\n  | 'groupBy'\n  | 'groupTitleColors'\n  | 'groupTitleStyle'\n  | 'headerRowHeight'\n  | 'height'\n  | 'hover'\n  | 'option'\n  | 'records'\n  | 'rowDrag'\n  | 'rowHeight'\n  | 'showHeader'\n  | 'showRowIndex'\n  | 'showRowSelection'\n  | 'showVerticalBorder'\n  | 'size'\n  | 'style'\n  | 'theme'\n  | 'tree'\n  | 'treeExpandLevel'\n  | 'treeIndent'\n  | 'width'\n> & {\n  columns?: TableProps['columns'];\n  /**\n   * 引擎实测的内容高度（含底部那 8px 的槽），折叠 / 展开之后由\n   * `useTableVTableEvents` 写入；没发生过折叠时是 null，走按数据算的那条。\n   */\n  measuredContentHeight: number | null;\n  tableRef: RefObject<ListTableInstance | null>;\n};\n\nexport const useTableRenderState = ({\n  autoFillWidth,\n  autoHeight,\n  columns,\n  editable,\n  emptyText,\n  frozenColCount,\n  groupBy,\n  groupTitleColors,\n  groupTitleStyle,\n  headerRowHeight,\n  height,\n  hover,\n  measuredContentHeight,\n  option,\n  records,\n  rowDrag,\n  rowHeight,\n  showHeader,\n  showRowIndex,\n  showRowSelection,\n  showVerticalBorder,\n  size,\n  style,\n  tableRef,\n  theme,\n  tree,\n  treeExpandLevel,\n  treeIndent,\n  width,\n}: RenderStateProps) => {\n  // 自定义种子（`createSuperadAntdTheme` 的入参）会留在解析后的 token 上；读回来是为了在**编辑器\n  // 那个独立 React root** 里原样重建同一份主题 —— context 不跨 root，那边拿不到 ThemeProvider。\n  const themeTokens = useTheme() as ReturnType<typeof useTheme> & {\n    neutralColor?: NeutralColors;\n    primaryColor?: PrimaryColors;\n  };\n  const {\n    colorBgContainer,\n    colorBorderSecondary,\n    colorFillQuaternary,\n    colorFillSecondary,\n    colorFillTertiary,\n    colorInfo,\n    colorPrimary,\n    colorSplit,\n    colorSuccess,\n    colorText,\n    colorTextQuaternary,\n    colorTextSecondary,\n    colorTextTertiary,\n    fontFamily,\n    isDarkMode,\n  } = themeTokens;\n\n  /** 送给编辑器 root 的主题。不传的话那边是全新 root、没有父级 context，一律退回 antd 默认。 */\n  const editorTheme = useMemo(() => {\n    const built = createSuperadAntdTheme({\n      appearance: isDarkMode ? 'dark' : 'light',\n      neutralColor: themeTokens.neutralColor,\n      primaryColor: themeTokens.primaryColor,\n    });\n\n    // 只交 **已经解析好的 token** + `components` 覆盖，**不带 `algorithm`**：\n    // 项目那套自定义 algorithm 在编辑器那个 root 里会算出残缺的 token（实测 `fontSize` /\n    // `controlHeight` 是 undefined），日期面板拿不到 `--ant-font-size`，字号退回继承的 16px、\n    // 日期区宽度从 288 涨到 906。这里给的是外层主题的终值，让 antd 用默认算法原样收下。\n    return { components: built.components, token: themeTokens };\n  }, [isDarkMode, themeTokens]);\n\n  const token = useMemo<TableToken>(\n    () => ({\n      colorBgContainer,\n      colorBorderSecondary,\n      colorFillQuaternary,\n      colorFillSecondary,\n      colorFillTertiary,\n      colorInfo,\n      colorPrimary,\n      colorSplit,\n      colorSuccess,\n      colorText,\n      colorTextQuaternary,\n      colorTextSecondary,\n      colorTextTertiary,\n      fontFamily,\n      isDarkMode,\n    }),\n    [\n      colorBgContainer,\n      colorBorderSecondary,\n      colorFillQuaternary,\n      colorFillSecondary,\n      colorFillTertiary,\n      colorInfo,\n      colorPrimary,\n      colorSplit,\n      colorSuccess,\n      colorText,\n      colorTextQuaternary,\n      colorTextSecondary,\n      colorTextTertiary,\n      fontFamily,\n      isDarkMode,\n    ],\n  );\n\n  const baseTheme = useMemo(\n    () => createTableTheme(token, { showVerticalBorder }),\n    [showVerticalBorder, token],\n  );\n\n  /** Column-level style beats the table theme, which beats the built-in theme. */\n  const groupTitleStyleMerged = useMemo(\n    () => ({ ...baseTheme.groupTitleStyle, ...theme?.groupTitleStyle, ...groupTitleStyle }),\n    [baseTheme, groupTitleStyle, theme],\n  );\n\n  const stickyGroupBackground = useMemo(() => {\n    const background = groupTitleStyleMerged?.bgColor;\n\n    // A sticky title sits over the rows scrolling beneath it, so a caller-supplied fill has\n    // to clear the same opacity bar as the token does — otherwise `bgColor: 'rgba(…, 0.02)'`\n    // would let content show through the pinned title.\n    if (typeof background === 'string' && background && isOpaqueColor(background)) {\n      return background;\n    }\n\n    return resolveGroupFill({ isDarkMode: token.isDarkMode } as TableToken);\n  }, [groupTitleStyleMerged, token]);\n\n  const { locale, t } = useI18n();\n  const i18n = useMemo(\n    () => resolveTableI18n(locale, (key) => t(key as Parameters<typeof t>[0])),\n    [locale, t],\n  );\n\n  const optionInputs = {\n    autoFillWidth: autoFillWidth ?? true,\n    columns,\n    editable,\n    emptyText,\n    i18n,\n    frozenColCount,\n    groupBy,\n    groupTitleColors,\n    headerRowHeight,\n    hover,\n    option,\n    records,\n    rowDrag,\n    rowHeight,\n    showHeader,\n    showRowIndex,\n    showRowSelection,\n    showVerticalBorder,\n    size,\n    theme: {\n      ...baseTheme,\n      ...theme,\n      groupTitleStyle: groupTitleStyleMerged,\n    },\n    token,\n    tree,\n    treeExpandLevel,\n    treeIndent,\n    /**\n     * 送给编辑器的主题。编辑器渲染在 `createRoot` 起的**独立 React root** 里，React context 不跨\n     * root —— 那边不显式传 theme 就退回 antd 默认（主色是 `#1677ff` 的蓝，而本项目是 `#222222`）。\n     * 与 palette 同一条通道：写进 `customConfig`，主题一变随 option 重建一起更新。\n     */\n    editorTheme,\n  };\n  /**\n   * 按**内容**复用上一次的 option 对象，而不是按引用 memo。\n   *\n   * 使用方写 `columns={[...]}` / `records={rows.map(...)}` 时每次渲染都是新数组，`useMemo`\n   * 的引用比较必然失效 → 新 option 里全是新建的函数与编辑器实例 → react-vtable 的\n   * `isEqual` 对非纯对象直接返回 false → 每次父组件渲染都走一遍 `updateOption`（整表重建：\n   * 重新编译列、重建数据源、9 个事件解绑重绑）。按内容认出来就能让引用保持稳定，\n   * `updateOption` 完全不会发生。\n   *\n   * 在渲染期写 ref 是 `useMemo` 本身的实现方式，这里只是把判据从引用换成内容。\n   */\n  const optionRef = useRef<\n    { inputs: typeof optionInputs; value: ReturnType<typeof createTableOption> } | undefined\n  >(undefined);\n  const mergedOption = (() => {\n    const previous = optionRef.current;\n    if (previous != null && sameRenderInputs(previous.inputs, optionInputs)) return previous.value;\n\n    const value = createTableOption(optionInputs);\n    optionRef.current = { inputs: optionInputs, value };\n    return value;\n  })();\n\n  useEffect(() => {\n    const table = tableRef.current;\n    // 用 isTableReleased 精确守卫，而不是把整个 effect 包进 try/catch：那个 catch 会把\n    // palette 写入失败、私有 API 漂移一并吞掉，症状是「主题换了但 canvas 颜色不更新」而且\n    // 没有任何信号。表被 release() 之后 scenegraph 与 internalProps 都是 null，读任何\n    // getter 都会抛，那一种情形由守卫覆盖。\n    if (table == null || isTableReleased(table)) return;\n\n    (\n      table as ListTableInstance & {\n        __superadPalette?: ReturnType<typeof resolveTableCanvasPalette>;\n      }\n    ).__superadPalette = resolveTableCanvasPalette(token);\n    // 与 palette 同一条通道：编辑器渲染在自己的 React root 里，只能从表实例上取主题。\n    (table as ListTableInstance & { __superadTheme?: ThemeConfig }).__superadTheme = editorTheme;\n    (table as ListTableInstance & { __superadI18n?: TableI18n }).__superadI18n = i18n;\n\n    const scenegraph = getScenegraph(table);\n    const headerRows = table.columnHeaderLevelCount ?? 1;\n    const startRow = Math.max(headerRows, scenegraph.proxy?.rowStart ?? headerRows);\n    // rowCount 是数量、不是行号，要 -1；对照 vtableAdapter 的 getVisibleRowRange 也是这么写的。\n    const endRow = Math.min((table.rowCount ?? 1) - 1, scenegraph.proxy?.rowEnd ?? startRow + 40);\n    const endCol = (table.colCount ?? 1) - 1;\n\n    if (headerRows > 0) updateCellContentRange(table, 0, 0, endCol, headerRows - 1);\n    if (endRow >= startRow) updateCellContentRange(table, 0, startRow, endCol, endRow);\n    scenegraph.updateNextFrame?.();\n  }, [editorTheme, i18n, mergedOption, tableRef, token]);\n\n  const dataContentHeight = useMemo(\n    () =>\n      computeTableHeight({\n        groupBy,\n        headerRowHeight: parsePxSize(headerRowHeight),\n        records,\n        rowHeight: parsePxSize(rowHeight),\n        showHeader,\n        size,\n        tree,\n      }),\n    [groupBy, headerRowHeight, records, rowHeight, showHeader, size, tree],\n  );\n  /**\n   * 引擎实测优先：按数据算只在首帧成立（那时还没有引擎实例，SSR 也要有个值），一旦用户折叠过，\n   * 行数就只有引擎知道了。见 `useTableVTableEvents` 里 `onHierarchyChange` 的注释。\n   */\n  const contentHeight = measuredContentHeight ?? dataContentHeight;\n  const resolvedHeight =\n    autoHeight !== false && typeof height === 'number' && records?.length\n      ? Math.min(height, contentHeight)\n      : (height ?? contentHeight);\n  const rootStyle: CSSProperties = {\n    height: toCssSize(resolvedHeight),\n    width: toCssSize(width ?? '100%'),\n    ...style,\n  };\n\n  return { mergedOption, rootStyle, stickyGroupBackground, token };\n};\n"],"mappings":"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"}

package/es/Table/react/useTableScroll.mjs

@@ -0,0 +1,33 @@
+"use client";
+import { getScenegraph } from "../vtable/vtableAdapter.mjs";
+import { placeEditHint, resolveEditHint, sameEditHint } from "../vtable/interaction.mjs";
+import { useRef } from "react";
+//#region src/Table/react/useTableScroll.ts
+const useTableScroll = ({ rootRef, setA11yVersion, setHint, syncEditorPosition, syncFrozenColumnShadow, tableRef }) => {
+	/** 上一次同步给 a11y 层的行窗口；窗口没变就不必重渲染。 */
+	const lastA11yRangeRef = useRef("");
+	const handleScroll = () => {
+		syncFrozenColumnShadow();
+		syncEditorPosition();
+		const table = tableRef.current;
+		const host = rootRef.current;
+		if (table != null) {
+			const { proxy } = getScenegraph(table) ?? {};
+			const key = `${proxy?.rowStart ?? -1}:${proxy?.rowEnd ?? -1}`;
+			if (key !== lastA11yRangeRef.current) {
+				lastA11yRangeRef.current = key;
+				setA11yVersion((version) => version + 1);
+			}
+		}
+		setHint((prev) => {
+			if (prev == null || table == null || host == null) return null;
+			const next = placeEditHint(resolveEditHint(table, prev.col, prev.row), table.getElement(), host);
+			return sameEditHint(prev, next) ? prev : next;
+		});
+	};
+	return handleScroll;
+};
+//#endregion
+export { useTableScroll };
+
+//# sourceMappingURL=useTableScroll.mjs.map

package/es/Table/react/useTableScroll.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"useTableScroll.mjs","names":[],"sources":["../../../src/Table/react/useTableScroll.ts"],"sourcesContent":["'use client';\n\nimport type { ListTable as ListTableInstance } from '@visactor/vtable';\nimport { type Dispatch, type RefObject, type SetStateAction, useRef } from 'react';\n\nimport {\n  type CellEditHint,\n  placeEditHint,\n  resolveEditHint,\n  sameEditHint,\n} from '../vtable/interaction';\nimport { getScenegraph } from '../vtable/vtableAdapter';\n\nexport const useTableScroll = ({\n  rootRef,\n  setA11yVersion,\n  setHint,\n  syncEditorPosition,\n  syncFrozenColumnShadow,\n  tableRef,\n}: {\n  rootRef: RefObject<HTMLDivElement | null>;\n  setA11yVersion: Dispatch<SetStateAction<number>>;\n  setHint: Dispatch<SetStateAction<CellEditHint | null>>;\n  syncEditorPosition: () => void;\n  syncFrozenColumnShadow: () => void;\n  tableRef: RefObject<ListTableInstance | null>;\n}) => {\n  /** 上一次同步给 a11y 层的行窗口；窗口没变就不必重渲染。 */\n  const lastA11yRangeRef = useRef('');\n\n  const handleScroll = () => {\n    syncFrozenColumnShadow();\n    syncEditorPosition();\n\n    const table = tableRef.current;\n    const host = rootRef.current;\n\n    // a11y 层只镜像可见行，而它每个 cell 都要向 VTable 读值。原先每个 scroll 事件都 bump\n    // 一次版本号 —— 实测 30 次滚动触发 29 次整树重渲染，a11y 层 360 个 cell 全量重读。\n    // 行窗口没变（横向滚动、行内微调）时它的输出不会变，跳过。\n    if (table != null) {\n      // 键必须与 a11y.tsx 真正读取的输入一致：它用的是 scenegraph.proxy 的原始行窗口，\n      // **不是** getVisibleRowRange（后者有 maxRows=80 的上限，小表上恒覆盖全表、窗口恒定，\n      // 用它当键会让 a11y 层在滚动时完全不更新 —— 实测 Tree/Grouping 上 0 次）。\n      const { proxy } = getScenegraph(table) ?? {};\n      const key = `${proxy?.rowStart ?? -1}:${proxy?.rowEnd ?? -1}`;\n      if (key !== lastA11yRangeRef.current) {\n        lastA11yRangeRef.current = key;\n        setA11yVersion((version) => version + 1);\n      }\n    }\n\n    setHint((prev) => {\n      if (prev == null || table == null || host == null) return null;\n\n      const next = placeEditHint(\n        resolveEditHint(table, prev.col, prev.row),\n        table.getElement(),\n        host,\n      );\n      // 去重：placeEditHint 每次都造新对象，直接返回它会让每个 scroll 事件都触发一次重渲染。\n      return sameEditHint(prev, next) ? prev : next;\n    });\n  };\n\n  return handleScroll;\n};\n"],"mappings":";;;;;AAaA,MAAa,kBAAkB,EAC7B,SACA,gBACA,SACA,oBACA,wBACA,eAQI;;CAEJ,MAAM,mBAAmB,OAAO,EAAE;CAElC,MAAM,qBAAqB;EACzB,uBAAuB;EACvB,mBAAmB;EAEnB,MAAM,QAAQ,SAAS;EACvB,MAAM,OAAO,QAAQ;EAKrB,IAAI,SAAS,MAAM;GAIjB,MAAM,EAAE,UAAU,cAAc,KAAK,KAAK,CAAC;GAC3C,MAAM,MAAM,GAAG,OAAO,YAAY,GAAG,GAAG,OAAO,UAAU;GACzD,IAAI,QAAQ,iBAAiB,SAAS;IACpC,iBAAiB,UAAU;IAC3B,gBAAgB,YAAY,UAAU,CAAC;GACzC;EACF;EAEA,SAAS,SAAS;GAChB,IAAI,QAAQ,QAAQ,SAAS,QAAQ,QAAQ,MAAM,OAAO;GAE1D,MAAM,OAAO,cACX,gBAAgB,OAAO,KAAK,KAAK,KAAK,GAAG,GACzC,MAAM,WAAW,GACjB,IACF;GAEA,OAAO,aAAa,MAAM,IAAI,IAAI,OAAO;EAC3C,CAAC;CACH;CAEA,OAAO;AACT"}