@geometra/renderer-three 0.1.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Razroo
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,81 @@
+# @geometra/renderer-three
+
+**Three.js helpers alongside Geometra** — not a replacement for `@geometra/renderer-canvas`. Geometra’s WebSocket geometry protocol still drives the 2D canvas; Three.js owns WebGL for meshes, scenes, and cameras.
+
+This package ships the **split-view host** pattern (Three.js pane + Geometra pane) as one bootstrap, plus small WebGL sizing utilities.
+
+## Install
+
+Peer dependencies (your app must install them):
+
+```bash
+npm install three @geometra/renderer-canvas @geometra/client @geometra/core
+npm install @geometra/renderer-three
+```
+
+## Usage
+
+```ts
+import * as THREE from 'three'
+import { createThreeGeometraSplitHost } from '@geometra/renderer-three'
+
+const host = createThreeGeometraSplitHost({
+  container: document.getElementById('app')!,
+  geometraWidth: 420,
+  url: 'ws://localhost:8080/geometra-ws',
+  binaryFraming: true,
+  autoFocus: true,
+  threeBackground: 0x07131f,
+  onThreeReady: ({ scene, camera }) => {
+    scene.add(new THREE.AmbientLight(0xffffff, 0.6))
+    camera.position.set(0, 2, 8)
+  },
+  onThreeFrame: ({ scene, camera, delta }) => {
+    // animate meshes, controls.update(), etc.
+  },
+})
+
+// later
+host.destroy()
+```
+
+`createThreeGeometraSplitHost` forwards all [`createBrowserCanvasClient`](https://github.com/razroo/geometra/tree/main/packages/renderer-canvas) options except `canvas` (it creates the Geometra canvas for you).
+
+### Geometra resize
+
+The Geometra thin client listens to `window` resize by default. When only the Geometra column changes size, this host dispatches a synthetic `window` `resize` after layout so server layout width/height stay in sync.
+
+## Roadmap (not in v0)
+
+- Optional **scene-graph extension** to the GEOM protocol (headless + WebGL from the same JSON).
+- **Stacked** overlay (full-viewport WebGL + partial Geometra HUD) with explicit pointer routing.
+- **Node / headless Three** helpers for parity with “AI talks the same protocol” stories.
+
+## Releasing (GitHub + npm)
+
+Same pattern as [`geometra-auth`](https://github.com/razroo/geometra-auth): publishing runs when a **GitHub Release is published**, not on every tag push.
+
+1. **Repository secret:** add **`NPM_TOKEN`** (automation token with publish rights for `@geometra/renderer-three`) under **Settings → Secrets and variables → Actions**.
+
+2. **Version:** set `"version"` in `package.json` to the release you want (e.g. `0.2.0`), commit, and push to `main`.
+
+3. **Tag** must match that version with a `v` prefix:
+
+   ```bash
+   git tag v0.2.0
+   git push origin v0.2.0
+   ```
+
+4. **Create the GitHub release** (triggers [`.github/workflows/release.yml`](.github/workflows/release.yml)):
+
+   ```bash
+   gh release create v0.2.0 --repo razroo/geometra-renderer-three --title "v0.2.0" --generate-notes
+   ```
+
+   Or publish a **draft** release from the web UI, then **Publish release** when ready.
+
+The workflow checks that `v$TAG` matches `package.json`, runs `npm ci` / `npm run build`, then **`npm publish --provenance --access public`**.
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export { createThreeGeometraSplitHost, type ThreeGeometraSplitHostHandle, type ThreeGeometraSplitHostOptions, type ThreeFrameContext, type ThreeRuntimeContext, } from './split-host.js';
+export { setWebGLDrawingBufferSize } from './utils.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,4BAA4B,EAC5B,KAAK,4BAA4B,EACjC,KAAK,6BAA6B,EAClC,KAAK,iBAAiB,EACtB,KAAK,mBAAmB,GACzB,MAAM,iBAAiB,CAAA;AACxB,OAAO,EAAE,yBAAyB,EAAE,MAAM,YAAY,CAAA"}

package/dist/index.js

@@ -0,0 +1,3 @@
+export { createThreeGeometraSplitHost, } from './split-host.js';
+export { setWebGLDrawingBufferSize } from './utils.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,4BAA4B,GAK7B,MAAM,iBAAiB,CAAA;AACxB,OAAO,EAAE,yBAAyB,EAAE,MAAM,YAAY,CAAA"}

package/dist/split-host.d.ts

@@ -0,0 +1,64 @@
+import * as THREE from 'three';
+import { type BrowserCanvasClientHandle, type BrowserCanvasClientOptions } from '@geometra/renderer-canvas';
+export interface ThreeGeometraSplitHostOptions extends Omit<BrowserCanvasClientOptions, 'canvas'> {
+    /** 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. */
+    geometraWidth?: number;
+    /** When true, Geometra panel is on the left. Default: false (Three.js left, Geometra right). */
+    geometraOnLeft?: boolean;
+    /** Clear color for the Three.js scene. Default: `0x000000`. */
+    threeBackground?: THREE.ColorRepresentation;
+    /** Perspective camera FOV in degrees. Default: 50. */
+    cameraFov?: number;
+    /** Near plane. Default: 0.1. */
+    cameraNear?: number;
+    /** Far plane. Default: 2000. */
+    cameraFar?: number;
+    /** Initial camera position. Default: `(0, 0, 5)`. */
+    cameraPosition?: THREE.Vector3Tuple;
+    /**
+     * Called once after scene, camera, and renderer are created.
+     * Add meshes, lights, controls, etc.
+     */
+    onThreeReady?: (ctx: ThreeRuntimeContext) => void;
+    /**
+     * Called every frame before `renderer.render`.
+     * Use for animations; return nothing.
+     */
+    onThreeFrame?: (ctx: ThreeFrameContext) => void;
+}
+export interface ThreeRuntimeContext {
+    renderer: THREE.WebGLRenderer;
+    scene: THREE.Scene;
+    camera: THREE.PerspectiveCamera;
+    threeCanvas: HTMLCanvasElement;
+}
+export interface ThreeFrameContext extends ThreeRuntimeContext {
+    clock: THREE.Clock;
+    delta: number;
+    elapsed: number;
+}
+export interface ThreeGeometraSplitHostHandle {
+    root: HTMLDivElement;
+    threePanel: HTMLDivElement;
+    geometraPanel: HTMLDivElement;
+    threeCanvas: HTMLCanvasElement;
+    geometraCanvas: 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. */
+    destroy(): void;
+}
+/**
+ * Side-by-side host: Three.js `WebGLRenderer` on one flex pane and Geometra’s streamed canvas UI on the other.
+ *
+ * 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.
+ */
+export declare function createThreeGeometraSplitHost(options: ThreeGeometraSplitHostOptions): ThreeGeometraSplitHostHandle;
+//# sourceMappingURL=split-host.d.ts.map

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

@@ -0,0 +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;AAElC,MAAM,WAAW,6BAA8B,SAAQ,IAAI,CAAC,0BAA0B,EAAE,QAAQ,CAAC;IAC/F,8FAA8F;IAC9F,SAAS,EAAE,WAAW,CAAA;IACtB,yDAAyD;IACzD,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,gGAAgG;IAChG,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB,+DAA+D;IAC/D,eAAe,CAAC,EAAE,KAAK,CAAC,mBAAmB,CAAA;IAC3C,sDAAsD;IACtD,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,gCAAgC;IAChC,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,gCAAgC;IAChC,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,qDAAqD;IACrD,cAAc,CAAC,EAAE,KAAK,CAAC,YAAY,CAAA;IACnC;;;OAGG;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;CAC/B;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;;;;;;GAMG;AACH,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,6BAA6B,GACrC,4BAA4B,CAgJ9B"}

package/dist/split-host.js

@@ -0,0 +1,135 @@
+import * as THREE from 'three';
+import { createBrowserCanvasClient, } from '@geometra/renderer-canvas';
+function panelStyle(el, flex) {
+    el.style.flex = flex;
+    el.style.minWidth = '0';
+    el.style.minHeight = '0';
+    el.style.position = 'relative';
+    el.style.overflow = 'hidden';
+}
+function fullSizeCanvas(canvas) {
+    canvas.style.display = 'block';
+    canvas.style.width = '100%';
+    canvas.style.height = '100%';
+}
+/**
+ * Side-by-side host: Three.js `WebGLRenderer` on one flex pane and Geometra’s streamed canvas UI on the other.
+ *
+ * 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.
+ */
+export function createThreeGeometraSplitHost(options) {
+    const { container, geometraWidth = 420, geometraOnLeft = false, threeBackground = 0x000000, cameraFov = 50, cameraNear = 0.1, cameraFar = 2000, cameraPosition = [0, 0, 5], onThreeReady, onThreeFrame, window: providedWindow, ...browserOptions } = options;
+    const doc = container.ownerDocument;
+    const win = providedWindow ?? doc.defaultView;
+    if (!win) {
+        throw new Error('createThreeGeometraSplitHost requires a browser window');
+    }
+    const root = doc.createElement('div');
+    root.style.display = 'flex';
+    root.style.flexDirection = 'row';
+    root.style.width = '100%';
+    root.style.height = '100%';
+    root.style.minHeight = '0';
+    root.style.minWidth = '0';
+    container.appendChild(root);
+    const threePanel = doc.createElement('div');
+    panelStyle(threePanel, '1 1 0%');
+    const geometraPanel = doc.createElement('div');
+    panelStyle(geometraPanel, '0 0 auto');
+    geometraPanel.style.width = `${geometraWidth}px`;
+    geometraPanel.style.flexShrink = '0';
+    if (geometraOnLeft) {
+        root.append(geometraPanel, threePanel);
+    }
+    else {
+        root.append(threePanel, geometraPanel);
+    }
+    const threeCanvas = doc.createElement('canvas');
+    fullSizeCanvas(threeCanvas);
+    threePanel.appendChild(threeCanvas);
+    const geometraCanvas = doc.createElement('canvas');
+    fullSizeCanvas(geometraCanvas);
+    geometraPanel.appendChild(geometraCanvas);
+    const glRenderer = new THREE.WebGLRenderer({
+        canvas: threeCanvas,
+        antialias: true,
+        alpha: false,
+    });
+    glRenderer.setPixelRatio(win.devicePixelRatio || 1);
+    const scene = new THREE.Scene();
+    scene.background = new THREE.Color(threeBackground);
+    const camera = new THREE.PerspectiveCamera(cameraFov, 1, cameraNear, cameraFar);
+    camera.position.set(cameraPosition[0], cameraPosition[1], cameraPosition[2]);
+    const clock = new THREE.Clock();
+    const resizeThree = () => {
+        const w = Math.max(1, Math.floor(threePanel.clientWidth));
+        const h = Math.max(1, Math.floor(threePanel.clientHeight));
+        camera.aspect = w / h;
+        camera.updateProjectionMatrix();
+        glRenderer.setSize(w, h, false);
+    };
+    resizeThree();
+    const geometraHandle = createBrowserCanvasClient({
+        ...browserOptions,
+        canvas: geometraCanvas,
+        window: win,
+    });
+    const triggerGeometraResize = () => {
+        win.requestAnimationFrame(() => {
+            win.dispatchEvent(new Event('resize'));
+        });
+    };
+    const roContainer = new ResizeObserver(() => {
+        resizeThree();
+        triggerGeometraResize();
+    });
+    roContainer.observe(threePanel);
+    roContainer.observe(geometraPanel);
+    const ctxBase = {
+        renderer: glRenderer,
+        scene,
+        camera,
+        threeCanvas,
+    };
+    onThreeReady?.(ctxBase);
+    let raf = 0;
+    let destroyed = false;
+    const loop = () => {
+        if (destroyed)
+            return;
+        raf = win.requestAnimationFrame(loop);
+        const delta = clock.getDelta();
+        const elapsed = clock.elapsedTime;
+        onThreeFrame?.({ ...ctxBase, clock, delta, elapsed });
+        glRenderer.render(scene, camera);
+    };
+    raf = win.requestAnimationFrame(loop);
+    const destroy = () => {
+        if (destroyed)
+            return;
+        destroyed = true;
+        win.cancelAnimationFrame(raf);
+        roContainer.disconnect();
+        geometraHandle.destroy();
+        glRenderer.dispose();
+        if (root.parentNode === container) {
+            container.removeChild(root);
+        }
+    };
+    return {
+        root,
+        threePanel,
+        geometraPanel,
+        threeCanvas,
+        geometraCanvas,
+        renderer: glRenderer,
+        scene,
+        camera,
+        clock,
+        geometra: geometraHandle,
+        destroy,
+    };
+}
+//# sourceMappingURL=split-host.js.map

package/dist/split-host.js.map

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

package/dist/utils.d.ts

@@ -0,0 +1,7 @@
+import type { WebGLRenderer } from 'three';
+/**
+ * Resize drawing buffer to match CSS pixel size × device pixel ratio.
+ * Use when you manage your own canvas layout (no `renderer.setSize`).
+ */
+export declare function setWebGLDrawingBufferSize(renderer: WebGLRenderer, cssWidth: number, cssHeight: number, pixelRatio?: number): void;
+//# sourceMappingURL=utils.d.ts.map

package/dist/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAA;AAE1C;;;GAGG;AACH,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,aAAa,EACvB,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,UAAU,CAAC,EAAE,MAAM,GAClB,IAAI,CAKN"}

package/dist/utils.js

@@ -0,0 +1,11 @@
+/**
+ * Resize drawing buffer to match CSS pixel size × device pixel ratio.
+ * Use when you manage your own canvas layout (no `renderer.setSize`).
+ */
+export function setWebGLDrawingBufferSize(renderer, cssWidth, cssHeight, pixelRatio) {
+    const pr = pixelRatio ?? (typeof window !== 'undefined' ? window.devicePixelRatio || 1 : 1);
+    const w = Math.max(1, Math.floor(cssWidth * pr));
+    const h = Math.max(1, Math.floor(cssHeight * pr));
+    renderer.setDrawingBufferSize(w, h, pr);
+}
+//# sourceMappingURL=utils.js.map

package/dist/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,UAAU,yBAAyB,CACvC,QAAuB,EACvB,QAAgB,EAChB,SAAiB,EACjB,UAAmB;IAEnB,MAAM,EAAE,GAAG,UAAU,IAAI,CAAC,OAAO,MAAM,KAAK,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,gBAAgB,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;IAC3F,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,QAAQ,GAAG,EAAE,CAAC,CAAC,CAAA;IAChD,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,SAAS,GAAG,EAAE,CAAC,CAAC,CAAA;IACjD,QAAQ,CAAC,oBAAoB,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAA;AACzC,CAAC"}

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "@geometra/renderer-three",
+  "version": "0.1.2",
+  "description": "Three.js render target helpers for Geometra — stack WebGL with the geometry-streamed canvas client",
+  "license": "MIT",
+  "type": "module",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/razroo/geometra-renderer-three"
+  },
+  "keywords": [
+    "geometra",
+    "three",
+    "three.js",
+    "webgl",
+    "renderer",
+    "dom-free",
+    "websocket"
+  ],
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "rm -rf dist && tsc -p tsconfig.build.json",
+    "check": "tsc --noEmit -p tsconfig.json",
+    "release:gate": "npm run check && npm run build",
+    "prepare": "npm run build",
+    "prepublishOnly": "npm run build"
+  },
+  "peerDependencies": {
+    "@geometra/renderer-canvas": "^1.2.1",
+    "three": ">=0.160.0 <0.180.0"
+  },
+  "devDependencies": {
+    "@geometra/client": "^1.2.1",
+    "@geometra/renderer-canvas": "^1.2.1",
+    "@types/three": "^0.170.0",
+    "three": "^0.170.0",
+    "typescript": "^6.0.2"
+  },
+  "overrides": {
+    "@geometra/renderer-canvas": {
+      "@geometra/client": "^1.2.1"
+    }
+  }
+}