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
@@ -34,8 +34,11 @@ export function newWearState() {
34
34
  // playerId -> JSON of what ghost last heard or said, so the same
35
35
  // wearable is not sent again
36
36
  wearSent: new Map(),
37
- // playerId -> JSON of the wearables last sent to that player alone
37
+ // playerId -> JSON of the wearables last sent to that player alone, or
38
+ // `RESEND` for a client that joined afresh and is to be told again
38
39
  sentWearMe: new Map(),
40
+ // whether any player was ever sent wearables alone (`hub-wear`)
41
+ wearAloneUsed: false,
39
42
  // playerId -> the wearable this place shows on them instead of their own
40
43
  // (v1.28 `hub.tryOn`); empty in a place that never calls it
41
44
  trying: new Map(),
@@ -182,7 +185,10 @@ function shownOf(h, worn, hidden) {
182
185
  // The wearables of players in a hidden pair, each to the players who may see
183
186
  // them, when they change. A session with no blocks sends nothing here.
184
187
  export function sendOverrides(h, hidden) {
185
- sendAlone(h, hidden, h.wearing, h.sentWearMe, (out) => ({ k: 'hub-wear', hubWear: out }));
188
+ sendAlone(h, hidden, h.wearing, h.sentWearMe, (out) => {
189
+ h.wearAloneUsed = true;
190
+ return { k: 'hub-wear', hubWear: out };
191
+ });
186
192
  }
187
193
 
188
194
  // The same for try-ons (v1.28, `hub-try`). Asked only once a place has
@@ -198,10 +204,14 @@ export function sendTryOverrides(h, hidden) {
198
204
  // a reloaded page that resumed its player id). What it holds of `hub-try` is
199
205
  // not known -- nothing, or a map from before it dropped out -- so it is sent
200
206
  // the map as it is now, empty or not, on the next tick it has a body. Only in
201
- // a place that has ever sent one: anywhere else no client holds any.
207
+ // a place that has ever sent one: anywhere else no client holds any. The same
208
+ // goes for `hub-wear`, the wearables of a hidden pair.
202
209
  const RESEND = 'resend';
203
210
 
204
211
  export function joinedAfresh(h, playerId) {
212
+ if (h.wearAloneUsed) {
213
+ h.sentWearMe.set(playerId, RESEND);
214
+ }
205
215
  if (h.tryAloneUsed) {
206
216
  h.sentTryMe.set(playerId, RESEND);
207
217
  }
@@ -0,0 +1,191 @@
1
+ // One account writer per place instance. The empty user target owns no game
2
+ // rows: ordinary deck saves stay compatible with their existing key families.
3
+ export const NOTICE = "You're playing somewhere else, so progress here isn't saved.";
4
+ export const KEEP_MS = 60000;
5
+ // How long a claim may keep failing before the account stops saving here.
6
+ export const CLAIM_WAIT_MS = 20000;
7
+ const operationId = () => `writer-${Date.now()}-${Math.random().toString(36).slice(2)}`;
8
+ const lostError = () => Object.assign(new Error(NOTICE), { code: 'CAULDRON_STORAGE_WRITER_LOST', retryable: false, committed: false });
9
+ const invalid = (error) => /(?:WRITER_LOST|STALE_ACCESS|STALE_RESET_GENERATION)$/.test(error?.code ?? '');
10
+ const transient = (error) => error?.retryable === true || error?.committed === 'unknown' ||
11
+ (!error?.code && error?.retryable !== false) || /(?:NETWORK|TIMEOUT|RATE_LIMITED)$/.test(error?.code ?? '');
12
+ // The platform has no save API here at all (an older host, unsupported storage):
13
+ // nobody can hold a lease, so saves go on as they did before it.
14
+ const missing = (error) => /(?:UNKNOWN_COMMAND|UNAVAILABLE)$/.test(error?.code ?? '') && error?.committed === false && error?.retryable !== true;
15
+
16
+ export function create(session, optedIn) {
17
+ const storage = session?.storage;
18
+ const enabled = optedIn === true && typeof storage?.claim === 'function' && typeof storage?.transaction === 'function';
19
+ const accounts = new Map();
20
+ const visits = new Map();
21
+ const listeners = new Set();
22
+ const views = new Map();
23
+ let closed = false;
24
+ let syncing = false;
25
+ const active = (entry) => !closed && accounts.get(entry.userId) === entry;
26
+ const markLost = (entry) => {
27
+ if (!active(entry) || entry.lost) { return; }
28
+ entry.lost = true;
29
+ for (const fn of listeners) {
30
+ try { fn(entry.userId); } catch (error) { console.warn(`[hub] saves onLost failed: ${error?.message ?? error}`); }
31
+ }
32
+ };
33
+ const cancel = (entry) => {
34
+ clearTimeout(entry.expiry);
35
+ clearTimeout(entry.timer);
36
+ entry.wake?.();
37
+ };
38
+ const open = (userId) => {
39
+ const entry = { userId, target: { scope: 'user', subject: userId, prefix: 'hub:writer:' }, tail: Promise.resolve(), lost: false };
40
+ accounts.set(userId, entry);
41
+ // Replaying this exact claim settles a lost reply; a new ID could steal
42
+ // ownership back from a player who has since opened another instance.
43
+ const input = { operationId: operationId(), target: entry.target, load: [] };
44
+ // Reads wait for the claim: a load before it could be overwritten by the
45
+ // instance that still holds the account. One that cannot claim stops saving.
46
+ entry.ready = (async () => {
47
+ const started = Date.now();
48
+ let tries = 0;
49
+ while (active(entry)) {
50
+ try {
51
+ const opened = await storage.claim(input);
52
+ if (!active(entry)) { return; }
53
+ entry.writer = opened.writer;
54
+ entry.access = opened.snapshot.access;
55
+ return;
56
+ } catch (error) {
57
+ if (!active(entry)) { return; }
58
+ if (missing(error)) {
59
+ console.warn(`[hub] writer lease unavailable (${error.code}); saving without it`);
60
+ entry.unleased = true;
61
+ return;
62
+ }
63
+ if (invalid(error) || !transient(error) || Date.now() - started >= CLAIM_WAIT_MS) {
64
+ console.warn(`[hub] writer lease not held (${error?.code ?? error?.message ?? error}); not saving this account here`);
65
+ markLost(entry);
66
+ return;
67
+ }
68
+ const delay = Math.max(error?.retryAfterMs ?? 0, Math.min(8000, 250 * 2 ** Math.min(tries++, 5)));
69
+ await new Promise((resolve) => {
70
+ entry.wake = resolve;
71
+ entry.timer = setTimeout(resolve, delay);
72
+ });
73
+ entry.wake = null;
74
+ }
75
+ }
76
+ })();
77
+ return entry;
78
+ };
79
+ const fenceEntry = (entry) => {
80
+ if (!entry || !active(entry) || entry.lost) { return Promise.reject(lostError()); }
81
+ if (entry.fencing) { return entry.fencing; }
82
+ entry.fencing = (async () => {
83
+ await entry.ready;
84
+ if (!active(entry) || entry.lost) { throw lostError(); }
85
+ if (entry.unleased) { return; }
86
+ try {
87
+ await storage.transaction({ operationId: operationId(), expectedAccess: entry.access,
88
+ checks: [{ target: entry.target, writer: entry.writer }], changes: [] });
89
+ } catch (error) {
90
+ if (invalid(error)) { markLost(entry); throw lostError(); }
91
+ throw error;
92
+ }
93
+ if (!active(entry) || entry.lost) { throw lostError(); }
94
+ })().finally(() => { entry.fencing = null; });
95
+ return entry.fencing;
96
+ };
97
+ const view = (raw, userId) => {
98
+ if (!enabled || !raw) { return raw; }
99
+ return new Proxy(raw, {
100
+ get(target, name) {
101
+ if (['get', 'list'].includes(name) && typeof target[name] === 'function') {
102
+ return async (...args) => { await api.ready(userId); return target[name](...args); };
103
+ }
104
+ if (['set', 'remove', 'increment', 'transaction', 'conditionalWrite'].includes(name) && typeof target[name] === 'function') {
105
+ return (...args) => {
106
+ const entry = accounts.get(userId);
107
+ if (!entry) { return Promise.reject(lostError()); }
108
+ const work = entry.tail.then(async () => { await fenceEntry(entry); return target[name](...args); });
109
+ entry.tail = work.catch(() => {});
110
+ return work;
111
+ };
112
+ }
113
+ return typeof target[name] === 'function' ? target[name].bind(target) : target[name];
114
+ },
115
+ });
116
+ };
117
+ const api = {
118
+ enabled,
119
+ deck(userId) {
120
+ if (!enabled) { return storage?.deck; }
121
+ if (!views.has(userId)) { views.set(userId, view(storage?.deck, userId)); }
122
+ return views.get(userId);
123
+ },
124
+ user(userId) {
125
+ return view(storage?.user?.(userId), userId);
126
+ },
127
+ ready(userId) { return enabled ? accounts.get(userId)?.ready ?? Promise.resolve() : Promise.resolve(); },
128
+ fence(userId) { return enabled ? fenceEntry(accounts.get(userId)) : Promise.resolve(); },
129
+ lost(userId) { return enabled && accounts.get(userId)?.lost === true; },
130
+ onLost(fn) { listeners.add(fn); return () => listeners.delete(fn); },
131
+ };
132
+ return {
133
+ api,
134
+ join(playerId, userId) {
135
+ if (!enabled || closed || typeof userId !== 'string' || visits.get(playerId) === userId) { return; }
136
+ this.leave(playerId);
137
+ // Retained stale visits must be finalized by sync before a fresh join.
138
+ if (!accounts.has(userId)) { open(userId); }
139
+ clearTimeout(accounts.get(userId).expiry);
140
+ visits.set(playerId, userId);
141
+ },
142
+ leave(playerId) {
143
+ const userId = visits.get(playerId);
144
+ visits.delete(playerId);
145
+ const entry = accounts.get(userId);
146
+ if (!entry || [...visits.values()].includes(userId)) { return; }
147
+ const drop = () => {
148
+ if (accounts.get(userId) !== entry) { return; }
149
+ accounts.delete(userId);
150
+ views.delete(userId);
151
+ cancel(entry);
152
+ };
153
+ // A lost account has no end save to keep, so a visit back claims afresh.
154
+ clearTimeout(entry.expiry);
155
+ if (entry.lost) { drop(); } else { entry.expiry = setTimeout(drop, KEEP_MS); }
156
+ },
157
+ // `held`: player ids whose authored state remains. A fresh replacement
158
+ // finalizes lost held visits through forgetHeld; otherwise keep them.
159
+ sync(players, held = [], forgetHeld) {
160
+ if (!enabled || closed || syncing) { return; }
161
+ const next = new Map(players), kept = new Set(held);
162
+ syncing = true;
163
+ try {
164
+ for (const [id, userId] of next) {
165
+ if (!forgetHeld || visits.has(id) || !api.lost(userId) ||
166
+ [...next].some(([otherId, otherUser]) => otherId !== id && otherUser === userId)) { continue; }
167
+ // Only a new connection with no connected account peer can replace
168
+ // stale held state. The kit's ordinary forget runs its leave hook
169
+ // before the lost entry is dropped and the new visit claims.
170
+ for (const [oldId, oldUser] of [...visits]) {
171
+ if (oldUser !== userId) { continue; }
172
+ if (kept.has(oldId)) { forgetHeld(oldId); }
173
+ this.leave(oldId);
174
+ }
175
+ }
176
+ // Otherwise joins first: a resume or a connected peer stays lost.
177
+ for (const [id, userId] of next) { this.join(id, userId); }
178
+ for (const [id, userId] of [...visits]) {
179
+ if (next.has(id) ? next.get(id) !== userId : !kept.has(id)) { this.leave(id); }
180
+ }
181
+ } finally {
182
+ syncing = false;
183
+ }
184
+ },
185
+ shutdown() {
186
+ closed = true;
187
+ for (const entry of accounts.values()) { cancel(entry); }
188
+ accounts.clear(); visits.clear(); views.clear(); listeners.clear();
189
+ },
190
+ };
191
+ }
@@ -22,7 +22,7 @@ export function interaction(actor, place, spawned = false) {
22
22
  if (Object.hasOwn(c, 'HubAct')) {
23
23
  return actProblem(c.HubAct) ? null : { ...c.HubAct, ...(spawned ? { id: actor.id } : {}), actor: actor.id, op: 'custom' };
24
24
  }
25
- if (c.HubSeat) {return { id: actor.id, actor: actor.id, verb: 'Sit', reach: 1.6, hold: false, op: 'sit' };}
25
+ if (c.HubSeat) {return { id: actor.id, actor: actor.id, verb: c.HubSeat.pose === 'lie' ? 'Lie down' : 'Sit', reach: 1.6, hold: false, op: 'sit' };}
26
26
  if (c.HubNpc) {
27
27
  const name = typeof c.HubNpc.name === 'string' && c.HubNpc.name ? c.HubNpc.name.slice(0, 40) : actor.id;
28
28
  const reach = c.HubNpc.talkRange > 0 ? Math.min(c.HubNpc.talkRange, 8) : 3.5;
@@ -7,3 +7,9 @@ export const EXPRESSION_EMOTES = {
7
7
  point: { emoji: '👉', ms: 2000 },
8
8
  };
9
9
  export const EMOTE_MOTIONS = ['wave', 'dance', 'cheer', 'bow', 'spin', ...Object.keys(EXPRESSION_EMOTES)];
10
+ // v1.174: kit emotes only a place plays (`hub.emote`), at any place with
11
+ // idle.emotes; never in a picker or wheel, and a client's own request for one
12
+ // is refused. A declared role emote of the same id keeps its own definition.
13
+ export const PLACE_EMOTES = {
14
+ yawn: { emoji: '🥱', ms: 3000 },
15
+ };
@@ -0,0 +1,37 @@
1
+ // Private replay trace, contract v1.163. Metres on input/output, cm on wire.
2
+ export const REPLAY_STEPS = [250, 500, 1000, 2000, 4000, 8000];
3
+ export function cleanTrace(trace) {
4
+ if (!trace || trace.v !== 1 || !REPLAY_STEPS.includes(trace.step) ||
5
+ !Number.isSafeInteger(trace.ms) || trace.ms <= 0 || trace.ms > 600000 ||
6
+ !Array.isArray(trace.poses) || trace.poses.length % 4 || trace.poses.length < 8 || trace.poses.length > 768 ||
7
+ Object.keys(trace).some(k => !['v', 'step', 'ms', 'poses'].includes(k))) {return null;}
8
+ const count = trace.poses.length / 4;
9
+ // The last pose is sampled at stop, possibly before the next regular tick.
10
+ if (Math.abs(trace.ms - (count - 1) * trace.step) > trace.step) {return null;}
11
+ for (let i = 0; i < trace.poses.length; i++) {
12
+ const n = trace.poses[i];
13
+ if (!Number.isSafeInteger(n) || (i % 4 === 3 ? n < -180 || n >= 180 : Math.abs(n) > 100000)) {return null;}
14
+ }
15
+ return { v: 1, step: trace.step, ms: trace.ms, poses: [...trace.poses] };
16
+ }
17
+
18
+ export function sampleTrace(trace, tMs) {
19
+ const n = trace.poses.length / 4, t = Math.max(0, Math.min(trace.ms, tMs));
20
+ if (t >= trace.ms) {
21
+ const at = (n - 1) * 4, p = trace.poses;
22
+ return { x: p[at] / 100, y: p[at + 1] / 100, z: p[at + 2] / 100, yaw: p[at + 3] };
23
+ }
24
+ // All but the final sample lie on the step grid. The final interval can
25
+ // be shorter; hit the actual final pose exactly at ms, without a jump.
26
+ const i = Math.min(n - 2, Math.floor(t / trace.step));
27
+ const end = i === n - 2 ? trace.ms : (i + 1) * trace.step;
28
+ const f = Math.max(0, Math.min(1, (t - i * trace.step) / Math.max(1, end - i * trace.step)));
29
+ const at = i * 4, next = at + 4, p = trace.poses;
30
+ const angle = ((p[next + 3] - p[at + 3] + 540) % 360) - 180;
31
+ return {
32
+ x: (p[at] + (p[next] - p[at]) * f) / 100,
33
+ y: (p[at + 1] + (p[next + 1] - p[at + 1]) * f) / 100,
34
+ z: (p[at + 2] + (p[next + 2] - p[at + 2]) * f) / 100,
35
+ yaw: ((p[at + 3] + angle * f + 540) % 360) - 180,
36
+ };
37
+ }