castle-web-cli 0.4.232 → 0.4.234

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (587) 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/api.d.ts +11 -0
  8. package/dist/api.js +43 -0
  9. package/dist/bundle.d.ts +64 -0
  10. package/dist/bundle.js +558 -2
  11. package/dist/castle-host/host.d.ts +18 -2
  12. package/dist/castle-host/host.js +844 -39
  13. package/dist/castleJson.d.ts +23 -2
  14. package/dist/castleJson.js +46 -2
  15. package/dist/check.d.ts +3 -1
  16. package/dist/check.js +20 -3
  17. package/dist/chunkLoader.d.ts +3 -0
  18. package/dist/chunkLoader.js +111 -0
  19. package/dist/devParty.d.ts +26 -0
  20. package/dist/devParty.js +231 -0
  21. package/dist/devSaveStorage.js +4 -0
  22. package/dist/devSessionStorage.js +50 -2
  23. package/dist/devSocial.d.ts +24 -0
  24. package/dist/devSocial.js +70 -0
  25. package/dist/ide.d.ts +2 -0
  26. package/dist/ide.js +119 -15
  27. package/dist/importPinMismatch.d.ts +22 -0
  28. package/dist/importPinMismatch.js +77 -0
  29. package/dist/importRegression.js +3 -15
  30. package/dist/imports.d.ts +10 -3
  31. package/dist/imports.js +88 -20
  32. package/dist/index.js +11 -4
  33. package/dist/init.js +1 -1
  34. package/dist/platformDoc.js +22 -0
  35. package/dist/routerFences.d.ts +5 -0
  36. package/dist/routerFences.js +12 -2
  37. package/dist/save-deck.d.ts +25 -1
  38. package/dist/save-deck.js +178 -9
  39. package/dist/serve.js +32 -11
  40. package/dist/shell/assets/{index-D2tWM896.js → index-DulbYIJm.js} +97 -97
  41. package/dist/shell/assets/index-MVLfNYd9.css +1 -0
  42. package/dist/shell/index.html +2 -2
  43. package/dist/taskSteer.d.ts +13 -0
  44. package/dist/taskSteer.js +22 -2
  45. package/dist/vitePlugins.d.ts +2 -1
  46. package/dist/vitePlugins.js +13 -0
  47. package/kits/base/castle.json +1 -1
  48. package/kits/base/package-lock.json +1 -1
  49. package/kits/base/sdk/README.md +339 -5
  50. package/kits/base/sdk/avatar.d.ts +6 -2
  51. package/kits/base/sdk/avatar.js +12 -4
  52. package/kits/base/sdk/castle.d.ts +7 -3
  53. package/kits/base/sdk/castle.js +2 -0
  54. package/kits/base/sdk/commands.d.ts +176 -1
  55. package/kits/base/sdk/commands.js +3 -0
  56. package/kits/base/sdk/display.d.ts +3 -0
  57. package/kits/base/sdk/display.js +9 -3
  58. package/kits/base/sdk/hub.d.ts +37 -6
  59. package/kits/base/sdk/hub.js +63 -4
  60. package/kits/base/sdk/multiplayer.d.ts +7 -1
  61. package/kits/base/sdk/multiplayer.js +148 -32
  62. package/kits/base/sdk/multiplayerProtocol.d.ts +2 -0
  63. package/kits/base/sdk/party.d.ts +23 -0
  64. package/kits/base/sdk/party.js +91 -0
  65. package/kits/base/sdk/reconnectBudget.d.ts +23 -0
  66. package/kits/base/sdk/reconnectBudget.js +96 -0
  67. package/kits/base/sdk/save.d.ts +38 -1
  68. package/kits/base/sdk/save.js +81 -7
  69. package/kits/base/sdk/server/hub.d.ts +117 -0
  70. package/kits/base/sdk/server/hub.js +119 -2
  71. package/kits/base/sdk/server/platformHandle.d.ts +43 -1
  72. package/kits/base/sdk/server/storage.d.ts +17 -0
  73. package/kits/base/sdk/server/storage.js +65 -3
  74. package/kits/base/sdk/server/wrapper.d.ts +43 -6
  75. package/kits/base/sdk/server/wrapper.js +93 -9
  76. package/kits/base/sdk/social.d.ts +9 -0
  77. package/kits/base/sdk/social.js +5 -0
  78. package/kits/hub-game/CLAUDE.md +451 -13
  79. package/kits/hub-game/README.md +63 -0
  80. package/kits/hub-game/blueprints/avatar-10.scene +28 -0
  81. package/kits/hub-game/blueprints/avatar-11.scene +28 -0
  82. package/kits/hub-game/blueprints/avatar-12.scene +28 -0
  83. package/kits/hub-game/blueprints/avatar-13.scene +28 -0
  84. package/kits/hub-game/blueprints/avatar-14.scene +28 -0
  85. package/kits/hub-game/blueprints/avatar-15.scene +28 -0
  86. package/kits/hub-game/blueprints/avatar-4.scene +28 -0
  87. package/kits/hub-game/blueprints/avatar-5.scene +28 -0
  88. package/kits/hub-game/blueprints/avatar-6.scene +28 -0
  89. package/kits/hub-game/blueprints/avatar-7.scene +28 -0
  90. package/kits/hub-game/blueprints/avatar-8.scene +28 -0
  91. package/kits/hub-game/blueprints/avatar-9.scene +28 -0
  92. package/kits/hub-game/castle.json +5 -5
  93. package/kits/hub-game/code/client/act.js +312 -0
  94. package/kits/hub-game/code/client/actionLayout.js +147 -0
  95. package/kits/hub-game/code/client/actionOverflow.js +556 -0
  96. package/kits/hub-game/code/client/actorBudget.js +47 -0
  97. package/kits/hub-game/code/client/arrivalCamera.js +50 -0
  98. package/kits/hub-game/code/client/askSlot.js +117 -0
  99. package/kits/hub-game/code/client/attention.js +11 -2
  100. package/kits/hub-game/code/client/avatar.js +311 -35
  101. package/kits/hub-game/code/client/avatarCap.js +228 -0
  102. package/kits/hub-game/code/client/avatarColors.js +70 -0
  103. package/kits/hub-game/code/client/avatarFaces.js +21 -0
  104. package/kits/hub-game/code/client/avatarShare.js +253 -0
  105. package/kits/hub-game/code/client/backVisibility.js +13 -0
  106. package/kits/hub-game/code/client/ballot.js +472 -0
  107. package/kits/hub-game/code/client/build.js +38 -0
  108. package/kits/hub-game/code/client/chat.js +41 -5
  109. package/kits/hub-game/code/client/chatModeration.js +5 -0
  110. package/kits/hub-game/code/client/chrome.js +2144 -160
  111. package/kits/hub-game/code/client/companion.js +716 -0
  112. package/kits/hub-game/code/client/companionDress.js +99 -0
  113. package/kits/hub-game/code/client/crowdNames.js +241 -0
  114. package/kits/hub-game/code/client/decor.js +515 -0
  115. package/kits/hub-game/code/client/defaultEnvironment.js +194 -0
  116. package/kits/hub-game/code/client/doorErrors.js +39 -0
  117. package/kits/hub-game/code/client/earned.js +131 -0
  118. package/kits/hub-game/code/client/emoteBubble.js +75 -0
  119. package/kits/hub-game/code/client/fall.js +18 -0
  120. package/kits/hub-game/code/client/farAvatars.js +233 -0
  121. package/kits/hub-game/code/client/firstJoin.js +9 -2
  122. package/kits/hub-game/code/client/fpsTelemetry.js +50 -0
  123. package/kits/hub-game/code/client/frameBatch.js +5 -0
  124. package/kits/hub-game/code/client/grab.js +368 -29
  125. package/kits/hub-game/code/client/hookLayer.js +385 -20
  126. package/kits/hub-game/code/client/hudCopy.js +51 -0
  127. package/kits/hub-game/code/client/hudRate.js +20 -0
  128. package/kits/hub-game/code/client/idle.js +177 -24
  129. package/kits/hub-game/code/client/interestCap.js +81 -0
  130. package/kits/hub-game/code/client/invites.js +231 -0
  131. package/kits/hub-game/code/client/joinError.js +9 -0
  132. package/kits/hub-game/code/client/keys.js +36 -0
  133. package/kits/hub-game/code/client/labelsNear.js +234 -0
  134. package/kits/hub-game/code/client/landscapeLayout.js +17 -0
  135. package/kits/hub-game/code/client/layoutCache.js +264 -0
  136. package/kits/hub-game/code/client/loadTelemetry.js +20 -0
  137. package/kits/hub-game/code/client/loadingCover.js +148 -0
  138. package/kits/hub-game/code/client/loadingEntry.js +8 -0
  139. package/kits/hub-game/code/client/menuIcons.js +34 -0
  140. package/kits/hub-game/code/client/menuRows.js +43 -0
  141. package/kits/hub-game/code/client/modelReady.js +7 -0
  142. package/kits/hub-game/code/client/pack.js +6 -2
  143. package/kits/hub-game/code/client/packFormat.js +3 -3
  144. package/kits/hub-game/code/client/padCueArrival.js +23 -0
  145. package/kits/hub-game/code/client/padCues.js +112 -0
  146. package/kits/hub-game/code/client/padOccupancy.js +88 -0
  147. package/kits/hub-game/code/client/padReadability.js +26 -0
  148. package/kits/hub-game/code/client/padRings.js +69 -0
  149. package/kits/hub-game/code/client/pushVisit.js +14 -0
  150. package/kits/hub-game/code/client/quality.js +205 -0
  151. package/kits/hub-game/code/client/qualityEntry.js +55 -0
  152. package/kits/hub-game/code/client/rehello.js +167 -0
  153. package/kits/hub-game/code/client/safeLayout.js +338 -0
  154. package/kits/hub-game/code/client/safeStyle.js +42 -0
  155. package/kits/hub-game/code/client/say.js +12 -3
  156. package/kits/hub-game/code/client/shot.js +146 -0
  157. package/kits/hub-game/code/client/shotFit.js +56 -0
  158. package/kits/hub-game/code/client/signIn.js +28 -0
  159. package/kits/hub-game/code/client/sound.js +63 -8
  160. package/kits/hub-game/code/client/soundscape.js +1151 -0
  161. package/kits/hub-game/code/client/soundscapeActions.js +99 -0
  162. package/kits/hub-game/code/client/soundscapeAmbience.js +453 -0
  163. package/kits/hub-game/code/client/soundscapeBaked.js +143 -0
  164. package/kits/hub-game/code/client/soundscapeBusker.js +217 -0
  165. package/kits/hub-game/code/client/soundscapeCourt.js +200 -0
  166. package/kits/hub-game/code/client/soundscapeCrowd.js +331 -0
  167. package/kits/hub-game/code/client/soundscapeCues.js +362 -0
  168. package/kits/hub-game/code/client/soundscapeMap.js +181 -0
  169. package/kits/hub-game/code/client/soundscapeMarket.js +176 -0
  170. package/kits/hub-game/code/client/soundscapeMusic.js +126 -0
  171. package/kits/hub-game/code/client/soundscapeMusicEngine.js +460 -0
  172. package/kits/hub-game/code/client/soundscapeSimlish.js +737 -0
  173. package/kits/hub-game/code/client/soundscapeSongs.js +127 -0
  174. package/kits/hub-game/code/client/soundscapeSongsRound3.js +63 -0
  175. package/kits/hub-game/code/client/soundscapeSynthesis.js +168 -0
  176. package/kits/hub-game/code/client/soundscapeUi.js +211 -0
  177. package/kits/hub-game/code/client/soundscapeVoice.js +1209 -0
  178. package/kits/hub-game/code/client/soundscapeWaves.js +206 -0
  179. package/kits/hub-game/code/client/spin.js +101 -0
  180. package/kits/hub-game/code/client/state.js +162 -1
  181. package/kits/hub-game/code/client/stuck.js +259 -0
  182. package/kits/hub-game/code/client/talk.js +714 -59
  183. package/kits/hub-game/code/client/tiers.js +543 -52
  184. package/kits/hub-game/code/client/toastBand.js +37 -0
  185. package/kits/hub-game/code/client/together.js +39 -2
  186. package/kits/hub-game/code/client/visibility.js +43 -0
  187. package/kits/hub-game/code/client/weakestLookBake.js +92 -0
  188. package/kits/hub-game/code/client/weakestTier.js +295 -0
  189. package/kits/hub-game/code/client/wear.js +461 -170
  190. package/kits/hub-game/code/client/worldLabels.js +241 -0
  191. package/kits/hub-game/code/client/yours.js +200 -0
  192. package/kits/hub-game/code/companionSpec.js +45 -0
  193. package/kits/hub-game/code/npcDisplayText.js +55 -0
  194. package/kits/hub-game/code/privateText.js +7 -0
  195. package/kits/hub-game/code/server/act.js +124 -0
  196. package/kits/hub-game/code/server/actions.js +138 -0
  197. package/kits/hub-game/code/server/actors.js +11 -2
  198. package/kits/hub-game/code/server/analytics.js +83 -0
  199. package/kits/hub-game/code/server/anonymousEntry.js +49 -0
  200. package/kits/hub-game/code/server/arrivalPose.js +36 -0
  201. package/kits/hub-game/code/server/ask.js +155 -0
  202. package/kits/hub-game/code/server/ballot.js +539 -0
  203. package/kits/hub-game/code/server/cells.js +100 -0
  204. package/kits/hub-game/code/server/companion.js +107 -0
  205. package/kits/hub-game/code/server/cues.js +70 -0
  206. package/kits/hub-game/code/server/decor.js +269 -0
  207. package/kits/hub-game/code/server/doorAnalytics.js +52 -0
  208. package/kits/hub-game/code/server/earned.js +478 -0
  209. package/kits/hub-game/code/server/frameBatch.js +183 -0
  210. package/kits/hub-game/code/server/friendBests.js +166 -0
  211. package/kits/hub-game/code/server/friendsAmong.js +272 -0
  212. package/kits/hub-game/code/server/history.js +7 -0
  213. package/kits/hub-game/code/server/hub.js +2510 -95
  214. package/kits/hub-game/code/server/idle.js +60 -12
  215. package/kits/hub-game/code/server/index.js +28 -6
  216. package/kits/hub-game/code/server/invites.js +19 -0
  217. package/kits/hub-game/code/server/labels.js +36 -2
  218. package/kits/hub-game/code/server/loadAbandon.js +106 -0
  219. package/kits/hub-game/code/server/manifest.js +586 -7
  220. package/kits/hub-game/code/server/menu.js +161 -0
  221. package/kits/hub-game/code/server/npcs.js +1025 -113
  222. package/kits/hub-game/code/server/observe.js +408 -0
  223. package/kits/hub-game/code/server/padOccupancy.js +85 -0
  224. package/kits/hub-game/code/server/party.js +2 -2
  225. package/kits/hub-game/code/server/players.js +30 -0
  226. package/kits/hub-game/code/server/resumePose.js +152 -0
  227. package/kits/hub-game/code/server/say.js +1 -1
  228. package/kits/hub-game/code/server/shot.js +110 -0
  229. package/kits/hub-game/code/server/standing.js +123 -0
  230. package/kits/hub-game/code/server/storageLimit.js +187 -0
  231. package/kits/hub-game/code/server/vis.js +175 -0
  232. package/kits/hub-game/code/server/wear.js +12 -0
  233. package/kits/hub-game/code/server/yours.js +59 -0
  234. package/kits/hub-game/code/shared/act.js +35 -0
  235. package/kits/hub-game/code/shared/cues.js +9 -0
  236. package/kits/hub-game/code/shared/danceIdle.js +28 -0
  237. package/kits/hub-game/code/shared/decor.js +41 -0
  238. package/kits/hub-game/code/shared/loadStages.js +12 -0
  239. package/kits/hub-game/code/shared/quality.js +74 -0
  240. package/kits/hub-game/code/shared/say.js +2 -0
  241. package/kits/hub-game/code/shared/shot.js +53 -0
  242. package/kits/hub-game/code/shared/spin.js +57 -0
  243. package/kits/hub-game/code/systems/hub.js +1753 -202
  244. package/kits/hub-game/docs/analytics.md +279 -0
  245. package/kits/hub-game/docs/content-pack.md +1 -1
  246. package/kits/hub-game/docs/contract.md +3475 -77
  247. package/kits/hub-game/docs/home-pieces.md +71 -0
  248. package/kits/hub-game/docs/observed-progress.md +252 -0
  249. package/kits/hub-game/main.jsx +2 -0
  250. package/kits/hub-game/models/avatar-10.pxmodel +28 -0
  251. package/kits/hub-game/models/avatar-11.pxmodel +28 -0
  252. package/kits/hub-game/models/avatar-12.pxmodel +27 -0
  253. package/kits/hub-game/models/avatar-13.pxmodel +24 -0
  254. package/kits/hub-game/models/avatar-14.pxmodel +29 -0
  255. package/kits/hub-game/models/avatar-15.pxmodel +24 -0
  256. package/kits/hub-game/models/avatar-4.pxmodel +29 -0
  257. package/kits/hub-game/models/avatar-5.pxmodel +27 -0
  258. package/kits/hub-game/models/avatar-6.pxmodel +26 -0
  259. package/kits/hub-game/models/avatar-7.pxmodel +25 -0
  260. package/kits/hub-game/models/avatar-8.pxmodel +24 -0
  261. package/kits/hub-game/models/avatar-9.pxmodel +30 -0
  262. package/kits/hub-game/models/earned/badge-round.pxmodel +100 -0
  263. package/kits/hub-game/models/earned/badge-shield.pxmodel +117 -0
  264. package/kits/hub-game/models/earned/badge-star.pxmodel +87 -0
  265. package/kits/hub-game/models/earned/belt-plain.pxmodel +72 -0
  266. package/kits/hub-game/models/earned/held-ball.pxmodel +43 -0
  267. package/kits/hub-game/models/earned/held-lantern.pxmodel +85 -0
  268. package/kits/hub-game/models/earned/held-net.pxmodel +57 -0
  269. package/kits/hub-game/models/earned/held-trophy.pxmodel +109 -0
  270. package/kits/hub-game/models/earned/pin-round.pxmodel +62 -0
  271. package/kits/hub-game/models/earned/sash-plain.pxmodel +66 -0
  272. package/kits/hub-game/models/earned/square/belt-plain.pxmodel +104 -0
  273. package/kits/hub-game/models/earned/square/sash-plain.pxmodel +98 -0
  274. package/kits/hub-game/models/hats/bat-clip.pxmodel +206 -0
  275. package/kits/hub-game/models/hats/beekeeper.pxmodel +149 -0
  276. package/kits/hub-game/models/hats/cap.pxmodel +162 -0
  277. package/kits/hub-game/models/hats/captain.pxmodel +178 -0
  278. package/kits/hub-game/models/hats/crooked-top.pxmodel +172 -0
  279. package/kits/hub-game/models/hats/flower-crown.pxmodel +451 -0
  280. package/kits/hub-game/models/hats/foam-crown.pxmodel +179 -0
  281. package/kits/hub-game/models/hats/lantern.pxmodel +230 -0
  282. package/kits/hub-game/models/hats/laurel.pxmodel +533 -0
  283. package/kits/hub-game/models/hats/lighthouse.pxmodel +96 -0
  284. package/kits/hub-game/models/hats/sailor.pxmodel +141 -0
  285. package/kits/hub-game/models/hats/souwester.pxmodel +131 -0
  286. package/kits/hub-game/models/hats/straw.pxmodel +139 -0
  287. package/kits/hub-game/models/hats/sunflower.pxmodel +406 -0
  288. package/kits/hub-game/models/hats/sweatband.pxmodel +112 -0
  289. package/kits/hub-game/models/hats/witch.pxmodel +147 -0
  290. package/kits/hub-game/package-lock.json +10 -1
  291. package/kits/hub-game/package.json +6 -2
  292. package/kits/hub-game/play/player.js +142 -0
  293. package/kits/hub-game/play/registry.js +47 -0
  294. package/kits/hub-game/play.jsx +37 -0
  295. package/kits/hub-game/scripts/check.mjs +117 -16
  296. package/kits/hub-game/scripts/companion-follower-wire.json +1 -0
  297. package/kits/hub-game/scripts/fixtures/decor-keyless-draw.json +132 -0
  298. package/kits/hub-game/scripts/fixtures/decor-keyless.json +293 -0
  299. package/kits/hub-game/scripts/fixtures/engine-models-stub.mjs +26 -0
  300. package/kits/hub-game/scripts/fixtures/fake-dom.mjs +123 -0
  301. package/kits/hub-game/scripts/fixtures/interest-legacy.json +385 -0
  302. package/kits/hub-game/scripts/fixtures/npc-notes-v1.77.jsonl +4 -0
  303. package/kits/hub-game/scripts/fixtures/vis-shared-wire.json +1 -0
  304. package/kits/hub-game/scripts/gen-avatars.mjs +933 -16
  305. package/kits/hub-game/scripts/gen-earned.mjs +285 -0
  306. package/kits/hub-game/scripts/gen-hats.mjs +827 -0
  307. package/kits/hub-game/scripts/grab.before-orbit.mjs +400 -0
  308. package/kits/hub-game/scripts/pose-storage-fixture.mjs +46 -0
  309. package/kits/hub-game/scripts/soundscape-wave-analysis.mjs +125 -0
  310. package/kits/hub-game/scripts/test-act-client.mjs +186 -0
  311. package/kits/hub-game/scripts/test-act.mjs +171 -0
  312. package/kits/hub-game/scripts/test-action-layout.mjs +80 -0
  313. package/kits/hub-game/scripts/test-action-observers.mjs +46 -0
  314. package/kits/hub-game/scripts/test-actions-client.mjs +853 -0
  315. package/kits/hub-game/scripts/test-actions.mjs +298 -0
  316. package/kits/hub-game/scripts/test-actor-budget.mjs +44 -0
  317. package/kits/hub-game/scripts/test-actors.mjs +38 -23
  318. package/kits/hub-game/scripts/test-analytics.mjs +76 -0
  319. package/kits/hub-game/scripts/test-anonymous-entry.mjs +28 -0
  320. package/kits/hub-game/scripts/test-arrival-pose-server.mjs +196 -0
  321. package/kits/hub-game/scripts/test-arrival-pose.mjs +24 -0
  322. package/kits/hub-game/scripts/test-ask-client.mjs +358 -0
  323. package/kits/hub-game/scripts/test-ask-slot.mjs +85 -0
  324. package/kits/hub-game/scripts/test-ask.mjs +269 -0
  325. package/kits/hub-game/scripts/test-attention.mjs +10 -1
  326. package/kits/hub-game/scripts/test-avatar-cap.mjs +379 -0
  327. package/kits/hub-game/scripts/test-avatar-colors.mjs +72 -0
  328. package/kits/hub-game/scripts/test-avatar-models.mjs +181 -0
  329. package/kits/hub-game/scripts/test-avatar-share.mjs +318 -0
  330. package/kits/hub-game/scripts/test-avatar-wire.mjs +792 -0
  331. package/kits/hub-game/scripts/test-avatar.mjs +584 -7
  332. package/kits/hub-game/scripts/test-back-visibility.mjs +82 -0
  333. package/kits/hub-game/scripts/test-ballot.mjs +1008 -0
  334. package/kits/hub-game/scripts/test-ban-join.mjs +121 -13
  335. package/kits/hub-game/scripts/test-build.mjs +49 -0
  336. package/kits/hub-game/scripts/test-cells.mjs +71 -0
  337. package/kits/hub-game/scripts/test-chat.mjs +863 -0
  338. package/kits/hub-game/scripts/test-classic.mjs +2 -0
  339. package/kits/hub-game/scripts/test-companion-chat.mjs +216 -0
  340. package/kits/hub-game/scripts/test-companion-client.mjs +1167 -0
  341. package/kits/hub-game/scripts/test-companion.mjs +259 -0
  342. package/kits/hub-game/scripts/test-control-layout-dom.mjs +120 -0
  343. package/kits/hub-game/scripts/test-crowd-names.mjs +205 -0
  344. package/kits/hub-game/scripts/test-decor-client.mjs +344 -0
  345. package/kits/hub-game/scripts/test-decor.mjs +464 -0
  346. package/kits/hub-game/scripts/test-default-environment-root.mjs +95 -0
  347. package/kits/hub-game/scripts/test-default-environment.mjs +267 -0
  348. package/kits/hub-game/scripts/test-door-analytics.mjs +58 -0
  349. package/kits/hub-game/scripts/test-door-jump.mjs +100 -0
  350. package/kits/hub-game/scripts/test-earned-client.mjs +459 -0
  351. package/kits/hub-game/scripts/test-earned.mjs +1224 -0
  352. package/kits/hub-game/scripts/test-emote-bubble.mjs +110 -0
  353. package/kits/hub-game/scripts/test-far-avatars.mjs +340 -0
  354. package/kits/hub-game/scripts/test-fps-telemetry.mjs +112 -0
  355. package/kits/hub-game/scripts/test-frame-batch.mjs +252 -0
  356. package/kits/hub-game/scripts/test-fresh-friends.mjs +118 -0
  357. package/kits/hub-game/scripts/test-friend-bests.mjs +435 -0
  358. package/kits/hub-game/scripts/test-grab-orbit.mjs +961 -0
  359. package/kits/hub-game/scripts/test-grab.mjs +7 -0
  360. package/kits/hub-game/scripts/test-hats.mjs +422 -168
  361. package/kits/hub-game/scripts/test-high-only.mjs +170 -0
  362. package/kits/hub-game/scripts/test-hub-leaving.mjs +203 -0
  363. package/kits/hub-game/scripts/test-hub-ops.mjs +758 -2
  364. package/kits/hub-game/scripts/test-hub-trip.mjs +1594 -12
  365. package/kits/hub-game/scripts/test-hud-clear.mjs +484 -57
  366. package/kits/hub-game/scripts/test-hud-defects-dom.mjs +100 -0
  367. package/kits/hub-game/scripts/test-hud-rate.mjs +224 -0
  368. package/kits/hub-game/scripts/test-hud-safe-visibility-dom.mjs +83 -0
  369. package/kits/hub-game/scripts/test-idle.mjs +427 -1
  370. package/kits/hub-game/scripts/test-interest-cap.mjs +36 -0
  371. package/kits/hub-game/scripts/test-interest-cells.mjs +513 -0
  372. package/kits/hub-game/scripts/test-interest-client.mjs +118 -0
  373. package/kits/hub-game/scripts/test-interest.mjs +15 -0
  374. package/kits/hub-game/scripts/test-invites-client.mjs +430 -0
  375. package/kits/hub-game/scripts/test-invites.mjs +109 -0
  376. package/kits/hub-game/scripts/test-keys.mjs +46 -1
  377. package/kits/hub-game/scripts/test-labels.mjs +664 -0
  378. package/kits/hub-game/scripts/test-landscape-layout.mjs +194 -0
  379. package/kits/hub-game/scripts/test-list-scroll-dom.mjs +49 -0
  380. package/kits/hub-game/scripts/test-load-abandon.mjs +246 -0
  381. package/kits/hub-game/scripts/test-loading-cover.mjs +162 -0
  382. package/kits/hub-game/scripts/test-manifest.mjs +472 -0
  383. package/kits/hub-game/scripts/test-menu-client.mjs +585 -0
  384. package/kits/hub-game/scripts/test-menu.mjs +319 -0
  385. package/kits/hub-game/scripts/test-npcs.mjs +2528 -13
  386. package/kits/hub-game/scripts/test-object-entry.mjs +76 -0
  387. package/kits/hub-game/scripts/test-observed.mjs +745 -0
  388. package/kits/hub-game/scripts/test-pack.mjs +7 -0
  389. package/kits/hub-game/scripts/test-pad-cues.mjs +304 -0
  390. package/kits/hub-game/scripts/test-pad-occupancy.mjs +177 -0
  391. package/kits/hub-game/scripts/test-picker.mjs +541 -0
  392. package/kits/hub-game/scripts/test-placement-cache.mjs +690 -0
  393. package/kits/hub-game/scripts/test-progress-reset.mjs +559 -0
  394. package/kits/hub-game/scripts/test-push-visit.mjs +26 -0
  395. package/kits/hub-game/scripts/test-quality.mjs +385 -0
  396. package/kits/hub-game/scripts/test-rehello.mjs +1733 -0
  397. package/kits/hub-game/scripts/test-relations-among.mjs +222 -0
  398. package/kits/hub-game/scripts/test-relations-refresh.mjs +188 -0
  399. package/kits/hub-game/scripts/test-resume-action-order.mjs +598 -0
  400. package/kits/hub-game/scripts/test-resume-held.mjs +239 -0
  401. package/kits/hub-game/scripts/test-resume-pose.mjs +142 -0
  402. package/kits/hub-game/scripts/test-safe-events-dom.mjs +116 -0
  403. package/kits/hub-game/scripts/test-safe-layout.mjs +330 -0
  404. package/kits/hub-game/scripts/test-say.mjs +1 -1
  405. package/kits/hub-game/scripts/test-shot.mjs +901 -0
  406. package/kits/hub-game/scripts/test-signin-client.mjs +45 -0
  407. package/kits/hub-game/scripts/test-soundscape.mjs +5437 -0
  408. package/kits/hub-game/scripts/test-spin.mjs +314 -0
  409. package/kits/hub-game/scripts/test-standing.mjs +449 -0
  410. package/kits/hub-game/scripts/test-storage-limit.mjs +333 -0
  411. package/kits/hub-game/scripts/test-stuck.mjs +1904 -0
  412. package/kits/hub-game/scripts/test-talk-overlay-dom.mjs +130 -0
  413. package/kits/hub-game/scripts/test-tier-cells.mjs +706 -0
  414. package/kits/hub-game/scripts/test-tiers-render.mjs +412 -0
  415. package/kits/hub-game/scripts/test-tiers.mjs +476 -2
  416. package/kits/hub-game/scripts/test-toast-band.mjs +61 -0
  417. package/kits/hub-game/scripts/test-try-on.mjs +22 -22
  418. package/kits/hub-game/scripts/test-vis.mjs +770 -0
  419. package/kits/hub-game/scripts/test-visibility.mjs +134 -0
  420. package/kits/hub-game/scripts/test-weakest-tier.mjs +924 -0
  421. package/kits/hub-game/scripts/test-world-labels.mjs +367 -0
  422. package/kits/hub-game/scripts/test-yours-chrome.mjs +210 -0
  423. package/kits/hub-game/scripts/test-yours.mjs +403 -0
  424. package/kits/multiplayer-3d/CLAUDE.md +50 -0
  425. package/kits/multiplayer-3d/castle.json +5 -5
  426. package/kits/multiplayer-3d/code/client/avatars.js +7 -0
  427. package/kits/multiplayer-3d/code/client/gait.js +65 -0
  428. package/kits/multiplayer-3d/code/client/joinFailure.js +27 -0
  429. package/kits/multiplayer-3d/code/client/nameTags.js +59 -4
  430. package/kits/multiplayer-3d/code/client/resumeGate.js +139 -0
  431. package/kits/multiplayer-3d/code/options.js +5 -0
  432. package/kits/multiplayer-3d/code/server/ownership.js +10 -2
  433. package/kits/multiplayer-3d/code/server/sceneBodies.js +12 -0
  434. package/kits/multiplayer-3d/code/server/world.js +7 -0
  435. package/kits/multiplayer-3d/code/systems/multiplayer.js +443 -34
  436. package/kits/multiplayer-3d/package-lock.json +8 -1
  437. package/kits/multiplayer-3d/package.json +3 -1
  438. package/kits/multiplayer-3d/scripts/fixtures/README.md +11 -0
  439. package/kits/multiplayer-3d/scripts/fixtures/ownership-legacy.json +2 -0
  440. package/kits/multiplayer-3d/scripts/ownership-harness.mjs +102 -0
  441. package/kits/multiplayer-3d/scripts/ownership-loader.mjs +46 -0
  442. package/kits/multiplayer-3d/scripts/ownership-worker.mjs +15 -0
  443. package/kits/multiplayer-3d/scripts/record-ownership-session.mjs +98 -0
  444. package/kits/multiplayer-3d/scripts/test-eligible-claims.mjs +167 -0
  445. package/kits/multiplayer-3d/scripts/test-join-watchdog.mjs +436 -0
  446. package/kits/multiplayer-3d/scripts/test-own-name-tag.mjs +247 -0
  447. package/kits/multiplayer-3d/scripts/test-resume-gate.mjs +624 -0
  448. package/kits/physics-2d/CLAUDE.md +19 -1
  449. package/kits/physics-2d/castle.json +2 -2
  450. package/kits/physics-2d/engine/frozenActors.js +233 -0
  451. package/kits/physics-2d/engine/scene.js +337 -3
  452. package/kits/physics-2d/engine/skyKey.js +129 -0
  453. package/kits/physics-2d/engine/stillClock.js +106 -0
  454. package/kits/physics-2d/engine/updateBudget.js +21 -0
  455. package/kits/physics-2d/eslint.config.js +1 -1
  456. package/kits/physics-2d/play/behaviors/AnalogStick.js +198 -0
  457. package/kits/physics-2d/play/behaviors/Camera.js +40 -0
  458. package/kits/physics-2d/play/behaviors/Collider.js +122 -0
  459. package/kits/physics-2d/play/behaviors/Draggable.js +115 -0
  460. package/kits/physics-2d/play/behaviors/Goal.js +46 -0
  461. package/kits/physics-2d/play/behaviors/Joints.js +126 -0
  462. package/kits/physics-2d/play/behaviors/Layout.js +71 -0
  463. package/kits/physics-2d/play/behaviors/RigidBody.js +57 -0
  464. package/kits/physics-2d/play/behaviors/Slingshot.js +142 -0
  465. package/kits/physics-2d/play/behaviors/SoundPlayer.js +263 -0
  466. package/kits/physics-2d/play/behaviors/Sprite.js +406 -0
  467. package/kits/physics-2d/play/behaviors/Style.js +209 -0
  468. package/kits/physics-2d/play/behaviors/Text.js +85 -0
  469. package/kits/physics-2d/play/behaviors/Video.js +93 -0
  470. package/kits/physics-2d/scripts/test-skip-unchanged.mjs +326 -1
  471. package/kits/physics-3d/CLAUDE.md +42 -529
  472. package/kits/physics-3d/behaviors/Body.jsx +3 -0
  473. package/kits/physics-3d/behaviors/Model.jsx +3 -0
  474. package/kits/physics-3d/behaviors/Player.jsx +661 -87
  475. package/kits/physics-3d/behaviors/Shape.jsx +3 -0
  476. package/kits/physics-3d/behaviors/Solid.jsx +3 -0
  477. package/kits/physics-3d/behaviors/Transform.jsx +3 -0
  478. package/kits/physics-3d/castle.json +3 -3
  479. package/kits/physics-3d/docs/engine-camera.md +542 -0
  480. package/kits/physics-3d/docs/engine-frame-cap.md +136 -0
  481. package/kits/physics-3d/docs/engine-load.md +149 -0
  482. package/kits/physics-3d/docs/engine-look.md +114 -0
  483. package/kits/physics-3d/docs/engine-shadows.md +372 -0
  484. package/kits/physics-3d/docs/engine-skip-work.md +187 -0
  485. package/kits/physics-3d/docs/engine-sky.md +198 -0
  486. package/kits/physics-3d/docs/engine-static-actors.md +226 -0
  487. package/kits/physics-3d/docs/engine-view.md +37 -0
  488. package/kits/physics-3d/docs/pxmodel-format.md +9 -1
  489. package/kits/physics-3d/engine3d/PlayOnly3D.jsx +5 -1
  490. package/kits/physics-3d/engine3d/Scene3DPlayer.jsx +19 -277
  491. package/kits/physics-3d/engine3d/actornode.js +87 -0
  492. package/kits/physics-3d/engine3d/animationBudget.js +23 -0
  493. package/kits/physics-3d/engine3d/branches.js +3 -13
  494. package/kits/physics-3d/engine3d/cage.js +2 -7
  495. package/kits/physics-3d/engine3d/cageops.js +2 -17
  496. package/kits/physics-3d/engine3d/dataBehaviors.js +12 -0
  497. package/kits/physics-3d/engine3d/editorWorld.js +6 -0
  498. package/kits/physics-3d/engine3d/emptynodes.js +232 -0
  499. package/kits/physics-3d/engine3d/framecap.js +99 -0
  500. package/kits/physics-3d/engine3d/frozenphysics.js +140 -0
  501. package/kits/physics-3d/engine3d/frozenstatics.js +273 -0
  502. package/kits/physics-3d/engine3d/gait.js +126 -0
  503. package/kits/physics-3d/engine3d/initialModelFiles.js +18 -0
  504. package/kits/physics-3d/engine3d/kithooks.js +47 -0
  505. package/kits/physics-3d/engine3d/look.js +514 -48
  506. package/kits/physics-3d/engine3d/lookbake.js +208 -0
  507. package/kits/physics-3d/engine3d/materialpresets.js +2 -0
  508. package/kits/physics-3d/engine3d/modelFiles.js +3 -17
  509. package/kits/physics-3d/engine3d/modelMath.js +49 -0
  510. package/kits/physics-3d/engine3d/modelready.js +16 -0
  511. package/kits/physics-3d/engine3d/motion.js +39 -10
  512. package/kits/physics-3d/engine3d/nearshadows.js +106 -21
  513. package/kits/physics-3d/engine3d/optimize.js +9 -5
  514. package/kits/physics-3d/engine3d/orbitinput.js +522 -10
  515. package/kits/physics-3d/engine3d/orbitlens.js +48 -0
  516. package/kits/physics-3d/engine3d/ownmodel.js +213 -0
  517. package/kits/physics-3d/engine3d/partgeometry.js +1 -16
  518. package/kits/physics-3d/engine3d/paths.js +1 -9
  519. package/kits/physics-3d/engine3d/playTimings.js +50 -0
  520. package/kits/physics-3d/engine3d/playerRun.js +372 -0
  521. package/kits/physics-3d/engine3d/pxmodel.js +42 -11
  522. package/kits/physics-3d/engine3d/rapier.js +27 -0
  523. package/kits/physics-3d/engine3d/scatter.js +1 -11
  524. package/kits/physics-3d/engine3d/shadowfade.js +890 -0
  525. package/kits/physics-3d/engine3d/sky.js +547 -0
  526. package/kits/physics-3d/engine3d/skylife.js +306 -0
  527. package/kits/physics-3d/engine3d/squarefirst.js +177 -0
  528. package/kits/physics-3d/engine3d/stillshadows.js +399 -0
  529. package/kits/physics-3d/engine3d/sweep.js +1 -25
  530. package/kits/physics-3d/engine3d/unchanged.js +11 -0
  531. package/kits/physics-3d/engine3d/viewrange.js +52 -0
  532. package/kits/physics-3d/engine3d/world3d.js +1253 -76
  533. package/kits/physics-3d/eslint.config.js +2 -1
  534. package/kits/physics-3d/main.jsx +10 -2
  535. package/kits/physics-3d/package-lock.json +7 -0
  536. package/kits/physics-3d/package.json +5 -1
  537. package/kits/physics-3d/play/behaviors/Body.js +31 -0
  538. package/kits/physics-3d/play/behaviors/Door.js +37 -0
  539. package/kits/physics-3d/play/behaviors/Lookable.js +16 -0
  540. package/kits/physics-3d/play/behaviors/Model.js +23 -0
  541. package/kits/physics-3d/play/behaviors/Pickup.js +46 -0
  542. package/kits/physics-3d/play/behaviors/Player.js +1204 -0
  543. package/kits/physics-3d/play/behaviors/Shape.js +47 -0
  544. package/kits/physics-3d/play/behaviors/Solid.js +16 -0
  545. package/kits/physics-3d/play/behaviors/Transform.js +29 -0
  546. package/kits/physics-3d/pnpm-lock.yaml +8 -0
  547. package/kits/physics-3d/scripts/bench-shadow-fade.mjs +37 -0
  548. package/kits/physics-3d/scripts/build-rapier-gz.mjs +56 -0
  549. package/kits/physics-3d/scripts/frozen-statics-fixture.mjs +141 -0
  550. package/kits/physics-3d/scripts/look-baseline.mjs +155 -0
  551. package/kits/physics-3d/scripts/test-camera-follow.mjs +5 -1
  552. package/kits/physics-3d/scripts/test-camera-orbit.mjs +2613 -82
  553. package/kits/physics-3d/scripts/test-drop-empty-parts.mjs +2 -2
  554. package/kits/physics-3d/scripts/test-empty-gait-hints.mjs +89 -0
  555. package/kits/physics-3d/scripts/test-frame-cap-bob.mjs +438 -0
  556. package/kits/physics-3d/scripts/test-frame-cap.mjs +452 -0
  557. package/kits/physics-3d/scripts/test-frozen-nested.mjs +49 -0
  558. package/kits/physics-3d/scripts/test-frozen-statics-legacy-physics2d.mjs +123 -0
  559. package/kits/physics-3d/scripts/test-frozen-statics.mjs +434 -0
  560. package/kits/physics-3d/scripts/test-gait.mjs +387 -0
  561. package/kits/physics-3d/scripts/test-look-bake.mjs +1056 -0
  562. package/kits/physics-3d/scripts/test-model-parse-cache.mjs +92 -0
  563. package/kits/physics-3d/scripts/test-near-shadows.mjs +5 -2
  564. package/kits/physics-3d/scripts/test-orbit-shadow-fade.mjs +2001 -0
  565. package/kits/physics-3d/scripts/test-orbit-shift-lock.mjs +582 -0
  566. package/kits/physics-3d/scripts/test-orbit-shot.mjs +657 -0
  567. package/kits/physics-3d/scripts/test-orbit-view.mjs +230 -0
  568. package/kits/physics-3d/scripts/test-rapier-gz.mjs +106 -0
  569. package/kits/physics-3d/scripts/test-skip-empty-nodes.mjs +845 -0
  570. package/kits/physics-3d/scripts/test-sky.mjs +2470 -0
  571. package/kits/physics-3d/scripts/test-square-first.mjs +921 -0
  572. package/kits/physics-3d/scripts/test-static-actors.mjs +10 -1
  573. package/kits/physics-3d/scripts/test-static-physics.mjs +4 -1
  574. package/kits/physics-3d/scripts/test-static-scenery.mjs +2174 -0
  575. package/kits/physics-3d/scripts/test-steady-hover.mjs +7 -2
  576. package/kits/physics-3d/scripts/test-still-shadows.mjs +477 -0
  577. package/kits/physics-3d/scripts/test-view-range.mjs +260 -0
  578. package/kits/physics-3d/systems/physics3d.js +419 -9
  579. package/kits/real-time/castle.json +2 -2
  580. package/kits/real-time/code/client/connection.js +33 -10
  581. package/kits/real-time/code/client/gameHooks.js +2 -0
  582. package/kits/real-time/code/client/joinOverlay.js +9 -4
  583. package/kits/real-time/code/server/gameHooks.js +7 -0
  584. package/kits/real-time/code/server/session.js +102 -22
  585. package/kits/real-time/package-lock.json +1 -1
  586. package/package.json +2 -2
  587. package/dist/shell/assets/index-Cf61cNfT.css +0 -1
@@ -0,0 +1,770 @@
1
+ // Per-viewer actor visibility (contract v1.62), real server and client hooks.
2
+ import assert from 'node:assert/strict';
3
+ import { readFileSync } from 'node:fs';
4
+ import { register } from 'node:module';
5
+
6
+ const sceneStub = 'export const readScene = () => globalThis.__hubTestActors ?? [];';
7
+ const avatarsStub = 'export function dropMissing() {}';
8
+ register(
9
+ `data:text/javascript,${encodeURIComponent(`
10
+ import { readFile } from 'node:fs/promises';
11
+ import { fileURLToPath } from 'node:url';
12
+ const stubs = {
13
+ '@imports/castle.multiplayer-3d/code/server/sceneBodies.js': 'data:text/javascript,${encodeURIComponent(sceneStub)}',
14
+ '@imports/castle.multiplayer-3d/code/client/avatars.js': 'data:text/javascript,${encodeURIComponent(avatarsStub)}',
15
+ 'castle-web-sdk': ${JSON.stringify(new URL('./fixtures/sdk-stub.mjs', import.meta.url).href)},
16
+ };
17
+ export async function resolve(specifier, context, next) {
18
+ 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 };
19
+ 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 };
20
+ if (stubs[specifier]) {
21
+ return { url: stubs[specifier], shortCircuit: true };
22
+ }
23
+ return next(specifier, context);
24
+ }
25
+ // The hook layer reads the deck's castle.json through the bundler.
26
+ export async function load(url, context, next) {
27
+ if (url.endsWith('/code/client/hookLayer.js')) {
28
+ const source = await readFile(fileURLToPath(url), 'utf8');
29
+ return { format: 'module', source: source.replaceAll('import.meta.glob(', '(() => ({}))('), shortCircuit: true };
30
+ }
31
+ return next(url, context);
32
+ }
33
+ `)}`,
34
+ );
35
+
36
+ const { layer } = await import('../code/server/hub.js');
37
+ const hook = (await import('../code/client/hookLayer.js')).default;
38
+ const State = await import('../code/client/state.js');
39
+ const Vis = await import('../code/server/vis.js');
40
+ const { CONTRACT_VERSION } = await import('../code/server/manifest.js');
41
+
42
+ const actors = [
43
+ { id: 'spawn', components: { Player: {}, Transform: { x: 0, y: 1, z: 0 } } },
44
+ ...Array.from({ length: 257 }, (_, i) => ({ id: `trophy-${i}`, components: {
45
+ Transform: { x: 2, y: 3, z: 4 }, Model: { file: 'models/trophy.pxmodel' },
46
+ } })),
47
+ ];
48
+ function boot(keys = {}, more = {}) {
49
+ const sent = [], enabled = [];
50
+ const players = structuredClone(more.players ?? [
51
+ { playerId: 'p1', userId: '101', username: 'Ada', isAnonymous: false },
52
+ { playerId: 'p2', userId: '102', username: 'Bo', isAnonymous: false },
53
+ ]);
54
+ const session = { sessionId: more.sessionId ?? 'test', players, send: (id, msg) => sent.push([id, structuredClone(msg)]), broadcast: (msg) => sent.push(['all', structuredClone(msg)]) };
55
+ const world = { timeMs: 0, scenePath: 'scenes/main.scene',
56
+ players: new Map(players.map(({ playerId }) => [playerId, { at: { x: 0, y: 1, z: 0 }, facing: 0, body: { setTranslation() {} } }])),
57
+ bodies: new Map([['trophy-0', { setEnabled: (value) => enabled.push(value) }]]) };
58
+ let hub;
59
+ globalThis.__hubTestActors = more.actors ?? actors;
60
+ const server = layer({ server: { maxPlayers: 8 }, hub: { contract: 1, title: 'Town', ...keys } }, {
61
+ ready(ctx) { hub = ctx; },
62
+ resume: more.resume,
63
+ leave: more.leave,
64
+ }, {}, () => true);
65
+ server.sceneFor(session);
66
+ server.ready(world);
67
+ const step = (ms = 0) => { world.timeMs += ms; server.place(world); server.step(world); };
68
+ const hello = (id, extra = {}) => server.message(session, { playerId: id }, { k: 'hub-hello', avatar: 0, ...extra });
69
+ return { sent, enabled, players, session, world, server, hub, step, hello };
70
+ }
71
+ const visibility = (r) => r.sent.filter(([, msg]) => msg.k === 'hub-vis');
72
+ const playerBody = () => ({ at: { x: 0, y: 1, z: 0 }, facing: 0, body: { setTranslation() {} } });
73
+ const arrive = (r) => {
74
+ r.hello('p1');
75
+ r.hello('p2');
76
+ r.step(2000);
77
+ r.step();
78
+ };
79
+ const drop = (r, id = 'p1') => {
80
+ r.session.players = r.session.players.filter((p) => p.playerId !== id);
81
+ r.world.players.delete(id);
82
+ };
83
+ const back = (r, player = { playerId: 'p1', userId: '101', username: 'Ada', isAnonymous: false }) => {
84
+ r.session.players.push(player);
85
+ r.world.players.set(player.playerId, playerBody());
86
+ };
87
+ const warnings = [];
88
+ const warn = console.warn, log = console.log;
89
+ console.warn = (...args) => warnings.push(args.join(' '));
90
+ console.log = () => {};
91
+ let passed = 0;
92
+ function test(name, fn) {
93
+ try {
94
+ State.clear();
95
+ warnings.length = 0;
96
+ fn();
97
+ passed += 1;
98
+ log(`ok: ${name}`);
99
+ } catch (error) {
100
+ console.warn = warn;
101
+ console.log = log;
102
+ console.error(`FAIL: ${name}`);
103
+ throw error;
104
+ }
105
+ }
106
+
107
+ // Captured from the pre-v1.62 server, including the order of every wire key.
108
+ function sharedWire(r) {
109
+ const out = [];
110
+ const capture = () => out.push([r.server.join(), r.server.delta(), r.sent.splice(0)]);
111
+ capture();
112
+ r.step(); capture();
113
+ assert.equal(r.hub.hide('trophy-0'), undefined);
114
+ r.step(); capture();
115
+ assert.equal(r.hub.show('trophy-0'), undefined);
116
+ r.step(); capture();
117
+ r.step(); capture();
118
+ return JSON.stringify(out);
119
+ }
120
+
121
+ test('shared-only snapshots, deltas and messages are byte-identical to v1.61', () => {
122
+ assert.equal(CONTRACT_VERSION, 1, 'optional v1.62 keeps the manifest/wire major');
123
+ const r = boot();
124
+ const wire = sharedWire(r);
125
+ assert.equal(wire, readFileSync(new URL('./fixtures/vis-shared-wire.json', import.meta.url), 'utf8').trim());
126
+ assert.ok(!wire.includes('hub-vis'));
127
+ assert.deepEqual(r.enabled, [false, true]);
128
+ });
129
+
130
+ test('resumeVisibility requires an authored resume hook', () => {
131
+ const messages = [];
132
+ const error = console.error;
133
+ console.error = (...args) => messages.push(args.join(' '));
134
+ try {
135
+ const invalid = layer({ server: { maxPlayers: 8 }, hub: {
136
+ contract: 1,
137
+ title: 'Town',
138
+ result: { score: { unit: 's', better: 'lower' } },
139
+ resume: { keep: true },
140
+ resumeVisibility: true,
141
+ } }, { ready() {} }, {}, () => true);
142
+ assert.equal(invalid.persist, false);
143
+ assert.match(messages.join('\n'), /resumeVisibility requires an exported resume hook/);
144
+ } finally {
145
+ console.error = error;
146
+ }
147
+ });
148
+
149
+ test('private overrides reach only named connected viewers, without shared changes', () => {
150
+ const r = boot();
151
+ const before = JSON.stringify(r.server.join());
152
+ assert.equal(r.hub.hide('trophy-0', { to: ['p1', 'missing', 'p1'] }), true);
153
+ assert.equal(r.hub.show('trophy-1', { to: ['p1'] }), true);
154
+ r.step();
155
+ assert.deepEqual(visibility(r), [['p1', { k: 'hub-vis', hide: ['trophy-0'], show: ['trophy-1'] }]]);
156
+ assert.equal(JSON.stringify(r.server.join()), before);
157
+ assert.deepEqual(r.enabled, [], 'private visibility does not toggle bodies');
158
+ const count = visibility(r).length;
159
+ r.step();
160
+ r.hub.hide('trophy-0', { to: ['p1'] });
161
+ r.step();
162
+ assert.equal(visibility(r).length, count, 'equal override sets are suppressed');
163
+ r.session.players = [r.players[1]];
164
+ assert.equal(r.hub.hide('trophy-2', { to: ['p1'] }), true);
165
+ r.step();
166
+ assert.equal(visibility(r).length, count, 'disconnected viewers are ignored, even with a stale sim body');
167
+ });
168
+
169
+ test('private calls leave snapshot and delta bytes identical to the shared-only place', () => {
170
+ const shared = boot(), privateView = boot();
171
+ for (const op of ['hide', 'show', 'hide']) {
172
+ shared.hub[op]('trophy-0');
173
+ privateView.hub[op]('trophy-0');
174
+ privateView.hub.show('trophy-0', { to: ['p1'] });
175
+ privateView.hub.hide('trophy-1', { to: ['p2'] });
176
+ shared.step(); privateView.step();
177
+ assert.equal(JSON.stringify(privateView.server.join()), JSON.stringify(shared.server.join()));
178
+ assert.equal(JSON.stringify(privateView.server.delta()), JSON.stringify(shared.server.delta()));
179
+ assert.deepEqual(privateView.sent.filter(([, msg]) => msg.k !== 'hub-vis'), shared.sent);
180
+ }
181
+ });
182
+
183
+ test('clear via either operation restores the current shared state and sends one empty set', () => {
184
+ for (const op of ['hide', 'show']) {
185
+ const r = boot();
186
+ r.hub.hide('trophy-0');
187
+ r.hub.show('trophy-0', { to: ['p1'] });
188
+ r.hub.hide('trophy-1', { to: ['p1'] });
189
+ r.step();
190
+ for (const [, msg] of visibility(r)) { hook.message({}, msg); }
191
+ hook.state({}, { hidden: r.server.join().hidden });
192
+ assert.deepEqual([...State.hub.hidden], ['trophy-1']);
193
+ assert.equal(r.hub[op]('trophy-0', { to: ['p1'], clear: true }), true);
194
+ r.step();
195
+ hook.message({}, visibility(r).at(-1)[1]);
196
+ assert.deepEqual([...State.hub.hidden].sort(), ['trophy-0', 'trophy-1']);
197
+ r.hub[op]('trophy-1', { to: ['p1'], clear: true });
198
+ r.step();
199
+ assert.deepEqual(visibility(r).at(-1), ['p1', { k: 'hub-vis', hide: [], show: [] }]);
200
+ hook.message({}, visibility(r).at(-1)[1]);
201
+ assert.deepEqual([...State.hub.hidden], ['trophy-0']);
202
+ const count = visibility(r).length;
203
+ r.hub[op]('trophy-1', { to: ['p1'], clear: true });
204
+ r.step();
205
+ assert.equal(visibility(r).length, count);
206
+ State.clear();
207
+ }
208
+ });
209
+
210
+ test('fresh hello replays overrides, avatar-only hello does not, unused/cleared joins send nothing', () => {
211
+ const r = boot();
212
+ r.hello('p1');
213
+ assert.deepEqual(visibility(r), []);
214
+ r.hub.hide('trophy-0', { to: ['p1'] });
215
+ r.step();
216
+ r.sent.length = 0;
217
+ r.hello('p2');
218
+ r.hello('p1', { again: true });
219
+ assert.deepEqual(visibility(r), []);
220
+ r.hello('p1');
221
+ assert.deepEqual(visibility(r), [['p1', { k: 'hub-vis', hide: ['trophy-0'], show: [] }]]);
222
+ r.step();
223
+ assert.equal(visibility(r).length, 1, 'replay also updates the send cache');
224
+ r.hub.show('trophy-0', { to: ['p1'], clear: true });
225
+ r.step();
226
+ r.sent.length = 0;
227
+ r.hello('p1');
228
+ r.step();
229
+ assert.deepEqual(visibility(r), []);
230
+ });
231
+
232
+ test('departure drops overrides, even ones created before hello; another viewer keeps theirs', () => {
233
+ for (const saidHello of [false, true]) {
234
+ const r = boot();
235
+ if (saidHello) { r.hello('p1'); }
236
+ r.hub.hide('trophy-0', { to: ['p1', 'p2'] });
237
+ r.step();
238
+ r.sent.length = 0;
239
+ r.session.players = [r.players[1]];
240
+ r.world.players.delete('p1');
241
+ r.step();
242
+ assert.deepEqual(visibility(r), []);
243
+ r.session.players = r.players;
244
+ r.world.players.set('p1', { at: { x: 0, y: 1, z: 0 }, facing: 0, body: { setTranslation() {} } });
245
+ r.hello('p1');
246
+ r.step();
247
+ assert.deepEqual(visibility(r), []);
248
+ r.hello('p2');
249
+ assert.deepEqual(visibility(r), [['p2', { k: 'hub-vis', hide: ['trophy-0'], show: [] }]]);
250
+ }
251
+ });
252
+
253
+ test('resumeVisibility prepares the current merged view before replay, for fresh, repeated and silent hellos', () => {
254
+ let resumeCalls = 0;
255
+ let pendingActor = false;
256
+ let r;
257
+ r = boot(
258
+ { result: { score: { unit: 's', better: 'lower' } }, resume: { keep: true }, resumeVisibility: true },
259
+ { async resume(ctx, { playerId }) {
260
+ resumeCalls += 1;
261
+ if (pendingActor) {
262
+ ctx.hide('trophy-2', { to: [playerId] });
263
+ }
264
+ ctx.send(playerId, { k: 'authored-resume', n: resumeCalls });
265
+ await Promise.resolve(); // only the synchronous prefix can prepare the replay
266
+ } },
267
+ );
268
+ arrive(r);
269
+ r.hub.hide('trophy-0'); // shared hidden, privately shown
270
+ assert.equal(r.hub.show('trophy-0', { to: ['p1'] }), true);
271
+ assert.equal(r.hub.hide('trophy-1', { to: ['p1'] }), true); // shared visible, privately hidden
272
+ r.step();
273
+
274
+ // Ordinary resumed page: it already holds the private map. The real-time
275
+ // WORLD snapshot arrives before its hello; updating shared visibility must
276
+ // keep the merged view correct throughout that pre-authored boundary.
277
+ State.clear();
278
+ hook.state({}, { hidden: r.server.join().hidden });
279
+ hook.message({}, visibility(r).at(-1)[1]);
280
+ assert.deepEqual([...State.hub.hidden], ['trophy-1']);
281
+ drop(r);
282
+ r.step();
283
+ hook.state({}, { hidden: r.server.join().hidden });
284
+ assert.deepEqual([...State.hub.hidden], ['trophy-1'], 'WORLD before hello retains the ordinary page private map');
285
+
286
+ // A locally cleared/fresh client has only WORLD until hello. The contract
287
+ // documents this pre-hello shared-view limit; the first replayed merged
288
+ // state, below, is the boundary the server can guarantee.
289
+ State.clear();
290
+ hook.state({}, { hidden: r.server.join().hidden });
291
+ assert.deepEqual([...State.hub.hidden], ['trophy-0'], 'snapshot alone has the shared view');
292
+ back(r);
293
+ let from = r.sent.length;
294
+ r.hello('p1');
295
+ let messages = r.sent.slice(from).filter(([id]) => id === 'p1').map(([, msg]) => msg);
296
+ assert.deepEqual(messages.filter((msg) => msg.k === 'hub-vis'), [], 'stale cache is gated at hello');
297
+ assert.equal(messages.some((msg) => msg.k === 'authored-resume'), false, 'authored resume stays queued');
298
+ r.step();
299
+ messages = r.sent.slice(from).filter(([id]) => id === 'p1').map(([, msg]) => msg);
300
+ assert.ok(messages.findIndex((msg) => msg.k === 'authored-resume') < messages.findIndex((msg) => msg.k === 'hub-vis'));
301
+ hook.message({}, messages.find((msg) => msg.k === 'hub-vis'));
302
+ assert.deepEqual([...State.hub.hidden], ['trophy-1'], 'first replayed merged state has both private overrides');
303
+ assert.equal(resumeCalls, 1);
304
+
305
+ from = r.sent.length;
306
+ r.hello('p1', { resume: true });
307
+ r.hello('p1', { resume: true });
308
+ assert.equal(
309
+ r.sent.slice(from).filter(([id, msg]) => id === 'p1' && msg.k === 'hub-vis').length,
310
+ 0,
311
+ 'same-body resume hellos are gated too',
312
+ );
313
+ r.step();
314
+ assert.equal(
315
+ r.sent.slice(from).filter(([id, msg]) => id === 'p1' && msg.k === 'hub-vis').length,
316
+ 1,
317
+ 'coalesced resume hellos receive one prepared complete override',
318
+ );
319
+ assert.equal(resumeCalls, 2, 'repeated hellos coalesce their authored resume');
320
+
321
+ drop(r);
322
+ r.step();
323
+ pendingActor = true; // another player's board change while this viewer is away
324
+ hook.state({}, { hidden: r.server.join().hidden }); // live host order: WORLD precedes hello/replay
325
+ assert.deepEqual([...State.hub.hidden], ['trophy-1'], 'ordinary page retains its old mask across WORLD');
326
+ back(r);
327
+ from = r.sent.length;
328
+ r.step(); // no client hello: prepareResume sends the kit's silent one
329
+ messages = r.sent.slice(from).filter(([id]) => id === 'p1').map(([, msg]) => msg);
330
+ const visAt = messages.findIndex((msg) => msg.k === 'hub-vis');
331
+ const authoredAt = messages.findIndex((msg) => msg.k === 'authored-resume');
332
+ assert.ok(authoredAt >= 0 && visAt > authoredAt, 'silent hook prepares before its whole-map replay');
333
+ hook.message({}, messages[visAt]);
334
+ assert.deepEqual([...State.hub.hidden].sort(), ['trophy-1', 'trophy-2'], 'current offline mutation is in the first replay');
335
+ assert.equal(resumeCalls, 3);
336
+ from = r.sent.length;
337
+ r.hello('p1', { resume: true });
338
+ r.step();
339
+ assert.ok(r.sent.slice(from).some(([id, msg]) => id === 'p1' && msg.k === 'hub-vis'));
340
+ assert.equal(resumeCalls, 3, 'the companion client hello shares the silent resume signal');
341
+ });
342
+
343
+ test('same-body fresh hello prepares newly changed visibility before its first replay', () => {
344
+ let currentBoard = false;
345
+ let resumeCalls = 0;
346
+ const r = boot(
347
+ { result: { score: { unit: 's', better: 'lower' } }, resume: { keep: true }, resumeVisibility: true },
348
+ { resume(ctx, { playerId }) {
349
+ resumeCalls += 1;
350
+ if (currentBoard) { ctx.hide('trophy-2', { to: [playerId] }); }
351
+ ctx.send(playerId, { k: 'authored-resume' });
352
+ } },
353
+ );
354
+ arrive(r);
355
+ r.hub.hide('trophy-0');
356
+ r.hub.show('trophy-0', { to: ['p1'] });
357
+ r.hub.hide('trophy-1', { to: ['p1'] });
358
+ r.step();
359
+
360
+ State.clear();
361
+ hook.state({}, { hidden: r.server.join().hidden });
362
+ currentBoard = true; // board changed immediately before a same-body reload hello
363
+ const body = r.world.players.get('p1');
364
+ const from = r.sent.length;
365
+ r.hello('p1');
366
+ assert.equal(r.world.players.get('p1'), body, 'no absence or body replacement creates the gate');
367
+ assert.deepEqual(r.sent.slice(from).filter(([id, msg]) => id === 'p1' && msg.k === 'hub-vis'), []);
368
+ r.step();
369
+ const messages = r.sent.slice(from).filter(([id]) => id === 'p1').map(([, msg]) => msg);
370
+ const visAt = messages.findIndex((msg) => msg.k === 'hub-vis');
371
+ const authoredAt = messages.findIndex((msg) => msg.k === 'authored-resume');
372
+ assert.ok(authoredAt >= 0 && authoredAt < visAt, 'current mask is authored before the first replay');
373
+ hook.message({}, messages[visAt]);
374
+ assert.deepEqual([...State.hub.hidden].sort(), ['trophy-1', 'trophy-2']);
375
+ assert.equal(resumeCalls, 1);
376
+ });
377
+
378
+ test('roster-only absence retains visibility identity and the original 60-second deadline', () => {
379
+ const realNow = Date.now;
380
+ let now = realNow();
381
+ Date.now = () => now;
382
+ try {
383
+ let currentBoard = false;
384
+ let resumeCalls = 0;
385
+ const r = boot(
386
+ { result: { score: { unit: 's', better: 'lower' } }, resume: { keep: true }, resumeVisibility: true },
387
+ { resume(ctx, { playerId }) {
388
+ resumeCalls += 1;
389
+ if (currentBoard) {
390
+ for (const actorId of ['trophy-3', 'trophy-4', 'trophy-5']) {
391
+ ctx.hide(actorId, { to: [playerId] });
392
+ }
393
+ }
394
+ ctx.send(playerId, { k: 'authored-resume' });
395
+ } },
396
+ );
397
+ arrive(r);
398
+ // Exercise an explicitly empty prior private map, as after a board turn
399
+ // whose old targets were all cleared.
400
+ r.hub.hide('trophy-0', { to: ['p1'] });
401
+ r.step();
402
+ r.hub.hide('trophy-0', { to: ['p1'], clear: true });
403
+ r.step();
404
+
405
+ const retainedBody = r.world.players.get('p1');
406
+ r.session.players = r.session.players.filter((player) => player.playerId !== 'p1');
407
+ r.step();
408
+ now += 30000;
409
+ r.step(); // the host still has the body through multiple roster-absent ticks
410
+ assert.equal(r.world.players.get('p1'), retainedBody);
411
+ currentBoard = true; // another viewer advances the board while p1 is away
412
+ State.clear();
413
+ hook.state({}, { hidden: r.server.join().hidden });
414
+ r.session.players.push(r.players[0]);
415
+ const from = r.sent.length;
416
+ r.hello('p1', { resume: true });
417
+ assert.deepEqual(
418
+ r.sent.slice(from).filter(([id, msg]) => id === 'p1' && msg.k === 'hub-vis'),
419
+ [],
420
+ 'the retained empty map cannot clear before current masks are authored',
421
+ );
422
+ r.step();
423
+ const messages = r.sent.slice(from).filter(([id]) => id === 'p1').map(([, msg]) => msg);
424
+ const authoredAt = messages.findIndex((msg) => msg.k === 'authored-resume');
425
+ const returningVis = messages.filter((msg) => msg.k === 'hub-vis');
426
+ assert.equal(resumeCalls, 1);
427
+ assert.equal(returningVis.length, 1);
428
+ assert.ok(authoredAt >= 0 && authoredAt < messages.findIndex((msg) => msg.k === 'hub-vis'));
429
+ assert.deepEqual(returningVis[0].hide, ['trophy-3', 'trophy-4', 'trophy-5']);
430
+ hook.message({}, returningVis[0]);
431
+ assert.deepEqual([...State.hub.hidden].sort(), ['trophy-3', 'trophy-4', 'trophy-5']);
432
+
433
+ let leaves = 0;
434
+ const expired = boot(
435
+ { result: { score: { unit: 's', better: 'lower' } }, resume: { keep: true }, resumeVisibility: true },
436
+ { resume() {}, leave() { leaves += 1; } },
437
+ );
438
+ arrive(expired);
439
+ expired.hub.hide('trophy-0', { to: ['p1'] });
440
+ expired.step();
441
+ const expiredBody = expired.world.players.get('p1');
442
+ expired.session.players = expired.session.players.filter((player) => player.playerId !== 'p1');
443
+ expired.step();
444
+ now += 59999;
445
+ expired.step();
446
+ assert.equal(leaves, 0);
447
+ assert.equal(expired.world.players.get('p1'), expiredBody);
448
+ now += 1;
449
+ expired.step();
450
+ assert.equal(leaves, 1, 'retained body ticks cannot refresh the 60-second absence deadline');
451
+ } finally {
452
+ Date.now = realNow;
453
+ }
454
+ });
455
+
456
+ test('resume hook rehellos defer normally and fail closed during retained preparation', () => {
457
+ for (const retainedVisibility of [false, true]) {
458
+ const calls = [];
459
+ const leaves = [];
460
+ let queueInsideHook = true;
461
+ let r;
462
+ const keys = retainedVisibility
463
+ ? { result: { score: { unit: 's', better: 'lower' } }, resume: { keep: true }, resumeVisibility: true }
464
+ : {};
465
+ r = boot(keys, {
466
+ resume(ctx, { playerId }) {
467
+ calls.push(playerId);
468
+ if (queueInsideHook) {
469
+ queueInsideHook = false;
470
+ r.hello('p1', { resume: true });
471
+ r.hello('p2', { resume: true });
472
+ }
473
+ },
474
+ leave(ctx, playerId) { leaves.push(playerId); },
475
+ });
476
+ arrive(r);
477
+ if (retainedVisibility) {
478
+ r.hub.hide('trophy-0', { to: ['p1'] });
479
+ r.step();
480
+ drop(r);
481
+ r.step();
482
+ back(r);
483
+ }
484
+ r.hello('p1', { resume: true });
485
+ r.step();
486
+ assert.deepEqual(calls, ['p1'], 'hook-created hellos do not enter the second drain');
487
+ r.step();
488
+ if (retainedVisibility) {
489
+ assert.deepEqual(calls, ['p1'], 'retained preparation never pauses the next authored step');
490
+ assert.deepEqual(leaves.sort(), ['p1', 'p2'], 'hook-created retained visits end through normal cleanup');
491
+ } else {
492
+ assert.deepEqual(calls.slice(1).sort(), ['p1', 'p2'], 'marker-absent signals survive once for the next step');
493
+ assert.deepEqual(leaves, []);
494
+ }
495
+ }
496
+ });
497
+
498
+ test('resumeVisibility is default-off and never replays to a changed trusted identity', () => {
499
+ const keys = { result: { score: { unit: 's', better: 'lower' } }, resume: { keep: true } };
500
+ {
501
+ const r = boot(keys);
502
+ arrive(r);
503
+ r.hub.hide('trophy-0', { to: ['p1'] });
504
+ r.step();
505
+ drop(r);
506
+ r.step();
507
+ back(r, { playerId: 'p1', userId: '999', username: 'Eve', isAnonymous: false });
508
+ const from = r.sent.length;
509
+ r.hello('p1', { resume: true });
510
+ r.step();
511
+ const changed = r.sent.slice(from).filter(([id, msg]) => id === 'p1' && msg.k === 'hub-vis');
512
+ assert.ok(changed.every(([, msg]) => msg.hide.length === 0 && msg.show.length === 0),
513
+ 'absent marker keeps legacy cleanup');
514
+ }
515
+ for (const returning of [
516
+ { playerId: 'p1', userId: '999', username: 'Eve', isAnonymous: false, why: 'changed account' },
517
+ { playerId: 'p1', userId: '101', username: 'Guest', isAnonymous: true, why: 'same raw id but anonymous' },
518
+ { playerId: 'p1', username: 'Unknown', isAnonymous: false, why: 'missing identity' },
519
+ ]) {
520
+ const r = boot({ ...keys, resumeVisibility: true }, { resume() {} });
521
+ arrive(r);
522
+ r.hub.hide('trophy-0', { to: ['p1'] });
523
+ r.step();
524
+ drop(r);
525
+ r.step();
526
+ back(r, returning);
527
+ const from = r.sent.length;
528
+ r.hello('p1', { resume: true });
529
+ r.step();
530
+ const changed = r.sent.slice(from).filter(([id, msg]) => id === 'p1' && msg.k === 'hub-vis');
531
+ assert.ok(changed.length <= 1);
532
+ assert.ok(changed.every(([, msg]) => msg.hide.length === 0 && msg.show.length === 0),
533
+ `${returning.why} receives only a cache clear`);
534
+ drop(r);
535
+ r.step();
536
+ back(r);
537
+ const again = r.sent.length;
538
+ r.hello('p1', { resume: true });
539
+ r.step();
540
+ const switchedBack = r.sent.slice(again).filter(([id, msg]) => id === 'p1' && msg.k === 'hub-vis');
541
+ assert.ok(switchedBack.every(([, msg]) => msg.hide.length === 0 && msg.show.length === 0),
542
+ 'deleted cache cannot be recovered by switching the roster identity back');
543
+ }
544
+ });
545
+
546
+ test('identity replacement between hello and step cancels retained preparation', () => {
547
+ for (const replacement of [
548
+ { playerId: 'p1', userId: '999', username: 'Eve', isAnonymous: false, why: 'changed identity' },
549
+ { playerId: 'p1', username: 'Unknown', isAnonymous: false, why: 'missing identity' },
550
+ ]) {
551
+ let resumeCalls = 0;
552
+ const r = boot(
553
+ { result: { score: { unit: 's', better: 'lower' } }, resume: { keep: true }, resumeVisibility: true },
554
+ { resume(ctx, { playerId }) {
555
+ resumeCalls += 1;
556
+ ctx.hide('trophy-2', { to: [playerId] });
557
+ ctx.send(playerId, { k: 'authored-resume' });
558
+ } },
559
+ );
560
+ arrive(r);
561
+ r.hub.hide('trophy-0', { to: ['p1'] });
562
+ r.step();
563
+
564
+ let from = r.sent.length;
565
+ r.hello('p1', { resume: true });
566
+ assert.deepEqual(r.sent.slice(from).filter(([id, msg]) => id === 'p1' && msg.k === 'hub-vis'), []);
567
+ r.session.players = [r.players[1], replacement];
568
+ r.step();
569
+ let messages = r.sent.slice(from).filter(([id]) => id === 'p1').map(([, msg]) => msg);
570
+ assert.equal(resumeCalls, 0, `${replacement.why} cancels the old queued resume`);
571
+ assert.equal(messages.some((msg) => msg.k === 'authored-resume'), false);
572
+ assert.ok(messages.filter((msg) => msg.k === 'hub-vis')
573
+ .every((msg) => msg.hide.length === 0 && msg.show.length === 0),
574
+ `${replacement.why} receives no private actor ids`);
575
+
576
+ // Switching back is another identity boundary: it cannot recover the old
577
+ // trophy-0 cache or the resume signal queued under the replacement.
578
+ r.session.players = [r.players[1], r.players[0]];
579
+ from = r.sent.length;
580
+ r.hello('p1', { resume: true });
581
+ r.step();
582
+ messages = r.sent.slice(from).filter(([id]) => id === 'p1').map(([, msg]) => msg);
583
+ assert.ok(resumeCalls <= 1);
584
+ assert.ok(messages.filter((msg) => msg.k === 'hub-vis')
585
+ .every((msg) => !msg.hide.includes('trophy-0') && !msg.show.includes('trophy-0')),
586
+ 'switching back cannot recover the deleted private map');
587
+ }
588
+ });
589
+
590
+ test('resumeVisibility cache is deleted on the 60-second boundary and explicit kit travel', () => {
591
+ const realNow = Date.now;
592
+ let now = realNow();
593
+ Date.now = () => now;
594
+ try {
595
+ const keys = { result: { score: { unit: 's', better: 'lower' } }, resume: { keep: true }, resumeVisibility: true };
596
+ const expired = boot(keys, { resume() {} });
597
+ arrive(expired);
598
+ expired.hub.hide('trophy-0', { to: ['p1'] });
599
+ expired.step();
600
+ drop(expired);
601
+ expired.step();
602
+ now += 60000;
603
+ expired.step();
604
+ back(expired);
605
+ let from = expired.sent.length;
606
+ expired.hello('p1', { resume: true });
607
+ expired.step();
608
+ assert.ok(expired.sent.slice(from).filter(([id, msg]) => id === 'p1' && msg.k === 'hub-vis')
609
+ .every(([, msg]) => msg.hide.length === 0 && msg.show.length === 0), 'expiry can only clear the old view');
610
+
611
+ const door = { id: 'door-lobby', components: {
612
+ Transform: { x: 1, y: 1, z: 1 },
613
+ HubDoor: { id: 'lobby', to: 'lobby', title: 'Lobby' },
614
+ } };
615
+ const travelled = boot({
616
+ ...keys,
617
+ places: { lobby: { title: 'Lobby', scene: 'scenes/lobby.scene' } },
618
+ }, { sessionId: 'dev', actors: [...actors, door], resume() {} });
619
+ arrive(travelled);
620
+ travelled.hub.hide('trophy-0', { to: ['p1'] });
621
+ travelled.step();
622
+ assert.equal(typeof travelled.hub.go('lobby', ['p1']), 'string');
623
+ drop(travelled);
624
+ travelled.step();
625
+ back(travelled);
626
+ from = travelled.sent.length;
627
+ travelled.hello('p1', { resume: true });
628
+ travelled.step();
629
+ assert.ok(
630
+ travelled.sent.slice(from).filter(([id, msg]) => id === 'p1' && msg.k === 'hub-vis')
631
+ .every(([, msg]) => msg.hide.length === 0 && msg.show.length === 0),
632
+ 'kit-issued travel ends the retained visit and can only clear its visibility cache',
633
+ );
634
+ } finally {
635
+ Date.now = realNow;
636
+ }
637
+ });
638
+
639
+ test('invalid actors and malformed options warn once per kind and change nothing', () => {
640
+ const r = boot();
641
+ r.hub.hide('trophy-0', { to: ['p1'] });
642
+ r.step();
643
+ const before = JSON.stringify(r.server.join());
644
+ for (const op of ['hide', 'show']) {
645
+ for (const actor of ['missing', null, 42, {}]) {
646
+ assert.equal(r.hub[op](actor, { to: ['p1'] }), false);
647
+ }
648
+ for (const options of [null, false, [], {}, { to: 'p1' }, { to: ['p1', 42] }, { to: ['p1'], clear: 1 },
649
+ Object.defineProperty({}, 'to', { get() { throw Error('bad getter'); } })]) {
650
+ assert.equal(r.hub[op]('trophy-1', options), false);
651
+ }
652
+ }
653
+ assert.equal(warnings.filter((msg) => msg.includes('not an actor')).length, 2);
654
+ assert.equal(warnings.filter((msg) => msg.includes('visibility options')).length, 2);
655
+ r.step();
656
+ assert.equal(visibility(r).length, 1);
657
+ assert.equal(JSON.stringify(r.server.join()), before);
658
+ });
659
+
660
+ test('256 per viewer; refusal is atomic, replacement/clear works, other viewer has their own cap', () => {
661
+ const r = boot();
662
+ for (let i = 0; i < 256; i += 1) {
663
+ assert.equal(r.hub.hide(`trophy-${i}`, { to: ['p1'] }), true);
664
+ }
665
+ r.step();
666
+ assert.equal(visibility(r).at(-1)[1].hide.length, 256);
667
+ assert.equal(r.hub.hide('trophy-256', { to: ['p2', 'p1'] }), false);
668
+ assert.equal(r.hub.show('trophy-256', { to: ['p1'] }), false);
669
+ r.step();
670
+ assert.equal(visibility(r).length, 1, 'failed multi-recipient call did not change p2');
671
+ assert.equal(warnings.filter((msg) => msg.includes('at most 256')).length, 1);
672
+ assert.equal(r.hub.show('trophy-0', { to: ['p1'] }), true);
673
+ assert.equal(r.hub.show('trophy-0', { to: ['p1'], clear: true }), true);
674
+ assert.equal(r.hub.hide('trophy-256', { to: ['p1', 'p2'] }), true);
675
+ r.step();
676
+ assert.deepEqual(visibility(r).at(-1), ['p2', { k: 'hub-vis', hide: ['trophy-256'], show: [] }]);
677
+ assert.equal(visibility(r).at(-2)[1].hide.length, 256);
678
+ });
679
+
680
+ test('unchanged effective override set sends nothing, including clear/reinsert ordering', () => {
681
+ const r = boot();
682
+ r.hub.hide('trophy-1', { to: ['p1'] });
683
+ r.hub.hide('trophy-0', { to: ['p1'] });
684
+ r.step();
685
+ r.hub.show('trophy-1', { to: ['p1'], clear: true });
686
+ r.hub.hide('trophy-1', { to: ['p1'] });
687
+ r.step();
688
+ assert.equal(visibility(r).length, 1);
689
+ const h = { actors, spawned: new Map(), session: r.session };
690
+ Vis.joinedAfresh(h, 'p1');
691
+ Vis.prune(h); Vis.send(h); Vis.forget(h, 'p1');
692
+ assert.deepEqual(Object.keys(h), ['actors', 'spawned', 'session'], 'unused place allocates no visibility maps');
693
+ });
694
+
695
+ test('a despawned copy drops its private overrides and frees the slot', () => {
696
+ actors.push({ id: 'crate', components: { Transform: { x: 1, y: 0.5, z: 1 }, Shape: { kind: 'box', width: 1, height: 1, depth: 1, color: '#888888' } } });
697
+ let r, id;
698
+ try {
699
+ r = boot();
700
+ id = r.hub.spawn('crate', { x: 1, y: 0.5, z: 2 });
701
+ } finally {
702
+ actors.pop();
703
+ }
704
+ assert.equal(typeof id, 'string', `spawned a copy (${JSON.stringify(id)}; ${warnings.join(' | ')})`);
705
+ assert.equal(r.hub.hide(id, { to: ['p1'] }), true);
706
+ r.step();
707
+ assert.deepEqual(visibility(r).at(-1), ['p1', { k: 'hub-vis', hide: [id], show: [] }]);
708
+ r.hub.despawn(id);
709
+ r.step();
710
+ assert.deepEqual(visibility(r).at(-1), ['p1', { k: 'hub-vis', hide: [], show: [] }]);
711
+ for (let i = 0; i < 256; i += 1) {
712
+ assert.equal(r.hub.hide(`trophy-${i}`, { to: ['p1'] }), true, 'the despawned copy holds no slot');
713
+ }
714
+ });
715
+
716
+ test('real client state merges shared hidden with private show/hide in either arrival order', () => {
717
+ for (const privateFirst of [false, true]) {
718
+ State.clear();
719
+ const shared = () => hook.state({}, { hidden: ['trophy-0'] });
720
+ const privateView = () => hook.message({}, { k: 'hub-vis', hide: ['trophy-1'], show: ['trophy-0'] });
721
+ if (privateFirst) { privateView(); shared(); } else { shared(); privateView(); }
722
+ assert.deepEqual([...State.hub.hidden], ['trophy-1']);
723
+ hook.state({}, { hidden: [] });
724
+ assert.deepEqual([...State.hub.hidden], ['trophy-1']);
725
+ hook.state({}, { hidden: ['trophy-0', 'trophy-2'] });
726
+ assert.deepEqual([...State.hub.hidden].sort(), ['trophy-1', 'trophy-2']);
727
+ State.clear();
728
+ for (const key of ['hidden', 'hiddenAll', 'hiddenMe', 'shownMe']) { assert.equal(State.hub[key].size, 0); }
729
+ hook.state({}, { hidden: ['trophy-0'] });
730
+ assert.deepEqual([...State.hub.hidden], ['trophy-0'], 'scene/place/leave reset retains no show override');
731
+ }
732
+ });
733
+
734
+ test('drawing re-applies both transitions from merged changes, including Models and static actors', () => {
735
+ // Extract the production method, as the lifecycle tests do, avoiding the
736
+ // full UI runtime. The same method runs both each frame and after behaviors.
737
+ const source = readFileSync(new URL('../code/systems/hub.js', import.meta.url), 'utf8');
738
+ const method = source.slice(source.indexOf(' applyVisibility(scene) {'), source.indexOf('\n // Copies the place spawned'));
739
+ const apply = new Function('Hub', 'HIDE_DROP_M', `return ({${method}}).applyVisibility;`)(State, 10000);
740
+ const actor = structuredClone(actors[1]);
741
+ const touches = [];
742
+ const scene = { getActor: (id) => id === actor.id ? actor : null, touch: (id) => touches.push(id) };
743
+ const drawing = { stash: new Map() };
744
+ const frame = () => apply.call(drawing, scene);
745
+ hook.state({}, { hidden: [actor.id] });
746
+ frame(); frame();
747
+ assert.equal(actor.components.Transform.y, -9997);
748
+ hook.message({}, { k: 'hub-vis', hide: [], show: [actor.id] });
749
+ frame(); frame();
750
+ assert.equal(actor.components.Transform.y, 3);
751
+ hook.message({}, { k: 'hub-vis', hide: [], show: [] });
752
+ frame();
753
+ assert.equal(actor.components.Transform.y, -9997);
754
+ hook.state({}, { hidden: [] });
755
+ frame();
756
+ assert.equal(actor.components.Transform.y, 3);
757
+ hook.message({}, { k: 'hub-vis', hide: [actor.id], show: [] });
758
+ frame();
759
+ assert.equal(actor.components.Transform.y, -9997);
760
+ hook.message({}, { k: 'hub-vis', hide: [], show: [] });
761
+ frame();
762
+ assert.equal(actor.components.Transform.y, 3);
763
+ assert.equal(touches.length, 6, 'each transition touches the static actor, repeated frames do not');
764
+ assert.equal(drawing.stash.size, 0);
765
+ });
766
+
767
+ console.warn = warn;
768
+ console.log = log;
769
+ State.clear();
770
+ console.log(`test-vis: ${passed} passed`);