spacemap 0.1.16 → 0.1.18

package/index.d.ts

@@ -1104,6 +1104,12 @@ export declare interface MapEvents {
     loading: (loading: boolean) => void;
     /** Boot progress, 0 to 1, monotonic within one load. */
     progress: (fraction: number) => void;
+    /** The map is at rest. The camera does not move, and the view has every
+     *  picture, model, tile and terrain grid that it needs. The event fires once
+     *  each time that the map comes to rest after a change. The clock can run. A
+     *  covered map is not at rest. The catalogue points and the star background
+     *  do not count. */
+    idle: () => void;
     /** The data could not be loaded. The map stays mounted and empty. */
     error: (message: string) => void;
     /** The export was republished while this map was open: its data is now a
@@ -1367,7 +1373,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' | 'matched to a controlled mosaic';
+    orientation?: 'unknown' | 'caption-aligned' | 'matched to an archival sphere' | 'matched to a controlled mosaic' | 'matched to a terrain model' | 'fitted to the Sun';
     /** `estimated` where the sphere's angular bounds were fitted to a
      *  published flat image rather than read from an archive label. */
     geometry?: 'estimated';
@@ -1847,6 +1853,8 @@ export declare class SimClock {
     private prevScale;
     private stops;
     private settleTimer;
+    /** The promises of {@link jumpTo} that wait for a frame at their date. */
+    private arrivals;
     constructor(initialJd: number, live?: boolean);
     /* Excluded from this release type: tick */
     /* Excluded from this release type: setBoundaryStops */
@@ -1854,9 +1862,12 @@ export declare class SimClock {
     setTimeScale(magnitude: number): void;
     toggleDirection(): void;
     /* Excluded from this release type: setJD */
-    /** Seek, and mark it as a discrete jump so listeners can react to the one
-     *  move rather than to a stream of them. */
-    jumpTo(jd: number): void;
+    /** Move the clock to `jd` in one jump, so that listeners react to it once.
+     *  The promise resolves when a frame shows the bodies at that date. Until
+     *  the data of the date loads, the map shows the date before the jump, and
+     *  the measures answer for that date. */
+    jumpTo(jd: number): Promise<void>;
+    /* Excluded from this release type: placed */
     /** Rest the settled date on where the clock stands now. */
     private settle;
     /** The same, once a drag holds still. A clock still playing is left alone: it
@@ -1871,8 +1882,9 @@ export declare class SimClock {
     get playing(): boolean;
     /** The moment the map is showing. */
     get date(): Date;
-    /** Show another moment, as one deliberate move. */
-    setDate(date: Date): void;
+    /** Move the clock to `date` in one jump. The promise resolves as the promise
+     *  of {@link jumpTo} does. */
+    setDate(date: Date): Promise<void>;
 }
 
 /**
@@ -2012,9 +2024,17 @@ export declare class SpaceMap {
      *  the move a click on its label makes. Resolves when the camera comes
      *  round. */
     panTo(target: FeatureTarget): Promise<void>;
-    /** Put the camera somewhere at once, with no flight: what a page restoring a
-     *  stored view wants, where a flight from nowhere would read as a lurch. */
-    jumpTo(target: JumpTarget): this;
+    /**
+     * Put the camera at a place at once, with no flight. Use it to restore a
+     * stored view. A body that the map has not loaded loads first. The promise
+     * resolves one frame after the camera is in its place. It rejects when the
+     * data of the body does not load. A later move stops this move.
+     */
+    jumpTo(target: JumpTarget): Promise<void>;
+    /** Whether `id` is in the scene, with a place at the date it shows. */
+    private placedNow;
+    /** The placement of {@link jumpTo}, on a body in the scene. */
+    private snap;
     /** Where the camera is now. Null before the first frame, and while nothing
      *  is focused. */
     getCamera(): CameraState | null;

package/index.js

@@ -110,7 +110,7 @@ var noop = () => {};
 function run_all(arr) {
 	for (var i = 0; i < arr.length; i++) arr[i]();
 }
-function deferred() {
+function deferred$1() {
 	var resolve;
 	var reject;
 	return {
@@ -902,7 +902,7 @@ var Batch = class Batch {
 		this.#discard_callbacks.add(fn);
 	}
 	settled() {
-		return (this.#deferred ??= deferred()).promise;
+		return (this.#deferred ??= deferred$1()).promise;
 	}
 	static ensure() {
 		if (current_batch === null) {
@@ -10378,6 +10378,30 @@ function applySouthTowardParent(obj, bodyPos, parentPos) {
 function applyUpVector(obj, dir) {
 	obj.quaternion.setFromUnitVectors(LOCAL_NORTH, dir);
 }
+function landedHeadingAt(headings, jd) {
+	let deg;
+	for (const h of headings ?? []) if (h.jd <= jd) deg = h.deg;
+	return deg;
+}
+var LOCAL_FRONT = new Vector3(0, 0, 1);
+var _up = new Vector3();
+var _front = new Vector3();
+var _north = new Vector3();
+var _east = new Vector3();
+var _target = new Vector3();
+var _cross = new Vector3();
+var _turn = new Quaternion();
+function turnToHeading(obj, north, headingDeg) {
+	_up.copy(LOCAL_NORTH).applyQuaternion(obj.quaternion);
+	_north.copy(north).addScaledVector(_up, -north.dot(_up)).normalize();
+	_east.crossVectors(_north, _up);
+	const h = headingDeg * DEG2RAD$5;
+	_target.copy(_north).multiplyScalar(Math.cos(h)).addScaledVector(_east, Math.sin(h));
+	_front.copy(LOCAL_FRONT).applyQuaternion(obj.quaternion);
+	_front.addScaledVector(_up, -_front.dot(_up)).normalize();
+	const angle = Math.atan2(_cross.crossVectors(_front, _target).dot(_up), _front.dot(_target));
+	obj.quaternion.premultiply(_turn.setFromAxisAngle(_up, angle));
+}
 var AXIS_VECTORS = {
 	"+x": new Vector3(1, 0, 0),
 	"-x": new Vector3(-1, 0, 0),
@@ -13517,6 +13541,11 @@ function disposeChain(chain) {
 	chain.uniforms.map.value = null;
 	chain.uniforms.mask.value = null;
 }
+function chainSettled(chain, tiles) {
+	const store = chain.store;
+	if (!store || chain.dead || chain.uniforms.window.value[0].w === 0) return true;
+	return store.windows.every((win) => settled(chain, store, tiles, win));
+}
 function restChain(chain, now) {
 	switchOff(chain);
 	if (now - chain.lastUsed > IDLE_DISPOSE_S * 1e3) disposeChain(chain);
@@ -15765,6 +15794,7 @@ async function loadSpacecraftModel(bo, modelScene, ctx) {
 	try {
 		const detail = await fetchObjectDetail(bo.body.data.id, false);
 		bo.body.pointing = detail.global?.pointing;
+		bo.body.landedHeadings = landedHeadings(detail.global?.events?.items);
 		const attitudeManifest = detail.global?.attitude;
 		if (attitudeManifest && (bo.modelLoadEpoch ?? 0) === epoch) {
 			const probeId = bo.body.data.id.replace(/^probe-/, "");
@@ -15804,8 +15834,9 @@ async function loadSpacecraftModel(bo, modelScene, ctx) {
 		bo.model = root;
 		bo.modelName = slug;
 		setHaloLoading(bo, false);
-		if (meta.scale_meters) {
-			const spanKm = meta.scale_meters / 2e3;
+		const spanM = meta.exports[tier]?.scale_meters;
+		if (spanM) {
+			const spanKm = spanM / 2e3;
 			bo.body.data.radiusKm = spanKm * (meta.body_span_ratio ?? 1);
 			bo.radiusScene = kmToScene(effectiveRadiusKm(bo.body.data));
 			bo.modelUnitOverride = meta.body_span_ratio ? kmToScene(spanKm) : void 0;
@@ -15918,6 +15949,7 @@ function unloadBodyModel(bo) {
 	bo.model = null;
 	bo.modelName = void 0;
 	bo.body.pointing = void 0;
+	bo.body.landedHeadings = void 0;
 	bo.body.attitudeTrack = void 0;
 	bo.body.modelBaseFrame = void 0;
 	if (bo.mesh && restoreSphere) bo.mesh.visible = true;
@@ -15937,6 +15969,17 @@ function setHaloLoading(bo, loading) {
 		bo.loadingShown = void 0;
 	}
 }
+function landedHeadings(events) {
+	const out = [];
+	for (const e of events ?? []) {
+		const deg = e.type === "landing" ? e.site?.heading_deg : void 0;
+		if (deg !== void 0) out.push({
+			jd: e.jd,
+			deg
+		});
+	}
+	return out.length ? out : void 0;
+}
 function withBaseFrame(scene, q) {
 	if (!q) return scene;
 	const wrapper = new Group();
@@ -18708,6 +18751,7 @@ var SimClock = class {
 	prevScale = 1;
 	stops = null;
 	settleTimer = null;
+	arrivals = [];
 	constructor(initialJd, live = false) {
 		this.jd = initialJd;
 		this.settledJd = initialJd;
@@ -18764,6 +18808,19 @@ var SimClock = class {
 		this.setJD(jd);
 		this.jumps++;
 		this.settle();
+		const jumps = this.jumps;
+		return new Promise((resolve) => this.arrivals.push({
+			jumps,
+			resolve
+		}));
+	}
+	placed(jumps) {
+		if (this.arrivals.length === 0) return;
+		this.arrivals = this.arrivals.filter((arrival) => {
+			if (arrival.jumps > jumps) return true;
+			arrival.resolve();
+			return false;
+		});
 	}
 	settle() {
 		if (this.settleTimer !== null) clearTimeout(this.settleTimer);
@@ -18804,7 +18861,7 @@ var SimClock = class {
 		return jdToDate(this.jd);
 	}
 	setDate(date) {
-		this.jumpTo(dateToJD(date));
+		return this.jumpTo(dateToJD(date));
 	}
 };
 
@@ -21100,6 +21157,7 @@ var SystemDataLoader = class {
 	lastBaryId = null;
 	pendingUnloads = /* @__PURE__ */ new Set();
 	prefetched = /* @__PURE__ */ new Set();
+	loads = 0;
 	constructor(scene, ctx, renderer, textureLoader, bodyObjects, clock, onLoaded) {
 		this.scene = scene;
 		this.ctx = ctx;
@@ -21145,10 +21203,14 @@ var SystemDataLoader = class {
 		return isTopLevelParent(baryId) ? null : baryId;
 	}
 	load(baryId) {
+		this.loads++;
 		loadSystemData(baryId, this.bodyObjects, this.scene, this.textureLoader, this.clock.jd, this.renderer.capabilities.maxTextureSize, this.ctx).then(() => {
 			this.onLoaded();
 			this.ctx.bodies.orientationVersion++;
-		});
+		}).finally(() => this.loads--);
+	}
+	isLoading() {
+		return this.loads > 0;
 	}
 	drainPendingUnloads() {
 		if (this.pendingUnloads.size === 0) return;
@@ -24514,6 +24576,7 @@ var OutOfRangeNotifier = class {
 //#region src/lib/scene/position/landed-probe.ts
 var lastSeat = /* @__PURE__ */ new Map();
 var _upScene = new Vector3();
+var _northScene = new Vector3();
 function renderLandedProbe(d, probe, landed, jd, where, ctx, bodyObjects) {
 	const sample = landedPositionAt(landed, jd, landedOpenEnded(probe));
 	if (!sample) return null;
@@ -24543,13 +24606,15 @@ function renderLandedProbe(d, probe, landed, jd, where, ctx, bodyObjects) {
 	const quat = bodyQuaternion(landingBody.orientation, jd, landingBody.nutPrec);
 	const tmp = new Vector3(bx, by, bz).applyQuaternion(quat);
 	const up = eff ? _upScene.set(eff.normal[0], eff.normal[1], eff.normal[2]).applyQuaternion(quat) : null;
+	const north = _northScene.set(-Math.sin(latR) * Math.cos(lngR), Math.cos(latR), Math.sin(latR) * Math.sin(lngR)).applyQuaternion(quat);
 	d.parentId = bodyKey;
 	return {
 		x: bodyWorldPos[0] + kmToScene(tmp.x),
 		y: bodyWorldPos[1] + kmToScene(tmp.y),
 		z: bodyWorldPos[2] + kmToScene(tmp.z),
 		parentPos: bodyWorldPos,
-		up
+		up,
+		north
 	};
 }
 
@@ -24800,8 +24865,12 @@ var Placer = class {
 			const up = landedRender.up;
 			if (bo?.mesh) if (up) applyUpVector(bo.mesh, up);
 			else applySouthTowardParent(bo.mesh, pos, landedRender.parentPos);
-			if (bo?.model) if (up) applyUpVector(bo.model, up);
-			else applySouthTowardParent(bo.model, pos, landedRender.parentPos);
+			if (bo?.model) {
+				if (up) applyUpVector(bo.model, up);
+				else applySouthTowardParent(bo.model, pos, landedRender.parentPos);
+				const heading = landedHeadingAt(body.landedHeadings, jd);
+				if (heading !== void 0) turnToHeading(bo.model, landedRender.north, heading);
+			}
 			return pos;
 		}
 		const primary = resolveProbePrimary(located.probe, jd, located.fitCenterNaifId, ctx.chebStore ?? null, (id) => this.at(id, jd) !== null);
@@ -25571,6 +25640,10 @@ function gridGeometry(grid) {
 	return geometry;
 }
 var tiledStates = /* @__PURE__ */ new WeakMap();
+var deferred = /* @__PURE__ */ new WeakSet();
+function terrainSettled(bo) {
+	return !tiledStates.get(bo)?.abort && !deferred.has(bo);
+}
 var MAX_BUILD_FAILURES = 2;
 function heightTilesOf(bo) {
 	const tiles = bo.displacementMeta?.tiles;
@@ -25625,7 +25698,10 @@ function updateTiledWindow(bo, mesh, tiles, altitude, centerTheta, centerPhi, in
 	if (held) {
 		const still = drift(centerTheta, centerPhi, held.centerTheta, held.centerPhi);
 		if (kept === stepLevel && still < RECENTER_FRAC * held.angRadius) return true;
-		if (performance.now() - held.builtAt < REBUILD_MIN_MS) return true;
+		if (performance.now() - held.builtAt < REBUILD_MIN_MS) {
+			deferred.add(bo);
+			return true;
+		}
 	}
 	const grid = planNestedGrid(centerTheta, centerPhi, altitude, .5 * meta.scale_km / radiusKm, finest, bandCells, stepLevel);
 	const thetas = grid.rows.at;
@@ -25687,6 +25763,7 @@ function updateTiledWindow(bo, mesh, tiles, altitude, centerTheta, centerPhi, in
 	return !!held;
 }
 function updateTerrainWindow(bo, camera, eligible, invalidate) {
+	deferred.delete(bo);
 	const mesh = bo.mesh;
 	const tex = bo.displacementMap;
 	if (!eligible || !mesh || !tex) {
@@ -25725,7 +25802,10 @@ function updateTerrainWindow(bo, camera, eligible, invalidate) {
 		if (w.stepLevel === stepLevel) {
 			if (drift(centerTheta, centerPhi, w.centerTheta, w.centerPhi) < RECENTER_FRAC * w.angRadius) return true;
 		}
-		if (performance.now() - w.builtAt < REBUILD_MIN_MS) return true;
+		if (performance.now() - w.builtAt < REBUILD_MIN_MS) {
+			deferred.add(bo);
+			return true;
+		}
 	}
 	const thetaLo = Math.max(0, centerTheta - angRadius);
 	const thetaHi = Math.min(Math.PI, centerTheta + angRadius);
@@ -25822,6 +25902,15 @@ function desiredDemTier(altitudeRadii, current) {
 	if (tierRank(down) < tierRank(current)) return down;
 	return current;
 }
+function bodyLoading(bo) {
+	if (bo.textureLoading || bo.displacementLoading || bo.clouds?.textureLoading) return true;
+	if (bo.appearance?.loading || bo.modelLoadPromise) return true;
+	const surface = bo.tileOverlay;
+	if (surface && bo.surfaceTiles && !chainSettled(surface.chain, bo.surfaceTiles)) return true;
+	const relief = bo.reliefTiles;
+	if (relief && !chainSettled(relief.chain, relief.tiles)) return true;
+	return !terrainSettled(bo);
+}
 function updateTextureLOD(bodyObjects, camera, renderer, ctx, textureLoader, focusedId, jd, appearances, invalidate) {
 	appearances.apply(bodyObjects, textureLoader);
 	const fovRad = camera.fov * Math.PI / 180;
@@ -25876,6 +25965,13 @@ function updateTextureLOD(bodyObjects, camera, renderer, ctx, textureLoader, foc
 	}
 }
 
+//#endregion
+//#region src/lib/scene/perf/calibration-state.svelte.ts
+var calibrationUi = proxy({
+	progress: null,
+	bootPending: false
+});
+
 //#endregion
 //#region src/lib/scene/animation/focus.ts
 var FOCUS_DURATION_MS = FOCUS_ROT_PACING.refMs;
@@ -27262,6 +27358,11 @@ var SceneRenderer = class SceneRenderer {
 	lastRenderedFocusKey = "";
 	lastRenderedCamPos = new Vector3(NaN, NaN, NaN);
 	lastRenderedCamQuat = new Quaternion();
+	restCamPos = new Vector3(NaN, NaN, NaN);
+	restCamQuat = new Quaternion();
+	restFocusKey = "";
+	atRest = false;
+	focusLoads = 0;
 	unsubscribeBodiesAdded = null;
 	_trailView = {
 		camX: 0,
@@ -27691,6 +27792,7 @@ var SceneRenderer = class SceneRenderer {
 		this.lastRenderedCamPos.copy(this.camera.position);
 		this.lastRenderedCamQuat.copy(this.camera.quaternion);
 		this.applyJdUpdate(true);
+		if (!this.dateHeld() && !this.seekAwaitsData) this.clock.placed(this.seenJumps);
 		this.refreshTravelFocus();
 		this.callbacks.onFrame?.(this.sceneJd, renderedDtMs);
 		const controlsSettled = this.holdingCamera ? this.applyHeldCamera() : stepFocusAnimation(this.focus, this.camera, this.controls, () => this.repositionAll(), () => this.pointClouds.rebuildBasis());
@@ -27766,7 +27868,27 @@ var SceneRenderer = class SceneRenderer {
 		this.renderModelOverlay();
 		this.labelRenderer.render(this.scene, this.camera);
 		if (this.haloDebug.active) this.haloDebug.draw(this.bodyObjects, this.camera, this.focus.focusTruePos, this.focusController.current?.data.id, this.renderer.domElement.clientWidth, this.renderer.domElement.clientHeight);
-	};
+		this.checkRest(nowMs);
+	};
+	checkRest(nowMs) {
+		const moved = this.cameraMovedFrom(this.restCamPos, this.restCamQuat) || this.focusKey() !== this.restFocusKey;
+		this.restCamPos.copy(this.camera.position);
+		this.restCamQuat.copy(this.camera.quaternion);
+		this.restFocusKey = this.focusKey();
+		if (moved || this.settling(nowMs)) this.atRest = false;
+		else if (!this.atRest) {
+			this.atRest = true;
+			this.callbacks.onIdle?.();
+		}
+	}
+	settling(nowMs) {
+		if (this.covered || this.ctx.loading || calibrationUi.bootPending) return true;
+		if (nowMs - this.focus.focusStartTime < this.focus.focusDurationMs) return true;
+		if (this.jumpJd !== null || this.seekAwaitsData) return true;
+		if (this.focusLoads > 0 || this.systemData.isLoading()) return true;
+		for (const bo of this.bodyObjects.values()) if (bo.group.visible && bodyLoading(bo)) return true;
+		return false;
+	}
 	syncSceneSamples(insideShell) {
 		const target = this.composer.readBuffer;
 		const samples = insideShell ? 0 : Math.min(this.tier.sceneSamples, this.maxSceneSamples);
@@ -28167,11 +28289,14 @@ var SceneRenderer = class SceneRenderer {
 		if (nowMs - this.focus.focusStartTime < this.focus.focusDurationMs || this.focusKey() !== this.lastRenderedFocusKey || this.ctx.bodies.minorStreaming || this.pointClouds.hasPendingSceneAdds() || this.systemData.hasPendingUnloads()) return true;
 		if (this.covered) return false;
 		if (this.frameIndex - this.lastRenderedFrame >= SceneRenderer.IDLE_HEARTBEAT_FRAMES) return true;
-		const cam = this.camera;
-		if (cam.position.distanceToSquared(this.lastRenderedCamPos) > cam.position.lengthSq() * 1e-10 || 8 * (1 - Math.abs(cam.quaternion.dot(this.lastRenderedCamQuat))) > 1e-8 || this.frameIndex < this.wakeUntilFrame || this.haloDebug.active) return true;
+		if (this.cameraMovedFrom(this.lastRenderedCamPos, this.lastRenderedCamQuat) || this.frameIndex < this.wakeUntilFrame || this.haloDebug.active) return true;
 		if (this.clock.jd === this.lastRenderedJd) return false;
 		return Math.abs(this.clock.timeScale) > 1 || nowMs - this.lastRenderMs >= SceneRenderer.REALTIME_FRAME_MS;
 	}
+	cameraMovedFrom(pos, quat) {
+		const cam = this.camera;
+		return !(cam.position.distanceToSquared(pos) <= cam.position.lengthSq() * 1e-10 && 8 * (1 - Math.abs(cam.quaternion.dot(quat))) <= 1e-8);
+	}
 	onControlsEnd = () => {
 		this.pendingUrlWrite = true;
 		this.focusController.clearPendingInitialView();
@@ -28187,13 +28312,15 @@ var SceneRenderer = class SceneRenderer {
 	maybeLoadTexture(body) {
 		const bo = this.bodyObjects.get(body.data.id);
 		if (!bo) return;
+		this.focusLoads += 2;
+		const done = () => this.focusLoads--;
 		loadBodyTexture(bo, this.textureLoader, this.sceneJd, this.scene, this.renderer.capabilities.maxTextureSize, this.ctx).then(() => {
 			if (this.focusController.current?.data.id !== body.data.id) return;
 			if (body.orientation && bo.mesh) {
 				applyOrientation(bo.mesh, body.orientation, this.sceneJd, body.nutPrec);
 				this.focusController.reapplyInitialViewIfPending();
 			}
-		});
+		}).finally(done);
 		loadBodyModel(bo, this.modelScene, this.ctx).then(() => {
 			if (this.focusController.current?.data.id === bo.body.data.id) this.controls.minDistance = minCameraDistance(bo.body, modelMinRadiusKm(bo));
 			if (this.ctx.layers.skipped.has("nomenclature")) return;
@@ -28203,7 +28330,7 @@ var SceneRenderer = class SceneRenderer {
 			});
 		}).then(() => {
 			if (this.selectedFeatureId !== null) setActiveFeatureLabel(bo, this.selectedFeatureId);
-		});
+		}).finally(done);
 	}
 	reapplyBodyLayers() {
 		const focused = this.focusController.current;
@@ -28661,7 +28788,8 @@ var SceneRenderer = class SceneRenderer {
 	setCovered(covered) {
 		if (this.covered === covered) return;
 		this.covered = covered;
-		if (!covered) this.invalidate();
+		if (covered) this.atRest = false;
+		else this.invalidate();
 	}
 	isContextLost() {
 		return this.renderer.getContext().isContextLost();
@@ -28754,13 +28882,6 @@ function disposeTexture(value) {
 	if (value && typeof value === "object" && value.isTexture) value.dispose();
 }
 
-//#endregion
-//#region src/lib/scene/perf/calibration-state.svelte.ts
-var calibrationUi = proxy({
-	progress: null,
-	bootPending: false
-});
-
 //#endregion
 //#region src/lib/scene/perf/atmosphere-benchmark.ts
 var EARTH_RADIUS_KM = 6371;
@@ -31223,6 +31344,7 @@ var SpaceMap = class {
 		clock: /* @__PURE__ */ new Set(),
 		loading: /* @__PURE__ */ new Set(),
 		progress: /* @__PURE__ */ new Set(),
+		idle: /* @__PURE__ */ new Set(),
 		error: /* @__PURE__ */ new Set(),
 		datastale: /* @__PURE__ */ new Set(),
 		notice: /* @__PURE__ */ new Set(),
@@ -31494,6 +31616,7 @@ var SpaceMap = class {
 					dtMs
 				});
 			},
+			onIdle: () => this.emit("idle"),
 			onCameraPosition: (latitude, longitude, zoom) => {
 				const body = this.focusedBody?.data.id;
 				if (body === void 0) return;
@@ -31728,20 +31851,38 @@ var SpaceMap = class {
 	panTo(target) {
 		return this.toFeature(this.targetBody(target), target.feature, "pan");
 	}
-	jumpTo(target) {
+	async jumpTo(target) {
 		const body = this.targetBody(target);
+		if (this.placedNow(body) && target.facing === void 0 || this.placedNow(target.facing)) this.navigation++;
+		else {
+			const loading = this.goTo(body, {
+				clock: "keep",
+				camera: "none"
+			});
+			const token = this.navigation;
+			const arrival = await loading;
+			if (arrival.outcome === "failed") throw arrival.error;
+			if (arrival.outcome !== "placed" || token !== this.navigation) return;
+		}
+		this.snap(target, body);
+		return this.settled(0);
+	}
+	placedNow(id) {
+		const body = this.ctx.getBody(id);
+		return !!body && !!this.renderer?.placeOf(body);
+	}
+	snap(target, body) {
 		if (target.facing !== void 0) {
 			this.snapToBodyFacing(body, target.facing, target.elevationDeg ?? 0, this.framing(target, body));
-			return this;
+			return;
 		}
 		if (target.feature) {
 			const { featureId, lat, lon, diameterM } = target.feature;
 			this.focusOnFeature(body, featureId, lat, lon, diameterM, null, "snap");
-			return this;
+			return;
 		}
 		const camera = this.getCamera();
 		this.snapToBody(body, target.lat ?? camera?.lat ?? 45, target.lon ?? camera?.lon ?? 0, this.framing(target, body));
-		return this;
 	}
 	getCamera() {
 		const renderer = this.renderer;

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "spacemap",
-	"version": "0.1.16",
+	"version": "0.1.18",
 	"description": "The map of the Solar System from spacemap.co, on your website!",
 	"keywords": ["solar system", "spacecraft", "orbits", "map", "three.js"],
 	"homepage": "https://spacemap.co",