@lineandvertexsoftware/vertexa-chart 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Vertexa contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,43 @@
+# @vertexa-chart/vertexa-chart-core
+
+Core chart API for Vertexa Chart.
+
+## Install
+
+```bash
+npm install @vertexa-chart/vertexa-chart-core
+```
+
+## Usage
+
+```ts
+import { Chart } from "@vertexa-chart/vertexa-chart-core";
+
+const chart = new Chart(document.querySelector("#root")!, {
+  width: 920,
+  height: 520,
+  traces: []
+});
+```
+
+## Public API
+
+- `setTraces(traces)`
+- `appendPoints(updates, options?)`
+- `exportPng(options?)`
+- `exportSvg(options?)`
+- `exportCsvPoints(options?)`
+- `setLayout(layout)`
+- `setSize(width, height)`
+- `panBy(dxCss, dyCss)`
+- `zoomBy(factor, centerPlot?)`
+- `resetView()`
+- `fitToData()`
+- `autoscaleY()`
+- `setAspectLock(enabled)`
+- `setPerformanceMode(mode)`
+- `getPerformanceStats()`
+- `destroy()`
+
+For full examples and docs, see the monorepo README:
+[https://github.com/LineandVertexSoftware/vertexa-chart/blob/main/README.md](https://github.com/LineandVertexSoftware/vertexa-chart/blob/main/README.md)

package/dist/Chart.d.ts

@@ -0,0 +1,256 @@
+import type { ChartAppendPointsOptions, ChartExportCsvPointsOptions, ChartExportPngOptions, ChartExportSvgOptions, ChartAppendPointsUpdate, ChartOptions, ChartPerformanceMode, ChartPerformanceStats, ChartPublicApi, Layout, Trace } from "./types.js";
+/**
+ * High-performance chart component with a frozen, minimal public API.
+ *
+ * Public API (v1):
+ * - `setTraces`
+ * - `appendPoints`
+ * - `exportPng`
+ * - `exportSvg`
+ * - `exportCsvPoints`
+ * - `setLayout`
+ * - `setSize`
+ * - `getPerformanceStats`
+ * - `destroy`
+ */
+export declare class Chart implements ChartPublicApi {
+    private root;
+    private container;
+    private svgGrid;
+    private canvas;
+    private svg;
+    private tooltip;
+    private toolbar;
+    private toolbarEl;
+    private toolbarExportWrap;
+    private toolbarExportMenu;
+    private toolbarExportButton;
+    private toolbarFullscreenButton;
+    private toolbarExportOpen;
+    private toolbarExportBusy;
+    private toolbarPreFullscreenSize;
+    private overlay;
+    private renderer;
+    private initialized;
+    private destroyed;
+    private initPromise;
+    private width;
+    private height;
+    private basePadding;
+    private padding;
+    private layout;
+    private theme;
+    private a11y;
+    private traces;
+    private pickingMode;
+    private onHoverHook?;
+    private onClickHook?;
+    private onZoomHook?;
+    private onLegendToggleHook?;
+    private onSelectHook?;
+    private tooltipFormatter?;
+    private tooltipRenderer?;
+    private handleContainerKeyDown;
+    private handleToolbarExportToggle;
+    private handleToolbarExportMenuClick;
+    private handleToolbarFullscreenClick;
+    private handleToolbarDocumentPointerDown;
+    private handleToolbarDocumentKeyDown;
+    private handleToolbarFullscreenChange;
+    private handleToolbarWindowResize;
+    private zoom;
+    private dpr;
+    private xDomainNum;
+    private yDomainNum;
+    private traceData;
+    private heatmapValueByTrace;
+    private heatmapHoverSizeByTrace;
+    private markerNormByTrace;
+    private markerNormLayers;
+    private idRanges;
+    private xSorted;
+    private ySorted;
+    private hoverRpx;
+    private hoverThrottleMs;
+    private lastHoverTs;
+    private hoverRaf;
+    private aspectLockEnabled;
+    private performanceMode;
+    private gridCellPx;
+    private gridMap;
+    private gridX;
+    private gridY;
+    private gridTrace;
+    private gridPoint;
+    private gridBuilt;
+    private gridRebuildPending;
+    private gridRebuildTimer;
+    private gridLastBuildTs;
+    private gridMinBuildIntervalMs;
+    private lastGridZoomK;
+    private lastGridZoomX;
+    private lastGridZoomY;
+    private gridMinScaleRelDelta;
+    private gridMinTransRelDelta;
+    private enablePerfMonitoring;
+    private perfStats;
+    /**
+     * Create a new chart and start async renderer initialization immediately.
+     */
+    constructor(target: string | HTMLElement, opts: ChartOptions);
+    private init;
+    /**
+     * Replace all traces and redraw the chart.
+     *
+     * @param traces New full trace list.
+     * @throws Error if called after `destroy()`.
+     */
+    setTraces(traces: Trace[]): void;
+    /**
+     * Incrementally append points to one or more traces and redraw.
+     *
+     * Use `maxPoints` for sliding-window behavior.
+     *
+     * @throws Error if called after `destroy()`.
+     * @throws RangeError if a target `traceIndex` does not exist.
+     */
+    appendPoints(updates: ChartAppendPointsUpdate | ChartAppendPointsUpdate[], options?: ChartAppendPointsOptions): void;
+    /**
+     * Export the current chart view as a PNG image.
+     */
+    exportPng(options?: ChartExportPngOptions): Promise<Blob>;
+    /**
+     * Export the current chart view as an SVG document.
+     *
+     * The rendered plot layer is embedded as a PNG image to preserve the WebGPU output,
+     * while grid/overlay layers remain SVG.
+     */
+    exportSvg(options?: ChartExportSvgOptions): Promise<Blob>;
+    /**
+     * Export chart points as CSV rows.
+     */
+    exportCsvPoints(options?: ChartExportCsvPointsOptions): Blob;
+    /**
+     * Replace the chart layout and redraw.
+     *
+     * @param layout New layout object.
+     * @throws Error if called after `destroy()`.
+     */
+    setLayout(layout: Layout): void;
+    private setLOD;
+    setPerformanceMode(mode: ChartPerformanceMode): void;
+    /**
+     * Read runtime performance stats for rendering and picking.
+     */
+    getPerformanceStats(): ChartPerformanceStats;
+    private toggleTrace;
+    /**
+     * Resize the chart viewport in CSS pixels and redraw.
+     *
+     * @param width New outer width in CSS pixels.
+     * @param height New outer height in CSS pixels.
+     * @throws Error if called after `destroy()`.
+     */
+    setSize(width: number, height: number): void;
+    panBy(dxCss: number, dyCss: number): void;
+    zoomBy(factor: number, centerPlot?: {
+        x: number;
+        y: number;
+    }): void;
+    resetView(): void;
+    fitToData(): void;
+    autoscaleY(): void;
+    setAspectLock(enabled: boolean): void;
+    /**
+     * Release GPU/DOM resources and make the chart unusable.
+     *
+     * Idempotent: calling this multiple times is safe.
+     */
+    destroy(): void;
+    private assertActive;
+    private toRuntimeTrace;
+    private resolveLayoutPadding;
+    private isLegendVisible;
+    private getAxis;
+    private setAxisInLayout;
+    private getVisibleAxisRangeNum;
+    private getHoverMode;
+    private createExportCanvas;
+    private getExport2dContext;
+    private drawSvgLayerToContext;
+    private serializeSvgLayerForExport;
+    private captureCanvasLayerDataUrl;
+    private drawCanvasLayerToContext;
+    private resolveAxisType;
+    private makeOverlayAxisSpec;
+    private makeOverlayAnnotations;
+    private resolveOverlayGrid;
+    private paletteColor;
+    private render;
+    private onHover;
+    private gpuPickOverride;
+    private handleClick;
+    private normalizeHoverToCss;
+    private normalizePickCss;
+    private toChartPoint;
+    private emitHoverHook;
+    private emitClickHook;
+    private handleSelection;
+    private handleBoxSelect;
+    private applyHover;
+    private requestRender;
+    private screenToPlot;
+    private cpuPickClosest;
+    private cpuPickFallbackScan;
+    private pickSnapX;
+    private pickSnapY;
+    private compileScene;
+    private computeAxisDomain;
+    private applyAxisBounds;
+    private normalizeInterleaved;
+    private smoothLinePoints;
+    private getTraceColor;
+    private getTraceHoverSizePx;
+    private normalizeBarBaseY;
+    private normalizeAreaBaseY;
+    private computeAreaFillWidthPx;
+    private toHeatmapRows;
+    private normalizeAxisValues;
+    private computeAxisEdges;
+    private resolveHeatmapScale;
+    private resolveHeatmapZRange;
+    private interpolateHeatmapColor;
+    private estimateHeatmapHoverSize;
+    private getHeatmapLegendColor;
+    private makeLegendItems;
+    private scheduleGridRebuild;
+    private shouldRebuildGrid;
+    private rebuildGridIndex;
+    private gridKey;
+    private idToHit;
+    private toScreenFromNorm;
+    private getNormPoint;
+    private formatHover;
+    private makeTooltipContext;
+    private showTooltip;
+    private showCursorTooltip;
+    private hideTooltip;
+    private onContainerKeyDown;
+    private mountToolbar;
+    private createToolbarButton;
+    private setToolbarExportMenuOpen;
+    private onToolbarExportToggle;
+    private onToolbarExportMenuClick;
+    private downloadToolbarBlob;
+    private onToolbarFullscreenClick;
+    private onToolbarDocumentPointerDown;
+    private onToolbarDocumentKeyDown;
+    private onToolbarFullscreenChange;
+    private onToolbarWindowResize;
+    private resizeToFullscreenViewport;
+    private syncToolbarFullscreenButton;
+    private cleanupToolbar;
+    private applyAriaAttributes;
+    private mountDom;
+}
+//# sourceMappingURL=Chart.d.ts.map

package/dist/Chart.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Chart.d.ts","sourceRoot":"","sources":["../src/Chart.ts"],"names":[],"mappings":"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"}