@superad/ui 0.1.1

package/es/Table/canvas/theme.mjs

@@ -0,0 +1,276 @@
+import { contrastRatio, parseHex } from "../core/tagTone.mjs";
+import { parseToRgb, rgba } from "polished";
+//#region src/Table/canvas/theme.ts
+/**
+* SuperAd Table visual language, aligned with the Figma Community kit.
+* White header, light bottom hairlines, 44px rows, neutral group rows and a
+* restrained brand-blue accent. Values are fallbacks; createTableTheme still
+* prefers Ant Design / antd-style tokens where they exist.
+*/
+const TABLE_CHROME = {
+	accent: "#1F5EFF",
+	fontFamily: "PingFang SC,Helvetica Neue,Microsoft Yahei,system-ui,'-apple-system',segoe ui,Roboto,Helvetica,Arial,sans-serif",
+	border: "#F4F4F5",
+	group: "#FAFAFA",
+	groupDark: "#161616",
+	hover: "#FAFAFA",
+	rowHover: "#F5F5F5",
+	overlayBorder: "#E4E4E7",
+	paddingX: 8,
+	pillBg: "#F4F4F5",
+	starOff: "#F4F4F5",
+	starOn: "#71717A",
+	success: "#16A34A",
+	text: "#18181B",
+	textAux: "#71717A",
+	textMuted: "#A1A1AA"
+};
+/**
+* True when a CSS colour paints fully opaque. parseToRgb reports opaque colours without an
+* alpha at all rather than as 1, and throws on anything it cannot parse (which we treat as
+* not opaque, so callers fall back).
+*/
+const isOpaqueColor = (color) => {
+	try {
+		const parsed = parseToRgb(color);
+		const alpha = "alpha" in parsed ? parsed.alpha : void 0;
+		return alpha == null || alpha >= 1;
+	} catch {
+		return false;
+	}
+};
+/**
+* Group title rows sit above the rows that scroll beneath them, so their fill has to be
+* opaque — a translucent token would let content show through the sticky title. Keep the
+* token when it is opaque and fall back to the built-in neutral when it is not, so a custom
+* opaque colour still themes the group rows.
+*/
+const resolveGroupFill = (token) => {
+	const fallback = token?.isDarkMode ? TABLE_CHROME.groupDark : TABLE_CHROME.group;
+	const fill = token?.colorFillQuaternary;
+	if (fill == null) return fallback;
+	return isOpaqueColor(fill) ? fill : fallback;
+};
+const resolveTableCanvasPalette = (token) => ({
+	accent: token?.colorPrimary ?? TABLE_CHROME.accent,
+	fontFamily: token?.fontFamily ?? TABLE_CHROME.fontFamily,
+	isDarkMode: Boolean(token?.isDarkMode),
+	checkboxBg: token?.colorBgContainer ?? "#FFFFFF",
+	overlayBorder: token?.colorBorderSecondary ?? TABLE_CHROME.overlayBorder,
+	pillBg: token?.colorFillTertiary ?? TABLE_CHROME.pillBg,
+	rowHover: token?.colorFillTertiary ?? TABLE_CHROME.rowHover,
+	starOff: token?.colorFillTertiary ?? TABLE_CHROME.starOff,
+	starOn: token?.colorTextTertiary ?? TABLE_CHROME.starOn,
+	success: token?.colorSuccess ?? TABLE_CHROME.success,
+	text: token?.colorText ?? TABLE_CHROME.text,
+	textAux: token?.colorTextSecondary ?? TABLE_CHROME.textAux,
+	textMuted: token?.colorTextTertiary ?? TABLE_CHROME.textMuted
+});
+/** 画在 `accent` 之上的前景色候选：深、浅各一个，取对比度更高的那个。 */
+const ON_ACCENT_DARK = "#18181B";
+const ON_ACCENT_LIGHT = "#FFFFFF";
+const ON_ACCENT_DARK_RGB = {
+	b: 27,
+	g: 24,
+	r: 24
+};
+const ON_ACCENT_LIGHT_RGB = {
+	b: 255,
+	g: 255,
+	r: 255
+};
+/**
+* 画在 `accent` 之上的前景色（对勾、半选短横）。
+*
+* **不能写死白色。** `accent` 来自 `token.colorPrimary`，而主色不一定深 —— 暗色下实测是
+* `#eeeeee`，白对勾画上去对比度只有 **1.1:1**，等于看不见（浅色下 `accent` 是 `#222222`，
+* 白对勾才是对的）。按对比度二选一，两种主题都对。
+*/
+const resolveOnAccent = (accent) => {
+	const rgb = parseHex(accent);
+	if (!rgb) return ON_ACCENT_LIGHT;
+	return contrastRatio(rgb, ON_ACCENT_DARK_RGB) >= contrastRatio(rgb, ON_ACCENT_LIGHT_RGB) ? ON_ACCENT_DARK : ON_ACCENT_LIGHT;
+};
+/** SuperAd rows use a top hairline so separators stay visible; vertical borders are opt-in. */
+const hairline = [
+	1,
+	1,
+	0,
+	0
+];
+/** Default SuperAd table: horizontal top row separator only. */
+const hairlineNoVertical = [
+	1,
+	0,
+	0,
+	0
+];
+const createTableTheme = (token, { showVerticalBorder = false } = {}) => {
+	const borderLineWidth = showVerticalBorder ? hairline : hairlineNoVertical;
+	const headerBorderLineWidth = showVerticalBorder ? [
+		0,
+		1,
+		0,
+		0
+	] : [
+		0,
+		0,
+		0,
+		0
+	];
+	const accent = token.colorPrimary ?? TABLE_CHROME.accent;
+	const shadowInk = token.isDarkMode ? "255, 255, 255" : "24, 24, 27";
+	const shadowAlpha = token.isDarkMode ? .14 : .06;
+	const border = token.colorBorderSecondary ?? TABLE_CHROME.border;
+	const headerBorderColor = showVerticalBorder ? border : "transparent";
+	const groupFill = resolveGroupFill(token);
+	const text = token.colorText ?? TABLE_CHROME.text;
+	const textSecondary = token.colorTextSecondary ?? TABLE_CHROME.textAux;
+	const textMuted = token.colorTextTertiary ?? TABLE_CHROME.textMuted;
+	const rowHover = token.colorFillTertiary ?? TABLE_CHROME.rowHover;
+	return {
+		bodyStyle: {
+			bgColor: token.colorBgContainer,
+			borderColor: border,
+			borderLineWidth,
+			color: text,
+			fontFamily: token.fontFamily,
+			fontSize: 14,
+			hover: {
+				cellBgColor: rowHover,
+				inlineRowBgColor: rowHover,
+				inlineColumnBgColor: rowHover
+			},
+			padding: [
+				0,
+				TABLE_CHROME.paddingX,
+				0,
+				TABLE_CHROME.paddingX
+			],
+			textAlign: "left"
+		},
+		cellInnerBorder: true,
+		columnResize: {
+			bgColor: "transparent",
+			labelVisible: false,
+			lineColor: "transparent",
+			lineWidth: 0,
+			visibleOnHover: false,
+			width: 0
+		},
+		dragHeaderSplitLine: {
+			lineColor: accent,
+			lineWidth: 2,
+			shadowBlockColor: rgba(accent, .08)
+		},
+		defaultStyle: {
+			borderColor: "transparent",
+			borderLineWidth: headerBorderLineWidth,
+			fontFamily: token.fontFamily,
+			fontSize: 14
+		},
+		frozenColumnLine: { shadow: {
+			width: 8,
+			startColor: `rgba(${shadowInk}, ${shadowAlpha})`,
+			endColor: `rgba(${shadowInk}, 0)`,
+			visible: "scrolling"
+		} },
+		frameStyle: {
+			borderColor: border,
+			borderLineWidth: [
+				0,
+				0,
+				1,
+				0
+			],
+			cornerRadius: 0
+		},
+		functionalIconsStyle: {
+			collapse_color: textMuted,
+			dragReorder_color: textMuted,
+			dragReorder_color_opacity: "1",
+			dragReorder_size: 16,
+			expand_color: textMuted
+		},
+		groupTitleStyle: {
+			bgColor: groupFill,
+			borderColor: border,
+			borderLineWidth,
+			color: textSecondary,
+			cursor: "pointer",
+			fontFamily: token.fontFamily,
+			fontSize: 14,
+			fontWeight: 500,
+			hover: { cellBgColor: rowHover },
+			padding: [
+				0,
+				TABLE_CHROME.paddingX,
+				0,
+				8
+			],
+			select: {
+				cellBgColor: groupFill,
+				inlineRowBgColor: groupFill
+			},
+			textAlign: "left"
+		},
+		rowHeaderStyle: { hover: {
+			cellBgColor: rowHover,
+			inlineRowBgColor: rowHover,
+			inlineColumnBgColor: rowHover
+		} },
+		headerStyle: {
+			bgColor: token.colorBgContainer,
+			borderColor: headerBorderColor,
+			borderLineWidth: headerBorderLineWidth,
+			color: textSecondary,
+			fontFamily: token.fontFamily,
+			fontSize: 13,
+			fontWeight: 500,
+			hover: {
+				cellBgColor: rowHover,
+				inlineRowBgColor: rowHover,
+				inlineColumnBgColor: rowHover
+			},
+			padding: [
+				0,
+				TABLE_CHROME.paddingX,
+				0,
+				TABLE_CHROME.paddingX
+			],
+			textAlign: "left"
+		},
+		scrollStyle: {
+			barToSide: true,
+			ignoreFrozenCols: true,
+			hoverOn: false,
+			horizontalPadding: [
+				2,
+				0,
+				2,
+				0
+			],
+			verticalPadding: [
+				0,
+				2,
+				0,
+				2
+			],
+			scrollSliderColor: token.colorTextQuaternary || TABLE_CHROME.starOff,
+			scrollSliderCornerRadius: 999,
+			visible: "focus",
+			width: 8
+		},
+		selectionStyle: {
+			cellBgColor: "transparent",
+			cellBorderColor: "transparent",
+			cellBorderLineWidth: 0,
+			selectionFillMode: "overlay"
+		},
+		underlayBackgroundColor: token.colorBgContainer
+	};
+};
+//#endregion
+export { TABLE_CHROME, createTableTheme, isOpaqueColor, resolveGroupFill, resolveOnAccent, resolveTableCanvasPalette };
+
+//# sourceMappingURL=theme.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"theme.mjs","names":[],"sources":["../../../src/Table/canvas/theme.ts"],"sourcesContent":["import type { Theme } from 'antd-style';\nimport { parseToRgb, rgba } from 'polished';\n\nimport { contrastRatio, parseHex, type Rgb } from '../core/tagTone';\nimport type { TableTheme } from '../type';\n\nexport type TableToken = Pick<\n  Theme,\n  | 'colorBgContainer'\n  | 'colorBorderSecondary'\n  | 'colorFillQuaternary'\n  | 'colorFillSecondary'\n  | 'colorFillTertiary'\n  | 'colorInfo'\n  | 'colorPrimary'\n  | 'colorSplit'\n  | 'colorSuccess'\n  | 'colorText'\n  | 'colorTextQuaternary'\n  | 'colorTextSecondary'\n  | 'colorTextTertiary'\n  | 'fontFamily'\n> & { isDarkMode?: boolean };\n/**\n * SuperAd Table visual language, aligned with the Figma Community kit.\n * White header, light bottom hairlines, 44px rows, neutral group rows and a\n * restrained brand-blue accent. Values are fallbacks; createTableTheme still\n * prefers Ant Design / antd-style tokens where they exist.\n */\nexport const TABLE_CHROME = {\n  accent: '#1F5EFF',\n  // 与 vrender 内置的默认一致：拿不到 antd token 时行为不变（见 DEFAULT_TEXT_FONT_FAMILY）。\n  fontFamily:\n    \"PingFang SC,Helvetica Neue,Microsoft Yahei,system-ui,'-apple-system',segoe ui,Roboto,Helvetica,Arial,sans-serif\",\n\n  border: '#F4F4F5',\n  group: '#FAFAFA',\n  groupDark: '#161616',\n  hover: '#FAFAFA',\n  rowHover: '#F5F5F5',\n  overlayBorder: '#E4E4E7',\n  paddingX: 8,\n  pillBg: '#F4F4F5',\n  starOff: '#F4F4F5',\n  starOn: '#71717A',\n  success: '#16A34A',\n  text: '#18181B',\n  textAux: '#71717A',\n  textMuted: '#A1A1AA',\n} as const;\n\nexport interface TableCanvasPalette {\n  accent: string;\n  checkboxBg: string;\n  fontFamily: string;\n  isDarkMode: boolean;\n  overlayBorder: string;\n  pillBg: string;\n  rowHover: string;\n  starOff: string;\n  starOn: string;\n  success: string;\n  text: string;\n  textAux: string;\n  textMuted: string;\n}\n\n/**\n * True when a CSS colour paints fully opaque. parseToRgb reports opaque colours without an\n * alpha at all rather than as 1, and throws on anything it cannot parse (which we treat as\n * not opaque, so callers fall back).\n */\nexport const isOpaqueColor = (color: string): boolean => {\n  try {\n    const parsed = parseToRgb(color);\n    const alpha = 'alpha' in parsed ? parsed.alpha : undefined;\n\n    return alpha == null || alpha >= 1;\n  } catch {\n    return false;\n  }\n};\n\n/**\n * Group title rows sit above the rows that scroll beneath them, so their fill has to be\n * opaque — a translucent token would let content show through the sticky title. Keep the\n * token when it is opaque and fall back to the built-in neutral when it is not, so a custom\n * opaque colour still themes the group rows.\n */\nexport const resolveGroupFill = (token?: TableToken): string => {\n  const fallback = token?.isDarkMode ? TABLE_CHROME.groupDark : TABLE_CHROME.group;\n  const fill = token?.colorFillQuaternary;\n\n  if (fill == null) return fallback;\n\n  return isOpaqueColor(fill) ? fill : fallback;\n};\n\nexport const resolveTableCanvasPalette = (token?: TableToken): TableCanvasPalette => ({\n  accent: token?.colorPrimary ?? TABLE_CHROME.accent,\n  fontFamily: token?.fontFamily ?? TABLE_CHROME.fontFamily,\n  isDarkMode: Boolean(token?.isDarkMode),\n  checkboxBg: token?.colorBgContainer ?? '#FFFFFF',\n  overlayBorder: token?.colorBorderSecondary ?? TABLE_CHROME.overlayBorder,\n  pillBg: token?.colorFillTertiary ?? TABLE_CHROME.pillBg,\n  rowHover: token?.colorFillTertiary ?? TABLE_CHROME.rowHover,\n  starOff: token?.colorFillTertiary ?? TABLE_CHROME.starOff,\n  starOn: token?.colorTextTertiary ?? TABLE_CHROME.starOn,\n  success: token?.colorSuccess ?? TABLE_CHROME.success,\n  text: token?.colorText ?? TABLE_CHROME.text,\n  textAux: token?.colorTextSecondary ?? TABLE_CHROME.textAux,\n  textMuted: token?.colorTextTertiary ?? TABLE_CHROME.textMuted,\n});\n\n/** 画在 `accent` 之上的前景色候选：深、浅各一个，取对比度更高的那个。 */\nconst ON_ACCENT_DARK = '#18181B';\nconst ON_ACCENT_LIGHT = '#FFFFFF';\nconst ON_ACCENT_DARK_RGB: Rgb = { b: 27, g: 24, r: 24 };\nconst ON_ACCENT_LIGHT_RGB: Rgb = { b: 255, g: 255, r: 255 };\n\n/**\n * 画在 `accent` 之上的前景色（对勾、半选短横）。\n *\n * **不能写死白色。** `accent` 来自 `token.colorPrimary`，而主色不一定深 —— 暗色下实测是\n * `#eeeeee`，白对勾画上去对比度只有 **1.1:1**，等于看不见（浅色下 `accent` 是 `#222222`，\n * 白对勾才是对的）。按对比度二选一，两种主题都对。\n */\nexport const resolveOnAccent = (accent: string): string => {\n  const rgb = parseHex(accent);\n  if (!rgb) return ON_ACCENT_LIGHT;\n\n  return contrastRatio(rgb, ON_ACCENT_DARK_RGB) >= contrastRatio(rgb, ON_ACCENT_LIGHT_RGB)\n    ? ON_ACCENT_DARK\n    : ON_ACCENT_LIGHT;\n};\n\n/** SuperAd rows use a top hairline so separators stay visible; vertical borders are opt-in. */\nconst hairline = [1, 1, 0, 0] as [number, number, number, number];\n/** Default SuperAd table: horizontal top row separator only. */\nconst hairlineNoVertical = [1, 0, 0, 0] as [number, number, number, number];\n\nexport interface CreateTableThemeOptions {\n  /** Show vertical borders between columns. The row index column never gets one. */\n  showVerticalBorder?: boolean;\n}\n\nexport const createTableTheme = (\n  token: TableToken,\n  { showVerticalBorder = false }: CreateTableThemeOptions = {},\n): TableTheme => {\n  const borderLineWidth = showVerticalBorder ? hairline : hairlineNoVertical;\n  const headerBorderLineWidth = showVerticalBorder\n    ? ([0, 1, 0, 0] as [number, number, number, number])\n    : ([0, 0, 0, 0] as [number, number, number, number]);\n  const accent = token.colorPrimary ?? TABLE_CHROME.accent;\n  // 冻结列阴影的「墨色」。**不能两套主题共用一个近黑** —— 深色压在同为深色的底上等于没有阴影：\n  // 实测暗色下已滚动与未滚动的边界像素完全一样（13,13,13），冻结列与内容之间看不出分界。\n  // 浅色这一侧的 RGB 与 alpha 保持原值不动，基线才不会被这次修复带偏。\n  const shadowInk = token.isDarkMode ? '255, 255, 255' : '24, 24, 27';\n  const shadowAlpha = token.isDarkMode ? 0.14 : 0.06;\n  const border = token.colorBorderSecondary ?? TABLE_CHROME.border;\n  const headerBorderColor = showVerticalBorder ? border : 'transparent';\n  const groupFill = resolveGroupFill(token);\n  const text = token.colorText ?? TABLE_CHROME.text;\n  const textSecondary = token.colorTextSecondary ?? TABLE_CHROME.textAux;\n  const textMuted = token.colorTextTertiary ?? TABLE_CHROME.textMuted;\n  const rowHover = token.colorFillTertiary ?? TABLE_CHROME.rowHover;\n\n  return {\n    bodyStyle: {\n      bgColor: token.colorBgContainer,\n      borderColor: border,\n      borderLineWidth,\n      color: text,\n      fontFamily: token.fontFamily,\n      fontSize: 14,\n      hover: {\n        cellBgColor: rowHover,\n        inlineRowBgColor: rowHover,\n        inlineColumnBgColor: rowHover,\n      },\n      padding: [0, TABLE_CHROME.paddingX, 0, TABLE_CHROME.paddingX],\n      textAlign: 'left',\n    },\n    cellInnerBorder: true,\n    columnResize: {\n      bgColor: 'transparent',\n      labelVisible: false,\n      lineColor: 'transparent',\n      lineWidth: 0,\n      visibleOnHover: false,\n      width: 0,\n    },\n    dragHeaderSplitLine: {\n      lineColor: accent,\n      lineWidth: 2,\n      shadowBlockColor: rgba(accent, 0.08),\n    },\n    defaultStyle: {\n      borderColor: 'transparent',\n      borderLineWidth: headerBorderLineWidth,\n      fontFamily: token.fontFamily,\n      fontSize: 14,\n    },\n    frozenColumnLine: {\n      shadow: {\n        width: 8,\n        // 两端用同一组 RGB：混用会让渐变中途泛灰。\n        startColor: `rgba(${shadowInk}, ${shadowAlpha})`,\n        endColor: `rgba(${shadowInk}, 0)`,\n        visible: 'scrolling',\n      },\n    },\n    frameStyle: {\n      borderColor: border,\n      borderLineWidth: [0, 0, 1, 0] as [number, number, number, number],\n      cornerRadius: 0,\n    },\n    functionalIconsStyle: {\n      collapse_color: textMuted,\n      dragReorder_color: textMuted,\n      dragReorder_color_opacity: '1',\n      dragReorder_size: 16,\n      expand_color: textMuted,\n    },\n    groupTitleStyle: {\n      bgColor: groupFill,\n      borderColor: border,\n      borderLineWidth,\n      color: textSecondary,\n      cursor: 'pointer',\n      fontFamily: token.fontFamily,\n      fontSize: 14,\n      fontWeight: 500,\n      hover: {\n        cellBgColor: rowHover,\n      },\n      padding: [0, TABLE_CHROME.paddingX, 0, 8],\n      select: {\n        cellBgColor: groupFill,\n        inlineRowBgColor: groupFill,\n      },\n      textAlign: 'left',\n    },\n    rowHeaderStyle: {\n      hover: {\n        cellBgColor: rowHover,\n        inlineRowBgColor: rowHover,\n        inlineColumnBgColor: rowHover,\n      },\n    },\n    headerStyle: {\n      bgColor: token.colorBgContainer,\n      borderColor: headerBorderColor,\n      borderLineWidth: headerBorderLineWidth,\n      color: textSecondary,\n      fontFamily: token.fontFamily,\n      fontSize: 13,\n      fontWeight: 500,\n      hover: {\n        cellBgColor: rowHover,\n        inlineRowBgColor: rowHover,\n        inlineColumnBgColor: rowHover,\n      },\n      padding: [0, TABLE_CHROME.paddingX, 0, TABLE_CHROME.paddingX],\n      textAlign: 'left',\n    },\n    scrollStyle: {\n      barToSide: true,\n      // 默认**从冻结列右边才开始**，不铺满整宽 —— 有冻结列的表（树表、单元格类型）因此和没有\n      // 冻结列的表长得不一样，看起来像「缩在里面」。打开这个开关让横条始终从最左铺到最右。\n      ignoreFrozenCols: true,\n      // **`hoverOn` 不是「hover 才显示」，而是「滚动条浮在内容上、不占位」。** 开着它时\n      // `getHorizontalScrollBarSize` 直接返回 0，引擎**不预留滚动条槽** —— 内容一直铺到画布\n      // 底边，而横条固定在画布底边，于是它压在底边框上（内容纵向溢出的表都是这个观感：树形\n      // 表格、Table 分组、百万数据）。关掉它引擎才会 `height = heightP - hScrollBarWidth` 预留\n      // 那 4px，横条落到边框**下方**的槽里，与不滚动的表（autoHeight 自带 8px 槽）一致。\n      //\n      // 「什么时候出现」由 `visible: 'focus'` 管，与这一项无关。\n      hoverOn: false,\n      // 滑块与表格留出 2px 缝：`width` 是**滚动条的槽宽**（引擎按它预留空间），滑块的实际\n      // 粗细由 padding 从槽里内缩出来 —— 槽 8、上下（横条）/ 左右（竖条）各内缩 2，滑块仍是\n      // 4px，贴着表格那侧因此有 2px 空白。槽宽即内容要付出的宽度，比 4px 多让出 4px。\n      horizontalPadding: [2, 0, 2, 0],\n      verticalPadding: [0, 2, 0, 2],\n      scrollSliderColor: token.colorTextQuaternary || TABLE_CHROME.starOff,\n      scrollSliderCornerRadius: 999,\n      visible: 'focus',\n      // 槽宽（不是滑块粗细）。8 = 滑块 4 + 两侧各 2 的缝，见上面的 padding 注释。\n      width: 8,\n    },\n    selectionStyle: {\n      // 选中不画任何高亮：不铺色（铺色和 hover 的中性灰撞）、不描边（这套 token 的主色是\n      // 近黑，描出来是一圈黑框）。选中只用来驱动编辑与复制，视觉反馈交给 hover。\n      cellBgColor: 'transparent',\n      cellBorderColor: 'transparent',\n      cellBorderLineWidth: 0,\n      selectionFillMode: 'overlay',\n    },\n    underlayBackgroundColor: token.colorBgContainer,\n  };\n};\n"],"mappings":"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"}

package/es/Table/core/cellValue.d.mts

@@ -0,0 +1 @@
+import "../type.mjs";

package/es/Table/core/cellValue.mjs

@@ -0,0 +1,240 @@
+import dayjs from "dayjs";
+//#region src/Table/core/cellValue.ts
+/** `YYYY-MM-DD` 开头（含可选的 T/空格 + 时间部分）的输入要做往返校验。 */
+const ISO_DATE_PREFIX = /^(\d{4})-(\d{2})-(\d{2})(?:[T ]|$)/;
+/** 空白串按空值处理：`Number('   ')` 是 0，会让 CSV / 粘贴进来的空白列显示成 `0`。 */
+const isBlank = (value) => value == null || typeof value === "string" && value.trim() === "";
+/**
+* 串自己带了时区标记（`Z` 或 `±HH:MM` / `±HHMM`）。
+*
+* 这类串由 `new Date(str)` 解析成一个**确定瞬间**，根本不存在「本地日历日」这回事 ——
+* 拿本地日期去和串里写的日期做往返校验是范畴错误：同一个瞬间在 UTC+8 下就是第二天，
+* 于是 `16:00:00Z` 之后的一整天全被判成非法日期、单元格显示空白。
+* （dayjs 对 `Z` 结尾的串本来就走原生解析，对带偏移的串则因匹配不上它的正则而同样走原生。）
+*/
+const HAS_TIMEZONE = /(?:[Zz]|[+-]\d{2}:?\d{2})$/;
+const toDate = (value) => {
+	if (value instanceof Date) return Number.isNaN(value.getTime()) ? void 0 : value;
+	if (value == null || value === "") return void 0;
+	const parsed = dayjs(value);
+	if (parsed.isValid() === false) return void 0;
+	const trimmed = typeof value === "string" ? value.trim() : void 0;
+	if (trimmed != null && ISO_DATE_PREFIX.test(trimmed) && HAS_TIMEZONE.test(trimmed) === false && parsed.format("YYYY-MM-DD") !== trimmed.slice(0, 10)) return;
+	return parsed.toDate();
+};
+const formatDateTime = (value, format = "YYYY-MM-DD HH:mm") => {
+	const date = toDate(value);
+	return date ? dayjs(date).format(format) : "";
+};
+/**
+* 日期范围的显示文案（`dateRange` 列）。值是一条 `[起, 止]` 数组，默认显示**起止时间**。
+* （参考图里甘特条上的「N天 / N个月」是时间条自己的标注，不是表格列的显示。）
+* 历史数据只存了一端时显示那一端的日期。
+*/
+const formatDateRange = (value, format = "YYYY-MM-DD") => {
+	const [start, end] = toValueList(value);
+	const startText = formatDateTime(start, format);
+	const endText = end == null ? "" : formatDateTime(end, format);
+	if (startText === "") return endText;
+	if (endText === "") return startText;
+	return `${startText} ~ ${endText}`;
+};
+/**
+* 一段 `[起, 止]` 的时长文案 —— 状态标题后跟的「5天 / 1个月」这类。不足一月按天、
+* 满一月按月（月按 30 天）。算不出（缺任一端）返回空串。
+*/
+const formatDuration = (value) => {
+	const [start, end] = toValueList(value);
+	const startDate = start == null ? void 0 : toDate(start);
+	const endDate = end == null ? void 0 : toDate(end);
+	if (!startDate || !endDate) return "";
+	const days = dayjs(endDate).diff(dayjs(startDate), "day");
+	return days >= 30 ? `${Math.floor(days / 30)}个月` : `${days}天`;
+};
+/**
+* 从记录里取日期范围，供「状态标题后跟时长」用。`duration` 是字段名（值本身就是
+* `[起, 止]` 数组），或 `{ from, to }` 两个字段。
+*/
+const resolveDurationRange = (record, duration) => {
+	if (duration == null || record == null) return void 0;
+	const source = record;
+	if (typeof duration === "string") return source[duration];
+	return [source[duration.from], source[duration.to]];
+};
+const toValueList = (value) => {
+	if (value == null || value === "") return [];
+	return Array.isArray(value) ? value : [value];
+};
+const isEmptyCellValue = (value) => {
+	if (value == null || value === "") return true;
+	if (typeof value === "number" || typeof value === "boolean") return false;
+	if (value instanceof Date) return Number.isNaN(value.getTime());
+	if (Array.isArray(value)) return value.every(isEmptyCellValue);
+	if (typeof value === "object") return Object.values(value).every(isEmptyCellValue);
+	return false;
+};
+const emptyCellLabel = (title) => title ? `设置 ${title}` : "设置";
+const matchesQuery = (query, ...parts) => {
+	const needle = query.trim().toLowerCase();
+	if (!needle) return true;
+	return parts.some((part) => String(part ?? "").toLowerCase().includes(needle));
+};
+const optionMap = (options = []) => new Map(options.map((item) => [item.value, item]));
+const resolveOption = (value, options = []) => {
+	if (value == null || value === "") return {
+		label: "",
+		value: ""
+	};
+	const raw = typeof value === "object" && value && "value" in value ? String(value.value) : String(value);
+	return optionMap(options).get(raw) ?? {
+		label: raw,
+		value: raw
+	};
+};
+/**
+* 把任意取值收敛成一个**可以画**的 user。
+*
+* `name` 必须是字符串：painter 要按字符逐个量宽（`measureLabelWidth` 用 `for...of`），
+* 数字 / `null` / `undefined` 透传过去就是 `TypeError: label is not iterable` —— 异常从
+* layout 回调抛进引擎渲染循环，**整张表都画不出来**（实时代码复现：canvas 直接没渲染）。
+* 没有 `name` 键的对象同样不能走 `String(value)`：那会在 chip 上画出 "[object Object]"。
+* 这两种形状都收敛成空名字，painter 见到空名字会退回落位提示。
+*/
+const resolveUser = (value) => {
+	if (typeof value === "string") return { name: value };
+	if (value && typeof value === "object") {
+		const user = value;
+		return {
+			avatar: user.avatar,
+			name: typeof user.name === "string" ? user.name : ""
+		};
+	}
+	return { name: value == null ? "" : String(value) };
+};
+const isGroupTitleRecord = (record) => Boolean(record && typeof record === "object" && record.vtableMerge);
+const toBoolean = (value) => {
+	if (isBlank(value)) return null;
+	if (typeof value === "boolean") return value;
+	if (Array.isArray(value)) return null;
+	if (value != null && typeof value === "object") {
+		const checked = value.checked;
+		return typeof checked === "boolean" ? checked : null;
+	}
+	const text = String(value).trim().toLowerCase();
+	if (text === "1" || text === "true" || text === "y" || text === "yes" || text === "是") return true;
+	if (text === "0" || text === "false" || text === "f" || text === "n" || text === "no" || text === "off" || text === "否") return false;
+	if (typeof value === "number") return Number.isFinite(value) ? value !== 0 : null;
+	if (text === "t") return true;
+	return Boolean(value);
+};
+const toRating = (value) => {
+	const numeric = Number(value);
+	if (!Number.isFinite(numeric)) return 0;
+	return Math.min(5, Math.max(0, Math.round(numeric)));
+};
+/**
+* `-0` 会被 `toLocaleString` 渲染成 `'-0'`，但它既不小于 0 也不是正数 —— 金额于是显示成
+* `¥-0`。`Math.round(-0.2)` 就是 -0，计算列很容易产出它。
+*/
+const normalizeZero = (value) => value === 0 ? 0 : value;
+/**
+* 取到**显示精度**再消负零。
+*
+* 只挡字面 `-0` 是不够的：`toLocaleString('en-US')` 默认保留 3 位小数，于是它自己会把
+* `-0.0001` 舍成字符串 `'-0'`、把 `-1e-9` 舍成 `'-0'` —— 计算列（占比、汇率换算）很容易
+* 产出这种值，界面上就出现 `-0 人` / `-¥0`。先按同一精度取整，再判零。
+*/
+const toDisplayPrecision = (value) => normalizeZero(Math.round(value * 1e3) / 1e3);
+const formatNumber = (value, unit) => {
+	if (isBlank(value)) return "";
+	const numeric = Number(value);
+	const text = Number.isFinite(numeric) ? toDisplayPrecision(numeric).toLocaleString("en-US") : String(value);
+	if (!unit) return text;
+	return unit === "%" ? `${text}%` : `${text} ${unit}`;
+};
+const formatCurrency = (value, currency = "¥") => {
+	if (isBlank(value)) return "";
+	const numeric = Number(value);
+	if (!Number.isFinite(numeric)) return String(value);
+	const display = toDisplayPrecision(numeric);
+	if (display < 0) return `-${currency}${Math.abs(display).toLocaleString("en-US")}`;
+	return `${currency}${display.toLocaleString("en-US")}`;
+};
+const formatJson = (value) => {
+	if (value == null || value === "") return "";
+	if (typeof value === "string") return value;
+	try {
+		return JSON.stringify(value);
+	} catch {
+		return String(value);
+	}
+};
+const formatLinkLabel = (value) => value.replace(/^https?:\/\/(?:www\.)?/i, "").replace(/^www\./i, "");
+const hrefFor = (type, value) => {
+	const text = value == null ? "" : String(value);
+	if (type === "email") return `mailto:${text}`;
+	if (type === "phone") return `tel:${text}`;
+	return text;
+};
+const formatAddress = (value) => {
+	const address = parseAddress(value);
+	return [
+		"street",
+		"street2",
+		"city",
+		"state",
+		"country",
+		"postcode"
+	].map((key) => address[key]).filter(Boolean).join(", ");
+};
+const parseAddress = (value) => {
+	if (value == null || value === "") return {};
+	if (typeof value === "string") return { street: value };
+	if (typeof value !== "object") return { street: String(value) };
+	const source = value;
+	const next = {};
+	[
+		"street",
+		"street2",
+		"city",
+		"state",
+		"country",
+		"postcode"
+	].forEach((key) => {
+		const part = source[key];
+		if (part != null && part !== "") next[key] = String(part);
+	});
+	return next;
+};
+/**
+* 单元格在**画面上**显示成什么 —— 供 a11y 隐藏层与剪贴板桥使用。
+*
+* 画布上的 select / tag / user / array 是 painter 把标签映射**闭包**进去画的，而
+* `getCellValue()` 给的是记录里的原始值：屏幕阅读器因此朗读 `done` 而不是「已完成」，
+* 对象值更是直接读成 `[object Object]`（画布上明明是姓名）。这里按同一套映射还原成
+* 人能读的文本。
+*
+* `markers` 取编译后的列上的 `superadKind` / `superadOptions`（见 `vtable/columns.ts`）。
+*/
+const describeCellValue = (value, markers, record) => {
+	if (value == null || value === "") return "";
+	const kind = markers?.kind;
+	if (kind === "select" || kind === "tag") {
+		const labels = toValueList(value).map((item) => resolveOption(item, markers?.options).label).filter((label) => label !== "");
+		const durationText = formatDuration(resolveDurationRange(record, markers?.duration));
+		const suffix = durationText === "" ? "" : ` ${durationText}`;
+		return `${labels.join("、")}${suffix}`;
+	}
+	if (kind === "user") return toValueList(value).map(resolveUser).map((user) => user.name).filter(Boolean).join("、");
+	if (kind === "array") return toValueList(value).map(String).join("、");
+	if (kind === "boolean" || kind === "checkbox") {
+		const boolean = toBoolean(value);
+		return boolean == null ? "" : boolean ? "是" : "否";
+	}
+	if (typeof value === "object") return formatJson(value);
+	return String(value);
+};
+//#endregion
+export { describeCellValue, emptyCellLabel, formatAddress, formatCurrency, formatDateRange, formatDateTime, formatDuration, formatJson, formatLinkLabel, formatNumber, hrefFor, isEmptyCellValue, isGroupTitleRecord, matchesQuery, optionMap, parseAddress, resolveDurationRange, resolveOption, resolveUser, toBoolean, toDate, toRating, toValueList };
+
+//# sourceMappingURL=cellValue.mjs.map

package/es/Table/core/cellValue.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"cellValue.mjs","names":[],"sources":["../../../src/Table/core/cellValue.ts"],"sourcesContent":["import dayjs from 'dayjs';\n\nimport type { TableAddress, TableSelectOption, TableUser } from '../type';\n\n/** `YYYY-MM-DD` 开头（含可选的 T/空格 + 时间部分）的输入要做往返校验。 */\nconst ISO_DATE_PREFIX = /^(\\d{4})-(\\d{2})-(\\d{2})(?:[T ]|$)/;\n\n/** 空白串按空值处理：`Number('   ')` 是 0，会让 CSV / 粘贴进来的空白列显示成 `0`。 */\nconst isBlank = (value: unknown): boolean =>\n  value == null || (typeof value === 'string' && value.trim() === '');\n\n/**\n * 串自己带了时区标记（`Z` 或 `±HH:MM` / `±HHMM`）。\n *\n * 这类串由 `new Date(str)` 解析成一个**确定瞬间**，根本不存在「本地日历日」这回事 ——\n * 拿本地日期去和串里写的日期做往返校验是范畴错误：同一个瞬间在 UTC+8 下就是第二天，\n * 于是 `16:00:00Z` 之后的一整天全被判成非法日期、单元格显示空白。\n * （dayjs 对 `Z` 结尾的串本来就走原生解析，对带偏移的串则因匹配不上它的正则而同样走原生。）\n */\nconst HAS_TIMEZONE = /(?:[Zz]|[+-]\\d{2}:?\\d{2})$/;\n\nexport const toDate = (value: unknown): Date | undefined => {\n  if (value instanceof Date) return Number.isNaN(value.getTime()) ? undefined : value;\n  if (value == null || value === '') return undefined;\n  const parsed = dayjs(value as any);\n  if (parsed.isValid() === false) return undefined;\n\n  // dayjs 是宽松解析：'2026-13-45' 会被「滚动」成 2027-02-13，`isValid()` 仍是 true ——\n  // 界面上于是显示一个看起来合理、其实完全错误的日子。只对 ISO 形状、且**不带时区标记**的\n  // 字符串做往返校验，其它写法（时间戳、Date、'2026/3/4'、带 Z/偏移的串）维持原样。\n  const trimmed = typeof value === 'string' ? value.trim() : undefined;\n  if (\n    trimmed != null &&\n    ISO_DATE_PREFIX.test(trimmed) &&\n    HAS_TIMEZONE.test(trimmed) === false &&\n    parsed.format('YYYY-MM-DD') !== trimmed.slice(0, 10)\n  ) {\n    return undefined;\n  }\n\n  return parsed.toDate();\n};\n\nexport const formatDateTime = (value: unknown, format = 'YYYY-MM-DD HH:mm'): string => {\n  const date = toDate(value);\n  return date ? dayjs(date).format(format) : '';\n};\n\n/**\n * 日期范围的显示文案（`dateRange` 列）。值是一条 `[起, 止]` 数组，默认显示**起止时间**。\n * （参考图里甘特条上的「N天 / N个月」是时间条自己的标注，不是表格列的显示。）\n * 历史数据只存了一端时显示那一端的日期。\n */\nexport const formatDateRange = (value: unknown, format = 'YYYY-MM-DD'): string => {\n  const [start, end] = toValueList(value);\n  const startText = formatDateTime(start, format);\n  const endText = end == null ? '' : formatDateTime(end, format);\n\n  // 只显示有值的那端，别把空端格式化成 `~ ` 悬着。\n  if (startText === '') return endText;\n  if (endText === '') return startText;\n  return `${startText} ~ ${endText}`;\n};\n\n/**\n * 一段 `[起, 止]` 的时长文案 —— 状态标题后跟的「5天 / 1个月」这类。不足一月按天、\n * 满一月按月（月按 30 天）。算不出（缺任一端）返回空串。\n */\nexport const formatDuration = (value: unknown): string => {\n  const [start, end] = toValueList(value);\n  const startDate = start == null ? undefined : toDate(start);\n  const endDate = end == null ? undefined : toDate(end);\n  if (!startDate || !endDate) return '';\n\n  const days = dayjs(endDate).diff(dayjs(startDate), 'day');\n  return days >= 30 ? `${Math.floor(days / 30)}个月` : `${days}天`;\n};\n\n/**\n * 从记录里取日期范围，供「状态标题后跟时长」用。`duration` 是字段名（值本身就是\n * `[起, 止]` 数组），或 `{ from, to }` 两个字段。\n */\nexport const resolveDurationRange = (\n  record: unknown,\n  duration?: string | { from: string; to: string },\n): unknown => {\n  if (duration == null || record == null) return undefined;\n  const source = record as Record<string, unknown>;\n\n  if (typeof duration === 'string') return source[duration];\n  return [source[duration.from], source[duration.to]];\n};\n\nexport const toValueList = (value: unknown): unknown[] => {\n  if (value == null || value === '') return [];\n  return Array.isArray(value) ? value : [value];\n};\n\nexport const isEmptyCellValue = (value: unknown): boolean => {\n  if (value == null || value === '') return true;\n  if (typeof value === 'number' || typeof value === 'boolean') return false;\n  if (value instanceof Date) return Number.isNaN(value.getTime());\n  if (Array.isArray(value)) return value.every(isEmptyCellValue);\n  if (typeof value === 'object') {\n    const values = Object.values(value as Record<string, unknown>);\n    return values.every(isEmptyCellValue);\n  }\n  return false;\n};\n\nexport const emptyCellLabel = (title?: string): string => (title ? `设置 ${title}` : '设置');\n\nexport const matchesQuery = (\n  query: string,\n  ...parts: Array<string | null | undefined>\n): boolean => {\n  const needle = query.trim().toLowerCase();\n  if (!needle) return true;\n  return parts.some((part) =>\n    String(part ?? '')\n      .toLowerCase()\n      .includes(needle),\n  );\n};\n\nexport const optionMap = (options: TableSelectOption[] = []): Map<string, TableSelectOption> =>\n  new Map(options.map((item) => [item.value, item]));\n\nexport const resolveOption = (\n  value: unknown,\n  options: TableSelectOption[] = [],\n): TableSelectOption => {\n  if (value == null || value === '') return { label: '', value: '' };\n  const raw =\n    typeof value === 'object' && value && 'value' in value\n      ? String((value as TableSelectOption).value)\n      : String(value);\n  return optionMap(options).get(raw) ?? { label: raw, value: raw };\n};\n\n/**\n * 把任意取值收敛成一个**可以画**的 user。\n *\n * `name` 必须是字符串：painter 要按字符逐个量宽（`measureLabelWidth` 用 `for...of`），\n * 数字 / `null` / `undefined` 透传过去就是 `TypeError: label is not iterable` —— 异常从\n * layout 回调抛进引擎渲染循环，**整张表都画不出来**（实时代码复现：canvas 直接没渲染）。\n * 没有 `name` 键的对象同样不能走 `String(value)`：那会在 chip 上画出 \"[object Object]\"。\n * 这两种形状都收敛成空名字，painter 见到空名字会退回落位提示。\n */\nexport const resolveUser = (value: unknown): TableUser => {\n  if (typeof value === 'string') return { name: value };\n  if (value && typeof value === 'object') {\n    const user = value as Partial<TableUser>;\n    return {\n      avatar: user.avatar,\n      name: typeof user.name === 'string' ? user.name : '',\n    };\n  }\n  return { name: value == null ? '' : String(value) };\n};\n\nexport const isGroupTitleRecord = (record: unknown): record is { vtableMerge: true } =>\n  Boolean(\n    record && typeof record === 'object' && (record as { vtableMerge?: boolean }).vtableMerge,\n  );\n\nexport const toBoolean = (value: unknown): boolean | null => {\n  // 空白串按空值处理，与 `isBlank`（number / currency 那一侧）同口径 —— 少了 trim，\n  // `'   '` 会落到兜底 `Boolean(value)` 变成「是」，复选框直接画成已勾选。\n  if (isBlank(value)) return null;\n  if (typeof value === 'boolean') return value;\n  // 数组没有布尔语义。原样走兜底的话空数组 `[]` 也是真。\n  if (Array.isArray(value)) return null;\n  if (value != null && typeof value === 'object') {\n    // VTable 的 checkbox 单元格把状态存在记录的 `{checked}` 上；其余对象没有布尔语义。\n    const checked = (value as { checked?: unknown }).checked;\n    return typeof checked === 'boolean' ? checked : null;\n  }\n\n  // 比较必须忽略大小写与首尾空格：'FALSE' / 'False' 落到最后的 `Boolean(value)` 会得到\n  // true —— 后端把布尔写成大写时整个含义反过来，而且没有任何报错。否定写法要列全（'n' /\n  // 'no' / 'off' 同样会落到那个兜底，把「否」画成绿色的对勾）。\n  const text = String(value).trim().toLowerCase();\n  if (text === '1' || text === 'true' || text === 'y' || text === 'yes' || text === '是')\n    return true;\n  if (\n    text === '0' ||\n    text === 'false' ||\n    // `'f'` 是 Postgres / MySQL 的布尔输出写法（`'t'` / `'f'`），漏在集合外就整个反过来。\n    text === 'f' ||\n    text === 'n' ||\n    text === 'no' ||\n    text === 'off' ||\n    text === '否'\n  ) {\n    return false;\n  }\n\n  // 数字保持原语义：0 是假，其余是真；`NaN` / `Infinity` 不是布尔。\n  if (typeof value === 'number') return Number.isFinite(value) ? value !== 0 : null;\n  if (text === 't') return true;\n  return Boolean(value);\n};\n\nexport const toRating = (value: unknown): number => {\n  const numeric = Number(value);\n  if (!Number.isFinite(numeric)) return 0;\n  return Math.min(5, Math.max(0, Math.round(numeric)));\n};\n\n/**\n * `-0` 会被 `toLocaleString` 渲染成 `'-0'`，但它既不小于 0 也不是正数 —— 金额于是显示成\n * `¥-0`。`Math.round(-0.2)` 就是 -0，计算列很容易产出它。\n */\nconst normalizeZero = (value: number): number => (value === 0 ? 0 : value);\n\n/**\n * 取到**显示精度**再消负零。\n *\n * 只挡字面 `-0` 是不够的：`toLocaleString('en-US')` 默认保留 3 位小数，于是它自己会把\n * `-0.0001` 舍成字符串 `'-0'`、把 `-1e-9` 舍成 `'-0'` —— 计算列（占比、汇率换算）很容易\n * 产出这种值，界面上就出现 `-0 人` / `-¥0`。先按同一精度取整，再判零。\n */\nconst toDisplayPrecision = (value: number): number =>\n  normalizeZero(Math.round(value * 1000) / 1000);\n\nexport const formatNumber = (value: unknown, unit?: string): string => {\n  if (isBlank(value)) return '';\n  const numeric = Number(value);\n  const text = Number.isFinite(numeric)\n    ? toDisplayPrecision(numeric).toLocaleString('en-US')\n    : String(value);\n  if (!unit) return text;\n  return unit === '%' ? `${text}%` : `${text} ${unit}`;\n};\n\nexport const formatCurrency = (value: unknown, currency = '¥'): string => {\n  if (isBlank(value)) return '';\n  const numeric = Number(value);\n  if (!Number.isFinite(numeric)) return String(value);\n  const display = toDisplayPrecision(numeric);\n  // 负号要在货币符之前：`¥-5` 不是中文里写金额的方式。符号取自**显示值** —— 舍入后是 0 的\n  // 小负数不该带负号（否则就是 `-¥0`）。\n  if (display < 0) return `-${currency}${Math.abs(display).toLocaleString('en-US')}`;\n  return `${currency}${display.toLocaleString('en-US')}`;\n};\n\nexport const formatJson = (value: unknown): string => {\n  if (value == null || value === '') return '';\n  if (typeof value === 'string') return value;\n  try {\n    return JSON.stringify(value);\n  } catch {\n    return String(value);\n  }\n};\n\nexport const formatLinkLabel = (value: string): string =>\n  value.replace(/^https?:\\/\\/(?:www\\.)?/i, '').replace(/^www\\./i, '');\n\n/** Link flavours a cell can render as. Owned here because it is a value concept, not an engine one. */\nexport type LinkKind = 'email' | 'link' | 'phone';\n\nexport const hrefFor = (type: LinkKind, value: unknown): string => {\n  const text = value == null ? '' : String(value);\n  if (type === 'email') return `mailto:${text}`;\n  if (type === 'phone') return `tel:${text}`;\n  return text;\n};\n\nexport const formatAddress = (value: unknown): string => {\n  const address = parseAddress(value);\n  return (['street', 'street2', 'city', 'state', 'country', 'postcode'] as const)\n    .map((key) => address[key])\n    .filter(Boolean)\n    .join(', ');\n};\n\nexport const parseAddress = (value: unknown): TableAddress => {\n  if (value == null || value === '') return {};\n  if (typeof value === 'string') return { street: value };\n  if (typeof value !== 'object') return { street: String(value) };\n  const source = value as Record<string, unknown>;\n  const next: TableAddress = {};\n  (['street', 'street2', 'city', 'state', 'country', 'postcode'] as const).forEach((key) => {\n    const part = source[key];\n    if (part != null && part !== '') next[key] = String(part);\n  });\n  return next;\n};\n\n/**\n * 单元格在**画面上**显示成什么 —— 供 a11y 隐藏层与剪贴板桥使用。\n *\n * 画布上的 select / tag / user / array 是 painter 把标签映射**闭包**进去画的，而\n * `getCellValue()` 给的是记录里的原始值：屏幕阅读器因此朗读 `done` 而不是「已完成」，\n * 对象值更是直接读成 `[object Object]`（画布上明明是姓名）。这里按同一套映射还原成\n * 人能读的文本。\n *\n * `markers` 取编译后的列上的 `superadKind` / `superadOptions`（见 `vtable/columns.ts`）。\n */\nexport const describeCellValue = (\n  value: unknown,\n  markers?: {\n    duration?: string | { from: string; to: string };\n    kind?: string;\n    options?: TableSelectOption[];\n  },\n  record?: unknown,\n): string => {\n  if (value == null || value === '') return '';\n  const kind = markers?.kind;\n\n  if (kind === 'select' || kind === 'tag') {\n    const labels = toValueList(value)\n      .map((item) => resolveOption(item, markers?.options).label)\n      .filter((label) => label !== '');\n    // 画布上时长标注画在最后一枚 chip 后面 —— 读屏与剪贴板也带上，两边口径一致。\n    const durationText = formatDuration(resolveDurationRange(record, markers?.duration));\n    const suffix = durationText === '' ? '' : ` ${durationText}`;\n\n    return `${labels.join('、')}${suffix}`;\n  }\n  if (kind === 'user') {\n    return toValueList(value)\n      .map(resolveUser)\n      .map((user) => user.name)\n      .filter(Boolean)\n      .join('、');\n  }\n  if (kind === 'array') return toValueList(value).map(String).join('、');\n  if (kind === 'boolean' || kind === 'checkbox') {\n    const boolean = toBoolean(value);\n    return boolean == null ? '' : boolean ? '是' : '否';\n  }\n  // 兜底：对象值别读成 \"[object Object]\"。\n  if (typeof value === 'object') return formatJson(value);\n  return String(value);\n};\n"],"mappings":"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"}