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,174 @@
1
+ // The "Stuck?" chip surface (`code/client/stuckSurface.js`) and its tree
2
+ // (`stuckTree.js`): the chip as the `stuck` UI tree root, with no DOM, for a
3
+ // native host. Checks that the trees validate, portrait and landscape; that
4
+ // bytes and binding ids do not move across rebuilds with fresh closures; that
5
+ // it hides under quick chat, the emote row, People, Doors and talk; that a
6
+ // press reaches the handler (the hub system's `unstick`, `{ k: 'hub-unstick'
7
+ // }`) only while it is drawn; and that the host's placement (`chipShift`, as
8
+ // chrome.js `placeStuckChip` runs it) becomes the same bottom edge less the
9
+ // shift, or no chip where there is no room.
10
+ import assert from 'node:assert/strict';
11
+ import { execFileSync } from 'node:child_process';
12
+ import { readFileSync } from 'node:fs';
13
+ import { dispatchUiEvent, resetUiTrees, serialize, setUiTreeSink, validate } from '../code/client/uiTree.js';
14
+ import { STUCK_AVOID, STUCK_BOTTOM, buildStuck, stuckChipShift, stuckChipSpot, stuckShown } from '../code/client/stuckTree.js';
15
+ import { makeStuckSurface } from '../code/client/stuckSurface.js';
16
+ import { chipShift, stuckText } from '../code/client/stuck.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 TEXT = stuckText('the square');
25
+ const NONE = { say: false, emotes: false, people: false, doors: false, talk: false };
26
+ // Portrait and landscape phones (CSS px), with their safe insets.
27
+ const VIEWS = { portrait: { w: 390, h: 844, insets: { bottom: 34 } }, landscape: { w: 844, h: 390, insets: { bottom: 21 } } };
28
+ const SIZE = { w: 180, h: 33 };
29
+
30
+ function makeHost() {
31
+ resetUiTrees();
32
+ const host = { roots: [], sent: [] };
33
+ setUiTreeSink((name, wire, handlers) => {host.roots.push({ name, wire, handlers });}, { dom: false });
34
+ host.surface = makeStuckSurface();
35
+ host.wire = () => host.roots.filter((r) => r.name === 'stuck').at(-1)?.wire ?? null;
36
+ host.chip = () => host.wire()?.c?.[0] ?? null;
37
+ host.press = () => dispatchUiEvent('stuck', 'stuck/chip#tap', null);
38
+ // The hub system's `unstick` (its rate limit and trip rule aside).
39
+ host.unstick = () => host.sent.push({ k: 'hub-unstick' });
40
+ return host;
41
+ }
42
+
43
+ await test('trees validate: no chip, shown, hidden under each panel, placed, no room', () => {
44
+ for (const state of [
45
+ { text: null, open: NONE }, { text: TEXT, open: NONE },
46
+ ...Object.keys(NONE).map((what) => ({ text: TEXT, open: { ...NONE, [what]: true } })),
47
+ { text: TEXT, open: NONE, shift: 0 }, { text: TEXT, open: NONE, shift: 40 }, { text: TEXT, open: NONE, shift: null },
48
+ ]) {
49
+ assert.deepEqual(validate(buildStuck(state, { press() {} }), 'stuck'), [], JSON.stringify(state));
50
+ assert.deepEqual(validate(buildStuck(state), 'stuck'), []);
51
+ }
52
+ });
53
+
54
+ await test('bytes and binding ids do not move across rebuilds with fresh closures', () => {
55
+ for (const state of [{ text: TEXT, open: NONE }, { text: TEXT, open: NONE, shift: 12 }]) {
56
+ const one = serialize(buildStuck(state, { press: () => 1 }), 'stuck');
57
+ const two = serialize(buildStuck(state, { press: () => 2 }), 'stuck');
58
+ assert.equal(one.json, two.json);
59
+ assert.deepEqual([...one.handlers.keys()], ['stuck/chip#tap']);
60
+ assert.deepEqual([...two.handlers.keys()], ['stuck/chip#tap']);
61
+ }
62
+ assert.equal(serialize(buildStuck({ text: null, open: NONE }), 'stuck').json, '{"t":"stack","k":"stuck","s":{"font":"ui","size":15,"weight":600,"lh":1.3,"color":"#fff"}}');
63
+ });
64
+
65
+ await test('the DOM\'s words, size and place; hidden under the panels it yields to', () => {
66
+ const chip = buildStuck({ text: TEXT, open: NONE }).c[0];
67
+ assert.deepEqual([chip.t, chip.k, chip.hub, chip.report, chip.fire, chip.c[0].text], ['button', 'chip', 'stuck', true, 'down', 'Stuck? Tap to go to the square']);
68
+ assert.deepEqual(chip.at, { anchor: 'bottom', bottom: [202, 192], avoid: STUCK_AVOID, avoidHide: true });
69
+ assert.deepEqual(chip.s, {
70
+ box: 'border', w: 'wrap', maxW: [{ vw: 100, px: -170 }], pad: [9, 12], radius: 18,
71
+ border: { w: 1, c: 'line45' }, bg: 'toast', color: '#fff', size: 12, weight: 600, lh: 'normal', talign: 'center', gone: false,
72
+ });
73
+ for (const what of Object.keys(NONE)) {
74
+ const hidden = buildStuck({ text: TEXT, open: { ...NONE, [what]: true } }).c[0];
75
+ assert.deepEqual([hidden.s.gone, hidden.on], [true, undefined], what);
76
+ assert.equal(stuckShown({ text: TEXT, open: { ...NONE, [what]: true } }), false);
77
+ }
78
+ const chrome = readFileSync(new URL('../code/client/chrome.js', import.meta.url), 'utf8');
79
+ for (const piece of [
80
+ "bottom: 'max(202px, calc(env(safe-area-inset-bottom) + 192px))', left: '50%', transform: 'translateX(-50%)', pointerEvents: 'auto', padding: '9px 12px', borderRadius: '18px', border: '1px solid rgba(255,255,255,0.45)', background: 'rgba(20,16,12,0.8)', color: '#fff', font: '600 12px system-ui, sans-serif'",
81
+ "width: 'max-content', maxWidth: 'calc(100vw - 170px)', textAlign: 'center'",
82
+ 'const show = Boolean(text) && !sayOpen && !emotesOpen && !peopleOpen && !doorsOpen && !talkOpen;',
83
+ "chip.addEventListener('pointerdown', (event) => {",
84
+ ]) {
85
+ assert(chrome.includes(piece), piece);
86
+ }
87
+ const hub = readFileSync(new URL('../code/systems/hub.js', import.meta.url), 'utf8');
88
+ assert(hub.includes("if (shown && !this.stuckShown) {\n Hub.hub.stuckTo = null;\n scene.multiplayer?.net?.send({ k: 'hub-unstick', ask: true });"));
89
+ assert(hub.includes("this.sendJump(net, { k: 'hub-unstick' });"));
90
+ });
91
+
92
+ await test('placement: the host\'s chipShift is the bottom edge less the shift, portrait and landscape; no room is no chip', () => {
93
+ for (const view of Object.values(VIEWS)) {
94
+ const spot = stuckChipSpot(SIZE, view);
95
+ const hang = Math.max(202, view.insets.bottom + 192);
96
+ assert.deepEqual(spot, { left: (view.w - SIZE.w) / 2, right: (view.w + SIZE.w) / 2, top: view.h - hang - SIZE.h, bottom: view.h - hang });
97
+ // Clear: it stays where it hangs.
98
+ assert.equal(stuckChipShift(spot, [], [], view.h), 0);
99
+ // A HUD reaching down over it: moved to 6 px under the HUD.
100
+ const hud = { left: spot.left - 20, right: spot.right + 20, top: 0, bottom: spot.top + 10 };
101
+ const down = stuckChipShift(spot, [hud], [], view.h);
102
+ assert.equal(down, hud.bottom + 6 - spot.top);
103
+ assert.equal(down, chipShift(spot, [hud], [], view.h));
104
+ const chip = buildStuck({ text: TEXT, open: NONE, shift: down }).c[0];
105
+ assert.deepEqual(chip.at, { anchor: 'bottom', bottom: [STUCK_BOTTOM[0] - down, STUCK_BOTTOM[1] - down] });
106
+ // max(202 - d, inset + 192 - d) is where the DOM's translate puts it.
107
+ assert.equal(view.h - Math.max(chip.at.bottom[0], view.insets.bottom + chip.at.bottom[1]), spot.bottom + down);
108
+ // Moved onto another control: not drawn.
109
+ const control = { left: spot.left, right: spot.right, top: spot.bottom + down - 5, bottom: spot.bottom + down + 40 };
110
+ assert.equal(stuckChipShift(spot, [hud], [control], view.h), null);
111
+ const none = buildStuck({ text: TEXT, open: NONE, shift: null }).c[0];
112
+ assert.deepEqual([none.s.gone, none.on, none.at.avoid], [true, undefined, undefined]);
113
+ }
114
+ });
115
+
116
+ await test('events: a press reaches the handler only while the chip is drawn', () => {
117
+ const host = makeHost();
118
+ assert.equal(host.wire().c, undefined, 'no words, no chip');
119
+ host.surface.stuckPrompt(TEXT, () => host.unstick());
120
+ assert.equal(host.surface.shown(), true);
121
+ assert.equal(host.press(), true);
122
+ assert.deepEqual(host.sent, [{ k: 'hub-unstick' }]);
123
+ // Hidden under each panel in turn: no binding, nothing sent.
124
+ for (const what of Object.keys(NONE)) {
125
+ host.surface.setOpen({ [what]: true });
126
+ assert.equal(host.chip().s.gone, true, what);
127
+ assert.equal(host.press(), false, what);
128
+ host.surface.setOpen({ [what]: false });
129
+ }
130
+ // Placed by the host, then no room, then back to the renderer's avoid.
131
+ host.surface.place(24);
132
+ assert.deepEqual(host.chip().at, { anchor: 'bottom', bottom: [178, 168] });
133
+ host.press();
134
+ host.surface.place(null);
135
+ assert.equal(host.chip().s.gone, true);
136
+ assert.equal(host.press(), false);
137
+ host.surface.place(undefined);
138
+ assert.deepEqual(host.chip().at.avoid, STUCK_AVOID);
139
+ // New words keep the binding; null hides the chip and keeps the handler.
140
+ host.surface.stuckPrompt('Stuck? Tap to get unstuck');
141
+ assert.equal(host.chip().c[0].text, 'Stuck? Tap to get unstuck');
142
+ host.press();
143
+ host.surface.stuckPrompt(null);
144
+ assert.equal(host.wire().c, undefined);
145
+ assert.equal(host.surface.shown(), false);
146
+ host.surface.stuckPrompt(TEXT);
147
+ host.press();
148
+ assert.deepEqual(host.sent, [{ k: 'hub-unstick' }, { k: 'hub-unstick' }, { k: 'hub-unstick' }, { k: 'hub-unstick' }]);
149
+ const count = host.roots.length;
150
+ host.surface.render();
151
+ host.surface.stuckPrompt(TEXT);
152
+ assert.equal(host.roots.length, count, 'nothing changed, nothing sent');
153
+ host.surface.dispose();
154
+ assert.equal(host.wire(), null);
155
+ resetUiTrees();
156
+ });
157
+
158
+ await test('the surface loads and runs in a process that never had a DOM', () => {
159
+ const probe = `
160
+ if (globalThis.document || globalThis.window) throw new Error('a DOM');
161
+ const { setUiTreeSink, dispatchUiEvent } = await import(${JSON.stringify(new URL('../code/client/uiTree.js', import.meta.url).href)});
162
+ const { makeStuckSurface } = await import(${JSON.stringify(new URL('../code/client/stuckSurface.js', import.meta.url).href)});
163
+ const seen = [];
164
+ setUiTreeSink((name, wire) => seen.push(name + ':' + (wire ? (wire.c ?? []).length : null)), { dom: false });
165
+ const surface = makeStuckSurface();
166
+ surface.stuckPrompt(${JSON.stringify(TEXT)}, () => seen.push('unstick'));
167
+ dispatchUiEvent('stuck', 'stuck/chip#tap', null);
168
+ surface.dispose();
169
+ console.log(seen.join(' '));
170
+ `;
171
+ assert.equal(execFileSync(process.execPath, ['--input-type=module', '-e', probe], { encoding: 'utf8' }).trim(), 'stuck:0 stuck:1 unstick stuck:null');
172
+ });
173
+
174
+ console.log(`stuck surface: ${passed} checks passed`);
@@ -1187,6 +1187,14 @@ const State = await import('../code/client/state.js');
1187
1187
  frames(STUCK_AFTER_MS + 1000);
1188
1188
  assert.equal(prompts.some(([text]) => text), false);
1189
1189
  State.hub.held.clear();
1190
+ // A sheet open (Rowan's first-visit talk panel, a card, an ask, a menu):
1191
+ // walk keys under it are no walk that got nowhere.
1192
+ for (const open of [{ talk: { talking: () => true } }, { carded: true }, { askInput: {} }, { menuInput: {} }]) {
1193
+ Object.assign(system, open);
1194
+ frames(STUCK_AFTER_MS + 1000);
1195
+ assert.equal(prompts.some(([text]) => text), false, JSON.stringify(Object.keys(open)));
1196
+ delete system.talk; system.carded = false; delete system.askInput; delete system.menuInput;
1197
+ }
1190
1198
  // A hidden page: frames drawn there count for nothing.
1191
1199
  globalThis.document.visibilityState = 'hidden';
1192
1200
  frames(STUCK_AFTER_MS + 1000);
@@ -1420,6 +1428,29 @@ test('refused in a game place, whatever the deck says', () => {
1420
1428
  assert.deepEqual(game.at('p1'), FAR);
1421
1429
  });
1422
1430
 
1431
+ test('v1.190: a hold with turnCamera tells the held player its facing, and again at release; without it nothing is sent', () => {
1432
+ const b = boot();
1433
+ const faces = () => b.sent.filter(([, m]) => m.k === 'hub-hold-face');
1434
+ b.ctx().hold('p1', { x: 3, y: 1, z: 3 }, 90);
1435
+ b.ctx().release('p1');
1436
+ assert.deepEqual(faces(), [], 'an ordinary hold sends nothing new');
1437
+ b.ctx().hold('p1', { x: 3, y: 1, z: 3 }, 90, { turnCamera: true });
1438
+ assert.equal(faces().length, 1);
1439
+ assert.equal(faces()[0][0], 'p1');
1440
+ assert.ok(Math.abs(faces()[0][1].facing - Math.PI / 2) < 1e-9, 'radians, as hub-jumped');
1441
+ b.ctx().release('p1');
1442
+ assert.equal(faces().length, 2, 'release turns it again');
1443
+ assert.deepEqual(faces()[1], faces()[0]);
1444
+ b.ctx().release('p1');
1445
+ assert.equal(faces().length, 2, 'a second release sends nothing');
1446
+ b.ctx().hold('p1', undefined, undefined, { turnCamera: true });
1447
+ b.ctx().hold('p1');
1448
+ b.ctx().release('p1');
1449
+ assert.equal(faces().length, 3, 'a plain hold replacing it takes the release turn away');
1450
+ b.ctx().hold('p1', undefined, undefined, { turnCamera: 'yes' });
1451
+ assert.equal(faces().length, 3, 'only true opts in');
1452
+ });
1453
+
1423
1454
  test('refused for a held player, one who has not arrived, one who has ended, one not here', () => {
1424
1455
  const b = boot({ hub: { stuck: true } });
1425
1456
  b.ctx().hold('p1', { x: 3, y: 1, z: 3 });
@@ -15,6 +15,11 @@
15
15
  // longer binds `cancel` (a host's Back went to a talk panel that was not
16
16
  // there). The web never drew that binding (`uiDom.js` wires events on
17
17
  // buttons and fields only), so its DOM writes are unchanged.
18
+ //
19
+ // A second: the panel, which holds the field, is anchored `ime: true`, so
20
+ // it rides above the keyboard on every renderer (as the text ask's and
21
+ // quick chat's cards do), not only where the view's inset holds the
22
+ // keyboard. Nothing else in a root moves, and the DOM writes are unchanged.
18
23
  // `RECORD=1` writes the recording anew.
19
24
  import assert from 'node:assert/strict';
20
25
  import { createHash } from 'node:crypto';
@@ -206,13 +211,16 @@ async function run(how, viewName) {
206
211
  return { record: rig.record, ...(dom ? { dom: digest(dom.log), writes: dom.log.length } : {}) };
207
212
  }
208
213
 
209
- // The recording with the one deliberate change: a closed panel's root binds
210
- // no `cancel`.
211
- function closedHasNoCancel(record) {
214
+ // The recording with the deliberate changes: a closed panel's root binds
215
+ // no `cancel`, and the panel's place rides above the keyboard.
216
+ function withDeliberateChanges(record) {
212
217
  return record.map((entry) => {
213
218
  if (entry[0] !== 'root' || entry[1] === 'null') {return entry;}
214
219
  const wire = JSON.parse(entry[1]);
215
- if (!wire.c[0].s.gone) {return entry;}
220
+ assert.equal(wire.c[0].k, 'panel');
221
+ assert.equal(wire.c[0].at.ime, undefined, 'the recording had no ime');
222
+ wire.c[0].at.ime = true;
223
+ if (!wire.c[0].s.gone) {return ['root', JSON.stringify(wire), entry[2], entry[3]];}
216
224
  assert.deepEqual(wire.on, { cancel: 'talk#cancel' }, 'the recording bound cancel while closed');
217
225
  delete wire.on;
218
226
  return ['root', JSON.stringify(wire), entry[2], entry[3].filter((id) => id !== 'talk#cancel')];
@@ -232,7 +240,7 @@ if (RECORD) {
232
240
  for (const [how, viewName] of runs) {
233
241
  const want = fixture[`${how}:${viewName}`];
234
242
  const got = await run(how, viewName);
235
- assert.deepEqual(got.record, closedHasNoCancel(want.record), `${how} ${viewName}: the chrome tells the host what it was recorded telling`);
243
+ assert.deepEqual(got.record, withDeliberateChanges(want.record), `${how} ${viewName}: the chrome tells the host what it was recorded telling`);
236
244
  if (how === 'dom') {
237
245
  assert.equal(got.writes, want.writes, `${how} ${viewName}: the recorded DOM writes`);
238
246
  assert.equal(got.dom, want.dom, `${how} ${viewName}: the recorded DOM bytes`);
@@ -240,7 +248,7 @@ if (RECORD) {
240
248
  passed += 1;
241
249
  if (how === 'host') {
242
250
  const surface = await run('surface', viewName);
243
- assert.deepEqual(surface.record, closedHasNoCancel(want.record), `${viewName}: talk.js over the surface alone tells the host the same`);
251
+ assert.deepEqual(surface.record, withDeliberateChanges(want.record), `${viewName}: talk.js over the surface alone tells the host the same`);
244
252
  passed += 1;
245
253
  }
246
254
  }
@@ -255,6 +263,15 @@ if (RECORD) {
255
263
  assert.equal(buildTalk(view.state, { on }).on.cancel, on.end, 'open');
256
264
  view.closeTalk();
257
265
  assert.equal(buildTalk(view.state, { on }).on, undefined, 'closed');
266
+ // The panel holds the field and rides above the keyboard in every place:
267
+ // portrait, landscape, and the desktop's left corner with or without
268
+ // safe insets.
269
+ for (const env of [{}, { landscape: true, w: 844 }, { desktop: true }, { desktop: true, safeInsets: true }]) {
270
+ const panel = buildTalk(view.state, { ...env, on }).c[0];
271
+ assert.equal(panel.k, 'panel');
272
+ assert.equal(panel.at.ime, true, JSON.stringify(env));
273
+ assert(panel.c.some((n) => n.k === 'form' && n.c.some((f) => f.t === 'field')), JSON.stringify(env));
274
+ }
258
275
  resetUiTrees();
259
276
  const { makeTalkSurface } = await import('../code/client/talkSurface.js');
260
277
  const surface = makeTalkSurface({ view: () => ({ landscape: false, desktop: false, w: 390, safeInsets: false }) });
@@ -0,0 +1,123 @@
1
+ // A talk panel opened on a desktop keyboard focuses its field, and until the
2
+ // player types in it or points at it the movement keys are still the game's
3
+ // (Rowan's first-visit sheet opens on arrival, and nobody is held): W, the
4
+ // arrows and Space reach the page unentered and the field is not typing; a
5
+ // letter goes to the field and from then on every key is the field's.
6
+ import assert from 'node:assert/strict';
7
+ import { readFile } from 'node:fs/promises';
8
+ import { fileURLToPath } from 'node:url';
9
+ import { chromium } from 'playwright-core';
10
+ import { launchChromium, logRenderer } from '../../../experiments/hub-town/qa/launch.mjs';
11
+
12
+ const root = new URL('../../../', import.meta.url);
13
+ const browser = await launchChromium(chromium, { executablePath: process.env.CHROME });
14
+ try {
15
+ const page = await browser.newPage();
16
+ await page.route('http://walk.test/**', async (route) => {
17
+ const pathname = new URL(route.request().url()).pathname;
18
+ if (pathname === '/') {return route.fulfill({ contentType: 'text/html', body: '<body style="margin:0"></body>' });}
19
+ const url = new URL(`.${pathname}`, root);
20
+ assert(fileURLToPath(url).startsWith(fileURLToPath(root)));
21
+ await route.fulfill({ contentType: 'text/javascript', body: await readFile(url, 'utf8') });
22
+ });
23
+ await page.setViewportSize({ width: 1280, height: 800 });
24
+ await page.goto('http://walk.test/');
25
+ await logRenderer(page, 'talk walk');
26
+ await page.evaluate(async () => {
27
+ const { makeChrome } = await import('/kits/hub-game/code/client/chrome.js');
28
+ const chrome = makeChrome({ avatarCount: 4, onBack() {}, onAvatar() {} });
29
+ // What the engine's window listeners see (physics-3d `playerRun.js`).
30
+ const seen = [];
31
+ window.addEventListener('keydown', (event) => seen.push(`down ${event.code}`));
32
+ window.addEventListener('keyup', (event) => seen.push(`up ${event.code}`));
33
+ const input = () => document.querySelector('input[name="say"]');
34
+ globalThis.__walk = {
35
+ chrome, seen, input,
36
+ state: () => ({ focused: document.activeElement === input(), typing: chrome.talkFocused(), value: input().value, seen: seen.splice(0) }),
37
+ };
38
+ chrome.openTalk('Rowan', { mind: true });
39
+ });
40
+ const state = () => page.evaluate(() => globalThis.__walk.state());
41
+ // A walk key's release always reaches the page; its press only while untouched.
42
+ const downs = (st) => st.seen.filter((e) => e.startsWith('down'));
43
+ assert.equal(await page.evaluate(() => matchMedia('(pointer: fine)').matches && !(navigator.maxTouchPoints > 0)), true, 'a desktop page');
44
+
45
+ let s = await state();
46
+ assert.equal(s.focused, true, 'the field is focused as it appears');
47
+ assert.equal(s.typing, false, 'a focused, untouched field is not typing');
48
+
49
+ await page.keyboard.down('w');
50
+ await page.keyboard.down('w');
51
+ await page.keyboard.up('w');
52
+ for (const key of ['ArrowLeft', 'ArrowUp', ' ', 'd']) {await page.keyboard.press(key);}
53
+ s = await state();
54
+ assert.equal(s.value, '', 'walk keys are not entered');
55
+ assert.deepEqual(s.seen, ['down KeyW', 'down KeyW', 'up KeyW', 'down ArrowLeft', 'up ArrowLeft', 'down ArrowUp', 'up ArrowUp', 'down Space', 'up Space', 'down KeyD', 'up KeyD'], 'the page sees them');
56
+ assert.equal(s.focused && !s.typing, true);
57
+
58
+ // Shift is a capital: the field's.
59
+ await page.keyboard.press('Shift+W');
60
+ s = await state();
61
+ assert.equal(s.value, 'W');
62
+ assert.equal(s.typing, true);
63
+ assert.equal(s.seen.includes('down KeyW'), false, 'only its release reaches the page');
64
+
65
+ // A letter goes to the field, and then W is a letter too.
66
+ await page.evaluate(() => {globalThis.__walk.chrome.closeTalk(); globalThis.__walk.chrome.openTalk('Rowan', { mind: true });});
67
+ s = await state();
68
+ assert.equal(s.focused && !s.typing && s.value === '', true, 'reopened: untouched again');
69
+ await page.keyboard.type('hi w');
70
+ s = await state();
71
+ assert.equal(s.value, 'hi w');
72
+ assert.equal(s.typing, true, 'typed into: typing');
73
+ assert.deepEqual(downs(s), [], 'no press reached the page');
74
+ // Emptied again, it stays the field's.
75
+ for (let i = 0; i < 4; i++) {await page.keyboard.press('Backspace');}
76
+ await page.keyboard.press('s');
77
+ s = await state();
78
+ assert.equal(s.value, 's');
79
+ assert.deepEqual(downs(s), []);
80
+
81
+ // Pointing at the field makes it the player's: W types.
82
+ await page.evaluate(() => {globalThis.__walk.chrome.closeTalk(); globalThis.__walk.chrome.openTalk('Rowan', { mind: true });});
83
+ await state();
84
+ await page.click('input[name="say"]');
85
+ await page.keyboard.press('w');
86
+ s = await state();
87
+ assert.equal(s.value, 'w');
88
+ assert.equal(s.typing, true);
89
+ assert.deepEqual(downs(s), []);
90
+
91
+ // A W held across the first letter still lets go on the page.
92
+ await page.evaluate(() => {globalThis.__walk.chrome.closeTalk(); globalThis.__walk.chrome.openTalk('Rowan', { mind: true });});
93
+ await state();
94
+ await page.keyboard.down('w');
95
+ await page.keyboard.press('h');
96
+ await page.keyboard.up('w');
97
+ s = await state();
98
+ assert.equal(s.value, 'h');
99
+ assert.deepEqual(s.seen, ['down KeyW', 'up KeyW']);
100
+
101
+ // A W held before the sheet opens is let go on the page when it is
102
+ // released into the focused field, typed into or not.
103
+ for (const type of [false, true]) {
104
+ await page.evaluate(() => {globalThis.__walk.chrome.closeTalk(); document.activeElement?.blur?.();});
105
+ await page.keyboard.down('w');
106
+ await page.evaluate(() => globalThis.__walk.chrome.openTalk('Rowan', { mind: true }));
107
+ if (type) {await page.keyboard.press('h');}
108
+ await page.keyboard.up('w');
109
+ s = await state();
110
+ assert.equal(s.focused, true);
111
+ assert.equal(s.seen.at(-1), 'up KeyW', `held across the open${type ? ' and a letter' : ''}`);
112
+ }
113
+
114
+ // Enter and Escape keep their meaning in an untouched field.
115
+ await page.evaluate(() => {globalThis.__walk.chrome.closeTalk(); globalThis.__walk.chrome.openTalk('Rowan', { mind: true });});
116
+ await state();
117
+ await page.keyboard.press('Escape');
118
+ s = await state();
119
+ assert.deepEqual(s.seen, [], 'Escape is the field\'s');
120
+ console.log('test-talk-walk-dom: ok');
121
+ } finally {
122
+ await browser.close();
123
+ }