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

package/scene-workspace/cesium-time.js

@@ -0,0 +1,403 @@
+/**
+ * Application time and rebuild boundaries for the Cesium scene adapter.
+ *
+ * Issue #930 gave the Cesium mount a diff: identity plus configuration
+ * fingerprint decide what is reused and what is rebuilt. What it did not have
+ * was a *time*. `applyCesiumScenePrimitives()` accepted the workspace state —
+ * the object carrying the `timeline` and `realtime` slices — and dropped it.
+ * This module is the missing half:
+ *
+ * - {@link sceneTimelineToCesiumClockPlan} turns the renderer-neutral
+ *   `SceneTimelineState` into the exact set of writes a Cesium `Clock` accepts.
+ *   It is pure and Cesium-free, so a host can inspect (and a test can assert)
+ *   what would be written without loading the optional peer.
+ * - {@link applyCesiumClockPlan} performs those writes against a live clock and
+ *   hands back the snapshot needed to undo them, so time participates in the
+ *   adapter's existing transactional rollback exactly like the terrain provider.
+ * - {@link bindTemporalPlaybackToCesium} gives the renderer-neutral playback
+ *   controller (`createTemporalPlayback`, `@honua/sdk-js/map`) a Cesium sink, so
+ *   the same controller that drives a MapLibre map and `<honua-time-slider>`
+ *   drives a globe.
+ * - {@link SceneRebuildBoundary} names, on the *beta* primitive path, what an
+ *   update had to cross. Before this the vocabulary existed only as a detail
+ *   field on the experimental entity slice's `incremental-update` diagnostic.
+ *
+ * ## Clock ownership
+ *
+ * The adapter binds a clock **only when the host opts in** by putting one on the
+ * scene target ({@link CesiumClockTarget.clock}). A target without a clock is
+ * never given one, and a target that declares `clockOwnership: "host"` is never
+ * written to at all — a host driving `viewer.clock` from Cesium's own Animation
+ * widget, or from a simulation loop, must not have the SDK fighting it. Both
+ * refusals are reported rather than silent, so "the time did not reach the
+ * globe" is always visible in the diagnostic list.
+ *
+ * ## Time is not a rebuild
+ *
+ * Application time lives in the workspace state, never in the scene plan, so it
+ * is outside the fingerprint the mount diffs on. Advancing time therefore
+ * crosses no rebuild boundary: every mounted binding is reused untouched and the
+ * only mutation is on the clock. That property is asserted, not assumed
+ * (`test/cesium-scene-temporal.test.ts`, and against a real `Viewer` in
+ * `test/playwright/cesium-scene-adapter-fixtures.spec.mjs`).
+ *
+ * @beta Part of the beta `@honua/app-platform/scene-workspace` surface: these
+ *   exports are not renamed or removed through 0.1.x, and the boundary and
+ *   diagnostic vocabularies grow additively.
+ * @module
+ */
+/**
+ * Translate a renderer-neutral timeline slice into Cesium clock writes.
+ *
+ * Pure: no Cesium import, no clock, no side effect. Returns `undefined` when the
+ * timeline declares nothing at all, so an empty slice (the default workspace
+ * state) produces no diagnostic and no write.
+ *
+ * `currentTime`, `startTime`, and `endTime` are ISO-8601 in the workspace
+ * contract and are passed through as strings for `JulianDate.fromIso8601`; each
+ * is validated with `Date.parse` first so an unparseable instant is *named*
+ * rather than handed to Cesium. The extent is applied only when both ends parse
+ * and `start < end`, because a half or inverted extent would leave a Cesium
+ * `Timeline` widget describing a range that does not exist.
+ */
+export function sceneTimelineToCesiumClockPlan(timeline) {
+    if (!timeline)
+        return undefined;
+    const declared = timeline.currentTime !== undefined ||
+        timeline.startTime !== undefined ||
+        timeline.endTime !== undefined ||
+        timeline.playing !== undefined ||
+        timeline.speed !== undefined;
+    if (!declared)
+        return undefined;
+    const rejected = [];
+    const instant = (value, label) => {
+        if (value === undefined)
+            return undefined;
+        if (typeof value !== "string" || Number.isNaN(Date.parse(value))) {
+            rejected.push(label);
+            return undefined;
+        }
+        return value;
+    };
+    const currentTime = instant(timeline.currentTime, "currentTime");
+    const startTime = instant(timeline.startTime, "startTime");
+    const endTime = instant(timeline.endTime, "endTime");
+    const extentOrdered = startTime !== undefined && endTime !== undefined ? Date.parse(startTime) < Date.parse(endTime) : false;
+    if (startTime !== undefined && endTime !== undefined && !extentOrdered)
+        rejected.push("extent");
+    let multiplier;
+    if (timeline.speed !== undefined) {
+        if (typeof timeline.speed === "number" && Number.isFinite(timeline.speed))
+            multiplier = timeline.speed;
+        else
+            rejected.push("speed");
+    }
+    const shouldAnimate = typeof timeline.playing === "boolean" ? timeline.playing : undefined;
+    if (timeline.playing !== undefined && shouldAnimate === undefined)
+        rejected.push("playing");
+    return Object.freeze({
+        ...(currentTime === undefined ? {} : { currentTime }),
+        ...(extentOrdered ? { startTime, stopTime: endTime } : {}),
+        ...(multiplier === undefined ? {} : { multiplier }),
+        ...(shouldAnimate === undefined ? {} : { shouldAnimate }),
+        rejected: Object.freeze(rejected),
+    });
+}
+/** Whether a plan would actually write anything to a clock. */
+export function cesiumClockPlanWrites(plan) {
+    if (!plan)
+        return false;
+    return (plan.currentTime !== undefined ||
+        plan.startTime !== undefined ||
+        plan.stopTime !== undefined ||
+        plan.multiplier !== undefined ||
+        plan.shouldAnimate !== undefined);
+}
+/** Read the clock values a plan is about to displace. */
+export function readCesiumClock(clock) {
+    return {
+        currentTime: clock.currentTime,
+        startTime: clock.startTime,
+        stopTime: clock.stopTime,
+        multiplier: clock.multiplier,
+        shouldAnimate: clock.shouldAnimate,
+    };
+}
+/** Restore a clock to a snapshot taken by {@link readCesiumClock}. */
+export function restoreCesiumClock(clock, snapshot) {
+    clock.currentTime = snapshot.currentTime;
+    clock.startTime = snapshot.startTime;
+    clock.stopTime = snapshot.stopTime;
+    clock.multiplier = snapshot.multiplier;
+    clock.shouldAnimate = snapshot.shouldAnimate;
+}
+/**
+ * Apply a {@link CesiumClockPlan} to a live clock and return what it displaced.
+ *
+ * The extent is written before `currentTime` so a clock whose `clockRange`
+ * clamps to `[startTime, stopTime]` accepts the new instant rather than pinning
+ * it to the previous range's edge.
+ */
+export function applyCesiumClockPlan(clock, plan, runtime) {
+    const previous = readCesiumClock(clock);
+    if (plan.startTime !== undefined && plan.stopTime !== undefined) {
+        clock.startTime = runtime.JulianDate.fromIso8601(plan.startTime);
+        clock.stopTime = runtime.JulianDate.fromIso8601(plan.stopTime);
+    }
+    if (plan.currentTime !== undefined)
+        clock.currentTime = runtime.JulianDate.fromIso8601(plan.currentTime);
+    if (plan.multiplier !== undefined)
+        clock.multiplier = plan.multiplier;
+    if (plan.shouldAnimate !== undefined)
+        clock.shouldAnimate = plan.shouldAnimate;
+    return previous;
+}
+/** Whether a loaded peer exposes the time symbols the clock binding needs. */
+export function isCesiumClockRuntime(runtime) {
+    if (runtime === null || typeof runtime !== "object")
+        return false;
+    const julian = runtime.JulianDate;
+    return typeof julian?.fromIso8601 === "function";
+}
+const NO_TIME_APPLICATION = Object.freeze({
+    applied: false,
+    plan: undefined,
+    previous: undefined,
+    diagnostics: Object.freeze([]),
+});
+function timeDiagnostic(code, severity, status, message, context, fallback) {
+    return {
+        code,
+        severity,
+        status,
+        renderer: "cesium",
+        message,
+        ...(fallback === undefined ? {} : { fallback }),
+        context,
+    };
+}
+function planContext(plan) {
+    return {
+        ...(plan.currentTime === undefined ? {} : { currentTime: plan.currentTime }),
+        ...(plan.startTime === undefined ? {} : { startTime: plan.startTime }),
+        ...(plan.stopTime === undefined ? {} : { stopTime: plan.stopTime }),
+        ...(plan.multiplier === undefined ? {} : { multiplier: plan.multiplier }),
+        ...(plan.shouldAnimate === undefined ? {} : { shouldAnimate: plan.shouldAnimate }),
+    };
+}
+/**
+ * Bind the workspace timeline slice to a scene target's clock.
+ *
+ * Every arm reports itself, so the diagnostic list always answers "did the
+ * application time reach the globe, and if not, why":
+ *
+ * | Situation | Code | Status |
+ * | --- | --- | --- |
+ * | Written to the clock | `scene-time-applied` | supported |
+ * | `clockOwnership: "host"` | `scene-time-host-owned` | supported |
+ * | Time declared, no clock on the target | `scene-time-clock-unbound` | degraded |
+ * | Time declared but uninterpretable | `scene-time-invalid` | degraded |
+ * | Peer has no usable `JulianDate` | `scene-time-runtime-unavailable` | degraded |
+ *
+ * The `rebuildBoundary: "none"` on `scene-time-applied` is load-bearing: it
+ * states, in the same vocabulary the mount uses for plan revisions, that moving
+ * time rebuilt nothing.
+ */
+export function applyCesiumSceneTime(target, timeline, runtime) {
+    const plan = sceneTimelineToCesiumClockPlan(timeline);
+    if (!plan)
+        return NO_TIME_APPLICATION;
+    if (plan.rejected.length > 0 && !cesiumClockPlanWrites(plan)) {
+        return {
+            applied: false,
+            plan,
+            previous: undefined,
+            diagnostics: [
+                timeDiagnostic("scene-time-invalid", "warning", "degraded", `The scene timeline declares application time this adapter cannot interpret: ${plan.rejected.join(", ")}.`, { rejected: [...plan.rejected] }, "Supply ISO-8601 instants (and a finite speed) on the workspace timeline slice."),
+            ],
+        };
+    }
+    const ownership = target.clockOwnership ?? "adapter";
+    if (!target.clock) {
+        return {
+            applied: false,
+            plan,
+            previous: undefined,
+            diagnostics: [
+                timeDiagnostic("scene-time-clock-unbound", "warning", "degraded", "The scene timeline declares an application time, but no Cesium clock is bound to this target.", { ...planContext(plan), ownership }, "Attach the viewer's clock to the scene target: `{ camera: viewer.camera, scene: viewer.scene, clock: viewer.clock }`."),
+            ],
+        };
+    }
+    if (ownership === "host") {
+        return {
+            applied: false,
+            plan,
+            previous: undefined,
+            diagnostics: [
+                timeDiagnostic("scene-time-host-owned", "info", "supported", "The host owns this Cesium clock; the adapter reported the application time without writing it.", { ...planContext(plan), ownership }),
+            ],
+        };
+    }
+    if (!isCesiumClockRuntime(runtime)) {
+        return {
+            applied: false,
+            plan,
+            previous: undefined,
+            diagnostics: [
+                timeDiagnostic("scene-time-runtime-unavailable", "warning", "degraded", "The loaded Cesium runtime does not expose JulianDate.fromIso8601, so application time cannot be bound.", { ...planContext(plan), ownership }, "Upgrade the `cesium` peer to a build that exports JulianDate."),
+            ],
+        };
+    }
+    const previous = applyCesiumClockPlan(target.clock, plan, runtime);
+    const diagnostics = [
+        timeDiagnostic("scene-time-applied", "info", "supported", "Bound canonical application time to the Cesium clock without rebuilding any scene primitive.", { ...planContext(plan), ownership, rebuildBoundary: "none" }),
+    ];
+    if (plan.rejected.length > 0) {
+        diagnostics.push(timeDiagnostic("scene-time-invalid", "warning", "degraded", `Part of the scene timeline could not be interpreted and was not applied: ${plan.rejected.join(", ")}.`, { rejected: [...plan.rejected] }, "Supply ISO-8601 instants (and a finite speed) on the workspace timeline slice."));
+    }
+    return { applied: true, plan, previous, diagnostics };
+}
+/** The boundary vocabulary, in escalation order. */
+export const SCENE_REBUILD_BOUNDARIES = Object.freeze([
+    "none",
+    "primitive-identity",
+    "primitive-configuration",
+    "plan-membership",
+    "unfingerprintable",
+]);
+const BOUNDARY_REASONS = Object.freeze({
+    none: "Identity and configuration are unchanged; the renderer resource was reused.",
+    "primitive-identity": "The binding was not previously mounted; its renderer resource was constructed.",
+    "primitive-configuration": "The configuration fingerprint changed; the renderer resource was rebuilt.",
+    "plan-membership": "The binding left the plan; its renderer resource was released.",
+    unfingerprintable: "The primitive could not be fingerprinted deterministically and was rebuilt conservatively.",
+});
+/** Build one boundary report with the vocabulary's own stable reason text. */
+export function sceneRebuildBoundaryReport(id, kind, boundary) {
+    return Object.freeze({
+        id,
+        kind,
+        boundary,
+        incremental: boundary === "none",
+        reason: BOUNDARY_REASONS[boundary],
+    });
+}
+async function loadCesiumClockRuntime(source) {
+    if (typeof source === "function")
+        return source();
+    if (source !== undefined)
+        return source;
+    return await import("cesium");
+}
+function refusedBinding(refusal, plan) {
+    return {
+        bound: false,
+        refusal,
+        applications: 0,
+        plan,
+        dispose() {
+            /* nothing was subscribed and nothing was written */
+        },
+    };
+}
+/**
+ * Drive a live Cesium clock from a renderer-neutral temporal playback
+ * controller.
+ *
+ * This is the Cesium sink `createTemporalPlayback()` never had: the same
+ * controller instance can hold a MapLibre filter binding, a data-to-map bridge
+ * `where` clause, a `<honua-time-slider>` view, and now a globe, without any of
+ * them knowing about the others.
+ *
+ * Ownership is the target's, not this function's: a target with no clock, or one
+ * that declares `clockOwnership: "host"`, gets an inert binding whose `refusal`
+ * names why. Nothing is written and nothing is thrown — a UI binding must not
+ * explode because the host drives its own clock.
+ *
+ * @example
+ * ```ts doc-test=skip reason="requires a live Cesium Viewer and a mounted source"
+ * const playback = createTemporalPlayback({ handle: mounted, timeField: "observed_at", ... });
+ * const binding = await bindTemporalPlaybackToCesium(
+ *   { camera: viewer.camera, scene: viewer.scene, clock: viewer.clock },
+ *   playback,
+ * );
+ * playback.play();          // the globe's clock now follows the controller
+ * binding.dispose();        // the clock is restored exactly as it was
+ * ```
+ */
+export async function bindTemporalPlaybackToCesium(target, playback, options = {}) {
+    const instant = options.instant ?? "window-start";
+    const transport = options.transport ?? "paused";
+    const bindExtent = options.bindExtent !== false;
+    // The clock's rate at bind time is the reference the controller's multiplier
+    // scales, so `speed: 2` means "twice whatever the host configured" rather than
+    // silently redefining the host's simulation rate as 1.
+    let baseMultiplier = 1;
+    const timelineFor = (window) => {
+        const at = instant === "window-end" ? window.end : window.start;
+        return {
+            currentTime: new Date(at).toISOString(),
+            ...(bindExtent
+                ? {
+                    startTime: new Date(playback.extent.start).toISOString(),
+                    endTime: new Date(playback.extent.end).toISOString(),
+                }
+                : {}),
+            playing: transport === "mirror" ? playback.playing : false,
+            ...(transport === "mirror" ? { speed: (playback.speed ?? 1) * baseMultiplier } : {}),
+        };
+    };
+    const planFor = (window) => sceneTimelineToCesiumClockPlan(timelineFor(window));
+    const ownership = target.clockOwnership ?? "adapter";
+    const clock = target.clock;
+    if (!clock)
+        return refusedBinding("clock-unbound", planFor(playback.window));
+    if (ownership === "host")
+        return refusedBinding("host-owned", planFor(playback.window));
+    const runtime = await loadCesiumClockRuntime(options.cesium);
+    if (!isCesiumClockRuntime(runtime))
+        return refusedBinding("runtime-unavailable", planFor(playback.window));
+    const restore = readCesiumClock(clock);
+    if (typeof restore.multiplier === "number" && Number.isFinite(restore.multiplier) && restore.multiplier !== 0) {
+        baseMultiplier = restore.multiplier;
+    }
+    let applications = 0;
+    let plan;
+    let disposed = false;
+    const write = (window) => {
+        if (disposed)
+            return;
+        const next = planFor(window);
+        if (!next || !cesiumClockPlanWrites(next))
+            return;
+        applyCesiumClockPlan(clock, next, runtime);
+        plan = next;
+        applications += 1;
+    };
+    const subscriptions = [
+        playback.on("tick", (event) => write(event.window)),
+        playback.on("play", () => write(playback.window)),
+        playback.on("pause", () => write(playback.window)),
+        playback.on("end", () => write(playback.window)),
+    ];
+    if (options.applyImmediately !== false)
+        write(playback.window);
+    return {
+        bound: true,
+        get applications() {
+            return applications;
+        },
+        get plan() {
+            return plan;
+        },
+        dispose() {
+            if (disposed)
+                return;
+            disposed = true;
+            for (const subscription of subscriptions)
+                subscription.remove();
+            restoreCesiumClock(clock, restore);
+        },
+    };
+}

package/scene-workspace/index.d.ts

@@ -1,18 +1,50 @@
 /**
- * `@honua/sdk-js/scene-workspace` — framework-neutral 3D scene workspace state.
+ * `@honua/app-platform/scene-workspace` — framework-neutral 3D scene workspace
+ * state and the Cesium renderer adapter. `@honua/sdk-js/scene-workspace` is a
+ * deprecated 0.1.x forwarder onto this module.
  *
- * @experimental This entrypoint is not yet covered by the SDK's semver contract
- *   — the surface may change in any minor release prior to `1.0.0`.
+ * This barrel carries two support tiers, and they are enumerated symbol by
+ * symbol in `config/support-manifest.v1.json` (projected into
+ * `config/public-surface.json`) rather than inferred from the directory. The
+ * support gate fails on an export that no tier classifies, so nothing is
+ * promoted by proximity.
+ *
+ * @beta The renderer-neutral workspace state, the scene primitive contract, and
+ *   the Cesium primitive adapter keep their shape through `@honua/app-platform`
+ *   0.1.x: no export is renamed or removed, primitive discriminants and
+ *   diagnostic codes grow additively only, and Cesium stays a lazily imported
+ *   optional peer. Additive union members can still require a new arm in an
+ *   exhaustive `switch`, the `cesium` peer floor can rise within 0.1.x, and the
+ *   server-authored 3D style types track the Honua Server styling contract.
+ * @experimental Held back from the beta tier: Honua Server scene discovery, the
+ *   `SceneView` container, and the elevation/analysis widgets (server-attached,
+ *   outside the open-endpoint evidence), plus the bounded accepted-plan
+ *   `Source`-to-Cesium-entity slice and the `mountCesiumScene` owner that
+ *   composes it with the primitive mount. Those may change in any minor release.
  * @module
  */
 export { createSceneWorkspace, emptySceneWorkspaceState, reduceSceneWorkspaceState, sceneWorkspaceIntentFromAdapterEvent, selectSceneDiagnosticsByStatus, selectSceneEvidenceForFeature, selectScenePrimitivesByKind, selectSceneVisibleLayers, } from "./workspace.js";
-export { SCENE_STATE_SYNC_KIND, SCENE_STATE_SYNC_SLICES, SCENE_STATE_SYNC_VERSION, HonuaSceneStateSyncError, createSceneStateSynchronizer, defaultSceneStateSyncMappings, } from "./state-sync.js";
+export { SCENE_STATE_SYNC_KIND, SCENE_STATE_SYNC_SLICES, SCENE_STATE_SYNC_SLICE_WORKSPACE_CROSSWALK, SCENE_STATE_SYNC_VERSION, HonuaSceneStateSyncError, createSceneStateSynchronizer, defaultSceneStateSyncMappings, } from "./state-sync.js";
+export { DEFAULT_MAPLIBRE_CAMERA_GEOMETRY, DEFAULT_MAPLIBRE_CAMERA_LIMITS, EARTH_CIRCUMFERENCE_METERS, WEB_MERCATOR_MAX_LATITUDE, mapLibreCameraHeightToZoom, mapLibreGroundResolutionMeters, mapLibreViewToSceneCamera, mapLibreZoomToCameraHeight, sceneCameraToMapLibreView, } from "./camera-correspondence.js";
+export type { MapLibreCameraGeometry, MapLibreCameraLimits, MapLibreCameraProjection, MapLibreCameraView, SceneCameraDegradation, SceneCameraDegradationCode, } from "./camera-correspondence.js";
+export { sceneAttributionId, sceneAttributionValue } from "./state-sync-port-kit.js";
+export type { SceneStateSyncPortDegradation, SceneStateSyncPortDegradationCode, SceneStateSyncPublishOutcome, SceneStateSyncRendererPort, } from "./state-sync-port-kit.js";
+export { createMapLibreStateSyncPort } from "./maplibre-state-sync.js";
+export type { CreateMapLibreStateSyncPortOptions, MapLibreStateSyncTarget } from "./maplibre-state-sync.js";
+export { createCesiumStateSyncPort } from "./cesium-state-sync.js";
+export type { CesiumStateSyncEntity, CesiumStateSyncEntityCollection, CesiumStateSyncEvent, CesiumStateSyncModule, CesiumStateSyncTarget, CreateCesiumStateSyncPortOptions, } from "./cesium-state-sync.js";
 export type { CreateSceneStateSynchronizerOptions, SceneStateSyncAttributionValue, SceneStateSyncDelivery, SceneStateSyncDiagnostic, SceneStateSyncDiagnosticCode, SceneStateSyncEnvelope, SceneStateSyncErrorCode, SceneStateSyncEvent, SceneStateSyncFidelity, SceneStateSyncIdentity, SceneStateSyncInput, SceneStateSyncMapping, SceneStateSyncMappings, SceneStateSyncOrigin, SceneStateSyncPort, SceneStateSyncRealtimeValue, SceneStateSyncRenderer, SceneStateSyncSlice, SceneStateSyncSnapshot, SceneStateSyncValueMap, SceneStateSynchronizer, } from "./state-sync.js";
-export { MAPLIBRE_SCENE_CAPABILITIES, applyMapLibreScenePrimitives, createMapLibreSceneAdapter, createSceneRuntimeAdapter, diagnoseScenePrimitive, diagnoseScenePrimitives, summarizeDiagnosticStatus, toMapLibreExtrusionLayer, toMapLibreTerrainPatch, } from "./primitives.js";
-export { CESIUM_SCENE_CAPABILITIES, addCesium3DTileset, addCesiumModel, applyCameraStateToCesiumCamera, applyCesiumScenePrimitives, applyCesiumTerrain, applyHonua3DStyle, applyTilesetServerStyle, cameraStateToCesiumView, cesiumCameraToSceneState, createCesiumSceneAdapter, fetchHonua3DStyleSpec, honua3DStyleToCesiumStyleOptions, loadHonua3DStyle, modelLayerToCesiumPlacement, pickCesiumFeatureAttributes, readHonua3DStyleDescriptor, resolveCesiumModelScale, resolveHonua3DStyleUri, resolvePickedFeatureAttributes, setTilesetStyle, } from "./cesium-adapter.js";
-export type { AddCesium3DTilesetOptions, CesiumCameraLike, CesiumCameraView, CesiumHeadingPitchRollRadians, CesiumLayerHandle, CesiumModelLike, CesiumModelPlacement, CesiumPrimitiveCollectionLike, CesiumSceneLike, CesiumSceneRuntimeTarget, CesiumTilesetLike, Honua3DStyleConditions, Honua3DStyleDescriptor, Honua3DStyleSpec, } from "./cesium-adapter.js";
-export { DEFAULT_CESIUM_ENTITY_LIMIT, HonuaCesiumEntityAdapterError, mountSourceToCesium, projectSourceToCesium, } from "./source-to-cesium.js";
-export type { CesiumEntityAdapterErrorCode, CesiumEntityCollectionTarget, CesiumEntityDiagnostic, CesiumEntityDiagnosticCode, CesiumEntityGeometry, CesiumEntityInterval, CesiumEntityProjection, CesiumEntityProjectionItem, CesiumEntityRuntimeLoader, CesiumEntityRuntimeModule, CesiumEntityWorkflowState, MountedCesiumEntitySource, MountSourceToCesiumOptions, ProjectSourceToCesiumOptions, } from "./source-to-cesium.js";
+export { MAPLIBRE_SCENE_CAPABILITIES, RENDERER_WGS84_SPATIAL_CAPABILITIES, applyMapLibreScenePrimitives, compileMapLibreFilters, createMapLibreSceneAdapter, createSceneRuntimeAdapter, diagnoseScenePrimitive, diagnoseScenePrimitives, summarizeDiagnosticStatus, toMapLibreExtrusionLayer, toMapLibreTerrainPatch, } from "./primitives.js";
+export { CESIUM_SCENE_CAPABILITIES, addCesium3DTileset, addCesiumImageryLayer, addCesiumModel, applyCameraStateToCesiumCamera, applyCesiumScenePrimitives, applyCesiumTerrain, applyHonua3DStyle, applyTilesetServerStyle, cameraStateToCesiumView, cesiumCameraToSceneState, createCesiumSceneAdapter, fetchHonua3DStyleSpec, honua3DStyleToCesiumStyleOptions, loadHonua3DStyle, modelLayerToCesiumPlacement, pickCesiumFeatureAttributes, readHonua3DStyleDescriptor, resolveCesiumModelScale, resolveHonua3DStyleUri, resolvePickedFeatureAttributes, setTilesetStyle, } from "./cesium-adapter.js";
+export { SCENE_REBUILD_BOUNDARIES, applyCesiumClockPlan, applyCesiumSceneTime, bindTemporalPlaybackToCesium, cesiumClockPlanWrites, isCesiumClockRuntime, readCesiumClock, restoreCesiumClock, sceneRebuildBoundaryReport, sceneTimelineToCesiumClockPlan, } from "./cesium-time.js";
+export type { BindTemporalPlaybackToCesiumOptions, CesiumClockLike, CesiumClockOwnership, CesiumClockPlan, CesiumClockRuntimeLoader, CesiumClockRuntimeModule, CesiumClockSnapshot, CesiumClockTarget, CesiumSceneTimeApplication, CesiumTemporalPlayback, CesiumTemporalPlaybackBinding, CesiumTemporalPlaybackInstant, CesiumTemporalPlaybackRefusal, CesiumTemporalPlaybackTransport, CesiumTemporalPlaybackWindow, SceneRebuildBoundary, SceneRebuildBoundaryReport, SceneTimeDiagnosticCode, } from "./cesium-time.js";
+export { DEFAULT_SCENE_MOUNT_LAYER_LIMIT, HonuaCesiumSceneMountError, mountScenePrimitivesToCesium, } from "./cesium-mount.js";
+export type { ApplyMountedScenePrimitivesOptions, CesiumSceneMountErrorCode, CesiumSceneMountState, MountedCesiumScenePrimitives, MountedScenePrimitiveApplyResult, MountScenePrimitivesToCesiumOptions, } from "./cesium-mount.js";
+export type { AddCesium3DTilesetOptions, CesiumCameraLike, CesiumCameraView, CesiumHeadingPitchRollRadians, CesiumImageryLayerCollectionLike, CesiumImageryLayerLike, CesiumImageryProviderLike, CesiumLayerHandle, CesiumModelLike, CesiumModelPlacement, CesiumPrimitiveCollectionLike, CesiumSceneLike, CesiumSceneMaterializationOptions, CesiumSceneRuntimeTarget, CesiumTilesetLike, Honua3DStyleConditions, Honua3DStyleDescriptor, Honua3DStyleSpec, } from "./cesium-adapter.js";
+export { CESIUM_ENTITY_REBUILD_BOUNDARIES, DEFAULT_CESIUM_ENTITY_LIMIT, HonuaCesiumEntityAdapterError, mountSourceToCesium, projectSourceToCesium, } from "./source-to-cesium.js";
+export type { CesiumEntityAdapterErrorCode, CesiumEntityCollectionTarget, CesiumEntityDiagnostic, CesiumEntityDiagnosticCode, CesiumEntityGeometry, CesiumEntityInterval, CesiumEntityProjection, CesiumEntityProjectionItem, CesiumEntityPositionSample, CesiumEntityRebuildBoundary, CesiumEntityRebuildBoundaryReport, CesiumEntityRefreshResult, CesiumEntityRuntimeLoader, CesiumEntityRuntimeModule, CesiumEntityTimeOptions, CesiumEntityWorkflowState, MountedCesiumEntitySource, MountSourceToCesiumOptions, ProjectSourceToCesiumOptions, } from "./source-to-cesium.js";
+export { DEFAULT_CESIUM_SCENE_SOURCE_LIMIT, HonuaCesiumSceneOwnerError, mountCesiumScene, } from "./cesium-scene-owner.js";
+export type { CesiumSceneOwnerErrorCode, CesiumSceneOwnerState, CesiumSceneOwnerTarget, MountCesiumSceneOptions, MountedCesiumScene, } from "./cesium-scene-owner.js";
 export { buildElevationProfilePath, buildLineOfSightBody, buildViewshedBody, formatMeasurementLabel, haversineMeters, measureScenePositions, pathLengthMeters, positionsToWktLineString, renderElevationProfilePolyline, renderLineOfSight, renderMeasurement, renderViewshed, requestElevationProfile, requestLineOfSight, requestViewshed, slantDistanceMeters, sphericalPolygonAreaSquareMeters, } from "./analysis-widgets.js";
 export type { CesiumEntityCollectionLike, ElevationProfileRequest, ElevationProfileResult, ElevationProfileSample, LineOfSightRequest, LineOfSightResult, SceneAnalysisCesiumModule, SceneAnalysisOverlay, SceneAnalysisPosition, SceneAnalysisRequestExecutor, SceneMeasurement, ViewshedRequest, ViewshedResult, ViewshedSample, } from "./analysis-widgets.js";
 export { getScene, listScenes, normalizeScene, resolveSceneTilesetUrl, sceneCameraPrimitive, sceneLayerStates, sceneTerrainPrimitive, sceneTilesetPrimitive, sceneToRuntimePrimitives, sceneViewpointBookmarks, } from "./scene-discovery.js";
@@ -20,6 +52,6 @@ export type { HonuaScene, SceneDiscoveryRequestExecutor, SceneExtent3D, SceneVie
 export { SceneView } from "./scene-view.js";
 export type { SceneViewEvent, SceneViewEventListener, SceneViewOptions, SceneViewRequestExecutor, } from "./scene-view.js";
 export { SCENE_WORKSPACE_SLICES } from "./types.js";
-export type { MapLibreExtrusionLayerSpecification, MapLibreSceneRuntimeTarget, MapLibreTerrainOptions, MapLibreTerrainPatch, MapLibreTerrainSourceSpecification, SceneCacheMetadata, SceneCameraPrimitive, SceneElevationSourcePrimitive, SceneElevationSourceProtocol, SceneExtrusionPrimitive, SceneExtrusionValue, SceneGroundPrimitive, SceneLayerMetadataPrimitive, SceneModelFormat, SceneModelLayerPrimitive, ScenePrimitiveApplyResult, ScenePrimitiveDiagnostic, ScenePrimitiveDiagnosticSeverity, ScenePrimitiveStatus, SceneRendererKind, SceneRuntimeAdapter, SceneRuntimeCapabilities, SceneRuntimePrimitive, SceneRuntimePrimitiveKind, } from "./primitives.js";
+export type { MapLibreExtrusionLayerSpecification, MapLibreSceneRuntimeTarget, MapLibreTerrainOptions, MapLibreTerrainPatch, MapLibreTerrainSourceSpecification, SceneCacheMetadata, SceneCameraPrimitive, SceneElevationSourcePrimitive, SceneElevationSourceProtocol, SceneExtrusionPrimitive, SceneExtrusionValue, SceneGroundPrimitive, SceneImageryLayerPrimitive, SceneImagerySourceProtocol, SceneLayerMetadataPrimitive, SceneModelFormat, SceneModelLayerPrimitive, ScenePointCloudShading, ScenePrimitiveApplyResult, ScenePrimitiveDiagnostic, ScenePrimitiveDiagnosticSeverity, ScenePrimitiveStatus, SceneRendererKind, SceneRuntimeAdapter, SceneRuntimeCapabilities, SceneRuntimePrimitive, SceneRuntimePrimitiveKind, SceneSpatialCapabilities, SceneSpatialFidelity, SceneSpatialPrecision, SceneSpatialPrecisionFloor, SceneSpatialReference, } from "./primitives.js";
 export type { SceneBookmark, SceneCameraState, SceneDetailState, SceneEvidenceReference, SceneLayerState, SceneRealtimeState, SceneTimelineState, SceneWorkspace, SceneWorkspaceAdapterEvent, SceneWorkspaceChangeEvent, SceneWorkspaceHistoryEntry, SceneWorkspaceIntent, SceneWorkspaceListener, SceneWorkspaceSlice, SceneWorkspaceSnapshot, SceneWorkspaceState, SceneWorkspaceUnsubscribe, } from "./types.js";
 //# sourceMappingURL=index.d.ts.map

package/scene-workspace/index.d.ts.map

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

package/scene-workspace/index.js

@@ -1,15 +1,40 @@
 /**
- * `@honua/sdk-js/scene-workspace` — framework-neutral 3D scene workspace state.
+ * `@honua/app-platform/scene-workspace` — framework-neutral 3D scene workspace
+ * state and the Cesium renderer adapter. `@honua/sdk-js/scene-workspace` is a
+ * deprecated 0.1.x forwarder onto this module.
  *
- * @experimental This entrypoint is not yet covered by the SDK's semver contract
- *   — the surface may change in any minor release prior to `1.0.0`.
+ * This barrel carries two support tiers, and they are enumerated symbol by
+ * symbol in `config/support-manifest.v1.json` (projected into
+ * `config/public-surface.json`) rather than inferred from the directory. The
+ * support gate fails on an export that no tier classifies, so nothing is
+ * promoted by proximity.
+ *
+ * @beta The renderer-neutral workspace state, the scene primitive contract, and
+ *   the Cesium primitive adapter keep their shape through `@honua/app-platform`
+ *   0.1.x: no export is renamed or removed, primitive discriminants and
+ *   diagnostic codes grow additively only, and Cesium stays a lazily imported
+ *   optional peer. Additive union members can still require a new arm in an
+ *   exhaustive `switch`, the `cesium` peer floor can rise within 0.1.x, and the
+ *   server-authored 3D style types track the Honua Server styling contract.
+ * @experimental Held back from the beta tier: Honua Server scene discovery, the
+ *   `SceneView` container, and the elevation/analysis widgets (server-attached,
+ *   outside the open-endpoint evidence), plus the bounded accepted-plan
+ *   `Source`-to-Cesium-entity slice and the `mountCesiumScene` owner that
+ *   composes it with the primitive mount. Those may change in any minor release.
  * @module
  */
 export { createSceneWorkspace, emptySceneWorkspaceState, reduceSceneWorkspaceState, sceneWorkspaceIntentFromAdapterEvent, selectSceneDiagnosticsByStatus, selectSceneEvidenceForFeature, selectScenePrimitivesByKind, selectSceneVisibleLayers, } from "./workspace.js";
-export { SCENE_STATE_SYNC_KIND, SCENE_STATE_SYNC_SLICES, SCENE_STATE_SYNC_VERSION, HonuaSceneStateSyncError, createSceneStateSynchronizer, defaultSceneStateSyncMappings, } from "./state-sync.js";
-export { MAPLIBRE_SCENE_CAPABILITIES, applyMapLibreScenePrimitives, createMapLibreSceneAdapter, createSceneRuntimeAdapter, diagnoseScenePrimitive, diagnoseScenePrimitives, summarizeDiagnosticStatus, toMapLibreExtrusionLayer, toMapLibreTerrainPatch, } from "./primitives.js";
-export { CESIUM_SCENE_CAPABILITIES, addCesium3DTileset, addCesiumModel, applyCameraStateToCesiumCamera, applyCesiumScenePrimitives, applyCesiumTerrain, applyHonua3DStyle, applyTilesetServerStyle, cameraStateToCesiumView, cesiumCameraToSceneState, createCesiumSceneAdapter, fetchHonua3DStyleSpec, honua3DStyleToCesiumStyleOptions, loadHonua3DStyle, modelLayerToCesiumPlacement, pickCesiumFeatureAttributes, readHonua3DStyleDescriptor, resolveCesiumModelScale, resolveHonua3DStyleUri, resolvePickedFeatureAttributes, setTilesetStyle, } from "./cesium-adapter.js";
-export { DEFAULT_CESIUM_ENTITY_LIMIT, HonuaCesiumEntityAdapterError, mountSourceToCesium, projectSourceToCesium, } from "./source-to-cesium.js";
+export { SCENE_STATE_SYNC_KIND, SCENE_STATE_SYNC_SLICES, SCENE_STATE_SYNC_SLICE_WORKSPACE_CROSSWALK, SCENE_STATE_SYNC_VERSION, HonuaSceneStateSyncError, createSceneStateSynchronizer, defaultSceneStateSyncMappings, } from "./state-sync.js";
+export { DEFAULT_MAPLIBRE_CAMERA_GEOMETRY, DEFAULT_MAPLIBRE_CAMERA_LIMITS, EARTH_CIRCUMFERENCE_METERS, WEB_MERCATOR_MAX_LATITUDE, mapLibreCameraHeightToZoom, mapLibreGroundResolutionMeters, mapLibreViewToSceneCamera, mapLibreZoomToCameraHeight, sceneCameraToMapLibreView, } from "./camera-correspondence.js";
+export { sceneAttributionId, sceneAttributionValue } from "./state-sync-port-kit.js";
+export { createMapLibreStateSyncPort } from "./maplibre-state-sync.js";
+export { createCesiumStateSyncPort } from "./cesium-state-sync.js";
+export { MAPLIBRE_SCENE_CAPABILITIES, RENDERER_WGS84_SPATIAL_CAPABILITIES, applyMapLibreScenePrimitives, compileMapLibreFilters, createMapLibreSceneAdapter, createSceneRuntimeAdapter, diagnoseScenePrimitive, diagnoseScenePrimitives, summarizeDiagnosticStatus, toMapLibreExtrusionLayer, toMapLibreTerrainPatch, } from "./primitives.js";
+export { CESIUM_SCENE_CAPABILITIES, addCesium3DTileset, addCesiumImageryLayer, addCesiumModel, applyCameraStateToCesiumCamera, applyCesiumScenePrimitives, applyCesiumTerrain, applyHonua3DStyle, applyTilesetServerStyle, cameraStateToCesiumView, cesiumCameraToSceneState, createCesiumSceneAdapter, fetchHonua3DStyleSpec, honua3DStyleToCesiumStyleOptions, loadHonua3DStyle, modelLayerToCesiumPlacement, pickCesiumFeatureAttributes, readHonua3DStyleDescriptor, resolveCesiumModelScale, resolveHonua3DStyleUri, resolvePickedFeatureAttributes, setTilesetStyle, } from "./cesium-adapter.js";
+export { SCENE_REBUILD_BOUNDARIES, applyCesiumClockPlan, applyCesiumSceneTime, bindTemporalPlaybackToCesium, cesiumClockPlanWrites, isCesiumClockRuntime, readCesiumClock, restoreCesiumClock, sceneRebuildBoundaryReport, sceneTimelineToCesiumClockPlan, } from "./cesium-time.js";
+export { DEFAULT_SCENE_MOUNT_LAYER_LIMIT, HonuaCesiumSceneMountError, mountScenePrimitivesToCesium, } from "./cesium-mount.js";
+export { CESIUM_ENTITY_REBUILD_BOUNDARIES, DEFAULT_CESIUM_ENTITY_LIMIT, HonuaCesiumEntityAdapterError, mountSourceToCesium, projectSourceToCesium, } from "./source-to-cesium.js";
+export { DEFAULT_CESIUM_SCENE_SOURCE_LIMIT, HonuaCesiumSceneOwnerError, mountCesiumScene, } from "./cesium-scene-owner.js";
 export { buildElevationProfilePath, buildLineOfSightBody, buildViewshedBody, formatMeasurementLabel, haversineMeters, measureScenePositions, pathLengthMeters, positionsToWktLineString, renderElevationProfilePolyline, renderLineOfSight, renderMeasurement, renderViewshed, requestElevationProfile, requestLineOfSight, requestViewshed, slantDistanceMeters, sphericalPolygonAreaSquareMeters, } from "./analysis-widgets.js";
 export { getScene, listScenes, normalizeScene, resolveSceneTilesetUrl, sceneCameraPrimitive, sceneLayerStates, sceneTerrainPrimitive, sceneTilesetPrimitive, sceneToRuntimePrimitives, sceneViewpointBookmarks, } from "./scene-discovery.js";
 export { SceneView } from "./scene-view.js";