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,41 @@
1
+ // Shared Model clone ownership, contract v1.196.
2
+ import { Group } from 'three';
3
+ import { buildModelNode, parseModelCached } from '@imports/castle.physics-3d/engine3d/pxmodel';
4
+ import { copyModel, takeModel, releaseModel } from '@imports/castle.physics-3d/engine3d/optimize';
5
+
6
+ const buildsOf = new WeakMap();
7
+ export function tintPaint(text, color) {
8
+ if (!color) {return text;}
9
+ const data = JSON.parse(text);
10
+ const visit = (part) => {
11
+ if (!part || typeof part !== 'object') {return;}
12
+ if (part.id === 'paint' || part.name === 'paint' || part.material === 'paint') {part.color = color; part.materialColor = color;}
13
+ for (const child of part.parts ?? []) {visit(child);}
14
+ };
15
+ for (const part of data.parts ?? []) {visit(part);}
16
+ return JSON.stringify(data);
17
+ }
18
+ function disposeTree(root) {
19
+ const freed = new Set();
20
+ root.traverse(o => {
21
+ for (const v of [o.geometry, ...[o.material].flat()]) {
22
+ if (v && !freed.has(v)) {freed.add(v); v.dispose();}
23
+ }
24
+ });
25
+ }
26
+ export function modelLook(scene, look, color = null) {
27
+ const model = scene.getActor?.(look)?.components.Model;
28
+ const text = model && scene.files?.[model.file];
29
+ if (typeof text !== 'string' || !scene.three) {return null;}
30
+ const tinted = tintPaint(text, color), parsed = parseModelCached(tinted);
31
+ if (!parsed) {return null;}
32
+ let builds = buildsOf.get(scene.three);
33
+ if (!builds) {builds = new Map(); buildsOf.set(scene.three, builds);}
34
+ const key = `${model.file}:${tinted}`;
35
+ const template = takeModel(builds, key, () => buildModelNode(parsed, scene.sprites, scene.files, model.file, [model.file], { optimize: true }));
36
+ const group = new Group(), copy = copyModel(template);
37
+ copy.scale.setScalar(model.scale ?? 1);
38
+ copy.position.y = model.yOffset ?? 0;
39
+ group.add(copy);
40
+ return { group, release: () => {group.removeFromParent(); releaseModel(builds, key, disposeTree);} };
41
+ }
@@ -0,0 +1,152 @@
1
+ // The avatar picker surface: the Character button and its sheet
2
+ // (`pickerTree.js`) with the behaviour `chrome.js` gives them in the DOM
3
+ // (`showPicker`, `onAvatar`, `onColor`, `fitPicker`) -- the button toggles
4
+ // the sheet; a character shuts it and is worn (`onAvatar(i)`, the host's
5
+ // avatar.choose); a colour is worn and leaves it open (`onColor(c)`,
6
+ // avatar.chooseColor); Invite a friend shuts it and calls the offer's
7
+ // `onPick`; Close and Back shut it; the button going away shuts it; on its
8
+ // side, a phone with no room in the lane for the whole sheet gets the
9
+ // bottom strip -- published as the `picker` UI tree root. No DOM and no
10
+ // window. The web chrome does not use it.
11
+ //
12
+ // makeAvatarPickerSurface({ view, avatars, onAvatar, onColor, onOpen, draw }):
13
+ // view() the stage: { landscape, safeInsets, w, h, lift, insets:
14
+ // { top, right, bottom, left } } (CSS px);
15
+ // avatars how many characters (chrome.js's `avatarCount`);
16
+ // onAvatar(i) a character picked;
17
+ // onColor(c) a colour picked;
18
+ // onOpen(open) the sheet opened or shut: open, the host hides what the
19
+ // DOM's sheet covers (the round corner buttons, the Talk
20
+ // button, the toast) and shuts what they opened (the emote
21
+ // surface's `setHidden`, quick chat); with `compact()` also
22
+ // the dock and the Shift lock;
23
+ // draw(tree) called with each root built (only when it changed).
24
+ import { publishUiRoot } from './uiTree.js';
25
+ import { buildPicker, pickerBodyHeight, pickerCompact, pickerSwatches } from './pickerTree.js';
26
+
27
+ export function makeAvatarPickerSurface({ view = () => ({}), avatars = 0, onAvatar = () => {}, onColor = () => {}, onOpen = null, draw = null } = {}) {
28
+ let show = false;
29
+ let open = false;
30
+ let selected = null;
31
+ let swatches = null;
32
+ let invitePick = null;
33
+ // The host's laid-out height of picker/card/body, and the layout inputs it
34
+ // was measured under: it counts only while they hold (chrome.js measures
35
+ // again whenever a row or the view changes), else the estimate does. The
36
+ // strip has no body to report, so once anything changes under it the
37
+ // estimate decides whether the sheet now fits.
38
+ let measured = null; // { height, inputs }
39
+ let place = { toggle: null };
40
+ let key = '';
41
+ let disposed = false;
42
+
43
+ const setOpen = (value) => {
44
+ const next = Boolean(value) && show;
45
+ if (next === open) {return;}
46
+ open = next;
47
+ render();
48
+ onOpen?.(open);
49
+ };
50
+
51
+ const on = {
52
+ toggle: () => setOpen(!open),
53
+ close: () => setOpen(false),
54
+ avatar: (i) => {
55
+ if (!open) {return;}
56
+ setOpen(false);
57
+ onAvatar(i);
58
+ },
59
+ color: (c) => {
60
+ if (open) {onColor(c);}
61
+ },
62
+ invite: () => {
63
+ if (!open || !invitePick) {return;}
64
+ const pick = invitePick;
65
+ setOpen(false);
66
+ pick();
67
+ },
68
+ };
69
+
70
+ // Everything the sheet's height or room depends on.
71
+ const layoutInputs = (stage) => JSON.stringify([avatars, Boolean(invitePick), swatches, stage.w, stage.h, stage.landscape, stage.insets, stage.lift]);
72
+ const currentStage = () => {
73
+ const v = view() ?? {};
74
+ return {
75
+ landscape: Boolean(v.landscape), safeInsets: Boolean(v.safeInsets), w: Number(v.w) || 0, h: Number(v.h) || 0, lift: Number(v.lift) || 0,
76
+ insets: Object.fromEntries(['top', 'right', 'bottom', 'left'].map((side) => [side, Number(v.insets?.[side]) || 0])),
77
+ };
78
+ };
79
+
80
+ function state() {
81
+ const stage = currentStage();
82
+ const inputs = layoutInputs(stage);
83
+ const body = measured && measured.inputs === inputs ? measured.height : pickerBodyHeight({ avatars, swatches, invite: Boolean(invitePick) });
84
+ const { insets, ...shown } = stage;
85
+ return {
86
+ view: shown, show, open, compact: pickerCompact(stage, open, body),
87
+ selected, avatars, swatches, invite: Boolean(invitePick), place,
88
+ };
89
+ }
90
+
91
+ function render() {
92
+ if (disposed) {return;}
93
+ const s = state();
94
+ const next = JSON.stringify(s);
95
+ if (next === key) {return;}
96
+ key = next;
97
+ const tree = buildPicker(s, on);
98
+ publishUiRoot('picker', tree);
99
+ draw?.(tree);
100
+ }
101
+
102
+ render();
103
+ return {
104
+ // chrome `showPicker`: asked every frame. `show` the button is offered;
105
+ // `selected` the character worn; `colors` { available, style, color,
106
+ // files, model } (chrome.js's own); `invite` { onPick } or null.
107
+ set(nextShow, nextSelected, colors = null, invite = null) {
108
+ show = Boolean(nextShow);
109
+ selected = Number.isInteger(nextSelected) ? nextSelected : null;
110
+ invitePick = show ? invite?.onPick ?? null : null;
111
+ swatches = pickerSwatches(selected, colors ?? {});
112
+ if (!show && open) {
113
+ open = false;
114
+ render();
115
+ onOpen?.(false);
116
+ return;
117
+ }
118
+ render();
119
+ },
120
+ // A turned or resized stage, or a new Shift lock lift.
121
+ render,
122
+ // The host's laid-out height of `picker/card/body` (the open lane
123
+ // sheet's content, a report node), or null for the estimate: the strip
124
+ // is chosen where it would not fit (`fitPicker`'s measure). It holds
125
+ // only while the characters, Invite, the colours and the view are as
126
+ // they were when it was taken.
127
+ measure(height) {
128
+ measured = Number.isFinite(height) ? { height, inputs: layoutInputs(currentStage()) } : null;
129
+ render();
130
+ },
131
+ // The box the host's rail layout gave the Character button ({ x, y, w,
132
+ // h } CSS px), or null for the DOM's corner spot.
133
+ place(next = {}) {
134
+ place = { toggle: next.toggle ?? null };
135
+ render();
136
+ },
137
+ close() {
138
+ if (!open) {return false;}
139
+ setOpen(false);
140
+ return true;
141
+ },
142
+ isOpen: () => open,
143
+ // Whether the open sheet is the bottom strip (the host hides the dock
144
+ // and the Shift lock under it, as layPicker does).
145
+ compact: () => open && state().compact,
146
+ dispose() {
147
+ if (disposed) {return;}
148
+ disposed = true;
149
+ publishUiRoot('picker', null);
150
+ },
151
+ };
152
+ }
@@ -0,0 +1,163 @@
1
+ // The avatar picker (`chrome.js` `showPicker`) as a UI tree (schema v0): the
2
+ // Character button in the corner, and the sheet it opens -- the kit's
3
+ // characters four across, each its face (the `avatar-face-<n>` icon) and
4
+ // name, the one worn ringed in gold; the worn character's colours (a toon
5
+ // avatar with a palette, `avatarColors.js`); and, where the place offers it,
6
+ // "Invite a friend". Over the right-hand lane above the button, or, on a
7
+ // phone on its side with no room there for the whole sheet, one strip of
8
+ // whole tiles along the bottom with its own Close (`layPicker`'s compact
9
+ // strip). The same words, labels and states as the DOM. Pure: no DOM, no
10
+ // window; the web chrome still draws its own. The 3D preview and the
11
+ // Graphics row are not drawn (a native host passes neither).
12
+ //
13
+ // state = {
14
+ // view: { landscape, safeInsets, w, h, lift } (CSS px; `lift` the
15
+ // Shift lock's lift of the corner, 0 without one);
16
+ // show: the Character button is offered;
17
+ // open: the sheet is open;
18
+ // compact: the sheet is the bottom strip (`pickerCompact`);
19
+ // selected: the character worn (its index), or null;
20
+ // avatars: how many characters (chrome.js's `avatarCount`);
21
+ // swatches: null, or { colors: [6 css colours], worn } (`pickerSwatches`);
22
+ // invite: "Invite a friend" is offered;
23
+ // place: { toggle }: null (the DOM's corner spot) or the box
24
+ // { x, y, w, h } (CSS px) the host's rail layout gave the button;
25
+ // }
26
+ // on = { toggle(), close(), avatar(i), color(c), invite() }: the Character
27
+ // button, Close and Back, a character, a colour, Invite a friend.
28
+ import { h } from './uiTree.js';
29
+ import { AVATAR_FACES } from './avatarFaces.js';
30
+ import * as Colors from './avatarColors.js';
31
+
32
+ export const PICKER_COLUMNS = 4;
33
+ export const PICKER_CELL_PX = 64;
34
+ const ROOT = { font: 'ui', size: 15, weight: 600, lh: 1.3, color: '#fff' };
35
+ const LINE = 'rgba(255,255,255,0.4)';
36
+ const GOLD = '#f2c94c';
37
+ const TILE_BG = 'rgba(20,16,12,0.7)';
38
+ const edge = (safeInsets, px) => (safeInsets ? [px, 0] : px);
39
+ const finiteBox = (box) => Boolean(box) && ['x', 'y', 'w', 'h'].every((key) => Number.isFinite(box[key]));
40
+
41
+ // The strip's whole tiles across a view `w` wide, and its width.
42
+ export const stripTiles = (w) => Math.max(1, Math.floor((w - 26) / (PICKER_CELL_PX + 6)));
43
+ export const stripWidth = (w) => stripTiles(w) * (PICKER_CELL_PX + 6) - 6;
44
+
45
+ // chrome.js `showColors`, without the DOM: the swatches for the character
46
+ // worn, or null where it has none to offer (not a toon set, no palette, or
47
+ // no model file to read colour 0 from, as a native host's `files: null`).
48
+ export function pickerSwatches(selected, { available = false, style = 'toon', color = 0, files = null, model = null } = {}) {
49
+ const palette = Colors.AVATAR_COLORS[selected];
50
+ if (!available || style !== 'toon' || !palette) {return null;}
51
+ let original;
52
+ try {
53
+ const data = JSON.parse(files?.[model]);
54
+ original = data.parts?.find((part) => palette.main.includes(part.id))?.color;
55
+ } catch {
56
+ // A pack still loading has no original colour to show yet.
57
+ }
58
+ if (!original) {return null;}
59
+ const colors = [];
60
+ for (let c = 0; c < Colors.COLORS; c += 1) {colors.push(c === 0 ? original : palette.colors[c - 1][0]);}
61
+ return { colors, worn: Colors.known(selected, color) };
62
+ }
63
+
64
+ // The open lane sheet's content height (CSS px, inside its padding), from
65
+ // the sizes the DOM gives each row: the handle, Invite, the heading, the
66
+ // tiles in rows of four, the colours. A host's measured height wins.
67
+ export function pickerBodyHeight({ avatars = 0, swatches = null, invite = false } = {}) {
68
+ const rows = Math.ceil(Math.max(0, avatars) / PICKER_COLUMNS);
69
+ const parts = [12, invite ? 44 : null, 12 * 1.3, rows ? rows * 62 + (rows - 1) * 6 : 0, swatches ? 44 : null].filter((n) => n !== null);
70
+ return parts.reduce((sum, n) => sum + n, 0) + (parts.length - 1) * 6;
71
+ }
72
+ // The lane sheet's height cap at a view (inside its padding): what is left
73
+ // over the button and its margins, as the DOM's max-height.
74
+ export const pickerRoom = (view) => (Number(view?.h) || 0) - 80 - (Number(view?.lift) || 0)
75
+ - (Number(view?.insets?.top) || 0) - (Number(view?.insets?.bottom) || 0) - 32;
76
+ // chrome.js `fitPicker`: on its side, a phone under 300 px tall, or one whose
77
+ // open lane sheet would scroll (cutting its last row), takes the strip.
78
+ export const pickerCompact = (view, open, bodyHeight) => Boolean(view?.landscape)
79
+ && ((Number(view?.h) || 0) < 300 || (Boolean(open) && bodyHeight > pickerRoom(view) + 1));
80
+
81
+ const BUTTON = { minH: 44, pad: [8, 12], radius: 12, border: { w: 1, c: LINE }, bg: TILE_BG, color: '#fff' };
82
+
83
+ function tile(i, selected, on, strip) {
84
+ // A character this kit has no face for is a number, as all of them were.
85
+ const [name, face] = AVATAR_FACES[i] ?? [`Character ${i + 1}`, null];
86
+ const worn = i === selected;
87
+ return h('button', {
88
+ key: `a:${i}`, label: face ? `Character: ${name}` : name, pressed: worn,
89
+ style: {
90
+ w: PICKER_CELL_PX, minH: 62, box: 'border', pad: [4, 0, 3, 0], radius: 12, border: { w: 2, c: worn ? GOLD : LINE },
91
+ bg: worn ? 'rgba(242,201,76,0.22)' : TILE_BG, color: '#fff', font: 'ui', size: 11, weight: 600, lh: 1.2, clip: true,
92
+ ...(strip ? { flex: '0 0 auto' } : {}),
93
+ },
94
+ on: { tap: () => on.avatar?.(i) },
95
+ },
96
+ h('column', { key: 'cell', style: { align: 'center', justify: 'center', gap: 2, hit: 'none' } },
97
+ face ? h('icon', { key: 'face', name: `avatar-face-${i}`, style: { w: 36, h: 36, flex: '0 0 auto' } }) : null,
98
+ h('text', { key: 'name', text: face ? name : String(i + 1), style: { maxW: '100%', lines: 1, size: face ? 11 : 13 } })));
99
+ }
100
+
101
+ function colorRow(swatches, on) {
102
+ return h('row', { key: 'colors', style: { gap: 4, justify: 'center', flex: '0 0 auto' } },
103
+ swatches.colors.map((bg, c) => h('button', {
104
+ key: `c:${c}`, label: `Colour: ${c + 1}`, pressed: c === swatches.worn,
105
+ style: { w: 44, h: 44, box: 'border', pad: 6, radius: 22, border: { w: 2, c: c === swatches.worn ? GOLD : LINE }, bg, flex: '0 0 auto' },
106
+ on: { tap: () => on.color?.(c) },
107
+ })));
108
+ }
109
+
110
+ function toggleAt(view, box) {
111
+ if (finiteBox(box)) {return { anchor: 'topLeft', top: box.y, left: box.x };}
112
+ const lift = Number(view.lift) || 0;
113
+ return { anchor: 'bottomRight', right: edge(view.safeInsets, view.landscape ? 12 : 10), bottom: [10 + lift, lift] };
114
+ }
115
+
116
+ export function buildPicker(state, on = {}) {
117
+ const view = state.view ?? {};
118
+ const root = { key: 'picker', style: ROOT };
119
+ if (!state.show) {return h('stack', root);}
120
+ const open = Boolean(state.open);
121
+ const compact = open && Boolean(state.compact);
122
+ const lift = Number(view.lift) || 0;
123
+ const avatars = Math.max(0, Number(state.avatars) || 0);
124
+ const tiles = Array.from({ length: avatars }, (_, i) => tile(i, state.selected, on, compact));
125
+ const invite = state.invite ? h('button', { key: 'invite', style: { ...BUTTON, flex: compact ? 1 : '0 0 auto' }, on: { tap: on.invite } }, 'Invite a friend') : null;
126
+ const sheetStyle = { box: 'border', radius: 12, bg: 'card', shadow: 'card', hit: 'auto' };
127
+ let card = null;
128
+ if (open && compact) {
129
+ const width = stripWidth(Number(view.w) || 0);
130
+ card = h('column', {
131
+ key: 'card', report: true,
132
+ at: { anchor: 'bottom', bottom: [12, 0] },
133
+ style: { ...sheetStyle, w: width + 8, maxH: [{ dvh: 100, px: -24, safe: 'tb' }], pad: 4, gap: 2, clip: true },
134
+ },
135
+ // Close keeps the right-hand column with or without Invite beside it.
136
+ h('row', { key: 'head', style: { gap: 2 } },
137
+ invite ?? h('spacer', { key: 'invite', style: { flex: 1 } }),
138
+ h('button', { key: 'close', label: 'Close character sheet', style: { ...BUTTON, flex: '0 0 auto' }, on: { tap: on.close } }, 'Close')),
139
+ h('scroll', { key: 'tiles', axis: 'x', style: { w: width, gap: 6 } }, tiles),
140
+ state.swatches ? colorRow(state.swatches, on) : null);
141
+ } else if (open) {
142
+ card = h('scroll', {
143
+ key: 'card', axis: 'y',
144
+ at: { anchor: 'bottomRight', right: 10, bottom: [64 + lift, 64 + lift] },
145
+ style: { ...sheetStyle, maxW: [{ vw: 100, px: -20 }], maxH: [{ dvh: 100, px: -(80 + lift), safe: 'tb' }], pad: [8, 8, 24, 8] },
146
+ },
147
+ h('column', { key: 'body', report: true, style: { gap: 6, flex: '0 0 auto' } },
148
+ h('column', { key: 'handle', hub: 'picker-handle', style: { align: 'center', pad: [2, 0, 6, 0], hit: 'none' } },
149
+ h('spacer', { key: 'bar', style: { w: 32, h: 4, radius: 2, bg: 'rgba(255,255,255,0.5)' } })),
150
+ invite,
151
+ h('text', { key: 'heading', text: 'Your character', style: { size: 12, opacity: 0.8 } }),
152
+ h('grid', { key: 'tiles', cols: { n: PICKER_COLUMNS, px: PICKER_CELL_PX }, style: { gap: 6 } }, tiles),
153
+ state.swatches ? colorRow(state.swatches, on) : null));
154
+ }
155
+ return h('stack', { ...root, on: { cancel: open ? on.close : undefined } },
156
+ card,
157
+ h('button', {
158
+ key: 'toggle', fire: 'down',
159
+ at: toggleAt(view, state.place?.toggle),
160
+ style: { pad: [8, 14], radius: 18, border: { w: 1, c: LINE }, bg: 'chip', color: '#fff', ...(compact ? { hidden: true } : {}) },
161
+ on: { tap: on.toggle },
162
+ }, 'Character'));
163
+ }
@@ -1,6 +1,8 @@
1
1
  // Facts only. No preferences, promise cache or queue reconciliation lives here.
2
- export function reportPushVisit(net, place, mark, previous, now = Date.now(), timezone = () => Intl.DateTimeFormat().resolvedOptions().timeZone) {
3
- if (place?.push?.version !== 1) {return previous;}
2
+ // v1.204: `catching` (the server is reading this player's progress, and the
3
+ // place would refuse the report) defers it to the frame after.
4
+ export function reportPushVisit(net, place, mark, previous, now = Date.now(), timezone = () => Intl.DateTimeFormat().resolvedOptions().timeZone, catching = false) {
5
+ if (place?.push?.version !== 1 || catching) {return previous;}
4
6
  const self = net?.selfId?.(), userId = self && net.userId?.(self);
5
7
  if (!self || !/^[1-9]\d*$/.test(String(userId ?? ''))) {return previous;}
6
8
  if (previous?.net === net && previous.self === self && previous.userId === String(userId) &&