@react-three/fiber 9.5.0 → 10.0.0-alpha.1

package/CHANGELOG.md

@@ -1,1192 +0,0 @@
-# @react-three/fiber
-
-## 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