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
@@ -0,0 +1,115 @@
1
+ // The choice card surface: the ballot sheet (`ballotTree.js`) with the
2
+ // behaviour `ballot.js` gives it in the DOM (its pure `tap` and `keepSel`),
3
+ // published as the `ballot` UI tree root. No DOM and no window: a native
4
+ // host calls `frame` each hub frame as the hub system calls ballot.js's, and
5
+ // draws the root from the UI tree sink. The web does not use it yet.
6
+ //
7
+ // makeBallotSurface({ view, send, onChip, now, draw }):
8
+ // view() the stage: { landscape, w, h } in CSS px;
9
+ // send(msg) a tap's message ({ v, face?, line?, option? }: the hub
10
+ // system sends it as `{ k: 'hub-ballot', ...msg }`);
11
+ // onChip() a tap that sends (the soundscape's chip sound);
12
+ // now() the page's monotonic ms (default performance.now): the
13
+ // 2.5 s a vote shows "Sending…";
14
+ // draw(tree) called with each root built (only when it changed).
15
+ import { publishUiRoot } from './uiTree.js';
16
+ import { buildBallot } from './ballotTree.js';
17
+ import { keepSel, tap, tapMessage } from './ballot.js';
18
+
19
+ const PENDING_MS = 2500;
20
+
21
+ export function makeBallotSurface({ view = () => ({}), send = () => {}, onChip = null, now = () => globalThis.performance?.now?.() ?? Date.now(), draw = null } = {}) {
22
+ let sel = { face: null, option: null, pending: null, mode: null, v: null };
23
+ let card = null;
24
+ let lines = [];
25
+ let selfId = null;
26
+ let hudBottom = 0;
27
+ let clock = null;
28
+ let clockGen = 0;
29
+ let shownPick = null;
30
+ let focus = null;
31
+ let key = '';
32
+ let disposed = false;
33
+
34
+ const on = {
35
+ tap: (what) => {
36
+ if (!card) {return;}
37
+ const result = tap(card, lines, sel, what, now());
38
+ sel = result.sel;
39
+ if (result.send) {
40
+ onChip?.();
41
+ send(tapMessage(card, result.send));
42
+ }
43
+ render();
44
+ },
45
+ };
46
+
47
+ // The countdown's clock: absolute, one generation per `until`.
48
+ function clockFor(until) {
49
+ if (until === undefined || !Number.isFinite(until)) {
50
+ clock = null;
51
+ return null;
52
+ }
53
+ if (!clock || clock.until !== until) {
54
+ clockGen += 1;
55
+ clock = { until, gen: clockGen, t0: until / 1000, v0: 0, rate: -1 };
56
+ }
57
+ return clock;
58
+ }
59
+
60
+ function state() {
61
+ const stage = view() ?? {};
62
+ const sending = sel.pending !== null && now() - sel.pending < PENDING_MS;
63
+ const c = card ? clockFor(card.until) : null;
64
+ return {
65
+ view: { landscape: Boolean(stage.landscape), w: Number(stage.w) || 0, h: Number(stage.h) || 0, hudBottom },
66
+ card, lines, selfId,
67
+ sel: { face: sel.face, option: sel.option },
68
+ sending,
69
+ clock: c ? { gen: c.gen, t0: c.t0, v0: c.v0, rate: c.rate } : null,
70
+ focus,
71
+ };
72
+ }
73
+
74
+ function render() {
75
+ if (disposed) {return;}
76
+ sel = keepSel(card, sel);
77
+ // A face or option newly picked: what to do next comes into view once.
78
+ const picked = card ? sel.face ?? sel.option : null;
79
+ if (picked !== shownPick) {
80
+ focus = picked;
81
+ shownPick = picked;
82
+ }
83
+ const s = state();
84
+ const next = JSON.stringify(s);
85
+ if (next === key) {return;}
86
+ key = next;
87
+ const tree = buildBallot(s, on);
88
+ publishUiRoot('ballot', tree);
89
+ draw?.(tree);
90
+ }
91
+
92
+ render();
93
+ return {
94
+ // Said every hub frame (ballot.js `frame`): `nextCard` this player's card
95
+ // or null, `placeLines` the place's manifest lines, `self` the player's
96
+ // id, `hudBottom` a clear HUD's bottom (CSS px) or 0. The countdown is a
97
+ // clock, so a running timer sends nothing per frame.
98
+ frame(nextCard, placeLines, self, hudBottomPx = 0) {
99
+ card = nextCard ?? null;
100
+ lines = Array.isArray(placeLines) ? placeLines : [];
101
+ selfId = self ?? null;
102
+ hudBottom = Number(hudBottomPx) || 0;
103
+ render();
104
+ },
105
+ // A turned or resized stage.
106
+ render,
107
+ // Whether the card is up (the hub hides what it would cover).
108
+ shown: () => card !== null,
109
+ dispose() {
110
+ if (disposed) {return;}
111
+ disposed = true;
112
+ publishUiRoot('ballot', null);
113
+ },
114
+ };
115
+ }
@@ -0,0 +1,180 @@
1
+ // The choice card (contract v1.68, `hub.ballot`) as a UI tree (schema v0):
2
+ // the bottom sheet `ballot.js` draws in the DOM -- the title and countdown,
3
+ // the deck's words, the recent lines said, the hint, the faces as a grid,
4
+ // what to say or the options as chips, and Vote -- with the same words,
5
+ // labels and states. Pure: no DOM, no window; the web still draws ballot.js.
6
+ // The wording is ballot.js's own (its pure exports), so both say the same.
7
+ //
8
+ // state = {
9
+ // view: { landscape, w, h, hudBottom } (CSS px; `hudBottom` the bottom
10
+ // of a clear HUD's box, or 0: the card stays under it);
11
+ // card: the player's `hub-ballot-card` (or null: no sheet);
12
+ // lines: the place's manifest lines (`hubPlace.ballot.lines`);
13
+ // selfId: this player's id ("You");
14
+ // sel: { face, option } picked and not yet sent;
15
+ // sending: a vote went out under 2.5 s ago and is not locked in;
16
+ // clock: null, or the countdown's absolute clock { gen, t0, v0, rate }
17
+ // in simulation seconds (fixed for as long as `card.until` is);
18
+ // focus: null, or the face/option just picked: the scroll holding what
19
+ // to do next goes to its end once (ballot.js's `focus`);
20
+ // }
21
+ // on = { tap(what) }: what = { face } | { option } | { line } | { vote: true }.
22
+ import { h } from './uiTree.js';
23
+ import { feedWords, hintOf, lineOf, nameOf, textOf, voteLabel } from './ballot.js';
24
+ import { AVATAR_FACES } from './avatarFaces.js';
25
+
26
+ const GOLD = '#ffd84a';
27
+ const CHIP_BG = 'rgba(0,0,0,0.6)';
28
+ const FEED_SHOWN = 3;
29
+ // The sheet sits on the view's bottom edge; its bottom padding reaches over
30
+ // the safe inset, as the DOM's `max(12px, env(safe-area-inset-bottom))`.
31
+ const SHEET_PAD = [12, 12, [12, 0], 12];
32
+ const own = (obj, id) => (obj && typeof obj === 'object' && Object.hasOwn(obj, id) ? obj[id] : undefined);
33
+ const ONE_LINE = { lines: 1 };
34
+
35
+ // The sheet's height cap: 60% of the view, under a clear HUD, never under 160.
36
+ export const ballotMaxH = (view) => Math.round(Math.max(160, Math.min(view.h * 0.6, view.h - (view.hudBottom ?? 0) - 8)));
37
+
38
+ // The countdown's clock, from the card's `until` (simulation ms) and its
39
+ // generation: counts down to 0:00, red under ten seconds.
40
+ export const countdownClock = (clock) => ({
41
+ gen: clock.gen, t0: clock.t0, v0: clock.v0, rate: clock.rate, fmt: 'm:ss', min: 0,
42
+ warn: { below: 10, s: { bg: 'rgba(230,70,70,0.85)' } },
43
+ });
44
+
45
+ function chip(key, text, enabled, onTap, { dashed = false, chosen = false } = {}) {
46
+ return h('button', {
47
+ key, disabled: !enabled,
48
+ style: {
49
+ box: 'border', minH: 44, pad: [9, 14], radius: 22,
50
+ border: { w: 1, c: chosen ? GOLD : 'line40', ...(dashed && !chosen ? { dash: true } : {}) },
51
+ ...(chosen ? { shadow: 'glow' } : {}),
52
+ bg: CHIP_BG, size: 15, weight: 600, lh: 1.2, talign: 'start', opacity: enabled ? 1 : 0.4,
53
+ },
54
+ on: { tap: () => {if (enabled) {onTap();}} },
55
+ }, text);
56
+ }
57
+
58
+ function faceCell(state, face, on) {
59
+ const { card, sel, selfId } = state;
60
+ const landscape = Boolean(state.view?.landscape);
61
+ const chosen = sel.face === face.id || card.picked?.face === face.id;
62
+ const tappable = card.mode !== 'reveal' && !face.off && !card.picked;
63
+ const who = own(card.who, face.id);
64
+ const size = landscape ? 28 : 36;
65
+ const name = nameOf(card, face.id, selfId);
66
+ const avatar = Number.isInteger(who?.avatar) && AVATAR_FACES[who.avatar]?.[1] ? who.avatar : null;
67
+ const votes = Number.isInteger(face.votes) ? face.votes : null;
68
+ return h('button', {
69
+ key: `f:${face.id}`, label: `${name}${face.note ? `, ${face.note}` : ''}${face.away === true ? ', away' : ''}${votes !== null ? `, ${votes} votes` : ''}`, pressed: chosen,
70
+ style: {
71
+ box: 'border', pad: 0, radius: 14, minW: 0, border: { w: 2, c: chosen ? GOLD : face.mark ?? 'rgba(255,255,255,0.18)' },
72
+ shadow: chosen ? 'glow' : 'none', bg: CHIP_BG, opacity: face.off ? 0.4 : 1, gray: Boolean(face.off),
73
+ },
74
+ on: { tap: () => {if (tappable) {on.tap?.({ face: face.id });}} },
75
+ },
76
+ h('stack', { key: 'cell', style: { w: 'fill' } },
77
+ h('column', {
78
+ key: 'body',
79
+ style: { w: 'fill', box: 'border', minH: landscape ? 62 : 72, pad: [6, 4], align: 'center', justify: 'center', gap: 2, hit: 'none' },
80
+ },
81
+ avatar !== null
82
+ ? h('icon', { key: 'face', name: `avatar-face-${avatar}`, style: { w: size, h: size, flex: '0 0 auto' } })
83
+ : h('column', { key: 'face', style: { w: size, h: size, radius: size / 2, bg: '#4a4458', align: 'center', justify: 'center', size: 18 } },
84
+ h('text', { key: 'initial', text: nameOf(card, face.id, null).slice(0, 1).toUpperCase() })),
85
+ h('text', { key: 'name', text: name, style: { maxW: '100%', size: 15, ...ONE_LINE } }),
86
+ face.note ? h('text', { key: 'note', text: String(face.note), style: { maxW: '100%', size: 15, weight: 500, lh: 1.2, opacity: 0.8, ...ONE_LINE } }) : null),
87
+ face.mark ? h('spacer', { key: 'mark', at: { anchor: 'topLeft', top: 6, left: 6 }, style: { w: 10, h: 10, radius: 5, bg: face.mark } }) : null,
88
+ votes !== null ? h('text', {
89
+ key: 'votes', text: String(votes), at: { anchor: 'topRight', top: 4, right: 4 },
90
+ style: { minW: 22, h: 22, pad: [0, 6], box: 'border', radius: 11, bg: votes > 0 ? GOLD : 'rgba(255,255,255,0.2)', color: votes > 0 ? '#2b2118' : '#fff', size: 15, weight: 800, lh: 1.4667, talign: 'center' },
91
+ }) : null,
92
+ // v1.179: a player the place is holding while they are away; still tappable.
93
+ face.away === true ? h('text', {
94
+ key: 'away', text: 'away', at: { anchor: 'bottomRight', bottom: 4, right: 4 },
95
+ style: { h: 16, pad: [0, 5], radius: 8, bg: 'rgba(255,255,255,0.22)', color: '#fff', size: 11, weight: 700, lh: 1.4545, talign: 'center' },
96
+ }) : null,
97
+ card.picked?.face === face.id ? h('text', {
98
+ key: 'tick', text: '✓', at: { anchor: 'bottomLeft', bottom: 4, left: 4 },
99
+ style: { w: 20, h: 20, radius: 10, bg: GOLD, color: '#2b2118', size: 13, weight: 800, lh: 1.5385, talign: 'center' },
100
+ }) : null));
101
+ }
102
+
103
+ export function buildBallot(state, on = {}) {
104
+ const card = state.card;
105
+ const root = { key: 'ballot', style: { font: 'ui', size: 15, weight: 600, lh: 1.3, color: '#fff' } };
106
+ if (!card) {return h('stack', root);}
107
+ const view = state.view ?? {};
108
+ const landscape = Boolean(view.landscape);
109
+ const lines = Array.isArray(state.lines) ? state.lines : [];
110
+ const sel = state.sel ?? { face: null, option: null };
111
+ const selfId = state.selfId ?? null;
112
+ const maxH = ballotMaxH(view);
113
+
114
+ const head = h('row', { key: 'head', style: { align: 'center', gap: 10 } },
115
+ h('text', { key: 'title', text: String(card.title ?? ''), style: { flex: 1, minW: 0, size: 17, weight: 800, lh: 1.25 } }),
116
+ card.until !== undefined && state.clock ? h('text', {
117
+ key: 'clock', clock: countdownClock(state.clock),
118
+ style: { flex: '0 0 auto', pad: [4, 10], radius: 12, bg: 'rgba(255,255,255,0.14)', size: 15, weight: 800, lh: 1.2, tabular: true },
119
+ }) : null);
120
+ const words = card.text ? h('text', { key: 'text', text: String(card.text), style: { weight: 500, opacity: 0.9 } }) : null;
121
+ // A short screen keeps fewer of the said lines.
122
+ const said = feedWords(card, lines, selfId).slice((view.h ?? 0) < 700 && !landscape ? -2 : -FEED_SHOWN);
123
+ const feed = said.length ? h('row', { key: 'feed', style: { align: 'stretch', gap: 7, pad: [2, 0], weight: 500, opacity: 0.88 } },
124
+ h('spacer', { key: 'bar', style: { w: 3, bg: 'rgba(255,255,255,0.25)', flex: '0 0 auto' } }),
125
+ h('column', { key: 'said', style: { gap: 2, flex: 1, minW: 0 } }, said.map((text, i) => h('text', { key: `s${i}`, text })))) : null;
126
+ const hintText = hintOf(card, lines, { ...sel, pending: null }, selfId);
127
+ const hint = hintText ? h('text', { key: 'hint', text: hintText, style: { color: '#e9c48f' } }) : null;
128
+ const grid = card.faces.length ? h('grid', { key: 'faces', cols: { min: landscape ? 70 : 72 }, style: { gap: 8 } }, card.faces.map((face) => faceCell({ ...state, sel, selfId }, face, on))) : null;
129
+
130
+ const chipNodes = [];
131
+ if (card.mode === 'talk') {
132
+ for (const id of card.lines) {
133
+ const line = lineOf(lines, id);
134
+ if (line) {chipNodes.push(chip(`l:${id}`, textOf(card, line), line.about === 'self' || Boolean(sel.face), () => on.tap?.({ line: id })));}
135
+ }
136
+ }
137
+ if (card.mode !== 'reveal') {
138
+ for (const option of card.options) {
139
+ const chosen = sel.option === option.id || card.picked?.option === option.id;
140
+ chipNodes.push(chip(`o:${option.id}`, option.text, !card.picked, () => on.tap?.({ option: option.id }), { dashed: true, chosen }));
141
+ }
142
+ }
143
+ const chips = chipNodes.length ? h('row', { key: 'chips', style: { wrap: true, gap: 8 } }, chipNodes) : null;
144
+ let vote = null;
145
+ if (card.mode === 'vote') {
146
+ const label = voteLabel(card, { ...sel, pending: state.sending ? 0 : null }, selfId, 0);
147
+ vote = h('button', {
148
+ key: 'vote', disabled: !label.enabled,
149
+ style: { w: 'fill', minH: 48, radius: 24, border: 'none', bg: card.picked ? 'rgba(255,216,74,0.25)' : GOLD, color: card.picked ? '#fff' : '#2b2118', size: 17, weight: 800, lh: 1.2, opacity: label.enabled || card.picked ? 1 : 0.45 },
150
+ on: { tap: () => {if (label.enabled) {on.tap?.({ vote: true });}} },
151
+ }, label.text);
152
+ }
153
+ // What to do next is brought into view once, as a face or option is
154
+ // picked: a marker appears at the end of the scroll that holds it, and the
155
+ // scroll follows it to the end (`follow` acts on a key's first appearance).
156
+ const focusKey = state.focus ? `pick:${state.focus}` : null;
157
+ const marker = focusKey ? h('spacer', { key: focusKey, style: { h: 0 } }) : null;
158
+ const follow = focusKey ? [{ key: focusKey, mode: 'end' }] : undefined;
159
+
160
+ const width = landscape ? [{ vw: 56 }, { max: [220, { vw: 100, px: -344 }] }, { px: 560 }] : [{ vw: 100 }, { px: 560 }];
161
+ const paint = { w: width, box: 'border', bg: 'rgba(16,12,22,0.96)', hit: 'auto' };
162
+ let sheet;
163
+ if (landscape) {
164
+ const rightKids = [h('scroll', { key: 'body', axis: 'y', follow: vote ? undefined : follow, style: { flex: '1 1 auto', minH: 0, gap: 8 } }, hint, chips, vote ? null : marker), vote];
165
+ const right = hint || chips || vote ? h('column', { key: 'right', style: { flex: '1 1 44%', minW: 0, minH: 0, gap: 8 } }, rightKids) : null;
166
+ sheet = h('row', {
167
+ key: 'sheet', at: { anchor: 'bottom', bottom: 0, z: 1 },
168
+ style: { ...paint, h: maxH, gap: 12, pad: SHEET_PAD, radius: [18, 18, 0, 0], shadow: 'sheet' },
169
+ },
170
+ h('scroll', { key: 'left', axis: 'y', style: { flex: '1 1 56%', minW: 0, minH: 0, gap: 8 } }, head, words, feed, grid),
171
+ right);
172
+ } else {
173
+ sheet = h('scroll', {
174
+ key: 'sheet', axis: 'y', follow,
175
+ at: { anchor: 'bottom', bottom: 0, z: 1 },
176
+ style: { ...paint, maxH, gap: 10, pad: SHEET_PAD, radius: [18, 18, 0, 0], shadow: 'sheet' },
177
+ }, head, words, feed, hint, grid, chips, vote, marker);
178
+ }
179
+ return h('stack', { ...root, hub: 'ballot' }, sheet);
180
+ }
@@ -0,0 +1,19 @@
1
+ // v1.204: while the server reads an arrived player's progress it refuses what
2
+ // could write it (`hub-progress`). `since` is the page time the client heard
3
+ // catching begin, or null. Presses are refused from the first moment; the
4
+ // controls dim only after DIM_MS of it, so the quick reread of every resume
5
+ // hello does not flicker them.
6
+ export const CATCHING_DIM_MS = 250;
7
+ export const CATCHING_LONG_MS = 30_000;
8
+
9
+ // Whether the controls show the catching-up state now.
10
+ export function catchingDim(since, now) {
11
+ return since != null && now - since >= CATCHING_DIM_MS;
12
+ }
13
+
14
+ // The line a refused press shows.
15
+ export function catchingLine(since, now) {
16
+ return since != null && now - since >= CATCHING_LONG_MS
17
+ ? 'Still catching up, re-enter the town if this lasts'
18
+ : 'Catching up, try again in a moment';
19
+ }
@@ -0,0 +1,66 @@
1
+ // v1.205. One lazily allocated pooled coin emitter; public ribbons use the
2
+ // ordinary world-label layer. No resources or state before the first message.
3
+ import { BufferGeometry, Float32BufferAttribute, Points, PointsMaterial } from 'three';
4
+ const BURST_MS = 2500, RIBBON_MS = 20000, COINS = 24;
5
+ let state = null;
6
+
7
+ export function receive(scene, msg, now = performance.now()) {
8
+ if (!scene || msg?.kind !== 'win' || typeof msg.player !== 'string' || typeof msg.door !== 'string' ||
9
+ !Number.isInteger(msg.tokens) || msg.tokens < 0 || msg.tokens > 40 ||
10
+ (msg.streak !== undefined && msg.streak !== 3 && msg.streak !== 5)) {return false;}
11
+ if (state?.scene !== scene) {clear();}
12
+ state ??= { scene, ribbons: new Map(), burst: null, emitter: null };
13
+ if (state.ribbons.size >= 8 && !state.ribbons.has(msg.player)) {state.ribbons.delete(state.ribbons.keys().next().value);}
14
+ const item = { ...msg, at: now };
15
+ state.ribbons.set(msg.player, item);
16
+ state.burst = item;
17
+ return true;
18
+ }
19
+
20
+ function position(scene, local, id) {
21
+ const mp = scene.multiplayer, self = mp?.net?.selfId?.();
22
+ const actor = id === self ? local : scene.getActor?.(mp?.avatars?.actors?.get(id));
23
+ return actor?.components?.Transform ?? null;
24
+ }
25
+
26
+ export function frame(scene, local, { now, low = false, live = true, doors = [], cam, view, project }) {
27
+ if (!state) {return [];}
28
+ if (state.scene !== scene || !live) { clear(); return []; }
29
+ const self = scene.multiplayer?.net?.selfId?.(), labels = [];
30
+ for (const [id, item] of state.ribbons) {
31
+ if (now - item.at >= RIBBON_MS) { state.ribbons.delete(id); continue; }
32
+ const at = position(scene, local, id);
33
+ const point = id !== self && at && cam ? project(cam, at.x, at.y + 1.7, at.z, view) : null;
34
+ const door = doors.find((d) => d.id === item.door);
35
+ if (point) {labels.push({ id: `celebrate:${id}`, ...point, text: `won ${door?.title ?? item.door}${item.tokens > 0 ? ` · +${item.tokens}` : ''}`, color: '#f5c542' });}
36
+ }
37
+ const burst = state.burst, elapsed = burst ? now - burst.at : Infinity;
38
+ const at = burst && position(scene, local, burst.player);
39
+ if (low || !at || elapsed < 0 || elapsed >= BURST_MS || !scene.three?.scene) {
40
+ if (state.emitter) {state.emitter.visible = false;}
41
+ return labels;
42
+ }
43
+ if (!state.emitter) {
44
+ const geometry = new BufferGeometry();
45
+ geometry.setAttribute('position', new Float32BufferAttribute(new Float32Array(COINS * 3), 3));
46
+ const material = new PointsMaterial({ color: '#f5c542', size: 0.13, transparent: true, depthWrite: false });
47
+ const emitter = new Points(geometry, material);
48
+ emitter.name = 'hub:celebrate'; emitter.frustumCulled = false; emitter.raycast = () => {};
49
+ scene.three.scene.add(emitter); state.emitter = emitter;
50
+ }
51
+ const emitter = state.emitter, t = elapsed / 1000, points = emitter.geometry.attributes.position;
52
+ emitter.visible = true; emitter.position.set(at.x, at.y + 0.6, at.z);
53
+ emitter.material.opacity = Math.max(0, 1 - elapsed / BURST_MS);
54
+ for (let i = 0; i < COINS; i++) {
55
+ const angle = i * 2.399963, speed = 0.3 + (i % 5) * 0.12;
56
+ points.setXYZ(i, Math.cos(angle) * speed * t, 0.3 + (1.8 + (i % 4) * 0.22) * t - 0.9 * t * t, Math.sin(angle) * speed * t);
57
+ }
58
+ points.needsUpdate = true;
59
+ return labels;
60
+ }
61
+
62
+ export function clear() {
63
+ if (!state) {return;}
64
+ state.emitter?.removeFromParent(); state.emitter?.geometry.dispose(); state.emitter?.material.dispose();
65
+ state = null;
66
+ }