castle-web-cli 0.4.233 → 0.4.235

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (383) hide show
  1. package/dist/api.d.ts +11 -0
  2. package/dist/api.js +43 -0
  3. package/dist/bundle.d.ts +64 -0
  4. package/dist/bundle.js +558 -2
  5. package/dist/castle-host/host.d.ts +17 -2
  6. package/dist/castle-host/host.js +793 -36
  7. package/dist/castleJson.d.ts +20 -1
  8. package/dist/castleJson.js +44 -2
  9. package/dist/check.js +9 -2
  10. package/dist/chunkLoader.d.ts +3 -0
  11. package/dist/chunkLoader.js +111 -0
  12. package/dist/devParty.d.ts +26 -0
  13. package/dist/devParty.js +231 -0
  14. package/dist/devSaveStorage.js +4 -0
  15. package/dist/devSessionStorage.js +3 -1
  16. package/dist/devSocial.d.ts +24 -0
  17. package/dist/devSocial.js +70 -0
  18. package/dist/ide.d.ts +2 -0
  19. package/dist/ide.js +119 -15
  20. package/dist/index.js +8 -2
  21. package/dist/init.js +1 -1
  22. package/dist/save-deck.d.ts +20 -1
  23. package/dist/save-deck.js +141 -5
  24. package/dist/serve.js +29 -11
  25. package/dist/shell/assets/{index-BjOxR-lW.js → index-DulbYIJm.js} +97 -97
  26. package/dist/shell/index.html +1 -1
  27. package/dist/vitePlugins.d.ts +2 -1
  28. package/dist/vitePlugins.js +13 -0
  29. package/kits/base/castle.json +1 -1
  30. package/kits/base/sdk/README.md +266 -3
  31. package/kits/base/sdk/castle.d.ts +7 -3
  32. package/kits/base/sdk/castle.js +2 -0
  33. package/kits/base/sdk/commands.d.ts +162 -1
  34. package/kits/base/sdk/commands.js +3 -0
  35. package/kits/base/sdk/display.d.ts +3 -0
  36. package/kits/base/sdk/display.js +9 -3
  37. package/kits/base/sdk/hub.d.ts +33 -6
  38. package/kits/base/sdk/hub.js +68 -5
  39. package/kits/base/sdk/hubRejoin.d.ts +4 -0
  40. package/kits/base/sdk/hubRejoin.js +15 -0
  41. package/kits/base/sdk/multiplayer.d.ts +7 -1
  42. package/kits/base/sdk/multiplayer.js +147 -40
  43. package/kits/base/sdk/multiplayerProtocol.d.ts +2 -0
  44. package/kits/base/sdk/party.d.ts +23 -0
  45. package/kits/base/sdk/party.js +91 -0
  46. package/kits/base/sdk/reconnectBudget.d.ts +23 -0
  47. package/kits/base/sdk/reconnectBudget.js +96 -0
  48. package/kits/base/sdk/save.d.ts +38 -1
  49. package/kits/base/sdk/save.js +79 -6
  50. package/kits/base/sdk/server/hub.d.ts +31 -1
  51. package/kits/base/sdk/server/hub.js +50 -3
  52. package/kits/base/sdk/server/platformHandle.d.ts +13 -1
  53. package/kits/base/sdk/server/storage.d.ts +4 -0
  54. package/kits/base/sdk/server/storage.js +19 -3
  55. package/kits/base/sdk/server/wrapper.d.ts +7 -1
  56. package/kits/base/sdk/server/wrapper.js +10 -1
  57. package/kits/base/sdk/social.d.ts +9 -0
  58. package/kits/base/sdk/social.js +5 -0
  59. package/kits/hub-game/CLAUDE.md +123 -3
  60. package/kits/hub-game/README.md +63 -0
  61. package/kits/hub-game/castle.json +5 -5
  62. package/kits/hub-game/code/client/act.js +312 -0
  63. package/kits/hub-game/code/client/actionLayout.js +147 -0
  64. package/kits/hub-game/code/client/actionOverflow.js +556 -0
  65. package/kits/hub-game/code/client/arrivalCamera.js +50 -0
  66. package/kits/hub-game/code/client/askSlot.js +117 -0
  67. package/kits/hub-game/code/client/avatar.js +4 -2
  68. package/kits/hub-game/code/client/avatarShare.js +2 -0
  69. package/kits/hub-game/code/client/backVisibility.js +13 -0
  70. package/kits/hub-game/code/client/ballot.js +15 -10
  71. package/kits/hub-game/code/client/build.js +16 -0
  72. package/kits/hub-game/code/client/chat.js +41 -5
  73. package/kits/hub-game/code/client/chatModeration.js +5 -0
  74. package/kits/hub-game/code/client/chrome.js +1148 -258
  75. package/kits/hub-game/code/client/crowdNames.js +241 -0
  76. package/kits/hub-game/code/client/decor.js +10 -4
  77. package/kits/hub-game/code/client/defaultEnvironment.js +194 -0
  78. package/kits/hub-game/code/client/doorErrors.js +39 -0
  79. package/kits/hub-game/code/client/fall.js +18 -0
  80. package/kits/hub-game/code/client/farAvatars.js +233 -0
  81. package/kits/hub-game/code/client/firstJoin.js +9 -2
  82. package/kits/hub-game/code/client/fpsTelemetry.js +50 -0
  83. package/kits/hub-game/code/client/frameBatch.js +5 -0
  84. package/kits/hub-game/code/client/grab.js +31 -11
  85. package/kits/hub-game/code/client/hookLayer.js +87 -8
  86. package/kits/hub-game/code/client/hudCopy.js +51 -0
  87. package/kits/hub-game/code/client/hudRate.js +20 -0
  88. package/kits/hub-game/code/client/idle.js +14 -2
  89. package/kits/hub-game/code/client/invites.js +231 -0
  90. package/kits/hub-game/code/client/joinError.js +9 -0
  91. package/kits/hub-game/code/client/labelsNear.js +31 -2
  92. package/kits/hub-game/code/client/landscapeLayout.js +17 -0
  93. package/kits/hub-game/code/client/layoutCache.js +264 -0
  94. package/kits/hub-game/code/client/loadTelemetry.js +20 -0
  95. package/kits/hub-game/code/client/loadingCover.js +148 -0
  96. package/kits/hub-game/code/client/loadingEntry.js +8 -0
  97. package/kits/hub-game/code/client/menuRows.js +43 -0
  98. package/kits/hub-game/code/client/modelReady.js +7 -0
  99. package/kits/hub-game/code/client/padCueArrival.js +23 -0
  100. package/kits/hub-game/code/client/padCues.js +112 -0
  101. package/kits/hub-game/code/client/padOccupancy.js +88 -0
  102. package/kits/hub-game/code/client/padReadability.js +26 -0
  103. package/kits/hub-game/code/client/padRings.js +69 -0
  104. package/kits/hub-game/code/client/pushVisit.js +14 -0
  105. package/kits/hub-game/code/client/quality.js +205 -0
  106. package/kits/hub-game/code/client/qualityEntry.js +55 -0
  107. package/kits/hub-game/code/client/safeLayout.js +338 -0
  108. package/kits/hub-game/code/client/safeStyle.js +42 -0
  109. package/kits/hub-game/code/client/say.js +12 -3
  110. package/kits/hub-game/code/client/shot.js +64 -10
  111. package/kits/hub-game/code/client/shotFit.js +56 -0
  112. package/kits/hub-game/code/client/signIn.js +28 -0
  113. package/kits/hub-game/code/client/state.js +53 -0
  114. package/kits/hub-game/code/client/talk.js +209 -45
  115. package/kits/hub-game/code/client/tiers.js +68 -66
  116. package/kits/hub-game/code/client/together.js +7 -2
  117. package/kits/hub-game/code/client/weakestLookBake.js +92 -0
  118. package/kits/hub-game/code/client/weakestTier.js +295 -0
  119. package/kits/hub-game/code/client/worldLabels.js +241 -0
  120. package/kits/hub-game/code/client/yours.js +10 -9
  121. package/kits/hub-game/code/npcDisplayText.js +55 -0
  122. package/kits/hub-game/code/server/act.js +124 -0
  123. package/kits/hub-game/code/server/actions.js +6 -1
  124. package/kits/hub-game/code/server/actors.js +2 -1
  125. package/kits/hub-game/code/server/analytics.js +83 -0
  126. package/kits/hub-game/code/server/anonymousEntry.js +49 -0
  127. package/kits/hub-game/code/server/arrivalPose.js +36 -0
  128. package/kits/hub-game/code/server/companion.js +28 -3
  129. package/kits/hub-game/code/server/doorAnalytics.js +52 -0
  130. package/kits/hub-game/code/server/earned.js +22 -5
  131. package/kits/hub-game/code/server/frameBatch.js +183 -0
  132. package/kits/hub-game/code/server/friendsAmong.js +49 -9
  133. package/kits/hub-game/code/server/history.js +2 -0
  134. package/kits/hub-game/code/server/hub.js +1306 -95
  135. package/kits/hub-game/code/server/idle.js +30 -1
  136. package/kits/hub-game/code/server/index.js +26 -4
  137. package/kits/hub-game/code/server/invites.js +19 -0
  138. package/kits/hub-game/code/server/labels.js +9 -1
  139. package/kits/hub-game/code/server/loadAbandon.js +106 -0
  140. package/kits/hub-game/code/server/manifest.js +211 -3
  141. package/kits/hub-game/code/server/menu.js +31 -3
  142. package/kits/hub-game/code/server/npcs.js +226 -64
  143. package/kits/hub-game/code/server/observe.js +408 -0
  144. package/kits/hub-game/code/server/padOccupancy.js +85 -0
  145. package/kits/hub-game/code/server/players.js +9 -1
  146. package/kits/hub-game/code/server/resumePose.js +152 -0
  147. package/kits/hub-game/code/server/say.js +1 -1
  148. package/kits/hub-game/code/server/standing.js +4 -5
  149. package/kits/hub-game/code/server/storageLimit.js +187 -0
  150. package/kits/hub-game/code/server/vis.js +67 -5
  151. package/kits/hub-game/code/shared/act.js +35 -0
  152. package/kits/hub-game/code/shared/danceIdle.js +28 -0
  153. package/kits/hub-game/code/shared/loadStages.js +12 -0
  154. package/kits/hub-game/code/shared/quality.js +74 -0
  155. package/kits/hub-game/code/shared/say.js +2 -0
  156. package/kits/hub-game/code/shared/shot.js +35 -1
  157. package/kits/hub-game/code/systems/hub.js +970 -169
  158. package/kits/hub-game/docs/analytics.md +279 -0
  159. package/kits/hub-game/docs/contract.md +1259 -42
  160. package/kits/hub-game/docs/home-pieces.md +9 -2
  161. package/kits/hub-game/docs/observed-progress.md +252 -0
  162. package/kits/hub-game/main.jsx +2 -0
  163. package/kits/hub-game/package-lock.json +10 -3
  164. package/kits/hub-game/package.json +6 -3
  165. package/kits/hub-game/play/player.js +142 -0
  166. package/kits/hub-game/play/registry.js +47 -0
  167. package/kits/hub-game/play.jsx +37 -0
  168. package/kits/hub-game/scripts/check.mjs +39 -5
  169. package/kits/hub-game/scripts/companion-follower-wire.json +1 -1
  170. package/kits/hub-game/scripts/fixtures/decor-keyless-draw.json +11 -0
  171. package/kits/hub-game/scripts/fixtures/decor-keyless.json +5 -5
  172. package/kits/hub-game/scripts/fixtures/engine-models-stub.mjs +3 -0
  173. package/kits/hub-game/scripts/fixtures/fake-dom.mjs +19 -3
  174. package/kits/hub-game/scripts/fixtures/interest-legacy.json +3 -3
  175. package/kits/hub-game/scripts/fixtures/vis-shared-wire.json +1 -1
  176. package/kits/hub-game/scripts/pose-storage-fixture.mjs +46 -0
  177. package/kits/hub-game/scripts/test-act-client.mjs +186 -0
  178. package/kits/hub-game/scripts/test-act.mjs +171 -0
  179. package/kits/hub-game/scripts/test-action-layout.mjs +80 -0
  180. package/kits/hub-game/scripts/test-action-observers.mjs +46 -0
  181. package/kits/hub-game/scripts/test-actions-client.mjs +367 -2
  182. package/kits/hub-game/scripts/test-actors.mjs +20 -7
  183. package/kits/hub-game/scripts/test-analytics.mjs +76 -0
  184. package/kits/hub-game/scripts/test-anonymous-entry.mjs +28 -0
  185. package/kits/hub-game/scripts/test-arrival-pose-server.mjs +196 -0
  186. package/kits/hub-game/scripts/test-arrival-pose.mjs +24 -0
  187. package/kits/hub-game/scripts/test-ask-slot.mjs +85 -0
  188. package/kits/hub-game/scripts/test-avatar-wire.mjs +49 -10
  189. package/kits/hub-game/scripts/test-avatar.mjs +44 -0
  190. package/kits/hub-game/scripts/test-back-visibility.mjs +82 -0
  191. package/kits/hub-game/scripts/test-ballot.mjs +11 -4
  192. package/kits/hub-game/scripts/test-ban-join.mjs +121 -13
  193. package/kits/hub-game/scripts/test-build.mjs +20 -2
  194. package/kits/hub-game/scripts/test-chat.mjs +206 -5
  195. package/kits/hub-game/scripts/test-companion-chat.mjs +20 -2
  196. package/kits/hub-game/scripts/test-control-layout-dom.mjs +120 -0
  197. package/kits/hub-game/scripts/test-crowd-names.mjs +205 -0
  198. package/kits/hub-game/scripts/test-decor-client.mjs +45 -4
  199. package/kits/hub-game/scripts/test-decor.mjs +7 -0
  200. package/kits/hub-game/scripts/test-default-environment-root.mjs +95 -0
  201. package/kits/hub-game/scripts/test-default-environment.mjs +267 -0
  202. package/kits/hub-game/scripts/test-door-analytics.mjs +58 -0
  203. package/kits/hub-game/scripts/test-door-jump.mjs +100 -0
  204. package/kits/hub-game/scripts/test-earned.mjs +33 -3
  205. package/kits/hub-game/scripts/test-far-avatars.mjs +340 -0
  206. package/kits/hub-game/scripts/test-fps-telemetry.mjs +112 -0
  207. package/kits/hub-game/scripts/test-frame-batch.mjs +252 -0
  208. package/kits/hub-game/scripts/test-fresh-friends.mjs +118 -0
  209. package/kits/hub-game/scripts/test-grab-orbit.mjs +47 -4
  210. package/kits/hub-game/scripts/test-high-only.mjs +170 -0
  211. package/kits/hub-game/scripts/test-hub-ops.mjs +321 -2
  212. package/kits/hub-game/scripts/test-hub-trip.mjs +879 -11
  213. package/kits/hub-game/scripts/test-hud-clear.mjs +162 -59
  214. package/kits/hub-game/scripts/test-hud-defects-dom.mjs +100 -0
  215. package/kits/hub-game/scripts/test-hud-rate.mjs +224 -0
  216. package/kits/hub-game/scripts/test-hud-safe-visibility-dom.mjs +83 -0
  217. package/kits/hub-game/scripts/test-idle.mjs +66 -0
  218. package/kits/hub-game/scripts/test-interest-cells.mjs +20 -0
  219. package/kits/hub-game/scripts/test-interest.mjs +15 -0
  220. package/kits/hub-game/scripts/test-invites-client.mjs +430 -0
  221. package/kits/hub-game/scripts/test-invites.mjs +109 -0
  222. package/kits/hub-game/scripts/test-labels.mjs +71 -3
  223. package/kits/hub-game/scripts/test-landscape-layout.mjs +194 -0
  224. package/kits/hub-game/scripts/test-list-scroll-dom.mjs +49 -0
  225. package/kits/hub-game/scripts/test-load-abandon.mjs +246 -0
  226. package/kits/hub-game/scripts/test-loading-cover.mjs +162 -0
  227. package/kits/hub-game/scripts/test-manifest.mjs +265 -0
  228. package/kits/hub-game/scripts/test-menu-client.mjs +105 -0
  229. package/kits/hub-game/scripts/test-menu.mjs +23 -0
  230. package/kits/hub-game/scripts/test-npcs.mjs +917 -10
  231. package/kits/hub-game/scripts/test-observed.mjs +745 -0
  232. package/kits/hub-game/scripts/test-pad-cues.mjs +304 -0
  233. package/kits/hub-game/scripts/test-pad-occupancy.mjs +177 -0
  234. package/kits/hub-game/scripts/test-picker.mjs +234 -7
  235. package/kits/hub-game/scripts/test-placement-cache.mjs +690 -0
  236. package/kits/hub-game/scripts/test-progress-reset.mjs +559 -0
  237. package/kits/hub-game/scripts/test-push-visit.mjs +26 -0
  238. package/kits/hub-game/scripts/test-quality.mjs +385 -0
  239. package/kits/hub-game/scripts/test-rehello.mjs +699 -5
  240. package/kits/hub-game/scripts/test-resume-action-order.mjs +598 -0
  241. package/kits/hub-game/scripts/test-resume-held.mjs +239 -0
  242. package/kits/hub-game/scripts/test-resume-pose.mjs +142 -0
  243. package/kits/hub-game/scripts/test-safe-events-dom.mjs +116 -0
  244. package/kits/hub-game/scripts/test-safe-layout.mjs +330 -0
  245. package/kits/hub-game/scripts/test-say.mjs +1 -1
  246. package/kits/hub-game/scripts/test-shot.mjs +145 -0
  247. package/kits/hub-game/scripts/test-signin-client.mjs +45 -0
  248. package/kits/hub-game/scripts/test-soundscape.mjs +22 -17
  249. package/kits/hub-game/scripts/test-standing.mjs +35 -2
  250. package/kits/hub-game/scripts/test-storage-limit.mjs +333 -0
  251. package/kits/hub-game/scripts/test-stuck.mjs +5 -4
  252. package/kits/hub-game/scripts/test-talk-overlay-dom.mjs +130 -0
  253. package/kits/hub-game/scripts/test-tiers-render.mjs +86 -13
  254. package/kits/hub-game/scripts/test-tiers.mjs +7 -8
  255. package/kits/hub-game/scripts/test-vis.mjs +433 -6
  256. package/kits/hub-game/scripts/test-weakest-tier.mjs +924 -0
  257. package/kits/hub-game/scripts/test-world-labels.mjs +367 -0
  258. package/kits/hub-game/scripts/test-yours-chrome.mjs +50 -6
  259. package/kits/hub-game/scripts/test-yours.mjs +39 -8
  260. package/kits/multiplayer-3d/castle.json +5 -5
  261. package/kits/multiplayer-3d/code/client/joinFailure.js +27 -0
  262. package/kits/multiplayer-3d/code/client/resumeGate.js +139 -0
  263. package/kits/multiplayer-3d/code/systems/multiplayer.js +369 -30
  264. package/kits/multiplayer-3d/package-lock.json +8 -1
  265. package/kits/multiplayer-3d/package.json +2 -1
  266. package/kits/multiplayer-3d/scripts/test-join-watchdog.mjs +436 -0
  267. package/kits/multiplayer-3d/scripts/test-resume-gate.mjs +624 -0
  268. package/kits/physics-2d/CLAUDE.md +10 -1
  269. package/kits/physics-2d/castle.json +2 -2
  270. package/kits/physics-2d/engine/frozenActors.js +233 -0
  271. package/kits/physics-2d/engine/scene.js +87 -5
  272. package/kits/physics-2d/eslint.config.js +1 -1
  273. package/kits/physics-2d/play/behaviors/AnalogStick.js +198 -0
  274. package/kits/physics-2d/play/behaviors/Camera.js +40 -0
  275. package/kits/physics-2d/play/behaviors/Collider.js +122 -0
  276. package/kits/physics-2d/play/behaviors/Draggable.js +115 -0
  277. package/kits/physics-2d/play/behaviors/Goal.js +46 -0
  278. package/kits/physics-2d/play/behaviors/Joints.js +126 -0
  279. package/kits/physics-2d/play/behaviors/Layout.js +71 -0
  280. package/kits/physics-2d/play/behaviors/RigidBody.js +57 -0
  281. package/kits/physics-2d/play/behaviors/Slingshot.js +142 -0
  282. package/kits/physics-2d/play/behaviors/SoundPlayer.js +263 -0
  283. package/kits/physics-2d/play/behaviors/Sprite.js +406 -0
  284. package/kits/physics-2d/play/behaviors/Style.js +209 -0
  285. package/kits/physics-2d/play/behaviors/Text.js +85 -0
  286. package/kits/physics-2d/play/behaviors/Video.js +93 -0
  287. package/kits/physics-3d/CLAUDE.md +25 -1651
  288. package/kits/physics-3d/behaviors/Body.jsx +3 -0
  289. package/kits/physics-3d/behaviors/Model.jsx +3 -0
  290. package/kits/physics-3d/behaviors/Player.jsx +35 -18
  291. package/kits/physics-3d/behaviors/Shape.jsx +3 -0
  292. package/kits/physics-3d/behaviors/Solid.jsx +3 -0
  293. package/kits/physics-3d/behaviors/Transform.jsx +3 -0
  294. package/kits/physics-3d/castle.json +3 -3
  295. package/kits/physics-3d/docs/engine-camera.md +542 -0
  296. package/kits/physics-3d/docs/engine-frame-cap.md +136 -0
  297. package/kits/physics-3d/docs/engine-load.md +149 -0
  298. package/kits/physics-3d/docs/engine-look.md +114 -0
  299. package/kits/physics-3d/docs/engine-shadows.md +372 -0
  300. package/kits/physics-3d/docs/engine-skip-work.md +187 -0
  301. package/kits/physics-3d/docs/engine-sky.md +198 -0
  302. package/kits/physics-3d/docs/engine-static-actors.md +226 -0
  303. package/kits/physics-3d/docs/engine-view.md +37 -0
  304. package/kits/physics-3d/docs/pxmodel-format.md +1 -1
  305. package/kits/physics-3d/engine3d/PlayOnly3D.jsx +5 -1
  306. package/kits/physics-3d/engine3d/Scene3DPlayer.jsx +19 -333
  307. package/kits/physics-3d/engine3d/actornode.js +1 -0
  308. package/kits/physics-3d/engine3d/branches.js +3 -13
  309. package/kits/physics-3d/engine3d/cage.js +2 -7
  310. package/kits/physics-3d/engine3d/cageops.js +2 -17
  311. package/kits/physics-3d/engine3d/dataBehaviors.js +12 -0
  312. package/kits/physics-3d/engine3d/framecap.js +4 -1
  313. package/kits/physics-3d/engine3d/frozenphysics.js +140 -0
  314. package/kits/physics-3d/engine3d/frozenstatics.js +273 -0
  315. package/kits/physics-3d/engine3d/gait.js +8 -0
  316. package/kits/physics-3d/engine3d/initialModelFiles.js +18 -0
  317. package/kits/physics-3d/engine3d/look.js +7 -0
  318. package/kits/physics-3d/engine3d/modelFiles.js +3 -17
  319. package/kits/physics-3d/engine3d/modelMath.js +49 -0
  320. package/kits/physics-3d/engine3d/modelready.js +16 -0
  321. package/kits/physics-3d/engine3d/motion.js +3 -3
  322. package/kits/physics-3d/engine3d/nearshadows.js +77 -10
  323. package/kits/physics-3d/engine3d/orbitinput.js +59 -25
  324. package/kits/physics-3d/engine3d/partgeometry.js +1 -16
  325. package/kits/physics-3d/engine3d/paths.js +1 -9
  326. package/kits/physics-3d/engine3d/playTimings.js +50 -0
  327. package/kits/physics-3d/engine3d/playerRun.js +372 -0
  328. package/kits/physics-3d/engine3d/pxmodel.js +3 -3
  329. package/kits/physics-3d/engine3d/rapier.js +27 -0
  330. package/kits/physics-3d/engine3d/scatter.js +1 -11
  331. package/kits/physics-3d/engine3d/shadowfade.js +23 -15
  332. package/kits/physics-3d/engine3d/sky.js +1 -1
  333. package/kits/physics-3d/engine3d/squarefirst.js +177 -0
  334. package/kits/physics-3d/engine3d/stillshadows.js +399 -0
  335. package/kits/physics-3d/engine3d/sweep.js +1 -25
  336. package/kits/physics-3d/engine3d/world3d.js +468 -18
  337. package/kits/physics-3d/eslint.config.js +2 -1
  338. package/kits/physics-3d/main.jsx +6 -3
  339. package/kits/physics-3d/package-lock.json +7 -0
  340. package/kits/physics-3d/package.json +5 -1
  341. package/kits/physics-3d/play/behaviors/Body.js +31 -0
  342. package/kits/physics-3d/play/behaviors/Door.js +37 -0
  343. package/kits/physics-3d/play/behaviors/Lookable.js +16 -0
  344. package/kits/physics-3d/play/behaviors/Model.js +23 -0
  345. package/kits/physics-3d/play/behaviors/Pickup.js +46 -0
  346. package/kits/physics-3d/play/behaviors/Player.js +1204 -0
  347. package/kits/physics-3d/play/behaviors/Shape.js +47 -0
  348. package/kits/physics-3d/play/behaviors/Solid.js +16 -0
  349. package/kits/physics-3d/play/behaviors/Transform.js +29 -0
  350. package/kits/physics-3d/pnpm-lock.yaml +8 -0
  351. package/kits/physics-3d/scripts/bench-shadow-fade.mjs +37 -0
  352. package/kits/physics-3d/scripts/build-rapier-gz.mjs +56 -0
  353. package/kits/physics-3d/scripts/frozen-statics-fixture.mjs +141 -0
  354. package/kits/physics-3d/scripts/test-camera-follow.mjs +5 -1
  355. package/kits/physics-3d/scripts/test-camera-orbit.mjs +52 -4
  356. package/kits/physics-3d/scripts/test-drop-empty-parts.mjs +1 -1
  357. package/kits/physics-3d/scripts/test-empty-gait-hints.mjs +89 -0
  358. package/kits/physics-3d/scripts/test-frame-cap-bob.mjs +6 -3
  359. package/kits/physics-3d/scripts/test-frame-cap.mjs +1 -1
  360. package/kits/physics-3d/scripts/test-frozen-nested.mjs +49 -0
  361. package/kits/physics-3d/scripts/test-frozen-statics-legacy-physics2d.mjs +123 -0
  362. package/kits/physics-3d/scripts/test-frozen-statics.mjs +434 -0
  363. package/kits/physics-3d/scripts/test-look-bake.mjs +1 -1
  364. package/kits/physics-3d/scripts/test-near-shadows.mjs +2 -2
  365. package/kits/physics-3d/scripts/test-orbit-shadow-fade.mjs +88 -7
  366. package/kits/physics-3d/scripts/test-orbit-shift-lock.mjs +40 -3
  367. package/kits/physics-3d/scripts/test-orbit-shot.mjs +75 -1
  368. package/kits/physics-3d/scripts/test-rapier-gz.mjs +106 -0
  369. package/kits/physics-3d/scripts/test-sky.mjs +1 -1
  370. package/kits/physics-3d/scripts/test-square-first.mjs +921 -0
  371. package/kits/physics-3d/scripts/test-static-actors.mjs +3 -1
  372. package/kits/physics-3d/scripts/test-static-physics.mjs +4 -1
  373. package/kits/physics-3d/scripts/test-static-scenery.mjs +5 -2
  374. package/kits/physics-3d/scripts/test-steady-hover.mjs +5 -2
  375. package/kits/physics-3d/scripts/test-still-shadows.mjs +477 -0
  376. package/kits/physics-3d/systems/physics3d.js +37 -4
  377. package/kits/real-time/castle.json +2 -2
  378. package/kits/real-time/code/client/connection.js +33 -10
  379. package/kits/real-time/code/client/gameHooks.js +2 -0
  380. package/kits/real-time/code/client/joinOverlay.js +9 -4
  381. package/kits/real-time/code/server/session.js +6 -4
  382. package/kits/real-time/package-lock.json +1 -1
  383. package/package.json +2 -2
@@ -0,0 +1,598 @@
1
+ // Retained resume ordering at the real hub layer boundary. The two small
2
+ // authored state machines preserve the timing that exposed this in Ribbon
3
+ // Relay (an intent matures on its second step) and the reduced Showcase-style
4
+ // case (a queued collection completion matures on the next step).
5
+ import assert from 'node:assert/strict';
6
+ import { register } from 'node:module';
7
+
8
+ register(`data:text/javascript,${encodeURIComponent(`
9
+ import { execFileSync } from 'node:child_process';
10
+ const rev = process.env.HUB_RESUME_SOURCE_REV;
11
+ const old = new Map([
12
+ ['/kits/hub-game/code/server/hub.js', 'kits/hub-game/code/server/hub.js'],
13
+ ['/kits/hub-game/code/server/actions.js', 'kits/hub-game/code/server/actions.js'],
14
+ ]);
15
+ export async function resolve(specifier, context, next) {
16
+ if (specifier === '@imports/castle.multiplayer-3d/code/server/sceneBodies.js') {
17
+ return { url: 'data:text/javascript,export const readScene = () => globalThis.__hubResumeOrderActors;', shortCircuit: true };
18
+ }
19
+ if (context.parentURL?.includes('/kits/base/sdk/') && specifier.startsWith('.') && !specifier.endsWith('.js')) {
20
+ return next(specifier + '.js', context);
21
+ }
22
+ return next(specifier, context);
23
+ }
24
+ export async function load(url, context, next) {
25
+ if (rev) {
26
+ const file = [...old].find(([suffix]) => url.split('?')[0].endsWith(suffix))?.[1];
27
+ if (file) {
28
+ return { format: 'module', source: execFileSync('git', ['show', rev + ':' + file], { encoding: 'utf8' }), shortCircuit: true };
29
+ }
30
+ }
31
+ return next(url, context);
32
+ }
33
+ `)}`);
34
+
35
+ const { layer } = await import('../code/server/hub.js');
36
+ const actors = [
37
+ { id: 'player', components: { Player: {}, Transform: { x: 0, y: 1, z: 0 } } },
38
+ { id: 'token', components: { Transform: { x: 1, y: 1, z: 0 } } },
39
+ ];
40
+ const members = [
41
+ { playerId: 'p1', userId: '101', username: 'Ada', isAnonymous: false },
42
+ { playerId: 'p2', userId: '102', username: 'Bo', isAnonymous: false },
43
+ ];
44
+ const body = () => ({ at: { x: 0, y: 1, z: 0 }, facing: 0, body: { setTranslation() {} } });
45
+ const optedIn = {
46
+ result: { score: { unit: 'points', better: 'higher' } },
47
+ resume: { keep: true },
48
+ resumeVisibility: true,
49
+ actions: true,
50
+ };
51
+ const flush = async () => { for (let i = 0; i < 8; i += 1) await Promise.resolve(); };
52
+ const deferred = () => {
53
+ let resolve;
54
+ const promise = new Promise((done) => { resolve = done; });
55
+ return { promise, resolve };
56
+ };
57
+
58
+ function boot(hooks, keys = optedIn, roster = members) {
59
+ globalThis.__hubResumeOrderActors = actors;
60
+ const sent = [];
61
+ let hub;
62
+ const wrapped = { ready(ctx) { hub = ctx; hooks.ready?.(ctx); }, ...hooks };
63
+ const server = layer({ deckId: 'resume-order-test', server: { maxPlayers: 8 }, hub: {
64
+ contract: 1, title: 'Resume order fixture', ...keys,
65
+ } }, wrapped, {}, () => true);
66
+ const session = {
67
+ sessionId: 'test', players: structuredClone(roster),
68
+ send(id, message) { sent.push([id, structuredClone(message)]); },
69
+ broadcast(message) { sent.push(['all', structuredClone(message)]); },
70
+ };
71
+ const world = {
72
+ timeMs: 0, scenePath: 'scenes/main.scene',
73
+ players: new Map(roster.map(({ playerId }) => [playerId, body()])),
74
+ objects: new Map(), bodies: new Map(),
75
+ };
76
+ server.sceneFor(session);
77
+ server.ready(world);
78
+ const say = (playerId, message) => server.message(session, { playerId }, message);
79
+ const hello = (playerId, more = {}) => say(playerId, { k: 'hub-hello', avatar: 0, party: 2, ...more });
80
+ const tick = (ms = 50) => {
81
+ world.timeMs += ms;
82
+ server.place(world);
83
+ server.step(world, []);
84
+ };
85
+ const stepOnly = (ms = 50) => {
86
+ world.timeMs += ms;
87
+ server.step(world, []);
88
+ };
89
+ hello('p1'); hello('p2'); tick(2000); tick(50);
90
+ const sameBodyHello = (playerId = 'p1') => {
91
+ const retained = world.players.get(playerId);
92
+ const member = session.players.find((player) => player.playerId === playerId);
93
+ session.players = session.players.filter((player) => player.playerId !== playerId);
94
+ session.players.push(structuredClone(member));
95
+ assert.equal(world.players.get(playerId), retained);
96
+ hello(playerId, { resume: true });
97
+ };
98
+ const observedAwayReturn = (playerId = 'p1') => {
99
+ const retained = world.players.get(playerId);
100
+ const member = session.players.find((player) => player.playerId === playerId);
101
+ session.players = session.players.filter((player) => player.playerId !== playerId);
102
+ world.players.delete(playerId);
103
+ world.timeMs += 50;
104
+ server.place(world);
105
+ session.players.push(structuredClone(member));
106
+ world.players.set(playerId, retained);
107
+ server.place(world);
108
+ };
109
+ return { server, session, world, sent, say, hello, tick, stepOnly, sameBodyHello, observedAwayReturn, hub: () => hub };
110
+ }
111
+
112
+ const anonymousRoster = (userId) => members.map((member) => member.playerId === 'p1'
113
+ ? { ...member, userId, isAnonymous: true }
114
+ : member);
115
+
116
+ const failures = [];
117
+ async function test(name, run) {
118
+ try {
119
+ await run();
120
+ console.log(`ok: ${name}`);
121
+ } catch (error) {
122
+ failures.push(error);
123
+ console.error(`not ok: ${name}\n${error.stack}`);
124
+ }
125
+ }
126
+
127
+ await test('Ribbon-style aged matching final pair is cancelled before score and result', () => {
128
+ const state = { pending: null, done: 8, score: 8, terminal: false, resumes: 0, actions: 0 };
129
+ let r;
130
+ r = boot({
131
+ action(ctx, playerId, actionId) {
132
+ state.actions += 1;
133
+ if (playerId === 'p1' && actionId === 'reveal' && !state.pending) state.pending = { age: 0 };
134
+ },
135
+ step(ctx) {
136
+ if (!state.pending || ++state.pending.age < 2) return;
137
+ state.pending = null;
138
+ state.done += 1;
139
+ state.score += 1;
140
+ state.terminal = true;
141
+ ctx.result('p1', { score: state.score });
142
+ },
143
+ resume() { state.resumes += 1; state.pending = null; },
144
+ });
145
+ r.hub().actions('p1', [{ id: 'reveal', label: 'Reveal' }]);
146
+ r.tick(250);
147
+ const offer = r.sent.findLast(([id, msg]) => id === 'p1' && msg.k === 'hub-actions')[1];
148
+ r.say('p1', { k: 'hub-action', id: 'reveal', n: offer.n });
149
+ r.tick();
150
+ assert.equal(state.pending?.age, 1, 'the valid final-pair intent spent its first delay step');
151
+ const resultCount = r.sent.filter(([, msg]) => msg.k === 'hub-result').length;
152
+ r.sameBodyHello();
153
+ for (let i = 0; i < 8; i += 1) {
154
+ r.say('p1', { k: 'hub-action', id: 'reveal', n: offer.n });
155
+ }
156
+ r.tick();
157
+ assert.deepEqual(
158
+ { done: state.done, score: state.score, terminal: state.terminal, pending: state.pending, resumes: state.resumes, actions: state.actions },
159
+ { done: 8, score: 8, terminal: false, pending: null, resumes: 1, actions: 1 },
160
+ );
161
+ assert.equal(r.sent.filter(([, msg]) => msg.k === 'hub-result').length, resultCount);
162
+ r.say('p1', { k: 'hub-action', id: 'reveal', n: offer.n });
163
+ assert.equal(state.actions, 1, 'rejected pending actions still spend the existing budget');
164
+ r.tick(2000);
165
+ r.say('p1', { k: 'hub-action', id: 'reveal', n: offer.n });
166
+ assert.equal(state.actions, 2, 'the existing action budget refills normally');
167
+ });
168
+
169
+ await test('Showcase-style queued completion is cancelled before its authored step', () => {
170
+ const state = { pendingCompletion: false, completed: 0, resumes: 0 };
171
+ const r = boot({
172
+ step() {
173
+ if (state.pendingCompletion) { state.pendingCompletion = false; state.completed += 1; }
174
+ },
175
+ resume() { state.resumes += 1; state.pendingCompletion = false; },
176
+ });
177
+ state.pendingCompletion = true;
178
+ r.sameBodyHello();
179
+ r.tick();
180
+ assert.deepEqual(state, { pendingCompletion: false, completed: 0, resumes: 1 });
181
+ });
182
+
183
+ const anonymousIdentities = [
184
+ ['null', null],
185
+ ['decimal', '101'],
186
+ ['hex', '7fa2bc'],
187
+ ];
188
+
189
+ for (const [identityKind, identity] of anonymousIdentities) {
190
+ await test(`anonymous ${identityKind} Case A cannot dispatch a cached immediate reveal`, () => {
191
+ const state = { reveals: 0, leaves: 0, arrivals: 0, steps: 0 };
192
+ const r = boot({
193
+ arrive(ctx, group) { if (group.some(({ playerId }) => playerId === 'p1')) state.arrivals += 1; },
194
+ leave(ctx, playerId) { if (playerId === 'p1') state.leaves += 1; },
195
+ action(ctx, playerId, actionId) {
196
+ if (playerId === 'p1' && actionId === 'reveal') {
197
+ state.reveals += 1;
198
+ ctx.result(playerId, { score: 9 });
199
+ }
200
+ },
201
+ step() { state.steps += 1; },
202
+ resume() { assert.fail('an anonymous retained visit must not resume'); },
203
+ }, optedIn, anonymousRoster(identity));
204
+ r.hub().actions('p1', [{ id: 'reveal', label: 'Reveal' }]);
205
+ r.tick(250);
206
+ const offer = r.sent.findLast(([id, msg]) => id === 'p1' && msg.k === 'hub-actions')[1];
207
+ const results = r.sent.filter(([, msg]) => msg.k === 'hub-result').length;
208
+ const beforeSteps = state.steps;
209
+ r.sameBodyHello();
210
+ r.say('p1', { k: 'hub-action', id: 'reveal', n: offer.n });
211
+ assert.deepEqual(
212
+ { reveals: state.reveals, leaves: state.leaves, arrivals: state.arrivals },
213
+ { reveals: 0, leaves: 1, arrivals: 1 },
214
+ 'cleanup is synchronous and the replacement entry has not arrived',
215
+ );
216
+ assert.equal(r.sent.filter(([, msg]) => msg.k === 'hub-result').length, results);
217
+ assert.equal(r.hub().actions('p1', [{ id: 'reveal', label: 'Reveal' }]), false,
218
+ 'the fresh waiting entry has no cached action state');
219
+ r.tick();
220
+ assert.equal(state.steps, beforeSteps + 1, 'the ordinary global step continues');
221
+ assert.equal(state.reveals, 0);
222
+ assert.equal(r.sent.filter(([, msg]) => msg.k === 'hub-result').length, results);
223
+ r.hello('p1', { party: 1 });
224
+ r.tick();
225
+ assert.equal(state.arrivals, 2, 'the next ordinary hello arrives as a fresh visit');
226
+ });
227
+ }
228
+
229
+ for (const [identityKind, identity] of anonymousIdentities) {
230
+ await test(`anonymous ${identityKind} Case B observed return clears an aged final pair`, () => {
231
+ const state = { pending: null, done: 8, score: 8, terminal: false, actions: 0, leaves: 0, arrivals: 0, steps: 0 };
232
+ const r = boot({
233
+ arrive(ctx, group) { if (group.some(({ playerId }) => playerId === 'p1')) state.arrivals += 1; },
234
+ leave(ctx, playerId) {
235
+ if (playerId === 'p1') { state.leaves += 1; state.pending = null; }
236
+ },
237
+ action(ctx, playerId, actionId) {
238
+ if (playerId === 'p1' && actionId === 'reveal') {
239
+ state.actions += 1;
240
+ state.pending ??= { age: 0 };
241
+ }
242
+ },
243
+ step(ctx) {
244
+ state.steps += 1;
245
+ if (!state.pending || ++state.pending.age < 2) return;
246
+ state.pending = null;
247
+ state.done += 1;
248
+ state.score += 1;
249
+ state.terminal = true;
250
+ ctx.result('p1', { score: state.score });
251
+ },
252
+ resume() { assert.fail('an anonymous retained visit must not resume'); },
253
+ }, optedIn, anonymousRoster(identity));
254
+ r.hub().actions('p1', [{ id: 'reveal', label: 'Reveal' }]);
255
+ r.tick(250);
256
+ const offer = r.sent.findLast(([id, msg]) => id === 'p1' && msg.k === 'hub-actions')[1];
257
+ r.say('p1', { k: 'hub-action', id: 'reveal', n: offer.n });
258
+ r.tick();
259
+ assert.equal(state.pending?.age, 1);
260
+ const results = r.sent.filter(([, msg]) => msg.k === 'hub-result').length;
261
+ const beforeSteps = state.steps;
262
+ r.observedAwayReturn();
263
+ r.say('p1', { k: 'hub-action', id: 'reveal', n: offer.n });
264
+ assert.deepEqual(
265
+ { done: state.done, score: state.score, terminal: state.terminal, pending: state.pending,
266
+ actions: state.actions, leaves: state.leaves, arrivals: state.arrivals },
267
+ { done: 8, score: 8, terminal: false, pending: null, actions: 1, leaves: 1, arrivals: 2 },
268
+ 'observed-away cleanup precedes the synthetic fresh arrival',
269
+ );
270
+ assert.equal(r.sent.filter(([, msg]) => msg.k === 'hub-result').length, results);
271
+ r.tick();
272
+ assert.equal(state.steps, beforeSteps + 1, 'the ordinary global step continues after cleanup');
273
+ assert.equal(state.terminal, false);
274
+ });
275
+ }
276
+
277
+ for (const [identityKind, identity] of anonymousIdentities) {
278
+ await test(`anonymous ${identityKind} Showcase completion is cleared before the next step`, () => {
279
+ const state = { pendingCompletion: false, completed: 0, leaves: 0, arrivals: 0, steps: 0 };
280
+ const r = boot({
281
+ arrive(ctx, group) { if (group.some(({ playerId }) => playerId === 'p1')) state.arrivals += 1; },
282
+ leave(ctx, playerId) {
283
+ if (playerId === 'p1') { state.leaves += 1; state.pendingCompletion = false; }
284
+ },
285
+ step() {
286
+ state.steps += 1;
287
+ if (state.pendingCompletion) { state.pendingCompletion = false; state.completed += 1; }
288
+ },
289
+ resume() { assert.fail('an anonymous retained visit must not resume'); },
290
+ }, optedIn, anonymousRoster(identity));
291
+ const beforeSteps = state.steps;
292
+ state.pendingCompletion = true;
293
+ r.sameBodyHello();
294
+ assert.deepEqual(
295
+ { pendingCompletion: state.pendingCompletion, completed: state.completed, leaves: state.leaves, arrivals: state.arrivals },
296
+ { pendingCompletion: false, completed: 0, leaves: 1, arrivals: 1 },
297
+ 'cleanup runs before the fresh entry can arrive',
298
+ );
299
+ r.tick();
300
+ assert.equal(state.steps, beforeSteps + 1, 'the ordinary global step continues');
301
+ assert.equal(state.completed, 0);
302
+ r.hello('p1', { party: 1 });
303
+ r.tick();
304
+ assert.equal(state.arrivals, 2);
305
+ });
306
+ }
307
+
308
+ for (const userId of [null, '101', '7fa2bc']) {
309
+ for (const companionAt of ['before', 'after']) {
310
+ await test(`anonymous ${String(userId)} silent fresh accepts its real companion ${companionAt} the first pose step`, () => {
311
+ const state = { pending: false, mutations: 0, results: 0, leaves: 0, arrivals: 0, resumes: 0, steps: 0 };
312
+ const r = boot({
313
+ arrive(ctx, group) { if (group.some(({ playerId }) => playerId === 'p1')) state.arrivals += 1; },
314
+ leave(ctx, playerId) {
315
+ if (playerId === 'p1') { state.leaves += 1; state.pending = false; }
316
+ },
317
+ action(ctx, playerId, actionId) {
318
+ if (playerId === 'p1' && actionId === 'reveal') {
319
+ state.mutations += 1;
320
+ state.results += 1;
321
+ ctx.result(playerId, { score: state.results });
322
+ }
323
+ },
324
+ step(ctx) {
325
+ state.steps += 1;
326
+ if (state.pending) {
327
+ state.pending = false;
328
+ state.mutations += 1;
329
+ state.results += 1;
330
+ ctx.result('p1', { score: state.results });
331
+ }
332
+ },
333
+ resume() { state.resumes += 1; },
334
+ }, optedIn, anonymousRoster(userId));
335
+ r.hub().actions('p1', [{ id: 'reveal', label: 'Reveal' }]);
336
+ r.tick(250);
337
+ const offer = r.sent.findLast(([id, msg]) => id === 'p1' && msg.k === 'hub-actions')[1];
338
+ const resultMessages = r.sent.filter(([, msg]) => msg.k === 'hub-result').length;
339
+ state.pending = true;
340
+ r.observedAwayReturn();
341
+ const stepsAfterFreshArrival = state.steps;
342
+ if (companionAt === 'after') r.stepOnly();
343
+ r.hello('p1', { resume: true, party: 1 });
344
+ r.say('p1', { k: 'hub-action', id: 'reveal', n: offer.n });
345
+ assert.deepEqual(
346
+ { pending: state.pending, mutations: state.mutations, results: state.results,
347
+ leaves: state.leaves, arrivals: state.arrivals, resumes: state.resumes },
348
+ { pending: false, mutations: 0, results: 0, leaves: 1, arrivals: 2, resumes: 0 },
349
+ 'the companion neither re-ends nor resumes the silent fresh visit',
350
+ );
351
+ assert.equal(r.sent.filter(([, msg]) => msg.k === 'hub-result').length, resultMessages);
352
+ r.tick();
353
+ assert.equal(state.leaves, 1);
354
+ assert.equal(state.arrivals, 2);
355
+ assert.equal(state.resumes, 0);
356
+ assert.equal(state.mutations, 0);
357
+ assert.equal(state.results, 0);
358
+ assert.ok(state.steps > stepsAfterFreshArrival, 'ordinary authored stepping continues');
359
+ });
360
+ }
361
+
362
+ }
363
+
364
+ for (const returnKind of ['same-body', 'observed-away', 'observed-away-companion']) {
365
+ await test(`committed signed ${returnKind} resume precedes its new platform read`, async () => {
366
+ const order = [];
367
+ const state = { pending: false, terminals: 0, resumes: 0, leaves: 0, steps: 0, resets: 0 };
368
+ const r = boot({
369
+ resume() { order.push('resume'); state.resumes += 1; state.pending = false; },
370
+ progressReset() { state.resets += 1; },
371
+ leave(ctx, id) { if (id === 'p1') state.leaves += 1; },
372
+ step() { state.steps += 1; if (state.pending) state.terminals += 1; },
373
+ });
374
+ r.session.storage = { async playthrough() { return { resetGeneration: 0 }; } };
375
+ await r.hub().refreshProgress('p1');
376
+ await r.hub().refreshProgress('p2');
377
+ const read = deferred();
378
+ r.session.storage = { playthrough() { order.push('read'); return read.promise; } };
379
+ state.pending = true;
380
+ const from = r.sent.length;
381
+ const before = state.steps;
382
+ if (returnKind === 'same-body') r.sameBodyHello();
383
+ else r.observedAwayReturn();
384
+ if (returnKind === 'observed-away-companion') r.hello('p1', { resume: true });
385
+ r.tick();
386
+ assert.deepEqual(order, ['resume', 'read']);
387
+ assert.deepEqual(state, { pending: false, terminals: 0, resumes: 1, leaves: 0, steps: before + 1, resets: 0 });
388
+ assert.equal(r.sent.slice(from).filter(([id, msg]) => id === 'p1' && msg.k === 'hub-end').length, 0);
389
+ r.tick();
390
+ assert.equal(state.steps, before + 2, 'a pending read never holds the place');
391
+ assert.equal(state.resumes, 1);
392
+ read.resolve({ resetGeneration: 1 });
393
+ await flush();
394
+ r.tick();
395
+ assert.equal(state.leaves, 0);
396
+ assert.equal(state.resets, 1, 'a newer marker still runs generation cleanup');
397
+ assert.equal(state.resumes, 1, 'read completion cannot replay resume');
398
+ });
399
+ }
400
+
401
+ for (const resetGeneration of [0, 1]) {
402
+ await test(`ended retained replay waits for deferred marker ${resetGeneration}`, async () => {
403
+ const r = boot({ resume() {} });
404
+ r.session.storage = { async playthrough() { return { resetGeneration: 0 }; } };
405
+ await r.hub().refreshProgress('p1');
406
+ r.hub().end(['p1']);
407
+ const read = deferred();
408
+ r.session.storage = { playthrough() { return read.promise; } };
409
+ const from = r.sent.length;
410
+ r.sameBodyHello();
411
+ const ends = () => r.sent.slice(from).filter(([id, msg]) => id === 'p1' && msg.k === 'hub-end');
412
+ assert.equal(ends().length, 0, 'hello cannot replay an end before checking the marker');
413
+ r.tick();
414
+ assert.equal(ends().length, 0, 'resume preparation cannot replay an unchecked end');
415
+ read.resolve({ resetGeneration });
416
+ await flush();
417
+ assert.equal(ends().length, resetGeneration ? 0 : 1,
418
+ 'a newer reset cancels stale end replay; an unchanged marker releases it');
419
+ });
420
+ }
421
+
422
+ await test('an existing read on a committed retained identity still blocks preparation', async () => {
423
+ const state = { resumes: 0, leaves: 0, steps: 0 };
424
+ const r = boot({
425
+ resume() { state.resumes += 1; },
426
+ leave(ctx, id) { if (id === 'p1') state.leaves += 1; },
427
+ step() { state.steps += 1; },
428
+ });
429
+ r.session.storage = { async playthrough() { return { resetGeneration: 0 }; } };
430
+ await r.hub().refreshProgress('p1');
431
+ const read = deferred();
432
+ r.session.storage = { playthrough() { return read.promise; } };
433
+ const pending = r.hub().refreshProgress('p1');
434
+ const before = state.steps;
435
+ r.sameBodyHello();
436
+ r.tick();
437
+ assert.deepEqual(state, { resumes: 0, leaves: 1, steps: before + 1 });
438
+ read.resolve({ resetGeneration: 1 });
439
+ await pending;
440
+ await flush();
441
+ r.tick();
442
+ assert.equal(state.resumes, 0, 'late reads cannot revive an ended retained visit');
443
+ assert.equal(state.leaves, 1);
444
+ });
445
+
446
+ await test('marker-absent places retain authored-step then late-resume ordering', () => {
447
+ const order = [];
448
+ const r = boot({ step() { order.push('step'); }, resume() { order.push('resume'); } }, {
449
+ result: { score: { unit: 'points', better: 'higher' } }, resume: { keep: true }, actions: true,
450
+ });
451
+ order.length = 0;
452
+ const from = r.sent.length;
453
+ r.sameBodyHello();
454
+ r.tick();
455
+ assert.deepEqual(order, ['step', 'resume']);
456
+ assert.deepEqual(r.sent.slice(from), [
457
+ ['p1', { k: 'hub-actions', items: null, n: 0 }],
458
+ ['p1', { k: 'hub-hud', hud: null }],
459
+ ['p1', { k: 'hub-tune', tune: null }],
460
+ ['p1', { k: 'hub-labels', labels: {} }],
461
+ ['p1', { k: 'hub-vis', hide: [], show: [] }],
462
+ ['p1', { k: 'hub-av', hubAv: {} }],
463
+ ]);
464
+ });
465
+
466
+ await test('trusted identity replacement cancels preparation before the early hook', () => {
467
+ const events = [];
468
+ const r = boot({ step() { events.push('step'); }, resume() { events.push('resume'); } });
469
+ r.sameBodyHello();
470
+ r.session.players = r.session.players.map((member) => member.playerId === 'p1'
471
+ ? { ...member, userId: '999', username: 'Eve' }
472
+ : member);
473
+ events.length = 0;
474
+ r.tick();
475
+ assert.deepEqual(events, ['step']);
476
+ });
477
+
478
+ for (const mode of ['throw', 'reject', 'never']) {
479
+ await test(`progressReset ${mode} ends only the retained visit and never holds the place`, async () => {
480
+ const open = deferred();
481
+ const state = { oldPending: false, terminals: 0, p2Steps: 0, resumes: 0, leaves: 0, p1Arrivals: 0 };
482
+ const r = boot({
483
+ arrive(ctx, group) { if (group.some(({ playerId }) => playerId === 'p1')) state.p1Arrivals += 1; },
484
+ leave(ctx, playerId) {
485
+ if (playerId === 'p1') {
486
+ state.leaves += 1;
487
+ state.oldPending = false;
488
+ }
489
+ },
490
+ step() {
491
+ state.p2Steps += 1;
492
+ if (state.oldPending) state.terminals += 1;
493
+ },
494
+ resume() { state.resumes += 1; },
495
+ progressReset() {
496
+ if (mode === 'throw') throw new Error('reset failed');
497
+ if (mode === 'reject') return Promise.reject(new Error('reset failed'));
498
+ return open.promise;
499
+ },
500
+ });
501
+ r.hub().actions('p1', [{ id: 'choose', label: 'Choose' }]);
502
+ r.hub().hide('token', { to: ['p1'] });
503
+ r.tick(250);
504
+ state.oldPending = true;
505
+ r.session.storage = { async playthrough() { return { generation: 1, resetGeneration: 1 }; } };
506
+ r.sameBodyHello('p1');
507
+ await flush();
508
+ const beforeSteps = state.p2Steps;
509
+ const fromEnd = r.sent.length;
510
+ r.tick();
511
+ assert.deepEqual(
512
+ { resumes: state.resumes, leaves: state.leaves, p2Steps: state.p2Steps, terminals: state.terminals },
513
+ { resumes: 0, leaves: 1, p2Steps: beforeSteps + 1, terminals: 0 },
514
+ );
515
+ assert.equal(r.sent.slice(fromEnd).filter(([id, msg]) => id === 'p1' && msg.k === 'hub-end').length, 1);
516
+ assert.equal(r.hub().actions('p1', [{ id: 'choose', label: 'Choose' }]), false,
517
+ 'normal forget removes the retained action entry');
518
+
519
+ delete r.session.storage;
520
+ const freshFrom = r.sent.length;
521
+ r.hello('p1', { party: 1 });
522
+ r.tick(2000);
523
+ r.tick();
524
+ assert.equal(state.p1Arrivals, 2, 'the next hello is a fresh authored arrival');
525
+ assert.equal(state.resumes, 0, 'the failed retained visit is not resumed later');
526
+ const fresh = r.sent.slice(freshFrom).filter(([id]) => id === 'p1');
527
+ assert.ok(fresh.some(([, msg]) => msg.k === 'hub-actions' && msg.items === null),
528
+ 'a fresh visit has no cached action offer');
529
+ assert.ok(
530
+ fresh.filter(([, msg]) => msg.k === 'hub-vis')
531
+ .every(([, msg]) => !msg.hide.includes('token') && !msg.show.includes('token')),
532
+ 'a fresh visit has no retained private visibility',
533
+ );
534
+
535
+ if (mode === 'never') {
536
+ open.resolve();
537
+ await flush();
538
+ r.tick();
539
+ assert.deepEqual({ leaves: state.leaves, resumes: state.resumes }, { leaves: 1, resumes: 0 },
540
+ 'late completion cannot finalize the replacement visit');
541
+ }
542
+ });
543
+ }
544
+
545
+ await test('a synchronous resume failure ends the retained visit before authored stepping', () => {
546
+ const state = { pending: false, terminal: false, resumes: 0, leaves: 0, steps: 0 };
547
+ const r = boot({
548
+ resume() { state.resumes += 1; throw new Error('resume failed'); },
549
+ leave(ctx, playerId) { if (playerId === 'p1') { state.leaves += 1; state.pending = false; } },
550
+ step() { state.steps += 1; if (state.pending) state.terminal = true; },
551
+ });
552
+ const before = state.steps;
553
+ const from = r.sent.length;
554
+ state.pending = true;
555
+ r.sameBodyHello();
556
+ r.tick();
557
+ assert.deepEqual(state, { pending: false, terminal: false, resumes: 1, leaves: 1, steps: before + 1 });
558
+ assert.equal(r.sent.slice(from).filter(([id, msg]) => id === 'p1' && msg.k === 'hub-end').length, 1);
559
+ r.tick();
560
+ assert.equal(state.leaves, 1, 'failed resume leaves exactly once');
561
+ });
562
+
563
+ await test('reentrant retained hello ends the new retained visit without pausing the place', () => {
564
+ let r;
565
+ let resumes = 0;
566
+ let steps = 0;
567
+ let actions = 0;
568
+ let leaves = 0;
569
+ r = boot({
570
+ step() { steps += 1; },
571
+ action() { actions += 1; },
572
+ leave(ctx, playerId) { if (playerId === 'p1') leaves += 1; },
573
+ resume(ctx, { playerId }) {
574
+ resumes += 1;
575
+ if (resumes === 1) r.hello(playerId, { resume: true });
576
+ },
577
+ });
578
+ r.hub().actions('p1', [{ id: 'choose', label: 'Choose' }]);
579
+ r.tick(250);
580
+ const offer = r.sent.findLast(([id, msg]) => id === 'p1' && msg.k === 'hub-actions')[1];
581
+ const before = steps;
582
+ r.sameBodyHello();
583
+ r.tick();
584
+ assert.equal(resumes, 1);
585
+ assert.equal(leaves, 1, 'the hook-created retained visit ends through ordinary leave cleanup');
586
+ assert.equal(steps, before + 1, 'another player never waits on reentrant preparation');
587
+ for (let i = 0; i < 8; i += 1) r.say('p1', { k: 'hub-action', id: 'choose', n: offer.n });
588
+ assert.equal(actions, 0, 'the ended visit cannot dispatch its cached action');
589
+ r.tick();
590
+ assert.equal(resumes, 1);
591
+ assert.equal(leaves, 1);
592
+ assert.equal(steps, before + 2);
593
+ });
594
+
595
+ if (failures.length) {
596
+ throw new AggregateError(failures, `${failures.length} resume action-order test(s) failed`);
597
+ }
598
+ console.log('test-resume-action-order: 30 passed');