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,460 @@
1
+ // A small looping music engine for zone beds, round 2.
2
+ //
3
+ // const music = makeMusic(context, destination, song, { level, seed })
4
+ // music.frame(t) // call once a frame with the context's time; schedules
5
+ // // at most LOOKAHEAD_S ahead, allocates nothing
6
+ // music.stop() // stops and disconnects every node
7
+ // music.nodes // how many nodes it holds (fixed for its life)
8
+ // music.lowestHz() // the lowest fundamental any voice plays, per track
9
+ //
10
+ // A song is data (see the music*.js modules): a tempo, a loop length and
11
+ // tracks. Every node is made once, when the song starts: plucks and mallets
12
+ // are small pools of voices taken in turn, a lead is one voice, a pad holds
13
+ // its chord tones, percussion is one shared-noise or one tone voice. Notes are
14
+ // gain and frequency automation on those nodes, so a steady state builds
15
+ // nothing. Every tone is a band-limited PeriodicWave (shared.js) or a sine.
16
+
17
+ import { clamp, midiHz, seeded, osc, gain, filter, noise, release, startAll, tracked } from './soundscapeSynthesis.js';
18
+
19
+ export const LOOKAHEAD_S = 0.3;
20
+
21
+ // --- notation ----------------------------------------------------------------
22
+
23
+ const NOTE = /^([A-G])([#b]?)(-?\d)$/;
24
+ const PITCH = { C: 0, D: 2, E: 4, F: 5, G: 7, A: 9, B: 11 };
25
+
26
+ export function noteMidi(name) {
27
+ const m = NOTE.exec(name);
28
+ if (!m) {
29
+ throw new Error(`bad note ${name}`);
30
+ }
31
+ return 12 * (Number(m[3]) + 1) + PITCH[m[1]] + (m[2] === '#' ? 1 : m[2] === 'b' ? -1 : 0);
32
+ }
33
+
34
+ // "D5:2 G5 F#5 r:2 B5:3!" -> [{ step, midi, len, vel }], length in steps.
35
+ // `:n` a length in steps (default 1), `r` a rest, `!` an accent, `|` a bar
36
+ // line (ignored, for reading).
37
+ export function melody(text) {
38
+ const events = [];
39
+ let step = 0;
40
+ for (const raw of text.trim().split(/\s+/)) {
41
+ if (raw === '|') {
42
+ continue;
43
+ }
44
+ const accent = raw.endsWith('!');
45
+ const token = accent ? raw.slice(0, -1) : raw;
46
+ const [name, len = '1'] = token.split(':');
47
+ const n = Number(len);
48
+ if (name !== 'r') {
49
+ events.push({ step, midi: noteMidi(name), len: n, vel: accent ? 1 : 0.82 });
50
+ }
51
+ step += n;
52
+ }
53
+ return { events, steps: step };
54
+ }
55
+
56
+ // Chords: "Bb3 D4 F4 / 8" lines -> [{ step, midis, len }].
57
+ export function chords(list) {
58
+ const events = [];
59
+ let step = 0;
60
+ for (const line of list) {
61
+ const [notes, len] = line.split('/');
62
+ events.push({ step, midis: notes.trim().split(/\s+/).map(noteMidi), len: Number(len), vel: 0.85 });
63
+ step += Number(len);
64
+ }
65
+ return { events, steps: step };
66
+ }
67
+
68
+ // An arpeggio over chord events: `order` indexes into each chord's tones
69
+ // (the chord's own tones, then the same an octave up), one per step.
70
+ export function arp(chordList, order, { skip = '', transpose = 0 } = {}) {
71
+ const c = chords(chordList);
72
+ const events = [];
73
+ for (const ch of c.events) {
74
+ const tones = [...ch.midis, ...ch.midis.map((m) => m + 12)].map((m) => m + transpose);
75
+ for (let i = 0; i < ch.len; i += 1) {
76
+ if (skip && skip[(ch.step + i) % skip.length] === '.') {
77
+ continue;
78
+ }
79
+ const k = order[(ch.step + i) % order.length];
80
+ events.push({ step: ch.step + i, midi: tones[k % tones.length], len: 1, vel: (ch.step + i) % order.length === 0 ? 0.95 : 0.75 });
81
+ }
82
+ }
83
+ return { events, steps: c.steps };
84
+ }
85
+
86
+ // "x..x X.x." -> hits, repeated to `steps`.
87
+ export function hits(pattern, steps) {
88
+ const p = pattern.replace(/\s+/g, '');
89
+ const events = [];
90
+ for (let i = 0; i < steps; i += 1) {
91
+ const c = p[i % p.length];
92
+ if (c === 'x' || c === 'X') {
93
+ events.push({ step: i, midi: 0, len: 1, vel: c === 'X' ? 1 : 0.6 });
94
+ }
95
+ }
96
+ return { events, steps };
97
+ }
98
+
99
+ // --- voices ------------------------------------------------------------------
100
+
101
+ function pluckVoice(ctx, out, t) {
102
+ const o = osc(ctx, t.wave ?? 'pluck');
103
+ const f = filter(ctx, 'lowpass', 2000, t.q ?? 0.8);
104
+ const env = gain(ctx, 0);
105
+ o.connect(f);
106
+ f.connect(env);
107
+ env.connect(out);
108
+ return {
109
+ nodes: [o, f, env],
110
+ play(at, hz, vel, len) {
111
+ env.gain.setTargetAtTime(0, at - 0.012, 0.003);
112
+ o.frequency.setValueAtTime(hz, at);
113
+ f.frequency.setValueAtTime(Math.min(hz * (t.bright ?? 6), 9000), at);
114
+ f.frequency.setTargetAtTime(hz * (t.dark ?? 1.6), at + 0.004, (t.decay ?? 0.3) * 0.4);
115
+ env.gain.setValueAtTime(0, at);
116
+ env.gain.linearRampToValueAtTime(vel, at + (t.attack ?? 0.004));
117
+ env.gain.setTargetAtTime(0, at + (t.attack ?? 0.004), t.decay ?? 0.3);
118
+ if (t.damp) {
119
+ env.gain.setTargetAtTime(0, at + len * t.damp, 0.03);
120
+ }
121
+ },
122
+ };
123
+ }
124
+
125
+ function malletVoice(ctx, out, t) {
126
+ const o = osc(ctx, 'sine');
127
+ const over = osc(ctx, 'sine');
128
+ const overGain = gain(ctx, 0);
129
+ const env = gain(ctx, 0);
130
+ o.connect(env);
131
+ over.connect(overGain);
132
+ overGain.connect(env);
133
+ env.connect(out);
134
+ const ratio = t.ratio ?? 4;
135
+ return {
136
+ nodes: [o, over, overGain, env],
137
+ play(at, hz, vel) {
138
+ env.gain.setTargetAtTime(0, at - 0.012, 0.003);
139
+ o.frequency.setValueAtTime(hz, at);
140
+ over.frequency.setValueAtTime(hz * ratio, at);
141
+ overGain.gain.setValueAtTime(t.overtone ?? 0.25, at);
142
+ overGain.gain.setTargetAtTime(0, at + 0.002, t.overDecay ?? 0.025);
143
+ env.gain.setValueAtTime(0, at);
144
+ env.gain.linearRampToValueAtTime(vel, at + 0.003);
145
+ env.gain.setTargetAtTime(0, at + 0.003, t.decay ?? 0.22);
146
+ },
147
+ };
148
+ }
149
+
150
+ function leadVoice(ctx, out, t) {
151
+ const o = osc(ctx, t.wave ?? 'flute');
152
+ const f = filter(ctx, 'lowpass', t.cutoff ?? 4000, 0.6);
153
+ const env = gain(ctx, 0);
154
+ const vib = osc(ctx, 'sine', t.vibratoHz ?? 5.2);
155
+ const depth = gain(ctx, t.vibrato ?? 10);
156
+ vib.connect(depth);
157
+ depth.connect(o.detune);
158
+ o.connect(f);
159
+ f.connect(env);
160
+ env.connect(out);
161
+ let sounding = false;
162
+ return {
163
+ nodes: [o, f, env, vib, depth],
164
+ reset() { sounding = false; },
165
+ play(at, hz, vel, len, legatoNext) {
166
+ if (sounding) {
167
+ o.frequency.setTargetAtTime(hz, at - 0.01, t.glide ?? 0.03);
168
+ env.gain.setTargetAtTime(vel * 0.8, at - 0.01, 0.02);
169
+ env.gain.setTargetAtTime(vel, at + 0.03, 0.04);
170
+ } else {
171
+ o.frequency.setValueAtTime(hz, at);
172
+ env.gain.setValueAtTime(0, at);
173
+ env.gain.setTargetAtTime(vel, at, t.attack ?? 0.02);
174
+ }
175
+ if (t.sustain !== undefined) {
176
+ env.gain.setTargetAtTime(vel * t.sustain, at + 0.08, len * 0.6);
177
+ }
178
+ sounding = legatoNext;
179
+ if (!legatoNext) {
180
+ env.gain.setTargetAtTime(0, at + len * (t.gate ?? 0.85), t.release ?? 0.06);
181
+ }
182
+ },
183
+ };
184
+ }
185
+
186
+ // A pad of `tones` chord tones, each two detuned oscillators, through one
187
+ // low-pass (optionally swept by a slow LFO) and one level.
188
+ function padVoice(ctx, out, t) {
189
+ const n = t.tones ?? 3;
190
+ const f = filter(ctx, 'lowpass', t.cutoff ?? 1800, t.q ?? 0.7);
191
+ const env = gain(ctx, 0);
192
+ const pump = gain(ctx, 1);
193
+ f.connect(env);
194
+ env.connect(pump);
195
+ pump.connect(out);
196
+ const nodes = [f, env, pump];
197
+ const oscs = [];
198
+ for (let i = 0; i < n; i += 1) {
199
+ for (const cents of t.detune === 0 ? [0] : [0, (t.detune ?? 7) * 2]) {
200
+ const o = osc(ctx, t.wave ?? 'softsaw');
201
+ o.detune.value = cents;
202
+ o.connect(f);
203
+ oscs.push({ o, k: i });
204
+ nodes.push(o);
205
+ }
206
+ }
207
+ const each = 1 / (n * (t.detune === 0 ? 1 : 2));
208
+ if (t.sweepHz) {
209
+ const lfo = osc(ctx, 'sine', t.sweepHz);
210
+ const depth = gain(ctx, t.sweepDepth ?? 600);
211
+ lfo.connect(depth);
212
+ depth.connect(f.frequency);
213
+ nodes.push(lfo, depth);
214
+ }
215
+ let first = true;
216
+ return {
217
+ nodes,
218
+ pump,
219
+ reset() { first = true; },
220
+ play(at, midis, vel) {
221
+ for (const { o, k } of oscs) {
222
+ const m = midis[Math.min(k, midis.length - 1)];
223
+ if (first) {
224
+ o.frequency.setValueAtTime(midiHz(m), at);
225
+ } else {
226
+ o.frequency.setTargetAtTime(midiHz(m), at, t.glide ?? 0.05);
227
+ }
228
+ }
229
+ const level = vel * each * 2.2;
230
+ if (first) {
231
+ env.gain.setValueAtTime(0, at);
232
+ env.gain.setTargetAtTime(level, at, t.attack ?? 0.4);
233
+ first = false;
234
+ } else {
235
+ env.gain.setTargetAtTime(level * 0.75, at - 0.03, 0.03);
236
+ env.gain.setTargetAtTime(level, at + 0.06, (t.attack ?? 0.4) * 0.5);
237
+ }
238
+ },
239
+ };
240
+ }
241
+
242
+ const NOISE_PERC = {
243
+ shaker: { type: 'highpass', f: 6500, q: 0.7, attack: 0.006, decay: 0.022 },
244
+ hat: { type: 'highpass', f: 8000, q: 0.7, attack: 0.002, decay: 0.018 },
245
+ clap: { type: 'bandpass', f: 1400, q: 1.1, attack: 0.001, decay: 0.06, flams: 3 },
246
+ brush: { type: 'bandpass', f: 4000, q: 0.6, attack: 0.03, decay: 0.07 },
247
+ };
248
+ const TONE_PERC = {
249
+ // A soft hand drum: a sine that drops a little, kept above 220 Hz.
250
+ knock: { from: 1.5, decay: 0.07 },
251
+ // A woodblock: high, short.
252
+ block: { from: 1.1, decay: 0.03 },
253
+ };
254
+
255
+ function percVoice(ctx, out, t) {
256
+ if (NOISE_PERC[t.sound]) {
257
+ const p = NOISE_PERC[t.sound];
258
+ const src = noise(ctx, t.offset ?? 0.37);
259
+ const f = filter(ctx, p.type, p.f, p.q);
260
+ const env = gain(ctx, 0);
261
+ src.connect(f);
262
+ f.connect(env);
263
+ env.connect(out);
264
+ return {
265
+ nodes: [src, f, env],
266
+ play(at, hz, vel) {
267
+ env.gain.setTargetAtTime(0, at - 0.006, 0.002);
268
+ if (p.flams) {
269
+ for (let i = 0; i < p.flams; i += 1) {
270
+ const a = at + i * 0.011;
271
+ env.gain.setValueAtTime(vel * (i === p.flams - 1 ? 1 : 0.7), a);
272
+ env.gain.setTargetAtTime(0, a + 0.001, 0.004);
273
+ }
274
+ env.gain.setTargetAtTime(0, at + p.flams * 0.011 + 0.001, p.decay);
275
+ return;
276
+ }
277
+ env.gain.setValueAtTime(0, at);
278
+ env.gain.linearRampToValueAtTime(vel, at + p.attack);
279
+ env.gain.setTargetAtTime(0, at + p.attack, p.decay);
280
+ },
281
+ };
282
+ }
283
+ const p = TONE_PERC[t.sound];
284
+ const o = osc(ctx, 'sine', t.hz);
285
+ const env = gain(ctx, 0);
286
+ o.connect(env);
287
+ env.connect(out);
288
+ return {
289
+ nodes: [o, env],
290
+ play(at, hz, vel) {
291
+ env.gain.setTargetAtTime(0, at - 0.006, 0.002);
292
+ o.frequency.setValueAtTime(t.hz * p.from, at);
293
+ o.frequency.exponentialRampToValueAtTime(t.hz, at + 0.03);
294
+ env.gain.setValueAtTime(0, at);
295
+ env.gain.linearRampToValueAtTime(vel, at + 0.002);
296
+ env.gain.setTargetAtTime(0, at + 0.002, p.decay);
297
+ },
298
+ };
299
+ }
300
+
301
+ // --- the engine --------------------------------------------------------------
302
+
303
+ function buildMusic(context, destination, song, { level = 0.3, seed = 1, beats = 4 } = {}) {
304
+ const ctx = context;
305
+ const next = seeded(seed);
306
+ const master = gain(ctx, level);
307
+ master.connect(destination);
308
+ const all = [master];
309
+ const beat = 60 / song.bpm;
310
+ const tracks = song.tracks.map((t) => {
311
+ const out = gain(ctx, t.gain ?? 0.5);
312
+ out.connect(master);
313
+ all.push(out);
314
+ const pattern = t.pattern;
315
+ const stepS = beat / (t.grid ?? 2);
316
+ let voices;
317
+ if (t.kind === 'pluck' || t.kind === 'mallet') {
318
+ voices = Array.from({ length: t.voices ?? 4 }, () => (t.kind === 'pluck' ? pluckVoice : malletVoice)(ctx, out, t));
319
+ } else if (t.kind === 'lead') {
320
+ voices = [leadVoice(ctx, out, t)];
321
+ } else if (t.kind === 'pad') {
322
+ voices = [padVoice(ctx, out, t)];
323
+ } else {
324
+ voices = [percVoice(ctx, out, t)];
325
+ }
326
+ for (const v of voices) {
327
+ all.push(...v.nodes);
328
+ }
329
+ // A lead's note runs into the next when the next starts where it ends.
330
+ const legato = pattern.events.map((e, i) => {
331
+ const n = pattern.events[(i + 1) % pattern.events.length];
332
+ return t.kind === 'lead' && n && (n.step === e.step + e.len || (i === pattern.events.length - 1 && n.step === 0 && e.step + e.len === pattern.steps));
333
+ });
334
+ return { t, voices, pattern, stepS, loopS: pattern.steps * stepS, legato, index: 0, base: null, turn: 0 };
335
+ });
336
+ startAll(all, ctx.currentTime);
337
+ // Pumping pads: a dip on every beat, scheduled with the pad's track.
338
+ let stopped = false;
339
+ let origin = null;
340
+ return {
341
+ nodes: all.length,
342
+ gain: master.gain,
343
+ restart(now) {
344
+ now = Math.max(now, ctx.currentTime);
345
+ origin = now + 0.06;
346
+ for (const node of all) {
347
+ for (const key of ['gain', 'frequency', 'detune', 'Q']) {
348
+ node[key]?.cancelScheduledValues(now);
349
+ }
350
+ }
351
+ for (const tr of tracks) {
352
+ tr.base = now + 0.06;
353
+ tr.index = tr.turn = 0;
354
+ for (const v of tr.voices) { v.reset?.(); }
355
+ }
356
+ },
357
+ frame(now, until = Infinity) {
358
+ if (stopped || !Number.isFinite(now)) {
359
+ return;
360
+ }
361
+ now = Math.max(now, ctx.currentTime);
362
+ origin ??= now + 0.06;
363
+ // Seek all tracks together to the next bar after a stalled frame.
364
+ // Directly locate the loop and event, rather than replaying missed notes.
365
+ if (tracks.some((tr) => {
366
+ const ev = tr.pattern.events[tr.index];
367
+ return tr.base !== null && ev && tr.base + ev.step * tr.stepS < now - LOOKAHEAD_S;
368
+ })) {
369
+ const bar = beat * beats;
370
+ const resumeAt = origin + Math.ceil((now + 0.06 - origin) / bar) * bar;
371
+ for (const tr of tracks) {
372
+ tr.base = origin + Math.floor((resumeAt - origin) / tr.loopS) * tr.loopS;
373
+ tr.index = tr.pattern.events.findIndex((ev) => tr.base + ev.step * tr.stepS >= resumeAt - 1e-8);
374
+ if (tr.index < 0) {
375
+ tr.index = 0;
376
+ tr.base += tr.loopS;
377
+ }
378
+ for (const v of tr.voices) { v.reset?.(); }
379
+ }
380
+ }
381
+ for (const tr of tracks) {
382
+ if (tr.base === null) {
383
+ tr.base = now + 0.06;
384
+ }
385
+ for (let guard = 0; guard < 64; guard += 1) {
386
+ const ev = tr.pattern.events[tr.index];
387
+ if (!ev) {
388
+ break;
389
+ }
390
+ const swing = tr.t.swing && ev.step % 2 === 1 ? tr.t.swing * tr.stepS : 0;
391
+ // Voices prepare envelopes up to 30 ms before the note itself.
392
+ const at = Math.max(now + 0.04, tr.base + ev.step * tr.stepS + swing + (tr.t.humanise ?? 0.004) * (next() - 0.5));
393
+ if (at >= now + LOOKAHEAD_S || at >= until) {
394
+ break;
395
+ }
396
+ const vel = ev.vel * (0.92 + next() * 0.16);
397
+ const v = tr.voices[tr.turn % tr.voices.length];
398
+ tr.turn += 1;
399
+ if (tr.t.kind === 'pad') {
400
+ v.play(at, ev.midis, ev.vel);
401
+ if (tr.t.pump) {
402
+ const beats = Math.round((ev.len * tr.stepS) / beat);
403
+ for (let b = 0; b < beats; b += 1) {
404
+ const bt = at + b * beat;
405
+ v.pump.gain.setTargetAtTime(1 - tr.t.pump, bt, 0.006);
406
+ v.pump.gain.setTargetAtTime(1, bt + 0.03, beat * 0.28);
407
+ }
408
+ }
409
+ } else {
410
+ v.play(at, midiHz(ev.midi), vel, ev.len * tr.stepS, tr.legato[tr.index]);
411
+ }
412
+ tr.index += 1;
413
+ if (tr.index >= tr.pattern.events.length) {
414
+ tr.index = 0;
415
+ tr.base += tr.loopS;
416
+ }
417
+ }
418
+ }
419
+ },
420
+ stop() {
421
+ stopped = true;
422
+ release(all);
423
+ },
424
+ // The lowest fundamental each tonal track plays, Hz.
425
+ lowestHz() {
426
+ const out = {};
427
+ for (const tr of tracks) {
428
+ const name = tr.t.name ?? tr.t.kind;
429
+ if (tr.t.kind === 'perc') {
430
+ out[name] = tr.t.hz ? +tr.t.hz.toFixed(1) : 'noise';
431
+ continue;
432
+ }
433
+ let low = Infinity;
434
+ let high = 0;
435
+ for (const e of tr.pattern.events) {
436
+ for (const m of e.midis ?? [e.midi]) {
437
+ low = Math.min(low, midiHz(m));
438
+ high = Math.max(high, midiHz(m));
439
+ }
440
+ }
441
+ out[name] = `${low.toFixed(1)}-${high.toFixed(1)}`;
442
+ }
443
+ return out;
444
+ },
445
+ };
446
+ }
447
+
448
+ export { clamp };
449
+
450
+ // The voice pools keep the audition's synthesis and scheduling. A restart
451
+ // cancels old automation; a finite phrase end prevents notes crossing it.
452
+ export function makeMusic(context, destination, song, options) {
453
+ const nodes = [];
454
+ try {
455
+ return buildMusic(tracked(context, nodes), destination, song, options);
456
+ } catch (err) {
457
+ release(nodes);
458
+ throw err;
459
+ }
460
+ }