@canvas-components/utils 0.2.8 → 0.2.9

package/dist/index.cjs

@@ -1215,6 +1215,25 @@ function resolveThousandsSeparator(separator) {
   return ",";
 }
 
+// src/async/index.ts
+async function mapInBatches(length, create, options = {}) {
+  const result = new Array(length);
+  let index = 0;
+  options.signal?.throwIfAborted();
+  while (index < length) {
+    await new Promise((resolve) => setTimeout(resolve, 0));
+    options.signal?.throwIfAborted();
+    const deadline = performance.now() + 8;
+    do {
+      result[index] = create(index);
+      index++;
+    } while (index < length && performance.now() < deadline);
+    options.onProgress?.(index, length);
+  }
+  options.signal?.throwIfAborted();
+  return result;
+}
+
 exports.addPreciseNumbers = addPreciseNumbers;
 exports.buildCsvContent = buildCsvContent;
 exports.buildTxtContent = buildTxtContent;
@@ -1241,6 +1260,7 @@ exports.getValueByDataIndex = getValueByDataIndex;
 exports.isDateTimeFormatPattern = isDateTimeFormatPattern;
 exports.isPointInRect = isPointInRect;
 exports.isSameDataIndex = isSameDataIndex;
+exports.mapInBatches = mapInBatches;
 exports.mapRowsToExportRecords = mapRowsToExportRecords;
 exports.normalizeDecimalPlaces = normalizeDecimalPlaces;
 exports.parseChineseNumber = parseChineseNumber;

package/dist/index.d.cts

@@ -98,4 +98,12 @@ declare function resolveCanvasScrollbarAxis(options: CanvasScrollbarOptions | un
 /** 长按按钮时逐渐加速，2.5 秒达到配置上限。 */
 declare function resolveCanvasScrollbarHoldSpeed(elapsedMs: number, maxScrollSpeed: number): number;
 
-export { type CanvasScrollbarAxisOptions, type CanvasScrollbarOptions, type TableExportColumnChoice, type TableExportNameRequest, type TableExportSettings, type TableExportSummarySettings, type TableExportSummaryType, resolveCanvasScrollbarAxis, resolveCanvasScrollbarHoldSpeed };
+/** 分批任务的取消信号与进度通知。 */
+interface BatchTaskOptions {
+    signal?: AbortSignal;
+    onProgress?: (completed: number, total: number) => void;
+}
+/** 按约 8ms 的时间片构造数组，在批次之间让出主线程。 */
+declare function mapInBatches<T>(length: number, create: (index: number) => T, options?: BatchTaskOptions): Promise<T[]>;
+
+export { type BatchTaskOptions, type CanvasScrollbarAxisOptions, type CanvasScrollbarOptions, type TableExportColumnChoice, type TableExportNameRequest, type TableExportSettings, type TableExportSummarySettings, type TableExportSummaryType, mapInBatches, resolveCanvasScrollbarAxis, resolveCanvasScrollbarHoldSpeed };

package/dist/index.d.ts

@@ -98,4 +98,12 @@ declare function resolveCanvasScrollbarAxis(options: CanvasScrollbarOptions | un
 /** 长按按钮时逐渐加速，2.5 秒达到配置上限。 */
 declare function resolveCanvasScrollbarHoldSpeed(elapsedMs: number, maxScrollSpeed: number): number;
 
-export { type CanvasScrollbarAxisOptions, type CanvasScrollbarOptions, type TableExportColumnChoice, type TableExportNameRequest, type TableExportSettings, type TableExportSummarySettings, type TableExportSummaryType, resolveCanvasScrollbarAxis, resolveCanvasScrollbarHoldSpeed };
+/** 分批任务的取消信号与进度通知。 */
+interface BatchTaskOptions {
+    signal?: AbortSignal;
+    onProgress?: (completed: number, total: number) => void;
+}
+/** 按约 8ms 的时间片构造数组，在批次之间让出主线程。 */
+declare function mapInBatches<T>(length: number, create: (index: number) => T, options?: BatchTaskOptions): Promise<T[]>;
+
+export { type BatchTaskOptions, type CanvasScrollbarAxisOptions, type CanvasScrollbarOptions, type TableExportColumnChoice, type TableExportNameRequest, type TableExportSettings, type TableExportSummarySettings, type TableExportSummaryType, mapInBatches, resolveCanvasScrollbarAxis, resolveCanvasScrollbarHoldSpeed };

package/dist/index.js

@@ -1193,4 +1193,23 @@ function resolveThousandsSeparator(separator) {
   return ",";
 }
 
-export { addPreciseNumbers, buildCsvContent, buildTxtContent, clamp, comparePreciseNumbers, copyJson, copyRows, copyText, copyTextSync, dividePreciseNumber, downloadJsonFile, exportTableToCsv, exportTableToTxt, exportTableToXlsx, formatChineseNumber, formatCustomNumberPattern, formatDateTimeValue, formatNumberValue, formatPercentValue, formatPreciseNumber, formatRowsForClipboard, formatScientificValue, getValueByDataIndex, isDateTimeFormatPattern, isPointInRect, isSameDataIndex, mapRowsToExportRecords, normalizeDecimalPlaces, parseChineseNumber, parseNumberValue, resolveCanvasScrollbarAxis, resolveCanvasScrollbarHoldSpeed, resolveDateValue, roundPreciseNumber, serializeCsvRows, stringifyDataIndex, sumPreciseNumbers };
+// src/async/index.ts
+async function mapInBatches(length, create, options = {}) {
+  const result = new Array(length);
+  let index = 0;
+  options.signal?.throwIfAborted();
+  while (index < length) {
+    await new Promise((resolve) => setTimeout(resolve, 0));
+    options.signal?.throwIfAborted();
+    const deadline = performance.now() + 8;
+    do {
+      result[index] = create(index);
+      index++;
+    } while (index < length && performance.now() < deadline);
+    options.onProgress?.(index, length);
+  }
+  options.signal?.throwIfAborted();
+  return result;
+}
+
+export { addPreciseNumbers, buildCsvContent, buildTxtContent, clamp, comparePreciseNumbers, copyJson, copyRows, copyText, copyTextSync, dividePreciseNumber, downloadJsonFile, exportTableToCsv, exportTableToTxt, exportTableToXlsx, formatChineseNumber, formatCustomNumberPattern, formatDateTimeValue, formatNumberValue, formatPercentValue, formatPreciseNumber, formatRowsForClipboard, formatScientificValue, getValueByDataIndex, isDateTimeFormatPattern, isPointInRect, isSameDataIndex, mapInBatches, mapRowsToExportRecords, normalizeDecimalPlaces, parseChineseNumber, parseNumberValue, resolveCanvasScrollbarAxis, resolveCanvasScrollbarHoldSpeed, resolveDateValue, roundPreciseNumber, serializeCsvRows, stringifyDataIndex, sumPreciseNumbers };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@canvas-components/utils",
-  "version": "0.2.8",
+  "version": "0.2.9",
   "description": "Clipboard and export utilities for canvas-components.",
   "license": "MIT",
   "type": "module",