@geometra/renderer-three 0.2.0 → 1.4.0

package/dist/scene3d-manager.js

@@ -0,0 +1,394 @@
+import * as THREE from 'three';
+/** True when `a` and `b` have the same discriminated `type` and matching nested `group` arity/shape. */
+function sameObjectStructure(a, b) {
+    if (a.type !== b.type)
+        return false;
+    if (a.type !== 'group')
+        return true;
+    const ga = a;
+    const gb = b;
+    if (ga.objects.length !== gb.objects.length)
+        return false;
+    for (let i = 0; i < ga.objects.length; i++) {
+        if (!sameObjectStructure(ga.objects[i], gb.objects[i]))
+            return false;
+    }
+    return true;
+}
+/**
+ * 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;
+    cameraInitialized = false;
+    lastCameraTarget;
+    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.
+     * Camera position/target are applied on the first call; subsequent calls update
+     * orbit controls target but leave camera position to user interaction.
+     */
+    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 projection (always safe to update)
+        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;
+        }
+        this.camera.updateProjectionMatrix();
+        // Set camera position only on first sync (subsequent frames: orbit controls owns it)
+        if (!this.cameraInitialized) {
+            if (cameraPosition) {
+                this.camera.position.set(cameraPosition[0], cameraPosition[1], cameraPosition[2]);
+            }
+            if (cameraTarget) {
+                this.camera.lookAt(cameraTarget[0], cameraTarget[1], cameraTarget[2]);
+            }
+            this.cameraInitialized = true;
+        }
+        // Track the latest target for orbit controls
+        if (cameraTarget) {
+            this.lastCameraTarget = cameraTarget;
+        }
+        // Orbit controls
+        this.syncOrbitControls(orbitControls, canvas);
+        // Update orbit controls target to track the scene center
+        if (this.orbitControls && this.lastCameraTarget) {
+            this.orbitControls.target.set(this.lastCameraTarget[0], this.lastCameraTarget[1], this.lastCameraTarget[2]);
+        }
+        // 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;
+            this.orbitControls.enableZoom = false;
+        }
+        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.orbitControls.enableZoom = false;
+                    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':
+            updateGroup(object, _oldDesc, newDesc);
+            break;
+    }
+}
+function updateGroup(group, oldDesc, newDesc) {
+    if (newDesc.position) {
+        group.position.set(newDesc.position[0], newDesc.position[1], newDesc.position[2]);
+    }
+    if (!sameObjectStructure(oldDesc, newDesc) || group.children.length !== newDesc.objects.length) {
+        for (const child of [...group.children]) {
+            group.remove(child);
+            disposeObject(child);
+        }
+        for (const childDesc of newDesc.objects) {
+            group.add(createThreeObject(childDesc));
+        }
+        return;
+    }
+    for (let i = 0; i < newDesc.objects.length; i++) {
+        const ch = group.children[i];
+        if (ch) {
+            updateThreeObject(ch, oldDesc.objects[i], newDesc.objects[i]);
+        }
+    }
+}
+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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"}

package/dist/split-host.d.ts

@@ -1,24 +1,62 @@
 import * as THREE from 'three';
 import { type BrowserCanvasClientHandle, type BrowserCanvasClientOptions } from '@geometra/renderer-canvas';
 import { type GeometraThreeSceneBasicsOptions } from './three-scene-basics.js';
-export interface ThreeGeometraSplitHostOptions extends Omit<BrowserCanvasClientOptions, 'canvas'>, GeometraThreeSceneBasicsOptions {
+/**
+ * Every {@link createBrowserCanvasClient} option except `canvas`, which split/stacked hosts create
+ * internally. Includes `url`, `binaryFraming`, optional explicit `window` for tests/iframes, and
+ * the rest of {@link BrowserCanvasClientOptions}.
+ */
+export type GeometraHostBrowserCanvasClientOptions = Omit<BrowserCanvasClientOptions, 'canvas'>;
+/**
+ * Default Geometra column width for {@link createThreeGeometraSplitHost}; same value as the
+ * `geometraWidth` option fallback and README.
+ */
+export declare const GEOMETRA_SPLIT_HOST_LAYOUT_DEFAULTS: {
+    readonly geometraWidth: 420;
+};
+export interface ThreeGeometraSplitHostOptions extends GeometraHostBrowserCanvasClientOptions, GeometraThreeSceneBasicsOptions {
     /** Host element; a flex row is appended as a child (existing children are left untouched). */
     container: HTMLElement;
-    /** Geometra column width in CSS pixels. Default: 420. */
+    /**
+     * Geometra column width in CSS pixels. Default: 420 ({@link GEOMETRA_SPLIT_HOST_LAYOUT_DEFAULTS}).
+     * Non-finite or negative values fall back to the default so layout does not emit invalid `px` styles.
+     */
     geometraWidth?: number;
     /** When true, Geometra panel is on the left. Default: false (Three.js left, Geometra right). */
     geometraOnLeft?: boolean;
+    /**
+     * Upper bound for `window.devicePixelRatio` when sizing the WebGL drawing buffer (e.g. `2` on retina
+     * to cut memory and fragment cost). When omitted, the full device pixel ratio is used.
+     */
+    maxDevicePixelRatio?: number;
     /**
      * Called once after scene, camera, and renderer are created.
      * Add meshes, lights, controls, etc. Call `ctx.destroy()` to tear down immediately; the render loop
-     * will not start if the host is already destroyed.
+     * will not start if the host is already destroyed. If this callback throws, the host is fully torn
+     * down and the error is rethrown.
      */
     onThreeReady?: (ctx: ThreeRuntimeContext) => void;
     /**
      * Called every frame before `renderer.render`.
-     * Use for animations; return nothing.
+     * Use for animations. Return **`false`** to skip `render` for this frame only (same idea as
+     * {@link tickGeometraThreeWebGLWithSceneBasicsFrame}). If you call {@link ThreeRuntimeContext.destroy} here,
+     * teardown runs and this frame’s `render` is skipped (avoids rendering after WebGL dispose).
+     * If this callback throws, the host is fully torn down and the error is rethrown (same as {@link onThreeReady}).
+     */
+    onThreeFrame?: (ctx: ThreeFrameContext) => void | false;
+    /**
+     * WebSocket URL for a transparent Geometra overlay canvas on the Three.js panel.
+     * When set, a second canvas is absolutely positioned over the Three.js panel and connected
+     * to this URL. Use for HUD elements (pills, labels, info panels) rendered by a separate
+     * Geometra server view.
      */
-    onThreeFrame?: (ctx: ThreeFrameContext) => void;
+    overlayUrl?: string;
+    /** Renderer options for the overlay canvas. Default: transparent background. */
+    overlayRendererOptions?: Record<string, unknown>;
+    /** CSS pointer-events for the overlay. Default: ‘none’ (click-through). */
+    overlayPointerEvents?: string;
+    /** Binary framing for the overlay WebSocket. Default: same as main client. */
+    overlayBinaryFraming?: boolean;
 }
 export interface ThreeRuntimeContext {
     renderer: THREE.WebGLRenderer;
@@ -39,12 +77,21 @@ export interface ThreeGeometraSplitHostHandle {
     geometraPanel: HTMLDivElement;
     threeCanvas: HTMLCanvasElement;
     geometraCanvas: HTMLCanvasElement;
+    /** Overlay canvas on the Three.js panel (present when `overlayUrl` was provided). */
+    overlayCanvas?: HTMLCanvasElement;
     renderer: THREE.WebGLRenderer;
     scene: THREE.Scene;
     camera: THREE.PerspectiveCamera;
     clock: THREE.Clock;
     geometra: BrowserCanvasClientHandle;
-    /** Stops the render loop, disconnects observers, disposes WebGL, and tears down the Geometra client. */
+    /** Overlay Geometra client (present when `overlayUrl` was provided). */
+    overlay?: BrowserCanvasClientHandle;
+    /**
+     * Stops the render loop, tears down WebGL via {@link disposeGeometraThreeWebGLWithSceneBasics} (clock stop +
+     * the same renderer registration headless {@link renderGeometraThreeWebGLWithSceneBasicsFrame} /
+     * {@link tickGeometraThreeWebGLWithSceneBasicsFrame} use to skip draws after dispose), disconnects observers,
+     * and tears down the Geometra client and overlay.
+     */
     destroy(): void;
 }
 /**
@@ -52,11 +99,20 @@ export interface ThreeGeometraSplitHostHandle {
  *
  * This is the recommended **hybrid** layout: 3D stays in Three; chrome and data panes stay in Geometra’s protocol.
  * Geometra’s client still uses `resizeTarget: window` by default; when only the Geometra column changes size,
- * a `ResizeObserver` dispatches a synthetic `resize` on `window` so layout width/height track the panel
- * (coalesced to at most once per animation frame when both panes notify in the same frame).
+ * a `ResizeObserver` schedules a synthetic `resize` on `window` so layout width/height track the panel.
+ * The host `root` and both flex panes are observed (same idea as {@link createThreeGeometraStackedHost} observing
+ * its `root`) so container-driven root box changes still coalesce into the same rAF pass even if a panel callback
+ * ordering quirk would otherwise miss a tick.
+ * Panel-driven updates coalesce to at most **one** animation frame per burst: a single `requestAnimationFrame`
+ * pass runs the Three.js buffer resize and (when needed) that synthetic `resize`, so both flex panes firing
+ * in the same frame do not call `renderer.setSize` twice.
+ *
+ * Real `window` `resize` events schedule the same coalesced Three.js pass **without** an extra synthetic
+ * `resize`, so the thin client is not double-notified when the browser already fired `resize`.
  *
  * The Three.js pane listens to `window` `resize` as well so `devicePixelRatio` updates (zoom / display changes)
- * refresh the WebGL drawing buffer without relying on panel `ResizeObserver` alone.
+ * refresh the WebGL drawing buffer without relying on panel `ResizeObserver` alone. Optional
+ * {@link ThreeGeometraSplitHostOptions.maxDevicePixelRatio} caps the ratio used for the WebGL buffer.
  *
  * Pass through {@link BrowserCanvasClientOptions} from `@geometra/renderer-canvas` / `@geometra/client`
  * (for example `binaryFraming`, `onError`, `onFrameMetrics`, `onData` for JSON side-channels on the same

package/dist/split-host.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"split-host.d.ts","sourceRoot":"","sources":["../src/split-host.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAC9B,OAAO,EAEL,KAAK,yBAAyB,EAC9B,KAAK,0BAA0B,EAChC,MAAM,2BAA2B,CAAA;AAClC,OAAO,EAAkC,KAAK,+BAA+B,EAAE,MAAM,yBAAyB,CAAA;AAG9G,MAAM,WAAW,6BACf,SAAQ,IAAI,CAAC,0BAA0B,EAAE,QAAQ,CAAC,EAChD,+BAA+B;IACjC,8FAA8F;IAC9F,SAAS,EAAE,WAAW,CAAA;IACtB,yDAAyD;IACzD,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,gGAAgG;IAChG,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB;;;;OAIG;IACH,YAAY,CAAC,EAAE,CAAC,GAAG,EAAE,mBAAmB,KAAK,IAAI,CAAA;IACjD;;;OAGG;IACH,YAAY,CAAC,EAAE,CAAC,GAAG,EAAE,iBAAiB,KAAK,IAAI,CAAA;CAChD;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,KAAK,CAAC,aAAa,CAAA;IAC7B,KAAK,EAAE,KAAK,CAAC,KAAK,CAAA;IAClB,MAAM,EAAE,KAAK,CAAC,iBAAiB,CAAA;IAC/B,WAAW,EAAE,iBAAiB,CAAA;IAC9B,iFAAiF;IACjF,OAAO,IAAI,IAAI,CAAA;CAChB;AAED,MAAM,WAAW,iBAAkB,SAAQ,mBAAmB;IAC5D,KAAK,EAAE,KAAK,CAAC,KAAK,CAAA;IAClB,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,4BAA4B;IAC3C,IAAI,EAAE,cAAc,CAAA;IACpB,UAAU,EAAE,cAAc,CAAA;IAC1B,aAAa,EAAE,cAAc,CAAA;IAC7B,WAAW,EAAE,iBAAiB,CAAA;IAC9B,cAAc,EAAE,iBAAiB,CAAA;IACjC,QAAQ,EAAE,KAAK,CAAC,aAAa,CAAA;IAC7B,KAAK,EAAE,KAAK,CAAC,KAAK,CAAA;IAClB,MAAM,EAAE,KAAK,CAAC,iBAAiB,CAAA;IAC/B,KAAK,EAAE,KAAK,CAAC,KAAK,CAAA;IAClB,QAAQ,EAAE,yBAAyB,CAAA;IACnC,wGAAwG;IACxG,OAAO,IAAI,IAAI,CAAA;CAChB;AAgBD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,6BAA6B,GACrC,4BAA4B,CAkK9B"}
+{"version":3,"file":"split-host.d.ts","sourceRoot":"","sources":["../src/split-host.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAC9B,OAAO,EAEL,KAAK,yBAAyB,EAC9B,KAAK,0BAA0B,EAChC,MAAM,2BAA2B,CAAA;AAClC,OAAO,EAIL,KAAK,+BAA+B,EACrC,MAAM,yBAAyB,CAAA;AAKhC;;;;GAIG;AACH,MAAM,MAAM,sCAAsC,GAAG,IAAI,CAAC,0BAA0B,EAAE,QAAQ,CAAC,CAAA;AAE/F;;;GAGG;AACH,eAAO,MAAM,mCAAmC;;CAEtC,CAAA;AAEV,MAAM,WAAW,6BACf,SAAQ,sCAAsC,EAC5C,+BAA+B;IACjC,8FAA8F;IAC9F,SAAS,EAAE,WAAW,CAAA;IACtB;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,gGAAgG;IAChG,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB;;;OAGG;IACH,mBAAmB,CAAC,EAAE,MAAM,CAAA;IAC5B;;;;;OAKG;IACH,YAAY,CAAC,EAAE,CAAC,GAAG,EAAE,mBAAmB,KAAK,IAAI,CAAA;IACjD;;;;;;OAMG;IACH,YAAY,CAAC,EAAE,CAAC,GAAG,EAAE,iBAAiB,KAAK,IAAI,GAAG,KAAK,CAAA;IACvD;;;;;OAKG;IACH,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,gFAAgF;IAChF,sBAAsB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAChD,2EAA2E;IAC3E,oBAAoB,CAAC,EAAE,MAAM,CAAA;IAC7B,8EAA8E;IAC9E,oBAAoB,CAAC,EAAE,OAAO,CAAA;CAC/B;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,KAAK,CAAC,aAAa,CAAA;IAC7B,KAAK,EAAE,KAAK,CAAC,KAAK,CAAA;IAClB,MAAM,EAAE,KAAK,CAAC,iBAAiB,CAAA;IAC/B,WAAW,EAAE,iBAAiB,CAAA;IAC9B,iFAAiF;IACjF,OAAO,IAAI,IAAI,CAAA;CAChB;AAED,MAAM,WAAW,iBAAkB,SAAQ,mBAAmB;IAC5D,KAAK,EAAE,KAAK,CAAC,KAAK,CAAA;IAClB,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,4BAA4B;IAC3C,IAAI,EAAE,cAAc,CAAA;IACpB,UAAU,EAAE,cAAc,CAAA;IAC1B,aAAa,EAAE,cAAc,CAAA;IAC7B,WAAW,EAAE,iBAAiB,CAAA;IAC9B,cAAc,EAAE,iBAAiB,CAAA;IACjC,qFAAqF;IACrF,aAAa,CAAC,EAAE,iBAAiB,CAAA;IACjC,QAAQ,EAAE,KAAK,CAAC,aAAa,CAAA;IAC7B,KAAK,EAAE,KAAK,CAAC,KAAK,CAAA;IAClB,MAAM,EAAE,KAAK,CAAC,iBAAiB,CAAA;IAC/B,KAAK,EAAE,KAAK,CAAC,KAAK,CAAA;IAClB,QAAQ,EAAE,yBAAyB,CAAA;IACnC,wEAAwE;IACxE,OAAO,CAAC,EAAE,yBAAyB,CAAA;IACnC;;;;;OAKG;IACH,OAAO,IAAI,IAAI,CAAA;CAChB;AAgBD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,6BAA6B,GACrC,4BAA4B,CAwO9B"}