@superad/ui 0.1.1

package/es/Table/vtable/seriesSelection.mjs

@@ -0,0 +1,374 @@
+import { isGroupTitleRecord } from "../core/cellValue.mjs";
+import { clearCheckboxState, clearSelected, fireTableEvent, getDataSource, getIndexKey, getInternalProps, getLayoutMapRowSeriesField, getRecordIndexByCell, getRecordShowIndexByCell, getRecords, getScenegraph, getStateManager, getVisibleRowRange, selectCells, setCellCheckboxStateByRecordIndex, updateCellContent, updateCellContentRange, updateNextFrame } from "./vtableAdapter.mjs";
+import { createFullRowRange, isFullRowRange, selectAllRows, toggleRowSelection } from "../core/rowSelection.mjs";
+import { TABLE_EVENT_TYPE } from "@visactor/vtable";
+//#region src/Table/vtable/seriesSelection.ts
+const isGroupTitleRow = (table, row) => Boolean(getInternalProps(table)?.groupBy && isGroupTitleRecord(table?.getCellOriginRecord?.(0, row)));
+/**
+* Last body row select-all should cover. Group title rows carry no data — the row series
+* skips them when numbering, the header checkbox route walks past them, and
+* `getCascadeSelectedRowIndexes` leaves them out — so select-all has to agree with all of
+* them. Returns a row below the header when every body row is a group.
+*/
+const resolveSelectionEndRow = (table) => {
+	const firstRow = table?.columnHeaderLevelCount ?? 1;
+	let row = (table?.rowCount ?? 1) - 1;
+	while (row >= firstRow && isGroupTitleRow(table, row)) row -= 1;
+	return row;
+};
+/**
+* First body row a select-all range may start on. Group title rows carry no data — the row
+* series skips them when numbering and the header checkbox leaves them out — so select-all
+* has to agree with both. Returns a row past the last body row when every one is a group.
+*/
+const resolveSelectionStartRow = (table) => {
+	const firstRow = table?.columnHeaderLevelCount ?? 1;
+	const lastRow = (table?.rowCount ?? 1) - 1;
+	let row = firstRow;
+	while (row <= lastRow && isGroupTitleRow(table, row)) row += 1;
+	return row;
+};
+/** 超过这个行数就不建索引：一份 rowCount 长的数组本身就是内存开销。 */
+const ROW_INDEX_CACHE_LIMIT = 1e5;
+/**
+* 分组表的行号索引缓存。
+*
+* `resolveRowSeriesIndex` 每画一个可见行都要从第一个体行数到它自己，每个 cursor 一次
+* `isGroupTitleRow`（内含 `getCellOriginRecord`）。两万行的分组表滚到中部时，单个可见行就是
+* 两万次记录查询，而一屏几十行、每帧都要重画 —— **序号列自己成了滚动卡顿源**（它只画一个数字）。
+*
+* 索引只跟「表头层数 + 总行数」有关（折叠 / 展开会改变行数），按它们失效，重建一次 O(行数)。
+*/
+const rowIndexCaches = /* @__PURE__ */ new WeakMap();
+const resolveGroupedRowIndex = (table, row, firstRow) => {
+	const rowCount = table?.rowCount ?? 0;
+	if (rowCount > ROW_INDEX_CACHE_LIMIT || rowCount <= firstRow) {
+		let index = 0;
+		for (let cursor = firstRow; cursor <= row; cursor += 1) if (isGroupTitleRow(table, cursor) === false) index += 1;
+		return index;
+	}
+	let cache = rowIndexCaches.get(table);
+	if (cache == null || cache.rowCount !== rowCount || cache.firstRow !== firstRow) {
+		const counts = [];
+		let index = 0;
+		for (let cursor = firstRow; cursor < rowCount; cursor += 1) {
+			if (isGroupTitleRow(table, cursor) === false) index += 1;
+			counts[cursor] = index;
+		}
+		cache = {
+			counts,
+			firstRow,
+			rowCount
+		};
+		rowIndexCaches.set(table, cache);
+	}
+	return cache.counts[row] ?? 0;
+};
+/** Row number that skips group title rows, so only data records are counted. */
+const resolveRowSeriesIndex = (table, row) => {
+	const firstRow = table?.columnHeaderLevelCount ?? 1;
+	if (row < firstRow) return 0;
+	if (getInternalProps(table)?.groupBy == null) return row - firstRow + 1;
+	return resolveGroupedRowIndex(table, row, firstRow);
+};
+/** Display value for a row series cell: group rows show no number. */
+const resolveRowSeriesValue = (table, row) => isGroupTitleRow(table, row) ? "" : resolveRowSeriesIndex(table, row);
+/**
+* VTable 在 `rowSeriesNumber.field` 缺省时用的字段名。**只在读不到解析结果时兜底** ——
+* 它是引擎的默认值，不是我们的契约；使用方覆盖 `field` 后就该以 `layoutMap` 里的为准。
+*/
+const FALLBACK_ROW_SERIES_CHECKBOX_FIELD = "_vtable_rowSeries_number";
+/**
+* 行号列复选框状态存在哪个键下。复选框的勾选态、底部「已选 N 行」计数、`selectionActions`
+* 和级联同步全都按这个键读写 `stateManager.checkedState`；读错键就**所有复选框恒为未选中、
+* 点选也不动**，而且不报任何错。
+*
+* 取值必须问 table 自己（见 `getLayoutMapRowSeriesField`）：写死默认名会在使用方给
+* `rowSeriesNumber` 传了自定义 `field` 时静默失效。
+*/
+const resolveRowSeriesField = (table) => getLayoutMapRowSeriesField(table) ?? FALLBACK_ROW_SERIES_CHECKBOX_FIELD;
+/**
+* 这张表有没有可以直接遍历的 `records`。
+*
+* **不能假设 `table.records` 就是数据。** 使用方传 `dataSource`（VTable 的懒加载形态，
+* 百万行 demo 就是）时，引擎在 `_setDataSource` 里把 `internalProps.records` 置空，react
+* 包装层再补一个 `[]`，取行只剩 `dataSource.get(i)` 一条路。此时所有按 records 遍历的
+* 代码全部**静默**走空：勾选确实写进了 `checkedState`，但「已选 N 行」恒为 0（浮动条根本
+* 不渲染）、表头全选一行都选不中 —— 和另外几张传 `records` 的表行为对不上。
+*/
+const hasRecordTree = (table) => Array.isArray(table?.records) && table.records.length > 0;
+/** 可被选中的数据行数。数据源表上分组标题行不存在（分组表一律按 records 走）。 */
+const sourceRowTotal = (table) => Math.max(0, (table?.rowCount ?? 0) - (table?.columnHeaderLevelCount ?? 0));
+/**
+* 数据源表的全选标记。
+*
+* **不能靠往 `checkedState` 里灌满所有行来全选**：百万行实测要 1 秒、66MB 堆，而懒加载
+* 数据源存在的意义正是不碰全部行。一个标记就够表达"整表选中"，`checkedState` 里留下的
+* 条目反过来变成**例外**（被单独取消的行），内存是 O(例外数)。数据源一换标记自动失效，
+* 不会把新数据整片画成已选。
+*/
+const selectAllStates = /* @__PURE__ */ new WeakMap();
+const isSelectAllActive = (table) => {
+	if (table == null) return false;
+	const state = selectAllStates.get(table);
+	return state != null && state.source === getDataSource(table);
+};
+const setSelectAllActive = (table, active) => {
+	if (table == null) return;
+	if (active) selectAllStates.set(table, { source: getDataSource(table) });
+	else selectAllStates.delete(table);
+};
+/**
+* 遍历这一列在 `checkedState` 里的所有取值。级联模式下这张表是**稀疏**的 —— 只有被点过
+* 的行才有条目，所以规模是「点过的行数」而不是表行数。
+*/
+const forEachRowSeriesState = (table, visit) => {
+	const field = resolveRowSeriesField(table);
+	getStateManager(table)?.checkedState?.forEach((entry) => {
+		if (entry != null) visit(entry[field]);
+	});
+};
+const countRowSeriesStates = (table) => {
+	let checked = 0;
+	let unchecked = 0;
+	forEachRowSeriesState(table, (value) => {
+		if (value === true) checked += 1;
+		else if (value === false) unchecked += 1;
+	});
+	return {
+		checked,
+		unchecked
+	};
+};
+/**
+* 直接写一条记录的勾选态。**只在批量化路径上用**（避开引擎逐行接口里的全树遍历，见
+* `setAllCascadeRows`）；单行勾选仍走 `setCellCheckboxStateByRecordIndex`，那条路要引擎
+* 顺手做级联与重绘。
+*/
+const setRowSeriesState = (table, key, value) => {
+	const checkedState = getStateManager(table)?.checkedState;
+	if (checkedState == null) return;
+	const field = resolveRowSeriesField(table);
+	const entry = checkedState.get(key) ?? {};
+	entry[field] = value;
+	checkedState.set(key, entry);
+};
+/** 只清本组件这一列：`checkedState` 里还可能存着使用方自己 checkbox 列的状态。 */
+const clearRowSeriesStates = (table) => {
+	const field = resolveRowSeriesField(table);
+	getStateManager(table)?.checkedState?.forEach((entry) => {
+		if (entry != null) delete entry[field];
+	});
+};
+/**
+* 重画序号列（表头 + 可见体行）。
+*
+* 这一列被自定义 layout 接管后，VTable 不会自己发现 `checkedState` 变了 —— records 那条路
+* 是靠 `setCellCheckboxStateByRecordIndex` 内部的 `table.render()` 顺带重画的，走标记的
+* 这条路没有那个调用，不自己标脏就要等下一次整表渲染才看得见勾。
+*/
+const refreshRowSeriesCells = (table) => {
+	if (getScenegraph(table) == null) return;
+	updateCellContent(table, 0, 0);
+	const { endRow, startRow } = getVisibleRowRange(table);
+	if (endRow >= startRow) updateCellContentRange(table, 0, startRow, 0, endRow);
+	updateNextFrame(table);
+};
+/**
+* 需要遍历的**可见**行范围。
+*
+* **不能扫全表。** 这两条路径每次勾选都会跑一遍，百万行的表上就是 100 万次
+* `getRecordIndexByCell` + Map 查询 —— 页面直接卡住，观感是「**复选框点不动**」。
+* 而 `select.ranges` 只影响**可见行**的画布高亮（VTable 渲染时本来也会裁到视口），
+* 所以扫可见窗口就够。
+*
+* 拿得到 `scenegraph.proxy` 时用它给的真实可视区；拿不到（未渲染 / 单测桩）就退到一个
+* 有上界的窗口，绝不能退回 `rowCount - 1`。
+*/
+const ROW_SCAN_LIMIT = 500;
+const selectionScanRange = (table) => {
+	const firstRow = table?.columnHeaderLevelCount ?? 1;
+	const lastRow = (table?.rowCount ?? 1) - 1;
+	const proxy = getScenegraph(table)?.proxy;
+	const startRow = Math.max(firstRow, proxy?.rowStart ?? firstRow);
+	return {
+		endRow: Math.min(lastRow, proxy?.rowEnd ?? startRow + ROW_SCAN_LIMIT),
+		startRow
+	};
+};
+const isCascadeSelectionTable = (table) => Boolean(getInternalProps(table)?.enableCheckboxCascade);
+const getRowRecordKey = (table, row) => {
+	const path = getRecordIndexByCell(table, 0, row) ?? getIndexKey(table, getRecordShowIndexByCell(table, 0, row));
+	if (path == null) return void 0;
+	return Array.isArray(path) ? path.toString() : String(path);
+};
+const getRowCheckboxState = (table, row) => {
+	const key = getRowRecordKey(table, row);
+	if (key == null) return void 0;
+	const state = getStateManager(table)?.checkedState?.get(key)?.[resolveRowSeriesField(table)];
+	if (state === void 0 && isSelectAllActive(table)) return true;
+	return state;
+};
+/** Toggle through VTable's record-index checkbox cascade. */
+const setRowCheckboxState = (table, row, checked) => {
+	const path = getRecordIndexByCell(table, 0, row);
+	if (path == null) return;
+	setCellCheckboxStateByRecordIndex(table, path, resolveRowSeriesField(table), checked);
+	syncCascadeSelectionRanges(table);
+	refreshRowSeriesCells(table);
+	fireTableEvent(table, TABLE_EVENT_TYPE.SELECTED_CHANGED, { ranges: getStateManager(table)?.select?.ranges ?? [] });
+};
+/** Keep VTable selection ranges in sync with checkbox state for row highlight. */
+const syncCascadeSelectionRanges = (table) => {
+	if (isCascadeSelectionTable(table) === false) return;
+	const { endRow, startRow } = selectionScanRange(table);
+	const endCol = (table?.colCount ?? 1) - 1;
+	const ranges = [];
+	let rangeStart = -1;
+	let rangeEnd = -1;
+	for (let row = startRow; row <= endRow; row += 1) {
+		if (isGroupTitleRow(table, row)) continue;
+		const state = getRowCheckboxState(table, row);
+		if (state === true || state === "indeterminate") {
+			if (rangeStart < 0) rangeStart = row;
+			rangeEnd = row;
+			continue;
+		}
+		if (rangeStart >= 0) {
+			ranges.push(createFullRowRange(rangeStart, rangeEnd, endCol));
+			rangeStart = -1;
+			rangeEnd = -1;
+		}
+	}
+	if (rangeStart >= 0) ranges.push(createFullRowRange(rangeStart, rangeEnd, endCol));
+	if (ranges.length === 0) clearSelected(table);
+	else selectCells(table, ranges);
+};
+const getCascadeHeaderState = (table) => {
+	if (hasRecordTree(table) === false) {
+		const { checked, unchecked } = countRowSeriesStates(table);
+		if (isSelectAllActive(table)) return unchecked > 0 ? "indeterminate" : true;
+		if (checked === 0) return false;
+		return checked >= sourceRowTotal(table) ? true : "indeterminate";
+	}
+	return getStateManager(table)?.headerCheckedState?.[resolveRowSeriesField(table)];
+};
+const setAllCascadeRows = (table, checked) => {
+	if (hasRecordTree(table) === false) {
+		setSelectAllActive(table, checked);
+		clearRowSeriesStates(table);
+		syncCascadeSelectionRanges(table);
+		refreshRowSeriesCells(table);
+		return;
+	}
+	if (checked === false) {
+		clearCascadeSelection(table);
+		clearSelected(table);
+		return;
+	}
+	const records = getRecords(table);
+	if (Array.isArray(records)) {
+		const field = resolveRowSeriesField(table);
+		const headerCheckedState = getStateManager(table)?.headerCheckedState;
+		forEachRecordPath(records, (path) => setRowSeriesState(table, path.toString(), true));
+		if (headerCheckedState != null) headerCheckedState[field] = true;
+	}
+	syncCascadeSelectionRanges(table);
+	refreshRowSeriesCells(table);
+};
+const toggleSeriesRow = (table, row, shiftKey) => {
+	if (Boolean(getInternalProps(table)?.enableCheckboxCascade)) {
+		setRowCheckboxState(table, row, getRowCheckboxState(table, row) === true ? false : true);
+		return;
+	}
+	toggleRowSelection(table, row, Boolean(shiftKey));
+};
+/**
+* 全选数据行，级联开着时走复选框（那才是选中态的真身）。
+*
+* 键盘必须走这里而不是自己拼区间：级联模式下 `clearSelected` / `selectCells` 只动
+* `select.ranges`，不动 `stateManager.checkedState` —— 而复选框的勾选态、底部「已选 N 行」
+* 计数、`selectionActions` 全都读 checkedState。只写 ranges 会得到「行高亮了但一个勾都没有、
+* 计数为 0」，而且下一次同步就把高亮抹掉。
+*
+* 返回是否真的选中了东西 —— 调用方要先拿它决定要不要 preventDefault，否则没有体行时也会
+* 吞掉浏览器的全选快捷键。
+*/
+const selectAllSeriesRows = (table) => {
+	if (isCascadeSelectionTable(table)) {
+		setAllCascadeRows(table, true);
+		return true;
+	}
+	const startRow = resolveSelectionStartRow(table);
+	const endRow = resolveSelectionEndRow(table);
+	if (endRow < startRow) return false;
+	selectAllRows(table, startRow, endRow, (table?.colCount ?? 1) - 1);
+	return true;
+};
+const toggleSeriesHeader = (table) => {
+	if (Boolean(getInternalProps(table)?.enableCheckboxCascade)) {
+		setAllCascadeRows(table, getCascadeHeaderState(table) === true ? false : true);
+		return;
+	}
+	const startRow = resolveSelectionStartRow(table);
+	const endRow = resolveSelectionEndRow(table);
+	if (endRow < startRow) return;
+	const endCol = (table?.colCount ?? 1) - 1;
+	if ((getStateManager(table)?.select?.ranges ?? []).some((range) => isFullRowRange(range, endCol) && Math.min(range.start.row, range.end.row) <= startRow && Math.max(range.start.row, range.end.row) >= endRow)) {
+		clearSelected(table);
+		return;
+	}
+	selectAllRows(table, startRow, endRow, endCol);
+};
+const forEachRecordPath = (records, visit, parentPath = []) => {
+	if (Array.isArray(records) === false) return;
+	records.forEach((item, index) => {
+		const record = item ?? {};
+		const path = [...parentPath, index];
+		visit(path, record);
+		if (Array.isArray(record.children)) forEachRecordPath(record.children, visit, path);
+	});
+};
+/** Visible rows whose VTable checkbox state is checked or indeterminate. */
+const getCascadeSelectedRowIndexes = (table) => {
+	const { endRow, startRow } = selectionScanRange(table);
+	const rows = [];
+	for (let row = startRow; row <= endRow; row += 1) {
+		if (isGroupTitleRow(table, row)) continue;
+		const state = getRowCheckboxState(table, row);
+		if (state === true || state === "indeterminate") rows.push(row);
+	}
+	return rows;
+};
+/**
+* 勾选了多少**行**：每条状态为 `true` 的记录算一行，含被折叠隐藏的那些。
+*
+* 树里的父行也算 —— 它有行号、能勾，级联全选时状态就是 `true`；只数叶子会把它漏掉
+* （实测四张表全选后全都少报，见函数内注释）。
+*/
+const getCascadeSelectedCount = (table) => {
+	if (hasRecordTree(table) === false) {
+		const { checked, unchecked } = countRowSeriesStates(table);
+		if (isSelectAllActive(table)) return Math.max(0, sourceRowTotal(table) - unchecked);
+		return checked;
+	}
+	let count = 0;
+	const field = resolveRowSeriesField(table);
+	forEachRecordPath(getRecords(table), (path, record) => {
+		if (isGroupTitleRecord(record)) return;
+		if (getStateManager(table)?.checkedState?.get(path.toString())?.[field] === true) count += 1;
+	});
+	return count;
+};
+const clearCascadeSelection = (table) => {
+	const sourceSelection = hasRecordTree(table) === false;
+	setSelectAllActive(table, false);
+	clearCheckboxState(table, resolveRowSeriesField(table));
+	if (sourceSelection) clearRowSeriesStates(table);
+	syncCascadeSelectionRanges(table);
+	refreshRowSeriesCells(table);
+};
+//#endregion
+export { clearCascadeSelection, getCascadeHeaderState, getCascadeSelectedCount, getCascadeSelectedRowIndexes, getRowCheckboxState, isCascadeSelectionTable, isGroupTitleRow, resolveRowSeriesIndex, resolveRowSeriesValue, resolveSelectionEndRow, resolveSelectionStartRow, selectAllSeriesRows, syncCascadeSelectionRanges, toggleSeriesHeader, toggleSeriesRow };
+
+//# sourceMappingURL=seriesSelection.mjs.map

package/es/Table/vtable/seriesSelection.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"seriesSelection.mjs","names":[],"sources":["../../../src/Table/vtable/seriesSelection.ts"],"sourcesContent":["import { TABLE_EVENT_TYPE } from '@visactor/vtable';\n\nimport { isGroupTitleRecord } from '../core/cellValue';\nimport {\n  createFullRowRange,\n  isFullRowRange,\n  selectAllRows,\n  type TableCellRange,\n  toggleRowSelection,\n} from '../core/rowSelection';\nimport {\n  clearCheckboxState,\n  clearSelected,\n  fireTableEvent,\n  getDataSource,\n  getIndexKey,\n  getInternalProps,\n  getLayoutMapRowSeriesField,\n  getRecordIndexByCell,\n  getRecords,\n  getRecordShowIndexByCell,\n  getScenegraph,\n  getStateManager,\n  getVisibleRowRange,\n  selectCells,\n  setCellCheckboxStateByRecordIndex,\n  updateCellContent,\n  updateCellContentRange,\n  updateNextFrame,\n} from './vtableAdapter';\n\nexport const isGroupTitleRow = (table: any, row: number): boolean =>\n  Boolean(\n    getInternalProps(table)?.groupBy && isGroupTitleRecord(table?.getCellOriginRecord?.(0, row)),\n  );\n\n/**\n * Last body row select-all should cover. Group title rows carry no data — the row series\n * skips them when numbering, the header checkbox route walks past them, and\n * `getCascadeSelectedRowIndexes` leaves them out — so select-all has to agree with all of\n * them. Returns a row below the header when every body row is a group.\n */\nexport const resolveSelectionEndRow = (table: any): number => {\n  const firstRow = table?.columnHeaderLevelCount ?? 1;\n  let row = (table?.rowCount ?? 1) - 1;\n\n  while (row >= firstRow && isGroupTitleRow(table, row)) row -= 1;\n\n  return row;\n};\n\n/**\n * First body row a select-all range may start on. Group title rows carry no data — the row\n * series skips them when numbering and the header checkbox leaves them out — so select-all\n * has to agree with both. Returns a row past the last body row when every one is a group.\n */\nexport const resolveSelectionStartRow = (table: any): number => {\n  const firstRow = table?.columnHeaderLevelCount ?? 1;\n  const lastRow = (table?.rowCount ?? 1) - 1;\n  let row = firstRow;\n\n  while (row <= lastRow && isGroupTitleRow(table, row)) row += 1;\n\n  return row;\n};\n\n/** 超过这个行数就不建索引：一份 rowCount 长的数组本身就是内存开销。 */\nconst ROW_INDEX_CACHE_LIMIT = 100_000;\n\n/**\n * 分组表的行号索引缓存。\n *\n * `resolveRowSeriesIndex` 每画一个可见行都要从第一个体行数到它自己，每个 cursor 一次\n * `isGroupTitleRow`（内含 `getCellOriginRecord`）。两万行的分组表滚到中部时，单个可见行就是\n * 两万次记录查询，而一屏几十行、每帧都要重画 —— **序号列自己成了滚动卡顿源**（它只画一个数字）。\n *\n * 索引只跟「表头层数 + 总行数」有关（折叠 / 展开会改变行数），按它们失效，重建一次 O(行数)。\n */\nconst rowIndexCaches = new WeakMap<\n  object,\n  { counts: number[]; firstRow: number; rowCount: number }\n>();\n\nconst resolveGroupedRowIndex = (table: any, row: number, firstRow: number): number => {\n  const rowCount = table?.rowCount ?? 0;\n\n  if (rowCount > ROW_INDEX_CACHE_LIMIT || rowCount <= firstRow) {\n    let index = 0;\n    for (let cursor = firstRow; cursor <= row; cursor += 1) {\n      if (isGroupTitleRow(table, cursor) === false) index += 1;\n    }\n    return index;\n  }\n\n  let cache = rowIndexCaches.get(table);\n  if (cache == null || cache.rowCount !== rowCount || cache.firstRow !== firstRow) {\n    const counts: number[] = [];\n    let index = 0;\n    for (let cursor = firstRow; cursor < rowCount; cursor += 1) {\n      if (isGroupTitleRow(table, cursor) === false) index += 1;\n      counts[cursor] = index;\n    }\n    cache = { counts, firstRow, rowCount };\n    rowIndexCaches.set(table, cache);\n  }\n\n  return cache.counts[row] ?? 0;\n};\n\n/** Row number that skips group title rows, so only data records are counted. */\nexport const resolveRowSeriesIndex = (table: any, row: number): number => {\n  const firstRow = table?.columnHeaderLevelCount ?? 1;\n  if (row < firstRow) return 0;\n\n  if (getInternalProps(table)?.groupBy == null) return row - firstRow + 1;\n\n  return resolveGroupedRowIndex(table, row, firstRow);\n};\n\n/** Display value for a row series cell: group rows show no number. */\nexport const resolveRowSeriesValue = (table: any, row: number): string | number =>\n  isGroupTitleRow(table, row) ? '' : resolveRowSeriesIndex(table, row);\n\n/**\n * VTable 在 `rowSeriesNumber.field` 缺省时用的字段名。**只在读不到解析结果时兜底** ——\n * 它是引擎的默认值，不是我们的契约；使用方覆盖 `field` 后就该以 `layoutMap` 里的为准。\n */\nconst FALLBACK_ROW_SERIES_CHECKBOX_FIELD = '_vtable_rowSeries_number';\n\n/**\n * 行号列复选框状态存在哪个键下。复选框的勾选态、底部「已选 N 行」计数、`selectionActions`\n * 和级联同步全都按这个键读写 `stateManager.checkedState`；读错键就**所有复选框恒为未选中、\n * 点选也不动**，而且不报任何错。\n *\n * 取值必须问 table 自己（见 `getLayoutMapRowSeriesField`）：写死默认名会在使用方给\n * `rowSeriesNumber` 传了自定义 `field` 时静默失效。\n */\nconst resolveRowSeriesField = (table: any): string =>\n  getLayoutMapRowSeriesField(table) ?? FALLBACK_ROW_SERIES_CHECKBOX_FIELD;\n\n/**\n * 这张表有没有可以直接遍历的 `records`。\n *\n * **不能假设 `table.records` 就是数据。** 使用方传 `dataSource`（VTable 的懒加载形态，\n * 百万行 demo 就是）时，引擎在 `_setDataSource` 里把 `internalProps.records` 置空，react\n * 包装层再补一个 `[]`，取行只剩 `dataSource.get(i)` 一条路。此时所有按 records 遍历的\n * 代码全部**静默**走空：勾选确实写进了 `checkedState`，但「已选 N 行」恒为 0（浮动条根本\n * 不渲染）、表头全选一行都选不中 —— 和另外几张传 `records` 的表行为对不上。\n */\nconst hasRecordTree = (table: any): boolean =>\n  Array.isArray(table?.records) && table.records.length > 0;\n\n/** 可被选中的数据行数。数据源表上分组标题行不存在（分组表一律按 records 走）。 */\nconst sourceRowTotal = (table: any): number =>\n  Math.max(0, (table?.rowCount ?? 0) - (table?.columnHeaderLevelCount ?? 0));\n\ninterface SelectAllState {\n  /** 数据源换掉就作废 —— `_setDataSource` 每次都会新建一个实例。 */\n  source: unknown;\n}\n\n/**\n * 数据源表的全选标记。\n *\n * **不能靠往 `checkedState` 里灌满所有行来全选**：百万行实测要 1 秒、66MB 堆，而懒加载\n * 数据源存在的意义正是不碰全部行。一个标记就够表达\"整表选中\"，`checkedState` 里留下的\n * 条目反过来变成**例外**（被单独取消的行），内存是 O(例外数)。数据源一换标记自动失效，\n * 不会把新数据整片画成已选。\n */\nconst selectAllStates = new WeakMap<object, SelectAllState>();\n\nconst isSelectAllActive = (table: any): boolean => {\n  if (table == null) return false;\n\n  const state = selectAllStates.get(table);\n\n  return state != null && state.source === getDataSource(table);\n};\n\nconst setSelectAllActive = (table: any, active: boolean): void => {\n  if (table == null) return;\n\n  if (active) selectAllStates.set(table, { source: getDataSource(table) });\n  else selectAllStates.delete(table);\n};\n\n/**\n * 遍历这一列在 `checkedState` 里的所有取值。级联模式下这张表是**稀疏**的 —— 只有被点过\n * 的行才有条目，所以规模是「点过的行数」而不是表行数。\n */\nconst forEachRowSeriesState = (table: any, visit: (value: unknown) => void): void => {\n  const field = resolveRowSeriesField(table);\n\n  getStateManager(table)?.checkedState?.forEach((entry: Record<string, unknown> | undefined) => {\n    if (entry != null) visit(entry[field]);\n  });\n};\n\nconst countRowSeriesStates = (table: any): { checked: number; unchecked: number } => {\n  let checked = 0;\n  let unchecked = 0;\n\n  forEachRowSeriesState(table, (value) => {\n    if (value === true) checked += 1;\n    else if (value === false) unchecked += 1;\n  });\n\n  return { checked, unchecked };\n};\n\n/**\n * 直接写一条记录的勾选态。**只在批量化路径上用**（避开引擎逐行接口里的全树遍历，见\n * `setAllCascadeRows`）；单行勾选仍走 `setCellCheckboxStateByRecordIndex`，那条路要引擎\n * 顺手做级联与重绘。\n */\nconst setRowSeriesState = (table: any, key: string, value: boolean): void => {\n  const checkedState = getStateManager(table)?.checkedState;\n  if (checkedState == null) return;\n\n  const field = resolveRowSeriesField(table);\n  const entry = checkedState.get(key) ?? {};\n\n  entry[field] = value;\n  checkedState.set(key, entry);\n};\n\n/** 只清本组件这一列：`checkedState` 里还可能存着使用方自己 checkbox 列的状态。 */\nconst clearRowSeriesStates = (table: any): void => {\n  const field = resolveRowSeriesField(table);\n\n  getStateManager(table)?.checkedState?.forEach((entry: Record<string, unknown> | undefined) => {\n    if (entry != null) delete entry[field];\n  });\n};\n\n/**\n * 重画序号列（表头 + 可见体行）。\n *\n * 这一列被自定义 layout 接管后，VTable 不会自己发现 `checkedState` 变了 —— records 那条路\n * 是靠 `setCellCheckboxStateByRecordIndex` 内部的 `table.render()` 顺带重画的，走标记的\n * 这条路没有那个调用，不自己标脏就要等下一次整表渲染才看得见勾。\n */\nconst refreshRowSeriesCells = (table: any): void => {\n  if (getScenegraph(table) == null) return;\n\n  updateCellContent(table, 0, 0);\n  const { endRow, startRow } = getVisibleRowRange(table);\n  if (endRow >= startRow) updateCellContentRange(table, 0, startRow, 0, endRow);\n  updateNextFrame(table);\n};\n\n/**\n * 需要遍历的**可见**行范围。\n *\n * **不能扫全表。** 这两条路径每次勾选都会跑一遍，百万行的表上就是 100 万次\n * `getRecordIndexByCell` + Map 查询 —— 页面直接卡住，观感是「**复选框点不动**」。\n * 而 `select.ranges` 只影响**可见行**的画布高亮（VTable 渲染时本来也会裁到视口），\n * 所以扫可见窗口就够。\n *\n * 拿得到 `scenegraph.proxy` 时用它给的真实可视区；拿不到（未渲染 / 单测桩）就退到一个\n * 有上界的窗口，绝不能退回 `rowCount - 1`。\n */\nconst ROW_SCAN_LIMIT = 500;\n\nconst selectionScanRange = (table: any): { endRow: number; startRow: number } => {\n  const firstRow = table?.columnHeaderLevelCount ?? 1;\n  const lastRow = (table?.rowCount ?? 1) - 1;\n  const proxy = getScenegraph(table)?.proxy;\n  const startRow = Math.max(firstRow, proxy?.rowStart ?? firstRow);\n  const endRow = Math.min(lastRow, proxy?.rowEnd ?? startRow + ROW_SCAN_LIMIT);\n\n  return { endRow, startRow };\n};\n\nexport const isCascadeSelectionTable = (table: any): boolean =>\n  Boolean(getInternalProps(table)?.enableCheckboxCascade);\n\nconst getRowRecordKey = (table: any, row: number): string | undefined => {\n  const path =\n    getRecordIndexByCell(table, 0, row) ??\n    getIndexKey(table, getRecordShowIndexByCell(table, 0, row));\n  if (path == null) return undefined;\n  return Array.isArray(path) ? path.toString() : String(path);\n};\n\nexport const getRowCheckboxState = (table: any, row: number): unknown => {\n  const key = getRowRecordKey(table, row);\n  if (key == null) return undefined;\n\n  const state = getStateManager(table)?.checkedState?.get(key)?.[resolveRowSeriesField(table)];\n  // 全选态下没有条目的行默认选中；条目里留下的就是**例外**（被单独取消的行）。\n  if (state === undefined && isSelectAllActive(table)) return true;\n\n  return state;\n};\n\n/** Toggle through VTable's record-index checkbox cascade. */\nconst setRowCheckboxState = (table: any, row: number, checked: boolean): void => {\n  const path = getRecordIndexByCell(table, 0, row);\n  if (path == null) return;\n\n  setCellCheckboxStateByRecordIndex(table, path, resolveRowSeriesField(table), checked);\n  syncCascadeSelectionRanges(table);\n  // 勾一行会连带改**表头**的勾选/半选态，而表头那格同样不会自己重建（键盘勾行没有画布点击\n  // 兜底）。只重画可见的序号列，代价是 O(可视行数)。\n  refreshRowSeriesCells(table);\n  fireTableEvent(table, TABLE_EVENT_TYPE.SELECTED_CHANGED, {\n    ranges: getStateManager(table)?.select?.ranges ?? [],\n  });\n};\n\n/** Keep VTable selection ranges in sync with checkbox state for row highlight. */\nexport const syncCascadeSelectionRanges = (table: any): void => {\n  // 非级联模式的选中态在 `select.ranges` 里，`checkedState` 全是 `undefined` —— 照这里反推会\n  // 得到空区间，然后 `clearSelected`。而它在 `TREE_HIERARCHY_STATE_CHANGE`（折叠/展开）时照样\n  // 被调用（见 useTableVTableEvents），于是**折叠一次分组就把整片选区清空**。\n  if (isCascadeSelectionTable(table) === false) return;\n\n  const { endRow, startRow } = selectionScanRange(table);\n  const endCol = (table?.colCount ?? 1) - 1;\n  const ranges: Array<ReturnType<typeof createFullRowRange>> = [];\n  let rangeStart = -1;\n  // Tracked rather than derived from the next row: the walk skips group title rows, so\n  // \"the row before the first unchecked one\" can land on a skipped group title and end the\n  // range on a row that has no checkbox to justify it.\n  let rangeEnd = -1;\n\n  for (let row = startRow; row <= endRow; row += 1) {\n    if (isGroupTitleRow(table, row)) continue;\n\n    const state = getRowCheckboxState(table, row);\n    const selected = state === true || state === 'indeterminate';\n\n    if (selected) {\n      if (rangeStart < 0) rangeStart = row;\n      rangeEnd = row;\n      continue;\n    }\n\n    if (rangeStart >= 0) {\n      ranges.push(createFullRowRange(rangeStart, rangeEnd, endCol));\n      rangeStart = -1;\n      rangeEnd = -1;\n    }\n  }\n\n  if (rangeStart >= 0) ranges.push(createFullRowRange(rangeStart, rangeEnd, endCol));\n\n  if (ranges.length === 0) clearSelected(table);\n  else selectCells(table, ranges);\n};\n\nexport const getCascadeHeaderState = (table: any): unknown => {\n  if (hasRecordTree(table) === false) {\n    const { checked, unchecked } = countRowSeriesStates(table);\n    if (isSelectAllActive(table)) return unchecked > 0 ? 'indeterminate' : true;\n    if (checked === 0) return false;\n\n    return checked >= sourceRowTotal(table) ? true : 'indeterminate';\n  }\n\n  return getStateManager(table)?.headerCheckedState?.[resolveRowSeriesField(table)];\n};\n\nconst setAllCascadeRows = (table: any, checked: boolean): void => {\n  if (hasRecordTree(table) === false) {\n    setSelectAllActive(table, checked);\n    clearRowSeriesStates(table);\n    syncCascadeSelectionRanges(table);\n    refreshRowSeriesCells(table);\n    return;\n  }\n\n  if (checked === false) {\n    clearCascadeSelection(table);\n    clearSelected(table);\n    return;\n  }\n\n  // **不能逐行调 `setCellCheckboxStateByRecordIndex`。** 那个接口末尾无条件跑一次\n  // `updateHeaderCheckboxStateByField`，而它要 `traverseRecords(table.records)` 走完整棵树\n  // —— 逐行调用就是 O(N²)：实测 500 行 54ms、2000 行 147ms、5000 行 566ms（一次全选卡半秒）。\n  // 这里直接写 `checkedState`（键的形状与引擎的 `getIndexKey(...).toString()` 一致，读写两侧\n  // 本来就共用它），再自己收尾更新一次表头状态。\n  const records = getRecords(table);\n  if (Array.isArray(records)) {\n    const field = resolveRowSeriesField(table);\n    const headerCheckedState = getStateManager(table)?.headerCheckedState;\n\n    forEachRecordPath(records, (path) => setRowSeriesState(table, path.toString(), true));\n    if (headerCheckedState != null) headerCheckedState[field] = true;\n  }\n\n  syncCascadeSelectionRanges(table);\n  refreshRowSeriesCells(table);\n};\n\nexport const toggleSeriesRow = (table: any, row: number, shiftKey?: boolean): void => {\n  const cascadeSelection = Boolean(getInternalProps(table)?.enableCheckboxCascade);\n\n  if (cascadeSelection) {\n    setRowCheckboxState(table, row, getRowCheckboxState(table, row) === true ? false : true);\n    return;\n  }\n\n  toggleRowSelection(table, row, Boolean(shiftKey));\n};\n\n/**\n * 全选数据行，级联开着时走复选框（那才是选中态的真身）。\n *\n * 键盘必须走这里而不是自己拼区间：级联模式下 `clearSelected` / `selectCells` 只动\n * `select.ranges`，不动 `stateManager.checkedState` —— 而复选框的勾选态、底部「已选 N 行」\n * 计数、`selectionActions` 全都读 checkedState。只写 ranges 会得到「行高亮了但一个勾都没有、\n * 计数为 0」，而且下一次同步就把高亮抹掉。\n *\n * 返回是否真的选中了东西 —— 调用方要先拿它决定要不要 preventDefault，否则没有体行时也会\n * 吞掉浏览器的全选快捷键。\n */\nexport const selectAllSeriesRows = (table: any): boolean => {\n  if (isCascadeSelectionTable(table)) {\n    setAllCascadeRows(table, true);\n    return true;\n  }\n\n  const startRow = resolveSelectionStartRow(table);\n  const endRow = resolveSelectionEndRow(table);\n  if (endRow < startRow) return false;\n\n  selectAllRows(table, startRow, endRow, (table?.colCount ?? 1) - 1);\n  return true;\n};\n\nexport const toggleSeriesHeader = (table: any): void => {\n  const cascadeSelection = Boolean(getInternalProps(table)?.enableCheckboxCascade);\n\n  if (cascadeSelection) {\n    setAllCascadeRows(table, getCascadeHeaderState(table) === true ? false : true);\n    return;\n  }\n\n  // 非级联模式的区间必须与 Ctrl+A **完全一致**（`resolveSelectionStartRow/EndRow` 的整表），\n  // 原先这里用的是可视窗口（`selectionScanRange`，代理窗口约 200 行）：1000 行的表点表头只\n  // 选中前约 200 行，而表头照样显示「已全选」。ARCHITECTURE §「选区一端要为『全选』定边界」\n  // 要的就是两条路径同一区间。\n  const startRow = resolveSelectionStartRow(table);\n  const endRow = resolveSelectionEndRow(table);\n  // 一个体行都没有：**别下发反序区间** —— `createFullRowRange` 会 min/max 归一成 [表头行, 下一行]，\n  // 空表点一下表头反而高亮表头。`selectAllSeriesRows` 早就有这条守卫。\n  if (endRow < startRow) return;\n\n  const endCol = (table?.colCount ?? 1) - 1;\n  const ranges = getStateManager(table)?.select?.ranges ?? [];\n  // 是否「已全选」：只要有一个整行区间盖住 [startRow, endRow] 即可 —— 逐行 `isFullRowSelected`\n  // 是大表上的 O(行数) 扫描，而表头点击只需要这个布尔值。\n  const checked = ranges.some(\n    (range: TableCellRange) =>\n      isFullRowRange(range, endCol) &&\n      Math.min(range.start.row, range.end.row) <= startRow &&\n      Math.max(range.start.row, range.end.row) >= endRow,\n  );\n\n  if (checked) {\n    clearSelected(table);\n    return;\n  }\n\n  selectAllRows(table, startRow, endRow, endCol);\n};\n\nconst forEachRecordPath = (\n  records: unknown,\n  visit: (path: number[], record: { children?: unknown[] }) => void,\n  parentPath: number[] = [],\n): void => {\n  if (Array.isArray(records) === false) return;\n\n  records.forEach((item, index) => {\n    const record = (item ?? {}) as { children?: unknown[] };\n    const path = [...parentPath, index];\n    visit(path, record);\n\n    if (Array.isArray(record.children)) forEachRecordPath(record.children, visit, path);\n  });\n};\n\n/** Visible rows whose VTable checkbox state is checked or indeterminate. */\nexport const getCascadeSelectedRowIndexes = (table: any): number[] => {\n  // 返回的本来就是**可见**行，所以只扫可见窗口 —— 见 selectionScanRange。\n  const { endRow, startRow } = selectionScanRange(table);\n  const rows: number[] = [];\n\n  for (let row = startRow; row <= endRow; row += 1) {\n    if (isGroupTitleRow(table, row)) continue;\n\n    const state = getRowCheckboxState(table, row);\n    if (state === true || state === 'indeterminate') rows.push(row);\n  }\n\n  return rows;\n};\n\n/**\n * 勾选了多少**行**：每条状态为 `true` 的记录算一行，含被折叠隐藏的那些。\n *\n * 树里的父行也算 —— 它有行号、能勾，级联全选时状态就是 `true`；只数叶子会把它漏掉\n * （实测四张表全选后全都少报，见函数内注释）。\n */\nexport const getCascadeSelectedCount = (table: any): number => {\n  if (hasRecordTree(table) === false) {\n    const { checked, unchecked } = countRowSeriesStates(table);\n    if (isSelectAllActive(table)) return Math.max(0, sourceRowTotal(table) - unchecked);\n\n    return checked;\n  }\n\n  let count = 0;\n  const field = resolveRowSeriesField(table);\n\n  // **每条状态为 true 的**数据**记录算一行**，两条边界：\n  //\n  // - 树里的**父行要算** —— 它有行号、能勾，级联全选时状态就是 true（半选才是\n  //   'indeterminate'）。只数叶子会漏掉它：实测树形表格 62 行全选后只写 41。\n  // - `groupBy` 合成的**分组标题行不算** —— 它在记录树里也是父节点（`vtableMerge`），\n  //   全选时同样打勾，但「已选 N 行」数的是数据行：Tree 分组 30 行里 3 个是分组行，\n  //   全选后条上该写 27。\n  //\n  // 折叠不影响这个口径：子孙的状态没变，照样计入。\n  forEachRecordPath(getRecords(table), (path, record) => {\n    if (isGroupTitleRecord(record)) return;\n\n    const state = getStateManager(table)?.checkedState?.get(path.toString())?.[field];\n    if (state === true) count += 1;\n  });\n\n  return count;\n};\n\nexport const clearCascadeSelection = (table: any): void => {\n  const sourceSelection = hasRecordTree(table) === false;\n\n  setSelectAllActive(table, false);\n  clearCheckboxState(table, resolveRowSeriesField(table));\n  // VTable 的 clearCheckboxState 是按 `table.records` 遍历的，数据源表上它自己什么也清不掉\n  // —— 条目都还在 checkedState 里，只清画面不清状态，下一次同步就把勾选态画回来。\n  if (sourceSelection) clearRowSeriesStates(table);\n  syncCascadeSelectionRanges(table);\n  // **两条路都要重绘。** VTable 的 `clearCheckboxState` 里那次 render 不重建序号列的自定义\n  // layout，records 表上一样会留下满屏的勾：实测 Basic demo 点「取消选择」后浮动条消失了、\n  // 表头与整列的勾还在，看上去就是「从工具栏取消不生效」。\n  refreshRowSeriesCells(table);\n};\n"],"mappings":"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"}

package/es/Table/vtable/vtableAdapter.mjs

@@ -0,0 +1,96 @@
+"use client";
+//#region src/Table/vtable/vtableAdapter.ts
+const getScenegraph = (table) => table.scenegraph;
+/**
+* VTable 的 `release()` 会把 `scenegraph` 与 `internalProps` 一起置 null，之后再读任何
+* getter（`columnHeaderLevelCount`、`getCellValue` …）都会抛 TypeError。表实例被 react-vtable
+* 拆掉之后 `tableRef` 仍然指着它，所以持有实例的渲染路径必须先问这一句。
+*/
+const isTableReleased = (table) => table == null || getScenegraph(table) == null;
+const getScenegraphComponent = (table) => table.scenegraph.component;
+const updateNextFrame = (table) => {
+	getScenegraph(table).updateNextFrame?.();
+};
+const updateCellContent = (table, col, row) => {
+	getScenegraph(table).updateCellContent?.(col, row);
+};
+const updateCellContentRange = (table, startCol, startRow, endCol, endRow) => {
+	table.updateCellContentRange?.(startCol, startRow, endCol, endRow);
+};
+const getVisibleRowRange = (table, maxRows = 80) => {
+	const scenegraph = getScenegraph(table);
+	const headerRows = table.columnHeaderLevelCount ?? 1;
+	const startRow = Math.max(headerRows, scenegraph.proxy?.rowStart ?? headerRows);
+	return {
+		endRow: Math.min(scenegraph.proxy?.rowEnd ?? startRow + maxRows, startRow + maxRows, (table.rowCount ?? 1) - 1),
+		startRow
+	};
+};
+const getLayoutMapHierarchyIndent = (table) => table?.internalProps?.layoutMap?.hierarchyIndent;
+/**
+* 行号列复选框状态存在哪个字段下。**不要写死** —— VTable 把字段名解析成
+* `rowSeriesNumber.field ?? '_vtable_rowSeries_number'`（`layout/simple-header-layout.js`
+* 的 `handleRowSeriesNumber`），解析结果就在这里。使用方覆盖了 `field` 时，只有读这里才对。
+*/
+const getLayoutMapRowSeriesField = (table) => {
+	const field = table?.internalProps?.layoutMap?.rowSeriesNumberColumn?.[0]?.field;
+	return typeof field === "string" && field !== "" ? field : void 0;
+};
+/**
+* 吸顶插件挂在 `scenegraph.plugins` 里，字段名取自 VTable 1.26.x 的
+* `plugins/list-tree-stick-cell.js`（`showedTitleRows` / `titleRows`）。这是**没有类型声明**
+* 的私有结构，全部走可选链：升版后失效会静默退回 VTable 写死的 40px 行高偏移，而不是报错。
+*/
+const getStickyTitleRows = (table) => {
+	const plugin = table?.listTreeStickCellPlugin;
+	return plugin?.showedTitleRows ?? plugin?.titleRows;
+};
+const getStickyShadowRoots = (table) => {
+	const scenegraph = table?.scenegraph;
+	return [scenegraph?.colHeaderGroup?.border?.shadowRoot, scenegraph?.cornerHeaderGroup?.border?.shadowRoot].filter(Boolean);
+};
+const getRowHeight = (table, row) => table?.getRowHeight?.(row);
+/**
+* 引擎当前实际排布出来的总行高（含表头行，不含底部那 8px 的槽）。
+*
+* 折叠 / 展开之后**只有引擎知道现在有多少行**：树节点的 `hierarchyState` 引擎会写回记录，但
+* 分组标题行（`groupBy` 生成的那些）的折叠状态只存在引擎的分组结构里，`records` 上根本没有
+* —— 所以容器高度不能在那之后按数据重算，只能问引擎。
+*/
+const getAllRowsHeight = (table) => {
+	const height = table?.getAllRowsHeight?.();
+	return typeof height === "number" && Number.isFinite(height) && height > 0 ? height : void 0;
+};
+const getInternalProps = (table) => table?.internalProps;
+/**
+* VTable 把当前编辑态挂在 `editorManager` 上（d.ts 里是 `ListTableProtected`）。
+* 这些字段在 1.26.x 上核对过；升版后若 `release()` 与 `doExit()` 的语义变化，这里的
+* 读取会静默返回 undefined，表现为「编辑浮层不跟随」。
+*/
+const getEditingEditor = (table) => table?.editorManager?.editingEditor;
+const getEditCell = (table) => table?.editorManager?.editCell;
+const getStateManager = (table) => table?.stateManager;
+const getDataSource = (table) => table?.dataSource;
+const getRecords = (table) => table?.records;
+const getRecordIndexByCell = (table, col, row) => table?.getRecordIndexByCell?.(col, row);
+const getRecordShowIndexByCell = (table, col, row) => table?.getRecordShowIndexByCell?.(col, row);
+const getIndexKey = (table, showIndex) => showIndex == null ? void 0 : getDataSource(table)?.getIndexKey?.(showIndex);
+const setCellCheckboxStateByRecordIndex = (table, path, field, checked) => {
+	table?.setCellCheckboxStateByRecordIndex?.(path, field, checked);
+};
+const fireTableEvent = (table, event, payload) => {
+	table?.fireListeners?.(event, payload);
+};
+const clearCheckboxState = (table, field) => {
+	table?.clearCheckboxState?.(field);
+};
+const clearSelected = (table) => {
+	table?.clearSelected?.();
+};
+const selectCells = (table, ranges) => {
+	table?.selectCells?.(ranges);
+};
+//#endregion
+export { clearCheckboxState, clearSelected, fireTableEvent, getAllRowsHeight, getDataSource, getEditCell, getEditingEditor, getIndexKey, getInternalProps, getLayoutMapHierarchyIndent, getLayoutMapRowSeriesField, getRecordIndexByCell, getRecordShowIndexByCell, getRecords, getRowHeight, getScenegraph, getScenegraphComponent, getStateManager, getStickyShadowRoots, getStickyTitleRows, getVisibleRowRange, isTableReleased, selectCells, setCellCheckboxStateByRecordIndex, updateCellContent, updateCellContentRange, updateNextFrame };
+
+//# sourceMappingURL=vtableAdapter.mjs.map

package/es/Table/vtable/vtableAdapter.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"vtableAdapter.mjs","names":[],"sources":["../../../src/Table/vtable/vtableAdapter.ts"],"sourcesContent":["'use client';\n\nimport type { ListTable as ListTableInstance } from '@visactor/vtable';\n\nexport interface PrivateScenegraph {\n  proxy?: { rowEnd?: number; rowStart?: number };\n  updateCellContent?: (col: number, row: number) => void;\n  updateNextFrame?: () => void;\n}\n\nexport const getScenegraph = (table: ListTableInstance): PrivateScenegraph =>\n  table.scenegraph as unknown as PrivateScenegraph;\n\n/**\n * VTable 的 `release()` 会把 `scenegraph` 与 `internalProps` 一起置 null，之后再读任何\n * getter（`columnHeaderLevelCount`、`getCellValue` …）都会抛 TypeError。表实例被 react-vtable\n * 拆掉之后 `tableRef` 仍然指着它，所以持有实例的渲染路径必须先问这一句。\n */\nexport const isTableReleased = (table: unknown): boolean =>\n  table == null || getScenegraph(table as ListTableInstance) == null;\n\nexport interface PrivateScenegraphComponent {\n  frozenShadowLine?: { setAttribute: (key: string, value: boolean) => void };\n  hideFrozenColumnShadow?: () => void;\n  showFrozenColumnShadow?: () => void;\n}\n\nexport const getScenegraphComponent = (\n  table: ListTableInstance,\n): PrivateScenegraphComponent | undefined =>\n  (table.scenegraph as unknown as { component?: PrivateScenegraphComponent }).component;\n\nexport const updateNextFrame = (table: ListTableInstance): void => {\n  getScenegraph(table).updateNextFrame?.();\n};\n\nexport const updateCellContent = (table: ListTableInstance, col: number, row: number): void => {\n  getScenegraph(table).updateCellContent?.(col, row);\n};\n\nexport const updateCellContentRange = (\n  table: ListTableInstance,\n  startCol: number,\n  startRow: number,\n  endCol: number,\n  endRow: number,\n): void => {\n  (\n    table as ListTableInstance & {\n      updateCellContentRange?: (\n        colStart: number,\n        rowStart: number,\n        colEnd: number,\n        rowEnd: number,\n      ) => void;\n    }\n  ).updateCellContentRange?.(startCol, startRow, endCol, endRow);\n};\n\nexport const getVisibleRowRange = (\n  table: ListTableInstance,\n  maxRows = 80,\n): { endRow: number; startRow: number } => {\n  const scenegraph = getScenegraph(table);\n  const headerRows = table.columnHeaderLevelCount ?? 1;\n  const startRow = Math.max(headerRows, scenegraph.proxy?.rowStart ?? headerRows);\n  const endRow = Math.min(\n    scenegraph.proxy?.rowEnd ?? startRow + maxRows,\n    startRow + maxRows,\n    (table.rowCount ?? 1) - 1,\n  );\n\n  return { endRow, startRow };\n};\n\nexport interface PrivateLayoutMap {\n  hierarchyIndent?: number;\n  rowSeriesNumberColumn?: ReadonlyArray<{ field?: unknown }>;\n}\n\nexport const getLayoutMapHierarchyIndent = (table: unknown): number | undefined =>\n  (table as { internalProps?: { layoutMap?: PrivateLayoutMap } } | undefined)?.internalProps\n    ?.layoutMap?.hierarchyIndent;\n\n/**\n * 行号列复选框状态存在哪个字段下。**不要写死** —— VTable 把字段名解析成\n * `rowSeriesNumber.field ?? '_vtable_rowSeries_number'`（`layout/simple-header-layout.js`\n * 的 `handleRowSeriesNumber`），解析结果就在这里。使用方覆盖了 `field` 时，只有读这里才对。\n */\nexport const getLayoutMapRowSeriesField = (table: unknown): string | undefined => {\n  const field = (table as { internalProps?: { layoutMap?: PrivateLayoutMap } } | undefined)\n    ?.internalProps?.layoutMap?.rowSeriesNumberColumn?.[0]?.field;\n  return typeof field === 'string' && field !== '' ? field : undefined;\n};\n\nexport interface PrivateStickyPlugin {\n  showedTitleRows?: readonly number[];\n  titleRows?: readonly number[];\n}\n\nexport interface PrivateStickyShadowRoot {\n  children?: unknown[];\n  forEachChildren?: (callback: (child: unknown) => unknown) => void;\n}\n\nexport interface PrivateStickyScenegraph {\n  colHeaderGroup?: { border?: { shadowRoot?: PrivateStickyShadowRoot } };\n  cornerHeaderGroup?: { border?: { shadowRoot?: PrivateStickyShadowRoot } };\n}\n\n/**\n * 吸顶插件挂在 `scenegraph.plugins` 里，字段名取自 VTable 1.26.x 的\n * `plugins/list-tree-stick-cell.js`（`showedTitleRows` / `titleRows`）。这是**没有类型声明**\n * 的私有结构，全部走可选链：升版后失效会静默退回 VTable 写死的 40px 行高偏移，而不是报错。\n */\nexport const getStickyTitleRows = (table: unknown): readonly number[] | undefined => {\n  const plugin = (table as { listTreeStickCellPlugin?: PrivateStickyPlugin } | undefined)\n    ?.listTreeStickCellPlugin;\n  return plugin?.showedTitleRows ?? plugin?.titleRows;\n};\n\nexport const getStickyShadowRoots = (table: unknown): PrivateStickyShadowRoot[] => {\n  const scenegraph = (table as { scenegraph?: PrivateStickyScenegraph } | undefined)?.scenegraph;\n  const roots = [\n    scenegraph?.colHeaderGroup?.border?.shadowRoot,\n    scenegraph?.cornerHeaderGroup?.border?.shadowRoot,\n  ];\n  return roots.filter(Boolean) as PrivateStickyShadowRoot[];\n};\n\nexport const getRowHeight = (table: unknown, row: number): number | undefined =>\n  (table as { getRowHeight?: (index: number) => number | undefined } | undefined)?.getRowHeight?.(\n    row,\n  );\n\n/**\n * 引擎当前实际排布出来的总行高（含表头行，不含底部那 8px 的槽）。\n *\n * 折叠 / 展开之后**只有引擎知道现在有多少行**：树节点的 `hierarchyState` 引擎会写回记录，但\n * 分组标题行（`groupBy` 生成的那些）的折叠状态只存在引擎的分组结构里，`records` 上根本没有\n * —— 所以容器高度不能在那之后按数据重算，只能问引擎。\n */\nexport const getAllRowsHeight = (table: unknown): number | undefined => {\n  const height = (\n    table as { getAllRowsHeight?: () => number | undefined } | undefined\n  )?.getAllRowsHeight?.();\n\n  return typeof height === 'number' && Number.isFinite(height) && height > 0 ? height : undefined;\n};\n\nexport interface PrivateTableInternalProps {\n  bodyHelper?: {\n    getHierarchyIcon?: (col: number, row: number) => unknown;\n    getHierarchyIconWidth?: () => number;\n  };\n  enableCheckboxCascade?: boolean;\n  groupBy?: string | string[];\n  layoutMap?: PrivateLayoutMap;\n}\n\nexport const getInternalProps = (table: unknown): PrivateTableInternalProps | undefined =>\n  (table as { internalProps?: PrivateTableInternalProps } | undefined)?.internalProps;\n\n/**\n * VTable 把当前编辑态挂在 `editorManager` 上（d.ts 里是 `ListTableProtected`）。\n * 这些字段在 1.26.x 上核对过；升版后若 `release()` 与 `doExit()` 的语义变化，这里的\n * 读取会静默返回 undefined，表现为「编辑浮层不跟随」。\n */\nexport const getEditingEditor = (table: unknown): any =>\n  (table as { editorManager?: { editingEditor?: unknown } } | undefined)?.editorManager\n    ?.editingEditor;\n\nexport const getEditCell = (table: unknown): { col: number; row: number } | undefined =>\n  (table as { editorManager?: { editCell?: { col: number; row: number } } } | undefined)\n    ?.editorManager?.editCell;\n\nexport const getStateManager = (table: unknown): any =>\n  (table as { stateManager?: any } | undefined)?.stateManager;\n\nexport const getDataSource = (table: unknown): any =>\n  (table as { dataSource?: any } | undefined)?.dataSource;\n\nexport const getRecords = (table: unknown): unknown[] | undefined =>\n  (table as { records?: unknown[] } | undefined)?.records;\n\nexport const getRecordIndexByCell = (table: unknown, col: number, row: number): unknown =>\n  (\n    table as { getRecordIndexByCell?: (col: number, row: number) => unknown } | undefined\n  )?.getRecordIndexByCell?.(col, row);\n\nexport const getRecordShowIndexByCell = (\n  table: unknown,\n  col: number,\n  row: number,\n): number | undefined =>\n  (\n    table as { getRecordShowIndexByCell?: (col: number, row: number) => number } | undefined\n  )?.getRecordShowIndexByCell?.(col, row);\n\nexport const getIndexKey = (table: unknown, showIndex: number | undefined): unknown =>\n  showIndex == null ? undefined : getDataSource(table)?.getIndexKey?.(showIndex);\n\nexport const getRecordIndexPaths = (table: unknown, showIndex: number | undefined): unknown =>\n  showIndex == null ? undefined : getDataSource(table)?.getRecordIndexPaths?.(showIndex);\n\nexport const setCellCheckboxStateByRecordIndex = (\n  table: unknown,\n  path: unknown,\n  field: string,\n  checked: boolean,\n): void => {\n  (\n    table as {\n      setCellCheckboxStateByRecordIndex?: (\n        recordIndex: unknown,\n        field: string,\n        checked: boolean,\n      ) => void;\n    }\n  )?.setCellCheckboxStateByRecordIndex?.(path, field, checked);\n};\n\nexport const fireTableEvent = (table: unknown, event: string, payload: unknown): void => {\n  (\n    table as { fireListeners?: (event: string, payload: unknown) => void } | undefined\n  )?.fireListeners?.(event, payload);\n};\n\nexport const clearCheckboxState = (table: unknown, field: string): void => {\n  (table as { clearCheckboxState?: (field: string) => void } | undefined)?.clearCheckboxState?.(\n    field,\n  );\n};\n\nexport const clearSelected = (table: unknown): void => {\n  (table as { clearSelected?: () => void } | undefined)?.clearSelected?.();\n};\n\nexport const selectCells = (table: unknown, ranges: unknown[]): void => {\n  (table as { selectCells?: (ranges: unknown[]) => void } | undefined)?.selectCells?.(ranges);\n};\n"],"mappings":";;AAUA,MAAa,iBAAiB,UAC5B,MAAM;;;;;;AAOR,MAAa,mBAAmB,UAC9B,SAAS,QAAQ,cAAc,KAA0B,KAAK;AAQhE,MAAa,0BACX,UAEC,MAAM,WAAqE;AAE9E,MAAa,mBAAmB,UAAmC;CACjE,cAAc,KAAK,CAAC,CAAC,kBAAkB;AACzC;AAEA,MAAa,qBAAqB,OAA0B,KAAa,QAAsB;CAC7F,cAAc,KAAK,CAAC,CAAC,oBAAoB,KAAK,GAAG;AACnD;AAEA,MAAa,0BACX,OACA,UACA,UACA,QACA,WACS;CACT,MASE,yBAAyB,UAAU,UAAU,QAAQ,MAAM;AAC/D;AAEA,MAAa,sBACX,OACA,UAAU,OAC+B;CACzC,MAAM,aAAa,cAAc,KAAK;CACtC,MAAM,aAAa,MAAM,0BAA0B;CACnD,MAAM,WAAW,KAAK,IAAI,YAAY,WAAW,OAAO,YAAY,UAAU;CAO9E,OAAO;EAAE,QANM,KAAK,IAClB,WAAW,OAAO,UAAU,WAAW,SACvC,WAAW,UACV,MAAM,YAAY,KAAK,CAGZ;EAAG;CAAS;AAC5B;AAOA,MAAa,+BAA+B,UACzC,OAA4E,eACzE,WAAW;;;;;;AAOjB,MAAa,8BAA8B,UAAuC;CAChF,MAAM,QAAS,OACX,eAAe,WAAW,wBAAwB,EAAE,EAAE;CAC1D,OAAO,OAAO,UAAU,YAAY,UAAU,KAAK,QAAQ,KAAA;AAC7D;;;;;;AAsBA,MAAa,sBAAsB,UAAkD;CACnF,MAAM,SAAU,OACZ;CACJ,OAAO,QAAQ,mBAAmB,QAAQ;AAC5C;AAEA,MAAa,wBAAwB,UAA8C;CACjF,MAAM,aAAc,OAAgE;CAKpF,OAAO,CAHL,YAAY,gBAAgB,QAAQ,YACpC,YAAY,mBAAmB,QAAQ,UAE9B,CAAC,CAAC,OAAO,OAAO;AAC7B;AAEA,MAAa,gBAAgB,OAAgB,QAC1C,OAAgF,eAC/E,GACF;;;;;;;;AASF,MAAa,oBAAoB,UAAuC;CACtE,MAAM,SACJ,OACC,mBAAmB;CAEtB,OAAO,OAAO,WAAW,YAAY,OAAO,SAAS,MAAM,KAAK,SAAS,IAAI,SAAS,KAAA;AACxF;AAYA,MAAa,oBAAoB,UAC9B,OAAqE;;;;;;AAOxE,MAAa,oBAAoB,UAC9B,OAAuE,eACpE;AAEN,MAAa,eAAe,UACzB,OACG,eAAe;AAErB,MAAa,mBAAmB,UAC7B,OAA8C;AAEjD,MAAa,iBAAiB,UAC3B,OAA4C;AAE/C,MAAa,cAAc,UACxB,OAA+C;AAElD,MAAa,wBAAwB,OAAgB,KAAa,QAE9D,OACC,uBAAuB,KAAK,GAAG;AAEpC,MAAa,4BACX,OACA,KACA,QAGE,OACC,2BAA2B,KAAK,GAAG;AAExC,MAAa,eAAe,OAAgB,cAC1C,aAAa,OAAO,KAAA,IAAY,cAAc,KAAK,CAAC,EAAE,cAAc,SAAS;AAK/E,MAAa,qCACX,OACA,MACA,OACA,YACS;CACT,OAQG,oCAAoC,MAAM,OAAO,OAAO;AAC7D;AAEA,MAAa,kBAAkB,OAAgB,OAAe,YAA2B;CACvF,OAEG,gBAAgB,OAAO,OAAO;AACnC;AAEA,MAAa,sBAAsB,OAAgB,UAAwB;CACzE,OAAyE,qBACvE,KACF;AACF;AAEA,MAAa,iBAAiB,UAAyB;CACrD,OAAuD,gBAAgB;AACzE;AAEA,MAAa,eAAe,OAAgB,WAA4B;CACtE,OAAsE,cAAc,MAAM;AAC5F"}

package/es/ThemeProvider/AppElementContext.d.mts

@@ -0,0 +1,5 @@
+//#region src/ThemeProvider/AppElementContext.d.ts
+declare const useAppElement: () => HTMLDivElement | null;
+//#endregion
+export { useAppElement };
+//# sourceMappingURL=AppElementContext.d.mts.map

package/es/ThemeProvider/AppElementContext.mjs

@@ -0,0 +1,10 @@
+"use client";
+import { createContext, use } from "react";
+//#region src/ThemeProvider/AppElementContext.tsx
+/** Portal 宿主元素（`data-superad-portal-host`）的上下文，弹层类组件据此定位挂载点。 */
+const AppElementContext = createContext(null);
+const useAppElement = () => use(AppElementContext);
+//#endregion
+export { AppElementContext as default, useAppElement };
+
+//# sourceMappingURL=AppElementContext.mjs.map

package/es/ThemeProvider/AppElementContext.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"AppElementContext.mjs","names":[],"sources":["../../src/ThemeProvider/AppElementContext.tsx"],"sourcesContent":["'use client';\n\nimport { createContext, use } from 'react';\n\n/** Portal 宿主元素（`data-superad-portal-host`）的上下文，弹层类组件据此定位挂载点。 */\nconst AppElementContext = createContext<HTMLDivElement | null>(null);\n\nexport const useAppElement = (): HTMLDivElement | null => use(AppElementContext);\n\nexport default AppElementContext;\n"],"mappings":";;;;AAKA,MAAM,oBAAoB,cAAqC,IAAI;AAEnE,MAAa,sBAA6C,IAAI,iBAAiB"}

package/es/ThemeProvider/ConfigProvider.mjs

@@ -0,0 +1,29 @@
+"use client";
+import { ConfigProvider } from "antd";
+import { cssVar } from "antd-style";
+import { jsx } from "react/jsx-runtime";
+import { memo } from "react";
+//#region src/ThemeProvider/ConfigProvider.tsx
+/** 录入类组件统一锁定边框色：hover / focus 时不变色，保持发丝边框稳定。 */
+const STEADY_BORDER_COMPONENTS = [
+	"DatePicker",
+	"Input",
+	"InputNumber",
+	"Mentions",
+	"Select"
+];
+const steadyBorderTheme = {
+	activeBorderColor: cssVar.colorBorder,
+	hoverBorderColor: cssVar.colorBorder
+};
+const ConfigProvider$1 = memo(({ children }) => /* @__PURE__ */ jsx(ConfigProvider, {
+	theme: { components: {
+		...Object.fromEntries(STEADY_BORDER_COMPONENTS.map((name) => [name, steadyBorderTheme])),
+		Button: { contentFontSizeSM: 12 }
+	} },
+	children
+}));
+//#endregion
+export { ConfigProvider$1 as default };
+
+//# sourceMappingURL=ConfigProvider.mjs.map

package/es/ThemeProvider/ConfigProvider.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConfigProvider.mjs","names":["ConfigProvider","AntdConfigProvider"],"sources":["../../src/ThemeProvider/ConfigProvider.tsx"],"sourcesContent":["'use client';\n\nimport { ConfigProvider as AntdConfigProvider } from 'antd';\nimport { cssVar } from 'antd-style';\nimport { memo, type PropsWithChildren } from 'react';\n\n/** 录入类组件统一锁定边框色：hover / focus 时不变色，保持发丝边框稳定。 */\nconst STEADY_BORDER_COMPONENTS = ['DatePicker', 'Input', 'InputNumber', 'Mentions', 'Select'];\n\nconst steadyBorderTheme = {\n  activeBorderColor: cssVar.colorBorder,\n  hoverBorderColor: cssVar.colorBorder,\n};\n\nconst ConfigProvider = memo<PropsWithChildren>(({ children }) => (\n  <AntdConfigProvider\n    theme={{\n      components: {\n        ...Object.fromEntries(STEADY_BORDER_COMPONENTS.map((name) => [name, steadyBorderTheme])),\n        Button: {\n          contentFontSizeSM: 12,\n        },\n      },\n    }}\n  >\n    {children}\n  </AntdConfigProvider>\n));\n\nexport default ConfigProvider;\n"],"mappings":";;;;;;;AAOA,MAAM,2BAA2B;CAAC;CAAc;CAAS;CAAe;CAAY;AAAQ;AAE5F,MAAM,oBAAoB;CACxB,mBAAmB,OAAO;CAC1B,kBAAkB,OAAO;AAC3B;AAEA,MAAMA,mBAAiB,MAAyB,EAAE,eAChD,oBAACC,gBAAD;CACE,OAAO,EACL,YAAY;EACV,GAAG,OAAO,YAAY,yBAAyB,KAAK,SAAS,CAAC,MAAM,iBAAiB,CAAC,CAAC;EACvF,QAAQ,EACN,mBAAmB,GACrB;CACF,EACF;CAEC;AACiB,CAAA,CACrB"}