Files
gods-eye-view/src/layers/launches/overlays.js
T
Manjunath PaparajuandSameh Khamis 0a6fd5f43f Make Space Missions an ordinary layer with its own panel
Space Missions no longer runs as a Context mode. The launches layer owns
its Satellites dependency, including the rule that a Satellites off
asked for after Space Missions was switched on ends it (request order
decides), and a small controller connects the layer to its own panel and
store. Context no longer isolates, snapshots or restores Space Missions
or Satellites, so Contacts and Space Missions run together in either
order, and scene playback no longer exits an isolating mode. Settled by
the owner: Contacts leaves Satellites as it is, and only a person's or
voice Satellites off ends Space Missions; a scene, story, preset or
other programmatic off does not.

Turning the layer on by hand or by voice, choosing it at first run, or
picking a mission on the globe opens the Space Missions panel, and on a
phone its Missions sheet. Asking voice to open the panel while the layer
is off is refused with a reason, and voice never opens it while the
Cockpit owns the screen. With no Context mode on, a voice Context off
switches Space Missions off. A failed Satellites restore no longer cuts
the layer's teardown short. Mission labels on the globe select their
mission. The layer names a failed first index load itself, so the
Context toast no longer imports Space Missions code.

Also carries the satellites request ordering and
DataLayerManager.waitForLayerIdle, the share token for the panel, voice
panel ids, Cockpit folding the panel away and the phone tab ellipsis.
The panel shares the rail gutters and hover border of the other side
panels.

On top of the Omnibar: "open space missions panel" reaches the new
panel, and Open Context no longer answers to "missions".

Co-authored-by: Sameh Khamis <[email protected]>
2026-11-18 16:03:51 -08:00

630 lines
21 KiB
JavaScript
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
import { WGS84 } from '../../geo/ellipsoid.js';
import { dot, magnitude, normalize, toDegrees } from '../../geo/vector.js';
import { canvasOf, findQuery } from '../../render/rendererOf.js';
import { t, msg } from '../../i18n/index.js';
import {
createCyberSonarSampler,
isCyberContactSonarActive as isCyberSonarActive,
} from '../../cyberSonar.js';
import {
ROCKET_MISSION_AMBIENT_OVERLAY_COHORT_LIMIT,
ROCKET_MISSION_AMBIENT_OVERLAY_SOURCE_ID,
ROCKET_MISSION_SELECTED_OVERLAY_SOURCE_ID,
ROCKET_MISSION_SELECTED_OVERLAY_SOURCE_OPTIONS,
ROCKET_MISSION_AMBIENT_OVERLAY_SOURCE_OPTIONS,
} from './policy.js';
/** The ellipsoid's largest radius, metres. */
const MAX_RADIUS = Math.max(WGS84.radii.x, WGS84.radii.y, WGS84.radii.z);
export function createOverlays({ state: layerState, services, parts, source }) {
/**
* Resolve whether a surface mission anchor is safely on the camera-facing
* side of Earth. The small positive limb margin prevents labels anchored just
* beyond the horizon from leaking through the hidden globe.
* @param {{x: number, y: number, z: number}} cameraPosition Camera world position.
* @param {{x: number, y: number, z: number}} markerPosition Mission anchor world position.
* @param {number} [limbMargin] Additional normalized horizon clearance.
* @returns {boolean} Whether the marker belongs on the visible hemisphere.
*/
function missionAnchorHorizonVisible(
cameraPosition,
markerPosition,
limbMargin = 0.012,
) {
if (!cameraPosition || !markerPosition) return false;
const cameraMagnitude = magnitude(cameraPosition);
if (!Number.isFinite(cameraMagnitude) || cameraMagnitude <= MAX_RADIUS) {
return false;
}
const limbThreshold = MAX_RADIUS / cameraMagnitude;
return (
dot(normalize(cameraPosition), normalize(markerPosition)) >
limbThreshold + limbMargin
);
}
/**
* Resolve launch-anchor visibility for overview and selected-mission views.
* @param {{x: number, y: number, z: number}} cameraPosition Camera world position.
* @param {{x: number, y: number, z: number}} markerPosition Mission anchor world position.
* @param {string} markerId Mission represented by this anchor.
* @param {string|null} selectedLaunchId Explicitly selected mission.
* @returns {boolean} Whether the launch anchor should render.
*/
function missionAnchorVisible(
cameraPosition,
markerPosition,
markerId,
selectedLaunchId = null,
) {
if (selectedLaunchId && markerId !== selectedLaunchId) return false;
return missionAnchorHorizonVisible(cameraPosition, markerPosition);
}
function shortMissionLabel(name, maxLength = 24) {
const text = String(name || 'Unnamed mission')
.replace(/\s+/g, ' ')
.trim()
.split(' | ')[0];
const compact = text.split(' — ')[0].trim();
return compact.length > maxLength
? `${compact.slice(0, maxLength - 1).trimEnd()}…`
: compact;
}
/**
* Reduce generic launch-complex names to their identifying pad or area suffix.
* @param {string|null} launchSite Launch Library pad name.
* @returns {string|null} Compact launch-site identifier.
*/
function compactLaunchSiteName(launchSite) {
const text = String(launchSite || '')
.replace(/\s+/g, ' ')
.trim();
if (!text || /^(unknown|unavailable|n\/a)$/i.test(text)) return null;
const genericPrefix =
/^(?:orbital\s+launch\s+pad|space\s+launch\s+complex|launch\s+(?:area|complex|pad|site))\s*[-·:]?\s*/i;
const compact = text.replace(genericPrefix, '').trim();
return compact || null;
}
/**
* Build the source-owned launch-site marker presentation. Overview markers
* compete in the bounded ambient-label domain; the selected mission moves to
* the protected selected lane and gains the former launch-site detail line.
* @param {object} launch Normalized Launch Library mission.
* @param {object|function():object} position Existing display position.
* @param {boolean} [selected=false] Whether the mission owns the selected view.
* @returns {object}
*/
function createRocketMissionMarkerOverlayEntry(
launch,
position,
selected = false,
) {
const mission = shortMissionLabel(launch?.name, 26).toUpperCase();
const siteName = compactLaunchSiteName(launch?.launchSite);
const launchTimeMs = Date.parse(launch?.launchTime);
const details = selected
? [
siteName
? t('LAUNCH SITE · {site}', {
site: shortMissionLabel(siteName, 20).toUpperCase(),
})
: t('LAUNCH SITE'),
]
: [];
return {
id: `launch:${launch?.id}`,
position,
variant: 'label',
title: mission,
details,
accent: '#22e6e6',
priority: selected
? Number.MAX_SAFE_INTEGER
: Number.isFinite(launchTimeMs)
? Math.floor(launchTimeMs / 1000)
: 0,
selected,
protected: selected,
paintLane: selected ? 'selected' : 'ambient-label',
collisionGroup: 'ambient-label',
interactive: true,
distanceScale: {
near: 1000,
nearValue: 1.08,
far: 20_000_000,
farValue: 0.78,
},
gapPx: 12,
verticalOnly: true,
placement: 'above',
edgeFade: 'keyhole',
horizonCull: true,
terrainOcclusion: false,
};
}
/**
* Build one protected label belonging to the selected mission's trajectory,
* live payload position, or orbit. Copy is already source-formatted by the
* caller; newline semantics become explicit host detail rows.
* @param {object} input
* @param {string} input.id Stable mission-element identity.
* @param {object|function():object} input.position Existing cached position.
* @param {string} input.text Former native-label text, including newlines.
* @param {string} input.accent Source-owned label color.
* @param {number} [input.priority=0] Protected placement order.
* @param {number} [input.gapPx=8] Anchor-to-label gap.
* @returns {object}
*/
function createRocketMissionElementOverlayEntry({
id,
position,
text,
accent,
priority = 0,
gapPx = 8,
}) {
const [title, ...details] = String(text || '').split('\n');
return {
id: String(id),
position,
variant: 'label',
title,
details,
accent,
priority,
selected: true,
protected: true,
paintLane: 'selected',
collisionGroup: 'ambient-label',
interactive: false,
gapPx,
verticalOnly: true,
placement: 'above',
edgeFade: 'keyhole',
horizonCull: true,
terrainOcclusion: false,
};
}
/** Keep the newest ambient mission markers with stable identity tie-breaking. */
function selectRocketMissionMarkerOverlayCohort(
entries,
limit = ROCKET_MISSION_AMBIENT_OVERLAY_COHORT_LIMIT,
) {
const cap = Math.max(
0,
Math.min(
ROCKET_MISSION_AMBIENT_OVERLAY_COHORT_LIMIT,
Math.floor(Number(limit) || 0),
),
);
if (!Array.isArray(entries) || cap === 0) return [];
return entries
.slice()
.sort(
(a, b) =>
b.priority - a.priority || String(a.id).localeCompare(String(b.id)),
)
.slice(0, cap);
}
function missionHoverReticleImage() {
if (layerState._missionHoverReticleImage)
return layerState._missionHoverReticleImage;
const canvas = document.createElement('canvas');
const size = 48;
const inset = 6;
const arm = 12;
canvas.width = size;
canvas.height = size;
const context = canvas.getContext('2d');
context.strokeStyle = '#22e6e6';
context.lineWidth = 2;
context.lineCap = 'square';
context.shadowColor = 'rgba(34, 230, 230, .72)';
context.shadowBlur = 5;
context.beginPath();
context.moveTo(inset, inset + arm);
context.lineTo(inset, inset);
context.lineTo(inset + arm, inset);
context.moveTo(size - inset - arm, inset);
context.lineTo(size - inset, inset);
context.lineTo(size - inset, inset + arm);
context.moveTo(inset, size - inset - arm);
context.lineTo(inset, size - inset);
context.lineTo(inset + arm, size - inset);
context.moveTo(size - inset - arm, size - inset);
context.lineTo(size - inset, size - inset);
context.lineTo(size - inset, size - inset - arm);
context.stroke();
layerState._missionHoverReticleImage = canvas;
return canvas;
}
/**
* Resolve the one permitted screen-space replay overlay state.
* @param {object} input Overlay state.
* @param {boolean} input.replayActive Whether replay owns the camera.
* @param {boolean} input.ascending Whether the replay marker is on ascent.
* @param {boolean} input.countdownActive Whether the T-minus hold is active.
* @returns {'countdown'|'ascent'|'orbit'|null}
*/
function replayOverlayMode({
replayActive,
ascending,
countdownActive,
preCountdownActive = false,
}) {
if (!replayActive) return null;
if (preCountdownActive) return null;
if (countdownActive) return 'countdown';
return ascending ? 'ascent' : 'orbit';
}
/**
* Present the replay vehicle overlay to its subscribers, or null to remove
* it. An unchanged presentation is not sent again.
*/
function presentReplayVehicleOverlay(patch) {
const current = layerState._replayVehicleOverlay;
const next = patch && { ...current, ...patch };
if (
next === current ||
(next &&
current &&
Object.keys(next).every((k) => next[k] === current[k]))
)
return;
layerState._replayVehicleOverlay = next;
for (const listener of [...layerState._replayVehicleOverlayListeners])
listener(next);
}
/**
* Receive every presentation of the replay vehicle overlay, starting with
* the current one.
* @param {(view: ?object) => void} listener
* @returns {() => void} Unsubscribe.
*/
function subscribeReplayOverlay(listener) {
layerState._replayVehicleOverlayListeners.add(listener);
listener(layerState._replayVehicleOverlay);
return () => layerState._replayVehicleOverlayListeners.delete(listener);
}
function createReplayVehicleOverlay() {
if (layerState._replayVehicleOverlay) return;
presentReplayVehicleOverlay({
visible: false,
mode: null,
thrusting: false,
paused: false,
transform: null,
rotation: null,
iconOpacity: null,
labelOpacity: null,
title: '',
detail: '',
});
}
function hideReplayVehicleOverlay() {
if (!layerState._replayVehicleOverlay) return;
presentReplayVehicleOverlay({
visible: false,
thrusting: false,
paused: false,
});
}
function destroyReplayVehicleOverlay() {
presentReplayVehicleOverlay(null);
}
function clearMissionOverlaySources() {
layerState._selectedMissionOverlayTimeText = null;
layerState._missionOverlayHost.clearSource(
ROCKET_MISSION_AMBIENT_OVERLAY_SOURCE_ID,
);
layerState._missionOverlayHost.setVisible(
ROCKET_MISSION_AMBIENT_OVERLAY_SOURCE_ID,
false,
);
layerState._missionOverlayHost.clearSource(
ROCKET_MISSION_SELECTED_OVERLAY_SOURCE_ID,
);
layerState._missionOverlayHost.setVisible(
ROCKET_MISSION_SELECTED_OVERLAY_SOURCE_ID,
false,
);
}
function syncMissionOverlayEntries() {
if (!layerState._enabled || !parts.rendering.missionsShown()) {
clearMissionOverlaySources();
return;
}
const selectedRecord = layerState._selectedLaunchId
? layerState._missionOverlayRecords.get(layerState._selectedLaunchId)
: null;
if (selectedRecord) {
layerState._missionOverlayHost.clearSource(
ROCKET_MISSION_AMBIENT_OVERLAY_SOURCE_ID,
);
layerState._missionOverlayHost.setVisible(
ROCKET_MISSION_AMBIENT_OVERLAY_SOURCE_ID,
false,
);
const entries = selectedRecord.elementEntryFactories.map((createEntry) =>
createEntry(),
);
if (layerState._replayCameraLaunchId !== selectedRecord.launch.id) {
entries.unshift(
createRocketMissionMarkerOverlayEntry(
selectedRecord.launch,
selectedRecord.anchorPosition,
true,
),
);
}
layerState._missionOverlayHost.setEntries(
ROCKET_MISSION_SELECTED_OVERLAY_SOURCE_ID,
entries,
ROCKET_MISSION_SELECTED_OVERLAY_SOURCE_OPTIONS,
);
layerState._missionOverlayHost.setVisible(
ROCKET_MISSION_SELECTED_OVERLAY_SOURCE_ID,
true,
);
layerState._selectedMissionOverlayTimeText = selectedRecord.liveEventTime
? parts.policyHelpers.formatMissionEventTime(
selectedRecord.liveEventTime(),
)
: null;
return;
}
layerState._missionOverlayHost.clearSource(
ROCKET_MISSION_SELECTED_OVERLAY_SOURCE_ID,
);
layerState._missionOverlayHost.setVisible(
ROCKET_MISSION_SELECTED_OVERLAY_SOURCE_ID,
false,
);
layerState._selectedMissionOverlayTimeText = null;
const records = [...layerState._missionOverlayRecords.values()].filter(
(record) => !layerState.launchHidden(record.launch),
);
const entries = selectRocketMissionMarkerOverlayCohort(
records.map((record) => {
const entry = createRocketMissionMarkerOverlayEntry(
record.launch,
record.anchorPosition,
);
if (record.launch.id === layerState._hoveredRosterLaunchId) {
entry.pinned = true;
entry.priority = Number.MAX_SAFE_INTEGER - 1;
}
return entry;
}),
);
layerState._missionOverlayHost.setEntries(
ROCKET_MISSION_AMBIENT_OVERLAY_SOURCE_ID,
entries,
ROCKET_MISSION_AMBIENT_OVERLAY_SOURCE_OPTIONS,
);
layerState._missionOverlayHost.setVisible(
ROCKET_MISSION_AMBIENT_OVERLAY_SOURCE_ID,
true,
);
}
function refreshSelectedMissionOverlayText() {
const selectedRecord = layerState._selectedLaunchId
? layerState._missionOverlayRecords.get(layerState._selectedLaunchId)
: null;
if (!selectedRecord?.liveEventTime) return;
const nextText = parts.policyHelpers.formatMissionEventTime(
selectedRecord.liveEventTime(),
);
if (nextText !== layerState._selectedMissionOverlayTimeText)
syncMissionOverlayEntries();
}
function updateReplayVehicleOverlay(occluder) {
if (
!layerState._viewer ||
!layerState._replayVehicleOverlay ||
!layerState._selectedLaunchId
) {
hideReplayVehicleOverlay();
return null;
}
const launch = layerState._launches.find(
(item) => item.id === layerState._selectedLaunchId,
);
const track = layerState._replayTracks.get(layerState._selectedLaunchId);
if (!launch || !track) {
hideReplayVehicleOverlay();
return null;
}
const replayActive = layerState._replayCameraLaunchId === launch.id;
const state = track.getReplayState();
const mode = replayOverlayMode({
replayActive,
ascending: state.ascending,
countdownActive: state.countdownActive,
preCountdownActive: state.preCountdownActive,
});
if (!mode) {
track.lastOverlayWindowPosition = null;
track.lastOverlayMode = null;
hideReplayVehicleOverlay();
return null;
}
const path = state.ascending ? track.ascentPath : track.animatedOrbitPath;
// Do not call scene.sampleHeight() from this post-render path. A selected
// mission can remain visible from globe range, and a periodic remote height
// probe forces Google Photorealistic 3D Tiles to reconsider its refinement
// set even though the camera is stationary. That presented as a one-second
// shrink/expand pulse across the globe. Replay follows its already-built,
// surface-safe Cartesian path and therefore needs no runtime pad sampling.
const position = parts.paths.samplePath(path, state.phaseProgress);
if (!position || !occluder.isPointVisible(position)) {
hideReplayVehicleOverlay();
return null;
}
const query = findQuery(layerState._viewer);
const windowPosition = query?.project(position) ?? null;
if (!windowPosition) {
hideReplayVehicleOverlay();
return null;
}
const canvas = canvasOf(layerState._viewer);
if (
windowPosition.x < -80 ||
windowPosition.y < -100 ||
windowPosition.x > canvas.clientWidth + 80 ||
windowPosition.y > canvas.clientHeight + 100
) {
hideReplayVehicleOverlay();
return null;
}
// The replay camera already targets this same frame-cached world position.
// Applying a second temporal filter here made the DOM vehicle trail the
// camera until the snap threshold was crossed, producing a repeating
// forward/back jump. Keep smoothing only for the non-tracked close-up pad
// marker, where the user can move the camera independently.
const renderedWindowPosition =
!replayActive && track.lastOverlayMode === mode
? parts.replay.smoothReplayWindowPosition(
track.lastOverlayWindowPosition,
windowPosition,
)
: windowPosition;
track.lastOverlayWindowPosition = renderedWindowPosition;
track.lastOverlayMode = mode;
const sonar = isCyberSonarActive()
? createCyberSonarSampler(canvas.clientWidth, canvas.clientHeight)
: null;
const factor =
sonar?.at(renderedWindowPosition.x, renderedWindowPosition.y) ?? 1;
const frame = {
visible: true,
mode,
thrusting: replayActive && state.ascending && !state.countdownActive,
paused: replayActive && layerState._replayPaused,
transform: `translate3d(${renderedWindowPosition.x}px, ${renderedWindowPosition.y}px, 0) translate(-50%, -50%)`,
iconOpacity: String(factor),
labelOpacity: String(sonar ? sonar.label(factor) : 1),
};
let vehicleRotation = 0;
if (replayActive && !state.countdownActive) {
const tangentStep = Math.max(0.002, 0.8 / Math.max(2, path.length - 1));
const forwardProgress = Math.min(1, state.phaseProgress + tangentStep);
const backwardProgress = Math.max(0, state.phaseProgress - tangentStep);
const useForward = forwardProgress > state.phaseProgress;
const tangentPosition = parts.paths.samplePath(
path,
useForward ? forwardProgress : backwardProgress,
);
const tangentWindowPosition = tangentPosition
? query.project(tangentPosition)
: null;
if (tangentWindowPosition) {
const screenDelta = Math.hypot(
tangentWindowPosition.x - windowPosition.x,
tangentWindowPosition.y - windowPosition.y,
);
// When the path points almost directly into/out of the camera, its
// screen projection has no trustworthy direction. Keep the last valid
// path-facing pose instead of snapping the rocket to a camera-facing
// upright orientation.
if (screenDelta >= 2) {
vehicleRotation = useForward
? parts.replay.replayVehicleScreenRotation(
windowPosition,
tangentWindowPosition,
)
: parts.replay.replayVehicleScreenRotation(
tangentWindowPosition,
windowPosition,
);
track.lastVehicleRotation = vehicleRotation;
} else if (Number.isFinite(track.lastVehicleRotation)) {
vehicleRotation = track.lastVehicleRotation;
}
}
}
frame.rotation = `${toDegrees(vehicleRotation)}deg`;
const mission = shortMissionLabel(launch.name, 22).toUpperCase();
const siteName = compactLaunchSiteName(launch.launchSite);
const siteCallout = siteName
? t('LAUNCH SITE · {site}', {
site: shortMissionLabel(siteName, 20).toUpperCase(),
})
: t('LAUNCH SITE');
let title = mission;
let detail = siteCallout;
if (mode === 'countdown') {
title = t('T−{time} · {mission}', {
time: String(state.countdownSeconds).padStart(2, '0'),
mission,
});
detail = `${t('LAUNCH STANDBY')}\n${siteCallout}`;
} else if (mode === 'ascent') {
title =
state.elapsedSinceStart < 1
? t('LIFTOFF · {mission}', { mission })
: t(
launch.trajectory.length > 1
? msg('ASCENT REPLAY · {mission}')
: msg('ASCENT ESTIMATE · {mission}'),
{ mission },
);
detail = parts.policyHelpers.formatMissionEventTime(state.eventTime);
} else if (mode === 'recovery') {
title = t('STAGE RE-ENTRY / RECOVERY · {mission}', { mission });
detail = parts.policyHelpers.formatMissionEventTime(state.eventTime);
} else if (mode === 'orbit') {
title = t('ORBIT REPLAY · {mission}', { mission });
detail = parts.policyHelpers.formatMissionEventTime(state.eventTime);
}
if (layerState._replayPaused) title = t('PAUSED · {title}', { title });
presentReplayVehicleOverlay({ ...frame, title, detail });
return mode;
}
return {
missionAnchorHorizonVisible,
missionAnchorVisible,
shortMissionLabel,
compactLaunchSiteName,
createRocketMissionMarkerOverlayEntry,
createRocketMissionElementOverlayEntry,
selectRocketMissionMarkerOverlayCohort,
missionHoverReticleImage,
replayOverlayMode,
createReplayVehicleOverlay,
subscribeReplayOverlay,
hideReplayVehicleOverlay,
destroyReplayVehicleOverlay,
clearMissionOverlaySources,
syncMissionOverlayEntries,
refreshSelectedMissionOverlayText,
updateReplayVehicleOverlay,
};
}