@canvas-components/utils 0.2.0 → 0.2.2

package/README.md

@@ -1,96 +1,141 @@
-# @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;
-```
-
-## 方法说明
-
-### 剪贴板
-
-| 方法 | 签名 | 说明 |
-| --- | --- | --- |
-| `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 文本 |
-| `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 项目里的浏览器工具函数复用
+# @canvas-components/utils
+
+`@canvas-components/utils` 提供表格包之间可复用的纯原生工具能力，覆盖日期时间、数据读取、剪贴板写入和导出文件。
+
+## 功能作用
+
+- 写入文本、二维表格文本、JSON 到系统剪贴板
+- 通过 `dataIndex` 安全读取嵌套数据
+- 使用 Day.js 风格的常用 token 格式化日期时间，不依赖 Day.js 运行时
+- 复用数字、金额、百分比、科学计数法和自定义数字格式化
+- 复用数据路径比较、数值约束和矩形命中等纯函数
+- 把行列数据导出为 `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                   |
+
+### 数据读取
+
+| 方法                  | 签名                              | 说明                                         |
+| --------------------- | --------------------------------- | -------------------------------------------- |
+| `getValueByDataIndex` | `(source, dataIndex?) => unknown` | 通过字符串、数字或属性路径数组安全读取嵌套值 |
+| `stringifyDataIndex`  | `(dataIndex) => string`           | 将属性路径转换为稳定字符串                   |
+| `isSameDataIndex`     | `(left, right) => boolean`        | 判断两个属性路径是否一致                     |
+
+### 日期时间
+
+可从主入口或 `@canvas-components/utils/date` 子路径引入。
+
+| 方法                      | 签名                                          | 说明                                           |
+| ------------------------- | --------------------------------------------- | ---------------------------------------------- |
+| `resolveDateValue`        | `(value: unknown) => Date \| null`            | 将日期、时间戳或日期字符串解析为有效日期       |
+| `isDateTimeFormatPattern` | `(pattern: string) => boolean`                | 判断是否包含日期时间格式 token                 |
+| `formatDateTimeValue`     | `(value, pattern, locale?) => string \| null` | 按格式字符串输出日期时间，默认使用中文区域设置 |
+
+常用 token 包括 `YYYY`、`YY`、`M`、`MM`、`D`、`DD`、`ddd`、`dddd`、`H`、`HH`、`h`、`hh`、`m`、`mm`、`s`、`ss`、`SSS`、`A`。方括号中的内容按普通文本输出，例如 `YYYY年M月D日 [更新]`。
+
+### 数字格式
+
+可从主入口或 `@canvas-components/utils/number` 子路径引入。
+
+| 方法                        | 签名                                 | 说明                                         |
+| --------------------------- | ------------------------------------ | -------------------------------------------- |
+| `parseNumberValue`          | `(value: unknown) => number \| null` | 解析数字和带千分位的数字字符串               |
+| `formatNumberValue`         | `(value, options?) => string`        | 格式化数字、金额和千分位数字                 |
+| `formatPercentValue`        | `(value, decimalPlaces?) => string`  | 将比例数值格式化为百分比                     |
+| `formatScientificValue`     | `(value, decimalPlaces?) => string`  | 格式化科学计数法                             |
+| `formatCustomNumberPattern` | `(value, pattern) => string`         | 按常见表格数字 pattern 格式化                |
+| `formatChineseNumber`       | `(value, style?) => string \| null`  | 将数字转换为普通或金融大写中文数字           |
+| `parseChineseNumber`        | `(value) => number \| null`          | 将规范的普通或金融大写中文数字转为阿拉伯数字 |
+
+金融大写使用规范数字字符，例如 `918000` 输出 `玖拾壹万捌仟`；不兼容形近字或错别字。
+
+### 基础几何
+
+| 方法            | 签名                                  | 说明                   |
+| --------------- | ------------------------------------- | ---------------------- |
+| `clamp`         | `(value, minimum, maximum) => number` | 将数值限制在闭区间内   |
+| `isPointInRect` | `(x, y, rect) => boolean`             | 判断坐标是否位于矩形内 |
+
+## 适用场景
+
+- 表格导出
+- 系统复制功能
+- 大批量数据下载
+- 非 React 项目里的浏览器工具函数复用

package/dist/clipboard/index.cjs

@@ -1,15 +1,16 @@
 'use strict';
 
 // src/clipboard/index.ts
-async function copyText(text) {
+async function copyText(text, ownerDocument = document) {
+  const clipboard = ownerDocument.defaultView?.navigator.clipboard;
   try {
-    if (navigator.clipboard?.writeText) {
-      await navigator.clipboard.writeText(text);
-      return;
+    if (clipboard?.writeText) {
+      await clipboard.writeText(text);
+      return true;
     }
   } catch {
   }
-  copyTextSync(text);
+  return copyTextSync(text, ownerDocument);
 }
 function copyTextSync(text, ownerDocument = document) {
   const activeElement = ownerDocument.activeElement;
@@ -27,6 +28,8 @@ function copyTextSync(text, ownerDocument = document) {
   let copied = false;
   try {
     copied = ownerDocument.execCommand?.("copy") ?? false;
+  } catch {
+    copied = false;
   } finally {
     textarea.remove();
     const HTMLElementConstructor = ownerDocument.defaultView?.HTMLElement;

package/dist/clipboard/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/clipboard/index.ts"],"names":[],"mappings":";;;AAKA,eAAsB,SAAS,IAAA,EAAc;AAC3C,EAAA,IAAI;AACF,IAAA,IAAI,SAAA,CAAU,WAAW,SAAA,EAAW;AAClC,MAAA,MAAM,SAAA,CAAU,SAAA,CAAU,SAAA,CAAU,IAAI,CAAA;AACxC,MAAA;AAAA,IACF;AAAA,EACF,CAAA,CAAA,MAAQ;AAAA,EAER;AAEA,EAAA,YAAA,CAAa,IAAI,CAAA;AACnB;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,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) {\n  try {\n    if (navigator.clipboard?.writeText) {\n      await navigator.clipboard.writeText(text);\n      return;\n    }\n  } catch {\n    // 非安全上下文或权限拒绝时回退到同步 DOM 复制。\n  }\n\n  copyTextSync(text);\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  } 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"]}
+{"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,7 @@ 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;
 /**

package/dist/clipboard/index.d.ts

@@ -2,7 +2,7 @@ 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;
 /**

package/dist/clipboard/index.js

@@ -1,13 +1,14 @@
 // src/clipboard/index.ts
-async function copyText(text) {
+async function copyText(text, ownerDocument = document) {
+  const clipboard = ownerDocument.defaultView?.navigator.clipboard;
   try {
-    if (navigator.clipboard?.writeText) {
-      await navigator.clipboard.writeText(text);
-      return;
+    if (clipboard?.writeText) {
+      await clipboard.writeText(text);
+      return true;
     }
   } catch {
   }
-  copyTextSync(text);
+  return copyTextSync(text, ownerDocument);
 }
 function copyTextSync(text, ownerDocument = document) {
   const activeElement = ownerDocument.activeElement;
@@ -25,6 +26,8 @@ function copyTextSync(text, ownerDocument = document) {
   let copied = false;
   try {
     copied = ownerDocument.execCommand?.("copy") ?? false;
+  } catch {
+    copied = false;
   } finally {
     textarea.remove();
     const HTMLElementConstructor = ownerDocument.defaultView?.HTMLElement;

package/dist/clipboard/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/clipboard/index.ts"],"names":[],"mappings":";AAKA,eAAsB,SAAS,IAAA,EAAc;AAC3C,EAAA,IAAI;AACF,IAAA,IAAI,SAAA,CAAU,WAAW,SAAA,EAAW;AAClC,MAAA,MAAM,SAAA,CAAU,SAAA,CAAU,SAAA,CAAU,IAAI,CAAA;AACxC,MAAA;AAAA,IACF;AAAA,EACF,CAAA,CAAA,MAAQ;AAAA,EAER;AAEA,EAAA,YAAA,CAAa,IAAI,CAAA;AACnB;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,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) {\n  try {\n    if (navigator.clipboard?.writeText) {\n      await navigator.clipboard.writeText(text);\n      return;\n    }\n  } catch {\n    // 非安全上下文或权限拒绝时回退到同步 DOM 复制。\n  }\n\n  copyTextSync(text);\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  } 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"]}
+{"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/date/index.cjs

@@ -0,0 +1,162 @@
+'use strict';
+
+// src/date/index.ts
+var DATE_TIME_FORMAT_TOKEN = /Y{2,4}|M{1,4}|D{1,2}|d{1,4}|H{1,2}|h{1,2}|m{1,2}|s{1,2}|S{1,3}|A|a/;
+var FORMAT_TOKEN = /\[[^\]]*\]|YYYY|MMMM|MMM|dddd|ddd|SSS|YY|MM|DD|dd|HH|hh|mm|ss|SS|M|D|d|H|h|m|s|S|A|a/g;
+var ZH_WEEKDAYS = [
+  "\u661F\u671F\u65E5",
+  "\u661F\u671F\u4E00",
+  "\u661F\u671F\u4E8C",
+  "\u661F\u671F\u4E09",
+  "\u661F\u671F\u56DB",
+  "\u661F\u671F\u4E94",
+  "\u661F\u671F\u516D"
+];
+var ZH_WEEKDAYS_SHORT = [
+  "\u5468\u65E5",
+  "\u5468\u4E00",
+  "\u5468\u4E8C",
+  "\u5468\u4E09",
+  "\u5468\u56DB",
+  "\u5468\u4E94",
+  "\u5468\u516D"
+];
+var EN_WEEKDAYS = [
+  "Sunday",
+  "Monday",
+  "Tuesday",
+  "Wednesday",
+  "Thursday",
+  "Friday",
+  "Saturday"
+];
+var EN_MONTHS = [
+  "January",
+  "February",
+  "March",
+  "April",
+  "May",
+  "June",
+  "July",
+  "August",
+  "September",
+  "October",
+  "November",
+  "December"
+];
+function resolveDateValue(value) {
+  if (value instanceof Date) {
+    return Number.isNaN(value.getTime()) ? null : value;
+  }
+  if (typeof value !== "string" && typeof value !== "number") {
+    return null;
+  }
+  if (typeof value === "string") {
+    const localDate = resolveLocalDateString(value);
+    if (localDate) {
+      return localDate;
+    }
+  }
+  const resolved = new Date(value);
+  return Number.isNaN(resolved.getTime()) ? null : resolved;
+}
+function isDateTimeFormatPattern(pattern) {
+  return DATE_TIME_FORMAT_TOKEN.test(pattern.replace(/\[[^\]]*\]/g, ""));
+}
+function formatDateTimeValue(value, pattern, locale = "zh-cn") {
+  const date = resolveDateValue(value);
+  const normalizedPattern = pattern.trim();
+  if (!date || !normalizedPattern) {
+    return null;
+  }
+  const year = date.getFullYear();
+  const monthIndex = date.getMonth();
+  const month = monthIndex + 1;
+  const day = date.getDate();
+  const weekdayIndex = date.getDay();
+  const hour = date.getHours();
+  const hour12 = hour % 12 || 12;
+  const minute = date.getMinutes();
+  const second = date.getSeconds();
+  const millisecond = date.getMilliseconds();
+  const chinese = locale.toLowerCase().startsWith("zh");
+  const marker = hour >= 12 ? chinese ? "\u4E0B\u5348" : "PM" : chinese ? "\u4E0A\u5348" : "AM";
+  const weekday = chinese ? ZH_WEEKDAYS[weekdayIndex] ?? "" : EN_WEEKDAYS[weekdayIndex] ?? "";
+  const weekdayShort = chinese ? ZH_WEEKDAYS_SHORT[weekdayIndex] ?? "" : weekday.slice(0, 3);
+  const monthName = chinese ? `${month}\u6708` : EN_MONTHS[monthIndex] ?? "";
+  const values = {
+    YYYY: String(year).padStart(4, "0"),
+    YY: String(year).slice(-2),
+    M: String(month),
+    MM: padNumber(month),
+    MMM: chinese ? monthName : monthName.slice(0, 3),
+    MMMM: monthName,
+    D: String(day),
+    DD: padNumber(day),
+    d: String(weekdayIndex),
+    dd: chinese ? weekdayShort.slice(-1) : weekday.slice(0, 2),
+    ddd: weekdayShort,
+    dddd: weekday,
+    H: String(hour),
+    HH: padNumber(hour),
+    h: String(hour12),
+    hh: padNumber(hour12),
+    m: String(minute),
+    mm: padNumber(minute),
+    s: String(second),
+    ss: padNumber(second),
+    S: String(Math.floor(millisecond / 100)),
+    SS: String(Math.floor(millisecond / 10)).padStart(2, "0"),
+    SSS: String(millisecond).padStart(3, "0"),
+    A: marker,
+    a: marker.toLowerCase()
+  };
+  return normalizedPattern.replace(
+    FORMAT_TOKEN,
+    (token) => token.startsWith("[") && token.endsWith("]") ? token.slice(1, -1) : values[token] ?? token
+  );
+}
+function padNumber(value) {
+  return String(value).padStart(2, "0");
+}
+function resolveLocalDateString(value) {
+  const match = value.trim().match(
+    /^(\d{4})[-/](\d{1,2})[-/](\d{1,2})(?:[ T](\d{1,2}):?(\d{2})?(?::?(\d{2}))?(?:\.(\d{1,3}))?)?$/
+  );
+  if (!match) {
+    return null;
+  }
+  const [
+    ,
+    yearText,
+    monthText,
+    dayText,
+    hourText,
+    minuteText,
+    secondText,
+    millisecondText
+  ] = match;
+  const year = Number(yearText);
+  const monthIndex = Number(monthText) - 1;
+  const day = Number(dayText);
+  const hour = Number(hourText ?? 0);
+  const minute = Number(minuteText ?? 0);
+  const second = Number(secondText ?? 0);
+  const millisecond = Number((millisecondText ?? "0").padEnd(3, "0"));
+  const resolved = new Date(
+    year,
+    monthIndex,
+    day,
+    hour,
+    minute,
+    second,
+    millisecond
+  );
+  return resolved.getFullYear() === year && resolved.getMonth() === monthIndex && resolved.getDate() === day && resolved.getHours() === hour && resolved.getMinutes() === minute && resolved.getSeconds() === second ? resolved : null;
+}
+
+exports.formatDateTimeValue = formatDateTimeValue;
+exports.isDateTimeFormatPattern = isDateTimeFormatPattern;
+exports.resolveDateValue = resolveDateValue;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map