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,217 @@
1
+ // v1.60: original placeholder tunes, independent of UI voices and zone music.
2
+ // Ten fixed nodes per phrase player; the frame clock schedules, never a timer.
3
+ import { hub } from './state.js';
4
+
5
+ // -40 dBFS active RMS at distance gain 1 and volume 0.7, through the UI bus
6
+ // and limiter (about 7 dB under the beds), measured in Chromium; `trim`
7
+ // levels the waltz to the jig.
8
+ export const BUSKER_LEVEL = 0.18 * 10 ** (-5.01 / 20);
9
+ export const BUSKER_LEASE_MS = 25000;
10
+ const FADE_S = 0.3;
11
+ const AHEAD_S = 0.04; // Including note tails, automation stays within 0.3 s.
12
+
13
+ // Written for these placeholders: ten 6/8 bars at dotted-quarter 128 bpm,
14
+ // and eight 3/4 bars at quarter 132 bpm. No samples or borrowed scores.
15
+ const TUNES = {
16
+ 'busker-jig': {
17
+ tick: 60 / 128 / 3, wave: 'triangle',
18
+ notes: [
19
+ 74, 78, 76, 81, 78, 73, 76, 81, 79, 78, 74, 76,
20
+ 78, 83, 81, 76, 79, 78, 74, 73, 78, 81, 76, 74,
21
+ 79, 83, 78, 81, 76, 73, 78, 74, 76, 83, 81, 79,
22
+ 81, 78, 74, 76, 73, 78, 79, 76, 81, 78, 74, 73,
23
+ 76, 79, 78, 83, 81, 76, 78, 73, 76, 81, 78, 74,
24
+ ],
25
+ },
26
+ 'busker-waltz': {
27
+ tick: 60 / 132, wave: 'sine', trim: 10 ** (-3.06 / 20),
28
+ notes: [74, 81, 78, 76, 79, 73, 78, 83, 76, 81, 74, 79,
29
+ 76, 83, 78, 79, 73, 81, 78, 76, 83, 74, 79, 78],
30
+ bass: [38, 45, 40, 47, 43, 50, 40, 45],
31
+ },
32
+ };
33
+ export const isBuskerCue = (name) => typeof name === 'string' && Object.hasOwn(TUNES, name);
34
+ const hz = (midi) => 440 * 2 ** ((midi - 69) / 12);
35
+
36
+ function phrase(ctx, bus, name, actor, gain, loop) {
37
+ const tune = TUNES[name];
38
+ const nodes = [];
39
+ const voices = [];
40
+ const made = (node) => { nodes.push(node); return node; };
41
+ let gone = false;
42
+ const release = () => {
43
+ if (gone) { return; }
44
+ gone = true;
45
+ for (const node of nodes) {
46
+ try { node.stop?.(); } catch { /* Already stopped, or not started. */ }
47
+ try { node.disconnect(); } catch { /* Already disconnected. */ }
48
+ }
49
+ };
50
+ try {
51
+ const filter = made(ctx.createBiquadFilter());
52
+ filter.type = 'lowpass';
53
+ filter.frequency.value = 3000;
54
+ filter.Q.value = 0.7;
55
+ const distance = made(ctx.createGain());
56
+ distance.gain.value = 0;
57
+ filter.connect(distance);
58
+ distance.connect(bus);
59
+ for (let i = 0; i < 4; i += 1) {
60
+ const osc = made(ctx.createOscillator());
61
+ osc.type = i === 3 ? 'sine' : tune.wave;
62
+ const env = made(ctx.createGain());
63
+ env.gain.value = 0;
64
+ osc.connect(env);
65
+ env.connect(filter);
66
+ voices.push({ osc, env });
67
+ }
68
+ const origin = ctx.currentTime + 0.005;
69
+ const duration = tune.notes.length * tune.tick;
70
+ let cursor = 0;
71
+ let fading = false;
72
+ let until = loop ? Infinity : origin + duration;
73
+ let loud = gain;
74
+ distance.gain.setValueAtTime(0, ctx.currentTime);
75
+ distance.gain.linearRampToValueAtTime(gain, ctx.currentTime + FADE_S);
76
+ for (const { osc } of voices) {
77
+ osc.onended = release;
78
+ osc.start(origin);
79
+ if (!loop) { osc.stop(until); }
80
+ }
81
+ const note = (voice, midi, at, level, duration) => {
82
+ voice.osc.frequency.setValueAtTime(hz(midi), at);
83
+ voice.env.gain.setValueAtTime(0, at);
84
+ voice.env.gain.linearRampToValueAtTime(level, at + 0.006);
85
+ voice.env.gain.exponentialRampToValueAtTime(level * 0.01, at + duration - 0.008);
86
+ voice.env.gain.linearRampToValueAtTime(0, at + duration);
87
+ };
88
+ return {
89
+ actor, name, nodes, distance, release,
90
+ get gone() { return gone; },
91
+ get until() { return until; },
92
+ get fading() { return fading; },
93
+ gain(value, t) {
94
+ if (!fading && value !== loud) {
95
+ if (distance.gain.cancelAndHoldAtTime) { distance.gain.cancelAndHoldAtTime(t); }
96
+ else {
97
+ distance.gain.cancelScheduledValues(t);
98
+ distance.gain.setValueAtTime(loud, t);
99
+ }
100
+ loud = value;
101
+ distance.gain.setTargetAtTime(value, t, 0.03);
102
+ }
103
+ },
104
+ fade(t) {
105
+ if (fading || gone) { return; }
106
+ fading = true;
107
+ until = Math.min(until, t + FADE_S);
108
+ // Hold the real interpolated gain where supported (not AudioParam.value,
109
+ // which can jump to a previous target during an interrupted attack).
110
+ if (distance.gain.cancelAndHoldAtTime) { distance.gain.cancelAndHoldAtTime(t); }
111
+ else {
112
+ distance.gain.cancelScheduledValues(t);
113
+ distance.gain.setValueAtTime(loud, t);
114
+ }
115
+ distance.gain.linearRampToValueAtTime(0, until);
116
+ for (const { osc } of voices) { osc.stop(until); }
117
+ },
118
+ frame(t) {
119
+ if (gone) { return; }
120
+ if (t >= until) { release(); return; }
121
+ if (fading) { return; }
122
+ // Advance directly past a hitch: no missed note ever starts late.
123
+ cursor = Math.max(cursor, Math.ceil((t - origin) / tune.tick));
124
+ while (origin + cursor * tune.tick <= t + AHEAD_S) {
125
+ if (!loop && cursor >= tune.notes.length) { break; }
126
+ const index = cursor % tune.notes.length;
127
+ const at = origin + cursor * tune.tick;
128
+ note(voices[cursor % 3], tune.notes[index], at, BUSKER_LEVEL * (tune.trim ?? 1) * (index % (tune.bass ? 3 : 6) === 0 ? 1 : 0.8), Math.min(0.24, tune.tick * 0.85));
129
+ if (tune.bass && index % 3 === 0) {
130
+ note(voices[3], tune.bass[index / 3], at, BUSKER_LEVEL * (tune.trim ?? 1) * 0.35, 0.24);
131
+ }
132
+ cursor += 1;
133
+ }
134
+ },
135
+ };
136
+ } catch (err) {
137
+ release();
138
+ throw err;
139
+ }
140
+ }
141
+
142
+ export function makeBusker({ ready, context, bus, failed, distanceGain }) {
143
+ const leases = new Map();
144
+ let sceneWas = null;
145
+ let loop = null;
146
+ let shot = null;
147
+ const quiet = () => {
148
+ loop?.release();
149
+ shot?.release();
150
+ loop = null;
151
+ shot = null;
152
+ leases.clear();
153
+ };
154
+ const start = (name, actor, gain, looping, now) => {
155
+ const ctx = ready(now);
156
+ if (!ctx) { return null; }
157
+ try { return phrase(ctx, bus(), name, actor, gain, looping); }
158
+ catch (err) { failed(err); return null; }
159
+ };
160
+ return {
161
+ receive(event, now, live) {
162
+ if (!live || !Number.isFinite(now) || !isBuskerCue(event?.cue)) { return; }
163
+ if (Object.hasOwn(event, 'actor')) {
164
+ if (typeof event.actor === 'string' && Number.isFinite(event.radius) && event.radius >= 1 && event.radius <= 60) {
165
+ leases.set(event.actor, { name: event.cue, radius: event.radius, at: now });
166
+ }
167
+ } else {
168
+ // One bounded private phrase slot, outside UI's caps.
169
+ shot?.release();
170
+ shot = start(event.cue, null, 1, false, now);
171
+ }
172
+ },
173
+ frame(scene, local, now, live) {
174
+ if (sceneWas !== scene) { quiet(); sceneWas = scene; }
175
+ if (!live) { quiet(); return; }
176
+ const c = context();
177
+ if (c && c.state !== 'running') {
178
+ // A suspended clock is frozen: release what was playing rather than
179
+ // resume a stale tail; a valid lease starts afresh once it runs.
180
+ loop?.release();
181
+ shot?.release();
182
+ loop = null;
183
+ shot = null;
184
+ // Keep asking to resume (ready() spaces the requests) while a lease
185
+ // is current and in range, so a failed first resume is retried.
186
+ for (const [actor, lease] of leases) {
187
+ if (now - lease.at < BUSKER_LEASE_MS && !hub.hidden.has(actor) && distanceGain(local?.components.Transform, scene.getActor(actor)?.components.Transform, lease.radius) > 0) {
188
+ ready(now);
189
+ break;
190
+ }
191
+ }
192
+ return;
193
+ }
194
+ const t = c?.currentTime;
195
+ let best = null;
196
+ let gain = 0;
197
+ for (const [actor, lease] of leases) {
198
+ if (now - lease.at >= BUSKER_LEASE_MS) { leases.delete(actor); continue; }
199
+ const loud = hub.hidden.has(actor) || hub.hidden.has(local?.id) ? 0 : distanceGain(local?.components.Transform, scene.getActor(actor)?.components.Transform, lease.radius);
200
+ if (loud > gain) { best = { actor, name: lease.name }; gain = loud; }
201
+ }
202
+ if (loop && !loop.fading && (!best || best.actor !== loop.actor || best.name !== loop.name)) { loop.fade(t); }
203
+ loop?.frame(t);
204
+ if (loop?.gone) { loop = null; }
205
+ if (!loop && best) {
206
+ loop = start(best.name, best.actor, gain, true, now);
207
+ if (!loop) { leases.delete(best.actor); } // A suspended context never queues a tune.
208
+ }
209
+ if (loop && !loop.fading) { loop.gain(gain, context().currentTime); loop.frame(context().currentTime); }
210
+ shot?.frame(context()?.currentTime);
211
+ if (shot?.gone) { shot = null; }
212
+ },
213
+ quiet,
214
+ dispose: quiet,
215
+ counts: () => ({ loops: loop ? 1 : 0, shots: shot ? 1 : 0, actor: loop?.actor ?? null, name: loop?.name ?? null, nodes: (loop?.nodes.length ?? 0) + (shot?.nodes.length ?? 0) }),
216
+ };
217
+ }
@@ -0,0 +1,200 @@
1
+ // Selected court voices (v1.50): chime A at stone 0, bell A, splash A,
2
+ // flutter B. Audition pitches, envelopes, noise seed and offsets are kept.
3
+
4
+ const noises = new WeakMap();
5
+ function noiseOf(context) {
6
+ const ctx = context.context ?? context;
7
+ let buffer = noises.get(ctx);
8
+ if (!buffer) {
9
+ const n = Math.floor(ctx.sampleRate);
10
+ buffer = ctx.createBuffer(1, n, ctx.sampleRate);
11
+ const data = buffer.getChannelData(0);
12
+ let a = 0xc0a7;
13
+ for (let i = 0; i < n; i += 1) {
14
+ a = (a + 0x6d2b79f5) >>> 0;
15
+ let t = a;
16
+ t = Math.imul(t ^ (t >>> 15), t | 1);
17
+ t ^= t + Math.imul(t ^ (t >>> 7), t | 61);
18
+ data[i] = (((t ^ (t >>> 14)) >>> 0) / 4294967296) * 2 - 1;
19
+ }
20
+ noises.set(ctx, buffer);
21
+ }
22
+ return buffer;
23
+ }
24
+
25
+ function seeded(seed) {
26
+ let a = seed >>> 0;
27
+ return () => {
28
+ a = (a + 0x6d2b79f5) >>> 0;
29
+ let t = a;
30
+ t = Math.imul(t ^ (t >>> 15), t | 1);
31
+ t ^= t + Math.imul(t ^ (t >>> 7), t | 61);
32
+ return ((t ^ (t >>> 14)) >>> 0) / 4294967296;
33
+ };
34
+ }
35
+
36
+
37
+
38
+ function cleanup(ctx, source, nodes, end) {
39
+ const group = ctx.track(nodes, end);
40
+ source.onended = () => ctx.ended(group);
41
+ }
42
+
43
+ function partials(ctx, dest, t, f, list, attack = 0.002) {
44
+ if (ctx.parts) {
45
+ const end = t + Math.max(...list.map((part) => part[2]));
46
+ ctx.parts.push({ at: t, options: { f, list, attack }, build: partialPart });
47
+ return end;
48
+ }
49
+ let end = t;
50
+ for (const [ratio, level, decay] of list) {
51
+ const o = ctx.createOscillator();
52
+ o.frequency.value = f * ratio;
53
+ const g = ctx.createGain();
54
+ g.gain.setValueAtTime(0, t);
55
+ g.gain.linearRampToValueAtTime(level, t + attack);
56
+ g.gain.exponentialRampToValueAtTime(0.0004, t + decay);
57
+ o.connect(g);
58
+ g.connect(dest);
59
+ cleanup(ctx, o, [o, g], t + decay + 0.02);
60
+ o.start(t);
61
+ o.stop(t + decay + 0.02);
62
+ end = Math.max(end, t + decay);
63
+ }
64
+ return end;
65
+ }
66
+ function partialPart(ctx, dest, t, { f, list, attack }) {
67
+ return partials(ctx, dest, t, f, list, attack);
68
+ }
69
+
70
+ function noiseBurst(ctx, dest, t, type, f, q, shape, sweep = null) {
71
+ if (ctx.parts) {
72
+ ctx.parts.push({ at: t, options: { type, f, q, shape, sweep }, build: noisePart });
73
+ return t + shape[shape.length - 1][0];
74
+ }
75
+ const src = ctx.createBufferSource();
76
+ src.buffer = noiseOf(ctx);
77
+ src.loop = true;
78
+ const filter = ctx.createBiquadFilter();
79
+ filter.type = type;
80
+ filter.frequency.setValueAtTime(f, t);
81
+ if (sweep) {
82
+ for (const [at, hz] of sweep) {
83
+ filter.frequency.exponentialRampToValueAtTime(hz, t + at);
84
+ }
85
+ }
86
+ filter.Q.value = q;
87
+ const env = ctx.createGain();
88
+ env.gain.setValueAtTime(0, t);
89
+ for (const [at, level] of shape) {
90
+ env.gain.linearRampToValueAtTime(level, t + at);
91
+ }
92
+ src.connect(filter);
93
+ filter.connect(env);
94
+ env.connect(dest);
95
+ const end = t + shape[shape.length - 1][0];
96
+ cleanup(ctx, src, [src, filter, env], end + 0.02);
97
+ src.start(t, (t * 7.31 + f / 997) % 0.5);
98
+ src.stop(end + 0.02);
99
+ return end;
100
+ }
101
+ function noisePart(ctx, dest, t, { type, f, q, shape, sweep }) {
102
+ return noiseBurst(ctx, dest, t, type, f, q, shape, sweep);
103
+ }
104
+
105
+ function droplet(ctx, dest, at, { f, level }) {
106
+ const o = ctx.createOscillator();
107
+ o.frequency.setValueAtTime(f, at);
108
+ o.frequency.exponentialRampToValueAtTime(f * 1.9, at + 0.035);
109
+ const g = ctx.createGain();
110
+ g.gain.setValueAtTime(0, at);
111
+ g.gain.linearRampToValueAtTime(level, at + 0.003);
112
+ g.gain.exponentialRampToValueAtTime(0.0004, at + 0.045);
113
+ o.connect(g);
114
+ g.connect(dest);
115
+ cleanup(ctx, o, [o, g], at + 0.06);
116
+ o.start(at);
117
+ o.stop(at + 0.06);
118
+ }
119
+
120
+ function droplets(ctx, dest, t, count, seed, span, level) {
121
+ const next = seeded(seed);
122
+ let end = t;
123
+ for (let i = 0; i < count; i += 1) {
124
+ const at = t + next() * span;
125
+ const f = 900 + next() * 1600;
126
+ const options = { f, level: level * (0.5 + next() * 0.5) };
127
+ if (ctx.parts) {
128
+ ctx.parts.push({ at, options, build: droplet });
129
+ } else {
130
+ droplet(ctx, dest, at, options);
131
+ }
132
+ end = Math.max(end, at + 0.06);
133
+ }
134
+ return end;
135
+ }
136
+
137
+ function flutter(ctx, dest, t, { length, rateLo, rateHi, cracks, seed, snap, cloth }) {
138
+ noiseBurst(ctx, dest, t, 'bandpass', 500, 0.9, [[length * 0.4, 0.09], [length, 0]], [[length * 0.4, 900], [length, 450]]);
139
+ const options = { length, rateLo, rateHi, cracks, seed, snap, cloth };
140
+ if (ctx.parts) {
141
+ ctx.parts.push({ at: t, options, build: clothPart });
142
+ return t + length + 0.05;
143
+ }
144
+ return clothPart(ctx, dest, t, options);
145
+ }
146
+
147
+ function clothPart(ctx, dest, t, { length, rateLo, rateHi, cracks, seed, snap, cloth }) {
148
+ const next = seeded(seed);
149
+ const src = ctx.createBufferSource();
150
+ src.buffer = noiseOf(ctx);
151
+ src.loop = true;
152
+ const filter = ctx.createBiquadFilter();
153
+ filter.type = 'bandpass';
154
+ filter.frequency.value = cloth;
155
+ filter.Q.value = 0.9;
156
+ const env = ctx.createGain();
157
+ env.gain.value = 0;
158
+ src.connect(filter);
159
+ filter.connect(env);
160
+ env.connect(dest);
161
+ cleanup(ctx, src, [src, filter, env], t + length + 0.05);
162
+ let at = t + 0.06;
163
+ let n = 0;
164
+ while (at < t + length - 0.08) {
165
+ const u = (at - t) / length;
166
+ const swell = Math.sin(Math.PI * u);
167
+ const hard = cracks.includes(n);
168
+ const level = hard ? snap : snap * (0.25 + 0.5 * swell) * (0.6 + next() * 0.4);
169
+ env.gain.setValueAtTime(level, at);
170
+ env.gain.setTargetAtTime(0, at + 0.001, hard ? 0.012 : 0.006);
171
+ at += 1 / (rateLo + (rateHi - rateLo) * swell) * (0.75 + next() * 0.5);
172
+ n += 1;
173
+ }
174
+ src.start(t);
175
+ src.stop(t + length + 0.05);
176
+ return t + length + 0.05;
177
+ }
178
+
179
+ export const CHIME_SCALE = [587.33, 659.26, 739.99, 880, 987.77];
180
+
181
+ export function courtChimeA(ctx, dest, t, degree = 0) {
182
+ const f = CHIME_SCALE[Math.max(0, Math.min(4, degree))];
183
+ noiseBurst(ctx, dest, t, 'bandpass', 3000, 1.5, [[0.002, 0.05], [0.02, 0]]);
184
+ return partials(ctx, dest, t, f, [[1, 0.2, 0.9], [2.76, 0.06, 0.28], [5.4, 0.025, 0.09]], 0.003);
185
+ }
186
+
187
+ export function courtBellA(ctx, dest, t) {
188
+ noiseBurst(ctx, dest, t, 'bandpass', 4200, 2, [[0.001, 0.08], [0.015, 0]]);
189
+ return partials(ctx, dest, t, 900, [[0.5, 0.05, 2.6], [1, 0.12, 2.3], [1.2, 0.07, 1.6], [1.5, 0.04, 1.2], [2, 0.07, 1.0], [2.5, 0.03, 0.6], [3.01, 0.02, 0.4]], 0.0015);
190
+ }
191
+
192
+ export function courtSplashA(ctx, dest, t) {
193
+ noiseBurst(ctx, dest, t, 'bandpass', 1400, 1.2, [[0.08, 0.16], [0.35, 0.12], [0.75, 0]], [[0.25, 4200], [0.7, 1800]]);
194
+ noiseBurst(ctx, dest, t + 0.32, 'highpass', 3000, 0.7, [[0.03, 0.07], [0.4, 0]]);
195
+ return Math.max(t + 0.9, droplets(ctx, dest, t + 0.35, 5, 0x5b1a, 0.4, 0.06));
196
+ }
197
+
198
+ export function courtFlutterB(ctx, dest, t) {
199
+ return flutter(ctx, dest, t, { length: 0.8, rateLo: 8, rateHi: 16, cracks: [1, 4, 7], seed: 0xf1b0, snap: 0.3, cloth: 1050 });
200
+ }