castle-web-cli 0.4.232 → 0.4.233

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 (355) hide show
  1. package/dist/agent-failures.d.ts +8 -0
  2. package/dist/agent-failures.js +19 -2
  3. package/dist/agent-prompts.d.ts +1 -1
  4. package/dist/agent-prompts.js +10 -3
  5. package/dist/agent.d.ts +64 -3
  6. package/dist/agent.js +170 -81
  7. package/dist/castle-host/host.d.ts +1 -0
  8. package/dist/castle-host/host.js +51 -3
  9. package/dist/castleJson.d.ts +4 -2
  10. package/dist/castleJson.js +2 -0
  11. package/dist/check.d.ts +3 -1
  12. package/dist/check.js +11 -1
  13. package/dist/devSessionStorage.js +47 -1
  14. package/dist/importPinMismatch.d.ts +22 -0
  15. package/dist/importPinMismatch.js +77 -0
  16. package/dist/importRegression.js +3 -15
  17. package/dist/imports.d.ts +10 -3
  18. package/dist/imports.js +88 -20
  19. package/dist/index.js +5 -4
  20. package/dist/init.js +1 -1
  21. package/dist/platformDoc.js +22 -0
  22. package/dist/routerFences.d.ts +5 -0
  23. package/dist/routerFences.js +12 -2
  24. package/dist/save-deck.d.ts +5 -0
  25. package/dist/save-deck.js +37 -4
  26. package/dist/serve.js +3 -0
  27. package/dist/shell/assets/{index-D2tWM896.js → index-BjOxR-lW.js} +4 -4
  28. package/dist/shell/assets/index-MVLfNYd9.css +1 -0
  29. package/dist/shell/index.html +2 -2
  30. package/dist/taskSteer.d.ts +13 -0
  31. package/dist/taskSteer.js +22 -2
  32. package/kits/base/castle.json +1 -1
  33. package/kits/base/package-lock.json +1 -1
  34. package/kits/base/sdk/README.md +79 -2
  35. package/kits/base/sdk/avatar.d.ts +6 -2
  36. package/kits/base/sdk/avatar.js +12 -4
  37. package/kits/base/sdk/castle.d.ts +1 -1
  38. package/kits/base/sdk/commands.d.ts +14 -0
  39. package/kits/base/sdk/hub.d.ts +6 -2
  40. package/kits/base/sdk/hub.js +13 -0
  41. package/kits/base/sdk/multiplayer.js +17 -1
  42. package/kits/base/sdk/save.js +2 -1
  43. package/kits/base/sdk/server/hub.d.ts +87 -0
  44. package/kits/base/sdk/server/hub.js +70 -0
  45. package/kits/base/sdk/server/platformHandle.d.ts +31 -1
  46. package/kits/base/sdk/server/storage.d.ts +13 -0
  47. package/kits/base/sdk/server/storage.js +46 -0
  48. package/kits/base/sdk/server/wrapper.d.ts +36 -5
  49. package/kits/base/sdk/server/wrapper.js +83 -8
  50. package/kits/hub-game/CLAUDE.md +329 -11
  51. package/kits/hub-game/blueprints/avatar-10.scene +28 -0
  52. package/kits/hub-game/blueprints/avatar-11.scene +28 -0
  53. package/kits/hub-game/blueprints/avatar-12.scene +28 -0
  54. package/kits/hub-game/blueprints/avatar-13.scene +28 -0
  55. package/kits/hub-game/blueprints/avatar-14.scene +28 -0
  56. package/kits/hub-game/blueprints/avatar-15.scene +28 -0
  57. package/kits/hub-game/blueprints/avatar-4.scene +28 -0
  58. package/kits/hub-game/blueprints/avatar-5.scene +28 -0
  59. package/kits/hub-game/blueprints/avatar-6.scene +28 -0
  60. package/kits/hub-game/blueprints/avatar-7.scene +28 -0
  61. package/kits/hub-game/blueprints/avatar-8.scene +28 -0
  62. package/kits/hub-game/blueprints/avatar-9.scene +28 -0
  63. package/kits/hub-game/code/client/actorBudget.js +47 -0
  64. package/kits/hub-game/code/client/attention.js +11 -2
  65. package/kits/hub-game/code/client/avatar.js +309 -35
  66. package/kits/hub-game/code/client/avatarCap.js +228 -0
  67. package/kits/hub-game/code/client/avatarColors.js +70 -0
  68. package/kits/hub-game/code/client/avatarFaces.js +21 -0
  69. package/kits/hub-game/code/client/avatarShare.js +251 -0
  70. package/kits/hub-game/code/client/ballot.js +467 -0
  71. package/kits/hub-game/code/client/build.js +22 -0
  72. package/kits/hub-game/code/client/chrome.js +1144 -50
  73. package/kits/hub-game/code/client/companion.js +716 -0
  74. package/kits/hub-game/code/client/companionDress.js +99 -0
  75. package/kits/hub-game/code/client/decor.js +509 -0
  76. package/kits/hub-game/code/client/earned.js +131 -0
  77. package/kits/hub-game/code/client/emoteBubble.js +75 -0
  78. package/kits/hub-game/code/client/grab.js +339 -20
  79. package/kits/hub-game/code/client/hookLayer.js +299 -13
  80. package/kits/hub-game/code/client/idle.js +163 -22
  81. package/kits/hub-game/code/client/interestCap.js +81 -0
  82. package/kits/hub-game/code/client/keys.js +36 -0
  83. package/kits/hub-game/code/client/labelsNear.js +205 -0
  84. package/kits/hub-game/code/client/menuIcons.js +34 -0
  85. package/kits/hub-game/code/client/pack.js +6 -2
  86. package/kits/hub-game/code/client/packFormat.js +3 -3
  87. package/kits/hub-game/code/client/rehello.js +167 -0
  88. package/kits/hub-game/code/client/shot.js +92 -0
  89. package/kits/hub-game/code/client/sound.js +63 -8
  90. package/kits/hub-game/code/client/soundscape.js +1151 -0
  91. package/kits/hub-game/code/client/soundscapeActions.js +99 -0
  92. package/kits/hub-game/code/client/soundscapeAmbience.js +453 -0
  93. package/kits/hub-game/code/client/soundscapeBaked.js +143 -0
  94. package/kits/hub-game/code/client/soundscapeBusker.js +217 -0
  95. package/kits/hub-game/code/client/soundscapeCourt.js +200 -0
  96. package/kits/hub-game/code/client/soundscapeCrowd.js +331 -0
  97. package/kits/hub-game/code/client/soundscapeCues.js +362 -0
  98. package/kits/hub-game/code/client/soundscapeMap.js +181 -0
  99. package/kits/hub-game/code/client/soundscapeMarket.js +176 -0
  100. package/kits/hub-game/code/client/soundscapeMusic.js +126 -0
  101. package/kits/hub-game/code/client/soundscapeMusicEngine.js +460 -0
  102. package/kits/hub-game/code/client/soundscapeSimlish.js +737 -0
  103. package/kits/hub-game/code/client/soundscapeSongs.js +127 -0
  104. package/kits/hub-game/code/client/soundscapeSongsRound3.js +63 -0
  105. package/kits/hub-game/code/client/soundscapeSynthesis.js +168 -0
  106. package/kits/hub-game/code/client/soundscapeUi.js +211 -0
  107. package/kits/hub-game/code/client/soundscapeVoice.js +1209 -0
  108. package/kits/hub-game/code/client/soundscapeWaves.js +206 -0
  109. package/kits/hub-game/code/client/spin.js +101 -0
  110. package/kits/hub-game/code/client/state.js +109 -1
  111. package/kits/hub-game/code/client/stuck.js +259 -0
  112. package/kits/hub-game/code/client/talk.js +538 -47
  113. package/kits/hub-game/code/client/tiers.js +516 -27
  114. package/kits/hub-game/code/client/toastBand.js +37 -0
  115. package/kits/hub-game/code/client/together.js +32 -0
  116. package/kits/hub-game/code/client/visibility.js +43 -0
  117. package/kits/hub-game/code/client/wear.js +461 -170
  118. package/kits/hub-game/code/client/yours.js +199 -0
  119. package/kits/hub-game/code/companionSpec.js +45 -0
  120. package/kits/hub-game/code/privateText.js +7 -0
  121. package/kits/hub-game/code/server/actions.js +133 -0
  122. package/kits/hub-game/code/server/actors.js +9 -1
  123. package/kits/hub-game/code/server/ask.js +155 -0
  124. package/kits/hub-game/code/server/ballot.js +539 -0
  125. package/kits/hub-game/code/server/cells.js +100 -0
  126. package/kits/hub-game/code/server/companion.js +82 -0
  127. package/kits/hub-game/code/server/cues.js +70 -0
  128. package/kits/hub-game/code/server/decor.js +269 -0
  129. package/kits/hub-game/code/server/earned.js +461 -0
  130. package/kits/hub-game/code/server/friendBests.js +166 -0
  131. package/kits/hub-game/code/server/friendsAmong.js +232 -0
  132. package/kits/hub-game/code/server/history.js +5 -0
  133. package/kits/hub-game/code/server/hub.js +1254 -50
  134. package/kits/hub-game/code/server/idle.js +30 -11
  135. package/kits/hub-game/code/server/index.js +2 -2
  136. package/kits/hub-game/code/server/labels.js +28 -2
  137. package/kits/hub-game/code/server/manifest.js +378 -7
  138. package/kits/hub-game/code/server/menu.js +133 -0
  139. package/kits/hub-game/code/server/npcs.js +830 -80
  140. package/kits/hub-game/code/server/party.js +2 -2
  141. package/kits/hub-game/code/server/players.js +22 -0
  142. package/kits/hub-game/code/server/shot.js +110 -0
  143. package/kits/hub-game/code/server/standing.js +124 -0
  144. package/kits/hub-game/code/server/vis.js +113 -0
  145. package/kits/hub-game/code/server/wear.js +12 -0
  146. package/kits/hub-game/code/server/yours.js +59 -0
  147. package/kits/hub-game/code/shared/cues.js +9 -0
  148. package/kits/hub-game/code/shared/decor.js +41 -0
  149. package/kits/hub-game/code/shared/shot.js +19 -0
  150. package/kits/hub-game/code/shared/spin.js +57 -0
  151. package/kits/hub-game/code/systems/hub.js +845 -95
  152. package/kits/hub-game/docs/content-pack.md +1 -1
  153. package/kits/hub-game/docs/contract.md +2244 -61
  154. package/kits/hub-game/docs/home-pieces.md +64 -0
  155. package/kits/hub-game/models/avatar-10.pxmodel +28 -0
  156. package/kits/hub-game/models/avatar-11.pxmodel +28 -0
  157. package/kits/hub-game/models/avatar-12.pxmodel +27 -0
  158. package/kits/hub-game/models/avatar-13.pxmodel +24 -0
  159. package/kits/hub-game/models/avatar-14.pxmodel +29 -0
  160. package/kits/hub-game/models/avatar-15.pxmodel +24 -0
  161. package/kits/hub-game/models/avatar-4.pxmodel +29 -0
  162. package/kits/hub-game/models/avatar-5.pxmodel +27 -0
  163. package/kits/hub-game/models/avatar-6.pxmodel +26 -0
  164. package/kits/hub-game/models/avatar-7.pxmodel +25 -0
  165. package/kits/hub-game/models/avatar-8.pxmodel +24 -0
  166. package/kits/hub-game/models/avatar-9.pxmodel +30 -0
  167. package/kits/hub-game/models/earned/badge-round.pxmodel +100 -0
  168. package/kits/hub-game/models/earned/badge-shield.pxmodel +117 -0
  169. package/kits/hub-game/models/earned/badge-star.pxmodel +87 -0
  170. package/kits/hub-game/models/earned/belt-plain.pxmodel +72 -0
  171. package/kits/hub-game/models/earned/held-ball.pxmodel +43 -0
  172. package/kits/hub-game/models/earned/held-lantern.pxmodel +85 -0
  173. package/kits/hub-game/models/earned/held-net.pxmodel +57 -0
  174. package/kits/hub-game/models/earned/held-trophy.pxmodel +109 -0
  175. package/kits/hub-game/models/earned/pin-round.pxmodel +62 -0
  176. package/kits/hub-game/models/earned/sash-plain.pxmodel +66 -0
  177. package/kits/hub-game/models/earned/square/belt-plain.pxmodel +104 -0
  178. package/kits/hub-game/models/earned/square/sash-plain.pxmodel +98 -0
  179. package/kits/hub-game/models/hats/bat-clip.pxmodel +206 -0
  180. package/kits/hub-game/models/hats/beekeeper.pxmodel +149 -0
  181. package/kits/hub-game/models/hats/cap.pxmodel +162 -0
  182. package/kits/hub-game/models/hats/captain.pxmodel +178 -0
  183. package/kits/hub-game/models/hats/crooked-top.pxmodel +172 -0
  184. package/kits/hub-game/models/hats/flower-crown.pxmodel +451 -0
  185. package/kits/hub-game/models/hats/foam-crown.pxmodel +179 -0
  186. package/kits/hub-game/models/hats/lantern.pxmodel +230 -0
  187. package/kits/hub-game/models/hats/laurel.pxmodel +533 -0
  188. package/kits/hub-game/models/hats/lighthouse.pxmodel +96 -0
  189. package/kits/hub-game/models/hats/sailor.pxmodel +141 -0
  190. package/kits/hub-game/models/hats/souwester.pxmodel +131 -0
  191. package/kits/hub-game/models/hats/straw.pxmodel +139 -0
  192. package/kits/hub-game/models/hats/sunflower.pxmodel +406 -0
  193. package/kits/hub-game/models/hats/sweatband.pxmodel +112 -0
  194. package/kits/hub-game/models/hats/witch.pxmodel +147 -0
  195. package/kits/hub-game/package-lock.json +2 -0
  196. package/kits/hub-game/package.json +2 -1
  197. package/kits/hub-game/scripts/check.mjs +78 -11
  198. package/kits/hub-game/scripts/companion-follower-wire.json +1 -0
  199. package/kits/hub-game/scripts/fixtures/decor-keyless-draw.json +121 -0
  200. package/kits/hub-game/scripts/fixtures/decor-keyless.json +293 -0
  201. package/kits/hub-game/scripts/fixtures/engine-models-stub.mjs +23 -0
  202. package/kits/hub-game/scripts/fixtures/fake-dom.mjs +107 -0
  203. package/kits/hub-game/scripts/fixtures/interest-legacy.json +385 -0
  204. package/kits/hub-game/scripts/fixtures/npc-notes-v1.77.jsonl +4 -0
  205. package/kits/hub-game/scripts/fixtures/vis-shared-wire.json +1 -0
  206. package/kits/hub-game/scripts/gen-avatars.mjs +933 -16
  207. package/kits/hub-game/scripts/gen-earned.mjs +285 -0
  208. package/kits/hub-game/scripts/gen-hats.mjs +827 -0
  209. package/kits/hub-game/scripts/grab.before-orbit.mjs +400 -0
  210. package/kits/hub-game/scripts/soundscape-wave-analysis.mjs +125 -0
  211. package/kits/hub-game/scripts/test-actions-client.mjs +488 -0
  212. package/kits/hub-game/scripts/test-actions.mjs +298 -0
  213. package/kits/hub-game/scripts/test-actor-budget.mjs +44 -0
  214. package/kits/hub-game/scripts/test-actors.mjs +19 -17
  215. package/kits/hub-game/scripts/test-ask-client.mjs +358 -0
  216. package/kits/hub-game/scripts/test-ask.mjs +269 -0
  217. package/kits/hub-game/scripts/test-attention.mjs +10 -1
  218. package/kits/hub-game/scripts/test-avatar-cap.mjs +379 -0
  219. package/kits/hub-game/scripts/test-avatar-colors.mjs +72 -0
  220. package/kits/hub-game/scripts/test-avatar-models.mjs +181 -0
  221. package/kits/hub-game/scripts/test-avatar-share.mjs +318 -0
  222. package/kits/hub-game/scripts/test-avatar-wire.mjs +753 -0
  223. package/kits/hub-game/scripts/test-avatar.mjs +540 -7
  224. package/kits/hub-game/scripts/test-ballot.mjs +1001 -0
  225. package/kits/hub-game/scripts/test-build.mjs +31 -0
  226. package/kits/hub-game/scripts/test-cells.mjs +71 -0
  227. package/kits/hub-game/scripts/test-chat.mjs +662 -0
  228. package/kits/hub-game/scripts/test-classic.mjs +2 -0
  229. package/kits/hub-game/scripts/test-companion-chat.mjs +198 -0
  230. package/kits/hub-game/scripts/test-companion-client.mjs +1167 -0
  231. package/kits/hub-game/scripts/test-companion.mjs +259 -0
  232. package/kits/hub-game/scripts/test-decor-client.mjs +303 -0
  233. package/kits/hub-game/scripts/test-decor.mjs +457 -0
  234. package/kits/hub-game/scripts/test-earned-client.mjs +459 -0
  235. package/kits/hub-game/scripts/test-earned.mjs +1194 -0
  236. package/kits/hub-game/scripts/test-emote-bubble.mjs +110 -0
  237. package/kits/hub-game/scripts/test-friend-bests.mjs +435 -0
  238. package/kits/hub-game/scripts/test-grab-orbit.mjs +918 -0
  239. package/kits/hub-game/scripts/test-grab.mjs +7 -0
  240. package/kits/hub-game/scripts/test-hats.mjs +422 -168
  241. package/kits/hub-game/scripts/test-hub-leaving.mjs +203 -0
  242. package/kits/hub-game/scripts/test-hub-ops.mjs +439 -2
  243. package/kits/hub-game/scripts/test-hub-trip.mjs +716 -2
  244. package/kits/hub-game/scripts/test-hud-clear.mjs +328 -4
  245. package/kits/hub-game/scripts/test-idle.mjs +361 -1
  246. package/kits/hub-game/scripts/test-interest-cap.mjs +36 -0
  247. package/kits/hub-game/scripts/test-interest-cells.mjs +493 -0
  248. package/kits/hub-game/scripts/test-interest-client.mjs +118 -0
  249. package/kits/hub-game/scripts/test-keys.mjs +46 -1
  250. package/kits/hub-game/scripts/test-labels.mjs +596 -0
  251. package/kits/hub-game/scripts/test-manifest.mjs +207 -0
  252. package/kits/hub-game/scripts/test-menu-client.mjs +480 -0
  253. package/kits/hub-game/scripts/test-menu.mjs +296 -0
  254. package/kits/hub-game/scripts/test-npcs.mjs +1718 -12
  255. package/kits/hub-game/scripts/test-object-entry.mjs +76 -0
  256. package/kits/hub-game/scripts/test-pack.mjs +7 -0
  257. package/kits/hub-game/scripts/test-picker.mjs +314 -0
  258. package/kits/hub-game/scripts/test-rehello.mjs +1039 -0
  259. package/kits/hub-game/scripts/test-relations-among.mjs +222 -0
  260. package/kits/hub-game/scripts/test-relations-refresh.mjs +188 -0
  261. package/kits/hub-game/scripts/test-shot.mjs +756 -0
  262. package/kits/hub-game/scripts/test-soundscape.mjs +5432 -0
  263. package/kits/hub-game/scripts/test-spin.mjs +314 -0
  264. package/kits/hub-game/scripts/test-standing.mjs +416 -0
  265. package/kits/hub-game/scripts/test-stuck.mjs +1903 -0
  266. package/kits/hub-game/scripts/test-tier-cells.mjs +706 -0
  267. package/kits/hub-game/scripts/test-tiers-render.mjs +339 -0
  268. package/kits/hub-game/scripts/test-tiers.mjs +477 -2
  269. package/kits/hub-game/scripts/test-toast-band.mjs +61 -0
  270. package/kits/hub-game/scripts/test-try-on.mjs +22 -22
  271. package/kits/hub-game/scripts/test-vis.mjs +343 -0
  272. package/kits/hub-game/scripts/test-visibility.mjs +134 -0
  273. package/kits/hub-game/scripts/test-yours-chrome.mjs +166 -0
  274. package/kits/hub-game/scripts/test-yours.mjs +372 -0
  275. package/kits/multiplayer-3d/CLAUDE.md +50 -0
  276. package/kits/multiplayer-3d/castle.json +5 -5
  277. package/kits/multiplayer-3d/code/client/avatars.js +7 -0
  278. package/kits/multiplayer-3d/code/client/gait.js +65 -0
  279. package/kits/multiplayer-3d/code/client/nameTags.js +59 -4
  280. package/kits/multiplayer-3d/code/options.js +5 -0
  281. package/kits/multiplayer-3d/code/server/ownership.js +10 -2
  282. package/kits/multiplayer-3d/code/server/sceneBodies.js +12 -0
  283. package/kits/multiplayer-3d/code/server/world.js +7 -0
  284. package/kits/multiplayer-3d/code/systems/multiplayer.js +74 -4
  285. package/kits/multiplayer-3d/package.json +2 -1
  286. package/kits/multiplayer-3d/scripts/fixtures/README.md +11 -0
  287. package/kits/multiplayer-3d/scripts/fixtures/ownership-legacy.json +2 -0
  288. package/kits/multiplayer-3d/scripts/ownership-harness.mjs +102 -0
  289. package/kits/multiplayer-3d/scripts/ownership-loader.mjs +46 -0
  290. package/kits/multiplayer-3d/scripts/ownership-worker.mjs +15 -0
  291. package/kits/multiplayer-3d/scripts/record-ownership-session.mjs +98 -0
  292. package/kits/multiplayer-3d/scripts/test-eligible-claims.mjs +167 -0
  293. package/kits/multiplayer-3d/scripts/test-own-name-tag.mjs +247 -0
  294. package/kits/physics-2d/CLAUDE.md +9 -0
  295. package/kits/physics-2d/castle.json +2 -2
  296. package/kits/physics-2d/engine/scene.js +253 -1
  297. package/kits/physics-2d/engine/skyKey.js +129 -0
  298. package/kits/physics-2d/engine/stillClock.js +106 -0
  299. package/kits/physics-2d/engine/updateBudget.js +21 -0
  300. package/kits/physics-2d/scripts/test-skip-unchanged.mjs +326 -1
  301. package/kits/physics-3d/CLAUDE.md +1169 -30
  302. package/kits/physics-3d/behaviors/Player.jsx +629 -72
  303. package/kits/physics-3d/castle.json +3 -3
  304. package/kits/physics-3d/docs/pxmodel-format.md +8 -0
  305. package/kits/physics-3d/engine3d/Scene3DPlayer.jsx +69 -13
  306. package/kits/physics-3d/engine3d/actornode.js +86 -0
  307. package/kits/physics-3d/engine3d/animationBudget.js +23 -0
  308. package/kits/physics-3d/engine3d/editorWorld.js +6 -0
  309. package/kits/physics-3d/engine3d/emptynodes.js +232 -0
  310. package/kits/physics-3d/engine3d/framecap.js +96 -0
  311. package/kits/physics-3d/engine3d/gait.js +118 -0
  312. package/kits/physics-3d/engine3d/kithooks.js +47 -0
  313. package/kits/physics-3d/engine3d/look.js +507 -48
  314. package/kits/physics-3d/engine3d/lookbake.js +208 -0
  315. package/kits/physics-3d/engine3d/materialpresets.js +2 -0
  316. package/kits/physics-3d/engine3d/motion.js +39 -10
  317. package/kits/physics-3d/engine3d/nearshadows.js +37 -19
  318. package/kits/physics-3d/engine3d/optimize.js +9 -5
  319. package/kits/physics-3d/engine3d/orbitinput.js +487 -9
  320. package/kits/physics-3d/engine3d/orbitlens.js +48 -0
  321. package/kits/physics-3d/engine3d/ownmodel.js +213 -0
  322. package/kits/physics-3d/engine3d/pxmodel.js +42 -11
  323. package/kits/physics-3d/engine3d/shadowfade.js +882 -0
  324. package/kits/physics-3d/engine3d/sky.js +547 -0
  325. package/kits/physics-3d/engine3d/skylife.js +306 -0
  326. package/kits/physics-3d/engine3d/unchanged.js +11 -0
  327. package/kits/physics-3d/engine3d/viewrange.js +52 -0
  328. package/kits/physics-3d/engine3d/world3d.js +796 -69
  329. package/kits/physics-3d/main.jsx +5 -0
  330. package/kits/physics-3d/package.json +1 -1
  331. package/kits/physics-3d/scripts/look-baseline.mjs +155 -0
  332. package/kits/physics-3d/scripts/test-camera-orbit.mjs +2563 -80
  333. package/kits/physics-3d/scripts/test-drop-empty-parts.mjs +1 -1
  334. package/kits/physics-3d/scripts/test-frame-cap-bob.mjs +435 -0
  335. package/kits/physics-3d/scripts/test-frame-cap.mjs +452 -0
  336. package/kits/physics-3d/scripts/test-gait.mjs +387 -0
  337. package/kits/physics-3d/scripts/test-look-bake.mjs +1056 -0
  338. package/kits/physics-3d/scripts/test-model-parse-cache.mjs +92 -0
  339. package/kits/physics-3d/scripts/test-near-shadows.mjs +3 -0
  340. package/kits/physics-3d/scripts/test-orbit-shadow-fade.mjs +1920 -0
  341. package/kits/physics-3d/scripts/test-orbit-shift-lock.mjs +545 -0
  342. package/kits/physics-3d/scripts/test-orbit-shot.mjs +583 -0
  343. package/kits/physics-3d/scripts/test-orbit-view.mjs +230 -0
  344. package/kits/physics-3d/scripts/test-skip-empty-nodes.mjs +845 -0
  345. package/kits/physics-3d/scripts/test-sky.mjs +2470 -0
  346. package/kits/physics-3d/scripts/test-static-actors.mjs +8 -1
  347. package/kits/physics-3d/scripts/test-static-scenery.mjs +2171 -0
  348. package/kits/physics-3d/scripts/test-steady-hover.mjs +2 -0
  349. package/kits/physics-3d/scripts/test-view-range.mjs +260 -0
  350. package/kits/physics-3d/systems/physics3d.js +383 -6
  351. package/kits/real-time/castle.json +2 -2
  352. package/kits/real-time/code/server/gameHooks.js +7 -0
  353. package/kits/real-time/code/server/session.js +97 -19
  354. package/package.json +2 -2
  355. package/dist/shell/assets/index-Cf61cNfT.css +0 -1
@@ -9,7 +9,7 @@
9
9
  import assert from 'node:assert/strict';
10
10
  import { register } from 'node:module';
11
11
 
12
- const sdkStub = 'export const Hub = globalThis.__tripHub;';
12
+ const sdkStub = 'export const Hub = globalThis.__tripHub; export const User = { getCurrent: async () => { globalThis.__yoursUserReads = (globalThis.__yoursUserReads ?? 0) + 1; return { userId: \"101\", isAnonymous: false }; } };';
13
13
  const packStub = `
14
14
  export const loadPack = (...args) => globalThis.__tripLoadPack(...args);
15
15
  export const cachedPacks = () => [];
@@ -22,6 +22,8 @@ register(
22
22
  'data:text/javascript,' +
23
23
  encodeURIComponent(`
24
24
  export async function resolve(specifier, context, next) {
25
+ if (['pxmodel', 'optimize', 'look', 'lookbake'].some((m) => specifier === '@imports/castle.physics-3d/engine3d/' + m)) return { url: ${JSON.stringify(new URL('./fixtures/engine-models-stub.mjs', import.meta.url).href)}, shortCircuit: true };
26
+ if (specifier === '@imports/castle.physics-3d/engine3d/orbitlens.js') return { url: ${JSON.stringify(new URL('../../physics-3d/engine3d/orbitlens.js', import.meta.url).href)}, shortCircuit: true };
25
27
  if (specifier === 'castle-web-sdk') {
26
28
  return { url: ${JSON.stringify('data:text/javascript,' + encodeURIComponent(sdkStub))}, shortCircuit: true };
27
29
  }
@@ -90,6 +92,9 @@ globalThis.__tripLoadPack = async (sha, url) => {
90
92
 
91
93
  const { installSystem, BANNED_TEXT } = await import('../code/systems/hub.js');
92
94
  const HubState = await import('../code/client/state.js');
95
+ const ShotClient = await import('../code/client/shot.js');
96
+ const { receiveShot } = ShotClient;
97
+ const clearShot = () => ShotClient.clearShot();
93
98
  const { makeTogether } = await import('../code/client/together.js');
94
99
 
95
100
  const tick = () => new Promise((resolve) => setTimeout(resolve, 0));
@@ -1171,6 +1176,79 @@ await test('friends: asked from a place that is not a game; here and empty rows
1171
1176
  }
1172
1177
  });
1173
1178
 
1179
+ await test('friends wanted asks at once, after 20 s, then every 90 s, never a trip or keyless game', async () => {
1180
+ const { system, scene } = setup();
1181
+ const mp = { joinState: () => 'joined' };
1182
+ HubState.hub.place = { id: 'main', title: 'Game', result: { outcomes: ['win'] } };
1183
+ HubState.hub.friendsWanted = false;
1184
+ try {
1185
+ system.askFriends(scene, mp, 0);
1186
+ await flush();
1187
+ assert.deepEqual(calls, [], 'keyless game sends nothing');
1188
+ answers.friends = { status: 'ok', friends: [] };
1189
+ HubState.hub.friendsWanted = true;
1190
+ system.askFriends(scene, mp, 1);
1191
+ await flush();
1192
+ assert.deepEqual(calls, [['friends']], 'first idle tick on receipt');
1193
+ system.askFriends(scene, mp, 20000);
1194
+ await flush();
1195
+ assert.equal(calls.length, 1);
1196
+ system.trip = {};
1197
+ system.askFriends(scene, mp, 20001);
1198
+ await flush();
1199
+ assert.equal(calls.length, 1, 'trip sends nothing');
1200
+ system.trip = null;
1201
+ system.askFriends(scene, { joinState: () => 'joining' }, 20001);
1202
+ await flush();
1203
+ assert.equal(calls.length, 1, 'not yet joined');
1204
+ system.askFriends(scene, mp, 20001);
1205
+ await flush();
1206
+ assert.equal(calls.length, 2, 'warm-up ask after heartbeat roster');
1207
+ system.askFriends(scene, mp, 40001);
1208
+ system.askFriends(scene, mp, 110000);
1209
+ await flush();
1210
+ assert.equal(calls.length, 2, 'warm-up does not repeat');
1211
+ answers.friendsError = 'TIMEOUT';
1212
+ system.askFriends(scene, mp, 110001);
1213
+ await flush();
1214
+ assert.equal(system.friendsOff, false);
1215
+ answers.friendsError = 'UNKNOWN_COMMAND';
1216
+ system.askFriends(scene, mp, 200001);
1217
+ await flush();
1218
+ assert.equal(system.friendsOff, true);
1219
+ system.askFriends(scene, mp, 290001);
1220
+ await flush();
1221
+ assert.equal(calls.length, 4, 'unknown command stops all asks');
1222
+ } finally {
1223
+ HubState.hub.place = null;
1224
+ HubState.hub.friendsWanted = false;
1225
+ }
1226
+ });
1227
+
1228
+ await test('a failed first friends ask still warms up after 20 s', async () => {
1229
+ const { system, scene } = setup();
1230
+ const mp = { joinState: () => 'joined' };
1231
+ HubState.hub.place = { id: 'main', result: {} };
1232
+ HubState.hub.friendsWanted = true;
1233
+ try {
1234
+ answers.friendsError = 'TIMEOUT';
1235
+ system.askFriends(scene, mp, 0);
1236
+ await flush();
1237
+ assert.equal(system.friendsOff, false);
1238
+ answers.friendsError = null;
1239
+ answers.friends = { status: 'ok', friends: [] };
1240
+ system.askFriends(scene, mp, 19999);
1241
+ await flush();
1242
+ assert.equal(calls.length, 1);
1243
+ system.askFriends(scene, mp, 20000);
1244
+ await flush();
1245
+ assert.equal(calls.length, 2);
1246
+ } finally {
1247
+ HubState.hub.place = null;
1248
+ HubState.hub.friendsWanted = false;
1249
+ }
1250
+ });
1251
+
1174
1252
  await test('a door refused because the player is barred from the hub says so, and is not asked again', async () => {
1175
1253
  const { system, scene } = setup();
1176
1254
  answers.goError = 'CAULDRON_HUB_BANNED';
@@ -1522,7 +1600,7 @@ function cueChrome(system) {
1522
1600
  const seen = { toast: '', say: null, ask: null };
1523
1601
  system.chrome = {
1524
1602
  showBack() {}, showPicker() {}, setFriends() {}, setDoors() {}, setPeople() {}, setHud() {}, setLabels() {}, setRibbon() {},
1525
- setToast(text) { seen.toast = text; },
1603
+ setToast(text, options) { seen.toast = text; seen.toastOptions = options; },
1526
1604
  setSay(say) { seen.say = say; },
1527
1605
  setAsk(ask) { seen.ask = ask; },
1528
1606
  };
@@ -2026,6 +2104,642 @@ await test('cues: a party that gains a member says so; not the party a session i
2026
2104
  }
2027
2105
  });
2028
2106
 
2107
+ await test('v1.52: Back, hub-end then Back, local doors and Hub.go capture the leaving line; cabinets do not', async () => {
2108
+ try {
2109
+ for (const way of ['back', 'end', 'door', 'hub', 'classic']) {
2110
+ HubState.clear();
2111
+ HubState.hub.place = { id: 'main', title: 'Town' };
2112
+ HubState.hub.leaving = 'Your lantern is waiting';
2113
+ const { system, scene } = setup();
2114
+ if (way === 'back') system.back(scene);
2115
+ if (way === 'end') {
2116
+ HubState.hub.commands.push({ k: 'hub-end', why: 'end' });
2117
+ system.runCommands(scene, 1000);
2118
+ system.stepEnd(scene, { joinState: () => 'joined' }, 2200);
2119
+ }
2120
+ if (way === 'door') system.go(scene, { door: 'race', key: 'hub.race', title: 'Foot Race' });
2121
+ if (way === 'hub') {
2122
+ answers.go = handoff();
2123
+ system.goHub(scene, { door: 'race', title: 'Foot Race' });
2124
+ await flush();
2125
+ }
2126
+ if (way === 'classic') system.startTrip(scene, { classic: true, title: 'Cabinet' });
2127
+ assert.equal(system.trip.leaving, way === 'classic' ? null : 'Your lantern is waiting', way);
2128
+ const captured = system.trip.leaving;
2129
+ HubState.clear();
2130
+ assert.equal(system.trip.leaving, captured, 'captured across Hub.clear');
2131
+ }
2132
+ } finally { HubState.clear(); }
2133
+ });
2134
+
2135
+ await test('v1.52: a fast trip shows the line as soon as the cover lifts, expires at 2800 ms, and never waits', async () => {
2136
+ const saved = globalThis.performance;
2137
+ let now = 1000;
2138
+ globalThis.performance = { now: () => now };
2139
+ try {
2140
+ HubState.clear();
2141
+ HubState.hub.leaving = 'Next time, the well';
2142
+ const { system, scene } = setup();
2143
+ const seen = cueChrome(system);
2144
+ const covers = [];
2145
+ system.chrome.setCover = (...args) => covers.push(args);
2146
+ system.startTrip(scene, { scene: 'scenes/next.scene', title: 'Next', join: { mode: 'public' } });
2147
+ const trip = system.trip;
2148
+ const mp = mpStub(scene, 'joined');
2149
+ mp.placed = () => true;
2150
+ system.stepTrip(scene, mp, null, 1650);
2151
+ assert.equal(trip.phase, 'loading');
2152
+ assert.deepEqual(covers.at(-1), [1, 'Next', 'Next time, the well']);
2153
+ assert.equal(HubState.hub.leaving, null, 'switch clears the old place line');
2154
+ scene.currentScenePath = scene.requestedScene;
2155
+ scene.requestedScene = null;
2156
+ HubState.hub.arrivedFacing = 0;
2157
+ system.stepTrip(scene, mp, null, 1651);
2158
+ assert.equal(trip.phase, 'revealing');
2159
+ now = 2071; // 60% of reveal: cover lifted, trip still moving.
2160
+ system.stepTrip(scene, mp, null, now);
2161
+ system.drawChrome(scene, null, now);
2162
+ assert.equal(seen.toast, 'Next time, the well');
2163
+ assert.deepEqual(seen.toastOptions, { wrap: true });
2164
+ assert.equal(system.trip, trip);
2165
+ now = 2351;
2166
+ system.stepTrip(scene, mp, null, now);
2167
+ assert.equal(system.trip, null, 'finished on the ordinary 700 ms reveal deadline');
2168
+ system.drawChrome(scene, null, 3799);
2169
+ assert.equal(seen.toast, 'Next time, the well');
2170
+ system.drawChrome(scene, null, 3800);
2171
+ assert.equal(seen.toast, '');
2172
+ assert.equal(seen.toastOptions, undefined, 'ordinary toasts keep the original call');
2173
+ } finally { globalThis.performance = saved; HubState.clear(); }
2174
+ });
2175
+
2176
+ await test('v1.52: return result and leaving line share one bounded toast; result survives the line deadline', async () => {
2177
+ const saved = globalThis.performance;
2178
+ globalThis.performance = { now: () => 2000 };
2179
+ try {
2180
+ HubState.clear();
2181
+ const { system, scene } = setup();
2182
+ const seen = cueChrome(system);
2183
+ system.chrome.setCover = () => {};
2184
+ scene.persistent.hubResult = { title: 'Foot Race', outcome: 'win' };
2185
+ const trip = { n: 1, startedAt: 1000, leaving: 'Your lantern is waiting', leavingUntil: 3800,
2186
+ target: { scene: 'scenes/main.scene', arrive: { returning: true } },
2187
+ marks: { covered: 1650, arrived: 1700, firstFrame: 1800, revealed: 2000 } };
2188
+ system.finishTrip(scene, trip);
2189
+ system.drawChrome(scene, null, 2000);
2190
+ assert.match(seen.toast, /^Back from Foot Race.* · Your lantern is waiting$/);
2191
+ const resultToast = system.toast;
2192
+ system.drawChrome(scene, null, 3799);
2193
+ assert.match(seen.toast, / · Your lantern is waiting$/);
2194
+ system.drawChrome(scene, null, 3800);
2195
+ assert.equal(system.toast, resultToast);
2196
+ assert.match(seen.toast, /^Back from Foot Race/);
2197
+ assert.doesNotMatch(seen.toast, /Your lantern/);
2198
+ scene.persistent.hubResult.title = 'X'.repeat(300);
2199
+ trip.leaving = 'y'.repeat(120);
2200
+ system.showLeaving(scene, trip, 2000);
2201
+ assert.ok(system.leavingToast.text.length <= 203);
2202
+ } finally { globalThis.performance = saved; HubState.clear(); }
2203
+ });
2204
+
2205
+ await test('v1.52: newer action feedback supersedes leaving, across reveal frames and the arrival result', async () => {
2206
+ const saved = globalThis.performance;
2207
+ let now = 2000;
2208
+ globalThis.performance = { now: () => now };
2209
+ try {
2210
+ for (const returning of [false, true]) {
2211
+ HubState.clear();
2212
+ const { system, scene } = setup();
2213
+ const seen = cueChrome(system);
2214
+ system.chrome.setCover = () => {};
2215
+ scene.persistent.hubResult = { title: 'Foot Race', outcome: 'win' };
2216
+ const trip = { n: 1, startedAt: 1000, leaving: 'Your lantern is waiting', leavingUntil: 3800,
2217
+ target: { scene: 'scenes/main.scene', arrive: { returning } },
2218
+ marks: { covered: 1650, arrived: 1700, firstFrame: 1800, revealed: 2200 } };
2219
+ system.toast = { text: 'Older feedback', until: 6000 };
2220
+ system.showLeaving(scene, trip, now);
2221
+ system.drawChrome(scene, null, now);
2222
+ assert.match(seen.toast, /Your lantern is waiting$/);
2223
+ // Real People-list action after the leaving toast starts.
2224
+ scene.multiplayer.net = { send() {} };
2225
+ now = 2100;
2226
+ system.join(scene, { playerId: 'ada', username: 'Ada' }, 'invite');
2227
+ const feedback = system.toast;
2228
+ system.drawChrome(scene, null, now);
2229
+ assert.equal(seen.toast, 'Invited Ada to your party');
2230
+ assert.equal(seen.toastOptions, undefined);
2231
+ now = 2200;
2232
+ system.showLeaving(scene, trip, now);
2233
+ system.finishTrip(scene, trip);
2234
+ system.drawChrome(scene, null, now);
2235
+ assert.equal(system.toast, feedback, 'arrival result does not overwrite newer feedback');
2236
+ assert.equal(seen.toast, 'Invited Ada to your party');
2237
+ // Expired newer feedback must not uncover the old leaving line again.
2238
+ feedback.until = 2300;
2239
+ system.drawChrome(scene, null, 2400);
2240
+ assert.equal(seen.toast, '');
2241
+ now = 2000;
2242
+ }
2243
+ } finally { globalThis.performance = saved; HubState.clear(); }
2244
+ });
2245
+
2246
+ await test('v1.52: replacement trips retain the first line and deadline after Hub.clear', async () => {
2247
+ const saved = globalThis.performance;
2248
+ let now = 1000;
2249
+ globalThis.performance = { now: () => now };
2250
+ try {
2251
+ for (const way of ['back', 'door', 'door-nested', 'jump', 'jump-nested', 'lost', 'mount']) {
2252
+ now = 1000;
2253
+ HubState.clear();
2254
+ HubState.hub.leaving = 'Next time, the well';
2255
+ const { system, scene } = setup();
2256
+ const mp = mpStub(scene);
2257
+ answers.go = handoff();
2258
+ answers.jump = handoff();
2259
+ answers.back = handoff();
2260
+ if (['back', 'door-nested', 'jump-nested'].includes(way)) {
2261
+ scene.persistent.hubDepth = 1;
2262
+ scene.persistent.hubTickets.push({ hub: true, scene: 'scenes/main.scene', title: 'Town', join: { mode: 'public' } });
2263
+ scene.multiplayer.target = { mode: 'hub', handoff: handoff({ nonce: 'spent' }) };
2264
+ }
2265
+ if (way === 'back') system.back(scene);
2266
+ else if (way.startsWith('jump')) system.jump(scene, { userId: 'ada', username: 'Ada' });
2267
+ else system.goHub(scene, { door: 'race', title: 'Foot Race' });
2268
+ await flush();
2269
+ const first = system.trip;
2270
+ assert.equal(first.leavingUntil, first.startedAt + 2800);
2271
+ system.stepTrip(scene, mp, null, 1650);
2272
+ assert.equal(first.phase, 'committing', way);
2273
+ assert.equal(HubState.hub.leaving, null);
2274
+ now = 1800;
2275
+ if (way === 'lost' || way === 'mount') {
2276
+ mp.state = 'joined';
2277
+ system.stepTrip(scene, mp, null, now);
2278
+ assert.equal(first.phase, 'loading');
2279
+ if (way === 'lost') mp.state = 'lost';
2280
+ else scene.mountError = new Error('could not mount');
2281
+ now = 1900;
2282
+ } else {
2283
+ mp.state = 'failed';
2284
+ }
2285
+ system.stepTrip(scene, mp, null, now);
2286
+ await flush();
2287
+ const replacement = system.trip;
2288
+ assert.notEqual(replacement, first, way);
2289
+ assert.equal(replacement.leaving, 'Next time, the well', way);
2290
+ assert.equal(replacement.leavingUntil, 3800, `${way}: deadline never restarts`);
2291
+ const covers = [];
2292
+ system.chrome.setCover = (...args) => covers.push(args);
2293
+ system.setTripCover(1, replacement);
2294
+ assert.equal(covers.at(-1)[2], first.leaving);
2295
+ system.showLeaving(scene, replacement, 3799);
2296
+ assert.equal(system.leavingToast.text, first.leaving);
2297
+ system.leavingToast = null;
2298
+ system.showLeaving(scene, replacement, 3800);
2299
+ assert.equal(system.leavingToast, null, `${way}: no toast beyond the original deadline`);
2300
+ }
2301
+ } finally { globalThis.performance = saved; HubState.clear(); }
2302
+ });
2303
+
2304
+ await test('v1.52: end-triggered Back retries after exhausted join attempts retain the original deadline', async () => {
2305
+ const saved = globalThis.performance;
2306
+ let now = 1000;
2307
+ globalThis.performance = { now: () => now };
2308
+ try {
2309
+ HubState.clear();
2310
+ HubState.hub.leaving = 'Next time, the well';
2311
+ const { system, scene } = setup();
2312
+ scene.persistent.hubDepth = 1;
2313
+ scene.persistent.hubTickets.push({ hub: true, scene: 'scenes/main.scene', title: 'Town', join: { mode: 'public' } });
2314
+ answers.back = handoff();
2315
+ HubState.hub.commands.push({ k: 'hub-end' });
2316
+ system.runCommands(scene, 0);
2317
+ system.back(scene);
2318
+ const first = system.trip;
2319
+ HubState.clear();
2320
+ now = 1800;
2321
+ system.uncommitted(scene, first, now);
2322
+ const retry = system.trip;
2323
+ assert.equal(retry.leaving, first.leaving);
2324
+ assert.equal(retry.leavingUntil, 3800);
2325
+ now = 2000;
2326
+ system.uncommitted(scene, retry, now);
2327
+ assert.equal(system.trip, null, 'ordinary retry exhausted');
2328
+ now = 3900;
2329
+ system.stepEnd(scene, { joinState: () => 'failed' }, now);
2330
+ assert.equal(system.trip.leaving, first.leaving);
2331
+ assert.equal(system.trip.leavingUntil, 3800, 'end retry cannot extend the toast');
2332
+ system.showLeaving(scene, system.trip, now);
2333
+ assert.equal(system.leavingToast, null);
2334
+ await flush();
2335
+ scene.multiplayer.target = { mode: 'named', key: 'another-visit' };
2336
+ system.settleEnd(scene);
2337
+ assert.equal(system.endLeaving, null);
2338
+ } finally { globalThis.performance = saved; HubState.clear(); }
2339
+ });
2340
+
2341
+ await test('v1.52: a slow trip keeps its cover line and creates no expired arrival toast; no-line trips keep the old cover arguments', async () => {
2342
+ try {
2343
+ HubState.clear();
2344
+ const { system, scene } = setup();
2345
+ const covers = [];
2346
+ system.chrome.setCover = (...args) => covers.push(args);
2347
+ system.startTrip(scene, { title: 'Town' });
2348
+ system.setTripCover(1, system.trip);
2349
+ assert.deepEqual(covers.at(-1), [1, 'Town']);
2350
+ const trip = system.trip;
2351
+ trip.leaving = 'The well is waiting';
2352
+ system.setTripCover(1, trip);
2353
+ assert.deepEqual(covers.at(-1), [1, 'Town', 'The well is waiting']);
2354
+ system.showLeaving(scene, trip, trip.leavingUntil + 1);
2355
+ assert.equal(system.leavingToast, null);
2356
+ trip.shut = 'full';
2357
+ system.setTripCover(1, trip);
2358
+ assert.deepEqual(covers.at(-1), [1, 'Town']);
2359
+ system.showLeaving(scene, trip, trip.startedAt + 1);
2360
+ assert.equal(system.leavingToast, null, 'a door that stayed shut has no arrival line');
2361
+ } finally { HubState.clear(); }
2362
+ });
2363
+
2364
+ await test('v1.52: hubLeaving is a bounded localhost fixture, ignored by hosted pages and classic cabinets', async () => {
2365
+ const saved = globalThis.location;
2366
+ try {
2367
+ HubState.clear();
2368
+ for (const hostname of ['localhost', '127.0.0.1', 'castle.xyz']) {
2369
+ globalThis.location = { hostname, search: '?hubLeaving=%20' + 'x'.repeat(140) + '%20' };
2370
+ const { system, scene } = setup();
2371
+ system.startTrip(scene, { title: 'Town' });
2372
+ assert.equal(system.trip.leaving, hostname === 'castle.xyz' ? null : 'x'.repeat(120));
2373
+ system.trip = null;
2374
+ system.startTrip(scene, { title: 'Cabinet', classic: true });
2375
+ assert.equal(system.trip.leaving, null);
2376
+ }
2377
+ } finally { globalThis.location = saved; HubState.clear(); }
2378
+ });
2379
+
2380
+ await test('yourGames v1.54: keyless sends nothing; offers obey party, solo, invitation, game and trip rules', async () => {
2381
+ try {
2382
+ const { system, scene } = setup();
2383
+ const seen = cueChrome(system);
2384
+ system.chrome.setCover = () => {};
2385
+ const sent = townNet(scene, new Map([['p2', 'bo']]), { p2: '102' });
2386
+ HubState.hub.place = { title: 'Town', result: null };
2387
+ HubState.hub.doors = [{ id: 'race', title: 'Foot Race' }, { id: 'solo', title: 'Sprint', solo: true }];
2388
+ HubState.hub.yours = { rows: [{ door: 'race', title: 'Foot Race', line: 'Best 10 s · today', hearted: true }], hearts: ['race'] };
2389
+ let heartReads = 0;
2390
+ globalThis.__tripHub.hearts = async () => { heartReads++; return { status: 'ok', hearts: ['race'] }; };
2391
+ HubState.deck.yourGames = false;
2392
+ const before = globalThis.__yoursUserReads ?? 0;
2393
+ system.drawChrome(scene, null, performance.now());
2394
+ await flush();
2395
+ assert.equal(system.yours, undefined);
2396
+ assert.equal(heartReads, 0);
2397
+ assert.equal(globalThis.__yoursUserReads ?? 0, before, 'keyless reads no account');
2398
+ assert.equal(seen.ask, null);
2399
+ HubState.deck.yourGames = true;
2400
+ HubState.deck.cues = true;
2401
+ system.drawChrome(scene, null, performance.now());
2402
+ await flush();
2403
+ system.drawChrome(scene, null, performance.now());
2404
+ assert.equal(heartReads, 1);
2405
+ assert.deepEqual([seen.ask.kind, seen.ask.text, seen.ask.line, seen.ask.yes], ['yours', '♥ Foot Race', 'Best 10 s · today', 'Go']);
2406
+ system.answer(scene, seen.ask, false);
2407
+ system.drawChrome(scene, null, performance.now());
2408
+ assert.equal(seen.ask, null, 'dismissed once');
2409
+ const back = (door) => {
2410
+ const at = performance.now();
2411
+ system.finishTrip(scene, { n: 1, startedAt: at, marks: { covered: at, arrived: at, firstFrame: at, revealed: at }, target: { arrive: { door, returning: true } } });
2412
+ };
2413
+ back('race');
2414
+ HubState.hub.party.members = ['p2'];
2415
+ system.drawChrome(scene, null, performance.now());
2416
+ assert.equal(seen.ask.yes, 'Go together');
2417
+ assert.equal(seen.ask.heart, true);
2418
+ system.answer(scene, seen.ask, true);
2419
+ assert.deepEqual(sent.splice(0), [{ k: 'hub-party', op: 'go', door: 'race' }]);
2420
+ scene.persistent.hubResult = { title: 'Sprint', score: 14, unit: 's' };
2421
+ back('solo');
2422
+ system.drawChrome(scene, null, performance.now());
2423
+ assert.deepEqual([seen.ask.door, seen.ask.yes, system.againAsk], ['solo', 'Go', null]);
2424
+ assert.equal(seen.ask.line, 'Last 14 s · today', 'return outside the top five still has a personal line');
2425
+ HubState.hub.party.invite = { from: 'p2', username: 'bo' };
2426
+ system.drawChrome(scene, null, performance.now());
2427
+ assert.equal(seen.ask.kind, 'invite');
2428
+ HubState.hub.party.invite = null;
2429
+ HubState.hub.party.proposal = { asked: false, door: 'race' };
2430
+ system.drawChrome(scene, null, performance.now());
2431
+ assert.equal(seen.ask, null, 'no offer over any proposal');
2432
+ HubState.hub.party.proposal = null;
2433
+ HubState.hub.place.result = {};
2434
+ system.drawChrome(scene, null, performance.now());
2435
+ assert.equal(seen.ask, null, 'never in a game');
2436
+ HubState.hub.place.result = null;
2437
+ system.trip = { phase: 'open' };
2438
+ system.drawChrome(scene, null, performance.now());
2439
+ assert.equal(seen.ask, null, 'never during a trip');
2440
+ assert.equal(heartReads, 1);
2441
+ } finally {
2442
+ HubState.deck.yourGames = false;
2443
+ HubState.hub.yours = null;
2444
+ delete globalThis.__tripHub.hearts;
2445
+ delete globalThis.__yoursUserReads;
2446
+ resetTown();
2447
+ }
2448
+ });
2449
+
2450
+ // v1.61: exercise the production lifecycle methods, including direct door
2451
+ // travel that starts without a hub-go message.
2452
+ for (const [name, leave] of [
2453
+ ['door trip', (system, scene) => system.startTrip(scene, { scene: 'scenes/next.scene' })],
2454
+ ['leaving the session', (system, scene) => {
2455
+ scene.multiplayer.switchSession = () => {};
2456
+ system.leaveSession(scene, scene.multiplayer);
2457
+ }],
2458
+ ['same-scene load', (system, scene) => system.reset(scene)],
2459
+ ['entering another scene', (system, scene) => system.enterScene(scene)],
2460
+ ['disconnect', (system, scene) => {
2461
+ system.lastNet = { closed: () => true };
2462
+ scene.multiplayer.net = null;
2463
+ system.watchSession(scene, scene.multiplayer);
2464
+ }],
2465
+ ['runtime disposal', (system) => { system.chrome = null; system.dispose(); }],
2466
+ ]) {
2467
+ for (const deckOwns of [false, true]) {
2468
+ await test(`v1.61: ${name} clears only a hub-owned shot (deck owns: ${deckOwns})`, () => {
2469
+ HubState.clear();
2470
+ const { system, scene } = setup();
2471
+ scene.cameraControl = 'orbit';
2472
+ const pose = { look: { x: 1, y: 2, z: 3 }, distance: 8, pitch: 30, yaw: 45 };
2473
+ try {
2474
+ receiveShot(scene, pose);
2475
+ if (deckOwns) { scene.orbitShot = pose; }
2476
+ leave(system, scene);
2477
+ assert.equal(scene.orbitShot, deckOwns ? pose : undefined);
2478
+ assert.equal(Object.hasOwn(HubState.hub, 'shot'), false);
2479
+ } finally {
2480
+ clearShot();
2481
+ }
2482
+ });
2483
+ }
2484
+ }
2485
+
2486
+ // A connection the session let go and took back (a phone's app switch): the
2487
+ // real-time server sends a WORLD snapshot each time it gives a connection a
2488
+ // body, and the client's hub system greets again when a second one is drained.
2489
+ function fakeNet(selfId = 'p1') {
2490
+ const net = {
2491
+ sent: [],
2492
+ inbox: [],
2493
+ id: selfId,
2494
+ send(msg) {
2495
+ net.sent.push(msg);
2496
+ },
2497
+ selfId: () => net.id,
2498
+ drain() {
2499
+ const out = net.inbox;
2500
+ net.inbox = [];
2501
+ return out;
2502
+ },
2503
+ };
2504
+ return net;
2505
+ }
2506
+
2507
+ await test('every place: a connection the session took back on the same net says a fresh hello once; steady state sends none', async () => {
2508
+ for (const place of [{}, { decor: { grid: { x: 0, z: 0, w: 1, d: 1, cell: 1 } } }]) {
2509
+ const { system, scene } = setup();
2510
+ HubState.hub.place = place;
2511
+ scene.persistent.hubArriving = { door: 'race', party: 3, returning: true, near: '42' };
2512
+ scene.persistent.hubResult = { title: 'Race', outcome: 'win' };
2513
+ const net = fakeNet();
2514
+ const mp = { net, joined: false };
2515
+ const hellos = () => net.sent.filter((m) => m.k === 'hub-hello');
2516
+ system.sayHello(scene, mp);
2517
+ assert.equal(hellos().length, 1);
2518
+ assert.equal(hellos()[0].party, 3);
2519
+ // The join's own snapshot, then ordinary traffic: no hello again.
2520
+ net.inbox.push({ k: 'w' }, { k: 's' });
2521
+ net.drain();
2522
+ mp.joined = true;
2523
+ for (let i = 0; i < 20; i += 1) {
2524
+ net.inbox.push({ k: 's' }, { k: 'hub-hud' });
2525
+ net.drain();
2526
+ system.sayHello(scene, mp);
2527
+ }
2528
+ assert.equal(hellos().length, 1, 'steady state: no extra hello');
2529
+ // The drop: the session let the player go, the SDK resumed this net, and
2530
+ // the session gave it a body again (a WORLD, queued while frames stopped).
2531
+ const kept = { startNear: system.startNear, say: system.say, together: system.together };
2532
+ net.inbox.push({ k: 'w' });
2533
+ net.drain();
2534
+ system.sayHello(scene, mp);
2535
+ system.sayHello(scene, mp);
2536
+ assert.equal(hellos().length, 2, 'one fresh hello');
2537
+ const again = hellos()[1];
2538
+ assert.equal(again.resume, true);
2539
+ assert.equal(again.again, undefined, 'fresh: the place re-sends what it had sent');
2540
+ assert.equal(again.party, 1, 'from a party of one');
2541
+ assert.equal(again.carry, null, 'carrying nothing back twice');
2542
+ assert.equal(again.near, undefined);
2543
+ assert.equal(again.from, 'race');
2544
+ assert.equal(system.startNear, kept.startNear, 'session state kept');
2545
+ assert.equal(system.say, kept.say);
2546
+ // A second drop greets once more.
2547
+ net.inbox.push({ k: 'w' });
2548
+ net.drain();
2549
+ system.sayHello(scene, mp);
2550
+ assert.equal(hellos().length, 3);
2551
+ HubState.hub.place = null;
2552
+ delete scene.persistent.hubArriving;
2553
+ delete scene.persistent.hubResult;
2554
+ await flush();
2555
+ }
2556
+ });
2557
+
2558
+ await test('a resumed net under a new player id greets afresh; a new net still greets as before', async () => {
2559
+ const { system, scene } = setup();
2560
+ const net = fakeNet('p1');
2561
+ const mp = { net, joined: true };
2562
+ system.sayHello(scene, mp);
2563
+ net.id = 'p9';
2564
+ system.sayHello(scene, mp);
2565
+ const hellos = net.sent.filter((m) => m.k === 'hub-hello');
2566
+ assert.equal(hellos.length, 2);
2567
+ assert.equal(hellos[1].resume, true);
2568
+ system.sayHello(scene, mp);
2569
+ assert.equal(net.sent.filter((m) => m.k === 'hub-hello').length, 2, 'once');
2570
+ const other = fakeNet('p2');
2571
+ system.sayHello(scene, { net: other, joined: false });
2572
+ assert.equal(other.sent.length, 1);
2573
+ assert.equal(other.sent[0].resume, undefined, 'a new net is an ordinary hello');
2574
+ await flush();
2575
+ });
2576
+
2577
+ await test('a new player id on the same net clears the old session\'s private state before the new session\'s packets apply', async () => {
2578
+ // The private packets as the hook layer applies them (client/hookLayer.js).
2579
+ const apply = (msg) => {
2580
+ if (msg.k === 'hub-hud') HubState.hub.hudMe = msg.hud ?? null;
2581
+ if (msg.k === 'hub-tune') HubState.hub.tune = msg.tune;
2582
+ if (msg.k === 'hub-decor') HubState.hub.decor = { button: msg.button, spec: msg.spec, grid: msg.grid };
2583
+ if (msg.k === 'hub-leaving') HubState.hub.leaving = msg.text;
2584
+ if (msg.k === 'hub-ballot-card') BallotClient.gate(HubState.hub.place, net, msg.card);
2585
+ };
2586
+ const BallotClient = await import('../code/client/ballot.js');
2587
+ const { system, scene } = setup();
2588
+ system.scene = scene;
2589
+ const net = fakeNet('pA');
2590
+ const mp = { net, joined: true };
2591
+ scene.multiplayer = { ...scene.multiplayer, net };
2592
+ system.sayHello(scene, mp);
2593
+ // Session A sends this player its own HUD, tune, decor, leaving line,
2594
+ // labels, marks, a held spot, and a choice card.
2595
+ HubState.hub.place = { ballot: true };
2596
+ for (const msg of [
2597
+ { k: 'hub-hud', hud: { title: 'A only' } },
2598
+ { k: 'hub-tune', tune: { speed: 2 } },
2599
+ { k: 'hub-decor', button: 'Decorate', spec: {}, grid: null },
2600
+ { k: 'hub-leaving', text: 'A leaving' },
2601
+ { k: 'hub-ballot-card', card: { v: 'a-1', mode: 'talk', faces: [] } },
2602
+ ]) {
2603
+ apply(msg);
2604
+ }
2605
+ BallotClient.settle(HubState.hub.place);
2606
+ HubState.hub.labelsMe = { x: 'A label' };
2607
+ HubState.hub.marks = { x: 1 };
2608
+ HubState.hub.held.set?.('pA', true);
2609
+ HubState.hub.held.add?.('pA');
2610
+ assert.equal(HubState.hub.hudMe.title, 'A only');
2611
+ assert.ok(BallotClient.cardFor(net), 'the card is held under A');
2612
+ // The SDK re-acquires: same net, new player id; session B has no private
2613
+ // overrides, and its first packet is an ordinary one.
2614
+ net.id = 'pB';
2615
+ net.inbox.push({ k: 'hub-say-x' });
2616
+ const got = net.drain();
2617
+ assert.equal(got.length, 1, 'the packets still go to the caller');
2618
+ assert.equal(HubState.hub.hudMe, null, 'HUD cleared at the boundary');
2619
+ assert.equal(HubState.hub.tune, null, 'tune cleared');
2620
+ assert.equal(HubState.hub.decor, undefined, 'decor cleared');
2621
+ assert.equal(HubState.hub.leaving, null, 'leaving line cleared');
2622
+ assert.deepEqual(HubState.hub.labelsMe, {});
2623
+ assert.deepEqual(HubState.hub.marks, {});
2624
+ assert.equal(HubState.hub.held.size, 0);
2625
+ assert.equal(HubState.hub.place, null);
2626
+ assert.equal(BallotClient.cardFor(net), null, 'the card goes');
2627
+ assert.equal(system.startNear, null, 'a recovery starts beside nobody');
2628
+ // B's own packets then apply normally, and are not cleared again.
2629
+ apply({ k: 'hub-hud', hud: { title: 'B' } });
2630
+ apply({ k: 'hub-tune', tune: { speed: 0.5 } });
2631
+ system.sayHello(scene, mp);
2632
+ net.drain();
2633
+ system.sayHello(scene, mp);
2634
+ assert.equal(HubState.hub.hudMe.title, 'B');
2635
+ assert.equal(HubState.hub.tune.speed, 0.5);
2636
+ const hellos = net.sent.filter((m) => m.k === 'hub-hello');
2637
+ assert.equal(hellos.length, 2, 'one fresh hello for B');
2638
+ assert.equal(hellos[1].resume, true);
2639
+ // The id seen first by sayHello (before any drain) resets too, once.
2640
+ net.id = 'pC';
2641
+ HubState.hub.hudMe = { title: 'B stale' };
2642
+ system.sayHello(scene, mp);
2643
+ assert.equal(HubState.hub.hudMe, null);
2644
+ apply({ k: 'hub-hud', hud: { title: 'C' } });
2645
+ net.drain();
2646
+ assert.equal(HubState.hub.hudMe.title, 'C', 'not reset twice');
2647
+ assert.equal(net.sent.filter((m) => m.k === 'hub-hello').length, 3);
2648
+ HubState.clear();
2649
+ await flush();
2650
+ });
2651
+
2652
+ await test('a game (a place with result) keeps the old way: no client re-hello after a drop', async () => {
2653
+ const { system, scene } = setup();
2654
+ HubState.hub.place = { result: { score: null } };
2655
+ const net = fakeNet();
2656
+ const mp = { net, joined: true };
2657
+ system.sayHello(scene, mp);
2658
+ net.inbox.push({ k: 'w' });
2659
+ net.drain();
2660
+ system.sayHello(scene, mp);
2661
+ system.sayHello(scene, mp);
2662
+ assert.equal(net.sent.filter((m) => m.k === 'hub-hello').length, 1);
2663
+ HubState.hub.place = null;
2664
+ await flush();
2665
+ });
2666
+
2667
+ await test('a game back under a new player id says one fresh, ordinary hello (a party of one, nothing carried)', async () => {
2668
+ const { system, scene } = setup();
2669
+ system.scene = scene;
2670
+ HubState.hub.place = { result: { score: null } };
2671
+ scene.persistent.hubArriving = { door: 'dash', party: 3, returning: true, near: '42' };
2672
+ scene.persistent.hubResult = { title: 'Race', outcome: 'win' };
2673
+ const net = fakeNet('pA');
2674
+ const mp = { net, joined: true };
2675
+ system.sayHello(scene, mp);
2676
+ // A fresh session: the identity reset clears the place until its WORLD.
2677
+ net.id = 'pB';
2678
+ net.drain();
2679
+ assert.equal(HubState.hub.place, null);
2680
+ system.sayHello(scene, mp);
2681
+ system.sayHello(scene, mp);
2682
+ const hellos = net.sent.filter((m) => m.k === 'hub-hello');
2683
+ assert.equal(hellos.length, 2, 'one fresh hello');
2684
+ assert.equal(hellos[1].resume, undefined, 'not a resume');
2685
+ assert.equal(hellos[1].again, undefined, 'a fresh client');
2686
+ assert.equal(hellos[1].party, 1);
2687
+ assert.equal(hellos[1].carry, null);
2688
+ assert.equal(hellos[1].near, undefined);
2689
+ // The new session's WORLD names the game; a drop after it under the same id
2690
+ // keeps the old way.
2691
+ HubState.hub.place = { result: { score: null } };
2692
+ net.inbox.push({ k: 'w' });
2693
+ net.drain();
2694
+ system.sayHello(scene, mp);
2695
+ assert.equal(net.sent.filter((m) => m.k === 'hub-hello').length, 2);
2696
+ HubState.hub.place = null;
2697
+ delete scene.persistent.hubArriving;
2698
+ delete scene.persistent.hubResult;
2699
+ await flush();
2700
+ });
2701
+
2702
+ await test('packets queued under the old player id are dropped at the identity boundary; the new session\'s private packets before its WORLD apply', async () => {
2703
+ const Rehello = await import('../code/client/rehello.js');
2704
+ const BallotClient = await import('../code/client/ballot.js');
2705
+ const { system, scene } = setup();
2706
+ system.scene = scene;
2707
+ const net = fakeNet('pA');
2708
+ const mp = { net, joined: true };
2709
+ system.sayHello(scene, mp);
2710
+ // As the hook layer applies them (client/hookLayer.js).
2711
+ const apply = (msg) => {
2712
+ if (msg.k === 'hub-hud') HubState.hub.hudMe = msg.hud ?? null;
2713
+ if (msg.k === 'hub-tune') HubState.hub.tune = msg.tune;
2714
+ if (msg.k === 'hub-ballot-card') BallotClient.gate(HubState.hub.place, net, msg.card);
2715
+ };
2716
+ // Each message is tagged as it arrives (the hook layer's `arrive`).
2717
+ const arrive = (msg) => {
2718
+ Rehello.tag(msg, net);
2719
+ net.inbox.push(msg);
2720
+ };
2721
+ // Session A's private packets arrive while the page is hidden (no drain).
2722
+ arrive({ k: 'hub-hud', hud: { title: 'A' } });
2723
+ arrive({ k: 'hub-tune', tune: { speed: 2 } });
2724
+ arrive({ k: 'hub-ballot-card', card: { v: 'a-1', mode: 'talk', faces: [] } });
2725
+ // The SDK re-acquires under B; B's private HUD comes ahead of its WORLD.
2726
+ net.id = 'pB';
2727
+ arrive({ k: 'hub-hud', hud: { title: 'B' } });
2728
+ net.inbox.push({ k: 'w', hubPlace: {} });
2729
+ const got = net.drain();
2730
+ assert.deepEqual(got.map((m) => m.k), ['hub-hud', 'w'], 'A\'s packets dropped, B\'s kept in order');
2731
+ assert.equal(got[0].hud.title, 'B');
2732
+ for (const msg of got) apply(msg);
2733
+ assert.equal(HubState.hub.hudMe.title, 'B', 'B\'s HUD applied');
2734
+ assert.equal(HubState.hub.tune, null, 'A\'s tune not re-applied');
2735
+ assert.equal(BallotClient.cardFor(net), null, 'A\'s card not re-applied');
2736
+ // Untagged messages (arrived before a net, or snapshots) are kept.
2737
+ net.inbox.push({ k: 'hub-hud', hud: { title: 'untagged' } });
2738
+ assert.equal(net.drain().length, 1);
2739
+ HubState.clear();
2740
+ await flush();
2741
+ });
2742
+
2029
2743
  console.warn = warn;
2030
2744
  console.log = log;
2031
2745
  console.log(`hub trips: ${n} tests passed`);