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,100 @@
1
+ // Actual browser geometry at the two phone sizes used for the HUD defects.
2
+ import assert from 'node:assert/strict';
3
+ import { readFile } from 'node:fs/promises';
4
+ import { fileURLToPath } from 'node:url';
5
+ import { chromium } from 'playwright-core';
6
+ import { launchChromium, logRenderer } from '../../../experiments/hub-town/qa/launch.mjs';
7
+ const root = new URL('../../../', import.meta.url);
8
+ const browser = await launchChromium(chromium, { executablePath: process.env.CHROME });
9
+ try {
10
+ const page = await browser.newPage({ hasTouch: true });
11
+ await page.route('http://hud.test/**', async route => {
12
+ const pathname = new URL(route.request().url()).pathname;
13
+ if (pathname === '/') return route.fulfill({ contentType: 'text/html', body: '<body style="margin:0"></body>' });
14
+ const url = new URL(`.${pathname}`, root);
15
+ assert(fileURLToPath(url).startsWith(fileURLToPath(root)));
16
+ await route.fulfill({ contentType: 'text/javascript', body: await readFile(url, 'utf8') });
17
+ });
18
+ for (const [width, height] of [[412, 870], [844, 390]]) {
19
+ await page.setViewportSize({ width, height });
20
+ await page.goto('http://hud.test/');
21
+ await logRenderer(page, 'HUD defects');
22
+ const result = await page.evaluate(async () => {
23
+ const { makeChrome } = await import('/kits/hub-game/code/client/chrome.js');
24
+ const { overlaps } = await import('/kits/hub-game/code/client/safeLayout.js');
25
+ const chrome = makeChrome({ avatarCount: 4, onBack() {}, onAvatar() {} });
26
+ chrome.setWorldLabelFocus(false);
27
+ chrome.showPicker(true, 0, undefined, { onPick() {} });
28
+ chrome.setCompanionBadge(true, 'Chirp', () => {});
29
+ chrome.setDoors([{ id: 'color', title: 'Color Call' }]);
30
+ chrome.talkPrompt('Chirp', true);
31
+ const caption = document.createElement('div');
32
+ caption.textContent = 'Castle Town · 1 here · Explore the town and meet your neighbours';
33
+ Object.assign(caption.style, { position: 'absolute', left: '0', right: '0', bottom: '22px', textAlign: 'center', font: 'italic 15px/1.4 Georgia, serif' });
34
+ document.body.append(caption);
35
+ chrome.safeSurface('engine-look', caption, 'text');
36
+ const rect = n => n.getBoundingClientRect();
37
+ const visible = n => rect(n).width > 0 && getComputedStyle(n).visibility !== 'hidden';
38
+ const navigation = [...document.querySelectorAll('button')].filter(n => ['Doors', 'Character', 'Invite a friend', 'Chat with Chirp'].includes(n.textContent));
39
+ chrome.flushWorldLabels();
40
+ const captionHits = navigation.filter(visible).filter(n => overlaps(rect(n), rect(caption))).map(n => n.textContent);
41
+ const firstCaption = caption.style.translate;
42
+ chrome.flushWorldLabels();
43
+ const stableCaption = firstCaption === caption.style.translate;
44
+ // The rail itself is a world-layout obstacle without safeInsets enabled.
45
+ chrome.setActions([{ id: 'short', label: 'Short trip' }, { id: 'bay', label: 'Bay trip' }, { id: 'next', label: 'Next' }], () => {}, true, 1, true);
46
+ await new Promise(resolve => requestAnimationFrame(resolve));
47
+ const rail = document.querySelector('[data-hub="action-rail"]');
48
+ const railBox = rect(rail);
49
+ chrome.beginWorldLabels();
50
+ chrome.setPointers([{ id: 'goal:house', x: railBox.left + railBox.width / 2, y: railBox.top + railBox.height / 2, text: 'your house · 80 m', angle: 0 }]);
51
+ chrome.flushWorldLabels();
52
+ const pointer = [...document.querySelectorAll('span')].find(n => n.textContent === 'your house · 80 m').parentElement;
53
+ const pointerVisible = visible(pointer);
54
+ const pointerHits = overlaps(rect(pointer), rect(rail));
55
+ const railHits = navigation.filter(visible).filter(n => overlaps(rect(n), rect(rail))).map(n => n.textContent);
56
+ chrome.setToast('Back from Color Call: win · 2 pts');
57
+ const toast = document.querySelector('[data-hub="toast"]');
58
+ chrome.setRibbon({ x: innerWidth / 2, y: rect(toast).bottom }, 'Color Call: win · 2 pts');
59
+ const ribbon = [...document.querySelectorAll('div')].find(n => n.textContent === 'Color Call: win · 2 pts');
60
+ const toastHits = overlaps(rect(toast), rect(ribbon));
61
+ chrome.clearActions();
62
+ chrome.beginWorldLabels(); chrome.flushWorldLabels();
63
+ const restored = visible(pointer);
64
+ // No full-width gap fits the caption: a bounded narrow slot must.
65
+ const blockers = [[0, 0, innerWidth, innerHeight * .5], [0, innerHeight * .52, innerWidth * .4, innerHeight * .42], [0, innerHeight - 24, innerWidth, 24]].map(([left, top, width, height], i) => {
66
+ const n = document.createElement('div');
67
+ Object.assign(n.style, { position: 'fixed', left: `${left}px`, top: `${top}px`, width: `${width}px`, height: `${height}px` });
68
+ document.body.append(n); chrome.safeSurface(`dense-${i}`, n, 'control'); return n;
69
+ });
70
+ chrome.beginWorldLabels(); chrome.flushWorldLabels();
71
+ const reflowBox = rect(caption);
72
+ const boundedReflow = reflowBox.top >= 8 && reflowBox.bottom <= innerHeight - 8 &&
73
+ reflowBox.left >= 8 && reflowBox.right <= innerWidth - 8 && !blockers.some(n => overlaps(rect(n), reflowBox));
74
+ blockers.forEach((n, i) => { chrome.safeSurface(`dense-${i}`, null); n.remove(); });
75
+ chrome.beginWorldLabels(); chrome.flushWorldLabels();
76
+ const reflowRestored = caption.style.width === '' && caption.style.right === '0px';
77
+ const sideWidth = (innerWidth - 196) / 2;
78
+ const sides = [0, sideWidth + 196].map((left, i) => {
79
+ const n = document.createElement('div');
80
+ Object.assign(n.style, { position: 'fixed', left: `${left}px`, top: '0', width: `${sideWidth}px`, height: '100vh' });
81
+ document.body.append(n); chrome.safeSurface(`side-${i}`, n, 'control'); return n;
82
+ });
83
+ chrome.beginWorldLabels(); chrome.flushWorldLabels();
84
+ const narrowBox = rect(caption);
85
+ const narrowLane = visible(caption) && narrowBox.width <= 180 && narrowBox.top >= 8 && narrowBox.bottom <= innerHeight - 8 && !sides.some(n => overlaps(rect(n), narrowBox));
86
+ sides.forEach((n, i) => { chrome.safeSurface(`side-${i}`, null); n.remove(); });
87
+ chrome.dispose(); caption.remove();
88
+ return { captionHits, stableCaption, pointerVisible, pointerHits, railHits, toastHits, restored, boundedReflow, reflowRestored, narrowLane };
89
+ });
90
+ assert.deepEqual(result.captionHits, [], 'caption clears navigation and Chirp');
91
+ assert(result.stableCaption, 'caption translation does not accumulate');
92
+ assert(result.pointerVisible && result.restored, 'guidance is visible and restores in the same frame');
93
+ assert.equal(result.pointerHits, false, 'guidance clears compact action rail');
94
+ assert.deepEqual(result.railHits, [], 'rail clears navigation and Chirp');
95
+ assert(result.narrowLane, 'caption fits a measured 180px lane');
96
+ assert(result.boundedReflow && result.reflowRestored, 'dense caption reflows in bounds and restores original width');
97
+ assert.equal(result.toastHits, false, 'return banner clears result ribbon');
98
+ console.log(`${width}x${height}: caption, guidance, rail and return banner passed`);
99
+ }
100
+ } finally { await browser.close(); }
@@ -0,0 +1,224 @@
1
+ import assert from 'node:assert/strict';
2
+ import { readFileSync } from 'node:fs';
3
+ import { PerspectiveCamera } from 'three';
4
+ import { makeHudRate } from '../code/client/hudRate.js';
5
+ import { makeChrome } from '../code/client/chrome.js';
6
+ import { fakeDom } from './fixtures/fake-dom.mjs';
7
+ import * as Hub from '../code/client/state.js';
8
+ import { makeAskSlot, padsAt as askPadsAt } from '../code/client/askSlot.js';
9
+ import { attend, makeAttention } from '../code/client/attention.js';
10
+ import { goalAt } from '../code/client/labelsNear.js';
11
+ import { mapWorldPoint, offsetWorldPoint, worldLabelFocus } from '../code/client/worldLabels.js';
12
+ import { bodyBox } from '../code/client/padOccupancy.js';
13
+ import { goalPointers, goalText, pointerAt } from '../code/client/together.js';
14
+ import { makeSay, REACTIONS } from '../code/client/say.js';
15
+ import { chatModerationEnabled } from '../code/client/chatModeration.js';
16
+ import { joinErrorText } from '../code/client/joinError.js';
17
+ import { padCuesEnabled } from '../code/client/padCues.js';
18
+
19
+ const inputEvents = ['pointerdown', 'pointerup', 'touchstart', 'touchend', 'keydown', 'keyup'];
20
+ function inputTarget() {
21
+ const listeners = new Map();
22
+ return {
23
+ listeners,
24
+ addEventListener(type, fn, capture) {
25
+ assert.equal(capture, true, `${type} must precede stopped bubbling`);
26
+ assert.ok(!listeners.has(type), `${type} installed once`);
27
+ listeners.set(type, fn);
28
+ },
29
+ removeEventListener(type, fn, capture) {
30
+ assert.equal(capture, true);
31
+ assert.equal(listeners.get(type), fn);
32
+ listeners.delete(type);
33
+ },
34
+ fire(type) {listeners.get(type)?.();},
35
+ };
36
+ }
37
+ for (const weakest of [false, true]) {
38
+ const target = inputTarget(), rate = makeHudRate(target);
39
+ assert.deepEqual(Array.from({ length: 6 }, () => rate.frame(weakest, 'same')),
40
+ weakest ? [true, false, true, false, true, false] : [true, true, true, true, true, true]);
41
+ assert.deepEqual([...target.listeners.keys()], inputEvents);
42
+ rate.dispose();
43
+ assert.equal(target.listeners.size, 0);
44
+ }
45
+ for (const event of inputEvents) {
46
+ const target = inputTarget(), rate = makeHudRate(target);
47
+ assert.equal(rate.frame(true, 'same'), true);
48
+ target.fire(event);
49
+ assert.equal(rate.frame(true, 'same'), true, `${event} wakes a skip frame`);
50
+ assert.equal(rate.frame(true, 'same'), false, `${event} resets parity and clears input`);
51
+ assert.equal(rate.frame(true, 'same'), true);
52
+ rate.dispose();
53
+ }
54
+ {
55
+ const rate = makeHudRate(inputTarget());
56
+ assert.equal(rate.frame(true, 'Grab'), true);
57
+ assert.equal(rate.frame(true, 'Throw'), true, 'prompt change wakes a skip frame');
58
+ assert.equal(rate.frame(true, 'Throw'), false);
59
+ assert.equal(rate.frame(false, 'Throw'), true, 'leaving Weakest ticks immediately');
60
+ assert.equal(rate.frame(false, 'Throw'), true);
61
+ assert.equal(rate.frame(true, 'Throw'), true, 'returning to Weakest starts with a tick');
62
+ rate.dispose();
63
+ }
64
+ console.log('HUD rate: cadence, capture input, prompt changes, profile transitions and disposal passed');
65
+
66
+ // Like test-weakest-tier, exercise production Hub methods with only the
67
+ // engine/avatar boundary substituted. Chrome and its prompt signature are real.
68
+ const source = readFileSync(new URL('../code/systems/hub.js', import.meta.url), 'utf8');
69
+ const method = name => {
70
+ const start = source.indexOf(` ${name}(`);
71
+ assert.ok(start >= 0, name);
72
+ return source.slice(start, source.indexOf('\n }\n', start) + 4);
73
+ };
74
+ const projectStart = source.indexOf('function project(');
75
+ const project = source.slice(projectStart, source.indexOf('\n}\n', projectStart) + 2);
76
+ const constants = ['GOALS_MAX', 'GOAL_NEAR_M', 'RIBBON_MS', 'TOAST_MS', 'WENT_ASK_MS', 'HERE_CUE_MS']
77
+ .map(name => source.match(new RegExp(`^const ${name} = .*;$`, 'm'))[0]).join('\n');
78
+ const dependencies = { Hub, makeHudRate, askPadsAt, attend, goalAt, worldLabelFocus, mapWorldPoint, offsetWorldPoint,
79
+ bodyBox, goalPointers, goalText, pointerAt, REACTIONS, chatModerationEnabled, joinErrorText, padCuesEnabled,
80
+ Avatar: { current: scene => scene.persistent.avatar, colorsAvailable: () => false, style: () => 'toon',
81
+ currentColor: () => 0, top: () => 1.5, drawn: () => 0 },
82
+ Cabinets: { nearest: () => null }, kitBackNeeded: () => false,
83
+ loadingCover: null, clearShot() {},
84
+ };
85
+ const Harness = new Function(...Object.keys(dependencies), `${constants}\n${project}
86
+ return class { ${['drawChrome', 'drawPanelControls', 'drawNearPrompt', 'dispose'].map(method).join('\n')} };`
87
+ )(...Object.values(dependencies));
88
+ const panelSetters = ['showPicker', 'setDoors', 'setPeople', 'setSay', 'setFeed', 'setHud', 'setToast'];
89
+ const motionSetters = ['setWorldViewport', 'setPointers', 'setLabels', 'setCabinet', 'setRibbon', 'setWorldAvatar', 'setCompanionBadge', 'setCompanionTalk'];
90
+
91
+ for (const tier of [undefined, { active: false, profile: 'weakest' }, { active: true, profile: 'middle' },
92
+ { active: true, profile: 'low' }, { active: true, profile: 'high' }, { active: true, profile: 'weakest' }]) {
93
+ Hub.clear();
94
+ Hub.hub.place = { id: 'town', companion: true, companionChat: { name: 'Guide' } };
95
+ Hub.hub.saidEvents.push({ player: 'self', r: 0 });
96
+ Hub.hub.hud = { text: 'Town' };
97
+ Hub.hub.labels = { sign: { text: 'Street', style: 'sign' }, goal: { text: 'Go', style: 'goal' } };
98
+ const dom = fakeDom({ viewW: 400, viewH: 800 }), target = inputTarget();
99
+ Object.assign(window, {
100
+ addEventListener(type, fn, capture) {if (capture === true) {target.addEventListener(type, fn, capture);}},
101
+ removeEventListener(type, fn, capture) {if (capture === true) {target.removeEventListener(type, fn, capture);}},
102
+ });
103
+ const local = { id: 'self', components: { Transform: { x: 0, y: 0, z: 0 } } };
104
+ const actors = new Map([['sign', { components: { Transform: { x: 1, y: 0, z: 0 } } }],
105
+ ['goal', { components: { Transform: { x: 1.5, y: 0, z: 0 } } }]]);
106
+ actors.set('self', local);
107
+ const camera = new PerspectiveCamera(60, 0.5, 0.1, 100);
108
+ camera.position.set(0, 3, 10); camera.lookAt(0, 0, 0); camera.updateMatrixWorld();
109
+ const scene = { persistent: { hubTickets: [], avatar: 0 }, files: {}, data: { engine: {} },
110
+ multiplayer: { net: { others: () => new Map(), selfId: () => 'self' } },
111
+ three: { camera }, getActor: id => actors.get(id), getActors: () => [...actors.values()] };
112
+ const chrome = makeChrome({ onBack() {}, onAvatar: i => {scene.persistent.avatar = i;}, avatarCount: 2 });
113
+ chrome.measureLabel = null; // Use Hub's ordinary projected-label path.
114
+ const calls = new Map(), order = [];
115
+ for (const name of [...panelSetters, ...motionSetters]) {
116
+ const original = chrome[name];
117
+ chrome[name] = (...args) => {order.push(name); const history = calls.get(name) ?? []; history.push(args); calls.set(name, history); return original.apply(chrome, args);};
118
+ }
119
+ const system = Object.assign(new Harness(), { chrome, scene, weakestTier: tier, trip: null, pendingEnd: null,
120
+ toast: { text: '', until: 0 }, askSlot: makeAskSlot(), attention: makeAttention(),
121
+ ask: () => null, retireExpiredAsk() {}, startBeside() {}, people: () => [],
122
+ together: { beside: () => null, arrivals: () => [], partyLine: () => null,
123
+ pointers: (scene, local, cam, view) => [pointerAt(cam, view, { x: -1, y: 1, z: 0 }, 'guide', 'Friend')] },
124
+ companion: { dispose() {}, labels: () => [], screen: (cam, view, project) => project(cam, 2, 1.6, 0, view) },
125
+ talk: { talking: () => false, talkingWith: () => null },
126
+ chat: { frame() {}, incoming: [], peers: null, available: () => false },
127
+ say: makeSay(), idle: { labels: () => [] }, markItems: () => [],
128
+ });
129
+ const weakest = tier?.active && tier.profile === 'weakest';
130
+ const draw = frame => {
131
+ // Match afterBehaviors: the existing snapshot wraps every draw, including skips.
132
+ chrome.beginLayoutFrame();
133
+ system.drawChrome(scene, local, frame * 60);
134
+ chrome.endLayoutFrame();
135
+ };
136
+ for (let frame = 0; frame < 4; frame++) {
137
+ camera.position.x += 0.1; camera.updateMatrixWorld();
138
+ draw(frame);
139
+ }
140
+ for (const name of motionSetters) {assert.equal(calls.get(name).length, 4, `${tier?.profile}: ${name} every frame`);}
141
+ for (const name of panelSetters) {assert.equal(calls.get(name).length, weakest ? 2 : 4, `${tier?.profile}: ${name} cadence`);}
142
+ assert.notEqual(calls.get('setLabels')[0][0][0].x, calls.get('setLabels')[1][0][0].x, 'world label follows moving camera on skip');
143
+ for (const id of ['goal:goal', 'guide']) {
144
+ assert.notEqual(calls.get('setPointers')[0][0].find(item => item.id === id).x,
145
+ calls.get('setPointers')[1][0].find(item => item.id === id).x, `${id} follows moving camera on skip`);
146
+ }
147
+ assert.notEqual(calls.get('setLabels')[0][0].find(item => item.id === 'react:self').x,
148
+ calls.get('setLabels')[1][0].find(item => item.id === 'react:self').x, 'speech bubble follows moving camera on skip');
149
+
150
+ if (!weakest) {
151
+ const legacyOrder = ['showPicker', 'setDoors', 'setPeople', 'setSay', 'setFeed', 'setHud', 'setWorldViewport',
152
+ 'setPointers', 'setLabels', 'setCompanionBadge', 'setCompanionTalk', 'setCabinet', 'setRibbon', 'setToast', 'setWorldAvatar'];
153
+ assert.deepEqual(order, Array.from({ length: 4 }, () => legacyOrder).flat(), 'other profiles retain setter order');
154
+ }
155
+ if (weakest) {
156
+ draw(4); // Tick; frame 5 would skip.
157
+ const pick = dom.made.find(node => node.getAttribute('aria-label') === 'Character: Petal');
158
+ target.fire('pointerdown'); target.fire('pointerup');
159
+ pick.handlers.click({ stopPropagation() {} });
160
+ assert.equal(pick.getAttribute('aria-pressed'), 'false');
161
+ draw(5);
162
+ assert.equal(pick.getAttribute('aria-pressed'), 'true', 'press state updates on the would-be skip frame');
163
+ const count = calls.get('setHud').length;
164
+ draw(6);
165
+ assert.equal(calls.get('setHud').length, count, 'forced input tick resets parity');
166
+ draw(7);
167
+ chrome.grabPrompt('Grab');
168
+ draw(8);
169
+ assert.equal(calls.get('setHud').length, count + 2, 'pickup prompt wakes all panels');
170
+ draw(9);
171
+ assert.equal(calls.get('setHud').length, count + 2);
172
+ chrome.talkPrompt('Biscuit');
173
+ draw(10);
174
+ assert.equal(calls.get('setHud').length, count + 3, 'talk prompt wakes all panels');
175
+ Hub.hub.prompts = [{ id: 'counter', verb: 'Trade' }];
176
+ draw(11);
177
+ assert.equal(calls.get('setHud').length, count + 4, 'act prompt wakes all panels');
178
+ chrome.sitPrompt('Sit');
179
+ draw(12);
180
+ assert.equal(calls.get('setHud').length, count + 5, 'sit prompt wakes all panels');
181
+ const act = document.createElement('button');
182
+ act.textContent = 'Trade'; act.setAttribute('aria-label', 'Trade');
183
+ chrome.safeSurface('act-prompt:counter', act, 'control');
184
+ draw(13);
185
+ assert.equal(calls.get('setHud').length, count + 6, 'visible act prompt wakes all panels');
186
+ system.together.beside = () => ({ playerId: 'friend', username: 'Friend' });
187
+ draw(14);
188
+ assert.equal(calls.get('setHud').length, count + 7, 'nearby invitation prompt wakes all panels');
189
+ system.ask = () => ({ key: 'ask', text: 'Join?', yes: 'Yes', no: 'No' });
190
+ draw(15);
191
+ assert.equal(calls.get('setHud').length, count + 8, 'question card wakes all panels');
192
+ const toggle = dom.made.find(node => node.textContent === 'Character');
193
+ toggle.handlers.pointerdown({ stopPropagation() {} });
194
+ draw(16);
195
+ assert.equal(calls.get('setHud').length, count + 9, 'menu opening wakes all panels');
196
+ // Each draw below lands on a would-be skip frame: the previous one ticked.
197
+ Hub.hub.doors = [...(Hub.hub.doors ?? [])];
198
+ draw(17);
199
+ assert.equal(calls.get('setDoors').length, count + 10, 'a new door offer replaces Go buttons at once');
200
+ Hub.hub.hud = { text: 'Reported. Thanks.' };
201
+ draw(18);
202
+ assert.equal(calls.get('setHud').length, count + 11, 'HUD copy wakes all panels');
203
+ system.toast = { text: 'Saved', until: performance.now() + 5000 };
204
+ draw(19);
205
+ assert.equal(calls.get('setToast').length, count + 12, 'a toast wakes all panels');
206
+ Hub.hub.hud = { text: 'Reported. Thanks.', timer: { since: 0 } };
207
+ draw(20);
208
+ draw(21);
209
+ assert.equal(calls.get('setHud').length, count + 13, 'a running timer alone waits for the next tick');
210
+ const writes = dom.log.length;
211
+ chrome.hudPromptSignature();
212
+ assert.equal(dom.log.length, writes, 'prompt signature makes no layout reads or DOM writes');
213
+ assert.equal(target.listeners.size, 6, 'one listener set after many frames');
214
+ // Run the production dispose method, substituting unrelated owners.
215
+ Object.assign(system, { clearPadReadability() {}, environment: { restore() {} }, idle: null });
216
+ system.weakestTier = { ...tier, restore() {} };
217
+ system.dispose();
218
+ assert.equal(target.listeners.size, 0, 'Hub disposal removes capture listeners');
219
+ } else {
220
+ chrome.dispose();
221
+ }
222
+ }
223
+ Hub.clear();
224
+ console.log('Hub HUD: Weakest-only panel cadence, per-frame projection, same-frame press/prompt updates and disposal passed');
@@ -0,0 +1,83 @@
1
+ // Exercise the real CSS cascade: safe-inset corrections must not reveal an
2
+ // empty HUD score row or override the renderer's subsequent visibility changes.
3
+ import assert from 'node:assert/strict';
4
+ import { readFile } from 'node:fs/promises';
5
+ import { fileURLToPath } from 'node:url';
6
+ import { chromium } from 'playwright-core';
7
+ import { launchChromium } from '../../../experiments/hub-town/qa/launch.mjs';
8
+
9
+ const root = new URL('../../../', import.meta.url);
10
+ const browser = await launchChromium(chromium, { executablePath: process.env.CHROME });
11
+ try {
12
+ const page = await browser.newPage();
13
+ await page.route('**/*', async route => {
14
+ const url = new URL(route.request().url());
15
+ assert.equal(url.origin, 'http://layout.test');
16
+ if (url.pathname === '/') {
17
+ return route.fulfill({ contentType: 'text/html', body: '<script type="importmap">{"imports":{"three":"/node_modules/three/build/three.module.js"}}</script><body style="margin:0"></body>' });
18
+ }
19
+ const file = new URL(`.${url.pathname}`, root);
20
+ assert(fileURLToPath(file).startsWith(fileURLToPath(root)));
21
+ await route.fulfill({ contentType: 'text/javascript', body: await readFile(file, 'utf8') });
22
+ });
23
+ let checks = 0;
24
+ for (const [width, height] of [[844, 390], [412, 915]]) {
25
+ await page.setViewportSize({ width, height });
26
+ await page.goto('http://layout.test/');
27
+ const rows = await page.evaluate(async () => {
28
+ const { makeChrome } = await import('/kits/hub-game/code/client/chrome.js');
29
+ const chrome = makeChrome({ avatarCount: 1, onBack() {}, onAvatar() {}, safeInsets: true });
30
+ const title = document.querySelector('[data-hub-copy="subtitle"]');
31
+ const hud = title.parentElement;
32
+ const score = hud.children[1];
33
+ const prompt = document.querySelector('[data-hub="hud-prompt"]');
34
+ const visible = node => getComputedStyle(node).display !== 'none' &&
35
+ getComputedStyle(node).visibility !== 'hidden' && node.getBoundingClientRect().height > 0;
36
+ const stages = [
37
+ ['title only', { title: 'You have a house here', text: 'Step on its pad.' }, null],
38
+ ['score', { title: 'Town', big: '12', text: 'Keep going.' }, null],
39
+ ['timer', { title: 'Town', text: 'Time remaining.' }, 1.5],
40
+ ['empty score again', { title: 'You have a house here', text: 'Step on its pad.' }, null],
41
+ ['score only', { big: '7' }, null],
42
+ ['zero timer', { title: 'Town', text: 'Finished.' }, 0],
43
+ ['no HUD', null, null],
44
+ ['title restored', { title: 'Town', text: 'Step on its pad.' }, null],
45
+ ];
46
+ const rows = [];
47
+ try {
48
+ for (const [name, spec, timer] of stages) {
49
+ chrome.setHudClear(true);
50
+ chrome.setHud(spec, timer);
51
+ // Flush the actual safe-inset controller after the renderer, then
52
+ // let its observer/frame cadence run before reading computed CSS.
53
+ chrome.flushSafeInsets();
54
+ await new Promise(resolve => requestAnimationFrame(() => requestAnimationFrame(resolve)));
55
+ chrome.frameSafeInsets();
56
+ rows.push({ name, title: visible(title) && visible(hud), score: visible(score) && visible(hud),
57
+ prompt: visible(prompt), scoreText: score.textContent, scoreDisplay: getComputedStyle(score).display,
58
+ scoreHeight: score.getBoundingClientRect().height });
59
+ }
60
+ } finally {
61
+ chrome.dispose();
62
+ }
63
+ return rows;
64
+ });
65
+ const expected = [
66
+ [true, false, true, ''], [true, true, true, '12'], [true, true, true, '1.5'],
67
+ [true, false, true, ''], [false, true, false, '7'], [true, true, true, '0.0'],
68
+ [false, false, false, '0.0'], [true, false, true, ''],
69
+ ];
70
+ for (let i = 0; i < rows.length; i++) {
71
+ const row = rows[i];
72
+ assert.deepEqual([row.title, row.score, row.prompt, row.scoreText], expected[i], `${width}x${height}: ${JSON.stringify(row)}`);
73
+ if (expected[i][3] === '') {
74
+ assert.equal(row.scoreDisplay, 'none', `${width}x${height}: ${row.name} must keep the empty score hidden`);
75
+ assert.equal(row.scoreHeight, 0, `${width}x${height}: ${row.name} must paint no empty score background`);
76
+ }
77
+ checks++;
78
+ }
79
+ }
80
+ console.log(`HUD safe-inset visibility: ${checks} real DOM transition checks passed`);
81
+ } finally {
82
+ await browser.close();
83
+ }