castle-web-cli 0.4.238 → 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 (404) 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 +218 -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 +22 -3
  16. package/dist/init.js +24 -2
  17. package/dist/multiplayerDoc.d.ts +1 -1
  18. package/dist/multiplayerDoc.js +9 -0
  19. package/dist/platformDoc.js +4 -2
  20. package/dist/playPagePolicy.d.ts +1 -0
  21. package/dist/playPagePolicy.js +12 -3
  22. package/dist/resetLeaderboards.d.ts +8 -1
  23. package/dist/resetLeaderboards.js +43 -8
  24. package/dist/roomLogs.d.ts +39 -0
  25. package/dist/roomLogs.js +166 -0
  26. package/dist/save-deck.d.ts +32 -2
  27. package/dist/save-deck.js +240 -39
  28. package/kits/base/CLAUDE.md +2 -1
  29. package/kits/base/castle.json +1 -1
  30. package/kits/base/sdk/README.md +240 -8
  31. package/kits/base/sdk/analytics.d.ts +8 -0
  32. package/kits/base/sdk/analytics.js +92 -0
  33. package/kits/base/sdk/castle.d.ts +8 -2
  34. package/kits/base/sdk/castle.js +3 -0
  35. package/kits/base/sdk/commands.d.ts +79 -0
  36. package/kits/base/sdk/commands.js +1 -0
  37. package/kits/base/sdk/debugConsole.d.ts +17 -0
  38. package/kits/base/sdk/debugConsole.js +154 -0
  39. package/kits/base/sdk/experiments.js +24 -1
  40. package/kits/base/sdk/hostRetry.d.ts +7 -0
  41. package/kits/base/sdk/hostRetry.js +57 -0
  42. package/kits/base/sdk/hub.d.ts +20 -2
  43. package/kits/base/sdk/hub.js +99 -13
  44. package/kits/base/sdk/multiplayer.d.ts +2 -0
  45. package/kits/base/sdk/multiplayer.js +198 -26
  46. package/kits/base/sdk/reconnectBudget.d.ts +6 -0
  47. package/kits/base/sdk/reconnectBudget.js +41 -1
  48. package/kits/base/sdk/rooms.d.ts +11 -0
  49. package/kits/base/sdk/rooms.js +22 -0
  50. package/kits/base/sdk/runtime.js +36 -19
  51. package/kits/base/sdk/server/hub.d.ts +19 -0
  52. package/kits/base/sdk/server/hub.js +12 -0
  53. package/kits/base/sdk/server/platformHandle.d.ts +1 -0
  54. package/kits/base/sdk/server/wrapper.d.ts +1 -1
  55. package/kits/base/sdk/server/wrapper.js +26 -1
  56. package/kits/base/sdk/store.d.ts +8 -2
  57. package/kits/base/sdk/store.js +5 -1
  58. package/kits/base/sdk/transport.d.ts +2 -1
  59. package/kits/base/sdk/transport.js +35 -0
  60. package/kits/hub-game/CLAUDE.md +66 -19
  61. package/kits/hub-game/castle.json +4 -4
  62. package/kits/hub-game/code/client/act.js +9 -6
  63. package/kits/hub-game/code/client/actCore.js +26 -6
  64. package/kits/hub-game/code/client/actGateLog.js +36 -0
  65. package/kits/hub-game/code/client/actionOverflow.js +29 -8
  66. package/kits/hub-game/code/client/actionRailSurface.js +186 -0
  67. package/kits/hub-game/code/client/actionRailTree.js +173 -0
  68. package/kits/hub-game/code/client/askSurface.js +85 -0
  69. package/kits/hub-game/code/client/askTree.js +51 -0
  70. package/kits/hub-game/code/client/attention.js +31 -6
  71. package/kits/hub-game/code/client/ballot.js +42 -5
  72. package/kits/hub-game/code/client/ballotSurface.js +115 -0
  73. package/kits/hub-game/code/client/ballotTree.js +180 -0
  74. package/kits/hub-game/code/client/catchingUp.js +19 -0
  75. package/kits/hub-game/code/client/celebrate.js +66 -0
  76. package/kits/hub-game/code/client/chrome.js +474 -53
  77. package/kits/hub-game/code/client/companion.js +93 -23
  78. package/kits/hub-game/code/client/companionDress.js +1 -1
  79. package/kits/hub-game/code/client/cornerSurface.js +106 -0
  80. package/kits/hub-game/code/client/cornerTree.js +83 -0
  81. package/kits/hub-game/code/client/decor.js +20 -11
  82. package/kits/hub-game/code/client/deviceStorage.js +121 -0
  83. package/kits/hub-game/code/client/disguise.js +23 -0
  84. package/kits/hub-game/code/client/disguiseDraw.js +87 -0
  85. package/kits/hub-game/code/client/dockSurface.js +206 -0
  86. package/kits/hub-game/code/client/dockTree.js +232 -0
  87. package/kits/hub-game/code/client/earned.js +29 -0
  88. package/kits/hub-game/code/client/emoteSurface.js +188 -0
  89. package/kits/hub-game/code/client/emoteTree.js +264 -0
  90. package/kits/hub-game/code/client/farAvatars.js +4 -3
  91. package/kits/hub-game/code/client/fpsTelemetry.js +3 -1
  92. package/kits/hub-game/code/client/grab.js +121 -50
  93. package/kits/hub-game/code/client/holdShow.js +19 -0
  94. package/kits/hub-game/code/client/hookLayer.js +96 -12
  95. package/kits/hub-game/code/client/hubControls.js +7 -1
  96. package/kits/hub-game/code/client/hudSurface.js +11 -3
  97. package/kits/hub-game/code/client/hudTree.js +7 -4
  98. package/kits/hub-game/code/client/idle.js +21 -3
  99. package/kits/hub-game/code/client/invites.js +24 -3
  100. package/kits/hub-game/code/client/keys.js +15 -0
  101. package/kits/hub-game/code/client/labelsNear.js +8 -1
  102. package/kits/hub-game/code/client/layoutCache.js +57 -8
  103. package/kits/hub-game/code/client/loadingCover.js +53 -4
  104. package/kits/hub-game/code/client/menuIcons.js +15 -0
  105. package/kits/hub-game/code/client/menuRows.js +8 -2
  106. package/kits/hub-game/code/client/menuSurface.js +102 -0
  107. package/kits/hub-game/code/client/menuTree.js +135 -0
  108. package/kits/hub-game/code/client/modelLook.js +41 -0
  109. package/kits/hub-game/code/client/pickerSurface.js +152 -0
  110. package/kits/hub-game/code/client/pickerTree.js +163 -0
  111. package/kits/hub-game/code/client/pushVisit.js +4 -2
  112. package/kits/hub-game/code/client/quality.js +188 -29
  113. package/kits/hub-game/code/client/qualityEntry.js +10 -1
  114. package/kits/hub-game/code/client/quickChatSurface.js +222 -0
  115. package/kits/hub-game/code/client/quickChatTree.js +201 -0
  116. package/kits/hub-game/code/client/rehello.js +75 -0
  117. package/kits/hub-game/code/client/renderVisibility.js +17 -0
  118. package/kits/hub-game/code/client/replay.js +118 -0
  119. package/kits/hub-game/code/client/role.js +3 -0
  120. package/kits/hub-game/code/client/safeLayout.js +441 -56
  121. package/kits/hub-game/code/client/safeStyle.js +13 -10
  122. package/kits/hub-game/code/client/say.js +2 -0
  123. package/kits/hub-game/code/client/soundSurface.js +77 -0
  124. package/kits/hub-game/code/client/soundTree.js +74 -0
  125. package/kits/hub-game/code/client/soundscape.js +12 -9
  126. package/kits/hub-game/code/client/soundscapeCues.js +1 -1
  127. package/kits/hub-game/code/client/state.js +67 -1
  128. package/kits/hub-game/code/client/stuckSurface.js +76 -0
  129. package/kits/hub-game/code/client/stuckTree.js +67 -0
  130. package/kits/hub-game/code/client/talk.js +42 -12
  131. package/kits/hub-game/code/client/talkTree.js +4 -2
  132. package/kits/hub-game/code/client/textAskSurface.js +147 -0
  133. package/kits/hub-game/code/client/textAskTree.js +67 -0
  134. package/kits/hub-game/code/client/tiers.js +252 -27
  135. package/kits/hub-game/code/client/together.js +4 -1
  136. package/kits/hub-game/code/client/uiDom.js +86 -8
  137. package/kits/hub-game/code/client/uiTree.js +33 -4
  138. package/kits/hub-game/code/client/vehicle.js +75 -52
  139. package/kits/hub-game/code/client/weakestTier.js +75 -31
  140. package/kits/hub-game/code/client/wear.js +159 -5
  141. package/kits/hub-game/code/client/worldLabels.js +215 -26
  142. package/kits/hub-game/code/companionSpec.js +4 -2
  143. package/kits/hub-game/code/server/act.js +3 -0
  144. package/kits/hub-game/code/server/actGate.js +83 -0
  145. package/kits/hub-game/code/server/actions.js +71 -15
  146. package/kits/hub-game/code/server/actors.js +20 -5
  147. package/kits/hub-game/code/server/analytics.js +40 -15
  148. package/kits/hub-game/code/server/ask.js +39 -3
  149. package/kits/hub-game/code/server/ballot.js +167 -4
  150. package/kits/hub-game/code/server/celebrate.js +64 -0
  151. package/kits/hub-game/code/server/companion.js +17 -2
  152. package/kits/hub-game/code/server/decor.js +11 -2
  153. package/kits/hub-game/code/server/disguise.js +63 -0
  154. package/kits/hub-game/code/server/doorAnalytics.js +2 -5
  155. package/kits/hub-game/code/server/earned.js +6 -2
  156. package/kits/hub-game/code/server/friendBests.js +13 -4
  157. package/kits/hub-game/code/server/friendsAmong.js +67 -8
  158. package/kits/hub-game/code/server/grab.js +12 -2
  159. package/kits/hub-game/code/server/heldOffers.js +142 -0
  160. package/kits/hub-game/code/server/holdShow.js +98 -0
  161. package/kits/hub-game/code/server/hub.js +854 -45
  162. package/kits/hub-game/code/server/idle.js +110 -9
  163. package/kits/hub-game/code/server/index.js +9 -0
  164. package/kits/hub-game/code/server/labels.js +13 -3
  165. package/kits/hub-game/code/server/loadAbandon.js +2 -5
  166. package/kits/hub-game/code/server/manifest.js +94 -6
  167. package/kits/hub-game/code/server/menu.js +26 -3
  168. package/kits/hub-game/code/server/npcs.js +55 -9
  169. package/kits/hub-game/code/server/observe.js +67 -6
  170. package/kits/hub-game/code/server/players.js +8 -1
  171. package/kits/hub-game/code/server/replay.js +135 -0
  172. package/kits/hub-game/code/server/storageLimit.js +4 -1
  173. package/kits/hub-game/code/server/townDay.js +74 -0
  174. package/kits/hub-game/code/server/trackQueue.js +29 -0
  175. package/kits/hub-game/code/server/vehicle.js +3 -0
  176. package/kits/hub-game/code/server/vis.js +26 -4
  177. package/kits/hub-game/code/server/wallet.js +677 -0
  178. package/kits/hub-game/code/server/wear.js +13 -3
  179. package/kits/hub-game/code/server/writerLease.js +191 -0
  180. package/kits/hub-game/code/shared/act.js +1 -1
  181. package/kits/hub-game/code/shared/expression.js +6 -0
  182. package/kits/hub-game/code/shared/replay.js +37 -0
  183. package/kits/hub-game/code/systems/hub.js +437 -57
  184. package/kits/hub-game/docs/analytics.md +20 -3
  185. package/kits/hub-game/docs/contract.md +942 -99
  186. package/kits/hub-game/docs/home-pieces.md +5 -6
  187. package/kits/hub-game/docs/observed-progress.md +49 -1
  188. package/kits/hub-game/docs/vehicle-preset.md +23 -0
  189. package/kits/hub-game/index.html +1 -0
  190. package/kits/hub-game/models/hats/baker-cap.pxmodel +3 -3
  191. package/kits/hub-game/models/hats/bat-clip.pxmodel +3 -3
  192. package/kits/hub-game/models/hats/beekeeper.pxmodel +3 -3
  193. package/kits/hub-game/models/hats/cap.pxmodel +3 -3
  194. package/kits/hub-game/models/hats/captain.pxmodel +3 -3
  195. package/kits/hub-game/models/hats/chef-toque.pxmodel +3 -3
  196. package/kits/hub-game/models/hats/crooked-top.pxmodel +3 -3
  197. package/kits/hub-game/models/hats/delivery-cap.pxmodel +3 -3
  198. package/kits/hub-game/models/hats/fire-helmet.pxmodel +3 -3
  199. package/kits/hub-game/models/hats/flower-crown.pxmodel +3 -3
  200. package/kits/hub-game/models/hats/foam-crown.pxmodel +3 -3
  201. package/kits/hub-game/models/hats/hard-hat.pxmodel +3 -3
  202. package/kits/hub-game/models/hats/lantern.pxmodel +3 -3
  203. package/kits/hub-game/models/hats/laurel.pxmodel +3 -3
  204. package/kits/hub-game/models/hats/lighthouse.pxmodel +3 -3
  205. package/kits/hub-game/models/hats/nurse-cap.pxmodel +3 -3
  206. package/kits/hub-game/models/hats/police-cap.pxmodel +3 -3
  207. package/kits/hub-game/models/hats/sailor.pxmodel +3 -3
  208. package/kits/hub-game/models/hats/souwester.pxmodel +3 -3
  209. package/kits/hub-game/models/hats/straw.pxmodel +3 -3
  210. package/kits/hub-game/models/hats/sunflower.pxmodel +3 -3
  211. package/kits/hub-game/models/hats/sweatband.pxmodel +3 -3
  212. package/kits/hub-game/models/hats/teacher-beret.pxmodel +3 -3
  213. package/kits/hub-game/models/hats/witch.pxmodel +3 -3
  214. package/kits/hub-game/models/hold-show/daisy.pxmodel +231 -0
  215. package/kits/hub-game/models/hold-show/moonflower.pxmodel +171 -0
  216. package/kits/hub-game/models/hold-show/rose.pxmodel +191 -0
  217. package/kits/hub-game/models/hold-show/square/daisy.pxmodel +233 -0
  218. package/kits/hub-game/models/hold-show/square/moonflower.pxmodel +173 -0
  219. package/kits/hub-game/models/hold-show/square/rose.pxmodel +193 -0
  220. package/kits/hub-game/models/hold-show/square/sunflower.pxmodel +313 -0
  221. package/kits/hub-game/models/hold-show/square/tulip.pxmodel +133 -0
  222. package/kits/hub-game/models/hold-show/sunflower.pxmodel +311 -0
  223. package/kits/hub-game/models/hold-show/tulip.pxmodel +131 -0
  224. package/kits/hub-game/package-lock.json +3 -3
  225. package/kits/hub-game/package.json +4 -3
  226. package/kits/hub-game/scripts/fixtures/engine-models-stub.mjs +1 -0
  227. package/kits/hub-game/scripts/fixtures/hud-surface.json +12 -12
  228. package/kits/hub-game/scripts/fixtures/talk-surface.json +8 -8
  229. package/kits/hub-game/scripts/gen-hats.mjs +1 -1
  230. package/kits/hub-game/scripts/gen-hold-show.mjs +27 -0
  231. package/kits/hub-game/scripts/pack.mjs +89 -23
  232. package/kits/hub-game/scripts/test-act-client.mjs +5 -0
  233. package/kits/hub-game/scripts/test-act-core.mjs +32 -0
  234. package/kits/hub-game/scripts/test-act-gate.mjs +186 -0
  235. package/kits/hub-game/scripts/test-action-rail-crowded-dom.mjs +7 -1
  236. package/kits/hub-game/scripts/test-action-rail-default-dom.mjs +102 -0
  237. package/kits/hub-game/scripts/test-action-rail-never-silent-dom.mjs +50 -0
  238. package/kits/hub-game/scripts/test-action-rail-surface.mjs +368 -0
  239. package/kits/hub-game/scripts/test-action-rail-town-jobs-dom.mjs +118 -0
  240. package/kits/hub-game/scripts/test-actions-client.mjs +5 -3
  241. package/kits/hub-game/scripts/test-actions.mjs +24 -0
  242. package/kits/hub-game/scripts/test-actors.mjs +19 -0
  243. package/kits/hub-game/scripts/test-again-corner-dom.mjs +59 -0
  244. package/kits/hub-game/scripts/test-analytics.mjs +80 -1
  245. package/kits/hub-game/scripts/test-arrival-pose-server.mjs +25 -8
  246. package/kits/hub-game/scripts/test-ask-client.mjs +9 -0
  247. package/kits/hub-game/scripts/test-ask-surface.mjs +188 -0
  248. package/kits/hub-game/scripts/test-attention.mjs +43 -1
  249. package/kits/hub-game/scripts/test-ballot-sheet-dom.mjs +71 -0
  250. package/kits/hub-game/scripts/test-ballot-surface.mjs +276 -0
  251. package/kits/hub-game/scripts/test-ballot.mjs +420 -3
  252. package/kits/hub-game/scripts/test-ban-join.mjs +1 -1
  253. package/kits/hub-game/scripts/test-celebrate-client.mjs +62 -0
  254. package/kits/hub-game/scripts/test-celebrate.mjs +116 -0
  255. package/kits/hub-game/scripts/test-chat.mjs +73 -0
  256. package/kits/hub-game/scripts/test-companion-client.mjs +203 -21
  257. package/kits/hub-game/scripts/test-companion.mjs +110 -3
  258. package/kits/hub-game/scripts/test-control-layout-dom.mjs +57 -10
  259. package/kits/hub-game/scripts/test-corner-surface.mjs +268 -0
  260. package/kits/hub-game/scripts/test-decor-client.mjs +59 -3
  261. package/kits/hub-game/scripts/test-decor.mjs +27 -0
  262. package/kits/hub-game/scripts/test-device-class.mjs +4 -1
  263. package/kits/hub-game/scripts/test-disguise-client.mjs +281 -0
  264. package/kits/hub-game/scripts/test-disguise.mjs +176 -0
  265. package/kits/hub-game/scripts/test-dock-surface.mjs +404 -0
  266. package/kits/hub-game/scripts/test-door-analytics.mjs +1 -1
  267. package/kits/hub-game/scripts/test-door-stay-client.mjs +602 -0
  268. package/kits/hub-game/scripts/test-door-stay.mjs +613 -0
  269. package/kits/hub-game/scripts/test-earned-client.mjs +119 -0
  270. package/kits/hub-game/scripts/test-emote-surface.mjs +616 -0
  271. package/kits/hub-game/scripts/test-fps-telemetry.mjs +39 -4
  272. package/kits/hub-game/scripts/test-friend-bests.mjs +38 -12
  273. package/kits/hub-game/scripts/test-ghost-click-dom.mjs +75 -0
  274. package/kits/hub-game/scripts/test-grab-client.mjs +29 -2
  275. package/kits/hub-game/scripts/test-grab-orbit.mjs +260 -11
  276. package/kits/hub-game/scripts/test-grab.mjs +10 -1
  277. package/kits/hub-game/scripts/test-hats.mjs +28 -0
  278. package/kits/hub-game/scripts/test-held-offers.mjs +394 -0
  279. package/kits/hub-game/scripts/test-high-only.mjs +3 -3
  280. package/kits/hub-game/scripts/test-hold-show-client.mjs +175 -0
  281. package/kits/hub-game/scripts/test-hold-show.mjs +355 -0
  282. package/kits/hub-game/scripts/test-hub-controls.mjs +3 -1
  283. package/kits/hub-game/scripts/test-hub-idle.mjs +348 -0
  284. package/kits/hub-game/scripts/test-hub-leaving.mjs +21 -0
  285. package/kits/hub-game/scripts/test-hub-ops.mjs +147 -0
  286. package/kits/hub-game/scripts/test-hub-trip.mjs +260 -5
  287. package/kits/hub-game/scripts/test-hud-clear.mjs +83 -0
  288. package/kits/hub-game/scripts/test-hud-rate.mjs +2 -1
  289. package/kits/hub-game/scripts/test-idle.mjs +160 -0
  290. package/kits/hub-game/scripts/test-invites-client.mjs +53 -0
  291. package/kits/hub-game/scripts/test-labels.mjs +11 -0
  292. package/kits/hub-game/scripts/test-landscape-layout.mjs +20 -0
  293. package/kits/hub-game/scripts/test-load-abandon.mjs +2 -2
  294. package/kits/hub-game/scripts/test-loading-cover.mjs +67 -1
  295. package/kits/hub-game/scripts/test-manifest.mjs +27 -0
  296. package/kits/hub-game/scripts/test-menu-client.mjs +55 -6
  297. package/kits/hub-game/scripts/test-menu-surface.mjs +236 -0
  298. package/kits/hub-game/scripts/test-npcs.mjs +128 -0
  299. package/kits/hub-game/scripts/test-observed.mjs +171 -3
  300. package/kits/hub-game/scripts/test-pack.mjs +166 -0
  301. package/kits/hub-game/scripts/test-picker-surface.mjs +321 -0
  302. package/kits/hub-game/scripts/test-placeat-server.mjs +395 -0
  303. package/kits/hub-game/scripts/test-placement-cache.mjs +1 -1
  304. package/kits/hub-game/scripts/test-pointer-clear-dom.mjs +82 -0
  305. package/kits/hub-game/scripts/test-progress-reset.mjs +184 -6
  306. package/kits/hub-game/scripts/test-push-visit.mjs +9 -0
  307. package/kits/hub-game/scripts/test-quality.mjs +312 -9
  308. package/kits/hub-game/scripts/test-quick-chat-surface.mjs +511 -0
  309. package/kits/hub-game/scripts/test-rehello.mjs +237 -0
  310. package/kits/hub-game/scripts/test-rejoin-yaw.mjs +138 -0
  311. package/kits/hub-game/scripts/test-relations-among.mjs +13 -7
  312. package/kits/hub-game/scripts/test-relations-refresh.mjs +90 -2
  313. package/kits/hub-game/scripts/test-replay-client.mjs +110 -0
  314. package/kits/hub-game/scripts/test-replay.mjs +178 -0
  315. package/kits/hub-game/scripts/test-resume-held.mjs +13 -0
  316. package/kits/hub-game/scripts/test-resume-pose-server.mjs +43 -5
  317. package/kits/hub-game/scripts/test-resync.mjs +13 -0
  318. package/kits/hub-game/scripts/test-role-client.mjs +10 -3
  319. package/kits/hub-game/scripts/test-safe-act.mjs +233 -0
  320. package/kits/hub-game/scripts/test-safe-caption.mjs +364 -0
  321. package/kits/hub-game/scripts/test-safe-layout.mjs +79 -0
  322. package/kits/hub-game/scripts/test-safe-prompt.mjs +163 -0
  323. package/kits/hub-game/scripts/test-sound-surface.mjs +256 -0
  324. package/kits/hub-game/scripts/test-soundscape.mjs +85 -2
  325. package/kits/hub-game/scripts/test-stuck-surface.mjs +174 -0
  326. package/kits/hub-game/scripts/test-stuck.mjs +31 -0
  327. package/kits/hub-game/scripts/test-talk-surface.mjs +23 -6
  328. package/kits/hub-game/scripts/test-talk-walk-dom.mjs +123 -0
  329. package/kits/hub-game/scripts/test-text-ask-surface.mjs +273 -0
  330. package/kits/hub-game/scripts/test-tiers.mjs +453 -3
  331. package/kits/hub-game/scripts/test-toast-no-row-dom.mjs +71 -0
  332. package/kits/hub-game/scripts/test-together.mjs +11 -0
  333. package/kits/hub-game/scripts/test-town-day.mjs +90 -0
  334. package/kits/hub-game/scripts/test-track-queue.mjs +64 -0
  335. package/kits/hub-game/scripts/test-try-on.mjs +39 -0
  336. package/kits/hub-game/scripts/test-ui-dom-dom.mjs +49 -2
  337. package/kits/hub-game/scripts/test-ui-tree.mjs +28 -0
  338. package/kits/hub-game/scripts/test-vehicle-client.mjs +77 -1
  339. package/kits/hub-game/scripts/test-vis.mjs +145 -0
  340. package/kits/hub-game/scripts/test-wallet.mjs +650 -0
  341. package/kits/hub-game/scripts/test-weakest-tier.mjs +135 -1
  342. package/kits/hub-game/scripts/test-world-labels.mjs +380 -0
  343. package/kits/hub-game/scripts/test-writer-lease-server.mjs +234 -0
  344. package/kits/hub-game/scripts/test-writer-lease.mjs +281 -0
  345. package/kits/hub-game/scripts/writer-storage-fixture.mjs +37 -0
  346. package/kits/hub-game/tools/hubScene/export.mjs +6 -5
  347. package/kits/hub-game/tools/hubScene/hubdata.mjs +10 -0
  348. package/kits/hub-game/tools/hubScene/test/export-fixture.mjs +48 -2
  349. package/kits/hub-game/tools/hubScene/validate-manifest.mjs +21 -3
  350. package/kits/multiplayer-3d/castle.json +5 -5
  351. package/kits/multiplayer-3d/code/client/resumeGate.js +49 -2
  352. package/kits/multiplayer-3d/code/server/ownership.js +25 -6
  353. package/kits/multiplayer-3d/code/server/world.js +19 -4
  354. package/kits/multiplayer-3d/code/systems/multiplayer.js +67 -11
  355. package/kits/multiplayer-3d/package-lock.json +1 -1
  356. package/kits/multiplayer-3d/package.json +2 -1
  357. package/kits/multiplayer-3d/scripts/test-ground-half.mjs +56 -0
  358. package/kits/multiplayer-3d/scripts/test-join-watchdog.mjs +54 -3
  359. package/kits/multiplayer-3d/scripts/test-owned-moves.mjs +190 -0
  360. package/kits/multiplayer-3d/scripts/test-resume-gate.mjs +191 -5
  361. package/kits/multiplayer-3d/scripts/test-resync-reconnect.mjs +68 -0
  362. package/kits/physics-2d/castle.json +2 -2
  363. package/kits/physics-2d/engine/scene.js +10 -2
  364. package/kits/physics-3d/CLAUDE.md +14 -0
  365. package/kits/physics-3d/behaviors/Player.jsx +39 -3
  366. package/kits/physics-3d/castle.json +3 -3
  367. package/kits/physics-3d/docs/engine-model-cache.md +109 -0
  368. package/kits/physics-3d/docs/engine-player.md +76 -0
  369. package/kits/physics-3d/docs/engine-skip-work.md +16 -0
  370. package/kits/physics-3d/docs/pxmodel-format.md +5 -1
  371. package/kits/physics-3d/engine3d/gait.js +16 -8
  372. package/kits/physics-3d/engine3d/groundsize.js +23 -0
  373. package/kits/physics-3d/engine3d/kithooks.js +50 -0
  374. package/kits/physics-3d/engine3d/look.js +110 -17
  375. package/kits/physics-3d/engine3d/lookbake.js +19 -1
  376. package/kits/physics-3d/engine3d/materialpresets.js +3 -2
  377. package/kits/physics-3d/engine3d/modelcache.js +280 -0
  378. package/kits/physics-3d/engine3d/modelcachedigest.js +37 -0
  379. package/kits/physics-3d/engine3d/modelcachegate.js +69 -0
  380. package/kits/physics-3d/engine3d/modelrefs.js +13 -0
  381. package/kits/physics-3d/engine3d/optimize.js +20 -9
  382. package/kits/physics-3d/engine3d/playerRun.js +26 -1
  383. package/kits/physics-3d/engine3d/pxmodel.js +7 -3
  384. package/kits/physics-3d/engine3d/templatecache.js +722 -0
  385. package/kits/physics-3d/engine3d/world3d.js +211 -17
  386. package/kits/physics-3d/package-lock.json +1 -1
  387. package/kits/physics-3d/package.json +2 -1
  388. package/kits/physics-3d/play/behaviors/Player.js +43 -3
  389. package/kits/physics-3d/scripts/render.mjs +56 -8
  390. package/kits/physics-3d/scripts/template-cache-fixtures.mjs +37 -0
  391. package/kits/physics-3d/scripts/template-cache-v1-bytes.json +49 -0
  392. package/kits/physics-3d/scripts/test-gait.mjs +53 -9
  393. package/kits/physics-3d/scripts/test-ground-half.mjs +120 -0
  394. package/kits/physics-3d/scripts/test-model-cache.mjs +600 -0
  395. package/kits/physics-3d/scripts/test-orbit-shadow-fade.mjs +1 -0
  396. package/kits/physics-3d/scripts/test-sleeping-models.mjs +384 -0
  397. package/kits/physics-3d/scripts/test-template-cache-minified.mjs +106 -0
  398. package/kits/physics-3d/scripts/test-template-cache.mjs +519 -0
  399. package/kits/physics-3d/scripts/test-wall-slide.mjs +272 -0
  400. package/kits/physics-3d/systems/physics3d.js +51 -2
  401. package/kits/real-time/castle.json +2 -2
  402. package/kits/real-time/code/client/connection.js +3 -0
  403. package/package.json +2 -2
  404. package/vendor/three/examples/jsm/libs/fflate.module.js +2672 -0
@@ -17,12 +17,13 @@ const localUnlock = { id: 'local-badge', class: 'badge', shape: 'badge-round', n
17
17
 
18
18
  function boot({ hook = true, failOnce = false, platform = false, unsaved = false, onReset = null, resumePlace = false, unlocks = null } = {}) {
19
19
  globalThis.__hubTestActors = [{ id: 'player', components: { Player: {}, Transform: { x: 0, y: 1, z: 0 } } }];
20
- const sent = [], hooks = [], opens = [], platformReads = [], arrived = [];
20
+ const sent = [], hooks = [], opens = [], platformReads = [], arrived = [], messages = [];
21
21
  let ctx;
22
22
  let heldHook = null;
23
23
  const hooksForTest = {
24
24
  ready(hub) { ctx = hub; },
25
25
  arrive(hub, group) { arrived.push(group); },
26
+ message(hub, player, data) { messages.push(data.k); },
26
27
  ...(hook ? { progressReset(hub, id, generation, options) {
27
28
  hooks.push([id, generation, options]);
28
29
  onReset?.(id, generation);
@@ -45,7 +46,8 @@ function boot({ hook = true, failOnce = false, platform = false, unsaved = false
45
46
  server.sceneFor(session); server.ready(world);
46
47
  const hello = (id, more = {}) => server.message(session, { playerId: id }, { k: 'hub-hello', avatar: 0, party: 1, ...more });
47
48
  const tick = () => { world.timeMs += 50; server.place(world); server.step(world, []); };
48
- return { sent, hooks, opens, platformReads, arrived, hello, tick, session, world, ctx: () => ctx, snapshot: () => server.join(), hold: (d) => { heldHook = d; } };
49
+ const say = (id, data) => server.message(session, { playerId: id }, data);
50
+ return { sent, hooks, opens, platformReads, arrived, messages, hello, say, tick, session, world, ctx: () => ctx, snapshot: () => server.join(), hold: (d) => { heldHook = d; } };
49
51
  }
50
52
 
51
53
  // A local unsaved serve exposes the SDK method but its broker has no storage.
@@ -299,7 +301,8 @@ await flush();
299
301
  assert.equal(failed.ctx().progressPending(), true, 'equal-generation retry waits for a new reread');
300
302
  retryDone.resolve(); await retryRefresh;
301
303
  assert.equal(failed.ctx().progressPending(), false);
302
- assert.deepEqual(failed.hooks.filter(([, gen]) => gen === 2).map(([id]) => id), ['p1', 'p2', 'p1', 'p2']);
304
+ // v1.204: only the id whose hook failed runs it again; p2's succeeded.
305
+ assert.deepEqual(failed.hooks.filter(([, gen]) => gen === 2).map(([id]) => id), ['p1', 'p2', 'p1']);
303
306
 
304
307
  // Retrying a failed hook at the same marker does not repeat kit cleanup. A
305
308
  // post-reset platform read that already completed remains the current state.
@@ -494,10 +497,14 @@ try {
494
497
  const tabs = boot(); tabs.hello('p1'); tabs.hello('p2');
495
498
  tabs.opens[0].resolve({ generation: 2, resetGeneration: 2 }); await flush();
496
499
  assert.equal(tabs.hooks.length, 2, 'one tab confirms the reset for both connected ids');
497
- markerNow += 5000; tabs.tick();
498
- assert.equal(tabs.ctx().progressPending(), true, 'sibling hung read stays protected after account reset');
500
+ markerNow += 4999; tabs.tick();
501
+ assert.equal(tabs.ctx().progressPending(), true, 'sibling hung read stays protected after account reset until the bound');
502
+ markerNow += 1; tabs.tick();
503
+ assert.equal(tabs.ctx().progressPending(), false, 'a hung read on a known marker releases arrival at the same bound');
504
+ assert.equal(tabs.arrived.flat().length, 2);
499
505
  tabs.opens[1].reject(Error('sibling read failed')); await flush();
500
- assert.equal(tabs.ctx().progressPending(), true, 'sibling rejected read cannot re-enable unknown-marker bypass');
506
+ assert.equal(tabs.ctx().progressPending(), true, 'an arrived id stays protected by the account read failure');
507
+ assert.deepEqual(tabs.snapshot().held, [], 'no arrival hold returns while the read retries');
501
508
  markerNow += 5000; tabs.tick();
502
509
  tabs.opens[2].resolve({ generation: 2, resetGeneration: 2 }); await flush(); tabs.tick();
503
510
  assert.equal(tabs.ctx().progressPending(), false);
@@ -506,6 +513,148 @@ try {
506
513
  const warn = console.warn, warned = [];
507
514
  console.warn = (...args) => warned.push(args.join(' '));
508
515
  try {
516
+ // Every arrival hold path lets go at the same five seconds, one line
517
+ // each. (a) A known marker whose read never settles.
518
+ const known = boot(); known.hello('p1');
519
+ known.opens[0].resolve({ generation: 2, resetGeneration: 2 }); await flush(); known.tick();
520
+ assert.equal(known.arrived.length, 1);
521
+ known.hello('p2'); known.tick();
522
+ assert.equal(known.opens.length, 2, 'the second id reads a marker it already knows');
523
+ assert.deepEqual(known.snapshot().held, ['p2']);
524
+ markerNow += 4999; known.tick();
525
+ assert.deepEqual(known.snapshot().held, ['p2'], 'a read that settles in time holds as before');
526
+ assert.equal(warned.some((line) => line.startsWith('[hub] arrival hold released')), false);
527
+ markerNow += 1; known.tick();
528
+ assert.deepEqual(known.snapshot().held, []);
529
+ assert.equal(known.arrived.length, 2, 'a hung read on a known marker releases arrival at the bound');
530
+ assert.equal(warned.filter((line) => line === '[hub] arrival hold released after 5 s: progress-read').length, 1);
531
+ known.opens[1].resolve({ generation: 2, resetGeneration: 2 }); await flush(); known.tick();
532
+ assert.equal(known.ctx().progressPending(), false);
533
+ assert.equal(known.hooks.length, 1, 'the late read applies no duplicate reset');
534
+ // A read that fails after the release still protects the arrived player,
535
+ // alone on the account (the first id has gone).
536
+ const lone = boot(); lone.hello('p1');
537
+ lone.opens[0].resolve({ generation: 2, resetGeneration: 2 }); await flush(); lone.tick();
538
+ lone.session.players = lone.session.players.filter((p) => p.playerId !== 'p1');
539
+ lone.world.players.delete('p1'); lone.tick();
540
+ assert.equal(lone.ctx().players().some((p) => p.playerId === 'p1'), false);
541
+ lone.hello('p2'); lone.tick();
542
+ markerNow += 5000; lone.tick();
543
+ assert.equal(lone.arrived.length, 2);
544
+ assert.equal(lone.ctx().progressPending(), false, 'released at the bound');
545
+ lone.opens[1].reject(Error('read failed after the release')); await flush(); lone.tick();
546
+ assert.equal(lone.ctx().progressPending(), true, 'a failure found after arrival keeps its protection');
547
+ assert.deepEqual(lone.snapshot().held, [], 'and holds no arrival');
548
+
549
+ // (b) A reset hook that throws: the failure stays, nothing rereads before
550
+ // a new hello, and the hold still lets go at the bound.
551
+ const failing = boot({ failOnce: true }); failing.hello('p1');
552
+ failing.opens[0].resolve({ generation: 2, resetGeneration: 2 }); await flush(); failing.tick();
553
+ assert.equal(failing.hooks.length, 1);
554
+ assert.deepEqual(failing.snapshot().held, ['p1']);
555
+ markerNow += 4999; failing.tick();
556
+ assert.equal(failing.arrived.length, 0);
557
+ markerNow += 1; failing.tick();
558
+ assert.deepEqual(failing.snapshot().held, []);
559
+ assert.equal(failing.arrived.length, 1, 'a failed reset hook releases arrival at the bound');
560
+ assert.equal(warned.filter((line) => line === '[hub] arrival hold released after 5 s: progress-reset-failed').length, 1);
561
+ warned.length = 0;
562
+
563
+ // An arrived player's progress protection is logged on and off, with
564
+ // the messages it dropped; a quick successful reread stays quiet.
565
+ const guard = boot(); guard.hello('p1');
566
+ guard.opens[0].resolve({ generation: 1 }); await flush(); guard.tick();
567
+ assert.equal(guard.arrived.length, 1);
568
+ const protection = () => warned.filter((line) => line.startsWith('[hub] progress protection'));
569
+ const quiet = guard.ctx().refreshProgress('p1'); guard.opens[1].resolve({ generation: 1 }); await quiet; guard.tick();
570
+ assert.deepEqual(protection(), [], 'a quick successful reread logs nothing');
571
+ const failed = guard.ctx().refreshProgress('p1'); guard.opens[2].reject(Error('read failed')); await failed;
572
+ assert.deepEqual(protection(), ['[hub] progress protection on: p1 (user 101) progress-read-failed']);
573
+ guard.say('p1', { k: 'hub-menu-pick' }); guard.say('p1', { k: 'hub-act' });
574
+ markerNow += 5000; guard.tick();
575
+ assert.equal(guard.opens.length, 4, 'the failed read retries');
576
+ guard.opens[3].resolve({ generation: 1 }); await flush(); guard.tick();
577
+ assert.equal(guard.ctx().progressPending(), false);
578
+ assert.deepEqual(protection(), [
579
+ '[hub] progress protection on: p1 (user 101) progress-read-failed',
580
+ '[hub] progress protection off: p1 (user 101) progress-read-failed after 5000 ms, 2 dropped',
581
+ ]);
582
+ // v1.204: during it, what writes no progress is heard and the rest is
583
+ // refused; the client hears on at once and off at the end, and past 30 s
584
+ // one line says so while the refusal holds.
585
+ const wire = boot(); wire.hello('p1');
586
+ wire.opens[0].resolve({ generation: 1 }); await flush(); wire.tick();
587
+ const catching = () => wire.sent.filter(([id, msg]) => id === 'p1' && msg.k === 'hub-progress').map(([, msg]) => msg.catching);
588
+ const quietWire = wire.ctx().refreshProgress('p1');
589
+ assert.deepEqual(catching(), [true], 'on is sent at once, before any log threshold');
590
+ wire.opens[1].resolve({ generation: 1 }); await quietWire;
591
+ assert.deepEqual(catching(), [true, false], 'and off when the spell ends');
592
+ const failedWire = wire.ctx().refreshProgress('p1'); wire.opens[2].reject(Error('read failed')); await failedWire;
593
+ assert.deepEqual(catching(), [true, false, true]);
594
+ let from = wire.sent.length;
595
+ wire.say('p1', { k: 'hub-where', ids: [] });
596
+ assert.equal(wire.sent.slice(from).some(([id, msg]) => id === 'p1' && msg.k === 'hub-where'), true, 'a progress-free message is heard');
597
+ wire.say('p1', { k: 'hub-act', id: 'x', n: 1 }); wire.say('p1', { k: 'place-own' });
598
+ assert.deepEqual(wire.messages, [], "a progress-touching message and the place's own are refused");
599
+ markerNow += 5000; wire.tick();
600
+ markerNow += 24_999; wire.tick();
601
+ const past = () => warned.filter((line) => line.startsWith('[hub] progress protection past 30 s'));
602
+ assert.deepEqual(past(), []);
603
+ markerNow += 1; wire.tick(); wire.tick();
604
+ assert.deepEqual(past(), ['[hub] progress protection past 30 s: p1 (user 101) progress-read-failed'], 'logged once');
605
+ wire.say('p1', { k: 'place-own' });
606
+ assert.deepEqual(wire.messages, [], 'past the bound it still refuses');
607
+ wire.opens.at(-1).resolve({ generation: 1 }); await flush(); wire.tick();
608
+ assert.deepEqual(catching(), [true, false, true, false]);
609
+ assert.equal(protection().at(-1), '[hub] progress protection off: p1 (user 101) progress-read-failed after 30000 ms, 3 dropped');
610
+ wire.say('p1', { k: 'place-own' });
611
+ assert.deepEqual(wire.messages, ['place-own'], 'heard again once the read succeeds');
612
+ warned.length = 0;
613
+
614
+ // v1.204: a reset hook that threw is retried on the read's cadence, not
615
+ // only at a new hello, and its failure is logged once per hub.
616
+ const retry = boot({ failOnce: true }); retry.hello('p1');
617
+ retry.opens[0].resolve({ generation: 2, resetGeneration: 2 }); await flush(); retry.tick();
618
+ assert.equal(retry.hooks.length, 1);
619
+ markerNow += 4999; retry.tick();
620
+ assert.equal(retry.opens.length, 1);
621
+ markerNow += 1; retry.tick();
622
+ assert.equal(retry.opens.length, 2, 'the failed hook is reread at 5 s');
623
+ retry.opens[1].resolve({ generation: 2, resetGeneration: 2 }); await flush(); retry.tick();
624
+ assert.equal(retry.hooks.length, 2, 'and its hook runs again');
625
+ assert.equal(retry.ctx().progressPending(), false);
626
+ assert.equal(retry.ctx().progressGeneration('p1'), 2);
627
+ assert.equal(warned.filter((line) => line === '[hub] progress reset hook failed').length, 1);
628
+ // Two ids of one account, one hook failing: the retry reruns that id
629
+ // alone; the sibling whose hook succeeded is not reset again.
630
+ const pair = boot({ failOnce: true }); pair.hello('p1'); pair.hello('p2');
631
+ pair.opens[0].resolve({ generation: 2, resetGeneration: 2 }); await flush(); pair.tick();
632
+ assert.deepEqual(pair.hooks.map(([id]) => id), ['p1', 'p2']);
633
+ markerNow += 5000; pair.tick();
634
+ pair.opens.at(-1).resolve({ generation: 2, resetGeneration: 2 }); await flush(); pair.tick();
635
+ assert.deepEqual(pair.hooks.map(([id]) => id), ['p1', 'p2', 'p1']);
636
+ warned.length = 0;
637
+
638
+ // One that settles past the second before any tick still logs both lines.
639
+ const mark = protection().length;
640
+ const slow = guard.ctx().refreshProgress('p1');
641
+ markerNow += 1001; guard.opens[4].resolve({ generation: 1 }); await slow;
642
+ assert.deepEqual(protection().slice(mark), [
643
+ '[hub] progress protection on: p1 (user 101) progress-read',
644
+ '[hub] progress protection off: p1 (user 101) progress-read after 1001 ms, 0 dropped',
645
+ ]);
646
+ warned.length = 0;
647
+ // A hung reread is logged once it lasts a second, and a leave ends it.
648
+ const hungRead = guard.ctx().refreshProgress('p1'); void hungRead;
649
+ markerNow += 999; guard.tick();
650
+ assert.equal(protection().length, 0);
651
+ markerNow += 1; guard.tick();
652
+ assert.equal(protection().at(-1), '[hub] progress protection on: p1 (user 101) progress-read');
653
+ guard.session.players = guard.session.players.filter((p) => p.playerId !== 'p1');
654
+ guard.world.players.delete('p1'); guard.tick();
655
+ assert.equal(protection().at(-1), '[hub] progress protection off: p1 (user 101) progress-read after 1000 ms, 0 dropped (left)');
656
+ warned.length = 0;
657
+
509
658
  // Failed reads keep retrying, the gap doubling per player state to a
510
659
  // cap, logged when the gap changes and at most every five minutes.
511
660
  const backoff = boot(); backoff.hello('p1');
@@ -556,4 +705,33 @@ try {
556
705
  } finally {
557
706
  Date.now = realNow;
558
707
  }
708
+ // v1.195: resetFences gives one fence per account from the observed markers,
709
+ // and null while any is unknown, so a place never stamps a guessed zero.
710
+ {
711
+ const fences = boot();
712
+ fences.session.players[1].userId = '202';
713
+ assert.equal(fences.ctx().resetFences(['p1']), null, 'no read yet');
714
+ fences.hello('p1'); fences.hello('p2');
715
+ assert.equal(fences.ctx().resetFences(['p1']), null, 'read in flight');
716
+ fences.opens[0].resolve({ generation: 1 });
717
+ await flush();
718
+ assert.deepEqual(fences.ctx().resetFences(['p1']), [{ playerId: '101', resetGeneration: 0 }]);
719
+ assert.equal(fences.ctx().resetFences(['p1', 'p2']), null, 'one unknown account makes the pair unknown');
720
+ fences.opens[1].resolve({ generation: 4, resetGeneration: 3 });
721
+ await flush();
722
+ assert.deepEqual(fences.ctx().resetFences(['p1', 'p2']), [{ playerId: '101', resetGeneration: 0 }, { playerId: '202', resetGeneration: 3 }]);
723
+ const again = fences.ctx().refreshProgress('p1');
724
+ fences.opens.at(-1).resolve({ generation: 2, resetGeneration: 5 });
725
+ await again; await flush();
726
+ assert.deepEqual(fences.ctx().resetFences(['p2', 'p1']), [{ playerId: '202', resetGeneration: 3 }, { playerId: '101', resetGeneration: 5 }], 'a newer reset is stamped');
727
+ for (const bad of [[], ['p1', 'p2', 'p1'], 'p1', null, undefined, ['nobody'], ['p1', 'nobody']]) {
728
+ assert.equal(fences.ctx().resetFences(bad), null);
729
+ }
730
+ // Two ids of one account are one fence; a guest or anonymous player has none.
731
+ fences.session.players[1].userId = '101';
732
+ assert.deepEqual(fences.ctx().resetFences(['p1', 'p2']), [{ playerId: '101', resetGeneration: 5 }]);
733
+ fences.session.players[1].isAnonymous = true;
734
+ assert.equal(fences.ctx().resetFences(['p2']), null);
735
+ assert.equal(unsaved.ctx().resetFences(['p1']), null, 'an unsaved deck has no markers');
736
+ }
559
737
  console.log('hub progress reset: ok');
@@ -23,4 +23,13 @@ previous = reportPushVisit(net, place, Rehello.mark(mp, net), previous, 60501, z
23
23
  assert.equal(sent.length, 5, 'foreground heartbeat keeps the visit current');
24
24
  net.send = () => { throw Error('disconnected'); };
25
25
  assert.equal(reportPushVisit(net, place, Rehello.mark(mp, net), previous, 130000, zone), previous);
26
+ // v1.204: while the server reads the player's progress the report waits, and
27
+ // goes on the first frame after.
28
+ {
29
+ const waited = [], waitNet = { selfId: () => 'p1', userId: () => '42', send: (msg) => waited.push(msg) };
30
+ assert.equal(reportPushVisit(waitNet, place, Rehello.mark(mp, waitNet), null, 100, zone, true), null);
31
+ assert.deepEqual(waited, []);
32
+ assert.notEqual(reportPushVisit(waitNet, place, Rehello.mark(mp, waitNet), null, 116, zone, false), null);
33
+ assert.equal(waited.length, 1); assert.equal(waited[0].k, 'hub-push-visit');
34
+ }
26
35
  console.log('push visit: keyless silence, account change, retained socket and heartbeat passed');