aliencharts 0.1.4 → 0.3.0

package/index.d.ts

@@ -1,5 +1,3 @@
-import type { MouseEvent as ReactMouseEvent, ReactElement } from "react";
-
 export type NumericArray =
   | number[]
   | Float32Array
@@ -35,6 +33,34 @@ export class LineSeries {
   name: string;
   color: string;
   maxLevels: number;
+  readonly type: "line";
+  readonly length: number;
+  rawX: Float64Array;
+  rawY: Float32Array;
+
+  append(xValues: NumericArray, yValues: NumericArray): void;
+  getVisiblePoints(
+    xMin: number,
+    xMax: number,
+    pixelWidth: number,
+  ): VisibleSeriesPoints;
+}
+
+export type BarOrientation = "vertical" | "horizontal";
+
+export interface BarSeriesOptions extends SeriesOptions {
+  orientation?: BarOrientation;
+}
+
+export class BarSeries {
+  constructor(options: BarSeriesOptions);
+
+  id: string;
+  name: string;
+  color: string;
+  maxLevels: number;
+  readonly type: "bar";
+  readonly orientation: BarOrientation;
   readonly length: number;
   rawX: Float64Array;
   rawY: Float32Array;
@@ -50,7 +76,9 @@ export class LineSeries {
 export interface Chart {
   id: string;
   title: string;
-  series: LineSeries[];
+  series: LineSeries[] | BarSeries[];
+  categories?: Array<string | ChartCategory>;
+  xAxisLabel?: string;
   pinned?: boolean;
   yRange?: {
     min: number;
@@ -59,6 +87,11 @@ export interface Chart {
   [key: string]: unknown;
 }
 
+export interface ChartCategory {
+  value: number;
+  label: string;
+}
+
 export interface DataPoint {
   x: number;
   y: number;
@@ -105,8 +138,8 @@ export interface TopMarker<T = unknown> {
 
 export interface ChartContextMenuPayload {
   chart: Chart;
-  event: ReactMouseEvent<HTMLDivElement>;
-  point: DataPoint;
+  event: MouseEvent;
+  point: DataPoint | null;
 }
 
 export interface CreateDrawingIdPayload {
@@ -114,11 +147,9 @@ export interface CreateDrawingIdPayload {
   type: DrawingTool;
 }
 
-export interface ChartGridProps {
+export interface ChartGridOptions {
   charts: Chart[];
   columns?: number;
-  className?: string;
-  dataRevision?: number;
   initialVisiblePoints?: number | null;
   backgroundColor?: string;
   antialiasLines?: boolean;
@@ -133,7 +164,6 @@ export interface ChartGridProps {
   showTooltips?: boolean;
   followLatest?: boolean;
   followVisibleLatest?: boolean;
-  jumpToLatestRevision?: number;
   drawings?: Drawing[];
   onDrawingsChange?: (drawings: Drawing[]) => void;
   activeDrawingTool?: DrawingTool | null;
@@ -165,6 +195,8 @@ export interface MockChartsOptions {
   pointCount?: number;
 }
 
-export function ChartGrid(props: ChartGridProps): ReactElement;
+export function createLineSeries(options: SeriesOptions): LineSeries;
+/** @deprecated Use createLineSeries for explicit line-series naming. */
 export function createSeries(options: SeriesOptions): LineSeries;
+export function createBarSeries(options: BarSeriesOptions): BarSeries;
 export function createMockCharts(options?: MockChartsOptions): Chart[];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "aliencharts",
-  "version": "0.1.4",
+  "version": "0.3.0",
   "description": "WebGL chart renderer for multi-metric dashboards, built for ease of use and high performance.",
   "type": "module",
   "license": "MIT",
@@ -22,39 +22,55 @@
   "bugs": {
     "url": "https://github.com/FarangLab/aliencharts/issues"
   },
-  "main": "./dist/index.cjs",
   "module": "./dist/index.js",
   "types": "./index.d.ts",
   "exports": {
     ".": {
       "types": "./index.d.ts",
-      "import": "./dist/index.js",
-      "require": "./dist/index.cjs"
+      "import": "./dist/index.js"
+    },
+    "./vanilla": {
+      "types": "./vanilla.d.ts",
+      "import": "./dist/vanilla.js"
+    },
+    "./react": {
+      "types": "./react.d.ts",
+      "import": "./dist/react.js"
     },
     "./styles.css": "./dist/aliencharts.css"
   },
   "files": [
     "dist",
     "assets",
-    "index.d.ts"
+    "index.d.ts",
+    "vanilla.d.ts",
+    "react.d.ts",
+    "THIRD_PARTY_NOTICES.md"
   ],
   "sideEffects": [
     "**/*.css"
   ],
   "scripts": {
     "build": "node build.js && tailwindcss -i src/styles.css -o dist/aliencharts.css --minify",
+    "examples": "vite --host 127.0.0.1 --port 4178",
+    "test": "npm run build && playwright test",
     "prepublishOnly": "npm run build"
   },
   "peerDependencies": {
-    "react": ">=18",
-    "react-dom": ">=18"
+    "react": ">=18"
   },
-  "dependencies": {
-    "@phosphor-icons/react": "^2.1.10"
+  "peerDependenciesMeta": {
+    "react": {
+      "optional": true
+    }
   },
   "devDependencies": {
+    "@playwright/test": "^1.61.1",
     "@tailwindcss/cli": "^4.3.2",
     "esbuild": "^0.28.1",
-    "tailwindcss": "^4.3.2"
+    "react": "^19.2.3",
+    "react-dom": "^19.2.8",
+    "tailwindcss": "^4.3.2",
+    "vite": "^8.1.5"
   }
 }

package/react.d.ts

@@ -0,0 +1,22 @@
+export * from "./index.js";
+
+import type {
+  ForwardRefExoticComponent,
+  RefAttributes,
+} from "react";
+import type { ChartGridOptions } from "./index.js";
+
+export interface ChartGridProps extends ChartGridOptions {
+  className?: string;
+  dataRevision?: number;
+}
+
+export interface ChartGridHandle {
+  invalidate(): void;
+  jumpToLatest(chartId?: string): void;
+  scrollToTop(options?: ScrollToOptions): void;
+}
+
+export const ChartGrid: ForwardRefExoticComponent<
+  ChartGridProps & RefAttributes<ChartGridHandle>
+>;

package/vanilla.d.ts

@@ -0,0 +1,17 @@
+export * from "./index.js";
+
+import type { Chart, ChartGridOptions } from "./index.js";
+
+export interface ChartGridController {
+  setOptions(options: Partial<ChartGridOptions>): void;
+  setCharts(charts: Chart[]): void;
+  invalidate(): void;
+  jumpToLatest(chartId?: string): void;
+  scrollToTop(options?: ScrollToOptions): void;
+  destroy(): void;
+}
+
+export function createChartGrid(
+  container: HTMLElement,
+  options: ChartGridOptions,
+): ChartGridController;