@celljs/ta 4.10.0 → 4.12.0

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 (589) hide show
  1. package/README.en.md +3 -1
  2. package/README.md +3 -1
  3. package/dist/cli.mjs +1675 -51
  4. package/dist/gateway.mjs +167 -5
  5. package/dist/pi/CHANGELOG.md +27 -0
  6. package/dist/pi/package.json +1 -1
  7. package/dist/pi/packages/ta-agents/extension/index.mjs +359 -155
  8. package/dist/pi/packages/ta-agents/lib/acp-agent.js +30 -10
  9. package/dist/pi/packages/ta-agents/lib/acp-protocol.d.ts +5 -0
  10. package/dist/pi/packages/ta-agents/lib/agent-catalog.d.ts +2 -2
  11. package/dist/pi/packages/ta-agents/lib/agent-catalog.js +4 -4
  12. package/dist/pi/packages/ta-agents/lib/agent-prompt.d.ts +9 -0
  13. package/dist/pi/packages/ta-agents/lib/agent-prompt.js +25 -0
  14. package/dist/pi/packages/ta-agents/lib/agent-session.d.ts +71 -1
  15. package/dist/pi/packages/ta-agents/lib/agent-session.js +177 -17
  16. package/dist/pi/packages/ta-agents/lib/agent-streamer.js +23 -2
  17. package/dist/pi/packages/ta-agents/lib/agent-tool.js +4 -3
  18. package/dist/pi/packages/ta-agents/lib/agent-turn.d.ts +7 -1
  19. package/dist/pi/packages/ta-agents/lib/agent-turn.js +26 -3
  20. package/dist/pi/packages/ta-agents/lib/extension.js +7 -0
  21. package/dist/pi/packages/ta-agents/lib/texts.d.ts +12 -0
  22. package/dist/pi/packages/ta-agents/lib/texts.js +12 -0
  23. package/dist/pi/packages/ta-agents/package.json +1 -1
  24. package/dist/pi/packages/ta-bots/extension/index.mjs +31 -299
  25. package/dist/pi/packages/ta-bots/host/index.mjs +143 -1
  26. package/dist/pi/packages/ta-bots/lib/bots-protocol.d.ts +2 -0
  27. package/dist/pi/packages/ta-bots/lib/bots-protocol.js +3 -1
  28. package/dist/pi/packages/ta-bots/lib/bots-view.js +24 -12
  29. package/dist/pi/packages/ta-bots/lib/composer.js +1 -0
  30. package/dist/pi/packages/ta-bots/lib/extension.js +10 -17
  31. package/dist/pi/packages/ta-bots/lib/i18n.d.ts +1 -0
  32. package/dist/pi/packages/ta-bots/lib/i18n.js +2 -0
  33. package/dist/pi/packages/ta-bots/lib/index.js +2 -0
  34. package/dist/pi/packages/ta-bots/lib/style.d.ts +1 -1
  35. package/dist/pi/packages/ta-bots/lib/style.js +1 -0
  36. package/dist/pi/packages/ta-bots/lib/text-util.js +8 -1
  37. package/dist/pi/packages/ta-bots/lib/tool-line.d.ts +8 -0
  38. package/dist/pi/packages/ta-bots/lib/tool-line.js +19 -0
  39. package/dist/pi/packages/ta-bots/package.json +1 -1
  40. package/dist/pi/packages/ta-bots/web/index.js +47 -16
  41. package/dist/pi/packages/ta-changes/extension/index.mjs +23 -13
  42. package/dist/pi/packages/ta-changes/lib/card.js +18 -4
  43. package/dist/pi/packages/ta-changes/lib/changes-protocol.d.ts +0 -4
  44. package/dist/pi/packages/ta-changes/lib/changes-protocol.js +1 -5
  45. package/dist/pi/packages/ta-changes/lib/extension.js +5 -13
  46. package/dist/pi/packages/ta-changes/package.json +1 -1
  47. package/dist/pi/packages/ta-changes/web/index.js +16 -3
  48. package/dist/pi/packages/ta-channels/README.en.md +4 -3
  49. package/dist/pi/packages/ta-channels/README.md +4 -3
  50. package/dist/pi/packages/ta-channels/extension/index.mjs +350 -28
  51. package/dist/pi/packages/ta-channels/host/index.mjs +588 -43
  52. package/dist/pi/packages/ta-channels/lib/agent-cards.d.ts +19 -0
  53. package/dist/pi/packages/ta-channels/lib/agent-cards.js +58 -0
  54. package/dist/pi/packages/ta-channels/lib/agent-menu.d.ts +2 -2
  55. package/dist/pi/packages/ta-channels/lib/agent-menu.js +20 -6
  56. package/dist/pi/packages/ta-channels/lib/card.d.ts +27 -0
  57. package/dist/pi/packages/ta-channels/lib/card.js +178 -0
  58. package/dist/pi/packages/ta-channels/lib/channels-model.d.ts +65 -13
  59. package/dist/pi/packages/ta-channels/lib/channels-model.js +15 -6
  60. package/dist/pi/packages/ta-channels/lib/channels-util.d.ts +31 -2
  61. package/dist/pi/packages/ta-channels/lib/channels-util.js +100 -6
  62. package/dist/pi/packages/ta-channels/lib/channels.d.ts +28 -18
  63. package/dist/pi/packages/ta-channels/lib/channels.js +65 -65
  64. package/dist/pi/packages/ta-channels/lib/create.js +3 -1
  65. package/dist/pi/packages/ta-channels/lib/extension.d.ts +8 -0
  66. package/dist/pi/packages/ta-channels/lib/extension.js +104 -18
  67. package/dist/pi/packages/ta-channels/lib/faces.d.ts +2 -0
  68. package/dist/pi/packages/ta-channels/lib/faces.js +6 -0
  69. package/dist/pi/packages/ta-channels/lib/handoff-view.d.ts +19 -0
  70. package/dist/pi/packages/ta-channels/lib/handoff-view.js +113 -0
  71. package/dist/pi/packages/ta-channels/lib/handoff.d.ts +67 -0
  72. package/dist/pi/packages/ta-channels/lib/handoff.js +114 -0
  73. package/dist/pi/packages/ta-channels/lib/host.d.ts +1 -1
  74. package/dist/pi/packages/ta-channels/lib/host.js +1 -1
  75. package/dist/pi/packages/ta-channels/lib/i18n.d.ts +45 -0
  76. package/dist/pi/packages/ta-channels/lib/i18n.js +90 -0
  77. package/dist/pi/packages/ta-channels/lib/index.js +10 -1
  78. package/dist/pi/packages/ta-channels/lib/member-tools.d.ts +23 -0
  79. package/dist/pi/packages/ta-channels/lib/member-tools.js +56 -0
  80. package/dist/pi/packages/ta-channels/lib/members.js +6 -2
  81. package/dist/pi/packages/ta-channels/lib/notice.d.ts +25 -0
  82. package/dist/pi/packages/ta-channels/lib/notice.js +101 -0
  83. package/dist/pi/packages/ta-channels/lib/room.js +13 -2
  84. package/dist/pi/packages/ta-channels/lib/sidebar.d.ts +1 -6
  85. package/dist/pi/packages/ta-channels/lib/sidebar.js +160 -79
  86. package/dist/pi/packages/ta-channels/lib/style.d.ts +1 -1
  87. package/dist/pi/packages/ta-channels/lib/style.js +72 -4
  88. package/dist/pi/packages/ta-channels/lib/team.d.ts +58 -10
  89. package/dist/pi/packages/ta-channels/lib/team.js +159 -38
  90. package/dist/pi/packages/ta-channels/lib/tool-lines.d.ts +22 -0
  91. package/dist/pi/packages/ta-channels/lib/tool-lines.js +113 -0
  92. package/dist/pi/packages/ta-channels/lib/views.d.ts +33 -16
  93. package/dist/pi/packages/ta-channels/lib/views.js +79 -31
  94. package/dist/pi/packages/ta-channels/package.json +2 -1
  95. package/dist/pi/packages/ta-channels/web/index.js +1551 -308
  96. package/dist/pi/packages/ta-computer-use/package.json +6 -1
  97. package/dist/pi/packages/ta-cron/README.en.md +4 -2
  98. package/dist/pi/packages/ta-cron/README.md +4 -2
  99. package/dist/pi/packages/ta-cron/extension/index.mjs +416 -44
  100. package/dist/pi/packages/ta-cron/host/index.mjs +24 -3
  101. package/dist/pi/packages/ta-cron/lib/chat-task.d.ts +48 -0
  102. package/dist/pi/packages/ta-cron/lib/chat-task.js +133 -0
  103. package/dist/pi/packages/ta-cron/lib/commands.d.ts +2 -1
  104. package/dist/pi/packages/ta-cron/lib/commands.js +10 -4
  105. package/dist/pi/packages/ta-cron/lib/composer.d.ts +11 -0
  106. package/dist/pi/packages/ta-cron/lib/composer.js +58 -0
  107. package/dist/pi/packages/ta-cron/lib/cron-protocol.d.ts +10 -3
  108. package/dist/pi/packages/ta-cron/lib/cron-protocol.js +6 -3
  109. package/dist/pi/packages/ta-cron/lib/editor.js +5 -3
  110. package/dist/pi/packages/ta-cron/lib/extension.d.ts +2 -0
  111. package/dist/pi/packages/ta-cron/lib/extension.js +33 -13
  112. package/dist/pi/packages/ta-cron/lib/i18n.d.ts +18 -0
  113. package/dist/pi/packages/ta-cron/lib/i18n.js +36 -0
  114. package/dist/pi/packages/ta-cron/lib/index.js +4 -0
  115. package/dist/pi/packages/ta-cron/lib/page.d.ts +5 -1
  116. package/dist/pi/packages/ta-cron/lib/page.js +12 -0
  117. package/dist/pi/packages/ta-cron/lib/react.d.ts +3 -0
  118. package/dist/pi/packages/ta-cron/lib/react.js +8 -0
  119. package/dist/pi/packages/ta-cron/lib/scheduler.js +3 -2
  120. package/dist/pi/packages/ta-cron/lib/style.d.ts +1 -1
  121. package/dist/pi/packages/ta-cron/lib/style.js +11 -13
  122. package/dist/pi/packages/ta-cron/lib/task-util.d.ts +2 -0
  123. package/dist/pi/packages/ta-cron/lib/task-util.js +20 -1
  124. package/dist/pi/packages/ta-cron/lib/tasks-view.js +6 -2
  125. package/dist/pi/packages/ta-cron/lib/tool-line.d.ts +9 -0
  126. package/dist/pi/packages/ta-cron/lib/tool-line.js +40 -0
  127. package/dist/pi/packages/ta-cron/lib/tool.d.ts +5 -1
  128. package/dist/pi/packages/ta-cron/lib/tool.js +6 -3
  129. package/dist/pi/packages/ta-cron/package.json +12 -1
  130. package/dist/pi/packages/ta-cron/web/index.js +661 -254
  131. package/dist/pi/packages/ta-extensions/README.en.md +1 -1
  132. package/dist/pi/packages/ta-extensions/README.md +1 -1
  133. package/dist/pi/packages/ta-extensions/host/index.mjs +3 -2
  134. package/dist/pi/packages/ta-extensions/lib/actions.d.ts +4 -0
  135. package/dist/pi/packages/ta-extensions/lib/actions.js +13 -4
  136. package/dist/pi/packages/ta-extensions/lib/extensions-util.d.ts +5 -0
  137. package/dist/pi/packages/ta-extensions/lib/extensions-util.js +10 -0
  138. package/dist/pi/packages/ta-extensions/lib/market-parts.js +8 -2
  139. package/dist/pi/packages/ta-extensions/lib/market-style.d.ts +1 -1
  140. package/dist/pi/packages/ta-extensions/lib/market-style.js +4 -5
  141. package/dist/pi/packages/ta-extensions/lib/market-util.d.ts +2 -2
  142. package/dist/pi/packages/ta-extensions/lib/market-util.js +2 -2
  143. package/dist/pi/packages/ta-extensions/lib/page.js +12 -7
  144. package/dist/pi/packages/ta-extensions/lib/react.d.ts +3 -0
  145. package/dist/pi/packages/ta-extensions/lib/react.js +8 -0
  146. package/dist/pi/packages/ta-extensions/lib/style.d.ts +1 -1
  147. package/dist/pi/packages/ta-extensions/lib/style.js +3 -2
  148. package/dist/pi/packages/ta-extensions/package.json +6 -1
  149. package/dist/pi/packages/ta-extensions/skills/ta-package/SKILL.md +20 -8
  150. package/dist/pi/packages/ta-extensions/web/index.js +191 -22
  151. package/dist/pi/packages/ta-games/README.en.md +47 -0
  152. package/dist/pi/packages/ta-games/README.md +47 -0
  153. package/dist/pi/packages/ta-games/host/index.mjs +65 -0
  154. package/dist/pi/packages/ta-games/lib/games-view.d.ts +16 -0
  155. package/dist/pi/packages/ta-games/lib/games-view.js +77 -0
  156. package/dist/pi/packages/ta-games/lib/host.d.ts +36 -0
  157. package/dist/pi/packages/ta-games/lib/host.js +83 -0
  158. package/dist/pi/packages/ta-games/lib/i18n.d.ts +35 -0
  159. package/dist/pi/packages/ta-games/lib/i18n.js +71 -0
  160. package/dist/pi/packages/ta-games/lib/ideas.d.ts +6 -0
  161. package/dist/pi/packages/ta-games/lib/ideas.js +62 -0
  162. package/dist/pi/packages/ta-games/lib/index.d.ts +7 -0
  163. package/dist/pi/packages/ta-games/lib/index.js +24 -0
  164. package/dist/pi/packages/ta-games/lib/make-game.d.ts +23 -0
  165. package/dist/pi/packages/ta-games/lib/make-game.js +67 -0
  166. package/dist/pi/packages/ta-games/lib/react.d.ts +11 -0
  167. package/dist/pi/packages/ta-games/lib/react.js +16 -0
  168. package/dist/pi/packages/ta-games/lib/style.d.ts +4 -0
  169. package/dist/pi/packages/ta-games/lib/style.js +33 -0
  170. package/dist/pi/packages/ta-games/package.json +60 -0
  171. package/dist/pi/packages/ta-games/skills/ta-game/SKILL.md +127 -0
  172. package/dist/pi/packages/ta-games/skills/ta-game/examples/dino-run/package.json +22 -0
  173. package/dist/pi/packages/ta-games/skills/ta-game/examples/dino-run/web.js +389 -0
  174. package/dist/pi/packages/ta-games/skills/ta-game/examples/stack/package.json +22 -0
  175. package/dist/pi/packages/ta-games/skills/ta-game/examples/stack/web.js +423 -0
  176. package/dist/pi/packages/ta-games/skills/ta-game/phaser/LICENSE.md +22 -0
  177. package/dist/pi/packages/ta-games/skills/ta-game/phaser/actions-and-utilities/SKILL.md +343 -0
  178. package/dist/pi/packages/ta-games/skills/ta-game/phaser/animations/SKILL.md +481 -0
  179. package/dist/pi/packages/ta-games/skills/ta-game/phaser/audio-and-sound/SKILL.md +453 -0
  180. package/dist/pi/packages/ta-games/skills/ta-game/phaser/cameras/SKILL.md +497 -0
  181. package/dist/pi/packages/ta-games/skills/ta-game/phaser/cameras/references/REFERENCE.md +128 -0
  182. package/dist/pi/packages/ta-games/skills/ta-game/phaser/curves-and-paths/SKILL.md +359 -0
  183. package/dist/pi/packages/ta-games/skills/ta-game/phaser/data-manager/SKILL.md +406 -0
  184. package/dist/pi/packages/ta-games/skills/ta-game/phaser/events-system/SKILL.md +497 -0
  185. package/dist/pi/packages/ta-games/skills/ta-game/phaser/filters-and-postfx/SKILL.md +449 -0
  186. package/dist/pi/packages/ta-games/skills/ta-game/phaser/game-object-components/SKILL.md +478 -0
  187. package/dist/pi/packages/ta-games/skills/ta-game/phaser/game-object-components/references/REFERENCE.md +76 -0
  188. package/dist/pi/packages/ta-games/skills/ta-game/phaser/game-setup-and-config/SKILL.md +485 -0
  189. package/dist/pi/packages/ta-games/skills/ta-game/phaser/geometry-and-math/SKILL.md +497 -0
  190. package/dist/pi/packages/ta-games/skills/ta-game/phaser/graphics-and-shapes/SKILL.md +473 -0
  191. package/dist/pi/packages/ta-games/skills/ta-game/phaser/groups-and-containers/SKILL.md +418 -0
  192. package/dist/pi/packages/ta-games/skills/ta-game/phaser/input-keyboard-mouse-touch/SKILL.md +500 -0
  193. package/dist/pi/packages/ta-games/skills/ta-game/phaser/input-keyboard-mouse-touch/references/REFERENCE.md +372 -0
  194. package/dist/pi/packages/ta-games/skills/ta-game/phaser/loading-assets/SKILL.md +474 -0
  195. package/dist/pi/packages/ta-games/skills/ta-game/phaser/loading-assets/references/REFERENCE.md +148 -0
  196. package/dist/pi/packages/ta-games/skills/ta-game/phaser/particles/SKILL.md +499 -0
  197. package/dist/pi/packages/ta-games/skills/ta-game/phaser/particles/references/REFERENCE.md +17 -0
  198. package/dist/pi/packages/ta-games/skills/ta-game/phaser/physics-arcade/SKILL.md +468 -0
  199. package/dist/pi/packages/ta-games/skills/ta-game/phaser/physics-matter/SKILL.md +499 -0
  200. package/dist/pi/packages/ta-games/skills/ta-game/phaser/render-textures/SKILL.md +441 -0
  201. package/dist/pi/packages/ta-games/skills/ta-game/phaser/scale-and-responsive/SKILL.md +371 -0
  202. package/dist/pi/packages/ta-games/skills/ta-game/phaser/scenes/SKILL.md +450 -0
  203. package/dist/pi/packages/ta-games/skills/ta-game/phaser/scenes/references/REFERENCE.md +78 -0
  204. package/dist/pi/packages/ta-games/skills/ta-game/phaser/sprites-and-images/SKILL.md +417 -0
  205. package/dist/pi/packages/ta-games/skills/ta-game/phaser/sprites-and-images/references/REFERENCE.md +160 -0
  206. package/dist/pi/packages/ta-games/skills/ta-game/phaser/text-and-bitmaptext/SKILL.md +460 -0
  207. package/dist/pi/packages/ta-games/skills/ta-game/phaser/tilemaps/SKILL.md +440 -0
  208. package/dist/pi/packages/ta-games/skills/ta-game/phaser/time-and-timers/SKILL.md +496 -0
  209. package/dist/pi/packages/ta-games/skills/ta-game/phaser/tweens/SKILL.md +414 -0
  210. package/dist/pi/packages/ta-games/skills/ta-game/phaser/v3-to-v4-migration/SKILL.md +430 -0
  211. package/dist/pi/packages/ta-games/skills/ta-game/phaser/v4-new-features/SKILL.md +384 -0
  212. package/dist/pi/packages/ta-games/skills/ta-game/phaser/v4-new-features/references/REFERENCE.md +69 -0
  213. package/dist/pi/packages/ta-games/web/index.js +431 -0
  214. package/dist/pi/packages/ta-glance/README.en.md +11 -0
  215. package/dist/pi/packages/ta-glance/README.md +11 -0
  216. package/dist/pi/packages/ta-glance/extension/index.mjs +67 -0
  217. package/dist/pi/packages/ta-glance/lib/card.d.ts +8 -0
  218. package/dist/pi/packages/ta-glance/lib/card.js +269 -0
  219. package/dist/pi/packages/ta-glance/lib/extension.d.ts +15 -0
  220. package/dist/pi/packages/ta-glance/lib/extension.js +24 -0
  221. package/dist/pi/packages/ta-glance/lib/glance-json.d.ts +9 -0
  222. package/dist/pi/packages/ta-glance/lib/glance-json.js +85 -0
  223. package/dist/pi/packages/ta-glance/lib/glance-prompt.d.ts +7 -0
  224. package/dist/pi/packages/ta-glance/lib/glance-prompt.js +34 -0
  225. package/dist/pi/packages/ta-glance/lib/glance-protocol.d.ts +98 -0
  226. package/dist/pi/packages/ta-glance/lib/glance-protocol.js +8 -0
  227. package/dist/pi/packages/ta-glance/lib/glance-spec.d.ts +7 -0
  228. package/dist/pi/packages/ta-glance/lib/glance-spec.js +206 -0
  229. package/dist/pi/packages/ta-glance/lib/glance-util.d.ts +3 -0
  230. package/dist/pi/packages/ta-glance/lib/glance-util.js +12 -0
  231. package/dist/pi/packages/ta-glance/lib/i18n.d.ts +22 -0
  232. package/dist/pi/packages/ta-glance/lib/i18n.js +41 -0
  233. package/dist/pi/packages/ta-glance/lib/index.d.ts +7 -0
  234. package/dist/pi/packages/ta-glance/lib/index.js +22 -0
  235. package/dist/pi/packages/ta-glance/lib/react.d.ts +8 -0
  236. package/dist/pi/packages/ta-glance/lib/react.js +8 -0
  237. package/dist/pi/packages/ta-glance/lib/style.d.ts +4 -0
  238. package/dist/pi/packages/ta-glance/lib/style.js +241 -0
  239. package/dist/pi/packages/ta-glance/package.json +53 -0
  240. package/dist/pi/packages/ta-glance/web/index.js +1013 -0
  241. package/dist/pi/packages/ta-launcher/lib/actions.d.ts +4 -4
  242. package/dist/pi/packages/ta-launcher/lib/actions.js +7 -3
  243. package/dist/pi/packages/ta-launcher/lib/launcher-util.d.ts +7 -7
  244. package/dist/pi/packages/ta-launcher/lib/launcher-util.js +11 -8
  245. package/dist/pi/packages/ta-launcher/lib/launcher-view.js +13 -7
  246. package/dist/pi/packages/ta-launcher/lib/react.d.ts +3 -0
  247. package/dist/pi/packages/ta-launcher/lib/react.js +8 -0
  248. package/dist/pi/packages/ta-launcher/lib/style.d.ts +1 -1
  249. package/dist/pi/packages/ta-launcher/lib/style.js +6 -4
  250. package/dist/pi/packages/ta-launcher/package.json +1 -1
  251. package/dist/pi/packages/ta-launcher/web/index.js +34 -17
  252. package/dist/pi/packages/ta-manual/README.en.md +10 -0
  253. package/dist/pi/packages/ta-manual/README.md +10 -0
  254. package/dist/pi/packages/ta-manual/lib/i18n.d.ts +15 -0
  255. package/dist/pi/packages/ta-manual/lib/i18n.js +31 -0
  256. package/dist/pi/packages/ta-manual/lib/index.d.ts +7 -0
  257. package/dist/pi/packages/ta-manual/lib/index.js +24 -0
  258. package/dist/pi/packages/ta-manual/lib/manual-util.d.ts +18 -0
  259. package/dist/pi/packages/ta-manual/lib/manual-util.js +40 -0
  260. package/dist/pi/packages/ta-manual/lib/manual-view.d.ts +9 -0
  261. package/dist/pi/packages/ta-manual/lib/manual-view.js +81 -0
  262. package/dist/pi/packages/ta-manual/lib/pictures-a.d.ts +2 -0
  263. package/dist/pi/packages/ta-manual/lib/pictures-a.js +263 -0
  264. package/dist/pi/packages/ta-manual/lib/pictures-b.d.ts +2 -0
  265. package/dist/pi/packages/ta-manual/lib/pictures-b.js +216 -0
  266. package/dist/pi/packages/ta-manual/lib/pictures-c.d.ts +2 -0
  267. package/dist/pi/packages/ta-manual/lib/pictures-c.js +53 -0
  268. package/dist/pi/packages/ta-manual/lib/pictures.d.ts +9 -0
  269. package/dist/pi/packages/ta-manual/lib/pictures.js +17 -0
  270. package/dist/pi/packages/ta-manual/lib/react.d.ts +8 -0
  271. package/dist/pi/packages/ta-manual/lib/react.js +8 -0
  272. package/dist/pi/packages/ta-manual/lib/scene.d.ts +68 -0
  273. package/dist/pi/packages/ta-manual/lib/scene.js +115 -0
  274. package/dist/pi/packages/ta-manual/lib/style.d.ts +4 -0
  275. package/dist/pi/packages/ta-manual/lib/style.js +47 -0
  276. package/dist/pi/packages/ta-manual/lib/topics.d.ts +43 -0
  277. package/dist/pi/packages/ta-manual/lib/topics.js +388 -0
  278. package/dist/pi/packages/ta-manual/package.json +54 -0
  279. package/dist/pi/packages/ta-manual/skills/ta-manual/SKILL.md +130 -0
  280. package/dist/pi/packages/ta-manual/web/index.js +2408 -0
  281. package/dist/pi/packages/ta-notify/README.en.md +29 -0
  282. package/dist/pi/packages/ta-notify/README.md +29 -0
  283. package/dist/pi/packages/ta-notify/extension/index.mjs +259 -0
  284. package/dist/pi/packages/ta-notify/host/index.mjs +163 -0
  285. package/dist/pi/packages/ta-notify/lib/ask-card.d.ts +9 -0
  286. package/dist/pi/packages/ta-notify/lib/ask-card.js +40 -0
  287. package/dist/pi/packages/ta-notify/lib/extension.d.ts +24 -0
  288. package/dist/pi/packages/ta-notify/lib/extension.js +102 -0
  289. package/dist/pi/packages/ta-notify/lib/host.d.ts +4 -0
  290. package/dist/pi/packages/ta-notify/lib/host.js +9 -0
  291. package/dist/pi/packages/ta-notify/lib/i18n.d.ts +31 -0
  292. package/dist/pi/packages/ta-notify/lib/i18n.js +63 -0
  293. package/dist/pi/packages/ta-notify/lib/index.d.ts +8 -0
  294. package/dist/pi/packages/ta-notify/lib/index.js +29 -0
  295. package/dist/pi/packages/ta-notify/lib/notify-protocol.d.ts +74 -0
  296. package/dist/pi/packages/ta-notify/lib/notify-protocol.js +23 -0
  297. package/dist/pi/packages/ta-notify/lib/notify-service.d.ts +21 -0
  298. package/dist/pi/packages/ta-notify/lib/notify-service.js +75 -0
  299. package/dist/pi/packages/ta-notify/lib/notify-util.d.ts +39 -0
  300. package/dist/pi/packages/ta-notify/lib/notify-util.js +119 -0
  301. package/dist/pi/packages/ta-notify/lib/react.d.ts +8 -0
  302. package/dist/pi/packages/ta-notify/lib/react.js +8 -0
  303. package/dist/pi/packages/ta-notify/lib/server-texts.d.ts +9 -0
  304. package/dist/pi/packages/ta-notify/lib/server-texts.js +22 -0
  305. package/dist/pi/packages/ta-notify/lib/settings.d.ts +8 -0
  306. package/dist/pi/packages/ta-notify/lib/settings.js +85 -0
  307. package/dist/pi/packages/ta-notify/lib/style.d.ts +4 -0
  308. package/dist/pi/packages/ta-notify/lib/style.js +29 -0
  309. package/dist/pi/packages/ta-notify/lib/tool-line.d.ts +9 -0
  310. package/dist/pi/packages/ta-notify/lib/tool-line.js +20 -0
  311. package/dist/pi/packages/ta-notify/lib/tool.d.ts +37 -0
  312. package/dist/pi/packages/ta-notify/lib/tool.js +46 -0
  313. package/dist/pi/packages/ta-notify/lib/watcher.d.ts +15 -0
  314. package/dist/pi/packages/ta-notify/lib/watcher.js +81 -0
  315. package/dist/pi/packages/ta-notify/package.json +55 -0
  316. package/dist/pi/packages/ta-notify/web/index.js +436 -0
  317. package/dist/pi/packages/ta-recall/README.en.md +19 -0
  318. package/dist/pi/packages/ta-recall/README.md +19 -0
  319. package/dist/pi/packages/ta-recall/extension/index.mjs +615 -0
  320. package/dist/pi/packages/ta-recall/host/index.mjs +820 -0
  321. package/dist/pi/packages/ta-recall/lib/brief-card.d.ts +21 -0
  322. package/dist/pi/packages/ta-recall/lib/brief-card.js +67 -0
  323. package/dist/pi/packages/ta-recall/lib/brief-home.d.ts +49 -0
  324. package/dist/pi/packages/ta-recall/lib/brief-home.js +143 -0
  325. package/dist/pi/packages/ta-recall/lib/brief-seen.d.ts +9 -0
  326. package/dist/pi/packages/ta-recall/lib/brief-seen.js +26 -0
  327. package/dist/pi/packages/ta-recall/lib/brief-util.d.ts +64 -0
  328. package/dist/pi/packages/ta-recall/lib/brief-util.js +179 -0
  329. package/dist/pi/packages/ta-recall/lib/chat-icons.d.ts +8 -0
  330. package/dist/pi/packages/ta-recall/lib/chat-icons.js +56 -0
  331. package/dist/pi/packages/ta-recall/lib/composer.d.ts +7 -0
  332. package/dist/pi/packages/ta-recall/lib/composer.js +38 -0
  333. package/dist/pi/packages/ta-recall/lib/conversation-index.d.ts +25 -0
  334. package/dist/pi/packages/ta-recall/lib/conversation-index.js +72 -0
  335. package/dist/pi/packages/ta-recall/lib/conversation-util.d.ts +16 -0
  336. package/dist/pi/packages/ta-recall/lib/conversation-util.js +109 -0
  337. package/dist/pi/packages/ta-recall/lib/conversations.d.ts +11 -0
  338. package/dist/pi/packages/ta-recall/lib/conversations.js +52 -0
  339. package/dist/pi/packages/ta-recall/lib/extension.d.ts +24 -0
  340. package/dist/pi/packages/ta-recall/lib/extension.js +132 -0
  341. package/dist/pi/packages/ta-recall/lib/host.d.ts +4 -0
  342. package/dist/pi/packages/ta-recall/lib/host.js +11 -0
  343. package/dist/pi/packages/ta-recall/lib/i18n.d.ts +41 -0
  344. package/dist/pi/packages/ta-recall/lib/i18n.js +83 -0
  345. package/dist/pi/packages/ta-recall/lib/index.d.ts +9 -0
  346. package/dist/pi/packages/ta-recall/lib/index.js +45 -0
  347. package/dist/pi/packages/ta-recall/lib/react.d.ts +11 -0
  348. package/dist/pi/packages/ta-recall/lib/react.js +16 -0
  349. package/dist/pi/packages/ta-recall/lib/recall-protocol.d.ts +186 -0
  350. package/dist/pi/packages/ta-recall/lib/recall-protocol.js +60 -0
  351. package/dist/pi/packages/ta-recall/lib/recall-service.d.ts +42 -0
  352. package/dist/pi/packages/ta-recall/lib/recall-service.js +241 -0
  353. package/dist/pi/packages/ta-recall/lib/search-source.d.ts +7 -0
  354. package/dist/pi/packages/ta-recall/lib/search-source.js +49 -0
  355. package/dist/pi/packages/ta-recall/lib/search-util.d.ts +30 -0
  356. package/dist/pi/packages/ta-recall/lib/search-util.js +167 -0
  357. package/dist/pi/packages/ta-recall/lib/server-texts.d.ts +7 -0
  358. package/dist/pi/packages/ta-recall/lib/server-texts.js +17 -0
  359. package/dist/pi/packages/ta-recall/lib/settings.d.ts +4 -0
  360. package/dist/pi/packages/ta-recall/lib/settings.js +77 -0
  361. package/dist/pi/packages/ta-recall/lib/skill-card.d.ts +9 -0
  362. package/dist/pi/packages/ta-recall/lib/skill-card.js +51 -0
  363. package/dist/pi/packages/ta-recall/lib/skill-util.d.ts +19 -0
  364. package/dist/pi/packages/ta-recall/lib/skill-util.js +110 -0
  365. package/dist/pi/packages/ta-recall/lib/stored.d.ts +5 -0
  366. package/dist/pi/packages/ta-recall/lib/stored.js +28 -0
  367. package/dist/pi/packages/ta-recall/lib/style.d.ts +4 -0
  368. package/dist/pi/packages/ta-recall/lib/style.js +48 -0
  369. package/dist/pi/packages/ta-recall/lib/tool-line.d.ts +10 -0
  370. package/dist/pi/packages/ta-recall/lib/tool-line.js +23 -0
  371. package/dist/pi/packages/ta-recall/lib/tool.d.ts +63 -0
  372. package/dist/pi/packages/ta-recall/lib/tool.js +71 -0
  373. package/dist/pi/packages/ta-recall/package.json +55 -0
  374. package/dist/pi/packages/ta-recall/web/index.js +1042 -0
  375. package/dist/pi/packages/ta-rooms/README.en.md +29 -0
  376. package/dist/pi/packages/ta-rooms/README.md +29 -0
  377. package/dist/pi/packages/ta-rooms/extension/index.mjs +362 -0
  378. package/dist/pi/packages/ta-rooms/host/index.mjs +966 -0
  379. package/dist/pi/packages/ta-rooms/lib/agents-view.d.ts +25 -0
  380. package/dist/pi/packages/ta-rooms/lib/agents-view.js +128 -0
  381. package/dist/pi/packages/ta-rooms/lib/dialogs.d.ts +39 -0
  382. package/dist/pi/packages/ta-rooms/lib/dialogs.js +235 -0
  383. package/dist/pi/packages/ta-rooms/lib/double-host.d.ts +114 -0
  384. package/dist/pi/packages/ta-rooms/lib/double-host.js +645 -0
  385. package/dist/pi/packages/ta-rooms/lib/double-i18n.d.ts +85 -0
  386. package/dist/pi/packages/ta-rooms/lib/double-i18n.js +172 -0
  387. package/dist/pi/packages/ta-rooms/lib/double-protocol.d.ts +165 -0
  388. package/dist/pi/packages/ta-rooms/lib/double-protocol.js +73 -0
  389. package/dist/pi/packages/ta-rooms/lib/double-util.d.ts +99 -0
  390. package/dist/pi/packages/ta-rooms/lib/double-util.js +180 -0
  391. package/dist/pi/packages/ta-rooms/lib/doubles-store.d.ts +45 -0
  392. package/dist/pi/packages/ta-rooms/lib/doubles-store.js +145 -0
  393. package/dist/pi/packages/ta-rooms/lib/doubles-view.d.ts +34 -0
  394. package/dist/pi/packages/ta-rooms/lib/doubles-view.js +223 -0
  395. package/dist/pi/packages/ta-rooms/lib/extension.d.ts +24 -0
  396. package/dist/pi/packages/ta-rooms/lib/extension.js +176 -0
  397. package/dist/pi/packages/ta-rooms/lib/host.d.ts +7 -0
  398. package/dist/pi/packages/ta-rooms/lib/host.js +18 -0
  399. package/dist/pi/packages/ta-rooms/lib/i18n.d.ts +105 -0
  400. package/dist/pi/packages/ta-rooms/lib/i18n.js +211 -0
  401. package/dist/pi/packages/ta-rooms/lib/index.d.ts +9 -0
  402. package/dist/pi/packages/ta-rooms/lib/index.js +106 -0
  403. package/dist/pi/packages/ta-rooms/lib/members-view.d.ts +3 -0
  404. package/dist/pi/packages/ta-rooms/lib/members-view.js +94 -0
  405. package/dist/pi/packages/ta-rooms/lib/page.d.ts +154 -0
  406. package/dist/pi/packages/ta-rooms/lib/page.js +400 -0
  407. package/dist/pi/packages/ta-rooms/lib/react.d.ts +8 -0
  408. package/dist/pi/packages/ta-rooms/lib/react.js +8 -0
  409. package/dist/pi/packages/ta-rooms/lib/room-view.d.ts +15 -0
  410. package/dist/pi/packages/ta-rooms/lib/room-view.js +168 -0
  411. package/dist/pi/packages/ta-rooms/lib/rooms-home.d.ts +32 -0
  412. package/dist/pi/packages/ta-rooms/lib/rooms-home.js +141 -0
  413. package/dist/pi/packages/ta-rooms/lib/rooms-page.d.ts +14 -0
  414. package/dist/pi/packages/ta-rooms/lib/rooms-page.js +217 -0
  415. package/dist/pi/packages/ta-rooms/lib/style.d.ts +4 -0
  416. package/dist/pi/packages/ta-rooms/lib/style.js +205 -0
  417. package/dist/pi/packages/ta-rooms/package.json +56 -0
  418. package/dist/pi/packages/ta-rooms/web/index.js +3165 -0
  419. package/dist/pi/packages/ta-share/README.en.md +27 -0
  420. package/dist/pi/packages/ta-share/README.md +27 -0
  421. package/dist/pi/packages/ta-share/extension/index.mjs +184 -0
  422. package/dist/pi/packages/ta-share/host/index.mjs +364 -0
  423. package/dist/pi/packages/ta-share/lib/extension.d.ts +15 -0
  424. package/dist/pi/packages/ta-share/lib/extension.js +115 -0
  425. package/dist/pi/packages/ta-share/lib/host.d.ts +4 -0
  426. package/dist/pi/packages/ta-share/lib/host.js +9 -0
  427. package/dist/pi/packages/ta-share/lib/i18n.d.ts +106 -0
  428. package/dist/pi/packages/ta-share/lib/i18n.js +213 -0
  429. package/dist/pi/packages/ta-share/lib/index.d.ts +9 -0
  430. package/dist/pi/packages/ta-share/lib/index.js +77 -0
  431. package/dist/pi/packages/ta-share/lib/page.d.ts +48 -0
  432. package/dist/pi/packages/ta-share/lib/page.js +105 -0
  433. package/dist/pi/packages/ta-share/lib/react.d.ts +8 -0
  434. package/dist/pi/packages/ta-share/lib/react.js +8 -0
  435. package/dist/pi/packages/ta-share/lib/server-texts.d.ts +14 -0
  436. package/dist/pi/packages/ta-share/lib/server-texts.js +52 -0
  437. package/dist/pi/packages/ta-share/lib/share-dialog.d.ts +18 -0
  438. package/dist/pi/packages/ta-share/lib/share-dialog.js +233 -0
  439. package/dist/pi/packages/ta-share/lib/share-protocol.d.ts +86 -0
  440. package/dist/pi/packages/ta-share/lib/share-protocol.js +30 -0
  441. package/dist/pi/packages/ta-share/lib/share-service.d.ts +50 -0
  442. package/dist/pi/packages/ta-share/lib/share-service.js +130 -0
  443. package/dist/pi/packages/ta-share/lib/shared-view.d.ts +18 -0
  444. package/dist/pi/packages/ta-share/lib/shared-view.js +225 -0
  445. package/dist/pi/packages/ta-share/lib/shares-page.d.ts +3 -0
  446. package/dist/pi/packages/ta-share/lib/shares-page.js +78 -0
  447. package/dist/pi/packages/ta-share/lib/snapshot.d.ts +30 -0
  448. package/dist/pi/packages/ta-share/lib/snapshot.js +195 -0
  449. package/dist/pi/packages/ta-share/lib/style.d.ts +4 -0
  450. package/dist/pi/packages/ta-share/lib/style.js +117 -0
  451. package/dist/pi/packages/ta-share/package.json +56 -0
  452. package/dist/pi/packages/ta-share/web/index.js +1224 -0
  453. package/dist/pi/packages/ta-workspace/README.md +1 -1
  454. package/dist/pi/packages/ta-workspace/README.zh-cn.md +1 -1
  455. package/dist/pi/packages/ta-workspace/lib/browser-common.d.ts +1 -1
  456. package/dist/pi/packages/ta-workspace/lib/browser-common.js +29 -30
  457. package/dist/pi/packages/ta-workspace/lib/browser-tool-line.d.ts +15 -0
  458. package/dist/pi/packages/ta-workspace/lib/browser-tool-line.js +70 -0
  459. package/dist/pi/packages/ta-workspace/lib/editors.js +29 -2
  460. package/dist/pi/packages/ta-workspace/lib/i18n.d.ts +13 -2
  461. package/dist/pi/packages/ta-workspace/lib/i18n.js +29 -7
  462. package/dist/pi/packages/ta-workspace/lib/index.js +2 -0
  463. package/dist/pi/packages/ta-workspace/lib/preview.d.ts +10 -1
  464. package/dist/pi/packages/ta-workspace/lib/preview.js +136 -11
  465. package/dist/pi/packages/ta-workspace/lib/style.d.ts +1 -1
  466. package/dist/pi/packages/ta-workspace/lib/style.js +56 -40
  467. package/dist/pi/packages/ta-workspace/lib/terminal-sessions.d.ts +15 -4
  468. package/dist/pi/packages/ta-workspace/lib/terminal-sessions.js +31 -9
  469. package/dist/pi/packages/ta-workspace/lib/terminal.d.ts +3 -2
  470. package/dist/pi/packages/ta-workspace/lib/terminal.js +51 -21
  471. package/dist/pi/packages/ta-workspace/lib/util/preview.d.ts +27 -0
  472. package/dist/pi/packages/ta-workspace/lib/util/preview.js +74 -0
  473. package/dist/pi/packages/ta-workspace/lib/util/terminal.d.ts +5 -0
  474. package/dist/pi/packages/ta-workspace/lib/util/terminal.js +14 -0
  475. package/dist/pi/packages/ta-workspace/package.json +1 -1
  476. package/dist/pi/packages/ta-workspace/web/index.js +823 -341
  477. package/dist/public/assets/OrbitControls-DVf70a7w.js +1 -0
  478. package/dist/public/assets/{abnfDiagram-S7VZAUFO-BmIko5tV.js → abnfDiagram-S7VZAUFO-BnqtcbpZ.js} +1 -1
  479. package/dist/public/assets/{architecture-WOLXFQ4H-XgsdQ7ul.js → architecture-WOLXFQ4H-BzPq1Ioe.js} +1 -1
  480. package/dist/public/assets/{architectureDiagram-YGSQEFNW--sVhMS03.js → architectureDiagram-YGSQEFNW-BsquO3a7.js} +1 -1
  481. package/dist/public/assets/{blockDiagram-APKKGZFW-8f9b-9k2.js → blockDiagram-APKKGZFW-BQNYOEP4.js} +1 -1
  482. package/dist/public/assets/{browser-DOHZ0JCf.js → browser-DS711n7Y.js} +1 -1
  483. package/dist/public/assets/{c4Diagram-KJ2TOQU5-CwYQ0Jfy.js → c4Diagram-KJ2TOQU5-D6e79Ycq.js} +1 -1
  484. package/dist/public/assets/{chunk-6MUBBAK2-7Y9ezehi.js → chunk-6MUBBAK2-B-sgaPoU.js} +1 -1
  485. package/dist/public/assets/{chunk-AXFCVDMN-CZIH4pWz.js → chunk-AXFCVDMN-D8pJKIg2.js} +1 -1
  486. package/dist/public/assets/{chunk-BG4553SI-DsNATY2m.js → chunk-BG4553SI-86TL-vCz.js} +1 -1
  487. package/dist/public/assets/{chunk-DQASFODM-CoXkfYE-.js → chunk-DQASFODM-CfUVuGjc.js} +1 -1
  488. package/dist/public/assets/{chunk-HFQBQIA3-C5OLqki8.js → chunk-HFQBQIA3-Drm0FEYk.js} +1 -1
  489. package/dist/public/assets/{chunk-KQLB2F66-DMHuYGEF.js → chunk-KQLB2F66-BVFRADlC.js} +1 -1
  490. package/dist/public/assets/{chunk-KS47KZWR-BKeOttO1.js → chunk-KS47KZWR-DfyALEmP.js} +1 -1
  491. package/dist/public/assets/{chunk-LEVMRMFU-D6zCwkk7.js → chunk-LEVMRMFU-DtJVzk2c.js} +1 -1
  492. package/dist/public/assets/{chunk-M57EVK23-B5-QqcZg.js → chunk-M57EVK23-DTy27PHQ.js} +1 -1
  493. package/dist/public/assets/{chunk-OY52VR5R-DQrq3n0T.js → chunk-OY52VR5R-nSgn7jZg.js} +1 -1
  494. package/dist/public/assets/{chunk-QB3YPZ4I-j6ZT7EDR.js → chunk-QB3YPZ4I-CkSxO_X6.js} +1 -1
  495. package/dist/public/assets/{chunk-R3KSYZAL-D5MXUO36.js → chunk-R3KSYZAL-Ck6iAjAL.js} +1 -1
  496. package/dist/public/assets/{chunk-STOXU5M4-DaBkw4dD.js → chunk-STOXU5M4-DQPHdSTh.js} +1 -1
  497. package/dist/public/assets/{chunk-TU62E6Q5-vXcRfGci.js → chunk-TU62E6Q5-Bc2AbV2Y.js} +1 -1
  498. package/dist/public/assets/{chunk-X4PVCEUW-CIh6H4Y2.js → chunk-X4PVCEUW-Cgpm0IXm.js} +1 -1
  499. package/dist/public/assets/{chunk-XXDRQBXY-C_Vwv1FM.js → chunk-XXDRQBXY-CGE4eLpg.js} +1 -1
  500. package/dist/public/assets/{classDiagram-v2-L25IHNXF-DccDWEJn.js → classDiagram-v2-L25IHNXF-4eQuDPEo.js} +1 -1
  501. package/dist/public/assets/{cose-bilkent-JH36ORCC-BX47lumZ.js → cose-bilkent-JH36ORCC-tDLCWq07.js} +1 -1
  502. package/dist/public/assets/cynefin-EF2NZ3EQ-Dd40W2Jh.js +1 -0
  503. package/dist/public/assets/{cynefinDiagram-L36ESFBY-BE6WOGxW.js → cynefinDiagram-L36ESFBY-ByqcZ8x9.js} +1 -1
  504. package/dist/public/assets/{d3-selection-ZcE6yRN5.js → d3-selection-Bgn1374-.js} +1 -1
  505. package/dist/public/assets/{dagre-SPEB5RXH-CE6SOOcN.js → dagre-SPEB5RXH-mCgr71mV.js} +1 -1
  506. package/dist/public/assets/{diagram-3B7GL73J-xC8VtiYL.js → diagram-3B7GL73J-DpYSwpQ0.js} +1 -1
  507. package/dist/public/assets/{diagram-DNEMPZML-4dmcBbjL.js → diagram-DNEMPZML-DMozUQzi.js} +1 -1
  508. package/dist/public/assets/{diagram-L3MUGCDN-D14Yn3sQ.js → diagram-L3MUGCDN-Bk5Uf8PD.js} +1 -1
  509. package/dist/public/assets/{diagram-LA4NIPWU-GxSXIhsK.js → diagram-LA4NIPWU-DFt5cPVK.js} +1 -1
  510. package/dist/public/assets/{diagram-MHCOC4E2-Cm7Prlpc.js → diagram-MHCOC4E2-BkZZcKqK.js} +1 -1
  511. package/dist/public/assets/{diagram-XPFHEONP-mkUnnKFu.js → diagram-XPFHEONP-HEY6kyyN.js} +1 -1
  512. package/dist/public/assets/{dist-acJS-BlA.js → dist-Bj2CrKn7.js} +1 -1
  513. package/dist/public/assets/{ebnfDiagram-UZSYDL2S-m77ua3UQ.js → ebnfDiagram-UZSYDL2S-D4JvYyVb.js} +1 -1
  514. package/dist/public/assets/{editor.api-CljTm-EQ.js → editor.api-BpJFzYbl.js} +1 -1
  515. package/dist/public/assets/{elk-XV6XMXQE-DsQY1hw9.js → elk-XV6XMXQE-CT6qLJkF.js} +1 -1
  516. package/dist/public/assets/{erDiagram-EYBAPDEH-CV8gJM0P.js → erDiagram-EYBAPDEH-BGng1goR.js} +1 -1
  517. package/dist/public/assets/{eventmodeling-K75KTNOO-C1pymbUr.js → eventmodeling-K75KTNOO-Tt8O-Q1Z.js} +1 -1
  518. package/dist/public/assets/flowDiagram-MALGAFMO-uFzenfA3.js +1 -0
  519. package/dist/public/assets/{freemarker2-DYJXaMHN.js → freemarker2-Dd5ksoRn.js} +1 -1
  520. package/dist/public/assets/{ganttDiagram-23REXITY-CppxOWRh.js → ganttDiagram-23REXITY-Jl8VO_g2.js} +1 -1
  521. package/dist/public/assets/gitGraph-VSP46ZUC-D28I_jUc.js +1 -0
  522. package/dist/public/assets/{gitGraphDiagram-STJD7YCW-CrQrZhcP.js → gitGraphDiagram-STJD7YCW-Be4qXALb.js} +1 -1
  523. package/dist/public/assets/{handlebars-DZCnH9e2.js → handlebars-4xabgUi4.js} +1 -1
  524. package/dist/public/assets/{html-DuzouNES.js → html-Dk3kt2w_.js} +1 -1
  525. package/dist/public/assets/{index-B7OYKvCE.js → index-Bx0c7eoh.js} +2 -2
  526. package/dist/public/assets/info-OHQRW6UA-5vIGEIq7.js +1 -0
  527. package/dist/public/assets/{infoDiagram-KBXO4MBG-6pby19tQ.js → infoDiagram-KBXO4MBG-Coc0tdwb.js} +1 -1
  528. package/dist/public/assets/{ishikawaDiagram-M35NCXHK-Duf8c8rQ.js → ishikawaDiagram-M35NCXHK-CE_1VQCg.js} +1 -1
  529. package/dist/public/assets/{javascript-2d_L6cVd.js → javascript-DKLGqy6v.js} +1 -1
  530. package/dist/public/assets/{journeyDiagram-OPLOXDXO-Dvv-xzNo.js → journeyDiagram-OPLOXDXO-CrolRZ_7.js} +1 -1
  531. package/dist/public/assets/{jsonMode-CFadYXyI.js → jsonMode-Chcs19_y.js} +1 -1
  532. package/dist/public/assets/{kanban-definition-BZKZHSQY-Dsk6F-TT.js → kanban-definition-BZKZHSQY-CjJj47De.js} +1 -1
  533. package/dist/public/assets/{liquid-Din4CF34.js → liquid-jff3p-Ji.js} +1 -1
  534. package/dist/public/assets/{mdx-DivDuCWI.js → mdx-DW4uRDfJ.js} +1 -1
  535. package/dist/public/assets/{mermaid-parser.core-BfCv4CYZ.js → mermaid-parser.core-XhQj6FvH.js} +3 -3
  536. package/dist/public/assets/{mermaid.core-DC20ZwJj.js → mermaid.core-OD4Atimg.js} +4 -4
  537. package/dist/public/assets/{mindmap-definition-I2QAS2VK-DRZRrJU_.js → mindmap-definition-I2QAS2VK-DpGelVY7.js} +1 -1
  538. package/dist/public/assets/module-CrD0OHQp.js +1 -0
  539. package/dist/public/assets/module-DEBMgdtf.js +2273 -0
  540. package/dist/public/assets/{monaco-D1d6MOPe.js → monaco-BTVZP-tU.js} +3 -3
  541. package/dist/public/assets/packet-JDAUHWVQ-CBxQ5Mzy.js +1 -0
  542. package/dist/public/assets/{pegDiagram-FD4XPPHP-DcGr3Tbk.js → pegDiagram-FD4XPPHP-CqcBmPfB.js} +1 -1
  543. package/dist/public/assets/phaser.esm-BxCDEWDb.js +3202 -0
  544. package/dist/public/assets/pie-XZMESJXO-DT5V3581.js +1 -0
  545. package/dist/public/assets/{pieDiagram-J4AKIIQI-GF7pu6ch.js → pieDiagram-J4AKIIQI-CRir3beB.js} +1 -1
  546. package/dist/public/assets/{python-BQbTTTT5.js → python-BwW_0207.js} +1 -1
  547. package/dist/public/assets/{quadrantDiagram-XTYBLID2-D-bcu7Ey.js → quadrantDiagram-XTYBLID2-DIY6gdcf.js} +1 -1
  548. package/dist/public/assets/radar-ABXABTNO-BAOovYEa.js +1 -0
  549. package/dist/public/assets/railroad-I3PHUGI6-RZ2Rnwzh.js +1 -0
  550. package/dist/public/assets/{railroad-abnf-LNEFI6M7-BiBHsI-K.js → railroad-abnf-LNEFI6M7-XWNOzunl.js} +1 -1
  551. package/dist/public/assets/{railroad-ebnf-DWYD2UWJ-zKjrfkHs.js → railroad-ebnf-DWYD2UWJ-CI0-j1Jz.js} +1 -1
  552. package/dist/public/assets/{railroad-peg-JR7BVNR7-DKuVn0GT.js → railroad-peg-JR7BVNR7-BVB_IaIG.js} +1 -1
  553. package/dist/public/assets/{railroadDiagram-MRQ6NCDL-Cyn-16mJ.js → railroadDiagram-MRQ6NCDL-CudwT6q2.js} +1 -1
  554. package/dist/public/assets/{razor-DiLk54O0.js → razor-DrjCyQqB.js} +1 -1
  555. package/dist/public/assets/{requirementDiagram-Y7LWUY3S-CwU2EBkW.js → requirementDiagram-Y7LWUY3S-CvRMeRqj.js} +1 -1
  556. package/dist/public/assets/{sankeyDiagram-WGJFYUXA-ajf00HyW.js → sankeyDiagram-WGJFYUXA-adxYCJKr.js} +1 -1
  557. package/dist/public/assets/{sequenceDiagram-5NDRBG5M-DiX_OIAw.js → sequenceDiagram-5NDRBG5M-lCRsoLUp.js} +1 -1
  558. package/dist/public/assets/{stateDiagram-v2-FJ4FJNEA-CV5bRqB7.js → stateDiagram-v2-FJ4FJNEA-DNst1BLg.js} +1 -1
  559. package/dist/public/assets/{swimlanes-UMQ2AFYF-BGQKSlj7.js → swimlanes-UMQ2AFYF-S_omrdvA.js} +1 -1
  560. package/dist/public/assets/swimlanesDiagram-OMPLPG4O-By5lnz4u.js +8 -0
  561. package/dist/public/assets/three.module-CeVBJVoU.js +4225 -0
  562. package/dist/public/assets/{timeline-definition-SEUHKTQE-DhQoApff.js → timeline-definition-SEUHKTQE-_pMGrTE-.js} +1 -1
  563. package/dist/public/assets/treeView-D4JQ5SDB-Cyb9N8KY.js +1 -0
  564. package/dist/public/assets/treemap-SAJKECNS-BkMo57pG.js +1 -0
  565. package/dist/public/assets/{typescript-COQ1g-up.js → typescript-0-z_OYCU.js} +1 -1
  566. package/dist/public/assets/{usecaseDiagram-AFA6YXN4-CmLFzjie.js → usecaseDiagram-AFA6YXN4-B2oJKi5Q.js} +1 -1
  567. package/dist/public/assets/{vennDiagram-NNMJR3RB-DOa6JR5K.js → vennDiagram-NNMJR3RB-inPs2Kkr.js} +1 -1
  568. package/dist/public/assets/wardley-7MLQ67FV-CSt-uQ-Y.js +1 -0
  569. package/dist/public/assets/{wardleyDiagram-S7YFUSEH-BV7EEShp.js → wardleyDiagram-S7YFUSEH-DNhNHM7b.js} +1 -1
  570. package/dist/public/assets/{xml-BbvtjuaG.js → xml-BXPxQzKF.js} +1 -1
  571. package/dist/public/assets/{xychartDiagram-GGNKY7IX-DtMpPbsq.js → xychartDiagram-GGNKY7IX-DJc93dNT.js} +1 -1
  572. package/dist/public/assets/{yaml-Bw8NFga9.js → yaml-CGmD9Rya.js} +1 -1
  573. package/dist/public/index.html +1 -1
  574. package/dist/serve/index.mjs +6664 -2480
  575. package/package.json +32 -25
  576. package/dist/public/assets/cynefin-EF2NZ3EQ-MaI-3dMQ.js +0 -1
  577. package/dist/public/assets/flowDiagram-MALGAFMO-shBnAQFk.js +0 -1
  578. package/dist/public/assets/gitGraph-VSP46ZUC-BtQWboBz.js +0 -1
  579. package/dist/public/assets/info-OHQRW6UA-CDSLjba_.js +0 -1
  580. package/dist/public/assets/module-BAQaY56j.js +0 -1
  581. package/dist/public/assets/module-DxRGg3ED.js +0 -1947
  582. package/dist/public/assets/packet-JDAUHWVQ-dYb4P9eU.js +0 -1
  583. package/dist/public/assets/pie-XZMESJXO-CIompBnc.js +0 -1
  584. package/dist/public/assets/radar-ABXABTNO-DiJl7BtK.js +0 -1
  585. package/dist/public/assets/railroad-I3PHUGI6-B5cRBukM.js +0 -1
  586. package/dist/public/assets/swimlanesDiagram-OMPLPG4O-DxXlavVT.js +0 -8
  587. package/dist/public/assets/treeView-D4JQ5SDB-BOP6mkZC.js +0 -1
  588. package/dist/public/assets/treemap-SAJKECNS-BJxuPMz3.js +0 -1
  589. package/dist/public/assets/wardley-7MLQ67FV-jqlowjVL.js +0 -1
@@ -0,0 +1,453 @@
1
+ ---
2
+ name: audio-and-sound
3
+ description: "Use this skill when adding audio or sound to a Phaser 4 game. Covers loading audio, playing sounds, music, volume, spatial audio, Web Audio API, and SoundManager. Triggers on: sound, audio, music, volume, mute."
4
+ ---
5
+
6
+ # Audio and Sound
7
+ > Phaser provides a unified Sound system via `this.sound` (a SoundManager) that abstracts over Web Audio API and HTML5 Audio. It handles loading, playback, volume, panning, looping, markers, audio sprites, spatial audio, and browser autoplay-policy unlocking.
8
+
9
+ **Key source paths:** `src/sound/BaseSoundManager.js`, `src/sound/BaseSound.js`, `src/sound/webaudio/`, `src/sound/html5/`, `src/sound/SoundManagerCreator.js`, `src/sound/events/`, `src/sound/typedefs/`
10
+ **Related skills:** ../loading-assets/SKILL.md, ../game-setup-and-config/SKILL.md
11
+
12
+ ## Quick Start
13
+
14
+ ```js
15
+ class GameScene extends Phaser.Scene {
16
+ preload() {
17
+ this.load.audio('bgm', 'assets/music.mp3');
18
+ this.load.audio('coin', ['assets/coin.ogg', 'assets/coin.mp3']);
19
+ }
20
+
21
+ create() {
22
+ // Fire-and-forget (auto-destroys when complete)
23
+ this.sound.play('coin');
24
+
25
+ // Retained reference for ongoing control
26
+ this.music = this.sound.add('bgm', { loop: true, volume: 0.5 });
27
+ this.music.play();
28
+ }
29
+ }
30
+ ```
31
+
32
+ Assets loaded via `this.load.audio()` in `preload()` are ready by the time `create()` runs. Provide an array of URLs for cross-browser format fallback.
33
+
34
+ ## Core Concepts
35
+
36
+ ### WebAudio vs HTML5 Audio
37
+
38
+ Phaser auto-selects the best backend via `SoundManagerCreator.create()`:
39
+
40
+ 1. If `config.audio.noAudio` is true, or the device supports neither Web Audio nor HTML5 Audio, a **NoAudioSoundManager** is created (all calls are no-ops).
41
+ 2. If the device supports Web Audio and `config.audio.disableWebAudio` is not true, a **WebAudioSoundManager** is created (preferred).
42
+ 3. Otherwise, an **HTML5AudioSoundManager** is created as fallback.
43
+
44
+ **WebAudio** advantages: precise timing, gapless looping, stereo panning (`StereoPannerNode`), spatial audio (`PannerNode`), per-sound gain nodes, `decodeAudio()` for runtime decoding.
45
+
46
+ **HTML5 Audio** limitations: no spatial audio, no real stereo panning (pan fires events but no audible effect), less precise looping, requires `instances` count at load time for simultaneous playback.
47
+
48
+ Force HTML5 or disable audio via game config: `audio: { disableWebAudio: true }` or `audio: { noAudio: true }`. Pass `audio: { context: existingAudioContext }` to reuse a WebAudio context in SPAs.
49
+
50
+ ### The SoundManager (`this.sound`)
51
+
52
+ Accessed via `this.sound` in any Scene. It is a single shared instance across the entire game. Key responsibilities:
53
+
54
+ - Adding, playing, and removing sound instances
55
+ - Global volume, mute, rate, and detune
56
+ - Automatic pause/resume when the browser tab loses/gains focus (`pauseOnBlur`, default `true`)
57
+ - Audio unlock handling for mobile browsers
58
+ - Spatial audio listener position (WebAudio only)
59
+
60
+ ### Sound Instances
61
+
62
+ Created via `this.sound.add(key, config)`. Each instance has its own playback state, volume, rate, detune, loop, pan, and seek properties. A sound must exist in the audio cache (loaded via the Loader) before it can be added.
63
+
64
+ State flags: `isPlaying` (boolean), `isPaused` (boolean).
65
+
66
+ ```js
67
+ const sfx = this.sound.add('explosion', { volume: 0.8 });
68
+ sfx.play(); // returns boolean
69
+ sfx.pause(); // only works if isPlaying
70
+ sfx.resume(); // only works if isPaused
71
+ sfx.stop(); // resets to stopped state
72
+ sfx.destroy(); // marks for removal from manager
73
+ ```
74
+
75
+ ## Common Patterns
76
+
77
+ ### Playing Sounds
78
+
79
+ **Fire-and-forget** -- `this.sound.play(key, config?)` adds, plays, and auto-destroys the sound on completion:
80
+
81
+ ```js
82
+ this.sound.play('explosion');
83
+ this.sound.play('powerup', { volume: 0.5, rate: 1.2 });
84
+ ```
85
+
86
+ **Retained reference** -- `this.sound.add(key, config?)` then call `play()` on the instance:
87
+
88
+ ```js
89
+ const laser = this.sound.add('laser');
90
+ laser.play();
91
+ // Later: laser.stop(), laser.volume = 0.3, etc.
92
+ ```
93
+
94
+ ### Volume, Rate, and Detune
95
+
96
+ Each property can be set per-sound or globally on the manager. Global and per-sound values combine (for rate/detune, they multiply via `calculateRate()`).
97
+
98
+ ```js
99
+ // Per-sound
100
+ sound.volume = 0.5; // 0 to 1
101
+ sound.setVolume(0.5); // chainable alternative
102
+ sound.rate = 1.5; // 0.5 = half speed, 2.0 = double speed
103
+ sound.setRate(1.5);
104
+ sound.detune = 200; // cents, -1200 to 1200
105
+ sound.setDetune(200);
106
+
107
+ // Global (affects all sounds)
108
+ this.sound.volume = 0.8;
109
+ this.sound.setVolume(0.8);
110
+ this.sound.rate = 1.0;
111
+ this.sound.setRate(1.0);
112
+ this.sound.detune = 0;
113
+ this.sound.setDetune(0);
114
+ ```
115
+
116
+ The effective playback rate is: `sound.rate * manager.rate * detuneRate` where `detuneRate = Math.pow(1.0005777895065548, sound.detune + manager.detune)`.
117
+
118
+ ### Looping
119
+
120
+ ```js
121
+ // Via config at creation
122
+ const bgm = this.sound.add('music', { loop: true });
123
+ bgm.play();
124
+
125
+ // Toggle during playback
126
+ bgm.loop = false;
127
+ bgm.setLoop(false); // chainable
128
+ ```
129
+
130
+ The `LOOPED` event fires each time the sound loops back to the start. The `LOOP` event fires when the loop property changes.
131
+
132
+ ### Seeking
133
+
134
+ ```js
135
+ sound.seek = 5.0; // jump to 5 seconds in
136
+ sound.setSeek(5.0); // chainable
137
+ console.log(sound.seek); // current playback position in seconds
138
+ ```
139
+
140
+ Setting seek on a stopped sound has no effect.
141
+
142
+ ### Stereo Panning
143
+
144
+ ```js
145
+ sound.pan = -1; // full left
146
+ sound.pan = 0; // center
147
+ sound.pan = 1; // full right
148
+ sound.setPan(0.5); // chainable
149
+ ```
150
+
151
+ Uses `StereoPannerNode`, if it exists, on WebAudio. On HTML5 Audio, the pan property fires events but has no audible effect.
152
+
153
+ ### Audio Sprites and Markers
154
+
155
+ Audio sprites combine multiple sounds into a single audio file with a JSON config (generated by the `audiosprite` tool). The JSON must be loaded separately.
156
+
157
+ ```js
158
+ // In preload
159
+ this.load.audioSprite('sfx', 'assets/sfx.json', ['assets/sfx.ogg', 'assets/sfx.mp3']);
160
+
161
+ // In create
162
+ this.sound.playAudioSprite('sfx', 'explosion');
163
+ this.sound.playAudioSprite('sfx', 'coin', { volume: 0.5 });
164
+
165
+ // Or add for retained control
166
+ const sprite = this.sound.addAudioSprite('sfx');
167
+ sprite.play('explosion');
168
+ ```
169
+
170
+ The JSON `spritemap` entries are automatically converted to markers with `name`, `start`, `duration`, and optional `loop`.
171
+
172
+ **Manual markers** -- you can also add markers to any sound:
173
+
174
+ ```js
175
+ const sound = this.sound.add('longtrack');
176
+
177
+ sound.addMarker({ name: 'intro', start: 0, duration: 5 });
178
+ sound.addMarker({ name: 'loop', start: 5, duration: 20, config: { loop: true } });
179
+ sound.addMarker({ name: 'outro', start: 25, duration: 3 });
180
+
181
+ sound.play('intro');
182
+ // Later
183
+ sound.play('loop');
184
+ ```
185
+
186
+ Marker API on BaseSound: `addMarker(marker)`, `updateMarker(marker)`, `removeMarker(markerName)`.
187
+
188
+ ### Background Music Pattern
189
+
190
+ ```js
191
+ this.bgm = this.sound.add('theme', { loop: true, volume: 0.4 });
192
+ this.bgm.play();
193
+ // Stop on scene shutdown: this.bgm.stop();
194
+ ```
195
+
196
+ The manager's `pauseOnBlur` (default `true`) automatically pauses all sounds when the tab loses focus.
197
+
198
+ ### Spatial Audio (WebAudio Only)
199
+
200
+ Spatial audio uses the Web Audio `PannerNode` to position sounds in 2D/3D space relative to a listener.
201
+
202
+ ```js
203
+ // Set the listener position (typically your camera or player)
204
+ this.sound.setListenerPosition(400, 300);
205
+ // Or update directly: this.sound.listenerPosition.set(x, y);
206
+
207
+ // Create a spatialized sound with a source config
208
+ const enemy = this.sound.add('roar', {
209
+ source: {
210
+ x: 800,
211
+ y: 300,
212
+ refDistance: 50,
213
+ maxDistance: 2000,
214
+ rolloffFactor: 1,
215
+ distanceModel: 'inverse',
216
+ panningModel: 'equalpower',
217
+ follow: enemySprite // auto-track a Game Object's x/y
218
+ }
219
+ });
220
+ enemy.play();
221
+ ```
222
+
223
+ You can set `sound.x` and `sound.y` directly on a WebAudioSound to reposition it at any time. If `follow` is set to an object with `x`/`y` properties, the spatial position updates automatically each frame.
224
+
225
+ `setListenerPosition()` defaults to the center of the game canvas if called with no arguments.
226
+
227
+ ### Muting
228
+
229
+ ```js
230
+ // Per-sound
231
+ sound.mute = true;
232
+ sound.setMute(true);
233
+
234
+ // Global
235
+ this.sound.mute = true;
236
+ this.sound.setMute(true);
237
+ ```
238
+
239
+ ### Querying Sounds
240
+
241
+ ```js
242
+ this.sound.get('coin'); // first sound with key, or null
243
+ this.sound.getAll('coin'); // all sounds with key
244
+ this.sound.getAll(); // every sound in the manager
245
+ this.sound.getAllPlaying(); // all currently playing sounds
246
+ this.sound.isPlaying('coin'); // true if any 'coin' sound is playing
247
+ this.sound.isPlaying(); // true if any sound is playing
248
+ ```
249
+
250
+ ### Removing and Stopping
251
+
252
+ ```js
253
+ this.sound.stopAll(); // stop all sounds, fires STOP_ALL
254
+ this.sound.stopByKey('coin'); // stop all sounds with key, returns count
255
+ this.sound.pauseAll(); // pause all, fires PAUSE_ALL
256
+ this.sound.resumeAll(); // resume all, fires RESUME_ALL
257
+
258
+ this.sound.remove(soundInstance); // destroy + remove specific sound
259
+ this.sound.removeByKey('coin'); // destroy + remove all with key, returns count
260
+ this.sound.removeAll(); // destroy + remove everything
261
+ ```
262
+
263
+ ### Decoding Audio at Runtime (WebAudio Only)
264
+
265
+ ```js
266
+ this.sound.decodeAudio('key', base64StringOrArrayBuffer);
267
+ // Or batch: this.sound.decodeAudio([{ key: 'sfx1', data: buf1 }, { key: 'sfx2', data: buf2 }]);
268
+ this.sound.on('decoded', (key) => { /* one done */ });
269
+ this.sound.on('decodedall', () => { /* all done */ });
270
+ ```
271
+
272
+ ## Configuration Reference
273
+
274
+ ### SoundConfig
275
+
276
+ | Property | Type | Default | Description |
277
+ |----------|------|---------|-------------|
278
+ | `mute` | boolean | `false` | Whether the sound is muted |
279
+ | `volume` | number | `1` | Volume, 0 (silence) to 1 (full) |
280
+ | `rate` | number | `1` | Playback speed (0.5 = half, 2.0 = double) |
281
+ | `detune` | number | `0` | Detuning in cents (-1200 to 1200) |
282
+ | `seek` | number | `0` | Start playback position in seconds |
283
+ | `loop` | boolean | `false` | Whether the sound should loop |
284
+ | `delay` | number | `0` | Delay before playback starts, in seconds |
285
+ | `pan` | number | `0` | Stereo pan, -1 (left) to 1 (right) |
286
+ | `source` | SpatialSoundConfig | `null` | Spatial audio configuration (WebAudio only) |
287
+
288
+ ### SpatialSoundConfig
289
+
290
+ Position: `x` (0), `y` (0), `z` (0) -- source position in world space.
291
+ Orientation: `orientationX` (0), `orientationY` (0), `orientationZ` (-1) -- source direction vector.
292
+ Models: `panningModel` (`'equalpower'` or `'HRTF'`), `distanceModel` (`'linear'`, `'inverse'`, `'exponential'`).
293
+ Distance: `refDistance` (1), `maxDistance` (10000), `rolloffFactor` (1).
294
+ Cone: `coneInnerAngle` (360), `coneOuterAngle` (0), `coneOuterGain` (0).
295
+ Tracking: `follow` (null) -- a Vector2Like object whose x/y is auto-tracked each frame.
296
+
297
+ ### SoundMarker
298
+
299
+ | Property | Type | Default | Description |
300
+ |----------|------|---------|-------------|
301
+ | `name` | string | (required) | Unique identifier for the marker |
302
+ | `start` | number | `0` | Start position in seconds |
303
+ | `duration` | number | (remaining) | Playback duration in seconds |
304
+ | `config` | SoundConfig | `{}` | Default settings for this marker |
305
+
306
+ ## Events
307
+
308
+ ### Sound Instance Events (emitted on a Sound object)
309
+
310
+ | Event Constant | String Value | Callback Args | When |
311
+ |---------------|-------------|---------------|------|
312
+ | `Events.PLAY` | `'play'` | `(sound)` | Sound starts playing |
313
+ | `Events.PAUSE` | `'pause'` | `(sound)` | Sound is paused |
314
+ | `Events.RESUME` | `'resume'` | `(sound)` | Sound resumes from pause |
315
+ | `Events.STOP` | `'stop'` | `(sound)` | Sound is stopped |
316
+ | `Events.COMPLETE` | `'complete'` | `(sound)` | Sound finishes (non-looping) |
317
+ | `Events.LOOPED` | `'looped'` | `(sound)` | Sound loops back to start |
318
+ | `Events.LOOP` | `'loop'` | `(sound, value)` | Loop property changes |
319
+ | `Events.MUTE` | `'mute'` | `(sound, value)` | Mute state changes |
320
+ | `Events.VOLUME` | `'volume'` | `(sound, value)` | Volume changes |
321
+ | `Events.RATE` | `'rate'` | `(sound, value)` | Rate changes |
322
+ | `Events.DETUNE` | `'detune'` | `(sound, value)` | Detune changes |
323
+ | `Events.SEEK` | `'seek'` | `(sound, value)` | Seek position changes |
324
+ | `Events.PAN` | `'pan'` | `(sound, value)` | Pan value changes |
325
+ | `Events.DESTROY` | `'destroy'` | `(sound)` | Sound is destroyed |
326
+
327
+ ### SoundManager Events (emitted on `this.sound`)
328
+
329
+ | Event Constant | String Value | Callback Args | When |
330
+ |---------------|-------------|---------------|------|
331
+ | `Events.PAUSE_ALL` | `'pauseall'` | `(manager)` | `pauseAll()` called |
332
+ | `Events.RESUME_ALL` | `'resumeall'` | `(manager)` | `resumeAll()` called |
333
+ | `Events.STOP_ALL` | `'stopall'` | `(manager)` | `stopAll()` called |
334
+ | `Events.GLOBAL_MUTE` | `'globalmute'` | `(manager, value)` | Global mute changes |
335
+ | `Events.GLOBAL_VOLUME` | `'globalvolume'` | `(manager, value)` | Global volume changes |
336
+ | `Events.GLOBAL_RATE` | `'globalrate'` | `(manager, value)` | Global rate changes |
337
+ | `Events.GLOBAL_DETUNE` | `'globaldetune'` | `(manager, value)` | Global detune changes |
338
+ | `Events.UNLOCKED` | `'unlocked'` | `(manager)` | Audio system unlocked after user interaction |
339
+ | `Events.DECODED` | `'decoded'` | `(key)` | Single audio key decoded (WebAudio) |
340
+ | `Events.DECODED_ALL` | `'decodedall'` | `()` | All queued audio decoded (WebAudio) |
341
+
342
+ ```js
343
+ // Example: listen for completion
344
+ const sfx = this.sound.add('bang');
345
+ sfx.on('complete', (sound) => {
346
+ console.log(sound.key, 'finished');
347
+ });
348
+ sfx.play();
349
+ ```
350
+
351
+ ## API Quick Reference
352
+
353
+ ### BaseSoundManager (`this.sound`)
354
+
355
+ Methods: `add(key, config?)`, `addAudioSprite(key, config?)`, `play(key, extra?)`, `playAudioSprite(key, spriteName, config?)`, `get(key)`, `getAll(key?)`, `getAllPlaying()`, `isPlaying(key?)`, `remove(sound)`, `removeByKey(key)`, `removeAll()`, `stopAll()`, `stopByKey(key)`, `pauseAll()`, `resumeAll()`, `setListenerPosition(x?, y?)`, `setMute(value)`, `setVolume(value)`, `setRate(value)`, `setDetune(value)`.
356
+
357
+ Properties: `volume` (0-1), `mute` (boolean), `rate` (number), `detune` (-1200 to 1200), `pauseOnBlur` (boolean, default true), `locked` (boolean, read-only), `listenerPosition` (Vector2), `sounds` (array, private).
358
+
359
+ ### BaseSound (sound instance)
360
+
361
+ Methods: `play(markerName?, config?)`, `pause()`, `resume()`, `stop()`, `destroy()`, `addMarker(marker)`, `updateMarker(marker)`, `removeMarker(name)`, `setMute(value)`, `setVolume(value)`, `setRate(value)`, `setDetune(value)`, `setSeek(value)`, `setLoop(value)`, `setPan(value)`.
362
+
363
+ Properties: `volume` (0-1), `mute` (boolean), `rate` (number), `detune` (number), `seek` (seconds), `loop` (boolean), `pan` (-1 to 1), `isPlaying` (read-only), `isPaused` (read-only), `duration` (seconds), `totalDuration` (seconds), `key` (string), `x` / `y` (spatial position, WebAudio only).
364
+
365
+ All `set*` methods return `this` for chaining.
366
+
367
+ ## Gotchas
368
+
369
+ ### Browser Autoplay Policy
370
+
371
+ Browsers block audio until user interaction. Phaser handles this automatically:
372
+
373
+ - **WebAudio**: `AudioContext` starts suspended. Phaser listens for touchstart/touchend/mousedown/mouseup/keydown on `document.body` to call `context.resume()`. The `locked` property is true until unlocked; `UNLOCKED` event fires once resolved.
374
+ - **HTML5 Audio**: Locked audio tags queue all actions until the first touch replays them.
375
+
376
+ You do **not** need to handle unlocking manually. To know when ready, listen for `UNLOCKED`:
377
+
378
+ ```js
379
+ if (this.sound.locked) {
380
+ this.sound.once('unlocked', () => {
381
+ this.sound.play('bgm');
382
+ });
383
+ } else {
384
+ this.sound.play('bgm');
385
+ }
386
+ ```
387
+
388
+ ### Audio Format Support
389
+
390
+ No single format works everywhere. Provide multiple formats: `this.load.audio('bgm', ['assets/bgm.ogg', 'assets/bgm.mp3'])`. MP3 has broadest support. OGG Vorbis lacks Safari support. AAC/M4A works well on Safari/iOS. WebM/Opus has excellent quality but limited older browser support.
391
+
392
+ ### HTML5 Audio Simultaneous Playback
393
+
394
+ HTML5 Audio uses a pool of `<audio>` tags. Specify `instances` when loading for simultaneous playback: `this.load.audio('shot', 'assets/shot.mp3', { instances: 4 })`. Default is 1. If all tags are in use and `manager.override` is true (default), the sound with the most progress is hijacked. WebAudio has no such limitation.
395
+
396
+ ### iOS/Safari Specifics
397
+
398
+ - `StereoPannerNode` not supported on iOS/Safari, so `pan` has no audible effect (events still fire).
399
+ - iOS 17/18+ can interrupt audio on background. Phaser handles this via `context.suspend()`/`context.resume()` on the `VISIBLE` game event.
400
+ - `setListenerPosition()` and spatial audio are WebAudio-only.
401
+
402
+ ### WebAudio Context Reuse
403
+
404
+ For SPAs that recreate the game without a full page reload, pass `audio: { context: existingAudioContext }` in the game config. You can also swap contexts at runtime via `this.sound.setAudioContext(newContext)` (WebAudio only).
405
+
406
+ ### Sound Manager is Shared (Global)
407
+
408
+ There is one SoundManager per game, not per scene. `this.sound` in every scene references the same manager. Sounds are not automatically cleaned up on scene shutdown -- you must stop/remove them yourself if needed. Looping sounds will continue playing across scene changes unless explicitly stopped.
409
+
410
+ ### Fire-and-Forget vs Persistent Sounds
411
+
412
+ `this.sound.play(key)` creates a sound that auto-destroys on completion -- you cannot control it after calling play. Use `this.sound.add(key)` when you need a persistent reference to pause, stop, adjust volume, or listen for events.
413
+
414
+ ### Spatial Audio is WebAudio Only
415
+
416
+ The `source` config for spatial audio is silently ignored when using HTML5 Audio. If your game must support HTML5 Audio fallback, do not rely on spatial positioning for gameplay-critical audio cues.
417
+
418
+ ### Web Audio Analyser (WebAudio Only)
419
+
420
+ Access the underlying `AudioContext` to create an `AnalyserNode` for frequency/waveform visualization:
421
+
422
+ ```js
423
+ const analyser = this.sound.context.createAnalyser();
424
+ analyser.fftSize = 256;
425
+ this.sound.masterVolumeNode.connect(analyser);
426
+ analyser.connect(this.sound.context.destination);
427
+
428
+ const dataArray = new Uint8Array(analyser.frequencyBinCount);
429
+
430
+ // In update loop
431
+ analyser.getByteFrequencyData(dataArray);
432
+ // Use dataArray values to drive visual effects
433
+ ```
434
+
435
+ This only works with the WebAudioSoundManager. Check `this.sound.context` exists before using.
436
+
437
+ ## Source File Map
438
+
439
+ | File | Purpose |
440
+ |------|---------|
441
+ | `src/sound/SoundManagerCreator.js` | Factory: picks WebAudio, HTML5, or NoAudio manager |
442
+ | `src/sound/BaseSoundManager.js` | Base manager: add, play, get, stop/pause/resume all, global volume/rate/detune |
443
+ | `src/sound/BaseSound.js` | Base sound: play/pause/resume/stop, markers, config, calculateRate |
444
+ | `src/sound/webaudio/WebAudioSoundManager.js` | WebAudio manager: AudioContext, gain nodes, unlock, spatial listener, decodeAudio |
445
+ | `src/sound/webaudio/WebAudioSound.js` | WebAudio sound: buffer sources, spatial/panner nodes, seek, all properties |
446
+ | `src/sound/html5/HTML5AudioSoundManager.js` | HTML5 manager: audio tag pooling, locked queue, override |
447
+ | `src/sound/html5/HTML5AudioSound.js` | HTML5 sound: tag-based playback, limited feature set |
448
+ | `src/sound/noaudio/NoAudioSoundManager.js` | No-op manager for environments without audio |
449
+ | `src/sound/events/` | All sound event constants (PLAY, STOP, COMPLETE, etc.) |
450
+ | `src/sound/typedefs/SoundConfig.js` | SoundConfig type definition |
451
+ | `src/sound/typedefs/SoundMarker.js` | SoundMarker type definition |
452
+ | `src/sound/typedefs/SpatialSoundConfig.js` | SpatialSoundConfig type definition |
453
+ | `src/sound/typedefs/AudioSpriteSound.js` | AudioSpriteSound type definition |