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
@@ -3,7 +3,7 @@
3
3
  // It is shown only through friendsAmong: ghost requires mutual follows, no
4
4
  // block and both players answered over 13; under-13 players see and show nobody.
5
5
  // Their client may ask Hub.friends, but ghost returns nothing; no data flows.
6
- import { USER_ID } from './friendsAmong.js';
6
+ import { USER_ID, emptyFor } from './friendsAmong.js';
7
7
 
8
8
  const INDEX_MS = 60000;
9
9
  const FRIEND_MS = 10 * 60000;
@@ -128,8 +128,15 @@ export function friendBests(h, key, options, userIdOf) {
128
128
  return null;
129
129
  }
130
130
  let visit = visits.get(playerId);
131
+ // A visit's membership belongs to the account it was asked for.
132
+ if (visit && visit.userId !== userId) {
133
+ if (visit.asking) {
134
+ return null;
135
+ }
136
+ visit = null;
137
+ }
131
138
  if (!visit || (!visit.asking && Date.now() - visit.at >= visit.ttl)) {
132
- visit = { at: Date.now(), ttl: EMPTY_MS, asking: true, pending: null };
139
+ visit = { userId, at: Date.now(), ttl: EMPTY_MS, asking: true, pending: null };
133
140
  visits.set(playerId, visit);
134
141
  visit.pending = Promise.resolve()
135
142
  .then(async () => {
@@ -142,14 +149,16 @@ export function friendBests(h, key, options, userIdOf) {
142
149
  })
143
150
  .catch(() => new Set())
144
151
  .then((ids) => {
145
- visit.ttl = ids.size ? FRIEND_MS : EMPTY_MS;
152
+ // v1.166: an empty answer from the session's first minute is kept
153
+ // only until friendsAmong may read again (5 s after a provisional one).
154
+ visit.ttl = ids.size ? FRIEND_MS : emptyFor(h, playerId, userId);
146
155
  visit.asking = false;
147
156
  return ids;
148
157
  });
149
158
  }
150
159
  const ids = await visit.pending;
151
160
  const rows = await read();
152
- if (!signedIn(playerId) || visits.get(playerId) !== visit) {
161
+ if (signedIn(playerId) !== userId || visits.get(playerId) !== visit) {
153
162
  return null;
154
163
  }
155
164
  const friend = rows.find((row) => ids.has(row.userId) && row.userId !== userId);
@@ -11,6 +11,15 @@ export const USER_ID = /^\d{1,20}$/;
11
11
  const EMPTY_MS = 40000;
12
12
  const FRIEND_MS = 10 * 60000;
13
13
  const MIN_READ_GAP_MS = 31000;
14
+ // v1.166: an account's first read in this session that comes back empty is
15
+ // provisional (ghost may not yet have marked a session the player has only just
16
+ // entered): cached this long, and the next read may go out once it expires,
17
+ // inside MIN_READ_GAP_MS. Only the first read of each account in a session is,
18
+ // and a read begun within EARLY_WINDOW_MS of that first holds the next one off
19
+ // until the window ends, so at most two ops go out in it (ghost allows two a
20
+ // minute per player per session). freshFriends places are unchanged.
21
+ export const EARLY_EMPTY_MS = 5000;
22
+ export const EARLY_WINDOW_MS = 60000;
14
23
  const ARRIVAL_MS = 60000;
15
24
  const CHECK_MS = 5000;
16
25
  const FRESH_READ_MS = 900;
@@ -70,6 +79,15 @@ export async function friendsAmong(h, playerId, userIds, userIdOf) {
70
79
  }
71
80
  }
72
81
  let entry = cache.get(playerId);
82
+ // A player id can come back as another account: an entry answers only
83
+ // for the account it was read for, and an account change fails closed.
84
+ const owner = userIdOf(h, playerId);
85
+ if (entry && entry.owner !== owner) {
86
+ if (entry.pending || now - entry.at < MIN_READ_GAP_MS) {
87
+ return [];
88
+ }
89
+ entry = null;
90
+ }
73
91
  const freshUser = h.place?.freshFriends === true ? userIdOf(h, playerId) : null;
74
92
  if (freshUser && entry && entry.userId !== freshUser) {
75
93
  if (entry.pending || now - entry.at < MIN_READ_GAP_MS) {
@@ -83,7 +101,10 @@ export async function friendsAmong(h, playerId, userIds, userIdOf) {
83
101
  }
84
102
  if (entry?.pending) {
85
103
  await entry.pending;
86
- if (!h.sim?.players.has(playerId) || !USER_ID.test(userIdOf(h, playerId) ?? '')) {
104
+ // The account may have changed while waiting: a covering read started now
105
+ // would be stored under the account captured before the wait.
106
+ if (!h.sim?.players.has(playerId) || !USER_ID.test(userIdOf(h, playerId) ?? '') ||
107
+ userIdOf(h, playerId) !== owner) {
87
108
  return [];
88
109
  }
89
110
  // Another waiting ask may already have latched the covering read.
@@ -91,16 +112,19 @@ export async function friendsAmong(h, playerId, userIds, userIdOf) {
91
112
  }
92
113
  const readAt = Date.now();
93
114
  const placeIds = placeUsers(h, playerId, userIdOf);
94
- if (!entry || (!entry.pending && readAt - entry.at >= MIN_READ_GAP_MS &&
115
+ if (!entry || (!entry.pending && readAt - entry.at >= gapOf(entry) &&
95
116
  (stale(entry, readAt, placeIds) || (hasNew(entry, ids) && !(entry.refused && readAt - entry.at < entry.ttl))))) {
96
- entry = startRead(h, playerId, [...new Set([...ids, ...placeIds])].slice(0, 100), readAt, freshUser);
117
+ entry = startRead(h, playerId, [...new Set([...ids, ...placeIds])].slice(0, 100), readAt, freshUser, owner);
97
118
  }
98
119
  entry.deckIds = ids;
99
120
  } else if (!entry || (!entry.pending && now - entry.at >= entry.ttl)) {
100
121
  // Keyless calls keep the original TTL, candidates and pending behavior.
101
- entry = startRead(h, playerId, ids, now);
122
+ entry = startRead(h, playerId, ids, now, null, owner);
102
123
  }
103
124
  await entry.pending;
125
+ if (entry.owner !== userIdOf(h, playerId)) {
126
+ return [];
127
+ }
104
128
  if (h.place?.freshFriends === true &&
105
129
  (!h.sim?.players.has(playerId) || userIdOf(h, playerId) !== entry.userId || Date.now() - entry.at >= entry.ttl)) {
106
130
  return [];
@@ -123,24 +147,59 @@ function hasNew(entry, placeIds) {
123
147
  return placeIds.some((id) => !asked.has(id));
124
148
  }
125
149
 
150
+ // The read gap after `entry`: shorter after a provisional empty answer, longer
151
+ // for a read that has to keep the next one out of the first read's window.
152
+ function gapOf(entry) {
153
+ return entry.provisional ? EARLY_EMPTY_MS : Math.max(MIN_READ_GAP_MS, entry.hold ?? 0);
154
+ }
155
+
156
+ // How long a caller should keep an empty answer for `playerId`'s account
157
+ // `userId`: EMPTY_MS, or for an early-window read (v1.166) until its cache entry
158
+ // may first be read again (by expiry, or past the gap for new candidates), so a
159
+ // caller neither asks before that nor long after.
160
+ export function emptyFor(h, playerId, userId) {
161
+ const entry = h.friendsCache?.get(playerId);
162
+ if (!entry || entry.pending || entry.owner !== userId || !(entry.provisional || entry.hold)) {
163
+ return EMPTY_MS;
164
+ }
165
+ return Math.max(0, entry.at + Math.min(entry.ttl, gapOf(entry)) - Date.now());
166
+ }
167
+
126
168
  function stale(entry, now, placeIds) {
127
169
  const age = now - entry.at;
128
170
  return age >= entry.ttl || (age >= ARRIVAL_MS && hasNew(entry, placeIds));
129
171
  }
130
172
 
131
- function startRead(h, playerId, ids, now, userId = null) {
173
+ function startRead(h, playerId, ids, now, userId = null, owner = undefined) {
132
174
  const fresh = h.place?.freshFriends === true;
133
175
  const entry = {
134
176
  ...(fresh ? { userId } : {}),
177
+ owner,
135
178
  at: now, ttl: fresh ? MIN_READ_GAP_MS : EMPTY_MS, ids: [], follows: [], followedBy: [], asked: ids, pending: null,
136
179
  };
137
180
  (h.friendsCache ??= new Map()).set(playerId, entry);
181
+ // When each account first read in this session (v1.166).
182
+ const firsts = (h.friendsRead ??= new Map());
183
+ const firstAt = firsts.get(owner);
184
+ const first = !fresh && firstAt === undefined;
185
+ if (first) {
186
+ firsts.set(owner, now);
187
+ } else if (!fresh && now - firstAt < EARLY_WINDOW_MS) {
188
+ entry.hold = firstAt + EARLY_WINDOW_MS - now;
189
+ }
138
190
  // Latch before awaiting: deck asks and background primes share this read.
139
191
  entry.pending = (fresh ? freshRead(h, playerId, ids) : read(h, playerId, ids)).then((answer) => {
140
192
  entry.ids = answer.friends;
141
193
  entry.follows = answer.follows;
142
194
  entry.followedBy = answer.followedBy;
143
- entry.ttl = fresh ? MIN_READ_GAP_MS : answer.friends.length ? FRIEND_MS : EMPTY_MS;
195
+ entry.provisional = first && !answer.friends.length;
196
+ entry.ttl = fresh
197
+ ? MIN_READ_GAP_MS
198
+ : answer.friends.length
199
+ ? FRIEND_MS
200
+ : first
201
+ ? EARLY_EMPTY_MS
202
+ : Math.max(EMPTY_MS, entry.hold ?? 0);
144
203
  entry.refused = answer.refused === true;
145
204
  entry.pending = null;
146
205
  });
@@ -177,12 +236,12 @@ export function prime(h, playerId, userIdOf, placeIds) {
177
236
  placeIds ??= placeUsers(h, playerId, userIdOf);
178
237
  // Expiry retries even for an unchanged roster, including refused reads.
179
238
  // Non-empty mutual-friend entries also refresh for arrivals after a minute.
180
- if (entry && (now - entry.at < MIN_READ_GAP_MS || !stale(entry, now, placeIds))) {
239
+ if (entry && (now - entry.at < gapOf(entry) || !stale(entry, now, placeIds))) {
181
240
  return;
182
241
  }
183
242
  const ids = [...new Set([...(entry?.deckIds ?? []), ...placeIds])].slice(0, 100);
184
243
  if (ids.length) {
185
- const fresh = startRead(h, playerId, ids, now, userIdOf(h, playerId));
244
+ const fresh = startRead(h, playerId, ids, now, userIdOf(h, playerId), userIdOf(h, playerId));
186
245
  fresh.deckIds = entry?.deckIds ?? [];
187
246
  }
188
247
  }
@@ -8,7 +8,7 @@
8
8
  //
9
9
  // { k: 'hub-grab', actor, op: 'grab' | 'throw' } client -> server
10
10
  // { k: 'hub-grab-deny', actor } server -> that client
11
- // { k: 'hub-drop' } server -> that client
11
+ // { k: 'hub-drop', actor? } server -> that client
12
12
  //
13
13
  // A place may keep a held object its holder's (v1.25, `grab.keepHeld`):
14
14
  // multiplayer-3d hands a loose object to whichever player is nearer, so
@@ -34,6 +34,7 @@
34
34
  // against the simulation and bounded per player.
35
35
 
36
36
  import { warnOnce } from './actors.js';
37
+ import { disguised } from './disguise.js';
37
38
 
38
39
  // How far from a player's body (metres) an object they say they grabbed may
39
40
  // be: the client offers one within about 2.5 m (with a place's `grab.reach`
@@ -383,6 +384,7 @@ export function message(h, playerId, data) {
383
384
  if (
384
385
  !entered ||
385
386
  h.held.has(playerId) ||
387
+ (h.disguiseUsed && disguised(h, playerId)?.look) ||
386
388
  entry?.owner !== playerId ||
387
389
  !near(h, playerId, entry, GRAB_REACH)
388
390
  ) {
@@ -403,6 +405,8 @@ export function message(h, playerId, data) {
403
405
  const stamp = keeps(h) ? endsOf(h, playerId, actorId) : null;
404
406
  if (
405
407
  !ask(h, playerId, actorId, 'grab') ||
408
+ // v1.196: the grab hook may have disguised the player before recording the hold.
409
+ (h.disguiseUsed && disguised(h, playerId)?.look) ||
406
410
  (stamp !== null && (endsOf(h, playerId, actorId) !== stamp || !stillGrabbable(h, playerId, actorId))) ||
407
411
  // v1.27: the hook itself kept the object for someone else.
408
412
  keptFromPlayer(h, playerId, actorId)
@@ -455,7 +459,10 @@ function capSpeed(body, cap) {
455
459
  }
456
460
 
457
461
  // `hub.drop(playerId?)`: whoever holds something lets go (default: everyone).
458
- // Only players the place knows hold something are told. Returns how many.
462
+ // With no id only players the place knows hold something are told; a named
463
+ // player here is told even when it registered no hold (v1.191), as a client
464
+ // may hold what the server never heard of. Returns how many registered holds
465
+ // ended.
459
466
  export function drop(h, playerId) {
460
467
  ended(h, playerId);
461
468
  let n = 0;
@@ -467,6 +474,9 @@ export function drop(h, playerId) {
467
474
  h.session?.send(holder, { k: 'hub-drop', actor: actorId });
468
475
  n += 1;
469
476
  }
477
+ if (playerId !== undefined && n === 0 && h.players.has(playerId)) {
478
+ h.session?.send(playerId, { k: 'hub-drop' });
479
+ }
470
480
  return n;
471
481
  }
472
482
 
@@ -0,0 +1,142 @@
1
+ // v1.180 `heldOffers: true`: hub.actions, hub.ask and hub.menu offers made
2
+ // to a retained player are kept while they are away and replayed, under fresh
3
+ // versions, on their resume hello. Nothing here runs, and no state exists, in
4
+ // a place without the key (or one with no resume mode in force).
5
+ //
6
+ // The invariant, enforced by `gate` on every call, press, tick and replay:
7
+ //
8
+ // An offer for transport id P is recorded, sent or pressed only under P's
9
+ // live hold H = (signed-in account A, body B). It is sent or pressed only
10
+ // while H is here: P's roster row is A, P's body is B, and nothing has
11
+ // interrupted that since the last replay. Any interruption -- the row gone,
12
+ // the body gone, or the body changed (a replacement included) -- puts H
13
+ // away: calls are recorded, nothing is sent or pressed, until a fresh hello
14
+ // finds A back on a body the kit took for A. That hello rebinds B and
15
+ // re-versions every offer, so no older version is ever pressable. Anyone
16
+ // but A on P's roster row (another account, a guest, an anonymous identity;
17
+ // with or without a body) or on P's visit entry ends H and blocks P: no
18
+ // channel records, sends or admits anything on P until a fresh hello
19
+ // rebuilds the entry for whoever is then on the row. A body change never
20
+ // ends H; prepareResume decides it (adopts the body, which a fresh hello
21
+ // then takes, or forgets the visit, which forgets H).
22
+ //
23
+ // Each offer carries the hold object it was made under, so a hold that ends
24
+ // takes every offer made under it with no replay, even if the same account is
25
+ // held again later. Guests and anonymous players get no hold; their offers
26
+ // follow the ordinary rules unless P is blocked.
27
+ const USER_ID = /^\d{1,20}$/;
28
+ const BLOCK = 'block';
29
+
30
+ export function on(h) {
31
+ return h.place?.heldOffers === true && Boolean(h.resumeKept);
32
+ }
33
+ function rowOf(h, playerId) {
34
+ return h.session?.players.find((p) => p.playerId === playerId) ?? null;
35
+ }
36
+ // Only a signed-in account holds anything: never a guest, dev guest or an
37
+ // anonymous identity (two missing accounts are not the same player).
38
+ function account(row) {
39
+ return row && !row.isAnonymous && USER_ID.test(String(row.userId ?? '')) ? String(row.userId) : null;
40
+ }
41
+ function end(h, playerId, block) {
42
+ h.offerHolds?.delete(playerId);
43
+ if (block) {
44
+ (h.offerBlocked ??= new Set()).add(playerId);
45
+ }
46
+ return null;
47
+ }
48
+ const blocked = (h, playerId) => h.offerBlocked?.has(playerId) === true;
49
+
50
+ // The hold in force on this id after checking it: { hold, away }, or null.
51
+ function check(h, playerId) {
52
+ const hold = h.offerHolds?.get(playerId);
53
+ if (!hold) {
54
+ return null;
55
+ }
56
+ const row = rowOf(h, playerId), body = h.sim?.players.get(playerId), entry = h.players?.get(playerId);
57
+ if ((row && account(row) !== hold.userId) || !entry || entry.userId !== hold.userId || entry.anonymous === true) {
58
+ return end(h, playerId, true);
59
+ }
60
+ if (entry.ended) {
61
+ return end(h, playerId, false);
62
+ }
63
+ if (row && body && body === hold.body && !hold.away) {
64
+ return { hold, away: false };
65
+ }
66
+ if (!h.resumeKept?.get(playerId)) {
67
+ return end(h, playerId, false);
68
+ }
69
+ hold.away = true;
70
+ return { hold, away: true };
71
+ }
72
+
73
+ // For a channel state on this id: 'here' (send and press), 'away' (keep;
74
+ // neither send nor press), 'drop' (forget it, no replay), 'block' (forget it;
75
+ // nothing on this id until a fresh hello), or null: no hold and none needed
76
+ // (a guest's offer, under the ordinary rules).
77
+ export function gate(h, playerId, state) {
78
+ const held = check(h, playerId);
79
+ if (blocked(h, playerId)) {
80
+ return BLOCK;
81
+ }
82
+ if (!held) {
83
+ return state?.hold ? 'drop' : null;
84
+ }
85
+ if (state && state.hold !== held.hold) {
86
+ return 'drop';
87
+ }
88
+ return held.away ? 'away' : 'here';
89
+ }
90
+
91
+ // A call: the hold to record under ({ hold, away }), 'block', or null for a
92
+ // player who gets no hold (ordinary rules). Stamps a new hold for a signed-in
93
+ // account connected on the id when none is in force.
94
+ export function take(h, playerId) {
95
+ const held = check(h, playerId);
96
+ if (blocked(h, playerId)) {
97
+ return BLOCK;
98
+ }
99
+ if (held) {
100
+ return held;
101
+ }
102
+ const row = rowOf(h, playerId), body = h.sim?.players.get(playerId), entry = h.players?.get(playerId);
103
+ const userId = account(row);
104
+ if (!userId || !body || !entry || entry.ended || entry.userId !== userId) {
105
+ return null;
106
+ }
107
+ const hold = { userId, body, away: false };
108
+ (h.offerHolds ??= new Map()).set(playerId, hold);
109
+ return { hold, away: false };
110
+ }
111
+
112
+ // A fresh hello, before the channels replay: the owner back on the hold's
113
+ // body, or on the replacement prepareResume took for them, lets offers go
114
+ // again under that body (each channel re-versions its own).
115
+ export function replay(h, playerId) {
116
+ const held = check(h, playerId);
117
+ if (!held || blocked(h, playerId)) {
118
+ return;
119
+ }
120
+ const body = h.sim?.players.get(playerId), kept = h.resumeKept?.get(playerId);
121
+ if (rowOf(h, playerId) && body && (body === held.hold.body || (kept?.body === body && kept.awayAt === undefined))) {
122
+ held.hold.body = body;
123
+ held.hold.away = false;
124
+ }
125
+ }
126
+
127
+ // A fresh hello, after its entry is rebuilt for whoever is on the row: that
128
+ // lifts a block and stamps their hold.
129
+ export function hello(h, playerId) {
130
+ h.offerBlocked?.delete(playerId);
131
+ take(h, playerId);
132
+ }
133
+
134
+ export function prune(h) {
135
+ for (const playerId of [...(h.offerHolds?.keys() ?? [])]) {
136
+ check(h, playerId);
137
+ }
138
+ }
139
+ export function forget(h, playerId) {
140
+ h.offerHolds?.delete(playerId);
141
+ h.offerBlocked?.delete(playerId);
142
+ }
@@ -0,0 +1,98 @@
1
+ // v1.182: visit-only right-hand flowers. No host calls or persistence.
2
+ import { HOLD_SHOW_SHAPES } from '../client/holdShow.js';
3
+
4
+ export function newHoldShowState() {
5
+ return { holdShows: new Map(), holdShowOwners: new Map(), holdShowWire: new Map(),
6
+ holdShowAt: new Map(), holdShowUsed: false, sentHoldShowMe: new Map(), holdShowAloneUsed: false };
7
+ }
8
+
9
+ function clean(spec) {
10
+ if (spec === null) { return null; }
11
+ const fail = () => { throw new TypeError('hub.holdShow: expected { shape, color: "#rrggbb" } or null'); };
12
+ if (!spec || typeof spec !== 'object' || ![Object.prototype, null].includes(Object.getPrototypeOf(spec))) { return fail(); }
13
+ const fields = Object.getOwnPropertyDescriptors(spec);
14
+ if (Reflect.ownKeys(fields).length !== 2 || !Object.hasOwn(fields, 'shape') || !Object.hasOwn(fields, 'color') ||
15
+ !Object.hasOwn(fields.shape, 'value') || !Object.hasOwn(fields.color, 'value')) { return fail(); }
16
+ const shape = fields.shape.value, color = fields.color.value;
17
+ if (!HOLD_SHOW_SHAPES.includes(shape) || typeof color !== 'string' || color.length !== 7 || !/^#[0-9a-f]{6}$/i.test(color)) { return fail(); }
18
+ return { shape, color: color.toLowerCase() };
19
+ }
20
+ const owner = (h, id) => h.session?.players.find((p) => p.playerId === id)?.userId ?? null;
21
+ const present = (h, id) => h.players.get(id)?.arrived && h.sim?.players.has(id) && h.session?.players.some((p) => p.playerId === id);
22
+
23
+ export function holdShow(h, playerId, spec) {
24
+ const value = clean(spec); // Invalid input throws even for a missing player.
25
+ prune(h);
26
+ if (!present(h, playerId) || h.resumeDeparting?.has(playerId)) { return false; }
27
+ if (value) {
28
+ h.holdShows.set(playerId, value);
29
+ h.holdShowOwners.set(playerId, owner(h, playerId));
30
+ h.holdShowUsed = true;
31
+ } else {
32
+ h.holdShows.delete(playerId);
33
+ }
34
+ return true;
35
+ }
36
+ export function holdShowing(h, playerId) {
37
+ prune(h);
38
+ const value = h.holdShows.get(playerId);
39
+ return value ? { ...value } : null;
40
+ }
41
+ export function prune(h) {
42
+ for (const id of new Set([...h.holdShows.keys(), ...h.holdShowWire.keys()])) {
43
+ if (!h.players.has(id) || h.resumeDeparting?.has(id) ||
44
+ (h.session?.players.some((p) => p.playerId === id) && h.holdShowOwners.has(id) && h.holdShowOwners.get(id) !== owner(h, id))) {
45
+ forget(h, id);
46
+ }
47
+ }
48
+ }
49
+
50
+ // Whole-map equality latch lives in hub.js, like hubRole. Each player's most
51
+ // recent value reaches this projection at most once per 250 ms, independently.
52
+ // Reads remain immediate; short drops keep both the visit value and its owner.
53
+ export function shown(h) {
54
+ prune(h);
55
+ const now = h.sim?.timeMs ?? 0;
56
+ for (const id of new Set([...h.holdShows.keys(), ...h.holdShowWire.keys()])) {
57
+ const value = h.holdShows.get(id);
58
+ const tuple = value && !h.grabs.has(id) ? [value.shape, value.color] : null;
59
+ if (JSON.stringify(h.holdShowWire.get(id) ?? null) === JSON.stringify(tuple)) { continue; }
60
+ if (now - (h.holdShowAt.get(id) ?? -Infinity) < 250) { continue; }
61
+ if (tuple) { h.holdShowWire.set(id, tuple); } else { h.holdShowWire.delete(id); }
62
+ h.holdShowAt.set(id, now);
63
+ }
64
+ // A grab owns the hand for every viewer, without changing the visit value.
65
+ // Absence hides immediately, even within the coalescing interval.
66
+ return new Map([...h.holdShowWire].filter(([id]) => present(h, id)));
67
+ }
68
+ export function fields(h, hidden) {
69
+ return Object.fromEntries([...shown(h)].filter(([id]) => !hidden?.has(id)).map(([id, tuple]) => [id, [...tuple]]));
70
+ }
71
+ export function sendOverrides(h, hidden) {
72
+ const worn = shown(h);
73
+ for (const id of h.sim.players.keys()) {
74
+ const out = Object.create(null);
75
+ for (const shrouded of hidden?.keys() ?? []) {
76
+ if (worn.has(shrouded) && !hidden.get(id)?.has(shrouded)) { out[shrouded] = [...worn.get(shrouded)]; }
77
+ }
78
+ const json = JSON.stringify(out);
79
+ if ((h.sentHoldShowMe.get(id) ?? '{}') !== json) {
80
+ h.sentHoldShowMe.set(id, json);
81
+ h.holdShowAloneUsed = true;
82
+ h.session?.send(id, { k: 'hub-hold-show', hubHoldShow: out });
83
+ }
84
+ }
85
+ }
86
+ export function joinedAfresh(h, id) {
87
+ if (h.holdShowAloneUsed) { h.sentHoldShowMe.set(id, 'resend'); }
88
+ }
89
+ export function forget(h, id) {
90
+ h.holdShows.delete(id); h.holdShowOwners.delete(id);
91
+ h.holdShowWire.delete(id); h.holdShowAt.delete(id);
92
+ // A viewer still connected (an account change) keeps a latch that differs
93
+ // from every payload, so the private flowers it holds are cleared too.
94
+ if (h.sim?.players.has(id) && h.sentHoldShowMe.has(id)) { h.sentHoldShowMe.set(id, 'resend'); } else { h.sentHoldShowMe.delete(id); }
95
+ }
96
+ export function end(h) {
97
+ for (const map of [h.holdShows, h.holdShowOwners, h.holdShowWire, h.holdShowAt, h.sentHoldShowMe]) { map.clear(); }
98
+ }