ooxml-core 0.19.0 → 0.21.0

package/dist/docx/ui/theme/types.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Editor theme tokens.
+ *
+ * Provenance: the semantic key set mirrors the shared theme of pptx-viewer
+ * (packages/shared/src/theme/types.ts, `ViewerThemeColors` plus `radius`), which follows the
+ * shadcn/ui naming convention. Keys are camelCase here and become `--dve-*` custom properties
+ * (kebab-case). Values accept any CSS color. Only editor chrome is themed: the document paper
+ * stays white like Word's page.
+ */
+export interface EditorTheme {
+    /** Application chrome background (title bar, window). */
+    background: string;
+    foreground: string;
+    /** Ribbon, panel and status-bar surface. */
+    card: string;
+    cardForeground: string;
+    /** Menus, dialogs and other floating surfaces. */
+    popover: string;
+    popoverForeground: string;
+    /** Brand and primary action color. */
+    primary: string;
+    primaryForeground: string;
+    secondary: string;
+    secondaryForeground: string;
+    /** Muted surface; also the area behind the document pages. */
+    muted: string;
+    mutedForeground: string;
+    /** Hover and selected highlight. */
+    accent: string;
+    accentForeground: string;
+    destructive: string;
+    destructiveForeground: string;
+    border: string;
+    input: string;
+    /** Focus ring. */
+    ring: string;
+    /** Base corner radius, e.g. `4px`. */
+    radius: string;
+}
+export type EditorThemeMode = 'light' | 'dark' | 'auto';
+export declare const EDITOR_THEME_MODES: readonly EditorThemeMode[];
+//# sourceMappingURL=types.d.ts.map

package/dist/docx/ui/theme/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/docx/ui/theme/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,MAAM,WAAW,WAAW;IAC3B,yDAAyD;IACzD,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,4CAA4C;IAC5C,IAAI,EAAE,MAAM,CAAC;IACb,cAAc,EAAE,MAAM,CAAC;IACvB,kDAAkD;IAClD,OAAO,EAAE,MAAM,CAAC;IAChB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,sCAAsC;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,8DAA8D;IAC9D,KAAK,EAAE,MAAM,CAAC;IACd,eAAe,EAAE,MAAM,CAAC;IACxB,oCAAoC;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,gBAAgB,EAAE,MAAM,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,qBAAqB,EAAE,MAAM,CAAC;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,kBAAkB;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,sCAAsC;IACtC,MAAM,EAAE,MAAM,CAAC;CACf;AACD,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC;AACxD,eAAO,MAAM,kBAAkB,EAAE,SAAS,eAAe,EAA8B,CAAC"}

package/dist/docx/ui/word-count.d.ts

@@ -0,0 +1,3 @@
+/** Unicode-aware word counting; segmentation is provided by the host's ICU data. */
+export declare function countWords(text: string, locale?: string): number;
+//# sourceMappingURL=word-count.d.ts.map

package/dist/docx/ui/word-count.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"word-count.d.ts","sourceRoot":"","sources":["../../../src/docx/ui/word-count.ts"],"names":[],"mappings":"AAAA,oFAAoF;AACpF,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAYhE"}

package/dist/docx/ui/zoom-fit.d.ts

@@ -0,0 +1,16 @@
+export type ZoomFit = 'actual' | 'width' | 'page' | 'pages';
+/** The gap between pages laid side by side in Print Layout, in CSS pixels. */
+export declare const PAGE_GAP = 24;
+/**
+ * The zoom percentage that makes a page fit its viewport: 100% for `actual`, the viewport's width
+ * for `width`, and both dimensions for `page`. Sizes are in the same CSS-pixel units; the result
+ * is a whole percent clamped to the 10-500% range Word allows.
+ */
+export declare function fitZoomPercent(mode: ZoomFit, viewport: {
+    width: number;
+    height: number;
+}, page: {
+    width: number;
+    height: number;
+}): number;
+//# sourceMappingURL=zoom-fit.d.ts.map

package/dist/docx/ui/zoom-fit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zoom-fit.d.ts","sourceRoot":"","sources":["../../../src/docx/ui/zoom-fit.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,OAAO,GAAG,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,OAAO,CAAC;AAE5D,8EAA8E;AAC9E,eAAO,MAAM,QAAQ,KAAK,CAAC;AAE3B;;;;GAIG;AACH,wBAAgB,cAAc,CAC7B,IAAI,EAAE,OAAO,EACb,QAAQ,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,EAC3C,IAAI,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACrC,MAAM,CAUR"}

package/dist/docx/validate-paragraph.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"validate-paragraph.d.ts","sourceRoot":"","sources":["../../src/docx/validate-paragraph.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAW,OAAO,EAAE,MAAM,YAAY,CAAC;AACxE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAC5D,OAAO,EAAE,OAAO,EAAQ,MAAM,sBAAsB,CAAC;AAMrD,6FAA6F;AAC7F,wBAAgB,sBAAsB,CACrC,CAAC,EAAE,OAAO,EACV,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,mBAAmB,GAAG,SAAS,GACpC,IAAI,CAMN;AAED,gGAAgG;AAChG,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,GAAG,SAAS,GAAG,IAAI,CAGhG;AAYD,wBAAgB,WAAW,CAAC,CAAC,EAAE,OAAO,EAAE,GAAG,EAAE,OAAO,GAAG,IAAI,CA6D1D;AAQD,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,GAAG,IAAI,CA2DxE"}
+{"version":3,"file":"validate-paragraph.d.ts","sourceRoot":"","sources":["../../src/docx/validate-paragraph.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAW,OAAO,EAAE,MAAM,YAAY,CAAC;AACxE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAC5D,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAM/C,6FAA6F;AAC7F,wBAAgB,sBAAsB,CACrC,CAAC,EAAE,OAAO,EACV,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,mBAAmB,GAAG,SAAS,GACpC,IAAI,CAMN;AAED,gGAAgG;AAChG,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,GAAG,SAAS,GAAG,IAAI,CAGhG;AAYD,wBAAgB,WAAW,CAAC,CAAC,EAAE,OAAO,EAAE,GAAG,EAAE,OAAO,GAAG,IAAI,CA6D1D;AAQD,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,GAAG,IAAI,CA2DxE"}

package/dist/index.cjs

@@ -191,13 +191,19 @@ function linearToSrgb255(linear) {
 // src/chart/index.ts
 var chart_exports = {};
 __export(chart_exports, {
+  aggregateByCategory: () => aggregateByCategory,
+  axisTargetIntervals: () => axisTargetIntervals,
   computeBoxStats: () => computeBoxStats,
+  computeHistogramBins: () => computeHistogramBins,
   computeLinearRegression: () => computeLinearRegression,
   computeRSquared: () => computeRSquared,
   computeStackedSeriesPlots: () => computeStackedSeriesPlots,
   fitPolynomial: () => fitPolynomial,
   groupRowsByCategory: () => groupRowsByCategory,
+  niceAxisStep: () => niceAxisStep,
+  niceValueAxisBounds: () => niceValueAxisBounds,
   resolveBlankDisplay: () => resolveBlankDisplay,
+  scottBinCount: () => scottBinCount,
   visibleRuns: () => visibleRuns
 });
 
@@ -420,6 +426,167 @@ function computeStackedSeriesPlots(seriesValues, catCount, percent) {
   });
 }
 
+// src/chart/axis-nice.ts
+var NICE_STEPS = [1, 2, 2.5, 5, 10];
+var HEADROOM = 0.05;
+var POINTS_PER_GRIDLINE = 20;
+var MIN_TARGET_INTERVALS = 1;
+var MAX_TARGET_INTERVALS = 10;
+var PX_PER_POINT = 4 / 3;
+var DEFAULT_TARGET_INTERVALS = 4;
+var ZERO_ANCHOR_RATIO = 5 / 6;
+function axisTargetIntervals(plotHeightPx) {
+  if (!Number.isFinite(plotHeightPx) || plotHeightPx <= 0) {
+    return DEFAULT_TARGET_INTERVALS;
+  }
+  const plotHeightPt = plotHeightPx / PX_PER_POINT;
+  const raw = Math.round(plotHeightPt / POINTS_PER_GRIDLINE);
+  return Math.min(MAX_TARGET_INTERVALS, Math.max(MIN_TARGET_INTERVALS, raw));
+}
+function niceAxisStep(value) {
+  if (!Number.isFinite(value) || value <= 0) {
+    return 1;
+  }
+  const exponent = Math.floor(Math.log10(value));
+  const power = 10 ** exponent;
+  const mantissa = value / power;
+  const step = NICE_STEPS.find((candidate) => mantissa <= candidate + 1e-12) ?? 10;
+  return step * power;
+}
+function snap(value, unit, direction) {
+  const scaled = value / unit;
+  const rounded = direction === "up" ? Math.ceil(scaled - 1e-9) : Math.floor(scaled + 1e-9);
+  return rounded * unit;
+}
+function niceValueAxisBounds(dataMin, dataMax, targetIntervals = DEFAULT_TARGET_INTERVALS, headroom = HEADROOM) {
+  if (!Number.isFinite(dataMin) || !Number.isFinite(dataMax)) {
+    return { min: 0, max: 1, majorUnit: 0.5 };
+  }
+  const low = Math.min(dataMin, dataMax);
+  const high = Math.max(dataMin, dataMax);
+  const intervals = Math.max(1, Math.round(targetIntervals));
+  if (low === high) {
+    if (low === 0) {
+      return { min: 0, max: 1, majorUnit: 1 / intervals };
+    }
+    const unit2 = niceAxisStep(Math.abs(low) / intervals);
+    return low > 0 ? { min: 0, max: snap(low, unit2, "up") || unit2, majorUnit: unit2 } : { min: snap(low, unit2, "down"), max: 0, majorUnit: unit2 };
+  }
+  const dataSpan = high - low;
+  const padding = dataSpan * headroom;
+  let paddedMin;
+  let paddedMax;
+  if (low >= 0) {
+    paddedMin = low < high * ZERO_ANCHOR_RATIO ? 0 : low - padding;
+    paddedMax = high + padding;
+  } else if (high <= 0) {
+    paddedMax = high > low * ZERO_ANCHOR_RATIO ? 0 : high + padding;
+    paddedMin = low - padding;
+  } else {
+    paddedMin = low - padding;
+    paddedMax = high + padding;
+  }
+  const unit = niceAxisStep((paddedMax - paddedMin) / intervals);
+  const min = paddedMin === 0 ? 0 : snap(paddedMin, unit, "down");
+  let max = paddedMax === 0 ? 0 : snap(paddedMax, unit, "up");
+  if (max <= min) {
+    max = min + unit;
+  }
+  return { min, max, majorUnit: unit };
+}
+
+// src/chart/histogram-binning.ts
+function binLabel(lower, upper, closed, format) {
+  return closed === "r" ? `(${format(lower)}, ${format(upper)}]` : `[${format(lower)}, ${format(upper)})`;
+}
+function scottBinCount(values, min, max) {
+  if (values.length < 2 || max <= min) {
+    return 1;
+  }
+  const mean = values.reduce((sum, value) => sum + value, 0) / values.length;
+  const variance = values.reduce((sum, value) => sum + (value - mean) ** 2, 0) / (values.length - 1);
+  const sd = Math.sqrt(variance);
+  if (!(sd > 0)) {
+    return 1;
+  }
+  const width = 3.49 * sd * values.length ** (-1 / 3);
+  return Math.max(1, Math.ceil((max - min) / width));
+}
+function computeHistogramBins(values, options, format = String) {
+  const closed = options.intervalClosed ?? "l";
+  const finite2 = values.map((value, sourceIndex) => ({ value, sourceIndex })).filter((item) => Number.isFinite(item.value));
+  if (finite2.length === 0) {
+    return [];
+  }
+  const underflow = typeof options.underflow === "number" ? options.underflow : void 0;
+  const overflow = typeof options.overflow === "number" ? options.overflow : void 0;
+  const under = underflow === void 0 ? [] : finite2.filter(
+    (item) => closed === "r" ? item.value <= underflow : item.value < underflow
+  );
+  const over = overflow === void 0 ? [] : finite2.filter((item) => closed === "l" ? item.value >= overflow : item.value > overflow);
+  const regular = finite2.filter((item) => !under.includes(item) && !over.includes(item));
+  const result = [];
+  if (underflow !== void 0) {
+    result.push({
+      value: under.length,
+      label: `${closed === "r" ? "\u2264" : "<"} ${format(underflow)}`,
+      sourceIndices: under.map((item) => item.sourceIndex)
+    });
+  }
+  if (regular.length > 0) {
+    const min = Math.min(...regular.map((item) => item.value));
+    const max = Math.max(...regular.map((item) => item.value));
+    const requestedSize = options.binSize && options.binSize > 0 ? options.binSize : void 0;
+    const requestedCount = options.binCount && options.binCount > 0 ? options.binCount : void 0;
+    const start = requestedSize ? Math.floor(min / requestedSize) * requestedSize : min;
+    const count = requestedSize ? Math.max(
+      closed === "l" ? Math.floor((max - start) / requestedSize) + 1 : Math.ceil((max - start) / requestedSize),
+      1
+    ) : Math.max(
+      requestedCount ?? scottBinCount(
+        regular.map((item) => item.value),
+        min,
+        max
+      ),
+      1
+    );
+    const width = requestedSize ?? Math.max((max - start) / count, 1);
+    const bins = Array.from({ length: count }, (_, index) => ({
+      value: 0,
+      label: binLabel(start + index * width, start + (index + 1) * width, closed, format),
+      sourceIndices: []
+    }));
+    for (const item of regular) {
+      const rawIndex = closed === "r" ? Math.ceil((item.value - start) / width) - 1 : Math.floor((item.value - start) / width);
+      const index = Math.max(0, Math.min(rawIndex, bins.length - 1));
+      const bin = bins[index];
+      if (!bin) continue;
+      bin.value += 1;
+      bin.sourceIndices.push(item.sourceIndex);
+    }
+    result.push(...bins);
+  }
+  if (overflow !== void 0) {
+    result.push({
+      value: over.length,
+      label: `${closed === "l" ? "\u2265" : ">"} ${format(overflow)}`,
+      sourceIndices: over.map((item) => item.sourceIndex)
+    });
+  }
+  return result;
+}
+function aggregateByCategory(values, rawCategories) {
+  const { uniqueCategories, rowIndexesByCategory } = groupRowsByCategory(rawCategories);
+  return uniqueCategories.map((label) => {
+    const rows = rowIndexesByCategory.get(label) ?? [];
+    return {
+      value: rows.reduce((sum, row) => sum + (values[row] ?? 0), 0),
+      label,
+      sourceIndices: rows
+    };
+  });
+}
+
 // src/text/index.ts
 var text_exports = {};
 __export(text_exports, {
@@ -880,7 +1047,8 @@ function parseXml(xml, options = {}) {
     }).parseFromString(xml, "application/xml");
   } catch (error) {
     throw new Error(
-      `Invalid ${label} XML: ${error instanceof Error ? error.message : String(error)}`
+      `Invalid ${label} XML: ${error instanceof Error ? error.message : String(error)}`,
+      { cause: error }
     );
   }
   if (parseError || !parsed.documentElement)

package/dist/index.mjs

@@ -189,13 +189,19 @@ function linearToSrgb255(linear) {
 // src/chart/index.ts
 var chart_exports = {};
 __export(chart_exports, {
+  aggregateByCategory: () => aggregateByCategory,
+  axisTargetIntervals: () => axisTargetIntervals,
   computeBoxStats: () => computeBoxStats,
+  computeHistogramBins: () => computeHistogramBins,
   computeLinearRegression: () => computeLinearRegression,
   computeRSquared: () => computeRSquared,
   computeStackedSeriesPlots: () => computeStackedSeriesPlots,
   fitPolynomial: () => fitPolynomial,
   groupRowsByCategory: () => groupRowsByCategory,
+  niceAxisStep: () => niceAxisStep,
+  niceValueAxisBounds: () => niceValueAxisBounds,
   resolveBlankDisplay: () => resolveBlankDisplay,
+  scottBinCount: () => scottBinCount,
   visibleRuns: () => visibleRuns
 });
 
@@ -418,6 +424,167 @@ function computeStackedSeriesPlots(seriesValues, catCount, percent) {
   });
 }
 
+// src/chart/axis-nice.ts
+var NICE_STEPS = [1, 2, 2.5, 5, 10];
+var HEADROOM = 0.05;
+var POINTS_PER_GRIDLINE = 20;
+var MIN_TARGET_INTERVALS = 1;
+var MAX_TARGET_INTERVALS = 10;
+var PX_PER_POINT = 4 / 3;
+var DEFAULT_TARGET_INTERVALS = 4;
+var ZERO_ANCHOR_RATIO = 5 / 6;
+function axisTargetIntervals(plotHeightPx) {
+  if (!Number.isFinite(plotHeightPx) || plotHeightPx <= 0) {
+    return DEFAULT_TARGET_INTERVALS;
+  }
+  const plotHeightPt = plotHeightPx / PX_PER_POINT;
+  const raw = Math.round(plotHeightPt / POINTS_PER_GRIDLINE);
+  return Math.min(MAX_TARGET_INTERVALS, Math.max(MIN_TARGET_INTERVALS, raw));
+}
+function niceAxisStep(value) {
+  if (!Number.isFinite(value) || value <= 0) {
+    return 1;
+  }
+  const exponent = Math.floor(Math.log10(value));
+  const power = 10 ** exponent;
+  const mantissa = value / power;
+  const step = NICE_STEPS.find((candidate) => mantissa <= candidate + 1e-12) ?? 10;
+  return step * power;
+}
+function snap(value, unit, direction) {
+  const scaled = value / unit;
+  const rounded = direction === "up" ? Math.ceil(scaled - 1e-9) : Math.floor(scaled + 1e-9);
+  return rounded * unit;
+}
+function niceValueAxisBounds(dataMin, dataMax, targetIntervals = DEFAULT_TARGET_INTERVALS, headroom = HEADROOM) {
+  if (!Number.isFinite(dataMin) || !Number.isFinite(dataMax)) {
+    return { min: 0, max: 1, majorUnit: 0.5 };
+  }
+  const low = Math.min(dataMin, dataMax);
+  const high = Math.max(dataMin, dataMax);
+  const intervals = Math.max(1, Math.round(targetIntervals));
+  if (low === high) {
+    if (low === 0) {
+      return { min: 0, max: 1, majorUnit: 1 / intervals };
+    }
+    const unit2 = niceAxisStep(Math.abs(low) / intervals);
+    return low > 0 ? { min: 0, max: snap(low, unit2, "up") || unit2, majorUnit: unit2 } : { min: snap(low, unit2, "down"), max: 0, majorUnit: unit2 };
+  }
+  const dataSpan = high - low;
+  const padding = dataSpan * headroom;
+  let paddedMin;
+  let paddedMax;
+  if (low >= 0) {
+    paddedMin = low < high * ZERO_ANCHOR_RATIO ? 0 : low - padding;
+    paddedMax = high + padding;
+  } else if (high <= 0) {
+    paddedMax = high > low * ZERO_ANCHOR_RATIO ? 0 : high + padding;
+    paddedMin = low - padding;
+  } else {
+    paddedMin = low - padding;
+    paddedMax = high + padding;
+  }
+  const unit = niceAxisStep((paddedMax - paddedMin) / intervals);
+  const min = paddedMin === 0 ? 0 : snap(paddedMin, unit, "down");
+  let max = paddedMax === 0 ? 0 : snap(paddedMax, unit, "up");
+  if (max <= min) {
+    max = min + unit;
+  }
+  return { min, max, majorUnit: unit };
+}
+
+// src/chart/histogram-binning.ts
+function binLabel(lower, upper, closed, format) {
+  return closed === "r" ? `(${format(lower)}, ${format(upper)}]` : `[${format(lower)}, ${format(upper)})`;
+}
+function scottBinCount(values, min, max) {
+  if (values.length < 2 || max <= min) {
+    return 1;
+  }
+  const mean = values.reduce((sum, value) => sum + value, 0) / values.length;
+  const variance = values.reduce((sum, value) => sum + (value - mean) ** 2, 0) / (values.length - 1);
+  const sd = Math.sqrt(variance);
+  if (!(sd > 0)) {
+    return 1;
+  }
+  const width = 3.49 * sd * values.length ** (-1 / 3);
+  return Math.max(1, Math.ceil((max - min) / width));
+}
+function computeHistogramBins(values, options, format = String) {
+  const closed = options.intervalClosed ?? "l";
+  const finite2 = values.map((value, sourceIndex) => ({ value, sourceIndex })).filter((item) => Number.isFinite(item.value));
+  if (finite2.length === 0) {
+    return [];
+  }
+  const underflow = typeof options.underflow === "number" ? options.underflow : void 0;
+  const overflow = typeof options.overflow === "number" ? options.overflow : void 0;
+  const under = underflow === void 0 ? [] : finite2.filter(
+    (item) => closed === "r" ? item.value <= underflow : item.value < underflow
+  );
+  const over = overflow === void 0 ? [] : finite2.filter((item) => closed === "l" ? item.value >= overflow : item.value > overflow);
+  const regular = finite2.filter((item) => !under.includes(item) && !over.includes(item));
+  const result = [];
+  if (underflow !== void 0) {
+    result.push({
+      value: under.length,
+      label: `${closed === "r" ? "\u2264" : "<"} ${format(underflow)}`,
+      sourceIndices: under.map((item) => item.sourceIndex)
+    });
+  }
+  if (regular.length > 0) {
+    const min = Math.min(...regular.map((item) => item.value));
+    const max = Math.max(...regular.map((item) => item.value));
+    const requestedSize = options.binSize && options.binSize > 0 ? options.binSize : void 0;
+    const requestedCount = options.binCount && options.binCount > 0 ? options.binCount : void 0;
+    const start = requestedSize ? Math.floor(min / requestedSize) * requestedSize : min;
+    const count = requestedSize ? Math.max(
+      closed === "l" ? Math.floor((max - start) / requestedSize) + 1 : Math.ceil((max - start) / requestedSize),
+      1
+    ) : Math.max(
+      requestedCount ?? scottBinCount(
+        regular.map((item) => item.value),
+        min,
+        max
+      ),
+      1
+    );
+    const width = requestedSize ?? Math.max((max - start) / count, 1);
+    const bins = Array.from({ length: count }, (_, index) => ({
+      value: 0,
+      label: binLabel(start + index * width, start + (index + 1) * width, closed, format),
+      sourceIndices: []
+    }));
+    for (const item of regular) {
+      const rawIndex = closed === "r" ? Math.ceil((item.value - start) / width) - 1 : Math.floor((item.value - start) / width);
+      const index = Math.max(0, Math.min(rawIndex, bins.length - 1));
+      const bin = bins[index];
+      if (!bin) continue;
+      bin.value += 1;
+      bin.sourceIndices.push(item.sourceIndex);
+    }
+    result.push(...bins);
+  }
+  if (overflow !== void 0) {
+    result.push({
+      value: over.length,
+      label: `${closed === "l" ? "\u2265" : ">"} ${format(overflow)}`,
+      sourceIndices: over.map((item) => item.sourceIndex)
+    });
+  }
+  return result;
+}
+function aggregateByCategory(values, rawCategories) {
+  const { uniqueCategories, rowIndexesByCategory } = groupRowsByCategory(rawCategories);
+  return uniqueCategories.map((label) => {
+    const rows = rowIndexesByCategory.get(label) ?? [];
+    return {
+      value: rows.reduce((sum, row) => sum + (values[row] ?? 0), 0),
+      label,
+      sourceIndices: rows
+    };
+  });
+}
+
 // src/text/index.ts
 var text_exports = {};
 __export(text_exports, {
@@ -878,7 +1045,8 @@ function parseXml(xml, options = {}) {
     }).parseFromString(xml, "application/xml");
   } catch (error) {
     throw new Error(
-      `Invalid ${label} XML: ${error instanceof Error ? error.message : String(error)}`
+      `Invalid ${label} XML: ${error instanceof Error ? error.message : String(error)}`,
+      { cause: error }
     );
   }
   if (parseError || !parsed.documentElement)

package/dist/math/index.cjs

@@ -1948,7 +1948,8 @@ function parseXml(xml, options = {}) {
     }).parseFromString(xml, "application/xml");
   } catch (error) {
     throw new Error(
-      `Invalid ${label} XML: ${error instanceof Error ? error.message : String(error)}`
+      `Invalid ${label} XML: ${error instanceof Error ? error.message : String(error)}`,
+      { cause: error }
     );
   }
   if (parseError || !parsed.documentElement)

package/dist/math/index.mjs

@@ -1946,7 +1946,8 @@ function parseXml(xml, options = {}) {
     }).parseFromString(xml, "application/xml");
   } catch (error) {
     throw new Error(
-      `Invalid ${label} XML: ${error instanceof Error ? error.message : String(error)}`
+      `Invalid ${label} XML: ${error instanceof Error ? error.message : String(error)}`,
+      { cause: error }
     );
   }
   if (parseError || !parsed.documentElement)

package/dist/opc/index.cjs

@@ -139,7 +139,8 @@ function parseXml(xml, options = {}) {
     }).parseFromString(xml, "application/xml");
   } catch (error) {
     throw new Error(
-      `Invalid ${label} XML: ${error instanceof Error ? error.message : String(error)}`
+      `Invalid ${label} XML: ${error instanceof Error ? error.message : String(error)}`,
+      { cause: error }
     );
   }
   if (parseError || !parsed.documentElement)

package/dist/opc/index.mjs

@@ -137,7 +137,8 @@ function parseXml(xml, options = {}) {
     }).parseFromString(xml, "application/xml");
   } catch (error) {
     throw new Error(
-      `Invalid ${label} XML: ${error instanceof Error ? error.message : String(error)}`
+      `Invalid ${label} XML: ${error instanceof Error ? error.message : String(error)}`,
+      { cause: error }
     );
   }
   if (parseError || !parsed.documentElement)