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,206 @@
1
+ // The Harbour's ambience, round 3: waves with a shape, not a steady sea hiss.
2
+ //
3
+ // const sea = makeHarbour(context, destination, variant = 'A-rolled', seed)
4
+ // sea.frame(t) // once a frame; allocates nothing
5
+ // sea.stop()
6
+ //
7
+ // - waves: two wave channels take turns so one wash overlaps the next swell.
8
+ // A wave is the shared noise through a low-pass that sweeps up as the
9
+ // water swells (amplitude rising with it), breaks (a quick peak, the
10
+ // filter wide open), then washes out (the filter closing, the level
11
+ // falling) with a foam hiss (high-passed) and a softer backwash after it.
12
+ // Periods are irregular: 6-9 s (A, calm) or 4-6.5 s (B, livelier).
13
+ // - a faint, low distant sea under them;
14
+ // - a gull now and then: a reedy band-limited tone through a band-pass,
15
+ // two or three "kee-ow" calls;
16
+ // - a creak now and then: a band-limited pulse train (rope or a wooden hull
17
+ // rubbing) through a resonant band-pass, its rate sliding.
18
+ //
19
+ // All nodes made once: 2x5 waves, 3 sea, 3 gull, 3 creak, 2 wash low-passes, 1 out = 22 nodes.
20
+
21
+ import { seeded, osc, gain, filter, noise, release, startAll, waveOf } from './soundscapeSynthesis.js';
22
+
23
+ // Unit output active RMS for the -41 dBFS bed target. Gull and creak
24
+ // retain their original relative levels.
25
+ // Pure-JS compressed/previous graph RMS ratio at 44.1 kHz, 300 s, seed 0x5ea,
26
+ // active 2048-sample windows within 20 dB of the loudest; absolute level
27
+ // anchored to the previous unit RMS 0.08952332884 (originally calibrated
28
+ // to the audition's offline -36.5 dBFS at volume 0.7 / gain 0.3913).
29
+ export const HARBOUR_WAVE_RMS = 0.07694443970;
30
+ const LOOK = 0.5;
31
+
32
+ // A band-limited pulse train for the creak: 48 equal harmonics.
33
+ function impulseWave(ctx) {
34
+ const n = 48;
35
+ const real = new Float32Array(n + 1);
36
+ const imag = new Float32Array(n + 1);
37
+ for (let i = 1; i <= n; i += 1) {
38
+ real[i] = 1;
39
+ }
40
+ return ctx.createPeriodicWave(real, imag);
41
+ }
42
+
43
+ export function makeHarbour(context, destination, variant = 'A-rolled', seed = 0x5ea, level = 0.5) {
44
+ const ctx = context;
45
+ const next = seeded(seed);
46
+ const rand = (lo, hi) => lo + (hi - lo) * next();
47
+ const lively = variant === 'B';
48
+ const rolled = variant === 'A-rolled';
49
+ const out = gain(ctx, level);
50
+ out.connect(destination);
51
+ const all = [out];
52
+ let wash = out;
53
+ if (rolled) {
54
+ const top1 = filter(ctx, 'lowpass', 3500, 0);
55
+ const top2 = filter(ctx, 'lowpass', 3500, 0);
56
+ top1.connect(top2);
57
+ top2.connect(out);
58
+ all.push(top1, top2);
59
+ wash = top1;
60
+ }
61
+
62
+ const waves = [0, 1].map((i) => {
63
+ const src = noise(ctx, 0.6 * i + 0.17);
64
+ const body = filter(ctx, 'lowpass', 300, 0.6);
65
+ const bodyEnv = gain(ctx, 0.04);
66
+ const foam = filter(ctx, 'highpass', rolled ? 1600 : 2600, 0.6);
67
+ const foamEnv = gain(ctx, 0);
68
+ src.connect(body);
69
+ body.connect(bodyEnv);
70
+ bodyEnv.connect(wash);
71
+ src.connect(foam);
72
+ foam.connect(foamEnv);
73
+ foamEnv.connect(wash);
74
+ all.push(src, body, bodyEnv, foam, foamEnv);
75
+ return { body, bodyEnv, foamEnv };
76
+ });
77
+
78
+ const sea = noise(ctx, 1.4);
79
+ const seaTone = filter(ctx, 'lowpass', 380, 0.5);
80
+ const seaGain = gain(ctx, 0.08);
81
+ sea.connect(seaTone);
82
+ seaTone.connect(seaGain);
83
+ seaGain.connect(out);
84
+ all.push(sea, seaTone, seaGain);
85
+
86
+ const gull = osc(ctx, 'reed', 1300);
87
+ const gullBand = filter(ctx, 'bandpass', 1700, 2.2);
88
+ const gullEnv = gain(ctx, 0);
89
+ gull.connect(gullBand);
90
+ gullBand.connect(gullEnv);
91
+ gullEnv.connect(out);
92
+ all.push(gull, gullBand, gullEnv);
93
+
94
+ const creak = ctx.createOscillator();
95
+ creak.setPeriodicWave(impulseWave(ctx));
96
+ creak.frequency.value = 40;
97
+ const creakBand = filter(ctx, 'bandpass', 720, 7);
98
+ const creakEnv = gain(ctx, 0);
99
+ creak.connect(creakBand);
100
+ creakBand.connect(creakEnv);
101
+ creakEnv.connect(out);
102
+ all.push(creak, creakBand, creakEnv);
103
+
104
+ startAll(all, ctx.currentTime);
105
+
106
+ let stopped = false;
107
+ let started = null;
108
+ let nextWave = 0.2;
109
+ let turn = 0;
110
+ let nextGull = lively ? 2.2 : 3.5;
111
+ let nextCreak = lively ? 5 : 7.5;
112
+
113
+ function wave(at, period, size) {
114
+ const w = waves[turn++ % 2];
115
+ // Keep the size draw's brightness/shape; compress only its amplitude.
116
+ const amp = 0.6 + (size - 0.6) * 0.25;
117
+ const bodyAt = (value, t, tc) => w.bodyEnv.gain.setTargetAtTime(value, t, tc);
118
+ const foamAt = (value, t, tc) => w.foamEnv.gain.setTargetAtTime(value, t, tc);
119
+ const rise = period * rand(0.38, 0.5);
120
+ const brk = at + rise;
121
+ const open = (lively ? 1600 : 1100) + 1400 * size;
122
+ // Swell: the water lifts, the sound brightens and grows.
123
+ w.body.frequency.setTargetAtTime(260, at, 0.1);
124
+ w.body.frequency.setTargetAtTime(open * 0.55, at + 0.2, rise * 0.45);
125
+ bodyAt(0.45 * amp, at, rise * 0.45);
126
+ // Break: a quick peak, wide open.
127
+ w.body.frequency.setTargetAtTime(open, brk - 0.1, 0.08);
128
+ bodyAt(amp, brk - 0.1, 0.07);
129
+ foamAt((lively ? 0.38 : 0.26) * amp, brk, 0.12);
130
+ // Wash: closing, falling; the foam fizzes out; a softer backwash.
131
+ w.body.frequency.setTargetAtTime(420, brk + 0.35, period * 0.16);
132
+ bodyAt(0.03, brk + 0.3, period * 0.14);
133
+ foamAt(0.04 * amp, brk + 0.45, period * 0.07);
134
+ foamAt((lively ? 0.16 : 0.1) * amp, brk + period * 0.28, 0.35);
135
+ foamAt(0, brk + period * 0.28 + 0.6, period * 0.09);
136
+ }
137
+
138
+ function gullCall(at) {
139
+ const calls = 2 + Math.floor(next() * 2);
140
+ const base = rand(1150, 1450);
141
+ for (let i = 0; i < calls; i += 1) {
142
+ const a = at + i * rand(0.38, 0.5);
143
+ gull.frequency.setValueAtTime(base, a);
144
+ gull.frequency.exponentialRampToValueAtTime(base * 1.3, a + 0.06);
145
+ gull.frequency.exponentialRampToValueAtTime(base * 0.68, a + 0.34);
146
+ gullEnv.gain.setValueAtTime(0, a);
147
+ gullEnv.gain.linearRampToValueAtTime(0.11, a + 0.03);
148
+ gullEnv.gain.setTargetAtTime(0.07, a + 0.06, 0.08);
149
+ gullEnv.gain.setTargetAtTime(0, a + 0.26, 0.03);
150
+ }
151
+ }
152
+
153
+ function creakAt(at) {
154
+ const length = rand(0.7, 1.3);
155
+ const from = rand(28, 40);
156
+ creak.frequency.setValueAtTime(from, at);
157
+ creak.frequency.linearRampToValueAtTime(from * rand(2, 2.8), at + length * 0.55);
158
+ creak.frequency.linearRampToValueAtTime(from * 1.3, at + length);
159
+ creakBand.frequency.setValueAtTime(rand(550, 900), at);
160
+ creakEnv.gain.setValueAtTime(0, at);
161
+ creakEnv.gain.linearRampToValueAtTime(0.5, at + length * 0.3);
162
+ creakEnv.gain.linearRampToValueAtTime(0.35, at + length * 0.7);
163
+ creakEnv.gain.linearRampToValueAtTime(0, at + length);
164
+ }
165
+
166
+ return {
167
+ nodes: all.length,
168
+ frame(t) {
169
+ if (stopped || !Number.isFinite(t)) { return; }
170
+ t = Math.max(t, ctx.currentTime);
171
+ if (started === null) {
172
+ started = t;
173
+ }
174
+ const rel = t - started;
175
+ // Drop missed calls after a stall; each stream gets a fresh interval.
176
+ if (nextWave < rel - LOOK) {
177
+ nextWave = rel + (lively ? rand(4, 6.5) : rand(6, 9)) * rand(0.78, 0.92);
178
+ }
179
+ if (nextGull < rel - LOOK) {
180
+ nextGull = rel + (lively ? rand(4, 9) : rand(7, 14));
181
+ }
182
+ if (nextCreak < rel - LOOK) {
183
+ nextCreak = rel + (lively ? rand(4, 8) : rand(6, 12));
184
+ }
185
+ if (rel + LOOK >= nextWave) {
186
+ const period = lively ? rand(4, 6.5) : rand(6, 9);
187
+ wave(Math.max(t, started + nextWave), period, rand(0.6, 1));
188
+ nextWave += period * rand(0.78, 0.92);
189
+ }
190
+ if (rel + LOOK >= nextGull) {
191
+ gullCall(Math.max(t, started + nextGull));
192
+ nextGull += lively ? rand(4, 9) : rand(7, 14);
193
+ }
194
+ if (rel + LOOK >= nextCreak) {
195
+ creakAt(Math.max(t, started + nextCreak));
196
+ nextCreak += lively ? rand(4, 8) : rand(6, 12);
197
+ }
198
+ },
199
+ stop() {
200
+ stopped = true;
201
+ release(all);
202
+ },
203
+ };
204
+ }
205
+
206
+ export { waveOf };
@@ -0,0 +1,101 @@
1
+ // Turning displays (contract v1.55, `code/shared/spin.js` has the rule): the
2
+ // scene actors carrying `HubSpin` turned about their vertical axis, on this
3
+ // client alone, by rate x dt each frame. Pure over a scene runtime's
4
+ // `getActor` / `touch`, so scripts/test-spin.mjs drives it headless.
5
+ //
6
+ // The hub system finds the turners once per scene load (`findSpinners`, over
7
+ // the loaded scene data) and once per copy the place spawns (`addSpinner`);
8
+ // a scene with none keeps `null` and its frame calls nothing of this. The
9
+ // turn is written to the actor's Transform, the way the hub swings a door:
10
+ // the engine draws the node (and everything under it, a hat's model) from it,
11
+ // and the actor's collider, which `spinProblem` requires to be a sensor on no
12
+ // moving body, turns with it on this client only.
13
+
14
+ import { spinRate } from '../shared/spin.js';
15
+
16
+ // This system runs outside behavior updates, so it owns a separate clock.
17
+ const clocks = new WeakMap();
18
+ function spinDt(actor, dt) {
19
+ const every = actor.runtime?.updateEvery;
20
+ if (!(Number.isFinite(every) && every > 0)) {
21
+ const elapsed = clocks.get(actor)?.elapsed ?? 0;
22
+ clocks.delete(actor);
23
+ return dt + elapsed;
24
+ }
25
+ const clock = clocks.get(actor);
26
+ if (!clock || clock.every !== every) {
27
+ clocks.set(actor, { every, elapsed: 0 });
28
+ return dt + (clock?.elapsed ?? 0);
29
+ }
30
+ clock.elapsed += dt;
31
+ if (clock.elapsed + 1e-9 < every) {return null;}
32
+ const elapsed = clock.elapsed;
33
+ clock.elapsed = 0;
34
+ return elapsed;
35
+ }
36
+
37
+ // The turners of a scene's actors (`scene.data.actors`, blueprints already
38
+ // merged by the engine), or null when none turns.
39
+ export function findSpinners(actors) {
40
+ let spin = null;
41
+ for (const actor of actors ?? []) {
42
+ const rate = spinRate(actor?.components);
43
+ if (rate && typeof actor.id === 'string') {
44
+ spin ??= { ids: [], rates: [] };
45
+ spin.ids.push(actor.id);
46
+ spin.rates.push(rate);
47
+ }
48
+ }
49
+ return spin;
50
+ }
51
+
52
+ // A copy the place spawned (`hub.spawn`) from a template carrying `HubSpin`
53
+ // turns too. Returns the turners (made when this is the first).
54
+ export function addSpinner(spin, id, components) {
55
+ const rate = spinRate(components);
56
+ if (!rate) {
57
+ return spin;
58
+ }
59
+ spin ??= { ids: [], rates: [] };
60
+ if (!spin.ids.includes(id)) {
61
+ spin.ids.push(id);
62
+ spin.rates.push(rate);
63
+ }
64
+ return spin;
65
+ }
66
+
67
+ // One frame: each turner's rotationY moved on by rate x dt, kept within one
68
+ // turn. An actor the place hid waits unturned (it is far below the ground);
69
+ // one that is gone (a despawned copy) is dropped from the list. Allocates
70
+ // nothing.
71
+ export function spinFrame(spin, scene, dt, hidden) {
72
+ if (!spin || !(dt > 0) || !Number.isFinite(dt)) {
73
+ return;
74
+ }
75
+ const { ids, rates } = spin;
76
+ let i = 0;
77
+ while (i < ids.length) {
78
+ const id = ids[i];
79
+ const actor = scene.getActor(id);
80
+ const t = actor?.components.Transform;
81
+ if (!t) {
82
+ // Swap the last one in: order means nothing here.
83
+ const last = ids.length - 1;
84
+ ids[i] = ids[last];
85
+ rates[i] = rates[last];
86
+ ids.pop();
87
+ rates.pop();
88
+ continue;
89
+ }
90
+ if (!hidden?.has(id)) {
91
+ // A scene may hold its scenery still (physics-3d `staticActors`): the
92
+ // engine is told before the write, as for every hub write.
93
+ const elapsed = spinDt(actor, dt);
94
+ if (elapsed !== null) {
95
+ scene.touch?.(actor);
96
+ t.rotationY = ((t.rotationY ?? 0) + rates[i] * elapsed) % 360;
97
+ }
98
+ }
99
+ i += 1;
100
+ }
101
+ }
@@ -2,17 +2,41 @@
2
2
  // (`hookLayer.js`) from the place's server and read by the hub system
3
3
  // (`code/systems/hub.js`). One module instance per page; `clear` runs on every
4
4
  // session switch.
5
+ import { clearShot } from './shot.js';
6
+
7
+ // The deck's own castle.json arrival for a place id, set by the hook layer;
8
+ // read only by the optional spawn ring (`engine.hubSpawnRing`), never sent.
9
+ export const localArrival = { for: () => undefined };
5
10
 
6
11
  // What the deck's own castle.json asks of the hub client, read once by the
7
12
  // hook layer (`hookLayer.js`) as the page loads. Not cleared on a session
8
13
  // switch: it is the page's deck, whichever place is playing.
9
14
  export const deck = {
15
+ // Root-only `hub.defaultEnvironment`: false disables the fallback picture
16
+ // and its fall fade for every scene this page visits, including packs.
17
+ defaultEnvironment: true,
10
18
  // `hub.tiers`: a cheaper picture on a slow device (`tiers.js`).
11
19
  tiers: false,
12
20
  // `hub.cues` (v1.23): a town says more about the friends and party a player
13
21
  // came with -- a friend already here, who reads chat, the door a friend
14
22
  // went to, who joined the party. Every such branch asks this first.
15
23
  cues: false,
24
+ // v1.122: friend/party play cards anywhere; strangers nearby and bounded.
25
+ playCards: false,
26
+ // `hub.stuck` (v1.33): a town offers a player who walks and gets nowhere
27
+ // the way back to its arrival (`stuck.js`). Every such branch asks this first.
28
+ stuck: false,
29
+ yourGames: false,
30
+ // `hub.labels: "near"` (v1.43): a town's labels near the player only, never
31
+ // overlapping, three at most (`labelsNear.js`). The one branch asks this first.
32
+ labels: false,
33
+ // `hub.soundscape`: the sounds the kit makes itself -- NPC babble and
34
+ // footsteps -- and the sound control (`soundscape.js`): `{ babble, steps }`,
35
+ // or null in a deck without the key. Every such branch asks this first.
36
+ soundscape: null,
37
+ // The deck's build.json, when its assembly wrote one (`build.js`):
38
+ // `{ sha, savedAt }` for QA to read off the page, or null.
39
+ build: null,
16
40
  };
17
41
 
18
42
  export const hub = {
@@ -24,6 +48,18 @@ export const hub = {
24
48
  avatars: new Map(),
25
49
  avatarsAll: new Map(),
26
50
  avatarsMe: new Map(),
51
+ // v1.51, the same two for a player who wears an avatar past the first four
52
+ // (`hubAv2`): the one really worn, where `hubAv` carries a stand-in.
53
+ avatars2All: new Map(),
54
+ avatars2Me: new Map(),
55
+ avatarColors: new Map(),
56
+ avatarColorsAll: new Map(),
57
+ avatarColorsMe: new Map(),
58
+ avatarColorStandIns: new Set(),
59
+ // Players this client draws as their stand-in (`avatar % 4`) rather than
60
+ // the later avatar they wear, to keep how many different characters it
61
+ // draws at once down (`avatarCap.js`). This client's alone.
62
+ avatarStandIns: new Set(),
27
63
  // playerId -> { kind, color, rarity }: what each player wears on their
28
64
  // avatar (`hubWear`, v1.4), with this player's own (`hub-wear`) over it, as
29
65
  // the avatars are
@@ -35,19 +71,42 @@ export const hub = {
35
71
  // own (`hub-try`) over it; both empty in a place that never tries one on
36
72
  tryAll: new Map(),
37
73
  tryMe: new Map(),
74
+ // playerId -> { class, shape, color, name }: the earned item each player
75
+ // shows (`hubEarned`, v1.53), with this player's own (`hub-earned`) over it,
76
+ // as the wearables are; all empty in a place where nobody shows one
77
+ earned: new Map(),
78
+ earnedAll: new Map(),
79
+ earnedMe: new Map(),
38
80
  // the declared HUD, this player's override of it, and the page time each
39
81
  // arrived (a timer is read against the simulation clock below)
40
82
  hud: null,
41
83
  hudMe: null,
84
+ // v1.52: this player's line for leaving the current place, or null.
85
+ leaving: null,
86
+ friendsWanted: false,
42
87
  // the newest simulation time seen and the page time it arrived
43
88
  lastT: 0,
44
89
  lastTAt: 0,
45
- // scene actor ids the place hid
90
+ // v1.62: shared hidden actors and this viewer's whole private override.
91
+ hiddenAll: new Set(),
92
+ hiddenMe: new Set(),
93
+ shownMe: new Set(),
94
+ // Merged visibility, read unchanged by drawing, pads, idle and soundscape.
46
95
  hidden: new Set(),
47
96
  // scene actor id -> '#rrggbb' the place painted it
48
97
  tints: {},
49
98
  // The town's doors a player may jump to (contract §5): [{ id, title }].
50
99
  doors: [],
100
+ yours: null,
101
+ // `{ to }` where the place puts a player back at its arrival for the asking
102
+ // (`hubStuck`, v1.33; `to` its name for the spot, or null), else null. Never
103
+ // set in a deck without `hub.stuck`.
104
+ stuck: null,
105
+ // v1.39, a place with the `unstick` hook: what it last said a tap would do
106
+ // for this player (`hub-unstick-to`: `{ spot, to }`), and where it put them
107
+ // when they tapped (`hub-jumped`'s `stuck`), until the hub system has read it
108
+ stuckTo: null,
109
+ unstuck: null,
51
110
  // playerId -> { x, z, where, door, on }: where the players this client
52
111
  // asked about are (`hub-where`), and the page time the answer arrived
53
112
  whereAt: {},
@@ -60,6 +119,11 @@ export const hub = {
60
119
  // door, the invitation waiting on this player ({ from, username }) and the
61
120
  // door their party proposed ({ door, by, username, asked })
62
121
  party: { members: null, away: 0, invite: null, proposal: null },
122
+ // Client-local invitation occurrence. `inviteSeq` survives clear so an old
123
+ // lease can never collide with a later invitation in this page runtime.
124
+ // The current occurrence is advanced at each observable receipt boundary.
125
+ inviteSeq: 0,
126
+ inviteOccurrence: null,
63
127
  // what players said since the hub system last looked (`hub-said`, v1.11):
64
128
  // { player, r } (a reaction) or { player, p, door } (a phrase)
65
129
  saidEvents: [],
@@ -83,6 +147,10 @@ export const hub = {
83
147
  // the facing the place gave this player on arrival, or null until it has,
84
148
  // and whether the camera has been turned to it
85
149
  arrivedFacing: null,
150
+ // The post-arrival server placement for this client has reached the
151
+ // multiplayer layer. A returned Your games card waits for this so its
152
+ // first-display position is the town position, not the scene spawn.
153
+ arrivalPlaced: false,
86
154
  faced: false,
87
155
  // a command for the hub system: { kind: 'go' | 'end' | 'result', ... }
88
156
  commands: [],
@@ -98,9 +166,17 @@ export const hub = {
98
166
  // actorId -> { file, volume, radius, since } (a loop playing there), and the
99
167
  // one-shot sounds not yet played
100
168
  emotes: {},
169
+ // v1.47: actor id -> an NPC's emote, empty until a body reacts.
170
+ npcEmotes: {},
101
171
  seated: {},
102
172
  sounds: {},
173
+ danceIdle: null,
103
174
  soundEvents: [],
175
+ // v1.50, allocated only for soundscape.cues; private or actor one-shots.
176
+ cueEvents: null,
177
+ // v1.42, a deck with `hub.soundscape` only: whether a one-shot arriving now
178
+ // may be queued (sound.js `filterEvents`); null in every other deck.
179
+ soundGate: null,
104
180
  // Arcade cabinets (v1.7, `cabinets.js`): door actor id -> { door, card, rev },
105
181
  // the cards this player has been sent, and a count of card changes
106
182
  cabinets: {},
@@ -109,23 +185,62 @@ export const hub = {
109
185
 
110
186
  export function clear() {
111
187
  hub.place = null;
188
+ delete hub.prompts;
189
+ hub.menuClose?.();
190
+ delete hub.menuClose;
191
+ delete hub.menu;
192
+ hub.askClose?.();
193
+ delete hub.askClose;
194
+ delete hub.decor;
195
+ if (Object.hasOwn(hub, 'ask')) {
196
+ delete hub.ask;
197
+ }
198
+ if (Object.hasOwn(hub, 'actions')) {
199
+ delete hub.actions;
200
+ }
201
+ delete hub.companion;
202
+ delete hub.glow;
203
+ clearShot();
112
204
  hub.avatars.clear();
113
205
  hub.avatarsAll.clear();
114
206
  hub.avatarsMe.clear();
207
+ hub.avatars2All.clear();
208
+ hub.avatars2Me.clear();
209
+ hub.avatarColors.clear();
210
+ hub.avatarColorsAll.clear();
211
+ hub.avatarColorsMe.clear();
212
+ hub.avatarColorStandIns.clear();
213
+ hub.avatarStandIns.clear();
115
214
  hub.wearing.clear();
116
215
  hub.wearAll.clear();
117
216
  hub.wearMe.clear();
118
217
  hub.tryAll.clear();
119
218
  hub.tryMe.clear();
219
+ hub.earned.clear();
220
+ hub.earnedAll.clear();
221
+ hub.earnedMe.clear();
120
222
  hub.hud = null;
223
+ delete hub.guests;
224
+ delete hub.guestsAll;
225
+ delete hub.guestsMe;
121
226
  hub.hudMe = null;
227
+ hub.leaving = null;
228
+ hub.friendsWanted = false;
122
229
  hub.hidden.clear();
230
+ hub.hiddenAll.clear();
231
+ hub.hiddenMe.clear();
232
+ hub.shownMe.clear();
123
233
  hub.tints = {};
124
234
  hub.doors = [];
235
+ hub.yours = null;
236
+ hub.stuck = null;
237
+ hub.stuckTo = null;
238
+ hub.unstuck = null;
125
239
  hub.whereAt = {};
126
240
  hub.whereAtAt = 0;
127
241
  hub.jumpedTo = null;
128
242
  hub.party = { members: null, away: 0, invite: null, proposal: null };
243
+ hub.inviteOccurrence = null;
129
244
  hub.marks = {};
130
245
  hub.spawned = {};
131
246
  hub.spawnTemplates = {};
@@ -139,11 +254,17 @@ export function clear() {
139
254
  hub.grabEvents.length = 0;
140
255
  hub.keptFor = new Map();
141
256
  hub.emotes = {};
257
+ hub.npcEmotes = {};
142
258
  hub.seated = {};
143
259
  hub.sounds = {};
260
+ hub.danceIdle = null;
144
261
  hub.soundEvents.length = 0;
262
+ if (hub.cueEvents) {
263
+ hub.cueEvents.length = 0;
264
+ }
145
265
  hub.cabinets = {};
146
266
  hub.arrivedFacing = null;
267
+ hub.arrivalPlaced = false;
147
268
  hub.faced = false;
148
269
  hub.commands.length = 0;
149
270
  }
@@ -155,6 +276,46 @@ export function wearingNow() {
155
276
  return new Map([...hub.wearAll, ...hub.wearMe, ...hub.tryAll, ...hub.tryMe]);
156
277
  }
157
278
 
279
+ export function mergeHidden() {
280
+ hub.hidden = new Set([...hub.hiddenAll].filter((id) => !hub.shownMe.has(id)));
281
+ for (const id of hub.hiddenMe) {
282
+ hub.hidden.add(id);
283
+ }
284
+ }
285
+
286
+ export function receiveParty(msg) {
287
+ const invite = msg.invite ?? null;
288
+ if (!invite) {
289
+ hub.inviteOccurrence = null;
290
+ } else if (hub.inviteOccurrence?.from !== invite.from) {
291
+ hub.inviteOccurrence = { from: invite.from, n: ++hub.inviteSeq };
292
+ }
293
+ hub.party = {
294
+ members: Array.isArray(msg.members) ? msg.members : null,
295
+ away: Number(msg.away) || 0,
296
+ invite,
297
+ proposal: msg.proposal ?? null,
298
+ };
299
+ }
300
+
301
+ // Tests and older composed clients can provide party state directly. Normal
302
+ // runtime state already has an occurrence from `receiveParty`.
303
+ export function invitationOccurrence(invite) {
304
+ if (!invite) {
305
+ return null;
306
+ }
307
+ if (hub.inviteOccurrence?.from !== invite.from) {
308
+ hub.inviteOccurrence = { from: invite.from, n: ++hub.inviteSeq };
309
+ }
310
+ return hub.inviteOccurrence;
311
+ }
312
+
313
+ // What earned item each player shows (v1.53): everyone's, with this
314
+ // player's own over it.
315
+ export function earnedNow() {
316
+ return new Map([...hub.earnedAll, ...hub.earnedMe]);
317
+ }
318
+
158
319
  export function avatarOf(playerId) {
159
320
  return hub.avatars.has(playerId) ? hub.avatars.get(playerId) : null;
160
321
  }