@geometra/renderer-three 0.2.0 → 1.3.1

package/dist/index.js

@@ -1,7 +1,43 @@
-export { createThreeGeometraSplitHost, } from './split-host.js';
-export { createThreeGeometraStackedHost, } from './stacked-host.js';
-export { resizeGeometraThreePerspectiveView, setWebGLDrawingBufferSize } from './utils.js';
-export { createGeometraThreeSceneBasics, } from './three-scene-basics.js';
-/** Re-export for hybrid apps using {@link createThreeGeometraSplitHost} with `onData`. */
+/**
+ * `@geometra/renderer-three` — split/stacked Three.js + Geometra canvas hosts, WebGL sizing helpers
+ * ({@link resizeGeometraThreePerspectiveView}, {@link toPlainGeometraThreeViewSizingState}, {@link isPlainGeometraThreeViewSizingState}, {@link resizeGeometraThreeDrawingBufferView} / {@link resizeGeometraThreeDrawingBufferViewHeadless}, DPR capping, {@link GEOMETRA_HEADLESS_RAW_DEVICE_PIXEL_RATIO}, {@link resolveHeadlessHostDevicePixelRatio}, {@link createGeometraThreePerspectiveResizeHandlerHeadless}), shared scene defaults
+ * ({@link createGeometraThreeSceneBasics}, {@link resolveGeometraThreeSceneBasicsOptions}, {@link toPlainGeometraThreeSceneBasicsOptions},
+ * {@link createGeometraThreeSceneBasicsFromPlain},
+ * {@link createGeometraThreeWebGLWithSceneBasics}, {@link createGeometraThreeWebGLWithSceneBasicsFromPlain},
+ * {@link resizeGeometraThreeWebGLWithSceneBasicsView}, {@link resizeGeometraThreeWebGLWithSceneBasicsViewHeadless},
+ * {@link resizeGeometraThreeWebGLWithSceneBasicsViewFromPlainViewSizing},
+ * {@link toPlainGeometraThreeViewSizingStateHeadless},
+ * {@link renderGeometraThreeWebGLWithSceneBasicsFrame},
+ * {@link tickGeometraThreeWebGLWithSceneBasicsFrame} (`onFrame` may return `false` to skip `render` and make the tick return `false`; {@link disposeGeometraThreeWebGLWithSceneBasics} inside `onFrame` skips `render` too, like host {@link ThreeRuntimeContext.destroy}; if `onFrame` throws, the error propagates and `render` is not called, matching split/stacked {@link ThreeGeometraSplitHostOptions.onThreeFrame} ordering), {@link resizeTickGeometraThreeWebGLWithSceneBasics} (resize + tick with explicit raw DPR), {@link resizeTickGeometraThreeWebGLWithSceneBasicsFromPlainViewSizing} (resize + tick from plain {@link PlainGeometraThreeViewSizingState}), {@link resizeTickGeometraThreeWebGLWithSceneBasicsFromPlainHostSnapshot} (same from full {@link PlainGeometraThreeHostSnapshot} / composite JSON), {@link resizeTickGeometraThreeWebGLWithSceneBasicsHeadless} (same with raw DPR **1**), {@link disposeGeometraThreeWebGLWithSceneBasics} (optional `clock` stops timing after dispose),
+ * {@link toPlainGeometraThreeHostSnapshot}, {@link toPlainGeometraThreeHostSnapshotHeadless},
+ * {@link toPlainGeometraThreeHostSnapshotFromViewSizing}, {@link mergePlainGeometraThreeHostSnapshot},
+ * {@link toPlainGeometraSplitHostLayoutOptions} / {@link toPlainGeometraStackedHostLayoutOptions},
+ * {@link toPlainGeometraThreeSplitHostSnapshot} / {@link toPlainGeometraThreeStackedHostSnapshot} (and headless variants)
+ * for JSON-stable split/stacked layout plus viewport/scene in one object ({@link isGeometraHybridHostKind}, {@link coerceGeometraHybridHostKind}, {@link GEOMETRA_HYBRID_HOST_KINDS},
+ * {@link isPlainGeometraThreeHostSnapshot}, {@link isPlainGeometraThreeSceneBasicsOptions}, {@link isPlainGeometraSplitHostLayoutOptions}, {@link isPlainGeometraStackedHostLayoutOptions},
+ * {@link isPlainGeometraThreeSplitHostSnapshot}, {@link isPlainGeometraThreeStackedHostSnapshot}, {@link isPlainGeometraHybridHostKind}),
+ * {@link toPlainGeometraStackedHudRect} for stacked HUD box math (same insets as {@link createThreeGeometraStackedHost}), and
+ * {@link createGeometraHostLayoutSyncRaf} for custom hybrid layouts, {@link coerceHostStackingZIndexCss},
+ * {@link coerceGeometraHudPointerEvents}, and {@link coerceGeometraHudPlacement} for stacked-overlay stacking and
+ * HUD corner rules, and {@link GEOMETRA_SPLIT_HOST_LAYOUT_DEFAULTS} /
+ * {@link GEOMETRA_STACKED_HOST_LAYOUT_DEFAULTS} for host layout defaults (custom layouts, logs, agent payloads).
+ */
+export { createThreeGeometraSplitHost, GEOMETRA_SPLIT_HOST_LAYOUT_DEFAULTS, } from './split-host.js';
+export { createThreeGeometraStackedHost, GEOMETRA_STACKED_HOST_LAYOUT_DEFAULTS, } from './stacked-host.js';
+export { GEOMETRA_HEADLESS_RAW_DEVICE_PIXEL_RATIO, createGeometraThreePerspectiveResizeHandler, createGeometraThreePerspectiveResizeHandlerHeadless, geometraHostPerspectiveAspectFromCss, isPlainGeometraThreeViewSizingState, normalizeGeometraLayoutPixels, resizeGeometraThreeDrawingBufferView, resizeGeometraThreeDrawingBufferViewHeadless, resizeGeometraThreePerspectiveView, resolveHeadlessHostDevicePixelRatio, resolveHostDevicePixelRatio, setWebGLDrawingBufferSize, syncGeometraThreePerspectiveFromBuffer, toPlainGeometraThreeViewSizingState, toPlainGeometraThreeViewSizingStateHeadless, } from './utils.js';
+export { GEOMETRA_HOST_WEBGL_RENDERER_OPTIONS, GEOMETRA_THREE_HOST_SCENE_DEFAULTS, createGeometraHostWebGLRendererParams, createGeometraThreeSceneBasics, createGeometraThreeSceneBasicsFromPlain, resolveGeometraThreeSceneBasicsOptions, toPlainGeometraThreeSceneBasicsOptions, toPlainGeometraThreeHostSnapshot, toPlainGeometraThreeHostSnapshotHeadless, toPlainGeometraThreeHostSnapshotFromViewSizing, mergePlainGeometraThreeHostSnapshot, createGeometraThreeWebGLRenderer, createGeometraThreeWebGLWithSceneBasics, createGeometraThreeWebGLWithSceneBasicsFromPlain, disposeGeometraThreeWebGLWithSceneBasics, isPlainGeometraThreeHostSnapshot, isPlainGeometraThreeSceneBasicsOptions, renderGeometraThreeWebGLWithSceneBasicsFrame, tickGeometraThreeWebGLWithSceneBasicsFrame, resizeGeometraThreeWebGLWithSceneBasicsView, resizeGeometraThreeWebGLWithSceneBasicsViewHeadless, resizeGeometraThreeWebGLWithSceneBasicsViewFromPlainViewSizing, resizeTickGeometraThreeWebGLWithSceneBasics, resizeTickGeometraThreeWebGLWithSceneBasicsFromPlainViewSizing, resizeTickGeometraThreeWebGLWithSceneBasicsFromPlainHostSnapshot, resizeTickGeometraThreeWebGLWithSceneBasicsHeadless, } from './three-scene-basics.js';
+export { createGeometraHostLayoutSyncRaf, } from './layout-sync.js';
+export { coerceGeometraHudPlacement, coerceGeometraHudPointerEvents, coerceHostNonNegativeCssPx, coerceHostStackingZIndexCss, } from './host-css-coerce.js';
+export { GEOMETRA_HYBRID_HOST_KINDS, coerceGeometraHybridHostKind, isGeometraHybridHostKind, isPlainGeometraHybridHostKind, isPlainGeometraSplitHostLayoutOptions, isPlainGeometraStackedHostLayoutOptions, isPlainGeometraThreeSplitHostSnapshot, isPlainGeometraThreeStackedHostSnapshot, toPlainGeometraSplitHostLayoutOptions, toPlainGeometraStackedHostLayoutOptions, toPlainGeometraThreeSplitHostSnapshot, toPlainGeometraThreeSplitHostSnapshotHeadless, toPlainGeometraThreeStackedHostSnapshot, toPlainGeometraThreeStackedHostSnapshotHeadless, toPlainGeometraStackedHudRect, } from './host-layout-plain.js';
+/**
+ * WebSocket **data channel** id for tracker snapshot JSON on the GEOM socket (re-exported from
+ * `@geometra/client`). Use in `onData` handlers passed through {@link createThreeGeometraSplitHost} /
+ * {@link createThreeGeometraStackedHost} so comparisons stay aligned with the thin client and agent
+ * payloads without importing `@geometra/client` only for this string.
+ *
+ * The runtime value is **`geom.tracker.snapshot`**; `npm run release:gate` asserts it still matches
+ * the installed `@geometra/client` package.
+ */
 export { GEOM_DATA_CHANNEL_TRACKER_SNAPSHOT } from '@geometra/client';
+export { Scene3dManager } from './scene3d-manager.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,4BAA4B,GAK7B,MAAM,iBAAiB,CAAA;AACxB,OAAO,EACL,8BAA8B,GAI/B,MAAM,mBAAmB,CAAA;AAC1B,OAAO,EAAE,kCAAkC,EAAE,yBAAyB,EAAE,MAAM,YAAY,CAAA;AAC1F,OAAO,EACL,8BAA8B,GAE/B,MAAM,yBAAyB,CAAA;AAEhC,0FAA0F;AAC1F,OAAO,EAAE,kCAAkC,EAAE,MAAM,kBAAkB,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,EACL,4BAA4B,EAC5B,mCAAmC,GAMpC,MAAM,iBAAiB,CAAA;AACxB,OAAO,EACL,8BAA8B,EAC9B,qCAAqC,GAGtC,MAAM,mBAAmB,CAAA;AAC1B,OAAO,EACL,wCAAwC,EACxC,2CAA2C,EAC3C,mDAAmD,EACnD,oCAAoC,EACpC,mCAAmC,EACnC,6BAA6B,EAC7B,oCAAoC,EACpC,4CAA4C,EAC5C,kCAAkC,EAClC,mCAAmC,EACnC,2BAA2B,EAC3B,yBAAyB,EACzB,sCAAsC,EACtC,mCAAmC,EACnC,2CAA2C,GAE5C,MAAM,YAAY,CAAA;AACnB,OAAO,EACL,oCAAoC,EACpC,kCAAkC,EAClC,qCAAqC,EACrC,8BAA8B,EAC9B,uCAAuC,EACvC,sCAAsC,EACtC,sCAAsC,EACtC,gCAAgC,EAChC,wCAAwC,EACxC,8CAA8C,EAC9C,mCAAmC,EACnC,gCAAgC,EAChC,uCAAuC,EACvC,gDAAgD,EAChD,wCAAwC,EACxC,gCAAgC,EAChC,sCAAsC,EACtC,4CAA4C,EAC5C,0CAA0C,EAC1C,2CAA2C,EAC3C,mDAAmD,EACnD,8DAA8D,EAC9D,2CAA2C,EAC3C,8DAA8D,EAC9D,gEAAgE,EAChE,mDAAmD,GAOpD,MAAM,yBAAyB,CAAA;AAChC,OAAO,EACL,+BAA+B,GAGhC,MAAM,kBAAkB,CAAA;AACzB,OAAO,EACL,0BAA0B,EAC1B,8BAA8B,EAC9B,0BAA0B,EAC1B,2BAA2B,GAC5B,MAAM,sBAAsB,CAAA;AAE7B,OAAO,EACL,0BAA0B,EAC1B,4BAA4B,EAC5B,wBAAwB,EACxB,6BAA6B,EAC7B,qCAAqC,EACrC,uCAAuC,EACvC,qCAAqC,EACrC,uCAAuC,EACvC,qCAAqC,EACrC,uCAAuC,EACvC,qCAAqC,EACrC,6CAA6C,EAC7C,uCAAuC,EACvC,+CAA+C,EAC/C,6BAA6B,GAU9B,MAAM,wBAAwB,CAAA;AAE/B;;;;;;;;GAQG;AACH,OAAO,EAAE,kCAAkC,EAAE,MAAM,kBAAkB,CAAA;AAErE,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA"}

package/dist/layout-sync.d.ts

@@ -0,0 +1,51 @@
+/**
+ * One `requestAnimationFrame` coalescer for hybrid Three + Geometra hosts: paired
+ * `ResizeObserver` notifications run WebGL buffer sync at most once per frame, and an optional
+ * synthetic `window` `resize` can fire on the same tick so the Geometra thin client picks up
+ * layout size without double work on real window resizes.
+ *
+ * {@link createThreeGeometraSplitHost} and {@link createThreeGeometraStackedHost} use this
+ * internally; export is for custom layouts that need the same behavior.
+ */
+export interface GeometraHostLayoutSyncRaf {
+    /**
+     * At most one drawing-buffer sync per animation frame. When `notifyGeometra` is true for any
+     * call coalesced into that frame, `dispatchGeometraResize` runs after `syncLayout`.
+     */
+    schedule(notifyGeometra: boolean): void;
+    /** Cancel a pending frame (e.g. on host destroy). */
+    cancel(): void;
+}
+export interface GeometraHostLayoutSyncRafOptions {
+    /** Return true after teardown so scheduled frames no-op. */
+    isDestroyed: () => boolean;
+    /** Resize WebGL + camera (runs inside the rAF callback). */
+    syncLayout: () => void;
+    /**
+     * e.g. `() => win.dispatchEvent(new Event('resize'))` for Geometra thin client.
+     * Runs only when {@link GeometraHostLayoutSyncRaf.schedule} requested a notify for this coalesced
+     * frame, after the layout sync callback, and only if {@link isDestroyed} is still false (avoids
+     * synthetic `resize` after teardown). If teardown happens after a successful `syncLayout` but before
+     * dispatch, the pending notify is cleared for the same reason. If the layout sync callback throws, the
+     * pending notify stays set so a later coalesced frame can still dispatch once sync succeeds. If `dispatchGeometraResize`
+     * throws, the pending notify is also left set so a later coalesced frame can retry the dispatch after
+     * `syncLayout` runs again.
+     */
+    dispatchGeometraResize: () => void;
+}
+/**
+ * Build a layout sync coalescer bound to `win` (typically the Geometra client’s `window` option).
+ * Call {@link GeometraHostLayoutSyncRaf.schedule} from `ResizeObserver` callbacks with
+ * `notifyGeometra: true` when Geometra’s canvas layout changed without a browser `resize`, and
+ * from real `window` `resize` handlers with `notifyGeometra: false`.
+ *
+ * If `syncLayout` or `dispatchGeometraResize` throws, the error propagates from the scheduled
+ * animation-frame callback (same as an uncaught rAF handler in the browser). A pending Geometra
+ * notify is cleared only after a successful `dispatchGeometraResize`; see
+ * {@link GeometraHostLayoutSyncRafOptions.dispatchGeometraResize}. If `isDestroyed` is true before
+ * `syncLayout` runs, or becomes true after `syncLayout` before `dispatchGeometraResize` (when
+ * {@link GeometraHostLayoutSyncRaf.cancel} was not used), the pending notify flag is cleared so later
+ * schedules do not inherit a stale synthetic `resize`.
+ */
+export declare function createGeometraHostLayoutSyncRaf(win: Window, options: GeometraHostLayoutSyncRafOptions): GeometraHostLayoutSyncRaf;
+//# sourceMappingURL=layout-sync.d.ts.map

package/dist/layout-sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"layout-sync.d.ts","sourceRoot":"","sources":["../src/layout-sync.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,WAAW,yBAAyB;IACxC;;;OAGG;IACH,QAAQ,CAAC,cAAc,EAAE,OAAO,GAAG,IAAI,CAAA;IACvC,qDAAqD;IACrD,MAAM,IAAI,IAAI,CAAA;CACf;AAED,MAAM,WAAW,gCAAgC;IAC/C,4DAA4D;IAC5D,WAAW,EAAE,MAAM,OAAO,CAAA;IAC1B,4DAA4D;IAC5D,UAAU,EAAE,MAAM,IAAI,CAAA;IACtB;;;;;;;;;OASG;IACH,sBAAsB,EAAE,MAAM,IAAI,CAAA;CACnC;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,+BAA+B,CAC7C,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,gCAAgC,GACxC,yBAAyB,CAoC3B"}

package/dist/layout-sync.js

@@ -0,0 +1,59 @@
+/**
+ * One `requestAnimationFrame` coalescer for hybrid Three + Geometra hosts: paired
+ * `ResizeObserver` notifications run WebGL buffer sync at most once per frame, and an optional
+ * synthetic `window` `resize` can fire on the same tick so the Geometra thin client picks up
+ * layout size without double work on real window resizes.
+ *
+ * {@link createThreeGeometraSplitHost} and {@link createThreeGeometraStackedHost} use this
+ * internally; export is for custom layouts that need the same behavior.
+ */
+/**
+ * Build a layout sync coalescer bound to `win` (typically the Geometra client’s `window` option).
+ * Call {@link GeometraHostLayoutSyncRaf.schedule} from `ResizeObserver` callbacks with
+ * `notifyGeometra: true` when Geometra’s canvas layout changed without a browser `resize`, and
+ * from real `window` `resize` handlers with `notifyGeometra: false`.
+ *
+ * If `syncLayout` or `dispatchGeometraResize` throws, the error propagates from the scheduled
+ * animation-frame callback (same as an uncaught rAF handler in the browser). A pending Geometra
+ * notify is cleared only after a successful `dispatchGeometraResize`; see
+ * {@link GeometraHostLayoutSyncRafOptions.dispatchGeometraResize}. If `isDestroyed` is true before
+ * `syncLayout` runs, or becomes true after `syncLayout` before `dispatchGeometraResize` (when
+ * {@link GeometraHostLayoutSyncRaf.cancel} was not used), the pending notify flag is cleared so later
+ * schedules do not inherit a stale synthetic `resize`.
+ */
+export function createGeometraHostLayoutSyncRaf(win, options) {
+    const { isDestroyed, syncLayout, dispatchGeometraResize } = options;
+    let layoutSyncRafId;
+    let pendingGeometraResizeNotify = false;
+    const schedule = (notifyGeometra) => {
+        if (notifyGeometra)
+            pendingGeometraResizeNotify = true;
+        if (layoutSyncRafId !== undefined)
+            return;
+        layoutSyncRafId = win.requestAnimationFrame(() => {
+            layoutSyncRafId = undefined;
+            if (isDestroyed()) {
+                pendingGeometraResizeNotify = false;
+                return;
+            }
+            syncLayout();
+            if (isDestroyed()) {
+                pendingGeometraResizeNotify = false;
+                return;
+            }
+            if (pendingGeometraResizeNotify) {
+                dispatchGeometraResize();
+                pendingGeometraResizeNotify = false;
+            }
+        });
+    };
+    const cancel = () => {
+        if (layoutSyncRafId !== undefined) {
+            win.cancelAnimationFrame(layoutSyncRafId);
+            layoutSyncRafId = undefined;
+        }
+        pendingGeometraResizeNotify = false;
+    };
+    return { schedule, cancel };
+}
+//# sourceMappingURL=layout-sync.js.map

package/dist/layout-sync.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"layout-sync.js","sourceRoot":"","sources":["../src/layout-sync.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AA8BH;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,+BAA+B,CAC7C,GAAW,EACX,OAAyC;IAEzC,MAAM,EAAE,WAAW,EAAE,UAAU,EAAE,sBAAsB,EAAE,GAAG,OAAO,CAAA;IAEnE,IAAI,eAAmC,CAAA;IACvC,IAAI,2BAA2B,GAAG,KAAK,CAAA;IAEvC,MAAM,QAAQ,GAAG,CAAC,cAAuB,EAAE,EAAE;QAC3C,IAAI,cAAc;YAAE,2BAA2B,GAAG,IAAI,CAAA;QACtD,IAAI,eAAe,KAAK,SAAS;YAAE,OAAM;QACzC,eAAe,GAAG,GAAG,CAAC,qBAAqB,CAAC,GAAG,EAAE;YAC/C,eAAe,GAAG,SAAS,CAAA;YAC3B,IAAI,WAAW,EAAE,EAAE,CAAC;gBAClB,2BAA2B,GAAG,KAAK,CAAA;gBACnC,OAAM;YACR,CAAC;YACD,UAAU,EAAE,CAAA;YACZ,IAAI,WAAW,EAAE,EAAE,CAAC;gBAClB,2BAA2B,GAAG,KAAK,CAAA;gBACnC,OAAM;YACR,CAAC;YACD,IAAI,2BAA2B,EAAE,CAAC;gBAChC,sBAAsB,EAAE,CAAA;gBACxB,2BAA2B,GAAG,KAAK,CAAA;YACrC,CAAC;QACH,CAAC,CAAC,CAAA;IACJ,CAAC,CAAA;IAED,MAAM,MAAM,GAAG,GAAG,EAAE;QAClB,IAAI,eAAe,KAAK,SAAS,EAAE,CAAC;YAClC,GAAG,CAAC,oBAAoB,CAAC,eAAe,CAAC,CAAA;YACzC,eAAe,GAAG,SAAS,CAAA;QAC7B,CAAC;QACD,2BAA2B,GAAG,KAAK,CAAA;IACrC,CAAC,CAAA;IAED,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAA;AAC7B,CAAC"}

package/dist/scene3d-manager.d.ts

@@ -0,0 +1,29 @@
+import * as THREE from 'three';
+import type { Scene3dElement } from '@geometra/core';
+/**
+ * Manages a Three.js scene graph from declarative {@link Scene3dObject} descriptors streamed
+ * from a Geometra server. Call {@link Scene3dManager.sync} each frame (or when the tree updates)
+ * to reconcile the live scene with the latest descriptor array.
+ */
+export declare class Scene3dManager {
+    readonly scene: THREE.Scene;
+    readonly camera: THREE.PerspectiveCamera;
+    private managed;
+    private sceneGroup;
+    private orbitControls;
+    private orbitControlsModule;
+    constructor(scene: THREE.Scene, camera: THREE.PerspectiveCamera);
+    /**
+     * Reconcile the live Three.js scene with the given element's props.
+     * Creates, updates, or removes objects as needed.
+     */
+    sync(element: Scene3dElement, canvas?: HTMLCanvasElement): void;
+    /** Update orbit controls damping each frame. */
+    tick(): void;
+    private syncOrbitControls;
+    private applyOrbitConfig;
+    private reconcileObjects;
+    private clearManaged;
+    dispose(): void;
+}
+//# sourceMappingURL=scene3d-manager.d.ts.map

package/dist/scene3d-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scene3d-manager.d.ts","sourceRoot":"","sources":["../src/scene3d-manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAC9B,OAAO,KAAK,EASV,cAAc,EAEf,MAAM,gBAAgB,CAAA;AAWvB;;;;GAIG;AACH,qBAAa,cAAc;IAOvB,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC,KAAK;IAC3B,QAAQ,CAAC,MAAM,EAAE,KAAK,CAAC,iBAAiB;IAP1C,OAAO,CAAC,OAAO,CAAsB;IACrC,OAAO,CAAC,UAAU,CAAoB;IACtC,OAAO,CAAC,aAAa,CAAoF;IACzG,OAAO,CAAC,mBAAmB,CAA6E;gBAG7F,KAAK,EAAE,KAAK,CAAC,KAAK,EAClB,MAAM,EAAE,KAAK,CAAC,iBAAiB;IAK1C;;;OAGG;IACH,IAAI,CAAC,OAAO,EAAE,cAAc,EAAE,MAAM,CAAC,EAAE,iBAAiB,GAAG,IAAI;IAkC/D,gDAAgD;IAChD,IAAI,IAAI,IAAI;IAIZ,OAAO,CAAC,iBAAiB;IAkCzB,OAAO,CAAC,gBAAgB;IAQxB,OAAO,CAAC,gBAAgB;IAwBxB,OAAO,CAAC,YAAY;IAQpB,OAAO,IAAI,IAAI;CAQhB"}

package/dist/scene3d-manager.js

@@ -0,0 +1,339 @@
+import * as THREE from 'three';
+/**
+ * Manages a Three.js scene graph from declarative {@link Scene3dObject} descriptors streamed
+ * from a Geometra server. Call {@link Scene3dManager.sync} each frame (or when the tree updates)
+ * to reconcile the live scene with the latest descriptor array.
+ */
+export class Scene3dManager {
+    scene;
+    camera;
+    managed = [];
+    sceneGroup = new THREE.Group();
+    orbitControls = null;
+    orbitControlsModule = null;
+    constructor(scene, camera) {
+        this.scene = scene;
+        this.camera = camera;
+        scene.add(this.sceneGroup);
+    }
+    /**
+     * Reconcile the live Three.js scene with the given element's props.
+     * Creates, updates, or removes objects as needed.
+     */
+    sync(element, canvas) {
+        const { objects, background, fov, near, far, cameraPosition, cameraTarget, orbitControls } = element.props;
+        // Update scene background
+        if (background !== undefined) {
+            this.scene.background = new THREE.Color(background);
+        }
+        // Update camera
+        if (fov !== undefined && fov > 0 && fov < 180) {
+            this.camera.fov = fov;
+        }
+        if (near !== undefined && near > 0) {
+            this.camera.near = near;
+        }
+        if (far !== undefined && far > this.camera.near) {
+            this.camera.far = far;
+        }
+        if (cameraPosition) {
+            this.camera.position.set(cameraPosition[0], cameraPosition[1], cameraPosition[2]);
+        }
+        this.camera.updateProjectionMatrix();
+        if (cameraTarget) {
+            this.camera.lookAt(cameraTarget[0], cameraTarget[1], cameraTarget[2]);
+        }
+        // Orbit controls
+        this.syncOrbitControls(orbitControls, canvas);
+        // Reconcile objects
+        this.reconcileObjects(objects);
+    }
+    /** Update orbit controls damping each frame. */
+    tick() {
+        this.orbitControls?.update();
+    }
+    syncOrbitControls(config, canvas) {
+        if (!config) {
+            if (this.orbitControls) {
+                this.orbitControls.dispose();
+                this.orbitControls = null;
+            }
+            return;
+        }
+        if (!canvas)
+            return;
+        if (!this.orbitControls && this.orbitControlsModule) {
+            this.orbitControls = new this.orbitControlsModule.OrbitControls(this.camera, canvas);
+            this.orbitControls.enableDamping = true;
+        }
+        if (!this.orbitControls && !this.orbitControlsModule) {
+            // Lazy-load OrbitControls
+            void import('three/examples/jsm/controls/OrbitControls.js').then((mod) => {
+                this.orbitControlsModule = mod;
+                if (!this.orbitControls) {
+                    this.orbitControls = new mod.OrbitControls(this.camera, canvas);
+                    this.orbitControls.enableDamping = true;
+                    this.applyOrbitConfig(config);
+                }
+            });
+            return;
+        }
+        this.applyOrbitConfig(config);
+    }
+    applyOrbitConfig(config) {
+        if (!this.orbitControls || typeof config === 'boolean')
+            return;
+        if (config.damping !== undefined)
+            this.orbitControls.dampingFactor = config.damping;
+        if (config.minDistance !== undefined)
+            this.orbitControls.minDistance = config.minDistance;
+        if (config.maxDistance !== undefined)
+            this.orbitControls.maxDistance = config.maxDistance;
+        if (config.maxPolarAngle !== undefined)
+            this.orbitControls.maxPolarAngle = config.maxPolarAngle;
+    }
+    reconcileObjects(objects) {
+        // Simple reconciliation: rebuild if count or types changed, update positions otherwise
+        const needsRebuild = objects.length !== this.managed.length ||
+            objects.some((obj, i) => obj.type !== this.managed[i]?.descriptor.type);
+        if (needsRebuild) {
+            this.clearManaged();
+            for (const desc of objects) {
+                const object = createThreeObject(desc);
+                this.managed.push({ descriptor: desc, object });
+                this.sceneGroup.add(object);
+            }
+        }
+        else {
+            // Update existing objects in place
+            for (let i = 0; i < objects.length; i++) {
+                const desc = objects[i];
+                const entry = this.managed[i];
+                updateThreeObject(entry.object, entry.descriptor, desc);
+                entry.descriptor = desc;
+            }
+        }
+    }
+    clearManaged() {
+        for (const entry of this.managed) {
+            this.sceneGroup.remove(entry.object);
+            disposeObject(entry.object);
+        }
+        this.managed = [];
+    }
+    dispose() {
+        this.clearManaged();
+        this.scene.remove(this.sceneGroup);
+        if (this.orbitControls) {
+            this.orbitControls.dispose();
+            this.orbitControls = null;
+        }
+    }
+}
+// ---------------------------------------------------------------------------
+// Object creation from descriptors
+// ---------------------------------------------------------------------------
+function createThreeObject(desc) {
+    switch (desc.type) {
+        case 'sphere':
+            return createSphere(desc);
+        case 'points':
+            return createPoints(desc);
+        case 'line':
+            return createLine(desc);
+        case 'ring':
+            return createRing(desc);
+        case 'ambientLight':
+            return createAmbientLight(desc);
+        case 'directionalLight':
+            return createDirectionalLight(desc);
+        case 'group':
+            return createGroup(desc);
+    }
+}
+function createSphere(desc) {
+    const geom = new THREE.SphereGeometry(desc.radius ?? 1, desc.widthSegments ?? 32, desc.heightSegments ?? 32);
+    const mat = new THREE.MeshStandardMaterial({
+        color: desc.color ?? 0xffffff,
+        emissive: desc.emissive ?? 0x000000,
+        metalness: desc.metalness ?? 0,
+        roughness: desc.roughness ?? 1,
+    });
+    const mesh = new THREE.Mesh(geom, mat);
+    if (desc.position)
+        mesh.position.set(desc.position[0], desc.position[1], desc.position[2]);
+    return mesh;
+}
+function createPoints(desc) {
+    const geom = new THREE.BufferGeometry();
+    const positions = new Float32Array(desc.positions);
+    geom.setAttribute('position', new THREE.BufferAttribute(positions, 3));
+    const mat = new THREE.PointsMaterial({
+        color: desc.color ?? 0xffffff,
+        size: desc.size ?? 1,
+        depthWrite: false,
+        opacity: desc.opacity ?? 1,
+        transparent: (desc.opacity ?? 1) < 1,
+    });
+    return new THREE.Points(geom, mat);
+}
+function createLine(desc) {
+    const pts = desc.points.map((p) => new THREE.Vector3(p[0], p[1], p[2]));
+    const geom = new THREE.BufferGeometry().setFromPoints(pts);
+    let mat;
+    if (desc.dashed) {
+        mat = new THREE.LineDashedMaterial({
+            color: desc.color ?? 0xffffff,
+            transparent: (desc.opacity ?? 1) < 1,
+            opacity: desc.opacity ?? 1,
+            dashSize: desc.dashSize ?? 0.14,
+            gapSize: desc.gapSize ?? 0.1,
+        });
+    }
+    else {
+        mat = new THREE.LineBasicMaterial({
+            color: desc.color ?? 0xffffff,
+            transparent: (desc.opacity ?? 1) < 1,
+            opacity: desc.opacity ?? 1,
+        });
+    }
+    const line = new THREE.Line(geom, mat);
+    if (desc.dashed)
+        line.computeLineDistances();
+    return line;
+}
+function createRing(desc) {
+    const geom = new THREE.RingGeometry(desc.innerRadius, desc.outerRadius, desc.segments ?? 128);
+    const mat = new THREE.MeshBasicMaterial({
+        color: desc.color ?? 0xffffff,
+        side: THREE.DoubleSide,
+        transparent: (desc.opacity ?? 1) < 1,
+        opacity: desc.opacity ?? 1,
+    });
+    const mesh = new THREE.Mesh(geom, mat);
+    if (desc.position)
+        mesh.position.set(desc.position[0], desc.position[1], desc.position[2]);
+    if (desc.rotation)
+        mesh.rotation.set(desc.rotation[0], desc.rotation[1], desc.rotation[2]);
+    return mesh;
+}
+function createAmbientLight(desc) {
+    return new THREE.AmbientLight(desc.color ?? 0xffffff, desc.intensity ?? 1);
+}
+function createDirectionalLight(desc) {
+    const light = new THREE.DirectionalLight(desc.color ?? 0xffffff, desc.intensity ?? 1);
+    if (desc.position)
+        light.position.set(desc.position[0], desc.position[1], desc.position[2]);
+    return light;
+}
+function createGroup(desc) {
+    const group = new THREE.Group();
+    if (desc.position)
+        group.position.set(desc.position[0], desc.position[1], desc.position[2]);
+    for (const child of desc.objects) {
+        group.add(createThreeObject(child));
+    }
+    return group;
+}
+// ---------------------------------------------------------------------------
+// In-place updates (position, color, etc.) without full rebuild
+// ---------------------------------------------------------------------------
+function updateThreeObject(object, _oldDesc, newDesc) {
+    switch (newDesc.type) {
+        case 'sphere':
+            updateSphere(object, newDesc);
+            break;
+        case 'points':
+            updatePoints(object, newDesc);
+            break;
+        case 'line':
+            updateLine(object, newDesc);
+            break;
+        case 'ring':
+            updateRing(object, newDesc);
+            break;
+        case 'ambientLight':
+            updateAmbientLight(object, newDesc);
+            break;
+        case 'directionalLight':
+            updateDirectionalLight(object, newDesc);
+            break;
+        case 'group':
+            // Groups require full reconciliation of children — handled by rebuild path
+            break;
+    }
+}
+function updateSphere(mesh, desc) {
+    if (desc.position)
+        mesh.position.set(desc.position[0], desc.position[1], desc.position[2]);
+    const mat = mesh.material;
+    if (desc.color !== undefined)
+        mat.color.setHex(desc.color);
+    if (desc.emissive !== undefined)
+        mat.emissive.setHex(desc.emissive);
+}
+function updatePoints(points, desc) {
+    const geom = points.geometry;
+    const posAttr = geom.getAttribute('position');
+    const newPositions = new Float32Array(desc.positions);
+    if (posAttr.count * 3 === newPositions.length) {
+        posAttr.set(newPositions);
+        posAttr.needsUpdate = true;
+    }
+}
+function updateLine(line, desc) {
+    const pts = desc.points.map((p) => new THREE.Vector3(p[0], p[1], p[2]));
+    line.geometry.dispose();
+    line.geometry = new THREE.BufferGeometry().setFromPoints(pts);
+    if (desc.dashed)
+        line.computeLineDistances();
+}
+function updateRing(mesh, desc) {
+    if (desc.position)
+        mesh.position.set(desc.position[0], desc.position[1], desc.position[2]);
+    if (desc.rotation)
+        mesh.rotation.set(desc.rotation[0], desc.rotation[1], desc.rotation[2]);
+}
+function updateAmbientLight(light, desc) {
+    if (desc.color !== undefined)
+        light.color.setHex(desc.color);
+    if (desc.intensity !== undefined)
+        light.intensity = desc.intensity;
+}
+function updateDirectionalLight(light, desc) {
+    if (desc.color !== undefined)
+        light.color.setHex(desc.color);
+    if (desc.intensity !== undefined)
+        light.intensity = desc.intensity;
+    if (desc.position)
+        light.position.set(desc.position[0], desc.position[1], desc.position[2]);
+}
+// ---------------------------------------------------------------------------
+// Disposal
+// ---------------------------------------------------------------------------
+function disposeObject(object) {
+    if (object instanceof THREE.Mesh) {
+        object.geometry.dispose();
+        if (Array.isArray(object.material)) {
+            for (const mat of object.material)
+                mat.dispose();
+        }
+        else {
+            object.material.dispose();
+        }
+    }
+    else if (object instanceof THREE.Points) {
+        object.geometry.dispose();
+        object.material.dispose();
+    }
+    else if (object instanceof THREE.Line) {
+        object.geometry.dispose();
+        object.material.dispose();
+    }
+    else if (object instanceof THREE.Group) {
+        for (const child of [...object.children]) {
+            disposeObject(child);
+        }
+    }
+}
+//# sourceMappingURL=scene3d-manager.js.map

package/dist/scene3d-manager.js.map

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