@react-x11/components 0.1.0 → 0.2.1

package/dist/three/canvas.js

@@ -0,0 +1,305 @@
+// `<Canvas>` — the react-three-fiber-shaped entry point, standing on core's
+// public `<glarea>` element.
+//
+// The division of labour: `<glarea>` owns everything that is renderer
+// internals — the child X window on a GL visual, the context, the frame
+// clock, the swap — and exposes it as `onCreated`/`onDraw`/`frameLoop`.
+// This component owns everything that is scene: the second reconciler
+// rendering `children` into the object graph, the store `useThree`/`useFrame`
+// read, the backend-appropriate renderer, picking, and post-processing.
+//
+// Which backend draws is not chosen here: ntk's `glPolicy` decided it when
+// the connection was made, and the context that arrives says which one it
+// is. `glPolicy: 'auto'` at createRoot() is what "pick the best available"
+// spells — the same scene JSX renders either way, which is the point of the
+// shared subset.
+import { createElement as h, useCallback, useEffect, useLayoutEffect, useMemo, useRef, useState, } from 'react';
+import { useSupports } from 'react-x11';
+import { hx } from './hx.js';
+import { OrthographicCamera, PerspectiveCamera, Scene } from './objects.js';
+import { applyProps, createSceneRoot } from './reconciler.js';
+import { ThreeContext, computeViewport, createThreeStore } from './store.js';
+import { IndirectRenderer } from './renderer-indirect.js';
+import { DirectRenderer } from './renderer-direct.js';
+import { PostProcessor } from './postprocess.js';
+import { ScenePointer } from './events.js';
+import { sceneWantsPointer } from './raycast.js';
+import { now, warn } from './globals.js';
+/**
+ * Failures that mean "one thing in this scene is broken", not "this machine
+ * has no 3D". The fallback is for the second: replacing a whole scene with
+ * "no 3D here" because a pass shader has a typo would send the reader off
+ * to check their drivers.
+ */
+const SCENE_LEVEL = new Set([
+    'GL_SHADER_FAILED',
+    'GL_CONTEXT_INCOMPLETE',
+    'GL_POST_UNAVAILABLE',
+    'GL_POST_TARGET_FAILED',
+]);
+const isGeometry = (value) => value.isBufferGeometry === true;
+export function Canvas({ children, style, camera, orthographic = false, frameloop = 'demand', clearColor, glx, fallback, onCreated, onPointerMissed, onError, onDraw, }) {
+    const supportsShaders = useSupports('shaders');
+    const [error, setError] = useState(null);
+    const areaRef = useRef(null);
+    // Everything with the canvas's lifetime, made once. The camera the scene
+    // starts with is the default one; `<perspectiveCamera makeDefault>`
+    // replaces it through the store.
+    const kit = useMemo(() => {
+        const scene = new Scene();
+        const defaultCamera = orthographic
+            ? new OrthographicCamera()
+            : new PerspectiveCamera();
+        const size = { width: 1, height: 1 };
+        const store = createThreeStore({
+            gl: null,
+            backend: null,
+            scene,
+            camera: defaultCamera,
+            size,
+            viewport: computeViewport(defaultCamera, size),
+            clock: { elapsedTime: 0, delta: 0 },
+            supportsShaders,
+            frameloop,
+            invalidate: () => {
+                const node = areaRef.current;
+                node?.requestFrame?.();
+            },
+        });
+        const state = {
+            scene,
+            store,
+            container: {
+                scene,
+                store,
+                invalidate: () => store.getState().invalidate(),
+                onRemoved: (instance) => {
+                    state.pointer.forget(instance);
+                    if (isGeometry(instance))
+                        state.disposals.push(instance);
+                },
+            },
+            pointer: new ScenePointer({
+                scene,
+                cameraOf: () => state.renderer?.camera ?? null,
+                onPointerMissed: (event) => {
+                    // read through a ref so the prop can change without remaking the kit
+                    missedRef.current?.(event);
+                },
+            }),
+            renderer: null,
+            post: null,
+            gl: null,
+            disposals: [],
+            root: null,
+            lastFrameAt: null,
+            firstFrameAt: null,
+        };
+        // mutations arriving outside React — `ref.current.position.x = 2` in an
+        // event handler — redraw a demand-mode surface without an invalidate()
+        scene.propagateDirty(() => store.getState().invalidate());
+        return state;
+        // the kit is per-mount; remaking it on prop changes would drop the scene
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, []);
+    const missedRef = useRef(onPointerMissed);
+    missedRef.current = onPointerMissed;
+    // r3f's camera prop contract: partial settings applied onto the default
+    // camera, diffed so an unchanged inline object costs nothing new.
+    const prevCameraProps = useRef({});
+    useEffect(() => {
+        if (!camera)
+            return;
+        applyProps(kit.store.getState().camera, prevCameraProps.current, camera);
+        prevCameraProps.current = camera;
+        kit.store.getState().invalidate();
+    }, [camera, kit]);
+    useEffect(() => {
+        if (kit.store.getState().frameloop !== frameloop) {
+            kit.store.setState({ frameloop });
+        }
+    }, [frameloop, kit]);
+    // Until a context exists the hook is the best prediction there is, and
+    // it can settle false→true after the kit captured it (caps resolve on
+    // their own clock). Keep the store following the hook so a direct-only
+    // element mounting on that flip is judged by the fresh value — declared
+    // before the scene-root effects so it lands first. The created context
+    // overwrites this with the backend that actually arrived.
+    useLayoutEffect(() => {
+        const state = kit.store.getState();
+        if (!state.backend && state.supportsShaders !== supportsShaders) {
+            kit.store.setState({ supportsShaders });
+        }
+    }, [kit, supportsShaders]);
+    // The scene root: created once, fed the children every render, torn down
+    // with the canvas. `useLayoutEffect` so the scene exists before the
+    // surface's first frame asks it to draw.
+    useLayoutEffect(() => {
+        kit.root = createSceneRoot(kit.container);
+        return () => {
+            kit.root?.unmount();
+            kit.root = null;
+            if (kit.renderer && kit.gl) {
+                kit.renderer.dispose(kit.gl);
+                kit.post?.dispose(kit.gl);
+            }
+        };
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [kit]);
+    useLayoutEffect(() => {
+        kit.root?.render(h(ThreeContext.Provider, { value: kit.store }, children));
+    });
+    // The surface animates while anything subscribes to useFrame — that is
+    // what makes a ported r3f component move — or while frameloop asks for it.
+    const [animating, setAnimating] = useState(false);
+    useEffect(() => kit.store.subscribe(() => {
+        setAnimating(kit.store.frames.length > 0);
+    }), [kit]);
+    const handleError = useCallback((err) => {
+        // The fallback means "this surface has no GL", so only a failure to
+        // get a context switches to it.
+        if (!SCENE_LEVEL.has(err?.code ?? ''))
+            setError(err);
+        if (onError)
+            return onError(err);
+        if (fallback === undefined) {
+            warn(`@react-x11/components: <Canvas>: ${err?.message ?? err}`);
+        }
+    }, [onError, fallback]);
+    const handleCreated = useCallback((gl) => {
+        kit.gl = gl;
+        const backend = gl?.backend === 'direct' ? 'direct' : 'indirect';
+        if (backend === 'direct') {
+            const renderer = new DirectRenderer();
+            renderer.onError = handleError;
+            kit.renderer = renderer;
+        }
+        else {
+            kit.renderer = new IndirectRenderer();
+        }
+        // The context in hand outranks any prediction: once a backend has
+        // actually arrived, `useThree((s) => s.supportsShaders)` and the
+        // direct-only mount guard follow it. (Since react-x11#358 the
+        // useSupports('shaders') hook is policy-aware and agrees with this;
+        // writing it here keeps the store truthful on any core version.)
+        kit.store.setState({
+            gl,
+            backend,
+            supportsShaders: backend === 'direct',
+        });
+        onCreated?.(kit.store.getState());
+    }, 
+    // handleError is stable enough (fallback/onError changes reroute later
+    // reports through the current closure on the next created surface)
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+    [kit]);
+    const onDrawRef = useRef(onDraw);
+    onDrawRef.current = onDraw;
+    const handleDraw = useCallback(
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    (gl, info) => {
+        const renderer = kit.renderer;
+        if (!renderer)
+            return;
+        const store = kit.store;
+        const state = store.getState();
+        if (state.size.width !== info.width ||
+            state.size.height !== info.height) {
+            const size = { width: info.width, height: info.height };
+            store.setState({
+                size,
+                viewport: computeViewport(state.camera, size),
+            });
+        }
+        // geometry that left the tree: its server/GPU resources go with it
+        if (kit.disposals.length) {
+            for (const geometry of kit.disposals)
+                renderer.forget(gl, geometry);
+            kit.disposals.length = 0;
+        }
+        // the frame clock, before anything draws: a callback that mutates the
+        // scene is drawing this frame, and one that sets React state lands on
+        // the next — both the r3f contract
+        const time = now();
+        if (kit.firstFrameAt === null)
+            kit.firstFrameAt = time;
+        // clamped: a surface that was occluded for a second must not teleport
+        // everything that integrates against delta
+        const delta = Math.min((time - (kit.lastFrameAt ?? time)) / 1000, 0.1);
+        kit.lastFrameAt = time;
+        const clock = store.getState().clock;
+        clock.elapsedTime = (time - kit.firstFrameAt) / 1000;
+        clock.delta = delta;
+        store.runFrames(store.getState(), delta);
+        // pointer events are only worth selecting on the X window when
+        // something in the scene listens — checked when the tree said it
+        // changed, attached the first time it is true
+        if (store.eventsDirty) {
+            store.eventsDirty = false;
+            if (!kit.pointer.attached && sceneWantsPointer(kit.scene.children)) {
+                const node = areaRef.current;
+                if (node?.window)
+                    kit.pointer.attach(node.window);
+            }
+        }
+        const current = store.getState();
+        const scene = kit.scene;
+        // `<color attach="background" />` wins over the clearColor prop. The
+        // surface already cleared to the prop before this ran, so only an
+        // explicit background costs a second clear.
+        const background = scene.background;
+        const composer = renderer.backend === 'direct'
+            ? scene.children.find((child) => child.isComposer)
+            : undefined;
+        const anyGl = gl;
+        const clearTo = (color) => {
+            const [r, g, b] = color ? color.toArray() : [0, 0, 0];
+            const a = color ? color._alpha : 1;
+            if (renderer.backend === 'direct') {
+                anyGl.clearColor?.(r, g, b, a);
+                anyGl.clear?.(anyGl.COLOR_BUFFER_BIT | anyGl.DEPTH_BUFFER_BIT);
+            }
+            else {
+                anyGl.ClearColor?.(r, g, b, a);
+                anyGl.Clear?.(anyGl.COLOR_BUFFER_BIT | anyGl.DEPTH_BUFFER_BIT);
+            }
+        };
+        // An <effectComposer> redirects the frame into a texture, and the
+        // redirect has to happen before the clear: the clear colour is the
+        // composed image's background, and `onDraw` output is part of what
+        // gets composed.
+        let composed = false;
+        if (composer && renderer.backend === 'direct') {
+            kit.post ??= new PostProcessor(renderer);
+            composed = kit.post.begin(gl, info, composer);
+            if (composed)
+                clearTo(background);
+        }
+        else if (background) {
+            clearTo(background);
+        }
+        renderer.render(gl, scene, current.camera, info);
+        onDrawRef.current?.(gl, info);
+        if (composed)
+            kit.post.end(gl, info);
+    }, 
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+    [kit]);
+    if (error && fallback !== undefined) {
+        return hx('box', { style }, typeof fallback === 'function' ? fallback(error) : fallback);
+    }
+    const loop = frameloop === 'always' || (frameloop === 'demand' && animating)
+        ? 'always'
+        : 'demand';
+    return hx('glarea', {
+        ref: areaRef,
+        style,
+        clearColor,
+        glx,
+        frameLoop: loop,
+        onCreated: handleCreated,
+        onDraw: handleDraw,
+        onError: handleError,
+    });
+}
+//# sourceMappingURL=canvas.js.map

package/dist/three/canvas.js.map

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

package/dist/three/events.d.ts

@@ -0,0 +1,64 @@
+import type { Mesh, Object3D, Scene } from './objects.js';
+import type { FrameCamera } from './renderer-indirect.js';
+/** What a pointer handler receives. */
+export interface ThreeEvent {
+    type: string;
+    /** The object whose handler is running (bubbling walks ancestors). */
+    target: Object3D | null;
+    /** The mesh the ray hit. */
+    object: Mesh | null;
+    point: [number, number, number] | null;
+    distance: number | null;
+    face: number | null;
+    uv: [number, number] | null;
+    x: number | undefined;
+    y: number | undefined;
+    nativeEvent: unknown;
+    stopPropagation(): void;
+    readonly propagationStopped: boolean;
+}
+interface NativeMouse {
+    x: number;
+    y: number;
+}
+/** The window seam this needs — what an ntk window provides. */
+export interface PointerSource {
+    on(name: string, handler: (event: NativeMouse) => void): unknown;
+    setCursor?(cursor: string | null): void;
+}
+/**
+ * One canvas's pointer pipeline. The canvas attaches it to the surface's
+ * child X window once anything in the scene listens; hover and press state
+ * live here so enter/leave pairs and click (down and up on the same object)
+ * come out right.
+ */
+export declare class ScenePointer {
+    private scene;
+    private cameraOf;
+    private onMissed;
+    private hovered;
+    private pressed;
+    private _cursor;
+    private source;
+    attached: boolean;
+    constructor(options: {
+        scene: Scene;
+        cameraOf: () => FrameCamera | null;
+        onPointerMissed?: (event: ThreeEvent) => void;
+    });
+    attach(source: PointerSource): void;
+    /** The nearest hit under the pointer, or null. */
+    private pick;
+    private makeEvent;
+    /** Call `on<Name>` along the bubble path until one stops propagation. */
+    private dispatch;
+    private onPointer;
+    /** enter/leave, diffed against the object hovered last time. */
+    private updateHover;
+    private applyCursor;
+    private onLeave;
+    /** A node left the tree: drop references to it. */
+    forget(node: object): void;
+}
+export {};
+//# sourceMappingURL=events.d.ts.map

package/dist/three/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../src/three/events.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AAG1D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAE1D,uCAAuC;AACvC,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,sEAAsE;IACtE,MAAM,EAAE,QAAQ,GAAG,IAAI,CAAC;IACxB,4BAA4B;IAC5B,MAAM,EAAE,IAAI,GAAG,IAAI,CAAC;IACpB,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAAC;IACvC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,EAAE,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAAC;IAC5B,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACtB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACtB,WAAW,EAAE,OAAO,CAAC;IACrB,eAAe,IAAI,IAAI,CAAC;IACxB,QAAQ,CAAC,kBAAkB,EAAE,OAAO,CAAC;CACtC;AAED,UAAU,WAAW;IACnB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AAED,gEAAgE;AAChE,MAAM,WAAW,aAAa;IAC5B,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,GAAG,OAAO,CAAC;IACjE,SAAS,CAAC,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAAC;CACzC;AAeD;;;;;GAKG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,KAAK,CAAQ;IACrB,OAAO,CAAC,QAAQ,CAA2B;IAC3C,OAAO,CAAC,QAAQ,CAA8B;IAC9C,OAAO,CAAC,OAAO,CAAyB;IACxC,OAAO,CAAC,OAAO,CAAyB;IACxC,OAAO,CAAC,OAAO,CAAuB;IACtC,OAAO,CAAC,MAAM,CAA8B;IAC5C,QAAQ,UAAS;IAEjB,YAAY,OAAO,EAAE;QACnB,KAAK,EAAE,KAAK,CAAC;QACb,QAAQ,EAAE,MAAM,WAAW,GAAG,IAAI,CAAC;QACnC,eAAe,CAAC,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,CAAC;KAC/C,EAIA;IAED,MAAM,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI,CAQlC;IAED,kDAAkD;IAClD,OAAO,CAAC,IAAI;IAOZ,OAAO,CAAC,SAAS;IA2BjB,yEAAyE;IACzE,OAAO,CAAC,QAAQ;IAqBhB,OAAO,CAAC,SAAS;IAqBjB,gEAAgE;IAChE,OAAO,CAAC,WAAW;IAUnB,OAAO,CAAC,WAAW;IASnB,OAAO,CAAC,OAAO;IAKf,mDAAmD;IACnD,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAGzB;CACF"}

package/dist/three/events.js

@@ -0,0 +1,146 @@
+import { raycast } from './raycast.js';
+/** The dispatch path: the object that was hit, then its ancestors. */
+function bubblePath(node, scene) {
+    const path = [];
+    for (let n = node; n && n !== scene; n = n.parent) {
+        path.push(n);
+    }
+    return path;
+}
+/**
+ * One canvas's pointer pipeline. The canvas attaches it to the surface's
+ * child X window once anything in the scene listens; hover and press state
+ * live here so enter/leave pairs and click (down and up on the same object)
+ * come out right.
+ */
+export class ScenePointer {
+    scene;
+    cameraOf;
+    onMissed;
+    hovered = null;
+    pressed = null;
+    _cursor = null;
+    source = null;
+    attached = false;
+    constructor(options) {
+        this.scene = options.scene;
+        this.cameraOf = options.cameraOf;
+        this.onMissed = (event) => options.onPointerMissed?.(event);
+    }
+    attach(source) {
+        if (this.attached || typeof source.on !== 'function')
+            return;
+        this.attached = true;
+        this.source = source;
+        source.on('mousedown', (ev) => this.onPointer('pointerdown', ev));
+        source.on('mouseup', (ev) => this.onPointer('pointerup', ev));
+        source.on('mousemove', (ev) => this.onPointer('pointermove', ev));
+        source.on('mouseout', () => this.onLeave());
+    }
+    /** The nearest hit under the pointer, or null. */
+    pick(ev) {
+        const camera = this.cameraOf();
+        if (!camera)
+            return null;
+        const [hit] = raycast(this.scene.children, ev.x, ev.y, camera);
+        return hit ?? null;
+    }
+    makeEvent(type, hit, native, target) {
+        let stopped = false;
+        return {
+            type,
+            target,
+            object: hit?.object ?? null,
+            point: hit?.point ?? null,
+            distance: hit?.distance ?? null,
+            face: hit?.face ?? null,
+            uv: hit?.uv ?? null,
+            x: native?.x,
+            y: native?.y,
+            nativeEvent: native,
+            stopPropagation() {
+                stopped = true;
+            },
+            get propagationStopped() {
+                return stopped;
+            },
+        };
+    }
+    /** Call `on<Name>` along the bubble path until one stops propagation. */
+    dispatch(name, hit, native, node = hit?.object ?? null) {
+        if (!node)
+            return;
+        const prop = `on${name[0].toUpperCase()}${name.slice(1)}`;
+        let event = null;
+        for (const target of bubblePath(node, this.scene)) {
+            const handler = target.__handlers?.[prop];
+            if (typeof handler !== 'function')
+                continue;
+            event = event ?? this.makeEvent(name.toLowerCase(), hit, native, target);
+            event.target = target;
+            handler(event);
+            if (event.propagationStopped)
+                break;
+        }
+    }
+    onPointer(type, native) {
+        const hit = this.pick(native);
+        if (type === 'pointermove') {
+            this.updateHover(hit, native);
+            if (hit)
+                this.dispatch('pointerMove', hit, native);
+            return;
+        }
+        if (type === 'pointerdown') {
+            this.pressed = hit?.object ?? null;
+            if (hit)
+                this.dispatch('pointerDown', hit, native);
+            else
+                this.onMissed(this.makeEvent('pointermissed', null, native, null));
+            return;
+        }
+        // pointerup: a click is down and up on the same object
+        if (hit)
+            this.dispatch('pointerUp', hit, native);
+        if (hit && this.pressed === hit.object) {
+            this.dispatch('click', hit, native);
+        }
+        this.pressed = null;
+    }
+    /** enter/leave, diffed against the object hovered last time. */
+    updateHover(hit, native) {
+        const next = hit?.object ?? null;
+        if (next === this.hovered)
+            return;
+        const previous = this.hovered;
+        this.hovered = next;
+        if (previous)
+            this.dispatch('pointerOut', null, native, previous);
+        if (next)
+            this.dispatch('pointerOver', hit, native);
+        this.applyCursor(next);
+    }
+    applyCursor(node) {
+        const source = this.source;
+        if (typeof source?.setCursor !== 'function')
+            return;
+        const cursor = node?.cursor ?? null;
+        if (cursor === this._cursor)
+            return;
+        this._cursor = cursor;
+        source.setCursor(cursor);
+    }
+    onLeave() {
+        if (!this.hovered)
+            return;
+        this.updateHover(null, null);
+    }
+    /** A node left the tree: drop references to it. */
+    forget(node) {
+        if (this.hovered === node)
+            this.hovered = null;
+        if (this.pressed === node)
+            this.pressed = null;
+    }
+}
+//# sourceMappingURL=events.js.map

package/dist/three/events.js.map

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

package/dist/three/geometries.d.ts

@@ -0,0 +1,89 @@
+export interface GeometryData {
+    positions: number[];
+    normals: number[];
+    uvs: number[];
+    index: number[] | null;
+}
+export interface BufferGeometryAttributes {
+    position?: ArrayLike<number>;
+    /** Derived from the triangles when omitted. */
+    normal?: ArrayLike<number>;
+    uv?: ArrayLike<number>;
+    index?: ArrayLike<number>;
+}
+/**
+ * The base every geometry is: cached arrays, a version, and `setArgs` for
+ * the reconciler.
+ *
+ * `<bufferGeometry position={…} normal={…} uv={…} index={…} />` is this
+ * class used directly — explicit attributes as flat arrays, which is the
+ * declarative face of three.js's `setAttribute`. `data({ normals: false })`
+ * is what a point cloud or a line asks for: nothing shades them, and
+ * deriving face normals for a hundred thousand loose vertices is a pass and
+ * a megabyte spent on data no shader will read.
+ */
+export declare class BufferGeometry {
+    readonly isGeometry = true;
+    readonly isBufferGeometry: boolean;
+    /** Bumped whenever the shape changes; GPU caches key on it. */
+    version: number;
+    args: readonly unknown[];
+    /** @internal */
+    _attributes: BufferGeometryAttributes;
+    /** @internal */
+    _built: Map<'shaded' | 'flat', GeometryData> | null;
+    /** @internal notified on any change so a demand-mode surface redraws */
+    __dirty: (() => void) | null;
+    constructor(attributes?: BufferGeometryAttributes);
+    /** Replace the constructor arguments — how an `args` prop change lands. */
+    setArgs(args: readonly unknown[]): void;
+    setAttribute(name: keyof BufferGeometryAttributes, array: ArrayLike<number>): void;
+    getAttribute(name: keyof BufferGeometryAttributes): ArrayLike<number> | undefined;
+    /** A new shape: drop the cached arrays; the renderers drop theirs. */
+    invalidate(): void;
+    /** `{ positions, normals, uvs, index }` — memoized per version. */
+    data({ normals }?: {
+        normals?: boolean;
+    }): GeometryData;
+    build({ normals }: {
+        normals: boolean;
+    }): GeometryData;
+}
+/** `[width, height, depth, widthSeg, heightSeg, depthSeg]` */
+export declare class BoxGeometry extends BufferGeometry {
+    readonly isBoxGeometry = true;
+    constructor(...args: (number | undefined)[]);
+    build(): GeometryData;
+}
+/** `[width, height, widthSeg, heightSeg]` */
+export declare class PlaneGeometry extends BufferGeometry {
+    readonly isPlaneGeometry = true;
+    constructor(...args: (number | undefined)[]);
+    build(): GeometryData;
+}
+/** `[radius, widthSeg, heightSeg]` */
+export declare class SphereGeometry extends BufferGeometry {
+    readonly isSphereGeometry = true;
+    constructor(...args: (number | undefined)[]);
+    build(): GeometryData;
+}
+/** `[radiusTop, radiusBottom, height, radialSeg, heightSeg, openEnded]` */
+export declare class CylinderGeometry extends BufferGeometry {
+    readonly isCylinderGeometry = true;
+    constructor(...args: (number | boolean | undefined)[]);
+    build(): GeometryData;
+}
+/** `[radius, height, radialSeg, heightSeg, openEnded]` — a cylinder whose
+ * top radius is zero, exactly as in three.js. */
+export declare class ConeGeometry extends BufferGeometry {
+    readonly isConeGeometry = true;
+    constructor(...args: (number | boolean | undefined)[]);
+    build(): GeometryData;
+}
+/** `[radius, tube, radialSeg, tubularSeg]` */
+export declare class TorusGeometry extends BufferGeometry {
+    readonly isTorusGeometry = true;
+    constructor(...args: (number | undefined)[]);
+    build(): GeometryData;
+}
+//# sourceMappingURL=geometries.d.ts.map

package/dist/three/geometries.d.ts.map

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