ooxml-core 0.20.0 → 0.21.0

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, {

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, {