@honua/app-platform 0.0.20-alpha.0

package/scene-workspace/scene-view.js

@@ -0,0 +1,267 @@
+/**
+ * `SceneView` — first-class 3D scene container backed by a Cesium runtime.
+ *
+ * `SceneView` is the 3D counterpart of {@link module:map.HonuaMap}: a cohesive,
+ * typed handle that loads a Honua scene and drives a live Cesium globe through
+ * the renderer-neutral {@link module:scene-workspace/cesium-adapter} (#1196). It
+ * renders the scene's 3D Tiles + terrain + glTF models (#1197) and exposes the
+ * 3D analysis + measurement widgets — line-of-sight, viewshed, measure, and
+ * elevation profile (#1205) — wired to the SDK's request pipeline.
+ *
+ * Like the rest of the scene workspace, this module never imports CesiumJS
+ * statically — the live `Viewer`/`Scene` is supplied by the caller as a
+ * {@link CesiumSceneRuntimeTarget}, and the adapter pulls the runtime in lazily
+ * only when it drives the globe. A `SceneView` constructed without a `target`
+ * still loads + diagnoses scenes (useful headless / in tests) but renders
+ * nothing.
+ *
+ * @example
+ * ```ts
+ * import { SceneView } from "@honua/sdk-js/scene-workspace";
+ *
+ * const view = new SceneView({ client, target: { camera: viewer.camera, scene: viewer.scene } });
+ * await view.loadScene("downtown");
+ * view.on((event) => { if (event.type === "scene-loaded") console.log(event.scene.title); });
+ *
+ * const los = await view.lineOfSight({
+ *   datasetId: "dem",
+ *   observer: { longitude: -157.8, latitude: 21.3, height: 30 },
+ *   target: { longitude: -157.81, latitude: 21.31 },
+ *   entities: viewer.entities,
+ * });
+ * ```
+ *
+ * @experimental Part of the experimental `scene-workspace` surface; not yet
+ *   covered by the SDK's semver contract prior to `1.0.0`.
+ * @module
+ */
+import { measureScenePositions, renderElevationProfilePolyline, renderLineOfSight, renderMeasurement, renderViewshed, requestElevationProfile, requestLineOfSight, requestViewshed, } from "./analysis-widgets.js";
+import { applyCesiumScenePrimitives, cesiumCameraToSceneState, } from "./cesium-adapter.js";
+import { getScene, listScenes, sceneLayerStates, sceneToRuntimePrimitives, sceneViewpointBookmarks, } from "./scene-discovery.js";
+/**
+ * First-class 3D scene container. Loads a Honua scene, renders it through the
+ * Cesium adapter, and exposes the analysis/measurement widgets.
+ */
+export class SceneView {
+    #execute;
+    #target;
+    #baseUrl;
+    #listeners = new Set();
+    #layerHandles = new Map();
+    #scene;
+    #layers = [];
+    #bookmarks = [];
+    #diagnostics = [];
+    constructor(options) {
+        const execute = options.execute ?? bindClientExecutor(options.client);
+        if (!execute) {
+            throw new Error("SceneView requires either a `client` or an explicit `execute` transport.");
+        }
+        this.#execute = execute;
+        this.#target = options.target;
+        this.#baseUrl = options.baseUrl ?? options.client?.serverBaseUrl;
+    }
+    // ── Discovery ───────────────────────────────────────────────
+    /** List the catalog of available 3D scenes (`GET /api/scenes`). */
+    listScenes(signal) {
+        return listScenes(this.#discoveryExecutor(), signal);
+    }
+    /** Fetch a single scene's metadata without loading it (`GET /api/scenes/{id}`). */
+    getScene(sceneId, signal) {
+        return getScene(this.#discoveryExecutor(), sceneId, signal);
+    }
+    // ── Loading / rendering ─────────────────────────────────────
+    /**
+     * Load a scene by id (or a pre-fetched {@link HonuaScene}) and render it onto
+     * the live target: the initial camera, terrain provider, and 3D-Tiles
+     * tileset. Replaces any previously loaded scene's layers. Returns the loaded
+     * scene. When no target is attached the scene is loaded + diagnosed but not
+     * rendered.
+     */
+    async loadScene(scene, signal) {
+        const resolved = typeof scene === "string" ? await this.getScene(scene, signal) : scene;
+        this.#teardownLayers();
+        this.#scene = resolved;
+        this.#bookmarks = sceneViewpointBookmarks(resolved);
+        this.#layers = sceneLayerStates(resolved, this.#baseUrl);
+        if (this.#target) {
+            const primitives = sceneToRuntimePrimitives(resolved, this.#baseUrl);
+            const result = await applyCesiumScenePrimitives(this.#target, primitives);
+            this.#diagnostics = result.diagnostics;
+            for (const [id, handle] of result.layers)
+                this.#layerHandles.set(id, handle);
+            this.#emit({ type: "diagnostics", diagnostics: this.#diagnostics });
+        }
+        this.#emit({ type: "scene-loaded", scene: resolved });
+        this.#emit({ type: "layers-changed", layers: this.#layers });
+        return resolved;
+    }
+    /** The currently loaded scene, or `undefined` before the first `loadScene`. */
+    get scene() {
+        return this.#scene;
+    }
+    /** Snapshot of the loaded scene's layers (one per rendered primitive). */
+    get layers() {
+        return this.#layers;
+    }
+    /** The loaded scene's named viewpoints as workspace bookmarks. */
+    get bookmarks() {
+        return this.#bookmarks;
+    }
+    /** Diagnostics from the most recent render (capability gaps, fallbacks). */
+    get diagnostics() {
+        return this.#diagnostics;
+    }
+    /** Whether a live Cesium target is attached (and therefore rendering). */
+    get hasTarget() {
+        return this.#target !== undefined;
+    }
+    /**
+     * Toggle a rendered layer's visibility on the live globe and in the layer
+     * snapshot. No-ops (still updates the snapshot) when the layer is not rendered
+     * (e.g. no target attached). Returns `true` when the layer is known.
+     */
+    setLayerVisible(layerId, visible) {
+        const layer = this.#layers.find((entry) => entry.id === layerId);
+        if (!layer)
+            return false;
+        this.#layerHandles.get(layerId)?.setVisible(visible);
+        this.#layers = this.#layers.map((entry) => (entry.id === layerId ? { ...entry, visible } : entry));
+        this.#emit({ type: "layer-visibility", layerId, visible });
+        this.#emit({ type: "layers-changed", layers: this.#layers });
+        return true;
+    }
+    // ── Camera ──────────────────────────────────────────────────
+    /**
+     * Read the live camera back as a renderer-neutral {@link SceneCameraState},
+     * or `undefined` when no target is attached. Also emits a `camera-change`
+     * event so subscribers can persist the current view.
+     */
+    readCamera() {
+        if (!this.#target)
+            return undefined;
+        const camera = cesiumCameraToSceneState(this.#target.camera);
+        this.#emit({ type: "camera-change", camera });
+        return camera;
+    }
+    /**
+     * Fly/jump to a named viewpoint (bookmark) on the loaded scene. Returns the
+     * applied camera state, or `undefined` when the viewpoint is unknown. The
+     * actual `Camera.setView` is performed through the adapter so no static Cesium
+     * import is needed here.
+     */
+    async applyBookmark(bookmarkId) {
+        const bookmark = this.#bookmarks.find((entry) => entry.id === bookmarkId);
+        if (!bookmark)
+            return undefined;
+        return this.setCamera(bookmark.camera);
+    }
+    /**
+     * Set the live camera to an explicit {@link SceneCameraState}. Returns the
+     * applied state (or `undefined` when no target is attached). Routed through
+     * the adapter's camera primitive so the lazy Cesium import stays centralized.
+     */
+    async setCamera(camera) {
+        if (!this.#target)
+            return undefined;
+        await applyCesiumScenePrimitives(this.#target, [
+            { kind: "camera", id: "scene-view:set-camera", camera, mode: "global" },
+        ]);
+        this.#emit({ type: "camera-change", camera });
+        return camera;
+    }
+    // ── Analysis + measurement widgets (#1205) ──────────────────
+    /**
+     * Run a line-of-sight analysis between an observer and a target. When an
+     * `entities` collection is supplied the sightline + obstruction marker are
+     * drawn into the scene and the overlay handle is returned alongside the
+     * result.
+     */
+    async lineOfSight(request) {
+        const result = await requestLineOfSight(this.#analysisExecutor(), request);
+        if (!request.entities)
+            return { result };
+        const overlay = await renderLineOfSight(request.entities, request, result, request.cesium);
+        return { result, overlay };
+    }
+    /**
+     * Run a viewshed analysis from an observer position. When an `entities`
+     * collection is supplied the radial visibility samples are drawn into the
+     * scene and the overlay handle is returned alongside the result.
+     */
+    async viewshed(request) {
+        const result = await requestViewshed(this.#analysisExecutor(), request);
+        if (!request.entities)
+            return { result };
+        const overlay = await renderViewshed(request.entities, result, request.cesium);
+        return { result, overlay };
+    }
+    /**
+     * Request an elevation profile along a polyline. When an `entities`
+     * collection is supplied the draped profile line is drawn into the scene and
+     * the overlay handle is returned alongside the result.
+     */
+    async elevationProfile(request) {
+        const result = await requestElevationProfile(this.#analysisExecutor(), request);
+        if (!request.entities)
+            return { result };
+        const overlay = await renderElevationProfilePolyline(request.entities, request.polyline, request.cesium);
+        return { result, overlay };
+    }
+    /**
+     * Compute a fully client-side 3D distance or area measurement from an ordered
+     * list of positions (typically picked off the scene). When an `entities`
+     * collection is supplied the measured polyline/polygon + label are drawn into
+     * the scene and the overlay handle is returned alongside the measurement.
+     */
+    async measure(positions, options = {}) {
+        const measurement = measureScenePositions(positions, options.mode ?? "distance");
+        if (!options.entities)
+            return { measurement };
+        const overlay = await renderMeasurement(options.entities, measurement, options.cesium);
+        return { measurement, overlay };
+    }
+    // ── Events / lifecycle ──────────────────────────────────────
+    /** Subscribe to view events. Returns a handle with `remove()` to unsubscribe. */
+    on(listener) {
+        this.#listeners.add(listener);
+        return {
+            remove: () => {
+                this.#listeners.delete(listener);
+            },
+        };
+    }
+    /**
+     * Tear down all rendered layers and clear listeners. The supplied Cesium
+     * target is owned by the caller and is NOT destroyed.
+     */
+    dispose() {
+        this.#teardownLayers();
+        this.#listeners.clear();
+        this.#scene = undefined;
+        this.#layers = [];
+        this.#bookmarks = [];
+        this.#diagnostics = [];
+    }
+    // ── Internals ───────────────────────────────────────────────
+    #discoveryExecutor() {
+        return this.#execute;
+    }
+    #analysisExecutor() {
+        return this.#execute;
+    }
+    #teardownLayers() {
+        for (const handle of this.#layerHandles.values())
+            handle.remove();
+        this.#layerHandles.clear();
+    }
+    #emit(event) {
+        for (const listener of this.#listeners)
+            listener(event);
+    }
+}
+function bindClientExecutor(client) {
+    if (!client)
+        return undefined;
+    return (method, path, init, signal) => client.pipelineRequestJson(method, path, init, signal);
+}

package/scene-workspace/types.d.ts

@@ -0,0 +1,229 @@
+/**
+ * Renderer-neutral 3D scene workspace contracts.
+ *
+ * These types intentionally describe state and adapter events without
+ * importing Cesium, MapLibre, or any rendering package.
+ *
+ * @module
+ */
+import type { FeatureId, SourceId } from "../contract/types.js";
+import type { FeatureSelectionTarget, FilterClause } from "../exploration/index.js";
+import type { RealtimeConnectionStatus } from "../realtime/index.js";
+import type { ScenePrimitiveDiagnostic, SceneRuntimePrimitive } from "./primitives.js";
+export type SceneWorkspaceSlice = "all" | "scene" | "camera" | "layers" | "primitives" | "diagnostics" | "filters" | "detail" | "selection" | "timeline" | "evidence" | "realtime" | "history";
+export declare const SCENE_WORKSPACE_SLICES: readonly SceneWorkspaceSlice[];
+export interface SceneLayerState {
+    readonly id: string;
+    readonly sourceId?: SourceId;
+    readonly title?: string;
+    readonly visible: boolean;
+    readonly opacity?: number;
+    readonly kind?: "scene" | "feature" | "imagery" | "tiles" | "evidence" | "custom";
+}
+export interface SceneCameraState {
+    readonly longitude: number;
+    readonly latitude: number;
+    readonly height: number;
+    readonly heading?: number;
+    readonly pitch?: number;
+    readonly roll?: number;
+}
+export interface SceneBookmark {
+    readonly id: string;
+    readonly label: string;
+    readonly camera: SceneCameraState;
+}
+export interface SceneTimelineState {
+    readonly currentTime?: string;
+    readonly startTime?: string;
+    readonly endTime?: string;
+    readonly playing?: boolean;
+    readonly progress?: number;
+}
+export interface SceneEvidenceReference {
+    readonly id: string;
+    readonly label: string;
+    readonly kind: "image" | "video" | "document" | "point-cloud" | "model" | "sensor" | "custom";
+    readonly sourceId?: SourceId;
+    readonly featureId?: FeatureId;
+    readonly url?: string;
+    readonly metadata?: Readonly<Record<string, unknown>>;
+}
+export interface SceneRealtimeState {
+    readonly status: RealtimeConnectionStatus;
+    readonly cursor?: string;
+    readonly staleSince?: number;
+}
+export interface SceneDetailState {
+    readonly target?: FeatureSelectionTarget;
+    readonly sourceId?: SourceId;
+    readonly featureId?: FeatureId;
+    readonly title?: string;
+    readonly status?: "empty" | "loading" | "ready" | "stale" | "error";
+    readonly attributes?: Readonly<Record<string, unknown>>;
+}
+export interface SceneWorkspaceState {
+    readonly sceneId?: string;
+    readonly title?: string;
+    readonly layers: Readonly<Record<string, SceneLayerState>>;
+    readonly primitives: Readonly<Record<string, SceneRuntimePrimitive>>;
+    readonly diagnostics: ReadonlyArray<ScenePrimitiveDiagnostic>;
+    readonly filters: Readonly<Record<string, FilterClause>>;
+    readonly detail: SceneDetailState;
+    readonly camera?: SceneCameraState;
+    readonly bookmarks: Readonly<Record<string, SceneBookmark>>;
+    readonly selection: ReadonlyArray<FeatureSelectionTarget>;
+    readonly activeAssetId?: FeatureId;
+    readonly timeline: SceneTimelineState;
+    readonly evidence: Readonly<Record<string, SceneEvidenceReference>>;
+    readonly realtime: SceneRealtimeState;
+    readonly history: ReadonlyArray<SceneWorkspaceHistoryEntry>;
+}
+export interface SceneWorkspaceHistoryEntry {
+    readonly id: string;
+    readonly label: string;
+    readonly at: string;
+    readonly intentKind: SceneWorkspaceIntent["kind"];
+}
+export interface SceneWorkspaceSnapshot {
+    readonly version: 1;
+    readonly state: SceneWorkspaceState;
+}
+export type SceneWorkspaceIntent = SetSceneIntent | SetSceneLayersIntent | SetScenePrimitivesIntent | SetSceneDiagnosticsIntent | SetLayerVisibilityIntent | SetCameraIntent | ApplyBookmarkIntent | SetSceneFilterIntent | ClearSceneFilterIntent | SetSelectionIntent | ClearSelectionIntent | SetSceneDetailIntent | SetActiveAssetIntent | SetTimelineIntent | AddEvidenceIntent | RemoveEvidenceIntent | SetRealtimeIntent | RestoreSceneWorkspaceIntent;
+interface IntentBase {
+    readonly source?: "scene" | "map" | "table" | "detail" | "timeline" | "realtime" | "workspace" | "custom";
+    readonly historyLabel?: string;
+    readonly at?: string;
+}
+export interface SetSceneIntent extends IntentBase {
+    readonly kind: "set-scene";
+    readonly sceneId: string | undefined;
+    readonly title?: string;
+}
+export interface SetSceneLayersIntent extends IntentBase {
+    readonly kind: "set-layers";
+    readonly layers: ReadonlyArray<SceneLayerState>;
+}
+export interface SetScenePrimitivesIntent extends IntentBase {
+    readonly kind: "set-primitives";
+    readonly primitives: ReadonlyArray<SceneRuntimePrimitive>;
+}
+export interface SetSceneDiagnosticsIntent extends IntentBase {
+    readonly kind: "set-diagnostics";
+    readonly diagnostics: ReadonlyArray<ScenePrimitiveDiagnostic>;
+}
+export interface SetLayerVisibilityIntent extends IntentBase {
+    readonly kind: "set-layer-visibility";
+    readonly layerId: string;
+    readonly visible: boolean;
+}
+export interface SetCameraIntent extends IntentBase {
+    readonly kind: "set-camera";
+    readonly camera: SceneCameraState | undefined;
+}
+export interface ApplyBookmarkIntent extends IntentBase {
+    readonly kind: "apply-bookmark";
+    readonly bookmark: SceneBookmark;
+}
+export interface SetSceneFilterIntent extends IntentBase {
+    readonly kind: "set-filter";
+    readonly id: string;
+    readonly clause: FilterClause;
+}
+export interface ClearSceneFilterIntent extends IntentBase {
+    readonly kind: "clear-filter";
+    readonly id: string;
+}
+export interface SetSelectionIntent extends IntentBase {
+    readonly kind: "set-selection";
+    readonly selection: ReadonlyArray<FeatureSelectionTarget>;
+}
+export interface ClearSelectionIntent extends IntentBase {
+    readonly kind: "clear-selection";
+}
+export interface SetSceneDetailIntent extends IntentBase {
+    readonly kind: "set-detail";
+    readonly detail: SceneDetailState;
+}
+export interface SetActiveAssetIntent extends IntentBase {
+    readonly kind: "set-active-asset";
+    readonly id: FeatureId | undefined;
+}
+export interface SetTimelineIntent extends IntentBase {
+    readonly kind: "set-timeline";
+    readonly timeline: SceneTimelineState;
+}
+export interface AddEvidenceIntent extends IntentBase {
+    readonly kind: "add-evidence";
+    readonly evidence: SceneEvidenceReference;
+}
+export interface RemoveEvidenceIntent extends IntentBase {
+    readonly kind: "remove-evidence";
+    readonly id: string;
+}
+export interface SetRealtimeIntent extends IntentBase {
+    readonly kind: "set-realtime";
+    readonly realtime: SceneRealtimeState;
+}
+export interface RestoreSceneWorkspaceIntent extends IntentBase {
+    readonly kind: "restore";
+    readonly snapshot: SceneWorkspaceSnapshot;
+}
+export type SceneWorkspaceAdapterEvent = SceneWorkspaceCameraEvent | SceneWorkspaceLayerVisibilityEvent | SceneWorkspacePrimitiveDiagnosticsEvent | SceneWorkspaceFilterEvent | SceneWorkspaceSelectionEvent | SceneWorkspaceDetailEvent | SceneWorkspaceTimelineEvent | SceneWorkspaceEvidenceEvent | SceneWorkspaceRealtimeEvent;
+export interface SceneWorkspaceCameraEvent {
+    readonly type: "camera-change";
+    readonly camera: SceneCameraState | undefined;
+}
+export interface SceneWorkspaceLayerVisibilityEvent {
+    readonly type: "layer-visibility-change";
+    readonly layerId: string;
+    readonly visible: boolean;
+}
+export interface SceneWorkspacePrimitiveDiagnosticsEvent {
+    readonly type: "primitive-diagnostics";
+    readonly diagnostics: ReadonlyArray<ScenePrimitiveDiagnostic>;
+}
+export interface SceneWorkspaceFilterEvent {
+    readonly type: "filter-change";
+    readonly id: string;
+    readonly clause: FilterClause | undefined;
+}
+export interface SceneWorkspaceSelectionEvent {
+    readonly type: "selection-change";
+    readonly selection: ReadonlyArray<FeatureSelectionTarget>;
+}
+export interface SceneWorkspaceDetailEvent {
+    readonly type: "detail-change";
+    readonly detail: SceneDetailState;
+}
+export interface SceneWorkspaceTimelineEvent {
+    readonly type: "timeline-change";
+    readonly timeline: SceneTimelineState;
+}
+export interface SceneWorkspaceEvidenceEvent {
+    readonly type: "evidence-add" | "evidence-remove";
+    readonly evidence?: SceneEvidenceReference;
+    readonly id?: string;
+}
+export interface SceneWorkspaceRealtimeEvent {
+    readonly type: "realtime-status";
+    readonly realtime: SceneRealtimeState;
+}
+export interface SceneWorkspaceChangeEvent {
+    readonly state: SceneWorkspaceState;
+    readonly previous: SceneWorkspaceState;
+    readonly changedSlices: ReadonlySet<SceneWorkspaceSlice>;
+    readonly intent: SceneWorkspaceIntent;
+}
+export type SceneWorkspaceListener = (event: SceneWorkspaceChangeEvent) => void;
+export type SceneWorkspaceUnsubscribe = () => void;
+export interface SceneWorkspace {
+    readonly state: SceneWorkspaceState;
+    dispatch(intent: SceneWorkspaceIntent): SceneWorkspaceState;
+    subscribe(slice: SceneWorkspaceSlice, listener: SceneWorkspaceListener): SceneWorkspaceUnsubscribe;
+    snapshot(): SceneWorkspaceSnapshot;
+    restore(snapshot: SceneWorkspaceSnapshot): SceneWorkspaceState;
+    dispose(): void;
+}
+export {};
+//# sourceMappingURL=types.d.ts.map

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

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

package/scene-workspace/types.js

@@ -0,0 +1,23 @@
+/**
+ * Renderer-neutral 3D scene workspace contracts.
+ *
+ * These types intentionally describe state and adapter events without
+ * importing Cesium, MapLibre, or any rendering package.
+ *
+ * @module
+ */
+export const SCENE_WORKSPACE_SLICES = [
+    "all",
+    "scene",
+    "camera",
+    "layers",
+    "primitives",
+    "diagnostics",
+    "filters",
+    "detail",
+    "selection",
+    "timeline",
+    "evidence",
+    "realtime",
+    "history",
+];

package/scene-workspace/workspace.d.ts

@@ -0,0 +1,13 @@
+import type { ScenePrimitiveDiagnostic, SceneRuntimePrimitive } from "./primitives.js";
+import type { SceneEvidenceReference, SceneLayerState, SceneWorkspace, SceneWorkspaceAdapterEvent, SceneWorkspaceIntent, SceneWorkspaceState } from "./types.js";
+export declare function emptySceneWorkspaceState(): SceneWorkspaceState;
+export declare function createSceneWorkspace(initialState?: Partial<SceneWorkspaceState>): SceneWorkspace;
+export declare function reduceSceneWorkspaceState(state: SceneWorkspaceState, intent: SceneWorkspaceIntent): SceneWorkspaceState;
+export declare function sceneWorkspaceIntentFromAdapterEvent(event: SceneWorkspaceAdapterEvent, source?: SceneWorkspaceIntent["source"]): SceneWorkspaceIntent;
+export declare function selectSceneVisibleLayers(state: SceneWorkspaceState): SceneLayerState[];
+export declare function selectScenePrimitivesByKind<K extends SceneRuntimePrimitive["kind"]>(state: SceneWorkspaceState, kind: K): Array<Extract<SceneRuntimePrimitive, {
+    readonly kind: K;
+}>>;
+export declare function selectSceneDiagnosticsByStatus(state: SceneWorkspaceState, status: ScenePrimitiveDiagnostic["status"]): ScenePrimitiveDiagnostic[];
+export declare function selectSceneEvidenceForFeature(state: SceneWorkspaceState, featureId: string | number | undefined): SceneEvidenceReference[];
+//# sourceMappingURL=workspace.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"workspace.d.ts","sourceRoot":"","sources":["../../../src/scene-workspace/workspace.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,wBAAwB,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AACvF,OAAO,KAAK,EACV,sBAAsB,EACtB,eAAe,EACf,cAAc,EACd,0BAA0B,EAE1B,oBAAoB,EAIpB,mBAAmB,EAEpB,MAAM,YAAY,CAAC;AAEpB,wBAAgB,wBAAwB,IAAI,mBAAmB,CAc9D;AAED,wBAAgB,oBAAoB,CAAC,YAAY,GAAE,OAAO,CAAC,mBAAmB,CAAM,GAAG,cAAc,CAoDpG;AAED,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,mBAAmB,EAC1B,MAAM,EAAE,oBAAoB,GAC3B,mBAAmB,CAGrB;AAED,wBAAgB,oCAAoC,CAClD,KAAK,EAAE,0BAA0B,EACjC,MAAM,GAAE,oBAAoB,CAAC,QAAQ,CAAW,GAC/C,oBAAoB,CA4CtB;AAED,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,mBAAmB,GAAG,eAAe,EAAE,CAEtF;AAED,wBAAgB,2BAA2B,CAAC,CAAC,SAAS,qBAAqB,CAAC,MAAM,CAAC,EACjF,KAAK,EAAE,mBAAmB,EAC1B,IAAI,EAAE,CAAC,GACN,KAAK,CAAC,OAAO,CAAC,qBAAqB,EAAE;IAAE,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAA;CAAE,CAAC,CAAC,CAI7D;AAED,wBAAgB,8BAA8B,CAC5C,KAAK,EAAE,mBAAmB,EAC1B,MAAM,EAAE,wBAAwB,CAAC,QAAQ,CAAC,GACzC,wBAAwB,EAAE,CAE5B;AAED,wBAAgB,6BAA6B,CAC3C,KAAK,EAAE,mBAAmB,EAC1B,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,GACrC,sBAAsB,EAAE,CAG1B"}