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
@@ -6,6 +6,7 @@
6
6
  // or told no after a place that asked. `npm run check` runs it.
7
7
 
8
8
  import assert from 'node:assert/strict';
9
+ import { firstPromptSentence, promptShift, warnHudCopy } from '../code/client/hudCopy.js';
9
10
  import {
10
11
  BIG_MIN_PX,
11
12
  BIG_PX,
@@ -190,6 +191,15 @@ function fakeDom(view) {
190
191
  append(...kids) {
191
192
  kids.forEach((kid) => self.appendChild(kid));
192
193
  },
194
+ insertBefore(child, before) {
195
+ if (child.parent) {
196
+ child.parent.children = child.parent.children.filter((c) => c !== child);
197
+ }
198
+ child.parent = self;
199
+ const at = self.children.indexOf(before);
200
+ self.children.splice(at < 0 ? self.children.length : at, 0, child);
201
+ return child;
202
+ },
193
203
  remove() {
194
204
  if (self.parent) {
195
205
  self.parent.children = self.parent.children.filter((c) => c !== self);
@@ -248,14 +258,77 @@ function rig(view = PHONE) {
248
258
  const dom = fakeDom(view);
249
259
  const chrome = makeChrome({ onBack() {}, onAvatar() {}, avatarCount: 4 });
250
260
  const root = dom.body.children[0];
251
- const hud = root.children.find((c) => c.styles.maxWidth === '70vw');
252
- const [hudTitle, hudBig, hudText] = hud.children;
253
- const labels = root.children[root.children.indexOf(hud) + 1];
254
- const pointers = dom.made.find((c) => c.parent === root && c !== labels && c.styles.inset === '0' && c.styles.position === 'absolute' && !c.styles.background && c.children.length === 0 && dom.made.indexOf(c) > dom.made.indexOf(labels));
261
+ const hud = root.children.find((c) => c.styles.textShadow?.includes('rgba(0,0,0,0.95)'));
262
+ const [hudTitle, hudBig] = hud.children;
263
+ const hudText = dom.made.find(node => node.dataset.hub === 'hud-prompt');
264
+ hudText.rect = { left: view.viewW * 0.2, right: view.viewW * 0.8, top: view.viewH - 80, bottom: view.viewH - 54, width: view.viewW * 0.6, height: 26 };
265
+ // v1.38: the pointers' layer is under the labels' (a speech bubble is read over a chip).
266
+ const pointers = root.children[root.children.indexOf(hud) + 2];
267
+ const labels = root.children[root.children.indexOf(hud) + 3];
255
268
  const cabinet = dom.made.find((c) => c.dataset.hub === 'cabinet');
256
269
  return { ...dom, chrome, root, hud, hudTitle, hudBig, hudText, labels, pointers, cabinet };
257
270
  }
258
271
 
272
+ test('v1.52: the cover line is smaller, centred and phone-wrappable, and absent without text', () => {
273
+ const r = rig();
274
+ const cover = r.root.children[0];
275
+ const [title] = cover.children;
276
+ r.chrome.setCover(1, 'Town');
277
+ assert.equal(title.textContent, 'Town');
278
+ assert.equal(cover.children.length, 1, 'no second line until a place asks');
279
+ assert.equal(cover.styles.flexDirection, undefined, 'original cover layout');
280
+ r.chrome.setCover(1, 'Town', 'Your lantern will be waiting by the well');
281
+ const line = cover.children[1];
282
+ assert.equal(line.textContent, 'Your lantern will be waiting by the well');
283
+ assert.equal(line.styles.display, 'block');
284
+ assert.ok(parseFloat(line.styles.fontSize) < parseFloat(title.styles.fontSize));
285
+ assert.equal(line.styles.textAlign, 'center');
286
+ assert.equal(line.styles.overflowWrap, 'anywhere');
287
+ assert.equal(line.styles.width, 'min(84vw, 420px)');
288
+ assert.equal(line.styles.fontFamily, undefined, 'both lines inherit the chrome font');
289
+ r.chrome.setCover(0);
290
+ assert.equal(line.textContent, '');
291
+ assert.equal(line.styles.display, 'none');
292
+ r.chrome.setCover(1, 'Another place');
293
+ assert.equal(line.styles.display, 'none', 'no old line on the next cover');
294
+ });
295
+
296
+ test('v1.52: leaving toasts wrap a 120-character unbroken line and restore the ordinary toast styles', () => {
297
+ for (const view of [PHONE, SIDEWAYS, { viewW: 1280, viewH: 800 }]) {
298
+ const r = rig(view);
299
+ const toast = r.root.children.find((c) => c.dataset.hub === 'toast');
300
+ r.chrome.setToast('Ordinary feedback');
301
+ const original = { ...toast.styles, display: 'none' };
302
+ assert.equal(toast.styles.width, 'max-content');
303
+ assert.equal(toast.styles.maxWidth, view.viewW > view.viewH ? 'min(42vw, 420px)' : 'calc(100vw - 24px)');
304
+ assert.equal(toast.styles.textAlign, 'center');
305
+ r.log.length = 0;
306
+ r.chrome.setToast('Ordinary feedback');
307
+ assert.equal(r.log.some((entry) => entry.startsWith(`${toast.id} style.`)), false, 'an unchanged toast writes no styles');
308
+ const line = 'x'.repeat(120);
309
+ r.chrome.setToast(line, { wrap: true });
310
+ assert.equal(toast.textContent, line);
311
+ assert.equal(toast.styles.maxWidth, 'min(90vw, 480px)');
312
+ assert.equal(toast.styles.overflowWrap, 'anywhere');
313
+ assert.equal(toast.styles.textAlign, 'center');
314
+ r.chrome.setToast(`Back from Foot Race · ${line}`, { wrap: true });
315
+ assert.equal(toast.styles.maxWidth, 'min(90vw, 480px)');
316
+ r.chrome.setToast('Invited Ada to your party');
317
+ const reset = { maxWidth: original.maxWidth, overflowWrap: '', textAlign: original.textAlign };
318
+ assert.deepEqual(toast.styles, { ...original, ...reset, display: 'block' });
319
+ // Restore actual prior inline values, not just the current empty defaults.
320
+ const prior = { maxWidth: '240px', overflowWrap: 'normal', textAlign: 'left' };
321
+ Object.assign(toast.style, prior);
322
+ r.chrome.setToast(line, { wrap: true });
323
+ r.chrome.setToast('');
324
+ assert.deepEqual(toast.styles, { ...original, ...prior });
325
+ // Even a wrap option on an empty toast must restore the old styles.
326
+ r.chrome.setToast(line, { wrap: true });
327
+ r.chrome.setToast('', { wrap: true });
328
+ assert.deepEqual(toast.styles, { ...original, ...prior });
329
+ }
330
+ });
331
+
259
332
  const SPEC = { title: 'Lantern Run', big: '12.3', text: 'find the lantern and bring it home' };
260
333
  const LABELS = [
261
334
  { id: 'sign', x: 180, y: 90, text: 'Start here', speech: false, npc: false, opacity: 1 },
@@ -293,11 +366,12 @@ const styleOf = (node) => Object.fromEntries(Object.entries(node.styles).filter(
293
366
  const tree = (node) => ({ id: node.id, text: node.children.length ? undefined : node.textContent, style: styleOf(node), kids: node.children.map(tree) });
294
367
 
295
368
  // The HUD as it is today, written here so a change to the default shows.
369
+ const COPY = { background: 'rgba(20,16,12,0.78)', borderRadius: '14px', padding: '4px 8px', boxSizing: 'border-box', width: 'max-content', maxWidth: '100%', margin: '0 auto', lineHeight: '1.3', whiteSpace: 'normal', overflowWrap: 'anywhere', overflow: 'hidden', display: 'block' };
296
370
  const TODAY = {
297
371
  hud: { position: 'absolute', top: 'max(12px, env(safe-area-inset-top))', left: '50%', transform: 'translateX(-50%)', textAlign: 'center', textShadow: '0 0 2px rgba(0,0,0,0.95), 0 0 2px rgba(0,0,0,0.95), 0 1px 4px rgba(0,0,0,0.75), 0 0 10px rgba(0,0,0,0.45)', display: 'block', maxWidth: '70vw' },
298
- title: { fontSize: '13px', opacity: '0.85', letterSpacing: '0.06em', textTransform: 'uppercase' },
299
- big: { fontSize: '56px', fontWeight: '800', lineHeight: '1.05', display: 'block' },
300
- text: { fontSize: '14px', fontWeight: '500' },
372
+ title: { ...COPY, fontSize: '13px', maxHeight: '41.8px', letterSpacing: '0.06em', textTransform: 'uppercase' },
373
+ big: { background: 'rgba(20,16,12,0.78)', borderRadius: '14px', padding: '0 8px', boxSizing: 'border-box', width: 'max-content', maxWidth: '100%', margin: '4px auto 0', overflowWrap: 'anywhere', fontSize: '56px', fontWeight: '800', lineHeight: '1.05', display: 'block' },
374
+ text: { ...COPY, position: 'absolute', left: 'max(16px, env(safe-area-inset-left))', right: 'max(16px, env(safe-area-inset-right))', bottom: 'max(54px, calc(env(safe-area-inset-bottom) + 48px))', fontSize: '14px', overflow: 'visible', maxWidth: 'min(60vw, 560px, calc(100vw - max(16px, env(safe-area-inset-left)) - max(16px, env(safe-area-inset-right))))', fontWeight: '500', textAlign: 'center', zIndex: '2' },
301
375
  };
302
376
 
303
377
  test('never told: the HUD, labels and pointers are styled and placed as today', () => {
@@ -308,13 +382,15 @@ test('never told: the HUD, labels and pointers are styled and placed as today',
308
382
  assert.deepEqual(styleOf(r.hudTitle), TODAY.title);
309
383
  assert.deepEqual(styleOf(r.hudBig), TODAY.big);
310
384
  assert.deepEqual(styleOf(r.hudText), TODAY.text);
311
- // Each label is where it was asked to be, under the HUD or not.
385
+ // Each label is where it was asked to be, under the HUD or not -- except
386
+ // an emote's emoji, which is drawn just under the HUD's box (106 px, an 8 px
387
+ // gap, its own height to its anchored bottom: `emoteBubble.js`).
312
388
  const top = Object.fromEntries(r.labels.children.map((c) => [c.textContent, c.styles.top]));
313
- assert.deepEqual(top, { 'Start here': '90px', 'Take the lantern to the well.': '60px', IT: '80px', Well: '400px', '👋': '70px' });
389
+ assert.deepEqual(top, { 'Start here': '90px', 'Take the lantern to the well.': '60px', IT: '80px', Well: '400px', '👋': '138px' });
314
390
  assert.deepEqual(r.pointers.children.map((c) => c.styles.top), ['84px', '95px', '500px']);
315
391
  // Nothing of a clear HUD was written anywhere.
316
- for (const node of [r.hud, r.hudBig, r.hudText]) {
317
- assert.ok(!r.log.some((line) => line.startsWith(`${node.id} `) && /overflow|maxHeight|webkit|textOverflow|margin|whiteSpace/.test(line)), node.id);
392
+ for (const node of [r.hud, r.hudBig]) {
393
+ assert.ok(!r.log.some((line) => line.startsWith(`${node.id} `) && /overflow=|maxHeight|webkit|textOverflow|whiteSpace/.test(line)), node.id);
318
394
  }
319
395
  });
320
396
 
@@ -352,7 +428,7 @@ test('asked: a big line over text is 32 px on one line; alone it is 56 px again'
352
428
  assert.equal(r.hudBig.styles.fontSize, '56px');
353
429
  assert.equal(r.hudBig.styles.whiteSpace, '');
354
430
  assert.equal(r.hudBig.styles.overflow, '');
355
- assert.equal(r.hudBig.styles.maxWidth, '');
431
+ assert.equal(r.hudBig.styles.maxWidth, '100%');
356
432
  // The drawn line is wider than its box: shrunk again by what was measured.
357
433
  r.hudBig.client = 252;
358
434
  r.hudBig.scroll = 336;
@@ -378,14 +454,45 @@ test('asked, a phone on its side: two lines of text and a box no taller than its
378
454
  r.chrome.setHudClear(true);
379
455
  r.chrome.setHud(SPEC, null);
380
456
  assert.equal(r.hudBig.styles.fontSize, '28px');
381
- assert.equal(r.hudText.styles.display, '-webkit-box');
382
- assert.equal(r.hudText.styles.webkitLineClamp, '2');
383
- assert.equal(r.hudText.styles.webkitBoxOrient, 'vertical');
384
- assert.equal(r.hudText.styles.overflow, 'hidden');
457
+ assert.equal(r.hudText.styles.display, 'block');
458
+ assert.equal(r.hudText.styles.webkitLineClamp ?? '', '');
459
+ assert.equal(r.hudText.styles.webkitBoxOrient ?? '', '');
460
+ assert.equal(r.hudText.styles.overflow, 'visible');
385
461
  assert.equal(r.hud.styles.maxHeight, '144px');
386
462
  assert.equal(r.hud.styles.overflow, 'hidden');
387
463
  });
388
464
 
465
+ test('emote bubbles: sizes are read each frame before its writes', () => {
466
+ const r = rig();
467
+ const heads = Array.from({ length: 30 }, (_, i) => ({ id: `e${i}`, x: 0, y: 0, text: i % 2 ? '👋' : '💃', emote: true, head: { left: 20 + i * 10, right: 50 + i * 10, top: 400, bottom: 430 }, lift: 0 }));
468
+ r.chrome.setLabels(heads);
469
+ const reads = (from) => r.log.slice(from).filter((line) => line.endsWith(' read'));
470
+ for (let frame = 0; frame < 3; frame += 1) {
471
+ r.chrome.beginLayoutFrame();
472
+ const from = r.log.length;
473
+ r.chrome.setLabels(heads.map((h) => ({ ...h, head: { ...h.head, top: h.head.top + frame } })));
474
+ assert.deepEqual(reads(from), [], 'no geometry read after the read phase');
475
+ r.chrome.endLayoutFrame();
476
+ }
477
+ });
478
+
479
+ test('emote bubbles: one hidden for a head off the view is shown again on any later placement', () => {
480
+ const r = rig();
481
+ const off = { id: 'w', x: 0, y: 0, text: '👋', emote: true, head: { left: 400, right: 440, top: 300, bottom: 330 }, lift: 0 };
482
+ r.chrome.setLabels([off]);
483
+ const node = r.labels.children.find((c) => c.textContent === '👋');
484
+ assert.equal(node.styles.visibility, 'hidden');
485
+ // Its head back in the view.
486
+ r.chrome.setLabels([{ ...off, head: { left: 150, right: 190, top: 300, bottom: 330 } }]);
487
+ assert.equal(node.styles.visibility, '');
488
+ r.chrome.setLabels([off]);
489
+ assert.equal(node.styles.visibility, 'hidden');
490
+ // No head this frame (the old point): shown again.
491
+ r.chrome.setLabels([{ id: 'w', x: 180, y: 400, text: '👋', emote: true }]);
492
+ assert.equal(node.styles.visibility, '');
493
+ assert.equal(node.styles.left, '180px');
494
+ });
495
+
389
496
  test('asked: labels, speech, marks, emotes, pointers and the ribbon over the HUD go just under it', () => {
390
497
  const r = rig();
391
498
  r.hud.rect = { left: 90, right: 270, top: 12, bottom: 106 };
@@ -459,59 +566,43 @@ test('after a place that asked, a place that does not is drawn as never told', (
459
566
  assert.equal(strip(tree(after.pointers)), strip(tree(never.pointers)));
460
567
  assert.deepEqual(styleOf(after.hudBig), TODAY.big);
461
568
  assert.deepEqual(styleOf(after.hudText), TODAY.text);
462
- assert.deepEqual(styleOf(after.hud), TODAY.hud);
569
+ assert.deepEqual(styleOf(after.hud), view.viewW > view.viewH ? { ...TODAY.hud, maxWidth: 'min(42vw, 420px)' } : TODAY.hud);
463
570
  // And after the one frame that put it back, nothing of it is written.
464
571
  const putBack = after.log.slice(mark).filter((line) => /maxHeight|webkit|textOverflow/.test(line));
465
- assert.equal(putBack.length, 4, 'put back once, in the first frame');
572
+ assert.equal(putBack.length, 2, 'put back once, in the first frame');
466
573
  }
467
574
  });
468
575
 
469
- test('asked: a bubble that wraps by where it is is measured again when it moves', () => {
576
+ test('asked: a wrapping change refreshes the affected bubble once in the same frame', () => {
470
577
  const r = rig();
471
578
  r.hud.rect = { left: 90, right: 270, top: 12, bottom: 106 };
472
- r.chrome.setHudClear(true);
473
- r.chrome.setHud(SPEC, null);
474
- // A player's chat bubble: its width is what is left of the view to its
475
- // right, so nearer the right edge it is narrower and taller.
579
+ r.chrome.setHudClear(true); r.chrome.setHud(SPEC, null);
476
580
  const bubble = (x) => [{ id: 'say:p2', x, y: 136, text: 'meet me by the well when the bell rings', speech: true, npc: false, opacity: 1 }];
477
- let reads = 0;
478
- r.chrome.setLabels(bubble(100));
479
- r.chrome.flushHudClear?.();
581
+ r.chrome.setLabels(bubble(100)); r.chrome.flushHudClear();
480
582
  const node = r.labels.children[0];
481
- node.size = (self) => ((reads += 1), parseFloat(self.styles.left) > 200 ? { w: 150, h: 58 } : { w: 220, h: 24 });
482
- r.chrome.setLabels(bubble(100));
483
- r.chrome.flushHudClear?.();
484
- assert.equal(node.styles.top, '136px', 'one line: its top is 112, clear');
485
- // Moved right with the same words: three lines now, so its top would be 78.
486
- r.chrome.setLabels(bubble(210));
487
- r.chrome.flushHudClear?.();
488
- assert.equal(node.styles.top, '170px', 'its top is 112 again');
489
- // Standing still it is not measured every frame.
490
- const before = reads;
583
+ node.size = (self) => parseFloat(self.styles.left) > 200 ? { w: 150, h: 58 } : { w: 220, h: 24 };
584
+ r.chrome.beginLayoutFrame();
585
+ const mark = r.log.length;
586
+ r.chrome.setLabels(bubble(210)); r.chrome.flushHudClear();
587
+ assert.equal(node.styles.top, '170px', 'this frame clears the current wrapped height');
588
+ assert.equal(r.log.slice(mark).filter((line) => line === `${node.id} read`).length, 2, 'only one fresh width/height measurement');
589
+ r.chrome.endLayoutFrame();
491
590
  for (let i = 0; i < 10; i += 1) {
492
- r.chrome.setLabels(bubble(210));
493
- r.chrome.flushHudClear?.();
494
- }
495
- assert.equal(reads, before);
496
- // A label that never wraps is measured once, wherever it goes.
497
- const sign = (x) => [{ id: 'sign', x, y: 90, text: 'Start here', speech: false, npc: false, opacity: 1 }];
498
- r.chrome.setLabels(sign(100));
499
- r.chrome.flushHudClear?.();
500
- let signReads = 0;
501
- r.labels.children[0].size = () => ((signReads += 1), { w: 90, h: 24 });
502
- for (let x = 100; x < 260; x += 10) {
503
- r.chrome.setLabels(sign(x));
504
- r.chrome.flushHudClear?.();
591
+ r.chrome.beginLayoutFrame();
592
+ const from = r.log.length;
593
+ r.chrome.setLabels(bubble(210)); r.chrome.flushHudClear();
594
+ assert.equal(node.styles.top, '170px', 'unchanged later frames retain the wrapped clearance');
595
+ assert(!r.log.slice(from).some((line) => line.endsWith(' read')));
596
+ r.chrome.endLayoutFrame();
505
597
  }
506
- assert.ok(signReads <= 2, `${signReads} reads`);
507
598
  });
508
599
 
509
600
  test('asked: a frame is all measured, then all moved -- no layout read after its first push, across pointers, labels, the card and the ribbon', () => {
510
601
  const r = rig();
511
602
  r.hud.rect = { left: 60, right: 300, top: 12, bottom: 106 };
512
603
  // Four chat bubbles and two pointers drifting sideways under the HUD: each
513
- // bubble's size is read again every frame (it wraps by where it is), and
514
- // each pointer's words change with its distance.
604
+ // bubble keeps its max-content size through movement, while each pointer's
605
+ // words change with its distance and need a new measurement.
515
606
  const bubbles = (dx) => [0, 1, 2, 3].map((i) => ({ id: `say:p${i}`, x: 100 + i * 40 + dx, y: 60 + i * 10, text: `bubble ${i} has a few words in it`, speech: true, npc: false, opacity: 1 }));
516
607
  const chips = (dx) => [0, 1].map((i) => ({ id: `to:p${i}`, x: 150 + i * 60 + dx, y: 90, text: `friend ${i} · ${20 + dx} m`, angle: null }));
517
608
  const card = { id: 'cab', rev: 1, card: { title: 'Arcade', top: [{ username: 'bo', score: 12 }] }, x: 180, y: 90, opacity: 1 };
@@ -528,7 +619,16 @@ test('asked: a frame is all measured, then all moved -- no layout read after its
528
619
  };
529
620
  for (let dx = 0; dx < 8; dx += 1) {
530
621
  const mark = r.log.length;
622
+ r.chrome.beginLayoutFrame();
531
623
  frame(dx);
624
+ r.chrome.endLayoutFrame();
625
+ // Browser textContent includes descendant copy; this fixture normally
626
+ // keeps it on the child. Let pointer invalidation see its changing words.
627
+ if (dx === 0) {
628
+ for (const node of r.pointers.children) {
629
+ Object.defineProperty(node, 'textContent', { get: () => node.children.map((child) => child.textContent).join('') });
630
+ }
631
+ }
532
632
  const lines = r.log.slice(mark);
533
633
  // A push is the second write of `top` to a node in the frame.
534
634
  const tops = new Set();
@@ -546,9 +646,10 @@ test('asked: a frame is all measured, then all moved -- no layout read after its
546
646
  assert.ok(firstPush > 0, 'something was pushed');
547
647
  const before = lines.slice(0, firstPush);
548
648
  const after = lines.slice(firstPush);
549
- // Measured this frame: the four moving bubbles, the two pointers, the ribbon.
649
+ // Changed pointers are sampled before pushes; unchanged max-content
650
+ // bubbles can reuse their persistent first-use measurements.
550
651
  const measured = new Set(before.filter((line) => line.endsWith(' read')).map((line) => line.split(' ')[0]));
551
- for (const node of [...r.labels.children, ...r.pointers.children]) {
652
+ for (const node of [...(dx === 0 ? r.labels.children : []), ...r.pointers.children]) {
552
653
  assert.ok(measured.has(node.id), `${node.id} was measured`);
553
654
  }
554
655
  assert.ok(!after.some((line) => line.endsWith(' read')), `frame ${dx}: no read after the first push`);
@@ -573,11 +674,13 @@ test('never asked: the end of a frame reads and writes nothing', () => {
573
674
  assert.equal(r.log.length, mark);
574
675
  // Nor after a place that asked has been left.
575
676
  frames(r, () => true, [SPEC]);
677
+ r.chrome.beginLayoutFrame();
576
678
  r.chrome.setHudClear(false);
577
679
  r.chrome.setLabels(LABELS);
578
680
  const quiet = r.log.length;
579
681
  r.chrome.flushHudClear();
580
682
  assert.equal(r.log.length, quiet);
683
+ r.chrome.endLayoutFrame();
581
684
  });
582
685
 
583
686
  test('pushBelow: nothing is pushed off the bottom of the view', () => {
@@ -626,14 +729,15 @@ test('asked, then not, with no HUD drawn: put back at once, and written to as ne
626
729
  assert.notDeepEqual(styleOf(after.hudBig), TODAY.big);
627
730
  // The place is left for one with no HUD: the option goes, then no HUD.
628
731
  after.chrome.setHudClear(false);
629
- for (const [node, today] of [[after.hud, TODAY.hud], [after.hudTitle, TODAY.title], [after.hudBig, TODAY.big], [after.hudText, TODAY.text]]) {
732
+ const hudToday = view.viewW > view.viewH ? { ...TODAY.hud, maxWidth: 'min(42vw, 420px)' } : TODAY.hud;
733
+ for (const [node, today] of [[after.hud, hudToday], [after.hudTitle, TODAY.title], [after.hudBig, TODAY.big], [after.hudText, TODAY.text]]) {
630
734
  assert.deepEqual(styleOf(node), today, 'put back before any HUD is drawn');
631
735
  }
632
736
  const mark = after.log.length;
633
737
  after.chrome.setHud(null, null);
634
- assert.deepEqual(styleOf(after.hud), { ...TODAY.hud, display: 'none' });
738
+ assert.deepEqual(styleOf(after.hud), { ...hudToday, display: 'none' });
635
739
  assert.deepEqual(styleOf(after.hudBig), TODAY.big);
636
- assert.deepEqual(styleOf(after.hudText), TODAY.text);
740
+ assert.deepEqual(styleOf(after.hudText), { ...TODAY.text, display: 'none' });
637
741
  after.log.length = mark;
638
742
  // From then on: the same writes, in the same order, as a client never told.
639
743
  frames(after, () => undefined, later);
@@ -673,4 +777,327 @@ test('asked, then not, with no HUD drawn: put back at once, and written to as ne
673
777
  n += 1;
674
778
  }
675
779
 
780
+ // v1.34: pointers (friends, a place's goals) are under every panel and card:
781
+ // their layer is made with the labels', before anything that opens over the
782
+ // world, so a goal's arrow is never drawn on the NPC words being read.
783
+ {
784
+ const r = rig();
785
+ const order = r.root.children;
786
+ const at = order.indexOf(r.pointers);
787
+ // v1.38: and under the labels' layer, so an NPC's speech bubble is read over a chip.
788
+ assert.equal(at, order.indexOf(r.labels) - 1, 'the pointers layer is just under the labels layer');
789
+ const over = order.filter((c) => c.tag === 'button' || (c.styles.width ?? '').startsWith('min(') || c.styles.borderRadius);
790
+ // (Back and the toast are made before both layers, as they always were.)
791
+ const early = order.slice(0, at).filter((c) => over.includes(c));
792
+ assert.ok(early.length <= 3 && over.length - early.length >= 8, `made before the pointers: ${early.length} of ${over.length}`);
793
+ assert.ok(over.filter((c) => !early.includes(c)).every((c) => order.indexOf(c) > order.indexOf(r.labels)), 'everything that opens over the world is over the pointers and the labels');
794
+ assert.ok(order.filter((c, i) => i > at && (c.styles.width ?? '').startsWith('min(')).length >= 1, 'the talk panel among them');
795
+ n += 1;
796
+ }
797
+
798
+ // v1.38: a chip at the screen's edge is kept beside the round buttons there
799
+ // (quick chat, emotes, grab), never under one: half its words were covered.
800
+ {
801
+ const r = rig();
802
+ const say = r.made.find((c) => c.attrs['aria-label'] === 'Quick chat');
803
+ r.chrome.setSay({ reactions: ['👋'], phrases: [] });
804
+ say.rect = { left: window.innerWidth - 72, right: window.innerWidth - 20, top: 600, bottom: 652 };
805
+ const chipOf = (text) => r.pointers.children.find((c) => c.children[1].textContent === text);
806
+ const edgeX = window.innerWidth - 4;
807
+ r.chrome.setPointers([
808
+ { id: 'a', x: edgeX, y: 626, text: 'lantern', angle: 0 },
809
+ { id: 'b', x: edgeX, y: 300, text: 'lantern b', angle: 0 },
810
+ { id: 'c', x: edgeX - 40, y: 626, text: 'amy', angle: null },
811
+ ]);
812
+ // (the stand-in layout measures a chip by its own text, none: 20 px wide)
813
+ const half = () => 10;
814
+ assert.equal(parseFloat(chipOf('lantern').styles.left), say.rect.left - 6 - half('lantern'), 'beside the button, not under it');
815
+ assert.equal(parseFloat(chipOf('lantern b').styles.left), window.innerWidth - half('lantern b') - 6, 'an edge chip clear of the button stays at the edge');
816
+ assert.equal(parseFloat(chipOf('amy').styles.left), Math.min(edgeX - 40, window.innerWidth - half('amy') - 6), 'a chip over a friend is not moved');
817
+ // A chip too wide to stand beside the button goes over it (under it with no room over).
818
+ const wide = chipOf('lantern');
819
+ wide.size = { w: 300, h: 20 };
820
+ r.chrome.setPointers([{ id: 'a', x: edgeX, y: 626, text: 'lantern', angle: 0 }]);
821
+ assert.equal(parseFloat(wide.styles.left), window.innerWidth - 150 - 6);
822
+ assert.equal(parseFloat(wide.styles.top), say.rect.top - 6 - 10, 'over the button');
823
+ say.rect = { ...say.rect, top: 10, bottom: 62 };
824
+ r.chrome.setPointers([{ id: 'a', x: edgeX, y: 30, text: 'lantern', angle: 0 }]);
825
+ assert.equal(parseFloat(wide.styles.top), 62 + 6 + 10, 'under it where there is no room over');
826
+ // With two buttons up, a move away from one never lands on the other.
827
+ const emote = r.made.find((c) => c.tag === 'button' && c.styles.right === '20px' && c.styles.width === '52px' && c !== say);
828
+ say.rect = { ...say.rect, top: 600, bottom: 652 };
829
+ emote.styles.display = 'block';
830
+ emote.style.display = 'block';
831
+ emote.rect = { left: say.rect.left, right: say.rect.right, top: 542, bottom: 594 };
832
+ r.chrome.setPointers([{ id: 'a', x: edgeX, y: 626, text: 'lantern', angle: 0 }]);
833
+ assert.equal(parseFloat(wide.styles.top), 542 - 6 - 10, 'over the whole column');
834
+ wide.size = undefined;
835
+ r.chrome.setPointers([{ id: 'a', x: edgeX, y: 626, text: 'lantern', angle: 0 }]);
836
+ assert.equal(parseFloat(wide.styles.left), say.rect.left - 6 - 10, 'a narrow chip goes left of the column');
837
+ emote.styles.display = 'none';
838
+ emote.style.display = 'none';
839
+ say.rect = { ...say.rect, top: 600, bottom: 652 };
840
+ // With the button hidden, the chip is at the edge as before.
841
+ r.chrome.setSay(null);
842
+ r.chrome.setPointers([{ id: 'a', x: edgeX, y: 626, text: 'lantern', angle: 0 }]);
843
+ assert.equal(parseFloat(chipOf('lantern').styles.left), window.innerWidth - half('lantern') - 6);
844
+ n += 1;
845
+ }
846
+
847
+ // v1.35: the NPC talk panel. A reply is scrolled to its first word, the
848
+ // player's own line to the end of the log, and a player who has scrolled up to
849
+ // read is left where they are. The log has no layout here, so its numbers are
850
+ // set by hand: each line lies where the last one ended.
851
+ {
852
+ const r = rig();
853
+ const logNode = r.dom?.made?.find?.((c) => c.styles.maxHeight === '28vh') ?? r.made.find((c) => c.styles.maxHeight === '28vh' && c.styles.overflowY === 'auto');
854
+ assert.ok(logNode, 'the talk log');
855
+ Object.assign(logNode, { offsetTop: 40, clientHeight: 100, scrollTop: 0, scrollHeight: 0 });
856
+ // Adds a line `height` tall as the browser would lay it out.
857
+ const add = (who, height) => {
858
+ const before = logNode.children.length;
859
+ const top = 40 + logNode.scrollHeight;
860
+ const made = logNode.appendChild;
861
+ logNode.appendChild = (child) => {
862
+ child.offsetTop = top;
863
+ logNode.scrollHeight += height;
864
+ return made.call(logNode, child);
865
+ };
866
+ r.chrome.talkLine(who, 'words');
867
+ logNode.appendChild = made;
868
+ assert.equal(logNode.children.length, before + 1);
869
+ return top - 40;
870
+ };
871
+ r.chrome.openTalk('Mabel');
872
+ add('me', 30);
873
+ assert.equal(logNode.scrollTop, 30, 'my own line: the end of the log');
874
+ logNode.scrollTop = 0; // the browser stops at the end: 30 tall in 100
875
+ // A long reply: its first word at the top of what shows, not its last.
876
+ const reply = add('them', 400);
877
+ assert.equal(reply, 30);
878
+ assert.equal(logNode.scrollTop, 30, 'a long reply starts at the top of the view');
879
+ // The player reads to its end, then another reply: again from its start.
880
+ logNode.scrollTop = logNode.scrollHeight - logNode.clientHeight;
881
+ const next = add('them', 300);
882
+ assert.equal(logNode.scrollTop, next);
883
+ // Scrolled up to read something earlier: a reply does not move the view...
884
+ logNode.scrollTop = 10;
885
+ add('them', 200);
886
+ assert.equal(logNode.scrollTop, 10, 'a player who scrolled up is left there');
887
+ // ...and their own next line does.
888
+ add('me', 30);
889
+ assert.equal(logNode.scrollTop, logNode.scrollHeight);
890
+ // During a hub frame even the scroll metrics come from the read phase.
891
+ // Model the browser's clamping setter while appending another own line.
892
+ let height = logNode.scrollHeight, top = height - 100, reads = 0;
893
+ Object.defineProperties(logNode, {
894
+ scrollHeight: { get() {reads += 1; return height;} },
895
+ clientHeight: { get() {reads += 1; return 100;} },
896
+ scrollTop: { get() {reads += 1; return top;}, set(value) {top = Math.min(height - 100, value);} },
897
+ });
898
+ r.chrome.beginLayoutFrame();
899
+ const before = reads, append = logNode.appendChild;
900
+ logNode.appendChild = (child) => {height += 30; return append.call(logNode, child);};
901
+ r.chrome.talkLine('me', 'another line');
902
+ assert.equal(reads, before, 'appending does not reread scroll layout after writes');
903
+ assert.equal(top, height - 100, 'an own line still scrolls to the live end');
904
+ r.chrome.talkAsks(['Next'], () => {});
905
+ assert.equal(reads, before, 'following the line when chips arrive reuses the scroll snapshot');
906
+ const followed = top;
907
+ r.chrome.endLayoutFrame();
908
+ r.chrome.beginLayoutFrame();
909
+ const beforeFollow = reads;
910
+ r.chrome.talkAsks(['Next again'], () => {});
911
+ assert.equal(reads, beforeFollow, 'a later frame follows without live scroll reads');
912
+ assert.equal(top, followed, 'browser-clamped scroll retains the followed line');
913
+ r.chrome.endLayoutFrame();
914
+ top = 10;
915
+ r.chrome.beginLayoutFrame();
916
+ r.chrome.talkAsks(['After scrolling back'], () => {});
917
+ assert.equal(top, 10, 'chips preserve a player scroll after an in-frame append');
918
+ r.chrome.endLayoutFrame();
919
+ n += 1;
920
+ }
921
+
922
+ // v1.37: what to ask an NPC, as chips in the talk panel between the log and
923
+ // the field: none made until a place gives some, a tap hands back the
924
+ // question, an empty list or closing the panel takes them away.
925
+ {
926
+ const r = rig();
927
+ const panel = r.made.find((c) => (c.styles.width ?? '').startsWith('min(92vw'));
928
+ const kids = () => panel.children.length;
929
+ const before = kids();
930
+ r.chrome.openTalk('Mabel');
931
+ r.chrome.talkAsks([], null);
932
+ assert.equal(kids(), before, 'no chips row until there are chips');
933
+ const taps = [];
934
+ r.chrome.talkAsks(['What can I do here?', 'Where is the inn?', 'Who are you?', 'A fourth'], (ask) => taps.push(ask));
935
+ assert.equal(kids(), before + 1);
936
+ const row = panel.children.at(-2);
937
+ assert.equal(panel.children.at(-1).children.some((c) => c.tag === 'input'), true, 'the row sits just above the field');
938
+ assert.deepEqual([row.styles.display, row.children.map((c) => c.textContent)], ['flex', ['What can I do here?', 'Where is the inn?', 'Who are you?']]);
939
+ r.chrome.talkAsks([], null);
940
+ assert.equal(kids(), before, 'an empty list takes the row out again');
941
+ r.chrome.talkAsks(['Again?'], (ask) => taps.push(ask));
942
+ assert.equal(kids(), before + 1);
943
+ r.chrome.closeTalk();
944
+ assert.equal(kids(), before, 'closing the panel takes it out');
945
+ r.chrome.talkAsks(['Once more?'], (ask) => taps.push(ask));
946
+ r.chrome.openTalk('Rowan');
947
+ assert.equal(kids(), before, 'and the next conversation starts with the panel it always had');
948
+ n += 1;
949
+ }
950
+
951
+ // --- a goal pointer's distance (v1.39) --------------------------------------
952
+
953
+ const { goalPointers, goalText, pointerAt } = await import('../code/client/together.js');
954
+
955
+ // A vector stand-in with identity camera matrices: x/y are NDC and z says
956
+ // whether a destination is in front. Exercise the real pointer projection.
957
+ class PointerVector {
958
+ clone() { return new PointerVector().set(this.x, this.y, this.z); }
959
+ set(x, y, z) { Object.assign(this, { x, y, z }); return this; }
960
+ applyMatrix4() { return this; }
961
+ project() { return this; }
962
+ }
963
+
964
+ test('v1.81: hints draw only on screen and hidden hints never consume the nearest-goal cap', () => {
965
+ const cam = { position: new PointerVector() };
966
+ const view = { w: 400, h: 800 };
967
+ const make = (id, d, at, edge) => ({ id, d, at, label: { text: id, ...(edge === undefined ? {} : { edge }) } });
968
+ const on = { x: 0, y: 0, z: -1 };
969
+ const off = { x: 2, y: 0, z: -1 };
970
+ const behind = { x: 0, y: 0, z: 1 };
971
+ const pointer = (g) => pointerAt(cam, view, g.at, `goal:${g.id}`, goalText(g.label, g.d, 6));
972
+ const visible = make('visible hint', 10, on, false);
973
+ const side = make('edge goal', 20, off);
974
+ const back = make('behind goal', 30, behind);
975
+ const hidden = [make('off hint', 1, off, false), make('behind hint', 2, behind, false)];
976
+ assert.deepEqual(goalPointers(hidden, 2, pointer), []);
977
+ assert.deepEqual(goalPointers([back, ...hidden, side, visible], 2, pointer), [pointer(visible), pointer(side)]);
978
+ assert.equal(pointer(visible).angle, null);
979
+ assert.equal(pointer(visible).text, 'visible hint · 10 m');
980
+ assert.notEqual(pointer(side).angle, null);
981
+ assert.deepEqual(goalPointers([...hidden, back, side], 2, pointer), [pointer(side), pointer(back)]);
982
+ assert.deepEqual(goalPointers([back, side, visible], 2, pointer), [pointer(visible), pointer(side)], 'absent-key selection is unchanged');
983
+ assert.deepEqual(goalPointers([make('near hint', 3, on, false)], 2, pointer)[0].text, 'near hint');
984
+ for (const edge of [true, null, 0, 'false']) {
985
+ const g = make('legacy', 10, behind, edge);
986
+ assert.deepEqual(goalPointers([g], 2, pointer), [pointer(g)]);
987
+ }
988
+ });
989
+
990
+ test("a goal pointer's words: the measured distance as before, the place's number, or none", () => {
991
+ const NEAR = 6;
992
+ // Without the option: the straight line to the actor, beyond 6 m, as it always was.
993
+ assert.equal(goalText({ text: 'Mill', style: 'goal' }, 22.4, NEAR), 'Mill · 22 m');
994
+ assert.equal(goalText({ text: 'Mill', style: 'goal' }, 6, NEAR), 'Mill');
995
+ assert.equal(goalText({ text: 'Mill', style: 'goal' }, 6.2, NEAR), 'Mill · 6 m');
996
+ // `distanceM`: that number, whatever the pointer's own actor is from the player.
997
+ assert.equal(goalText({ text: 'Mill', style: 'goal', distanceM: 84 }, 3, NEAR), 'Mill · 84 m', 'the corner is 3 m off, the walk 84');
998
+ assert.equal(goalText({ text: 'Mill', style: 'goal', distanceM: 84 }, 300, NEAR), 'Mill · 84 m');
999
+ assert.equal(goalText({ text: 'Mill', style: 'goal', distanceM: 4 }, 300, NEAR), 'Mill', 'nearly there: no number, as for a near actor');
1000
+ assert.equal(goalText({ text: 'Mill', style: 'goal', distanceM: 0 }, 300, NEAR), 'Mill');
1001
+ // `distance: false`: none, however far.
1002
+ assert.equal(goalText({ text: 'Mill', style: 'goal', distance: false }, 300, NEAR), 'Mill');
1003
+ assert.equal(goalText({ text: 'Mill', style: 'goal', distance: false, distanceM: 84 }, 300, NEAR), 'Mill');
1004
+ // Anything else is not there: measured.
1005
+ for (const junk of [{ distanceM: -1 }, { distanceM: NaN }, { distanceM: Infinity }, { distanceM: '40' }, { distanceM: null }, { distance: true }, { distance: 0 }]) {
1006
+ assert.equal(goalText({ text: 'Mill', style: 'goal', ...junk }, 22.4, NEAR), 'Mill · 22 m', JSON.stringify(junk));
1007
+ }
1008
+ });
1009
+
1010
+ test('a new distance alone rewrites the chip\'s words: the same node, nothing else written', () => {
1011
+ const r = rig();
1012
+ const at = (text) => [{ id: 'goal:corner', x: 180, y: 300, text, angle: -1.57 }];
1013
+ r.chrome.setPointers(at(goalText({ text: 'Mill', distanceM: 84 }, 3, 6)));
1014
+ const chip = r.pointers.children[0];
1015
+ const made = r.made.length;
1016
+ r.log.length = 0;
1017
+ // The place sends the label again a second later with one metre less.
1018
+ r.chrome.setPointers(at(goalText({ text: 'Mill', distanceM: 83 }, 3, 6)));
1019
+ assert.equal(r.pointers.children.length, 1);
1020
+ assert.equal(r.pointers.children[0], chip, 'the same chip');
1021
+ assert.equal(r.made.length, made, 'nothing built');
1022
+ const words = chip.children[1];
1023
+ assert.equal(words.textContent, 'Mill · 83 m');
1024
+ assert.deepEqual(r.log.filter((line) => / text=| removed| emptied| \+/.test(line)), [`${words.id} text=Mill · 83 m`], 'one write of words: no node made, moved or taken away');
1025
+ // The same number again: no words written at all.
1026
+ r.log.length = 0;
1027
+ r.chrome.setPointers(at('Mill · 83 m'));
1028
+ assert.equal(r.log.some((line) => / text=/.test(line)), false);
1029
+ });
1030
+
1031
+
1032
+
1033
+ // Dev overflow diagnostics use browser-measured wrapping, not character counts.
1034
+ test('two lines fit at 844x390; a third warns once and is rechecked on resize', () => {
1035
+ const previous = { window: globalThis.window, getComputedStyle: globalThis.getComputedStyle, warn: console.warn };
1036
+ const warnings = [];
1037
+ let reads = 0;
1038
+ globalThis.window = { innerWidth: 844, innerHeight: 390 };
1039
+ globalThis.getComputedStyle = () => { reads += 1; return { lineHeight: '18.2px', paddingTop: '4px', paddingBottom: '4px' }; };
1040
+ console.warn = (...args) => warnings.push(args);
1041
+ try {
1042
+ const node = { textContent: 'Two lines of instructions', scrollHeight: 44, clientWidth: 354 };
1043
+ warnHudCopy(node, 'instruction');
1044
+ assert.equal(warnings.length, 0);
1045
+ node.textContent = 'Three lines of instructions';
1046
+ node.scrollHeight = 63;
1047
+ warnHudCopy(node, 'instruction');
1048
+ warnHudCopy(node, 'instruction');
1049
+ assert.equal(warnings.length, 1);
1050
+ assert.match(warnings[0][0], /instruction exceeds two lines at 844x390/);
1051
+ assert.equal(warnings[0][1], node.textContent);
1052
+ assert.equal(reads, 2, 'unchanged timer frames do not measure again');
1053
+ window.innerWidth = 1440; window.innerHeight = 900; node.scrollHeight = 26;
1054
+ warnHudCopy(node, 'instruction');
1055
+ assert.equal(warnings.length, 1, 'desktop copy fits');
1056
+ window.innerWidth = 844; window.innerHeight = 390; node.scrollHeight = 63;
1057
+ warnHudCopy(node, 'instruction');
1058
+ assert.equal(warnings.length, 2, 'returning to landscape checks again');
1059
+ node.clientWidth = 250;
1060
+ warnHudCopy(node, 'instruction');
1061
+ assert.equal(warnings.length, 3, 'safe layout narrowing at the same viewport checks again');
1062
+ warnHudCopy({ textContent: '', scrollHeight: 100 }, 'subtitle');
1063
+ assert.equal(warnings.length, 3, 'empty scrims are absent');
1064
+ } finally {
1065
+ globalThis.window = previous.window; globalThis.getComputedStyle = previous.getComputedStyle; console.warn = previous.warn;
1066
+ }
1067
+ });
1068
+
1069
+ test('prompt is separate from top HUD and uses only first sentence', () => {
1070
+ const r = rig({ viewW: 844, viewH: 390 });
1071
+ r.chrome.setHud({ title: 'Color Call', big: '4', text: 'Stand on plum. Stay until the floor returns.' }, null);
1072
+ assert.equal(r.hud.children.length, 2);
1073
+ assert.equal(r.hudText.parent, r.root);
1074
+ assert.equal(r.hudText.textContent, 'Stand on plum.');
1075
+ assert.equal(r.hudText.style.maxHeight, '');
1076
+ assert.equal(r.hudText.style.overflow, 'visible', 'legacy long first sentences remain readable until authors cut them');
1077
+ r.chrome.setDecorating(true);
1078
+ assert.equal(r.hudText.style.visibility, 'hidden');
1079
+ r.chrome.setDecorating(false);
1080
+ assert.equal(r.hudText.style.visibility, '');
1081
+ assert.ok(r.hudText.style.bottom.includes('safe-area-inset-bottom'));
1082
+ r.chrome.setHud(null, null);
1083
+ assert.equal(r.hudText.style.display, 'none');
1084
+ assert.equal(firstPromptSentence('Wait 1.5 seconds. Then jump!'), 'Wait 1.5 seconds.');
1085
+ assert.equal(firstPromptSentence('Move now! A story follows.'), 'Move now!');
1086
+ assert.equal(firstPromptSentence(' Walk to the gold gate '), 'Walk to the gold gate');
1087
+ assert.equal(firstPromptSentence(null), '');
1088
+ assert.equal(firstPromptSentence('Talk to Dr. Bloom. Then plant a seed.'), 'Talk to Dr. Bloom.');
1089
+ assert.equal(firstPromptSentence('The helper says "Go now!" Then wait.'), 'The helper says "Go now!"');
1090
+ });
1091
+ test('projected labels and pointers avoid the bottom pill without hud.clear', () => {
1092
+ const r = rig({ viewW: 844, viewH: 390 });
1093
+ r.chrome.setHud({ text: 'Stand on plum.' }, null);
1094
+ r.chrome.setLabels([{ id: 'near-prompt', x: 422, y: 330, text: 'Plum', speech: false, npc: false }]);
1095
+ r.chrome.setPointers([{ id: 'goal:plum', x: 422, y: 330, text: 'Plum', angle: null }]);
1096
+ r.chrome.flushHudClear();
1097
+ assert.equal(r.labels.children[0].style.top, '304px');
1098
+ assert.equal(r.pointers.children[0].style.top, '304px');
1099
+ assert.ok(r.chrome.padOccupancyControls().some(box => box.top === 310 && box.bottom === 336));
1100
+ assert.equal(promptShift({ left: 400, right: 450, top: 306, bottom: 330 }, r.hudText.rect), -26);
1101
+ assert.equal(promptShift({ left: 0, right: 50, top: 306, bottom: 330 }, r.hudText.rect), 0);
1102
+ });
676
1103
  console.log(`hub-game hud-clear: ${n} tests passed`);