@geometra/renderer-three 0.2.0 → 1.3.1

package/dist/utils.js

@@ -1,26 +1,227 @@
+/** Floor to a positive integer; non-finite and values below 1 become 1 (avoids NaN in WebGL sizing). */
+function normalizeLayoutPixels(n) {
+    if (!Number.isFinite(n))
+        return 1;
+    const floored = Math.floor(n);
+    return floored >= 1 ? floored : 1;
+}
+/**
+ * Same integer flooring and minimum size as {@link createThreeGeometraSplitHost} and
+ * {@link createThreeGeometraStackedHost} use for CSS layout sizes and drawing-buffer dimensions.
+ *
+ * Use in custom or headless `WebGLRenderer` setups so width/height math stays aligned with those hosts.
+ *
+ * @returns A positive integer width or height in layout pixels (at least 1).
+ */
+export function normalizeGeometraLayoutPixels(n) {
+    return normalizeLayoutPixels(n);
+}
+function normalizedCssLayoutDimensions(cssWidth, cssHeight) {
+    return {
+        w: normalizeLayoutPixels(cssWidth),
+        h: normalizeLayoutPixels(cssHeight),
+    };
+}
+/**
+ * Perspective `aspect` value for the same CSS layout → camera path as
+ * {@link resizeGeometraThreePerspectiveView} and the built-in split/stacked hosts
+ * (`setPixelRatio` + `setSize` with layout pixels, not raw drawing-buffer dimensions).
+ *
+ * Use in headless or custom renderers when you resize the drawing buffer yourself but want
+ * projection to stay aligned with {@link createThreeGeometraSplitHost} /
+ * {@link createThreeGeometraStackedHost}. For buffer-sized projection, use
+ * {@link syncGeometraThreePerspectiveFromBuffer} instead — flooring differs when width and height
+ * are scaled to physical pixels separately.
+ */
+export function geometraHostPerspectiveAspectFromCss(cssWidth, cssHeight) {
+    const { w, h } = normalizedCssLayoutDimensions(cssWidth, cssHeight);
+    return w / h;
+}
+/**
+ * Device pixel ratio for split/stacked hosts and custom renderers: full raw ratio, optionally capped.
+ * Use with {@link resizeGeometraThreePerspectiveView} or {@link setWebGLDrawingBufferSize} so headless
+ * or offscreen setups match the same `maxDevicePixelRatio` behavior as {@link createThreeGeometraSplitHost}
+ * and {@link createThreeGeometraStackedHost}.
+ *
+ * @returns A finite positive ratio, capped when `maxDevicePixelRatio` is a finite positive number.
+ */
+export function resolveHostDevicePixelRatio(rawDevicePixelRatio, maxDevicePixelRatio) {
+    const raw = rawDevicePixelRatio > 0 && Number.isFinite(rawDevicePixelRatio) ? rawDevicePixelRatio : 1;
+    if (maxDevicePixelRatio === undefined ||
+        !Number.isFinite(maxDevicePixelRatio) ||
+        maxDevicePixelRatio <= 0) {
+        return raw;
+    }
+    return Math.min(raw, maxDevicePixelRatio);
+}
+/**
+ * Raw device pixel ratio used by headless / no-`window` helpers that mirror browser hosts where
+ * `win.devicePixelRatio || 1` would apply, but the baseline is fixed at **1** (see
+ * {@link resolveHeadlessHostDevicePixelRatio}, {@link toPlainGeometraThreeViewSizingStateHeadless},
+ * {@link createGeometraThreePerspectiveResizeHandlerHeadless}). Prefer this export over a bare `1`
+ * in agent payloads, tests, or custom hosts so the baseline stays grep-stable and documented.
+ */
+export const GEOMETRA_HEADLESS_RAW_DEVICE_PIXEL_RATIO = 1;
+/**
+ * Same optional {@link maxDevicePixelRatio} cap as {@link createThreeGeometraSplitHost} and
+ * {@link createThreeGeometraStackedHost}, but with raw ratio **1** for environments without a
+ * browser `window` (headless WebGL, Node, tests).
+ *
+ * Equivalent to
+ * `resolveHostDevicePixelRatio(GEOMETRA_HEADLESS_RAW_DEVICE_PIXEL_RATIO, maxDevicePixelRatio)`.
+ */
+export function resolveHeadlessHostDevicePixelRatio(maxDevicePixelRatio) {
+    return resolveHostDevicePixelRatio(GEOMETRA_HEADLESS_RAW_DEVICE_PIXEL_RATIO, maxDevicePixelRatio);
+}
+/**
+ * Coerce CSS layout size and DPR into the same integers the built-in hosts use for perspective resize
+ * and nominal buffer dimensions (floored layout × effective DPR per axis).
+ */
+export function toPlainGeometraThreeViewSizingState(cssWidth, cssHeight, rawDevicePixelRatio, maxDevicePixelRatio) {
+    const layoutWidth = normalizeGeometraLayoutPixels(cssWidth);
+    const layoutHeight = normalizeGeometraLayoutPixels(cssHeight);
+    const sanitizedRawDevicePixelRatio = rawDevicePixelRatio > 0 && Number.isFinite(rawDevicePixelRatio) ? rawDevicePixelRatio : 1;
+    const effectiveDevicePixelRatio = resolveHostDevicePixelRatio(sanitizedRawDevicePixelRatio, maxDevicePixelRatio);
+    return {
+        layoutWidth,
+        layoutHeight,
+        perspectiveAspect: layoutWidth / layoutHeight,
+        sanitizedRawDevicePixelRatio,
+        effectiveDevicePixelRatio,
+        drawingBufferWidth: normalizeGeometraLayoutPixels(layoutWidth * effectiveDevicePixelRatio),
+        drawingBufferHeight: normalizeGeometraLayoutPixels(layoutHeight * effectiveDevicePixelRatio),
+    };
+}
+/**
+ * Same plain viewport sizing as {@link toPlainGeometraThreeViewSizingState} with raw device pixel ratio
+ * fixed at **1** — parity with {@link resolveHeadlessHostDevicePixelRatio},
+ * {@link toPlainGeometraThreeHostSnapshotHeadless}, and {@link resizeGeometraThreeWebGLWithSceneBasicsViewHeadless}
+ * for headless GL, Node, tests, or agent payloads without a browser `window`.
+ *
+ * Equivalent to
+ * `toPlainGeometraThreeViewSizingState(cssWidth, cssHeight, GEOMETRA_HEADLESS_RAW_DEVICE_PIXEL_RATIO, maxDevicePixelRatio)`.
+ */
+export function toPlainGeometraThreeViewSizingStateHeadless(cssWidth, cssHeight, maxDevicePixelRatio) {
+    return toPlainGeometraThreeViewSizingState(cssWidth, cssHeight, GEOMETRA_HEADLESS_RAW_DEVICE_PIXEL_RATIO, maxDevicePixelRatio);
+}
+function isFinitePositiveNumber(value) {
+    return typeof value === 'number' && Number.isFinite(value) && value > 0;
+}
+/**
+ * Narrow `unknown` (e.g. `JSON.parse`) to {@link PlainGeometraThreeViewSizingState} when the object has the
+ * viewport fields produced by {@link toPlainGeometraThreeViewSizingState} and
+ * {@link toPlainGeometraThreeViewSizingStateHeadless}. Extra keys are allowed. Objects that also include scene
+ * fields may satisfy this guard; for the full viewport + scene shape use `isPlainGeometraThreeHostSnapshot`
+ * from this package’s entry (re-exported next to the host snapshot helpers).
+ */
+export function isPlainGeometraThreeViewSizingState(value) {
+    if (value === null || typeof value !== 'object')
+        return false;
+    const o = value;
+    return (isFinitePositiveNumber(o.layoutWidth) &&
+        isFinitePositiveNumber(o.layoutHeight) &&
+        isFinitePositiveNumber(o.perspectiveAspect) &&
+        isFinitePositiveNumber(o.sanitizedRawDevicePixelRatio) &&
+        isFinitePositiveNumber(o.effectiveDevicePixelRatio) &&
+        isFinitePositiveNumber(o.drawingBufferWidth) &&
+        isFinitePositiveNumber(o.drawingBufferHeight));
+}
 /**
  * Resize drawing buffer to match CSS pixel size × device pixel ratio.
  * Use when you manage your own canvas layout (no `renderer.setSize`).
+ * Non-finite CSS sizes or products fall back to 1; non-finite or non-positive `pixelRatio` becomes 1.
  */
 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));
+    const rawPr = pixelRatio ?? (typeof window !== 'undefined' ? window.devicePixelRatio || 1 : 1);
+    const pr = rawPr > 0 && Number.isFinite(rawPr) ? rawPr : 1;
+    const w = normalizeLayoutPixels(cssWidth * pr);
+    const h = normalizeLayoutPixels(cssHeight * pr);
     renderer.setDrawingBufferSize(w, h, pr);
 }
+/**
+ * Size the WebGL drawing buffer from CSS layout × pixel ratio and update the perspective camera aspect
+ * to match, in one step.
+ *
+ * Use this on the **drawing-buffer** path (with {@link setWebGLDrawingBufferSize}) instead of
+ * {@link resizeGeometraThreePerspectiveView} when you do not use `setPixelRatio` + `setSize` on the
+ * renderer — for example headless GL, offscreen canvas, or custom buffer management. Equivalent to calling
+ * {@link setWebGLDrawingBufferSize} then {@link syncGeometraThreePerspectiveFromBuffer} with the
+ * resulting buffer dimensions (read from {@link WebGLRenderer.domElement} after resize).
+ */
+export function resizeGeometraThreeDrawingBufferView(renderer, camera, cssWidth, cssHeight, pixelRatio) {
+    setWebGLDrawingBufferSize(renderer, cssWidth, cssHeight, pixelRatio);
+    syncGeometraThreePerspectiveFromBuffer(camera, renderer.domElement.width, renderer.domElement.height);
+}
+/**
+ * Same as {@link resizeGeometraThreeDrawingBufferView} with pixel ratio from
+ * {@link resolveHeadlessHostDevicePixelRatio} — raw ratio **1** and the same optional
+ * `maxDevicePixelRatio` cap as split/stacked hosts.
+ *
+ * Parity with {@link resizeGeometraThreeWebGLWithSceneBasicsViewHeadless} for the
+ * {@link setWebGLDrawingBufferSize} / drawing-buffer path (headless GL, offscreen canvas, Node tests).
+ *
+ * Equivalent to calling {@link resizeGeometraThreeDrawingBufferView} with
+ * `resolveHeadlessHostDevicePixelRatio(maxDevicePixelRatio)` as the pixel ratio argument.
+ */
+export function resizeGeometraThreeDrawingBufferViewHeadless(renderer, camera, cssWidth, cssHeight, maxDevicePixelRatio) {
+    resizeGeometraThreeDrawingBufferView(renderer, camera, cssWidth, cssHeight, resolveHeadlessHostDevicePixelRatio(maxDevicePixelRatio));
+}
 /**
  * Apply the same CSS-size → aspect ratio → WebGL buffer sizing path as
  * {@link createThreeGeometraSplitHost} and {@link createThreeGeometraStackedHost}.
  *
  * Use with {@link createGeometraThreeSceneBasics} when you own the `WebGLRenderer` (headless GL,
  * offscreen canvas, tests) but want buffer dimensions and projection to stay aligned with those hosts.
+ * Non-finite or non-positive CSS sizes (including negative values) normalize to at least 1 layout
+ * pixel each, matching {@link normalizeGeometraLayoutPixels}; non-finite or non-positive `pixelRatio`
+ * becomes 1.
  */
 export function resizeGeometraThreePerspectiveView(renderer, camera, cssWidth, cssHeight, pixelRatio) {
-    renderer.setPixelRatio(pixelRatio);
-    const w = Math.max(1, Math.floor(cssWidth));
-    const h = Math.max(1, Math.floor(cssHeight));
+    const pr = pixelRatio > 0 && Number.isFinite(pixelRatio) ? pixelRatio : 1;
+    renderer.setPixelRatio(pr);
+    const { w, h } = normalizedCssLayoutDimensions(cssWidth, cssHeight);
     camera.aspect = w / h;
     camera.updateProjectionMatrix();
     renderer.setSize(w, h, false);
 }
+/**
+ * Build a resize callback that applies the same CSS layout → DPR → `setPixelRatio` / `setSize` path as
+ * {@link createThreeGeometraSplitHost} and {@link createThreeGeometraStackedHost}.
+ *
+ * Use in headless GL, offscreen canvas, tests, or custom hosts where you resize on a timer or explicit
+ * layout pass instead of the built-in `ResizeObserver`, but want {@link resolveHostDevicePixelRatio}
+ * capping and layout-pixel normalization without duplicating that wiring at every call site.
+ *
+ * @param getRawDevicePixelRatio - e.g. `() => win.devicePixelRatio || 1` or `() => 1` when no `window`.
+ */
+export function createGeometraThreePerspectiveResizeHandler(renderer, camera, getRawDevicePixelRatio, maxDevicePixelRatio) {
+    return (cssWidth, cssHeight) => {
+        resizeGeometraThreePerspectiveView(renderer, camera, cssWidth, cssHeight, resolveHostDevicePixelRatio(getRawDevicePixelRatio(), maxDevicePixelRatio));
+    };
+}
+/**
+ * Same as {@link createGeometraThreePerspectiveResizeHandler} with raw device pixel ratio fixed at **1** —
+ * parity with {@link resolveHeadlessHostDevicePixelRatio}, {@link resizeGeometraThreeWebGLWithSceneBasicsViewHeadless},
+ * {@link toPlainGeometraThreeViewSizingStateHeadless}, and {@link toPlainGeometraThreeHostSnapshotHeadless} for headless GL, Node, tests, or agent loops without a browser
+ * `window`.
+ *
+ * Equivalent to `createGeometraThreePerspectiveResizeHandler(renderer, camera, () => 1, maxDevicePixelRatio)`.
+ */
+export function createGeometraThreePerspectiveResizeHandlerHeadless(renderer, camera, maxDevicePixelRatio) {
+    return createGeometraThreePerspectiveResizeHandler(renderer, camera, () => GEOMETRA_HEADLESS_RAW_DEVICE_PIXEL_RATIO, maxDevicePixelRatio);
+}
+/**
+ * Update perspective projection from **drawing-buffer** pixel dimensions (physical pixels), not CSS size.
+ *
+ * Use when you size WebGL with {@link setWebGLDrawingBufferSize} or `renderer.setDrawingBufferSize` directly
+ * (headless GL, offscreen canvas, tests) and still want the same aspect handling as
+ * {@link resizeGeometraThreePerspectiveView}. Does not touch the renderer — only the camera.
+ * Non-finite buffer dimensions fall back to 1.
+ */
+export function syncGeometraThreePerspectiveFromBuffer(camera, drawingBufferWidth, drawingBufferHeight) {
+    const w = normalizeLayoutPixels(drawingBufferWidth);
+    const h = normalizeLayoutPixels(drawingBufferHeight);
+    camera.aspect = w / h;
+    camera.updateProjectionMatrix();
+}
 //# sourceMappingURL=utils.js.map

package/dist/utils.js.map

@@ -1 +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;AAED;;;;;;GAMG;AACH,MAAM,UAAU,kCAAkC,CAChD,QAAuB,EACvB,MAAyB,EACzB,QAAgB,EAChB,SAAiB,EACjB,UAAkB;IAElB,QAAQ,CAAC,aAAa,CAAC,UAAU,CAAC,CAAA;IAClC,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAA;IAC3C,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAA;IAC5C,MAAM,CAAC,MAAM,GAAG,CAAC,GAAG,CAAC,CAAA;IACrB,MAAM,CAAC,sBAAsB,EAAE,CAAA;IAC/B,QAAQ,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC,EAAE,KAAK,CAAC,CAAA;AAC/B,CAAC"}
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,13 +1,15 @@
 {
   "name": "@geometra/renderer-three",
-  "version": "0.2.0",
-  "description": "Three.js render target helpers for Geometra — stack WebGL with the geometry-streamed canvas client",
+  "version": "1.3.1",
+  "description": "Three.js render target helpers for Geometra — stack WebGL with the geometry-streamed canvas client, declarative scene3d element rendering",
   "license": "MIT",
   "type": "module",
   "repository": {
     "type": "git",
-    "url": "https://github.com/razroo/geometra-renderer-three"
+    "url": "https://github.com/razroo/geometra",
+    "directory": "packages/renderer-three"
   },
+  "homepage": "https://razroo.github.io/geometra",
   "keywords": [
     "geometra",
     "three",
@@ -15,7 +17,8 @@
     "webgl",
     "renderer",
     "dom-free",
-    "websocket"
+    "websocket",
+    "scene3d"
   ],
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -26,28 +29,22 @@
     }
   },
   "files": [
-    "dist",
-    "README.md",
-    "LICENSE"
+    "dist"
   ],
   "scripts": {
     "build": "rm -rf dist && tsc -p tsconfig.build.json",
-    "check": "tsc --noEmit -p tsconfig.json",
-    "verify:exports": "node scripts/verify-exports.mjs",
-    "verify:utils": "node scripts/verify-utils.mjs",
-    "release:gate": "npm run check && npm run build && npm run verify:exports && npm run verify:utils",
-    "prepare": "npm run build",
-    "prepublishOnly": "npm run build"
+    "check": "tsc --noEmit"
+  },
+  "dependencies": {
+    "@geometra/client": "^1.3.1",
+    "@geometra/core": "^1.3.1",
+    "@geometra/renderer-canvas": "^1.3.1"
   },
   "peerDependencies": {
-    "@geometra/renderer-canvas": "^1.2.2",
     "three": ">=0.160.0 <0.180.0"
   },
   "devDependencies": {
-    "@geometra/client": "^1.2.2",
-    "@geometra/renderer-canvas": "^1.2.2",
     "@types/three": "^0.170.0",
-    "three": "^0.170.0",
-    "typescript": "^6.0.2"
+    "three": "^0.170.0"
   }
 }

package/LICENSE

@@ -1,21 +0,0 @@
-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

@@ -1,111 +0,0 @@
-# @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) and a **stacked HUD** host (full-viewport WebGL + corner Geometra overlay) as bootstrap helpers, plus small WebGL sizing utilities.
-
-For the long-term goal — Three.js and Geometra in one **native**, protocol-first, DOM-free space — see [docs/GEOMETRA_NATIVE_SPACE.md](docs/GEOMETRA_NATIVE_SPACE.md). To drive the Cursor Agent CLI in a loop (like the main Geometra repo), use [`scripts/cursor-agent-loop.sh`](scripts/cursor-agent-loop.sh) after installing the [`agent` CLI](https://cursor.com/install); each iteration should pass `npm run release:gate`.
-
-## 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()
-```
-
-### Stacked HUD (WebGL + overlay)
-
-```ts
-import * as THREE from 'three'
-import { createThreeGeometraStackedHost } from '@geometra/renderer-three'
-
-const stacked = createThreeGeometraStackedHost({
-  container: document.getElementById('app')!,
-  geometraHudWidth: 400,
-  geometraHudHeight: 280,
-  geometraHudPlacement: 'bottom-right',
-  geometraHudMargin: 16,
-  url: 'ws://localhost:8080/geometra-ws',
-  binaryFraming: true,
-  onThreeReady: ({ scene, camera }) => {
-    scene.add(new THREE.AmbientLight(0xffffff, 0.55))
-    camera.position.set(0, 1.5, 6)
-  },
-})
-stacked.destroy()
-```
-
-Use `geometraHudPointerEvents` (CSS `pointer-events`, default `'auto'`) when you want the HUD to ignore input — for example `'none'` so pointer events reach the full-viewport Three.js canvas underneath.
-
-`createThreeGeometraSplitHost` and `createThreeGeometraStackedHost` each forward all [`createBrowserCanvasClient`](https://github.com/razroo/geometra/tree/main/packages/renderer-canvas) options except `canvas` (the host 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.
-
-### Shared scene / camera defaults (headless-friendly)
-
-`createGeometraThreeSceneBasics` builds a `Scene`, `PerspectiveCamera`, and `Clock` with the same defaults as the split and stacked hosts. Pair it with your own `WebGLRenderer` (or a headless GL context) and `resizeGeometraThreePerspectiveView` so buffer size and camera aspect match those hosts, or use `setWebGLDrawingBufferSize` alone when you already manage aspect and `setPixelRatio` yourself.
-
-## Roadmap (not in v0)
-
-- Optional **scene-graph extension** to the GEOM protocol (headless + WebGL from the same JSON).
-- **Stacked** overlay: v0 ships a corner HUD layout; richer stacking (custom regions, explicit `pointer-events` policies) may follow.
-- **Node / headless Three** helpers for parity with “AI talks the same protocol” stories (`createGeometraThreeSceneBasics` is a small shared baseline; richer helpers may follow).
-
-## 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