@honua/app-platform 0.1.1-beta.0 → 0.1.4-beta.0

package/scene-workspace/camera-correspondence.js

@@ -0,0 +1,220 @@
+/**
+ * The 2D/3D camera correspondence.
+ *
+ * The renderer-neutral {@link SceneCameraState} is a globe pose: geodetic
+ * longitude/latitude, an ellipsoidal camera height in metres, and a
+ * heading/pitch/roll triple in degrees using Cesium's sign convention
+ * (`pitch = -90` looks straight down, `pitch = 0` looks at the horizon).
+ *
+ * A 2D web map does not carry a camera height at all — it carries a *zoom*,
+ * which is a statement about ground resolution. This module is the documented,
+ * unit-tested bridge between the two, so no consumer has to re-derive it. The
+ * Cesium half of the same correspondence lives in `cesium-adapter.ts`
+ * (`cameraStateToCesiumView` / `cesiumCameraToSceneState`), which needs no
+ * conversion because the workspace camera *is* a globe pose.
+ *
+ * ## The zoom/height relationship
+ *
+ * Zoom fixes the ground resolution of the projected plane:
+ *
+ * ```text
+ * groundResolution(zoom, lat) = C · cos(lat) / (tileSize · 2^zoom)   [m/px]
+ * ```
+ *
+ * where `C` is the WGS84 equatorial circumference. The 2D renderer places its
+ * perspective camera so the map centre fills the viewport at that resolution:
+ *
+ * ```text
+ * centreDistance(px) = 0.5 · viewportHeight / tan(fov / 2)
+ * centreDistance(m)  = groundResolution · centreDistance(px)
+ * cameraHeight(m)    = centreDistance(m) · cos(pitch2D)
+ * ```
+ *
+ * The relationship is therefore **not** latitude-independent and **not**
+ * viewport-independent: the same zoom on a taller viewport puts the camera
+ * further away in metres, because more ground is on screen at the same
+ * resolution. Both halves are captured in {@link MapLibreCameraGeometry}, which
+ * a live port reads from the map it is bound to rather than assuming.
+ *
+ * ## What cannot round-trip
+ *
+ * A globe camera can hold poses a Web Mercator plane cannot express. Those are
+ * clamped and reported as {@link SceneCameraDegradation} entries rather than
+ * silently applied: latitudes beyond the Mercator limit, zooms outside the
+ * map's own range, pitches beyond the map's maximum, and a non-zero roll on a
+ * renderer that does not support roll. A projection that needed no clamping
+ * reports `exact` fidelity and round-trips to floating-point precision.
+ *
+ * @beta Part of the beta `@honua/app-platform/scene-workspace` surface.
+ * @module
+ */
+/** WGS84 equatorial circumference in metres (`2π · 6378137`). */
+export const EARTH_CIRCUMFERENCE_METERS = 40_075_016.685_578_49;
+/**
+ * The Web Mercator latitude limit in degrees. Beyond it the projection is
+ * undefined, so a globe camera over the poles has no 2D equivalent.
+ */
+export const WEB_MERCATOR_MAX_LATITUDE = 85.051_128_779_806_59;
+/** Documented defaults for {@link MapLibreCameraGeometry}. */
+export const DEFAULT_MAPLIBRE_CAMERA_GEOMETRY = Object.freeze({
+    viewportHeightPixels: 600,
+    fovRadians: 0.643_501_108_793_284_4,
+    tileSizePixels: 512,
+});
+/** Documented defaults for {@link MapLibreCameraLimits}. */
+export const DEFAULT_MAPLIBRE_CAMERA_LIMITS = Object.freeze({
+    minZoom: 0,
+    maxZoom: 22,
+    maxPitch: 60,
+    rollSupported: false,
+});
+const DEG2RAD = Math.PI / 180;
+/** Smallest camera height treated as physical, so the inverse never divides by zero. */
+const MIN_CAMERA_HEIGHT_METERS = 1e-3;
+/**
+ * Ground resolution in metres per CSS pixel at a zoom and latitude.
+ *
+ * This is the definition of zoom, and the only part of the correspondence that
+ * is independent of the viewport and the lens.
+ */
+export function mapLibreGroundResolutionMeters(zoom, latitude, geometry = DEFAULT_MAPLIBRE_CAMERA_GEOMETRY) {
+    const normalized = normalizeGeometry(geometry);
+    const cosine = Math.cos(clampLatitude(latitude) * DEG2RAD);
+    return (EARTH_CIRCUMFERENCE_METERS * cosine) / (normalized.tileSizePixels * 2 ** zoom);
+}
+/**
+ * Camera height in metres above the map centre for a 2D zoom.
+ *
+ * `pitchDegrees` is the 2D tilt (`0` = straight down), not the globe pitch.
+ */
+export function mapLibreZoomToCameraHeight(zoom, latitude, pitchDegrees = 0, geometry = DEFAULT_MAPLIBRE_CAMERA_GEOMETRY) {
+    const normalized = normalizeGeometry(geometry);
+    const distance = mapLibreGroundResolutionMeters(zoom, latitude, normalized) * centerDistancePixels(normalized);
+    return Math.max(MIN_CAMERA_HEIGHT_METERS, distance * Math.cos(clampPitch(pitchDegrees) * DEG2RAD));
+}
+/**
+ * The inverse of {@link mapLibreZoomToCameraHeight}: the zoom whose camera sits
+ * `height` metres above the map centre. Unclamped — callers decide what their
+ * map will accept.
+ */
+export function mapLibreCameraHeightToZoom(height, latitude, pitchDegrees = 0, geometry = DEFAULT_MAPLIBRE_CAMERA_GEOMETRY) {
+    const normalized = normalizeGeometry(geometry);
+    const safeHeight = Math.max(MIN_CAMERA_HEIGHT_METERS, finite(height, MIN_CAMERA_HEIGHT_METERS));
+    const distance = safeHeight / Math.cos(clampPitch(pitchDegrees) * DEG2RAD);
+    const resolution = distance / centerDistancePixels(normalized);
+    const cosine = Math.cos(clampLatitude(latitude) * DEG2RAD);
+    return Math.log2((EARTH_CIRCUMFERENCE_METERS * cosine) / (normalized.tileSizePixels * resolution));
+}
+/**
+ * Read a 2D map view as a renderer-neutral globe pose.
+ *
+ * Always lossless in this direction: every 2D view is a valid globe pose. The
+ * pitch convention flips (`pitch2D = 0` looks down, which is `pitch = -90` on
+ * the globe) and the bearing is the heading unchanged.
+ */
+export function mapLibreViewToSceneCamera(view, geometry = DEFAULT_MAPLIBRE_CAMERA_GEOMETRY) {
+    const longitude = wrapLongitude(finite(view.center[0], 0));
+    const latitude = clampLatitude(finite(view.center[1], 0));
+    const pitch = clampPitch(finite(view.pitch, 0));
+    return Object.freeze({
+        longitude,
+        latitude,
+        height: mapLibreZoomToCameraHeight(finite(view.zoom, 0), latitude, pitch, geometry),
+        heading: wrapDegrees(finite(view.bearing, 0)),
+        pitch: pitch - 90,
+        roll: wrapSignedDegrees(finite(view.roll, 0)),
+    });
+}
+/**
+ * Project a globe pose onto a 2D map view, clamping what the plane cannot hold
+ * and naming every clamp.
+ *
+ * The caller is expected to apply `view` and surface `degradations`; the shared
+ * state is deliberately left alone, because writing the clamped pose back would
+ * drag the 3D view down to the 2D renderer's limits.
+ */
+export function sceneCameraToMapLibreView(camera, options = {}) {
+    const geometry = normalizeGeometry(options.geometry ?? DEFAULT_MAPLIBRE_CAMERA_GEOMETRY);
+    const limits = normalizeLimits(options.limits ?? DEFAULT_MAPLIBRE_CAMERA_LIMITS);
+    const degradations = [];
+    const requestedLatitude = finite(camera.latitude, 0);
+    const latitude = clampLatitude(requestedLatitude);
+    if (Math.abs(requestedLatitude - latitude) > 1e-9) {
+        degradations.push(degradation("camera-latitude-clamped", "Latitude is beyond the Web Mercator limit and was clamped; the 2D plane cannot reach the poles.", requestedLatitude, latitude));
+    }
+    const requestedPitch = finite(camera.pitch ?? -90, -90) + 90;
+    const pitch = Math.min(Math.max(requestedPitch, 0), limits.maxPitch);
+    if (Math.abs(requestedPitch - pitch) > 1e-9) {
+        degradations.push(degradation("camera-pitch-clamped", "Globe pitch exceeds the 2D map's maximum tilt and was clamped.", requestedPitch, pitch));
+    }
+    const requestedZoom = mapLibreCameraHeightToZoom(Math.max(finite(camera.height, MIN_CAMERA_HEIGHT_METERS), MIN_CAMERA_HEIGHT_METERS), latitude, pitch, geometry);
+    const zoom = Math.min(Math.max(requestedZoom, limits.minZoom), limits.maxZoom);
+    if (Math.abs(requestedZoom - zoom) > 1e-9) {
+        degradations.push(degradation("camera-zoom-clamped", "Camera height maps outside the 2D map's zoom range and was clamped.", requestedZoom, zoom));
+    }
+    const requestedRoll = wrapSignedDegrees(finite(camera.roll ?? 0, 0));
+    const roll = limits.rollSupported ? requestedRoll : 0;
+    if (!limits.rollSupported && Math.abs(requestedRoll) > 1e-9) {
+        degradations.push(degradation("camera-roll-dropped", "The 2D renderer cannot express camera roll; the globe's roll was dropped.", requestedRoll, 0));
+    }
+    return Object.freeze({
+        view: Object.freeze({
+            center: Object.freeze([wrapLongitude(finite(camera.longitude, 0)), latitude]),
+            zoom,
+            bearing: wrapDegrees(finite(camera.heading ?? 0, 0)),
+            pitch,
+            roll,
+        }),
+        fidelity: (degradations.length === 0 ? "exact" : "equivalent"),
+        degradations: Object.freeze(degradations),
+    });
+}
+function degradation(code, message, requested, applied) {
+    return Object.freeze({ code, message, requested, applied });
+}
+function centerDistancePixels(geometry) {
+    return (0.5 * geometry.viewportHeightPixels) / Math.tan(geometry.fovRadians / 2);
+}
+function normalizeGeometry(geometry) {
+    const viewportHeightPixels = positive(geometry?.viewportHeightPixels, DEFAULT_MAPLIBRE_CAMERA_GEOMETRY.viewportHeightPixels);
+    const tileSizePixels = positive(geometry?.tileSizePixels, DEFAULT_MAPLIBRE_CAMERA_GEOMETRY.tileSizePixels);
+    const fovRaw = positive(geometry?.fovRadians, DEFAULT_MAPLIBRE_CAMERA_GEOMETRY.fovRadians);
+    const fovRadians = fovRaw >= Math.PI ? DEFAULT_MAPLIBRE_CAMERA_GEOMETRY.fovRadians : fovRaw;
+    return { viewportHeightPixels, fovRadians, tileSizePixels };
+}
+function normalizeLimits(limits) {
+    const minZoom = finite(limits?.minZoom, DEFAULT_MAPLIBRE_CAMERA_LIMITS.minZoom);
+    const maxZoomRaw = finite(limits?.maxZoom, DEFAULT_MAPLIBRE_CAMERA_LIMITS.maxZoom);
+    return {
+        minZoom,
+        maxZoom: Math.max(minZoom, maxZoomRaw),
+        maxPitch: Math.min(Math.max(finite(limits?.maxPitch, DEFAULT_MAPLIBRE_CAMERA_LIMITS.maxPitch), 0), 89),
+        rollSupported: limits?.rollSupported === true,
+    };
+}
+function clampLatitude(latitude) {
+    return Math.min(Math.max(latitude, -WEB_MERCATOR_MAX_LATITUDE), WEB_MERCATOR_MAX_LATITUDE);
+}
+function clampPitch(pitch) {
+    return Math.min(Math.max(pitch, 0), 89);
+}
+function wrapLongitude(longitude) {
+    const wrapped = ((((longitude + 180) % 360) + 360) % 360) - 180;
+    return Object.is(wrapped, -0) ? 0 : wrapped;
+}
+/** Wrap into `[0, 360)`, matching the heading range the Cesium half normalizes to. */
+function wrapDegrees(degrees) {
+    const wrapped = degrees % 360;
+    return wrapped < 0 ? wrapped + 360 : wrapped;
+}
+/** Wrap into `(-180, 180]`, the natural range for a signed roll. */
+function wrapSignedDegrees(degrees) {
+    const wrapped = wrapDegrees(degrees);
+    return wrapped > 180 ? wrapped - 360 : wrapped;
+}
+function finite(value, fallback) {
+    return typeof value === "number" && Number.isFinite(value) ? value : fallback;
+}
+function positive(value, fallback) {
+    return typeof value === "number" && Number.isFinite(value) && value > 0 ? value : fallback;
+}

package/scene-workspace/cesium-adapter.d.ts

@@ -7,20 +7,30 @@
  * when a live {@link CesiumSceneRuntimeTarget} is actually driven.
  *
  * As of honua-server#1197 the adapter renders Honua 3D content end-to-end:
- * 3D-Tiles tilesets (add/remove/visibility), terrain providers (quantized-mesh
- * via `CesiumTerrainProvider`, with vertical exaggeration), and glTF/GLB model
- * layers placed with heading/pitch/roll + scale. It also resolves a picked
- * 3D-Tiles feature's attributes (batch properties / `EXT_structural_metadata`).
+ * 3D-Tiles tilesets (add/remove/visibility, including point clouds with bounded
+ * shading), terrain providers (quantized-mesh via `CesiumTerrainProvider`, with
+ * vertical exaggeration), imagery providers, and glTF/GLB model layers placed
+ * with heading/pitch/roll + scale. It also resolves a picked 3D-Tiles feature's
+ * attributes (batch properties / `EXT_structural_metadata`).
+ *
+ * Every model/imagery binding is validated before the peer loads, so an
+ * unrenderable primitive fails closed with a stable diagnostic instead of
+ * reaching a Cesium factory or silently rendering nothing.
  *
  * The provider wiring is still kept Cesium-mockable: every CesiumJS symbol the
  * adapter touches is read off the lazily-imported module, so the wiring is
  * exercised against a `vi.mock("cesium")` stub without a live WebGL `Viewer`.
  *
- * @experimental Part of the experimental `scene-workspace` surface; not yet
- *   covered by the SDK's semver contract prior to `1.0.0`.
+ * @beta Part of the beta `@honua/app-platform/scene-workspace` surface: the
+ *   adapter's exports are not renamed or removed through 0.1.x, and diagnostic
+ *   codes and renderer capability flags grow additively. The `cesium` peer floor
+ *   may rise within 0.1.x, and the server-authored 3D style types track the
+ *   Honua Server styling contract. See the surface tiers table in
+ *   `docs/standalone-capability-matrix.md`.
  * @module
  */
-import { type SceneElevationSourcePrimitive, type SceneModelLayerPrimitive, type ScenePrimitiveApplyResult, type SceneRuntimeAdapter, type SceneRuntimeCapabilities, type SceneRuntimePrimitive } from "./primitives.js";
+import { type CesiumClockTarget, type CesiumSceneTimeApplication } from "./cesium-time.js";
+import { type SceneElevationSourcePrimitive, type SceneImageryLayerPrimitive, type SceneModelLayerPrimitive, type ScenePrimitiveApplyResult, type ScenePrimitiveDiagnostic, type ScenePrimitiveStatus, type SceneRuntimeAdapter, type SceneRuntimeCapabilities, type SceneRuntimePrimitive } from "./primitives.js";
 import type { SceneCameraState, SceneWorkspaceState } from "./types.js";
 /**
  * Capabilities advertised by the Cesium adapter. Unlike the MapLibre 2.5D
@@ -66,13 +76,16 @@ export interface CesiumCameraLike {
     readonly heading: number;
     readonly pitch: number;
     readonly roll: number;
+    /**
+     * `orientation` is `unknown` rather than a heading/pitch/roll record because
+     * the real `Camera.setView` also accepts a direction/up pair. Narrowing it
+     * here made a live `Camera` fail to satisfy this interface, which is the one
+     * thing it exists to describe (#1049); callers still build the orientation
+     * through the typed {@link CesiumHeadingPitchRollRadians}.
+     */
     setView(options: {
         destination?: unknown;
-        orientation?: {
-            heading?: number;
-            pitch?: number;
-            roll?: number;
-        };
+        orientation?: unknown;
     }): void;
 }
 /**
@@ -95,10 +108,15 @@ export interface CesiumTilesetLike {
 /**
  * A glTF/GLB model handle (the bits the adapter mutates). Real Cesium `Model`
  * instances satisfy this.
+ *
+ * `color` is Cesium's per-model blend color; its alpha channel is how a `Model`
+ * expresses opacity, which is what backs {@link CesiumLayerHandle.setOpacity}
+ * on the glTF/GLB path.
  */
 export interface CesiumModelLike {
     show: boolean;
     modelMatrix?: unknown;
+    color?: unknown;
     destroy?(): void;
     isDestroyed?(): boolean;
 }
@@ -111,17 +129,36 @@ export interface CesiumPrimitiveCollectionLike {
     remove(primitive?: unknown): boolean;
     contains(primitive?: unknown): boolean;
 }
+export interface CesiumImageryProviderLike {
+    destroy?(): void;
+    isDestroyed?(): boolean;
+}
+export interface CesiumImageryLayerLike {
+    show: boolean;
+    alpha: number;
+    destroy?(): void;
+    isDestroyed?(): boolean;
+}
+export interface CesiumImageryLayerCollectionLike {
+    addImageryProvider(provider: CesiumImageryProviderLike, index?: number): CesiumImageryLayerLike;
+    remove(layer: CesiumImageryLayerLike, destroy?: boolean): boolean;
+    contains(layer: CesiumImageryLayerLike): boolean;
+}
 /**
- * The Cesium `Scene` surface the adapter mutates: a primitive collection for
- * tilesets/models, a settable `terrainProvider`, vertical exaggeration, and a
+ * The Cesium `Scene` surface the adapter mutates: primitive and imagery
+ * collections, a settable `terrainProvider`, vertical exaggeration, and a
  * `pick` entry point used by {@link pickCesiumFeatureAttributes}.
  */
 export interface CesiumSceneLike {
     readonly primitives: CesiumPrimitiveCollectionLike;
+    readonly imageryLayers?: CesiumImageryLayerCollectionLike;
     terrainProvider?: unknown;
     verticalExaggeration?: number;
     pick?(windowPosition: unknown, width?: number, height?: number): unknown;
 }
+interface CesiumTerrainProviderLike {
+    destroy?(): void;
+}
 /**
  * The subset of a live Cesium `Viewer`/`Scene` the adapter drives. Supplying
  * this is optional: an adapter created without a target still diagnoses
@@ -129,8 +166,13 @@ export interface CesiumSceneLike {
  *
  * `scene` is optional so a camera-only target (as shipped in #1196) keeps
  * working unchanged; layer rendering simply no-ops without it.
+ *
+ * `clock` (from {@link CesiumClockTarget}) is the opt-in for application-time
+ * binding: supply `viewer.clock` and the adapter drives it from the workspace
+ * `timeline` slice; omit it and no clock is ever touched. See
+ * `docs/scene-workspace.md` for the ownership contract.
  */
-export interface CesiumSceneRuntimeTarget {
+export interface CesiumSceneRuntimeTarget extends CesiumClockTarget {
     readonly camera: CesiumCameraLike;
     readonly scene?: CesiumSceneLike;
 }
@@ -151,12 +193,21 @@ export interface CesiumModelPlacement {
 /**
  * The handle returned by {@link applyCesiumScenePrimitives} so callers can
  * later toggle visibility or tear a layer down. Keyed by the primitive id.
+ *
+ * `setOpacity` is present only where the underlying Cesium object exposes an
+ * alpha channel the adapter owns: imagery layers (`ImageryLayer.alpha`) and
+ * glTF/GLB models (`Model.color` alpha). A `Cesium3DTileset` has no tileset-wide
+ * alpha — tileset translucency is a `Cesium3DTileStyle` concern owned by the
+ * server styling contract — so tileset handles deliberately omit it rather than
+ * clobbering an applied style. Callers must feature-detect.
  */
 export interface CesiumLayerHandle {
     readonly id: string;
-    readonly kind: "model-layer" | "elevation-source";
+    readonly kind: "model-layer" | "elevation-source" | "imagery-layer";
     readonly format?: SceneModelLayerPrimitive["format"];
+    readonly protocol?: SceneImageryLayerPrimitive["protocol"];
     setVisible(visible: boolean): void;
+    setOpacity?(opacity: number): void;
     remove(): void;
 }
 /**
@@ -219,11 +270,33 @@ type CesiumModule = {
         fromUrl(url: string, options?: Record<string, unknown>): Promise<CesiumTilesetLike>;
     };
     readonly Cesium3DTileStyle: new (style?: Record<string, unknown>) => unknown;
+    readonly Color: {
+        readonly WHITE: {
+            withAlpha(alpha: number): unknown;
+        };
+    };
     readonly Model: {
         fromGltfAsync(options: Record<string, unknown>): Promise<CesiumModelLike>;
     };
     readonly CesiumTerrainProvider: {
-        fromUrl(url: string, options?: Record<string, unknown>): Promise<unknown>;
+        fromUrl(url: string, options?: Record<string, unknown>): Promise<CesiumTerrainProviderLike>;
+    };
+    /**
+     * Optional on purpose: only the clock binding reads it, and a peer without it
+     * degrades to `scene-time-runtime-unavailable` instead of throwing, so a
+     * plan-only application never depends on it.
+     */
+    readonly JulianDate?: {
+        fromIso8601(value: string): unknown;
+    };
+    readonly UrlTemplateImageryProvider: new (options: Record<string, unknown>) => CesiumImageryProviderLike;
+    readonly WebMapServiceImageryProvider: new (options: Record<string, unknown>) => CesiumImageryProviderLike;
+    readonly WebMapTileServiceImageryProvider: new (options: Record<string, unknown>) => CesiumImageryProviderLike;
+    readonly SingleTileImageryProvider: {
+        fromUrl(url: string, options?: Record<string, unknown>): Promise<CesiumImageryProviderLike>;
+    };
+    readonly ArcGisMapServerImageryProvider: {
+        fromUrl(url: string, options?: Record<string, unknown>): Promise<CesiumImageryProviderLike>;
     };
 };
 /**
@@ -336,10 +409,25 @@ export declare function setTilesetStyle(tileset: CesiumTilesetLike, spec: Honua3
  * load a tileset themselves.
  */
 export declare function applyTilesetServerStyle(tileset: CesiumTilesetLike, tilesetUrl: string, cesium?: CesiumModule, fetchImpl?: typeof fetch): Promise<Honua3DStyleSpec | undefined>;
+/**
+ * Cancellation shared by every adapter entry point that materializes a live
+ * renderer resource.
+ *
+ * The Cesium asset factories (`Cesium3DTileset.fromUrl`, `Model.fromGltfAsync`,
+ * `SingleTileImageryProvider.fromUrl`, …) take no `AbortSignal`, so a load that
+ * is already in flight cannot be stopped at the peer. What the signal *does*
+ * guarantee is the half that matters for teardown: an aborted load is never
+ * attached to the scene, and the resource it resolved to is destroyed before the
+ * rejection propagates. Nothing is stranded in a scene the host has abandoned.
+ */
+export interface CesiumSceneMaterializationOptions {
+    /** Abort the materialization. Checked before the load starts and again before the resource is attached. */
+    readonly signal?: AbortSignal;
+}
 /**
  * Options controlling {@link addCesium3DTileset}.
  */
-export interface AddCesium3DTilesetOptions {
+export interface AddCesium3DTilesetOptions extends CesiumSceneMaterializationOptions {
     /**
      * When `true` (the default), a tileset that advertises Honua styling metadata
      * (`extras.honua_style`) has its `style.json` sidecar fetched and applied
@@ -369,9 +457,18 @@ export declare function addCesium3DTileset(scene: CesiumSceneLike, primitive: Sc
 /**
  * Materialize a glTF/GLB model from a model-layer primitive, placing it at the
  * primitive's position/rotation/scale, and add it to the scene. Returns a
- * handle for visibility / teardown.
+ * handle for visibility / opacity / teardown.
+ */
+export declare function addCesiumModel(scene: CesiumSceneLike, primitive: SceneModelLayerPrimitive, cesium?: CesiumModule, options?: CesiumSceneMaterializationOptions): Promise<CesiumLayerHandle>;
+/**
+ * Materialize one renderer-neutral imagery primitive through Cesium's matching
+ * provider and add it to the scene's imagery collection.
+ *
+ * The returned handle owns the provider and layer it creates. Removal is
+ * idempotent, releases the layer's GPU resources through Cesium, and calls an
+ * optional provider `destroy()` exactly once.
  */
-export declare function addCesiumModel(scene: CesiumSceneLike, primitive: SceneModelLayerPrimitive, cesium?: CesiumModule): Promise<CesiumLayerHandle>;
+export declare function addCesiumImageryLayer(scene: CesiumSceneLike, primitive: SceneImageryLayerPrimitive, cesium?: CesiumModule, options?: CesiumSceneMaterializationOptions): Promise<CesiumLayerHandle>;
 /**
  * Wire a terrain provider from an elevation-source primitive onto the scene.
  *
@@ -405,27 +502,131 @@ export declare function pickCesiumFeatureAttributes(scene: CesiumSceneLike, wind
  * As of #1197 this lands the full 3D stack against `target.scene`:
  *  - `camera` → `Camera.setView` (via the lazily-loaded `Cartesian3`).
  *  - `elevation-source` → `scene.terrainProvider` + `verticalExaggeration`.
+ *  - `imagery-layer` → a protocol-specific provider added to `scene.imageryLayers`.
  *  - `model-layer` (`3d-tiles`) → `Cesium3DTileset.fromUrl` added to
  *    `scene.primitives`; (`gltf`/`glb`) → `Model.fromGltfAsync` placed by
  *    position/rotation/scale.
  *
  * Returns the diagnostics plus the live layer handles keyed by primitive id so
  * callers can toggle visibility / tear layers down. Layer rendering is skipped
- * (gracefully) when no `scene` is attached or when a primitive diagnoses as
- * unsupported. I3S model layers and extrusions are declared-capable but not yet
- * materialized here (no Honua server primitives emit them); point clouds ride
- * the 3D-Tiles path and are gated on server ingest (honua-server#1201).
- */
-export declare function applyCesiumScenePrimitives(target: CesiumSceneRuntimeTarget, primitives: readonly SceneRuntimePrimitive[], _state?: SceneWorkspaceState): Promise<ScenePrimitiveApplyResult & {
+ * when no `scene` is attached or when a primitive diagnoses as unsupported —
+ * and every skip is accounted for by a diagnostic, so nothing is silently
+ * dropped. Point clouds ride the 3D-Tiles path with optional
+ * `pointCloudShading`. I3S is declared-capable but unmaterialized, so it
+ * diagnoses `scene-primitive-model-format-not-materialized`; extrusions remain
+ * a MapLibre-path concern.
+ *
+ * As of #1048 `state` is load-bearing: its `timeline` slice is bound to the
+ * target's clock when the host opted into one (see
+ * {@link CesiumSceneRuntimeTarget}), and every arm — applied, host-owned,
+ * unbound, uninterpretable — reports itself as a `scene-time-*` diagnostic.
+ * Binding time constructs no renderer resource, so it never displaces a
+ * primitive: the mount's reuse diff is untouched by a moving clock.
+ */
+export declare function applyCesiumScenePrimitives(target: CesiumSceneRuntimeTarget, primitives: readonly SceneRuntimePrimitive[], state?: SceneWorkspaceState): Promise<ScenePrimitiveApplyResult & {
     readonly layers: ReadonlyMap<string, CesiumLayerHandle>;
 }>;
+/**
+ * Stable identity of a scene primitive within one mount: its kind and id.
+ *
+ * Identity is deliberately kind-qualified. Two primitives of different kinds may
+ * legitimately share an id (a terrain source and the imagery draped over it, for
+ * instance), and they own different renderer resources, so they must never be
+ * treated as revisions of one another.
+ *
+ * @internal
+ */
+export declare function scenePrimitiveMountKey(primitive: SceneRuntimePrimitive): string;
+/**
+ * A stable, order-independent fingerprint of a primitive's configuration, used
+ * to decide whether a revised plan's primitive is the *same* binding as the one
+ * already mounted.
+ *
+ * Returns `undefined` when the primitive cannot be fingerprinted deterministically
+ * (a cycle, or a non-serializable value smuggled through `metadata`). An absent
+ * fingerprint means "assume changed": the binding is rebuilt rather than reused,
+ * which costs a rebuild but can never leave a stale renderer resource claiming to
+ * satisfy a plan it no longer matches.
+ *
+ * @internal
+ */
+export declare function scenePrimitiveFingerprint(primitive: SceneRuntimePrimitive): string | undefined;
+/**
+ * Options for the internal apply engine that both {@link applyCesiumScenePrimitives}
+ * and the mount lifecycle share.
+ *
+ * @internal
+ */
+export interface ApplyCesiumScenePrimitivesInternalOptions {
+    /**
+     * Cancels the application. Checked before the Cesium peer loads, between
+     * primitives, and inside each materialization before its resource is attached.
+     * An abort unwinds through the same rollback path as any other failure, so the
+     * scene is left exactly as it was before the application started.
+     */
+    readonly signal?: AbortSignal;
+    /**
+     * Keys (see {@link scenePrimitiveMountKey}) whose primitive is unchanged since
+     * the previous application. A present key is skipped entirely — no renderer
+     * resource is constructed for it — and its value, when defined, is the live
+     * handle carried forward into this application's result.
+     */
+    readonly reuse?: ReadonlyMap<string, CesiumLayerHandle | undefined>;
+    /**
+     * Workspace state applied alongside the plan. Only the `timeline` slice is
+     * consumed here — it drives the target's clock when the host bound one. Time
+     * is deliberately outside the plan, so it can never displace a mounted
+     * binding.
+     */
+    readonly state?: SceneWorkspaceState;
+}
+/**
+ * The outcome of one application: the diagnostics and layer handles that
+ * {@link applyCesiumScenePrimitives} exposes, plus the per-key ownership record
+ * and reuse accounting the mount lifecycle needs to diff the next revision.
+ *
+ * @internal
+ */
+export interface CesiumScenePrimitiveApplication {
+    readonly status: ScenePrimitiveStatus;
+    readonly diagnostics: readonly ScenePrimitiveDiagnostic[];
+    readonly layers: ReadonlyMap<string, CesiumLayerHandle>;
+    /** Every plan key mapped to the handle it owns (`undefined` for handle-less kinds). */
+    readonly mounted: ReadonlyMap<string, CesiumLayerHandle | undefined>;
+    /** Ids of primitives whose renderer resource was constructed by this application. */
+    readonly created: readonly string[];
+    /** Ids of primitives whose renderer resource was carried forward untouched. */
+    readonly reused: readonly string[];
+    /** What the workspace `timeline` slice did to the bound clock, if anything. */
+    readonly time: CesiumSceneTimeApplication;
+}
+/**
+ * The application engine behind both the one-shot
+ * {@link applyCesiumScenePrimitives} and the {@link CesiumLayerHandle}-owning
+ * mount lifecycle.
+ *
+ * Two properties hold regardless of how it is driven:
+ *
+ * - **Transactional.** Any failure — including an abort — removes every handle
+ *   this application created, in reverse construction order, and restores the
+ *   terrain provider, vertical exaggeration, and clock the scene had on entry.
+ *   Handles carried in through `reuse` are never touched, so a failed revision
+ *   leaves the previously applied plan intact.
+ * - **Ownership-complete.** Every renderer resource it constructs is either
+ *   returned in `mounted` or destroyed before the call returns. Nothing is
+ *   reachable only from a discarded local.
+ *
+ * @internal
+ */
+export declare function applyCesiumScenePrimitivesInternal(target: CesiumSceneRuntimeTarget, primitives: readonly SceneRuntimePrimitive[], options?: ApplyCesiumScenePrimitivesInternalOptions): Promise<CesiumScenePrimitiveApplication>;
 /**
  * Create a {@link SceneRuntimeAdapter} backed by CesiumJS.
  *
  * When `options.target` (a live Cesium `Viewer`/`Scene` surface — a `camera`
- * plus an optional `scene`) is supplied, `apply` drives the live globe: camera
- * sync plus, when a `scene` is attached, terrain providers, 3D-Tiles tilesets,
- * and glTF/GLB model layers (#1197). Without a target the adapter still
+ * plus an optional `scene` and an optional `clock`) is supplied, `apply` drives
+ * the live globe: camera sync plus, when a `scene` is attached, terrain and
+ * imagery providers, 3D-Tiles tilesets, and glTF/GLB model layers, and, when a
+ * `clock` is attached, the workspace `timeline` slice. Without a target the adapter still
  * diagnoses primitives against Cesium's true-3D capabilities — useful for
  * migration analysis before a viewer exists. CesiumJS itself is only imported
  * lazily when `apply` runs.

package/scene-workspace/cesium-adapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cesium-adapter.d.ts","sourceRoot":"","sources":["../../../src/scene-workspace/cesium-adapter.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"cesium-adapter.d.ts","sourceRoot":"","sources":["../../../src/scene-workspace/cesium-adapter.ts"],"names":[],"mappings":"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"}