@zendir/ui 0.1.0

package/dist/react/charts/GroundTrackMap.d.ts

@@ -0,0 +1,112 @@
+import { default as React } from 'react';
+import { GroundTrackPoint, GroundStation } from '../types';
+
+export interface SatelliteTrack {
+    /** Unique satellite identifier */
+    id: string;
+    /** Satellite display name */
+    name: string;
+    /** Ground track points */
+    groundTrack: GroundTrackPoint[];
+    /** Track color */
+    color?: string;
+    /** Satellite status for icon coloring */
+    status?: 'normal' | 'caution' | 'serious' | 'critical' | 'standby' | 'off';
+    /** Access mask (true = in contact) */
+    accessMask?: boolean[];
+    /** Show this satellite's sensor footprint */
+    showFootprint?: boolean;
+    /** Footprint radius in degrees (sensor cone half-angle on ground) */
+    footprintRadius?: number;
+    /** Show future (predicted) track as dashed line */
+    futureTrackIndex?: number;
+    /** AOS/LOS markers */
+    passMarkers?: Array<{
+        type: 'aos' | 'los';
+        latitude: number;
+        longitude: number;
+        label?: string;
+    }>;
+}
+export interface GroundStationEnhanced extends GroundStation {
+    /** Station status */
+    status?: 'normal' | 'caution' | 'serious' | 'critical' | 'standby' | 'off';
+    /** Show coverage circle */
+    showCoverage?: boolean;
+    /** Coverage radius in degrees (visibility horizon) */
+    coverageRadius?: number;
+    /** Station type (affects icon) */
+    type?: 'dish' | 'phased-array' | 'omni' | 'relay';
+}
+/**
+ * SRO-compatible team path format (space-range-operator CustomMap data shape).
+ * Provide this as an alternative to `satellites` for plug-and-play compatibility.
+ */
+export interface TeamPath {
+    /** Team/satellite name */
+    name: string;
+    /** Track color */
+    color?: string;
+    /** Ordered position array */
+    positions: Array<{
+        lat: number;
+        lng: number;
+        time?: number;
+        altitude?: number | null;
+    }>;
+}
+/** SRO-compatible ground station format */
+export interface SROGroundStation {
+    name: string;
+    latitude: number;
+    longitude: number;
+    altitude?: number | null;
+}
+export interface GroundTrackMapProps {
+    /** Single satellite ground track (legacy API) */
+    groundTrack?: GroundTrackPoint[];
+    /** Multiple satellite tracks */
+    satellites?: SatelliteTrack[];
+    /** Ground stations to display */
+    groundStations?: (GroundStation | GroundStationEnhanced | SROGroundStation)[];
+    /** Access mask for single-satellite mode (legacy API) */
+    accessMask?: boolean[];
+    /** Team path data (SRO CustomMap format) — auto-converts to satellites internally */
+    teamPaths?: TeamPath[];
+    /** Show day/night terminator */
+    showTerminator?: boolean;
+    /** Show grid lines */
+    showGrid?: boolean;
+    /** Show legend */
+    showLegend?: boolean;
+    /** Show equator highlight */
+    showEquator?: boolean;
+    /** Show recenter button (SRO compat) */
+    showRecenterButton?: boolean;
+    /** Whether data is still loading (SRO compat) */
+    isLoading?: boolean;
+    /** Message when there is no data (SRO compat) */
+    emptyMessage?: string;
+    /** Chart width (default: 100%) */
+    width?: number | string;
+    /** Chart height — number for fixed px, or CSS string like '100%' to fill a flex parent */
+    height?: number | string;
+    /** Minimum height CSS string (SRO compat, e.g. "400px") */
+    minHeight?: string;
+    /** Default center [lat, lon] (SRO compat) */
+    defaultCenter?: [number, number];
+    /** Default zoom level 1-10 (SRO compat, affects initial scale) */
+    defaultZoom?: number;
+    /** Custom className */
+    className?: string;
+    /** Click handler for satellites */
+    onSatelliteClick?: (satelliteId: string) => void;
+    /** Click handler for ground stations */
+    onStationClick?: (stationId: string) => void;
+    /** Map backend: 'leaflet' (default, requires leaflet peer) or 'canvas' */
+    mapProvider?: 'leaflet' | 'canvas';
+    /** Tile URL for Leaflet (default: CartoDB dark). Ignored when mapProvider is 'canvas'. */
+    tileUrl?: string;
+}
+export declare function GroundTrackMap({ groundTrack, satellites, groundStations, accessMask, teamPaths, showTerminator, showGrid, showLegend, showEquator, showRecenterButton, isLoading, emptyMessage, width, height, minHeight, defaultCenter, defaultZoom, className, onSatelliteClick, onStationClick, mapProvider, tileUrl, }: GroundTrackMapProps): React.ReactElement;
+export default GroundTrackMap;