spacemap 0.1.20 → 0.1.22

package/index.d.ts

@@ -4,6 +4,18 @@ export declare type Anchor = InertialAnchor | SurfaceAnchor;
 
 export declare type ArrowKey = 'previous' | 'next';
 
+/**
+ * A body drawn as a sphere wears an artist's impression, not a picture of it.
+ * Sent again when the body it speaks of changes, and dismissed once no such
+ * sphere is in view.
+ */
+export declare interface ArtistImpressionNotice {
+    topic: 'artist-impression';
+    /** The body: the focused one when it wears an impression, else the
+     *  nearest that does. */
+    id: string;
+}
+
 /** Boot-time benchmark result (see perf/atmosphere-calibration.ts). */
 declare interface AtmosphereCalibration {
     /** GPU + resolution identity the run is valid for — a mismatch re-calibrates. */
@@ -95,6 +107,18 @@ export declare type BodyType = 'barycenter' | 'lagrange-point' | 'star' | 'plane
  *  the edges are walked and left for {@link pathFor} to fill in. */
 export declare function boxRing(latMin: number, latMax: number, lonMin: number, lonSpan: number): LonLat[];
 
+/**
+ * How the view is turned off looking straight down at the place, in degrees.
+ * Close to a surface only: from half a radius up the turn the map allows
+ * shrinks, and from one radius up the view is level.
+ */
+export declare interface CameraAngles {
+    /** Off the vertical toward the horizon: 0 looks straight down. */
+    pitch?: number;
+    /** Clockwise from the north the map keeps up. */
+    bearing?: number;
+}
+
 /** A suspension of the map's own camera control, for as long as it is held. */
 export declare interface CameraHold {
     /** Put the camera at `pose` from the next frame on. Call it from the map's
@@ -155,7 +179,7 @@ export declare interface CameraPose {
 
 /** The camera as it stands. `body` is what it orbits, which is also what the
  *  map draws in most detail. */
-export declare interface CameraState {
+export declare interface CameraState extends Required<CameraAngles> {
     body: string;
     lat: number;
     lon: number;
@@ -292,6 +316,8 @@ export declare interface CoreMessages {
     attribution_imagery: () => string;
     attribution_stars: () => string;
     attribution_constellations: () => string;
+    attribution_galaxy: () => string;
+    attribution_galaxy_model: () => string;
     credits_see_all: () => string;
     layer_surface: () => string;
     layer_clouds: () => string;
@@ -316,9 +342,10 @@ export declare interface CoreMessages {
 }
 
 /**
- * Conditions the scene reports while it runs: the clock has left the data, or
- * it stopped at a probe's data wall. Raw dates and ids, never sentences — the
- * page around the map words them and decides how they are shown.
+ * Conditions the scene reports while it runs: the clock has left the data, it
+ * stopped at a probe's data wall, or a sphere in view wears an artist's
+ * impression. A notice holds raw dates and ids, not sentences. The page
+ * around the map words them and decides how to show them.
  */
 /** A coverage edge the clock has crossed, and where it lies. */
 export declare interface CoverageEdge {
@@ -414,6 +441,7 @@ export declare interface FeatureRef {
     /** Planetographic degrees, IAU convention. */
     lat: number;
     lon: number;
+    /** IAU diameter in metres; 0 when it gives none. */
     diameterM: number;
 }
 
@@ -1032,7 +1060,7 @@ export declare function jdToDate(jd: number): Date;
 
 /** The same, for a move that does not animate: framing a body against another
  *  one only makes sense as a placement, never as a flight. */
-export declare interface JumpTarget extends CameraTarget {
+export declare interface JumpTarget extends CameraTarget, CameraAngles {
     /** Put this other body — the Sun, usually — behind the one being framed. */
     facing?: string;
     /** How far above the ecliptic to look from, in degrees. */
@@ -1268,7 +1296,7 @@ export declare interface Neighbours {
  *  the same spot. */
 export declare function neighboursOf(entries: PanoramaEntry[], current: PanoramaEntry, radiusKm: number): Neighbours;
 
-export declare type Notice = OutOfRangeNotice | CoveragePauseNotice;
+export declare type Notice = OutOfRangeNotice | CoveragePauseNotice | ArtistImpressionNotice;
 
 export declare type NoticeTopic = Notice['topic'];
 
@@ -1328,9 +1356,12 @@ export declare interface OutOfRangeNotice {
     } | {
         side: 'gap';
     } | null;
-    majorBodies: CoverageEdge | {
-        side: 'outside';
-    } | null;
+    /** The edge of the ephemeris itself, once the date is past it: no planet or
+     *  moon has data. */
+    majorBodies: CoverageEdge | null;
+    /** One entry per edge crossed, by date. Bodies on the side of a crossed
+     *  `majorBodies` edge are left out: that edge already says why. */
+    bodies: UncoveredBodies[];
 }
 
 /** The sky of a page. It leaves the reader's own layer settings alone. */
@@ -1414,7 +1445,14 @@ export declare interface PanoramaEntry {
     /** Image azimuth where the observed span begins, with its width; absent
      *  when the archive label carried no coverage geometry. */
     azimuth_start_deg?: number;
+    /** Width of the mosaic's frame, which can hold far less than it spans:
+     *  read `horizon_deg` for what the sphere shows. */
     hfov_deg?: number;
+    /** Degrees of azimuth where the sphere's pixels hold the horizon. Zero for
+     *  a ring of ground. A mosaic with no real gap in its horizon reads 340 or
+     *  more. Tilt is taken out on most of a turn only, so a tilted arc reads
+     *  short. */
+    horizon_deg?: number;
     /** Solid-angle share of the sphere the mosaic covers, percent. */
     sphere_percent?: number;
     color?: string;
@@ -1831,6 +1869,9 @@ export declare interface SceneSettings {
     highAmbient: boolean;
     realisticLighting: boolean;
     overexposeRings: boolean;
+    /** The glow reads the grid's coarse copies where a sample is wider than a
+     *  cell. Debug only. */
+    glowCoarseReads?: boolean;
     showShapeMesh: boolean;
     showSurfaceTexture: boolean;
     showDisplacement: boolean;
@@ -1989,6 +2030,9 @@ export declare class SpaceMap {
     private pendingFocusId;
     /** The first load, started once. */
     private opening;
+    /** The camera is on the opening view; the map shows once it stops moving. */
+    private openingPlaced;
+    private openingShown;
     /** Counts navigations: a later one supersedes an earlier one still on its way. */
     private navigation;
     /** Retires the host's hold on the camera. Kept so that a second hold, or
@@ -2017,7 +2061,8 @@ export declare class SpaceMap {
     /** Kilometres between two places, as the last frame drew them: a body's
      *  centre, a point on its surface, anything an anchor names. Null while
      *  either end is on a body this map has not loaded, or one that is nowhere
-     *  at that date. */
+     *  at that date, and while a point on a surface is on a body that may yet
+     *  turn (see {@link getSubsolarPoint}). */
     distanceKm(from: Anchor, to: Anchor): number | null;
     /** The same measure with its direction kept: from one place to the other,
      *  in kilometres on ecliptic J2000 axes. What a held camera's `up` is made
@@ -2026,7 +2071,10 @@ export declare class SpaceMap {
     /** Where on `id` the Sun is overhead, as the last frame drew it: the middle
      *  of the lit half, in the frame a surface anchor is placed in. Null for a
      *  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. */
+     *  once the camera is on the body or its system. On a bad line that can
+     *  take longer: a moon's spin can come before the file of the terms that
+     *  sway it, and the map asks for that file again until it has it, or the
+     *  data host says it has none. */
     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
@@ -2041,6 +2089,8 @@ export declare class SpaceMap {
     /* Excluded from this release type: open */
     private openOnce;
     /* Excluded from this release type: applyInitialView */
+    /* Excluded from this release type: showOpeningView */
+    private revealWhenSettled;
     /* Excluded from this release type: mount */
     /** Hang a control in one of the map's corners; top-right unless the control
      *  or the caller names another. Adding the same control twice does nothing. */
@@ -2145,6 +2195,8 @@ export declare class SpaceMap {
     /* Excluded from this release type: snapToBodyFrom */
     /* Excluded from this release type: snapToBodyFacing */
     /* Excluded from this release type: tripView */
+    /* Excluded from this release type: tripBallView */
+    private vantageView;
     /* Excluded from this release type: focusOnFeature */
     /* Excluded from this release type: setFocusTarget */
     /** Where the camera is and what it orbits, as anchors a host can store,
@@ -2237,7 +2289,7 @@ export declare interface SpaceMapOptions {
     date?: Date;
     live?: boolean;
     /** Where the map opens. */
-    view?: CameraOptions;
+    view?: CameraOptions & CameraAngles;
     /** Whether the reader may move the map at all. True unless it is said
      *  otherwise; false switches every gesture off. */
     interactive?: boolean;
@@ -2518,6 +2570,16 @@ export declare interface TrajectorySample {
     km: OffsetKm;
 }
 
+/** Planets and moons past their own kernels, which end before the ephemeris
+ *  does. `outside`: the date is in a hole between two of their spans. */
+export declare type UncoveredBodies = (CoverageEdge | {
+    side: 'outside';
+}) & {
+    ids: string[];
+    /** Their names, in the order of `ids`. */
+    names: string[];
+};
+
 export declare interface VectorLayer {
     readonly kind: 'vector';
     id: string;