@zendir/ui 0.1.0

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

@@ -0,0 +1,826 @@
+import { EChartsOption } from 'echarts';
+
+export type ChartType = 'line' | 'area' | 'bar' | 'scatter' | 'bubble' | 'pie' | 'donut' | 'gauge' | 'radar' | 'heatmap' | 'histogram' | 'gantt' | 'candlestick' | 'boxplot' | 'treemap' | 'sunburst' | 'funnel' | 'sankey' | 'waterfall' | 'rose';
+export type ChartTheme = 'astro-dark' | 'astro-light' | 'purple-hue';
+export interface DataPoint {
+    /** X-axis value (time, category, or number) */
+    x: number | string | Date;
+    /** Y-axis value */
+    y: number;
+    /** Optional label */
+    label?: string;
+    /** Optional category for grouping */
+    category?: string;
+    /** Optional color for this data point (used in pie/donut/histogram charts) */
+    color?: string;
+    /** Optional metadata */
+    meta?: Record<string, unknown>;
+}
+export interface TimeSeriesPoint {
+    /** Timestamp (Unix ms or Date) */
+    time: number | Date;
+    /** Value */
+    value: number;
+    /** Optional metadata */
+    meta?: Record<string, unknown>;
+}
+export interface SeriesData {
+    /** Unique series identifier */
+    id: string;
+    /** Display name */
+    name: string;
+    /** Data points (heatmap uses [x, y, value][]) */
+    data: DataPoint[] | TimeSeriesPoint[] | number[] | [number, number][] | [number, number, number][];
+    /** Series type override */
+    type?: ChartType;
+    /** Series color (uses theme palette if not specified) */
+    color?: string;
+    /** Y-axis index for dual-axis charts */
+    yAxisIndex?: number;
+    /** Line style options */
+    lineStyle?: LineStyleOptions;
+    /** Area style options */
+    areaStyle?: AreaStyleOptions;
+    /** Symbol/marker options */
+    symbol?: SymbolOptions;
+    /** Whether to show in legend */
+    showInLegend?: boolean;
+    /** Stack group name (for stacked charts) */
+    stack?: string;
+    /** Smooth line */
+    smooth?: boolean | number;
+    /**
+     * Property key for auto-configuration (e.g., 'temperature', 'battery')
+     * Auto-provides icon, unit, and thresholds from PROPERTY_PRESETS
+     */
+    property?: string;
+    /**
+     * Icon name to display in legend and tooltips
+     * Overrides property preset icon
+     */
+    icon?: string;
+    /**
+     * Unit of measurement (e.g., '°C', 'W', '%')
+     * Overrides property preset unit
+     */
+    unit?: string;
+    /**
+     * Status thresholds for auto-deriving status from latest value
+     * Overrides property preset thresholds
+     */
+    thresholds?: {
+        /** Value at or above which status becomes 'critical' */
+        critical?: number;
+        /** Value at or above which status becomes 'serious' */
+        serious?: number;
+        /** Value at or above which status becomes 'caution' */
+        caution?: number;
+        /** Value at or below which status becomes 'caution' */
+        cautionLow?: number;
+        /** Value at or below which status becomes 'critical' */
+        criticalLow?: number;
+    };
+    /**
+     * Override status (bypasses auto-derivation)
+     */
+    status?: 'off' | 'standby' | 'normal' | 'caution' | 'serious' | 'critical';
+}
+export interface LineStyleOptions {
+    width?: number;
+    type?: 'solid' | 'dashed' | 'dotted';
+    opacity?: number;
+    dashOffset?: number;
+}
+export interface AreaStyleOptions {
+    opacity?: number;
+    color?: string | GradientOptions;
+}
+export interface GradientOptions {
+    type: 'linear' | 'radial';
+    colorStops: Array<{
+        offset: number;
+        color: string;
+    }>;
+    direction?: 'vertical' | 'horizontal';
+}
+export interface SymbolOptions {
+    type?: 'circle' | 'rect' | 'roundRect' | 'triangle' | 'diamond' | 'pin' | 'arrow' | 'none';
+    size?: number | [number, number];
+    color?: string;
+    borderColor?: string;
+    borderWidth?: number;
+}
+export interface AxisOptions {
+    /** Axis type */
+    type?: 'value' | 'category' | 'time' | 'log';
+    /** Axis name/label */
+    name?: string;
+    /** Name location */
+    nameLocation?: 'start' | 'middle' | 'end';
+    /** Minimum value (auto if not specified) */
+    min?: number | 'auto' | 'dataMin';
+    /** Maximum value (auto if not specified) */
+    max?: number | 'auto' | 'dataMax';
+    /** Axis position */
+    position?: 'left' | 'right' | 'top' | 'bottom';
+    /** Show grid lines */
+    showGrid?: boolean;
+    /** Show axis line */
+    showLine?: boolean;
+    /** Show axis labels */
+    showLabels?: boolean;
+    /** Label formatter */
+    labelFormatter?: (value: number | string) => string;
+    /** Split number (approximate tick count) */
+    splitNumber?: number;
+    /** Inverse axis direction */
+    inverse?: boolean;
+    /** Unit suffix for labels */
+    unit?: string;
+    /** Split line (grid) options */
+    splitLine?: {
+        show?: boolean;
+    };
+}
+export interface ZoomOptions {
+    /** Enable zoom */
+    enabled?: boolean;
+    /** Zoom type */
+    type?: 'inside' | 'slider' | 'both';
+    /** Zoom axis */
+    axis?: 'x' | 'y' | 'both';
+    /** Initial zoom range (0-100) */
+    start?: number;
+    end?: number;
+    /** Minimum zoom span */
+    minSpan?: number;
+    /** Maximum zoom span */
+    maxSpan?: number;
+}
+export interface TooltipOptions {
+    /** Enable tooltip */
+    enabled?: boolean;
+    /** Trigger type */
+    trigger?: 'item' | 'axis' | 'none';
+    /** Show crosshair */
+    crosshair?: boolean | 'x' | 'y' | 'both';
+    /** Custom formatter */
+    formatter?: (params: unknown) => string;
+    /** Confine tooltip to chart area */
+    confine?: boolean;
+}
+export interface LegendOptions {
+    /** Show legend */
+    show?: boolean;
+    /** Legend position */
+    position?: 'top' | 'bottom' | 'left' | 'right';
+    /** Legend orientation */
+    orient?: 'horizontal' | 'vertical';
+    /** Allow clicking to toggle series */
+    interactive?: boolean;
+    /** Maximum items per row/column */
+    itemsPerLine?: number;
+}
+export interface BrushOptions {
+    /** Enable brush selection */
+    enabled?: boolean;
+    /** Brush type */
+    type?: 'rect' | 'polygon' | 'lineX' | 'lineY';
+    /** Brush mode */
+    mode?: 'single' | 'multiple';
+}
+export interface MarkLineOptions {
+    /** Mark line data */
+    data: Array<{
+        /** Line type */
+        type?: 'min' | 'max' | 'average' | 'median';
+        /** Fixed Y value */
+        yAxis?: number;
+        /** Fixed X value */
+        xAxis?: number | string;
+        /** Label */
+        label?: string;
+        /** Line style */
+        lineStyle?: LineStyleOptions;
+        /** Line color */
+        color?: string;
+    }>;
+}
+export interface MarkAreaOptions {
+    /** Mark area data */
+    data: Array<[
+        {
+            xAxis?: number | string;
+            yAxis?: number;
+            name?: string;
+        },
+        {
+            xAxis?: number | string;
+            yAxis?: number;
+        }
+    ]>;
+    /** Area style */
+    itemStyle?: {
+        color?: string;
+        opacity?: number;
+    };
+}
+export interface AnnotationOptions {
+    /** Mark lines (thresholds, averages) */
+    markLines?: MarkLineOptions;
+    /** Mark areas (regions, events) */
+    markAreas?: MarkAreaOptions;
+    /** Mark points */
+    markPoints?: Array<{
+        coord: [number | string, number];
+        name?: string;
+        symbol?: string;
+        symbolSize?: number;
+        itemStyle?: {
+            color?: string;
+        };
+    }>;
+}
+export interface RealTimeOptions {
+    /** Enable real-time mode */
+    enabled?: boolean;
+    /** Maximum data points to keep */
+    maxPoints?: number;
+    /** Time window in milliseconds */
+    timeWindow?: number;
+    /** Animation duration for updates */
+    animationDuration?: number;
+    /** Whether to shift data (sliding window) */
+    shift?: boolean;
+}
+/** Context passed to getExportFileName for dynamic filename generation */
+export interface ExportFileNameContext {
+    /** Chart title */
+    title?: string;
+    /** Chart subtitle */
+    subtitle?: string;
+    /** Series display names in order */
+    seriesNames: string[];
+    /** Chart type (line, area, bar, etc.) */
+    chartType: string;
+}
+export interface ExportOptions {
+    /** Enable export button */
+    enabled?: boolean;
+    /** Export formats (png, jpeg, svg for image; csv, json for data) */
+    formats?: ('png' | 'jpeg' | 'jpg' | 'svg' | 'csv' | 'json')[];
+    /** Static file name prefix (overridden by getExportFileName if provided) */
+    fileName?: string;
+    /** Dynamic filename from chart title, series names, and type */
+    getExportFileName?: (context: ExportFileNameContext) => string;
+    /** Image scale factor */
+    pixelRatio?: number;
+    /** Background color for export */
+    backgroundColor?: string;
+}
+/**
+ * Info tooltip configuration for chart header
+ * Shows an info icon (ⓘ) in top-right corner that reveals helpful information
+ */
+export interface InfoTooltipOptions {
+    /** Tooltip content - can be string or React node */
+    content: string | React.ReactNode;
+    /** Custom icon (defaults to info circle) */
+    icon?: React.ReactNode;
+    /** Tooltip position */
+    position?: 'top' | 'bottom' | 'left' | 'right';
+    /** Maximum width of tooltip content */
+    maxWidth?: number;
+}
+/** Status types for chart header icon */
+export type ChartStatus = 'off' | 'standby' | 'normal' | 'caution' | 'serious' | 'critical';
+export interface AstroChartProps {
+    /** Chart type */
+    type: ChartType;
+    /** Series data */
+    series: SeriesData[];
+    /** Chart title */
+    title?: string;
+    /** Chart subtitle */
+    subtitle?: string;
+    /**
+     * Icon name to display in chart header (uses AstroIcon)
+     * Shows before the chart title
+     */
+    icon?: string;
+    /**
+     * Status for the header icon (shows as colored dot)
+     * Uses AstroUXDS status colors
+     */
+    iconStatus?: ChartStatus;
+    /**
+     * Status message shown on hover over the status icon
+     */
+    statusMessage?: string;
+    /**
+     * Show status badge in header (for bold/minimal themes)
+     * Displays status label text alongside the accent line
+     * @default false
+     */
+    showStatusBadge?: boolean;
+    /** Chart width (default: 100%) */
+    width?: number | string;
+    /** Chart height (default: 400px) */
+    height?: number | string;
+    /** X-axis options */
+    xAxis?: AxisOptions;
+    /** Y-axis options (single or array for dual axis) */
+    yAxis?: AxisOptions | AxisOptions[];
+    /** Tooltip options */
+    tooltip?: TooltipOptions;
+    /** Legend options */
+    legend?: LegendOptions;
+    /** Zoom/pan options */
+    zoom?: ZoomOptions;
+    /** Brush selection options */
+    brush?: BrushOptions;
+    /** Annotations (mark lines, areas, points) */
+    annotations?: AnnotationOptions;
+    /** Real-time streaming options */
+    realTime?: RealTimeOptions;
+    /** Export options */
+    export?: ExportOptions;
+    /** Loading state */
+    loading?: boolean;
+    /** Empty state message */
+    emptyMessage?: string;
+    /** Theme override */
+    theme?: ChartTheme;
+    /**
+     * Info tooltip shown as ⓘ icon in top-right corner
+     * SDK developers can define this to provide contextual help
+     */
+    infoTooltip?: InfoTooltipOptions;
+    /**
+     * Hide chart axes (useful for pie, donut, gauge, radar)
+     * When true, removes axis lines, labels, and grid
+     */
+    hideAxes?: boolean;
+    /**
+     * Compact axis mode - hides axis name labels by default for more chart space.
+     * Axis names are shown on hover tooltip instead.
+     * Set to false to always show axis name labels.
+     * @default true
+     */
+    compactAxes?: boolean;
+    /** Custom ECharts options (advanced) */
+    echartsOptions?: Partial<EChartsOption>;
+    /**
+     * ECharts renderer: 'svg' gives sharper text (recommended); 'canvas' can be faster for very large datasets.
+     * @default 'svg'
+     */
+    renderer?: 'canvas' | 'svg';
+    /** Chart instance ref callback */
+    onChartReady?: (chart: unknown) => void;
+    /** Click handler */
+    onClick?: (params: ChartEventParams) => void;
+    /** Hover handler */
+    onHover?: (params: ChartEventParams) => void;
+    /** Zoom change handler */
+    onZoomChange?: (params: ZoomEventParams) => void;
+    /** Brush selection handler */
+    onBrushSelect?: (params: BrushEventParams) => void;
+    /** Custom CSS class */
+    className?: string;
+    /** Custom inline styles */
+    style?: React.CSSProperties;
+    /** ARIA label for accessibility */
+    ariaLabel?: string;
+}
+export interface ChartEventParams {
+    /** Event type */
+    type: string;
+    /** Series index */
+    seriesIndex?: number;
+    /** Series name */
+    seriesName?: string;
+    /** Data index */
+    dataIndex?: number;
+    /** Data value */
+    value?: number | string | number[];
+    /** Data name */
+    name?: string;
+    /** Original event */
+    event?: MouseEvent;
+}
+export interface ZoomEventParams {
+    /** Start percentage (0-100) */
+    start: number;
+    /** End percentage (0-100) */
+    end: number;
+    /** Start value */
+    startValue?: number | string;
+    /** End value */
+    endValue?: number | string;
+}
+export interface BrushEventParams {
+    /** Selected areas */
+    areas: Array<{
+        coordRange: [number, number][];
+        coordRanges: [number, number][][];
+    }>;
+    /** Selected series data */
+    selected: Array<{
+        seriesIndex: number;
+        dataIndex: number[];
+    }>;
+}
+export interface ChartPreset {
+    /** Preset name */
+    name: string;
+    /** Base chart type */
+    type: ChartType;
+    /** Default options */
+    defaults: Partial<AstroChartProps>;
+    /** Series transformer */
+    transformSeries?: (series: SeriesData[]) => SeriesData[];
+    /** Options transformer */
+    transformOptions?: (options: EChartsOption) => EChartsOption;
+}
+/** Power system chart data */
+export interface PowerChartData {
+    time: number;
+    solarPower: number;
+    batteryPercent: number;
+    netPower: number;
+    consumption: number;
+    eclipse?: boolean;
+    voltage?: number;
+}
+/** Attitude chart data */
+export interface AttitudeChartData {
+    time: number;
+    roll: number;
+    pitch: number;
+    yaw: number;
+    pointingError?: number;
+    angularVelocity?: number;
+}
+/** Thermal chart data */
+export interface ThermalChartData {
+    time: number;
+    zones: Record<string, number>;
+    averageTemp?: number;
+}
+/** Link budget chart data */
+export interface LinkBudgetChartData {
+    time: number;
+    signalStrength: number;
+    noiseFloor: number;
+    margin: number;
+    elevation?: number;
+}
+/** Telemetry stream point */
+export interface TelemetryStreamPoint {
+    timestamp: number;
+    parameter: string;
+    value: number;
+    unit?: string;
+    /** Status using AstroUXDS terminology */
+    status?: 'normal' | 'caution' | 'serious' | 'critical';
+}
+/** Contact window / pass data (Gantt-style) */
+export interface ContactWindowData {
+    /** Ground station or asset ID */
+    id: string;
+    /** Display name */
+    name: string;
+    /** Contact windows */
+    windows: {
+        start: number;
+        end: number;
+        elevation?: number;
+        signalQuality?: 'good' | 'marginal' | 'poor';
+        label?: string;
+    }[];
+}
+/** Spectrum / waterfall data point */
+export interface SpectrumDataPoint {
+    /** Frequency bin (Hz or normalized) */
+    frequency: number;
+    /** Power/amplitude (dBm or dB) */
+    power: number;
+    /** Timestamp for waterfall */
+    time?: number;
+}
+/** Maneuver / delta-V budget data */
+export interface ManeuverBudgetData {
+    /** Maneuver name */
+    name: string;
+    /** Delta-V (m/s) */
+    deltaV: number;
+    /** Type category */
+    type: 'planned' | 'executed' | 'remaining' | 'margin';
+    /** Optional date */
+    date?: number;
+}
+/** Eclipse / sunlight timeline data */
+export interface EclipseTimelineData {
+    /** Start time (ms) */
+    start: number;
+    /** End time (ms) */
+    end: number;
+    /** Eclipse type */
+    type: 'umbra' | 'penumbra' | 'sunlight';
+    /** Orbit number */
+    orbitNumber?: number;
+}
+/** Bubble chart data point */
+export interface BubbleDataPoint {
+    /** X value */
+    x: number | string | Date;
+    /** Y value */
+    y: number;
+    /** Bubble size */
+    size: number;
+    /** Optional color category */
+    category?: string;
+    /** Label */
+    label?: string;
+}
+/** Rose diagram data (polar histogram for directional data) */
+export interface RoseDiagramData {
+    /** Direction/angle (degrees, 0-360) */
+    direction: number;
+    /** Magnitude/frequency */
+    magnitude: number;
+    /** Optional category label */
+    category?: string;
+}
+/** Heliocentric orbit data */
+export interface HeliocentricOrbitData {
+    /** Body/spacecraft name */
+    name: string;
+    /** X coordinate (AU or km) */
+    x: number;
+    /** Y coordinate (AU or km) */
+    y: number;
+    /** Z coordinate (AU or km) - for 3D visualization */
+    z?: number;
+    /** Orbit path points (for ellipse) - 2D or 3D */
+    orbitPath?: {
+        x: number;
+        y: number;
+        z?: number;
+    }[];
+    /** Body type */
+    type?: 'planet' | 'spacecraft' | 'comet' | 'asteroid' | 'satellite' | 'station' | 'probe' | 'debris';
+    /** Optional color */
+    color?: string;
+    /** Optional size */
+    size?: number;
+    /** Optional description/metadata for tooltip */
+    description?: string;
+    /** Semi-major axis (AU) - for orbital info */
+    semiMajorAxis?: number;
+    /** Orbital period (days) */
+    period?: number;
+    /** Inclination (degrees) - for 3D orbit tilt */
+    inclination?: number;
+}
+/** 3D data point for scatter3D, bar3D, etc. */
+export interface Data3DPoint {
+    /** X coordinate */
+    x: number;
+    /** Y coordinate */
+    y: number;
+    /** Z coordinate */
+    z: number;
+    /** Optional value (for color mapping, sizing) */
+    value?: number;
+    /** Optional label */
+    label?: string;
+    /** Optional category */
+    category?: string;
+    /** Optional color override */
+    color?: string;
+    /** Optional size override */
+    size?: number;
+    /** Optional metadata */
+    meta?: Record<string, unknown>;
+}
+/** Scatter3D chart data - for constellation visualization, debris fields */
+export interface Scatter3DData {
+    /** Unique identifier */
+    id: string;
+    /** Display name */
+    name: string;
+    /** 3D data points */
+    data: Data3DPoint[];
+    /** Optional symbol size (or function) */
+    symbolSize?: number | ((value: number[]) => number);
+    /** Optional color (or gradient) */
+    color?: string;
+    /** Category for grouping */
+    category?: string;
+}
+/** Bar3D chart data - for telemetry comparisons across satellites/time */
+export interface Bar3DData {
+    /** X-axis value (category: satellite name, subsystem, etc.) */
+    x: string | number;
+    /** Y-axis value (category: time period, parameter, etc.) */
+    y: string | number;
+    /** Z-axis value (height/magnitude) */
+    z: number;
+    /** Optional color */
+    color?: string;
+    /** Optional label */
+    label?: string;
+}
+/** Surface3D chart data - for signal strength maps, thermal surfaces */
+export interface Surface3DData {
+    /** 2D array of z-values [x][y] -> z */
+    data: number[][];
+    /** X-axis range [min, max] */
+    xRange?: [number, number];
+    /** Y-axis range [min, max] */
+    yRange?: [number, number];
+    /** Color map name */
+    colorMap?: 'jet' | 'viridis' | 'plasma' | 'inferno' | 'magma' | 'thermal' | 'custom';
+    /** Custom color stops for 'custom' colorMap */
+    colorStops?: Array<{
+        offset: number;
+        color: string;
+    }>;
+    /** Wireframe mode */
+    wireframe?: boolean;
+}
+/** Globe chart data - for Earth visualization with satellites */
+export interface GlobeData {
+    /** Satellites/objects in orbit */
+    satellites?: Array<{
+        id: string;
+        name: string;
+        latitude: number;
+        longitude: number;
+        altitude: number;
+        color?: string;
+        size?: number;
+        category?: string;
+    }>;
+    /** Ground stations */
+    groundStations?: Array<{
+        id: string;
+        name: string;
+        latitude: number;
+        longitude: number;
+        color?: string;
+        size?: number;
+    }>;
+    /** Ground tracks (satellite paths) */
+    groundTracks?: Array<{
+        id: string;
+        name: string;
+        path: Array<{
+            latitude: number;
+            longitude: number;
+        }>;
+        color?: string;
+    }>;
+    /** Coverage areas (footprints) */
+    coverageAreas?: Array<{
+        id: string;
+        name: string;
+        polygon: Array<{
+            latitude: number;
+            longitude: number;
+        }>;
+        color?: string;
+        opacity?: number;
+    }>;
+    /** Communication/link lines */
+    links?: Array<{
+        from: {
+            latitude: number;
+            longitude: number;
+            altitude?: number;
+        };
+        to: {
+            latitude: number;
+            longitude: number;
+            altitude?: number;
+        };
+        color?: string;
+        lineWidth?: number;
+    }>;
+}
+/** Lines3D chart data - for debris trajectories, satellite links */
+export interface Lines3DData {
+    /** Unique identifier */
+    id: string;
+    /** Display name */
+    name: string;
+    /** 3D path points */
+    path: Array<{
+        x: number;
+        y: number;
+        z: number;
+    }>;
+    /** Line color */
+    color?: string;
+    /** Line width */
+    lineWidth?: number;
+    /** Line style */
+    lineStyle?: 'solid' | 'dashed' | 'dotted';
+    /** Show endpoints */
+    showEndpoints?: boolean;
+    /** Category for grouping */
+    category?: string;
+}
+export interface ChartRegistry {
+    presets: Map<string, ChartPreset>;
+    themes: Map<string, unknown>;
+    register: (name: string, preset: ChartPreset) => void;
+    get: (name: string) => ChartPreset | undefined;
+}
+export interface ChartSyncGroup {
+    /** Group ID */
+    id: string;
+    /** Chart instances */
+    charts: Set<unknown>;
+    /** Sync tooltip */
+    syncTooltip?: boolean;
+    /** Sync zoom */
+    syncZoom?: boolean;
+    /** Sync crosshair */
+    syncCrosshair?: boolean;
+}
+export interface ChartSyncOptions {
+    /** Group ID to join */
+    groupId?: string;
+    /** Sync features */
+    sync?: {
+        tooltip?: boolean;
+        zoom?: boolean;
+        crosshair?: boolean;
+    };
+}
+/** Single data point for waterfall/spectrogram display */
+export interface WaterfallDataPoint {
+    /** Timestamp */
+    time: number | Date;
+    /** Frequency values (Hz) */
+    frequencies: number[];
+    /** Power levels (dBm) at each frequency */
+    powers: number[];
+}
+/** Signal marker for waterfall display */
+export interface WaterfallSignalMarker {
+    /** Marker ID */
+    id: string;
+    /** Frequency (Hz) */
+    frequency: number;
+    /** Bandwidth (Hz) */
+    bandwidth?: number;
+    /** Signal name/label */
+    label: string;
+    /** Marker color */
+    color?: string;
+}
+/** Doppler track data point */
+export interface DopplerTrackPoint {
+    /** Timestamp */
+    time: number | Date;
+    /** Doppler shift (Hz) */
+    dopplerShift: number;
+    /** Optional elevation angle */
+    elevation?: number;
+}
+/** Satellite pass info for Doppler tracking */
+export interface SatellitePassInfo {
+    /** Satellite name */
+    name: string;
+    /** Acquisition of signal */
+    aos: Date;
+    /** Loss of signal */
+    los: Date;
+    /** Time of closest approach */
+    tca?: Date;
+    /** Max elevation angle */
+    maxElevation?: number;
+}
+/** Link margin data point */
+export interface LinkMarginPoint {
+    /** Elevation angle (degrees) */
+    elevation: number;
+    /** Uplink margin (dB) */
+    uplinkMargin?: number;
+    /** Downlink margin (dB) */
+    downlinkMargin?: number;
+}
+/** Coverage grid data for constellation coverage analysis */
+export interface CoverageGridData {
+    /** Latitude values */
+    latitudes: number[];
+    /** Longitude values */
+    longitudes: number[];
+    /** Coverage values (2D array) */
+    coverage: number[][];
+    /** Unit for coverage values */
+    unit?: string;
+}