quilt-three 0.10.0 → 0.11.0

package/README.md

@@ -1,6 +1,6 @@
 # quilt-three
 
-Shared-scene Three.js viewports for Quilt, with optional React Three Fiber bindings.
+Shared-scene Three.js viewports for Quilt, with React Three Fiber bindings available separately in `quilt-three-react`.
 The main workspace shares one canvas and renderer. Each same-origin companion document
 has its own renderer. Geometry, authored materials, and camera poses remain
 application-owned; moving a pane does not delete scene data.
@@ -8,20 +8,21 @@ application-owned; moving a pane does not delete scene data.
 ## Install
 
 ```sh
-npm install quilt-three three
-npm install --save-dev @types/three
+npm install quilt-three
 ```
 
-The compatibility target is Three.js r186. For React:
+With modern npm's default peer resolution, this installs the Quilt renderer,
+Three.js r186, and its TypeScript declarations automatically. React and R3F are
+not installed. For React applications instead use:
 
 ```sh
-npm install quilt-react react@^19 react-dom@^19 @react-three/fiber@^9.8.1
+npm install quilt-three-react
 ```
 
-`quilt-three` does not import or install React or R3F. The `/react` entry requires
-React 19 and R3F 9.8.1 or newer within major 9. The optional React peer range also
-allows React 18 applications to use the **imperative base entry** without adopting
-R3F. Existing `quilt-react` React 18 support is unchanged.
+That package installs the shared integration, Quilt React bindings, React 19,
+React DOM 19, R3F 9, and the required declarations. Compatible existing peers
+are reused; incompatible versions must be upgraded. Existing `quilt-react`
+React 18 support is unchanged.
 
 ## Vanilla
 
@@ -141,7 +142,7 @@ Disposal is idempotent and releases only helper-owned graphics. Session disposal
 disposes attached helpers, without disposing application scene assets.
 
 In React, place `<CameraHelpers visible={showCameras} ray="pointer" />` from
-`quilt-three/react` inside `ThreeSessionProvider`, alongside `SharedScene` and the workspace.
+`quilt-three-react` inside `ThreeSessionProvider`, alongside `SharedScene` and the workspace.
 `visible` updates reactively; other helper options are mount-only. Unmounting cleans up
 the helper instance, including React Strict Mode effect replays.
 
@@ -150,7 +151,7 @@ the helper instance, including React Strict Mode effect replays.
 ```tsx
 import { Workspace } from 'quilt-react';
 import type { PaneProps } from 'quilt-react';
-import { SharedScene, ThreeSessionProvider, ThreeView } from 'quilt-three/react';
+import { SharedScene, ThreeSessionProvider, ThreeView } from 'quilt-three-react';
 
 // `camera` and `initialLayout` are application-owned, as in the vanilla example.
 function ScenePane(props: PaneProps) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "quilt-three",
-  "version": "0.10.0",
+  "version": "0.11.0",
   "description": "Shared-scene Three.js viewports for Quilt",
   "type": "module",
   "license": "MIT",
@@ -15,10 +15,6 @@
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js"
     },
-    "./react": {
-      "types": "./dist/react.d.ts",
-      "import": "./dist/react.js"
-    },
     "./webgpu": {
       "types": "./dist/webgpu.d.ts",
       "import": "./dist/webgpu.js"
@@ -29,28 +25,11 @@
     "prepack": "node ../../scripts/build-package.mjs three --dependencies"
   },
   "dependencies": {
-    "quilt-vanilla": "0.10.0"
+    "quilt-vanilla": "0.11.0",
+    "@types/three": "^0.186.0"
   },
   "peerDependencies": {
-    "three": "^0.186.0",
-    "@react-three/fiber": "^9.8.1",
-    "react": "^18.3.0 || ^19.0.0",
-    "react-dom": "^18.3.0 || ^19.0.0",
-    "quilt-react": "0.10.0"
-  },
-  "peerDependenciesMeta": {
-    "@react-three/fiber": {
-      "optional": true
-    },
-    "react": {
-      "optional": true
-    },
-    "react-dom": {
-      "optional": true
-    },
-    "quilt-react": {
-      "optional": true
-    }
+    "three": "^0.186.0"
   },
   "sideEffects": false,
   "publishConfig": {

package/dist/react.d.ts

@@ -1,28 +0,0 @@
-import type { ReactNode } from 'react';
-import type { PaneProps } from 'quilt-react';
-import { ThreeSession } from './index.js';
-import type { CameraHelpersOptions, SessionOptions, ViewOptions } from './index.js';
-export declare function useThreeSession(): ThreeSession;
-export interface ThreeSessionProviderProps {
-    children: ReactNode;
-    options?: Omit<SessionOptions, 'scene' | 'window' | 'requestFrame'>;
-    onReady?: (session: ThreeSession) => void;
-}
-/** Owns one persistent R3F scene tree; place outside the Quilt Workspace. Options are mount-only. */
-export declare function ThreeSessionProvider({ children, options, onReady }: ThreeSessionProviderProps): import("react").JSX.Element | null;
-/** Declare scene content exactly once, outside individual pane components. */
-export declare function SharedScene({ children }: {
-    children: ReactNode;
-}): null;
-export interface ThreeViewProps extends ViewOptions {
-    paneContext: PaneProps;
-    children?: ReactNode;
-}
-/** The children here are HTML overlays. Shared Three.js JSX belongs in SharedScene. */
-export declare function ThreeView({ paneContext, children, ...options }: ThreeViewProps): import("react").JSX.Element;
-export type { ThreeElements, ThreeEvent } from '@react-three/fiber';
-/** Mount inside ThreeSessionProvider, alongside SharedScene (not inside its R3F tree).
- * Visibility is reactive; other options are mount-only.
- */
-export declare function CameraHelpers({ visible, ...options }: CameraHelpersOptions): null;
-//# sourceMappingURL=react.d.ts.map

package/dist/react.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"react.d.ts","sourceRoot":"","sources":["../src/react.tsx"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAIvC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EACL,YAAY,EAGb,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,oBAAoB,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAkBpF,wBAAgB,eAAe,IAAI,YAAY,CAE9C;AAsBD,MAAM,WAAW,yBAAyB;IACxC,QAAQ,EAAE,SAAS,CAAC;IACpB,OAAO,CAAC,EAAE,IAAI,CAAC,cAAc,EAAE,OAAO,GAAG,QAAQ,GAAG,cAAc,CAAC,CAAC;IACpE,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,YAAY,KAAK,IAAI,CAAC;CAC3C;AACD,qGAAqG;AACrG,wBAAgB,oBAAoB,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,yBAAyB,sCA8J7F;AACD,8EAA8E;AAC9E,wBAAgB,WAAW,CAAC,EAAE,QAAQ,EAAE,EAAE;IAAE,QAAQ,EAAE,SAAS,CAAA;CAAE,QAOhE;AACD,MAAM,WAAW,cAAe,SAAQ,WAAW;IACjD,WAAW,EAAE,SAAS,CAAC;IACvB,QAAQ,CAAC,EAAE,SAAS,CAAC;CACtB;AACD,uFAAuF;AACvF,wBAAgB,SAAS,CAAC,EAAE,WAAW,EAAE,QAAQ,EAAE,GAAG,OAAO,EAAE,EAAE,cAAc,+BAiC9E;AAGD,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAEpE;;GAEG;AACH,wBAAgB,aAAa,CAAC,EAAE,OAAc,EAAE,GAAG,OAAO,EAAE,EAAE,oBAAoB,QAgBjF"}

package/dist/react.js

@@ -1,247 +0,0 @@
-import { jsx as _jsx } from "react/jsx-runtime";
-import { Component, createContext, useContext, useEffect, useLayoutEffect, useRef, useState, } from 'react';
-import { createRoot, events, extend, useFrame } from '@react-three/fiber';
-import * as THREE from 'three';
-import { ThreeSession, isWebGPURenderer, CameraHelpers as CameraHelpersController, } from './index.js';
-const Context = createContext(null);
-function useBridge() {
-    const bridge = useContext(Context);
-    if (!bridge)
-        throw new Error('Three components require ThreeSessionProvider');
-    return bridge;
-}
-export function useThreeSession() {
-    return useBridge().session;
-}
-class SceneBoundary extends Component {
-    state = { failed: false };
-    static getDerivedStateFromError() {
-        return { failed: true };
-    }
-    componentDidCatch(error) {
-        this.props.fail(error);
-    }
-    render() {
-        return this.state.failed ? null : this.props.children;
-    }
-}
-function FrameOwner({ ready, children }) {
-    // Positive priority delegates drawing to the shared session, while useFrame still runs once.
-    useFrame(() => { }, 1);
-    useLayoutEffect(ready, [ready]);
-    return children;
-}
-/** Owns one persistent R3F scene tree; place outside the Quilt Workspace. Options are mount-only. */
-export function ThreeSessionProvider({ children, options, onReady }) {
-    const [bridge, setBridge] = useState(null);
-    const initial = useRef({ options, onReady });
-    useEffect(() => {
-        extend(Object.fromEntries(Object.entries(THREE).filter(([, value]) => typeof value === 'function')));
-        const win = window;
-        let root;
-        let store;
-        let content = null;
-        let frameWindow = win;
-        let animation = 0, disposed = false, elapsed = 0, previous;
-        let resolve, reject;
-        const ready = new Promise((yes, no) => {
-            resolve = yes;
-            reject = no;
-        });
-        void ready.catch(() => { });
-        const committed = () => {
-            resolve();
-            session.invalidate();
-        };
-        const failed = (error) => {
-            reject(error);
-            initial.current.options?.onError?.(error);
-        };
-        const sceneTree = () => (_jsx(SceneBoundary, { fail: failed, children: _jsx(FrameOwner, { ready: committed, children: content }) }));
-        const drawScene = () => {
-            root?.render(sceneTree());
-        };
-        const session = new ThreeSession({
-            ...initial.current.options,
-            scene: new THREE.Scene(),
-            window: win,
-            requestFrame(owner) {
-                if (disposed)
-                    return;
-                if (animation && frameWindow !== owner) {
-                    frameWindow.cancelAnimationFrame(animation);
-                    animation = 0;
-                }
-                if (animation)
-                    return;
-                frameWindow = owner;
-                animation = owner.requestAnimationFrame(() => {
-                    const time = win.performance.now();
-                    animation = 0;
-                    if (previous !== undefined)
-                        elapsed += Math.min((time - previous) / 1000, 0.1);
-                    previous = time;
-                    try {
-                        store?.getState().advance(elapsed, true);
-                        session.render(time);
-                    }
-                    catch (error) {
-                        failed(error);
-                    }
-                });
-            },
-            createRenderer(canvas) {
-                const created = initial.current.options?.createRenderer?.(canvas) ??
-                    new THREE.WebGLRenderer({ canvas, alpha: true, antialias: true });
-                const connect = (renderer) => {
-                    if (!disposed && canvas.ownerDocument === win.document) {
-                        root = createRoot(canvas);
-                        const currentRoot = root;
-                        const initialized = isWebGPURenderer(renderer) ? renderer.init() : Promise.resolve();
-                        void initialized
-                            .then(() => {
-                            if (disposed)
-                                return;
-                            return currentRoot.configure({
-                                gl: renderer,
-                                scene: session.scene,
-                                frameloop: 'never',
-                                events,
-                                size: { width: 1, height: 1, top: 0, left: 0 },
-                                onCreated(state) {
-                                    state.set({ invalidate: session.invalidate });
-                                },
-                            });
-                        })
-                            .then(() => {
-                            if (disposed)
-                                return;
-                            store = root.render(sceneTree());
-                            // Events are forwarded from pane elements, including companion documents.
-                            store.getState().events.disconnect?.();
-                            store.getState().setEvents({
-                                enabled: true,
-                                compute(event, state) {
-                                    const element = event.currentTarget;
-                                    const rect = element.getBoundingClientRect();
-                                    state.pointer.set(((event.clientX - rect.left) / rect.width) * 2 - 1, (-(event.clientY - rect.top) / rect.height) * 2 + 1);
-                                    state.raycaster.layers.mask = state.camera.layers.mask;
-                                    state.raycaster.setFromCamera(state.pointer, state.camera);
-                                },
-                            });
-                        })
-                            .catch(failed);
-                    }
-                    return renderer;
-                };
-                return 'then' in created ? Promise.resolve(created).then(connect) : connect(created);
-            },
-        });
-        const names = {
-            click: 'onClick',
-            dblclick: 'onDoubleClick',
-            contextmenu: 'onContextMenu',
-            wheel: 'onWheel',
-            pointerdown: 'onPointerDown',
-            pointerup: 'onPointerUp',
-            pointermove: 'onPointerMove',
-            pointerleave: 'onPointerLeave',
-            pointercancel: 'onPointerCancel',
-            lostpointercapture: 'onLostPointerCapture',
-        };
-        const value = {
-            session,
-            ready,
-            setScene(next) {
-                content = next;
-                drawScene();
-                session.invalidate();
-            },
-            pointer(_element, camera, event) {
-                if (!store)
-                    return;
-                const state = store.getState();
-                const original = state.camera;
-                state.set({ camera: camera });
-                try {
-                    const name = names[event.type];
-                    if (name)
-                        state.events.handlers?.[name]?.(event);
-                }
-                finally {
-                    state.set({ camera: original });
-                }
-            },
-        };
-        setBridge(value);
-        initial.current.onReady?.(session);
-        return () => {
-            disposed = true;
-            if (animation)
-                frameWindow.cancelAnimationFrame(animation);
-            reject(new Error('Three session disposed before scene readiness'));
-            root?.unmount();
-            session.dispose();
-        };
-    }, []);
-    return bridge ? _jsx(Context.Provider, { value: bridge, children: children }) : null;
-}
-/** Declare scene content exactly once, outside individual pane components. */
-export function SharedScene({ children }) {
-    const bridge = useBridge();
-    useLayoutEffect(() => {
-        bridge.setScene(children);
-    }, [bridge, children]);
-    useLayoutEffect(() => () => bridge.setScene(null), [bridge]);
-    return null;
-}
-/** The children here are HTML overlays. Shared Three.js JSX belongs in SharedScene. */
-export function ThreeView({ paneContext, children, ...options }) {
-    const bridge = useBridge();
-    const element = useRef(null);
-    const current = useRef(options);
-    current.current = options;
-    useLayoutEffect(() => {
-        if (!element.current)
-            return;
-        const host = element.current;
-        const view = bridge.session.register({ ...paneContext, element: host }, {
-            ...current.current,
-            onPointer(event, hits, camera) {
-                bridge.pointer(host, camera, event);
-                current.current.onPointer?.(event, hits, camera);
-            },
-        });
-        paneContext.deferReady(bridge.ready);
-        return () => view.dispose();
-    }, [
-        bridge,
-        paneContext.pane.id,
-        paneContext.document,
-        options.camera,
-        options.controls,
-        options.pipeline,
-    ]);
-    return (_jsx("div", { ref: element, style: { width: '100%', height: '100%', position: 'relative' }, children: children }));
-}
-/** Mount inside ThreeSessionProvider, alongside SharedScene (not inside its R3F tree).
- * Visibility is reactive; other options are mount-only.
- */
-export function CameraHelpers({ visible = true, ...options }) {
-    const session = useThreeSession();
-    const initial = useRef(options);
-    const instance = useRef(null);
-    useEffect(() => {
-        const helpers = new CameraHelpersController(session, { ...initial.current, visible });
-        instance.current = helpers;
-        return () => {
-            helpers.dispose();
-            instance.current = null;
-        };
-    }, [session]);
-    useEffect(() => {
-        instance.current?.setVisible(visible);
-    }, [visible]);
-    return null;
-}
-//# sourceMappingURL=react.js.map

package/dist/react.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"react.js","sourceRoot":"","sources":["../src/react.tsx"],"names":[],"mappings":"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","sourcesContent":["import {\n  Component,\n  createContext,\n  useContext,\n  useEffect,\n  useLayoutEffect,\n  useRef,\n  useState,\n} from 'react';\nimport type { ReactNode } from 'react';\nimport { createRoot, events, extend, useFrame } from '@react-three/fiber';\nimport type { RootStore, ReconcilerRoot, Events } from '@react-three/fiber';\nimport * as THREE from 'three';\nimport type { PaneProps } from 'quilt-react';\nimport {\n  ThreeSession,\n  isWebGPURenderer,\n  CameraHelpers as CameraHelpersController,\n} from './index.js';\nimport type { CameraHelpersOptions, SessionOptions, ViewOptions } from './index.js';\n\ninterface Bridge {\n  session: ThreeSession;\n  ready: Promise<void>;\n  setScene(children: ReactNode): void;\n  pointer(\n    element: HTMLElement,\n    camera: THREE.Camera,\n    event: PointerEvent | MouseEvent | WheelEvent,\n  ): void;\n}\nconst Context = createContext<Bridge | null>(null);\nfunction useBridge() {\n  const bridge = useContext(Context);\n  if (!bridge) throw new Error('Three components require ThreeSessionProvider');\n  return bridge;\n}\nexport function useThreeSession(): ThreeSession {\n  return useBridge().session;\n}\nclass SceneBoundary extends Component<\n  { children: ReactNode; fail(error: unknown): void },\n  { failed: boolean }\n> {\n  override state = { failed: false };\n  static getDerivedStateFromError() {\n    return { failed: true };\n  }\n  override componentDidCatch(error: unknown) {\n    this.props.fail(error);\n  }\n  override render() {\n    return this.state.failed ? null : this.props.children;\n  }\n}\nfunction FrameOwner({ ready, children }: { ready(): void; children: ReactNode }) {\n  // Positive priority delegates drawing to the shared session, while useFrame still runs once.\n  useFrame(() => {}, 1);\n  useLayoutEffect(ready, [ready]);\n  return children;\n}\nexport interface ThreeSessionProviderProps {\n  children: ReactNode;\n  options?: Omit<SessionOptions, 'scene' | 'window' | 'requestFrame'>;\n  onReady?: (session: ThreeSession) => void;\n}\n/** Owns one persistent R3F scene tree; place outside the Quilt Workspace. Options are mount-only. */\nexport function ThreeSessionProvider({ children, options, onReady }: ThreeSessionProviderProps) {\n  const [bridge, setBridge] = useState<Bridge | null>(null);\n  const initial = useRef({ options, onReady });\n  useEffect(() => {\n    extend(\n      Object.fromEntries(\n        Object.entries(THREE).filter(([, value]) => typeof value === 'function'),\n      ) as Parameters<typeof extend>[0],\n    );\n    const win = window;\n    let root: ReconcilerRoot<HTMLCanvasElement> | undefined;\n    let store: RootStore | undefined;\n    let content: ReactNode = null;\n    let frameWindow: Window = win;\n    let animation = 0,\n      disposed = false,\n      elapsed = 0,\n      previous: number | undefined;\n    let resolve!: () => void, reject!: (error: unknown) => void;\n    const ready = new Promise<void>((yes, no) => {\n      resolve = yes;\n      reject = no;\n    });\n    void ready.catch(() => {});\n    const committed = () => {\n      resolve();\n      session.invalidate();\n    };\n    const failed = (error: unknown) => {\n      reject(error);\n      initial.current.options?.onError?.(error);\n    };\n    const sceneTree = () => (\n      <SceneBoundary fail={failed}>\n        <FrameOwner ready={committed}>{content}</FrameOwner>\n      </SceneBoundary>\n    );\n    const drawScene = () => {\n      root?.render(sceneTree());\n    };\n    const session = new ThreeSession({\n      ...initial.current.options,\n      scene: new THREE.Scene(),\n      window: win,\n      requestFrame(owner) {\n        if (disposed) return;\n        if (animation && frameWindow !== owner) {\n          frameWindow.cancelAnimationFrame(animation);\n          animation = 0;\n        }\n        if (animation) return;\n        frameWindow = owner;\n        animation = owner.requestAnimationFrame(() => {\n          const time = win.performance.now();\n          animation = 0;\n          if (previous !== undefined) elapsed += Math.min((time - previous) / 1000, 0.1);\n          previous = time;\n          try {\n            store?.getState().advance(elapsed, true);\n            session.render(time);\n          } catch (error) {\n            failed(error);\n          }\n        });\n      },\n      createRenderer(canvas) {\n        const created =\n          initial.current.options?.createRenderer?.(canvas) ??\n          new THREE.WebGLRenderer({ canvas, alpha: true, antialias: true });\n        const connect = (renderer: import('./index.js').ThreeRenderer) => {\n          if (!disposed && canvas.ownerDocument === win.document) {\n            root = createRoot(canvas);\n            const currentRoot = root;\n            const initialized = isWebGPURenderer(renderer) ? renderer.init() : Promise.resolve();\n            void initialized\n              .then(() => {\n                if (disposed) return;\n                return currentRoot.configure({\n                  gl: renderer,\n                  scene: session.scene,\n                  frameloop: 'never',\n                  events,\n                  size: { width: 1, height: 1, top: 0, left: 0 },\n                  onCreated(state) {\n                    state.set({ invalidate: session.invalidate });\n                  },\n                });\n              })\n              .then(() => {\n                if (disposed) return;\n                store = root!.render(sceneTree());\n                // Events are forwarded from pane elements, including companion documents.\n                store.getState().events.disconnect?.();\n                store.getState().setEvents({\n                  enabled: true,\n                  compute(event, state) {\n                    const element = event.currentTarget as HTMLElement;\n                    const rect = element.getBoundingClientRect();\n                    state.pointer.set(\n                      ((event.clientX - rect.left) / rect.width) * 2 - 1,\n                      (-(event.clientY - rect.top) / rect.height) * 2 + 1,\n                    );\n                    state.raycaster.layers.mask = state.camera.layers.mask;\n                    state.raycaster.setFromCamera(state.pointer, state.camera);\n                  },\n                });\n              })\n              .catch(failed);\n          }\n          return renderer;\n        };\n        return 'then' in created ? Promise.resolve(created).then(connect) : connect(created);\n      },\n    });\n    const names: Record<string, keyof Events> = {\n      click: 'onClick',\n      dblclick: 'onDoubleClick',\n      contextmenu: 'onContextMenu',\n      wheel: 'onWheel',\n      pointerdown: 'onPointerDown',\n      pointerup: 'onPointerUp',\n      pointermove: 'onPointerMove',\n      pointerleave: 'onPointerLeave',\n      pointercancel: 'onPointerCancel',\n      lostpointercapture: 'onLostPointerCapture',\n    };\n    const value: Bridge = {\n      session,\n      ready,\n      setScene(next) {\n        content = next;\n        drawScene();\n        session.invalidate();\n      },\n      pointer(_element, camera, event) {\n        if (!store) return;\n        const state = store.getState();\n        const original = state.camera;\n        state.set({ camera: camera as THREE.PerspectiveCamera });\n        try {\n          const name = names[event.type];\n          if (name) state.events.handlers?.[name]?.(event);\n        } finally {\n          state.set({ camera: original });\n        }\n      },\n    };\n    setBridge(value);\n    initial.current.onReady?.(session);\n    return () => {\n      disposed = true;\n      if (animation) frameWindow.cancelAnimationFrame(animation);\n      reject(new Error('Three session disposed before scene readiness'));\n      root?.unmount();\n      session.dispose();\n    };\n  }, []);\n  return bridge ? <Context.Provider value={bridge}>{children}</Context.Provider> : null;\n}\n/** Declare scene content exactly once, outside individual pane components. */\nexport function SharedScene({ children }: { children: ReactNode }) {\n  const bridge = useBridge();\n  useLayoutEffect(() => {\n    bridge.setScene(children);\n  }, [bridge, children]);\n  useLayoutEffect(() => () => bridge.setScene(null), [bridge]);\n  return null;\n}\nexport interface ThreeViewProps extends ViewOptions {\n  paneContext: PaneProps;\n  children?: ReactNode;\n}\n/** The children here are HTML overlays. Shared Three.js JSX belongs in SharedScene. */\nexport function ThreeView({ paneContext, children, ...options }: ThreeViewProps) {\n  const bridge = useBridge();\n  const element = useRef<HTMLDivElement>(null);\n  const current = useRef(options);\n  current.current = options;\n  useLayoutEffect(() => {\n    if (!element.current) return;\n    const host = element.current;\n    const view = bridge.session.register(\n      { ...paneContext, element: host },\n      {\n        ...current.current,\n        onPointer(event, hits, camera) {\n          bridge.pointer(host, camera, event);\n          current.current.onPointer?.(event, hits, camera);\n        },\n      },\n    );\n    paneContext.deferReady(bridge.ready);\n    return () => view.dispose();\n  }, [\n    bridge,\n    paneContext.pane.id,\n    paneContext.document,\n    options.camera,\n    options.controls,\n    options.pipeline,\n  ]);\n  return (\n    <div ref={element} style={{ width: '100%', height: '100%', position: 'relative' }}>\n      {children}\n    </div>\n  );\n}\n\n// Preserve R3F JSX augmentation for consumers importing only quilt-three/react.\nexport type { ThreeElements, ThreeEvent } from '@react-three/fiber';\n\n/** Mount inside ThreeSessionProvider, alongside SharedScene (not inside its R3F tree).\n * Visibility is reactive; other options are mount-only.\n */\nexport function CameraHelpers({ visible = true, ...options }: CameraHelpersOptions) {\n  const session = useThreeSession();\n  const initial = useRef(options);\n  const instance = useRef<CameraHelpersController | null>(null);\n  useEffect(() => {\n    const helpers = new CameraHelpersController(session, { ...initial.current, visible });\n    instance.current = helpers;\n    return () => {\n      helpers.dispose();\n      instance.current = null;\n    };\n  }, [session]);\n  useEffect(() => {\n    instance.current?.setVisible(visible);\n  }, [visible]);\n  return null;\n}\n"]}

package/src/react.tsx

@@ -1,298 +0,0 @@
-import {
-  Component,
-  createContext,
-  useContext,
-  useEffect,
-  useLayoutEffect,
-  useRef,
-  useState,
-} from 'react';
-import type { ReactNode } from 'react';
-import { createRoot, events, extend, useFrame } from '@react-three/fiber';
-import type { RootStore, ReconcilerRoot, Events } from '@react-three/fiber';
-import * as THREE from 'three';
-import type { PaneProps } from 'quilt-react';
-import {
-  ThreeSession,
-  isWebGPURenderer,
-  CameraHelpers as CameraHelpersController,
-} from './index.js';
-import type { CameraHelpersOptions, SessionOptions, ViewOptions } from './index.js';
-
-interface Bridge {
-  session: ThreeSession;
-  ready: Promise<void>;
-  setScene(children: ReactNode): void;
-  pointer(
-    element: HTMLElement,
-    camera: THREE.Camera,
-    event: PointerEvent | MouseEvent | WheelEvent,
-  ): void;
-}
-const Context = createContext<Bridge | null>(null);
-function useBridge() {
-  const bridge = useContext(Context);
-  if (!bridge) throw new Error('Three components require ThreeSessionProvider');
-  return bridge;
-}
-export function useThreeSession(): ThreeSession {
-  return useBridge().session;
-}
-class SceneBoundary extends Component<
-  { children: ReactNode; fail(error: unknown): void },
-  { failed: boolean }
-> {
-  override state = { failed: false };
-  static getDerivedStateFromError() {
-    return { failed: true };
-  }
-  override componentDidCatch(error: unknown) {
-    this.props.fail(error);
-  }
-  override render() {
-    return this.state.failed ? null : this.props.children;
-  }
-}
-function FrameOwner({ ready, children }: { ready(): void; children: ReactNode }) {
-  // Positive priority delegates drawing to the shared session, while useFrame still runs once.
-  useFrame(() => {}, 1);
-  useLayoutEffect(ready, [ready]);
-  return children;
-}
-export interface ThreeSessionProviderProps {
-  children: ReactNode;
-  options?: Omit<SessionOptions, 'scene' | 'window' | 'requestFrame'>;
-  onReady?: (session: ThreeSession) => void;
-}
-/** Owns one persistent R3F scene tree; place outside the Quilt Workspace. Options are mount-only. */
-export function ThreeSessionProvider({ children, options, onReady }: ThreeSessionProviderProps) {
-  const [bridge, setBridge] = useState<Bridge | null>(null);
-  const initial = useRef({ options, onReady });
-  useEffect(() => {
-    extend(
-      Object.fromEntries(
-        Object.entries(THREE).filter(([, value]) => typeof value === 'function'),
-      ) as Parameters<typeof extend>[0],
-    );
-    const win = window;
-    let root: ReconcilerRoot<HTMLCanvasElement> | undefined;
-    let store: RootStore | undefined;
-    let content: ReactNode = null;
-    let frameWindow: Window = win;
-    let animation = 0,
-      disposed = false,
-      elapsed = 0,
-      previous: number | undefined;
-    let resolve!: () => void, reject!: (error: unknown) => void;
-    const ready = new Promise<void>((yes, no) => {
-      resolve = yes;
-      reject = no;
-    });
-    void ready.catch(() => {});
-    const committed = () => {
-      resolve();
-      session.invalidate();
-    };
-    const failed = (error: unknown) => {
-      reject(error);
-      initial.current.options?.onError?.(error);
-    };
-    const sceneTree = () => (
-      <SceneBoundary fail={failed}>
-        <FrameOwner ready={committed}>{content}</FrameOwner>
-      </SceneBoundary>
-    );
-    const drawScene = () => {
-      root?.render(sceneTree());
-    };
-    const session = new ThreeSession({
-      ...initial.current.options,
-      scene: new THREE.Scene(),
-      window: win,
-      requestFrame(owner) {
-        if (disposed) return;
-        if (animation && frameWindow !== owner) {
-          frameWindow.cancelAnimationFrame(animation);
-          animation = 0;
-        }
-        if (animation) return;
-        frameWindow = owner;
-        animation = owner.requestAnimationFrame(() => {
-          const time = win.performance.now();
-          animation = 0;
-          if (previous !== undefined) elapsed += Math.min((time - previous) / 1000, 0.1);
-          previous = time;
-          try {
-            store?.getState().advance(elapsed, true);
-            session.render(time);
-          } catch (error) {
-            failed(error);
-          }
-        });
-      },
-      createRenderer(canvas) {
-        const created =
-          initial.current.options?.createRenderer?.(canvas) ??
-          new THREE.WebGLRenderer({ canvas, alpha: true, antialias: true });
-        const connect = (renderer: import('./index.js').ThreeRenderer) => {
-          if (!disposed && canvas.ownerDocument === win.document) {
-            root = createRoot(canvas);
-            const currentRoot = root;
-            const initialized = isWebGPURenderer(renderer) ? renderer.init() : Promise.resolve();
-            void initialized
-              .then(() => {
-                if (disposed) return;
-                return currentRoot.configure({
-                  gl: renderer,
-                  scene: session.scene,
-                  frameloop: 'never',
-                  events,
-                  size: { width: 1, height: 1, top: 0, left: 0 },
-                  onCreated(state) {
-                    state.set({ invalidate: session.invalidate });
-                  },
-                });
-              })
-              .then(() => {
-                if (disposed) return;
-                store = root!.render(sceneTree());
-                // Events are forwarded from pane elements, including companion documents.
-                store.getState().events.disconnect?.();
-                store.getState().setEvents({
-                  enabled: true,
-                  compute(event, state) {
-                    const element = event.currentTarget as HTMLElement;
-                    const rect = element.getBoundingClientRect();
-                    state.pointer.set(
-                      ((event.clientX - rect.left) / rect.width) * 2 - 1,
-                      (-(event.clientY - rect.top) / rect.height) * 2 + 1,
-                    );
-                    state.raycaster.layers.mask = state.camera.layers.mask;
-                    state.raycaster.setFromCamera(state.pointer, state.camera);
-                  },
-                });
-              })
-              .catch(failed);
-          }
-          return renderer;
-        };
-        return 'then' in created ? Promise.resolve(created).then(connect) : connect(created);
-      },
-    });
-    const names: Record<string, keyof Events> = {
-      click: 'onClick',
-      dblclick: 'onDoubleClick',
-      contextmenu: 'onContextMenu',
-      wheel: 'onWheel',
-      pointerdown: 'onPointerDown',
-      pointerup: 'onPointerUp',
-      pointermove: 'onPointerMove',
-      pointerleave: 'onPointerLeave',
-      pointercancel: 'onPointerCancel',
-      lostpointercapture: 'onLostPointerCapture',
-    };
-    const value: Bridge = {
-      session,
-      ready,
-      setScene(next) {
-        content = next;
-        drawScene();
-        session.invalidate();
-      },
-      pointer(_element, camera, event) {
-        if (!store) return;
-        const state = store.getState();
-        const original = state.camera;
-        state.set({ camera: camera as THREE.PerspectiveCamera });
-        try {
-          const name = names[event.type];
-          if (name) state.events.handlers?.[name]?.(event);
-        } finally {
-          state.set({ camera: original });
-        }
-      },
-    };
-    setBridge(value);
-    initial.current.onReady?.(session);
-    return () => {
-      disposed = true;
-      if (animation) frameWindow.cancelAnimationFrame(animation);
-      reject(new Error('Three session disposed before scene readiness'));
-      root?.unmount();
-      session.dispose();
-    };
-  }, []);
-  return bridge ? <Context.Provider value={bridge}>{children}</Context.Provider> : null;
-}
-/** Declare scene content exactly once, outside individual pane components. */
-export function SharedScene({ children }: { children: ReactNode }) {
-  const bridge = useBridge();
-  useLayoutEffect(() => {
-    bridge.setScene(children);
-  }, [bridge, children]);
-  useLayoutEffect(() => () => bridge.setScene(null), [bridge]);
-  return null;
-}
-export interface ThreeViewProps extends ViewOptions {
-  paneContext: PaneProps;
-  children?: ReactNode;
-}
-/** The children here are HTML overlays. Shared Three.js JSX belongs in SharedScene. */
-export function ThreeView({ paneContext, children, ...options }: ThreeViewProps) {
-  const bridge = useBridge();
-  const element = useRef<HTMLDivElement>(null);
-  const current = useRef(options);
-  current.current = options;
-  useLayoutEffect(() => {
-    if (!element.current) return;
-    const host = element.current;
-    const view = bridge.session.register(
-      { ...paneContext, element: host },
-      {
-        ...current.current,
-        onPointer(event, hits, camera) {
-          bridge.pointer(host, camera, event);
-          current.current.onPointer?.(event, hits, camera);
-        },
-      },
-    );
-    paneContext.deferReady(bridge.ready);
-    return () => view.dispose();
-  }, [
-    bridge,
-    paneContext.pane.id,
-    paneContext.document,
-    options.camera,
-    options.controls,
-    options.pipeline,
-  ]);
-  return (
-    <div ref={element} style={{ width: '100%', height: '100%', position: 'relative' }}>
-      {children}
-    </div>
-  );
-}
-
-// Preserve R3F JSX augmentation for consumers importing only quilt-three/react.
-export type { ThreeElements, ThreeEvent } from '@react-three/fiber';
-
-/** Mount inside ThreeSessionProvider, alongside SharedScene (not inside its R3F tree).
- * Visibility is reactive; other options are mount-only.
- */
-export function CameraHelpers({ visible = true, ...options }: CameraHelpersOptions) {
-  const session = useThreeSession();
-  const initial = useRef(options);
-  const instance = useRef<CameraHelpersController | null>(null);
-  useEffect(() => {
-    const helpers = new CameraHelpersController(session, { ...initial.current, visible });
-    instance.current = helpers;
-    return () => {
-      helpers.dispose();
-      instance.current = null;
-    };
-  }, [session]);
-  useEffect(() => {
-    instance.current?.setVisible(visible);
-  }, [visible]);
-  return null;
-}