castle-web-cli 0.4.239 → 0.4.240

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 (386) hide show
  1. package/dist/agent.js +5 -1
  2. package/dist/api.d.ts +20 -0
  3. package/dist/api.js +57 -0
  4. package/dist/bundle.d.ts +38 -1
  5. package/dist/bundle.js +309 -13
  6. package/dist/castle-host/host.js +163 -11
  7. package/dist/castleJson.d.ts +10 -0
  8. package/dist/castleJson.js +46 -2
  9. package/dist/check.js +5 -2
  10. package/dist/devSessionServer.js +4 -1
  11. package/dist/devSessionStorage.d.ts +1 -0
  12. package/dist/devSessionStorage.js +32 -7
  13. package/dist/importOrder.d.ts +2 -0
  14. package/dist/importOrder.js +29 -0
  15. package/dist/index.js +6 -3
  16. package/dist/init.js +24 -2
  17. package/dist/platformDoc.js +2 -1
  18. package/dist/playPagePolicy.js +5 -1
  19. package/dist/resetLeaderboards.d.ts +8 -1
  20. package/dist/resetLeaderboards.js +43 -8
  21. package/dist/save-deck.d.ts +32 -2
  22. package/dist/save-deck.js +240 -39
  23. package/kits/base/CLAUDE.md +1 -1
  24. package/kits/base/castle.json +1 -1
  25. package/kits/base/sdk/README.md +174 -6
  26. package/kits/base/sdk/analytics.d.ts +8 -0
  27. package/kits/base/sdk/analytics.js +92 -0
  28. package/kits/base/sdk/castle.d.ts +5 -1
  29. package/kits/base/sdk/castle.js +2 -0
  30. package/kits/base/sdk/commands.d.ts +48 -0
  31. package/kits/base/sdk/commands.js +1 -0
  32. package/kits/base/sdk/debugConsole.d.ts +17 -0
  33. package/kits/base/sdk/debugConsole.js +154 -0
  34. package/kits/base/sdk/experiments.js +24 -1
  35. package/kits/base/sdk/hostRetry.d.ts +7 -0
  36. package/kits/base/sdk/hostRetry.js +57 -0
  37. package/kits/base/sdk/hub.d.ts +20 -2
  38. package/kits/base/sdk/hub.js +99 -13
  39. package/kits/base/sdk/multiplayer.d.ts +2 -0
  40. package/kits/base/sdk/multiplayer.js +168 -26
  41. package/kits/base/sdk/reconnectBudget.d.ts +6 -0
  42. package/kits/base/sdk/reconnectBudget.js +41 -1
  43. package/kits/base/sdk/runtime.js +36 -19
  44. package/kits/base/sdk/server/hub.d.ts +19 -0
  45. package/kits/base/sdk/server/hub.js +12 -0
  46. package/kits/base/sdk/server/platformHandle.d.ts +1 -0
  47. package/kits/base/sdk/server/wrapper.d.ts +1 -1
  48. package/kits/base/sdk/server/wrapper.js +26 -1
  49. package/kits/base/sdk/transport.d.ts +2 -1
  50. package/kits/base/sdk/transport.js +35 -0
  51. package/kits/hub-game/CLAUDE.md +66 -19
  52. package/kits/hub-game/code/client/act.js +9 -6
  53. package/kits/hub-game/code/client/actCore.js +26 -6
  54. package/kits/hub-game/code/client/actGateLog.js +36 -0
  55. package/kits/hub-game/code/client/actionOverflow.js +29 -8
  56. package/kits/hub-game/code/client/actionRailSurface.js +186 -0
  57. package/kits/hub-game/code/client/actionRailTree.js +173 -0
  58. package/kits/hub-game/code/client/askSurface.js +85 -0
  59. package/kits/hub-game/code/client/askTree.js +51 -0
  60. package/kits/hub-game/code/client/attention.js +31 -6
  61. package/kits/hub-game/code/client/ballot.js +42 -5
  62. package/kits/hub-game/code/client/ballotSurface.js +115 -0
  63. package/kits/hub-game/code/client/ballotTree.js +180 -0
  64. package/kits/hub-game/code/client/catchingUp.js +19 -0
  65. package/kits/hub-game/code/client/celebrate.js +66 -0
  66. package/kits/hub-game/code/client/chrome.js +473 -53
  67. package/kits/hub-game/code/client/companion.js +93 -23
  68. package/kits/hub-game/code/client/companionDress.js +1 -1
  69. package/kits/hub-game/code/client/cornerSurface.js +106 -0
  70. package/kits/hub-game/code/client/cornerTree.js +83 -0
  71. package/kits/hub-game/code/client/decor.js +20 -11
  72. package/kits/hub-game/code/client/deviceStorage.js +121 -0
  73. package/kits/hub-game/code/client/disguise.js +23 -0
  74. package/kits/hub-game/code/client/disguiseDraw.js +87 -0
  75. package/kits/hub-game/code/client/dockSurface.js +206 -0
  76. package/kits/hub-game/code/client/dockTree.js +232 -0
  77. package/kits/hub-game/code/client/earned.js +29 -0
  78. package/kits/hub-game/code/client/emoteSurface.js +188 -0
  79. package/kits/hub-game/code/client/emoteTree.js +264 -0
  80. package/kits/hub-game/code/client/farAvatars.js +4 -3
  81. package/kits/hub-game/code/client/fpsTelemetry.js +3 -1
  82. package/kits/hub-game/code/client/grab.js +121 -50
  83. package/kits/hub-game/code/client/holdShow.js +19 -0
  84. package/kits/hub-game/code/client/hookLayer.js +96 -12
  85. package/kits/hub-game/code/client/hubControls.js +7 -1
  86. package/kits/hub-game/code/client/hudSurface.js +11 -3
  87. package/kits/hub-game/code/client/hudTree.js +7 -4
  88. package/kits/hub-game/code/client/idle.js +21 -3
  89. package/kits/hub-game/code/client/invites.js +24 -3
  90. package/kits/hub-game/code/client/keys.js +15 -0
  91. package/kits/hub-game/code/client/labelsNear.js +8 -1
  92. package/kits/hub-game/code/client/layoutCache.js +57 -8
  93. package/kits/hub-game/code/client/loadingCover.js +53 -4
  94. package/kits/hub-game/code/client/menuIcons.js +15 -0
  95. package/kits/hub-game/code/client/menuSurface.js +102 -0
  96. package/kits/hub-game/code/client/menuTree.js +135 -0
  97. package/kits/hub-game/code/client/modelLook.js +41 -0
  98. package/kits/hub-game/code/client/pickerSurface.js +152 -0
  99. package/kits/hub-game/code/client/pickerTree.js +163 -0
  100. package/kits/hub-game/code/client/pushVisit.js +4 -2
  101. package/kits/hub-game/code/client/quality.js +188 -29
  102. package/kits/hub-game/code/client/qualityEntry.js +10 -1
  103. package/kits/hub-game/code/client/quickChatSurface.js +222 -0
  104. package/kits/hub-game/code/client/quickChatTree.js +201 -0
  105. package/kits/hub-game/code/client/rehello.js +75 -0
  106. package/kits/hub-game/code/client/renderVisibility.js +17 -0
  107. package/kits/hub-game/code/client/replay.js +118 -0
  108. package/kits/hub-game/code/client/role.js +3 -0
  109. package/kits/hub-game/code/client/safeLayout.js +441 -56
  110. package/kits/hub-game/code/client/safeStyle.js +13 -10
  111. package/kits/hub-game/code/client/say.js +2 -0
  112. package/kits/hub-game/code/client/soundSurface.js +77 -0
  113. package/kits/hub-game/code/client/soundTree.js +74 -0
  114. package/kits/hub-game/code/client/soundscape.js +12 -9
  115. package/kits/hub-game/code/client/soundscapeCues.js +1 -1
  116. package/kits/hub-game/code/client/state.js +67 -1
  117. package/kits/hub-game/code/client/stuckSurface.js +76 -0
  118. package/kits/hub-game/code/client/stuckTree.js +67 -0
  119. package/kits/hub-game/code/client/talk.js +42 -12
  120. package/kits/hub-game/code/client/talkTree.js +4 -2
  121. package/kits/hub-game/code/client/textAskSurface.js +147 -0
  122. package/kits/hub-game/code/client/textAskTree.js +67 -0
  123. package/kits/hub-game/code/client/tiers.js +252 -27
  124. package/kits/hub-game/code/client/together.js +4 -1
  125. package/kits/hub-game/code/client/uiDom.js +86 -8
  126. package/kits/hub-game/code/client/uiTree.js +33 -4
  127. package/kits/hub-game/code/client/vehicle.js +72 -51
  128. package/kits/hub-game/code/client/weakestTier.js +75 -31
  129. package/kits/hub-game/code/client/wear.js +159 -5
  130. package/kits/hub-game/code/client/worldLabels.js +205 -25
  131. package/kits/hub-game/code/companionSpec.js +4 -2
  132. package/kits/hub-game/code/server/act.js +3 -0
  133. package/kits/hub-game/code/server/actGate.js +83 -0
  134. package/kits/hub-game/code/server/actions.js +71 -15
  135. package/kits/hub-game/code/server/actors.js +20 -5
  136. package/kits/hub-game/code/server/analytics.js +35 -3
  137. package/kits/hub-game/code/server/ask.js +39 -3
  138. package/kits/hub-game/code/server/ballot.js +167 -4
  139. package/kits/hub-game/code/server/celebrate.js +64 -0
  140. package/kits/hub-game/code/server/companion.js +17 -2
  141. package/kits/hub-game/code/server/decor.js +11 -2
  142. package/kits/hub-game/code/server/disguise.js +63 -0
  143. package/kits/hub-game/code/server/earned.js +6 -2
  144. package/kits/hub-game/code/server/friendBests.js +13 -4
  145. package/kits/hub-game/code/server/friendsAmong.js +67 -8
  146. package/kits/hub-game/code/server/grab.js +12 -2
  147. package/kits/hub-game/code/server/heldOffers.js +142 -0
  148. package/kits/hub-game/code/server/holdShow.js +98 -0
  149. package/kits/hub-game/code/server/hub.js +851 -45
  150. package/kits/hub-game/code/server/idle.js +110 -9
  151. package/kits/hub-game/code/server/index.js +9 -0
  152. package/kits/hub-game/code/server/labels.js +13 -3
  153. package/kits/hub-game/code/server/manifest.js +94 -6
  154. package/kits/hub-game/code/server/menu.js +26 -3
  155. package/kits/hub-game/code/server/npcs.js +55 -9
  156. package/kits/hub-game/code/server/observe.js +67 -6
  157. package/kits/hub-game/code/server/players.js +8 -1
  158. package/kits/hub-game/code/server/replay.js +135 -0
  159. package/kits/hub-game/code/server/storageLimit.js +4 -1
  160. package/kits/hub-game/code/server/townDay.js +74 -0
  161. package/kits/hub-game/code/server/vehicle.js +3 -0
  162. package/kits/hub-game/code/server/vis.js +26 -4
  163. package/kits/hub-game/code/server/wallet.js +677 -0
  164. package/kits/hub-game/code/server/wear.js +13 -3
  165. package/kits/hub-game/code/server/writerLease.js +191 -0
  166. package/kits/hub-game/code/shared/act.js +1 -1
  167. package/kits/hub-game/code/shared/expression.js +6 -0
  168. package/kits/hub-game/code/shared/replay.js +37 -0
  169. package/kits/hub-game/code/systems/hub.js +427 -54
  170. package/kits/hub-game/docs/analytics.md +16 -2
  171. package/kits/hub-game/docs/contract.md +942 -99
  172. package/kits/hub-game/docs/home-pieces.md +5 -6
  173. package/kits/hub-game/docs/observed-progress.md +49 -1
  174. package/kits/hub-game/docs/vehicle-preset.md +23 -0
  175. package/kits/hub-game/index.html +1 -0
  176. package/kits/hub-game/models/hats/baker-cap.pxmodel +3 -3
  177. package/kits/hub-game/models/hats/bat-clip.pxmodel +3 -3
  178. package/kits/hub-game/models/hats/beekeeper.pxmodel +3 -3
  179. package/kits/hub-game/models/hats/cap.pxmodel +3 -3
  180. package/kits/hub-game/models/hats/captain.pxmodel +3 -3
  181. package/kits/hub-game/models/hats/chef-toque.pxmodel +3 -3
  182. package/kits/hub-game/models/hats/crooked-top.pxmodel +3 -3
  183. package/kits/hub-game/models/hats/delivery-cap.pxmodel +3 -3
  184. package/kits/hub-game/models/hats/fire-helmet.pxmodel +3 -3
  185. package/kits/hub-game/models/hats/flower-crown.pxmodel +3 -3
  186. package/kits/hub-game/models/hats/foam-crown.pxmodel +3 -3
  187. package/kits/hub-game/models/hats/hard-hat.pxmodel +3 -3
  188. package/kits/hub-game/models/hats/lantern.pxmodel +3 -3
  189. package/kits/hub-game/models/hats/laurel.pxmodel +3 -3
  190. package/kits/hub-game/models/hats/lighthouse.pxmodel +3 -3
  191. package/kits/hub-game/models/hats/nurse-cap.pxmodel +3 -3
  192. package/kits/hub-game/models/hats/police-cap.pxmodel +3 -3
  193. package/kits/hub-game/models/hats/sailor.pxmodel +3 -3
  194. package/kits/hub-game/models/hats/souwester.pxmodel +3 -3
  195. package/kits/hub-game/models/hats/straw.pxmodel +3 -3
  196. package/kits/hub-game/models/hats/sunflower.pxmodel +3 -3
  197. package/kits/hub-game/models/hats/sweatband.pxmodel +3 -3
  198. package/kits/hub-game/models/hats/teacher-beret.pxmodel +3 -3
  199. package/kits/hub-game/models/hats/witch.pxmodel +3 -3
  200. package/kits/hub-game/models/hold-show/daisy.pxmodel +231 -0
  201. package/kits/hub-game/models/hold-show/moonflower.pxmodel +171 -0
  202. package/kits/hub-game/models/hold-show/rose.pxmodel +191 -0
  203. package/kits/hub-game/models/hold-show/square/daisy.pxmodel +233 -0
  204. package/kits/hub-game/models/hold-show/square/moonflower.pxmodel +173 -0
  205. package/kits/hub-game/models/hold-show/square/rose.pxmodel +193 -0
  206. package/kits/hub-game/models/hold-show/square/sunflower.pxmodel +313 -0
  207. package/kits/hub-game/models/hold-show/square/tulip.pxmodel +133 -0
  208. package/kits/hub-game/models/hold-show/sunflower.pxmodel +311 -0
  209. package/kits/hub-game/models/hold-show/tulip.pxmodel +131 -0
  210. package/kits/hub-game/package-lock.json +3 -3
  211. package/kits/hub-game/package.json +4 -3
  212. package/kits/hub-game/scripts/fixtures/engine-models-stub.mjs +1 -0
  213. package/kits/hub-game/scripts/fixtures/hud-surface.json +12 -12
  214. package/kits/hub-game/scripts/fixtures/talk-surface.json +8 -8
  215. package/kits/hub-game/scripts/gen-hats.mjs +1 -1
  216. package/kits/hub-game/scripts/gen-hold-show.mjs +27 -0
  217. package/kits/hub-game/scripts/pack.mjs +89 -23
  218. package/kits/hub-game/scripts/test-act-client.mjs +5 -0
  219. package/kits/hub-game/scripts/test-act-core.mjs +32 -0
  220. package/kits/hub-game/scripts/test-act-gate.mjs +186 -0
  221. package/kits/hub-game/scripts/test-action-rail-crowded-dom.mjs +7 -1
  222. package/kits/hub-game/scripts/test-action-rail-default-dom.mjs +102 -0
  223. package/kits/hub-game/scripts/test-action-rail-never-silent-dom.mjs +50 -0
  224. package/kits/hub-game/scripts/test-action-rail-surface.mjs +368 -0
  225. package/kits/hub-game/scripts/test-action-rail-town-jobs-dom.mjs +118 -0
  226. package/kits/hub-game/scripts/test-actions-client.mjs +5 -3
  227. package/kits/hub-game/scripts/test-actions.mjs +24 -0
  228. package/kits/hub-game/scripts/test-actors.mjs +19 -0
  229. package/kits/hub-game/scripts/test-again-corner-dom.mjs +59 -0
  230. package/kits/hub-game/scripts/test-analytics.mjs +79 -0
  231. package/kits/hub-game/scripts/test-arrival-pose-server.mjs +25 -8
  232. package/kits/hub-game/scripts/test-ask-client.mjs +9 -0
  233. package/kits/hub-game/scripts/test-ask-surface.mjs +188 -0
  234. package/kits/hub-game/scripts/test-attention.mjs +43 -1
  235. package/kits/hub-game/scripts/test-ballot-sheet-dom.mjs +71 -0
  236. package/kits/hub-game/scripts/test-ballot-surface.mjs +276 -0
  237. package/kits/hub-game/scripts/test-ballot.mjs +420 -3
  238. package/kits/hub-game/scripts/test-ban-join.mjs +1 -1
  239. package/kits/hub-game/scripts/test-celebrate-client.mjs +62 -0
  240. package/kits/hub-game/scripts/test-celebrate.mjs +116 -0
  241. package/kits/hub-game/scripts/test-chat.mjs +73 -0
  242. package/kits/hub-game/scripts/test-companion-client.mjs +203 -21
  243. package/kits/hub-game/scripts/test-companion.mjs +110 -3
  244. package/kits/hub-game/scripts/test-control-layout-dom.mjs +57 -10
  245. package/kits/hub-game/scripts/test-corner-surface.mjs +268 -0
  246. package/kits/hub-game/scripts/test-decor-client.mjs +59 -3
  247. package/kits/hub-game/scripts/test-decor.mjs +27 -0
  248. package/kits/hub-game/scripts/test-device-class.mjs +4 -1
  249. package/kits/hub-game/scripts/test-disguise-client.mjs +281 -0
  250. package/kits/hub-game/scripts/test-disguise.mjs +176 -0
  251. package/kits/hub-game/scripts/test-dock-surface.mjs +404 -0
  252. package/kits/hub-game/scripts/test-door-stay-client.mjs +602 -0
  253. package/kits/hub-game/scripts/test-door-stay.mjs +613 -0
  254. package/kits/hub-game/scripts/test-earned-client.mjs +119 -0
  255. package/kits/hub-game/scripts/test-emote-surface.mjs +616 -0
  256. package/kits/hub-game/scripts/test-fps-telemetry.mjs +39 -4
  257. package/kits/hub-game/scripts/test-friend-bests.mjs +38 -12
  258. package/kits/hub-game/scripts/test-ghost-click-dom.mjs +75 -0
  259. package/kits/hub-game/scripts/test-grab-client.mjs +29 -2
  260. package/kits/hub-game/scripts/test-grab-orbit.mjs +260 -11
  261. package/kits/hub-game/scripts/test-grab.mjs +10 -1
  262. package/kits/hub-game/scripts/test-hats.mjs +28 -0
  263. package/kits/hub-game/scripts/test-held-offers.mjs +394 -0
  264. package/kits/hub-game/scripts/test-high-only.mjs +3 -3
  265. package/kits/hub-game/scripts/test-hold-show-client.mjs +175 -0
  266. package/kits/hub-game/scripts/test-hold-show.mjs +355 -0
  267. package/kits/hub-game/scripts/test-hub-controls.mjs +3 -1
  268. package/kits/hub-game/scripts/test-hub-idle.mjs +348 -0
  269. package/kits/hub-game/scripts/test-hub-leaving.mjs +21 -0
  270. package/kits/hub-game/scripts/test-hub-ops.mjs +119 -0
  271. package/kits/hub-game/scripts/test-hub-trip.mjs +240 -4
  272. package/kits/hub-game/scripts/test-hud-clear.mjs +83 -0
  273. package/kits/hub-game/scripts/test-hud-rate.mjs +2 -1
  274. package/kits/hub-game/scripts/test-idle.mjs +160 -0
  275. package/kits/hub-game/scripts/test-invites-client.mjs +53 -0
  276. package/kits/hub-game/scripts/test-labels.mjs +11 -0
  277. package/kits/hub-game/scripts/test-landscape-layout.mjs +20 -0
  278. package/kits/hub-game/scripts/test-loading-cover.mjs +67 -1
  279. package/kits/hub-game/scripts/test-manifest.mjs +27 -0
  280. package/kits/hub-game/scripts/test-menu-client.mjs +54 -5
  281. package/kits/hub-game/scripts/test-menu-surface.mjs +236 -0
  282. package/kits/hub-game/scripts/test-npcs.mjs +128 -0
  283. package/kits/hub-game/scripts/test-observed.mjs +171 -3
  284. package/kits/hub-game/scripts/test-pack.mjs +166 -0
  285. package/kits/hub-game/scripts/test-picker-surface.mjs +321 -0
  286. package/kits/hub-game/scripts/test-placeat-server.mjs +395 -0
  287. package/kits/hub-game/scripts/test-placement-cache.mjs +1 -1
  288. package/kits/hub-game/scripts/test-pointer-clear-dom.mjs +82 -0
  289. package/kits/hub-game/scripts/test-progress-reset.mjs +184 -6
  290. package/kits/hub-game/scripts/test-push-visit.mjs +9 -0
  291. package/kits/hub-game/scripts/test-quality.mjs +312 -9
  292. package/kits/hub-game/scripts/test-quick-chat-surface.mjs +511 -0
  293. package/kits/hub-game/scripts/test-rehello.mjs +237 -0
  294. package/kits/hub-game/scripts/test-rejoin-yaw.mjs +138 -0
  295. package/kits/hub-game/scripts/test-relations-among.mjs +13 -7
  296. package/kits/hub-game/scripts/test-relations-refresh.mjs +90 -2
  297. package/kits/hub-game/scripts/test-replay-client.mjs +110 -0
  298. package/kits/hub-game/scripts/test-replay.mjs +178 -0
  299. package/kits/hub-game/scripts/test-resume-held.mjs +13 -0
  300. package/kits/hub-game/scripts/test-resume-pose-server.mjs +43 -5
  301. package/kits/hub-game/scripts/test-role-client.mjs +2 -1
  302. package/kits/hub-game/scripts/test-safe-act.mjs +233 -0
  303. package/kits/hub-game/scripts/test-safe-caption.mjs +364 -0
  304. package/kits/hub-game/scripts/test-safe-layout.mjs +79 -0
  305. package/kits/hub-game/scripts/test-safe-prompt.mjs +163 -0
  306. package/kits/hub-game/scripts/test-sound-surface.mjs +256 -0
  307. package/kits/hub-game/scripts/test-soundscape.mjs +85 -2
  308. package/kits/hub-game/scripts/test-stuck-surface.mjs +174 -0
  309. package/kits/hub-game/scripts/test-stuck.mjs +31 -0
  310. package/kits/hub-game/scripts/test-talk-surface.mjs +23 -6
  311. package/kits/hub-game/scripts/test-talk-walk-dom.mjs +123 -0
  312. package/kits/hub-game/scripts/test-text-ask-surface.mjs +273 -0
  313. package/kits/hub-game/scripts/test-tiers.mjs +453 -3
  314. package/kits/hub-game/scripts/test-toast-no-row-dom.mjs +71 -0
  315. package/kits/hub-game/scripts/test-together.mjs +11 -0
  316. package/kits/hub-game/scripts/test-town-day.mjs +90 -0
  317. package/kits/hub-game/scripts/test-try-on.mjs +39 -0
  318. package/kits/hub-game/scripts/test-ui-dom-dom.mjs +49 -2
  319. package/kits/hub-game/scripts/test-ui-tree.mjs +28 -0
  320. package/kits/hub-game/scripts/test-vehicle-client.mjs +68 -1
  321. package/kits/hub-game/scripts/test-vis.mjs +145 -0
  322. package/kits/hub-game/scripts/test-wallet.mjs +650 -0
  323. package/kits/hub-game/scripts/test-weakest-tier.mjs +135 -1
  324. package/kits/hub-game/scripts/test-world-labels.mjs +340 -0
  325. package/kits/hub-game/scripts/test-writer-lease-server.mjs +234 -0
  326. package/kits/hub-game/scripts/test-writer-lease.mjs +281 -0
  327. package/kits/hub-game/scripts/writer-storage-fixture.mjs +37 -0
  328. package/kits/hub-game/tools/hubScene/export.mjs +6 -5
  329. package/kits/hub-game/tools/hubScene/hubdata.mjs +10 -0
  330. package/kits/hub-game/tools/hubScene/test/export-fixture.mjs +36 -2
  331. package/kits/hub-game/tools/hubScene/validate-manifest.mjs +10 -2
  332. package/kits/multiplayer-3d/castle.json +5 -5
  333. package/kits/multiplayer-3d/code/client/resumeGate.js +49 -2
  334. package/kits/multiplayer-3d/code/server/ownership.js +25 -6
  335. package/kits/multiplayer-3d/code/server/world.js +19 -4
  336. package/kits/multiplayer-3d/code/systems/multiplayer.js +67 -11
  337. package/kits/multiplayer-3d/package-lock.json +1 -1
  338. package/kits/multiplayer-3d/package.json +2 -1
  339. package/kits/multiplayer-3d/scripts/test-ground-half.mjs +56 -0
  340. package/kits/multiplayer-3d/scripts/test-join-watchdog.mjs +54 -3
  341. package/kits/multiplayer-3d/scripts/test-owned-moves.mjs +190 -0
  342. package/kits/multiplayer-3d/scripts/test-resume-gate.mjs +191 -5
  343. package/kits/multiplayer-3d/scripts/test-resync-reconnect.mjs +68 -0
  344. package/kits/physics-2d/castle.json +2 -2
  345. package/kits/physics-2d/engine/scene.js +10 -2
  346. package/kits/physics-3d/CLAUDE.md +14 -0
  347. package/kits/physics-3d/behaviors/Player.jsx +39 -3
  348. package/kits/physics-3d/castle.json +3 -3
  349. package/kits/physics-3d/docs/engine-model-cache.md +109 -0
  350. package/kits/physics-3d/docs/engine-player.md +76 -0
  351. package/kits/physics-3d/docs/engine-skip-work.md +16 -0
  352. package/kits/physics-3d/docs/pxmodel-format.md +5 -1
  353. package/kits/physics-3d/engine3d/gait.js +16 -8
  354. package/kits/physics-3d/engine3d/groundsize.js +23 -0
  355. package/kits/physics-3d/engine3d/kithooks.js +50 -0
  356. package/kits/physics-3d/engine3d/look.js +110 -17
  357. package/kits/physics-3d/engine3d/lookbake.js +19 -1
  358. package/kits/physics-3d/engine3d/materialpresets.js +3 -2
  359. package/kits/physics-3d/engine3d/modelcache.js +280 -0
  360. package/kits/physics-3d/engine3d/modelcachedigest.js +37 -0
  361. package/kits/physics-3d/engine3d/modelcachegate.js +69 -0
  362. package/kits/physics-3d/engine3d/modelrefs.js +13 -0
  363. package/kits/physics-3d/engine3d/optimize.js +20 -9
  364. package/kits/physics-3d/engine3d/playerRun.js +26 -1
  365. package/kits/physics-3d/engine3d/pxmodel.js +7 -3
  366. package/kits/physics-3d/engine3d/templatecache.js +722 -0
  367. package/kits/physics-3d/engine3d/world3d.js +211 -17
  368. package/kits/physics-3d/package-lock.json +1 -1
  369. package/kits/physics-3d/package.json +2 -1
  370. package/kits/physics-3d/play/behaviors/Player.js +43 -3
  371. package/kits/physics-3d/scripts/render.mjs +56 -8
  372. package/kits/physics-3d/scripts/template-cache-fixtures.mjs +37 -0
  373. package/kits/physics-3d/scripts/template-cache-v1-bytes.json +49 -0
  374. package/kits/physics-3d/scripts/test-gait.mjs +53 -9
  375. package/kits/physics-3d/scripts/test-ground-half.mjs +120 -0
  376. package/kits/physics-3d/scripts/test-model-cache.mjs +600 -0
  377. package/kits/physics-3d/scripts/test-orbit-shadow-fade.mjs +1 -0
  378. package/kits/physics-3d/scripts/test-sleeping-models.mjs +384 -0
  379. package/kits/physics-3d/scripts/test-template-cache-minified.mjs +106 -0
  380. package/kits/physics-3d/scripts/test-template-cache.mjs +519 -0
  381. package/kits/physics-3d/scripts/test-wall-slide.mjs +272 -0
  382. package/kits/physics-3d/systems/physics3d.js +51 -2
  383. package/kits/real-time/castle.json +2 -2
  384. package/kits/real-time/code/client/connection.js +3 -0
  385. package/package.json +2 -2
  386. package/vendor/three/examples/jsm/libs/fflate.module.js +2672 -0
@@ -1,6 +1,7 @@
1
1
  // Opt-in client budgets. State belongs to the runtime, never the transport or
2
2
  // authored files. The load entry installs the filter before SceneRuntime.load.
3
3
  import { deck, hub } from './state.js';
4
+ import { hideVisible, restoreVisible } from './renderVisibility.js';
4
5
  import { skippableDecor } from '../shared/quality.js';
5
6
 
6
7
  const visits = new WeakMap();
@@ -9,8 +10,32 @@ const visits = new WeakMap();
9
10
  export const allActors = (scene) => scene.actors ? [...scene.actors.values()] : scene.getActors();
10
11
  export const qualityFor = (scene) => visits.get(scene);
11
12
  export const lowQuality = (scene) => !scene.content && qualityFor(scene)?.tiers.current() === 'low' ? deck.quality?.low : null;
13
+ // v1.197: the spawned-copy cap holds in a game behind a door too, under the
14
+ // Town's quality block (the deck this page runs), counting the decor templates
15
+ // that game named apart (`hubDecorTpl`) as well as any marked in place.
16
+ export const spawnLowQuality = (scene) => qualityFor(scene)?.tiers.current() === 'low' ? deck.quality?.low : null;
17
+ export function withDecorTemplates(templates, decor) {
18
+ if (!decor?.size) {return templates;}
19
+ const out = Object.create(null);
20
+ for (const [id, components] of Object.entries(templates)) {
21
+ out[id] = decor.has(id) && components && typeof components === 'object' ? { ...components, decor: true } : components;
22
+ }
23
+ return out;
24
+ }
12
25
  const distance = (a, b) => a && b ? Math.hypot((a.x ?? 0) - (b.x ?? 0), (a.z ?? 0) - (b.z ?? 0)) : Infinity;
13
26
 
27
+ // The budgets' order: nearer first, then by id in UTF-16 code-unit order. A distance that is not a
28
+ // finite number (no point: Infinity, or NaN) sorts after every finite one, those then by id, so the
29
+ // comparator is consistent (Infinity - Infinity is NaN, which used to fall through to the id alone).
30
+ // Not localeCompare: Hermes on Android asks java.text.Collator for every call, and a Low label pass
31
+ // of ~140 items took 360 ms on a moto e22.
32
+ export function nearerThenId(da, db, ia, ib) {
33
+ const a = Number.isFinite(da) ? da : Infinity, b = Number.isFinite(db) ? db : Infinity;
34
+ if (a !== b) {return a < b ? -1 : 1;}
35
+ const x = String(ia), y = String(ib);
36
+ return x < y ? -1 : x > y ? 1 : 0;
37
+ }
38
+
14
39
  export function noteQualityInteraction(scene, playerId, now = performance.now()) {
15
40
  const q = qualityFor(scene);
16
41
  if (q && playerId) {q.recent.set(playerId, now + 10000);}
@@ -20,7 +45,7 @@ export function noteQualityInteraction(scene, playerId, now = performance.now())
20
45
  export function choosePlayers(players, most, previous = new Set()) {
21
46
  const exempt = players.filter((p) => p.exempt);
22
47
  const ranked = players.filter((p) => !p.exempt).sort((a, b) =>
23
- (a.distance - (previous.has(a.id) ? 2 : 0)) - (b.distance - (previous.has(b.id) ? 2 : 0)) || String(a.id).localeCompare(String(b.id)));
48
+ nearerThenId(a.distance - (previous.has(a.id) ? 2 : 0), b.distance - (previous.has(b.id) ? 2 : 0), a.id, b.id));
24
49
  return new Set([...exempt, ...ranked.slice(0, most)].map((p) => p.id));
25
50
  }
26
51
 
@@ -36,14 +61,15 @@ export function samePad(scene, here, there, pads = allActors(scene)) {
36
61
  }
37
62
 
38
63
  export function makeQualityVisit(tiers) {
39
- return { tiers, skipped: [], drawn: new Set(), hidden: new Map(), recent: new Map(), emotes: new Map(), nextMind: new Map(), culled: new Set() };
64
+ return { tiers, skipped: [], drawn: new Set(), hidden: new Map(), hiddenTags: new Map(), recent: new Map(), emotes: new Map(), nextMind: new Map(), culled: new Set() };
40
65
  }
41
66
 
42
67
  export function resetQualityVisit(q) {
43
- q.skipped = [];
68
+ q.skipped = []; q.culledFor = null; q.loadedHigh = null;
69
+ if (q.tags) { q.tags.list.length = 0; q.tags.of.clear(); q.tags.all.length = 0; q.tags.kept.length = 0; q.tags.pool.length = 0; }
44
70
  q.drawn.clear(); q.culled.clear(); q.recent.clear(); q.emotes.clear(); q.nextMind.clear();
45
71
  q.npcData = null; q.padData = null;
46
- restorePlayers(q);
72
+ restorePlayers(q); releaseRender(q);
47
73
  }
48
74
 
49
75
  export function filterQualityScene(scene, data, q, componentsOf = (actor) => actor.components, protectedIds = new Set()) {
@@ -53,19 +79,52 @@ export function filterQualityScene(scene, data, q, componentsOf = (actor) => act
53
79
  console.warn('[hub] hub.quality.low.spawned has no decor: true templates; the cap has no effect.');
54
80
  q.warned = true;
55
81
  }
56
- if (scene.content || q.tiers.current() !== 'low') {return data;}
57
- const skipDecor = deck.quality?.low.decor === 'skip';
58
- if (!skipDecor && !deck.highOnly) {return data;}
82
+ if (scene.content) {return data;}
83
+ if (q.tiers.current() !== 'low') {
84
+ // Kept for `lowerLate`: the authored actors (the runtime loads a copy and
85
+ // never changes these), to find what this load would have skipped on Low.
86
+ if (skipsOnLow()) {q.loadedHigh = { actors: [...(data.actors ?? [])], componentsOf, protectedIds };}
87
+ return data;
88
+ }
89
+ if (!skipsOnLow()) {return data;}
59
90
  const actors = (data.actors ?? []).filter((actor) => {
60
91
  const components = componentsOf(actor);
61
- const highOnly = deck.highOnly === true && actor.tier === 'high';
62
- if (!highOnly && (!skipDecor || protectedIds.has(actor.id) || !skippableDecor(actor, components))) {return true;}
92
+ if (!skipsOnLow(actor, components, protectedIds)) {return true;}
63
93
  q.skipped.push({ ...actor, components });
64
94
  return false;
65
95
  });
66
96
  return { ...data, actors };
67
97
  }
68
98
 
99
+ // Whether a Low load leaves this authored actor out (High-only, or skippable
100
+ // decor); with no actor, whether a Low load leaves anything out at all.
101
+ function skipsOnLow(actor, components, protectedIds) {
102
+ const skipDecor = deck.quality?.low.decor === 'skip';
103
+ if (!actor) {return skipDecor || deck.highOnly === true;}
104
+ return (deck.highOnly === true && actor.tier === 'high') ||
105
+ (skipDecor && !protectedIds.has(actor.id) && skippableDecor(actor, components));
106
+ }
107
+
108
+ // A remembered Low or Graphics pick that arrived only after the scene loaded
109
+ // as High (`deviceStorage.js`: castle.xyz's sandboxed frame reads them from
110
+ // LocalCache, asynchronously): the actors that load would have skipped on Low
111
+ // are taken out now and kept in `skipped`, so the visit is as if it had loaded
112
+ // Low and `restoreDecor` brings them back on High. Only for that late arrival
113
+ // (`tiers.lateLow`): a Low the judge finds while playing keeps its actors.
114
+ export function lowerLate(scene, q) {
115
+ if (!q.tiers.lateLow) {return;}
116
+ q.tiers.lateLow = false;
117
+ const loaded = q.loadedHigh;
118
+ if (!loaded || scene.content || q.tiers.current() !== 'low' || !skipsOnLow()) {return;}
119
+ q.loadedHigh = null;
120
+ for (const actor of loaded.actors) {
121
+ const components = loaded.componentsOf(actor);
122
+ if (skipsOnLow(actor, components, loaded.protectedIds) && scene.despawnActor(actor.id)) {
123
+ q.skipped.push({ ...actor, components });
124
+ }
125
+ }
126
+ }
127
+
69
128
  // Cooperative 8 ms slice including the engine's synchronous node build. No
70
129
  // further actor is admitted after the budget; synchronous engine work cannot
71
130
  // be preempted halfway through a single model.
@@ -87,13 +146,40 @@ export function restoreDecor(scene, q, build, clock = () => performance.now()) {
87
146
  function restorePlayers(q) {
88
147
  for (const [node, visible] of q.hidden) {node.visible = visible;}
89
148
  q.hidden.clear();
149
+ if (q.hiddenTags) {restoreVisible(q.hiddenTags);}
150
+ }
151
+
152
+ // The engine builds/replaces nodes after systems run. Scene.onBeforeRender
153
+ // is called before Three collects its draw list, so a newly built bystander
154
+ // or copy never flashes for a frame. Existing avatar-cap/far-avatar state stays live.
155
+ // Installed only while Low culls, and the exact previous callback given back
156
+ // after (as disguiseDraw.js does): still shadows cache only under the original.
157
+ // One left under another hook (a live disguise) does nothing more and unhooks
158
+ // itself the first time it is called on top again.
159
+ function holdRender(scene, q) {
160
+ const root = scene.three?.scene;
161
+ if (q.renderRoot && q.renderRoot !== root) {releaseRender(q);}
162
+ if (!root || q.renderRoot === root) {return;}
163
+ const previous = root.onBeforeRender;
164
+ const render = function (...args) {
165
+ previous?.apply(this, args);
166
+ if (q.renderBefore === render) {applyPlayerVisibility(scene, q);}
167
+ else if (this.onBeforeRender === render) {this.onBeforeRender = previous;}
168
+ };
169
+ q.renderRoot = root; q.renderBefore = render; q.renderPrevious = previous;
170
+ root.onBeforeRender = render;
171
+ }
172
+
173
+ function releaseRender(q) {
174
+ if (q.renderRoot && q.renderRoot.onBeforeRender === q.renderBefore) {q.renderRoot.onBeforeRender = q.renderPrevious;}
175
+ q.renderRoot = null; q.renderBefore = null; q.renderPrevious = null;
90
176
  }
91
177
 
92
178
  export function qualityPlayers(scene, q, now) {
93
179
  restorePlayers(q);
94
180
  const low = lowQuality(scene);
95
181
  q.culled.clear();
96
- if (!low) { q.drawn.clear(); applyPlayerVisibility(scene, q); return; }
182
+ if (!low) { q.drawn.clear(); applyPlayerVisibility(scene, q); releaseRender(q); return; }
97
183
  const mp = scene.multiplayer;
98
184
  const here = scene.actorWith('Player')?.components.Transform;
99
185
  const players = [];
@@ -117,26 +203,43 @@ export function qualityPlayers(scene, q, now) {
117
203
  samePad(scene, here, there, q.pads) || (q.recent.get(id) ?? -Infinity) > now });
118
204
  }
119
205
  q.drawn = choosePlayers(players, low.players, q.drawn);
206
+ const culledPlayers = new Set();
120
207
  for (const player of players) {
121
208
  if (q.drawn.has(player.id)) {continue;}
122
- q.culled.add(player.actorId);
209
+ q.culled.add(player.actorId); culledPlayers.add(player.id);
123
210
  }
124
- applyPlayerVisibility(scene, q);
125
- // The engine builds/replaces nodes after systems run. Scene.onBeforeRender
126
- // is called before Three collects its draw list, so a newly built bystander
127
- // never flashes for a frame. Existing avatar-cap/far-avatar state stays live.
128
- const root = scene.three?.scene;
129
- if (root && q.renderRoot !== root) {
130
- const previous = root.onBeforeRender;
131
- root.onBeforeRender = function (...args) {
132
- previous?.apply(this, args);
133
- applyPlayerVisibility(scene, q);
134
- };
135
- q.renderRoot = root;
211
+ // v1.162: a copy that names its carer (a pet) is drawn only with them.
212
+ for (const [id, copy] of Object.entries(hub.spawned ?? {})) {
213
+ if (culledPlayers.has(copy?.carer)) {q.culled.add(id);}
136
214
  }
215
+ applyPlayerVisibility(scene, q);
216
+ holdRender(scene, q);
137
217
  for (const [id, until] of q.recent) {if (until <= now) {q.recent.delete(id);}}
138
218
  }
139
219
 
220
+ // v1.168: one cull a frame, before the labels, so a mark or role is drawn
221
+ // exactly when its avatar is. The tier system's later pass culls only when the
222
+ // label pass did not run or the tier moved since; otherwise it just hides an
223
+ // avatar multiplayer added in between (no label yet), until the next frame decides.
224
+ export function cullBeforeLabels(scene, q, now) {
225
+ qualityPlayers(scene, q, now);
226
+ q.culledFor = q.tiers.current();
227
+ }
228
+
229
+ export function cullAfterTier(scene, q, now) {
230
+ const done = q.culledFor === q.tiers.current();
231
+ q.culledFor = null;
232
+ if (!done) { qualityPlayers(scene, q, now); return; }
233
+ if (!lowQuality(scene)) {return;}
234
+ const self = scene.multiplayer?.net?.selfId?.();
235
+ let added = false;
236
+ for (const [id, actorId] of scene.multiplayer?.avatars?.actors ?? []) {
237
+ if (id === self || q.drawn.has(id) || q.culled.has(actorId)) {continue;}
238
+ q.culled.add(actorId); added = true;
239
+ }
240
+ if (added) {applyPlayerVisibility(scene, q);}
241
+ }
242
+
140
243
  export function applyPlayerVisibility(scene, q) {
141
244
  restorePlayers(q);
142
245
  const nodes = new Set();
@@ -144,6 +247,16 @@ export function applyPlayerVisibility(scene, q) {
144
247
  const node = scene.three?.nodes?.get(id)?.node;
145
248
  if (node) { q.hidden.set(node, node.visible); node.visible = false; nodes.add(node); }
146
249
  }
250
+ // v1.170: a name tag is multiplayer-3d's sprite on the scene root, not under the
251
+ // avatar's node, so it is hidden with its body here and restored with it.
252
+ // Through its material: the name passes own sprite.visible, and restoring
253
+ // that would undo what they decided after the cull. It never counts under
254
+ // quality.low.labels: the body's cap already bounds it.
255
+ const avatars = scene.multiplayer?.avatars;
256
+ for (const [id, actorId] of q.culled.size ? avatars?.actors ?? [] : []) {
257
+ const material = q.culled.has(actorId) && avatars.tags?.get(id)?.sprite?.material;
258
+ if (material) { hideVisible(q.hiddenTags ??= new Map(), material); }
259
+ }
147
260
  if (nodes.size !== q.culledNodes?.size || [...nodes].some((node) => !q.culledNodes?.has(node))) {
148
261
  // Shared instances live outside avatar roots. Their matrices were gathered
149
262
  // by syncActors before Scene.onBeforeRender, so refresh on a changed cap
@@ -167,23 +280,69 @@ export function talkActors(scene) {
167
280
  // still win. Pointers never enter this list. Party labels consume no slots.
168
281
  export function capLabels(items, most, distanceOf, exempt = () => false) {
169
282
  const keep = new Set(items.filter((item) => item.kind === 'pointer' || exempt(item)).map((item) => item.id));
170
- const ranked = items.filter((item) => !keep.has(item.id)).sort((a, b) => distanceOf(a) - distanceOf(b) || String(a.id).localeCompare(String(b.id)));
283
+ const ranked = items.filter((item) => !keep.has(item.id)).sort((a, b) => nearerThenId(distanceOf(a), distanceOf(b), a.id, b.id));
171
284
  for (const item of ranked.slice(0, most)) {keep.add(item.id);}
172
285
  return items.filter((item) => keep.has(item.id));
173
286
  }
174
287
 
175
288
  // Rendering ids can change with label style; actorId always names the world
176
289
  // anchor. Captions admitted by the existing near-label rule consume no slots.
177
- export function capWorldLabels(items, placed, local, most, party) {
290
+ // v1.168: `tags` (from qualityTags) rank with them at their avatar's anchor;
291
+ // the player's own consume no slots. Without tags the result is as before.
292
+ export function capWorldLabels(items, placed, local, most, party, tags = null) {
178
293
  const anchors = new Map(placed.map(({ id, at }) => [id, at]));
179
- const actorId = (item) => item.actorId ?? item.id;
180
- return capLabels(items, most, (item) => distance(local, anchors.get(actorId(item))),
181
- (item) => item.qualityNear === true || party.has(actorId(item)));
294
+ const of = tags?.of;
295
+ const actorId = (item) => of?.get(item)?.actorId ?? item.actorId ?? item.id;
296
+ const at = (item) => of?.has(item) ? of.get(item).at : anchors.get(actorId(item));
297
+ let all = items;
298
+ if (tags?.list.length) {
299
+ all = tags.all; all.length = 0;
300
+ for (const item of items) {all.push(item);}
301
+ for (const tag of tags.list) {all.push(tag.item);}
302
+ }
303
+ return capLabels(all, most, (item) => distance(local, at(item)),
304
+ (item) => item.qualityNear === true || party.has(actorId(item)) || of?.get(item)?.own === true);
305
+ }
306
+
307
+ // v1.168: hub.mark tags and role labels (`mark:<playerId>`, `role:<playerId>`)
308
+ // on Low. A culled bystander's are not drawn, as with a v1.162 carer copy;
309
+ // each other names its avatar and the Transform it is ranked by. The lists,
310
+ // lookup and descriptors belong to the visit and are reused every frame.
311
+ export function qualityTags(scene, local, marks, roles) {
312
+ const q = qualityFor(scene);
313
+ const tags = (q.tags ??= { list: [], of: new Map(), all: [], kept: [], pool: [] });
314
+ tags.list.length = 0; tags.of.clear();
315
+ const self = scene.multiplayer?.net?.selfId?.() ?? null;
316
+ addTags(scene, q, tags, local, self, marks);
317
+ addTags(scene, q, tags, local, self, roles);
318
+ return tags;
319
+ }
320
+
321
+ function addTags(scene, q, tags, local, self, items) {
322
+ const avatars = scene.multiplayer?.avatars?.actors;
323
+ for (const item of items) {
324
+ const playerId = item.id.slice(item.id.indexOf(':') + 1);
325
+ const own = playerId === self;
326
+ const actorId = own ? local?.id : avatars?.get(playerId);
327
+ if (!own && q.culled.has(actorId)) {continue;}
328
+ const tag = (tags.pool[tags.list.length] ??= {});
329
+ tag.item = item; tag.actorId = actorId; tag.own = own;
330
+ tag.at = (own ? local : scene.getActor(actorId))?.components?.Transform;
331
+ tags.list.push(tag); tags.of.set(item, tag);
332
+ }
333
+ }
334
+
335
+ // Splits capWorldLabels' result back in place: world labels into `labels`,
336
+ // surviving tags into the visit's reused `kept`, each in its own order.
337
+ export function splitTags(capped, labels, tags) {
338
+ labels.length = 0; tags.kept.length = 0;
339
+ for (const item of capped) {(tags.of.has(item) ? tags.kept : labels).push(item);}
340
+ return tags.kept;
182
341
  }
183
342
 
184
343
  export function qualitySpawnIds(want, templates, here, most) {
185
344
  const decor = Object.entries(want).filter(([, copy]) => templates[copy.from]?.decor === true)
186
- .sort((a, b) => distance(here, a[1]) - distance(here, b[1]) || a[0].localeCompare(b[0]));
345
+ .sort((a, b) => nearerThenId(distance(here, a[1]), distance(here, b[1]), a[0], b[0]));
187
346
  return new Set([...Object.entries(want).filter(([, copy]) => templates[copy.from]?.decor !== true).map(([id]) => id),
188
347
  ...decor.slice(0, most).map(([id]) => id)]);
189
348
  }
@@ -7,7 +7,7 @@ import { drawInstances } from '@imports/castle.physics-3d/engine3d/optimize';
7
7
  import { syncActors } from '@imports/castle.physics-3d/engine3d/world3d';
8
8
  import { lowMemoryDevice } from '@imports/castle.physics-3d/engine3d/memoryprofile.js';
9
9
  import { deck } from './state.js';
10
- import { makeTiers } from './tiers.js';
10
+ import { makeTiers, primeTiers } from './tiers.js';
11
11
  import { readQuality } from '../shared/quality.js';
12
12
  import { filterQualityScene, makeQualityVisit, qualityFor, resetQualityVisit } from './quality.js';
13
13
 
@@ -57,4 +57,13 @@ if ((config.hub?.quality !== undefined || config.hub?.highOnly === true) && conf
57
57
  if (config.hub.quality !== undefined) {deck.quality = readQuality(config.hub.quality, true, []);}
58
58
  if (config.hub.highOnly === true) {deck.highOnly = true;}
59
59
  installQualityLoad(SceneRuntime);
60
+ // In castle.xyz's sandboxed frame the remembered tier and Graphics pick
61
+ // only come from LocalCache, asynchronously (`deviceStorage.js`). Asked for
62
+ // here, as early as the page allows. Nothing waits for them: the play entry
63
+ // mounts the player as its module is evaluated and the default entry a
64
+ // React render later, and a top-level await is not something every bundle
65
+ // format takes. One that arrives after the first load and turns the device
66
+ // Low is caught up by `lowerLate` (quality.js). With a working localStorage
67
+ // this does nothing.
68
+ primeTiers();
60
69
  }
@@ -0,0 +1,222 @@
1
+ // The quick chat surface: the button, card and feed (`quickChatTree.js`)
2
+ // with the behaviour `chrome.js` gives them in the DOM (`setSay`, `onSay`,
3
+ // `setFeed`, `setChatModeration`) -- the button toggles the card, a reaction
4
+ // or phrase shuts it and says { r } or { p }, a typed line is trimmed and
5
+ // says { text }, Esc shuts it, a card rebuilt for new phrases or chat drops a
6
+ // line being typed, the Character sheet hides the button and shuts the card,
7
+ // an open Doors or People list empties the feed -- published as the
8
+ // `quickchat` UI tree root. No DOM and no window: a native host gives it what
9
+ // the hub system gives the chrome and draws the root from the UI tree sink.
10
+ // The web chrome does not use it.
11
+ //
12
+ // makeQuickChatSurface({ view, onSay, onChip, onOpen, onReport, onBlock, draw }):
13
+ // view() the stage: { landscape, safeInsets, lift, slot } (CSS
14
+ // px; `quickChatTree.js`);
15
+ // onSay(what) a pick: { r } (a reaction's index), { p } (a phrase id)
16
+ // or { text } (a typed line), as chrome.js's `onSay`
17
+ // handler is called (the hub system's `saying`);
18
+ // onChip() a reaction or phrase picked (the soundscape's chip);
19
+ // onOpen(open) the card opened or shut (the host shuts its emote row
20
+ // when it opens, as the DOM's button does);
21
+ // onReport(line) a feed line's Report (chrome.js `onReportChat`);
22
+ // onBlock(line) its Report & block (`onBlockChat`; only offered with
23
+ // moderation on and a line naming its user);
24
+ // draw(tree) called with each root built (only when it changed).
25
+ import { publishUiRoot } from './uiTree.js';
26
+ import { buildQuickChat, feedShown, sayKey } from './quickChatTree.js';
27
+
28
+ export function makeQuickChatSurface({ view = () => ({}), onSay = () => {}, onChip = null, onOpen = null, onReport = () => {}, onBlock = () => {}, draw = null } = {}) {
29
+ let say = null;
30
+ let open = false;
31
+ let covered = false;
32
+ let cardKey = '';
33
+ // The field: its words as of its version, the words as typed (mirrored
34
+ // from the renderer's input events), focus requests and whether it has it.
35
+ const field = { value: '', ver: 0, focus: 0 };
36
+ let typed = '';
37
+ let focused = false;
38
+ const feed = { lines: [], moderation: false, hidden: false, confirming: [], reported: [] };
39
+ let feedKey = '';
40
+ let key = '';
41
+ let disposed = false;
42
+
43
+ function render() {
44
+ if (disposed) {return;}
45
+ const stage = view() ?? {};
46
+ const slot = stage.slot && Number.isFinite(stage.slot.right) && Number.isFinite(stage.slot.bottom)
47
+ ? { right: Number(stage.slot.right), bottom: Number(stage.slot.bottom), width: Number(stage.slot.width) || 0 }
48
+ : null;
49
+ const state = {
50
+ view: { landscape: Boolean(stage.landscape), safeInsets: Boolean(stage.safeInsets), lift: Number(stage.lift) || 0, slot },
51
+ say, open, covered,
52
+ field: { ...field },
53
+ feed: { ...feed, confirming: [...feed.confirming], reported: [...feed.reported] },
54
+ };
55
+ const next = JSON.stringify(state);
56
+ if (next === key) {return;}
57
+ key = next;
58
+ const tree = buildQuickChat(state, on);
59
+ publishUiRoot('quickchat', tree);
60
+ draw?.(tree);
61
+ }
62
+
63
+ const blur = () => {
64
+ field.focus = -(Math.abs(field.focus) + 1);
65
+ focused = false;
66
+ };
67
+ function setOpen(next) {
68
+ next = Boolean(next) && Boolean(say) && !covered;
69
+ if (next === open) {return;}
70
+ open = next;
71
+ // A card opened again shows what was typed before it shut, under a new
72
+ // version: a submit or input queued from an earlier opening is late.
73
+ if (open) {
74
+ field.value = typed;
75
+ field.ver += 1;
76
+ }
77
+ else if (focused) {blur();}
78
+ render();
79
+ onOpen?.(open);
80
+ }
81
+ // A typed line: trimmed, never empty; the field empties and the card shuts.
82
+ function sendTyped(text) {
83
+ if (!open || !say?.chat?.input) {return;}
84
+ const words = String(text ?? '').trim();
85
+ if (!words) {return;}
86
+ typed = '';
87
+ field.value = '';
88
+ field.ver += 1;
89
+ blur();
90
+ setOpen(false);
91
+ render();
92
+ onSay({ text: words });
93
+ }
94
+ function pick(what) {
95
+ if (!open) {return;}
96
+ setOpen(false);
97
+ onChip?.();
98
+ onSay(what);
99
+ }
100
+ // The feed line an event names, as it is drawn now.
101
+ const lineOf = (id) => feedShown(feed).find((line) => line.id !== null && line.id !== undefined && String(line.id) === id) ?? null;
102
+ function refeed() {
103
+ const shown = feedShown({ ...feed, reported: [] });
104
+ const next = `${feed.moderation}:` + shown.map((line) => `${line.id ?? ''}:${line.text}`).join('\n');
105
+ // The DOM rebuilds the feed when what it shows changes: a line asking to
106
+ // be reported asks no more, a reported one comes back if still there.
107
+ if (next !== feedKey) {
108
+ feedKey = next;
109
+ feed.confirming = [];
110
+ feed.reported = [];
111
+ }
112
+ }
113
+
114
+ const on = {
115
+ toggle: () => setOpen(!open),
116
+ close: () => setOpen(false),
117
+ react: (r) => {if (Number.isInteger(r) && r >= 0 && r < (say?.reactions.length ?? 0)) {pick({ r });}},
118
+ phrase: (id) => {if (say?.phrases.some(([p]) => p === id)) {pick({ p: id });}},
119
+ input: (e) => {
120
+ // Input typed before a reset landed (an older base) is dropped.
121
+ if (e?.base !== undefined && e.base < field.ver) {return;}
122
+ typed = String(e?.text ?? '');
123
+ },
124
+ // A submit belongs to the field as it is now (its version), as talk's.
125
+ submit: (e) => {if (Number.isFinite(e?.base) && e.base === field.ver) {sendTyped(e?.text ?? typed);}},
126
+ send: () => sendTyped(typed),
127
+ focus: () => {focused = true;},
128
+ blur: () => {focused = false;},
129
+ ask: (id) => {
130
+ if (!lineOf(id) || feed.confirming.includes(id)) {return;}
131
+ feed.confirming.push(id);
132
+ render();
133
+ },
134
+ report: (id) => {
135
+ const line = lineOf(id);
136
+ if (!line || !feed.confirming.includes(id)) {return;}
137
+ feed.confirming = feed.confirming.filter((c) => c !== id);
138
+ feed.reported.push(id);
139
+ render();
140
+ onReport(line);
141
+ },
142
+ block: (id) => {
143
+ const line = lineOf(id);
144
+ if (!line || !feed.confirming.includes(id) || !feed.moderation || !line.userId) {return;}
145
+ onBlock(line);
146
+ },
147
+ // Cancel: the DOM draws the feed afresh, every line as it was.
148
+ unask: (id) => {
149
+ if (!feed.confirming.includes(id)) {return;}
150
+ feed.confirming = [];
151
+ feed.reported = [];
152
+ render();
153
+ },
154
+ };
155
+
156
+ render();
157
+ return {
158
+ // chrome `setSay`: { reactions, phrases, chat } to offer, or null to hide
159
+ // the button (and shut the card).
160
+ setSay(next) {
161
+ if (!next) {
162
+ // The card's key is kept, as the DOM's: the next offer is compared
163
+ // with the card last built, and a changed one empties the field.
164
+ say = null;
165
+ setOpen(false);
166
+ render();
167
+ return;
168
+ }
169
+ const nextKey = sayKey(next);
170
+ // The DOM rebuilds the card for new reactions, phrases or chat: a line
171
+ // being typed goes with the old field.
172
+ if (nextKey !== cardKey) {
173
+ if (cardKey) {
174
+ typed = '';
175
+ field.value = '';
176
+ field.ver += 1;
177
+ if (focused) {blur();}
178
+ }
179
+ cardKey = nextKey;
180
+ }
181
+ say = {
182
+ reactions: [...next.reactions],
183
+ phrases: next.phrases.map(([id, words]) => [id, words]),
184
+ chat: next.chat ? { input: next.chat.input === true, note: next.chat.note ?? '', ...(next.chat.placeholder ? { placeholder: next.chat.placeholder } : {}), ...(next.chat.label ? { label: next.chat.label } : {}) } : null,
185
+ };
186
+ render();
187
+ },
188
+ // chrome `setFeed`: the lines of what was just said, oldest first.
189
+ setFeed(lines) {
190
+ feed.lines = (Array.isArray(lines) ? lines : []).map((line) => ({ text: String(line.text ?? ''), id: line.id ?? null, ...(line.userId ? { userId: line.userId } : {}) }));
191
+ refeed();
192
+ render();
193
+ },
194
+ // chrome `setChatModeration`: the scene's opt-in to Report & block.
195
+ setChatModeration(enabled) {
196
+ feed.moderation = enabled === true;
197
+ refeed();
198
+ render();
199
+ },
200
+ // What else is open: `picker` the Character sheet (the button hides, the
201
+ // card shuts), `lists` a Doors or People list (the feed empties).
202
+ cover({ picker = covered, lists = feed.hidden } = {}) {
203
+ covered = Boolean(picker);
204
+ feed.hidden = Boolean(lists);
205
+ if (covered) {setOpen(false);}
206
+ refeed();
207
+ render();
208
+ },
209
+ // Opens or shuts the card (a host's own shut, as chrome.js `shutRound`).
210
+ setOpen,
211
+ // A turned or resized stage, a moved rail slot or lift.
212
+ render,
213
+ isOpen: () => open,
214
+ // Whether the chat field has the keyboard (the game's keys are its own).
215
+ chatFocused: () => open && focused,
216
+ dispose() {
217
+ if (disposed) {return;}
218
+ disposed = true;
219
+ publishUiRoot('quickchat', null);
220
+ },
221
+ };
222
+ }