deepbox 0.1.0 → 0.2.0

package/dist/{chunk-ALS7ETWZ.cjs → chunk-HI2EZHCJ.cjs}

@@ -1,11 +1,11 @@
 'use strict';
 
-var chunk6AE5FKKQ_cjs = require('./chunk-6AE5FKKQ.cjs');
-var chunkJSCDE774_cjs = require('./chunk-JSCDE774.cjs');
+var chunk724CXHFH_cjs = require('./chunk-724CXHFH.cjs');
+var chunkZ6BGACIH_cjs = require('./chunk-Z6BGACIH.cjs');
 
 // src/plot/index.ts
 var plot_exports = {};
-chunkJSCDE774_cjs.__export(plot_exports, {
+chunkZ6BGACIH_cjs.__export(plot_exports, {
   Axes: () => Axes,
   Figure: () => Figure,
   bar: () => bar,
@@ -333,13 +333,13 @@ function buildLegendEntry(label, entry) {
 // src/plot/utils/validation.ts
 function assertPositiveInt(name, v) {
   if (!Number.isFinite(v)) {
-    throw new chunkJSCDE774_cjs.InvalidParameterError(`${name} must be a positive integer; received ${v}`, name, v);
+    throw new chunkZ6BGACIH_cjs.InvalidParameterError(`${name} must be a positive integer; received ${v}`, name, v);
   }
   if (v <= 0) {
-    throw new chunkJSCDE774_cjs.InvalidParameterError(`${name} must be a positive integer; received ${v}`, name, v);
+    throw new chunkZ6BGACIH_cjs.InvalidParameterError(`${name} must be a positive integer; received ${v}`, name, v);
   }
   if (Math.trunc(v) !== v) {
-    throw new chunkJSCDE774_cjs.InvalidParameterError(`${name} must be a positive integer; received ${v}`, name, v);
+    throw new chunkZ6BGACIH_cjs.InvalidParameterError(`${name} must be a positive integer; received ${v}`, name, v);
   }
 }
 function isFiniteNumber(x) {
@@ -367,7 +367,7 @@ var Bar2D = class {
   barWidth;
   label;
   constructor(x, height, options) {
-    if (x.length !== height.length) throw new chunkJSCDE774_cjs.ShapeError("x and height must have the same length");
+    if (x.length !== height.length) throw new chunkZ6BGACIH_cjs.ShapeError("x and height must have the same length");
     this.x = x;
     this.height = height;
     this.color = normalizeColor(options.color, "#2ca02c");
@@ -572,7 +572,7 @@ var Boxplot = class {
     const n = sorted.length;
     if (n === 0) {
       if (data.length > 0) {
-        throw new chunkJSCDE774_cjs.InvalidParameterError(
+        throw new chunkZ6BGACIH_cjs.InvalidParameterError(
           "boxplot data must contain at least one finite value",
           "data",
           data
@@ -788,7 +788,7 @@ function resolveLevels(min, max, levels) {
   if (Array.isArray(levels)) {
     const filtered = levels.filter((v) => Number.isFinite(v));
     if (filtered.length === 0) {
-      throw new chunkJSCDE774_cjs.InvalidParameterError(
+      throw new chunkZ6BGACIH_cjs.InvalidParameterError(
         "levels must contain at least one finite value",
         "levels",
         levels
@@ -800,7 +800,7 @@ function resolveLevels(min, max, levels) {
   }
   const numLevels = typeof levels === "number" ? levels : 10;
   if (!Number.isFinite(numLevels) || Math.trunc(numLevels) !== numLevels || numLevels <= 0) {
-    throw new chunkJSCDE774_cjs.InvalidParameterError(
+    throw new chunkZ6BGACIH_cjs.InvalidParameterError(
       `levels must be a positive integer; received ${numLevels}`,
       "levels",
       numLevels
@@ -829,7 +829,7 @@ function resolveLevelColors(levels, options) {
     for (let i = 0; i < count; i++) colors.push(normalized);
   } else if (options.colormap) {
     if (!["viridis", "plasma", "inferno", "magma", "grayscale"].includes(options.colormap)) {
-      throw new chunkJSCDE774_cjs.InvalidParameterError(
+      throw new chunkZ6BGACIH_cjs.InvalidParameterError(
         `colormap must be one of viridis, plasma, inferno, magma, grayscale; received ${options.colormap}`,
         "colormap",
         options.colormap
@@ -868,14 +868,14 @@ var Contour2D = class {
   label;
   constructor(grid, options = {}) {
     if (options.vmin !== void 0 && !Number.isFinite(options.vmin)) {
-      throw new chunkJSCDE774_cjs.InvalidParameterError(
+      throw new chunkZ6BGACIH_cjs.InvalidParameterError(
         `vmin must be finite; received ${options.vmin}`,
         "vmin",
         options.vmin
       );
     }
     if (options.vmax !== void 0 && !Number.isFinite(options.vmax)) {
-      throw new chunkJSCDE774_cjs.InvalidParameterError(
+      throw new chunkZ6BGACIH_cjs.InvalidParameterError(
         `vmax must be finite; received ${options.vmax}`,
         "vmax",
         options.vmax
@@ -884,7 +884,7 @@ var Contour2D = class {
     const min = options.vmin ?? grid.dataMin;
     const max = options.vmax ?? grid.dataMax;
     if (Number.isFinite(min) && Number.isFinite(max) && min > max) {
-      throw new chunkJSCDE774_cjs.InvalidParameterError(
+      throw new chunkZ6BGACIH_cjs.InvalidParameterError(
         `vmin must be <= vmax; received vmin=${min} vmax=${max}`,
         "vmin/vmax",
         { vmin: min, vmax: max }
@@ -897,7 +897,7 @@ var Contour2D = class {
     this.label = normalizeLegendLabel(options.label);
     const lw = options.linewidth ?? 1;
     if (!Number.isFinite(lw) || lw <= 0) {
-      throw new chunkJSCDE774_cjs.InvalidParameterError(
+      throw new chunkZ6BGACIH_cjs.InvalidParameterError(
         `linewidth must be a positive number; received ${lw}`,
         "linewidth",
         lw
@@ -1203,7 +1203,7 @@ function resolveFillLevels(min, max, levels) {
     const unique = Array.from(new Set(filtered));
     unique.sort((a, b) => a - b);
     if (unique.length < 2) {
-      throw new chunkJSCDE774_cjs.InvalidParameterError(
+      throw new chunkZ6BGACIH_cjs.InvalidParameterError(
         "levels must contain at least two finite values",
         "levels",
         levels
@@ -1213,7 +1213,7 @@ function resolveFillLevels(min, max, levels) {
   }
   const numLevels = typeof levels === "number" ? levels : 10;
   if (!Number.isFinite(numLevels) || Math.trunc(numLevels) !== numLevels || numLevels <= 0) {
-    throw new chunkJSCDE774_cjs.InvalidParameterError(
+    throw new chunkZ6BGACIH_cjs.InvalidParameterError(
       `levels must be a positive integer; received ${numLevels}`,
       "levels",
       numLevels
@@ -1244,7 +1244,7 @@ function resolveBandColors(bandCount, options) {
     for (let i = 0; i < bandCount; i++) colors.push(normalized);
   } else if (options.colormap) {
     if (!["viridis", "plasma", "inferno", "magma", "grayscale"].includes(options.colormap)) {
-      throw new chunkJSCDE774_cjs.InvalidParameterError(
+      throw new chunkZ6BGACIH_cjs.InvalidParameterError(
         `colormap must be one of viridis, plasma, inferno, magma, grayscale; received ${options.colormap}`,
         "colormap",
         options.colormap
@@ -1289,14 +1289,14 @@ var ContourF2D = class {
     this.xCoords = grid.xCoords;
     this.yCoords = grid.yCoords;
     if (options.vmin !== void 0 && !Number.isFinite(options.vmin)) {
-      throw new chunkJSCDE774_cjs.InvalidParameterError(
+      throw new chunkZ6BGACIH_cjs.InvalidParameterError(
         `vmin must be finite; received ${options.vmin}`,
         "vmin",
         options.vmin
       );
     }
     if (options.vmax !== void 0 && !Number.isFinite(options.vmax)) {
-      throw new chunkJSCDE774_cjs.InvalidParameterError(
+      throw new chunkZ6BGACIH_cjs.InvalidParameterError(
         `vmax must be finite; received ${options.vmax}`,
         "vmax",
         options.vmax
@@ -1305,7 +1305,7 @@ var ContourF2D = class {
     const min = options.vmin ?? grid.dataMin;
     const max = options.vmax ?? grid.dataMax;
     if (Number.isFinite(min) && Number.isFinite(max) && min > max) {
-      throw new chunkJSCDE774_cjs.InvalidParameterError(
+      throw new chunkZ6BGACIH_cjs.InvalidParameterError(
         `vmin must be <= vmax; received vmin=${min} vmax=${max}`,
         "vmin/vmax",
         { vmin: min, vmax: max }
@@ -1314,7 +1314,7 @@ var ContourF2D = class {
     this.levels = resolveFillLevels(min, max, options.levels);
     const bandCount = this.levels.length - 1;
     if (bandCount <= 0) {
-      throw new chunkJSCDE774_cjs.InvalidParameterError(
+      throw new chunkZ6BGACIH_cjs.InvalidParameterError(
         "levels must define at least one fill band",
         "levels",
         this.levels
@@ -1445,7 +1445,7 @@ var Heatmap2D = class {
     this.cols = cols;
     const colormap = options.colormap ?? "viridis";
     if (!["viridis", "plasma", "inferno", "magma", "grayscale"].includes(colormap)) {
-      throw new chunkJSCDE774_cjs.InvalidParameterError(
+      throw new chunkZ6BGACIH_cjs.InvalidParameterError(
         `colormap must be one of viridis, plasma, inferno, magma, grayscale; received ${colormap}`,
         "colormap",
         colormap
@@ -1457,10 +1457,10 @@ var Heatmap2D = class {
     if (extent) {
       const { xmin, xmax, ymin, ymax } = extent;
       if (!Number.isFinite(xmin) || !Number.isFinite(xmax) || !Number.isFinite(ymin) || !Number.isFinite(ymax)) {
-        throw new chunkJSCDE774_cjs.InvalidParameterError("extent values must be finite", "extent", extent);
+        throw new chunkZ6BGACIH_cjs.InvalidParameterError("extent values must be finite", "extent", extent);
       }
       if (xmax <= xmin || ymax <= ymin) {
-        throw new chunkJSCDE774_cjs.InvalidParameterError("extent ranges must be positive", "extent", extent);
+        throw new chunkZ6BGACIH_cjs.InvalidParameterError("extent ranges must be positive", "extent", extent);
       }
       this.xMin = xmin;
       this.xMax = xmax;
@@ -1482,21 +1482,21 @@ var Heatmap2D = class {
       }
     }
     if (!Number.isFinite(min) || !Number.isFinite(max)) {
-      throw new chunkJSCDE774_cjs.InvalidParameterError(
+      throw new chunkZ6BGACIH_cjs.InvalidParameterError(
         "heatmap data must contain at least one finite value",
         "data",
         data
       );
     }
     if (options.vmin !== void 0 && !Number.isFinite(options.vmin)) {
-      throw new chunkJSCDE774_cjs.InvalidParameterError(
+      throw new chunkZ6BGACIH_cjs.InvalidParameterError(
         `vmin must be finite; received ${options.vmin}`,
         "vmin",
         options.vmin
       );
     }
     if (options.vmax !== void 0 && !Number.isFinite(options.vmax)) {
-      throw new chunkJSCDE774_cjs.InvalidParameterError(
+      throw new chunkZ6BGACIH_cjs.InvalidParameterError(
         `vmax must be finite; received ${options.vmax}`,
         "vmax",
         options.vmax
@@ -1505,7 +1505,7 @@ var Heatmap2D = class {
     const vmin = options.vmin ?? min;
     const vmax = options.vmax ?? max;
     if (Number.isFinite(vmin) && Number.isFinite(vmax) && vmin > vmax) {
-      throw new chunkJSCDE774_cjs.InvalidParameterError(
+      throw new chunkZ6BGACIH_cjs.InvalidParameterError(
         `vmin must be <= vmax; received vmin=${vmin} vmax=${vmax}`,
         "vmin/vmax",
         { vmin, vmax }
@@ -1588,7 +1588,7 @@ var Histogram = class {
   label;
   constructor(data, numBins, options) {
     if (!Number.isFinite(numBins) || Math.trunc(numBins) !== numBins || numBins <= 0) {
-      throw new chunkJSCDE774_cjs.InvalidParameterError(
+      throw new chunkZ6BGACIH_cjs.InvalidParameterError(
         `bins must be a positive integer; received ${numBins}`,
         "bins",
         numBins
@@ -1613,7 +1613,7 @@ var Histogram = class {
     }
     if (!hasFinite) {
       if (hasInfinity) {
-        throw new chunkJSCDE774_cjs.InvalidParameterError(
+        throw new chunkZ6BGACIH_cjs.InvalidParameterError(
           "histogram data must contain at least one finite value",
           "data",
           data
@@ -1724,7 +1724,7 @@ var HorizontalBar2D = class {
   barHeight;
   label;
   constructor(y, width, options) {
-    if (y.length !== width.length) throw new chunkJSCDE774_cjs.ShapeError("y and width must have the same length");
+    if (y.length !== width.length) throw new chunkZ6BGACIH_cjs.ShapeError("y and width must have the same length");
     this.y = y;
     this.width = width;
     this.color = normalizeColor(options.color, "#9467bd");
@@ -1812,13 +1812,13 @@ var Line2D = class {
   linewidth;
   label;
   constructor(x, y, options) {
-    if (x.length !== y.length) throw new chunkJSCDE774_cjs.ShapeError("x and y must have the same length");
+    if (x.length !== y.length) throw new chunkZ6BGACIH_cjs.ShapeError("x and y must have the same length");
     this.x = x;
     this.y = y;
     this.color = normalizeColor(options.color, "#1f77b4");
     const lw = options.linewidth ?? 2;
     if (!Number.isFinite(lw) || lw <= 0) {
-      throw new chunkJSCDE774_cjs.InvalidParameterError(
+      throw new chunkZ6BGACIH_cjs.InvalidParameterError(
         `linewidth must be a positive number; received ${lw}`,
         "linewidth",
         lw
@@ -1903,10 +1903,10 @@ var Pie = class {
   label;
   constructor(centerX, centerY, radius, values, labels, options = {}, rangeOverride) {
     if (!Number.isFinite(centerX) || !Number.isFinite(centerY)) {
-      throw new chunkJSCDE774_cjs.InvalidParameterError("pie center must be finite", "center", { centerX, centerY });
+      throw new chunkZ6BGACIH_cjs.InvalidParameterError("pie center must be finite", "center", { centerX, centerY });
     }
     if (!Number.isFinite(radius) || radius <= 0) {
-      throw new chunkJSCDE774_cjs.InvalidParameterError(
+      throw new chunkZ6BGACIH_cjs.InvalidParameterError(
         `pie radius must be positive; received ${radius}`,
         "radius",
         radius
@@ -1916,10 +1916,10 @@ var Pie = class {
     this.centerY = centerY;
     this.radius = radius;
     if (values.length === 0) {
-      throw new chunkJSCDE774_cjs.InvalidParameterError("pie requires at least one value", "values", values.length);
+      throw new chunkZ6BGACIH_cjs.InvalidParameterError("pie requires at least one value", "values", values.length);
     }
     if (labels && labels.length !== values.length) {
-      throw new chunkJSCDE774_cjs.InvalidParameterError(
+      throw new chunkZ6BGACIH_cjs.InvalidParameterError(
         `labels length (${labels.length}) must match values length (${values.length})`,
         "labels",
         labels
@@ -1932,16 +1932,16 @@ var Pie = class {
     for (let i = 0; i < values.length; i++) {
       const v = values[i] ?? 0;
       if (!isFiniteNumber(v)) {
-        throw new chunkJSCDE774_cjs.InvalidParameterError("pie values must be finite", "values", v);
+        throw new chunkZ6BGACIH_cjs.InvalidParameterError("pie values must be finite", "values", v);
       }
       if (v < 0) {
-        throw new chunkJSCDE774_cjs.InvalidParameterError("pie values must be non-negative", "values", v);
+        throw new chunkZ6BGACIH_cjs.InvalidParameterError("pie values must be non-negative", "values", v);
       }
       validValues.push(v);
     }
     const total = validValues.reduce((sum, val) => sum + val, 0);
     if (!Number.isFinite(total) || total <= 0) {
-      throw new chunkJSCDE774_cjs.InvalidParameterError(
+      throw new chunkZ6BGACIH_cjs.InvalidParameterError(
         "pie values must sum to a positive number",
         "values",
         validValues
@@ -2106,13 +2106,13 @@ var Scatter2D = class {
   size;
   label;
   constructor(x, y, options) {
-    if (x.length !== y.length) throw new chunkJSCDE774_cjs.ShapeError("x and y must have the same length");
+    if (x.length !== y.length) throw new chunkZ6BGACIH_cjs.ShapeError("x and y must have the same length");
     this.x = x;
     this.y = y;
     this.color = normalizeColor(options.color, "#ff7f0e");
     const size = options.size ?? 5;
     if (!Number.isFinite(size) || size <= 0) {
-      throw new chunkJSCDE774_cjs.InvalidParameterError(
+      throw new chunkZ6BGACIH_cjs.InvalidParameterError(
         `size must be a positive number; received ${size}`,
         "size",
         size
@@ -2197,7 +2197,7 @@ var Violinplot = class {
     const n = sorted.length;
     if (n === 0) {
       if (data.length > 0) {
-        throw new chunkJSCDE774_cjs.InvalidParameterError(
+        throw new chunkZ6BGACIH_cjs.InvalidParameterError(
           "violinplot data must contain at least one finite value",
           "data",
           data
@@ -2369,8 +2369,8 @@ var Violinplot = class {
 // src/plot/utils/tensor.ts
 function tensorToFloat64Vector1D(t) {
   const tensor2 = "tensor" in t ? t.tensor : t;
-  if (tensor2.ndim !== 1) throw new chunkJSCDE774_cjs.ShapeError("Expected a 1D tensor");
-  if (tensor2.dtype === "string") throw new chunkJSCDE774_cjs.DTypeError("Plotting does not support string tensors");
+  if (tensor2.ndim !== 1) throw new chunkZ6BGACIH_cjs.ShapeError("Expected a 1D tensor");
+  if (tensor2.dtype === "string") throw new chunkZ6BGACIH_cjs.DTypeError("Plotting does not support string tensors");
   const n = tensor2.shape[0] ?? 0;
   const stride = tensor2.strides[0] ?? 0;
   const out = new Float64Array(n);
@@ -2383,8 +2383,8 @@ function tensorToFloat64Vector1D(t) {
 }
 function tensorToFloat64Matrix2D(t) {
   const tensor2 = "tensor" in t ? t.tensor : t;
-  if (tensor2.ndim !== 2) throw new chunkJSCDE774_cjs.ShapeError("Expected a 2D tensor");
-  if (tensor2.dtype === "string") throw new chunkJSCDE774_cjs.DTypeError("Plotting does not support string tensors");
+  if (tensor2.ndim !== 2) throw new chunkZ6BGACIH_cjs.ShapeError("Expected a 2D tensor");
+  if (tensor2.dtype === "string") throw new chunkZ6BGACIH_cjs.DTypeError("Plotting does not support string tensors");
   const rows = tensor2.shape[0] ?? 0;
   const cols = tensor2.shape[1] ?? 0;
   const strideRow = tensor2.strides[0] ?? 0;
@@ -2416,7 +2416,7 @@ function safeConvertToNumber(value) {
   if (typeof value === "bigint") {
     return Number(value);
   }
-  throw new chunkJSCDE774_cjs.DTypeError(`Cannot convert ${typeof value} to number for plotting`);
+  throw new chunkZ6BGACIH_cjs.DTypeError(`Cannot convert ${typeof value} to number for plotting`);
 }
 
 // src/plot/utils/contours.ts
@@ -2435,7 +2435,7 @@ function assertFiniteCoords(values, name) {
   for (let i = 0; i < values.length; i++) {
     const v = values[i] ?? 0;
     if (!isFiniteNumber(v)) {
-      throw new chunkJSCDE774_cjs.InvalidParameterError(`${name} coordinates must be finite`, name, v);
+      throw new chunkZ6BGACIH_cjs.InvalidParameterError(`${name} coordinates must be finite`, name, v);
     }
   }
 }
@@ -2455,7 +2455,7 @@ function computeDataRange(data) {
     if (v > max) max = v;
   }
   if (!Number.isFinite(min) || !Number.isFinite(max)) {
-    throw new chunkJSCDE774_cjs.InvalidParameterError("Contour requires at least one finite Z value", "Z", data);
+    throw new chunkZ6BGACIH_cjs.InvalidParameterError("Contour requires at least one finite Z value", "Z", data);
   }
   return { min, max, hasNaN };
 }
@@ -2463,10 +2463,10 @@ function meshgridToCoords(X, Y, rows, cols) {
   const xMat = tensorToFloat64Matrix2D(X);
   const yMat = tensorToFloat64Matrix2D(Y);
   if (xMat.rows !== rows || xMat.cols !== cols) {
-    throw new chunkJSCDE774_cjs.ShapeError("X must match Z shape for meshgrid input");
+    throw new chunkZ6BGACIH_cjs.ShapeError("X must match Z shape for meshgrid input");
   }
   if (yMat.rows !== rows || yMat.cols !== cols) {
-    throw new chunkJSCDE774_cjs.ShapeError("Y must match Z shape for meshgrid input");
+    throw new chunkZ6BGACIH_cjs.ShapeError("Y must match Z shape for meshgrid input");
   }
   const xCoords = new Float64Array(cols);
   const yCoords = new Float64Array(rows);
@@ -2485,13 +2485,13 @@ function meshgridToCoords(X, Y, rows, cols) {
       const xv = xMat.data[rowOffset + j] ?? 0;
       const yv = yMat.data[rowOffset + j] ?? 0;
       if (!isFiniteNumber(xv) || !isFiniteNumber(yv)) {
-        throw new chunkJSCDE774_cjs.InvalidParameterError("X/Y meshgrid values must be finite", "X/Y", {
+        throw new chunkZ6BGACIH_cjs.InvalidParameterError("X/Y meshgrid values must be finite", "X/Y", {
           x: xv,
           y: yv
         });
       }
       if (Math.abs(xv - expectedX) > tol || Math.abs(yv - expectedY) > tol) {
-        throw new chunkJSCDE774_cjs.InvalidParameterError(
+        throw new chunkZ6BGACIH_cjs.InvalidParameterError(
           "Contour supports only rectilinear grids (use 1D X/Y or meshgrid)",
           "X/Y",
           { x: xv, y: yv }
@@ -2517,10 +2517,10 @@ function buildContourGrid(X, Y, Z, extent) {
     if (extent) {
       const { xmin, xmax, ymin, ymax } = extent;
       if (!Number.isFinite(xmin) || !Number.isFinite(xmax) || !Number.isFinite(ymin) || !Number.isFinite(ymax)) {
-        throw new chunkJSCDE774_cjs.InvalidParameterError("extent values must be finite", "extent", extent);
+        throw new chunkZ6BGACIH_cjs.InvalidParameterError("extent values must be finite", "extent", extent);
       }
       if (xmax <= xmin || ymax <= ymin) {
-        throw new chunkJSCDE774_cjs.InvalidParameterError("extent ranges must be positive", "extent", extent);
+        throw new chunkZ6BGACIH_cjs.InvalidParameterError("extent ranges must be positive", "extent", extent);
       }
       const xDenom = Math.max(1, cols - 1);
       const yDenom = Math.max(1, rows - 1);
@@ -2536,7 +2536,7 @@ function buildContourGrid(X, Y, Z, extent) {
     }
   } else if (xSize > 0 && ySize > 0) {
     if (extent) {
-      throw new chunkJSCDE774_cjs.InvalidParameterError(
+      throw new chunkZ6BGACIH_cjs.InvalidParameterError(
         "extent cannot be combined with explicit X/Y coordinates",
         "extent",
         extent
@@ -2548,20 +2548,20 @@ function buildContourGrid(X, Y, Z, extent) {
       xCoords = tensorToFloat64Vector1D(X);
       yCoords = tensorToFloat64Vector1D(Y);
       if (xCoords.length !== cols) {
-        throw new chunkJSCDE774_cjs.ShapeError(`X must have length ${cols}; received ${xCoords.length}`);
+        throw new chunkZ6BGACIH_cjs.ShapeError(`X must have length ${cols}; received ${xCoords.length}`);
       }
       if (yCoords.length !== rows) {
-        throw new chunkJSCDE774_cjs.ShapeError(`Y must have length ${rows}; received ${yCoords.length}`);
+        throw new chunkZ6BGACIH_cjs.ShapeError(`Y must have length ${rows}; received ${yCoords.length}`);
       }
       assertFiniteCoords(xCoords, "X");
       assertFiniteCoords(yCoords, "Y");
     } else if (rawX.ndim === 2 && rawY.ndim === 2) {
       ({ xCoords, yCoords } = meshgridToCoords(X, Y, rows, cols));
     } else {
-      throw new chunkJSCDE774_cjs.ShapeError("X and Y must be 1D vectors or 2D meshgrids matching Z");
+      throw new chunkZ6BGACIH_cjs.ShapeError("X and Y must be 1D vectors or 2D meshgrids matching Z");
     }
   } else {
-    throw new chunkJSCDE774_cjs.InvalidParameterError("Both X and Y must be provided or both empty", "X/Y", {
+    throw new chunkZ6BGACIH_cjs.InvalidParameterError("Both X and Y must be provided or both empty", "X/Y", {
       xSize,
       ySize
     });
@@ -2719,7 +2719,7 @@ var Axes = class {
       height: this.fig.height
     };
     if (!Number.isFinite(base.x) || !Number.isFinite(base.y) || !Number.isFinite(base.width) || !Number.isFinite(base.height) || base.width <= 0 || base.height <= 0) {
-      throw new chunkJSCDE774_cjs.InvalidParameterError(
+      throw new chunkZ6BGACIH_cjs.InvalidParameterError(
         "viewport must have positive finite width/height",
         "viewport",
         base
@@ -2727,11 +2727,11 @@ var Axes = class {
     }
     const p = options.padding ?? Math.min(50, Math.max(0, Math.floor(Math.min(base.width, base.height) / 4)));
     if (!Number.isFinite(p) || p < 0) {
-      throw new chunkJSCDE774_cjs.InvalidParameterError(`padding must be non-negative; received ${p}`, "padding", p);
+      throw new chunkZ6BGACIH_cjs.InvalidParameterError(`padding must be non-negative; received ${p}`, "padding", p);
     }
     if (2 * p >= base.width || 2 * p >= base.height) {
       if (this.paddingProvided) {
-        throw new chunkJSCDE774_cjs.InvalidParameterError("padding is too large", "padding", p);
+        throw new chunkZ6BGACIH_cjs.InvalidParameterError("padding is too large", "padding", p);
       }
       const maxSafe = Math.max(0, Math.floor((Math.min(base.width, base.height) - 1) / 2));
       this.padding = maxSafe;
@@ -2782,7 +2782,7 @@ var Axes = class {
    */
   legend(options = {}) {
     if (options.location !== void 0 && !["upper-right", "upper-left", "lower-right", "lower-left"].includes(options.location)) {
-      throw new chunkJSCDE774_cjs.InvalidParameterError(
+      throw new chunkZ6BGACIH_cjs.InvalidParameterError(
         `legend location must be one of upper-right, upper-left, lower-right, lower-left; received ${options.location}`,
         "location",
         options.location
@@ -2790,7 +2790,7 @@ var Axes = class {
     }
     if (options.fontSize !== void 0) {
       if (!Number.isFinite(options.fontSize) || options.fontSize <= 0) {
-        throw new chunkJSCDE774_cjs.InvalidParameterError(
+        throw new chunkZ6BGACIH_cjs.InvalidParameterError(
           `legend fontSize must be positive; received ${options.fontSize}`,
           "fontSize",
           options.fontSize
@@ -2799,7 +2799,7 @@ var Axes = class {
     }
     if (options.padding !== void 0) {
       if (!Number.isFinite(options.padding) || options.padding < 0) {
-        throw new chunkJSCDE774_cjs.InvalidParameterError(
+        throw new chunkZ6BGACIH_cjs.InvalidParameterError(
           `legend padding must be non-negative; received ${options.padding}`,
           "padding",
           options.padding
@@ -3001,7 +3001,7 @@ var Axes = class {
   buildTickOverride(values, labels, name) {
     if (values.length === 0) return null;
     if (labels && labels.length !== values.length) {
-      throw new chunkJSCDE774_cjs.InvalidParameterError(
+      throw new chunkZ6BGACIH_cjs.InvalidParameterError(
         `${name} labels length must match values length (${values.length}); received ${labels.length}`,
         name,
         labels
@@ -3010,7 +3010,7 @@ var Axes = class {
     const ticks = [];
     for (const [i, value] of values.entries()) {
       if (!Number.isFinite(value)) {
-        throw new chunkJSCDE774_cjs.InvalidParameterError(`${name} values must be finite`, name, value);
+        throw new chunkZ6BGACIH_cjs.InvalidParameterError(`${name} values must be finite`, name, value);
       }
       const label = labels ? labels[i] ?? "" : String(value);
       ticks.push({ value, label: label.trim() });
@@ -3680,7 +3680,7 @@ async function pngEncodeRGBA(width, height, rgba) {
   assertPositiveInt("width", width);
   assertPositiveInt("height", height);
   if (rgba.length !== width * height * 4)
-    throw new chunkJSCDE774_cjs.InvalidParameterError("RGBA buffer has incorrect length", "rgba", rgba.length);
+    throw new chunkZ6BGACIH_cjs.InvalidParameterError("RGBA buffer has incorrect length", "rgba", rgba.length);
   const signature = Uint8Array.of(137, 80, 78, 71, 13, 10, 26, 10);
   const ihdrData = concatBytes([u32be(width), u32be(height), Uint8Array.of(8, 6, 0, 0, 0)]);
   const ihdr = pngChunk("IHDR", ihdrData);
@@ -3722,7 +3722,7 @@ var Figure = class {
     assertPositiveInt("Figure.width", this.width);
     assertPositiveInt("Figure.height", this.height);
     if (this.width > 32768 || this.height > 32768) {
-      throw new chunkJSCDE774_cjs.InvalidParameterError(
+      throw new chunkZ6BGACIH_cjs.InvalidParameterError(
         "Figure dimensions too large. Maximum is 32,768 pixels.",
         "width/height",
         { width: this.width, height: this.height }
@@ -3763,7 +3763,7 @@ ${elements.join("\n")}
    */
   async renderPNG() {
     if (!isNodeEnvironment_export()) {
-      throw new chunkJSCDE774_cjs.NotImplementedError(
+      throw new chunkZ6BGACIH_cjs.NotImplementedError(
         "PNG rendering is only available in Node.js environments. Use renderSVG() for browser compatibility, or run in Node.js to generate PNG files."
       );
     }
@@ -3811,14 +3811,14 @@ function figure(options = {}) {
 }
 function subplot(rows, cols, index, options = {}) {
   if (!Number.isFinite(rows) || Math.trunc(rows) !== rows || rows <= 0) {
-    throw new chunkJSCDE774_cjs.InvalidParameterError(
+    throw new chunkZ6BGACIH_cjs.InvalidParameterError(
       `rows must be a positive integer; received ${rows}`,
       "rows",
       rows
     );
   }
   if (!Number.isFinite(cols) || Math.trunc(cols) !== cols || cols <= 0) {
-    throw new chunkJSCDE774_cjs.InvalidParameterError(
+    throw new chunkZ6BGACIH_cjs.InvalidParameterError(
       `cols must be a positive integer; received ${cols}`,
       "cols",
       cols
@@ -3826,14 +3826,14 @@ function subplot(rows, cols, index, options = {}) {
   }
   const total = rows * cols;
   if (total > 1e4) {
-    throw new chunkJSCDE774_cjs.InvalidParameterError(
+    throw new chunkZ6BGACIH_cjs.InvalidParameterError(
       `Subplot grid too large (${rows}\xD7${cols}=${total}). Maximum is 10,000 subplots.`,
       "rows*cols",
       total
     );
   }
   if (!Number.isFinite(index) || Math.trunc(index) !== index || index < 1 || index > total) {
-    throw new chunkJSCDE774_cjs.InvalidParameterError(
+    throw new chunkZ6BGACIH_cjs.InvalidParameterError(
       `index must be in [1, ${total}]; received ${index}`,
       "index",
       index
@@ -3864,13 +3864,13 @@ function show(options = {}) {
 }
 async function saveFig(path, options = {}) {
   if (!path || path.trim().length === 0) {
-    throw new chunkJSCDE774_cjs.InvalidParameterError("path must be a non-empty string", "path", path);
+    throw new chunkZ6BGACIH_cjs.InvalidParameterError("path must be a non-empty string", "path", path);
   }
   const dotIndex = path.lastIndexOf(".");
   const ext = dotIndex > 0 ? path.slice(dotIndex + 1).toLowerCase() : void 0;
   const fmt = options.format ?? (ext === "png" ? "png" : "svg");
   if (ext && ext !== fmt) {
-    throw new chunkJSCDE774_cjs.InvalidParameterError(
+    throw new chunkZ6BGACIH_cjs.InvalidParameterError(
       `File extension .${ext} does not match format ${fmt}`,
       "path",
       path
@@ -3899,8 +3899,17 @@ function bar(x, height, options = {}) {
 function barh(y, width, options = {}) {
   gca().barh(y, width, options);
 }
-function hist(x, bins = 10, options = {}) {
-  gca().hist(x, bins, options);
+function hist(x, bins, options = {}) {
+  let resolvedBins = 10;
+  let resolvedOptions = options;
+  if (typeof bins === "object" && bins !== null) {
+    resolvedBins = bins.bins ?? 10;
+    const { bins: _b, ...rest } = bins;
+    resolvedOptions = rest;
+  } else if (typeof bins === "number") {
+    resolvedBins = bins;
+  }
+  gca().hist(x, resolvedBins, resolvedOptions);
 }
 function boxplot(data, options = {}) {
   gca().boxplot(data, options);
@@ -3936,7 +3945,7 @@ function plotConfusionMatrix(cm, labels, options = {}) {
     ax.setXLabel("Predicted");
     ax.setYLabel("Actual");
     if (labels && labels.length < Math.max(rows, cols)) {
-      throw new chunkJSCDE774_cjs.InvalidParameterError(
+      throw new chunkZ6BGACIH_cjs.InvalidParameterError(
         `labels length must be >= ${Math.max(rows, cols)}; received ${labels.length}`,
         "labels",
         labels
@@ -3959,7 +3968,7 @@ function plotRocCurve(fpr, tpr, auc, options = {}) {
     color: options.color ?? "#1f77b4",
     label: options.label ?? "ROC"
   });
-  ax.plot(chunk6AE5FKKQ_cjs.tensor([0, 1]), chunk6AE5FKKQ_cjs.tensor([0, 1]), {
+  ax.plot(chunk724CXHFH_cjs.tensor([0, 1]), chunk724CXHFH_cjs.tensor([0, 1]), {
     color: "#999999",
     linewidth: 1,
     label: "Chance"
@@ -4021,17 +4030,17 @@ function plotValidationCurve(paramRange, trainScores, valScores, options = {}) {
 }
 function plotDecisionBoundary(X, y, model, options = {}) {
   if (X.dtype === "string") {
-    throw new chunkJSCDE774_cjs.InvalidParameterError("plotDecisionBoundary: X must be numeric", "X", X.dtype);
+    throw new chunkZ6BGACIH_cjs.InvalidParameterError("plotDecisionBoundary: X must be numeric", "X", X.dtype);
   }
   if (X.ndim !== 2 || (X.shape[1] ?? 0) !== 2) {
-    throw new chunkJSCDE774_cjs.ShapeError("plotDecisionBoundary: X must be shape [n, 2]");
+    throw new chunkZ6BGACIH_cjs.ShapeError("plotDecisionBoundary: X must be shape [n, 2]");
   }
   const n = X.shape[0] ?? 0;
   if (n === 0) {
-    throw new chunkJSCDE774_cjs.InvalidParameterError("plotDecisionBoundary: X must have at least one row", "X", n);
+    throw new chunkZ6BGACIH_cjs.InvalidParameterError("plotDecisionBoundary: X must have at least one row", "X", n);
   }
   if (y.ndim !== 1 || (y.shape[0] ?? -1) !== n) {
-    throw new chunkJSCDE774_cjs.ShapeError("plotDecisionBoundary: y must be shape [n]");
+    throw new chunkZ6BGACIH_cjs.ShapeError("plotDecisionBoundary: y must be shape [n]");
   }
   const { data: xData } = tensorToFloat64Matrix2D(X);
   const x0 = new Float64Array(n);
@@ -4040,7 +4049,7 @@ function plotDecisionBoundary(X, y, model, options = {}) {
     const vx = xData[i * 2] ?? NaN;
     const vy = xData[i * 2 + 1] ?? NaN;
     if (!Number.isFinite(vx) || !Number.isFinite(vy)) {
-      throw new chunkJSCDE774_cjs.InvalidParameterError("plotDecisionBoundary: X must be finite", "X", {
+      throw new chunkZ6BGACIH_cjs.InvalidParameterError("plotDecisionBoundary: X must be finite", "X", {
         index: i,
         x: vx,
         y: vy
@@ -4054,17 +4063,17 @@ function plotDecisionBoundary(X, y, model, options = {}) {
     if (typeof value === "string") return value;
     if (typeof value === "number") {
       if (!Number.isFinite(value)) {
-        throw new chunkJSCDE774_cjs.InvalidParameterError("plotDecisionBoundary: invalid label value", "y", value);
+        throw new chunkZ6BGACIH_cjs.InvalidParameterError("plotDecisionBoundary: invalid label value", "y", value);
       }
       return value;
     }
     if (typeof value === "bigint") return value;
-    throw new chunkJSCDE774_cjs.InvalidParameterError("plotDecisionBoundary: invalid label value", "y", value);
+    throw new chunkZ6BGACIH_cjs.InvalidParameterError("plotDecisionBoundary: invalid label value", "y", value);
   };
   const toFiniteNumber = (value) => {
     if (typeof value === "number") {
       if (!Number.isFinite(value)) {
-        throw new chunkJSCDE774_cjs.InvalidParameterError(
+        throw new chunkZ6BGACIH_cjs.InvalidParameterError(
           "plotDecisionBoundary: model.predict must return finite numeric scores",
           "predict",
           value
@@ -4075,7 +4084,7 @@ function plotDecisionBoundary(X, y, model, options = {}) {
     if (typeof value === "bigint") {
       const n2 = Number(value);
       if (!Number.isFinite(n2)) {
-        throw new chunkJSCDE774_cjs.InvalidParameterError(
+        throw new chunkZ6BGACIH_cjs.InvalidParameterError(
           "plotDecisionBoundary: model.predict must return finite numeric scores",
           "predict",
           value
@@ -4083,7 +4092,7 @@ function plotDecisionBoundary(X, y, model, options = {}) {
       }
       return n2;
     }
-    throw new chunkJSCDE774_cjs.InvalidParameterError(
+    throw new chunkZ6BGACIH_cjs.InvalidParameterError(
       "plotDecisionBoundary: model.predict must return numeric scores",
       "predict",
       value
@@ -4120,12 +4129,12 @@ function plotDecisionBoundary(X, y, model, options = {}) {
       gridFlat[idx + 1] = fy;
     }
   }
-  const gridTensor = chunk6AE5FKKQ_cjs.tensor(gridFlat).reshape([gridCount, 2]);
+  const gridTensor = chunk724CXHFH_cjs.tensor(gridFlat).reshape([gridCount, 2]);
   const predictions = model.predict(gridTensor);
   const predictedLabels = new Array(gridCount);
   if (predictions.ndim === 1) {
     if ((predictions.shape[0] ?? -1) !== gridCount) {
-      throw new chunkJSCDE774_cjs.ShapeError("plotDecisionBoundary: model.predict must return [gridSize] labels");
+      throw new chunkZ6BGACIH_cjs.ShapeError("plotDecisionBoundary: model.predict must return [gridSize] labels");
     }
     for (let i = 0; i < gridCount; i++) {
       predictedLabels[i] = readLabel(predictions, i);
@@ -4134,7 +4143,7 @@ function plotDecisionBoundary(X, y, model, options = {}) {
     const rows = predictions.shape[0] ?? -1;
     const cols = predictions.shape[1] ?? -1;
     if (rows !== gridCount || cols <= 0) {
-      throw new chunkJSCDE774_cjs.ShapeError("plotDecisionBoundary: model.predict must return [gridSize, k]");
+      throw new chunkZ6BGACIH_cjs.ShapeError("plotDecisionBoundary: model.predict must return [gridSize, k]");
     }
     for (let i = 0; i < rows; i++) {
       let bestCol = 0;
@@ -4149,7 +4158,7 @@ function plotDecisionBoundary(X, y, model, options = {}) {
       predictedLabels[i] = bestCol;
     }
   } else {
-    throw new chunkJSCDE774_cjs.ShapeError("plotDecisionBoundary: model.predict output must be 1D or 2D");
+    throw new chunkZ6BGACIH_cjs.ShapeError("plotDecisionBoundary: model.predict output must be 1D or 2D");
   }
   const classIndex = /* @__PURE__ */ new Map();
   const classValues = [];
@@ -4175,7 +4184,7 @@ function plotDecisionBoundary(X, y, model, options = {}) {
   for (let gy = 0; gy < gridResolution; gy++) {
     const row = boundaryMatrix[gy];
     if (!row) {
-      throw new chunkJSCDE774_cjs.InvalidParameterError("plotDecisionBoundary: grid row access failed", "gy", gy);
+      throw new chunkZ6BGACIH_cjs.InvalidParameterError("plotDecisionBoundary: grid row access failed", "gy", gy);
     }
     for (let gx = 0; gx < gridResolution; gx++) {
       const label = predictedLabels[gy * gridResolution + gx];
@@ -4184,7 +4193,7 @@ function plotDecisionBoundary(X, y, model, options = {}) {
     }
   }
   const ax = gca();
-  ax.imshow(chunk6AE5FKKQ_cjs.tensor(boundaryMatrix), {
+  ax.imshow(chunk724CXHFH_cjs.tensor(boundaryMatrix), {
     colormap: options.colormap ?? "grayscale",
     vmin: options.vmin ?? 0,
     vmax: options.vmax ?? Math.max(1, classValues.length - 1),
@@ -4221,7 +4230,7 @@ function plotDecisionBoundary(X, y, model, options = {}) {
   }
   for (const group of byClass.values()) {
     const color = classColors[group.index % classColors.length] ?? "#000000";
-    ax.scatter(chunk6AE5FKKQ_cjs.tensor(group.x), chunk6AE5FKKQ_cjs.tensor(group.y), {
+    ax.scatter(chunk724CXHFH_cjs.tensor(group.x), chunk724CXHFH_cjs.tensor(group.y), {
       color,
       size: options.size ?? 4,
       label: group.label
@@ -4259,5 +4268,5 @@ exports.scatter = scatter;
 exports.show = show;
 exports.subplot = subplot;
 exports.violinplot = violinplot;
-//# sourceMappingURL=chunk-ALS7ETWZ.cjs.map
-//# sourceMappingURL=chunk-ALS7ETWZ.cjs.map
+//# sourceMappingURL=chunk-HI2EZHCJ.cjs.map
+//# sourceMappingURL=chunk-HI2EZHCJ.cjs.map