castle-web-cli 0.4.233 → 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 (381) hide show
  1. package/dist/api.d.ts +11 -0
  2. package/dist/api.js +43 -0
  3. package/dist/bundle.d.ts +64 -0
  4. package/dist/bundle.js +558 -2
  5. package/dist/castle-host/host.d.ts +17 -2
  6. package/dist/castle-host/host.js +793 -36
  7. package/dist/castleJson.d.ts +20 -1
  8. package/dist/castleJson.js +44 -2
  9. package/dist/check.js +9 -2
  10. package/dist/chunkLoader.d.ts +3 -0
  11. package/dist/chunkLoader.js +111 -0
  12. package/dist/devParty.d.ts +26 -0
  13. package/dist/devParty.js +231 -0
  14. package/dist/devSaveStorage.js +4 -0
  15. package/dist/devSessionStorage.js +3 -1
  16. package/dist/devSocial.d.ts +24 -0
  17. package/dist/devSocial.js +70 -0
  18. package/dist/ide.d.ts +2 -0
  19. package/dist/ide.js +119 -15
  20. package/dist/index.js +8 -2
  21. package/dist/init.js +1 -1
  22. package/dist/save-deck.d.ts +20 -1
  23. package/dist/save-deck.js +141 -5
  24. package/dist/serve.js +29 -11
  25. package/dist/shell/assets/{index-BjOxR-lW.js → index-DulbYIJm.js} +97 -97
  26. package/dist/shell/index.html +1 -1
  27. package/dist/vitePlugins.d.ts +2 -1
  28. package/dist/vitePlugins.js +13 -0
  29. package/kits/base/castle.json +1 -1
  30. package/kits/base/sdk/README.md +260 -3
  31. package/kits/base/sdk/castle.d.ts +7 -3
  32. package/kits/base/sdk/castle.js +2 -0
  33. package/kits/base/sdk/commands.d.ts +162 -1
  34. package/kits/base/sdk/commands.js +3 -0
  35. package/kits/base/sdk/display.d.ts +3 -0
  36. package/kits/base/sdk/display.js +9 -3
  37. package/kits/base/sdk/hub.d.ts +33 -6
  38. package/kits/base/sdk/hub.js +50 -4
  39. package/kits/base/sdk/multiplayer.d.ts +7 -1
  40. package/kits/base/sdk/multiplayer.js +140 -40
  41. package/kits/base/sdk/multiplayerProtocol.d.ts +2 -0
  42. package/kits/base/sdk/party.d.ts +23 -0
  43. package/kits/base/sdk/party.js +91 -0
  44. package/kits/base/sdk/reconnectBudget.d.ts +23 -0
  45. package/kits/base/sdk/reconnectBudget.js +96 -0
  46. package/kits/base/sdk/save.d.ts +38 -1
  47. package/kits/base/sdk/save.js +79 -6
  48. package/kits/base/sdk/server/hub.d.ts +31 -1
  49. package/kits/base/sdk/server/hub.js +50 -3
  50. package/kits/base/sdk/server/platformHandle.d.ts +13 -1
  51. package/kits/base/sdk/server/storage.d.ts +4 -0
  52. package/kits/base/sdk/server/storage.js +19 -3
  53. package/kits/base/sdk/server/wrapper.d.ts +7 -1
  54. package/kits/base/sdk/server/wrapper.js +10 -1
  55. package/kits/base/sdk/social.d.ts +9 -0
  56. package/kits/base/sdk/social.js +5 -0
  57. package/kits/hub-game/CLAUDE.md +123 -3
  58. package/kits/hub-game/README.md +63 -0
  59. package/kits/hub-game/castle.json +5 -5
  60. package/kits/hub-game/code/client/act.js +312 -0
  61. package/kits/hub-game/code/client/actionLayout.js +147 -0
  62. package/kits/hub-game/code/client/actionOverflow.js +556 -0
  63. package/kits/hub-game/code/client/arrivalCamera.js +50 -0
  64. package/kits/hub-game/code/client/askSlot.js +117 -0
  65. package/kits/hub-game/code/client/avatar.js +4 -2
  66. package/kits/hub-game/code/client/avatarShare.js +2 -0
  67. package/kits/hub-game/code/client/backVisibility.js +13 -0
  68. package/kits/hub-game/code/client/ballot.js +15 -10
  69. package/kits/hub-game/code/client/build.js +16 -0
  70. package/kits/hub-game/code/client/chat.js +41 -5
  71. package/kits/hub-game/code/client/chatModeration.js +5 -0
  72. package/kits/hub-game/code/client/chrome.js +1148 -258
  73. package/kits/hub-game/code/client/crowdNames.js +241 -0
  74. package/kits/hub-game/code/client/decor.js +10 -4
  75. package/kits/hub-game/code/client/defaultEnvironment.js +194 -0
  76. package/kits/hub-game/code/client/doorErrors.js +39 -0
  77. package/kits/hub-game/code/client/fall.js +18 -0
  78. package/kits/hub-game/code/client/farAvatars.js +233 -0
  79. package/kits/hub-game/code/client/firstJoin.js +9 -2
  80. package/kits/hub-game/code/client/fpsTelemetry.js +50 -0
  81. package/kits/hub-game/code/client/frameBatch.js +5 -0
  82. package/kits/hub-game/code/client/grab.js +31 -11
  83. package/kits/hub-game/code/client/hookLayer.js +87 -8
  84. package/kits/hub-game/code/client/hudCopy.js +51 -0
  85. package/kits/hub-game/code/client/hudRate.js +20 -0
  86. package/kits/hub-game/code/client/idle.js +14 -2
  87. package/kits/hub-game/code/client/invites.js +231 -0
  88. package/kits/hub-game/code/client/joinError.js +9 -0
  89. package/kits/hub-game/code/client/labelsNear.js +31 -2
  90. package/kits/hub-game/code/client/landscapeLayout.js +17 -0
  91. package/kits/hub-game/code/client/layoutCache.js +264 -0
  92. package/kits/hub-game/code/client/loadTelemetry.js +20 -0
  93. package/kits/hub-game/code/client/loadingCover.js +148 -0
  94. package/kits/hub-game/code/client/loadingEntry.js +8 -0
  95. package/kits/hub-game/code/client/menuRows.js +43 -0
  96. package/kits/hub-game/code/client/modelReady.js +7 -0
  97. package/kits/hub-game/code/client/padCueArrival.js +23 -0
  98. package/kits/hub-game/code/client/padCues.js +112 -0
  99. package/kits/hub-game/code/client/padOccupancy.js +88 -0
  100. package/kits/hub-game/code/client/padReadability.js +26 -0
  101. package/kits/hub-game/code/client/padRings.js +69 -0
  102. package/kits/hub-game/code/client/pushVisit.js +14 -0
  103. package/kits/hub-game/code/client/quality.js +205 -0
  104. package/kits/hub-game/code/client/qualityEntry.js +55 -0
  105. package/kits/hub-game/code/client/safeLayout.js +338 -0
  106. package/kits/hub-game/code/client/safeStyle.js +42 -0
  107. package/kits/hub-game/code/client/say.js +12 -3
  108. package/kits/hub-game/code/client/shot.js +64 -10
  109. package/kits/hub-game/code/client/shotFit.js +56 -0
  110. package/kits/hub-game/code/client/signIn.js +28 -0
  111. package/kits/hub-game/code/client/state.js +53 -0
  112. package/kits/hub-game/code/client/talk.js +209 -45
  113. package/kits/hub-game/code/client/tiers.js +68 -66
  114. package/kits/hub-game/code/client/together.js +7 -2
  115. package/kits/hub-game/code/client/weakestLookBake.js +92 -0
  116. package/kits/hub-game/code/client/weakestTier.js +295 -0
  117. package/kits/hub-game/code/client/worldLabels.js +241 -0
  118. package/kits/hub-game/code/client/yours.js +10 -9
  119. package/kits/hub-game/code/npcDisplayText.js +55 -0
  120. package/kits/hub-game/code/server/act.js +124 -0
  121. package/kits/hub-game/code/server/actions.js +6 -1
  122. package/kits/hub-game/code/server/actors.js +2 -1
  123. package/kits/hub-game/code/server/analytics.js +83 -0
  124. package/kits/hub-game/code/server/anonymousEntry.js +49 -0
  125. package/kits/hub-game/code/server/arrivalPose.js +36 -0
  126. package/kits/hub-game/code/server/companion.js +28 -3
  127. package/kits/hub-game/code/server/doorAnalytics.js +52 -0
  128. package/kits/hub-game/code/server/earned.js +22 -5
  129. package/kits/hub-game/code/server/frameBatch.js +183 -0
  130. package/kits/hub-game/code/server/friendsAmong.js +49 -9
  131. package/kits/hub-game/code/server/history.js +2 -0
  132. package/kits/hub-game/code/server/hub.js +1306 -95
  133. package/kits/hub-game/code/server/idle.js +30 -1
  134. package/kits/hub-game/code/server/index.js +26 -4
  135. package/kits/hub-game/code/server/invites.js +19 -0
  136. package/kits/hub-game/code/server/labels.js +9 -1
  137. package/kits/hub-game/code/server/loadAbandon.js +106 -0
  138. package/kits/hub-game/code/server/manifest.js +211 -3
  139. package/kits/hub-game/code/server/menu.js +31 -3
  140. package/kits/hub-game/code/server/npcs.js +226 -64
  141. package/kits/hub-game/code/server/observe.js +408 -0
  142. package/kits/hub-game/code/server/padOccupancy.js +85 -0
  143. package/kits/hub-game/code/server/players.js +9 -1
  144. package/kits/hub-game/code/server/resumePose.js +152 -0
  145. package/kits/hub-game/code/server/say.js +1 -1
  146. package/kits/hub-game/code/server/standing.js +4 -5
  147. package/kits/hub-game/code/server/storageLimit.js +187 -0
  148. package/kits/hub-game/code/server/vis.js +67 -5
  149. package/kits/hub-game/code/shared/act.js +35 -0
  150. package/kits/hub-game/code/shared/danceIdle.js +28 -0
  151. package/kits/hub-game/code/shared/loadStages.js +12 -0
  152. package/kits/hub-game/code/shared/quality.js +74 -0
  153. package/kits/hub-game/code/shared/say.js +2 -0
  154. package/kits/hub-game/code/shared/shot.js +35 -1
  155. package/kits/hub-game/code/systems/hub.js +970 -169
  156. package/kits/hub-game/docs/analytics.md +279 -0
  157. package/kits/hub-game/docs/contract.md +1257 -42
  158. package/kits/hub-game/docs/home-pieces.md +9 -2
  159. package/kits/hub-game/docs/observed-progress.md +252 -0
  160. package/kits/hub-game/main.jsx +2 -0
  161. package/kits/hub-game/package-lock.json +10 -3
  162. package/kits/hub-game/package.json +6 -3
  163. package/kits/hub-game/play/player.js +142 -0
  164. package/kits/hub-game/play/registry.js +47 -0
  165. package/kits/hub-game/play.jsx +37 -0
  166. package/kits/hub-game/scripts/check.mjs +39 -5
  167. package/kits/hub-game/scripts/companion-follower-wire.json +1 -1
  168. package/kits/hub-game/scripts/fixtures/decor-keyless-draw.json +11 -0
  169. package/kits/hub-game/scripts/fixtures/decor-keyless.json +5 -5
  170. package/kits/hub-game/scripts/fixtures/engine-models-stub.mjs +3 -0
  171. package/kits/hub-game/scripts/fixtures/fake-dom.mjs +19 -3
  172. package/kits/hub-game/scripts/fixtures/interest-legacy.json +3 -3
  173. package/kits/hub-game/scripts/fixtures/vis-shared-wire.json +1 -1
  174. package/kits/hub-game/scripts/pose-storage-fixture.mjs +46 -0
  175. package/kits/hub-game/scripts/test-act-client.mjs +186 -0
  176. package/kits/hub-game/scripts/test-act.mjs +171 -0
  177. package/kits/hub-game/scripts/test-action-layout.mjs +80 -0
  178. package/kits/hub-game/scripts/test-action-observers.mjs +46 -0
  179. package/kits/hub-game/scripts/test-actions-client.mjs +367 -2
  180. package/kits/hub-game/scripts/test-actors.mjs +20 -7
  181. package/kits/hub-game/scripts/test-analytics.mjs +76 -0
  182. package/kits/hub-game/scripts/test-anonymous-entry.mjs +28 -0
  183. package/kits/hub-game/scripts/test-arrival-pose-server.mjs +196 -0
  184. package/kits/hub-game/scripts/test-arrival-pose.mjs +24 -0
  185. package/kits/hub-game/scripts/test-ask-slot.mjs +85 -0
  186. package/kits/hub-game/scripts/test-avatar-wire.mjs +49 -10
  187. package/kits/hub-game/scripts/test-avatar.mjs +44 -0
  188. package/kits/hub-game/scripts/test-back-visibility.mjs +82 -0
  189. package/kits/hub-game/scripts/test-ballot.mjs +11 -4
  190. package/kits/hub-game/scripts/test-ban-join.mjs +121 -13
  191. package/kits/hub-game/scripts/test-build.mjs +20 -2
  192. package/kits/hub-game/scripts/test-chat.mjs +206 -5
  193. package/kits/hub-game/scripts/test-companion-chat.mjs +20 -2
  194. package/kits/hub-game/scripts/test-control-layout-dom.mjs +120 -0
  195. package/kits/hub-game/scripts/test-crowd-names.mjs +205 -0
  196. package/kits/hub-game/scripts/test-decor-client.mjs +45 -4
  197. package/kits/hub-game/scripts/test-decor.mjs +7 -0
  198. package/kits/hub-game/scripts/test-default-environment-root.mjs +95 -0
  199. package/kits/hub-game/scripts/test-default-environment.mjs +267 -0
  200. package/kits/hub-game/scripts/test-door-analytics.mjs +58 -0
  201. package/kits/hub-game/scripts/test-door-jump.mjs +100 -0
  202. package/kits/hub-game/scripts/test-earned.mjs +33 -3
  203. package/kits/hub-game/scripts/test-far-avatars.mjs +340 -0
  204. package/kits/hub-game/scripts/test-fps-telemetry.mjs +112 -0
  205. package/kits/hub-game/scripts/test-frame-batch.mjs +252 -0
  206. package/kits/hub-game/scripts/test-fresh-friends.mjs +118 -0
  207. package/kits/hub-game/scripts/test-grab-orbit.mjs +47 -4
  208. package/kits/hub-game/scripts/test-high-only.mjs +170 -0
  209. package/kits/hub-game/scripts/test-hub-ops.mjs +321 -2
  210. package/kits/hub-game/scripts/test-hub-trip.mjs +879 -11
  211. package/kits/hub-game/scripts/test-hud-clear.mjs +162 -59
  212. package/kits/hub-game/scripts/test-hud-defects-dom.mjs +100 -0
  213. package/kits/hub-game/scripts/test-hud-rate.mjs +224 -0
  214. package/kits/hub-game/scripts/test-hud-safe-visibility-dom.mjs +83 -0
  215. package/kits/hub-game/scripts/test-idle.mjs +66 -0
  216. package/kits/hub-game/scripts/test-interest-cells.mjs +20 -0
  217. package/kits/hub-game/scripts/test-interest.mjs +15 -0
  218. package/kits/hub-game/scripts/test-invites-client.mjs +430 -0
  219. package/kits/hub-game/scripts/test-invites.mjs +109 -0
  220. package/kits/hub-game/scripts/test-labels.mjs +71 -3
  221. package/kits/hub-game/scripts/test-landscape-layout.mjs +194 -0
  222. package/kits/hub-game/scripts/test-list-scroll-dom.mjs +49 -0
  223. package/kits/hub-game/scripts/test-load-abandon.mjs +246 -0
  224. package/kits/hub-game/scripts/test-loading-cover.mjs +162 -0
  225. package/kits/hub-game/scripts/test-manifest.mjs +265 -0
  226. package/kits/hub-game/scripts/test-menu-client.mjs +105 -0
  227. package/kits/hub-game/scripts/test-menu.mjs +23 -0
  228. package/kits/hub-game/scripts/test-npcs.mjs +819 -10
  229. package/kits/hub-game/scripts/test-observed.mjs +745 -0
  230. package/kits/hub-game/scripts/test-pad-cues.mjs +304 -0
  231. package/kits/hub-game/scripts/test-pad-occupancy.mjs +177 -0
  232. package/kits/hub-game/scripts/test-picker.mjs +234 -7
  233. package/kits/hub-game/scripts/test-placement-cache.mjs +690 -0
  234. package/kits/hub-game/scripts/test-progress-reset.mjs +559 -0
  235. package/kits/hub-game/scripts/test-push-visit.mjs +26 -0
  236. package/kits/hub-game/scripts/test-quality.mjs +385 -0
  237. package/kits/hub-game/scripts/test-rehello.mjs +699 -5
  238. package/kits/hub-game/scripts/test-resume-action-order.mjs +598 -0
  239. package/kits/hub-game/scripts/test-resume-held.mjs +239 -0
  240. package/kits/hub-game/scripts/test-resume-pose.mjs +142 -0
  241. package/kits/hub-game/scripts/test-safe-events-dom.mjs +116 -0
  242. package/kits/hub-game/scripts/test-safe-layout.mjs +330 -0
  243. package/kits/hub-game/scripts/test-say.mjs +1 -1
  244. package/kits/hub-game/scripts/test-shot.mjs +145 -0
  245. package/kits/hub-game/scripts/test-signin-client.mjs +45 -0
  246. package/kits/hub-game/scripts/test-soundscape.mjs +22 -17
  247. package/kits/hub-game/scripts/test-standing.mjs +35 -2
  248. package/kits/hub-game/scripts/test-storage-limit.mjs +333 -0
  249. package/kits/hub-game/scripts/test-stuck.mjs +5 -4
  250. package/kits/hub-game/scripts/test-talk-overlay-dom.mjs +130 -0
  251. package/kits/hub-game/scripts/test-tiers-render.mjs +86 -13
  252. package/kits/hub-game/scripts/test-tiers.mjs +7 -8
  253. package/kits/hub-game/scripts/test-vis.mjs +433 -6
  254. package/kits/hub-game/scripts/test-weakest-tier.mjs +924 -0
  255. package/kits/hub-game/scripts/test-world-labels.mjs +367 -0
  256. package/kits/hub-game/scripts/test-yours-chrome.mjs +50 -6
  257. package/kits/hub-game/scripts/test-yours.mjs +39 -8
  258. package/kits/multiplayer-3d/castle.json +5 -5
  259. package/kits/multiplayer-3d/code/client/joinFailure.js +27 -0
  260. package/kits/multiplayer-3d/code/client/resumeGate.js +139 -0
  261. package/kits/multiplayer-3d/code/systems/multiplayer.js +369 -30
  262. package/kits/multiplayer-3d/package-lock.json +8 -1
  263. package/kits/multiplayer-3d/package.json +2 -1
  264. package/kits/multiplayer-3d/scripts/test-join-watchdog.mjs +436 -0
  265. package/kits/multiplayer-3d/scripts/test-resume-gate.mjs +624 -0
  266. package/kits/physics-2d/CLAUDE.md +10 -1
  267. package/kits/physics-2d/castle.json +2 -2
  268. package/kits/physics-2d/engine/frozenActors.js +233 -0
  269. package/kits/physics-2d/engine/scene.js +87 -5
  270. package/kits/physics-2d/eslint.config.js +1 -1
  271. package/kits/physics-2d/play/behaviors/AnalogStick.js +198 -0
  272. package/kits/physics-2d/play/behaviors/Camera.js +40 -0
  273. package/kits/physics-2d/play/behaviors/Collider.js +122 -0
  274. package/kits/physics-2d/play/behaviors/Draggable.js +115 -0
  275. package/kits/physics-2d/play/behaviors/Goal.js +46 -0
  276. package/kits/physics-2d/play/behaviors/Joints.js +126 -0
  277. package/kits/physics-2d/play/behaviors/Layout.js +71 -0
  278. package/kits/physics-2d/play/behaviors/RigidBody.js +57 -0
  279. package/kits/physics-2d/play/behaviors/Slingshot.js +142 -0
  280. package/kits/physics-2d/play/behaviors/SoundPlayer.js +263 -0
  281. package/kits/physics-2d/play/behaviors/Sprite.js +406 -0
  282. package/kits/physics-2d/play/behaviors/Style.js +209 -0
  283. package/kits/physics-2d/play/behaviors/Text.js +85 -0
  284. package/kits/physics-2d/play/behaviors/Video.js +93 -0
  285. package/kits/physics-3d/CLAUDE.md +25 -1651
  286. package/kits/physics-3d/behaviors/Body.jsx +3 -0
  287. package/kits/physics-3d/behaviors/Model.jsx +3 -0
  288. package/kits/physics-3d/behaviors/Player.jsx +35 -18
  289. package/kits/physics-3d/behaviors/Shape.jsx +3 -0
  290. package/kits/physics-3d/behaviors/Solid.jsx +3 -0
  291. package/kits/physics-3d/behaviors/Transform.jsx +3 -0
  292. package/kits/physics-3d/castle.json +3 -3
  293. package/kits/physics-3d/docs/engine-camera.md +542 -0
  294. package/kits/physics-3d/docs/engine-frame-cap.md +136 -0
  295. package/kits/physics-3d/docs/engine-load.md +149 -0
  296. package/kits/physics-3d/docs/engine-look.md +114 -0
  297. package/kits/physics-3d/docs/engine-shadows.md +372 -0
  298. package/kits/physics-3d/docs/engine-skip-work.md +187 -0
  299. package/kits/physics-3d/docs/engine-sky.md +198 -0
  300. package/kits/physics-3d/docs/engine-static-actors.md +226 -0
  301. package/kits/physics-3d/docs/engine-view.md +37 -0
  302. package/kits/physics-3d/docs/pxmodel-format.md +1 -1
  303. package/kits/physics-3d/engine3d/PlayOnly3D.jsx +5 -1
  304. package/kits/physics-3d/engine3d/Scene3DPlayer.jsx +19 -333
  305. package/kits/physics-3d/engine3d/actornode.js +1 -0
  306. package/kits/physics-3d/engine3d/branches.js +3 -13
  307. package/kits/physics-3d/engine3d/cage.js +2 -7
  308. package/kits/physics-3d/engine3d/cageops.js +2 -17
  309. package/kits/physics-3d/engine3d/dataBehaviors.js +12 -0
  310. package/kits/physics-3d/engine3d/framecap.js +4 -1
  311. package/kits/physics-3d/engine3d/frozenphysics.js +140 -0
  312. package/kits/physics-3d/engine3d/frozenstatics.js +273 -0
  313. package/kits/physics-3d/engine3d/gait.js +8 -0
  314. package/kits/physics-3d/engine3d/initialModelFiles.js +18 -0
  315. package/kits/physics-3d/engine3d/look.js +7 -0
  316. package/kits/physics-3d/engine3d/modelFiles.js +3 -17
  317. package/kits/physics-3d/engine3d/modelMath.js +49 -0
  318. package/kits/physics-3d/engine3d/modelready.js +16 -0
  319. package/kits/physics-3d/engine3d/motion.js +3 -3
  320. package/kits/physics-3d/engine3d/nearshadows.js +77 -10
  321. package/kits/physics-3d/engine3d/orbitinput.js +59 -25
  322. package/kits/physics-3d/engine3d/partgeometry.js +1 -16
  323. package/kits/physics-3d/engine3d/paths.js +1 -9
  324. package/kits/physics-3d/engine3d/playTimings.js +50 -0
  325. package/kits/physics-3d/engine3d/playerRun.js +372 -0
  326. package/kits/physics-3d/engine3d/pxmodel.js +3 -3
  327. package/kits/physics-3d/engine3d/rapier.js +27 -0
  328. package/kits/physics-3d/engine3d/scatter.js +1 -11
  329. package/kits/physics-3d/engine3d/shadowfade.js +23 -15
  330. package/kits/physics-3d/engine3d/sky.js +1 -1
  331. package/kits/physics-3d/engine3d/squarefirst.js +177 -0
  332. package/kits/physics-3d/engine3d/stillshadows.js +399 -0
  333. package/kits/physics-3d/engine3d/sweep.js +1 -25
  334. package/kits/physics-3d/engine3d/world3d.js +468 -18
  335. package/kits/physics-3d/eslint.config.js +2 -1
  336. package/kits/physics-3d/main.jsx +6 -3
  337. package/kits/physics-3d/package-lock.json +7 -0
  338. package/kits/physics-3d/package.json +5 -1
  339. package/kits/physics-3d/play/behaviors/Body.js +31 -0
  340. package/kits/physics-3d/play/behaviors/Door.js +37 -0
  341. package/kits/physics-3d/play/behaviors/Lookable.js +16 -0
  342. package/kits/physics-3d/play/behaviors/Model.js +23 -0
  343. package/kits/physics-3d/play/behaviors/Pickup.js +46 -0
  344. package/kits/physics-3d/play/behaviors/Player.js +1204 -0
  345. package/kits/physics-3d/play/behaviors/Shape.js +47 -0
  346. package/kits/physics-3d/play/behaviors/Solid.js +16 -0
  347. package/kits/physics-3d/play/behaviors/Transform.js +29 -0
  348. package/kits/physics-3d/pnpm-lock.yaml +8 -0
  349. package/kits/physics-3d/scripts/bench-shadow-fade.mjs +37 -0
  350. package/kits/physics-3d/scripts/build-rapier-gz.mjs +56 -0
  351. package/kits/physics-3d/scripts/frozen-statics-fixture.mjs +141 -0
  352. package/kits/physics-3d/scripts/test-camera-follow.mjs +5 -1
  353. package/kits/physics-3d/scripts/test-camera-orbit.mjs +52 -4
  354. package/kits/physics-3d/scripts/test-drop-empty-parts.mjs +1 -1
  355. package/kits/physics-3d/scripts/test-empty-gait-hints.mjs +89 -0
  356. package/kits/physics-3d/scripts/test-frame-cap-bob.mjs +6 -3
  357. package/kits/physics-3d/scripts/test-frame-cap.mjs +1 -1
  358. package/kits/physics-3d/scripts/test-frozen-nested.mjs +49 -0
  359. package/kits/physics-3d/scripts/test-frozen-statics-legacy-physics2d.mjs +123 -0
  360. package/kits/physics-3d/scripts/test-frozen-statics.mjs +434 -0
  361. package/kits/physics-3d/scripts/test-look-bake.mjs +1 -1
  362. package/kits/physics-3d/scripts/test-near-shadows.mjs +2 -2
  363. package/kits/physics-3d/scripts/test-orbit-shadow-fade.mjs +88 -7
  364. package/kits/physics-3d/scripts/test-orbit-shift-lock.mjs +40 -3
  365. package/kits/physics-3d/scripts/test-orbit-shot.mjs +75 -1
  366. package/kits/physics-3d/scripts/test-rapier-gz.mjs +106 -0
  367. package/kits/physics-3d/scripts/test-sky.mjs +1 -1
  368. package/kits/physics-3d/scripts/test-square-first.mjs +921 -0
  369. package/kits/physics-3d/scripts/test-static-actors.mjs +3 -1
  370. package/kits/physics-3d/scripts/test-static-physics.mjs +4 -1
  371. package/kits/physics-3d/scripts/test-static-scenery.mjs +5 -2
  372. package/kits/physics-3d/scripts/test-steady-hover.mjs +5 -2
  373. package/kits/physics-3d/scripts/test-still-shadows.mjs +477 -0
  374. package/kits/physics-3d/systems/physics3d.js +37 -4
  375. package/kits/real-time/castle.json +2 -2
  376. package/kits/real-time/code/client/connection.js +33 -10
  377. package/kits/real-time/code/client/gameHooks.js +2 -0
  378. package/kits/real-time/code/client/joinOverlay.js +9 -4
  379. package/kits/real-time/code/server/session.js +6 -4
  380. package/kits/real-time/package-lock.json +1 -1
  381. package/package.json +2 -2
@@ -102,7 +102,7 @@ function platformHub(answers = {}) {
102
102
  };
103
103
  }
104
104
 
105
- function boot(s, hooks = {}, json = castleJson) {
105
+ function boot(s, hooks = {}, json = castleJson, ground = null) {
106
106
  let ctx = null;
107
107
  const arrived = [];
108
108
  const deck = {
@@ -114,7 +114,7 @@ function boot(s, hooks = {}, json = castleJson) {
114
114
  },
115
115
  ...hooks,
116
116
  };
117
- const h = layer(json, deck, {}, sceneExists);
117
+ const h = layer(json, deck, {}, sceneExists, () => ground);
118
118
  h.sceneFor(s.session);
119
119
  const world = sim();
120
120
  h.ready(world);
@@ -183,6 +183,139 @@ await test("arrival, result and avatar come from ghost, not the client's hello",
183
183
  assert.equal(h.join().hubAv.p1, 2);
184
184
  });
185
185
 
186
+ await test('weekly Cup is opt-in, private, periodically refreshed and fenced to the requested identity', async () => {
187
+ let resolveCup;
188
+ const combined = [];
189
+ const p = platformHub({
190
+ read(input) {
191
+ if (input.userIds && input.doorIds) {
192
+ combined.push(input);
193
+ return new Promise((resolve) => { resolveCup = resolve; });
194
+ }
195
+ return { players: Object.fromEntries((input.userIds ?? []).map((id) => [id, { avatar: 1, records: [], recent: [] }])), boards: {} };
196
+ },
197
+ });
198
+ const s = session({ hub: p.hub });
199
+ const enabled = { ...castleJson, deckId: 'town-deck', hub: { ...castleJson.hub, weeklyCup: true } };
200
+ const { h, world, ctx } = boot(s, {}, enabled);
201
+ hello(h, s, 'p1');
202
+ hello(h, s, 'p2');
203
+ h.place(world);
204
+ assert.equal(typeof ctx().cup, 'function');
205
+ assert.equal(typeof ctx().cupNow, 'function');
206
+ assert.equal(ctx().cupDeckId, 'town-deck', 'the saved awarding namespace is server-only context authority');
207
+ assert.equal(ctx().cup('p1', 'race'), null, 'pending result bits are unavailable');
208
+ assert.deepEqual(combined, [{ doorIds: ['race'], userIds: ['101', '102'] }], 'only connected signed-in host identities are requested');
209
+ const clockAt = Date.now();
210
+ resolveCup({
211
+ boards: { race: { event: { day: '2026-10-10', validResultCount: 3, cupNow: clockAt } } },
212
+ players: {
213
+ 101: { cup: { race: {
214
+ '2026-10-10': { participated: true, champion: false },
215
+ '2026-10-03': { participated: true, champion: true },
216
+ '2026-09-26': { participated: true, champion: true },
217
+ bad: { participated: true, champion: true },
218
+ } } },
219
+ 102: { cup: { race: { '2026-10-10': { participated: false, champion: false } } } },
220
+ },
221
+ });
222
+ await flush();
223
+ assert.deepEqual(ctx().cup('p1', 'race'), {
224
+ '2026-10-10': { participated: true, champion: false },
225
+ '2026-10-03': { participated: true, champion: true },
226
+ }, 'only two valid occurrence rows survive');
227
+ const copy = ctx().cup('p1', 'race');
228
+ copy['2026-10-10'].participated = false;
229
+ assert.equal(ctx().cup('p1', 'race')['2026-10-10'].participated, true, 'the server-only cache is copied');
230
+ assert.equal(ctx().board('race').event.validResultCount, 3);
231
+ assert.equal(Object.hasOwn(ctx().board('race').event, 'cupNow'), false, 'raw clock metadata is stripped from the stored board');
232
+ assert.ok(ctx().cupNow('race') >= clockAt && ctx().cupNow('race') < clockAt + 1000, 'the paired clock advances from receipt time');
233
+ assert.equal('cup' in h.join(), false, 'private eligibility never enters shared wire');
234
+
235
+ const realNow = Date.now;
236
+ Date.now = () => realNow() + 61_000;
237
+ try {
238
+ h.place(world);
239
+ assert.equal(combined.length, 2, 'connected result bits are refreshed on the board cadence');
240
+ assert.equal(ctx().cup('p1', 'race'), null, 'the old map cannot be used during refresh');
241
+ assert.equal(ctx().cupNow('race'), null, 'the old clock cannot be combined with a refresh in flight');
242
+ s.session.players = s.session.players.map((player) => player.playerId === 'p1' ? { ...player, userId: '999' } : player);
243
+ hello(h, s, 'p1');
244
+ resolveCup({
245
+ boards: { race: { event: { day: '2026-10-10', validResultCount: 4, cupNow: clockAt + 61_000 } } },
246
+ players: { 101: { cup: { race: { '2026-10-10': { participated: true, champion: true } } } } },
247
+ });
248
+ await flush();
249
+ assert.equal(ctx().cup('p1', 'race'), null, 'an answer for the replaced account cannot cross the identity boundary');
250
+ assert.ok(ctx().cupNow('race') >= clockAt + 61_000, 'the shared clock does not depend on one player result row');
251
+ h.sceneFor({ ...s.session, sessionId: 's-2' });
252
+ assert.equal(ctx().cupNow('race'), null, 'a clock never crosses a session replacement');
253
+ } finally {
254
+ Date.now = realNow;
255
+ }
256
+ });
257
+
258
+ await test('the paired Cup clock expires and malformed or failed board reads keep it unavailable', async () => {
259
+ const realNow = Date.now;
260
+ let wall = 1_800_000_000_000;
261
+ Date.now = () => wall;
262
+ const responses = [
263
+ { boards: { race: { event: { day: '2027-01-02', cupNow: 2_000_000_000_000 } } }, players: { 101: { cup: {} } } },
264
+ { boards: { race: { event: { day: '2027-01-02', cupNow: 2_000_000_060_000.5 } } }, players: { 101: { cup: {} } } },
265
+ new Error('clock worker unavailable'),
266
+ ];
267
+ const p = platformHub({
268
+ read(input) {
269
+ if (input.userIds && input.doorIds) {
270
+ const answer = responses.shift();
271
+ if (answer instanceof Error) return Promise.reject(answer);
272
+ return answer;
273
+ }
274
+ return { players: Object.fromEntries((input.userIds ?? []).map((id) => [id, { avatar: 1, records: [], recent: [] }])), boards: {} };
275
+ },
276
+ });
277
+ try {
278
+ const s = session({ hub: p.hub });
279
+ const enabled = { ...castleJson, deckId: 'town-deck', hub: { ...castleJson.hub, weeklyCup: true } };
280
+ const { h, world, ctx } = boot(s, {}, enabled);
281
+ hello(h, s, 'p1');
282
+ h.place(world);
283
+ assert.equal(ctx().cupNow('race'), null, 'a clock is unavailable while its paired board read is pending');
284
+ await flush();
285
+ assert.equal(ctx().cupNow('race'), 2_000_000_000_000);
286
+
287
+ wall += 119_999;
288
+ assert.equal(ctx().cupNow('race'), 2_000_000_119_999, 'a fresh clock advances by elapsed wall time');
289
+ wall += 2;
290
+ assert.equal(ctx().cupNow('race'), null, 'two missed one-minute refreshes make the clock stale');
291
+
292
+ h.place(world);
293
+ await flush();
294
+ assert.equal(ctx().cupNow('race'), null, 'a non-integer host clock is rejected');
295
+ assert.equal(Object.hasOwn(ctx().board('race').event, 'cupNow'), false, 'malformed raw metadata is still private');
296
+
297
+ wall += 60_001;
298
+ h.place(world);
299
+ await flush();
300
+ assert.equal(ctx().cupNow('race'), null, 'a failed paired board read cannot revive the clock');
301
+ } finally {
302
+ Date.now = realNow;
303
+ }
304
+ });
305
+
306
+ await test('a deck without weeklyCup keeps the legacy server API and read shapes', async () => {
307
+ const p = platformHub();
308
+ const s = session({ hub: p.hub });
309
+ const { h, world, ctx } = boot(s);
310
+ hello(h, s, 'p1');
311
+ h.place(world);
312
+ assert.equal(Object.hasOwn(ctx(), 'cup'), false);
313
+ assert.equal(Object.hasOwn(ctx(), 'cupNow'), false);
314
+ assert.equal(Object.hasOwn(ctx(), 'cupDeckId'), false);
315
+ assert.deepEqual(p.calls.filter(([op]) => op === 'read').map(([, input]) => Object.keys(input)), [['userIds'], ['doorIds']]);
316
+ assert.equal('cup' in h.join(), false);
317
+ });
318
+
186
319
  await test("a production door to another deck reads its title and group from ghost's board, its props until then", async () => {
187
320
  const actors = globalThis.__hubTestActors;
188
321
  globalThis.__hubTestActors = [
@@ -542,6 +675,86 @@ await test('a player who jumped to a friend arrives beside them, facing them', a
542
675
  assert.ok(Math.abs(me.facing - Math.atan2(-1.6, 0)) < 1e-9);
543
676
  });
544
677
 
678
+ await test('invite target survives an avatar hello before initial placement', async () => {
679
+ castleJson.hub.invite = true;
680
+ try {
681
+ const s = session();
682
+ const { h, world, arrived } = boot(s);
683
+ hello(h, s, 'p2'); h.place(world);
684
+ world.players.get('p2').at = { x: 10, y: 1, z: 5 };
685
+ hello(h, s, 'p1', { near: '102', invited: true });
686
+ // Platform avatar loading can replace the hello before progress is read.
687
+ hello(h, s, 'p1', { avatar: 2, again: true, invited: true });
688
+ h.place(world);
689
+ assert.equal(arrived.find((p) => p.playerId === 'p1').near, '102');
690
+ assert.equal(arrived.find((p) => p.playerId === 'p1').invited, true);
691
+ assert.ok(Math.abs(world.players.get('p1').at.x - 11.6) < 1e-9);
692
+ } finally { delete castleJson.hub.invite; }
693
+ });
694
+
695
+ // The v1.113 floor repair must not perturb established ground-backed town
696
+ // or game placement, nor invite-only authored-floor fallback.
697
+ function floorInvite({ optIn = true, ground = null, shape = null, at = { x: 0, y: 0.74, z: 0 }, run = false } = {}) {
698
+ const json = structuredClone(castleJson);
699
+ json.hub.invite = true;
700
+ if (optIn) {json.hub.bringFriend = true;}
701
+ if (run) {Object.assign(json.hub.places.race, { minPlayers: 1, lateJoin: true });}
702
+ const s = session({ sessionId: run ? 'dev:hub.race.test' : 'dev:test' });
703
+ const { h, world } = boot(s, {}, json, ground);
704
+ if (shape) {world.template = { shape };}
705
+ hello(h, s, 'p2'); h.place(world);
706
+ Object.assign(world.players.get('p2'), { at: { ...at }, facing: 0 });
707
+ hello(h, s, 'p1', { near: '102', invited: true }); h.place(world);
708
+ return { pose: world.players.get('p1').at, facing: world.players.get('p1').facing,
709
+ wire: s.sent, manifest: h.join() };
710
+ }
711
+
712
+ await test('bringFriend leaves ground-backed town and run placement byte-identical', async () => {
713
+ for (const run of [false, true]) {
714
+ const options = { run, at: { x: 10, y: 1, z: 5 }, shape: { kind: 'capsule', radius: 0.35, height: 1.4 } };
715
+ const before = floorInvite({ ...options, optIn: false });
716
+ const after = floorInvite(options);
717
+ assert.equal(JSON.stringify(after), JSON.stringify(before));
718
+ assert.deepEqual(after.pose, { x: 11.6, y: 1, z: 5 });
719
+ assert.equal(after.facing, -Math.PI / 2);
720
+ }
721
+ });
722
+
723
+ await test('opted-in authored floor supports an invited player beside and facing their friend', async () => {
724
+ const saved = globalThis.__hubTestActors;
725
+ const floor = { id: 'floor', components: { Solid: {}, Transform: { x: 0, y: -0.07, z: 0 }, Shape: { kind: 'box', width: 8, height: 0.14, depth: 7 } } };
726
+ globalThis.__hubTestActors = [saved[0], floor];
727
+ try {
728
+ const options = { ground: { none: true } };
729
+ const legacy = floorInvite({ ...options, optIn: false });
730
+ assert.notEqual(legacy.pose.x, 1.6, 'absent marker retains old fallback');
731
+ const fixed = floorInvite(options);
732
+ assert.deepEqual(fixed.pose, { x: 1.6, y: 0.74, z: 0 });
733
+ assert.equal(fixed.facing, -Math.PI / 2);
734
+
735
+ const wall = { id: 'wall', components: { Solid: {}, Transform: { x: 1.6, y: 1, z: 0 }, Shape: { kind: 'box', width: 0.8, height: 2, depth: 7 } } };
736
+ globalThis.__hubTestActors.push(wall);
737
+ assert.equal(floorInvite(options).pose.x, -1.6, 'real wall still rejects the right side');
738
+ globalThis.__hubTestActors.pop();
739
+
740
+ globalThis.__hubTestActors.push({ id: 'pad', components: { HubPad: { radius: 1 }, Transform: { x: 1.6, y: 0, z: 0 } } });
741
+ assert.equal(floorInvite(options).pose.x, -1.6, 'never arrive on a pad');
742
+ globalThis.__hubTestActors.pop();
743
+
744
+ globalThis.__hubTestActors.push({ id: 'roof', components: { Solid: {}, Transform: { x: 1.6, y: 1.6, z: 0 }, Shape: { kind: 'box', width: 1, height: 0.1, depth: 1 } } });
745
+ assert.equal(floorInvite(options).pose.x, 1.6, 'default 1.4m body fits below roof');
746
+ assert.equal(floorInvite({ ...options, shape: { kind: 'capsule', radius: 0.35, height: 1.8 }, at: { x: 0, y: 0.96, z: 0 } }).pose.x, -1.6, 'trusted taller body does not fit');
747
+ globalThis.__hubTestActors.pop();
748
+
749
+ floor.components.Shape.width = 1; floor.components.Shape.depth = 1;
750
+ const unsupported = floorInvite(options);
751
+ assert.notEqual(unsupported.pose.x, 1.6, 'no placement beside friend over a hole');
752
+ const invalid = floorInvite({ ...options, shape: { kind: 'capsule', radius: NaN, height: 1.4 } });
753
+ assert.equal(invalid.pose.x, unsupported.pose.x, 'invalid template keeps group placement');
754
+ assert.equal(invalid.pose.z, unsupported.pose.z);
755
+ } finally { globalThis.__hubTestActors = saved; }
756
+ });
757
+
545
758
  await test('a jump beside a friend takes a clear side, and none beside someone a block hides', async () => {
546
759
  const actors = globalThis.__hubTestActors;
547
760
  // A wall right of the friend (facing +z, right is +x).
@@ -649,6 +862,32 @@ await test('pads gather on change, fire with the gathered id, and the next gathe
649
862
  assert.equal(hub.go('race', ['p3']), null);
650
863
  });
651
864
 
865
+ await test('a guest ghost admitted, with a real user id, gathers, fires and goes; a playerless id does not', async () => {
866
+ const p = platformHub();
867
+ const s = session({ hub: p.hub });
868
+ s.session.players = [...PLAYERS, { playerId: 'g1', userId: '243', username: 'guest', isAnonymous: true }];
869
+ const { ctx } = boot(s);
870
+ const hub = ctx();
871
+ hub.pad('race', ['p1', 'g1', 'p3']);
872
+ const gathered = p.calls.filter((c) => c[0] === 'pad').at(-1)[1];
873
+ assert.deepEqual(gathered.memberUserIds, ['101', '243'], 'the guest counts on the pad; a dev-serve guest without an id does not');
874
+ const padId = gathered.padId;
875
+ assert.equal(hub.go('race', ['p1', 'g1']), padId);
876
+ await flush();
877
+ assert.deepEqual(p.calls.filter((c) => c[0] === 'pad').at(-1)[1].memberUserIds, ['101', '243']);
878
+ assert.deepEqual(
879
+ s.sent.filter(([, d]) => d.k === 'hub-go').map(([id]) => id).sort(),
880
+ ['g1', 'p1'],
881
+ 'the guest is sent through with the group',
882
+ );
883
+ const alone = platformHub();
884
+ const solo = session({ hub: alone.hub });
885
+ solo.session.players = [{ playerId: 'g1', userId: '243', username: 'guest', isAnonymous: true }];
886
+ const lone = boot(solo).ctx();
887
+ lone.pad('race', ['g1']);
888
+ assert.ok(lone.go('race', ['g1']), 'a guest alone can go through');
889
+ });
890
+
652
891
  await test('a fire whose answer is lost is retried on the same pad', async () => {
653
892
  const p = platformHub();
654
893
  let lose = true;
@@ -1269,4 +1508,84 @@ await test('sixteen avatars (v1.51): a place takes 0-15 from the hello and from
1269
1508
  }
1270
1509
  });
1271
1510
 
1511
+ await test('private goal coordinates stay out of shared snapshots and blocked recipients', async () => {
1512
+ const p = platformHub();
1513
+ p.hub.hiddenPair = (a, b) => new Set([a, b]).has('p2') && new Set([a, b]).has('p3');
1514
+ const s = session({ hub: p.hub });
1515
+ const { h, world, ctx } = boot(s);
1516
+ assert.equal(ctx().goalPositions, true);
1517
+ for (const { playerId } of PLAYERS) hello(h, s, playerId);
1518
+ h.place(world); await flush(); h.place(world);
1519
+ const at = { x: 81.25, y: 1.2, z: -53.75 };
1520
+ ctx().label('race-door', 'bo', { style: 'goal', to: ['p1', 'p3'], about: 'p2', at });
1521
+ at.x = 99; // The stored wire point must not alias the caller's object.
1522
+ h.step(world);
1523
+ const own = s.sent.filter(([id, data]) => id === 'p1' && data.k === 'hub-labels').at(-1)?.[1].labels;
1524
+ assert.deepEqual(own['race-door'].at, { x: 81.25, y: 1.2, z: -53.75 });
1525
+ assert.ok(!JSON.stringify(s.sent.filter(([id]) => id === 'p3')).includes('81.25'));
1526
+ assert.ok(!JSON.stringify(h.join()).includes('81.25'), 'shared join has no private coordinates');
1527
+ assert.equal(Object.keys(h.join().spawned).length, 0, 'no spawned tracking actor');
1528
+ assert.equal(world.bodies.size, 0, 'no shared kinematic marker body');
1529
+ for (const bad of [{x:NaN,y:0,z:0}, {x:201,y:0,z:0}, {x:0,y:81,z:0}, {x:0,z:0}]) {
1530
+ ctx().label('race-door', 'bo', {style:'goal',to:['p1'],at:bad});
1531
+ h.step(world);
1532
+ const row=s.sent.filter(([id,data])=>id==='p1'&&data.k==='hub-labels').at(-1)?.[1].labels;
1533
+ assert.ok(!row['race-door'].at, 'invalid coordinates ignored');
1534
+ }
1535
+ ctx().label('race-door', 'bo', {style:'goal',at:{x:81.25,y:1.2,z:-53.75}});
1536
+ assert.ok(!JSON.stringify(h.join()).includes('81.25'), 'unscoped sign ignores coordinates');
1537
+ });
1538
+
1539
+
1540
+
1541
+
1542
+ await test('door telemetry follows real arrival/result/end and authenticated quit', async () => {
1543
+ const events = [], p = platformHub();
1544
+ p.hub.track = (id, event) => { events.push([id, event]); return Promise.resolve({ recorded: true }); };
1545
+ const s = session({ hub: p.hub, place: 'race' });
1546
+ const { h, world, ctx } = boot(s);
1547
+ hello(h, s, 'p1');
1548
+ h.place(world); await flush(); h.place(world);
1549
+ assert.equal(events.filter(([, e]) => e.kind === 28).length, 1);
1550
+ world.timeMs = 7000;
1551
+ assert.equal(ctx().result('p1', { outcome: 'win', score: 100 }), true);
1552
+ ctx().end(['p1']);
1553
+ assert.deepEqual(events.filter(([, e]) => e.kind === 29).map(([, e]) => [e.value, e.result]), [[7, 1]]);
1554
+ hello(h, s, 'p2'); h.place(world); await flush(); h.place(world);
1555
+ h.message(s.session, { playerId: 'p2' }, { k: 'hub-door-quit' });
1556
+ assert.equal(events.at(-1)[1].result, 2);
1557
+ h.message(s.session, { playerId: 'stranger' }, { k: 'hub-door-error', result: 2 });
1558
+ assert.equal(events.at(-1)[1].kind, 29);
1559
+ });
1560
+
1561
+
1562
+
1563
+ await test('authored visit results/end do not finish an interrupted competitive round', async () => {
1564
+ const events = [], p = platformHub();
1565
+ p.hub.track = (id, event) => { events.push([id, event]); return Promise.resolve({ recorded: true }); };
1566
+ const json = structuredClone(castleJson); json.hub.places.race.analyticsRounds = 'authored';
1567
+ const s = session({ hub: p.hub, place: 'race' });
1568
+ const { h, world, ctx } = boot(s, {}, json);
1569
+ hello(h,s,'p1'); h.place(world); await flush(); h.place(world);
1570
+ assert.equal(events.length,0,'no automatic arrival round in authored mode');
1571
+ ctx().track('p1','round_start',{value:1});
1572
+ assert.equal(ctx().result('p1',{outcome:'win',score:100}),true);
1573
+ ctx().end(['p1']);
1574
+ assert.equal(events.filter(([,e])=>e.kind===29).length,0,'visit result/end cannot claim round completion');
1575
+ world.players.delete('p1'); s.session.players = s.session.players.filter(p=>p.playerId!=='p1'); h.place(world);
1576
+ assert.deepEqual(events.filter(([,e])=>e.kind===29).map(([,e])=>e.result),[3],'disconnect closes interrupted round');
1577
+ });
1272
1578
  console.log(`hub ops: ${n} tests passed`);
1579
+
1580
+ // Opt-in exists after actual layer construction, before authored hooks run.
1581
+ {
1582
+ const s = session();
1583
+ const plain = boot(s);
1584
+ assert.equal(plain.ctx().firstVisit, undefined);
1585
+ assert.equal(plain.ctx().firstVisitArrived, undefined);
1586
+ const enabled = boot(session(), {}, { ...castleJson, hub: { ...castleJson.hub, firstVisit: { live: ['home', 'door'] } } });
1587
+ assert.deepEqual(enabled.ctx().firstVisit, { live: ['home', 'door'] });
1588
+ assert.equal(typeof enabled.ctx().firstVisitArrived, 'function');
1589
+ assert.equal(enabled.ctx().firstVisitArrived('unknown', 2), false);
1590
+ assert(Object.isFrozen(enabled.ctx().firstVisit.live));
1591
+ }