@zendir/ui 0.1.0

package/dist/react/charts/unified/index.d.ts

@@ -0,0 +1,55 @@
+/**
+ * @zendir/ui - Unified Chart System
+ *
+ * Enterprise-grade charting components built on ECharts with AstroUXD compliance.
+ *
+ * Features:
+ * - 15+ chart types
+ * - Real-time streaming
+ * - Zoom, pan, brush selection
+ * - Annotations (thresholds, regions)
+ * - Export (PNG, SVG, CSV)
+ * - Crosshair sync across charts
+ * - Full accessibility support
+ * - Dark/light theme support
+ *
+ * @example
+ * ```tsx
+ * import { AstroChart, LineChart, useChartStream } from '@zendir/ui';
+ *
+ * // Basic usage
+ * <LineChart
+ *   series={[{ id: 'temp', name: 'Temperature', data: points }]}
+ *   height={300}
+ * />
+ *
+ * // Advanced usage
+ * <AstroChart
+ *   type="line"
+ *   series={series}
+ *   yAxis={[
+ *     { name: 'Power [W]', position: 'left' },
+ *     { name: 'Battery [%]', position: 'right' },
+ *   ]}
+ *   zoom={{ enabled: true, type: 'both' }}
+ *   annotations={{ markLines: { data: [{ yAxis: 80, label: 'Threshold' }] }}}
+ * />
+ * ```
+ */
+export { AstroChart, default } from './AstroChart';
+export type { AstroChartHandle } from './AstroChart';
+export type { AstroChartProps, ChartType, ChartTheme, ChartStatus, DataPoint, TimeSeriesPoint, SeriesData, LineStyleOptions, AreaStyleOptions, GradientOptions, SymbolOptions, AxisOptions, ZoomOptions, TooltipOptions, LegendOptions, BrushOptions, InfoTooltipOptions, MarkLineOptions, MarkAreaOptions, AnnotationOptions, RealTimeOptions, ExportOptions, ExportFileNameContext, ChartEventParams, ZoomEventParams, BrushEventParams, ChartPreset, PowerChartData, AttitudeChartData, ThermalChartData, LinkBudgetChartData, TelemetryStreamPoint, ContactWindowData, SpectrumDataPoint, ManeuverBudgetData, EclipseTimelineData, BubbleDataPoint, RoseDiagramData, HeliocentricOrbitData, Data3DPoint, Scatter3DData, Bar3DData, Surface3DData, GlobeData, Lines3DData, WaterfallDataPoint, WaterfallSignalMarker, DopplerTrackPoint, SatellitePassInfo, LinkMarginPoint, CoverageGridData, ChartRegistry, ChartSyncGroup, ChartSyncOptions, } from './types';
+export { createAstroEChartsTheme, ASTRO_DATA_VIZ_COLORS, OFFICIAL_ASTRO_DATA_VIZ_COLORS, STATUS_COLORS, ZENDIR_BRAND_COLORS, getStatusColor, getSeriesColor, getPaletteForDataType, createAreaGradient, formatTimeLabel, formatValueWithUnit, calculateAxisBounds, } from './theme';
+export type { EChartsTheme } from './theme';
+export { LineChart, AreaChart, BarChart, ScatterChart, PieChart, DonutChart, GaugeChart, RadarChart, HeatmapChart, TimeSeriesChart, DualAxisChart, StackedAreaChart, StackedBarChart, BubbleChart, HistogramChart, SankeyChart, TreemapChart, SunburstChart, ParallelChart, CandlestickChart, GraphChart, BoxPlotChart, } from './presets';
+export type { LineChartProps, AreaChartProps, BarChartProps, ScatterChartProps, PieChartProps, GaugeChartProps, RadarChartProps, HeatmapChartProps, TimeSeriesChartProps, DualAxisChartProps, BubbleChartProps, HistogramChartProps, SankeyChartProps, TreemapChartProps, TreemapDataNode, SunburstChartProps, SunburstDataNode, ParallelChartProps, ParallelAxisDef, CandlestickChartProps, CandlestickDataPoint, GraphChartProps, GraphNode, GraphLink, GraphCategory, BoxPlotChartProps, BoxPlotDataPoint, } from './presets';
+export { PowerChart, AttitudeChart, ThermalHeatmapChart, LinkBudgetChart, SubsystemGauge, OrbitChart, ContactWindowChart, SpectrumChart, ManeuverBudgetChart, EclipseTimelineChart, RoseDiagram, HeliocentricOrbitPlot, Scatter3DChart, Bar3DChart, Surface3DChart, Lines3DChart, SphericalRadar3DChart, TransferOrbit3DChart, AttitudeHistory3DChart, ConjunctionAssessment3DChart, LaunchCorridor3DChart, AntennaPattern3DChart, WaterfallChart, DopplerTrackChart, LinkMarginChart, ConstellationCoverageChart, ConjunctionChart, } from './domain';
+export { generatePowerData, generateAttitudeData, generateDopplerData, generateWaterfallData, generateContactWindows, generateHeliocentricOrbits, generateSpectrum, generateEclipseTimeline, generateConstellationCoverage, generateConjunctionEvents, } from './generators';
+export type { PowerGeneratorConfig, AttitudeGeneratorConfig, DopplerGeneratorConfig, WaterfallGeneratorConfig, ContactGeneratorConfig, HeliocentricGeneratorConfig, SpectrumGeneratorConfig, EclipseGeneratorConfig, CoverageGeneratorConfig, ConjunctionGeneratorConfig, } from './generators';
+export { PowerOverviewChart, generateSamplePowerData, } from './PowerOverviewChart';
+export type { PowerOverviewChartProps, PowerTimelinePoint, PowerEvent, PowerState, OperationalMode, EventType, EventType as PowerEventType, } from './PowerOverviewChart';
+export type { PowerChartProps, AttitudeChartProps, ThermalHeatmapChartProps, LinkBudgetChartProps, SubsystemGaugeProps, OrbitChartProps, ContactWindowChartProps, SpectrumChartProps, ManeuverBudgetChartProps, EclipseTimelineChartProps, RoseDiagramProps, HeliocentricOrbitProps, Scatter3DChartProps, Bar3DChartProps, Surface3DChartProps, Lines3DChartProps, SphericalRadar3DChartProps, SphericalRadar3DData, TransferOrbit3DChartProps, TransferOrbitSegment, TransferOrbitWaypoint, AttitudeHistory3DChartProps, AttitudeHistoryPoint, ConjunctionAssessment3DChartProps, ConjunctionEvent, LaunchCorridor3DChartProps, LaunchCorridorData, AntennaPattern3DChartProps, AntennaPattern3DData, WaterfallChartProps, DopplerTrackChartProps, LinkMarginChartProps, ConstellationCoverageChartProps, ConjunctionChartProps, } from './domain';
+export { useChartStream, useWebSocketStream, } from './useChartStream';
+export type { StreamOptions, StreamController, WebSocketStreamOptions, WebSocketStreamController, } from './useChartStream';
+export { useChartSync, dispatchToGroup, syncZoomRange, resetGroupZoom, showGroupTooltip, hideGroupTooltip, getGroupCharts, exportGroupAsImages, exportGroupAsCSV, } from './sync';
+export type { UseChartSyncOptions } from './sync';

package/dist/react/charts/unified/presets.d.ts

@@ -0,0 +1,290 @@
+import { default as React } from 'react';
+import { AstroChartHandle } from './AstroChart';
+import { AstroChartProps, AxisOptions } from './types';
+
+type PresetProps = Omit<AstroChartProps, 'type'>;
+export interface LineChartProps extends PresetProps {
+    /** Enable smooth curves */
+    smooth?: boolean;
+    /** Show data points */
+    showPoints?: boolean;
+    /** Enable area fill */
+    showArea?: boolean;
+}
+export declare const LineChart: React.MemoExoticComponent<React.ForwardRefExoticComponent<LineChartProps & React.RefAttributes<AstroChartHandle>>>;
+export interface AreaChartProps extends PresetProps {
+    /** Stack areas */
+    stacked?: boolean;
+    /** Smooth curves */
+    smooth?: boolean;
+}
+export declare const AreaChart: React.MemoExoticComponent<React.ForwardRefExoticComponent<AreaChartProps & React.RefAttributes<AstroChartHandle>>>;
+export interface BarChartProps extends PresetProps {
+    /** Stack bars */
+    stacked?: boolean;
+    /** Horizontal orientation */
+    horizontal?: boolean;
+    /** Bar category gap */
+    categoryGap?: string;
+}
+export declare const BarChart: React.MemoExoticComponent<React.ForwardRefExoticComponent<BarChartProps & React.RefAttributes<AstroChartHandle>>>;
+export interface ScatterChartProps extends PresetProps {
+    /** Symbol size */
+    symbolSize?: number | ((value: number[]) => number);
+    /** Show regression line */
+    showRegression?: boolean;
+}
+export declare const ScatterChart: React.MemoExoticComponent<React.ForwardRefExoticComponent<ScatterChartProps & React.RefAttributes<AstroChartHandle>>>;
+export interface PieChartProps extends Omit<PresetProps, 'xAxis' | 'yAxis' | 'zoom'> {
+    /** Show as donut */
+    donut?: boolean;
+    /** Inner radius for donut (percentage) */
+    innerRadius?: string;
+    /** Outer radius (percentage) */
+    outerRadius?: string;
+    /** Show labels */
+    showLabels?: boolean;
+    /** Center content (for donut) */
+    centerContent?: React.ReactNode;
+}
+export declare const PieChart: React.MemoExoticComponent<React.ForwardRefExoticComponent<PieChartProps & React.RefAttributes<AstroChartHandle>>>;
+export declare const DonutChart: React.MemoExoticComponent<React.ForwardRefExoticComponent<PieChartProps & React.RefAttributes<AstroChartHandle>>>;
+export interface GaugeChartProps extends Omit<PresetProps, 'xAxis' | 'yAxis' | 'zoom' | 'series'> {
+    /** Current value */
+    value: number;
+    /** Minimum value */
+    min?: number;
+    /** Maximum value */
+    max?: number;
+    /** Unit label */
+    unit?: string;
+    /** Title label */
+    label?: string;
+    /** Threshold colors */
+    thresholds?: {
+        value: number;
+        color: string;
+    }[];
+    /** Show progress arc */
+    progress?: boolean;
+    /** Show clock-style pointer (needle). Set false for arc + value only. */
+    showPointer?: boolean;
+}
+export declare const GaugeChart: React.MemoExoticComponent<React.ForwardRefExoticComponent<GaugeChartProps & React.RefAttributes<AstroChartHandle>>>;
+export interface RadarChartProps extends Omit<PresetProps, 'xAxis' | 'yAxis' | 'zoom'> {
+    /** Indicator definitions */
+    indicators: {
+        name: string;
+        max: number;
+        min?: number;
+    }[];
+    /** Fill area */
+    areaStyle?: boolean;
+}
+export declare const RadarChart: React.MemoExoticComponent<React.ForwardRefExoticComponent<RadarChartProps & React.RefAttributes<AstroChartHandle>>>;
+export interface HeatmapChartProps extends PresetProps {
+    /** X-axis categories */
+    xCategories: string[];
+    /** Y-axis categories */
+    yCategories: string[];
+    /** Value range */
+    valueRange?: [number, number];
+    /** Show value labels */
+    showLabels?: boolean;
+}
+export declare const HeatmapChart: React.MemoExoticComponent<React.ForwardRefExoticComponent<HeatmapChartProps & React.RefAttributes<AstroChartHandle>>>;
+export interface TimeSeriesChartProps extends PresetProps {
+    /** Time window in milliseconds */
+    timeWindow?: number;
+    /** Maximum data points */
+    maxPoints?: number;
+    /** Auto-scroll to latest data */
+    autoScroll?: boolean;
+    /** Show current values */
+    showCurrentValues?: boolean;
+}
+export declare const TimeSeriesChart: React.MemoExoticComponent<React.ForwardRefExoticComponent<TimeSeriesChartProps & React.RefAttributes<AstroChartHandle>>>;
+export interface DualAxisChartProps extends PresetProps {
+    /** Left Y-axis options */
+    leftAxis?: AxisOptions;
+    /** Right Y-axis options */
+    rightAxis?: AxisOptions;
+}
+export declare const DualAxisChart: React.MemoExoticComponent<React.ForwardRefExoticComponent<DualAxisChartProps & React.RefAttributes<AstroChartHandle>>>;
+export declare const StackedAreaChart: React.MemoExoticComponent<React.ForwardRefExoticComponent<AreaChartProps & React.RefAttributes<AstroChartHandle>>>;
+export declare const StackedBarChart: React.MemoExoticComponent<React.ForwardRefExoticComponent<BarChartProps & React.RefAttributes<AstroChartHandle>>>;
+export interface BubbleChartProps extends PresetProps {
+    /** Min bubble size (px) */
+    minSize?: number;
+    /** Max bubble size (px) */
+    maxSize?: number;
+    /** Show size legend */
+    showSizeLegend?: boolean;
+}
+export declare const BubbleChart: React.MemoExoticComponent<React.ForwardRefExoticComponent<BubbleChartProps & React.RefAttributes<AstroChartHandle>>>;
+export interface HistogramChartProps extends PresetProps {
+    /** Number of bins (auto if not specified) */
+    bins?: number;
+    /** Show distribution curve overlay */
+    showCurve?: boolean;
+}
+export declare const HistogramChart: React.MemoExoticComponent<React.ForwardRefExoticComponent<HistogramChartProps & React.RefAttributes<AstroChartHandle>>>;
+export interface SankeyChartProps extends Omit<PresetProps, 'series'> {
+    /** Node definitions */
+    nodes: {
+        name: string;
+        itemStyle?: {
+            color?: string;
+        };
+    }[];
+    /** Link definitions */
+    links: {
+        source: string;
+        target: string;
+        value: number;
+    }[];
+    /** Orient vertical or horizontal */
+    orient?: 'horizontal' | 'vertical';
+}
+export declare const SankeyChart: React.MemoExoticComponent<React.ForwardRefExoticComponent<SankeyChartProps & React.RefAttributes<AstroChartHandle>>>;
+export interface TreemapDataNode {
+    name: string;
+    value?: number;
+    children?: TreemapDataNode[];
+    itemStyle?: {
+        color?: string;
+    };
+}
+export interface TreemapChartProps extends Omit<PresetProps, 'series'> {
+    /** Hierarchical data */
+    data: TreemapDataNode[];
+    /** Show breadcrumb navigation */
+    showBreadcrumb?: boolean;
+    /** Leaf depth to show */
+    leafDepth?: number;
+}
+export declare const TreemapChart: React.MemoExoticComponent<React.ForwardRefExoticComponent<TreemapChartProps & React.RefAttributes<AstroChartHandle>>>;
+export interface SunburstDataNode {
+    name: string;
+    value?: number;
+    children?: SunburstDataNode[];
+    itemStyle?: {
+        color?: string;
+    };
+}
+export interface SunburstChartProps extends Omit<PresetProps, 'series'> {
+    /** Hierarchical data */
+    data: SunburstDataNode[];
+    /** Inner radius (percentage or pixels) */
+    innerRadius?: string | number;
+    /** Outer radius (percentage or pixels) */
+    outerRadius?: string | number;
+}
+export declare const SunburstChart: React.MemoExoticComponent<React.ForwardRefExoticComponent<SunburstChartProps & React.RefAttributes<AstroChartHandle>>>;
+export interface ParallelAxisDef {
+    dim: number;
+    name: string;
+    min?: number;
+    max?: number;
+    type?: 'value' | 'category';
+    data?: string[];
+}
+export interface ParallelChartProps extends Omit<PresetProps, 'series'> {
+    /** Axis definitions */
+    axes: ParallelAxisDef[];
+    /** Data rows (each row is values for each axis) */
+    data: (number | string)[][];
+    /** Line style */
+    lineStyle?: {
+        opacity?: number;
+        width?: number;
+    };
+}
+export declare const ParallelChart: React.MemoExoticComponent<React.ForwardRefExoticComponent<ParallelChartProps & React.RefAttributes<AstroChartHandle>>>;
+export interface CandlestickDataPoint {
+    time: number | string;
+    open: number;
+    close: number;
+    low: number;
+    high: number;
+}
+export interface CandlestickChartProps extends Omit<PresetProps, 'series'> {
+    /** OHLC data */
+    data: CandlestickDataPoint[];
+    /** Show volume bars */
+    showVolume?: boolean;
+}
+export declare const CandlestickChart: React.MemoExoticComponent<React.ForwardRefExoticComponent<CandlestickChartProps & React.RefAttributes<AstroChartHandle>>>;
+export interface GraphNode {
+    id: string;
+    name: string;
+    value?: number;
+    category?: number;
+    symbolSize?: number;
+    x?: number;
+    y?: number;
+    itemStyle?: {
+        color?: string;
+    };
+}
+export interface GraphLink {
+    source: string;
+    target: string;
+    value?: number;
+    lineStyle?: {
+        width?: number;
+        color?: string;
+    };
+}
+export interface GraphCategory {
+    name: string;
+    itemStyle?: {
+        color?: string;
+    };
+}
+export interface GraphChartProps extends Omit<PresetProps, 'series'> {
+    /** Node definitions */
+    nodes: GraphNode[];
+    /** Link definitions */
+    links: GraphLink[];
+    /** Category definitions */
+    categories?: GraphCategory[];
+    /** Layout type */
+    layout?: 'force' | 'circular' | 'none';
+}
+export declare const GraphChart: React.MemoExoticComponent<React.ForwardRefExoticComponent<GraphChartProps & React.RefAttributes<AstroChartHandle>>>;
+export interface BoxPlotDataPoint {
+    /** Category name (x-axis label) */
+    name: string;
+    /** Raw data values for computing boxplot statistics */
+    values: number[];
+}
+export interface BoxPlotChartProps extends Omit<PresetProps, 'series'> {
+    /** Box plot data - each item contains a category name and array of values */
+    data: BoxPlotDataPoint[];
+    /** Show outliers as scatter points */
+    showOutliers?: boolean;
+    /** Custom colors for each box (uses theme palette if not provided) */
+    colors?: string[];
+    /** Horizontal orientation (default is vertical) */
+    horizontal?: boolean;
+}
+/**
+ * BoxPlotChart - Statistical distribution visualization
+ *
+ * Shows distribution of data through quartiles (box) and whiskers (range).
+ * Uses theme-aware colors from the data visualization palette.
+ *
+ * @example
+ * ```tsx
+ * <BoxPlotChart
+ *   title="Score Distribution"
+ *   data={[
+ *     { name: 'Team A', values: [65, 72, 84, 91, 55, 88, 76] },
+ *     { name: 'Team B', values: [78, 82, 95, 88, 70, 92, 85] },
+ *   ]}
+ * />
+ * ```
+ */
+export declare const BoxPlotChart: React.MemoExoticComponent<React.ForwardRefExoticComponent<BoxPlotChartProps & React.RefAttributes<AstroChartHandle>>>;
+export {};