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
@@ -28,14 +28,13 @@ is no mirrored constant to update. Footprints are the house deck's decision.
28
28
  | `pet-walk-2` | furniture | none: the house pet at its Young stage, read by the town to draw it walking behind its keeper | the House (never offered in the decor tray) |
29
29
  | `pet-walk-3` | furniture | none: the house pet at its Grown stage, read by the town to draw it walking behind its keeper | the House (never offered in the decor tray) |
30
30
  | `pet-collar` | furniture | none: the house pet's Star collar, read by the town to draw it on the pet | the House (never offered in the decor tray) |
31
- | `yard` | deed | 14×4, behind the house | Willowbank Farm |
32
- | `kitchen` | deed | 6×7, beside the living room | Comet Post |
33
- | `upstairs` | deed | 8×7, over the living room | Ripple Boatyard |
31
+ | `yard` | deed | 14×4, in front of the living room (+z) | Willowbank Farm |
32
+ | `kitchen` | deed | 6×7, east of the living room (+x) | The Lucky Ladle (a first crew goal met) |
33
+ | `upstairs` | deed | 8×7, at y=3 over the living room | Windmill Works (all six toys sent) |
34
34
  | `pond` | deed | TBD by the house deck | Amberwake |
35
- | `attic` | deed | TBD by the house deck | TBD |
35
+ | `attic` | deed | 8×4, over the back half of upstairs | none: the House opens it for badges from 4 games (never declared by a game) |
36
36
 
37
- Deeds are owned now but the house builds no extra area until phase 2.1; a
38
- deed declared today is kept and takes effect then.
37
+ The house builds these rooms in phase 2.1, dormant until the House save turns it on.
39
38
 
40
39
  ## Claimed, not offered by the house
41
40
 
@@ -70,7 +70,8 @@ current body is reset.
70
70
  Let `d` be the horizontal displacement from `at` to this tick's body position.
71
71
 
72
72
  - **Allowance.** `allowance` is the scene's `Player.speed` (6 if unset) times the
73
- player's `hub.tune` speed factor, times a 1.25 tolerance.
73
+ player's `hub.tune` speed factor, times a 1.25 tolerance. A driver's (v1.165,
74
+ below) is their car's.
74
75
  - **One credit clock.** Elapsed time comes from a single monotonic clock `C`, the
75
76
  larger of the sim's total and the wall clock's total since observation started.
76
77
  A tick moves `C` by at most its own sim delta plus 1 s. The wall clock covers a
@@ -169,6 +170,45 @@ A **retained resume on the same body** is not a reset. Dwell did not advance whi
169
170
  the player was absent, and nothing restarts. This was Cedar v2's failure: a return
170
171
  must not restart a grace period.
171
172
 
173
+ ## Drivers and riders (v1.165)
174
+
175
+ A car (`hub.drive`, [the vehicle preset](vehicle-preset.md)) moves its driver
176
+ at up to `car.speed`, 2 to 16 m/s, and `setPose`'s clamp already follows
177
+ `max(car.speed, car.reverse)`. A walker's allowance would leave every car
178
+ step past the first few metres unfunded, so no car door could score.
179
+
180
+ - **A driver's allowance** is `max(car.speed, car.reverse) × 1.25`, the same
181
+ tolerance over the same number the clamp uses. `hub.tune` does not move it
182
+ while driving; the tune applies again on getting out, as the clamp's does.
183
+ The cap scales with it: `0.4 s × allowance + 0.3 m`, 6.3 m for a 12 m/s car.
184
+ - **Switching.** The pass that first sees a different driving state (getting
185
+ in, getting out, a respray to another speed or reverse) fills that tick's
186
+ credit at the **lower** of the old and the new allowance, because either may
187
+ have been in force for any part of the tick, and holds the credit to the new
188
+ cap at once. A walker's `hub.tune` change is not a driving-state change and
189
+ keeps v1.141's rule (its tick fills at the new allowance), so a place
190
+ without cars observes exactly as before. Getting in therefore carries at most the walker's credit
191
+ (3.3 m) into the car and buys nothing. It is not a reset: stations and
192
+ travel go on. Getting out (`hub.drive(id, null)`) places the driver beside
193
+ the car, which is a placement more than 5 cm away and so a reset, with the
194
+ walker's allowance from then.
195
+ - **Riders** keep the walker's allowance and never earn. The kit places a
196
+ rider on their seat every tick (`vehicle.js` `tick`), but a seat placement
197
+ within 5 cm of the observed spot is no reset (a slow car), so the pass
198
+ excludes riders explicitly: a rider's body is adopted as `at`, `ok` true,
199
+ with no step, no travel, no credit, and every station back to `unknown`.
200
+ A rider's `travel` stays 0 and they enter nothing however slowly the car
201
+ moves. After `hub.ride(id, null)` they walk from where they were put, like
202
+ any placement, from no credit.
203
+ - **The reach test** still uses the current allowance over the time since the
204
+ player last moved. After getting in, a stuffed jump may therefore be
205
+ adopted rather than rejected, but it is unfunded like any other: it earns
206
+ nothing and its distance is owed.
207
+
208
+ The invariant holds with the allowance in force tick by tick in place of the
209
+ constant one: the displacement since the last reset is at most the sum over
210
+ ticks of `allowance × elapsed`, plus the largest cap.
211
+
172
212
  ## Details the build settled
173
213
 
174
214
  The kit's `code/server/observe.js` implements this. Where the text above left room,
@@ -250,3 +290,11 @@ real `world`, `players.setPose` and the hub layer's `place` and `step`.
250
290
  and no travel is credited for the gap. A 1 s server stall, with sim time capped,
251
291
  followed by legitimate reports is admitted or resynced, never rejected.
252
292
  8. A place that never calls the API keeps no observation state.
293
+ 9. (v1.165) A driver's allowance is the car's: 12 m/s driving at 50, 100 and 200 ms
294
+ reports is funded throughout, earns its travel and enters; a tune leaves it alone;
295
+ `max(speed, reverse)` is taken. Stuffing past the car's cap never enters. Getting in
296
+ carries only the walker's credit, filled at the walker's rate for the switch tick.
297
+ Getting out is a reset back to the walker's allowance. A rider carried into a
298
+ station earns no travel, enters nothing, and reads `ok` in `step`, also in a
299
+ car moving at 0.5 m/s with 50 ms ticks. A walker's tune change keeps v1.141's
300
+ fill (a doubled tune with no credit funds 0.6 m in 50 ms).
@@ -101,6 +101,23 @@ against; the native engine checks its host against the same file.
101
101
  - The driver's movement clamp follows `car.speed` (the way `hub.tune`'s does);
102
102
  getting out puts the walk's back. A driver cannot be tuned while driving
103
103
  (`hub.tune` is kept and applies on getting out).
104
+ - **Observed progress (v1.165).** `hub.observed`'s allowance follows the car
105
+ too: `max(car.speed, car.reverse)` × 1.25 while driving, so a race door can
106
+ score laps from `hub.station` / `hub.dwell` at car speed. The tick a player
107
+ gets in is filled at the walker's rate and the credit kept to the new cap,
108
+ so getting in buys nothing; getting out is a placement and a reset. Riders
109
+ keep the walker's allowance and are excluded from earning while riding: no
110
+ travel and no station entry, however slowly the car moves
111
+ ([observed progress](observed-progress.md), Drivers and riders). A walker's
112
+ `hub.tune` change is no transition: places without cars are unchanged.
113
+ - **A placed driver's heading (v1.165 fix).** `hub.placeAt` / `hub.hold` of a
114
+ driver with a facing (a race grid, a reset onto the road) turns the car: the
115
+ client's own clamped pose row already carries the server's facing, and the
116
+ car takes it, from rest, when the clamp is a placement (the driver is held,
117
+ or it turns the car more than 20°, or moves it more than 1 m;
118
+ `code/client/vehicle.js` `placedHeading`, the row kept by `hookLayer.js`
119
+ `state` as `hub.selfClamp`). An ordinary refused move keeps the car's own
120
+ heading and speed. No wire field.
104
121
  - `hub.hold` of a driver stops the car (speed 0) and keeps them driving;
105
122
  `release` lets them drive on. A seat (`HubSeat`) cannot be taken while
106
123
  driving or riding.
@@ -126,6 +143,12 @@ despawns one when its driver gets in and spawns one where they get out.
126
143
  - `scripts/test-vehicle.mjs` (server): drive/ride validation and refusals,
127
144
  seat pinning math, clamp follows speed, get-out positions, leave/trip/end
128
145
  cleanup, retained reconnect keeps the car, `hubCars` deltas.
146
+ - `scripts/test-observed.mjs` (v1.165, real Rapier): a driver's allowance
147
+ and cap, the switch tick on getting in, getting out as a reset, and a
148
+ rider carried through a station earning nothing.
149
+ - `scripts/test-vehicle-client.mjs` (v1.165 fix): a held placement and a
150
+ reset with a facing set the heading from rest; a small refused move and a
151
+ stale clamp do not.
129
152
  - `scripts/test-vehicle-client.mjs`: drawing a car on a driver's node and a
130
153
  rider at its seat from the drawn pose; input ignored while riding; stuck
131
154
  wording.
@@ -2,6 +2,7 @@
2
2
  <html>
3
3
  <head>
4
4
  <meta name="viewport" content="width=device-width, initial-scale=1, user-scalable=no" />
5
+ <meta name="castle-display" content="layout=fill, orientation=landscape" />
5
6
  <meta name="color-scheme" content="dark" />
6
7
  <title>hub-game</title>
7
8
  <!-- Declare the dark scheme before the JS-imported CSS loads, so the frame
@@ -3,10 +3,10 @@
3
3
  "name": "baker-cap",
4
4
  "triangles": 900,
5
5
  "look": {
6
- "outline": 0.02,
6
+ "outline": 0.03,
7
7
  "outlineColor": "#241a2e",
8
- "rim": 0.3,
9
- "ao": 0.4
8
+ "rim": 0,
9
+ "ao": 0.12
10
10
  },
11
11
  "parts": [
12
12
  {
@@ -3,10 +3,10 @@
3
3
  "name": "bat-clip",
4
4
  "triangles": 900,
5
5
  "look": {
6
- "outline": 0.02,
6
+ "outline": 0.03,
7
7
  "outlineColor": "#241a2e",
8
- "rim": 0.3,
9
- "ao": 0.4
8
+ "rim": 0,
9
+ "ao": 0.12
10
10
  },
11
11
  "parts": [
12
12
  {
@@ -3,10 +3,10 @@
3
3
  "name": "beekeeper",
4
4
  "triangles": 900,
5
5
  "look": {
6
- "outline": 0.02,
6
+ "outline": 0.03,
7
7
  "outlineColor": "#241a2e",
8
- "rim": 0.3,
9
- "ao": 0.4
8
+ "rim": 0,
9
+ "ao": 0.12
10
10
  },
11
11
  "parts": [
12
12
  {
@@ -3,10 +3,10 @@
3
3
  "name": "cap",
4
4
  "triangles": 900,
5
5
  "look": {
6
- "outline": 0.02,
6
+ "outline": 0.03,
7
7
  "outlineColor": "#241a2e",
8
- "rim": 0.3,
9
- "ao": 0.4
8
+ "rim": 0,
9
+ "ao": 0.12
10
10
  },
11
11
  "parts": [
12
12
  {
@@ -3,10 +3,10 @@
3
3
  "name": "captain",
4
4
  "triangles": 900,
5
5
  "look": {
6
- "outline": 0.02,
6
+ "outline": 0.03,
7
7
  "outlineColor": "#241a2e",
8
- "rim": 0.3,
9
- "ao": 0.4
8
+ "rim": 0,
9
+ "ao": 0.12
10
10
  },
11
11
  "parts": [
12
12
  {
@@ -3,10 +3,10 @@
3
3
  "name": "chef-toque",
4
4
  "triangles": 900,
5
5
  "look": {
6
- "outline": 0.02,
6
+ "outline": 0.03,
7
7
  "outlineColor": "#241a2e",
8
- "rim": 0.3,
9
- "ao": 0.4
8
+ "rim": 0,
9
+ "ao": 0.12
10
10
  },
11
11
  "parts": [
12
12
  {
@@ -3,10 +3,10 @@
3
3
  "name": "crooked-top",
4
4
  "triangles": 900,
5
5
  "look": {
6
- "outline": 0.02,
6
+ "outline": 0.03,
7
7
  "outlineColor": "#241a2e",
8
- "rim": 0.3,
9
- "ao": 0.4
8
+ "rim": 0,
9
+ "ao": 0.12
10
10
  },
11
11
  "parts": [
12
12
  {
@@ -3,10 +3,10 @@
3
3
  "name": "delivery-cap",
4
4
  "triangles": 900,
5
5
  "look": {
6
- "outline": 0.02,
6
+ "outline": 0.03,
7
7
  "outlineColor": "#241a2e",
8
- "rim": 0.3,
9
- "ao": 0.4
8
+ "rim": 0,
9
+ "ao": 0.12
10
10
  },
11
11
  "parts": [
12
12
  {
@@ -3,10 +3,10 @@
3
3
  "name": "fire-helmet",
4
4
  "triangles": 900,
5
5
  "look": {
6
- "outline": 0.02,
6
+ "outline": 0.03,
7
7
  "outlineColor": "#241a2e",
8
- "rim": 0.3,
9
- "ao": 0.4
8
+ "rim": 0,
9
+ "ao": 0.12
10
10
  },
11
11
  "parts": [
12
12
  {
@@ -3,10 +3,10 @@
3
3
  "name": "flower-crown",
4
4
  "triangles": 900,
5
5
  "look": {
6
- "outline": 0.02,
6
+ "outline": 0.03,
7
7
  "outlineColor": "#241a2e",
8
- "rim": 0.3,
9
- "ao": 0.4
8
+ "rim": 0,
9
+ "ao": 0.12
10
10
  },
11
11
  "parts": [
12
12
  {
@@ -3,10 +3,10 @@
3
3
  "name": "foam-crown",
4
4
  "triangles": 900,
5
5
  "look": {
6
- "outline": 0.02,
6
+ "outline": 0.03,
7
7
  "outlineColor": "#241a2e",
8
- "rim": 0.3,
9
- "ao": 0.4
8
+ "rim": 0,
9
+ "ao": 0.12
10
10
  },
11
11
  "parts": [
12
12
  {
@@ -3,10 +3,10 @@
3
3
  "name": "hard-hat",
4
4
  "triangles": 900,
5
5
  "look": {
6
- "outline": 0.02,
6
+ "outline": 0.03,
7
7
  "outlineColor": "#241a2e",
8
- "rim": 0.3,
9
- "ao": 0.4
8
+ "rim": 0,
9
+ "ao": 0.12
10
10
  },
11
11
  "parts": [
12
12
  {
@@ -3,10 +3,10 @@
3
3
  "name": "lantern",
4
4
  "triangles": 900,
5
5
  "look": {
6
- "outline": 0.02,
6
+ "outline": 0.03,
7
7
  "outlineColor": "#241a2e",
8
- "rim": 0.3,
9
- "ao": 0.4
8
+ "rim": 0,
9
+ "ao": 0.12
10
10
  },
11
11
  "parts": [
12
12
  {
@@ -3,10 +3,10 @@
3
3
  "name": "laurel",
4
4
  "triangles": 900,
5
5
  "look": {
6
- "outline": 0.02,
6
+ "outline": 0.03,
7
7
  "outlineColor": "#241a2e",
8
- "rim": 0.3,
9
- "ao": 0.4
8
+ "rim": 0,
9
+ "ao": 0.12
10
10
  },
11
11
  "parts": [
12
12
  {
@@ -3,10 +3,10 @@
3
3
  "name": "lighthouse",
4
4
  "triangles": 900,
5
5
  "look": {
6
- "outline": 0.02,
6
+ "outline": 0.03,
7
7
  "outlineColor": "#241a2e",
8
- "rim": 0.3,
9
- "ao": 0.4
8
+ "rim": 0,
9
+ "ao": 0.12
10
10
  },
11
11
  "parts": [
12
12
  {
@@ -3,10 +3,10 @@
3
3
  "name": "nurse-cap",
4
4
  "triangles": 900,
5
5
  "look": {
6
- "outline": 0.02,
6
+ "outline": 0.03,
7
7
  "outlineColor": "#241a2e",
8
- "rim": 0.3,
9
- "ao": 0.4
8
+ "rim": 0,
9
+ "ao": 0.12
10
10
  },
11
11
  "parts": [
12
12
  {
@@ -3,10 +3,10 @@
3
3
  "name": "police-cap",
4
4
  "triangles": 900,
5
5
  "look": {
6
- "outline": 0.02,
6
+ "outline": 0.03,
7
7
  "outlineColor": "#241a2e",
8
- "rim": 0.3,
9
- "ao": 0.4
8
+ "rim": 0,
9
+ "ao": 0.12
10
10
  },
11
11
  "parts": [
12
12
  {
@@ -3,10 +3,10 @@
3
3
  "name": "sailor",
4
4
  "triangles": 900,
5
5
  "look": {
6
- "outline": 0.02,
6
+ "outline": 0.03,
7
7
  "outlineColor": "#241a2e",
8
- "rim": 0.3,
9
- "ao": 0.4
8
+ "rim": 0,
9
+ "ao": 0.12
10
10
  },
11
11
  "parts": [
12
12
  {
@@ -3,10 +3,10 @@
3
3
  "name": "souwester",
4
4
  "triangles": 900,
5
5
  "look": {
6
- "outline": 0.02,
6
+ "outline": 0.03,
7
7
  "outlineColor": "#241a2e",
8
- "rim": 0.3,
9
- "ao": 0.4
8
+ "rim": 0,
9
+ "ao": 0.12
10
10
  },
11
11
  "parts": [
12
12
  {
@@ -3,10 +3,10 @@
3
3
  "name": "straw",
4
4
  "triangles": 900,
5
5
  "look": {
6
- "outline": 0.02,
6
+ "outline": 0.03,
7
7
  "outlineColor": "#241a2e",
8
- "rim": 0.3,
9
- "ao": 0.4
8
+ "rim": 0,
9
+ "ao": 0.12
10
10
  },
11
11
  "parts": [
12
12
  {
@@ -3,10 +3,10 @@
3
3
  "name": "sunflower",
4
4
  "triangles": 900,
5
5
  "look": {
6
- "outline": 0.02,
6
+ "outline": 0.03,
7
7
  "outlineColor": "#241a2e",
8
- "rim": 0.3,
9
- "ao": 0.4
8
+ "rim": 0,
9
+ "ao": 0.12
10
10
  },
11
11
  "parts": [
12
12
  {
@@ -3,10 +3,10 @@
3
3
  "name": "sweatband",
4
4
  "triangles": 900,
5
5
  "look": {
6
- "outline": 0.02,
6
+ "outline": 0.03,
7
7
  "outlineColor": "#241a2e",
8
- "rim": 0.3,
9
- "ao": 0.4
8
+ "rim": 0,
9
+ "ao": 0.12
10
10
  },
11
11
  "parts": [
12
12
  {
@@ -3,10 +3,10 @@
3
3
  "name": "teacher-beret",
4
4
  "triangles": 900,
5
5
  "look": {
6
- "outline": 0.02,
6
+ "outline": 0.03,
7
7
  "outlineColor": "#241a2e",
8
- "rim": 0.3,
9
- "ao": 0.4
8
+ "rim": 0,
9
+ "ao": 0.12
10
10
  },
11
11
  "parts": [
12
12
  {
@@ -3,10 +3,10 @@
3
3
  "name": "witch",
4
4
  "triangles": 900,
5
5
  "look": {
6
- "outline": 0.02,
6
+ "outline": 0.03,
7
7
  "outlineColor": "#241a2e",
8
- "rim": 0.3,
9
- "ao": 0.4
8
+ "rim": 0,
9
+ "ao": 0.12
10
10
  },
11
11
  "parts": [
12
12
  {