/** * @module app/renderer * @description The application's default renderer plugin: today's Cesium * viewer, set up exactly as before, behind the contract's `RendererPlugin` * (`src/render/contract/renderer.d.ts`). * * The renderer it makes is transitional: it has only the members it really * has, and the contract's ports arrive one layer family at a time (phase 2 * of the renderer plan); `checkRendererShape` lists what is still missing. * Until a family is ported, its code reaches the Cesium viewer through * `cesiumViewerOf`, never through a renderer member, so no engine type * crosses the contract and each call marks code still to port. */ import { CONTRACT_VERSION } from '../render/contract/index.js'; import { createApplicationViewer } from './viewer.js'; /** * The members a transitional renderer has today. * @typedef {Pick} * TransitionalRenderer */ const viewers = new WeakMap(); /** A Set no one can change once built, so `capabilities` stays true. */ export class ReadonlySet extends Set { #sealed; constructor(values = []) { // Filled here, not by Set's constructor: it would call the guarded add // before the private field exists. super(); for (const value of values) super.add(value); this.#sealed = true; } add(value) { if (this.#sealed) throw new TypeError('capabilities are read-only'); return super.add(value); } delete() { throw new TypeError('capabilities are read-only'); } clear() { throw new TypeError('capabilities are read-only'); } } /** * The Cesium viewer behind a renderer this plugin made, or null for any * renderer it did not make. * @param {object} renderer * @returns {object|null} */ export const cesiumViewerOf = (renderer) => viewers.get(renderer) ?? null; /** * The Cesium plugin over a viewer factory; tests pass a fake one. * @param {{createViewer?: typeof createApplicationViewer}} [options] */ export function createCesiumRendererPlugin({ createViewer = createApplicationViewer, } = {}) { return Object.freeze({ id: 'cesium', /** * Credentials stay with the scene, which still loads the tiles; they * move into the renderer with the globe port. * @param {{container: HTMLElement, signal: AbortSignal}} options * @returns {Promise} */ async create({ container, signal }) { signal?.throwIfAborted(); // Provider attribution stays visible, including clean-view and recording. const creditContainer = document.createElement('div'); creditContainer.id = 'cesium-credits'; document.body.appendChild(creditContainer); let viewer; try { viewer = createViewer({ container, creditContainer }); } catch (error) { creditContainer.remove(); throw error; } const renderer = Object.freeze({ id: 'cesium', contractVersion: CONTRACT_VERSION, capabilities: new ReadonlySet(), canvas: viewer.canvas, resize() { viewer.resize(); }, destroy() { try { if (!viewer.isDestroyed()) viewer.destroy(); } finally { creditContainer.remove(); } }, }); viewers.set(renderer, viewer); return renderer; }, }); } /** The default plugin. */ export const cesiumRenderer = createCesiumRendererPlugin();