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
@@ -0,0 +1,49 @@
1
+ {
2
+ "models/barrel.pxmodel": 50296,
3
+ "models/cart.pxmodel": 1778184,
4
+ "models/mixed.pxmodel": 56824,
5
+ "models/parts/axe.pxmodel": 117392,
6
+ "models/parts/backpack.pxmodel": 166872,
7
+ "models/parts/barrel.pxmodel": 1813976,
8
+ "models/parts/bedroll.pxmodel": 76528,
9
+ "models/parts/belt-pouch.pxmodel": 95400,
10
+ "models/parts/bolt.pxmodel": 16680,
11
+ "models/parts/bracer.pxmodel": 79992,
12
+ "models/parts/chain-span.pxmodel": 176136,
13
+ "models/parts/chimney.pxmodel": 99960,
14
+ "models/parts/crate.pxmodel": 1576104,
15
+ "models/parts/crystal.pxmodel": 48704,
16
+ "models/parts/door-arched.pxmodel": 86536,
17
+ "models/parts/engine-block.pxmodel": 164784,
18
+ "models/parts/exhaust-pipe.pxmodel": 111936,
19
+ "models/parts/fence-span.pxmodel": 120264,
20
+ "models/parts/fender.pxmodel": 96656,
21
+ "models/parts/headlight.pxmodel": 91656,
22
+ "models/parts/hood.pxmodel": 44904,
23
+ "models/parts/horned-helmet.pxmodel": 81040,
24
+ "models/parts/jerry-can.pxmodel": 1813912,
25
+ "models/parts/ladder.pxmodel": 155496,
26
+ "models/parts/lamp.pxmodel": 63296,
27
+ "models/parts/lantern.pxmodel": 167496,
28
+ "models/parts/leaf-cluster.pxmodel": null,
29
+ "models/parts/offroad-tire.pxmodel": 753664,
30
+ "models/parts/pauldron.pxmodel": 66144,
31
+ "models/parts/rivet.pxmodel": 13072,
32
+ "models/parts/rock.pxmodel": 571000,
33
+ "models/parts/roll-bar-light.pxmodel": 102688,
34
+ "models/parts/round-shield.pxmodel": 151320,
35
+ "models/parts/saddlebag.pxmodel": 158136,
36
+ "models/parts/spoked-wheel.pxmodel": 1682072,
37
+ "models/parts/staff.pxmodel": 99000,
38
+ "models/parts/stepping-stones.pxmodel": 167712,
39
+ "models/parts/stone-base.pxmodel": 205744,
40
+ "models/parts/sword.pxmodel": null,
41
+ "models/parts/window-lit.pxmodel": 129976,
42
+ "models/parts/wizard-hat.pxmodel": null,
43
+ "models/player.pxmodel": 58856,
44
+ "models/rock.pxmodel": 8000,
45
+ "models/templates/biped-stout.pxmodel": 220160,
46
+ "models/templates/biped-tall.pxmodel": 217560,
47
+ "models/templates/quadruped.pxmodel": 155448,
48
+ "models/tree.pxmodel": 114776
49
+ }
@@ -131,8 +131,8 @@ for (const [name, url, leg, amplitude, speed, options] of cases) {
131
131
  // survive a missing write. A 30 s/3 min resume cannot jump whole cycles.
132
132
  const beforeAmplitude = state.amplitudeScale ?? 1;
133
133
  frame(entry, DT, 30, DT);
134
- assert.ok(Math.abs(state.amplitudeScale - beforeAmplitude) <= (0.3 / amplitude) / 6 + 1e-12);
135
- assert.ok(state.gait.cadence <= 6);
134
+ assert.ok(Math.abs(state.amplitudeScale - beforeAmplitude) <= (0.4 / amplitude) / 6 + 1e-12);
135
+ assert.ok(state.gait.cadence <= 2.5 + 1e-12);
136
136
  assert.equal(state.gait.cap, 30);
137
137
  assert.ok(!Object.hasOwn(entry.node.userData, 'walkSpeedHint'));
138
138
  assert.ok(!Object.hasOwn(entry.node.userData, 'walkTimeHint'));
@@ -220,10 +220,13 @@ if (gait) {
220
220
  gait.setWalkGait('model');
221
221
 
222
222
  const hub = diagnostics.find((row) => row.model === 'avatar-0-hub6' && row.mode === 'model');
223
+ const hubFixed = diagnostics.find((row) => row.model === 'avatar-0-hub6' && row.mode === 'fixed');
223
224
  if (hub) {
224
- assert.ok(hub.cadence > 4.5 && hub.cadence < 6);
225
- assert.ok(Math.abs(hub.A - 1.1) < 1e-10);
226
- assert.ok(hub.footSlipRatio < 1e-10);
225
+ // Short legs cannot cover a hub run at 2.5 cycles a second: the swing is
226
+ // at its widest and the feet slip, but less than the fixed gait's do.
227
+ assert.ok(Math.abs(hub.cadence - 2.5) < 1e-10);
228
+ assert.ok(Math.abs(hub.A - 1.2) < 1e-10);
229
+ assert.ok(hub.footSpeedRatio > hubFixed.footSpeedRatio);
227
230
  }
228
231
 
229
232
  // Slow walks must cover their distance too: cadence uses the TARGET swing
@@ -242,9 +245,16 @@ if (gait) {
242
245
  const cadence = state.gait.cadence;
243
246
  const cycleFootSpeed = 4 * state.gait.length * Math.sin(effectiveAmplitude) * cadence;
244
247
  const footSpeedRatio = cycleFootSpeed / speed;
245
- assert.ok(Math.abs(footSpeedRatio - 1) <= 0.05,
246
- `${name} at ${speed} m/s: foot/ground ratio ${footSpeedRatio}`);
247
- assert.ok(cadence <= 6);
248
+ // Feet keep up wherever the widest swing allows 2.5 cycles a second;
249
+ // past that the cadence holds at the cap and the feet slip.
250
+ const reach = 4 * state.gait.length * Math.sin(baseAmplitude + 0.4) * 2.5;
251
+ if (speed <= reach) {
252
+ assert.ok(Math.abs(footSpeedRatio - 1) <= 0.05,
253
+ `${name} at ${speed} m/s: foot/ground ratio ${footSpeedRatio}`);
254
+ } else {
255
+ assert.ok(Math.abs(cadence - 2.5) < 1e-10 && footSpeedRatio < 1, `${name} at ${speed} m/s: cadence ${cadence}`);
256
+ }
257
+ assert.ok(cadence <= 2.5 + 1e-12);
248
258
  const result = { test: 'steady', model: name, mode: 'model', groundSpeed: speed,
249
259
  L: state.gait.length, cadence, A, effectiveAmplitude, cycleFootSpeed, footSpeedRatio };
250
260
  diagnostics.push(result);
@@ -254,13 +264,47 @@ if (gait) {
254
264
  }
255
265
  }
256
266
 
267
+ // Every wardrobe body at the town's 5.68 m/s run: no faster than 2.5
268
+ // cycles a second, and a torso bob no taller than the fixed gait's.
269
+ for (let body = 0; body < 16; body += 1) {
270
+ const url = new URL(`../../hub-game/models/avatar-${body}.pxmodel`, import.meta.url);
271
+ if (!fs.existsSync(url)) continue;
272
+ const bob = {};
273
+ for (const mode of ['fixed', 'model']) {
274
+ gait.setWalkGait(mode);
275
+ const entry = build(url, { rigScale: hubModel.scale ?? 1, yOffset: hubModel.yOffset ?? 0 });
276
+ const torso = entry.node.userData.modelParts.get('torso');
277
+ let low = Infinity;
278
+ let high = -Infinity;
279
+ for (let n = 0; n < 240; n += 1) {
280
+ entry.node.position.z += 5.68 * DT;
281
+ frame(entry, DT);
282
+ if (n >= 120) {
283
+ low = Math.min(low, torso.position.y);
284
+ high = Math.max(high, torso.position.y);
285
+ }
286
+ }
287
+ bob[mode] = high - low;
288
+ if (mode === 'model') {
289
+ assert.ok(entry.modelAnim.gait.cadence <= 2.5 + 1e-12, `avatar-${body}: cadence ${entry.modelAnim.gait.cadence}`);
290
+ assert.ok(bob.model < bob.fixed, `avatar-${body}: bob ${bob.model} vs fixed ${bob.fixed}`);
291
+ const result = { test: 'wardrobe', model: `avatar-${body}`, groundSpeed: 5.68,
292
+ L: entry.modelAnim.gait.length, cadence: entry.modelAnim.gait.cadence, bob: bob.model, fixedBob: bob.fixed };
293
+ diagnostics.push(result);
294
+ console.log('wardrobe', JSON.stringify(result));
295
+ }
296
+ }
297
+ }
298
+ gait.setWalkGait('model');
299
+
257
300
  // Network poses follow real time even when the engine caps its own step.
258
301
  // Exercise both animation passes and measure cadence from actual phase,
259
302
  // rather than the requested cadence stored in the gait diagnostics.
260
303
  for (const [name, url, leg, baseAmplitude] of models.slice(0, 2)) {
261
304
  const realDt = 1 / 18;
262
305
  const engineDt = 0.033;
263
- const speed = 4;
306
+ // Inside both models' reach at the 2.5 cycle cap, so the feet keep up.
307
+ const speed = 2;
264
308
  const entry = build(url);
265
309
  const capped = build(url);
266
310
  for (let n = 0; n < 90; n += 1) {
@@ -0,0 +1,120 @@
1
+ // `"ground": { "half": n }` (engine3d/groundsize.js) on the client: the drawn
2
+ // plane and its line grid become 2n wide and the physics system's ground
3
+ // collider n each way. Without the key the plane `addGround` made is not
4
+ // touched and the collider stays 100 m each way. rapier is a recording
5
+ // stand-in: this is about the sizes asked for, not the simulation.
6
+ import assert from 'node:assert/strict';
7
+ import { register } from 'node:module';
8
+ import * as THREE from 'three';
9
+
10
+ const stub = `
11
+ const any = () => new Proxy(function () {}, {
12
+ get: (t, k) => (k === 'then' ? undefined : k === Symbol.toPrimitive ? () => 0 : any()),
13
+ apply: () => any(),
14
+ construct: () => any(),
15
+ });
16
+ export const init = async () => {};
17
+ export const World = any();
18
+ export const EventQueue = any();
19
+ export const RigidBodyDesc = any();
20
+ export const ColliderDesc = new Proxy(any(), {
21
+ get: (t, k) => (k === 'cuboid' ? (...args) => { (globalThis.__cuboids ??= []).push(args); return any(); } : any()),
22
+ });
23
+ export const RigidBodyType = { Dynamic: 0, Fixed: 1, KinematicPositionBased: 2, KinematicVelocityBased: 3 };
24
+ export const ActiveEvents = any();
25
+ export const ActiveCollisionTypes = any();
26
+ export const Ray = any();
27
+ export const Quaternion = any();
28
+ export const Vector3 = any();
29
+ `;
30
+ const hooks = `
31
+ import { existsSync } from 'node:fs';
32
+ import { fileURLToPath } from 'node:url';
33
+ export async function resolve(specifier, context, next) {
34
+ const isRapier = specifier === '@dimforge/rapier3d-compat' ||
35
+ ((specifier.startsWith('.') || specifier.startsWith('file:')) &&
36
+ new URL(specifier, context.parentURL).href.endsWith('/kits/physics-3d/engine3d/rapier.js'));
37
+ const parent = context.parentURL ?? '';
38
+ if (isRapier) {
39
+ return { url: 'data:text/javascript,' + encodeURIComponent(${JSON.stringify(stub)}), shortCircuit: true };
40
+ }
41
+ if (specifier.startsWith('@imports/castle.physics-2d/')) {
42
+ specifier = parent.replace(/\\/kits\\/.*/, '/kits/physics-2d/') + specifier.slice(27);
43
+ }
44
+ if ((specifier.startsWith('.') || specifier.startsWith('file:')) && parent.includes('/kits/') && !/\\.(m?js|jsx|json)$/.test(specifier)) {
45
+ const base = new URL(specifier, parent).href;
46
+ for (const ext of ['.js', '.jsx']) if (existsSync(fileURLToPath(base + ext))) return next(base + ext, context);
47
+ }
48
+ return next(specifier, context);
49
+ }`;
50
+ register(`data:text/javascript,${encodeURIComponent(hooks)}`);
51
+ const { syncGround } = await import('../engine3d/world3d.js');
52
+ const { groundHalf, colliderHalf } = await import('../engine3d/groundsize.js');
53
+ const { Physics3DSystem } = await import('../systems/physics3d.js');
54
+
55
+ let checks = 0;
56
+ function equal(a, b, message) {
57
+ checks++;
58
+ assert.deepEqual(a, b, message);
59
+ }
60
+
61
+ // The rule a native engine follows too.
62
+ equal([undefined, null, {}, { half: '150' }, { half: NaN }, { half: Infinity }].map(groundHalf), [null, null, null, null, null, null], 'no usable half');
63
+ equal([{ half: 150 }, { half: 0 }, { half: -5 }, { half: 1e6 }, { half: 37.5 }].map(groundHalf), [150, 1, 1, 200, 37.5], 'half clamps to 1..200');
64
+ equal([undefined, { color: '#fff' }, { half: 150 }].map(colliderHalf), [100, 100, 150], 'collider falls back to 100');
65
+
66
+ // The world as makeWorld3D's addGround leaves it.
67
+ function makeWorld() {
68
+ const scene = new THREE.Scene();
69
+ const ground = new THREE.Mesh(new THREE.PlaneGeometry(60, 60), new THREE.MeshStandardMaterial());
70
+ const grid = new THREE.GridHelper(60, 60, 0x505050, 0x505050);
71
+ scene.add(ground, grid);
72
+ return { scene, ground, grid, renderer: { dispose() {} }, nodes: new Map(), syncDepth: 0, generation: 0 };
73
+ }
74
+ const width = (mesh) => mesh.geometry.parameters.width;
75
+ const gridSpan = (grid) => {
76
+ grid.geometry.computeBoundingBox();
77
+ const box = grid.geometry.boundingBox;
78
+ return [box.max.x - box.min.x, box.max.z - box.min.z, grid.geometry.attributes.position.count];
79
+ };
80
+
81
+ {
82
+ const world = makeWorld();
83
+ const plane = world.ground.geometry;
84
+ const lines = world.grid.geometry;
85
+ syncGround(world, { color: '#445566', tile: 4 });
86
+ equal(world.ground.geometry === plane && world.grid.geometry === lines, true, 'no half: the plane and grid are untouched');
87
+ syncGround(world, null);
88
+ equal(world.ground.geometry === plane && world.grid.geometry === lines, true, 'no ground setting: untouched');
89
+
90
+ syncGround(world, { half: 150 });
91
+ equal(width(world.ground), 300, 'half 150 draws a 300 m plane');
92
+ equal(gridSpan(world.grid), [300, 300, 2 * 2 * 301], 'and a 300 m grid of 1 m cells');
93
+ const wide = world.ground.geometry;
94
+ syncGround(world, { half: 150, color: '#123456' });
95
+ equal(world.ground.geometry, wide, 'a restyle at the same half keeps the plane');
96
+
97
+ syncGround(world, { half: 1e6 });
98
+ equal(width(world.ground), 400, 'half clamps to 200');
99
+ syncGround(world, { color: '#445566' });
100
+ equal(width(world.ground), 60, 'dropping the key goes back to 60 m');
101
+ equal(gridSpan(world.grid), [60, 60, 2 * 2 * 61]);
102
+ }
103
+
104
+ // The physics system's collider.
105
+ async function collider(ground) {
106
+ globalThis.__cuboids = [];
107
+ const system = new Physics3DSystem();
108
+ system.attach({});
109
+ await new Promise((resolve) => setTimeout(resolve, 0));
110
+ const scene = { data: ground === undefined ? {} : { ground }, actors: [], getActors: () => [], getActor: () => null };
111
+ system.afterBehaviors(scene, 1 / 60);
112
+ return globalThis.__cuboids;
113
+ }
114
+ equal(await collider(undefined), [[100, 0.5, 100]], 'no ground setting: 100 m each way');
115
+ equal(await collider({ color: '#fff' }), [[100, 0.5, 100]], 'no half: 100 m each way');
116
+ equal(await collider({ half: 150 }), [[150, 0.5, 150]], 'half 150: 150 m each way');
117
+ equal(await collider({ half: 500 }), [[200, 0.5, 200]], 'clamped to 200');
118
+ equal(await collider({ none: true, half: 150 }), [], 'none: no collider');
119
+
120
+ console.log(`ground half: ${checks} checks (plane, grid, collider; absent key untouched)`);