resolvcharts 0.2.0 → 0.3.0

package/dist/index.d.cts

@@ -209,24 +209,35 @@ interface ChartOptions {
   maxPoints?: number;
   /**
    * Render backend for xy series (line/area/sparkline/scatter). `"canvas"`
-   * (default) uses Canvas2D. `"webgpu"` rasterizes series on the GPU —
-   * instanced lines and point sprites — while axes, grid, and tooltips stay
-   * on Canvas2D. `"auto"` uses WebGPU when available, else Canvas2D.
+   * uses Canvas2D. `"webgpu"` rasterizes series on the GPU — instanced
+   * lines, point sprites, compute decimation — while axes, grid, and
+   * tooltips stay on Canvas2D. `"auto"` (default) engages WebGPU once the
+   * point count crosses `gpuThreshold`, else Canvas2D.
    * Unknown to older browsers → silent fallback to Canvas2D.
    */
   renderer?: "auto" | "canvas" | "webgpu";
+  /**
+   * For `renderer: "auto"`: total visible xy points (x-length × series) at
+   * which the GPU path engages. Below this, Canvas2D is faster. Once the
+   * GPU attaches it stays attached for the chart's lifetime.
+   * Default: 100,000.
+   */
+  gpuThreshold?: number;
   /**
    * WebGPU adapter options — only used when `renderer` resolves to WebGPU.
    * `powerPreference` picks the discrete GPU on dual-GPU systems;
    * `compat` requests compatibility mode (GLES 3.1 / D3D11 reach);
    * `timing` enables GPU-side pass timing via "timestamp-query" when the
-   * adapter supports it (note: browsers quantize to ~100 µs unless the
-   * WebGPU developer-features flag is enabled).
+   * adapter supports it (note: browsers require cross-origin isolation and
+   * quantize to ~100 µs — dev/profiling use only);
+   * `allowFallback` accepts software adapters like SwiftShader (off by
+   * default — usually slower than Canvas2D).
    */
   gpu?: {
     powerPreference?: "default" | "low-power" | "high-performance";
     compat?: boolean;
     timing?: boolean;
+    allowFallback?: boolean;
   };
   /**
    * Canvas2D context settings passed to `getContext("2d", …)` for all layers.
@@ -247,6 +258,14 @@ interface ChartOptions {
     x?: (v: number) => string;
     y?: (v: number) => string;
   };
+  /**
+   * Pin the y-axis domain. Each bound overrides the auto-fitted value —
+   * unset ends still auto-fit. E.g. `{ yMin: 0, yMax: 100 }` frames a
+   * utilization chart honestly; `{ yMin: 0 }` zero-anchors without a
+   * ceiling. Values exceeding the bounds are clipped at the plot edge.
+   */
+  yMin?: number;
+  yMax?: number;
   /** Called on pointer hover with the nearest hit, or `null` on leave. */
   onHover?: (info: HoverInfo | null) => void;
 }
@@ -294,23 +313,37 @@ export declare class Chart {
   private destroyed;
   private pendingView;
   private gpu;
+  private gpuInit;
+  /** bumped whenever xy data is replaced or reordered — triggers GPU re-upload */
+  private dataRev;
   private lastAppendAt;
   private estInterval;
   private onScroll;
   private frame;
   constructor(el: HTMLElement, options: ChartOptions);
+  /**
+   * Lazily acquire the WebGPU backend. `"webgpu"` attaches unconditionally;
+   * `"auto"` waits until the xy point count crosses `gpuThreshold` — small
+   * charts never pay adapter/device acquisition.
+   */
+  private maybeInitGpu;
   private normalize;
   private bindEvents;
   private onMove;
   private onLeave;
   private layout;
   private domains;
+  private yDomain;
   private lerpView;
   private makeScales;
   private renderContext;
   private drawStatic;
   private render;
-  /** series rasterization on the GPU; grid/labels/hover stay on Canvas2D */
+  /**
+   * Series rasterization on the GPU; grid/labels/hover stay on Canvas2D.
+   * Raw data lives in GPU buffers — the per-frame cost is uniform writes +
+   * instanced draws, with compute decimation above the density threshold.
+   */
   private gpuRender;
   private drawHover;
   private applyHover;
@@ -387,6 +420,9 @@ export declare function extent(values: ArrayLike<number>): [number, number];
 /** @category Utilities
  * Pad a domain by 5% on each end; `includeZero` anchors the axis at 0. */
 export declare function padDomain(min: number, max: number, includeZero?: boolean): [number, number];
+/** @category Utilities
+ * Pin domain ends — each defined bound overrides the fitted value. */
+export declare function boundDomain(dom: [number, number], min?: number, max?: number): [number, number];
 //#endregion
 //#region src/core/theme.d.ts
 /** Built-in light theme.

package/dist/index.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.cts","names":[],"sources":["../src/core/types.ts","../src/core/chart.ts","../src/core/decimate.ts","../src/core/format.ts","../src/core/hit.ts","../src/core/scales.ts","../src/core/theme.ts","../src/core/ticks.ts"],"mappings":";;;;;KAIY;;;;;UAiBK;EACf;EACA;EACA;EACA;EACA;EACA;EACA;EACA;;EAEA;;EAEA;EACA;EACA;EACA;EACA;EACA;EACA;;;;;;UAOe;EACf;EACA;EACA,GAAG;;;;;UAMY;EACf,GAAG;EACH,QAAQ;;;;;;KAOE;;;;;UAMK;EACf;EACA;;EAEA,OAAO;EACP,QAAQ;;;;;;UAOO;EACf;EACA,QAAQ;;;;;;UAOO;EACf;EACA;EACA;;;;;;UAOe;EACf,QAAQ;;;;;;UAOO;EACf;EACA;EACA;EACA;EACA;EACA;;;;;;UAOe;EACf,SAAS;;;;;;UAOM;EACf;;EAEA,QAAQ;;EAER;;;;;KAMU,YACR,SACA,eACA,YACA,WACA;;;;;KAMQ;;;;;KAMA;EAEN;EACA;EACA;EACA;EACA;EACA;IAAU;IAAe;IAAe;;;EAExC;;EAGA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA,MAAM;;EAGN;EACA;EACA;EACA;EACA;EACA;EACA;EACA;;EAGA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;;;;;;UAOW;EACf,MAAM;EACN,MAAM;EACN,2BAA2B,QAAQ;;EAEnC;EACA,QAAQ;EACR;EACA;EACA;;EAEA;;;;;;;;EAQA;;;;;;EAMA;;;;;;;EAOA;;;;;;;;EASA;;;;;;;;;EASA;IACE;IACA;IACA;;;;;;;;;EASF,SAAS;;EAET;;EAEA;;EAEA;;EAEA;IACE,KAAK;IACL,KAAK;;;EAGP,WAAW,MAAM;;;;;UAMF;EACf;EACA;EACA;EACA;;;;;UAMe;GACd;EACD,OAAO;EACP;EACA;;;;;;;qBCnLW;WACF,IAAI;WACJ,SAAS;UACV;UACA;UACA;UACA;UACA;UACA;UACA;UACA;UACA;UACA;UACA;UACA;UAIA;UACA;UAIA;UACA;UACA;UACA;UACA;UACA;UACA;UAGA;EAkCR,YAAY,IAAI,aAAa,SAAS;UA6C9B;UAmIA;UAUA;UASA;UAUA;UAkCA;UAoGA;UAiBA;UAmBA;UAeA;UA8EA;;UAUA;UA0CA;UA8DA;UA4DA;UAaA;;EAcR,QAAQ,MAAM;;;;;;EAYd,OAAO,WAAW;;EAoFlB;;EAoBA;;;;;;;;;;;;;;;;;;wBAmDc,YAAY,IAAI,aAAa,SAAS,eAAe;;;;;;;;;;;;;;wBC9zBrD,WACd,IAAI,mBACJ,IAAI,mBACJ,qBACC;;;;;wBCpMa,aAAa;;;wBAcb,SAAS;;;;;;;;wBCXT,aAAa,IAAI,mBAAmB;;;;;wBCDpC,YACd,YACA,YACA,YACA,aACC;;;wBAYa,OAAO,QAAQ;;;wBAkBf,UACd,aACA,aACA;;;;;;qBCnCW,YAAY;;;;qBAsBZ,WAAW;;;;wBAmCR,aACd,KAAK,uBACL,6BACC;;;;;;wBC/Ca,aAAa,aAAa,aAAa"}
+{"version":3,"file":"index.d.cts","names":[],"sources":["../src/core/types.ts","../src/core/chart.ts","../src/core/decimate.ts","../src/core/format.ts","../src/core/hit.ts","../src/core/scales.ts","../src/core/theme.ts","../src/core/ticks.ts"],"mappings":";;;;;KAIY;;;;;UAiBK;EACf;EACA;EACA;EACA;EACA;EACA;EACA;EACA;;EAEA;;EAEA;EACA;EACA;EACA;EACA;EACA;EACA;;;;;;UAOe;EACf;EACA;EACA,GAAG;;;;;UAMY;EACf,GAAG;EACH,QAAQ;;;;;;KAOE;;;;;UAMK;EACf;EACA;;EAEA,OAAO;EACP,QAAQ;;;;;;UAOO;EACf;EACA,QAAQ;;;;;;UAOO;EACf;EACA;EACA;;;;;;UAOe;EACf,QAAQ;;;;;;UAOO;EACf;EACA;EACA;EACA;EACA;EACA;;;;;;UAOe;EACf,SAAS;;;;;;UAOM;EACf;;EAEA,QAAQ;;EAER;;;;;KAMU,YACR,SACA,eACA,YACA,WACA;;;;;KAMQ;;;;;KAMA;EAEN;EACA;EACA;EACA;EACA;EACA;IAAU;IAAe;IAAe;;;EAExC;;EAGA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA,MAAM;;EAGN;EACA;EACA;EACA;EACA;EACA;EACA;EACA;;EAGA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;;;;;;UAOW;EACf,MAAM;EACN,MAAM;EACN,2BAA2B,QAAQ;;EAEnC;EACA,QAAQ;EACR;EACA;EACA;;EAEA;;;;;;;;EAQA;;;;;;EAMA;;;;;;;EAOA;;;;;;;;;EAUA;;;;;;;EAOA;;;;;;;;;;;EAWA;IACE;IACA;IACA;IACA;;;;;;;;;EASF,SAAS;;EAET;;EAEA;;EAEA;;EAEA;IACE,KAAK;IACL,KAAK;;;;;;;;EAQP;EACA;;EAEA,WAAW,MAAM;;;;;UAMF;EACf;EACA;EACA;EACA;;;;;UAMe;GACd;EACD,OAAO;EACP;EACA;;;;;;;qBCrMW;WACF,IAAI;WACJ,SAAS;UACV;UACA;UACA;UACA;UACA;UACA;UACA;UACA;UACA;UACA;UACA;UACA;UAIA;UACA;UAIA;UACA;UACA;UACA;UACA;;UAEA;UACA;UACA;UACA;UAGA;EAkCR,YAAY,IAAI,aAAa,SAAS;;;;;;UA8B9B;UA8BA;UAmIA;UAUA;UASA;UAUA;UAkCA;UA0GA;UAIA;UAiBA;UAmBA;UAeA;UA8EA;;;;;;UAcA;UAiCA;UA8DA;UA4DA;UAaA;;EAcR,QAAQ,MAAM;;;;;;EAcd,OAAO,WAAW;;EAoGlB;;EAoBA;;;;;;;;;;;;;;;;;;wBAmDc,YAAY,IAAI,aAAa,SAAS,eAAe;;;;;;;;;;;;;;wBCx2BrD,WACd,IAAI,mBACJ,IAAI,mBACJ,qBACC;;;;;wBCpMa,aAAa;;;wBAcb,SAAS;;;;;;;;wBCXT,aAAa,IAAI,mBAAmB;;;;;wBCDpC,YACd,YACA,YACA,YACA,aACC;;;wBAYa,OAAO,QAAQ;;;wBAkBf,UACd,aACA,aACA;;;wBAoBc,YACd,uBACA,cACA;;;;;;qBC1DW,YAAY;;;;qBAsBZ,WAAW;;;;wBAmCR,aACd,KAAK,uBACL,6BACC;;;;;;wBC/Ca,aAAa,aAAa,aAAa"}

package/dist/index.d.mts

@@ -209,24 +209,35 @@ interface ChartOptions {
   maxPoints?: number;
   /**
    * Render backend for xy series (line/area/sparkline/scatter). `"canvas"`
-   * (default) uses Canvas2D. `"webgpu"` rasterizes series on the GPU —
-   * instanced lines and point sprites — while axes, grid, and tooltips stay
-   * on Canvas2D. `"auto"` uses WebGPU when available, else Canvas2D.
+   * uses Canvas2D. `"webgpu"` rasterizes series on the GPU — instanced
+   * lines, point sprites, compute decimation — while axes, grid, and
+   * tooltips stay on Canvas2D. `"auto"` (default) engages WebGPU once the
+   * point count crosses `gpuThreshold`, else Canvas2D.
    * Unknown to older browsers → silent fallback to Canvas2D.
    */
   renderer?: "auto" | "canvas" | "webgpu";
+  /**
+   * For `renderer: "auto"`: total visible xy points (x-length × series) at
+   * which the GPU path engages. Below this, Canvas2D is faster. Once the
+   * GPU attaches it stays attached for the chart's lifetime.
+   * Default: 100,000.
+   */
+  gpuThreshold?: number;
   /**
    * WebGPU adapter options — only used when `renderer` resolves to WebGPU.
    * `powerPreference` picks the discrete GPU on dual-GPU systems;
    * `compat` requests compatibility mode (GLES 3.1 / D3D11 reach);
    * `timing` enables GPU-side pass timing via "timestamp-query" when the
-   * adapter supports it (note: browsers quantize to ~100 µs unless the
-   * WebGPU developer-features flag is enabled).
+   * adapter supports it (note: browsers require cross-origin isolation and
+   * quantize to ~100 µs — dev/profiling use only);
+   * `allowFallback` accepts software adapters like SwiftShader (off by
+   * default — usually slower than Canvas2D).
    */
   gpu?: {
     powerPreference?: "default" | "low-power" | "high-performance";
     compat?: boolean;
     timing?: boolean;
+    allowFallback?: boolean;
   };
   /**
    * Canvas2D context settings passed to `getContext("2d", …)` for all layers.
@@ -247,6 +258,14 @@ interface ChartOptions {
     x?: (v: number) => string;
     y?: (v: number) => string;
   };
+  /**
+   * Pin the y-axis domain. Each bound overrides the auto-fitted value —
+   * unset ends still auto-fit. E.g. `{ yMin: 0, yMax: 100 }` frames a
+   * utilization chart honestly; `{ yMin: 0 }` zero-anchors without a
+   * ceiling. Values exceeding the bounds are clipped at the plot edge.
+   */
+  yMin?: number;
+  yMax?: number;
   /** Called on pointer hover with the nearest hit, or `null` on leave. */
   onHover?: (info: HoverInfo | null) => void;
 }
@@ -294,23 +313,37 @@ export declare class Chart {
   private destroyed;
   private pendingView;
   private gpu;
+  private gpuInit;
+  /** bumped whenever xy data is replaced or reordered — triggers GPU re-upload */
+  private dataRev;
   private lastAppendAt;
   private estInterval;
   private onScroll;
   private frame;
   constructor(el: HTMLElement, options: ChartOptions);
+  /**
+   * Lazily acquire the WebGPU backend. `"webgpu"` attaches unconditionally;
+   * `"auto"` waits until the xy point count crosses `gpuThreshold` — small
+   * charts never pay adapter/device acquisition.
+   */
+  private maybeInitGpu;
   private normalize;
   private bindEvents;
   private onMove;
   private onLeave;
   private layout;
   private domains;
+  private yDomain;
   private lerpView;
   private makeScales;
   private renderContext;
   private drawStatic;
   private render;
-  /** series rasterization on the GPU; grid/labels/hover stay on Canvas2D */
+  /**
+   * Series rasterization on the GPU; grid/labels/hover stay on Canvas2D.
+   * Raw data lives in GPU buffers — the per-frame cost is uniform writes +
+   * instanced draws, with compute decimation above the density threshold.
+   */
   private gpuRender;
   private drawHover;
   private applyHover;
@@ -387,6 +420,9 @@ export declare function extent(values: ArrayLike<number>): [number, number];
 /** @category Utilities
  * Pad a domain by 5% on each end; `includeZero` anchors the axis at 0. */
 export declare function padDomain(min: number, max: number, includeZero?: boolean): [number, number];
+/** @category Utilities
+ * Pin domain ends — each defined bound overrides the fitted value. */
+export declare function boundDomain(dom: [number, number], min?: number, max?: number): [number, number];
 //#endregion
 //#region src/core/theme.d.ts
 /** Built-in light theme.

package/dist/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../src/core/types.ts","../src/core/chart.ts","../src/core/decimate.ts","../src/core/format.ts","../src/core/hit.ts","../src/core/scales.ts","../src/core/theme.ts","../src/core/ticks.ts"],"mappings":";;;;;KAIY;;;;;UAiBK;EACf;EACA;EACA;EACA;EACA;EACA;EACA;EACA;;EAEA;;EAEA;EACA;EACA;EACA;EACA;EACA;EACA;;;;;;UAOe;EACf;EACA;EACA,GAAG;;;;;UAMY;EACf,GAAG;EACH,QAAQ;;;;;;KAOE;;;;;UAMK;EACf;EACA;;EAEA,OAAO;EACP,QAAQ;;;;;;UAOO;EACf;EACA,QAAQ;;;;;;UAOO;EACf;EACA;EACA;;;;;;UAOe;EACf,QAAQ;;;;;;UAOO;EACf;EACA;EACA;EACA;EACA;EACA;;;;;;UAOe;EACf,SAAS;;;;;;UAOM;EACf;;EAEA,QAAQ;;EAER;;;;;KAMU,YACR,SACA,eACA,YACA,WACA;;;;;KAMQ;;;;;KAMA;EAEN;EACA;EACA;EACA;EACA;EACA;IAAU;IAAe;IAAe;;;EAExC;;EAGA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA,MAAM;;EAGN;EACA;EACA;EACA;EACA;EACA;EACA;EACA;;EAGA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;;;;;;UAOW;EACf,MAAM;EACN,MAAM;EACN,2BAA2B,QAAQ;;EAEnC;EACA,QAAQ;EACR;EACA;EACA;;EAEA;;;;;;;;EAQA;;;;;;EAMA;;;;;;;EAOA;;;;;;;;EASA;;;;;;;;;EASA;IACE;IACA;IACA;;;;;;;;;EASF,SAAS;;EAET;;EAEA;;EAEA;;EAEA;IACE,KAAK;IACL,KAAK;;;EAGP,WAAW,MAAM;;;;;UAMF;EACf;EACA;EACA;EACA;;;;;UAMe;GACd;EACD,OAAO;EACP;EACA;;;;;;;qBCnLW;WACF,IAAI;WACJ,SAAS;UACV;UACA;UACA;UACA;UACA;UACA;UACA;UACA;UACA;UACA;UACA;UACA;UAIA;UACA;UAIA;UACA;UACA;UACA;UACA;UACA;UACA;UAGA;EAkCR,YAAY,IAAI,aAAa,SAAS;UA6C9B;UAmIA;UAUA;UASA;UAUA;UAkCA;UAoGA;UAiBA;UAmBA;UAeA;UA8EA;;UAUA;UA0CA;UA8DA;UA4DA;UAaA;;EAcR,QAAQ,MAAM;;;;;;EAYd,OAAO,WAAW;;EAoFlB;;EAoBA;;;;;;;;;;;;;;;;;;wBAmDc,YAAY,IAAI,aAAa,SAAS,eAAe;;;;;;;;;;;;;;wBC9zBrD,WACd,IAAI,mBACJ,IAAI,mBACJ,qBACC;;;;;wBCpMa,aAAa;;;wBAcb,SAAS;;;;;;;;wBCXT,aAAa,IAAI,mBAAmB;;;;;wBCDpC,YACd,YACA,YACA,YACA,aACC;;;wBAYa,OAAO,QAAQ;;;wBAkBf,UACd,aACA,aACA;;;;;;qBCnCW,YAAY;;;;qBAsBZ,WAAW;;;;wBAmCR,aACd,KAAK,uBACL,6BACC;;;;;;wBC/Ca,aAAa,aAAa,aAAa"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/core/types.ts","../src/core/chart.ts","../src/core/decimate.ts","../src/core/format.ts","../src/core/hit.ts","../src/core/scales.ts","../src/core/theme.ts","../src/core/ticks.ts"],"mappings":";;;;;KAIY;;;;;UAiBK;EACf;EACA;EACA;EACA;EACA;EACA;EACA;EACA;;EAEA;;EAEA;EACA;EACA;EACA;EACA;EACA;EACA;;;;;;UAOe;EACf;EACA;EACA,GAAG;;;;;UAMY;EACf,GAAG;EACH,QAAQ;;;;;;KAOE;;;;;UAMK;EACf;EACA;;EAEA,OAAO;EACP,QAAQ;;;;;;UAOO;EACf;EACA,QAAQ;;;;;;UAOO;EACf;EACA;EACA;;;;;;UAOe;EACf,QAAQ;;;;;;UAOO;EACf;EACA;EACA;EACA;EACA;EACA;;;;;;UAOe;EACf,SAAS;;;;;;UAOM;EACf;;EAEA,QAAQ;;EAER;;;;;KAMU,YACR,SACA,eACA,YACA,WACA;;;;;KAMQ;;;;;KAMA;EAEN;EACA;EACA;EACA;EACA;EACA;IAAU;IAAe;IAAe;;;EAExC;;EAGA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA,MAAM;;EAGN;EACA;EACA;EACA;EACA;EACA;EACA;EACA;;EAGA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;;;;;;UAOW;EACf,MAAM;EACN,MAAM;EACN,2BAA2B,QAAQ;;EAEnC;EACA,QAAQ;EACR;EACA;EACA;;EAEA;;;;;;;;EAQA;;;;;;EAMA;;;;;;;EAOA;;;;;;;;;EAUA;;;;;;;EAOA;;;;;;;;;;;EAWA;IACE;IACA;IACA;IACA;;;;;;;;;EASF,SAAS;;EAET;;EAEA;;EAEA;;EAEA;IACE,KAAK;IACL,KAAK;;;;;;;;EAQP;EACA;;EAEA,WAAW,MAAM;;;;;UAMF;EACf;EACA;EACA;EACA;;;;;UAMe;GACd;EACD,OAAO;EACP;EACA;;;;;;;qBCrMW;WACF,IAAI;WACJ,SAAS;UACV;UACA;UACA;UACA;UACA;UACA;UACA;UACA;UACA;UACA;UACA;UACA;UAIA;UACA;UAIA;UACA;UACA;UACA;UACA;;UAEA;UACA;UACA;UACA;UAGA;EAkCR,YAAY,IAAI,aAAa,SAAS;;;;;;UA8B9B;UA8BA;UAmIA;UAUA;UASA;UAUA;UAkCA;UA0GA;UAIA;UAiBA;UAmBA;UAeA;UA8EA;;;;;;UAcA;UAiCA;UA8DA;UA4DA;UAaA;;EAcR,QAAQ,MAAM;;;;;;EAcd,OAAO,WAAW;;EAoGlB;;EAoBA;;;;;;;;;;;;;;;;;;wBAmDc,YAAY,IAAI,aAAa,SAAS,eAAe;;;;;;;;;;;;;;wBCx2BrD,WACd,IAAI,mBACJ,IAAI,mBACJ,qBACC;;;;;wBCpMa,aAAa;;;wBAcb,SAAS;;;;;;;;wBCXT,aAAa,IAAI,mBAAmB;;;;;wBCDpC,YACd,YACA,YACA,YACA,aACC;;;wBAYa,OAAO,QAAQ;;;wBAkBf,UACd,aACA,aACA;;;wBAoBc,YACd,uBACA,cACA;;;;;;qBC1DW,YAAY;;;;qBAsBZ,WAAW;;;;wBAmCR,aACd,KAAK,uBACL,6BACC;;;;;;wBC/Ca,aAAa,aAAa,aAAa"}

package/dist/index.mjs

@@ -1380,6 +1380,11 @@ function padDomain(min, max, includeZero = false) {
 	}
 	return [lo, hi];
 }
+/** @category Utilities
+* Pin domain ends — each defined bound overrides the fitted value. */
+function boundDomain(dom, min, max) {
+	return [min ?? dom[0], max ?? dom[1]];
+}
 //#endregion
 //#region src/core/scheduler.ts
 const raf = typeof requestAnimationFrame === "function" ? (cb) => requestAnimationFrame(cb) : (cb) => setTimeout(() => cb(Date.now()), 16);
@@ -1695,6 +1700,8 @@ const GPU_KIND = {
 };
 /** points retained beyond the window's left edge so they slide off-screen instead of vanishing mid-plot */
 const EDGE_KEEP = 3;
+/** default point count at which `renderer: "auto"` engages the GPU path */
+const GPU_THRESHOLD = 1e5;
 /** Chart instance. Create via {@link createChart}.
 * @category Charts
 */
@@ -1720,6 +1727,8 @@ var Chart = class {
 		this.destroyed = false;
 		this.pendingView = false;
 		this.gpu = null;
+		this.gpuInit = false;
+		this.dataRev = 0;
 		this.lastAppendAt = 0;
 		this.estInterval = 400;
 		this.onScroll = () => {
@@ -1782,7 +1791,35 @@ var Chart = class {
 		this.reduced = typeof matchMedia === "function" && matchMedia("(prefers-reduced-motion: reduce)").matches;
 		if (options.tooltip ?? this.mod.defaultTooltip) this.tooltip = new Tooltip(el, this.theme);
 		this.data = this.normalize(options.data, null);
-		if (GPU_KIND[options.type] && (options.renderer === "webgpu" || options.renderer === "auto")) import("./series-BdprL87H.mjs").then(({ GpuSeries }) => GpuSeries.create(options.gpu).then((g) => {
+		this.maybeInitGpu();
+		this.bindEvents();
+		const dom = this.layout();
+		this.view = {
+			x: [...dom.x],
+			y: [...dom.y]
+		};
+		this.viewTo = {
+			x: [...dom.x],
+			y: [...dom.y]
+		};
+		this.startAnimation(dom);
+	}
+	/**
+	* Lazily acquire the WebGPU backend. `"webgpu"` attaches unconditionally;
+	* `"auto"` waits until the xy point count crosses `gpuThreshold` — small
+	* charts never pay adapter/device acquisition.
+	*/
+	maybeInitGpu() {
+		if (this.gpu || this.gpuInit || this.destroyed) return;
+		if (!GPU_KIND[this.options.type]) return;
+		const r = this.options.renderer ?? "auto";
+		if (r !== "auto" && r !== "webgpu") return;
+		if (r === "auto") {
+			const d = this.data;
+			if ((d.kind === "xy" ? d.sortedX.length * Math.max(1, d.series.length) : 0) < (this.options.gpuThreshold ?? GPU_THRESHOLD)) return;
+		}
+		this.gpuInit = true;
+		import("./series-wyqYpkXm.mjs").then(({ GpuSeries }) => GpuSeries.create(this.options.gpu).then((g) => {
 			if (!g || this.destroyed) {
 				g?.destroy();
 				return;
@@ -1795,17 +1832,6 @@ var Chart = class {
 				return false;
 			});
 		}));
-		this.bindEvents();
-		const dom = this.layout();
-		this.view = {
-			x: [...dom.x],
-			y: [...dom.y]
-		};
-		this.viewTo = {
-			x: [...dom.x],
-			y: [...dom.y]
-		};
-		this.startAnimation(dom);
 	}
 	normalize(data, prev) {
 		const t = this.options.type;
@@ -2001,7 +2027,7 @@ var Chart = class {
 			const includeZero = this.options.type === "area" || this.options.type === "sparkline";
 			return {
 				x,
-				y: padDomain(min, max, includeZero)
+				y: this.yDomain(padDomain(min, max, includeZero))
 			};
 		}
 		if (d.kind === "category") {
@@ -2037,7 +2063,7 @@ var Chart = class {
 			}
 			return {
 				x: [0, d.categories.length],
-				y: padDomain(min, max, true)
+				y: this.yDomain(padDomain(min, max, true))
 			};
 		}
 		if (d.kind === "ohlc") {
@@ -2056,7 +2082,7 @@ var Chart = class {
 			}
 			return {
 				x,
-				y: padDomain(min, max)
+				y: this.yDomain(padDomain(min, max))
 			};
 		}
 		if (d.kind === "waterfall") {
@@ -2072,14 +2098,17 @@ var Chart = class {
 			}
 			return {
 				x: [0, d.bars.length],
-				y: padDomain(min, max, true)
+				y: this.yDomain(padDomain(min, max, true))
 			};
 		}
 		return {
 			x: [0, 1],
-			y: [0, 1]
+			y: this.yDomain([0, 1])
 		};
 	}
+	yDomain(y) {
+		return boundDomain(y, this.options.yMin, this.options.yMax);
+	}
 	lerpView(eased) {
 		const f = this.viewFrom;
 		const to = this.viewTo;
@@ -2181,30 +2210,35 @@ var Chart = class {
 		else this.mod.render(this.renderContext(t, scales));
 		if (this.hover) this.drawHover(this.hover, scales.yScale);
 	}
-	/** series rasterization on the GPU; grid/labels/hover stay on Canvas2D */
+	/**
+	* Series rasterization on the GPU; grid/labels/hover stay on Canvas2D.
+	* Raw data lives in GPU buffers — the per-frame cost is uniform writes +
+	* instanced draws, with compute decimation above the density threshold.
+	*/
 	gpuRender(t, scales) {
 		const g = this.gpu;
 		const d = this.data;
 		const kind = GPU_KIND[this.options.type];
-		if (!g || !kind || d.kind !== "xy") {
+		if (!g || g.unavailable || !kind || d.kind !== "xy") {
 			this.mod.render(this.renderContext(t, scales));
 			return;
 		}
-		const r = this.renderContext(t, scales);
+		g.syncData(d, this.dataRev);
+		const view = {
+			x: scales.xScale.domain,
+			y: scales.yScale.domain
+		};
 		const flow = this.options.flow ? FLOW_RIPPLE : 0;
-		g.begin(this.backend.plot);
-		for (const s of d.series) {
+		g.begin(this.backend.plot, t, flow);
+		for (let i = 0; i < d.series.length; i++) {
+			const s = d.series[i];
+			if (!s) continue;
 			if (kind === "points") {
-				const pts = mapSeriesPx(d.sortedX, s.y, s.prevY, t, scales.yScale.domain[0], scales.xScale, scales.yScale, flow);
-				g.points(pts, s.color, 2.5, .65);
+				g.points(i, s.color, 2.5, .65, view);
 				continue;
 			}
-			const pts = seriesPoints(r, s);
-			if (kind === "area") {
-				const base = scales.yScale(Math.max(0, scales.yScale.domain[0]));
-				g.area(pts, s.color, base, this.backend.plot);
-			}
-			g.line(pts, s.color, 2);
+			if (kind === "area") g.area(i, s.color, Math.max(0, scales.yScale.domain[0]), view);
+			g.line(i, s.color, 2, view);
 		}
 		g.end();
 	}
@@ -2339,6 +2373,8 @@ var Chart = class {
 	setData(data) {
 		const prev = this.data;
 		this.data = this.normalize(data, prev);
+		this.dataRev++;
+		this.maybeInitGpu();
 		const dom = this.layout();
 		this.startAnimation(dom);
 	}
@@ -2404,8 +2440,14 @@ var Chart = class {
 			sortedX,
 			series
 		};
-		if (m > 1 && x < sortedX[m - 2]) resortXY(nd);
+		const resort = m > 1 && x < sortedX[m - 2];
+		if (resort) resortXY(nd);
 		this.data = nd;
+		if (resort) this.dataRev++;
+		else if (this.gpu && !this.gpu.unavailable) {
+			if (!this.gpu.appended(x, d.series.map((s, i) => ys[i] ?? s.y[n - 1]), d.series.map((s) => s.y[n - 1]), drop)) this.dataRev++;
+		}
+		this.maybeInitGpu();
 		this.pendingView = true;
 		sharedScheduler.add(this.frame);
 	}
@@ -2480,6 +2522,6 @@ function createChart(el, options) {
 	return new Chart(el, options);
 }
 //#endregion
-export { Chart, computeTicks, createChart, darkTheme, decimateM4, extent, formatNumber, formatSI, lightTheme, linearScale, nearestIndex, padDomain, resolveTheme };
+export { Chart, boundDomain, computeTicks, createChart, darkTheme, decimateM4, extent, formatNumber, formatSI, lightTheme, linearScale, nearestIndex, padDomain, resolveTheme };
 
 //# sourceMappingURL=index.mjs.map