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,188 @@
1
+ // The emote surface: idle play's Emote button, its row of emoji, the
2
+ // expression wheel and Sit / Stand (`emoteTree.js`) with the behaviour
3
+ // `chrome.js` (`setEmotes`, `sitPrompt`, `onEmote`, `onSit`) and
4
+ // `emoteWheel.js` give them in the DOM, published as the `emotes` and
5
+ // `emotewheel` UI tree roots. No DOM and no window: it is a chrome as idle.js
6
+ // `makeIdle` takes one, so a native host runs `makeIdle(surface)` (or hands
7
+ // these four methods to its own chrome stand-in) and idle.js sends exactly
8
+ // what it sends on the web: `{ k: 'hub-emote', id }` for a pick,
9
+ // `{ k: 'hub-sit-here' }` for the wheel's Sit (its ground variant,
10
+ // `onEmote(id, true)`), `{ k: 'hub-sit', seat }` and `{ k: 'hub-stand' }`
11
+ // for Sit / Stand. The web chrome does not use it yet.
12
+ //
13
+ // makeEmoteSurface({ view, bands, onChip, draw }):
14
+ // view() the stage: { landscape, safeInsets, w, h, lift, insets:
15
+ // { top, right, bottom, left } } in CSS px (`lift` the
16
+ // portrait corner's shift-lock lift; `insets` the larger of
17
+ // the host's and the safe area's, as the wheel's probe reads);
18
+ // bands() the boxes ({ left, top, right, bottom }, CSS px) of the
19
+ // controls and cards shown now, the wheel's own excluded: the
20
+ // wheel is placed clear of them (`panelPlacement`), as
21
+ // chrome.js's surfaces() feed emoteWheel.js;
22
+ // onChip() a pick (the soundscape's chip sound);
23
+ // draw(name, tree) called with each root built (only when it changed).
24
+ import { publishUiRoot } from './uiTree.js';
25
+ import { buildEmoteWheel, buildEmotes, clampPage, wheelLayout } from './emoteTree.js';
26
+
27
+ export const EMOTE_ROOTS = { emotes: 'emotes', wheel: 'emotewheel' };
28
+
29
+ export function makeEmoteSurface({ view = () => ({}), bands = () => [], onChip = null, draw = null } = {}) {
30
+ let emoteHandler = () => {};
31
+ let sitHandler = () => {};
32
+ let emotes = null; // [[id, emoji]] or null: no Emote button
33
+ let choices = null; // the wheel's { basics, more }, or null: the row
34
+ let choicesKey = '';
35
+ let open = false;
36
+ let page = 0;
37
+ let sit = null;
38
+ let hidden = false;
39
+ let place = { emote: null, sit: null, row: null };
40
+ const keys = { emotes: '', wheel: '' };
41
+ let disposed = false;
42
+
43
+ const stage = () => view() ?? {};
44
+ const setOpen = (value) => {
45
+ open = Boolean(value) && Boolean(emotes);
46
+ // The wheel opens on its basics.
47
+ if (open) {page = 0;}
48
+ render();
49
+ };
50
+
51
+ const on = {
52
+ emotes: {
53
+ toggle: () => setOpen(!open),
54
+ // A row emoji: the row shuts, then the pick.
55
+ pick: (id) => {
56
+ setOpen(false);
57
+ onChip?.();
58
+ emoteHandler(id);
59
+ },
60
+ sit: () => sitHandler(),
61
+ close: () => setOpen(false),
62
+ },
63
+ wheel: {
64
+ pick: (id, ground) => {
65
+ setOpen(false);
66
+ onChip?.();
67
+ emoteHandler(id, ground);
68
+ },
69
+ page: (n) => {
70
+ page = Number(n) || 0;
71
+ render();
72
+ },
73
+ close: () => setOpen(false),
74
+ },
75
+ };
76
+
77
+ function publish(name, root, state, build) {
78
+ const next = JSON.stringify(state);
79
+ if (next === keys[name]) {return;}
80
+ keys[name] = next;
81
+ const tree = build(state, on[name]);
82
+ publishUiRoot(root, tree);
83
+ draw?.(root, tree);
84
+ }
85
+
86
+ function render() {
87
+ if (disposed) {return;}
88
+ const v = stage();
89
+ const wheelOpen = open && Boolean(choices);
90
+ publish('emotes', EMOTE_ROOTS.emotes, {
91
+ view: { landscape: Boolean(v.landscape), safeInsets: Boolean(v.safeInsets), w: Number(v.w) || 0, h: Number(v.h) || 0, lift: Number(v.lift) || 0 },
92
+ emotes, wheel: Boolean(choices), open, hidden, sit, place,
93
+ }, buildEmotes);
94
+ let layout = null;
95
+ if (wheelOpen) {
96
+ layout = wheelLayout({ w: v.w, h: v.h, insets: v.insets }, bands() ?? [], page);
97
+ page = clampPage(page, choices, layout);
98
+ }
99
+ publish('wheel', EMOTE_ROOTS.wheel, { open: wheelOpen, choices: wheelOpen ? choices : null, page: wheelOpen ? page : 0, layout }, buildEmoteWheel);
100
+ }
101
+
102
+ function shut() {
103
+ if (!open) {return false;}
104
+ setOpen(false);
105
+ return true;
106
+ }
107
+
108
+ render();
109
+ return {
110
+ // ---- the chrome idle.js drives ----
111
+ onEmote(handler) {
112
+ emoteHandler = typeof handler === 'function' ? handler : () => {};
113
+ },
114
+ onSit(handler) {
115
+ sitHandler = typeof handler === 'function' ? handler : () => {};
116
+ },
117
+ // chrome `setEmotes`: `list` [[id, emoji]] to offer, or null to hide
118
+ // the button (and shut what it opened); `expression` the wheel's
119
+ // choices (idle.js `expressionChoices`) at an expression place, else
120
+ // null for the row. New choices put an open wheel back on its basics.
121
+ setEmotes(list, expression = null) {
122
+ const show = Array.isArray(list) && list.length > 0;
123
+ emotes = show ? list.map(([id, emoji]) => [id, emoji]) : null;
124
+ if (!show) {
125
+ open = false;
126
+ render();
127
+ return;
128
+ }
129
+ if (expression) {
130
+ // Leaving the row for the wheel shuts it.
131
+ if (!choices) {open = false;}
132
+ const key = JSON.stringify(expression);
133
+ if (key !== choicesKey) {
134
+ choicesKey = key;
135
+ choices = { basics: expression.basics.map((entry) => [...entry]), more: expression.more.map((entry) => [...entry]) };
136
+ page = 0;
137
+ }
138
+ } else if (choices) {
139
+ // Leaving the wheel for the row shuts it.
140
+ choices = null;
141
+ choicesKey = '';
142
+ open = false;
143
+ }
144
+ render();
145
+ },
146
+ // chrome `sitPrompt`: the Sit / Stand button's words, or null to hide it.
147
+ sitPrompt(text) {
148
+ sit = text ? String(text) : null;
149
+ render();
150
+ },
151
+
152
+ // ---- the host's ----
153
+ // A turned or resized stage, or new bands (the chrome calls the wheel's
154
+ // layout again after its safe layout settles).
155
+ render,
156
+ // The boxes the host's rail layout gave the Emote and Sit buttons
157
+ // ({ x, y, w, h } CSS px, or null for the DOM's own corner spot), and,
158
+ // in a safe-inset place, the box its safe layout gave the open row
159
+ // (`row`; null: the row's own corner spot, as the safe layout leaves it
160
+ // where nothing is in its way).
161
+ place(next = {}) {
162
+ place = { emote: next.emote ?? null, sit: next.sit ?? null, row: next.row ?? null };
163
+ render();
164
+ },
165
+ // The avatar picker lies over the corner: the button hides and what it
166
+ // opened shuts (chrome.js `overPicker` / `shutRound`).
167
+ setHidden(value) {
168
+ hidden = Boolean(value);
169
+ if (hidden) {open = false;}
170
+ render();
171
+ },
172
+ // Shut the row or wheel (quick chat opening, a round shut); Back / Esc.
173
+ // Says whether it shut anything.
174
+ close: shut,
175
+ cancel: shut,
176
+ isOpen: () => open,
177
+ // 'wheel' or 'row' while open, else null.
178
+ mode: () => (open ? (choices ? 'wheel' : 'row') : null),
179
+ // The wheel's page (0 the basics).
180
+ page: () => page,
181
+ dispose() {
182
+ if (disposed) {return;}
183
+ disposed = true;
184
+ publishUiRoot(EMOTE_ROOTS.emotes, null);
185
+ publishUiRoot(EMOTE_ROOTS.wheel, null);
186
+ },
187
+ };
188
+ }
@@ -0,0 +1,264 @@
1
+ // Idle play's emote controls (contract §6, v1.6 and v1.158) as UI trees
2
+ // (schema v0): what `chrome.js` `setEmotes` / `sitPrompt` and
3
+ // `emoteWheel.js` draw in the DOM, with the same words, labels and states.
4
+ // Two roots, so the wheel can lie over what the row lies beside:
5
+ //
6
+ // - `emotes`: the round Emote button (☺) over the corner, the row of the
7
+ // kit's five emoji it opens beside itself (a place with `idle.emotes` and
8
+ // no `expression`), and the Sit / Lie down / Stand button;
9
+ // - `emotewheel` (v1.158, a place with `idle.expression`): a full-view
10
+ // shield that shuts the sheet on a press outside it, and the 240 px sheet:
11
+ // the ring of basics (each cell placed absolutely from the DOM's own
12
+ // cos/sin) or, where the ring does not fit, a compact grid, then pages of
13
+ // the place's and the original emotes, More / Basics, Next and Close.
14
+ //
15
+ // Pure: no DOM, no window; the web chrome still draws its own DOM. Lengths
16
+ // the DOM writes from trigonometry or division are rounded to 1/1000 px so
17
+ // every JS engine sends the same bytes.
18
+ //
19
+ // emotes state = {
20
+ // view: { landscape, safeInsets, w, h, lift } (CSS px; `lift` the
21
+ // portrait corner's shift-lock lift, 0 without one);
22
+ // emotes: null (no Emote button) or [[id, emoji]], the kit's EMOTES;
23
+ // wheel: the place has the expression wheel (the button opens it, not
24
+ // the row);
25
+ // open: the row or wheel is open;
26
+ // hidden: the button is out of sight (an open avatar picker lies over it);
27
+ // sit: null or the Sit button's words ('Sit', 'Lie down', 'Stand');
28
+ // place: { emote, sit, row }: each null (the DOM's own corner spot) or
29
+ // the box { x, y, w, h } (CSS px from the view's top left) the
30
+ // host's rail layout gave that button (landscape and safe-inset
31
+ // places, where the chrome's rail or safe layout moves them), and
32
+ // `row` the box a safe-inset place's safe layout gave the open row
33
+ // (a card it moves clear of the other controls; read only where
34
+ // `view.safeInsets`);
35
+ // }
36
+ // on = { toggle(), pick(id), sit(), close() }: the Emote button pressed, a
37
+ // row emoji pressed, Sit / Stand pressed, Back with the row open.
38
+ //
39
+ // wheel state = {
40
+ // open: the wheel is shown;
41
+ // choices: idle.js `expressionChoices`: { basics, more }, each [[id,
42
+ // emoji, label]];
43
+ // page: 0 the basics, n >= 1 a page of `more`;
44
+ // layout: `wheelLayout(view, bands, page)`'s result;
45
+ // }
46
+ // on = { pick(id, ground), page(n), close() }: a cell pressed (`ground` for
47
+ // the basics' Sit, idle.js's sit-here), More / Basics / Next, Close and a
48
+ // press on the shield, and Back.
49
+ import { h } from './uiTree.js';
50
+ import { panelPlacement } from './safeLayout.js';
51
+
52
+ const ROOT = { font: 'ui', size: 15, weight: 600, lh: 1.3, color: '#fff' };
53
+ const edge = (safeInsets, px) => (safeInsets ? [px, 0] : px);
54
+ const r3 = (n) => Math.round(n * 1000) / 1000;
55
+ const finiteBox = (box) => Boolean(box) && ['x', 'y', 'w', 'h'].every((key) => Number.isFinite(box[key]));
56
+
57
+ // ---- the `emotes` root ----
58
+
59
+ // The corner spots the chrome gives the Emote button, its row and Sit, or
60
+ // the host's boxes for them.
61
+ function emoteAt(view, box) {
62
+ if (finiteBox(box)) {return { anchor: 'topLeft', top: r3(box.y), left: r3(box.x) };}
63
+ const lift = view.landscape ? 0 : Number(view.lift) || 0;
64
+ return { anchor: 'bottomRight', right: edge(view.safeInsets, view.landscape ? 18 : 20), bottom: [146 + lift, 136 + lift] };
65
+ }
66
+ function rowAt(view, box, rowBox) {
67
+ if (view.safeInsets) {
68
+ // chrome.js's safe layout places the row as a card: from its own corner
69
+ // spot (right max(68, inset) turned, max(80, inset) upright; bottom
70
+ // max(146, inset + 136)), moved only clear of the other controls --
71
+ // never into the turned rail's 184 px lane, which the safe layout does
72
+ // not run. The host's box for it is that placement, kept to its bottom
73
+ // right corner.
74
+ if (finiteBox(rowBox) && Number.isFinite(view.w) && Number.isFinite(view.h)) {
75
+ return { anchor: 'bottomRight', right: r3(view.w - rowBox.x - rowBox.w), bottom: r3(view.h - rowBox.y - rowBox.h) };
76
+ }
77
+ const lift = view.landscape ? 0 : Number(view.lift) || 0;
78
+ return { anchor: 'bottomRight', right: edge(true, view.landscape ? 68 : 80), bottom: [146 + lift, 136 + lift] };
79
+ }
80
+ if (finiteBox(box) && Number.isFinite(view.w) && Number.isFinite(view.h)) {
81
+ // Just left of the button: 8 px off it upright, clear of the whole
82
+ // action lane (184 px) turned, as layoutLandscapeRail puts the card.
83
+ const off = view.w - box.x;
84
+ return { anchor: 'bottomRight', right: r3(view.landscape ? Math.max(184, off + 6) : off + 8), bottom: r3(view.h - box.y - box.h) };
85
+ }
86
+ const lift = view.landscape ? 0 : Number(view.lift) || 0;
87
+ return { anchor: 'bottomRight', right: edge(view.safeInsets, view.landscape ? 68 : 80), bottom: [146 + lift, 136 + lift] };
88
+ }
89
+ // The row's padding, inside the width maxW caps (content-box).
90
+ const ROW_PAD = 4;
91
+ // The turned row (a scroll) keeps its cap and, in a safe-inset place, also
92
+ // stays within the width of the box the host's safe layout gave it: its
93
+ // outer width, padding included. The upright row is a plain row of fixed
94
+ // buttons, so a cap would only overflow it; the host's box for it is its
95
+ // own measured size.
96
+ function rowMaxW(view, rowBox) {
97
+ if (!view.landscape) {return {};}
98
+ const terms = [{ vw: 100, px: -156 }];
99
+ if (view.safeInsets && finiteBox(rowBox) && Number.isFinite(view.w) && Number.isFinite(view.h)) {terms.push({ px: r3(Math.max(0, rowBox.w - 2 * ROW_PAD)) });}
100
+ return { maxW: terms };
101
+ }
102
+ function sitAt(view, box) {
103
+ if (finiteBox(box)) {return { anchor: 'topLeft', top: r3(box.y), left: r3(box.x) };}
104
+ return view.landscape
105
+ ? { anchor: 'bottomRight', right: edge(view.safeInsets, 12), bottom: [112, 102] }
106
+ : { anchor: 'bottom', bottom: [112, 102] };
107
+ }
108
+
109
+ export function buildEmotes(state, on = {}) {
110
+ const view = state.view ?? {};
111
+ const landscape = Boolean(view.landscape);
112
+ const place = state.place ?? {};
113
+ const emotes = Array.isArray(state.emotes) && state.emotes.length ? state.emotes : null;
114
+ const rowOpen = Boolean(emotes && state.open && !state.wheel);
115
+ const round = landscape ? 44 : 52;
116
+ return h('stack', {
117
+ key: 'emotes', style: ROOT,
118
+ // Back shuts an open row; the wheel's own root takes Back for the wheel.
119
+ on: { cancel: rowOpen ? on.close : undefined },
120
+ },
121
+ emotes ? h('button', {
122
+ key: 'emote', label: 'Emote', fire: 'down',
123
+ at: emoteAt(view, place.emote),
124
+ style: {
125
+ box: 'border', w: round, h: round, radius: round / 2, pad: 0, border: { w: 2, c: 'rgba(255,255,255,0.5)' },
126
+ bg: 'copy', color: '#fff', size: 24, weight: 400, lh: 'normal', ...(state.hidden ? { hidden: true } : {}),
127
+ },
128
+ on: { tap: on.toggle },
129
+ }, '☺') : null,
130
+ rowOpen ? h(landscape ? 'scroll' : 'row', {
131
+ key: 'row', ...(landscape ? { axis: 'x' } : {}),
132
+ at: rowAt(view, place.emote, place.row),
133
+ style: { gap: 6, pad: ROW_PAD, radius: 28, bg: 'copy', hit: 'auto', ...rowMaxW(view, place.row) },
134
+ }, emotes.map(([id, emoji]) => h('button', {
135
+ key: `e:${id}`, label: String(id), fire: 'down', data: { emote: String(id) },
136
+ style: { w: 44, h: 44, radius: 22, pad: 0, bg: 'transparent', size: 26, weight: 400, lh: 'normal', flex: '0 0 auto' },
137
+ on: { tap: () => on.pick?.(id) },
138
+ }, String(emoji)))) : null,
139
+ state.sit ? h('button', {
140
+ key: 'sit', fire: 'down',
141
+ at: sitAt(view, place.sit),
142
+ style: {
143
+ pad: [10, 22], radius: 22, border: { w: 1, c: 'line45' }, bg: 'toast', color: '#fff',
144
+ ...(landscape ? { maxW: [{ vw: 38 }, { px: 160 }] } : {}),
145
+ },
146
+ on: { tap: on.sit },
147
+ }, String(state.sit)) : null);
148
+ }
149
+
150
+ // ---- the `emotewheel` root ----
151
+
152
+ export const WHEEL_W = 240;
153
+ // The ring's box and the nav row under every page.
154
+ const RING_H = 284;
155
+ const GRID_H = 148;
156
+ const NAV_H = 44;
157
+ const PAD = 4;
158
+
159
+ // emoteWheel.js `layout`, without the DOM: where the sheet goes clear of the
160
+ // shown controls (`panelPlacement`), whether the ring fits, and the grid.
161
+ // `view` { w, h, insets: { top, right, bottom, left } } in CSS px (the
162
+ // insets the larger of the host's and the safe area's); `bands` the boxes
163
+ // of the shown controls and cards ({ left, top, right, bottom }), the
164
+ // wheel's own excluded; `page` as drawn.
165
+ export function wheelLayout(view, bands = [], page = 0) {
166
+ const insets = view?.insets ?? {};
167
+ const v = {
168
+ w: Number(view?.w) || 0, h: Number(view?.h) || 0,
169
+ insets: Object.fromEntries(['top', 'right', 'bottom', 'left'].map((side) => [side, Number(insets[side]) || 0])),
170
+ };
171
+ const obstacles = Array.isArray(bands) ? bands : [];
172
+ const place = (height, top) => panelPlacement({ left: (v.w - WHEEL_W) / 2, right: (v.w + WHEEL_W) / 2, top: (v.h - height) / 2, bottom: (v.h + height) / 2 }, v, { top, bottom: 12, left: 12, right: 12 }, obstacles, WHEEL_W);
173
+ let placed = place(RING_H, 64);
174
+ const ring = placed.h >= RING_H && placed.w >= WHEEL_W;
175
+ if (!ring) {
176
+ placed = place(GRID_H, 64);
177
+ if (placed.h < GRID_H) {
178
+ // Actual HUD bands still reserve their space when the blanket top
179
+ // margin is reduced to the ordinary safe edge.
180
+ const compact = place(GRID_H, 12);
181
+ if (compact.h > placed.h) {placed = compact;}
182
+ }
183
+ }
184
+ const columns = ring ? 3 : 4;
185
+ const rows = ring ? 2 : Math.max(1, Math.min(2, Math.floor((placed.h - 52) / 48)));
186
+ return { placed, ring, columns, bodyHeight: ring ? 232 : (page ? rows : 2) * 48, pageSize: Math.min(6, columns * rows) };
187
+ }
188
+
189
+ // How many pages of `more` there are at a layout's page size.
190
+ export const wheelPages = (choices, layout) => Math.ceil((choices?.more?.length ?? 0) / layout.pageSize);
191
+ // emoteWheel.js `draw`'s clamp: a page past the last is the last (or the
192
+ // basics when there are none).
193
+ export const clampPage = (page, choices, layout) => (page ? Math.min(page, wheelPages(choices, layout)) : 0);
194
+
195
+ // The cells on a page, each { id, emoji, label, ground, left, top, w, h }
196
+ // in px inside the sheet's body: on the basics with the ring, the DOM's
197
+ // circle (radius 86 about 88, 92; 45° apart from the top); otherwise rows
198
+ // of `count` across the sheet's width.
199
+ export function wheelCells(choices, layout, page) {
200
+ const { placed, ring, columns, pageSize } = layout;
201
+ if (page === 0 && ring) {
202
+ return (choices?.basics ?? []).map(([id, emoji, label], i) => {
203
+ const angle = i * Math.PI / 4 - Math.PI / 2;
204
+ return { id, emoji, label, ground: id === 'sit', left: r3(88 + Math.cos(angle) * 86), top: r3(92 + Math.sin(angle) * 86), w: 56, h: 48 };
205
+ });
206
+ }
207
+ const entries = page ? (choices?.more ?? []).slice((page - 1) * pageSize, page * pageSize) : (choices?.basics ?? []);
208
+ const count = page ? columns : 4;
209
+ const width = (placed.w - 8 - (count - 1) * 6) / count;
210
+ // Before the layout is known (placed.w 0) the width is not positive: the
211
+ // cell carries no w (minW holds it, as the DOM's dropped width does) and
212
+ // its left counts no width.
213
+ const across = width > 0 ? width : 0;
214
+ return entries.map(([id, emoji, label], i) => ({
215
+ id, emoji, label, ground: !page && id === 'sit',
216
+ left: r3(i % count * (across + 6)), top: Math.floor(i / count) * (ring ? 54 : 48) + (ring ? 62 : 0), ...(width > 0 ? { w: r3(width) } : {}), h: ring ? 48 : 44,
217
+ }));
218
+ }
219
+
220
+ // emoteWheel.js `button`'s style.
221
+ const CELL = {
222
+ box: 'border', minW: 44, minH: 44, border: { w: 1, c: 'line35' }, radius: 16, bg: 'rgba(255,255,255,0.08)',
223
+ color: '#fff', font: 'ui', size: 12, weight: 600, pad: 2,
224
+ };
225
+
226
+ export function buildEmoteWheel(state, on = {}) {
227
+ const root = { key: 'emotewheel', style: ROOT };
228
+ const choices = state.choices;
229
+ const layout = state.layout;
230
+ if (!state.open || !choices || !layout) {return h('stack', root);}
231
+ const page = Number(state.page) || 0;
232
+ const { placed, bodyHeight, pageSize } = layout;
233
+ const seen = new Map();
234
+ const keyFor = (id) => {
235
+ const n = seen.get(id) ?? 0;
236
+ seen.set(id, n + 1);
237
+ return n ? `e:${id}#${n}` : `e:${id}`;
238
+ };
239
+ const cells = wheelCells(choices, layout, page).map((cell) => h('button', {
240
+ key: keyFor(cell.id), label: String(cell.label ?? ''), data: { emote: String(cell.id) },
241
+ at: { anchor: 'topLeft', left: cell.left, top: cell.top },
242
+ style: { ...CELL, w: cell.w, h: cell.h },
243
+ on: { tap: () => on.pick?.(cell.id, cell.ground) },
244
+ },
245
+ h('column', { key: 'cell', style: { w: 'fill', hit: 'none' } },
246
+ h('text', { key: 'emoji', text: String(cell.emoji ?? ''), style: { size: 22, h: 24, lh: 1.0909 } }),
247
+ h('text', { key: 'label', text: String(cell.label ?? ''), style: { h: 14, lh: 1.1667, lines: 1, ellipsis: true } }))));
248
+ const pages = Math.ceil((choices.more?.length ?? 0) / pageSize);
249
+ const nav = (key, text, label, tap) => h('button', { key, label, style: CELL, on: { tap } }, text);
250
+ return h('stack', { ...root, on: { cancel: on.close } },
251
+ // A press anywhere off the sheet shuts it (the DOM's capturing
252
+ // pointerdown outside the sheet).
253
+ h('button', { key: 'shield', label: 'Close emotes', fire: 'down', at: { anchor: 'fill' }, style: { bg: 'transparent', hit: 'auto' }, on: { tap: on.close } }),
254
+ h('scroll', {
255
+ key: 'sheet', axis: 'y', role: 'dialog', label: 'Emotes', report: true,
256
+ at: { anchor: 'topLeft', top: r3(placed.y), left: r3(placed.x) },
257
+ style: { box: 'border', w: r3(placed.w), h: bodyHeight + NAV_H + 2 * PAD, maxH: r3(placed.h), pad: PAD, radius: 24, bg: 'rgba(20,16,12,0.94)', hit: 'auto' },
258
+ },
259
+ h('stack', { key: 'body', style: { w: 'fill', h: bodyHeight, flex: '0 0 auto' } }, cells),
260
+ h('row', { key: 'nav', style: { h: NAV_H, justify: 'between', gap: 6, flex: '0 0 auto' } },
261
+ nav('page', page ? 'Basics' : 'More', page ? 'Basic emotes' : 'More emotes', () => on.page?.(page ? 0 : 1)),
262
+ page && (choices.more?.length ?? 0) > pageSize ? nav('next', 'Next', 'Next emotes', () => on.page?.(page % pages + 1)) : null,
263
+ nav('close', 'Close', 'Close emotes', on.close))));
264
+ }
@@ -2,6 +2,7 @@ import { ensureActorModel } from './modelReady.js';
2
2
  import * as THREE from 'three';
3
3
  import { mergeGeometries } from 'three/addons/utils/BufferGeometryUtils.js';
4
4
  import { lookOf, rigOf, sharedFor } from './avatarShare.js';
5
+ import { hideVisible, restoreVisible } from './renderVisibility.js';
5
6
 
6
7
  const PLAIN_RENDER = String(THREE.Object3D.prototype.onBeforeRender);
7
8
 
@@ -23,7 +24,7 @@ export function makeFarAvatars() {
23
24
  }
24
25
  rows.delete(id);
25
26
  row.node.removeEventListener('removed', row.removed);
26
- row.rig.visible = row.visible;
27
+ restoreVisible(row.hidden);
27
28
  row.proxy.removeFromParent();
28
29
  row.built.users -= 1;
29
30
  if (!row.built.users) {
@@ -135,12 +136,12 @@ export function makeFarAvatars() {
135
136
  proxy.add(mesh.clone());
136
137
  }
137
138
  const removed = () => release(id);
138
- const row = { node: entry.node, rig, template, built, proxy, visible: rig.visible, removed };
139
+ const row = { node: entry.node, rig, template, built, proxy, hidden: new Map(), removed };
139
140
  rows.set(id, row);
140
141
  built.users += 1;
141
142
  entry.node.add(proxy);
142
143
  entry.node.addEventListener('removed', removed);
143
- rig.visible = false;
144
+ hideVisible(row.hidden, rig);
144
145
  }
145
146
 
146
147
  function clear() {
@@ -17,7 +17,9 @@ export function makeFpsTelemetry({ send, document: doc = globalThis.document, ta
17
17
  if (!samples.length || !context) {return;}
18
18
  const sorted = [...samples].sort((a, b) => a - b);
19
19
  const quantile = (q) => Math.min(4095, Math.max(0, Math.round(sorted[Math.max(0, Math.ceil(q * sorted.length) - 1)] * 10)));
20
- const message = { k: 'hub-fps', median: quantile(0.5), p10: quantile(0.1), ...context, final };
20
+ const { quality, ...measurements } = context;
21
+ const message = { k: 'hub-fps', median: quantile(0.5), p10: quantile(0.1), ...measurements,
22
+ ...(quality === 'hide' || quality === 'skip' ? { quality } : {}), final };
21
23
  samples = []; elapsed = 0;
22
24
  try { send(message); } catch { /* Never interrupt a departure. */ }
23
25
  };