import { frameOf } from '../../render/rendererOf.js'; import { ISS_NORAD, ISS_OVERLAY_SOURCE_ID, SATELLITE_COVERAGE_MS, } from './policy.js'; import { worldClock } from '../../time/worldClock.js'; export function createLifecycle({ state: layerState, services, parts, source, }) { const { clearFocusTarget } = services.focus; // While on with a catalog, satellites can be shown at any time in reach of // their element sets. Registered once; off, the layer has no time to show, // and each step tells the clock once it has settled. const clockSource = { id: 'satellites', coverage: () => { if (!layerState._enabled || !layerState._catalog.size) return null; const now = worldClock.wallNow(); return { start: now - SATELLITE_COVERAGE_MS, end: now + SATELLITE_COVERAGE_MS, }; }, }; // Unregistered on destroy, so a page that builds the app again holds no old layer; init // registers it again. let uncover = worldClock.register(clockSource); const { holdContinuousRender, releaseContinuousRender } = services.render; const { registerPickOwner, unregisterPickOwner } = services.picking; /** Run the shared per-frame tick before each frame draws. */ function onEachFrame(frame) { return frame.on('preRender', (t) => parts.rendering._preRenderTick(t)); } const methods = { // Catalog data refresh; propagation remains preRender-owned. async init(viewer) { uncover ??= worldClock.register(clockSource); // Asked first: a viewer without one fails before anything is built. const frame = frameOf(viewer); parts.catalog._abortActiveUpdates(); clearFocusTarget('satellites'); for (const model of parts.stationModels ?? []) model._destroyStationModel(); layerState._viewer = viewer; layerState._catalog = new Map(); layerState._points = new Map(); layerState._detectionObjects = new Map(); layerState._orbitPaths = new Map(); layerState._count = 0; layerState._lastUpdate = null; layerState._coreStale = false; layerState._denseStale = false; layerState._trackedNorad = null; parts.tracking._cancelPendingTrackingRestore(); layerState._trackedEntity = null; layerState._trackedFrameNumber = -1; layerState._trackedFrameGeo = null; layerState._trackedFrameNowForTest = null; // The new catalog's points and rings carry no hold. layerState._cockpitHiddenPoints = new Set(); layerState._cockpitHiddenPath = null; layerState._cockpitHiddenDot = false; layerState._lastFocusUpdate = 0; layerState._activeFocusCount = 0; layerState._enabled = false; layerState._overlayHost.clearSource(ISS_OVERLAY_SOURCE_ID); layerState._overlayHost.setVisible(ISS_OVERLAY_SOURCE_ID, false); // Dense extras rebuild via update() when _params.catalog === 'dense' // (the catalog-mode preference itself is sticky across init/destroy). layerState._denseIds = []; layerState._denseCursor = 0; layerState._denseLoadPromise = null; layerState._denseLoadToken++; layerState._denseStatus = 'idle'; layerState._denseError = null; layerState._catalogRevision++; layerState.coverageChanged(); // The sets the satellite dots, the tracked dot and the rings draw in parts.rendering._attach(viewer); parts.interaction._installClickHandler(viewer); // Pre-render listener for real-time position updates // (fleet propagation + tracked per-frame dot + orbit ring GMST rotation) layerState._preRenderListener = onEachFrame(frame); console.log('[Data:Satellites] Initialized'); }, enable(viewer) { layerState._enabled = true; holdContinuousRender('satellites'); // per-frame animator (perf wave 2) parts.rendering._setPointsShown( parts.controls.satelliteVisualsVisible( layerState._enabled, layerState._params.showPoints, ), ); // Orbit rings + persistent ISS host label — show them; the ISS's ring // follows its class (and its tracking). for (const noradId of layerState._orbitPaths.keys()) parts.rendering._setOrbitPathShown( noradId, noradId === ISS_NORAD ? parts.controls._issOrbitVisible() : parts.controls.satelliteVisualsVisible( layerState._enabled, layerState._params.showOrbits, ), ); parts.labels._syncIssOverlay(); // Re-attach input handlers and preRender propagation parts.interaction._installClickHandler(viewer); // Pick-ownership (H2): satellite dot ids are numeric NORAD catalog numbers; // the registry hands predicates String()-coerced ids, so match via Number(). registerPickOwner('satellites', (pickedId) => { const norad = Number(pickedId); return Number.isFinite(norad) && layerState._points.has(norad); }); if (!layerState._preRenderListener && viewer) { layerState._preRenderListener = onEachFrame(frameOf(viewer)); } parts.tracking._applyPendingTrackingRestore(); layerState.coverageChanged(); }, disable(viewer) { parts.catalog._abortActiveUpdates(); parts.tracking._cancelPendingTrackingRestore(); layerState._enabled = false; releaseContinuousRender('satellites'); parts.rendering._setPointsShown(false); parts.rendering._setOrbitPathsShown(false); for (const model of parts.stationModels ?? []) model._updateStationModel(); // off: releases the model parts.tracking._clearTracking(); parts.stationPanel?._syncStationPanel(); // off: takes the panel down parts.labels._syncIssOverlay(); // Remove click handler + keydown listener + preRender propagation while disabled layerState._clickSubscription?.(); layerState._clickSubscription = null; if (layerState._trackedEntityChangedRemove) { layerState._trackedEntityChangedRemove(); layerState._trackedEntityChangedRemove = null; } document.removeEventListener('keydown', parts.interaction._onKeyDown); unregisterPickOwner('satellites'); if (layerState._preRenderListener) { layerState._preRenderListener(); layerState._preRenderListener = null; } layerState.coverageChanged(); }, destroy(viewer) { parts.catalog._abortActiveUpdates(); uncover?.(); uncover = null; releaseContinuousRender('satellites'); // direct-destroy path (perf wave 2 fix) layerState._enabled = false; parts.tracking._clearTracking(); parts.tracking._cancelPendingTrackingRestore(); layerState._clickSubscription?.(); layerState._clickSubscription = null; if (layerState._trackedEntityChangedRemove) { layerState._trackedEntityChangedRemove(); layerState._trackedEntityChangedRemove = null; } document.removeEventListener('keydown', parts.interaction._onKeyDown); unregisterPickOwner('satellites'); if (layerState._preRenderListener) { layerState._preRenderListener(); layerState._preRenderListener = null; } layerState._overlayHost.clearSource(ISS_OVERLAY_SOURCE_ID); layerState._overlayHost.setVisible(ISS_OVERLAY_SOURCE_ID, false); for (const model of parts.stationModels ?? []) model._destroyStationModel(); parts.stationPanel?._destroyStationPanel(); // The dots', tracked dot's and rings' sets are disposed of parts.rendering._detach(viewer); layerState._points.clear(); layerState._detectionObjects.clear(); layerState._orbitPaths.clear(); layerState._catalog.clear(); layerState._denseIds = []; layerState._denseCursor = 0; layerState._denseLoadToken++; layerState._denseStatus = 'idle'; layerState._denseError = null; layerState._catalogRevision++; layerState._rowControlsListener = null; layerState._count = 0; layerState._lastUpdate = null; layerState._coreStale = false; layerState._denseStale = false; layerState._lastError = null; layerState._lastFocusUpdate = 0; layerState._activeFocusCount = 0; layerState._trackingRefreshEpoch += 1; layerState._lastTrackingRefreshOutcome = { epoch: layerState._trackingRefreshEpoch, status: 'destroyed', failedGroups: [], }; layerState._viewer = null; layerState.coverageChanged(); }, }; return { methods }; }