spacemap 0.1.14 → 0.1.16

package/index.d.ts

@@ -390,8 +390,9 @@ export declare interface ElementsOptions {
     /** What the orbit is round; the Sun when left out. */
     body?: string;
     /** The export's own elements: `a` in astronomical units, angles in degrees,
-     *  `n` in degrees a day, `epoch` a Julian date. Set `equatorial` when the
-     *  angles are referenced to Earth's equator rather than the ecliptic. */
+     *  `n` in degrees a day, `epoch` a Julian date in TDB. Set `equatorial` when
+     *  the angles are referenced to Earth's equator rather than the ecliptic, as
+     *  in a TLE: `epoch` is then in UTC, as the TLE gives it. */
     elements: OrbitalElements;
 }
 
@@ -1237,9 +1238,10 @@ export declare interface Neighbours {
     next: Neighbour | null;
 }
 
-/** The entries before and after `current` on the same mission's traverse.
- *  The list is already mission-then-time ordered, so neighbours are adjacent
- *  rows until the mission changes. */
+/** The nearest entries before and after `current` on the same mission's
+ *  traverse that stand somewhere else. A rover often shoots many mosaics at
+ *  one stop, so the adjacent rows of the mission-then-time list are mostly
+ *  the same spot. */
 export declare function neighboursOf(entries: PanoramaEntry[], current: PanoramaEntry, radiusKm: number): Neighbours;
 
 export declare type Notice = OutOfRangeNotice | CoveragePauseNotice;
@@ -1265,6 +1267,8 @@ export declare interface OrbitalElements {
     w: number;
     ma: number;
     n: number;
+    /** Julian date of the elements: UTC for TLE elements (`equatorial`), as the
+     *  TLE gives it; TDB for the others, as the ephemerides give it. */
     epoch: number;
     /**
      * Secular drift rates (deg/day) applied to om and w. Populated for SPICE
@@ -1275,6 +1279,8 @@ export declare interface OrbitalElements {
     omDot?: number;
     wDot?: number;
     q?: number;
+    /** Julian date of perihelion passage, on the time scale of `epoch`. Only for
+     *  parabolic orbits. */
     tp?: number;
     /**
      * True when i/om/w are referenced to Earth's mean equator of J2000 instead of
@@ -1361,7 +1367,7 @@ export declare interface PanoramaEntry {
      *  `unknown` means the sphere sits at an arbitrary azimuth, so nothing
      *  may be drawn or written as a heading. The full set `export/panoramas.py`
      *  writes — a wider union would erase the literals and stop checking. */
-    orientation?: 'unknown' | 'caption-aligned' | 'matched to an archival sphere';
+    orientation?: 'unknown' | 'caption-aligned' | 'matched to an archival sphere' | 'matched to a controlled mosaic';
     /** `estimated` where the sphere's angular bounds were fitted to a
      *  published flat image rather than read from an archive label. */
     geometry?: 'estimated';
@@ -1459,13 +1465,14 @@ export declare class PanoramaView {
     /** Every panorama of the body, mission by mission in time order. */
     getPanoramas(): readonly PanoramaEntry[];
     getCurrent(): PanoramaEntry | null;
-    /** The panoramas before and after the current one on its traverse. */
+    /** The nearest panoramas before and after the current one that stand
+     *  elsewhere on its traverse. */
     getNeighbours(): Neighbours | null;
     /** Show a panorama: an entry from the list, its id, or its `time,lat,lon`
      *  key. Resolves once it is on screen; a newer call supersedes one still
      *  in flight. */
     open(target: PanoramaEntry | string): Promise<void>;
-    /** Open the previous or next panorama on the traverse, when there is one. */
+    /** Open the previous or next neighbour on the traverse, when there is one. */
     step(key: ArrowKey): Promise<void>;
     private byKey;
     getView(): PanoramaViewState;
@@ -1956,6 +1963,15 @@ export declare class SpaceMap {
      *  body not loaded, and until the map has read how it spins, which it does
      *  once the camera is on the body or its system. */
     getSubsolarPoint(id: string): LonLat | null;
+    /** Whether this map draws surface tiles at all. False where no tile host is
+     *  set, and on a device short of memory: every body then shows its
+     *  whole-globe maps alone, and close up they go soft. */
+    tilesEnabled(): boolean;
+    /** Whether tiles sharpen `id`'s surface up close. False for a body without
+     *  a tile pyramid this embed may draw, one that is a shape model up close,
+     *  and one whose tiles the tile host has failed. Read from the body's own
+     *  data, so the answer does not wait for the camera to get there. */
+    hasTiles(id: string): Promise<boolean>;
     /* Excluded from this release type: load */
     /* Excluded from this release type: open */
     private openOnce;
@@ -2254,6 +2270,7 @@ export declare class SystemMap {
     private readonly names;
     private readonly grouping;
     private readonly zones;
+    private readonly rings;
     private readonly places;
     private targets;
     /** Bundles read for the bodies no map file places, by id; null where the
@@ -2335,6 +2352,12 @@ export declare interface SystemMapOptions {
     /** `inner-outer` turns the two belts into the doors of the two zones of
      *  small bodies; `belts` leaves them the scenery they are. */
     zones?: 'belts' | 'inner-outer';
+    /** `visible` spans a planetary system's rings band over only the rings
+     *  {@link createMap} shows: Saturn's stops at the F ring rather than the
+     *  E ring, and Jupiter's and Neptune's, too faint to see, have no band. It
+     *  reads the primary's bundle and ring profiles. `all`, the default, spans
+     *  every ring. */
+    rings?: 'all' | 'visible';
 }
 
 /**