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
@@ -45,23 +45,45 @@ const actors = [
45
45
  Transform: { x: 2, y: 3, z: 4 }, Model: { file: 'models/trophy.pxmodel' },
46
46
  } })),
47
47
  ];
48
- function boot() {
48
+ function boot(keys = {}, more = {}) {
49
49
  const sent = [], enabled = [];
50
- const players = [{ playerId: 'p1' }, { playerId: 'p2' }];
51
- const session = { sessionId: 'test', players, send: (id, msg) => sent.push([id, msg]), broadcast: (msg) => sent.push(['all', msg]) };
50
+ const players = structuredClone(more.players ?? [
51
+ { playerId: 'p1', userId: '101', username: 'Ada', isAnonymous: false },
52
+ { playerId: 'p2', userId: '102', username: 'Bo', isAnonymous: false },
53
+ ]);
54
+ const session = { sessionId: more.sessionId ?? 'test', players, send: (id, msg) => sent.push([id, structuredClone(msg)]), broadcast: (msg) => sent.push(['all', structuredClone(msg)]) };
52
55
  const world = { timeMs: 0, scenePath: 'scenes/main.scene',
53
56
  players: new Map(players.map(({ playerId }) => [playerId, { at: { x: 0, y: 1, z: 0 }, facing: 0, body: { setTranslation() {} } }])),
54
57
  bodies: new Map([['trophy-0', { setEnabled: (value) => enabled.push(value) }]]) };
55
58
  let hub;
56
- globalThis.__hubTestActors = actors;
57
- const server = layer({ server: { maxPlayers: 8 }, hub: { contract: 1, title: 'Town' } }, { ready(ctx) { hub = ctx; } }, {}, () => true);
59
+ globalThis.__hubTestActors = more.actors ?? actors;
60
+ const server = layer({ server: { maxPlayers: 8 }, hub: { contract: 1, title: 'Town', ...keys } }, {
61
+ ready(ctx) { hub = ctx; },
62
+ resume: more.resume,
63
+ leave: more.leave,
64
+ }, {}, () => true);
58
65
  server.sceneFor(session);
59
66
  server.ready(world);
60
- const step = () => { server.place(world); server.step(world); };
67
+ const step = (ms = 0) => { world.timeMs += ms; server.place(world); server.step(world); };
61
68
  const hello = (id, extra = {}) => server.message(session, { playerId: id }, { k: 'hub-hello', avatar: 0, ...extra });
62
69
  return { sent, enabled, players, session, world, server, hub, step, hello };
63
70
  }
64
71
  const visibility = (r) => r.sent.filter(([, msg]) => msg.k === 'hub-vis');
72
+ const playerBody = () => ({ at: { x: 0, y: 1, z: 0 }, facing: 0, body: { setTranslation() {} } });
73
+ const arrive = (r) => {
74
+ r.hello('p1');
75
+ r.hello('p2');
76
+ r.step(2000);
77
+ r.step();
78
+ };
79
+ const drop = (r, id = 'p1') => {
80
+ r.session.players = r.session.players.filter((p) => p.playerId !== id);
81
+ r.world.players.delete(id);
82
+ };
83
+ const back = (r, player = { playerId: 'p1', userId: '101', username: 'Ada', isAnonymous: false }) => {
84
+ r.session.players.push(player);
85
+ r.world.players.set(player.playerId, playerBody());
86
+ };
65
87
  const warnings = [];
66
88
  const warn = console.warn, log = console.log;
67
89
  console.warn = (...args) => warnings.push(args.join(' '));
@@ -105,6 +127,25 @@ test('shared-only snapshots, deltas and messages are byte-identical to v1.61', (
105
127
  assert.deepEqual(r.enabled, [false, true]);
106
128
  });
107
129
 
130
+ test('resumeVisibility requires an authored resume hook', () => {
131
+ const messages = [];
132
+ const error = console.error;
133
+ console.error = (...args) => messages.push(args.join(' '));
134
+ try {
135
+ const invalid = layer({ server: { maxPlayers: 8 }, hub: {
136
+ contract: 1,
137
+ title: 'Town',
138
+ result: { score: { unit: 's', better: 'lower' } },
139
+ resume: { keep: true },
140
+ resumeVisibility: true,
141
+ } }, { ready() {} }, {}, () => true);
142
+ assert.equal(invalid.persist, false);
143
+ assert.match(messages.join('\n'), /resumeVisibility requires an exported resume hook/);
144
+ } finally {
145
+ console.error = error;
146
+ }
147
+ });
148
+
108
149
  test('private overrides reach only named connected viewers, without shared changes', () => {
109
150
  const r = boot();
110
151
  const before = JSON.stringify(r.server.join());
@@ -209,6 +250,392 @@ test('departure drops overrides, even ones created before hello; another viewer
209
250
  }
210
251
  });
211
252
 
253
+ test('resumeVisibility prepares the current merged view before replay, for fresh, repeated and silent hellos', () => {
254
+ let resumeCalls = 0;
255
+ let pendingActor = false;
256
+ let r;
257
+ r = boot(
258
+ { result: { score: { unit: 's', better: 'lower' } }, resume: { keep: true }, resumeVisibility: true },
259
+ { async resume(ctx, { playerId }) {
260
+ resumeCalls += 1;
261
+ if (pendingActor) {
262
+ ctx.hide('trophy-2', { to: [playerId] });
263
+ }
264
+ ctx.send(playerId, { k: 'authored-resume', n: resumeCalls });
265
+ await Promise.resolve(); // only the synchronous prefix can prepare the replay
266
+ } },
267
+ );
268
+ arrive(r);
269
+ r.hub.hide('trophy-0'); // shared hidden, privately shown
270
+ assert.equal(r.hub.show('trophy-0', { to: ['p1'] }), true);
271
+ assert.equal(r.hub.hide('trophy-1', { to: ['p1'] }), true); // shared visible, privately hidden
272
+ r.step();
273
+
274
+ // Ordinary resumed page: it already holds the private map. The real-time
275
+ // WORLD snapshot arrives before its hello; updating shared visibility must
276
+ // keep the merged view correct throughout that pre-authored boundary.
277
+ State.clear();
278
+ hook.state({}, { hidden: r.server.join().hidden });
279
+ hook.message({}, visibility(r).at(-1)[1]);
280
+ assert.deepEqual([...State.hub.hidden], ['trophy-1']);
281
+ drop(r);
282
+ r.step();
283
+ hook.state({}, { hidden: r.server.join().hidden });
284
+ assert.deepEqual([...State.hub.hidden], ['trophy-1'], 'WORLD before hello retains the ordinary page private map');
285
+
286
+ // A locally cleared/fresh client has only WORLD until hello. The contract
287
+ // documents this pre-hello shared-view limit; the first replayed merged
288
+ // state, below, is the boundary the server can guarantee.
289
+ State.clear();
290
+ hook.state({}, { hidden: r.server.join().hidden });
291
+ assert.deepEqual([...State.hub.hidden], ['trophy-0'], 'snapshot alone has the shared view');
292
+ back(r);
293
+ let from = r.sent.length;
294
+ r.hello('p1');
295
+ let messages = r.sent.slice(from).filter(([id]) => id === 'p1').map(([, msg]) => msg);
296
+ assert.deepEqual(messages.filter((msg) => msg.k === 'hub-vis'), [], 'stale cache is gated at hello');
297
+ assert.equal(messages.some((msg) => msg.k === 'authored-resume'), false, 'authored resume stays queued');
298
+ r.step();
299
+ messages = r.sent.slice(from).filter(([id]) => id === 'p1').map(([, msg]) => msg);
300
+ assert.ok(messages.findIndex((msg) => msg.k === 'authored-resume') < messages.findIndex((msg) => msg.k === 'hub-vis'));
301
+ hook.message({}, messages.find((msg) => msg.k === 'hub-vis'));
302
+ assert.deepEqual([...State.hub.hidden], ['trophy-1'], 'first replayed merged state has both private overrides');
303
+ assert.equal(resumeCalls, 1);
304
+
305
+ from = r.sent.length;
306
+ r.hello('p1', { resume: true });
307
+ r.hello('p1', { resume: true });
308
+ assert.equal(
309
+ r.sent.slice(from).filter(([id, msg]) => id === 'p1' && msg.k === 'hub-vis').length,
310
+ 0,
311
+ 'same-body resume hellos are gated too',
312
+ );
313
+ r.step();
314
+ assert.equal(
315
+ r.sent.slice(from).filter(([id, msg]) => id === 'p1' && msg.k === 'hub-vis').length,
316
+ 1,
317
+ 'coalesced resume hellos receive one prepared complete override',
318
+ );
319
+ assert.equal(resumeCalls, 2, 'repeated hellos coalesce their authored resume');
320
+
321
+ drop(r);
322
+ r.step();
323
+ pendingActor = true; // another player's board change while this viewer is away
324
+ hook.state({}, { hidden: r.server.join().hidden }); // live host order: WORLD precedes hello/replay
325
+ assert.deepEqual([...State.hub.hidden], ['trophy-1'], 'ordinary page retains its old mask across WORLD');
326
+ back(r);
327
+ from = r.sent.length;
328
+ r.step(); // no client hello: prepareResume sends the kit's silent one
329
+ messages = r.sent.slice(from).filter(([id]) => id === 'p1').map(([, msg]) => msg);
330
+ const visAt = messages.findIndex((msg) => msg.k === 'hub-vis');
331
+ const authoredAt = messages.findIndex((msg) => msg.k === 'authored-resume');
332
+ assert.ok(authoredAt >= 0 && visAt > authoredAt, 'silent hook prepares before its whole-map replay');
333
+ hook.message({}, messages[visAt]);
334
+ assert.deepEqual([...State.hub.hidden].sort(), ['trophy-1', 'trophy-2'], 'current offline mutation is in the first replay');
335
+ assert.equal(resumeCalls, 3);
336
+ from = r.sent.length;
337
+ r.hello('p1', { resume: true });
338
+ r.step();
339
+ assert.ok(r.sent.slice(from).some(([id, msg]) => id === 'p1' && msg.k === 'hub-vis'));
340
+ assert.equal(resumeCalls, 3, 'the companion client hello shares the silent resume signal');
341
+ });
342
+
343
+ test('same-body fresh hello prepares newly changed visibility before its first replay', () => {
344
+ let currentBoard = false;
345
+ let resumeCalls = 0;
346
+ const r = boot(
347
+ { result: { score: { unit: 's', better: 'lower' } }, resume: { keep: true }, resumeVisibility: true },
348
+ { resume(ctx, { playerId }) {
349
+ resumeCalls += 1;
350
+ if (currentBoard) { ctx.hide('trophy-2', { to: [playerId] }); }
351
+ ctx.send(playerId, { k: 'authored-resume' });
352
+ } },
353
+ );
354
+ arrive(r);
355
+ r.hub.hide('trophy-0');
356
+ r.hub.show('trophy-0', { to: ['p1'] });
357
+ r.hub.hide('trophy-1', { to: ['p1'] });
358
+ r.step();
359
+
360
+ State.clear();
361
+ hook.state({}, { hidden: r.server.join().hidden });
362
+ currentBoard = true; // board changed immediately before a same-body reload hello
363
+ const body = r.world.players.get('p1');
364
+ const from = r.sent.length;
365
+ r.hello('p1');
366
+ assert.equal(r.world.players.get('p1'), body, 'no absence or body replacement creates the gate');
367
+ assert.deepEqual(r.sent.slice(from).filter(([id, msg]) => id === 'p1' && msg.k === 'hub-vis'), []);
368
+ r.step();
369
+ const messages = r.sent.slice(from).filter(([id]) => id === 'p1').map(([, msg]) => msg);
370
+ const visAt = messages.findIndex((msg) => msg.k === 'hub-vis');
371
+ const authoredAt = messages.findIndex((msg) => msg.k === 'authored-resume');
372
+ assert.ok(authoredAt >= 0 && authoredAt < visAt, 'current mask is authored before the first replay');
373
+ hook.message({}, messages[visAt]);
374
+ assert.deepEqual([...State.hub.hidden].sort(), ['trophy-1', 'trophy-2']);
375
+ assert.equal(resumeCalls, 1);
376
+ });
377
+
378
+ test('roster-only absence retains visibility identity and the original 60-second deadline', () => {
379
+ const realNow = Date.now;
380
+ let now = realNow();
381
+ Date.now = () => now;
382
+ try {
383
+ let currentBoard = false;
384
+ let resumeCalls = 0;
385
+ const r = boot(
386
+ { result: { score: { unit: 's', better: 'lower' } }, resume: { keep: true }, resumeVisibility: true },
387
+ { resume(ctx, { playerId }) {
388
+ resumeCalls += 1;
389
+ if (currentBoard) {
390
+ for (const actorId of ['trophy-3', 'trophy-4', 'trophy-5']) {
391
+ ctx.hide(actorId, { to: [playerId] });
392
+ }
393
+ }
394
+ ctx.send(playerId, { k: 'authored-resume' });
395
+ } },
396
+ );
397
+ arrive(r);
398
+ // Exercise an explicitly empty prior private map, as after a board turn
399
+ // whose old targets were all cleared.
400
+ r.hub.hide('trophy-0', { to: ['p1'] });
401
+ r.step();
402
+ r.hub.hide('trophy-0', { to: ['p1'], clear: true });
403
+ r.step();
404
+
405
+ const retainedBody = r.world.players.get('p1');
406
+ r.session.players = r.session.players.filter((player) => player.playerId !== 'p1');
407
+ r.step();
408
+ now += 30000;
409
+ r.step(); // the host still has the body through multiple roster-absent ticks
410
+ assert.equal(r.world.players.get('p1'), retainedBody);
411
+ currentBoard = true; // another viewer advances the board while p1 is away
412
+ State.clear();
413
+ hook.state({}, { hidden: r.server.join().hidden });
414
+ r.session.players.push(r.players[0]);
415
+ const from = r.sent.length;
416
+ r.hello('p1', { resume: true });
417
+ assert.deepEqual(
418
+ r.sent.slice(from).filter(([id, msg]) => id === 'p1' && msg.k === 'hub-vis'),
419
+ [],
420
+ 'the retained empty map cannot clear before current masks are authored',
421
+ );
422
+ r.step();
423
+ const messages = r.sent.slice(from).filter(([id]) => id === 'p1').map(([, msg]) => msg);
424
+ const authoredAt = messages.findIndex((msg) => msg.k === 'authored-resume');
425
+ const returningVis = messages.filter((msg) => msg.k === 'hub-vis');
426
+ assert.equal(resumeCalls, 1);
427
+ assert.equal(returningVis.length, 1);
428
+ assert.ok(authoredAt >= 0 && authoredAt < messages.findIndex((msg) => msg.k === 'hub-vis'));
429
+ assert.deepEqual(returningVis[0].hide, ['trophy-3', 'trophy-4', 'trophy-5']);
430
+ hook.message({}, returningVis[0]);
431
+ assert.deepEqual([...State.hub.hidden].sort(), ['trophy-3', 'trophy-4', 'trophy-5']);
432
+
433
+ let leaves = 0;
434
+ const expired = boot(
435
+ { result: { score: { unit: 's', better: 'lower' } }, resume: { keep: true }, resumeVisibility: true },
436
+ { resume() {}, leave() { leaves += 1; } },
437
+ );
438
+ arrive(expired);
439
+ expired.hub.hide('trophy-0', { to: ['p1'] });
440
+ expired.step();
441
+ const expiredBody = expired.world.players.get('p1');
442
+ expired.session.players = expired.session.players.filter((player) => player.playerId !== 'p1');
443
+ expired.step();
444
+ now += 59999;
445
+ expired.step();
446
+ assert.equal(leaves, 0);
447
+ assert.equal(expired.world.players.get('p1'), expiredBody);
448
+ now += 1;
449
+ expired.step();
450
+ assert.equal(leaves, 1, 'retained body ticks cannot refresh the 60-second absence deadline');
451
+ } finally {
452
+ Date.now = realNow;
453
+ }
454
+ });
455
+
456
+ test('resume hook rehellos defer normally and fail closed during retained preparation', () => {
457
+ for (const retainedVisibility of [false, true]) {
458
+ const calls = [];
459
+ const leaves = [];
460
+ let queueInsideHook = true;
461
+ let r;
462
+ const keys = retainedVisibility
463
+ ? { result: { score: { unit: 's', better: 'lower' } }, resume: { keep: true }, resumeVisibility: true }
464
+ : {};
465
+ r = boot(keys, {
466
+ resume(ctx, { playerId }) {
467
+ calls.push(playerId);
468
+ if (queueInsideHook) {
469
+ queueInsideHook = false;
470
+ r.hello('p1', { resume: true });
471
+ r.hello('p2', { resume: true });
472
+ }
473
+ },
474
+ leave(ctx, playerId) { leaves.push(playerId); },
475
+ });
476
+ arrive(r);
477
+ if (retainedVisibility) {
478
+ r.hub.hide('trophy-0', { to: ['p1'] });
479
+ r.step();
480
+ drop(r);
481
+ r.step();
482
+ back(r);
483
+ }
484
+ r.hello('p1', { resume: true });
485
+ r.step();
486
+ assert.deepEqual(calls, ['p1'], 'hook-created hellos do not enter the second drain');
487
+ r.step();
488
+ if (retainedVisibility) {
489
+ assert.deepEqual(calls, ['p1'], 'retained preparation never pauses the next authored step');
490
+ assert.deepEqual(leaves.sort(), ['p1', 'p2'], 'hook-created retained visits end through normal cleanup');
491
+ } else {
492
+ assert.deepEqual(calls.slice(1).sort(), ['p1', 'p2'], 'marker-absent signals survive once for the next step');
493
+ assert.deepEqual(leaves, []);
494
+ }
495
+ }
496
+ });
497
+
498
+ test('resumeVisibility is default-off and never replays to a changed trusted identity', () => {
499
+ const keys = { result: { score: { unit: 's', better: 'lower' } }, resume: { keep: true } };
500
+ {
501
+ const r = boot(keys);
502
+ arrive(r);
503
+ r.hub.hide('trophy-0', { to: ['p1'] });
504
+ r.step();
505
+ drop(r);
506
+ r.step();
507
+ back(r, { playerId: 'p1', userId: '999', username: 'Eve', isAnonymous: false });
508
+ const from = r.sent.length;
509
+ r.hello('p1', { resume: true });
510
+ r.step();
511
+ const changed = r.sent.slice(from).filter(([id, msg]) => id === 'p1' && msg.k === 'hub-vis');
512
+ assert.ok(changed.every(([, msg]) => msg.hide.length === 0 && msg.show.length === 0),
513
+ 'absent marker keeps legacy cleanup');
514
+ }
515
+ for (const returning of [
516
+ { playerId: 'p1', userId: '999', username: 'Eve', isAnonymous: false, why: 'changed account' },
517
+ { playerId: 'p1', userId: '101', username: 'Guest', isAnonymous: true, why: 'same raw id but anonymous' },
518
+ { playerId: 'p1', username: 'Unknown', isAnonymous: false, why: 'missing identity' },
519
+ ]) {
520
+ const r = boot({ ...keys, resumeVisibility: true }, { resume() {} });
521
+ arrive(r);
522
+ r.hub.hide('trophy-0', { to: ['p1'] });
523
+ r.step();
524
+ drop(r);
525
+ r.step();
526
+ back(r, returning);
527
+ const from = r.sent.length;
528
+ r.hello('p1', { resume: true });
529
+ r.step();
530
+ const changed = r.sent.slice(from).filter(([id, msg]) => id === 'p1' && msg.k === 'hub-vis');
531
+ assert.ok(changed.length <= 1);
532
+ assert.ok(changed.every(([, msg]) => msg.hide.length === 0 && msg.show.length === 0),
533
+ `${returning.why} receives only a cache clear`);
534
+ drop(r);
535
+ r.step();
536
+ back(r);
537
+ const again = r.sent.length;
538
+ r.hello('p1', { resume: true });
539
+ r.step();
540
+ const switchedBack = r.sent.slice(again).filter(([id, msg]) => id === 'p1' && msg.k === 'hub-vis');
541
+ assert.ok(switchedBack.every(([, msg]) => msg.hide.length === 0 && msg.show.length === 0),
542
+ 'deleted cache cannot be recovered by switching the roster identity back');
543
+ }
544
+ });
545
+
546
+ test('identity replacement between hello and step cancels retained preparation', () => {
547
+ for (const replacement of [
548
+ { playerId: 'p1', userId: '999', username: 'Eve', isAnonymous: false, why: 'changed identity' },
549
+ { playerId: 'p1', username: 'Unknown', isAnonymous: false, why: 'missing identity' },
550
+ ]) {
551
+ let resumeCalls = 0;
552
+ const r = boot(
553
+ { result: { score: { unit: 's', better: 'lower' } }, resume: { keep: true }, resumeVisibility: true },
554
+ { resume(ctx, { playerId }) {
555
+ resumeCalls += 1;
556
+ ctx.hide('trophy-2', { to: [playerId] });
557
+ ctx.send(playerId, { k: 'authored-resume' });
558
+ } },
559
+ );
560
+ arrive(r);
561
+ r.hub.hide('trophy-0', { to: ['p1'] });
562
+ r.step();
563
+
564
+ let from = r.sent.length;
565
+ r.hello('p1', { resume: true });
566
+ assert.deepEqual(r.sent.slice(from).filter(([id, msg]) => id === 'p1' && msg.k === 'hub-vis'), []);
567
+ r.session.players = [r.players[1], replacement];
568
+ r.step();
569
+ let messages = r.sent.slice(from).filter(([id]) => id === 'p1').map(([, msg]) => msg);
570
+ assert.equal(resumeCalls, 0, `${replacement.why} cancels the old queued resume`);
571
+ assert.equal(messages.some((msg) => msg.k === 'authored-resume'), false);
572
+ assert.ok(messages.filter((msg) => msg.k === 'hub-vis')
573
+ .every((msg) => msg.hide.length === 0 && msg.show.length === 0),
574
+ `${replacement.why} receives no private actor ids`);
575
+
576
+ // Switching back is another identity boundary: it cannot recover the old
577
+ // trophy-0 cache or the resume signal queued under the replacement.
578
+ r.session.players = [r.players[1], r.players[0]];
579
+ from = r.sent.length;
580
+ r.hello('p1', { resume: true });
581
+ r.step();
582
+ messages = r.sent.slice(from).filter(([id]) => id === 'p1').map(([, msg]) => msg);
583
+ assert.ok(resumeCalls <= 1);
584
+ assert.ok(messages.filter((msg) => msg.k === 'hub-vis')
585
+ .every((msg) => !msg.hide.includes('trophy-0') && !msg.show.includes('trophy-0')),
586
+ 'switching back cannot recover the deleted private map');
587
+ }
588
+ });
589
+
590
+ test('resumeVisibility cache is deleted on the 60-second boundary and explicit kit travel', () => {
591
+ const realNow = Date.now;
592
+ let now = realNow();
593
+ Date.now = () => now;
594
+ try {
595
+ const keys = { result: { score: { unit: 's', better: 'lower' } }, resume: { keep: true }, resumeVisibility: true };
596
+ const expired = boot(keys, { resume() {} });
597
+ arrive(expired);
598
+ expired.hub.hide('trophy-0', { to: ['p1'] });
599
+ expired.step();
600
+ drop(expired);
601
+ expired.step();
602
+ now += 60000;
603
+ expired.step();
604
+ back(expired);
605
+ let from = expired.sent.length;
606
+ expired.hello('p1', { resume: true });
607
+ expired.step();
608
+ assert.ok(expired.sent.slice(from).filter(([id, msg]) => id === 'p1' && msg.k === 'hub-vis')
609
+ .every(([, msg]) => msg.hide.length === 0 && msg.show.length === 0), 'expiry can only clear the old view');
610
+
611
+ const door = { id: 'door-lobby', components: {
612
+ Transform: { x: 1, y: 1, z: 1 },
613
+ HubDoor: { id: 'lobby', to: 'lobby', title: 'Lobby' },
614
+ } };
615
+ const travelled = boot({
616
+ ...keys,
617
+ places: { lobby: { title: 'Lobby', scene: 'scenes/lobby.scene' } },
618
+ }, { sessionId: 'dev', actors: [...actors, door], resume() {} });
619
+ arrive(travelled);
620
+ travelled.hub.hide('trophy-0', { to: ['p1'] });
621
+ travelled.step();
622
+ assert.equal(typeof travelled.hub.go('lobby', ['p1']), 'string');
623
+ drop(travelled);
624
+ travelled.step();
625
+ back(travelled);
626
+ from = travelled.sent.length;
627
+ travelled.hello('p1', { resume: true });
628
+ travelled.step();
629
+ assert.ok(
630
+ travelled.sent.slice(from).filter(([id, msg]) => id === 'p1' && msg.k === 'hub-vis')
631
+ .every(([, msg]) => msg.hide.length === 0 && msg.show.length === 0),
632
+ 'kit-issued travel ends the retained visit and can only clear its visibility cache',
633
+ );
634
+ } finally {
635
+ Date.now = realNow;
636
+ }
637
+ });
638
+
212
639
  test('invalid actors and malformed options warn once per kind and change nothing', () => {
213
640
  const r = boot();
214
641
  r.hub.hide('trophy-0', { to: ['p1'] });