castle-web-cli 0.4.233 → 0.4.235

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 (383) hide show
  1. package/dist/api.d.ts +11 -0
  2. package/dist/api.js +43 -0
  3. package/dist/bundle.d.ts +64 -0
  4. package/dist/bundle.js +558 -2
  5. package/dist/castle-host/host.d.ts +17 -2
  6. package/dist/castle-host/host.js +793 -36
  7. package/dist/castleJson.d.ts +20 -1
  8. package/dist/castleJson.js +44 -2
  9. package/dist/check.js +9 -2
  10. package/dist/chunkLoader.d.ts +3 -0
  11. package/dist/chunkLoader.js +111 -0
  12. package/dist/devParty.d.ts +26 -0
  13. package/dist/devParty.js +231 -0
  14. package/dist/devSaveStorage.js +4 -0
  15. package/dist/devSessionStorage.js +3 -1
  16. package/dist/devSocial.d.ts +24 -0
  17. package/dist/devSocial.js +70 -0
  18. package/dist/ide.d.ts +2 -0
  19. package/dist/ide.js +119 -15
  20. package/dist/index.js +8 -2
  21. package/dist/init.js +1 -1
  22. package/dist/save-deck.d.ts +20 -1
  23. package/dist/save-deck.js +141 -5
  24. package/dist/serve.js +29 -11
  25. package/dist/shell/assets/{index-BjOxR-lW.js → index-DulbYIJm.js} +97 -97
  26. package/dist/shell/index.html +1 -1
  27. package/dist/vitePlugins.d.ts +2 -1
  28. package/dist/vitePlugins.js +13 -0
  29. package/kits/base/castle.json +1 -1
  30. package/kits/base/sdk/README.md +266 -3
  31. package/kits/base/sdk/castle.d.ts +7 -3
  32. package/kits/base/sdk/castle.js +2 -0
  33. package/kits/base/sdk/commands.d.ts +162 -1
  34. package/kits/base/sdk/commands.js +3 -0
  35. package/kits/base/sdk/display.d.ts +3 -0
  36. package/kits/base/sdk/display.js +9 -3
  37. package/kits/base/sdk/hub.d.ts +33 -6
  38. package/kits/base/sdk/hub.js +68 -5
  39. package/kits/base/sdk/hubRejoin.d.ts +4 -0
  40. package/kits/base/sdk/hubRejoin.js +15 -0
  41. package/kits/base/sdk/multiplayer.d.ts +7 -1
  42. package/kits/base/sdk/multiplayer.js +147 -40
  43. package/kits/base/sdk/multiplayerProtocol.d.ts +2 -0
  44. package/kits/base/sdk/party.d.ts +23 -0
  45. package/kits/base/sdk/party.js +91 -0
  46. package/kits/base/sdk/reconnectBudget.d.ts +23 -0
  47. package/kits/base/sdk/reconnectBudget.js +96 -0
  48. package/kits/base/sdk/save.d.ts +38 -1
  49. package/kits/base/sdk/save.js +79 -6
  50. package/kits/base/sdk/server/hub.d.ts +31 -1
  51. package/kits/base/sdk/server/hub.js +50 -3
  52. package/kits/base/sdk/server/platformHandle.d.ts +13 -1
  53. package/kits/base/sdk/server/storage.d.ts +4 -0
  54. package/kits/base/sdk/server/storage.js +19 -3
  55. package/kits/base/sdk/server/wrapper.d.ts +7 -1
  56. package/kits/base/sdk/server/wrapper.js +10 -1
  57. package/kits/base/sdk/social.d.ts +9 -0
  58. package/kits/base/sdk/social.js +5 -0
  59. package/kits/hub-game/CLAUDE.md +123 -3
  60. package/kits/hub-game/README.md +63 -0
  61. package/kits/hub-game/castle.json +5 -5
  62. package/kits/hub-game/code/client/act.js +312 -0
  63. package/kits/hub-game/code/client/actionLayout.js +147 -0
  64. package/kits/hub-game/code/client/actionOverflow.js +556 -0
  65. package/kits/hub-game/code/client/arrivalCamera.js +50 -0
  66. package/kits/hub-game/code/client/askSlot.js +117 -0
  67. package/kits/hub-game/code/client/avatar.js +4 -2
  68. package/kits/hub-game/code/client/avatarShare.js +2 -0
  69. package/kits/hub-game/code/client/backVisibility.js +13 -0
  70. package/kits/hub-game/code/client/ballot.js +15 -10
  71. package/kits/hub-game/code/client/build.js +16 -0
  72. package/kits/hub-game/code/client/chat.js +41 -5
  73. package/kits/hub-game/code/client/chatModeration.js +5 -0
  74. package/kits/hub-game/code/client/chrome.js +1148 -258
  75. package/kits/hub-game/code/client/crowdNames.js +241 -0
  76. package/kits/hub-game/code/client/decor.js +10 -4
  77. package/kits/hub-game/code/client/defaultEnvironment.js +194 -0
  78. package/kits/hub-game/code/client/doorErrors.js +39 -0
  79. package/kits/hub-game/code/client/fall.js +18 -0
  80. package/kits/hub-game/code/client/farAvatars.js +233 -0
  81. package/kits/hub-game/code/client/firstJoin.js +9 -2
  82. package/kits/hub-game/code/client/fpsTelemetry.js +50 -0
  83. package/kits/hub-game/code/client/frameBatch.js +5 -0
  84. package/kits/hub-game/code/client/grab.js +31 -11
  85. package/kits/hub-game/code/client/hookLayer.js +87 -8
  86. package/kits/hub-game/code/client/hudCopy.js +51 -0
  87. package/kits/hub-game/code/client/hudRate.js +20 -0
  88. package/kits/hub-game/code/client/idle.js +14 -2
  89. package/kits/hub-game/code/client/invites.js +231 -0
  90. package/kits/hub-game/code/client/joinError.js +9 -0
  91. package/kits/hub-game/code/client/labelsNear.js +31 -2
  92. package/kits/hub-game/code/client/landscapeLayout.js +17 -0
  93. package/kits/hub-game/code/client/layoutCache.js +264 -0
  94. package/kits/hub-game/code/client/loadTelemetry.js +20 -0
  95. package/kits/hub-game/code/client/loadingCover.js +148 -0
  96. package/kits/hub-game/code/client/loadingEntry.js +8 -0
  97. package/kits/hub-game/code/client/menuRows.js +43 -0
  98. package/kits/hub-game/code/client/modelReady.js +7 -0
  99. package/kits/hub-game/code/client/padCueArrival.js +23 -0
  100. package/kits/hub-game/code/client/padCues.js +112 -0
  101. package/kits/hub-game/code/client/padOccupancy.js +88 -0
  102. package/kits/hub-game/code/client/padReadability.js +26 -0
  103. package/kits/hub-game/code/client/padRings.js +69 -0
  104. package/kits/hub-game/code/client/pushVisit.js +14 -0
  105. package/kits/hub-game/code/client/quality.js +205 -0
  106. package/kits/hub-game/code/client/qualityEntry.js +55 -0
  107. package/kits/hub-game/code/client/safeLayout.js +338 -0
  108. package/kits/hub-game/code/client/safeStyle.js +42 -0
  109. package/kits/hub-game/code/client/say.js +12 -3
  110. package/kits/hub-game/code/client/shot.js +64 -10
  111. package/kits/hub-game/code/client/shotFit.js +56 -0
  112. package/kits/hub-game/code/client/signIn.js +28 -0
  113. package/kits/hub-game/code/client/state.js +53 -0
  114. package/kits/hub-game/code/client/talk.js +209 -45
  115. package/kits/hub-game/code/client/tiers.js +68 -66
  116. package/kits/hub-game/code/client/together.js +7 -2
  117. package/kits/hub-game/code/client/weakestLookBake.js +92 -0
  118. package/kits/hub-game/code/client/weakestTier.js +295 -0
  119. package/kits/hub-game/code/client/worldLabels.js +241 -0
  120. package/kits/hub-game/code/client/yours.js +10 -9
  121. package/kits/hub-game/code/npcDisplayText.js +55 -0
  122. package/kits/hub-game/code/server/act.js +124 -0
  123. package/kits/hub-game/code/server/actions.js +6 -1
  124. package/kits/hub-game/code/server/actors.js +2 -1
  125. package/kits/hub-game/code/server/analytics.js +83 -0
  126. package/kits/hub-game/code/server/anonymousEntry.js +49 -0
  127. package/kits/hub-game/code/server/arrivalPose.js +36 -0
  128. package/kits/hub-game/code/server/companion.js +28 -3
  129. package/kits/hub-game/code/server/doorAnalytics.js +52 -0
  130. package/kits/hub-game/code/server/earned.js +22 -5
  131. package/kits/hub-game/code/server/frameBatch.js +183 -0
  132. package/kits/hub-game/code/server/friendsAmong.js +49 -9
  133. package/kits/hub-game/code/server/history.js +2 -0
  134. package/kits/hub-game/code/server/hub.js +1306 -95
  135. package/kits/hub-game/code/server/idle.js +30 -1
  136. package/kits/hub-game/code/server/index.js +26 -4
  137. package/kits/hub-game/code/server/invites.js +19 -0
  138. package/kits/hub-game/code/server/labels.js +9 -1
  139. package/kits/hub-game/code/server/loadAbandon.js +106 -0
  140. package/kits/hub-game/code/server/manifest.js +211 -3
  141. package/kits/hub-game/code/server/menu.js +31 -3
  142. package/kits/hub-game/code/server/npcs.js +226 -64
  143. package/kits/hub-game/code/server/observe.js +408 -0
  144. package/kits/hub-game/code/server/padOccupancy.js +85 -0
  145. package/kits/hub-game/code/server/players.js +9 -1
  146. package/kits/hub-game/code/server/resumePose.js +152 -0
  147. package/kits/hub-game/code/server/say.js +1 -1
  148. package/kits/hub-game/code/server/standing.js +4 -5
  149. package/kits/hub-game/code/server/storageLimit.js +187 -0
  150. package/kits/hub-game/code/server/vis.js +67 -5
  151. package/kits/hub-game/code/shared/act.js +35 -0
  152. package/kits/hub-game/code/shared/danceIdle.js +28 -0
  153. package/kits/hub-game/code/shared/loadStages.js +12 -0
  154. package/kits/hub-game/code/shared/quality.js +74 -0
  155. package/kits/hub-game/code/shared/say.js +2 -0
  156. package/kits/hub-game/code/shared/shot.js +35 -1
  157. package/kits/hub-game/code/systems/hub.js +970 -169
  158. package/kits/hub-game/docs/analytics.md +279 -0
  159. package/kits/hub-game/docs/contract.md +1259 -42
  160. package/kits/hub-game/docs/home-pieces.md +9 -2
  161. package/kits/hub-game/docs/observed-progress.md +252 -0
  162. package/kits/hub-game/main.jsx +2 -0
  163. package/kits/hub-game/package-lock.json +10 -3
  164. package/kits/hub-game/package.json +6 -3
  165. package/kits/hub-game/play/player.js +142 -0
  166. package/kits/hub-game/play/registry.js +47 -0
  167. package/kits/hub-game/play.jsx +37 -0
  168. package/kits/hub-game/scripts/check.mjs +39 -5
  169. package/kits/hub-game/scripts/companion-follower-wire.json +1 -1
  170. package/kits/hub-game/scripts/fixtures/decor-keyless-draw.json +11 -0
  171. package/kits/hub-game/scripts/fixtures/decor-keyless.json +5 -5
  172. package/kits/hub-game/scripts/fixtures/engine-models-stub.mjs +3 -0
  173. package/kits/hub-game/scripts/fixtures/fake-dom.mjs +19 -3
  174. package/kits/hub-game/scripts/fixtures/interest-legacy.json +3 -3
  175. package/kits/hub-game/scripts/fixtures/vis-shared-wire.json +1 -1
  176. package/kits/hub-game/scripts/pose-storage-fixture.mjs +46 -0
  177. package/kits/hub-game/scripts/test-act-client.mjs +186 -0
  178. package/kits/hub-game/scripts/test-act.mjs +171 -0
  179. package/kits/hub-game/scripts/test-action-layout.mjs +80 -0
  180. package/kits/hub-game/scripts/test-action-observers.mjs +46 -0
  181. package/kits/hub-game/scripts/test-actions-client.mjs +367 -2
  182. package/kits/hub-game/scripts/test-actors.mjs +20 -7
  183. package/kits/hub-game/scripts/test-analytics.mjs +76 -0
  184. package/kits/hub-game/scripts/test-anonymous-entry.mjs +28 -0
  185. package/kits/hub-game/scripts/test-arrival-pose-server.mjs +196 -0
  186. package/kits/hub-game/scripts/test-arrival-pose.mjs +24 -0
  187. package/kits/hub-game/scripts/test-ask-slot.mjs +85 -0
  188. package/kits/hub-game/scripts/test-avatar-wire.mjs +49 -10
  189. package/kits/hub-game/scripts/test-avatar.mjs +44 -0
  190. package/kits/hub-game/scripts/test-back-visibility.mjs +82 -0
  191. package/kits/hub-game/scripts/test-ballot.mjs +11 -4
  192. package/kits/hub-game/scripts/test-ban-join.mjs +121 -13
  193. package/kits/hub-game/scripts/test-build.mjs +20 -2
  194. package/kits/hub-game/scripts/test-chat.mjs +206 -5
  195. package/kits/hub-game/scripts/test-companion-chat.mjs +20 -2
  196. package/kits/hub-game/scripts/test-control-layout-dom.mjs +120 -0
  197. package/kits/hub-game/scripts/test-crowd-names.mjs +205 -0
  198. package/kits/hub-game/scripts/test-decor-client.mjs +45 -4
  199. package/kits/hub-game/scripts/test-decor.mjs +7 -0
  200. package/kits/hub-game/scripts/test-default-environment-root.mjs +95 -0
  201. package/kits/hub-game/scripts/test-default-environment.mjs +267 -0
  202. package/kits/hub-game/scripts/test-door-analytics.mjs +58 -0
  203. package/kits/hub-game/scripts/test-door-jump.mjs +100 -0
  204. package/kits/hub-game/scripts/test-earned.mjs +33 -3
  205. package/kits/hub-game/scripts/test-far-avatars.mjs +340 -0
  206. package/kits/hub-game/scripts/test-fps-telemetry.mjs +112 -0
  207. package/kits/hub-game/scripts/test-frame-batch.mjs +252 -0
  208. package/kits/hub-game/scripts/test-fresh-friends.mjs +118 -0
  209. package/kits/hub-game/scripts/test-grab-orbit.mjs +47 -4
  210. package/kits/hub-game/scripts/test-high-only.mjs +170 -0
  211. package/kits/hub-game/scripts/test-hub-ops.mjs +321 -2
  212. package/kits/hub-game/scripts/test-hub-trip.mjs +879 -11
  213. package/kits/hub-game/scripts/test-hud-clear.mjs +162 -59
  214. package/kits/hub-game/scripts/test-hud-defects-dom.mjs +100 -0
  215. package/kits/hub-game/scripts/test-hud-rate.mjs +224 -0
  216. package/kits/hub-game/scripts/test-hud-safe-visibility-dom.mjs +83 -0
  217. package/kits/hub-game/scripts/test-idle.mjs +66 -0
  218. package/kits/hub-game/scripts/test-interest-cells.mjs +20 -0
  219. package/kits/hub-game/scripts/test-interest.mjs +15 -0
  220. package/kits/hub-game/scripts/test-invites-client.mjs +430 -0
  221. package/kits/hub-game/scripts/test-invites.mjs +109 -0
  222. package/kits/hub-game/scripts/test-labels.mjs +71 -3
  223. package/kits/hub-game/scripts/test-landscape-layout.mjs +194 -0
  224. package/kits/hub-game/scripts/test-list-scroll-dom.mjs +49 -0
  225. package/kits/hub-game/scripts/test-load-abandon.mjs +246 -0
  226. package/kits/hub-game/scripts/test-loading-cover.mjs +162 -0
  227. package/kits/hub-game/scripts/test-manifest.mjs +265 -0
  228. package/kits/hub-game/scripts/test-menu-client.mjs +105 -0
  229. package/kits/hub-game/scripts/test-menu.mjs +23 -0
  230. package/kits/hub-game/scripts/test-npcs.mjs +917 -10
  231. package/kits/hub-game/scripts/test-observed.mjs +745 -0
  232. package/kits/hub-game/scripts/test-pad-cues.mjs +304 -0
  233. package/kits/hub-game/scripts/test-pad-occupancy.mjs +177 -0
  234. package/kits/hub-game/scripts/test-picker.mjs +234 -7
  235. package/kits/hub-game/scripts/test-placement-cache.mjs +690 -0
  236. package/kits/hub-game/scripts/test-progress-reset.mjs +559 -0
  237. package/kits/hub-game/scripts/test-push-visit.mjs +26 -0
  238. package/kits/hub-game/scripts/test-quality.mjs +385 -0
  239. package/kits/hub-game/scripts/test-rehello.mjs +699 -5
  240. package/kits/hub-game/scripts/test-resume-action-order.mjs +598 -0
  241. package/kits/hub-game/scripts/test-resume-held.mjs +239 -0
  242. package/kits/hub-game/scripts/test-resume-pose.mjs +142 -0
  243. package/kits/hub-game/scripts/test-safe-events-dom.mjs +116 -0
  244. package/kits/hub-game/scripts/test-safe-layout.mjs +330 -0
  245. package/kits/hub-game/scripts/test-say.mjs +1 -1
  246. package/kits/hub-game/scripts/test-shot.mjs +145 -0
  247. package/kits/hub-game/scripts/test-signin-client.mjs +45 -0
  248. package/kits/hub-game/scripts/test-soundscape.mjs +22 -17
  249. package/kits/hub-game/scripts/test-standing.mjs +35 -2
  250. package/kits/hub-game/scripts/test-storage-limit.mjs +333 -0
  251. package/kits/hub-game/scripts/test-stuck.mjs +5 -4
  252. package/kits/hub-game/scripts/test-talk-overlay-dom.mjs +130 -0
  253. package/kits/hub-game/scripts/test-tiers-render.mjs +86 -13
  254. package/kits/hub-game/scripts/test-tiers.mjs +7 -8
  255. package/kits/hub-game/scripts/test-vis.mjs +433 -6
  256. package/kits/hub-game/scripts/test-weakest-tier.mjs +924 -0
  257. package/kits/hub-game/scripts/test-world-labels.mjs +367 -0
  258. package/kits/hub-game/scripts/test-yours-chrome.mjs +50 -6
  259. package/kits/hub-game/scripts/test-yours.mjs +39 -8
  260. package/kits/multiplayer-3d/castle.json +5 -5
  261. package/kits/multiplayer-3d/code/client/joinFailure.js +27 -0
  262. package/kits/multiplayer-3d/code/client/resumeGate.js +139 -0
  263. package/kits/multiplayer-3d/code/systems/multiplayer.js +369 -30
  264. package/kits/multiplayer-3d/package-lock.json +8 -1
  265. package/kits/multiplayer-3d/package.json +2 -1
  266. package/kits/multiplayer-3d/scripts/test-join-watchdog.mjs +436 -0
  267. package/kits/multiplayer-3d/scripts/test-resume-gate.mjs +624 -0
  268. package/kits/physics-2d/CLAUDE.md +10 -1
  269. package/kits/physics-2d/castle.json +2 -2
  270. package/kits/physics-2d/engine/frozenActors.js +233 -0
  271. package/kits/physics-2d/engine/scene.js +87 -5
  272. package/kits/physics-2d/eslint.config.js +1 -1
  273. package/kits/physics-2d/play/behaviors/AnalogStick.js +198 -0
  274. package/kits/physics-2d/play/behaviors/Camera.js +40 -0
  275. package/kits/physics-2d/play/behaviors/Collider.js +122 -0
  276. package/kits/physics-2d/play/behaviors/Draggable.js +115 -0
  277. package/kits/physics-2d/play/behaviors/Goal.js +46 -0
  278. package/kits/physics-2d/play/behaviors/Joints.js +126 -0
  279. package/kits/physics-2d/play/behaviors/Layout.js +71 -0
  280. package/kits/physics-2d/play/behaviors/RigidBody.js +57 -0
  281. package/kits/physics-2d/play/behaviors/Slingshot.js +142 -0
  282. package/kits/physics-2d/play/behaviors/SoundPlayer.js +263 -0
  283. package/kits/physics-2d/play/behaviors/Sprite.js +406 -0
  284. package/kits/physics-2d/play/behaviors/Style.js +209 -0
  285. package/kits/physics-2d/play/behaviors/Text.js +85 -0
  286. package/kits/physics-2d/play/behaviors/Video.js +93 -0
  287. package/kits/physics-3d/CLAUDE.md +25 -1651
  288. package/kits/physics-3d/behaviors/Body.jsx +3 -0
  289. package/kits/physics-3d/behaviors/Model.jsx +3 -0
  290. package/kits/physics-3d/behaviors/Player.jsx +35 -18
  291. package/kits/physics-3d/behaviors/Shape.jsx +3 -0
  292. package/kits/physics-3d/behaviors/Solid.jsx +3 -0
  293. package/kits/physics-3d/behaviors/Transform.jsx +3 -0
  294. package/kits/physics-3d/castle.json +3 -3
  295. package/kits/physics-3d/docs/engine-camera.md +542 -0
  296. package/kits/physics-3d/docs/engine-frame-cap.md +136 -0
  297. package/kits/physics-3d/docs/engine-load.md +149 -0
  298. package/kits/physics-3d/docs/engine-look.md +114 -0
  299. package/kits/physics-3d/docs/engine-shadows.md +372 -0
  300. package/kits/physics-3d/docs/engine-skip-work.md +187 -0
  301. package/kits/physics-3d/docs/engine-sky.md +198 -0
  302. package/kits/physics-3d/docs/engine-static-actors.md +226 -0
  303. package/kits/physics-3d/docs/engine-view.md +37 -0
  304. package/kits/physics-3d/docs/pxmodel-format.md +1 -1
  305. package/kits/physics-3d/engine3d/PlayOnly3D.jsx +5 -1
  306. package/kits/physics-3d/engine3d/Scene3DPlayer.jsx +19 -333
  307. package/kits/physics-3d/engine3d/actornode.js +1 -0
  308. package/kits/physics-3d/engine3d/branches.js +3 -13
  309. package/kits/physics-3d/engine3d/cage.js +2 -7
  310. package/kits/physics-3d/engine3d/cageops.js +2 -17
  311. package/kits/physics-3d/engine3d/dataBehaviors.js +12 -0
  312. package/kits/physics-3d/engine3d/framecap.js +4 -1
  313. package/kits/physics-3d/engine3d/frozenphysics.js +140 -0
  314. package/kits/physics-3d/engine3d/frozenstatics.js +273 -0
  315. package/kits/physics-3d/engine3d/gait.js +8 -0
  316. package/kits/physics-3d/engine3d/initialModelFiles.js +18 -0
  317. package/kits/physics-3d/engine3d/look.js +7 -0
  318. package/kits/physics-3d/engine3d/modelFiles.js +3 -17
  319. package/kits/physics-3d/engine3d/modelMath.js +49 -0
  320. package/kits/physics-3d/engine3d/modelready.js +16 -0
  321. package/kits/physics-3d/engine3d/motion.js +3 -3
  322. package/kits/physics-3d/engine3d/nearshadows.js +77 -10
  323. package/kits/physics-3d/engine3d/orbitinput.js +59 -25
  324. package/kits/physics-3d/engine3d/partgeometry.js +1 -16
  325. package/kits/physics-3d/engine3d/paths.js +1 -9
  326. package/kits/physics-3d/engine3d/playTimings.js +50 -0
  327. package/kits/physics-3d/engine3d/playerRun.js +372 -0
  328. package/kits/physics-3d/engine3d/pxmodel.js +3 -3
  329. package/kits/physics-3d/engine3d/rapier.js +27 -0
  330. package/kits/physics-3d/engine3d/scatter.js +1 -11
  331. package/kits/physics-3d/engine3d/shadowfade.js +23 -15
  332. package/kits/physics-3d/engine3d/sky.js +1 -1
  333. package/kits/physics-3d/engine3d/squarefirst.js +177 -0
  334. package/kits/physics-3d/engine3d/stillshadows.js +399 -0
  335. package/kits/physics-3d/engine3d/sweep.js +1 -25
  336. package/kits/physics-3d/engine3d/world3d.js +468 -18
  337. package/kits/physics-3d/eslint.config.js +2 -1
  338. package/kits/physics-3d/main.jsx +6 -3
  339. package/kits/physics-3d/package-lock.json +7 -0
  340. package/kits/physics-3d/package.json +5 -1
  341. package/kits/physics-3d/play/behaviors/Body.js +31 -0
  342. package/kits/physics-3d/play/behaviors/Door.js +37 -0
  343. package/kits/physics-3d/play/behaviors/Lookable.js +16 -0
  344. package/kits/physics-3d/play/behaviors/Model.js +23 -0
  345. package/kits/physics-3d/play/behaviors/Pickup.js +46 -0
  346. package/kits/physics-3d/play/behaviors/Player.js +1204 -0
  347. package/kits/physics-3d/play/behaviors/Shape.js +47 -0
  348. package/kits/physics-3d/play/behaviors/Solid.js +16 -0
  349. package/kits/physics-3d/play/behaviors/Transform.js +29 -0
  350. package/kits/physics-3d/pnpm-lock.yaml +8 -0
  351. package/kits/physics-3d/scripts/bench-shadow-fade.mjs +37 -0
  352. package/kits/physics-3d/scripts/build-rapier-gz.mjs +56 -0
  353. package/kits/physics-3d/scripts/frozen-statics-fixture.mjs +141 -0
  354. package/kits/physics-3d/scripts/test-camera-follow.mjs +5 -1
  355. package/kits/physics-3d/scripts/test-camera-orbit.mjs +52 -4
  356. package/kits/physics-3d/scripts/test-drop-empty-parts.mjs +1 -1
  357. package/kits/physics-3d/scripts/test-empty-gait-hints.mjs +89 -0
  358. package/kits/physics-3d/scripts/test-frame-cap-bob.mjs +6 -3
  359. package/kits/physics-3d/scripts/test-frame-cap.mjs +1 -1
  360. package/kits/physics-3d/scripts/test-frozen-nested.mjs +49 -0
  361. package/kits/physics-3d/scripts/test-frozen-statics-legacy-physics2d.mjs +123 -0
  362. package/kits/physics-3d/scripts/test-frozen-statics.mjs +434 -0
  363. package/kits/physics-3d/scripts/test-look-bake.mjs +1 -1
  364. package/kits/physics-3d/scripts/test-near-shadows.mjs +2 -2
  365. package/kits/physics-3d/scripts/test-orbit-shadow-fade.mjs +88 -7
  366. package/kits/physics-3d/scripts/test-orbit-shift-lock.mjs +40 -3
  367. package/kits/physics-3d/scripts/test-orbit-shot.mjs +75 -1
  368. package/kits/physics-3d/scripts/test-rapier-gz.mjs +106 -0
  369. package/kits/physics-3d/scripts/test-sky.mjs +1 -1
  370. package/kits/physics-3d/scripts/test-square-first.mjs +921 -0
  371. package/kits/physics-3d/scripts/test-static-actors.mjs +3 -1
  372. package/kits/physics-3d/scripts/test-static-physics.mjs +4 -1
  373. package/kits/physics-3d/scripts/test-static-scenery.mjs +5 -2
  374. package/kits/physics-3d/scripts/test-steady-hover.mjs +5 -2
  375. package/kits/physics-3d/scripts/test-still-shadows.mjs +477 -0
  376. package/kits/physics-3d/systems/physics3d.js +37 -4
  377. package/kits/real-time/castle.json +2 -2
  378. package/kits/real-time/code/client/connection.js +33 -10
  379. package/kits/real-time/code/client/gameHooks.js +2 -0
  380. package/kits/real-time/code/client/joinOverlay.js +9 -4
  381. package/kits/real-time/code/server/session.js +6 -4
  382. package/kits/real-time/package-lock.json +1 -1
  383. package/package.json +2 -2
@@ -0,0 +1,49 @@
1
+ // Static actors under a parent that cannot freeze stay on the live walk.
2
+ // Their watches must survive unchanged frames: re-walking every child each
3
+ // frame cost a Town about 29% of a phone's main thread.
4
+ import assert from 'node:assert/strict';
5
+ import { side, frame, actor, frozen, node } from './frozen-statics-fixture.mjs';
6
+ import { FrozenStatics } from '../engine3d/frozenstatics.js';
7
+
8
+ let watches = 0;
9
+ const watch = FrozenStatics.prototype.watch;
10
+ FrozenStatics.prototype.watch = function (...args) { watches += 1; return watch.apply(this, args); };
11
+
12
+ const actors = [actor('holder', 0)];
13
+ for (let i = 0; i < 20; i++) actors.push(actor(`c${i}`, i));
14
+ const s = await side(frozen, false, { engine: frozen, ground: { none: true }, actors });
15
+ frame(s);
16
+ for (let i = 0; i < 20; i++) node(s, 'holder').add(node(s, `c${i}`));
17
+ for (let i = 0; i < 5; i++) frame(s);
18
+ const state = s.world.frozenStatics;
19
+ assert.ok(state.live.has(s.runtime.getActor('c0')), 'a child under an unfreezable parent stays live');
20
+
21
+ watches = 0;
22
+ for (let i = 0; i < 30; i++) frame(s);
23
+ assert.equal(watches, 0, 'unchanged live children keep their watches');
24
+
25
+ // A change still rewatches, and the change reaches the node.
26
+ s.runtime.getActor('c3').components.Transform.y = 4;
27
+ watches = 0;
28
+ frame(s); frame(s);
29
+ assert.ok(watches >= 1, 'a changed child is watched again');
30
+ assert.equal(node(s, 'c3').position.y, 4, 'the change is drawn');
31
+
32
+ // A descendant added under a live child is covered: its watch is rebuilt.
33
+ const marker = node(s, 'c5').clone(false);
34
+ marker.userData = {};
35
+ watches = 0;
36
+ node(s, 'c5').add(marker);
37
+ frame(s);
38
+ assert.ok(watches >= 1, 'a new descendant rewatches its actor');
39
+ assert.ok(state.records.get(s.runtime.getActor('c5')).objects.includes(marker), 'the new descendant is watched');
40
+ // A change noticed after this sync's take(), before the actor's own freeze:
41
+ // the stale watch must not be reused.
42
+ state.take();
43
+ const late = node(s, 'c7').clone(false);
44
+ late.userData = {};
45
+ node(s, 'c7').add(late);
46
+ state.freeze(s.runtime.getActor('c7'), s.world.nodes.get('c7'));
47
+ assert.ok(state.records.get(s.runtime.getActor('c7')).objects.includes(late), 'a change after take() rewatches');
48
+ frame(s);
49
+ console.log('frozen nested: live children keep watches; changes and new descendants rewatch');
@@ -0,0 +1,123 @@
1
+ // An old physics-2d must ignore the new scene key, including through public
2
+ // physics APIs. Keep the actual fixture's sibling modules when supplied.
3
+ import assert from 'node:assert/strict';
4
+ import { register } from 'node:module';
5
+ import { isAbsolute } from 'node:path';
6
+ import { pathToFileURL } from 'node:url';
7
+ import { DT, side, frame, same, close, frozen, writeFrame } from './frozen-statics-fixture.mjs';
8
+ const { SceneRuntime } = await import('../../physics-2d/engine/scene.js');
9
+ const { setLookEnabled } = await import('../engine3d/look.js');
10
+
11
+ class MaskedRuntime extends SceneRuntime {
12
+ load(sceneData) {
13
+ // Masking getters alone leaves the modern runtime's private observer and
14
+ // update queue active. Load without that implementation, then retain the
15
+ // original key so physics-3d still sees precisely the legacy scene data.
16
+ const engine = { ...sceneData.engine };
17
+ const legacyEngine = { ...engine };
18
+ delete legacyEngine.frozenStatics;
19
+ const result = super.load({ ...sceneData, engine: legacyEngine });
20
+ this.data.engine = engine;
21
+ return result;
22
+ }
23
+ get freezesStatics() { return undefined; }
24
+ get frozenActors() { return undefined; }
25
+ }
26
+ let Runtime = MaskedRuntime;
27
+ if (process.env.PHYSICS2D_SCENE) {
28
+ assert.ok(isAbsolute(process.env.PHYSICS2D_SCENE), 'PHYSICS2D_SCENE must be absolute');
29
+ const sceneURL = pathToFileURL(process.env.PHYSICS2D_SCENE).href;
30
+ // Published kit modules use extensionless relative imports too. Scope this
31
+ // resolver to the supplied kit, sharing only the existing bundler stubs.
32
+ register(`data:text/javascript,${encodeURIComponent(`
33
+ import { existsSync } from 'node:fs';
34
+ import { fileURLToPath } from 'node:url';
35
+ const repoEngine = ${JSON.stringify(new URL('../../physics-2d/engine/', import.meta.url).href)};
36
+ const root = ${JSON.stringify(new URL('../', sceneURL).href)};
37
+ export async function resolve(specifier, context, next) {
38
+ if (context.parentURL?.startsWith(root) && specifier.startsWith('.')) {
39
+ const stub = /^(?:\\.\\/)(files|systemRegistry|fonts)(?:\\.js)?$/.exec(specifier);
40
+ if (stub) return next(new URL(stub[1] + '.js', repoEngine).href, context);
41
+
42
+ const url = new URL(specifier, context.parentURL);
43
+ if (!/\\.(m?js|jsx|json)$/.test(url.pathname)) {
44
+ for (const ext of ['.js', '.jsx']) {
45
+ if (existsSync(fileURLToPath(url.href + ext))) return next(url.href + ext, context);
46
+ }
47
+ }
48
+ }
49
+ return next(specifier, context);
50
+ }
51
+ `)}`);
52
+ ({ SceneRuntime: Runtime } = await import(sceneURL));
53
+ }
54
+ const RAPIER = await import('../engine3d/rapier.js');
55
+ await RAPIER.init();
56
+ const withoutKey = { ...frozen };
57
+ delete withoutKey.frozenStatics;
58
+ let frames = 0;
59
+ function inert(s) {
60
+ assert.equal(s.runtime.freezesStatics, undefined);
61
+ assert.equal(s.runtime.frozenActors, undefined);
62
+ assert.equal(s.world.frozenStatics, undefined);
63
+ assert.equal(s.system.frozenPhysics, undefined);
64
+ assert.equal(Object.hasOwn(s.world, 'frozenStatics'), false);
65
+ assert.equal(Object.hasOwn(s.system, 'frozenPhysics'), false);
66
+ }
67
+ function compare(a, b, label) {
68
+ for (const s of [a, b]) assert.ok(s.runtime.physics3d.ready(), 'real Rapier initialized');
69
+ same(a, b, label);
70
+ assert.deepEqual(a.runtime.getActors().map(actor => actor.components.Transform),
71
+ b.runtime.getActors().map(actor => actor.components.Transform), `${label}: actor transforms`);
72
+ const physics = s => [...s.system.bodies].map(([id, entry]) => ({
73
+ id, velocity: { ...entry.body.linvel() }, angular: { ...entry.body.angvel() },
74
+ colliders: entry.body.numColliders(), enabled: entry.body.isEnabled(),
75
+ }));
76
+ assert.deepEqual(physics(a), physics(b), `${label}: physics state`);
77
+ inert(a); inert(b);
78
+ frames++;
79
+ }
80
+ // The complete writer sequence from test-frozen-statics, with the audit flag
81
+ // both off and on, and the editor/static opt-out world as well.
82
+ for (const mode of ['normal', 'audit', 'editor']) {
83
+ const a = await side(frozen, mode === 'audit', undefined, Runtime);
84
+ const b = await side(withoutKey, mode === 'audit', undefined, Runtime);
85
+ try {
86
+ for (const s of [a, b]) {
87
+ inert(s);
88
+ if (mode === 'editor') s.world.staticActorsOff = true;
89
+ }
90
+ for (let i = 0; i < 100; i++) {
91
+ for (const s of [a, b]) { writeFrame(s, i); frame(s, i % 3 === 0 ? DT / 2 : DT); }
92
+ compare(a, b, `${mode} writer frame ${i}`);
93
+ }
94
+ // bodyOf is the other entry point that can dereference frozenActors.
95
+ for (const s of [a, b]) {
96
+ const body = s.runtime.physics3d.bodyOf('dynamic');
97
+ assert.ok(body && typeof body.sleep === 'function', 'real Rapier body');
98
+ s.runtime.physics3d.setVelocity('dynamic', { x: 1, y: 0, z: 0 });
99
+ }
100
+ for (let i = 0; i < 5; i++) { frame(a); frame(b); compare(a, b, `${mode} velocity ${i}`); }
101
+ for (const s of [a, b]) s.runtime.physics3d.bodyOf('dynamic').sleep();
102
+ for (let i = 0; i < 20; i++) {
103
+ const dt = [DT / 2, DT / 4, DT * 2.5][i % 3];
104
+ frame(a, dt); frame(b, dt); compare(a, b, `${mode} sleep ${i}`);
105
+ }
106
+ for (const s of [a, b]) s.runtime.physics3d.applyImpulse('dynamic', { x: 1, y: 0, z: 0 });
107
+ for (let i = 0; i < 10; i++) { frame(a); frame(b); compare(a, b, `${mode} wake ${i}`); }
108
+ // Reload with the key still present, then remove it in the same world.
109
+ for (const removeKey of [false, true]) {
110
+ for (const s of [a, b]) {
111
+ const saved = s.runtime.serialize();
112
+ if (removeKey) delete saved.engine.frozenStatics;
113
+ s.runtime.load(saved);
114
+ }
115
+ for (let i = 0; i < 3; i++) { frame(a); frame(b); compare(a, b, `${mode} reload ${removeKey} ${i}`); }
116
+ }
117
+ } finally {
118
+ close(a); close(b);
119
+ inert(a); inert(b);
120
+ setLookEnabled(true);
121
+ }
122
+ }
123
+ console.log(`frozen statics legacy physics-2d (${process.env.PHYSICS2D_SCENE ? 'external' : 'masked'}): ${frames}-frame transform/sync/physics parity, writers, bodyOf, sleep/wake, reload, no frozen state passed`);
@@ -0,0 +1,434 @@
1
+ // Real SceneRuntime, three.js and Rapier. The existing scenery harness supplies
2
+ // only the bundler's files/font/system-registry stubs; its ?still Rapier stub
3
+ // does not apply to the normal physics module used here.
4
+ import assert from 'node:assert/strict';
5
+ import { DT, classes, actor, side, frame, node, same, close, full, frozen, writeFrame } from './frozen-statics-fixture.mjs';
6
+ const { syncActors } = await import('../engine3d/world3d.js');
7
+ const { setLookEnabled } = await import('../engine3d/look.js');
8
+ const { prepareEmptyNodes } = await import('../engine3d/emptynodes.js');
9
+
10
+ // Missing/invalid key: the original paths, including the original static path,
11
+ // produce exactly the old full-loop state on every one of 100 frames.
12
+ for (const engine of [{}, full, { ...full, staticActors: true }, { ...full, staticActors: true, frozenStatics: false }]) {
13
+ const a = await side(engine), b = await side({});
14
+ // This fixture's behaviour writes another actor only in the explicit frozen
15
+ // exercise below; original staticActors requires touch for such a write.
16
+ for (const s of [a, b]) s.runtime.touch('behaviour');
17
+ for (let i = 0; i < 100; i++) { frame(a); frame(b); same(a, b, `absent key, frame ${i}`); }
18
+ assert.equal(a.world.frozenStatics, undefined);
19
+ assert.equal(a.system.frozenPhysics, undefined);
20
+ close(a); close(b);
21
+ }
22
+ for (const engine of [{ frozenStatics: true }, { skipUnchangedActors: true, frozenStatics: true }, { staticActors: true, frozenStatics: true }]) {
23
+ const warns = [], warn = console.warn;
24
+ console.warn = message => warns.push(message);
25
+ try {
26
+ const s = await side(engine);
27
+ assert.equal(s.runtime.freezesStatics, false);
28
+ assert.match(warns.join(' '), /requires skipUnchangedActors and staticActors/);
29
+ close(s);
30
+ } finally { console.warn = warn; }
31
+ }
32
+
33
+ // Each supported writer, plus the moving-parent exclusion, on its exact frame.
34
+ // Run with both the debug oracle enabled and with the actual frozen fast path.
35
+ for (const audit of [false, true]) {
36
+ const a = await side(frozen, audit), b = await side(full);
37
+ for (let i = 0; i < 100; i++) {
38
+ for (const s of [a, b]) {
39
+ writeFrame(s, i);
40
+ frame(s, i % 3 === 0 ? DT / 2 : DT);
41
+ }
42
+ same(a, b, `frozen=${audit ? 'audit' : 'fast'}, frame ${i}`);
43
+ if (i === 5) assert.notEqual(node(a, 'child').frozenStatic, true, 'static under a moving parent stays live');
44
+ }
45
+ assert.deepEqual(a.runtime.serialize().actors.map(a => a.id), b.runtime.serialize().actors.map(a => a.id));
46
+ close(a); close(b);
47
+ }
48
+
49
+ // Counter proof: unchanged statics never enter sync/reconcile/push, and no
50
+ // subtree unchanged/matrix walk runs when the renderer visits their root.
51
+ {
52
+ const s = await side(frozen);
53
+ for (let i = 0; i < 5; i++) frame(s);
54
+ const root = node(s, 'still');
55
+ assert.equal(root.frozenStatic, true);
56
+ root.traverse(o => { assert.equal(o.matrixAutoUpdate, false); assert.equal(o.matrixWorldAutoUpdate, false); });
57
+ const visit = s.visits.get('still'), body = s.physicsVisits.get('still');
58
+ let matrixVisits = 0;
59
+ const child = root.children[0], update = child.updateMatrixWorld;
60
+ // Count the old checks as well as the selected-actor counters.
61
+ const place = s.world.nodes.get.bind(s.world.nodes);
62
+ let staticLookups = 0;
63
+ s.world.nodes.get = id => { if (id === 'still') staticLookups++; return place(id); };
64
+ // A custom controller must fall back, so count traversal via the unchanged
65
+ // matrix itself instead of replacing the watched method.
66
+ const elements = child.matrixWorld.elements;
67
+ const descriptor = Object.getOwnPropertyDescriptor(elements, '0');
68
+ Object.defineProperty(elements, '0', { ...descriptor, get() { matrixVisits++; return descriptor.get(); } });
69
+ for (let i = 0; i < 100; i++) frame(s);
70
+ assert.equal(s.visits.get('still'), visit);
71
+ assert.equal(s.physicsVisits.get('still'), body);
72
+ assert.equal(staticLookups, 0);
73
+ assert.equal(matrixVisits, 0);
74
+ assert.equal(child.updateMatrixWorld, update);
75
+ s.runtime.touch('still');
76
+ frame(s); frame(s);
77
+ const after = s.visits.get('still');
78
+ for (let i = 0; i < 4; i++) frame(s);
79
+ assert.equal(s.visits.get('still'), after, 'touched statics return to the frozen queue');
80
+ close(s);
81
+ }
82
+
83
+ // Fixed bodies with update hooks need physics visits only when they write.
84
+ for (const move of [false, true]) {
85
+ let updates = 0;
86
+ class FixedUpdate {
87
+ static behaviorName = 'FixedUpdate';
88
+ update(actor) {
89
+ if (++updates === 5 && move) actor.components.Transform.x += 3;
90
+ }
91
+ }
92
+ const s = await side(frozen, move, { engine: frozen, ground: { none: true }, actors: [
93
+ { ...actor('fixed-update', 0, { Body: { type: 'fixed' }, FixedUpdate: {} }), static: false },
94
+ ] });
95
+ try {
96
+ s.runtime.setBehaviors([...classes, FixedUpdate]);
97
+ for (let i = 0; i < 10; i++) {
98
+ frame(s);
99
+ const moved = move && i >= 4;
100
+ assert.equal(s.physicsVisits.get('fixed-update'), moved ? 2 : 1, `fixed update visits, frame ${i}`);
101
+ assert.equal(s.system.bodies.get('fixed-update').body.translation().x, moved ? 3 : 0, `fixed update pose, frame ${i}`);
102
+ }
103
+ assert.equal(updates, 10, 'the fixed actor behavior still updates every frame');
104
+ } finally { close(s); }
105
+ }
106
+
107
+ // Unchanged kinematic bodies keep their last target without physics visits.
108
+ {
109
+ const s = await side(frozen, false, { engine: frozen, ground: { none: true }, actors: [
110
+ actor('kinematic', 0, { Body: { type: 'kinematic' } }),
111
+ ] });
112
+ try {
113
+ for (let i = 0; i < 10; i++) {
114
+ frame(s);
115
+ assert.equal(s.physicsVisits.get('kinematic'), 1, `unchanged kinematic visits, frame ${i}`);
116
+ }
117
+ } finally { close(s); }
118
+ }
119
+
120
+ // Kinematic writes push a resting ball on the same step, then both settle.
121
+ for (const audit of [false, true]) {
122
+ class Lift {
123
+ static behaviorName = 'Lift';
124
+ frames = 0;
125
+ update(actor) {
126
+ if (++this.frames >= 3 && this.frames <= 6) actor.components.Transform.y += 0.125;
127
+ }
128
+ }
129
+ const fixture = engine => ({ engine, ground: { none: true }, actors: [
130
+ actor('lift', 0, { Body: { type: 'kinematic', gravityScale: 0 }, Lift: {},
131
+ Shape: { kind: 'box', width: 4, height: 1, depth: 4, solid: true } }),
132
+ actor('ball', 0, { Transform: { x: 0, y: 2, z: 0, rotationX: 0, rotationY: 0, rotationZ: 0 },
133
+ Body: { type: 'dynamic', gravityScale: 1 }, Shape: { kind: 'sphere', radius: 0.5, solid: true } }),
134
+ ] });
135
+ const a = await side(frozen, audit, fixture(frozen)), b = await side(full, false, fixture(full));
136
+ try {
137
+ for (const s of [a, b]) s.runtime.setBehaviors([...classes, Lift]);
138
+ let visits = 0, restingY;
139
+ for (let i = 1; i <= 240; i++) {
140
+ frame(a); frame(b);
141
+ same(a, b, `kinematic lift audit=${audit}, frame ${i}`);
142
+ if (i === 1 || (i >= 3 && i <= 6)) visits++;
143
+ assert.equal(a.physicsVisits.get('lift'), visits, `moving kinematic visits, frame ${i}`);
144
+ assert.equal(a.system.bodies.get('lift').body.translation().y, 1 + Math.min(4, Math.max(0, i - 2)) * 0.125, `kinematic pose, frame ${i}`);
145
+ const ball = a.system.bodies.get('ball').body;
146
+ if (i === 2) restingY = ball.translation().y;
147
+ if (i >= 3 && i <= 6) assert.ok(ball.translation().y > restingY, `ball pushed during lift, frame ${i}`);
148
+ }
149
+ const ball = a.system.bodies.get('ball').body;
150
+ assert.ok(ball.isSleeping(), 'the ball settles after the kinematic stops');
151
+ assert.ok(Math.abs(ball.translation().y - 2.5) < 0.02, 'the ball rests on the raised kinematic');
152
+ } finally { close(a); close(b); }
153
+ }
154
+
155
+ // The actual hub tint/hide methods and tier levers use the same notifications.
156
+ {
157
+ const { installSystem } = await import('../../hub-game/code/systems/hub.js');
158
+ const { hub } = await import('../../hub-game/code/client/state.js');
159
+ const { makeLevers } = await import('../../hub-game/code/client/tiers.js');
160
+ const a = await side(frozen), b = await side(full);
161
+ const makeHub = () => { let system; installSystem({ registerSystem: s => { system = s; } }); return system; };
162
+ const systems = new Map([[a, makeHub()], [b, makeHub()]]);
163
+ const levers = new Map([[a, makeLevers()], [b, makeLevers()]]);
164
+ try {
165
+ for (let i = 0; i < 5; i++) { frame(a); frame(b); }
166
+ hub.hidden = new Set(['decor']); hub.tints = { still: '#123456' };
167
+ for (const s of [a, b]) { systems.get(s).applyVisibility(s.runtime); systems.get(s).applyTints(s.runtime); frame(s); }
168
+ same(a, b, 'hub hide/tint');
169
+ hub.hidden = new Set(); hub.tints = {};
170
+ for (const s of [a, b]) { systems.get(s).applyVisibility(s.runtime); systems.get(s).applyTints(s.runtime); frame(s); }
171
+ same(a, b, 'hub show/untint');
172
+ for (const distance of [200, 0]) {
173
+ for (let i = 0; i < 3; i++) {
174
+ for (const s of [a, b]) {
175
+ s.world.camera.position.set(distance, 2, 0);
176
+ levers.get(s).apply(s.world, { scenePath: s.runtime.scenePath, data: s.runtime.data,
177
+ readFromFile: () => s.runtime.serialize(), getActor: id => s.runtime.getActor(id) }, (i + 1) * 600);
178
+ frame(s);
179
+ }
180
+ same(a, b, `tier levers ${distance}, frame ${i}`);
181
+ }
182
+ if (distance) assert.ok([...a.world.nodes.values()].some(e => !e.node.parent), 'real levers hid scenery');
183
+ }
184
+ } finally {
185
+ for (const s of [a, b]) { levers.get(s).restore(s.world); close(s); }
186
+ hub.hidden = new Set(); hub.tints = {};
187
+ }
188
+ }
189
+
190
+ // Editor display worlds keep following whole-component inspector replacements.
191
+ {
192
+ const a = await side(frozen), b = await side(full);
193
+ for (const s of [a, b]) s.world.staticActorsOff = true; // editor display world
194
+ for (let i = 0; i < 8; i++) {
195
+ for (const s of [a, b]) {
196
+ const edited = s.runtime.getActor('still');
197
+ edited.components = { ...edited.components, Transform: { ...edited.components.Transform, x: i } };
198
+ frame(s);
199
+ }
200
+ same(a, b, `editor component replacement ${i}`);
201
+ assert.equal(a.world.frozenStatics, undefined);
202
+ }
203
+ close(a); close(b);
204
+ }
205
+
206
+ // A consumer taking matrix ownership falls back, preserving its requested flag.
207
+ {
208
+ const a = await side(frozen), b = await side(full);
209
+ for (let i = 0; i < 5; i++) { frame(a); frame(b); }
210
+ for (const s of [a, b]) {
211
+ const child = node(s, 'still').children[0];
212
+ child.matrixAutoUpdate = false;
213
+ child.matrix.makeTranslation(1, 2, 3);
214
+ }
215
+ for (let i = 0; i < 10; i++) { frame(a); frame(b); same(a, b, 'manual matrix fallback'); }
216
+ assert.equal(node(a, 'still').children[0].matrixAutoUpdate, false);
217
+ assert.notEqual(node(a, 'still').frozenStatic, true);
218
+ close(a); close(b);
219
+ }
220
+
221
+ // Prove that the opt-in audit detects a lost notification in either consumer.
222
+ for (const target of ['nodes', 'bodies']) {
223
+ const s = await side(frozen);
224
+ for (let i = 0; i < 5; i++) frame(s);
225
+ s.runtime.getActor('still').components.Shape.width = 2;
226
+ if (target === 'nodes') s.world.frozenStatics.pending.dirty.clear();
227
+ else s.system.frozenPhysics.pending.dirty.clear();
228
+ s.world.auditFrozenStatics = true;
229
+ assert.throws(() => target === 'nodes' ? syncActors(s.world, s.runtime, {}, DT) : s.system.simulate(s.runtime, DT), /frozenStatics audit/);
230
+ close(s);
231
+ }
232
+
233
+ // Real Rapier sleep/wake: no sleeping dynamic enters bodyFor or pushUnchanged.
234
+ {
235
+ const a = await side(frozen), b = await side(full);
236
+ for (let i = 0; i < 5; i++) { frame(a); frame(b); }
237
+ for (const s of [a, b]) s.runtime.physics3d.setVelocity('dynamic', { x: 1, y: 0, z: 0 });
238
+ for (let i = 0; i < 5; i++) { frame(a, DT / 2); frame(b, DT / 2); same(a, b, 'moving before sleep'); }
239
+ for (const s of [a, b]) s.system.bodies.get('dynamic').body.sleep();
240
+ const count = a.physicsVisits.get('dynamic');
241
+ for (let i = 0; i < 100; i++) {
242
+ const dt = [DT / 2, DT / 4, DT * 2.5][i % 3];
243
+ frame(a, dt); frame(b, dt); same(a, b, `sleep frame ${i}`);
244
+ }
245
+ assert.equal(a.physicsVisits.get('dynamic'), count);
246
+ for (const s of [a, b]) s.runtime.physics3d.applyImpulse('dynamic', { x: 1, y: 0, z: 0 });
247
+ for (let i = 0; i < 10; i++) { frame(a); frame(b); same(a, b, 'wake by API'); }
248
+ assert.ok(a.physicsVisits.get('dynamic') > count);
249
+ close(a); close(b);
250
+ }
251
+
252
+ // A collision can wake a body inside Rapier's step, before it appears in the
253
+ // next pre-step active set. Its previous settled pose must still interpolate.
254
+ {
255
+ const a = await side(frozen), b = await side(full);
256
+ for (let i = 0; i < 5; i++) { frame(a); frame(b); }
257
+ for (const s of [a, b]) {
258
+ s.system.bodies.get('dynamic').body.sleep();
259
+ s.runtime.spawnActor(actor('projectile', 18, { Body: { type: 'dynamic', gravityScale: 0 } }));
260
+ frame(s);
261
+ s.runtime.physics3d.setVelocity('projectile', { x: 6, y: 0, z: 0 });
262
+ }
263
+ let woke = false;
264
+ for (let i = 0; i < 45; i++) {
265
+ frame(a, DT * 0.75); frame(b, DT * 0.75); same(a, b, `collision wake ${i}`);
266
+ woke ||= !a.system.bodies.get('dynamic').body.isSleeping();
267
+ }
268
+ assert.ok(woke, 'the collision woke the sleeper');
269
+ close(a); close(b);
270
+ }
271
+
272
+ // Empty-node lifecycle, reload and opt-out restore all flags/listeners.
273
+ {
274
+ const s = await side({ ...frozen, skipEmptyNodes: true });
275
+ const empty = actor('empty', 40);
276
+ delete empty.components.Shape;
277
+ s.runtime.spawnActor(empty);
278
+ prepareEmptyNodes(s.world, s.runtime);
279
+ for (let i = 0; i < 4; i++) frame(s);
280
+ assert.ok(node(s, 'empty').parent === null);
281
+ assert.equal(node(s, 'empty').frozenStatic, true);
282
+ const root = node(s, 'still');
283
+ const saved = s.runtime.serialize();
284
+ const clone = s.runtime.clone(); clone.dispose();
285
+ delete saved.engine.frozenStatics;
286
+ s.runtime.load(saved);
287
+ frame(s);
288
+ root.traverse(o => { assert.equal(o.matrixAutoUpdate, true); assert.equal(o.matrixWorldAutoUpdate, true); });
289
+ assert.equal(s.world.frozenStatics, undefined);
290
+ assert.equal(s.system.frozenPhysics, null);
291
+ close(s);
292
+ }
293
+ setLookEnabled(true);
294
+
295
+ // Review regressions are run independently so a failure in one does not hide
296
+ // the other five. Each exercises the real runtime/world/physics lifecycle.
297
+ const reviewRegressions = {
298
+ async 'reload removes obsolete nodes'() {
299
+ for (const nextPath of ['scenes/frozen.scene', 'scenes/other.scene']) {
300
+ const a = await side(frozen), b = await side(full);
301
+ try {
302
+ for (let i = 0; i < 3; i++) { frame(a); frame(b); }
303
+ for (const s of [a, b]) {
304
+ const next = s.runtime.serialize();
305
+ next.actors = next.actors.filter(a => a.id !== 'delete');
306
+ s.runtime.scenePath = nextPath;
307
+ s.runtime.load(next);
308
+ frame(s);
309
+ assert.equal(s.world.nodes.has('delete'), false, `removed actor remains after reload at ${nextPath}`);
310
+ assert.ok(!s.world.scene.children.some(n => n.userData.actorId === 'delete'));
311
+ }
312
+ same(a, b, `reload at ${nextPath}`);
313
+ for (let i = 0; i < 3; i++) { frame(a); frame(b); same(a, b, 'after reload'); }
314
+ } finally { close(a); close(b); }
315
+ }
316
+ },
317
+
318
+ async 'throwing placement retries the entire consumed batch'() {
319
+ const a = await side(frozen), b = await side(full);
320
+ const failure = new Error('first actor listener');
321
+ const listener = event => { if (event.child.userData.actorId === 'still') throw failure; };
322
+ try {
323
+ a.world.scene.addEventListener('childadded', listener);
324
+ assert.throws(() => frame(a), error => error === failure);
325
+ a.world.scene.removeEventListener('childadded', listener);
326
+ const pending = new Set([...a.world.frozenStatics.pending.dirty].map(a => a.id));
327
+ for (const actor of a.runtime.getActors()) assert.ok(pending.has(actor.id), `${actor.id} lost from consumed batch`);
328
+ frame(b); // Match the runtime/physics step completed before the throw.
329
+ frame(a); frame(b);
330
+ same(a, b, 'placement recovered on the next frame');
331
+ for (const actor of a.runtime.getActors()) {
332
+ assert.equal(a.world.scene.children.filter(n => n.userData.actorId === actor.id).length, 1, `${actor.id} has missing/duplicate visible nodes`);
333
+ }
334
+ } finally { a.world.scene.removeEventListener('childadded', listener); close(a); close(b); }
335
+ },
336
+
337
+ async 'animated unwatched ancestors keep children live'() {
338
+ const moving = 'models/frozen-moving-parent.pxmodel';
339
+ const fixture = engine => ({ engine, ground: { none: true }, actors: [
340
+ actor('animated-parent', 2, { Model: { file: moving, scale: 1 } }), actor('static-child', 1),
341
+ ] });
342
+ const a = await side(frozen, false, fixture(frozen)), b = await side(full, false, fixture(full));
343
+ const model = JSON.stringify({ format: 'pxmodel', parts: [{ id: 'sway', kind: 'box', size: [1, 1, 1], motion: { move: [0, 1, 0] } }] });
344
+ try {
345
+ for (const s of [a, b]) s.runtime.files[moving] = model;
346
+ for (let i = 0; i < 3; i++) { frame(a); frame(b); }
347
+ assert.ok(a.world.frozenStatics.live.has(a.runtime.getActor('animated-parent')), 'fixture parent is animated');
348
+ assert.equal(a.world.frozenStatics.records.has(a.runtime.getActor('animated-parent')), false, 'fixture parent is unwatched');
349
+ for (const s of [a, b]) node(s, 'animated-parent').add(node(s, 'static-child'));
350
+ frame(a); frame(b);
351
+ assert.notEqual(node(a, 'static-child').frozenStatic, true, 'child froze beneath an animated/unwatched parent');
352
+ for (let i = 0; i < 20; i++) {
353
+ for (const s of [a, b]) { s.runtime.getActor('animated-parent').components.Transform.x += 0.1; frame(s); }
354
+ same(a, b, `animated parent moves, frame ${i}`);
355
+ }
356
+ } finally { close(a); close(b); }
357
+ },
358
+
359
+ async 'initial invalidation marks grow linearly'() {
360
+ const samples = [];
361
+ for (const count of [100, 200, 400]) {
362
+ const s = await side(frozen, false, { engine: frozen, ground: { none: true },
363
+ actors: Array.from({ length: count }, (_, i) => actor(`static-${i}`, i * 2)) });
364
+ const owner = s.runtime.frozenActors, mark = owner.mark;
365
+ let marks = 0;
366
+ owner.mark = function (...args) { marks++; return mark.apply(this, args); };
367
+ try {
368
+ frame(s);
369
+ samples.push([count, marks]);
370
+ assert.ok(marks <= count * 2, `${count} initial actors required ${marks} invalidation marks`);
371
+ assert.equal(s.world.nodes.size, count);
372
+ frame(s); frame(s);
373
+ const visits = [...s.visits.values()].reduce((a, b) => a + b, 0);
374
+ frame(s);
375
+ assert.equal([...s.visits.values()].reduce((a, b) => a + b, 0), visits, 'initialization still settles');
376
+ } finally { owner.mark = mark; close(s); }
377
+ }
378
+ console.log(`frozen statics initial invalidation marks: ${JSON.stringify(samples)}`);
379
+ },
380
+
381
+ async 'serialization unwraps Map and Set keys/values and cycles'() {
382
+ const s = await side(frozen);
383
+ try {
384
+ const shape = s.runtime.getActor('still').components.Shape;
385
+ const map = new Map([['shape', shape], [shape, 'component key']]);
386
+ const set = new Set([shape, map]);
387
+ map.set('self', map); map.set('set', set); set.add(set);
388
+ s.runtime.getActor('still').components.References = { map, set };
389
+ const saved = s.runtime.serialize();
390
+ const actor = saved.actors.find(a => a.id === 'still');
391
+ const refs = actor.components.References;
392
+ assert.equal(refs.map.get('shape'), actor.components.Shape);
393
+ assert.equal(refs.map.get(actor.components.Shape), 'component key');
394
+ assert.equal(refs.map.get('self'), refs.map);
395
+ assert.equal(refs.map.get('set'), refs.set);
396
+ assert.ok(refs.set.has(actor.components.Shape) && refs.set.has(refs.map) && refs.set.has(refs.set));
397
+ assert.deepEqual(structuredClone(saved), saved, 'serialized graph contains no observation Proxies');
398
+ const clone = s.runtime.clone();
399
+ try { assert.deepEqual(clone.serialize(), saved); } finally { clone.dispose(); }
400
+ } finally { close(s); }
401
+ },
402
+
403
+ async 'body replacement and removal clear persistent motion caches'() {
404
+ for (const action of ['fixed', 'despawn']) {
405
+ const fixture = engine => ({ engine, ground: { none: true }, actors: [
406
+ actor('dynamic', 0, { Body: { type: 'dynamic', gravityScale: 0 } }),
407
+ ] });
408
+ const a = await side(frozen, false, fixture(frozen)), b = await side(full, false, fixture(full));
409
+ try {
410
+ frame(a); frame(b);
411
+ for (const s of [a, b]) s.runtime.physics3d.setVelocity('dynamic', { x: 1, y: 0, z: 0 });
412
+ frame(a); frame(b);
413
+ frame(a, DT / 2); frame(b, DT / 2);
414
+ const cached = a.system.frozenPhysics;
415
+ assert.ok(cached.settling.has('dynamic') && cached.newDynamics.has('dynamic'), 'fixture has persistent interpolation and pending-step entries');
416
+ for (const s of [a, b]) {
417
+ if (action === 'fixed') s.runtime.getActor('dynamic').components.Body.type = 'fixed';
418
+ else s.runtime.despawnActor('dynamic');
419
+ frame(s, 0); // Rebuild/remove even when Rapier cannot step this frame.
420
+ }
421
+ for (const key of ['settling', 'sampled', 'newDynamics']) assert.equal(cached[key].has('dynamic'), false, `${action} retained ${key}`);
422
+ for (let i = 0; i < 10; i++) { frame(a); frame(b); same(a, b, `${action} after dynamic caching`); }
423
+ } finally { close(a); close(b); }
424
+ }
425
+ },
426
+ };
427
+ const reviewFailures = [];
428
+ for (const [name, test] of Object.entries(reviewRegressions)) {
429
+ try { await test(); }
430
+ catch (error) { reviewFailures.push(`${name}: ${error.message}`); }
431
+ }
432
+ assert.equal(reviewFailures.length, 0, reviewFailures.join('\n'));
433
+ console.log(`frozen statics review regressions: ${Object.keys(reviewRegressions).length} passed`);
434
+ console.log('frozen statics: 100-frame byte parity, all writers, audit, zero static visits, real Rapier sleep/wake, lifecycle passed');
@@ -44,7 +44,7 @@ const { syncActors, renderWorld, disposeWorld } = await import('../engine3d/worl
44
44
  // later, and it changes only when what the look bakes into a model is meant
45
45
  // to change: then run `node scripts/look-baseline.mjs` and put its number
46
46
  // here, in the commit that means it.
47
- const BAKED_AT_ONCE = '0903359ab39721f4cea54ea02824381c422562298b905ebb0e63b88e16f08573';
47
+ const BAKED_AT_ONCE = 'a7bcbc7167c874e6225964fb420a95750abeb7b87f39a9242622418604f2e411';
48
48
 
49
49
  function build(model, path, optimize, queue) {
50
50
  const make = () => buildModelNode(model.parsed, {}, model.files, path, [path], optimize ? { optimize: true } : {});
@@ -683,7 +683,7 @@ const scenarios = {
683
683
  nearOf(world, own);
684
684
  assert.ok(world.cast.includes(near), 'a caster within the distance is drawn');
685
685
  assert.ok(world.cast.includes(far), 'and this one past it happens to be: nothing cuts receivers off');
686
- for (const file of ['../engine3d/nearshadows.js', '../CLAUDE.md', '../../../experiments/hub-world/README.md']) {
686
+ for (const file of ['../engine3d/nearshadows.js', '../docs/engine-shadows.md', '../../../experiments/hub-world/README.md']) {
687
687
  const text = fs.readFileSync(new URL(file, import.meta.url), 'utf8').replace(/\s*\n\s*(\/\/|>)?\s*/g, ' ');
688
688
  assert.ok(!/past `distance` nothing is shadowed|drawn only out to|shadows stop `distance`/.test(text), `${file} does not say shadows stop at the distance`);
689
689
  }
@@ -970,7 +970,7 @@ const scenarios = {
970
970
  const near = [within, beyond, farSide].map((mesh) => world.cast.includes(mesh));
971
971
  assert.deepEqual(plain, [true, false, true], "the sun's own camera does not draw a caster 25 m up the light");
972
972
  assert.deepEqual(near, plain, "and the mode's draws what it draws");
973
- for (const file of ['../engine3d/nearshadows.js', '../CLAUDE.md']) {
973
+ for (const file of ['../engine3d/nearshadows.js', '../docs/engine-shadows.md']) {
974
974
  const text = fs.readFileSync(new URL(file, import.meta.url), 'utf8').replace(/\s*\n\s*(\/\/|>)?\s*/g, ' ');
975
975
  assert.ok(/complete out to `distance` for casters (inside|within) /.test(text), `${file} limits the claim to the depth range`);
976
976
  assert.ok(text.includes('19.4 m toward the sun and 30.1 m away'), `${file} gives the range for the engine's sun`);