castle-web-cli 0.4.231 → 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 (368) 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/serverBundle.js +5 -3
  28. package/dist/shell/assets/{index-D2tWM896.js → index-BjOxR-lW.js} +4 -4
  29. package/dist/shell/assets/index-MVLfNYd9.css +1 -0
  30. package/dist/shell/index.html +2 -2
  31. package/dist/taskSteer.d.ts +13 -0
  32. package/dist/taskSteer.js +22 -2
  33. package/kits/base/castle.json +1 -1
  34. package/kits/base/package-lock.json +1 -1
  35. package/kits/base/sdk/README.md +79 -2
  36. package/kits/base/sdk/avatar.d.ts +6 -2
  37. package/kits/base/sdk/avatar.js +12 -4
  38. package/kits/base/sdk/castle.d.ts +1 -1
  39. package/kits/base/sdk/commands.d.ts +14 -0
  40. package/kits/base/sdk/hub.d.ts +6 -2
  41. package/kits/base/sdk/hub.js +13 -0
  42. package/kits/base/sdk/multiplayer.js +17 -1
  43. package/kits/base/sdk/save.js +2 -1
  44. package/kits/base/sdk/server/hub.d.ts +87 -0
  45. package/kits/base/sdk/server/hub.js +70 -0
  46. package/kits/base/sdk/server/platformHandle.d.ts +31 -1
  47. package/kits/base/sdk/server/storage.d.ts +13 -0
  48. package/kits/base/sdk/server/storage.js +46 -0
  49. package/kits/base/sdk/server/wrapper.d.ts +36 -5
  50. package/kits/base/sdk/server/wrapper.js +83 -8
  51. package/kits/hub-game/CLAUDE.md +352 -12
  52. package/kits/hub-game/blueprints/avatar-10.scene +28 -0
  53. package/kits/hub-game/blueprints/avatar-11.scene +28 -0
  54. package/kits/hub-game/blueprints/avatar-12.scene +28 -0
  55. package/kits/hub-game/blueprints/avatar-13.scene +28 -0
  56. package/kits/hub-game/blueprints/avatar-14.scene +28 -0
  57. package/kits/hub-game/blueprints/avatar-15.scene +28 -0
  58. package/kits/hub-game/blueprints/avatar-4.scene +28 -0
  59. package/kits/hub-game/blueprints/avatar-5.scene +28 -0
  60. package/kits/hub-game/blueprints/avatar-6.scene +28 -0
  61. package/kits/hub-game/blueprints/avatar-7.scene +28 -0
  62. package/kits/hub-game/blueprints/avatar-8.scene +28 -0
  63. package/kits/hub-game/blueprints/avatar-9.scene +28 -0
  64. package/kits/hub-game/code/client/actorBudget.js +47 -0
  65. package/kits/hub-game/code/client/attention.js +11 -2
  66. package/kits/hub-game/code/client/avatar.js +345 -32
  67. package/kits/hub-game/code/client/avatarCap.js +228 -0
  68. package/kits/hub-game/code/client/avatarColors.js +70 -0
  69. package/kits/hub-game/code/client/avatarFaces.js +21 -0
  70. package/kits/hub-game/code/client/avatarShare.js +251 -0
  71. package/kits/hub-game/code/client/ballot.js +467 -0
  72. package/kits/hub-game/code/client/build.js +22 -0
  73. package/kits/hub-game/code/client/chat.js +12 -0
  74. package/kits/hub-game/code/client/chrome.js +1334 -50
  75. package/kits/hub-game/code/client/companion.js +716 -0
  76. package/kits/hub-game/code/client/companionDress.js +99 -0
  77. package/kits/hub-game/code/client/decor.js +509 -0
  78. package/kits/hub-game/code/client/earned.js +131 -0
  79. package/kits/hub-game/code/client/emoteBubble.js +75 -0
  80. package/kits/hub-game/code/client/grab.js +363 -20
  81. package/kits/hub-game/code/client/hats.js +26 -0
  82. package/kits/hub-game/code/client/hookLayer.js +328 -15
  83. package/kits/hub-game/code/client/hudClear.js +126 -0
  84. package/kits/hub-game/code/client/idle.js +163 -22
  85. package/kits/hub-game/code/client/interestCap.js +81 -0
  86. package/kits/hub-game/code/client/keys.js +36 -0
  87. package/kits/hub-game/code/client/labelsNear.js +205 -0
  88. package/kits/hub-game/code/client/menuIcons.js +34 -0
  89. package/kits/hub-game/code/client/pack.js +6 -2
  90. package/kits/hub-game/code/client/packFormat.js +3 -3
  91. package/kits/hub-game/code/client/rehello.js +167 -0
  92. package/kits/hub-game/code/client/shot.js +92 -0
  93. package/kits/hub-game/code/client/sound.js +63 -8
  94. package/kits/hub-game/code/client/soundscape.js +1151 -0
  95. package/kits/hub-game/code/client/soundscapeActions.js +99 -0
  96. package/kits/hub-game/code/client/soundscapeAmbience.js +453 -0
  97. package/kits/hub-game/code/client/soundscapeBaked.js +143 -0
  98. package/kits/hub-game/code/client/soundscapeBusker.js +217 -0
  99. package/kits/hub-game/code/client/soundscapeCourt.js +200 -0
  100. package/kits/hub-game/code/client/soundscapeCrowd.js +331 -0
  101. package/kits/hub-game/code/client/soundscapeCues.js +362 -0
  102. package/kits/hub-game/code/client/soundscapeMap.js +181 -0
  103. package/kits/hub-game/code/client/soundscapeMarket.js +176 -0
  104. package/kits/hub-game/code/client/soundscapeMusic.js +126 -0
  105. package/kits/hub-game/code/client/soundscapeMusicEngine.js +460 -0
  106. package/kits/hub-game/code/client/soundscapeSimlish.js +737 -0
  107. package/kits/hub-game/code/client/soundscapeSongs.js +127 -0
  108. package/kits/hub-game/code/client/soundscapeSongsRound3.js +63 -0
  109. package/kits/hub-game/code/client/soundscapeSynthesis.js +168 -0
  110. package/kits/hub-game/code/client/soundscapeUi.js +211 -0
  111. package/kits/hub-game/code/client/soundscapeVoice.js +1209 -0
  112. package/kits/hub-game/code/client/soundscapeWaves.js +206 -0
  113. package/kits/hub-game/code/client/spin.js +101 -0
  114. package/kits/hub-game/code/client/state.js +131 -1
  115. package/kits/hub-game/code/client/stuck.js +259 -0
  116. package/kits/hub-game/code/client/talk.js +538 -47
  117. package/kits/hub-game/code/client/tiers.js +541 -27
  118. package/kits/hub-game/code/client/toastBand.js +37 -0
  119. package/kits/hub-game/code/client/together.js +98 -1
  120. package/kits/hub-game/code/client/visibility.js +43 -0
  121. package/kits/hub-game/code/client/wear.js +470 -97
  122. package/kits/hub-game/code/client/yours.js +199 -0
  123. package/kits/hub-game/code/companionSpec.js +45 -0
  124. package/kits/hub-game/code/privateText.js +7 -0
  125. package/kits/hub-game/code/server/actions.js +133 -0
  126. package/kits/hub-game/code/server/actors.js +14 -1
  127. package/kits/hub-game/code/server/ask.js +155 -0
  128. package/kits/hub-game/code/server/ballot.js +539 -0
  129. package/kits/hub-game/code/server/cells.js +100 -0
  130. package/kits/hub-game/code/server/companion.js +82 -0
  131. package/kits/hub-game/code/server/cues.js +70 -0
  132. package/kits/hub-game/code/server/decor.js +269 -0
  133. package/kits/hub-game/code/server/earned.js +461 -0
  134. package/kits/hub-game/code/server/friendBests.js +166 -0
  135. package/kits/hub-game/code/server/friendsAmong.js +232 -0
  136. package/kits/hub-game/code/server/grab.js +296 -11
  137. package/kits/hub-game/code/server/history.js +5 -0
  138. package/kits/hub-game/code/server/hub.js +1317 -52
  139. package/kits/hub-game/code/server/idle.js +30 -11
  140. package/kits/hub-game/code/server/index.js +2 -2
  141. package/kits/hub-game/code/server/labels.js +28 -2
  142. package/kits/hub-game/code/server/manifest.js +424 -8
  143. package/kits/hub-game/code/server/menu.js +133 -0
  144. package/kits/hub-game/code/server/npcs.js +830 -80
  145. package/kits/hub-game/code/server/party.js +13 -2
  146. package/kits/hub-game/code/server/players.js +22 -0
  147. package/kits/hub-game/code/server/say.js +8 -2
  148. package/kits/hub-game/code/server/shot.js +110 -0
  149. package/kits/hub-game/code/server/standing.js +124 -0
  150. package/kits/hub-game/code/server/vis.js +113 -0
  151. package/kits/hub-game/code/server/wear.js +128 -11
  152. package/kits/hub-game/code/server/yours.js +59 -0
  153. package/kits/hub-game/code/shared/cues.js +9 -0
  154. package/kits/hub-game/code/shared/decor.js +41 -0
  155. package/kits/hub-game/code/shared/shot.js +19 -0
  156. package/kits/hub-game/code/shared/spin.js +57 -0
  157. package/kits/hub-game/code/systems/hub.js +1083 -85
  158. package/kits/hub-game/docs/content-pack.md +1 -1
  159. package/kits/hub-game/docs/contract.md +2440 -61
  160. package/kits/hub-game/docs/home-pieces.md +64 -0
  161. package/kits/hub-game/models/avatar-10.pxmodel +28 -0
  162. package/kits/hub-game/models/avatar-11.pxmodel +28 -0
  163. package/kits/hub-game/models/avatar-12.pxmodel +27 -0
  164. package/kits/hub-game/models/avatar-13.pxmodel +24 -0
  165. package/kits/hub-game/models/avatar-14.pxmodel +29 -0
  166. package/kits/hub-game/models/avatar-15.pxmodel +24 -0
  167. package/kits/hub-game/models/avatar-4.pxmodel +29 -0
  168. package/kits/hub-game/models/avatar-5.pxmodel +27 -0
  169. package/kits/hub-game/models/avatar-6.pxmodel +26 -0
  170. package/kits/hub-game/models/avatar-7.pxmodel +25 -0
  171. package/kits/hub-game/models/avatar-8.pxmodel +24 -0
  172. package/kits/hub-game/models/avatar-9.pxmodel +30 -0
  173. package/kits/hub-game/models/earned/badge-round.pxmodel +100 -0
  174. package/kits/hub-game/models/earned/badge-shield.pxmodel +117 -0
  175. package/kits/hub-game/models/earned/badge-star.pxmodel +87 -0
  176. package/kits/hub-game/models/earned/belt-plain.pxmodel +72 -0
  177. package/kits/hub-game/models/earned/held-ball.pxmodel +43 -0
  178. package/kits/hub-game/models/earned/held-lantern.pxmodel +85 -0
  179. package/kits/hub-game/models/earned/held-net.pxmodel +57 -0
  180. package/kits/hub-game/models/earned/held-trophy.pxmodel +109 -0
  181. package/kits/hub-game/models/earned/pin-round.pxmodel +62 -0
  182. package/kits/hub-game/models/earned/sash-plain.pxmodel +66 -0
  183. package/kits/hub-game/models/earned/square/belt-plain.pxmodel +104 -0
  184. package/kits/hub-game/models/earned/square/sash-plain.pxmodel +98 -0
  185. package/kits/hub-game/models/hats/bat-clip.pxmodel +206 -0
  186. package/kits/hub-game/models/hats/beekeeper.pxmodel +149 -0
  187. package/kits/hub-game/models/hats/cap.pxmodel +162 -0
  188. package/kits/hub-game/models/hats/captain.pxmodel +178 -0
  189. package/kits/hub-game/models/hats/crooked-top.pxmodel +172 -0
  190. package/kits/hub-game/models/hats/flower-crown.pxmodel +451 -0
  191. package/kits/hub-game/models/hats/foam-crown.pxmodel +179 -0
  192. package/kits/hub-game/models/hats/lantern.pxmodel +230 -0
  193. package/kits/hub-game/models/hats/laurel.pxmodel +533 -0
  194. package/kits/hub-game/models/hats/lighthouse.pxmodel +96 -0
  195. package/kits/hub-game/models/hats/sailor.pxmodel +141 -0
  196. package/kits/hub-game/models/hats/souwester.pxmodel +131 -0
  197. package/kits/hub-game/models/hats/straw.pxmodel +139 -0
  198. package/kits/hub-game/models/hats/sunflower.pxmodel +406 -0
  199. package/kits/hub-game/models/hats/sweatband.pxmodel +112 -0
  200. package/kits/hub-game/models/hats/witch.pxmodel +147 -0
  201. package/kits/hub-game/package-lock.json +2 -0
  202. package/kits/hub-game/package.json +2 -1
  203. package/kits/hub-game/scripts/check.mjs +78 -11
  204. package/kits/hub-game/scripts/companion-follower-wire.json +1 -0
  205. package/kits/hub-game/scripts/fixtures/decor-keyless-draw.json +121 -0
  206. package/kits/hub-game/scripts/fixtures/decor-keyless.json +293 -0
  207. package/kits/hub-game/scripts/fixtures/engine-models-stub.mjs +23 -0
  208. package/kits/hub-game/scripts/fixtures/fake-dom.mjs +107 -0
  209. package/kits/hub-game/scripts/fixtures/interest-legacy.json +385 -0
  210. package/kits/hub-game/scripts/fixtures/npc-notes-v1.77.jsonl +4 -0
  211. package/kits/hub-game/scripts/fixtures/vis-shared-wire.json +1 -0
  212. package/kits/hub-game/scripts/gen-avatars.mjs +933 -16
  213. package/kits/hub-game/scripts/gen-earned.mjs +285 -0
  214. package/kits/hub-game/scripts/gen-hats.mjs +827 -0
  215. package/kits/hub-game/scripts/grab.before-orbit.mjs +400 -0
  216. package/kits/hub-game/scripts/soundscape-wave-analysis.mjs +125 -0
  217. package/kits/hub-game/scripts/test-actions-client.mjs +488 -0
  218. package/kits/hub-game/scripts/test-actions.mjs +298 -0
  219. package/kits/hub-game/scripts/test-actor-budget.mjs +44 -0
  220. package/kits/hub-game/scripts/test-actors.mjs +19 -17
  221. package/kits/hub-game/scripts/test-ask-client.mjs +358 -0
  222. package/kits/hub-game/scripts/test-ask.mjs +269 -0
  223. package/kits/hub-game/scripts/test-attention.mjs +10 -1
  224. package/kits/hub-game/scripts/test-avatar-cap.mjs +379 -0
  225. package/kits/hub-game/scripts/test-avatar-colors.mjs +72 -0
  226. package/kits/hub-game/scripts/test-avatar-models.mjs +181 -0
  227. package/kits/hub-game/scripts/test-avatar-share.mjs +318 -0
  228. package/kits/hub-game/scripts/test-avatar-wire.mjs +753 -0
  229. package/kits/hub-game/scripts/test-avatar.mjs +540 -7
  230. package/kits/hub-game/scripts/test-ballot.mjs +1001 -0
  231. package/kits/hub-game/scripts/test-build.mjs +31 -0
  232. package/kits/hub-game/scripts/test-cells.mjs +71 -0
  233. package/kits/hub-game/scripts/test-chat.mjs +694 -0
  234. package/kits/hub-game/scripts/test-classic.mjs +2 -0
  235. package/kits/hub-game/scripts/test-companion-chat.mjs +198 -0
  236. package/kits/hub-game/scripts/test-companion-client.mjs +1167 -0
  237. package/kits/hub-game/scripts/test-companion.mjs +259 -0
  238. package/kits/hub-game/scripts/test-decor-client.mjs +303 -0
  239. package/kits/hub-game/scripts/test-decor.mjs +457 -0
  240. package/kits/hub-game/scripts/test-earned-client.mjs +459 -0
  241. package/kits/hub-game/scripts/test-earned.mjs +1194 -0
  242. package/kits/hub-game/scripts/test-emote-bubble.mjs +110 -0
  243. package/kits/hub-game/scripts/test-friend-bests.mjs +435 -0
  244. package/kits/hub-game/scripts/test-grab-client.mjs +186 -3
  245. package/kits/hub-game/scripts/test-grab-orbit.mjs +918 -0
  246. package/kits/hub-game/scripts/test-grab.mjs +864 -3
  247. package/kits/hub-game/scripts/test-hats.mjs +483 -0
  248. package/kits/hub-game/scripts/test-hub-leaving.mjs +203 -0
  249. package/kits/hub-game/scripts/test-hub-ops.mjs +439 -2
  250. package/kits/hub-game/scripts/test-hub-trip.mjs +1228 -1
  251. package/kits/hub-game/scripts/test-hud-clear.mjs +1000 -0
  252. package/kits/hub-game/scripts/test-idle.mjs +361 -1
  253. package/kits/hub-game/scripts/test-interest-cap.mjs +36 -0
  254. package/kits/hub-game/scripts/test-interest-cells.mjs +493 -0
  255. package/kits/hub-game/scripts/test-interest-client.mjs +118 -0
  256. package/kits/hub-game/scripts/test-keys.mjs +46 -1
  257. package/kits/hub-game/scripts/test-labels.mjs +596 -0
  258. package/kits/hub-game/scripts/test-manifest.mjs +282 -0
  259. package/kits/hub-game/scripts/test-menu-client.mjs +480 -0
  260. package/kits/hub-game/scripts/test-menu.mjs +296 -0
  261. package/kits/hub-game/scripts/test-npcs.mjs +1718 -12
  262. package/kits/hub-game/scripts/test-object-entry.mjs +76 -0
  263. package/kits/hub-game/scripts/test-pack.mjs +7 -0
  264. package/kits/hub-game/scripts/test-party.mjs +22 -1
  265. package/kits/hub-game/scripts/test-picker.mjs +314 -0
  266. package/kits/hub-game/scripts/test-rehello.mjs +1039 -0
  267. package/kits/hub-game/scripts/test-relations-among.mjs +222 -0
  268. package/kits/hub-game/scripts/test-relations-refresh.mjs +188 -0
  269. package/kits/hub-game/scripts/test-say.mjs +59 -2
  270. package/kits/hub-game/scripts/test-shot.mjs +756 -0
  271. package/kits/hub-game/scripts/test-soundscape.mjs +5432 -0
  272. package/kits/hub-game/scripts/test-spin.mjs +314 -0
  273. package/kits/hub-game/scripts/test-standing.mjs +416 -0
  274. package/kits/hub-game/scripts/test-stuck.mjs +1903 -0
  275. package/kits/hub-game/scripts/test-tier-cells.mjs +706 -0
  276. package/kits/hub-game/scripts/test-tiers-render.mjs +339 -0
  277. package/kits/hub-game/scripts/test-tiers.mjs +666 -3
  278. package/kits/hub-game/scripts/test-toast-band.mjs +61 -0
  279. package/kits/hub-game/scripts/test-try-on.mjs +940 -0
  280. package/kits/hub-game/scripts/test-vis.mjs +343 -0
  281. package/kits/hub-game/scripts/test-visibility.mjs +134 -0
  282. package/kits/hub-game/scripts/test-yours-chrome.mjs +166 -0
  283. package/kits/hub-game/scripts/test-yours.mjs +372 -0
  284. package/kits/multiplayer-3d/CLAUDE.md +50 -0
  285. package/kits/multiplayer-3d/castle.json +5 -5
  286. package/kits/multiplayer-3d/code/client/avatars.js +7 -0
  287. package/kits/multiplayer-3d/code/client/gait.js +65 -0
  288. package/kits/multiplayer-3d/code/client/nameTags.js +59 -4
  289. package/kits/multiplayer-3d/code/options.js +5 -0
  290. package/kits/multiplayer-3d/code/server/ownership.js +10 -2
  291. package/kits/multiplayer-3d/code/server/sceneBodies.js +12 -0
  292. package/kits/multiplayer-3d/code/server/world.js +7 -0
  293. package/kits/multiplayer-3d/code/systems/multiplayer.js +74 -4
  294. package/kits/multiplayer-3d/package.json +2 -1
  295. package/kits/multiplayer-3d/scripts/fixtures/README.md +11 -0
  296. package/kits/multiplayer-3d/scripts/fixtures/ownership-legacy.json +2 -0
  297. package/kits/multiplayer-3d/scripts/ownership-harness.mjs +102 -0
  298. package/kits/multiplayer-3d/scripts/ownership-loader.mjs +46 -0
  299. package/kits/multiplayer-3d/scripts/ownership-worker.mjs +15 -0
  300. package/kits/multiplayer-3d/scripts/record-ownership-session.mjs +98 -0
  301. package/kits/multiplayer-3d/scripts/test-eligible-claims.mjs +167 -0
  302. package/kits/multiplayer-3d/scripts/test-own-name-tag.mjs +247 -0
  303. package/kits/physics-2d/CLAUDE.md +9 -0
  304. package/kits/physics-2d/castle.json +2 -2
  305. package/kits/physics-2d/engine/scene.js +288 -1
  306. package/kits/physics-2d/engine/skyKey.js +129 -0
  307. package/kits/physics-2d/engine/stillClock.js +106 -0
  308. package/kits/physics-2d/engine/updateBudget.js +21 -0
  309. package/kits/physics-2d/scripts/test-skip-unchanged.mjs +370 -1
  310. package/kits/physics-3d/CLAUDE.md +1391 -0
  311. package/kits/physics-3d/behaviors/Player.jsx +921 -3
  312. package/kits/physics-3d/castle.json +3 -3
  313. package/kits/physics-3d/docs/pxmodel-format.md +12 -0
  314. package/kits/physics-3d/engine3d/Scene3DPlayer.jsx +98 -10
  315. package/kits/physics-3d/engine3d/actornode.js +86 -0
  316. package/kits/physics-3d/engine3d/animationBudget.js +23 -0
  317. package/kits/physics-3d/engine3d/editorWorld.js +6 -0
  318. package/kits/physics-3d/engine3d/emptynodes.js +232 -0
  319. package/kits/physics-3d/engine3d/framecap.js +96 -0
  320. package/kits/physics-3d/engine3d/gait.js +118 -0
  321. package/kits/physics-3d/engine3d/kithooks.js +47 -0
  322. package/kits/physics-3d/engine3d/look.js +507 -48
  323. package/kits/physics-3d/engine3d/lookbake.js +208 -0
  324. package/kits/physics-3d/engine3d/materialpresets.js +2 -0
  325. package/kits/physics-3d/engine3d/motion.js +39 -10
  326. package/kits/physics-3d/engine3d/nearshadows.js +37 -19
  327. package/kits/physics-3d/engine3d/optimize.js +58 -5
  328. package/kits/physics-3d/engine3d/orbitinput.js +755 -0
  329. package/kits/physics-3d/engine3d/orbitlens.js +48 -0
  330. package/kits/physics-3d/engine3d/ownmodel.js +213 -0
  331. package/kits/physics-3d/engine3d/pxmodel.js +42 -11
  332. package/kits/physics-3d/engine3d/shadowfade.js +882 -0
  333. package/kits/physics-3d/engine3d/sky.js +547 -0
  334. package/kits/physics-3d/engine3d/skylife.js +306 -0
  335. package/kits/physics-3d/engine3d/unchanged.js +11 -0
  336. package/kits/physics-3d/engine3d/viewrange.js +52 -0
  337. package/kits/physics-3d/engine3d/world3d.js +870 -87
  338. package/kits/physics-3d/main.jsx +5 -0
  339. package/kits/physics-3d/package.json +1 -1
  340. package/kits/physics-3d/scripts/Player.before-orbit.mjs +310 -0
  341. package/kits/physics-3d/scripts/Scene3DPlayer.before-orbit.jsx +337 -0
  342. package/kits/physics-3d/scripts/look-baseline.mjs +155 -0
  343. package/kits/physics-3d/scripts/test-camera-follow.mjs +12 -2
  344. package/kits/physics-3d/scripts/test-camera-orbit.mjs +4588 -0
  345. package/kits/physics-3d/scripts/test-drop-empty-parts.mjs +787 -0
  346. package/kits/physics-3d/scripts/test-frame-cap-bob.mjs +435 -0
  347. package/kits/physics-3d/scripts/test-frame-cap.mjs +452 -0
  348. package/kits/physics-3d/scripts/test-gait.mjs +387 -0
  349. package/kits/physics-3d/scripts/test-look-bake.mjs +1056 -0
  350. package/kits/physics-3d/scripts/test-model-parse-cache.mjs +92 -0
  351. package/kits/physics-3d/scripts/test-near-shadows.mjs +3 -0
  352. package/kits/physics-3d/scripts/test-orbit-shadow-fade.mjs +1920 -0
  353. package/kits/physics-3d/scripts/test-orbit-shift-lock.mjs +545 -0
  354. package/kits/physics-3d/scripts/test-orbit-shot.mjs +583 -0
  355. package/kits/physics-3d/scripts/test-orbit-view.mjs +230 -0
  356. package/kits/physics-3d/scripts/test-skip-empty-nodes.mjs +845 -0
  357. package/kits/physics-3d/scripts/test-sky.mjs +2470 -0
  358. package/kits/physics-3d/scripts/test-static-actors.mjs +13 -1
  359. package/kits/physics-3d/scripts/test-static-passes.mjs +1 -1
  360. package/kits/physics-3d/scripts/test-static-scenery.mjs +2171 -0
  361. package/kits/physics-3d/scripts/test-steady-hover.mjs +635 -0
  362. package/kits/physics-3d/scripts/test-view-range.mjs +260 -0
  363. package/kits/physics-3d/systems/physics3d.js +474 -12
  364. package/kits/real-time/castle.json +2 -2
  365. package/kits/real-time/code/server/gameHooks.js +7 -0
  366. package/kits/real-time/code/server/session.js +97 -19
  367. package/package.json +2 -2
  368. package/dist/shell/assets/index-Cf61cNfT.css +0 -1
@@ -0,0 +1,127 @@
1
+ // Selected round-2 songs. Notes, track timbres and tempos are the audition's.
2
+ import { melody, chords, arp, hits } from './soundscapeMusicEngine.js';
3
+
4
+
5
+ // The square's music, round 2: faster, livelier and higher than the shipped
6
+ // sine notes (G3, 0.9 s each). Our own melodies. Every voice's fundamental is
7
+ // 220 Hz or higher.
8
+
9
+ const G_CHORDS = ['B3 D4 G4 / 8', 'B3 E4 G4 / 8', 'C4 E4 G4 / 8', 'A3 D4 F#4 / 8', 'B3 D4 G4 / 8', 'B3 D4 F#4 / 8', 'C4 E4 G4 / 4', 'A3 D4 F#4 / 4', 'B3 D4 G4 / 8'];
10
+
11
+ // A: "Stroll" -- 116 BPM, G major: plucked arpeggios, a flute-like lead, a
12
+ // soft pad, a shaker on the off-beats and a soft knock on 2 and 4.
13
+ export const SQUARE_A = {
14
+ bpm: 116,
15
+ tracks: [
16
+ { name: 'lead (flute)', kind: 'lead', grid: 2, wave: 'flute', gain: 0.42, vibrato: 9, glide: 0.025, attack: 0.018, gate: 0.88, release: 0.05, pattern: melody(`
17
+ D5:2 G5 A5 B5:2 G5:2 | E5:2 G5 B5 A5:3 r | G5:2 E5 G5 C6:2 B5 A5 | A5:3 F#5 D5:4 |
18
+ D5:2 G5 A5 B5:2 D6:2 | B5:2 A5 F#5 D5:3 r | E5 G5 C6 B5 A5:2 F#5 A5 | G5:6 r:2`) },
19
+ { name: 'pluck arps', kind: 'pluck', grid: 2, voices: 4, gain: 0.3, decay: 0.28, bright: 7, pattern: arp(G_CHORDS, [0, 1, 2, 1, 3, 2, 1, 2], { transpose: 12 }) },
20
+ { name: 'pad', kind: 'pad', grid: 2, tones: 3, wave: 'warm', cutoff: 1600, attack: 0.25, detune: 6, gain: 0.22, pattern: chords(G_CHORDS) },
21
+ { name: 'shaker', kind: 'perc', sound: 'shaker', grid: 2, gain: 0.1, pattern: hits('.x.x.x.x', 64) },
22
+ { name: 'knock', kind: 'perc', sound: 'knock', hz: 330, grid: 2, gain: 0.16, pattern: hits('..X...X.', 64) },
23
+ ],
24
+ };
25
+
26
+ // B: "Bounce" -- 126 BPM, D major: sixteenth-note marimba, a bright whistle
27
+ // lead, a clap on 2 and 4 and a soft pad.
28
+ const D_CHORDS = (len) => [`A3 D4 F#4 / ${len}`, `A3 C#4 E4 / ${len}`, `B3 D4 F#4 / ${len}`, `B3 D4 G4 / ${len}`, `A3 D4 F#4 / ${len}`, `A3 C#4 E4 / ${len}`, `B3 D4 G4 / ${len}`, `A3 C#4 E4 / ${len}`];
29
+ export const SQUARE_B = {
30
+ bpm: 126,
31
+ tracks: [
32
+ { name: 'lead (whistle)', kind: 'lead', grid: 2, wave: 'flute', gain: 0.38, vibrato: 16, vibratoHz: 5.8, glide: 0.02, attack: 0.012, gate: 0.8, release: 0.04, pattern: melody(`
33
+ F#5:2 A5:2 D6:3 C#6 | B5:2 A5 E5 C#5:4 | D5:2 F#5 B5 A5:2 F#5:2 | G5:3 F#5 E5:4 |
34
+ F#5:2 A5:2 D6:2 E6:2 | C#6:2 B5 A5 E5:2 A5:2 | B5:2 G5 E5 D5:2 E5:2 | C#6:2 B5:2 A5:4`) },
35
+ { name: 'marimba', kind: 'mallet', grid: 4, voices: 4, gain: 0.3, decay: 0.16, ratio: 4, overtone: 0.22, pattern: arp(D_CHORDS(16), [0, 1, 2, 3, 2, 1, 2, 3, 0, 1, 2, 3, 4, 3, 2, 1], { transpose: 12 }) },
36
+ { name: 'pad', kind: 'pad', grid: 2, tones: 3, wave: 'warm', cutoff: 1800, attack: 0.2, detune: 7, gain: 0.18, pattern: chords(D_CHORDS(8)) },
37
+ { name: 'clap', kind: 'perc', sound: 'clap', grid: 2, gain: 0.13, pattern: hits('..x...x.', 64) },
38
+ { name: 'shaker', kind: 'perc', sound: 'shaker', grid: 4, gain: 0.07, offset: 0.9, pattern: hits('x.X.', 128) },
39
+ ],
40
+ };
41
+
42
+
43
+ // Synth pads to lay under Hollow End's shipped music (the kit's "night" bed:
44
+ // sine notes on D minor pentatonic from D3, 1.8 s each, eight to a bar). The
45
+ // pads keep that bar: one beat is one of the kit's notes (1.8 s), so a pad
46
+ // bar is 14.4 s, and the chords hold only notes that sit under D, F, G, A, C.
47
+ // Every pad tone is 220 Hz or higher; the kit's own notes are unchanged.
48
+
49
+ const BEAT = 60 / 1.8;
50
+
51
+ // A: four warm chords, one every two of the kit's notes (Dm, Bb, F, C).
52
+ export const HOLLOW_PAD_A = {
53
+ bpm: BEAT,
54
+ tracks: [
55
+ { name: 'warm pad', kind: 'pad', grid: 1, tones: 3, wave: 'warm', cutoff: 1100, attack: 1.1, glide: 0.25, detune: 6, gain: 0.5, pattern: chords(['A3 D4 F4 / 2', 'Bb3 D4 F4 / 2', 'A3 C4 F4 / 2', 'C4 E4 G4 / 2']) },
56
+ ],
57
+ };
58
+
59
+ // B: two wide seventh chords (Dm7, Bbmaj7), a soft-saw pad whose filter
60
+ // breathes slowly open and shut.
61
+ export const HOLLOW_PAD_B = {
62
+ bpm: BEAT,
63
+ tracks: [
64
+ { name: 'breathing pad', kind: 'pad', grid: 1, tones: 4, wave: 'softsaw', cutoff: 1300, q: 1.2, sweepHz: 0.07, sweepDepth: 550, attack: 1.6, glide: 0.4, detune: 10, gain: 0.45, pattern: chords(['D4 F4 A4 C5 / 4', 'Bb3 D4 F4 A4 / 4']) },
65
+ ],
66
+ };
67
+
68
+
69
+ // Sunny Side's music, round 2: upbeat and pastoral -- bright, melodic,
70
+ // plucked and mallet leads, light soft percussion, simple chords. Our own
71
+ // melodies, written for this. Every voice's fundamental is 220 Hz or higher.
72
+
73
+ const C_CHORDS = ['C4 E4 G4 / 8', 'B3 E4 G4 / 8', 'A3 C4 F4 / 8', 'B3 D4 G4 / 8', 'A3 C4 E4 / 8', 'A3 C4 F4 / 8', 'A3 D4 F4 / 4', 'B3 D4 G4 / 4', 'C4 E4 G4 / 8'];
74
+
75
+ // A: "Garden walk" -- 112 BPM, C major, 4/4: marimba arpeggios, a flute lead,
76
+ // a soft hand drum and a shaker, a quiet pad.
77
+ export const SUNNY_A = {
78
+ bpm: 112,
79
+ tracks: [
80
+ { name: 'lead (flute)', kind: 'lead', grid: 2, wave: 'flute', gain: 0.4, vibrato: 12, glide: 0.03, attack: 0.02, gate: 0.86, release: 0.06, pattern: melody(`
81
+ E5 G5 C6:2 B5 G5 E5:2 | G5:3 E5 D5:2 E5:2 | F5 A5 C6 A5 G5:2 F5:2 | D5:2 G5:2 B5:3 r |
82
+ C6 B5 A5 E5 A5:2 C6:2 | A5:2 G5 F5 C5:4 | D5 F5 A5 F5 G5 B5 D6 B5 | C6:6 r:2`) },
83
+ { name: 'marimba', kind: 'mallet', grid: 2, voices: 3, gain: 0.34, decay: 0.24, ratio: 4, overtone: 0.2, pattern: arp(C_CHORDS, [0, 1, 2, 1, 3, 2, 1, 2]) },
84
+ { name: 'pad', kind: 'pad', grid: 2, tones: 3, wave: 'warm', cutoff: 1500, attack: 0.3, detune: 6, gain: 0.16, pattern: chords(C_CHORDS) },
85
+ { name: 'hand drum', kind: 'perc', sound: 'knock', hz: 262, grid: 2, gain: 0.17, pattern: hits('X...x.x.', 64) },
86
+ { name: 'shaker', kind: 'perc', sound: 'shaker', grid: 2, gain: 0.08, pattern: hits('.x.x.x.x', 64) },
87
+ ],
88
+ };
89
+
90
+ // B: "Meadow jig" -- 6/8 at 92 dotted beats a minute, F major: a plucked
91
+ // harp, an ocarina lead, a woodblock and a shaker. Sixteen bars.
92
+ const F_HALF = ['A3 C4 F4 / 6', 'Bb3 D4 F4 / 6', 'A3 C4 F4 / 6', 'C4 E4 G4 / 6', 'A3 D4 F4 / 6', 'Bb3 D4 F4 / 6', 'C4 E4 G4 / 6', 'A3 C4 F4 / 6'];
93
+ const F_CHORDS = [...F_HALF, ...F_HALF];
94
+ export const SUNNY_B = {
95
+ bpm: 92,
96
+ tracks: [
97
+ { name: 'lead (ocarina)', kind: 'lead', grid: 3, wave: 'flute', cutoff: 5000, gain: 0.4, vibrato: 14, vibratoHz: 5.6, glide: 0.025, attack: 0.015, gate: 0.8, release: 0.05, pattern: melody(`
98
+ A5:2 C6 A5:2 F5 | D6:2 C6 Bb5:2 A5 | A5:2 F5 C5:3 | E5:2 G5 C6:2 Bb5 |
99
+ A5:2 F5 D5:2 F5 | G5 A5 Bb5 D6:3 | C6:2 Bb5 G5:2 E5 | F5:3 r:3 |
100
+ C6:2 A5 F5:2 A5 | Bb5:2 D6 F6:2 D6 | C6:2 A5 F5:3 | G5:2 A5 Bb5:2 G5 |
101
+ F5:2 A5 D6:2 C6 | Bb5:2 A5 G5:2 F5 | E5 G5 C6:2 Bb5:2 | F5:6`) },
102
+ { name: 'harp', kind: 'pluck', grid: 3, voices: 4, gain: 0.32, decay: 0.35, bright: 8, dark: 2, pattern: arp(F_CHORDS, [0, 1, 2, 3, 2, 1]) },
103
+ { name: 'woodblock', kind: 'perc', sound: 'block', hz: 880, grid: 3, gain: 0.12, pattern: hits('X..x..', 96) },
104
+ { name: 'shaker', kind: 'perc', sound: 'shaker', grid: 3, gain: 0.07, pattern: hits('..x..x', 96) },
105
+ ],
106
+ };
107
+
108
+
109
+ // The Harbour's music, round 2: more than a bass synth -- a lilting 6/8 with a
110
+ // reedy concertina-like lead, a plucked guitar-like arpeggio, a warm pad and a
111
+ // soft brush on each dotted beat. F major, as the shipped bed. Our own melody.
112
+ // Every voice's fundamental is 220 Hz or higher.
113
+
114
+ const HARBOUR_CHORDS = ['A3 C4 F4 / 6', 'C4 E4 G4 / 6', 'A3 D4 F4 / 6', 'Bb3 D4 F4 / 6', 'A3 C4 F4 / 6', 'C4 E4 G4 / 6', 'Bb3 D4 F4 / 3', 'C4 E4 G4 / 3', 'A3 C4 F4 / 6'];
115
+
116
+ export const HARBOUR = {
117
+ bpm: 58,
118
+ tracks: [
119
+ { name: 'lead (reed)', kind: 'lead', grid: 3, wave: 'reed', cutoff: 3200, gain: 0.3, vibrato: 7, vibratoHz: 4.6, glide: 0.04, attack: 0.035, gate: 0.9, release: 0.09, pattern: melody(`
120
+ C5:3 A5:2 G5 | G5:2 E5 C5:3 | D5:2 F5 A5:2 G5 | F5:3 D5:3 |
121
+ A5:2 C6 C6:2 A5 | G5:2 E5 G5:3 | F5 D5 F5 E5 G5 C6 | A5:3 F5:3`) },
122
+ { name: 'guitar arps', kind: 'pluck', grid: 3, voices: 4, gain: 0.3, decay: 0.45, bright: 5, dark: 1.8, pattern: arp(HARBOUR_CHORDS, [0, 1, 2, 3, 2, 1]) },
123
+ { name: 'pad', kind: 'pad', grid: 3, tones: 3, wave: 'warm', cutoff: 1300, attack: 0.5, glide: 0.12, detune: 6, gain: 0.2, pattern: chords(HARBOUR_CHORDS) },
124
+ { name: 'brush', kind: 'perc', sound: 'brush', grid: 3, gain: 0.07, pattern: hits('X..x..', 48) },
125
+ ],
126
+ };
127
+
@@ -0,0 +1,63 @@
1
+ // Selected round-3 audition scores, unchanged notes, tracks and tempos.
2
+ import { melody, chords, arp, hits } from './soundscapeMusicEngine.js';
3
+
4
+ const G_MIX = ['B3 D4 G4 / 8', 'A3 C4 F4 / 8', 'C4 E4 G4 / 8', 'B3 D4 G4 / 8'];
5
+ export const STADIUM_1 = {
6
+ bpm: 126,
7
+ tracks: [
8
+ { name: 'lead (brass)', kind: 'lead', grid: 2, wave: 'softsaw', cutoff: 3400, gain: 0.3, vibrato: 8, glide: 0.02, attack: 0.012, gate: 0.8, release: 0.05, pattern: melody(`
9
+ G5:2 B5 D6:2 B5 A5 G5 | F5:2 A5 C6:3 A5 G5 | E5 G5 C6:2 D6 C6 B5 G5 | D6:3 B5 G5:2 F5 G5 |
10
+ G5 G5 B5 D6 E6:2 D6 B5 | C6:2 A5 F5 A5:2 C6 A5 | G5:2 E5 G5 C6:2 E6 D6 | B5:2 A5 G5 F5:2 G5:2`) },
11
+ { name: 'pumping pad', kind: 'pad', grid: 2, tones: 3, wave: 'softsaw', cutoff: 2600, attack: 0.06, detune: 9, gain: 0.26, pump: 0.55, pattern: chords([...G_MIX, ...G_MIX]) },
12
+ { name: 'stabs', kind: 'pluck', grid: 2, voices: 3, gain: 0.2, decay: 0.1, bright: 6, pattern: arp([...G_MIX, ...G_MIX], [2, 2, 2, 2], { skip: '.x', transpose: 12 }) },
13
+ { name: 'knock', kind: 'perc', sound: 'knock', hz: 247, grid: 2, gain: 0.16, pattern: hits('X.x.X.x.', 64) },
14
+ { name: 'clap', kind: 'perc', sound: 'clap', grid: 2, gain: 0.17, pattern: hits('..x...x.', 64) },
15
+ { name: 'hat', kind: 'perc', sound: 'hat', grid: 4, gain: 0.07, pattern: hits('..x.', 128) },
16
+ ],
17
+ };
18
+
19
+
20
+ const A_MIX = ['A3 C#4 E4 / 8', 'B3 D4 G4 / 8', 'A3 D4 F#4 / 8', 'A3 C#4 E4 / 8'];
21
+ export const STADIUM_3 = {
22
+ bpm: 132,
23
+ tracks: [
24
+ { name: 'lead (bright)', kind: 'lead', grid: 2, wave: 'softsaw', cutoff: 4200, gain: 0.26, vibrato: 6, glide: 0.015, attack: 0.008, gate: 0.6, release: 0.04, pattern: melody(`
25
+ E5 A5 C#6 A5 E6:2 C#6 A5 | D6:2 B5 G5 B5 D6 G6:2 | F#6:2 E6 D6 A5:2 F#5 A5 | G5:2 A5:2 r:2 E5 G5 |
26
+ A5 A5 C#6 E6 A6:2 G6 E6 | D6 B5 D6 G6:2 F#6 D6 B5 | A5:2 D6 F#6 E6:2 D6 C#6 | E6:2 G5:2 A5:4`) },
27
+ { name: 'pumping pad', kind: 'pad', grid: 2, tones: 3, wave: 'softsaw', cutoff: 2400, attack: 0.05, detune: 10, gain: 0.24, pump: 0.6, pattern: chords([...A_MIX, ...A_MIX]) },
28
+ { name: 'off-beat stabs', kind: 'pluck', grid: 2, voices: 3, gain: 0.24, decay: 0.09, bright: 7, pattern: arp([...A_MIX, ...A_MIX], [1, 1, 1, 1], { skip: '.x', transpose: 12 }) },
29
+ { name: 'clap', kind: 'perc', sound: 'clap', grid: 2, gain: 0.18, pattern: hits('..x...x.', 64) },
30
+ { name: 'shaker', kind: 'perc', sound: 'shaker', grid: 4, gain: 0.06, pattern: hits('xXxx', 128) },
31
+ ],
32
+ };
33
+
34
+
35
+ const G_WALTZ = ['B3 D4 G4 / 6', 'C4 E4 G4 / 6', 'B3 D4 G4 / 6', 'A3 D4 F#4 / 6'];
36
+ export const HARBOUR_B = {
37
+ bpm: 100,
38
+ tracks: [
39
+ { name: 'lead (flute)', kind: 'lead', grid: 2, wave: 'flute', cutoff: 5000, gain: 0.4, vibrato: 14, vibratoHz: 5.2, glide: 0.035, attack: 0.03, gate: 0.88, release: 0.08, pattern: melody(`
40
+ D5:2 G5 A5 B5:2 | E5:2 G5:2 E5 D5 | G5:2 B5 A5 G5:2 | A5:4 r:2 |
41
+ B5:2 D6 B5 A5:2 | G5:2 E5 G5 A5:2 | B5 A5 G5:2 E5 D5 | G5:6`) },
42
+ { name: 'harp', kind: 'pluck', grid: 2, voices: 4, gain: 0.3, decay: 0.4, bright: 7, dark: 2, pattern: arp([...G_WALTZ, ...G_WALTZ], [0, 1, 2, 3, 2, 1]) },
43
+ { name: 'pad', kind: 'pad', grid: 2, tones: 3, wave: 'warm', cutoff: 1400, attack: 0.4, glide: 0.1, detune: 6, gain: 0.18, pattern: chords([...G_WALTZ, ...G_WALTZ]) },
44
+ { name: 'woodblock', kind: 'perc', sound: 'block', hz: 880, grid: 2, gain: 0.09, pattern: hits('X.....', 48) },
45
+ { name: 'shaker', kind: 'perc', sound: 'shaker', grid: 2, gain: 0.06, pattern: hits('..x.x.', 48) },
46
+ ],
47
+ };
48
+
49
+
50
+ const C_JIG = ['C4 E4 G4 / 6', 'Bb3 D4 F4 / 6', 'A3 C4 F4 / 6', 'C4 E4 G4 / 6'];
51
+ export const HARBOUR_C = {
52
+ bpm: 76,
53
+ tracks: [
54
+ { name: 'lead (reed)', kind: 'lead', grid: 3, wave: 'reed', cutoff: 3600, gain: 0.28, vibrato: 7, vibratoHz: 5, glide: 0.03, attack: 0.02, gate: 0.82, release: 0.06, pattern: melody(`
55
+ G5:2 E5 G5:2 C6 | D6:2 Bb5 F5:2 Bb5 | A5:2 C6 F5:2 A5 | G5:3 E5:3 |
56
+ C6:2 D6 E6:2 C6 | D6:2 C6 Bb5:2 G5 | A5 G5 F5 A5:2 C6 | G5:3 C6:3`) },
57
+ { name: 'marimba', kind: 'mallet', grid: 3, voices: 3, gain: 0.32, decay: 0.22, ratio: 4, overtone: 0.2, pattern: arp([...C_JIG, ...C_JIG], [0, 1, 2, 3, 2, 1]) },
58
+ { name: 'pad', kind: 'pad', grid: 3, tones: 3, wave: 'warm', cutoff: 1400, attack: 0.35, glide: 0.1, detune: 6, gain: 0.17, pattern: chords([...C_JIG, ...C_JIG]) },
59
+ { name: 'woodblock', kind: 'perc', sound: 'block', hz: 784, grid: 3, gain: 0.1, pattern: hits('X..x..', 48) },
60
+ { name: 'shaker', kind: 'perc', sound: 'shaker', grid: 3, gain: 0.06, pattern: hits('.xx.xx', 48) },
61
+ ],
62
+ };
63
+
@@ -0,0 +1,168 @@
1
+ // Small helpers every round-2 generator uses. No samples: noise is made from a
2
+ // seeded generator, tones from band-limited PeriodicWaves with a handful of
3
+ // harmonics (never the raw sawtooth/square), so nothing aliases on any pitch
4
+ // these generators use.
5
+
6
+ export const clamp = (v, lo, hi) => Math.min(hi, Math.max(lo, v));
7
+ export const num = (v, fallback) => (typeof v === 'number' && Number.isFinite(v) ? v : fallback);
8
+ export const midiHz = (m) => 440 * 2 ** ((m - 69) / 12);
9
+
10
+ // FNV-1a and mulberry32, as the kit's soundscape has them.
11
+ export function hashOf(text) {
12
+ let h = 0x811c9dc5;
13
+ const s = String(text);
14
+ for (let i = 0; i < s.length; i += 1) {
15
+ h ^= s.charCodeAt(i);
16
+ h = Math.imul(h, 0x01000193);
17
+ }
18
+ return h >>> 0;
19
+ }
20
+
21
+ export function seeded(seed) {
22
+ let a = seed >>> 0;
23
+ return () => {
24
+ a = (a + 0x6d2b79f5) >>> 0;
25
+ let t = a;
26
+ t = Math.imul(t ^ (t >>> 15), t | 1);
27
+ t ^= t + Math.imul(t ^ (t >>> 7), t | 61);
28
+ return ((t ^ (t >>> 14)) >>> 0) / 4294967296;
29
+ };
30
+ }
31
+
32
+ // Two seconds of white noise per context, made once and shared.
33
+ const noises = new WeakMap();
34
+ export function noiseOf(context) {
35
+ const ctx = context.context ?? context;
36
+ let buffer = noises.get(ctx);
37
+ if (!buffer) {
38
+ const n = Math.floor(ctx.sampleRate * 2);
39
+ buffer = ctx.createBuffer(1, n, ctx.sampleRate);
40
+ const data = buffer.getChannelData(0);
41
+ const next = seeded(0x2a0d5);
42
+ for (let i = 0; i < n; i += 1) {
43
+ data[i] = next() * 2 - 1;
44
+ }
45
+ noises.set(ctx, buffer);
46
+ }
47
+ return buffer;
48
+ }
49
+
50
+ // Band-limited waves by name, one per context. Each lists its harmonics'
51
+ // amplitudes (sine phase); the top harmonic times the highest pitch a
52
+ // generator plays stays under 10 kHz.
53
+ const SHAPES = {
54
+ // A soft "glottal" buzz for voices: 1/n^1.5, 14 harmonics.
55
+ glottal: Array.from({ length: 14 }, (_, i) => 1 / (i + 1) ** 1.5),
56
+ // A rounder voice: falls off faster.
57
+ round: Array.from({ length: 10 }, (_, i) => 1 / (i + 1) ** 2.2),
58
+ // A plucked string's spectrum at the pluck: 1/n^1.2, 10 harmonics.
59
+ pluck: Array.from({ length: 10 }, (_, i) => 1 / (i + 1) ** 1.2),
60
+ // A flute / ocarina: mostly fundamental, a breath of 2nd and 3rd.
61
+ flute: [1, 0.22, 0.07, 0.03],
62
+ // A soft saw for pads and leads: 1/n, 8 harmonics.
63
+ softsaw: Array.from({ length: 8 }, (_, i) => 1 / (i + 1)),
64
+ // A reed (concertina-like): odd harmonics strong, a little even.
65
+ reed: [1, 0.12, 0.42, 0.08, 0.24, 0.05, 0.14, 0.03],
66
+ // A warm pad: triangle-like, odd harmonics 1/n^2.
67
+ warm: [1, 0, 1 / 9, 0, 1 / 25, 0, 1 / 49],
68
+ };
69
+ const waves = new WeakMap();
70
+ export function waveOf(context, name) {
71
+ const ctx = context.context ?? context;
72
+ let set = waves.get(ctx);
73
+ if (!set) {
74
+ set = new Map();
75
+ waves.set(ctx, set);
76
+ }
77
+ let wave = set.get(name);
78
+ if (!wave) {
79
+ const amps = Object.hasOwn(SHAPES, name) ? SHAPES[name] : SHAPES.glottal;
80
+ const real = new Float32Array(amps.length + 1);
81
+ const imag = new Float32Array(amps.length + 1);
82
+ for (let i = 0; i < amps.length; i += 1) {
83
+ imag[i + 1] = amps[i];
84
+ }
85
+ wave = ctx.createPeriodicWave(real, imag);
86
+ set.set(name, wave);
87
+ }
88
+ return wave;
89
+ }
90
+
91
+ export function osc(ctx, wave, frequency = 440) {
92
+ const o = ctx.createOscillator();
93
+ if (wave === 'sine') {
94
+ o.type = 'sine';
95
+ } else {
96
+ o.setPeriodicWave(waveOf(ctx, wave));
97
+ }
98
+ o.frequency.value = frequency;
99
+ return o;
100
+ }
101
+
102
+ export function gain(ctx, value = 0) {
103
+ const g = ctx.createGain();
104
+ g.gain.value = value;
105
+ return g;
106
+ }
107
+
108
+ export function filter(ctx, type, frequency, q = 0.7) {
109
+ const f = ctx.createBiquadFilter();
110
+ f.type = type;
111
+ f.frequency.value = frequency;
112
+ f.Q.value = q;
113
+ return f;
114
+ }
115
+
116
+ // A looped noise source started at an offset (so two never coincide).
117
+ export function noise(ctx, offset = 0) {
118
+ const src = ctx.createBufferSource();
119
+ src.buffer = noiseOf(ctx);
120
+ src.loop = true;
121
+ src._offset = offset % 2;
122
+ return src;
123
+ }
124
+
125
+ // Stops and disconnects every node; safe to call twice.
126
+ export function release(nodes) {
127
+ for (const node of nodes) {
128
+ try {
129
+ node.stop?.();
130
+ } catch {
131
+ // Not started, or over.
132
+ }
133
+ try {
134
+ node.disconnect();
135
+ } catch {
136
+ // Already out.
137
+ }
138
+ }
139
+ }
140
+
141
+ // Starts sources by their node interface, including a noise source's offset.
142
+ export function startAll(nodes, t) {
143
+ for (const node of nodes) {
144
+ if (typeof node.start === 'function') {
145
+ if (node.buffer) {
146
+ node.start(t, node._offset ?? 0);
147
+ } else {
148
+ node.start(t);
149
+ }
150
+ }
151
+ }
152
+ }
153
+
154
+ // Records partial graphs too, so a failed construction releases every node.
155
+ export function tracked(context, nodes) {
156
+ return {
157
+ context: context.context ?? context,
158
+ get currentTime() { return context.currentTime; },
159
+ sampleRate: context.sampleRate,
160
+ createBuffer: (...args) => context.createBuffer(...args),
161
+ createPeriodicWave: (...args) => context.createPeriodicWave(...args),
162
+ ...Object.fromEntries(['createOscillator', 'createGain', 'createBiquadFilter', 'createBufferSource', 'createDelay'].map((name) => [name, (...args) => {
163
+ const node = context[name](...args);
164
+ nodes.push(node);
165
+ return node;
166
+ }])),
167
+ };
168
+ }
@@ -0,0 +1,211 @@
1
+ // UI cues (v1.49) and named cues (v1.50), each behind its own opt-in key.
2
+ // Two small graphs at most, four starts in any rolling second. The audio clock reaps ended voices
3
+ // even without an ended callback; an idle frame allocates nothing.
4
+
5
+ import { makeCueVoice } from './soundscapeCues.js';
6
+
7
+ const CUES = {
8
+ tap: { duration: 0.065, from: 1800, to: 1200, gain: 0.025, wave: 'triangle' },
9
+ door: { duration: 0.12, from: 320, to: 1700, gain: 0.045, noise: true },
10
+ arrive: { duration: 0.32, from: 440, to: 660, gain: 0.035, wave: 'sine', pair: true },
11
+ activity: { duration: 0.18, from: 620, to: 930, gain: 0.028, wave: 'sine' },
12
+ };
13
+
14
+ function stop(voice) {
15
+ if (voice.stop) {
16
+ voice.stop();
17
+ return;
18
+ }
19
+ for (const node of voice.nodes) {
20
+ try {
21
+ node.stop?.();
22
+ } catch {
23
+ // Already over, or never started.
24
+ }
25
+ node.disconnect();
26
+ }
27
+ }
28
+
29
+ export function makeUi({ ready, context, bus, noise, live, canArrive, failed }) {
30
+ const voices = [];
31
+ const starts = new Float64Array(4).fill(-Infinity);
32
+ let next = 0;
33
+ let arrivalAt = null;
34
+ let timerSeen = false;
35
+ let timerSince = null;
36
+ let timerUntil = null;
37
+
38
+ function reap() {
39
+ const ctx = context();
40
+ if (!ctx) {
41
+ return;
42
+ }
43
+ for (let i = voices.length - 1; i >= 0; i -= 1) {
44
+ if (voices[i].until <= ctx.currentTime) {
45
+ stop(voices[i]);
46
+ voices.splice(i, 1);
47
+ } else if (voices[i].frame) {
48
+ try {
49
+ voices[i].frame(ctx.currentTime);
50
+ } catch (err) {
51
+ stop(voices[i]);
52
+ voices.splice(i, 1);
53
+ failed(err);
54
+ }
55
+ }
56
+ }
57
+ }
58
+
59
+ function cue(name, now) {
60
+ if (!Number.isFinite(now) || typeof name !== 'string' || !Object.hasOwn(CUES, name) || !live()) {
61
+ return false;
62
+ }
63
+ reap();
64
+ if (voices.length >= 2 && voices.every((voice) => voice.priority >= 2)) {
65
+ return false;
66
+ }
67
+ const ctx = ready(now);
68
+ if (!ctx) {
69
+ return false;
70
+ }
71
+ const t = ctx.currentTime;
72
+ if (t - starts[next] < 1) {
73
+ return false;
74
+ }
75
+ const p = CUES[name];
76
+ const nodes = [];
77
+ try {
78
+ const source = p.noise ? ctx.createBufferSource() : ctx.createOscillator();
79
+ nodes.push(source);
80
+ let tone = source;
81
+ if (p.noise) {
82
+ source.buffer = noise(ctx);
83
+ tone = ctx.createBiquadFilter();
84
+ nodes.push(tone);
85
+ tone.type = 'bandpass';
86
+ tone.Q.value = 0.7;
87
+ source.connect(tone);
88
+ } else {
89
+ source.type = p.wave;
90
+ }
91
+ const env = ctx.createGain();
92
+ nodes.push(env);
93
+ env.gain.value = 0;
94
+ tone.connect(env);
95
+ env.connect(bus());
96
+ tone.frequency.setValueAtTime(p.from, t);
97
+ env.gain.setValueAtTime(0, t);
98
+ env.gain.linearRampToValueAtTime(p.gain, t + (p.noise ? 0.035 : 0.008));
99
+ if (p.pair) {
100
+ env.gain.linearRampToValueAtTime(0, t + 0.14);
101
+ tone.frequency.setValueAtTime(p.to, t + 0.16);
102
+ env.gain.setValueAtTime(0, t + 0.16);
103
+ env.gain.linearRampToValueAtTime(p.gain * 0.8, t + 0.168);
104
+ } else {
105
+ tone.frequency.exponentialRampToValueAtTime(p.to, t + p.duration * 0.8);
106
+ }
107
+ env.gain.linearRampToValueAtTime(0, t + p.duration);
108
+ const voice = { name, nodes, priority: 2, until: t + p.duration };
109
+ source.onended = () => {
110
+ const at = voices.indexOf(voice);
111
+ if (at >= 0) {
112
+ voices.splice(at, 1);
113
+ stop(voice);
114
+ }
115
+ };
116
+ if (voices.length >= 2) {
117
+ stop(voices.splice(voices.findIndex((v) => v.priority < 2), 1)[0]);
118
+ }
119
+ source.start(t);
120
+ source.stop(t + p.duration);
121
+ voices.push(voice);
122
+ starts[next] = t;
123
+ next = (next + 1) % starts.length;
124
+ return true;
125
+ } catch (err) {
126
+ stop({ nodes });
127
+ failed(err);
128
+ return false;
129
+ }
130
+ }
131
+
132
+ return {
133
+ cue,
134
+ play(name, synth, now, gain = 1, priority = 2) {
135
+ if (typeof synth !== 'function' || !Number.isFinite(now) || !Number.isFinite(gain) || gain <= 0 || gain > 1 || !live()) {
136
+ return false;
137
+ }
138
+ reap();
139
+ const ctx = ready(now);
140
+ if (!ctx || ctx.currentTime - starts[next] < 1) {
141
+ return false;
142
+ }
143
+ let replace = -1;
144
+ if (voices.length >= 2) {
145
+ replace = voices.findIndex((voice) => voice.priority < priority);
146
+ if (replace < 0) { return false; }
147
+ }
148
+ let voice = null;
149
+ try {
150
+ voice = makeCueVoice(synth, ctx, bus(), ctx.currentTime, gain);
151
+ voice.name = name;
152
+ voice.priority = priority;
153
+ if (replace >= 0) { stop(voices.splice(replace, 1)[0]); }
154
+ voice.frame(ctx.currentTime);
155
+ voices.push(voice);
156
+ starts[next] = ctx.currentTime;
157
+ next = (next + 1) % starts.length;
158
+ return true;
159
+ } catch (err) {
160
+ if (voice) { stop(voice); }
161
+ failed(err);
162
+ return false;
163
+ }
164
+ },
165
+ arrive(now) {
166
+ // Only arrival waits, only for settling. A hidden, muted or untouched
167
+ // page never saves an arrival for a later gesture or interruption.
168
+ arrivalAt = Number.isFinite(now) && canArrive() ? now : null;
169
+ },
170
+ frame(now, on, hud, completed = false) {
171
+ reap();
172
+ if (arrivalAt !== null) {
173
+ if (!Number.isFinite(now) || now < arrivalAt || now - arrivalAt > 3000 || !canArrive()) {
174
+ arrivalAt = null;
175
+ } else if (on) {
176
+ arrivalAt = null;
177
+ cue('arrive', now);
178
+ }
179
+ }
180
+ // Observe the private timer once, after the transport drain. The first
181
+ // frame's baseline is the same in either drain order.
182
+ if (!completed) {
183
+ return;
184
+ }
185
+ const since = Number.isFinite(hud?.timer?.since) ? hud.timer.since : null;
186
+ const until = since === null && Number.isFinite(hud?.timer?.until) ? hud.timer.until : null;
187
+ if (timerSeen && (since !== null || until !== null) && (since !== timerSince || until !== timerUntil) && on) {
188
+ cue('activity', now);
189
+ }
190
+ timerSeen = true;
191
+ timerSince = since;
192
+ timerUntil = until;
193
+ },
194
+ quiet(departing = false) {
195
+ for (let i = voices.length - 1; i >= 0; i -= 1) {
196
+ if (!departing || voices[i].name !== 'door') {
197
+ stop(voices[i]);
198
+ voices.splice(i, 1);
199
+ }
200
+ }
201
+ if (!canArrive()) {
202
+ arrivalAt = null;
203
+ }
204
+ },
205
+ dispose() {
206
+ this.quiet();
207
+ arrivalAt = null;
208
+ },
209
+ counts: () => ({ voices: voices.length, nodes: voices.reduce((total, voice) => total + voice.nodes.length, 0), arrival: arrivalAt !== null }),
210
+ };
211
+ }