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,234 @@
1
+ // A town's labels kept near and apart (contract v1.43, the deck's
2
+ // `hub.labels: "near"`), with no DOM in it so `scripts/test-labels.mjs` can
3
+ // hold it. The hub system calls in here only in a deck that asks, and only in
4
+ // a place that is not a game; without the key nothing here runs.
5
+ //
6
+ // The world labels are what `hub.label` puts over scene actors as a plate
7
+ // (plain or `"tag"`), an NPC's line (`"speech"`) or a `"sign"`. The attention
8
+ // rule (`attention.js`) already picks the one plate and the one line a player
9
+ // stands by. This adds, for a world too wide for signs seen from anywhere:
10
+ // - a sign is drawn only near the player: from SIGN_NEAR_M, until SIGN_FAR_M;
11
+ // - no two world labels overlap: the more important one is drawn;
12
+ // - at most MAX are drawn at once.
13
+ // Goal and friend pointers, players' own bubbles, emotes and marks, name tags,
14
+ // a cabinet's card, the ribbon and the "Stuck?" chip are not world labels:
15
+ // they are never given to this, never counted and never hidden by it.
16
+
17
+ // A sign comes on this near the player (on the ground, not from the camera:
18
+ // zooming out brings nothing in) and is kept until this far.
19
+ export const SIGN_NEAR_M = 12;
20
+ export const SIGN_FAR_M = 14;
21
+ // Over the last of the way out it thins, so nothing is drawn past SIGN_FAR_M.
22
+ const SIGN_THIN_M = 1;
23
+ export const MAX = 3;
24
+ // A label drawn counts as this much nearer, so two equally near do not swap.
25
+ export const STICK_M = 0.75;
26
+ // A label taken down for another (or for being one too many) comes back only
27
+ // when it clears the others by this much, and no sooner than this after it
28
+ // went: no label goes and comes and goes inside HIDE_MS, whatever passes in
29
+ // front of it. While it waits it keeps its place among the MAX, so the next
30
+ // one down the order does not flash up in it for that moment.
31
+ export const CLEAR_PX = 8;
32
+ export const HIDE_MS = 2000;
33
+ // Coming or going by distance, a label fades over this long.
34
+ const FADE_MS = 250;
35
+
36
+ import { pushBelow } from './hudClear.js';
37
+ import { promptShift } from './hudCopy.js';
38
+
39
+ const RANK = { plate: 0, speech: 1, sign: 2 };
40
+
41
+ export function makeNear() {
42
+ return {
43
+ // id -> opacity of every label drawn or fading
44
+ alpha: new Map(),
45
+ // the signs in reach, and the labels chosen on the last frame
46
+ reach: new Set(),
47
+ chosen: new Set(),
48
+ // id -> when it was last taken down for another label or the cap
49
+ downAt: new Map(),
50
+ at: 0,
51
+ };
52
+ }
53
+
54
+ // The rule's state belongs to one visit: one loaded scene, on one connection,
55
+ // in one place as the server last said it. `holder` keeps the state and what
56
+ // it was made for; anything else and it starts again, so nothing held, in
57
+ // reach or half faded is carried into another scene, across a reconnect or
58
+ // past the hub's state being cleared. `scope` is
59
+ // `{ scene, data, net, place }`: the scene's key (another scene: the hub
60
+ // system's `enterScene`), the loaded scene's data (a new object on every
61
+ // load, the same scene loaded again included: the engine's `reset`), the
62
+ // connection (a new one on every join), and the place's manifest (`state.js`
63
+ // `clear()` drops it, and each join is told a new one).
64
+ export function nearFor(holder, scope) {
65
+ const was = holder.scope;
66
+ if (!holder.state || !was || was.scene !== scope.scene || was.data !== scope.data || was.net !== scope.net || was.place !== scope.place) {
67
+ holder.state = makeNear();
68
+ holder.scope = { scene: scope.scene, data: scope.data, net: scope.net, place: scope.place };
69
+ }
70
+ return holder.state;
71
+ }
72
+
73
+ // Keep every potentially visible sign, including ones behind the camera.
74
+ // A player may drift 0.5 m before refresh; the extra metre covers that drift
75
+ // beyond the far threshold. Plates/speech have no distance limit. This is
76
+ // only a projection shortlist: near() still ranks, fades and collides each frame.
77
+ export function nearCandidates(holder, placed, position, now, scope, defaults = false) {
78
+ const source = JSON.stringify([defaults, placed.map(({ id, at, label, always }) => [id, at.x, at.y, at.z, label, always])]);
79
+ const cached = holder.current;
80
+ if (!cached || cached.scope !== scope || cached.source !== source || now < cached.at || now - cached.at >= 100
81
+ || Math.hypot(position.x - cached.x, (position.y ?? 0) - cached.y, position.z - cached.z) > 0.5) {
82
+ const ranked = placed.map((entry) => ({ ...entry, d: Math.hypot(entry.at.x - position.x, entry.at.z - position.z) }))
83
+ .filter((entry) => (!defaults && !entry.always) || entry.d <= SIGN_FAR_M + 1)
84
+ .sort((a, b) => a.d - b.d);
85
+ holder.current = { scope, source, at: now, x: position.x, y: position.y ?? 0, z: position.z, ids: new Set(ranked.map(({ id }) => id)) };
86
+ }
87
+ return holder.current.ids;
88
+ }
89
+
90
+ const touch = (a, b, pad) => a.left - pad < b.right && b.left - pad < a.right && a.top - pad < b.bottom && b.top - pad < a.bottom;
91
+ const inView = (box, view) => box.right > 0 && box.left < view.w && box.bottom > 0 && box.top < view.h;
92
+
93
+ // `items` is every world label the place has up for this player that may be
94
+ // drawn: `{ id, kind, pick, d, mine, box }`. `kind` is 'plate', 'speech' or
95
+ // 'sign'; `pick` whether a plate or a line is the attention rule's own for
96
+ // this frame (one that is not may only finish fading); `d` its actor's
97
+ // distance from the player on the ground; `mine`
98
+ // whether it was said to this player alone; `box` where its label would lie,
99
+ // `{ left, right, top, bottom }` in CSS pixels, or null when its actor is not
100
+ // in front of the camera. `view` is `{ w, h }`. Returns the labels to draw,
101
+ // id -> opacity.
102
+ export function near(s, items, view, now) {
103
+ const dt = s.at ? Math.min(100, Math.max(0, now - s.at)) : FADE_MS;
104
+ s.at = now;
105
+ const live = new Map();
106
+ const want = [];
107
+ for (const item of items) {
108
+ live.set(item.id, item);
109
+ if (item.kind === 'sign') {
110
+ if (item.d <= (s.reach.has(item.id) ? SIGN_FAR_M : SIGN_NEAR_M)) {
111
+ s.reach.add(item.id);
112
+ } else {
113
+ s.reach.delete(item.id);
114
+ continue;
115
+ }
116
+ }
117
+ if (item.box && inView(item.box, view) && (item.kind === 'sign' || item.pick)) {
118
+ want.push(item);
119
+ }
120
+ }
121
+ for (const id of s.reach) {
122
+ if (!live.has(id)) {
123
+ s.reach.delete(id);
124
+ }
125
+ }
126
+ // The more important first: the plate stood by, the NPC's line, then signs
127
+ // by how near; one said to this player before one said to everyone.
128
+ const felt = (item) => item.d - (s.chosen.has(item.id) ? STICK_M : 0);
129
+ const order = (a, b) => RANK[a.kind] - RANK[b.kind] || felt(a) - felt(b) || Number(b.mine === true) - Number(a.mine === true) || (a.id < b.id ? -1 : 1);
130
+ want.sort(order);
131
+ const chosen = [];
132
+ let places = 0;
133
+ for (const item of want) {
134
+ const was = s.chosen.has(item.id);
135
+ // One not drawn waits out its time down, and for clear air.
136
+ const waits = !was && now - (s.downAt.get(item.id) ?? -Infinity) < HIDE_MS;
137
+ const pad = was ? 0 : CLEAR_PX;
138
+ if (places < MAX && !waits && !chosen.some((c) => touch(item.box, c.box, pad))) {
139
+ chosen.push(item);
140
+ places += 1;
141
+ } else if (was || waits) {
142
+ if (was) {
143
+ s.downAt.set(item.id, now);
144
+ }
145
+ places += 1;
146
+ }
147
+ }
148
+ s.chosen = new Set(chosen.map((c) => c.id));
149
+ const shown = new Map();
150
+ const step = dt / FADE_MS;
151
+ for (const item of chosen) {
152
+ const alpha = Math.min(1, (s.alpha.get(item.id) ?? 0) + step);
153
+ s.alpha.set(item.id, alpha);
154
+ if (alpha * thin(item) > 0) {
155
+ shown.set(item.id, alpha * thin(item));
156
+ }
157
+ }
158
+ // What was drawn and is not chosen fades out where it lies -- but every box
159
+ // drawn this frame, at any opacity, is held to the one rule: no two touch.
160
+ // The fading are taken in the same order of importance after the chosen;
161
+ // one whose box touches a box already taken (a chosen label's, or an
162
+ // earlier fading one's), or that would be one too many, is gone at once.
163
+ const fading = [];
164
+ for (const [id, was] of s.alpha) {
165
+ const item = live.get(id);
166
+ if (s.chosen.has(id)) {
167
+ continue;
168
+ }
169
+ if (item?.box && inView(item.box, view) && (was - step) * thin(item) > 0) {
170
+ fading.push(item);
171
+ } else {
172
+ s.alpha.delete(id);
173
+ }
174
+ }
175
+ fading.sort(order);
176
+ const taken = chosen.map((c) => c.box);
177
+ for (const item of fading) {
178
+ if (taken.length < MAX && !taken.some((box) => touch(item.box, box, 0))) {
179
+ const alpha = s.alpha.get(item.id) - step;
180
+ taken.push(item.box);
181
+ s.alpha.set(item.id, alpha);
182
+ shown.set(item.id, alpha * thin(item));
183
+ } else {
184
+ s.alpha.delete(item.id);
185
+ }
186
+ }
187
+ for (const id of s.downAt.keys()) {
188
+ if (!live.has(id)) {
189
+ s.downAt.delete(id);
190
+ }
191
+ }
192
+ return shown;
193
+ }
194
+
195
+ // A sign's share of its opacity by distance: whole to within SIGN_THIN_M of
196
+ // SIGN_FAR_M, nothing at it.
197
+ function thin(item) {
198
+ return item.kind === 'sign' ? Math.max(0, Math.min(1, (SIGN_FAR_M - item.d) / SIGN_THIN_M)) : 1;
199
+ }
200
+
201
+ // Where a label of `size` (`{ w, h }`) will lie when the frame is drawn, for
202
+ // the screen point (x, y) it hangs over: centred on it with its bottom edge
203
+ // there, an NPC's line kept on the screen sideways (`chrome.js` `setLabels`),
204
+ // and then, in a place with a clear HUD (v1.26), moved down from under the
205
+ // HUD's box exactly as the chrome's flush will move it (`hudClear.js`
206
+ // `pushBelow`; `hud` is that box, or null where there is none to clear).
207
+ // v1.131 optionally reserves the bottom prompt before selection too.
208
+ // The rule judges these boxes, so they must be the final ones.
209
+ export function labelBox(x, y, size, npc, view, hud = null, prompt = null) {
210
+ const half = size.w / 2;
211
+ const cx = npc ? Math.min(Math.max(x, half + 6), view.w - half - 6) : x;
212
+ const box = { left: cx - half, right: cx + half, top: y - size.h, bottom: y };
213
+ const down = pushBelow(box, hud, undefined, view.h);
214
+ const placed = down > 0 ? { left: box.left, right: box.right, top: box.top + down, bottom: box.bottom + down } : box;
215
+ const up = promptShift(placed, prompt);
216
+ const final = up < 0 ? { left: placed.left, right: placed.right, top: placed.top + up, bottom: placed.bottom + up } : placed;
217
+ // With both bands, a label too tall for the remaining lane is not selected.
218
+ return prompt && hud && touch(final, hud, 0) ? null : final;
219
+ }
220
+
221
+ // What the chrome is given for a world label the rule chose (`setLabels`):
222
+ // its words, its `box` -- the one the rule judged, which the chrome draws it
223
+ // in -- and an id for its node. The chrome styles a node once, as a plate or
224
+ // as a line, so a label that turns from one into the other gets another node:
225
+ // the one drawn is always styled as the one that was measured.
226
+ export function chromeItem(id, text, speech, npc, box, opacity) {
227
+ return { id: speech ? `${id}\u0000${npc ? 'npc' : 'speech'}` : id, x: (box.left + box.right) / 2, y: box.bottom, text, speech, npc, box, opacity };
228
+ }
229
+
230
+ // A private goal can project a server-supplied point without moving any actor.
231
+ export function goalAt(label, actorAt) {
232
+ return label.style === 'goal' && label.at && ['x', 'y', 'z'].every((key) => Number.isFinite(label.at[key]))
233
+ ? label.at : actorAt;
234
+ }
@@ -0,0 +1,17 @@
1
+ // Viewport-only landscape detection shared by the hub's independent DOM
2
+ // surfaces. It deliberately does not infer from device, pointer or metadata:
3
+ // a live resize/turn is the whole contract.
4
+ export function landscapeViewport(view = globalThis.window) {
5
+ return Number(view?.innerWidth) > Number(view?.innerHeight);
6
+ }
7
+
8
+ // Listen to both signals used by embedded mobile browsers. Some deliver only
9
+ // resize, some also deliver orientationchange; the callback is idempotent.
10
+ export function watchViewport(callback, view = globalThis.window) {
11
+ view?.addEventListener?.('resize', callback);
12
+ view?.addEventListener?.('orientationchange', callback);
13
+ return () => {
14
+ view?.removeEventListener?.('resize', callback);
15
+ view?.removeEventListener?.('orientationchange', callback);
16
+ };
17
+ }
@@ -0,0 +1,264 @@
1
+ // Placement inputs are small value records, never DOM subtrees. Keep a copy
2
+ // only when they change so mutating an offer in place still invalidates it.
3
+ function equal(a, b) {
4
+ if (a === b) {return true;}
5
+ if (!a || !b || typeof a !== 'object' || typeof b !== 'object') {return false;}
6
+ const keys = Object.keys(a);
7
+ return keys.length === Object.keys(b).length && keys.every((key) => Object.hasOwn(b, key) && equal(a[key], b[key]));
8
+ }
9
+ const copy = (value) => !value || typeof value !== 'object' ? value
10
+ : Array.isArray(value) ? value.map(copy) : Object.fromEntries(Object.entries(value).map(([key, item]) => [key, copy(item)]));
11
+ export function placementCache() {
12
+ let previous, value;
13
+ return (inputs, place) => {
14
+ if (!equal(inputs, previous)) {value = place(); previous = copy(inputs);}
15
+ return value;
16
+ };
17
+ }
18
+
19
+ function displayed(node) {
20
+ for (let parent = node; parent; parent = parent.parentElement ?? parent.parent) {
21
+ if (parent.style?.display === 'none') {return false;}
22
+ }
23
+ return true;
24
+ }
25
+ const pixels = (value, size = 0) => !value || value === 'none' ? 0
26
+ : /^-?(?:\d+\.?\d*|\.\d+)(px|%)?$/.test(value)
27
+ ? Number.parseFloat(value) * (value.endsWith('%') ? size / 100 : 1) : null;
28
+ function anchor(value, box) {
29
+ const pair = /^translate\(([^,]+),\s*([^)]+)\)$/.exec(value ?? '');
30
+ if (pair) {return [pixels(pair[1], box.width), pixels(pair[2], box.height)];}
31
+ const x = /^translateX\(([^)]+)\)$/.exec(value ?? '');
32
+ return [x ? pixels(x[1], box.width) : 0, 0];
33
+ }
34
+ function shift(box, before, after, viewport) {
35
+ const [bx, by = '0'] = (before.translate || '0 0').split(' ');
36
+ const [ax, ay = '0'] = (after.translate || '0 0').split(' ');
37
+ const dx = after.left === before.left ? 0 : pixels(after.left, viewport.w) - pixels(before.left, viewport.w);
38
+ const dy = after.top === before.top ? 0 : pixels(after.top, viewport.h) - pixels(before.top, viewport.h);
39
+ const oldAnchor = before.transform === after.transform ? [0, 0] : anchor(before.transform, box);
40
+ const newAnchor = before.transform === after.transform ? [0, 0] : anchor(after.transform, box);
41
+ const x = dx + pixels(ax, box.width) - pixels(bx, box.width) + newAnchor[0] - oldAnchor[0];
42
+ const y = dy + pixels(ay, box.height) - pixels(by, box.height) + newAnchor[1] - oldAnchor[1];
43
+ return { left: box.left + x, right: box.right + x, top: box.top + y, bottom: box.bottom + y,
44
+ width: box.width, height: box.height };
45
+ }
46
+
47
+ const sizeStyles = ['width', 'minWidth', 'maxWidth', 'height', 'minHeight', 'maxHeight', 'boxSizing',
48
+ 'font', 'fontFamily', 'fontSize', 'fontWeight', 'fontStyle', 'lineHeight', 'letterSpacing',
49
+ 'whiteSpace', 'overflowWrap', 'wordBreak', 'padding', 'paddingLeft', 'paddingRight', 'paddingTop', 'paddingBottom',
50
+ 'border', 'borderWidth', 'display'];
51
+ const sizeProperties = new Set([...sizeStyles.map((key) => key.replace(/[A-Z]/g, (letter) => `-${letter.toLowerCase()}`)),
52
+ 'border-left-width', 'border-right-width', 'border-top-width', 'border-bottom-width']);
53
+ // Declarations split on semicolons outside quotes and parentheses, so a quoted
54
+ // font family or a data URL stays one value.
55
+ function parseStyles(css) {
56
+ const styles = Object.create(null);
57
+ let start = 0, quote = '', depth = 0;
58
+ const add = (end) => {
59
+ const declaration = css.slice(start, end), colon = declaration.indexOf(':');
60
+ if (colon >= 0) {styles[declaration.slice(0, colon).trim().toLowerCase()] = declaration.slice(colon + 1).replace(/\s*!important\s*$/i, '').trim();}
61
+ start = end + 1;
62
+ };
63
+ for (let i = 0; i < css.length; i += 1) {
64
+ const char = css[i];
65
+ if (quote) {if (char === '\\') {i += 1;} else if (char === quote) {quote = '';}}
66
+ else if (char === '"' || char === "'") {quote = char;}
67
+ else if (char === '(') {depth += 1;}
68
+ else if (char === ')') {depth = Math.max(0, depth - 1);}
69
+ else if (char === ';' && depth === 0) {add(i);}
70
+ }
71
+ add(css.length);
72
+ return styles;
73
+ }
74
+ // Auto-width wrapping text can change size when moved into a narrower lane.
75
+ // Fixed/max-content widths and no-wrap labels only need translation math.
76
+ const wrapsAtPosition = (style) => (!style.width || style.width === 'auto') && !['nowrap', 'pre'].includes(style.whiteSpace);
77
+ function layoutState(node) {
78
+ const style = node.style ?? {};
79
+ const css = 'cssText' in style ? style.cssText : undefined;
80
+ if (typeof css === 'string') {return { text: node.textContent, className: node.className, css };}
81
+ return { text: node.textContent, className: node.className,
82
+ styles: Object.fromEntries(sizeStyles.map((key) => [key, style[key]])),
83
+ left: wrapsAtPosition(style) ? style.left : null, right: wrapsAtPosition(style) ? style.right : null };
84
+ }
85
+ function layoutChanged(node, previous) {
86
+ if (node.textContent !== previous.text || node.className !== previous.className) {return true;}
87
+ const style = node.style ?? {};
88
+ const css = 'cssText' in style ? style.cssText : undefined;
89
+ if (typeof css === 'string') {
90
+ if (css === previous.css) {return false;}
91
+ if (previous.css === undefined) {return true;}
92
+ // Parse the stored sample at most once; moving/fading surfaces can keep
93
+ // that same measurement for many frames without native per-style reads.
94
+ const before = previous.parsed ??= parseStyles(previous.css), after = parseStyles(css);
95
+ return [...new Set([...Object.keys(before), ...Object.keys(after)])].some((key) =>
96
+ (sizeProperties.has(key) || key.startsWith('font-') || key.startsWith('border') || key.startsWith('padding')) && before[key] !== after[key])
97
+ || (wrapsAtPosition({ width: after.width, whiteSpace: after['white-space'] })
98
+ && (before.left !== after.left || before.right !== after.right));
99
+ }
100
+ return !previous.styles || sizeStyles.some((key) => style[key] !== previous.styles[key])
101
+ || (wrapsAtPosition(style) && (style.left !== previous.left || style.right !== previous.right));
102
+ }
103
+
104
+ // Positioned measurements are refreshed at least this often, whatever the
105
+ // observer saw: inherited changes above a source and late font metrics.
106
+ const REFRESH_FRAMES = 30;
107
+
108
+ export function makeLayoutCache() {
109
+ const sources = new Map(), snapshot = new Map(), dirty = new Set(), descendants = new Set(), structural = new Set();
110
+ // Sources mutated since their stored layoutState; only a fresh sample clears it.
111
+ const unsampled = new Set();
112
+ let active = false, viewport, frame = 0, reconnect = false;
113
+ function changedChildren(node) {
114
+ for (const child of node.children ?? []) {
115
+ if (sources.has(child)) {descendants.add(child);}
116
+ changedChildren(child);
117
+ }
118
+ }
119
+ function mutations(records) {
120
+ const parents = new Set();
121
+ for (const record of records) {
122
+ if (record.type === 'attributes' && record.target.children?.length) {parents.add(record.target);}
123
+ for (let node = record.target; node; node = node.parentElement ?? node.parentNode ?? node.parent) {
124
+ if (!sources.has(node)) {continue;}
125
+ dirty.add(node); unsampled.add(node);
126
+ if (record.type === 'childList') {structural.add(node);}
127
+ if (node !== record.target) {descendants.add(node);}
128
+ }
129
+ }
130
+ // Inherited font/width changes can resize positioned descendants without
131
+ // touching their own inline inputs. Refresh those in the next read phase.
132
+ for (const node of parents) {changedChildren(node);}
133
+ }
134
+ const observe = (node) => observer?.observe(node, { subtree: true, childList: true, characterData: true,
135
+ attributes: true, attributeFilter: ['style', 'class'] });
136
+ const observer = globalThis.MutationObserver ? new globalThis.MutationObserver(mutations) : null;
137
+ function changes() {
138
+ if (!observer) {return;}
139
+ // MutationObserver callbacks run after this synchronous frame. Drain writes
140
+ // now too, so growing copy/wrapping is visible to the next consumer.
141
+ mutations(observer.takeRecords?.() ?? []);
142
+ if (!reconnect) {return;}
143
+ observer.disconnect();
144
+ for (const node of sources.keys()) {observe(node);}
145
+ reconnect = false;
146
+ }
147
+ const fonts = globalThis.document?.fonts;
148
+ const fontsLoaded = () => snapshot.clear();
149
+ fonts?.addEventListener?.('loadingdone', fontsLoaded);
150
+ const view = () => active ? viewport : { w: globalThis.window?.innerWidth, h: globalThis.window?.innerHeight };
151
+ function register(node, options = {}) {
152
+ if (node) {
153
+ const previous = sources.get(node);
154
+ sources.set(node, { ...previous, ...options });
155
+ if (!previous) {observe(node);}
156
+ }
157
+ return node;
158
+ }
159
+ function forget(node) {
160
+ if (sources.delete(node)) {reconnect = true;}
161
+ snapshot.delete(node); dirty.delete(node); descendants.delete(node); structural.delete(node); unsampled.delete(node);
162
+ for (const child of node.children ?? []) {forget(child);}
163
+ }
164
+ // Release observer membership as soon as a surface leaves, once per call.
165
+ function unregister(node) {
166
+ if (!node) {return;}
167
+ forget(node);
168
+ if (reconnect) {changes();}
169
+ }
170
+ // An observed source with no mutation since its last layout sample keeps
171
+ // that sample's copy and inline styles; only geometry is read again.
172
+ function measure(node, previous) {
173
+ const shown = displayed(node);
174
+ const box = shown ? node.getBoundingClientRect() : { left: 0, right: 0, top: 0, bottom: 0, width: 0, height: 0 };
175
+ const options = sources.get(node);
176
+ const style = node.style ?? {};
177
+ const reuse = shown && observer && previous?.layout && !unsampled.has(node);
178
+ if (shown && !reuse) {unsampled.delete(node);}
179
+ const measured = {
180
+ rect: { left: box.left, right: box.right, top: box.top, bottom: box.bottom, width: box.width, height: box.height },
181
+ size: { w: shown ? node.offsetWidth : 0, h: shown ? node.offsetHeight : 0 },
182
+ offsets: { left: shown ? node.offsetLeft ?? 0 : 0, top: shown ? node.offsetTop ?? 0 : 0 },
183
+ position: { left: style.left, top: style.top, translate: style.translate, transform: style.transform },
184
+ displayed: shown, frame,
185
+ layout: !shown ? null : reuse ? previous.layout : layoutState(node),
186
+ };
187
+ if (options?.fit) {measured.fit = { client: shown ? node.clientWidth : 0, scroll: shown ? node.scrollWidth : 0, text: node.textContent, fontSize: style.fontSize };}
188
+ if (options?.scroll) {measured.scroll = { height: shown ? node.scrollHeight : 0, top: shown ? node.scrollTop : 0, client: shown ? node.clientHeight : 0 };}
189
+ if (options?.padding) {
190
+ const computed = shown ? globalThis.getComputedStyle?.(node) ?? style : {};
191
+ measured.padding = Object.fromEntries(['Left', 'Right', 'Top', 'Bottom'].map((edge) => [edge.toLowerCase(), Number.parseFloat(computed[`padding${edge}`]) || 0]));
192
+ }
193
+ return measured;
194
+ }
195
+ function used(node) {
196
+ if (!sources.has(node)) {register(node);}
197
+ sources.get(node).readFrame = frame;
198
+ return node;
199
+ }
200
+ function read(node) {
201
+ used(node); changes();
202
+ const options = sources.get(node);
203
+ let measured = snapshot.get(node);
204
+ const shown = displayed(node);
205
+ // Descendant style changes retain the current read-phase sample, then
206
+ // refresh next frame. Own copy/size changes still refresh immediately.
207
+ if (!measured || measured.displayed !== shown || (shown && !options.positioned && measured.frame !== frame)
208
+ || (shown && structural.has(node))
209
+ || (shown && (!observer || dirty.has(node)) && layoutChanged(node, measured.layout))) {
210
+ measured = measure(node); snapshot.set(node, measured); descendants.delete(node);
211
+ }
212
+ dirty.delete(node); structural.delete(node);
213
+ return measured;
214
+ }
215
+ return {
216
+ register, unregister, invalidate: (node) => snapshot.delete(node), view, active: () => active,
217
+ beginFrame(nodes = []) {
218
+ for (const node of nodes) {register(node);}
219
+ changes();
220
+ const next = { w: globalThis.window?.innerWidth, h: globalThis.window?.innerHeight };
221
+ if (viewport?.w !== next.w || viewport?.h !== next.h) {snapshot.clear();}
222
+ active = true; viewport = next; frame += 1;
223
+ // Keep positioned measurements through walking/camera frames. In-flow
224
+ // surfaces used last frame must still sample sibling/ancestor movement
225
+ // before writes, even when no mutation touched their own size inputs.
226
+ for (const [node, options] of sources) {
227
+ if (node.isConnected === false) {unregister(node); continue;}
228
+ if (!displayed(node)) {snapshot.delete(node); continue;}
229
+ const measured = snapshot.get(node);
230
+ if (!measured?.displayed || (!options.positioned && options.readFrame === frame - 1)
231
+ || (options.positioned && (descendants.has(node) || structural.has(node) || frame - measured.frame >= REFRESH_FRAMES
232
+ || ((!observer || dirty.has(node)) && layoutChanged(node, measured.layout))))) {
233
+ snapshot.set(node, measure(node, measured));
234
+ }
235
+ }
236
+ dirty.clear(); descendants.clear(); structural.clear();
237
+ },
238
+ endFrame() {active = false;},
239
+ rect(node) {
240
+ if (!active) {return used(node).getBoundingClientRect();}
241
+ const measured = read(node);
242
+ // These owned world layers have no transformed ancestors. Use their
243
+ // snapshot size at the new pixel position, without another DOM read.
244
+ if (!measured.displayed) {return measured.rect;}
245
+ if (sources.get(node)?.positioned) {return shift(measured.rect, measured.position, node.style, viewport);}
246
+ // Caption and other surface translations can be restored after the
247
+ // snapshot too; derive that move without re-reading their layout.
248
+ return measured.position.translate !== node.style.translate
249
+ ? shift(measured.rect, { translate: measured.position.translate }, { translate: node.style.translate }, viewport)
250
+ : measured.rect;
251
+ },
252
+ size: (node) => active ? read(node).size : { w: used(node).offsetWidth, h: node.offsetHeight },
253
+ dimensions(node) {const box = this.rect(node); return { w: box.width, h: box.height };},
254
+ offsets: (node) => active ? read(node).offsets : { left: used(node).offsetLeft ?? 0, top: node.offsetTop ?? 0 },
255
+ fit: (node) => active ? read(node).fit : { client: used(node).clientWidth, scroll: node.scrollWidth, text: node.textContent, fontSize: node.style.fontSize },
256
+ scroll: (node) => active ? read(node).scroll : { height: used(node).scrollHeight, top: node.scrollTop, client: node.clientHeight },
257
+ padding: (node) => active ? read(node).padding : (() => {
258
+ used(node);
259
+ const style = globalThis.getComputedStyle?.(node) ?? node.style;
260
+ return Object.fromEntries(['Left', 'Right', 'Top', 'Bottom'].map((edge) => [edge.toLowerCase(), Number.parseFloat(style[`padding${edge}`]) || 0]));
261
+ })(),
262
+ dispose() {active = false; observer?.disconnect(); fonts?.removeEventListener?.('loadingdone', fontsLoaded); structural.clear(); unsampled.clear(); sources.clear(); snapshot.clear(); dirty.clear(); descendants.clear(); viewport = null;},
263
+ };
264
+ }
@@ -0,0 +1,20 @@
1
+ // v1.138: which transports' places asked for load stages, and what each was told.
2
+ // Allocate nothing until an opted-in server snapshot arrives.
3
+ import { CLIENT_LOAD_STAGES } from '../shared/loadStages.js';
4
+ let sessions;
5
+ export function setLoadTelemetry(net, on) {
6
+ if (!net) {return;}
7
+ if (on === true) {
8
+ sessions ??= new WeakMap();
9
+ if (!sessions.has(net)) {sessions.set(net, { sent: 0 });}
10
+ } else {sessions?.delete(net);}
11
+ }
12
+ export function loadTelemetryFor(net) {return net ? sessions?.has(net) === true : false;}
13
+ // Send one client stage once per transport, only upward.
14
+ export function reportLoadStage(net, stage) {
15
+ const state = net ? sessions?.get(net) : undefined;
16
+ if (!state || !CLIENT_LOAD_STAGES.includes(stage) || stage <= state.sent) {return false;}
17
+ state.sent = stage;
18
+ try { net.send({ k: 'hub-load', stage }); } catch { return false; }
19
+ return true;
20
+ }