@geometra/renderer-three 0.2.0 → 1.4.0

package/dist/__tests__/scene3d-manager.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=scene3d-manager.test.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"scene3d-manager.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/scene3d-manager.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/scene3d-manager.test.js

@@ -0,0 +1,80 @@
+import * as THREE from 'three';
+import { describe, expect, it } from 'vitest';
+import { group, scene3d, sphere } from '@geometra/core';
+import { Scene3dManager } from '../scene3d-manager.js';
+function sceneContentRoot(scene) {
+    const g = scene.children[0];
+    if (!g || !(g instanceof THREE.Group)) {
+        throw new Error('expected Scene3dManager scene group as first scene child');
+    }
+    return g;
+}
+describe('Scene3dManager', () => {
+    it('updates nested sphere props when wrapped in a group (in-place)', () => {
+        const scene = new THREE.Scene();
+        const camera = new THREE.PerspectiveCamera();
+        const mgr = new Scene3dManager(scene, camera);
+        mgr.sync(scene3d({
+            width: 100,
+            height: 80,
+            objects: [group({ objects: [sphere({ color: 0xff0000 })] })],
+        }));
+        const top = sceneContentRoot(scene).children[0];
+        const mesh = top.children[0];
+        expect(mesh.material.color.getHex()).toBe(0xff0000);
+        mgr.sync(scene3d({
+            width: 100,
+            height: 80,
+            objects: [group({ objects: [sphere({ color: 0x00ff00 })] })],
+        }));
+        expect(mesh.material.color.getHex()).toBe(0x00ff00);
+        expect(top.children[0]).toBe(mesh);
+    });
+    it('rebuilds group children when nested arity changes', () => {
+        const scene = new THREE.Scene();
+        const camera = new THREE.PerspectiveCamera();
+        const mgr = new Scene3dManager(scene, camera);
+        mgr.sync(scene3d({
+            width: 100,
+            height: 80,
+            objects: [group({ objects: [sphere({ color: 0xff0000 })] })],
+        }));
+        const top = sceneContentRoot(scene).children[0];
+        expect(top.children.length).toBe(1);
+        mgr.sync(scene3d({
+            width: 100,
+            height: 80,
+            objects: [group({ objects: [sphere({ color: 0xff0000 }), sphere({ color: 0x0000ff })] })],
+        }));
+        expect(top.children.length).toBe(2);
+    });
+    it('updates a sphere inside nested groups', () => {
+        const scene = new THREE.Scene();
+        const camera = new THREE.PerspectiveCamera();
+        const mgr = new Scene3dManager(scene, camera);
+        mgr.sync(scene3d({
+            width: 100,
+            height: 80,
+            objects: [
+                group({
+                    objects: [group({ objects: [sphere({ color: 0xff0000 })] })],
+                }),
+            ],
+        }));
+        const outer = sceneContentRoot(scene).children[0];
+        const inner = outer.children[0];
+        const mesh = inner.children[0];
+        mgr.sync(scene3d({
+            width: 100,
+            height: 80,
+            objects: [
+                group({
+                    objects: [group({ objects: [sphere({ color: 0x0000ff })] })],
+                }),
+            ],
+        }));
+        expect(mesh.material.color.getHex()).toBe(0x0000ff);
+        expect(inner.children[0]).toBe(mesh);
+    });
+});
+//# sourceMappingURL=scene3d-manager.test.js.map

package/dist/__tests__/scene3d-manager.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scene3d-manager.test.js","sourceRoot":"","sources":["../../src/__tests__/scene3d-manager.test.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAC9B,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAA;AAC7C,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAA;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAA;AAEtD,SAAS,gBAAgB,CAAC,KAAkB;IAC1C,MAAM,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAA;IAC3B,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,YAAY,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;QACtC,MAAM,IAAI,KAAK,CAAC,0DAA0D,CAAC,CAAA;IAC7E,CAAC;IACD,OAAO,CAAC,CAAA;AACV,CAAC;AAED,QAAQ,CAAC,gBAAgB,EAAE,GAAG,EAAE;IAC9B,EAAE,CAAC,gEAAgE,EAAE,GAAG,EAAE;QACxE,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,KAAK,EAAE,CAAA;QAC/B,MAAM,MAAM,GAAG,IAAI,KAAK,CAAC,iBAAiB,EAAE,CAAA;QAC5C,MAAM,GAAG,GAAG,IAAI,cAAc,CAAC,KAAK,EAAE,MAAM,CAAC,CAAA;QAE7C,GAAG,CAAC,IAAI,CACN,OAAO,CAAC;YACN,KAAK,EAAE,GAAG;YACV,MAAM,EAAE,EAAE;YACV,OAAO,EAAE,CAAC,KAAK,CAAC,EAAE,OAAO,EAAE,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;SAC7D,CAAC,CACH,CAAA;QAED,MAAM,GAAG,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAgB,CAAA;QAC9D,MAAM,IAAI,GAAG,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAe,CAAA;QAC1C,MAAM,CAAE,IAAI,CAAC,QAAuC,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;QAEnF,GAAG,CAAC,IAAI,CACN,OAAO,CAAC;YACN,KAAK,EAAE,GAAG;YACV,MAAM,EAAE,EAAE;YACV,OAAO,EAAE,CAAC,KAAK,CAAC,EAAE,OAAO,EAAE,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;SAC7D,CAAC,CACH,CAAA;QAED,MAAM,CAAE,IAAI,CAAC,QAAuC,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;QACnF,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IACpC,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,mDAAmD,EAAE,GAAG,EAAE;QAC3D,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,KAAK,EAAE,CAAA;QAC/B,MAAM,MAAM,GAAG,IAAI,KAAK,CAAC,iBAAiB,EAAE,CAAA;QAC5C,MAAM,GAAG,GAAG,IAAI,cAAc,CAAC,KAAK,EAAE,MAAM,CAAC,CAAA;QAE7C,GAAG,CAAC,IAAI,CACN,OAAO,CAAC;YACN,KAAK,EAAE,GAAG;YACV,MAAM,EAAE,EAAE;YACV,OAAO,EAAE,CAAC,KAAK,CAAC,EAAE,OAAO,EAAE,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;SAC7D,CAAC,CACH,CAAA;QAED,MAAM,GAAG,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAgB,CAAA;QAC9D,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;QAEnC,GAAG,CAAC,IAAI,CACN,OAAO,CAAC;YACN,KAAK,EAAE,GAAG;YACV,MAAM,EAAE,EAAE;YACV,OAAO,EAAE,CAAC,KAAK,CAAC,EAAE,OAAO,EAAE,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,EAAE,MAAM,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;SAC1F,CAAC,CACH,CAAA;QAED,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IACrC,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,uCAAuC,EAAE,GAAG,EAAE;QAC/C,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,KAAK,EAAE,CAAA;QAC/B,MAAM,MAAM,GAAG,IAAI,KAAK,CAAC,iBAAiB,EAAE,CAAA;QAC5C,MAAM,GAAG,GAAG,IAAI,cAAc,CAAC,KAAK,EAAE,MAAM,CAAC,CAAA;QAE7C,GAAG,CAAC,IAAI,CACN,OAAO,CAAC;YACN,KAAK,EAAE,GAAG;YACV,MAAM,EAAE,EAAE;YACV,OAAO,EAAE;gBACP,KAAK,CAAC;oBACJ,OAAO,EAAE,CAAC,KAAK,CAAC,EAAE,OAAO,EAAE,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;iBAC7D,CAAC;aACH;SACF,CAAC,CACH,CAAA;QAED,MAAM,KAAK,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAgB,CAAA;QAChE,MAAM,KAAK,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAgB,CAAA;QAC9C,MAAM,IAAI,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAe,CAAA;QAE5C,GAAG,CAAC,IAAI,CACN,OAAO,CAAC;YACN,KAAK,EAAE,GAAG;YACV,MAAM,EAAE,EAAE;YACV,OAAO,EAAE;gBACP,KAAK,CAAC;oBACJ,OAAO,EAAE,CAAC,KAAK,CAAC,EAAE,OAAO,EAAE,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;iBAC7D,CAAC;aACH;SACF,CAAC,CACH,CAAA;QAED,MAAM,CAAE,IAAI,CAAC,QAAuC,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;QACnF,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IACtC,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}

package/dist/host-css-coerce.d.ts

@@ -0,0 +1,39 @@
+/** Corner anchor for the Geometra HUD overlay (same literals as {@link createThreeGeometraStackedHost}). */
+export type GeometraHudPlacement = 'bottom-right' | 'bottom-left' | 'top-right' | 'top-left';
+/**
+ * Normalize HUD corner placement from runtime strings (e.g. agent JSON or untyped config).
+ * Leading/trailing whitespace is trimmed and the four known literals are matched **case-insensitively**
+ * so payloads stay stable across generators. Unknown or empty values use `fallback` so the overlay
+ * keeps a valid `position: absolute` inset.
+ */
+export declare function coerceGeometraHudPlacement(value: string | undefined, fallback: GeometraHudPlacement): GeometraHudPlacement;
+/**
+ * CSS `pointer-events` for stacked HUD / overlay wrappers: trimmed non-empty strings pass through;
+ * otherwise `fallback` (avoids blank or invalid values from untyped config or agent JSON).
+ *
+ * {@link createThreeGeometraStackedHost} uses this for {@link ThreeGeometraStackedHostOptions.geometraHudPointerEvents}.
+ * Use next to {@link coerceHostStackingZIndexCss} when you build a custom stacked layout.
+ */
+export declare function coerceGeometraHudPointerEvents(value: string | undefined | null, fallback?: string): string;
+/**
+ * Finite, non-negative CSS px for host panel/HUD sizing; invalid values use `fallback`
+ * (avoids `NaNpx` / negative sizes in inline styles).
+ *
+ * Same helper {@link createThreeGeometraSplitHost} and {@link createThreeGeometraStackedHost} use for
+ * `geometraWidth`, HUD width/height, and margin. Use when building a custom hybrid layout next to
+ * {@link createGeometraHostLayoutSyncRaf} so numeric options stay consistent with those hosts.
+ *
+ * @param value - Requested size in CSS pixels; non-finite, negative, or non-number values are rejected.
+ * @param fallback - Default used when `value` is invalid (match the host default you document, e.g. 420).
+ * @returns Either `value` (when valid) or `fallback`.
+ */
+export declare function coerceHostNonNegativeCssPx(value: number, fallback: number): number;
+/**
+ * CSS `z-index` string for stacked HUD / overlay wrappers: finite numbers and non-blank strings pass
+ * through; otherwise `fallback` (avoids `NaN` / `Infinity` in inline styles).
+ *
+ * {@link createThreeGeometraStackedHost} uses this for {@link ThreeGeometraStackedHostOptions.geometraHudZIndex}.
+ * Use in custom stacking layouts next to {@link coerceHostNonNegativeCssPx} for consistent behavior.
+ */
+export declare function coerceHostStackingZIndexCss(value: string | number, fallback: number): string;
+//# sourceMappingURL=host-css-coerce.d.ts.map

package/dist/host-css-coerce.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"host-css-coerce.d.ts","sourceRoot":"","sources":["../src/host-css-coerce.ts"],"names":[],"mappings":"AAAA,4GAA4G;AAC5G,MAAM,MAAM,oBAAoB,GAAG,cAAc,GAAG,aAAa,GAAG,WAAW,GAAG,UAAU,CAAA;AAE5F;;;;;GAKG;AACH,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,QAAQ,EAAE,oBAAoB,GAC7B,oBAAoB,CAYtB;AAED;;;;;;GAMG;AACH,wBAAgB,8BAA8B,CAC5C,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,EAChC,QAAQ,SAAS,GAChB,MAAM,CAMR;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAElF;AAED;;;;;;GAMG;AACH,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAS5F"}

package/dist/host-css-coerce.js

@@ -0,0 +1,69 @@
+/**
+ * Normalize HUD corner placement from runtime strings (e.g. agent JSON or untyped config).
+ * Leading/trailing whitespace is trimmed and the four known literals are matched **case-insensitively**
+ * so payloads stay stable across generators. Unknown or empty values use `fallback` so the overlay
+ * keeps a valid `position: absolute` inset.
+ */
+export function coerceGeometraHudPlacement(value, fallback) {
+    if (typeof value !== 'string')
+        return fallback;
+    const key = value.trim().toLowerCase();
+    switch (key) {
+        case 'bottom-right':
+        case 'bottom-left':
+        case 'top-right':
+        case 'top-left':
+            return key;
+        default:
+            return fallback;
+    }
+}
+/**
+ * CSS `pointer-events` for stacked HUD / overlay wrappers: trimmed non-empty strings pass through;
+ * otherwise `fallback` (avoids blank or invalid values from untyped config or agent JSON).
+ *
+ * {@link createThreeGeometraStackedHost} uses this for {@link ThreeGeometraStackedHostOptions.geometraHudPointerEvents}.
+ * Use next to {@link coerceHostStackingZIndexCss} when you build a custom stacked layout.
+ */
+export function coerceGeometraHudPointerEvents(value, fallback = 'auto') {
+    if (typeof value === 'string') {
+        const t = value.trim();
+        if (t.length > 0)
+            return t;
+    }
+    return fallback;
+}
+/**
+ * Finite, non-negative CSS px for host panel/HUD sizing; invalid values use `fallback`
+ * (avoids `NaNpx` / negative sizes in inline styles).
+ *
+ * Same helper {@link createThreeGeometraSplitHost} and {@link createThreeGeometraStackedHost} use for
+ * `geometraWidth`, HUD width/height, and margin. Use when building a custom hybrid layout next to
+ * {@link createGeometraHostLayoutSyncRaf} so numeric options stay consistent with those hosts.
+ *
+ * @param value - Requested size in CSS pixels; non-finite, negative, or non-number values are rejected.
+ * @param fallback - Default used when `value` is invalid (match the host default you document, e.g. 420).
+ * @returns Either `value` (when valid) or `fallback`.
+ */
+export function coerceHostNonNegativeCssPx(value, fallback) {
+    return typeof value === 'number' && Number.isFinite(value) && value >= 0 ? value : fallback;
+}
+/**
+ * CSS `z-index` string for stacked HUD / overlay wrappers: finite numbers and non-blank strings pass
+ * through; otherwise `fallback` (avoids `NaN` / `Infinity` in inline styles).
+ *
+ * {@link createThreeGeometraStackedHost} uses this for {@link ThreeGeometraStackedHostOptions.geometraHudZIndex}.
+ * Use in custom stacking layouts next to {@link coerceHostNonNegativeCssPx} for consistent behavior.
+ */
+export function coerceHostStackingZIndexCss(value, fallback) {
+    if (typeof value === 'number' && Number.isFinite(value)) {
+        return String(value);
+    }
+    if (typeof value === 'string') {
+        const t = value.trim();
+        if (t.length > 0)
+            return t;
+    }
+    return String(fallback);
+}
+//# sourceMappingURL=host-css-coerce.js.map

package/dist/host-css-coerce.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"host-css-coerce.js","sourceRoot":"","sources":["../src/host-css-coerce.ts"],"names":[],"mappings":"AAGA;;;;;GAKG;AACH,MAAM,UAAU,0BAA0B,CACxC,KAAyB,EACzB,QAA8B;IAE9B,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,QAAQ,CAAA;IAC9C,MAAM,GAAG,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAA;IACtC,QAAQ,GAAG,EAAE,CAAC;QACZ,KAAK,cAAc,CAAC;QACpB,KAAK,aAAa,CAAC;QACnB,KAAK,WAAW,CAAC;QACjB,KAAK,UAAU;YACb,OAAO,GAAG,CAAA;QACZ;YACE,OAAO,QAAQ,CAAA;IACnB,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,8BAA8B,CAC5C,KAAgC,EAChC,QAAQ,GAAG,MAAM;IAEjB,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,MAAM,CAAC,GAAG,KAAK,CAAC,IAAI,EAAE,CAAA;QACtB,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC;YAAE,OAAO,CAAC,CAAA;IAC5B,CAAC;IACD,OAAO,QAAQ,CAAA;AACjB,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,0BAA0B,CAAC,KAAa,EAAE,QAAgB;IACxE,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAA;AAC7F,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,2BAA2B,CAAC,KAAsB,EAAE,QAAgB;IAClF,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QACxD,OAAO,MAAM,CAAC,KAAK,CAAC,CAAA;IACtB,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,MAAM,CAAC,GAAG,KAAK,CAAC,IAAI,EAAE,CAAA;QACtB,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC;YAAE,OAAO,CAAC,CAAA;IAC5B,CAAC;IACD,OAAO,MAAM,CAAC,QAAQ,CAAC,CAAA;AACzB,CAAC"}

package/dist/host-layout-plain.d.ts

@@ -0,0 +1,164 @@
+import { type GeometraHudPlacement } from './host-css-coerce.js';
+import { type GeometraThreeSceneBasicsOptions, type PlainGeometraThreeHostSnapshot } from './three-scene-basics.js';
+/** Resolved Geometra column layout for {@link createThreeGeometraSplitHost} after coercion (JSON-friendly). */
+export interface PlainGeometraSplitHostLayoutOptions {
+    geometraWidth: number;
+    geometraOnLeft: boolean;
+}
+export interface ToPlainGeometraSplitHostLayoutOptionsInput {
+    geometraWidth?: number;
+    geometraOnLeft?: boolean;
+}
+/**
+ * Resolved split-host layout fields for logs, tests, or agent-side JSON without constructing the DOM host.
+ * Uses the same coercion as {@link createThreeGeometraSplitHost}.
+ */
+export declare function toPlainGeometraSplitHostLayoutOptions(options?: ToPlainGeometraSplitHostLayoutOptionsInput): PlainGeometraSplitHostLayoutOptions;
+/** Resolved stacked HUD layout for {@link createThreeGeometraStackedHost} after coercion (JSON-friendly). */
+export interface PlainGeometraStackedHostLayoutOptions {
+    geometraHudWidth: number;
+    geometraHudHeight: number;
+    geometraHudPlacement: GeometraHudPlacement;
+    geometraHudMargin: number;
+    geometraHudPointerEvents: string;
+    /** Coerced CSS `z-index` string (same value applied to the HUD wrapper in the stacked host). */
+    geometraHudZIndex: string;
+}
+export interface ToPlainGeometraStackedHostLayoutOptionsInput {
+    geometraHudWidth?: number;
+    geometraHudHeight?: number;
+    /** Runtime strings (e.g. from JSON) are normalized like {@link createThreeGeometraStackedHost}. */
+    geometraHudPlacement?: GeometraHudPlacement | string;
+    geometraHudMargin?: number;
+    geometraHudPointerEvents?: string;
+    geometraHudZIndex?: string | number;
+}
+/**
+ * Resolved stacked HUD layout fields for logs, tests, or agent-side JSON without constructing the DOM host.
+ * Uses the same coercion as {@link createThreeGeometraStackedHost}.
+ */
+export declare function toPlainGeometraStackedHostLayoutOptions(options?: ToPlainGeometraStackedHostLayoutOptionsInput): PlainGeometraStackedHostLayoutOptions;
+/**
+ * Axis-aligned HUD rectangle in the stacked host root’s coordinate system (origin top-left), matching
+ * the inset rules used by {@link createThreeGeometraStackedHost} (`right`/`bottom`/`left`/`top` on the
+ * absolutely positioned HUD wrapper).
+ *
+ * Root width and height are normalized with {@link normalizeGeometraLayoutPixels} per axis so they stay
+ * aligned with {@link PlainGeometraThreeViewSizingState.layoutWidth} / `layoutHeight` for the same CSS
+ * inputs. `width` and `height` are taken from {@link PlainGeometraStackedHostLayoutOptions} as-is.
+ *
+ * Use for custom overlay geometry, agent hit targets, or stacked layouts built outside this package
+ * without calling `getBoundingClientRect`.
+ */
+export interface PlainGeometraStackedHudRect {
+    left: number;
+    top: number;
+    width: number;
+    height: number;
+}
+/** Fields read by {@link toPlainGeometraStackedHudRect} (satisfied by {@link PlainGeometraStackedHostLayoutOptions} and stacked composite snapshots). */
+export type GeometraStackedHudRectLayoutInput = Pick<PlainGeometraStackedHostLayoutOptions, 'geometraHudWidth' | 'geometraHudHeight' | 'geometraHudPlacement' | 'geometraHudMargin'>;
+/**
+ * Compute {@link PlainGeometraStackedHudRect} from resolved stacked layout and root CSS size.
+ *
+ * @param layout - From {@link toPlainGeometraStackedHostLayoutOptions}, or any object that includes the
+ *   HUD width/height/placement/margin fields (for example {@link toPlainGeometraThreeStackedHostSnapshot}).
+ */
+export declare function toPlainGeometraStackedHudRect(layout: GeometraStackedHudRectLayoutInput, rootCssWidth: number, rootCssHeight: number): PlainGeometraStackedHudRect;
+/** Literal tag on composite plain snapshots so JSON consumers can tell hybrid layout without inferring fields. */
+export type GeometraHybridHostKind = 'split' | 'stacked';
+/** Every {@link GeometraHybridHostKind} value (stable iteration, prompts, or defensive checks). */
+export declare const GEOMETRA_HYBRID_HOST_KINDS: readonly GeometraHybridHostKind[];
+/**
+ * Narrow `unknown` to {@link GeometraHybridHostKind} when parsing composite snapshot JSON from logs or agents.
+ */
+export declare function isGeometraHybridHostKind(value: unknown): value is GeometraHybridHostKind;
+/**
+ * Narrow `unknown` to {@link GeometraHybridHostKind} using the same trim + case-insensitive literals as
+ * {@link coerceGeometraHybridHostKind} and {@link isPlainGeometraThreeSplitHostSnapshot} /
+ * {@link isPlainGeometraThreeStackedHostSnapshot}. Use when agent or log JSON may carry whitespace or mixed case;
+ * prefer {@link isGeometraHybridHostKind} when the value is already normalized.
+ */
+export declare function isPlainGeometraHybridHostKind(value: unknown): value is GeometraHybridHostKind;
+/**
+ * Normalize {@link GeometraHybridHostKind} from runtime values (e.g. agent JSON or untyped config).
+ * Literal `'split'` and `'stacked'` pass through. Strings are trimmed and matched **case-insensitively**;
+ * unknown or empty strings use `fallback` (same normalization idea as {@link coerceGeometraHudPlacement}).
+ *
+ * For narrowing without coercion, use {@link isGeometraHybridHostKind} for exact literals or
+ * {@link isPlainGeometraHybridHostKind} when payloads may use whitespace or mixed case.
+ */
+export declare function coerceGeometraHybridHostKind(value: unknown, fallback: GeometraHybridHostKind): GeometraHybridHostKind;
+/**
+ * Narrow `unknown` (e.g. `JSON.parse`) to {@link PlainGeometraSplitHostLayoutOptions} — the layout-only
+ * fields from {@link toPlainGeometraSplitHostLayoutOptions} without viewport or scene sizing. Extra keys
+ * are allowed. Composite {@link PlainGeometraThreeSplitHostSnapshot} values satisfy this guard as well.
+ */
+export declare function isPlainGeometraSplitHostLayoutOptions(value: unknown): value is PlainGeometraSplitHostLayoutOptions;
+/**
+ * Narrow `unknown` (e.g. `JSON.parse`) to {@link PlainGeometraStackedHostLayoutOptions} — the HUD layout
+ * fields from {@link toPlainGeometraStackedHostLayoutOptions} without viewport or scene. Extra keys are
+ * allowed. `geometraHudPlacement` must be exactly one of the four corner literals (same rule as
+ * {@link isPlainGeometraThreeStackedHostSnapshot}; normalize loose strings with {@link coerceGeometraHudPlacement}
+ * before asserting). Composite {@link PlainGeometraThreeStackedHostSnapshot} values satisfy this guard too.
+ */
+export declare function isPlainGeometraStackedHostLayoutOptions(value: unknown): value is PlainGeometraStackedHostLayoutOptions;
+/**
+ * Narrow `unknown` (e.g. `JSON.parse`) to {@link PlainGeometraThreeSplitHostSnapshot} when the object
+ * matches the shape produced by {@link toPlainGeometraThreeSplitHostSnapshot} /
+ * {@link toPlainGeometraThreeSplitHostSnapshotHeadless}. `geometraHybridHostKind` accepts the same trim +
+ * case-insensitive literals as {@link coerceGeometraHybridHostKind} (not only exact `'split'`).
+ * `geometraWidth` is finite and **≥ 0**, same as
+ * {@link coerceHostNonNegativeCssPx}. Complements {@link isGeometraHybridHostKind} for composite agent or log payloads.
+ */
+export declare function isPlainGeometraThreeSplitHostSnapshot(value: unknown): value is PlainGeometraThreeSplitHostSnapshot;
+/**
+ * Same idea as {@link isPlainGeometraThreeSplitHostSnapshot} for {@link PlainGeometraThreeStackedHostSnapshot}
+ * / {@link toPlainGeometraThreeStackedHostSnapshot} / {@link toPlainGeometraThreeStackedHostSnapshotHeadless}.
+ * `geometraHybridHostKind` accepts the same trim + case-insensitive literals as {@link coerceGeometraHybridHostKind}.
+ * HUD width, height, and margin are finite and **≥ 0**, same as {@link coerceHostNonNegativeCssPx}.
+ */
+export declare function isPlainGeometraThreeStackedHostSnapshot(value: unknown): value is PlainGeometraThreeStackedHostSnapshot;
+/**
+ * Split-host layout fields plus {@link PlainGeometraThreeHostSnapshot} in one JSON-friendly object —
+ * same coercion as {@link toPlainGeometraSplitHostLayoutOptions} and {@link toPlainGeometraThreeHostSnapshot}.
+ *
+ * Use for logs, tests, or agent payloads that describe column chrome and Three viewport/scene together.
+ * The `geometraHybridHostKind` field is always `'split'` on values from {@link toPlainGeometraThreeSplitHostSnapshot} /
+ * {@link toPlainGeometraThreeSplitHostSnapshotHeadless}.
+ */
+export type PlainGeometraThreeSplitHostSnapshot = PlainGeometraSplitHostLayoutOptions & PlainGeometraThreeHostSnapshot & {
+    geometraHybridHostKind: 'split';
+};
+/**
+ * Stacked-host HUD layout plus {@link PlainGeometraThreeHostSnapshot} (full-viewport Three sizing, not HUD box size).
+ *
+ * Same coercion as {@link toPlainGeometraStackedHostLayoutOptions} and {@link toPlainGeometraThreeHostSnapshot}.
+ * The `geometraHybridHostKind` field is always `'stacked'` on values from {@link toPlainGeometraThreeStackedHostSnapshot} /
+ * {@link toPlainGeometraThreeStackedHostSnapshotHeadless}.
+ */
+export type PlainGeometraThreeStackedHostSnapshot = PlainGeometraStackedHostLayoutOptions & PlainGeometraThreeHostSnapshot & {
+    geometraHybridHostKind: 'stacked';
+};
+/**
+ * Merge split layout and host viewport/scene plain fields for stable JSON.
+ *
+ * @see PlainGeometraThreeSplitHostSnapshot
+ */
+export declare function toPlainGeometraThreeSplitHostSnapshot(layoutOptions: ToPlainGeometraSplitHostLayoutOptionsInput | undefined, cssWidth: number, cssHeight: number, rawDevicePixelRatio: number, maxDevicePixelRatio?: number, sceneBasicsOptions?: GeometraThreeSceneBasicsOptions): PlainGeometraThreeSplitHostSnapshot;
+/**
+ * Same as {@link toPlainGeometraThreeSplitHostSnapshot} with raw device pixel ratio **1** —
+ * parity with {@link toPlainGeometraThreeHostSnapshotHeadless} for headless or agent payloads without a `window`.
+ */
+export declare function toPlainGeometraThreeSplitHostSnapshotHeadless(layoutOptions: ToPlainGeometraSplitHostLayoutOptionsInput | undefined, cssWidth: number, cssHeight: number, maxDevicePixelRatio?: number, sceneBasicsOptions?: GeometraThreeSceneBasicsOptions): PlainGeometraThreeSplitHostSnapshot;
+/**
+ * Merge stacked HUD layout and host viewport/scene plain fields for stable JSON.
+ *
+ * @see PlainGeometraThreeStackedHostSnapshot
+ */
+export declare function toPlainGeometraThreeStackedHostSnapshot(layoutOptions: ToPlainGeometraStackedHostLayoutOptionsInput | undefined, cssWidth: number, cssHeight: number, rawDevicePixelRatio: number, maxDevicePixelRatio?: number, sceneBasicsOptions?: GeometraThreeSceneBasicsOptions): PlainGeometraThreeStackedHostSnapshot;
+/**
+ * Same as {@link toPlainGeometraThreeStackedHostSnapshot} with raw device pixel ratio **1**.
+ */
+export declare function toPlainGeometraThreeStackedHostSnapshotHeadless(layoutOptions: ToPlainGeometraStackedHostLayoutOptionsInput | undefined, cssWidth: number, cssHeight: number, maxDevicePixelRatio?: number, sceneBasicsOptions?: GeometraThreeSceneBasicsOptions): PlainGeometraThreeStackedHostSnapshot;
+//# sourceMappingURL=host-layout-plain.d.ts.map

package/dist/host-layout-plain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"host-layout-plain.d.ts","sourceRoot":"","sources":["../src/host-layout-plain.ts"],"names":[],"mappings":"AAEA,OAAO,EAKL,KAAK,oBAAoB,EAC1B,MAAM,sBAAsB,CAAA;AAC7B,OAAO,EAIL,KAAK,+BAA+B,EACpC,KAAK,8BAA8B,EACpC,MAAM,yBAAyB,CAAA;AAGhC,+GAA+G;AAC/G,MAAM,WAAW,mCAAmC;IAClD,aAAa,EAAE,MAAM,CAAA;IACrB,cAAc,EAAE,OAAO,CAAA;CACxB;AAED,MAAM,WAAW,0CAA0C;IACzD,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,cAAc,CAAC,EAAE,OAAO,CAAA;CACzB;AAED;;;GAGG;AACH,wBAAgB,qCAAqC,CACnD,OAAO,GAAE,0CAA+C,GACvD,mCAAmC,CAUrC;AAED,6GAA6G;AAC7G,MAAM,WAAW,qCAAqC;IACpD,gBAAgB,EAAE,MAAM,CAAA;IACxB,iBAAiB,EAAE,MAAM,CAAA;IACzB,oBAAoB,EAAE,oBAAoB,CAAA;IAC1C,iBAAiB,EAAE,MAAM,CAAA;IACzB,wBAAwB,EAAE,MAAM,CAAA;IAChC,gGAAgG;IAChG,iBAAiB,EAAE,MAAM,CAAA;CAC1B;AAED,MAAM,WAAW,4CAA4C;IAC3D,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,mGAAmG;IACnG,oBAAoB,CAAC,EAAE,oBAAoB,GAAG,MAAM,CAAA;IACpD,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,wBAAwB,CAAC,EAAE,MAAM,CAAA;IACjC,iBAAiB,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;CACpC;AAED;;;GAGG;AACH,wBAAgB,uCAAuC,CACrD,OAAO,GAAE,4CAAiD,GACzD,qCAAqC,CA6BvC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,2BAA2B;IAC1C,IAAI,EAAE,MAAM,CAAA;IACZ,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;CACf;AAED,yJAAyJ;AACzJ,MAAM,MAAM,iCAAiC,GAAG,IAAI,CAClD,qCAAqC,EACrC,kBAAkB,GAAG,mBAAmB,GAAG,sBAAsB,GAAG,mBAAmB,CACxF,CAAA;AAED;;;;;GAKG;AACH,wBAAgB,6BAA6B,CAC3C,MAAM,EAAE,iCAAiC,EACzC,YAAY,EAAE,MAAM,EACpB,aAAa,EAAE,MAAM,GACpB,2BAA2B,CAe7B;AAED,kHAAkH;AAClH,MAAM,MAAM,sBAAsB,GAAG,OAAO,GAAG,SAAS,CAAA;AAExD,mGAAmG;AACnG,eAAO,MAAM,0BAA0B,EAAE,SAAS,sBAAsB,EAAyB,CAAA;AAejG;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,sBAAsB,CAExF;AAED;;;;;GAKG;AACH,wBAAgB,6BAA6B,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,sBAAsB,CAE7F;AAED;;;;;;;GAOG;AACH,wBAAgB,4BAA4B,CAC1C,KAAK,EAAE,OAAO,EACd,QAAQ,EAAE,sBAAsB,GAC/B,sBAAsB,CAExB;AASD;;;;GAIG;AACH,wBAAgB,qCAAqC,CACnD,KAAK,EAAE,OAAO,GACb,KAAK,IAAI,mCAAmC,CAQ9C;AAED;;;;;;GAMG;AACH,wBAAgB,uCAAuC,CACrD,KAAK,EAAE,OAAO,GACb,KAAK,IAAI,qCAAqC,CAsBhD;AAED;;;;;;;GAOG;AACH,wBAAgB,qCAAqC,CACnD,KAAK,EAAE,OAAO,GACb,KAAK,IAAI,mCAAmC,CAS9C;AAED;;;;;GAKG;AACH,wBAAgB,uCAAuC,CACrD,KAAK,EAAE,OAAO,GACb,KAAK,IAAI,qCAAqC,CAuBhD;AAED;;;;;;;GAOG;AACH,MAAM,MAAM,mCAAmC,GAAG,mCAAmC,GACnF,8BAA8B,GAAG;IAC/B,sBAAsB,EAAE,OAAO,CAAA;CAChC,CAAA;AAEH;;;;;;GAMG;AACH,MAAM,MAAM,qCAAqC,GAAG,qCAAqC,GACvF,8BAA8B,GAAG;IAC/B,sBAAsB,EAAE,SAAS,CAAA;CAClC,CAAA;AAEH;;;;GAIG;AACH,wBAAgB,qCAAqC,CACnD,aAAa,EAAE,0CAA0C,YAAK,EAC9D,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,mBAAmB,EAAE,MAAM,EAC3B,mBAAmB,CAAC,EAAE,MAAM,EAC5B,kBAAkB,GAAE,+BAAoC,GACvD,mCAAmC,CAYrC;AAED;;;GAGG;AACH,wBAAgB,6CAA6C,CAC3D,aAAa,EAAE,0CAA0C,YAAK,EAC9D,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,mBAAmB,CAAC,EAAE,MAAM,EAC5B,kBAAkB,GAAE,+BAAoC,GACvD,mCAAmC,CAMrC;AAED;;;;GAIG;AACH,wBAAgB,uCAAuC,CACrD,aAAa,EAAE,4CAA4C,YAAK,EAChE,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,mBAAmB,EAAE,MAAM,EAC3B,mBAAmB,CAAC,EAAE,MAAM,EAC5B,kBAAkB,GAAE,+BAAoC,GACvD,qCAAqC,CAYvC;AAED;;GAEG;AACH,wBAAgB,+CAA+C,CAC7D,aAAa,EAAE,4CAA4C,YAAK,EAChE,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,mBAAmB,CAAC,EAAE,MAAM,EAC5B,kBAAkB,GAAE,+BAAoC,GACvD,qCAAqC,CAMvC"}

package/dist/host-layout-plain.js

@@ -0,0 +1,255 @@
+import { GEOMETRA_SPLIT_HOST_LAYOUT_DEFAULTS } from './split-host.js';
+import { GEOMETRA_STACKED_HOST_LAYOUT_DEFAULTS } from './stacked-host.js';
+import { coerceGeometraHudPlacement, coerceGeometraHudPointerEvents, coerceHostNonNegativeCssPx, coerceHostStackingZIndexCss, } from './host-css-coerce.js';
+import { isPlainGeometraThreeHostSnapshot, toPlainGeometraThreeHostSnapshot, toPlainGeometraThreeHostSnapshotHeadless, } from './three-scene-basics.js';
+import { normalizeGeometraLayoutPixels } from './utils.js';
+/**
+ * Resolved split-host layout fields for logs, tests, or agent-side JSON without constructing the DOM host.
+ * Uses the same coercion as {@link createThreeGeometraSplitHost}.
+ */
+export function toPlainGeometraSplitHostLayoutOptions(options = {}) {
+    const d = GEOMETRA_SPLIT_HOST_LAYOUT_DEFAULTS;
+    const geometraWidth = coerceHostNonNegativeCssPx(options.geometraWidth ?? d.geometraWidth, d.geometraWidth);
+    return {
+        geometraWidth,
+        geometraOnLeft: options.geometraOnLeft ?? false,
+    };
+}
+/**
+ * Resolved stacked HUD layout fields for logs, tests, or agent-side JSON without constructing the DOM host.
+ * Uses the same coercion as {@link createThreeGeometraStackedHost}.
+ */
+export function toPlainGeometraStackedHostLayoutOptions(options = {}) {
+    const d = GEOMETRA_STACKED_HOST_LAYOUT_DEFAULTS;
+    const geometraHudWidth = coerceHostNonNegativeCssPx(options.geometraHudWidth ?? d.geometraHudWidth, d.geometraHudWidth);
+    const geometraHudHeight = coerceHostNonNegativeCssPx(options.geometraHudHeight ?? d.geometraHudHeight, d.geometraHudHeight);
+    const geometraHudMargin = coerceHostNonNegativeCssPx(options.geometraHudMargin ?? d.geometraHudMargin, d.geometraHudMargin);
+    const geometraHudPlacementOpt = options.geometraHudPlacement ?? d.geometraHudPlacement;
+    const geometraHudPlacement = coerceGeometraHudPlacement(geometraHudPlacementOpt, d.geometraHudPlacement);
+    const geometraHudPointerEvents = coerceGeometraHudPointerEvents(options.geometraHudPointerEvents, 'auto');
+    const geometraHudZIndex = coerceHostStackingZIndexCss(options.geometraHudZIndex ?? 1, 1);
+    return {
+        geometraHudWidth,
+        geometraHudHeight,
+        geometraHudPlacement,
+        geometraHudMargin,
+        geometraHudPointerEvents,
+        geometraHudZIndex,
+    };
+}
+/**
+ * Compute {@link PlainGeometraStackedHudRect} from resolved stacked layout and root CSS size.
+ *
+ * @param layout - From {@link toPlainGeometraStackedHostLayoutOptions}, or any object that includes the
+ *   HUD width/height/placement/margin fields (for example {@link toPlainGeometraThreeStackedHostSnapshot}).
+ */
+export function toPlainGeometraStackedHudRect(layout, rootCssWidth, rootCssHeight) {
+    const rw = normalizeGeometraLayoutPixels(rootCssWidth);
+    const rh = normalizeGeometraLayoutPixels(rootCssHeight);
+    const { geometraHudWidth: w, geometraHudHeight: h, geometraHudPlacement: p, geometraHudMargin: m } = layout;
+    switch (p) {
+        case 'bottom-right':
+            return { left: rw - w - m, top: rh - h - m, width: w, height: h };
+        case 'bottom-left':
+            return { left: m, top: rh - h - m, width: w, height: h };
+        case 'top-right':
+            return { left: rw - w - m, top: m, width: w, height: h };
+        case 'top-left':
+            return { left: m, top: m, width: w, height: h };
+    }
+}
+/** Every {@link GeometraHybridHostKind} value (stable iteration, prompts, or defensive checks). */
+export const GEOMETRA_HYBRID_HOST_KINDS = ['split', 'stacked'];
+/**
+ * Parse a {@link GeometraHybridHostKind} from loose input (trim + case-insensitive literals) without a fallback.
+ * Used by {@link coerceGeometraHybridHostKind} and composite {@link isPlainGeometraThreeSplitHostSnapshot} /
+ * {@link isPlainGeometraThreeStackedHostSnapshot} guards so agent JSON matches coercion rules.
+ */
+function parseGeometraHybridHostKindLiteral(value) {
+    if (value === 'split' || value === 'stacked')
+        return value;
+    if (typeof value !== 'string')
+        return undefined;
+    const key = value.trim().toLowerCase();
+    if (key === 'split' || key === 'stacked')
+        return key;
+    return undefined;
+}
+/**
+ * Narrow `unknown` to {@link GeometraHybridHostKind} when parsing composite snapshot JSON from logs or agents.
+ */
+export function isGeometraHybridHostKind(value) {
+    return value === 'split' || value === 'stacked';
+}
+/**
+ * Narrow `unknown` to {@link GeometraHybridHostKind} using the same trim + case-insensitive literals as
+ * {@link coerceGeometraHybridHostKind} and {@link isPlainGeometraThreeSplitHostSnapshot} /
+ * {@link isPlainGeometraThreeStackedHostSnapshot}. Use when agent or log JSON may carry whitespace or mixed case;
+ * prefer {@link isGeometraHybridHostKind} when the value is already normalized.
+ */
+export function isPlainGeometraHybridHostKind(value) {
+    return parseGeometraHybridHostKindLiteral(value) !== undefined;
+}
+/**
+ * Normalize {@link GeometraHybridHostKind} from runtime values (e.g. agent JSON or untyped config).
+ * Literal `'split'` and `'stacked'` pass through. Strings are trimmed and matched **case-insensitively**;
+ * unknown or empty strings use `fallback` (same normalization idea as {@link coerceGeometraHudPlacement}).
+ *
+ * For narrowing without coercion, use {@link isGeometraHybridHostKind} for exact literals or
+ * {@link isPlainGeometraHybridHostKind} when payloads may use whitespace or mixed case.
+ */
+export function coerceGeometraHybridHostKind(value, fallback) {
+    return parseGeometraHybridHostKindLiteral(value) ?? fallback;
+}
+const GEOMETRA_HUD_PLACEMENT_LITERALS = new Set([
+    'bottom-right',
+    'bottom-left',
+    'top-right',
+    'top-left',
+]);
+/**
+ * Narrow `unknown` (e.g. `JSON.parse`) to {@link PlainGeometraSplitHostLayoutOptions} — the layout-only
+ * fields from {@link toPlainGeometraSplitHostLayoutOptions} without viewport or scene sizing. Extra keys
+ * are allowed. Composite {@link PlainGeometraThreeSplitHostSnapshot} values satisfy this guard as well.
+ */
+export function isPlainGeometraSplitHostLayoutOptions(value) {
+    if (value === null || typeof value !== 'object')
+        return false;
+    const o = value;
+    if (typeof o.geometraOnLeft !== 'boolean')
+        return false;
+    if (typeof o.geometraWidth !== 'number' || !Number.isFinite(o.geometraWidth) || o.geometraWidth < 0) {
+        return false;
+    }
+    return true;
+}
+/**
+ * Narrow `unknown` (e.g. `JSON.parse`) to {@link PlainGeometraStackedHostLayoutOptions} — the HUD layout
+ * fields from {@link toPlainGeometraStackedHostLayoutOptions} without viewport or scene. Extra keys are
+ * allowed. `geometraHudPlacement` must be exactly one of the four corner literals (same rule as
+ * {@link isPlainGeometraThreeStackedHostSnapshot}; normalize loose strings with {@link coerceGeometraHudPlacement}
+ * before asserting). Composite {@link PlainGeometraThreeStackedHostSnapshot} values satisfy this guard too.
+ */
+export function isPlainGeometraStackedHostLayoutOptions(value) {
+    if (value === null || typeof value !== 'object')
+        return false;
+    const o = value;
+    if (typeof o.geometraHudWidth !== 'number' ||
+        !Number.isFinite(o.geometraHudWidth) ||
+        o.geometraHudWidth < 0 ||
+        typeof o.geometraHudHeight !== 'number' ||
+        !Number.isFinite(o.geometraHudHeight) ||
+        o.geometraHudHeight < 0 ||
+        typeof o.geometraHudMargin !== 'number' ||
+        !Number.isFinite(o.geometraHudMargin) ||
+        o.geometraHudMargin < 0) {
+        return false;
+    }
+    if (typeof o.geometraHudPlacement !== 'string' || !GEOMETRA_HUD_PLACEMENT_LITERALS.has(o.geometraHudPlacement)) {
+        return false;
+    }
+    if (typeof o.geometraHudPointerEvents !== 'string')
+        return false;
+    if (typeof o.geometraHudZIndex !== 'string')
+        return false;
+    return true;
+}
+/**
+ * Narrow `unknown` (e.g. `JSON.parse`) to {@link PlainGeometraThreeSplitHostSnapshot} when the object
+ * matches the shape produced by {@link toPlainGeometraThreeSplitHostSnapshot} /
+ * {@link toPlainGeometraThreeSplitHostSnapshotHeadless}. `geometraHybridHostKind` accepts the same trim +
+ * case-insensitive literals as {@link coerceGeometraHybridHostKind} (not only exact `'split'`).
+ * `geometraWidth` is finite and **≥ 0**, same as
+ * {@link coerceHostNonNegativeCssPx}. Complements {@link isGeometraHybridHostKind} for composite agent or log payloads.
+ */
+export function isPlainGeometraThreeSplitHostSnapshot(value) {
+    if (value === null || typeof value !== 'object')
+        return false;
+    const o = value;
+    if (parseGeometraHybridHostKindLiteral(o.geometraHybridHostKind) !== 'split')
+        return false;
+    if (typeof o.geometraOnLeft !== 'boolean')
+        return false;
+    if (typeof o.geometraWidth !== 'number' || !Number.isFinite(o.geometraWidth) || o.geometraWidth < 0) {
+        return false;
+    }
+    return isPlainGeometraThreeHostSnapshot(value);
+}
+/**
+ * Same idea as {@link isPlainGeometraThreeSplitHostSnapshot} for {@link PlainGeometraThreeStackedHostSnapshot}
+ * / {@link toPlainGeometraThreeStackedHostSnapshot} / {@link toPlainGeometraThreeStackedHostSnapshotHeadless}.
+ * `geometraHybridHostKind` accepts the same trim + case-insensitive literals as {@link coerceGeometraHybridHostKind}.
+ * HUD width, height, and margin are finite and **≥ 0**, same as {@link coerceHostNonNegativeCssPx}.
+ */
+export function isPlainGeometraThreeStackedHostSnapshot(value) {
+    if (value === null || typeof value !== 'object')
+        return false;
+    const o = value;
+    if (parseGeometraHybridHostKindLiteral(o.geometraHybridHostKind) !== 'stacked')
+        return false;
+    if (typeof o.geometraHudWidth !== 'number' ||
+        !Number.isFinite(o.geometraHudWidth) ||
+        o.geometraHudWidth < 0 ||
+        typeof o.geometraHudHeight !== 'number' ||
+        !Number.isFinite(o.geometraHudHeight) ||
+        o.geometraHudHeight < 0 ||
+        typeof o.geometraHudMargin !== 'number' ||
+        !Number.isFinite(o.geometraHudMargin) ||
+        o.geometraHudMargin < 0) {
+        return false;
+    }
+    if (typeof o.geometraHudPlacement !== 'string' || !GEOMETRA_HUD_PLACEMENT_LITERALS.has(o.geometraHudPlacement)) {
+        return false;
+    }
+    if (typeof o.geometraHudPointerEvents !== 'string')
+        return false;
+    if (typeof o.geometraHudZIndex !== 'string')
+        return false;
+    return isPlainGeometraThreeHostSnapshot(value);
+}
+/**
+ * Merge split layout and host viewport/scene plain fields for stable JSON.
+ *
+ * @see PlainGeometraThreeSplitHostSnapshot
+ */
+export function toPlainGeometraThreeSplitHostSnapshot(layoutOptions = {}, cssWidth, cssHeight, rawDevicePixelRatio, maxDevicePixelRatio, sceneBasicsOptions = {}) {
+    return {
+        geometraHybridHostKind: 'split',
+        ...toPlainGeometraSplitHostLayoutOptions(layoutOptions),
+        ...toPlainGeometraThreeHostSnapshot(cssWidth, cssHeight, rawDevicePixelRatio, maxDevicePixelRatio, sceneBasicsOptions),
+    };
+}
+/**
+ * Same as {@link toPlainGeometraThreeSplitHostSnapshot} with raw device pixel ratio **1** —
+ * parity with {@link toPlainGeometraThreeHostSnapshotHeadless} for headless or agent payloads without a `window`.
+ */
+export function toPlainGeometraThreeSplitHostSnapshotHeadless(layoutOptions = {}, cssWidth, cssHeight, maxDevicePixelRatio, sceneBasicsOptions = {}) {
+    return {
+        geometraHybridHostKind: 'split',
+        ...toPlainGeometraSplitHostLayoutOptions(layoutOptions),
+        ...toPlainGeometraThreeHostSnapshotHeadless(cssWidth, cssHeight, maxDevicePixelRatio, sceneBasicsOptions),
+    };
+}
+/**
+ * Merge stacked HUD layout and host viewport/scene plain fields for stable JSON.
+ *
+ * @see PlainGeometraThreeStackedHostSnapshot
+ */
+export function toPlainGeometraThreeStackedHostSnapshot(layoutOptions = {}, cssWidth, cssHeight, rawDevicePixelRatio, maxDevicePixelRatio, sceneBasicsOptions = {}) {
+    return {
+        geometraHybridHostKind: 'stacked',
+        ...toPlainGeometraStackedHostLayoutOptions(layoutOptions),
+        ...toPlainGeometraThreeHostSnapshot(cssWidth, cssHeight, rawDevicePixelRatio, maxDevicePixelRatio, sceneBasicsOptions),
+    };
+}
+/**
+ * Same as {@link toPlainGeometraThreeStackedHostSnapshot} with raw device pixel ratio **1**.
+ */
+export function toPlainGeometraThreeStackedHostSnapshotHeadless(layoutOptions = {}, cssWidth, cssHeight, maxDevicePixelRatio, sceneBasicsOptions = {}) {
+    return {
+        geometraHybridHostKind: 'stacked',
+        ...toPlainGeometraStackedHostLayoutOptions(layoutOptions),
+        ...toPlainGeometraThreeHostSnapshotHeadless(cssWidth, cssHeight, maxDevicePixelRatio, sceneBasicsOptions),
+    };
+}
+//# sourceMappingURL=host-layout-plain.js.map