castle-web-cli 0.4.239 → 0.4.241

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 (396) hide show
  1. package/dist/agent.js +5 -1
  2. package/dist/api.d.ts +20 -0
  3. package/dist/api.js +57 -0
  4. package/dist/bundle.d.ts +38 -1
  5. package/dist/bundle.js +309 -13
  6. package/dist/castle-host/host.js +163 -11
  7. package/dist/castleJson.d.ts +10 -0
  8. package/dist/castleJson.js +46 -2
  9. package/dist/check.js +5 -2
  10. package/dist/devSessionServer.js +4 -1
  11. package/dist/devSessionStorage.d.ts +1 -0
  12. package/dist/devSessionStorage.js +32 -7
  13. package/dist/importOrder.d.ts +2 -0
  14. package/dist/importOrder.js +29 -0
  15. package/dist/index.js +6 -3
  16. package/dist/init.js +24 -2
  17. package/dist/multiplayerDoc.d.ts +1 -1
  18. package/dist/multiplayerDoc.js +2 -0
  19. package/dist/platformDoc.js +3 -2
  20. package/dist/playPagePolicy.js +5 -1
  21. package/dist/resetLeaderboards.d.ts +8 -1
  22. package/dist/resetLeaderboards.js +43 -8
  23. package/dist/roomLogs.d.ts +1 -0
  24. package/dist/roomLogs.js +30 -6
  25. package/dist/save-deck.d.ts +32 -2
  26. package/dist/save-deck.js +240 -39
  27. package/kits/base/CLAUDE.md +1 -1
  28. package/kits/base/castle.json +1 -1
  29. package/kits/base/sdk/README.md +174 -6
  30. package/kits/base/sdk/analytics.d.ts +8 -0
  31. package/kits/base/sdk/analytics.js +92 -0
  32. package/kits/base/sdk/castle.d.ts +5 -1
  33. package/kits/base/sdk/castle.js +2 -0
  34. package/kits/base/sdk/commands.d.ts +48 -0
  35. package/kits/base/sdk/commands.js +1 -0
  36. package/kits/base/sdk/debugConsole.d.ts +17 -0
  37. package/kits/base/sdk/debugConsole.js +154 -0
  38. package/kits/base/sdk/experiments.js +24 -1
  39. package/kits/base/sdk/hostRetry.d.ts +7 -0
  40. package/kits/base/sdk/hostRetry.js +57 -0
  41. package/kits/base/sdk/hub.d.ts +20 -2
  42. package/kits/base/sdk/hub.js +99 -13
  43. package/kits/base/sdk/multiplayer.d.ts +2 -0
  44. package/kits/base/sdk/multiplayer.js +168 -26
  45. package/kits/base/sdk/reconnectBudget.d.ts +6 -0
  46. package/kits/base/sdk/reconnectBudget.js +41 -1
  47. package/kits/base/sdk/runtime.js +36 -19
  48. package/kits/base/sdk/server/hub.d.ts +19 -0
  49. package/kits/base/sdk/server/hub.js +12 -0
  50. package/kits/base/sdk/server/platformHandle.d.ts +1 -0
  51. package/kits/base/sdk/server/wrapper.d.ts +1 -1
  52. package/kits/base/sdk/server/wrapper.js +26 -1
  53. package/kits/base/sdk/transport.d.ts +2 -1
  54. package/kits/base/sdk/transport.js +35 -0
  55. package/kits/hub-game/CLAUDE.md +66 -19
  56. package/kits/hub-game/code/client/act.js +9 -6
  57. package/kits/hub-game/code/client/actCore.js +26 -6
  58. package/kits/hub-game/code/client/actGateLog.js +36 -0
  59. package/kits/hub-game/code/client/actionOverflow.js +29 -8
  60. package/kits/hub-game/code/client/actionRailSurface.js +186 -0
  61. package/kits/hub-game/code/client/actionRailTree.js +173 -0
  62. package/kits/hub-game/code/client/askSurface.js +85 -0
  63. package/kits/hub-game/code/client/askTree.js +51 -0
  64. package/kits/hub-game/code/client/attention.js +31 -6
  65. package/kits/hub-game/code/client/ballot.js +42 -5
  66. package/kits/hub-game/code/client/ballotSurface.js +115 -0
  67. package/kits/hub-game/code/client/ballotTree.js +180 -0
  68. package/kits/hub-game/code/client/catchingUp.js +19 -0
  69. package/kits/hub-game/code/client/celebrate.js +66 -0
  70. package/kits/hub-game/code/client/chrome.js +481 -57
  71. package/kits/hub-game/code/client/companion.js +93 -23
  72. package/kits/hub-game/code/client/companionDress.js +1 -1
  73. package/kits/hub-game/code/client/cornerSurface.js +106 -0
  74. package/kits/hub-game/code/client/cornerTree.js +83 -0
  75. package/kits/hub-game/code/client/decor.js +20 -11
  76. package/kits/hub-game/code/client/deviceStorage.js +121 -0
  77. package/kits/hub-game/code/client/disguise.js +23 -0
  78. package/kits/hub-game/code/client/disguiseDraw.js +87 -0
  79. package/kits/hub-game/code/client/dockSurface.js +206 -0
  80. package/kits/hub-game/code/client/dockTree.js +232 -0
  81. package/kits/hub-game/code/client/earned.js +29 -0
  82. package/kits/hub-game/code/client/emoteSurface.js +188 -0
  83. package/kits/hub-game/code/client/emoteTree.js +264 -0
  84. package/kits/hub-game/code/client/farAvatars.js +4 -3
  85. package/kits/hub-game/code/client/fpsTelemetry.js +3 -1
  86. package/kits/hub-game/code/client/grab.js +121 -50
  87. package/kits/hub-game/code/client/holdShow.js +19 -0
  88. package/kits/hub-game/code/client/hookLayer.js +96 -12
  89. package/kits/hub-game/code/client/hubControls.js +7 -1
  90. package/kits/hub-game/code/client/hudSurface.js +11 -3
  91. package/kits/hub-game/code/client/hudTree.js +7 -4
  92. package/kits/hub-game/code/client/idle.js +21 -3
  93. package/kits/hub-game/code/client/invites.js +24 -3
  94. package/kits/hub-game/code/client/keys.js +15 -0
  95. package/kits/hub-game/code/client/labelsNear.js +8 -1
  96. package/kits/hub-game/code/client/layoutCache.js +57 -8
  97. package/kits/hub-game/code/client/loadingCover.js +53 -4
  98. package/kits/hub-game/code/client/menuIcons.js +15 -0
  99. package/kits/hub-game/code/client/menuSurface.js +102 -0
  100. package/kits/hub-game/code/client/menuTree.js +135 -0
  101. package/kits/hub-game/code/client/modelLook.js +41 -0
  102. package/kits/hub-game/code/client/padCues.js +11 -7
  103. package/kits/hub-game/code/client/padReadability.js +3 -3
  104. package/kits/hub-game/code/client/pickerSurface.js +152 -0
  105. package/kits/hub-game/code/client/pickerTree.js +163 -0
  106. package/kits/hub-game/code/client/pushVisit.js +4 -2
  107. package/kits/hub-game/code/client/quality.js +188 -29
  108. package/kits/hub-game/code/client/qualityEntry.js +10 -1
  109. package/kits/hub-game/code/client/quickChatSurface.js +222 -0
  110. package/kits/hub-game/code/client/quickChatTree.js +201 -0
  111. package/kits/hub-game/code/client/rehello.js +75 -0
  112. package/kits/hub-game/code/client/renderVisibility.js +17 -0
  113. package/kits/hub-game/code/client/replay.js +118 -0
  114. package/kits/hub-game/code/client/role.js +3 -0
  115. package/kits/hub-game/code/client/safeLayout.js +441 -56
  116. package/kits/hub-game/code/client/safeStyle.js +13 -10
  117. package/kits/hub-game/code/client/say.js +2 -0
  118. package/kits/hub-game/code/client/soundSurface.js +77 -0
  119. package/kits/hub-game/code/client/soundTree.js +74 -0
  120. package/kits/hub-game/code/client/soundscape.js +12 -9
  121. package/kits/hub-game/code/client/soundscapeCues.js +1 -1
  122. package/kits/hub-game/code/client/state.js +67 -1
  123. package/kits/hub-game/code/client/stuckSurface.js +76 -0
  124. package/kits/hub-game/code/client/stuckTree.js +67 -0
  125. package/kits/hub-game/code/client/talk.js +42 -12
  126. package/kits/hub-game/code/client/talkTree.js +4 -2
  127. package/kits/hub-game/code/client/textAskSurface.js +147 -0
  128. package/kits/hub-game/code/client/textAskTree.js +67 -0
  129. package/kits/hub-game/code/client/tiers.js +252 -27
  130. package/kits/hub-game/code/client/together.js +4 -1
  131. package/kits/hub-game/code/client/uiDom.js +86 -8
  132. package/kits/hub-game/code/client/uiTree.js +33 -4
  133. package/kits/hub-game/code/client/vehicle.js +72 -51
  134. package/kits/hub-game/code/client/weakestTier.js +75 -31
  135. package/kits/hub-game/code/client/wear.js +159 -5
  136. package/kits/hub-game/code/client/worldLabels.js +205 -25
  137. package/kits/hub-game/code/companionSpec.js +4 -2
  138. package/kits/hub-game/code/server/act.js +3 -0
  139. package/kits/hub-game/code/server/actGate.js +83 -0
  140. package/kits/hub-game/code/server/actions.js +71 -15
  141. package/kits/hub-game/code/server/actors.js +20 -5
  142. package/kits/hub-game/code/server/analytics.js +35 -3
  143. package/kits/hub-game/code/server/ask.js +39 -3
  144. package/kits/hub-game/code/server/ballot.js +167 -4
  145. package/kits/hub-game/code/server/celebrate.js +64 -0
  146. package/kits/hub-game/code/server/companion.js +17 -2
  147. package/kits/hub-game/code/server/decor.js +11 -2
  148. package/kits/hub-game/code/server/disguise.js +63 -0
  149. package/kits/hub-game/code/server/earned.js +6 -2
  150. package/kits/hub-game/code/server/friendBests.js +13 -4
  151. package/kits/hub-game/code/server/friendsAmong.js +67 -8
  152. package/kits/hub-game/code/server/grab.js +12 -2
  153. package/kits/hub-game/code/server/heldOffers.js +142 -0
  154. package/kits/hub-game/code/server/holdShow.js +98 -0
  155. package/kits/hub-game/code/server/hub.js +991 -72
  156. package/kits/hub-game/code/server/idle.js +110 -9
  157. package/kits/hub-game/code/server/index.js +9 -0
  158. package/kits/hub-game/code/server/labels.js +13 -3
  159. package/kits/hub-game/code/server/manifest.js +94 -6
  160. package/kits/hub-game/code/server/menu.js +26 -3
  161. package/kits/hub-game/code/server/npcs.js +55 -9
  162. package/kits/hub-game/code/server/observe.js +67 -6
  163. package/kits/hub-game/code/server/players.js +14 -2
  164. package/kits/hub-game/code/server/replay.js +135 -0
  165. package/kits/hub-game/code/server/standing.js +7 -3
  166. package/kits/hub-game/code/server/storageLimit.js +4 -1
  167. package/kits/hub-game/code/server/townDay.js +74 -0
  168. package/kits/hub-game/code/server/vehicle.js +3 -0
  169. package/kits/hub-game/code/server/vis.js +26 -4
  170. package/kits/hub-game/code/server/wallet.js +677 -0
  171. package/kits/hub-game/code/server/wear.js +13 -3
  172. package/kits/hub-game/code/server/writerLease.js +191 -0
  173. package/kits/hub-game/code/shared/act.js +1 -1
  174. package/kits/hub-game/code/shared/expression.js +6 -0
  175. package/kits/hub-game/code/shared/replay.js +37 -0
  176. package/kits/hub-game/code/systems/hub.js +429 -55
  177. package/kits/hub-game/docs/analytics.md +16 -2
  178. package/kits/hub-game/docs/contract.md +956 -101
  179. package/kits/hub-game/docs/home-pieces.md +5 -6
  180. package/kits/hub-game/docs/observed-progress.md +49 -1
  181. package/kits/hub-game/docs/vehicle-preset.md +23 -0
  182. package/kits/hub-game/index.html +1 -0
  183. package/kits/hub-game/models/hats/baker-cap.pxmodel +3 -3
  184. package/kits/hub-game/models/hats/bat-clip.pxmodel +3 -3
  185. package/kits/hub-game/models/hats/beekeeper.pxmodel +3 -3
  186. package/kits/hub-game/models/hats/cap.pxmodel +3 -3
  187. package/kits/hub-game/models/hats/captain.pxmodel +3 -3
  188. package/kits/hub-game/models/hats/chef-toque.pxmodel +3 -3
  189. package/kits/hub-game/models/hats/crooked-top.pxmodel +3 -3
  190. package/kits/hub-game/models/hats/delivery-cap.pxmodel +3 -3
  191. package/kits/hub-game/models/hats/fire-helmet.pxmodel +3 -3
  192. package/kits/hub-game/models/hats/flower-crown.pxmodel +3 -3
  193. package/kits/hub-game/models/hats/foam-crown.pxmodel +3 -3
  194. package/kits/hub-game/models/hats/hard-hat.pxmodel +3 -3
  195. package/kits/hub-game/models/hats/lantern.pxmodel +3 -3
  196. package/kits/hub-game/models/hats/laurel.pxmodel +3 -3
  197. package/kits/hub-game/models/hats/lighthouse.pxmodel +3 -3
  198. package/kits/hub-game/models/hats/nurse-cap.pxmodel +3 -3
  199. package/kits/hub-game/models/hats/police-cap.pxmodel +3 -3
  200. package/kits/hub-game/models/hats/sailor.pxmodel +3 -3
  201. package/kits/hub-game/models/hats/souwester.pxmodel +3 -3
  202. package/kits/hub-game/models/hats/straw.pxmodel +3 -3
  203. package/kits/hub-game/models/hats/sunflower.pxmodel +3 -3
  204. package/kits/hub-game/models/hats/sweatband.pxmodel +3 -3
  205. package/kits/hub-game/models/hats/teacher-beret.pxmodel +3 -3
  206. package/kits/hub-game/models/hats/witch.pxmodel +3 -3
  207. package/kits/hub-game/models/hold-show/daisy.pxmodel +231 -0
  208. package/kits/hub-game/models/hold-show/moonflower.pxmodel +171 -0
  209. package/kits/hub-game/models/hold-show/rose.pxmodel +191 -0
  210. package/kits/hub-game/models/hold-show/square/daisy.pxmodel +233 -0
  211. package/kits/hub-game/models/hold-show/square/moonflower.pxmodel +173 -0
  212. package/kits/hub-game/models/hold-show/square/rose.pxmodel +193 -0
  213. package/kits/hub-game/models/hold-show/square/sunflower.pxmodel +313 -0
  214. package/kits/hub-game/models/hold-show/square/tulip.pxmodel +133 -0
  215. package/kits/hub-game/models/hold-show/sunflower.pxmodel +311 -0
  216. package/kits/hub-game/models/hold-show/tulip.pxmodel +131 -0
  217. package/kits/hub-game/package-lock.json +3 -3
  218. package/kits/hub-game/package.json +4 -3
  219. package/kits/hub-game/scripts/fixtures/engine-models-stub.mjs +1 -0
  220. package/kits/hub-game/scripts/fixtures/hud-surface.json +12 -12
  221. package/kits/hub-game/scripts/fixtures/talk-surface.json +8 -8
  222. package/kits/hub-game/scripts/gen-hats.mjs +1 -1
  223. package/kits/hub-game/scripts/gen-hold-show.mjs +27 -0
  224. package/kits/hub-game/scripts/pack.mjs +89 -23
  225. package/kits/hub-game/scripts/test-act-client.mjs +5 -0
  226. package/kits/hub-game/scripts/test-act-core.mjs +32 -0
  227. package/kits/hub-game/scripts/test-act-gate.mjs +186 -0
  228. package/kits/hub-game/scripts/test-action-rail-crowded-dom.mjs +7 -1
  229. package/kits/hub-game/scripts/test-action-rail-default-dom.mjs +102 -0
  230. package/kits/hub-game/scripts/test-action-rail-never-silent-dom.mjs +50 -0
  231. package/kits/hub-game/scripts/test-action-rail-surface.mjs +368 -0
  232. package/kits/hub-game/scripts/test-action-rail-town-jobs-dom.mjs +118 -0
  233. package/kits/hub-game/scripts/test-actions-client.mjs +5 -3
  234. package/kits/hub-game/scripts/test-actions.mjs +24 -0
  235. package/kits/hub-game/scripts/test-actors.mjs +19 -0
  236. package/kits/hub-game/scripts/test-again-corner-dom.mjs +59 -0
  237. package/kits/hub-game/scripts/test-analytics.mjs +79 -0
  238. package/kits/hub-game/scripts/test-arrival-pose-server.mjs +25 -8
  239. package/kits/hub-game/scripts/test-ask-client.mjs +9 -0
  240. package/kits/hub-game/scripts/test-ask-surface.mjs +188 -0
  241. package/kits/hub-game/scripts/test-attention.mjs +43 -1
  242. package/kits/hub-game/scripts/test-ballot-sheet-dom.mjs +71 -0
  243. package/kits/hub-game/scripts/test-ballot-surface.mjs +276 -0
  244. package/kits/hub-game/scripts/test-ballot.mjs +421 -4
  245. package/kits/hub-game/scripts/test-ban-join.mjs +1 -1
  246. package/kits/hub-game/scripts/test-celebrate-client.mjs +62 -0
  247. package/kits/hub-game/scripts/test-celebrate.mjs +116 -0
  248. package/kits/hub-game/scripts/test-chat.mjs +73 -0
  249. package/kits/hub-game/scripts/test-companion-client.mjs +203 -21
  250. package/kits/hub-game/scripts/test-companion.mjs +110 -3
  251. package/kits/hub-game/scripts/test-control-layout-dom.mjs +57 -10
  252. package/kits/hub-game/scripts/test-corner-surface.mjs +268 -0
  253. package/kits/hub-game/scripts/test-decor-client.mjs +59 -3
  254. package/kits/hub-game/scripts/test-decor.mjs +27 -0
  255. package/kits/hub-game/scripts/test-device-class.mjs +4 -1
  256. package/kits/hub-game/scripts/test-disguise-client.mjs +281 -0
  257. package/kits/hub-game/scripts/test-disguise.mjs +176 -0
  258. package/kits/hub-game/scripts/test-dock-surface.mjs +404 -0
  259. package/kits/hub-game/scripts/test-door-stay-client.mjs +602 -0
  260. package/kits/hub-game/scripts/test-door-stay.mjs +613 -0
  261. package/kits/hub-game/scripts/test-earned-client.mjs +119 -0
  262. package/kits/hub-game/scripts/test-emote-surface.mjs +616 -0
  263. package/kits/hub-game/scripts/test-fps-telemetry.mjs +39 -4
  264. package/kits/hub-game/scripts/test-friend-bests.mjs +38 -12
  265. package/kits/hub-game/scripts/test-ghost-click-dom.mjs +75 -0
  266. package/kits/hub-game/scripts/test-grab-client.mjs +29 -2
  267. package/kits/hub-game/scripts/test-grab-orbit.mjs +260 -11
  268. package/kits/hub-game/scripts/test-grab.mjs +10 -1
  269. package/kits/hub-game/scripts/test-hats.mjs +28 -0
  270. package/kits/hub-game/scripts/test-held-offers.mjs +394 -0
  271. package/kits/hub-game/scripts/test-high-only.mjs +3 -3
  272. package/kits/hub-game/scripts/test-hold-show-client.mjs +175 -0
  273. package/kits/hub-game/scripts/test-hold-show.mjs +355 -0
  274. package/kits/hub-game/scripts/test-hub-controls.mjs +3 -1
  275. package/kits/hub-game/scripts/test-hub-idle.mjs +348 -0
  276. package/kits/hub-game/scripts/test-hub-leaving.mjs +21 -0
  277. package/kits/hub-game/scripts/test-hub-ops.mjs +119 -0
  278. package/kits/hub-game/scripts/test-hub-trip.mjs +240 -4
  279. package/kits/hub-game/scripts/test-hud-clear.mjs +83 -0
  280. package/kits/hub-game/scripts/test-hud-rate.mjs +2 -1
  281. package/kits/hub-game/scripts/test-idle.mjs +160 -0
  282. package/kits/hub-game/scripts/test-invites-client.mjs +53 -0
  283. package/kits/hub-game/scripts/test-labels.mjs +11 -0
  284. package/kits/hub-game/scripts/test-landscape-layout.mjs +20 -0
  285. package/kits/hub-game/scripts/test-loading-cover.mjs +67 -1
  286. package/kits/hub-game/scripts/test-manifest.mjs +27 -0
  287. package/kits/hub-game/scripts/test-menu-client.mjs +54 -5
  288. package/kits/hub-game/scripts/test-menu-surface.mjs +236 -0
  289. package/kits/hub-game/scripts/test-npcs.mjs +128 -0
  290. package/kits/hub-game/scripts/test-observed.mjs +171 -3
  291. package/kits/hub-game/scripts/test-pack.mjs +166 -0
  292. package/kits/hub-game/scripts/test-pad-cues.mjs +39 -0
  293. package/kits/hub-game/scripts/test-picker-surface.mjs +321 -0
  294. package/kits/hub-game/scripts/test-placeat-server.mjs +648 -0
  295. package/kits/hub-game/scripts/test-placement-cache.mjs +1 -1
  296. package/kits/hub-game/scripts/test-pointer-clear-dom.mjs +82 -0
  297. package/kits/hub-game/scripts/test-progress-reset.mjs +184 -6
  298. package/kits/hub-game/scripts/test-push-visit.mjs +9 -0
  299. package/kits/hub-game/scripts/test-quality.mjs +312 -9
  300. package/kits/hub-game/scripts/test-quick-chat-surface.mjs +511 -0
  301. package/kits/hub-game/scripts/test-rehello.mjs +242 -3
  302. package/kits/hub-game/scripts/test-rejoin-yaw.mjs +138 -0
  303. package/kits/hub-game/scripts/test-relations-among.mjs +13 -7
  304. package/kits/hub-game/scripts/test-relations-refresh.mjs +90 -2
  305. package/kits/hub-game/scripts/test-replay-client.mjs +110 -0
  306. package/kits/hub-game/scripts/test-replay.mjs +178 -0
  307. package/kits/hub-game/scripts/test-resume-held.mjs +13 -0
  308. package/kits/hub-game/scripts/test-resume-pose-server.mjs +43 -5
  309. package/kits/hub-game/scripts/test-role-client.mjs +2 -1
  310. package/kits/hub-game/scripts/test-safe-act.mjs +233 -0
  311. package/kits/hub-game/scripts/test-safe-caption.mjs +364 -0
  312. package/kits/hub-game/scripts/test-safe-layout.mjs +79 -0
  313. package/kits/hub-game/scripts/test-safe-prompt.mjs +163 -0
  314. package/kits/hub-game/scripts/test-sound-surface.mjs +256 -0
  315. package/kits/hub-game/scripts/test-soundscape.mjs +85 -2
  316. package/kits/hub-game/scripts/test-standing.mjs +135 -2
  317. package/kits/hub-game/scripts/test-stuck-surface.mjs +174 -0
  318. package/kits/hub-game/scripts/test-stuck.mjs +36 -1
  319. package/kits/hub-game/scripts/test-talk-surface.mjs +23 -6
  320. package/kits/hub-game/scripts/test-talk-walk-dom.mjs +123 -0
  321. package/kits/hub-game/scripts/test-text-ask-surface.mjs +273 -0
  322. package/kits/hub-game/scripts/test-tiers.mjs +453 -3
  323. package/kits/hub-game/scripts/test-toast-no-row-dom.mjs +71 -0
  324. package/kits/hub-game/scripts/test-together.mjs +11 -0
  325. package/kits/hub-game/scripts/test-town-day.mjs +90 -0
  326. package/kits/hub-game/scripts/test-try-on.mjs +39 -0
  327. package/kits/hub-game/scripts/test-ui-dom-dom.mjs +49 -2
  328. package/kits/hub-game/scripts/test-ui-tree.mjs +28 -0
  329. package/kits/hub-game/scripts/test-vehicle-client.mjs +68 -1
  330. package/kits/hub-game/scripts/test-vis.mjs +145 -0
  331. package/kits/hub-game/scripts/test-wallet.mjs +650 -0
  332. package/kits/hub-game/scripts/test-weakest-tier.mjs +135 -1
  333. package/kits/hub-game/scripts/test-world-labels.mjs +340 -0
  334. package/kits/hub-game/scripts/test-writer-lease-server.mjs +234 -0
  335. package/kits/hub-game/scripts/test-writer-lease.mjs +281 -0
  336. package/kits/hub-game/scripts/writer-storage-fixture.mjs +37 -0
  337. package/kits/hub-game/tools/hubScene/export.mjs +6 -5
  338. package/kits/hub-game/tools/hubScene/hubdata.mjs +10 -0
  339. package/kits/hub-game/tools/hubScene/test/export-fixture.mjs +36 -2
  340. package/kits/hub-game/tools/hubScene/validate-manifest.mjs +10 -2
  341. package/kits/multiplayer-3d/castle.json +5 -5
  342. package/kits/multiplayer-3d/code/client/resumeGate.js +66 -2
  343. package/kits/multiplayer-3d/code/server/ownership.js +25 -6
  344. package/kits/multiplayer-3d/code/server/world.js +19 -4
  345. package/kits/multiplayer-3d/code/systems/multiplayer.js +108 -18
  346. package/kits/multiplayer-3d/package-lock.json +1 -1
  347. package/kits/multiplayer-3d/package.json +2 -1
  348. package/kits/multiplayer-3d/scripts/test-ground-half.mjs +56 -0
  349. package/kits/multiplayer-3d/scripts/test-join-watchdog.mjs +54 -3
  350. package/kits/multiplayer-3d/scripts/test-owned-moves.mjs +190 -0
  351. package/kits/multiplayer-3d/scripts/test-resume-gate.mjs +417 -5
  352. package/kits/multiplayer-3d/scripts/test-resync-reconnect.mjs +68 -0
  353. package/kits/physics-2d/castle.json +2 -2
  354. package/kits/physics-2d/engine/scene.js +10 -2
  355. package/kits/physics-3d/CLAUDE.md +14 -0
  356. package/kits/physics-3d/behaviors/Player.jsx +39 -3
  357. package/kits/physics-3d/castle.json +3 -3
  358. package/kits/physics-3d/docs/engine-model-cache.md +109 -0
  359. package/kits/physics-3d/docs/engine-player.md +76 -0
  360. package/kits/physics-3d/docs/engine-skip-work.md +16 -0
  361. package/kits/physics-3d/docs/pxmodel-format.md +5 -1
  362. package/kits/physics-3d/engine3d/gait.js +16 -8
  363. package/kits/physics-3d/engine3d/groundsize.js +23 -0
  364. package/kits/physics-3d/engine3d/kithooks.js +50 -0
  365. package/kits/physics-3d/engine3d/look.js +110 -17
  366. package/kits/physics-3d/engine3d/lookbake.js +19 -1
  367. package/kits/physics-3d/engine3d/materialpresets.js +3 -2
  368. package/kits/physics-3d/engine3d/modelcache.js +280 -0
  369. package/kits/physics-3d/engine3d/modelcachedigest.js +37 -0
  370. package/kits/physics-3d/engine3d/modelcachegate.js +69 -0
  371. package/kits/physics-3d/engine3d/modelrefs.js +13 -0
  372. package/kits/physics-3d/engine3d/optimize.js +20 -9
  373. package/kits/physics-3d/engine3d/playerRun.js +26 -1
  374. package/kits/physics-3d/engine3d/pxmodel.js +7 -3
  375. package/kits/physics-3d/engine3d/templatecache.js +722 -0
  376. package/kits/physics-3d/engine3d/world3d.js +211 -17
  377. package/kits/physics-3d/package-lock.json +1 -1
  378. package/kits/physics-3d/package.json +2 -1
  379. package/kits/physics-3d/play/behaviors/Player.js +43 -3
  380. package/kits/physics-3d/scripts/render.mjs +56 -8
  381. package/kits/physics-3d/scripts/template-cache-fixtures.mjs +37 -0
  382. package/kits/physics-3d/scripts/template-cache-v1-bytes.json +49 -0
  383. package/kits/physics-3d/scripts/test-coaxial-escape.mjs +176 -0
  384. package/kits/physics-3d/scripts/test-gait.mjs +53 -9
  385. package/kits/physics-3d/scripts/test-ground-half.mjs +120 -0
  386. package/kits/physics-3d/scripts/test-model-cache.mjs +600 -0
  387. package/kits/physics-3d/scripts/test-orbit-shadow-fade.mjs +1 -0
  388. package/kits/physics-3d/scripts/test-sleeping-models.mjs +384 -0
  389. package/kits/physics-3d/scripts/test-template-cache-minified.mjs +106 -0
  390. package/kits/physics-3d/scripts/test-template-cache.mjs +519 -0
  391. package/kits/physics-3d/scripts/test-wall-slide.mjs +272 -0
  392. package/kits/physics-3d/systems/physics3d.js +59 -2
  393. package/kits/real-time/castle.json +2 -2
  394. package/kits/real-time/code/client/connection.js +3 -0
  395. package/package.json +2 -2
  396. package/vendor/three/examples/jsm/libs/fflate.module.js +2672 -0
@@ -0,0 +1,355 @@
1
+ // Hold-show (contract v1.182), real server layer and wire.
2
+ import assert from 'node:assert/strict';
3
+ import { register } from 'node:module';
4
+ import { pathToFileURL } from 'node:url';
5
+ import path from 'node:path';
6
+
7
+ const sceneStub = 'export const readScene = () => globalThis.__hubTestActors ?? [];';
8
+ const avatarsStub = 'export function dropMissing() {}';
9
+ register(
10
+ `data:text/javascript,${encodeURIComponent(`
11
+ import { readFile } from 'node:fs/promises';
12
+ import { fileURLToPath } from 'node:url';
13
+ const stubs = {
14
+ '@imports/castle.multiplayer-3d/code/server/sceneBodies.js': 'data:text/javascript,${encodeURIComponent(sceneStub)}',
15
+ '@imports/castle.multiplayer-3d/code/client/avatars.js': 'data:text/javascript,${encodeURIComponent(avatarsStub)}',
16
+ 'castle-web-sdk': ${JSON.stringify(new URL('./fixtures/sdk-stub.mjs', import.meta.url).href)},
17
+ };
18
+ export async function resolve(specifier, context, next) {
19
+ 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 };
20
+ 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 };
21
+ if (stubs[specifier]) {
22
+ return { url: stubs[specifier], shortCircuit: true };
23
+ }
24
+ return next(specifier, context);
25
+ }
26
+ // The hook layer reads the deck's castle.json through the bundler.
27
+ export async function load(url, context, next) {
28
+ if (url.endsWith('/code/client/hookLayer.js')) {
29
+ const source = await readFile(fileURLToPath(url), 'utf8');
30
+ return { format: 'module', source: source.replaceAll('import.meta.glob(', '(() => ({}))('), shortCircuit: true };
31
+ }
32
+ return next(url, context);
33
+ }
34
+ `)}`,
35
+ );
36
+
37
+ async function kit(root) {
38
+ const at = (file) => pathToFileURL(path.join(root, file)).href;
39
+ return {
40
+ layer: (await import(at('code/server/hub.js'))).layer,
41
+ hookLayer: (await import(at('code/client/hookLayer.js'))).default,
42
+ State: await import(at('code/client/state.js')),
43
+ };
44
+ }
45
+
46
+ const here = await kit(path.join(import.meta.dirname, '..'));
47
+
48
+ globalThis.__hubTestActors = [
49
+ { id: 'spawn', components: { Player: {}, Transform: { x: 0, y: 1, z: 0 } } },
50
+ { id: 'sign', components: { Transform: { x: 2, y: 1, z: 0 }, Shape: { kind: 'box', width: 1, height: 1, depth: 1, color: '#808080' } } },
51
+ ];
52
+ const castleJson = { server: { maxPlayers: 8 }, hub: { contract: 1, title: 'Hat Shop', result: {} } };
53
+ const sceneExists = () => true;
54
+ const flush = () => new Promise((resolve) => setImmediate(resolve));
55
+
56
+ const ROSTER = [
57
+ { playerId: 'p1', userId: '101', username: 'ada', isAnonymous: false },
58
+ { playerId: 'p2', userId: '102', username: 'bo', isAnonymous: false },
59
+ { playerId: 'p3', userId: 'anon-1', username: 'guest', isAnonymous: true },
60
+ ];
61
+ const halo = { kind: 'halo', color: '#ffd700', rarity: 4 };
62
+
63
+ // A place on a fake session, with everything it writes kept in `log` in the
64
+ // order it wrote it: snapshots, deltas, messages to one player, ghost calls,
65
+ // the deck's hooks and warnings. `hides(x, y)` is the host's block answer.
66
+ function room(layer, { hides = null, saved = { 101: halo, 102: null }, roster = ROSTER, keys = {}, holdShow = true } = {}) {
67
+ const log = [];
68
+ const calls = [];
69
+ const players = roster.map((p) => ({ ...p }));
70
+ const platform = {
71
+ place: 'main',
72
+ title: 'Town',
73
+ result: null,
74
+ arrival: () => null,
75
+ async reportResult() {
76
+ return { recorded: true };
77
+ },
78
+ async updatePad() {
79
+ return { status: 'gathering', members: [] };
80
+ },
81
+ async readResults(input) {
82
+ calls.push(['read', input]);
83
+ log.push(['ghost-read', JSON.stringify(input)]);
84
+ const out = {};
85
+ for (const id of input.userIds ?? []) {
86
+ out[id] = { avatar: 1, recent: [], records: [], wearable: saved[id] ?? null };
87
+ }
88
+ return { players: out, boards: {} };
89
+ },
90
+ async wear(playerId, wearable) {
91
+ calls.push(['wear', playerId, wearable]);
92
+ log.push(['ghost-wear', playerId, JSON.stringify(wearable)]);
93
+ return { wearable };
94
+ },
95
+ };
96
+ if (hides) {
97
+ platform.hiddenPair = hides;
98
+ }
99
+ const session = {
100
+ sessionId: 's-1',
101
+ place: null,
102
+ players,
103
+ hub: platform,
104
+ send: (playerId, data) => log.push(['send', playerId, JSON.stringify(data)]),
105
+ broadcast: (data) => log.push(['broadcast', JSON.stringify(data)]),
106
+ };
107
+ let ctx = null;
108
+ const deck = {
109
+ ready: (hub) => (ctx = hub),
110
+ arrive: (hub, group) => log.push(['arrive', JSON.stringify(group)]),
111
+ leave: (hub, playerId) => log.push(['leave', playerId]),
112
+ step: () => log.push(['step']),
113
+ shutdown: () => log.push(['shutdown']),
114
+ resume() {},
115
+ };
116
+ const h = layer({ ...castleJson, hub: { ...castleJson.hub, ...(holdShow ? { holdShow: true } : {}), ...keys } }, deck, {}, sceneExists);
117
+ h.sceneFor(session);
118
+ const world = { timeMs: 0, players: new Map(), bodies: new Map(), scenePath: 'scenes/main.scene' };
119
+ const body = () => ({ at: { x: 0, y: 1, z: 0 }, facing: 0, body: { setTranslation() {} } });
120
+ h.ready(world);
121
+ return {
122
+ h,
123
+ session,
124
+ log,
125
+ calls,
126
+ world,
127
+ hub: () => ctx,
128
+ // The WORLD snapshot a joiner gets, and the delta everyone does.
129
+ join() {
130
+ const snapshot = h.join();
131
+ log.push(['join', JSON.stringify(snapshot)]);
132
+ return snapshot;
133
+ },
134
+ delta() {
135
+ const delta = h.delta();
136
+ log.push(['delta', JSON.stringify(delta)]);
137
+ return delta;
138
+ },
139
+ async tick(ms = 50) {
140
+ world.timeMs += ms;
141
+ h.place(world);
142
+ // Ghost's arrival read answers, and the next tick places who it was for.
143
+ await flush();
144
+ world.timeMs += ms;
145
+ h.place(world);
146
+ h.step(world);
147
+ },
148
+ enter(playerId) {
149
+ this.body(playerId);
150
+ this.hello(playerId);
151
+ },
152
+ // The two halves of coming in: a body in the simulation (and a place in
153
+ // the roster, for one who went), and the client's hello.
154
+ body(playerId) {
155
+ world.players.set(playerId, body());
156
+ if (!players.some((p) => p.playerId === playerId)) {
157
+ players.push({ ...(roster.find((p) => p.playerId === playerId) ?? { playerId, userId: null, username: playerId, isAnonymous: true }) });
158
+ }
159
+ },
160
+ hello(playerId, extra = {}) {
161
+ h.message(session, { playerId }, { k: 'hub-hello', avatar: 1, from: null, party: 1, ...extra });
162
+ },
163
+ exit(playerId) {
164
+ world.players.delete(playerId);
165
+ const at = players.findIndex((p) => p.playerId === playerId);
166
+ if (at >= 0) {
167
+ players.splice(at, 1);
168
+ }
169
+ },
170
+ shutdown: () => h.shutdown(),
171
+ };
172
+ }
173
+
174
+ const { readManifest } = await import('../code/server/manifest.js');
175
+ const HoldShow = await import('../code/server/holdShow.js');
176
+ const Earned = await import('../code/server/earned.js');
177
+ const flower = { shape: 'daisy', color: '#abcdef' };
178
+ const rose = { shape: 'rose', color: '#ff3344' };
179
+ let count = 0;
180
+ async function test(name, fn) { await fn(); count += 1; console.log(`ok: ${name}`); }
181
+ async function boot(options) {
182
+ const r = room(here.layer, options);
183
+ for (const id of ['p1', 'p2', 'p3']) r.enter(id);
184
+ await r.tick(); r.delta(); r.log.length = 0;
185
+ return r;
186
+ }
187
+ await test('manifest permits only top-level true and gates both methods', async () => {
188
+ for (const value of [false, null, undefined, 1, {}, 'true']) {
189
+ assert.ok(readManifest({ ...castleJson, hub: { ...castleJson.hub, holdShow: value } }).errors.some((e) => e.includes('hub.holdShow')));
190
+ }
191
+ const plain = room(here.layer, { keys: {} });
192
+ assert.equal(typeof plain.hub().holdShow, 'function');
193
+ const noKey = { ...castleJson, hub: { ...castleJson.hub } };
194
+ let ctx;
195
+ const quiet = here.layer(noKey, { ready: (h) => { ctx = h; } }, {}, sceneExists);
196
+ quiet.sceneFor(plain.session); quiet.ready(plain.world);
197
+ assert.equal(Object.hasOwn(ctx, 'holdShow'), false);
198
+ assert.equal(Object.hasOwn(ctx, 'holdShowing'), false);
199
+ assert.ok(!Object.hasOwn(readManifest(noKey).manifest, 'holdShow'));
200
+ const nested = { ...castleJson, hub: { contract: 1, places: { garden: { title: 'Garden', scene: 'scenes/garden.scene', holdShow: true } } } };
201
+ assert.ok(readManifest(nested).errors.some((e) => e.includes('holdShow')));
202
+ });
203
+ await test('plain own data fields only, copied once; TypeError leaves state and wire unchanged', async () => {
204
+ const r = await boot();
205
+ assert.equal(r.hub().holdShow('p1', flower), true); r.delta();
206
+ let reads = 0;
207
+ const getter = { get shape() { reads++; return 'daisy'; }, color: '#abcdef' };
208
+ const inherited = Object.create(flower);
209
+ const symbol = { ...flower, [Symbol('extra')]: 1 };
210
+ for (const value of [undefined, false, 1, [], {}, { ...flower, extra: 1 }, { shape: 'other', color: '#abcdef' },
211
+ { ...flower, color: '#abc' }, { ...flower, color: '#abcdef\n' }, getter, inherited, symbol]) {
212
+ assert.throws(() => r.hub().holdShow('p1', value), TypeError);
213
+ assert.throws(() => r.hub().holdShow('missing', value), TypeError);
214
+ assert.deepEqual(r.hub().holdShowing('p1'), flower); assert.equal(r.delta(), null);
215
+ }
216
+ assert.equal(reads, 0);
217
+ const spec = Object.assign(Object.create(null), { shape: 'rose', color: '#FF3344' });
218
+ r.hub().holdShow('p1', spec); spec.color = '#000000';
219
+ const copy = r.hub().holdShowing('p1'); copy.shape = 'tulip';
220
+ assert.deepEqual(r.hub().holdShowing('p1'), rose);
221
+ assert.equal(r.hub().holdShow('missing', flower), false);
222
+ r.body('early'); assert.equal(r.hub().holdShow('early', flower), false);
223
+ assert.equal(r.hub().holdShowing('early'), null);
224
+ });
225
+ await test('latched tuple snapshots, equality suppression, sticky empty, four/s per-player coalescing', async () => {
226
+ const r = await boot(); assert.ok(!('hubHoldShow' in r.join()));
227
+ r.hub().holdShow('p1', flower);
228
+ assert.deepEqual(r.delta().hubHoldShow, { p1: ['daisy', '#abcdef'] });
229
+ r.hub().holdShow('p1', { ...flower }); assert.equal(r.delta(), null);
230
+ r.hub().holdShow('p1', rose); r.hub().holdShow('p1', { shape: 'tulip', color: '#111111' });
231
+ assert.equal(r.delta(), null); assert.deepEqual(r.join().hubHoldShow, { p1: ['daisy', '#abcdef'] });
232
+ r.hub().holdShow('p2', rose); assert.deepEqual(r.delta().hubHoldShow.p2, ['rose', '#ff3344']);
233
+ r.world.timeMs += 249; assert.equal(r.delta(), null);
234
+ r.world.timeMs += 1; assert.deepEqual(r.delta().hubHoldShow.p1, ['tulip', '#111111']);
235
+ r.hub().holdShow('p1', null); r.hub().holdShow('p2', null);
236
+ assert.equal(r.hub().holdShowing('p1'), null);
237
+ r.world.timeMs += 250;
238
+ assert.deepEqual(r.delta().hubHoldShow, {}); assert.equal(r.delta(), null);
239
+ assert.deepEqual(r.join().hubHoldShow, {});
240
+ r.hub().holdShow('p1', flower); r.hub().holdShow('p1', null);
241
+ r.world.timeMs += 250; assert.equal(r.delta(), null);
242
+ const sentAt = [];
243
+ for (let elapsed = 0; elapsed < 1000; elapsed += 25) {
244
+ r.hub().holdShow('p3', { shape: 'sunflower', color: elapsed % 50 ? '#112233' : '#445566' });
245
+ if (r.delta()?.hubHoldShow) sentAt.push(elapsed);
246
+ r.world.timeMs += 25;
247
+ }
248
+ assert.ok(sentAt.length <= 4);
249
+ assert.ok(sentAt.every((at, i) => i === 0 || at - sentAt[i - 1] >= 250));
250
+ r.world.timeMs += 250; r.delta();
251
+ assert.deepEqual(r.join().hubHoldShow.p3, ['sunflower', '#112233']);
252
+ });
253
+ await test('retained drop keeps flower, rejects absent writes, hides body, restores and clears on account change', async () => {
254
+ const r = await boot({ keys: { resume: { keep: true } } });
255
+ r.hub().holdShow('p1', flower); r.delta(); r.exit('p1'); await r.tick();
256
+ assert.deepEqual(r.hub().holdShowing('p1'), flower); assert.deepEqual(r.delta().hubHoldShow, {});
257
+ assert.equal(r.hub().holdShow('p1', rose), false);
258
+ r.body('p1'); r.hello('p1', { resume: true }); await r.tick();
259
+ assert.deepEqual(r.join().hubHoldShow, { p1: ['daisy', '#abcdef'] }); r.delta();
260
+ r.session.players.find((p) => p.playerId === 'p1').userId = '999';
261
+ assert.equal(r.hub().holdShowing('p1'), null); assert.deepEqual(r.delta().hubHoldShow, {});
262
+ });
263
+ await test('final leave, retained expiry, restart-as-fresh and place end clear', async () => {
264
+ const r = await boot(); r.hub().holdShow('p1', flower); r.delta(); r.exit('p1'); await r.tick();
265
+ assert.equal(r.hub().holdShowing('p1'), null); assert.deepEqual(r.delta().hubHoldShow, {});
266
+ for (const fresh of [false, true]) {
267
+ const t = await boot({ keys: { resume: { keep: true }, ...(fresh ? { resumeVisibility: true } : {}) } });
268
+ const id = fresh ? 'p3' : 'p1';
269
+ t.hub().holdShow(id, flower); t.delta(); t.exit(id); await t.tick();
270
+ if (!fresh) {
271
+ const now = Date.now; Date.now = () => now() + 61000;
272
+ try { await t.tick(); } finally { Date.now = now; }
273
+ }
274
+ t.body(id); t.hello(id, { resume: true }); await t.tick();
275
+ assert.equal(t.hub().holdShowing(id), null);
276
+ }
277
+ r.hub().holdShow('p2', rose); await r.shutdown();
278
+ assert.equal(r.hub().holdShowing('p2'), null); assert.deepEqual(r.join().hubHoldShow, {});
279
+ });
280
+ await test('trip retires value; grabs hide projection and restore without changing visit value', () => {
281
+ const h = { ...HoldShow.newHoldShowState(), sim: { timeMs: 0, players: new Map([['p', {}]]) },
282
+ players: new Map([['p', { arrived: true, hello: true }]]), session: { players: [{ playerId: 'p', userId: '1' }] }, grabs: new Map(), resumeDeparting: new Set() };
283
+ HoldShow.holdShow(h, 'p', flower); assert.deepEqual({ ...HoldShow.fields(h) }, { p: ['daisy', '#abcdef'] });
284
+ h.earned = new Map([['p', { class: 'held', shape: 'held-lantern', color: '#abcdef', name: 'Lantern' }]]);
285
+ const owned = { p: { ...h.earned.get('p') } };
286
+ assert.deepEqual(Earned.earnedForAll(h), {}, 'held Earned stays masked for the whole flower lifetime');
287
+ h.sim.timeMs += 250; h.grabs.set('p', 'ball'); assert.deepEqual({ ...HoldShow.fields(h) }, {});
288
+ assert.deepEqual(Earned.earnedForAll(h), {}, 'a remote grab cannot reveal the masked earned held item');
289
+ h.sentEarnedMe = new Map();
290
+ const privateEarned = []; h.session.send = (id, msg) => privateEarned.push(msg.hubEarned);
291
+ h.sentEarnedMe.set('p', 'resend');
292
+ Earned.sendOverrides(h, new Map([['p', new Set()]]));
293
+ assert.deepEqual(privateEarned, [{}]);
294
+ assert.deepEqual(HoldShow.holdShowing(h, 'p'), flower);
295
+ h.sim.timeMs += 250; h.grabs.clear(); assert.deepEqual({ ...HoldShow.fields(h) }, { p: ['daisy', '#abcdef'] });
296
+ assert.deepEqual(Earned.earnedForAll(h), {});
297
+ HoldShow.holdShow(h, 'p', null);
298
+ assert.deepEqual(Earned.earnedForAll(h), owned);
299
+ Earned.sendOverrides(h, new Map([['p', new Set()]]));
300
+ assert.deepEqual(privateEarned.at(-1), owned);
301
+ assert.equal(h.earned.get('p').shape, 'held-lantern');
302
+ HoldShow.holdShow(h, 'p', flower);
303
+ h.resumeDeparting.add('p'); assert.deepEqual({ ...HoldShow.fields(h) }, {});
304
+ assert.equal(HoldShow.holdShowing(h, 'p'), null);
305
+ });
306
+ await test('real hub.go clears before the player drops, with retained visits enabled', async () => {
307
+ const original = globalThis.__hubTestActors;
308
+ globalThis.__hubTestActors = [...original, { id: 'door', components: { HubDoor: { id: 'garden', to: 'garden' }, Transform: { x: 5, y: 0, z: 5 } } }];
309
+ try {
310
+ const r = await boot({ keys: { resume: { keep: true }, places: { garden: { title: 'Garden', scene: 'scenes/garden.scene' } } } });
311
+ r.session.hub = null; r.session.sessionId = 'dev';
312
+ r.hub().holdShow('p1', flower); r.delta();
313
+ assert.ok(r.hub().go('garden', ['p1']));
314
+ assert.ok(r.log.some((e) => e[0] === 'send' && JSON.parse(e[2]).k === 'hub-go'));
315
+ assert.equal(r.hub().holdShowing('p1'), null);
316
+ assert.deepEqual(r.delta().hubHoldShow, {});
317
+ r.exit('p1'); await r.tick(); r.body('p1'); r.hello('p1', { resume: true }); await r.tick();
318
+ assert.equal(r.hub().holdShowing('p1'), null);
319
+ } finally { globalThis.__hubTestActors = original; }
320
+ });
321
+ await test('blocked pairs receive only permitted projections, with fresh private empty replay', async () => {
322
+ const r = await boot({ hides: (a, b) => [a, b].sort().join() === 'p1,p2' });
323
+ r.hub().holdShow('p1', flower); await r.tick();
324
+ assert.deepEqual(r.delta().hubHoldShow, {});
325
+ const alone = () => r.log.filter((e) => e[0] === 'send' && JSON.parse(e[2]).k === 'hub-hold-show').map((e) => [e[1], JSON.parse(e[2]).hubHoldShow]);
326
+ assert.deepEqual(alone(), [['p1', { p1: ['daisy', '#abcdef'] }], ['p3', { p1: ['daisy', '#abcdef'] }]]);
327
+ r.world.timeMs += 250; r.hub().holdShow('p1', null); await r.tick();
328
+ assert.deepEqual(alone().at(-1), ['p3', {}]);
329
+ r.hello('p3'); await r.tick(); assert.deepEqual(alone().at(-1), ['p3', {}]);
330
+ // An account change clears the private flower for its own viewer too.
331
+ r.world.timeMs += 250; r.hub().holdShow('p1', flower); await r.tick();
332
+ assert.deepEqual(alone().slice(-2), [['p1', { p1: ['daisy', '#abcdef'] }], ['p3', { p1: ['daisy', '#abcdef'] }]]);
333
+ r.session.players.find((p) => p.playerId === 'p1').userId = '999'; await r.tick();
334
+ assert.deepEqual(alone().slice(-2).sort(), [['p1', {}], ['p3', {}]]);
335
+ });
336
+ await test('absent and opted-in-but-unused wire bytes identical; hold-show has no host calls', async () => {
337
+ async function story(use, enabled = true) {
338
+ const r = await boot({ holdShow: enabled }); r.join(); r.delta();
339
+ if (use) r.hub().holdShow('p1', flower);
340
+ r.delta(); await r.tick(); r.join();
341
+ if (use) r.hub().holdShow('p1', null);
342
+ r.world.timeMs += 250; r.delta(); await r.tick(); r.delta();
343
+ return r;
344
+ }
345
+ const quiet = await story(false), loud = await story(true), absent = await story(false, false);
346
+ assert.deepEqual(absent.log, quiet.log);
347
+ assert.ok(!JSON.stringify(quiet.log).includes('hubHoldShow'));
348
+ const stripped = loud.log.map((e) => {
349
+ if (!['join', 'delta'].includes(e[0])) return e;
350
+ const msg = JSON.parse(e[1]); if (msg) delete msg.hubHoldShow;
351
+ return [e[0], JSON.stringify(e[0] === 'delta' && msg && !Object.keys(msg).length ? null : msg)];
352
+ });
353
+ assert.deepEqual(stripped, quiet.log); assert.deepEqual(loud.calls, quiet.calls);
354
+ });
355
+ console.log(`test-hold-show: ${count} passed`);
@@ -13,7 +13,7 @@ function rig() {
13
13
  say: (t) => log.push(['say', t]),
14
14
  jump: (n, m) => log.push(['jump', n === net, m]),
15
15
  jumpTo: (f) => log.push(['jumpTo', f]),
16
- doors: [{ id: 'race', title: 'Foot Race' }],
16
+ doors: [{ id: 'race', title: 'Foot Race' }, { id: 'house', title: 'House', solo: true }],
17
17
  };
18
18
  return { log, net, opts };
19
19
  }
@@ -36,6 +36,8 @@ function rig() {
36
36
  const before = log.length;
37
37
  personAction(net, { playerId: 'p4', door: 'race' }, 'door', opts);
38
38
  assert.equal(log.length, before + 1, 'someone at the door is simply gone to');
39
+ assert.equal(personAction(net, { playerId: 'p4', door: 'house' }, 'door', opts), false, 'not someone at a door that takes one player');
40
+ assert.equal(log.length, before + 1);
39
41
  personAction(net, { userId: '42', username: 'Ed', playerId: null }, 'jump', opts);
40
42
  assert.deepEqual(log.at(-1), ['jumpTo', { userId: '42', username: 'Ed' }]);
41
43
  const quiet = log.length;