@rm-graph/core 0.1.0

package/dist/index-DWzDIVQ9.d.mts

@@ -0,0 +1,404 @@
+/**
+ * Core type definitions for SciChart UI
+ */
+interface ChartConfig {
+    /** Unique identifier for the chart */
+    id?: string;
+    /** Width of the chart (CSS value or number in pixels) */
+    width?: string | number;
+    /** Height of the chart (CSS value or number in pixels) */
+    height?: string | number;
+    /** Theme to apply to the chart */
+    theme?: ThemeConfig | string;
+    /** Enable/disable animations */
+    animation?: boolean | AnimationConfig;
+    /** Tooltip configuration */
+    tooltip?: TooltipConfig;
+    /** Legend configuration */
+    legend?: LegendConfig;
+    /** Title configuration */
+    title?: TitleConfig;
+}
+interface AnimationConfig {
+    /** Enable/disable animations */
+    enabled: boolean;
+    /** Animation duration in milliseconds */
+    duration?: number;
+    /** Animation easing function */
+    easing?: "linear" | "easeIn" | "easeOut" | "easeInOut";
+}
+interface TooltipConfig {
+    /** Enable/disable tooltip */
+    enabled?: boolean;
+    /** Tooltip trigger mode */
+    trigger?: "hover" | "click" | "none";
+    /** Custom tooltip formatter */
+    formatter?: (data: TooltipData) => string;
+}
+interface TooltipData {
+    seriesName: string;
+    dataPoint: DataPoint;
+    x: number;
+    y: number;
+}
+interface LegendConfig {
+    /** Show/hide legend */
+    show?: boolean;
+    /** Legend position */
+    position?: "top" | "bottom" | "left" | "right";
+    /** Legend orientation */
+    orientation?: "horizontal" | "vertical";
+}
+interface TitleConfig {
+    /** Title text */
+    text?: string;
+    /** Subtitle text */
+    subtext?: string;
+    /** Title position */
+    position?: "left" | "center" | "right";
+}
+interface DataPoint {
+    x: number | Date | string;
+    y: number;
+    /** Optional label for the data point */
+    label?: string;
+    /** Optional custom data */
+    meta?: Record<string, unknown>;
+}
+interface SeriesData {
+    /** Series name (used in legend and tooltips) */
+    name: string;
+    /** Data points */
+    data: DataPoint[] | number[];
+    /** Series color (overrides theme) */
+    color?: string;
+    /** Series type for mixed charts */
+    type?: ChartType;
+}
+type ChartType = "line" | "bar" | "area" | "scatter" | "pie" | "donut" | "candlestick" | "column" | "spline" | "bubble" | "heatmap" | "surface3d";
+interface AxisConfig {
+    /** Axis title */
+    title?: string;
+    /** Show/hide axis */
+    show?: boolean;
+    /** Axis type */
+    type?: "numeric" | "category" | "date" | "logarithmic";
+    /** Minimum value (auto if not specified) */
+    min?: number;
+    /** Maximum value (auto if not specified) */
+    max?: number;
+    /** Grid line configuration */
+    gridLines?: GridLineConfig;
+    /** Label formatter */
+    labelFormatter?: (value: number | string) => string;
+}
+interface GridLineConfig {
+    /** Show/hide grid lines */
+    show?: boolean;
+    /** Grid line color */
+    color?: string;
+    /** Grid line style */
+    style?: "solid" | "dashed" | "dotted";
+}
+interface XAxisConfig extends AxisConfig {
+    /** Categories for category axis */
+    categories?: string[];
+}
+interface YAxisConfig extends AxisConfig {
+    /** Position of Y axis */
+    position?: "left" | "right";
+}
+interface ThemeConfig {
+    /** Theme name */
+    name: string;
+    /** Background color */
+    backgroundColor?: string;
+    /** Text color */
+    textColor?: string;
+    /** Default color palette for series */
+    colorPalette?: string[];
+    /** Axis styling */
+    axis?: {
+        lineColor?: string;
+        labelColor?: string;
+        titleColor?: string;
+        gridLineColor?: string;
+    };
+    /** Tooltip styling */
+    tooltip?: {
+        backgroundColor?: string;
+        textColor?: string;
+        borderColor?: string;
+        borderRadius?: number;
+    };
+    /** Legend styling */
+    legend?: {
+        textColor?: string;
+        backgroundColor?: string;
+    };
+    /** Title styling */
+    title?: {
+        color?: string;
+        fontSize?: number;
+        fontWeight?: string;
+    };
+    /** Font family */
+    fontFamily?: string;
+}
+interface ChartEventMap {
+    click: ChartClickEvent;
+    hover: ChartHoverEvent;
+    legendClick: LegendClickEvent;
+    zoom: ZoomEvent;
+    pan: PanEvent;
+    rendered: RenderedEvent;
+}
+interface ChartClickEvent {
+    dataPoint?: DataPoint;
+    seriesIndex?: number;
+    x: number;
+    y: number;
+}
+interface ChartHoverEvent {
+    dataPoint?: DataPoint;
+    seriesIndex?: number;
+    x: number;
+    y: number;
+}
+interface LegendClickEvent {
+    seriesName: string;
+    seriesIndex: number;
+    visible: boolean;
+}
+interface ZoomEvent {
+    xMin: number;
+    xMax: number;
+    yMin: number;
+    yMax: number;
+}
+interface PanEvent {
+    deltaX: number;
+    deltaY: number;
+}
+interface RenderedEvent {
+    chartId: string;
+    renderTime: number;
+}
+interface ChartInstance {
+    /** Unique chart ID */
+    readonly id: string;
+    /** Update chart data */
+    setData(data: SeriesData[]): void;
+    /** Update chart options */
+    setOptions(options: Partial<ChartConfig>): void;
+    /** Destroy the chart and clean up resources */
+    destroy(): void;
+    /** Resize the chart */
+    resize(width?: number, height?: number): void;
+    /** Export chart as image */
+    exportImage(format?: "png" | "jpeg" | "svg"): Promise<string>;
+    /** Add event listener */
+    on<K extends keyof ChartEventMap>(event: K, handler: (e: ChartEventMap[K]) => void): void;
+    /** Remove event listener */
+    off<K extends keyof ChartEventMap>(event: K, handler: (e: ChartEventMap[K]) => void): void;
+}
+interface LineChartConfig extends ChartConfig {
+    /** X-axis configuration */
+    xAxis?: XAxisConfig;
+    /** Y-axis configuration */
+    yAxis?: YAxisConfig;
+    /** Line thickness */
+    lineWidth?: number;
+    /** Show data points */
+    showPoints?: boolean;
+    /** Point size */
+    pointSize?: number;
+    /** Enable smooth curves (spline) */
+    smooth?: boolean;
+    /** Series data */
+    series: SeriesData[];
+}
+interface BarChartConfig extends ChartConfig {
+    /** X-axis configuration */
+    xAxis?: XAxisConfig;
+    /** Y-axis configuration */
+    yAxis?: YAxisConfig;
+    /** Bar orientation */
+    orientation?: "vertical" | "horizontal";
+    /** Bar width (0-1 as percentage) */
+    barWidth?: number;
+    /** Stack bars */
+    stacked?: boolean;
+    /** Border radius for bars */
+    borderRadius?: number;
+    /** Series data */
+    series: SeriesData[];
+}
+interface PieChartConfig extends ChartConfig {
+    /** Inner radius for donut (0 for pie) */
+    innerRadius?: number;
+    /** Outer radius */
+    outerRadius?: number;
+    /** Start angle in degrees */
+    startAngle?: number;
+    /** Show labels */
+    showLabels?: boolean;
+    /** Label position */
+    labelPosition?: "inside" | "outside";
+    /** Series data (single series) */
+    series: SeriesData;
+}
+interface AreaChartConfig extends LineChartConfig {
+    /** Fill opacity (0-1) */
+    fillOpacity?: number;
+    /** Stack areas */
+    stacked?: boolean;
+}
+interface ScatterChartConfig extends ChartConfig {
+    /** X-axis configuration */
+    xAxis?: XAxisConfig;
+    /** Y-axis configuration */
+    yAxis?: YAxisConfig;
+    /** Point size */
+    pointSize?: number;
+    /** Point shape */
+    pointShape?: "circle" | "square" | "triangle" | "diamond";
+    /** Series data */
+    series: SeriesData[];
+}
+interface HeatmapChartConfig extends ChartConfig {
+    /** X-axis configuration */
+    xAxis?: XAxisConfig;
+    /** Y-axis configuration */
+    yAxis?: YAxisConfig;
+    /** 2D array of z-values for the heatmap */
+    zValues: number[][];
+    /** X start position */
+    xStart?: number;
+    /** X step size */
+    xStep?: number;
+    /** Y start position */
+    yStart?: number;
+    /** Y step size */
+    yStep?: number;
+    /** Minimum value for color mapping */
+    colorMin?: number;
+    /** Maximum value for color mapping */
+    colorMax?: number;
+    /** Color gradient stops */
+    colorStops?: Array<{
+        offset: number;
+        color: string;
+    }>;
+    /** Show color legend */
+    showLegend?: boolean;
+}
+interface Surface3DChartConfig extends ChartConfig {
+    /** X size of the grid */
+    xSize?: number;
+    /** Z size of the grid */
+    zSize?: number;
+    /** X step size */
+    xStep?: number;
+    /** Z step size */
+    zStep?: number;
+    /** 2D array of Y values for the surface (height values) */
+    yValues: number[][];
+    /** Minimum value for color mapping */
+    colorMin?: number;
+    /** Maximum value for color mapping */
+    colorMax?: number;
+    /** Color gradient stops */
+    colorStops?: Array<{
+        offset: number;
+        color: string;
+    }>;
+    /** Surface opacity (0-1) */
+    opacity?: number;
+    /** Draw wireframe */
+    drawWireframe?: boolean;
+    /** Wireframe stroke color */
+    wireframeStroke?: string;
+    /** Draw mesh */
+    drawMesh?: boolean;
+    /** Camera position */
+    cameraPosition?: {
+        x: number;
+        y: number;
+        z: number;
+    };
+}
+
+/**
+ * Default light theme - clean white background with subtle grid
+ */
+declare const lightTheme: ThemeConfig;
+/**
+ * Default dark theme
+ */
+declare const darkTheme: ThemeConfig;
+/**
+ * Modern gradient theme with vibrant colors
+ */
+declare const modernTheme: ThemeConfig;
+/**
+ * Midnight theme - deep dark with neon accents
+ */
+declare const midnightTheme: ThemeConfig;
+
+/**
+ * ThemeManager - Manages chart themes and provides theme resolution
+ */
+declare class ThemeManager {
+    private static instance;
+    private themes;
+    private currentTheme;
+    private constructor();
+    /**
+     * Get the singleton instance of ThemeManager
+     */
+    static getInstance(): ThemeManager;
+    /**
+     * Register a custom theme
+     */
+    registerTheme(theme: ThemeConfig): void;
+    /**
+     * Get a theme by name
+     */
+    getTheme(name: string): ThemeConfig;
+    /**
+     * Set the global default theme
+     */
+    setDefaultTheme(name: string): void;
+    /**
+     * Get the current default theme name
+     */
+    getDefaultThemeName(): string;
+    /**
+     * Get the current default theme configuration
+     */
+    getDefaultTheme(): ThemeConfig;
+    /**
+     * Get all registered theme names
+     */
+    getAvailableThemes(): string[];
+    /**
+     * Check if a theme is registered
+     */
+    hasTheme(name: string): boolean;
+    /**
+     * Resolve theme from string name or ThemeConfig object
+     */
+    resolveTheme(theme?: ThemeConfig | string): ThemeConfig;
+    /**
+     * Merge two themes, with override taking precedence
+     */
+    mergeThemes(base: ThemeConfig, override: Partial<ThemeConfig>): ThemeConfig;
+    /**
+     * Get color from palette by index (cycles through palette)
+     */
+    getColorFromPalette(theme: ThemeConfig, index: number): string;
+}
+declare const getThemeManager: () => ThemeManager;
+
+export { type AreaChartConfig as A, type BarChartConfig as B, type ChartConfig as C, type DataPoint as D, type GridLineConfig as G, type HeatmapChartConfig as H, type LineChartConfig as L, type PieChartConfig as P, type RenderedEvent as R, type SeriesData as S, type ThemeConfig as T, type XAxisConfig as X, type YAxisConfig as Y, type ZoomEvent as Z, type ChartInstance as a, type ChartEventMap as b, type Surface3DChartConfig as c, type ScatterChartConfig as d, type AnimationConfig as e, type TooltipConfig as f, type TooltipData as g, type LegendConfig as h, type TitleConfig as i, type AxisConfig as j, type ChartType as k, type ChartClickEvent as l, type ChartHoverEvent as m, type LegendClickEvent as n, type PanEvent as o, lightTheme as p, darkTheme as q, modernTheme as r, midnightTheme as s, ThemeManager as t, getThemeManager as u };