@canvas-components/utils 0.1.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 canvas-components contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/clipboard/index.cjs

@@ -0,0 +1,49 @@
+'use strict';
+
+// src/clipboard/index.ts
+async function copyText(text) {
+  if (navigator.clipboard?.writeText) {
+    await navigator.clipboard.writeText(text);
+    return;
+  }
+  copyTextByTextarea(text);
+}
+async function copyRows(rows) {
+  await copyText(formatRowsForClipboard(rows));
+}
+async function copyJson(value, space = 2) {
+  await copyText(JSON.stringify(value, null, space) ?? "");
+}
+function formatRowsForClipboard(rows) {
+  return rows.map((row) => row.map(formatClipboardCell).join("	")).join("\n");
+}
+function formatClipboardCell(value) {
+  if (value == null) {
+    return "";
+  }
+  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.formatRowsForClipboard = formatRowsForClipboard;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/clipboard/index.cjs.map

@@ -0,0 +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"]}

package/dist/clipboard/index.d.cts

@@ -0,0 +1,19 @@
+type ClipboardCellValue = string | number | boolean | null | undefined;
+/**
+ * 写入纯文本到系统剪贴板。
+ */
+declare function copyText(text: string): Promise<void>;
+/**
+ * 写入二维表格文本到系统剪贴板。
+ */
+declare function copyRows(rows: ClipboardCellValue[][]): Promise<void>;
+/**
+ * 写入 JSON 文本到系统剪贴板。
+ */
+declare function copyJson(value: unknown, space?: number): Promise<void>;
+/**
+ * 格式化二维数据为剪贴板友好的文本。
+ */
+declare function formatRowsForClipboard(rows: ClipboardCellValue[][]): string;
+
+export { type ClipboardCellValue, copyJson, copyRows, copyText, formatRowsForClipboard };

package/dist/clipboard/index.d.ts

@@ -0,0 +1,19 @@
+type ClipboardCellValue = string | number | boolean | null | undefined;
+/**
+ * 写入纯文本到系统剪贴板。
+ */
+declare function copyText(text: string): Promise<void>;
+/**
+ * 写入二维表格文本到系统剪贴板。
+ */
+declare function copyRows(rows: ClipboardCellValue[][]): Promise<void>;
+/**
+ * 写入 JSON 文本到系统剪贴板。
+ */
+declare function copyJson(value: unknown, space?: number): Promise<void>;
+/**
+ * 格式化二维数据为剪贴板友好的文本。
+ */
+declare function formatRowsForClipboard(rows: ClipboardCellValue[][]): string;
+
+export { type ClipboardCellValue, copyJson, copyRows, copyText, formatRowsForClipboard };

package/dist/clipboard/index.js

@@ -0,0 +1,44 @@
+// src/clipboard/index.ts
+async function copyText(text) {
+  if (navigator.clipboard?.writeText) {
+    await navigator.clipboard.writeText(text);
+    return;
+  }
+  copyTextByTextarea(text);
+}
+async function copyRows(rows) {
+  await copyText(formatRowsForClipboard(rows));
+}
+async function copyJson(value, space = 2) {
+  await copyText(JSON.stringify(value, null, space) ?? "");
+}
+function formatRowsForClipboard(rows) {
+  return rows.map((row) => row.map(formatClipboardCell).join("	")).join("\n");
+}
+function formatClipboardCell(value) {
+  if (value == null) {
+    return "";
+  }
+  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 };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/clipboard/index.js.map

@@ -0,0 +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"]}

package/dist/export/index.cjs

@@ -0,0 +1,220 @@
+'use strict';
+
+var XLSX = require('xlsx');
+
+function _interopNamespace(e) {
+  if (e && e.__esModule) return e;
+  var n = Object.create(null);
+  if (e) {
+    Object.keys(e).forEach(function (k) {
+      if (k !== 'default') {
+        var d = Object.getOwnPropertyDescriptor(e, k);
+        Object.defineProperty(n, k, d.get ? d : {
+          enumerable: true,
+          get: function () { return e[k]; }
+        });
+      }
+    });
+  }
+  n.default = e;
+  return Object.freeze(n);
+}
+
+var XLSX__namespace = /*#__PURE__*/_interopNamespace(XLSX);
+
+// src/export/index.ts
+var EXPORT_CHUNK_SIZE = 2e3;
+function mapRowsToExportRecords(params) {
+  const { rows, columns } = params;
+  return rows.map(
+    (row, rowIndex) => columns.reduce((record, column) => {
+      record[column.title] = column.value(row, rowIndex);
+      return record;
+    }, {})
+  );
+}
+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");
+}
+function buildTxtContent(params) {
+  const { rows, columns } = params;
+  const header = columns.map((column) => normalizeTextCell(column.title)).join("	");
+  const body = rows.map(
+    (row, rowIndex) => columns.map((column) => normalizeTextCell(column.value(row, rowIndex))).join("	")
+  );
+  return [header, ...body].join("\n");
+}
+async function downloadJsonFile(params) {
+  const { data, fileName, space = 2 } = params;
+  const content = await buildJsonContentAsync({ data, space });
+  downloadTextFile({
+    fileName: ensureExtension(fileName, "json"),
+    content,
+    type: "application/json;charset=utf-8"
+  });
+}
+async function exportTableToCsv(params) {
+  const { fileName, rows, columns } = params;
+  const content = await buildCsvContentAsync({ rows, columns });
+  downloadTextFile({
+    fileName: ensureExtension(fileName, "csv"),
+    content,
+    type: "text/csv;charset=utf-8"
+  });
+}
+async function exportTableToTxt(params) {
+  const { fileName, rows, columns } = params;
+  const content = await buildTxtContentAsync({ rows, columns });
+  downloadTextFile({
+    fileName: ensureExtension(fileName, "txt"),
+    content,
+    type: "text/plain;charset=utf-8"
+  });
+}
+async function exportTableToXlsx(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);
+  await yieldToMainThread();
+  XLSX__namespace.writeFile(workbook, ensureExtension(fileName, "xlsx"));
+}
+async function buildXlsxWorksheet(params) {
+  const { rows, columns } = params;
+  const header = columns.map((column) => column.title);
+  const denseOptions = { dense: true };
+  const appendOptions = {
+    origin: -1,
+    dense: true
+  };
+  const worksheet = XLSX__namespace.utils.aoa_to_sheet([header], denseOptions);
+  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)))
+    );
+    XLSX__namespace.utils.sheet_add_aoa(worksheet, chunk, appendOptions);
+    await yieldToMainThread();
+  }
+  return worksheet;
+}
+async function buildJsonContentAsync(params) {
+  const { data, space } = params;
+  if (!Array.isArray(data)) {
+    return JSON.stringify(data, null, space) ?? "";
+  }
+  if (data.length === 0) {
+    return "[]";
+  }
+  const lineBreak = space > 0 ? "\n" : "";
+  const indent = space > 0 ? " ".repeat(space) : "";
+  const parts = ["[", lineBreak];
+  for (let start = 0; start < data.length; start += EXPORT_CHUNK_SIZE) {
+    const chunk = data.slice(start, start + EXPORT_CHUNK_SIZE);
+    for (let index = 0; index < chunk.length; index += 1) {
+      const itemIndex = start + index;
+      const prefix = itemIndex === 0 ? "" : `,${lineBreak}`;
+      const content = JSON.stringify(chunk[index], null, space) ?? "null";
+      parts.push(prefix, indent, content);
+    }
+    await yieldToMainThread();
+  }
+  parts.push(lineBreak, "]");
+  return parts.join("");
+}
+async function buildCsvContentAsync(params) {
+  const { rows, columns } = params;
+  const header = columns.map((column) => escapeCsvCell(column.title)).join(",");
+  const parts = [header];
+  for (let start = 0; start < rows.length; start += EXPORT_CHUNK_SIZE) {
+    const chunk = rows.slice(start, start + EXPORT_CHUNK_SIZE);
+    for (let rowIndex = 0; rowIndex < chunk.length; rowIndex += 1) {
+      const row = chunk[rowIndex];
+      const line = columns.map((column) => escapeCsvCell(column.value(row, start + rowIndex))).join(",");
+      parts.push("\n", line);
+    }
+    await yieldToMainThread();
+  }
+  return parts.join("");
+}
+async function buildTxtContentAsync(params) {
+  const { rows, columns } = params;
+  const header = columns.map((column) => normalizeTextCell(column.title)).join("	");
+  const parts = [header];
+  for (let start = 0; start < rows.length; start += EXPORT_CHUNK_SIZE) {
+    const chunk = rows.slice(start, start + EXPORT_CHUNK_SIZE);
+    for (let rowIndex = 0; rowIndex < chunk.length; rowIndex += 1) {
+      const row = chunk[rowIndex];
+      const line = columns.map((column) => normalizeTextCell(column.value(row, start + rowIndex))).join("	");
+      parts.push("\n", line);
+    }
+    await yieldToMainThread();
+  }
+  return parts.join("");
+}
+function escapeCsvCell(value) {
+  const normalized = value == null ? "" : String(value);
+  if (normalized.includes(",") || normalized.includes('"') || normalized.includes("\n")) {
+    return `"${normalized.split('"').join('""')}"`;
+  }
+  return normalized;
+}
+function normalizeTextCell(value) {
+  return value == null ? "" : String(value);
+}
+function normalizeXlsxCell(value) {
+  if (value == null) {
+    return "";
+  }
+  if (typeof value === "string" || typeof value === "number" || typeof value === "boolean") {
+    return value;
+  }
+  if (value instanceof Date) {
+    return value;
+  }
+  return String(value);
+}
+function ensureExtension(fileName, extension) {
+  return fileName.toLowerCase().endsWith(`.${extension}`) ? fileName : `${fileName}.${extension}`;
+}
+function yieldToMainThread() {
+  return new Promise((resolve) => {
+    if (typeof window !== "undefined" && typeof window.requestAnimationFrame === "function") {
+      window.requestAnimationFrame(() => {
+        resolve();
+      });
+      return;
+    }
+    setTimeout(resolve, 0);
+  });
+}
+function downloadTextFile(params) {
+  const { fileName, content, type } = params;
+  const blob = new Blob([content], { type });
+  const url = URL.createObjectURL(blob);
+  const anchor = document.createElement("a");
+  anchor.href = url;
+  anchor.download = fileName;
+  anchor.click();
+  URL.revokeObjectURL(url);
+}
+
+exports.buildCsvContent = buildCsvContent;
+exports.buildTxtContent = buildTxtContent;
+exports.downloadJsonFile = downloadJsonFile;
+exports.exportTableToCsv = exportTableToCsv;
+exports.exportTableToTxt = exportTableToTxt;
+exports.exportTableToXlsx = exportTableToXlsx;
+exports.mapRowsToExportRecords = mapRowsToExportRecords;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/export/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/export/index.ts"],"names":["XLSX"],"mappings":"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","file":"index.cjs","sourcesContent":["import * as XLSX from \"xlsx\";\r\n\r\nconst EXPORT_CHUNK_SIZE = 2_000;\r\n\r\nexport interface ExportTableColumn<Row> {\r\n  key: string;\r\n  title: string;\r\n  value: (row: Row, index: number) => unknown;\r\n}\r\n\r\n/**\r\n * 将表格行映射为适合导出的对象数组。\r\n */\r\nexport function mapRowsToExportRecords<Row>(params: {\r\n  rows: Row[];\r\n  columns: ExportTableColumn<Row>[];\r\n}) {\r\n  const { rows, columns } = params;\r\n  return rows.map((row, rowIndex) =>\r\n    columns.reduce<Record<string, unknown>>((record, column) => {\r\n      record[column.title] = column.value(row, rowIndex);\r\n      return record;\r\n    }, {}),\r\n  );\r\n}\r\n\r\n/**\r\n * 生成 CSV 文本内容。\r\n */\r\nexport function buildCsvContent<Row>(params: {\r\n  rows: Row[];\r\n  columns: ExportTableColumn<Row>[];\r\n}) {\r\n  const { rows, columns } = params;\r\n  const header = columns.map((column) => escapeCsvCell(column.title)).join(\",\");\r\n  const body = rows.map((row, rowIndex) =>\r\n    columns\r\n      .map((column) => escapeCsvCell(column.value(row, rowIndex)))\r\n      .join(\",\"),\r\n  );\r\n\r\n  return [header, ...body].join(\"\\n\");\r\n}\r\n\r\n/**\r\n * 生成 TXT 文本内容。\r\n */\r\nexport function buildTxtContent<Row>(params: {\r\n  rows: Row[];\r\n  columns: ExportTableColumn<Row>[];\r\n}) {\r\n  const { rows, columns } = params;\r\n  const header = columns.map((column) => normalizeTextCell(column.title)).join(\"\\t\");\r\n  const body = rows.map((row, rowIndex) =>\r\n    columns\r\n      .map((column) => normalizeTextCell(column.value(row, rowIndex)))\r\n      .join(\"\\t\"),\r\n  );\r\n\r\n  return [header, ...body].join(\"\\n\");\r\n}\r\n\r\n/**\r\n * 下载 JSON 文件。\r\n */\r\nexport async function downloadJsonFile(params: {\r\n  fileName: string;\r\n  data: unknown;\r\n  space?: number;\r\n}) {\r\n  const { data, fileName, space = 2 } = params;\r\n  const content = await buildJsonContentAsync({ data, space });\r\n  downloadTextFile({\r\n    fileName: ensureExtension(fileName, \"json\"),\r\n    content,\r\n    type: \"application/json;charset=utf-8\",\r\n  });\r\n}\r\n\r\n/**\r\n * 导出表格 CSV 文件。\r\n */\r\nexport async function exportTableToCsv<Row>(params: {\r\n  fileName: string;\r\n  rows: Row[];\r\n  columns: ExportTableColumn<Row>[];\r\n}) {\r\n  const { fileName, rows, columns } = params;\r\n  const content = await buildCsvContentAsync({ rows, columns });\r\n  downloadTextFile({\r\n    fileName: ensureExtension(fileName, \"csv\"),\r\n    content,\r\n    type: \"text/csv;charset=utf-8\",\r\n  });\r\n}\r\n\r\n/**\r\n * 导出表格 TXT 文件。\r\n */\r\nexport async function exportTableToTxt<Row>(params: {\r\n  fileName: string;\r\n  rows: Row[];\r\n  columns: ExportTableColumn<Row>[];\r\n}) {\r\n  const { fileName, rows, columns } = params;\r\n  const content = await buildTxtContentAsync({ rows, columns });\r\n  downloadTextFile({\r\n    fileName: ensureExtension(fileName, \"txt\"),\r\n    content,\r\n    type: \"text/plain;charset=utf-8\",\r\n  });\r\n}\r\n\r\n/**\r\n * 导出表格 XLSX 文件。\r\n */\r\nexport async function exportTableToXlsx<Row>(params: {\r\n  fileName: string;\r\n  rows: Row[];\r\n  columns: ExportTableColumn<Row>[];\r\n  sheetName?: string;\r\n}) {\r\n  const {\r\n    fileName,\r\n    rows,\r\n    columns,\r\n    sheetName = \"Sheet1\",\r\n  } = params;\r\n  const worksheet = await buildXlsxWorksheet({ rows, columns });\r\n  const workbook = XLSX.utils.book_new();\r\n  XLSX.utils.book_append_sheet(workbook, worksheet, sheetName);\r\n  await yieldToMainThread();\r\n  XLSX.writeFile(workbook, ensureExtension(fileName, \"xlsx\"));\r\n}\r\n\r\n/**\r\n * 构建适合大数据量导出的 XLSX 工作表。\r\n */\r\nasync function buildXlsxWorksheet<Row>(params: {\r\n  rows: Row[];\r\n  columns: ExportTableColumn<Row>[];\r\n}) {\r\n  const { rows, columns } = params;\r\n  const header = columns.map((column) => column.title);\r\n  const denseOptions = { dense: true } as unknown as XLSX.AOA2SheetOpts;\r\n  const appendOptions = {\r\n    origin: -1,\r\n    dense: true,\r\n  } as unknown as XLSX.SheetAOAOpts;\r\n  const worksheet = XLSX.utils.aoa_to_sheet([header], denseOptions);\r\n  const chunkSize = EXPORT_CHUNK_SIZE;\r\n\r\n  for (let start = 0; start < rows.length; start += chunkSize) {\r\n    const chunk = rows.slice(start, start + chunkSize).map((row, rowIndex) =>\r\n      columns.map((column) => normalizeXlsxCell(column.value(row, start + rowIndex))),\r\n    );\r\n\r\n    XLSX.utils.sheet_add_aoa(worksheet, chunk, appendOptions);\r\n\r\n    await yieldToMainThread();\r\n  }\r\n\r\n  return worksheet;\r\n}\r\n\r\nasync function buildJsonContentAsync(params: {\r\n  data: unknown;\r\n  space: number;\r\n}) {\r\n  const { data, space } = params;\r\n  if (!Array.isArray(data)) {\r\n    return JSON.stringify(data, null, space) ?? \"\";\r\n  }\r\n\r\n  if (data.length === 0) {\r\n    return \"[]\";\r\n  }\r\n\r\n  const lineBreak = space > 0 ? \"\\n\" : \"\";\r\n  const indent = space > 0 ? \" \".repeat(space) : \"\";\r\n  const parts = [\"[\", lineBreak];\r\n\r\n  for (let start = 0; start < data.length; start += EXPORT_CHUNK_SIZE) {\r\n    const chunk = data.slice(start, start + EXPORT_CHUNK_SIZE);\r\n    for (let index = 0; index < chunk.length; index += 1) {\r\n      const itemIndex = start + index;\r\n      const prefix = itemIndex === 0 ? \"\" : `,${lineBreak}`;\r\n      const content = JSON.stringify(chunk[index], null, space) ?? \"null\";\r\n      parts.push(prefix, indent, content);\r\n    }\r\n\r\n    await yieldToMainThread();\r\n  }\r\n\r\n  parts.push(lineBreak, \"]\");\r\n  return parts.join(\"\");\r\n}\r\n\r\nasync function buildCsvContentAsync<Row>(params: {\r\n  rows: Row[];\r\n  columns: ExportTableColumn<Row>[];\r\n}) {\r\n  const { rows, columns } = params;\r\n  const header = columns.map((column) => escapeCsvCell(column.title)).join(\",\");\r\n  const parts = [header];\r\n\r\n  for (let start = 0; start < rows.length; start += EXPORT_CHUNK_SIZE) {\r\n    const chunk = rows.slice(start, start + EXPORT_CHUNK_SIZE);\r\n    for (let rowIndex = 0; rowIndex < chunk.length; rowIndex += 1) {\r\n      const row = chunk[rowIndex];\r\n      const line = columns\r\n        .map((column) => escapeCsvCell(column.value(row, start + rowIndex)))\r\n        .join(\",\");\r\n      parts.push(\"\\n\", line);\r\n    }\r\n\r\n    await yieldToMainThread();\r\n  }\r\n\r\n  return parts.join(\"\");\r\n}\r\n\r\nasync function buildTxtContentAsync<Row>(params: {\r\n  rows: Row[];\r\n  columns: ExportTableColumn<Row>[];\r\n}) {\r\n  const { rows, columns } = params;\r\n  const header = columns.map((column) => normalizeTextCell(column.title)).join(\"\\t\");\r\n  const parts = [header];\r\n\r\n  for (let start = 0; start < rows.length; start += EXPORT_CHUNK_SIZE) {\r\n    const chunk = rows.slice(start, start + EXPORT_CHUNK_SIZE);\r\n    for (let rowIndex = 0; rowIndex < chunk.length; rowIndex += 1) {\r\n      const row = chunk[rowIndex];\r\n      const line = columns\r\n        .map((column) => normalizeTextCell(column.value(row, start + rowIndex)))\r\n        .join(\"\\t\");\r\n      parts.push(\"\\n\", line);\r\n    }\r\n\r\n    await yieldToMainThread();\r\n  }\r\n\r\n  return parts.join(\"\");\r\n}\r\n\r\nfunction escapeCsvCell(value: unknown) {\r\n  const normalized = value == null ? \"\" : String(value);\r\n  if (\r\n    normalized.includes(\",\") ||\r\n    normalized.includes(\"\\\"\") ||\r\n    normalized.includes(\"\\n\")\r\n  ) {\r\n    return `\"${normalized.split(\"\\\"\").join(\"\\\"\\\"\")}\"`;\r\n  }\r\n  return normalized;\r\n}\r\n\r\nfunction normalizeTextCell(value: unknown) {\r\n  return value == null ? \"\" : String(value);\r\n}\r\n\r\nfunction normalizeXlsxCell(value: unknown) {\r\n  if (value == null) {\r\n    return \"\";\r\n  }\r\n\r\n  if (\r\n    typeof value === \"string\" ||\r\n    typeof value === \"number\" ||\r\n    typeof value === \"boolean\"\r\n  ) {\r\n    return value;\r\n  }\r\n\r\n  if (value instanceof Date) {\r\n    return value;\r\n  }\r\n\r\n  return String(value);\r\n}\r\n\r\nfunction ensureExtension(fileName: string, extension: string) {\r\n  return fileName.toLowerCase().endsWith(`.${extension}`)\r\n    ? fileName\r\n    : `${fileName}.${extension}`;\r\n}\r\n\r\nfunction yieldToMainThread() {\r\n  return new Promise<void>((resolve) => {\r\n    if (typeof window !== \"undefined\" && typeof window.requestAnimationFrame === \"function\") {\r\n      window.requestAnimationFrame(() => {\r\n        resolve();\r\n      });\r\n      return;\r\n    }\r\n\r\n    setTimeout(resolve, 0);\r\n  });\r\n}\r\n\r\nfunction downloadTextFile(params: {\r\n  fileName: string;\r\n  content: string;\r\n  type: string;\r\n}) {\r\n  const { fileName, content, type } = params;\r\n  const blob = new Blob([content], { type });\r\n  const url = URL.createObjectURL(blob);\r\n  const anchor = document.createElement(\"a\");\r\n  anchor.href = url;\r\n  anchor.download = fileName;\r\n  anchor.click();\r\n  URL.revokeObjectURL(url);\r\n}\r\n"]}

package/dist/export/index.d.cts

@@ -0,0 +1,61 @@
+interface ExportTableColumn<Row> {
+    key: string;
+    title: string;
+    value: (row: Row, index: number) => unknown;
+}
+/**
+ * 将表格行映射为适合导出的对象数组。
+ */
+declare function mapRowsToExportRecords<Row>(params: {
+    rows: Row[];
+    columns: ExportTableColumn<Row>[];
+}): Record<string, unknown>[];
+/**
+ * 生成 CSV 文本内容。
+ */
+declare function buildCsvContent<Row>(params: {
+    rows: Row[];
+    columns: ExportTableColumn<Row>[];
+}): string;
+/**
+ * 生成 TXT 文本内容。
+ */
+declare function buildTxtContent<Row>(params: {
+    rows: Row[];
+    columns: ExportTableColumn<Row>[];
+}): string;
+/**
+ * 下载 JSON 文件。
+ */
+declare function downloadJsonFile(params: {
+    fileName: string;
+    data: unknown;
+    space?: number;
+}): Promise<void>;
+/**
+ * 导出表格 CSV 文件。
+ */
+declare function exportTableToCsv<Row>(params: {
+    fileName: string;
+    rows: Row[];
+    columns: ExportTableColumn<Row>[];
+}): Promise<void>;
+/**
+ * 导出表格 TXT 文件。
+ */
+declare function exportTableToTxt<Row>(params: {
+    fileName: string;
+    rows: Row[];
+    columns: ExportTableColumn<Row>[];
+}): Promise<void>;
+/**
+ * 导出表格 XLSX 文件。
+ */
+declare function exportTableToXlsx<Row>(params: {
+    fileName: string;
+    rows: Row[];
+    columns: ExportTableColumn<Row>[];
+    sheetName?: string;
+}): Promise<void>;
+
+export { type ExportTableColumn, buildCsvContent, buildTxtContent, downloadJsonFile, exportTableToCsv, exportTableToTxt, exportTableToXlsx, mapRowsToExportRecords };

package/dist/export/index.d.ts

@@ -0,0 +1,61 @@
+interface ExportTableColumn<Row> {
+    key: string;
+    title: string;
+    value: (row: Row, index: number) => unknown;
+}
+/**
+ * 将表格行映射为适合导出的对象数组。
+ */
+declare function mapRowsToExportRecords<Row>(params: {
+    rows: Row[];
+    columns: ExportTableColumn<Row>[];
+}): Record<string, unknown>[];
+/**
+ * 生成 CSV 文本内容。
+ */
+declare function buildCsvContent<Row>(params: {
+    rows: Row[];
+    columns: ExportTableColumn<Row>[];
+}): string;
+/**
+ * 生成 TXT 文本内容。
+ */
+declare function buildTxtContent<Row>(params: {
+    rows: Row[];
+    columns: ExportTableColumn<Row>[];
+}): string;
+/**
+ * 下载 JSON 文件。
+ */
+declare function downloadJsonFile(params: {
+    fileName: string;
+    data: unknown;
+    space?: number;
+}): Promise<void>;
+/**
+ * 导出表格 CSV 文件。
+ */
+declare function exportTableToCsv<Row>(params: {
+    fileName: string;
+    rows: Row[];
+    columns: ExportTableColumn<Row>[];
+}): Promise<void>;
+/**
+ * 导出表格 TXT 文件。
+ */
+declare function exportTableToTxt<Row>(params: {
+    fileName: string;
+    rows: Row[];
+    columns: ExportTableColumn<Row>[];
+}): Promise<void>;
+/**
+ * 导出表格 XLSX 文件。
+ */
+declare function exportTableToXlsx<Row>(params: {
+    fileName: string;
+    rows: Row[];
+    columns: ExportTableColumn<Row>[];
+    sheetName?: string;
+}): Promise<void>;
+
+export { type ExportTableColumn, buildCsvContent, buildTxtContent, downloadJsonFile, exportTableToCsv, exportTableToTxt, exportTableToXlsx, mapRowsToExportRecords };