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,585 @@
1
+ // v1.79 menu chrome, private picks, input locks and cleanup.
2
+ import assert from 'node:assert/strict';
3
+ import { setMaxListeners } from 'node:events';
4
+ import { register } from 'node:module';
5
+
6
+ register(`data:text/javascript,${encodeURIComponent(`
7
+ import { readFile } from 'node:fs/promises';
8
+ import { fileURLToPath } from 'node:url';
9
+ export async function resolve(specifier, context, next) {
10
+ 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 };
11
+ 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 };
12
+ if (specifier === 'castle-web-sdk') return { url: 'data:text/javascript,export const Hub = { onBack(fn) { globalThis.__menuTestHostBack = fn; } };', shortCircuit: true };
13
+ if (specifier === '@imports/castle.multiplayer-3d/code/client/avatars.js') return { url: 'data:text/javascript,export const dropMissing = () => {};', shortCircuit: true };
14
+ if (specifier === '@imports/castle.real-time/code/client/messages.js') return { url: ${JSON.stringify(new URL('../../real-time/code/client/messages.js', import.meta.url).href)}, shortCircuit: true };
15
+ if (specifier.startsWith('@imports/castle.physics-2d/engine/')) return { url: 'data:text/javascript,export const initialMedia = {}; export const playMedia = () => {}; export const stopMedia = () => {};', shortCircuit: true };
16
+ if (specifier === '../client/pack.js') return { url: 'data:text/javascript,export const cachedPacks = () => []; export const loadPack = () => {}; export const matchesOwn = () => false; export const resolveDeckDoor = () => {};', shortCircuit: true };
17
+ return next(specifier, context);
18
+ }
19
+ export async function load(url, context, next) {
20
+ if (url.endsWith('/behaviors/Player.jsx')) {
21
+ return { format: 'module', source: await readFile(fileURLToPath(url), 'utf8'), shortCircuit: true };
22
+ }
23
+ if (url.endsWith('/code/client/hookLayer.js')) {
24
+ const source = await readFile(fileURLToPath(url), 'utf8');
25
+ return { format: 'module', source: source.replaceAll('import.meta.glob(', '(() => ({}))('), shortCircuit: true };
26
+ }
27
+ return next(url, context);
28
+ }
29
+ `)}`);
30
+ const { EARNED_SHAPES } = await import('../code/client/earned.js');
31
+ const { HATS } = await import('../code/client/hats.js');
32
+ const State = await import('../code/client/state.js');
33
+ const hook = (await import('../code/client/hookLayer.js')).default;
34
+ const { installSystem } = await import('../code/systems/hub.js');
35
+ const { makeChrome } = await import('../code/client/chrome.js');
36
+ const Ballot = await import('../code/client/ballot.js');
37
+ const { Player } = await import('../../physics-3d/behaviors/Player.jsx');
38
+ const { packMove } = await import('../../multiplayer-3d/code/client/poses.js');
39
+ function fakeDom(view) {
40
+ const log = [];
41
+ let ids = 0;
42
+ const made = [];
43
+ function node(tag) {
44
+ const id = `${tag}#${(ids += 1)}`;
45
+ const styles = {};
46
+ let text = '';
47
+ const self = {
48
+ id,
49
+ tag,
50
+ children: [],
51
+ parent: null,
52
+ dataset: {},
53
+ attrs: {},
54
+ rect: null,
55
+ size: null,
56
+ style: new Proxy(styles, {
57
+ get: (target, key) => target[key] ?? '',
58
+ set(target, key, value) {
59
+ target[key] = String(value);
60
+ log.push(`${id} style.${String(key)}=${value}`);
61
+ return true;
62
+ },
63
+ }),
64
+ styles,
65
+ get textContent() {
66
+ return text;
67
+ },
68
+ set textContent(value) {
69
+ text = String(value);
70
+ log.push(`${id} text=${text}`);
71
+ },
72
+ appendChild(child) {
73
+ child.parent = self;
74
+ self.children.push(child);
75
+ log.push(`${id} +${child.id}`);
76
+ return child;
77
+ },
78
+ append(...kids) {
79
+ kids.forEach((kid) => self.appendChild(kid));
80
+ },
81
+ insertBefore(child, before) {
82
+ if (child.parent) {
83
+ child.parent.children = child.parent.children.filter((c) => c !== child);
84
+ }
85
+ child.parent = self;
86
+ const at = self.children.indexOf(before);
87
+ self.children.splice(at < 0 ? self.children.length : at, 0, child);
88
+ return child;
89
+ },
90
+ remove() {
91
+ if (self.parent) {
92
+ self.parent.children = self.parent.children.filter((c) => c !== self);
93
+ log.push(`${id} removed`);
94
+ }
95
+ },
96
+ replaceChildren(...kids) {
97
+ self.children = [];
98
+ log.push(`${id} emptied`);
99
+ kids.forEach((kid) => self.appendChild(kid));
100
+ },
101
+ handlers: {},
102
+ addEventListener(type, fn, options) {
103
+ self.handlers[type] = fn;
104
+ if (options?.signal) {
105
+ setMaxListeners(0, options.signal);
106
+ options.signal.addEventListener('abort', () => { delete self.handlers[type]; }, { once: true });
107
+ }
108
+ },
109
+ removeEventListener() {},
110
+ setAttribute(key, value) {
111
+ self.attrs[key] = String(value);
112
+ },
113
+ getAttribute: (key) => self.attrs[key] ?? null,
114
+ focus() { document.activeElement = self; },
115
+ blur() { if (document.activeElement === self) document.activeElement = null; },
116
+ // A stand-in layout: 7 px a character and 20 of padding, one 24 px line.
117
+ get offsetWidth() {
118
+ log.push(`${id} read`);
119
+ return (typeof self.size === 'function' ? self.size(self) : self.size)?.w ?? text.length * 7 + 20;
120
+ },
121
+ get offsetHeight() {
122
+ log.push(`${id} read`);
123
+ return (typeof self.size === 'function' ? self.size(self) : self.size)?.h ?? 24;
124
+ },
125
+ get offsetLeft() {
126
+ return parseFloat(styles.left) || 0;
127
+ },
128
+ get clientWidth() {
129
+ return self.client ?? self.offsetWidth;
130
+ },
131
+ get scrollWidth() {
132
+ return self.scroll ?? self.offsetWidth;
133
+ },
134
+ getBoundingClientRect() {
135
+ let r = self.rect ?? { left: 0, right: 0, top: 0, bottom: 0 };
136
+ if (styles.flexDirection === 'column-reverse') {
137
+ const height = self.children.length * 44 + (self.children.length - 1) * 6;
138
+ const bottom = styles.bottom.startsWith('max') ? 132 : parseFloat(styles.bottom);
139
+ r = { left: view.viewW - 162, right: view.viewW - 12, top: view.viewH - bottom - height, bottom: view.viewH - bottom };
140
+ }
141
+ return { ...r, width: r.right - r.left, height: r.bottom - r.top };
142
+ },
143
+ };
144
+ made.push(self);
145
+ return self;
146
+ }
147
+ const body = node('body');
148
+ globalThis.document = { body, createElement: node, activeElement: null };
149
+ globalThis.window = { innerWidth: view.viewW, innerHeight: view.viewH };
150
+ globalThis.innerWidth = view.viewW;
151
+ return { log, body, made };
152
+ }
153
+ const spec = { title: 'Wardrobe', note: 'Pick a colour', sections: [{ title: 'Colours', items: [{ id: 'blue', label: 'Blue', color: '#123abc', on: true }, { id: 'red', label: 'Red', color: '#ab1234', icon: 'badge-star' }] }, { title: 'Hats', items: [{ id: 'cap', label: 'Cap', icon: 'cap' }] }, { title: 'Empty', items: [] }] };
154
+ const offer = { spec, n: 1 };
155
+ const find = (dom, text) => dom.made.findLast((node) => node.textContent === text);
156
+ const tile = (dom, id) => dom.made.findLast((node) => node.dataset.id === id);
157
+ const sheet = (dom) => dom.made.findLast((node) => node.dataset.hub === 'menu');
158
+ const tap = (node) => node.handlers.click?.({ stopPropagation() {} });
159
+ let passed = 0;
160
+ function test(name, fn) { fn(); passed++; console.log(`ok: ${name}`); }
161
+ function rig() {
162
+ const dom = fakeDom({ viewW: 360, viewH: 780 }), sent = [], locks = [];
163
+ const chrome = makeChrome({ avatarCount: 4, onBack() {}, onAvatar() {} });
164
+ const draw = (value = offer) => chrome.setMenu(value, (id, n) => sent.push({ k: 'hub-menu-pick', id, n }), (open) => locks.push(open));
165
+ return { dom, sent, locks, chrome, draw };
166
+ }
167
+ function systemRig() {
168
+ State.clear(); Ballot.forget(); const dom = fakeDom({ viewW: 360, viewH: 780 });
169
+ let system; installSystem({ registerSystem(value) { system = value; } });
170
+ const calls = [], sent = [];
171
+ const chrome = makeChrome({ avatarCount: 4, onBack() {}, onAvatar() {} });
172
+ system.chrome = new Proxy(chrome, { get(target, name) {
173
+ if (['setMenu', 'clearMenu'].includes(name)) return (...args) => { calls.push([name, ...args]); return target[name](...args); };
174
+ return target[name];
175
+ } });
176
+ system.talk = { frame() {}, talking: () => false, typing: () => false, talkingWith: () => null };
177
+ system.idle = { frame() {}, draw() {}, labels: () => [] }; system.grab = { frame() {} }; system.sound = { frame() {} }; system.sayHooked = true;
178
+ system.together.frame = () => {};
179
+ for (const method of ['keepResident', 'wearAvatar', 'applyTune', 'watchSession', 'sayHello', 'followPlace', 'holdFall', 'turnSpinners', 'applySpawns', 'applyTints', 'registerInterest', 'applyVisibility', 'applyWear', 'adoptLate', 'runCommands', 'askFriends', 'stepEnd', 'faceArrival', 'measure', 'drawChrome']) system[method] = () => {};
180
+ system.sceneKey = 'main'; let locks = 0;
181
+ const scene = { sceneKey: 'main', currentScenePath: 'scenes/main.scene', multiplayer: { net: { selfId: () => 'p1', send: (msg) => sent.push(msg) } }, actorWith: () => null, persistent: { hubTickets: [], hubAvatar: 0 }, getActors: () => [], moveInput: { active: true, x: 1, y: 1 }, keys: { clear() {} }, cameraControl: 'orbit', lookInput: { lock() { locks += 1; } } };
182
+ return { system, scene, dom, sent, calls, chrome, locks: () => locks, frame: () => system.afterBehaviors(scene, 0.05) };
183
+ }
184
+ function facingRig() {
185
+ const r = systemRig(), player = { id: 'local', runtime: { facing: 0.3 }, components: { Player: Player.defaultProps, Transform: { x: 0, y: 1, z: 0, rotationY: 0.3 * 180 / Math.PI } } };
186
+ const behavior = new Player(Player.defaultProps);
187
+ r.scene.actorWith = () => player;
188
+ r.scene.actorsWith = () => [];
189
+ r.scene.keys.has = () => false;
190
+ r.scene.physics3d = { ready: () => true, castRay: () => ({ distance: 0.85 }), mass: () => 1, getVelocity: () => ({ x: 0, y: 0, z: 0 }), addForce() {}, applyImpulse() {} };
191
+ r.scene.persistent.camAngle = 0.7;
192
+ r.scene.update = () => { behavior.update(player, r.scene, 0.05); r.frame(); };
193
+ return { ...r, player, face: () => player.components.Transform.rotationY };
194
+ }
195
+ test('buffer before WORLD, opt-in only, stale versions ignored, place change clears private state', () => {
196
+ State.clear(); assert(!Object.hasOwn(State.hub, 'menu'));
197
+ hook.message({}, { k: 'hub-menu', ...offer }); assert.deepEqual(State.hub.menu, offer);
198
+ hook.state({}, { hubPlace: { id: 'main', menu: true } }); assert.deepEqual(State.hub.menu, offer);
199
+ hook.message({}, { k: 'hub-menu', spec: null, n: 2 });
200
+ hook.message({}, { k: 'hub-menu', ...offer }); assert.deepEqual(State.hub.menu, { spec: null, n: 2 });
201
+ hook.message({}, { k: 'hub-menu', spec, n: 3 });
202
+ hook.state({}, { hubPlace: { id: 'other', menu: true } }); assert(!Object.hasOwn(State.hub, 'menu'));
203
+ hook.state({}, { hubPlace: { id: 'plain' } }); hook.message({}, { k: 'hub-menu', ...offer }); assert(!Object.hasOwn(State.hub, 'menu'));
204
+ State.clear();
205
+ });
206
+ test('lazy sheet, sections including empty sections, square phone touch tiles, scroll, note and selection', () => {
207
+ const r = rig(), count = r.dom.made.length; r.draw(null); assert.equal(r.dom.made.length, count); assert.deepEqual(r.locks, []);
208
+ r.draw(); const card = sheet(r.dom), blue = tile(r.dom, 'blue'), red = tile(r.dom, 'red');
209
+ assert.equal(card.attrs.role, 'dialog'); assert.equal(card.attrs['aria-label'], 'Wardrobe'); assert.equal(card.style.maxHeight, '55vh');
210
+ assert.equal(card.style.bottom, '0'); assert.equal(card.style.pointerEvents, 'auto');
211
+ assert(card.style.background.startsWith('var(--castle-surface-'));
212
+ for (const text of ['Wardrobe', 'Pick a colour', 'Colours', 'Hats', 'Empty', 'Blue', 'Red', 'Cap', '✓']) assert(find(r.dom, text));
213
+ assert.equal(blue.style.aspectRatio, '1'); assert.equal(blue.style.minHeight, '64px'); assert.equal(blue.style.minWidth, '64px');
214
+ assert.equal(blue.parent.style.gridTemplateColumns, 'repeat(auto-fill, minmax(64px, 1fr))');
215
+ assert.equal(blue.parent.parent.style.overflowY, 'auto'); assert.equal(blue.parent.parent.style.overscrollBehavior, 'contain');
216
+ assert.equal(blue.attrs['aria-pressed'], 'true'); assert.equal(red.attrs['aria-pressed'], 'false'); assert(blue.style.outline.includes('2px'));
217
+ assert(red.children.some((node) => node.style.maskImage.includes('data:image/svg+xml')));
218
+ assert(tile(r.dom, 'cap').children.some((node) => node.style.maskImage.includes('data:image/svg+xml')));
219
+ const css = card.children.find((node) => node.tag === 'style').textContent;
220
+ assert(css.includes('prefers-reduced-motion'));
221
+ assert(css.includes('repeat(4, minmax(64px, 1fr))'));
222
+ assert(css.includes('repeat(3, minmax(64px, 1fr))'));
223
+ assert.deepEqual(r.locks, [true]); r.chrome.dispose(); assert.deepEqual(r.locks, [true, false]);
224
+ });
225
+ test('face caps the sheet at 40 percent, absent face preserves CSS and replacements restore either cap', () => {
226
+ const r = rig();
227
+ const cssBefore = `
228
+ .hub-menu-tile { color: inherit; font: inherit; border: 1px solid var(--castle-border-2, rgba(255,255,255,.4)); background: var(--castle-surface-4, rgba(255,255,255,.1)); border-radius: 8px; }
229
+ .hub-menu-tile:not(:disabled) { cursor: pointer; }
230
+ .hub-menu-tile:not(:disabled):active, .hub-menu-tile.is-pressed { background: var(--castle-surface-5, rgba(255,255,255,.18)); transform: scale(.96); }
231
+ @media (hover: hover) { .hub-menu-tile:not(:disabled):hover { border-color: var(--castle-text-primary, #fff); } }
232
+ @media (prefers-reduced-motion: reduce) { .hub-menu-tile:not(:disabled):active, .hub-menu-tile.is-pressed { transform: none; } }
233
+ @media (max-width: 600px) { .hub-menu-grid { grid-template-columns: repeat(4, minmax(64px, 1fr)) !important; } }
234
+ @media (max-width: 340px) { .hub-menu-grid { grid-template-columns: repeat(3, minmax(64px, 1fr)) !important; } }
235
+ @supports (height: 1dvh) { .hub-menu-sheet { max-height: 55dvh !important; } }
236
+ `;
237
+ r.draw(); const stylesBefore = { ...sheet(r.dom).styles };
238
+ for (const [i, value] of [spec, { ...spec, face: 0 }, spec, { ...spec, face: 90 }].entries()) {
239
+ r.draw({ n: i + 2, spec: value });
240
+ const card = sheet(r.dom), hasFace = Object.hasOwn(value, 'face');
241
+ assert.deepEqual(card.styles, { ...stylesBefore, maxHeight: hasFace ? '40vh' : '55vh' });
242
+ assert.equal(card.children.find((node) => node.tag === 'style').textContent, hasFace ? cssBefore.replace('55dvh', '40dvh') : cssBefore);
243
+ const scroll = tile(r.dom, 'blue').parent.parent;
244
+ assert.equal(scroll.style.overflowY, 'auto'); assert.equal(scroll.style.minHeight, '0');
245
+ assert.equal(scroll.style.overscrollBehavior, 'contain'); assert.equal(scroll.style.touchAction, 'pan-y');
246
+ }
247
+ r.chrome.dispose();
248
+ });
249
+ test('on rings draw independently in different sections', () => {
250
+ const r = rig();
251
+ r.draw({ n: 1, spec: { title: 'Menu', sections: ['one', 'two'].map((id) => ({ title: id, items: [{ id, label: id, on: true }] })) } });
252
+ for (const id of ['one', 'two']) {
253
+ assert.equal(tile(r.dom, id).attrs['aria-pressed'], 'true');
254
+ assert(tile(r.dom, id).style.outline.includes('2px'));
255
+ }
256
+ r.chrome.dispose();
257
+ });
258
+ test('every existing earned shape and hat id has an icon silhouette', () => {
259
+ const r = rig();
260
+ const icons = [...EARNED_SHAPES, ...HATS];
261
+ r.draw({ n: 1, spec: { title: 'Icons', sections: [{ title: 'All', items: icons.map((icon, i) => ({ id: `a${i}`, label: icon.slice(0, 16), icon })) }] } });
262
+ for (let i = 0; i < icons.length; i++) assert(tile(r.dom, `a${i}`).children.some((node) => node.style.maskImage.includes('data:image/svg+xml')));
263
+ r.chrome.dispose();
264
+ });
265
+ test('tap sends id/version with instant feedback; selection remains server truth; no focus stealing', () => {
266
+ const r = rig(), canvas = r.dom.body; canvas.focus(); r.draw(); assert.equal(document.activeElement, canvas);
267
+ const red = tile(r.dom, 'red'); let prevented = false;
268
+ red.handlers.pointerdown({ preventDefault() { prevented = true; } }); assert(prevented); assert.equal(document.activeElement, canvas);
269
+ tap(red); assert.deepEqual(r.sent, [{ k: 'hub-menu-pick', id: 'red', n: 1 }]);
270
+ assert.equal(red.className, 'hub-menu-tile is-pressed'); assert.equal(red.attrs['aria-pressed'], 'false'); assert.equal(tile(r.dom, 'blue').attrs['aria-pressed'], 'true');
271
+ const count = r.dom.made.length; r.draw(); assert.equal(r.dom.made.length, count); assert(r.chrome.menuOpen()); r.chrome.dispose();
272
+ });
273
+ test('readOnly tiles have no pick listeners/affordance; Close still works', () => {
274
+ const r = rig(); r.draw({ spec: { ...spec, readOnly: true }, n: 1 });
275
+ const blue = tile(r.dom, 'blue'); assert.equal(blue.disabled, true); assert(!blue.handlers.click); assert(!blue.handlers.pointerdown); tap(blue); assert.deepEqual(r.sent, []);
276
+ assert(sheet(r.dom).children.find((n) => n.tag === 'style').textContent.includes(':not(:disabled):hover'));
277
+ tap(find(r.dom, '×')); assert.deepEqual(r.sent, [{ k: 'hub-menu-pick', id: 'close', n: 1 }]); assert(!r.chrome.menuOpen()); r.chrome.dispose();
278
+ });
279
+ test('Close sends once, aborts old listeners, releases lock and same/stale n cannot reopen', () => {
280
+ const r = rig(); r.draw(); const old = sheet(r.dom), close = find(r.dom, '×'); tap(close); tap(close);
281
+ assert.deepEqual(r.sent, [{ k: 'hub-menu-pick', id: 'close', n: 1 }]); assert.deepEqual(r.locks, [true, false]);
282
+ assert(!old.parent.children.includes(old)); assert.deepEqual(close.handlers, {}); assert.deepEqual(tile(r.dom, 'red').handlers, {});
283
+ r.draw(); r.draw({ spec, n: 0 }); assert(!r.chrome.menuOpen()); r.draw({ spec, n: 2 }); assert(r.chrome.menuOpen()); r.chrome.dispose();
284
+ });
285
+ test('new spec replaces all tiles; null removes sheet, silent disposal/clear, keyless draw creates nothing', () => {
286
+ const r = rig(); r.draw(); const old = sheet(r.dom), oldBlue = tile(r.dom, 'blue');
287
+ r.draw({ spec: { title: 'Other', sections: [{ title: 'New', items: [{ id: 'green', label: 'Green' }] }] }, n: 2 });
288
+ assert(!old.parent.children.includes(old)); assert.deepEqual(oldBlue.handlers, {}); assert(tile(r.dom, 'green')); assert.equal(sheet(r.dom).attrs['aria-label'], 'Other');
289
+ r.draw({ spec: null, n: 3 }); assert(!r.chrome.menuOpen()); assert.deepEqual(r.sent, []);
290
+ r.draw({ spec, n: 2 }); assert(!r.chrome.menuOpen()); r.draw({ spec, n: 4 }); r.chrome.clearMenu(); assert(!r.chrome.menuOpen());
291
+ r.draw(); r.chrome.dispose(); assert.deepEqual(r.sent, []); assert.deepEqual(r.locks, [true, false, true, false, true, false, true, false]);
292
+ });
293
+ test('Escape and browser Back close and send current n; capture listeners removed', () => {
294
+ const add = globalThis.addEventListener, remove = globalThis.removeEventListener;
295
+ const listeners = [];
296
+ globalThis.addEventListener = (type, fn, options) => {
297
+ const entry = { type, fn, options }; listeners.push(entry);
298
+ options?.signal?.addEventListener('abort', () => { const at = listeners.indexOf(entry); if (at >= 0) listeners.splice(at, 1); }, { once: true });
299
+ };
300
+ globalThis.removeEventListener = (type, fn) => { const at = listeners.findIndex((l) => l.type === type && l.fn === fn); if (at >= 0) listeners.splice(at, 1); };
301
+ try {
302
+ for (const key of ['Escape', 'BrowserBack']) {
303
+ const r = rig(); r.draw(); const listener = listeners.find((l) => l.type === 'keydown' && l.options?.capture);
304
+ let stopped = false, prevented = false;
305
+ listener.fn({ key, preventDefault() { prevented = true; }, stopImmediatePropagation() { stopped = true; } });
306
+ assert(stopped && prevented); assert.deepEqual(r.sent, [{ k: 'hub-menu-pick', id: 'close', n: 1 }]); assert(!r.chrome.menuOpen());
307
+ assert(!listeners.some((l) => l.options?.capture)); r.chrome.dispose();
308
+ }
309
+ } finally { globalThis.addEventListener = add; globalThis.removeEventListener = remove; }
310
+ });
311
+ test('frame holds walking/jumps/orbit before player update; restores update/inputs on Close', () => {
312
+ const r = systemRig(), reads = [];
313
+ let jumped = true; r.scene.moveInput.consumeJump = () => { const old = jumped; jumped = false; return old; };
314
+ const player = { runtime: { jumpBuffer: 1 } }; r.scene.actorWith = () => player;
315
+ const update = () => reads.push([r.scene.moveInput.active, r.scene.moveInput.x, jumped, player.runtime.jumpBuffer]); r.scene.update = update;
316
+ r.frame(); assert.deepEqual(r.calls, []); assert.equal(r.scene.moveInput.active, true);
317
+ hook.state({}, { hubPlace: { id: 'main', menu: true } }); hook.message({}, { k: 'hub-menu', ...offer }); r.frame();
318
+ assert.equal(r.scene.moveInput.active, false); assert.equal(r.scene.moveInput.x, 0); assert(r.locks() > 0); assert(Object.hasOwn(r.system, 'menuInput'));
319
+ r.scene.moveInput.active = true; r.scene.moveInput.x = 1; jumped = true; player.runtime.jumpBuffer = 1;
320
+ r.scene.update(); assert.deepEqual(reads, [[false, 0, false, 0]]);
321
+ tap(find(r.dom, '×')); assert.equal(r.scene.update, update); assert.equal(r.scene.moveInput.active, true); assert(!Object.hasOwn(r.system, 'menuInput'));
322
+ assert.deepEqual(r.sent, [{ k: 'hub-menu-pick', id: 'close', n: 1 }]); r.chrome.dispose(); State.clear();
323
+ });
324
+ test('face turns the local Player each frame, preserves orbit yaw and follows replacements', () => {
325
+ const r = facingRig(); hook.state({}, { hubPlace: { id: 'main', menu: true } });
326
+ hook.message({}, { k: 'hub-menu', spec: { ...spec, face: 90 }, n: 1 }); r.frame();
327
+ assert.equal(r.face(), 90); assert.equal(r.player.runtime.facing, Math.PI / 2); assert.equal(r.scene.persistent.camAngle, 0.7);
328
+ assert.deepEqual(packMove(r.player.components.Transform), [0, 1, 0, 1.571]);
329
+ for (let i = 0; i < 3; i++) {
330
+ r.player.runtime.facing = -1; r.player.components.Transform.rotationY = -30;
331
+ r.scene.moveInput.active = true; r.scene.moveInput.x = 1;
332
+ r.scene.update(); assert.equal(r.face(), 90); assert.equal(r.player.runtime.facing, Math.PI / 2);
333
+ }
334
+ hook.message({}, { k: 'hub-menu', spec: { ...spec, face: -45 }, n: 2 }); r.scene.update();
335
+ assert.equal(r.face(), -45); assert.equal(r.player.runtime.facing, -Math.PI / 4);
336
+ hook.message({}, { k: 'hub-menu', spec: { ...spec, face: 0 }, n: 3 }); r.scene.update(); assert.equal(r.face(), 0);
337
+ r.chrome.dispose(); State.clear();
338
+ });
339
+ test('face releases on local/server close, replacement without face, leave and reset', () => {
340
+ for (const release of ['local', 'null', 'replace', 'leave', 'place', 'reset']) {
341
+ const r = facingRig(); hook.state({}, { hubPlace: { id: 'main', menu: true } });
342
+ hook.message({}, { k: 'hub-menu', spec: { ...spec, face: 90 }, n: 1 }); r.frame(); assert.equal(r.face(), 90);
343
+ if (release === 'local') tap(find(r.dom, '×'));
344
+ if (release === 'null') { hook.message({}, { k: 'hub-menu', spec: null, n: 2 }); r.frame(); }
345
+ if (release === 'replace') { hook.message({}, { k: 'hub-menu', spec, n: 2 }); r.frame(); }
346
+ if (release === 'leave') State.clear();
347
+ if (release === 'place') hook.state({}, { hubPlace: { id: 'plain' } });
348
+ if (release === 'reset') r.system.reset();
349
+ assert.equal(r.face(), 90); assert.equal(r.chrome.menuFace(), undefined);
350
+ r.scene.moveInput.active = false; r.scene.update(); assert.equal(r.face(), 90, `${release}: standing retains facing`);
351
+ r.player.runtime.facing = -0.5; r.player.components.Transform.rotationY = -0.5 * 180 / Math.PI;
352
+ r.scene.update(); assert.equal(r.player.runtime.facing, -0.5, `${release}: no residual override`);
353
+ if (release !== 'replace') {
354
+ r.scene.moveInput.active = true; r.scene.moveInput.x = 1; r.scene.moveInput.y = 0;
355
+ r.scene.update(); assert.notEqual(r.player.runtime.facing, -0.5, `${release}: walking controls facing`);
356
+ }
357
+ r.chrome.dispose(); State.clear();
358
+ }
359
+ });
360
+ test('face is applied only while the menu sheet wins over ask, conversation, ballot, decor and travel', () => {
361
+ for (const ui of ['ask', 'talk', 'ballot', 'decor', 'travel', 'end']) {
362
+ const r = facingRig(); hook.state({}, { hubPlace: { id: 'main', menu: true, ask: true, decor: {}, ballot: { lines: [] } } });
363
+ r.system.decor = { frame() {}, opened: () => false, dispose() {} };
364
+ r.system.ballot = { frame() {}, dispose() {} };
365
+ hook.message({}, { k: 'hub-menu', spec: { ...spec, face: 90 }, n: 1 }); r.frame(); assert.equal(r.face(), 90);
366
+ if (ui === 'ask') hook.message({}, { k: 'hub-ask', id: 'name', title: 'Name', max: 16, n: 1 });
367
+ if (ui === 'talk') r.system.talk.talking = () => true;
368
+ if (ui === 'ballot') hook.message(r.scene, { k: 'hub-ballot-card', card: { v: 'v1', mode: 'vote', faces: [], lines: [], who: {}, options: [] } });
369
+ if (ui === 'decor') r.system.decor.opened = () => true;
370
+ if (ui === 'travel') { r.system.trip = {}; r.system.stepTrip = () => {}; }
371
+ if (ui === 'end') r.system.pendingEnd = {};
372
+ r.player.runtime.facing = -0.5; r.player.components.Transform.rotationY = -30; r.frame();
373
+ assert(!r.chrome.menuOpen(), ui); assert.equal(r.player.runtime.facing, -0.5, ui); assert.equal(r.face(), -30, ui);
374
+ r.chrome.dispose(); State.clear(); Ballot.forget();
375
+ }
376
+ });
377
+ test('held and seated players retain their facing while a menu with face is open', () => {
378
+ for (const state of ['held', 'seated', 'both']) {
379
+ const r = facingRig(); hook.state({}, { hubPlace: { id: 'main', menu: true } });
380
+ const block = () => hook.state({}, { held: state === 'seated' ? [] : ['p1'], hubSeated: state === 'held' ? {} : { p1: 'bench' } });
381
+ block();
382
+ hook.message({}, { k: 'hub-menu', spec: { ...spec, face: 90 }, n: 1 }); r.frame();
383
+ assert(r.chrome.menuOpen()); assert.equal(r.player.runtime.facing, 0.3, state);
384
+ assert.deepEqual(packMove(r.player.components.Transform), [0, 1, 0, 0.3], state);
385
+ r.scene.update(); assert.equal(r.player.runtime.facing, 0.3, state); assert.equal(r.scene.persistent.camAngle, 0.7);
386
+ hook.state({}, { held: [], hubSeated: {} }); r.scene.update(); assert.equal(r.face(), 90);
387
+ block(); r.player.runtime.facing = -0.5; r.player.components.Transform.rotationY = -0.5 * 180 / Math.PI;
388
+ r.scene.update(); assert.equal(r.player.runtime.facing, -0.5, `${state}: an open menu yields immediately`);
389
+ assert.deepEqual(packMove(r.player.components.Transform), [0, 1, 0, -0.5]);
390
+ assert.equal(r.scene.persistent.camAngle, 0.7);
391
+ r.chrome.dispose(); State.clear();
392
+ }
393
+ });
394
+ test('menu without face never reads menuFace or alters yaw', () => {
395
+ const r = facingRig(); hook.state({}, { hubPlace: { id: 'main', menu: true } });
396
+ r.system.chrome = new Proxy(r.system.chrome, { get(target, name) { if (name === 'menuFace') assert.fail('absent face lookup'); return target[name]; } });
397
+ hook.message({}, { k: 'hub-menu', ...offer }); r.frame();
398
+ assert.equal(r.player.runtime.facing, 0.3); assert.equal(r.scene.persistent.camAngle, 0.7);
399
+ r.chrome.dispose(); State.clear();
400
+ });
401
+ test('follow camera ignores face without changing camAngle, including a stale orbit shot', () => {
402
+ for (const staleShot of [false, true]) {
403
+ const r = facingRig(); r.scene.cameraControl = undefined;
404
+ if (staleShot) r.scene.orbitShot = { look: { x: 0, y: 1, z: 0 }, distance: 2.6, pitch: 12, yaw: 60 };
405
+ hook.state({}, { hubPlace: { id: 'main', menu: true } });
406
+ hook.message({}, { k: 'hub-menu', spec: { ...spec, face: -90 }, n: 1 }); r.frame();
407
+ assert(r.chrome.menuOpen()); assert.equal(r.player.runtime.facing, 0.3); assert.equal(r.scene.persistent.camAngle, 0.7);
408
+ r.scene.update(); assert.equal(r.player.runtime.facing, Math.PI - 0.7); assert.equal(r.scene.persistent.camAngle, 0.7);
409
+ const yaw = r.face();
410
+ tap(find(r.dom, '×')); r.scene.moveInput.active = false; r.scene.update();
411
+ assert.equal(r.face(), yaw); assert.equal(r.scene.persistent.camAngle, 0.7);
412
+ r.chrome.dispose(); State.clear();
413
+ }
414
+ });
415
+ test('face applies under a held orbit shot without changing camera yaw', () => {
416
+ const r = facingRig(); hook.state({}, { hubPlace: { id: 'main', menu: true } });
417
+ const shot = { look: { x: 0, y: 1, z: 0 }, distance: 2.6, pitch: 12, yaw: 60 };
418
+ hook.message(r.scene, { k: 'hub-shot', shot }); assert.deepEqual(r.scene.orbitShot, shot);
419
+ hook.message({}, { k: 'hub-menu', spec: { ...spec, face: -60 }, n: 1 }); r.frame();
420
+ assert.equal(r.face(), -60); assert.equal(r.scene.persistent.camAngle, 0.7); assert.deepEqual(r.scene.orbitShot, shot);
421
+ r.scene.update(); assert.equal(r.face(), -60); assert.equal(r.scene.persistent.camAngle, 0.7); assert.deepEqual(r.scene.orbitShot, shot);
422
+ tap(find(r.dom, '×')); r.scene.moveInput.active = false; r.scene.update(); assert(Math.abs(r.face() + 60) < 1e-10);
423
+ r.chrome.dispose(); State.clear(); assert.equal(r.scene.orbitShot, undefined);
424
+ });
425
+ test('kit/host Back first closes menu with current n, subsequent Back travels normally', () => {
426
+ const r = systemRig(); let back = 0; r.system.back = () => { back++; };
427
+ hook.state({}, { hubPlace: { id: 'main', menu: true } }); hook.message({}, { k: 'hub-menu', ...offer }); r.frame();
428
+ globalThis.__menuTestHostBack();
429
+ assert.equal(back, 0); assert.deepEqual(r.sent, [{ k: 'hub-menu-pick', id: 'close', n: 1 }]);
430
+ assert.equal(r.scene.moveInput.active, true); r.system.backFromControl(r.scene); assert.equal(back, 1);
431
+ hook.message({}, { k: 'hub-menu', spec, n: 2 }); r.frame(); r.system.backFromControl(r.scene);
432
+ assert.equal(back, 1); assert.deepEqual(r.sent.at(-1), { k: 'hub-menu-pick', id: 'close', n: 2 });
433
+ r.chrome.dispose(); State.clear(); delete globalThis.__menuTestHostBack;
434
+ });
435
+ test('null, rehello, place change, state clear, scene reset and disposal release locks', () => {
436
+ const r = systemRig(); hook.state({}, { hubPlace: { id: 'main', menu: true } });
437
+ const open = (n) => { hook.message({}, { k: 'hub-menu', spec, n }); r.frame(); assert.equal(r.scene.moveInput.active, false); };
438
+ open(1); hook.message({}, { k: 'hub-menu', spec: null, n: 2 }); r.frame(); assert.equal(r.scene.moveInput.active, true);
439
+ open(3); r.system.sendHello(r.scene, r.scene.multiplayer, r.scene.multiplayer.net, 0, { resume: true }); assert.equal(r.scene.moveInput.active, true); assert(!Object.hasOwn(State.hub, 'menu'));
440
+ open(3); State.clear(); assert.equal(r.scene.moveInput.active, true);
441
+ hook.state({}, { hubPlace: { id: 'main', menu: true } }); open(4);
442
+ hook.state({}, { hubPlace: { id: 'other', menu: true } }); assert.equal(r.scene.moveInput.active, true); assert(!Object.hasOwn(State.hub, 'menu'));
443
+ open(5); hook.state({}, { hubPlace: { id: 'plain' } }); assert.equal(r.scene.moveInput.active, true); r.frame(); const count = r.calls.length; r.frame(); assert.equal(r.calls.length, count);
444
+ hook.state({}, { hubPlace: { id: 'main', menu: true } }); open(6); r.system.reset(); assert.equal(r.scene.moveInput.active, true); assert(!r.chrome.menuOpen());
445
+ open(7); r.chrome.dispose(); assert.equal(r.scene.moveInput.active, true); assert(!Object.hasOwn(r.system, 'menuInput')); State.clear();
446
+ });
447
+ test('pending sheet yields to ask/choice card; locks never nest', () => {
448
+ const r = systemRig(); hook.state({}, { hubPlace: { id: 'main', menu: true, ask: true, ballot: { lines: [] } } });
449
+ const card = { v: 'v1', mode: 'vote', faces: [], lines: [], who: {}, options: [] };
450
+ r.system.ballot = { frame() {}, dispose() {} };
451
+ hook.message(r.scene, { k: 'hub-ballot-card', card }); hook.message({}, { k: 'hub-menu', ...offer }); r.frame(); assert(!r.chrome.menuOpen());
452
+ hook.message({}, { k: 'hub-menu', spec, n: 2 }); hook.message(r.scene, { k: 'hub-ballot-card', card: null }); r.frame(); assert(r.chrome.menuOpen());
453
+ hook.message({}, { k: 'hub-ask', id: 'name', title: 'Name', max: 16, n: 1 }); r.frame();
454
+ assert(!r.chrome.menuOpen()); assert(r.chrome.textAskOpen()); assert(!Object.hasOwn(r.system, 'menuInput')); assert(Object.hasOwn(r.system, 'askInput'));
455
+ assert(r.sent.some((msg) => msg.k === 'hub-menu-pick' && msg.id === 'close' && msg.n === 2));
456
+ tap(find(r.dom, 'Cancel')); assert.equal(r.scene.moveInput.active, true); r.chrome.dispose(); State.clear(); Ballot.forget();
457
+ });
458
+ test('a locally consumed ask does not close a newer menu while its server close is pending', () => {
459
+ const r = systemRig(); hook.state({}, { hubPlace: { id: 'main', menu: true, ask: true } });
460
+ hook.message({}, { k: 'hub-ask', id: 'name', title: 'Name', max: 16, n: 1 }); r.frame(); assert(r.chrome.textAskOpen());
461
+ tap(find(r.dom, 'Cancel')); assert(!r.chrome.textAskOpen());
462
+ hook.message({}, { k: 'hub-menu', ...offer }); r.frame(); assert(r.chrome.menuOpen());
463
+ r.frame(); assert(r.chrome.menuOpen()); assert(!r.sent.some((msg) => msg.k === 'hub-menu-pick'));
464
+ hook.message({}, { k: 'hub-ask', id: 'name', title: 'Name', max: 16, n: 2 }); r.frame();
465
+ assert(!r.chrome.menuOpen()); assert(r.chrome.textAskOpen());
466
+ assert.deepEqual(r.sent.at(-1), { k: 'hub-menu-pick', id: 'close', n: 1 });
467
+ r.chrome.dispose(); State.clear();
468
+ });
469
+ test('keyless frame/state/DOM/pick trace byte identical; no menu fields or calls', () => {
470
+ function trace(inject) {
471
+ const r = systemRig(); hook.state({}, { hubPlace: { id: 'plain' } }); const at = r.dom.log.length;
472
+ if (inject) hook.message({}, { k: 'hub-menu', ...offer });
473
+ for (let i = 0; i < 3; i++) r.frame();
474
+ assert(!Object.hasOwn(State.hub, 'menu')); assert(!Object.hasOwn(State.hub, 'menuClose'));
475
+ assert(!Object.hasOwn(r.system, 'menuInput')); assert(!Object.hasOwn(r.system, 'menuDrawn'));
476
+ const trace = JSON.stringify([r.dom.log.slice(at), r.calls, r.sent]); r.chrome.dispose(); State.clear(); return trace;
477
+ }
478
+ assert.equal(trace(true), trace(false));
479
+ });
480
+ test('row menu has complete text columns, no icon slots and a pinned footer; close restores HUD', () => {
481
+ const r = rig();
482
+ r.chrome.setHud({ title: 'Gem Rush', big: '12', text: 'Walk into gems.' }, null);
483
+ const hud = find(r.dom, 'Gem Rush').parent, prompt = find(r.dom, 'Walk into gems.');
484
+ const rows = { title: 'Scores', presentation: 'rows', sections: [{ title: 'Rank · Player · Points', items: [{ id: 'record', label: '1st', readOnly: true, columns: ['1st', 'abcdefghijklmnopqrstuvwx', '500 pts'] }] }], footer: [{ id: 'next', label: 'More scores' }, { id: 'leave', label: 'Back to town' }] };
485
+ r.draw({ n: 1, spec: rows });
486
+ const card = sheet(r.dom), record = tile(r.dom, 'record'), leave = tile(r.dom, 'leave');
487
+ assert.equal(card.style.maxHeight, 'calc(100vh - 24px)');
488
+ assert.equal(hud.style.visibility, 'hidden'); assert.equal(prompt.style.visibility, 'hidden');
489
+ assert.equal(record.tag, 'div'); assert.deepEqual(record.children.map(c => c.textContent), ['1st', 'abcdefghijklmnopqrstuvwx', '500 pts']);
490
+ assert.equal(record.style.gridTemplateColumns, 'minmax(0, 1fr) minmax(0, 4fr) minmax(0, 2fr)');
491
+ assert(!record.children.some(c => c.attrs['aria-hidden'] === 'true'));
492
+ assert.equal(leave.parent.parent, card); assert.equal(leave.parent.style.flexShrink, '0');
493
+ assert.equal(leave.textContent, 'Back to town'); assert.equal(leave.style.minHeight, '44px'); assert.equal(leave.style.aspectRatio, '');
494
+ tap(tile(r.dom, 'next')); assert.deepEqual(r.sent, [{ k: 'hub-menu-pick', id: 'next', n: 1 }]);
495
+ r.draw({ n: 2, spec: { ...rows, face: 0 } }); assert.equal(sheet(r.dom).style.maxHeight, '40vh');
496
+ r.draw(null); assert.equal(hud.style.visibility, ''); assert.equal(prompt.style.visibility, '');
497
+ r.draw({ n: 3, spec }); assert.equal(tile(r.dom, 'blue').style.aspectRatio, '1');
498
+ r.chrome.dispose();
499
+ });
500
+ // The mask is the marker attribute plus the sheet's own !important rule; a
501
+ // control's own style.visibility is never read or written by it.
502
+ const RULE = '[data-hub-menu-covered] { visibility: hidden !important; }';
503
+ const covered = (node) => node.dataset.hubMenuCovered !== undefined;
504
+ const ruled = (dom) => sheet(dom).children.some((child) => child.tag === 'style' && child.textContent.includes(RULE));
505
+ test('row menu without face hides the controls under it and restores each one; tiles and face rows leave them', () => {
506
+ const r = rig();
507
+ r.chrome.soundControl(true, { volume: 0.5, muted: false }, {});
508
+ r.chrome.setPointers([{ id: 'goal', x: 300, y: 400, text: 'Post', angle: 0 }]);
509
+ const shift = document.createElement('button'); r.dom.body.appendChild(shift);
510
+ r.chrome.safeSurface('engine-shift-lock', shift, 'control');
511
+ const doors = find(r.dom, 'Doors'), dock = doors.parent, picker = find(r.dom, 'Your character').parent.parent;
512
+ const say = find(r.dom, '💬'), emote = find(r.dom, '☺'), pointers = find(r.dom, 'Post').parent.parent;
513
+ const sound = r.dom.made.findLast((node) => node.dataset.hub === 'sound');
514
+ emote.style.visibility = 'hidden';
515
+ const controls = { dock, picker, say, emote, sound, pointers, shift };
516
+ const own = () => Object.fromEntries(Object.entries(controls).map(([name, node]) => [name, node.style.visibility]));
517
+ const masks = () => Object.fromEntries(Object.entries(controls).map(([name, node]) => [name, covered(node)]));
518
+ const none = Object.fromEntries(Object.keys(controls).map((name) => [name, false]));
519
+ const all = Object.fromEntries(Object.keys(controls).map((name) => [name, true]));
520
+ const before = own();
521
+ const rows = { title: 'Rowan post', presentation: 'rows', sections: [{ title: 'Notes', items: [{ id: 'a', label: 'Hello', columns: ['1', 'Hello', 'Rowan'] }] }], footer: [{ id: 'back', label: 'Back' }] };
522
+ r.draw({ n: 1, spec });
523
+ assert.deepEqual(masks(), none, 'a tile menu leaves the controls');
524
+ assert.equal(ruled(r.dom), false);
525
+ r.draw({ n: 2, spec: rows });
526
+ assert.deepEqual(masks(), all);
527
+ assert.equal(ruled(r.dom), true);
528
+ assert.deepEqual(own(), before, 'the mask never writes a control\'s own visibility');
529
+ // A control the kit registers while the sheet is up is covered at the frame's end.
530
+ const late = document.createElement('button'); r.dom.body.appendChild(late);
531
+ r.chrome.safeSurface('act-prompt:late', late, 'control', { transient: true });
532
+ r.chrome.endLayoutFrame();
533
+ assert.equal(covered(late), true);
534
+ // The kit's own writes under the sheet are what it has once the sheet goes.
535
+ say.style.visibility = 'hidden';
536
+ r.draw({ n: 3, spec: { ...rows, face: 0 } });
537
+ assert.deepEqual(masks(), none, 'replaced by a face row menu: unmasked and left');
538
+ assert.equal(covered(late), false);
539
+ assert.equal(ruled(r.dom), false);
540
+ assert.equal(say.style.visibility, 'hidden');
541
+ say.style.visibility = '';
542
+ r.draw({ n: 4, spec: rows });
543
+ assert.deepEqual(masks(), all);
544
+ r.draw(null);
545
+ assert.deepEqual(masks(), none, 'closed: unmasked');
546
+ r.chrome.endLayoutFrame();
547
+ assert.deepEqual(masks(), none);
548
+ assert.deepEqual(own(), before);
549
+ r.draw({ n: 5, spec: rows });
550
+ assert.deepEqual(masks(), all);
551
+ r.chrome.clearMenu();
552
+ assert.deepEqual(masks(), none, 'teardown: unmasked');
553
+ r.draw({ n: 6, spec: rows });
554
+ r.chrome.dispose();
555
+ assert.deepEqual(masks(), none, 'dispose: unmasked');
556
+ assert.deepEqual(own(), before);
557
+ });
558
+ test('row menu without face covers a shown pad-context chip and restores it; no pad context never throws', () => {
559
+ const rows = { title: 'Rowan post', presentation: 'rows', sections: [], note: 'No post to read yet.', footer: [{ id: 'back', label: 'Back' }] };
560
+ // (b) Pad cues off: no chip was ever made, so there is nothing to cover.
561
+ const off = rig();
562
+ assert.doesNotThrow(() => off.draw({ n: 1, spec: rows }));
563
+ assert.doesNotThrow(() => off.chrome.endLayoutFrame());
564
+ assert.equal(off.dom.made.some((node) => node.dataset.hub === 'pad-context'), false);
565
+ assert.doesNotThrow(() => off.draw(null));
566
+ off.chrome.setPadContext(null);
567
+ assert.doesNotThrow(() => off.draw({ n: 2, spec: rows }));
568
+ off.chrome.dispose();
569
+ // (a) Pad cues on, a pad context shown.
570
+ const r = rig();
571
+ r.chrome.setPadContext({ id: 'pad', title: 'Fancy pad', secondary: '' });
572
+ const chip = r.dom.made.find((node) => node.dataset.hub === 'pad-context');
573
+ assert.ok(chip);
574
+ assert.equal(chip.style.visibility, '', 'the pad context is shown before the sheet');
575
+ r.draw({ n: 1, spec: rows });
576
+ assert.equal(covered(chip), true);
577
+ r.chrome.endLayoutFrame();
578
+ assert.equal(covered(chip), true);
579
+ r.draw(null);
580
+ assert.equal(covered(chip), false, 'unmasked on close');
581
+ r.chrome.setPadContext({ id: 'pad', title: 'Fancy pad', secondary: '' });
582
+ assert.equal(chip.style.visibility, '', 'shown again');
583
+ r.chrome.dispose();
584
+ });
585
+ console.log(`${passed} menu client tests passed`);