castle-web-cli 0.4.232 → 0.4.234

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (587) hide show
  1. package/dist/agent-failures.d.ts +8 -0
  2. package/dist/agent-failures.js +19 -2
  3. package/dist/agent-prompts.d.ts +1 -1
  4. package/dist/agent-prompts.js +10 -3
  5. package/dist/agent.d.ts +64 -3
  6. package/dist/agent.js +170 -81
  7. package/dist/api.d.ts +11 -0
  8. package/dist/api.js +43 -0
  9. package/dist/bundle.d.ts +64 -0
  10. package/dist/bundle.js +558 -2
  11. package/dist/castle-host/host.d.ts +18 -2
  12. package/dist/castle-host/host.js +844 -39
  13. package/dist/castleJson.d.ts +23 -2
  14. package/dist/castleJson.js +46 -2
  15. package/dist/check.d.ts +3 -1
  16. package/dist/check.js +20 -3
  17. package/dist/chunkLoader.d.ts +3 -0
  18. package/dist/chunkLoader.js +111 -0
  19. package/dist/devParty.d.ts +26 -0
  20. package/dist/devParty.js +231 -0
  21. package/dist/devSaveStorage.js +4 -0
  22. package/dist/devSessionStorage.js +50 -2
  23. package/dist/devSocial.d.ts +24 -0
  24. package/dist/devSocial.js +70 -0
  25. package/dist/ide.d.ts +2 -0
  26. package/dist/ide.js +119 -15
  27. package/dist/importPinMismatch.d.ts +22 -0
  28. package/dist/importPinMismatch.js +77 -0
  29. package/dist/importRegression.js +3 -15
  30. package/dist/imports.d.ts +10 -3
  31. package/dist/imports.js +88 -20
  32. package/dist/index.js +11 -4
  33. package/dist/init.js +1 -1
  34. package/dist/platformDoc.js +22 -0
  35. package/dist/routerFences.d.ts +5 -0
  36. package/dist/routerFences.js +12 -2
  37. package/dist/save-deck.d.ts +25 -1
  38. package/dist/save-deck.js +178 -9
  39. package/dist/serve.js +32 -11
  40. package/dist/shell/assets/{index-D2tWM896.js → index-DulbYIJm.js} +97 -97
  41. package/dist/shell/assets/index-MVLfNYd9.css +1 -0
  42. package/dist/shell/index.html +2 -2
  43. package/dist/taskSteer.d.ts +13 -0
  44. package/dist/taskSteer.js +22 -2
  45. package/dist/vitePlugins.d.ts +2 -1
  46. package/dist/vitePlugins.js +13 -0
  47. package/kits/base/castle.json +1 -1
  48. package/kits/base/package-lock.json +1 -1
  49. package/kits/base/sdk/README.md +339 -5
  50. package/kits/base/sdk/avatar.d.ts +6 -2
  51. package/kits/base/sdk/avatar.js +12 -4
  52. package/kits/base/sdk/castle.d.ts +7 -3
  53. package/kits/base/sdk/castle.js +2 -0
  54. package/kits/base/sdk/commands.d.ts +176 -1
  55. package/kits/base/sdk/commands.js +3 -0
  56. package/kits/base/sdk/display.d.ts +3 -0
  57. package/kits/base/sdk/display.js +9 -3
  58. package/kits/base/sdk/hub.d.ts +37 -6
  59. package/kits/base/sdk/hub.js +63 -4
  60. package/kits/base/sdk/multiplayer.d.ts +7 -1
  61. package/kits/base/sdk/multiplayer.js +148 -32
  62. package/kits/base/sdk/multiplayerProtocol.d.ts +2 -0
  63. package/kits/base/sdk/party.d.ts +23 -0
  64. package/kits/base/sdk/party.js +91 -0
  65. package/kits/base/sdk/reconnectBudget.d.ts +23 -0
  66. package/kits/base/sdk/reconnectBudget.js +96 -0
  67. package/kits/base/sdk/save.d.ts +38 -1
  68. package/kits/base/sdk/save.js +81 -7
  69. package/kits/base/sdk/server/hub.d.ts +117 -0
  70. package/kits/base/sdk/server/hub.js +119 -2
  71. package/kits/base/sdk/server/platformHandle.d.ts +43 -1
  72. package/kits/base/sdk/server/storage.d.ts +17 -0
  73. package/kits/base/sdk/server/storage.js +65 -3
  74. package/kits/base/sdk/server/wrapper.d.ts +43 -6
  75. package/kits/base/sdk/server/wrapper.js +93 -9
  76. package/kits/base/sdk/social.d.ts +9 -0
  77. package/kits/base/sdk/social.js +5 -0
  78. package/kits/hub-game/CLAUDE.md +451 -13
  79. package/kits/hub-game/README.md +63 -0
  80. package/kits/hub-game/blueprints/avatar-10.scene +28 -0
  81. package/kits/hub-game/blueprints/avatar-11.scene +28 -0
  82. package/kits/hub-game/blueprints/avatar-12.scene +28 -0
  83. package/kits/hub-game/blueprints/avatar-13.scene +28 -0
  84. package/kits/hub-game/blueprints/avatar-14.scene +28 -0
  85. package/kits/hub-game/blueprints/avatar-15.scene +28 -0
  86. package/kits/hub-game/blueprints/avatar-4.scene +28 -0
  87. package/kits/hub-game/blueprints/avatar-5.scene +28 -0
  88. package/kits/hub-game/blueprints/avatar-6.scene +28 -0
  89. package/kits/hub-game/blueprints/avatar-7.scene +28 -0
  90. package/kits/hub-game/blueprints/avatar-8.scene +28 -0
  91. package/kits/hub-game/blueprints/avatar-9.scene +28 -0
  92. package/kits/hub-game/castle.json +5 -5
  93. package/kits/hub-game/code/client/act.js +312 -0
  94. package/kits/hub-game/code/client/actionLayout.js +147 -0
  95. package/kits/hub-game/code/client/actionOverflow.js +556 -0
  96. package/kits/hub-game/code/client/actorBudget.js +47 -0
  97. package/kits/hub-game/code/client/arrivalCamera.js +50 -0
  98. package/kits/hub-game/code/client/askSlot.js +117 -0
  99. package/kits/hub-game/code/client/attention.js +11 -2
  100. package/kits/hub-game/code/client/avatar.js +311 -35
  101. package/kits/hub-game/code/client/avatarCap.js +228 -0
  102. package/kits/hub-game/code/client/avatarColors.js +70 -0
  103. package/kits/hub-game/code/client/avatarFaces.js +21 -0
  104. package/kits/hub-game/code/client/avatarShare.js +253 -0
  105. package/kits/hub-game/code/client/backVisibility.js +13 -0
  106. package/kits/hub-game/code/client/ballot.js +472 -0
  107. package/kits/hub-game/code/client/build.js +38 -0
  108. package/kits/hub-game/code/client/chat.js +41 -5
  109. package/kits/hub-game/code/client/chatModeration.js +5 -0
  110. package/kits/hub-game/code/client/chrome.js +2144 -160
  111. package/kits/hub-game/code/client/companion.js +716 -0
  112. package/kits/hub-game/code/client/companionDress.js +99 -0
  113. package/kits/hub-game/code/client/crowdNames.js +241 -0
  114. package/kits/hub-game/code/client/decor.js +515 -0
  115. package/kits/hub-game/code/client/defaultEnvironment.js +194 -0
  116. package/kits/hub-game/code/client/doorErrors.js +39 -0
  117. package/kits/hub-game/code/client/earned.js +131 -0
  118. package/kits/hub-game/code/client/emoteBubble.js +75 -0
  119. package/kits/hub-game/code/client/fall.js +18 -0
  120. package/kits/hub-game/code/client/farAvatars.js +233 -0
  121. package/kits/hub-game/code/client/firstJoin.js +9 -2
  122. package/kits/hub-game/code/client/fpsTelemetry.js +50 -0
  123. package/kits/hub-game/code/client/frameBatch.js +5 -0
  124. package/kits/hub-game/code/client/grab.js +368 -29
  125. package/kits/hub-game/code/client/hookLayer.js +385 -20
  126. package/kits/hub-game/code/client/hudCopy.js +51 -0
  127. package/kits/hub-game/code/client/hudRate.js +20 -0
  128. package/kits/hub-game/code/client/idle.js +177 -24
  129. package/kits/hub-game/code/client/interestCap.js +81 -0
  130. package/kits/hub-game/code/client/invites.js +231 -0
  131. package/kits/hub-game/code/client/joinError.js +9 -0
  132. package/kits/hub-game/code/client/keys.js +36 -0
  133. package/kits/hub-game/code/client/labelsNear.js +234 -0
  134. package/kits/hub-game/code/client/landscapeLayout.js +17 -0
  135. package/kits/hub-game/code/client/layoutCache.js +264 -0
  136. package/kits/hub-game/code/client/loadTelemetry.js +20 -0
  137. package/kits/hub-game/code/client/loadingCover.js +148 -0
  138. package/kits/hub-game/code/client/loadingEntry.js +8 -0
  139. package/kits/hub-game/code/client/menuIcons.js +34 -0
  140. package/kits/hub-game/code/client/menuRows.js +43 -0
  141. package/kits/hub-game/code/client/modelReady.js +7 -0
  142. package/kits/hub-game/code/client/pack.js +6 -2
  143. package/kits/hub-game/code/client/packFormat.js +3 -3
  144. package/kits/hub-game/code/client/padCueArrival.js +23 -0
  145. package/kits/hub-game/code/client/padCues.js +112 -0
  146. package/kits/hub-game/code/client/padOccupancy.js +88 -0
  147. package/kits/hub-game/code/client/padReadability.js +26 -0
  148. package/kits/hub-game/code/client/padRings.js +69 -0
  149. package/kits/hub-game/code/client/pushVisit.js +14 -0
  150. package/kits/hub-game/code/client/quality.js +205 -0
  151. package/kits/hub-game/code/client/qualityEntry.js +55 -0
  152. package/kits/hub-game/code/client/rehello.js +167 -0
  153. package/kits/hub-game/code/client/safeLayout.js +338 -0
  154. package/kits/hub-game/code/client/safeStyle.js +42 -0
  155. package/kits/hub-game/code/client/say.js +12 -3
  156. package/kits/hub-game/code/client/shot.js +146 -0
  157. package/kits/hub-game/code/client/shotFit.js +56 -0
  158. package/kits/hub-game/code/client/signIn.js +28 -0
  159. package/kits/hub-game/code/client/sound.js +63 -8
  160. package/kits/hub-game/code/client/soundscape.js +1151 -0
  161. package/kits/hub-game/code/client/soundscapeActions.js +99 -0
  162. package/kits/hub-game/code/client/soundscapeAmbience.js +453 -0
  163. package/kits/hub-game/code/client/soundscapeBaked.js +143 -0
  164. package/kits/hub-game/code/client/soundscapeBusker.js +217 -0
  165. package/kits/hub-game/code/client/soundscapeCourt.js +200 -0
  166. package/kits/hub-game/code/client/soundscapeCrowd.js +331 -0
  167. package/kits/hub-game/code/client/soundscapeCues.js +362 -0
  168. package/kits/hub-game/code/client/soundscapeMap.js +181 -0
  169. package/kits/hub-game/code/client/soundscapeMarket.js +176 -0
  170. package/kits/hub-game/code/client/soundscapeMusic.js +126 -0
  171. package/kits/hub-game/code/client/soundscapeMusicEngine.js +460 -0
  172. package/kits/hub-game/code/client/soundscapeSimlish.js +737 -0
  173. package/kits/hub-game/code/client/soundscapeSongs.js +127 -0
  174. package/kits/hub-game/code/client/soundscapeSongsRound3.js +63 -0
  175. package/kits/hub-game/code/client/soundscapeSynthesis.js +168 -0
  176. package/kits/hub-game/code/client/soundscapeUi.js +211 -0
  177. package/kits/hub-game/code/client/soundscapeVoice.js +1209 -0
  178. package/kits/hub-game/code/client/soundscapeWaves.js +206 -0
  179. package/kits/hub-game/code/client/spin.js +101 -0
  180. package/kits/hub-game/code/client/state.js +162 -1
  181. package/kits/hub-game/code/client/stuck.js +259 -0
  182. package/kits/hub-game/code/client/talk.js +714 -59
  183. package/kits/hub-game/code/client/tiers.js +543 -52
  184. package/kits/hub-game/code/client/toastBand.js +37 -0
  185. package/kits/hub-game/code/client/together.js +39 -2
  186. package/kits/hub-game/code/client/visibility.js +43 -0
  187. package/kits/hub-game/code/client/weakestLookBake.js +92 -0
  188. package/kits/hub-game/code/client/weakestTier.js +295 -0
  189. package/kits/hub-game/code/client/wear.js +461 -170
  190. package/kits/hub-game/code/client/worldLabels.js +241 -0
  191. package/kits/hub-game/code/client/yours.js +200 -0
  192. package/kits/hub-game/code/companionSpec.js +45 -0
  193. package/kits/hub-game/code/npcDisplayText.js +55 -0
  194. package/kits/hub-game/code/privateText.js +7 -0
  195. package/kits/hub-game/code/server/act.js +124 -0
  196. package/kits/hub-game/code/server/actions.js +138 -0
  197. package/kits/hub-game/code/server/actors.js +11 -2
  198. package/kits/hub-game/code/server/analytics.js +83 -0
  199. package/kits/hub-game/code/server/anonymousEntry.js +49 -0
  200. package/kits/hub-game/code/server/arrivalPose.js +36 -0
  201. package/kits/hub-game/code/server/ask.js +155 -0
  202. package/kits/hub-game/code/server/ballot.js +539 -0
  203. package/kits/hub-game/code/server/cells.js +100 -0
  204. package/kits/hub-game/code/server/companion.js +107 -0
  205. package/kits/hub-game/code/server/cues.js +70 -0
  206. package/kits/hub-game/code/server/decor.js +269 -0
  207. package/kits/hub-game/code/server/doorAnalytics.js +52 -0
  208. package/kits/hub-game/code/server/earned.js +478 -0
  209. package/kits/hub-game/code/server/frameBatch.js +183 -0
  210. package/kits/hub-game/code/server/friendBests.js +166 -0
  211. package/kits/hub-game/code/server/friendsAmong.js +272 -0
  212. package/kits/hub-game/code/server/history.js +7 -0
  213. package/kits/hub-game/code/server/hub.js +2510 -95
  214. package/kits/hub-game/code/server/idle.js +60 -12
  215. package/kits/hub-game/code/server/index.js +28 -6
  216. package/kits/hub-game/code/server/invites.js +19 -0
  217. package/kits/hub-game/code/server/labels.js +36 -2
  218. package/kits/hub-game/code/server/loadAbandon.js +106 -0
  219. package/kits/hub-game/code/server/manifest.js +586 -7
  220. package/kits/hub-game/code/server/menu.js +161 -0
  221. package/kits/hub-game/code/server/npcs.js +1025 -113
  222. package/kits/hub-game/code/server/observe.js +408 -0
  223. package/kits/hub-game/code/server/padOccupancy.js +85 -0
  224. package/kits/hub-game/code/server/party.js +2 -2
  225. package/kits/hub-game/code/server/players.js +30 -0
  226. package/kits/hub-game/code/server/resumePose.js +152 -0
  227. package/kits/hub-game/code/server/say.js +1 -1
  228. package/kits/hub-game/code/server/shot.js +110 -0
  229. package/kits/hub-game/code/server/standing.js +123 -0
  230. package/kits/hub-game/code/server/storageLimit.js +187 -0
  231. package/kits/hub-game/code/server/vis.js +175 -0
  232. package/kits/hub-game/code/server/wear.js +12 -0
  233. package/kits/hub-game/code/server/yours.js +59 -0
  234. package/kits/hub-game/code/shared/act.js +35 -0
  235. package/kits/hub-game/code/shared/cues.js +9 -0
  236. package/kits/hub-game/code/shared/danceIdle.js +28 -0
  237. package/kits/hub-game/code/shared/decor.js +41 -0
  238. package/kits/hub-game/code/shared/loadStages.js +12 -0
  239. package/kits/hub-game/code/shared/quality.js +74 -0
  240. package/kits/hub-game/code/shared/say.js +2 -0
  241. package/kits/hub-game/code/shared/shot.js +53 -0
  242. package/kits/hub-game/code/shared/spin.js +57 -0
  243. package/kits/hub-game/code/systems/hub.js +1753 -202
  244. package/kits/hub-game/docs/analytics.md +279 -0
  245. package/kits/hub-game/docs/content-pack.md +1 -1
  246. package/kits/hub-game/docs/contract.md +3475 -77
  247. package/kits/hub-game/docs/home-pieces.md +71 -0
  248. package/kits/hub-game/docs/observed-progress.md +252 -0
  249. package/kits/hub-game/main.jsx +2 -0
  250. package/kits/hub-game/models/avatar-10.pxmodel +28 -0
  251. package/kits/hub-game/models/avatar-11.pxmodel +28 -0
  252. package/kits/hub-game/models/avatar-12.pxmodel +27 -0
  253. package/kits/hub-game/models/avatar-13.pxmodel +24 -0
  254. package/kits/hub-game/models/avatar-14.pxmodel +29 -0
  255. package/kits/hub-game/models/avatar-15.pxmodel +24 -0
  256. package/kits/hub-game/models/avatar-4.pxmodel +29 -0
  257. package/kits/hub-game/models/avatar-5.pxmodel +27 -0
  258. package/kits/hub-game/models/avatar-6.pxmodel +26 -0
  259. package/kits/hub-game/models/avatar-7.pxmodel +25 -0
  260. package/kits/hub-game/models/avatar-8.pxmodel +24 -0
  261. package/kits/hub-game/models/avatar-9.pxmodel +30 -0
  262. package/kits/hub-game/models/earned/badge-round.pxmodel +100 -0
  263. package/kits/hub-game/models/earned/badge-shield.pxmodel +117 -0
  264. package/kits/hub-game/models/earned/badge-star.pxmodel +87 -0
  265. package/kits/hub-game/models/earned/belt-plain.pxmodel +72 -0
  266. package/kits/hub-game/models/earned/held-ball.pxmodel +43 -0
  267. package/kits/hub-game/models/earned/held-lantern.pxmodel +85 -0
  268. package/kits/hub-game/models/earned/held-net.pxmodel +57 -0
  269. package/kits/hub-game/models/earned/held-trophy.pxmodel +109 -0
  270. package/kits/hub-game/models/earned/pin-round.pxmodel +62 -0
  271. package/kits/hub-game/models/earned/sash-plain.pxmodel +66 -0
  272. package/kits/hub-game/models/earned/square/belt-plain.pxmodel +104 -0
  273. package/kits/hub-game/models/earned/square/sash-plain.pxmodel +98 -0
  274. package/kits/hub-game/models/hats/bat-clip.pxmodel +206 -0
  275. package/kits/hub-game/models/hats/beekeeper.pxmodel +149 -0
  276. package/kits/hub-game/models/hats/cap.pxmodel +162 -0
  277. package/kits/hub-game/models/hats/captain.pxmodel +178 -0
  278. package/kits/hub-game/models/hats/crooked-top.pxmodel +172 -0
  279. package/kits/hub-game/models/hats/flower-crown.pxmodel +451 -0
  280. package/kits/hub-game/models/hats/foam-crown.pxmodel +179 -0
  281. package/kits/hub-game/models/hats/lantern.pxmodel +230 -0
  282. package/kits/hub-game/models/hats/laurel.pxmodel +533 -0
  283. package/kits/hub-game/models/hats/lighthouse.pxmodel +96 -0
  284. package/kits/hub-game/models/hats/sailor.pxmodel +141 -0
  285. package/kits/hub-game/models/hats/souwester.pxmodel +131 -0
  286. package/kits/hub-game/models/hats/straw.pxmodel +139 -0
  287. package/kits/hub-game/models/hats/sunflower.pxmodel +406 -0
  288. package/kits/hub-game/models/hats/sweatband.pxmodel +112 -0
  289. package/kits/hub-game/models/hats/witch.pxmodel +147 -0
  290. package/kits/hub-game/package-lock.json +10 -1
  291. package/kits/hub-game/package.json +6 -2
  292. package/kits/hub-game/play/player.js +142 -0
  293. package/kits/hub-game/play/registry.js +47 -0
  294. package/kits/hub-game/play.jsx +37 -0
  295. package/kits/hub-game/scripts/check.mjs +117 -16
  296. package/kits/hub-game/scripts/companion-follower-wire.json +1 -0
  297. package/kits/hub-game/scripts/fixtures/decor-keyless-draw.json +132 -0
  298. package/kits/hub-game/scripts/fixtures/decor-keyless.json +293 -0
  299. package/kits/hub-game/scripts/fixtures/engine-models-stub.mjs +26 -0
  300. package/kits/hub-game/scripts/fixtures/fake-dom.mjs +123 -0
  301. package/kits/hub-game/scripts/fixtures/interest-legacy.json +385 -0
  302. package/kits/hub-game/scripts/fixtures/npc-notes-v1.77.jsonl +4 -0
  303. package/kits/hub-game/scripts/fixtures/vis-shared-wire.json +1 -0
  304. package/kits/hub-game/scripts/gen-avatars.mjs +933 -16
  305. package/kits/hub-game/scripts/gen-earned.mjs +285 -0
  306. package/kits/hub-game/scripts/gen-hats.mjs +827 -0
  307. package/kits/hub-game/scripts/grab.before-orbit.mjs +400 -0
  308. package/kits/hub-game/scripts/pose-storage-fixture.mjs +46 -0
  309. package/kits/hub-game/scripts/soundscape-wave-analysis.mjs +125 -0
  310. package/kits/hub-game/scripts/test-act-client.mjs +186 -0
  311. package/kits/hub-game/scripts/test-act.mjs +171 -0
  312. package/kits/hub-game/scripts/test-action-layout.mjs +80 -0
  313. package/kits/hub-game/scripts/test-action-observers.mjs +46 -0
  314. package/kits/hub-game/scripts/test-actions-client.mjs +853 -0
  315. package/kits/hub-game/scripts/test-actions.mjs +298 -0
  316. package/kits/hub-game/scripts/test-actor-budget.mjs +44 -0
  317. package/kits/hub-game/scripts/test-actors.mjs +38 -23
  318. package/kits/hub-game/scripts/test-analytics.mjs +76 -0
  319. package/kits/hub-game/scripts/test-anonymous-entry.mjs +28 -0
  320. package/kits/hub-game/scripts/test-arrival-pose-server.mjs +196 -0
  321. package/kits/hub-game/scripts/test-arrival-pose.mjs +24 -0
  322. package/kits/hub-game/scripts/test-ask-client.mjs +358 -0
  323. package/kits/hub-game/scripts/test-ask-slot.mjs +85 -0
  324. package/kits/hub-game/scripts/test-ask.mjs +269 -0
  325. package/kits/hub-game/scripts/test-attention.mjs +10 -1
  326. package/kits/hub-game/scripts/test-avatar-cap.mjs +379 -0
  327. package/kits/hub-game/scripts/test-avatar-colors.mjs +72 -0
  328. package/kits/hub-game/scripts/test-avatar-models.mjs +181 -0
  329. package/kits/hub-game/scripts/test-avatar-share.mjs +318 -0
  330. package/kits/hub-game/scripts/test-avatar-wire.mjs +792 -0
  331. package/kits/hub-game/scripts/test-avatar.mjs +584 -7
  332. package/kits/hub-game/scripts/test-back-visibility.mjs +82 -0
  333. package/kits/hub-game/scripts/test-ballot.mjs +1008 -0
  334. package/kits/hub-game/scripts/test-ban-join.mjs +121 -13
  335. package/kits/hub-game/scripts/test-build.mjs +49 -0
  336. package/kits/hub-game/scripts/test-cells.mjs +71 -0
  337. package/kits/hub-game/scripts/test-chat.mjs +863 -0
  338. package/kits/hub-game/scripts/test-classic.mjs +2 -0
  339. package/kits/hub-game/scripts/test-companion-chat.mjs +216 -0
  340. package/kits/hub-game/scripts/test-companion-client.mjs +1167 -0
  341. package/kits/hub-game/scripts/test-companion.mjs +259 -0
  342. package/kits/hub-game/scripts/test-control-layout-dom.mjs +120 -0
  343. package/kits/hub-game/scripts/test-crowd-names.mjs +205 -0
  344. package/kits/hub-game/scripts/test-decor-client.mjs +344 -0
  345. package/kits/hub-game/scripts/test-decor.mjs +464 -0
  346. package/kits/hub-game/scripts/test-default-environment-root.mjs +95 -0
  347. package/kits/hub-game/scripts/test-default-environment.mjs +267 -0
  348. package/kits/hub-game/scripts/test-door-analytics.mjs +58 -0
  349. package/kits/hub-game/scripts/test-door-jump.mjs +100 -0
  350. package/kits/hub-game/scripts/test-earned-client.mjs +459 -0
  351. package/kits/hub-game/scripts/test-earned.mjs +1224 -0
  352. package/kits/hub-game/scripts/test-emote-bubble.mjs +110 -0
  353. package/kits/hub-game/scripts/test-far-avatars.mjs +340 -0
  354. package/kits/hub-game/scripts/test-fps-telemetry.mjs +112 -0
  355. package/kits/hub-game/scripts/test-frame-batch.mjs +252 -0
  356. package/kits/hub-game/scripts/test-fresh-friends.mjs +118 -0
  357. package/kits/hub-game/scripts/test-friend-bests.mjs +435 -0
  358. package/kits/hub-game/scripts/test-grab-orbit.mjs +961 -0
  359. package/kits/hub-game/scripts/test-grab.mjs +7 -0
  360. package/kits/hub-game/scripts/test-hats.mjs +422 -168
  361. package/kits/hub-game/scripts/test-high-only.mjs +170 -0
  362. package/kits/hub-game/scripts/test-hub-leaving.mjs +203 -0
  363. package/kits/hub-game/scripts/test-hub-ops.mjs +758 -2
  364. package/kits/hub-game/scripts/test-hub-trip.mjs +1594 -12
  365. package/kits/hub-game/scripts/test-hud-clear.mjs +484 -57
  366. package/kits/hub-game/scripts/test-hud-defects-dom.mjs +100 -0
  367. package/kits/hub-game/scripts/test-hud-rate.mjs +224 -0
  368. package/kits/hub-game/scripts/test-hud-safe-visibility-dom.mjs +83 -0
  369. package/kits/hub-game/scripts/test-idle.mjs +427 -1
  370. package/kits/hub-game/scripts/test-interest-cap.mjs +36 -0
  371. package/kits/hub-game/scripts/test-interest-cells.mjs +513 -0
  372. package/kits/hub-game/scripts/test-interest-client.mjs +118 -0
  373. package/kits/hub-game/scripts/test-interest.mjs +15 -0
  374. package/kits/hub-game/scripts/test-invites-client.mjs +430 -0
  375. package/kits/hub-game/scripts/test-invites.mjs +109 -0
  376. package/kits/hub-game/scripts/test-keys.mjs +46 -1
  377. package/kits/hub-game/scripts/test-labels.mjs +664 -0
  378. package/kits/hub-game/scripts/test-landscape-layout.mjs +194 -0
  379. package/kits/hub-game/scripts/test-list-scroll-dom.mjs +49 -0
  380. package/kits/hub-game/scripts/test-load-abandon.mjs +246 -0
  381. package/kits/hub-game/scripts/test-loading-cover.mjs +162 -0
  382. package/kits/hub-game/scripts/test-manifest.mjs +472 -0
  383. package/kits/hub-game/scripts/test-menu-client.mjs +585 -0
  384. package/kits/hub-game/scripts/test-menu.mjs +319 -0
  385. package/kits/hub-game/scripts/test-npcs.mjs +2528 -13
  386. package/kits/hub-game/scripts/test-object-entry.mjs +76 -0
  387. package/kits/hub-game/scripts/test-observed.mjs +745 -0
  388. package/kits/hub-game/scripts/test-pack.mjs +7 -0
  389. package/kits/hub-game/scripts/test-pad-cues.mjs +304 -0
  390. package/kits/hub-game/scripts/test-pad-occupancy.mjs +177 -0
  391. package/kits/hub-game/scripts/test-picker.mjs +541 -0
  392. package/kits/hub-game/scripts/test-placement-cache.mjs +690 -0
  393. package/kits/hub-game/scripts/test-progress-reset.mjs +559 -0
  394. package/kits/hub-game/scripts/test-push-visit.mjs +26 -0
  395. package/kits/hub-game/scripts/test-quality.mjs +385 -0
  396. package/kits/hub-game/scripts/test-rehello.mjs +1733 -0
  397. package/kits/hub-game/scripts/test-relations-among.mjs +222 -0
  398. package/kits/hub-game/scripts/test-relations-refresh.mjs +188 -0
  399. package/kits/hub-game/scripts/test-resume-action-order.mjs +598 -0
  400. package/kits/hub-game/scripts/test-resume-held.mjs +239 -0
  401. package/kits/hub-game/scripts/test-resume-pose.mjs +142 -0
  402. package/kits/hub-game/scripts/test-safe-events-dom.mjs +116 -0
  403. package/kits/hub-game/scripts/test-safe-layout.mjs +330 -0
  404. package/kits/hub-game/scripts/test-say.mjs +1 -1
  405. package/kits/hub-game/scripts/test-shot.mjs +901 -0
  406. package/kits/hub-game/scripts/test-signin-client.mjs +45 -0
  407. package/kits/hub-game/scripts/test-soundscape.mjs +5437 -0
  408. package/kits/hub-game/scripts/test-spin.mjs +314 -0
  409. package/kits/hub-game/scripts/test-standing.mjs +449 -0
  410. package/kits/hub-game/scripts/test-storage-limit.mjs +333 -0
  411. package/kits/hub-game/scripts/test-stuck.mjs +1904 -0
  412. package/kits/hub-game/scripts/test-talk-overlay-dom.mjs +130 -0
  413. package/kits/hub-game/scripts/test-tier-cells.mjs +706 -0
  414. package/kits/hub-game/scripts/test-tiers-render.mjs +412 -0
  415. package/kits/hub-game/scripts/test-tiers.mjs +476 -2
  416. package/kits/hub-game/scripts/test-toast-band.mjs +61 -0
  417. package/kits/hub-game/scripts/test-try-on.mjs +22 -22
  418. package/kits/hub-game/scripts/test-vis.mjs +770 -0
  419. package/kits/hub-game/scripts/test-visibility.mjs +134 -0
  420. package/kits/hub-game/scripts/test-weakest-tier.mjs +924 -0
  421. package/kits/hub-game/scripts/test-world-labels.mjs +367 -0
  422. package/kits/hub-game/scripts/test-yours-chrome.mjs +210 -0
  423. package/kits/hub-game/scripts/test-yours.mjs +403 -0
  424. package/kits/multiplayer-3d/CLAUDE.md +50 -0
  425. package/kits/multiplayer-3d/castle.json +5 -5
  426. package/kits/multiplayer-3d/code/client/avatars.js +7 -0
  427. package/kits/multiplayer-3d/code/client/gait.js +65 -0
  428. package/kits/multiplayer-3d/code/client/joinFailure.js +27 -0
  429. package/kits/multiplayer-3d/code/client/nameTags.js +59 -4
  430. package/kits/multiplayer-3d/code/client/resumeGate.js +139 -0
  431. package/kits/multiplayer-3d/code/options.js +5 -0
  432. package/kits/multiplayer-3d/code/server/ownership.js +10 -2
  433. package/kits/multiplayer-3d/code/server/sceneBodies.js +12 -0
  434. package/kits/multiplayer-3d/code/server/world.js +7 -0
  435. package/kits/multiplayer-3d/code/systems/multiplayer.js +443 -34
  436. package/kits/multiplayer-3d/package-lock.json +8 -1
  437. package/kits/multiplayer-3d/package.json +3 -1
  438. package/kits/multiplayer-3d/scripts/fixtures/README.md +11 -0
  439. package/kits/multiplayer-3d/scripts/fixtures/ownership-legacy.json +2 -0
  440. package/kits/multiplayer-3d/scripts/ownership-harness.mjs +102 -0
  441. package/kits/multiplayer-3d/scripts/ownership-loader.mjs +46 -0
  442. package/kits/multiplayer-3d/scripts/ownership-worker.mjs +15 -0
  443. package/kits/multiplayer-3d/scripts/record-ownership-session.mjs +98 -0
  444. package/kits/multiplayer-3d/scripts/test-eligible-claims.mjs +167 -0
  445. package/kits/multiplayer-3d/scripts/test-join-watchdog.mjs +436 -0
  446. package/kits/multiplayer-3d/scripts/test-own-name-tag.mjs +247 -0
  447. package/kits/multiplayer-3d/scripts/test-resume-gate.mjs +624 -0
  448. package/kits/physics-2d/CLAUDE.md +19 -1
  449. package/kits/physics-2d/castle.json +2 -2
  450. package/kits/physics-2d/engine/frozenActors.js +233 -0
  451. package/kits/physics-2d/engine/scene.js +337 -3
  452. package/kits/physics-2d/engine/skyKey.js +129 -0
  453. package/kits/physics-2d/engine/stillClock.js +106 -0
  454. package/kits/physics-2d/engine/updateBudget.js +21 -0
  455. package/kits/physics-2d/eslint.config.js +1 -1
  456. package/kits/physics-2d/play/behaviors/AnalogStick.js +198 -0
  457. package/kits/physics-2d/play/behaviors/Camera.js +40 -0
  458. package/kits/physics-2d/play/behaviors/Collider.js +122 -0
  459. package/kits/physics-2d/play/behaviors/Draggable.js +115 -0
  460. package/kits/physics-2d/play/behaviors/Goal.js +46 -0
  461. package/kits/physics-2d/play/behaviors/Joints.js +126 -0
  462. package/kits/physics-2d/play/behaviors/Layout.js +71 -0
  463. package/kits/physics-2d/play/behaviors/RigidBody.js +57 -0
  464. package/kits/physics-2d/play/behaviors/Slingshot.js +142 -0
  465. package/kits/physics-2d/play/behaviors/SoundPlayer.js +263 -0
  466. package/kits/physics-2d/play/behaviors/Sprite.js +406 -0
  467. package/kits/physics-2d/play/behaviors/Style.js +209 -0
  468. package/kits/physics-2d/play/behaviors/Text.js +85 -0
  469. package/kits/physics-2d/play/behaviors/Video.js +93 -0
  470. package/kits/physics-2d/scripts/test-skip-unchanged.mjs +326 -1
  471. package/kits/physics-3d/CLAUDE.md +42 -529
  472. package/kits/physics-3d/behaviors/Body.jsx +3 -0
  473. package/kits/physics-3d/behaviors/Model.jsx +3 -0
  474. package/kits/physics-3d/behaviors/Player.jsx +661 -87
  475. package/kits/physics-3d/behaviors/Shape.jsx +3 -0
  476. package/kits/physics-3d/behaviors/Solid.jsx +3 -0
  477. package/kits/physics-3d/behaviors/Transform.jsx +3 -0
  478. package/kits/physics-3d/castle.json +3 -3
  479. package/kits/physics-3d/docs/engine-camera.md +542 -0
  480. package/kits/physics-3d/docs/engine-frame-cap.md +136 -0
  481. package/kits/physics-3d/docs/engine-load.md +149 -0
  482. package/kits/physics-3d/docs/engine-look.md +114 -0
  483. package/kits/physics-3d/docs/engine-shadows.md +372 -0
  484. package/kits/physics-3d/docs/engine-skip-work.md +187 -0
  485. package/kits/physics-3d/docs/engine-sky.md +198 -0
  486. package/kits/physics-3d/docs/engine-static-actors.md +226 -0
  487. package/kits/physics-3d/docs/engine-view.md +37 -0
  488. package/kits/physics-3d/docs/pxmodel-format.md +9 -1
  489. package/kits/physics-3d/engine3d/PlayOnly3D.jsx +5 -1
  490. package/kits/physics-3d/engine3d/Scene3DPlayer.jsx +19 -277
  491. package/kits/physics-3d/engine3d/actornode.js +87 -0
  492. package/kits/physics-3d/engine3d/animationBudget.js +23 -0
  493. package/kits/physics-3d/engine3d/branches.js +3 -13
  494. package/kits/physics-3d/engine3d/cage.js +2 -7
  495. package/kits/physics-3d/engine3d/cageops.js +2 -17
  496. package/kits/physics-3d/engine3d/dataBehaviors.js +12 -0
  497. package/kits/physics-3d/engine3d/editorWorld.js +6 -0
  498. package/kits/physics-3d/engine3d/emptynodes.js +232 -0
  499. package/kits/physics-3d/engine3d/framecap.js +99 -0
  500. package/kits/physics-3d/engine3d/frozenphysics.js +140 -0
  501. package/kits/physics-3d/engine3d/frozenstatics.js +273 -0
  502. package/kits/physics-3d/engine3d/gait.js +126 -0
  503. package/kits/physics-3d/engine3d/initialModelFiles.js +18 -0
  504. package/kits/physics-3d/engine3d/kithooks.js +47 -0
  505. package/kits/physics-3d/engine3d/look.js +514 -48
  506. package/kits/physics-3d/engine3d/lookbake.js +208 -0
  507. package/kits/physics-3d/engine3d/materialpresets.js +2 -0
  508. package/kits/physics-3d/engine3d/modelFiles.js +3 -17
  509. package/kits/physics-3d/engine3d/modelMath.js +49 -0
  510. package/kits/physics-3d/engine3d/modelready.js +16 -0
  511. package/kits/physics-3d/engine3d/motion.js +39 -10
  512. package/kits/physics-3d/engine3d/nearshadows.js +106 -21
  513. package/kits/physics-3d/engine3d/optimize.js +9 -5
  514. package/kits/physics-3d/engine3d/orbitinput.js +522 -10
  515. package/kits/physics-3d/engine3d/orbitlens.js +48 -0
  516. package/kits/physics-3d/engine3d/ownmodel.js +213 -0
  517. package/kits/physics-3d/engine3d/partgeometry.js +1 -16
  518. package/kits/physics-3d/engine3d/paths.js +1 -9
  519. package/kits/physics-3d/engine3d/playTimings.js +50 -0
  520. package/kits/physics-3d/engine3d/playerRun.js +372 -0
  521. package/kits/physics-3d/engine3d/pxmodel.js +42 -11
  522. package/kits/physics-3d/engine3d/rapier.js +27 -0
  523. package/kits/physics-3d/engine3d/scatter.js +1 -11
  524. package/kits/physics-3d/engine3d/shadowfade.js +890 -0
  525. package/kits/physics-3d/engine3d/sky.js +547 -0
  526. package/kits/physics-3d/engine3d/skylife.js +306 -0
  527. package/kits/physics-3d/engine3d/squarefirst.js +177 -0
  528. package/kits/physics-3d/engine3d/stillshadows.js +399 -0
  529. package/kits/physics-3d/engine3d/sweep.js +1 -25
  530. package/kits/physics-3d/engine3d/unchanged.js +11 -0
  531. package/kits/physics-3d/engine3d/viewrange.js +52 -0
  532. package/kits/physics-3d/engine3d/world3d.js +1253 -76
  533. package/kits/physics-3d/eslint.config.js +2 -1
  534. package/kits/physics-3d/main.jsx +10 -2
  535. package/kits/physics-3d/package-lock.json +7 -0
  536. package/kits/physics-3d/package.json +5 -1
  537. package/kits/physics-3d/play/behaviors/Body.js +31 -0
  538. package/kits/physics-3d/play/behaviors/Door.js +37 -0
  539. package/kits/physics-3d/play/behaviors/Lookable.js +16 -0
  540. package/kits/physics-3d/play/behaviors/Model.js +23 -0
  541. package/kits/physics-3d/play/behaviors/Pickup.js +46 -0
  542. package/kits/physics-3d/play/behaviors/Player.js +1204 -0
  543. package/kits/physics-3d/play/behaviors/Shape.js +47 -0
  544. package/kits/physics-3d/play/behaviors/Solid.js +16 -0
  545. package/kits/physics-3d/play/behaviors/Transform.js +29 -0
  546. package/kits/physics-3d/pnpm-lock.yaml +8 -0
  547. package/kits/physics-3d/scripts/bench-shadow-fade.mjs +37 -0
  548. package/kits/physics-3d/scripts/build-rapier-gz.mjs +56 -0
  549. package/kits/physics-3d/scripts/frozen-statics-fixture.mjs +141 -0
  550. package/kits/physics-3d/scripts/look-baseline.mjs +155 -0
  551. package/kits/physics-3d/scripts/test-camera-follow.mjs +5 -1
  552. package/kits/physics-3d/scripts/test-camera-orbit.mjs +2613 -82
  553. package/kits/physics-3d/scripts/test-drop-empty-parts.mjs +2 -2
  554. package/kits/physics-3d/scripts/test-empty-gait-hints.mjs +89 -0
  555. package/kits/physics-3d/scripts/test-frame-cap-bob.mjs +438 -0
  556. package/kits/physics-3d/scripts/test-frame-cap.mjs +452 -0
  557. package/kits/physics-3d/scripts/test-frozen-nested.mjs +49 -0
  558. package/kits/physics-3d/scripts/test-frozen-statics-legacy-physics2d.mjs +123 -0
  559. package/kits/physics-3d/scripts/test-frozen-statics.mjs +434 -0
  560. package/kits/physics-3d/scripts/test-gait.mjs +387 -0
  561. package/kits/physics-3d/scripts/test-look-bake.mjs +1056 -0
  562. package/kits/physics-3d/scripts/test-model-parse-cache.mjs +92 -0
  563. package/kits/physics-3d/scripts/test-near-shadows.mjs +5 -2
  564. package/kits/physics-3d/scripts/test-orbit-shadow-fade.mjs +2001 -0
  565. package/kits/physics-3d/scripts/test-orbit-shift-lock.mjs +582 -0
  566. package/kits/physics-3d/scripts/test-orbit-shot.mjs +657 -0
  567. package/kits/physics-3d/scripts/test-orbit-view.mjs +230 -0
  568. package/kits/physics-3d/scripts/test-rapier-gz.mjs +106 -0
  569. package/kits/physics-3d/scripts/test-skip-empty-nodes.mjs +845 -0
  570. package/kits/physics-3d/scripts/test-sky.mjs +2470 -0
  571. package/kits/physics-3d/scripts/test-square-first.mjs +921 -0
  572. package/kits/physics-3d/scripts/test-static-actors.mjs +10 -1
  573. package/kits/physics-3d/scripts/test-static-physics.mjs +4 -1
  574. package/kits/physics-3d/scripts/test-static-scenery.mjs +2174 -0
  575. package/kits/physics-3d/scripts/test-steady-hover.mjs +7 -2
  576. package/kits/physics-3d/scripts/test-still-shadows.mjs +477 -0
  577. package/kits/physics-3d/scripts/test-view-range.mjs +260 -0
  578. package/kits/physics-3d/systems/physics3d.js +419 -9
  579. package/kits/real-time/castle.json +2 -2
  580. package/kits/real-time/code/client/connection.js +33 -10
  581. package/kits/real-time/code/client/gameHooks.js +2 -0
  582. package/kits/real-time/code/client/joinOverlay.js +9 -4
  583. package/kits/real-time/code/server/gameHooks.js +7 -0
  584. package/kits/real-time/code/server/session.js +102 -22
  585. package/kits/real-time/package-lock.json +1 -1
  586. package/package.json +2 -2
  587. package/dist/shell/assets/index-Cf61cNfT.css +0 -1
@@ -0,0 +1,126 @@
1
+ // Generated from ../../behaviors/Joints.jsx; run npm run sync:play-behaviors.
2
+ import { layoutCenter } from '../../engine/layout';
3
+ import { inActorWorldSpace } from '../../engine/physics/controls';
4
+ import '../../engine/physics/joints';
5
+ import { drawJointArt } from '../../engine/physics/jointArt';
6
+
7
+ // Joints: connect this actor to one or more `target` actors with physics links.
8
+ // The component holds a LIST so an actor can carry several links at once (a
9
+ // a body both sprung and roped, a truss node). Each entry picks a TYPE -- spring
10
+ // (elastic), rod (rigid stick, ends rotate; also the hinge -- to a static anchor),
11
+ // weld (fused, no relative rotation), rope (slack, taut at max length). The
12
+ // simulation builds the matter constraints
13
+ // (see physics/joints.js); this behavior owns the authoring UI + editor overlay.
14
+ //
15
+ // Both actors of a link need a Collider (to have a body); the owner is usually a
16
+ // dynamic RigidBody and each target either dynamic or a static anchor. `target`
17
+ // is instance-local -- pick it per instance, since a blueprint-level target would
18
+ // point every instance at the same actor.
19
+ class Joints {
20
+ static behaviorName = 'Joints';
21
+ // A link binds two bodies, so the OWNER needs a Collider to have one. Only the
22
+ // owner: the `target` actor needs one too, but it isn't a sibling -- it's a
23
+ // separate actor the author picks later, and inventing a Collider on it isn't
24
+ // this hook's business.
25
+ static expectedSiblings = ['Collider'];
26
+ static defaultProps = { list: [] };
27
+ // A freshly-added Joints behavior starts with one blank link to fill in.
28
+ static initialProps() {
29
+ return { list: [defaultJoint()] };
30
+ }
31
+ constructor(props) {
32
+ this.props = props;
33
+ }
34
+ // Draw every link. In the EDITOR (options.editPlaceholders) it's an authoring
35
+ // overlay -- always shown so connections are visible, sprite-art previewed
36
+ // WYSIWYG, and even `hidden` joints drawn as a faint line so you don't lose
37
+ // them. In PLAY each joint's `render` decides: `hidden` (nothing), `line` (the
38
+ // schematic) or `sprite` (art along the joint). Drawn in world space so the
39
+ // link doesn't spin with the actor's rotation (see inActorWorldSpace).
40
+ draw(actor, scene, ctx, options) {
41
+ const list = Array.isArray(this.props.list) ? this.props.list : [];
42
+ if (!list.length)
43
+ return;
44
+ const editing = Boolean(options.editPlaceholders);
45
+ const emphasized = options.colliderOverlayIds?.includes(actor.id) ||
46
+ scene.usesBlueprint(actor, options.dimBlueprintPath);
47
+ const a = layoutCenter(actor.components.Layout);
48
+ inActorWorldSpace(ctx, actor.components.Layout, (g) => {
49
+ for (const joint of list) {
50
+ const target = joint?.target && scene.getActor(joint.target);
51
+ if (!target || target.id === actor.id)
52
+ continue;
53
+ const b = layoutCenter(target.components.Layout);
54
+ // hidden shows as a faint line in the editor, nothing in play.
55
+ let render = joint.render ?? 'line';
56
+ if (editing && render === 'hidden')
57
+ render = 'line';
58
+ if (render === 'hidden')
59
+ continue;
60
+ if (render === 'sprite' && drawJointArt(g, scene, joint, a, b))
61
+ continue;
62
+ g.globalAlpha = editing ? (emphasized ? 1 : 0.45) : 0.7;
63
+ g.strokeStyle = '#c9a9ff';
64
+ g.fillStyle = '#c9a9ff';
65
+ g.lineWidth = 2;
66
+ drawLink(g, a, b, joint.type ?? 'spring');
67
+ g.globalAlpha = 1;
68
+ }
69
+ });
70
+ }
71
+ }
72
+ function defaultJoint() {
73
+ return { type: 'spring', target: '', length: -1, springiness: 0.4, damping: 0.1, render: 'line' };
74
+ }
75
+ // Draw the link between two world points, styled by joint type: spring coils,
76
+ // rope dashes, weld doubles the line, rod is a plain line.
77
+ function drawLink(ctx, a, b, type) {
78
+ if (type === 'spring')
79
+ return drawCoil(ctx, a, b);
80
+ if (type === 'rope') {
81
+ ctx.setLineDash([6, 5]);
82
+ line(ctx, a, b);
83
+ ctx.setLineDash([]);
84
+ return;
85
+ }
86
+ if (type === 'weld')
87
+ return drawDouble(ctx, a, b);
88
+ line(ctx, a, b); // rod (and any fallthrough)
89
+ }
90
+ function line(ctx, a, b) {
91
+ ctx.beginPath();
92
+ ctx.moveTo(a.x, a.y);
93
+ ctx.lineTo(b.x, b.y);
94
+ ctx.stroke();
95
+ }
96
+ // Two parallel lines offset along the perpendicular -- the "fused" read.
97
+ function drawDouble(ctx, a, b) {
98
+ const dx = b.x - a.x;
99
+ const dy = b.y - a.y;
100
+ const len = Math.hypot(dx, dy) || 1;
101
+ const nx = (-dy / len) * 3;
102
+ const ny = (dx / len) * 3;
103
+ line(ctx, { x: a.x + nx, y: a.y + ny }, { x: b.x + nx, y: b.y + ny });
104
+ line(ctx, { x: a.x - nx, y: a.y - ny }, { x: b.x - nx, y: b.y - ny });
105
+ }
106
+ // A zig-zag coil between the endpoints, straight stubs at each end.
107
+ function drawCoil(ctx, a, b) {
108
+ const dx = b.x - a.x;
109
+ const dy = b.y - a.y;
110
+ const len = Math.hypot(dx, dy) || 1;
111
+ const px = -dy / len;
112
+ const py = dx / len;
113
+ const coils = Math.max(3, Math.min(10, Math.round(len / 22)));
114
+ const amp = 6;
115
+ ctx.beginPath();
116
+ ctx.moveTo(a.x, a.y);
117
+ for (let i = 1; i < coils; i++) {
118
+ const t = i / coils;
119
+ const side = i % 2 === 0 ? 1 : -1;
120
+ ctx.lineTo(a.x + dx * t + px * amp * side, a.y + dy * t + py * amp * side);
121
+ }
122
+ ctx.lineTo(b.x, b.y);
123
+ ctx.stroke();
124
+ }
125
+
126
+ export { Joints };
@@ -0,0 +1,71 @@
1
+ // Generated from ../../behaviors/Layout.jsx; run npm run sync:play-behaviors.
2
+ import { DEFAULT_ORIGIN_Y, DEFAULT_ORIGIN_X, layoutRect } from '../../engine/layout';
3
+
4
+ class Layout {
5
+ static behaviorName = 'Layout';
6
+ static defaultProps = {
7
+ x: 0,
8
+ y: 0,
9
+ z: 0,
10
+ rotation: 0,
11
+ width: 50,
12
+ height: 50,
13
+ // Which point of the box `x`/`y` names, as a fraction of the box from its
14
+ // own top-left: `0, 0` top-left, `0.5, 0.5` center (the default, and what
15
+ // an absent origin means -- see DEFAULT_ORIGIN_* in engine/layout.js),
16
+ // `1, 1` bottom-right. Not clamped. Rotation still pivots on the box
17
+ // CENTER -- the origin anchors position only.
18
+ originX: DEFAULT_ORIGIN_X,
19
+ originY: DEFAULT_ORIGIN_Y,
20
+ // Show the Layout box (the invisible frame the sprite fills and the collider
21
+ // derives from) as a dashed outline, in editor and play. Per-actor toggle.
22
+ debug: false,
23
+ };
24
+ // Position first: it is what tells two instances of the same blueprint apart,
25
+ // and the first thing you look for when the panel is shut.
26
+ static summary(props) {
27
+ const round = (n) => Math.round(Number(n) || 0);
28
+ return `${round(props.x)}, ${round(props.y)} · ${round(props.width)}×${round(props.height)}`;
29
+ }
30
+ // Position/rotation/z never inherit from a blueprint: they're always written
31
+ // as instance values at placement time (z gets an explicit top-of-stack value
32
+ // on spawn), and a blueprint edit to its own template x/y/z/rotation only
33
+ // affects newly placed instances, never moves ones already placed. Because
34
+ // they're always instance-local, they're also never surfaced as blueprint
35
+ // "overrides" in the inspector. width/height default to inherited (absent),
36
+ // and so does the origin: it describes the KIND of thing (a ball is placed by
37
+ // its center), so it belongs on the blueprint -- with a per-instance override
38
+ // available like any other inherited prop.
39
+ //
40
+ // Size is width/height in card units -- the same space you compose in. A
41
+ // user-facing scaleX/scaleY (relative to the sprite's native pixels) was
42
+ // tried and reverted: it only pays off under pixel-perfect (integer scales),
43
+ // and in today's card-units model it just adds a conversion + couples Layout
44
+ // to the Sprite. Revisit scale fields when pixel-perfect mode lands. See
45
+ // ~/castle/cauldron-rendering-scale-model.md.
46
+ static propertyMeta = {
47
+ x: { inherit: false },
48
+ y: { inherit: false },
49
+ z: { inherit: false },
50
+ rotation: { inherit: false },
51
+ };
52
+ constructor(props) {
53
+ this.props = props;
54
+ }
55
+ // Outline the Layout box when `debug` is on. Drawn in the actor's own rotated
56
+ // frame (so it rotates with the actor), with a distinct dashed lavender style
57
+ // so it reads separately from the solid collider debug and the selection box.
58
+ draw(actor, scene, ctx) {
59
+ if (!this.props.debug)
60
+ return;
61
+ const rect = layoutRect(this.props);
62
+ ctx.save();
63
+ ctx.strokeStyle = 'rgba(190, 178, 255, 0.75)';
64
+ ctx.setLineDash([4, 3]);
65
+ ctx.lineWidth = 1.5;
66
+ ctx.strokeRect(rect.x + 0.5, rect.y + 0.5, rect.width - 1, rect.height - 1);
67
+ ctx.restore();
68
+ }
69
+ }
70
+
71
+ export { Layout };
@@ -0,0 +1,57 @@
1
+ // Generated from ../../behaviors/RigidBody.jsx; run npm run sync:play-behaviors.
2
+ import { DAMPING } from '../../engine/propertyRanges';
3
+
4
+ // RigidBody makes an actor a physics object. Pair it with a Collider (which
5
+ // gives the shape + material). The simulation reads these props each frame; the
6
+ // behavior itself does no per-frame work -- author code drives motion through
7
+ // `scene.physics` (setVelocity / applyImpulse / applyForce).
8
+ //
9
+ // bodyType 'dynamic' -> simulated: gravity, collisions, forces move it.
10
+ // 'static' -> never moves (a wall); a Collider alone is also this.
11
+ // 'kinematic' -> unpushable, but you move it by writing its Layout.
12
+ // gravityScale -> multiplies world gravity for this body (0 = float).
13
+ // drag -> linear damping (matter frictionAir).
14
+ // angularDrag -> extra spin damping.
15
+ // freezeRotation -> lock rotation (stays upright).
16
+ // velocityX/velocityY -> initial velocity, applied once when play starts.
17
+ class RigidBody {
18
+ static behaviorName = 'RigidBody';
19
+ // No Collider means no body at all (matterBridge's `isPhysicsActor`), so a
20
+ // RigidBody on its own simulates nothing.
21
+ static expectedSiblings = ['Collider'];
22
+ static defaultProps = {
23
+ bodyType: 'dynamic',
24
+ // New bodies float until the author opts into gravity — falling immediately
25
+ // on add is the common surprise when placing a dynamic body to push around.
26
+ gravityScale: 0,
27
+ drag: 0.01,
28
+ angularDrag: 0,
29
+ freezeRotation: false,
30
+ velocityX: 0,
31
+ velocityY: 0,
32
+ // Initial spin, degrees per fixed step (like velocityX/Y are px per step),
33
+ // applied once when play starts.
34
+ angularVelocity: 0,
35
+ };
36
+ // Body type is the whole question about a rigid body: does this thing fall,
37
+ // sit still, or get pushed around by hand.
38
+ static summary(props) {
39
+ return typeof props.bodyType === 'string' ? props.bodyType : '';
40
+ }
41
+ // `drag`/`angularDrag` are matter's air friction, where values above 1 flip
42
+ // the velocity sign and destabilize the body -- so 1 is a real ceiling, not a
43
+ // convenience. `gravityScale` deliberately has none: negative is legitimate
44
+ // (it inverts gravity), as is scaling well past 1. Drag steps at 0.005 so the
45
+ // scrubber lands on the default (0.01) and the finer authored values kits use.
46
+ static propertyMeta = {
47
+ gravityScale: { step: 0.1 },
48
+ drag: { ...DAMPING, step: 0.005 },
49
+ angularDrag: DAMPING,
50
+ angularVelocity: { step: 0.1 },
51
+ };
52
+ constructor(props) {
53
+ this.props = props;
54
+ }
55
+ }
56
+
57
+ export { RigidBody };
@@ -0,0 +1,142 @@
1
+ // Generated from ../../behaviors/Slingshot.jsx; run npm run sync:play-behaviors.
2
+ import { PIXELS } from '../../engine/propertyRanges';
3
+ import { acquirePress, TARGETED_CLAIM, GREEDY_CLAIM, slingLaunch, slingPull, inActorWorldSpace } from '../../engine/physics/controls';
4
+
5
+ // Slingshot: pull back and release to fling the actor the opposite way
6
+ // (angry-birds style) -- the physics feel of castle-client's Sling. While
7
+ // aiming it draws an arrow showing the launch direction and power. Needs a
8
+ // RigidBody (dynamic) + Collider.
9
+ //
10
+ // speed -> launch velocity per pixel of pull.
11
+ // maxDrag -> pull distance cap (also caps launch power).
12
+ // grabAnywhere -> start the sling from a press ANYWHERE on screen (default,
13
+ // like castle-client); set false to require pressing the actor.
14
+ class Slingshot {
15
+ static behaviorName = 'Slingshot';
16
+ // Launches a body, so it needs one: Collider + dynamic RigidBody.
17
+ static expectedSiblings = ['Collider', 'RigidBody'];
18
+ static defaultProps = {
19
+ speed: 0.08,
20
+ maxDrag: 160,
21
+ grabAnywhere: true,
22
+ };
23
+ // `speed` is a small multiplier (0.08 default), so whole-number steps were
24
+ // useless here. `maxDrag` is pixels of pull.
25
+ static propertyMeta = {
26
+ speed: { min: 0, step: 0.01 },
27
+ maxDrag: PIXELS,
28
+ };
29
+ static initialState = { slinging: false, pointerId: null, anchor: null, aim: null };
30
+ constructor(props) {
31
+ this.props = props;
32
+ }
33
+ update(actor, scene) {
34
+ const state = this.state;
35
+ if (!state.slinging) {
36
+ const grabAnywhere = this.props.grabAnywhere ?? true;
37
+ const press = acquirePress(scene, actor.id, (p) => {
38
+ // Collider-accurate, at the body's live orientation -- the same pick
39
+ // Draggable uses, so the two agree on what "on this actor" means.
40
+ const onSelf = scene.physics.actorAtPoint(p.x, p.y)?.id === actor.id;
41
+ if (!grabAnywhere && !onSelf)
42
+ return null;
43
+ // Pressing the body itself is an unambiguous aim; taking any press
44
+ // anywhere is not, so it yields to a control that was actually targeted.
45
+ return onSelf ? TARGETED_CLAIM : GREEDY_CLAIM;
46
+ });
47
+ if (press) {
48
+ state.pointerId = press.id;
49
+ state.slinging = true;
50
+ // Anchor at the press point (like castle-client): the aim/launch depends
51
+ // on the drag gesture, not where the press landed relative to the actor.
52
+ state.anchor = { x: press.x, y: press.y };
53
+ // A same-frame tap (down already false) is not an aim — cancel before we
54
+ // can launch with a zero pull. A TARGETED control that updates later this
55
+ // frame may still steal a greedy claim; we must not freeze velocity yet.
56
+ if (!press.down) {
57
+ state.slinging = false;
58
+ state.pointerId = null;
59
+ return;
60
+ }
61
+ }
62
+ }
63
+ if (!state.slinging)
64
+ return;
65
+ const p = scene.pointers.get(state.pointerId);
66
+ // Outranked mid-aim, or the contact was cancelled: drop the shot rather than
67
+ // launching from an anchor the player has stopped steering.
68
+ if (!p || !scene.ownsPointer(state.pointerId, actor.id)) {
69
+ state.slinging = false;
70
+ state.pointerId = null;
71
+ state.aim = null;
72
+ return;
73
+ }
74
+ if (p.down) {
75
+ // Hold still while aiming — but not on the press frame. A greedy claim can
76
+ // still lose to a higher claim that hasn't updated yet (e.g. a Draggable
77
+ // on the pressed body); freezing here would hitch a mid-air body for one frame
78
+ // and then drop the shot with no launch. Matches claimPointer's contract
79
+ // that the press frame costs a greedy control nothing visible.
80
+ if (!p.justPressed)
81
+ scene.physics.setVelocity(actor, { x: 0, y: 0 });
82
+ state.aim = { x: p.x, y: p.y };
83
+ }
84
+ else {
85
+ scene.physics.setVelocity(actor, slingLaunch(state.anchor, p, this.props));
86
+ state.slinging = false;
87
+ state.pointerId = null;
88
+ state.aim = null;
89
+ }
90
+ }
91
+ // Aim overlay in the castle-client style: a translucent grab circle plus a
92
+ // line + arrowhead pointing in the launch direction (opposite the pull).
93
+ draw(actor, scene, ctx) {
94
+ const state = this.state;
95
+ if (!state.slinging || !state.aim)
96
+ return;
97
+ const a = state.anchor;
98
+ const pull = slingPull(a, state.aim, this.props.maxDrag ?? 160);
99
+ const len = Math.hypot(pull.x, pull.y);
100
+ if (len < 0.001)
101
+ return;
102
+ const dir = { x: -pull.x / len, y: -pull.y / len }; // launch direction (opposite pull)
103
+ const end = { x: a.x - pull.x * 0.8, y: a.y - pull.y * 0.8 };
104
+ // Aim is drawn in world space because the anchor is on the actor.
105
+ inActorWorldSpace(ctx, actor.components.Layout, (c) => drawSling(c, a, end, dir));
106
+ }
107
+ }
108
+ // castle-client's sling overlay: a white grab circle (solid outline + faint
109
+ // fill) at `start`, a line to the base of a filled triangle arrowhead at `end`,
110
+ // pointing along `dir`. Sizes mirror sling.cpp (circle 18, arrowhead 25x10).
111
+ function drawSling(ctx, start, end, dir) {
112
+ const radius = 18;
113
+ const triLen = 25;
114
+ const triW = 10;
115
+ const baseX = end.x - dir.x * triLen;
116
+ const baseY = end.y - dir.y * triLen;
117
+ const perpX = -dir.y;
118
+ const perpY = dir.x;
119
+ ctx.lineWidth = 1.5;
120
+ // Grab circle.
121
+ ctx.fillStyle = 'rgba(255, 255, 255, 0.3)';
122
+ ctx.strokeStyle = 'rgba(255, 255, 255, 0.8)';
123
+ ctx.beginPath();
124
+ ctx.arc(start.x, start.y, radius, 0, Math.PI * 2);
125
+ ctx.fill();
126
+ ctx.stroke();
127
+ // Line from the grab circle to the arrowhead base.
128
+ ctx.beginPath();
129
+ ctx.moveTo(start.x, start.y);
130
+ ctx.lineTo(baseX, baseY);
131
+ ctx.stroke();
132
+ // Filled triangle arrowhead.
133
+ ctx.fillStyle = 'rgba(255, 255, 255, 0.8)';
134
+ ctx.beginPath();
135
+ ctx.moveTo(end.x, end.y);
136
+ ctx.lineTo(baseX + perpX * triW, baseY + perpY * triW);
137
+ ctx.lineTo(baseX - perpX * triW, baseY - perpY * triW);
138
+ ctx.closePath();
139
+ ctx.fill();
140
+ }
141
+
142
+ export { Slingshot };
@@ -0,0 +1,263 @@
1
+ // Generated from ../../behaviors/SoundPlayer.jsx; run npm run sync:play-behaviors.
2
+ import { resolveDeckFile } from 'castle-web-sdk';
3
+ import { mediaElement, setMediaPlaybackRate, setMediaPan, stopMedia, playMedia } from '../../engine/media';
4
+ import { isPreloadedPath, playSound } from '../../engine/sound';
5
+ import { PAN, UNIT } from '../../engine/propertyRanges';
6
+
7
+ // Plays one audio file (.mp3 / .wav / .m4a) from an actor.
8
+ //
9
+ // `stream` picks HOW it plays, which is the only real decision here:
10
+ //
11
+ // stream: false the sound is already decoded in memory, and plays instantly.
12
+ // Copies overlap. This is what a sound effect wants, and it is
13
+ // the default. Preloaded only if the file lives in
14
+ // `assets/sounds/` -- see engine/sound.js.
15
+ // stream: true an <audio> element, decoded as it plays. Nothing is held in
16
+ // memory, so this is what a music track or a long ambience
17
+ // wants -- a minute of audio is ~21MB decoded. One at a time:
18
+ // playing again restarts it rather than overlapping.
19
+ //
20
+ // Set `playOnStart` and it plays when the scene starts. Either way you can
21
+ // trigger it from a behavior:
22
+ //
23
+ // scene.getActor('music').behaviors.SoundPlayer.play();
24
+ // await actor.behaviors.SoundPlayer.play(); // ...and wait for it to end
25
+ // actor.behaviors.SoundPlayer.stop();
26
+ //
27
+ // `actor.runtime.soundPlayer` still holds the handle too (the older spelling,
28
+ // still written every `update`):
29
+ //
30
+ // scene.getActor('music').runtime.soundPlayer.play();
31
+ //
32
+ // To fire a sound effect that no actor owns -- most of them -- don't place one of
33
+ // these at all. `scene.sound.play('hit')` needs no actor and no import.
34
+ //
35
+ // Sound only plays during play, never in the editor: `update` is what wires it
36
+ // up, and the editor doesn't run it. Pressing Stop silences everything, as does
37
+ // `scene.sound.stopAll()` (see systems/media.js).
38
+ //
39
+ // Browsers refuse to play audio until the player has touched the page. A sound
40
+ // that starts before that isn't lost -- it's queued and starts on the first tap
41
+ // or key, which for a game is usually the first input anyway.
42
+ class SoundPlayer {
43
+ static behaviorName = 'SoundPlayer';
44
+ static defaultProps = {
45
+ file: '',
46
+ stream: false,
47
+ volume: 1,
48
+ playbackRate: 1,
49
+ pan: 0,
50
+ loop: false,
51
+ playOnStart: true,
52
+ };
53
+ // Mirrors the clamps `readSettings` already applies at runtime, so the
54
+ // inspector can't author a value the sound would silently ignore -- including
55
+ // playbackRate's 0.01..10, where the classic editor's ceiling lives.
56
+ static propertyMeta = {
57
+ stream: { hint: streamHint },
58
+ volume: UNIT,
59
+ playbackRate: { min: 0.01, max: 10, step: 0.05 },
60
+ pan: PAN,
61
+ };
62
+ static initialState = { handle: null };
63
+ constructor(props) {
64
+ this.props = props;
65
+ }
66
+ update(actor) {
67
+ if (actor.runtime.collected)
68
+ return;
69
+ const file = resolveDeckFile(this.props.file);
70
+ const settings = readSettings(this.props);
71
+ const previous = this.state.handle;
72
+ const handle = settings.stream
73
+ ? streamHandleFor(actor.id, file, settings, previous)
74
+ : bufferHandleFor(file, settings, previous);
75
+ this.state.handle = handle;
76
+ // Kept as the older spelling -- `scene.getActor('music').runtime.soundPlayer`
77
+ // still works alongside `.behaviors.SoundPlayer`.
78
+ actor.runtime.soundPlayer = handle;
79
+ // Only a NEW handle starts itself: this runs every frame, and `playOnStart`
80
+ // means the start of the scene, not the start of each one.
81
+ if (handle && handle !== previous && this.props.playOnStart)
82
+ void handle.play();
83
+ }
84
+ // Instance methods so `actor.behaviors.SoundPlayer.play()` works, delegating
85
+ // to whatever handle `update` last built. Before the first `update()` runs
86
+ // (frame 0, before any `update` has ticked -- see engine/scene.js's ordering,
87
+ // taps are processed before per-actor updates) `this.state.handle` is still
88
+ // null, so these are no-ops that frame; a pre-existing race (the old code had
89
+ // the identical gap via `actor.runtime.soundPlayer` being undefined until the
90
+ // first `update`), not a regression.
91
+ play() {
92
+ return this.state.handle?.play();
93
+ }
94
+ stop() {
95
+ this.state.handle?.stop();
96
+ }
97
+ pause() {
98
+ this.state.handle?.pause();
99
+ }
100
+ resume() {
101
+ this.state.handle?.resume();
102
+ }
103
+ get playing() {
104
+ return this.state.handle?.playing ?? false;
105
+ }
106
+ }
107
+ // What `stream` means, in the inspector, for the setting it is actually on --
108
+ // a note describing both halves of the toggle at once would say less than the
109
+ // prop's own name does. The third case is the one that bites: a sound outside
110
+ // assets/sounds/ plays, but not the first time it is asked for, and nothing else
111
+ // in the editor would ever tell you that.
112
+ function streamHint(on, component) {
113
+ if (on)
114
+ return 'Music and long sounds. Streamed, so nothing is held in memory.';
115
+ const file = resolveDeckFile(component?.file ?? '');
116
+ if (file && !isPreloadedPath(file)) {
117
+ return 'Short sfx. Move this file into assets/sounds/ to preload before first play, otherwise first play is silent.';
118
+ }
119
+ return 'Short sfx. Preloaded, so they fire instantly and overlap.';
120
+ }
121
+ function clamp(value, min, max, fallback) {
122
+ return Number.isFinite(value) ? Math.min(max, Math.max(min, value)) : fallback;
123
+ }
124
+ function readSettings(props) {
125
+ return {
126
+ stream: Boolean(props.stream),
127
+ volume: clamp(props.volume, 0, 1, 1),
128
+ // The same ceiling the classic editor used: past 10x a sound is a click.
129
+ playbackRate: clamp(props.playbackRate, 0.01, 10, 1),
130
+ pan: clamp(props.pan, -1, 1, 0),
131
+ loop: Boolean(props.loop),
132
+ };
133
+ }
134
+ function applyStreamSettings(element, settings) {
135
+ element.volume = settings.volume;
136
+ // Not a plain assignment: an element time-stretches by default, so this is
137
+ // what makes `playbackRate` mean the same retune on both paths. See
138
+ // engine/media.js.
139
+ setMediaPlaybackRate(element, settings.playbackRate);
140
+ element.loop = settings.loop;
141
+ if (settings.pan !== 0)
142
+ setMediaPan(element, settings.pan);
143
+ }
144
+ const warnedStreamOnly = new Set();
145
+ function streamOnly(method) {
146
+ if (warnedStreamOnly.has(method))
147
+ return;
148
+ warnedStreamOnly.add(method);
149
+ console.warn(`[SoundPlayer] ${method}() needs "stream" on -- a decoded sound has no playhead to hold. Ignored.`);
150
+ }
151
+ // Asking the pool for this actor's element EVERY frame is what keeps it alive:
152
+ // an entry nobody asks for is reaped as a despawned actor's leftovers (see
153
+ // engine/media.js). Skipping the ask on frames where the handle already matched
154
+ // meant a track went on sounding while its entry was reaped out from under the
155
+ // pool, past the reach of `stopAll`.
156
+ //
157
+ // A different file is a different pool entry, so comparing elements is also how
158
+ // a changed `file` prop gets a new handle.
159
+ function streamHandleFor(actorId, file, settings, previous) {
160
+ const element = mediaElement(actorId, 'audio', file);
161
+ if (!element)
162
+ return null;
163
+ // Props are live: turning the volume down or the pitch up in the inspector
164
+ // takes effect on the sound already playing.
165
+ applyStreamSettings(element, settings);
166
+ if (previous && previous.element === element) {
167
+ previous.settings = settings;
168
+ return previous;
169
+ }
170
+ return makeStreamHandle(file, element, settings);
171
+ }
172
+ function bufferHandleFor(file, settings, previous) {
173
+ if (previous && !previous.stream && previous.file === file) {
174
+ previous.settings = settings;
175
+ return previous;
176
+ }
177
+ return makeBufferHandle(file, settings);
178
+ }
179
+ // The <audio> handle: one element, reused. `play()` resolves when the sound ends,
180
+ // so a behavior can `await` one before doing the next thing. A looping sound
181
+ // resolves right away rather than never -- awaiting something that by definition
182
+ // doesn't end would hang the caller forever, and that is never what was meant.
183
+ function makeStreamHandle(file, element, settings) {
184
+ const handle = {
185
+ file,
186
+ stream: true,
187
+ settings,
188
+ element,
189
+ play() {
190
+ applyStreamSettings(element, handle.settings);
191
+ try {
192
+ element.currentTime = 0;
193
+ }
194
+ catch {
195
+ // Not seekable yet (still loading) -- it plays from the start anyway.
196
+ }
197
+ playMedia(element);
198
+ if (handle.settings.loop)
199
+ return Promise.resolve();
200
+ return new Promise((resolve) => {
201
+ const done = () => resolve();
202
+ element.addEventListener('ended', done, { once: true });
203
+ element.addEventListener('error', done, { once: true });
204
+ });
205
+ },
206
+ resume() {
207
+ playMedia(element);
208
+ },
209
+ pause() {
210
+ element.pause();
211
+ },
212
+ stop() {
213
+ stopMedia(element);
214
+ },
215
+ get playing() {
216
+ return !element.paused;
217
+ },
218
+ };
219
+ return handle;
220
+ }
221
+ // The decoded handle: every `play()` is its own voice, so they overlap. `stop()`
222
+ // stops the one most recently started -- the others are already on their way out,
223
+ // and `scene.sound.stopAll()` is the blunt instrument for all of them at once.
224
+ //
225
+ // `play()` resolves immediately when nothing played: an unknown file, or a sound
226
+ // still decoding. Never hanging is the point -- see playSound in engine/sound.js.
227
+ function makeBufferHandle(file, settings) {
228
+ const handle = {
229
+ file,
230
+ stream: false,
231
+ settings,
232
+ element: null,
233
+ voice: null,
234
+ play() {
235
+ const s = handle.settings;
236
+ const voice = playSound(file, { volume: s.volume, pan: s.pan, playbackRate: s.playbackRate });
237
+ handle.voice = voice;
238
+ if (!voice)
239
+ return Promise.resolve();
240
+ void voice.finished.then(() => {
241
+ if (handle.voice === voice)
242
+ handle.voice = null;
243
+ });
244
+ return voice.finished;
245
+ },
246
+ resume() {
247
+ streamOnly('resume');
248
+ },
249
+ pause() {
250
+ streamOnly('pause');
251
+ },
252
+ stop() {
253
+ handle.voice?.stop();
254
+ handle.voice = null;
255
+ },
256
+ get playing() {
257
+ return handle.voice !== null;
258
+ },
259
+ };
260
+ return handle;
261
+ }
262
+
263
+ export { SoundPlayer };