@superad/ui 0.1.1

package/es/Table/react/useTableSelectionInfo.mjs

@@ -0,0 +1,48 @@
+"use client";
+import { getStateManager, isTableReleased } from "../vtable/vtableAdapter.mjs";
+import { isFullRowRange } from "../core/rowSelection.mjs";
+import { getCascadeSelectedCount, getCascadeSelectedRowIndexes, isCascadeSelectionTable } from "../vtable/seriesSelection.mjs";
+import { useMemo } from "react";
+//#region src/Table/react/useTableSelectionInfo.ts
+/**
+* Body rows covered by full-row ranges. 去重：逐区间累加会把重叠部分重复计入，于是同一个
+* 表格状态会因为「调用方有没有传 `selectionActions`」而显示不同的「已选 N 行」。
+*/
+const collectFullRowIndexes = (table) => {
+	const startRow = table.columnHeaderLevelCount ?? 1;
+	const endRow = (table.rowCount ?? 1) - 1;
+	const endCol = (table.colCount ?? 1) - 1;
+	const ranges = getStateManager(table)?.select?.ranges ?? [];
+	const rows = /* @__PURE__ */ new Set();
+	ranges.forEach((range) => {
+		if (isFullRowRange(range, endCol) === false) return;
+		const from = Math.max(startRow, Math.min(range.start.row, range.end.row));
+		const to = Math.min(endRow, Math.max(range.start.row, range.end.row));
+		for (let row = from; row <= to; row += 1) rows.add(row);
+	});
+	return [...rows].sort((left, right) => left - right);
+};
+const useTableSelectionInfo = ({ selectionActions, selectionVersion, tableRef }) => useMemo(() => {
+	const table = tableRef.current;
+	if (table == null || isTableReleased(table)) return {
+		count: 0,
+		rows: []
+	};
+	if (isCascadeSelectionTable(table)) return {
+		count: getCascadeSelectedCount(table),
+		rows: selectionActions == null ? [] : getCascadeSelectedRowIndexes(table)
+	};
+	const rows = collectFullRowIndexes(table);
+	return {
+		count: rows.length,
+		rows: selectionActions == null ? [] : rows
+	};
+}, [
+	selectionActions,
+	selectionVersion,
+	tableRef
+]);
+//#endregion
+export { useTableSelectionInfo };
+
+//# sourceMappingURL=useTableSelectionInfo.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useTableSelectionInfo.mjs","names":[],"sources":["../../../src/Table/react/useTableSelectionInfo.ts"],"sourcesContent":["'use client';\n\nimport type { ListTable as ListTableInstance } from '@visactor/vtable';\nimport { type RefObject, useMemo } from 'react';\n\nimport type { TableCellRange } from '../core/rowSelection';\nimport { isFullRowRange } from '../core/rowSelection';\nimport {\n  getCascadeSelectedCount,\n  getCascadeSelectedRowIndexes,\n  isCascadeSelectionTable,\n} from '../vtable/seriesSelection';\nimport { getStateManager, isTableReleased } from '../vtable/vtableAdapter';\n\nexport interface TableSelectionInfo {\n  count: number;\n  rows: number[];\n}\n\n/**\n * Body rows covered by full-row ranges. 去重：逐区间累加会把重叠部分重复计入，于是同一个\n * 表格状态会因为「调用方有没有传 `selectionActions`」而显示不同的「已选 N 行」。\n */\nconst collectFullRowIndexes = (table: ListTableInstance): number[] => {\n  const startRow = table.columnHeaderLevelCount ?? 1;\n  const endRow = (table.rowCount ?? 1) - 1;\n  const endCol = (table.colCount ?? 1) - 1;\n  const ranges: TableCellRange[] = getStateManager(table)?.select?.ranges ?? [];\n  const rows = new Set<number>();\n\n  ranges.forEach((range) => {\n    if (isFullRowRange(range, endCol) === false) return;\n\n    const from = Math.max(startRow, Math.min(range.start.row, range.end.row));\n    const to = Math.min(endRow, Math.max(range.start.row, range.end.row));\n    for (let row = from; row <= to; row += 1) rows.add(row);\n  });\n\n  return [...rows].sort((left, right) => left - right);\n};\n\nexport const useTableSelectionInfo = ({\n  selectionActions,\n  selectionVersion,\n  tableRef,\n}: {\n  selectionActions?: unknown;\n  selectionVersion: number;\n  tableRef: RefObject<ListTableInstance | null>;\n}): TableSelectionInfo =>\n  useMemo(() => {\n    void selectionVersion;\n\n    const table = tableRef.current;\n    // `release()` 会把 `scenegraph` 与 `internalProps` 一起置 null，而 `tableRef` 仍指着那个\n    // 实例 —— 之后读 `columnHeaderLevelCount` / `rowCount` / `colCount` 这些 getter 会抛\n    // TypeError，而且是**渲染期**抛、库内没有错误边界，整个应用白屏。容器塌成 0×0 让表卸载、\n    // 之后再重渲染就会走到这里。\n    if (table == null || isTableReleased(table)) return { count: 0, rows: [] };\n\n    if (isCascadeSelectionTable(table)) {\n      // 级联模式下选中态的真身是 checkedState，行数口径与 ranges 不同源 —— 见 ARCHITECTURE §5。\n      return {\n        count: getCascadeSelectedCount(table),\n        rows: selectionActions == null ? [] : getCascadeSelectedRowIndexes(table),\n      };\n    }\n\n    const rows = collectFullRowIndexes(table);\n    return { count: rows.length, rows: selectionActions == null ? [] : rows };\n  }, [selectionActions, selectionVersion, tableRef]);\n"],"mappings":";;;;;;;;;;AAuBA,MAAM,yBAAyB,UAAuC;CACpE,MAAM,WAAW,MAAM,0BAA0B;CACjD,MAAM,UAAU,MAAM,YAAY,KAAK;CACvC,MAAM,UAAU,MAAM,YAAY,KAAK;CACvC,MAAM,SAA2B,gBAAgB,KAAK,CAAC,EAAE,QAAQ,UAAU,CAAC;CAC5E,MAAM,uBAAO,IAAI,IAAY;CAE7B,OAAO,SAAS,UAAU;EACxB,IAAI,eAAe,OAAO,MAAM,MAAM,OAAO;EAE7C,MAAM,OAAO,KAAK,IAAI,UAAU,KAAK,IAAI,MAAM,MAAM,KAAK,MAAM,IAAI,GAAG,CAAC;EACxE,MAAM,KAAK,KAAK,IAAI,QAAQ,KAAK,IAAI,MAAM,MAAM,KAAK,MAAM,IAAI,GAAG,CAAC;EACpE,KAAK,IAAI,MAAM,MAAM,OAAO,IAAI,OAAO,GAAG,KAAK,IAAI,GAAG;CACxD,CAAC;CAED,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC,MAAM,MAAM,UAAU,OAAO,KAAK;AACrD;AAEA,MAAa,yBAAyB,EACpC,kBACA,kBACA,eAMA,cAAc;CAGZ,MAAM,QAAQ,SAAS;CAKvB,IAAI,SAAS,QAAQ,gBAAgB,KAAK,GAAG,OAAO;EAAE,OAAO;EAAG,MAAM,CAAC;CAAE;CAEzE,IAAI,wBAAwB,KAAK,GAE/B,OAAO;EACL,OAAO,wBAAwB,KAAK;EACpC,MAAM,oBAAoB,OAAO,CAAC,IAAI,6BAA6B,KAAK;CAC1E;CAGF,MAAM,OAAO,sBAAsB,KAAK;CACxC,OAAO;EAAE,OAAO,KAAK;EAAQ,MAAM,oBAAoB,OAAO,CAAC,IAAI;CAAK;AAC1E,GAAG;CAAC;CAAkB;CAAkB;AAAQ,CAAC"}

package/es/Table/react/useTableVTableEvents.mjs

@@ -0,0 +1,132 @@
+"use client";
+import { resolveTableCanvasPalette } from "../canvas/theme.mjs";
+import { getAllRowsHeight } from "../vtable/vtableAdapter.mjs";
+import { patchFrozenShadowControls } from "../vtable/frozenShadow.mjs";
+import { alignStickyGroupTitles } from "../canvas/groupTitle.mjs";
+import { syncCascadeSelectionRanges } from "../vtable/seriesSelection.mjs";
+import { refreshRowSeriesHover, refreshVisibleRowSeriesCells } from "../canvas/rowSeries.mjs";
+import { TABLE_EVENT_TYPE } from "@visactor/vtable";
+//#region src/Table/react/useTableVTableEvents.ts
+const useTableVTableEvents = ({ lastRowSeriesHoverRef, onReady, rootRef, scheduleEditorSync, setA11yVersion, setMeasuredContentHeight, setResizeGuide, setSelectionVersion, stickyGroupBackground, syncFrozenColumnShadow, tableCleanupRef, tableRef, token }) => {
+	const handleReady = (instance, isInitial) => {
+		const table = instance;
+		const updateDomContainer = () => table.scenegraph.updateDomContainer();
+		const onResize = (args) => {
+			updateDomContainer();
+			alignStickyGroupTitles(table, stickyGroupBackground);
+			const host = rootRef.current;
+			const el = table.getElement();
+			if (host == null || el == null) return;
+			const rect = table.getCellRelativeRect(args?.col ?? 0, 0);
+			const hr = host.getBoundingClientRect();
+			const tr = el.getBoundingClientRect();
+			const guideLeft = rect.left + rect.width + tr.left - hr.left;
+			setResizeGuide(Math.max(0, Math.min(guideLeft, host.clientWidth - 1)));
+		};
+		const onResizeEnd = () => {
+			updateDomContainer();
+			alignStickyGroupTitles(table, stickyGroupBackground);
+			setResizeGuide(null);
+		};
+		const onSelectionChange = () => {
+			lastRowSeriesHoverRef.current = null;
+			setSelectionVersion((version) => version + 1);
+			setA11yVersion((version) => version + 1);
+			refreshVisibleRowSeriesCells(table);
+		};
+		const onEditTrigger = () => scheduleEditorSync();
+		/**
+		* 折叠 / 展开之后**容器高度必须重新问引擎**。外层容器的高度是 React 按 `records` 算的
+		* （`computeTableHeight`），而折叠只改引擎内部状态：`records` 这个 prop 的身份和内容都没变，
+		* 那个 memo 不会重算 —— 折起来时容器留一大片空白，展开时反过来把内容裁掉。
+		*
+		* 引擎发这个事件时行高**已经是新的**（实测：handler 里同步读 `getAllRowsHeight()` 就是
+		* 折叠后的值），所以同步读，不用等下一帧。
+		*
+		* 这里不能改成「按数据重算」：树节点的 `hierarchyState` 引擎会写回记录，但分组标题行
+		* （`groupBy` 生成的那些）的折叠状态只存在引擎的分组结构里，`records` 上没有。
+		*/
+		const onHierarchyChange = () => {
+			syncCascadeSelectionRanges(table);
+			alignStickyGroupTitles(table, stickyGroupBackground);
+			refreshVisibleRowSeriesCells(table);
+			setA11yVersion((version) => version + 1);
+			const measured = getAllRowsHeight(table);
+			if (measured != null) setMeasuredContentHeight(measured + 8);
+		};
+		const onLeaveTable = () => {
+			const previous = lastRowSeriesHoverRef.current;
+			lastRowSeriesHoverRef.current = null;
+			if (previous == null || previous < 0) return;
+			refreshRowSeriesHover(table, previous, -1);
+		};
+		const onScrollSticky = () => {
+			alignStickyGroupTitles(table, stickyGroupBackground);
+		};
+		/**
+		* `updateOption` 的第一件事是 `editorManager.cancelEdit()`，而它**只调 `exit()` + `onEnd()`、
+		* 不写值**（提交走 `completeEdit()`）—— 正在输入的内容会被静默丢弃。
+		*
+		* 而 `updateOption` 在我们的用法下**几乎必然被调用**：react-vtable 用 vutils 的 `isEqual`
+		* 比较前后 option，它的实现对任何**非纯对象**直接返回 false，而我们的列上挂着
+		* `editor: new TextEditor()` 这类类实例 —— 内容完全相同的两个实例也判不等。所以只要使用方
+		* 把 `columns` / `records` 内联传入（父组件每次渲染都换数组身份），每次渲染都会走一遍
+		* `updateOption`。实测：父组件每 1.5s 重渲染一次时，刚打开的编辑器会在 2s 内被关掉；
+		* 换成静态父组件则一直开着。
+		*
+		* VTable 在 `cancelEdit()` **之前**发这个事件，所以在这里补一次提交，把「静默丢弃」变成
+		* 「正常结束」。
+		*/
+		const onBeforeUpdateOption = () => {
+			table.completeEditCell?.();
+		};
+		/**
+		* a11y 隐藏层每个 cell 现读 `table.getCellValue`，但只在 `a11yVersion` 自增时才重读。
+		* 编辑提交走的是 `changeCellValue`，既不滚动也不改变选中 —— 不订阅它，读屏读到的会一直是
+		* 改前的旧值（canvas 上已经是新值），要等下一次滚动或点选才自愈。
+		*/
+		const onCellValueChange = () => {
+			setA11yVersion((version) => version + 1);
+		};
+		tableCleanupRef.current?.();
+		table.on("resize_column", onResize);
+		table.on("resize_column_end", onResizeEnd);
+		table.on("scroll", onScrollSticky);
+		table.on(TABLE_EVENT_TYPE.BEFORE_UPDATE_OPTION, onBeforeUpdateOption);
+		table.on(TABLE_EVENT_TYPE.CHANGE_CELL_VALUE, onCellValueChange);
+		table.on(TABLE_EVENT_TYPE.CHANGE_CELL_VALUES, onCellValueChange);
+		table.on(TABLE_EVENT_TYPE.CLICK_CELL, onEditTrigger);
+		table.on(TABLE_EVENT_TYPE.DBLCLICK_CELL, onEditTrigger);
+		table.on(TABLE_EVENT_TYPE.SELECTED_CHANGED, onSelectionChange);
+		table.on(TABLE_EVENT_TYPE.SELECTED_CLEAR, onSelectionChange);
+		table.on(TABLE_EVENT_TYPE.TREE_HIERARCHY_STATE_CHANGE, onHierarchyChange);
+		table.on(TABLE_EVENT_TYPE.MOUSELEAVE_TABLE, onLeaveTable);
+		tableCleanupRef.current = () => {
+			table.off("resize_column", onResize);
+			table.off("resize_column_end", onResizeEnd);
+			table.off("scroll", onScrollSticky);
+			table.off(TABLE_EVENT_TYPE.BEFORE_UPDATE_OPTION, onBeforeUpdateOption);
+			table.off(TABLE_EVENT_TYPE.CHANGE_CELL_VALUE, onCellValueChange);
+			table.off(TABLE_EVENT_TYPE.CHANGE_CELL_VALUES, onCellValueChange);
+			table.off(TABLE_EVENT_TYPE.CLICK_CELL, onEditTrigger);
+			table.off(TABLE_EVENT_TYPE.DBLCLICK_CELL, onEditTrigger);
+			table.off(TABLE_EVENT_TYPE.SELECTED_CHANGED, onSelectionChange);
+			table.off(TABLE_EVENT_TYPE.SELECTED_CLEAR, onSelectionChange);
+			table.off(TABLE_EVENT_TYPE.TREE_HIERARCHY_STATE_CHANGE, onHierarchyChange);
+			table.off(TABLE_EVENT_TYPE.MOUSELEAVE_TABLE, onLeaveTable);
+		};
+		tableRef.current = table;
+		setSelectionVersion((version) => version + 1);
+		table.__superadPalette = resolveTableCanvasPalette(token);
+		patchFrozenShadowControls(table);
+		syncFrozenColumnShadow();
+		alignStickyGroupTitles(table, stickyGroupBackground);
+		setA11yVersion((version) => version + 1);
+		onReady?.(table, isInitial);
+	};
+	return { onReady: handleReady };
+};
+//#endregion
+export { useTableVTableEvents };
+
+//# sourceMappingURL=useTableVTableEvents.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useTableVTableEvents.mjs","names":[],"sources":["../../../src/Table/react/useTableVTableEvents.ts"],"sourcesContent":["'use client';\n\nimport { type ListTable as ListTableInstance, TABLE_EVENT_TYPE } from '@visactor/vtable';\nimport type { Dispatch, RefObject, SetStateAction } from 'react';\n\nimport { alignStickyGroupTitles } from '../canvas/groupTitle';\nimport { refreshRowSeriesHover, refreshVisibleRowSeriesCells } from '../canvas/rowSeries';\nimport { resolveTableCanvasPalette, type TableToken } from '../canvas/theme';\nimport { TABLE_HEIGHT_GUTTER } from '../core/size';\nimport type { TableProps } from '../type';\nimport { patchFrozenShadowControls } from '../vtable/frozenShadow';\nimport { syncCascadeSelectionRanges } from '../vtable/seriesSelection';\nimport { getAllRowsHeight } from '../vtable/vtableAdapter';\n\ntype MutableRef<T> = { current: T };\n\nexport const useTableVTableEvents = ({\n  lastRowSeriesHoverRef,\n  onReady,\n  rootRef,\n  scheduleEditorSync,\n  setA11yVersion,\n  setMeasuredContentHeight,\n  setResizeGuide,\n  setSelectionVersion,\n  stickyGroupBackground,\n  syncFrozenColumnShadow,\n  tableCleanupRef,\n  tableRef,\n  token,\n}: {\n  lastRowSeriesHoverRef: MutableRef<number | null>;\n  onReady?: TableProps['onReady'];\n  rootRef: RefObject<HTMLDivElement | null>;\n  scheduleEditorSync: () => void;\n  setA11yVersion: Dispatch<SetStateAction<number>>;\n  setMeasuredContentHeight: Dispatch<SetStateAction<number | null>>;\n  setResizeGuide: Dispatch<SetStateAction<number | null>>;\n  setSelectionVersion: Dispatch<SetStateAction<number>>;\n  stickyGroupBackground: string;\n  syncFrozenColumnShadow: () => void;\n  tableCleanupRef: MutableRef<(() => void) | undefined>;\n  tableRef: MutableRef<ListTableInstance | null>;\n  token: TableToken;\n}) => {\n  const handleReady = (instance: unknown, isInitial: boolean) => {\n    const table = instance as ListTableInstance;\n    const updateDomContainer = () => table.scenegraph.updateDomContainer();\n    const onResize = (args: any) => {\n      updateDomContainer();\n      alignStickyGroupTitles(table, stickyGroupBackground);\n      const host = rootRef.current;\n      const el = table.getElement();\n      if (host == null || el == null) return;\n      const rect = table.getCellRelativeRect(args?.col ?? 0, 0);\n      const hr = host.getBoundingClientRect();\n      const tr = el.getBoundingClientRect();\n      const guideLeft = rect.left + rect.width + tr.left - hr.left;\n      setResizeGuide(Math.max(0, Math.min(guideLeft, host.clientWidth - 1)));\n    };\n    const onResizeEnd = () => {\n      updateDomContainer();\n      alignStickyGroupTitles(table, stickyGroupBackground);\n      setResizeGuide(null);\n    };\n\n    const onSelectionChange = () => {\n      lastRowSeriesHoverRef.current = null;\n      setSelectionVersion((version) => version + 1);\n      setA11yVersion((version) => version + 1);\n      refreshVisibleRowSeriesCells(table);\n    };\n    const onEditTrigger = () => scheduleEditorSync();\n    /**\n     * 折叠 / 展开之后**容器高度必须重新问引擎**。外层容器的高度是 React 按 `records` 算的\n     * （`computeTableHeight`），而折叠只改引擎内部状态：`records` 这个 prop 的身份和内容都没变，\n     * 那个 memo 不会重算 —— 折起来时容器留一大片空白，展开时反过来把内容裁掉。\n     *\n     * 引擎发这个事件时行高**已经是新的**（实测：handler 里同步读 `getAllRowsHeight()` 就是\n     * 折叠后的值），所以同步读，不用等下一帧。\n     *\n     * 这里不能改成「按数据重算」：树节点的 `hierarchyState` 引擎会写回记录，但分组标题行\n     * （`groupBy` 生成的那些）的折叠状态只存在引擎的分组结构里，`records` 上没有。\n     */\n    const onHierarchyChange = () => {\n      syncCascadeSelectionRanges(table);\n      alignStickyGroupTitles(table, stickyGroupBackground);\n      refreshVisibleRowSeriesCells(table);\n      setA11yVersion((version) => version + 1);\n      const measured = getAllRowsHeight(table);\n      if (measured != null) setMeasuredContentHeight(measured + TABLE_HEIGHT_GUTTER);\n    };\n    const onLeaveTable = () => {\n      const previous = lastRowSeriesHoverRef.current;\n      lastRowSeriesHoverRef.current = null;\n      if (previous == null || previous < 0) return;\n      refreshRowSeriesHover(table, previous, -1);\n    };\n    const onScrollSticky = () => {\n      alignStickyGroupTitles(table, stickyGroupBackground);\n    };\n    /**\n     * `updateOption` 的第一件事是 `editorManager.cancelEdit()`，而它**只调 `exit()` + `onEnd()`、\n     * 不写值**（提交走 `completeEdit()`）—— 正在输入的内容会被静默丢弃。\n     *\n     * 而 `updateOption` 在我们的用法下**几乎必然被调用**：react-vtable 用 vutils 的 `isEqual`\n     * 比较前后 option，它的实现对任何**非纯对象**直接返回 false，而我们的列上挂着\n     * `editor: new TextEditor()` 这类类实例 —— 内容完全相同的两个实例也判不等。所以只要使用方\n     * 把 `columns` / `records` 内联传入（父组件每次渲染都换数组身份），每次渲染都会走一遍\n     * `updateOption`。实测：父组件每 1.5s 重渲染一次时，刚打开的编辑器会在 2s 内被关掉；\n     * 换成静态父组件则一直开着。\n     *\n     * VTable 在 `cancelEdit()` **之前**发这个事件，所以在这里补一次提交，把「静默丢弃」变成\n     * 「正常结束」。\n     */\n    const onBeforeUpdateOption = () => {\n      (table as ListTableInstance & { completeEditCell?: () => void }).completeEditCell?.();\n    };\n    /**\n     * a11y 隐藏层每个 cell 现读 `table.getCellValue`，但只在 `a11yVersion` 自增时才重读。\n     * 编辑提交走的是 `changeCellValue`，既不滚动也不改变选中 —— 不订阅它，读屏读到的会一直是\n     * 改前的旧值（canvas 上已经是新值），要等下一次滚动或点选才自愈。\n     */\n    const onCellValueChange = () => {\n      setA11yVersion((version) => version + 1);\n    };\n\n    tableCleanupRef.current?.();\n    table.on('resize_column', onResize);\n    table.on('resize_column_end', onResizeEnd);\n    table.on('scroll', onScrollSticky);\n    table.on(TABLE_EVENT_TYPE.BEFORE_UPDATE_OPTION, onBeforeUpdateOption);\n    table.on(TABLE_EVENT_TYPE.CHANGE_CELL_VALUE, onCellValueChange);\n    table.on(TABLE_EVENT_TYPE.CHANGE_CELL_VALUES, onCellValueChange);\n    table.on(TABLE_EVENT_TYPE.CLICK_CELL, onEditTrigger);\n    table.on(TABLE_EVENT_TYPE.DBLCLICK_CELL, onEditTrigger);\n    table.on(TABLE_EVENT_TYPE.SELECTED_CHANGED, onSelectionChange);\n    table.on(TABLE_EVENT_TYPE.SELECTED_CLEAR, onSelectionChange);\n    table.on(TABLE_EVENT_TYPE.TREE_HIERARCHY_STATE_CHANGE, onHierarchyChange);\n    table.on(TABLE_EVENT_TYPE.MOUSELEAVE_TABLE, onLeaveTable);\n    tableCleanupRef.current = () => {\n      table.off('resize_column', onResize);\n      table.off('resize_column_end', onResizeEnd);\n      table.off('scroll', onScrollSticky);\n      table.off(TABLE_EVENT_TYPE.BEFORE_UPDATE_OPTION, onBeforeUpdateOption);\n      table.off(TABLE_EVENT_TYPE.CHANGE_CELL_VALUE, onCellValueChange);\n      table.off(TABLE_EVENT_TYPE.CHANGE_CELL_VALUES, onCellValueChange);\n      table.off(TABLE_EVENT_TYPE.CLICK_CELL, onEditTrigger);\n      table.off(TABLE_EVENT_TYPE.DBLCLICK_CELL, onEditTrigger);\n      table.off(TABLE_EVENT_TYPE.SELECTED_CHANGED, onSelectionChange);\n      table.off(TABLE_EVENT_TYPE.SELECTED_CLEAR, onSelectionChange);\n      table.off(TABLE_EVENT_TYPE.TREE_HIERARCHY_STATE_CHANGE, onHierarchyChange);\n      table.off(TABLE_EVENT_TYPE.MOUSELEAVE_TABLE, onLeaveTable);\n    };\n    tableRef.current = table;\n    setSelectionVersion((version) => version + 1);\n    (\n      table as ListTableInstance & {\n        __superadPalette?: ReturnType<typeof resolveTableCanvasPalette>;\n      }\n    ).__superadPalette = resolveTableCanvasPalette(token);\n    patchFrozenShadowControls(table);\n    syncFrozenColumnShadow();\n    alignStickyGroupTitles(table, stickyGroupBackground);\n    setA11yVersion((version) => version + 1);\n    onReady?.(table, isInitial);\n  };\n\n  return { onReady: handleReady };\n};\n"],"mappings":"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"}

package/es/Table/type.d.mts

@@ -0,0 +1,279 @@
+import { CSSProperties, ReactNode, Ref } from "react";
+import { ColumnDefine, ColumnDefine as ColumnDefine$1, ColumnsDefine as ColumnsDefine$1, ListTable, ListTableConstructorOptions, ListTableConstructorOptions as ListTableConstructorOptions$1 } from "@visactor/vtable";
+//#region src/Table/type.d.ts
+type TableSize = 'large' | 'middle' | 'small';
+type TableHover = 'cell' | 'column' | 'cross' | 'none' | 'row';
+type TableCellType = 'address' | 'array' | 'boolean' | 'checkbox' | 'currency' | 'date' | 'dateRange' | 'datetime' | 'email' | 'image' | 'json' | 'link' | 'number' | 'phone' | 'progress' | 'rating' | 'select' | 'tag' | 'text' | 'user';
+declare const TABLE_CELL_MIN_WIDTH: Record<TableCellType, number>;
+declare const DEFAULT_TABLE_COLUMN_MIN_WIDTH = 80;
+declare const TABLE_ROW_HEIGHT: Record<TableSize, number>;
+declare const TABLE_HEADER_HEIGHT = 36;
+interface TableSelectOption {
+  /**
+   * SuperAd tag color name (`blue`, `green`, `purple`…) or a hex that snaps to that palette.
+   */
+  color?: string;
+  label: string;
+  value: string;
+}
+interface TableUser {
+  avatar?: string;
+  /**
+   * 第二行说明（部门 / 公司 / 邮箱…）。只出现在**人员选择面板**里，单元格仍只画姓名。
+   */
+  description?: string;
+  name: string;
+}
+interface TableAddress {
+  city?: string;
+  country?: string;
+  postcode?: string;
+  state?: string;
+  street?: string;
+  street2?: string;
+}
+interface TableRecord {
+  [key: string]: unknown;
+  children?: TableRecord[];
+  hierarchyState?: 'collapse' | 'expand';
+}
+/** SuperAd column. Use `type` for bitable-style cells; raw VTable columns are also accepted. */
+interface TableColumn {
+  /**
+   * Currency symbol for `currency` cells.
+   * @default ¥
+   */
+  currency?: string;
+  /**
+   * 状态 / 标签标题后跟的时长来源：记录里存日期范围的字段名（值本身是 `[起, 止]` 数组），
+   * 或 `{ from, to }` 两个字段。时长按「N天 / N个月」现算，不写死在选项里。
+   */
+  duration?: string | {
+    from: string;
+    to: string;
+  };
+  /**
+   * Enable editor for this column.
+   * @default inherits Table.editable
+   */
+  editable?: boolean;
+  field: string;
+  /**
+   * Custom cell text, passed straight through to VTable. When set it wins over the
+   * formatter this component would generate for `type`; the column still keeps its
+   * editor, so `fieldFormat` and `editable` can be used together.
+   */
+  fieldFormat?: ColumnDefine['fieldFormat'];
+  /**
+   * Datetime display format, also used by `dateRange`.
+   * @default YYYY-MM-DD
+   */
+  format?: string;
+  /** Minimum column width. Defaults to a type-specific value. */
+  minWidth?: number | string;
+  /**
+   * Allow multiple values for tag / select / user / email / phone.
+   * @default false for select, true for tag / user / email / phone / array
+   */
+  multiple?: boolean;
+  options?: TableSelectOption[];
+  /**
+   * Enable header sort.
+   * @default false
+   */
+  sort?: boolean;
+  /**
+   * Optional VTable cell style. Useful for row-level highlighting in tree / grouped tables.
+   */
+  style?: ColumnDefine['style'];
+  title?: string;
+  /**
+   * Mark this column as the tree expand column.
+   * @default first column when Table.tree is true
+   */
+  tree?: boolean;
+  /**
+   * Cell type.
+   *
+   * `image` is preview-only (`clickToPreview`). It never mounts an editor, even
+   * when `Table.editable` is true.
+   * @default text
+   */
+  type?: TableCellType;
+  /**
+   * Suffix for `number` / `progress` cells, such as `%`.
+   * `progress` defaults to `%`.
+   */
+  unit?: string;
+  /** People directory for `user` picker. */
+  users?: TableUser[];
+  width?: number | string;
+}
+type TableColumnInput = ColumnDefine | TableColumn;
+/** SuperAd table, wrapping VisActor VTable ListTable. */
+interface TableProps {
+  /**
+   * Stretch columns to fill the container.
+   * @default true
+   */
+  autoFillWidth?: boolean;
+  /**
+   * Shrink numeric height to content height.
+   * @default true
+   */
+  autoHeight?: boolean;
+  className?: string;
+  /** SuperAd or VTable column definitions. */
+  columns?: TableColumnInput[];
+  /**
+   * Enable editors on supported cell types. Click a cell to edit; select / tag cells open an option picker.
+   * @default false
+   */
+  editable?: boolean;
+  /**
+   * Empty state copy.
+   * @default No data
+   */
+  emptyText?: string;
+  /**
+   * Freeze the first N data columns. The row index / drag column stays fixed on
+   * the left, so with it present the frozen columns start at the second column.
+   *
+   * VTable caps the frozen block at 80% of the table width. Rather than dropping
+   * the whole freeze once the block would be wider, the block is trimmed to the
+   * columns that fit — a narrow container freezes fewer columns instead of none.
+   * Pass `option={{ unfreezeAllOnExceedsMaxWidth: true }}` to drop it entirely
+   * instead. Reaching the column count (N plus the row index column) zeroes it too.
+   * @default 0
+   */
+  frozenColCount?: number;
+  /**
+   * Group rows by field name.
+   */
+  groupBy?: string | string[];
+  /**
+   * Per-group title tag colors, keyed by group value. When provided, group
+   * titles render as colored tags while keeping the standard collapse icon.
+   */
+  groupTitleColors?: Record<string, string | undefined>;
+  /** Merged on top of the default group title style. */
+  groupTitleStyle?: NonNullable<ListTableConstructorOptions['theme']>['groupTitleStyle'];
+  /**
+   * Header row height in pixels. Strings like `32px` are accepted.
+   */
+  headerRowHeight?: number | string;
+  /**
+   * Table height. When autoHeight is true and records exist, a numeric value shrinks to content height.
+   * @default auto
+   */
+  height?: number | string;
+  /**
+   * Hover highlight mode.
+   * @default row
+   */
+  hover?: TableHover;
+  /**
+   * Called after a column is moved with the column settings menu.
+   */
+  onColumnOrderChange?: (fields: string[]) => void;
+  /**
+   * Called after a column is shown or hidden with the column settings menu.
+   */
+  onColumnVisibilityChange?: (field: string, visible: boolean) => void;
+  onReady?: (instance: ListTable, isInitial: boolean) => void;
+  /**
+   * Extra VTable options. First-class props win on conflict.
+   *
+   * Column resizing is off by default — pass `{ columnResizeMode: 'all' }`
+   * (or `'header'` / `'body'`) to enable it. The column drag guide only appears
+   * while it is on.
+   *
+   * `rowSeriesNumber` is merged onto the built-in row index column rather than
+   * replacing it, so a custom `field` / `cellType` / `title` applies and the
+   * checkbox state follows the `field` you give. One exception: while the row
+   * selection column is on, its checkbox is drawn by this component on canvas, so
+   * `cellType` / `headerType` are dropped — passing `checkbox` would make VTable
+   * draw a second one in the same cell.
+   */
+  option?: ListTableConstructorOptions;
+  /** Row data. Nested rows use `children` when `tree` is on. */
+  records?: TableRecord[];
+  ref?: Ref<ListTable>;
+  /**
+   * Reorder rows via VTable's native `rowSeriesNumber.dragOrder` handle.
+   * Opt-in per table (`@default false`); other tables are unchanged unless they pass it.
+   * Tree / grouped tables can turn it on, but VTable reorders visible rows and does not
+   * keep parent–child or group-title semantics — dragging a parent will not move children
+   * as a unit, and group title rows are not data records.
+   * @default false
+   */
+  rowDrag?: boolean;
+  /**
+   * Body row height in pixels. Strings like `32px` are accepted.
+   */
+  rowHeight?: number | string;
+  /**
+   * Render extra actions in the selection status bar.
+   *
+   * `selectedRowIndexes` lists **visible** rows only. The "已选 N 行" count next to it
+   * counts every checked record instead, so it can exceed `selectedRowIndexes.length`
+   * when a group node is collapsed — collapsed rows are still selected, they just are
+   * not on screen. Do not derive one from the other.
+   */
+  selectionActions?: (selectedRowIndexes: number[], clearSelection: () => void) => ReactNode;
+  /**
+   * Show the column settings menu button in the header.
+   * @default true
+   */
+  showColumnSettings?: boolean;
+  /**
+   * @default true
+   */
+  showHeader?: boolean;
+  /**
+   * Show a leading row index column.
+   * @default false
+   */
+  showRowIndex?: boolean;
+  /**
+   * Show the row selection checkbox column.
+   * @default true
+   */
+  showRowSelection?: boolean;
+  /**
+   * Show vertical borders between columns, including the leading row index column.
+   * @default false
+   */
+  showVerticalBorder?: boolean;
+  /**
+   * Row density.
+   * @default middle
+   */
+  size?: TableSize;
+  style?: CSSProperties;
+  /** Merged on top of the SuperAd VTable theme. */
+  theme?: ListTableConstructorOptions['theme'];
+  /**
+   * Enable tree rows. Records nest via `children`.
+   * @default false
+   */
+  tree?: boolean;
+  /**
+   * Expanded tree depth. Use `Infinity` to expand all.
+   * @default 1
+   */
+  treeExpandLevel?: number;
+  /**
+   * Indent per tree level.
+   * @default 16
+   */
+  treeIndent?: number;
+  /**
+   * @default 100%
+   */
+  width?: number | string;
+}
+type TableTheme = NonNullable<ListTableConstructorOptions['theme']>;
+//#endregion
+export { type ColumnDefine$1 as ColumnDefine, type ColumnsDefine$1 as ColumnsDefine, DEFAULT_TABLE_COLUMN_MIN_WIDTH, type ListTableConstructorOptions$1 as ListTableConstructorOptions, TABLE_CELL_MIN_WIDTH, TABLE_HEADER_HEIGHT, TABLE_ROW_HEIGHT, TableAddress, TableCellType, TableColumn, TableColumnInput, TableHover, TableProps, TableRecord, TableSelectOption, TableSize, TableTheme, TableUser };
+//# sourceMappingURL=type.d.mts.map

package/es/Table/type.mjs

@@ -0,0 +1,34 @@
+//#region src/Table/type.ts
+const TABLE_CELL_MIN_WIDTH = {
+	address: 160,
+	array: 104,
+	boolean: 64,
+	checkbox: 56,
+	currency: 96,
+	date: 112,
+	dateRange: 216,
+	datetime: 144,
+	email: 144,
+	image: 80,
+	json: 120,
+	link: 144,
+	number: 80,
+	phone: 128,
+	progress: 112,
+	rating: 96,
+	select: 96,
+	tag: 104,
+	text: 80,
+	user: 112
+};
+const DEFAULT_TABLE_COLUMN_MIN_WIDTH = 80;
+const TABLE_ROW_HEIGHT = {
+	large: 44,
+	middle: 36,
+	small: 32
+};
+const TABLE_HEADER_HEIGHT = 36;
+//#endregion
+export { DEFAULT_TABLE_COLUMN_MIN_WIDTH, TABLE_CELL_MIN_WIDTH, TABLE_HEADER_HEIGHT, TABLE_ROW_HEIGHT };
+
+//# sourceMappingURL=type.mjs.map

package/es/Table/type.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"type.mjs","names":[],"sources":["../../src/Table/type.ts"],"sourcesContent":["import type { ColumnDefine, ListTable, ListTableConstructorOptions } from '@visactor/vtable';\nimport type { CSSProperties, ReactNode, Ref } from 'react';\n\nexport type TableSize = 'large' | 'middle' | 'small';\n\nexport type TableHover = 'cell' | 'column' | 'cross' | 'none' | 'row';\n\nexport type TableCellType =\n  | 'address'\n  | 'array'\n  | 'boolean'\n  | 'checkbox'\n  | 'currency'\n  | 'date'\n  | 'dateRange'\n  | 'datetime'\n  | 'email'\n  | 'image'\n  | 'json'\n  | 'link'\n  | 'number'\n  | 'phone'\n  | 'progress'\n  | 'rating'\n  | 'select'\n  | 'tag'\n  | 'text'\n  | 'user';\n\nexport const TABLE_CELL_MIN_WIDTH: Record<TableCellType, number> = {\n  address: 160,\n  array: 104,\n  boolean: 64,\n  checkbox: 56,\n  currency: 96,\n  date: 112,\n  dateRange: 216,\n  datetime: 144,\n  email: 144,\n  image: 80,\n  json: 120,\n  link: 144,\n  number: 80,\n  phone: 128,\n  progress: 112,\n  rating: 96,\n  select: 96,\n  tag: 104,\n  text: 80,\n  user: 112,\n};\n\nexport const DEFAULT_TABLE_COLUMN_MIN_WIDTH = 80;\n\nexport const TABLE_ROW_HEIGHT: Record<TableSize, number> = {\n  large: 44,\n  middle: 36,\n  small: 32,\n};\nexport const TABLE_HEADER_HEIGHT = 36;\n\nexport interface TableSelectOption {\n  /**\n   * SuperAd tag color name (`blue`, `green`, `purple`…) or a hex that snaps to that palette.\n   */\n  color?: string;\n  label: string;\n  value: string;\n}\n\nexport interface TableUser {\n  avatar?: string;\n  /**\n   * 第二行说明（部门 / 公司 / 邮箱…）。只出现在**人员选择面板**里，单元格仍只画姓名。\n   */\n  description?: string;\n  name: string;\n}\n\nexport interface TableAddress {\n  city?: string;\n  country?: string;\n  postcode?: string;\n  state?: string;\n  street?: string;\n  street2?: string;\n}\n\nexport interface TableRecord {\n  [key: string]: unknown;\n  children?: TableRecord[];\n  hierarchyState?: 'collapse' | 'expand';\n}\n\n/** SuperAd column. Use `type` for bitable-style cells; raw VTable columns are also accepted. */\nexport interface TableColumn {\n  /**\n   * Currency symbol for `currency` cells.\n   * @default ¥\n   */\n  currency?: string;\n  /**\n   * 状态 / 标签标题后跟的时长来源：记录里存日期范围的字段名（值本身是 `[起, 止]` 数组），\n   * 或 `{ from, to }` 两个字段。时长按「N天 / N个月」现算，不写死在选项里。\n   */\n  duration?: string | { from: string; to: string };\n  /**\n   * Enable editor for this column.\n   * @default inherits Table.editable\n   */\n  editable?: boolean;\n  field: string;\n  /**\n   * Custom cell text, passed straight through to VTable. When set it wins over the\n   * formatter this component would generate for `type`; the column still keeps its\n   * editor, so `fieldFormat` and `editable` can be used together.\n   */\n  fieldFormat?: ColumnDefine['fieldFormat'];\n  /**\n   * Datetime display format, also used by `dateRange`.\n   * @default YYYY-MM-DD\n   */\n  format?: string;\n  /** Minimum column width. Defaults to a type-specific value. */\n  minWidth?: number | string;\n  /**\n   * Allow multiple values for tag / select / user / email / phone.\n   * @default false for select, true for tag / user / email / phone / array\n   */\n  multiple?: boolean;\n  options?: TableSelectOption[];\n  /**\n   * Enable header sort.\n   * @default false\n   */\n  sort?: boolean;\n  /**\n   * Optional VTable cell style. Useful for row-level highlighting in tree / grouped tables.\n   */\n  style?: ColumnDefine['style'];\n  title?: string;\n  /**\n   * Mark this column as the tree expand column.\n   * @default first column when Table.tree is true\n   */\n  tree?: boolean;\n  /**\n   * Cell type.\n   *\n   * `image` is preview-only (`clickToPreview`). It never mounts an editor, even\n   * when `Table.editable` is true.\n   * @default text\n   */\n  type?: TableCellType;\n  /**\n   * Suffix for `number` / `progress` cells, such as `%`.\n   * `progress` defaults to `%`.\n   */\n  unit?: string;\n  /** People directory for `user` picker. */\n  users?: TableUser[];\n  width?: number | string;\n}\n\nexport type TableColumnInput = ColumnDefine | TableColumn;\n\n/** SuperAd table, wrapping VisActor VTable ListTable. */\nexport interface TableProps {\n  /**\n   * Stretch columns to fill the container.\n   * @default true\n   */\n  autoFillWidth?: boolean;\n  /**\n   * Shrink numeric height to content height.\n   * @default true\n   */\n  autoHeight?: boolean;\n  className?: string;\n  /** SuperAd or VTable column definitions. */\n  columns?: TableColumnInput[];\n  /**\n   * Enable editors on supported cell types. Click a cell to edit; select / tag cells open an option picker.\n   * @default false\n   */\n  editable?: boolean;\n  /**\n   * Empty state copy.\n   * @default No data\n   */\n  emptyText?: string;\n  /**\n   * Freeze the first N data columns. The row index / drag column stays fixed on\n   * the left, so with it present the frozen columns start at the second column.\n   *\n   * VTable caps the frozen block at 80% of the table width. Rather than dropping\n   * the whole freeze once the block would be wider, the block is trimmed to the\n   * columns that fit — a narrow container freezes fewer columns instead of none.\n   * Pass `option={{ unfreezeAllOnExceedsMaxWidth: true }}` to drop it entirely\n   * instead. Reaching the column count (N plus the row index column) zeroes it too.\n   * @default 0\n   */\n  frozenColCount?: number;\n  /**\n   * Group rows by field name.\n   */\n  groupBy?: string | string[];\n  /**\n   * Per-group title tag colors, keyed by group value. When provided, group\n   * titles render as colored tags while keeping the standard collapse icon.\n   */\n  groupTitleColors?: Record<string, string | undefined>;\n  /** Merged on top of the default group title style. */\n  groupTitleStyle?: NonNullable<ListTableConstructorOptions['theme']>['groupTitleStyle'];\n  /**\n   * Header row height in pixels. Strings like `32px` are accepted.\n   */\n  headerRowHeight?: number | string;\n  /**\n   * Table height. When autoHeight is true and records exist, a numeric value shrinks to content height.\n   * @default auto\n   */\n  height?: number | string;\n  /**\n   * Hover highlight mode.\n   * @default row\n   */\n  hover?: TableHover;\n  /**\n   * Called after a column is moved with the column settings menu.\n   */\n  onColumnOrderChange?: (fields: string[]) => void;\n  /**\n   * Called after a column is shown or hidden with the column settings menu.\n   */\n  onColumnVisibilityChange?: (field: string, visible: boolean) => void;\n  onReady?: (instance: ListTable, isInitial: boolean) => void;\n  /**\n   * Extra VTable options. First-class props win on conflict.\n   *\n   * Column resizing is off by default — pass `{ columnResizeMode: 'all' }`\n   * (or `'header'` / `'body'`) to enable it. The column drag guide only appears\n   * while it is on.\n   *\n   * `rowSeriesNumber` is merged onto the built-in row index column rather than\n   * replacing it, so a custom `field` / `cellType` / `title` applies and the\n   * checkbox state follows the `field` you give. One exception: while the row\n   * selection column is on, its checkbox is drawn by this component on canvas, so\n   * `cellType` / `headerType` are dropped — passing `checkbox` would make VTable\n   * draw a second one in the same cell.\n   */\n  option?: ListTableConstructorOptions;\n  /** Row data. Nested rows use `children` when `tree` is on. */\n  records?: TableRecord[];\n  ref?: Ref<ListTable>;\n  /**\n   * Reorder rows via VTable's native `rowSeriesNumber.dragOrder` handle.\n   * Opt-in per table (`@default false`); other tables are unchanged unless they pass it.\n   * Tree / grouped tables can turn it on, but VTable reorders visible rows and does not\n   * keep parent–child or group-title semantics — dragging a parent will not move children\n   * as a unit, and group title rows are not data records.\n   * @default false\n   */\n  rowDrag?: boolean;\n  /**\n   * Body row height in pixels. Strings like `32px` are accepted.\n   */\n  rowHeight?: number | string;\n  /**\n   * Render extra actions in the selection status bar.\n   *\n   * `selectedRowIndexes` lists **visible** rows only. The \"已选 N 行\" count next to it\n   * counts every checked record instead, so it can exceed `selectedRowIndexes.length`\n   * when a group node is collapsed — collapsed rows are still selected, they just are\n   * not on screen. Do not derive one from the other.\n   */\n  selectionActions?: (selectedRowIndexes: number[], clearSelection: () => void) => ReactNode;\n  /**\n   * Show the column settings menu button in the header.\n   * @default true\n   */\n  showColumnSettings?: boolean;\n  /**\n   * @default true\n   */\n  showHeader?: boolean;\n  /**\n   * Show a leading row index column.\n   * @default false\n   */\n  showRowIndex?: boolean;\n  /**\n   * Show the row selection checkbox column.\n   * @default true\n   */\n  showRowSelection?: boolean;\n  /**\n   * Show vertical borders between columns, including the leading row index column.\n   * @default false\n   */\n  showVerticalBorder?: boolean;\n  /**\n   * Row density.\n   * @default middle\n   */\n  size?: TableSize;\n  style?: CSSProperties;\n  /** Merged on top of the SuperAd VTable theme. */\n  theme?: ListTableConstructorOptions['theme'];\n  /**\n   * Enable tree rows. Records nest via `children`.\n   * @default false\n   */\n  tree?: boolean;\n  /**\n   * Expanded tree depth. Use `Infinity` to expand all.\n   * @default 1\n   */\n  treeExpandLevel?: number;\n  /**\n   * Indent per tree level.\n   * @default 16\n   */\n  treeIndent?: number;\n  /**\n   * @default 100%\n   */\n  width?: number | string;\n}\n\nexport type { ColumnDefine, ColumnsDefine, ListTableConstructorOptions } from '@visactor/vtable';\nexport type TableTheme = NonNullable<ListTableConstructorOptions['theme']>;\n"],"mappings":";AA6BA,MAAa,uBAAsD;CACjE,SAAS;CACT,OAAO;CACP,SAAS;CACT,UAAU;CACV,UAAU;CACV,MAAM;CACN,WAAW;CACX,UAAU;CACV,OAAO;CACP,OAAO;CACP,MAAM;CACN,MAAM;CACN,QAAQ;CACR,OAAO;CACP,UAAU;CACV,QAAQ;CACR,QAAQ;CACR,KAAK;CACL,MAAM;CACN,MAAM;AACR;AAEA,MAAa,iCAAiC;AAE9C,MAAa,mBAA8C;CACzD,OAAO;CACP,QAAQ;CACR,OAAO;AACT;AACA,MAAa,sBAAsB"}

package/es/Table/vtable/columns.d.mts

@@ -0,0 +1,17 @@
+import { TableColumnInput } from "../type.mjs";
+import { TableToken } from "../canvas/theme.mjs";
+import "../core/cellValue.mjs";
+import { TableI18n } from "../core/tableI18n.mjs";
+import { ColumnsDefine } from "@visactor/vtable";
+//#region src/Table/vtable/columns.d.ts
+interface CompileColumnsContext {
+  editable?: boolean;
+  groupedTree?: boolean;
+  i18n?: TableI18n;
+  token?: TableToken;
+  tree?: boolean;
+}
+declare const compileColumns: (columns: TableColumnInput[] | undefined, ctx?: CompileColumnsContext) => ColumnsDefine | undefined;
+//#endregion
+export { CompileColumnsContext, compileColumns };
+//# sourceMappingURL=columns.d.mts.map