/** * @module render/applicationHooks * @description What a renderer's plugin may hand the application beside the * contract: behaviour the application uses where a renderer has it, and does * without where it has none. Nothing here is part of the renderer contract, * and the application never asks which renderer it runs on: it reads the * hooks of the renderer it was given, each of them optional. * * - `mapEngine`: the renderer's own map engine (`src/maps/engine.js`), which * the map stacks switch through in place of the globe port * (`src/maps/globeEngine.js`). * - `trimStaleCommands()`: drops the draw commands a renderer keeps for a * while after it stops drawing them; run after a layer turns off. * - `keepPanelRendering(options)`: keeps the globe drawing in an inline panel * whose host stops animation frames (embed mode); returns its disposer. * - `viewerDrawsEntity(entity)`: whether an entity is one the renderer draws * itself (Cockpit asks whether the aircraft it flies still draws). * - `installZoomOutGuard(options)`: keeps outward user zooms bounded and the * Earth framed; returns its disposer. * - `qaHandles`: values QA scripts read from `window.__godsEyeView`. * - `ownCreditDisplay`: true when the renderer shows its credits in a * display of its own; otherwise the application shows what its credits * port lists (`src/ui/creditsView.js`). */ const hooks = new WeakMap(); const NONE = Object.freeze({}); /** * Hand the application `value`'s hooks for `renderer`. A renderer's plugin * calls it as it creates the renderer; a later call replaces them. * @param {object} renderer * @param {object} value */ export function provideApplicationHooks(renderer, value) { hooks.set(renderer, Object.freeze({ ...value })); } /** * The hooks `renderer`'s plugin provided; an empty object when it provided * none, or `renderer` is not an object. * @param {object|null|undefined} renderer * @returns {Readonly} */ export const applicationHooksOf = (renderer) => (renderer && hooks.get(renderer)) || NONE;