@canvas-components/utils 0.1.5 → 0.2.1

package/README.md

@@ -1,96 +1,114 @@
-# @canvas-components/utils
-
-`@canvas-components/utils` 提供和表格外围常见流程相关的浏览器工具能力，主要覆盖剪贴板写入和导出文件。
-
-## 功能作用
-
+# @canvas-components/utils
+
+`@canvas-components/utils` 提供表格包之间可复用的纯原生工具能力，覆盖数据读取、剪贴板写入和导出文件。
+
+## 功能作用
+
 - 写入文本、二维表格文本、JSON 到系统剪贴板
-- 把行列数据导出为 `csv`、`txt`、`xlsx`
-- 生成导出前的中间文本 / 记录结构
-- 对大批量导出做分片让步，减少主线程长时间阻塞
-
-## 安装方法
-
-```bash
-pnpm add @canvas-components/utils
-```
-
-最低环境要求：
-
-- `Node.js >= 18.12.0`
-- `pnpm >= 9.0.0`
-
-## 使用方法
-
-```ts
-import {
-  copyRows,
-  exportTableToXlsx,
-} from "@canvas-components/utils";
-
-await copyRows([
-  ["姓名", "年龄"],
-  ["张三", 28],
-  ["李四", 31],
-]);
-
-await exportTableToXlsx({
-  fileName: "users.xlsx",
-  rows: [
-    { name: "张三", age: 28 },
-    { name: "李四", age: 31 },
-  ],
-  columns: [
-    { key: "name", title: "姓名", value: (row) => row.name },
-    { key: "age", title: "年龄", value: (row) => row.age },
-  ],
-});
-```
-
-## 属性说明
-
-### `ExportTableColumn<Row>`
-
-| 属性 | 类型 | 说明 |
-| --- | --- | --- |
-| `key` | `string` | 列唯一标识 |
-| `title` | `string` | 导出列标题 |
-| `value` | `(row: Row, index: number) => unknown` | 从行数据中取导出值 |
-
-### `ClipboardCellValue`
-
-支持的剪贴板单元格值类型：
-
-```ts
-type ClipboardCellValue = string | number | boolean | null | undefined;
-```
-
-## 方法说明
+- 通过 `dataIndex` 安全读取嵌套数据
+- 复用数据路径比较、数值约束和矩形命中等纯函数
+- 把行列数据导出为 `csv`、`txt`、`xlsx`
+- 生成导出前的中间文本 / 记录结构
+- 对大批量导出做分片让步，减少主线程长时间阻塞
+
+## 安装方法
+
+```bash
+pnpm add @canvas-components/utils
+```
+
+最低环境要求：
+
+- `Node.js >= 18.12.0`
+- `pnpm >= 9.0.0`
+
+## 使用方法
+
+```ts
+import {
+  copyRows,
+  exportTableToXlsx,
+} from "@canvas-components/utils";
+
+await copyRows([
+  ["姓名", "年龄"],
+  ["张三", 28],
+  ["李四", 31],
+]);
+
+await exportTableToXlsx({
+  fileName: "users.xlsx",
+  rows: [
+    { name: "张三", age: 28 },
+    { name: "李四", age: 31 },
+  ],
+  columns: [
+    { key: "name", title: "姓名", value: (row) => row.name },
+    { key: "age", title: "年龄", value: (row) => row.age },
+  ],
+});
+```
+
+## 属性说明
+
+### `ExportTableColumn<Row>`
+
+| 属性 | 类型 | 说明 |
+| --- | --- | --- |
+| `key` | `string` | 列唯一标识 |
+| `title` | `string` | 导出列标题 |
+| `value` | `(row: Row, index: number) => unknown` | 从行数据中取导出值 |
+
+### `ClipboardCellValue`
+
+支持的剪贴板单元格值类型：
+
+```ts
+type ClipboardCellValue = string | number | boolean | null | undefined;
+```
+
+## 方法说明
+
+### 剪贴板
+
+| 方法 | 签名 | 说明 |
+| --- | --- | --- |
+| `copyText` | `(text: string) => Promise<void>` | 写入纯文本 |
+| `copyRows` | `(rows: ClipboardCellValue[][]) => Promise<void>` | 把二维数据写入剪贴板 |
+| `copyJson` | `(value: unknown, space = 2) => Promise<void>` | 写入 JSON 文本 |
+| `formatRowsForClipboard` | `(rows) => string` | 把二维数据转成制表符文本 |
+
+### 导出
+
+| 方法 | 签名 | 说明 |
+| --- | --- | --- |
+| `mapRowsToExportRecords` | `({ rows, columns }) => Record<string, unknown>[]` | 生成导出记录数组 |
+| `buildCsvContent` | `({ rows, columns }) => string` | 生成 CSV 文本 |
+| `serializeCsvRows` | `(rows, lineBreak?) => string` | 将二维数据序列化为 CSV 文本 |
+| `buildTxtContent` | `({ rows, columns }) => string` | 生成 TXT 文本 |
+| `downloadJsonFile` | `({ fileName, data, space? }) => Promise<void>` | 下载 JSON |
+| `exportTableToCsv` | `({ fileName, rows, columns }) => Promise<void>` | 导出 CSV |
+| `exportTableToTxt` | `({ fileName, rows, columns }) => Promise<void>` | 导出 TXT |
+| `exportTableToXlsx` | `({ fileName, rows, columns, sheetName? }) => Promise<void>` | 导出 XLSX |
 
-### 剪贴板
+### 数据读取
 
 | 方法 | 签名 | 说明 |
 | --- | --- | --- |
-| `copyText` | `(text: string) => Promise<void>` | 写入纯文本 |
-| `copyRows` | `(rows: ClipboardCellValue[][]) => Promise<void>` | 把二维数据写入剪贴板 |
-| `copyJson` | `(value: unknown, space = 2) => Promise<void>` | 写入 JSON 文本 |
-| `formatRowsForClipboard` | `(rows) => string` | 把二维数据转成制表符文本 |
+| `getValueByDataIndex` | `(source, dataIndex?) => unknown` | 通过字符串、数字或属性路径数组安全读取嵌套值 |
+| `stringifyDataIndex` | `(dataIndex) => string` | 将属性路径转换为稳定字符串 |
+| `isSameDataIndex` | `(left, right) => boolean` | 判断两个属性路径是否一致 |
 
-### 导出
+### 基础几何
 
 | 方法 | 签名 | 说明 |
 | --- | --- | --- |
-| `mapRowsToExportRecords` | `({ rows, columns }) => Record<string, unknown>[]` | 生成导出记录数组 |
-| `buildCsvContent` | `({ rows, columns }) => string` | 生成 CSV 文本 |
-| `buildTxtContent` | `({ rows, columns }) => string` | 生成 TXT 文本 |
-| `downloadJsonFile` | `({ fileName, data, space? }) => Promise<void>` | 下载 JSON |
-| `exportTableToCsv` | `({ fileName, rows, columns }) => Promise<void>` | 导出 CSV |
-| `exportTableToTxt` | `({ fileName, rows, columns }) => Promise<void>` | 导出 TXT |
-| `exportTableToXlsx` | `({ fileName, rows, columns, sheetName? }) => Promise<void>` | 导出 XLSX |
-
-## 适用场景
-
-- 表格导出
-- 系统复制功能
-- 大批量数据下载
-- 非 React 项目里的浏览器工具函数复用
+| `clamp` | `(value, minimum, maximum) => number` | 将数值限制在闭区间内 |
+| `isPointInRect` | `(x, y, rect) => boolean` | 判断坐标是否位于矩形内 |
+
+## 适用场景
+
+- 表格导出
+- 系统复制功能
+- 大批量数据下载
+- 非 React 项目里的浏览器工具函数复用

package/dist/clipboard/index.cjs

@@ -1,12 +1,43 @@
 'use strict';
 
 // src/clipboard/index.ts
-async function copyText(text) {
-  if (navigator.clipboard?.writeText) {
-    await navigator.clipboard.writeText(text);
-    return;
+async function copyText(text, ownerDocument = document) {
+  const clipboard = ownerDocument.defaultView?.navigator.clipboard;
+  try {
+    if (clipboard?.writeText) {
+      await clipboard.writeText(text);
+      return true;
+    }
+  } catch {
+  }
+  return copyTextSync(text, ownerDocument);
+}
+function copyTextSync(text, ownerDocument = document) {
+  const activeElement = ownerDocument.activeElement;
+  const textarea = ownerDocument.createElement("textarea");
+  textarea.value = text;
+  textarea.setAttribute("readonly", "true");
+  textarea.style.position = "fixed";
+  textarea.style.left = "-9999px";
+  textarea.style.top = "0";
+  textarea.style.opacity = "0";
+  ownerDocument.body.appendChild(textarea);
+  textarea.focus({ preventScroll: true });
+  textarea.select();
+  textarea.setSelectionRange(0, textarea.value.length);
+  let copied = false;
+  try {
+    copied = ownerDocument.execCommand?.("copy") ?? false;
+  } catch {
+    copied = false;
+  } finally {
+    textarea.remove();
+    const HTMLElementConstructor = ownerDocument.defaultView?.HTMLElement;
+    if (HTMLElementConstructor && activeElement instanceof HTMLElementConstructor) {
+      activeElement.focus({ preventScroll: true });
+    }
   }
-  copyTextByTextarea(text);
+  return copied;
 }
 async function copyRows(rows) {
   await copyText(formatRowsForClipboard(rows));
@@ -23,27 +54,11 @@ function formatClipboardCell(value) {
   }
   return String(value);
 }
-function copyTextByTextarea(text) {
-  const textarea = document.createElement("textarea");
-  textarea.value = text;
-  textarea.setAttribute("readonly", "true");
-  textarea.style.position = "fixed";
-  textarea.style.left = "-9999px";
-  textarea.style.top = "0";
-  textarea.style.opacity = "0";
-  document.body.appendChild(textarea);
-  textarea.select();
-  textarea.setSelectionRange(0, textarea.value.length);
-  try {
-    document.execCommand("copy");
-  } finally {
-    textarea.remove();
-  }
-}
 
 exports.copyJson = copyJson;
 exports.copyRows = copyRows;
 exports.copyText = copyText;
+exports.copyTextSync = copyTextSync;
 exports.formatRowsForClipboard = formatRowsForClipboard;
 //# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map

package/dist/clipboard/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/clipboard/index.ts"],"names":[],"mappings":";;;AAUA,eAAsB,SAAS,IAAA,EAAc;AAC3C,EAAA,IAAI,SAAA,CAAU,WAAW,SAAA,EAAW;AAClC,IAAA,MAAM,SAAA,CAAU,SAAA,CAAU,SAAA,CAAU,IAAI,CAAA;AACxC,IAAA;AAAA,EACF;AAEA,EAAA,kBAAA,CAAmB,IAAI,CAAA;AACzB;AAKA,eAAsB,SAAS,IAAA,EAA8B;AAC3D,EAAA,MAAM,QAAA,CAAS,sBAAA,CAAuB,IAAI,CAAC,CAAA;AAC7C;AAKA,eAAsB,QAAA,CAAS,KAAA,EAAgB,KAAA,GAAQ,CAAA,EAAG;AACxD,EAAA,MAAM,SAAS,IAAA,CAAK,SAAA,CAAU,OAAO,IAAA,EAAM,KAAK,KAAK,EAAE,CAAA;AACzD;AAKO,SAAS,uBAAuB,IAAA,EAA8B;AACnE,EAAA,OAAO,IAAA,CACJ,GAAA,CAAI,CAAC,GAAA,KAAQ,GAAA,CAAI,GAAA,CAAI,mBAAmB,CAAA,CAAE,IAAA,CAAK,GAAI,CAAC,CAAA,CACpD,KAAK,IAAI,CAAA;AACd;AAEA,SAAS,oBAAoB,KAAA,EAA2B;AACtD,EAAA,IAAI,SAAS,IAAA,EAAM;AACjB,IAAA,OAAO,EAAA;AAAA,EACT;AAEA,EAAA,OAAO,OAAO,KAAK,CAAA;AACrB;AAEA,SAAS,mBAAmB,IAAA,EAAc;AACxC,EAAA,MAAM,QAAA,GAAW,QAAA,CAAS,aAAA,CAAc,UAAU,CAAA;AAClD,EAAA,QAAA,CAAS,KAAA,GAAQ,IAAA;AACjB,EAAA,QAAA,CAAS,YAAA,CAAa,YAAY,MAAM,CAAA;AACxC,EAAA,QAAA,CAAS,MAAM,QAAA,GAAW,OAAA;AAC1B,EAAA,QAAA,CAAS,MAAM,IAAA,GAAO,SAAA;AACtB,EAAA,QAAA,CAAS,MAAM,GAAA,GAAM,GAAA;AACrB,EAAA,QAAA,CAAS,MAAM,OAAA,GAAU,GAAA;AAEzB,EAAA,QAAA,CAAS,IAAA,CAAK,YAAY,QAAQ,CAAA;AAClC,EAAA,QAAA,CAAS,MAAA,EAAO;AAChB,EAAA,QAAA,CAAS,iBAAA,CAAkB,CAAA,EAAG,QAAA,CAAS,KAAA,CAAM,MAAM,CAAA;AAEnD,EAAA,IAAI;AACF,IAAA,QAAA,CAAS,YAAY,MAAM,CAAA;AAAA,EAC7B,CAAA,SAAE;AACA,IAAA,QAAA,CAAS,MAAA,EAAO;AAAA,EAClB;AACF","file":"index.cjs","sourcesContent":["export type ClipboardCellValue =\r\n  | string\r\n  | number\r\n  | boolean\r\n  | null\r\n  | undefined;\r\n\r\n/**\r\n * 写入纯文本到系统剪贴板。\r\n */\r\nexport async function copyText(text: string) {\r\n  if (navigator.clipboard?.writeText) {\r\n    await navigator.clipboard.writeText(text);\r\n    return;\r\n  }\r\n\r\n  copyTextByTextarea(text);\r\n}\r\n\r\n/**\r\n * 写入二维表格文本到系统剪贴板。\r\n */\r\nexport async function copyRows(rows: ClipboardCellValue[][]) {\r\n  await copyText(formatRowsForClipboard(rows));\r\n}\r\n\r\n/**\r\n * 写入 JSON 文本到系统剪贴板。\r\n */\r\nexport async function copyJson(value: unknown, space = 2) {\r\n  await copyText(JSON.stringify(value, null, space) ?? \"\");\r\n}\r\n\r\n/**\r\n * 格式化二维数据为剪贴板友好的文本。\r\n */\r\nexport function formatRowsForClipboard(rows: ClipboardCellValue[][]) {\r\n  return rows\r\n    .map((row) => row.map(formatClipboardCell).join(\"\\t\"))\r\n    .join(\"\\n\");\r\n}\r\n\r\nfunction formatClipboardCell(value: ClipboardCellValue) {\r\n  if (value == null) {\r\n    return \"\";\r\n  }\r\n\r\n  return String(value);\r\n}\r\n\r\nfunction copyTextByTextarea(text: string) {\r\n  const textarea = document.createElement(\"textarea\");\r\n  textarea.value = text;\r\n  textarea.setAttribute(\"readonly\", \"true\");\r\n  textarea.style.position = \"fixed\";\r\n  textarea.style.left = \"-9999px\";\r\n  textarea.style.top = \"0\";\r\n  textarea.style.opacity = \"0\";\r\n\r\n  document.body.appendChild(textarea);\r\n  textarea.select();\r\n  textarea.setSelectionRange(0, textarea.value.length);\r\n\r\n  try {\r\n    document.execCommand(\"copy\");\r\n  } finally {\r\n    textarea.remove();\r\n  }\r\n}\r\n"]}
+{"version":3,"sources":["../../src/clipboard/index.ts"],"names":[],"mappings":";;;AAKA,eAAsB,QAAA,CAAS,IAAA,EAAc,aAAA,GAAgB,QAAA,EAAU;AACrE,EAAA,MAAM,SAAA,GAAY,aAAA,CAAc,WAAA,EAAa,SAAA,CAAU,SAAA;AACvD,EAAA,IAAI;AACF,IAAA,IAAI,WAAW,SAAA,EAAW;AACxB,MAAA,MAAM,SAAA,CAAU,UAAU,IAAI,CAAA;AAC9B,MAAA,OAAO,IAAA;AAAA,IACT;AAAA,EACF,CAAA,CAAA,MAAQ;AAAA,EAER;AAEA,EAAA,OAAO,YAAA,CAAa,MAAM,aAAa,CAAA;AACzC;AAGO,SAAS,YAAA,CAAa,IAAA,EAAc,aAAA,GAAgB,QAAA,EAAU;AACnE,EAAA,MAAM,gBAAgB,aAAA,CAAc,aAAA;AACpC,EAAA,MAAM,QAAA,GAAW,aAAA,CAAc,aAAA,CAAc,UAAU,CAAA;AACvD,EAAA,QAAA,CAAS,KAAA,GAAQ,IAAA;AACjB,EAAA,QAAA,CAAS,YAAA,CAAa,YAAY,MAAM,CAAA;AACxC,EAAA,QAAA,CAAS,MAAM,QAAA,GAAW,OAAA;AAC1B,EAAA,QAAA,CAAS,MAAM,IAAA,GAAO,SAAA;AACtB,EAAA,QAAA,CAAS,MAAM,GAAA,GAAM,GAAA;AACrB,EAAA,QAAA,CAAS,MAAM,OAAA,GAAU,GAAA;AAEzB,EAAA,aAAA,CAAc,IAAA,CAAK,YAAY,QAAQ,CAAA;AACvC,EAAA,QAAA,CAAS,KAAA,CAAM,EAAE,aAAA,EAAe,IAAA,EAAM,CAAA;AACtC,EAAA,QAAA,CAAS,MAAA,EAAO;AAChB,EAAA,QAAA,CAAS,iBAAA,CAAkB,CAAA,EAAG,QAAA,CAAS,KAAA,CAAM,MAAM,CAAA;AAEnD,EAAA,IAAI,MAAA,GAAS,KAAA;AACb,EAAA,IAAI;AACF,IAAA,MAAA,GAAS,aAAA,CAAc,WAAA,GAAc,MAAM,CAAA,IAAK,KAAA;AAAA,EAClD,CAAA,CAAA,MAAQ;AACN,IAAA,MAAA,GAAS,KAAA;AAAA,EACX,CAAA,SAAE;AACA,IAAA,QAAA,CAAS,MAAA,EAAO;AAChB,IAAA,MAAM,sBAAA,GAAyB,cAAc,WAAA,EAAa,WAAA;AAC1D,IAAA,IACE,sBAAA,IACA,yBAAyB,sBAAA,EACzB;AACA,MAAA,aAAA,CAAc,KAAA,CAAM,EAAE,aAAA,EAAe,IAAA,EAAM,CAAA;AAAA,IAC7C;AAAA,EACF;AACA,EAAA,OAAO,MAAA;AACT;AAKA,eAAsB,SAAS,IAAA,EAA8B;AAC3D,EAAA,MAAM,QAAA,CAAS,sBAAA,CAAuB,IAAI,CAAC,CAAA;AAC7C;AAKA,eAAsB,QAAA,CAAS,KAAA,EAAgB,KAAA,GAAQ,CAAA,EAAG;AACxD,EAAA,MAAM,SAAS,IAAA,CAAK,SAAA,CAAU,OAAO,IAAA,EAAM,KAAK,KAAK,EAAE,CAAA;AACzD;AAKO,SAAS,uBAAuB,IAAA,EAA8B;AACnE,EAAA,OAAO,IAAA,CAAK,GAAA,CAAI,CAAC,GAAA,KAAQ,GAAA,CAAI,GAAA,CAAI,mBAAmB,CAAA,CAAE,IAAA,CAAK,GAAI,CAAC,CAAA,CAAE,KAAK,IAAI,CAAA;AAC7E;AAEA,SAAS,oBAAoB,KAAA,EAA2B;AACtD,EAAA,IAAI,SAAS,IAAA,EAAM;AACjB,IAAA,OAAO,EAAA;AAAA,EACT;AAEA,EAAA,OAAO,OAAO,KAAK,CAAA;AACrB","file":"index.cjs","sourcesContent":["export type ClipboardCellValue = string | number | boolean | null | undefined;\n\n/**\n * 写入纯文本到系统剪贴板。\n */\nexport async function copyText(text: string, ownerDocument = document) {\n  const clipboard = ownerDocument.defaultView?.navigator.clipboard;\n  try {\n    if (clipboard?.writeText) {\n      await clipboard.writeText(text);\n      return true;\n    }\n  } catch {\n    // 非安全上下文或权限拒绝时回退到同步 DOM 复制。\n  }\n\n  return copyTextSync(text, ownerDocument);\n}\n\n/** 在当前用户激活事件中同步复制纯文本。 */\nexport function copyTextSync(text: string, ownerDocument = document) {\n  const activeElement = ownerDocument.activeElement;\n  const textarea = ownerDocument.createElement(\"textarea\");\n  textarea.value = text;\n  textarea.setAttribute(\"readonly\", \"true\");\n  textarea.style.position = \"fixed\";\n  textarea.style.left = \"-9999px\";\n  textarea.style.top = \"0\";\n  textarea.style.opacity = \"0\";\n\n  ownerDocument.body.appendChild(textarea);\n  textarea.focus({ preventScroll: true });\n  textarea.select();\n  textarea.setSelectionRange(0, textarea.value.length);\n\n  let copied = false;\n  try {\n    copied = ownerDocument.execCommand?.(\"copy\") ?? false;\n  } catch {\n    copied = false;\n  } finally {\n    textarea.remove();\n    const HTMLElementConstructor = ownerDocument.defaultView?.HTMLElement;\n    if (\n      HTMLElementConstructor &&\n      activeElement instanceof HTMLElementConstructor\n    ) {\n      activeElement.focus({ preventScroll: true });\n    }\n  }\n  return copied;\n}\n\n/**\n * 写入二维表格文本到系统剪贴板。\n */\nexport async function copyRows(rows: ClipboardCellValue[][]) {\n  await copyText(formatRowsForClipboard(rows));\n}\n\n/**\n * 写入 JSON 文本到系统剪贴板。\n */\nexport async function copyJson(value: unknown, space = 2) {\n  await copyText(JSON.stringify(value, null, space) ?? \"\");\n}\n\n/**\n * 格式化二维数据为剪贴板友好的文本。\n */\nexport function formatRowsForClipboard(rows: ClipboardCellValue[][]) {\n  return rows.map((row) => row.map(formatClipboardCell).join(\"\\t\")).join(\"\\n\");\n}\n\nfunction formatClipboardCell(value: ClipboardCellValue) {\n  if (value == null) {\n    return \"\";\n  }\n\n  return String(value);\n}\n"]}

package/dist/clipboard/index.d.cts

@@ -2,7 +2,9 @@ type ClipboardCellValue = string | number | boolean | null | undefined;
 /**
  * 写入纯文本到系统剪贴板。
  */
-declare function copyText(text: string): Promise<void>;
+declare function copyText(text: string, ownerDocument?: Document): Promise<boolean>;
+/** 在当前用户激活事件中同步复制纯文本。 */
+declare function copyTextSync(text: string, ownerDocument?: Document): boolean;
 /**
  * 写入二维表格文本到系统剪贴板。
  */
@@ -16,4 +18,4 @@ declare function copyJson(value: unknown, space?: number): Promise<void>;
  */
 declare function formatRowsForClipboard(rows: ClipboardCellValue[][]): string;
 
-export { type ClipboardCellValue, copyJson, copyRows, copyText, formatRowsForClipboard };
+export { type ClipboardCellValue, copyJson, copyRows, copyText, copyTextSync, formatRowsForClipboard };

package/dist/clipboard/index.d.ts

@@ -2,7 +2,9 @@ type ClipboardCellValue = string | number | boolean | null | undefined;
 /**
  * 写入纯文本到系统剪贴板。
  */
-declare function copyText(text: string): Promise<void>;
+declare function copyText(text: string, ownerDocument?: Document): Promise<boolean>;
+/** 在当前用户激活事件中同步复制纯文本。 */
+declare function copyTextSync(text: string, ownerDocument?: Document): boolean;
 /**
  * 写入二维表格文本到系统剪贴板。
  */
@@ -16,4 +18,4 @@ declare function copyJson(value: unknown, space?: number): Promise<void>;
  */
 declare function formatRowsForClipboard(rows: ClipboardCellValue[][]): string;
 
-export { type ClipboardCellValue, copyJson, copyRows, copyText, formatRowsForClipboard };
+export { type ClipboardCellValue, copyJson, copyRows, copyText, copyTextSync, formatRowsForClipboard };

package/dist/clipboard/index.js

@@ -1,10 +1,41 @@
 // src/clipboard/index.ts
-async function copyText(text) {
-  if (navigator.clipboard?.writeText) {
-    await navigator.clipboard.writeText(text);
-    return;
+async function copyText(text, ownerDocument = document) {
+  const clipboard = ownerDocument.defaultView?.navigator.clipboard;
+  try {
+    if (clipboard?.writeText) {
+      await clipboard.writeText(text);
+      return true;
+    }
+  } catch {
+  }
+  return copyTextSync(text, ownerDocument);
+}
+function copyTextSync(text, ownerDocument = document) {
+  const activeElement = ownerDocument.activeElement;
+  const textarea = ownerDocument.createElement("textarea");
+  textarea.value = text;
+  textarea.setAttribute("readonly", "true");
+  textarea.style.position = "fixed";
+  textarea.style.left = "-9999px";
+  textarea.style.top = "0";
+  textarea.style.opacity = "0";
+  ownerDocument.body.appendChild(textarea);
+  textarea.focus({ preventScroll: true });
+  textarea.select();
+  textarea.setSelectionRange(0, textarea.value.length);
+  let copied = false;
+  try {
+    copied = ownerDocument.execCommand?.("copy") ?? false;
+  } catch {
+    copied = false;
+  } finally {
+    textarea.remove();
+    const HTMLElementConstructor = ownerDocument.defaultView?.HTMLElement;
+    if (HTMLElementConstructor && activeElement instanceof HTMLElementConstructor) {
+      activeElement.focus({ preventScroll: true });
+    }
   }
-  copyTextByTextarea(text);
+  return copied;
 }
 async function copyRows(rows) {
   await copyText(formatRowsForClipboard(rows));
@@ -21,24 +52,7 @@ function formatClipboardCell(value) {
   }
   return String(value);
 }
-function copyTextByTextarea(text) {
-  const textarea = document.createElement("textarea");
-  textarea.value = text;
-  textarea.setAttribute("readonly", "true");
-  textarea.style.position = "fixed";
-  textarea.style.left = "-9999px";
-  textarea.style.top = "0";
-  textarea.style.opacity = "0";
-  document.body.appendChild(textarea);
-  textarea.select();
-  textarea.setSelectionRange(0, textarea.value.length);
-  try {
-    document.execCommand("copy");
-  } finally {
-    textarea.remove();
-  }
-}
 
-export { copyJson, copyRows, copyText, formatRowsForClipboard };
+export { copyJson, copyRows, copyText, copyTextSync, formatRowsForClipboard };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/clipboard/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/clipboard/index.ts"],"names":[],"mappings":";AAUA,eAAsB,SAAS,IAAA,EAAc;AAC3C,EAAA,IAAI,SAAA,CAAU,WAAW,SAAA,EAAW;AAClC,IAAA,MAAM,SAAA,CAAU,SAAA,CAAU,SAAA,CAAU,IAAI,CAAA;AACxC,IAAA;AAAA,EACF;AAEA,EAAA,kBAAA,CAAmB,IAAI,CAAA;AACzB;AAKA,eAAsB,SAAS,IAAA,EAA8B;AAC3D,EAAA,MAAM,QAAA,CAAS,sBAAA,CAAuB,IAAI,CAAC,CAAA;AAC7C;AAKA,eAAsB,QAAA,CAAS,KAAA,EAAgB,KAAA,GAAQ,CAAA,EAAG;AACxD,EAAA,MAAM,SAAS,IAAA,CAAK,SAAA,CAAU,OAAO,IAAA,EAAM,KAAK,KAAK,EAAE,CAAA;AACzD;AAKO,SAAS,uBAAuB,IAAA,EAA8B;AACnE,EAAA,OAAO,IAAA,CACJ,GAAA,CAAI,CAAC,GAAA,KAAQ,GAAA,CAAI,GAAA,CAAI,mBAAmB,CAAA,CAAE,IAAA,CAAK,GAAI,CAAC,CAAA,CACpD,KAAK,IAAI,CAAA;AACd;AAEA,SAAS,oBAAoB,KAAA,EAA2B;AACtD,EAAA,IAAI,SAAS,IAAA,EAAM;AACjB,IAAA,OAAO,EAAA;AAAA,EACT;AAEA,EAAA,OAAO,OAAO,KAAK,CAAA;AACrB;AAEA,SAAS,mBAAmB,IAAA,EAAc;AACxC,EAAA,MAAM,QAAA,GAAW,QAAA,CAAS,aAAA,CAAc,UAAU,CAAA;AAClD,EAAA,QAAA,CAAS,KAAA,GAAQ,IAAA;AACjB,EAAA,QAAA,CAAS,YAAA,CAAa,YAAY,MAAM,CAAA;AACxC,EAAA,QAAA,CAAS,MAAM,QAAA,GAAW,OAAA;AAC1B,EAAA,QAAA,CAAS,MAAM,IAAA,GAAO,SAAA;AACtB,EAAA,QAAA,CAAS,MAAM,GAAA,GAAM,GAAA;AACrB,EAAA,QAAA,CAAS,MAAM,OAAA,GAAU,GAAA;AAEzB,EAAA,QAAA,CAAS,IAAA,CAAK,YAAY,QAAQ,CAAA;AAClC,EAAA,QAAA,CAAS,MAAA,EAAO;AAChB,EAAA,QAAA,CAAS,iBAAA,CAAkB,CAAA,EAAG,QAAA,CAAS,KAAA,CAAM,MAAM,CAAA;AAEnD,EAAA,IAAI;AACF,IAAA,QAAA,CAAS,YAAY,MAAM,CAAA;AAAA,EAC7B,CAAA,SAAE;AACA,IAAA,QAAA,CAAS,MAAA,EAAO;AAAA,EAClB;AACF","file":"index.js","sourcesContent":["export type ClipboardCellValue =\r\n  | string\r\n  | number\r\n  | boolean\r\n  | null\r\n  | undefined;\r\n\r\n/**\r\n * 写入纯文本到系统剪贴板。\r\n */\r\nexport async function copyText(text: string) {\r\n  if (navigator.clipboard?.writeText) {\r\n    await navigator.clipboard.writeText(text);\r\n    return;\r\n  }\r\n\r\n  copyTextByTextarea(text);\r\n}\r\n\r\n/**\r\n * 写入二维表格文本到系统剪贴板。\r\n */\r\nexport async function copyRows(rows: ClipboardCellValue[][]) {\r\n  await copyText(formatRowsForClipboard(rows));\r\n}\r\n\r\n/**\r\n * 写入 JSON 文本到系统剪贴板。\r\n */\r\nexport async function copyJson(value: unknown, space = 2) {\r\n  await copyText(JSON.stringify(value, null, space) ?? \"\");\r\n}\r\n\r\n/**\r\n * 格式化二维数据为剪贴板友好的文本。\r\n */\r\nexport function formatRowsForClipboard(rows: ClipboardCellValue[][]) {\r\n  return rows\r\n    .map((row) => row.map(formatClipboardCell).join(\"\\t\"))\r\n    .join(\"\\n\");\r\n}\r\n\r\nfunction formatClipboardCell(value: ClipboardCellValue) {\r\n  if (value == null) {\r\n    return \"\";\r\n  }\r\n\r\n  return String(value);\r\n}\r\n\r\nfunction copyTextByTextarea(text: string) {\r\n  const textarea = document.createElement(\"textarea\");\r\n  textarea.value = text;\r\n  textarea.setAttribute(\"readonly\", \"true\");\r\n  textarea.style.position = \"fixed\";\r\n  textarea.style.left = \"-9999px\";\r\n  textarea.style.top = \"0\";\r\n  textarea.style.opacity = \"0\";\r\n\r\n  document.body.appendChild(textarea);\r\n  textarea.select();\r\n  textarea.setSelectionRange(0, textarea.value.length);\r\n\r\n  try {\r\n    document.execCommand(\"copy\");\r\n  } finally {\r\n    textarea.remove();\r\n  }\r\n}\r\n"]}
+{"version":3,"sources":["../../src/clipboard/index.ts"],"names":[],"mappings":";AAKA,eAAsB,QAAA,CAAS,IAAA,EAAc,aAAA,GAAgB,QAAA,EAAU;AACrE,EAAA,MAAM,SAAA,GAAY,aAAA,CAAc,WAAA,EAAa,SAAA,CAAU,SAAA;AACvD,EAAA,IAAI;AACF,IAAA,IAAI,WAAW,SAAA,EAAW;AACxB,MAAA,MAAM,SAAA,CAAU,UAAU,IAAI,CAAA;AAC9B,MAAA,OAAO,IAAA;AAAA,IACT;AAAA,EACF,CAAA,CAAA,MAAQ;AAAA,EAER;AAEA,EAAA,OAAO,YAAA,CAAa,MAAM,aAAa,CAAA;AACzC;AAGO,SAAS,YAAA,CAAa,IAAA,EAAc,aAAA,GAAgB,QAAA,EAAU;AACnE,EAAA,MAAM,gBAAgB,aAAA,CAAc,aAAA;AACpC,EAAA,MAAM,QAAA,GAAW,aAAA,CAAc,aAAA,CAAc,UAAU,CAAA;AACvD,EAAA,QAAA,CAAS,KAAA,GAAQ,IAAA;AACjB,EAAA,QAAA,CAAS,YAAA,CAAa,YAAY,MAAM,CAAA;AACxC,EAAA,QAAA,CAAS,MAAM,QAAA,GAAW,OAAA;AAC1B,EAAA,QAAA,CAAS,MAAM,IAAA,GAAO,SAAA;AACtB,EAAA,QAAA,CAAS,MAAM,GAAA,GAAM,GAAA;AACrB,EAAA,QAAA,CAAS,MAAM,OAAA,GAAU,GAAA;AAEzB,EAAA,aAAA,CAAc,IAAA,CAAK,YAAY,QAAQ,CAAA;AACvC,EAAA,QAAA,CAAS,KAAA,CAAM,EAAE,aAAA,EAAe,IAAA,EAAM,CAAA;AACtC,EAAA,QAAA,CAAS,MAAA,EAAO;AAChB,EAAA,QAAA,CAAS,iBAAA,CAAkB,CAAA,EAAG,QAAA,CAAS,KAAA,CAAM,MAAM,CAAA;AAEnD,EAAA,IAAI,MAAA,GAAS,KAAA;AACb,EAAA,IAAI;AACF,IAAA,MAAA,GAAS,aAAA,CAAc,WAAA,GAAc,MAAM,CAAA,IAAK,KAAA;AAAA,EAClD,CAAA,CAAA,MAAQ;AACN,IAAA,MAAA,GAAS,KAAA;AAAA,EACX,CAAA,SAAE;AACA,IAAA,QAAA,CAAS,MAAA,EAAO;AAChB,IAAA,MAAM,sBAAA,GAAyB,cAAc,WAAA,EAAa,WAAA;AAC1D,IAAA,IACE,sBAAA,IACA,yBAAyB,sBAAA,EACzB;AACA,MAAA,aAAA,CAAc,KAAA,CAAM,EAAE,aAAA,EAAe,IAAA,EAAM,CAAA;AAAA,IAC7C;AAAA,EACF;AACA,EAAA,OAAO,MAAA;AACT;AAKA,eAAsB,SAAS,IAAA,EAA8B;AAC3D,EAAA,MAAM,QAAA,CAAS,sBAAA,CAAuB,IAAI,CAAC,CAAA;AAC7C;AAKA,eAAsB,QAAA,CAAS,KAAA,EAAgB,KAAA,GAAQ,CAAA,EAAG;AACxD,EAAA,MAAM,SAAS,IAAA,CAAK,SAAA,CAAU,OAAO,IAAA,EAAM,KAAK,KAAK,EAAE,CAAA;AACzD;AAKO,SAAS,uBAAuB,IAAA,EAA8B;AACnE,EAAA,OAAO,IAAA,CAAK,GAAA,CAAI,CAAC,GAAA,KAAQ,GAAA,CAAI,GAAA,CAAI,mBAAmB,CAAA,CAAE,IAAA,CAAK,GAAI,CAAC,CAAA,CAAE,KAAK,IAAI,CAAA;AAC7E;AAEA,SAAS,oBAAoB,KAAA,EAA2B;AACtD,EAAA,IAAI,SAAS,IAAA,EAAM;AACjB,IAAA,OAAO,EAAA;AAAA,EACT;AAEA,EAAA,OAAO,OAAO,KAAK,CAAA;AACrB","file":"index.js","sourcesContent":["export type ClipboardCellValue = string | number | boolean | null | undefined;\n\n/**\n * 写入纯文本到系统剪贴板。\n */\nexport async function copyText(text: string, ownerDocument = document) {\n  const clipboard = ownerDocument.defaultView?.navigator.clipboard;\n  try {\n    if (clipboard?.writeText) {\n      await clipboard.writeText(text);\n      return true;\n    }\n  } catch {\n    // 非安全上下文或权限拒绝时回退到同步 DOM 复制。\n  }\n\n  return copyTextSync(text, ownerDocument);\n}\n\n/** 在当前用户激活事件中同步复制纯文本。 */\nexport function copyTextSync(text: string, ownerDocument = document) {\n  const activeElement = ownerDocument.activeElement;\n  const textarea = ownerDocument.createElement(\"textarea\");\n  textarea.value = text;\n  textarea.setAttribute(\"readonly\", \"true\");\n  textarea.style.position = \"fixed\";\n  textarea.style.left = \"-9999px\";\n  textarea.style.top = \"0\";\n  textarea.style.opacity = \"0\";\n\n  ownerDocument.body.appendChild(textarea);\n  textarea.focus({ preventScroll: true });\n  textarea.select();\n  textarea.setSelectionRange(0, textarea.value.length);\n\n  let copied = false;\n  try {\n    copied = ownerDocument.execCommand?.(\"copy\") ?? false;\n  } catch {\n    copied = false;\n  } finally {\n    textarea.remove();\n    const HTMLElementConstructor = ownerDocument.defaultView?.HTMLElement;\n    if (\n      HTMLElementConstructor &&\n      activeElement instanceof HTMLElementConstructor\n    ) {\n      activeElement.focus({ preventScroll: true });\n    }\n  }\n  return copied;\n}\n\n/**\n * 写入二维表格文本到系统剪贴板。\n */\nexport async function copyRows(rows: ClipboardCellValue[][]) {\n  await copyText(formatRowsForClipboard(rows));\n}\n\n/**\n * 写入 JSON 文本到系统剪贴板。\n */\nexport async function copyJson(value: unknown, space = 2) {\n  await copyText(JSON.stringify(value, null, space) ?? \"\");\n}\n\n/**\n * 格式化二维数据为剪贴板友好的文本。\n */\nexport function formatRowsForClipboard(rows: ClipboardCellValue[][]) {\n  return rows.map((row) => row.map(formatClipboardCell).join(\"\\t\")).join(\"\\n\");\n}\n\nfunction formatClipboardCell(value: ClipboardCellValue) {\n  if (value == null) {\n    return \"\";\n  }\n\n  return String(value);\n}\n"]}

package/dist/data/index.cjs

@@ -0,0 +1,31 @@
+'use strict';
+
+// src/data/index.ts
+function stringifyDataIndex(dataIndex) {
+  return (Array.isArray(dataIndex) ? dataIndex : [dataIndex]).map((item) => String(item)).join(".");
+}
+function isSameDataIndex(left, right) {
+  const leftPath = Array.isArray(left) ? left : [left];
+  const rightPath = Array.isArray(right) ? right : [right];
+  return leftPath.length === rightPath.length && leftPath.every((key, index) => key === rightPath[index]);
+}
+function getValueByDataIndex(source, dataIndex) {
+  if (dataIndex == null) {
+    return void 0;
+  }
+  const path = Array.isArray(dataIndex) ? dataIndex : [dataIndex];
+  let current = source;
+  for (const key of path) {
+    if (current == null || typeof current !== "object" && typeof current !== "function") {
+      return void 0;
+    }
+    current = current[key];
+  }
+  return current;
+}
+
+exports.getValueByDataIndex = getValueByDataIndex;
+exports.isSameDataIndex = isSameDataIndex;
+exports.stringifyDataIndex = stringifyDataIndex;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/data/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/data/index.ts"],"names":[],"mappings":";;;AAQO,SAAS,mBAAmB,SAAA,EAA2B;AAC5D,EAAA,OAAA,CAAQ,MAAM,OAAA,CAAQ,SAAS,CAAA,GAAI,SAAA,GAAY,CAAC,SAAS,CAAA,EACtD,GAAA,CAAI,CAAC,SAAS,MAAA,CAAO,IAAI,CAAC,CAAA,CAC1B,KAAK,GAAG,CAAA;AACb;AAKO,SAAS,eAAA,CAAgB,MAAsB,KAAA,EAAuB;AAC3E,EAAA,MAAM,WAAW,KAAA,CAAM,OAAA,CAAQ,IAAI,CAAA,GAAI,IAAA,GAAO,CAAC,IAAI,CAAA;AACnD,EAAA,MAAM,YAAY,KAAA,CAAM,OAAA,CAAQ,KAAK,CAAA,GAAI,KAAA,GAAQ,CAAC,KAAK,CAAA;AACvD,EAAA,OACE,QAAA,CAAS,MAAA,KAAW,SAAA,CAAU,MAAA,IAC9B,QAAA,CAAS,KAAA,CAAM,CAAC,GAAA,EAAK,KAAA,KAAU,GAAA,KAAQ,SAAA,CAAU,KAAK,CAAC,CAAA;AAE3D;AASO,SAAS,mBAAA,CACd,QACA,SAAA,EACA;AACA,EAAA,IAAI,aAAa,IAAA,EAAM;AACrB,IAAA,OAAO,MAAA;AAAA,EACT;AAEA,EAAA,MAAM,OAAO,KAAA,CAAM,OAAA,CAAQ,SAAS,CAAA,GAAI,SAAA,GAAY,CAAC,SAAS,CAAA;AAC9D,EAAA,IAAI,OAAA,GAAmB,MAAA;AAEvB,EAAA,KAAA,MAAW,OAAO,IAAA,EAAM;AACtB,IAAA,IACE,WAAW,IAAA,IACV,OAAO,YAAY,QAAA,IAAY,OAAO,YAAY,UAAA,EACnD;AACA,MAAA,OAAO,MAAA;AAAA,IACT;AACA,IAAA,OAAA,GAAW,QAA6C,GAAG,CAAA;AAAA,EAC7D;AAEA,EAAA,OAAO,OAAA;AACT","file":"index.cjs","sourcesContent":["/**\n * 支持对象属性路径的数据索引。\n */\nexport type ValueDataIndex = string | number | Array<string | number>;\n\n/**\n * 将 dataIndex 转换为稳定字符串。\n */\nexport function stringifyDataIndex(dataIndex: ValueDataIndex) {\n  return (Array.isArray(dataIndex) ? dataIndex : [dataIndex])\n    .map((item) => String(item))\n    .join(\".\");\n}\n\n/**\n * 判断两个 dataIndex 是否指向相同属性路径。\n */\nexport function isSameDataIndex(left: ValueDataIndex, right: ValueDataIndex) {\n  const leftPath = Array.isArray(left) ? left : [left];\n  const rightPath = Array.isArray(right) ? right : [right];\n  return (\n    leftPath.length === rightPath.length &&\n    leftPath.every((key, index) => key === rightPath[index])\n  );\n}\n\n/**\n * 通过 dataIndex 安全读取值。\n *\n * @param source 数据记录。\n * @param dataIndex 属性路径。\n * @returns 读取结果。\n */\nexport function getValueByDataIndex(\n  source: unknown,\n  dataIndex?: ValueDataIndex,\n) {\n  if (dataIndex == null) {\n    return undefined;\n  }\n\n  const path = Array.isArray(dataIndex) ? dataIndex : [dataIndex];\n  let current: unknown = source;\n\n  for (const key of path) {\n    if (\n      current == null ||\n      (typeof current !== \"object\" && typeof current !== \"function\")\n    ) {\n      return undefined;\n    }\n    current = (current as Record<string | number, unknown>)[key];\n  }\n\n  return current;\n}\n"]}

package/dist/data/index.d.cts

@@ -0,0 +1,22 @@
+/**
+ * 支持对象属性路径的数据索引。
+ */
+type ValueDataIndex = string | number | Array<string | number>;
+/**
+ * 将 dataIndex 转换为稳定字符串。
+ */
+declare function stringifyDataIndex(dataIndex: ValueDataIndex): string;
+/**
+ * 判断两个 dataIndex 是否指向相同属性路径。
+ */
+declare function isSameDataIndex(left: ValueDataIndex, right: ValueDataIndex): boolean;
+/**
+ * 通过 dataIndex 安全读取值。
+ *
+ * @param source 数据记录。
+ * @param dataIndex 属性路径。
+ * @returns 读取结果。
+ */
+declare function getValueByDataIndex(source: unknown, dataIndex?: ValueDataIndex): unknown;
+
+export { type ValueDataIndex, getValueByDataIndex, isSameDataIndex, stringifyDataIndex };

package/dist/data/index.d.ts

@@ -0,0 +1,22 @@
+/**
+ * 支持对象属性路径的数据索引。
+ */
+type ValueDataIndex = string | number | Array<string | number>;
+/**
+ * 将 dataIndex 转换为稳定字符串。
+ */
+declare function stringifyDataIndex(dataIndex: ValueDataIndex): string;
+/**
+ * 判断两个 dataIndex 是否指向相同属性路径。
+ */
+declare function isSameDataIndex(left: ValueDataIndex, right: ValueDataIndex): boolean;
+/**
+ * 通过 dataIndex 安全读取值。
+ *
+ * @param source 数据记录。
+ * @param dataIndex 属性路径。
+ * @returns 读取结果。
+ */
+declare function getValueByDataIndex(source: unknown, dataIndex?: ValueDataIndex): unknown;
+
+export { type ValueDataIndex, getValueByDataIndex, isSameDataIndex, stringifyDataIndex };

package/dist/data/index.js

@@ -0,0 +1,27 @@
+// src/data/index.ts
+function stringifyDataIndex(dataIndex) {
+  return (Array.isArray(dataIndex) ? dataIndex : [dataIndex]).map((item) => String(item)).join(".");
+}
+function isSameDataIndex(left, right) {
+  const leftPath = Array.isArray(left) ? left : [left];
+  const rightPath = Array.isArray(right) ? right : [right];
+  return leftPath.length === rightPath.length && leftPath.every((key, index) => key === rightPath[index]);
+}
+function getValueByDataIndex(source, dataIndex) {
+  if (dataIndex == null) {
+    return void 0;
+  }
+  const path = Array.isArray(dataIndex) ? dataIndex : [dataIndex];
+  let current = source;
+  for (const key of path) {
+    if (current == null || typeof current !== "object" && typeof current !== "function") {
+      return void 0;
+    }
+    current = current[key];
+  }
+  return current;
+}
+
+export { getValueByDataIndex, isSameDataIndex, stringifyDataIndex };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/data/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/data/index.ts"],"names":[],"mappings":";AAQO,SAAS,mBAAmB,SAAA,EAA2B;AAC5D,EAAA,OAAA,CAAQ,MAAM,OAAA,CAAQ,SAAS,CAAA,GAAI,SAAA,GAAY,CAAC,SAAS,CAAA,EACtD,GAAA,CAAI,CAAC,SAAS,MAAA,CAAO,IAAI,CAAC,CAAA,CAC1B,KAAK,GAAG,CAAA;AACb;AAKO,SAAS,eAAA,CAAgB,MAAsB,KAAA,EAAuB;AAC3E,EAAA,MAAM,WAAW,KAAA,CAAM,OAAA,CAAQ,IAAI,CAAA,GAAI,IAAA,GAAO,CAAC,IAAI,CAAA;AACnD,EAAA,MAAM,YAAY,KAAA,CAAM,OAAA,CAAQ,KAAK,CAAA,GAAI,KAAA,GAAQ,CAAC,KAAK,CAAA;AACvD,EAAA,OACE,QAAA,CAAS,MAAA,KAAW,SAAA,CAAU,MAAA,IAC9B,QAAA,CAAS,KAAA,CAAM,CAAC,GAAA,EAAK,KAAA,KAAU,GAAA,KAAQ,SAAA,CAAU,KAAK,CAAC,CAAA;AAE3D;AASO,SAAS,mBAAA,CACd,QACA,SAAA,EACA;AACA,EAAA,IAAI,aAAa,IAAA,EAAM;AACrB,IAAA,OAAO,MAAA;AAAA,EACT;AAEA,EAAA,MAAM,OAAO,KAAA,CAAM,OAAA,CAAQ,SAAS,CAAA,GAAI,SAAA,GAAY,CAAC,SAAS,CAAA;AAC9D,EAAA,IAAI,OAAA,GAAmB,MAAA;AAEvB,EAAA,KAAA,MAAW,OAAO,IAAA,EAAM;AACtB,IAAA,IACE,WAAW,IAAA,IACV,OAAO,YAAY,QAAA,IAAY,OAAO,YAAY,UAAA,EACnD;AACA,MAAA,OAAO,MAAA;AAAA,IACT;AACA,IAAA,OAAA,GAAW,QAA6C,GAAG,CAAA;AAAA,EAC7D;AAEA,EAAA,OAAO,OAAA;AACT","file":"index.js","sourcesContent":["/**\n * 支持对象属性路径的数据索引。\n */\nexport type ValueDataIndex = string | number | Array<string | number>;\n\n/**\n * 将 dataIndex 转换为稳定字符串。\n */\nexport function stringifyDataIndex(dataIndex: ValueDataIndex) {\n  return (Array.isArray(dataIndex) ? dataIndex : [dataIndex])\n    .map((item) => String(item))\n    .join(\".\");\n}\n\n/**\n * 判断两个 dataIndex 是否指向相同属性路径。\n */\nexport function isSameDataIndex(left: ValueDataIndex, right: ValueDataIndex) {\n  const leftPath = Array.isArray(left) ? left : [left];\n  const rightPath = Array.isArray(right) ? right : [right];\n  return (\n    leftPath.length === rightPath.length &&\n    leftPath.every((key, index) => key === rightPath[index])\n  );\n}\n\n/**\n * 通过 dataIndex 安全读取值。\n *\n * @param source 数据记录。\n * @param dataIndex 属性路径。\n * @returns 读取结果。\n */\nexport function getValueByDataIndex(\n  source: unknown,\n  dataIndex?: ValueDataIndex,\n) {\n  if (dataIndex == null) {\n    return undefined;\n  }\n\n  const path = Array.isArray(dataIndex) ? dataIndex : [dataIndex];\n  let current: unknown = source;\n\n  for (const key of path) {\n    if (\n      current == null ||\n      (typeof current !== \"object\" && typeof current !== \"function\")\n    ) {\n      return undefined;\n    }\n    current = (current as Record<string | number, unknown>)[key];\n  }\n\n  return current;\n}\n"]}

package/dist/export/index.cjs

@@ -35,11 +35,15 @@ function mapRowsToExportRecords(params) {
 }
 function buildCsvContent(params) {
   const { rows, columns } = params;
-  const header = columns.map((column) => escapeCsvCell(column.title)).join(",");
-  const body = rows.map(
-    (row, rowIndex) => columns.map((column) => escapeCsvCell(column.value(row, rowIndex))).join(",")
-  );
-  return [header, ...body].join("\n");
+  return serializeCsvRows([
+    columns.map((column) => column.title),
+    ...rows.map(
+      (row, rowIndex) => columns.map((column) => column.value(row, rowIndex))
+    )
+  ]);
+}
+function serializeCsvRows(rows, lineBreak = "\n") {
+  return rows.map((row) => row.map((value) => escapeCsvCell(value)).join(",")).join(lineBreak);
 }
 function buildTxtContent(params) {
   const { rows, columns } = params;
@@ -77,12 +81,7 @@ async function exportTableToTxt(params) {
   });
 }
 async function exportTableToXlsx(params) {
-  const {
-    fileName,
-    rows,
-    columns,
-    sheetName = "Sheet1"
-  } = params;
+  const { fileName, rows, columns, sheetName = "Sheet1" } = params;
   const worksheet = await buildXlsxWorksheet({ rows, columns });
   const workbook = XLSX__namespace.utils.book_new();
   XLSX__namespace.utils.book_append_sheet(workbook, worksheet, sheetName);
@@ -101,7 +100,9 @@ async function buildXlsxWorksheet(params) {
   const chunkSize = EXPORT_CHUNK_SIZE;
   for (let start = 0; start < rows.length; start += chunkSize) {
     const chunk = rows.slice(start, start + chunkSize).map(
-      (row, rowIndex) => columns.map((column) => normalizeXlsxCell(column.value(row, start + rowIndex)))
+      (row, rowIndex) => columns.map(
+        (column) => normalizeXlsxCell(column.value(row, start + rowIndex))
+      )
     );
     XLSX__namespace.utils.sheet_add_aoa(worksheet, chunk, appendOptions);
     await yieldToMainThread();
@@ -216,5 +217,6 @@ exports.exportTableToCsv = exportTableToCsv;
 exports.exportTableToTxt = exportTableToTxt;
 exports.exportTableToXlsx = exportTableToXlsx;
 exports.mapRowsToExportRecords = mapRowsToExportRecords;
+exports.serializeCsvRows = serializeCsvRows;
 //# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map