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,478 @@
1
+ // Earned items (contract §11, v1.53): the second wearable slot. v1.70
2
+ // adds furniture and deeds; v1.73 adds pets, with a separate cap. All are
3
+ // owned with `piece` and never worn. A game
4
+ // declares what it gives in its castle.json (`hub.unlocks`, read by the
5
+ // manifest), gives one with `hub.unlock(playerId, id)`, and the town alone
6
+ // chooses which owned one a player shows (`hub.wearEarned`). Ghost owns the
7
+ // rows, checks the declaration from the saved deck and answers with an
8
+ // EarnedItem `{ deckId, id, class, shape, name, deed, color }`; the arrival
9
+ // read carries `earned` only for a player who shows one. Nothing here touches
10
+ // the Look slot (`wear.js`): `hub.wearing` is what it was.
11
+ //
12
+ // The snapshot's `hubEarned` is playerId -> `{ class, shape, color, name }`
13
+ // (what a client draws) for helloed players who show one, without anyone a
14
+ // block hides from someone here: theirs go to each player who may see them
15
+ // alone (`hub-earned`), exactly as `hubWear` / `hub-wear` go. A place where
16
+ // nobody shows one sends neither.
17
+ //
18
+ // Where the host has no `unlock` (the dev serve), or for a guest, an unlock
19
+ // is this session's alone, from the deck's own declaration: drawn here and
20
+ // never saved, as a guest's wearable is.
21
+
22
+ import { warnOnce } from './actors.js';
23
+
24
+ export const EARNED_CLASSES = ['badge', 'pin', 'belt', 'sash', 'held'];
25
+ export const HOME_CLASSES = ['furniture', 'deed', 'pet'];
26
+ export const MAX_HOME_UNLOCKS = 6;
27
+ export const MAX_PET_UNLOCKS = 16;
28
+ export const isHome = (item) => HOME_CLASSES.includes(item?.class);
29
+ export const ITEM_ID = /^[a-z][a-z0-9-]{0,23}$/;
30
+ export const MAX_UNLOCKS = 8;
31
+ const COLOR = /^#[0-9a-f]{6}$/i;
32
+ const DECK_ID = /^[A-Za-z0-9_-]{1,100}$/;
33
+ const LIMITS = { name: 24, deed: 80 };
34
+
35
+ export function newEarnedState() {
36
+ return {
37
+ // playerId -> EarnedItem the player shows, as this place knows it
38
+ earned: new Map(),
39
+ // playerId -> how many times an unlock or choice was applied here, so an
40
+ // arrival read that began before one does not undo it (a refused one
41
+ // applies nothing and leaves the read to land)
42
+ earnedRev: new Map(),
43
+ // playerId -> JSON of the earned items last sent to that player alone, or
44
+ // `RESEND` for a client that joined afresh and is to be told again
45
+ sentEarnedMe: new Map(),
46
+ // playerId -> Set of item ids unlocked in this session only (a guest, or
47
+ // the dev serve)
48
+ sessionOwned: new Map(),
49
+ // playerId -> Set of known home item keys, from unlocks or the owned read.
50
+ // Used only to refuse a home choice before calling the host; never sent.
51
+ homeOwned: new Map(),
52
+ };
53
+ }
54
+
55
+ // One declared unlock `{ id, class, shape, name, deed, color }` (home items
56
+ // use `piece` instead of `shape`) as ghost takes
57
+ // it (ghost-server `normalizeHubUnlockEntry`: name and deed trimmed before
58
+ // their lengths are checked), or a string saying what is wrong with it.
59
+ // Unknown keys are refused.
60
+ export function readUnlock(value) {
61
+ if (!value || typeof value !== 'object' || Array.isArray(value)) {
62
+ return 'must be an object of { id, class, shape, name, deed, color }';
63
+ }
64
+ const home = isHome(value);
65
+ const field = home ? 'piece' : 'shape';
66
+ const extra = Object.keys(value).find((key) => !['id', 'class', field, 'name', 'deed', 'color'].includes(key));
67
+ if (extra) {
68
+ return `.${extra} is not part of an unlock (an earned item has no rarity)`;
69
+ }
70
+ const { id, class: cls, color } = value;
71
+ const model = value[field];
72
+ const name = typeof value.name === 'string' ? value.name.trim() : value.name;
73
+ const deed = typeof value.deed === 'string' ? value.deed.trim() : value.deed;
74
+ if (typeof id !== 'string' || !ITEM_ID.test(id)) {
75
+ return '.id must match [a-z][a-z0-9-]{0,23}';
76
+ }
77
+ if (!EARNED_CLASSES.includes(cls) && !home) {
78
+ return `.class must be one of ${[...EARNED_CLASSES, ...HOME_CLASSES].join(', ')}`;
79
+ }
80
+ if (cls === 'pet') {
81
+ if (typeof model !== 'string' || !/^pet-[a-z][a-z0-9-]{0,19}$/.test(model)) {
82
+ return '.piece of a pet must match pet-[a-z][a-z0-9-]{0,19}';
83
+ }
84
+ if (model.startsWith('pet-walk-')) {
85
+ return ".piece pet-walk-* is the house pet's stage, not a species";
86
+ }
87
+ }
88
+ if (typeof model !== 'string' || !ITEM_ID.test(model)) {
89
+ return `.${field} must match [a-z][a-z0-9-]{0,23}`;
90
+ }
91
+ if (typeof name !== 'string' || name.length < 1 || name.length > LIMITS.name) {
92
+ return `.name must be 1-${LIMITS.name} characters (trimmed)`;
93
+ }
94
+ if (typeof deed !== 'string' || deed.length < 1 || deed.length > LIMITS.deed) {
95
+ return `.deed must be 1-${LIMITS.deed} characters (trimmed)`;
96
+ }
97
+ if (typeof color !== 'string' || !COLOR.test(color)) {
98
+ return '.color must be #rrggbb';
99
+ }
100
+ return { id, class: cls, [field]: model, name, deed, color: color.toLowerCase() };
101
+ }
102
+
103
+ // `hub.unlocks`: the list, or null when it is left out; errors pushed.
104
+ export function readUnlocks(value, errors) {
105
+ if (value === undefined) {
106
+ return null;
107
+ }
108
+ if (!Array.isArray(value)) {
109
+ errors.push('hub.unlocks must be a list of { id, class, shape, name, deed, color }.');
110
+ return null;
111
+ }
112
+ if (value.filter((entry) => !isHome(entry)).length > MAX_UNLOCKS) {
113
+ errors.push(`hub.unlocks may declare at most ${MAX_UNLOCKS} items.`);
114
+ }
115
+ if (value.filter((entry) => isHome(entry) && entry.class !== 'pet').length > MAX_HOME_UNLOCKS) {
116
+ errors.push(`hub.unlocks may declare at most ${MAX_HOME_UNLOCKS} home items.`);
117
+ }
118
+ if (value.filter((entry) => entry?.class === 'pet').length > MAX_PET_UNLOCKS) {
119
+ errors.push(`hub.unlocks may declare at most ${MAX_PET_UNLOCKS} pet items.`);
120
+ }
121
+ const out = [];
122
+ const ids = new Set();
123
+ value.forEach((entry, i) => {
124
+ const read = readUnlock(entry);
125
+ if (typeof read === 'string') {
126
+ errors.push(`hub.unlocks[${i}]${read}.`);
127
+ return;
128
+ }
129
+ if (ids.has(read.id)) {
130
+ errors.push(`hub.unlocks[${i}].id "${read.id}" is declared twice.`);
131
+ return;
132
+ }
133
+ ids.add(read.id);
134
+ out.push(read);
135
+ });
136
+ return out;
137
+ }
138
+
139
+ // An EarnedItem from ghost, cleaned, or null when it is not one.
140
+ export function cleanEarned(value) {
141
+ if (!value || typeof value !== 'object' || Array.isArray(value)) {
142
+ return null;
143
+ }
144
+ if (typeof value.deckId !== 'string' || !DECK_ID.test(value.deckId)) {
145
+ return null;
146
+ }
147
+ const { deckId, ...rest } = value;
148
+ const field = isHome(rest) ? 'piece' : 'shape';
149
+ // Refuse the other model field even on a host answer.
150
+ if ((field === 'piece' ? 'shape' : 'piece') in rest) {
151
+ return null;
152
+ }
153
+ const read = readUnlock({ id: rest.id, class: rest.class, [field]: rest[field], name: rest.name, deed: rest.deed, color: rest.color });
154
+ return typeof read === 'string' ? null : { deckId, ...read };
155
+ }
156
+
157
+ function here(h, playerId) {
158
+ return typeof playerId === 'string' && (h.players.has(playerId) || h.sim?.players.has(playerId));
159
+ }
160
+
161
+ // A host receipt belongs to the session and signed-in account that started
162
+ // the request. Ghost may persist an old account's operation after that socket
163
+ // is replaced; its shown item and notices must never be applied to the new
164
+ // account reusing the player id.
165
+ function sameAccount(h, playerId, userId, session) {
166
+ if (h.session !== session || !here(h, playerId)) { return false; }
167
+ const roster = session?.players?.find((player) => player.playerId === playerId);
168
+ if (!roster || roster.isAnonymous === true || String(roster.userId) !== String(userId)) { return false; }
169
+ const known = h.players.get(playerId);
170
+ return !known || String(known.userId) === String(userId);
171
+ }
172
+
173
+ function show(h, playerId, item) {
174
+ if (isHome(item)) {
175
+ return;
176
+ }
177
+ if (item) {
178
+ h.earned.set(playerId, item);
179
+ } else {
180
+ h.earned.delete(playerId);
181
+ }
182
+ }
183
+
184
+ // Applied: an arrival read that began before this does not undo it.
185
+ function applied(h, playerId) {
186
+ h.earnedRev.set(playerId, (h.earnedRev.get(playerId) ?? 0) + 1);
187
+ }
188
+
189
+ // `hub.unlock(playerId, itemId)`: a promise of `{ isNew, earned, saved }`
190
+ // (`earned` what the player now shows, or null, a home item never;
191
+ // `saved` false for one kept in this session only), or of null when it is refused (logged once, never
192
+ // thrown). `platform` is the host's hub ops or null; `userId` the
193
+ // player's, or null for a guest; `declared` this deck's unlocks; `deckId`
194
+ // this deck's id, for a session-only item; `refused` logs a refusal once.
195
+ export function unlock(h, playerId, itemId, { platform, userId, declared, deckId, refused }) {
196
+ if (!here(h, playerId)) {
197
+ warnOnce(h, `unlock:${playerId}`, `hub.unlock: "${playerId}" is not a player here`);
198
+ return Promise.resolve(null);
199
+ }
200
+ if (typeof itemId !== 'string' || !ITEM_ID.test(itemId)) {
201
+ warnOnce(h, 'unlock:id', 'hub.unlock: an item id is [a-z][a-z0-9-]{0,23}, one of hub.unlocks');
202
+ return Promise.resolve(null);
203
+ }
204
+ if (platform && userId && typeof platform.unlock === 'function') {
205
+ const session = h.session;
206
+ const earnedRev = h.earnedRev.get(playerId) ?? 0;
207
+ return platform.unlock(playerId, itemId).then(
208
+ (answer) => {
209
+ const current = sameAccount(h, playerId, userId, session);
210
+ // Ghost answers with what the player shows, never the home item given.
211
+ const given = (declared ?? []).find((d) => d.id === itemId);
212
+ if (isHome(given) && current) {
213
+ homeUnlock(h, playerId, { deckId, ...given }, answer?.isNew === true);
214
+ }
215
+ const earned = cleanEarned(answer?.earned);
216
+ // A later applied choice wins over this receipt's older shown item.
217
+ if (earned && !isHome(earned) && current && (h.earnedRev.get(playerId) ?? 0) === earnedRev) {
218
+ show(h, playerId, earned);
219
+ applied(h, playerId);
220
+ }
221
+ return { isNew: answer?.isNew === true, earned: earned && !isHome(earned) ? { ...earned } : null, saved: true };
222
+ },
223
+ (err) => {
224
+ refused(err);
225
+ // A host whose runtime cannot keep unlocks: this session's, as on the
226
+ // dev serve.
227
+ return err?.code === UNAVAILABLE && sameAccount(h, playerId, userId, session)
228
+ ? sessionUnlock(h, playerId, itemId, declared, deckId) : null;
229
+ },
230
+ );
231
+ }
232
+ return Promise.resolve(sessionUnlock(h, playerId, itemId, declared, deckId));
233
+ }
234
+
235
+ const UNAVAILABLE = 'CAULDRON_HUB_UNAVAILABLE';
236
+
237
+ // An unlock kept in this session only, from the deck's own declaration.
238
+ function sessionUnlock(h, playerId, itemId, declared, deckId) {
239
+ const item = (declared ?? []).find((d) => d.id === itemId);
240
+ if (!item) {
241
+ warnOnce(h, `unlock:undeclared:${itemId}`, `hub.unlock: "${itemId}" is not declared in castle.json hub.unlocks`);
242
+ return null;
243
+ }
244
+ if (!h.sessionOwned.has(playerId)) {
245
+ h.sessionOwned.set(playerId, new Set());
246
+ }
247
+ const owned = h.sessionOwned.get(playerId);
248
+ const isNew = !owned.has(itemId);
249
+ owned.add(itemId);
250
+ if (isHome(item)) {
251
+ homeUnlock(h, playerId, { deckId, ...item }, isNew);
252
+ const now = h.earned.get(playerId);
253
+ return { isNew, earned: now ? { ...now } : null, saved: false };
254
+ }
255
+ // A first unlock is shown, as ghost shows it, when nothing else is.
256
+ if (isNew && !h.earned.has(playerId)) {
257
+ show(h, playerId, { deckId, ...item });
258
+ applied(h, playerId);
259
+ }
260
+ const now = h.earned.get(playerId);
261
+ return { isNew, earned: now ? { ...now } : null, saved: false };
262
+ }
263
+
264
+ // Home ownership is separate from what the avatar shows. The first unlock
265
+ // has a private announcement only; it never starts the earned wire. A
266
+ // harbour boat deed (a `boat-` piece) names its destination (v1.77); every
267
+ // other home item sends the same bytes as before.
268
+ const homeKey = (item) => JSON.stringify([item.deckId, item.id]);
269
+ const isBoat = (item) => String(item.piece ?? item.id ?? '').startsWith('boat-');
270
+ function homeUnlock(h, playerId, item, isNew) {
271
+ rememberHome(h, playerId, item);
272
+ if (isNew) {
273
+ h.session?.send(playerId, isBoat(item) ? { k: 'hub-home-unlock', to: 'boat' } : { k: 'hub-home-unlock' });
274
+ }
275
+ }
276
+
277
+ function rememberHome(h, playerId, item) {
278
+ if (!h.homeOwned.has(playerId)) {
279
+ h.homeOwned.set(playerId, new Set());
280
+ }
281
+ h.homeOwned.get(playerId).add(homeKey(item));
282
+ }
283
+
284
+ // `hub.wearEarned(playerId, { deckId, id } | null)`: the town's choice of
285
+ // what an owned earned item a player shows. A promise of `{ earned, saved }`,
286
+ // or of null when it is refused (logged once, never thrown).
287
+ export function wearEarned(h, playerId, choice, { platform, userId, deckId, declared, refused }) {
288
+ if (!here(h, playerId)) {
289
+ warnOnce(h, `wearEarned:${playerId}`, `hub.wearEarned: "${playerId}" is not a player here`);
290
+ return Promise.resolve(null);
291
+ }
292
+ const pick = choice ?? null;
293
+ if (
294
+ pick !== null &&
295
+ (typeof pick !== 'object' || typeof pick.deckId !== 'string' || !DECK_ID.test(pick.deckId) || typeof pick.id !== 'string' || !ITEM_ID.test(pick.id))
296
+ ) {
297
+ warnOnce(h, 'wearEarned:spec', 'hub.wearEarned: a choice is { deckId, id } or null');
298
+ return Promise.resolve(null);
299
+ }
300
+ const item = pick?.deckId === deckId ? (declared ?? []).find((d) => d.id === pick.id) : null;
301
+ if (pick && (isHome(item) || h.homeOwned.get(playerId)?.has(homeKey(pick)))) {
302
+ refused({ code: 'CAULDRON_HUB_EARNED_NOT_WEARABLE', message: 'home items are never worn' });
303
+ return Promise.resolve(null);
304
+ }
305
+ if (platform && userId && typeof platform.wearEarned === 'function') {
306
+ const session = h.session;
307
+ return platform.wearEarned(playerId, pick && { deckId: pick.deckId, id: pick.id }).then(
308
+ (answer) => {
309
+ const earned = cleanEarned(answer?.earned);
310
+ if (isHome(earned)) {
311
+ refused({ code: 'CAULDRON_HUB_EARNED_NOT_WEARABLE', message: 'home items are never worn' });
312
+ return null;
313
+ }
314
+ if (sameAccount(h, playerId, userId, session)) {
315
+ show(h, playerId, earned);
316
+ applied(h, playerId);
317
+ }
318
+ return { earned: earned ? { ...earned } : null, saved: true };
319
+ },
320
+ (err) => {
321
+ refused(err);
322
+ return err?.code === UNAVAILABLE && sameAccount(h, playerId, userId, session)
323
+ ? sessionChoice(h, playerId, pick, declared, deckId) : null;
324
+ },
325
+ );
326
+ }
327
+ return Promise.resolve(sessionChoice(h, playerId, pick, declared, deckId));
328
+ }
329
+
330
+ // A choice kept in this session only: an item unlocked here, or none.
331
+ function sessionChoice(h, playerId, pick, declared, deckId) {
332
+ if (pick === null) {
333
+ show(h, playerId, null);
334
+ applied(h, playerId);
335
+ return { earned: null, saved: false };
336
+ }
337
+ const item = pick.deckId === deckId && h.sessionOwned.get(playerId)?.has(pick.id) ? (declared ?? []).find((d) => d.id === pick.id) : null;
338
+ if (!item) {
339
+ warnOnce(h, `wearEarned:owned:${pick.deckId}:${pick.id}`, `hub.wearEarned: the player does not own ${pick.deckId}/${pick.id} here`);
340
+ return null;
341
+ }
342
+ show(h, playerId, { deckId, ...item });
343
+ applied(h, playerId);
344
+ return { earned: { deckId, ...item }, saved: false };
345
+ }
346
+
347
+ // `hub.unlocksOf(userIds)`: always a promise: of ghost's read, `{ players: {
348
+ // [userId]: { owned } } }`, or of null where the host lacks it or refuses it
349
+ // (logged once).
350
+ export function unlocksOf(platform, userIds, refused, h = null) {
351
+ if (!platform || typeof platform.readUnlocks !== 'function') {
352
+ return Promise.resolve(null);
353
+ }
354
+ const ids = Array.isArray(userIds) ? userIds.filter((id) => typeof id === 'string') : [];
355
+ return platform.readUnlocks(ids).then(
356
+ (read) => {
357
+ const players = {};
358
+ for (const [userId, entry] of Object.entries(read?.players ?? {})) {
359
+ players[userId] = { owned: (Array.isArray(entry?.owned) ? entry.owned : []).map(cleanEarned).filter(Boolean) };
360
+ // A wardrobe read tells us the class of a cross-deck choice too.
361
+ for (const player of h?.session?.players ?? []) {
362
+ if (String(player.userId) === userId && here(h, player.playerId)) {
363
+ for (const item of players[userId].owned.filter(isHome)) {
364
+ rememberHome(h, player.playerId, item);
365
+ }
366
+ }
367
+ }
368
+ }
369
+ return { players };
370
+ },
371
+ (err) => {
372
+ refused(err);
373
+ return null;
374
+ },
375
+ );
376
+ }
377
+
378
+ // `hub.earned(playerId)`: the item a player here shows, a copy, or null.
379
+ export function earnedOf(h, playerId) {
380
+ if (!h.players.has(playerId)) {
381
+ return null;
382
+ }
383
+ const item = h.earned.get(playerId);
384
+ return item ? { ...item } : null;
385
+ }
386
+
387
+ // Ghost's word on a player's earned item, from the arrival read: kept when the
388
+ // read carries one, unless an unlock or choice was made here since the read
389
+ // began. A read without one (most players, and every ghost older than earned
390
+ // items) changes nothing.
391
+ export function applyRead(h, playerId, earnedRev, read) {
392
+ if (!read || !('earned' in read) || (h.earnedRev.get(playerId) ?? 0) !== earnedRev) {
393
+ return;
394
+ }
395
+ const earned = cleanEarned(read.earned);
396
+ if (earned && !isHome(earned)) {
397
+ h.earned.set(playerId, earned);
398
+ }
399
+ }
400
+
401
+ // What a client draws of one item.
402
+ function drawn(item) {
403
+ return { class: item.class, shape: item.shape, color: item.color, name: item.name };
404
+ }
405
+
406
+ // Everyone's earned items, for everyone: helloed players only, without the
407
+ // ones a block hides from someone here.
408
+ export function earnedForAll(h, hidden) {
409
+ const out = {};
410
+ for (const [playerId, item] of h.earned) {
411
+ if (h.players.get(playerId)?.hello && !hidden?.has(playerId)) {
412
+ out[playerId] = drawn(item);
413
+ }
414
+ }
415
+ return out;
416
+ }
417
+
418
+ // Whether this place has anything of earned items to send.
419
+ export function used(h) {
420
+ return h.earned.size > 0 || h.sentEarnedMe.size > 0;
421
+ }
422
+
423
+ // Housekeeping is separate from the wire gate: home ownership (including a
424
+ // grant before hello) must be forgotten even when no avatar shows an item.
425
+ export function needsPrune(h) {
426
+ return used(h) || h.earnedRev.size > 0 || h.sessionOwned.size > 0 || h.homeOwned.size > 0;
427
+ }
428
+
429
+ // The earned items of players in a hidden pair, each to the players who may
430
+ // see them, when they change (`hub-earned`), as `wear.js` sends `hub-wear`.
431
+ export function sendOverrides(h, hidden) {
432
+ for (const playerId of h.sim.players.keys()) {
433
+ const out = {};
434
+ for (const shrouded of hidden?.keys() ?? []) {
435
+ const item = h.earned.get(shrouded);
436
+ if (item && h.players.get(shrouded)?.hello && !hidden.get(playerId)?.has(shrouded)) {
437
+ out[shrouded] = drawn(item);
438
+ }
439
+ }
440
+ const json = JSON.stringify(out);
441
+ // A client that joined afresh holds nothing of it: told again, empty or not.
442
+ if ((h.sentEarnedMe.get(playerId) ?? '{}') !== json) {
443
+ h.sentEarnedMe.set(playerId, json);
444
+ h.session?.send(playerId, { k: 'hub-earned', hubEarned: out });
445
+ }
446
+ }
447
+ }
448
+
449
+ // A client joined afresh (a hello that is not an avatar change: a reload that
450
+ // kept its player id, a reconnect). What it held of `hub-earned` is gone, so
451
+ // it is sent the map as it is now, empty or not, on the next tick. Asked only
452
+ // in a place where someone shows one or was sent one alone (`used`).
453
+ const RESEND = 'resend';
454
+
455
+ export function joinedAfresh(h, playerId) {
456
+ h.sentEarnedMe.set(playerId, RESEND);
457
+ }
458
+
459
+ // An item is taken for a player with a body who has not said hello (as
460
+ // `hub.wear` takes one), and such a player's going is not a `forget`: drop
461
+ // what is kept for anyone neither known to the place nor in the simulation.
462
+ export function prune(h) {
463
+ for (const kept of [h.earned, h.earnedRev, h.sentEarnedMe, h.sessionOwned, h.homeOwned]) {
464
+ for (const playerId of [...kept.keys()]) {
465
+ if (!h.players.has(playerId) && !h.sim?.players.has(playerId)) {
466
+ kept.delete(playerId);
467
+ }
468
+ }
469
+ }
470
+ }
471
+
472
+ export function forget(h, playerId) {
473
+ h.earned.delete(playerId);
474
+ h.earnedRev.delete(playerId);
475
+ h.sentEarnedMe.delete(playerId);
476
+ h.sessionOwned.delete(playerId);
477
+ h.homeOwned.delete(playerId);
478
+ }
@@ -0,0 +1,183 @@
1
+ // Opt-in transport: capture packets when sent, then deliver each player's
2
+ // ordered packets together after the simulation tick. The unbatched handlers
3
+ // and session are returned unchanged when the deck does not opt in.
4
+ const PAYLOAD_BYTES = 60000;
5
+ const encoder = new TextEncoder();
6
+ // Host teardown precedes onShutdown. Commands that end/change a visit cannot
7
+ // sit behind replay. Controls use a reserved, paced lane ahead of snapshots.
8
+ const IMMEDIATE = new Set(['hub-frame-offer', 'hub-go', 'hub-end', 'hub-result', 'hub-home-unlock', 'hub-leaving', 'replaced', 'x']);
9
+
10
+ export function batchFrames(callbacks, enabled) {
11
+ if (!enabled) { return callbacks; }
12
+ const queues = new Map();
13
+ const controls = new Map();
14
+ // Reserve 192 KiB/s of the host's 1 MiB/s budget for storage/hub requests.
15
+ const normalBudget = { rate: 768 * 1024, tokens: 65500, at: Date.now() };
16
+ const controlBudget = { rate: 64 * 1024, tokens: 65500, at: Date.now() };
17
+ // Both lanes share a frame bucket, leaving host headroom for RPCs.
18
+ const frameBudget = { tokens: 20, at: Date.now() };
19
+ const sessions = new WeakMap();
20
+ const ready = new Set();
21
+ const offers = new Map();
22
+ let stopping = false;
23
+
24
+ function enqueue(session, id, data) {
25
+ if (stopping) { return; }
26
+ if (!session.players.some((p) => p.playerId === id)) { return; }
27
+ const json = JSON.stringify(data);
28
+ // Capture before another hook mutates the same object, as session.send does.
29
+ const packet = json === undefined ? 'null' : json;
30
+ // Reject a source packet that cannot fit a legal runtime frame; never
31
+ // bypass pacing or leave an undeliverable packet at the FIFO head.
32
+ if (encoder.encode(packet).length + 160 > 65500) { throw new RangeError('hub.frameBatch packet exceeds the runtime frame limit'); }
33
+ const lane = IMMEDIATE.has(data?.k) ? controls : queues;
34
+ const queue = lane.get(id) ?? [];
35
+ queue.push({ packet, bytes: encoder.encode(packet).length });
36
+ lane.set(id, queue);
37
+ if (lane === controls) { flushLane(session, controls, controlBudget, id); }
38
+ }
39
+
40
+ function wrapped(session) {
41
+ let proxy = sessions.get(session);
42
+ if (!proxy) {
43
+ proxy = new Proxy(session, {
44
+ get(target, key) {
45
+ if (key === 'send') { return (id, data) => enqueue(target, id, data); }
46
+ if (key === 'broadcast') {
47
+ return (data, options) => {
48
+ if (stopping) { return; }
49
+ // Serialize once even when this broadcast has many recipients.
50
+ const value = JSON.parse(JSON.stringify(data) ?? 'null');
51
+ for (const p of target.players) {
52
+ if (p.playerId !== options?.except) { enqueue(target, p.playerId, value); }
53
+ }
54
+ };
55
+ }
56
+ const value = Reflect.get(target, key, target);
57
+ return typeof value === 'function' ? value.bind(target) : value;
58
+ },
59
+ });
60
+ sessions.set(session, proxy);
61
+ }
62
+ return proxy;
63
+ }
64
+
65
+ function refill(budget) {
66
+ const now = Date.now();
67
+ budget.tokens = Math.min(65500, budget.tokens + Math.max(0, now - budget.at) * budget.rate / 1000);
68
+ budget.at = now;
69
+ }
70
+
71
+ function packetFor(queue, allowance) {
72
+ const packets = [];
73
+ let bytes = 160; // Envelope plus platform protocol/recipient overhead.
74
+ for (const row of queue) {
75
+ if (bytes + row.bytes + 1 > Math.min(PAYLOAD_BYTES, allowance)) { break; }
76
+ bytes += row.bytes + 1;
77
+ packets.push(row.packet);
78
+ }
79
+ if (!packets.length) {
80
+ // A valid large single packet gets its own paced envelope.
81
+ const row = queue[0];
82
+ if (row && row.bytes + 160 <= allowance) {
83
+ return { count: 1, bytes: row.bytes + 160, text: `{"k":"hub-frame","packets":[${row.packet}]}` };
84
+ }
85
+ return null;
86
+ }
87
+ return { count: packets.length, bytes,
88
+ text: `{"k":"hub-frame","packets":[${packets.join(',')}]}` };
89
+ }
90
+
91
+ function flushLane(session, lane, budget, only) {
92
+ refill(budget);
93
+ const players = new Set(session.players.map((p) => p.playerId));
94
+ const now = Date.now();
95
+ frameBudget.tokens = Math.min(20, frameBudget.tokens + Math.max(0, now - frameBudget.at) * 30 * players.size / 1000);
96
+ frameBudget.at = now;
97
+ for (const id of lane.keys()) { if (!players.has(id)) { lane.delete(id); } }
98
+ function delivered(id, count) {
99
+ const queue = lane.get(id);
100
+ queue.splice(0, count);
101
+ lane.delete(id);
102
+ if (queue.length) { lane.set(id, queue); } // Round-robin across ticks.
103
+ }
104
+ const shared = only === undefined && lane.size === players.size
105
+ ? [...lane].map(([id, queue]) => ({ id, row: packetFor(queue, budget.tokens) })) : [];
106
+ if (frameBudget.tokens >= 1 && shared.length && shared.every(({ row }) => row && row.text === shared[0].row.text)) {
107
+ frameBudget.tokens -= 1;
108
+ budget.tokens -= shared[0].row.bytes;
109
+ session.broadcast(JSON.parse(shared[0].row.text));
110
+ for (const { id, row } of shared) { delivered(id, row.count); }
111
+ return;
112
+ }
113
+ for (const [id, queue] of [...lane]) {
114
+ if (frameBudget.tokens < 1) { break; }
115
+ if (only !== undefined && id !== only) { continue; }
116
+ const row = packetFor(queue, budget.tokens);
117
+ if (!row) { continue; }
118
+ frameBudget.tokens -= 1;
119
+ budget.tokens -= row.bytes;
120
+ session.send(id, JSON.parse(row.text));
121
+ delivered(id, row.count);
122
+ }
123
+ }
124
+
125
+ function flush(session) {
126
+ flushLane(session, controls, controlBudget);
127
+ const held = new Map();
128
+ for (const id of controls.keys()) {
129
+ if (queues.has(id)) { held.set(id, queues.get(id)); queues.delete(id); }
130
+ }
131
+ flushLane(session, queues, normalBudget);
132
+ for (const [id, queue] of held) { queues.set(id, queue); }
133
+ }
134
+
135
+ const out = { ...callbacks };
136
+ for (const name of ['onStart']) {
137
+ if (callbacks[name]) { out[name] = (session, ...args) => callbacks[name](wrapped(session), ...args); }
138
+ }
139
+ out.onPlayerJoin = (session, player, ...args) => {
140
+ const id = player.playerId;
141
+ ready.delete(id); queues.delete(id); controls.delete(id);
142
+ offers.set(id, Date.now());
143
+ enqueue(session, id, { k: 'hub-frame-offer' });
144
+ return callbacks.onPlayerJoin?.(wrapped(session), player, ...args);
145
+ };
146
+ out.onPlayerLeave = (session, player, ...args) => {
147
+ ready.delete(player.playerId); offers.delete(player.playerId); queues.delete(player.playerId); controls.delete(player.playerId);
148
+ return callbacks.onPlayerLeave?.(wrapped(session), player, ...args);
149
+ };
150
+ out.onMessage = (session, player, data, ...args) => {
151
+ if (data?.k === 'hub-frame-ready') {
152
+ if (offers.has(player.playerId) && session.players.some((p) => p.playerId === player.playerId)) { ready.add(player.playerId); }
153
+ return;
154
+ }
155
+ return callbacks.onMessage?.(wrapped(session), player, data, ...args);
156
+ };
157
+ out.onTick = (session) => {
158
+ // ACK affects offer retries, never eligibility for the paced FIFO.
159
+ const now = Date.now();
160
+ const players = new Set(session.players.map((p) => p.playerId));
161
+ for (const id of ready) { if (!players.has(id)) { ready.delete(id); } }
162
+ for (const id of offers.keys()) { if (!players.has(id)) { offers.delete(id); } }
163
+ for (const id of players) {
164
+ if (!ready.has(id) && now - (offers.get(id) ?? -Infinity) >= 1000) {
165
+ offers.set(id, now);
166
+ enqueue(session, id, { k: 'hub-frame-offer' });
167
+ }
168
+ }
169
+ try { return callbacks.onTick?.(wrapped(session)); }
170
+ finally { flush(session); }
171
+ };
172
+ if (callbacks.onReplaced) {
173
+ out.onReplaced = (session) => {
174
+ callbacks.onReplaced(wrapped(session));
175
+ flush(session);
176
+ };
177
+ }
178
+ out.onShutdown = async (...args) => {
179
+ stopping = true; controls.clear(); queues.clear(); ready.clear(); offers.clear();
180
+ return callbacks.onShutdown?.(...args);
181
+ };
182
+ return out;
183
+ }