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,404 @@
1
+ // The dock surface (`code/client/dockSurface.js`) and its tree
2
+ // (`dockTree.js`): the Doors and People buttons, the companion badge and the
3
+ // list each opens, as the `dock` UI tree root, with no DOM, for a native
4
+ // host. Checks that the trees validate in every state, portrait and
5
+ // landscape; that their bytes and binding ids do not move across rebuilds
6
+ // with fresh closures; and that events dispatched as a host sends them
7
+ // (`dispatchUiEvent`) reach the right action: Doors open and shut, a door
8
+ // picked, the "Stuck?" row, a heart, People open and shut with its count
9
+ // following the roster, a person's action, Report behind its confirm, the
10
+ // party line, the companion badge, and Back shutting an open list.
11
+ import assert from 'node:assert/strict';
12
+ import { execFileSync } from 'node:child_process';
13
+ import { dispatchUiEvent, resetUiTrees, serialize, setUiTreeSink, validate } from '../code/client/uiTree.js';
14
+ import { buildDock, dockLines, peopleLabel } from '../code/client/dockTree.js';
15
+ import { makeDockSurface } from '../code/client/dockSurface.js';
16
+
17
+ let passed = 0;
18
+ const test = async (name, fn) => {
19
+ try {await fn();} catch (error) {error.message = `${name}: ${error.message}`; throw error;}
20
+ passed += 1;
21
+ };
22
+
23
+ const VIEWS = {
24
+ portrait: { landscape: false, desktop: false, safeInsets: true },
25
+ landscape: { landscape: true, desktop: false, safeInsets: true },
26
+ };
27
+ const DOORS = [
28
+ { id: 'race', title: 'Rooftop Race', featured: true },
29
+ { id: 'golf', title: 'Mini Golf', solo: true },
30
+ { id: 'tag', title: 'Tag', need: 3 },
31
+ ];
32
+ const YOURS = { rows: [{ door: 'golf', title: 'My Golf', line: 'Best 3 under' }], hearts: ['race'] };
33
+ const ME_ACTIONS = [{ id: 'find', text: 'Find' }, { id: 'invite', text: 'Invite' }, { id: 'report', text: 'Report' }];
34
+ const PEOPLE = [
35
+ { key: 'p2', playerId: 'p2', username: 'bo', mark: '★ ', where: 'By the fountain', actions: ME_ACTIONS },
36
+ { key: 'p3', playerId: 'p3', username: 'cy', actions: [{ id: 'report', text: 'Report' }] },
37
+ { key: 'f9', userId: 'u9', username: 'di', where: 'In Rooftop Race', door: 'race', actions: [{ id: 'join', text: 'Join' }] },
38
+ ];
39
+
40
+ // The node at a path of keys under a wire (or builder) tree.
41
+ function at(tree, path) {
42
+ let node = tree;
43
+ for (const key of path.split('/').slice(1)) {
44
+ node = node?.c?.find((child) => child.k === key);
45
+ }
46
+ return node ?? null;
47
+ }
48
+ const words = (node) => node?.text ?? node?.c?.find((child) => child.t === 'text' && !child.k)?.text;
49
+
50
+ function makeHost() {
51
+ const host = { roots: new Map(), posts: 0, calls: [] };
52
+ setUiTreeSink((name, wire, handlers) => {
53
+ host.posts += 1;
54
+ host.roots.set(name, { wire, handlers });
55
+ }, { dom: false });
56
+ host.wire = () => host.roots.get('dock')?.wire ?? null;
57
+ host.ids = () => [...(host.roots.get('dock')?.handlers.keys() ?? [])];
58
+ host.event = (id, payload = {}) => dispatchUiEvent('dock', id, payload);
59
+ return host;
60
+ }
61
+ function makeSurface(host, view) {
62
+ const note = (...entry) => host.calls.push(entry);
63
+ return makeDockSurface({
64
+ view: () => view,
65
+ onJumpDoor: (door) => note('jump', door.id ?? null, door.title),
66
+ onHeart: (id) => note('heart', id),
67
+ onPerson: (person, id) => note('person', person.key, id),
68
+ onReport: (person) => note('report', person.key),
69
+ onLeaveParty: () => note('leave'),
70
+ onChip: () => note('chip'),
71
+ onChange: (open) => note('open', open),
72
+ });
73
+ }
74
+
75
+ await test('trees validate in every state, portrait and landscape', () => {
76
+ for (const view of [...Object.values(VIEWS), { landscape: false, desktop: true, safeInsets: false }]) {
77
+ for (const open of [null, 'doors', 'people']) {
78
+ for (const doors of [null, { list: DOORS, goText: 'Go' }, { list: DOORS, goText: 'Go together', stuck: { where: 'Back to the square' }, yours: YOURS }]) {
79
+ for (const people of [null, { list: PEOPLE, party: null }, { list: PEOPLE, party: 'Your party · 2' }]) {
80
+ for (const rows of [{}, { p2: { more: true }, p3: { confirming: true } }]) {
81
+ for (const companion of [null, { name: 'Biscuit' }]) {
82
+ const state = { view, open, doors, people, rows, companion, hidden: false, badgeBlocked: false };
83
+ const on = Object.fromEntries(['doors', 'people', 'go', 'stuck', 'heart', 'action', 'report', 'confirm', 'more', 'leaveParty', 'companion', 'close'].map((name) => [name, () => {}]));
84
+ assert.deepEqual(validate(buildDock(state, on)), [], JSON.stringify(state));
85
+ assert.deepEqual(validate(buildDock(state)), [], 'no handlers');
86
+ }
87
+ }
88
+ }
89
+ }
90
+ }
91
+ }
92
+ });
93
+
94
+ await test('bytes and binding ids do not move across rebuilds with fresh closures', () => {
95
+ for (const view of Object.values(VIEWS)) {
96
+ for (const open of ['doors', 'people']) {
97
+ const state = { view, open, doors: { list: DOORS, goText: 'Go', stuck: { where: 'Square' }, yours: YOURS }, people: { list: PEOPLE, party: 'Party · 2' }, rows: { p2: { more: true } }, companion: { name: 'Biscuit' } };
98
+ const handlers = (n) => Object.fromEntries(['doors', 'people', 'go', 'stuck', 'heart', 'action', 'report', 'confirm', 'more', 'leaveParty', 'companion', 'close'].map((name) => [name, () => n]));
99
+ const one = serialize(buildDock(state, handlers(1)), 'dock');
100
+ const two = serialize(buildDock(state, handlers(2)), 'dock');
101
+ assert.equal(one.json, two.json);
102
+ assert.deepEqual([...one.handlers.keys()], [...two.handlers.keys()]);
103
+ assert(one.handlers.has('dock#cancel'));
104
+ assert(one.handlers.has('dock/dock/buttons/doors#tap'));
105
+ assert(one.handlers.has('dock/dock/buttons/people#tap'));
106
+ assert(one.handlers.has('dock/dock/buttons/companion#tap'));
107
+ if (open === 'doors') {
108
+ assert(one.handlers.has('dock/dock/doors/body/d:race/go#tap'));
109
+ assert(one.handlers.has('dock/dock/doors/body/y:golf/go#tap'));
110
+ assert(one.handlers.has('dock/dock/doors/body/d:race/heart#tap'));
111
+ assert(one.handlers.has('dock/dock/doors/body/stuck/row/go#tap'));
112
+ } else {
113
+ assert(one.handlers.has('dock/dock/people/body/p:p2/row/a:find#tap'));
114
+ assert(one.handlers.has('dock/dock/people/body/p:p2/more/a:invite#tap'));
115
+ assert(one.handlers.has('dock/dock/people/body/party/row/leave#tap'));
116
+ }
117
+ }
118
+ }
119
+ });
120
+
121
+ await test('the dock: portrait at the bottom left with the list above; landscape at the top with it below', () => {
122
+ const state = { open: 'doors', doors: { list: DOORS, goText: 'Go' }, people: { list: PEOPLE } };
123
+ const portrait = buildDock({ ...state, view: VIEWS.portrait });
124
+ assert.deepEqual(at(portrait, 'dock/dock').at, { anchor: 'bottomLeft', bottom: [10, 0], left: [10, 0] });
125
+ assert.deepEqual(at(portrait, 'dock/dock').c.map((n) => n.k), ['doors', 'buttons']);
126
+ assert.deepEqual(at(portrait, 'dock/dock/doors').s.maxH, [{ vh: 40 }]);
127
+ const landscape = buildDock({ ...state, view: VIEWS.landscape });
128
+ assert.deepEqual(at(landscape, 'dock/dock').at, { anchor: 'topLeft', top: [68, 56], left: [10, 0] });
129
+ assert.deepEqual(at(landscape, 'dock/dock').c.map((n) => n.k), ['buttons', 'doors']);
130
+ assert.deepEqual(at(landscape, 'dock/dock/buttons').s.maxW, [{ vw: 24 }, { px: 160 }]);
131
+ // Not a safe-inset place: a plain 10 px from the left.
132
+ assert.equal(at(buildDock({ ...state, view: { landscape: false } }), 'dock/dock').at.left, 10);
133
+ // The doors list: featured star, solo, needs, Go words.
134
+ const rows = at(portrait, 'dock/dock/doors/body').c;
135
+ assert.deepEqual(rows.map((r) => r.k), ['d:race', 'd:golf', 'd:tag']);
136
+ assert.deepEqual(rows.map((r) => at(r, 'x/words/name').text), ['★ Rooftop Race', 'Mini Golf', 'Tag']);
137
+ assert.deepEqual(rows.map((r) => at(r, 'x/words/takes')?.text ?? null), [null, 'solo', 'needs 3']);
138
+ const party = buildDock({ ...state, view: VIEWS.portrait, doors: { list: DOORS, goText: 'Go together', stuck: { where: 'Back to the square' }, yours: YOURS } });
139
+ const body = at(party, 'dock/dock/doors/body');
140
+ assert.deepEqual(body.c.map((r) => r.k), ['stuck', 'yours', 'y:golf', 'all', 'd:race', 'd:golf', 'd:tag']);
141
+ assert.equal(at(body, 'x/stuck').hub, 'stuck-row');
142
+ assert.equal(at(body, 'x/stuck/row/go').label, 'Stuck? Back to the square');
143
+ assert.equal(at(body, 'x/yours').text, 'Your games');
144
+ assert.equal(at(body, 'x/all/title').text, 'All doors');
145
+ assert.equal(at(body, 'x/y:golf/words/name').text, 'My Golf');
146
+ assert.equal(at(body, 'x/y:golf/words/takes').text, 'Best 3 under');
147
+ assert.deepEqual(['d:race', 'd:golf', 'd:tag'].map((k) => words(at(body, `x/${k}/go`))), ['Go together', 'Go', 'Go together']);
148
+ assert.deepEqual([at(body, 'x/d:race/heart').pressed, at(body, 'x/d:golf/heart').pressed], [true, false]);
149
+ assert.deepEqual([words(at(body, 'x/d:race/heart')), at(body, 'x/d:race/heart').label], ['♥', 'Remove heart']);
150
+ assert.equal(at(body, 'x/d:golf/heart').label, 'Heart this game');
151
+ // A phone shows three of the player's games, a desktop five.
152
+ const many = { rows: Array.from({ length: 6 }, (_, i) => ({ door: 'race', title: `G${i}`, line: '' })), hearts: null };
153
+ const count = (desktop) => {
154
+ const tree = buildDock({ ...state, view: { desktop }, doors: { list: DOORS, yours: many } });
155
+ assert.deepEqual(validate(tree), []);
156
+ return at(tree, 'dock/dock/doors/body').c.filter((r) => r.k.startsWith('y:race')).map((r) => r.k);
157
+ };
158
+ assert.deepEqual(count(false), ['y:race', 'y:race~2', 'y:race~3'], 'a phone; a door listed twice keeps a key of its own');
159
+ assert.equal(count(true).length, 5);
160
+ });
161
+
162
+ await test('surface: Doors opens and shuts, a door is picked, Back shuts it', () => {
163
+ for (const view of Object.values(VIEWS)) {
164
+ resetUiTrees();
165
+ const host = makeHost();
166
+ const surface = makeSurface(host, view);
167
+ assert.equal(at(host.wire(), 'dock/dock/buttons/doors').s.gone, true, 'no doors, no button');
168
+ surface.setDoors(DOORS, 'Go', { where: 'Back to the square', onPick: () => host.calls.push(['stuck']) }, YOURS);
169
+ assert.equal(at(host.wire(), 'dock/dock/buttons/doors').s.gone, false);
170
+ assert.equal(words(at(host.wire(), 'dock/dock/buttons/doors')), 'Doors');
171
+ // Said every frame unchanged: nothing more is sent.
172
+ const posts = host.posts;
173
+ surface.setDoors(DOORS, 'Go', { where: 'Back to the square', onPick: () => host.calls.push(['stuck']) }, YOURS);
174
+ assert.equal(host.posts, posts);
175
+ // Open, shut by the button.
176
+ host.event('dock/dock/buttons/doors#tap');
177
+ assert.equal(surface.doorsOpen(), true);
178
+ assert(at(host.wire(), 'dock/dock/doors'));
179
+ assert.equal(host.wire().on.cancel, 'dock#cancel');
180
+ host.event('dock/dock/buttons/doors#tap');
181
+ assert.equal(surface.doorsOpen(), false);
182
+ assert.equal(at(host.wire(), 'dock/dock/doors'), null);
183
+ assert.equal(host.wire().on, undefined, 'no list, no cancel');
184
+ // Open, shut by Back.
185
+ host.event('dock/dock/buttons/doors#tap');
186
+ assert.equal(host.event('dock#cancel'), true);
187
+ assert.equal(surface.doorsOpen(), false);
188
+ assert.equal(host.event('dock#cancel'), false, 'Back passes a shut dock by');
189
+ // Open, pick a door: the list shuts, then the chip sound, then the jump.
190
+ host.event('dock/dock/buttons/doors#tap');
191
+ host.event('dock/dock/doors/body/d:tag/go#tap');
192
+ assert.equal(surface.doorsOpen(), false);
193
+ // One of the player's games: its door, with the row's title.
194
+ host.event('dock/dock/buttons/doors#tap');
195
+ host.event('dock/dock/doors/body/y:golf/go#tap');
196
+ // The stuck row, and a heart (the list stays open).
197
+ host.event('dock/dock/buttons/doors#tap');
198
+ host.event('dock/dock/doors/body/d:race/heart#tap');
199
+ assert.equal(surface.doorsOpen(), true);
200
+ host.event('dock/dock/doors/body/stuck/row/go#tap');
201
+ assert.equal(surface.doorsOpen(), false);
202
+ assert.deepEqual(host.calls, [
203
+ ['open', 'doors'], ['open', null],
204
+ ['open', 'doors'], ['open', null],
205
+ ['open', 'doors'], ['open', null], ['chip'], ['jump', 'tag', 'Tag'],
206
+ ['open', 'doors'], ['open', null], ['chip'], ['jump', 'golf', 'My Golf'],
207
+ ['open', 'doors'], ['heart', 'race'], ['open', null], ['stuck'],
208
+ ]);
209
+ // The doors go away while the list is open: it shuts.
210
+ host.event('dock/dock/buttons/doors#tap');
211
+ surface.setDoors(null);
212
+ assert.equal(surface.doorsOpen(), false);
213
+ assert.equal(at(host.wire(), 'dock/dock/buttons/doors').s.gone, true);
214
+ assert.deepEqual(validate(host.wire()), []);
215
+ surface.dispose();
216
+ assert.equal(host.wire(), null);
217
+ resetUiTrees();
218
+ }
219
+ });
220
+
221
+ await test('surface: People opens and shuts, its count follows the roster, one list at a time', () => {
222
+ for (const view of Object.values(VIEWS)) {
223
+ resetUiTrees();
224
+ const host = makeHost();
225
+ const surface = makeSurface(host, view);
226
+ surface.setDoors(DOORS);
227
+ surface.setPeople(PEOPLE);
228
+ const label = () => words(at(host.wire(), 'dock/dock/buttons/people'));
229
+ assert.equal(label(), 'People · 3', 'two others here and the player; a friend elsewhere is not counted');
230
+ surface.setPeople(PEOPLE.slice(0, 1));
231
+ assert.equal(label(), 'People · 2');
232
+ surface.setPeople([...PEOPLE, { key: 'p4', playerId: 'p4', username: 'ed', actions: [] }]);
233
+ assert.equal(label(), 'People · 4');
234
+ assert.equal(peopleLabel(PEOPLE), 'People · 3');
235
+ // Open, then Doors: one list at a time.
236
+ host.event('dock/dock/buttons/people#tap');
237
+ assert.equal(surface.peopleOpen(), true);
238
+ assert.deepEqual(at(host.wire(), 'dock/dock/people/body').c.map((r) => r.k), ['p:p2', 'p:p3', 'p:f9', 'p:p4']);
239
+ host.event('dock/dock/buttons/doors#tap');
240
+ assert.equal(surface.peopleOpen(), false);
241
+ assert.equal(surface.doorsOpen(), true);
242
+ host.event('dock/dock/buttons/people#tap');
243
+ assert.equal(surface.doorsOpen(), false);
244
+ // Shut by its button, then by Back.
245
+ host.event('dock/dock/buttons/people#tap');
246
+ assert.equal(surface.peopleOpen(), false);
247
+ host.event('dock/dock/buttons/people#tap');
248
+ host.event('dock#cancel');
249
+ assert.equal(surface.peopleOpen(), false);
250
+ // The roster empties while open: the list shuts, the button goes.
251
+ host.event('dock/dock/buttons/people#tap');
252
+ surface.setPeople(null);
253
+ assert.equal(surface.peopleOpen(), false);
254
+ assert.equal(at(host.wire(), 'dock/dock/buttons/people').s.gone, true);
255
+ surface.dispose();
256
+ resetUiTrees();
257
+ }
258
+ });
259
+
260
+ await test('surface: a person\'s actions, Report behind its confirm, more, the party line', () => {
261
+ resetUiTrees();
262
+ const host = makeHost();
263
+ const surface = makeSurface(host, VIEWS.portrait);
264
+ surface.setPeople(PEOPLE, 'Your party · 2');
265
+ host.event('dock/dock/buttons/people#tap');
266
+ const row = (key) => at(host.wire(), `dock/dock/people/body/p:${key}`);
267
+ // The first action beside the name (Find is not gold), the rest behind ⋯.
268
+ assert.deepEqual(row('p2').c[0].c.map((n) => n.k), ['words', 'a:find', 'more']);
269
+ assert.equal(at(row('p2'), 'x/row/words/name').text, '★ bo');
270
+ assert.equal(at(row('p2'), 'x/row/words/where').text, 'By the fountain');
271
+ assert.equal(at(row('p2'), 'x/row/a:find').s.bg, 'transparent');
272
+ assert.equal(at(row('f9'), 'x/row/a:join').s.bg, 'gold');
273
+ assert.equal(at(row('p2'), 'x/row/more').label, 'More for bo');
274
+ host.event('dock/dock/people/body/p:p2/row/more#tap');
275
+ assert.deepEqual(at(row('p2'), 'x/more').c.map((n) => words(n)), ['Invite', 'Report']);
276
+ // A `where` moving alone keeps the row's state (as the DOM's setWhere).
277
+ surface.setPeople(PEOPLE.map((p) => (p.key === 'p2' ? { ...p, where: 'At the pier' } : p)), 'Your party · 2');
278
+ assert.equal(at(row('p2'), 'x/row/words/where').text, 'At the pier');
279
+ assert(at(row('p2'), 'x/more'), 'still expanded');
280
+ // Report asks first; Cancel goes back.
281
+ host.event('dock/dock/people/body/p:p2/more/a:report#tap');
282
+ assert.equal(at(row('p2'), 'x/row/words/name').text, 'Report bo?');
283
+ assert.deepEqual(row('p2').c[0].c.map((n) => n.k), ['words', 'report', 'cancel']);
284
+ assert.equal(surface.peopleOpen(), true);
285
+ host.event('dock/dock/people/body/p:p2/row/cancel#tap');
286
+ assert.equal(at(row('p2'), 'x/row/words/name').text, '★ bo');
287
+ // Report confirmed: the list shuts and the report is made.
288
+ host.event('dock/dock/people/body/p:p3/row/a:report#tap');
289
+ host.event('dock/dock/people/body/p:p3/row/report#tap');
290
+ assert.equal(surface.peopleOpen(), false);
291
+ // Another action: the list shuts, then the action.
292
+ host.event('dock/dock/buttons/people#tap');
293
+ host.event('dock/dock/people/body/p:p2/row/a:find#tap');
294
+ assert.equal(surface.peopleOpen(), false);
295
+ // The party line and Leave party (the list stays open).
296
+ host.event('dock/dock/buttons/people#tap');
297
+ assert.equal(at(host.wire(), 'dock/dock/people/body/party/row/line').text, 'Your party · 2');
298
+ host.event('dock/dock/people/body/party/row/leave#tap');
299
+ assert.equal(surface.peopleOpen(), true);
300
+ // The roster changing (a new name) forgets a row's more and confirm.
301
+ host.event('dock/dock/people/body/p:p2/row/more#tap');
302
+ surface.setPeople([...PEOPLE, { key: 'p5', playerId: 'p5', username: 'fy', actions: [] }], 'Your party · 2');
303
+ assert.equal(at(row('p2'), 'x/more'), null);
304
+ assert.deepEqual(host.calls, [
305
+ ['open', 'people'], ['open', null], ['report', 'p3'],
306
+ ['open', 'people'], ['open', null], ['person', 'p2', 'find'],
307
+ ['open', 'people'], ['leave'],
308
+ ]);
309
+ surface.dispose();
310
+ resetUiTrees();
311
+ });
312
+
313
+ await test('surface: the companion badge, hidden while a list or another panel is open', () => {
314
+ resetUiTrees();
315
+ const host = makeHost();
316
+ const surface = makeSurface(host, VIEWS.portrait);
317
+ const badge = () => at(host.wire(), 'dock/dock/buttons/companion');
318
+ assert.equal(badge(), null);
319
+ surface.setDoors(DOORS);
320
+ surface.setCompanionBadge(true, 'Biscuit', () => host.calls.push(['companion']));
321
+ assert.equal(badge().label, 'Chat with Biscuit');
322
+ assert.equal(badge().c[0].t, 'icon');
323
+ assert.equal(Boolean(badge().s.gone), false);
324
+ host.event('dock/dock/buttons/companion#tap');
325
+ host.event('dock/dock/buttons/doors#tap');
326
+ assert.equal(badge().s.gone, true, 'a list is open');
327
+ host.event('dock#cancel');
328
+ assert.equal(badge().s.gone, false);
329
+ surface.setBadgeBlocked(true);
330
+ assert.equal(badge().s.gone, true, 'talk, the picker, quick chat or emotes');
331
+ surface.setBadgeBlocked(false);
332
+ surface.setHidden(true);
333
+ assert.equal(at(host.wire(), 'dock/dock').s.hidden, true, 'a compact picker over the dock');
334
+ surface.setCompanionBadge(false);
335
+ assert.equal(badge(), null);
336
+ assert.equal(host.event('dock/dock/buttons/companion#tap'), false, 'gone with its badge');
337
+ assert.deepEqual(host.calls, [['companion'], ['open', 'doors'], ['open', null]]);
338
+ surface.dispose();
339
+ resetUiTrees();
340
+ });
341
+
342
+ await test('the buttons wrap in reverse as the DOM\'s wrap-reverse: on a narrow phone People sits above Doors', () => {
343
+ resetUiTrees();
344
+ let view = { landscape: false, safeInsets: true, w: 390 };
345
+ const host2 = makeHost();
346
+ const dock = makeDockSurface({ view: () => view, onChange: (open) => host2.calls.push(['open', open]) });
347
+ dock.setDoors(DOORS);
348
+ dock.setPeople(PEOPLE);
349
+ const rows = () => {
350
+ const buttons = at(host2.wire(), 'dock/dock/buttons');
351
+ return buttons.t === 'row' ? [buttons.c.filter((n) => !n.s.gone).map((n) => n.k)] : buttons.c.map((row) => row.c.filter((n) => !n.s.gone).map((n) => n.k));
352
+ };
353
+ // Room on a 390 px phone (390 - 130): one line, Doors then People.
354
+ assert.deepEqual(rows(), [['doors', 'people']]);
355
+ // 320 px: they wrap; the first line (Doors) is drawn lowest.
356
+ view = { ...view, w: 320 };
357
+ dock.render();
358
+ assert.equal(at(host2.wire(), 'dock/dock/buttons').t, 'column');
359
+ assert.deepEqual(rows(), [['people'], ['doors']]);
360
+ assert.deepEqual(at(host2.wire(), 'dock/dock/buttons').c.map((r) => r.k), ['l1', 'l0']);
361
+ assert.deepEqual(validate(host2.wire()), []);
362
+ // Wrapped, the buttons still work.
363
+ assert.equal(host2.event('dock/dock/buttons/l1/people#tap'), true);
364
+ assert.equal(dock.peopleOpen(), true);
365
+ dock.cancel();
366
+ // Measured widths win over the estimate: the badge is the one that wraps.
367
+ view = { ...view, w: 390 };
368
+ dock.setCompanionBadge(true, 'Biscuit', () => {});
369
+ dock.setButtonWidths({ doors: 100, people: 120, companion: 44 });
370
+ assert.deepEqual(rows(), [['companion'], ['doors', 'people']]);
371
+ dock.setButtonWidths(null);
372
+ assert.deepEqual(rows(), [['doors', 'people', 'companion']]);
373
+ // On its side the dock has min(24vw, 160) px: People above Doors there too.
374
+ view = { landscape: true, safeInsets: true, w: 844 };
375
+ dock.render();
376
+ assert.deepEqual(rows(), [['companion'], ['people'], ['doors']]);
377
+ // Bytes do not move across rebuilds with fresh closures.
378
+ const state = { ...dock.state };
379
+ assert.equal(serialize(buildDock(state, { doors: () => 1 }), 'dock').json, serialize(buildDock(state, { doors: () => 2 }), 'dock').json);
380
+ // The line rule itself: in order, a new line when the next does not fit.
381
+ assert.deepEqual(dockLines([{ key: 'a', w: 100 }, { key: 'b', w: 100 }, { key: 'c', w: 44 }], { w: 360 }), [['a', 'b'], ['c']]);
382
+ assert.deepEqual(dockLines([{ key: 'a', w: 100 }, { key: 'b', w: 100 }], { w: 0 }), [['a', 'b']], 'unknown width: one line');
383
+ dock.dispose();
384
+ resetUiTrees();
385
+ });
386
+
387
+ await test('the surface loads and runs in a process that never had a DOM', () => {
388
+ const probe = `
389
+ if (globalThis.document || globalThis.window) throw new Error('a DOM');
390
+ const { setUiTreeSink, dispatchUiEvent } = await import(${JSON.stringify(new URL('../code/client/uiTree.js', import.meta.url).href)});
391
+ const { makeDockSurface } = await import(${JSON.stringify(new URL('../code/client/dockSurface.js', import.meta.url).href)});
392
+ const seen = [];
393
+ setUiTreeSink((name, wire) => seen.push(name + ':' + (wire ? wire.c[0].c.length : null)), { dom: false });
394
+ const surface = makeDockSurface({ view: () => ({ landscape: true, safeInsets: true }), onJumpDoor: (door) => seen.push('jump:' + door.id) });
395
+ surface.setDoors([{ id: 'race', title: 'Race' }]);
396
+ dispatchUiEvent('dock', 'dock/dock/buttons/doors#tap', {});
397
+ dispatchUiEvent('dock', 'dock/dock/doors/body/d:race/go#tap', {});
398
+ surface.dispose();
399
+ console.log(seen.join(' '));
400
+ `;
401
+ assert.equal(execFileSync(process.execPath, ['--input-type=module', '-e', probe], { encoding: 'utf8' }).trim(), 'dock:1 dock:1 dock:2 dock:1 jump:race dock:null');
402
+ });
403
+
404
+ console.log(`dock surface: ${passed} checks passed`);
@@ -4,7 +4,7 @@ import { readManifest, publicPlace } from '../code/server/manifest.js';
4
4
  import { makeDoorErrors } from '../code/client/doorErrors.js';
5
5
  const calls = [], entry = { arrived: true };
6
6
  const h = { place: { result: {} }, sim: { timeMs: 1000 }, players: new Map([['p', entry]]),
7
- session: { hub: { track: (id, e) => { calls.push([id, e]); return Promise.resolve(true); } } } };
7
+ session: { hub: { track: (id, e) => { calls.push([id, e]); return true; } } } };
8
8
  D.arrive(h, [{ playerId: 'p' }]);
9
9
  D.arrive(h, [{ playerId: 'p' }]);
10
10
  assert.equal(calls.length, 1);