castle-web-cli 0.4.232 → 0.4.233

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 (355) 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/castle-host/host.d.ts +1 -0
  8. package/dist/castle-host/host.js +51 -3
  9. package/dist/castleJson.d.ts +4 -2
  10. package/dist/castleJson.js +2 -0
  11. package/dist/check.d.ts +3 -1
  12. package/dist/check.js +11 -1
  13. package/dist/devSessionStorage.js +47 -1
  14. package/dist/importPinMismatch.d.ts +22 -0
  15. package/dist/importPinMismatch.js +77 -0
  16. package/dist/importRegression.js +3 -15
  17. package/dist/imports.d.ts +10 -3
  18. package/dist/imports.js +88 -20
  19. package/dist/index.js +5 -4
  20. package/dist/init.js +1 -1
  21. package/dist/platformDoc.js +22 -0
  22. package/dist/routerFences.d.ts +5 -0
  23. package/dist/routerFences.js +12 -2
  24. package/dist/save-deck.d.ts +5 -0
  25. package/dist/save-deck.js +37 -4
  26. package/dist/serve.js +3 -0
  27. package/dist/shell/assets/{index-D2tWM896.js → index-BjOxR-lW.js} +4 -4
  28. package/dist/shell/assets/index-MVLfNYd9.css +1 -0
  29. package/dist/shell/index.html +2 -2
  30. package/dist/taskSteer.d.ts +13 -0
  31. package/dist/taskSteer.js +22 -2
  32. package/kits/base/castle.json +1 -1
  33. package/kits/base/package-lock.json +1 -1
  34. package/kits/base/sdk/README.md +79 -2
  35. package/kits/base/sdk/avatar.d.ts +6 -2
  36. package/kits/base/sdk/avatar.js +12 -4
  37. package/kits/base/sdk/castle.d.ts +1 -1
  38. package/kits/base/sdk/commands.d.ts +14 -0
  39. package/kits/base/sdk/hub.d.ts +6 -2
  40. package/kits/base/sdk/hub.js +13 -0
  41. package/kits/base/sdk/multiplayer.js +17 -1
  42. package/kits/base/sdk/save.js +2 -1
  43. package/kits/base/sdk/server/hub.d.ts +87 -0
  44. package/kits/base/sdk/server/hub.js +70 -0
  45. package/kits/base/sdk/server/platformHandle.d.ts +31 -1
  46. package/kits/base/sdk/server/storage.d.ts +13 -0
  47. package/kits/base/sdk/server/storage.js +46 -0
  48. package/kits/base/sdk/server/wrapper.d.ts +36 -5
  49. package/kits/base/sdk/server/wrapper.js +83 -8
  50. package/kits/hub-game/CLAUDE.md +329 -11
  51. package/kits/hub-game/blueprints/avatar-10.scene +28 -0
  52. package/kits/hub-game/blueprints/avatar-11.scene +28 -0
  53. package/kits/hub-game/blueprints/avatar-12.scene +28 -0
  54. package/kits/hub-game/blueprints/avatar-13.scene +28 -0
  55. package/kits/hub-game/blueprints/avatar-14.scene +28 -0
  56. package/kits/hub-game/blueprints/avatar-15.scene +28 -0
  57. package/kits/hub-game/blueprints/avatar-4.scene +28 -0
  58. package/kits/hub-game/blueprints/avatar-5.scene +28 -0
  59. package/kits/hub-game/blueprints/avatar-6.scene +28 -0
  60. package/kits/hub-game/blueprints/avatar-7.scene +28 -0
  61. package/kits/hub-game/blueprints/avatar-8.scene +28 -0
  62. package/kits/hub-game/blueprints/avatar-9.scene +28 -0
  63. package/kits/hub-game/code/client/actorBudget.js +47 -0
  64. package/kits/hub-game/code/client/attention.js +11 -2
  65. package/kits/hub-game/code/client/avatar.js +309 -35
  66. package/kits/hub-game/code/client/avatarCap.js +228 -0
  67. package/kits/hub-game/code/client/avatarColors.js +70 -0
  68. package/kits/hub-game/code/client/avatarFaces.js +21 -0
  69. package/kits/hub-game/code/client/avatarShare.js +251 -0
  70. package/kits/hub-game/code/client/ballot.js +467 -0
  71. package/kits/hub-game/code/client/build.js +22 -0
  72. package/kits/hub-game/code/client/chrome.js +1144 -50
  73. package/kits/hub-game/code/client/companion.js +716 -0
  74. package/kits/hub-game/code/client/companionDress.js +99 -0
  75. package/kits/hub-game/code/client/decor.js +509 -0
  76. package/kits/hub-game/code/client/earned.js +131 -0
  77. package/kits/hub-game/code/client/emoteBubble.js +75 -0
  78. package/kits/hub-game/code/client/grab.js +339 -20
  79. package/kits/hub-game/code/client/hookLayer.js +299 -13
  80. package/kits/hub-game/code/client/idle.js +163 -22
  81. package/kits/hub-game/code/client/interestCap.js +81 -0
  82. package/kits/hub-game/code/client/keys.js +36 -0
  83. package/kits/hub-game/code/client/labelsNear.js +205 -0
  84. package/kits/hub-game/code/client/menuIcons.js +34 -0
  85. package/kits/hub-game/code/client/pack.js +6 -2
  86. package/kits/hub-game/code/client/packFormat.js +3 -3
  87. package/kits/hub-game/code/client/rehello.js +167 -0
  88. package/kits/hub-game/code/client/shot.js +92 -0
  89. package/kits/hub-game/code/client/sound.js +63 -8
  90. package/kits/hub-game/code/client/soundscape.js +1151 -0
  91. package/kits/hub-game/code/client/soundscapeActions.js +99 -0
  92. package/kits/hub-game/code/client/soundscapeAmbience.js +453 -0
  93. package/kits/hub-game/code/client/soundscapeBaked.js +143 -0
  94. package/kits/hub-game/code/client/soundscapeBusker.js +217 -0
  95. package/kits/hub-game/code/client/soundscapeCourt.js +200 -0
  96. package/kits/hub-game/code/client/soundscapeCrowd.js +331 -0
  97. package/kits/hub-game/code/client/soundscapeCues.js +362 -0
  98. package/kits/hub-game/code/client/soundscapeMap.js +181 -0
  99. package/kits/hub-game/code/client/soundscapeMarket.js +176 -0
  100. package/kits/hub-game/code/client/soundscapeMusic.js +126 -0
  101. package/kits/hub-game/code/client/soundscapeMusicEngine.js +460 -0
  102. package/kits/hub-game/code/client/soundscapeSimlish.js +737 -0
  103. package/kits/hub-game/code/client/soundscapeSongs.js +127 -0
  104. package/kits/hub-game/code/client/soundscapeSongsRound3.js +63 -0
  105. package/kits/hub-game/code/client/soundscapeSynthesis.js +168 -0
  106. package/kits/hub-game/code/client/soundscapeUi.js +211 -0
  107. package/kits/hub-game/code/client/soundscapeVoice.js +1209 -0
  108. package/kits/hub-game/code/client/soundscapeWaves.js +206 -0
  109. package/kits/hub-game/code/client/spin.js +101 -0
  110. package/kits/hub-game/code/client/state.js +109 -1
  111. package/kits/hub-game/code/client/stuck.js +259 -0
  112. package/kits/hub-game/code/client/talk.js +538 -47
  113. package/kits/hub-game/code/client/tiers.js +516 -27
  114. package/kits/hub-game/code/client/toastBand.js +37 -0
  115. package/kits/hub-game/code/client/together.js +32 -0
  116. package/kits/hub-game/code/client/visibility.js +43 -0
  117. package/kits/hub-game/code/client/wear.js +461 -170
  118. package/kits/hub-game/code/client/yours.js +199 -0
  119. package/kits/hub-game/code/companionSpec.js +45 -0
  120. package/kits/hub-game/code/privateText.js +7 -0
  121. package/kits/hub-game/code/server/actions.js +133 -0
  122. package/kits/hub-game/code/server/actors.js +9 -1
  123. package/kits/hub-game/code/server/ask.js +155 -0
  124. package/kits/hub-game/code/server/ballot.js +539 -0
  125. package/kits/hub-game/code/server/cells.js +100 -0
  126. package/kits/hub-game/code/server/companion.js +82 -0
  127. package/kits/hub-game/code/server/cues.js +70 -0
  128. package/kits/hub-game/code/server/decor.js +269 -0
  129. package/kits/hub-game/code/server/earned.js +461 -0
  130. package/kits/hub-game/code/server/friendBests.js +166 -0
  131. package/kits/hub-game/code/server/friendsAmong.js +232 -0
  132. package/kits/hub-game/code/server/history.js +5 -0
  133. package/kits/hub-game/code/server/hub.js +1254 -50
  134. package/kits/hub-game/code/server/idle.js +30 -11
  135. package/kits/hub-game/code/server/index.js +2 -2
  136. package/kits/hub-game/code/server/labels.js +28 -2
  137. package/kits/hub-game/code/server/manifest.js +378 -7
  138. package/kits/hub-game/code/server/menu.js +133 -0
  139. package/kits/hub-game/code/server/npcs.js +830 -80
  140. package/kits/hub-game/code/server/party.js +2 -2
  141. package/kits/hub-game/code/server/players.js +22 -0
  142. package/kits/hub-game/code/server/shot.js +110 -0
  143. package/kits/hub-game/code/server/standing.js +124 -0
  144. package/kits/hub-game/code/server/vis.js +113 -0
  145. package/kits/hub-game/code/server/wear.js +12 -0
  146. package/kits/hub-game/code/server/yours.js +59 -0
  147. package/kits/hub-game/code/shared/cues.js +9 -0
  148. package/kits/hub-game/code/shared/decor.js +41 -0
  149. package/kits/hub-game/code/shared/shot.js +19 -0
  150. package/kits/hub-game/code/shared/spin.js +57 -0
  151. package/kits/hub-game/code/systems/hub.js +845 -95
  152. package/kits/hub-game/docs/content-pack.md +1 -1
  153. package/kits/hub-game/docs/contract.md +2244 -61
  154. package/kits/hub-game/docs/home-pieces.md +64 -0
  155. package/kits/hub-game/models/avatar-10.pxmodel +28 -0
  156. package/kits/hub-game/models/avatar-11.pxmodel +28 -0
  157. package/kits/hub-game/models/avatar-12.pxmodel +27 -0
  158. package/kits/hub-game/models/avatar-13.pxmodel +24 -0
  159. package/kits/hub-game/models/avatar-14.pxmodel +29 -0
  160. package/kits/hub-game/models/avatar-15.pxmodel +24 -0
  161. package/kits/hub-game/models/avatar-4.pxmodel +29 -0
  162. package/kits/hub-game/models/avatar-5.pxmodel +27 -0
  163. package/kits/hub-game/models/avatar-6.pxmodel +26 -0
  164. package/kits/hub-game/models/avatar-7.pxmodel +25 -0
  165. package/kits/hub-game/models/avatar-8.pxmodel +24 -0
  166. package/kits/hub-game/models/avatar-9.pxmodel +30 -0
  167. package/kits/hub-game/models/earned/badge-round.pxmodel +100 -0
  168. package/kits/hub-game/models/earned/badge-shield.pxmodel +117 -0
  169. package/kits/hub-game/models/earned/badge-star.pxmodel +87 -0
  170. package/kits/hub-game/models/earned/belt-plain.pxmodel +72 -0
  171. package/kits/hub-game/models/earned/held-ball.pxmodel +43 -0
  172. package/kits/hub-game/models/earned/held-lantern.pxmodel +85 -0
  173. package/kits/hub-game/models/earned/held-net.pxmodel +57 -0
  174. package/kits/hub-game/models/earned/held-trophy.pxmodel +109 -0
  175. package/kits/hub-game/models/earned/pin-round.pxmodel +62 -0
  176. package/kits/hub-game/models/earned/sash-plain.pxmodel +66 -0
  177. package/kits/hub-game/models/earned/square/belt-plain.pxmodel +104 -0
  178. package/kits/hub-game/models/earned/square/sash-plain.pxmodel +98 -0
  179. package/kits/hub-game/models/hats/bat-clip.pxmodel +206 -0
  180. package/kits/hub-game/models/hats/beekeeper.pxmodel +149 -0
  181. package/kits/hub-game/models/hats/cap.pxmodel +162 -0
  182. package/kits/hub-game/models/hats/captain.pxmodel +178 -0
  183. package/kits/hub-game/models/hats/crooked-top.pxmodel +172 -0
  184. package/kits/hub-game/models/hats/flower-crown.pxmodel +451 -0
  185. package/kits/hub-game/models/hats/foam-crown.pxmodel +179 -0
  186. package/kits/hub-game/models/hats/lantern.pxmodel +230 -0
  187. package/kits/hub-game/models/hats/laurel.pxmodel +533 -0
  188. package/kits/hub-game/models/hats/lighthouse.pxmodel +96 -0
  189. package/kits/hub-game/models/hats/sailor.pxmodel +141 -0
  190. package/kits/hub-game/models/hats/souwester.pxmodel +131 -0
  191. package/kits/hub-game/models/hats/straw.pxmodel +139 -0
  192. package/kits/hub-game/models/hats/sunflower.pxmodel +406 -0
  193. package/kits/hub-game/models/hats/sweatband.pxmodel +112 -0
  194. package/kits/hub-game/models/hats/witch.pxmodel +147 -0
  195. package/kits/hub-game/package-lock.json +2 -0
  196. package/kits/hub-game/package.json +2 -1
  197. package/kits/hub-game/scripts/check.mjs +78 -11
  198. package/kits/hub-game/scripts/companion-follower-wire.json +1 -0
  199. package/kits/hub-game/scripts/fixtures/decor-keyless-draw.json +121 -0
  200. package/kits/hub-game/scripts/fixtures/decor-keyless.json +293 -0
  201. package/kits/hub-game/scripts/fixtures/engine-models-stub.mjs +23 -0
  202. package/kits/hub-game/scripts/fixtures/fake-dom.mjs +107 -0
  203. package/kits/hub-game/scripts/fixtures/interest-legacy.json +385 -0
  204. package/kits/hub-game/scripts/fixtures/npc-notes-v1.77.jsonl +4 -0
  205. package/kits/hub-game/scripts/fixtures/vis-shared-wire.json +1 -0
  206. package/kits/hub-game/scripts/gen-avatars.mjs +933 -16
  207. package/kits/hub-game/scripts/gen-earned.mjs +285 -0
  208. package/kits/hub-game/scripts/gen-hats.mjs +827 -0
  209. package/kits/hub-game/scripts/grab.before-orbit.mjs +400 -0
  210. package/kits/hub-game/scripts/soundscape-wave-analysis.mjs +125 -0
  211. package/kits/hub-game/scripts/test-actions-client.mjs +488 -0
  212. package/kits/hub-game/scripts/test-actions.mjs +298 -0
  213. package/kits/hub-game/scripts/test-actor-budget.mjs +44 -0
  214. package/kits/hub-game/scripts/test-actors.mjs +19 -17
  215. package/kits/hub-game/scripts/test-ask-client.mjs +358 -0
  216. package/kits/hub-game/scripts/test-ask.mjs +269 -0
  217. package/kits/hub-game/scripts/test-attention.mjs +10 -1
  218. package/kits/hub-game/scripts/test-avatar-cap.mjs +379 -0
  219. package/kits/hub-game/scripts/test-avatar-colors.mjs +72 -0
  220. package/kits/hub-game/scripts/test-avatar-models.mjs +181 -0
  221. package/kits/hub-game/scripts/test-avatar-share.mjs +318 -0
  222. package/kits/hub-game/scripts/test-avatar-wire.mjs +753 -0
  223. package/kits/hub-game/scripts/test-avatar.mjs +540 -7
  224. package/kits/hub-game/scripts/test-ballot.mjs +1001 -0
  225. package/kits/hub-game/scripts/test-build.mjs +31 -0
  226. package/kits/hub-game/scripts/test-cells.mjs +71 -0
  227. package/kits/hub-game/scripts/test-chat.mjs +662 -0
  228. package/kits/hub-game/scripts/test-classic.mjs +2 -0
  229. package/kits/hub-game/scripts/test-companion-chat.mjs +198 -0
  230. package/kits/hub-game/scripts/test-companion-client.mjs +1167 -0
  231. package/kits/hub-game/scripts/test-companion.mjs +259 -0
  232. package/kits/hub-game/scripts/test-decor-client.mjs +303 -0
  233. package/kits/hub-game/scripts/test-decor.mjs +457 -0
  234. package/kits/hub-game/scripts/test-earned-client.mjs +459 -0
  235. package/kits/hub-game/scripts/test-earned.mjs +1194 -0
  236. package/kits/hub-game/scripts/test-emote-bubble.mjs +110 -0
  237. package/kits/hub-game/scripts/test-friend-bests.mjs +435 -0
  238. package/kits/hub-game/scripts/test-grab-orbit.mjs +918 -0
  239. package/kits/hub-game/scripts/test-grab.mjs +7 -0
  240. package/kits/hub-game/scripts/test-hats.mjs +422 -168
  241. package/kits/hub-game/scripts/test-hub-leaving.mjs +203 -0
  242. package/kits/hub-game/scripts/test-hub-ops.mjs +439 -2
  243. package/kits/hub-game/scripts/test-hub-trip.mjs +716 -2
  244. package/kits/hub-game/scripts/test-hud-clear.mjs +328 -4
  245. package/kits/hub-game/scripts/test-idle.mjs +361 -1
  246. package/kits/hub-game/scripts/test-interest-cap.mjs +36 -0
  247. package/kits/hub-game/scripts/test-interest-cells.mjs +493 -0
  248. package/kits/hub-game/scripts/test-interest-client.mjs +118 -0
  249. package/kits/hub-game/scripts/test-keys.mjs +46 -1
  250. package/kits/hub-game/scripts/test-labels.mjs +596 -0
  251. package/kits/hub-game/scripts/test-manifest.mjs +207 -0
  252. package/kits/hub-game/scripts/test-menu-client.mjs +480 -0
  253. package/kits/hub-game/scripts/test-menu.mjs +296 -0
  254. package/kits/hub-game/scripts/test-npcs.mjs +1718 -12
  255. package/kits/hub-game/scripts/test-object-entry.mjs +76 -0
  256. package/kits/hub-game/scripts/test-pack.mjs +7 -0
  257. package/kits/hub-game/scripts/test-picker.mjs +314 -0
  258. package/kits/hub-game/scripts/test-rehello.mjs +1039 -0
  259. package/kits/hub-game/scripts/test-relations-among.mjs +222 -0
  260. package/kits/hub-game/scripts/test-relations-refresh.mjs +188 -0
  261. package/kits/hub-game/scripts/test-shot.mjs +756 -0
  262. package/kits/hub-game/scripts/test-soundscape.mjs +5432 -0
  263. package/kits/hub-game/scripts/test-spin.mjs +314 -0
  264. package/kits/hub-game/scripts/test-standing.mjs +416 -0
  265. package/kits/hub-game/scripts/test-stuck.mjs +1903 -0
  266. package/kits/hub-game/scripts/test-tier-cells.mjs +706 -0
  267. package/kits/hub-game/scripts/test-tiers-render.mjs +339 -0
  268. package/kits/hub-game/scripts/test-tiers.mjs +477 -2
  269. package/kits/hub-game/scripts/test-toast-band.mjs +61 -0
  270. package/kits/hub-game/scripts/test-try-on.mjs +22 -22
  271. package/kits/hub-game/scripts/test-vis.mjs +343 -0
  272. package/kits/hub-game/scripts/test-visibility.mjs +134 -0
  273. package/kits/hub-game/scripts/test-yours-chrome.mjs +166 -0
  274. package/kits/hub-game/scripts/test-yours.mjs +372 -0
  275. package/kits/multiplayer-3d/CLAUDE.md +50 -0
  276. package/kits/multiplayer-3d/castle.json +5 -5
  277. package/kits/multiplayer-3d/code/client/avatars.js +7 -0
  278. package/kits/multiplayer-3d/code/client/gait.js +65 -0
  279. package/kits/multiplayer-3d/code/client/nameTags.js +59 -4
  280. package/kits/multiplayer-3d/code/options.js +5 -0
  281. package/kits/multiplayer-3d/code/server/ownership.js +10 -2
  282. package/kits/multiplayer-3d/code/server/sceneBodies.js +12 -0
  283. package/kits/multiplayer-3d/code/server/world.js +7 -0
  284. package/kits/multiplayer-3d/code/systems/multiplayer.js +74 -4
  285. package/kits/multiplayer-3d/package.json +2 -1
  286. package/kits/multiplayer-3d/scripts/fixtures/README.md +11 -0
  287. package/kits/multiplayer-3d/scripts/fixtures/ownership-legacy.json +2 -0
  288. package/kits/multiplayer-3d/scripts/ownership-harness.mjs +102 -0
  289. package/kits/multiplayer-3d/scripts/ownership-loader.mjs +46 -0
  290. package/kits/multiplayer-3d/scripts/ownership-worker.mjs +15 -0
  291. package/kits/multiplayer-3d/scripts/record-ownership-session.mjs +98 -0
  292. package/kits/multiplayer-3d/scripts/test-eligible-claims.mjs +167 -0
  293. package/kits/multiplayer-3d/scripts/test-own-name-tag.mjs +247 -0
  294. package/kits/physics-2d/CLAUDE.md +9 -0
  295. package/kits/physics-2d/castle.json +2 -2
  296. package/kits/physics-2d/engine/scene.js +253 -1
  297. package/kits/physics-2d/engine/skyKey.js +129 -0
  298. package/kits/physics-2d/engine/stillClock.js +106 -0
  299. package/kits/physics-2d/engine/updateBudget.js +21 -0
  300. package/kits/physics-2d/scripts/test-skip-unchanged.mjs +326 -1
  301. package/kits/physics-3d/CLAUDE.md +1169 -30
  302. package/kits/physics-3d/behaviors/Player.jsx +629 -72
  303. package/kits/physics-3d/castle.json +3 -3
  304. package/kits/physics-3d/docs/pxmodel-format.md +8 -0
  305. package/kits/physics-3d/engine3d/Scene3DPlayer.jsx +69 -13
  306. package/kits/physics-3d/engine3d/actornode.js +86 -0
  307. package/kits/physics-3d/engine3d/animationBudget.js +23 -0
  308. package/kits/physics-3d/engine3d/editorWorld.js +6 -0
  309. package/kits/physics-3d/engine3d/emptynodes.js +232 -0
  310. package/kits/physics-3d/engine3d/framecap.js +96 -0
  311. package/kits/physics-3d/engine3d/gait.js +118 -0
  312. package/kits/physics-3d/engine3d/kithooks.js +47 -0
  313. package/kits/physics-3d/engine3d/look.js +507 -48
  314. package/kits/physics-3d/engine3d/lookbake.js +208 -0
  315. package/kits/physics-3d/engine3d/materialpresets.js +2 -0
  316. package/kits/physics-3d/engine3d/motion.js +39 -10
  317. package/kits/physics-3d/engine3d/nearshadows.js +37 -19
  318. package/kits/physics-3d/engine3d/optimize.js +9 -5
  319. package/kits/physics-3d/engine3d/orbitinput.js +487 -9
  320. package/kits/physics-3d/engine3d/orbitlens.js +48 -0
  321. package/kits/physics-3d/engine3d/ownmodel.js +213 -0
  322. package/kits/physics-3d/engine3d/pxmodel.js +42 -11
  323. package/kits/physics-3d/engine3d/shadowfade.js +882 -0
  324. package/kits/physics-3d/engine3d/sky.js +547 -0
  325. package/kits/physics-3d/engine3d/skylife.js +306 -0
  326. package/kits/physics-3d/engine3d/unchanged.js +11 -0
  327. package/kits/physics-3d/engine3d/viewrange.js +52 -0
  328. package/kits/physics-3d/engine3d/world3d.js +796 -69
  329. package/kits/physics-3d/main.jsx +5 -0
  330. package/kits/physics-3d/package.json +1 -1
  331. package/kits/physics-3d/scripts/look-baseline.mjs +155 -0
  332. package/kits/physics-3d/scripts/test-camera-orbit.mjs +2563 -80
  333. package/kits/physics-3d/scripts/test-drop-empty-parts.mjs +1 -1
  334. package/kits/physics-3d/scripts/test-frame-cap-bob.mjs +435 -0
  335. package/kits/physics-3d/scripts/test-frame-cap.mjs +452 -0
  336. package/kits/physics-3d/scripts/test-gait.mjs +387 -0
  337. package/kits/physics-3d/scripts/test-look-bake.mjs +1056 -0
  338. package/kits/physics-3d/scripts/test-model-parse-cache.mjs +92 -0
  339. package/kits/physics-3d/scripts/test-near-shadows.mjs +3 -0
  340. package/kits/physics-3d/scripts/test-orbit-shadow-fade.mjs +1920 -0
  341. package/kits/physics-3d/scripts/test-orbit-shift-lock.mjs +545 -0
  342. package/kits/physics-3d/scripts/test-orbit-shot.mjs +583 -0
  343. package/kits/physics-3d/scripts/test-orbit-view.mjs +230 -0
  344. package/kits/physics-3d/scripts/test-skip-empty-nodes.mjs +845 -0
  345. package/kits/physics-3d/scripts/test-sky.mjs +2470 -0
  346. package/kits/physics-3d/scripts/test-static-actors.mjs +8 -1
  347. package/kits/physics-3d/scripts/test-static-scenery.mjs +2171 -0
  348. package/kits/physics-3d/scripts/test-steady-hover.mjs +2 -0
  349. package/kits/physics-3d/scripts/test-view-range.mjs +260 -0
  350. package/kits/physics-3d/systems/physics3d.js +383 -6
  351. package/kits/real-time/castle.json +2 -2
  352. package/kits/real-time/code/server/gameHooks.js +7 -0
  353. package/kits/real-time/code/server/session.js +97 -19
  354. package/package.json +2 -2
  355. package/dist/shell/assets/index-Cf61cNfT.css +0 -1
@@ -0,0 +1,331 @@
1
+ // The Stadium's crowd, round 3: a crowd made of people, not of noise.
2
+ //
3
+ // const crowd = makeStadiumCrowd(context, destination, variant = 'A', seed)
4
+ // crowd.frame(t) // once a frame with the context's time; makes no nodes
5
+ // crowd.stop()
6
+ // crowd.nodes // fixed for its life
7
+ //
8
+ // - voices: a pool of VOICES slots, each one person: a band-limited buzz
9
+ // through two vowel formants (band-passes) and its own level. A slot is
10
+ // retriggered for every call: short wordless shouts ("hey", "oh", "yeah",
11
+ // "woo", "ah" as vowel shapes and pitch shapes) or, when the crowd is
12
+ // quiet, a few chatty syllables. Each call picks a man's or a woman's
13
+ // range (shouting pitch, 120-430 Hz, a wide spread), its own level and
14
+ // distance (a level and a darker or brighter vowel).
15
+ // - claps: CLAPPERS slots, each a pair of hands: a burst of the shared noise
16
+ // 5-15 ms long through that pair's own band-pass (cupped or flat hands,
17
+ // 0.8-2.6 kHz). In a clap swell they keep a loose shared beat, each person
18
+ // a little early or late and drifting; in applause each claps at their own
19
+ // rate.
20
+ // - space: everything goes to a small stadium-sized echo (four damped
21
+ // feedback delays and two all-passes), so many short calls run together
22
+ // into a crowd.
23
+ // - the crowd's mood is a script per variant: how busy, how loud and how
24
+ // high the calls are, and when clapping swells, second by second.
25
+ //
26
+ // No noise bed and no samples: every sound is a call or a clap.
27
+
28
+ import { seeded, gain, filter, noise, release, startAll } from './soundscapeSynthesis.js';
29
+
30
+ const VOICES = 12;
31
+ const CLAPPERS = 8;
32
+ const LOOK = 0.35;
33
+
34
+ // Shout vowels [F1, F2] Hz.
35
+ const V = { a: [850, 1300], e: [560, 1900], i: [360, 2300], o: [560, 950], u: [390, 900], ae: [760, 1750] };
36
+
37
+ // The crowd's mood over time: [t, busy (0-1), clap mode, clap amount (0-1)].
38
+ // clap mode: 'none', 'applause' (each at their own rate) or 'beat'.
39
+ const SCRIPTS = {
40
+ // A: "Match day" -- chatter and a little applause, a big cheer that rises
41
+ // and falls, a clap-along swell, chatter again.
42
+ A: { bpm: 140, far: 0, wet: 0.32, points: [[0, 0.22, 'applause', 0.15], [2.6, 0.28, 'applause', 0.2], [3.4, 0.75, 'applause', 0.6], [4.6, 1, 'applause', 1], [6.2, 0.8, 'applause', 0.7], [7.4, 0.35, 'beat', 0.4], [8.2, 0.45, 'beat', 1], [11.2, 0.5, 'beat', 0.9], [11.9, 0.85, 'applause', 0.7], [12.8, 0.5, 'applause', 0.3], [14, 0.25, 'applause', 0.15]] },
43
+ // B: "Clap-along" -- the crowd claps a beat that builds, with a group shout
44
+ // every fourth bar, and a cheer to finish.
45
+ B: { bpm: 150, far: 0, wet: 0.28, shoutEvery: 8, points: [[0, 0.25, 'beat', 0.35], [2, 0.35, 'beat', 0.8], [9.5, 0.45, 'beat', 1], [10.6, 0.9, 'applause', 0.9], [12, 1, 'applause', 0.8], [14, 0.6, 'applause', 0.4]] },
46
+ // C: "From the concourse" -- the same crowd heard from outside the stands:
47
+ // farther, darker, more echo; rolling cheers and applause that never stop.
48
+ C: { bpm: 132, far: 1, wet: 0.5, points: [[0, 0.45, 'applause', 0.4], [3, 0.7, 'applause', 0.6], [5, 0.45, 'applause', 0.35], [7.5, 0.55, 'beat', 0.7], [10.5, 0.85, 'applause', 0.8], [12.5, 0.5, 'applause', 0.4], [14, 0.45, 'applause', 0.4]] },
49
+ };
50
+
51
+ function moodAt(points, t) {
52
+ let a = points[0];
53
+ for (const p of points) {
54
+ if (p[0] <= t) {
55
+ a = p;
56
+ }
57
+ }
58
+ const b = points.find((p) => p[0] > t) ?? a;
59
+ const f = b === a ? 0 : (t - a[0]) / (b[0] - a[0]);
60
+ return { busy: a[1] + (b[1] - a[1]) * f, mode: a[2], claps: a[3] + (b[3] - a[3]) * f };
61
+ }
62
+
63
+ // A strained voice's spectrum: 1/n^0.95, 40 harmonics (the browser drops
64
+ // those over Nyquist).
65
+ const shoutWaves = new WeakMap();
66
+ function shoutWave(ctx) {
67
+ let w = shoutWaves.get(ctx);
68
+ if (!w) {
69
+ const n = 40;
70
+ const real = new Float32Array(n + 1);
71
+ const imag = new Float32Array(n + 1);
72
+ for (let i = 1; i <= n; i += 1) {
73
+ imag[i] = 1 / i ** 0.95;
74
+ }
75
+ w = ctx.createPeriodicWave(real, imag);
76
+ shoutWaves.set(ctx, w);
77
+ }
78
+ return w;
79
+ }
80
+
81
+ export function makeStadiumCrowd(context, destination, variant = 'A', seed = 0xc20d, level = 1) {
82
+ const ctx = context;
83
+ const script = SCRIPTS[variant] ?? SCRIPTS.A;
84
+ const next = seeded(seed ^ variant.charCodeAt(0));
85
+ const rand = (lo, hi) => lo + (hi - lo) * next();
86
+ const all = [];
87
+
88
+ // Output: dry plus the echo.
89
+ const out = gain(ctx, 0.5 * level);
90
+ out.connect(destination);
91
+ const tone = filter(ctx, 'lowpass', script.far ? 2600 : 7500, 0);
92
+ tone.connect(out);
93
+ const dry = gain(ctx, script.far ? 0.55 : 1);
94
+ dry.connect(tone);
95
+ const send = gain(ctx, script.wet);
96
+ all.push(out, tone, dry, send);
97
+ // The echo: four damped feedback delays in parallel, two all-passes after.
98
+ const diffuse1 = filter(ctx, 'allpass', 900, 0.7);
99
+ const diffuse2 = filter(ctx, 'allpass', 2300, 0.7);
100
+ diffuse1.connect(diffuse2);
101
+ diffuse2.connect(tone);
102
+ all.push(diffuse1, diffuse2);
103
+ for (const [d, fb] of [[0.0613, 0.62], [0.0839, 0.6], [0.1129, 0.58], [0.1471, 0.55]]) {
104
+ const delay = ctx.createDelay(0.5);
105
+ delay.delayTime.value = d * (script.far ? 1.35 : 1);
106
+ const damp = filter(ctx, 'lowpass', script.far ? 1600 : 2600, 0);
107
+ const loop = gain(ctx, fb);
108
+ send.connect(delay);
109
+ delay.connect(damp);
110
+ damp.connect(loop);
111
+ loop.connect(delay);
112
+ damp.connect(diffuse1);
113
+ all.push(delay, damp, loop);
114
+ }
115
+ const bus = gain(ctx, 1);
116
+ bus.connect(dry);
117
+ bus.connect(send);
118
+ all.push(bus);
119
+
120
+ // Voices.
121
+ const voiceBus = gain(ctx, 0.5);
122
+ voiceBus.connect(bus);
123
+ all.push(voiceBus);
124
+ const slots = [];
125
+ for (let i = 0; i < VOICES; i += 1) {
126
+ const o = ctx.createOscillator();
127
+ o.setPeriodicWave(shoutWave(ctx));
128
+ o.frequency.value = 200;
129
+ const env = gain(ctx, 0);
130
+ const f1 = filter(ctx, 'bandpass', 600, 3.5);
131
+ const f2 = filter(ctx, 'bandpass', 1500, 5);
132
+ o.connect(env);
133
+ env.connect(f1);
134
+ env.connect(f2);
135
+ f1.connect(voiceBus);
136
+ f2.connect(voiceBus);
137
+ all.push(o, env, f1, f2);
138
+ slots.push({ o, env, f1, f2, free: 0 });
139
+ }
140
+
141
+ // Claps.
142
+ const clapBus = filter(ctx, 'highpass', 450, 0);
143
+ const clapLevel = gain(ctx, 1.3);
144
+ clapBus.connect(clapLevel);
145
+ clapLevel.connect(bus);
146
+ const hands = noise(ctx, 0.29);
147
+ all.push(clapBus, clapLevel, hands);
148
+ const clappers = [];
149
+ for (let i = 0; i < CLAPPERS; i += 1) {
150
+ const band = filter(ctx, 'bandpass', rand(800, 2600), rand(1.2, 2.6));
151
+ const env = gain(ctx, 0);
152
+ hands.connect(band);
153
+ band.connect(env);
154
+ env.connect(clapBus);
155
+ all.push(band, env);
156
+ clappers.push({ band, env, hz: band.frequency.value, q: band.Q.value, lag: rand(-0.02, 0.035), rate: rand(3.2, 5), next: rand(0, 0.3), last: -1 });
157
+ }
158
+ startAll(all, ctx.currentTime);
159
+
160
+ // --- one call on one slot ---
161
+ function call(slot, at, busy, kind) {
162
+ const female = next() < 0.5;
163
+ const lift = 2 ** ((busy * 3 + rand(-1, 1)) / 12);
164
+ const p = (female ? rand(240, 400) : rand(125, 230)) * lift;
165
+ const mouth = female ? 1.14 : 1;
166
+ const near = script.far ? rand(0.25, 0.7) : rand(0.3, 1);
167
+ // Farther voices are darker: their F2 is pulled down a little.
168
+ const vowel = (name) => [V[name][0] * mouth, V[name][1] * mouth * (0.82 + 0.18 * near)];
169
+ const { o, env, f1, f2 } = slot;
170
+ const set = (t, name) => {
171
+ const [a, b] = vowel(name);
172
+ f1.frequency.linearRampToValueAtTime(a, t);
173
+ f2.frequency.linearRampToValueAtTime(b, t);
174
+ };
175
+ const start = (name) => {
176
+ const [a, b] = vowel(name);
177
+ f1.frequency.setValueAtTime(a, at);
178
+ f2.frequency.setValueAtTime(b, at);
179
+ };
180
+ const level = near * (0.35 + 0.65 * busy) * rand(0.7, 1);
181
+ o.frequency.setValueAtTime(p, at);
182
+ env.gain.setValueAtTime(0, at);
183
+ let end;
184
+ if (kind === 'talk') {
185
+ // A few quick syllables, lower and quieter.
186
+ const n = 2 + Math.floor(next() * 3);
187
+ const names = Object.keys(V);
188
+ let t = at;
189
+ start(names[Math.floor(next() * names.length)]);
190
+ o.frequency.setValueAtTime(p * 0.8, at);
191
+ for (let i = 0; i < n; i += 1) {
192
+ const d = rand(0.1, 0.19);
193
+ set(t + 0.03, names[Math.floor(next() * names.length)]);
194
+ o.frequency.linearRampToValueAtTime(p * 0.8 * rand(0.92, 1.1), t + d * 0.5);
195
+ env.gain.linearRampToValueAtTime(level * 0.95, t + 0.025);
196
+ env.gain.linearRampToValueAtTime(level * 0.8, t + d - 0.03);
197
+ env.gain.linearRampToValueAtTime(level * 0.2, t + d);
198
+ t += d;
199
+ }
200
+ env.gain.linearRampToValueAtTime(0, t + 0.04);
201
+ end = t + 0.04;
202
+ } else {
203
+ const shapes = {
204
+ // [vowels with times, pitch points (fraction, ratio), length]
205
+ hey: [[['e', 0], ['e', 0.55], ['i', 0.85]], [[0.3, 1.14], [1, 0.84]], rand(0.25, 0.42)],
206
+ oh: [[['o', 0], ['o', 0.6], ['u', 1]], [[0.2, 1.06], [1, 0.78]], rand(0.3, 0.6)],
207
+ yeah: [[['i', 0], ['e', 0.25], ['ae', 0.6]], [[0.3, 1.18], [1, 0.82]], rand(0.35, 0.6)],
208
+ woo: [[['u', 0], ['u', 0.5], ['o', 1]], [[0.35, 1.3], [0.8, 1.22], [1, 1.04]], rand(0.5, 1.1)],
209
+ ah: [[['a', 0], ['a', 0.7], ['o', 1]], [[0.25, 1.1], [1, 0.86]], rand(0.35, 0.8)],
210
+ };
211
+ const [vs, ps, d] = shapes[kind];
212
+ start(vs[0][0]);
213
+ for (const [name, f] of vs.slice(1)) {
214
+ set(at + d * f, name);
215
+ }
216
+ if (kind === 'woo') {
217
+ o.frequency.setValueAtTime(p * 0.82, at);
218
+ }
219
+ for (const [f, r] of ps) {
220
+ o.frequency.linearRampToValueAtTime(p * r, at + d * f);
221
+ }
222
+ const attack = rand(0.02, 0.045);
223
+ env.gain.linearRampToValueAtTime(level, at + attack);
224
+ env.gain.linearRampToValueAtTime(level * 0.75, at + d * 0.8);
225
+ env.gain.linearRampToValueAtTime(0, at + d + rand(0.06, 0.14));
226
+ end = at + d + 0.14;
227
+ }
228
+ slot.free = end + 0.02;
229
+ }
230
+
231
+ // --- one clap on one pair of hands ---
232
+ function clap(c, at, level, clock) {
233
+ // Its filter is set 2 ms ahead; a clap whose lead has passed is skipped.
234
+ if (at - 0.002 < clock) {
235
+ return;
236
+ }
237
+ const hz = c.hz * rand(0.9, 1.1);
238
+ c.band.frequency.setValueAtTime(hz, at - 0.002);
239
+ const len = rand(0.005, 0.015);
240
+ c.env.gain.setValueAtTime(0, at);
241
+ c.env.gain.linearRampToValueAtTime(level, at + 0.0008);
242
+ c.env.gain.linearRampToValueAtTime(level * 0.3, at + len * 0.5);
243
+ c.env.gain.linearRampToValueAtTime(0, at + len);
244
+ c.last = at;
245
+ }
246
+
247
+ let started = null;
248
+ let scheduled = 0; // seconds from start already scheduled for calls
249
+ let beat = 0; // next beat index
250
+ let beatAt = 0.3; // next beat time (from start)
251
+ let stopped = false;
252
+ return {
253
+ nodes: all.length,
254
+ voices: VOICES,
255
+ clappers: CLAPPERS,
256
+ // The optional clock lets an offline bake advance expiry without rendering.
257
+ frame(now, clock = ctx.currentTime) {
258
+ if (stopped || !Number.isFinite(now)) { return; }
259
+ now = Math.max(now, clock);
260
+ if (started === null) {
261
+ started = now;
262
+ }
263
+ const rel = now - started;
264
+ // Drop missed shouts/claps after a stalled frame; never replay a backlog.
265
+ if (scheduled < rel) { scheduled = rel; }
266
+ if (beatAt < rel) { beatAt = rel + LOOK; }
267
+ for (const c of clappers) {
268
+ if (c.next < rel) { c.next = rel + rand(0, 0.3); }
269
+ }
270
+ const horizon = rel + LOOK;
271
+ // Calls: a Poisson stream whose rate follows the mood.
272
+ while (scheduled < horizon) {
273
+ const m = moodAt(script.points, scheduled);
274
+ const perSecond = 2.5 + 22 * m.busy * m.busy;
275
+ scheduled += -Math.log(1 - next() * 0.999) / perSecond;
276
+ const slot = slots.find((s) => s.free <= started + scheduled);
277
+ if (!slot) {
278
+ continue;
279
+ }
280
+ const r = next();
281
+ const kind = m.busy < 0.35 ? (r < 0.75 ? 'talk' : r < 0.9 ? 'hey' : 'oh') : m.busy < 0.7 ? (r < 0.3 ? 'talk' : r < 0.55 ? 'hey' : r < 0.75 ? 'yeah' : r < 0.9 ? 'oh' : 'ah') : (r < 0.3 ? 'woo' : r < 0.5 ? 'yeah' : r < 0.7 ? 'hey' : r < 0.88 ? 'ah' : 'oh');
282
+ call(slot, started + scheduled, m.busy, kind);
283
+ }
284
+ // Claps.
285
+ const beatS = 60 / script.bpm;
286
+ while (beatAt < rel + LOOK) {
287
+ const m = moodAt(script.points, beatAt);
288
+ if (m.mode === 'beat') {
289
+ for (const c of clappers) {
290
+ // Some join late, some miss a beat; each keeps their own lag.
291
+ if (next() < m.claps * 0.95) {
292
+ c.lag += rand(-0.004, 0.004);
293
+ c.lag = Math.max(-0.03, Math.min(0.045, c.lag));
294
+ const at = started + beatAt + c.lag + rand(-0.012, 0.012);
295
+ if (at >= clock && at > c.last + 0.06) {
296
+ clap(c, at, rand(0.6, 1) * (0.5 + 0.5 * m.claps), clock);
297
+ }
298
+ }
299
+ c.next = beatAt + 0.3;
300
+ }
301
+ // B: a group shout on the last beat of every few bars.
302
+ if (script.shoutEvery && beat % script.shoutEvery === script.shoutEvery - 1) {
303
+ for (const s of slots) {
304
+ if (s.free <= started + beatAt && next() < 0.8) {
305
+ call(s, started + beatAt + rand(0, 0.05), 0.85, 'hey');
306
+ }
307
+ }
308
+ }
309
+ }
310
+ beat += 1;
311
+ beatAt += beatS * (m.mode === 'beat' ? 0.997 : 1);
312
+ }
313
+ for (const c of clappers) {
314
+ while (c.next < rel + LOOK) {
315
+ const m = moodAt(script.points, c.next);
316
+ if (m.mode === 'applause' && next() < 0.25 + 0.75 * m.claps) {
317
+ const at = started + c.next;
318
+ if (at > c.last + 0.06) {
319
+ clap(c, at, rand(0.5, 1) * (0.3 + 0.7 * m.claps), clock);
320
+ }
321
+ }
322
+ c.next += m.mode === 'beat' ? 0.1 : (1 / c.rate) * rand(0.85, 1.15);
323
+ }
324
+ }
325
+ },
326
+ stop() {
327
+ stopped = true;
328
+ release(all);
329
+ },
330
+ };
331
+ }
@@ -0,0 +1,362 @@
1
+ // Chosen action voices (v1.50), from the owner's original audition.
2
+ // Pitch, envelopes, noise seed and part timings are kept. Parts are planned
3
+ // once per cue, then built 75 ms ahead by the frame clock to keep graphs small.
4
+
5
+ import { courtChimeA, courtBellA, courtSplashA, courtFlutterB } from './soundscapeCourt.js';
6
+
7
+ const noises = new WeakMap();
8
+ function noiseOf(ctx) {
9
+ let buffer = noises.get(ctx);
10
+ if (!buffer) {
11
+ const n = Math.floor(ctx.sampleRate);
12
+ buffer = ctx.createBuffer(1, n, ctx.sampleRate);
13
+ const data = buffer.getChannelData(0);
14
+ let a = 0xac710;
15
+ for (let i = 0; i < n; i += 1) {
16
+ a = (a + 0x6d2b79f5) >>> 0;
17
+ let t = a;
18
+ t = Math.imul(t ^ (t >>> 15), t | 1);
19
+ t ^= t + Math.imul(t ^ (t >>> 7), t | 61);
20
+ data[i] = (((t ^ (t >>> 14)) >>> 0) / 4294967296) * 2 - 1;
21
+ }
22
+ noises.set(ctx, buffer);
23
+ }
24
+ return buffer;
25
+ }
26
+
27
+ function run(ctx, source, nodes, t, end) {
28
+ const group = ctx.track(nodes, end + 0.02);
29
+ source.onended = () => ctx.ended(group);
30
+ source.start(t);
31
+ source.stop(end + 0.02);
32
+ }
33
+
34
+ // A pitched part: `f` Hz (sliding to `to` over `slide` seconds, the whole
35
+ // length by default), up to `gain` in `attack`, held `hold`, gone by `dur`.
36
+ // `lp` softens it with a low-pass at that frequency. Returns when it ends.
37
+ function tone(ctx, dest, t, { type = 'sine', f, to = 0, slide = 0, dur, gain = 0.18, attack = 0.005, hold = 0, lp = 0, tremolo = 0 }) {
38
+ if (ctx.parts) {
39
+ ctx.parts.push({ kind: 'tone', at: t, options: { type, f, to, slide, dur, gain, attack, hold, lp, tremolo } });
40
+ return t + dur;
41
+ }
42
+ const osc = ctx.createOscillator();
43
+ osc.type = type;
44
+ osc.frequency.setValueAtTime(f, t);
45
+ if (to > 0) {
46
+ osc.frequency.exponentialRampToValueAtTime(to, t + (slide || dur));
47
+ }
48
+ const env = ctx.createGain();
49
+ env.gain.setValueAtTime(0, t);
50
+ env.gain.linearRampToValueAtTime(gain, t + attack);
51
+ if (hold > 0) {
52
+ env.gain.setValueAtTime(gain, t + attack + hold);
53
+ }
54
+ env.gain.exponentialRampToValueAtTime(0.0006, t + dur);
55
+ const nodes = [osc, env];
56
+ let last = osc;
57
+ if (lp > 0) {
58
+ const filter = ctx.createBiquadFilter();
59
+ filter.type = 'lowpass';
60
+ filter.frequency.value = lp;
61
+ filter.Q.value = 0.7;
62
+ osc.connect(filter);
63
+ last = filter;
64
+ nodes.push(filter);
65
+ }
66
+ last.connect(env);
67
+ env.connect(dest);
68
+ if (tremolo > 0) {
69
+ // A flutter, by the envelope: no extra oscillator.
70
+ const steps = Math.floor(dur * tremolo * 2);
71
+ env.gain.cancelScheduledValues(t);
72
+ env.gain.setValueAtTime(0, t);
73
+ for (let i = 1; i <= steps; i += 1) {
74
+ const u = i / steps;
75
+ const shape = Math.sin(Math.PI * u);
76
+ env.gain.linearRampToValueAtTime(gain * shape * (i % 2 ? 1 : 0.35), t + dur * u);
77
+ }
78
+ env.gain.linearRampToValueAtTime(0, t + dur);
79
+ }
80
+ run(ctx, osc, nodes, t, t + dur);
81
+ return t + dur;
82
+ }
83
+
84
+ // A noise part through a filter at `f` Hz (sweeping to `to`).
85
+ function noise(ctx, dest, t, { type = 'bandpass', f, to = 0, q = 1, dur, gain = 0.15, attack = 0.004 }) {
86
+ if (ctx.parts) {
87
+ ctx.parts.push({ kind: 'noise', at: t, options: { type, f, to, q, dur, gain, attack } });
88
+ return t + dur;
89
+ }
90
+ const src = ctx.createBufferSource();
91
+ src.buffer = noiseOf(ctx.context);
92
+ src.loop = true;
93
+ const filter = ctx.createBiquadFilter();
94
+ filter.type = type;
95
+ filter.Q.value = q;
96
+ filter.frequency.setValueAtTime(f, t);
97
+ if (to > 0) {
98
+ filter.frequency.exponentialRampToValueAtTime(to, t + dur);
99
+ }
100
+ const env = ctx.createGain();
101
+ env.gain.setValueAtTime(0, t);
102
+ env.gain.linearRampToValueAtTime(gain, t + attack);
103
+ env.gain.exponentialRampToValueAtTime(0.0006, t + dur);
104
+ src.connect(filter);
105
+ filter.connect(env);
106
+ env.connect(dest);
107
+ run(ctx, src, [src, filter, env], t, t + dur);
108
+ return t + dur;
109
+ }
110
+
111
+ // A small bell: the note and a quiet octave-and-a-fifth over it.
112
+ function bell(ctx, dest, t, f, dur, gain = 0.14) {
113
+ tone(ctx, dest, t, { f: f * 3, dur: dur * 0.4, gain: gain * 0.22, attack: 0.003 });
114
+ return tone(ctx, dest, t, { f, dur, gain, attack: 0.004 });
115
+ }
116
+
117
+ export function kickA(ctx, dest, t) {
118
+ noise(ctx, dest, t, { f: 650, q: 0.8, dur: 0.07, gain: 0.34 });
119
+ return tone(ctx, dest, t, { f: 260, to: 105, dur: 0.14, gain: 0.26, attack: 0.004 });
120
+ }
121
+
122
+ export function goal(ctx, dest, t) {
123
+ const notes = [523.25, 659.25, 783.99, 1174.66];
124
+ notes.forEach((f, i) => {
125
+ const at = t + i * 0.13;
126
+ const last = i === notes.length - 1;
127
+ tone(ctx, dest, at, { type: 'triangle', f, dur: last ? 0.5 : 0.2, gain: 0.15, attack: 0.006 });
128
+ tone(ctx, dest, at, { f: f * 2, dur: last ? 0.42 : 0.12, gain: 0.05, attack: 0.004 });
129
+ });
130
+ return t + 0.13 * 3 + 0.5;
131
+ }
132
+
133
+ export function fishCast(ctx, dest, t) {
134
+ noise(ctx, dest, t, { f: 700, to: 3800, q: 2.2, dur: 0.2, gain: 0.2, attack: 0.09 });
135
+ tone(ctx, dest, t + 0.42, { f: 520, to: 190, dur: 0.08, gain: 0.24, attack: 0.003 });
136
+ noise(ctx, dest, t + 0.42, { type: 'lowpass', f: 1800, to: 500, q: 0.6, dur: 0.12, gain: 0.1 });
137
+ return tone(ctx, dest, t + 0.5, { f: 330, to: 760, dur: 0.07, gain: 0.14, attack: 0.004 });
138
+ }
139
+
140
+ export function fishNibble(ctx, dest, t) {
141
+ tone(ctx, dest, t, { f: 1320, to: 1180, dur: 0.04, gain: 0.13, attack: 0.003 });
142
+ tone(ctx, dest, t + 0.1, { f: 1480, to: 1320, dur: 0.04, gain: 0.11, attack: 0.003 });
143
+ return tone(ctx, dest, t + 0.17, { f: 1320, to: 1180, dur: 0.04, gain: 0.09, attack: 0.003 });
144
+ }
145
+
146
+ export function fishBite(ctx, dest, t) {
147
+ noise(ctx, dest, t, { f: 1500, q: 1.5, dur: 0.035, gain: 0.14, attack: 0.002 });
148
+ tone(ctx, dest, t, { type: 'triangle', f: 760, to: 360, dur: 0.1, gain: 0.26, attack: 0.003 });
149
+ return tone(ctx, dest, t + 0.11, { type: 'triangle', f: 990, dur: 0.09, gain: 0.2, attack: 0.003 });
150
+ }
151
+
152
+ export function fishCatchC(ctx, dest, t) {
153
+ // The whirr: quick ticks that speed up.
154
+ let at = t;
155
+ let gap = 0.034;
156
+ for (let i = 0; i < 12; i += 1) {
157
+ noise(ctx, dest, at, { f: 1900, q: 3, dur: 0.02, gain: 0.11, attack: 0.002 });
158
+ at += gap;
159
+ gap *= 0.93;
160
+ }
161
+ [2093, 2637, 3136, 3951].forEach((f, i) => {
162
+ tone(ctx, dest, at + 0.03 + i * 0.055, { f, dur: 0.16, gain: 0.07, attack: 0.003 });
163
+ });
164
+ return at + 0.03 + 3 * 0.055 + 0.16;
165
+ }
166
+
167
+ export function emoteWaveB(ctx, dest, t) {
168
+ tone(ctx, dest, t, { type: 'triangle', f: 783.99, dur: 0.1, gain: 0.16 });
169
+ tone(ctx, dest, t + 0.1, { type: 'triangle', f: 987.77, dur: 0.1, gain: 0.16 });
170
+ return tone(ctx, dest, t + 0.2, { type: 'triangle', f: 783.99, dur: 0.2, gain: 0.14 });
171
+ }
172
+
173
+ export function emoteDanceC(ctx, dest, t) {
174
+ for (let i = 0; i < 6; i += 1) {
175
+ noise(ctx, dest, t + i * 0.1, { type: 'highpass', f: 4200, q: 0.7, dur: 0.045, gain: i % 2 ? 0.07 : 0.11, attack: 0.004 });
176
+ }
177
+ tone(ctx, dest, t, { type: 'triangle', f: 262, to: 330, dur: 0.14, gain: 0.2, attack: 0.004 });
178
+ tone(ctx, dest, t + 0.3, { type: 'triangle', f: 330, to: 392, dur: 0.14, gain: 0.2, attack: 0.004 });
179
+ return t + 0.6;
180
+ }
181
+
182
+ export function emoteCheer(ctx, dest, t) {
183
+ noise(ctx, dest, t, { f: 900, to: 2600, q: 0.9, dur: 0.42, gain: 0.13, attack: 0.16 });
184
+ tone(ctx, dest, t + 0.05, { type: 'triangle', f: 659.25, dur: 0.09, gain: 0.15 });
185
+ tone(ctx, dest, t + 0.14, { type: 'triangle', f: 830.61, dur: 0.09, gain: 0.15 });
186
+ tone(ctx, dest, t + 0.23, { type: 'triangle', f: 987.77, dur: 0.22, gain: 0.15 });
187
+ return tone(ctx, dest, t + 0.3, { f: 2637, dur: 0.2, gain: 0.05, attack: 0.004 });
188
+ }
189
+
190
+ export function emoteBow(ctx, dest, t) {
191
+ tone(ctx, dest, t, { f: 587.33, to: 554, dur: 0.24, gain: 0.16, attack: 0.03, hold: 0.06 });
192
+ return tone(ctx, dest, t + 0.22, { f: 440, to: 392, dur: 0.36, gain: 0.16, attack: 0.03, hold: 0.08 });
193
+ }
194
+
195
+ export function emoteSpin(ctx, dest, t) {
196
+ noise(ctx, dest, t, { f: 800, to: 2400, q: 3, dur: 0.5, gain: 0.08, attack: 0.2 });
197
+ tone(ctx, dest, t, { f: 420, to: 1250, dur: 0.3, gain: 0.15, tremolo: 16 });
198
+ return tone(ctx, dest, t + 0.28, { f: 1250, to: 520, dur: 0.3, gain: 0.13, tremolo: 16 });
199
+ }
200
+
201
+ export function sit(ctx, dest, t) {
202
+ noise(ctx, dest, t, { type: 'lowpass', f: 1300, to: 400, q: 0.5, dur: 0.2, gain: 0.2, attack: 0.04 });
203
+ return tone(ctx, dest, t + 0.05, { f: 330, to: 215, dur: 0.2, gain: 0.16, attack: 0.03 });
204
+ }
205
+
206
+ export function padTick(ctx, dest, t, last = false) {
207
+ noise(ctx, dest, t, { f: last ? 2600 : 2000, q: 2, dur: 0.02, gain: 0.07, attack: 0.002 });
208
+ return tone(ctx, dest, t, { f: last ? 1318.5 : 880, dur: last ? 0.16 : 0.09, gain: 0.2, attack: 0.003 });
209
+ }
210
+
211
+ export function padGo(ctx, dest, t) {
212
+ noise(ctx, dest, t, { f: 420, to: 2800, q: 1.4, dur: 0.38, gain: 0.18, attack: 0.2 });
213
+ for (const f of [523.25, 659.25, 783.99]) {
214
+ tone(ctx, dest, t + 0.3, { type: 'triangle', f, dur: 0.55, gain: 0.09, attack: 0.012 });
215
+ }
216
+ return t + 0.85;
217
+ }
218
+
219
+ export function tokenEarned(ctx, dest, t) {
220
+ bell(ctx, dest, t, 1244.5, 0.09, 0.15);
221
+ return bell(ctx, dest, t + 0.085, 1864.7, 0.34, 0.15);
222
+ }
223
+
224
+ export function hatBought(ctx, dest, t) {
225
+ noise(ctx, dest, t, { type: 'highpass', f: 5200, q: 0.7, dur: 0.05, gain: 0.1 });
226
+ noise(ctx, dest, t + 0.09, { type: 'highpass', f: 5200, q: 0.7, dur: 0.05, gain: 0.1 });
227
+ bell(ctx, dest, t + 0.19, 1567.98, 0.14);
228
+ return bell(ctx, dest, t + 0.31, 2093, 0.38);
229
+ }
230
+
231
+ export function hatOn(ctx, dest, t) {
232
+ noise(ctx, dest, t, { type: 'lowpass', f: 1000, q: 0.6, dur: 0.11, gain: 0.26, attack: 0.012 });
233
+ return tone(ctx, dest, t + 0.06, { f: 520, to: 830, dur: 0.11, gain: 0.16, attack: 0.012 });
234
+ }
235
+
236
+ export function lanternFound(ctx, dest, t) {
237
+ for (const f of [440, 554.37, 659.25]) {
238
+ tone(ctx, dest, t, { f, dur: 0.75, gain: 0.085, attack: 0.3, hold: 0.1 });
239
+ }
240
+ return tone(ctx, dest, t + 0.42, { f: 1760, dur: 0.4, gain: 0.07, attack: 0.004 });
241
+ }
242
+
243
+ export function marketStamp(ctx, dest, t) {
244
+ noise(ctx, dest, t, { f: 420, q: 1.6, dur: 0.07, gain: 0.34, attack: 0.002 });
245
+ tone(ctx, dest, t, { f: 260, to: 120, dur: 0.09, gain: 0.24, attack: 0.002 });
246
+ return tone(ctx, dest, t + 0.16, { f: 1318.5, dur: 0.24, gain: 0.1, attack: 0.004 });
247
+ }
248
+
249
+ export function trialStart(ctx, dest, t) {
250
+ tone(ctx, dest, t, { type: 'triangle', f: 659.25, dur: 0.1, gain: 0.17 });
251
+ tone(ctx, dest, t + 0.17, { type: 'triangle', f: 659.25, dur: 0.1, gain: 0.17 });
252
+ return tone(ctx, dest, t + 0.34, { type: 'triangle', f: 987.77, dur: 0.3, gain: 0.18 });
253
+ }
254
+
255
+ export function trialGate(ctx, dest, t) {
256
+ tone(ctx, dest, t, { f: 880, dur: 0.07, gain: 0.16, attack: 0.003 });
257
+ return tone(ctx, dest, t + 0.065, { f: 1174.66, dur: 0.14, gain: 0.16, attack: 0.003 });
258
+ }
259
+
260
+ export function trialFinish(ctx, dest, t) {
261
+ [523.25, 659.25, 783.99, 1046.5].forEach((f, i) => {
262
+ tone(ctx, dest, t + i * 0.085, { type: 'triangle', f, dur: 0.12, gain: 0.15 });
263
+ });
264
+ for (const f of [1046.5, 1318.5, 1567.98]) {
265
+ tone(ctx, dest, t + 0.36, { type: 'triangle', f, dur: 0.52, gain: 0.075, attack: 0.008 });
266
+ }
267
+ return t + 0.88;
268
+ }
269
+
270
+ export function chatOpen(ctx, dest, t) {
271
+ return tone(ctx, dest, t, { f: 430, to: 720, dur: 0.075, gain: 0.2, attack: 0.012 });
272
+ }
273
+
274
+ export const CUE_VOICES = Object.freeze({
275
+ kick: kickA, goal, cast: fishCast, nibble: fishNibble, bite: fishBite,
276
+ catch: fishCatchC, token: tokenEarned, 'hat-bought': hatBought,
277
+ 'hat-on': hatOn, lantern: lanternFound, stamp: marketStamp,
278
+ 'trial-start': trialStart, 'trial-gate': trialGate, 'trial-finish': trialFinish,
279
+ 'pad-tick': padTick, 'pad-go': padGo,
280
+ 'court-chime': courtChimeA, 'court-bell': courtBellA,
281
+ 'court-splash': courtSplashA, 'court-flutter': courtFlutterB,
282
+ });
283
+ export const ACTION_VOICES = Object.freeze({
284
+ wave: emoteWaveB, dance: emoteDanceC, cheer: emoteCheer,
285
+ bow: emoteBow, spin: emoteSpin, sit, chat: chatOpen,
286
+ });
287
+
288
+ function release(nodes) {
289
+ for (const node of nodes) {
290
+ try {
291
+ node.stop?.();
292
+ } catch {
293
+ // Already over, or never started.
294
+ }
295
+ node.disconnect();
296
+ }
297
+ }
298
+
299
+ export function makeCueVoice(synth, context, bus, t, gain) {
300
+ const parts = [];
301
+ const end = synth({ parts }, null, t);
302
+ if (!Number.isFinite(end) || end < t || end - t > 3 || parts.some((part) => !Number.isFinite(part.at) || Object.values(part.options).some((value) => typeof value === 'number' && !Number.isFinite(value)))) {
303
+ throw new Error('invalid cue voice');
304
+ }
305
+ parts.sort((a, b) => a.at - b.at);
306
+ const nodes = [];
307
+ const groups = [];
308
+ let index = 0;
309
+ const made = (node) => { nodes.push(node); return node; };
310
+ const ended = (group) => {
311
+ const at = groups.indexOf(group);
312
+ if (at < 0) { return; }
313
+ groups.splice(at, 1);
314
+ release(group.nodes);
315
+ for (const node of group.nodes) {
316
+ const i = nodes.indexOf(node);
317
+ if (i >= 0) { nodes.splice(i, 1); }
318
+ }
319
+ };
320
+ const ctx = {
321
+ context,
322
+ createOscillator: () => made(context.createOscillator()),
323
+ createGain: () => made(context.createGain()),
324
+ createBiquadFilter: () => made(context.createBiquadFilter()),
325
+ createBufferSource: () => made(context.createBufferSource()),
326
+ track: (partNodes, until) => {
327
+ const group = { nodes: partNodes, until };
328
+ groups.push(group);
329
+ return group;
330
+ },
331
+ ended,
332
+ };
333
+ try {
334
+ const mix = made(context.createGain());
335
+ mix.gain.value = gain;
336
+ mix.connect(bus);
337
+ return {
338
+ nodes, until: end + 0.02,
339
+ frame(now) {
340
+ if (!Number.isFinite(now)) { return; }
341
+ for (let i = groups.length - 1; i >= 0; i -= 1) {
342
+ if (groups[i].until <= now) { ended(groups[i]); }
343
+ }
344
+ while (index < parts.length && parts[index].at <= now + 0.075) {
345
+ const part = parts[index++];
346
+ // A stalled frame drops missed parts, never plays them late.
347
+ if (part.at < now - 0.04) { continue; }
348
+ (part.build ?? (part.kind === 'tone' ? tone : noise))(ctx, mix, part.at, part.options);
349
+ }
350
+ },
351
+ stop() {
352
+ groups.length = 0;
353
+ release(nodes);
354
+ nodes.length = 0;
355
+ index = parts.length;
356
+ },
357
+ };
358
+ } catch (err) {
359
+ release(nodes);
360
+ throw err;
361
+ }
362
+ }