castle-web-cli 0.4.233 → 0.4.234

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 (381) 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 +260 -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 +50 -4
  39. package/kits/base/sdk/multiplayer.d.ts +7 -1
  40. package/kits/base/sdk/multiplayer.js +140 -40
  41. package/kits/base/sdk/multiplayerProtocol.d.ts +2 -0
  42. package/kits/base/sdk/party.d.ts +23 -0
  43. package/kits/base/sdk/party.js +91 -0
  44. package/kits/base/sdk/reconnectBudget.d.ts +23 -0
  45. package/kits/base/sdk/reconnectBudget.js +96 -0
  46. package/kits/base/sdk/save.d.ts +38 -1
  47. package/kits/base/sdk/save.js +79 -6
  48. package/kits/base/sdk/server/hub.d.ts +31 -1
  49. package/kits/base/sdk/server/hub.js +50 -3
  50. package/kits/base/sdk/server/platformHandle.d.ts +13 -1
  51. package/kits/base/sdk/server/storage.d.ts +4 -0
  52. package/kits/base/sdk/server/storage.js +19 -3
  53. package/kits/base/sdk/server/wrapper.d.ts +7 -1
  54. package/kits/base/sdk/server/wrapper.js +10 -1
  55. package/kits/base/sdk/social.d.ts +9 -0
  56. package/kits/base/sdk/social.js +5 -0
  57. package/kits/hub-game/CLAUDE.md +123 -3
  58. package/kits/hub-game/README.md +63 -0
  59. package/kits/hub-game/castle.json +5 -5
  60. package/kits/hub-game/code/client/act.js +312 -0
  61. package/kits/hub-game/code/client/actionLayout.js +147 -0
  62. package/kits/hub-game/code/client/actionOverflow.js +556 -0
  63. package/kits/hub-game/code/client/arrivalCamera.js +50 -0
  64. package/kits/hub-game/code/client/askSlot.js +117 -0
  65. package/kits/hub-game/code/client/avatar.js +4 -2
  66. package/kits/hub-game/code/client/avatarShare.js +2 -0
  67. package/kits/hub-game/code/client/backVisibility.js +13 -0
  68. package/kits/hub-game/code/client/ballot.js +15 -10
  69. package/kits/hub-game/code/client/build.js +16 -0
  70. package/kits/hub-game/code/client/chat.js +41 -5
  71. package/kits/hub-game/code/client/chatModeration.js +5 -0
  72. package/kits/hub-game/code/client/chrome.js +1148 -258
  73. package/kits/hub-game/code/client/crowdNames.js +241 -0
  74. package/kits/hub-game/code/client/decor.js +10 -4
  75. package/kits/hub-game/code/client/defaultEnvironment.js +194 -0
  76. package/kits/hub-game/code/client/doorErrors.js +39 -0
  77. package/kits/hub-game/code/client/fall.js +18 -0
  78. package/kits/hub-game/code/client/farAvatars.js +233 -0
  79. package/kits/hub-game/code/client/firstJoin.js +9 -2
  80. package/kits/hub-game/code/client/fpsTelemetry.js +50 -0
  81. package/kits/hub-game/code/client/frameBatch.js +5 -0
  82. package/kits/hub-game/code/client/grab.js +31 -11
  83. package/kits/hub-game/code/client/hookLayer.js +87 -8
  84. package/kits/hub-game/code/client/hudCopy.js +51 -0
  85. package/kits/hub-game/code/client/hudRate.js +20 -0
  86. package/kits/hub-game/code/client/idle.js +14 -2
  87. package/kits/hub-game/code/client/invites.js +231 -0
  88. package/kits/hub-game/code/client/joinError.js +9 -0
  89. package/kits/hub-game/code/client/labelsNear.js +31 -2
  90. package/kits/hub-game/code/client/landscapeLayout.js +17 -0
  91. package/kits/hub-game/code/client/layoutCache.js +264 -0
  92. package/kits/hub-game/code/client/loadTelemetry.js +20 -0
  93. package/kits/hub-game/code/client/loadingCover.js +148 -0
  94. package/kits/hub-game/code/client/loadingEntry.js +8 -0
  95. package/kits/hub-game/code/client/menuRows.js +43 -0
  96. package/kits/hub-game/code/client/modelReady.js +7 -0
  97. package/kits/hub-game/code/client/padCueArrival.js +23 -0
  98. package/kits/hub-game/code/client/padCues.js +112 -0
  99. package/kits/hub-game/code/client/padOccupancy.js +88 -0
  100. package/kits/hub-game/code/client/padReadability.js +26 -0
  101. package/kits/hub-game/code/client/padRings.js +69 -0
  102. package/kits/hub-game/code/client/pushVisit.js +14 -0
  103. package/kits/hub-game/code/client/quality.js +205 -0
  104. package/kits/hub-game/code/client/qualityEntry.js +55 -0
  105. package/kits/hub-game/code/client/safeLayout.js +338 -0
  106. package/kits/hub-game/code/client/safeStyle.js +42 -0
  107. package/kits/hub-game/code/client/say.js +12 -3
  108. package/kits/hub-game/code/client/shot.js +64 -10
  109. package/kits/hub-game/code/client/shotFit.js +56 -0
  110. package/kits/hub-game/code/client/signIn.js +28 -0
  111. package/kits/hub-game/code/client/state.js +53 -0
  112. package/kits/hub-game/code/client/talk.js +209 -45
  113. package/kits/hub-game/code/client/tiers.js +68 -66
  114. package/kits/hub-game/code/client/together.js +7 -2
  115. package/kits/hub-game/code/client/weakestLookBake.js +92 -0
  116. package/kits/hub-game/code/client/weakestTier.js +295 -0
  117. package/kits/hub-game/code/client/worldLabels.js +241 -0
  118. package/kits/hub-game/code/client/yours.js +10 -9
  119. package/kits/hub-game/code/npcDisplayText.js +55 -0
  120. package/kits/hub-game/code/server/act.js +124 -0
  121. package/kits/hub-game/code/server/actions.js +6 -1
  122. package/kits/hub-game/code/server/actors.js +2 -1
  123. package/kits/hub-game/code/server/analytics.js +83 -0
  124. package/kits/hub-game/code/server/anonymousEntry.js +49 -0
  125. package/kits/hub-game/code/server/arrivalPose.js +36 -0
  126. package/kits/hub-game/code/server/companion.js +28 -3
  127. package/kits/hub-game/code/server/doorAnalytics.js +52 -0
  128. package/kits/hub-game/code/server/earned.js +22 -5
  129. package/kits/hub-game/code/server/frameBatch.js +183 -0
  130. package/kits/hub-game/code/server/friendsAmong.js +49 -9
  131. package/kits/hub-game/code/server/history.js +2 -0
  132. package/kits/hub-game/code/server/hub.js +1306 -95
  133. package/kits/hub-game/code/server/idle.js +30 -1
  134. package/kits/hub-game/code/server/index.js +26 -4
  135. package/kits/hub-game/code/server/invites.js +19 -0
  136. package/kits/hub-game/code/server/labels.js +9 -1
  137. package/kits/hub-game/code/server/loadAbandon.js +106 -0
  138. package/kits/hub-game/code/server/manifest.js +211 -3
  139. package/kits/hub-game/code/server/menu.js +31 -3
  140. package/kits/hub-game/code/server/npcs.js +226 -64
  141. package/kits/hub-game/code/server/observe.js +408 -0
  142. package/kits/hub-game/code/server/padOccupancy.js +85 -0
  143. package/kits/hub-game/code/server/players.js +9 -1
  144. package/kits/hub-game/code/server/resumePose.js +152 -0
  145. package/kits/hub-game/code/server/say.js +1 -1
  146. package/kits/hub-game/code/server/standing.js +4 -5
  147. package/kits/hub-game/code/server/storageLimit.js +187 -0
  148. package/kits/hub-game/code/server/vis.js +67 -5
  149. package/kits/hub-game/code/shared/act.js +35 -0
  150. package/kits/hub-game/code/shared/danceIdle.js +28 -0
  151. package/kits/hub-game/code/shared/loadStages.js +12 -0
  152. package/kits/hub-game/code/shared/quality.js +74 -0
  153. package/kits/hub-game/code/shared/say.js +2 -0
  154. package/kits/hub-game/code/shared/shot.js +35 -1
  155. package/kits/hub-game/code/systems/hub.js +970 -169
  156. package/kits/hub-game/docs/analytics.md +279 -0
  157. package/kits/hub-game/docs/contract.md +1257 -42
  158. package/kits/hub-game/docs/home-pieces.md +9 -2
  159. package/kits/hub-game/docs/observed-progress.md +252 -0
  160. package/kits/hub-game/main.jsx +2 -0
  161. package/kits/hub-game/package-lock.json +10 -3
  162. package/kits/hub-game/package.json +6 -3
  163. package/kits/hub-game/play/player.js +142 -0
  164. package/kits/hub-game/play/registry.js +47 -0
  165. package/kits/hub-game/play.jsx +37 -0
  166. package/kits/hub-game/scripts/check.mjs +39 -5
  167. package/kits/hub-game/scripts/companion-follower-wire.json +1 -1
  168. package/kits/hub-game/scripts/fixtures/decor-keyless-draw.json +11 -0
  169. package/kits/hub-game/scripts/fixtures/decor-keyless.json +5 -5
  170. package/kits/hub-game/scripts/fixtures/engine-models-stub.mjs +3 -0
  171. package/kits/hub-game/scripts/fixtures/fake-dom.mjs +19 -3
  172. package/kits/hub-game/scripts/fixtures/interest-legacy.json +3 -3
  173. package/kits/hub-game/scripts/fixtures/vis-shared-wire.json +1 -1
  174. package/kits/hub-game/scripts/pose-storage-fixture.mjs +46 -0
  175. package/kits/hub-game/scripts/test-act-client.mjs +186 -0
  176. package/kits/hub-game/scripts/test-act.mjs +171 -0
  177. package/kits/hub-game/scripts/test-action-layout.mjs +80 -0
  178. package/kits/hub-game/scripts/test-action-observers.mjs +46 -0
  179. package/kits/hub-game/scripts/test-actions-client.mjs +367 -2
  180. package/kits/hub-game/scripts/test-actors.mjs +20 -7
  181. package/kits/hub-game/scripts/test-analytics.mjs +76 -0
  182. package/kits/hub-game/scripts/test-anonymous-entry.mjs +28 -0
  183. package/kits/hub-game/scripts/test-arrival-pose-server.mjs +196 -0
  184. package/kits/hub-game/scripts/test-arrival-pose.mjs +24 -0
  185. package/kits/hub-game/scripts/test-ask-slot.mjs +85 -0
  186. package/kits/hub-game/scripts/test-avatar-wire.mjs +49 -10
  187. package/kits/hub-game/scripts/test-avatar.mjs +44 -0
  188. package/kits/hub-game/scripts/test-back-visibility.mjs +82 -0
  189. package/kits/hub-game/scripts/test-ballot.mjs +11 -4
  190. package/kits/hub-game/scripts/test-ban-join.mjs +121 -13
  191. package/kits/hub-game/scripts/test-build.mjs +20 -2
  192. package/kits/hub-game/scripts/test-chat.mjs +206 -5
  193. package/kits/hub-game/scripts/test-companion-chat.mjs +20 -2
  194. package/kits/hub-game/scripts/test-control-layout-dom.mjs +120 -0
  195. package/kits/hub-game/scripts/test-crowd-names.mjs +205 -0
  196. package/kits/hub-game/scripts/test-decor-client.mjs +45 -4
  197. package/kits/hub-game/scripts/test-decor.mjs +7 -0
  198. package/kits/hub-game/scripts/test-default-environment-root.mjs +95 -0
  199. package/kits/hub-game/scripts/test-default-environment.mjs +267 -0
  200. package/kits/hub-game/scripts/test-door-analytics.mjs +58 -0
  201. package/kits/hub-game/scripts/test-door-jump.mjs +100 -0
  202. package/kits/hub-game/scripts/test-earned.mjs +33 -3
  203. package/kits/hub-game/scripts/test-far-avatars.mjs +340 -0
  204. package/kits/hub-game/scripts/test-fps-telemetry.mjs +112 -0
  205. package/kits/hub-game/scripts/test-frame-batch.mjs +252 -0
  206. package/kits/hub-game/scripts/test-fresh-friends.mjs +118 -0
  207. package/kits/hub-game/scripts/test-grab-orbit.mjs +47 -4
  208. package/kits/hub-game/scripts/test-high-only.mjs +170 -0
  209. package/kits/hub-game/scripts/test-hub-ops.mjs +321 -2
  210. package/kits/hub-game/scripts/test-hub-trip.mjs +879 -11
  211. package/kits/hub-game/scripts/test-hud-clear.mjs +162 -59
  212. package/kits/hub-game/scripts/test-hud-defects-dom.mjs +100 -0
  213. package/kits/hub-game/scripts/test-hud-rate.mjs +224 -0
  214. package/kits/hub-game/scripts/test-hud-safe-visibility-dom.mjs +83 -0
  215. package/kits/hub-game/scripts/test-idle.mjs +66 -0
  216. package/kits/hub-game/scripts/test-interest-cells.mjs +20 -0
  217. package/kits/hub-game/scripts/test-interest.mjs +15 -0
  218. package/kits/hub-game/scripts/test-invites-client.mjs +430 -0
  219. package/kits/hub-game/scripts/test-invites.mjs +109 -0
  220. package/kits/hub-game/scripts/test-labels.mjs +71 -3
  221. package/kits/hub-game/scripts/test-landscape-layout.mjs +194 -0
  222. package/kits/hub-game/scripts/test-list-scroll-dom.mjs +49 -0
  223. package/kits/hub-game/scripts/test-load-abandon.mjs +246 -0
  224. package/kits/hub-game/scripts/test-loading-cover.mjs +162 -0
  225. package/kits/hub-game/scripts/test-manifest.mjs +265 -0
  226. package/kits/hub-game/scripts/test-menu-client.mjs +105 -0
  227. package/kits/hub-game/scripts/test-menu.mjs +23 -0
  228. package/kits/hub-game/scripts/test-npcs.mjs +819 -10
  229. package/kits/hub-game/scripts/test-observed.mjs +745 -0
  230. package/kits/hub-game/scripts/test-pad-cues.mjs +304 -0
  231. package/kits/hub-game/scripts/test-pad-occupancy.mjs +177 -0
  232. package/kits/hub-game/scripts/test-picker.mjs +234 -7
  233. package/kits/hub-game/scripts/test-placement-cache.mjs +690 -0
  234. package/kits/hub-game/scripts/test-progress-reset.mjs +559 -0
  235. package/kits/hub-game/scripts/test-push-visit.mjs +26 -0
  236. package/kits/hub-game/scripts/test-quality.mjs +385 -0
  237. package/kits/hub-game/scripts/test-rehello.mjs +699 -5
  238. package/kits/hub-game/scripts/test-resume-action-order.mjs +598 -0
  239. package/kits/hub-game/scripts/test-resume-held.mjs +239 -0
  240. package/kits/hub-game/scripts/test-resume-pose.mjs +142 -0
  241. package/kits/hub-game/scripts/test-safe-events-dom.mjs +116 -0
  242. package/kits/hub-game/scripts/test-safe-layout.mjs +330 -0
  243. package/kits/hub-game/scripts/test-say.mjs +1 -1
  244. package/kits/hub-game/scripts/test-shot.mjs +145 -0
  245. package/kits/hub-game/scripts/test-signin-client.mjs +45 -0
  246. package/kits/hub-game/scripts/test-soundscape.mjs +22 -17
  247. package/kits/hub-game/scripts/test-standing.mjs +35 -2
  248. package/kits/hub-game/scripts/test-storage-limit.mjs +333 -0
  249. package/kits/hub-game/scripts/test-stuck.mjs +5 -4
  250. package/kits/hub-game/scripts/test-talk-overlay-dom.mjs +130 -0
  251. package/kits/hub-game/scripts/test-tiers-render.mjs +86 -13
  252. package/kits/hub-game/scripts/test-tiers.mjs +7 -8
  253. package/kits/hub-game/scripts/test-vis.mjs +433 -6
  254. package/kits/hub-game/scripts/test-weakest-tier.mjs +924 -0
  255. package/kits/hub-game/scripts/test-world-labels.mjs +367 -0
  256. package/kits/hub-game/scripts/test-yours-chrome.mjs +50 -6
  257. package/kits/hub-game/scripts/test-yours.mjs +39 -8
  258. package/kits/multiplayer-3d/castle.json +5 -5
  259. package/kits/multiplayer-3d/code/client/joinFailure.js +27 -0
  260. package/kits/multiplayer-3d/code/client/resumeGate.js +139 -0
  261. package/kits/multiplayer-3d/code/systems/multiplayer.js +369 -30
  262. package/kits/multiplayer-3d/package-lock.json +8 -1
  263. package/kits/multiplayer-3d/package.json +2 -1
  264. package/kits/multiplayer-3d/scripts/test-join-watchdog.mjs +436 -0
  265. package/kits/multiplayer-3d/scripts/test-resume-gate.mjs +624 -0
  266. package/kits/physics-2d/CLAUDE.md +10 -1
  267. package/kits/physics-2d/castle.json +2 -2
  268. package/kits/physics-2d/engine/frozenActors.js +233 -0
  269. package/kits/physics-2d/engine/scene.js +87 -5
  270. package/kits/physics-2d/eslint.config.js +1 -1
  271. package/kits/physics-2d/play/behaviors/AnalogStick.js +198 -0
  272. package/kits/physics-2d/play/behaviors/Camera.js +40 -0
  273. package/kits/physics-2d/play/behaviors/Collider.js +122 -0
  274. package/kits/physics-2d/play/behaviors/Draggable.js +115 -0
  275. package/kits/physics-2d/play/behaviors/Goal.js +46 -0
  276. package/kits/physics-2d/play/behaviors/Joints.js +126 -0
  277. package/kits/physics-2d/play/behaviors/Layout.js +71 -0
  278. package/kits/physics-2d/play/behaviors/RigidBody.js +57 -0
  279. package/kits/physics-2d/play/behaviors/Slingshot.js +142 -0
  280. package/kits/physics-2d/play/behaviors/SoundPlayer.js +263 -0
  281. package/kits/physics-2d/play/behaviors/Sprite.js +406 -0
  282. package/kits/physics-2d/play/behaviors/Style.js +209 -0
  283. package/kits/physics-2d/play/behaviors/Text.js +85 -0
  284. package/kits/physics-2d/play/behaviors/Video.js +93 -0
  285. package/kits/physics-3d/CLAUDE.md +25 -1651
  286. package/kits/physics-3d/behaviors/Body.jsx +3 -0
  287. package/kits/physics-3d/behaviors/Model.jsx +3 -0
  288. package/kits/physics-3d/behaviors/Player.jsx +35 -18
  289. package/kits/physics-3d/behaviors/Shape.jsx +3 -0
  290. package/kits/physics-3d/behaviors/Solid.jsx +3 -0
  291. package/kits/physics-3d/behaviors/Transform.jsx +3 -0
  292. package/kits/physics-3d/castle.json +3 -3
  293. package/kits/physics-3d/docs/engine-camera.md +542 -0
  294. package/kits/physics-3d/docs/engine-frame-cap.md +136 -0
  295. package/kits/physics-3d/docs/engine-load.md +149 -0
  296. package/kits/physics-3d/docs/engine-look.md +114 -0
  297. package/kits/physics-3d/docs/engine-shadows.md +372 -0
  298. package/kits/physics-3d/docs/engine-skip-work.md +187 -0
  299. package/kits/physics-3d/docs/engine-sky.md +198 -0
  300. package/kits/physics-3d/docs/engine-static-actors.md +226 -0
  301. package/kits/physics-3d/docs/engine-view.md +37 -0
  302. package/kits/physics-3d/docs/pxmodel-format.md +1 -1
  303. package/kits/physics-3d/engine3d/PlayOnly3D.jsx +5 -1
  304. package/kits/physics-3d/engine3d/Scene3DPlayer.jsx +19 -333
  305. package/kits/physics-3d/engine3d/actornode.js +1 -0
  306. package/kits/physics-3d/engine3d/branches.js +3 -13
  307. package/kits/physics-3d/engine3d/cage.js +2 -7
  308. package/kits/physics-3d/engine3d/cageops.js +2 -17
  309. package/kits/physics-3d/engine3d/dataBehaviors.js +12 -0
  310. package/kits/physics-3d/engine3d/framecap.js +4 -1
  311. package/kits/physics-3d/engine3d/frozenphysics.js +140 -0
  312. package/kits/physics-3d/engine3d/frozenstatics.js +273 -0
  313. package/kits/physics-3d/engine3d/gait.js +8 -0
  314. package/kits/physics-3d/engine3d/initialModelFiles.js +18 -0
  315. package/kits/physics-3d/engine3d/look.js +7 -0
  316. package/kits/physics-3d/engine3d/modelFiles.js +3 -17
  317. package/kits/physics-3d/engine3d/modelMath.js +49 -0
  318. package/kits/physics-3d/engine3d/modelready.js +16 -0
  319. package/kits/physics-3d/engine3d/motion.js +3 -3
  320. package/kits/physics-3d/engine3d/nearshadows.js +77 -10
  321. package/kits/physics-3d/engine3d/orbitinput.js +59 -25
  322. package/kits/physics-3d/engine3d/partgeometry.js +1 -16
  323. package/kits/physics-3d/engine3d/paths.js +1 -9
  324. package/kits/physics-3d/engine3d/playTimings.js +50 -0
  325. package/kits/physics-3d/engine3d/playerRun.js +372 -0
  326. package/kits/physics-3d/engine3d/pxmodel.js +3 -3
  327. package/kits/physics-3d/engine3d/rapier.js +27 -0
  328. package/kits/physics-3d/engine3d/scatter.js +1 -11
  329. package/kits/physics-3d/engine3d/shadowfade.js +23 -15
  330. package/kits/physics-3d/engine3d/sky.js +1 -1
  331. package/kits/physics-3d/engine3d/squarefirst.js +177 -0
  332. package/kits/physics-3d/engine3d/stillshadows.js +399 -0
  333. package/kits/physics-3d/engine3d/sweep.js +1 -25
  334. package/kits/physics-3d/engine3d/world3d.js +468 -18
  335. package/kits/physics-3d/eslint.config.js +2 -1
  336. package/kits/physics-3d/main.jsx +6 -3
  337. package/kits/physics-3d/package-lock.json +7 -0
  338. package/kits/physics-3d/package.json +5 -1
  339. package/kits/physics-3d/play/behaviors/Body.js +31 -0
  340. package/kits/physics-3d/play/behaviors/Door.js +37 -0
  341. package/kits/physics-3d/play/behaviors/Lookable.js +16 -0
  342. package/kits/physics-3d/play/behaviors/Model.js +23 -0
  343. package/kits/physics-3d/play/behaviors/Pickup.js +46 -0
  344. package/kits/physics-3d/play/behaviors/Player.js +1204 -0
  345. package/kits/physics-3d/play/behaviors/Shape.js +47 -0
  346. package/kits/physics-3d/play/behaviors/Solid.js +16 -0
  347. package/kits/physics-3d/play/behaviors/Transform.js +29 -0
  348. package/kits/physics-3d/pnpm-lock.yaml +8 -0
  349. package/kits/physics-3d/scripts/bench-shadow-fade.mjs +37 -0
  350. package/kits/physics-3d/scripts/build-rapier-gz.mjs +56 -0
  351. package/kits/physics-3d/scripts/frozen-statics-fixture.mjs +141 -0
  352. package/kits/physics-3d/scripts/test-camera-follow.mjs +5 -1
  353. package/kits/physics-3d/scripts/test-camera-orbit.mjs +52 -4
  354. package/kits/physics-3d/scripts/test-drop-empty-parts.mjs +1 -1
  355. package/kits/physics-3d/scripts/test-empty-gait-hints.mjs +89 -0
  356. package/kits/physics-3d/scripts/test-frame-cap-bob.mjs +6 -3
  357. package/kits/physics-3d/scripts/test-frame-cap.mjs +1 -1
  358. package/kits/physics-3d/scripts/test-frozen-nested.mjs +49 -0
  359. package/kits/physics-3d/scripts/test-frozen-statics-legacy-physics2d.mjs +123 -0
  360. package/kits/physics-3d/scripts/test-frozen-statics.mjs +434 -0
  361. package/kits/physics-3d/scripts/test-look-bake.mjs +1 -1
  362. package/kits/physics-3d/scripts/test-near-shadows.mjs +2 -2
  363. package/kits/physics-3d/scripts/test-orbit-shadow-fade.mjs +88 -7
  364. package/kits/physics-3d/scripts/test-orbit-shift-lock.mjs +40 -3
  365. package/kits/physics-3d/scripts/test-orbit-shot.mjs +75 -1
  366. package/kits/physics-3d/scripts/test-rapier-gz.mjs +106 -0
  367. package/kits/physics-3d/scripts/test-sky.mjs +1 -1
  368. package/kits/physics-3d/scripts/test-square-first.mjs +921 -0
  369. package/kits/physics-3d/scripts/test-static-actors.mjs +3 -1
  370. package/kits/physics-3d/scripts/test-static-physics.mjs +4 -1
  371. package/kits/physics-3d/scripts/test-static-scenery.mjs +5 -2
  372. package/kits/physics-3d/scripts/test-steady-hover.mjs +5 -2
  373. package/kits/physics-3d/scripts/test-still-shadows.mjs +477 -0
  374. package/kits/physics-3d/systems/physics3d.js +37 -4
  375. package/kits/real-time/castle.json +2 -2
  376. package/kits/real-time/code/client/connection.js +33 -10
  377. package/kits/real-time/code/client/gameHooks.js +2 -0
  378. package/kits/real-time/code/client/joinOverlay.js +9 -4
  379. package/kits/real-time/code/server/session.js +6 -4
  380. package/kits/real-time/package-lock.json +1 -1
  381. package/package.json +2 -2
@@ -0,0 +1,267 @@
1
+ import assert from 'node:assert/strict';
2
+ import { Color, Fog } from 'three';
3
+ import {
4
+ DEFAULT_FOG_FAR,
5
+ DEFAULT_FOG_NEAR,
6
+ DEFAULT_SKY_COLOR,
7
+ hasAuthoredEnvironment,
8
+ makeDefaultEnvironment,
9
+ } from '../code/client/defaultEnvironment.js';
10
+ import { activeFallY, holdFallenPlayer } from '../code/client/fall.js';
11
+
12
+ function normalizedStyle(initial = {}) {
13
+ const values = { opacity: initial.opacity ?? '', background: initial.background ?? '' };
14
+ return {
15
+ get opacity() { return values.opacity; },
16
+ set opacity(value) { values.opacity = String(Number(value)); },
17
+ get background() { return values.background; },
18
+ set background(value) {
19
+ const match = /^#([\da-f]{2})([\da-f]{2})([\da-f]{2})$/i.exec(value);
20
+ values.background = match
21
+ ? `rgb(${parseInt(match[1], 16)}, ${parseInt(match[2], 16)}, ${parseInt(match[3], 16)})`
22
+ : value;
23
+ },
24
+ };
25
+ }
26
+
27
+ function fixture(data = {}) {
28
+ let clear = new Color('#010203');
29
+ let alpha = 0.75;
30
+ const parent = { style: normalizedStyle({ background: 'rgb(1, 2, 3)' }) };
31
+ const canvas = { style: normalizedStyle({ opacity: '0.8' }), parentElement: parent };
32
+ const renderer = {
33
+ domElement: canvas,
34
+ getClearColor(target) { return target.copy(clear); },
35
+ getClearAlpha() { return alpha; },
36
+ setClearColor(color, nextAlpha = 1) {
37
+ clear = new Color(color);
38
+ alpha = nextAlpha;
39
+ },
40
+ };
41
+ const world = { scene: { fog: null, background: null }, renderer };
42
+ const local = { components: { Transform: { y: 1 } } };
43
+ const scene = { data, three: world, skyZone: null };
44
+ return { scene, world, renderer, canvas, parent, local, clear: () => clear.clone(), alpha: () => alpha };
45
+ }
46
+
47
+ assert.equal(hasAuthoredEnvironment({}), false);
48
+ for (const data of [
49
+ { background: '#123456' },
50
+ { engine: { sky: null } },
51
+ { engine: { view: null } },
52
+ ]) assert.equal(hasAuthoredEnvironment(data), true);
53
+
54
+ // The client's guard and fade use the same fall threshold. A place hold may
55
+ // legitimately be below the default implicit-ground threshold, and travel may
56
+ // retain the prior place for a frame; neither is a fall until released.
57
+ {
58
+ assert.equal(activeFallY(-20, false, false), -20);
59
+ assert.equal(activeFallY(-20, true, false), null);
60
+ assert.equal(activeFallY(-20, false, true), null);
61
+
62
+ const calls = [];
63
+ const local = { components: { Transform: { x: 4, y: -24, z: 5 } } };
64
+ const scene = { physics3d: {
65
+ bodyOf: () => ({ setTranslation: (at) => calls.push(['at', at]) }),
66
+ setVelocity: (_actor, velocity) => calls.push(['velocity', velocity]),
67
+ } };
68
+ holdFallenPlayer(scene, local, activeFallY(-20, true, false));
69
+ assert.equal(local.components.Transform.y, -24, 'a held low pose is left alone');
70
+ assert.deepEqual(calls, []);
71
+ holdFallenPlayer(scene, local, activeFallY(-20, false, false));
72
+ assert.equal(local.components.Transform.y, -21, 'an unheld fall waits just below the catch line');
73
+ assert.deepEqual(calls, [
74
+ ['at', { x: 4, y: -21, z: 5 }],
75
+ ['velocity', { x: 0, y: 0, z: 0 }],
76
+ ]);
77
+ }
78
+
79
+ // A keyless scene gets one cheap fog and a non-black clear on a world with no
80
+ // composer, hook or scene nodes -- the same minimum render path Weakest uses.
81
+ {
82
+ const h = fixture();
83
+ Object.defineProperty(h.scene, 'sky', { value: null, configurable: true });
84
+ const environment = makeDefaultEnvironment();
85
+ environment.frame(h.scene, h.local, -20, 1 / 60);
86
+ assert.equal(h.clear().getHexString(), DEFAULT_SKY_COLOR.slice(1));
87
+ assert.equal(h.alpha(), 0.75);
88
+ assert.ok(h.world.scene.fog instanceof Fog);
89
+ assert.equal(h.world.scene.fog.near, DEFAULT_FOG_NEAR);
90
+ assert.equal(h.world.scene.fog.far, DEFAULT_FOG_FAR);
91
+ assert.equal(h.canvas.style.opacity, '0.8');
92
+
93
+ h.local.components.Transform.y = -24;
94
+ environment.frame(h.scene, h.local, activeFallY(-20, true, false), 1 / 60);
95
+ assert.equal(h.canvas.style.opacity, '0.8', 'a held low pose does not fade');
96
+ environment.frame(h.scene, h.local, activeFallY(-20, false, true), 1 / 60);
97
+ assert.equal(h.canvas.style.opacity, '0.8', 'travel does not use the prior place threshold');
98
+
99
+ h.local.components.Transform.y = -21;
100
+ environment.frame(h.scene, h.local, activeFallY(-20, false, false), 1 / 60);
101
+ assert.equal(h.canvas.style.opacity, '0');
102
+ assert.equal(h.parent.style.background, 'rgb(191, 227, 242)', 'the CSSOM-normalized colour is retained');
103
+ h.local.components.Transform.y = 1;
104
+ environment.frame(h.scene, h.local, -20, 0.225);
105
+ assert.equal(h.canvas.style.opacity, '0.5');
106
+ environment.frame(h.scene, h.local, -20, 0.225);
107
+ assert.equal(h.canvas.style.opacity, '0.8');
108
+ assert.equal(h.parent.style.background, 'rgb(1, 2, 3)', 'return restores the exact prior CSSOM value');
109
+
110
+ environment.restore();
111
+ assert.equal(h.world.scene.fog, null);
112
+ assert.equal(h.clear().getHexString(), '010203');
113
+ assert.equal(h.alpha(), 0.75);
114
+ }
115
+
116
+ // Standing above any authored threshold is fully visible. Once below it, the
117
+ // last metre fades to the same full cover where the client waits for the
118
+ // server catch.
119
+ {
120
+ for (const [fallY, y] of [[-5, 0.75], [3, 3.1]]) {
121
+ const h = fixture();
122
+ h.local.components.Transform.y = y;
123
+ const environment = makeDefaultEnvironment();
124
+ environment.frame(h.scene, h.local, fallY, 1 / 60);
125
+ assert.equal(h.canvas.style.opacity, '0.8', `standing at ${y} above fallY ${fallY}`);
126
+ environment.restore();
127
+ }
128
+
129
+ const h = fixture();
130
+ const environment = makeDefaultEnvironment();
131
+ h.local.components.Transform.y = 2.5;
132
+ environment.frame(h.scene, h.local, 3, 1 / 60);
133
+ assert.equal(h.canvas.style.opacity, '0.5', 'half a metre below the threshold is half faded');
134
+ h.local.components.Transform.y = 2;
135
+ environment.frame(h.scene, h.local, 3, 1 / 60);
136
+ assert.equal(h.canvas.style.opacity, '0', 'the clamp point is fully faded');
137
+ environment.restore();
138
+ }
139
+
140
+ // Authored keys are untouched in steady state even when a tier shadows the
141
+ // runtime sky getter with an own null. A real fall still fades to that sky's
142
+ // current authored colour, then returns without retaining a style write.
143
+ {
144
+ const data = { engine: { sky: { zones: [
145
+ { id: 'day', color: '#224466' },
146
+ { id: 'dusk', color: '#6688aa' },
147
+ ] } } };
148
+ const h = fixture(data);
149
+ h.scene.skyZone = { id: 'dusk', from: 'day', to: 'dusk', blend: 1 };
150
+ Object.defineProperty(h.scene, 'sky', { value: null, configurable: true });
151
+ const environment = makeDefaultEnvironment();
152
+ environment.frame(h.scene, h.local, -20, 1 / 60);
153
+ assert.equal(h.clear().getHexString(), '010203');
154
+ assert.equal(h.world.scene.fog, null);
155
+ assert.equal(h.canvas.style.opacity, '0.8');
156
+ h.local.components.Transform.y = -21;
157
+ environment.frame(h.scene, h.local, -20, 1 / 60);
158
+ assert.equal(h.canvas.style.opacity, '0');
159
+ assert.equal(h.parent.style.background, 'rgb(102, 136, 170)');
160
+ environment.restore();
161
+ assert.equal(h.canvas.style.opacity, '0.8');
162
+ assert.equal(h.parent.style.background, 'rgb(1, 2, 3)');
163
+ }
164
+
165
+ // A background-only authored scene fades to its own colour too.
166
+ {
167
+ const h = fixture({ background: '#123456' });
168
+ const environment = makeDefaultEnvironment();
169
+ h.local.components.Transform.y = -21;
170
+ environment.frame(h.scene, h.local, -20, 1 / 60);
171
+ assert.equal(h.parent.style.background, 'rgb(18, 52, 86)');
172
+ environment.restore();
173
+ }
174
+
175
+ // The root opt-out owns the whole controller: no fallback picture and no
176
+ // canvas fade, even below the catch line in an authored scene.
177
+ {
178
+ const keyless = fixture();
179
+ keyless.local.components.Transform.y = -21;
180
+ const environment = makeDefaultEnvironment();
181
+ environment.frame(keyless.scene, keyless.local, -20, 1 / 60, false);
182
+ assert.equal(keyless.clear().getHexString(), '010203');
183
+ assert.equal(keyless.world.scene.fog, null);
184
+ assert.equal(keyless.canvas.style.opacity, '0.8');
185
+ assert.equal(keyless.parent.style.background, 'rgb(1, 2, 3)');
186
+
187
+ const authored = fixture({ engine: { sky: { zones: [{ id: 'night', color: '#101827' }] } } });
188
+ const authoredFog = new Fog('#334455', 3, 9);
189
+ authored.world.scene.fog = authoredFog;
190
+ authored.world.scene.background = new Color('#223344');
191
+ authored.local.components.Transform.y = -21;
192
+ environment.frame(authored.scene, authored.local, -20, 1 / 60, false);
193
+ assert.equal(authored.world.scene.fog, authoredFog);
194
+ assert.equal(authored.world.scene.background.getHexString(), '223344');
195
+ assert.equal(authored.clear().getHexString(), '010203');
196
+ assert.equal(authored.canvas.style.opacity, '0.8');
197
+ }
198
+
199
+ // Missing and true are the same enabled behavior. Turning an enabled
200
+ // controller off restores every value it owned immediately.
201
+ for (const explicit of [undefined, true]) {
202
+ const h = fixture();
203
+ h.local.components.Transform.y = -21;
204
+ const environment = makeDefaultEnvironment();
205
+ environment.frame(h.scene, h.local, -20, 1 / 60, explicit);
206
+ assert.equal(h.clear().getHexString(), DEFAULT_SKY_COLOR.slice(1));
207
+ assert.ok(h.world.scene.fog instanceof Fog);
208
+ assert.equal(h.canvas.style.opacity, '0');
209
+ environment.frame(h.scene, h.local, -20, 1 / 60, false);
210
+ assert.equal(h.clear().getHexString(), '010203');
211
+ assert.equal(h.world.scene.fog, null);
212
+ assert.equal(h.canvas.style.opacity, '0.8');
213
+ assert.equal(h.parent.style.background, 'rgb(1, 2, 3)');
214
+ }
215
+
216
+ // One root decision remains off as the controller sees replacement worlds,
217
+ // including an authored scene supplied by mounted content.
218
+ {
219
+ const first = fixture();
220
+ const packed = fixture({ background: '#123456' });
221
+ first.local.components.Transform.y = -21;
222
+ packed.local.components.Transform.y = -21;
223
+ const environment = makeDefaultEnvironment();
224
+ environment.frame(first.scene, first.local, -20, 1 / 60, false);
225
+ environment.frame(packed.scene, packed.local, -20, 1 / 60, false);
226
+ assert.equal(first.clear().getHexString(), '010203');
227
+ assert.equal(first.world.scene.fog, null);
228
+ assert.equal(first.canvas.style.opacity, '0.8');
229
+ assert.equal(packed.clear().getHexString(), '010203');
230
+ assert.equal(packed.world.scene.fog, null);
231
+ assert.equal(packed.canvas.style.opacity, '0.8');
232
+ }
233
+
234
+ // Scene travel gives every owned value back before deciding the next scene,
235
+ // including a load frame whose replacement world is not built yet.
236
+ {
237
+ const first = fixture();
238
+ const authoredFog = new Fog('#334455', 3, 9);
239
+ const next = fixture({ engine: { view: { far: 80 } } });
240
+ next.world.scene.fog = authoredFog;
241
+ const environment = makeDefaultEnvironment();
242
+ environment.frame(first.scene, first.local, -20, 1 / 60);
243
+ environment.frame(next.scene, next.local, -20, 1 / 60);
244
+ assert.equal(first.world.scene.fog, null);
245
+ assert.equal(first.clear().getHexString(), '010203');
246
+ assert.equal(next.world.scene.fog, authoredFog);
247
+ const loading = { data: {}, three: null };
248
+ environment.frame(loading, null, -20, 1 / 60);
249
+ assert.equal(next.world.scene.fog, authoredFog);
250
+ }
251
+
252
+ // A later owner wins: cleanup does not put an older fog or clear colour over
253
+ // values installed after the fallback.
254
+ {
255
+ const h = fixture();
256
+ const environment = makeDefaultEnvironment();
257
+ environment.frame(h.scene, h.local, -20, 1 / 60);
258
+ const laterFog = new Fog('#abcdef', 2, 4);
259
+ h.world.scene.fog = laterFog;
260
+ h.renderer.setClearColor('#fedcba', 1);
261
+ environment.restore();
262
+ assert.equal(h.world.scene.fog, laterFog);
263
+ assert.equal(h.clear().getHexString(), 'fedcba');
264
+ assert.equal(h.alpha(), 1);
265
+ }
266
+
267
+ console.log('test-default-environment: fallback, authored scenes, Weakest, fall return and cleanup passed');
@@ -0,0 +1,58 @@
1
+ import assert from 'node:assert/strict';
2
+ import * as D from '../code/server/doorAnalytics.js';
3
+ import { readManifest, publicPlace } from '../code/server/manifest.js';
4
+ import { makeDoorErrors } from '../code/client/doorErrors.js';
5
+ const calls = [], entry = { arrived: true };
6
+ const h = { place: { result: {} }, sim: { timeMs: 1000 }, players: new Map([['p', entry]]),
7
+ session: { hub: { track: (id, e) => { calls.push([id, e]); return Promise.resolve(true); } } } };
8
+ D.arrive(h, [{ playerId: 'p' }]);
9
+ D.arrive(h, [{ playerId: 'p' }]);
10
+ assert.equal(calls.length, 1);
11
+ assert.deepEqual(calls[0][1], { kind: D.EVENTS.round_start, value: 1, result: 0 });
12
+ h.sim.timeMs = 4500;
13
+ D.finish(h, 'p'); D.finish(h, 'p', 3);
14
+ assert.deepEqual(calls.at(-1)[1], { kind: D.EVENTS.round_end, value: 4, result: 1 });
15
+ assert.equal(calls.length, 2, 'one end even when result/end/leave all run');
16
+ D.track(h, 'p', 'round_start', { value: 2 });
17
+ D.message(h, 'p', { k: 'hub-door-quit' }); D.finish(h, 'p', 3);
18
+ assert.equal(calls.at(-1)[1].result, 2);
19
+ D.arrive(h, [{ playerId: 'p' }]); D.finish(h, 'p', 3);
20
+ assert.equal(calls.at(-1)[1].result, 3);
21
+ for (const props of [{ value: 1, result: 3 }, { value: 'private', result: 1 }, { value: 1, result: 1, subject: 103 }]) {
22
+ assert.equal(D.track(h, 'p', 'door_progress', props), false);
23
+ }
24
+ assert.equal(D.track(h, 'p', 'door_progress', { value: 2, result: 1 }), true);
25
+ assert.equal(D.message(h, 'p', { k: 'hub-door-error', result: 2, text: 'secret' }), false);
26
+ assert.equal(D.message(h, 'p', { k: 'hub-door-error', result: 2 }), true);
27
+ assert.equal(D.message(h, 'p', { k: 'hub-door-error', result: 2 }), false, 'server rate limit');
28
+ assert.equal(D.track(h, 'other', 'door_error', { value: 1, result: 2 }), false);
29
+ const handlers = new Map(), sent = [];
30
+ const win = { addEventListener: (k, fn) => handlers.set(k, fn), removeEventListener: k => handlers.delete(k) };
31
+ const doc = { visibilityState: 'visible' }, net = { send: e => sent.push(e) };
32
+ const c = makeDoorErrors(win, doc);
33
+ c.sync(net, false, 0); assert.equal(handlers.size, 0);
34
+ c.sync(net, true, 1); handlers.get('error')({ message: 'private' });
35
+ assert.deepEqual(sent, [{ k: 'hub-door-error', result: 2 }]);
36
+ c.sync(net, true, 4000); assert.equal(sent.length, 1, 'client rate limit');
37
+ c.sync(net, false, 5000); assert.equal(handlers.size, 0);
38
+ c.dispose();
39
+ const stalls = [], s = makeDoorErrors(win, doc);
40
+ s.sync({ send: e => stalls.push(e) }, true, 0);
41
+ // Keep the same connection while testing a visible stall.
42
+ const n = { send: e => stalls.push(e) };
43
+ s.sync(n, true, 0); s.sync(n, true, 2100);
44
+ assert.deepEqual(stalls, [{ k: 'hub-door-error', result: 1 }]);
45
+ s.dispose(); assert.equal(handlers.size, 0);
46
+ console.log('door analytics lifecycle, privacy, errors and budgets: passed');
47
+
48
+ const manifest = hub => readManifest({ hub: { contract: 1, title: 'Door', ...hub } });
49
+ const authored = manifest({ analyticsRounds: 'authored' });
50
+ assert.equal(authored.errors.length, 0);
51
+ assert.equal(authored.manifest.places.main.analyticsRounds, 'authored');
52
+ assert.deepEqual(publicPlace('main', authored.manifest.places.main), publicPlace('main', manifest({}).manifest.places.main));
53
+ assert(manifest({ analyticsRounds: true }).errors.length);
54
+ const prior = calls.length;
55
+ h.place.analyticsRounds = 'authored';
56
+ D.arrive(h, [{ playerId: 'p' }]); assert.equal(calls.length, prior);
57
+ D.track(h, 'p', 'round_start', { value: 1 });
58
+ D.finish(h, 'p'); assert.equal(calls.length, prior + 2);
@@ -60,6 +60,18 @@ const jump = (b, playerId, door) => b.h.message(b.session, { playerId }, { k: 'h
60
60
 
61
61
  let n = 0;
62
62
 
63
+ // An authored list label changes only the list, not the destination.
64
+ {
65
+ const props = globalThis.__hubTestActors[2].components.HubDoor;
66
+ props.listTitle = ' Your house · north entrance ';
67
+ const b = boot();
68
+ assert.equal(b.h.join().hubDoors[1].title, 'Your house · north entrance');
69
+ assert.equal(props.title, 'Gem Rush');
70
+ delete props.listTitle;
71
+ assert.equal(b.h.join().hubDoors[1].title, 'Gem Rush');
72
+ n += 1;
73
+ }
74
+
63
75
  // The town lists its doors.
64
76
  {
65
77
  const b = boot();
@@ -119,6 +131,94 @@ let n = 0;
119
131
  n += 1;
120
132
  }
121
133
 
134
+ // A slow phone, a pad 3.4 m from where the player stands: the client eases a
135
+ // quarter of the way toward a clamp each frame it hears of one, and its move
136
+ // reports are taken while they are a legal step (the session's rule: 12 m/s
137
+ // of the time since the last report, plus 0.6 m). The player stays on the pad
138
+ // once the client has caught up, however many frames that took.
139
+ {
140
+ const actors = globalThis.__hubTestActors;
141
+ globalThis.__hubTestActors = [
142
+ actors[0],
143
+ { id: 'door-prism', components: { HubDoor: { id: 'prism', to: 'deck:prism', title: 'Prism Post' }, Transform: { x: 0, y: 0.07, z: -3.4, rotationY: 0 } } },
144
+ { id: 'pad-prism', components: { HubPad: { door: 'prism', radius: 2.3 }, Shape: { kind: 'cylinder', radius: 2.3, height: 0.1 }, Transform: { x: 0, y: 0.07, z: -3.4 } } },
145
+ ];
146
+ const realNow = Date.now;
147
+ let clock = 1_000_000;
148
+ Date.now = () => clock;
149
+ try {
150
+ // A body the client has not yet agreed with (`settled` false: new, or
151
+ // replaced on a reconnect) has its first far report refused outright.
152
+ for (const [frameMs, reports, settled] of [[300, true, true], [60, true, true], [300, true, false], [300, false, true]]) {
153
+ const b = boot();
154
+ const p1 = b.world.players.get('p1');
155
+ const report = (at) => {
156
+ const reach = 12 * Math.min(1, (b.world.timeMs - p1.movedAt) / 1000) + 0.6;
157
+ p1.movedAt = b.world.timeMs;
158
+ const step = Math.hypot(at.x - p1.at.x, at.z - p1.at.z);
159
+ if (step <= reach) {
160
+ p1.at = { x: at.x, y: p1.at.y, z: at.z };
161
+ p1.clamped = false;
162
+ p1.settled = true;
163
+ } else if (!p1.settled) {
164
+ p1.clamped = true;
165
+ } else {
166
+ const scale = reach / step;
167
+ p1.at = { x: p1.at.x + (at.x - p1.at.x) * scale, y: p1.at.y, z: p1.at.z + (at.z - p1.at.z) * scale };
168
+ p1.clamped = true;
169
+ }
170
+ };
171
+ // Arrived first: the arrival's own placement is not the jump's.
172
+ for (let i = 0; i < 20; i += 1) {
173
+ clock += 50;
174
+ b.world.timeMs += 50;
175
+ b.h.place(b.world, []);
176
+ }
177
+ const client = { x: p1.at.x, z: p1.at.z };
178
+ p1.movedAt = b.world.timeMs;
179
+ p1.settled = settled;
180
+ let heard = null;
181
+ // The ring's spot nearest where the player stands, 2.25 m off.
182
+ const random = Math.random;
183
+ Math.random = () => 0;
184
+ try { jump(b, 'p1', 'prism'); } finally { Math.random = random; }
185
+ const spot = { ...p1.at };
186
+ const onPad = () => Math.hypot(p1.at.x, p1.at.z + 3.4) <= 2.3;
187
+ assert.ok(onPad(), 'put on the pad');
188
+ // Seven seconds of 20 Hz ticks and the client's frames, its reports and
189
+ // the snapshots it hears a frame late.
190
+ for (let t = 0; t < 7000; t += 10) {
191
+ clock += 10;
192
+ b.world.timeMs += 10;
193
+ if (t % 50 === 0) {
194
+ b.h.place(b.world, []);
195
+ if (p1.clamped) { heard = { ...p1.at }; }
196
+ }
197
+ if (t % frameMs === 0) {
198
+ if (heard) {
199
+ const off = Math.hypot(heard.x - client.x, heard.z - client.z);
200
+ const k = off > 4 ? 1 : 0.25;
201
+ client.x += (heard.x - client.x) * k;
202
+ client.z += (heard.z - client.z) * k;
203
+ heard = null;
204
+ }
205
+ if (reports) { report({ x: client.x, y: 1, z: client.z }); }
206
+ }
207
+ }
208
+ if (reports) {
209
+ assert.ok(onPad(), `${frameMs} ms frames: still on the pad at (${p1.at.x.toFixed(2)}, ${p1.at.z.toFixed(2)})`);
210
+ assert.ok(Math.hypot(client.x - spot.x, client.z - spot.z) <= 0.25, `${frameMs} ms frames: the client caught up`);
211
+ } else {
212
+ assert.deepEqual(p1.at, spot, 'a silent client is left where it was put');
213
+ }
214
+ n += 1;
215
+ }
216
+ } finally {
217
+ Date.now = realNow;
218
+ globalThis.__hubTestActors = actors;
219
+ }
220
+ }
221
+
122
222
  // A game has no door list and no jumps.
123
223
  {
124
224
  const b = boot('dev:hub.race.abc123');
@@ -680,6 +680,36 @@ await test('delayed unlock receipts cannot undo a newer shown choice or clear',
680
680
  assert.deepEqual(r.hub().earned('p1'), ace);
681
681
  });
682
682
 
683
+ await test('delayed earned receipts never apply to a replacement account reusing the player id', async () => {
684
+ for (const operation of ['unlock', 'wearEarned']) {
685
+ let finish;
686
+ const pending = () => new Promise((resolve) => { finish = resolve; });
687
+ const r = room(here.layer, { ops: { [operation]: pending } });
688
+ r.enter('p1');
689
+ await r.tick();
690
+ r.delta();
691
+ const receipt = operation === 'unlock'
692
+ ? r.hub().unlock('p1', ace.id)
693
+ : r.hub().wearEarned('p1', { deckId: lamp.deckId, id: lamp.id });
694
+
695
+ r.session.players = r.session.players.map((player) => player.playerId === 'p1'
696
+ ? { ...player, userId: '999', username: 'replacement' }
697
+ : player);
698
+ r.rehello('p1');
699
+ await r.tick();
700
+ r.delta();
701
+ finish(operation === 'unlock'
702
+ ? { isNew: true, earned: ace }
703
+ : { earned: lamp });
704
+
705
+ const answer = await receipt;
706
+ assert.equal(answer.saved, true, 'Ghost may persist the original account operation');
707
+ assert.equal(r.hub().earned('p1'), null, 'the original account receipt is not shown on its replacement');
708
+ assert.equal(r.delta(), null);
709
+ assert.equal('hubEarned' in r.join(), false);
710
+ }
711
+ });
712
+
683
713
  await test('home grants before hello are pruned after departure without starting the earned wire', async () => {
684
714
  for (const config of [
685
715
  { platform: false, playerId: 'p1' },
@@ -1083,13 +1113,13 @@ await test('no pets: furniture and badge wire and host calls match the pre-pet t
1083
1113
  // Captured from the full pre-change kit code at 741d74c18^ in scratch.
1084
1114
  // This literal is always checked, including without HUB_EARNED_BASELINE.
1085
1115
  const expected = [
1086
- '[["join","p1",{"hubPlace":{"contract":1,"id":"main","title":"Cove","scene":"scenes/main.scene","controller":"walk","maxDurationSec":600,"result":{"score":null},"fallY":null},"hubAv":{},"hud":null,"hidden":[],"held":[],"labels":{},"tints":{},"marks":{},"hubDoors":[],"spawned":{},"spawnTemplates":{}}]',
1116
+ '[["join","p1",{"hubPlace":{"contract":1,"id":"main","title":"Cove","scene":"scenes/main.scene","controller":"walk","maxDurationSec":600,"result":{"score":null},"fallY":-20},"hubAv":{},"hud":null,"hidden":[],"held":[],"labels":{},"tints":{},"marks":{},"hubDoors":[],"spawned":{},"spawnTemplates":{}}]',
1087
1117
  ',["delta",{"hubAv":{},"hud":null,"hidden":[],"held":[],"labels":{},"tints":{},"marks":{},"hubDoors":[],"spawnTemplates":{},"spawned":{}}]',
1088
1118
  ',["host","readResults",{"userIds":["101"]}]',
1089
1119
  ',["host-answer","readResults",{"players":{"101":{"avatar":1,"recent":[],"records":[],"wearable":null}},"boards":{}}]',
1090
1120
  ',["send","p1",{"k":"hub-arrived","facing":0}]',
1091
1121
  ',["delta",{"hubAv":{"p1":1}}]',
1092
- ',["join","p2",{"hubPlace":{"contract":1,"id":"main","title":"Cove","scene":"scenes/main.scene","controller":"walk","maxDurationSec":600,"result":{"score":null},"fallY":null},"hubAv":{"p1":1},"hud":null,"hidden":[],"held":[],"labels":{},"tints":{},"marks":{},"hubDoors":[],"spawned":{},"spawnTemplates":{}}]',
1122
+ ',["join","p2",{"hubPlace":{"contract":1,"id":"main","title":"Cove","scene":"scenes/main.scene","controller":"walk","maxDurationSec":600,"result":{"score":null},"fallY":-20},"hubAv":{"p1":1},"hud":null,"hidden":[],"held":[],"labels":{},"tints":{},"marks":{},"hubDoors":[],"spawned":{},"spawnTemplates":{}}]',
1093
1123
  ',["host","readResults",{"userIds":["102"]}]',
1094
1124
  ',["host-answer","readResults",{"players":{"102":{"avatar":1,"recent":[],"records":[],"wearable":null}},"boards":{}}]',
1095
1125
  ',["send","p2",{"k":"hub-arrived","facing":0}]',
@@ -1106,7 +1136,7 @@ await test('no pets: furniture and badge wire and host calls match the pre-pet t
1106
1136
  ',["host","wearEarned","p1",{"deckId":"cove-deck","id":"cove-3-wins"}]',
1107
1137
  ',["host-answer","wearEarned",{"earned":{"id":"cove-3-wins","class":"badge","shape":"badge-round","name":"Cove Ace","deed":"win 3 races in Cove","color":"#3aa0d8","deckId":"cove-deck"}}]',
1108
1138
  ',["delta",null]',
1109
- ',["join","p1",{"hubPlace":{"contract":1,"id":"main","title":"Cove","scene":"scenes/main.scene","controller":"walk","maxDurationSec":600,"result":{"score":null},"fallY":null},"hubAv":{"p1":1,"p2":1},"hubEarned":{"p1":{"class":"badge","shape":"badge-round","color":"#3aa0d8","name":"Cove Ace"}},"hud":null,"hidden":[],"held":[],"labels":{},"tints":{},"marks":{},"hubDoors":[],"spawned":{},"spawnTemplates":{}}]',
1139
+ ',["join","p1",{"hubPlace":{"contract":1,"id":"main","title":"Cove","scene":"scenes/main.scene","controller":"walk","maxDurationSec":600,"result":{"score":null},"fallY":-20},"hubAv":{"p1":1,"p2":1},"hubEarned":{"p1":{"class":"badge","shape":"badge-round","color":"#3aa0d8","name":"Cove Ace"}},"hud":null,"hidden":[],"held":[],"labels":{},"tints":{},"marks":{},"hubDoors":[],"spawned":{},"spawnTemplates":{}}]',
1110
1140
  ',["host","wearEarned","p1",null]',
1111
1141
  ',["host-answer","wearEarned",{"earned":null}]',
1112
1142
  ',["delta",{"hubEarned":{}}]',