CHANGELOG.md

Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog and this project adheres to Semantic Versioning.

[0.9.9] - 2026-03-03

Added

• Add tests for ObjectBVH, SkinnedMeshBVH
• ObjectBVH: Add "getObjectFromId", "getInstanceFromId" functions
• Moved "ObjectBVH" and "SkinnedMeshBVH" to core. These classes are still in development and APIs may change.

Changed

• BVHHelper: Handled case where the a root object does not have geometry.

Fixed

• ParallelMeshBVHWorker: Fix failure when reporting progress.
• ObjectBVH, SkinnedMeshBVH: Fix raycasting bugs for both classes
• ObjectBVH: Fix case where the first BatchedMesh instance would be skipped

[0.9.8] - 2026-01-28

Changed

• Added deprecation warning when using "intersectsTriangle" without casting boundsTree.

Fixed

• "onProgress" function not broadcasting percentages correctly.

Added

• "ObjectBVH" to examples.

[0.9.7] - 2026-01-17

Added

• BVH: Added support for "bvhcast" callback

Fixed

• BVHHelper: Rename "objectIndex" to "instanceId"
• BVHHelper: Enable "instanceId" to be set to - 1 to ignore the instance transform.

Changed

• MeshBVH: deprecated "maxLeafTris" option in favor of "maxLeafSize".
• MeshBVHHelper: deprecated class in favor of "BVHHelper".
• BVH: Changed internal shapecast callbacks

[0.9.6] - 2026-01-15

Fixed

• BVHHelper: Fix "clone" function not cloning all fields.
• acceleratedRaycast: Fix case where raycasting will fail if "type" is modified.
• Update types.
• WGSL: Fix use of keyword as a variable.

Added

• PointsBVH, LineBVH, LineLoopBVH, LineSegmentsBVH: Added support for "refit" function.
• SkinnedMeshBVH for skinned meshes or morph target meshes to the examples directory.

[0.9.5] - 2026-01-08

Added

• Support for PointsBVH, LineBVH, LineSegmentsBVH, LineLoopBVH.

Fixed

• Removed unnecessary PURE annotation.
• Fixed typing

[0.9.4] - 2025-12-18

Added

• Docs for bvhcast function.
• More usage of "PURE" annotations.
• Added "version" field to serialized data.
• Add support for "shiftTriangleOffsets" function.

Changed

• Changed the internal storage of child indices from uint32 offsets to node indices. Old serialized data will continue to work via a "fixup" step while logging a warning.

[0.9.3] - 2025-12-01

Fixed

• Fixed dependencies on WebGPURenderer compute nodes.
• Fixed MeshBVH.bvhcast passing "NaN" nodeIndex values to callbacks when more than one group was present.
• Fixed triangles being included in the BVH when they were not included in a groups range (eg exclude triangles in group gaps).
• Ensure "triangle bounds" buffer is limited to the size it needs to be to avoid unnecessary memory overhead.
• Remove limitation preventing "indirect" BVHs from being generated for BatchedMesh instances.
• Raycasting will now return the correct material index aligned with three.js' results including when geometry with overlapping groups are used.

[0.9.2] - 2025-10-24

Added

• Types for web workers.
• Add tsl functions for running bvh raycasting and distance queries via compute shaders.
• Add "three-mesh-bvh/worker" export.
• Add "three-mesh-bvh/webgpu" export.

Fixed

• Type definitions.
• Case where raycasting results would not match three.js' behavior.
• Case where "intersectsGeometry" would throw an error if a geometry without an index was provided.
• MeshBVHHelper: fix types to align with docs.
• MeshBVHHelper: fix case where "update" causes an error if "mesh" is not provided.
• MeshBVH: Fixed case where generating a bvh for a sub geometry was significantly slower, impacting BatchedMesh generation.

[0.9.1] - 2025-06-20

Fixed

• Type definitions.

[0.9.0] - 2025-01-21

Changed

• Changed "bvhClosestPointToPoint" function signature to include "maxDistance" argument.

[0.8.3] - 2024-11-11

Fixed

• Library not working with BatchedMesh in three.js r170.

[0.8.2] - 2024-10-01

Fixed

• Unnecessarily large triangle bounds buffer used during BVH construction.

[0.8.1] - 2024-09-29

Fixed

• Made example SDF generation logic more robust.
• Adjust the valid the three.js peer dependency.
• Add "barycoord" to the intersection values to align with latest three.js.

[0.8.0] - 2024-09-18

Fixed

• Updated three.js version to r158 where BatchedMesh is supported and available so certain bundlers do not fail on build.

[0.7.8] - 2024-09-11

deprecated due to three.js version incompatibility. Use v0.8.0.

Fixed

• Failure with older versions of three.js.

[0.7.7] - 2024-09-09

deprecated due to three.js version incompatibility. Use v0.8.0.

Added

• Support for a custom "range" option to build a BVH from a sub range of the geometry.
• BatchedMesh support for bounds tree generation functions and raycasting. See "computeBatchedBoundsTree" and "disposeBatchedBoundsTree".
• MeshBVHHelper support for InstancedMesh, BatchedMesh.

Fixed

• Bug in MeshBVH.bvhcast causing the incorrect bounds to be checked on the other bvh.
• Box3.setFromObject failing when MeshBVHHelper is included.

[0.7.6] - 2024-07-02

Fixed

• Regression when intersecting InstancedMesh instances.

[0.7.5] - 2024-06-02

Changed

• Respect Raycaster.near and Raycaster.far during raycast traversal, improving performance.

Fixed

• The resolveTriangleIndex throwing an error when deserializing an indirect BVH.

[0.7.4] - 2024-04-10

Changed

• Improved raycasting performancy by ~20% by avoiding use of the "arrayToBox" function internally.

Fixed

• ParallelMeshBVHWorker now generates a geometry index if it's required.
• Add support for the "indirect" option to both workers.
• Worker generators not guaranteeing that 100% progress would be fired to the onProgress callback.

[0.7.3] - 2024-02-20

Fixed

• StaticGeometryGenerator, VertexAttributeTexture now support empty geometry.

[0.7.2] - 2024-02-13

Fixed

• MeshBVHHelper not updating correctly

Added

• StaticGeometryGenerator now inverts geometry winding order when a mesh uses negative scales.

[0.7.1] - 2024-01-30

Fixed

• Minor case where outside bounds did not have floating point epsilon accounted for which could have resulted in missed intersections at the very edge of the bounds.
• The MeshBVHHelper( mesh, depth ) constructor not working as expected.
• The validateBounds function not accounting for the use of the "indirect" option.

Added

• Added new "ParallelMeshBVHWorker" that parallelizes MeshBVH generation across multiple WebWorkers. Falls back to a single threaded approach if SharedArrayBuffer is not supported.

[0.7.0] - 2024-01-15

Changed

• MeshBVHVisualizer has been deprecated and renamed MeshBVHHelper to align with three.js' conventions.
• MeshBVHHelper constructor now optionally takes a bvh.
• Organization of shader GLSL snippets. They are now grouped into the BVHSShaderGLSL object. Backwards compatible glsl snippets are provided for now but it's recommended to use the new location.

Fixed

• MeshBVHHelper will now display correctly regardless of parent in hierarchy.
• MeshBVHHelper.copy now correctly copies opacity, color.

[0.6.8] - 2023-10-08

Changed

• Small performance improvements to bvhcast function (up to ~10%).

[0.6.7] - 2023-09-07

Fixed

• GPU function parameters to fix undefined behavior on some platforms.

[0.6.6] - 2023-09-03

Fixed

• Case where indirect buffer with no index failed to raycast.

[0.6.5] - 2023-08-30

Added

• Added support for draw range so the BVH now implicitly respects the start and end range specified in the geometry.

[0.6.4] - 2023-08-28

Added

• An experimental "indirect" option to support an indirect triangle sorting for the BVH structure so the geometry index is not adjusted or implicitly generated.

Fixed

• Fixed estimateMemoryInBytes not testing for SharedArrayBuffers resulting in a smaller memory footprint.
• Fixed bug in "intersectsGeometry" function.

Removed

• Removed long deprecated shapecast code path using old function signature.
• Removed long deprecated serialization code path using old function signature.
• Removed long deprecated "terminate" function from web worker class.

[0.6.3] - 2023-07-22

Fixed

• Fixed another triangle / triangle intersection failure case.
• Type declaration and documentation for shapecast function.

[0.6.2] - 2023-07-19

Fixed

• Fixed triangle / triangle intersection failure case.

[0.6.1] - 2023-07-08

Fixed

• The root bounding box incorrectly including the origin causing an extra large bounds for shift geometry.

[0.6.0] - 2023-05-19

Changed

• Bumped minimum required three.js version to v0.151.0

[0.5.24] - 2023-05-13

Fixed

• MeshBVH Worker error when incorrectly transferring shader array buffers.

[0.5.23] - 2023-02-03

Fixed

• Case where raycasting would not work if uvs are not present.

[0.5.22] - 2023-01-15

Added

• Support to suppress logs in ExtendedTriangle.intersectsTriangle.

[0.5.21] - 2023-01-03

Changed

• Removed use of optional chaining.

[0.5.20] - 2022-12-31

Added

• Diff support to StaticGeometryGenerator so only changed meshes and skinned meshes are updated in order to improve performance on subsequent updates.

[0.5.19] - 2022-11-28

Fixed

• StaticGeometryGenerator: now correctly only traverses and includes visible meshes.

[0.5.18] - 2022-11-15

Added

• Support for distance queries on the GPU.

Fixed

• Case in triangle intersect function that would incorrectly report an intersection.

[0.5.17] - 2022-10-22

Fixed

• Case in new three.js that caused the vertex texture to work incrrectly.
• Removed incomplete and incorrect Box3 inheritance from OrientedBox.
• Adde min and max to typescript definition for OrientedBox.

[0.5.16] - 2022-08-05

Added

• Support for normalized vertex attributes.

Removed

• Removed deprecated MeshBVH function signatures for raycast, raycastFirst, closestPointToPoint, closestPointToGeometry, refit, intersectsGeometry, shapecast, intersectsBox, intersectsSphere.

[0.5.15] - 2022-07-25

Fixed

• single point intersection in intersectsTriangle function.
• issue in the closestPointLineToLine function.

[0.5.14] - 2022-06-20

Fixed

• ExtendedTriangle: Fix Another case where IntersectsTriangle failed

[0.5.13] - 2022-06-19

Fixed

• ExtendedTriangle: Fix Another case where IntersectsTriangle failed

[0.5.12] - 2022-06-17

Fixed

• MeshBVHVisualizer: not removing child roots on update.
• ExtendedTriangle: Fix intersection not being reported when triangles intersect at vertex.
• MeshBVH.bvhcast: Fix bvhcast using incorrect bounds to traverse.

[0.5.11] - 2022-05-20

Fixed

• "global" unnecessarily being used in the web worker.

Added

• GenerateMeshBVHWorker.generate: reject when class has been disposed of or error is thrown in worker.
• GenerateMeshBVHWorker: ensure the root array buffers ate transfered when finishing construction.

[0.5.10] - 2022-04-15

Added

• StaticGeometryGenerator to enable skinned and morph target mesh support.

[0.5.9] - 2022-04-11

Fixed

• Incorrect return type for computeBoundsTree.

[0.5.8] - 2022-03-27

Fixed

• Improved type definitions.

Changed

• GenerateMeshBVHWorker: Added "dispose" function. Deprecated "terminate" function.

[0.5.7] - 2022-03-22

Fixed

• WebWorker BVH generation not accounting for geometry groups.
• Export and document "OrientedBox" and "ExtendedTriangle" classes for more clarity and enable use of internal mathematical functions.

[0.5.6] - 2022-03-15

Fixed

• Case where MeshBVH.closestPointToGeometry would return an incorrect value.
• Automatically dispose of textures on update instead of just "needsUpdate".
• Case where SeparatingAxisTriangle.intersectsTriangle would return incorrect intersection lines. Performance of the function improved as a side effect.

[0.5.5] - 2022-02-01

Changed

• onProgress callback now always reports 1.0 when the BVH creation is complete instead of just passing intermmediate progress.

[0.5.4] - 2022-01-20

Fixed

• Removed use of RGBFormat and RGBIntegerFormat for compatibility with three.js r137.

[0.5.3] - 2022-01-08

Changed

• Improved SAH build time by ~20% by checking every triangle split once fewer than 8 triangles are present which also improves the split cost.
• GenerateMeshBVHWorker / MeshBVH: Add onProgress callback option to enable the ability to display BVH build percentage.

Fixed

• MeshBVH.bvhcast incorrectly using the same geometry for both bvh.
• shapecast and bvhcast types to be more correct.

[0.5.2] - 2021-11-02

Fixed

• src/utils incorrectly being published as src/Utils in the previous release.

[0.5.1] - 2021-11-02

Added

• Typescript definition files.
• VertexAttributeTexture, BVHStructUniform, and associated helper shader functions for performing raytracing in a fragment shader.
• Warning when passing in an unknown split strategy option value.

Changed

• src/workers/GenerateMeshBVHWorker to use a proper webworker syntax compatible with esm-capable bundlers.

[0.5.0] - 2021-10-10

Added

• useSharedArrayBuffer option to MeshBVH so SharedArrayBuffers are created rather than ArrayBuffers making it easier to share and reuse BVH memory across workers.
• SeparatingAxisTriangle.intersectsTriangle: added target field to retrieve the edge describing the intersection.
• "box" argument to shapecast "intersectsRange" function.
• /* @__PURE__ */ indicator to reusable variables.

Fixed

• raycast and raycastFirst not properly accounting for material sidedness with geometry groups.
• Case where the BVH root bounds would be incorrect if the geometry bounding box was incorrect / out of date.
• MeshBVH.closestPointTGeometry not returning a proper intersection point if triangles intersect.
• Shapecast function will now ensure a unique triangle / box is provided for each recursive call.
• Fix GenerateMeshBVHWorker not setting the geometry index correctly on return.

Changed

• Changed function signature for intersectsGeometry, shapecast, intersectsBox, intersectsSphere, closestPointToGeometry, closestPointToPoint, raycast, and raycastFirst. Specifically at least the first "mesh" argument has been removed. Calling functions with the old signature will log a warning. See documentation for current signatures.
• raycast and raycastFirst now return hits in the local space of the geometry rather than world space when querying the BVH directly to conform with other cast functions. Results still match three.js' original results when using Raycaster.intersectObject(s) functions. See documentation for more details.
• MeshBVHDebug class has been removed and the function getJSONStructure and validateBounds are now exported individually.
• Small observed performance improvements possibly a result of simplified function arguments.
• The function signatures and options for MeshBVH.serialize and MeshBVH.deserialize have changed. See documentation for more new signature.
• Changed refit function to take just a single argument with traversed node indices. Calling the function with the old signature will log a warning. See documentation for current signature.

Removed

• distanceToGeometry and distanceToPoint functions.

[0.4.3] - 2021-08-20

Fixed

• Fixed Surface Area Heuristic (SAH) split strategy to function correctly, improve build performance, and produce more optimal bounds and improved a memory footprint.

Added

• Return "surfaceAreaCost" in returned getBVHExtremes object to compare BVH structure quality.
• Support for displayEdges, meshMaterial, and edgeMaterial to MeshBVHVisualizer to enable displaying bounds as solid meshes.

Changed

• Deprecated the getBVHExtremes "total" return value in favor of nodeCount.

[0.4.2] - 2021-08-04

Fixed

• Case where intersectsRangeFunc could be passed the incorrect node id in shapecast.
• Bug in distanceToGeometry and closestPointToGeometry which would likely result in some closest points being missed. This fix greatly degrades performance in the case where the passed geometry does not have a BVH. It is recommended that the passed in geometry include a computed bounds tree.
• Cases where passed in geometry that did not include an index buffer could throw an error when calling functions like closestPointToGeometry.
• Case where raycastFirst would return the incorrect result.
• Greatly improved MeshBVHVisualizer render and update performance.
• Case where MeshBVHVisualizer would not correctly display a BVH for geometry with multiple groups.

Added

• distanceToGeometry and closestPointToGeometry fast path when the passed in geometry has a bounds tree.
• Support for position BufferAttribute to be interleaved.

[0.4.1] - 2021-06-21

Changed

• package.json "main" field to use a .cjs file extension

[0.4.0] - 2021-06-11

Added

• MeshBVH.refit function to refit the bounds to modified vertices.
• setBoundingBox MeshBVH construction option.
• MeshBVH.getBoundingBox function.
• intersectsRange callback option to MeshBVH.shapecast.

Changed

• Removed src/worker/generateAsync.js function. Use GenerateMeshBVHWorker instead.
• Use type: module in package.json to enable use of es6 modules in node.
• Add sideEffects: false to package.json.
• Remove ability to generate an unpacked BVH.
• Improved "closestPointToPoint" performance slightly.
• MeshBVH.shapecast to take an object of callback functions instead of a list of function arguments and the triangle intersection callback has been changed to take a single triangle index. See README for new API. Calls using the old function will log a warning.

Fixed

• MeshBVHVisualizer not using the new geometry BVH if one was generated.
• MeshBVHVisualizer not using the new mesh if it was set.
• Case where passing in null intersectsTriangleFunc to MeshBVH.shapecast could throw an error.
• Case where the buffer being raycast against was not cleared correctly if a BVH had multiple roots.

[0.3.7] - 2021-03-06

Fixed

• Include built umd file including v0.3.6 changes.

[0.3.6] - 2021-03-03

Fixed

• Incorrect face index would be returned from intersection (related to three.js bug fixed in v0.126.1).

[0.3.5] - 2021-02-28

Fixed

• Case where raycastFirst failed to return a valid result.

[0.3.4] - 2021-02-25

Changed

• Raycast result to return a custom intersection object aligned with three.js v0.126.0.

[0.3.3] - 2021-01-24

Added

• depth argument to intersectsBoundsFunc and intersectsTriangleFunc of shapecast.
• "webvr" and "webxr" tags.
• closestPointToSegment function to the triangle object used during shapecast which can be used for capsule intersection detection.

[0.3.2] - 2020-12-23

Fixed

• Case where float 32 rounding error could result in leaf bounds not completely containing the triangles by expanding the bounds by an estimation of the error.

Changed

• Shapecast intersectsBoundsFunc to return one of the NOT_INTERSECTED, INTERSECTED, or CONTAINED constants. Returning true and false currently retains the old functionality.

[0.3.1] - 2020-12-14

Added

• Performance improvements when computing distance to geometry.
• shapecast to the docs.
• MeshBVHVisualizer to exports.

Fixed

• Cloning the bvh visualizer causing an error.
• Bug with shapecast function where one node would not be checked when using the node score function.

Changed

• Change the bvh visualizer so it automatically copies the local position and rotation of the target mesh.

[0.3.0] - 2020-12-01

Added

• generateAsync function in the /src/worker folder to help generate BVHs asynchronously with WebWorkers.

Changed

• three.js version to use v0.123.0, change Matrix4.getInverse to Matrix4.invert.

[0.2.0] - 2020-02-07

Added

• MeshBVH.serialize and deserialize functions so the bvh can be computed and transferred from a webworker.
• lazyGeneration (defaults to true) option for faster tree initialization.
• Support for a buffer-packed tree if lazyGeneration is false or a tree has been deserialized for a more smaller memory footprint.

Changed

• CENTER tree computation to improve raycast performance and create more balanced trees.

[0.1.5] - 2020-01-03

Fixed

• Uglify warning for inline defined functions.

[0.1.4] - 2019-08-31

Changed

• Changed three.js peer dependency version from ^ to >= to prevent warnings.

[0.1.3] - 2019-05-24

Added

• Use the BufferGeometry bounding box if it exists and set it if it does not.

Changed

• Use the center of the triangles bounding box instead of the average of the vertices as the triangles center when binning the polygons.

[0.1.2] - 2019-03-17

Fixed

• Bug where closestPointToGeometry would throw an error when target vectors were provided because a function name was misspelled.

[0.1.1] - 2019-03-16

Added

• API for performing intersecting boxes, spheres, and geometry.
• API for checking the distance to geometry and points.

Fixed

• Fixed issue where an index buffer of the incorrect type was created if there were more than 2^16 vertices.
• Fixed MeshBVHVisualizer not visualizing all the groups in the bvh.

[0.1.0] - 2019-02-28

Added

• Error conditions when using InterleavedAttributeBuffers for both index and position geometry attributes.
• The geometry index attribute is modified when building the MeshBVH. And index attribute is created on geometry if it does not exist.

Fixed

• Fix the bounds tree not respecting groups

[0.0.2] - 2019-01-05

Added

• Add included files array to package.json.