@woosh/meep-engine 2.168.1 → 2.169.1

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 (624) hide show
  1. package/README.md +2 -2
  2. package/build/bundle-worker-image-decoder.js +1 -1
  3. package/editor/process/symbolic/make3DSymbolicDisplay.js +1 -1
  4. package/editor/view/ecs/EntityList.js +1 -1
  5. package/editor/view/ecs/components/particles/ParticleLayerController.js +1 -1
  6. package/editor/view/makeEntityDecorators.js +1 -1
  7. package/package.json +1 -1
  8. package/src/REVIEW_2026_08_06/adv-core.md +511 -0
  9. package/src/REVIEW_2026_08_06/adv-gfx.md +480 -0
  10. package/src/REVIEW_2026_08_06/adv-view.md +446 -0
  11. package/src/REVIEW_2026_08_06/api-core.md +296 -0
  12. package/src/REVIEW_2026_08_06/api-engine.md +195 -0
  13. package/src/REVIEW_2026_08_06/bvh-phys-sound-net.md +507 -0
  14. package/src/REVIEW_2026_08_06/core-binary.md +348 -0
  15. package/src/REVIEW_2026_08_06/core-collection.md +376 -0
  16. package/src/REVIEW_2026_08_06/core-math.md +221 -0
  17. package/src/REVIEW_2026_08_06/core-process.md +266 -0
  18. package/src/REVIEW_2026_08_06/core-science.md +223 -0
  19. package/src/REVIEW_2026_08_06/engine-ai-nav.md +279 -0
  20. package/src/REVIEW_2026_08_06/engine-animation.md +167 -0
  21. package/src/REVIEW_2026_08_06/engine-asset.md +166 -0
  22. package/src/REVIEW_2026_08_06/engine-ecs.md +920 -0
  23. package/src/REVIEW_2026_08_06/engine-input.md +197 -0
  24. package/src/REVIEW_2026_08_06/engine-misc.md +248 -0
  25. package/src/REVIEW_2026_08_06/engine-terrain.md +52 -0
  26. package/src/REVIEW_2026_08_06/generation.md +176 -0
  27. package/src/REVIEW_2026_08_06/geom-2d.md +434 -0
  28. package/src/REVIEW_2026_08_06/geom-3d.md +117 -0
  29. package/src/REVIEW_2026_08_06/gfx-gi.md +143 -0
  30. package/src/REVIEW_2026_08_06/gfx-render.md +740 -0
  31. package/src/REVIEW_2026_08_06/gfx-texture.md +690 -0
  32. package/src/REVIEW_2026_08_06/prior-criticals.md +49 -0
  33. package/src/REVIEW_2026_08_06/prior-highs.md +138 -0
  34. package/src/REVIEW_2026_08_06/test-gaps.md +364 -0
  35. package/src/REVIEW_2026_08_06/view.md +667 -0
  36. package/src/REVIEW_2026_08_06.md +610 -0
  37. package/src/core/IdPool.d.ts +2 -2
  38. package/src/core/IdPool.d.ts.map +1 -1
  39. package/src/core/IdPool.js +1 -1
  40. package/src/core/binary/32BitEncoder.d.ts +2 -3
  41. package/src/core/binary/32BitEncoder.d.ts.map +1 -1
  42. package/src/core/binary/32BitEncoder.js +1 -1
  43. package/src/core/binary/BinaryBuffer.d.ts.map +1 -1
  44. package/src/core/binary/BinaryBuffer.js +12 -1
  45. package/src/core/binary/BitImage2.d.ts +5 -1
  46. package/src/core/binary/BitImage2.d.ts.map +1 -1
  47. package/src/core/binary/BitImage2.js +5 -1
  48. package/src/core/bvh2/bvh3/BVH.d.ts +2 -2
  49. package/src/core/bvh2/bvh3/BVH.d.ts.map +1 -1
  50. package/src/core/bvh2/bvh3/BVH.js +1 -1
  51. package/src/core/bvh2/bvh3/query/bvh_query_user_data_nearest_to_point_filtered.d.ts +2 -2
  52. package/src/core/bvh2/bvh3/query/bvh_query_user_data_nearest_to_point_filtered.d.ts.map +1 -1
  53. package/src/core/bvh2/bvh3/query/bvh_query_user_data_nearest_to_point_filtered.js +86 -86
  54. package/src/core/bvh2/traversal/aabb3_detailed_volume_intersection_callback_based.d.ts +2 -2
  55. package/src/core/bvh2/traversal/aabb3_detailed_volume_intersection_callback_based.d.ts.map +1 -1
  56. package/src/core/bvh2/traversal/aabb3_detailed_volume_intersection_callback_based.js +1 -1
  57. package/src/core/bvh8/build/NodeProxy.d.ts.map +1 -1
  58. package/src/core/bvh8/build/NodeProxy.js +314 -308
  59. package/src/core/cache/Cache.d.ts +4 -4
  60. package/src/core/cache/Cache.d.ts.map +1 -1
  61. package/src/core/cache/Cache.js +3 -3
  62. package/src/core/cache/LoadingCache.d.ts +1 -1
  63. package/src/core/cache/LoadingCache.js +2 -2
  64. package/src/core/cache/wtinylfu/CacheWTinylfu.d.ts +2 -2
  65. package/src/core/cache/wtinylfu/CacheWTinylfu.js +2 -2
  66. package/src/core/collection/array/array_index_by_equality.d.ts +2 -2
  67. package/src/core/collection/array/array_index_by_equality.d.ts.map +1 -1
  68. package/src/core/collection/array/array_index_by_equality.js +1 -1
  69. package/src/core/collection/array/array_pick_best_element.d.ts +2 -2
  70. package/src/core/collection/array/array_pick_best_element.d.ts.map +1 -1
  71. package/src/core/collection/array/array_pick_best_element.js +1 -1
  72. package/src/core/collection/array/array_pick_best_elements.d.ts +2 -2
  73. package/src/core/collection/array/array_pick_best_elements.d.ts.map +1 -1
  74. package/src/core/collection/array/array_pick_best_elements.js +1 -1
  75. package/src/core/collection/array/array_set_diff.d.ts +2 -3
  76. package/src/core/collection/array/array_set_diff.d.ts.map +1 -1
  77. package/src/core/collection/array/array_set_diff.js +1 -1
  78. package/src/core/collection/array/array_set_diff_sorting.d.ts +2 -2
  79. package/src/core/collection/array/array_set_diff_sorting.d.ts.map +1 -1
  80. package/src/core/collection/array/array_set_diff_sorting.js +1 -1
  81. package/src/core/collection/array/iterator/ArrayIteratorRandom.d.ts +2 -1
  82. package/src/core/collection/array/iterator/ArrayIteratorRandom.d.ts.map +1 -1
  83. package/src/core/collection/heap/BinaryHeap.d.ts +2 -2
  84. package/src/core/collection/heap/BinaryHeap.d.ts.map +1 -1
  85. package/src/core/collection/heap/BinaryHeap.js +1 -1
  86. package/src/core/collection/list/List.d.ts +32 -17
  87. package/src/core/collection/list/List.d.ts.map +1 -1
  88. package/src/core/collection/list/List.js +43 -9
  89. package/src/core/collection/list/SortedListProjection.d.ts.map +1 -1
  90. package/src/core/collection/list/SortedListProjection.js +4 -1
  91. package/src/core/collection/map/BiMap.d.ts +25 -2
  92. package/src/core/collection/map/BiMap.d.ts.map +1 -1
  93. package/src/core/collection/map/BiMap.js +57 -3
  94. package/src/core/collection/map/HashMap.d.ts +2 -2
  95. package/src/core/collection/map/HashMap.d.ts.map +1 -1
  96. package/src/core/collection/map/HashMap.js +1 -1
  97. package/src/core/collection/set/ArraySet.d.ts +2 -2
  98. package/src/core/collection/set/ArraySet.d.ts.map +1 -1
  99. package/src/core/collection/set/ArraySet.js +1 -1
  100. package/src/core/collection/table/RowFirstTable.d.ts +2 -2
  101. package/src/core/collection/table/RowFirstTable.d.ts.map +1 -1
  102. package/src/core/collection/table/RowFirstTable.js +1 -1
  103. package/src/core/collection/table/RowFirstTableSpec.js +4 -4
  104. package/src/core/debug/matchers/IsAnything.d.ts.map +1 -1
  105. package/src/core/debug/matchers/IsAnything.js +5 -1
  106. package/src/core/events/signal/Signal.d.ts.map +1 -1
  107. package/src/core/events/signal/Signal.js +3 -1
  108. package/src/core/fsm/simple/SimpleStateMachineDescription.d.ts +2 -2
  109. package/src/core/fsm/simple/SimpleStateMachineDescription.d.ts.map +1 -1
  110. package/src/core/fsm/simple/SimpleStateMachineDescription.js +1 -1
  111. package/src/core/geom/2d/bvh/BVH2D.d.ts +2 -2
  112. package/src/core/geom/2d/bvh/BVH2D.d.ts.map +1 -1
  113. package/src/core/geom/2d/bvh/BVH2D.js +1 -1
  114. package/src/core/geom/2d/polygon/TRIANGULATION_DESIGN.md +433 -0
  115. package/src/core/geom/2d/polygon/polygon2_is_counter_clockwise.d.ts +31 -0
  116. package/src/core/geom/2d/polygon/polygon2_is_counter_clockwise.d.ts.map +1 -0
  117. package/src/core/geom/2d/polygon/polygon2_is_counter_clockwise.js +84 -0
  118. package/src/core/geom/2d/polygon/polygon2_signed_area.d.ts +24 -2
  119. package/src/core/geom/2d/polygon/polygon2_signed_area.d.ts.map +1 -1
  120. package/src/core/geom/2d/polygon/polygon2_signed_area.js +52 -34
  121. package/src/core/geom/2d/polygon/polygon2_triangulate.corpus.d.ts +28 -0
  122. package/src/core/geom/2d/polygon/polygon2_triangulate.corpus.d.ts.map +1 -0
  123. package/src/core/geom/2d/polygon/polygon2_triangulate.corpus.js +86 -0
  124. package/src/core/geom/2d/polygon/polygon2_triangulate.d.ts +40 -0
  125. package/src/core/geom/2d/polygon/polygon2_triangulate.d.ts.map +1 -0
  126. package/src/core/geom/2d/polygon/polygon2_triangulate.js +1280 -0
  127. package/src/core/geom/2d/polygon/polygon2_triangulation_deviation.d.ts +28 -0
  128. package/src/core/geom/2d/polygon/polygon2_triangulation_deviation.d.ts.map +1 -0
  129. package/src/core/geom/2d/polygon/polygon2_triangulation_deviation.js +77 -0
  130. package/src/core/geom/2d/quad-tree/qt_match_data_by_circle.d.ts +2 -2
  131. package/src/core/geom/2d/quad-tree/qt_match_data_by_circle.d.ts.map +1 -1
  132. package/src/core/geom/2d/quad-tree/qt_match_data_by_circle.js +1 -1
  133. package/src/core/geom/2d/quad-tree/qt_query_data_raycast.d.ts +2 -2
  134. package/src/core/geom/2d/quad-tree/qt_query_data_raycast.d.ts.map +1 -1
  135. package/src/core/geom/2d/quad-tree/qt_query_data_raycast.js +1 -1
  136. package/src/core/geom/2d/triangle/tri2_rasterize_conservative.d.ts +6 -3
  137. package/src/core/geom/2d/triangle/tri2_rasterize_conservative.d.ts.map +1 -1
  138. package/src/core/geom/2d/triangle/tri2_rasterize_conservative.js +26 -13
  139. package/src/core/geom/2d/triangle/tri2_signed_area.d.ts +17 -1
  140. package/src/core/geom/2d/triangle/tri2_signed_area.d.ts.map +1 -1
  141. package/src/core/geom/2d/triangle/tri2_signed_area.js +35 -23
  142. package/src/core/geom/2d/v2_morton_encode.d.ts +20 -0
  143. package/src/core/geom/2d/v2_morton_encode.d.ts.map +1 -0
  144. package/src/core/geom/2d/v2_morton_encode.js +23 -0
  145. package/src/core/geom/3d/aabb/AABB3.d.ts +2 -2
  146. package/src/core/geom/3d/aabb/AABB3.d.ts.map +1 -1
  147. package/src/core/geom/3d/aabb/AABB3.js +1 -1
  148. package/src/core/geom/3d/atlas/segment/atlas_merge_charts.d.ts.map +1 -1
  149. package/src/core/geom/3d/atlas/segment/atlas_merge_charts.js +4 -1
  150. package/src/core/geom/3d/polygon/polygon3_compute_normal.d.ts +27 -0
  151. package/src/core/geom/3d/polygon/polygon3_compute_normal.d.ts.map +1 -0
  152. package/src/core/geom/3d/polygon/polygon3_compute_normal.js +60 -0
  153. package/src/core/geom/3d/polygon/polygon3_triangulate.d.ts +34 -0
  154. package/src/core/geom/3d/polygon/polygon3_triangulate.d.ts.map +1 -0
  155. package/src/core/geom/3d/polygon/polygon3_triangulate.js +94 -0
  156. package/src/core/geom/3d/quaternion/quat3_multiply.d.ts +8 -2
  157. package/src/core/geom/3d/quaternion/quat3_multiply.d.ts.map +1 -1
  158. package/src/core/geom/3d/quaternion/quat3_multiply.js +8 -2
  159. package/src/core/geom/3d/shape/ConvexHullShape3D.d.ts.map +1 -1
  160. package/src/core/geom/3d/shape/ConvexHullShape3D.js +32 -2
  161. package/src/core/geom/3d/tetrahedra/TetrahedralMesh.d.ts +2 -2
  162. package/src/core/geom/3d/tetrahedra/TetrahedralMesh.d.ts.map +1 -1
  163. package/src/core/geom/3d/tetrahedra/TetrahedralMesh.js +1 -1
  164. package/src/core/geom/3d/tetrahedra/delaunay/debug/push_boundary_with_validation.d.ts +2 -5
  165. package/src/core/geom/3d/tetrahedra/delaunay/debug/push_boundary_with_validation.d.ts.map +1 -1
  166. package/src/core/geom/3d/tetrahedra/delaunay/debug/push_boundary_with_validation.js +1 -1
  167. package/src/core/geom/3d/tetrahedra/delaunay/debug/validate_cavity_boundary.d.ts +2 -2
  168. package/src/core/geom/3d/tetrahedra/delaunay/debug/validate_cavity_boundary.d.ts.map +1 -1
  169. package/src/core/geom/3d/tetrahedra/delaunay/debug/validate_cavity_boundary.js +1 -1
  170. package/src/core/geom/3d/tetrahedra/validate_tetrahedral_mesh.d.ts +2 -3
  171. package/src/core/geom/3d/tetrahedra/validate_tetrahedral_mesh.d.ts.map +1 -1
  172. package/src/core/geom/3d/tetrahedra/validate_tetrahedral_mesh.js +69 -69
  173. package/src/core/geom/3d/tetrahedra/validate_tetrahedron_neighbourhood.d.ts +2 -3
  174. package/src/core/geom/3d/tetrahedra/validate_tetrahedron_neighbourhood.d.ts.map +1 -1
  175. package/src/core/geom/3d/tetrahedra/validate_tetrahedron_neighbourhood.js +50 -50
  176. package/src/core/geom/3d/topology/struct/TopoEdge.d.ts +2 -2
  177. package/src/core/geom/3d/topology/struct/TopoEdge.d.ts.map +1 -1
  178. package/src/core/geom/3d/topology/struct/TopoEdge.js +1 -1
  179. package/src/core/geom/3d/topology/struct/TopoMesh.d.ts +2 -3
  180. package/src/core/geom/3d/topology/struct/TopoMesh.d.ts.map +1 -1
  181. package/src/core/geom/3d/topology/struct/TopoMesh.js +1 -1
  182. package/src/core/geom/3d/topology/struct/TopoTriangle.d.ts +2 -2
  183. package/src/core/geom/3d/topology/struct/TopoTriangle.d.ts.map +1 -1
  184. package/src/core/geom/3d/topology/struct/TopoTriangle.js +1 -1
  185. package/src/core/geom/3d/topology/struct/TopoVertex.d.ts +2 -2
  186. package/src/core/geom/3d/topology/struct/TopoVertex.d.ts.map +1 -1
  187. package/src/core/geom/3d/topology/struct/TopoVertex.js +1 -1
  188. package/src/core/geom/3d/topology/struct/binary/io/face/bt_face_triangulate.d.ts +23 -6
  189. package/src/core/geom/3d/topology/struct/binary/io/face/bt_face_triangulate.d.ts.map +1 -1
  190. package/src/core/geom/3d/topology/struct/binary/io/face/bt_face_triangulate.js +268 -124
  191. package/src/core/geom/3d/topology/struct/binary/query/bt_mesh_assert_valid.d.ts +17 -0
  192. package/src/core/geom/3d/topology/struct/binary/query/bt_mesh_assert_valid.d.ts.map +1 -0
  193. package/src/core/geom/3d/topology/struct/binary/query/bt_mesh_assert_valid.js +44 -0
  194. package/src/core/geom/3d/topology/struct/binary/query/bt_mesh_count_edge_faces.d.ts +20 -0
  195. package/src/core/geom/3d/topology/struct/binary/query/bt_mesh_count_edge_faces.d.ts.map +1 -0
  196. package/src/core/geom/3d/topology/struct/binary/query/bt_mesh_count_edge_faces.js +40 -0
  197. package/src/core/geom/3d/topology/struct/binary/query/bt_mesh_is_closed.d.ts +19 -0
  198. package/src/core/geom/3d/topology/struct/binary/query/bt_mesh_is_closed.d.ts.map +1 -0
  199. package/src/core/geom/3d/topology/struct/binary/query/bt_mesh_is_closed.js +34 -0
  200. package/src/core/geom/3d/topology/struct/binary/query/bt_mesh_is_manifold.d.ts +22 -0
  201. package/src/core/geom/3d/topology/struct/binary/query/bt_mesh_is_manifold.d.ts.map +1 -0
  202. package/src/core/geom/3d/topology/struct/binary/query/bt_mesh_is_manifold.js +37 -0
  203. package/src/core/geom/3d/topology/struct/binary/query/bt_mesh_validate.d.ts +87 -0
  204. package/src/core/geom/3d/topology/struct/binary/query/bt_mesh_validate.d.ts.map +1 -0
  205. package/src/core/geom/3d/topology/struct/binary/query/bt_mesh_validate.js +599 -0
  206. package/src/core/geom/3d/topology/util/mesh_flood_fill.d.ts +1 -1
  207. package/src/core/geom/3d/topology/util/mesh_flood_fill.js +1 -1
  208. package/src/core/geom/3d/triangle/tri3_compute_signed_volume.d.ts +32 -0
  209. package/src/core/geom/3d/triangle/tri3_compute_signed_volume.d.ts.map +1 -1
  210. package/src/core/geom/3d/triangle/tri3_compute_signed_volume.js +66 -7
  211. package/src/core/geom/3d/triangle/tri3_mesh_compute_signed_volume.d.ts +22 -1
  212. package/src/core/geom/3d/triangle/tri3_mesh_compute_signed_volume.d.ts.map +1 -1
  213. package/src/core/geom/3d/triangle/tri3_mesh_compute_signed_volume.js +83 -38
  214. package/src/core/geom/3d/util/aabb3_emit_point_grid.d.ts +2 -2
  215. package/src/core/geom/3d/util/aabb3_emit_point_grid.d.ts.map +1 -1
  216. package/src/core/geom/3d/util/aabb3_emit_point_grid.js +1 -1
  217. package/src/core/geom/MANIFOLD_COMPARISON_2026_08_01.md +554 -0
  218. package/src/core/geom/Quaternion.d.ts +2 -2
  219. package/src/core/geom/Quaternion.d.ts.map +1 -1
  220. package/src/core/geom/Quaternion.js +1 -1
  221. package/src/core/geom/Vector1.d.ts +2 -2
  222. package/src/core/geom/Vector1.d.ts.map +1 -1
  223. package/src/core/geom/Vector1.js +1 -1
  224. package/src/core/geom/packing/max-rect/find_best_container.d.ts +2 -2
  225. package/src/core/geom/packing/max-rect/find_best_container.d.ts.map +1 -1
  226. package/src/core/geom/packing/max-rect/find_best_container.js +1 -1
  227. package/src/core/geom/vec3/v3_cotangent.d.ts +6 -2
  228. package/src/core/geom/vec3/v3_cotangent.d.ts.map +1 -1
  229. package/src/core/geom/vec3/v3_cotangent.js +6 -2
  230. package/src/core/geom/vec3/v3_cross.d.ts +6 -2
  231. package/src/core/geom/vec3/v3_cross.d.ts.map +1 -1
  232. package/src/core/geom/vec3/v3_cross.js +6 -2
  233. package/src/core/geom/vec3/v3_lerp.d.ts +1 -1
  234. package/src/core/geom/vec3/v3_lerp.js +1 -1
  235. package/src/core/geom/vec3/v3_multiply.d.ts +6 -2
  236. package/src/core/geom/vec3/v3_multiply.d.ts.map +1 -1
  237. package/src/core/geom/vec3/v3_multiply.js +6 -2
  238. package/src/core/geom/vec3/v3_subtract.d.ts +6 -2
  239. package/src/core/geom/vec3/v3_subtract.d.ts.map +1 -1
  240. package/src/core/geom/vec3/v3_subtract.js +6 -2
  241. package/src/core/json/abstractJSONSerializer.d.ts +2 -2
  242. package/src/core/json/abstractJSONSerializer.d.ts.map +1 -1
  243. package/src/core/json/abstractJSONSerializer.js +1 -1
  244. package/src/core/lang/reactive/AbstractCachingParser.d.ts +2 -3
  245. package/src/core/lang/reactive/AbstractCachingParser.d.ts.map +1 -1
  246. package/src/core/lang/reactive/AbstractCachingParser.js +1 -1
  247. package/src/core/localization/Localization.d.ts +2 -2
  248. package/src/core/localization/Localization.d.ts.map +1 -1
  249. package/src/core/localization/Localization.js +2 -2
  250. package/src/core/math/noise/create_simplex_noise_2d.d.ts +2 -2
  251. package/src/core/math/noise/create_simplex_noise_2d.d.ts.map +1 -1
  252. package/src/core/math/noise/create_simplex_noise_2d.js +1 -1
  253. package/src/core/math/physics/mie/MIE_PARTICLES_STANDARD.js +1 -1
  254. package/src/core/math/physics/mie/compute_mie_particle_properties_rgb.d.ts +3 -3
  255. package/src/core/math/physics/mie/compute_mie_particle_properties_rgb.d.ts.map +1 -1
  256. package/src/core/math/physics/mie/compute_mie_particle_properties_rgb.js +2 -2
  257. package/src/core/math/random/randomSeed.d.ts +13 -0
  258. package/src/core/math/random/randomSeed.d.ts.map +1 -0
  259. package/src/core/math/random/randomSeed.js +16 -0
  260. package/src/core/math/random/seededRandom_Mulberry32.d.ts +3 -2
  261. package/src/core/math/random/seededRandom_Mulberry32.d.ts.map +1 -1
  262. package/src/core/math/random/seededRandom_Mulberry32.js +1 -1
  263. package/src/core/math/spline/spline3_hermite_apply_transform.d.ts +50 -0
  264. package/src/core/math/spline/spline3_hermite_apply_transform.d.ts.map +1 -0
  265. package/src/core/math/spline/spline3_hermite_apply_transform.js +107 -0
  266. package/src/core/math/spline/spline3_hermite_reverse.d.ts +34 -0
  267. package/src/core/math/spline/spline3_hermite_reverse.d.ts.map +1 -0
  268. package/src/core/math/spline/spline3_hermite_reverse.js +49 -0
  269. package/src/core/math/statistics/hammersley_sequence.d.ts +17 -4
  270. package/src/core/math/statistics/hammersley_sequence.d.ts.map +1 -1
  271. package/src/core/math/statistics/hammersley_sequence.js +25 -16
  272. package/src/core/model/ModuleRegistry.d.ts +2 -2
  273. package/src/core/model/ModuleRegistry.d.ts.map +1 -1
  274. package/src/core/model/ModuleRegistry.js +1 -1
  275. package/src/core/model/node-graph/json/serializeNodeGraphToJSON.d.ts +1 -1
  276. package/src/core/model/node-graph/json/serializeNodeGraphToJSON.js +2 -2
  277. package/src/core/model/object/objectDeepEquals.d.ts +2 -2
  278. package/src/core/model/object/objectDeepEquals.d.ts.map +1 -1
  279. package/src/core/model/object/objectDeepEquals.js +1 -1
  280. package/src/core/model/reactive/model/ReactiveExpression.d.ts +2 -2
  281. package/src/core/model/reactive/model/ReactiveExpression.d.ts.map +1 -1
  282. package/src/core/model/reactive/model/ReactiveExpression.js +1 -1
  283. package/src/core/model/validate_enum_schema.d.ts +2 -3
  284. package/src/core/model/validate_enum_schema.d.ts.map +1 -1
  285. package/src/core/model/validate_enum_schema.js +1 -1
  286. package/src/core/process/Future.d.ts +3 -3
  287. package/src/core/process/Future.d.ts.map +1 -1
  288. package/src/core/process/Future.js +13 -1
  289. package/src/core/process/PromiseWatcher.d.ts.map +1 -1
  290. package/src/core/process/PromiseWatcher.js +9 -2
  291. package/src/core/process/executor/ConcurrentExecutor.d.ts.map +1 -1
  292. package/src/core/process/executor/ConcurrentExecutor.js +12 -2
  293. package/src/core/process/task/Task.d.ts +3 -3
  294. package/src/core/process/task/Task.d.ts.map +1 -1
  295. package/src/core/process/task/Task.js +2 -2
  296. package/src/core/process/task/util/countTask.d.ts +2 -2
  297. package/src/core/process/task/util/countTask.d.ts.map +1 -1
  298. package/src/core/process/task/util/countTask.js +1 -1
  299. package/src/core/process/task/util/randomCountTask.d.ts +2 -2
  300. package/src/core/process/task/util/randomCountTask.d.ts.map +1 -1
  301. package/src/core/process/task/util/randomCountTask.js +1 -1
  302. package/src/core/process/worker/WorkerProxy.d.ts.map +1 -1
  303. package/src/core/process/worker/WorkerProxy.js +5 -2
  304. package/src/core/process/worker/extractTransferables.d.ts.map +1 -1
  305. package/src/core/process/worker/extractTransferables.js +4 -1
  306. package/src/engine/Engine.d.ts +12 -12
  307. package/src/engine/Engine.d.ts.map +1 -1
  308. package/src/engine/Engine.js +149 -10
  309. package/src/engine/animation/Animations.d.ts +4 -4
  310. package/src/engine/animation/Animations.d.ts.map +1 -1
  311. package/src/engine/animation/Animations.js +2 -2
  312. package/src/engine/animation/EntityAnimation.d.ts +5 -5
  313. package/src/engine/animation/EntityAnimation.d.ts.map +1 -1
  314. package/src/engine/animation/EntityAnimation.js +2 -2
  315. package/src/engine/animation/TransitionFunctions.d.ts +1 -4
  316. package/src/engine/animation/TransitionFunctions.d.ts.map +1 -1
  317. package/src/engine/animation/TransitionFunctions.js +1 -1
  318. package/src/engine/animation/Tween.d.ts +4 -4
  319. package/src/engine/animation/Tween.d.ts.map +1 -1
  320. package/src/engine/animation/Tween.js +2 -2
  321. package/src/engine/asset/AssetManager.d.ts +6 -6
  322. package/src/engine/asset/AssetManager.d.ts.map +1 -1
  323. package/src/engine/asset/AssetManager.js +1411 -1411
  324. package/src/engine/asset/AssetRequest.d.ts +4 -4
  325. package/src/engine/asset/AssetRequest.d.ts.map +1 -1
  326. package/src/engine/asset/AssetRequest.js +3 -3
  327. package/src/engine/asset/loaders/ArrayBufferLoader.d.ts.map +1 -1
  328. package/src/engine/asset/loaders/ArrayBufferLoader.js +7 -0
  329. package/src/engine/asset/loaders/AssetLoader.d.ts +3 -3
  330. package/src/engine/asset/loaders/AssetLoader.d.ts.map +1 -1
  331. package/src/engine/asset/loaders/AssetLoader.js +2 -2
  332. package/src/engine/control/first-person/FirstPersonPlayerControllerSystem.d.ts +0 -10
  333. package/src/engine/control/first-person/FirstPersonPlayerControllerSystem.d.ts.map +1 -1
  334. package/src/engine/ecs/EntityComponentDataset.d.ts +6 -6
  335. package/src/engine/ecs/EntityComponentDataset.d.ts.map +1 -1
  336. package/src/engine/ecs/EntityComponentDataset.js +3 -3
  337. package/src/engine/ecs/EntityManager.d.ts +4 -4
  338. package/src/engine/ecs/EntityManager.js +4 -4
  339. package/src/engine/ecs/EntityObserver.d.ts +3 -3
  340. package/src/engine/ecs/EntityObserver.d.ts.map +1 -1
  341. package/src/engine/ecs/EntityObserver.js +2 -2
  342. package/src/engine/ecs/System.d.ts +4 -4
  343. package/src/engine/ecs/System.d.ts.map +1 -1
  344. package/src/engine/ecs/System.js +2 -2
  345. package/src/engine/ecs/dynamic_actions/DynamicActorSystem.d.ts +2 -3
  346. package/src/engine/ecs/dynamic_actions/DynamicActorSystem.d.ts.map +1 -1
  347. package/src/engine/ecs/dynamic_actions/DynamicActorSystem.js +1 -1
  348. package/src/engine/ecs/grid/pick.d.ts +4 -2
  349. package/src/engine/ecs/grid/pick.d.ts.map +1 -1
  350. package/src/engine/ecs/grid/pick.js +1 -1
  351. package/src/engine/ecs/parent/EntityNode.d.ts +4 -4
  352. package/src/engine/ecs/parent/EntityNode.d.ts.map +1 -1
  353. package/src/engine/ecs/parent/EntityNode.js +2 -2
  354. package/src/engine/ecs/speaker/lines/sets/LineSetDescription.d.ts.map +1 -1
  355. package/src/engine/ecs/speaker/lines/sets/LineSetDescription.js +3 -1
  356. package/src/engine/ecs/storage/binary/collection/BinaryCollectionDeSerializer.d.ts +2 -2
  357. package/src/engine/ecs/storage/binary/collection/BinaryCollectionDeSerializer.d.ts.map +1 -1
  358. package/src/engine/ecs/storage/binary/collection/BinaryCollectionDeSerializer.js +1 -1
  359. package/src/engine/ecs/storage/binary/collection/BinaryCollectionHeaderCodec.d.ts +1 -2
  360. package/src/engine/ecs/storage/binary/collection/BinaryCollectionHeaderCodec.d.ts.map +1 -1
  361. package/src/engine/ecs/systems/AnimationSystem.d.ts +0 -5
  362. package/src/engine/ecs/systems/AnimationSystem.d.ts.map +1 -1
  363. package/src/engine/ecs/terrain/ecs/TerrainSystem.d.ts +2 -2
  364. package/src/engine/ecs/terrain/ecs/TerrainSystem.d.ts.map +1 -1
  365. package/src/engine/ecs/terrain/ecs/TerrainSystem.js +5 -2
  366. package/src/engine/ecs/terrain/tiles/TerrainTileManager.d.ts +34 -5
  367. package/src/engine/ecs/terrain/tiles/TerrainTileManager.d.ts.map +1 -1
  368. package/src/engine/ecs/terrain/tiles/TerrainTileManager.js +87 -26
  369. package/src/engine/ecs/terrain/util/obtainTerrain.d.ts +2 -3
  370. package/src/engine/ecs/terrain/util/obtainTerrain.d.ts.map +1 -1
  371. package/src/engine/ecs/terrain/util/obtainTerrain.js +1 -1
  372. package/src/engine/ecs/util/hideEntityGracefully.js +2 -2
  373. package/src/engine/graphics/CONTEXT_LOSS_RECOVERY_PLAN.md +446 -0
  374. package/src/engine/graphics/FrameRunner.d.ts +2 -2
  375. package/src/engine/graphics/FrameRunner.d.ts.map +1 -1
  376. package/src/engine/graphics/FrameRunner.js +1 -1
  377. package/src/engine/graphics/GraphicsEngine.d.ts +60 -9
  378. package/src/engine/graphics/GraphicsEngine.d.ts.map +1 -1
  379. package/src/engine/graphics/GraphicsEngine.js +197 -25
  380. package/src/engine/graphics/camera/CameraShake.d.ts +6 -6
  381. package/src/engine/graphics/camera/CameraShake.d.ts.map +1 -1
  382. package/src/engine/graphics/context/WebGLContextFailureReason.d.ts +9 -0
  383. package/src/engine/graphics/context/WebGLContextFailureReason.d.ts.map +1 -0
  384. package/src/engine/graphics/context/WebGLContextFailureReason.js +17 -0
  385. package/src/engine/graphics/context/WebGLContextMonitor.d.ts +106 -0
  386. package/src/engine/graphics/context/WebGLContextMonitor.d.ts.map +1 -0
  387. package/src/engine/graphics/context/WebGLContextMonitor.js +341 -0
  388. package/src/engine/graphics/context/WebGLContextState.d.ts +14 -0
  389. package/src/engine/graphics/context/WebGLContextState.d.ts.map +1 -0
  390. package/src/engine/graphics/context/WebGLContextState.js +24 -0
  391. package/src/engine/graphics/context/testWebGLContextLoss.d.ts +2 -0
  392. package/src/engine/graphics/context/testWebGLContextLoss.d.ts.map +1 -0
  393. package/src/engine/graphics/context/testWebGLContextLoss.js +696 -0
  394. package/src/engine/graphics/ecs/camera/CameraSystem.d.ts +2 -2
  395. package/src/engine/graphics/ecs/camera/CameraSystem.d.ts.map +1 -1
  396. package/src/engine/graphics/ecs/camera/CameraSystem.js +1 -1
  397. package/src/engine/graphics/ecs/camera/serialization/CameraSerializationAdapter.d.ts.map +1 -1
  398. package/src/engine/graphics/ecs/camera/serialization/CameraSerializationAdapter.js +68 -32
  399. package/src/engine/graphics/ecs/camera/serialization/CameraSerializationUpgrader_0_1.d.ts +14 -0
  400. package/src/engine/graphics/ecs/camera/serialization/CameraSerializationUpgrader_0_1.d.ts.map +1 -0
  401. package/src/engine/graphics/ecs/camera/serialization/CameraSerializationUpgrader_0_1.js +41 -0
  402. package/src/engine/graphics/ecs/decal/v2/FPDecalSystem.d.ts +2 -3
  403. package/src/engine/graphics/ecs/decal/v2/FPDecalSystem.d.ts.map +1 -1
  404. package/src/engine/graphics/ecs/decal/v2/FPDecalSystem.js +2 -2
  405. package/src/engine/graphics/ecs/light/three/ThreeLightCache.d.ts +1 -1
  406. package/src/engine/graphics/ecs/light/three/ThreeLightCache.js +1 -1
  407. package/src/engine/graphics/ecs/mesh-v2/ShadedGeometrySystem.d.ts +4 -5
  408. package/src/engine/graphics/ecs/mesh-v2/ShadedGeometrySystem.d.ts.map +1 -1
  409. package/src/engine/graphics/ecs/mesh-v2/ShadedGeometrySystem.js +7 -2
  410. package/src/engine/graphics/ecs/trail2d/Trail2DSystem.d.ts +1 -1
  411. package/src/engine/graphics/ecs/trail2d/Trail2DSystem.d.ts.map +1 -1
  412. package/src/engine/graphics/ecs/trail2d/Trail2DSystem.js +2 -1
  413. package/src/engine/graphics/ecs/trail3d/Trail3DSystem.d.ts +1 -1
  414. package/src/engine/graphics/ecs/trail3d/Trail3DSystem.d.ts.map +1 -1
  415. package/src/engine/graphics/ecs/trail3d/Trail3DSystem.js +3 -5
  416. package/src/engine/graphics/geometry/MikkT/BuildNeighborsFast.d.ts.map +1 -1
  417. package/src/engine/graphics/geometry/MikkT/BuildNeighborsFast.js +3 -2
  418. package/src/engine/graphics/geometry/MikkT/GenerateSharedVerticesIndexList.d.ts.map +1 -1
  419. package/src/engine/graphics/geometry/MikkT/GenerateSharedVerticesIndexList.js +3 -1
  420. package/src/engine/graphics/geometry/computeBoundingSphereFromVertexData.d.ts +2 -2
  421. package/src/engine/graphics/geometry/computeBoundingSphereFromVertexData.js +1 -1
  422. package/src/engine/graphics/geometry/computeMeshSurfaceArea.js +1 -1
  423. package/src/engine/graphics/geometry/instancing/InstancedMeshGroup.d.ts +2 -2
  424. package/src/engine/graphics/geometry/instancing/InstancedMeshGroup.d.ts.map +1 -1
  425. package/src/engine/graphics/geometry/instancing/InstancedMeshGroup.js +1 -1
  426. package/src/engine/graphics/geometry/ribbon/Ribbon.d.ts +2 -2
  427. package/src/engine/graphics/geometry/ribbon/Ribbon.d.ts.map +1 -1
  428. package/src/engine/graphics/geometry/ribbon/Ribbon.js +1 -1
  429. package/src/engine/graphics/load_and_set_cubemap_v0.d.ts +5 -0
  430. package/src/engine/graphics/load_and_set_cubemap_v0.d.ts.map +1 -1
  431. package/src/engine/graphics/load_and_set_cubemap_v0.js +26 -21
  432. package/src/engine/graphics/particles/particular/engine/emitter/ParticleEmitter.d.ts +2 -2
  433. package/src/engine/graphics/particles/particular/engine/emitter/ParticleEmitter.d.ts.map +1 -1
  434. package/src/engine/graphics/particles/particular/engine/emitter/ParticleEmitter.js +1 -1
  435. package/src/engine/graphics/particles/particular/engine/emitter/computeEmissionFunction.d.ts +2 -2
  436. package/src/engine/graphics/particles/particular/engine/emitter/computeEmissionFunction.d.ts.map +1 -1
  437. package/src/engine/graphics/particles/particular/engine/emitter/computeEmissionFunction.js +1 -1
  438. package/src/engine/graphics/particles/particular/engine/utils/distrubuteParticlesOnMesh.d.ts +2 -2
  439. package/src/engine/graphics/particles/particular/engine/utils/distrubuteParticlesOnMesh.d.ts.map +1 -1
  440. package/src/engine/graphics/particles/particular/engine/utils/distrubuteParticlesOnMesh.js +1 -1
  441. package/src/engine/graphics/particles/particular/group/ParticleGroup.d.ts.map +1 -1
  442. package/src/engine/graphics/particles/particular/group/ParticleGroup.js +19 -8
  443. package/src/engine/graphics/particles/particular/group/optimizeCommandQueue.js +1 -1
  444. package/src/engine/graphics/render/RendererPool.d.ts +4 -4
  445. package/src/engine/graphics/render/RendererPool.d.ts.map +1 -1
  446. package/src/engine/graphics/render/RendererPool.js +2 -2
  447. package/src/engine/graphics/render/frame_graph/FrameGraph.d.ts +5 -4
  448. package/src/engine/graphics/render/frame_graph/FrameGraph.d.ts.map +1 -1
  449. package/src/engine/graphics/render/frame_graph/FrameGraph.js +2 -2
  450. package/src/engine/graphics/render/layers/RenderLayer.d.ts +2 -2
  451. package/src/engine/graphics/render/layers/RenderLayer.d.ts.map +1 -1
  452. package/src/engine/graphics/render/layers/RenderLayer.js +1 -1
  453. package/src/engine/graphics/render/layers/RenderLayerUtils.js +1 -1
  454. package/src/engine/graphics/sh3/lightmap/bake_lightmap_for_scene.d.ts +3 -1
  455. package/src/engine/graphics/sh3/lightmap/bake_lightmap_for_scene.d.ts.map +1 -1
  456. package/src/engine/graphics/sh3/lightmap/bake_lightmap_for_scene.js +681 -681
  457. package/src/engine/graphics/sh3/lightmap/lightmap_rasterize_triangle.d.ts +2 -2
  458. package/src/engine/graphics/sh3/lightmap/lightmap_rasterize_triangle.d.ts.map +1 -1
  459. package/src/engine/graphics/sh3/lightmap/lightmap_rasterize_triangle.js +145 -145
  460. package/src/engine/graphics/sh3/lpv/PathTracerProbeRenderer.d.ts +2 -1
  461. package/src/engine/graphics/sh3/lpv/PathTracerProbeRenderer.d.ts.map +1 -1
  462. package/src/engine/graphics/texture/atlas/AtlasLookupTexture.d.ts.map +1 -1
  463. package/src/engine/graphics/texture/atlas/AtlasLookupTexture.js +10 -3
  464. package/src/engine/graphics/texture/atlas/TextureAtlas.d.ts.map +1 -1
  465. package/src/engine/graphics/texture/atlas/TextureAtlas.js +4 -1
  466. package/src/engine/graphics/texture/atlas/gpu/WebGLTextureAtlas.d.ts.map +1 -1
  467. package/src/engine/graphics/texture/atlas/gpu/WebGLTextureAtlas.js +11 -0
  468. package/src/engine/graphics/texture/cubemap/load_environment_map.d.ts.map +1 -1
  469. package/src/engine/graphics/texture/cubemap/load_environment_map.js +5 -2
  470. package/src/engine/graphics/texture/sampler/Sampler2D.d.ts +2 -2
  471. package/src/engine/graphics/texture/sampler/Sampler2D.d.ts.map +1 -1
  472. package/src/engine/graphics/texture/sampler/Sampler2D.js +1 -1
  473. package/src/engine/graphics/texture/sampler/distance/computeSignedDistanceField_Chamfer.d.ts.map +1 -1
  474. package/src/engine/graphics/texture/sampler/distance/computeSignedDistanceField_Chamfer.js +26 -18
  475. package/src/engine/graphics/texture/sampler/filter/sampler2d_blur_gaussian.d.ts +15 -2
  476. package/src/engine/graphics/texture/sampler/filter/sampler2d_blur_gaussian.d.ts.map +1 -1
  477. package/src/engine/graphics/texture/sampler/filter/sampler2d_blur_gaussian.js +29 -3
  478. package/src/engine/graphics/texture/sampler/resize/sampler2d_scale_down_lanczos.d.ts +14 -1
  479. package/src/engine/graphics/texture/sampler/resize/sampler2d_scale_down_lanczos.d.ts.map +1 -1
  480. package/src/engine/graphics/texture/sampler/resize/sampler2d_scale_down_lanczos.js +148 -171
  481. package/src/engine/graphics/texture/sampler/sampler2d_combine.d.ts +2 -2
  482. package/src/engine/graphics/texture/sampler/sampler2d_combine.d.ts.map +1 -1
  483. package/src/engine/graphics/texture/sampler/sampler2d_combine.js +1 -1
  484. package/src/engine/graphics/texture/sampler/sampler2d_paint.js +1 -1
  485. package/src/engine/graphics/texture/sampler/util/bitSet2Sampler2D.js +2 -2
  486. package/src/engine/graphics/texture/virtual/VirtualTextureTileLoader.d.ts +1 -1
  487. package/src/engine/graphics/texture/virtual/VirtualTextureTileLoader.js +2 -2
  488. package/src/engine/grid/obstacle/GridObstacle.d.ts +2 -2
  489. package/src/engine/grid/obstacle/GridObstacle.d.ts.map +1 -1
  490. package/src/engine/grid/obstacle/GridObstacle.js +1 -1
  491. package/src/engine/input/ecs/util/TopDownCameraControllerHelper.d.ts.map +1 -1
  492. package/src/engine/input/ecs/util/TopDownCameraControllerHelper.js +10 -3
  493. package/src/engine/intelligence/behavior/ecs/BehaviorComponent.d.ts +2 -2
  494. package/src/engine/intelligence/behavior/ecs/BehaviorComponent.d.ts.map +1 -1
  495. package/src/engine/intelligence/behavior/ecs/BehaviorComponent.js +1 -1
  496. package/src/engine/intelligence/behavior/primitive/ActionBehavior.d.ts +3 -3
  497. package/src/engine/intelligence/behavior/primitive/ActionBehavior.d.ts.map +1 -1
  498. package/src/engine/intelligence/behavior/primitive/ActionBehavior.js +1 -1
  499. package/src/engine/intelligence/behavior/util/RandomDelayBehavior.d.ts +2 -1
  500. package/src/engine/intelligence/behavior/util/RandomDelayBehavior.d.ts.map +1 -1
  501. package/src/engine/intelligence/blackboard/Blackboard.d.ts +4 -4
  502. package/src/engine/intelligence/blackboard/Blackboard.d.ts.map +1 -1
  503. package/src/engine/intelligence/blackboard/Blackboard.js +2 -2
  504. package/src/engine/intelligence/mcts/MonteCarlo.d.ts +17 -15
  505. package/src/engine/intelligence/mcts/MonteCarlo.d.ts.map +1 -1
  506. package/src/engine/intelligence/mcts/MonteCarlo.js +345 -345
  507. package/src/engine/intelligence/mcts/StateNode.d.ts +2 -2
  508. package/src/engine/intelligence/mcts/StateNode.d.ts.map +1 -1
  509. package/src/engine/intelligence/mcts/StateNode.js +364 -364
  510. package/src/engine/intelligence/optimization/RandomOptimizer.d.ts +3 -3
  511. package/src/engine/intelligence/optimization/RandomOptimizer.d.ts.map +1 -1
  512. package/src/engine/intelligence/optimization/RandomOptimizer.js +2 -2
  513. package/src/engine/intelligence/optimization/optimize_cyclic_sequence_pairwise.d.ts +2 -2
  514. package/src/engine/intelligence/optimization/optimize_cyclic_sequence_pairwise.d.ts.map +1 -1
  515. package/src/engine/intelligence/optimization/optimize_cyclic_sequence_pairwise.js +1 -1
  516. package/src/engine/knowledge/database/StaticKnowledgeDataTable.d.ts +4 -5
  517. package/src/engine/knowledge/database/StaticKnowledgeDataTable.d.ts.map +1 -1
  518. package/src/engine/knowledge/database/StaticKnowledgeDataTable.js +2 -2
  519. package/src/engine/navigation/ecs/components/PathSerializationUpgrader_2_3.d.ts +14 -0
  520. package/src/engine/navigation/ecs/components/PathSerializationUpgrader_2_3.d.ts.map +1 -0
  521. package/src/engine/navigation/ecs/components/PathSerializationUpgrader_2_3.js +38 -0
  522. package/src/engine/navigation/ecs/path_following/PathFollowingSystem.d.ts +0 -5
  523. package/src/engine/navigation/ecs/path_following/PathFollowingSystem.d.ts.map +1 -1
  524. package/src/engine/network/orchestrator/ServerAuthoritativeClient.d.ts.map +1 -1
  525. package/src/engine/network/orchestrator/ServerAuthoritativeClient.js +433 -425
  526. package/src/engine/physics/constraint/solve_constraints.d.ts +4 -1
  527. package/src/engine/physics/constraint/solve_constraints.d.ts.map +1 -1
  528. package/src/engine/physics/constraint/solve_constraints.js +38 -13
  529. package/src/engine/physics/contact/ManifoldStore.d.ts +15 -3
  530. package/src/engine/physics/contact/ManifoldStore.d.ts.map +1 -1
  531. package/src/engine/physics/contact/ManifoldStore.js +15 -3
  532. package/src/engine/physics/ecs/Joint.d.ts +7 -4
  533. package/src/engine/physics/ecs/Joint.d.ts.map +1 -1
  534. package/src/engine/physics/ecs/Joint.js +7 -4
  535. package/src/engine/physics/ecs/PhysicsSystem.d.ts +14 -0
  536. package/src/engine/physics/ecs/PhysicsSystem.d.ts.map +1 -1
  537. package/src/engine/physics/ecs/PhysicsSystem.js +16 -0
  538. package/src/engine/physics/fluid/ecs/FluidObstacleSystem.d.ts +4 -8
  539. package/src/engine/physics/fluid/ecs/FluidObstacleSystem.d.ts.map +1 -1
  540. package/src/engine/physics/fluid/ecs/FluidSystem.d.ts +3 -7
  541. package/src/engine/physics/fluid/ecs/FluidSystem.d.ts.map +1 -1
  542. package/src/engine/physics/narrowphase/convex_convex_manifold.d.ts +15 -7
  543. package/src/engine/physics/narrowphase/convex_convex_manifold.d.ts.map +1 -1
  544. package/src/engine/physics/narrowphase/convex_convex_manifold.js +33 -10
  545. package/src/engine/physics/narrowphase/refine_ray_concave.d.ts +6 -2
  546. package/src/engine/physics/narrowphase/refine_ray_concave.d.ts.map +1 -1
  547. package/src/engine/physics/narrowphase/refine_ray_concave.js +6 -2
  548. package/src/engine/physics/narrowphase/refine_ray_hit.d.ts +6 -2
  549. package/src/engine/physics/narrowphase/refine_ray_hit.d.ts.map +1 -1
  550. package/src/engine/physics/narrowphase/refine_ray_hit.js +6 -2
  551. package/src/engine/physics/queries/raycast.d.ts.map +1 -1
  552. package/src/engine/physics/queries/raycast.js +11 -4
  553. package/src/engine/save/GameStateLoader.d.ts +2 -2
  554. package/src/engine/save/GameStateLoader.d.ts.map +1 -1
  555. package/src/engine/save/GameStateLoader.js +1 -1
  556. package/src/engine/save/Storage.d.ts +4 -4
  557. package/src/engine/save/Storage.d.ts.map +1 -1
  558. package/src/engine/save/Storage.js +2 -2
  559. package/src/engine/save/storage/IndexedDBStorage.d.ts.map +1 -1
  560. package/src/engine/save/storage/IndexedDBStorage.js +24 -5
  561. package/src/engine/simulation/Ticker.d.ts +12 -0
  562. package/src/engine/simulation/Ticker.d.ts.map +1 -1
  563. package/src/engine/simulation/Ticker.js +18 -0
  564. package/src/engine/sound/simulation/AcousticSimulator.d.ts.map +1 -1
  565. package/src/engine/sound/simulation/AcousticSimulator.js +9 -1
  566. package/src/engine/sound/simulation/core/VolumeField.d.ts +6 -2
  567. package/src/engine/sound/simulation/core/VolumeField.d.ts.map +1 -1
  568. package/src/engine/sound/simulation/core/VolumeField.js +6 -2
  569. package/src/engine/sound/simulation/probe/AcousticProbeField.d.ts +6 -2
  570. package/src/engine/sound/simulation/probe/AcousticProbeField.d.ts.map +1 -1
  571. package/src/engine/sound/simulation/probe/AcousticProbeField.js +6 -2
  572. package/src/engine/sound/simulation/probe/acoustic_probe_transfer.d.ts +6 -2
  573. package/src/engine/sound/simulation/probe/acoustic_probe_transfer.d.ts.map +1 -1
  574. package/src/engine/sound/simulation/probe/acoustic_probe_transfer.js +6 -2
  575. package/src/engine/sound/simulation/probe/bakeProbeReflectors.d.ts +3 -1
  576. package/src/engine/sound/simulation/probe/bakeProbeReflectors.d.ts.map +1 -1
  577. package/src/engine/sound/simulation/probe/bakeProbeReflectors.js +3 -1
  578. package/src/engine/sound/simulation/prototypeAcousticSolver.js +1652 -1652
  579. package/src/engine/sound/sopra/util/buildAttenuationCurve.d.ts +2 -2
  580. package/src/engine/sound/sopra/util/buildAttenuationCurve.d.ts.map +1 -1
  581. package/src/engine/sound/sopra/util/buildAttenuationCurve.js +40 -40
  582. package/src/engine/ui/GUIEngine.d.ts.map +1 -1
  583. package/src/engine/ui/GUIEngine.js +8 -1
  584. package/src/engine/ui/notification/NotificationManager.d.ts +5 -5
  585. package/src/engine/ui/notification/NotificationManager.d.ts.map +1 -1
  586. package/src/engine/ui/notification/NotificationManager.js +4 -4
  587. package/src/engine/ui/tiles2d/TileGrid.d.ts +2 -2
  588. package/src/engine/ui/tiles2d/TileGrid.d.ts.map +1 -1
  589. package/src/engine/ui/tiles2d/TileGrid.js +1 -1
  590. package/src/generation/filtering/numeric/complex/CellFilterSimplexNoise.d.ts +1 -1
  591. package/src/generation/filtering/numeric/complex/CellFilterSimplexNoise.js +1 -1
  592. package/src/generation/grid/generation/road/GridTaskGenerateRoads.js +2 -2
  593. package/src/generation/grid/generation/util/buildPathFromDistanceMap.d.ts +1 -1
  594. package/src/generation/grid/generation/util/buildPathFromDistanceMap.js +1 -1
  595. package/src/generation/markers/actions/placement/MarkerNodeEntityProcessorRandomRotation.d.ts +2 -1
  596. package/src/generation/markers/actions/placement/MarkerNodeEntityProcessorRandomRotation.d.ts.map +1 -1
  597. package/src/generation/markers/actions/probability/MarkerNodeActionSelectWeighted.d.ts +2 -1
  598. package/src/generation/markers/actions/probability/MarkerNodeActionSelectWeighted.d.ts.map +1 -1
  599. package/src/generation/markers/transform/MarkerNodeTransformRotateRandom.d.ts +2 -1
  600. package/src/generation/markers/transform/MarkerNodeTransformRotateRandom.d.ts.map +1 -1
  601. package/src/generation/markers/transform/MarkerNodeTransformerRecordPropertyClosure.d.ts +4 -3
  602. package/src/generation/markers/transform/MarkerNodeTransformerRecordPropertyClosure.d.ts.map +1 -1
  603. package/src/generation/markers/transform/MarkerNodeTransformerRecordPropertyClosure.js +1 -1
  604. package/src/generation/markers/transform/MarkerNodeTransformerRecordUniqueRandomEnum.d.ts +2 -1
  605. package/src/generation/markers/transform/MarkerNodeTransformerRecordUniqueRandomEnum.d.ts.map +1 -1
  606. package/src/generation/theme/TerrainTheme.d.ts.map +1 -1
  607. package/src/generation/theme/TerrainTheme.js +2 -1
  608. package/src/generation/theme/ThemeEngine.d.ts.map +1 -1
  609. package/src/generation/theme/ThemeEngine.js +6 -5
  610. package/src/view/ViewGroup.d.ts.map +1 -1
  611. package/src/view/ViewGroup.js +9 -7
  612. package/src/view/common/VirtualListView.d.ts +1 -1
  613. package/src/view/common/VirtualListView.js +1 -1
  614. package/src/view/graphics/WebGLContextFailureView.d.ts +19 -0
  615. package/src/view/graphics/WebGLContextFailureView.d.ts.map +1 -0
  616. package/src/view/graphics/WebGLContextFailureView.js +76 -0
  617. package/src/view/minimap/Minimap.d.ts +8 -0
  618. package/src/view/minimap/Minimap.d.ts.map +1 -1
  619. package/src/view/minimap/Minimap.js +16 -3
  620. package/src/view/minimap/dom/MinimapMarkerView.d.ts.map +1 -1
  621. package/src/view/minimap/dom/MinimapMarkerView.js +3 -1
  622. package/src/view/tooltip/gml/compiler/GMLReferenceCompiler.d.ts +2 -2
  623. package/src/view/tooltip/gml/compiler/GMLReferenceCompiler.d.ts.map +1 -1
  624. package/src/view/tooltip/gml/compiler/GMLReferenceCompiler.js +1 -1
@@ -0,0 +1,696 @@
1
+ import { Color as ThreeColor, Mesh, MeshStandardMaterial, SphereGeometry, WebGLRenderer } from "three";
2
+ import Vector3 from "../../../core/geom/Vector3.js";
3
+ import Entity from "../../ecs/Entity.js";
4
+ import Renderable from "../../ecs/renderable/Renderable.js";
5
+ import RenderSystem from "../../ecs/renderable/RenderSystem.js";
6
+ import { Transform } from "../../ecs/transform/Transform.js";
7
+ import { EngineHarness } from "../../EngineHarness.js";
8
+ import { configureThreeRenderer } from "../GraphicsEngine.js";
9
+ import { load_and_set_cubemap_v0 } from "../load_and_set_cubemap_v0.js";
10
+ import { WebGLContextState } from "./WebGLContextState.js";
11
+
12
+ /**
13
+ * WebGL context loss / restore harness.
14
+ *
15
+ * Drives the engine by hand (no rAF, so it works in a hidden tab), forces context loss through
16
+ * `WEBGL_lose_context`, and compares the framebuffer before and after restore. Read the report from
17
+ * the console or from `window.__context_loss_report`.
18
+ *
19
+ * Scenarios:
20
+ * - `window.__context_loss_test.run()` single loss/restore cycle with a full pixel A/B
21
+ * - `window.__context_loss_test.repeat(n)` n cycles, watching `renderer.info.memory` for leaks
22
+ *
23
+ * The scene is deliberately static (no water, no behaviours) so that two consecutive frames are
24
+ * pixel-identical; the noise floor between two pre-loss captures is reported so the post-restore
25
+ * difference is interpretable.
26
+ */
27
+
28
+ const harness = new EngineHarness();
29
+
30
+ const SPHERE_POSITION = new Vector3(0, 2, 0);
31
+
32
+ /**
33
+ * Grid resolution for the per-region luminance breakdown
34
+ * @type {number}
35
+ */
36
+ const REGION_GRID = 4;
37
+
38
+ const scratch_color = new ThreeColor();
39
+
40
+ const VIEWPORT_WIDTH = 800;
41
+ const VIEWPORT_HEIGHT = 600;
42
+
43
+ /**
44
+ *
45
+ * @param {Engine} engine
46
+ * @returns {WebGLRenderer}
47
+ */
48
+ function get_renderer(engine) {
49
+ return engine.graphics.renderer;
50
+ }
51
+
52
+ /**
53
+ * Advance the simulation and draw one frame
54
+ * @param {Engine} engine
55
+ * @param {number} [dt]
56
+ * @returns {number} frame duration in milliseconds
57
+ */
58
+ function frame(engine, dt = 1 / 60) {
59
+ const t0 = performance.now();
60
+
61
+ engine.ticker.onTick.send1(dt);
62
+ engine.render();
63
+
64
+ return performance.now() - t0;
65
+ }
66
+
67
+ /**
68
+ * Reads the default framebuffer. Must run in the same task as the draw, the drawing buffer is not
69
+ * preserved across a compositor frame.
70
+ * @param {Engine} engine
71
+ * @returns {{width:number, height:number, mean:number[], luminance:number, regions:number[], hash:number, nonzero:number}}
72
+ */
73
+ function capture(engine) {
74
+ const renderer = get_renderer(engine);
75
+ const gl = renderer.getContext();
76
+
77
+ renderer.setRenderTarget(null);
78
+
79
+ const width = gl.drawingBufferWidth;
80
+ const height = gl.drawingBufferHeight;
81
+
82
+ const pixels = new Uint8Array(width * height * 4);
83
+
84
+ gl.readPixels(0, 0, width, height, gl.RGBA, gl.UNSIGNED_BYTE, pixels);
85
+
86
+ const mean = [0, 0, 0, 0];
87
+ const regions = new Array(REGION_GRID * REGION_GRID).fill(0);
88
+ const region_counts = new Array(REGION_GRID * REGION_GRID).fill(0);
89
+
90
+ let nonzero = 0;
91
+ let hash = 0x811c9dc5;
92
+
93
+ for (let y = 0; y < height; y++) {
94
+ const region_y = Math.min(REGION_GRID - 1, Math.floor((y / height) * REGION_GRID));
95
+
96
+ for (let x = 0; x < width; x++) {
97
+ const address = (y * width + x) * 4;
98
+
99
+ const r = pixels[address];
100
+ const g = pixels[address + 1];
101
+ const b = pixels[address + 2];
102
+ const a = pixels[address + 3];
103
+
104
+ mean[0] += r;
105
+ mean[1] += g;
106
+ mean[2] += b;
107
+ mean[3] += a;
108
+
109
+ if (r !== 0 || g !== 0 || b !== 0) {
110
+ nonzero++;
111
+ }
112
+
113
+ // Rec.709 luma, close enough for an A/B
114
+ const luma = 0.2126 * r + 0.7152 * g + 0.0722 * b;
115
+
116
+ const region_x = Math.min(REGION_GRID - 1, Math.floor((x / width) * REGION_GRID));
117
+ const region = region_y * REGION_GRID + region_x;
118
+
119
+ regions[region] += luma;
120
+ region_counts[region]++;
121
+
122
+ hash = ((hash ^ r) * 0x01000193) >>> 0;
123
+ hash = ((hash ^ g) * 0x01000193) >>> 0;
124
+ hash = ((hash ^ b) * 0x01000193) >>> 0;
125
+ }
126
+ }
127
+
128
+ const pixel_count = width * height;
129
+
130
+ for (let i = 0; i < 4; i++) {
131
+ mean[i] = mean[i] / pixel_count;
132
+ }
133
+
134
+ for (let i = 0; i < regions.length; i++) {
135
+ regions[i] = region_counts[i] === 0 ? 0 : regions[i] / region_counts[i];
136
+ }
137
+
138
+ return {
139
+ width,
140
+ height,
141
+ mean: mean.map(v => Number(v.toFixed(3))),
142
+ luminance: Number((0.2126 * mean[0] + 0.7152 * mean[1] + 0.0722 * mean[2]).toFixed(3)),
143
+ regions: regions.map(v => Number(v.toFixed(2))),
144
+ hash,
145
+ nonzero: Number((nonzero / pixel_count).toFixed(4))
146
+ };
147
+ }
148
+
149
+ /**
150
+ *
151
+ * @param {{luminance:number, regions:number[], hash:number, mean:number[]}} a
152
+ * @param {{luminance:number, regions:number[], hash:number, mean:number[]}} b
153
+ */
154
+ function compare(a, b) {
155
+ let region_max = 0;
156
+ let region_total = 0;
157
+
158
+ for (let i = 0; i < a.regions.length; i++) {
159
+ const d = Math.abs(a.regions[i] - b.regions[i]);
160
+
161
+ region_total += d;
162
+
163
+ if (d > region_max) {
164
+ region_max = d;
165
+ }
166
+ }
167
+
168
+ return {
169
+ identical: a.hash === b.hash,
170
+ luminance_delta: Number((b.luminance - a.luminance).toFixed(3)),
171
+ region_delta_max: Number(region_max.toFixed(3)),
172
+ region_delta_mean: Number((region_total / a.regions.length).toFixed(3))
173
+ };
174
+ }
175
+
176
+ /**
177
+ * Coarse luminance map of the framebuffer, printable in a console. The harness is expected to run in a
178
+ * hidden tab, where screenshots are not available, and an aggregate number does not tell you *what* went
179
+ * missing.
180
+ * @param {Engine} engine
181
+ * @returns {string}
182
+ */
183
+ function ascii_image(engine, columns = 40, rows = 20) {
184
+ const RAMP = ' .:-=+*#%@';
185
+
186
+ const renderer = get_renderer(engine);
187
+ const gl = renderer.getContext();
188
+
189
+ renderer.setRenderTarget(null);
190
+
191
+ const width = gl.drawingBufferWidth;
192
+ const height = gl.drawingBufferHeight;
193
+
194
+ const pixels = new Uint8Array(width * height * 4);
195
+
196
+ gl.readPixels(0, 0, width, height, gl.RGBA, gl.UNSIGNED_BYTE, pixels);
197
+
198
+ const lines = [];
199
+
200
+ // readPixels returns rows bottom-up
201
+ for (let row = rows - 1; row >= 0; row--) {
202
+ let line = '';
203
+
204
+ for (let column = 0; column < columns; column++) {
205
+ const x0 = Math.floor(column * width / columns);
206
+ const x1 = Math.floor((column + 1) * width / columns);
207
+ const y0 = Math.floor(row * height / rows);
208
+ const y1 = Math.floor((row + 1) * height / rows);
209
+
210
+ let sum = 0;
211
+ let count = 0;
212
+
213
+ for (let y = y0; y < y1; y += 3) {
214
+ for (let x = x0; x < x1; x += 3) {
215
+ const address = (y * width + x) * 4;
216
+
217
+ sum += 0.2126 * pixels[address] + 0.7152 * pixels[address + 1] + 0.0722 * pixels[address + 2];
218
+ count++;
219
+ }
220
+ }
221
+
222
+ const luma = sum / count;
223
+
224
+ line += RAMP[Math.min(RAMP.length - 1, Math.floor((luma / 255) * RAMP.length))];
225
+ }
226
+
227
+ lines.push(line);
228
+ }
229
+
230
+ return lines.join('\n');
231
+ }
232
+
233
+ /**
234
+ *
235
+ * @param {Engine} engine
236
+ */
237
+ function snapshot_renderer_state(engine) {
238
+ const renderer = get_renderer(engine);
239
+ const gl = renderer.getContext();
240
+ const info = renderer.info;
241
+
242
+ const clear_color = renderer.getClearColor(scratch_color);
243
+
244
+ return {
245
+ context_lost: gl.isContextLost(),
246
+ monitor_state: engine.graphics.context.state,
247
+ monitor_generation: engine.graphics.context.generation,
248
+ monitor_loss_count: engine.graphics.context.loss_count,
249
+ programs: info.programs === null ? -1 : info.programs.length,
250
+ textures: info.memory.textures,
251
+ geometries: info.memory.geometries,
252
+ clear_color: [
253
+ Number(clear_color.r.toFixed(4)),
254
+ Number(clear_color.g.toFixed(4)),
255
+ Number(clear_color.b.toFixed(4))
256
+ ],
257
+ clear_alpha: renderer.getClearAlpha(),
258
+ environment_set: engine.graphics.scene.environment !== null
259
+ && engine.graphics.scene.environment !== undefined,
260
+ gl_error: gl.getError()
261
+ };
262
+ }
263
+
264
+ /**
265
+ * Waits for a single event on the canvas
266
+ * @param {HTMLCanvasElement} canvas
267
+ * @param {string} name
268
+ * @param {number} timeout milliseconds
269
+ * @returns {Promise<number>} milliseconds waited, or -1 on timeout
270
+ */
271
+ function wait_for_canvas_event(canvas, name, timeout) {
272
+ return new Promise(resolve => {
273
+ const t0 = performance.now();
274
+
275
+ let timeout_handle = -1;
276
+
277
+ const handler = () => {
278
+ clearTimeout(timeout_handle);
279
+ canvas.removeEventListener(name, handler);
280
+ resolve(performance.now() - t0);
281
+ };
282
+
283
+ canvas.addEventListener(name, handler, false);
284
+
285
+ timeout_handle = setTimeout(() => {
286
+ canvas.removeEventListener(name, handler);
287
+ resolve(-1);
288
+ }, timeout);
289
+ });
290
+ }
291
+
292
+ /**
293
+ * One loss/restore cycle
294
+ * @param {Engine} engine
295
+ * @param {number} [warmup_frames]
296
+ * @param {number} [lost_frames] frames driven while the context is lost
297
+ * @param {number} [settle_frames] frames driven after restore before the second capture
298
+ */
299
+ async function run_cycle(engine, { warmup_frames = 30, lost_frames = 5, settle_frames = 20 } = {}) {
300
+ const renderer = get_renderer(engine);
301
+ const canvas = renderer.domElement;
302
+
303
+ const report = {};
304
+
305
+ // ---- baseline -------------------------------------------------------------------------------
306
+ for (let i = 0; i < warmup_frames; i++) {
307
+ frame(engine);
308
+ }
309
+
310
+ frame(engine);
311
+ const baseline = capture(engine);
312
+
313
+ frame(engine);
314
+ const baseline_2 = capture(engine);
315
+
316
+ report.baseline = baseline;
317
+ report.noise_floor = compare(baseline, baseline_2);
318
+ report.before = snapshot_renderer_state(engine);
319
+
320
+ // ---- lose ---------------------------------------------------------------------------------
321
+ const lost_promise = wait_for_canvas_event(canvas, 'webglcontextlost', 5000);
322
+
323
+ renderer.forceContextLoss();
324
+
325
+ report.lost_event_delay_ms = Number((await lost_promise).toFixed(2));
326
+
327
+ const lost_frame_errors = [];
328
+
329
+ for (let i = 0; i < lost_frames; i++) {
330
+ try {
331
+ frame(engine);
332
+ } catch (e) {
333
+ lost_frame_errors.push(String(e && e.message ? e.message : e));
334
+ }
335
+ }
336
+
337
+ report.frames_while_lost_threw = lost_frame_errors;
338
+ report.while_lost = snapshot_renderer_state(engine);
339
+
340
+ // ---- restore ------------------------------------------------------------------------------
341
+ const restored_promise = wait_for_canvas_event(canvas, 'webglcontextrestored', 10000);
342
+
343
+ renderer.forceContextRestore();
344
+
345
+ const restore_delay = await restored_promise;
346
+
347
+ report.restored_event_delay_ms = Number(restore_delay.toFixed(2));
348
+ report.restored = restore_delay >= 0;
349
+
350
+ if (!report.restored) {
351
+ report.verdict = 'context was NOT restored within 10s';
352
+ return report;
353
+ }
354
+
355
+ // first frame after restore carries the re-upload + recompile storm
356
+ report.first_frame_ms = Number(frame(engine).toFixed(2));
357
+ const first = capture(engine);
358
+
359
+ const settle_durations = [];
360
+
361
+ for (let i = 0; i < settle_frames; i++) {
362
+ settle_durations.push(frame(engine));
363
+ }
364
+
365
+ frame(engine);
366
+ const settled = capture(engine);
367
+
368
+ report.settle_frames_ms = {
369
+ max: Number(Math.max(...settle_durations).toFixed(2)),
370
+ mean: Number((settle_durations.reduce((a, b) => a + b, 0) / settle_durations.length).toFixed(2))
371
+ };
372
+
373
+ report.after = snapshot_renderer_state(engine);
374
+
375
+ report.first_frame_vs_baseline = compare(baseline, first);
376
+ report.settled_vs_baseline = compare(baseline, settled);
377
+
378
+ report.settled = settled;
379
+
380
+ return report;
381
+ }
382
+
383
+ /**
384
+ * Loss/restore lifecycle without actually killing the context: the canvas events are dispatched by hand.
385
+ *
386
+ * three.js reacts to the restore event by rebuilding all of its GPU-object bookkeeping, so everything is
387
+ * re-uploaded and every shader recompiled exactly as it would be after a real restore - the difference is
388
+ * that the underlying context stays healthy, which is what makes this runnable in a hidden tab (browsers
389
+ * only restore a genuinely lost context while the page is visible).
390
+ *
391
+ * What this covers: the engine's gate, the fix-up sequence, the environment re-bake, and three's own
392
+ * restore path. What it cannot cover: whether the browser is willing to restore, and how stale GL handles
393
+ * from the dead context behave.
394
+ *
395
+ * @param {Engine} engine
396
+ */
397
+ function run_synthetic_cycle(engine, { warmup_frames = 40, lost_frames = 5, settle_frames = 10 } = {}) {
398
+ const renderer = get_renderer(engine);
399
+ const canvas = renderer.domElement;
400
+
401
+ const report = {};
402
+
403
+ for (let i = 0; i < warmup_frames; i++) {
404
+ frame(engine);
405
+ }
406
+
407
+ frame(engine);
408
+ const baseline = capture(engine);
409
+
410
+ frame(engine);
411
+ report.noise_floor = compare(baseline, capture(engine));
412
+ report.baseline = baseline;
413
+ report.before = snapshot_renderer_state(engine);
414
+ report.baseline_image = ascii_image(engine);
415
+
416
+ // ---- loss -----------------------------------------------------------------------------------
417
+ const frame_index_before = engine.graphics.frameIndex;
418
+
419
+ canvas.dispatchEvent(new Event('webglcontextlost', { cancelable: true }));
420
+
421
+ report.state_while_lost = engine.graphics.context.state;
422
+
423
+ const errors = [];
424
+
425
+ for (let i = 0; i < lost_frames; i++) {
426
+ try {
427
+ frame(engine);
428
+ } catch (e) {
429
+ errors.push(String(e && e.message ? e.message : e));
430
+ }
431
+ }
432
+
433
+ report.frames_while_lost_threw = errors;
434
+ // the gate returns before the frame counter is touched, so this proves no drawing happened
435
+ report.frames_drawn_while_lost = engine.graphics.frameIndex - frame_index_before;
436
+
437
+ // ---- restore --------------------------------------------------------------------------------
438
+ canvas.dispatchEvent(new Event('webglcontextrestored'));
439
+
440
+ report.first_frame_ms = Number(frame(engine).toFixed(2));
441
+ const first = capture(engine);
442
+
443
+ for (let i = 0; i < settle_frames; i++) {
444
+ frame(engine);
445
+ }
446
+
447
+ frame(engine);
448
+ const settled = capture(engine);
449
+
450
+ report.after = snapshot_renderer_state(engine);
451
+ report.first_frame_vs_baseline = compare(baseline, first);
452
+ report.settled_vs_baseline = compare(baseline, settled);
453
+ report.settled = settled;
454
+ report.settled_image = ascii_image(engine);
455
+
456
+ return report;
457
+ }
458
+
459
+ /**
460
+ * Renders the same scene through a brand new renderer on a brand new context.
461
+ *
462
+ * Note that the environment map is expected to differ here: swapping the renderer is not a context
463
+ * restore, so the engine's recovery hook never runs and the prefiltered radiance is never re-baked. The
464
+ * value of this scenario is everything else - geometry, textures, shaders, render targets and the
465
+ * composit chain all have to come back from CPU-side data, and any of them failing to shows up as a
466
+ * difference beyond the known environment delta.
467
+ *
468
+ * This is the closest analogue of a restore that can be produced in a hidden tab while still exercising
469
+ * real GPU work: the object graph is untouched, but the GL-side caches are empty, so everything that
470
+ * cannot be re-derived from CPU-side data shows up as a difference against the baseline.
471
+ *
472
+ * @param {Engine} engine
473
+ */
474
+ function run_fresh_context(engine, { warmup_frames = 40, settle_frames = 10 } = {}) {
475
+ const graphics = engine.graphics;
476
+
477
+ const report = {};
478
+
479
+ for (let i = 0; i < warmup_frames; i++) {
480
+ frame(engine);
481
+ }
482
+
483
+ frame(engine);
484
+ const baseline = capture(engine);
485
+
486
+ frame(engine);
487
+ report.noise_floor = compare(baseline, capture(engine));
488
+ report.baseline = baseline;
489
+
490
+ const previous = graphics.renderer;
491
+
492
+ const canvas = document.createElement('canvas');
493
+ const context = canvas.getContext('webgl2', { antialias: false });
494
+
495
+ const fresh = new WebGLRenderer({
496
+ antialias: true,
497
+ logarithmicDepthBuffer: false,
498
+ canvas,
499
+ context,
500
+ powerPreference: 'high-performance'
501
+ });
502
+
503
+ configureThreeRenderer(fresh);
504
+
505
+ graphics.renderer = fresh;
506
+
507
+ graphics.updateSize();
508
+
509
+ report.first_frame_ms = Number(frame(engine).toFixed(2));
510
+ const first = capture(engine);
511
+
512
+ for (let i = 0; i < settle_frames; i++) {
513
+ frame(engine);
514
+ }
515
+
516
+ frame(engine);
517
+ const settled = capture(engine);
518
+
519
+ report.fresh_programs = fresh.info.programs.length;
520
+ report.fresh_textures = fresh.info.memory.textures;
521
+ report.fresh_geometries = fresh.info.memory.geometries;
522
+ report.fresh_draw_calls = fresh.info.render.calls;
523
+ report.fresh_triangles = fresh.info.render.triangles;
524
+ report.settled_image = ascii_image(engine);
525
+
526
+ graphics.renderer = previous;
527
+
528
+ graphics.updateSize();
529
+
530
+ report.first_frame_vs_baseline = compare(baseline, first);
531
+ report.settled_vs_baseline = compare(baseline, settled);
532
+
533
+ // and confirm the shared object graph was not disturbed by the swap
534
+ frame(engine);
535
+ report.restored_original_vs_baseline = compare(baseline, capture(engine));
536
+
537
+ fresh.forceContextLoss();
538
+ fresh.dispose();
539
+
540
+ return report;
541
+ }
542
+
543
+ /**
544
+ *
545
+ * @param {Engine} engine
546
+ */
547
+ function install_api(engine) {
548
+ const api = {
549
+ engine,
550
+
551
+ frame: (n = 1) => {
552
+ const durations = [];
553
+ for (let i = 0; i < n; i++) {
554
+ durations.push(frame(engine));
555
+ }
556
+ return durations;
557
+ },
558
+
559
+ capture: () => {
560
+ frame(engine);
561
+ return capture(engine);
562
+ },
563
+
564
+ state: () => snapshot_renderer_state(engine),
565
+
566
+ image: () => ascii_image(engine),
567
+
568
+ /**
569
+ * Loss/restore lifecycle driven by synthetic canvas events. Works in a hidden tab.
570
+ */
571
+ synthetic(options) {
572
+ const report = run_synthetic_cycle(engine, options);
573
+
574
+ window.__context_loss_report = report;
575
+
576
+ console.log('[context-loss] synthetic report', report);
577
+ console.log('[context-loss] baseline\n' + report.baseline_image);
578
+ console.log('[context-loss] after restore\n' + report.settled_image);
579
+
580
+ return report;
581
+ },
582
+
583
+ /**
584
+ * Same scene, brand new context. Works in a hidden tab.
585
+ */
586
+ fresh(options) {
587
+ const report = run_fresh_context(engine, options);
588
+
589
+ window.__context_loss_report = report;
590
+
591
+ console.log('[context-loss] fresh-context report', report);
592
+
593
+ return report;
594
+ },
595
+
596
+ async run(options) {
597
+ const report = await run_cycle(engine, options);
598
+
599
+ window.__context_loss_report = report;
600
+
601
+ console.log('[context-loss] report', report);
602
+
603
+ return report;
604
+ },
605
+
606
+ async repeat(count = 3, options) {
607
+ const reports = [];
608
+
609
+ for (let i = 0; i < count; i++) {
610
+ console.log(`[context-loss] cycle ${i + 1}/${count}`);
611
+ reports.push(await run_cycle(engine, options));
612
+ }
613
+
614
+ const summary = reports.map((r, i) => ({
615
+ cycle: i,
616
+ restored: r.restored,
617
+ first_frame_ms: r.first_frame_ms,
618
+ settled_vs_baseline: r.settled_vs_baseline,
619
+ textures_before: r.before.textures,
620
+ textures_after: r.after === undefined ? -1 : r.after.textures,
621
+ geometries_after: r.after === undefined ? -1 : r.after.geometries,
622
+ programs_after: r.after === undefined ? -1 : r.after.programs
623
+ }));
624
+
625
+ window.__context_loss_report = { reports, summary };
626
+
627
+ console.log('[context-loss] repeat summary', summary);
628
+
629
+ return summary;
630
+ }
631
+ };
632
+
633
+ window.__context_loss_test = api;
634
+ }
635
+
636
+ /**
637
+ *
638
+ * @param {Engine} engine
639
+ * @returns {Promise<void>}
640
+ */
641
+ async function main(engine) {
642
+ // fixed viewport: the pixel A/B needs a stable resolution, and the harness is expected to run in a
643
+ // hidden tab where the window-driven sizing path produces a 0-sized viewport
644
+ engine.settings.graphics_control_viewport_size.set(false);
645
+ engine.viewStack.size.set(VIEWPORT_WIDTH, VIEWPORT_HEIGHT);
646
+
647
+ await EngineHarness.buildBasics({
648
+ engine,
649
+ focus: SPHERE_POSITION,
650
+ distance: 6,
651
+ pitch: 0.35,
652
+ // static scene: animated water would make consecutive frames differ
653
+ enableWater: false,
654
+ enableTerrain: true,
655
+ terrainSize: { x: 32, y: 32 },
656
+ enableLights: true,
657
+ enableShadows: true,
658
+ cameraController: false
659
+ });
660
+
661
+ const ecd = engine.entityManager.dataset;
662
+
663
+ // a large mirror-metal sphere; almost all of its shading comes from scene.environment, which makes
664
+ // the PMREM environment map's survival directly visible in the pixel A/B
665
+ const material = new MeshStandardMaterial({
666
+ color: 0xffffff,
667
+ metalness: 1,
668
+ roughness: 0.08
669
+ });
670
+
671
+ const mesh = new Mesh(new SphereGeometry(2, 48, 32), material);
672
+
673
+ mesh.castShadow = true;
674
+
675
+ new Entity()
676
+ .add(new Renderable(mesh))
677
+ .add(Transform.fromJSON({
678
+ position: SPHERE_POSITION,
679
+ scale: { x: 1, y: 1, z: 1 }
680
+ }))
681
+ .build(ecd);
682
+
683
+ await load_and_set_cubemap_v0(engine.graphics, 'data/textures/cubemaps/hip_miramar/32/', '.png');
684
+
685
+ install_api(engine);
686
+
687
+ console.log('[context-loss] ready. Run window.__context_loss_test.run()');
688
+ }
689
+
690
+ harness.initialize({
691
+ configuration(config, engine) {
692
+ config.addManySystems(
693
+ new RenderSystem(engine.graphics)
694
+ );
695
+ }
696
+ }).then(main);
@@ -8,9 +8,9 @@ export class CameraSystem extends System<any> {
8
8
  /**
9
9
  *
10
10
  * @param {EntityComponentDataset} ecd
11
- * @param {function(Camera, entity:number)} visitor
11
+ * @param {(camera: Camera, entity: number) => void} visitor
12
12
  */
13
- static traverseActiveCameras(ecd: EntityComponentDataset, visitor: any): void;
13
+ static traverseActiveCameras(ecd: EntityComponentDataset, visitor: (camera: Camera, entity: number) => void): void;
14
14
  /**
15
15
  *
16
16
  * @param {EntityComponentDataset} ecd
@@ -1 +1 @@
1
- {"version":3,"file":"CameraSystem.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/graphics/ecs/camera/CameraSystem.js"],"names":[],"mappings":"AAoBA;;;;GAIG;AACH,4DAHW,YAAY,YACZ,UAAU,QAsBpB;AAED;IAgOI;;;;OAIG;IACH,8EAOC;IAED;;;;OAIG;IACH,0DAFa;QAAC,SAAS,EAAC,CAAC,MAAM,GAAC,SAAS,CAAC,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAC,CAc1D;IAED;;;;OAIG;IACH,uEAFoB,YAAY,EAAE,gBAqBjC;IAxRD;;;;OAIG;IACH,sCAuDC;IAhDG,WAA2B;IAE3B,mDAAuC;IAEvC,8DAEC;IAQD;;OAEG;IACH,yBAAwB;IAExB,kBAAoB;IAKpB;;;;;OAKG;IACH,+BAeC;IAED,sBAAwB;IAI5B;;;;;OAKG;IACH,aAHW,MAAM,aADN,SAAS,uBAyEnB;IAED;;;;;OAKG;IACH,eAHW,MAAM,aADN,SAAS,uBAiBnB;IAED,2CAoDC;IAED,4CAMC;CA4DJ;uBA9TsB,aAAa;uBARb,qCAAqC;uBAGrC,wBAAwB;0BACrB,qCAAqC;4CAFnB,uDAAuD;wCAL1D,OAAO"}
1
+ {"version":3,"file":"CameraSystem.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/graphics/ecs/camera/CameraSystem.js"],"names":[],"mappings":"AAoBA;;;;GAIG;AACH,4DAHW,YAAY,YACZ,UAAU,QAsBpB;AAED;IAgOI;;;;OAIG;IACH,4EAFoB,MAAM,UAAU,MAAM,KAAK,IAAI,QASlD;IAED;;;;OAIG;IACH,0DAFa;QAAC,SAAS,EAAC,CAAC,MAAM,GAAC,SAAS,CAAC,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAC,CAc1D;IAED;;;;OAIG;IACH,uEAFoB,YAAY,EAAE,gBAqBjC;IAxRD;;;;OAIG;IACH,sCAuDC;IAhDG,WAA2B;IAE3B,mDAAuC;IAEvC,8DAEC;IAQD;;OAEG;IACH,yBAAwB;IAExB,kBAAoB;IAKpB;;;;;OAKG;IACH,+BAeC;IAED,sBAAwB;IAI5B;;;;;OAKG;IACH,aAHW,MAAM,aADN,SAAS,uBAyEnB;IAED;;;;;OAKG;IACH,eAHW,MAAM,aADN,SAAS,uBAiBnB;IAED,2CAoDC;IAED,4CAMC;CA4DJ;uBA9TsB,aAAa;uBARb,qCAAqC;uBAGrC,wBAAwB;0BACrB,qCAAqC;4CAFnB,uDAAuD;wCAL1D,OAAO"}