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
@@ -391,6 +391,10 @@ await test('the town mounts a pack with its sounds as data: URLs, and a place pl
391
391
  [`${kit}drawings/pixel/kai-face.sprite`]: '{"frames":[]}',
392
392
  [`${kit}blueprints/bean/avatar-3.scene`]: blueprint('models/bean/avatar-3.pxmodel'),
393
393
  [`${kit}models/bean/avatar-3.pxmodel`]: '{"parts":[]}',
394
+ // v1.53: the earned items are the town's too.
395
+ [`${kit}models/earned/badge-round.pxmodel`]: '{"parts":[]}',
396
+ [`${kit}models/earned/held-2.pxmodel`]: '{"parts":[]}',
397
+ [`${kit}models/earned/square/belt-plain.pxmodel`]: '{"parts":[]}',
394
398
  [`${kit}blueprints/bean/statue.scene`]: blueprint('models/statue.pxmodel'),
395
399
  [`${kit}models/statue.pxmodel`]: '{"parts":[]}',
396
400
  'scenes/town.scene': '{"actors":[]}',
@@ -403,6 +407,9 @@ await test('the town mounts a pack with its sounds as data: URLs, and a place pl
403
407
  .filter((path) => !/statue|town/.test(path))
404
408
  .sort(),
405
409
  );
410
+ // v1.53: the engine's earned models are laid over the pack, as its hats are.
411
+ assert.equal(content.files[`${kit}models/earned/badge-round.pxmodel`], '{"parts":[]}');
412
+ assert.ok(!content.carried.files.includes(`${kit}models/earned/badge-round.pxmodel`));
406
413
  assert.equal(content.audio['sounds/horn.wav'], `data:audio/wav;base64,${loud.audio['sounds/horn.wav'].base64}`);
407
414
  assert.equal(content.audio['sounds/beep.mp3'], `data:audio/mpeg;base64,${loud.audio['sounds/beep.mp3'].base64}`);
408
415
  const listed = loud.places.main.idle.sounds;
@@ -0,0 +1,304 @@
1
+ import assert from 'node:assert/strict';
2
+ import { readFile } from 'node:fs/promises';
3
+ import { register } from 'node:module';
4
+ import * as THREE from 'three';
5
+ import { collectPadCues, makePadCueTracker, padArrivalPoint, padContextText, padCuesEnabled, selectPadCue, validatePadCue } from '../code/client/padCues.js';
6
+ import { makePadRings, ringGeometry, spawnRingOverlaps } from '../code/client/padRings.js';
7
+ import { makePadReadability } from '../code/client/padReadability.js';
8
+ import { fakeDom } from './fixtures/fake-dom.mjs';
9
+
10
+ const actor = (id, components) => ({ id, components });
11
+ const pad = (id, x = 0, extras = {}) => actor(id, { Transform: { x, y: 0.1, z: 0 }, HubPad: { door: 'door', radius: 0.6 }, ...extras });
12
+ const door = actor('door-actor', { HubDoor: { id: 'door', title: 'The Stadium' } });
13
+ const cues = (actors, hidden = new Set()) => collectPadCues(actors, hidden);
14
+ const body = (x, z = 0) => ({ x, z });
15
+ const close = (actual, expected) => assert.ok(Math.abs(actual - expected) < 1e-5, `${actual} ≈ ${expected}`);
16
+
17
+ for (const radius of [undefined, null, NaN, Infinity, -1, 0.29, 6.01, '1']) {
18
+ assert.equal(validatePadCue({ radius, title: 'Quick pad' }), null);
19
+ }
20
+ for (const radius of [0.3, 6]) {assert.deepEqual(validatePadCue({ radius }), { radius });}
21
+ assert.deepEqual(validatePadCue({ radius: 0.6, title: ' Quick pad ', other: 2 }), { radius: 0.6, title: 'Quick pad' });
22
+ assert.equal(validatePadCue({ radius: 1, title: '🌕'.repeat(24) }).title, '🌕'.repeat(24));
23
+ for (const title of ['', ' ', 'x'.repeat(25), 'a\nb', '\tStir ring', 'a\u007fb', 'a\u0085b', 24]) {
24
+ assert.deepEqual(validatePadCue({ radius: 0.6, title }), { radius: 0.6 });
25
+ }
26
+
27
+ const a = pad('a'), b = pad('b', 0.2);
28
+ assert.equal(cues([a, door])[0].title, 'The Stadium', 'HubDoor.id resolves the title, not actor id');
29
+ assert.equal(cues([a])[0].title, undefined);
30
+ assert.equal(cues([a, door], new Set(['a'])).length, 0);
31
+ assert.equal(cues([a, door], new Set(['door-actor']))[0].title, 'The Stadium', 'cue visibility belongs to the pad actor');
32
+ const explicit = pad('station', 1, { HubPadCue: { radius: 1.2, title: 'Fancy pad' } });
33
+ assert.equal(cues([explicit, door])[0].radius, 1.2);
34
+ assert.equal(cues([explicit, door])[0].door, false);
35
+ explicit.components.HubPadCue.title = '\nbad';
36
+ assert.equal(cues([explicit, door])[0].title, undefined, 'invalid explicit title does not fall back to the door');
37
+ explicit.components.HubPadCue.radius = Infinity;
38
+ assert.equal(cues([explicit, door]).length, 0, 'invalid explicit radius excludes a dual-component actor');
39
+
40
+ const pair = cues([b, a, door]);
41
+ let active = selectPadCue(pair, body(0));
42
+ assert.equal(active.cue.id, 'a', 'overlapping footprints tie by stable id');
43
+ assert.equal(active.on, true);
44
+ active = selectPadCue(pair, body(0.2), { cue: pair[0], on: true });
45
+ assert.equal(active.cue.id, 'b', 'a valid standing incumbent survives the id tie');
46
+ active = selectPadCue(cues([a]), body(2.1));
47
+ assert.equal(active.on, false);
48
+ assert.equal(selectPadCue(cues([a]), body(2.101)), null, 'new near cue must be within 1.5 m of edge');
49
+ assert.equal(selectPadCue(cues([a]), body(2.59), active).cue.id, 'a');
50
+ assert.equal(selectPadCue(cues([a]), body(2.601), active), null);
51
+ assert.equal(selectPadCue(cues([a], new Set(['a'])), body(0), active), null);
52
+ assert.equal(selectPadCue(pair, body(2)).cue.id, 'b', 'nearest edge wins');
53
+ assert.equal(selectPadCue(cues([pad('b', 1), pad('a', -1)]), body(0)).cue.id, 'a', 'equal edge distances tie by id');
54
+ assert.equal(selectPadCue(cues([a, pad('inside', 2.4)]), body(2.4), active).cue.id, 'inside', 'standing beats a retained near cue');
55
+ assert.equal(selectPadCue(pair, null), null);
56
+
57
+ const tracked = new Map([[a.id, a], [door.id, door]]), hidden = new Set();
58
+ const tracker = makePadCueTracker();
59
+ const first = tracker.frame(tracked, hidden, body(0));
60
+ assert.equal(tracker.frame(tracked, hidden, body(0.04)), first, 'under 5 cm returns the same allocation');
61
+ assert.notEqual(tracker.frame(tracked, hidden, body(0.051)), first, 'over 5 cm reselects');
62
+ door.components.HubDoor.title = 'New title';
63
+ assert.equal(tracker.frame(tracked, hidden, body(0.051)).cue.title, 'New title', 'in-place cue text edits invalidate');
64
+ hidden.add('a');
65
+ assert.equal(tracker.frame(tracked, hidden, body(0.051)), null, 'in-place private hide revokes immediately');
66
+ hidden.clear();
67
+ assert.ok(tracker.frame(tracked, hidden, body(0.051)));
68
+ tracked.delete('a');
69
+ assert.equal(tracker.frame(tracked, hidden, body(0.051)), null, 'actor removal revokes');
70
+ const invalid = pad('invalid', 0, { HubPadCue: { radius: NaN } });
71
+ const invalidTracker = makePadCueTracker(), withInvalid = new Map([['a', a], ['invalid', invalid]]);
72
+ const cached = invalidTracker.frame(withInvalid, hidden, body(0));
73
+ assert.equal(invalidTracker.frame(withInvalid, hidden, body(0)), cached, 'invalid NaN fields do not force frame allocations/reselection');
74
+ assert.equal(invalidTracker.frame(withInvalid, hidden, body(NaN)), null, 'an unavailable local body clears selection');
75
+ assert.ok(invalidTracker.frame(withInvalid, hidden, body(0)), 'selection recovers after an unavailable local body');
76
+
77
+ const named = cues([pad('caption'), door])[0];
78
+ assert.deepEqual(padContextText({ cue: named, on: false }), { id: 'caption', title: 'New title', secondary: 'Step on to join' });
79
+ assert.equal(padContextText({ cue: named, on: true }).secondary, '');
80
+ assert.equal(padContextText({ cue: { ...named, door: false }, on: false }).secondary, '');
81
+ assert.equal(padContextText({ cue: { ...named, title: undefined }, on: true }), null);
82
+ assert.equal(padContextText(null), null);
83
+
84
+ // Actual enable gate: even accessing options would create client resources.
85
+ const forbidden = new Proxy({}, { get() {throw new Error('disabled path touched a resource');} });
86
+ for (const engine of [undefined, {}, { hubPadContext: false, hubPadRing: false, hubSpawnRing: false }, { hubPadRing: 1 }]) {
87
+ assert.equal(padCuesEnabled(engine), false);
88
+ assert.equal(makePadReadability(engine, forbidden), null);
89
+ }
90
+
91
+ function radii(geometry) {
92
+ const p = geometry.attributes.position, out = [];
93
+ for (let i = 0; i < p.count; i += 1) {close(p.getY(i), 0); out.push(Math.hypot(p.getX(i), p.getZ(i)));}
94
+ return [Math.min(...out), Math.max(...out)];
95
+ }
96
+ const geometry = ringGeometry(0.65, 0.12);
97
+ radii(geometry).forEach((r, i) => close(r, [0.65, 0.77][i]));
98
+ assert.equal(geometry.attributes.position.count, 64 * 6);
99
+ geometry.dispose();
100
+ const segmented = ringGeometry(1.2, 0.12, 8);
101
+ assert.equal(segmented.attributes.position.count, 8 * 8 * 6);
102
+ assert.equal(segmented.groups.length, 0, 'segments share a single draw call');
103
+ for (let i = 0; i < 8; i += 1) {
104
+ const p = segmented.attributes.position;
105
+ const index = i * 8 * 6;
106
+ close(Math.atan2(p.getZ(index), p.getX(index)), Math.atan2(Math.sin(i * Math.PI / 4), Math.cos(i * Math.PI / 4)));
107
+ const last = index + 8 * 6 - 1;
108
+ const expected = i * Math.PI / 4 + Math.PI / 4 * 0.75;
109
+ close(p.getX(last), Math.cos(expected) * 1.32);
110
+ close(p.getZ(last), Math.sin(expected) * 1.32);
111
+ }
112
+ segmented.dispose();
113
+
114
+ const raised = cues([pad('raised', 0, { Shape: { kind: 'cylinder', height: 0.2, color: '#123456' } })])[0];
115
+ close(raised.y, 0.23);
116
+ close(named.y, 0.13);
117
+ assert.equal(named.color, '#d9a441');
118
+ assert.equal(raised.color, '#123456');
119
+ const world = new THREE.Scene();
120
+ const rings = makePadRings(world, { active: true, arrival: null });
121
+ assert.equal(world.children.length, 0, 'B creates its mesh lazily');
122
+ rings.frame(raised);
123
+ assert.equal(world.children.length, 1);
124
+ const mesh = world.children[0], buffer = mesh.geometry.attributes.position;
125
+ assert.equal(mesh.material.type, 'MeshBasicMaterial');
126
+ assert.equal(mesh.material.transparent, false);
127
+ assert.equal(mesh.material.opacity, 1);
128
+ assert.equal(mesh.castShadow, false);
129
+ assert.equal(mesh.receiveShadow, false);
130
+ assert.equal(mesh.material.color.getHexString(), '123456');
131
+ close(mesh.position.y, 0.23);
132
+ rings.frame({ ...named, radius: 3, x: 4 });
133
+ assert.equal(world.children[0], mesh);
134
+ assert.equal(mesh.geometry.attributes.position, buffer, 'radius changes reuse the position buffer');
135
+ radii(mesh.geometry).forEach((r, i) => close(r, [3.05, 3.17][i]));
136
+ assert.equal(mesh.material.color.getHexString(), 'd9a441');
137
+ assert.equal(mesh.position.x, 4);
138
+ rings.frame(null);
139
+ assert.equal(mesh.visible, false);
140
+ rings.frame(raised);
141
+ assert.equal(world.children.length, 1);
142
+ let disposed = 0;
143
+ mesh.geometry.addEventListener('dispose', () => disposed++);
144
+ mesh.material.addEventListener('dispose', () => disposed++);
145
+ rings.dispose();
146
+ assert.equal(disposed, 2);
147
+ assert.equal(world.children.length, 0);
148
+
149
+ const arrival = { x: 0, y: 0, z: 0 };
150
+ assert.equal(spawnRingOverlaps({ x: 1.8, z: 0, radius: 0.6 }, arrival), true);
151
+ assert.equal(spawnRingOverlaps({ x: 1.801, z: 0, radius: 0.6 }, arrival), false);
152
+ const both = makePadRings(world, { active: true, arrival });
153
+ assert.equal(world.children.length, 1);
154
+ const spawn = world.children[0];
155
+ assert.equal(spawn.material.color.getHexString(), '7fc9b8');
156
+ close(spawn.position.y, 0.03);
157
+ both.frame(raised);
158
+ assert.equal(world.children.length, 1, 'overlap never creates a second mesh unnecessarily');
159
+ both.frame({ ...raised, x: 5 });
160
+ assert.equal(world.children.length, 2);
161
+ both.frame(raised);
162
+ assert.equal(world.children[1].visible, false);
163
+ assert.equal(spawn.visible, true);
164
+ both.dispose();
165
+
166
+ // Each marker alone creates only its own affordance, on every graphics tier.
167
+ const noChrome = new Proxy({}, { get() {throw new Error('ring marker touched chrome');} });
168
+ const justSpawn = makePadReadability({ hubSpawnRing: true }, { world, arrival, chrome: noChrome });
169
+ justSpawn.frame(forbidden, forbidden, null, false);
170
+ assert.equal(world.children.length, 1);
171
+ justSpawn.dispose();
172
+ const justActive = makePadReadability({ hubPadRing: true }, { world, chrome: noChrome });
173
+ justActive.frame(tracked, hidden, body(0), false);
174
+ assert.equal(world.children.length, 0, 'ring marker has no locator and no active pad');
175
+ justActive.frame(new Map([['a', a]]), hidden, body(0), false);
176
+ assert.equal(world.children.length, 1);
177
+ justActive.dispose();
178
+
179
+ const spawnActor = actor('player', { Player: {}, Shape: {}, Transform: { x: 5, y: 1, z: 9 } });
180
+ const arrivalActor = actor('arrival', { Transform: { x: 2, y: 0, z: 3 } });
181
+ assert.deepEqual(padArrivalPoint([spawnActor, arrivalActor], { actor: 'arrival' }), { x: 2, y: 0, z: 3 });
182
+ assert.deepEqual(padArrivalPoint([spawnActor], null), { x: 5, y: 1, z: 9 });
183
+ assert.deepEqual(padArrivalPoint([spawnActor], { actor: 'missing' }), { x: 5, y: 1, z: 9 });
184
+ assert.deepEqual(padArrivalPoint([], null), { x: 0, y: 1, z: 0 });
185
+
186
+ // Resolve the browser-only blueprint boundary as existing client tests do.
187
+ register(`data:text/javascript,${encodeURIComponent(`
188
+ export async function resolve(specifier, context, next) {
189
+ if (specifier === '@imports/castle.physics-2d/engine/blueprint') return {
190
+ url: 'data:text/javascript,' + encodeURIComponent('export const mergeComponents = (a,b) => Object.fromEntries([...new Set([...Object.keys(a??{}),...Object.keys(b??{})])].map(k=>[k,{...a?.[k],...b?.[k]}])); export const getBlueprintTemplate = (files,ref) => ({components:JSON.parse(files[ref]).actors[0].components});'), shortCircuit: true };
191
+ return next(specifier, context);
192
+ }
193
+ `)}`);
194
+ const { readPadArrival } = await import('../code/client/padCueArrival.js');
195
+ const scene = { currentScenePath: 'scenes/main.scene', files: { 'scenes/main.scene': JSON.stringify({ actors: [spawnActor, arrivalActor] }) }, data: { actors: [pad('moving-player', 99)] } };
196
+ assert.deepEqual(readPadArrival(scene, { id: 'main' }, { actor: 'arrival' }), { x: 2, y: 0, z: 3 }, 'local manifest uses authored arrival, never moving runtime transforms');
197
+ scene.content = { places: { main: { arrival: { actor: 'player' } } } };
198
+ assert.deepEqual(readPadArrival(scene, { id: 'main' }, { actor: 'arrival' }), { x: 5, y: 1, z: 9 }, 'mounted manifest overrides root manifest');
199
+ scene.files['scenes/main.scene'] = JSON.stringify({ actors: [{ id: 'blue', blueprint: 'blueprints/spawn.scene', components: { Transform: { x: 7 } } }] });
200
+ scene.files['blueprints/spawn.scene'] = JSON.stringify({ actors: [{ components: spawnActor.components }] });
201
+ assert.deepEqual(readPadArrival(scene, { id: 'main' }, { actor: 'arrival' }), { x: 7, y: 1, z: 9 }, 'blueprint Player spawn resolves authored overrides');
202
+ assert.equal(readPadArrival({ ...scene, files: {} }, { id: 'main' }), null, 'missing authored data never invents a locator from runtime positions');
203
+ for (const bad of ['{', '{"actors":{}}', 'null', '{"actors":[null,7]}']) {
204
+ assert.doesNotThrow(() => readPadArrival({ ...scene, files: { 'scenes/main.scene': bad } }, { id: 'main' }, { actor: 'arrival' }), `malformed source ${bad} stays out of the frame loop`);
205
+ }
206
+ assert.equal(readPadArrival({ ...scene, files: { 'scenes/main.scene': '{' } }, { id: 'main' }), null, 'malformed source omits the locator');
207
+
208
+ const dom = fakeDom({ viewW: 844, viewH: 390 });
209
+ const { makeChrome } = await import('../code/client/chrome.js');
210
+ const chrome = makeChrome({ onBack() {throw new Error('caption dispatched Back');}, onAvatar() {throw new Error('caption dispatched avatar');}, avatarCount: 4 });
211
+ assert.equal(dom.made.some((n) => n.dataset.hub === 'pad-context'), false);
212
+ chrome.setPadContext(null);
213
+ assert.equal(dom.made.some((n) => n.dataset.hub === 'pad-context'), false);
214
+ const text = { id: 'a', title: 'Fancy pad', secondary: '' };
215
+ chrome.setPadContext(text);
216
+ const caption = dom.made.find((n) => n.dataset.hub === 'pad-context');
217
+ assert.ok(caption);
218
+ assert.equal(caption.tag, 'div');
219
+ assert.equal(caption.style.pointerEvents, 'none');
220
+ assert.equal(caption.attrs.tabindex, undefined);
221
+ assert.equal(caption.attrs['aria-label'], 'Fancy pad');
222
+ assert.equal(caption.attrs.title, 'Fancy pad');
223
+ assert.equal(caption.children[0].style.fontSize, '16px');
224
+ assert.equal(caption.children[0].style.webkitLineClamp, '2');
225
+ assert.equal(caption.children[0].style.textOverflow, 'ellipsis');
226
+ assert.equal(caption.children[1].style.fontSize, '13px');
227
+ assert.equal(caption.children[1].style.display, 'none');
228
+ assert.ok([caption, ...caption.children].every((n) => n.tag !== 'button' && Object.keys(n.handlers).length === 0), 'caption creates no buttons, listeners or dispatch path');
229
+ const before = dom.log.length;
230
+ chrome.setPadContext(text);
231
+ assert.ok(dom.log.slice(before).every((line) => !line.includes(' text=') && !line.includes(' style.')), 'identical caption/layout performs no DOM writes');
232
+ chrome.beginLayoutFrame?.();
233
+ assert.doesNotThrow(() => chrome.setPadContext({ ...text, id: 'layout-frame' }), 'caption reads safe insets inside an active layout frame');
234
+ chrome.endLayoutFrame?.();
235
+ chrome.setPadContext(text);
236
+ chrome.setPadContext({ ...text, secondary: 'Step on to join' });
237
+ assert.equal(caption.children[1].textContent, 'Step on to join');
238
+ assert.equal(caption.children[1].style.display, 'block');
239
+ caption.size = { w: 180, h: 70 };
240
+ const obstacle = document.createElement('div');
241
+ obstacle.rect = { left: 0, right: 844, top: 0, bottom: 390 };
242
+ chrome.safeSurface('full-screen-hud', obstacle, 'text');
243
+ chrome.setPadContext(text);
244
+ assert.equal(caption.style.visibility, 'hidden', 'no slot suppresses the caption');
245
+ chrome.safeSurface('full-screen-hud', null);
246
+ chrome.setPadContext(text);
247
+ assert.equal(caption.style.visibility, '');
248
+ const panel = document.createElement('div');
249
+ panel.rect = { left: 0, right: 100, top: 0, bottom: 100 };
250
+ chrome.safeSurface('invite-dialog', panel, 'card');
251
+ chrome.setPadContext(text);
252
+ assert.equal(caption.style.visibility, 'hidden', 'any registered open panel hides the caption');
253
+ chrome.safeSurface('invite-dialog', null);
254
+ // Exact phone viewports use the shared final-rectangle placement, including
255
+ // action rails, joystick space, HUD and both host-reserved corners.
256
+ const overlaps = (a, b) => a.left < b.right && a.right > b.left && a.top < b.bottom && a.bottom > b.top;
257
+ const rail = document.createElement('div');
258
+ for (const [w, h] of [[844, 390], [352, 526], [509, 218]]) {
259
+ window.innerWidth = w; window.innerHeight = h;
260
+ rail.rect = { left: w - 110, right: w - 8, top: h - 100, bottom: h - 8 };
261
+ chrome.safeSurface('test-action-rail', rail, 'control');
262
+ chrome.setPadContext(text);
263
+ assert.equal(caption.style.visibility, '', `${w}x${h} has a clear caption slot`);
264
+ const left = parseFloat(caption.style.left), top = parseFloat(caption.style.top);
265
+ const rect = { left, right: left + 180, top, bottom: top + 70 };
266
+ assert.ok(rect.left >= 8 && rect.right <= w - 8 && rect.top >= 8 && rect.bottom <= h - 8);
267
+ const corners = [{ left: 0, right: 64, top: 0, bottom: 56 }, { left: w - 64, right: w, top: 0, bottom: 56 }];
268
+ const joystick = w > h ? { left: 0, right: w / 2, top: h / 2, bottom: h } : { left: 0, right: 112, top: h - 112, bottom: h };
269
+ assert.ok([...corners, joystick, rail.rect].every((obstacle) => !overlaps(rect, obstacle)));
270
+ }
271
+ chrome.safeSurface('test-action-rail', null);
272
+ // The caption runs after the stuck chip in a frame, so a chip shown this
273
+ // frame is already a final rect the caption keeps clear of.
274
+ {
275
+ window.innerWidth = 844; window.innerHeight = 390;
276
+ chrome.setPadContext(text);
277
+ const left = parseFloat(caption.style.left), top = parseFloat(caption.style.top);
278
+ chrome.stuckPrompt('Stuck? Tap to go back to the start', () => {});
279
+ const chip = dom.made.find((n) => n.dataset?.hub === 'stuck');
280
+ assert.ok(chip, 'the stuck chip exists');
281
+ chip.rect = { left: left + 20, right: left + 80, top: top + 10, bottom: top + 40 };
282
+ chrome.setPadContext(text);
283
+ const l2 = parseFloat(caption.style.left), t2 = parseFloat(caption.style.top);
284
+ const placed = { left: l2, right: l2 + 180, top: t2, bottom: t2 + 70 };
285
+ assert.ok(caption.style.visibility === 'hidden' || !overlaps(placed, chip.rect), 'a shown stuck chip is never under the caption');
286
+ chrome.stuckPrompt(null);
287
+ }
288
+ const runtime = makePadReadability({ hubPadContext: true }, { world, chrome });
289
+ runtime.frame(new Map([['a', a], ['door', door]]), new Set(), body(0), false);
290
+ assert.equal(caption.style.visibility, '');
291
+ runtime.frame(new Map([['a', a], ['door', door]]), new Set(), body(0), false, true);
292
+ assert.equal(caption.style.visibility, 'hidden', 'decorating and other system-owned sheets hide captions');
293
+ runtime.frame(new Map([['a', a]]), new Set(), body(0), true);
294
+ assert.equal(caption.style.visibility, 'hidden', 'travel hides the caption');
295
+ runtime.dispose();
296
+ assert.equal(caption.parent.children.includes(caption), false);
297
+ chrome.dispose();
298
+
299
+ const source = await readFile(new URL('../code/systems/hub.js', import.meta.url), 'utf8');
300
+ assert.match(source, /if \(padCuesEnabled\(scene\.data\?\.engine\) \|\| this\.padReadability\)/, 'production frame respects the same enable gate');
301
+ assert.match(source, /enterScene\(scene\) \{\s*this\.clearPadReadability\(\)/);
302
+ assert.match(source, /reset\(scene\) \{\s*this\.clearPadReadability\(\)/);
303
+ assert.match(source, /dispose\(\) \{\s*this\.clearPadReadability\(\)/);
304
+ console.log('pad cues: validation, selection/cache/privacy, disabled gate, captions, merged/reused rings and authored arrival passed');
@@ -0,0 +1,177 @@
1
+ import assert from 'node:assert/strict';
2
+ import { addOccupancy, makePadOccupancy, occupancyLine, selectedPad } from '../code/server/padOccupancy.js';
3
+ import { bodyBox, clearBox, occupancyText, placeLabels } from '../code/client/padOccupancy.js';
4
+ import { fakeDom } from './fixtures/fake-dom.mjs';
5
+
6
+ const pad = { id: 'pad', components: { HubPad: { door: 'door' }, Transform: { x: 0, z: 0 } } };
7
+ function fixture(n) {
8
+ const ids = ['self', ...Array.from({ length: n }, (_, i) => `p${i}`)];
9
+ const h = {
10
+ sim: { timeMs: 1000, players: new Map(ids.map((id) => [id, { at: { x: 0, z: 0 } }])) },
11
+ session: { players: ids.map((playerId) => ({ playerId })) },
12
+ hidden: new Set(), labels: new Map([['pad', { text: 'Station', style: 'tag' }]]),
13
+ padDoors: new Map([['door', new Set(ids)]]), padOccupancy: makePadOccupancy([pad]),
14
+ };
15
+ h.padOccupancy.reportedAt.set('door', 1000);
16
+ h.padOccupancy.knownAt = 1000;
17
+ h.padOccupancy.known = new Map([['self', new Set(ids.slice(1))]]);
18
+ return h;
19
+ }
20
+ for (const n of [0, 3, 11]) {
21
+ const h = fixture(n);
22
+ assert.equal(occupancyLine(h, pad, 'self'), `you + ${n} more`);
23
+ h.padDoors.get('door').delete('self');
24
+ assert.equal(occupancyLine(h, pad, 'self'), `${n} here`, 'departure excludes self immediately');
25
+ }
26
+ {
27
+ const h = fixture(3);
28
+ const blocked = new Set(['p0']);
29
+ assert.equal(occupancyLine(h, pad, 'self', blocked), 'you + 2 more');
30
+ h.hidden.add('p1');
31
+ assert.equal(occupancyLine(h, pad, 'self', blocked), 'you + 1 more');
32
+ h.padOccupancy.known.get('self').delete('p2');
33
+ assert.equal(occupancyLine(h, pad, 'self', blocked), 'you + 0 more', 'undisclosed occupants never contribute');
34
+ h.padOccupancy.known.get('self').add('p2');
35
+ h.session.players = h.session.players.filter((p) => p.playerId !== 'p2');
36
+ assert.equal(occupancyLine(h, pad, 'self', blocked), 'you + 0 more', 'disconnected body retention never contributes');
37
+ h.sim.timeMs = 1501;
38
+ assert.equal(occupancyLine(h, pad, 'self', blocked), 'occupancy unavailable');
39
+ h.sim.timeMs = 1000;
40
+ h.padOccupancy.known = null;
41
+ assert.equal(occupancyLine(h, pad, 'self', blocked), 'occupancy unavailable');
42
+ h.padOccupancy.known = new Map([['self', new Set(['p0'])]]);
43
+ h.padOccupancy.ambiguous.add('door');
44
+ assert.equal(occupancyLine(h, pad, 'self', blocked), 'occupancy unavailable', 'a door-level set cannot disambiguate two pads');
45
+ }
46
+ {
47
+ const h = fixture(3);
48
+ const out = {};
49
+ addOccupancy(h, 'self', out);
50
+ assert.deepEqual(out, { pad: { text: 'Station\nyou + 3 more', style: 'tag' } });
51
+ assert.equal(h.labels.get('pad').text, 'Station', 'shared label is unchanged');
52
+ const redacted = {};
53
+ addOccupancy(h, 'self', redacted, new Set(['p0']), () => ({ text: 'redacted station', style: 'tag' }));
54
+ assert.equal(redacted.pad.text, 'redacted station\nyou + 2 more');
55
+ const refused = {};
56
+ addOccupancy(h, 'self', refused, new Set(['p0']), () => null);
57
+ assert.deepEqual(refused, {}, 'a hidden label is never reconstructed from the raw shared text');
58
+ const privateOverride = { pad: { text: 'Your personal record', style: 'tag' } };
59
+ addOccupancy(h, 'self', privateOverride);
60
+ assert.equal(privateOverride.pad.text, 'Your personal record\nyou + 3 more');
61
+ const goal = { pad: { text: 'Your quest', style: 'goal' } };
62
+ addOccupancy(h, 'self', goal);
63
+ assert.equal(goal.pad.text, 'Your quest');
64
+ h.labels.set('pad', { text: 'x'.repeat(64), style: 'tag' });
65
+ const long = {};
66
+ addOccupancy(h, 'self', long);
67
+ assert.equal(long.pad.text, 'you + 3 more', 'occupancy wins over an unfit decorative duplicate');
68
+ }
69
+ {
70
+ const h = fixture(0);
71
+ const other = { id: 'other', components: { HubPad: { door: 'second' }, Transform: { x: 0.1, z: 0 } } };
72
+ h.padOccupancy.pads.push(other);
73
+ h.labels.set('other', { text: 'Second', style: 'tag' });
74
+ h.padDoors.set('second', new Set(['self']));
75
+ h.padOccupancy.reportedAt.set('second', 1000);
76
+ assert.equal(selectedPad(h, 'self').id, 'pad');
77
+ h.sim.players.get('self').at.x = 0.1;
78
+ assert.equal(selectedPad(h, 'self').id, 'pad', 'overlap retains a valid identity');
79
+ h.padDoors.get('door').delete('self');
80
+ assert.equal(selectedPad(h, 'self').id, 'other', 'membership on another pad wins');
81
+ h.visMe = new Map([['self', new Map([['other', true]])]]);
82
+ assert.equal(selectedPad(h, 'self').id, 'pad', 'private pad hide revokes selection immediately');
83
+ h.sim.players.get('self').at.x = 8;
84
+ assert.equal(selectedPad(h, 'self'), null);
85
+ }
86
+
87
+ const touching = (a, b) => a.left < b.right && b.left < a.right && a.top < b.bottom && b.top < a.bottom;
88
+ const measure = (text) => ({ w: Math.max(...text.split('\n').map((s) => s.length)) * 7 + 20, h: text.split('\n').length * 18 + 8 });
89
+ for (const [w, h] of [[844, 390], [352, 526], [509, 218]]) {
90
+ const own = { left: w / 2 - 45, right: w / 2 + 45, top: 76, bottom: h - 68 };
91
+ const controls = [{ left: 0, right: w, top: 0, bottom: 56 }, { left: 0, right: w, top: h - 56, bottom: h }];
92
+ const text = 'The Stadium\nyou + 3 more';
93
+ const size = measure(text);
94
+ const item = { id: 'pad', padOccupancy: true, text, x: w / 2, y: h / 2, box: { left: w / 2 - size.w / 2, right: w / 2 + size.w / 2, top: h / 2 - size.h, bottom: h / 2 } };
95
+ const out = placeLabels([item], own, controls, { w, h }, measure);
96
+ assert.equal(out.length, 1, `${w}x${h} has a clear pad label`);
97
+ for (const obstacle of [...controls, own]) {assert.equal(touching(out[0].box, obstacle), false);}
98
+ assert.equal(out[0].x, (out[0].box.left + out[0].box.right) / 2);
99
+ assert.equal(out[0].y, out[0].box.bottom);
100
+ const stale = placeLabels([item], own, controls, { w, h }, measure, true);
101
+ assert.ok(stale.every((i) => !/\d+ (more|here)/.test(i.text)), 'stale client never draws a number');
102
+ assert.deepEqual(placeLabels([item], own, [{ left: 0, right: w, top: 0, bottom: h }], { w, h }, measure), [], 'no room suppresses text');
103
+ }
104
+ assert.equal(occupancyText('You + 3 more needed'), null);
105
+ {
106
+ const own = { left: 90, right: 130, top: 60, bottom: 110 };
107
+ const obstacles = [own, { left: 0, right: 85, top: 50, bottom: 110 }, { left: 135, right: 240, top: 50, bottom: 110 }, { left: 75, right: 145, top: 0, bottom: 55 }, { left: 0, right: 240, top: 115, bottom: 150 }];
108
+ const placed = clearBox({ left: 80, right: 140, top: 65, bottom: 85 }, obstacles, { w: 240, h: 150 }, own);
109
+ assert.ok(placed, 'a free corner is used when every cardinal direction is blocked');
110
+ assert.ok(obstacles.every((o) => !touching(placed, o)));
111
+ }
112
+ assert.equal(occupancyText('Station\nyou + 11 more'), 'you + 11 more');
113
+ const body = bodyBox({ x: 0, y: 0, z: 0 }, 2, 0.7, (x, y) => ({ x: 100 + x * 10, y: 100 - y * 10 }));
114
+ assert.deepEqual(body, { left: 85, right: 115, top: 72, bottom: 108 });
115
+ const lowered = bodyBox({ x: 0, y: 0.7, z: 0 }, 2, 0.7, (x, y) => ({ x: 100 + x * 10, y: 100 - y * 10 }), -0.7);
116
+ assert.deepEqual(lowered, body, 'drawn rig offset includes feet below the collider centre');
117
+ assert.equal(bodyBox({ x: 0, y: 0, z: 0 }, 2, 0.7, () => null).right, Infinity);
118
+ const dom = fakeDom({ viewW: 844, viewH: 390 });
119
+ const { makeChrome } = await import('../code/client/chrome.js');
120
+ const chrome = makeChrome({ onBack() {}, onAvatar() {}, avatarCount: 4 });
121
+ assert.ok(Array.isArray(chrome.padOccupancyControls()), 'actual chrome control pass is callable');
122
+ chrome.setCabinet({ id: 'cabinet', rev: 1, x: 200, y: 125, opacity: 1, card: { title: 'Cabinet', top: [{ username: 'QA', score: 42 }] } }, () => null);
123
+ const cabinet = dom.made.find((node) => node.attrs['aria-label'] === 'Cabinet: show the scores');
124
+ assert.ok(cabinet);
125
+ cabinet.rect = { left: 120, right: 280, top: 60, bottom: 125 };
126
+ const rail = document.createElement('div');
127
+ rail.dataset.hub = 'action-rail';
128
+ rail.rect = { left: 400, right: 500, top: 240, bottom: 284 };
129
+ cabinet.parent.appendChild(rail);
130
+ const controls = chrome.padOccupancyControls();
131
+ assert.ok(controls.some((rect) => rect.left === 400 && rect.right === 500), 'final action overflow rail is reserved');
132
+ assert.ok(controls.some((rect) => rect.left === 120 && rect.right === 280 && rect.top === 60 && rect.bottom === 125), 'rendered cabinet card is reserved');
133
+ const beside = placeLabels([{ id: 'pad', padOccupancy: true, text: 'you + 0 more', x: 200, y: 110, box: { left: 150, right: 250, top: 80, bottom: 110 } }], null, controls, { w: 844, h: 390 }, measure);
134
+ assert.equal(beside.length, 1);
135
+ assert.equal(touching(beside[0].box, cabinet.rect), false, 'pad text clears the actual cabinet target');
136
+ chrome.setLabels([{ id: 'pad', x: 200, y: 120, text: 'Station\nyou + 3 more', padOccupancy: true, box: { left: 130, right: 270, top: 80, bottom: 120 } }]);
137
+ const label = dom.made.find((node) => node.dataset.padOccupancy === '1');
138
+ assert.equal(label.style.left, '200px');
139
+ assert.equal(label.style.top, '120px');
140
+ assert.equal(label.style.whiteSpace, 'pre-line');
141
+ label.rect = { left: 130, right: 270, top: 80, bottom: 120 };
142
+ assert.deepEqual(chrome.crowdNameLabelBoxes(), [label.rect], 'crowd pass reads the final rendered label rectangle');
143
+ chrome.setLabels([{ id: 'pad', x: 200, y: 120, text: 'Station' }]);
144
+ assert.equal(label.style.whiteSpace, 'nowrap', 'OFF restores any reused opted-in label');
145
+ // With both HUD clearance and crowd names opted in, the late summary setter
146
+ // must preserve the actual final position of an ordinary unboxed label.
147
+ const hud = dom.made.find((node) => node.styles.textShadow?.includes('rgba(0,0,0,0.95)'));
148
+ dom.made.find(node => node.dataset.hub === 'hud-prompt').rect = { left: 200, right: 600, top: 310, bottom: 336, width: 400, height: 26 };
149
+ hud.rect = { left: 90, right: 360, top: 12, bottom: 106 };
150
+ chrome.setHudClear(true);
151
+ chrome.setHud({ title: 'Town', big: '12', text: 'Players nearby' }, null);
152
+ chrome.setLabels([{ id: 'ordinary', x: 200, y: 90, text: 'Start here' }]);
153
+ chrome.flushHudClear();
154
+ const ordinary = dom.made.find((node) => node.textContent === 'Start here');
155
+ const clearedTop = ordinary.style.top;
156
+ assert.notEqual(clearedTop, '90px', 'hud.clear moves the ordinary label before the late crowd pass');
157
+ chrome.setCrowdNameSummary({ id: 'crowd:summary', text: '+2 more', box: { left: 170, right: 230, top: 120, bottom: 144 } });
158
+ assert.equal(ordinary.style.top, clearedTop, 'crowd summary preserves the ordinary label final DOM position');
159
+ const summaryNode = dom.made.find((node) => node.textContent === '+2 more');
160
+ assert.equal(summaryNode.style.top, '144px');
161
+ chrome.setLabels([{ id: 'ordinary', x: 200, y: 90, text: 'Start here' }], true);
162
+ chrome.setCrowdNameSummary({ id: 'crowd:summary', text: '+3 more', box: { left: 180, right: 240, top: 122, bottom: 146 } });
163
+ assert.equal(dom.made.find((node) => node.textContent === '+3 more'), summaryNode, 'consecutive opted-in frames reuse the one summary node');
164
+ chrome.setLabels([{ id: 'ordinary', x: 200, y: 90, text: 'Start here' }]);
165
+ assert.equal(summaryNode.parent.children.includes(summaryNode), false, 'the ordinary OFF path destroys the retained summary node');
166
+ rail.remove();
167
+ chrome.setActions([{ id: 'one', label: 'Play' }, { id: 'two', label: 'Watch' }, { id: 'three', label: 'Details' }], () => {}, true, 1, true);
168
+ const launcher = dom.made.find((node) => node.attrs['aria-haspopup'] === 'dialog');
169
+ assert.ok(launcher);
170
+ launcher.style.display = 'block';
171
+ launcher.handlers.click({ stopPropagation() {} });
172
+ const sheet = dom.made.find((node) => node.dataset.hub === 'action-sheet');
173
+ assert.equal(sheet.parent.dataset.hub, 'action-backdrop');
174
+ sheet.rect = { left: 200, right: 760, top: 140, bottom: 390 };
175
+ assert.ok(chrome.padOccupancyControls().some((rect) => rect.left === 200 && rect.top === 140 && rect.right === 760), 'actual nested open action sheet is reserved');
176
+ chrome.dispose();
177
+ console.log('pad occupancy: eligible counts, privacy, stale state, override precedence, overlap and exact viewport clearance passed');