@superad/ui 0.1.1

package/es/Table/canvas/groupTitle.mjs

@@ -0,0 +1,181 @@
+"use client";
+import { toneFor } from "../core/tagTone.mjs";
+import { getCanvasPalette } from "./canvasPalette.mjs";
+import { isGroupTitleRecord, resolveOption } from "../core/cellValue.mjs";
+import { fitLabel } from "./paintUtils.mjs";
+import { getLayoutMapHierarchyIndent, getRowHeight, getStickyShadowRoots, getStickyTitleRows } from "../vtable/vtableAdapter.mjs";
+import { CustomLayout } from "@visactor/vtable";
+/** Resolve the level of a group title row, where `0` is the outermost group. */
+const getGroupTitleLevel = (table, col, row) => Math.max(0, table?.getGroupTitleLevel?.(col, row) ?? 0);
+/** Per-level indent used by VTable's built-in group titles. */
+const getGroupTitleIndent = (table, level) => {
+	const indent = getLayoutMapHierarchyIndent(table);
+	return Math.max(0, level) * (typeof indent === "number" ? indent : 20);
+};
+/**
+* VTable's sticky group-title plugin stacks sticky titles with a hard-coded 40px
+* offset, which drifts from the real row height (SuperAd defaults to 36px) and
+* leaves gaps between sticky groups. Compute offsets from the actual row heights
+* so sticky titles line up with the header row and with the rows underneath.
+*/
+const computeStickyTitleOffsets = (rows, getRowHeight) => {
+	const offsets = [];
+	let offset = 0;
+	rows.forEach((row) => {
+		offsets.push(offset);
+		offset += Math.max(0, getRowHeight(row) ?? 0);
+	});
+	return offsets;
+};
+/** 吸顶克隆节点自带的高度（vrender 的 `attribute.height`，即该行行高）。 */
+const readCellHeight = (node) => {
+	const height = node?.attribute?.height;
+	return typeof height === "number" && height > 0 ? height : void 0;
+};
+/**
+* 从吸顶克隆节点自身的高度推出整摞的 y 偏移。缺任何一个高度就返回 undefined ——
+* 只把缺失的那个当 0 会让它后面的节点全叠在同一位置，比原来的漂移更难查。
+*/
+const computeStickyOffsetsFromCells = (children) => {
+	const offsets = [];
+	let offset = 0;
+	for (const child of children) {
+		const height = readCellHeight(child);
+		if (height === void 0) return void 0;
+		offsets.push(offset);
+		offset += height;
+	}
+	return offsets;
+};
+/**
+* VTable positions sticky group titles in a shadow group above the body, but uses
+* a fixed 40px step (`y: 40 * i` in `plugins/list-tree-stick-cell.js`). Re-apply the
+* offsets computed from real row heights so the sticky stack lines up with the header
+* row and the body rows.
+*
+* Offsets come from the sticky clones' own heights: those nodes are already being
+* walked here, and their height *is* the row height, so this needs no read of the
+* plugin's private `showedTitleRows`. That field is only a fallback — if it ever
+* stops matching (`titleRows` is a stack, so nested groups stick several rows), the
+* geometry path keeps working instead of silently reverting to the 40px step.
+*/
+const alignStickyGroupTitles = (table, background) => {
+	const roots = getStickyShadowRoots(table);
+	if (roots.length === 0) return;
+	const rowOffsets = (count) => {
+		const rows = getStickyTitleRows(table);
+		if (rows == null || rows.length === 0) return void 0;
+		const offsets = computeStickyTitleOffsets(rows, (row) => getRowHeight(table, row));
+		return offsets.length >= count ? offsets : void 0;
+	};
+	const childrenOf = (node) => {
+		if (Array.isArray(node?.children)) return node.children;
+		const children = [];
+		node?.forEachChildren?.((child) => {
+			children.push(child);
+		});
+		return children;
+	};
+	roots.forEach((root) => {
+		childrenOf(root).forEach((colGroup) => {
+			const children = childrenOf(colGroup);
+			const offsets = computeStickyOffsetsFromCells(children) ?? rowOffsets(children.length);
+			if (offsets == null) return;
+			children.forEach((child, index) => {
+				const offset = offsets[index];
+				if (offset == null) return;
+				const attrs = { y: offset };
+				if (background != null) attrs.fill = background;
+				child.setAttributes?.(attrs);
+			});
+		});
+	});
+};
+/** Pick the grouped column that belongs to the given group level. */
+const getGroupByField = (groupBy, level) => {
+	const fields = Array.isArray(groupBy) ? groupBy : [groupBy];
+	return fields[level] ?? fields.at(-1) ?? "";
+};
+/** Count the leaf records under a group record (nested groups are traversed). */
+const countGroupRecords = (record) => {
+	const children = record?.children;
+	if (Array.isArray(children) === false) return 0;
+	return children.reduce((total, child) => {
+		return total + (isGroupTitleRecord(child) ? countGroupRecords(child) : 1);
+	}, 0);
+};
+const createGroupTitleTagLayout = ({ colors, columns, groupBy }) => (args) => {
+	const palette = getCanvasPalette(args.table);
+	const table = args.table;
+	const row = args.row ?? 0;
+	const col = args.col ?? 0;
+	const width = args.rect?.width ?? 240;
+	const height = args.rect?.height ?? 40;
+	const record = table?.getCellOriginRecord?.(0, row);
+	const label = record?.vtableMergeName == null ? "" : String(record.vtableMergeName);
+	const level = getGroupTitleLevel(table, col, row);
+	const field = getGroupByField(groupBy, level);
+	const column = columns?.find((item) => item.field === field);
+	const option = resolveOption(record?.vtableMergeName, column?.options);
+	const isDark = palette.isDarkMode;
+	const tone = toneFor(option.value, option.color, isDark, palette.checkboxBg);
+	const customColor = colors?.[label];
+	const background = customColor ? toneFor(option.value, customColor, isDark, palette.checkboxBg).bg : tone.bg;
+	const count = countGroupRecords(record);
+	const suffix = count > 0 ? `共${count}个` : "";
+	const chipHeight = 24;
+	const chipTop = Math.max(0, (height - chipHeight) / 2);
+	const chipLeft = 26 + getGroupTitleIndent(table, level);
+	const estimate = (text) => text.length * 15 + 24;
+	const suffixWidth = suffix === "" ? 0 : estimate(suffix) + 8;
+	const available = Math.max(64, width - chipLeft - 26 - suffixWidth);
+	const fitted = fitLabel(label, available, estimate);
+	const chipWidth = Math.min(Math.max(64, estimate(fitted)), available);
+	const root = new CustomLayout.Group({
+		height,
+		pickable: false,
+		width
+	});
+	root.add(new CustomLayout.Rect({
+		cornerRadius: 6,
+		fill: background,
+		height: chipHeight,
+		lineWidth: tone.border ? 1 : 0,
+		pickable: false,
+		stroke: tone.border,
+		width: chipWidth,
+		x: chipLeft,
+		y: chipTop
+	}));
+	root.add(new CustomLayout.Text({
+		fontFamily: palette.fontFamily,
+		fill: isDark ? tone.color : palette.text,
+		fontSize: 13,
+		pickable: false,
+		text: fitted,
+		textAlign: "left",
+		textBaseline: "top",
+		x: chipLeft + 10,
+		y: chipTop + 4
+	}));
+	if (suffix !== "") root.add(new CustomLayout.Text({
+		fontFamily: palette.fontFamily,
+		fill: palette.textMuted,
+		fontSize: 12,
+		pickable: false,
+		text: suffix,
+		textAlign: "left",
+		textBaseline: "top",
+		x: chipLeft + chipWidth + 8,
+		y: chipTop + 5
+	}));
+	return {
+		enableCellPadding: false,
+		renderDefault: true,
+		rootContainer: root
+	};
+};
+//#endregion
+export { alignStickyGroupTitles, computeStickyOffsetsFromCells, computeStickyTitleOffsets, countGroupRecords, createGroupTitleTagLayout, getGroupByField, getGroupTitleIndent, getGroupTitleLevel };
+
+//# sourceMappingURL=groupTitle.mjs.map

package/es/Table/canvas/groupTitle.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"groupTitle.mjs","names":[],"sources":["../../../src/Table/canvas/groupTitle.ts"],"sourcesContent":["'use client';\n\nimport { CustomLayout } from '@visactor/vtable';\nimport type { ICustomLayoutFuc } from '@visactor/vtable/es/ts-types/customLayout';\n\nimport { isGroupTitleRecord, resolveOption } from '../core/cellValue';\nimport { toneFor } from '../core/tagTone';\nimport type { TableSelectOption } from '../type';\nimport {\n  getLayoutMapHierarchyIndent,\n  getRowHeight,\n  getStickyShadowRoots,\n  getStickyTitleRows,\n} from '../vtable/vtableAdapter';\nimport { getCanvasPalette } from './canvasPalette';\nimport { fitLabel } from './paintUtils';\n\ntype GroupTitleTable = {\n  getGroupTitleLevel?: (col: number, row: number) => number | undefined;\n  internalProps?: { layoutMap?: { hierarchyIndent?: number } };\n};\n\n/** Horizontal inset before the group-title chip, after the collapse icon. */\nexport const GROUP_TITLE_CHIP_INSET = 26;\n\n/**\n * Fallback for VTable's own default hierarchy indent. Every indented surface should read the\n * live value through getLayoutMapHierarchyIndent and use this only when the layout map is\n * unavailable, so a custom `hierarchyIndent` cannot make them drift apart.\n * (See @visactor/vtable layout/simple-header-layout: `hierarchyIndent ?? 20`.)\n */\nexport const DEFAULT_HIERARCHY_INDENT = 20;\n\n/** Resolve the level of a group title row, where `0` is the outermost group. */\nexport const getGroupTitleLevel = (table: unknown, col: number, row: number): number =>\n  Math.max(0, (table as GroupTitleTable | undefined)?.getGroupTitleLevel?.(col, row) ?? 0);\n\n/** Per-level indent used by VTable's built-in group titles. */\nexport const getGroupTitleIndent = (table: unknown, level: number): number => {\n  const indent = getLayoutMapHierarchyIndent(table);\n  return Math.max(0, level) * (typeof indent === 'number' ? indent : DEFAULT_HIERARCHY_INDENT);\n};\n\n/**\n * VTable's sticky group-title plugin stacks sticky titles with a hard-coded 40px\n * offset, which drifts from the real row height (SuperAd defaults to 36px) and\n * leaves gaps between sticky groups. Compute offsets from the actual row heights\n * so sticky titles line up with the header row and with the rows underneath.\n */\nexport const computeStickyTitleOffsets = (\n  rows: readonly number[],\n  getRowHeight: (row: number) => number | undefined,\n): number[] => {\n  const offsets: number[] = [];\n  let offset = 0;\n\n  rows.forEach((row) => {\n    offsets.push(offset);\n    offset += Math.max(0, getRowHeight(row) ?? 0);\n  });\n\n  return offsets;\n};\n\n/** 吸顶克隆节点自带的高度（vrender 的 `attribute.height`，即该行行高）。 */\nconst readCellHeight = (node: unknown): number | undefined => {\n  const height = (node as { attribute?: { height?: unknown } } | undefined)?.attribute?.height;\n  return typeof height === 'number' && height > 0 ? height : undefined;\n};\n\n/**\n * 从吸顶克隆节点自身的高度推出整摞的 y 偏移。缺任何一个高度就返回 undefined ——\n * 只把缺失的那个当 0 会让它后面的节点全叠在同一位置，比原来的漂移更难查。\n */\nexport const computeStickyOffsetsFromCells = (\n  children: readonly unknown[],\n): number[] | undefined => {\n  const offsets: number[] = [];\n  let offset = 0;\n\n  for (const child of children) {\n    const height = readCellHeight(child);\n    if (height === undefined) return undefined;\n    offsets.push(offset);\n    offset += height;\n  }\n\n  return offsets;\n};\n\n/**\n * VTable positions sticky group titles in a shadow group above the body, but uses\n * a fixed 40px step (`y: 40 * i` in `plugins/list-tree-stick-cell.js`). Re-apply the\n * offsets computed from real row heights so the sticky stack lines up with the header\n * row and the body rows.\n *\n * Offsets come from the sticky clones' own heights: those nodes are already being\n * walked here, and their height *is* the row height, so this needs no read of the\n * plugin's private `showedTitleRows`. That field is only a fallback — if it ever\n * stops matching (`titleRows` is a stack, so nested groups stick several rows), the\n * geometry path keeps working instead of silently reverting to the 40px step.\n */\nexport const alignStickyGroupTitles = (table: any, background?: string): void => {\n  const roots = getStickyShadowRoots(table);\n\n  if (roots.length === 0) return;\n\n  // 兜底：吸顶节点没带高度时，才回去读插件的行号 + 行高表。\n  const rowOffsets = (count: number): number[] | undefined => {\n    const rows = getStickyTitleRows(table);\n    if (rows == null || rows.length === 0) return undefined;\n\n    const offsets = computeStickyTitleOffsets(rows, (row) => getRowHeight(table, row));\n    return offsets.length >= count ? offsets : undefined;\n  };\n  // vrender's forEachChildren stops when the callback returns a truthy value, so the\n  // collector must never leak Array#push's return value.\n  const childrenOf = (node: any): any[] => {\n    if (Array.isArray(node?.children)) return node.children;\n\n    const children: any[] = [];\n    node?.forEachChildren?.((child: any) => {\n      children.push(child);\n    });\n    return children;\n  };\n\n  roots.forEach((root) => {\n    childrenOf(root).forEach((colGroup) => {\n      const children = childrenOf(colGroup);\n      const offsets = computeStickyOffsetsFromCells(children) ?? rowOffsets(children.length);\n\n      if (offsets == null) return;\n\n      children.forEach((child, index) => {\n        const offset = offsets[index];\n        if (offset == null) return;\n        const attrs: { fill?: string; y: number } = { y: offset };\n        // VTable re-creates merged group titles outside of their merge range, so the\n        // background is lost and the sticky row looks transparent. Restore it here.\n        if (background != null) attrs.fill = background;\n        child.setAttributes?.(attrs);\n      });\n    });\n  });\n};\n\n/** Pick the grouped column that belongs to the given group level. */\nexport const getGroupByField = (groupBy: string | string[], level: number): string => {\n  const fields = Array.isArray(groupBy) ? groupBy : [groupBy];\n  return fields[level] ?? fields.at(-1) ?? '';\n};\n\n/** Count the leaf records under a group record (nested groups are traversed). */\nexport const countGroupRecords = (record: unknown): number => {\n  const children = (record as { children?: unknown[] } | undefined)?.children;\n  if (Array.isArray(children) === false) return 0;\n\n  return children.reduce<number>((total, child) => {\n    return total + (isGroupTitleRecord(child) ? countGroupRecords(child) : 1);\n  }, 0);\n};\n\nexport interface CreateGroupTitleTagLayoutOptions {\n  colors?: Record<string, string | undefined>;\n  columns?: ReadonlyArray<{ field?: unknown; options?: TableSelectOption[] }>;\n  groupBy: string | string[];\n}\n\nexport const createGroupTitleTagLayout =\n  ({ colors, columns, groupBy }: CreateGroupTitleTagLayoutOptions): ICustomLayoutFuc =>\n  (args) => {\n    const palette = getCanvasPalette(args.table);\n    const table = args.table as any;\n    const row = args.row ?? 0;\n    const col = args.col ?? 0;\n    const width = args.rect?.width ?? 240;\n    const height = args.rect?.height ?? 40;\n    const record = table?.getCellOriginRecord?.(0, row);\n    const label = record?.vtableMergeName == null ? '' : String(record.vtableMergeName);\n    const level = getGroupTitleLevel(table, col, row);\n    const field = getGroupByField(groupBy, level);\n    const column = columns?.find((item) => item.field === field);\n    const option = resolveOption(record?.vtableMergeName, column?.options);\n    const isDark = palette.isDarkMode;\n    const tone = toneFor(option.value, option.color, isDark, palette.checkboxBg);\n    const customColor = colors?.[label];\n    // 自定义颜色也**吸附进 tone 调色板**再取浅底：直接拿它当背景会「颜色太重」（demo 的\n    // stageColors 是中等浅色，普通 chip 的底是 95% 亮度的浅底），与其它标题观感不一致。\n    const background = customColor\n      ? toneFor(option.value, customColor, isDark, palette.checkboxBg).bg\n      : tone.bg;\n    // 样式与普通 chip 同口径：浅色用主题文字色、暗色用 tone 的提亮色；描边只在暗色 tone 给\n    // `border` 时才有 —— 不再兜底 tone.color（那会画成彩色描边，和普通 chip 观感两套）。\n    // 「共 N 个」画在 chip **外面**（N = 叶子记录数），是 chip 后的标注，不参与 chip 配色。\n    const count = countGroupRecords(record);\n    const suffix = count > 0 ? `共${count}个` : '';\n    const chipHeight = 24;\n    const chipTop = Math.max(0, (height - chipHeight) / 2);\n    const chipLeft = GROUP_TITLE_CHIP_INSET + getGroupTitleIndent(table, level);\n    // Deliberately not paintUtils.measureLabelWidth: that model is per-script (CJK at\n    // fontSize, ASCII at 0.58x) and tuned for 20px tag chips, whereas a group title is a\n    // taller 24px chip whose label is nearly always CJK. This per-character estimate stays\n    // generous — it overshoots rather than clips — so do not \"fix\" it into the shared model.\n    const estimate = (text: string): number => text.length * 15 + 24;\n    // …但**「宁可超出」只对度量本身成立，不能让 chip 越过单元格**：窄表（表宽 − 序号列 ≈ 264）\n    // 遇上长分组名时，chip 和标签一起顶出表格右缘被画布硬切，文字断在半个字上且没有省略号。\n    // 按可用宽度收口（「共N个」标注也要占位），截断仍走各自的估算法（不切进共享模型）。\n    const suffixWidth = suffix === '' ? 0 : estimate(suffix) + 8;\n    const available = Math.max(64, width - chipLeft - GROUP_TITLE_CHIP_INSET - suffixWidth);\n    const fitted = fitLabel(label, available, estimate);\n    const chipWidth = Math.min(Math.max(64, estimate(fitted)), available);\n    const root = new CustomLayout.Group({ height, pickable: false, width });\n\n    root.add(\n      new CustomLayout.Rect({\n        cornerRadius: 6,\n        fill: background,\n        height: chipHeight,\n        lineWidth: tone.border ? 1 : 0,\n        pickable: false,\n        stroke: tone.border,\n        width: chipWidth,\n        x: chipLeft,\n        y: chipTop,\n      }),\n    );\n    root.add(\n      new CustomLayout.Text({\n        fontFamily: palette.fontFamily,\n        fill: isDark ? tone.color : palette.text,\n        fontSize: 13,\n        pickable: false,\n        text: fitted,\n        textAlign: 'left',\n        textBaseline: 'top',\n        x: chipLeft + 10,\n        y: chipTop + 4,\n      }),\n    );\n\n    if (suffix !== '') {\n      root.add(\n        new CustomLayout.Text({\n          fontFamily: palette.fontFamily,\n          fill: palette.textMuted,\n          fontSize: 12,\n          pickable: false,\n          text: suffix,\n          textAlign: 'left',\n          textBaseline: 'top',\n          x: chipLeft + chipWidth + 8,\n          y: chipTop + 5,\n        }),\n      );\n    }\n\n    return {\n      enableCellPadding: false,\n      renderDefault: true,\n      rootContainer: root,\n    };\n  };\n"],"mappings":"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"}

package/es/Table/canvas/paintUtils.mjs

@@ -0,0 +1,70 @@
+"use client";
+/**
+* 可编辑格要给右侧铅笔让出一条槽。画布与 DOM 悬停浮层共用；不可编辑 / 读不到列定义时为 0。
+*
+* 放在 paintUtils（而不是 chipPainters）是为了让 textPainters 也能用，且不跟 chipPainters
+* 形成环（chipPainters → textPainters → …）。
+*/
+const editHintGutterFor = (table, col, row) => {
+	if (table == null || col == null || row == null) return 0;
+	return (table.getBodyColumnDefine?.(col, row))?.superadEditable === true ? 28 : 0;
+};
+const measureLabelWidth = (label, fontSize = 12) => {
+	let width = 0;
+	for (const char of label) width += (char.codePointAt(0) ?? 0) > 255 ? fontSize : Math.round(fontSize * .58);
+	return width;
+};
+const measureTagWidth = (label) => 28 + measureLabelWidth(label, 13);
+/** 「+N」徽标的宽度。 */
+const measureOverflowBadgeWidth = (label) => 16 + measureLabelWidth(label, 13);
+/** 数组 chip 的宽度。与 painter 的绘制、浮层的命中区共用一份。 */
+const measureArrayChipWidth = (label) => 28 + measureLabelWidth(label, 13);
+/** 链接 pill 的宽度。同上。 */
+const measureLinkPillWidth = (label) => 28 + measureLabelWidth(label, 13);
+const packItems = (widths, available, overflowWidth) => {
+	if (widths.length === 0) return {
+		overflow: 0,
+		visible: 0
+	};
+	let visible = 0;
+	let used = 0;
+	for (let index = 0; index < widths.length; index += 1) {
+		const rest = widths.length - index - 1;
+		const next = used + (visible > 0 ? 4 : 0) + (widths[index] ?? 0);
+		const reserved = rest > 0 ? 4 + overflowWidth(rest) : 0;
+		if (visible > 0 && next + reserved > available) break;
+		used = next;
+		visible += 1;
+	}
+	if (visible === 0) visible = 1;
+	return {
+		overflow: widths.length - visible,
+		visible
+	};
+};
+/**
+* 把标签截到能放进 `maxWidth` 为止（末尾加省略号）。
+*
+* `packItems` 保证「至少画一个」—— 单个超长值因此会无上限越界，而自定义容器没有 clip，
+* 会盖到相邻单元格上。`widthOf` 由调用方给，因为各 painter 的 chip 宽度模型不同
+* （tag / user / link / array 各自不同）。
+*/
+const fitLabel = (label, maxWidth, widthOf) => {
+	if (widthOf(label) <= maxWidth) return label;
+	const ellipsis = "…";
+	const chars = [...label];
+	let cut = chars.length;
+	while (cut > 1 && widthOf(`${chars.slice(0, cut).join("")}${ellipsis}`) > maxWidth) cut -= 1;
+	return `${chars.slice(0, cut).join("")}${ellipsis}`;
+};
+/**
+* 「+N」徽标占的宽度（含它与前一枚 chip 之间的间距）。
+*
+* 四个 chip 布局的 `packItems` 只在**第二枚起**才把徽标算进预算，于是「首枚 chip 就被截断」
+* 的那种值会把徽标顶出单元格 —— 自定义容器没有 clip，出格就是盖住邻格。截断首枚时先减掉它。
+*/
+const overflowBadgeWidth = (overflow) => overflow > 0 ? 4 + measureLabelWidth(`+${overflow}`, 13) : 0;
+//#endregion
+export { editHintGutterFor, fitLabel, measureArrayChipWidth, measureLabelWidth, measureLinkPillWidth, measureOverflowBadgeWidth, measureTagWidth, overflowBadgeWidth, packItems };
+
+//# sourceMappingURL=paintUtils.mjs.map

package/es/Table/canvas/paintUtils.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"paintUtils.mjs","names":[],"sources":["../../../src/Table/canvas/paintUtils.ts"],"sourcesContent":["'use client';\n\nexport const TAG_GAP = 4;\n/**\n * 悬停时盖在 chip 右端的移除按钮占位（12px 按钮 + 1px 外边距）。\n *\n * 它是 chip 内边距的**下界**，不是内边距之外另加的一截：外加会让未悬停时右侧空一块、文字\n * 视觉偏左；反过来把内边距收到它以下，× 就压在最后一个字上（× 底透明、笔画近黑，叠在深色\n * 字上等于没画）。人员 chip 自己一套，见 `USER_CHIP_TRAILING`。\n */\nexport const CHIP_REMOVE_ROOM = 13;\n/**\n * chip 文字的水平内边距。**左右相同**，且比 `CHIP_REMOVE_ROOM` 多 1px —— × 整颗落在右内边距\n * 里，笔画（10px 图标里 8px 墨迹居中）与文字之间还剩 3px。\n */\nexport const CHIP_PAD = CHIP_REMOVE_ROOM + 1;\n/** 标签文字左侧的内边距。 */\nexport const TAG_PAD_LEFT = CHIP_PAD;\n/** 标签文字右侧的内边距。与左侧对称。 */\nexport const TAG_PAD_RIGHT = CHIP_PAD;\n/**\n * chip 的水平内边距合计。度量 / 打包 / 截断都按它算。\n *\n * demo 标签列 176（可用 160，减去铅笔槽 28 后 132）：2 字 chip = 26 + 28 = 54；\n * `54 + 4 + 徽标 35 = 93 ≤ 132`，第二枚要 `2×54 + 4 + 35 = 143 > 132` 放不下。\n */\nexport const TAG_PAD_X = TAG_PAD_LEFT + TAG_PAD_RIGHT;\n/**\n * 「+N」徽标的水平内边距。徽标上没有 ×，因此不受 `CHIP_REMOVE_ROOM` 下界约束，用更紧的一档 ——\n * 它是计数标注，撑到跟 chip 一样宽会抢走本来能多放一枚 chip 的位置。\n */\nexport const BADGE_PAD_X = 16;\n/** 数组 chip 的左右内边距。 */\nexport const ARRAY_PAD_LEFT = CHIP_PAD;\nexport const ARRAY_PAD_RIGHT = CHIP_PAD;\n/** 链接 pill 的左右内边距。 */\nexport const LINK_PAD_LEFT = CHIP_PAD;\nexport const LINK_PAD_RIGHT = CHIP_PAD;\n/**\n * 可编辑格右侧留给铅笔按钮的槽（24 按钮 + 4 内边距）。\n *\n * 画布打包与 hover 浮层**必须共用**这个值，否则铅笔会盖在最后一枚 chip / 文字上。\n */\nexport const EDIT_HINT_GUTTER = 28;\n\n/**\n * 可编辑格要给右侧铅笔让出一条槽。画布与 DOM 悬停浮层共用；不可编辑 / 读不到列定义时为 0。\n *\n * 放在 paintUtils（而不是 chipPainters）是为了让 textPainters 也能用，且不跟 chipPainters\n * 形成环（chipPainters → textPainters → …）。\n */\nexport const editHintGutterFor = (\n  table: { getBodyColumnDefine?: (col: number, row: number) => unknown } | undefined,\n  col: number | undefined,\n  row: number | undefined,\n): number => {\n  if (table == null || col == null || row == null) return 0;\n  const define = table.getBodyColumnDefine?.(col, row) as { superadEditable?: boolean } | undefined;\n  return define?.superadEditable === true ? EDIT_HINT_GUTTER : 0;\n};\n/**\n * tag chip 的文字字号。**度量与渲染必须用同一个值**：度量走默认的 12、渲染写 13 时，\n * `8 + 13n > 16 + 12n` 在 n > 8 就成立 —— ≥9 个全角字符的标签文字会伸出胶囊压到邻格上\n * （chip 间距只有 4）。\n */\nexport const TAG_FONT_SIZE = 13;\n\nexport const measureLabelWidth = (label: string, fontSize = 12): number => {\n  let width = 0;\n  for (const char of label) {\n    width += (char.codePointAt(0) ?? 0) > 255 ? fontSize : Math.round(fontSize * 0.58);\n  }\n  return width;\n};\n\nexport const measureTagWidth = (label: string): number =>\n  TAG_PAD_X + measureLabelWidth(label, TAG_FONT_SIZE);\n\n/** 「+N」徽标的宽度。 */\nexport const measureOverflowBadgeWidth = (label: string): number =>\n  BADGE_PAD_X + measureLabelWidth(label, TAG_FONT_SIZE);\n\n/** 数组 chip 的宽度。与 painter 的绘制、浮层的命中区共用一份。 */\nexport const measureArrayChipWidth = (label: string): number =>\n  ARRAY_PAD_LEFT + ARRAY_PAD_RIGHT + measureLabelWidth(label, TAG_FONT_SIZE);\n\n/** 链接 pill 的宽度。同上。 */\nexport const measureLinkPillWidth = (label: string): number =>\n  LINK_PAD_LEFT + LINK_PAD_RIGHT + measureLabelWidth(label, TAG_FONT_SIZE);\n\nexport const packItems = (\n  widths: number[],\n  available: number,\n  overflowWidth: (rest: number) => number,\n): { overflow: number; visible: number } => {\n  if (widths.length === 0) return { overflow: 0, visible: 0 };\n\n  let visible = 0;\n  let used = 0;\n  for (let index = 0; index < widths.length; index += 1) {\n    const rest = widths.length - index - 1;\n    const next = used + (visible > 0 ? TAG_GAP : 0) + (widths[index] ?? 0);\n    const reserved = rest > 0 ? TAG_GAP + overflowWidth(rest) : 0;\n    if (visible > 0 && next + reserved > available) break;\n    used = next;\n    visible += 1;\n  }\n\n  if (visible === 0) visible = 1;\n  return { overflow: widths.length - visible, visible };\n};\n\n/**\n * 把标签截到能放进 `maxWidth` 为止（末尾加省略号）。\n *\n * `packItems` 保证「至少画一个」—— 单个超长值因此会无上限越界，而自定义容器没有 clip，\n * 会盖到相邻单元格上。`widthOf` 由调用方给，因为各 painter 的 chip 宽度模型不同\n * （tag / user / link / array 各自不同）。\n */\nexport const fitLabel = (\n  label: string,\n  maxWidth: number,\n  widthOf: (label: string) => number,\n): string => {\n  if (widthOf(label) <= maxWidth) return label;\n\n  const ellipsis = '…';\n  // **按码点退格，不是按 UTF-16 码元。** `'😀'.length` 是 2：按码元切会切出孤立代理项，\n  // 画布上是一个替换字形（tofu）加省略号，而且 `measureLabelWidth` 会把它当宽字符多算一格。\n  const chars = [...label];\n  let cut = chars.length;\n  while (cut > 1 && widthOf(`${chars.slice(0, cut).join('')}${ellipsis}`) > maxWidth) {\n    cut -= 1;\n  }\n  return `${chars.slice(0, cut).join('')}${ellipsis}`;\n};\n\n/**\n * 「+N」徽标占的宽度（含它与前一枚 chip 之间的间距）。\n *\n * 四个 chip 布局的 `packItems` 只在**第二枚起**才把徽标算进预算，于是「首枚 chip 就被截断」\n * 的那种值会把徽标顶出单元格 —— 自定义容器没有 clip，出格就是盖住邻格。截断首枚时先减掉它。\n */\nexport const overflowBadgeWidth = (overflow: number): number =>\n  overflow > 0 ? TAG_GAP + measureLabelWidth(`+${overflow}`, TAG_FONT_SIZE) : 0;\n"],"mappings":";;;;;;;AAmDA,MAAa,qBACX,OACA,KACA,QACW;CACX,IAAI,SAAS,QAAQ,OAAO,QAAQ,OAAO,MAAM,OAAO;CAExD,QADe,MAAM,sBAAsB,KAAK,GAAG,EAAA,EACpC,oBAAoB,OAAA,KAA0B;AAC/D;AAQA,MAAa,qBAAqB,OAAe,WAAW,OAAe;CACzE,IAAI,QAAQ;CACZ,KAAK,MAAM,QAAQ,OACjB,UAAU,KAAK,YAAY,CAAC,KAAK,KAAK,MAAM,WAAW,KAAK,MAAM,WAAW,GAAI;CAEnF,OAAO;AACT;AAEA,MAAa,mBAAmB,UAAA,KAClB,kBAAkB,OAAA,EAAoB;;AAGpD,MAAa,6BAA6B,UAAA,KAC1B,kBAAkB,OAAA,EAAoB;;AAGtD,MAAa,yBAAyB,UACpC,KAAmC,kBAAkB,OAAA,EAAoB;;AAG3E,MAAa,wBAAwB,UACnC,KAAiC,kBAAkB,OAAA,EAAoB;AAEzE,MAAa,aACX,QACA,WACA,kBAC0C;CAC1C,IAAI,OAAO,WAAW,GAAG,OAAO;EAAE,UAAU;EAAG,SAAS;CAAE;CAE1D,IAAI,UAAU;CACd,IAAI,OAAO;CACX,KAAK,IAAI,QAAQ,GAAG,QAAQ,OAAO,QAAQ,SAAS,GAAG;EACrD,MAAM,OAAO,OAAO,SAAS,QAAQ;EACrC,MAAM,OAAO,QAAQ,UAAU,IAAA,IAAc,MAAM,OAAO,UAAU;EACpE,MAAM,WAAW,OAAO,IAAA,IAAc,cAAc,IAAI,IAAI;EAC5D,IAAI,UAAU,KAAK,OAAO,WAAW,WAAW;EAChD,OAAO;EACP,WAAW;CACb;CAEA,IAAI,YAAY,GAAG,UAAU;CAC7B,OAAO;EAAE,UAAU,OAAO,SAAS;EAAS;CAAQ;AACtD;;;;;;;;AASA,MAAa,YACX,OACA,UACA,YACW;CACX,IAAI,QAAQ,KAAK,KAAK,UAAU,OAAO;CAEvC,MAAM,WAAW;CAGjB,MAAM,QAAQ,CAAC,GAAG,KAAK;CACvB,IAAI,MAAM,MAAM;CAChB,OAAO,MAAM,KAAK,QAAQ,GAAG,MAAM,MAAM,GAAG,GAAG,CAAC,CAAC,KAAK,EAAE,IAAI,UAAU,IAAI,UACxE,OAAO;CAET,OAAO,GAAG,MAAM,MAAM,GAAG,GAAG,CAAC,CAAC,KAAK,EAAE,IAAI;AAC3C;;;;;;;AAQA,MAAa,sBAAsB,aACjC,WAAW,IAAA,IAAc,kBAAkB,IAAI,YAAA,EAAyB,IAAI"}

package/es/Table/canvas/rowSeries.mjs

@@ -0,0 +1,130 @@
+"use client";
+import { getCanvasPalette } from "./canvasPalette.mjs";
+import { getInternalProps, getScenegraph, getStateManager, getVisibleRowRange, updateCellContent, updateCellContentRange } from "../vtable/vtableAdapter.mjs";
+import { getCascadeRowSelection, isFullRowSelected } from "../core/rowSelection.mjs";
+import { getCascadeHeaderState, getRowCheckboxState, isGroupTitleRow, resolveRowSeriesValue } from "../vtable/seriesSelection.mjs";
+import { drawSeriesCheckbox } from "./controlPainters.mjs";
+import { CustomLayout } from "@visactor/vtable";
+const seriesContentX = (width, showDrag) => showDrag ? 16 + (width - 16) / 2 : width / 2;
+const createRowSeriesLayout = (showIndex = true, showSelection = true, showDrag = false) => (args) => {
+	const palette = getCanvasPalette(args.table);
+	const width = args.rect?.width ?? 56;
+	const height = args.rect?.height ?? 40;
+	const table = args.table;
+	const row = args.row ?? 0;
+	const root = new CustomLayout.Group({
+		height,
+		pickable: false,
+		width
+	});
+	const groupTitleRow = isGroupTitleRow(table, row);
+	const endCol = (table?.colCount ?? 1) - 1;
+	const ranges = getStateManager(table)?.select?.ranges ?? [];
+	const cascadeSelection = Boolean(getInternalProps(table)?.enableCheckboxCascade);
+	const recordState = cascadeSelection ? getRowCheckboxState(table, row) : void 0;
+	const rangeChecked = isFullRowSelected(ranges, row, endCol);
+	const checked = cascadeSelection ? recordState === true : rangeChecked;
+	let indeterminate;
+	if (cascadeSelection) indeterminate = recordState === "indeterminate";
+	else {
+		const cascade = getCascadeRowSelection(table, row, ranges, endCol);
+		indeterminate = cascade ? cascade.selectedCount > 0 && cascade.selectedCount < cascade.total : false;
+	}
+	const hovered = getStateManager(table)?.hover?.cellPos?.row === row;
+	const showIndexValue = showIndex && groupTitleRow === false;
+	const showCheckbox = showSelection && (showIndex === false || hovered || checked || indeterminate);
+	const centerX = seriesContentX(width, showDrag);
+	const centerY = height / 2;
+	if (showCheckbox) drawSeriesCheckbox(root, centerX, centerY, 16, checked, indeterminate, palette);
+	else if (showIndexValue) root.add(new CustomLayout.Text({
+		fontFamily: palette.fontFamily,
+		fill: palette.text,
+		fontSize: 14,
+		pickable: false,
+		text: String(resolveRowSeriesValue(table, row)),
+		textAlign: "center",
+		textBaseline: "middle",
+		x: centerX,
+		y: centerY
+	}));
+	return {
+		enableCellPadding: false,
+		renderDefault: showDrag,
+		rootContainer: root
+	};
+};
+const createRowSeriesHeaderLayout = (showIndex = false, showDrag = false) => (args) => {
+	const palette = getCanvasPalette(args.table);
+	const width = args.rect?.width ?? 56;
+	const height = args.rect?.height ?? 40;
+	const table = args.table;
+	const row = args.row ?? 0;
+	const root = new CustomLayout.Group({
+		height,
+		pickable: false,
+		width
+	});
+	const startRow = table?.columnHeaderLevelCount ?? 1;
+	const endRow = (table?.rowCount ?? 1) - 1;
+	const endCol = (table?.colCount ?? 1) - 1;
+	const ranges = getStateManager(table)?.select?.ranges ?? [];
+	const cascadeSelection = Boolean(getInternalProps(table)?.enableCheckboxCascade);
+	let selectedCount = 0;
+	if (cascadeSelection === false) {
+		for (let cursor = startRow; cursor <= endRow; cursor += 1) if (isFullRowSelected(ranges, cursor, endCol)) selectedCount += 1;
+	}
+	const total = endRow - startRow + 1;
+	const cascadeState = cascadeSelection ? getCascadeHeaderState(table) : void 0;
+	const checked = cascadeSelection ? cascadeState === true : total > 0 && selectedCount === total;
+	const partiallySelected = cascadeSelection ? cascadeState === "indeterminate" : selectedCount > 0 && checked === false;
+	const hovered = getStateManager(table)?.hover?.cellPos?.row === row;
+	const hoverScope = getStateManager(table)?.hover?.highlightScope ?? "row";
+	const hoverCol = getStateManager(table)?.hover?.cellPos?.col;
+	if (hovered && (hoverScope === "row" || hoverScope === "cross" || (hoverScope === "single" || hoverScope === "column") && hoverCol === 0)) root.add(new CustomLayout.Rect({
+		fill: palette.rowHover,
+		height,
+		pickable: false,
+		width,
+		x: 0,
+		y: 0
+	}));
+	const centerX = seriesContentX(width, showDrag);
+	const centerY = Math.min(height, table?.getRowHeight?.(row) ?? height) / 2;
+	if (showIndex && hovered === false && (checked || partiallySelected) === false) root.add(new CustomLayout.Text({
+		fontFamily: palette.fontFamily,
+		fill: palette.textAux,
+		fontSize: 13,
+		fontWeight: 500,
+		pickable: false,
+		text: "序号",
+		textAlign: "center",
+		textBaseline: "middle",
+		x: centerX,
+		y: centerY
+	}));
+	else drawSeriesCheckbox(root, centerX, centerY, 16, checked, partiallySelected, palette);
+	return {
+		enableCellPadding: false,
+		renderDefault: false,
+		rootContainer: root
+	};
+};
+/** Re-render the canvas row-series cells of the visible range. */
+const refreshVisibleRowSeriesCells = (table) => {
+	const { endRow, startRow } = getVisibleRowRange(table);
+	updateCellContent(table, 0, 0);
+	if (endRow < startRow) return;
+	updateCellContentRange(table, 0, startRow, 0, endRow);
+	getScenegraph(table).updateNextFrame?.();
+};
+/** Re-render the previously and newly hovered row-series cells. */
+const refreshRowSeriesHover = (table, previous, nextRow) => {
+	if (previous === nextRow) return;
+	if (previous != null && previous >= 0) updateCellContent(table, 0, previous);
+	if (nextRow >= 0) updateCellContent(table, 0, nextRow);
+	getScenegraph(table).updateNextFrame?.();
+};
+//#endregion
+export { createRowSeriesHeaderLayout, createRowSeriesLayout, refreshRowSeriesHover, refreshVisibleRowSeriesCells };
+
+//# sourceMappingURL=rowSeries.mjs.map

package/es/Table/canvas/rowSeries.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"rowSeries.mjs","names":[],"sources":["../../../src/Table/canvas/rowSeries.ts"],"sourcesContent":["'use client';\n\nimport { CustomLayout, type ListTable } from '@visactor/vtable';\nimport type { ICustomLayoutFuc } from '@visactor/vtable/es/ts-types/customLayout';\n\nimport { getCascadeRowSelection, isFullRowSelected } from '../core/rowSelection';\nimport {\n  getCascadeHeaderState,\n  getRowCheckboxState,\n  isGroupTitleRow,\n  resolveRowSeriesValue,\n} from '../vtable/seriesSelection';\nimport {\n  getInternalProps,\n  getScenegraph,\n  getStateManager,\n  getVisibleRowRange,\n  updateCellContent,\n  updateCellContentRange,\n} from '../vtable/vtableAdapter';\nimport { getCanvasPalette } from './canvasPalette';\nimport { drawSeriesCheckbox } from './controlPainters';\n\n/** VTable `dragReorder` 图标占的左槽。序号 / 复选框画在右边，避免盖住原生手柄。 */\nexport const SERIES_DRAG_SLOT = 16;\n\nconst seriesContentX = (width: number, showDrag: boolean) =>\n  showDrag ? SERIES_DRAG_SLOT + (width - SERIES_DRAG_SLOT) / 2 : width / 2;\n\nexport const createRowSeriesLayout =\n  (showIndex = true, showSelection = true, showDrag = false): ICustomLayoutFuc =>\n  (args) => {\n    const palette = getCanvasPalette(args.table);\n    const width = args.rect?.width ?? 56;\n    const height = args.rect?.height ?? 40;\n    const table = args.table as any;\n    const row = args.row ?? 0;\n    const root = new CustomLayout.Group({ height, pickable: false, width });\n    const groupTitleRow = isGroupTitleRow(table, row);\n    const endCol = (table?.colCount ?? 1) - 1;\n    const ranges = getStateManager(table)?.select?.ranges ?? [];\n    const cascadeSelection = Boolean(getInternalProps(table)?.enableCheckboxCascade);\n    const recordState = cascadeSelection ? getRowCheckboxState(table, row) : undefined;\n    const rangeChecked = isFullRowSelected(ranges, row, endCol);\n    const checked = cascadeSelection ? recordState === true : rangeChecked;\n    // 级联模式（`createTableOption` 里恒为 `?? true`）下这个分支根本不会被读到，而\n    // `getCascadeRowSelection` 是一次 O(行数) 的全表遍历（按 ranges 内容缓存），所以**惰性求值**：\n    // 无条件算等于每张分组/树表在每次 ranges 变化后都白跑一次。平铺表上它会早退，\n    // 百万行性能基线因此看不见这项开销。\n    let indeterminate: boolean;\n    if (cascadeSelection) {\n      indeterminate = recordState === 'indeterminate';\n    } else {\n      const cascade = getCascadeRowSelection(table, row, ranges, endCol);\n      indeterminate = cascade\n        ? cascade.selectedCount > 0 && cascade.selectedCount < cascade.total\n        : false;\n    }\n    const hovered = getStateManager(table)?.hover?.cellPos?.row === row;\n    // Do not paint a hover background for body rows. VTable already styles them: this\n    // column's body cells classify as row-header cells and take theme.rowHeaderStyle.hover.\n    // Adding a translucent rowHover rect on top stacked a second layer and made this one\n    // cell visibly darker — rgb(239,239,239) against rgb(247,247,247) for the rest of the\n    // row. The header cell is the exception; see createRowSeriesHeaderLayout.\n\n    const showIndexValue = showIndex && groupTitleRow === false;\n    // 序号模式下**分组行平时什么也不画**（没有行号可显示，也不常驻一个空复选框 —— 那样整列\n    // 看起来全是待选框，而数据行平时显示的是行号），鼠标移到这一行才出现。数据行同理：平时\n    // 是行号，hover / 已选 / 半选时换成复选框。不显示序号列时这一列本来只有复选框，常驻。\n    const showCheckbox =\n      showSelection && (showIndex === false || hovered || checked || indeterminate);\n    const centerX = seriesContentX(width, showDrag);\n    const centerY = height / 2;\n\n    if (showCheckbox) {\n      drawSeriesCheckbox(root, centerX, centerY, 16, checked, indeterminate, palette);\n    } else if (showIndexValue) {\n      root.add(\n        new CustomLayout.Text({\n          fontFamily: palette.fontFamily,\n          // 用 `text` 而不是 `textMuted`：序号列此前比同行的数据文字浅一大截\n          // （亮色 #999999 对白底 2.85:1、暗色 #6f6f6f 对 #0d0d0d 3.92:1，都不足 AA）。\n          // 数据列走 `createCanvasTextLayout` 的 `fill: palette.text`，这里与它保持一致。\n          fill: palette.text,\n          // 与 `option.ts` 里这一列的 `style.fontSize` 一致；painter 接管单元格后 VTable 的样式\n          // 不再生效，两边写不一样就会让序号比同行的数据文字小一号。\n          fontSize: 14,\n          pickable: false,\n          text: String(resolveRowSeriesValue(table, row)),\n          textAlign: 'center',\n          textBaseline: 'middle',\n          x: centerX,\n          y: centerY,\n        } as never),\n      );\n    }\n\n    // 行拖拽时 `renderDefault: true`：VTable 只在默认渲染里画 `dragOrder` 手柄。\n    // 我们自己画序号 / 复选框，`format` 交空串，避免和默认文字叠两套数字。\n    return { enableCellPadding: false, renderDefault: showDrag, rootContainer: root };\n  };\n\nexport const createRowSeriesHeaderLayout =\n  (showIndex = false, showDrag = false): ICustomLayoutFuc =>\n  (args) => {\n    const palette = getCanvasPalette(args.table);\n    const width = args.rect?.width ?? 56;\n    const height = args.rect?.height ?? 40;\n    const table = args.table as any;\n    const row = args.row ?? 0;\n    const root = new CustomLayout.Group({ height, pickable: false, width });\n    const startRow = table?.columnHeaderLevelCount ?? 1;\n    const endRow = (table?.rowCount ?? 1) - 1;\n    const endCol = (table?.colCount ?? 1) - 1;\n    const ranges = getStateManager(table)?.select?.ranges ?? [];\n    const cascadeSelection = Boolean(getInternalProps(table)?.enableCheckboxCascade);\n    let selectedCount = 0;\n\n    if (cascadeSelection === false) {\n      for (let cursor = startRow; cursor <= endRow; cursor += 1) {\n        if (isFullRowSelected(ranges, cursor, endCol)) selectedCount += 1;\n      }\n    }\n\n    const total = endRow - startRow + 1;\n    const cascadeState = cascadeSelection ? getCascadeHeaderState(table) : undefined;\n    const checked = cascadeSelection ? cascadeState === true : total > 0 && selectedCount === total;\n    const partiallySelected = cascadeSelection\n      ? cascadeState === 'indeterminate'\n      : selectedCount > 0 && checked === false;\n    const hovered = getStateManager(table)?.hover?.cellPos?.row === row;\n    const hoverScope = getStateManager(table)?.hover?.highlightScope ?? 'row';\n    const hoverCol = getStateManager(table)?.hover?.cellPos?.col;\n    const hoverCoversRow = hoverScope === 'row' || hoverScope === 'cross';\n    const hoverCoversSeriesCell =\n      (hoverScope === 'single' || hoverScope === 'column') && hoverCol === 0;\n\n    // This painter has to draw the hover background itself, unlike the body layout.\n    // VTable picks a hover style by cell kind (@visactor/vtable state/hover/is-cell-hover.js):\n    // corner header, column header, row header, frozen rows/columns, then a final\n    // `isHeader(col, row) || (hoverStyle = theme.bodyStyle.hover)` branch. That `||`\n    // short-circuits, so any cell that is a header but matched none of the earlier kinds\n    // ends up with hoverStyle undefined and gets no hover at all. This cell is that case:\n    // no theme hook reaches it — theme.rowHeaderStyle.hover, theme.cornerHeaderStyle.hover\n    // and this column's own headerStyle.hover were each tested and none of them tint it.\n    if (hovered && (hoverCoversRow || hoverCoversSeriesCell)) {\n      root.add(\n        new CustomLayout.Rect({\n          fill: palette.rowHover,\n          height,\n          pickable: false,\n          width,\n          x: 0,\n          y: 0,\n        } as never),\n      );\n    }\n\n    const centerX = seriesContentX(width, showDrag);\n    // **不能按 `rect.height` 居中。** 表头是多级时这一格是**跨行合并**的（百万数据 demo 的\n    // `full name` 分组让表头变成两行，行号列因此合并 0–1 行）：`rect.height` 是合并后的\n    // 72，而引擎给每一行各建一个 36 高的节点、各跑一次这个 layout。居中的 16px 框正好落在\n    // 两行的接缝上 —— 上半截留在第一行的节点里，下半截被第二行盖掉，看上去就是个空框。\n    // 按本行高度居中，框始终完整落在自己那一行内；单级表头两值相等，行为不变。\n    const centerY = Math.min(height, table?.getRowHeight?.(row) ?? height) / 2;\n    const showIndexValue =\n      showIndex && hovered === false && (checked || partiallySelected) === false;\n\n    if (showIndexValue) {\n      root.add(\n        new CustomLayout.Text({\n          fontFamily: palette.fontFamily,\n          fill: palette.textAux,\n          fontSize: 13,\n          // `option.ts` 的 `headerStyle.fontWeight` 是 500；painter 接管后要自己带上，\n          // 否则表头「序号」比同行的其他表头文字细。\n          fontWeight: 500,\n          pickable: false,\n          text: '序号',\n          textAlign: 'center',\n          textBaseline: 'middle',\n          x: centerX,\n          y: centerY,\n        } as never),\n      );\n    } else {\n      drawSeriesCheckbox(root, centerX, centerY, 16, checked, partiallySelected, palette);\n    }\n\n    return { enableCellPadding: false, renderDefault: false, rootContainer: root };\n  };\n\n/** Re-render the canvas row-series cells of the visible range. */\nexport const refreshVisibleRowSeriesCells = (table: ListTable): void => {\n  const { endRow, startRow } = getVisibleRowRange(table);\n\n  updateCellContent(table, 0, 0);\n  if (endRow < startRow) return;\n  updateCellContentRange(table, 0, startRow, 0, endRow);\n  getScenegraph(table).updateNextFrame?.();\n};\n\n/** Re-render the previously and newly hovered row-series cells. */\nexport const refreshRowSeriesHover = (\n  table: ListTable,\n  previous: number | null,\n  nextRow: number,\n): void => {\n  if (previous === nextRow) return;\n\n  if (previous != null && previous >= 0) updateCellContent(table, 0, previous);\n  if (nextRow >= 0) updateCellContent(table, 0, nextRow);\n  getScenegraph(table).updateNextFrame?.();\n};\n"],"mappings":"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"}

package/es/Table/canvas/textPainters.mjs

@@ -0,0 +1,97 @@
+"use client";
+import { getCanvasPalette } from "./canvasPalette.mjs";
+import { emptyCellLabel, formatCurrency } from "../core/cellValue.mjs";
+import { editHintGutterFor } from "./paintUtils.mjs";
+import { tableText } from "../core/tableI18n.mjs";
+import { CustomLayout } from "@visactor/vtable";
+//#region src/Table/canvas/textPainters.ts
+/**
+* Empty-state placeholder text ("设置 X"). Every painter that can show a hint draws
+* the same node, so it lives here rather than being repeated per cell type.
+*/
+const createEmptyCellText = (placeholder, palette, height, table) => new CustomLayout.Text({
+	fontFamily: palette.fontFamily,
+	fill: palette.textMuted,
+	fontSize: 14,
+	pickable: false,
+	text: table != null ? tableText(table, placeholder ? "setField" : "set", { title: placeholder }) : emptyCellLabel(placeholder),
+	textAlign: "left",
+	textBaseline: "middle",
+	x: palette.paddingX,
+	y: height / 2
+});
+const createCanvasTextLayout = (options = {}) => (args) => {
+	const palette = getCanvasPalette(args.table);
+	const width = args.rect?.width ?? 120;
+	const height = args.rect?.height ?? 40;
+	const align = options.align ?? "left";
+	const root = new CustomLayout.Group({
+		height,
+		pickable: false,
+		width
+	});
+	const text = args.value == null ? "" : String(args.value);
+	const gutter = editHintGutterFor(args.table, args.col, args.row);
+	const contentWidth = Math.max(width - gutter, 1);
+	if (text) {
+		const paddingX = palette.paddingX;
+		const x = align === "center" ? contentWidth / 2 : align === "right" ? contentWidth - paddingX : paddingX;
+		root.add(new CustomLayout.Text({
+			fontFamily: palette.fontFamily,
+			ellipsis: true,
+			fill: options.color ?? palette.text,
+			fontSize: options.fontSize ?? 14,
+			fontWeight: options.fontWeight,
+			maxLineWidth: Math.max(0, contentWidth - paddingX * 2),
+			pickable: false,
+			text,
+			textAlign: align,
+			textBaseline: "middle",
+			x,
+			y: height / 2
+		}));
+	}
+	return {
+		enableCellPadding: false,
+		renderDefault: false,
+		rootContainer: root
+	};
+};
+const createCurrencyLayout = (currency = "¥", placeholder) => (args) => {
+	const palette = getCanvasPalette(args.table);
+	const width = args.rect?.width ?? 100;
+	const height = args.rect?.height ?? 40;
+	const text = formatCurrency(args.value, currency);
+	const empty = text === "";
+	const root = new CustomLayout.Group({
+		height,
+		pickable: false,
+		width
+	});
+	const gutter = editHintGutterFor(args.table, args.col, args.row);
+	const contentWidth = Math.max(width - gutter, 1);
+	if (empty) {
+		if (placeholder) root.add(createEmptyCellText(placeholder, palette, height, args.table));
+	} else root.add(new CustomLayout.Text({
+		fontFamily: palette.fontFamily,
+		ellipsis: true,
+		fill: palette.text,
+		fontSize: 13,
+		maxLineWidth: Math.max(0, contentWidth - palette.paddingX * 2),
+		pickable: false,
+		text,
+		textAlign: "right",
+		textBaseline: "middle",
+		x: contentWidth - palette.paddingX,
+		y: height / 2
+	}));
+	return {
+		enableCellPadding: false,
+		renderDefault: false,
+		rootContainer: root
+	};
+};
+//#endregion
+export { createCanvasTextLayout, createCurrencyLayout, createEmptyCellText };
+
+//# sourceMappingURL=textPainters.mjs.map

package/es/Table/canvas/textPainters.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"textPainters.mjs","names":[],"sources":["../../../src/Table/canvas/textPainters.ts"],"sourcesContent":["'use client';\n\nimport { CustomLayout } from '@visactor/vtable';\nimport type { ICustomLayoutFuc } from '@visactor/vtable/es/ts-types/customLayout';\n\nimport { emptyCellLabel, formatCurrency } from '../core/cellValue';\nimport { tableText } from '../core/tableI18n';\nimport { type CanvasPalette, getCanvasPalette } from './canvasPalette';\nimport { editHintGutterFor } from './paintUtils';\n\nexport interface CreateCanvasTextLayoutOptions {\n  align?: 'center' | 'left' | 'right';\n  color?: string;\n  fontSize?: number;\n  fontWeight?: number | string;\n}\n\n/**\n * Empty-state placeholder text (\"设置 X\"). Every painter that can show a hint draws\n * the same node, so it lives here rather than being repeated per cell type.\n */\nexport const createEmptyCellText = (\n  placeholder: string,\n  palette: CanvasPalette,\n  height: number,\n  table?: unknown,\n) =>\n  new CustomLayout.Text({\n    fontFamily: palette.fontFamily,\n    // 占位文字统一**弱色 + 与正文同字号**：空值占位有两条路径（这条 canvas 的，与 text /\n    // number / date 那些交回 VTable 原生渲染、用列样式的），两边的字号必须一样，否则同一张表里\n    // 「设置 名称」和「设置 状态」大小不一。颜色则两边都走弱色 —— 见 columns.ts 的 style。\n    fill: palette.textMuted,\n    fontSize: 14,\n    pickable: false,\n    text:\n      table != null\n        ? tableText(table, placeholder ? 'setField' : 'set', { title: placeholder })\n        : emptyCellLabel(placeholder),\n    textAlign: 'left',\n    textBaseline: 'middle',\n    x: palette.paddingX,\n    y: height / 2,\n  } as never);\n\nexport const createCanvasTextLayout =\n  (options: CreateCanvasTextLayoutOptions = {}): ICustomLayoutFuc =>\n  (args) => {\n    const palette = getCanvasPalette(args.table);\n    const width = args.rect?.width ?? 120;\n    const height = args.rect?.height ?? 40;\n    const align = options.align ?? 'left';\n    const root = new CustomLayout.Group({ height, pickable: false, width });\n    const text = args.value == null ? '' : String(args.value);\n    const gutter = editHintGutterFor(args.table as never, args.col, args.row);\n    const contentWidth = Math.max(width - gutter, 1);\n\n    if (text) {\n      const paddingX = palette.paddingX;\n      const x =\n        align === 'center'\n          ? contentWidth / 2\n          : align === 'right'\n            ? contentWidth - paddingX\n            : paddingX;\n\n      root.add(\n        new CustomLayout.Text({\n          fontFamily: palette.fontFamily,\n          ellipsis: true,\n          fill: options.color ?? palette.text,\n          fontSize: options.fontSize ?? 14,\n          fontWeight: options.fontWeight,\n          maxLineWidth: Math.max(0, contentWidth - paddingX * 2),\n          pickable: false,\n          text,\n          textAlign: align,\n          textBaseline: 'middle',\n          x,\n          y: height / 2,\n        } as never),\n      );\n    }\n\n    return { enableCellPadding: false, renderDefault: false, rootContainer: root };\n  };\n\nexport const createCurrencyLayout =\n  (currency = '¥', placeholder?: string): ICustomLayoutFuc =>\n  (args) => {\n    const palette = getCanvasPalette(args.table);\n    const width = args.rect?.width ?? 100;\n    const height = args.rect?.height ?? 40;\n    // 判空交给格式化函数。painter 里再判一次 `Number.isFinite` 会让 `formatCurrency` 的\n    // 「非有限数原样显示」分支永远到不了 —— 同一种脏数据（如 `待定`），`number` 列显示原文、\n    // `currency` 列显示占位符。两种类型的口径必须一致。\n    const text = formatCurrency(args.value, currency);\n    const empty = text === '';\n    const root = new CustomLayout.Group({ height, pickable: false, width });\n    const gutter = editHintGutterFor(args.table as never, args.col, args.row);\n    const contentWidth = Math.max(width - gutter, 1);\n\n    if (empty) {\n      if (placeholder) {\n        root.add(createEmptyCellText(placeholder, palette, height, args.table));\n      }\n    } else {\n      root.add(\n        new CustomLayout.Text({\n          fontFamily: palette.fontFamily,\n          // `createCanvasTextLayout` 早就有这两个（右对齐的长金额不加限制会往左压进前一列）。\n          ellipsis: true,\n          fill: palette.text,\n          fontSize: 13,\n          maxLineWidth: Math.max(0, contentWidth - palette.paddingX * 2),\n          pickable: false,\n          text,\n          textAlign: 'right',\n          textBaseline: 'middle',\n          x: contentWidth - palette.paddingX,\n          y: height / 2,\n        } as never),\n      );\n    }\n\n    return { enableCellPadding: false, renderDefault: false, rootContainer: root };\n  };\n"],"mappings":";;;;;;;;;;;AAqBA,MAAa,uBACX,aACA,SACA,QACA,UAEA,IAAI,aAAa,KAAK;CACpB,YAAY,QAAQ;CAIpB,MAAM,QAAQ;CACd,UAAU;CACV,UAAU;CACV,MACE,SAAS,OACL,UAAU,OAAO,cAAc,aAAa,OAAO,EAAE,OAAO,YAAY,CAAC,IACzE,eAAe,WAAW;CAChC,WAAW;CACX,cAAc;CACd,GAAG,QAAQ;CACX,GAAG,SAAS;AACd,CAAU;AAEZ,MAAa,0BACV,UAAyC,CAAC,OAC1C,SAAS;CACR,MAAM,UAAU,iBAAiB,KAAK,KAAK;CAC3C,MAAM,QAAQ,KAAK,MAAM,SAAS;CAClC,MAAM,SAAS,KAAK,MAAM,UAAU;CACpC,MAAM,QAAQ,QAAQ,SAAS;CAC/B,MAAM,OAAO,IAAI,aAAa,MAAM;EAAE;EAAQ,UAAU;EAAO;CAAM,CAAC;CACtE,MAAM,OAAO,KAAK,SAAS,OAAO,KAAK,OAAO,KAAK,KAAK;CACxD,MAAM,SAAS,kBAAkB,KAAK,OAAgB,KAAK,KAAK,KAAK,GAAG;CACxE,MAAM,eAAe,KAAK,IAAI,QAAQ,QAAQ,CAAC;CAE/C,IAAI,MAAM;EACR,MAAM,WAAW,QAAQ;EACzB,MAAM,IACJ,UAAU,WACN,eAAe,IACf,UAAU,UACR,eAAe,WACf;EAER,KAAK,IACH,IAAI,aAAa,KAAK;GACpB,YAAY,QAAQ;GACpB,UAAU;GACV,MAAM,QAAQ,SAAS,QAAQ;GAC/B,UAAU,QAAQ,YAAY;GAC9B,YAAY,QAAQ;GACpB,cAAc,KAAK,IAAI,GAAG,eAAe,WAAW,CAAC;GACrD,UAAU;GACV;GACA,WAAW;GACX,cAAc;GACd;GACA,GAAG,SAAS;EACd,CAAU,CACZ;CACF;CAEA,OAAO;EAAE,mBAAmB;EAAO,eAAe;EAAO,eAAe;CAAK;AAC/E;AAEF,MAAa,wBACV,WAAW,KAAK,iBAChB,SAAS;CACR,MAAM,UAAU,iBAAiB,KAAK,KAAK;CAC3C,MAAM,QAAQ,KAAK,MAAM,SAAS;CAClC,MAAM,SAAS,KAAK,MAAM,UAAU;CAIpC,MAAM,OAAO,eAAe,KAAK,OAAO,QAAQ;CAChD,MAAM,QAAQ,SAAS;CACvB,MAAM,OAAO,IAAI,aAAa,MAAM;EAAE;EAAQ,UAAU;EAAO;CAAM,CAAC;CACtE,MAAM,SAAS,kBAAkB,KAAK,OAAgB,KAAK,KAAK,KAAK,GAAG;CACxE,MAAM,eAAe,KAAK,IAAI,QAAQ,QAAQ,CAAC;CAE/C,IAAI,OACE;MAAA,aACF,KAAK,IAAI,oBAAoB,aAAa,SAAS,QAAQ,KAAK,KAAK,CAAC;CAAA,OAGxE,KAAK,IACH,IAAI,aAAa,KAAK;EACpB,YAAY,QAAQ;EAEpB,UAAU;EACV,MAAM,QAAQ;EACd,UAAU;EACV,cAAc,KAAK,IAAI,GAAG,eAAe,QAAQ,WAAW,CAAC;EAC7D,UAAU;EACV;EACA,WAAW;EACX,cAAc;EACd,GAAG,eAAe,QAAQ;EAC1B,GAAG,SAAS;CACd,CAAU,CACZ;CAGF,OAAO;EAAE,mBAAmB;EAAO,eAAe;EAAO,eAAe;CAAK;AAC/E"}

package/es/Table/canvas/theme.d.mts

@@ -0,0 +1,14 @@
+import { TableTheme } from "../type.mjs";
+import { Theme } from "antd-style";
+//#region src/Table/canvas/theme.d.ts
+type TableToken = Pick<Theme, 'colorBgContainer' | 'colorBorderSecondary' | 'colorFillQuaternary' | 'colorFillSecondary' | 'colorFillTertiary' | 'colorInfo' | 'colorPrimary' | 'colorSplit' | 'colorSuccess' | 'colorText' | 'colorTextQuaternary' | 'colorTextSecondary' | 'colorTextTertiary' | 'fontFamily'> & {
+  isDarkMode?: boolean;
+};
+interface CreateTableThemeOptions {
+  /** Show vertical borders between columns. The row index column never gets one. */
+  showVerticalBorder?: boolean;
+}
+declare const createTableTheme: (token: TableToken, { showVerticalBorder }?: CreateTableThemeOptions) => TableTheme;
+//#endregion
+export { CreateTableThemeOptions, TableToken, createTableTheme };
+//# sourceMappingURL=theme.d.mts.map