@superad/ui 0.1.1

package/es/Table/vtable/columns.mjs

@@ -0,0 +1,381 @@
+import { TABLE_CHROME } from "../canvas/theme.mjs";
+import { emptyCellLabel, formatAddress, formatDateRange, formatDateTime, formatJson, formatNumber, isEmptyCellValue, isGroupTitleRecord } from "../core/cellValue.mjs";
+import { tableText } from "../core/tableI18n.mjs";
+import { createCanvasTextLayout, createCurrencyLayout } from "../canvas/textPainters.mjs";
+import { createArrayLayout, createLinkLayout, createTagLayout, createUserLayout } from "../canvas/chipPainters.mjs";
+import { JsonEditor, NumberEditor, TextEditor } from "../react/editors/inline.mjs";
+import { AddressEditor, ArrayEditor, DateRangeEditor, DateTimeEditor, OptionEditor, UserEditor } from "../react/editors/picker.mjs";
+import { createBooleanLayout, createCheckboxLayout, createRatingLayout } from "../canvas/controlPainters.mjs";
+import { TABLE_CELL_MIN_WIDTH } from "../type.mjs";
+//#region src/Table/vtable/columns.ts
+const isGroupColumn = (column) => "columns" in column && Array.isArray(column.columns);
+/**
+* 使用方是否要这一列**整列交回 VTable**。
+*
+* 判据只看「这列的渲染方式由 VTable 原生负责」的信号：`cellType` / `customRender` /
+* `customLayout` / `headerType` / 分组子列。
+*
+* **`fieldFormat` **不在**这里**。它只是自定义显示，是极普通的写法，而我们照样能编译这一列 ——
+* 曾经把它也算作「原生列」，代价是整列被原样返回、**不挂编辑器**：只是加了个 `fieldFormat`，
+* 列就静默失去编辑能力（树形表格 demo 的前三列连同树列本身都中招）。
+*/
+const isRawVTableColumn = (column) => isGroupColumn(column) || "cellType" in column || "customRender" in column || "customLayout" in column || "headerType" in column;
+const canEdit = (column, editable) => column.editable ?? editable ?? false;
+const fieldFormatter = (field, format, empty, i18n) => (record) => {
+	if (isGroupTitleRecord(record)) return "";
+	const text = format(record == null ? void 0 : record[field]);
+	if (text.trim()) return text;
+	if (!empty) return "";
+	return i18n ? tableText({ __superadI18n: i18n }, "setField", { title: empty }) : emptyCellLabel(empty);
+};
+const withCellKind = (define, kind, editable) => {
+	const next = define;
+	next.superadEditable = editable;
+	next.superadKind = kind;
+	return next;
+};
+/** 标 `superadKind`，并带上是否可编辑（画布铅笔槽 / 悬停浮层要读）。 */
+const withTextKind = (define, kind, editable) => Object.assign(define, {
+	superadEditable: editable,
+	superadKind: kind
+});
+/**
+* 把选择项挂到编译结果上。
+*
+* painter 是把 `options` 闭包进去的，编译后的列上只剩一个 `customLayout` 函数 —— 于是画布上
+* 是「已完成」、而**按列定义取值的地方**（a11y 隐藏层、剪贴板桥）只能拿到记录里的原始值
+* `done`。屏幕阅读器因此朗读英文键。把 `options` 一并留在列上，这些地方才能解析出同一个标签。
+*/
+const withOptions = (define, options, kind, editable, duration) => Object.assign(define, {
+	superadDuration: duration,
+	superadEditable: editable,
+	superadKind: kind,
+	superadOptions: options
+});
+const withLinkKind = (define, linkKind, editable) => {
+	const next = define;
+	next.superadEditable = editable;
+	next.superadKind = "link";
+	next.superadLinkKind = linkKind;
+	return next;
+};
+const compileSuperAdColumn = (column, ctx, treeField) => {
+	const { currency = "¥", field, format, options = [], title, users = [], width } = column;
+	const type = column.type ?? "text";
+	const editable = canEdit(column, ctx.editable);
+	const empty = editable ? title : void 0;
+	const multiple = column.multiple ?? [
+		"array",
+		"email",
+		"phone",
+		"tag",
+		"user"
+	].includes(type);
+	const tree = field === treeField || column.tree ? true : void 0;
+	const sort = column.sort || void 0;
+	const token = ctx.token;
+	const useCanvasTextLayout = Boolean(ctx.groupedTree) && tree !== true;
+	if (type === "checkbox") return withCellKind({
+		cellType: "text",
+		customLayout: createCheckboxLayout(),
+		field,
+		sort,
+		title,
+		tree,
+		width
+	}, "checkbox", editable);
+	if (type === "boolean") return withCellKind({
+		cellType: "text",
+		customLayout: createBooleanLayout(editable),
+		field,
+		sort,
+		title,
+		tree,
+		width
+	}, "boolean", editable);
+	if (type === "rating") return withCellKind({
+		cellType: "text",
+		customLayout: createRatingLayout(),
+		field,
+		sort,
+		title,
+		tree,
+		width
+	}, "rating", editable);
+	if (type === "array") return withTextKind({
+		cellType: "text",
+		customLayout: createArrayLayout(empty),
+		editor: editable ? new ArrayEditor() : void 0,
+		field,
+		sort,
+		title,
+		tree,
+		width
+	}, "array", editable);
+	if (type === "email" || type === "phone" || type === "link") return withLinkKind({
+		cellType: "text",
+		customLayout: createLinkLayout(type, empty),
+		editor: editable ? multiple ? new ArrayEditor() : new TextEditor() : void 0,
+		field,
+		sort,
+		title,
+		tree,
+		width
+	}, type, editable);
+	if (type === "currency") return {
+		cellType: "text",
+		customLayout: createCurrencyLayout(currency, empty),
+		editor: editable ? new NumberEditor({ prefix: currency }) : void 0,
+		field,
+		sort,
+		title,
+		tree,
+		width
+	};
+	if (type === "json") return {
+		cellType: "text",
+		...useCanvasTextLayout ? { customLayout: createCanvasTextLayout() } : null,
+		editor: editable ? new JsonEditor() : void 0,
+		field,
+		fieldFormat: fieldFormatter(field, formatJson, empty, ctx.i18n),
+		sort,
+		title,
+		tree,
+		width
+	};
+	if (type === "address") return {
+		cellType: "text",
+		...useCanvasTextLayout ? { customLayout: createCanvasTextLayout() } : null,
+		editor: editable ? new AddressEditor() : void 0,
+		field,
+		fieldFormat: fieldFormatter(field, formatAddress, empty, ctx.i18n),
+		sort,
+		title,
+		tree,
+		width
+	};
+	if (type === "image") return {
+		cellType: "image",
+		clickToPreview: true,
+		field,
+		imageAutoSizing: false,
+		keepAspectRatio: true,
+		style: { margin: 4 },
+		title,
+		tree,
+		width
+	};
+	if (type === "progress") {
+		const unit = column.unit ?? "%";
+		return {
+			cellType: "progressbar",
+			editor: editable ? new NumberEditor({
+				max: 100,
+				min: 0,
+				suffix: unit
+			}) : void 0,
+			field,
+			fieldFormat: fieldFormatter(field, (value) => formatNumber(value, unit)),
+			max: 100,
+			min: 0,
+			sort,
+			style: {
+				barBgColor: token?.colorFillSecondary ?? "#f5f5f5",
+				barBottom: 10,
+				barColor: (args) => {
+					const value = Number(args.dataValue ?? args.value);
+					if (Number.isFinite(value) && value >= 100) return token?.colorSuccess ?? TABLE_CHROME.success;
+					return token?.colorInfo ?? TABLE_CHROME.accent;
+				},
+				barHeight: 6,
+				color: token?.colorText ?? TABLE_CHROME.text,
+				fontSize: 12,
+				textAlign: "right"
+			},
+			title,
+			tree,
+			width
+		};
+	}
+	if (type === "number") {
+		const formatValue = (value) => formatNumber(value, column.unit);
+		return {
+			cellType: "text",
+			...useCanvasTextLayout ? { customLayout: createCanvasTextLayout() } : null,
+			editor: editable ? new NumberEditor({ suffix: column.unit }) : void 0,
+			field,
+			fieldFormat: fieldFormatter(field, formatValue, empty, ctx.i18n),
+			sort,
+			title,
+			tree,
+			width
+		};
+	}
+	if (type === "date" || type === "datetime") {
+		const pattern = format ?? (type === "datetime" ? "YYYY-MM-DD HH:mm" : "YYYY-MM-DD");
+		return {
+			cellType: "text",
+			...useCanvasTextLayout ? { customLayout: createCanvasTextLayout() } : null,
+			editor: editable ? new DateTimeEditor(pattern.includes("HH")) : void 0,
+			field,
+			fieldFormat: fieldFormatter(field, (value) => formatDateTime(value, pattern), empty, ctx.i18n),
+			sort,
+			title,
+			tree,
+			width
+		};
+	}
+	if (type === "dateRange") {
+		const pattern = format ?? "YYYY-MM-DD";
+		return {
+			cellType: "text",
+			...useCanvasTextLayout ? { customLayout: createCanvasTextLayout() } : null,
+			editor: editable ? new DateRangeEditor(pattern) : void 0,
+			field,
+			fieldFormat: fieldFormatter(field, (value) => formatDateRange(value, pattern), empty, ctx.i18n),
+			sort,
+			title,
+			tree,
+			width
+		};
+	}
+	if (type === "tag" || type === "select") return withOptions({
+		cellType: "text",
+		customLayout: createTagLayout(options, empty, column.duration),
+		editor: editable ? new OptionEditor(options, multiple) : void 0,
+		field,
+		sort,
+		title,
+		tree,
+		width
+	}, options, type, editable, column.duration);
+	if (type === "user") return withTextKind({
+		cellType: "text",
+		customLayout: createUserLayout(empty),
+		editor: editable ? new UserEditor(users, multiple) : void 0,
+		field,
+		sort,
+		title,
+		tree,
+		width
+	}, "user", editable);
+	return {
+		cellType: "text",
+		...useCanvasTextLayout ? { customLayout: createCanvasTextLayout() } : null,
+		editor: editable ? new TextEditor() : void 0,
+		field,
+		fieldFormat: fieldFormatter(field, (value) => value == null ? "" : String(value), empty, ctx.i18n),
+		sort,
+		style: tree ? {
+			color: token?.colorText || TABLE_CHROME.text,
+			fontSize: 14
+		} : void 0,
+		title,
+		tree,
+		width
+	};
+};
+const resolveTreeField = (columns, tree) => {
+	const marked = columns.find((column) => !isRawVTableColumn(column) && "tree" in column && column.tree);
+	if (marked?.field) return marked.field;
+	if (!tree) return void 0;
+	return columns.find((column) => !isRawVTableColumn(column))?.field;
+};
+const resolveColumnMinWidth = (column, treeField) => {
+	if (column.minWidth != null) return column.minWidth;
+	if (column.tree || column.field === treeField) return 160;
+	return TABLE_CELL_MIN_WIDTH[column.type ?? "text"];
+};
+const withMinWidth = (column, minWidth) => {
+	const next = {
+		...column,
+		minWidth: column.minWidth ?? minWidth
+	};
+	const children = column.columns;
+	if (Array.isArray(children)) next.columns = children.map((child) => withMinWidth(child, 80));
+	return next;
+};
+const withDefaultColumnMinWidths = (columns) => columns?.map((column) => withMinWidth(column, 80));
+/**
+* 空值时把文字压成弱色 —— 与 canvas 那条路径（`createEmptyCellText`）对齐。
+*
+* 原生渲染的列（有 `fieldFormat`、没有 `customLayout`）用的是列样式，不区分空值就会同一张表里
+* 「设置 名称」深、「设置 状态」浅。json / address / progress / number / date 这几个分支各写各的
+* `fieldFormat`，所以在这里一处收口。
+*
+* 两个必须注意的点：
+* - 判空看**原始值**：格式化后的文本在空值时正好是占位文案（「设置 X」），拿它比会误判。
+* - 使用方给了 `fieldFormat` 时**不介入**：显示值来自那个函数、未必是 `field`。树表的 department
+*   列就是这样（值取 `rec.department ?? rec.group ?? rec.name`，而记录里 `group` 是空的），
+*   按 `field` 判空会把整列错涂成弱色。
+*/
+const withBlankMutedColor = (define, column, token) => {
+	if (column.fieldFormat != null || define.fieldFormat == null || define.customLayout != null) return;
+	const base = define.style;
+	define.style = ((args) => {
+		const record = args.table?.getCellOriginRecord?.(args.col, args.row);
+		const blank = record != null && isEmptyCellValue(record[column.field]);
+		const inherited = typeof base === "function" ? base(args) : base ?? {};
+		return {
+			...inherited,
+			color: blank ? token?.colorTextTertiary ?? TABLE_CHROME.textMuted : inherited.color ?? token?.colorText ?? TABLE_CHROME.text
+		};
+	});
+};
+/**
+* 原生渲染（无 customLayout）且**真有编辑器**的列：右侧 padding 多留铅笔槽。
+*
+* 判据必须与 `resolveEditHint`（看 `getEditor`）对齐 —— 只看 `canEdit` 会给 image 这类
+* 「表可编辑但本列没有 editor」的列白白让出 28px，进度条 / 封面被挤窄却永远不出现铅笔。
+* customLayout 那条路径由各 painter 自己减 `EDIT_HINT_GUTTER`，这里再加会双倍。
+*/
+const withEditHintPadding = (define) => {
+	if (define.customLayout != null || define.editor == null) return;
+	const base = define.style;
+	define.style = ((args) => {
+		const inherited = typeof base === "function" ? base(args) : base ?? {};
+		const padding = inherited.padding;
+		let next;
+		if (Array.isArray(padding)) next = [
+			Number(padding[0] ?? 0),
+			Number(padding[1] ?? 0) + 28,
+			Number(padding[2] ?? 0),
+			Number(padding[3] ?? 0)
+		];
+		else if (typeof padding === "number") next = [
+			padding,
+			padding + 28,
+			padding,
+			padding
+		];
+		else next = [
+			0,
+			TABLE_CHROME.paddingX + 28,
+			0,
+			TABLE_CHROME.paddingX
+		];
+		return {
+			...inherited,
+			padding: next
+		};
+	});
+};
+const compileColumns = (columns, ctx = {}) => {
+	if (!columns) return void 0;
+	const treeField = resolveTreeField(columns, ctx.tree);
+	return columns.map((column) => {
+		if (isRawVTableColumn(column)) return withMinWidth(column, 80);
+		const tableColumn = column;
+		const compiled = compileSuperAdColumn(tableColumn, ctx, treeField);
+		if (tableColumn.style != null) compiled.style = tableColumn.style;
+		if (tableColumn.fieldFormat != null) compiled.fieldFormat = tableColumn.fieldFormat;
+		withBlankMutedColor(compiled, tableColumn, ctx.token);
+		withEditHintPadding(compiled);
+		if (compiled.editor != null) compiled.superadEditable = true;
+		return withMinWidth(compiled, resolveColumnMinWidth(tableColumn, treeField));
+	});
+};
+//#endregion
+export { compileColumns, withDefaultColumnMinWidths };
+
+//# sourceMappingURL=columns.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"columns.mjs","names":[],"sources":["../../../src/Table/vtable/columns.ts"],"sourcesContent":["import type { ColumnDefine, ColumnsDefine } from '@visactor/vtable';\n\nimport {\n  createArrayLayout,\n  createLinkLayout,\n  createTagLayout,\n  createUserLayout,\n} from '../canvas/chipPainters';\nimport {\n  createBooleanLayout,\n  createCheckboxLayout,\n  createRatingLayout,\n} from '../canvas/controlPainters';\nimport { EDIT_HINT_GUTTER } from '../canvas/paintUtils';\nimport { createCanvasTextLayout, createCurrencyLayout } from '../canvas/textPainters';\nimport { TABLE_CHROME, type TableToken } from '../canvas/theme';\nimport {\n  emptyCellLabel,\n  formatAddress,\n  formatDateRange,\n  formatDateTime,\n  formatJson,\n  formatNumber,\n  isEmptyCellValue,\n  isGroupTitleRecord,\n  type LinkKind,\n} from '../core/cellValue';\nimport { type TableI18n, tableText } from '../core/tableI18n';\nimport {\n  AddressEditor,\n  ArrayEditor,\n  DateRangeEditor,\n  DateTimeEditor,\n  JsonEditor,\n  NumberEditor,\n  OptionEditor,\n  TextEditor,\n  UserEditor,\n} from '../react/editors';\nimport {\n  DEFAULT_TABLE_COLUMN_MIN_WIDTH,\n  TABLE_CELL_MIN_WIDTH,\n  type TableCellType,\n  type TableColumn,\n  type TableColumnInput,\n  type TableSelectOption,\n} from '../type';\n\nexport interface CompileColumnsContext {\n  editable?: boolean;\n  groupedTree?: boolean;\n  i18n?: TableI18n;\n  token?: TableToken;\n  tree?: boolean;\n}\n\nconst isGroupColumn = (column: TableColumnInput): boolean =>\n  'columns' in column && Array.isArray((column as { columns?: unknown }).columns);\n\n/**\n * 使用方是否要这一列**整列交回 VTable**。\n *\n * 判据只看「这列的渲染方式由 VTable 原生负责」的信号：`cellType` / `customRender` /\n * `customLayout` / `headerType` / 分组子列。\n *\n * **`fieldFormat` **不在**这里**。它只是自定义显示，是极普通的写法，而我们照样能编译这一列 ——\n * 曾经把它也算作「原生列」，代价是整列被原样返回、**不挂编辑器**：只是加了个 `fieldFormat`，\n * 列就静默失去编辑能力（树形表格 demo 的前三列连同树列本身都中招）。\n */\nconst isRawVTableColumn = (column: TableColumnInput): column is ColumnDefine =>\n  isGroupColumn(column) ||\n  'cellType' in column ||\n  'customRender' in column ||\n  'customLayout' in column ||\n  'headerType' in column;\n\nconst canEdit = (column: TableColumn, editable?: boolean) => column.editable ?? editable ?? false;\n\nconst fieldFormatter =\n  (\n    field: string,\n    format: (value: unknown) => string,\n    empty?: string,\n    i18n?: TableI18n,\n  ): ((record: Record<string, unknown>) => string) =>\n  (record) => {\n    if (isGroupTitleRecord(record)) return '';\n    const text = format(record == null ? undefined : record[field]);\n\n    if (text.trim()) return text;\n    if (!empty) return '';\n    return i18n\n      ? tableText({ __superadI18n: i18n }, 'setField', { title: empty })\n      : emptyCellLabel(empty);\n  };\n\n/** Kinds that toggle in place when their cell is clicked. */\ntype SuperAdToggleKind = 'boolean' | 'checkbox' | 'rating';\n\n/**\n * Every `superadKind` marker value written onto a compiled VTable column.\n *\n * `array` / `select` / `tag` / `user` 不参与点击切换，标出来是给 **a11y 隐藏层与剪贴板**\n * 用的：这几类的显示文本由 painter 从 `options` / 姓名 / 分隔符映射出来，而 `getCellValue`\n * 给的是记录原始值（读屏于是念 `done` 而不是「已完成」，对象值更是一串 `[object Object]`）。\n */\nexport type SuperAdCellKind = SuperAdToggleKind | 'array' | 'link' | 'select' | 'tag' | 'user';\n\n/** Markers read back by `interaction.ts` via `getBodyColumnDefine`. */\nexport interface SuperAdCellMarkers {\n  /** 状态标题后跟的时长来源（见 `TableColumn.duration`），供悬停浮层与画布用同一份预留。 */\n  superadDuration?: string | { from: string; to: string };\n  superadEditable?: boolean;\n  superadKind?: SuperAdCellKind;\n  superadLinkKind?: LinkKind;\n  /** 选择项，供 a11y / 剪贴板把原始值还原成画面上的标签（见 `withOptions`）。 */\n  superadOptions?: TableSelectOption[];\n}\n\nconst withCellKind = (\n  define: ColumnDefine,\n  kind: SuperAdToggleKind,\n  editable: boolean,\n): ColumnDefine => {\n  const next = define as ColumnDefine & SuperAdCellMarkers;\n  next.superadEditable = editable;\n  next.superadKind = kind;\n  return next;\n};\n\n/** 标 `superadKind`，并带上是否可编辑（画布铅笔槽 / 悬停浮层要读）。 */\nconst withTextKind = (\n  define: ColumnDefine,\n  kind: 'array' | 'user',\n  editable: boolean,\n): ColumnDefine =>\n  Object.assign(define, {\n    superadEditable: editable,\n    superadKind: kind,\n  } as Partial<SuperAdCellMarkers>);\n\n/**\n * 把选择项挂到编译结果上。\n *\n * painter 是把 `options` 闭包进去的，编译后的列上只剩一个 `customLayout` 函数 —— 于是画布上\n * 是「已完成」、而**按列定义取值的地方**（a11y 隐藏层、剪贴板桥）只能拿到记录里的原始值\n * `done`。屏幕阅读器因此朗读英文键。把 `options` 一并留在列上，这些地方才能解析出同一个标签。\n */\nconst withOptions = (\n  define: ColumnDefine,\n  options: TableSelectOption[],\n  kind: 'select' | 'tag',\n  editable: boolean,\n  duration?: string | { from: string; to: string },\n): ColumnDefine =>\n  Object.assign(define, {\n    superadDuration: duration,\n    superadEditable: editable,\n    superadKind: kind,\n    superadOptions: options,\n  } as Partial<SuperAdCellMarkers>);\n\nconst withLinkKind = (\n  define: ColumnDefine,\n  linkKind: LinkKind,\n  editable: boolean,\n): ColumnDefine => {\n  const next = define as ColumnDefine & SuperAdCellMarkers;\n  next.superadEditable = editable;\n  next.superadKind = 'link';\n  next.superadLinkKind = linkKind;\n  return next;\n};\n\nconst compileSuperAdColumn = (\n  column: TableColumn,\n  ctx: CompileColumnsContext,\n  treeField?: string,\n): ColumnDefine => {\n  const { currency = '¥', field, format, options = [], title, users = [], width } = column;\n  const type: TableCellType = column.type ?? 'text';\n  const editable = canEdit(column, ctx.editable);\n  const empty = editable ? title : undefined;\n  const multiple = column.multiple ?? ['array', 'email', 'phone', 'tag', 'user'].includes(type);\n  const tree = field === treeField || column.tree ? true : undefined;\n  const sort = column.sort || undefined;\n  const token = ctx.token;\n  const useCanvasTextLayout = Boolean(ctx.groupedTree) && tree !== true;\n\n  if (type === 'checkbox') {\n    return withCellKind(\n      {\n        cellType: 'text',\n        customLayout: createCheckboxLayout(),\n        field,\n        sort,\n        title,\n        tree,\n        width,\n      },\n      'checkbox',\n      editable,\n    );\n  }\n\n  if (type === 'boolean') {\n    return withCellKind(\n      {\n        cellType: 'text',\n        customLayout: createBooleanLayout(editable),\n        field,\n        sort,\n        title,\n        tree,\n        width,\n      },\n      'boolean',\n      editable,\n    );\n  }\n\n  if (type === 'rating') {\n    return withCellKind(\n      {\n        cellType: 'text',\n        customLayout: createRatingLayout(),\n        field,\n        sort,\n        title,\n        tree,\n        width,\n      },\n      'rating',\n      editable,\n    );\n  }\n\n  if (type === 'array') {\n    return withTextKind(\n      {\n        cellType: 'text',\n        customLayout: createArrayLayout(empty),\n        editor: editable ? new ArrayEditor() : undefined,\n        field,\n        sort,\n        title,\n        tree,\n        width,\n      },\n      'array',\n      editable,\n    );\n  }\n\n  if (type === 'email' || type === 'phone' || type === 'link') {\n    return withLinkKind(\n      {\n        cellType: 'text',\n        customLayout: createLinkLayout(type, empty),\n        editor: editable ? (multiple ? new ArrayEditor() : new TextEditor()) : undefined,\n        field,\n        sort,\n        title,\n        tree,\n        width,\n      },\n      type,\n      editable,\n    );\n  }\n\n  if (type === 'currency') {\n    return {\n      cellType: 'text',\n      customLayout: createCurrencyLayout(currency, empty),\n      editor: editable ? new NumberEditor({ prefix: currency }) : undefined,\n      field,\n      sort,\n      title,\n      tree,\n      width,\n    };\n  }\n\n  if (type === 'json') {\n    return {\n      cellType: 'text',\n      ...(useCanvasTextLayout ? { customLayout: createCanvasTextLayout() } : null),\n      editor: editable ? new JsonEditor() : undefined,\n      field,\n      fieldFormat: fieldFormatter(field, formatJson, empty, ctx.i18n),\n      sort,\n      title,\n      tree,\n      width,\n    };\n  }\n\n  if (type === 'address') {\n    return {\n      cellType: 'text',\n      ...(useCanvasTextLayout ? { customLayout: createCanvasTextLayout() } : null),\n      editor: editable ? new AddressEditor() : undefined,\n      field,\n      fieldFormat: fieldFormatter(field, formatAddress, empty, ctx.i18n),\n      sort,\n      title,\n      tree,\n      width,\n    };\n  }\n\n  if (type === 'image') {\n    return {\n      cellType: 'image',\n      clickToPreview: true,\n      field,\n      imageAutoSizing: false,\n      keepAspectRatio: true,\n      style: { margin: 4 },\n      title,\n      tree,\n      width,\n    };\n  }\n\n  if (type === 'progress') {\n    const unit = column.unit ?? '%';\n    return {\n      cellType: 'progressbar',\n      editor: editable ? new NumberEditor({ max: 100, min: 0, suffix: unit }) : undefined,\n      field,\n      // 走 fieldFormatter：它有分组标题行与 record == null 的守卫，其它类型的 fieldFormat\n      // 都从这里出。直接 `record[field]` 会在分组标题行上抛（record 可能为空）。\n      fieldFormat: fieldFormatter(field, (value) => formatNumber(value, unit)),\n      max: 100,\n      min: 0,\n      sort,\n      style: {\n        barBgColor: token?.colorFillSecondary ?? '#f5f5f5',\n        barBottom: 10,\n        barColor: (args) => {\n          const value = Number(args.dataValue ?? args.value);\n          if (Number.isFinite(value) && value >= 100)\n            return token?.colorSuccess ?? TABLE_CHROME.success;\n          return token?.colorInfo ?? TABLE_CHROME.accent;\n        },\n        barHeight: 6,\n        // 走 token，否则暗色模式下是近黑色压在同为暗色的容器上。\n        color: token?.colorText ?? TABLE_CHROME.text,\n        fontSize: 12,\n        textAlign: 'right',\n      },\n      title,\n      tree,\n      width,\n    };\n  }\n\n  if (type === 'number') {\n    const formatValue = (value: unknown) => formatNumber(value, column.unit);\n    return {\n      cellType: 'text',\n      ...(useCanvasTextLayout ? { customLayout: createCanvasTextLayout() } : null),\n      editor: editable ? new NumberEditor({ suffix: column.unit }) : undefined,\n      field,\n      fieldFormat: fieldFormatter(field, formatValue, empty, ctx.i18n),\n      sort,\n      title,\n      tree,\n      width,\n    };\n  }\n\n  if (type === 'date' || type === 'datetime') {\n    const pattern = format ?? (type === 'datetime' ? 'YYYY-MM-DD HH:mm' : 'YYYY-MM-DD');\n    return {\n      cellType: 'text',\n      ...(useCanvasTextLayout ? { customLayout: createCanvasTextLayout() } : null),\n      editor: editable ? new DateTimeEditor(pattern.includes('HH')) : undefined,\n      field,\n      fieldFormat: fieldFormatter(\n        field,\n        (value) => formatDateTime(value, pattern),\n        empty,\n        ctx.i18n,\n      ),\n      sort,\n      title,\n      tree,\n      width,\n    };\n  }\n\n  if (type === 'dateRange') {\n    const pattern = format ?? 'YYYY-MM-DD';\n    return {\n      cellType: 'text',\n      ...(useCanvasTextLayout ? { customLayout: createCanvasTextLayout() } : null),\n      editor: editable ? new DateRangeEditor(pattern) : undefined,\n      field,\n      fieldFormat: fieldFormatter(\n        field,\n        (value) => formatDateRange(value, pattern),\n        empty,\n        ctx.i18n,\n      ),\n      sort,\n      title,\n      tree,\n      width,\n    };\n  }\n\n  if (type === 'tag' || type === 'select') {\n    return withOptions(\n      {\n        cellType: 'text',\n        customLayout: createTagLayout(options, empty, column.duration),\n        editor: editable ? new OptionEditor(options, multiple) : undefined,\n        field,\n        sort,\n        title,\n        tree,\n        width,\n      },\n      options,\n      type,\n      editable,\n      column.duration,\n    );\n  }\n\n  if (type === 'user') {\n    return withTextKind(\n      {\n        cellType: 'text',\n        customLayout: createUserLayout(empty),\n        editor: editable ? new UserEditor(users, multiple) : undefined,\n        field,\n        sort,\n        title,\n        tree,\n        width,\n      },\n      'user',\n      editable,\n    );\n  }\n\n  return {\n    cellType: 'text',\n    ...(useCanvasTextLayout ? { customLayout: createCanvasTextLayout() } : null),\n    editor: editable ? new TextEditor() : undefined,\n    field,\n    fieldFormat: fieldFormatter(\n      field,\n      (value) => (value == null ? '' : String(value)),\n      empty,\n      ctx.i18n,\n    ),\n    sort,\n    style: tree ? { color: token?.colorText || TABLE_CHROME.text, fontSize: 14 } : undefined,\n    title,\n    tree,\n    width,\n  };\n};\n\nconst resolveTreeField = (columns: TableColumnInput[], tree?: boolean): string | undefined => {\n  const marked = columns.find(\n    (column) => !isRawVTableColumn(column) && 'tree' in column && column.tree,\n  ) as TableColumn | undefined;\n  if (marked?.field) return marked.field;\n  if (!tree) return undefined;\n  const first = columns.find((column) => !isRawVTableColumn(column)) as TableColumn | undefined;\n  return first?.field;\n};\n\nconst resolveColumnMinWidth = (column: TableColumn, treeField?: string): number | string => {\n  if (column.minWidth != null) return column.minWidth;\n  if (column.tree || column.field === treeField) return 160;\n  return TABLE_CELL_MIN_WIDTH[column.type ?? 'text'];\n};\n\nconst withMinWidth = (column: ColumnDefine, minWidth: number | string): ColumnDefine => {\n  const next = {\n    ...column,\n    minWidth: (column as { minWidth?: number | string }).minWidth ?? minWidth,\n  } as ColumnDefine & { columns?: ColumnDefine[] };\n  const children = (column as { columns?: ColumnDefine[] }).columns;\n\n  if (Array.isArray(children)) {\n    next.columns = children.map((child) => withMinWidth(child, DEFAULT_TABLE_COLUMN_MIN_WIDTH));\n  }\n\n  return next;\n};\n\nexport const withDefaultColumnMinWidths = (columns?: ColumnsDefine): ColumnsDefine | undefined =>\n  columns?.map((column) => withMinWidth(column, DEFAULT_TABLE_COLUMN_MIN_WIDTH));\n\n/**\n * 空值时把文字压成弱色 —— 与 canvas 那条路径（`createEmptyCellText`）对齐。\n *\n * 原生渲染的列（有 `fieldFormat`、没有 `customLayout`）用的是列样式，不区分空值就会同一张表里\n * 「设置 名称」深、「设置 状态」浅。json / address / progress / number / date 这几个分支各写各的\n * `fieldFormat`，所以在这里一处收口。\n *\n * 两个必须注意的点：\n * - 判空看**原始值**：格式化后的文本在空值时正好是占位文案（「设置 X」），拿它比会误判。\n * - 使用方给了 `fieldFormat` 时**不介入**：显示值来自那个函数、未必是 `field`。树表的 department\n *   列就是这样（值取 `rec.department ?? rec.group ?? rec.name`，而记录里 `group` 是空的），\n *   按 `field` 判空会把整列错涂成弱色。\n */\nconst withBlankMutedColor = (\n  define: ColumnDefine,\n  column: TableColumn,\n  token?: TableToken,\n): void => {\n  if (column.fieldFormat != null || define.fieldFormat == null || define.customLayout != null)\n    return;\n\n  const base = define.style as\n    ((args: unknown) => Record<string, unknown>) | Record<string, unknown> | undefined;\n\n  define.style = ((args: { col: number; row: number; table?: unknown }) => {\n    const table = args.table as\n      | { getCellOriginRecord?: (col: number, row: number) => Record<string, unknown> | undefined }\n      | undefined;\n    const record = table?.getCellOriginRecord?.(args.col, args.row);\n    const blank = record != null && isEmptyCellValue(record[column.field]);\n    const inherited = typeof base === 'function' ? base(args) : (base ?? {});\n\n    return {\n      ...inherited,\n      color: blank\n        ? (token?.colorTextTertiary ?? TABLE_CHROME.textMuted)\n        : ((inherited as { color?: string }).color ?? token?.colorText ?? TABLE_CHROME.text),\n    };\n  }) as ColumnDefine['style'];\n};\n\n/**\n * 原生渲染（无 customLayout）且**真有编辑器**的列：右侧 padding 多留铅笔槽。\n *\n * 判据必须与 `resolveEditHint`（看 `getEditor`）对齐 —— 只看 `canEdit` 会给 image 这类\n * 「表可编辑但本列没有 editor」的列白白让出 28px，进度条 / 封面被挤窄却永远不出现铅笔。\n * customLayout 那条路径由各 painter 自己减 `EDIT_HINT_GUTTER`，这里再加会双倍。\n */\nconst withEditHintPadding = (define: ColumnDefine): void => {\n  if (define.customLayout != null || define.editor == null) return;\n\n  const base = define.style as\n    ((args: unknown) => Record<string, unknown>) | Record<string, unknown> | undefined;\n\n  define.style = ((args: unknown) => {\n    const inherited = typeof base === 'function' ? base(args) : (base ?? {});\n    const padding = (inherited as { padding?: number | (number | null)[] }).padding;\n    let next: [number, number, number, number];\n\n    if (Array.isArray(padding)) {\n      next = [\n        Number(padding[0] ?? 0),\n        Number(padding[1] ?? 0) + EDIT_HINT_GUTTER,\n        Number(padding[2] ?? 0),\n        Number(padding[3] ?? 0),\n      ];\n    } else if (typeof padding === 'number') {\n      next = [padding, padding + EDIT_HINT_GUTTER, padding, padding];\n    } else {\n      next = [0, TABLE_CHROME.paddingX + EDIT_HINT_GUTTER, 0, TABLE_CHROME.paddingX];\n    }\n\n    return { ...inherited, padding: next };\n  }) as ColumnDefine['style'];\n};\n\nexport const compileColumns = (\n  columns: TableColumnInput[] | undefined,\n  ctx: CompileColumnsContext = {},\n): ColumnsDefine | undefined => {\n  if (!columns) return undefined;\n  const treeField = resolveTreeField(columns, ctx.tree);\n\n  return columns.map((column) => {\n    if (isRawVTableColumn(column)) {\n      return withMinWidth(column, DEFAULT_TABLE_COLUMN_MIN_WIDTH);\n    }\n\n    const tableColumn = column as TableColumn;\n    const compiled = compileSuperAdColumn(tableColumn, ctx, treeField);\n    if (tableColumn.style != null) compiled.style = tableColumn.style;\n    // 使用方给的 `fieldFormat` 是这一列显示的唯一真相，压过按 `type` 生成的格式化器 ——\n    // 否则「带 fieldFormat 的列现在会被编译」这条改动会把它们的显示改掉。\n    if (tableColumn.fieldFormat != null) compiled.fieldFormat = tableColumn.fieldFormat;\n    withBlankMutedColor(compiled, tableColumn, ctx.token);\n    withEditHintPadding(compiled);\n    // customLayout 列的铅笔槽读 `superadEditable`，不走上面的 padding。chip / 开关列各自\n    // 已经打过；currency 与 groupedTree 下的文本 / 日期 / JSON 一直漏 —— CellTypes 的预算列\n    // 和 Group demo 的日期列就会金额 / 日期顶进铅笔。有 editor 就打，与 resolveEditHint 同口径。\n    if (compiled.editor != null) {\n      (compiled as ColumnDefine & SuperAdCellMarkers).superadEditable = true;\n    }\n    return withMinWidth(compiled, resolveColumnMinWidth(tableColumn, treeField));\n  });\n};\n"],"mappings":"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"}

package/es/Table/vtable/frozenShadow.mjs

@@ -0,0 +1,27 @@
+import { getScenegraphComponent, updateNextFrame } from "./vtableAdapter.mjs";
+//#region src/Table/vtable/frozenShadow.ts
+const hasFrozenColumns = (table) => (table?.frozenColCount ?? 0) > 0;
+/** SuperAd 只在横向滚动离开最左侧时才显示固定列阴影。 */
+const shouldShowFrozenShadow = (table) => hasFrozenColumns(table) && (table?.scrollLeft ?? 0) > 0;
+const applyFrozenShadow = (table, visible) => {
+	if (table == null) return;
+	const shadowLine = getScenegraphComponent(table)?.frozenShadowLine;
+	if (shadowLine == null) return;
+	shadowLine.setAttribute("visible", visible);
+	updateNextFrame(table);
+};
+/**
+* VTable 的 show/hide 会同时控制左右两条阴影线；SuperAd 只需要固定列内侧阴影。
+* 用只控制 frozenShadowLine 的版本替换，避免右侧出现阴影。
+*/
+const patchFrozenShadowControls = (table) => {
+	if (table == null) return;
+	const component = getScenegraphComponent(table);
+	if (component == null) return;
+	component.showFrozenColumnShadow = () => applyFrozenShadow(table, shouldShowFrozenShadow(table));
+	component.hideFrozenColumnShadow = () => applyFrozenShadow(table, false);
+};
+//#endregion
+export { applyFrozenShadow, hasFrozenColumns, patchFrozenShadowControls, shouldShowFrozenShadow };
+
+//# sourceMappingURL=frozenShadow.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"frozenShadow.mjs","names":[],"sources":["../../../src/Table/vtable/frozenShadow.ts"],"sourcesContent":["import { getScenegraphComponent, updateNextFrame } from './vtableAdapter';\n\nexport interface FrozenShadowLine {\n  setAttribute: (key: string, value: boolean) => void;\n}\n\nexport interface FrozenShadowComponent {\n  frozenShadowLine?: FrozenShadowLine;\n  hideFrozenColumnShadow?: () => void;\n  showFrozenColumnShadow?: () => void;\n}\n\nexport interface FrozenShadowTable {\n  frozenColCount?: number;\n  scenegraph?: {\n    component?: FrozenShadowComponent;\n    updateNextFrame?: () => void;\n  };\n  scrollLeft?: number;\n}\n\nexport const hasFrozenColumns = (table?: FrozenShadowTable | null): boolean =>\n  (table?.frozenColCount ?? 0) > 0;\n\n/** SuperAd 只在横向滚动离开最左侧时才显示固定列阴影。 */\nexport const shouldShowFrozenShadow = (table?: FrozenShadowTable | null): boolean =>\n  hasFrozenColumns(table) && (table?.scrollLeft ?? 0) > 0;\n\nexport const applyFrozenShadow = (\n  table: FrozenShadowTable | null | undefined,\n  visible: boolean,\n): void => {\n  if (table == null) return;\n\n  const component = getScenegraphComponent(table as never);\n  const shadowLine = component?.frozenShadowLine;\n  if (shadowLine == null) return;\n\n  shadowLine.setAttribute('visible', visible);\n  updateNextFrame(table as never);\n};\n\n/**\n * VTable 的 show/hide 会同时控制左右两条阴影线；SuperAd 只需要固定列内侧阴影。\n * 用只控制 frozenShadowLine 的版本替换，避免右侧出现阴影。\n */\nexport const patchFrozenShadowControls = (table: FrozenShadowTable | null | undefined): void => {\n  if (table == null) return;\n\n  const component = getScenegraphComponent(table as never);\n  if (component == null) return;\n\n  component.showFrozenColumnShadow = () => applyFrozenShadow(table, shouldShowFrozenShadow(table));\n  component.hideFrozenColumnShadow = () => applyFrozenShadow(table, false);\n};\n"],"mappings":";;AAqBA,MAAa,oBAAoB,WAC9B,OAAO,kBAAkB,KAAK;;AAGjC,MAAa,0BAA0B,UACrC,iBAAiB,KAAK,MAAM,OAAO,cAAc,KAAK;AAExD,MAAa,qBACX,OACA,YACS;CACT,IAAI,SAAS,MAAM;CAGnB,MAAM,aADY,uBAAuB,KACd,CAAC,EAAE;CAC9B,IAAI,cAAc,MAAM;CAExB,WAAW,aAAa,WAAW,OAAO;CAC1C,gBAAgB,KAAc;AAChC;;;;;AAMA,MAAa,6BAA6B,UAAsD;CAC9F,IAAI,SAAS,MAAM;CAEnB,MAAM,YAAY,uBAAuB,KAAc;CACvD,IAAI,aAAa,MAAM;CAEvB,UAAU,+BAA+B,kBAAkB,OAAO,uBAAuB,KAAK,CAAC;CAC/F,UAAU,+BAA+B,kBAAkB,OAAO,KAAK;AACzE"}

package/es/Table/vtable/interaction.mjs

@@ -0,0 +1,175 @@
+import { hrefFor, isGroupTitleRecord, toBoolean, toRating, toValueList } from "../core/cellValue.mjs";
+import { getEditingEditor, getInternalProps, isTableReleased, updateCellContent, updateNextFrame } from "./vtableAdapter.mjs";
+import { isPickerEditor, pickerJustClosed } from "../react/editors/base.mjs";
+import { toggleSeriesHeader, toggleSeriesRow } from "./seriesSelection.mjs";
+//#region src/Table/vtable/interaction.ts
+/**
+* 单元格里直接移除一个值 —— chip 上悬停出来的那个 × 走这条路（人员的姓名 chip、标签 chip）。
+*
+* 值写进 `getCellOriginRecord` 拿到的记录对象，再让引擎只重绘这一格，**不走
+* `changeCellValue`**：它在「分组 + 树」的嵌套行上会静默无操作，症状是「点了没反应，人还在」。
+* 口径与编辑器提交时一致（见 `writeBackOnCommit`）。
+*
+* `index` 是**记录原始数组**里的下标（与 `resolveUserEntries` / `layoutTagChips` 同一套编号）。
+* 值的容器类型保持使用方给的原样：数组仍是数组，单选写回首个剩余项、空了写 `''` —— 与 picker
+* 的 `publish` 同口径，避免「删一个值顺手把字段从 string 改成了数组」。
+*/
+const removeChipAt = (table, col, row, index) => {
+	const record = table.getCellOriginRecord(col, row);
+	const field = table.getBodyColumnDefine(col, row)?.field;
+	if (record == null || typeof field !== "string") return false;
+	const current = record[field];
+	const rest = toValueList(current).filter((_, position) => position !== index);
+	record[field] = Array.isArray(current) ? rest : rest[0] ?? "";
+	updateCellContent(table, col, row);
+	updateNextFrame(table);
+	return true;
+};
+const TREE_ICON_GAP = 4;
+const getGroupToggleCol = (table, col, row) => table.isSeriesNumber(col, row) ? col + 1 : col;
+const isTableEditing = (table) => Boolean(getEditingEditor(table));
+const sameEditHint = (left, right) => {
+	if (left === right) return true;
+	if (!left || !right) return false;
+	return left.col === right.col && left.row === right.row && left.left === right.left && left.top === right.top && left.width === right.width && left.height === right.height;
+};
+const resolveTreeTextOffset = (table, col, row) => {
+	if ((table?.getBodyColumnDefine?.(col, row))?.tree !== true) return 0;
+	const internalProps = getInternalProps(table);
+	const layoutMap = internalProps?.layoutMap;
+	const bodyHelper = internalProps?.bodyHelper;
+	const showIndex = table?.getRecordShowIndexByCell?.(col, row);
+	const indexKey = table?.dataSource?.getIndexKey?.(showIndex);
+	const groupLength = table?.dataSource?.getGroupLength?.() ?? 0;
+	let level = Array.isArray(indexKey) ? indexKey.length - 1 : 0;
+	if (groupLength > 0) level = Math.max(0, level - groupLength);
+	const indent = Math.max(0, level) * (layoutMap?.hierarchyIndent ?? 20);
+	const hasIcon = Boolean(bodyHelper?.getHierarchyIcon?.(col, row));
+	const iconWidth = bodyHelper?.getHierarchyIconWidth?.() ?? 16;
+	const padding = (table?.getCellStyle?.(col, row))?.padding;
+	const paddingLeft = Array.isArray(padding) ? Number(padding[3] || 0) : typeof padding === "number" ? padding : 0;
+	return indent + (hasIcon ? iconWidth + TREE_ICON_GAP : 0) + paddingLeft;
+};
+const resolveEditHint = (table, col, row) => {
+	if (isTableEditing(table)) return null;
+	if (col < 0 || row < 0) return null;
+	if (table.isHeader(col, row) || table.isSeriesNumber(col, row)) return null;
+	if (isGroupTitleRecord(table.getCellOriginRecord(col, row))) return null;
+	if (!table.getEditor(col, row)) return null;
+	const rect = table.getCellRelativeRect(col, row);
+	if (!rect || rect.width <= 0 || rect.height <= 0) return null;
+	const treeOffset = resolveTreeTextOffset(table, col, row);
+	const left = rect.left + treeOffset;
+	const width = rect.width - treeOffset;
+	if (width <= 0) return null;
+	return {
+		col,
+		height: rect.height,
+		left,
+		row,
+		top: rect.top,
+		width
+	};
+};
+const placeEditHint = (hint, tableEl, host) => {
+	if (!hint || !tableEl || !host) return hint;
+	const tableRect = tableEl.getBoundingClientRect();
+	const hostRect = host.getBoundingClientRect();
+	return {
+		...hint,
+		left: hint.left + (tableRect.left - hostRect.left),
+		top: hint.top + (tableRect.top - hostRect.top)
+	};
+};
+const hintFromClientPoint = (table, host, clientX, clientY) => {
+	const tableEl = table.getElement();
+	const rect = tableEl.getBoundingClientRect();
+	const cell = table.getCellAtRelativePosition(clientX - rect.left, clientY - rect.top);
+	if (!cell || cell.col < 0 || cell.row < 0) return null;
+	return placeEditHint(resolveEditHint(table, cell.col, cell.row), tableEl, host);
+};
+const writeCellValue = (table, col, row, value) => {
+	table.changeCellValue(col, row, value);
+};
+const resolveRatingStar = (table, col, row, event) => {
+	const rect = table.getCellRelativeRect(col, row);
+	const offsetX = event != null && "offsetX" in event ? event.offsetX : void 0;
+	if (rect == null || rect.width <= 0 || typeof offsetX !== "number") return 5;
+	const ratio = (offsetX - rect.left) / rect.width;
+	return Math.min(5, Math.max(1, Math.ceil(ratio * 5)));
+};
+/**
+* 去掉 URL 解析本来就会忽略的字符：空白、C0 控制字符与 DEL。按字面前缀匹配会被
+* `java\tscript:` / `  javascript:` 绕过，所以匹配前先归一化。
+* 写成显式字符码而不是控制字符正则：这里要的正是「码点大于空格」这个精确条件。
+*/
+const stripUrlNoise = (href) => {
+	let out = "";
+	for (const char of href) {
+		const code = char.codePointAt(0) ?? 0;
+		if (code > 32 && code !== 127) out += char;
+	}
+	return out;
+};
+/** 会执行脚本的协议。 */
+const SCRIPT_URL = /^(?:javascript|vbscript):/i;
+const isScriptUrl = (href) => SCRIPT_URL.test(stripUrlNoise(href));
+const openHref = (href) => {
+	if (typeof document === "undefined") return;
+	if (isScriptUrl(href)) return;
+	const anchor = document.createElement("a");
+	anchor.href = href;
+	anchor.rel = "noreferrer";
+	anchor.target = "_blank";
+	anchor.click();
+};
+const handleSuperAdCellClick = (table, args) => {
+	const define = table.getBodyColumnDefine?.(args.col, args.row);
+	const kind = define?.superadKind;
+	if (define == null || kind == null) return false;
+	const value = table.getCellOriginValue(args.col, args.row);
+	if (kind === "link") {
+		if (define.superadEditable === true) return false;
+		const href = hrefFor(define.superadLinkKind ?? "link", value);
+		if (href) openHref(href);
+		return true;
+	}
+	if (define.superadEditable !== true) return false;
+	if (kind === "checkbox" || kind === "boolean") {
+		writeCellValue(table, args.col, args.row, toBoolean(value) !== true);
+		return true;
+	}
+	if (kind === "rating") {
+		const current = toRating(value);
+		const star = resolveRatingStar(table, args.col, args.row, args.event);
+		writeCellValue(table, args.col, args.row, current === star ? 0 : star);
+		return true;
+	}
+	return false;
+};
+const handleTableCellClick = (table, args) => {
+	if (table.isSeriesNumber?.(args.col, args.row)) {
+		if (table.isHeader?.(args.col, args.row)) toggleSeriesHeader(table);
+		else toggleSeriesRow(table, args.row, args.event?.shiftKey);
+		return true;
+	}
+	const record = table.getCellOriginRecord(args.col, args.row);
+	if (isGroupTitleRecord(record)) {
+		if (args.targetIcon) return true;
+		table.clearSelected();
+		table.toggleHierarchyState(getGroupToggleCol(table, args.col, args.row), args.row);
+		return true;
+	}
+	if (pickerJustClosed(table)) return true;
+	if (handleSuperAdCellClick(table, args)) return true;
+	if (!isPickerEditor(table.getEditor(args.col, args.row))) return false;
+	window.setTimeout(() => {
+		if (isTableReleased(table)) return;
+		table.startEditCell(args.col, args.row);
+	}, 0);
+	return false;
+};
+//#endregion
+export { getGroupToggleCol, handleTableCellClick, hintFromClientPoint, isTableEditing, placeEditHint, removeChipAt, resolveEditHint, resolveTreeTextOffset, sameEditHint };
+
+//# sourceMappingURL=interaction.mjs.map