castle-web-cli 0.4.232 → 0.4.233

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (355) hide show
  1. package/dist/agent-failures.d.ts +8 -0
  2. package/dist/agent-failures.js +19 -2
  3. package/dist/agent-prompts.d.ts +1 -1
  4. package/dist/agent-prompts.js +10 -3
  5. package/dist/agent.d.ts +64 -3
  6. package/dist/agent.js +170 -81
  7. package/dist/castle-host/host.d.ts +1 -0
  8. package/dist/castle-host/host.js +51 -3
  9. package/dist/castleJson.d.ts +4 -2
  10. package/dist/castleJson.js +2 -0
  11. package/dist/check.d.ts +3 -1
  12. package/dist/check.js +11 -1
  13. package/dist/devSessionStorage.js +47 -1
  14. package/dist/importPinMismatch.d.ts +22 -0
  15. package/dist/importPinMismatch.js +77 -0
  16. package/dist/importRegression.js +3 -15
  17. package/dist/imports.d.ts +10 -3
  18. package/dist/imports.js +88 -20
  19. package/dist/index.js +5 -4
  20. package/dist/init.js +1 -1
  21. package/dist/platformDoc.js +22 -0
  22. package/dist/routerFences.d.ts +5 -0
  23. package/dist/routerFences.js +12 -2
  24. package/dist/save-deck.d.ts +5 -0
  25. package/dist/save-deck.js +37 -4
  26. package/dist/serve.js +3 -0
  27. package/dist/shell/assets/{index-D2tWM896.js → index-BjOxR-lW.js} +4 -4
  28. package/dist/shell/assets/index-MVLfNYd9.css +1 -0
  29. package/dist/shell/index.html +2 -2
  30. package/dist/taskSteer.d.ts +13 -0
  31. package/dist/taskSteer.js +22 -2
  32. package/kits/base/castle.json +1 -1
  33. package/kits/base/package-lock.json +1 -1
  34. package/kits/base/sdk/README.md +79 -2
  35. package/kits/base/sdk/avatar.d.ts +6 -2
  36. package/kits/base/sdk/avatar.js +12 -4
  37. package/kits/base/sdk/castle.d.ts +1 -1
  38. package/kits/base/sdk/commands.d.ts +14 -0
  39. package/kits/base/sdk/hub.d.ts +6 -2
  40. package/kits/base/sdk/hub.js +13 -0
  41. package/kits/base/sdk/multiplayer.js +17 -1
  42. package/kits/base/sdk/save.js +2 -1
  43. package/kits/base/sdk/server/hub.d.ts +87 -0
  44. package/kits/base/sdk/server/hub.js +70 -0
  45. package/kits/base/sdk/server/platformHandle.d.ts +31 -1
  46. package/kits/base/sdk/server/storage.d.ts +13 -0
  47. package/kits/base/sdk/server/storage.js +46 -0
  48. package/kits/base/sdk/server/wrapper.d.ts +36 -5
  49. package/kits/base/sdk/server/wrapper.js +83 -8
  50. package/kits/hub-game/CLAUDE.md +329 -11
  51. package/kits/hub-game/blueprints/avatar-10.scene +28 -0
  52. package/kits/hub-game/blueprints/avatar-11.scene +28 -0
  53. package/kits/hub-game/blueprints/avatar-12.scene +28 -0
  54. package/kits/hub-game/blueprints/avatar-13.scene +28 -0
  55. package/kits/hub-game/blueprints/avatar-14.scene +28 -0
  56. package/kits/hub-game/blueprints/avatar-15.scene +28 -0
  57. package/kits/hub-game/blueprints/avatar-4.scene +28 -0
  58. package/kits/hub-game/blueprints/avatar-5.scene +28 -0
  59. package/kits/hub-game/blueprints/avatar-6.scene +28 -0
  60. package/kits/hub-game/blueprints/avatar-7.scene +28 -0
  61. package/kits/hub-game/blueprints/avatar-8.scene +28 -0
  62. package/kits/hub-game/blueprints/avatar-9.scene +28 -0
  63. package/kits/hub-game/code/client/actorBudget.js +47 -0
  64. package/kits/hub-game/code/client/attention.js +11 -2
  65. package/kits/hub-game/code/client/avatar.js +309 -35
  66. package/kits/hub-game/code/client/avatarCap.js +228 -0
  67. package/kits/hub-game/code/client/avatarColors.js +70 -0
  68. package/kits/hub-game/code/client/avatarFaces.js +21 -0
  69. package/kits/hub-game/code/client/avatarShare.js +251 -0
  70. package/kits/hub-game/code/client/ballot.js +467 -0
  71. package/kits/hub-game/code/client/build.js +22 -0
  72. package/kits/hub-game/code/client/chrome.js +1144 -50
  73. package/kits/hub-game/code/client/companion.js +716 -0
  74. package/kits/hub-game/code/client/companionDress.js +99 -0
  75. package/kits/hub-game/code/client/decor.js +509 -0
  76. package/kits/hub-game/code/client/earned.js +131 -0
  77. package/kits/hub-game/code/client/emoteBubble.js +75 -0
  78. package/kits/hub-game/code/client/grab.js +339 -20
  79. package/kits/hub-game/code/client/hookLayer.js +299 -13
  80. package/kits/hub-game/code/client/idle.js +163 -22
  81. package/kits/hub-game/code/client/interestCap.js +81 -0
  82. package/kits/hub-game/code/client/keys.js +36 -0
  83. package/kits/hub-game/code/client/labelsNear.js +205 -0
  84. package/kits/hub-game/code/client/menuIcons.js +34 -0
  85. package/kits/hub-game/code/client/pack.js +6 -2
  86. package/kits/hub-game/code/client/packFormat.js +3 -3
  87. package/kits/hub-game/code/client/rehello.js +167 -0
  88. package/kits/hub-game/code/client/shot.js +92 -0
  89. package/kits/hub-game/code/client/sound.js +63 -8
  90. package/kits/hub-game/code/client/soundscape.js +1151 -0
  91. package/kits/hub-game/code/client/soundscapeActions.js +99 -0
  92. package/kits/hub-game/code/client/soundscapeAmbience.js +453 -0
  93. package/kits/hub-game/code/client/soundscapeBaked.js +143 -0
  94. package/kits/hub-game/code/client/soundscapeBusker.js +217 -0
  95. package/kits/hub-game/code/client/soundscapeCourt.js +200 -0
  96. package/kits/hub-game/code/client/soundscapeCrowd.js +331 -0
  97. package/kits/hub-game/code/client/soundscapeCues.js +362 -0
  98. package/kits/hub-game/code/client/soundscapeMap.js +181 -0
  99. package/kits/hub-game/code/client/soundscapeMarket.js +176 -0
  100. package/kits/hub-game/code/client/soundscapeMusic.js +126 -0
  101. package/kits/hub-game/code/client/soundscapeMusicEngine.js +460 -0
  102. package/kits/hub-game/code/client/soundscapeSimlish.js +737 -0
  103. package/kits/hub-game/code/client/soundscapeSongs.js +127 -0
  104. package/kits/hub-game/code/client/soundscapeSongsRound3.js +63 -0
  105. package/kits/hub-game/code/client/soundscapeSynthesis.js +168 -0
  106. package/kits/hub-game/code/client/soundscapeUi.js +211 -0
  107. package/kits/hub-game/code/client/soundscapeVoice.js +1209 -0
  108. package/kits/hub-game/code/client/soundscapeWaves.js +206 -0
  109. package/kits/hub-game/code/client/spin.js +101 -0
  110. package/kits/hub-game/code/client/state.js +109 -1
  111. package/kits/hub-game/code/client/stuck.js +259 -0
  112. package/kits/hub-game/code/client/talk.js +538 -47
  113. package/kits/hub-game/code/client/tiers.js +516 -27
  114. package/kits/hub-game/code/client/toastBand.js +37 -0
  115. package/kits/hub-game/code/client/together.js +32 -0
  116. package/kits/hub-game/code/client/visibility.js +43 -0
  117. package/kits/hub-game/code/client/wear.js +461 -170
  118. package/kits/hub-game/code/client/yours.js +199 -0
  119. package/kits/hub-game/code/companionSpec.js +45 -0
  120. package/kits/hub-game/code/privateText.js +7 -0
  121. package/kits/hub-game/code/server/actions.js +133 -0
  122. package/kits/hub-game/code/server/actors.js +9 -1
  123. package/kits/hub-game/code/server/ask.js +155 -0
  124. package/kits/hub-game/code/server/ballot.js +539 -0
  125. package/kits/hub-game/code/server/cells.js +100 -0
  126. package/kits/hub-game/code/server/companion.js +82 -0
  127. package/kits/hub-game/code/server/cues.js +70 -0
  128. package/kits/hub-game/code/server/decor.js +269 -0
  129. package/kits/hub-game/code/server/earned.js +461 -0
  130. package/kits/hub-game/code/server/friendBests.js +166 -0
  131. package/kits/hub-game/code/server/friendsAmong.js +232 -0
  132. package/kits/hub-game/code/server/history.js +5 -0
  133. package/kits/hub-game/code/server/hub.js +1254 -50
  134. package/kits/hub-game/code/server/idle.js +30 -11
  135. package/kits/hub-game/code/server/index.js +2 -2
  136. package/kits/hub-game/code/server/labels.js +28 -2
  137. package/kits/hub-game/code/server/manifest.js +378 -7
  138. package/kits/hub-game/code/server/menu.js +133 -0
  139. package/kits/hub-game/code/server/npcs.js +830 -80
  140. package/kits/hub-game/code/server/party.js +2 -2
  141. package/kits/hub-game/code/server/players.js +22 -0
  142. package/kits/hub-game/code/server/shot.js +110 -0
  143. package/kits/hub-game/code/server/standing.js +124 -0
  144. package/kits/hub-game/code/server/vis.js +113 -0
  145. package/kits/hub-game/code/server/wear.js +12 -0
  146. package/kits/hub-game/code/server/yours.js +59 -0
  147. package/kits/hub-game/code/shared/cues.js +9 -0
  148. package/kits/hub-game/code/shared/decor.js +41 -0
  149. package/kits/hub-game/code/shared/shot.js +19 -0
  150. package/kits/hub-game/code/shared/spin.js +57 -0
  151. package/kits/hub-game/code/systems/hub.js +845 -95
  152. package/kits/hub-game/docs/content-pack.md +1 -1
  153. package/kits/hub-game/docs/contract.md +2244 -61
  154. package/kits/hub-game/docs/home-pieces.md +64 -0
  155. package/kits/hub-game/models/avatar-10.pxmodel +28 -0
  156. package/kits/hub-game/models/avatar-11.pxmodel +28 -0
  157. package/kits/hub-game/models/avatar-12.pxmodel +27 -0
  158. package/kits/hub-game/models/avatar-13.pxmodel +24 -0
  159. package/kits/hub-game/models/avatar-14.pxmodel +29 -0
  160. package/kits/hub-game/models/avatar-15.pxmodel +24 -0
  161. package/kits/hub-game/models/avatar-4.pxmodel +29 -0
  162. package/kits/hub-game/models/avatar-5.pxmodel +27 -0
  163. package/kits/hub-game/models/avatar-6.pxmodel +26 -0
  164. package/kits/hub-game/models/avatar-7.pxmodel +25 -0
  165. package/kits/hub-game/models/avatar-8.pxmodel +24 -0
  166. package/kits/hub-game/models/avatar-9.pxmodel +30 -0
  167. package/kits/hub-game/models/earned/badge-round.pxmodel +100 -0
  168. package/kits/hub-game/models/earned/badge-shield.pxmodel +117 -0
  169. package/kits/hub-game/models/earned/badge-star.pxmodel +87 -0
  170. package/kits/hub-game/models/earned/belt-plain.pxmodel +72 -0
  171. package/kits/hub-game/models/earned/held-ball.pxmodel +43 -0
  172. package/kits/hub-game/models/earned/held-lantern.pxmodel +85 -0
  173. package/kits/hub-game/models/earned/held-net.pxmodel +57 -0
  174. package/kits/hub-game/models/earned/held-trophy.pxmodel +109 -0
  175. package/kits/hub-game/models/earned/pin-round.pxmodel +62 -0
  176. package/kits/hub-game/models/earned/sash-plain.pxmodel +66 -0
  177. package/kits/hub-game/models/earned/square/belt-plain.pxmodel +104 -0
  178. package/kits/hub-game/models/earned/square/sash-plain.pxmodel +98 -0
  179. package/kits/hub-game/models/hats/bat-clip.pxmodel +206 -0
  180. package/kits/hub-game/models/hats/beekeeper.pxmodel +149 -0
  181. package/kits/hub-game/models/hats/cap.pxmodel +162 -0
  182. package/kits/hub-game/models/hats/captain.pxmodel +178 -0
  183. package/kits/hub-game/models/hats/crooked-top.pxmodel +172 -0
  184. package/kits/hub-game/models/hats/flower-crown.pxmodel +451 -0
  185. package/kits/hub-game/models/hats/foam-crown.pxmodel +179 -0
  186. package/kits/hub-game/models/hats/lantern.pxmodel +230 -0
  187. package/kits/hub-game/models/hats/laurel.pxmodel +533 -0
  188. package/kits/hub-game/models/hats/lighthouse.pxmodel +96 -0
  189. package/kits/hub-game/models/hats/sailor.pxmodel +141 -0
  190. package/kits/hub-game/models/hats/souwester.pxmodel +131 -0
  191. package/kits/hub-game/models/hats/straw.pxmodel +139 -0
  192. package/kits/hub-game/models/hats/sunflower.pxmodel +406 -0
  193. package/kits/hub-game/models/hats/sweatband.pxmodel +112 -0
  194. package/kits/hub-game/models/hats/witch.pxmodel +147 -0
  195. package/kits/hub-game/package-lock.json +2 -0
  196. package/kits/hub-game/package.json +2 -1
  197. package/kits/hub-game/scripts/check.mjs +78 -11
  198. package/kits/hub-game/scripts/companion-follower-wire.json +1 -0
  199. package/kits/hub-game/scripts/fixtures/decor-keyless-draw.json +121 -0
  200. package/kits/hub-game/scripts/fixtures/decor-keyless.json +293 -0
  201. package/kits/hub-game/scripts/fixtures/engine-models-stub.mjs +23 -0
  202. package/kits/hub-game/scripts/fixtures/fake-dom.mjs +107 -0
  203. package/kits/hub-game/scripts/fixtures/interest-legacy.json +385 -0
  204. package/kits/hub-game/scripts/fixtures/npc-notes-v1.77.jsonl +4 -0
  205. package/kits/hub-game/scripts/fixtures/vis-shared-wire.json +1 -0
  206. package/kits/hub-game/scripts/gen-avatars.mjs +933 -16
  207. package/kits/hub-game/scripts/gen-earned.mjs +285 -0
  208. package/kits/hub-game/scripts/gen-hats.mjs +827 -0
  209. package/kits/hub-game/scripts/grab.before-orbit.mjs +400 -0
  210. package/kits/hub-game/scripts/soundscape-wave-analysis.mjs +125 -0
  211. package/kits/hub-game/scripts/test-actions-client.mjs +488 -0
  212. package/kits/hub-game/scripts/test-actions.mjs +298 -0
  213. package/kits/hub-game/scripts/test-actor-budget.mjs +44 -0
  214. package/kits/hub-game/scripts/test-actors.mjs +19 -17
  215. package/kits/hub-game/scripts/test-ask-client.mjs +358 -0
  216. package/kits/hub-game/scripts/test-ask.mjs +269 -0
  217. package/kits/hub-game/scripts/test-attention.mjs +10 -1
  218. package/kits/hub-game/scripts/test-avatar-cap.mjs +379 -0
  219. package/kits/hub-game/scripts/test-avatar-colors.mjs +72 -0
  220. package/kits/hub-game/scripts/test-avatar-models.mjs +181 -0
  221. package/kits/hub-game/scripts/test-avatar-share.mjs +318 -0
  222. package/kits/hub-game/scripts/test-avatar-wire.mjs +753 -0
  223. package/kits/hub-game/scripts/test-avatar.mjs +540 -7
  224. package/kits/hub-game/scripts/test-ballot.mjs +1001 -0
  225. package/kits/hub-game/scripts/test-build.mjs +31 -0
  226. package/kits/hub-game/scripts/test-cells.mjs +71 -0
  227. package/kits/hub-game/scripts/test-chat.mjs +662 -0
  228. package/kits/hub-game/scripts/test-classic.mjs +2 -0
  229. package/kits/hub-game/scripts/test-companion-chat.mjs +198 -0
  230. package/kits/hub-game/scripts/test-companion-client.mjs +1167 -0
  231. package/kits/hub-game/scripts/test-companion.mjs +259 -0
  232. package/kits/hub-game/scripts/test-decor-client.mjs +303 -0
  233. package/kits/hub-game/scripts/test-decor.mjs +457 -0
  234. package/kits/hub-game/scripts/test-earned-client.mjs +459 -0
  235. package/kits/hub-game/scripts/test-earned.mjs +1194 -0
  236. package/kits/hub-game/scripts/test-emote-bubble.mjs +110 -0
  237. package/kits/hub-game/scripts/test-friend-bests.mjs +435 -0
  238. package/kits/hub-game/scripts/test-grab-orbit.mjs +918 -0
  239. package/kits/hub-game/scripts/test-grab.mjs +7 -0
  240. package/kits/hub-game/scripts/test-hats.mjs +422 -168
  241. package/kits/hub-game/scripts/test-hub-leaving.mjs +203 -0
  242. package/kits/hub-game/scripts/test-hub-ops.mjs +439 -2
  243. package/kits/hub-game/scripts/test-hub-trip.mjs +716 -2
  244. package/kits/hub-game/scripts/test-hud-clear.mjs +328 -4
  245. package/kits/hub-game/scripts/test-idle.mjs +361 -1
  246. package/kits/hub-game/scripts/test-interest-cap.mjs +36 -0
  247. package/kits/hub-game/scripts/test-interest-cells.mjs +493 -0
  248. package/kits/hub-game/scripts/test-interest-client.mjs +118 -0
  249. package/kits/hub-game/scripts/test-keys.mjs +46 -1
  250. package/kits/hub-game/scripts/test-labels.mjs +596 -0
  251. package/kits/hub-game/scripts/test-manifest.mjs +207 -0
  252. package/kits/hub-game/scripts/test-menu-client.mjs +480 -0
  253. package/kits/hub-game/scripts/test-menu.mjs +296 -0
  254. package/kits/hub-game/scripts/test-npcs.mjs +1718 -12
  255. package/kits/hub-game/scripts/test-object-entry.mjs +76 -0
  256. package/kits/hub-game/scripts/test-pack.mjs +7 -0
  257. package/kits/hub-game/scripts/test-picker.mjs +314 -0
  258. package/kits/hub-game/scripts/test-rehello.mjs +1039 -0
  259. package/kits/hub-game/scripts/test-relations-among.mjs +222 -0
  260. package/kits/hub-game/scripts/test-relations-refresh.mjs +188 -0
  261. package/kits/hub-game/scripts/test-shot.mjs +756 -0
  262. package/kits/hub-game/scripts/test-soundscape.mjs +5432 -0
  263. package/kits/hub-game/scripts/test-spin.mjs +314 -0
  264. package/kits/hub-game/scripts/test-standing.mjs +416 -0
  265. package/kits/hub-game/scripts/test-stuck.mjs +1903 -0
  266. package/kits/hub-game/scripts/test-tier-cells.mjs +706 -0
  267. package/kits/hub-game/scripts/test-tiers-render.mjs +339 -0
  268. package/kits/hub-game/scripts/test-tiers.mjs +477 -2
  269. package/kits/hub-game/scripts/test-toast-band.mjs +61 -0
  270. package/kits/hub-game/scripts/test-try-on.mjs +22 -22
  271. package/kits/hub-game/scripts/test-vis.mjs +343 -0
  272. package/kits/hub-game/scripts/test-visibility.mjs +134 -0
  273. package/kits/hub-game/scripts/test-yours-chrome.mjs +166 -0
  274. package/kits/hub-game/scripts/test-yours.mjs +372 -0
  275. package/kits/multiplayer-3d/CLAUDE.md +50 -0
  276. package/kits/multiplayer-3d/castle.json +5 -5
  277. package/kits/multiplayer-3d/code/client/avatars.js +7 -0
  278. package/kits/multiplayer-3d/code/client/gait.js +65 -0
  279. package/kits/multiplayer-3d/code/client/nameTags.js +59 -4
  280. package/kits/multiplayer-3d/code/options.js +5 -0
  281. package/kits/multiplayer-3d/code/server/ownership.js +10 -2
  282. package/kits/multiplayer-3d/code/server/sceneBodies.js +12 -0
  283. package/kits/multiplayer-3d/code/server/world.js +7 -0
  284. package/kits/multiplayer-3d/code/systems/multiplayer.js +74 -4
  285. package/kits/multiplayer-3d/package.json +2 -1
  286. package/kits/multiplayer-3d/scripts/fixtures/README.md +11 -0
  287. package/kits/multiplayer-3d/scripts/fixtures/ownership-legacy.json +2 -0
  288. package/kits/multiplayer-3d/scripts/ownership-harness.mjs +102 -0
  289. package/kits/multiplayer-3d/scripts/ownership-loader.mjs +46 -0
  290. package/kits/multiplayer-3d/scripts/ownership-worker.mjs +15 -0
  291. package/kits/multiplayer-3d/scripts/record-ownership-session.mjs +98 -0
  292. package/kits/multiplayer-3d/scripts/test-eligible-claims.mjs +167 -0
  293. package/kits/multiplayer-3d/scripts/test-own-name-tag.mjs +247 -0
  294. package/kits/physics-2d/CLAUDE.md +9 -0
  295. package/kits/physics-2d/castle.json +2 -2
  296. package/kits/physics-2d/engine/scene.js +253 -1
  297. package/kits/physics-2d/engine/skyKey.js +129 -0
  298. package/kits/physics-2d/engine/stillClock.js +106 -0
  299. package/kits/physics-2d/engine/updateBudget.js +21 -0
  300. package/kits/physics-2d/scripts/test-skip-unchanged.mjs +326 -1
  301. package/kits/physics-3d/CLAUDE.md +1169 -30
  302. package/kits/physics-3d/behaviors/Player.jsx +629 -72
  303. package/kits/physics-3d/castle.json +3 -3
  304. package/kits/physics-3d/docs/pxmodel-format.md +8 -0
  305. package/kits/physics-3d/engine3d/Scene3DPlayer.jsx +69 -13
  306. package/kits/physics-3d/engine3d/actornode.js +86 -0
  307. package/kits/physics-3d/engine3d/animationBudget.js +23 -0
  308. package/kits/physics-3d/engine3d/editorWorld.js +6 -0
  309. package/kits/physics-3d/engine3d/emptynodes.js +232 -0
  310. package/kits/physics-3d/engine3d/framecap.js +96 -0
  311. package/kits/physics-3d/engine3d/gait.js +118 -0
  312. package/kits/physics-3d/engine3d/kithooks.js +47 -0
  313. package/kits/physics-3d/engine3d/look.js +507 -48
  314. package/kits/physics-3d/engine3d/lookbake.js +208 -0
  315. package/kits/physics-3d/engine3d/materialpresets.js +2 -0
  316. package/kits/physics-3d/engine3d/motion.js +39 -10
  317. package/kits/physics-3d/engine3d/nearshadows.js +37 -19
  318. package/kits/physics-3d/engine3d/optimize.js +9 -5
  319. package/kits/physics-3d/engine3d/orbitinput.js +487 -9
  320. package/kits/physics-3d/engine3d/orbitlens.js +48 -0
  321. package/kits/physics-3d/engine3d/ownmodel.js +213 -0
  322. package/kits/physics-3d/engine3d/pxmodel.js +42 -11
  323. package/kits/physics-3d/engine3d/shadowfade.js +882 -0
  324. package/kits/physics-3d/engine3d/sky.js +547 -0
  325. package/kits/physics-3d/engine3d/skylife.js +306 -0
  326. package/kits/physics-3d/engine3d/unchanged.js +11 -0
  327. package/kits/physics-3d/engine3d/viewrange.js +52 -0
  328. package/kits/physics-3d/engine3d/world3d.js +796 -69
  329. package/kits/physics-3d/main.jsx +5 -0
  330. package/kits/physics-3d/package.json +1 -1
  331. package/kits/physics-3d/scripts/look-baseline.mjs +155 -0
  332. package/kits/physics-3d/scripts/test-camera-orbit.mjs +2563 -80
  333. package/kits/physics-3d/scripts/test-drop-empty-parts.mjs +1 -1
  334. package/kits/physics-3d/scripts/test-frame-cap-bob.mjs +435 -0
  335. package/kits/physics-3d/scripts/test-frame-cap.mjs +452 -0
  336. package/kits/physics-3d/scripts/test-gait.mjs +387 -0
  337. package/kits/physics-3d/scripts/test-look-bake.mjs +1056 -0
  338. package/kits/physics-3d/scripts/test-model-parse-cache.mjs +92 -0
  339. package/kits/physics-3d/scripts/test-near-shadows.mjs +3 -0
  340. package/kits/physics-3d/scripts/test-orbit-shadow-fade.mjs +1920 -0
  341. package/kits/physics-3d/scripts/test-orbit-shift-lock.mjs +545 -0
  342. package/kits/physics-3d/scripts/test-orbit-shot.mjs +583 -0
  343. package/kits/physics-3d/scripts/test-orbit-view.mjs +230 -0
  344. package/kits/physics-3d/scripts/test-skip-empty-nodes.mjs +845 -0
  345. package/kits/physics-3d/scripts/test-sky.mjs +2470 -0
  346. package/kits/physics-3d/scripts/test-static-actors.mjs +8 -1
  347. package/kits/physics-3d/scripts/test-static-scenery.mjs +2171 -0
  348. package/kits/physics-3d/scripts/test-steady-hover.mjs +2 -0
  349. package/kits/physics-3d/scripts/test-view-range.mjs +260 -0
  350. package/kits/physics-3d/systems/physics3d.js +383 -6
  351. package/kits/real-time/castle.json +2 -2
  352. package/kits/real-time/code/server/gameHooks.js +7 -0
  353. package/kits/real-time/code/server/session.js +97 -19
  354. package/package.json +2 -2
  355. package/dist/shell/assets/index-Cf61cNfT.css +0 -1
@@ -0,0 +1,296 @@
1
+ // v1.79 private menus: real hub hooks, exact wire, validation and lifecycle.
2
+ import assert from 'node:assert/strict';
3
+ import { register } from 'node:module';
4
+
5
+ register(`data:text/javascript,${encodeURIComponent(`
6
+ export async function resolve(specifier, context, next) {
7
+ if (specifier === '@imports/castle.multiplayer-3d/code/server/sceneBodies.js') return { url: 'data:text/javascript,export const readScene = () => globalThis.__hubTestActors;', shortCircuit: true };
8
+ if (context.parentURL?.includes('/kits/base/sdk/') && specifier.startsWith('.') && !specifier.endsWith('.js')) return next(specifier + '.js', context);
9
+ return next(specifier, context);
10
+ }
11
+
12
+ `)}`);
13
+ const { layer } = await import('../code/server/hub.js');
14
+ const Manifest = await import('../code/server/manifest.js');
15
+ const actors = [
16
+ { id: 'player', components: { Player: {}, Transform: { x: 0, y: 1, z: 0 } } },
17
+ { id: 'floor', components: { Transform: { x: 0, y: 0, z: 0 } } },
18
+ ];
19
+ const players = [
20
+ { playerId: 'p1', userId: '101', username: 'Ada', isAnonymous: false },
21
+ { playerId: 'p2', userId: '102', username: 'Bo', isAnonymous: false },
22
+ ];
23
+ const json = (keys = {}) => ({ server: { maxPlayers: 8 }, hub: { contract: 1, title: 'House', ...keys } });
24
+ function boot(keys = {}, options = {}) {
25
+ const sent = [], ops = [], arrivals = [];
26
+ let hub;
27
+ const hooks = { ready(ctx) { hub = ctx; }, arrive(ctx, group) { arrivals.push([ctx.owner ?? null, group.map((p) => p.playerId)]); }, menu(ctx, playerId, id) { ops.push([playerId, id]); }, ...(options.hooks ?? {}) };
28
+ const bodies = [];
29
+ const engine = {
30
+ createBody(sim, actor, at) {
31
+ const rb = { at: { ...at }, setEnabled() {}, setNextKinematicTranslation(at) { this.at = { ...at }; }, setNextKinematicRotation() {} };
32
+ bodies.push([actor.id, rb]);
33
+ return rb;
34
+ },
35
+ removeActor(sim, id) { sim.bodies.delete(id); sim.objects.delete(id); },
36
+ };
37
+ globalThis.__hubTestActors = structuredClone(actors);
38
+ const server = layer(json(keys), hooks, {}, () => true, () => null, null, engine);
39
+ const session = { sessionId: options.sessionId ?? 'dev', players: [...players], hub: options.platform ?? null, send(id, msg) { sent.push([id, structuredClone(msg)]); }, broadcast(msg) { sent.push(['all', structuredClone(msg)]); } };
40
+ const world = { timeMs: 0, scenePath: 'scenes/main.scene', objects: new Map(), bodies: new Map(), players: new Map(players.map((p) => [p.playerId, { at: { x: 0, y: 1, z: 0 }, facing: 0, body: { setTranslation() {} } }])) };
41
+ server.sceneFor(session);
42
+ server.ready(world);
43
+ const say = (id, data) => server.message(session, { playerId: id }, data);
44
+ if (options.hello !== false) {
45
+ for (const id of options.order ?? ['p1', 'p2']) {
46
+ say(id, { k: 'hub-hello', avatar: 0, party: 2 });
47
+ }
48
+ server.place(world);
49
+ }
50
+ const tick = (ms = 50) => { world.timeMs += ms; server.place(world); server.step(world, []); };
51
+ return { server, session, world, hub, sent, ops, say, tick, bodies, arrivals, hooks };
52
+ }
53
+ const Menu = await import('../code/server/menu.js');
54
+ const { EARNED_SHAPES } = await import('../code/client/earned.js');
55
+ const { HATS } = await import('../code/client/hats.js');
56
+ const spec = { title: 'Wardrobe', note: 'Choose a look', sections: [{ title: 'Colours', items: [{ id: 'blue', label: 'Blue', color: '#123abc', icon: 'badge-star', on: true }] }] };
57
+ const wire = (r) => r.sent.filter(([, msg]) => msg.k === 'hub-menu');
58
+ const offer = (r, p = 'p1') => wire(r).findLast(([id]) => id === p)?.[1];
59
+ const pick = (r, id = 'blue', p = 'p1', n = offer(r, p)?.n) => r.say(p, { k: 'hub-menu-pick', id, n });
60
+ let passed = 0;
61
+ async function test(name, fn) { await fn(); passed++; console.log(`ok: ${name}`); }
62
+ const itemSpec = (item) => ({ title: 'Menu', sections: [{ title: 'Section', items: [item] }] });
63
+ const baseItem = spec.sections[0].items[0];
64
+
65
+ await test('manifest main/named places: only true or absent, publicPlace opted in only', () => {
66
+ for (const named of [false, true]) {
67
+ for (const value of [true, false, null, undefined, 0, 1, '', 'true', {}, []]) {
68
+ const keys = named ? { places: { porch: { title: 'Porch', scene: 'scenes/main.scene', menu: value } } } : { menu: value };
69
+ const read = Manifest.readManifest(json(keys));
70
+ assert.equal(read.errors.some((e) => e.includes('.menu')), value !== true);
71
+ if (value === true) {
72
+ const id = named ? 'porch' : 'main';
73
+ assert.equal(read.manifest.places[id].menu, true);
74
+ assert.equal(Manifest.publicPlace(id, read.manifest.places[id]).menu, true);
75
+ }
76
+ }
77
+ }
78
+ const plain = Manifest.readManifest(json()).manifest.places.main;
79
+ assert(!Object.hasOwn(plain, 'menu')); assert(!Object.hasOwn(Manifest.publicPlace('main', plain), 'menu'));
80
+ });
81
+ await test('atomic validation: every bound, type, required/unknown own key and text hygiene', () => {
82
+ const r = boot({ menu: true }); r.hub.menu('p1', spec); r.tick(250);
83
+ const before = offer(r), plain = { title: 'Menu', sections: [{ title: 'Section', items: [] }] };
84
+ const invalid = [undefined, false, [], 'x', {}, new Date(), Object.create(spec),
85
+ { ...plain, title: '' }, { ...plain, title: ' ' }, { ...plain, title: '😀'.repeat(33) },
86
+ { ...plain, note: '' }, { ...plain, note: ' ' }, { ...plain, note: '😀'.repeat(81) },
87
+ { ...plain, readOnly: 1 },
88
+ ...[NaN, Infinity, -Infinity, undefined, null, '90', true, {}, new Number(90)].map((face) => ({ ...plain, face })),
89
+ { ...plain, sections: Array(9).fill(plain.sections[0]) },
90
+ { ...plain, sections: {} }, { ...plain, sections: Array(1) },
91
+ { ...plain, sections: [{ title: '', items: [] }] }, { ...plain, sections: [{ title: '😀'.repeat(25), items: [] }] },
92
+ { ...plain, sections: [{ title: 'ok', items: Array(1) }] }, { ...plain, sections: [{ title: 'ok', items: {} }] },
93
+ { ...plain, sections: [{ title: 'ok' }] }, { ...plain, sections: [new Date()] },
94
+ { ...plain, extra: 1 }, { ...plain, [Symbol('extra')]: true }, Object.defineProperty({ ...plain }, 'hidden', { value: 1 }),
95
+ { ...plain, sections: [{ ...plain.sections[0], extra: 1 }] },
96
+ ...['A', 'blue\n', 'a'.repeat(33), 'close', '', 1].map((id) => itemSpec({ ...baseItem, id })),
97
+ ...['', ' ', '😀'.repeat(17), 1].map((label) => itemSpec({ ...baseItem, label })),
98
+ ...['#fff', '#ffffff\n', 'red', 1, null].map((color) => itemSpec({ ...baseItem, color })),
99
+ ...['unknown', 'hat-cap', '', null].map((icon) => itemSpec({ ...baseItem, icon })),
100
+ ...[1, null, 'true', undefined].map((on) => itemSpec({ ...baseItem, on })),
101
+ itemSpec({ ...baseItem, extra: 1 }), itemSpec(Object.create(baseItem)), itemSpec({ id: 'blue' }),
102
+ { ...plain, sections: [{ title: 'one', items: [baseItem] }, { title: 'two', items: [baseItem] }] },
103
+ { ...plain, sections: [{ title: 'one', items: Array.from({ length: 25 }, (_, i) => ({ id: `a${i}`, label: 'A' })) }, { title: 'two', items: Array.from({ length: 24 }, (_, i) => ({ id: `b${i}`, label: 'B' })) }] },
104
+ { ...plain, sections: [{ title: 'one', items: Array.from({ length: 49 }, (_, i) => ({ id: `a${i}`, label: 'A' })) }] },
105
+ ];
106
+ const cps = [...Array.from({ length: 32 }, (_, i) => i), ...Array.from({ length: 33 }, (_, i) => 127 + i), 0x061c, ...Array.from({ length: 5 }, (_, i) => 0x200b + i), ...Array.from({ length: 5 }, (_, i) => 0x202a + i), ...Array.from({ length: 10 }, (_, i) => 0x2060 + i), 0xfeff];
107
+ for (const cp of cps) {
108
+ const text = `a${String.fromCodePoint(cp)}`;
109
+ invalid.push({ ...plain, title: text }, { ...plain, note: text }, { ...plain, sections: [{ title: text, items: [] }] }, itemSpec({ ...baseItem, label: text }));
110
+ }
111
+ for (const bad of invalid) {
112
+ assert.throws(() => r.hub.menu('p1', bad), TypeError);
113
+ r.tick(250); assert.deepEqual(offer(r), before);
114
+ }
115
+ assert.throws(() => r.hub.menu(null, spec), TypeError);
116
+ const max = { title: '😀'.repeat(32), note: '😀'.repeat(80), readOnly: false, sections: Array.from({ length: 8 }, (_, section) => ({ title: '😀'.repeat(24), items: Array.from({ length: 6 }, (_, i) => ({ id: `a${section}_${i}`, label: '😀'.repeat(16), color: '#ABCDEF', on: false })) })) };
117
+ max.sections[0].items[0].id = 'a'.repeat(32);
118
+ assert(r.hub.menu('p1', max)); r.tick(250); assert.deepEqual(offer(r).spec, max);
119
+ assert(r.hub.menu('p1', { title: 'Empty wardrobe', note: 'Earn things', sections: [] }));
120
+ r.tick(250); assert.deepEqual(offer(r).spec.sections, []);
121
+ assert(r.hub.menu('p1', plain));
122
+ for (const icon of [...EARNED_SHAPES, ...HATS]) assert(r.hub.menu('p1', itemSpec({ ...baseItem, icon })));
123
+ });
124
+ await test('face normalises finite degrees, copies input and preserves absent-key wire bytes', () => {
125
+ const r = boot({ menu: true });
126
+ for (const [face, normal] of [[0, 0], [-0, 0], [90, 90], [-90, -90], [180, -180], [-180, -180], [540, -180], [-541, 179], [720.5, 0.5], [Number.MAX_VALUE, 128], [-Number.MAX_VALUE, -128]]) {
127
+ const input = { ...spec, face };
128
+ assert(r.hub.menu('p1', input)); input.face = 17; r.tick(250);
129
+ assert.equal(offer(r).spec.face, normal);
130
+ assert.equal(JSON.stringify(offer(r)), JSON.stringify({ k: 'hub-menu', spec: { title: spec.title, sections: spec.sections, note: spec.note, face: normal }, n: offer(r).n }));
131
+ }
132
+ const count = wire(r).length, n = offer(r).n;
133
+ r.hub.menu('p1', { ...spec, face: 232 }); r.tick(250);
134
+ assert.equal(wire(r).length, count); assert.equal(offer(r).n, n);
135
+ const plain = boot({ menu: true }); plain.hub.menu('p1', spec); plain.tick(250);
136
+ assert.equal(JSON.stringify(offer(plain)), '{"k":"hub-menu","spec":{"title":"Wardrobe","sections":[{"title":"Colours","items":[{"id":"blue","label":"Blue","color":"#123abc","icon":"badge-star","on":true}]}],"note":"Choose a look"},"n":1}');
137
+ plain.hub.menu('p1', null); plain.tick(250);
138
+ assert.equal(JSON.stringify(offer(plain)), '{"k":"hub-menu","spec":null,"n":2}');
139
+ });
140
+ await test('sections and items copy bounded indices without iterators', () => {
141
+ const r = boot({ menu: true });
142
+ for (const length of [0, 1]) {
143
+ const sections = Array.from({ length }, () => ({ title: 'Section', items: [] }));
144
+ sections[Symbol.iterator] = function* () { assert.fail('sections iterator read'); yield* Array(9).fill(spec.sections[0]); };
145
+ assert(r.hub.menu('p1', { title: 'Menu', sections })); r.tick(250);
146
+ assert.equal(offer(r).spec.sections.length, length);
147
+ const items = Array.from({ length }, () => baseItem);
148
+ items[Symbol.iterator] = function* () { assert.fail('items iterator read'); yield baseItem; };
149
+ assert(r.hub.menu('p1', { title: 'Menu', sections: [{ title: 'Section', items }] })); r.tick(250);
150
+ assert.equal(offer(r).spec.sections[0].items.length, length);
151
+ }
152
+ });
153
+ await test('required and optional own getters read once; copied input; throwing getters atomic', () => {
154
+ const r = boot({ menu: true }); const reads = {};
155
+ function getters(value, prefix) {
156
+ const out = Object.create(null);
157
+ for (const [key, field] of Object.entries(value)) Object.defineProperty(out, key, { enumerable: true, get() { const name = `${prefix}.${key}`; reads[name] = (reads[name] ?? 0) + 1; return field; } });
158
+ return out;
159
+ }
160
+ const item = getters(baseItem, 'item'), section = getters({ title: 'Colours', items: [item] }, 'section');
161
+ r.hub.menu('p1', getters({ title: 'Wardrobe', note: 'Choose', readOnly: true, face: 450, sections: [section] }, 'spec'));
162
+ assert(Object.values(reads).every((n) => n === 1)); r.tick(250); const old = offer(r);
163
+ assert.equal(reads['spec.face'], 1); assert.equal(old.spec.face, 90);
164
+ assert.throws(() => r.hub.menu('p1', { get title() { throw new Error('bad'); }, sections: [] }), TypeError);
165
+ const mutable = structuredClone(spec); r.hub.menu('p1', mutable); mutable.sections[0].items[0].label = 'Changed'; r.tick(250);
166
+ assert.deepEqual(offer(r).spec, spec); assert(offer(r).n > old.n);
167
+ });
168
+ await test('eligibility and private exact wire: never snapshots, deltas or other players', () => {
169
+ const r = boot({ menu: true }); assert.equal(r.hub.menu('missing', spec), false);
170
+ const waiting = boot({ menu: true }, { hello: false }); assert.equal(waiting.hub.menu('p1', spec), false);
171
+ r.sent.length = 0; assert(r.hub.menu('p1', spec)); assert.deepEqual(wire(r), []); r.tick(250);
172
+ assert.deepEqual(wire(r), [['p1', { k: 'hub-menu', spec, n: 1 }]]);
173
+ assert.equal(JSON.stringify(r.server.join()).includes('Wardrobe'), false);
174
+ assert.equal(JSON.stringify(r.server.delta()).includes('Wardrobe'), false);
175
+ assert.equal(r.server.join().hubPlace.menu, true);
176
+ r.world.players.delete('p1'); assert.equal(r.hub.menu('p1', spec), false);
177
+ });
178
+ await test('place-only API and hook lookup; arrival can offer; disconnected players cannot pick', () => {
179
+ let offered;
180
+ boot({ menu: true }, { hooks: { arrive(ctx, group) { offered = ctx.menu(group[0].playerId, spec); } } });
181
+ assert.equal(offered, true);
182
+ const r = boot({ menu: true, places: { porch: { title: 'Porch', scene: 'scenes/porch.scene' } } });
183
+ const captured = r.hub.menu;
184
+ r.session.place = 'porch'; r.server.sceneFor(r.session);
185
+ assert(!Object.hasOwn(r.hub, 'menu')); assert.throws(() => captured('p1', spec), TypeError);
186
+ Object.defineProperty(r.hooks, 'menu', { get() { throw new Error('keyless hook lookup'); } });
187
+ pick(r, 'close', 'p1', 1);
188
+ const disconnected = boot({ menu: true }); disconnected.hub.menu('p1', spec); disconnected.tick(250);
189
+ disconnected.session.players = [];
190
+ pick(disconnected); assert.deepEqual(disconnected.ops, []); assert.equal(disconnected.hub.menu('p1', spec), false);
191
+ });
192
+ await test('per-player versions, equal resends, changed-back invalidation and four/s coalescing', () => {
193
+ const r = boot({ menu: true });
194
+ r.hub.menu('p1', spec); r.hub.menu('p2', spec); r.tick(250);
195
+ assert.equal(offer(r).n, 1); assert.equal(offer(r, 'p2').n, 1);
196
+ const start = wire(r).length;
197
+ r.hub.menu('p1', structuredClone(spec)); r.tick(250); assert.equal(wire(r).length, start);
198
+ const first = offer(r).n;
199
+ r.hub.menu('p1', { ...spec, title: 'Other' }); r.hub.menu('p1', spec);
200
+ pick(r, 'blue', 'p1', first); assert.deepEqual(r.ops, []);
201
+ r.tick(250); assert.equal(offer(r).n, first + 2);
202
+ r.sent.length = 0;
203
+ for (let i = 0; i < 20; i++) { r.hub.menu('p1', { ...spec, title: `Menu ${i}` }); r.tick(50); }
204
+ assert.equal(wire(r).length, 4); assert.equal(offer(r).spec.title, 'Menu 19');
205
+ const n = offer(r).n; r.hub.menu('p1', null); r.tick(250); assert.deepEqual(offer(r), { k: 'hub-menu', spec: null, n: n + 1 });
206
+ r.sent.length = 0; r.hub.menu('p1', null); r.tick(250); assert.deepEqual(wire(r), []);
207
+ });
208
+ await test('safe-integer exhaustion throws before changing state', () => {
209
+ const h = { place: { menu: true }, session: { players: [{ playerId: 'p' }] }, sim: { players: new Map([['p', {}]]) }, players: new Map([['p', { arrived: true }]]), menuSeq: new Map([['p', Number.MAX_SAFE_INTEGER]]) };
210
+ const before = Reflect.ownKeys(h);
211
+ assert.throws(() => Menu.set(h, 'p', spec), TypeError); assert.deepEqual(Reflect.ownKeys(h), before); assert.equal(h.menuSeq.get('p'), Number.MAX_SAFE_INTEGER);
212
+ });
213
+ await test('current AND sent versions; unknown, stale, malformed and other-player picks drop', () => {
214
+ const r = boot({ menu: true }); r.hub.menu('p1', spec); r.tick(250); const n = offer(r).n;
215
+ pick(r); assert.deepEqual(r.ops, [['p1', 'blue']]);
216
+ pick(r, 'missing'); pick(r, 'blue', 'p2', n); pick(r, 'blue', 'p1', n - 1);
217
+ r.say('p1', { k: 'hub-menu-pick', id: 'blue', n, extra: true });
218
+ r.say('p1', { k: 'hub-menu-pick', id: 'blue', n: '1' });
219
+ r.hub.menu('p1', { ...spec, title: 'New' }); pick(r, 'blue', 'p1', n + 1); pick(r, 'blue', 'p1', n);
220
+ assert.equal(r.ops.length, 1);
221
+ r.tick(1000); pick(r); assert.equal(r.ops.length, 2);
222
+ r.hub.menu('p1', null); r.tick(250); pick(r, 'close'); assert.equal(r.ops.length, 2);
223
+ });
224
+ await test('readOnly refuses item picks but delivers close; picks do not consume a menu', () => {
225
+ const r = boot({ menu: true }); r.hub.menu('p1', { ...spec, readOnly: true }); r.tick(250);
226
+ pick(r); pick(r, 'close'); assert.deepEqual(r.ops, [['p1', 'close']]);
227
+ r.hub.menu('p1', spec); r.tick(1000); pick(r); pick(r); pick(r, 'close');
228
+ assert.deepEqual(r.ops.slice(1), [['p1', 'blue'], ['p1', 'blue'], ['p1', 'close']]);
229
+ });
230
+ await test('six/s burst eight; dropped presses spend tokens; per-player budgets', () => {
231
+ const r = boot({ menu: true }); for (const p of ['p1', 'p2']) r.hub.menu(p, spec); r.tick(250);
232
+ for (let i = 0; i < 10; i++) pick(r); assert.equal(r.ops.length, 8);
233
+ pick(r, 'blue', 'p2'); assert.equal(r.ops.length, 9);
234
+ r.tick(1000); for (let i = 0; i < 8; i++) pick(r); assert.equal(r.ops.length, 15);
235
+ r.tick(1000); for (let i = 0; i < 6; i++) pick(r, 'missing'); pick(r); assert.equal(r.ops.length, 15);
236
+ });
237
+ await test('hello replay once; leave forgets menu and budget, retains per-player version', () => {
238
+ const r = boot({ menu: true }); r.hub.menu('p1', spec); r.tick(250); const n = offer(r).n;
239
+ r.sent.length = 0; r.say('p1', { k: 'hub-hello', resume: true }); r.tick(250);
240
+ assert.deepEqual(wire(r), [['p1', { k: 'hub-menu', spec, n }]]);
241
+ r.sent.length = 0; r.say('p1', { k: 'hub-hello', again: true }); assert.deepEqual(wire(r), []);
242
+ const body = r.world.players.get('p1'); r.session.players = [players[1]]; r.world.players.delete('p1'); r.tick();
243
+ r.session.players.push(players[0]); r.world.players.set('p1', body); r.sent.length = 0;
244
+ r.say('p1', { k: 'hub-hello', resume: true }); r.tick(); assert.deepEqual(wire(r), []);
245
+ r.hub.menu('p1', spec); r.tick(250); assert.equal(offer(r).n, n + 1); pick(r, 'blue', 'p1', n); assert.deepEqual(r.ops, []);
246
+ });
247
+ await test('opted-in unused menu is silent on join/re-hello; only pending closes replay', () => {
248
+ const r = boot({ menu: true }); assert.deepEqual(wire(r), []);
249
+ for (const id of ['p1', 'p2']) r.say(id, { k: 'hub-hello', resume: true });
250
+ r.tick(250); assert.deepEqual(wire(r), []);
251
+ r.hub.menu('p1', spec); r.tick(250); const n = offer(r).n;
252
+ r.hub.menu('p1', null); r.sent.length = 0;
253
+ r.say('p1', { k: 'hub-hello', resume: true });
254
+ assert.deepEqual(wire(r), [['p1', { k: 'hub-menu', spec: null, n: n + 1 }]]);
255
+ r.sent.length = 0; r.say('p1', { k: 'hub-hello', resume: true }); r.tick(250);
256
+ assert.deepEqual(wire(r), []);
257
+ });
258
+ await test('malformed getters, hidden/symbol extras and wide envelopes drop before reading values', () => {
259
+ const r = boot({ menu: true }); r.hub.menu('p1', spec); r.tick(250); const n = offer(r).n;
260
+ const throwing = { k: 'hub-menu-pick', n, get id() { throw new Error('bad getter'); } };
261
+ const hidden = Object.defineProperty({ k: 'hub-menu-pick', id: 'blue', n }, 'extra', { value: 1 });
262
+ const symbol = { k: 'hub-menu-pick', id: 'blue', n, [Symbol('extra')]: true };
263
+ const wide = { k: 'hub-menu-pick', n, get id() { throw new Error('must not read'); }, extra: 1 };
264
+ for (const data of [throwing, hidden, symbol, wide]) { r.say('p1', data); }
265
+ assert.deepEqual(r.ops, []); pick(r); assert.deepEqual(r.ops, [['p1', 'blue']]);
266
+ });
267
+ await test('async hooks overlap, survive leave, and throwing/rejected hooks contained once', async () => {
268
+ let resolve, calls = 0; const pending = new Promise((done) => { resolve = done; });
269
+ const r = boot({ menu: true }, { hooks: { menu() { calls++; return pending; } } });
270
+ r.hub.menu('p1', spec); r.tick(250); pick(r); pick(r); assert.equal(calls, 2);
271
+ r.session.players = []; r.world.players.clear(); r.tick(); resolve(); await pending;
272
+ const warnings = [], warn = console.warn; console.warn = (...args) => warnings.push(args.join(' '));
273
+ try {
274
+ let attempts = 0;
275
+ const bad = boot({ menu: true }, { hooks: { menu() { if (++attempts === 1) throw new Error('bad'); return Promise.reject(new Error('bad')); } } });
276
+ bad.hub.menu('p1', spec); bad.tick(250); pick(bad); pick(bad);
277
+ await new Promise((done) => setImmediate(done)); assert.deepEqual(warnings, ['[hub] menu hook failed']);
278
+ } finally { console.warn = warn; }
279
+ });
280
+ await test('keys absent: byte-identical snapshots/deltas/wire, no API, hook lookup or private state', () => {
281
+ function trace(inject) {
282
+ const r = boot(); Object.defineProperty(r.hooks, 'menu', { get() { throw new Error('keyless hook lookup'); } });
283
+ assert(!Object.hasOwn(r.hub, 'menu')); const snapshots = [], deltas = [];
284
+ for (let i = 0; i < 4; i++) {
285
+ if (inject) pick(r, 'blue', 'p1', 1);
286
+ r.tick(250); snapshots.push(JSON.stringify(r.server.join())); deltas.push(JSON.stringify(r.server.delta()));
287
+ }
288
+ assert.deepEqual(wire(r), []); assert.deepEqual(r.ops, []);
289
+ assert(snapshots.every((s) => !s.includes('"menu"'))); assert(deltas.every((s) => !s?.includes('"menu"')));
290
+ return JSON.stringify([r.sent, snapshots, deltas]);
291
+ }
292
+ assert.equal(trace(true), trace(false));
293
+ const h = { place: {}, session: { players: [{ playerId: 'p' }] }, sim: { players: new Map([['p', {}]]) } }, keys = Reflect.ownKeys(h);
294
+ Menu.message(h, 'p', { k: 'hub-menu-pick', id: 'blue', n: 1 }); assert.deepEqual(Reflect.ownKeys(h), keys);
295
+ });
296
+ console.log(`${passed} menu server tests passed`);