@woosh/meep-engine 2.138.20 → 2.140.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (584) hide show
  1. package/package.json +1 -1
  2. package/src/core/bvh2/bvh3/query/bvh_query_user_data_overlaps_aabb.d.ts +3 -3
  3. package/src/core/bvh2/bvh3/query/bvh_query_user_data_overlaps_aabb.d.ts.map +1 -1
  4. package/src/core/bvh2/bvh3/query/bvh_query_user_data_overlaps_aabb.js +4 -4
  5. package/src/core/collection/PairUint32Map.d.ts +100 -0
  6. package/src/core/collection/PairUint32Map.d.ts.map +1 -0
  7. package/src/core/collection/PairUint32Map.js +321 -0
  8. package/src/core/collection/Uint32Map.d.ts +119 -0
  9. package/src/core/collection/Uint32Map.d.ts.map +1 -0
  10. package/src/core/collection/Uint32Map.js +345 -0
  11. package/src/core/collection/array/array_shuffle.d.ts +10 -3
  12. package/src/core/collection/array/array_shuffle.d.ts.map +1 -1
  13. package/src/core/collection/array/array_shuffle.js +27 -22
  14. package/src/core/collection/heap/FibonacciHeap.d.ts +195 -0
  15. package/src/core/collection/heap/FibonacciHeap.d.ts.map +1 -0
  16. package/src/core/collection/heap/FibonacciHeap.js +586 -0
  17. package/src/core/collection/heap/Uint32Heap.js +1 -1
  18. package/src/core/collection/heap/Uint32Heap4.d.ts +169 -0
  19. package/src/core/collection/heap/Uint32Heap4.d.ts.map +1 -0
  20. package/src/core/collection/heap/Uint32Heap4.js +490 -0
  21. package/src/core/geom/3d/aabb/aabb3_transform_oriented.d.ts +30 -0
  22. package/src/core/geom/3d/aabb/aabb3_transform_oriented.d.ts.map +1 -0
  23. package/src/core/geom/3d/aabb/aabb3_transform_oriented.js +93 -0
  24. package/src/core/geom/3d/line/line3_closest_points_segment_segment.d.ts +27 -0
  25. package/src/core/geom/3d/line/line3_closest_points_segment_segment.d.ts.map +1 -0
  26. package/src/core/geom/3d/line/line3_closest_points_segment_segment.js +88 -0
  27. package/src/core/geom/3d/quaternion/quat3_to_matrix3.d.ts +54 -0
  28. package/src/core/geom/3d/quaternion/quat3_to_matrix3.d.ts.map +1 -0
  29. package/src/core/geom/3d/quaternion/quat3_to_matrix3.js +69 -0
  30. package/src/core/geom/3d/shape/AbstractShape3D.d.ts +24 -2
  31. package/src/core/geom/3d/shape/AbstractShape3D.d.ts.map +1 -1
  32. package/src/core/geom/3d/shape/AbstractShape3D.js +24 -1
  33. package/src/core/geom/3d/shape/BoxShape3D.d.ts +61 -0
  34. package/src/core/geom/3d/shape/BoxShape3D.d.ts.map +1 -0
  35. package/src/core/geom/3d/shape/BoxShape3D.js +158 -0
  36. package/src/core/geom/3d/shape/CapsuleShape3D.d.ts +11 -0
  37. package/src/core/geom/3d/shape/CapsuleShape3D.d.ts.map +1 -1
  38. package/src/core/geom/3d/shape/CapsuleShape3D.js +12 -0
  39. package/src/core/geom/3d/shape/HeightMapShape3D.d.ts +148 -0
  40. package/src/core/geom/3d/shape/HeightMapShape3D.d.ts.map +1 -0
  41. package/src/core/geom/3d/shape/HeightMapShape3D.js +451 -0
  42. package/src/core/geom/3d/shape/MeshShape3D.d.ts +210 -0
  43. package/src/core/geom/3d/shape/MeshShape3D.d.ts.map +1 -0
  44. package/src/core/geom/3d/shape/MeshShape3D.js +593 -0
  45. package/src/core/geom/3d/shape/TransformedShape3D.d.ts.map +1 -1
  46. package/src/core/geom/3d/shape/TransformedShape3D.js +46 -2
  47. package/src/core/geom/3d/shape/Triangle3D.d.ts +95 -0
  48. package/src/core/geom/3d/shape/Triangle3D.d.ts.map +1 -0
  49. package/src/core/geom/3d/shape/Triangle3D.js +318 -0
  50. package/src/core/geom/3d/shape/UnionShape3D.js +13 -0
  51. package/src/core/geom/3d/shape/UnitCubeShape3D.d.ts +37 -9
  52. package/src/core/geom/3d/shape/UnitCubeShape3D.d.ts.map +1 -1
  53. package/src/core/geom/3d/shape/UnitCubeShape3D.js +45 -98
  54. package/src/core/geom/3d/shape/UnitSphereShape3D.d.ts +10 -0
  55. package/src/core/geom/3d/shape/UnitSphereShape3D.d.ts.map +1 -1
  56. package/src/core/geom/3d/shape/UnitSphereShape3D.js +11 -0
  57. package/src/core/geom/3d/shape/shape_mesh_from_geometry.d.ts +30 -0
  58. package/src/core/geom/3d/shape/shape_mesh_from_geometry.d.ts.map +1 -0
  59. package/src/core/geom/3d/shape/shape_mesh_from_geometry.js +64 -0
  60. package/src/core/geom/3d/shape/util/shape3d_voxelize_to_grid.d.ts +61 -0
  61. package/src/core/geom/3d/shape/util/shape3d_voxelize_to_grid.d.ts.map +1 -0
  62. package/src/core/geom/3d/shape/util/shape3d_voxelize_to_grid.js +148 -0
  63. package/src/core/geom/3d/tetrahedra/compute_tetrahedral_mesh_from_surface.d.ts +39 -0
  64. package/src/core/geom/3d/tetrahedra/compute_tetrahedral_mesh_from_surface.d.ts.map +1 -0
  65. package/src/core/geom/3d/tetrahedra/compute_tetrahedral_mesh_from_surface.js +147 -0
  66. package/src/core/geom/3d/tetrahedra/compute_tetrahedron_quality.d.ts +15 -0
  67. package/src/core/geom/3d/tetrahedra/compute_tetrahedron_quality.d.ts.map +1 -0
  68. package/src/core/geom/3d/tetrahedra/compute_tetrahedron_quality.js +22 -0
  69. package/src/core/geom/3d/tetrahedra/prototype_tetrahedrize_mesh.d.ts +2 -0
  70. package/src/core/geom/3d/tetrahedra/prototype_tetrahedrize_mesh.d.ts.map +1 -0
  71. package/src/core/geom/3d/tetrahedra/prototype_tetrahedrize_mesh.js +671 -0
  72. package/src/core/geom/3d/tetrahedra/tetrahedral_mesh_build_vertex_to_tets_map.d.ts +28 -0
  73. package/src/core/geom/3d/tetrahedra/tetrahedral_mesh_build_vertex_to_tets_map.d.ts.map +1 -0
  74. package/src/core/geom/3d/tetrahedra/tetrahedral_mesh_build_vertex_to_tets_map.js +48 -0
  75. package/src/core/geom/3d/tetrahedra/tetrahedral_mesh_carve_outside_surface.d.ts +26 -0
  76. package/src/core/geom/3d/tetrahedra/tetrahedral_mesh_carve_outside_surface.d.ts.map +1 -0
  77. package/src/core/geom/3d/tetrahedra/tetrahedral_mesh_carve_outside_surface.js +222 -0
  78. package/src/core/geom/3d/tetrahedra/tetrahedral_mesh_find_tets_around_edge.d.ts +34 -0
  79. package/src/core/geom/3d/tetrahedra/tetrahedral_mesh_find_tets_around_edge.d.ts.map +1 -0
  80. package/src/core/geom/3d/tetrahedra/tetrahedral_mesh_find_tets_around_edge.js +146 -0
  81. package/src/core/geom/3d/tetrahedra/tetrahedral_mesh_flip_23.d.ts +36 -0
  82. package/src/core/geom/3d/tetrahedra/tetrahedral_mesh_flip_23.d.ts.map +1 -0
  83. package/src/core/geom/3d/tetrahedra/tetrahedral_mesh_flip_23.js +232 -0
  84. package/src/core/geom/3d/tetrahedra/tetrahedral_mesh_flip_32.d.ts +33 -0
  85. package/src/core/geom/3d/tetrahedra/tetrahedral_mesh_flip_32.d.ts.map +1 -0
  86. package/src/core/geom/3d/tetrahedra/tetrahedral_mesh_flip_32.js +255 -0
  87. package/src/core/geom/3d/tetrahedra/tetrahedral_mesh_improve_quality.d.ts +68 -0
  88. package/src/core/geom/3d/tetrahedra/tetrahedral_mesh_improve_quality.d.ts.map +1 -0
  89. package/src/core/geom/3d/tetrahedra/tetrahedral_mesh_improve_quality.js +387 -0
  90. package/src/core/geom/3d/tetrahedra/tetrahedral_mesh_smooth_vertex.d.ts +35 -0
  91. package/src/core/geom/3d/tetrahedra/tetrahedral_mesh_smooth_vertex.d.ts.map +1 -0
  92. package/src/core/geom/3d/tetrahedra/tetrahedral_mesh_smooth_vertex.js +140 -0
  93. package/src/core/geom/3d/tetrahedra/tetrahedral_mesh_vertex_is_boundary.d.ts +31 -0
  94. package/src/core/geom/3d/tetrahedra/tetrahedral_mesh_vertex_is_boundary.d.ts.map +1 -0
  95. package/src/core/geom/3d/tetrahedra/tetrahedral_mesh_vertex_is_boundary.js +97 -0
  96. package/src/core/geom/3d/tetrahedra/tetrahedron_compute_quality.d.ts +32 -0
  97. package/src/core/geom/3d/tetrahedra/tetrahedron_compute_quality.d.ts.map +1 -0
  98. package/src/core/geom/3d/tetrahedra/tetrahedron_compute_quality.js +66 -0
  99. package/src/core/geom/3d/topology/struct/binary/BinaryElementPool.d.ts +41 -0
  100. package/src/core/geom/3d/topology/struct/binary/BinaryElementPool.d.ts.map +1 -1
  101. package/src/core/geom/3d/topology/struct/binary/BinaryElementPool.js +124 -13
  102. package/src/core/geom/3d/topology/struct/binary/BinaryTopology.d.ts +134 -0
  103. package/src/core/geom/3d/topology/struct/binary/BinaryTopology.d.ts.map +1 -1
  104. package/src/core/geom/3d/topology/struct/binary/BinaryTopology.js +276 -3
  105. package/src/core/geom/3d/topology/struct/binary/io/bt_mesh_close_boundary_holes.d.ts +17 -0
  106. package/src/core/geom/3d/topology/struct/binary/io/bt_mesh_close_boundary_holes.d.ts.map +1 -0
  107. package/src/core/geom/3d/topology/struct/binary/io/bt_mesh_close_boundary_holes.js +135 -0
  108. package/src/core/geom/3d/topology/struct/binary/io/bt_mesh_compact.d.ts +14 -0
  109. package/src/core/geom/3d/topology/struct/binary/io/bt_mesh_compact.d.ts.map +1 -0
  110. package/src/core/geom/3d/topology/struct/binary/io/bt_mesh_compact.js +177 -0
  111. package/src/core/geom/3d/topology/struct/binary/io/bt_mesh_face_decouple.d.ts.map +1 -1
  112. package/src/core/geom/3d/topology/struct/binary/io/bt_mesh_face_decouple.js +20 -4
  113. package/src/core/geom/3d/topology/struct/binary/io/bt_mesh_simplify.d.ts.map +1 -1
  114. package/src/core/geom/3d/topology/struct/binary/io/bt_mesh_simplify.js +5 -3
  115. package/src/core/geom/3d/topology/struct/binary/io/edge/bt_edge_create.d.ts.map +1 -1
  116. package/src/core/geom/3d/topology/struct/binary/io/edge/bt_edge_create.js +9 -0
  117. package/src/core/geom/3d/topology/struct/binary/io/edge/bt_edge_get_or_create.d.ts.map +1 -1
  118. package/src/core/geom/3d/topology/struct/binary/io/edge/bt_edge_get_or_create.js +21 -45
  119. package/src/core/geom/3d/topology/struct/binary/io/edge/bt_edge_kill.d.ts.map +1 -1
  120. package/src/core/geom/3d/topology/struct/binary/io/edge/bt_edge_kill.js +7 -1
  121. package/src/core/geom/3d/topology/struct/binary/io/edge/bt_edge_kill_parallels.d.ts +8 -6
  122. package/src/core/geom/3d/topology/struct/binary/io/edge/bt_edge_kill_parallels.d.ts.map +1 -1
  123. package/src/core/geom/3d/topology/struct/binary/io/edge/bt_edge_kill_parallels.js +8 -6
  124. package/src/core/geom/3d/topology/struct/binary/io/edge/bt_mesh_kill_short_edges.d.ts +22 -0
  125. package/src/core/geom/3d/topology/struct/binary/io/edge/bt_mesh_kill_short_edges.d.ts.map +1 -0
  126. package/src/core/geom/3d/topology/struct/binary/io/edge/bt_mesh_kill_short_edges.js +73 -0
  127. package/src/core/geom/3d/topology/struct/binary/io/vertex/bt_vertex_replace.d.ts.map +1 -1
  128. package/src/core/geom/3d/topology/struct/binary/io/vertex/bt_vertex_replace.js +51 -1
  129. package/src/core/geom/3d/topology/struct/binary/query/bt_edge_get.d.ts +10 -0
  130. package/src/core/geom/3d/topology/struct/binary/query/bt_edge_get.d.ts.map +1 -0
  131. package/src/core/geom/3d/topology/struct/binary/query/bt_edge_get.js +42 -0
  132. package/src/core/geom/3d/topology/struct/binary/query/bt_mesh_sample_interior_grid_points.d.ts +28 -0
  133. package/src/core/geom/3d/topology/struct/binary/query/bt_mesh_sample_interior_grid_points.d.ts.map +1 -0
  134. package/src/core/geom/3d/topology/struct/binary/query/bt_mesh_sample_interior_grid_points.js +227 -0
  135. package/src/core/geom/3d/topology/struct/binary/query/bt_mesh_walk_boundary_loops.d.ts +13 -0
  136. package/src/core/geom/3d/topology/struct/binary/query/bt_mesh_walk_boundary_loops.d.ts.map +1 -0
  137. package/src/core/geom/3d/topology/struct/binary/query/bt_mesh_walk_boundary_loops.js +108 -0
  138. package/src/core/geom/3d/topology/struct/binary/query/bt_query_edge_is_boundary.d.ts +11 -0
  139. package/src/core/geom/3d/topology/struct/binary/query/bt_query_edge_is_boundary.d.ts.map +1 -0
  140. package/src/core/geom/3d/topology/struct/binary/query/bt_query_edge_is_boundary.js +20 -0
  141. package/src/core/geom/3d/triangle/triangle_mesh_compute_signed_volume.d.ts +20 -0
  142. package/src/core/geom/3d/triangle/triangle_mesh_compute_signed_volume.d.ts.map +1 -0
  143. package/src/core/geom/3d/triangle/triangle_mesh_compute_signed_volume.js +38 -0
  144. package/src/core/geom/3d/triangle/v3_compute_triangle_normal.d.ts +2 -2
  145. package/src/core/geom/3d/triangle/v3_compute_triangle_normal.d.ts.map +1 -1
  146. package/src/core/geom/3d/triangle/v3_compute_triangle_normal.js +1 -1
  147. package/src/core/geom/vec3/v3_dot_array_array.d.ts +3 -3
  148. package/src/core/geom/vec3/v3_dot_array_array.d.ts.map +1 -1
  149. package/src/core/geom/vec3/v3_dot_array_array.js +2 -2
  150. package/src/core/geom/vec3/v3_negate_array.d.ts +3 -3
  151. package/src/core/geom/vec3/v3_negate_array.d.ts.map +1 -1
  152. package/src/core/geom/vec3/v3_negate_array.js +2 -2
  153. package/src/core/geom/vec3/v3_quat3_apply.d.ts +29 -0
  154. package/src/core/geom/vec3/v3_quat3_apply.d.ts.map +1 -0
  155. package/src/core/geom/vec3/v3_quat3_apply.js +39 -0
  156. package/src/core/geom/vec3/v3_quat3_apply_inverse.d.ts +30 -0
  157. package/src/core/geom/vec3/v3_quat3_apply_inverse.d.ts.map +1 -0
  158. package/src/core/geom/vec3/v3_quat3_apply_inverse.js +41 -0
  159. package/src/core/geom/vec3/v3_triple_cross_product.d.ts +32 -0
  160. package/src/core/geom/vec3/v3_triple_cross_product.d.ts.map +1 -0
  161. package/src/core/geom/vec3/v3_triple_cross_product.js +45 -0
  162. package/src/core/graph/csr/CSRGraph.d.ts +168 -0
  163. package/src/core/graph/csr/CSRGraph.d.ts.map +1 -0
  164. package/src/core/graph/csr/CSRGraph.js +319 -0
  165. package/src/core/graph/metis/cluster_mesh_metis.d.ts +12 -0
  166. package/src/core/graph/metis/cluster_mesh_metis.d.ts.map +1 -1
  167. package/src/core/graph/metis/cluster_mesh_metis.js +12 -0
  168. package/src/core/graph/metis/metis.d.ts +19 -0
  169. package/src/core/graph/metis/metis.d.ts.map +1 -1
  170. package/src/core/graph/metis/metis.js +20 -0
  171. package/src/core/graph/metis/metis_cluster_bs.d.ts +11 -0
  172. package/src/core/graph/metis/metis_cluster_bs.d.ts.map +1 -1
  173. package/src/core/graph/metis/metis_cluster_bs.js +11 -0
  174. package/src/core/graph/metis/metis_options.d.ts +17 -2
  175. package/src/core/graph/metis/metis_options.d.ts.map +1 -1
  176. package/src/core/graph/metis/metis_options.js +17 -2
  177. package/src/core/graph/metis/native/MetisGraph.d.ts +144 -0
  178. package/src/core/graph/metis/native/MetisGraph.d.ts.map +1 -0
  179. package/src/core/graph/metis/native/MetisGraph.js +212 -0
  180. package/src/core/graph/metis/native/bisection/BisectionScratch.d.ts +72 -0
  181. package/src/core/graph/metis/native/bisection/BisectionScratch.d.ts.map +1 -0
  182. package/src/core/graph/metis/native/bisection/BisectionScratch.js +101 -0
  183. package/src/core/graph/metis/native/bisection/bisect_graph.d.ts +37 -0
  184. package/src/core/graph/metis/native/bisection/bisect_graph.d.ts.map +1 -0
  185. package/src/core/graph/metis/native/bisection/bisect_graph.js +100 -0
  186. package/src/core/graph/metis/native/bisection/compute_2way_params.d.ts +15 -0
  187. package/src/core/graph/metis/native/bisection/compute_2way_params.d.ts.map +1 -0
  188. package/src/core/graph/metis/native/bisection/compute_2way_params.js +84 -0
  189. package/src/core/graph/metis/native/bisection/fm_2way.d.ts +30 -0
  190. package/src/core/graph/metis/native/bisection/fm_2way.d.ts.map +1 -0
  191. package/src/core/graph/metis/native/bisection/fm_2way.js +290 -0
  192. package/src/core/graph/metis/native/bisection/grow_bisection.d.ts +23 -0
  193. package/src/core/graph/metis/native/bisection/grow_bisection.d.ts.map +1 -0
  194. package/src/core/graph/metis/native/bisection/grow_bisection.js +137 -0
  195. package/src/core/graph/metis/native/bisection/split_graph_two_way.d.ts +28 -0
  196. package/src/core/graph/metis/native/bisection/split_graph_two_way.d.ts.map +1 -0
  197. package/src/core/graph/metis/native/bisection/split_graph_two_way.js +119 -0
  198. package/src/core/graph/metis/native/coarsen/coarsen_graph.d.ts +20 -0
  199. package/src/core/graph/metis/native/coarsen/coarsen_graph.d.ts.map +1 -0
  200. package/src/core/graph/metis/native/coarsen/coarsen_graph.js +94 -0
  201. package/src/core/graph/metis/native/coarsen/create_coarse_graph.d.ts +24 -0
  202. package/src/core/graph/metis/native/coarsen/create_coarse_graph.d.ts.map +1 -0
  203. package/src/core/graph/metis/native/coarsen/create_coarse_graph.js +158 -0
  204. package/src/core/graph/metis/native/coarsen/match_shem.d.ts +41 -0
  205. package/src/core/graph/metis/native/coarsen/match_shem.d.ts.map +1 -0
  206. package/src/core/graph/metis/native/coarsen/match_shem.js +175 -0
  207. package/src/core/graph/metis/native/initial/initial_kway_bfs.d.ts +24 -0
  208. package/src/core/graph/metis/native/initial/initial_kway_bfs.d.ts.map +1 -0
  209. package/src/core/graph/metis/native/initial/initial_kway_bfs.js +122 -0
  210. package/src/core/graph/metis/native/initial/initial_kway_recursive_bisection.d.ts +29 -0
  211. package/src/core/graph/metis/native/initial/initial_kway_recursive_bisection.d.ts.map +1 -0
  212. package/src/core/graph/metis/native/initial/initial_kway_recursive_bisection.js +170 -0
  213. package/src/core/graph/metis/native/metis_partition_kway.d.ts +41 -0
  214. package/src/core/graph/metis/native/metis_partition_kway.d.ts.map +1 -0
  215. package/src/core/graph/metis/native/metis_partition_kway.js +126 -0
  216. package/src/core/graph/metis/native/refine/IndexedFloatMaxHeap.d.ts +62 -0
  217. package/src/core/graph/metis/native/refine/IndexedFloatMaxHeap.d.ts.map +1 -0
  218. package/src/core/graph/metis/native/refine/IndexedFloatMaxHeap.js +261 -0
  219. package/src/core/graph/metis/native/refine/RefinementScratch.d.ts +45 -0
  220. package/src/core/graph/metis/native/refine/RefinementScratch.d.ts.map +1 -0
  221. package/src/core/graph/metis/native/refine/RefinementScratch.js +53 -0
  222. package/src/core/graph/metis/native/refine/compute_kway_params.d.ts +18 -0
  223. package/src/core/graph/metis/native/refine/compute_kway_params.d.ts.map +1 -0
  224. package/src/core/graph/metis/native/refine/compute_kway_params.js +138 -0
  225. package/src/core/graph/metis/native/refine/fm_kway.d.ts +63 -0
  226. package/src/core/graph/metis/native/refine/fm_kway.d.ts.map +1 -0
  227. package/src/core/graph/metis/native/refine/fm_kway.js +462 -0
  228. package/src/core/graph/metis/native/refine/project_kway.d.ts +22 -0
  229. package/src/core/graph/metis/native/refine/project_kway.d.ts.map +1 -0
  230. package/src/core/graph/metis/native/refine/project_kway.js +43 -0
  231. package/src/core/graph/metis/native/refine/refine_kway.d.ts +34 -0
  232. package/src/core/graph/metis/native/refine/refine_kway.d.ts.map +1 -0
  233. package/src/core/graph/metis/native/refine/refine_kway.js +43 -0
  234. package/src/core/math/linalg/eigen/matrix_householder_in_place.d.ts +2 -2
  235. package/src/core/math/linalg/eigen/matrix_householder_in_place.js +2 -2
  236. package/src/core/math/linalg/eigen/matrix_qr_in_place.d.ts +6 -4
  237. package/src/core/math/linalg/eigen/matrix_qr_in_place.d.ts.map +1 -1
  238. package/src/core/math/linalg/eigen/matrix_qr_in_place.js +69 -23
  239. package/src/engine/EngineHarness.d.ts +3 -1
  240. package/src/engine/EngineHarness.d.ts.map +1 -1
  241. package/src/engine/EngineHarness.js +3 -0
  242. package/src/engine/control/first-person/DESIGN.md +30 -6
  243. package/src/engine/control/first-person/DESIGN_EXTENSIONS.md +563 -0
  244. package/src/engine/control/first-person/FirstPersonPlayerController.d.ts +115 -9
  245. package/src/engine/control/first-person/FirstPersonPlayerController.d.ts.map +1 -1
  246. package/src/engine/control/first-person/FirstPersonPlayerController.js +211 -176
  247. package/src/engine/control/first-person/FirstPersonPlayerControllerConfig.d.ts +601 -8
  248. package/src/engine/control/first-person/FirstPersonPlayerControllerConfig.d.ts.map +1 -1
  249. package/src/engine/control/first-person/FirstPersonPlayerControllerConfig.js +349 -8
  250. package/src/engine/control/first-person/FirstPersonPlayerControllerSystem.d.ts +319 -23
  251. package/src/engine/control/first-person/FirstPersonPlayerControllerSystem.d.ts.map +1 -1
  252. package/src/engine/control/first-person/FirstPersonPlayerControllerSystem.js +1789 -799
  253. package/src/engine/control/first-person/TODO.md +173 -0
  254. package/src/engine/control/first-person/abilities/Ability.d.ts +101 -0
  255. package/src/engine/control/first-person/abilities/Ability.d.ts.map +1 -0
  256. package/src/engine/control/first-person/abilities/Ability.js +119 -0
  257. package/src/engine/control/first-person/abilities/AbilitySet.d.ts +86 -0
  258. package/src/engine/control/first-person/abilities/AbilitySet.d.ts.map +1 -0
  259. package/src/engine/control/first-person/abilities/AbilitySet.js +185 -0
  260. package/src/engine/control/first-person/abilities/LedgeGrab.d.ts +62 -0
  261. package/src/engine/control/first-person/abilities/LedgeGrab.d.ts.map +1 -0
  262. package/src/engine/control/first-person/abilities/LedgeGrab.js +199 -0
  263. package/src/engine/control/first-person/abilities/Mantle.d.ts +45 -0
  264. package/src/engine/control/first-person/abilities/Mantle.d.ts.map +1 -0
  265. package/src/engine/control/first-person/abilities/Mantle.js +188 -0
  266. package/src/engine/control/first-person/abilities/Slide.d.ts +33 -0
  267. package/src/engine/control/first-person/abilities/Slide.d.ts.map +1 -0
  268. package/src/engine/control/first-person/abilities/Slide.js +166 -0
  269. package/src/engine/control/first-person/abilities/WallJump.d.ts +45 -0
  270. package/src/engine/control/first-person/abilities/WallJump.d.ts.map +1 -0
  271. package/src/engine/control/first-person/abilities/WallJump.js +131 -0
  272. package/src/engine/control/first-person/abilities/WallRun.d.ts +44 -0
  273. package/src/engine/control/first-person/abilities/WallRun.d.ts.map +1 -0
  274. package/src/engine/control/first-person/abilities/WallRun.js +180 -0
  275. package/src/engine/control/first-person/composer/EyeOffsetStack.d.ts +49 -0
  276. package/src/engine/control/first-person/composer/EyeOffsetStack.d.ts.map +1 -0
  277. package/src/engine/control/first-person/composer/EyeOffsetStack.js +60 -0
  278. package/src/engine/control/first-person/mastery/BreathRhythmEvaluator.d.ts +100 -0
  279. package/src/engine/control/first-person/mastery/BreathRhythmEvaluator.d.ts.map +1 -0
  280. package/src/engine/control/first-person/mastery/BreathRhythmEvaluator.js +133 -0
  281. package/src/engine/control/first-person/mastery/DecisionPoint.d.ts +10 -0
  282. package/src/engine/control/first-person/mastery/DecisionPoint.d.ts.map +1 -0
  283. package/src/engine/control/first-person/mastery/DecisionPoint.js +30 -0
  284. package/src/engine/control/first-person/mastery/FootAsymmetryTurnEvaluator.d.ts +61 -0
  285. package/src/engine/control/first-person/mastery/FootAsymmetryTurnEvaluator.d.ts.map +1 -0
  286. package/src/engine/control/first-person/mastery/FootAsymmetryTurnEvaluator.js +109 -0
  287. package/src/engine/control/first-person/mastery/MasteryEvaluator.d.ts +40 -0
  288. package/src/engine/control/first-person/mastery/MasteryEvaluator.d.ts.map +1 -0
  289. package/src/engine/control/first-person/mastery/MasteryEvaluator.js +45 -0
  290. package/src/engine/control/first-person/mastery/MasteryScore.d.ts +68 -0
  291. package/src/engine/control/first-person/mastery/MasteryScore.d.ts.map +1 -0
  292. package/src/engine/control/first-person/mastery/MasteryScore.js +100 -0
  293. package/src/engine/control/first-person/mastery/MasterySet.d.ts +60 -0
  294. package/src/engine/control/first-person/mastery/MasterySet.d.ts.map +1 -0
  295. package/src/engine/control/first-person/mastery/MasterySet.js +86 -0
  296. package/src/engine/control/first-person/mastery/SlideInitiationTimingEvaluator.d.ts +58 -0
  297. package/src/engine/control/first-person/mastery/SlideInitiationTimingEvaluator.d.ts.map +1 -0
  298. package/src/engine/control/first-person/mastery/SlideInitiationTimingEvaluator.js +83 -0
  299. package/src/engine/control/first-person/mastery/StrideTimingJumpEvaluator.d.ts +69 -0
  300. package/src/engine/control/first-person/mastery/StrideTimingJumpEvaluator.d.ts.map +1 -0
  301. package/src/engine/control/first-person/mastery/StrideTimingJumpEvaluator.js +109 -0
  302. package/src/engine/control/first-person/math/Spring.d.ts +56 -0
  303. package/src/engine/control/first-person/math/Spring.d.ts.map +1 -0
  304. package/src/engine/control/first-person/math/Spring.js +71 -0
  305. package/src/engine/control/first-person/math/computeLRCBreathRate.d.ts +26 -0
  306. package/src/engine/control/first-person/math/computeLRCBreathRate.d.ts.map +1 -0
  307. package/src/engine/control/first-person/math/computeLRCBreathRate.js +41 -0
  308. package/src/engine/control/first-person/math/computeMassRatios.d.ts +35 -0
  309. package/src/engine/control/first-person/math/computeMassRatios.d.ts.map +1 -0
  310. package/src/engine/control/first-person/math/computeMassRatios.js +44 -0
  311. package/src/engine/control/first-person/pose/FirstPersonPose.d.ts +31 -1
  312. package/src/engine/control/first-person/pose/FirstPersonPose.d.ts.map +1 -1
  313. package/src/engine/control/first-person/pose/FirstPersonPose.js +49 -3
  314. package/src/engine/control/first-person/pose/FirstPersonPosture.d.ts +7 -0
  315. package/src/engine/control/first-person/pose/FirstPersonPosture.d.ts.map +1 -0
  316. package/src/engine/control/first-person/pose/FirstPersonPosture.js +27 -0
  317. package/src/engine/control/first-person/prototype_first_person_controller.js +637 -120
  318. package/src/engine/control/first-person/sensors/FirstPersonSensors.d.ts +58 -0
  319. package/src/engine/control/first-person/sensors/FirstPersonSensors.d.ts.map +1 -0
  320. package/src/engine/control/first-person/sensors/FirstPersonSensors.js +77 -0
  321. package/src/engine/control/first-person/sensors/FirstPersonSensorsSystem.d.ts +80 -0
  322. package/src/engine/control/first-person/sensors/FirstPersonSensorsSystem.d.ts.map +1 -0
  323. package/src/engine/control/first-person/sensors/FirstPersonSensorsSystem.js +196 -0
  324. package/src/engine/control/first-person/test/buildTestPlayer.d.ts +20 -0
  325. package/src/engine/control/first-person/test/buildTestPlayer.d.ts.map +1 -0
  326. package/src/engine/control/first-person/test/buildTestPlayer.js +36 -0
  327. package/src/engine/graphics/camera/testClippingPlaneComputation.js +0 -2
  328. package/src/engine/graphics/ecs/light/Light.d.ts.map +1 -1
  329. package/src/engine/graphics/ecs/light/Light.js +27 -0
  330. package/src/engine/graphics/ecs/light/LightSystem.js +1 -1
  331. package/src/engine/graphics/ecs/path/PathDisplaySystem.d.ts.map +1 -1
  332. package/src/engine/graphics/ecs/path/testPathDisplaySystem.js +0 -2
  333. package/src/engine/graphics/ecs/path/tube/prototypeAnimatedPathMask.js +0 -2
  334. package/src/engine/graphics/geometry/CapsuleGeometry.d.ts +42 -0
  335. package/src/engine/graphics/geometry/CapsuleGeometry.d.ts.map +1 -0
  336. package/src/engine/graphics/geometry/CapsuleGeometry.js +171 -0
  337. package/src/engine/graphics/render/buffer/buffers/prototypeNormalFrameBuffer.js +0 -2
  338. package/src/engine/graphics/render/forward_plus/plugin/ptototypeFPPlugin.js +0 -2
  339. package/src/engine/graphics/render/visibility/hiz/prototypeHiZ.js +0 -2
  340. package/src/engine/navigation/grid/find_path_on_grid_astar.d.ts.map +1 -1
  341. package/src/engine/navigation/grid/find_path_on_grid_astar.js +11 -2
  342. package/src/engine/navigation/mesh/bt_mesh_face_find_path.d.ts.map +1 -1
  343. package/src/engine/navigation/mesh/bt_mesh_face_find_path.js +11 -1
  344. package/src/engine/physics/BULLET_REVIEW.md +945 -0
  345. package/src/engine/physics/CANNON_REVIEW.md +1300 -0
  346. package/src/engine/physics/JOLT_REVIEW.md +913 -0
  347. package/src/engine/physics/PLAN.md +461 -0
  348. package/src/engine/physics/RAPIER_REVIEW.md +934 -0
  349. package/src/engine/physics/REVIEW_001_ACTION_PLAN.md +642 -0
  350. package/src/engine/physics/body/BodyStorage.d.ts +187 -0
  351. package/src/engine/physics/body/BodyStorage.d.ts.map +1 -0
  352. package/src/engine/physics/body/BodyStorage.js +427 -0
  353. package/src/engine/physics/broadphase/PairList.d.ts +62 -0
  354. package/src/engine/physics/broadphase/PairList.d.ts.map +1 -0
  355. package/src/engine/physics/broadphase/PairList.js +97 -0
  356. package/src/engine/physics/broadphase/compute_fat_world_aabb.d.ts +16 -0
  357. package/src/engine/physics/broadphase/compute_fat_world_aabb.d.ts.map +1 -0
  358. package/src/engine/physics/broadphase/compute_fat_world_aabb.js +61 -0
  359. package/src/engine/physics/broadphase/generate_pairs.d.ts +38 -0
  360. package/src/engine/physics/broadphase/generate_pairs.d.ts.map +1 -0
  361. package/src/engine/physics/broadphase/generate_pairs.js +101 -0
  362. package/src/engine/physics/contact/ManifoldStore.d.ts +299 -0
  363. package/src/engine/physics/contact/ManifoldStore.d.ts.map +1 -0
  364. package/src/engine/physics/contact/ManifoldStore.js +608 -0
  365. package/src/engine/physics/ecs/BodyKind.d.ts +23 -0
  366. package/src/engine/physics/ecs/BodyKind.d.ts.map +1 -0
  367. package/src/engine/physics/ecs/BodyKind.js +24 -0
  368. package/src/engine/physics/ecs/Collider.d.ts +98 -0
  369. package/src/engine/physics/ecs/Collider.d.ts.map +1 -0
  370. package/src/engine/physics/ecs/Collider.js +136 -0
  371. package/src/engine/physics/ecs/ColliderFlags.d.ts +14 -0
  372. package/src/engine/physics/ecs/ColliderFlags.d.ts.map +1 -0
  373. package/src/engine/physics/ecs/ColliderFlags.js +15 -0
  374. package/src/engine/physics/ecs/ColliderObserverSystem.d.ts +58 -0
  375. package/src/engine/physics/ecs/ColliderObserverSystem.d.ts.map +1 -0
  376. package/src/engine/physics/ecs/ColliderObserverSystem.js +103 -0
  377. package/src/engine/physics/ecs/ColliderSerializationAdapter.d.ts +25 -0
  378. package/src/engine/physics/ecs/ColliderSerializationAdapter.d.ts.map +1 -0
  379. package/src/engine/physics/ecs/ColliderSerializationAdapter.js +37 -0
  380. package/src/engine/physics/ecs/PhysicsEvents.d.ts +15 -0
  381. package/src/engine/physics/ecs/PhysicsEvents.d.ts.map +1 -0
  382. package/src/engine/physics/ecs/PhysicsEvents.js +16 -0
  383. package/src/engine/physics/ecs/PhysicsSystem.d.ts +628 -0
  384. package/src/engine/physics/ecs/PhysicsSystem.d.ts.map +1 -0
  385. package/src/engine/physics/ecs/PhysicsSystem.js +1301 -0
  386. package/src/engine/physics/ecs/RigidBody.d.ts +197 -0
  387. package/src/engine/physics/ecs/RigidBody.d.ts.map +1 -0
  388. package/src/engine/physics/ecs/RigidBody.js +240 -0
  389. package/src/engine/physics/ecs/RigidBodyFlags.d.ts +21 -0
  390. package/src/engine/physics/ecs/RigidBodyFlags.d.ts.map +1 -0
  391. package/src/engine/physics/ecs/RigidBodyFlags.js +22 -0
  392. package/src/engine/physics/ecs/RigidBodySerializationAdapter.d.ts +28 -0
  393. package/src/engine/physics/ecs/RigidBodySerializationAdapter.d.ts.map +1 -0
  394. package/src/engine/physics/ecs/RigidBodySerializationAdapter.js +81 -0
  395. package/src/engine/physics/ecs/SleepState.d.ts +11 -0
  396. package/src/engine/physics/ecs/SleepState.d.ts.map +1 -0
  397. package/src/engine/physics/ecs/SleepState.js +12 -0
  398. package/src/engine/physics/events/ContactEventBuffer.d.ts +46 -0
  399. package/src/engine/physics/events/ContactEventBuffer.d.ts.map +1 -0
  400. package/src/engine/physics/events/ContactEventBuffer.js +83 -0
  401. package/src/engine/physics/events/diff_manifolds.d.ts +25 -0
  402. package/src/engine/physics/events/diff_manifolds.d.ts.map +1 -0
  403. package/src/engine/physics/events/diff_manifolds.js +50 -0
  404. package/src/engine/physics/fluid/FluidField.d.ts +294 -16
  405. package/src/engine/physics/fluid/FluidField.d.ts.map +1 -1
  406. package/src/engine/physics/fluid/FluidField.js +510 -66
  407. package/src/engine/physics/fluid/FluidSimulator.d.ts +188 -5
  408. package/src/engine/physics/fluid/FluidSimulator.d.ts.map +1 -1
  409. package/src/engine/physics/fluid/FluidSimulator.js +456 -95
  410. package/src/engine/physics/fluid/SliceVisualiser.d.ts +29 -6
  411. package/src/engine/physics/fluid/SliceVisualiser.d.ts.map +1 -1
  412. package/src/engine/physics/fluid/SliceVisualiser.js +190 -165
  413. package/src/engine/physics/fluid/ecs/FluidComponent.d.ts +154 -0
  414. package/src/engine/physics/fluid/ecs/FluidComponent.d.ts.map +1 -0
  415. package/src/engine/physics/fluid/ecs/FluidComponent.js +238 -0
  416. package/src/engine/physics/fluid/ecs/FluidEffectorsComponent.d.ts +45 -0
  417. package/src/engine/physics/fluid/ecs/FluidEffectorsComponent.d.ts.map +1 -0
  418. package/src/engine/physics/fluid/ecs/FluidEffectorsComponent.js +89 -0
  419. package/src/engine/physics/fluid/ecs/FluidSystem.d.ts +107 -0
  420. package/src/engine/physics/fluid/ecs/FluidSystem.d.ts.map +1 -0
  421. package/src/engine/physics/fluid/ecs/FluidSystem.js +278 -0
  422. package/src/engine/physics/fluid/effector/AbstractFluidEffector.d.ts +62 -1
  423. package/src/engine/physics/fluid/effector/AbstractFluidEffector.d.ts.map +1 -1
  424. package/src/engine/physics/fluid/effector/AbstractFluidEffector.js +81 -6
  425. package/src/engine/physics/fluid/effector/GlobalFluidEffector.d.ts +17 -4
  426. package/src/engine/physics/fluid/effector/GlobalFluidEffector.d.ts.map +1 -1
  427. package/src/engine/physics/fluid/effector/GlobalFluidEffector.js +105 -12
  428. package/src/engine/physics/fluid/effector/ImpulseFluidEffector.d.ts +43 -0
  429. package/src/engine/physics/fluid/effector/ImpulseFluidEffector.d.ts.map +1 -0
  430. package/src/engine/physics/fluid/effector/ImpulseFluidEffector.js +210 -0
  431. package/src/engine/physics/fluid/effector/WakeFluidEffector.d.ts +62 -1
  432. package/src/engine/physics/fluid/effector/WakeFluidEffector.d.ts.map +1 -1
  433. package/src/engine/physics/fluid/effector/WakeFluidEffector.js +302 -8
  434. package/src/engine/physics/fluid/prototype.js +102 -91
  435. package/src/engine/physics/fluid/solver/optimal_sor_omega.d.ts +33 -0
  436. package/src/engine/physics/fluid/solver/optimal_sor_omega.d.ts.map +1 -0
  437. package/src/engine/physics/fluid/solver/optimal_sor_omega.js +41 -0
  438. package/src/engine/physics/fluid/solver/v3_grid_apply_advection_forward.d.ts +20 -5
  439. package/src/engine/physics/fluid/solver/v3_grid_apply_advection_forward.d.ts.map +1 -1
  440. package/src/engine/physics/fluid/solver/v3_grid_apply_advection_forward.js +60 -38
  441. package/src/engine/physics/fluid/solver/v3_grid_apply_diffusion.d.ts +25 -4
  442. package/src/engine/physics/fluid/solver/v3_grid_apply_diffusion.d.ts.map +1 -1
  443. package/src/engine/physics/fluid/solver/v3_grid_apply_diffusion.js +93 -73
  444. package/src/engine/physics/fluid/solver/v3_grid_apply_scalar_advection.d.ts +23 -0
  445. package/src/engine/physics/fluid/solver/v3_grid_apply_scalar_advection.d.ts.map +1 -0
  446. package/src/engine/physics/fluid/solver/v3_grid_apply_scalar_advection.js +60 -0
  447. package/src/engine/physics/fluid/solver/v3_grid_compute_divergence.d.ts +23 -0
  448. package/src/engine/physics/fluid/solver/v3_grid_compute_divergence.d.ts.map +1 -0
  449. package/src/engine/physics/fluid/solver/v3_grid_compute_divergence.js +68 -0
  450. package/src/engine/physics/fluid/solver/v3_grid_compute_solid_neighbour_mask.d.ts +30 -0
  451. package/src/engine/physics/fluid/solver/v3_grid_compute_solid_neighbour_mask.d.ts.map +1 -0
  452. package/src/engine/physics/fluid/solver/v3_grid_compute_solid_neighbour_mask.js +66 -0
  453. package/src/engine/physics/fluid/solver/v3_grid_patch_edges_uniform.d.ts +26 -0
  454. package/src/engine/physics/fluid/solver/v3_grid_patch_edges_uniform.d.ts.map +1 -0
  455. package/src/engine/physics/fluid/solver/v3_grid_patch_edges_uniform.js +113 -0
  456. package/src/engine/physics/fluid/solver/v3_grid_shift_in_place.d.ts +30 -0
  457. package/src/engine/physics/fluid/solver/v3_grid_shift_in_place.d.ts.map +1 -0
  458. package/src/engine/physics/fluid/solver/v3_grid_shift_in_place.js +107 -0
  459. package/src/engine/physics/fluid/solver/v3_grid_solve_pressure.d.ts +49 -0
  460. package/src/engine/physics/fluid/solver/v3_grid_solve_pressure.d.ts.map +1 -0
  461. package/src/engine/physics/fluid/solver/v3_grid_solve_pressure.js +126 -0
  462. package/src/engine/physics/fluid/solver/v3_grid_solve_pressure_pcg.d.ts +93 -0
  463. package/src/engine/physics/fluid/solver/v3_grid_solve_pressure_pcg.d.ts.map +1 -0
  464. package/src/engine/physics/fluid/solver/v3_grid_solve_pressure_pcg.js +424 -0
  465. package/src/engine/physics/fluid/solver/v3_grid_subtract_pressure_gradient.d.ts +48 -0
  466. package/src/engine/physics/fluid/solver/v3_grid_subtract_pressure_gradient.d.ts.map +1 -0
  467. package/src/engine/physics/fluid/solver/v3_grid_subtract_pressure_gradient.js +92 -0
  468. package/src/engine/physics/gjk/expanding_polytope_algorithm.d.ts +6 -6
  469. package/src/engine/physics/gjk/expanding_polytope_algorithm.d.ts.map +1 -1
  470. package/src/engine/physics/gjk/expanding_polytope_algorithm.js +76 -32
  471. package/src/engine/physics/gjk/gjk.d.ts +28 -2
  472. package/src/engine/physics/gjk/gjk.d.ts.map +1 -1
  473. package/src/engine/physics/gjk/gjk.js +421 -378
  474. package/src/engine/physics/gjk/minkowski_support.d.ts +37 -0
  475. package/src/engine/physics/gjk/minkowski_support.d.ts.map +1 -0
  476. package/src/engine/physics/gjk/minkowski_support.js +75 -0
  477. package/src/engine/physics/gjk/mpr.d.ts +56 -0
  478. package/src/engine/physics/gjk/mpr.d.ts.map +1 -0
  479. package/src/engine/physics/gjk/mpr.js +344 -0
  480. package/src/engine/physics/inertia/world_inverse_inertia.d.ts +44 -0
  481. package/src/engine/physics/inertia/world_inverse_inertia.d.ts.map +1 -0
  482. package/src/engine/physics/inertia/world_inverse_inertia.js +77 -0
  483. package/src/engine/physics/integration/integrate_position.d.ts +34 -0
  484. package/src/engine/physics/integration/integrate_position.d.ts.map +1 -0
  485. package/src/engine/physics/integration/integrate_position.js +79 -0
  486. package/src/engine/physics/integration/integrate_velocity.d.ts +55 -0
  487. package/src/engine/physics/integration/integrate_velocity.d.ts.map +1 -0
  488. package/src/engine/physics/integration/integrate_velocity.js +160 -0
  489. package/src/engine/physics/integration/quat_integrate.d.ts +27 -0
  490. package/src/engine/physics/integration/quat_integrate.d.ts.map +1 -0
  491. package/src/engine/physics/integration/quat_integrate.js +62 -0
  492. package/src/engine/physics/island/IslandBuilder.d.ts +167 -0
  493. package/src/engine/physics/island/IslandBuilder.d.ts.map +1 -0
  494. package/src/engine/physics/island/IslandBuilder.js +411 -0
  495. package/src/engine/physics/island/union_find.d.ts +51 -0
  496. package/src/engine/physics/island/union_find.d.ts.map +1 -0
  497. package/src/engine/physics/island/union_find.js +76 -0
  498. package/src/engine/physics/narrowphase/PosedShape.d.ts +51 -0
  499. package/src/engine/physics/narrowphase/PosedShape.d.ts.map +1 -0
  500. package/src/engine/physics/narrowphase/PosedShape.js +108 -0
  501. package/src/engine/physics/narrowphase/box_box_manifold.d.ts +32 -0
  502. package/src/engine/physics/narrowphase/box_box_manifold.d.ts.map +1 -0
  503. package/src/engine/physics/narrowphase/box_box_manifold.js +639 -0
  504. package/src/engine/physics/narrowphase/box_triangle_contact.d.ts +30 -0
  505. package/src/engine/physics/narrowphase/box_triangle_contact.d.ts.map +1 -0
  506. package/src/engine/physics/narrowphase/box_triangle_contact.js +811 -0
  507. package/src/engine/physics/narrowphase/capsule_contacts.d.ts +122 -0
  508. package/src/engine/physics/narrowphase/capsule_contacts.d.ts.map +1 -0
  509. package/src/engine/physics/narrowphase/capsule_contacts.js +462 -0
  510. package/src/engine/physics/narrowphase/capsule_triangle_contact.d.ts +71 -0
  511. package/src/engine/physics/narrowphase/capsule_triangle_contact.d.ts.map +1 -0
  512. package/src/engine/physics/narrowphase/capsule_triangle_contact.js +375 -0
  513. package/src/engine/physics/narrowphase/compute_penetration.d.ts +91 -0
  514. package/src/engine/physics/narrowphase/compute_penetration.d.ts.map +1 -0
  515. package/src/engine/physics/narrowphase/compute_penetration.js +396 -0
  516. package/src/engine/physics/narrowphase/decomposition/aabb_world_to_local.d.ts +35 -0
  517. package/src/engine/physics/narrowphase/decomposition/aabb_world_to_local.d.ts.map +1 -0
  518. package/src/engine/physics/narrowphase/decomposition/aabb_world_to_local.js +80 -0
  519. package/src/engine/physics/narrowphase/decomposition/decompose_to_triangles.d.ts +31 -0
  520. package/src/engine/physics/narrowphase/decomposition/decompose_to_triangles.d.ts.map +1 -0
  521. package/src/engine/physics/narrowphase/decomposition/decompose_to_triangles.js +55 -0
  522. package/src/engine/physics/narrowphase/decomposition/heightmap_enumerate_triangles.d.ts +42 -0
  523. package/src/engine/physics/narrowphase/decomposition/heightmap_enumerate_triangles.d.ts.map +1 -0
  524. package/src/engine/physics/narrowphase/decomposition/heightmap_enumerate_triangles.js +204 -0
  525. package/src/engine/physics/narrowphase/decomposition/mesh_enumerate_triangles.d.ts +42 -0
  526. package/src/engine/physics/narrowphase/decomposition/mesh_enumerate_triangles.d.ts.map +1 -0
  527. package/src/engine/physics/narrowphase/decomposition/mesh_enumerate_triangles.js +94 -0
  528. package/src/engine/physics/narrowphase/decomposition/triangle_buffer_layout.d.ts +37 -0
  529. package/src/engine/physics/narrowphase/decomposition/triangle_buffer_layout.d.ts.map +1 -0
  530. package/src/engine/physics/narrowphase/decomposition/triangle_buffer_layout.js +37 -0
  531. package/src/engine/physics/narrowphase/narrowphase_step.d.ts +17 -0
  532. package/src/engine/physics/narrowphase/narrowphase_step.d.ts.map +1 -0
  533. package/src/engine/physics/narrowphase/narrowphase_step.js +1422 -0
  534. package/src/engine/physics/narrowphase/sphere_box_contact.d.ts +38 -0
  535. package/src/engine/physics/narrowphase/sphere_box_contact.d.ts.map +1 -0
  536. package/src/engine/physics/narrowphase/sphere_box_contact.js +123 -0
  537. package/src/engine/physics/narrowphase/sphere_sphere_contact.d.ts +26 -0
  538. package/src/engine/physics/narrowphase/sphere_sphere_contact.d.ts.map +1 -0
  539. package/src/engine/physics/narrowphase/sphere_sphere_contact.js +51 -0
  540. package/src/engine/physics/narrowphase/sphere_triangle_contact.d.ts +48 -0
  541. package/src/engine/physics/narrowphase/sphere_triangle_contact.d.ts.map +1 -0
  542. package/src/engine/physics/narrowphase/sphere_triangle_contact.js +143 -0
  543. package/src/engine/physics/queries/PhysicsSurfacePoint.d.ts +83 -0
  544. package/src/engine/physics/queries/PhysicsSurfacePoint.d.ts.map +1 -0
  545. package/src/engine/physics/queries/PhysicsSurfacePoint.js +100 -0
  546. package/src/engine/physics/queries/overlap_shape.d.ts +51 -0
  547. package/src/engine/physics/queries/overlap_shape.d.ts.map +1 -0
  548. package/src/engine/physics/queries/overlap_shape.js +183 -0
  549. package/src/engine/physics/queries/raycast.d.ts +20 -0
  550. package/src/engine/physics/queries/raycast.d.ts.map +1 -0
  551. package/src/engine/physics/queries/raycast.js +249 -0
  552. package/src/engine/physics/queries/shape_cast.d.ts +56 -0
  553. package/src/engine/physics/queries/shape_cast.d.ts.map +1 -0
  554. package/src/engine/physics/queries/shape_cast.js +387 -0
  555. package/src/engine/physics/solver/friction_cone.d.ts +16 -0
  556. package/src/engine/physics/solver/friction_cone.d.ts.map +1 -0
  557. package/src/engine/physics/solver/friction_cone.js +37 -0
  558. package/src/engine/physics/solver/solve_contacts.d.ts +122 -0
  559. package/src/engine/physics/solver/solve_contacts.d.ts.map +1 -0
  560. package/src/engine/physics/solver/solve_contacts.js +1016 -0
  561. package/src/core/geom/3d/topology/struct/binary/io/edge/OrderedEdge.d.ts +0 -34
  562. package/src/core/geom/3d/topology/struct/binary/io/edge/OrderedEdge.d.ts.map +0 -1
  563. package/src/core/geom/3d/topology/struct/binary/io/edge/OrderedEdge.js +0 -66
  564. package/src/core/geom/3d/topology/struct/binary/io/edge/bt_mesh_calc_edges.d.ts +0 -2
  565. package/src/core/geom/3d/topology/struct/binary/io/edge/bt_mesh_calc_edges.d.ts.map +0 -1
  566. package/src/core/geom/3d/topology/struct/binary/io/edge/bt_mesh_calc_edges.js +0 -54
  567. package/src/core/geom/3d/topology/struct/binary/io/edge/get_or_create_edge_map.d.ts +0 -2
  568. package/src/core/geom/3d/topology/struct/binary/io/edge/get_or_create_edge_map.d.ts.map +0 -1
  569. package/src/core/geom/3d/topology/struct/binary/io/edge/get_or_create_edge_map.js +0 -26
  570. package/src/engine/ecs/components/Motion.d.ts +0 -21
  571. package/src/engine/ecs/components/Motion.d.ts.map +0 -1
  572. package/src/engine/ecs/components/Motion.js +0 -27
  573. package/src/engine/ecs/components/MotionSerializationAdapter.d.ts +0 -20
  574. package/src/engine/ecs/components/MotionSerializationAdapter.d.ts.map +0 -1
  575. package/src/engine/ecs/components/MotionSerializationAdapter.js +0 -26
  576. package/src/engine/ecs/systems/MotionSystem.d.ts +0 -9
  577. package/src/engine/ecs/systems/MotionSystem.d.ts.map +0 -1
  578. package/src/engine/ecs/systems/MotionSystem.js +0 -29
  579. package/src/engine/physics/fluid/Fluid.d.ts +0 -26
  580. package/src/engine/physics/fluid/Fluid.d.ts.map +0 -1
  581. package/src/engine/physics/fluid/Fluid.js +0 -221
  582. package/src/engine/physics/fluid/solver/v3_grid_apply_advection_reverse.d.ts +0 -7
  583. package/src/engine/physics/fluid/solver/v3_grid_apply_advection_reverse.d.ts.map +0 -1
  584. package/src/engine/physics/fluid/solver/v3_grid_apply_advection_reverse.js +0 -8
@@ -0,0 +1,126 @@
1
+ import { seededRandom_Mulberry32 } from "../../../math/random/seededRandom_Mulberry32.js";
2
+ import { coarsen_graph } from "./coarsen/coarsen_graph.js";
3
+ import { initial_kway_bfs } from "./initial/initial_kway_bfs.js";
4
+ import { initial_kway_recursive_bisection } from "./initial/initial_kway_recursive_bisection.js";
5
+ import { MetisGraph } from "./MetisGraph.js";
6
+ import { compute_kway_params } from "./refine/compute_kway_params.js";
7
+ import { refine_kway } from "./refine/refine_kway.js";
8
+ import { RefinementScratch } from "./refine/RefinementScratch.js";
9
+
10
+ /**
11
+ * Pure-JS k-way graph partitioning, drop-in compatible with the existing
12
+ * `micron_partition(...)` WASM-backed entry point.
13
+ *
14
+ * Implements the multilevel pipeline: coarsen → initial partition → uncoarsen
15
+ * with refinement at every level. Scope matches the subset that meep's
16
+ * `metis_cluster_bs` actually uses:
17
+ * - cut-objective only
18
+ * - single balance constraint, all vertex weights = 1
19
+ * - uniform target partition weights
20
+ * - no minconn / contig / volume / multi-constraint paths
21
+ *
22
+ * @param {number} vertex_count
23
+ * @param {number} partition_count
24
+ * @param {Uint32Array} edge_addresses CSR row pointers, length vertex_count + 1
25
+ * @param {Uint32Array} adjacency CSR column indices, length edge_addresses[vertex_count]
26
+ * @param {Uint32Array} edge_weights parallel to adjacency
27
+ * @param {{
28
+ * seed?: number,
29
+ * niter?: number,
30
+ * ufactor?: number,
31
+ * initial_partition_strategy?: 'recursive_bisection' | 'bfs',
32
+ * }} [options]
33
+ * Only a small slice of `metis_options` is wired; everything else uses METIS
34
+ * defaults.
35
+ * - `ufactor`: load imbalance factor in METIS units (per-mille over 1.0;
36
+ * ufactor = 30 → ub_factor = 1.03). Default 30.
37
+ * - `niter`: number of FM passes per level. Default 10.
38
+ * - `seed`: RNG seed; same seed + same input ⇒ same partition. Default 0.
39
+ * - `initial_partition_strategy`: 'recursive_bisection' (Karypis-Kumar §2.2,
40
+ * higher quality) or 'bfs' (simpler, faster initial phase, weaker cut).
41
+ * Default 'recursive_bisection'.
42
+ * @returns {Uint32Array} partition assignment per vertex, values in [0, partition_count)
43
+ */
44
+ export function metis_partition_kway(
45
+ vertex_count,
46
+ partition_count,
47
+ edge_addresses,
48
+ adjacency,
49
+ edge_weights,
50
+ options
51
+ ) {
52
+ const raw_seed = options?.seed;
53
+ const seed = (raw_seed === undefined || raw_seed === -1) ? 0 : raw_seed;
54
+
55
+ const raw_pass_count = options?.niter;
56
+ const pass_count = (raw_pass_count === undefined || raw_pass_count === -1) ? 10 : raw_pass_count;
57
+
58
+ const raw_ufactor = options?.ufactor;
59
+ const ufactor = (raw_ufactor === undefined || raw_ufactor === -1) ? 30 : raw_ufactor;
60
+ const ub_factor = 1 + ufactor / 1000;
61
+
62
+ const initial_partition_strategy = options?.initial_partition_strategy ?? 'recursive_bisection';
63
+
64
+ const random = seededRandom_Mulberry32(seed);
65
+
66
+ if (vertex_count === 0 || partition_count <= 1) {
67
+ return new Uint32Array(vertex_count);
68
+ }
69
+
70
+ // Copy the input CSR into a MetisGraph with a single shared buffer. We
71
+ // can't alias the caller's arrays directly because CSRGraph owns one
72
+ // contiguous buffer and aliasing would split the four arrays across
73
+ // independent buffers, breaking copy/equals/hash. The copy cost is small
74
+ // relative to the partitioning work that follows.
75
+ const original_graph = new MetisGraph(vertex_count, edge_addresses[vertex_count]);
76
+ original_graph.edge_addresses.set(edge_addresses);
77
+ original_graph.adjacency.set(adjacency);
78
+ original_graph.edge_weights.set(edge_weights);
79
+ // vertex_weights stays at the all-1s default; total_vertex_weight = vertex_count.
80
+
81
+ // METIS heuristic for the coarsening floor: stop once we're down to about
82
+ // 30·k vertices (or vertex_count / (20·log2(k)), whichever is greater).
83
+ const coarsen_until_vertex_count = Math.max(
84
+ Math.ceil(vertex_count / (20 * Math.log2(Math.max(2, partition_count)))),
85
+ 30 * partition_count
86
+ );
87
+
88
+ let coarsest_graph;
89
+ if (vertex_count <= coarsen_until_vertex_count) {
90
+ // Graph is already small enough; skip multilevel. Refinement still runs
91
+ // on this single level via the refine_kway driver.
92
+ coarsest_graph = original_graph;
93
+ } else {
94
+ coarsest_graph = coarsen_graph(original_graph, { random, coarsen_until_vertex_count });
95
+ }
96
+
97
+ if (initial_partition_strategy === 'recursive_bisection') {
98
+ // Recursive bisection leaves `coarsest_graph.vertex_partition` pointing
99
+ // at a buffer that's now owned by the graph (the BisectionScratch goes
100
+ // out of scope but the partition buffer survives because the graph
101
+ // still references it). `allocate_partition_state` preserves the
102
+ // existing vertex_partition, so we just install the rest of the k-way
103
+ // state on top.
104
+ initial_kway_recursive_bisection(coarsest_graph, partition_count, ub_factor, random);
105
+ coarsest_graph.allocate_partition_state(partition_count);
106
+ } else {
107
+ coarsest_graph.allocate_partition_state(partition_count);
108
+ initial_kway_bfs(coarsest_graph, partition_count, random);
109
+ }
110
+
111
+ compute_kway_params(coarsest_graph, partition_count);
112
+
113
+ // Shared scratch for fm_kway across every uncoarsening level. Sized to the
114
+ // original (finest) graph since that's the largest level we'll process.
115
+ const refinement_scratch = new RefinementScratch(original_graph.vertex_count, partition_count);
116
+
117
+ refine_kway(
118
+ original_graph,
119
+ coarsest_graph,
120
+ partition_count,
121
+ { random, pass_count, ub_factor },
122
+ refinement_scratch
123
+ );
124
+
125
+ return original_graph.vertex_partition;
126
+ }
@@ -0,0 +1,62 @@
1
+ export class IndexedFloatMaxHeap {
2
+ /**
3
+ * @param {number} id_capacity ids must be in [0, id_capacity)
4
+ * @param {number} [initial_slot_capacity] initial heap slot count (grows on demand)
5
+ */
6
+ constructor(id_capacity: number, initial_slot_capacity?: number);
7
+ __slot_capacity: number;
8
+ __size: number;
9
+ __data_buffer: ArrayBuffer;
10
+ __data_uint32: Uint32Array;
11
+ __data_float32: Float32Array;
12
+ /**
13
+ * Maps id → slot index in [0, size), or SLOT_NOT_PRESENT.
14
+ * @type {Uint32Array}
15
+ */
16
+ __slot_of_id: Uint32Array;
17
+ get size(): number;
18
+ /**
19
+ * Empty the heap. Only resets the index entries that are actually populated,
20
+ * so this is O(size), not O(id_capacity).
21
+ */
22
+ clear(): void;
23
+ contains(id: any): boolean;
24
+ /**
25
+ * Swap the entries at two slot indices, keeping the id→slot index in sync.
26
+ * @private
27
+ */
28
+ private __swap_slots;
29
+ /**
30
+ * Restore heap order downward starting at `start_slot`. Used when an entry's
31
+ * score has just decreased.
32
+ * @private
33
+ */
34
+ private __sift_down;
35
+ /**
36
+ * Restore heap order upward starting at `start_slot`. Used when an entry's
37
+ * score has just increased.
38
+ * @private
39
+ */
40
+ private __sift_up;
41
+ __grow_capacity(): void;
42
+ /**
43
+ * @param {number} id
44
+ * @param {number} score
45
+ */
46
+ insert(id: number, score: number): void;
47
+ /**
48
+ * @returns {number} id of the entry with the largest score, or -1 if empty
49
+ */
50
+ pop_max(): number;
51
+ /**
52
+ * @param {number} id
53
+ * @param {number} new_score
54
+ */
55
+ update(id: number, new_score: number): void;
56
+ /**
57
+ * @param {number} id
58
+ * @returns {boolean} true if the id was present and removed
59
+ */
60
+ remove(id: number): boolean;
61
+ }
62
+ //# sourceMappingURL=IndexedFloatMaxHeap.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"IndexedFloatMaxHeap.d.ts","sourceRoot":"","sources":["../../../../../../../src/core/graph/metis/native/refine/IndexedFloatMaxHeap.js"],"names":[],"mappings":"AA6BA;IACI;;;OAGG;IACH,yBAHW,MAAM,0BACN,MAAM,EAsBhB;IAbG,wBAA4C;IAC5C,eAAe;IAEf,2BAA4E;IAC5E,2BAAwD;IACxD,6BAA0D;IAE1D;;;OAGG;IACH,cAFU,WAAW,CAE2B;IAIpD,mBAEC;IAED;;;OAGG;IACH,cAQC;IAED,2BAEC;IAED;;;OAGG;IACH,qBAkBC;IAED;;;;OAIG;IACH,oBAsBC;IAED;;;;OAIG;IACH,kBAYC;IAED,wBAUC;IAED;;;OAGG;IACH,WAHW,MAAM,SACN,MAAM,QAehB;IAED;;OAEG;IACH,WAFa,MAAM,CAuBlB;IAED;;;OAGG;IACH,WAHW,MAAM,aACN,MAAM,QAehB;IAED;;;OAGG;IACH,WAHW,MAAM,GACJ,OAAO,CA+BnB;CACJ"}
@@ -0,0 +1,261 @@
1
+ import { assert } from "../../../../assert.js";
2
+
3
+ /**
4
+ * Max-heap of (uint32 id, float32 score) entries with an external id→slot index
5
+ * for O(log n) `update` and `remove` by id (rather than O(n) linear scan).
6
+ *
7
+ * Used by the k-way Fiduccia–Mattheyses refinement, where each vertex move
8
+ * requires updating the gain entries of every neighbour's boundary vertex.
9
+ * Without the index, that's O(degree · |boundary|) per move; with it,
10
+ * O(degree · log |boundary|).
11
+ *
12
+ * Behaviour notes:
13
+ * - This is a MAX-heap (`pop_max` returns the entry with the largest score).
14
+ * - Ids must be in `[0, id_capacity)`; the index table is sized at construction.
15
+ * - Duplicate ids are not allowed. Calling `insert` with an existing id throws.
16
+ *
17
+ * Storage layout mirrors meep's `Uint32Heap`: each heap slot is 8 bytes packed
18
+ * as `(float32 score, uint32 id)`. The id→slot map is a separate
19
+ * `Uint32Array(id_capacity)` where `SLOT_NOT_PRESENT` means "not in heap".
20
+ *
21
+ * We measured a JS `Map<number, number>` as the index instead — it removes the
22
+ * eager `id_capacity` allocation but added 35-60% to FM-dominated benchmarks
23
+ * because `Map.get/set/delete` per `__swap_slots` call (O(log n) per pop) is
24
+ * meaningfully slower than typed-array indexing. Kept the typed-array form.
25
+ */
26
+
27
+ const SLOT_NOT_PRESENT = 0xFFFFFFFF;
28
+ const BYTES_PER_SLOT = 8;
29
+
30
+ export class IndexedFloatMaxHeap {
31
+ /**
32
+ * @param {number} id_capacity ids must be in [0, id_capacity)
33
+ * @param {number} [initial_slot_capacity] initial heap slot count (grows on demand)
34
+ */
35
+ constructor(
36
+ id_capacity,
37
+ initial_slot_capacity = Math.min(64, id_capacity)
38
+ ) {
39
+ assert.isNonNegativeInteger(id_capacity, 'id_capacity');
40
+ assert.isNonNegativeInteger(initial_slot_capacity, 'initial_slot_capacity');
41
+
42
+ this.__slot_capacity = initial_slot_capacity;
43
+ this.__size = 0;
44
+
45
+ this.__data_buffer = new ArrayBuffer(initial_slot_capacity * BYTES_PER_SLOT);
46
+ this.__data_uint32 = new Uint32Array(this.__data_buffer);
47
+ this.__data_float32 = new Float32Array(this.__data_buffer);
48
+
49
+ /**
50
+ * Maps id → slot index in [0, size), or SLOT_NOT_PRESENT.
51
+ * @type {Uint32Array}
52
+ */
53
+ this.__slot_of_id = new Uint32Array(id_capacity);
54
+ this.__slot_of_id.fill(SLOT_NOT_PRESENT);
55
+ }
56
+
57
+ get size() {
58
+ return this.__size;
59
+ }
60
+
61
+ /**
62
+ * Empty the heap. Only resets the index entries that are actually populated,
63
+ * so this is O(size), not O(id_capacity).
64
+ */
65
+ clear() {
66
+ const data_uint32 = this.__data_uint32;
67
+ const size = this.__size;
68
+ const slot_of_id = this.__slot_of_id;
69
+ for (let slot = 0; slot < size; slot++) {
70
+ slot_of_id[data_uint32[slot * 2 + 1]] = SLOT_NOT_PRESENT;
71
+ }
72
+ this.__size = 0;
73
+ }
74
+
75
+ contains(id) {
76
+ return this.__slot_of_id[id] !== SLOT_NOT_PRESENT;
77
+ }
78
+
79
+ /**
80
+ * Swap the entries at two slot indices, keeping the id→slot index in sync.
81
+ * @private
82
+ */
83
+ __swap_slots(slot_a, slot_b) {
84
+ const data_uint32 = this.__data_uint32;
85
+ const word_a = slot_a << 1;
86
+ const word_b = slot_b << 1;
87
+
88
+ const score_a = data_uint32[word_a];
89
+ const id_a = data_uint32[word_a + 1];
90
+ const score_b = data_uint32[word_b];
91
+ const id_b = data_uint32[word_b + 1];
92
+
93
+ data_uint32[word_a] = score_b;
94
+ data_uint32[word_a + 1] = id_b;
95
+ data_uint32[word_b] = score_a;
96
+ data_uint32[word_b + 1] = id_a;
97
+
98
+ const slot_of_id = this.__slot_of_id;
99
+ slot_of_id[id_a] = slot_b;
100
+ slot_of_id[id_b] = slot_a;
101
+ }
102
+
103
+ /**
104
+ * Restore heap order downward starting at `start_slot`. Used when an entry's
105
+ * score has just decreased.
106
+ * @private
107
+ */
108
+ __sift_down(start_slot) {
109
+ const size = this.__size;
110
+ const data_float32 = this.__data_float32;
111
+ let slot = start_slot;
112
+
113
+ for (;;) {
114
+ const left_child = (slot << 1) + 1;
115
+ const right_child = left_child + 1;
116
+ let largest_slot = slot;
117
+
118
+ if (left_child < size && data_float32[left_child * 2] > data_float32[largest_slot * 2]) {
119
+ largest_slot = left_child;
120
+ }
121
+ if (right_child < size && data_float32[right_child * 2] > data_float32[largest_slot * 2]) {
122
+ largest_slot = right_child;
123
+ }
124
+ if (largest_slot === slot) {
125
+ break;
126
+ }
127
+ this.__swap_slots(slot, largest_slot);
128
+ slot = largest_slot;
129
+ }
130
+ }
131
+
132
+ /**
133
+ * Restore heap order upward starting at `start_slot`. Used when an entry's
134
+ * score has just increased.
135
+ * @private
136
+ */
137
+ __sift_up(start_slot) {
138
+ const data_float32 = this.__data_float32;
139
+ let slot = start_slot;
140
+
141
+ while (slot > 0) {
142
+ const parent_slot = (slot - 1) >> 1;
143
+ if (data_float32[parent_slot * 2] >= data_float32[slot * 2]) {
144
+ break;
145
+ }
146
+ this.__swap_slots(parent_slot, slot);
147
+ slot = parent_slot;
148
+ }
149
+ }
150
+
151
+ __grow_capacity() {
152
+ const old_capacity = this.__slot_capacity;
153
+ const new_capacity = Math.max(old_capacity + 16, Math.ceil(old_capacity * 1.5));
154
+ const new_buffer = new ArrayBuffer(new_capacity * BYTES_PER_SLOT);
155
+ const new_uint32 = new Uint32Array(new_buffer);
156
+ new_uint32.set(this.__data_uint32);
157
+ this.__data_buffer = new_buffer;
158
+ this.__data_uint32 = new_uint32;
159
+ this.__data_float32 = new Float32Array(new_buffer);
160
+ this.__slot_capacity = new_capacity;
161
+ }
162
+
163
+ /**
164
+ * @param {number} id
165
+ * @param {number} score
166
+ */
167
+ insert(id, score) {
168
+ if (this.__slot_of_id[id] !== SLOT_NOT_PRESENT) {
169
+ throw new Error(`id ${id} already in heap`);
170
+ }
171
+ if (this.__size >= this.__slot_capacity) {
172
+ this.__grow_capacity();
173
+ }
174
+ const new_slot = this.__size;
175
+ this.__data_float32[new_slot * 2] = score;
176
+ this.__data_uint32[new_slot * 2 + 1] = id;
177
+ this.__slot_of_id[id] = new_slot;
178
+ this.__size = new_slot + 1;
179
+ this.__sift_up(new_slot);
180
+ }
181
+
182
+ /**
183
+ * @returns {number} id of the entry with the largest score, or -1 if empty
184
+ */
185
+ pop_max() {
186
+ if (this.__size === 0) {
187
+ return -1;
188
+ }
189
+ const data_uint32 = this.__data_uint32;
190
+ const top_id = data_uint32[1];
191
+ const new_size = this.__size - 1;
192
+ this.__size = new_size;
193
+ this.__slot_of_id[top_id] = SLOT_NOT_PRESENT;
194
+
195
+ if (new_size > 0) {
196
+ const last_slot_word = new_size << 1;
197
+ const moved_score = this.__data_float32[last_slot_word];
198
+ const moved_id = data_uint32[last_slot_word + 1];
199
+ this.__data_float32[0] = moved_score;
200
+ data_uint32[1] = moved_id;
201
+ this.__slot_of_id[moved_id] = 0;
202
+ this.__sift_down(0);
203
+ }
204
+
205
+ return top_id;
206
+ }
207
+
208
+ /**
209
+ * @param {number} id
210
+ * @param {number} new_score
211
+ */
212
+ update(id, new_score) {
213
+ const slot = this.__slot_of_id[id];
214
+ if (slot === SLOT_NOT_PRESENT) {
215
+ throw new Error(`id ${id} not in heap`);
216
+ }
217
+ const slot_score_address = slot * 2;
218
+ const old_score = this.__data_float32[slot_score_address];
219
+ this.__data_float32[slot_score_address] = new_score;
220
+ if (new_score > old_score) {
221
+ this.__sift_up(slot);
222
+ } else if (new_score < old_score) {
223
+ this.__sift_down(slot);
224
+ }
225
+ }
226
+
227
+ /**
228
+ * @param {number} id
229
+ * @returns {boolean} true if the id was present and removed
230
+ */
231
+ remove(id) {
232
+ const slot = this.__slot_of_id[id];
233
+ if (slot === SLOT_NOT_PRESENT) {
234
+ return false;
235
+ }
236
+ this.__slot_of_id[id] = SLOT_NOT_PRESENT;
237
+ const new_size = this.__size - 1;
238
+ this.__size = new_size;
239
+
240
+ if (slot === new_size) {
241
+ return true;
242
+ }
243
+
244
+ // Move the last entry into the vacated slot, then restore heap order.
245
+ const last_slot_word = new_size << 1;
246
+ const moved_score = this.__data_float32[last_slot_word];
247
+ const moved_id = this.__data_uint32[last_slot_word + 1];
248
+ const slot_word = slot * 2;
249
+ const old_slot_score = this.__data_float32[slot_word];
250
+ this.__data_float32[slot_word] = moved_score;
251
+ this.__data_uint32[slot_word + 1] = moved_id;
252
+ this.__slot_of_id[moved_id] = slot;
253
+
254
+ if (moved_score > old_slot_score) {
255
+ this.__sift_up(slot);
256
+ } else {
257
+ this.__sift_down(slot);
258
+ }
259
+ return true;
260
+ }
261
+ }
@@ -0,0 +1,45 @@
1
+ /**
2
+ * Pre-allocated scratch reused across every `fm_kway` call during the
3
+ * uncoarsening / refinement phase.
4
+ *
5
+ * `refine_kway` invokes `fm_kway` once per multilevel level (typically 3-15
6
+ * times per partition run). Each call previously allocated:
7
+ * - one `IndexedFloatMaxHeap` (with a `Uint32Array(vertex_count)` index table —
8
+ * 4 MB at 1M vertices)
9
+ * - three vertex-sized typed arrays for queue status and touched bookkeeping
10
+ * - two partition-count-sized arrays for the weight bounds
11
+ *
12
+ * Sharing one set of arrays scoped to the original (finest) graph's vertex
13
+ * count means the heap's index table is sized once and the rest of the state
14
+ * is reused across all levels.
15
+ *
16
+ * The arrays' invariants are preserved across calls without explicit clears:
17
+ *
18
+ * - `queue_status` starts all-0 (NOT_PRESENT). Each fm_kway pass resets
19
+ * touched entries back to 0 in its cleanup, so subsequent calls see a
20
+ * clean slate without needing a fresh `.fill(0)`.
21
+ *
22
+ * - `touched_position_of_vertex` starts all -1. Same per-pass cleanup
23
+ * restores -1 for every touched entry.
24
+ *
25
+ * - The heap uses `.clear()` at the start of each pass — that's O(size),
26
+ * not O(capacity), and resets `__slot_of_id` only for the entries actually
27
+ * in the heap.
28
+ */
29
+ export class RefinementScratch {
30
+ /**
31
+ * @param {number} max_vertex_count typically the original (finest) graph's vertex count
32
+ * @param {number} partition_count
33
+ */
34
+ constructor(max_vertex_count: number, partition_count: number);
35
+ max_vertex_count: number;
36
+ partition_count: number;
37
+ move_queue: IndexedFloatMaxHeap;
38
+ queue_status: Uint8Array;
39
+ touched_vertices: Uint32Array;
40
+ touched_position_of_vertex: Int32Array;
41
+ partition_weight_min: Uint32Array;
42
+ partition_weight_max: Uint32Array;
43
+ }
44
+ import { IndexedFloatMaxHeap } from "./IndexedFloatMaxHeap.js";
45
+ //# sourceMappingURL=RefinementScratch.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"RefinementScratch.d.ts","sourceRoot":"","sources":["../../../../../../../src/core/graph/metis/native/refine/RefinementScratch.js"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH;IACI;;;OAGG;IACH,8BAHW,MAAM,mBACN,MAAM,EAkBhB;IAfG,yBAAwC;IACxC,wBAAsC;IAEtC,gCAGC;IAED,yBAAoD;IACpD,8BAAyD;IACzD,uCAAkE;IAGlE,kCAA4D;IAC5D,kCAA4D;CAEnE;oCApDmC,0BAA0B"}
@@ -0,0 +1,53 @@
1
+ import { IndexedFloatMaxHeap } from "./IndexedFloatMaxHeap.js";
2
+
3
+ /**
4
+ * Pre-allocated scratch reused across every `fm_kway` call during the
5
+ * uncoarsening / refinement phase.
6
+ *
7
+ * `refine_kway` invokes `fm_kway` once per multilevel level (typically 3-15
8
+ * times per partition run). Each call previously allocated:
9
+ * - one `IndexedFloatMaxHeap` (with a `Uint32Array(vertex_count)` index table —
10
+ * 4 MB at 1M vertices)
11
+ * - three vertex-sized typed arrays for queue status and touched bookkeeping
12
+ * - two partition-count-sized arrays for the weight bounds
13
+ *
14
+ * Sharing one set of arrays scoped to the original (finest) graph's vertex
15
+ * count means the heap's index table is sized once and the rest of the state
16
+ * is reused across all levels.
17
+ *
18
+ * The arrays' invariants are preserved across calls without explicit clears:
19
+ *
20
+ * - `queue_status` starts all-0 (NOT_PRESENT). Each fm_kway pass resets
21
+ * touched entries back to 0 in its cleanup, so subsequent calls see a
22
+ * clean slate without needing a fresh `.fill(0)`.
23
+ *
24
+ * - `touched_position_of_vertex` starts all -1. Same per-pass cleanup
25
+ * restores -1 for every touched entry.
26
+ *
27
+ * - The heap uses `.clear()` at the start of each pass — that's O(size),
28
+ * not O(capacity), and resets `__slot_of_id` only for the entries actually
29
+ * in the heap.
30
+ */
31
+ export class RefinementScratch {
32
+ /**
33
+ * @param {number} max_vertex_count typically the original (finest) graph's vertex count
34
+ * @param {number} partition_count
35
+ */
36
+ constructor(max_vertex_count, partition_count) {
37
+ this.max_vertex_count = max_vertex_count;
38
+ this.partition_count = partition_count;
39
+
40
+ this.move_queue = new IndexedFloatMaxHeap(
41
+ max_vertex_count,
42
+ Math.min(max_vertex_count, 1024)
43
+ );
44
+
45
+ this.queue_status = new Uint8Array(max_vertex_count);
46
+ this.touched_vertices = new Uint32Array(max_vertex_count);
47
+ this.touched_position_of_vertex = new Int32Array(max_vertex_count);
48
+ this.touched_position_of_vertex.fill(-1);
49
+
50
+ this.partition_weight_min = new Uint32Array(partition_count);
51
+ this.partition_weight_max = new Uint32Array(partition_count);
52
+ }
53
+ }
@@ -0,0 +1,18 @@
1
+ /**
2
+ * From a freshly-assigned `vertex_partition[]`, populate the rest of the k-way
3
+ * refinement state: per-partition weights, per-vertex internal/external degree,
4
+ * the neighbour-partition list (via `neighbor_partition_pool`), the boundary
5
+ * list, and the total edge cut.
6
+ *
7
+ * Mirrors `ComputeKWayPartitionParams` from libmetis/kwayrefine.c, cut-objective
8
+ * branch only.
9
+ *
10
+ * Boundary insertion rule (refinement-type boundary): a vertex is added to the
11
+ * boundary when `external_degree >= internal_degree`. That captures "worth
12
+ * considering for a move" — vertices with no external pull aren't candidates.
13
+ *
14
+ * @param {import('../MetisGraph.js').MetisGraph} graph
15
+ * @param {number} partition_count
16
+ */
17
+ export function compute_kway_params(graph: import('../MetisGraph.js').MetisGraph, partition_count: number): void;
18
+ //# sourceMappingURL=compute_kway_params.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"compute_kway_params.d.ts","sourceRoot":"","sources":["../../../../../../../src/core/graph/metis/native/refine/compute_kway_params.js"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;GAeG;AACH,2CAHW,OAAO,kBAAkB,EAAE,UAAU,mBACrC,MAAM,QAyHhB"}