castle-web-cli 0.4.232 → 0.4.234

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 (587) hide show
  1. package/dist/agent-failures.d.ts +8 -0
  2. package/dist/agent-failures.js +19 -2
  3. package/dist/agent-prompts.d.ts +1 -1
  4. package/dist/agent-prompts.js +10 -3
  5. package/dist/agent.d.ts +64 -3
  6. package/dist/agent.js +170 -81
  7. package/dist/api.d.ts +11 -0
  8. package/dist/api.js +43 -0
  9. package/dist/bundle.d.ts +64 -0
  10. package/dist/bundle.js +558 -2
  11. package/dist/castle-host/host.d.ts +18 -2
  12. package/dist/castle-host/host.js +844 -39
  13. package/dist/castleJson.d.ts +23 -2
  14. package/dist/castleJson.js +46 -2
  15. package/dist/check.d.ts +3 -1
  16. package/dist/check.js +20 -3
  17. package/dist/chunkLoader.d.ts +3 -0
  18. package/dist/chunkLoader.js +111 -0
  19. package/dist/devParty.d.ts +26 -0
  20. package/dist/devParty.js +231 -0
  21. package/dist/devSaveStorage.js +4 -0
  22. package/dist/devSessionStorage.js +50 -2
  23. package/dist/devSocial.d.ts +24 -0
  24. package/dist/devSocial.js +70 -0
  25. package/dist/ide.d.ts +2 -0
  26. package/dist/ide.js +119 -15
  27. package/dist/importPinMismatch.d.ts +22 -0
  28. package/dist/importPinMismatch.js +77 -0
  29. package/dist/importRegression.js +3 -15
  30. package/dist/imports.d.ts +10 -3
  31. package/dist/imports.js +88 -20
  32. package/dist/index.js +11 -4
  33. package/dist/init.js +1 -1
  34. package/dist/platformDoc.js +22 -0
  35. package/dist/routerFences.d.ts +5 -0
  36. package/dist/routerFences.js +12 -2
  37. package/dist/save-deck.d.ts +25 -1
  38. package/dist/save-deck.js +178 -9
  39. package/dist/serve.js +32 -11
  40. package/dist/shell/assets/{index-D2tWM896.js → index-DulbYIJm.js} +97 -97
  41. package/dist/shell/assets/index-MVLfNYd9.css +1 -0
  42. package/dist/shell/index.html +2 -2
  43. package/dist/taskSteer.d.ts +13 -0
  44. package/dist/taskSteer.js +22 -2
  45. package/dist/vitePlugins.d.ts +2 -1
  46. package/dist/vitePlugins.js +13 -0
  47. package/kits/base/castle.json +1 -1
  48. package/kits/base/package-lock.json +1 -1
  49. package/kits/base/sdk/README.md +339 -5
  50. package/kits/base/sdk/avatar.d.ts +6 -2
  51. package/kits/base/sdk/avatar.js +12 -4
  52. package/kits/base/sdk/castle.d.ts +7 -3
  53. package/kits/base/sdk/castle.js +2 -0
  54. package/kits/base/sdk/commands.d.ts +176 -1
  55. package/kits/base/sdk/commands.js +3 -0
  56. package/kits/base/sdk/display.d.ts +3 -0
  57. package/kits/base/sdk/display.js +9 -3
  58. package/kits/base/sdk/hub.d.ts +37 -6
  59. package/kits/base/sdk/hub.js +63 -4
  60. package/kits/base/sdk/multiplayer.d.ts +7 -1
  61. package/kits/base/sdk/multiplayer.js +148 -32
  62. package/kits/base/sdk/multiplayerProtocol.d.ts +2 -0
  63. package/kits/base/sdk/party.d.ts +23 -0
  64. package/kits/base/sdk/party.js +91 -0
  65. package/kits/base/sdk/reconnectBudget.d.ts +23 -0
  66. package/kits/base/sdk/reconnectBudget.js +96 -0
  67. package/kits/base/sdk/save.d.ts +38 -1
  68. package/kits/base/sdk/save.js +81 -7
  69. package/kits/base/sdk/server/hub.d.ts +117 -0
  70. package/kits/base/sdk/server/hub.js +119 -2
  71. package/kits/base/sdk/server/platformHandle.d.ts +43 -1
  72. package/kits/base/sdk/server/storage.d.ts +17 -0
  73. package/kits/base/sdk/server/storage.js +65 -3
  74. package/kits/base/sdk/server/wrapper.d.ts +43 -6
  75. package/kits/base/sdk/server/wrapper.js +93 -9
  76. package/kits/base/sdk/social.d.ts +9 -0
  77. package/kits/base/sdk/social.js +5 -0
  78. package/kits/hub-game/CLAUDE.md +451 -13
  79. package/kits/hub-game/README.md +63 -0
  80. package/kits/hub-game/blueprints/avatar-10.scene +28 -0
  81. package/kits/hub-game/blueprints/avatar-11.scene +28 -0
  82. package/kits/hub-game/blueprints/avatar-12.scene +28 -0
  83. package/kits/hub-game/blueprints/avatar-13.scene +28 -0
  84. package/kits/hub-game/blueprints/avatar-14.scene +28 -0
  85. package/kits/hub-game/blueprints/avatar-15.scene +28 -0
  86. package/kits/hub-game/blueprints/avatar-4.scene +28 -0
  87. package/kits/hub-game/blueprints/avatar-5.scene +28 -0
  88. package/kits/hub-game/blueprints/avatar-6.scene +28 -0
  89. package/kits/hub-game/blueprints/avatar-7.scene +28 -0
  90. package/kits/hub-game/blueprints/avatar-8.scene +28 -0
  91. package/kits/hub-game/blueprints/avatar-9.scene +28 -0
  92. package/kits/hub-game/castle.json +5 -5
  93. package/kits/hub-game/code/client/act.js +312 -0
  94. package/kits/hub-game/code/client/actionLayout.js +147 -0
  95. package/kits/hub-game/code/client/actionOverflow.js +556 -0
  96. package/kits/hub-game/code/client/actorBudget.js +47 -0
  97. package/kits/hub-game/code/client/arrivalCamera.js +50 -0
  98. package/kits/hub-game/code/client/askSlot.js +117 -0
  99. package/kits/hub-game/code/client/attention.js +11 -2
  100. package/kits/hub-game/code/client/avatar.js +311 -35
  101. package/kits/hub-game/code/client/avatarCap.js +228 -0
  102. package/kits/hub-game/code/client/avatarColors.js +70 -0
  103. package/kits/hub-game/code/client/avatarFaces.js +21 -0
  104. package/kits/hub-game/code/client/avatarShare.js +253 -0
  105. package/kits/hub-game/code/client/backVisibility.js +13 -0
  106. package/kits/hub-game/code/client/ballot.js +472 -0
  107. package/kits/hub-game/code/client/build.js +38 -0
  108. package/kits/hub-game/code/client/chat.js +41 -5
  109. package/kits/hub-game/code/client/chatModeration.js +5 -0
  110. package/kits/hub-game/code/client/chrome.js +2144 -160
  111. package/kits/hub-game/code/client/companion.js +716 -0
  112. package/kits/hub-game/code/client/companionDress.js +99 -0
  113. package/kits/hub-game/code/client/crowdNames.js +241 -0
  114. package/kits/hub-game/code/client/decor.js +515 -0
  115. package/kits/hub-game/code/client/defaultEnvironment.js +194 -0
  116. package/kits/hub-game/code/client/doorErrors.js +39 -0
  117. package/kits/hub-game/code/client/earned.js +131 -0
  118. package/kits/hub-game/code/client/emoteBubble.js +75 -0
  119. package/kits/hub-game/code/client/fall.js +18 -0
  120. package/kits/hub-game/code/client/farAvatars.js +233 -0
  121. package/kits/hub-game/code/client/firstJoin.js +9 -2
  122. package/kits/hub-game/code/client/fpsTelemetry.js +50 -0
  123. package/kits/hub-game/code/client/frameBatch.js +5 -0
  124. package/kits/hub-game/code/client/grab.js +368 -29
  125. package/kits/hub-game/code/client/hookLayer.js +385 -20
  126. package/kits/hub-game/code/client/hudCopy.js +51 -0
  127. package/kits/hub-game/code/client/hudRate.js +20 -0
  128. package/kits/hub-game/code/client/idle.js +177 -24
  129. package/kits/hub-game/code/client/interestCap.js +81 -0
  130. package/kits/hub-game/code/client/invites.js +231 -0
  131. package/kits/hub-game/code/client/joinError.js +9 -0
  132. package/kits/hub-game/code/client/keys.js +36 -0
  133. package/kits/hub-game/code/client/labelsNear.js +234 -0
  134. package/kits/hub-game/code/client/landscapeLayout.js +17 -0
  135. package/kits/hub-game/code/client/layoutCache.js +264 -0
  136. package/kits/hub-game/code/client/loadTelemetry.js +20 -0
  137. package/kits/hub-game/code/client/loadingCover.js +148 -0
  138. package/kits/hub-game/code/client/loadingEntry.js +8 -0
  139. package/kits/hub-game/code/client/menuIcons.js +34 -0
  140. package/kits/hub-game/code/client/menuRows.js +43 -0
  141. package/kits/hub-game/code/client/modelReady.js +7 -0
  142. package/kits/hub-game/code/client/pack.js +6 -2
  143. package/kits/hub-game/code/client/packFormat.js +3 -3
  144. package/kits/hub-game/code/client/padCueArrival.js +23 -0
  145. package/kits/hub-game/code/client/padCues.js +112 -0
  146. package/kits/hub-game/code/client/padOccupancy.js +88 -0
  147. package/kits/hub-game/code/client/padReadability.js +26 -0
  148. package/kits/hub-game/code/client/padRings.js +69 -0
  149. package/kits/hub-game/code/client/pushVisit.js +14 -0
  150. package/kits/hub-game/code/client/quality.js +205 -0
  151. package/kits/hub-game/code/client/qualityEntry.js +55 -0
  152. package/kits/hub-game/code/client/rehello.js +167 -0
  153. package/kits/hub-game/code/client/safeLayout.js +338 -0
  154. package/kits/hub-game/code/client/safeStyle.js +42 -0
  155. package/kits/hub-game/code/client/say.js +12 -3
  156. package/kits/hub-game/code/client/shot.js +146 -0
  157. package/kits/hub-game/code/client/shotFit.js +56 -0
  158. package/kits/hub-game/code/client/signIn.js +28 -0
  159. package/kits/hub-game/code/client/sound.js +63 -8
  160. package/kits/hub-game/code/client/soundscape.js +1151 -0
  161. package/kits/hub-game/code/client/soundscapeActions.js +99 -0
  162. package/kits/hub-game/code/client/soundscapeAmbience.js +453 -0
  163. package/kits/hub-game/code/client/soundscapeBaked.js +143 -0
  164. package/kits/hub-game/code/client/soundscapeBusker.js +217 -0
  165. package/kits/hub-game/code/client/soundscapeCourt.js +200 -0
  166. package/kits/hub-game/code/client/soundscapeCrowd.js +331 -0
  167. package/kits/hub-game/code/client/soundscapeCues.js +362 -0
  168. package/kits/hub-game/code/client/soundscapeMap.js +181 -0
  169. package/kits/hub-game/code/client/soundscapeMarket.js +176 -0
  170. package/kits/hub-game/code/client/soundscapeMusic.js +126 -0
  171. package/kits/hub-game/code/client/soundscapeMusicEngine.js +460 -0
  172. package/kits/hub-game/code/client/soundscapeSimlish.js +737 -0
  173. package/kits/hub-game/code/client/soundscapeSongs.js +127 -0
  174. package/kits/hub-game/code/client/soundscapeSongsRound3.js +63 -0
  175. package/kits/hub-game/code/client/soundscapeSynthesis.js +168 -0
  176. package/kits/hub-game/code/client/soundscapeUi.js +211 -0
  177. package/kits/hub-game/code/client/soundscapeVoice.js +1209 -0
  178. package/kits/hub-game/code/client/soundscapeWaves.js +206 -0
  179. package/kits/hub-game/code/client/spin.js +101 -0
  180. package/kits/hub-game/code/client/state.js +162 -1
  181. package/kits/hub-game/code/client/stuck.js +259 -0
  182. package/kits/hub-game/code/client/talk.js +714 -59
  183. package/kits/hub-game/code/client/tiers.js +543 -52
  184. package/kits/hub-game/code/client/toastBand.js +37 -0
  185. package/kits/hub-game/code/client/together.js +39 -2
  186. package/kits/hub-game/code/client/visibility.js +43 -0
  187. package/kits/hub-game/code/client/weakestLookBake.js +92 -0
  188. package/kits/hub-game/code/client/weakestTier.js +295 -0
  189. package/kits/hub-game/code/client/wear.js +461 -170
  190. package/kits/hub-game/code/client/worldLabels.js +241 -0
  191. package/kits/hub-game/code/client/yours.js +200 -0
  192. package/kits/hub-game/code/companionSpec.js +45 -0
  193. package/kits/hub-game/code/npcDisplayText.js +55 -0
  194. package/kits/hub-game/code/privateText.js +7 -0
  195. package/kits/hub-game/code/server/act.js +124 -0
  196. package/kits/hub-game/code/server/actions.js +138 -0
  197. package/kits/hub-game/code/server/actors.js +11 -2
  198. package/kits/hub-game/code/server/analytics.js +83 -0
  199. package/kits/hub-game/code/server/anonymousEntry.js +49 -0
  200. package/kits/hub-game/code/server/arrivalPose.js +36 -0
  201. package/kits/hub-game/code/server/ask.js +155 -0
  202. package/kits/hub-game/code/server/ballot.js +539 -0
  203. package/kits/hub-game/code/server/cells.js +100 -0
  204. package/kits/hub-game/code/server/companion.js +107 -0
  205. package/kits/hub-game/code/server/cues.js +70 -0
  206. package/kits/hub-game/code/server/decor.js +269 -0
  207. package/kits/hub-game/code/server/doorAnalytics.js +52 -0
  208. package/kits/hub-game/code/server/earned.js +478 -0
  209. package/kits/hub-game/code/server/frameBatch.js +183 -0
  210. package/kits/hub-game/code/server/friendBests.js +166 -0
  211. package/kits/hub-game/code/server/friendsAmong.js +272 -0
  212. package/kits/hub-game/code/server/history.js +7 -0
  213. package/kits/hub-game/code/server/hub.js +2510 -95
  214. package/kits/hub-game/code/server/idle.js +60 -12
  215. package/kits/hub-game/code/server/index.js +28 -6
  216. package/kits/hub-game/code/server/invites.js +19 -0
  217. package/kits/hub-game/code/server/labels.js +36 -2
  218. package/kits/hub-game/code/server/loadAbandon.js +106 -0
  219. package/kits/hub-game/code/server/manifest.js +586 -7
  220. package/kits/hub-game/code/server/menu.js +161 -0
  221. package/kits/hub-game/code/server/npcs.js +1025 -113
  222. package/kits/hub-game/code/server/observe.js +408 -0
  223. package/kits/hub-game/code/server/padOccupancy.js +85 -0
  224. package/kits/hub-game/code/server/party.js +2 -2
  225. package/kits/hub-game/code/server/players.js +30 -0
  226. package/kits/hub-game/code/server/resumePose.js +152 -0
  227. package/kits/hub-game/code/server/say.js +1 -1
  228. package/kits/hub-game/code/server/shot.js +110 -0
  229. package/kits/hub-game/code/server/standing.js +123 -0
  230. package/kits/hub-game/code/server/storageLimit.js +187 -0
  231. package/kits/hub-game/code/server/vis.js +175 -0
  232. package/kits/hub-game/code/server/wear.js +12 -0
  233. package/kits/hub-game/code/server/yours.js +59 -0
  234. package/kits/hub-game/code/shared/act.js +35 -0
  235. package/kits/hub-game/code/shared/cues.js +9 -0
  236. package/kits/hub-game/code/shared/danceIdle.js +28 -0
  237. package/kits/hub-game/code/shared/decor.js +41 -0
  238. package/kits/hub-game/code/shared/loadStages.js +12 -0
  239. package/kits/hub-game/code/shared/quality.js +74 -0
  240. package/kits/hub-game/code/shared/say.js +2 -0
  241. package/kits/hub-game/code/shared/shot.js +53 -0
  242. package/kits/hub-game/code/shared/spin.js +57 -0
  243. package/kits/hub-game/code/systems/hub.js +1753 -202
  244. package/kits/hub-game/docs/analytics.md +279 -0
  245. package/kits/hub-game/docs/content-pack.md +1 -1
  246. package/kits/hub-game/docs/contract.md +3475 -77
  247. package/kits/hub-game/docs/home-pieces.md +71 -0
  248. package/kits/hub-game/docs/observed-progress.md +252 -0
  249. package/kits/hub-game/main.jsx +2 -0
  250. package/kits/hub-game/models/avatar-10.pxmodel +28 -0
  251. package/kits/hub-game/models/avatar-11.pxmodel +28 -0
  252. package/kits/hub-game/models/avatar-12.pxmodel +27 -0
  253. package/kits/hub-game/models/avatar-13.pxmodel +24 -0
  254. package/kits/hub-game/models/avatar-14.pxmodel +29 -0
  255. package/kits/hub-game/models/avatar-15.pxmodel +24 -0
  256. package/kits/hub-game/models/avatar-4.pxmodel +29 -0
  257. package/kits/hub-game/models/avatar-5.pxmodel +27 -0
  258. package/kits/hub-game/models/avatar-6.pxmodel +26 -0
  259. package/kits/hub-game/models/avatar-7.pxmodel +25 -0
  260. package/kits/hub-game/models/avatar-8.pxmodel +24 -0
  261. package/kits/hub-game/models/avatar-9.pxmodel +30 -0
  262. package/kits/hub-game/models/earned/badge-round.pxmodel +100 -0
  263. package/kits/hub-game/models/earned/badge-shield.pxmodel +117 -0
  264. package/kits/hub-game/models/earned/badge-star.pxmodel +87 -0
  265. package/kits/hub-game/models/earned/belt-plain.pxmodel +72 -0
  266. package/kits/hub-game/models/earned/held-ball.pxmodel +43 -0
  267. package/kits/hub-game/models/earned/held-lantern.pxmodel +85 -0
  268. package/kits/hub-game/models/earned/held-net.pxmodel +57 -0
  269. package/kits/hub-game/models/earned/held-trophy.pxmodel +109 -0
  270. package/kits/hub-game/models/earned/pin-round.pxmodel +62 -0
  271. package/kits/hub-game/models/earned/sash-plain.pxmodel +66 -0
  272. package/kits/hub-game/models/earned/square/belt-plain.pxmodel +104 -0
  273. package/kits/hub-game/models/earned/square/sash-plain.pxmodel +98 -0
  274. package/kits/hub-game/models/hats/bat-clip.pxmodel +206 -0
  275. package/kits/hub-game/models/hats/beekeeper.pxmodel +149 -0
  276. package/kits/hub-game/models/hats/cap.pxmodel +162 -0
  277. package/kits/hub-game/models/hats/captain.pxmodel +178 -0
  278. package/kits/hub-game/models/hats/crooked-top.pxmodel +172 -0
  279. package/kits/hub-game/models/hats/flower-crown.pxmodel +451 -0
  280. package/kits/hub-game/models/hats/foam-crown.pxmodel +179 -0
  281. package/kits/hub-game/models/hats/lantern.pxmodel +230 -0
  282. package/kits/hub-game/models/hats/laurel.pxmodel +533 -0
  283. package/kits/hub-game/models/hats/lighthouse.pxmodel +96 -0
  284. package/kits/hub-game/models/hats/sailor.pxmodel +141 -0
  285. package/kits/hub-game/models/hats/souwester.pxmodel +131 -0
  286. package/kits/hub-game/models/hats/straw.pxmodel +139 -0
  287. package/kits/hub-game/models/hats/sunflower.pxmodel +406 -0
  288. package/kits/hub-game/models/hats/sweatband.pxmodel +112 -0
  289. package/kits/hub-game/models/hats/witch.pxmodel +147 -0
  290. package/kits/hub-game/package-lock.json +10 -1
  291. package/kits/hub-game/package.json +6 -2
  292. package/kits/hub-game/play/player.js +142 -0
  293. package/kits/hub-game/play/registry.js +47 -0
  294. package/kits/hub-game/play.jsx +37 -0
  295. package/kits/hub-game/scripts/check.mjs +117 -16
  296. package/kits/hub-game/scripts/companion-follower-wire.json +1 -0
  297. package/kits/hub-game/scripts/fixtures/decor-keyless-draw.json +132 -0
  298. package/kits/hub-game/scripts/fixtures/decor-keyless.json +293 -0
  299. package/kits/hub-game/scripts/fixtures/engine-models-stub.mjs +26 -0
  300. package/kits/hub-game/scripts/fixtures/fake-dom.mjs +123 -0
  301. package/kits/hub-game/scripts/fixtures/interest-legacy.json +385 -0
  302. package/kits/hub-game/scripts/fixtures/npc-notes-v1.77.jsonl +4 -0
  303. package/kits/hub-game/scripts/fixtures/vis-shared-wire.json +1 -0
  304. package/kits/hub-game/scripts/gen-avatars.mjs +933 -16
  305. package/kits/hub-game/scripts/gen-earned.mjs +285 -0
  306. package/kits/hub-game/scripts/gen-hats.mjs +827 -0
  307. package/kits/hub-game/scripts/grab.before-orbit.mjs +400 -0
  308. package/kits/hub-game/scripts/pose-storage-fixture.mjs +46 -0
  309. package/kits/hub-game/scripts/soundscape-wave-analysis.mjs +125 -0
  310. package/kits/hub-game/scripts/test-act-client.mjs +186 -0
  311. package/kits/hub-game/scripts/test-act.mjs +171 -0
  312. package/kits/hub-game/scripts/test-action-layout.mjs +80 -0
  313. package/kits/hub-game/scripts/test-action-observers.mjs +46 -0
  314. package/kits/hub-game/scripts/test-actions-client.mjs +853 -0
  315. package/kits/hub-game/scripts/test-actions.mjs +298 -0
  316. package/kits/hub-game/scripts/test-actor-budget.mjs +44 -0
  317. package/kits/hub-game/scripts/test-actors.mjs +38 -23
  318. package/kits/hub-game/scripts/test-analytics.mjs +76 -0
  319. package/kits/hub-game/scripts/test-anonymous-entry.mjs +28 -0
  320. package/kits/hub-game/scripts/test-arrival-pose-server.mjs +196 -0
  321. package/kits/hub-game/scripts/test-arrival-pose.mjs +24 -0
  322. package/kits/hub-game/scripts/test-ask-client.mjs +358 -0
  323. package/kits/hub-game/scripts/test-ask-slot.mjs +85 -0
  324. package/kits/hub-game/scripts/test-ask.mjs +269 -0
  325. package/kits/hub-game/scripts/test-attention.mjs +10 -1
  326. package/kits/hub-game/scripts/test-avatar-cap.mjs +379 -0
  327. package/kits/hub-game/scripts/test-avatar-colors.mjs +72 -0
  328. package/kits/hub-game/scripts/test-avatar-models.mjs +181 -0
  329. package/kits/hub-game/scripts/test-avatar-share.mjs +318 -0
  330. package/kits/hub-game/scripts/test-avatar-wire.mjs +792 -0
  331. package/kits/hub-game/scripts/test-avatar.mjs +584 -7
  332. package/kits/hub-game/scripts/test-back-visibility.mjs +82 -0
  333. package/kits/hub-game/scripts/test-ballot.mjs +1008 -0
  334. package/kits/hub-game/scripts/test-ban-join.mjs +121 -13
  335. package/kits/hub-game/scripts/test-build.mjs +49 -0
  336. package/kits/hub-game/scripts/test-cells.mjs +71 -0
  337. package/kits/hub-game/scripts/test-chat.mjs +863 -0
  338. package/kits/hub-game/scripts/test-classic.mjs +2 -0
  339. package/kits/hub-game/scripts/test-companion-chat.mjs +216 -0
  340. package/kits/hub-game/scripts/test-companion-client.mjs +1167 -0
  341. package/kits/hub-game/scripts/test-companion.mjs +259 -0
  342. package/kits/hub-game/scripts/test-control-layout-dom.mjs +120 -0
  343. package/kits/hub-game/scripts/test-crowd-names.mjs +205 -0
  344. package/kits/hub-game/scripts/test-decor-client.mjs +344 -0
  345. package/kits/hub-game/scripts/test-decor.mjs +464 -0
  346. package/kits/hub-game/scripts/test-default-environment-root.mjs +95 -0
  347. package/kits/hub-game/scripts/test-default-environment.mjs +267 -0
  348. package/kits/hub-game/scripts/test-door-analytics.mjs +58 -0
  349. package/kits/hub-game/scripts/test-door-jump.mjs +100 -0
  350. package/kits/hub-game/scripts/test-earned-client.mjs +459 -0
  351. package/kits/hub-game/scripts/test-earned.mjs +1224 -0
  352. package/kits/hub-game/scripts/test-emote-bubble.mjs +110 -0
  353. package/kits/hub-game/scripts/test-far-avatars.mjs +340 -0
  354. package/kits/hub-game/scripts/test-fps-telemetry.mjs +112 -0
  355. package/kits/hub-game/scripts/test-frame-batch.mjs +252 -0
  356. package/kits/hub-game/scripts/test-fresh-friends.mjs +118 -0
  357. package/kits/hub-game/scripts/test-friend-bests.mjs +435 -0
  358. package/kits/hub-game/scripts/test-grab-orbit.mjs +961 -0
  359. package/kits/hub-game/scripts/test-grab.mjs +7 -0
  360. package/kits/hub-game/scripts/test-hats.mjs +422 -168
  361. package/kits/hub-game/scripts/test-high-only.mjs +170 -0
  362. package/kits/hub-game/scripts/test-hub-leaving.mjs +203 -0
  363. package/kits/hub-game/scripts/test-hub-ops.mjs +758 -2
  364. package/kits/hub-game/scripts/test-hub-trip.mjs +1594 -12
  365. package/kits/hub-game/scripts/test-hud-clear.mjs +484 -57
  366. package/kits/hub-game/scripts/test-hud-defects-dom.mjs +100 -0
  367. package/kits/hub-game/scripts/test-hud-rate.mjs +224 -0
  368. package/kits/hub-game/scripts/test-hud-safe-visibility-dom.mjs +83 -0
  369. package/kits/hub-game/scripts/test-idle.mjs +427 -1
  370. package/kits/hub-game/scripts/test-interest-cap.mjs +36 -0
  371. package/kits/hub-game/scripts/test-interest-cells.mjs +513 -0
  372. package/kits/hub-game/scripts/test-interest-client.mjs +118 -0
  373. package/kits/hub-game/scripts/test-interest.mjs +15 -0
  374. package/kits/hub-game/scripts/test-invites-client.mjs +430 -0
  375. package/kits/hub-game/scripts/test-invites.mjs +109 -0
  376. package/kits/hub-game/scripts/test-keys.mjs +46 -1
  377. package/kits/hub-game/scripts/test-labels.mjs +664 -0
  378. package/kits/hub-game/scripts/test-landscape-layout.mjs +194 -0
  379. package/kits/hub-game/scripts/test-list-scroll-dom.mjs +49 -0
  380. package/kits/hub-game/scripts/test-load-abandon.mjs +246 -0
  381. package/kits/hub-game/scripts/test-loading-cover.mjs +162 -0
  382. package/kits/hub-game/scripts/test-manifest.mjs +472 -0
  383. package/kits/hub-game/scripts/test-menu-client.mjs +585 -0
  384. package/kits/hub-game/scripts/test-menu.mjs +319 -0
  385. package/kits/hub-game/scripts/test-npcs.mjs +2528 -13
  386. package/kits/hub-game/scripts/test-object-entry.mjs +76 -0
  387. package/kits/hub-game/scripts/test-observed.mjs +745 -0
  388. package/kits/hub-game/scripts/test-pack.mjs +7 -0
  389. package/kits/hub-game/scripts/test-pad-cues.mjs +304 -0
  390. package/kits/hub-game/scripts/test-pad-occupancy.mjs +177 -0
  391. package/kits/hub-game/scripts/test-picker.mjs +541 -0
  392. package/kits/hub-game/scripts/test-placement-cache.mjs +690 -0
  393. package/kits/hub-game/scripts/test-progress-reset.mjs +559 -0
  394. package/kits/hub-game/scripts/test-push-visit.mjs +26 -0
  395. package/kits/hub-game/scripts/test-quality.mjs +385 -0
  396. package/kits/hub-game/scripts/test-rehello.mjs +1733 -0
  397. package/kits/hub-game/scripts/test-relations-among.mjs +222 -0
  398. package/kits/hub-game/scripts/test-relations-refresh.mjs +188 -0
  399. package/kits/hub-game/scripts/test-resume-action-order.mjs +598 -0
  400. package/kits/hub-game/scripts/test-resume-held.mjs +239 -0
  401. package/kits/hub-game/scripts/test-resume-pose.mjs +142 -0
  402. package/kits/hub-game/scripts/test-safe-events-dom.mjs +116 -0
  403. package/kits/hub-game/scripts/test-safe-layout.mjs +330 -0
  404. package/kits/hub-game/scripts/test-say.mjs +1 -1
  405. package/kits/hub-game/scripts/test-shot.mjs +901 -0
  406. package/kits/hub-game/scripts/test-signin-client.mjs +45 -0
  407. package/kits/hub-game/scripts/test-soundscape.mjs +5437 -0
  408. package/kits/hub-game/scripts/test-spin.mjs +314 -0
  409. package/kits/hub-game/scripts/test-standing.mjs +449 -0
  410. package/kits/hub-game/scripts/test-storage-limit.mjs +333 -0
  411. package/kits/hub-game/scripts/test-stuck.mjs +1904 -0
  412. package/kits/hub-game/scripts/test-talk-overlay-dom.mjs +130 -0
  413. package/kits/hub-game/scripts/test-tier-cells.mjs +706 -0
  414. package/kits/hub-game/scripts/test-tiers-render.mjs +412 -0
  415. package/kits/hub-game/scripts/test-tiers.mjs +476 -2
  416. package/kits/hub-game/scripts/test-toast-band.mjs +61 -0
  417. package/kits/hub-game/scripts/test-try-on.mjs +22 -22
  418. package/kits/hub-game/scripts/test-vis.mjs +770 -0
  419. package/kits/hub-game/scripts/test-visibility.mjs +134 -0
  420. package/kits/hub-game/scripts/test-weakest-tier.mjs +924 -0
  421. package/kits/hub-game/scripts/test-world-labels.mjs +367 -0
  422. package/kits/hub-game/scripts/test-yours-chrome.mjs +210 -0
  423. package/kits/hub-game/scripts/test-yours.mjs +403 -0
  424. package/kits/multiplayer-3d/CLAUDE.md +50 -0
  425. package/kits/multiplayer-3d/castle.json +5 -5
  426. package/kits/multiplayer-3d/code/client/avatars.js +7 -0
  427. package/kits/multiplayer-3d/code/client/gait.js +65 -0
  428. package/kits/multiplayer-3d/code/client/joinFailure.js +27 -0
  429. package/kits/multiplayer-3d/code/client/nameTags.js +59 -4
  430. package/kits/multiplayer-3d/code/client/resumeGate.js +139 -0
  431. package/kits/multiplayer-3d/code/options.js +5 -0
  432. package/kits/multiplayer-3d/code/server/ownership.js +10 -2
  433. package/kits/multiplayer-3d/code/server/sceneBodies.js +12 -0
  434. package/kits/multiplayer-3d/code/server/world.js +7 -0
  435. package/kits/multiplayer-3d/code/systems/multiplayer.js +443 -34
  436. package/kits/multiplayer-3d/package-lock.json +8 -1
  437. package/kits/multiplayer-3d/package.json +3 -1
  438. package/kits/multiplayer-3d/scripts/fixtures/README.md +11 -0
  439. package/kits/multiplayer-3d/scripts/fixtures/ownership-legacy.json +2 -0
  440. package/kits/multiplayer-3d/scripts/ownership-harness.mjs +102 -0
  441. package/kits/multiplayer-3d/scripts/ownership-loader.mjs +46 -0
  442. package/kits/multiplayer-3d/scripts/ownership-worker.mjs +15 -0
  443. package/kits/multiplayer-3d/scripts/record-ownership-session.mjs +98 -0
  444. package/kits/multiplayer-3d/scripts/test-eligible-claims.mjs +167 -0
  445. package/kits/multiplayer-3d/scripts/test-join-watchdog.mjs +436 -0
  446. package/kits/multiplayer-3d/scripts/test-own-name-tag.mjs +247 -0
  447. package/kits/multiplayer-3d/scripts/test-resume-gate.mjs +624 -0
  448. package/kits/physics-2d/CLAUDE.md +19 -1
  449. package/kits/physics-2d/castle.json +2 -2
  450. package/kits/physics-2d/engine/frozenActors.js +233 -0
  451. package/kits/physics-2d/engine/scene.js +337 -3
  452. package/kits/physics-2d/engine/skyKey.js +129 -0
  453. package/kits/physics-2d/engine/stillClock.js +106 -0
  454. package/kits/physics-2d/engine/updateBudget.js +21 -0
  455. package/kits/physics-2d/eslint.config.js +1 -1
  456. package/kits/physics-2d/play/behaviors/AnalogStick.js +198 -0
  457. package/kits/physics-2d/play/behaviors/Camera.js +40 -0
  458. package/kits/physics-2d/play/behaviors/Collider.js +122 -0
  459. package/kits/physics-2d/play/behaviors/Draggable.js +115 -0
  460. package/kits/physics-2d/play/behaviors/Goal.js +46 -0
  461. package/kits/physics-2d/play/behaviors/Joints.js +126 -0
  462. package/kits/physics-2d/play/behaviors/Layout.js +71 -0
  463. package/kits/physics-2d/play/behaviors/RigidBody.js +57 -0
  464. package/kits/physics-2d/play/behaviors/Slingshot.js +142 -0
  465. package/kits/physics-2d/play/behaviors/SoundPlayer.js +263 -0
  466. package/kits/physics-2d/play/behaviors/Sprite.js +406 -0
  467. package/kits/physics-2d/play/behaviors/Style.js +209 -0
  468. package/kits/physics-2d/play/behaviors/Text.js +85 -0
  469. package/kits/physics-2d/play/behaviors/Video.js +93 -0
  470. package/kits/physics-2d/scripts/test-skip-unchanged.mjs +326 -1
  471. package/kits/physics-3d/CLAUDE.md +42 -529
  472. package/kits/physics-3d/behaviors/Body.jsx +3 -0
  473. package/kits/physics-3d/behaviors/Model.jsx +3 -0
  474. package/kits/physics-3d/behaviors/Player.jsx +661 -87
  475. package/kits/physics-3d/behaviors/Shape.jsx +3 -0
  476. package/kits/physics-3d/behaviors/Solid.jsx +3 -0
  477. package/kits/physics-3d/behaviors/Transform.jsx +3 -0
  478. package/kits/physics-3d/castle.json +3 -3
  479. package/kits/physics-3d/docs/engine-camera.md +542 -0
  480. package/kits/physics-3d/docs/engine-frame-cap.md +136 -0
  481. package/kits/physics-3d/docs/engine-load.md +149 -0
  482. package/kits/physics-3d/docs/engine-look.md +114 -0
  483. package/kits/physics-3d/docs/engine-shadows.md +372 -0
  484. package/kits/physics-3d/docs/engine-skip-work.md +187 -0
  485. package/kits/physics-3d/docs/engine-sky.md +198 -0
  486. package/kits/physics-3d/docs/engine-static-actors.md +226 -0
  487. package/kits/physics-3d/docs/engine-view.md +37 -0
  488. package/kits/physics-3d/docs/pxmodel-format.md +9 -1
  489. package/kits/physics-3d/engine3d/PlayOnly3D.jsx +5 -1
  490. package/kits/physics-3d/engine3d/Scene3DPlayer.jsx +19 -277
  491. package/kits/physics-3d/engine3d/actornode.js +87 -0
  492. package/kits/physics-3d/engine3d/animationBudget.js +23 -0
  493. package/kits/physics-3d/engine3d/branches.js +3 -13
  494. package/kits/physics-3d/engine3d/cage.js +2 -7
  495. package/kits/physics-3d/engine3d/cageops.js +2 -17
  496. package/kits/physics-3d/engine3d/dataBehaviors.js +12 -0
  497. package/kits/physics-3d/engine3d/editorWorld.js +6 -0
  498. package/kits/physics-3d/engine3d/emptynodes.js +232 -0
  499. package/kits/physics-3d/engine3d/framecap.js +99 -0
  500. package/kits/physics-3d/engine3d/frozenphysics.js +140 -0
  501. package/kits/physics-3d/engine3d/frozenstatics.js +273 -0
  502. package/kits/physics-3d/engine3d/gait.js +126 -0
  503. package/kits/physics-3d/engine3d/initialModelFiles.js +18 -0
  504. package/kits/physics-3d/engine3d/kithooks.js +47 -0
  505. package/kits/physics-3d/engine3d/look.js +514 -48
  506. package/kits/physics-3d/engine3d/lookbake.js +208 -0
  507. package/kits/physics-3d/engine3d/materialpresets.js +2 -0
  508. package/kits/physics-3d/engine3d/modelFiles.js +3 -17
  509. package/kits/physics-3d/engine3d/modelMath.js +49 -0
  510. package/kits/physics-3d/engine3d/modelready.js +16 -0
  511. package/kits/physics-3d/engine3d/motion.js +39 -10
  512. package/kits/physics-3d/engine3d/nearshadows.js +106 -21
  513. package/kits/physics-3d/engine3d/optimize.js +9 -5
  514. package/kits/physics-3d/engine3d/orbitinput.js +522 -10
  515. package/kits/physics-3d/engine3d/orbitlens.js +48 -0
  516. package/kits/physics-3d/engine3d/ownmodel.js +213 -0
  517. package/kits/physics-3d/engine3d/partgeometry.js +1 -16
  518. package/kits/physics-3d/engine3d/paths.js +1 -9
  519. package/kits/physics-3d/engine3d/playTimings.js +50 -0
  520. package/kits/physics-3d/engine3d/playerRun.js +372 -0
  521. package/kits/physics-3d/engine3d/pxmodel.js +42 -11
  522. package/kits/physics-3d/engine3d/rapier.js +27 -0
  523. package/kits/physics-3d/engine3d/scatter.js +1 -11
  524. package/kits/physics-3d/engine3d/shadowfade.js +890 -0
  525. package/kits/physics-3d/engine3d/sky.js +547 -0
  526. package/kits/physics-3d/engine3d/skylife.js +306 -0
  527. package/kits/physics-3d/engine3d/squarefirst.js +177 -0
  528. package/kits/physics-3d/engine3d/stillshadows.js +399 -0
  529. package/kits/physics-3d/engine3d/sweep.js +1 -25
  530. package/kits/physics-3d/engine3d/unchanged.js +11 -0
  531. package/kits/physics-3d/engine3d/viewrange.js +52 -0
  532. package/kits/physics-3d/engine3d/world3d.js +1253 -76
  533. package/kits/physics-3d/eslint.config.js +2 -1
  534. package/kits/physics-3d/main.jsx +10 -2
  535. package/kits/physics-3d/package-lock.json +7 -0
  536. package/kits/physics-3d/package.json +5 -1
  537. package/kits/physics-3d/play/behaviors/Body.js +31 -0
  538. package/kits/physics-3d/play/behaviors/Door.js +37 -0
  539. package/kits/physics-3d/play/behaviors/Lookable.js +16 -0
  540. package/kits/physics-3d/play/behaviors/Model.js +23 -0
  541. package/kits/physics-3d/play/behaviors/Pickup.js +46 -0
  542. package/kits/physics-3d/play/behaviors/Player.js +1204 -0
  543. package/kits/physics-3d/play/behaviors/Shape.js +47 -0
  544. package/kits/physics-3d/play/behaviors/Solid.js +16 -0
  545. package/kits/physics-3d/play/behaviors/Transform.js +29 -0
  546. package/kits/physics-3d/pnpm-lock.yaml +8 -0
  547. package/kits/physics-3d/scripts/bench-shadow-fade.mjs +37 -0
  548. package/kits/physics-3d/scripts/build-rapier-gz.mjs +56 -0
  549. package/kits/physics-3d/scripts/frozen-statics-fixture.mjs +141 -0
  550. package/kits/physics-3d/scripts/look-baseline.mjs +155 -0
  551. package/kits/physics-3d/scripts/test-camera-follow.mjs +5 -1
  552. package/kits/physics-3d/scripts/test-camera-orbit.mjs +2613 -82
  553. package/kits/physics-3d/scripts/test-drop-empty-parts.mjs +2 -2
  554. package/kits/physics-3d/scripts/test-empty-gait-hints.mjs +89 -0
  555. package/kits/physics-3d/scripts/test-frame-cap-bob.mjs +438 -0
  556. package/kits/physics-3d/scripts/test-frame-cap.mjs +452 -0
  557. package/kits/physics-3d/scripts/test-frozen-nested.mjs +49 -0
  558. package/kits/physics-3d/scripts/test-frozen-statics-legacy-physics2d.mjs +123 -0
  559. package/kits/physics-3d/scripts/test-frozen-statics.mjs +434 -0
  560. package/kits/physics-3d/scripts/test-gait.mjs +387 -0
  561. package/kits/physics-3d/scripts/test-look-bake.mjs +1056 -0
  562. package/kits/physics-3d/scripts/test-model-parse-cache.mjs +92 -0
  563. package/kits/physics-3d/scripts/test-near-shadows.mjs +5 -2
  564. package/kits/physics-3d/scripts/test-orbit-shadow-fade.mjs +2001 -0
  565. package/kits/physics-3d/scripts/test-orbit-shift-lock.mjs +582 -0
  566. package/kits/physics-3d/scripts/test-orbit-shot.mjs +657 -0
  567. package/kits/physics-3d/scripts/test-orbit-view.mjs +230 -0
  568. package/kits/physics-3d/scripts/test-rapier-gz.mjs +106 -0
  569. package/kits/physics-3d/scripts/test-skip-empty-nodes.mjs +845 -0
  570. package/kits/physics-3d/scripts/test-sky.mjs +2470 -0
  571. package/kits/physics-3d/scripts/test-square-first.mjs +921 -0
  572. package/kits/physics-3d/scripts/test-static-actors.mjs +10 -1
  573. package/kits/physics-3d/scripts/test-static-physics.mjs +4 -1
  574. package/kits/physics-3d/scripts/test-static-scenery.mjs +2174 -0
  575. package/kits/physics-3d/scripts/test-steady-hover.mjs +7 -2
  576. package/kits/physics-3d/scripts/test-still-shadows.mjs +477 -0
  577. package/kits/physics-3d/scripts/test-view-range.mjs +260 -0
  578. package/kits/physics-3d/systems/physics3d.js +419 -9
  579. package/kits/real-time/castle.json +2 -2
  580. package/kits/real-time/code/client/connection.js +33 -10
  581. package/kits/real-time/code/client/gameHooks.js +2 -0
  582. package/kits/real-time/code/client/joinOverlay.js +9 -4
  583. package/kits/real-time/code/server/gameHooks.js +7 -0
  584. package/kits/real-time/code/server/session.js +102 -22
  585. package/kits/real-time/package-lock.json +1 -1
  586. package/package.json +2 -2
  587. package/dist/shell/assets/index-Cf61cNfT.css +0 -1
@@ -0,0 +1,472 @@
1
+ // The choice card (contract v1.68, `hub.ballot`), the client's half: a
2
+ // bottom sheet of players' faces, the deck's fixed lines and its options,
3
+ // drawn by the kit because a Tier 0 game has no client code. Every word on it
4
+ // is worded here from ids: a username or "You", a line's text from the
5
+ // place's manifest (`hubPlace.ballot.lines`), an option's text from the card.
6
+ // A tap sends the card's version and ids only (`{ k: 'hub-ballot', v, face?,
7
+ // line?, option? }`); nothing a player types is ever carried.
8
+ //
9
+ // Rule B (contract §6, "The choice card"): a place without `ballot` runs none
10
+ // of this. Everything on the client enters through one gate, `gate`, called
11
+ // by the hook layer for a `hub-ballot-card` message and nowhere else:
12
+ // - the place is not known yet (the server's first tick sends a card ahead
13
+ // of the WORLD snapshot): one card is held, pending, with its connection;
14
+ // the WORLD snapshot then keeps it (`settle`) or drops it by the manifest;
15
+ // - the place is known and declares no `ballot`: the message is dropped
16
+ // before anything is made;
17
+ // - otherwise the card is held with its connection.
18
+ // While a card is held, every WORLD snapshot rechecks it (`settle`): one that
19
+ // names a place without `ballot` lets it go, pending or not. `held` is null
20
+ // until the gate holds a card, and everything else here (the hub system's
21
+ // sheet, `cardFor`) runs only while it is not. A card of another connection
22
+ // is dropped the first time it is asked for, and the hub system reads the
23
+ // gate again after that before it makes or draws anything.
24
+ //
25
+ // Ids index only own properties: `own(obj, id)`, never `obj[id]` alone.
26
+
27
+ // `{ net, card, pending }` once the gate has held a card, else null.
28
+ export let held = null;
29
+
30
+ export function gate(place, net, card) {
31
+ if (place && !place.ballot) {
32
+ return;
33
+ }
34
+ held = { net, card: card && typeof card === 'object' && Array.isArray(card.faces) ? card : null, pending: !place };
35
+ }
36
+
37
+ // A WORLD snapshot named the place a held card came to: a place without
38
+ // `ballot` lets go of it, pending or not (a recovery that keeps the
39
+ // connection but lands somewhere keyless); one with it keeps it.
40
+ export function settle(place) {
41
+ if (place?.ballot) {
42
+ held.pending = false;
43
+ } else {
44
+ held = null;
45
+ }
46
+ }
47
+
48
+ // This connection's card, or null. A card of another connection is let go.
49
+ // A held card goes when its session does (the same net under another player
50
+ // id is another session).
51
+ export function forget() {
52
+ held = null;
53
+ }
54
+
55
+ export function cardFor(net) {
56
+ if (held && held.net !== net) {
57
+ held = null;
58
+ }
59
+ return held && !held.pending ? held.card : null;
60
+ }
61
+
62
+ // What a tap sends: the card's version (rule A), an opaque string echoed as
63
+ // it came, and the ids.
64
+ export function tapMessage(card, ids) {
65
+ return { v: card.v, ...ids };
66
+ }
67
+
68
+ const own = (obj, id) => (obj && typeof obj === 'object' && Object.hasOwn(obj, id) ? obj[id] : undefined);
69
+
70
+ import { AVATAR_FACES } from './avatarFaces.js';
71
+ import { landscapeViewport } from './landscapeLayout.js';
72
+
73
+ const Z = 2147480001;
74
+ const GOLD = '#ffd84a';
75
+ const CHIP_BG = 'rgba(0,0,0,0.6)';
76
+ // A vote sent and not yet locked in by the server may be sent again after this.
77
+ const PENDING_MS = 2500;
78
+ const FEED_SHOWN = 3;
79
+
80
+ // The words of a manifest line, or null.
81
+ export function lineOf(lines, id) {
82
+ return lines.find((line) => line.id === id) ?? null;
83
+ }
84
+
85
+ // A line's words as this viewer reads them: the server's `words` (the line
86
+ // with the name of anyone a block hides from them taken out) over the
87
+ // manifest's.
88
+ export function textOf(card, line) {
89
+ const words = own(card?.words, line.id);
90
+ return typeof words === 'string' ? words : line.text;
91
+ }
92
+
93
+ // A player on the card, as this viewer reads them.
94
+ export function nameOf(card, playerId, selfId) {
95
+ if (playerId === selfId) {
96
+ return 'You';
97
+ }
98
+ const name = own(own(card?.who, playerId), 'name');
99
+ return typeof name === 'string' ? name : 'someone';
100
+ }
101
+
102
+ // The card's recent lines, worded from ids, oldest first:
103
+ // "bo → amy: I saw them by the boat", "bo: Not me!".
104
+ export function feedWords(card, lines, selfId) {
105
+ const out = [];
106
+ for (const row of card?.feed ?? []) {
107
+ const line = lineOf(lines, row.line);
108
+ if (!line) {
109
+ continue;
110
+ }
111
+ const from = nameOf(card, row.from, selfId);
112
+ const text = textOf(card, line);
113
+ out.push(row.to ? `${from} → ${nameOf(card, row.to, selfId)}: ${text}` : `${from}: ${text}`);
114
+ }
115
+ return out;
116
+ }
117
+
118
+ // What a tap does, as data: `{ sel, send }`, `send` the message's ids (or
119
+ // null). `sel` is `{ face, option, pending }`: what this viewer has picked on
120
+ // the card and not yet sent, and when a vote went out.
121
+ export function tap(card, lines, sel, what, now = 0) {
122
+ const none = { sel, send: null };
123
+ if (!card || card.mode === 'reveal') {
124
+ return none;
125
+ }
126
+ const live = (id) => card.faces.some((face) => face.id === id && !face.off);
127
+ if (card.mode === 'vote') {
128
+ if (card.picked || (sel.pending !== null && now - sel.pending < PENDING_MS)) {
129
+ return none;
130
+ }
131
+ if (what.face !== undefined) {
132
+ return live(what.face) ? { sel: { ...sel, face: sel.face === what.face ? null : what.face, option: null }, send: null } : none;
133
+ }
134
+ if (what.option !== undefined) {
135
+ return { sel: { ...sel, face: null, option: sel.option === what.option ? null : what.option }, send: null };
136
+ }
137
+ if (what.vote) {
138
+ if (sel.face) {
139
+ return { sel: { ...sel, pending: now }, send: { face: sel.face } };
140
+ }
141
+ if (sel.option) {
142
+ return { sel: { ...sel, pending: now }, send: { option: sel.option } };
143
+ }
144
+ }
145
+ return none;
146
+ }
147
+ // Talk: a face, then a line about it; a line about oneself at once; an option at once.
148
+ if (what.face !== undefined) {
149
+ return live(what.face) ? { sel: { ...sel, face: sel.face === what.face ? null : what.face }, send: null } : none;
150
+ }
151
+ if (what.option !== undefined) {
152
+ return card.options.some((o) => o.id === what.option) ? { sel: { ...sel, face: null }, send: { option: what.option } } : none;
153
+ }
154
+ if (what.line !== undefined && card.lines.includes(what.line)) {
155
+ const line = lineOf(lines, what.line);
156
+ if (line?.about === 'self') {
157
+ return { sel, send: { line: line.id } };
158
+ }
159
+ if (line?.about === 'face' && sel.face && live(sel.face)) {
160
+ return { sel: { ...sel, face: null }, send: { face: sel.face, line: line.id } };
161
+ }
162
+ }
163
+ return none;
164
+ }
165
+
166
+ // The selection kept only while the card still allows it.
167
+ // A new version (what can be tapped changed: rule A) starts the selection
168
+ // afresh, so a tap the server refused for an old version leaves nothing
169
+ // selected or pending; a refresh of the words alone keeps it.
170
+ export function keepSel(card, sel) {
171
+ if (!card) {
172
+ return { face: null, option: null, pending: null, mode: null, v: null };
173
+ }
174
+ if (sel.mode !== card.mode || sel.v !== card.v) {
175
+ return { face: null, option: null, pending: null, mode: card.mode, v: card.v };
176
+ }
177
+ const face = sel.face && card.faces.some((f) => f.id === sel.face && !f.off) ? sel.face : null;
178
+ const option = sel.option && card.options.some((o) => o.id === sel.option) ? sel.option : null;
179
+ return { face, option, pending: card.picked ? null : sel.pending, mode: card.mode, v: card.v };
180
+ }
181
+
182
+ // The line under the title that says what to do now.
183
+ export function hintOf(card, lines, sel, selfId) {
184
+ if (card.mode === 'reveal') {
185
+ return null;
186
+ }
187
+ if (card.mode === 'vote') {
188
+ if (card.picked) {
189
+ return null;
190
+ }
191
+ return sel.face || sel.option ? null : 'Tap a face to vote';
192
+ }
193
+ const offered = card.lines.map((id) => lineOf(lines, id)).filter(Boolean);
194
+ if (sel.face) {
195
+ return `About ${nameOf(card, sel.face, selfId)}:`;
196
+ }
197
+ return offered.some((line) => line.about === 'face') ? 'Tap a face, then what to say' : null;
198
+ }
199
+
200
+ export function voteLabel(card, sel, selfId, now) {
201
+ if (card.picked) {
202
+ // `{}`: locked in on a face this viewer is not shown.
203
+ const what = card.picked.face ? nameOf(card, card.picked.face, selfId) : card.picked.option ? card.options.find((o) => o.id === card.picked.option)?.text ?? '' : '';
204
+ return { text: what ? `Locked in: ${what} ✓` : 'Locked in ✓', enabled: false };
205
+ }
206
+ if (sel.pending !== null && now - sel.pending < PENDING_MS) {
207
+ return { text: 'Sending…', enabled: false };
208
+ }
209
+ if (sel.face) {
210
+ return { text: `Vote for ${nameOf(card, sel.face, selfId)}`, enabled: true };
211
+ }
212
+ if (sel.option) {
213
+ return { text: `Vote: ${card.options.find((o) => o.id === sel.option)?.text ?? ''}`, enabled: true };
214
+ }
215
+ return { text: 'Vote', enabled: false };
216
+ }
217
+
218
+ export function clock(seconds) {
219
+ const s = Math.max(0, Math.ceil(seconds));
220
+ return `${Math.floor(s / 60)}:${String(s % 60).padStart(2, '0')}`;
221
+ }
222
+
223
+ function el(tag, style, parent) {
224
+ const node = document.createElement(tag);
225
+ Object.assign(node.style, style);
226
+ parent?.appendChild(node);
227
+ return node;
228
+ }
229
+
230
+ // `send(ids)` sends a tap; `onChip()` (optional) is the soundscape's chip tap.
231
+ export function makeBallot({ safeInsets = false, send, onChip }) {
232
+ let root = null;
233
+ let sheet = null;
234
+ let countdown = null;
235
+ let key = '';
236
+ let sel = { face: null, option: null, pending: null, mode: null, v: null };
237
+ let current = null;
238
+ let lines = [];
239
+ let selfId = null;
240
+ // The face or option the card was last drawn with picked.
241
+ let shownPick = null;
242
+
243
+ function build() {
244
+ root = el('div', { position: 'fixed', left: '0', right: '0', bottom: '0', display: 'flex', justifyContent: 'center', pointerEvents: 'none', zIndex: String(Z) }, document.body);
245
+ root.dataset.hub = 'ballot';
246
+ sheet = el('div', { pointerEvents: 'auto', width: 'min(100%, 560px)', boxSizing: 'border-box', overflowY: 'auto', overscrollBehavior: 'contain', touchAction: 'pan-y', background: 'rgba(16,12,22,0.96)', borderRadius: '18px 18px 0 0', padding: '12px 12px max(12px, env(safe-area-inset-bottom))', boxShadow: '0 -4px 18px rgba(0,0,0,0.45)', font: '600 15px/1.3 system-ui, sans-serif', color: '#fff', display: 'flex', flexDirection: 'column', gap: '10px', userSelect: 'none', webkitUserSelect: 'none' }, root);
247
+ for (const type of ['pointerdown', 'touchstart', 'mousedown', 'wheel']) {
248
+ sheet.addEventListener(type, (event) => event.stopPropagation(), { passive: true });
249
+ }
250
+ }
251
+
252
+ function press(what) {
253
+ const result = tap(current, lines, sel, what, performance.now());
254
+ sel = result.sel;
255
+ if (result.send) {
256
+ onChip?.();
257
+ send(tapMessage(current, result.send));
258
+ }
259
+ key = '';
260
+ }
261
+
262
+ function button(parent, style, onTap) {
263
+ const node = el('button', { boxSizing: 'border-box', cursor: 'pointer', touchAction: 'manipulation', font: 'inherit', color: '#fff', ...style }, parent);
264
+ node.type = 'button';
265
+ node.addEventListener('click', (event) => {
266
+ event.stopPropagation();
267
+ event.preventDefault();
268
+ onTap();
269
+ });
270
+ return node;
271
+ }
272
+
273
+ function chip(parent, text, enabled, onTap, dashed = false) {
274
+ const node = button(parent, { minHeight: '44px', padding: '9px 14px', borderRadius: '22px', border: `1px ${dashed ? 'dashed' : 'solid'} rgba(255,255,255,0.4)`, background: CHIP_BG, font: '600 15px/1.2 system-ui, sans-serif', textAlign: 'left', opacity: enabled ? '1' : '0.4' }, () => {
275
+ if (enabled) {
276
+ onTap();
277
+ }
278
+ });
279
+ node.textContent = text;
280
+ node.setAttribute('aria-disabled', enabled ? 'false' : 'true');
281
+ return node;
282
+ }
283
+
284
+ function faceCell(parent, card, face, landscape) {
285
+ const chosen = sel.face === face.id || card.picked?.face === face.id;
286
+ const tappable = card.mode !== 'reveal' && !face.off && !card.picked;
287
+ const node = button(parent, { position: 'relative', minHeight: landscape ? '66px' : '76px', padding: '6px 4px', borderRadius: '14px', border: `2px solid ${chosen ? GOLD : face.mark ?? 'rgba(255,255,255,0.18)'}`, boxShadow: chosen ? `0 0 0 3px rgba(255,216,74,0.5)` : 'none', background: CHIP_BG, display: 'flex', flexDirection: 'column', alignItems: 'center', justifyContent: 'center', gap: '2px', minWidth: '0', opacity: face.off ? '0.4' : '1', filter: face.off ? 'grayscale(1)' : 'none', cursor: tappable ? 'pointer' : 'default' }, () => {
288
+ if (tappable) {
289
+ press({ face: face.id });
290
+ }
291
+ });
292
+ const who = own(card.who, face.id);
293
+ const drawing = Number.isInteger(who?.avatar) ? AVATAR_FACES[who.avatar]?.[1] : null;
294
+ const size = landscape ? 28 : 36;
295
+ if (drawing) {
296
+ el('div', { width: `${size}px`, height: `${size}px`, flex: 'none', pointerEvents: 'none' }, node).innerHTML = `<svg viewBox="0 0 24 24" width="${size}" height="${size}" stroke="#241a2e" stroke-width="1.3" stroke-linejoin="round" stroke-linecap="round" aria-hidden="true">${drawing}</svg>`;
297
+ } else {
298
+ const blank = el('div', { width: `${size}px`, height: `${size}px`, borderRadius: '50%', background: '#4a4458', display: 'flex', alignItems: 'center', justifyContent: 'center', fontSize: '18px', pointerEvents: 'none' }, node);
299
+ blank.textContent = nameOf(card, face.id, null).slice(0, 1).toUpperCase();
300
+ }
301
+ const name = el('div', { maxWidth: '100%', overflow: 'hidden', textOverflow: 'ellipsis', whiteSpace: 'nowrap', fontSize: '15px', pointerEvents: 'none' }, node);
302
+ name.textContent = nameOf(card, face.id, selfId);
303
+ if (face.note) {
304
+ const note = el('div', { maxWidth: '100%', overflow: 'hidden', textOverflow: 'ellipsis', whiteSpace: 'nowrap', font: '500 15px/1.2 system-ui, sans-serif', opacity: '0.8', pointerEvents: 'none' }, node);
305
+ note.textContent = face.note;
306
+ }
307
+ if (face.mark) {
308
+ el('div', { position: 'absolute', left: '6px', top: '6px', width: '10px', height: '10px', borderRadius: '5px', background: face.mark, pointerEvents: 'none' }, node);
309
+ }
310
+ if (Number.isInteger(face.votes)) {
311
+ 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
+ votes.textContent = String(face.votes);
313
+ }
314
+ if (card.picked?.face === face.id) {
315
+ 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
+ tick.textContent = '✓';
317
+ }
318
+ node.setAttribute('aria-label', `${nameOf(card, face.id, selfId)}${face.note ? `, ${face.note}` : ''}${Number.isInteger(face.votes) ? `, ${face.votes} votes` : ''}`);
319
+ node.setAttribute('aria-pressed', chosen ? 'true' : 'false');
320
+ }
321
+
322
+ // Portrait: one column that scrolls. A phone on its side: the card's words
323
+ // and faces on the left, what to say or vote on the right, each column
324
+ // scrolling on its own, so the chips stay in view whatever the faces do.
325
+ // `focus` (a face was just picked) brings the chips or Vote into view.
326
+ function draw(card, landscape, now, maxH, focus) {
327
+ const scrollBox = (child) => Array.from(child.children ?? []).find((node) => node.dataset.ballotScroll === 'true') ?? child;
328
+ const scrolls = [...sheet.children].map((child) => scrollBox(child).scrollTop);
329
+ const scroll = sheet.scrollTop;
330
+ sheet.replaceChildren();
331
+ Object.assign(sheet.style, landscape ? { height: `${Math.round(maxH)}px`, flexDirection: 'row', overflowY: 'hidden', gap: '12px' } : { height: '', flexDirection: 'column', overflowY: 'auto', gap: '10px' });
332
+ const column = (flex, scrollable = true) => el('div', { flex, minWidth: '0', minHeight: '0', overflowY: scrollable ? 'auto' : 'hidden', overscrollBehavior: 'contain', display: 'flex', flexDirection: 'column', gap: '8px' }, sheet);
333
+ const left = landscape ? column('1 1 56%') : sheet;
334
+ const right = landscape ? column('1 1 44%', false) : sheet;
335
+ const rightBody = landscape ? el('div', { flex: '1 1 auto', minHeight: '0', overflowY: 'auto', overscrollBehavior: 'contain', display: 'flex', flexDirection: 'column', gap: '8px' }, right) : right;
336
+ if (landscape) {rightBody.dataset.ballotScroll = 'true';}
337
+ const head = el('div', { display: 'flex', alignItems: 'center', gap: '10px', flex: 'none' }, left);
338
+ const title = el('div', { flex: '1', minWidth: '0', font: '800 17px/1.25 system-ui, sans-serif' }, head);
339
+ title.textContent = card.title ?? '';
340
+ countdown = null;
341
+ if (card.until !== undefined) {
342
+ countdown = el('div', { flex: 'none', padding: '4px 10px', borderRadius: '12px', background: 'rgba(255,255,255,0.14)', font: '800 15px/1.2 system-ui, sans-serif', fontVariantNumeric: 'tabular-nums' }, head);
343
+ }
344
+ if (card.text) {
345
+ el('div', { flex: 'none', font: '500 15px/1.3 system-ui, sans-serif', opacity: '0.9' }, left).textContent = card.text;
346
+ }
347
+ // A short screen keeps fewer of the said lines.
348
+ const said = feedWords(card, lines, selfId).slice(window.innerHeight < 700 && !landscape ? -2 : -FEED_SHOWN);
349
+ if (said.length) {
350
+ const feed = el('div', { flex: 'none', display: 'flex', flexDirection: 'column', gap: '2px', padding: '2px 0 2px 10px', borderLeft: '3px solid rgba(255,255,255,0.25)', font: '500 15px/1.3 system-ui, sans-serif', opacity: '0.88' }, left);
351
+ for (const words of said) {
352
+ el('div', {}, feed).textContent = words;
353
+ }
354
+ }
355
+ const hint = hintOf(card, lines, sel, selfId);
356
+ if (hint) {
357
+ el('div', { flex: 'none', font: '600 15px/1.3 system-ui, sans-serif', color: '#e9c48f' }, landscape ? rightBody : left).textContent = hint;
358
+ }
359
+ if (card.faces.length) {
360
+ const grid = el('div', { flex: 'none', display: 'grid', gridTemplateColumns: `repeat(auto-fill, minmax(${landscape ? 70 : 72}px, 1fr))`, gap: '8px' }, left);
361
+ for (const face of card.faces) {
362
+ faceCell(grid, card, face, landscape);
363
+ }
364
+ }
365
+ const chips = el('div', { flex: 'none', display: 'flex', flexWrap: 'wrap', gap: '8px' }, rightBody);
366
+ if (card.mode === 'talk') {
367
+ for (const id of card.lines) {
368
+ const line = lineOf(lines, id);
369
+ if (line) {
370
+ chip(chips, textOf(card, line), line.about === 'self' || Boolean(sel.face), () => press({ line: id }));
371
+ }
372
+ }
373
+ }
374
+ if (card.mode !== 'reveal') {
375
+ for (const option of card.options) {
376
+ const chosen = sel.option === option.id || card.picked?.option === option.id;
377
+ const node = chip(chips, option.text, !card.picked, () => press({ option: option.id }), true);
378
+ if (chosen) {
379
+ Object.assign(node.style, { borderColor: GOLD, borderStyle: 'solid', boxShadow: '0 0 0 3px rgba(255,216,74,0.5)' });
380
+ }
381
+ }
382
+ }
383
+ if (!chips.childElementCount) {
384
+ chips.remove();
385
+ }
386
+ let vote = null;
387
+ if (card.mode === 'vote') {
388
+ const label = voteLabel(card, sel, selfId, now);
389
+ vote = button(right, { flex: 'none', minHeight: '48px', width: '100%', borderRadius: '24px', border: 'none', background: card.picked ? 'rgba(255,216,74,0.25)' : GOLD, color: card.picked ? '#fff' : '#2b2118', font: '800 17px/1.2 system-ui, sans-serif', opacity: label.enabled || card.picked ? '1' : '0.45' }, () => {
390
+ if (label.enabled) {
391
+ press({ vote: true });
392
+ }
393
+ });
394
+ vote.textContent = label.text;
395
+ vote.setAttribute('aria-disabled', label.enabled ? 'false' : 'true');
396
+ }
397
+ if (landscape && !right.childElementCount) {
398
+ right.remove();
399
+ }
400
+ if (landscape) {
401
+ [...sheet.children].forEach((child, i) => {
402
+ scrollBox(child).scrollTop = scrolls[i] ?? 0;
403
+ });
404
+ } else {
405
+ sheet.scrollTop = scroll;
406
+ }
407
+ // What to do next, brought into view once, as a face is picked.
408
+ const next = vote ?? (chips.isConnected ? chips : null);
409
+ if (focus && next) {
410
+ const box = next.parentElement;
411
+ const over = next.offsetTop + next.offsetHeight - (box.scrollTop + box.clientHeight) + 12;
412
+ if (over > 0) {
413
+ box.scrollTop += over;
414
+ }
415
+ }
416
+ }
417
+
418
+ return {
419
+ surface: () => root ? sheet : null,
420
+ // `card` is this player's card (`hub-ballot-card`) or null; `placeLines`
421
+ // the place's manifest lines; `simNow` the simulation time now;
422
+ // `hudBottom` the bottom of a clear HUD's box in CSS px, or 0 (the card
423
+ // stays under it; an ordinary HUD never reaches 40% of the view).
424
+ frame(card, placeLines, self, simNow, hudBottom = 0) {
425
+ current = card;
426
+ if (!card) {
427
+ if (root) {
428
+ root.style.display = 'none';
429
+ }
430
+ sel = keepSel(null, sel);
431
+ key = '';
432
+ return;
433
+ }
434
+ if (!root) {
435
+ build();
436
+ }
437
+ root.style.display = 'flex';
438
+ lines = Array.isArray(placeLines) ? placeLines : [];
439
+ selfId = self;
440
+ sel = keepSel(card, sel);
441
+ const now = performance.now();
442
+ const w = window.innerWidth;
443
+ const h = window.innerHeight;
444
+ const landscape = landscapeViewport(window);
445
+ const maxH = Math.max(160, Math.min(h * 0.6, h - hudBottom - 8));
446
+ sheet.style.maxHeight = `${Math.round(maxH)}px`;
447
+ sheet.style.width = landscape ? 'min(56vw, max(220px, calc(100vw - 344px)), 560px)' : 'min(100%, 560px)';
448
+ const pending = sel.pending !== null && now - sel.pending < PENDING_MS;
449
+ const next = JSON.stringify([card, sel.face, sel.option, pending, lines, selfId, landscape, Math.round(maxH)]);
450
+ if (next !== key) {
451
+ key = next;
452
+ const picked = sel.face ?? sel.option;
453
+ draw(card, landscape, now, maxH, picked !== null && picked !== shownPick);
454
+ shownPick = picked;
455
+ }
456
+ if (countdown) {
457
+ const left = (card.until - simNow) / 1000;
458
+ const text = clock(left);
459
+ if (countdown.textContent !== text) {
460
+ countdown.textContent = text;
461
+ countdown.style.background = left <= 10 ? 'rgba(230,70,70,0.85)' : 'rgba(255,255,255,0.14)';
462
+ }
463
+ }
464
+ },
465
+ // Whether the card is up (the hub hides what it would cover).
466
+ shown: () => current !== null,
467
+ dispose() {
468
+ root?.remove();
469
+ root = null;
470
+ },
471
+ };
472
+ }
@@ -0,0 +1,38 @@
1
+ // The build stamp a town's assembly writes beside its castle.json: which git
2
+ // commit the deck was built from, and when. It is for QA to read off the page
3
+ // (`globalThis.__hub.build`; the hook layer reads the file), so a phone leg can tell which save a layer runs.
4
+ // A deck with no build.json, or one that does not read as a stamp, has none.
5
+
6
+ const SHA = /^[0-9a-f]{7,40}$/;
7
+ const text = (value) => (typeof value === 'string' && value.length > 0 && value.length <= 80 ? value : null);
8
+
9
+ // `{ sha, savedAt, bundle?, dirty? }` or null. Only the named fields are kept.
10
+ export function buildStamp(json) {
11
+ if (!json || typeof json !== 'object' || Array.isArray(json)) {return null;}
12
+ if (typeof json.sha !== 'string' || !SHA.test(json.sha)) {return null;}
13
+ const savedAt = text(json.savedAt);
14
+ if (savedAt === null || Number.isNaN(Date.parse(savedAt))) {return null;}
15
+ const bundle = text(json.bundle);
16
+ return Object.freeze({
17
+ sha: json.sha,
18
+ savedAt,
19
+ ...(bundle === null ? {} : { bundle }),
20
+ ...(json.dirty === true ? { dirty: true } : {}),
21
+ });
22
+ }
23
+
24
+ // Hidden page evidence for QA, independent of the player's visible HUD.
25
+ // Missing stamps leave the DOM exactly as it was.
26
+ export function showBuildStamp(stamp, doc = globalThis.document) {
27
+ if (!stamp || !doc?.body) {return;}
28
+ let node = doc.getElementById('hub-build-stamp');
29
+ if (!node) {
30
+ node = doc.createElement('script');
31
+ node.id = 'hub-build-stamp';
32
+ node.type = 'application/json';
33
+ node.hidden = true;
34
+ doc.body.appendChild(node);
35
+ }
36
+ const json = JSON.stringify(stamp);
37
+ if (node.textContent !== json) {node.textContent = json;}
38
+ }
@@ -26,6 +26,7 @@ export function makeChat() {
26
26
  // Counts sessions: an answer that lands after a reset belongs to the last
27
27
  // session and is dropped.
28
28
  let generation = 0;
29
+ const blocked = new Set();
29
30
  const c = {
30
31
  // Whether this player may chat at all, and the user ids here they may
31
32
  // chat with; null until the host has answered.
@@ -34,7 +35,8 @@ export function makeChat() {
34
35
  // Messages not yet shown: [{ id, fromUserId, fromUsername, text, mine }].
35
36
  incoming: [],
36
37
 
37
- available: () => !off && typeof castleSdk.Hub?.chat === 'function' && typeof castleSdk.Hub?.say === 'function',
38
+ available: () =>
39
+ !off && typeof castleSdk.Hub?.chat === 'function' && typeof castleSdk.Hub?.say === 'function',
38
40
 
39
41
  // Asks the host what there is to read, on its cadence. `active` is false
40
42
  // during a trip or away from any place.
@@ -62,10 +64,14 @@ export function makeChat() {
62
64
  // player arrived is not replayed.
63
65
  const first = cursor === null && c.peers === null;
64
66
  c.canChat = answer.canChat === true;
65
- c.peers = Array.isArray(answer.peers) ? answer.peers.map(String) : [];
67
+ c.peers = Array.isArray(answer.peers)
68
+ ? answer.peers.map(String).filter((id) => !blocked.has(id))
69
+ : [];
66
70
  if (!first) {
67
71
  for (const m of answer.messages ?? []) {
68
- c.incoming.push({ ...m, mine: false });
72
+ if (!blocked.has(String(m.fromUserId))) {
73
+ c.incoming.push({ ...m, mine: false });
74
+ }
69
75
  }
70
76
  }
71
77
  cursor = answer.cursor ?? cursor;
@@ -99,7 +105,9 @@ export function makeChat() {
99
105
  // Sends `text`; `done(status)` hears ghost's answer: "sent", "none"
100
106
  // (nobody here may read it), "limited", "refused" or "unavailable".
101
107
  send(text, done = () => {}) {
102
- const words = String(text ?? '').trim().slice(0, 200);
108
+ const words = String(text ?? '')
109
+ .trim()
110
+ .slice(0, 200);
103
111
  if (!words || sending || !c.available()) {
104
112
  return;
105
113
  }
@@ -111,7 +119,13 @@ export function makeChat() {
111
119
  return;
112
120
  }
113
121
  if (answer?.status === 'sent') {
114
- c.incoming.push({ id: answer.id ?? null, fromUserId: null, fromUsername: null, text: words, mine: true });
122
+ c.incoming.push({
123
+ id: answer.id ?? null,
124
+ fromUserId: null,
125
+ fromUsername: null,
126
+ text: words,
127
+ mine: true,
128
+ });
115
129
  }
116
130
  done(answer?.status ?? 'unavailable');
117
131
  })
@@ -131,6 +145,28 @@ export function makeChat() {
131
145
  .catch(() => done(false));
132
146
  },
133
147
 
148
+ reportAndBlock(messageId, userId, done = () => {}) {
149
+ if (typeof castleSdk.Hub?.reportChat !== 'function' || !messageId || !userId) {
150
+ done(false);
151
+ return;
152
+ }
153
+ const asked = generation;
154
+ Promise.resolve(castleSdk.Hub.reportChat(messageId, { block: true }))
155
+ .then((answer) => {
156
+ if (asked !== generation) {
157
+ return;
158
+ }
159
+ const ok = answer?.status === 'ok' && answer.blocked === true;
160
+ if (ok) {
161
+ blocked.add(String(userId));
162
+ c.peers = c.peers?.filter((id) => String(id) !== String(userId)) ?? null;
163
+ c.incoming = c.incoming.filter((m) => String(m.fromUserId) !== String(userId));
164
+ }
165
+ done(ok);
166
+ })
167
+ .catch(() => asked === generation && done(false));
168
+ },
169
+
134
170
  // Another session: the cursor and what was read belong to the last one.
135
171
  reset() {
136
172
  generation += 1;
@@ -0,0 +1,5 @@
1
+ // A scene opt-in; existing scenes retain their report-only chat controls.
2
+ export function chatModerationEnabled(scene) {
3
+ const marker = scene?.getActor?.('hub-chat-moderation')?.components?.HubChatModeration;
4
+ return marker?.v === 1 && Object.keys(marker).length === 1;
5
+ }