castle-web-cli 0.4.238 → 0.4.240

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (404) hide show
  1. package/dist/agent.js +5 -1
  2. package/dist/api.d.ts +20 -0
  3. package/dist/api.js +57 -0
  4. package/dist/bundle.d.ts +38 -1
  5. package/dist/bundle.js +309 -13
  6. package/dist/castle-host/host.js +218 -11
  7. package/dist/castleJson.d.ts +10 -0
  8. package/dist/castleJson.js +46 -2
  9. package/dist/check.js +5 -2
  10. package/dist/devSessionServer.js +4 -1
  11. package/dist/devSessionStorage.d.ts +1 -0
  12. package/dist/devSessionStorage.js +32 -7
  13. package/dist/importOrder.d.ts +2 -0
  14. package/dist/importOrder.js +29 -0
  15. package/dist/index.js +22 -3
  16. package/dist/init.js +24 -2
  17. package/dist/multiplayerDoc.d.ts +1 -1
  18. package/dist/multiplayerDoc.js +9 -0
  19. package/dist/platformDoc.js +4 -2
  20. package/dist/playPagePolicy.d.ts +1 -0
  21. package/dist/playPagePolicy.js +12 -3
  22. package/dist/resetLeaderboards.d.ts +8 -1
  23. package/dist/resetLeaderboards.js +43 -8
  24. package/dist/roomLogs.d.ts +39 -0
  25. package/dist/roomLogs.js +166 -0
  26. package/dist/save-deck.d.ts +32 -2
  27. package/dist/save-deck.js +240 -39
  28. package/kits/base/CLAUDE.md +2 -1
  29. package/kits/base/castle.json +1 -1
  30. package/kits/base/sdk/README.md +240 -8
  31. package/kits/base/sdk/analytics.d.ts +8 -0
  32. package/kits/base/sdk/analytics.js +92 -0
  33. package/kits/base/sdk/castle.d.ts +8 -2
  34. package/kits/base/sdk/castle.js +3 -0
  35. package/kits/base/sdk/commands.d.ts +79 -0
  36. package/kits/base/sdk/commands.js +1 -0
  37. package/kits/base/sdk/debugConsole.d.ts +17 -0
  38. package/kits/base/sdk/debugConsole.js +154 -0
  39. package/kits/base/sdk/experiments.js +24 -1
  40. package/kits/base/sdk/hostRetry.d.ts +7 -0
  41. package/kits/base/sdk/hostRetry.js +57 -0
  42. package/kits/base/sdk/hub.d.ts +20 -2
  43. package/kits/base/sdk/hub.js +99 -13
  44. package/kits/base/sdk/multiplayer.d.ts +2 -0
  45. package/kits/base/sdk/multiplayer.js +198 -26
  46. package/kits/base/sdk/reconnectBudget.d.ts +6 -0
  47. package/kits/base/sdk/reconnectBudget.js +41 -1
  48. package/kits/base/sdk/rooms.d.ts +11 -0
  49. package/kits/base/sdk/rooms.js +22 -0
  50. package/kits/base/sdk/runtime.js +36 -19
  51. package/kits/base/sdk/server/hub.d.ts +19 -0
  52. package/kits/base/sdk/server/hub.js +12 -0
  53. package/kits/base/sdk/server/platformHandle.d.ts +1 -0
  54. package/kits/base/sdk/server/wrapper.d.ts +1 -1
  55. package/kits/base/sdk/server/wrapper.js +26 -1
  56. package/kits/base/sdk/store.d.ts +8 -2
  57. package/kits/base/sdk/store.js +5 -1
  58. package/kits/base/sdk/transport.d.ts +2 -1
  59. package/kits/base/sdk/transport.js +35 -0
  60. package/kits/hub-game/CLAUDE.md +66 -19
  61. package/kits/hub-game/castle.json +4 -4
  62. package/kits/hub-game/code/client/act.js +9 -6
  63. package/kits/hub-game/code/client/actCore.js +26 -6
  64. package/kits/hub-game/code/client/actGateLog.js +36 -0
  65. package/kits/hub-game/code/client/actionOverflow.js +29 -8
  66. package/kits/hub-game/code/client/actionRailSurface.js +186 -0
  67. package/kits/hub-game/code/client/actionRailTree.js +173 -0
  68. package/kits/hub-game/code/client/askSurface.js +85 -0
  69. package/kits/hub-game/code/client/askTree.js +51 -0
  70. package/kits/hub-game/code/client/attention.js +31 -6
  71. package/kits/hub-game/code/client/ballot.js +42 -5
  72. package/kits/hub-game/code/client/ballotSurface.js +115 -0
  73. package/kits/hub-game/code/client/ballotTree.js +180 -0
  74. package/kits/hub-game/code/client/catchingUp.js +19 -0
  75. package/kits/hub-game/code/client/celebrate.js +66 -0
  76. package/kits/hub-game/code/client/chrome.js +474 -53
  77. package/kits/hub-game/code/client/companion.js +93 -23
  78. package/kits/hub-game/code/client/companionDress.js +1 -1
  79. package/kits/hub-game/code/client/cornerSurface.js +106 -0
  80. package/kits/hub-game/code/client/cornerTree.js +83 -0
  81. package/kits/hub-game/code/client/decor.js +20 -11
  82. package/kits/hub-game/code/client/deviceStorage.js +121 -0
  83. package/kits/hub-game/code/client/disguise.js +23 -0
  84. package/kits/hub-game/code/client/disguiseDraw.js +87 -0
  85. package/kits/hub-game/code/client/dockSurface.js +206 -0
  86. package/kits/hub-game/code/client/dockTree.js +232 -0
  87. package/kits/hub-game/code/client/earned.js +29 -0
  88. package/kits/hub-game/code/client/emoteSurface.js +188 -0
  89. package/kits/hub-game/code/client/emoteTree.js +264 -0
  90. package/kits/hub-game/code/client/farAvatars.js +4 -3
  91. package/kits/hub-game/code/client/fpsTelemetry.js +3 -1
  92. package/kits/hub-game/code/client/grab.js +121 -50
  93. package/kits/hub-game/code/client/holdShow.js +19 -0
  94. package/kits/hub-game/code/client/hookLayer.js +96 -12
  95. package/kits/hub-game/code/client/hubControls.js +7 -1
  96. package/kits/hub-game/code/client/hudSurface.js +11 -3
  97. package/kits/hub-game/code/client/hudTree.js +7 -4
  98. package/kits/hub-game/code/client/idle.js +21 -3
  99. package/kits/hub-game/code/client/invites.js +24 -3
  100. package/kits/hub-game/code/client/keys.js +15 -0
  101. package/kits/hub-game/code/client/labelsNear.js +8 -1
  102. package/kits/hub-game/code/client/layoutCache.js +57 -8
  103. package/kits/hub-game/code/client/loadingCover.js +53 -4
  104. package/kits/hub-game/code/client/menuIcons.js +15 -0
  105. package/kits/hub-game/code/client/menuRows.js +8 -2
  106. package/kits/hub-game/code/client/menuSurface.js +102 -0
  107. package/kits/hub-game/code/client/menuTree.js +135 -0
  108. package/kits/hub-game/code/client/modelLook.js +41 -0
  109. package/kits/hub-game/code/client/pickerSurface.js +152 -0
  110. package/kits/hub-game/code/client/pickerTree.js +163 -0
  111. package/kits/hub-game/code/client/pushVisit.js +4 -2
  112. package/kits/hub-game/code/client/quality.js +188 -29
  113. package/kits/hub-game/code/client/qualityEntry.js +10 -1
  114. package/kits/hub-game/code/client/quickChatSurface.js +222 -0
  115. package/kits/hub-game/code/client/quickChatTree.js +201 -0
  116. package/kits/hub-game/code/client/rehello.js +75 -0
  117. package/kits/hub-game/code/client/renderVisibility.js +17 -0
  118. package/kits/hub-game/code/client/replay.js +118 -0
  119. package/kits/hub-game/code/client/role.js +3 -0
  120. package/kits/hub-game/code/client/safeLayout.js +441 -56
  121. package/kits/hub-game/code/client/safeStyle.js +13 -10
  122. package/kits/hub-game/code/client/say.js +2 -0
  123. package/kits/hub-game/code/client/soundSurface.js +77 -0
  124. package/kits/hub-game/code/client/soundTree.js +74 -0
  125. package/kits/hub-game/code/client/soundscape.js +12 -9
  126. package/kits/hub-game/code/client/soundscapeCues.js +1 -1
  127. package/kits/hub-game/code/client/state.js +67 -1
  128. package/kits/hub-game/code/client/stuckSurface.js +76 -0
  129. package/kits/hub-game/code/client/stuckTree.js +67 -0
  130. package/kits/hub-game/code/client/talk.js +42 -12
  131. package/kits/hub-game/code/client/talkTree.js +4 -2
  132. package/kits/hub-game/code/client/textAskSurface.js +147 -0
  133. package/kits/hub-game/code/client/textAskTree.js +67 -0
  134. package/kits/hub-game/code/client/tiers.js +252 -27
  135. package/kits/hub-game/code/client/together.js +4 -1
  136. package/kits/hub-game/code/client/uiDom.js +86 -8
  137. package/kits/hub-game/code/client/uiTree.js +33 -4
  138. package/kits/hub-game/code/client/vehicle.js +75 -52
  139. package/kits/hub-game/code/client/weakestTier.js +75 -31
  140. package/kits/hub-game/code/client/wear.js +159 -5
  141. package/kits/hub-game/code/client/worldLabels.js +215 -26
  142. package/kits/hub-game/code/companionSpec.js +4 -2
  143. package/kits/hub-game/code/server/act.js +3 -0
  144. package/kits/hub-game/code/server/actGate.js +83 -0
  145. package/kits/hub-game/code/server/actions.js +71 -15
  146. package/kits/hub-game/code/server/actors.js +20 -5
  147. package/kits/hub-game/code/server/analytics.js +40 -15
  148. package/kits/hub-game/code/server/ask.js +39 -3
  149. package/kits/hub-game/code/server/ballot.js +167 -4
  150. package/kits/hub-game/code/server/celebrate.js +64 -0
  151. package/kits/hub-game/code/server/companion.js +17 -2
  152. package/kits/hub-game/code/server/decor.js +11 -2
  153. package/kits/hub-game/code/server/disguise.js +63 -0
  154. package/kits/hub-game/code/server/doorAnalytics.js +2 -5
  155. package/kits/hub-game/code/server/earned.js +6 -2
  156. package/kits/hub-game/code/server/friendBests.js +13 -4
  157. package/kits/hub-game/code/server/friendsAmong.js +67 -8
  158. package/kits/hub-game/code/server/grab.js +12 -2
  159. package/kits/hub-game/code/server/heldOffers.js +142 -0
  160. package/kits/hub-game/code/server/holdShow.js +98 -0
  161. package/kits/hub-game/code/server/hub.js +854 -45
  162. package/kits/hub-game/code/server/idle.js +110 -9
  163. package/kits/hub-game/code/server/index.js +9 -0
  164. package/kits/hub-game/code/server/labels.js +13 -3
  165. package/kits/hub-game/code/server/loadAbandon.js +2 -5
  166. package/kits/hub-game/code/server/manifest.js +94 -6
  167. package/kits/hub-game/code/server/menu.js +26 -3
  168. package/kits/hub-game/code/server/npcs.js +55 -9
  169. package/kits/hub-game/code/server/observe.js +67 -6
  170. package/kits/hub-game/code/server/players.js +8 -1
  171. package/kits/hub-game/code/server/replay.js +135 -0
  172. package/kits/hub-game/code/server/storageLimit.js +4 -1
  173. package/kits/hub-game/code/server/townDay.js +74 -0
  174. package/kits/hub-game/code/server/trackQueue.js +29 -0
  175. package/kits/hub-game/code/server/vehicle.js +3 -0
  176. package/kits/hub-game/code/server/vis.js +26 -4
  177. package/kits/hub-game/code/server/wallet.js +677 -0
  178. package/kits/hub-game/code/server/wear.js +13 -3
  179. package/kits/hub-game/code/server/writerLease.js +191 -0
  180. package/kits/hub-game/code/shared/act.js +1 -1
  181. package/kits/hub-game/code/shared/expression.js +6 -0
  182. package/kits/hub-game/code/shared/replay.js +37 -0
  183. package/kits/hub-game/code/systems/hub.js +437 -57
  184. package/kits/hub-game/docs/analytics.md +20 -3
  185. package/kits/hub-game/docs/contract.md +942 -99
  186. package/kits/hub-game/docs/home-pieces.md +5 -6
  187. package/kits/hub-game/docs/observed-progress.md +49 -1
  188. package/kits/hub-game/docs/vehicle-preset.md +23 -0
  189. package/kits/hub-game/index.html +1 -0
  190. package/kits/hub-game/models/hats/baker-cap.pxmodel +3 -3
  191. package/kits/hub-game/models/hats/bat-clip.pxmodel +3 -3
  192. package/kits/hub-game/models/hats/beekeeper.pxmodel +3 -3
  193. package/kits/hub-game/models/hats/cap.pxmodel +3 -3
  194. package/kits/hub-game/models/hats/captain.pxmodel +3 -3
  195. package/kits/hub-game/models/hats/chef-toque.pxmodel +3 -3
  196. package/kits/hub-game/models/hats/crooked-top.pxmodel +3 -3
  197. package/kits/hub-game/models/hats/delivery-cap.pxmodel +3 -3
  198. package/kits/hub-game/models/hats/fire-helmet.pxmodel +3 -3
  199. package/kits/hub-game/models/hats/flower-crown.pxmodel +3 -3
  200. package/kits/hub-game/models/hats/foam-crown.pxmodel +3 -3
  201. package/kits/hub-game/models/hats/hard-hat.pxmodel +3 -3
  202. package/kits/hub-game/models/hats/lantern.pxmodel +3 -3
  203. package/kits/hub-game/models/hats/laurel.pxmodel +3 -3
  204. package/kits/hub-game/models/hats/lighthouse.pxmodel +3 -3
  205. package/kits/hub-game/models/hats/nurse-cap.pxmodel +3 -3
  206. package/kits/hub-game/models/hats/police-cap.pxmodel +3 -3
  207. package/kits/hub-game/models/hats/sailor.pxmodel +3 -3
  208. package/kits/hub-game/models/hats/souwester.pxmodel +3 -3
  209. package/kits/hub-game/models/hats/straw.pxmodel +3 -3
  210. package/kits/hub-game/models/hats/sunflower.pxmodel +3 -3
  211. package/kits/hub-game/models/hats/sweatband.pxmodel +3 -3
  212. package/kits/hub-game/models/hats/teacher-beret.pxmodel +3 -3
  213. package/kits/hub-game/models/hats/witch.pxmodel +3 -3
  214. package/kits/hub-game/models/hold-show/daisy.pxmodel +231 -0
  215. package/kits/hub-game/models/hold-show/moonflower.pxmodel +171 -0
  216. package/kits/hub-game/models/hold-show/rose.pxmodel +191 -0
  217. package/kits/hub-game/models/hold-show/square/daisy.pxmodel +233 -0
  218. package/kits/hub-game/models/hold-show/square/moonflower.pxmodel +173 -0
  219. package/kits/hub-game/models/hold-show/square/rose.pxmodel +193 -0
  220. package/kits/hub-game/models/hold-show/square/sunflower.pxmodel +313 -0
  221. package/kits/hub-game/models/hold-show/square/tulip.pxmodel +133 -0
  222. package/kits/hub-game/models/hold-show/sunflower.pxmodel +311 -0
  223. package/kits/hub-game/models/hold-show/tulip.pxmodel +131 -0
  224. package/kits/hub-game/package-lock.json +3 -3
  225. package/kits/hub-game/package.json +4 -3
  226. package/kits/hub-game/scripts/fixtures/engine-models-stub.mjs +1 -0
  227. package/kits/hub-game/scripts/fixtures/hud-surface.json +12 -12
  228. package/kits/hub-game/scripts/fixtures/talk-surface.json +8 -8
  229. package/kits/hub-game/scripts/gen-hats.mjs +1 -1
  230. package/kits/hub-game/scripts/gen-hold-show.mjs +27 -0
  231. package/kits/hub-game/scripts/pack.mjs +89 -23
  232. package/kits/hub-game/scripts/test-act-client.mjs +5 -0
  233. package/kits/hub-game/scripts/test-act-core.mjs +32 -0
  234. package/kits/hub-game/scripts/test-act-gate.mjs +186 -0
  235. package/kits/hub-game/scripts/test-action-rail-crowded-dom.mjs +7 -1
  236. package/kits/hub-game/scripts/test-action-rail-default-dom.mjs +102 -0
  237. package/kits/hub-game/scripts/test-action-rail-never-silent-dom.mjs +50 -0
  238. package/kits/hub-game/scripts/test-action-rail-surface.mjs +368 -0
  239. package/kits/hub-game/scripts/test-action-rail-town-jobs-dom.mjs +118 -0
  240. package/kits/hub-game/scripts/test-actions-client.mjs +5 -3
  241. package/kits/hub-game/scripts/test-actions.mjs +24 -0
  242. package/kits/hub-game/scripts/test-actors.mjs +19 -0
  243. package/kits/hub-game/scripts/test-again-corner-dom.mjs +59 -0
  244. package/kits/hub-game/scripts/test-analytics.mjs +80 -1
  245. package/kits/hub-game/scripts/test-arrival-pose-server.mjs +25 -8
  246. package/kits/hub-game/scripts/test-ask-client.mjs +9 -0
  247. package/kits/hub-game/scripts/test-ask-surface.mjs +188 -0
  248. package/kits/hub-game/scripts/test-attention.mjs +43 -1
  249. package/kits/hub-game/scripts/test-ballot-sheet-dom.mjs +71 -0
  250. package/kits/hub-game/scripts/test-ballot-surface.mjs +276 -0
  251. package/kits/hub-game/scripts/test-ballot.mjs +420 -3
  252. package/kits/hub-game/scripts/test-ban-join.mjs +1 -1
  253. package/kits/hub-game/scripts/test-celebrate-client.mjs +62 -0
  254. package/kits/hub-game/scripts/test-celebrate.mjs +116 -0
  255. package/kits/hub-game/scripts/test-chat.mjs +73 -0
  256. package/kits/hub-game/scripts/test-companion-client.mjs +203 -21
  257. package/kits/hub-game/scripts/test-companion.mjs +110 -3
  258. package/kits/hub-game/scripts/test-control-layout-dom.mjs +57 -10
  259. package/kits/hub-game/scripts/test-corner-surface.mjs +268 -0
  260. package/kits/hub-game/scripts/test-decor-client.mjs +59 -3
  261. package/kits/hub-game/scripts/test-decor.mjs +27 -0
  262. package/kits/hub-game/scripts/test-device-class.mjs +4 -1
  263. package/kits/hub-game/scripts/test-disguise-client.mjs +281 -0
  264. package/kits/hub-game/scripts/test-disguise.mjs +176 -0
  265. package/kits/hub-game/scripts/test-dock-surface.mjs +404 -0
  266. package/kits/hub-game/scripts/test-door-analytics.mjs +1 -1
  267. package/kits/hub-game/scripts/test-door-stay-client.mjs +602 -0
  268. package/kits/hub-game/scripts/test-door-stay.mjs +613 -0
  269. package/kits/hub-game/scripts/test-earned-client.mjs +119 -0
  270. package/kits/hub-game/scripts/test-emote-surface.mjs +616 -0
  271. package/kits/hub-game/scripts/test-fps-telemetry.mjs +39 -4
  272. package/kits/hub-game/scripts/test-friend-bests.mjs +38 -12
  273. package/kits/hub-game/scripts/test-ghost-click-dom.mjs +75 -0
  274. package/kits/hub-game/scripts/test-grab-client.mjs +29 -2
  275. package/kits/hub-game/scripts/test-grab-orbit.mjs +260 -11
  276. package/kits/hub-game/scripts/test-grab.mjs +10 -1
  277. package/kits/hub-game/scripts/test-hats.mjs +28 -0
  278. package/kits/hub-game/scripts/test-held-offers.mjs +394 -0
  279. package/kits/hub-game/scripts/test-high-only.mjs +3 -3
  280. package/kits/hub-game/scripts/test-hold-show-client.mjs +175 -0
  281. package/kits/hub-game/scripts/test-hold-show.mjs +355 -0
  282. package/kits/hub-game/scripts/test-hub-controls.mjs +3 -1
  283. package/kits/hub-game/scripts/test-hub-idle.mjs +348 -0
  284. package/kits/hub-game/scripts/test-hub-leaving.mjs +21 -0
  285. package/kits/hub-game/scripts/test-hub-ops.mjs +147 -0
  286. package/kits/hub-game/scripts/test-hub-trip.mjs +260 -5
  287. package/kits/hub-game/scripts/test-hud-clear.mjs +83 -0
  288. package/kits/hub-game/scripts/test-hud-rate.mjs +2 -1
  289. package/kits/hub-game/scripts/test-idle.mjs +160 -0
  290. package/kits/hub-game/scripts/test-invites-client.mjs +53 -0
  291. package/kits/hub-game/scripts/test-labels.mjs +11 -0
  292. package/kits/hub-game/scripts/test-landscape-layout.mjs +20 -0
  293. package/kits/hub-game/scripts/test-load-abandon.mjs +2 -2
  294. package/kits/hub-game/scripts/test-loading-cover.mjs +67 -1
  295. package/kits/hub-game/scripts/test-manifest.mjs +27 -0
  296. package/kits/hub-game/scripts/test-menu-client.mjs +55 -6
  297. package/kits/hub-game/scripts/test-menu-surface.mjs +236 -0
  298. package/kits/hub-game/scripts/test-npcs.mjs +128 -0
  299. package/kits/hub-game/scripts/test-observed.mjs +171 -3
  300. package/kits/hub-game/scripts/test-pack.mjs +166 -0
  301. package/kits/hub-game/scripts/test-picker-surface.mjs +321 -0
  302. package/kits/hub-game/scripts/test-placeat-server.mjs +395 -0
  303. package/kits/hub-game/scripts/test-placement-cache.mjs +1 -1
  304. package/kits/hub-game/scripts/test-pointer-clear-dom.mjs +82 -0
  305. package/kits/hub-game/scripts/test-progress-reset.mjs +184 -6
  306. package/kits/hub-game/scripts/test-push-visit.mjs +9 -0
  307. package/kits/hub-game/scripts/test-quality.mjs +312 -9
  308. package/kits/hub-game/scripts/test-quick-chat-surface.mjs +511 -0
  309. package/kits/hub-game/scripts/test-rehello.mjs +237 -0
  310. package/kits/hub-game/scripts/test-rejoin-yaw.mjs +138 -0
  311. package/kits/hub-game/scripts/test-relations-among.mjs +13 -7
  312. package/kits/hub-game/scripts/test-relations-refresh.mjs +90 -2
  313. package/kits/hub-game/scripts/test-replay-client.mjs +110 -0
  314. package/kits/hub-game/scripts/test-replay.mjs +178 -0
  315. package/kits/hub-game/scripts/test-resume-held.mjs +13 -0
  316. package/kits/hub-game/scripts/test-resume-pose-server.mjs +43 -5
  317. package/kits/hub-game/scripts/test-resync.mjs +13 -0
  318. package/kits/hub-game/scripts/test-role-client.mjs +10 -3
  319. package/kits/hub-game/scripts/test-safe-act.mjs +233 -0
  320. package/kits/hub-game/scripts/test-safe-caption.mjs +364 -0
  321. package/kits/hub-game/scripts/test-safe-layout.mjs +79 -0
  322. package/kits/hub-game/scripts/test-safe-prompt.mjs +163 -0
  323. package/kits/hub-game/scripts/test-sound-surface.mjs +256 -0
  324. package/kits/hub-game/scripts/test-soundscape.mjs +85 -2
  325. package/kits/hub-game/scripts/test-stuck-surface.mjs +174 -0
  326. package/kits/hub-game/scripts/test-stuck.mjs +31 -0
  327. package/kits/hub-game/scripts/test-talk-surface.mjs +23 -6
  328. package/kits/hub-game/scripts/test-talk-walk-dom.mjs +123 -0
  329. package/kits/hub-game/scripts/test-text-ask-surface.mjs +273 -0
  330. package/kits/hub-game/scripts/test-tiers.mjs +453 -3
  331. package/kits/hub-game/scripts/test-toast-no-row-dom.mjs +71 -0
  332. package/kits/hub-game/scripts/test-together.mjs +11 -0
  333. package/kits/hub-game/scripts/test-town-day.mjs +90 -0
  334. package/kits/hub-game/scripts/test-track-queue.mjs +64 -0
  335. package/kits/hub-game/scripts/test-try-on.mjs +39 -0
  336. package/kits/hub-game/scripts/test-ui-dom-dom.mjs +49 -2
  337. package/kits/hub-game/scripts/test-ui-tree.mjs +28 -0
  338. package/kits/hub-game/scripts/test-vehicle-client.mjs +77 -1
  339. package/kits/hub-game/scripts/test-vis.mjs +145 -0
  340. package/kits/hub-game/scripts/test-wallet.mjs +650 -0
  341. package/kits/hub-game/scripts/test-weakest-tier.mjs +135 -1
  342. package/kits/hub-game/scripts/test-world-labels.mjs +380 -0
  343. package/kits/hub-game/scripts/test-writer-lease-server.mjs +234 -0
  344. package/kits/hub-game/scripts/test-writer-lease.mjs +281 -0
  345. package/kits/hub-game/scripts/writer-storage-fixture.mjs +37 -0
  346. package/kits/hub-game/tools/hubScene/export.mjs +6 -5
  347. package/kits/hub-game/tools/hubScene/hubdata.mjs +10 -0
  348. package/kits/hub-game/tools/hubScene/test/export-fixture.mjs +48 -2
  349. package/kits/hub-game/tools/hubScene/validate-manifest.mjs +21 -3
  350. package/kits/multiplayer-3d/castle.json +5 -5
  351. package/kits/multiplayer-3d/code/client/resumeGate.js +49 -2
  352. package/kits/multiplayer-3d/code/server/ownership.js +25 -6
  353. package/kits/multiplayer-3d/code/server/world.js +19 -4
  354. package/kits/multiplayer-3d/code/systems/multiplayer.js +67 -11
  355. package/kits/multiplayer-3d/package-lock.json +1 -1
  356. package/kits/multiplayer-3d/package.json +2 -1
  357. package/kits/multiplayer-3d/scripts/test-ground-half.mjs +56 -0
  358. package/kits/multiplayer-3d/scripts/test-join-watchdog.mjs +54 -3
  359. package/kits/multiplayer-3d/scripts/test-owned-moves.mjs +190 -0
  360. package/kits/multiplayer-3d/scripts/test-resume-gate.mjs +191 -5
  361. package/kits/multiplayer-3d/scripts/test-resync-reconnect.mjs +68 -0
  362. package/kits/physics-2d/castle.json +2 -2
  363. package/kits/physics-2d/engine/scene.js +10 -2
  364. package/kits/physics-3d/CLAUDE.md +14 -0
  365. package/kits/physics-3d/behaviors/Player.jsx +39 -3
  366. package/kits/physics-3d/castle.json +3 -3
  367. package/kits/physics-3d/docs/engine-model-cache.md +109 -0
  368. package/kits/physics-3d/docs/engine-player.md +76 -0
  369. package/kits/physics-3d/docs/engine-skip-work.md +16 -0
  370. package/kits/physics-3d/docs/pxmodel-format.md +5 -1
  371. package/kits/physics-3d/engine3d/gait.js +16 -8
  372. package/kits/physics-3d/engine3d/groundsize.js +23 -0
  373. package/kits/physics-3d/engine3d/kithooks.js +50 -0
  374. package/kits/physics-3d/engine3d/look.js +110 -17
  375. package/kits/physics-3d/engine3d/lookbake.js +19 -1
  376. package/kits/physics-3d/engine3d/materialpresets.js +3 -2
  377. package/kits/physics-3d/engine3d/modelcache.js +280 -0
  378. package/kits/physics-3d/engine3d/modelcachedigest.js +37 -0
  379. package/kits/physics-3d/engine3d/modelcachegate.js +69 -0
  380. package/kits/physics-3d/engine3d/modelrefs.js +13 -0
  381. package/kits/physics-3d/engine3d/optimize.js +20 -9
  382. package/kits/physics-3d/engine3d/playerRun.js +26 -1
  383. package/kits/physics-3d/engine3d/pxmodel.js +7 -3
  384. package/kits/physics-3d/engine3d/templatecache.js +722 -0
  385. package/kits/physics-3d/engine3d/world3d.js +211 -17
  386. package/kits/physics-3d/package-lock.json +1 -1
  387. package/kits/physics-3d/package.json +2 -1
  388. package/kits/physics-3d/play/behaviors/Player.js +43 -3
  389. package/kits/physics-3d/scripts/render.mjs +56 -8
  390. package/kits/physics-3d/scripts/template-cache-fixtures.mjs +37 -0
  391. package/kits/physics-3d/scripts/template-cache-v1-bytes.json +49 -0
  392. package/kits/physics-3d/scripts/test-gait.mjs +53 -9
  393. package/kits/physics-3d/scripts/test-ground-half.mjs +120 -0
  394. package/kits/physics-3d/scripts/test-model-cache.mjs +600 -0
  395. package/kits/physics-3d/scripts/test-orbit-shadow-fade.mjs +1 -0
  396. package/kits/physics-3d/scripts/test-sleeping-models.mjs +384 -0
  397. package/kits/physics-3d/scripts/test-template-cache-minified.mjs +106 -0
  398. package/kits/physics-3d/scripts/test-template-cache.mjs +519 -0
  399. package/kits/physics-3d/scripts/test-wall-slide.mjs +272 -0
  400. package/kits/physics-3d/systems/physics3d.js +51 -2
  401. package/kits/real-time/castle.json +2 -2
  402. package/kits/real-time/code/client/connection.js +3 -0
  403. package/package.json +2 -2
  404. package/vendor/three/examples/jsm/libs/fflate.module.js +2672 -0
@@ -41,7 +41,11 @@ function element(tag, style, parent) {
41
41
  // DOM controller for a scene that explicitly asks for action overflow. The
42
42
  // legacy chrome never constructs it, so marker-absent scenes retain their old
43
43
  // allocations, listeners and measurements exactly.
44
- export function makeActionOverflow({ root, edgeMax = false, readSafeInsets = null, obstacles, reserved = () => [], onOpen = () => {}, focusFallback = () => null, view = globalThis.window }) {
44
+ // `transient()` lists, in the order they may be given up, groups of the
45
+ // obstacles that are passing text (the prompt and a toast, then the HUD's
46
+ // title): when no place clears everything, the rail goes over them rather
47
+ // than hiding, so an offer is never dropped without a trace.
48
+ export function makeActionOverflow({ root, edgeMax = false, readSafeInsets = null, obstacles, held = () => null, transient = () => [], reserved = () => [], onOpen = () => {}, focusFallback = () => null, view = globalThis.window }) {
45
49
  let items = [];
46
50
  let offerN;
47
51
  let handler = null;
@@ -130,7 +134,10 @@ export function makeActionOverflow({ root, edgeMax = false, readSafeInsets = nul
130
134
  event.stopPropagation();
131
135
  }
132
136
 
133
- function activate(id, node) {
137
+ // A pointer press leaves no focus behind (as the legacy chips did): a
138
+ // focused chip would keep the movement keys. Keyboard use keeps focus.
139
+ function activate(id, node, byPointer = false) {
140
+ if (byPointer && !open) {node.blur();}
134
141
  if (!canAct || pressed.has(node) || !items.some((item) => item.id === id)) {return;}
135
142
  pressed.add(node);
136
143
  const currentN = offerN;
@@ -142,7 +149,7 @@ export function makeActionOverflow({ root, edgeMax = false, readSafeInsets = nul
142
149
  timers.delete(timer);
143
150
  pressed.delete(node);
144
151
  node.style.transform = '';
145
- if (open && generation === sheetGeneration) {closeSheet();}
152
+ if (open && generation === sheetGeneration) {closeSheet({ focus: !byPointer });}
146
153
  }, 80);
147
154
  timers.add(timer);
148
155
  } else {
@@ -161,9 +168,10 @@ export function makeActionOverflow({ root, edgeMax = false, readSafeInsets = nul
161
168
  for (const type of ['pointerdown', 'pointermove', 'pointerup', 'mousedown', 'mouseup', 'keydown', 'keyup']) {
162
169
  button.addEventListener(type, stop, { signal });
163
170
  }
171
+ button.addEventListener('mousedown', (event) => event.preventDefault(), { signal });
164
172
  button.addEventListener('click', (event) => {
165
173
  event.stopPropagation();
166
- activate(button.dataset.actionId, button);
174
+ activate(button.dataset.actionId, button, event.detail > 0);
167
175
  }, { signal });
168
176
  return button;
169
177
  }
@@ -178,6 +186,7 @@ export function makeActionOverflow({ root, edgeMax = false, readSafeInsets = nul
178
186
  for (const type of ['pointerdown', 'pointermove', 'pointerup', 'mousedown', 'mouseup', 'keydown', 'keyup']) {
179
187
  launcher.addEventListener(type, stop, { signal });
180
188
  }
189
+ launcher.addEventListener('mousedown', (event) => event.preventDefault(), { signal });
181
190
  launcher.addEventListener('click', (event) => {
182
191
  event.stopPropagation();
183
192
  openSheet();
@@ -310,7 +319,12 @@ export function makeActionOverflow({ root, edgeMax = false, readSafeInsets = nul
310
319
  metrics = { viewKey, safe, offerSizes, moreSize, launcherSize, launcherNode };
311
320
  }
312
321
  const { safe, offerSizes, moreSize, launcherSize, launcherNode } = metrics;
313
- const obstacleRects = (obstacles?.() ?? []).map(rectOf).filter(Boolean);
322
+ const obstacleNodes = obstacles?.() ?? [];
323
+ const rectFor = (node) => {
324
+ const box = held(node);
325
+ return box ? { left: box.left, right: box.right, top: box.top, bottom: box.bottom } : rectOf(node);
326
+ };
327
+ const obstacleRects = obstacleNodes.map(rectFor).filter(Boolean);
314
328
  const reservedRects = reserved({ w: view.innerWidth, h: view.innerHeight, safe }) ?? [];
315
329
  const key = [view.innerWidth, view.innerHeight, safe.left, safe.right, safe.top, safe.bottom,
316
330
  ...offerSizes.flatMap((size) => [size.w, size.h]), moreSize?.w, moreSize?.h, launcherSize.w, launcherSize.h,
@@ -319,11 +333,18 @@ export function makeActionOverflow({ root, edgeMax = false, readSafeInsets = nul
319
333
  return;
320
334
  }
321
335
  layoutKey = key;
322
- const placed = actionLayout({
336
+ const place = (rects) => actionLayout({
323
337
  view: { w: view.innerWidth, h: view.innerHeight }, safe, offers: offerSizes,
324
338
  ...(edgeMax ? { edgeMax: true } : {}),
325
- more: moreSize, launcher: launcherSize, obstacles: obstacleRects, reserved: reservedRects,
339
+ more: moreSize, launcher: launcherSize, obstacles: rects, reserved: reservedRects,
326
340
  });
341
+ let placed = place(obstacleRects);
342
+ const soft = new Set();
343
+ for (const group of placed ? [] : transient()) {
344
+ group.forEach((node) => soft.add(node));
345
+ placed = place(obstacleNodes.filter((node) => !soft.has(node)).map(rectFor).filter(Boolean));
346
+ if (placed) {break;}
347
+ }
327
348
  if (!placed) {
328
349
  rail.style.display = 'none';
329
350
  if (pendingRailFocus !== null) {
@@ -429,7 +450,7 @@ export function makeActionOverflow({ root, edgeMax = false, readSafeInsets = nul
429
450
  closeButton.type = 'button';
430
451
  closeButton.textContent = 'Close';
431
452
  closeButton.setAttribute('aria-label', 'Close actions');
432
- closeButton.addEventListener('click', (event) => {event.stopPropagation(); closeSheet();}, { signal });
453
+ closeButton.addEventListener('click', (event) => {event.stopPropagation(); closeSheet({ focus: event.detail === 0 });}, { signal });
433
454
  for (const type of ['pointerdown', 'pointermove', 'pointerup', 'pointercancel', 'mousedown', 'mouseup', 'wheel', 'touchstart', 'touchmove', 'contextmenu', 'keydown', 'keyup', 'keypress']) {
434
455
  backdrop.addEventListener(type, (event) => event.stopPropagation(), { signal, passive: false });
435
456
  }
@@ -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;