castle-web-cli 0.4.239 → 0.4.240

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (386) hide show
  1. package/dist/agent.js +5 -1
  2. package/dist/api.d.ts +20 -0
  3. package/dist/api.js +57 -0
  4. package/dist/bundle.d.ts +38 -1
  5. package/dist/bundle.js +309 -13
  6. package/dist/castle-host/host.js +163 -11
  7. package/dist/castleJson.d.ts +10 -0
  8. package/dist/castleJson.js +46 -2
  9. package/dist/check.js +5 -2
  10. package/dist/devSessionServer.js +4 -1
  11. package/dist/devSessionStorage.d.ts +1 -0
  12. package/dist/devSessionStorage.js +32 -7
  13. package/dist/importOrder.d.ts +2 -0
  14. package/dist/importOrder.js +29 -0
  15. package/dist/index.js +6 -3
  16. package/dist/init.js +24 -2
  17. package/dist/platformDoc.js +2 -1
  18. package/dist/playPagePolicy.js +5 -1
  19. package/dist/resetLeaderboards.d.ts +8 -1
  20. package/dist/resetLeaderboards.js +43 -8
  21. package/dist/save-deck.d.ts +32 -2
  22. package/dist/save-deck.js +240 -39
  23. package/kits/base/CLAUDE.md +1 -1
  24. package/kits/base/castle.json +1 -1
  25. package/kits/base/sdk/README.md +174 -6
  26. package/kits/base/sdk/analytics.d.ts +8 -0
  27. package/kits/base/sdk/analytics.js +92 -0
  28. package/kits/base/sdk/castle.d.ts +5 -1
  29. package/kits/base/sdk/castle.js +2 -0
  30. package/kits/base/sdk/commands.d.ts +48 -0
  31. package/kits/base/sdk/commands.js +1 -0
  32. package/kits/base/sdk/debugConsole.d.ts +17 -0
  33. package/kits/base/sdk/debugConsole.js +154 -0
  34. package/kits/base/sdk/experiments.js +24 -1
  35. package/kits/base/sdk/hostRetry.d.ts +7 -0
  36. package/kits/base/sdk/hostRetry.js +57 -0
  37. package/kits/base/sdk/hub.d.ts +20 -2
  38. package/kits/base/sdk/hub.js +99 -13
  39. package/kits/base/sdk/multiplayer.d.ts +2 -0
  40. package/kits/base/sdk/multiplayer.js +168 -26
  41. package/kits/base/sdk/reconnectBudget.d.ts +6 -0
  42. package/kits/base/sdk/reconnectBudget.js +41 -1
  43. package/kits/base/sdk/runtime.js +36 -19
  44. package/kits/base/sdk/server/hub.d.ts +19 -0
  45. package/kits/base/sdk/server/hub.js +12 -0
  46. package/kits/base/sdk/server/platformHandle.d.ts +1 -0
  47. package/kits/base/sdk/server/wrapper.d.ts +1 -1
  48. package/kits/base/sdk/server/wrapper.js +26 -1
  49. package/kits/base/sdk/transport.d.ts +2 -1
  50. package/kits/base/sdk/transport.js +35 -0
  51. package/kits/hub-game/CLAUDE.md +66 -19
  52. package/kits/hub-game/code/client/act.js +9 -6
  53. package/kits/hub-game/code/client/actCore.js +26 -6
  54. package/kits/hub-game/code/client/actGateLog.js +36 -0
  55. package/kits/hub-game/code/client/actionOverflow.js +29 -8
  56. package/kits/hub-game/code/client/actionRailSurface.js +186 -0
  57. package/kits/hub-game/code/client/actionRailTree.js +173 -0
  58. package/kits/hub-game/code/client/askSurface.js +85 -0
  59. package/kits/hub-game/code/client/askTree.js +51 -0
  60. package/kits/hub-game/code/client/attention.js +31 -6
  61. package/kits/hub-game/code/client/ballot.js +42 -5
  62. package/kits/hub-game/code/client/ballotSurface.js +115 -0
  63. package/kits/hub-game/code/client/ballotTree.js +180 -0
  64. package/kits/hub-game/code/client/catchingUp.js +19 -0
  65. package/kits/hub-game/code/client/celebrate.js +66 -0
  66. package/kits/hub-game/code/client/chrome.js +473 -53
  67. package/kits/hub-game/code/client/companion.js +93 -23
  68. package/kits/hub-game/code/client/companionDress.js +1 -1
  69. package/kits/hub-game/code/client/cornerSurface.js +106 -0
  70. package/kits/hub-game/code/client/cornerTree.js +83 -0
  71. package/kits/hub-game/code/client/decor.js +20 -11
  72. package/kits/hub-game/code/client/deviceStorage.js +121 -0
  73. package/kits/hub-game/code/client/disguise.js +23 -0
  74. package/kits/hub-game/code/client/disguiseDraw.js +87 -0
  75. package/kits/hub-game/code/client/dockSurface.js +206 -0
  76. package/kits/hub-game/code/client/dockTree.js +232 -0
  77. package/kits/hub-game/code/client/earned.js +29 -0
  78. package/kits/hub-game/code/client/emoteSurface.js +188 -0
  79. package/kits/hub-game/code/client/emoteTree.js +264 -0
  80. package/kits/hub-game/code/client/farAvatars.js +4 -3
  81. package/kits/hub-game/code/client/fpsTelemetry.js +3 -1
  82. package/kits/hub-game/code/client/grab.js +121 -50
  83. package/kits/hub-game/code/client/holdShow.js +19 -0
  84. package/kits/hub-game/code/client/hookLayer.js +96 -12
  85. package/kits/hub-game/code/client/hubControls.js +7 -1
  86. package/kits/hub-game/code/client/hudSurface.js +11 -3
  87. package/kits/hub-game/code/client/hudTree.js +7 -4
  88. package/kits/hub-game/code/client/idle.js +21 -3
  89. package/kits/hub-game/code/client/invites.js +24 -3
  90. package/kits/hub-game/code/client/keys.js +15 -0
  91. package/kits/hub-game/code/client/labelsNear.js +8 -1
  92. package/kits/hub-game/code/client/layoutCache.js +57 -8
  93. package/kits/hub-game/code/client/loadingCover.js +53 -4
  94. package/kits/hub-game/code/client/menuIcons.js +15 -0
  95. package/kits/hub-game/code/client/menuSurface.js +102 -0
  96. package/kits/hub-game/code/client/menuTree.js +135 -0
  97. package/kits/hub-game/code/client/modelLook.js +41 -0
  98. package/kits/hub-game/code/client/pickerSurface.js +152 -0
  99. package/kits/hub-game/code/client/pickerTree.js +163 -0
  100. package/kits/hub-game/code/client/pushVisit.js +4 -2
  101. package/kits/hub-game/code/client/quality.js +188 -29
  102. package/kits/hub-game/code/client/qualityEntry.js +10 -1
  103. package/kits/hub-game/code/client/quickChatSurface.js +222 -0
  104. package/kits/hub-game/code/client/quickChatTree.js +201 -0
  105. package/kits/hub-game/code/client/rehello.js +75 -0
  106. package/kits/hub-game/code/client/renderVisibility.js +17 -0
  107. package/kits/hub-game/code/client/replay.js +118 -0
  108. package/kits/hub-game/code/client/role.js +3 -0
  109. package/kits/hub-game/code/client/safeLayout.js +441 -56
  110. package/kits/hub-game/code/client/safeStyle.js +13 -10
  111. package/kits/hub-game/code/client/say.js +2 -0
  112. package/kits/hub-game/code/client/soundSurface.js +77 -0
  113. package/kits/hub-game/code/client/soundTree.js +74 -0
  114. package/kits/hub-game/code/client/soundscape.js +12 -9
  115. package/kits/hub-game/code/client/soundscapeCues.js +1 -1
  116. package/kits/hub-game/code/client/state.js +67 -1
  117. package/kits/hub-game/code/client/stuckSurface.js +76 -0
  118. package/kits/hub-game/code/client/stuckTree.js +67 -0
  119. package/kits/hub-game/code/client/talk.js +42 -12
  120. package/kits/hub-game/code/client/talkTree.js +4 -2
  121. package/kits/hub-game/code/client/textAskSurface.js +147 -0
  122. package/kits/hub-game/code/client/textAskTree.js +67 -0
  123. package/kits/hub-game/code/client/tiers.js +252 -27
  124. package/kits/hub-game/code/client/together.js +4 -1
  125. package/kits/hub-game/code/client/uiDom.js +86 -8
  126. package/kits/hub-game/code/client/uiTree.js +33 -4
  127. package/kits/hub-game/code/client/vehicle.js +72 -51
  128. package/kits/hub-game/code/client/weakestTier.js +75 -31
  129. package/kits/hub-game/code/client/wear.js +159 -5
  130. package/kits/hub-game/code/client/worldLabels.js +205 -25
  131. package/kits/hub-game/code/companionSpec.js +4 -2
  132. package/kits/hub-game/code/server/act.js +3 -0
  133. package/kits/hub-game/code/server/actGate.js +83 -0
  134. package/kits/hub-game/code/server/actions.js +71 -15
  135. package/kits/hub-game/code/server/actors.js +20 -5
  136. package/kits/hub-game/code/server/analytics.js +35 -3
  137. package/kits/hub-game/code/server/ask.js +39 -3
  138. package/kits/hub-game/code/server/ballot.js +167 -4
  139. package/kits/hub-game/code/server/celebrate.js +64 -0
  140. package/kits/hub-game/code/server/companion.js +17 -2
  141. package/kits/hub-game/code/server/decor.js +11 -2
  142. package/kits/hub-game/code/server/disguise.js +63 -0
  143. package/kits/hub-game/code/server/earned.js +6 -2
  144. package/kits/hub-game/code/server/friendBests.js +13 -4
  145. package/kits/hub-game/code/server/friendsAmong.js +67 -8
  146. package/kits/hub-game/code/server/grab.js +12 -2
  147. package/kits/hub-game/code/server/heldOffers.js +142 -0
  148. package/kits/hub-game/code/server/holdShow.js +98 -0
  149. package/kits/hub-game/code/server/hub.js +851 -45
  150. package/kits/hub-game/code/server/idle.js +110 -9
  151. package/kits/hub-game/code/server/index.js +9 -0
  152. package/kits/hub-game/code/server/labels.js +13 -3
  153. package/kits/hub-game/code/server/manifest.js +94 -6
  154. package/kits/hub-game/code/server/menu.js +26 -3
  155. package/kits/hub-game/code/server/npcs.js +55 -9
  156. package/kits/hub-game/code/server/observe.js +67 -6
  157. package/kits/hub-game/code/server/players.js +8 -1
  158. package/kits/hub-game/code/server/replay.js +135 -0
  159. package/kits/hub-game/code/server/storageLimit.js +4 -1
  160. package/kits/hub-game/code/server/townDay.js +74 -0
  161. package/kits/hub-game/code/server/vehicle.js +3 -0
  162. package/kits/hub-game/code/server/vis.js +26 -4
  163. package/kits/hub-game/code/server/wallet.js +677 -0
  164. package/kits/hub-game/code/server/wear.js +13 -3
  165. package/kits/hub-game/code/server/writerLease.js +191 -0
  166. package/kits/hub-game/code/shared/act.js +1 -1
  167. package/kits/hub-game/code/shared/expression.js +6 -0
  168. package/kits/hub-game/code/shared/replay.js +37 -0
  169. package/kits/hub-game/code/systems/hub.js +427 -54
  170. package/kits/hub-game/docs/analytics.md +16 -2
  171. package/kits/hub-game/docs/contract.md +942 -99
  172. package/kits/hub-game/docs/home-pieces.md +5 -6
  173. package/kits/hub-game/docs/observed-progress.md +49 -1
  174. package/kits/hub-game/docs/vehicle-preset.md +23 -0
  175. package/kits/hub-game/index.html +1 -0
  176. package/kits/hub-game/models/hats/baker-cap.pxmodel +3 -3
  177. package/kits/hub-game/models/hats/bat-clip.pxmodel +3 -3
  178. package/kits/hub-game/models/hats/beekeeper.pxmodel +3 -3
  179. package/kits/hub-game/models/hats/cap.pxmodel +3 -3
  180. package/kits/hub-game/models/hats/captain.pxmodel +3 -3
  181. package/kits/hub-game/models/hats/chef-toque.pxmodel +3 -3
  182. package/kits/hub-game/models/hats/crooked-top.pxmodel +3 -3
  183. package/kits/hub-game/models/hats/delivery-cap.pxmodel +3 -3
  184. package/kits/hub-game/models/hats/fire-helmet.pxmodel +3 -3
  185. package/kits/hub-game/models/hats/flower-crown.pxmodel +3 -3
  186. package/kits/hub-game/models/hats/foam-crown.pxmodel +3 -3
  187. package/kits/hub-game/models/hats/hard-hat.pxmodel +3 -3
  188. package/kits/hub-game/models/hats/lantern.pxmodel +3 -3
  189. package/kits/hub-game/models/hats/laurel.pxmodel +3 -3
  190. package/kits/hub-game/models/hats/lighthouse.pxmodel +3 -3
  191. package/kits/hub-game/models/hats/nurse-cap.pxmodel +3 -3
  192. package/kits/hub-game/models/hats/police-cap.pxmodel +3 -3
  193. package/kits/hub-game/models/hats/sailor.pxmodel +3 -3
  194. package/kits/hub-game/models/hats/souwester.pxmodel +3 -3
  195. package/kits/hub-game/models/hats/straw.pxmodel +3 -3
  196. package/kits/hub-game/models/hats/sunflower.pxmodel +3 -3
  197. package/kits/hub-game/models/hats/sweatband.pxmodel +3 -3
  198. package/kits/hub-game/models/hats/teacher-beret.pxmodel +3 -3
  199. package/kits/hub-game/models/hats/witch.pxmodel +3 -3
  200. package/kits/hub-game/models/hold-show/daisy.pxmodel +231 -0
  201. package/kits/hub-game/models/hold-show/moonflower.pxmodel +171 -0
  202. package/kits/hub-game/models/hold-show/rose.pxmodel +191 -0
  203. package/kits/hub-game/models/hold-show/square/daisy.pxmodel +233 -0
  204. package/kits/hub-game/models/hold-show/square/moonflower.pxmodel +173 -0
  205. package/kits/hub-game/models/hold-show/square/rose.pxmodel +193 -0
  206. package/kits/hub-game/models/hold-show/square/sunflower.pxmodel +313 -0
  207. package/kits/hub-game/models/hold-show/square/tulip.pxmodel +133 -0
  208. package/kits/hub-game/models/hold-show/sunflower.pxmodel +311 -0
  209. package/kits/hub-game/models/hold-show/tulip.pxmodel +131 -0
  210. package/kits/hub-game/package-lock.json +3 -3
  211. package/kits/hub-game/package.json +4 -3
  212. package/kits/hub-game/scripts/fixtures/engine-models-stub.mjs +1 -0
  213. package/kits/hub-game/scripts/fixtures/hud-surface.json +12 -12
  214. package/kits/hub-game/scripts/fixtures/talk-surface.json +8 -8
  215. package/kits/hub-game/scripts/gen-hats.mjs +1 -1
  216. package/kits/hub-game/scripts/gen-hold-show.mjs +27 -0
  217. package/kits/hub-game/scripts/pack.mjs +89 -23
  218. package/kits/hub-game/scripts/test-act-client.mjs +5 -0
  219. package/kits/hub-game/scripts/test-act-core.mjs +32 -0
  220. package/kits/hub-game/scripts/test-act-gate.mjs +186 -0
  221. package/kits/hub-game/scripts/test-action-rail-crowded-dom.mjs +7 -1
  222. package/kits/hub-game/scripts/test-action-rail-default-dom.mjs +102 -0
  223. package/kits/hub-game/scripts/test-action-rail-never-silent-dom.mjs +50 -0
  224. package/kits/hub-game/scripts/test-action-rail-surface.mjs +368 -0
  225. package/kits/hub-game/scripts/test-action-rail-town-jobs-dom.mjs +118 -0
  226. package/kits/hub-game/scripts/test-actions-client.mjs +5 -3
  227. package/kits/hub-game/scripts/test-actions.mjs +24 -0
  228. package/kits/hub-game/scripts/test-actors.mjs +19 -0
  229. package/kits/hub-game/scripts/test-again-corner-dom.mjs +59 -0
  230. package/kits/hub-game/scripts/test-analytics.mjs +79 -0
  231. package/kits/hub-game/scripts/test-arrival-pose-server.mjs +25 -8
  232. package/kits/hub-game/scripts/test-ask-client.mjs +9 -0
  233. package/kits/hub-game/scripts/test-ask-surface.mjs +188 -0
  234. package/kits/hub-game/scripts/test-attention.mjs +43 -1
  235. package/kits/hub-game/scripts/test-ballot-sheet-dom.mjs +71 -0
  236. package/kits/hub-game/scripts/test-ballot-surface.mjs +276 -0
  237. package/kits/hub-game/scripts/test-ballot.mjs +420 -3
  238. package/kits/hub-game/scripts/test-ban-join.mjs +1 -1
  239. package/kits/hub-game/scripts/test-celebrate-client.mjs +62 -0
  240. package/kits/hub-game/scripts/test-celebrate.mjs +116 -0
  241. package/kits/hub-game/scripts/test-chat.mjs +73 -0
  242. package/kits/hub-game/scripts/test-companion-client.mjs +203 -21
  243. package/kits/hub-game/scripts/test-companion.mjs +110 -3
  244. package/kits/hub-game/scripts/test-control-layout-dom.mjs +57 -10
  245. package/kits/hub-game/scripts/test-corner-surface.mjs +268 -0
  246. package/kits/hub-game/scripts/test-decor-client.mjs +59 -3
  247. package/kits/hub-game/scripts/test-decor.mjs +27 -0
  248. package/kits/hub-game/scripts/test-device-class.mjs +4 -1
  249. package/kits/hub-game/scripts/test-disguise-client.mjs +281 -0
  250. package/kits/hub-game/scripts/test-disguise.mjs +176 -0
  251. package/kits/hub-game/scripts/test-dock-surface.mjs +404 -0
  252. package/kits/hub-game/scripts/test-door-stay-client.mjs +602 -0
  253. package/kits/hub-game/scripts/test-door-stay.mjs +613 -0
  254. package/kits/hub-game/scripts/test-earned-client.mjs +119 -0
  255. package/kits/hub-game/scripts/test-emote-surface.mjs +616 -0
  256. package/kits/hub-game/scripts/test-fps-telemetry.mjs +39 -4
  257. package/kits/hub-game/scripts/test-friend-bests.mjs +38 -12
  258. package/kits/hub-game/scripts/test-ghost-click-dom.mjs +75 -0
  259. package/kits/hub-game/scripts/test-grab-client.mjs +29 -2
  260. package/kits/hub-game/scripts/test-grab-orbit.mjs +260 -11
  261. package/kits/hub-game/scripts/test-grab.mjs +10 -1
  262. package/kits/hub-game/scripts/test-hats.mjs +28 -0
  263. package/kits/hub-game/scripts/test-held-offers.mjs +394 -0
  264. package/kits/hub-game/scripts/test-high-only.mjs +3 -3
  265. package/kits/hub-game/scripts/test-hold-show-client.mjs +175 -0
  266. package/kits/hub-game/scripts/test-hold-show.mjs +355 -0
  267. package/kits/hub-game/scripts/test-hub-controls.mjs +3 -1
  268. package/kits/hub-game/scripts/test-hub-idle.mjs +348 -0
  269. package/kits/hub-game/scripts/test-hub-leaving.mjs +21 -0
  270. package/kits/hub-game/scripts/test-hub-ops.mjs +119 -0
  271. package/kits/hub-game/scripts/test-hub-trip.mjs +240 -4
  272. package/kits/hub-game/scripts/test-hud-clear.mjs +83 -0
  273. package/kits/hub-game/scripts/test-hud-rate.mjs +2 -1
  274. package/kits/hub-game/scripts/test-idle.mjs +160 -0
  275. package/kits/hub-game/scripts/test-invites-client.mjs +53 -0
  276. package/kits/hub-game/scripts/test-labels.mjs +11 -0
  277. package/kits/hub-game/scripts/test-landscape-layout.mjs +20 -0
  278. package/kits/hub-game/scripts/test-loading-cover.mjs +67 -1
  279. package/kits/hub-game/scripts/test-manifest.mjs +27 -0
  280. package/kits/hub-game/scripts/test-menu-client.mjs +54 -5
  281. package/kits/hub-game/scripts/test-menu-surface.mjs +236 -0
  282. package/kits/hub-game/scripts/test-npcs.mjs +128 -0
  283. package/kits/hub-game/scripts/test-observed.mjs +171 -3
  284. package/kits/hub-game/scripts/test-pack.mjs +166 -0
  285. package/kits/hub-game/scripts/test-picker-surface.mjs +321 -0
  286. package/kits/hub-game/scripts/test-placeat-server.mjs +395 -0
  287. package/kits/hub-game/scripts/test-placement-cache.mjs +1 -1
  288. package/kits/hub-game/scripts/test-pointer-clear-dom.mjs +82 -0
  289. package/kits/hub-game/scripts/test-progress-reset.mjs +184 -6
  290. package/kits/hub-game/scripts/test-push-visit.mjs +9 -0
  291. package/kits/hub-game/scripts/test-quality.mjs +312 -9
  292. package/kits/hub-game/scripts/test-quick-chat-surface.mjs +511 -0
  293. package/kits/hub-game/scripts/test-rehello.mjs +237 -0
  294. package/kits/hub-game/scripts/test-rejoin-yaw.mjs +138 -0
  295. package/kits/hub-game/scripts/test-relations-among.mjs +13 -7
  296. package/kits/hub-game/scripts/test-relations-refresh.mjs +90 -2
  297. package/kits/hub-game/scripts/test-replay-client.mjs +110 -0
  298. package/kits/hub-game/scripts/test-replay.mjs +178 -0
  299. package/kits/hub-game/scripts/test-resume-held.mjs +13 -0
  300. package/kits/hub-game/scripts/test-resume-pose-server.mjs +43 -5
  301. package/kits/hub-game/scripts/test-role-client.mjs +2 -1
  302. package/kits/hub-game/scripts/test-safe-act.mjs +233 -0
  303. package/kits/hub-game/scripts/test-safe-caption.mjs +364 -0
  304. package/kits/hub-game/scripts/test-safe-layout.mjs +79 -0
  305. package/kits/hub-game/scripts/test-safe-prompt.mjs +163 -0
  306. package/kits/hub-game/scripts/test-sound-surface.mjs +256 -0
  307. package/kits/hub-game/scripts/test-soundscape.mjs +85 -2
  308. package/kits/hub-game/scripts/test-stuck-surface.mjs +174 -0
  309. package/kits/hub-game/scripts/test-stuck.mjs +31 -0
  310. package/kits/hub-game/scripts/test-talk-surface.mjs +23 -6
  311. package/kits/hub-game/scripts/test-talk-walk-dom.mjs +123 -0
  312. package/kits/hub-game/scripts/test-text-ask-surface.mjs +273 -0
  313. package/kits/hub-game/scripts/test-tiers.mjs +453 -3
  314. package/kits/hub-game/scripts/test-toast-no-row-dom.mjs +71 -0
  315. package/kits/hub-game/scripts/test-together.mjs +11 -0
  316. package/kits/hub-game/scripts/test-town-day.mjs +90 -0
  317. package/kits/hub-game/scripts/test-try-on.mjs +39 -0
  318. package/kits/hub-game/scripts/test-ui-dom-dom.mjs +49 -2
  319. package/kits/hub-game/scripts/test-ui-tree.mjs +28 -0
  320. package/kits/hub-game/scripts/test-vehicle-client.mjs +68 -1
  321. package/kits/hub-game/scripts/test-vis.mjs +145 -0
  322. package/kits/hub-game/scripts/test-wallet.mjs +650 -0
  323. package/kits/hub-game/scripts/test-weakest-tier.mjs +135 -1
  324. package/kits/hub-game/scripts/test-world-labels.mjs +340 -0
  325. package/kits/hub-game/scripts/test-writer-lease-server.mjs +234 -0
  326. package/kits/hub-game/scripts/test-writer-lease.mjs +281 -0
  327. package/kits/hub-game/scripts/writer-storage-fixture.mjs +37 -0
  328. package/kits/hub-game/tools/hubScene/export.mjs +6 -5
  329. package/kits/hub-game/tools/hubScene/hubdata.mjs +10 -0
  330. package/kits/hub-game/tools/hubScene/test/export-fixture.mjs +36 -2
  331. package/kits/hub-game/tools/hubScene/validate-manifest.mjs +10 -2
  332. package/kits/multiplayer-3d/castle.json +5 -5
  333. package/kits/multiplayer-3d/code/client/resumeGate.js +49 -2
  334. package/kits/multiplayer-3d/code/server/ownership.js +25 -6
  335. package/kits/multiplayer-3d/code/server/world.js +19 -4
  336. package/kits/multiplayer-3d/code/systems/multiplayer.js +67 -11
  337. package/kits/multiplayer-3d/package-lock.json +1 -1
  338. package/kits/multiplayer-3d/package.json +2 -1
  339. package/kits/multiplayer-3d/scripts/test-ground-half.mjs +56 -0
  340. package/kits/multiplayer-3d/scripts/test-join-watchdog.mjs +54 -3
  341. package/kits/multiplayer-3d/scripts/test-owned-moves.mjs +190 -0
  342. package/kits/multiplayer-3d/scripts/test-resume-gate.mjs +191 -5
  343. package/kits/multiplayer-3d/scripts/test-resync-reconnect.mjs +68 -0
  344. package/kits/physics-2d/castle.json +2 -2
  345. package/kits/physics-2d/engine/scene.js +10 -2
  346. package/kits/physics-3d/CLAUDE.md +14 -0
  347. package/kits/physics-3d/behaviors/Player.jsx +39 -3
  348. package/kits/physics-3d/castle.json +3 -3
  349. package/kits/physics-3d/docs/engine-model-cache.md +109 -0
  350. package/kits/physics-3d/docs/engine-player.md +76 -0
  351. package/kits/physics-3d/docs/engine-skip-work.md +16 -0
  352. package/kits/physics-3d/docs/pxmodel-format.md +5 -1
  353. package/kits/physics-3d/engine3d/gait.js +16 -8
  354. package/kits/physics-3d/engine3d/groundsize.js +23 -0
  355. package/kits/physics-3d/engine3d/kithooks.js +50 -0
  356. package/kits/physics-3d/engine3d/look.js +110 -17
  357. package/kits/physics-3d/engine3d/lookbake.js +19 -1
  358. package/kits/physics-3d/engine3d/materialpresets.js +3 -2
  359. package/kits/physics-3d/engine3d/modelcache.js +280 -0
  360. package/kits/physics-3d/engine3d/modelcachedigest.js +37 -0
  361. package/kits/physics-3d/engine3d/modelcachegate.js +69 -0
  362. package/kits/physics-3d/engine3d/modelrefs.js +13 -0
  363. package/kits/physics-3d/engine3d/optimize.js +20 -9
  364. package/kits/physics-3d/engine3d/playerRun.js +26 -1
  365. package/kits/physics-3d/engine3d/pxmodel.js +7 -3
  366. package/kits/physics-3d/engine3d/templatecache.js +722 -0
  367. package/kits/physics-3d/engine3d/world3d.js +211 -17
  368. package/kits/physics-3d/package-lock.json +1 -1
  369. package/kits/physics-3d/package.json +2 -1
  370. package/kits/physics-3d/play/behaviors/Player.js +43 -3
  371. package/kits/physics-3d/scripts/render.mjs +56 -8
  372. package/kits/physics-3d/scripts/template-cache-fixtures.mjs +37 -0
  373. package/kits/physics-3d/scripts/template-cache-v1-bytes.json +49 -0
  374. package/kits/physics-3d/scripts/test-gait.mjs +53 -9
  375. package/kits/physics-3d/scripts/test-ground-half.mjs +120 -0
  376. package/kits/physics-3d/scripts/test-model-cache.mjs +600 -0
  377. package/kits/physics-3d/scripts/test-orbit-shadow-fade.mjs +1 -0
  378. package/kits/physics-3d/scripts/test-sleeping-models.mjs +384 -0
  379. package/kits/physics-3d/scripts/test-template-cache-minified.mjs +106 -0
  380. package/kits/physics-3d/scripts/test-template-cache.mjs +519 -0
  381. package/kits/physics-3d/scripts/test-wall-slide.mjs +272 -0
  382. package/kits/physics-3d/systems/physics3d.js +51 -2
  383. package/kits/real-time/castle.json +2 -2
  384. package/kits/real-time/code/client/connection.js +3 -0
  385. package/package.json +2 -2
  386. package/vendor/three/examples/jsm/libs/fflate.module.js +2672 -0
@@ -0,0 +1,273 @@
1
+ // The text ask surface (`code/client/textAskSurface.js`) and its tree
2
+ // (`textAskTree.js`): the question card on its dimming shield as the
3
+ // `textask` UI tree root, with no DOM, for a native host. Checks that the
4
+ // trees validate, portrait and landscape; that bytes and binding ids do not
5
+ // move across rebuilds with fresh closures; and that every event dispatched
6
+ // as a host sends it reaches the right action: OK and Enter answering with
7
+ // the words only while valid and not composing, Cancel, Esc and Back
8
+ // answering null, input and submits from an earlier opening dropped, the
9
+ // words cut to `max` code points, a newer offer replacing the card, an older
10
+ // one ignored, an id of null opening nothing.
11
+ import assert from 'node:assert/strict';
12
+ import { execFileSync } from 'node:child_process';
13
+ import { readFileSync } from 'node:fs';
14
+ import { dispatchUiEvent, resetUiTrees, serialize, setUiTreeSink, validate } from '../code/client/uiTree.js';
15
+ import { buildTextAsk, textAskWidth } from '../code/client/textAskTree.js';
16
+ import { clampCodePoints, makeTextAskSurface } from '../code/client/textAskSurface.js';
17
+
18
+ let passed = 0;
19
+ const test = async (name, fn) => {
20
+ try {await fn();} catch (error) {error.message = `${name}: ${error.message}`; throw error;}
21
+ passed += 1;
22
+ };
23
+
24
+ const VIEWS = { portrait: { landscape: false }, landscape: { landscape: true } };
25
+ const SPEC = { id: 'name', n: 3, title: 'Name your boat', max: 12 };
26
+ const FIELD = { value: '', ver: 1, focus: 1 };
27
+ const ON = () => ({ input() {}, submit() {}, ok() {}, cancel() {}, focus() {}, blur() {} });
28
+ const P = 'textask/shield/card';
29
+
30
+ function at(tree, path) {
31
+ let node = tree;
32
+ for (const key of path.split('/').slice(1)) {
33
+ node = node?.c?.find((child) => child.k === key);
34
+ }
35
+ return node ?? null;
36
+ }
37
+ const words = (node) => node?.text ?? node?.c?.find((child) => child.t === 'text' && !child.k)?.text;
38
+
39
+ function makeHost(view = VIEWS.portrait) {
40
+ resetUiTrees();
41
+ const host = { roots: [], answers: [], opens: [], view };
42
+ setUiTreeSink((name, wire, handlers) => {host.roots.push({ name, wire, handlers });}, { dom: false });
43
+ host.surface = makeTextAskSurface({ view: () => host.view });
44
+ host.wire = () => host.roots.filter((r) => r.name === 'textask').at(-1)?.wire ?? null;
45
+ host.field = () => at(host.wire(), `${P}/answer`);
46
+ host.okNode = () => at(host.wire(), `${P}/buttons/ok`);
47
+ host.event = (id, payload = {}) => dispatchUiEvent('textask', id, payload);
48
+ host.type = (text, composing = false) => host.event(`${P}/answer#input`, { text, base: host.field().ver, composing });
49
+ // The hub system's handler: it sends { k: 'hub-answer', id, n, text }.
50
+ host.offer = (spec) => host.surface.set(spec, (id, n, text) => host.answers.push({ k: 'hub-answer', id, n, text }), (open) => host.opens.push(open));
51
+ return host;
52
+ }
53
+
54
+ await test('trees validate, portrait and landscape: no card, OK on and off', () => {
55
+ for (const view of Object.values(VIEWS)) {
56
+ for (const state of [{ view, spec: null }, { view, spec: { ...SPEC, id: null } }, { view, spec: SPEC, field: FIELD, ok: false }, { view, spec: SPEC, field: FIELD, ok: true }]) {
57
+ assert.deepEqual(validate(buildTextAsk(state, ON()), 'textask'), [], JSON.stringify(state));
58
+ assert.deepEqual(validate(buildTextAsk(state), 'textask'), []);
59
+ }
60
+ }
61
+ });
62
+
63
+ await test('bytes and binding ids do not move across rebuilds with fresh closures', () => {
64
+ for (const view of Object.values(VIEWS)) {
65
+ for (const ok of [false, true]) {
66
+ const fresh = (n) => Object.fromEntries(Object.keys(ON()).map((name) => [name, () => n]));
67
+ const one = serialize(buildTextAsk({ view, spec: SPEC, field: FIELD, ok }, fresh(1)), 'textask');
68
+ const two = serialize(buildTextAsk({ view, spec: SPEC, field: FIELD, ok }, fresh(2)), 'textask');
69
+ assert.equal(one.json, two.json);
70
+ assert.deepEqual([...one.handlers.keys()], [...two.handlers.keys()]);
71
+ }
72
+ }
73
+ assert.deepEqual([...serialize(buildTextAsk({ view: VIEWS.portrait, spec: SPEC, field: FIELD, ok: true }, ON()), 'textask').handlers.keys()], [
74
+ 'textask#cancel',
75
+ `${P}/answer#input`, `${P}/answer#submit`, `${P}/answer#cancel`, `${P}/answer#focus`, `${P}/answer#blur`,
76
+ `${P}/buttons/ok#tap`, `${P}/buttons/cancel#tap`,
77
+ ]);
78
+ assert.equal(serialize(buildTextAsk({ view: VIEWS.portrait, spec: null }, ON()), 'textask').json, '{"t":"stack","k":"textask","s":{"font":"ui","size":15,"weight":600,"lh":1.3,"color":"#fff"}}');
79
+ });
80
+
81
+ await test('the DOM\'s words, sizes and places, portrait and landscape', () => {
82
+ const tree = buildTextAsk({ view: VIEWS.portrait, spec: SPEC, field: FIELD, ok: false });
83
+ const shield = at(tree, 'textask/shield');
84
+ // Level 10 in its root, as the DOM's shield; nothing else in the root.
85
+ assert.deepEqual([shield.at, shield.s.bg, shield.s.hit], [{ anchor: 'fill', z: 10 }, 'rgba(0,0,0,0.35)', 'auto']);
86
+ assert.deepEqual(tree.c.map((n) => n.k), ['shield']);
87
+ const card = at(tree, P);
88
+ assert.deepEqual([card.t, card.role, card.label], ['column', 'dialog', 'Name your boat']);
89
+ assert.deepEqual(card.at, { anchor: 'bottom', bottom: [24, 24], ime: true });
90
+ assert.deepEqual([card.s.w, card.s.pad, card.s.gap, card.s.radius, card.s.bg, card.s.size], [[{ vw: 90 }, { px: 320 }], 14, 10, 12, '#17120e', 14]);
91
+ assert.equal(at(tree, `${P}/title`).text, 'Name your boat');
92
+ const field = at(tree, `${P}/answer`);
93
+ assert.deepEqual([field.label, field.max, field.maxUnit, field.cap, field.spell, field.correct, field.s.minH, field.s.size], ['Name your boat', 12, 'cp', 'words', false, false, 44, 16]);
94
+ const ok = at(tree, `${P}/buttons/ok`);
95
+ assert.deepEqual([words(ok), ok.disabled, ok.s.opacity, ok.s.minH, ok.s.minW, ok.s.bg], ['OK', true, 0.45, 44, 64, 'gold']);
96
+ const cancel = at(tree, `${P}/buttons/cancel`);
97
+ assert.deepEqual([words(cancel), cancel.disabled, cancel.s.minH, cancel.s.minW], ['Cancel', undefined, 44, 64]);
98
+ assert.equal(at(buildTextAsk({ view: VIEWS.portrait, spec: SPEC, field: FIELD, ok: true }), `${P}/buttons/ok`).s.opacity, 1);
99
+ const land = at(buildTextAsk({ view: VIEWS.landscape, spec: SPEC, field: FIELD, ok: false }), P);
100
+ assert.deepEqual([land.t, land.axis, land.s.w, land.s.maxH], ['scroll', 'y', textAskWidth(true), [{ dvh: 100, px: -88, safe: 'tb' }]]);
101
+ const chrome = readFileSync(new URL('../code/client/chrome.js', import.meta.url), 'utf8');
102
+ for (const piece of [
103
+ "zIndex: '10', background: 'rgba(0,0,0,0.35)'", "width: 'min(90vw, 320px)', boxSizing: 'border-box', pointerEvents: 'auto', display: 'flex', flexDirection: 'column', gap: '10px', padding: '14px', borderRadius: '12px', background: '#17120e'",
104
+ "card.style.bottom = `max(${bottom + 24}px, calc(env(safe-area-inset-bottom) + 24px))`", "input.setAttribute('autocapitalize', 'words')", "input.spellcheck = false",
105
+ "smallButton(row, 'OK', true), cancel = smallButton(row, 'Cancel', false)", "ok.style.opacity = ok.disabled ? '0.45' : ''", "button.style.minHeight = '44px'",
106
+ "textAsk.card.style.width = landscape ? width : 'min(90vw, 320px)'", "const width = 'min(56vw, max(220px, calc(100vw - 344px)), 560px)'",
107
+ ]) {
108
+ assert(chrome.includes(piece), piece);
109
+ }
110
+ });
111
+
112
+ await test('events: OK and Enter answer only with valid words not mid-composition', () => {
113
+ for (const view of Object.values(VIEWS)) {
114
+ const host = makeHost(view);
115
+ host.offer(SPEC);
116
+ assert.equal(host.surface.isOpen(), true);
117
+ assert(host.field().focus > 0, 'the field asks for focus as it opens');
118
+ // Empty, spaces only, a control character: OK stays off and takes nothing.
119
+ assert.equal(host.okNode().disabled, true);
120
+ host.event(`${P}/buttons/ok#tap`);
121
+ host.type(' ');
122
+ assert.equal(host.okNode().disabled, true);
123
+ host.type('bad​word');
124
+ assert.equal(host.okNode().disabled, true);
125
+ host.event(`${P}/answer#submit`, { text: 'bad​word', base: host.field().ver });
126
+ // Composing: off until the composition ends.
127
+ host.type('ふね', true);
128
+ assert.equal(host.okNode().disabled, true);
129
+ host.event(`${P}/buttons/ok#tap`);
130
+ assert.deepEqual(host.answers, []);
131
+ host.type('ふね');
132
+ assert.equal(host.okNode().disabled, false);
133
+ // OK.
134
+ host.event(`${P}/buttons/ok#tap`);
135
+ assert.deepEqual(host.answers, [{ k: 'hub-answer', id: 'name', n: 3, text: 'ふね' }]);
136
+ assert.equal(host.surface.isOpen(), false);
137
+ assert.equal(at(host.wire(), 'textask/shield'), null);
138
+ assert.equal(host.wire().on, undefined, 'a shut card binds no cancel');
139
+ // Enter, on a newer offer: the words cut to max code points.
140
+ host.offer({ ...SPEC, n: 4, max: 3 });
141
+ host.type('🐟🐟🐟🐟🐟');
142
+ assert.equal(host.okNode().disabled, false);
143
+ host.event(`${P}/answer#submit`, { text: '🐟🐟🐟🐟🐟', base: host.field().ver });
144
+ assert.deepEqual(host.answers.at(-1), { k: 'hub-answer', id: 'name', n: 4, text: '🐟🐟🐟' });
145
+ assert.deepEqual(host.opens, [true, false, true, false]);
146
+ host.surface.dispose();
147
+ assert.equal(host.wire(), null);
148
+ resetUiTrees();
149
+ }
150
+ });
151
+
152
+ await test('events: a submit mid-composition answers nothing until an input commits the composition', () => {
153
+ for (const view of Object.values(VIEWS)) {
154
+ const host = makeHost(view);
155
+ host.offer(SPEC);
156
+ host.type('ふね', true);
157
+ // Enter while composing, with words that would be valid: nothing.
158
+ assert.equal(host.event(`${P}/answer#submit`, { text: 'ふね', base: host.field().ver }), true);
159
+ assert.deepEqual(host.answers, []);
160
+ assert.equal(host.surface.isOpen(), true);
161
+ assert.equal(host.okNode().disabled, true, 'still composing');
162
+ host.event(`${P}/buttons/ok#tap`);
163
+ assert.deepEqual(host.answers, []);
164
+ // The composition commits; then Enter answers.
165
+ host.type('船');
166
+ assert.equal(host.okNode().disabled, false);
167
+ host.event(`${P}/answer#submit`, { text: '船', base: host.field().ver });
168
+ assert.deepEqual(host.answers, [{ k: 'hub-answer', id: 'name', n: 3, text: '船' }]);
169
+ host.surface.dispose();
170
+ resetUiTrees();
171
+ }
172
+ });
173
+
174
+ await test('events: Cancel, Esc and Back answer null; the host can cancel', () => {
175
+ for (const view of Object.values(VIEWS)) {
176
+ const host = makeHost(view);
177
+ host.offer(SPEC);
178
+ host.type('half');
179
+ host.event(`${P}/buttons/cancel#tap`);
180
+ host.offer({ ...SPEC, n: 4 });
181
+ assert.equal(host.field().value, '', 'the words were wiped');
182
+ host.event(`${P}/answer#cancel`);
183
+ host.offer({ ...SPEC, n: 5 });
184
+ assert.equal(host.event('textask#cancel'), true);
185
+ host.offer({ ...SPEC, n: 6 });
186
+ host.surface.cancel();
187
+ assert.deepEqual(host.answers.map((a) => [a.n, a.text]), [[3, null], [4, null], [5, null], [6, null]]);
188
+ assert.equal(host.event('textask#cancel'), false);
189
+ host.surface.dispose();
190
+ resetUiTrees();
191
+ }
192
+ });
193
+
194
+ await test('events: input and submits from an earlier opening are dropped; every opening is a new version', () => {
195
+ for (const view of Object.values(VIEWS)) {
196
+ const host = makeHost(view);
197
+ host.offer(SPEC);
198
+ const first = host.field().ver;
199
+ host.type('Old');
200
+ host.surface.set(null);
201
+ assert.deepEqual(host.answers, [], 'a null offer shuts the card without answering');
202
+ host.offer({ ...SPEC, n: 4 });
203
+ assert.equal(host.field().ver, first + 1);
204
+ assert.equal(host.event(`${P}/answer#submit`, { text: 'Old', base: first }), true);
205
+ host.event(`${P}/answer#input`, { text: 'Stale', base: first, composing: false });
206
+ assert.deepEqual(host.answers, []);
207
+ assert.equal(host.okNode().disabled, true, 'the stale input did not count');
208
+ host.event(`${P}/answer#submit`, { text: 'no version' });
209
+ assert.deepEqual(host.answers, []);
210
+ host.type('Fresh');
211
+ host.event(`${P}/buttons/ok#tap`);
212
+ assert.deepEqual(host.answers, [{ k: 'hub-answer', id: 'name', n: 4, text: 'Fresh' }]);
213
+ host.surface.dispose();
214
+ resetUiTrees();
215
+ }
216
+ });
217
+
218
+ await test('offers: a newer one replaces the card, an older or equal one is ignored, an id of null opens nothing', () => {
219
+ const host = makeHost();
220
+ host.offer(SPEC);
221
+ host.type('first');
222
+ host.offer({ ...SPEC, n: 3, title: 'Same version' });
223
+ assert.equal(at(host.wire(), `${P}/title`).text, 'Name your boat');
224
+ host.offer({ ...SPEC, n: 2 });
225
+ assert.equal(host.surface.isOpen(), true);
226
+ // A newer offer: the old card shuts unanswered, the new one is fresh.
227
+ host.offer({ id: 'pet', n: 5, title: 'Name your pet', max: 20 });
228
+ assert.equal(at(host.wire(), `${P}/title`).text, 'Name your pet');
229
+ assert.equal(host.field().value, '');
230
+ // An id of null: the version is taken, nothing opens.
231
+ assert.equal(host.surface.pending({ id: null, n: 6 }), false);
232
+ assert.equal(host.surface.pending({ id: 'x', n: 6 }), true);
233
+ host.offer({ id: null, n: 6 });
234
+ assert.equal(host.surface.isOpen(), false);
235
+ assert.equal(host.surface.pending({ id: 'x', n: 6 }), false);
236
+ host.offer({ ...SPEC, n: 6 });
237
+ assert.equal(host.surface.isOpen(), false);
238
+ host.surface.clear();
239
+ assert.equal(host.surface.pending({ id: 'x', n: 1 }), true, 'clear forgets the last version');
240
+ host.offer({ ...SPEC, n: 1 });
241
+ assert.equal(host.surface.isOpen(), true);
242
+ assert.deepEqual(host.answers, []);
243
+ assert.deepEqual(host.opens, [true, false, true, false, true]);
244
+ // A turn re-lays the card out; an unchanged stage sends nothing.
245
+ host.view = VIEWS.landscape;
246
+ host.surface.render();
247
+ assert.equal(at(host.wire(), P).t, 'scroll');
248
+ const count = host.roots.length;
249
+ host.surface.render();
250
+ assert.equal(host.roots.length, count);
251
+ assert.equal(clampCodePoints('a🐟b', 2), 'a🐟');
252
+ host.surface.dispose();
253
+ resetUiTrees();
254
+ });
255
+
256
+ await test('the surface loads and runs in a process that never had a DOM', () => {
257
+ const probe = `
258
+ if (globalThis.document || globalThis.window) throw new Error('a DOM');
259
+ const { setUiTreeSink, dispatchUiEvent } = await import(${JSON.stringify(new URL('../code/client/uiTree.js', import.meta.url).href)});
260
+ const { makeTextAskSurface } = await import(${JSON.stringify(new URL('../code/client/textAskSurface.js', import.meta.url).href)});
261
+ const seen = [];
262
+ let ver = 0;
263
+ setUiTreeSink((name, wire) => {seen.push(name + ':' + (wire ? (wire.c ?? []).length : null)); ver = wire?.c?.[0]?.c?.[0]?.c?.[1]?.ver ?? ver;}, { dom: false });
264
+ const surface = makeTextAskSurface({ view: () => ({ landscape: false }) });
265
+ surface.set(${JSON.stringify(SPEC)}, (id, n, text) => seen.push(JSON.stringify({ k: 'hub-answer', id, n, text })));
266
+ dispatchUiEvent('textask', 'textask/shield/card/answer#submit', { text: 'Skiff', base: ver });
267
+ surface.dispose();
268
+ console.log(seen.join(' '));
269
+ `;
270
+ assert.equal(execFileSync(process.execPath, ['--input-type=module', '-e', probe], { encoding: 'utf8' }).trim(), 'textask:0 textask:1 textask:0 {"k":"hub-answer","id":"name","n":3,"text":"Skiff"} textask:null');
271
+ });
272
+
273
+ console.log(`text ask surface: ${passed} checks passed`);