@canvas-components/utils 0.2.3 → 0.2.5

package/dist/index.cjs

@@ -33,7 +33,10 @@ var __export = (target, all) => {
 };
 
 // src/export/xlsx-runtime.ts
-function createXlsxWriter(xlsx, header, sheetName, maxRows = 1048576) {
+function createXlsxWriter(xlsx, header, sheetName, maxRows = 1048576, merges = []) {
+  const headerRows = Array.isArray(header[0]) ? header : [header];
+  if (headerRows.length >= maxRows)
+    throw new Error("XLSX \u8868\u5934\u884C\u6570\u8D85\u8FC7\u5DE5\u4F5C\u8868\u5BB9\u91CF");
   const workbook = xlsx.utils.book_new();
   let worksheet;
   let rowCount = 0;
@@ -41,7 +44,7 @@ function createXlsxWriter(xlsx, header, sheetName, maxRows = 1048576) {
   const baseName = sheetName.replace(/[\\/?*[\]:]/g, "_").replace(/^'+|'+$/g, "") || "Sheet1";
   const addSheet = () => {
     const suffix = sheetIndex === 0 ? "" : `_${sheetIndex + 1}`;
-    worksheet = xlsx.utils.aoa_to_sheet([header], {
+    worksheet = xlsx.utils.aoa_to_sheet(headerRows, {
       dense: true
     });
     xlsx.utils.book_append_sheet(
@@ -49,7 +52,8 @@ function createXlsxWriter(xlsx, header, sheetName, maxRows = 1048576) {
       worksheet,
       baseName.slice(0, 31 - suffix.length) + suffix
     );
-    rowCount = 1;
+    if (merges.length && sheetIndex === 0) worksheet["!merges"] = merges;
+    rowCount = headerRows.length;
     sheetIndex += 1;
   };
   addSheet();
@@ -125,7 +129,7 @@ let writer;
 self.onmessage = function(event) {
   try {
     const message = event.data;
-    if (message.type === 'init') writer = createWriter(XLSX, message.header, message.sheetName);
+    if (message.type === 'init') writer = createWriter(XLSX, message.header, message.sheetName, undefined, message.merges);
     else if (message.type === 'append') writer.append(message.rows);
     else if (message.type === 'finish') {
       const buffer = writer.finish();
@@ -228,8 +232,22 @@ async function buildXlsxPart(params, rangeStart, rangeEnd) {
     throw new Error(
       "\u5355\u4EFD XLSX \u6570\u636E\u8D85\u8FC7\u5B89\u5168\u9650\u5236\uFF0C\u8BF7\u4F7F\u7528 exportTableToXlsx \u81EA\u52A8\u5206\u6587\u4EF6\u5BFC\u51FA"
     );
-  const header = columns.map((column) => column.title);
-  let textSize = header.reduce((size, title) => size + title.length, 0);
+  const header = params.headerRows?.length ? params.headerRows : [columns.map((column) => column.title)];
+  const headerRowCount = header.length;
+  const merges = (params.merges ?? []).flatMap((merge) => {
+    if (merge.e.r < headerRowCount) return [merge];
+    const start = Math.max(merge.s.r, headerRowCount + rangeStart);
+    const end = Math.min(merge.e.r, headerRowCount + rangeEnd - 1);
+    return end < start || end === start && merge.s.c === merge.e.c ? [] : [
+      {
+        s: { r: start - rangeStart, c: merge.s.c },
+        e: { r: end - rangeStart, c: merge.e.c }
+      }
+    ];
+  });
+  if (header.some((row) => row.length > columns.length))
+    throw new Error("XLSX \u8868\u5934\u5355\u5143\u683C\u6570\u4E0D\u80FD\u8D85\u8FC7\u5BFC\u51FA\u5217\u6570");
+  let textSize = header.flat().reduce((size, title) => size + title.length, 0);
   const normalizeExportCell = (value) => {
     const cell = normalizeCell(value);
     if (typeof cell === "string") {
@@ -243,7 +261,7 @@ async function buildXlsxPart(params, rangeStart, rangeEnd) {
     }
     return cell;
   };
-  header.forEach((title) => {
+  header.flat().forEach((title) => {
     if (title.length > 32767) throw new Error("XLSX \u8868\u5934\u8D85\u8FC7 32767 \u5B57\u7B26");
   });
   if (textSize > XLSX_MAX_TEXT_CHARS_PER_FILE)
@@ -295,7 +313,7 @@ async function buildXlsxPart(params, rangeStart, rangeEnd) {
           () => fail(new Error("XLSX Worker \u542F\u52A8\u8D85\u65F6")),
           1e4
         );
-        await request({ type: "init", header, sheetName });
+        await request({ type: "init", header, sheetName, merges });
       } catch {
         worker?.terminate();
         worker = void 0;
@@ -305,7 +323,7 @@ async function buildXlsxPart(params, rangeStart, rangeEnd) {
       }
     }
     checkAbort();
-    const writer = worker ? void 0 : createXlsxWriter(XLSX__namespace, header, sheetName);
+    const writer = worker ? void 0 : createXlsxWriter(XLSX__namespace, header, sheetName, void 0, merges);
     const totalRows = rangeEnd - rangeStart;
     const report = (phase, completedRows) => params.onProgress?.({
       phase,
@@ -436,7 +454,7 @@ function getXlsxRowsPerFile(params) {
     throw new Error("XLSX \u5206\u6587\u4EF6\u4E0A\u9650\u5FC5\u987B\u4E3A\u6B63\u6574\u6570");
   const byCells = Math.floor(
     Math.min(cellLimit, XLSX_MAX_CELLS_PER_FILE) / Math.max(1, params.columns.length)
-  ) - 1;
+  ) - (params.headerRows?.length || 1);
   if (byCells < 1) throw new Error("XLSX \u5355\u5143\u683C\u9884\u7B97\u4E0D\u8DB3\u4EE5\u5BB9\u7EB3\u8868\u5934\u548C\u4E00\u884C\u6570\u636E");
   return Math.min(rowLimit, XLSX_MAX_ROWS_PER_FILE, byCells);
 }
@@ -458,7 +476,8 @@ function buildCsvContent(params) {
     columns.map((column) => column.title),
     ...rows.map(
       (row, rowIndex) => columns.map((column) => column.value(row, rowIndex))
-    )
+    ),
+    ...params.footerRows ?? []
   ]);
 }
 function serializeCsvRows(rows, lineBreak = "\n") {
@@ -470,7 +489,13 @@ function buildTxtContent(params) {
   const body = rows.map(
     (row, rowIndex) => columns.map((column) => normalizeTextCell(column.value(row, rowIndex))).join("	")
   );
-  return [header, ...body].join("\n");
+  return [
+    header,
+    ...body,
+    ...(params.footerRows ?? []).map(
+      (row) => row.map(normalizeTextCell).join("	")
+    )
+  ].join("\n");
 }
 async function downloadJsonFile(params) {
   const { data, fileName, space = 2 } = params;
@@ -482,8 +507,8 @@ async function downloadJsonFile(params) {
   });
 }
 async function exportTableToCsv(params) {
-  const { fileName, rows, columns } = params;
-  const content = await buildCsvContentAsync({ rows, columns });
+  const { fileName, rows, columns, footerRows } = params;
+  const content = await buildCsvContentAsync({ rows, columns, footerRows });
   downloadTextFile({
     fileName: ensureExtension(fileName, "csv"),
     content,
@@ -491,8 +516,8 @@ async function exportTableToCsv(params) {
   });
 }
 async function exportTableToTxt(params) {
-  const { fileName, rows, columns } = params;
-  const content = await buildTxtContentAsync({ rows, columns });
+  const { fileName, rows, columns, footerRows } = params;
+  const content = await buildTxtContentAsync({ rows, columns, footerRows });
   downloadTextFile({
     fileName: ensureExtension(fileName, "txt"),
     content,
@@ -536,6 +561,9 @@ async function buildCsvContentAsync(params) {
     }
     await yieldToMainThread();
   }
+  for (const footer of params.footerRows ?? []) {
+    parts.push("\n", footer.map(escapeCsvCell).join(","));
+  }
   return parts.join("");
 }
 async function buildTxtContentAsync(params) {
@@ -551,6 +579,9 @@ async function buildTxtContentAsync(params) {
     }
     await yieldToMainThread();
   }
+  for (const footer of params.footerRows ?? []) {
+    parts.push("\n", footer.map(normalizeTextCell).join("	"));
+  }
   return parts.join("");
 }
 function escapeCsvCell(value) {
@@ -775,6 +806,34 @@ function isPointInRect(x, y, rect) {
   return x >= rect.x && x <= rect.x + rect.width && y >= rect.y && y <= rect.y + rect.height;
 }
 
+// src/canvas-scrollbar.ts
+function resolveCanvasScrollbarAxis(options, axis) {
+  const override = options?.[axis];
+  const merged = { ...options, ...override };
+  const axisSize = axis === "vertical" ? merged.width : merged.height;
+  const requestedThickness = axisSize ?? merged.thickness;
+  const thickness = Number.isFinite(requestedThickness) ? Math.max(requestedThickness, 6) : 10;
+  return {
+    mode: merged.mode === "button" ? "button" : "scrollbar",
+    visible: options?.visible !== false && override !== false && merged.visible !== false,
+    thickness,
+    maxScrollSpeed: Number.isFinite(merged.maxScrollSpeed) && merged.maxScrollSpeed > 0 ? merged.maxScrollSpeed : 1800,
+    thumbColor: merged.thumbColor ?? "rgba(100, 116, 139, 0.8)",
+    trackColor: merged.trackColor,
+    buttonColor: merged.buttonColor ?? "rgba(71, 85, 105, 0.88)",
+    buttonBackgroundColor: merged.buttonBackgroundColor,
+    buttonHoverBackgroundColor: merged.buttonHoverBackgroundColor ?? "rgba(71, 85, 105, 0.09)",
+    buttonPressedBackgroundColor: merged.buttonPressedBackgroundColor ?? "rgba(37, 99, 235, 0.18)",
+    thumbRadius: Number.isFinite(merged.thumbRadius) ? Math.max(merged.thumbRadius, 0) : void 0
+  };
+}
+function resolveCanvasScrollbarHoldSpeed(elapsedMs, maxScrollSpeed) {
+  const maximum = Math.max(maxScrollSpeed, 1);
+  const initial = Math.min(240, maximum);
+  const progress = Math.min(Math.max(elapsedMs, 0) / 2500, 1);
+  return initial + (maximum - initial) * progress * progress;
+}
+
 // src/number/precise.ts
 function addPreciseNumbers(left, right) {
   const leftParts = parseDecimal(left);
@@ -1186,6 +1245,8 @@ exports.mapRowsToExportRecords = mapRowsToExportRecords;
 exports.normalizeDecimalPlaces = normalizeDecimalPlaces;
 exports.parseChineseNumber = parseChineseNumber;
 exports.parseNumberValue = parseNumberValue;
+exports.resolveCanvasScrollbarAxis = resolveCanvasScrollbarAxis;
+exports.resolveCanvasScrollbarHoldSpeed = resolveCanvasScrollbarHoldSpeed;
 exports.resolveDateValue = resolveDateValue;
 exports.roundPreciseNumber = roundPreciseNumber;
 exports.serializeCsvRows = serializeCsvRows;