castle-web-cli 0.4.239 → 0.4.241

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 (396) 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/multiplayerDoc.d.ts +1 -1
  18. package/dist/multiplayerDoc.js +2 -0
  19. package/dist/platformDoc.js +3 -2
  20. package/dist/playPagePolicy.js +5 -1
  21. package/dist/resetLeaderboards.d.ts +8 -1
  22. package/dist/resetLeaderboards.js +43 -8
  23. package/dist/roomLogs.d.ts +1 -0
  24. package/dist/roomLogs.js +30 -6
  25. package/dist/save-deck.d.ts +32 -2
  26. package/dist/save-deck.js +240 -39
  27. package/kits/base/CLAUDE.md +1 -1
  28. package/kits/base/castle.json +1 -1
  29. package/kits/base/sdk/README.md +174 -6
  30. package/kits/base/sdk/analytics.d.ts +8 -0
  31. package/kits/base/sdk/analytics.js +92 -0
  32. package/kits/base/sdk/castle.d.ts +5 -1
  33. package/kits/base/sdk/castle.js +2 -0
  34. package/kits/base/sdk/commands.d.ts +48 -0
  35. package/kits/base/sdk/commands.js +1 -0
  36. package/kits/base/sdk/debugConsole.d.ts +17 -0
  37. package/kits/base/sdk/debugConsole.js +154 -0
  38. package/kits/base/sdk/experiments.js +24 -1
  39. package/kits/base/sdk/hostRetry.d.ts +7 -0
  40. package/kits/base/sdk/hostRetry.js +57 -0
  41. package/kits/base/sdk/hub.d.ts +20 -2
  42. package/kits/base/sdk/hub.js +99 -13
  43. package/kits/base/sdk/multiplayer.d.ts +2 -0
  44. package/kits/base/sdk/multiplayer.js +168 -26
  45. package/kits/base/sdk/reconnectBudget.d.ts +6 -0
  46. package/kits/base/sdk/reconnectBudget.js +41 -1
  47. package/kits/base/sdk/runtime.js +36 -19
  48. package/kits/base/sdk/server/hub.d.ts +19 -0
  49. package/kits/base/sdk/server/hub.js +12 -0
  50. package/kits/base/sdk/server/platformHandle.d.ts +1 -0
  51. package/kits/base/sdk/server/wrapper.d.ts +1 -1
  52. package/kits/base/sdk/server/wrapper.js +26 -1
  53. package/kits/base/sdk/transport.d.ts +2 -1
  54. package/kits/base/sdk/transport.js +35 -0
  55. package/kits/hub-game/CLAUDE.md +66 -19
  56. package/kits/hub-game/code/client/act.js +9 -6
  57. package/kits/hub-game/code/client/actCore.js +26 -6
  58. package/kits/hub-game/code/client/actGateLog.js +36 -0
  59. package/kits/hub-game/code/client/actionOverflow.js +29 -8
  60. package/kits/hub-game/code/client/actionRailSurface.js +186 -0
  61. package/kits/hub-game/code/client/actionRailTree.js +173 -0
  62. package/kits/hub-game/code/client/askSurface.js +85 -0
  63. package/kits/hub-game/code/client/askTree.js +51 -0
  64. package/kits/hub-game/code/client/attention.js +31 -6
  65. package/kits/hub-game/code/client/ballot.js +42 -5
  66. package/kits/hub-game/code/client/ballotSurface.js +115 -0
  67. package/kits/hub-game/code/client/ballotTree.js +180 -0
  68. package/kits/hub-game/code/client/catchingUp.js +19 -0
  69. package/kits/hub-game/code/client/celebrate.js +66 -0
  70. package/kits/hub-game/code/client/chrome.js +481 -57
  71. package/kits/hub-game/code/client/companion.js +93 -23
  72. package/kits/hub-game/code/client/companionDress.js +1 -1
  73. package/kits/hub-game/code/client/cornerSurface.js +106 -0
  74. package/kits/hub-game/code/client/cornerTree.js +83 -0
  75. package/kits/hub-game/code/client/decor.js +20 -11
  76. package/kits/hub-game/code/client/deviceStorage.js +121 -0
  77. package/kits/hub-game/code/client/disguise.js +23 -0
  78. package/kits/hub-game/code/client/disguiseDraw.js +87 -0
  79. package/kits/hub-game/code/client/dockSurface.js +206 -0
  80. package/kits/hub-game/code/client/dockTree.js +232 -0
  81. package/kits/hub-game/code/client/earned.js +29 -0
  82. package/kits/hub-game/code/client/emoteSurface.js +188 -0
  83. package/kits/hub-game/code/client/emoteTree.js +264 -0
  84. package/kits/hub-game/code/client/farAvatars.js +4 -3
  85. package/kits/hub-game/code/client/fpsTelemetry.js +3 -1
  86. package/kits/hub-game/code/client/grab.js +121 -50
  87. package/kits/hub-game/code/client/holdShow.js +19 -0
  88. package/kits/hub-game/code/client/hookLayer.js +96 -12
  89. package/kits/hub-game/code/client/hubControls.js +7 -1
  90. package/kits/hub-game/code/client/hudSurface.js +11 -3
  91. package/kits/hub-game/code/client/hudTree.js +7 -4
  92. package/kits/hub-game/code/client/idle.js +21 -3
  93. package/kits/hub-game/code/client/invites.js +24 -3
  94. package/kits/hub-game/code/client/keys.js +15 -0
  95. package/kits/hub-game/code/client/labelsNear.js +8 -1
  96. package/kits/hub-game/code/client/layoutCache.js +57 -8
  97. package/kits/hub-game/code/client/loadingCover.js +53 -4
  98. package/kits/hub-game/code/client/menuIcons.js +15 -0
  99. package/kits/hub-game/code/client/menuSurface.js +102 -0
  100. package/kits/hub-game/code/client/menuTree.js +135 -0
  101. package/kits/hub-game/code/client/modelLook.js +41 -0
  102. package/kits/hub-game/code/client/padCues.js +11 -7
  103. package/kits/hub-game/code/client/padReadability.js +3 -3
  104. package/kits/hub-game/code/client/pickerSurface.js +152 -0
  105. package/kits/hub-game/code/client/pickerTree.js +163 -0
  106. package/kits/hub-game/code/client/pushVisit.js +4 -2
  107. package/kits/hub-game/code/client/quality.js +188 -29
  108. package/kits/hub-game/code/client/qualityEntry.js +10 -1
  109. package/kits/hub-game/code/client/quickChatSurface.js +222 -0
  110. package/kits/hub-game/code/client/quickChatTree.js +201 -0
  111. package/kits/hub-game/code/client/rehello.js +75 -0
  112. package/kits/hub-game/code/client/renderVisibility.js +17 -0
  113. package/kits/hub-game/code/client/replay.js +118 -0
  114. package/kits/hub-game/code/client/role.js +3 -0
  115. package/kits/hub-game/code/client/safeLayout.js +441 -56
  116. package/kits/hub-game/code/client/safeStyle.js +13 -10
  117. package/kits/hub-game/code/client/say.js +2 -0
  118. package/kits/hub-game/code/client/soundSurface.js +77 -0
  119. package/kits/hub-game/code/client/soundTree.js +74 -0
  120. package/kits/hub-game/code/client/soundscape.js +12 -9
  121. package/kits/hub-game/code/client/soundscapeCues.js +1 -1
  122. package/kits/hub-game/code/client/state.js +67 -1
  123. package/kits/hub-game/code/client/stuckSurface.js +76 -0
  124. package/kits/hub-game/code/client/stuckTree.js +67 -0
  125. package/kits/hub-game/code/client/talk.js +42 -12
  126. package/kits/hub-game/code/client/talkTree.js +4 -2
  127. package/kits/hub-game/code/client/textAskSurface.js +147 -0
  128. package/kits/hub-game/code/client/textAskTree.js +67 -0
  129. package/kits/hub-game/code/client/tiers.js +252 -27
  130. package/kits/hub-game/code/client/together.js +4 -1
  131. package/kits/hub-game/code/client/uiDom.js +86 -8
  132. package/kits/hub-game/code/client/uiTree.js +33 -4
  133. package/kits/hub-game/code/client/vehicle.js +72 -51
  134. package/kits/hub-game/code/client/weakestTier.js +75 -31
  135. package/kits/hub-game/code/client/wear.js +159 -5
  136. package/kits/hub-game/code/client/worldLabels.js +205 -25
  137. package/kits/hub-game/code/companionSpec.js +4 -2
  138. package/kits/hub-game/code/server/act.js +3 -0
  139. package/kits/hub-game/code/server/actGate.js +83 -0
  140. package/kits/hub-game/code/server/actions.js +71 -15
  141. package/kits/hub-game/code/server/actors.js +20 -5
  142. package/kits/hub-game/code/server/analytics.js +35 -3
  143. package/kits/hub-game/code/server/ask.js +39 -3
  144. package/kits/hub-game/code/server/ballot.js +167 -4
  145. package/kits/hub-game/code/server/celebrate.js +64 -0
  146. package/kits/hub-game/code/server/companion.js +17 -2
  147. package/kits/hub-game/code/server/decor.js +11 -2
  148. package/kits/hub-game/code/server/disguise.js +63 -0
  149. package/kits/hub-game/code/server/earned.js +6 -2
  150. package/kits/hub-game/code/server/friendBests.js +13 -4
  151. package/kits/hub-game/code/server/friendsAmong.js +67 -8
  152. package/kits/hub-game/code/server/grab.js +12 -2
  153. package/kits/hub-game/code/server/heldOffers.js +142 -0
  154. package/kits/hub-game/code/server/holdShow.js +98 -0
  155. package/kits/hub-game/code/server/hub.js +991 -72
  156. package/kits/hub-game/code/server/idle.js +110 -9
  157. package/kits/hub-game/code/server/index.js +9 -0
  158. package/kits/hub-game/code/server/labels.js +13 -3
  159. package/kits/hub-game/code/server/manifest.js +94 -6
  160. package/kits/hub-game/code/server/menu.js +26 -3
  161. package/kits/hub-game/code/server/npcs.js +55 -9
  162. package/kits/hub-game/code/server/observe.js +67 -6
  163. package/kits/hub-game/code/server/players.js +14 -2
  164. package/kits/hub-game/code/server/replay.js +135 -0
  165. package/kits/hub-game/code/server/standing.js +7 -3
  166. package/kits/hub-game/code/server/storageLimit.js +4 -1
  167. package/kits/hub-game/code/server/townDay.js +74 -0
  168. package/kits/hub-game/code/server/vehicle.js +3 -0
  169. package/kits/hub-game/code/server/vis.js +26 -4
  170. package/kits/hub-game/code/server/wallet.js +677 -0
  171. package/kits/hub-game/code/server/wear.js +13 -3
  172. package/kits/hub-game/code/server/writerLease.js +191 -0
  173. package/kits/hub-game/code/shared/act.js +1 -1
  174. package/kits/hub-game/code/shared/expression.js +6 -0
  175. package/kits/hub-game/code/shared/replay.js +37 -0
  176. package/kits/hub-game/code/systems/hub.js +429 -55
  177. package/kits/hub-game/docs/analytics.md +16 -2
  178. package/kits/hub-game/docs/contract.md +956 -101
  179. package/kits/hub-game/docs/home-pieces.md +5 -6
  180. package/kits/hub-game/docs/observed-progress.md +49 -1
  181. package/kits/hub-game/docs/vehicle-preset.md +23 -0
  182. package/kits/hub-game/index.html +1 -0
  183. package/kits/hub-game/models/hats/baker-cap.pxmodel +3 -3
  184. package/kits/hub-game/models/hats/bat-clip.pxmodel +3 -3
  185. package/kits/hub-game/models/hats/beekeeper.pxmodel +3 -3
  186. package/kits/hub-game/models/hats/cap.pxmodel +3 -3
  187. package/kits/hub-game/models/hats/captain.pxmodel +3 -3
  188. package/kits/hub-game/models/hats/chef-toque.pxmodel +3 -3
  189. package/kits/hub-game/models/hats/crooked-top.pxmodel +3 -3
  190. package/kits/hub-game/models/hats/delivery-cap.pxmodel +3 -3
  191. package/kits/hub-game/models/hats/fire-helmet.pxmodel +3 -3
  192. package/kits/hub-game/models/hats/flower-crown.pxmodel +3 -3
  193. package/kits/hub-game/models/hats/foam-crown.pxmodel +3 -3
  194. package/kits/hub-game/models/hats/hard-hat.pxmodel +3 -3
  195. package/kits/hub-game/models/hats/lantern.pxmodel +3 -3
  196. package/kits/hub-game/models/hats/laurel.pxmodel +3 -3
  197. package/kits/hub-game/models/hats/lighthouse.pxmodel +3 -3
  198. package/kits/hub-game/models/hats/nurse-cap.pxmodel +3 -3
  199. package/kits/hub-game/models/hats/police-cap.pxmodel +3 -3
  200. package/kits/hub-game/models/hats/sailor.pxmodel +3 -3
  201. package/kits/hub-game/models/hats/souwester.pxmodel +3 -3
  202. package/kits/hub-game/models/hats/straw.pxmodel +3 -3
  203. package/kits/hub-game/models/hats/sunflower.pxmodel +3 -3
  204. package/kits/hub-game/models/hats/sweatband.pxmodel +3 -3
  205. package/kits/hub-game/models/hats/teacher-beret.pxmodel +3 -3
  206. package/kits/hub-game/models/hats/witch.pxmodel +3 -3
  207. package/kits/hub-game/models/hold-show/daisy.pxmodel +231 -0
  208. package/kits/hub-game/models/hold-show/moonflower.pxmodel +171 -0
  209. package/kits/hub-game/models/hold-show/rose.pxmodel +191 -0
  210. package/kits/hub-game/models/hold-show/square/daisy.pxmodel +233 -0
  211. package/kits/hub-game/models/hold-show/square/moonflower.pxmodel +173 -0
  212. package/kits/hub-game/models/hold-show/square/rose.pxmodel +193 -0
  213. package/kits/hub-game/models/hold-show/square/sunflower.pxmodel +313 -0
  214. package/kits/hub-game/models/hold-show/square/tulip.pxmodel +133 -0
  215. package/kits/hub-game/models/hold-show/sunflower.pxmodel +311 -0
  216. package/kits/hub-game/models/hold-show/tulip.pxmodel +131 -0
  217. package/kits/hub-game/package-lock.json +3 -3
  218. package/kits/hub-game/package.json +4 -3
  219. package/kits/hub-game/scripts/fixtures/engine-models-stub.mjs +1 -0
  220. package/kits/hub-game/scripts/fixtures/hud-surface.json +12 -12
  221. package/kits/hub-game/scripts/fixtures/talk-surface.json +8 -8
  222. package/kits/hub-game/scripts/gen-hats.mjs +1 -1
  223. package/kits/hub-game/scripts/gen-hold-show.mjs +27 -0
  224. package/kits/hub-game/scripts/pack.mjs +89 -23
  225. package/kits/hub-game/scripts/test-act-client.mjs +5 -0
  226. package/kits/hub-game/scripts/test-act-core.mjs +32 -0
  227. package/kits/hub-game/scripts/test-act-gate.mjs +186 -0
  228. package/kits/hub-game/scripts/test-action-rail-crowded-dom.mjs +7 -1
  229. package/kits/hub-game/scripts/test-action-rail-default-dom.mjs +102 -0
  230. package/kits/hub-game/scripts/test-action-rail-never-silent-dom.mjs +50 -0
  231. package/kits/hub-game/scripts/test-action-rail-surface.mjs +368 -0
  232. package/kits/hub-game/scripts/test-action-rail-town-jobs-dom.mjs +118 -0
  233. package/kits/hub-game/scripts/test-actions-client.mjs +5 -3
  234. package/kits/hub-game/scripts/test-actions.mjs +24 -0
  235. package/kits/hub-game/scripts/test-actors.mjs +19 -0
  236. package/kits/hub-game/scripts/test-again-corner-dom.mjs +59 -0
  237. package/kits/hub-game/scripts/test-analytics.mjs +79 -0
  238. package/kits/hub-game/scripts/test-arrival-pose-server.mjs +25 -8
  239. package/kits/hub-game/scripts/test-ask-client.mjs +9 -0
  240. package/kits/hub-game/scripts/test-ask-surface.mjs +188 -0
  241. package/kits/hub-game/scripts/test-attention.mjs +43 -1
  242. package/kits/hub-game/scripts/test-ballot-sheet-dom.mjs +71 -0
  243. package/kits/hub-game/scripts/test-ballot-surface.mjs +276 -0
  244. package/kits/hub-game/scripts/test-ballot.mjs +421 -4
  245. package/kits/hub-game/scripts/test-ban-join.mjs +1 -1
  246. package/kits/hub-game/scripts/test-celebrate-client.mjs +62 -0
  247. package/kits/hub-game/scripts/test-celebrate.mjs +116 -0
  248. package/kits/hub-game/scripts/test-chat.mjs +73 -0
  249. package/kits/hub-game/scripts/test-companion-client.mjs +203 -21
  250. package/kits/hub-game/scripts/test-companion.mjs +110 -3
  251. package/kits/hub-game/scripts/test-control-layout-dom.mjs +57 -10
  252. package/kits/hub-game/scripts/test-corner-surface.mjs +268 -0
  253. package/kits/hub-game/scripts/test-decor-client.mjs +59 -3
  254. package/kits/hub-game/scripts/test-decor.mjs +27 -0
  255. package/kits/hub-game/scripts/test-device-class.mjs +4 -1
  256. package/kits/hub-game/scripts/test-disguise-client.mjs +281 -0
  257. package/kits/hub-game/scripts/test-disguise.mjs +176 -0
  258. package/kits/hub-game/scripts/test-dock-surface.mjs +404 -0
  259. package/kits/hub-game/scripts/test-door-stay-client.mjs +602 -0
  260. package/kits/hub-game/scripts/test-door-stay.mjs +613 -0
  261. package/kits/hub-game/scripts/test-earned-client.mjs +119 -0
  262. package/kits/hub-game/scripts/test-emote-surface.mjs +616 -0
  263. package/kits/hub-game/scripts/test-fps-telemetry.mjs +39 -4
  264. package/kits/hub-game/scripts/test-friend-bests.mjs +38 -12
  265. package/kits/hub-game/scripts/test-ghost-click-dom.mjs +75 -0
  266. package/kits/hub-game/scripts/test-grab-client.mjs +29 -2
  267. package/kits/hub-game/scripts/test-grab-orbit.mjs +260 -11
  268. package/kits/hub-game/scripts/test-grab.mjs +10 -1
  269. package/kits/hub-game/scripts/test-hats.mjs +28 -0
  270. package/kits/hub-game/scripts/test-held-offers.mjs +394 -0
  271. package/kits/hub-game/scripts/test-high-only.mjs +3 -3
  272. package/kits/hub-game/scripts/test-hold-show-client.mjs +175 -0
  273. package/kits/hub-game/scripts/test-hold-show.mjs +355 -0
  274. package/kits/hub-game/scripts/test-hub-controls.mjs +3 -1
  275. package/kits/hub-game/scripts/test-hub-idle.mjs +348 -0
  276. package/kits/hub-game/scripts/test-hub-leaving.mjs +21 -0
  277. package/kits/hub-game/scripts/test-hub-ops.mjs +119 -0
  278. package/kits/hub-game/scripts/test-hub-trip.mjs +240 -4
  279. package/kits/hub-game/scripts/test-hud-clear.mjs +83 -0
  280. package/kits/hub-game/scripts/test-hud-rate.mjs +2 -1
  281. package/kits/hub-game/scripts/test-idle.mjs +160 -0
  282. package/kits/hub-game/scripts/test-invites-client.mjs +53 -0
  283. package/kits/hub-game/scripts/test-labels.mjs +11 -0
  284. package/kits/hub-game/scripts/test-landscape-layout.mjs +20 -0
  285. package/kits/hub-game/scripts/test-loading-cover.mjs +67 -1
  286. package/kits/hub-game/scripts/test-manifest.mjs +27 -0
  287. package/kits/hub-game/scripts/test-menu-client.mjs +54 -5
  288. package/kits/hub-game/scripts/test-menu-surface.mjs +236 -0
  289. package/kits/hub-game/scripts/test-npcs.mjs +128 -0
  290. package/kits/hub-game/scripts/test-observed.mjs +171 -3
  291. package/kits/hub-game/scripts/test-pack.mjs +166 -0
  292. package/kits/hub-game/scripts/test-pad-cues.mjs +39 -0
  293. package/kits/hub-game/scripts/test-picker-surface.mjs +321 -0
  294. package/kits/hub-game/scripts/test-placeat-server.mjs +648 -0
  295. package/kits/hub-game/scripts/test-placement-cache.mjs +1 -1
  296. package/kits/hub-game/scripts/test-pointer-clear-dom.mjs +82 -0
  297. package/kits/hub-game/scripts/test-progress-reset.mjs +184 -6
  298. package/kits/hub-game/scripts/test-push-visit.mjs +9 -0
  299. package/kits/hub-game/scripts/test-quality.mjs +312 -9
  300. package/kits/hub-game/scripts/test-quick-chat-surface.mjs +511 -0
  301. package/kits/hub-game/scripts/test-rehello.mjs +242 -3
  302. package/kits/hub-game/scripts/test-rejoin-yaw.mjs +138 -0
  303. package/kits/hub-game/scripts/test-relations-among.mjs +13 -7
  304. package/kits/hub-game/scripts/test-relations-refresh.mjs +90 -2
  305. package/kits/hub-game/scripts/test-replay-client.mjs +110 -0
  306. package/kits/hub-game/scripts/test-replay.mjs +178 -0
  307. package/kits/hub-game/scripts/test-resume-held.mjs +13 -0
  308. package/kits/hub-game/scripts/test-resume-pose-server.mjs +43 -5
  309. package/kits/hub-game/scripts/test-role-client.mjs +2 -1
  310. package/kits/hub-game/scripts/test-safe-act.mjs +233 -0
  311. package/kits/hub-game/scripts/test-safe-caption.mjs +364 -0
  312. package/kits/hub-game/scripts/test-safe-layout.mjs +79 -0
  313. package/kits/hub-game/scripts/test-safe-prompt.mjs +163 -0
  314. package/kits/hub-game/scripts/test-sound-surface.mjs +256 -0
  315. package/kits/hub-game/scripts/test-soundscape.mjs +85 -2
  316. package/kits/hub-game/scripts/test-standing.mjs +135 -2
  317. package/kits/hub-game/scripts/test-stuck-surface.mjs +174 -0
  318. package/kits/hub-game/scripts/test-stuck.mjs +36 -1
  319. package/kits/hub-game/scripts/test-talk-surface.mjs +23 -6
  320. package/kits/hub-game/scripts/test-talk-walk-dom.mjs +123 -0
  321. package/kits/hub-game/scripts/test-text-ask-surface.mjs +273 -0
  322. package/kits/hub-game/scripts/test-tiers.mjs +453 -3
  323. package/kits/hub-game/scripts/test-toast-no-row-dom.mjs +71 -0
  324. package/kits/hub-game/scripts/test-together.mjs +11 -0
  325. package/kits/hub-game/scripts/test-town-day.mjs +90 -0
  326. package/kits/hub-game/scripts/test-try-on.mjs +39 -0
  327. package/kits/hub-game/scripts/test-ui-dom-dom.mjs +49 -2
  328. package/kits/hub-game/scripts/test-ui-tree.mjs +28 -0
  329. package/kits/hub-game/scripts/test-vehicle-client.mjs +68 -1
  330. package/kits/hub-game/scripts/test-vis.mjs +145 -0
  331. package/kits/hub-game/scripts/test-wallet.mjs +650 -0
  332. package/kits/hub-game/scripts/test-weakest-tier.mjs +135 -1
  333. package/kits/hub-game/scripts/test-world-labels.mjs +340 -0
  334. package/kits/hub-game/scripts/test-writer-lease-server.mjs +234 -0
  335. package/kits/hub-game/scripts/test-writer-lease.mjs +281 -0
  336. package/kits/hub-game/scripts/writer-storage-fixture.mjs +37 -0
  337. package/kits/hub-game/tools/hubScene/export.mjs +6 -5
  338. package/kits/hub-game/tools/hubScene/hubdata.mjs +10 -0
  339. package/kits/hub-game/tools/hubScene/test/export-fixture.mjs +36 -2
  340. package/kits/hub-game/tools/hubScene/validate-manifest.mjs +10 -2
  341. package/kits/multiplayer-3d/castle.json +5 -5
  342. package/kits/multiplayer-3d/code/client/resumeGate.js +66 -2
  343. package/kits/multiplayer-3d/code/server/ownership.js +25 -6
  344. package/kits/multiplayer-3d/code/server/world.js +19 -4
  345. package/kits/multiplayer-3d/code/systems/multiplayer.js +108 -18
  346. package/kits/multiplayer-3d/package-lock.json +1 -1
  347. package/kits/multiplayer-3d/package.json +2 -1
  348. package/kits/multiplayer-3d/scripts/test-ground-half.mjs +56 -0
  349. package/kits/multiplayer-3d/scripts/test-join-watchdog.mjs +54 -3
  350. package/kits/multiplayer-3d/scripts/test-owned-moves.mjs +190 -0
  351. package/kits/multiplayer-3d/scripts/test-resume-gate.mjs +417 -5
  352. package/kits/multiplayer-3d/scripts/test-resync-reconnect.mjs +68 -0
  353. package/kits/physics-2d/castle.json +2 -2
  354. package/kits/physics-2d/engine/scene.js +10 -2
  355. package/kits/physics-3d/CLAUDE.md +14 -0
  356. package/kits/physics-3d/behaviors/Player.jsx +39 -3
  357. package/kits/physics-3d/castle.json +3 -3
  358. package/kits/physics-3d/docs/engine-model-cache.md +109 -0
  359. package/kits/physics-3d/docs/engine-player.md +76 -0
  360. package/kits/physics-3d/docs/engine-skip-work.md +16 -0
  361. package/kits/physics-3d/docs/pxmodel-format.md +5 -1
  362. package/kits/physics-3d/engine3d/gait.js +16 -8
  363. package/kits/physics-3d/engine3d/groundsize.js +23 -0
  364. package/kits/physics-3d/engine3d/kithooks.js +50 -0
  365. package/kits/physics-3d/engine3d/look.js +110 -17
  366. package/kits/physics-3d/engine3d/lookbake.js +19 -1
  367. package/kits/physics-3d/engine3d/materialpresets.js +3 -2
  368. package/kits/physics-3d/engine3d/modelcache.js +280 -0
  369. package/kits/physics-3d/engine3d/modelcachedigest.js +37 -0
  370. package/kits/physics-3d/engine3d/modelcachegate.js +69 -0
  371. package/kits/physics-3d/engine3d/modelrefs.js +13 -0
  372. package/kits/physics-3d/engine3d/optimize.js +20 -9
  373. package/kits/physics-3d/engine3d/playerRun.js +26 -1
  374. package/kits/physics-3d/engine3d/pxmodel.js +7 -3
  375. package/kits/physics-3d/engine3d/templatecache.js +722 -0
  376. package/kits/physics-3d/engine3d/world3d.js +211 -17
  377. package/kits/physics-3d/package-lock.json +1 -1
  378. package/kits/physics-3d/package.json +2 -1
  379. package/kits/physics-3d/play/behaviors/Player.js +43 -3
  380. package/kits/physics-3d/scripts/render.mjs +56 -8
  381. package/kits/physics-3d/scripts/template-cache-fixtures.mjs +37 -0
  382. package/kits/physics-3d/scripts/template-cache-v1-bytes.json +49 -0
  383. package/kits/physics-3d/scripts/test-coaxial-escape.mjs +176 -0
  384. package/kits/physics-3d/scripts/test-gait.mjs +53 -9
  385. package/kits/physics-3d/scripts/test-ground-half.mjs +120 -0
  386. package/kits/physics-3d/scripts/test-model-cache.mjs +600 -0
  387. package/kits/physics-3d/scripts/test-orbit-shadow-fade.mjs +1 -0
  388. package/kits/physics-3d/scripts/test-sleeping-models.mjs +384 -0
  389. package/kits/physics-3d/scripts/test-template-cache-minified.mjs +106 -0
  390. package/kits/physics-3d/scripts/test-template-cache.mjs +519 -0
  391. package/kits/physics-3d/scripts/test-wall-slide.mjs +272 -0
  392. package/kits/physics-3d/systems/physics3d.js +59 -2
  393. package/kits/real-time/castle.json +2 -2
  394. package/kits/real-time/code/client/connection.js +3 -0
  395. package/package.json +2 -2
  396. package/vendor/three/examples/jsm/libs/fflate.module.js +2672 -0
@@ -0,0 +1,186 @@
1
+ // The action rail surface: the opt-in action rail and its overflow sheet
2
+ // (`actionRailTree.js`) with the behaviour `actionOverflow.js` gives them in
3
+ // the DOM, published as the `actions` UI tree root. No DOM and no window: a
4
+ // native host gives it the place's offers each frame and draws the root from
5
+ // the UI tree sink. The web chrome does not use it yet; it still draws the
6
+ // DOM controller.
7
+ //
8
+ // makeActionRailSurface({ view, safeInsets, later, draw }):
9
+ // view() the stage: { w, h } in CSS px, and `safeInsets` when the
10
+ // host follows it (read at each render and fit), so a
11
+ // manifest update that flips it moves the rail;
12
+ // safeInsets the place keeps its edges clear of the safe area, while
13
+ // view() says nothing of it;
14
+ // later(fn, ms) / cancelLater(token) a timer (default setTimeout): a
15
+ // press's debounce, and the sheet shutting 80 ms after an
16
+ // offer in it is pressed, as the DOM's does;
17
+ // draw(tree) called with each root built (only when its state changed).
18
+ import { publishUiRoot } from './uiTree.js';
19
+ import { buildActionRail } from './actionRailTree.js';
20
+ import { actionLayout } from './actionLayout.js';
21
+
22
+ export function makeActionRailSurface({
23
+ view = () => ({}),
24
+ safeInsets = false,
25
+ later = (fn, ms) => globalThis.setTimeout(fn, ms),
26
+ cancelLater = (token) => globalThis.clearTimeout(token),
27
+ draw = null,
28
+ } = {}) {
29
+ const state = { items: [], n: undefined, canAct: false, open: false, changed: false, layout: null, view: { w: 0, h: 0 }, safeInsets: Boolean(safeInsets) };
30
+ let handler = null;
31
+ let onOpen = () => {};
32
+ let offerKey = '';
33
+ let generation = 0;
34
+ let disposed = false;
35
+ const pressed = new Set();
36
+ const timers = new Set();
37
+
38
+ const on = {
39
+ act: (id) => activate(id),
40
+ open: () => openSheet(),
41
+ close: () => closeSheet(),
42
+ };
43
+
44
+ function readStage() {
45
+ const stage = view() ?? {};
46
+ state.view = { w: Number(stage.w) || 0, h: Number(stage.h) || 0 };
47
+ if (typeof stage.safeInsets === 'boolean') {state.safeInsets = stage.safeInsets;}
48
+ }
49
+
50
+ let key = '';
51
+ function render() {
52
+ if (disposed) {return;}
53
+ readStage();
54
+ const layout = state.layout;
55
+ const next = JSON.stringify([offerKey, state.canAct, state.open, state.changed, layout?.mode ?? null, layout?.rect ?? null, layout?.cells ?? null, state.view.w, state.view.h, state.safeInsets]);
56
+ if (next === key) {return;}
57
+ key = next;
58
+ const tree = buildActionRail(state, on);
59
+ publishUiRoot('actions', tree);
60
+ draw?.(tree);
61
+ }
62
+
63
+ function clearTimers() {
64
+ for (const token of timers) {cancelLater(token);}
65
+ timers.clear();
66
+ pressed.clear();
67
+ }
68
+ function wait(fn, ms) {
69
+ const token = later(() => {
70
+ timers.delete(token);
71
+ fn();
72
+ }, ms);
73
+ timers.add(token);
74
+ }
75
+
76
+ // An offer pressed: the handler gets (id, n) once per press; a second press
77
+ // of the same offer inside its debounce is dropped. From the sheet, the
78
+ // sheet shuts 80 ms later, unless it was shut or redrawn meanwhile.
79
+ function activate(id) {
80
+ if (!state.canAct || pressed.has(id) || !state.items.some((item) => item.id === id)) {return false;}
81
+ pressed.add(id);
82
+ const sheet = state.open;
83
+ const at = generation;
84
+ handler?.(id, state.n);
85
+ wait(() => {
86
+ pressed.delete(id);
87
+ if (sheet && state.open && at === generation) {closeSheet();}
88
+ }, sheet ? 80 : 120);
89
+ return true;
90
+ }
91
+
92
+ function openSheet() {
93
+ const mode = state.layout?.mode;
94
+ if (disposed || state.open || !state.canAct || !state.items.length || (mode !== 'more' && mode !== 'launcher')) {return false;}
95
+ state.open = true;
96
+ state.changed = false;
97
+ generation += 1;
98
+ render();
99
+ onOpen(true);
100
+ return true;
101
+ }
102
+
103
+ function closeSheet() {
104
+ if (!state.open) {return false;}
105
+ state.open = false;
106
+ state.changed = false;
107
+ generation += 1;
108
+ clearTimers();
109
+ render();
110
+ onOpen(false);
111
+ return true;
112
+ }
113
+
114
+ render();
115
+ return {
116
+ state,
117
+ render,
118
+ // The place's offers, said every frame (chrome `setActions` with the
119
+ // rail): `items` [{ id, label }] (the first three are kept), `nextHandler`
120
+ // (id, n) for a press, `canAct`, the offer generation `n`, and
121
+ // `nextOnOpen(open)` as the sheet opens and shuts.
122
+ set(items, nextHandler, canAct, n, nextOnOpen = () => {}) {
123
+ if (disposed) {return;}
124
+ handler = nextHandler;
125
+ onOpen = nextOnOpen ?? (() => {});
126
+ const next = (items ?? []).slice(0, 3).map((item) => ({ id: item.id, label: item.label }));
127
+ const nextKey = JSON.stringify([next, n ?? null]);
128
+ const changed = nextKey !== offerKey;
129
+ state.n = n;
130
+ state.canAct = canAct === true;
131
+ if (!next.length) {
132
+ offerKey = nextKey;
133
+ state.items = [];
134
+ closeSheet();
135
+ render();
136
+ return;
137
+ }
138
+ if (changed) {
139
+ offerKey = nextKey;
140
+ state.items = next;
141
+ if (state.open) {
142
+ // Redrawn in place, announced once; pending shuts are void.
143
+ state.changed = true;
144
+ generation += 1;
145
+ clearTimers();
146
+ }
147
+ }
148
+ if (!state.canAct) {closeSheet();}
149
+ render();
150
+ },
151
+ // The rail's placement: `actionLayout.js`'s result ({ mode, rect, cells }) for
152
+ // the host's measured sizes, or null for the default lane (every offer,
153
+ // low right, moved up clear of the other controls).
154
+ setLayout(layout) {
155
+ // The sheet stays open while it is up; the rail returns as placed when
156
+ // it shuts.
157
+ state.layout = layout && typeof layout.mode === 'string' ? {
158
+ mode: layout.mode,
159
+ ...(layout.rect ? { rect: { ...layout.rect } } : {}),
160
+ ...(Array.isArray(layout.cells) ? { cells: layout.cells.map((cell) => ({ ...cell })) } : {}),
161
+ } : null;
162
+ render();
163
+ },
164
+ // `actionLayout` over sizes the host measured (the `report: true` boxes
165
+ // of the rail's buttons): { view, safe, offers, more, launcher,
166
+ // obstacles, reserved }. Returns the placement it set; null when nothing
167
+ // fits, and the rail is hidden (mode 'none') as the DOM's is.
168
+ fit(inputs) {
169
+ if (!disposed) {readStage();}
170
+ const placed = actionLayout({ ...inputs, ...(state.safeInsets ? { edgeMax: true } : {}) });
171
+ state.layout = placed ? { mode: placed.mode, rect: { ...placed.rect }, cells: placed.cells.map((cell) => ({ ...cell })) } : { mode: 'none' };
172
+ render();
173
+ return placed;
174
+ },
175
+ // Back / Escape: shuts the sheet; false when it was not open.
176
+ cancel: () => closeSheet(),
177
+ isOpen: () => state.open,
178
+ dispose() {
179
+ if (disposed) {return;}
180
+ closeSheet();
181
+ clearTimers();
182
+ disposed = true;
183
+ publishUiRoot('actions', null);
184
+ },
185
+ };
186
+ }
@@ -0,0 +1,173 @@
1
+ // The opt-in action rail and its overflow sheet as a UI tree (schema v0):
2
+ // the place's offers (`hub.actions`, at most three) as gold buttons low on
3
+ // the right, collapsing to the first offer and "More (n)" or one
4
+ // "Actions (n)" launcher where they do not fit, and the sheet the launcher
5
+ // opens: every offer full width under a Close button, over an opaque
6
+ // backdrop. It draws what `actionOverflow.js` draws in the DOM (the rail a
7
+ // safe-inset place always takes), with the same words, labels and states.
8
+ // Pure: no DOM, no window; the web chrome still draws the DOM controller.
9
+ //
10
+ // state = {
11
+ // items: [{ id, label }], at most three, in the server's order;
12
+ // canAct: whether the player may act now (false hides the rail and shuts
13
+ // the sheet);
14
+ // open: the sheet is open;
15
+ // changed: the offers changed while the sheet was open (its label says so
16
+ // once, as the DOM's aria-label does);
17
+ // layout: null (the default lane: low right, moved up clear of the other
18
+ // controls, hidden where nothing clears) or `actionLayout.js`'s
19
+ // result { mode, rect, cells }: mode 'all' | 'all-two' | 'more' |
20
+ // 'launcher', the rail pinned to `rect` (CSS px from the view's
21
+ // top left) and each button to its measured cell (the rows
22
+ // `actionLayout` chose, never a re-wrap that could leave the
23
+ // rect it checked), or { mode: 'none' }: nothing fits, the rail
24
+ // is hidden;
25
+ // view: { w, h } in CSS px (a narrow or portrait view lists the sheet in
26
+ // one column, else two);
27
+ // safeInsets: the place keeps its edges clear of the safe area (the
28
+ // rail's margin is max(8, inset) rather than inset + 8);
29
+ // }
30
+ // on = { act(id), open(), close() }: an offer pressed (on the rail or in the
31
+ // sheet), the launcher pressed, Close / Back.
32
+ import { h } from './uiTree.js';
33
+
34
+ // The boxes the default lane is moved up clear of: the host's own controls,
35
+ // and the kit's HUD, talk panel and dock roots.
36
+ export const RAIL_AVOID = ['controls', 'hud/back', 'hud/hud', 'hud/prompt', 'hud/toast', 'hud/actpair', 'talk/panel', 'dock/dock'];
37
+
38
+ // actionOverflow.js `buttonStyle` as tree style.
39
+ const OFFER = {
40
+ box: 'border', border: 'none', radius: 22, minW: 44, minH: 44, pad: [10, 16],
41
+ font: 'ui', size: 16, weight: 600, lh: 1.2, color: 'onAction', bg: 'action',
42
+ wrap: ['word', 'anywhere'], talign: 'center',
43
+ };
44
+
45
+ // The rail's words for the launcher in a mode, and its spoken label.
46
+ export function launcherWords(mode, count) {
47
+ return mode === 'more'
48
+ ? { text: `More (${count - 1})`, label: `${count - 1} more actions, ${count} actions total` }
49
+ : { text: `Actions (${count})`, label: `${count} actions` };
50
+ }
51
+
52
+ const railMode = (layout) => (layout?.mode === 'more' || layout?.mode === 'launcher' ? layout.mode : 'all');
53
+
54
+ function finiteRect(rect) {
55
+ return Boolean(rect) && ['left', 'right', 'top', 'bottom'].every((key) => Number.isFinite(rect[key])) && rect.right > rect.left;
56
+ }
57
+ const finiteCell = (cell) => Boolean(cell) && ['index', 'left', 'top', 'width', 'height'].every((key) => Number.isFinite(cell[key]));
58
+
59
+ // The measured cells by what they hold: offer index, or 'launcher' (the
60
+ // cells index `actionLayout`'s sizes: every offer, or [first, More], or
61
+ // [Actions]).
62
+ function cellsByButton(layout, mode) {
63
+ const cells = Array.isArray(layout?.cells) ? layout.cells.filter(finiteCell) : [];
64
+ const byButton = new Map();
65
+ for (const cell of cells) {
66
+ const button = mode === 'launcher' ? (cell.index === 0 ? 'launcher' : null)
67
+ : mode === 'more' ? (cell.index === 0 ? 0 : cell.index === 1 ? 'launcher' : null)
68
+ : cell.index;
69
+ if (button !== null) {byButton.set(button, cell);}
70
+ }
71
+ return byButton;
72
+ }
73
+
74
+ export function buildActionRail(state, on = {}) {
75
+ const items = Array.isArray(state.items) ? state.items.slice(0, 3) : [];
76
+ const count = items.length;
77
+ const open = Boolean(state.open) && count > 0;
78
+ const canAct = Boolean(state.canAct);
79
+ const layout = state.layout ?? null;
80
+ const mode = railMode(layout);
81
+ const pinned = finiteRect(layout?.rect) ? layout.rect : null;
82
+ const margin = state.safeInsets ? [8, 0] : [8, 8];
83
+ const at = pinned
84
+ ? { anchor: 'topLeft', top: pinned.top, left: pinned.left, z: 8 }
85
+ : { anchor: 'bottomRight', bottom: margin, right: margin, z: 8, avoid: RAIL_AVOID, avoidHide: true };
86
+ const launcher = launcherWords(mode, count);
87
+ const showLauncher = mode !== 'all' && count > 0;
88
+ // Pinned with measured cells: a stack of the rect's size, each shown
89
+ // button at its cell, as the DOM places them; otherwise a row that wraps.
90
+ const cells = pinned ? cellsByButton(layout, mode) : new Map();
91
+ const placed = cells.size > 0;
92
+ const cellOf = (button) => {
93
+ const cell = cells.get(button);
94
+ return cell ? { at: { anchor: 'topLeft', top: cell.top - pinned.top, left: cell.left - pinned.left }, size: { w: cell.width, h: cell.height, maxW: cell.width } } : null;
95
+ };
96
+ const gone = !canAct || open || count === 0 || layout?.mode === 'none';
97
+
98
+ const rail = h(placed ? 'stack' : 'row', {
99
+ key: 'rail', hub: 'action-rail', report: true, at,
100
+ style: placed
101
+ ? { w: pinned.right - pinned.left, h: pinned.bottom - pinned.top, hit: 'none', gone }
102
+ : {
103
+ // Rows wrap, each row's offers at its right.
104
+ wrap: true, justify: 'end', gap: 8, hit: 'none',
105
+ ...(pinned ? { w: pinned.right - pinned.left } : { maxW: [state.safeInsets ? { vw: 100, sub: { l: 8, r: 8 } } : { vw: 100, px: -16, safe: 'lr' }] }),
106
+ gone,
107
+ },
108
+ },
109
+ items.map((item, index) => {
110
+ const cell = placed ? cellOf(index) : null;
111
+ const hidden = mode === 'launcher' || (mode === 'more' && index > 0) || (placed && !cell);
112
+ return h('button', {
113
+ key: `o:${item.id}`, label: item.label, press: 'scale', report: true,
114
+ data: { actionId: String(item.id) },
115
+ ...(cell ? { at: cell.at } : {}),
116
+ style: { ...OFFER, ...cell?.size, gone: hidden },
117
+ on: { tap: () => on.act?.(item.id) },
118
+ }, item.label);
119
+ }),
120
+ (() => {
121
+ const cell = placed ? cellOf('launcher') : null;
122
+ const shown = showLauncher && (!placed || Boolean(cell));
123
+ return h('button', {
124
+ key: 'launcher', label: launcher.label, report: true,
125
+ ...(cell ? { at: cell.at } : {}),
126
+ style: { ...OFFER, ...cell?.size, gone: !shown },
127
+ on: { tap: shown ? on.open : undefined },
128
+ }, launcher.text);
129
+ })());
130
+
131
+ const view = state.view ?? {};
132
+ const narrow = (view.w ?? 0) < 480 || (view.h ?? 0) > (view.w ?? 0);
133
+ const sheet = open ? h('stack', {
134
+ key: 'sheet', hub: 'action-backdrop',
135
+ at: { anchor: 'fill', z: 12 },
136
+ style: { bg: '#14100c', hit: 'auto' },
137
+ },
138
+ // The safe area between the insets, as the DOM's backdrop padding is; the
139
+ // card is centred in it, never against the full view.
140
+ h('column', {
141
+ key: 'safe',
142
+ at: { anchor: 'bottom', bottom: [0, 0], left: [0, 0], right: [0, 0] },
143
+ style: { align: 'center', hit: 'none' },
144
+ },
145
+ h('column', {
146
+ key: 'card', hub: 'action-sheet', role: 'dialog', label: state.changed ? 'Actions changed. Actions' : 'Actions',
147
+ style: {
148
+ w: 'fill', maxW: 560, maxH: [{ dvh: 100, safe: 'tb' }], box: 'border',
149
+ gap: 8, pad: 10, radius: [14, 14, 0, 0], bg: 'sheet', shadow: 'sheet', hit: 'auto',
150
+ },
151
+ },
152
+ h('button', {
153
+ key: 'close', label: 'Close actions',
154
+ style: { self: 'end', minW: 44, minH: 44, pad: [8, 14], radius: 22, border: { w: 1, c: 'line45' }, bg: 'sheet', color: '#fff', font: 'ui', size: 16, weight: 700, lh: 'normal' },
155
+ on: { tap: on.close },
156
+ }, 'Close'),
157
+ h('scroll', { key: 'list', axis: 'y', style: { minH: 0, flex: '0 1 auto' } },
158
+ h('grid', { key: 'grid', cols: narrow ? 1 : 2, style: { gap: 8 } },
159
+ items.map((item) => h('button', {
160
+ key: `o:${item.id}`, label: item.label, press: 'scale',
161
+ data: { actionId: String(item.id) },
162
+ style: { ...OFFER, w: 'fill' },
163
+ on: { tap: () => on.act?.(item.id) },
164
+ }, item.label))))))) : null;
165
+
166
+ // Back shuts the sheet only while it is open: a closed rail binds none, so
167
+ // a host's Back passes it by.
168
+ return h('stack', {
169
+ key: 'actions',
170
+ style: { font: 'ui', size: 15, weight: 600, lh: 1.3, color: '#fff' },
171
+ on: { cancel: open ? on.close : undefined },
172
+ }, rail, sheet);
173
+ }
@@ -0,0 +1,85 @@
1
+ // The question card surface: the card (`askTree.js`) with the behaviour
2
+ // `chrome.js` gives it in the DOM (`setAsk`, `askShowable`, `onAsk`,
3
+ // `onHeart`) -- the card is drawn while a question is given and the page is
4
+ // not away; an answer hides it at once and goes to `onAsk(ask, yes)` with
5
+ // the card it was drawn for; the next `set` with a question draws it again
6
+ // -- published as the `ask` UI tree root. No DOM and no window: a native
7
+ // host gives it what the hub system gives the chrome's `setAsk` each frame,
8
+ // and the hub system's own `answer` (the `onAsk` the chrome is made with)
9
+ // stays the sender: { k: 'hub-party', op: 'go-yes' | 'go-no', id } for a
10
+ // door the party proposed, { k: 'hub-party', op: 'accept' | 'decline',
11
+ // from } for an invitation, { k: 'hub-door-jump', door } for "Let's play",
12
+ // the door path for the game just come back from or one of the player's
13
+ // own. The web chrome does not use it.
14
+ //
15
+ // makeAskSurface({ onAsk, onHeart, draw }):
16
+ // onAsk(ask, yes) an answer, as chrome.js's `onAsk`;
17
+ // onHeart(door, ask) a 'yours' card's heart, as chrome.js's `onHeart`
18
+ // with the card it was drawn for;
19
+ // draw(tree) called with each root built (only when it changed).
20
+ import { publishUiRoot } from './uiTree.js';
21
+ import { buildAsk } from './askTree.js';
22
+
23
+ export function makeAskSurface({ onAsk = () => {}, onHeart = () => {}, draw = null } = {}) {
24
+ let ask = null;
25
+ let shown = false;
26
+ let away = false;
27
+ let key = '';
28
+ let disposed = false;
29
+
30
+ const on = {
31
+ answer: (yes) => {
32
+ if (!ask || !shown) {return;}
33
+ const answered = ask;
34
+ shown = false;
35
+ render();
36
+ onAsk(answered, yes === true);
37
+ },
38
+ heart: () => {
39
+ if (ask && shown) {onHeart(ask.door, ask);}
40
+ },
41
+ };
42
+
43
+ function render() {
44
+ if (disposed) {return;}
45
+ const state = { ask: shown ? ask : null, shown };
46
+ const next = JSON.stringify(state);
47
+ if (next === key) {return;}
48
+ key = next;
49
+ const tree = buildAsk(state, on);
50
+ publishUiRoot('ask', tree);
51
+ draw?.(tree);
52
+ }
53
+
54
+ render();
55
+ return {
56
+ // chrome `setAsk`: { key, kind?, text, yes, no, line?, door?, heart? },
57
+ // or null for none. Said every frame; drawn unless the page is away.
58
+ set(next) {
59
+ ask = next ?? null;
60
+ shown = Boolean(ask) && !away;
61
+ render();
62
+ },
63
+ // chrome `askShowable`: whether a card given now would be drawn (the hub
64
+ // starts no ask lease while it is false).
65
+ showable: () => !away,
66
+ // The page went away (backgrounded, pagehide) or came back. Away hides
67
+ // the card at once and keeps it; back draws it on the next `set`, as
68
+ // the DOM's lifecycle does.
69
+ setAway(value) {
70
+ away = Boolean(value);
71
+ if (away) {
72
+ shown = false;
73
+ render();
74
+ }
75
+ },
76
+ // Whether the card is drawn now (the hub's HUD and toast keep under it).
77
+ shown: () => shown,
78
+ current: () => (shown ? ask : null),
79
+ dispose() {
80
+ if (disposed) {return;}
81
+ disposed = true;
82
+ publishUiRoot('ask', null);
83
+ },
84
+ };
85
+ }
@@ -0,0 +1,51 @@
1
+ // The question card (v1.10, `chrome.js` `setAsk`) as a UI tree (schema v0):
2
+ // one question at a time under the HUD -- an invitation to a party, a door
3
+ // the party wants to go through, "Let's play", the game just come back from,
4
+ // or (`kind: 'yours'`) one of the player's own games with its line and an
5
+ // optional heart -- and its two answers. The same words, labels and states
6
+ // as the DOM card. Pure: no DOM, no window; the web chrome still draws it.
7
+ //
8
+ // state = {
9
+ // ask: null, or the card: { key, kind?, text, yes, no, line?, door?,
10
+ // heart? } (`heart` a boolean offers the heart on a 'yours' card);
11
+ // shown: the card is drawn (false while the page is away, and after an
12
+ // answer until the card is given again, as the DOM hides it);
13
+ // }
14
+ // on = { answer(yes), heart() }: Yes / No pressed, the heart pressed.
15
+ import { h } from './uiTree.js';
16
+
17
+ const ROOT = { font: 'ui', size: 15, weight: 600, lh: 1.3, color: '#fff' };
18
+ // chrome.js `smallButton`.
19
+ const small = (primary) => ({
20
+ pad: [5, 12], radius: 12, border: primary ? 'none' : { w: 1, c: 'line35' }, bg: primary ? 'gold' : 'transparent',
21
+ color: primary ? 'onGold' : '#fff', font: 'ui', size: 13, weight: 700, lh: 'normal',
22
+ });
23
+
24
+ // The card's width: wider for one of the player's own games.
25
+ export const askWidth = (ask) => (ask?.kind === 'yours' ? [{ vw: 94 }, { px: 420 }] : [{ vw: 86 }, { px: 320 }]);
26
+
27
+ export function buildAsk(state, on = {}) {
28
+ const ask = state.ask;
29
+ const root = { key: 'ask', style: ROOT };
30
+ if (!ask || !state.shown) {return h('stack', root);}
31
+ const yours = ask.kind === 'yours';
32
+ const words = yours
33
+ ? h('column', { key: 'words', style: { flex: 1, minW: 0, weight: 600, clip: true } },
34
+ h('text', { key: 'text', text: String(ask.text ?? ''), style: { lines: 1 } }),
35
+ h('text', { key: 'line', text: String(ask.line ?? ''), style: { size: 11, weight: 500, opacity: 0.7, lines: 1 } }))
36
+ : h('text', { key: 'text', text: String(ask.text ?? ''), style: { flex: 1, minW: 0, weight: 600 } });
37
+ const hearted = ask.heart === true;
38
+ return h('stack', root,
39
+ h('row', {
40
+ key: 'card', data: { ask: String(ask.key ?? '') },
41
+ at: { anchor: 'top', top: [92, 80] },
42
+ style: { w: askWidth(ask), box: 'border', align: 'center', gap: 8, pad: [8, 10], radius: 12, bg: 'rgba(20,16,12,0.9)', shadow: 'card', size: 14, hit: 'auto' },
43
+ },
44
+ words,
45
+ yours && typeof ask.heart === 'boolean' ? h('button', {
46
+ key: 'heart', fire: 'down', label: hearted ? 'Remove heart' : 'Heart this game', pressed: hearted,
47
+ style: { ...small(false), flex: '0 0 auto' }, on: { tap: on.heart },
48
+ }, hearted ? '♥' : '♡') : null,
49
+ h('button', { key: 'yes', fire: 'down', style: small(true), on: { tap: () => on.answer?.(true) } }, String(ask.yes ?? '')),
50
+ h('button', { key: 'no', fire: 'down', style: small(false), on: { tap: () => on.answer?.(false) } }, String(ask.no ?? ''))));
51
+ }
@@ -21,13 +21,34 @@ const FADE_MS = 250;
21
21
  // The plate shown changes to a nearer one only when that one is nearer by
22
22
  // this much, so standing between two statues does not flicker.
23
23
  const SWITCH_M = 0.75;
24
+ // A plate behind the player (one they walked past) counts as this much
25
+ // further: walking past one statue to the next, the player stops about as
26
+ // near the one passed, and its plate must not stay chosen.
27
+ export const BEHIND_M = PLATE_NEAR_M;
28
+ // Behind: more than about 107 degrees off the way the player faces, and not
29
+ // one they stand on (whose bearing is noise).
30
+ const BEHIND_COS = -0.3;
31
+ const BEARING_M = 0.75;
32
+
33
+ // Whether a plate at (x, z) lies behind a player at `from` facing `facing`
34
+ // (radians, the physics-3d player's: forward is (sin, cos)). False with no
35
+ // facing to go by.
36
+ export function behind(from, facing, x, z) {
37
+ const dx = x - from.x, dz = z - from.z;
38
+ const d = Math.hypot(dx, dz);
39
+ if (!Number.isFinite(facing) || d < BEARING_M) {
40
+ return false;
41
+ }
42
+ return (dx * Math.sin(facing) + dz * Math.cos(facing)) / d < BEHIND_COS;
43
+ }
24
44
 
25
45
  export function makeAttention() {
26
46
  return { alpha: new Map(), plate: null, speech: null, at: 0 };
27
47
  }
28
48
 
29
- // `candidates` is every label the place has up: `{ id, d, speech }`, `d` its
30
- // actor's distance from the player on the ground. Returns the ones to draw,
49
+ // `candidates` is every label the place has up: `{ id, d, speech, behind }`,
50
+ // `d` its actor's distance from the player on the ground, `behind` whether a
51
+ // plate lies behind the player (`behind()`). Returns the ones to draw,
31
52
  // id -> opacity: the nearest plate and the nearest line, fading in and out.
32
53
  export function attend(a, candidates, now) {
33
54
  const dt = a.at ? Math.min(100, Math.max(0, now - a.at)) : FADE_MS;
@@ -41,6 +62,7 @@ export function attend(a, candidates, now) {
41
62
  candidates.filter((c) => c.speech),
42
63
  a.speech,
43
64
  SPEECH_NEAR_M,
65
+ false,
44
66
  );
45
67
  const shown = new Map();
46
68
  const live = new Set();
@@ -66,22 +88,25 @@ export function attend(a, candidates, now) {
66
88
  return shown;
67
89
  }
68
90
 
69
- // The nearest within `near`, keeping `current` unless another is clearly nearer.
70
- function pick(list, current, near) {
91
+ // The nearest within `near`, keeping `current` unless another is clearly
92
+ // nearer. A plate behind the player counts BEHIND_M further (`facing`); an
93
+ // NPC's line is chosen by distance alone, as it calls from any side.
94
+ function pick(list, current, near, facing = true) {
71
95
  let best = null;
72
96
  let mine = null;
97
+ const felt = (c) => c.d + (facing && c.behind ? BEHIND_M : 0);
73
98
  for (const c of list) {
74
99
  if (c.d > near) {
75
100
  continue;
76
101
  }
77
- if (!best || c.d < best.d) {
102
+ if (!best || felt(c) < felt(best)) {
78
103
  best = c;
79
104
  }
80
105
  if (c.id === current) {
81
106
  mine = c;
82
107
  }
83
108
  }
84
- if (mine && best && best.d > mine.d - SWITCH_M) {
109
+ if (mine && best && felt(best) > felt(mine) - SWITCH_M) {
85
110
  return mine.id;
86
111
  }
87
112
  return best?.id ?? null;
@@ -227,8 +227,10 @@ function el(tag, style, parent) {
227
227
  return node;
228
228
  }
229
229
 
230
- // `send(ids)` sends a tap; `onChip()` (optional) is the soundscape's chip tap.
231
- export function makeBallot({ safeInsets = false, send, onChip }) {
230
+ // `send(ids)` sends a tap; `onChip()` (optional) is the soundscape's chip tap;
231
+ // `refuse()` (v1.204) is true, having said why, when a send must wait on the
232
+ // server's progress read.
233
+ export function makeBallot({ safeInsets = false, send, onChip, refuse = () => false }) {
232
234
  let root = null;
233
235
  let sheet = null;
234
236
  let countdown = null;
@@ -251,6 +253,11 @@ export function makeBallot({ safeInsets = false, send, onChip }) {
251
253
 
252
254
  function press(what) {
253
255
  const result = tap(current, lines, sel, what, performance.now());
256
+ // A refused send keeps the pick as it was, with nothing pending.
257
+ if (result.send && refuse()) {
258
+ key = '';
259
+ return;
260
+ }
254
261
  sel = result.sel;
255
262
  if (result.send) {
256
263
  onChip?.();
@@ -311,11 +318,16 @@ export function makeBallot({ safeInsets = false, send, onChip }) {
311
318
  const votes = el('div', { position: 'absolute', right: '4px', top: '4px', minWidth: '22px', height: '22px', padding: '0 6px', boxSizing: 'border-box', borderRadius: '11px', background: face.votes > 0 ? GOLD : 'rgba(255,255,255,0.2)', color: face.votes > 0 ? '#2b2118' : '#fff', font: '800 15px/22px system-ui, sans-serif', textAlign: 'center', pointerEvents: 'none' }, node);
312
319
  votes.textContent = String(face.votes);
313
320
  }
321
+ // v1.179: a player the place is holding while they are away; still tappable.
322
+ if (face.away === true) {
323
+ const away = el('div', { position: 'absolute', right: '4px', bottom: '4px', padding: '0 5px', height: '16px', borderRadius: '8px', background: 'rgba(255,255,255,0.22)', color: '#fff', font: '700 11px/16px system-ui, sans-serif', pointerEvents: 'none' }, node);
324
+ away.textContent = 'away';
325
+ }
314
326
  if (card.picked?.face === face.id) {
315
327
  const tick = el('div', { position: 'absolute', left: '4px', bottom: '4px', width: '20px', height: '20px', borderRadius: '10px', background: GOLD, color: '#2b2118', font: '800 13px/20px system-ui, sans-serif', textAlign: 'center', pointerEvents: 'none' }, node);
316
328
  tick.textContent = '✓';
317
329
  }
318
- node.setAttribute('aria-label', `${nameOf(card, face.id, selfId)}${face.note ? `, ${face.note}` : ''}${Number.isInteger(face.votes) ? `, ${face.votes} votes` : ''}`);
330
+ node.setAttribute('aria-label', `${nameOf(card, face.id, selfId)}${face.note ? `, ${face.note}` : ''}${face.away === true ? ', away' : ''}${Number.isInteger(face.votes) ? `, ${face.votes} votes` : ''}`);
319
331
  node.setAttribute('aria-pressed', chosen ? 'true' : 'false');
320
332
  }
321
333
 
@@ -404,15 +416,40 @@ export function makeBallot({ safeInsets = false, send, onChip }) {
404
416
  } else {
405
417
  sheet.scrollTop = scroll;
406
418
  }
407
- // What to do next, brought into view once, as a face is picked.
419
+ // What to do next, brought into view once, as a face is picked: just its
420
+ // first row, so the picked face above stays in view too.
408
421
  const next = vote ?? (chips.isConnected ? chips : null);
409
422
  if (focus && next) {
410
423
  const box = next.parentElement;
411
- const over = next.offsetTop + next.offsetHeight - (box.scrollTop + box.clientHeight) + 12;
424
+ const over = next.offsetTop + Math.min(next.offsetHeight, 56) - (box.scrollTop + box.clientHeight) + 12;
412
425
  if (over > 0) {
413
426
  box.scrollTop += over;
414
427
  }
415
428
  }
429
+ if (landscape) {
430
+ // The columns scroll now; the sheet keeps no fade from portrait.
431
+ sheet.style.maskImage = sheet.style.webkitMaskImage = '';
432
+ }
433
+ for (const box of landscape ? [left, rightBody] : [sheet]) {
434
+ moreBelow(box);
435
+ }
436
+ }
437
+
438
+ // A box with more below its fold fades out at the bottom edge, so a sheet
439
+ // that scrolls says so; the fade goes once the end is in view.
440
+ function moreBelow(box) {
441
+ const update = () => {
442
+ const more = box.scrollHeight - box.scrollTop - box.clientHeight > 8;
443
+ const mask = more ? 'linear-gradient(to bottom, #000 calc(100% - 36px), transparent)' : '';
444
+ if (box.style.maskImage !== mask) {
445
+ box.style.maskImage = box.style.webkitMaskImage = mask;
446
+ }
447
+ };
448
+ if (!box.dataset.ballotMore) {
449
+ box.dataset.ballotMore = 'true';
450
+ box.addEventListener('scroll', update, { passive: true });
451
+ }
452
+ update();
416
453
  }
417
454
 
418
455
  return {