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
@@ -456,7 +456,9 @@ const scenarios = {
456
456
  },
457
457
  });
458
458
  const material = new THREE.MeshStandardMaterial();
459
+ // eslint-disable-next-line no-self-assign -- the setter must survive a reassignment of its own value
459
460
  material.onBeforeCompile = material.onBeforeCompile;
461
+ // eslint-disable-next-line no-self-assign -- the setter must survive a reassignment of its own value
460
462
  material.customProgramCacheKey = material.customProgramCacheKey;
461
463
  const before = Reflect.ownKeys(material);
462
464
  install(material, { rim: 0.2, ao: 0 }, { getAttribute: () => null });
@@ -908,6 +910,79 @@ const scenarios = {
908
910
  assert.equal(world.shadowFade.count, 0, 'no mesh is noted outside a frame');
909
911
  },
910
912
 
913
+ 'descriptor checks preserve proxy assignments and material attributes without reading getters'() {
914
+ const stuff = makeStuff();
915
+ const world = makeWorld(stuff);
916
+ frames(world, runtime(world, KEYED), 2);
917
+ const mesh = world.scene.getObjectByName('standard');
918
+ const material = mesh.material;
919
+ Object.defineProperty(mesh, 'material', { enumerable: false });
920
+ const before = Object.getOwnPropertyDescriptor(mesh, 'material');
921
+ const assigned = [];
922
+ let reads = 0;
923
+ const proxy = new Proxy(mesh, {
924
+ get(target, key, receiver) {
925
+ if (key === 'material') reads++;
926
+ return Reflect.get(target, key, receiver);
927
+ },
928
+ set(target, key, value, receiver) {
929
+ if (key === 'material') assigned.push(value);
930
+ return Reflect.set(target, key, value, receiver);
931
+ },
932
+ });
933
+ const parent = mesh.parent;
934
+ parent.remove(mesh);
935
+ parent.add(proxy);
936
+ const fade = world.shadowFade;
937
+ try {
938
+ fade.begin(40, world.sun);
939
+ assert.ok(isVariantOf(Object.getOwnPropertyDescriptor(mesh, 'material').value, material));
940
+ } finally {
941
+ fade.end();
942
+ }
943
+ assert.equal(reads, 0, 'the fade only reads descriptors, even through a proxy');
944
+ assert.equal(assigned.length, 2, 'both assignments still go through the proxy');
945
+ assert.ok(isVariantOf(assigned[0], material));
946
+ assert.equal(assigned[1], material);
947
+ assert.deepEqual(Object.getOwnPropertyDescriptor(mesh, 'material'), before, 'all attributes restored');
948
+ },
949
+
950
+ 'eligibility stays live after direct writes without a material version bump'() {
951
+ const stuff = makeStuff();
952
+ const world = makeWorld(stuff);
953
+ const run = runtime(world, KEYED);
954
+ frames(world, run, 2);
955
+ const mesh = world.scene.getObjectByName('standard');
956
+ const material = mesh.material;
957
+ const replacement = stuff.lit.lambert;
958
+ const versions = [material.version, replacement.version];
959
+ const draw = () => {
960
+ frames(world, run, 1);
961
+ const main = world.draws.filter((entry) => entry.name === 'standard' && !entry.shadow);
962
+ assert.equal(mesh.material, replacement, 'the replacement is back after each render');
963
+ if (mesh.visible) assert.ok(main.length > 0, 'the visible mesh was drawn');
964
+ return main;
965
+ };
966
+ mesh.material = replacement;
967
+ assert.ok(draw().every((entry) => isVariantOf(entry.material, replacement) && entry.fade));
968
+ mesh.receiveShadow = false;
969
+ assert.ok(draw().every((entry) => entry.material === replacement && !entry.fade));
970
+ mesh.receiveShadow = true;
971
+ let callbacks = 0;
972
+ mesh.onBeforeRender = (_renderer, _scene, _camera, _geometry, drawn) => {
973
+ assert.equal(drawn, replacement, 'a newly installed deck callback gets the original');
974
+ callbacks++;
975
+ };
976
+ assert.ok(draw().every((entry) => !entry.fade));
977
+ assert.ok(callbacks > 0);
978
+ delete mesh.onBeforeRender;
979
+ mesh.visible = false;
980
+ assert.equal(draw().length, 0);
981
+ mesh.visible = true;
982
+ assert.ok(draw().every((entry) => isVariantOf(entry.material, replacement) && entry.fade));
983
+ assert.deepEqual([material.version, replacement.version], versions, 'none of these writes moves a material version');
984
+ },
985
+
911
986
  // Reviews 1 and 2: a deck's own hook that stores the shader on the
912
987
  // material (through `this` or a closure), writes a define, or renders
913
988
  // another world that shares the material, as three's examples do. Its
@@ -1860,8 +1935,9 @@ const scenarios = {
1860
1935
  };
1861
1936
 
1862
1937
  // The cost of a faded frame's own work: the walk, the swaps and the swaps
1863
- // back, for a scene of `count` receiving meshes.
1864
- export function measure(count = 500, frames = 2000) {
1938
+ // back and settling, for a scene of `count` receiving meshes. An optional
1939
+ // saved module is for bench-shadow-fade.mjs's before/after comparison.
1940
+ export function measure(count = 500, frames = 2000, moduleURL = new URL('../engine3d/shadowfade.js', import.meta.url)) {
1865
1941
  const pass = { render() {} };
1866
1942
  // A renderer that compiles by adding its one dispose listener, as three's.
1867
1943
  const released = () => {};
@@ -1875,21 +1951,23 @@ export function measure(count = 500, frames = 2000) {
1875
1951
  mesh.receiveShadow = true;
1876
1952
  world.scene.add(mesh);
1877
1953
  }
1878
- return import('../engine3d/shadowfade.js').then(({ holdShadowFade }) => {
1954
+ return import(moduleURL).then(({ holdShadowFade, renderShadowFaded, dropShadowFade }) => {
1879
1955
  const fade = holdShadowFade(world, { nearShadowDistance: 40 });
1880
1956
  // As three's render calls them: the scene's hook, the shadow pass's,
1881
1957
  // then the frame's end.
1882
- const frame = () => {
1958
+ const frame = () => renderShadowFaded(fade, () => {
1883
1959
  fade.begin(40, sun);
1884
1960
  world.scene.onBeforeRender(null, world.scene, world.camera, null);
1885
1961
  pass.render([], world.scene, world.camera);
1886
1962
  fade.end();
1887
- };
1888
- for (let i = 0; i < 200; i++) frame();
1963
+ });
1964
+ for (let i = 0; i < Math.min(200, frames); i++) frame();
1889
1965
  assert.equal(fade.variants.size, 40);
1890
1966
  const start = process.hrtime.bigint();
1891
1967
  for (let i = 0; i < frames; i++) frame();
1892
- return Number(process.hrtime.bigint() - start) / 1000 / frames;
1968
+ const elapsed = Number(process.hrtime.bigint() - start) / 1000 / frames;
1969
+ dropShadowFade(world);
1970
+ return elapsed;
1893
1971
  });
1894
1972
  }
1895
1973
 
@@ -1918,3 +1996,6 @@ if (process.argv[1] === new URL(import.meta.url).pathname) {
1918
1996
  console.log(`orbit shadow fade: ${await run()} scenarios`);
1919
1997
  console.log(`a faded frame's own work, 500 receiving meshes: ${(await measure()).toFixed(1)} us`);
1920
1998
  }
1999
+
2000
+ // Reuse the real WebGLRenderer/fake-context harness for still-shadow tests.
2001
+ export { makeWorld, makeStuff, runtime, frames };
@@ -8,7 +8,7 @@ const cutInput = (file) => {
8
8
  const source = readFileSync(new URL(file, import.meta.url), 'utf8');
9
9
  return source.slice(source.indexOf('function attachInput('), source.indexOf('\nfunction attachResize('));
10
10
  };
11
- const inputSource = cutInput('../engine3d/Scene3DPlayer.jsx');
11
+ const inputSource = cutInput('../engine3d/playerRun.js');
12
12
  const beforeSource = cutInput('./Scene3DPlayer.before-orbit.jsx');
13
13
  const tick = () => new Promise((resolve) => setTimeout(resolve, 0));
14
14
  const near = (got, expected) => assert.ok(Math.abs(got - expected) < 1e-12, `${got} ~= ${expected}`);
@@ -118,7 +118,7 @@ function harness({ keyed = true, fine = true, mode = 'promise', chromium = false
118
118
  get exits() { return exits; },
119
119
  get button() { return parent.children[0]; },
120
120
  get on() { return runtime.orbitInput().shiftLock.active; },
121
- listen() { runtime.orbitInput(); runtime.lookInput.listen(); },
121
+ listen(keyboard = true) { runtime.orbitInput(); runtime.lookInput.listen(); if (keyboard) { win.fire('keydown', { code: 'Tab' }); win.fire('keyup', { code: 'Tab' }); runtime.lookInput.listen(); } },
122
122
  take: () => ({ ...runtime.lookInput.consume() }),
123
123
  shift(more = {}) { return win.fire('keydown', { key: 'Shift', code: 'ShiftLeft', repeat: false, target: canvas, ...more }); },
124
124
  flush() { for (const fn of later.splice(0)) fn(); },
@@ -170,6 +170,43 @@ export async function runShiftLockChecks() {
170
170
  before.detach();
171
171
  checks += 1;
172
172
  }
173
+ // Fine pointer capability alone is not a hardware keyboard. Touch/pen
174
+ // immediately relinquish both the visible control and an active lock.
175
+ {
176
+ const h = harness();
177
+ h.listen(false);
178
+ assert.equal(h.button, undefined, 'cold fine-pointer page has no keyboard chrome');
179
+ for (const event of [
180
+ { code: 'KeyW', isComposing: true }, { code: 'KeyW', ctrlKey: true },
181
+ { code: 'KeyW', target: { isContentEditable: true } },
182
+ { code: 'Enter', target: { closest: () => true } },
183
+ ]) h.win.fire('keydown', event);
184
+ assert.equal(h.button, undefined, 'typing and composing do not infer a hardware keyboard');
185
+ h.win.fire('keydown', { code: 'KeyW' });
186
+ assert.equal(h.button.style.display, 'flex');
187
+ h.win.fire('pointerdown', { pointerType: 'mouse' });
188
+ assert.equal(h.button.style.display, 'flex', 'mouse can use keyboard chrome');
189
+ h.shift(); await h.grant();
190
+ h.win.fire('pointerdown', { pointerType: 'touch' });
191
+ assert.equal(h.button.style.display, 'none'); assert.equal(h.on, false);
192
+ h.flush();
193
+ h.win.fire('keydown', { code: 'Tab' });
194
+ assert.equal(h.button.style.display, 'flex', 'keyboard can resume after touch');
195
+ h.win.fire('pointerdown', { pointerType: 'pen' });
196
+ assert.equal(h.button.style.display, 'none');
197
+ h.win.fire('keydown', { code: 'KeyW' });
198
+ h.runtime.lookInput.reset();
199
+ h.runtime.cameraControl = null;
200
+ h.win.fire('pointerdown', { pointerType: 'touch' });
201
+ h.runtime.cameraControl = 'orbit';
202
+ h.listen(false);
203
+ assert.equal(h.button.style.display, 'none', 'returning from an unobserved scene needs fresh keyboard input');
204
+ h.win.fire('keydown', { code: 'KeyW' });
205
+ assert.equal(h.button.style.display, 'flex');
206
+ h.detach();
207
+ assert(!h.win.listeners.some(entry => entry.type === 'pointerdown'), 'input observer removed');
208
+ checks += 1;
209
+ }
173
210
  // A Shift gesture before the first Player frame also makes the control
174
211
  // lazily; attaching the keyless input handlers alone makes nothing.
175
212
  {
@@ -500,7 +537,7 @@ export async function runShiftLockChecks() {
500
537
  assert.equal(h.button, undefined);
501
538
  assert.equal(h.requests, 0);
502
539
  assert.equal(h.doc.listeners.length, 0);
503
- assert.deepEqual(h.win.listeners.map((entry) => entry.type), ['keydown', 'keyup']);
540
+ assert.deepEqual(h.win.listeners.map((entry) => entry.type), ['keydown', 'keyup', 'keydown', 'pointerdown']);
504
541
  for (const pointerType of ['touch', 'pen']) {
505
542
  h.pointer('pointerdown', 1, { pointerType, clientX: 100 });
506
543
  h.pointer('pointermove', 1, { pointerType, clientX: 160 });
@@ -140,7 +140,7 @@ function harness({ keyed = true, rigid = true, PlayerClass = Player } = {}) {
140
140
  };
141
141
  const scene = { cameraControl: keyed ? 'orbit' : null, cameraFollowsRigidly: rigid,
142
142
  data: { engine: { camera: { fov: 83 } } }, physics3d: phys, three: { camera },
143
- persistent: {}, time: 0, keys: new Set(), actorsWith: () => [], getActor: () => actor,
143
+ persistent: {}, time: 0, keys: new Set(), actorsWith: () => [], getActors: () => [actor], getActor: () => actor,
144
144
  lookInput: { listen() {}, consume() { consumed += 1; const out = input; input = { yaw: 0, pitch: 0, zoom: 1, locked: false }; return out; } },
145
145
  };
146
146
  const frame = (dt = DT, keys = []) => {
@@ -569,6 +569,80 @@ export async function runOrbitShotChecks() {
569
569
  assert.ok(a.frame(DT, [arrow]).calls.length > 0, `${arrow} moves under a shot`);
570
570
  checks += 1;
571
571
  }
572
+ // A held view can opt into screen-relative walking independently of the
573
+ // persistent arrival heading. Check keyboard and stick through real impulses.
574
+ const walkInputs = [
575
+ { keys: ['KeyW'], ahead: 1, aside: 0 },
576
+ { keys: ['ArrowUp'], ahead: 1, aside: 0 },
577
+ { keys: ['KeyS'], ahead: -1, aside: 0 },
578
+ { keys: ['ArrowDown'], ahead: -1, aside: 0 },
579
+ { keys: ['KeyA'], ahead: 0, aside: -1 },
580
+ { keys: ['ArrowLeft'], ahead: 0, aside: -1 },
581
+ { keys: ['KeyD'], ahead: 0, aside: 1 },
582
+ { keys: ['ArrowRight'], ahead: 0, aside: 1 },
583
+ { stick: { x: 0, y: -1 }, ahead: 1, aside: 0 },
584
+ { stick: { x: 0, y: 1 }, ahead: -1, aside: 0 },
585
+ { stick: { x: -1, y: 0 }, ahead: 0, aside: -1 },
586
+ { stick: { x: 1, y: 0 }, ahead: 0, aside: 1 },
587
+ ];
588
+ function checkWalk(h, input, yaw, message) {
589
+ const angle = h.scene.persistent.camAngle;
590
+ h.scene.moveInput = input.stick && { active: true, ...input.stick };
591
+ const result = h.frame(DT, input.keys);
592
+ const impulse = result.calls.find(([kind, v]) => kind === 'impulse' && Math.hypot(v.x, v.z) > 0)?.[1];
593
+ assert.ok(impulse, `${message}: walking impulse`);
594
+ const length = Math.hypot(impulse.x, impulse.z);
595
+ near(impulse.x / length, Math.sin(yaw) * input.ahead + Math.cos(yaw) * input.aside, `${message}: x`);
596
+ near(impulse.z / length, -Math.cos(yaw) * input.ahead + Math.sin(yaw) * input.aside, `${message}: z`);
597
+ assert.equal(h.scene.persistent.camAngle, angle, `${message}: persistent heading kept`);
598
+ }
599
+ for (const input of walkInputs) {
600
+ const h = harness(); h.run(240);
601
+ h.scene.data.engine.camera.walkFromShot = true;
602
+ h.scene.orbitShot = { ...shotA(), yaw: 225 }; h.run(300);
603
+ const forward = h.camera.getWorldDirection(new THREE.Vector3());
604
+ const yaw = Math.atan2(forward.x, -forward.z);
605
+ checkWalk(h, input, yaw, 'held shot uses screen direction, 180 degrees from camAngle');
606
+ // Absent and explicitly false retain the old basis for the same input.
607
+ for (const enabled of [undefined, false]) {
608
+ if (enabled === undefined) delete h.scene.data.engine.camera.walkFromShot;
609
+ else h.scene.data.engine.camera.walkFromShot = enabled;
610
+ checkWalk(h, input, h.scene.persistent.camAngle, `walkFromShot ${enabled}: old basis`);
611
+ }
612
+ checks += 1;
613
+ }
614
+ // Entry has no drawn shot yaw yet, so it uses the target. Thereafter use
615
+ // the view already on screen while it eases, including a changed shot.
616
+ {
617
+ const h = harness(); h.run(240);
618
+ h.scene.data.engine.camera.walkFromShot = true;
619
+ h.scene.orbitShot = { ...shotA(), yaw: 225 };
620
+ checkWalk(h, walkInputs[0], 225 * Math.PI / 180, 'entry uses target yaw');
621
+ for (let i = 0; i < 20; i += 1) {
622
+ if (i === 10) h.scene.orbitShot = { ...shotA(), yaw: -90 };
623
+ const forward = h.camera.getWorldDirection(new THREE.Vector3());
624
+ checkWalk(h, walkInputs[i % walkInputs.length], Math.atan2(forward.x, -forward.z), 'blend uses drawn yaw');
625
+ }
626
+ // Clearing or invalidating a shot ignores its retained drawn state.
627
+ for (const shot of [null, { ...shotA(), distance: 0 }]) {
628
+ h.scene.orbitShot = shot;
629
+ checkWalk(h, walkInputs[0], h.scene.persistent.camAngle, 'no valid shot uses follow heading');
630
+ }
631
+ checks += 1;
632
+ }
633
+ // Follow-mode turns, camera placement, facing and impulses stay identical
634
+ // with the new key, even while a previous held shot is handing back.
635
+ {
636
+ const now = harness(), before = harness();
637
+ now.scene.data.engine.camera.walkFromShot = true;
638
+ for (const h of [now, before]) { h.run(60); h.scene.orbitShot = shotA(); h.run(30); h.scene.orbitShot = null; }
639
+ for (let i = 0; i < 60; i += 1) {
640
+ for (const h of [now, before]) h.scene.moveInput = i % 2 ? { active: true, x: .4, y: -.8 } : null;
641
+ const keys = i % 2 ? [] : ['KeyW', 'ArrowRight'];
642
+ assert.deepEqual(now.frame(DT, keys), before.frame(DT, keys), 'no shot leaves follow mode unchanged');
643
+ }
644
+ checks += 1;
645
+ }
572
646
  // Both keyless follow modes ignore even a throwing orbitShot getter.
573
647
  for (const rigid of [false, true]) {
574
648
  const h = harness({ keyed: false, rigid }), before = harness({ keyed: false, rigid, PlayerClass: PlayerBefore });
@@ -0,0 +1,106 @@
1
+ import assert from 'node:assert/strict';
2
+ import { execFileSync } from 'node:child_process';
3
+ import { createHash } from 'node:crypto';
4
+ import { readFileSync } from 'node:fs';
5
+ import { fileURLToPath } from 'node:url';
6
+ import { gunzipSync } from 'node:zlib';
7
+ import { gunzipSync as fallbackGunzip } from 'fflate';
8
+
9
+ const entry = new URL(import.meta.resolve('@dimforge/rapier3d-compat'));
10
+ const { version } = JSON.parse(readFileSync(new URL('package.json', entry), 'utf8'));
11
+ const upstream = readFileSync(entry, 'utf8');
12
+ const originalBase64 = upstream.match(/toByteArray\("(AGFzbQ[A-Za-z0-9+/=]+)"\)/)[1];
13
+ const originalWasm = Buffer.from(originalBase64, 'base64');
14
+ const hash = bytes => createHash('sha256').update(bytes).digest('hex');
15
+ const moduleURL = new URL('../engine3d/rapier.js', import.meta.url);
16
+ const before = readFileSync(moduleURL, 'utf8');
17
+
18
+ // Check before regenerating so an installed dependency bump cannot hide drift.
19
+ assert.equal(before.match(/^\/\/ Source: @dimforge\/rapier3d-compat (\S+)/m)?.[1], version,
20
+ 'Rapier version changed: regenerate with node scripts/build-rapier-gz.mjs');
21
+ assert.equal(before.match(/^\/\/ Original wasm sha256: (\w+)/m)?.[1], hash(originalWasm),
22
+ 'Rapier wasm changed: regenerate with node scripts/build-rapier-gz.mjs');
23
+ assert.deepEqual(originalWasm, readFileSync(new URL('rapier_wasm3d_bg.wasm', entry)));
24
+ const compressed = Buffer.from(before.match(/castleRapierWasm\(\(\) => Lg\.toByteArray\("([A-Za-z0-9+/=]+)"\)\)/)[1], 'base64');
25
+ assert.equal(compressed.readUInt32LE(4), 0, 'gzip mtime must be fixed at zero');
26
+ assert.deepEqual(gunzipSync(compressed), originalWasm);
27
+ assert.equal(hash(fallbackGunzip(compressed)), hash(originalWasm));
28
+ assert.equal(typeof DecompressionStream, 'function', 'Run this test on Node 22+');
29
+ const stream = new Blob([compressed]).stream().pipeThrough(new DecompressionStream('gzip'));
30
+ assert.equal(hash(new Uint8Array(await new Response(stream).arrayBuffer())), hash(originalWasm));
31
+ console.log(`PASS wasm bytes: ${originalWasm.length} bytes, sha256 ${hash(originalWasm)} (native + fflate)`);
32
+
33
+ function fall(rapier) {
34
+ const world = new rapier.World({ x: 0, y: -9.81, z: 0 });
35
+ try {
36
+ world.timestep = 1 / 60;
37
+ const body = world.createRigidBody(rapier.RigidBodyDesc.dynamic().setTranslation(0, 10, 0));
38
+ world.createCollider(rapier.ColliderDesc.ball(0.5), body);
39
+ for (let i = 0; i < 60; i++) world.step();
40
+ const position = body.translation();
41
+ assert(position.y < 10, 'Body must fall');
42
+ return { x: position.x, y: position.y, z: position.z };
43
+ } finally {
44
+ world.free();
45
+ }
46
+ }
47
+
48
+ async function initialize(rapier, args) {
49
+ const warnings = [];
50
+ const warn = console.warn;
51
+ console.warn = (...values) => warnings.push(values);
52
+ try {
53
+ assert.equal(await rapier.init(...args), undefined);
54
+ assert.equal(await rapier.default.init(...args), undefined, 'Repeated/default init resolves too');
55
+ } finally {
56
+ console.warn = warn;
57
+ }
58
+ return warnings;
59
+ }
60
+
61
+ const native = globalThis.DecompressionStream;
62
+ try {
63
+ for (const mode of ['native', 'fallback']) {
64
+ globalThis.DecompressionStream = mode === 'native' ? native : undefined;
65
+ // Compat init ignores arguments; preserve its no-argument signature and the
66
+ // internal deprecated-ArrayBuffer warning, even when callers supply a value.
67
+ for (const [label, args] of [['no-args', []], ['object', [{}]], ['deprecated', [new Uint8Array()]]]) {
68
+ const original = await import(`${entry.href}?${mode}-${label}`);
69
+ const generated = await import(`${moduleURL.href}?${mode}-${label}`);
70
+ assert.deepEqual(Object.keys(generated), Object.keys(original), 'All named exports are preserved');
71
+ assert.deepEqual(Object.keys(generated.default), Object.keys(original.default), 'Default API is preserved');
72
+ assert.equal(generated.init.length, original.init.length);
73
+ for (const key of Object.keys(original.default)) {
74
+ assert.equal(generated.default[key], generated[key], `Default/named export identity: ${key}`);
75
+ }
76
+ const warnings = await initialize(original, args);
77
+ assert.equal(warnings.length, 1);
78
+ assert.match(warnings[0][0], /using deprecated parameters/);
79
+ assert.deepEqual(await initialize(generated, args), warnings);
80
+ assert.equal(generated.version(), original.version());
81
+ const position = fall(original);
82
+ assert.deepEqual(fall(generated), position);
83
+ console.log(`PASS ${mode} ${label}: init, exports, warnings, repeated init; 60 steps ${JSON.stringify(position)}`);
84
+ }
85
+ }
86
+ } finally {
87
+ globalThis.DecompressionStream = native;
88
+ }
89
+
90
+ execFileSync(process.execPath, [fileURLToPath(new URL('./build-rapier-gz.mjs', import.meta.url))],
91
+ { timeout: 10_000, killSignal: 'SIGKILL', stdio: 'pipe' });
92
+ assert.equal(readFileSync(moduleURL, 'utf8'), before, 'Generator must be byte-identical on rerun');
93
+ console.log('PASS generator idempotence and installed version/wasm header checks');
94
+ console.log(`SIZE original base64: ${originalBase64.length} bytes; gzip base64: ${compressed.toString('base64').length} bytes; generated module: ${Buffer.byteLength(before)} bytes`);
95
+
96
+ // Like the package, a repeated init() answers within one tick: callers that
97
+ // wait a tick after init has run once (physics3d attach) must not see it pending.
98
+ {
99
+ const generated = await import(moduleURL.href);
100
+ await generated.init();
101
+ let again = false;
102
+ generated.init().then(() => { again = true; });
103
+ await new Promise((resolve) => setTimeout(resolve, 0));
104
+ assert.equal(again, true, 'a repeated init resolves within one tick');
105
+ console.log('PASS repeated init within one tick');
106
+ }
@@ -1,5 +1,5 @@
1
1
  // `"engine": { "sky": { ... } }` (physics-2d engine/skyKey.js, engine3d/sky.js;
2
- // CLAUDE.md has the terms), on the real `renderWorld`, the real key reader and
2
+ // docs/engine-sky.md has the terms), on the real `renderWorld`, the real key reader and
3
3
  // the real SceneRuntime.
4
4
  //
5
5
  // - The key: absent is null with no warning and no work; every malformed