chartai 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+This is free and unencumbered software released into the public domain.
+
+Anyone is free to copy, modify, publish, use, compile, sell, or
+distribute this software, either in source code form or as a compiled
+binary, for any purpose, commercial or non-commercial, and by any
+means. It can be slapped, mashed, told that the code is a good boy,
+anything and everything. 
+
+In jurisdictions that recognize copyright laws, the author or authors
+of this software dedicate any and all copyright interest in the
+software to the public domain. We intend this to be an overt act of
+relinquishment in perpetuity of all present and future rights to this
+software under copyright law. This is the way.
+
+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 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/dist/chart-library.d.ts

@@ -0,0 +1,170 @@
+export type ChartType = "scatter" | "line" | "bar";
+export type ZoomMode = "both" | "x-only" | "y-only" | "none";
+export interface ChartSeries {
+    label: string;
+    color: {
+        r: number;
+        g: number;
+        b: number;
+    };
+    x: number[];
+    y: number[];
+}
+export interface HoverData {
+    x: number;
+    y: number;
+    index: number;
+    screenX: number;
+    screenY: number;
+    seriesIndex: number;
+    seriesLabel: string;
+}
+export interface ChartConfig {
+    type: ChartType;
+    container: HTMLElement;
+    series: ChartSeries[];
+    formatX?: (value: number) => string;
+    formatY?: (value: number) => string;
+    onHover?: (data: HoverData | null) => void;
+    zoomMode?: ZoomMode;
+    labelSize?: number;
+    pointSize?: number;
+    defaultBounds?: {
+        minX?: number;
+        maxX?: number;
+        minY?: number;
+        maxY?: number;
+    };
+    /** Max data samples scanned per pixel column for min/max (line/bar). 0 = unlimited. Default: 1000. */
+    maxSamplesPerPixel?: number;
+    /** Background color [r, g, b] (0-1 range). Default: derived from theme. */
+    bgColor?: [number, number, number];
+    /** CSS color string for axis label text. Default: derived from theme. */
+    textColor?: string;
+    /** CSS color string for grid lines. Default: derived from theme. */
+    gridColor?: string;
+    /** CSS font-family for axis labels. Default: system font stack. */
+    fontFamily?: string;
+    /** Show built-in hover tooltip with crosshairs on the axis canvas. Default: false. */
+    showTooltip?: boolean;
+    /** Pill tween half-life in ms (time to cover half remaining distance). Default: 60. */
+    pillDecayMs?: number;
+}
+export interface ChartStats {
+    fps: number;
+    renderMs: number;
+    total: number;
+    active: number;
+}
+export interface InternalChart {
+    id: string;
+    config: ChartConfig;
+    el: HTMLElement;
+    backCanvas: HTMLCanvasElement;
+    axisCanvas: HTMLCanvasElement;
+    /** Logical dimensions in CSS pixels (for plugin coordinate calculations) */
+    width: number;
+    height: number;
+    series: Array<{
+        label: string;
+        color: {
+            r: number;
+            g: number;
+            b: number;
+        };
+        rawX: number[];
+        rawY: number[];
+    }>;
+    bounds: {
+        minX: number;
+        maxX: number;
+        minY: number;
+        maxY: number;
+    };
+    view: {
+        panX: number;
+        panY: number;
+        zoomX: number;
+        zoomY: number;
+    };
+    zoomMode: ZoomMode;
+    visible: boolean;
+    /** Shared drag flag — set by zoom plugin, read by hover plugin. */
+    dragging: boolean;
+    bgColor?: [number, number, number];
+    textColor?: string;
+    gridColor?: string;
+    fontFamily?: string;
+    /** Momentum animation frame id (shared for cross-concern cancellation). */
+    momentum: number | null;
+    /** Binary-search nearest data point to a screen coordinate. */
+    findNearestPoint(screenX: number, screenY: number, width: number, height: number): HoverData | null;
+}
+export interface ChartPlugin {
+    name: string;
+    /** Called when a chart is created. `el` is the canvas-wrap element. */
+    install?(chart: InternalChart, el: HTMLElement): void;
+    /** Called when a chart is destroyed. */
+    uninstall?(chart: InternalChart): void;
+    /** Called on the back canvas (behind GPU). Draw here to appear behind chart data. */
+    beforeDraw?(ctx: CanvasRenderingContext2D, chart: InternalChart): void;
+    /** Called on the front canvas (above GPU). Plugins paint in registration order. */
+    afterDraw?(ctx: CanvasRenderingContext2D, chart: InternalChart): void;
+}
+export declare function registerPlugin(plugin: ChartPlugin): void;
+export declare function unregisterPlugin(name: string): void;
+export declare function getPlugins(): readonly ChartPlugin[];
+type StatsCallback = (stats: ChartStats) => void;
+declare class ChartManager {
+    private static instance;
+    static readonly MARGIN: {
+        left: number;
+        right: number;
+        top: number;
+        bottom: number;
+    };
+    static readonly HOVER_MAX_DISTANCE_PX = 50;
+    static readonly MIN_ZOOM = 0.1;
+    static readonly MAX_ZOOM = 10000000;
+    static readonly DEFAULT_LABEL_SIZE = 12;
+    static readonly DEFAULT_FONT = "-apple-system, BlinkMacSystemFont, \"Segoe UI\", system-ui, sans-serif";
+    private static resizeCanvas;
+    private worker;
+    private charts;
+    private chartIdCounter;
+    private _syncViews;
+    private _isDark;
+    private statsCallbacks;
+    private currentStats;
+    private visibilityObserver;
+    private resizeObserver;
+    private constructor();
+    static getInstance(): ChartManager;
+    get isDark(): boolean;
+    get syncViews(): boolean;
+    init(): Promise<boolean>;
+    create(config: ChartConfig): string;
+    destroy(id: string): void;
+    updateSeries(id: string, series: ChartSeries[]): void;
+    setPointSize(id: string, size: number): void;
+    setMaxSamplesPerPixel(id: string, maxSamples: number): void;
+    setStyle(id: string, style: {
+        bgColor?: [number, number, number];
+        textColor?: string;
+        gridColor?: string;
+        fontFamily?: string;
+    }): void;
+    setZoomMode(id: string, mode: ZoomMode): void;
+    getChartCount(): number;
+    getZoomMode(id: string): ZoomMode;
+    setSyncViews(sync: boolean): void;
+    setTheme(dark: boolean): void;
+    onStats(callback: StatsCallback): () => void;
+    getStats(): ChartStats;
+    resetView(id: string): void;
+    sendViewTransform(chart: InternalChart): void;
+    syncAllViews(source: InternalChart): void;
+    drawChart(chart: InternalChart): void;
+}
+export { ChartManager };
+//# sourceMappingURL=chart-library.d.ts.map

package/dist/chart-library.d.ts.map

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