@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,499 @@
1
+ ---
2
+ name: particles
3
+ description: "Use this skill when creating particle effects in Phaser 4. Covers ParticleEmitter, emission zones, death zones, particle properties, textures, gravity wells, and particle movement. Triggers on: particles, emitter, particle effect, explosion, fire, smoke."
4
+ ---
5
+
6
+ # Particle System
7
+ > Creating and controlling particle effects in Phaser 4 -- ParticleEmitter creation and configuration, emitter ops (value formats), gravity wells, emission and death zones, flow vs burst modes, following game objects, and particle callbacks.
8
+
9
+ **Key source paths:** `src/gameobjects/particles/`
10
+ **Related skills:** ../sprites-and-images/SKILL.md, ../loading-assets/SKILL.md
11
+
12
+ ## Quick Start
13
+
14
+ ```js
15
+ // In a Scene's create() method:
16
+
17
+ // Basic continuous emitter (flow mode)
18
+ const emitter = this.add.particles(400, 300, 'flares', {
19
+ frame: 'red',
20
+ speed: 200,
21
+ lifespan: 2000,
22
+ scale: { start: 1, end: 0 },
23
+ alpha: { start: 1, end: 0 },
24
+ gravityY: 150
25
+ });
26
+
27
+ // One-shot burst (explode mode)
28
+ const burst = this.add.particles(400, 300, 'flares', {
29
+ frame: 'blue',
30
+ speed: { min: 100, max: 300 },
31
+ lifespan: 1000,
32
+ scale: { start: 0.5, end: 0 },
33
+ emitting: false // don't auto-start
34
+ });
35
+ burst.explode(20); // emit 20 particles at once
36
+ ```
37
+
38
+ ## Core Concepts
39
+
40
+ ### ParticleEmitter
41
+
42
+ `ParticleEmitter` extends `GameObject` and is added directly to the display list. It is both a game object (positionable, scalable, maskable) and the emitter itself. There is no separate manager -- `this.add.particles()` returns a `ParticleEmitter` instance.
43
+
44
+ **Factory signature:**
45
+ ```js
46
+ this.add.particles(x, y, texture, config);
47
+ // x, y: world position (both optional, default 0)
48
+ // texture: string key or Texture instance
49
+ // config: ParticleEmitterConfig object (optional, can call setConfig later)
50
+ ```
51
+
52
+ **Mixins:** AlphaSingle, BlendMode, Depth, Lighting, Mask, RenderNodes, ScrollFactor, Texture, Transform, Visible. So you can call `setPosition()`, `setScale()`, `setDepth()`, `setBlendMode()`, `setMask()`, `setScrollFactor()`, etc.
53
+
54
+ ### Particle
55
+
56
+ A lightweight object owned by its emitter. Key properties: `x`, `y`, `velocityX/Y`, `accelerationX/Y`, `scaleX/Y`, `alpha`, `angle`, `rotation`, `tint`, `life` (total ms), `lifeCurrent` (remaining ms), `lifeT` (0-1 normalized), `bounce`, `delayCurrent`, `holdCurrent`. Particles are pooled internally -- you never create them manually.
57
+
58
+ ### EmitterOp Value Formats
59
+
60
+ Most config properties (speed, scale, alpha, angle, x, y, etc.) accept flexible value formats:
61
+
62
+ ```js
63
+ x: 400 // static value
64
+ x: [100, 200, 300, 400] // random pick from array
65
+ x: { min: 100, max: 700 } // random float in range
66
+ x: { min: 100, max: 700, int: true } // random integer
67
+ x: { random: [100, 700] } // random integer shorthand
68
+ scale: { start: 0, end: 1 } // ease over lifetime (default linear)
69
+ scale: { start: 0, end: 1, ease: 'bounce.out' } // custom ease
70
+ scale: { start: 4, end: 0.5, random: true } // random start, ease to end
71
+ x: { values: [50, 500, 200, 800], interpolation: 'catmull' } // interpolation
72
+ x: { steps: 32, start: 0, end: 576 } // stepped sequential
73
+ x: { steps: 32, start: 0, end: 576, yoyo: true } // stepped with yoyo
74
+ x: { // custom callbacks
75
+ onEmit: (particle, key, t, value) => value,
76
+ onUpdate: (particle, key, t, value) => value
77
+ }
78
+ x: (particle, key, t, value) => value + 50 // emit-time callback shorthand
79
+ ```
80
+
81
+ **Emit-only** (no onUpdate): `angle`, `delay`, `hold`, `lifespan`, `quantity`, `speedX`, `speedY`.
82
+ **Emit + Update** (support start/end, onUpdate): `accelerationX/Y`, `alpha`, `bounce`, `maxVelocityX/Y`, `moveToX/Y`, `rotate`, `scaleX/Y`, `tint`, `x`, `y`.
83
+
84
+ ### Flow vs Explode (Burst)
85
+
86
+ **Flow mode** (`frequency >= 0`): emits `quantity` particles every `frequency` ms. Default is `frequency: 0` (every frame) with `emitting: true`.
87
+
88
+ **Explode mode** (`frequency = -1`): emits a batch all at once, then stops.
89
+
90
+ ```js
91
+ emitter.flow(100, 5); // 5 particles every 100ms
92
+ emitter.flow(100, 5, 50); // auto-stop after 50 total
93
+ emitter.explode(30, 200, 400); // burst 30 at position
94
+ emitter.explode(30); // burst at emitter position
95
+ ```
96
+
97
+ ## Common Patterns
98
+
99
+ ### Scale, Alpha, and Color Over Lifetime
100
+
101
+ ```js
102
+ // Scale and alpha with custom easing
103
+ this.add.particles(400, 300, 'spark', {
104
+ lifespan: 2000,
105
+ speed: 100,
106
+ scale: { start: 1, end: 0, ease: 'power2' },
107
+ alpha: { start: 1, end: 0, ease: 'cubic.in' }
108
+ });
109
+ ```
110
+
111
+ ### Color Interpolation
112
+
113
+ The `color` property interpolates through an array of colors over particle lifetime (overrides `tint`):
114
+
115
+ ```js
116
+ this.add.particles(400, 300, 'spark', {
117
+ lifespan: 2000, speed: 100, scale: { start: 0.5, end: 0 },
118
+ color: [0xfacc22, 0xf89800, 0xf83600, 0x9f0404], colorEase: 'quad.out'
119
+ });
120
+ ```
121
+
122
+ ### Tinting Particles
123
+
124
+ ```js
125
+ this.add.particles(400, 300, 'spark', { tint: 0xff0000 }); // static
126
+ this.add.particles(400, 300, 'spark', { tint: { start: 0xffffff, end: 0xff0000 } }); // over lifetime
127
+ ```
128
+
129
+ ### Gravity Wells
130
+
131
+ A `GravityWell` applies inverse-square gravitational force, pulling (or repelling with negative `power`) particles toward a point.
132
+
133
+ ```js
134
+ const emitter = this.add.particles(400, 300, 'spark', {
135
+ speed: 100, lifespan: 4000, scale: { start: 0.4, end: 0 }, quantity: 2
136
+ });
137
+
138
+ const well = emitter.createGravityWell({
139
+ x: 400, y: 300, power: 2, epsilon: 100, gravity: 50
140
+ });
141
+
142
+ // Update at runtime
143
+ well.x = 300;
144
+ well.power = -1; // negative = repel
145
+
146
+ // Or create manually and add
147
+ const well2 = new Phaser.GameObjects.Particles.GravityWell(500, 200, 3, 100, 50);
148
+ emitter.addParticleProcessor(well2);
149
+ emitter.removeParticleProcessor(well2);
150
+ ```
151
+
152
+ ### Emission Zones (Random)
153
+
154
+ A `RandomZone` spawns particles at random positions within a shape. The source must have a `getRandomPoint(point)` method -- all Phaser geometry classes (Circle, Ellipse, Rectangle, Triangle, Polygon, Line) support this, or provide a custom source:
155
+
156
+ ```js
157
+ // Using built-in geometry
158
+ this.add.particles(400, 300, 'spark', {
159
+ speed: 50, lifespan: 2000,
160
+ emitZone: { type: 'random', source: new Phaser.Geom.Circle(0, 0, 100) }
161
+ });
162
+
163
+ // Custom source object (any object with getRandomPoint)
164
+ emitter.addEmitZone({
165
+ type: 'random',
166
+ source: {
167
+ getRandomPoint: (point) => {
168
+ const a = Math.random() * Math.PI * 2;
169
+ point.x = Math.cos(a) * 100;
170
+ point.y = Math.sin(a) * 50;
171
+ return point;
172
+ }
173
+ }
174
+ });
175
+ ```
176
+
177
+ ### Emission Zones (Edge)
178
+
179
+ An `EdgeZone` places particles sequentially along shape edges. The source must have a `getPoints(quantity, stepRate)` method. Curves, Paths, and all geometry shapes support this:
180
+
181
+ ```js
182
+ this.add.particles(400, 300, 'spark', {
183
+ lifespan: 1500, speed: 20,
184
+ emitZone: {
185
+ type: 'edge',
186
+ source: new Phaser.Geom.Circle(0, 0, 150),
187
+ quantity: 48, // number of points on edge (use 0 with stepRate instead)
188
+ yoyo: false, // reverse direction at ends
189
+ seamless: true // remove duplicate endpoint
190
+ }
191
+ });
192
+
193
+ // Or add post-creation with any source that has getPoints
194
+ emitter.addEmitZone({ type: 'edge', source: geom, quantity: 50, yoyo: false, seamless: true });
195
+ ```
196
+
197
+ **Multiple emission zones:** Pass an array to `emitZone` or call `addEmitZone()` multiple times. Zones iterate in sequence. The `total` property controls how many particles emit before rotating to the next zone (-1 = never rotate).
198
+
199
+ ```js
200
+ this.add.particles(400, 300, 'spark', {
201
+ emitZone: [
202
+ { type: 'random', source: new Phaser.Geom.Circle(0, 0, 50) },
203
+ { type: 'random', source: new Phaser.Geom.Circle(200, 0, 50) }
204
+ ]
205
+ });
206
+ ```
207
+
208
+ ### Death Zones
209
+
210
+ A `DeathZone` kills particles when they enter (or leave) a region. The source must have a `contains(x, y)` method.
211
+
212
+ ```js
213
+ // Kill particles entering a rectangle
214
+ this.add.particles(400, 100, 'spark', {
215
+ speed: 200, lifespan: 5000, gravityY: 100,
216
+ deathZone: { type: 'onEnter', source: new Phaser.Geom.Rectangle(300, 400, 200, 50) }
217
+ });
218
+
219
+ // Kill particles leaving a circle (confine to area)
220
+ this.add.particles(400, 300, 'spark', {
221
+ speed: 100, lifespan: 5000,
222
+ deathZone: { type: 'onLeave', source: new Phaser.Geom.Circle(400, 300, 150) }
223
+ });
224
+
225
+ // Custom death zone source (any object with contains)
226
+ emitter.addDeathZone({
227
+ type: 'onEnter',
228
+ source: { contains: (x, y) => x > 600 && y > 400 }
229
+ });
230
+ ```
231
+
232
+ ### Following a Game Object
233
+
234
+ ```js
235
+ const player = this.add.sprite(100, 100, 'player');
236
+ const emitter = this.add.particles(0, 0, 'spark', {
237
+ speed: 50, lifespan: 800, scale: { start: 0.5, end: 0 }
238
+ });
239
+
240
+ emitter.startFollow(player); // follow position
241
+ emitter.startFollow(player, 10, -20); // with offset
242
+ emitter.startFollow(player, 0, 0, true); // track visibility too
243
+ emitter.stopFollow();
244
+
245
+ // Or via config:
246
+ this.add.particles(0, 0, 'spark', { follow: player, followOffset: { x: 0, y: -20 } });
247
+ ```
248
+
249
+ ### Particle Callbacks
250
+
251
+ ```js
252
+ // Via config
253
+ const emitter = this.add.particles(400, 300, 'spark', {
254
+ speed: 100, lifespan: 2000,
255
+ emitCallback: (particle, emitter) => { /* on emit */ },
256
+ deathCallback: (particle) => { /* on death */ }
257
+ });
258
+
259
+ // Or set after creation
260
+ emitter.onParticleEmit((particle, emitter) => { /* ... */ });
261
+ emitter.onParticleDeath((particle) => { /* ... */ });
262
+
263
+ // Iterate alive/dead particles
264
+ emitter.forEachAlive((particle, emitter) => { /* particle.x, particle.lifeT */ });
265
+ ```
266
+
267
+ ### Duration, StopAfter, and Advance
268
+
269
+ ```js
270
+ // Auto-stop after 3 seconds (alive particles continue until they expire)
271
+ this.add.particles(400, 300, 'spark', { speed: 100, duration: 3000 });
272
+
273
+ // Emit exactly 50 particles then stop
274
+ this.add.particles(400, 300, 'spark', { speed: 100, stopAfter: 50 });
275
+
276
+ // Pre-warm: fast-forward 2 seconds so particles visible on first frame
277
+ this.add.particles(400, 300, 'spark', { speed: 100, lifespan: 2000, advance: 2000 });
278
+ // Or manually: emitter.fastForward(2000, 50);
279
+ ```
280
+
281
+ ### Particle Bounds (Bounce)
282
+
283
+ ```js
284
+ this.add.particles(400, 300, 'spark', {
285
+ speed: 200, lifespan: 5000, bounce: 0.8,
286
+ bounds: { x: 100, y: 100, width: 600, height: 400 },
287
+ collideLeft: true, collideRight: true, collideTop: true, collideBottom: true
288
+ });
289
+ // Or: emitter.addParticleBounds(100, 100, 600, 400);
290
+ ```
291
+
292
+ ### Texture Frames and Animations
293
+
294
+ ```js
295
+ // Random frame per particle
296
+ this.add.particles(400, 300, 'flares', { frame: ['red', 'green', 'blue'] });
297
+
298
+ // Sequential frames cycling through with quantity per frame
299
+ this.add.particles(400, 300, 'flares', {
300
+ frame: { frames: ['red', 'green', 'blue'], cycle: true, quantity: 4 }
301
+ });
302
+
303
+ // Particle animation (plays anim over particle lifetime)
304
+ this.add.particles(400, 300, 'explosion', { anim: 'explode_anim', lifespan: 1000 });
305
+
306
+ // Multiple anims, randomly assigned
307
+ this.add.particles(400, 300, 'sheet', {
308
+ anim: { anims: ['fire', 'smoke'], cycle: false, quantity: 1 }
309
+ });
310
+ ```
311
+
312
+ ### Sorting Particles
313
+
314
+ ```js
315
+ this.add.particles(400, 300, 'spark', { sortProperty: 'y', sortOrderAsc: true });
316
+ // Or: sortCallback: (a, b) => a.y - b.y
317
+ ```
318
+
319
+ ### Custom Particle Processor
320
+
321
+ Extend `ParticleProcessor` to apply custom per-particle logic each frame. Implement `update(particle, delta, step, t)`:
322
+
323
+ ```js
324
+ class WindProcessor extends Phaser.GameObjects.Particles.ParticleProcessor {
325
+ constructor (windX, windY) {
326
+ super(0, 0);
327
+ this.windX = windX;
328
+ this.windY = windY;
329
+ }
330
+
331
+ update (particle, delta, step, t) {
332
+ particle.velocityX += this.windX * step;
333
+ particle.velocityY += this.windY * step;
334
+ }
335
+ }
336
+
337
+ emitter.addParticleProcessor(new WindProcessor(0.5, 0));
338
+ ```
339
+
340
+ ### Custom Particle Class
341
+
342
+ Extend `Particle` and override `update` for per-particle behavior. Set via `particleClass` in config:
343
+
344
+ ```js
345
+ class TrailParticle extends Phaser.GameObjects.Particles.Particle {
346
+ update (delta, step, processors) {
347
+ const result = super.update(delta, step, processors);
348
+ this.alpha = this.lifeT; // custom: alpha matches life progress
349
+ return result; // must return true if particle is still alive
350
+ }
351
+ }
352
+
353
+ this.add.particles(400, 300, 'spark', {
354
+ particleClass: TrailParticle,
355
+ speed: 100, lifespan: 2000
356
+ });
357
+ ```
358
+
359
+ ## Configuration Reference
360
+
361
+ ### ParticleEmitterConfig -- Simple Properties
362
+
363
+ | Property | Type | Default | Description |
364
+ |---|---|---|---|
365
+ | `active` | boolean | `true` | False = emitter does not update at all |
366
+ | `emitting` | boolean | `true` | False = no new particles (alive ones still update) |
367
+ | `blendMode` | string/number | `0` | Blend mode for rendering |
368
+ | `frequency` | number | `0` | ms between flow cycles; 0 = every frame; -1 = explode |
369
+ | `gravityX`, `gravityY` | number | `0` | Gravity in px/s^2 |
370
+ | `maxParticles` | number | `0` | Hard limit on total particle objects (0 = unlimited) |
371
+ | `maxAliveParticles` | number | `0` | Max alive particles at once (0 = unlimited) |
372
+ | `duration` | number | `0` | Auto-stop after ms (0 = forever) |
373
+ | `stopAfter` | number | `0` | Auto-stop after N particles emitted (0 = unlimited) |
374
+ | `advance` | number | `0` | Fast-forward on creation (ms) |
375
+ | `radial` | boolean | `true` | True = speed+angle; false = speedX/speedY |
376
+ | `particleBringToTop` | boolean | `true` | New particles render on top |
377
+ | `timeScale` | number | `1` | Time multiplier for updates |
378
+ | `follow` | Vector2Like | `null` | Object to follow |
379
+ | `followOffset` | Vector2Like | | Offset from follow target |
380
+ | `trackVisible` | boolean | `false` | Match follow target's visibility |
381
+ | `reserve` | number | | Pre-allocate particle objects |
382
+ | `particleClass` | function | `Particle` | Custom particle class |
383
+ | `sortProperty` | string | | Particle property to sort by |
384
+ | `sortOrderAsc` | boolean | | Sort ascending if true |
385
+
386
+ ### ParticleEmitterConfig -- EmitterOp Properties
387
+
388
+ All accept the flexible value formats described above.
389
+
390
+ | Property | Default | E/U | Description |
391
+ |---|---|---|---|
392
+ | `x`, `y` | `0` | E+U | Particle offset from emitter |
393
+ | `speed` | `0` | E | Radial speed (sets speedX, deactivates speedY) |
394
+ | `speedX`, `speedY` | `0` | E | Directional speed (sets radial=false) |
395
+ | `angle` | `{min:0,max:360}` | E | Emission angle in degrees |
396
+ | `scale` | `1` | E+U | Uniform scale (sets scaleX, deactivates scaleY) |
397
+ | `scaleX`, `scaleY` | `1` | E+U | Non-uniform scale |
398
+ | `alpha` | `1` | E+U | Alpha transparency |
399
+ | `rotate` | `0` | E+U | Rotation in degrees |
400
+ | `tint` | `0xffffff` | E+U | Tint color (WebGL) |
401
+ | `color` | | E+U | Color array to interpolate (overrides tint) |
402
+ | `colorEase` | | | Ease for color interpolation |
403
+ | `lifespan` | `1000` | E | Lifetime in ms |
404
+ | `delay` | `0` | E | Delay before visible (ms) |
405
+ | `hold` | `0` | E | Hold at end of life before dying (ms) |
406
+ | `quantity` | `1` | E | Particles per flow cycle |
407
+ | `accelerationX/Y` | `0` | E+U | Acceleration (px/s^2) |
408
+ | `maxVelocityX/Y` | `10000` | E+U | Max velocity |
409
+ | `bounce` | `0` | E+U | Bounce restitution (0-1) |
410
+ | `moveToX`, `moveToY` | `0` | E+U | Target position (overrides angle/speed) |
411
+
412
+ *E = emit-only, E+U = emit + update (supports start/end, onUpdate)*
413
+
414
+ ### Zone Config Properties
415
+
416
+ | Config Key | Type | Properties |
417
+ |---|---|---|
418
+ | `emitZone` | object or array | `{ type: 'random', source: <shape> }` |
419
+ | | | `{ type: 'edge', source: <shape>, quantity, stepRate, yoyo, seamless, total }` |
420
+ | `deathZone` | object or array | `{ type: 'onEnter'\|'onLeave', source: <shape> }` |
421
+ | `bounds` | object | `{ x, y, width, height }` or `{ x, y, w, h }` |
422
+
423
+ ## Events
424
+
425
+ All events are emitted on the `ParticleEmitter` instance itself.
426
+
427
+ | Event | String | Callback Args | When |
428
+ |---|---|---|---|
429
+ | `START` | `'start'` | `(emitter)` | `start()` is called and emitter begins emitting |
430
+ | `STOP` | `'stop'` | `(emitter)` | `stop()` is called, or duration/stopAfter limit reached |
431
+ | `COMPLETE` | `'complete'` | `(emitter)` | Final alive particle dies after emitter has stopped |
432
+ | `EXPLODE` | `'explode'` | `(emitter, particle)` | `explode()` is called |
433
+ | `DEATH_ZONE` | `'deathzone'` | `(emitter, particle, zone)` | A death zone kills a particle |
434
+
435
+ ```js
436
+ emitter.on('stop', (emitter) => { /* stopped emitting */ });
437
+ emitter.on('complete', (emitter) => { /* all particles dead */ });
438
+ emitter.on('deathzone', (emitter, particle, zone) => { /* ... */ });
439
+ ```
440
+
441
+ ## API Quick Reference
442
+
443
+ ### ParticleEmitter Key Methods
444
+
445
+ **Lifecycle:** `start(advance?, duration?)`, `stop(kill?)`, `pause()`, `resume()`, `flow(frequency, count?, stopAfter?)`, `explode(count?, x?, y?)`, `emitParticleAt(x?, y?, count?)`, `emitParticle(count?, x?, y?)`, `fastForward(time, delta?)`.
446
+
447
+ **Config:** `setConfig(config)`, `updateConfig(config)`.
448
+
449
+ **Following:** `startFollow(target, offX?, offY?, trackVisible?)`, `stopFollow()`.
450
+
451
+ **Zones:** `addEmitZone(config)`, `removeEmitZone(zone)`, `clearEmitZones()`, `addDeathZone(config)`, `removeDeathZone(zone)`, `clearDeathZones()`.
452
+
453
+ **Processors:** `createGravityWell(config)`, `addParticleProcessor(processor)`, `removeParticleProcessor(processor)`, `getProcessors()`.
454
+
455
+ **Bounds:** `addParticleBounds(x, y, w, h, collideL?, collideR?, collideT?, collideB?)`.
456
+
457
+ **Callbacks/Iteration:** `onParticleEmit(cb, ctx?)`, `onParticleDeath(cb, ctx?)`, `killAll()`, `forEachAlive(cb, ctx?)`, `forEachDead(cb, ctx?)`.
458
+
459
+ **Counts:** `getAliveParticleCount()`, `getDeadParticleCount()`, `getParticleCount()`, `atLimit()`, `reserve(count)`.
460
+
461
+ **Property setters:** `setParticleSpeed(x, y?)`, `setParticleScale(x, y?)`, `setParticleGravity(x, y)`, `setParticleAlpha(value)`, `setParticleTint(value)`, `setParticleLifespan(value)`, `setEmitterAngle(value)`, `setQuantity(qty)`, `setFrequency(freq, qty?)`, `setRadial(value)`, `setEmitterFrame(frames, random?, qty?)`, `setAnim(anims, random?, qty?)`.
462
+
463
+ **Sorting:** `setSortProperty(property, ascending?)`, `setSortCallback(callback)`, `depthSort()`.
464
+
465
+ **Utility:** `getBounds(padding?, advance?, delta?, output?)`, `overlap(target)`.
466
+
467
+ ### GravityWell
468
+
469
+ | Property/Method | Description |
470
+ |---|---|
471
+ | `x`, `y` | World position of the well |
472
+ | `power` | Force strength (negative to repel) |
473
+ | `epsilon` | Min distance for force calc (default 100) |
474
+ | `gravity` | Gravitational constant (default 50) |
475
+ | `active` | Enable/disable processing (inherited from ParticleProcessor) |
476
+
477
+ **Constructor:** `new GravityWell(x, y, power, epsilon, gravity)` or `new GravityWell(config)` where config is `{ x, y, power, epsilon, gravity }`.
478
+
479
+ ## Gotchas
480
+
481
+ - **No ParticleEmitterManager:** Removed in v3.60. `this.add.particles()` returns a `ParticleEmitter` directly.
482
+ - **`speed` vs `speedX`/`speedY`:** `speed` sets speedX and deactivates speedY (radial). `speedX`/`speedY` switches to point mode (`radial: false`).
483
+ - **`scale` vs `scaleX`/`scaleY`:** `scale` applies to scaleX and deactivates scaleY. Use both for non-uniform scaling.
484
+ - **`color` overrides `tint`:** They are mutually exclusive; `color` (array) takes priority.
485
+ - **`moveToX`/`moveToY`:** Both must be set to activate. Overrides `angle` and `speed`.
486
+ - **`emitting` vs `active`:** `emitting: false` = no new particles but alive ones update. `active: false` = entire emitter frozen.
487
+ - **`stop` vs `complete`:** `'stop'` fires when emission stops. `'complete'` fires when the last alive particle dies.
488
+ - **`frequency: 0`:** Means emit every frame (max rate), not "never." Use `emitting: false` to prevent emission.
489
+ - **`frequency: -1`:** Puts the emitter in explode mode -- it will not flow automatically. Use `explode()` to emit bursts.
490
+ - **`hold` freezes particle:** After lifespan expires, `hold` keeps the particle visible and frozen for the specified ms before it dies. Useful for trail/lingering effects.
491
+ - **`advance` fast-forwards:** Pre-warms the emitter by simulating the given ms on creation, so particles are already visible on the first frame.
492
+ - **`reserve(count)` pre-allocates:** Call `reserve()` or set `reserve` in config to pre-create particle objects upfront, avoiding GC spikes during gameplay from on-demand allocation.
493
+ - **Zone source methods:** RandomZone needs `getRandomPoint(point)`. EdgeZone needs `getPoints(quantity, stepRate)`. DeathZone needs `contains(x, y)`.
494
+ - **Particle pool:** `maxParticles` limits total objects (not alive count). Use `maxAliveParticles` for visible limit.
495
+ - **Texture required:** The emitter needs a valid texture key. Use `frame` config for multi-frame textures.
496
+
497
+ ## Source Files
498
+
499
+ See `references/REFERENCE.md` for the full source file map. Key entry points: `src/gameobjects/particles/ParticleEmitter.js` (main class), `src/gameobjects/particles/Particle.js` (individual particle), `src/gameobjects/particles/zones/` (zone classes).
@@ -0,0 +1,17 @@
1
+ # Particle System -- Reference
2
+
3
+ ## Source File Map
4
+
5
+ | File | Purpose |
6
+ |---|---|
7
+ | `src/gameobjects/particles/ParticleEmitter.js` | Main emitter class -- config parsing, all methods |
8
+ | `src/gameobjects/particles/ParticleEmitterFactory.js` | `this.add.particles()` factory |
9
+ | `src/gameobjects/particles/Particle.js` | Individual particle: fire, update, death logic |
10
+ | `src/gameobjects/particles/GravityWell.js` | Gravity well processor |
11
+ | `src/gameobjects/particles/ParticleProcessor.js` | Base class for processors |
12
+ | `src/gameobjects/particles/ParticleBounds.js` | Rectangular bounds processor |
13
+ | `src/gameobjects/particles/EmitterOp.js` | EmitterOp value formats (start/end, random, stepped) |
14
+ | `src/gameobjects/particles/EmitterColorOp.js` | Color interpolation op |
15
+ | `src/gameobjects/particles/zones/` | RandomZone, EdgeZone, DeathZone |
16
+ | `src/gameobjects/particles/events/` | COMPLETE, DEATH_ZONE, EXPLODE, START, STOP |
17
+ | `src/gameobjects/particles/typedefs/ParticleEmitterConfig.js` | Full config typedef |