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,107 @@
1
+ // The companion (v1.71): one private follower per arrived player.
2
+ import { check } from '../companionSpec.js';
3
+ import { heldAway } from './vis.js';
4
+ const SEND_EVERY_MS = 250;
5
+ function need(condition, message) {
6
+ if (!condition) {
7
+ throw new TypeError(`hub.companion: ${message}`);
8
+ }
9
+ }
10
+ function present(h, playerId) {
11
+ return h.session?.players.some((p) => p.playerId === playerId) && h.sim?.players.has(playerId);
12
+ }
13
+ function arrived(h, playerId) {
14
+ const entry = h.players.get(playerId);
15
+ return present(h, playerId) && entry?.arrived && !entry.ended;
16
+ }
17
+ // v1.145: a resumePose place keeps an authenticated player's follower while
18
+ // their visit is retained, as it keeps their HUD; nothing is sent until they
19
+ // are back.
20
+ function held(h, playerId) {
21
+ return heldAway(h, playerId) && !h.players.get(playerId)?.ended;
22
+ }
23
+ function current(h, playerId) {
24
+ return h.companionMe?.get(playerId) ?? { c: null, n: 0, json: 'null', sentJson: 'null', sentN: 0, sentAt: -Infinity };
25
+ }
26
+ function send(h, playerId, state) {
27
+ h.session?.send(playerId, { k: 'hub-companion', c: state.c, n: state.n });
28
+ state.sentN = state.n;
29
+ state.sentJson = state.json;
30
+ state.sentAt = h.sim?.timeMs ?? 0;
31
+ }
32
+ // One counter for the place's session, so no spec ever shares a version with
33
+ // an earlier one, whoever it was for and whenever they left and came back.
34
+ function version(h) {
35
+ h.companionSeq = (h.companionSeq ?? 0) + 1;
36
+ return h.companionSeq;
37
+ }
38
+
39
+ export function set(h, playerId, c) {
40
+ need(h.place.companion === true, 'this place does not declare companion');
41
+ need(typeof playerId === 'string', 'playerId must be a string');
42
+ const checked = check(c);
43
+ if (!arrived(h, playerId) && !held(h, playerId)) {
44
+ return false;
45
+ }
46
+ const state = current(h, playerId), json = JSON.stringify(checked);
47
+ if (state.json === json) {
48
+ return true;
49
+ }
50
+ // Record every changed spec; the tick sends only the latest, at most 4/s.
51
+ // Back to the spec the player was last sent, with nothing sent since: that
52
+ // spec and its version stand (the client never heard of the ones between).
53
+ const n = json === state.sentJson ? state.sentN : version(h);
54
+ (h.companionMe ??= new Map()).set(playerId, { ...state, c: checked, json, n });
55
+ if (checked) {
56
+ h.companionUsed = true;
57
+ }
58
+ return true;
59
+ }
60
+
61
+ // Nothing is sent, or kept, for a player the place never gave a companion.
62
+ export function joinedAfresh(h, playerId, identityUserId = null) {
63
+ const state = h.companionMe?.get(playerId);
64
+ const kept = h.resumeKept?.get(playerId);
65
+ // v1.145: a retained follower goes back only to the account it was for; the
66
+ // client keeps its follower across a same-id reconnect, so clear it.
67
+ if (state && h.place.resumePose === true && typeof kept?.identityUserId === 'string' &&
68
+ kept.identityUserId !== identityUserId) {
69
+ clearRetained(h, playerId);
70
+ return;
71
+ }
72
+ if (state) {
73
+ send(h, playerId, state);
74
+ }
75
+ }
76
+ // Drop a held follower; a client that was ever sent one is told to drop it.
77
+ export function clearRetained(h, playerId) {
78
+ const state = h.companionMe?.get(playerId);
79
+ forget(h, playerId);
80
+ if (state && state.sentJson !== 'null') {
81
+ h.session?.send(playerId, { k: 'hub-companion', c: null, n: version(h) });
82
+ }
83
+ }
84
+ export function forget(h, playerId) {
85
+ h.companionMe?.delete(playerId);
86
+ }
87
+ export function prune(h) {
88
+ for (const playerId of h.companionMe?.keys() ?? []) {
89
+ // An ended visit is over for the follower too: nothing of it is replayed.
90
+ if (!present(h, playerId) || h.players.get(playerId)?.ended) {
91
+ if (!held(h, playerId)) {
92
+ forget(h, playerId);
93
+ }
94
+ continue;
95
+ }
96
+ const state = h.companionMe?.get(playerId);
97
+ // Unsent intermediate specs coalesce; an equal last-sent spec stays put.
98
+ if (state && state.n !== state.sentN && h.sim.timeMs - state.sentAt >= SEND_EVERY_MS) {
99
+ send(h, playerId, state);
100
+ }
101
+ }
102
+ }
103
+
104
+ // Public presence alone: never the look, dress, words or target.
105
+ export function glowOf(h) {
106
+ return [...(h.companionMe ?? [])].filter(([id, state]) => state.c && h.players.get(id)?.hello && arrived(h, id)).map(([id]) => id).sort();
107
+ }
@@ -0,0 +1,70 @@
1
+ // Synthesised place cues (v1.50). Budgets are made only after an enabled
2
+ // deck asks; private targets have separate buckets, broadcasts share one.
3
+ import { warnOnce, isActor } from './actors.js';
4
+ import { CUE_NAMES } from '../shared/cues.js';
5
+ export { CUE_NAMES } from '../shared/cues.js';
6
+
7
+ function refuse(h, key, text) {
8
+ warnOnce(h, `cue:${key}`, `hub.cue: ${text}`);
9
+ return false;
10
+ }
11
+
12
+ function spend(h, key) {
13
+ const now = h.sim?.timeMs;
14
+ if (!Number.isFinite(now)) {
15
+ return false;
16
+ }
17
+ const budgets = (h.cueBudgets ??= new Map());
18
+ const b = budgets.get(key) ?? { tokens: 6, at: now };
19
+ b.tokens = Math.min(6, b.tokens + Math.max(0, now - b.at) * 0.006);
20
+ b.at = now;
21
+ budgets.set(key, b);
22
+ if (b.tokens < 1) {
23
+ return false;
24
+ }
25
+ b.tokens -= 1;
26
+ return true;
27
+ }
28
+
29
+ export function cue(h, target, name) {
30
+ try {
31
+ if (h.manifest.soundscape?.cues !== true) {
32
+ return refuse(h, 'off', 'this deck does not turn on soundscape.cues');
33
+ }
34
+ if (typeof name !== 'string' || !CUE_NAMES.includes(name)) {
35
+ return refuse(h, 'name', 'unknown cue name');
36
+ }
37
+ if (!target || typeof target !== 'object' || Array.isArray(target)) {
38
+ return refuse(h, 'target', 'target must name one player or actor');
39
+ }
40
+ const player = Object.hasOwn(target, 'player');
41
+ const actor = Object.hasOwn(target, 'actor');
42
+ if (player === actor || Object.keys(target).some((key) => !['player', 'actor', 'radius'].includes(key))) {
43
+ return refuse(h, 'target', 'target must name one player or actor');
44
+ }
45
+ if (player) {
46
+ const id = target.player;
47
+ const entry = h.players.get(id);
48
+ if (typeof id !== 'string' || !entry?.arrived || entry.ended || !h.sim?.players.has(id) || !h.session?.players?.some((p) => p.playerId === id) || !h.session?.send || Object.hasOwn(target, 'radius')) {
49
+ return refuse(h, 'player', 'player is not connected here or target is invalid');
50
+ }
51
+ if (!spend(h, `player:${id}`)) {
52
+ return refuse(h, 'private-rate', 'at most 6 cues a second per player');
53
+ }
54
+ h.session.send(id, { k: 'hub-cue', cue: name });
55
+ } else {
56
+ const id = target.actor;
57
+ const radius = Object.hasOwn(target, 'radius') ? target.radius : 12;
58
+ if (!isActor(h, id) || !h.session?.broadcast || typeof radius !== 'number' || !Number.isFinite(radius) || radius < 1 || radius > 60) {
59
+ return refuse(h, 'actor', 'actor or radius is invalid (1–60 m)');
60
+ }
61
+ if (!spend(h, 'actors')) {
62
+ return refuse(h, 'actor-rate', 'at most 6 actor cues a second per place');
63
+ }
64
+ h.session.broadcast({ k: 'hub-cue', cue: name, actor: id, radius });
65
+ }
66
+ return true;
67
+ } catch {
68
+ return refuse(h, 'invalid', 'invalid cue target');
69
+ }
70
+ }
@@ -0,0 +1,269 @@
1
+ // Decorating (contract §10, v1.67). The kit offers a private catalogue and
2
+ // validates input; only the deck's decor hook applies an edit. Nothing here
3
+ // exists in a place without `decor`, and no private state enters a snapshot.
4
+ import { DECOR_ID, footprint } from '../shared/decor.js';
5
+
6
+ export const MAX_ITEMS = 64;
7
+ export const MAX_PLACED = 64;
8
+ export const MAX_SWATCHES = 24;
9
+ const COLOR = /^#[0-9a-fA-F]{6}$/;
10
+ const ACTOR = (value) => typeof value === 'string' && value.trim().length > 0 && value.length <= 128;
11
+ const object = (value) => value !== null && typeof value === 'object' && !Array.isArray(value);
12
+ const int = (value, min, max) => Number.isSafeInteger(value) && value >= min && value <= max;
13
+ const text = (value, max) => typeof value === 'string' && value.trim().length > 0 && value.length <= max;
14
+
15
+ function need(condition, message) {
16
+ if (!condition) {
17
+ throw new TypeError(`hub.decor: ${message}`);
18
+ }
19
+ }
20
+ function keys(value, allowed, where) {
21
+ need(object(value), `${where} must be an object`);
22
+ need(Object.keys(value).every((key) => allowed.includes(key)), `${where} has an unknown key`);
23
+ }
24
+ function id(value, where) {
25
+ need(typeof value === 'string' && DECOR_ID.test(value), `${where} must be a short id`);
26
+ }
27
+
28
+ // The manifest and the publish check share this reader. Absence adds no key.
29
+ export function readDecor(value, where, errors) {
30
+ if (value === undefined) {
31
+ return null;
32
+ }
33
+ try {
34
+ keys(value, ['grid', 'layers'], where);
35
+ keys(value.grid, ['origin', 'w', 'd', 'cell'], `${where}.grid`);
36
+ const { origin, w, d, cell } = value.grid;
37
+ need(ACTOR(origin), `${where}.grid.origin must name an actor`);
38
+ need(int(w, 1, 16) && int(d, 1, 16), `${where}.grid w and d must be integers in 1..16`);
39
+ need(Number.isFinite(cell) && cell >= 0.5 && cell <= 2, `${where}.grid.cell must be 0.5..2 metres`);
40
+ need(Array.isArray(value.layers) && value.layers.length >= 1 && value.layers.length <= 3, `${where}.layers must contain 1..3 ids`);
41
+ for (const layer of value.layers) {
42
+ id(layer, `${where}.layers`);
43
+ }
44
+ need(new Set(value.layers).size === value.layers.length, `${where}.layers must be unique`);
45
+ return { grid: { origin, w, d, cell }, layers: [...value.layers] };
46
+ } catch (error) {
47
+ errors.push(error.message);
48
+ return null;
49
+ }
50
+ }
51
+
52
+ function list(value, max, where, nonempty = false) {
53
+ need(Array.isArray(value) && value.length <= max && (!nonempty || value.length > 0), `${where} must be an array of ${nonempty ? '1..' : 'at most '}${max}`);
54
+ }
55
+ function unique(values, where) {
56
+ need(new Set(values).size === values.length, `${where} must be unique`);
57
+ }
58
+
59
+ export function checkSpec(h, value) {
60
+ keys(value, ['title', 'tabs', 'items', 'swatches', 'placed'], 'spec');
61
+ const out = {};
62
+ if (value.title !== undefined) {
63
+ need(typeof value.title === 'string' && value.title.length <= 40, 'title must be at most 40 characters');
64
+ out.title = value.title;
65
+ }
66
+ list(value.tabs, 6, 'tabs', true);
67
+ out.tabs = value.tabs.map((tab) => {
68
+ keys(tab, ['id', 'label'], 'tab');
69
+ id(tab.id, 'tab.id');
70
+ need(text(tab.label, 16), 'tab.label must be 1..16 characters');
71
+ return { id: tab.id, label: tab.label };
72
+ });
73
+ unique(out.tabs.map((tab) => tab.id), 'tab ids');
74
+ const tabs = new Set(out.tabs.map((tab) => tab.id));
75
+ list(value.items, MAX_ITEMS, 'items');
76
+ out.items = value.items.map((item) => {
77
+ keys(item, ['id', 'tab', 'label', 'template', 'w', 'd', 'layer', 'count', 'locked'], 'item');
78
+ id(item.id, 'item.id');
79
+ need(tabs.has(item.tab), 'item.tab must name a tab');
80
+ need(text(item.label, 16), 'item.label must be 1..16 characters');
81
+ const c = h.actors.find((actor) => actor.id === item.template)?.components;
82
+ need(ACTOR(item.template) && c?.Transform && c.Shape && !['Player', 'HubDoor', 'HubNpc', 'HubPad', 'Pickup'].some((name) => c[name]) && c.Body?.type !== 'dynamic', 'item.template must name a spawnable scene actor');
83
+ need(int(item.w, 1, 4) && int(item.d, 1, 4), 'item w and d must be integers in 1..4');
84
+ need(h.place.decor.layers.includes(item.layer), 'item.layer must name a decor layer');
85
+ need(int(item.count, 0, Number.MAX_SAFE_INTEGER), 'item.count must be a non-negative integer');
86
+ const entry = { id: item.id, tab: item.tab, label: item.label, template: item.template, w: item.w, d: item.d, layer: item.layer, count: item.count };
87
+ if (item.locked !== undefined) {
88
+ keys(item.locked, ['price'], 'item.locked');
89
+ need(text(item.locked.price, 12), 'locked.price must be 1..12 characters');
90
+ entry.locked = { price: item.locked.price };
91
+ }
92
+ return entry;
93
+ });
94
+ unique(out.items.map((item) => item.id), 'item ids');
95
+ if (value.swatches !== undefined) {
96
+ list(value.swatches, MAX_SWATCHES, 'swatches');
97
+ out.swatches = value.swatches.map((swatch) => {
98
+ keys(swatch, ['id', 'tab', 'label', 'color'], 'swatch');
99
+ id(swatch.id, 'swatch.id');
100
+ need(tabs.has(swatch.tab), 'swatch.tab must name a tab');
101
+ need(text(swatch.label, 16), 'swatch.label must be 1..16 characters');
102
+ need(typeof swatch.color === 'string' && COLOR.test(swatch.color), 'swatch.color must be #rrggbb');
103
+ return { id: swatch.id, tab: swatch.tab, label: swatch.label, color: swatch.color };
104
+ });
105
+ unique(out.swatches.map((swatch) => swatch.id), 'swatch ids');
106
+ }
107
+ list(value.placed, MAX_PLACED, 'placed');
108
+ out.placed = value.placed.map((piece) => {
109
+ keys(piece, ['key', 'item', 'x', 'z', 'rot', 'layer'], 'placed piece');
110
+ need(ACTOR(piece.key) && h.spawned.has(piece.key), 'placed.key must name a spawned actor');
111
+ const item = out.items.find((i) => i.id === piece.item);
112
+ need(item && item.layer === piece.layer, 'placed item and layer must match the catalogue');
113
+ need(int(piece.rot, 0, 3), 'placed.rot must be 0..3');
114
+ const size = footprint(item, piece.rot), grid = h.place.decor.grid;
115
+ need(int(piece.x, 0, grid.w - size.w) && int(piece.z, 0, grid.d - size.d), 'placed piece must fit in the grid');
116
+ return { key: piece.key, item: piece.item, x: piece.x, z: piece.z, rot: piece.rot, layer: piece.layer };
117
+ });
118
+ unique(out.placed.map((piece) => piece.key), 'placed keys');
119
+ return out;
120
+ }
121
+
122
+ function present(h, playerId) {
123
+ return typeof playerId === 'string' && h.session?.players.some((p) => p.playerId === playerId);
124
+ }
125
+ function player(h, playerId) {
126
+ need(h.place.decor, 'this place does not declare decor');
127
+ need(present(h, playerId), 'playerId must name a player here');
128
+ }
129
+ function gridOf(h) {
130
+ const grid = h.place.decor.grid;
131
+ const t = h.actors.find((actor) => actor.id === grid.origin)?.components.Transform;
132
+ need(t && ['x', 'y', 'z'].every((key) => t[key] === undefined || Number.isFinite(t[key])), 'grid.origin must have a finite Transform');
133
+ return { x: t.x ?? 0, y: t.y ?? 0, z: t.z ?? 0, w: grid.w, d: grid.d, cell: grid.cell };
134
+ }
135
+ function current(h, playerId) {
136
+ return h.decorMe?.get(playerId) ?? { button: null, spec: null };
137
+ }
138
+ function send(h, playerId, state) {
139
+ const wire = { k: 'hub-decor', ...state };
140
+ if (state.spec) {
141
+ wire.grid = gridOf(h);
142
+ }
143
+ h.session?.send(playerId, wire);
144
+ }
145
+ function set(h, playerId, state) {
146
+ (h.decorMe ??= new Map()).set(playerId, state);
147
+ send(h, playerId, state);
148
+ }
149
+
150
+ export function api(h) {
151
+ return Object.freeze({
152
+ has(key) {
153
+ const actor = h.spawned.get(key)?.actor;
154
+ return Boolean(actor && (!actor.components.Body || !h.sim || h.sim.bodies.has(key)));
155
+ },
156
+ button(playerId, label) {
157
+ player(h, playerId);
158
+ need(label === null || text(label, 16), 'button label must be null or 1..16 characters');
159
+ set(h, playerId, { ...current(h, playerId), button: label });
160
+ },
161
+ open(playerId, spec) {
162
+ player(h, playerId);
163
+ const checked = checkSpec(h, spec);
164
+ gridOf(h);
165
+ set(h, playerId, { ...current(h, playerId), spec: checked });
166
+ },
167
+ close(playerId) {
168
+ player(h, playerId);
169
+ set(h, playerId, { ...current(h, playerId), spec: null });
170
+ },
171
+ update(playerId, partial) {
172
+ player(h, playerId);
173
+ const state = current(h, playerId);
174
+ need(state.spec, 'update needs an open catalogue');
175
+ keys(partial, ['title', 'tabs', 'items', 'swatches', 'placed'], 'partial spec');
176
+ const checked = checkSpec(h, { ...state.spec, ...partial });
177
+ set(h, playerId, { ...state, spec: checked });
178
+ },
179
+ });
180
+ }
181
+
182
+ export function message(h, playerId, data) {
183
+ if (!h.place.decor || !h.sim?.players.has(playerId) || !present(h, playerId)) {
184
+ return;
185
+ }
186
+ const entry = h.players.get(playerId);
187
+ if (!entry?.arrived || entry.ended) {
188
+ return;
189
+ }
190
+ const state = current(h, playerId), spec = state.spec;
191
+ let op;
192
+ try {
193
+ if (data.op === 'button') {
194
+ keys(data, ['k', 'op'], 'button op');
195
+ need(state.button !== null, 'button is not offered');
196
+ op = { op: 'button' };
197
+ } else {
198
+ need(spec, 'catalogue is not open');
199
+ switch (data.op) {
200
+ case 'place':
201
+ case 'move': {
202
+ keys(data, ['k', 'op', data.op === 'place' ? 'item' : 'key', 'x', 'z', 'rot'], 'placement op');
203
+ const grid = h.place.decor.grid;
204
+ need(int(data.x, 0, grid.w - 1) && int(data.z, 0, grid.d - 1) && int(data.rot, 0, 3), 'invalid cells or rotation');
205
+ if (data.op === 'place') {
206
+ const item = spec.items.find((i) => i.id === data.item);
207
+ need(item && !item.locked && item.count > 0, 'item is unavailable');
208
+ op = { op: 'place', item: data.item, x: data.x, z: data.z, rot: data.rot };
209
+ } else {
210
+ need(spec.placed.some((p) => p.key === data.key), 'piece is not in this catalogue');
211
+ op = { op: 'move', key: data.key, x: data.x, z: data.z, rot: data.rot };
212
+ }
213
+ break;
214
+ }
215
+ case 'stash':
216
+ keys(data, ['k', 'op', 'key'], 'stash op');
217
+ need(spec.placed.some((p) => p.key === data.key), 'piece is not in this catalogue');
218
+ op = { op: 'stash', key: data.key };
219
+ break;
220
+ case 'swatch':
221
+ keys(data, ['k', 'op', 'swatch'], 'swatch op');
222
+ need(spec.swatches?.some((s) => s.id === data.swatch), 'swatch is not in this catalogue');
223
+ op = { op: 'swatch', swatch: data.swatch };
224
+ break;
225
+ case 'close':
226
+ keys(data, ['k', 'op'], 'close op');
227
+ op = { op: 'close' };
228
+ break;
229
+ default:
230
+ return;
231
+ }
232
+ }
233
+ } catch {
234
+ return;
235
+ }
236
+ // Six ops/s with a burst of eight. A refused hook still spends a token.
237
+ const now = h.sim.timeMs;
238
+ const budgets = (h.decorBudget ??= new Map());
239
+ const b = budgets.get(playerId) ?? { tokens: 8, at: now };
240
+ b.tokens = Math.min(8, b.tokens + Math.max(0, now - b.at) * 0.006);
241
+ b.at = now;
242
+ budgets.set(playerId, b);
243
+ if (b.tokens < 1) {
244
+ return;
245
+ }
246
+ b.tokens -= 1;
247
+ try {
248
+ Promise.resolve(h.hooks.decor?.(h.ctx, playerId, op)).catch((error) => console.warn(`[hub] decor hook failed: ${error?.message ?? error}`));
249
+ } catch (error) {
250
+ console.warn(`[hub] decor hook failed: ${error?.message ?? error}`);
251
+ }
252
+ }
253
+
254
+ export function joinedAfresh(h, playerId) {
255
+ if (h.place.decor && h.decorMe?.has(playerId)) {
256
+ send(h, playerId, h.decorMe.get(playerId));
257
+ }
258
+ }
259
+ export function forget(h, playerId) {
260
+ h.decorMe?.delete(playerId);
261
+ h.decorBudget?.delete(playerId);
262
+ }
263
+ export function prune(h) {
264
+ for (const playerId of h.decorMe?.keys() ?? []) {
265
+ if (!present(h, playerId)) {
266
+ forget(h, playerId);
267
+ }
268
+ }
269
+ }
@@ -0,0 +1,52 @@
1
+ // Numeric door telemetry. Ghost stamps the subject from the committed trip;
2
+ // the client's door id and the authored server's subject are never trusted.
3
+ export const EVENTS = Object.freeze({ round_start: 28, round_end: 29, door_progress: 30, door_error: 31 });
4
+ export const ERROR_INTERVAL_MS = 10000;
5
+ function emit(h, playerId, name, value, result) {
6
+ if (!h.players.get(playerId)?.arrived) {return false;}
7
+ try {
8
+ const pending = h.session?.hub?.track?.(playerId, { kind: EVENTS[name], value, result });
9
+ pending?.catch?.(() => {});
10
+ return pending !== undefined && pending !== false;
11
+ } catch {return false;}
12
+ }
13
+ export function track(h, playerId, name, props = {}) {
14
+ const entry = h.players.get(playerId);
15
+ if (!entry?.arrived || !EVENTS[name] || !props || typeof props !== 'object' || Array.isArray(props) ||
16
+ Object.keys(props).some(k => !['value', 'result'].includes(k))) {return false;}
17
+ const value = props.value ?? 0, result = props.result ?? 0;
18
+ if (!Number.isSafeInteger(value) || value < 0 || value > 2147483647 || !Number.isSafeInteger(result)) {return false;}
19
+ if (name === 'round_start') {
20
+ if (entry.doorRoundAt !== undefined || value < 1 || value > 256 || result !== 0) {return false;}
21
+ entry.doorRoundAt = h.sim.timeMs;
22
+ } else if (name === 'round_end') {
23
+ if (entry.doorRoundAt === undefined || ![1, 2, 3].includes(result)) {return false;}
24
+ const seconds = Math.min(2147483647, Math.max(0, Math.round((h.sim.timeMs - entry.doorRoundAt) / 1000)));
25
+ delete entry.doorRoundAt;
26
+ return emit(h, playerId, name, seconds, result);
27
+ } else if (name === 'door_progress') {
28
+ if (value < 1 || ![1, 2].includes(result)) {return false;}
29
+ } else {
30
+ if (value < 1 || value > 60 || ![1, 2].includes(result)) {return false;}
31
+ const now = Date.now();
32
+ if (now < (entry.doorErrorAfter ?? 0)) {return false;}
33
+ entry.doorErrorAfter = now + ERROR_INTERVAL_MS;
34
+ }
35
+ return emit(h, playerId, name, value, result);
36
+ }
37
+ export function arrive(h, group) {
38
+ if (!h.place.result || h.place.analyticsRounds === 'authored') {return;}
39
+ // Count actually admitted group members rather than the client's claimed party.
40
+ for (const { playerId } of group) {track(h, playerId, 'round_start', { value: group.length });}
41
+ }
42
+ export function finish(h, playerId, result = 1) {
43
+ return track(h, playerId, 'round_end', { result });
44
+ }
45
+ export function message(h, playerId, data) {
46
+ if (!data || Object.keys(data).some(k => !['k', 'result'].includes(k))) {return false;}
47
+ if (data.k === 'hub-door-quit') {return finish(h, playerId, 2);}
48
+ if (data.k === 'hub-door-error') {
49
+ return track(h, playerId, 'door_error', { value: 1, result: data.result });
50
+ }
51
+ return false;
52
+ }