@xperimntl/vue-threejs 1.1.0

package/CHANGELOG.md

@@ -0,0 +1,1210 @@
+# @react-three/fiber
+
+## 1.1.0
+
+### Minor Changes
+
+- c7e33c6: Initial publish under @xperimntl scope
+
+## 1.1.1
+
+### Patch Changes
+
+- 0433707: Bump TypeScript to 5.9 and align @types/three with three@0.183.
+
+## 1.1.0
+
+### Minor Changes
+
+- 46ce1f9: Publish all sub-packages to npm and export templateCompilerOptions for Vite custom element configuration.
+
+## 9.5.0
+
+### Minor Changes
+
+- 1050a62bd4bc15e60ab3a65deea08dedfcf24989: Support React 19.2
+
+## 9.4.2
+
+### Patch Changes
+
+- 3d445fd158b25eb380cd27bd2e01304016aa23e3: fix: Expo SDK 54 compatibility through workaround
+
+## 9.4.1
+
+### Patch Changes
+
+- 4f8cec0d79003a9ef6d1ca1e56de94aec4158714: fix: pass DevTools config through createReconciler to fix React DevTools
+
+## 9.4.0
+
+### Minor Changes
+
+- f0976dc14a2d3203af267d0e3524d45a07f3248a: feat: improve applyProps errors, harden pierced props setting
+
+## 9.3.0
+
+### Minor Changes
+
+- 7579c2d79ed60e5c93a259637b65c01971f39d82: feat: add flushSync example
+- 26e5d6e8b8b00b817ebb5242432000abe38bfc2c: fix: update flushSync for new reconciler
+- 0281b6bc4fcf041ed801e64f1876f70c214aa117: fix(native): update react-native deep imports for 0.79 compatibility
+
+## 9.2.0
+
+### Minor Changes
+
+- 94ece53e17a586465b10ec627cf4799cefa72b3a: Export flushSync
+
+## 9.1.4
+
+### Patch Changes
+
+- d491e46087508dff50c48768a99f87bd486b6910: Accept readonly arrays for vector props
+
+## 9.1.3
+
+### Patch Changes
+
+- efd28328f5e612b0592be7da316fad990fdf4675: fix(native) fix crash on rerendering GLView with new arch
+
+## 9.1.2
+
+### Patch Changes
+
+- 053757f45d2411f2929975add76a4c979713e616: fix: reference dev-only act with computed key for Webpack
+
+## 9.1.1
+
+### Patch Changes
+
+- 0deae3fb12b6d62ff083891e388ab09de51330d0: Fix failing builds for production when React.act is unavailable. This fixes issues found in React@19.1.0 and up.
+
+## 9.1.0
+
+### Minor Changes
+
+- cbc79507600b81f6a39de9f3f0ecb3aaf811233f: feat: add meshes to loader graph, misc internal fixes
+
+## 9.0.4
+
+### Patch Changes
+
+- 28ebfbf3e7f9e69dc62f5481965b7fd6a3e3a038: fix(types): exclude type conflicts in React runtime types
+
+## 9.0.3
+
+### Patch Changes
+
+- 01f0f1c8855325aae1c337d5443c846cc46007b0: fix(types): remove recursive references in JSX types
+
+## 9.0.2
+
+### Patch Changes
+
+- 14e133278c3cf1550a3b9aeaaadb624a2aae4781: fix(reconciler): prefer to resolve unprefixed instance types
+
+## 9.0.1
+
+### Patch Changes
+
+- 5d711d103b8d3833b93c3ab74707b2b6db5d274a: fix: add use-sync-external-store dep
+
+## 9.0.0
+
+### Major Changes
+
+- 226d2ec: feat: React 19 support
+
+## 8.18.0
+
+### Minor Changes
+
+- 54a3330f: feat: make children optional in Canvas
+
+## 8.17.14
+
+### Patch Changes
+
+- eeeed16b: fix: update use-measure
+
+## 8.17.13
+
+### Patch Changes
+
+- 0a0f2acd: fix: upstream use-measure
+
+## 8.17.12
+
+### Patch Changes
+
+- ff1a16f1: fix: narrow React peer dep range
+
+## 8.17.11
+
+### Patch Changes
+
+- 7461bf0c: fix: loosen instanceof checks for CSB issue
+
+## 8.17.10
+
+### Patch Changes
+
+- d1a072ac: fix: ThreeEvent should not include initMouseEvent
+
+## 8.17.9
+
+### Patch Changes
+
+- f34de655: fix: add orientation handling
+
+## 8.17.8
+
+### Patch Changes
+
+- 3c885807: fix(types): fix React typings, fault tolerant Node type
+
+## 8.17.7
+
+### Patch Changes
+
+- c20a7d73: fix(native): missing pointerId in pointer events
+
+## 8.17.6
+
+### Patch Changes
+
+- 66c3e9fe: fix(native): don't bind events to GLView
+
+## 8.17.5
+
+### Patch Changes
+
+- 162dbbdd: fix: npmignore ignored types"
+
+## 8.17.4
+
+### Patch Changes
+
+- 43866f4e: fix: rebuild with types
+
+## 8.17.3
+
+### Patch Changes
+
+- 8363eb7a: fix: rebuild with types
+
+## 8.17.2
+
+### Patch Changes
+
+- 6aa4eb28: fix: rebuild with types
+
+## 8.17.1
+
+### Patch Changes
+
+- e5f3f4f9: fix: rebuild with types
+
+## 8.17.0
+
+### Minor Changes
+
+- 3c22194d: feat: flushSync, native EventTarget
+
+## 8.16.8
+
+### Patch Changes
+
+- 4748b365: fix: update is.equ to compare booleans
+
+## 8.16.7
+
+### Patch Changes
+
+- 4d6408c7: fix(types): revert usage of future module JSX
+
+## 8.16.6
+
+### Patch Changes
+
+- 03ab82fe: fix(applyProps): null check indeterminate instances
+
+## 8.16.5
+
+### Patch Changes
+
+- cb913e01: fix: use fast JSX, future JSX types
+
+## 8.16.4
+
+### Patch Changes
+
+- 1270d24c: fix: missing dependency on inject function
+
+## 8.16.3
+
+### Patch Changes
+
+- 9c83502c: fix(Canvas): don't override camera frustum props
+
+## 8.16.2
+
+### Patch Changes
+
+- e0900489: fix(useLoader): don't dispose of memoized loader
+
+## 8.16.1
+
+### Patch Changes
+
+- 503efc2e: fix: prevent invalidate from piling up frames
+
+## 8.16.0
+
+### Minor Changes
+
+- 6b0ea6eb: feat: add childadded event dispatch
+
+## 8.15.19
+
+### Patch Changes
+
+- 74926b94: fix(types): avoid emitting THREE.XRFrame
+
+## 8.15.18
+
+### Patch Changes
+
+- 8c01939a: fix: correctly pass frames in invalidate
+
+## 8.15.17
+
+### Patch Changes
+
+- 16c2ee97: fix(types): support @types/three@0.162.0
+
+## 8.15.16
+
+### Patch Changes
+
+- 71cd8f96: fix: tonemapping config overwrites userland
+- 0bb12fd1: fix(types): remove usage of THREE.Vector
+
+## 8.15.14
+
+### Patch Changes
+
+- 0afc9c12: fix: portal events, update examples
+
+## 8.15.13
+
+### Patch Changes
+
+- 0a399f6d: fix(native): use MSAA for antialias on iOS
+
+## 8.15.12
+
+### Patch Changes
+
+- 496d6f0d: fix: useLoader and XRFrame type fixes
+
+## 8.15.11
+
+### Patch Changes
+
+- 3d9af04d: fix: update import from three examples
+
+## 8.15.10
+
+### Patch Changes
+
+- 49158164: fix: don't recursively dispose primitives
+
+## 8.15.9
+
+### Patch Changes
+
+- 4cbc5530: fix(native): deopt iOS blob URI path
+
+## 8.15.8
+
+### Patch Changes
+
+- 70680832: fix: revert stable sort
+
+## 8.15.7
+
+### Patch Changes
+
+- 07e39e2e: fix(types): remove use of Object3D generic
+
+## 8.15.6
+
+### Patch Changes
+
+- 7bb2950b: experiment: stable object sort
+
+## 8.15.5
+
+### Patch Changes
+
+- 0e44fd8b: fix(types): preserve deprecated JSX annotations
+
+## 8.15.4
+
+### Patch Changes
+
+- 634e5db5: fix(native): harden Blob URI check for Android
+
+## 8.15.3
+
+### Patch Changes
+
+- beab4344: fix(native): workaround Android content policy for Blob URI
+
+## 8.15.2
+
+### Patch Changes
+
+- 086d3932: fix: size check and raycaster camera
+
+## 8.15.1
+
+### Patch Changes
+
+- 2d39676d: fix: ignore deprecated types, use correct XRFrame definition
+
+## 8.15.0
+
+### Minor Changes
+
+- cca8b6bb: feat: export buildGraph
+
+## 8.14.7
+
+### Patch Changes
+
+- 0f63a287: fix(native): restore polyfill conversions, drop networking
+
+## 8.14.6
+
+### Patch Changes
+
+- 465fa0fb: fix(native): revert usage of networking stack
+
+## 8.14.5
+
+### Patch Changes
+
+- f372a5b5: fix(applyProps): loosen copy identity in dev
+
+## 8.14.4
+
+### Patch Changes
+
+- dc7e5739: fix(native): amend BlobManager over globals
+
+## 8.14.3
+
+### Patch Changes
+
+- d77b0990: fix(native): drop fsstat for react-native-web
+
+## 8.14.2
+
+### Patch Changes
+
+- 33e8baef: fix: native perf, loader types
+
+## 8.14.1
+
+### Patch Changes
+
+- c99907bf: fix(native): prefer local uri for fs
+
+## 8.14.0
+
+### Minor Changes
+
+- 89e96bf4: feat: react-native-web, native globals fixes
+
+## 8.13.9
+
+### Patch Changes
+
+- 44d57b3c: fix(native): TextureLoader should remain consistent with FileLoader
+
+## 8.13.8
+
+### Patch Changes
+
+- 5da26d52: fix(useLoader): dispose loaders
+
+## 8.13.7
+
+### Patch Changes
+
+- 37b9502a: fix(Canvas): pass scene prop
+
+## 8.13.6
+
+### Patch Changes
+
+- 0597495c: fix: harden XR init against Renderer shim
+
+## 8.13.5
+
+### Patch Changes
+
+- 7a3b543b: fix: three type regressions
+
+## 8.13.4
+
+### Patch Changes
+
+- 824ee0f7: fix: safely diff instances
+
+## 8.13.3
+
+### Patch Changes
+
+- ffdb5fc4: revert nested portals, up suspend-react
+
+## 8.13.2
+
+### Patch Changes
+
+- bbabdf07: update suspend-react
+
+## 8.13.1
+
+### Patch Changes
+
+- c9fe03ba: fix: primitive swap and reactive portals
+
+## 8.13.0
+
+### Minor Changes
+
+- ecfc48b7: feat: CanvasProps alias, respect r152 color management
+
+## 8.12.2
+
+### Patch Changes
+
+- c5193468: fix: safeguard window.devicePixelRatio
+
+## 8.12.1
+
+### Patch Changes
+
+- 571f07ac: fix: safeguard window.devicePixelRatio
+
+## 8.12.0
+
+### Minor Changes
+
+- 1928d095: feat: `scene` render prop for custom THREE.Scene
+
+## 8.11.11
+
+### Patch Changes
+
+- f03c6ef8: feat: `scene` render prop for custom THREE.Scene
+
+## 8.11.10
+
+### Patch Changes
+
+- 12907836: fix onpointerlostcapture which fired before pointerup
+
+## 8.11.9
+
+### Patch Changes
+
+- 6b5f572c: fix: treeshake THREE.ColorManagement
+
+## 8.11.8
+
+### Patch Changes
+
+- 350cd3f3: fix(Canvas): inline render-effect
+
+## 8.11.7
+
+### Patch Changes
+
+- 96af62d5: fix: don't overwrite public cameras
+
+## 8.11.6
+
+### Patch Changes
+
+- 7d319c18: Fix is.equ obj:shallow, allow it to test arrays 1 level deep, fix canvas.camera prop being stale
+
+## 8.11.5
+
+### Patch Changes
+
+- c658f763: fix: update canvas prop types
+
+## 8.11.4
+
+### Patch Changes
+
+- 970aa58b: fix: play nice with offscreencanvas
+
+## 8.11.3
+
+### Patch Changes
+
+- 2bce569c: fix: progressively set colormanagement
+
+## 8.11.2
+
+### Patch Changes
+
+- 41d655cd: fix: hmr, srgb encode
+
+## 8.11.1
+
+### Patch Changes
+
+- 58cadeff: fix: skip circular onUpdate calls
+
+## 8.11.0
+
+### Minor Changes
+
+- 2917a47b: events.update, allow raycast w/o user interaction
+- 521bfb07: events.update, allow raycast w/o user interaction
+
+## 8.10.4
+
+### Patch Changes
+
+- d9e6316d: fix: transpile class properties
+
+## 8.10.3
+
+### Patch Changes
+
+- d06d2879: fix: align useLoader type, public fields from builds
+
+## 8.10.2
+
+### Patch Changes
+
+- 564edbbb: fix port inject layers, it should allow root props to overwrite undefined portal props"
+
+## 8.10.1
+
+### Patch Changes
+
+- bfa0298f: fix memoized identity
+
+## 8.10.0
+
+### Minor Changes
+
+- 24c4dba4: shortcut for shadow type
+
+## 8.9.2
+
+### Patch Changes
+
+- 2aeb6500: fix: primitives are incorrectly swapped on key change in maps
+
+## 8.9.1
+
+### Patch Changes
+
+- 0cf11797: fix(events): type spread event props
+
+## 8.9.0
+
+### Minor Changes
+
+- a458b4dd: fix(loop): export flush methods and types
+
+## 8.8.11
+
+### Patch Changes
+
+- 2068f0cc: fix: events pointerlock, useLoader extension types
+
+## 8.8.10
+
+### Patch Changes
+
+- 00c24718: fix: invalidate pierced props
+
+## 8.8.9
+
+### Patch Changes
+
+- 4254400e: fix(createPortal): use correct JSX type
+
+## 8.8.8
+
+### Patch Changes
+
+- fcb183e3: fix: call onUpdate for attached children prop update
+
+## 8.8.7
+
+### Patch Changes
+
+- bedb16e7: fix: prefer named functions, for loops in hot paths
+
+## 8.8.6
+
+### Patch Changes
+
+- 02a558bb: fix: upgrade deps
+
+## 8.8.5
+
+### Patch Changes
+
+- 530a06d6: fix: upgrade deps to work-around CRA
+
+## 8.8.4
+
+### Patch Changes
+
+- 2f2dc9f9: chore: upgrade bridge to harden suspense behavior
+
+## 8.8.3
+
+### Patch Changes
+
+- 9f571239: fix #2506, events should fall back to rootstate"
+
+## 8.8.2
+
+### Patch Changes
+
+- dc389ed6: fix(Canvas): prevent remount on context update
+
+## 8.8.1
+
+### Patch Changes
+
+- 370d3ae5: refactor: pull context bridge from its-fine
+
+## 8.8.0
+
+### Minor Changes
+
+- 46d8b440: bridge cross-container context
+
+## 8.7.4
+
+### Patch Changes
+
+- 259c8895: fix: use self to get global context before window
+
+## 8.7.3
+
+### Patch Changes
+
+- eb5a3be4: fix: if there is an eventsource pointerevent will be set to none
+
+## 8.7.2
+
+### Patch Changes
+
+- 7f801e60: fix: events in portals carry the wrong raycaster, camera, etc
+
+## 8.7.1
+
+### Patch Changes
+
+- 962cc270: fix: allow canvas eventsource to be a ref
+
+## 8.7.0
+
+### Minor Changes
+
+- f5db1b78: feat: useInstanceHandle, flushGlobalEffects
+
+## 8.6.2
+
+### Patch Changes
+
+- 57c12e9c: fix(types): @react-three/drei declaration files
+
+## 8.6.1
+
+### Patch Changes
+
+- 7a0b5670: fix(core): don't append to unmounted containers
+
+## 8.6.0
+
+### Minor Changes
+
+- 85c80e70: eventsource and eventprefix on the canvas component
+
+## 8.5.1
+
+### Patch Changes
+
+- 87821d9: fix: null-check instance.children on reconstruct
+
+## 8.5.0
+
+### Minor Changes
+
+- edc8252: feat: handle primitive children, auto-attach via instanceof
+
+## 8.3.1
+
+### Patch Changes
+
+- aaeb2b8: fix(types): accept readonly arrays for vector props
+
+## 8.3.0
+
+### Minor Changes
+
+- 9c450ec: feat: improve errors
+
+## 8.2.3
+
+### Patch Changes
+
+- b8d2eab: fix: improve useLoader signature, initial size on createRoot
+
+## 8.2.2
+
+### Patch Changes
+
+- acd6f04: fix: warn on stray text
+
+## 8.2.1
+
+### Patch Changes
+
+- 25e35a1: fix: prefer useLayoutEffect in react-native
+
+## 8.2.0
+
+### Minor Changes
+
+- 9770d7d: feat: expose ThreeElements interface for JSX elements
+
+## 8.1.0
+
+### Minor Changes
+
+- 8d0f708c: Expose position information in state.size
+
+## 8.0.27
+
+### Patch Changes
+
+- 7940995: fix: resume on xrsession end, export internal events
+
+## 8.0.26
+
+### Patch Changes
+
+- 7b6df9df: fix: infinite loop updating cam viewport
+
+## 8.0.25
+
+### Patch Changes
+
+- b7cd0f42: update viewport on camera changes
+
+## 8.0.24
+
+### Patch Changes
+
+- ee8e785: fix: attach timings
+
+## 8.0.23
+
+### Patch Changes
+
+- 29d03c64: revert multi attach
+
+## 8.0.22
+
+### Patch Changes
+
+- 419e854: fix: always prepare primitives
+
+## 8.0.21
+
+### Patch Changes
+
+- 3098b9b: fix: resizing in worker contexts, copy over attachments on reconstruct
+
+## 8.0.20
+
+### Patch Changes
+
+- 4c87bce: fix: attach, devtools, and perf fixes
+
+## 8.0.19
+
+### Patch Changes
+
+- 360b45a: fix: handle attach on reconstruct
+
+## 8.0.18
+
+### Patch Changes
+
+- be567c1: fix: suspense attach and three compat in webpack
+
+## 8.0.17
+
+### Patch Changes
+
+- 9e3369e: fix dom resize, improve native tree shaking
+
+## 8.0.16
+
+### Patch Changes
+
+- 669c45c: correctly type useLoader results
+
+## 8.0.15
+
+### Patch Changes
+
+- c4715d5f: allow invalidate to preempt more than 1 frame
+
+## 8.0.14
+
+### Patch Changes
+
+- 5559a119: Add support for recoverable errors
+
+## 8.0.13
+
+### Patch Changes
+
+- 9d77d8e2: fix: detach attribute removal
+
+## 8.0.12
+
+### Patch Changes
+
+- 3d10413f: fix portal layers
+
+## 8.0.11
+
+### Patch Changes
+
+- 5167b1e4: memoized.args can be undefined
+
+## 8.0.10
+
+### Patch Changes
+
+- eb321afd: fix: remount bug, allow portals to inject custom size
+
+## 8.0.9
+
+### Patch Changes
+
+- 624df949: fix: canvas unmount race condition"
+
+## 8.0.8
+
+### Patch Changes
+
+- 952a566: fix: react SSR
+
+## 8.0.7
+
+### Patch Changes
+
+- f63806b: fix: react SSR
+
+## 8.0.6
+
+### Patch Changes
+
+- d4bafb9: fix re-parenting, useframe not working properly in portals, attach crash
+
+## 8.0.5
+
+### Patch Changes
+
+- 227c328: fix pointer for root and portals
+
+## 8.0.4
+
+### Patch Changes
+
+- e981a72: fix: mock three color management, loosen peer dep
+
+## 8.0.3
+
+### Patch Changes
+
+- 3252aed: setevents needs to spread and be mirrored in portals
+
+## 8.0.2
+
+### Patch Changes
+
+- 8035d1f: fix: legacy mode
+
+## 8.0.1
+
+### Patch Changes
+
+- 26db195: add legacy flag to turn of three.colormanagement
+
+## 8.0.0
+
+### Major Changes
+
+- 385ba9c: v8 major, react-18 compat
+- 04c07b8: v8 major, react-18 compat
+
+### Patch Changes
+
+- 347ea79: new beta for library testing
+
+## 8.0.0-beta.0
+
+### Major Changes
+
+- 385ba9c: v8 major, react-18 compat
+
+## 8.0.0-beta.0
+
+### Patch Changes
+
+- cf6316c: new beta for library testing
+
+## 7.0.25
+
+### Patch Changes
+
+- 8698734: Release latest patches
+
+## 7.0.24
+
+### Patch Changes
+
+- 7f46ddf: cleanup captured pointers when released (#1914)
+
+## 7.0.23
+
+### Patch Changes
+
+- 30d38b1: remove logs
+
+## 7.0.22
+
+### Patch Changes
+
+- 259e1fa: add camera:manual
+
+## 7.0.21
+
+### Patch Changes
+
+- 65e4147: up usemeasure, add last event to internals"
+
+## 7.0.20
+
+### Patch Changes
+
+- 54cb0fd: update react-use-measure, allow it to use the offsetSize
+
+## 7.0.19
+
+### Patch Changes
+
+- 7aa2eab: fix: remove zustand subscribe selector
+
+## 7.0.18
+
+### Patch Changes
+
+- 6780f58: fix unmount pointer capture
+
+## 7.0.17
+
+### Patch Changes
+
+- 894c550: fix: event count
+
+## 7.0.16
+
+### Patch Changes
+
+- c7a4220: patch: applyprops returns the same instance
+
+## 7.0.15
+
+### Patch Changes
+
+- c5645e8: fix primitive leftovers on switch
+
+## 7.0.14
+
+### Patch Changes
+
+- 05af996: fix: revert the is function
+
+## 7.0.13
+
+### Patch Changes
+
+- f256558: fix(core): don't overwrite camera rotation
+- 51e6fc9: fix(core): safely handle external instances
+
+## 7.0.12
+
+### Patch Changes
+
+- 0df6073: fix: missed events
+
+## 7.0.11
+
+### Patch Changes
+
+- 62b0a3a: fix: event order of missed pointers
+
+## 7.0.10
+
+### Patch Changes
+
+- e019dd4: fixes
+
+## 7.0.9
+
+### Patch Changes
+
+- cd266e4: Fix diffProps dashed keys
+
+## 7.0.8
+
+### Patch Changes
+
+- 6f68406: Allow getCurrentViewport to receive an array
+
+## 7.0.7
+
+### Patch Changes
+
+- 0375896: Simplify useframe, support instanced event cancelation, silence disposal
+
+## 7.0.6
+
+### Patch Changes
+
+- fb052ad: Fix babel-env browserslist transpiling into old code"
+
+## 7.0.5
+
+### Patch Changes
+
+- c97794a: Add useLoader.clear(Loader, input)
+
+## 7.0.4
+
+### Patch Changes
+
+- 974ecfb: Allow elements to define attachFns for specific mount/unmount
+
+## 7.0.2
+
+### Patch Changes
+
+- a97aca3: Add controls state field
+- 4c703d6: fix rttr didn't work with r130
+
+## 7.0.0
+
+### Major Changes
+
+- 96ae1ad: fix javascript interpreting negative renderpriority as positive
+
+This is a major breaking change that will fix an edge-case. It will only affect you if you used negative useFrame indices, for instance
+
+```jsx
+useFrame(..., -1)
+```
+
+Surprisingly this disabled auto-rendering although the documentation says positive numbers only. As of v7 this will not take over the render loop.
+
+```jsx
+function Render() {
+  // Takes over the render-loop, the user has the responsibility to render
+  useFrame(({ gl, scene, camera }) => {
+    gl.render(scene, camera)
+  }, 1)
+
+function RenderOnTop() {
+  // This will render on top of the previous call
+  useFrame(({ gl, ... }) => {
+    gl.render(...)
+  }, 2)
+
+function A() {
+  // Will *not* take over the render-loop, negative indices can still be useful for sorting
+  useFrame(() => ..., -1)
+
+function B() {
+  // B's useFrame will execute *after* A's
+  useFrame(() => ..., -2)
+```
+
+## 6.2.3
+
+### Patch Changes
+
+- 26bc7eb: typescript changes
+
+## 6.2.2
+
+### Patch Changes
+
+- 4f44a2c: use more helpful name with event handling in rttr
+
+## 6.2.1
+
+### Patch Changes
+
+- Fix stopPropagation logic
+
+## 6.2.0
+
+### Minor Changes
+
+- Allow object3d instances to be attached
+
+## 6.1.5
+
+### Patch Changes
+
+- fix(rttr): if children is undefined return an array to map with
+
+## 6.1.4
+
+### Patch Changes
+
+- 6faa090: Add shape to types, exclude event functions from event data
+
+## 6.1.3
+
+### Patch Changes
+
+- 71e72c0: Fix constructor args with attached children (#1348)
+- 015fc03: Only set up pointer/wheel events as passive
+- a160e08: Fix event setPointerCapture and stopPropagation.
+
+## 6.1.2

package/README.md

@@ -0,0 +1,125 @@
+# vue-threejs
+
+[![npm](https://img.shields.io/npm/v/@xperimntl/vue-threejs?style=flat&colorA=09090b&colorB=09090b)](https://www.npmjs.com/package/@xperimntl/vue-threejs)
+[![CI](https://img.shields.io/github/actions/workflow/status/chris-xperimntl/vue-threejs/test.yml?branch=master&style=flat&colorA=09090b&colorB=09090b&label=tests)](https://github.com/chris-xperimntl/vue-threejs/actions/workflows/test.yml)
+[![docs](https://img.shields.io/badge/docs-live-09090b?style=flat&colorA=09090b)](https://chris-xperimntl.github.io/vue-threejs/)
+[![license](https://img.shields.io/github/license/chris-xperimntl/vue-threejs?style=flat&colorA=09090b&colorB=09090b)](LICENSE)
+
+A Vue 3 renderer for [Three.js](https://threejs.org/), ported from [react-three-fiber](https://github.com/pmndrs/react-three-fiber). Declarative scene authoring with Vue composables, DOM/3D slot composition, and reactive demand rendering.
+
+```bash
+npm install @xperimntl/vue-threejs three vue
+```
+
+## Quick Start
+
+```vue
+<script setup lang="ts">
+import type { Mesh } from 'three'
+import { Canvas, useFrame, useObjectRef } from '@xperimntl/vue-threejs'
+
+const box = useObjectRef<Mesh>()
+
+useFrame((_, delta) => {
+  if (box.object.value) {
+    box.object.value.rotation.x += delta
+    box.object.value.rotation.y += delta * 0.5
+  }
+})
+</script>
+
+<template>
+  <Canvas>
+    <ambientLight :intensity="0.5" />
+    <pointLight :position="[10, 10, 10]" />
+    <mesh :ref="box.ref">
+      <boxGeometry />
+      <meshStandardMaterial color="orange" />
+    </mesh>
+  </Canvas>
+</template>
+```
+
+## Features
+
+|                        |                                                                                   |
+| ---------------------- | --------------------------------------------------------------------------------- |
+| **Declarative scenes** | Vue components map directly to Three.js objects                                   |
+| **Fiber-compatible**   | `Canvas`, `useFrame`, `useThree`, `useLoader`, `createPortal`, `extend`           |
+| **Vue-native**         | `useObjectRef`, `useRenderCommit`, `useNextFrame`, `watchInvalidate`              |
+| **DOM + 3D**           | Canvas `#overlay` and `#error` slots, `provide`/`inject` across boundaries        |
+| **Demand rendering**   | `frameloop="demand"` + `watchInvalidate` for zero-waste rendering                 |
+| **Plugin system**      | `defineFiberPlugin` for root-scoped extensions (postprocessing, physics, helpers) |
+
+## API
+
+<details>
+<summary><strong>Core composables</strong></summary>
+
+| Composable                                  | Purpose                                         |
+| ------------------------------------------- | ----------------------------------------------- |
+| `useFrame(cb, priority?)`                   | Run logic each rendered frame                   |
+| `useThree(selector?)`                       | Access renderer state (gl, scene, camera, size) |
+| `useLoader(loader, url, ext?, onProgress?)` | Load and cache assets                           |
+| `useObjectRef<T>()`                         | Raw THREE object access with lifecycle tracking |
+| `useRenderCommit()`                         | Wait for Vue flush + rendered frame             |
+| `useNextFrame()`                            | Promise that resolves after one frame           |
+| `useAfterRender(cb)`                        | Post-render hook with auto cleanup              |
+| `watchInvalidate(source, opts?)`            | Vue reactivity to demand-mode invalidation      |
+| `createPortal(children, container)`         | Render into another scene container             |
+
+</details>
+
+<details>
+<summary><strong>Compatibility notes</strong></summary>
+
+- **Refs** are proxy-backed. `instanceof` works, `===` identity does not. Use `useObjectRef` for the raw object.
+- **Suspense** keeps previous content visible during re-entrance. Use manual loading patterns for transitions.
+- **Events** are raycaster-based, not DOM-based. Pointer capture semantics differ.
+
+See [Known Limitations](https://chris-xperimntl.github.io/vue-threejs/advanced/known-limitations) and [Compatibility Contract](https://chris-xperimntl.github.io/vue-threejs/advanced/compatibility-contract).
+
+</details>
+
+## Ecosystem
+
+Built-in packages ported from [Poimandres](https://github.com/pmndrs):
+
+| Package        | Origin                                                                                                       | What it provides                               |
+| -------------- | ------------------------------------------------------------------------------------------------------------ | ---------------------------------------------- |
+| drei           | [@react-three/drei](https://github.com/pmndrs/drei)                                                          | Controls, loaders, staging, materials, helpers |
+| postprocessing | [@react-three/postprocessing](https://github.com/pmndrs/react-postprocessing)                                | GPU postprocessing effects                     |
+| rapier         | [@react-three/rapier](https://github.com/pmndrs/react-three-rapier)                                          | Rigid-body physics                             |
+| test-renderer  | [@react-three/test-renderer](https://github.com/pmndrs/react-three-fiber/tree/master/packages/test-renderer) | Node.js testing                                |
+
+## Documentation
+
+[**chris-xperimntl.github.io/vue-threejs**](https://chris-xperimntl.github.io/vue-threejs/)
+
+- [Installation](https://chris-xperimntl.github.io/vue-threejs/getting-started/installation)
+- [Interactive Examples](https://chris-xperimntl.github.io/vue-threejs/getting-started/examples)
+- [Vue-Native Patterns](https://chris-xperimntl.github.io/vue-threejs/tutorials/vue-native-patterns)
+- [Architecture](https://chris-xperimntl.github.io/vue-threejs/advanced/architecture)
+- [Support Matrix](https://chris-xperimntl.github.io/vue-threejs/advanced/support-matrix)
+
+<details>
+<summary><strong>Develop locally</strong></summary>
+
+```bash
+git clone https://github.com/chris-xperimntl/vue-threejs.git
+cd vue-threejs
+yarn install && yarn build
+```
+
+```bash
+yarn examples      # docs site with demos
+yarn test          # test suite
+yarn typecheck     # TypeScript checks
+yarn eslint        # lint
+```
+
+</details>
+
+## License
+
+[MIT](LICENSE). Includes substantial code from [react-three-fiber](https://github.com/pmndrs/react-three-fiber) by [Poimandres](https://github.com/pmndrs), licensed under the same terms. Ecosystem packages ported from [drei](https://github.com/pmndrs/drei), [react-postprocessing](https://github.com/pmndrs/react-postprocessing), and [react-three-rapier](https://github.com/pmndrs/react-three-rapier).

package/TESTING.md

@@ -0,0 +1,34 @@
+# Testing — Gap-to-Proof Map
+
+Internal reference mapping each behavioral claim to the test that proves it.
+This is not part of the public docs.
+
+## Divergence Coverage
+
+| Behavior                                       | Test Name                                                         | File              |
+| ---------------------------------------------- | ----------------------------------------------------------------- | ----------------- |
+| Refs: instanceof works via proxy               | "should forward ref three object"                                 | renderer.test.tsx |
+| Refs: identity requires .object                | "should handle the object prop reactively"                        | renderer.test.tsx |
+| Suspense: visibility stays true                | "should toggle visibility during Suspense non-destructively"      | renderer.test.tsx |
+| Suspense: old content stays during re-entrance | "should handle Suspense lifecycle with async primitives" (Step 3) | renderer.test.tsx |
+| flushSync: synchronous scene update            | "should update scene synchronously with flushSync"                | renderer.test.tsx |
+| flushSync: nested component flush              | "should flush nested component updates synchronously"             | renderer.test.tsx |
+| flushSync: no double-run after flush           | "should not double-run effects after flushSync"                   | renderer.test.tsx |
+| flushSync: multi-root flush                    | "should flush multiple roots"                                     | renderer.test.tsx |
+| flushSync: returns void                        | "should return void, not Promise"                                 | renderer.test.tsx |
+
+## Vue-Native API Coverage
+
+| Behavior                                 | Test Name                                                         | File              |
+| ---------------------------------------- | ----------------------------------------------------------------- | ----------------- |
+| useObjectRef: direct object access       | "should provide direct object access"                             | renderer.test.tsx |
+| useObjectRef: reconstruction handling    | "should handle reconstruction"                                    | renderer.test.tsx |
+| useObjectRef: mounted state tracking     | "should track mounted state"                                      | renderer.test.tsx |
+| Canvas: overlay slot renders DOM sibling | "should render overlay slot in DOM sibling of canvas"             | renderer.test.tsx |
+| Canvas: no overlay div when slot absent  | "should not render overlay div when slot is absent"               | renderer.test.tsx |
+| Canvas: error slot with retry            | "should render error slot with error and retry props"             | renderer.test.tsx |
+| Canvas: default error display            | "should show default error display when no error slot provided"   | renderer.test.tsx |
+| watchInvalidate: invalidates on change   | "should invalidate on reactive source change"                     | renderer.test.tsx |
+| useAfterRender: callback + cleanup       | "useAfterRender should call callback after render and cleanup"    | renderer.test.tsx |
+| useNextFrame: resolves after frame       | "useNextFrame should resolve after a rendered frame"              | renderer.test.tsx |
+| useRenderCommit: waits for flush + frame | "useRenderCommit should wait for Vue flush and scene application" | renderer.test.tsx |

package/dist/xperimntl-vue-threejs.cjs.d.ts

@@ -0,0 +1,2 @@
+export * from "../src/index.js";
+//# sourceMappingURL=data:application/json;charset=utf-8;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoieHBlcmltbnRsLXZ1ZS10aHJlZWpzLmNqcy5kLnRzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vc3JjL2luZGV4LnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBIn0=

package/dist/xperimntl-vue-threejs.cjs.js

@@ -0,0 +1,16 @@
+"use strict";
+// this file might look strange and you might be wondering what it's for
+// it's lets you import your source files by importing this entrypoint
+// as you would import it if it was built with preconstruct build
+// this file is slightly different to some others though
+// it has a require hook which compiles your code with Babel
+// this means that you don't have to set up @babel/register or anything like that
+// but you can still require this module and it'll be compiled
+
+// this bit of code imports the require hook and registers it
+let unregister = require("../../../node_modules/@preconstruct/hook").___internalHook(typeof __dirname === 'undefined' ? undefined : __dirname, "../../..", "..");
+
+// this re-exports the source file
+module.exports = require("../src/index.ts");
+
+unregister();

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "@xperimntl/vue-threejs",
+  "version": "1.1.0",
+  "description": "A Vue.js renderer for Three.js",
+  "keywords": [
+    "vue",
+    "renderer",
+    "fiber",
+    "three",
+    "threejs"
+  ],
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/chris-xperimntl/vue-threejs/issues"
+  },
+  "homepage": "https://github.com/chris-xperimntl/vue-threejs#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/chris-xperimntl/vue-threejs.git"
+  },
+  "main": "dist/xperimntl-vue-threejs.cjs.js",
+  "module": "dist/xperimntl-vue-threejs.esm.js",
+  "types": "dist/xperimntl-vue-threejs.cjs.d.ts",
+  "sideEffects": false,
+  "preconstruct": {
+    "entrypoints": [
+      "index.ts"
+    ]
+  },
+  "scripts": {
+    "prebuild": "node -e \"require('node:fs').copyFileSync('../../README.md','README.md')\""
+  },
+  "dependencies": {
+    "@babel/runtime": "^7.29.2",
+    "@types/webxr": "*",
+    "@vueuse/core": "^10.0.0",
+    "base64-js": "^1.5.1",
+    "buffer": "^6.0.3",
+    "zustand": "^5.0.12"
+  },
+  "peerDependencies": {
+    "vue": ">=3.3",
+    "three": ">=0.156"
+  }
+}