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,901 @@
1
+ // Private orbit shots (contract v1.61), server delivery and real client hooks.
2
+ import assert from 'node:assert/strict';
3
+ import { register } from 'node:module';
4
+
5
+ const sceneStub = 'export const readScene = () => globalThis.__hubTestActors ?? [];';
6
+ const avatarsStub = 'export function dropMissing() {}';
7
+ register(
8
+ `data:text/javascript,${encodeURIComponent(`
9
+ import { readFile } from 'node:fs/promises';
10
+ import { fileURLToPath } from 'node:url';
11
+ const stubs = {
12
+ '@imports/castle.multiplayer-3d/code/server/sceneBodies.js': 'data:text/javascript,${encodeURIComponent(sceneStub)}',
13
+ '@imports/castle.multiplayer-3d/code/client/avatars.js': 'data:text/javascript,${encodeURIComponent(avatarsStub)}',
14
+ 'castle-web-sdk': ${JSON.stringify(new URL('./fixtures/sdk-stub.mjs', import.meta.url).href)},
15
+ };
16
+ export async function resolve(specifier, context, next) {
17
+ 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 };
18
+ 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 };
19
+ if (stubs[specifier]) {
20
+ return { url: stubs[specifier], shortCircuit: true };
21
+ }
22
+ return next(specifier, context);
23
+ }
24
+ // The hook layer reads the deck's castle.json through the bundler.
25
+ export async function load(url, context, next) {
26
+ if (url.endsWith('/code/client/hookLayer.js')) {
27
+ const source = await readFile(fileURLToPath(url), 'utf8');
28
+ return { format: 'module', source: source.replaceAll('import.meta.glob(', '(() => ({}))('), shortCircuit: true };
29
+ }
30
+ return next(url, context);
31
+ }
32
+ `)}`,
33
+ );
34
+
35
+ const { layer } = await import('../code/server/hub.js');
36
+ const hook = (await import('../code/client/hookLayer.js')).default;
37
+ const State = await import('../code/client/state.js');
38
+ const { shot, joinedAfresh, forgetPlayer, stopHolding } = await import('../code/server/shot.js');
39
+ const ShotClient = await import('../code/client/shot.js');
40
+ const { shotValue } = await import('../code/shared/shot.js');
41
+ const { fittedDistance } = await import('../code/client/shotFit.js');
42
+ const { faceArrivalCamera } = await import('../code/client/arrivalCamera.js');
43
+ const clearShot = () => ShotClient.clearShot();
44
+ const pose = () => ({ look: { x: 1, y: 2, z: 3 }, distance: 8, pitch: 30, yaw: 45 });
45
+ const sent = [];
46
+ let clientTime = 0;
47
+ const warnings = [];
48
+ const warn = console.warn;
49
+ const log = console.log;
50
+ console.warn = (...args) => warnings.push(args.join(' '));
51
+ console.log = () => {};
52
+ let n = 0;
53
+ function test(name, fn) {
54
+ try {
55
+ State.clear();
56
+ clientTime = 0;
57
+ warnings.length = 0;
58
+ fn();
59
+ n += 1;
60
+ } catch (err) {
61
+ console.warn = warn;
62
+ console.log = log;
63
+ console.error(`FAIL ${name}`);
64
+ throw err;
65
+ } finally {
66
+ clearShot();
67
+ }
68
+ }
69
+ function serverState() {
70
+ sent.length = 0;
71
+ return {
72
+ warned: new Set(),
73
+ players: new Map(['p1', 'p2'].map((id) => [id, { arrived: true, ended: false }])),
74
+ sim: { timeMs: 0, players: new Map([['p1', {}], ['p2', {}]]) },
75
+ session: { players: [{ playerId: 'p1' }, { playerId: 'p2' }], send: (id, msg) => sent.push([id, msg]) },
76
+ };
77
+ }
78
+
79
+ test('private delivery, plain copied pose, no broadcast, pitch capped', () => {
80
+ const h = serverState();
81
+ const value = { ...pose(), pitch: 100, extra: 'discard', look: { ...pose().look, extra: 99 } };
82
+ assert.equal(shot(h, 'p1', value), true);
83
+ assert.deepEqual(sent, [['p1', { k: 'hub-shot', shot: { ...pose(), pitch: 89 } }]]);
84
+ assert.notEqual(sent[0][1].shot, value);
85
+ assert.notEqual(sent[0][1].shot.look, value.look);
86
+ value.look.x = 100;
87
+ assert.equal(sent[0][1].shot.look.x, 1);
88
+ assert.equal(shot(h, 'p2', { ...pose(), pitch: -100 }), true);
89
+ assert.equal(sent[1][1].shot.pitch, -89);
90
+ });
91
+
92
+ test('null and every invalid finite field clear, invalid values warn only once', () => {
93
+ const bad = [undefined, {}, [], false, { ...pose(), look: null }, { ...pose(), distance: 0 }, { ...pose(), distance: -1 }];
94
+ for (const value of [NaN, Infinity, -Infinity, '1']) {
95
+ for (const field of ['distance', 'pitch', 'yaw']) {
96
+ bad.push({ ...pose(), [field]: value });
97
+ }
98
+ for (const field of ['x', 'y', 'z']) {
99
+ bad.push({ ...pose(), look: { ...pose().look, [field]: value } });
100
+ }
101
+ }
102
+ bad.push(Object.defineProperty({}, 'look', { get() { throw Error('bad getter'); } }));
103
+ const h = serverState();
104
+ for (const value of bad) {
105
+ assert.equal(shot(h, 'p1', pose()), true);
106
+ assert.equal(shot(h, 'p1', value), true);
107
+ assert.deepEqual(sent.at(-1), ['p1', { k: 'hub-shot', shot: null }]);
108
+ h.sim.timeMs += 1000;
109
+ }
110
+ assert.equal(warnings.filter((s) => s.includes('invalid shot; clearing')).length, 1);
111
+ assert.equal(shot(h, 'p1', pose()), true);
112
+ assert.equal(shot(h, 'p1', null), true);
113
+ });
114
+
115
+ test('unknown, unarrived, ended, disconnected and unsendable players refuse once', () => {
116
+ for (const change of [
117
+ (h) => h.players.delete('p1'),
118
+ (h) => { h.players.get('p1').arrived = false; },
119
+ (h) => { h.players.get('p1').ended = true; },
120
+ (h) => h.sim.players.delete('p1'),
121
+ (h) => { h.session.players = [{ playerId: 'p2' }]; },
122
+ (h) => { delete h.session.send; },
123
+ ]) {
124
+ const h = serverState();
125
+ change(h);
126
+ const before = warnings.length;
127
+ assert.equal(shot(h, 'p1', pose()), false);
128
+ assert.equal(shot(h, 'p1', null), false);
129
+ assert.equal(warnings.length, before + 1);
130
+ assert.equal(sent.length, 0);
131
+ assert.equal(Object.hasOwn(h, 'shotBudgets'), false);
132
+ }
133
+ const h = serverState();
134
+ for (const id of [null, {}, 1, 'missing']) {
135
+ assert.equal(shot(h, id, pose()), false);
136
+ }
137
+ });
138
+
139
+ test('equal values spend nothing; bounded repeat, per-player refill, clear despite exhausted budget', () => {
140
+ const h = serverState();
141
+ assert.equal(shot(h, 'p1', pose()), true);
142
+ for (let i = 0; i < 20; i += 1) {
143
+ assert.equal(shot(h, 'p1', pose()), false);
144
+ }
145
+ assert.equal(sent.length, 1);
146
+ assert.equal(h.shotBudgets.get('p1').tokens, 3);
147
+ assert.equal(warnings.length, 1);
148
+ for (let yaw = 1; yaw <= 3; yaw += 1) {
149
+ assert.equal(shot(h, 'p1', { ...pose(), yaw }), true);
150
+ }
151
+ assert.equal(shot(h, 'p1', { ...pose(), yaw: 4 }), false);
152
+ assert.equal(shot(h, 'p2', pose()), true);
153
+ assert.equal(shot(h, 'p1', null), true);
154
+ assert.equal(shot(h, 'p1', null), false);
155
+ h.sim.timeMs = 250;
156
+ assert.equal(shot(h, 'p1', pose()), true);
157
+ h.sim.timeMs = 1249;
158
+ assert.equal(shot(h, 'p1', pose()), false);
159
+ h.sim.timeMs = 1250;
160
+ assert.equal(shot(h, 'p1', pose()), true);
161
+ });
162
+
163
+ test('fresh join renews a held pose privately without deleting or spending its budget', () => {
164
+ const h = serverState();
165
+ joinedAfresh(h, 'p1');
166
+ assert.equal(Object.hasOwn(h, 'shotBudgets'), false);
167
+ assert.equal(Object.hasOwn(h, 'renewShots'), false);
168
+ assert.equal(sent.length, 0);
169
+ assert.equal(shot(h, 'p1', pose()), true);
170
+ assert.equal(shot(h, 'p2', pose()), true);
171
+ const otherBudget = h.shotBudgets.get('p2');
172
+ const budget = h.shotBudgets.get('p1');
173
+ sent.length = 0;
174
+ joinedAfresh(h, 'p1');
175
+ assert.deepEqual(sent, [['p1', { k: 'hub-shot', shot: pose(), lease: true }]]);
176
+ assert.equal(h.shotBudgets.get('p1'), budget);
177
+ assert.equal(budget.tokens, 3);
178
+ assert.equal(h.shotBudgets.get('p2'), otherBudget);
179
+ forgetPlayer(h, 'p1');
180
+ assert.equal(sent.length, 1, 'departure sends nothing to the gone player');
181
+ assert.equal(h.shotBudgets.has('p1'), false);
182
+ forgetPlayer(h, 'p2');
183
+ assert.equal(sent.length, 1, 'departure sends nothing to the gone player');
184
+ assert.equal(h.shotBudgets.has('p2'), false);
185
+ assert.equal(Object.hasOwn(h, 'renewShots'), false);
186
+ });
187
+
188
+ test('fresh join sends nothing after null or an unsuccessful shot send', () => {
189
+ const h = serverState();
190
+ assert.equal(shot(h, 'p1', null), true);
191
+ sent.length = 0;
192
+ joinedAfresh(h, 'p1');
193
+ assert.equal(sent.length, 0);
194
+ h.session.send = () => { throw Error('send failed'); };
195
+ assert.equal(shot(h, 'p1', pose()), false);
196
+ assert.equal(h.shotBudgets.get('p1').key, 'null', 'a failed send retains the last accepted clear');
197
+ h.session.send = (id, msg) => sent.push([id, msg]);
198
+ joinedAfresh(h, 'p1');
199
+ assert.equal(sent.length, 0);
200
+ assert.equal(Object.hasOwn(h, 'renewShots'), false);
201
+ });
202
+
203
+ test('held poses renew every 2 s of sim time, without roster iteration, budget cost or catch-up bursts', () => {
204
+ const h = serverState();
205
+ for (let yaw = 0; yaw < 4; yaw += 1) {
206
+ assert.equal(shot(h, 'p1', { ...pose(), yaw }), true);
207
+ }
208
+ const budget = h.shotBudgets.get('p1');
209
+ assert.equal(budget.tokens, 0);
210
+ h.session.players = new Proxy([], { get() { throw Error('renewal read the roster'); } });
211
+ h.players[Symbol.iterator] = h.sim.players[Symbol.iterator] = () => { throw Error('renewal iterated players'); };
212
+ sent.length = 0;
213
+ h.sim.timeMs = 1999;
214
+ h.renewShots();
215
+ assert.equal(sent.length, 0);
216
+ for (const now of [2000, 4000, 60000]) {
217
+ h.sim.timeMs = now;
218
+ h.renewShots();
219
+ assert.deepEqual(sent.at(-1), ['p1', { k: 'hub-shot', shot: { ...pose(), yaw: 3 }, lease: true }]);
220
+ assert.equal(budget.tokens, 0);
221
+ assert.equal(budget.sentAt, 0);
222
+ const count = sent.length;
223
+ h.renewShots();
224
+ assert.equal(sent.length, count, 'one renewal per interval, including after a stall');
225
+ }
226
+ assert.equal(sent.length, 3);
227
+ });
228
+
229
+ test('clear stops only that player renewing; last clear and forget remove the renewal callback', () => {
230
+ const h = serverState();
231
+ shot(h, 'p1', pose());
232
+ shot(h, 'p2', pose());
233
+ sent.length = 0;
234
+ assert.equal(shot(h, 'p1', null), true);
235
+ assert.equal(shot(h, 'p1', null), false);
236
+ assert.deepEqual(sent, [['p1', { k: 'hub-shot', shot: null }]]);
237
+ h.sim.timeMs = 2000;
238
+ h.renewShots();
239
+ assert.deepEqual(sent.at(-1), ['p2', { k: 'hub-shot', shot: pose(), lease: true }]);
240
+ assert.equal(shot(h, 'p2', null), true);
241
+ assert.equal(Object.hasOwn(h, 'renewShots'), false);
242
+ const count = sent.length;
243
+ h.sim.timeMs = 6000;
244
+ h.renewShots?.();
245
+ joinedAfresh(h, 'p1');
246
+ joinedAfresh(h, 'p2');
247
+ assert.equal(sent.length, count);
248
+ shot(h, 'p1', pose());
249
+ forgetPlayer(h, 'p1');
250
+ assert.equal(Object.hasOwn(h, 'renewShots'), false);
251
+ });
252
+
253
+ test('unused server has no shot state, renewal callback or renewal messages', () => {
254
+ const h = serverState();
255
+ const keys = Object.keys(h);
256
+ for (let i = 0; i < 20; i += 1) {
257
+ h.sim.timeMs = i * 2000;
258
+ h.renewShots?.();
259
+ joinedAfresh(h, 'p1');
260
+ forgetPlayer(h, 'missing');
261
+ }
262
+ assert.deepEqual(Object.keys(h), keys);
263
+ assert.equal(sent.length, 0);
264
+ });
265
+
266
+ function bootServer(hooks = {}, { sessionId = 'test', actors = [], manifest = {} } = {}) {
267
+ const delivered = [];
268
+ const players = [{ playerId: 'p1' }, { playerId: 'p2' }];
269
+ const session = { sessionId, players, send: (id, msg) => delivered.push([id, msg]), broadcast() {} };
270
+ const world = { timeMs: 0, scenePath: 'scenes/main.scene', bodies: new Map(), players: new Map(players.map((p) => [p.playerId,
271
+ { at: { x: 0, y: 1, z: 0 }, facing: 0, body: { setTranslation() {} } }])) };
272
+ let hub;
273
+ globalThis.__hubTestActors = actors;
274
+ const server = layer({ server: { maxPlayers: 8 }, hub: { contract: 1, title: 'Town', ...manifest } }, { ...hooks, ready(ctx) { hub = ctx; } }, {}, () => true);
275
+ server.sceneFor(session);
276
+ server.ready(world);
277
+ const hello = (extra = {}) => server.message(session, players[0], { k: 'hub-hello', avatar: 0, ...extra });
278
+ hello();
279
+ server.place(world);
280
+ return { delivered, players, session, world, hub, server, hello };
281
+ }
282
+
283
+ test('layer exposes shot; no snapshot/delta fields; fresh hello renews and departure forgets', () => {
284
+ const { delivered, players, session, world, hub, server, hello } = bootServer();
285
+ assert.equal(hub.shot('p1', pose()), true);
286
+ assert.equal(hub.shot('p1', pose()), false);
287
+ assert.deepEqual(delivered.filter(([, msg]) => msg.k === 'hub-shot'), [['p1', { k: 'hub-shot', shot: pose() }]]);
288
+ assert.ok(!JSON.stringify(server.join()).includes('hub-shot'));
289
+ assert.ok(!JSON.stringify(server.delta()).includes('hub-shot'));
290
+ delivered.length = 0;
291
+ hello();
292
+ assert.deepEqual(delivered.filter(([, msg]) => msg.k === 'hub-shot'), [['p1', { k: 'hub-shot', shot: pose(), lease: true }]]);
293
+ assert.equal(hub.shot('p1', pose()), false, 'fresh hello preserves the explicit-call budget');
294
+ delivered.length = 0;
295
+ session.players = [];
296
+ world.players.clear();
297
+ server.place(world);
298
+ session.players = players;
299
+ world.players.set('p1', { at: { x: 0, y: 1, z: 0 }, facing: 0, body: { setTranslation() {} } });
300
+ hello();
301
+ server.place(world);
302
+ assert.equal(delivered.some(([, msg]) => msg.k === 'hub-shot'), false, 'forget and a later hello send no clear to a gone player');
303
+ assert.equal(hub.shot('p1', pose()), true);
304
+ });
305
+
306
+ test('production server step renews held shots and sends none when unused or cleared', () => {
307
+ const r = bootServer();
308
+ for (const now of [2000, 4000, 6000]) {
309
+ r.world.timeMs = now;
310
+ r.server.step(r.world);
311
+ }
312
+ assert.equal(r.delivered.some(([, msg]) => msg.k === 'hub-shot'), false);
313
+ assert.equal(r.hub.shot('p1', pose()), true);
314
+ r.delivered.length = 0;
315
+ r.world.timeMs = 7999;
316
+ r.server.step(r.world);
317
+ assert.equal(r.delivered.some(([, msg]) => msg.k === 'hub-shot'), false);
318
+ r.world.timeMs = 8000;
319
+ r.server.step(r.world);
320
+ assert.deepEqual(r.delivered.filter(([, msg]) => msg.k === 'hub-shot'), [['p1', { k: 'hub-shot', shot: pose(), lease: true }]]);
321
+ r.hub.shot('p1', null);
322
+ r.delivered.length = 0;
323
+ r.world.timeMs = 16000;
324
+ r.server.step(r.world);
325
+ assert.equal(r.delivered.some(([, msg]) => msg.k === 'hub-shot'), false);
326
+ });
327
+
328
+ test('fresh hello when no shot was sent sends no shot messages; avatar hello retains the budget', () => {
329
+ const { delivered, hub, hello } = bootServer();
330
+ delivered.length = 0;
331
+ hello();
332
+ hello();
333
+ assert.equal(delivered.some(([, msg]) => msg.k === 'hub-shot'), false);
334
+ assert.equal(hub.shot('p1', pose()), true);
335
+ delivered.length = 0;
336
+ hello({ again: true, avatar: 1 });
337
+ assert.equal(delivered.some(([, msg]) => msg.k === 'hub-shot'), false);
338
+ assert.equal(hub.shot('p1', pose()), false, 'avatar changes keep equal-shot suppression');
339
+ });
340
+
341
+ test('stopping a holder preserves its budget and only renews other holders', () => {
342
+ const h = serverState();
343
+ stopHolding(h, 'missing');
344
+ assert.equal(Object.hasOwn(h, 'shotBudgets'), false);
345
+ shot(h, 'p1', pose());
346
+ shot(h, 'p2', pose());
347
+ const budget = h.shotBudgets.get('p1');
348
+ const before = { tokens: budget.tokens, key: budget.key, sentAt: budget.sentAt };
349
+ stopHolding(h, 'p1');
350
+ assert.equal(h.shotBudgets.get('p1'), budget);
351
+ assert.deepEqual({ tokens: budget.tokens, key: budget.key, sentAt: budget.sentAt }, before);
352
+ assert.equal(Object.hasOwn(budget, 'pose'), false);
353
+ assert.equal(Object.hasOwn(budget, 'renewAt'), false);
354
+ sent.length = 0;
355
+ h.sim.timeMs = 2000;
356
+ joinedAfresh(h, 'p1');
357
+ h.renewShots();
358
+ assert.deepEqual(sent, [['p2', { k: 'hub-shot', shot: pose(), lease: true }]]);
359
+ stopHolding(h, 'p2');
360
+ assert.equal(Object.hasOwn(h, 'renewShots'), false);
361
+ });
362
+
363
+ test('successful hub.go stops renewals only for the departing player, without sending a clear', () => {
364
+ const r = bootServer({}, {
365
+ sessionId: 'dev',
366
+ actors: [{ id: 'door-race', components: { HubDoor: { id: 'race', to: 'race' }, Transform: {} } }],
367
+ manifest: { places: { race: { title: 'Race', scene: 'scenes/race.scene' } } },
368
+ });
369
+ r.server.message(r.session, r.players[1], { k: 'hub-hello', avatar: 0 });
370
+ r.server.place(r.world);
371
+ assert.equal(r.hub.shot('p1', pose()), true);
372
+ assert.equal(r.hub.shot('p2', pose()), true);
373
+ assert.equal(r.hub.go('missing', ['p1']), null);
374
+ r.delivered.length = 0;
375
+ assert.match(r.hub.go('race', ['p1']), /^hub\.race\./);
376
+ assert.deepEqual(r.delivered.filter(([, msg]) => msg.k === 'hub-shot'), []);
377
+ assert.deepEqual(r.delivered.filter(([, msg]) => msg.k === 'hub-go').map(([id]) => id), ['p1']);
378
+ r.hello();
379
+ r.world.timeMs = 2000;
380
+ r.server.step(r.world);
381
+ assert.deepEqual(r.delivered.filter(([, msg]) => msg.k === 'hub-shot'), [['p2', { k: 'hub-shot', shot: pose(), lease: true }]]);
382
+ });
383
+
384
+ test('hub.end drops the held pose so a later fresh hello cannot renew it', () => {
385
+ const r = bootServer();
386
+ r.hub.shot('p1', pose());
387
+ r.delivered.length = 0;
388
+ r.hub.end(['p1']);
389
+ assert.deepEqual(r.delivered.filter(([, msg]) => msg.k === 'hub-shot'), []);
390
+ assert.equal(r.delivered.some(([id, msg]) => id === 'p1' && msg.k === 'hub-end'), true);
391
+ r.hello();
392
+ r.world.timeMs = 2000;
393
+ r.server.step(r.world);
394
+ assert.deepEqual(r.delivered.filter(([, msg]) => msg.k === 'hub-shot'), []);
395
+ });
396
+
397
+ // Deterministic active-only connection watcher; no real browser/timers needed.
398
+ const realSet = globalThis.setInterval;
399
+ const realClear = globalThis.clearInterval;
400
+ const nowDescriptor = Object.getOwnPropertyDescriptor(performance, 'now');
401
+ Object.defineProperty(performance, 'now', { configurable: true, value: () => clientTime });
402
+ const timers = new Map();
403
+ let nextTimer = 0;
404
+ globalThis.setInterval = (fn, ms) => { assert.equal(ms, 100); timers.set(++nextTimer, fn); return nextTimer; };
405
+ globalThis.clearInterval = (id) => timers.delete(id);
406
+ function scene() {
407
+ return { cameraControl: 'orbit', currentScenePath: 'scenes/main.scene', sceneKey: 'main', multiplayer: { generation: 1, net: { status: () => ({ state: 'connected' }), closed: () => false } } };
408
+ }
409
+ const receive = (s, value = pose(), extra = {}) => hook.message(s, { k: 'hub-shot', shot: value, ...extra });
410
+ const watch = () => { for (const fn of [...timers.values()]) { fn(); } };
411
+
412
+ test('a lease without a received shot is ignored, with no pose or watcher', () => {
413
+ const s = scene();
414
+ receive(s, pose(), { lease: true });
415
+ assert.equal(s.orbitShot, undefined);
416
+ assert.equal(timers.size, 0);
417
+ });
418
+
419
+ test('a lease cannot change the held pose or renew a different pose', () => {
420
+ const s = scene();
421
+ receive(s);
422
+ const held = s.orbitShot;
423
+ clientTime = 2000;
424
+ receive(s, { ...pose(), yaw: 90 }, { lease: true });
425
+ assert.equal(s.orbitShot, held);
426
+ clientTime = 5001;
427
+ watch();
428
+ assert.equal(s.orbitShot, undefined);
429
+ receive(s, { ...pose(), yaw: 90 }, { lease: true });
430
+ assert.equal(s.orbitShot, undefined);
431
+ receive(s, pose(), { lease: true });
432
+ assert.deepEqual(s.orbitShot, pose(), 'an equal pose can resume after lease expiry');
433
+ });
434
+
435
+ for (const tickFirst of [false, true]) {
436
+ test('deck-owned orbitShot survives lease renewal before and after the ownership watcher', () => {
437
+ const s = scene();
438
+ receive(s);
439
+ const deckShot = pose();
440
+ s.orbitShot = deckShot;
441
+ if (tickFirst) {
442
+ watch();
443
+ }
444
+ receive(s, pose(), { lease: true });
445
+ assert.equal(s.orbitShot, deckShot);
446
+ assert.equal(timers.size, 0);
447
+ delete s.orbitShot;
448
+ receive(s, pose(), { lease: true });
449
+ assert.equal(s.orbitShot, undefined, 'the declined pose stays declined after the deck shot ends');
450
+ receive(s);
451
+ assert.deepEqual(s.orbitShot, pose(), 'a fresh explicit call can apply again');
452
+ });
453
+ }
454
+
455
+ test('equal renewals and fresh pose messages refresh the 5 s lease without replacing the shot or watcher', () => {
456
+ const s = scene();
457
+ receive(s);
458
+ const held = s.orbitShot;
459
+ const timer = [...timers.keys()][0];
460
+ for (const now of [2000, 4000, 6000]) {
461
+ clientTime = now;
462
+ receive(s, pose(), { lease: true });
463
+ watch();
464
+ assert.equal(s.orbitShot, held);
465
+ assert.deepEqual([...timers.keys()], [timer]);
466
+ }
467
+ clientTime = 8000;
468
+ receive(s);
469
+ assert.equal(s.orbitShot, held);
470
+ clientTime = 13000;
471
+ watch();
472
+ assert.equal(s.orbitShot, held, 'valid through the 5 s boundary');
473
+ clientTime = 13001;
474
+ watch();
475
+ assert.equal(s.orbitShot, undefined);
476
+ assert.equal(timers.size, 0);
477
+ });
478
+
479
+ test('restarted-server reconnect expires an old shot on the first delayed watcher callback', () => {
480
+ const oldServer = bootServer();
481
+ const s = scene();
482
+ hook.state(s, { ...oldServer.server.join(), k: 'w' }, null);
483
+ oldServer.hub.shot('p1', pose());
484
+ hook.message(s, oldServer.delivered.find(([, msg]) => msg.k === 'hub-shot')[1]);
485
+ const net = s.multiplayer.net;
486
+ const generation = s.multiplayer.generation;
487
+ const deferredWatcher = [...timers.values()][0];
488
+ // The background tab missed the disconnect. A restarted process has no
489
+ // held pose to renew, even though connectSession retains both identities.
490
+ const restarted = bootServer();
491
+ restarted.hello();
492
+ restarted.server.step(restarted.world);
493
+ assert.equal(restarted.delivered.some(([, msg]) => msg.k === 'hub-shot'), false);
494
+ hook.state(s, { ...restarted.server.join(), k: 'w' }, null);
495
+ assert.equal(s.multiplayer.net, net);
496
+ assert.equal(s.multiplayer.generation, generation);
497
+ clientTime = 5001;
498
+ deferredWatcher();
499
+ assert.equal(s.orbitShot, undefined);
500
+ assert.equal(timers.size, 0);
501
+ // A much later first callback, rather than ticking a counter, also expires.
502
+ receive(s);
503
+ const delayedAgain = [...timers.values()][0];
504
+ clientTime = 60000;
505
+ delayedAgain();
506
+ assert.equal(s.orbitShot, undefined);
507
+ assert.equal(timers.size, 0);
508
+ });
509
+
510
+ test('same-server reconnect regains its held pose through an immediate hello renewal', () => {
511
+ const r = bootServer();
512
+ const s = scene();
513
+ let status = 'connected';
514
+ s.multiplayer.net.status = () => ({ state: status });
515
+ r.hub.shot('p1', pose());
516
+ hook.message(s, r.delivered.find(([, msg]) => msg.k === 'hub-shot')[1]);
517
+ status = 'reconnecting';
518
+ watch();
519
+ assert.equal(s.orbitShot, undefined);
520
+ status = 'connected';
521
+ r.delivered.length = 0;
522
+ clientTime = 3000;
523
+ r.hello();
524
+ const messages = r.delivered.filter(([, msg]) => msg.k === 'hub-shot');
525
+ assert.deepEqual(messages, [['p1', { k: 'hub-shot', shot: pose(), lease: true }]]);
526
+ hook.message(s, messages[0][1]);
527
+ assert.deepEqual(s.orbitShot, pose());
528
+ const held = s.orbitShot;
529
+ hook.state(s, { ...r.server.join(), k: 'w' }, null);
530
+ watch();
531
+ assert.equal(s.orbitShot, held);
532
+ });
533
+
534
+ test('late fresh hello after a changed fresh shot renews that shot without clearing or restarting it', () => {
535
+ const r = bootServer();
536
+ const s = scene();
537
+ r.hub.shot('p1', pose());
538
+ const freshPose = { ...pose(), yaw: 90 };
539
+ r.hub.shot('p1', freshPose);
540
+ const freshMessage = r.delivered.filter(([, msg]) => msg.k === 'hub-shot').at(-1)[1];
541
+ hook.message(s, freshMessage);
542
+ const held = s.orbitShot;
543
+ r.delivered.length = 0;
544
+ r.hello();
545
+ const messages = r.delivered.filter(([, msg]) => msg.k === 'hub-shot');
546
+ assert.deepEqual(messages, [['p1', { k: 'hub-shot', shot: freshPose, lease: true }]]);
547
+ hook.message(s, messages[0][1]);
548
+ assert.equal(s.orbitShot, held);
549
+ assert.equal(timers.size, 1);
550
+ });
551
+
552
+ test('client copies valid pose, replaces mid-hold, clears null and invalid without leaking watcher', () => {
553
+ const s = scene();
554
+ const value = pose();
555
+ receive(s, value);
556
+ assert.deepEqual(s.orbitShot, value);
557
+ assert.notEqual(s.orbitShot, value);
558
+ assert.notEqual(s.orbitShot.look, value.look);
559
+ value.look.x = 999;
560
+ assert.equal(s.orbitShot.look.x, 1);
561
+ assert.equal(timers.size, 1);
562
+ const before = s.orbitShot;
563
+ receive(s, { ...pose(), yaw: 90 });
564
+ assert.notEqual(s.orbitShot, before);
565
+ assert.equal(s.orbitShot.yaw, 90);
566
+ assert.equal(timers.size, 1);
567
+ receive(s, null);
568
+ assert.equal(Object.hasOwn(s, 'orbitShot'), false);
569
+ assert.equal(Object.hasOwn(State.hub, 'shot'), false);
570
+ assert.equal(timers.size, 0);
571
+ receive(s);
572
+ receive(s, { ...pose(), pitch: Infinity });
573
+ assert.equal(s.orbitShot, undefined);
574
+ assert.equal(timers.size, 0);
575
+ });
576
+
577
+ test('without orbit key: no pose read, state, storage, watcher or later replay', () => {
578
+ const s = scene();
579
+ delete s.cameraControl;
580
+ const deckShot = pose();
581
+ s.orbitShot = deckShot;
582
+ receive(s, Object.defineProperty({}, 'look', { get() { throw Error('must not read'); } }));
583
+ receive(s, null);
584
+ assert.equal(s.orbitShot, deckShot);
585
+ assert.equal(Object.hasOwn(State.hub, 'shot'), false);
586
+ assert.equal(timers.size, 0);
587
+ s.cameraControl = 'orbit';
588
+ hook.state(s, { hubPlace: { id: 'main' } }, null);
589
+ watch();
590
+ assert.equal(s.orbitShot, deckShot);
591
+ });
592
+
593
+ for (const clear of [
594
+ () => clearShot(),
595
+ (s) => receive(s, null),
596
+ () => State.clear(),
597
+ (s) => hook.reset(s),
598
+ (s) => hook.dispose(s),
599
+ (s) => hook.message(s, { k: 'hub-go' }),
600
+ (s) => { s.multiplayer.net.status = () => ({ state: 'reconnecting' }); watch(); },
601
+ () => { clientTime = 5001; watch(); },
602
+ ]) {
603
+ test('cleanup preserves a deck-assigned shot, including an equal replacement', () => {
604
+ const s = scene();
605
+ receive(s);
606
+ const deckShot = pose();
607
+ s.orbitShot = deckShot;
608
+ clear(s);
609
+ assert.equal(s.orbitShot, deckShot);
610
+ assert.equal(timers.size, 0);
611
+ });
612
+ }
613
+
614
+ for (const k of ['hub-go', 'hub-end']) {
615
+ test(`${k} clears before the command is queued`, () => {
616
+ const s = scene();
617
+ receive(s);
618
+ hook.message(s, { k });
619
+ assert.equal(s.orbitShot, undefined);
620
+ assert.equal(timers.size, 0);
621
+ receive(s, pose(), { lease: true });
622
+ assert.equal(s.orbitShot, undefined, 'renewal cannot undo the command clear');
623
+ receive(s);
624
+ assert.deepEqual(s.orbitShot, pose());
625
+ });
626
+ }
627
+ for (const clear of [() => State.clear(), (s) => hook.reset(s), (s) => hook.dispose(s)]) {
628
+ test('leave, same-scene load and runtime disposal clear owned shots', () => {
629
+ const s = scene();
630
+ receive(s);
631
+ clear(s);
632
+ assert.equal(s.orbitShot, undefined);
633
+ assert.equal(timers.size, 0);
634
+ receive(s, pose(), { lease: true });
635
+ assert.equal(s.orbitShot, undefined, 'renewal cannot undo the lifecycle clear');
636
+ receive(s);
637
+ assert.deepEqual(s.orbitShot, pose());
638
+ });
639
+ }
640
+
641
+ for (const decline of [(s) => receive(s, null), () => State.clear(), (s) => { s.sceneKey = 'new'; }, (s) => { s.currentScenePath = 'scenes/new.scene'; }, (s) => { s.orbitShot = pose(); }]) {
642
+ test('lifecycle clears and ownership changes also decline an already disconnected shot', () => {
643
+ const s = scene();
644
+ let status = 'connected';
645
+ s.multiplayer.net.status = () => ({ state: status });
646
+ receive(s);
647
+ status = 'reconnecting';
648
+ watch();
649
+ assert.equal(s.orbitShot, undefined);
650
+ decline(s);
651
+ const before = s.orbitShot;
652
+ status = 'connected';
653
+ receive(s, pose(), { lease: true });
654
+ assert.equal(s.orbitShot, before);
655
+ assert.equal(timers.size, 0);
656
+ });
657
+ }
658
+ for (const update of [
659
+ (s) => { s.multiplayer.net.status = () => ({ state: 'reconnecting' }); },
660
+ (s) => { s.multiplayer.net.closed = () => true; },
661
+ (s) => { s.multiplayer.net = null; },
662
+ (s) => { s.multiplayer.net = { status: () => ({ state: 'connected' }) }; },
663
+ (s) => { s.multiplayer.generation += 1; },
664
+ (s) => { s.currentScenePath = 'scenes/other.scene'; },
665
+ (s) => { s.sceneKey = 'other-content'; },
666
+ ]) {
667
+ test('disconnect/reconnect, session replacement or scene change clears and cancels watcher', () => {
668
+ const s = scene();
669
+ receive(s);
670
+ update(s);
671
+ watch();
672
+ assert.equal(s.orbitShot, undefined);
673
+ assert.equal(timers.size, 0);
674
+ assert.equal(Object.hasOwn(State.hub, 'shot'), false);
675
+ });
676
+ }
677
+ for (const field of ['currentScenePath', 'sceneKey']) {
678
+ test('a renewal cannot undo a scene change, even before the watcher runs or after returning', () => {
679
+ const s = scene();
680
+ receive(s);
681
+ const old = s[field];
682
+ s[field] = 'new-scene';
683
+ receive(s, pose(), { lease: true });
684
+ assert.equal(s.orbitShot, undefined);
685
+ assert.equal(timers.size, 0);
686
+ s[field] = old;
687
+ receive(s, pose(), { lease: true });
688
+ assert.equal(s.orbitShot, undefined);
689
+ receive(s);
690
+ assert.deepEqual(s.orbitShot, pose());
691
+ });
692
+ }
693
+ test('same-net reconnect: a fresh place shot before WORLD survives the hello renewal and snapshot', () => {
694
+ let resend = false;
695
+ const freshPose = { ...pose(), yaw: 90 };
696
+ const r = bootServer({ step(hub) { if (resend) { assert.equal(hub.shot('p1', freshPose), true); } } });
697
+ const s = scene();
698
+ const net = s.multiplayer.net;
699
+ const generation = s.multiplayer.generation;
700
+ let status = 'connected';
701
+ net.status = () => ({ state: status });
702
+ hook.state(s, { ...r.server.join(), k: 'w' }, null);
703
+ assert.equal(r.hub.shot('p1', pose()), true);
704
+ const oldMessage = r.delivered.find(([, msg]) => msg.k === 'hub-shot')[1];
705
+ hook.message(s, oldMessage);
706
+ const old = s.orbitShot;
707
+ r.delivered.length = 0;
708
+ // A fast connectSession reconnect keeps both identities, and completes
709
+ // before the watcher ticks. The server renews rather than clearing.
710
+ status = 'reconnecting';
711
+ status = 'connected';
712
+ r.hello();
713
+ resend = true;
714
+ r.server.step(r.world);
715
+ const messages = r.delivered.filter(([, msg]) => msg.k === 'hub-shot');
716
+ assert.deepEqual(messages, [
717
+ ['p1', { k: 'hub-shot', shot: pose(), lease: true }],
718
+ ['p1', { k: 'hub-shot', shot: freshPose }],
719
+ ]);
720
+ hook.message(s, messages[0][1]);
721
+ assert.equal(s.orbitShot, old);
722
+ assert.equal(timers.size, 1);
723
+ hook.message(s, messages[1][1]);
724
+ const fresh = s.orbitShot;
725
+ assert.notEqual(fresh, old);
726
+ assert.deepEqual(fresh, freshPose);
727
+ // session.js sends WORLD only after the place/step hooks have run.
728
+ hook.state(s, { ...r.server.join(), k: 'w' }, null);
729
+ watch();
730
+ assert.equal(s.multiplayer.net, net);
731
+ assert.equal(s.multiplayer.generation, generation);
732
+ assert.equal(s.orbitShot, fresh);
733
+ assert.equal(timers.size, 1);
734
+ });
735
+
736
+ test('unused clients allocate no shot state, timers or storage and never inspect scene poses', () => {
737
+ const keys = Object.keys(State.hub);
738
+ const s = Object.defineProperty({}, 'orbitShot', { get() { throw Error('unused pose read'); } });
739
+ hook.message(s, { k: 'unrelated' });
740
+ hook.state(s, { hubPlace: { id: 'main' } }, null);
741
+ hook.state(s, { t: 20 }, null);
742
+ hook.reset(s);
743
+ State.clear();
744
+ assert.deepEqual(Object.keys(State.hub), keys);
745
+ assert.equal(timers.size, 0);
746
+ const h = serverState();
747
+ assert.equal(Object.hasOwn(h, 'shotBudgets'), false);
748
+ });
749
+
750
+ function arrivalScene(enabled = true) {
751
+ const s = scene();
752
+ s.persistent = { camAngle: 2.1 };
753
+ s.data = { engine: { camera: { arrivalFromShot: enabled } } };
754
+ return s;
755
+ }
756
+ const houseShot = () => ({ ...pose(), yaw: -38 });
757
+ const houseAngle = -38 * Math.PI / 180;
758
+ test('a portrait accepted before arrival cannot seed the house movement heading', () => {
759
+ const s = arrivalScene({ yaw: -38 });
760
+ receive(s, houseShot());
761
+ receive(s, { ...pose(), yaw: 41.26 });
762
+ faceArrivalCamera(s, 19.4);
763
+ assert.equal(s.persistent.camAngle, Math.PI - 19.4, 'wait while the portrait is held');
764
+ receive(s, { ...pose(), yaw: 60 });
765
+ assert.equal(s.persistent.camAngle, Math.PI - 19.4, 'another portrait must not retire the pending room seed');
766
+ receive(s, houseShot());
767
+ assert.equal(s.persistent.camAngle, houseAngle, 'closing the portrait restores the intended movement basis');
768
+ s.persistent.camAngle = 1.2;
769
+ receive(s, { ...pose(), yaw: 41.26 });
770
+ receive(s, houseShot());
771
+ assert.equal(s.persistent.camAngle, 1.2, 'later portrait changes do not reseed a completed arrival');
772
+ });
773
+ test('an authored arrival heading accepts equivalent shot yaw and rejects invalid settings', () => {
774
+ const s = arrivalScene({ yaw: 322 });
775
+ receive(s, houseShot());
776
+ faceArrivalCamera(s, 19.4);
777
+ assert.equal(s.persistent.camAngle, houseAngle);
778
+ clearShot();
779
+ for (const setting of [{}, { yaw: '322' }, { yaw: Infinity }, null]) {
780
+ const s = arrivalScene(setting);
781
+ receive(s, houseShot());
782
+ faceArrivalCamera(s, 19.4);
783
+ assert.equal(s.persistent.camAngle, Math.PI - 19.4);
784
+ clearShot();
785
+ }
786
+ });
787
+ test('fresh gated arrival seeds from an already accepted shot, default facing is unchanged', () => {
788
+ for (const enabled of [undefined, false, true]) {
789
+ const s = arrivalScene(enabled);
790
+ if (enabled === undefined) delete s.data.engine.camera.arrivalFromShot;
791
+ receive(s, houseShot());
792
+ faceArrivalCamera(s, 19.4);
793
+ assert.equal(s.persistent.camAngle, enabled === true ? houseAngle : Math.PI - 19.4);
794
+ clearShot();
795
+ }
796
+ });
797
+ test('shot after fresh arrival seeds once; later author shots and leases do not reseed movement', () => {
798
+ const s = arrivalScene();
799
+ faceArrivalCamera(s, 19.4);
800
+ receive(s, houseShot());
801
+ assert.equal(s.persistent.camAngle, houseAngle);
802
+ s.persistent.camAngle = 1.2;
803
+ receive(s, houseShot(), { lease: true });
804
+ assert.equal(s.persistent.camAngle, 1.2);
805
+ receive(s, { ...houseShot(), yaw: 75 });
806
+ assert.equal(s.persistent.camAngle, 1.2);
807
+ faceArrivalCamera(s, 19.4);
808
+ assert.equal(s.persistent.camAngle, 75 * Math.PI / 180);
809
+ });
810
+ test('a pending arrival seed cannot cross scene or multiplayer ownership changes', () => {
811
+ for (const change of [
812
+ s => { s.currentScenePath = 'scenes/elsewhere.scene'; },
813
+ s => { s.sceneKey = 'elsewhere'; },
814
+ s => { s.multiplayer.net = { status: () => ({ state: 'connected' }) }; },
815
+ s => { s.multiplayer.generation++; },
816
+ s => { s.data.engine.camera.arrivalFromShot = false; },
817
+ ]) {
818
+ const s = arrivalScene();
819
+ faceArrivalCamera(s, 19.4);
820
+ change(s);
821
+ receive(s, houseShot());
822
+ assert.equal(s.persistent.camAngle, Math.PI - 19.4);
823
+ clearShot();
824
+ }
825
+ });
826
+ test('explicit shot clear cancels delayed seeding, and follow cameras keep the arrival basis', () => {
827
+ const s = arrivalScene();
828
+ faceArrivalCamera(s, 19.4);
829
+ receive(s, null);
830
+ receive(s, houseShot());
831
+ assert.equal(s.persistent.camAngle, Math.PI - 19.4);
832
+ clearShot();
833
+ const follow = arrivalScene();
834
+ follow.cameraControl = undefined;
835
+ follow.orbitShot = houseShot();
836
+ faceArrivalCamera(follow, 19.4);
837
+ assert.equal(follow.persistent.camAngle, Math.PI - 19.4);
838
+ });
839
+
840
+ const fitShot = () => ({ ...pose(), look: {x:0,y:.65,z:0}, distance:24, pitch:48, yaw:-38,
841
+ fit: {min:{x:-4.35,y:0,z:-3.85}, max:{x:4.35,y:2.15,z:3.85}, minDistance:14} });
842
+ test('fit metadata is bounded, copied by server and rejects malformed bounds', () => {
843
+ const raw=fitShot(),wire=shotValue(raw);raw.fit.min.x=-10;assert.equal(wire.fit.min.x,-4.35);
844
+ // The shared validator is the wire contract on both ends.
845
+ for (const fit of [null, {}, {...fitShot().fit,minDistance:0}, {...fitShot().fit,min:{x:5,y:0,z:0}}, {...fitShot().fit,max:{x:Infinity,y:2,z:4}}]) {
846
+ const s = scene(); receive(s, {...fitShot(),fit}); assert.equal(s.orbitShot, undefined);
847
+ }
848
+ });
849
+ test('all bounds project inside a safe frame at phone aspects and lens values', () => {
850
+ for(const aspect of [360/800,390/844,412/915,844/390,915/412])for(const fov of [50,55,70])for(const zoom of [1,1.5]) {
851
+ const shot=fitShot(),distance=fittedDistance(shot,{aspect,fov,zoom,near:.1});
852
+ const yaw=shot.yaw*Math.PI/180,pitch=shot.pitch*Math.PI/180;
853
+ for(const x of [shot.fit.min.x,shot.fit.max.x])for(const y of [shot.fit.min.y,shot.fit.max.y])for(const z of [shot.fit.min.z,shot.fit.max.z]) {
854
+ const dx=x-shot.look.x,dy=y-shot.look.y,dz=z-shot.look.z;
855
+ const right=dx*Math.cos(yaw)+dz*Math.sin(yaw);
856
+ const up=dx*Math.sin(yaw)*Math.sin(pitch)+dy*Math.cos(pitch)-dz*Math.cos(yaw)*Math.sin(pitch);
857
+ const depth=distance+dx*Math.sin(yaw)*Math.cos(pitch)-dy*Math.sin(pitch)-dz*Math.cos(yaw)*Math.cos(pitch);
858
+ const tangent=Math.tan(fov*Math.PI/360)/zoom;
859
+ assert(depth>=.1);assert(Math.abs(right/(depth*tangent*aspect))<=.900001);assert(Math.abs(up/(depth*tangent))<=.900001);
860
+ }
861
+ }
862
+ });
863
+ test('an impossible fit falls back instead of putting the box beyond the far plane', () => {
864
+ const shot=fitShot(),camera={aspect:.45,fov:70,near:.1,far:1000};
865
+ shot.fit={min:{x:-500,y:0,z:0},max:{x:500,y:0,z:0},minDistance:14};
866
+ assert.equal(fittedDistance(shot,camera),shot.distance);
867
+ shot.fit={min:{x:0,y:.65,z:0},max:{x:0,y:.65,z:0},minDistance:1000};
868
+ assert.equal(fittedDistance(shot,camera),shot.distance);
869
+ shot.fit.minDistance=999;assert.equal(fittedDistance(shot,camera),999);
870
+ const s=scene();s.three={camera};receive(s,shot);const held=s.orbitShot;
871
+ camera.far=500;watch();assert.equal(s.orbitShot,held);assert.equal(held.distance,shot.distance);
872
+ camera.far=1000;watch();assert.equal(held.distance,999);
873
+ });
874
+ test('fit responds to resize without replacing ownership or confusing wire leases', () => {
875
+ const s=scene();s.three={camera:{aspect:390/844,fov:55,near:.1,zoom:1}};
876
+ const source=fitShot();receive(s,source);const held=s.orbitShot,portrait=held.distance;
877
+ assert(portrait>14);assert.equal(source.distance,24);
878
+ s.three.camera.aspect=844/390;watch();assert.equal(s.orbitShot,held);assert.equal(held.distance,14);
879
+ clientTime=4500;receive(s,source,{lease:true});clientTime=8000;watch();assert.equal(s.orbitShot,held);
880
+ s.three.camera.aspect=390/844;watch();assert.equal(held.distance,portrait);
881
+ const changed=fitShot();changed.fit.minDistance=30;
882
+ receive(s,changed,{lease:true});assert.equal(s.orbitShot,held,'lease cannot change fit bounds');
883
+ clientTime=9600;watch();assert.equal(s.orbitShot,undefined);
884
+ receive(s,source,{lease:true});assert.equal(s.orbitShot.distance,portrait,'disconnect/expiry restores source fit');
885
+ const deck={...pose()};s.orbitShot=deck;watch();receive(s,source,{lease:true});assert.equal(s.orbitShot,deck);
886
+ });
887
+ test('fitted shot expires on travel and does not renew into another scene', () => {
888
+ const s=scene();s.three={camera:{aspect:.5,fov:55}};receive(s,fitShot());s.sceneKey='next';watch();
889
+ assert.equal(s.orbitShot,undefined);receive(s,fitShot(),{lease:true});assert.equal(s.orbitShot,undefined);
890
+ });
891
+
892
+ globalThis.setInterval = realSet;
893
+ globalThis.clearInterval = realClear;
894
+ if (nowDescriptor) {
895
+ Object.defineProperty(performance, 'now', nowDescriptor);
896
+ } else {
897
+ delete performance.now;
898
+ }
899
+ console.warn = warn;
900
+ console.log = log;
901
+ console.log(`hub shots: ${n} tests passed`);