@celljs/ta 4.9.1 → 4.11.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 (673) hide show
  1. package/README.en.md +3 -1
  2. package/README.md +3 -1
  3. package/dist/cli.mjs +1753 -75
  4. package/dist/gateway.mjs +311 -25
  5. package/dist/pi/CHANGELOG.md +30 -0
  6. package/dist/pi/dist/bundle/chunks/anthropic-messages-CA3HHOL3.js +6 -0
  7. package/dist/pi/dist/bundle/chunks/{azure-openai-responses-FSC6BAW3.js → azure-openai-responses-76TWS6DT.js} +1 -1
  8. package/dist/pi/dist/bundle/chunks/bedrock-converse-stream.js +3 -3
  9. package/dist/pi/dist/bundle/chunks/chunk-4KSTFUIK.js +19 -0
  10. package/dist/pi/dist/bundle/chunks/chunk-4UNPP53I.js +55 -0
  11. package/dist/pi/dist/bundle/chunks/chunk-AUUCDC7R.js +4 -0
  12. package/dist/pi/dist/bundle/chunks/{chunk-V6KH5QG4.js → chunk-BAC3QPNW.js} +1 -1
  13. package/dist/pi/dist/bundle/chunks/{chunk-4EYXVSA5.js → chunk-FF6XOTWB.js} +9 -9
  14. package/dist/pi/dist/bundle/chunks/chunk-FMPAMX2W.js +82 -0
  15. package/dist/pi/dist/bundle/chunks/chunk-GFUN2N5K.js +2 -0
  16. package/dist/pi/dist/bundle/chunks/chunk-IEBK4HQA.js +2 -0
  17. package/dist/pi/dist/bundle/chunks/{chunk-C2WU32PX.js → chunk-IQUU5XIT.js} +1 -1
  18. package/dist/pi/dist/bundle/chunks/{chunk-EBFHJFEE.js → chunk-LQLJ7CDW.js} +1 -1
  19. package/dist/pi/dist/bundle/chunks/chunk-MMDXLZVS.js +30 -0
  20. package/dist/pi/dist/bundle/chunks/{chunk-GN3QYODH.js → chunk-QN4TOIZN.js} +1 -1
  21. package/dist/pi/dist/bundle/chunks/chunk-RKNK4Y6L.js +2 -0
  22. package/dist/pi/dist/bundle/chunks/{chunk-B46VJEHW.js → chunk-V7SLUK6A.js} +1 -1
  23. package/dist/pi/dist/bundle/chunks/chunk-VEJDBY3O.js +1237 -0
  24. package/dist/pi/dist/bundle/chunks/chunk-VKJQ6CME.js +8 -0
  25. package/dist/pi/dist/bundle/chunks/{chunk-3TGLJEWK.js → chunk-WL4TUXY7.js} +1 -1
  26. package/dist/pi/dist/bundle/chunks/{chunk-YZKQS34S.js → chunk-Y55SJART.js} +5 -1
  27. package/dist/pi/dist/bundle/chunks/{chunk-EOO47QGR.js → chunk-ZBIZYD6W.js} +1 -1
  28. package/dist/pi/dist/bundle/chunks/chunk-ZG74NES2.js +2 -0
  29. package/dist/pi/dist/bundle/chunks/chunk-ZGYS4UTC.js +2 -0
  30. package/dist/pi/dist/bundle/chunks/{cli-MCOUW5WS.js → cli-7RHMDOHL.js} +7 -7
  31. package/dist/pi/dist/bundle/chunks/{cloudflare-workers-ai-system-one-WLAFJSP6.js → cloudflare-workers-ai-system-one-U4J7D646.js} +1 -1
  32. package/dist/pi/dist/bundle/chunks/codemode-worker.js +2 -0
  33. package/dist/pi/dist/bundle/chunks/{easter-egg-3d-WMBNSJ4M.js → easter-egg-3d-GEVPKQF6.js} +1 -1
  34. package/dist/pi/dist/bundle/chunks/{execute-4CEBORGZ.js → execute-L2EEDV3L.js} +5 -3
  35. package/dist/pi/dist/bundle/chunks/github-copilot.js +1 -1
  36. package/dist/pi/dist/bundle/chunks/{google-generative-ai-INGKNW72.js → google-generative-ai-D5B6W47J.js} +1 -1
  37. package/dist/pi/dist/bundle/chunks/{google-vertex-IBTX6MBF.js → google-vertex-U4H5YDEW.js} +1 -1
  38. package/dist/pi/dist/bundle/chunks/{llama-cpp-classify-V5U3QKXI.js → llama-cpp-classify-EJXCQRUQ.js} +1 -1
  39. package/dist/pi/dist/bundle/chunks/{mistral-conversations-S4OWXIXQ.js → mistral-conversations-S277EKLB.js} +1 -1
  40. package/dist/pi/dist/bundle/chunks/openai-codex-responses-TEQRB65N.js +10 -0
  41. package/dist/pi/dist/bundle/chunks/{openai-completions-EJNYB6IX.js → openai-completions-HRZOSLBO.js} +3 -3
  42. package/dist/pi/dist/bundle/chunks/{openai-decisions-IXI34BYG.js → openai-decisions-F66BDLOM.js} +1 -1
  43. package/dist/pi/dist/bundle/chunks/openai-responses-BAKFWTGE.js +4 -0
  44. package/dist/pi/dist/bundle/chunks/{openrouter-images-PISKSFMS.js → openrouter-images-VXF5TVIK.js} +1 -1
  45. package/dist/pi/dist/bundle/chunks/{pi-messages-NORUKF4E.js → pi-messages-UBJKNDRN.js} +1 -1
  46. package/dist/pi/dist/bundle/chunks/{runtime-FQB7RU7U.js → runtime-J5ZSBGTX.js} +1 -1
  47. package/dist/pi/dist/bundle/chunks/{typesafe-system-one-CHVC2UUI.js → typesafe-system-one-56TEMIHL.js} +1 -1
  48. package/dist/pi/dist/bundle/chunks/virtual-modules-KITQRTYM.js +2 -0
  49. package/dist/pi/dist/bundle/cli-runtime.js +1 -1
  50. package/dist/pi/dist/bundle/index.js +1 -1
  51. package/dist/pi/dist/bundle/rpc-entry.js +1 -1
  52. package/dist/pi/docs/cli.md +14 -1
  53. package/dist/pi/docs/extensions.md +27 -7
  54. package/dist/pi/docs/keybindings.md +1 -1
  55. package/dist/pi/docs/llama-cpp.md +5 -8
  56. package/dist/pi/docs/models-configuration.md +6 -1
  57. package/dist/pi/docs/models.md +2 -1
  58. package/dist/pi/docs/prompt-templates.md +1 -1
  59. package/dist/pi/docs/providers.md +1 -1
  60. package/dist/pi/docs/rpc.md +4 -2
  61. package/dist/pi/docs/sessions.md +7 -1
  62. package/dist/pi/docs/settings.md +1 -1
  63. package/dist/pi/docs/tui.md +1 -1
  64. package/dist/pi/examples/extensions/custom-provider-anthropic/package-lock.json +2 -2
  65. package/dist/pi/examples/extensions/custom-provider-anthropic/package.json +1 -1
  66. package/dist/pi/examples/extensions/custom-provider-gitlab-duo/package.json +1 -1
  67. package/dist/pi/examples/extensions/gondolin/package-lock.json +2 -2
  68. package/dist/pi/examples/extensions/gondolin/package.json +1 -1
  69. package/dist/pi/examples/extensions/plan-mode/index.ts +23 -13
  70. package/dist/pi/examples/extensions/plan-mode/utils.ts +42 -16
  71. package/dist/pi/examples/extensions/subagent/README.md +14 -11
  72. package/dist/pi/examples/extensions/subagent/index.ts +392 -171
  73. package/dist/pi/examples/extensions/with-deps/package-lock.json +2 -2
  74. package/dist/pi/examples/extensions/with-deps/package.json +1 -1
  75. package/dist/pi/examples/tsconfig.json +63 -35
  76. package/dist/pi/package.json +1 -1
  77. package/dist/pi/packages/ta-agents/extension/index.mjs +185 -140
  78. package/dist/pi/packages/ta-agents/lib/acp-agent.js +30 -10
  79. package/dist/pi/packages/ta-agents/lib/agent-bindings.d.ts +2 -0
  80. package/dist/pi/packages/ta-agents/lib/agent-bindings.js +4 -0
  81. package/dist/pi/packages/ta-agents/lib/agent-catalog.d.ts +2 -2
  82. package/dist/pi/packages/ta-agents/lib/agent-catalog.js +4 -4
  83. package/dist/pi/packages/ta-agents/lib/agent-prompt.d.ts +6 -0
  84. package/dist/pi/packages/ta-agents/lib/agent-prompt.js +19 -0
  85. package/dist/pi/packages/ta-agents/lib/agent-session.d.ts +2 -0
  86. package/dist/pi/packages/ta-agents/lib/agent-session.js +2 -0
  87. package/dist/pi/packages/ta-agents/lib/agent-streamer.js +7 -0
  88. package/dist/pi/packages/ta-agents/lib/agent-tool.js +3 -2
  89. package/dist/pi/packages/ta-agents/lib/extension.js +15 -1
  90. package/dist/pi/packages/ta-agents/lib/texts.d.ts +4 -0
  91. package/dist/pi/packages/ta-agents/lib/texts.js +4 -0
  92. package/dist/pi/packages/ta-agents/package.json +3 -3
  93. package/dist/pi/packages/ta-bots/extension/index.mjs +31 -253
  94. package/dist/pi/packages/ta-bots/host/index.mjs +189 -1
  95. package/dist/pi/packages/ta-bots/lib/bots-protocol.d.ts +2 -0
  96. package/dist/pi/packages/ta-bots/lib/bots-protocol.js +3 -1
  97. package/dist/pi/packages/ta-bots/lib/bots-view.js +24 -12
  98. package/dist/pi/packages/ta-bots/lib/composer.js +1 -0
  99. package/dist/pi/packages/ta-bots/lib/extension.js +10 -17
  100. package/dist/pi/packages/ta-bots/lib/i18n.d.ts +1 -0
  101. package/dist/pi/packages/ta-bots/lib/i18n.js +2 -0
  102. package/dist/pi/packages/ta-bots/lib/index.js +2 -0
  103. package/dist/pi/packages/ta-bots/lib/style.d.ts +1 -1
  104. package/dist/pi/packages/ta-bots/lib/style.js +1 -0
  105. package/dist/pi/packages/ta-bots/lib/text-util.js +8 -1
  106. package/dist/pi/packages/ta-bots/lib/tool-line.d.ts +8 -0
  107. package/dist/pi/packages/ta-bots/lib/tool-line.js +19 -0
  108. package/dist/pi/packages/ta-bots/package.json +1 -1
  109. package/dist/pi/packages/ta-bots/web/index.js +47 -16
  110. package/dist/pi/packages/ta-changes/extension/index.mjs +23 -13
  111. package/dist/pi/packages/ta-changes/lib/card.js +18 -4
  112. package/dist/pi/packages/ta-changes/lib/changes-protocol.d.ts +0 -4
  113. package/dist/pi/packages/ta-changes/lib/changes-protocol.js +1 -5
  114. package/dist/pi/packages/ta-changes/lib/extension.js +5 -13
  115. package/dist/pi/packages/ta-changes/package.json +1 -1
  116. package/dist/pi/packages/ta-changes/web/index.js +16 -3
  117. package/dist/pi/packages/ta-channels/README.en.md +6 -5
  118. package/dist/pi/packages/ta-channels/README.md +6 -5
  119. package/dist/pi/packages/ta-channels/extension/index.mjs +350 -28
  120. package/dist/pi/packages/ta-channels/host/index.mjs +638 -43
  121. package/dist/pi/packages/ta-channels/lib/agent-cards.d.ts +19 -0
  122. package/dist/pi/packages/ta-channels/lib/agent-cards.js +58 -0
  123. package/dist/pi/packages/ta-channels/lib/agent-menu.d.ts +2 -2
  124. package/dist/pi/packages/ta-channels/lib/agent-menu.js +20 -6
  125. package/dist/pi/packages/ta-channels/lib/card.d.ts +27 -0
  126. package/dist/pi/packages/ta-channels/lib/card.js +178 -0
  127. package/dist/pi/packages/ta-channels/lib/channels-model.d.ts +65 -13
  128. package/dist/pi/packages/ta-channels/lib/channels-model.js +15 -6
  129. package/dist/pi/packages/ta-channels/lib/channels-util.d.ts +31 -2
  130. package/dist/pi/packages/ta-channels/lib/channels-util.js +100 -6
  131. package/dist/pi/packages/ta-channels/lib/channels.d.ts +28 -18
  132. package/dist/pi/packages/ta-channels/lib/channels.js +65 -65
  133. package/dist/pi/packages/ta-channels/lib/create.js +14 -4
  134. package/dist/pi/packages/ta-channels/lib/extension.d.ts +8 -0
  135. package/dist/pi/packages/ta-channels/lib/extension.js +104 -18
  136. package/dist/pi/packages/ta-channels/lib/faces.d.ts +2 -0
  137. package/dist/pi/packages/ta-channels/lib/faces.js +7 -1
  138. package/dist/pi/packages/ta-channels/lib/handoff-view.d.ts +19 -0
  139. package/dist/pi/packages/ta-channels/lib/handoff-view.js +113 -0
  140. package/dist/pi/packages/ta-channels/lib/handoff.d.ts +67 -0
  141. package/dist/pi/packages/ta-channels/lib/handoff.js +114 -0
  142. package/dist/pi/packages/ta-channels/lib/host.d.ts +1 -1
  143. package/dist/pi/packages/ta-channels/lib/host.js +1 -1
  144. package/dist/pi/packages/ta-channels/lib/i18n.d.ts +49 -8
  145. package/dist/pi/packages/ta-channels/lib/i18n.js +98 -16
  146. package/dist/pi/packages/ta-channels/lib/index.js +10 -1
  147. package/dist/pi/packages/ta-channels/lib/member-tools.d.ts +23 -0
  148. package/dist/pi/packages/ta-channels/lib/member-tools.js +56 -0
  149. package/dist/pi/packages/ta-channels/lib/members.js +6 -2
  150. package/dist/pi/packages/ta-channels/lib/more-menu.d.ts +3 -2
  151. package/dist/pi/packages/ta-channels/lib/more-menu.js +21 -29
  152. package/dist/pi/packages/ta-channels/lib/notice.d.ts +25 -0
  153. package/dist/pi/packages/ta-channels/lib/notice.js +101 -0
  154. package/dist/pi/packages/ta-channels/lib/room.js +26 -10
  155. package/dist/pi/packages/ta-channels/lib/sidebar.d.ts +1 -6
  156. package/dist/pi/packages/ta-channels/lib/sidebar.js +257 -84
  157. package/dist/pi/packages/ta-channels/lib/style.d.ts +1 -1
  158. package/dist/pi/packages/ta-channels/lib/style.js +151 -40
  159. package/dist/pi/packages/ta-channels/lib/tasks.js +3 -4
  160. package/dist/pi/packages/ta-channels/lib/team.d.ts +58 -10
  161. package/dist/pi/packages/ta-channels/lib/team.js +159 -38
  162. package/dist/pi/packages/ta-channels/lib/tool-lines.d.ts +22 -0
  163. package/dist/pi/packages/ta-channels/lib/tool-lines.js +113 -0
  164. package/dist/pi/packages/ta-channels/lib/views.d.ts +54 -1
  165. package/dist/pi/packages/ta-channels/lib/views.js +129 -1
  166. package/dist/pi/packages/ta-channels/package.json +2 -1
  167. package/dist/pi/packages/ta-channels/web/index.js +1792 -439
  168. package/dist/pi/packages/ta-computer-use/package.json +7 -2
  169. package/dist/pi/packages/ta-cron/README.en.md +6 -4
  170. package/dist/pi/packages/ta-cron/README.md +6 -4
  171. package/dist/pi/packages/ta-cron/extension/index.mjs +416 -44
  172. package/dist/pi/packages/ta-cron/host/index.mjs +30 -3
  173. package/dist/pi/packages/ta-cron/lib/chat-task.d.ts +48 -0
  174. package/dist/pi/packages/ta-cron/lib/chat-task.js +133 -0
  175. package/dist/pi/packages/ta-cron/lib/commands.d.ts +2 -1
  176. package/dist/pi/packages/ta-cron/lib/commands.js +10 -4
  177. package/dist/pi/packages/ta-cron/lib/composer.d.ts +11 -0
  178. package/dist/pi/packages/ta-cron/lib/composer.js +58 -0
  179. package/dist/pi/packages/ta-cron/lib/cron-protocol.d.ts +10 -3
  180. package/dist/pi/packages/ta-cron/lib/cron-protocol.js +6 -3
  181. package/dist/pi/packages/ta-cron/lib/editor.js +65 -30
  182. package/dist/pi/packages/ta-cron/lib/extension.d.ts +2 -0
  183. package/dist/pi/packages/ta-cron/lib/extension.js +33 -13
  184. package/dist/pi/packages/ta-cron/lib/i18n.d.ts +30 -1
  185. package/dist/pi/packages/ta-cron/lib/i18n.js +60 -2
  186. package/dist/pi/packages/ta-cron/lib/index.js +4 -0
  187. package/dist/pi/packages/ta-cron/lib/page.d.ts +38 -4
  188. package/dist/pi/packages/ta-cron/lib/page.js +131 -4
  189. package/dist/pi/packages/ta-cron/lib/react.d.ts +3 -0
  190. package/dist/pi/packages/ta-cron/lib/react.js +8 -0
  191. package/dist/pi/packages/ta-cron/lib/scheduler.js +3 -2
  192. package/dist/pi/packages/ta-cron/lib/style.d.ts +1 -1
  193. package/dist/pi/packages/ta-cron/lib/style.js +168 -50
  194. package/dist/pi/packages/ta-cron/lib/task-extension.d.ts +15 -0
  195. package/dist/pi/packages/ta-cron/lib/task-extension.js +56 -0
  196. package/dist/pi/packages/ta-cron/lib/task-util.d.ts +4 -0
  197. package/dist/pi/packages/ta-cron/lib/task-util.js +31 -1
  198. package/dist/pi/packages/ta-cron/lib/tasks-view.d.ts +4 -1
  199. package/dist/pi/packages/ta-cron/lib/tasks-view.js +107 -67
  200. package/dist/pi/packages/ta-cron/lib/tool-line.d.ts +9 -0
  201. package/dist/pi/packages/ta-cron/lib/tool-line.js +40 -0
  202. package/dist/pi/packages/ta-cron/lib/tool.d.ts +5 -1
  203. package/dist/pi/packages/ta-cron/lib/tool.js +6 -3
  204. package/dist/pi/packages/ta-cron/package.json +12 -1
  205. package/dist/pi/packages/ta-cron/web/index.js +1346 -415
  206. package/dist/pi/packages/ta-extensions/README.en.md +4 -2
  207. package/dist/pi/packages/ta-extensions/README.md +4 -2
  208. package/dist/pi/packages/ta-extensions/host/index.mjs +3 -2
  209. package/dist/pi/packages/ta-extensions/lib/actions.d.ts +4 -0
  210. package/dist/pi/packages/ta-extensions/lib/actions.js +16 -5
  211. package/dist/pi/packages/ta-extensions/lib/composer.d.ts +17 -0
  212. package/dist/pi/packages/ta-extensions/lib/composer.js +84 -0
  213. package/dist/pi/packages/ta-extensions/lib/extensions-util.d.ts +5 -0
  214. package/dist/pi/packages/ta-extensions/lib/extensions-util.js +10 -0
  215. package/dist/pi/packages/ta-extensions/lib/i18n.d.ts +9 -0
  216. package/dist/pi/packages/ta-extensions/lib/i18n.js +18 -0
  217. package/dist/pi/packages/ta-extensions/lib/index.js +4 -0
  218. package/dist/pi/packages/ta-extensions/lib/make-model.d.ts +20 -0
  219. package/dist/pi/packages/ta-extensions/lib/make-model.js +43 -0
  220. package/dist/pi/packages/ta-extensions/lib/market-parts.js +8 -2
  221. package/dist/pi/packages/ta-extensions/lib/market-style.d.ts +1 -1
  222. package/dist/pi/packages/ta-extensions/lib/market-style.js +4 -5
  223. package/dist/pi/packages/ta-extensions/lib/market-util.d.ts +2 -2
  224. package/dist/pi/packages/ta-extensions/lib/market-util.js +2 -2
  225. package/dist/pi/packages/ta-extensions/lib/page.js +52 -23
  226. package/dist/pi/packages/ta-extensions/lib/react.d.ts +3 -0
  227. package/dist/pi/packages/ta-extensions/lib/react.js +8 -0
  228. package/dist/pi/packages/ta-extensions/lib/settings.d.ts +4 -0
  229. package/dist/pi/packages/ta-extensions/lib/settings.js +44 -0
  230. package/dist/pi/packages/ta-extensions/lib/style.d.ts +1 -1
  231. package/dist/pi/packages/ta-extensions/lib/style.js +13 -6
  232. package/dist/pi/packages/ta-extensions/package.json +6 -1
  233. package/dist/pi/packages/ta-extensions/skills/ta-package/SKILL.md +25 -10
  234. package/dist/pi/packages/ta-extensions/web/index.js +459 -47
  235. package/dist/pi/packages/ta-games/README.en.md +47 -0
  236. package/dist/pi/packages/ta-games/README.md +47 -0
  237. package/dist/pi/packages/ta-games/host/index.mjs +65 -0
  238. package/dist/pi/packages/ta-games/lib/games-view.d.ts +16 -0
  239. package/dist/pi/packages/ta-games/lib/games-view.js +77 -0
  240. package/dist/pi/packages/ta-games/lib/host.d.ts +36 -0
  241. package/dist/pi/packages/ta-games/lib/host.js +83 -0
  242. package/dist/pi/packages/ta-games/lib/i18n.d.ts +35 -0
  243. package/dist/pi/packages/ta-games/lib/i18n.js +71 -0
  244. package/dist/pi/packages/ta-games/lib/ideas.d.ts +6 -0
  245. package/dist/pi/packages/ta-games/lib/ideas.js +62 -0
  246. package/dist/pi/packages/ta-games/lib/index.d.ts +7 -0
  247. package/dist/pi/packages/ta-games/lib/index.js +24 -0
  248. package/dist/pi/packages/ta-games/lib/make-game.d.ts +23 -0
  249. package/dist/pi/packages/ta-games/lib/make-game.js +67 -0
  250. package/dist/pi/packages/ta-games/lib/react.d.ts +11 -0
  251. package/dist/pi/packages/ta-games/lib/react.js +16 -0
  252. package/dist/pi/packages/ta-games/lib/style.d.ts +4 -0
  253. package/dist/pi/packages/ta-games/lib/style.js +33 -0
  254. package/dist/pi/packages/ta-games/package.json +60 -0
  255. package/dist/pi/packages/ta-games/skills/ta-game/SKILL.md +127 -0
  256. package/dist/pi/packages/ta-games/skills/ta-game/examples/dino-run/package.json +22 -0
  257. package/dist/pi/packages/ta-games/skills/ta-game/examples/dino-run/web.js +389 -0
  258. package/dist/pi/packages/ta-games/skills/ta-game/examples/stack/package.json +22 -0
  259. package/dist/pi/packages/ta-games/skills/ta-game/examples/stack/web.js +423 -0
  260. package/dist/pi/packages/ta-games/skills/ta-game/phaser/LICENSE.md +22 -0
  261. package/dist/pi/packages/ta-games/skills/ta-game/phaser/actions-and-utilities/SKILL.md +343 -0
  262. package/dist/pi/packages/ta-games/skills/ta-game/phaser/animations/SKILL.md +481 -0
  263. package/dist/pi/packages/ta-games/skills/ta-game/phaser/audio-and-sound/SKILL.md +453 -0
  264. package/dist/pi/packages/ta-games/skills/ta-game/phaser/cameras/SKILL.md +497 -0
  265. package/dist/pi/packages/ta-games/skills/ta-game/phaser/cameras/references/REFERENCE.md +128 -0
  266. package/dist/pi/packages/ta-games/skills/ta-game/phaser/curves-and-paths/SKILL.md +359 -0
  267. package/dist/pi/packages/ta-games/skills/ta-game/phaser/data-manager/SKILL.md +406 -0
  268. package/dist/pi/packages/ta-games/skills/ta-game/phaser/events-system/SKILL.md +497 -0
  269. package/dist/pi/packages/ta-games/skills/ta-game/phaser/filters-and-postfx/SKILL.md +449 -0
  270. package/dist/pi/packages/ta-games/skills/ta-game/phaser/game-object-components/SKILL.md +478 -0
  271. package/dist/pi/packages/ta-games/skills/ta-game/phaser/game-object-components/references/REFERENCE.md +76 -0
  272. package/dist/pi/packages/ta-games/skills/ta-game/phaser/game-setup-and-config/SKILL.md +485 -0
  273. package/dist/pi/packages/ta-games/skills/ta-game/phaser/geometry-and-math/SKILL.md +497 -0
  274. package/dist/pi/packages/ta-games/skills/ta-game/phaser/graphics-and-shapes/SKILL.md +473 -0
  275. package/dist/pi/packages/ta-games/skills/ta-game/phaser/groups-and-containers/SKILL.md +418 -0
  276. package/dist/pi/packages/ta-games/skills/ta-game/phaser/input-keyboard-mouse-touch/SKILL.md +500 -0
  277. package/dist/pi/packages/ta-games/skills/ta-game/phaser/input-keyboard-mouse-touch/references/REFERENCE.md +372 -0
  278. package/dist/pi/packages/ta-games/skills/ta-game/phaser/loading-assets/SKILL.md +474 -0
  279. package/dist/pi/packages/ta-games/skills/ta-game/phaser/loading-assets/references/REFERENCE.md +148 -0
  280. package/dist/pi/packages/ta-games/skills/ta-game/phaser/particles/SKILL.md +499 -0
  281. package/dist/pi/packages/ta-games/skills/ta-game/phaser/particles/references/REFERENCE.md +17 -0
  282. package/dist/pi/packages/ta-games/skills/ta-game/phaser/physics-arcade/SKILL.md +468 -0
  283. package/dist/pi/packages/ta-games/skills/ta-game/phaser/physics-matter/SKILL.md +499 -0
  284. package/dist/pi/packages/ta-games/skills/ta-game/phaser/render-textures/SKILL.md +441 -0
  285. package/dist/pi/packages/ta-games/skills/ta-game/phaser/scale-and-responsive/SKILL.md +371 -0
  286. package/dist/pi/packages/ta-games/skills/ta-game/phaser/scenes/SKILL.md +450 -0
  287. package/dist/pi/packages/ta-games/skills/ta-game/phaser/scenes/references/REFERENCE.md +78 -0
  288. package/dist/pi/packages/ta-games/skills/ta-game/phaser/sprites-and-images/SKILL.md +417 -0
  289. package/dist/pi/packages/ta-games/skills/ta-game/phaser/sprites-and-images/references/REFERENCE.md +160 -0
  290. package/dist/pi/packages/ta-games/skills/ta-game/phaser/text-and-bitmaptext/SKILL.md +460 -0
  291. package/dist/pi/packages/ta-games/skills/ta-game/phaser/tilemaps/SKILL.md +440 -0
  292. package/dist/pi/packages/ta-games/skills/ta-game/phaser/time-and-timers/SKILL.md +496 -0
  293. package/dist/pi/packages/ta-games/skills/ta-game/phaser/tweens/SKILL.md +414 -0
  294. package/dist/pi/packages/ta-games/skills/ta-game/phaser/v3-to-v4-migration/SKILL.md +430 -0
  295. package/dist/pi/packages/ta-games/skills/ta-game/phaser/v4-new-features/SKILL.md +384 -0
  296. package/dist/pi/packages/ta-games/skills/ta-game/phaser/v4-new-features/references/REFERENCE.md +69 -0
  297. package/dist/pi/packages/ta-games/web/index.js +431 -0
  298. package/dist/pi/packages/ta-glance/README.en.md +11 -0
  299. package/dist/pi/packages/ta-glance/README.md +11 -0
  300. package/dist/pi/packages/ta-glance/extension/index.mjs +67 -0
  301. package/dist/pi/packages/ta-glance/lib/card.d.ts +8 -0
  302. package/dist/pi/packages/ta-glance/lib/card.js +268 -0
  303. package/dist/pi/packages/ta-glance/lib/extension.d.ts +15 -0
  304. package/dist/pi/packages/ta-glance/lib/extension.js +24 -0
  305. package/dist/pi/packages/ta-glance/lib/glance-json.d.ts +9 -0
  306. package/dist/pi/packages/ta-glance/lib/glance-json.js +85 -0
  307. package/dist/pi/packages/ta-glance/lib/glance-prompt.d.ts +7 -0
  308. package/dist/pi/packages/ta-glance/lib/glance-prompt.js +34 -0
  309. package/dist/pi/packages/ta-glance/lib/glance-protocol.d.ts +98 -0
  310. package/dist/pi/packages/ta-glance/lib/glance-protocol.js +8 -0
  311. package/dist/pi/packages/ta-glance/lib/glance-spec.d.ts +6 -0
  312. package/dist/pi/packages/ta-glance/lib/glance-spec.js +204 -0
  313. package/dist/pi/packages/ta-glance/lib/glance-util.d.ts +3 -0
  314. package/dist/pi/packages/ta-glance/lib/glance-util.js +12 -0
  315. package/dist/pi/packages/ta-glance/lib/i18n.d.ts +22 -0
  316. package/dist/pi/packages/ta-glance/lib/i18n.js +41 -0
  317. package/dist/pi/packages/ta-glance/lib/index.d.ts +7 -0
  318. package/dist/pi/packages/ta-glance/lib/index.js +22 -0
  319. package/dist/pi/packages/ta-glance/lib/react.d.ts +8 -0
  320. package/dist/pi/packages/ta-glance/lib/react.js +8 -0
  321. package/dist/pi/packages/ta-glance/lib/style.d.ts +4 -0
  322. package/dist/pi/packages/ta-glance/lib/style.js +164 -0
  323. package/dist/pi/packages/ta-glance/package.json +53 -0
  324. package/dist/pi/packages/ta-glance/web/index.js +933 -0
  325. package/dist/pi/packages/ta-launcher/lib/actions.d.ts +4 -4
  326. package/dist/pi/packages/ta-launcher/lib/actions.js +7 -3
  327. package/dist/pi/packages/ta-launcher/lib/launcher-util.d.ts +7 -7
  328. package/dist/pi/packages/ta-launcher/lib/launcher-util.js +11 -8
  329. package/dist/pi/packages/ta-launcher/lib/launcher-view.js +13 -7
  330. package/dist/pi/packages/ta-launcher/lib/react.d.ts +3 -0
  331. package/dist/pi/packages/ta-launcher/lib/react.js +8 -0
  332. package/dist/pi/packages/ta-launcher/lib/style.d.ts +1 -1
  333. package/dist/pi/packages/ta-launcher/lib/style.js +6 -4
  334. package/dist/pi/packages/ta-launcher/package.json +1 -1
  335. package/dist/pi/packages/ta-launcher/web/index.js +34 -17
  336. package/dist/pi/packages/ta-manual/README.en.md +10 -0
  337. package/dist/pi/packages/ta-manual/README.md +10 -0
  338. package/dist/pi/packages/ta-manual/lib/i18n.d.ts +15 -0
  339. package/dist/pi/packages/ta-manual/lib/i18n.js +31 -0
  340. package/dist/pi/packages/ta-manual/lib/index.d.ts +7 -0
  341. package/dist/pi/packages/ta-manual/lib/index.js +24 -0
  342. package/dist/pi/packages/ta-manual/lib/manual-util.d.ts +18 -0
  343. package/dist/pi/packages/ta-manual/lib/manual-util.js +40 -0
  344. package/dist/pi/packages/ta-manual/lib/manual-view.d.ts +9 -0
  345. package/dist/pi/packages/ta-manual/lib/manual-view.js +81 -0
  346. package/dist/pi/packages/ta-manual/lib/pictures-a.d.ts +2 -0
  347. package/dist/pi/packages/ta-manual/lib/pictures-a.js +263 -0
  348. package/dist/pi/packages/ta-manual/lib/pictures-b.d.ts +2 -0
  349. package/dist/pi/packages/ta-manual/lib/pictures-b.js +216 -0
  350. package/dist/pi/packages/ta-manual/lib/pictures.d.ts +9 -0
  351. package/dist/pi/packages/ta-manual/lib/pictures.js +16 -0
  352. package/dist/pi/packages/ta-manual/lib/react.d.ts +8 -0
  353. package/dist/pi/packages/ta-manual/lib/react.js +8 -0
  354. package/dist/pi/packages/ta-manual/lib/scene.d.ts +68 -0
  355. package/dist/pi/packages/ta-manual/lib/scene.js +115 -0
  356. package/dist/pi/packages/ta-manual/lib/style.d.ts +4 -0
  357. package/dist/pi/packages/ta-manual/lib/style.js +47 -0
  358. package/dist/pi/packages/ta-manual/lib/topics.d.ts +42 -0
  359. package/dist/pi/packages/ta-manual/lib/topics.js +354 -0
  360. package/dist/pi/packages/ta-manual/package.json +54 -0
  361. package/dist/pi/packages/ta-manual/skills/ta-manual/SKILL.md +119 -0
  362. package/dist/pi/packages/ta-manual/web/index.js +2223 -0
  363. package/dist/pi/packages/ta-notify/README.en.md +29 -0
  364. package/dist/pi/packages/ta-notify/README.md +29 -0
  365. package/dist/pi/packages/ta-notify/extension/index.mjs +259 -0
  366. package/dist/pi/packages/ta-notify/host/index.mjs +163 -0
  367. package/dist/pi/packages/ta-notify/lib/ask-card.d.ts +9 -0
  368. package/dist/pi/packages/ta-notify/lib/ask-card.js +40 -0
  369. package/dist/pi/packages/ta-notify/lib/extension.d.ts +24 -0
  370. package/dist/pi/packages/ta-notify/lib/extension.js +102 -0
  371. package/dist/pi/packages/ta-notify/lib/host.d.ts +4 -0
  372. package/dist/pi/packages/ta-notify/lib/host.js +9 -0
  373. package/dist/pi/packages/ta-notify/lib/i18n.d.ts +31 -0
  374. package/dist/pi/packages/ta-notify/lib/i18n.js +63 -0
  375. package/dist/pi/packages/ta-notify/lib/index.d.ts +8 -0
  376. package/dist/pi/packages/ta-notify/lib/index.js +29 -0
  377. package/dist/pi/packages/ta-notify/lib/notify-protocol.d.ts +74 -0
  378. package/dist/pi/packages/ta-notify/lib/notify-protocol.js +23 -0
  379. package/dist/pi/packages/ta-notify/lib/notify-service.d.ts +21 -0
  380. package/dist/pi/packages/ta-notify/lib/notify-service.js +75 -0
  381. package/dist/pi/packages/ta-notify/lib/notify-util.d.ts +39 -0
  382. package/dist/pi/packages/ta-notify/lib/notify-util.js +119 -0
  383. package/dist/pi/packages/ta-notify/lib/react.d.ts +8 -0
  384. package/dist/pi/packages/ta-notify/lib/react.js +8 -0
  385. package/dist/pi/packages/ta-notify/lib/server-texts.d.ts +9 -0
  386. package/dist/pi/packages/ta-notify/lib/server-texts.js +22 -0
  387. package/dist/pi/packages/ta-notify/lib/settings.d.ts +8 -0
  388. package/dist/pi/packages/ta-notify/lib/settings.js +85 -0
  389. package/dist/pi/packages/ta-notify/lib/style.d.ts +4 -0
  390. package/dist/pi/packages/ta-notify/lib/style.js +29 -0
  391. package/dist/pi/packages/ta-notify/lib/tool-line.d.ts +9 -0
  392. package/dist/pi/packages/ta-notify/lib/tool-line.js +20 -0
  393. package/dist/pi/packages/ta-notify/lib/tool.d.ts +37 -0
  394. package/dist/pi/packages/ta-notify/lib/tool.js +46 -0
  395. package/dist/pi/packages/ta-notify/lib/watcher.d.ts +15 -0
  396. package/dist/pi/packages/ta-notify/lib/watcher.js +81 -0
  397. package/dist/pi/packages/ta-notify/package.json +55 -0
  398. package/dist/pi/packages/ta-notify/web/index.js +436 -0
  399. package/dist/pi/packages/ta-recall/README.en.md +19 -0
  400. package/dist/pi/packages/ta-recall/README.md +19 -0
  401. package/dist/pi/packages/ta-recall/extension/index.mjs +614 -0
  402. package/dist/pi/packages/ta-recall/host/index.mjs +820 -0
  403. package/dist/pi/packages/ta-recall/lib/brief-card.d.ts +21 -0
  404. package/dist/pi/packages/ta-recall/lib/brief-card.js +67 -0
  405. package/dist/pi/packages/ta-recall/lib/brief-home.d.ts +49 -0
  406. package/dist/pi/packages/ta-recall/lib/brief-home.js +143 -0
  407. package/dist/pi/packages/ta-recall/lib/brief-seen.d.ts +9 -0
  408. package/dist/pi/packages/ta-recall/lib/brief-seen.js +26 -0
  409. package/dist/pi/packages/ta-recall/lib/brief-util.d.ts +64 -0
  410. package/dist/pi/packages/ta-recall/lib/brief-util.js +179 -0
  411. package/dist/pi/packages/ta-recall/lib/chat-icons.d.ts +8 -0
  412. package/dist/pi/packages/ta-recall/lib/chat-icons.js +56 -0
  413. package/dist/pi/packages/ta-recall/lib/composer.d.ts +7 -0
  414. package/dist/pi/packages/ta-recall/lib/composer.js +38 -0
  415. package/dist/pi/packages/ta-recall/lib/conversation-index.d.ts +25 -0
  416. package/dist/pi/packages/ta-recall/lib/conversation-index.js +72 -0
  417. package/dist/pi/packages/ta-recall/lib/conversation-util.d.ts +16 -0
  418. package/dist/pi/packages/ta-recall/lib/conversation-util.js +109 -0
  419. package/dist/pi/packages/ta-recall/lib/conversations.d.ts +11 -0
  420. package/dist/pi/packages/ta-recall/lib/conversations.js +46 -0
  421. package/dist/pi/packages/ta-recall/lib/extension.d.ts +24 -0
  422. package/dist/pi/packages/ta-recall/lib/extension.js +131 -0
  423. package/dist/pi/packages/ta-recall/lib/host.d.ts +4 -0
  424. package/dist/pi/packages/ta-recall/lib/host.js +11 -0
  425. package/dist/pi/packages/ta-recall/lib/i18n.d.ts +41 -0
  426. package/dist/pi/packages/ta-recall/lib/i18n.js +83 -0
  427. package/dist/pi/packages/ta-recall/lib/index.d.ts +9 -0
  428. package/dist/pi/packages/ta-recall/lib/index.js +45 -0
  429. package/dist/pi/packages/ta-recall/lib/react.d.ts +11 -0
  430. package/dist/pi/packages/ta-recall/lib/react.js +16 -0
  431. package/dist/pi/packages/ta-recall/lib/recall-protocol.d.ts +186 -0
  432. package/dist/pi/packages/ta-recall/lib/recall-protocol.js +60 -0
  433. package/dist/pi/packages/ta-recall/lib/recall-service.d.ts +42 -0
  434. package/dist/pi/packages/ta-recall/lib/recall-service.js +241 -0
  435. package/dist/pi/packages/ta-recall/lib/search-source.d.ts +7 -0
  436. package/dist/pi/packages/ta-recall/lib/search-source.js +49 -0
  437. package/dist/pi/packages/ta-recall/lib/search-util.d.ts +30 -0
  438. package/dist/pi/packages/ta-recall/lib/search-util.js +167 -0
  439. package/dist/pi/packages/ta-recall/lib/server-texts.d.ts +7 -0
  440. package/dist/pi/packages/ta-recall/lib/server-texts.js +17 -0
  441. package/dist/pi/packages/ta-recall/lib/settings.d.ts +4 -0
  442. package/dist/pi/packages/ta-recall/lib/settings.js +77 -0
  443. package/dist/pi/packages/ta-recall/lib/skill-card.d.ts +9 -0
  444. package/dist/pi/packages/ta-recall/lib/skill-card.js +51 -0
  445. package/dist/pi/packages/ta-recall/lib/skill-util.d.ts +19 -0
  446. package/dist/pi/packages/ta-recall/lib/skill-util.js +110 -0
  447. package/dist/pi/packages/ta-recall/lib/stored.d.ts +5 -0
  448. package/dist/pi/packages/ta-recall/lib/stored.js +28 -0
  449. package/dist/pi/packages/ta-recall/lib/style.d.ts +4 -0
  450. package/dist/pi/packages/ta-recall/lib/style.js +48 -0
  451. package/dist/pi/packages/ta-recall/lib/tool-line.d.ts +10 -0
  452. package/dist/pi/packages/ta-recall/lib/tool-line.js +23 -0
  453. package/dist/pi/packages/ta-recall/lib/tool.d.ts +63 -0
  454. package/dist/pi/packages/ta-recall/lib/tool.js +71 -0
  455. package/dist/pi/packages/ta-recall/package.json +55 -0
  456. package/dist/pi/packages/ta-recall/web/index.js +1038 -0
  457. package/dist/pi/packages/ta-rooms/README.en.md +23 -0
  458. package/dist/pi/packages/ta-rooms/README.md +23 -0
  459. package/dist/pi/packages/ta-rooms/lib/dialogs.d.ts +39 -0
  460. package/dist/pi/packages/ta-rooms/lib/dialogs.js +235 -0
  461. package/dist/pi/packages/ta-rooms/lib/i18n.d.ts +101 -0
  462. package/dist/pi/packages/ta-rooms/lib/i18n.js +203 -0
  463. package/dist/pi/packages/ta-rooms/lib/index.d.ts +9 -0
  464. package/dist/pi/packages/ta-rooms/lib/index.js +85 -0
  465. package/dist/pi/packages/ta-rooms/lib/members-view.d.ts +3 -0
  466. package/dist/pi/packages/ta-rooms/lib/members-view.js +64 -0
  467. package/dist/pi/packages/ta-rooms/lib/page.d.ts +105 -0
  468. package/dist/pi/packages/ta-rooms/lib/page.js +306 -0
  469. package/dist/pi/packages/ta-rooms/lib/react.d.ts +8 -0
  470. package/dist/pi/packages/ta-rooms/lib/react.js +8 -0
  471. package/dist/pi/packages/ta-rooms/lib/room-view.d.ts +17 -0
  472. package/dist/pi/packages/ta-rooms/lib/room-view.js +150 -0
  473. package/dist/pi/packages/ta-rooms/lib/rooms-page.d.ts +8 -0
  474. package/dist/pi/packages/ta-rooms/lib/rooms-page.js +174 -0
  475. package/dist/pi/packages/ta-rooms/lib/style.d.ts +4 -0
  476. package/dist/pi/packages/ta-rooms/lib/style.js +154 -0
  477. package/dist/pi/packages/ta-rooms/package.json +50 -0
  478. package/dist/pi/packages/ta-rooms/web/index.js +1932 -0
  479. package/dist/pi/packages/ta-share/README.en.md +27 -0
  480. package/dist/pi/packages/ta-share/README.md +27 -0
  481. package/dist/pi/packages/ta-share/extension/index.mjs +184 -0
  482. package/dist/pi/packages/ta-share/host/index.mjs +364 -0
  483. package/dist/pi/packages/ta-share/lib/extension.d.ts +15 -0
  484. package/dist/pi/packages/ta-share/lib/extension.js +115 -0
  485. package/dist/pi/packages/ta-share/lib/host.d.ts +4 -0
  486. package/dist/pi/packages/ta-share/lib/host.js +9 -0
  487. package/dist/pi/packages/ta-share/lib/i18n.d.ts +106 -0
  488. package/dist/pi/packages/ta-share/lib/i18n.js +213 -0
  489. package/dist/pi/packages/ta-share/lib/index.d.ts +9 -0
  490. package/dist/pi/packages/ta-share/lib/index.js +77 -0
  491. package/dist/pi/packages/ta-share/lib/page.d.ts +48 -0
  492. package/dist/pi/packages/ta-share/lib/page.js +105 -0
  493. package/dist/pi/packages/ta-share/lib/react.d.ts +8 -0
  494. package/dist/pi/packages/ta-share/lib/react.js +8 -0
  495. package/dist/pi/packages/ta-share/lib/server-texts.d.ts +14 -0
  496. package/dist/pi/packages/ta-share/lib/server-texts.js +52 -0
  497. package/dist/pi/packages/ta-share/lib/share-dialog.d.ts +18 -0
  498. package/dist/pi/packages/ta-share/lib/share-dialog.js +233 -0
  499. package/dist/pi/packages/ta-share/lib/share-protocol.d.ts +86 -0
  500. package/dist/pi/packages/ta-share/lib/share-protocol.js +30 -0
  501. package/dist/pi/packages/ta-share/lib/share-service.d.ts +50 -0
  502. package/dist/pi/packages/ta-share/lib/share-service.js +130 -0
  503. package/dist/pi/packages/ta-share/lib/shared-view.d.ts +18 -0
  504. package/dist/pi/packages/ta-share/lib/shared-view.js +225 -0
  505. package/dist/pi/packages/ta-share/lib/shares-page.d.ts +3 -0
  506. package/dist/pi/packages/ta-share/lib/shares-page.js +54 -0
  507. package/dist/pi/packages/ta-share/lib/snapshot.d.ts +30 -0
  508. package/dist/pi/packages/ta-share/lib/snapshot.js +195 -0
  509. package/dist/pi/packages/ta-share/lib/style.d.ts +4 -0
  510. package/dist/pi/packages/ta-share/lib/style.js +111 -0
  511. package/dist/pi/packages/ta-share/package.json +56 -0
  512. package/dist/pi/packages/ta-share/web/index.js +1197 -0
  513. package/dist/pi/packages/ta-workspace/README.md +2 -2
  514. package/dist/pi/packages/ta-workspace/README.zh-cn.md +2 -2
  515. package/dist/pi/packages/ta-workspace/lib/browser-common.d.ts +1 -1
  516. package/dist/pi/packages/ta-workspace/lib/browser-common.js +29 -30
  517. package/dist/pi/packages/ta-workspace/lib/browser-tool-line.d.ts +15 -0
  518. package/dist/pi/packages/ta-workspace/lib/browser-tool-line.js +70 -0
  519. package/dist/pi/packages/ta-workspace/lib/bytes.d.ts +11 -0
  520. package/dist/pi/packages/ta-workspace/lib/bytes.js +40 -0
  521. package/dist/pi/packages/ta-workspace/lib/common.d.ts +2 -1
  522. package/dist/pi/packages/ta-workspace/lib/common.js +15 -37
  523. package/dist/pi/packages/ta-workspace/lib/editors.js +40 -4
  524. package/dist/pi/packages/ta-workspace/lib/i18n.d.ts +14 -4
  525. package/dist/pi/packages/ta-workspace/lib/i18n.js +31 -11
  526. package/dist/pi/packages/ta-workspace/lib/index.js +17 -0
  527. package/dist/pi/packages/ta-workspace/lib/launcher.d.ts +9 -0
  528. package/dist/pi/packages/ta-workspace/lib/launcher.js +39 -0
  529. package/dist/pi/packages/ta-workspace/lib/preview.d.ts +22 -3
  530. package/dist/pi/packages/ta-workspace/lib/preview.js +150 -22
  531. package/dist/pi/packages/ta-workspace/lib/style.d.ts +1 -1
  532. package/dist/pi/packages/ta-workspace/lib/style.js +70 -41
  533. package/dist/pi/packages/ta-workspace/lib/terminal-sessions.d.ts +15 -4
  534. package/dist/pi/packages/ta-workspace/lib/terminal-sessions.js +31 -9
  535. package/dist/pi/packages/ta-workspace/lib/terminal.d.ts +3 -2
  536. package/dist/pi/packages/ta-workspace/lib/terminal.js +51 -21
  537. package/dist/pi/packages/ta-workspace/lib/util/keys.d.ts +18 -0
  538. package/dist/pi/packages/ta-workspace/lib/util/keys.js +23 -0
  539. package/dist/pi/packages/ta-workspace/lib/util/preview.d.ts +46 -0
  540. package/dist/pi/packages/ta-workspace/lib/util/preview.js +106 -1
  541. package/dist/pi/packages/ta-workspace/lib/util/terminal.d.ts +5 -0
  542. package/dist/pi/packages/ta-workspace/lib/util/terminal.js +14 -0
  543. package/dist/pi/packages/ta-workspace/package.json +1 -1
  544. package/dist/pi/packages/ta-workspace/web/index.js +1032 -382
  545. package/dist/public/assets/OrbitControls-DVf70a7w.js +1 -0
  546. package/dist/public/assets/{abnfDiagram-S7VZAUFO-EVMX_yOb.js → abnfDiagram-S7VZAUFO-D9uU0Tx2.js} +1 -1
  547. package/dist/public/assets/{architecture-WOLXFQ4H-CDgbgZ_o.js → architecture-WOLXFQ4H-f7Nm7EIo.js} +1 -1
  548. package/dist/public/assets/{architectureDiagram-YGSQEFNW-dHreaCWz.js → architectureDiagram-YGSQEFNW-DSAqlcms.js} +1 -1
  549. package/dist/public/assets/{blockDiagram-APKKGZFW-D6FhzBDq.js → blockDiagram-APKKGZFW-C0lPIW9g.js} +1 -1
  550. package/dist/public/assets/browser-WLpgVYno.js +12 -0
  551. package/dist/public/assets/{c4Diagram-KJ2TOQU5-BFpcr8Cs.js → c4Diagram-KJ2TOQU5-CDcZ7mJq.js} +1 -1
  552. package/dist/public/assets/{chunk-6MUBBAK2-BczXkMV-.js → chunk-6MUBBAK2-CXPuyqPL.js} +1 -1
  553. package/dist/public/assets/{chunk-AXFCVDMN-CjJsv3jB.js → chunk-AXFCVDMN-Du6JRX1x.js} +1 -1
  554. package/dist/public/assets/{chunk-BG4553SI-FBaleaLz.js → chunk-BG4553SI-D592E55X.js} +1 -1
  555. package/dist/public/assets/{chunk-DQASFODM-BFdXY5sX.js → chunk-DQASFODM-BW2r2SL4.js} +1 -1
  556. package/dist/public/assets/{chunk-HFQBQIA3-C5cwK-Fg.js → chunk-HFQBQIA3-C3yoe54R.js} +1 -1
  557. package/dist/public/assets/{chunk-KQLB2F66-BUek3IRk.js → chunk-KQLB2F66-DF8gfYCy.js} +1 -1
  558. package/dist/public/assets/{chunk-KS47KZWR-BxsYBzt6.js → chunk-KS47KZWR-C8CRMTv1.js} +1 -1
  559. package/dist/public/assets/{chunk-LEVMRMFU-Bdcwz9fS.js → chunk-LEVMRMFU-BDcMKiwj.js} +1 -1
  560. package/dist/public/assets/{chunk-M57EVK23-kkpP5oug.js → chunk-M57EVK23-CKJPBygc.js} +1 -1
  561. package/dist/public/assets/{chunk-OY52VR5R-CFhQgxmD.js → chunk-OY52VR5R-B3ZWH07L.js} +1 -1
  562. package/dist/public/assets/{chunk-QB3YPZ4I-BVXqu0eC.js → chunk-QB3YPZ4I-DI-z4UPL.js} +1 -1
  563. package/dist/public/assets/{chunk-R3KSYZAL-B7SUqqLI.js → chunk-R3KSYZAL-Bg4-haAc.js} +1 -1
  564. package/dist/public/assets/{chunk-STOXU5M4-B3abfbnH.js → chunk-STOXU5M4-l_SHib3p.js} +1 -1
  565. package/dist/public/assets/{chunk-TU62E6Q5-C9NqnUav.js → chunk-TU62E6Q5-BINu9tIm.js} +1 -1
  566. package/dist/public/assets/{chunk-X4PVCEUW-BeLfETDx.js → chunk-X4PVCEUW-BQn-mvV5.js} +1 -1
  567. package/dist/public/assets/{chunk-XXDRQBXY-DXai1i8p.js → chunk-XXDRQBXY-uvpAu0Ys.js} +1 -1
  568. package/dist/public/assets/{classDiagram-v2-L25IHNXF-Zj6ne_tC.js → classDiagram-v2-L25IHNXF-BIowooW1.js} +1 -1
  569. package/dist/public/assets/{cose-bilkent-JH36ORCC-C0-TjqfJ.js → cose-bilkent-JH36ORCC-BTyx1Mh2.js} +1 -1
  570. package/dist/public/assets/cynefin-EF2NZ3EQ-Dg54eFzZ.js +1 -0
  571. package/dist/public/assets/{cynefinDiagram-L36ESFBY-BnqxfzPa.js → cynefinDiagram-L36ESFBY-D64EU9I0.js} +1 -1
  572. package/dist/public/assets/{d3-selection-DfFLTR9d.js → d3-selection-CN9k6_B9.js} +1 -1
  573. package/dist/public/assets/{dagre-SPEB5RXH-kI17e5cH.js → dagre-SPEB5RXH-FCbz2-Kk.js} +1 -1
  574. package/dist/public/assets/{diagram-3B7GL73J-DgPjeLA5.js → diagram-3B7GL73J-OhHUSI7j.js} +1 -1
  575. package/dist/public/assets/{diagram-DNEMPZML-CRhPfa0I.js → diagram-DNEMPZML-Be4xMtp6.js} +1 -1
  576. package/dist/public/assets/{diagram-L3MUGCDN-ExuTg12b.js → diagram-L3MUGCDN-CmKSs3aG.js} +1 -1
  577. package/dist/public/assets/{diagram-LA4NIPWU-Dgx5xNiY.js → diagram-LA4NIPWU-D1C32rMN.js} +1 -1
  578. package/dist/public/assets/{diagram-MHCOC4E2-BuifkUTl.js → diagram-MHCOC4E2-BjoE6JXs.js} +1 -1
  579. package/dist/public/assets/{diagram-XPFHEONP-CFEaBo7z.js → diagram-XPFHEONP-B22k4v8R.js} +1 -1
  580. package/dist/public/assets/{dist-C-iJHcSK.js → dist-DcBP8Cf6.js} +1 -1
  581. package/dist/public/assets/{ebnfDiagram-UZSYDL2S-D-hp5yNt.js → ebnfDiagram-UZSYDL2S-Tn-K8-X7.js} +1 -1
  582. package/dist/public/assets/{editor.api-BopUWpqY.js → editor.api-Bz4sjRz_.js} +1 -1
  583. package/dist/public/assets/{elk-XV6XMXQE-CBbk_IpU.js → elk-XV6XMXQE-COnQsWlN.js} +1 -1
  584. package/dist/public/assets/{erDiagram-EYBAPDEH-B02R_WWE.js → erDiagram-EYBAPDEH-c53dJilq.js} +1 -1
  585. package/dist/public/assets/{eventmodeling-K75KTNOO-aCZfYnCI.js → eventmodeling-K75KTNOO-DaFpPPks.js} +1 -1
  586. package/dist/public/assets/flowDiagram-MALGAFMO-V5qkYWIO.js +1 -0
  587. package/dist/public/assets/{freemarker2-DMN60LeK.js → freemarker2-BLxfRHsw.js} +1 -1
  588. package/dist/public/assets/{ganttDiagram-23REXITY-DioU8TlD.js → ganttDiagram-23REXITY-Md-SavIS.js} +1 -1
  589. package/dist/public/assets/gitGraph-VSP46ZUC-1q8ldRXU.js +1 -0
  590. package/dist/public/assets/{gitGraphDiagram-STJD7YCW--q3ctg6y.js → gitGraphDiagram-STJD7YCW-CMSwTghO.js} +1 -1
  591. package/dist/public/assets/{handlebars-B_-qdvpB.js → handlebars-sNpu01kP.js} +1 -1
  592. package/dist/public/assets/{html-BN8Ah3Js.js → html-C_tKd-uP.js} +1 -1
  593. package/dist/public/assets/{index-B3A--ac8.js → index-Bn86rI4n.js} +2 -2
  594. package/dist/public/assets/info-OHQRW6UA-Crere6sx.js +1 -0
  595. package/dist/public/assets/{infoDiagram-KBXO4MBG-CGXteYo9.js → infoDiagram-KBXO4MBG-CwgNj-7i.js} +1 -1
  596. package/dist/public/assets/{ishikawaDiagram-M35NCXHK-DM2LmOAc.js → ishikawaDiagram-M35NCXHK-BSlzQNMN.js} +1 -1
  597. package/dist/public/assets/{javascript-BlizGb0q.js → javascript-l3qKw0L-.js} +1 -1
  598. package/dist/public/assets/{journeyDiagram-OPLOXDXO-CNITRtGl.js → journeyDiagram-OPLOXDXO-B09LPEnF.js} +1 -1
  599. package/dist/public/assets/{jsonMode-CEUmT5sN.js → jsonMode-5SQQn1EX.js} +1 -1
  600. package/dist/public/assets/{kanban-definition-BZKZHSQY-BPUuS9um.js → kanban-definition-BZKZHSQY-BiW4aJ29.js} +1 -1
  601. package/dist/public/assets/{liquid-BbyLjUbE.js → liquid-BGyTIIUt.js} +1 -1
  602. package/dist/public/assets/{mdx-DiQz7Q35.js → mdx-8tGjz4em.js} +1 -1
  603. package/dist/public/assets/{mermaid-parser.core-Dum100hC.js → mermaid-parser.core-CctN5b0z.js} +3 -3
  604. package/dist/public/assets/{mermaid.core-BWmWf6XO.js → mermaid.core-7ERSdZ4-.js} +4 -4
  605. package/dist/public/assets/{mindmap-definition-I2QAS2VK-L8HyYUDY.js → mindmap-definition-I2QAS2VK-D-GOUwW1.js} +1 -1
  606. package/dist/public/assets/module-DEqsdd00.js +1 -0
  607. package/dist/public/assets/module-TWc52XwT.js +2244 -0
  608. package/dist/public/assets/{monaco-zOOyBmxy.js → monaco-B_9hlk78.js} +3 -3
  609. package/dist/public/assets/packet-JDAUHWVQ-qMf5LkHT.js +1 -0
  610. package/dist/public/assets/{pegDiagram-FD4XPPHP-CTZKPo0Z.js → pegDiagram-FD4XPPHP-Dmy1fWB3.js} +1 -1
  611. package/dist/public/assets/phaser.esm-BxCDEWDb.js +3202 -0
  612. package/dist/public/assets/pie-XZMESJXO-BjqLn4qm.js +1 -0
  613. package/dist/public/assets/{pieDiagram-J4AKIIQI-DAeT3dFi.js → pieDiagram-J4AKIIQI-CXFHLYTg.js} +1 -1
  614. package/dist/public/assets/{python-C984gt98.js → python-e-JK0s5M.js} +1 -1
  615. package/dist/public/assets/{quadrantDiagram-XTYBLID2--PXxwV1Z.js → quadrantDiagram-XTYBLID2-RQvEpGWO.js} +1 -1
  616. package/dist/public/assets/radar-ABXABTNO-DWO6t_4C.js +1 -0
  617. package/dist/public/assets/railroad-I3PHUGI6-D1XOJPWy.js +1 -0
  618. package/dist/public/assets/{railroad-abnf-LNEFI6M7-BYcFfrCa.js → railroad-abnf-LNEFI6M7-CDOSPZwX.js} +1 -1
  619. package/dist/public/assets/{railroad-ebnf-DWYD2UWJ-Cd33qxAm.js → railroad-ebnf-DWYD2UWJ-BTrNQ0DX.js} +1 -1
  620. package/dist/public/assets/{railroad-peg-JR7BVNR7-C5TpzaU8.js → railroad-peg-JR7BVNR7-B7NtVofS.js} +1 -1
  621. package/dist/public/assets/{railroadDiagram-MRQ6NCDL-DlWwjbhH.js → railroadDiagram-MRQ6NCDL-DsDrT0Jf.js} +1 -1
  622. package/dist/public/assets/{razor-BBqMR1Qn.js → razor-DtSPwumi.js} +1 -1
  623. package/dist/public/assets/{requirementDiagram-Y7LWUY3S-CsYBy9HS.js → requirementDiagram-Y7LWUY3S-BQh0hFuA.js} +1 -1
  624. package/dist/public/assets/{sankeyDiagram-WGJFYUXA-Baxyb5p9.js → sankeyDiagram-WGJFYUXA-BUXNAQEF.js} +1 -1
  625. package/dist/public/assets/{sequenceDiagram-5NDRBG5M-Cq6VeBT_.js → sequenceDiagram-5NDRBG5M-05f-N5V_.js} +1 -1
  626. package/dist/public/assets/{stateDiagram-v2-FJ4FJNEA-O60WKaE7.js → stateDiagram-v2-FJ4FJNEA-D6V1fGWV.js} +1 -1
  627. package/dist/public/assets/{swimlanes-UMQ2AFYF-C2nf1-Cc.js → swimlanes-UMQ2AFYF-DWhlPvKs.js} +1 -1
  628. package/dist/public/assets/swimlanesDiagram-OMPLPG4O-CRn5uHsY.js +8 -0
  629. package/dist/public/assets/three.module-CeVBJVoU.js +4225 -0
  630. package/dist/public/assets/{timeline-definition-SEUHKTQE-DEfUG6YH.js → timeline-definition-SEUHKTQE-CMdocOui.js} +1 -1
  631. package/dist/public/assets/treeView-D4JQ5SDB-D09wHNzT.js +1 -0
  632. package/dist/public/assets/treemap-SAJKECNS-ChxAT7Fq.js +1 -0
  633. package/dist/public/assets/{typescript-Gtq7f0aU.js → typescript-65jNyipU.js} +1 -1
  634. package/dist/public/assets/{usecaseDiagram-AFA6YXN4-Gw9DyJcx.js → usecaseDiagram-AFA6YXN4-BQTHUX1f.js} +1 -1
  635. package/dist/public/assets/{vennDiagram-NNMJR3RB-Clb3MLWF.js → vennDiagram-NNMJR3RB-BULkVTfA.js} +1 -1
  636. package/dist/public/assets/wardley-7MLQ67FV-DfSjKzbJ.js +1 -0
  637. package/dist/public/assets/{wardleyDiagram-S7YFUSEH-BrTRpwu2.js → wardleyDiagram-S7YFUSEH-Cek6l8lz.js} +1 -1
  638. package/dist/public/assets/{xml-Bx3nk7iG.js → xml-DWBejfu-.js} +1 -1
  639. package/dist/public/assets/{xychartDiagram-GGNKY7IX-BfjTcIsb.js → xychartDiagram-GGNKY7IX-ujnZQTWA.js} +1 -1
  640. package/dist/public/assets/{yaml-dFLE_rSl.js → yaml-CwRCT7q1.js} +1 -1
  641. package/dist/public/index.html +1 -1
  642. package/dist/public/launch.svg +46 -42
  643. package/dist/serve/index.mjs +8244 -3756
  644. package/package.json +33 -26
  645. package/dist/pi/dist/bundle/chunks/anthropic-messages-BWGCKOF4.js +0 -6
  646. package/dist/pi/dist/bundle/chunks/chunk-44DLKSKE.js +0 -1232
  647. package/dist/pi/dist/bundle/chunks/chunk-62VOPMLK.js +0 -65
  648. package/dist/pi/dist/bundle/chunks/chunk-7O7QKK6A.js +0 -2
  649. package/dist/pi/dist/bundle/chunks/chunk-CHWNPHIS.js +0 -82
  650. package/dist/pi/dist/bundle/chunks/chunk-NL4X6LBY.js +0 -4
  651. package/dist/pi/dist/bundle/chunks/chunk-NZY7EIPA.js +0 -4
  652. package/dist/pi/dist/bundle/chunks/chunk-R2EGYMOO.js +0 -7
  653. package/dist/pi/dist/bundle/chunks/chunk-UKVNB6C4.js +0 -2
  654. package/dist/pi/dist/bundle/chunks/chunk-USJZMAIR.js +0 -2
  655. package/dist/pi/dist/bundle/chunks/chunk-VOLAXWGI.js +0 -2
  656. package/dist/pi/dist/bundle/chunks/openai-codex-responses-QAWLOQSN.js +0 -10
  657. package/dist/pi/dist/bundle/chunks/openai-responses-MD3562FB.js +0 -4
  658. package/dist/pi/dist/bundle/chunks/virtual-modules-O76XM3OB.js +0 -2
  659. package/dist/public/assets/browser-y6EDNUmc.js +0 -12
  660. package/dist/public/assets/cynefin-EF2NZ3EQ-CoY4CrZu.js +0 -1
  661. package/dist/public/assets/flowDiagram-MALGAFMO-CATkJShO.js +0 -1
  662. package/dist/public/assets/gitGraph-VSP46ZUC-g4yHXXxx.js +0 -1
  663. package/dist/public/assets/info-OHQRW6UA-CKADJjz4.js +0 -1
  664. package/dist/public/assets/module-CH7IXa5L.js +0 -1781
  665. package/dist/public/assets/module-DNAasuMC.js +0 -1
  666. package/dist/public/assets/packet-JDAUHWVQ-CpKMhX4K.js +0 -1
  667. package/dist/public/assets/pie-XZMESJXO-CW-zGDRd.js +0 -1
  668. package/dist/public/assets/radar-ABXABTNO-Cg8W433p.js +0 -1
  669. package/dist/public/assets/railroad-I3PHUGI6-DriMt2PQ.js +0 -1
  670. package/dist/public/assets/swimlanesDiagram-OMPLPG4O-B46JxqS8.js +0 -8
  671. package/dist/public/assets/treeView-D4JQ5SDB-1LhEWwC9.js +0 -1
  672. package/dist/public/assets/treemap-SAJKECNS-D3t3N7nS.js +0 -1
  673. package/dist/public/assets/wardley-7MLQ67FV-D3sAsd8p.js +0 -1
@@ -0,0 +1,449 @@
1
+ ---
2
+ name: filters-and-postfx
3
+ description: "Use this skill when applying visual filters or post-processing effects in Phaser 4. Covers bloom, blur, glow, color matrix, barrel distortion, displacement, custom shaders, and the filter pipeline. Triggers on: filter, post-processing, shader, bloom, blur, glow, color effects."
4
+ ---
5
+
6
+ # Phaser 4 Filters and Post-FX
7
+
8
+ ## Quick Start
9
+
10
+ Add a glow effect to a sprite:
11
+
12
+ ```js
13
+ // In your Scene's create() method:
14
+ const sprite = this.add.sprite(400, 300, 'player');
15
+
16
+ // Step 1: Enable the filter system on the game object (WebGL only)
17
+ sprite.enableFilters();
18
+
19
+ // Step 2: Add filters via .filters.internal or .filters.external
20
+ sprite.filters.internal.addGlow(0xff00ff, 4, 0, 1);
21
+ ```
22
+
23
+ Add a blur to the camera:
24
+
25
+ ```js
26
+ // Cameras have filters enabled by default - no enableFilters() needed
27
+ const camera = this.cameras.main;
28
+ camera.filters.internal.addBlur(0, 2, 2, 1);
29
+ ```
30
+
31
+ ---
32
+
33
+ ## Core Concepts
34
+
35
+ ### How Filters Work in v4
36
+
37
+ Filters are GPU-based post-processing effects applied after an object or camera renders to a texture. Each filter runs a shader pass over that texture, producing the final visual output. Filters are WebGL only.
38
+
39
+ The rendering pipeline for a camera with filters:
40
+
41
+ 1. Objects render to a texture the size of the camera.
42
+ 2. **Internal filters** process that texture, applying effects in object/camera local space.
43
+ 3. The texture is drawn to a context-sized texture, applying camera transformations (position, rotation, zoom).
44
+ 4. **External filters** process that context texture, applying effects in screen space.
45
+ 5. The final texture is composited into the output.
46
+
47
+ ### Internal vs External Filters
48
+
49
+ Every `FilterList` exposes two sub-lists: `filters.internal` and `filters.external`. The distinction controls **when** the filter runs relative to the camera/object transform:
50
+
51
+ - **Internal** -- applied before the camera transform. Effects operate in the object's local coordinate space. A horizontal blur on a rotated object appears rotated with the object. Internal filters only cover the object/camera region, so they are cheaper.
52
+ - **External** -- applied after the camera transform. Effects operate in screen space. A horizontal blur on a rotated object always blurs horizontally on screen. External filters are full-screen and more expensive.
53
+
54
+ Use internal filters wherever possible for better performance.
55
+
56
+ ### FilterList
57
+
58
+ `FilterList` (`Phaser.GameObjects.Components.FilterList`) is the container that holds filter controllers. It provides:
59
+
60
+ - `add(filter, index)` -- add a Controller instance at an optional index
61
+ - `remove(filter, forceDestroy)` -- remove and destroy a filter
62
+ - `clear()` -- remove and destroy all filters
63
+ - `getActive()` -- return all filters where `active === true`
64
+ - `list` -- the raw array of Controllers (safe to reorder)
65
+ - Convenience factory methods: `addBlur()`, `addGlow()`, `addMask()`, etc.
66
+
67
+ ### Filter Controllers
68
+
69
+ Every filter is a `Phaser.Filters.Controller` subclass. Common Controller properties:
70
+
71
+ | Property | Type | Description |
72
+ |---|---|---|
73
+ | `active` | boolean | Toggle the filter on/off without removing it |
74
+ | `camera` | Camera | The camera that owns this filter |
75
+ | `renderNode` | string | The render node ID for the shader |
76
+ | `paddingOverride` | Rectangle | Override automatic padding calculation |
77
+ | `ignoreDestroy` | boolean | If true, the filter survives when its FilterList is destroyed (for reuse) |
78
+
79
+ Key methods: `setActive(bool)`, `setPaddingOverride(left, top, right, bottom)`, `getPadding()`, `destroy()`.
80
+
81
+ ### Enabling Filters on Game Objects
82
+
83
+ Cameras have filters available by default. Game objects do not -- you must call `enableFilters()` first:
84
+
85
+ ```js
86
+ const sprite = this.add.sprite(400, 300, 'hero');
87
+ sprite.enableFilters();
88
+
89
+ // Now sprite.filters is available
90
+ sprite.filters.internal.addGlow();
91
+ sprite.filters.external.addVignette();
92
+ ```
93
+
94
+ `enableFilters()` creates an internal `filterCamera` on the game object that handles rendering the object to a texture for filter processing. It returns `this` for chaining.
95
+
96
+ Related properties on game objects after enabling:
97
+
98
+ | Property | Default | Description |
99
+ |---|---|---|
100
+ | `filterCamera` | null -> Camera | The internal camera used for filter rendering |
101
+ | `filters` | null -> {internal, external} | Access to the FilterList pair |
102
+ | `renderFilters` | true | Master toggle for all filter rendering |
103
+ | `filtersAutoFocus` | true | Auto-adjust camera to follow the object |
104
+ | `filtersFocusContext` | false | Focus on the rendering context instead of the object bounds |
105
+ | `filtersForceComposite` | false | Always draw to a framebuffer even with no active filters |
106
+ | `maxFilterSize` | null -> Vector2 | Maximum texture size for filter framebuffers |
107
+
108
+ Use `willRenderFilters()` to check if any active filters will actually render.
109
+
110
+ ---
111
+
112
+ ## Common Patterns
113
+
114
+ ### Adding Filters to Game Objects
115
+
116
+ ```js
117
+ const sprite = this.add.sprite(400, 300, 'enemy');
118
+ sprite.enableFilters();
119
+
120
+ // Add a glow
121
+ const glow = sprite.filters.internal.addGlow(0x00ff00, 4);
122
+
123
+ // Modify at runtime
124
+ glow.outerStrength = 8;
125
+ glow.color = 0xff0000;
126
+
127
+ // Temporarily disable
128
+ glow.setActive(false);
129
+
130
+ // Remove and destroy
131
+ sprite.filters.internal.remove(glow);
132
+ ```
133
+
134
+ ### Camera Filters
135
+
136
+ ```js
137
+ const camera = this.cameras.main;
138
+
139
+ // Internal: effect in camera-local space
140
+ const blur = camera.filters.internal.addBlur(0, 2, 2, 1);
141
+
142
+ // External: effect in screen space
143
+ const vignette = camera.filters.external.addVignette(0.5, 0.5, 0.5, 0.5);
144
+
145
+ // Color grading via ColorMatrix
146
+ const cm = camera.filters.internal.addColorMatrix();
147
+ cm.colorMatrix.sepia();
148
+ ```
149
+
150
+ ### Chaining Multiple Filters
151
+
152
+ Filters execute in list order. Each filter receives the output of the previous one:
153
+
154
+ ```js
155
+ const cam = this.cameras.main;
156
+
157
+ // First: apply color grading
158
+ const cm = cam.filters.internal.addColorMatrix();
159
+ cm.colorMatrix.brightness(0.2);
160
+
161
+ // Second: apply blur to the color-graded result
162
+ cam.filters.internal.addBlur(1, 2, 2, 1);
163
+
164
+ // Third: add a vignette on top
165
+ cam.filters.external.addVignette(0.5, 0.5, 0.5, 0.8);
166
+ ```
167
+
168
+ ### Masks via Filters
169
+
170
+ Masks in v4 are implemented as filters. They use the alpha channel of a texture or game object to control visibility:
171
+
172
+ ```js
173
+ // Mask with a static texture
174
+ sprite.enableFilters();
175
+ sprite.filters.internal.addMask('maskTexture');
176
+
177
+ // Mask with a game object (renders to DynamicTexture automatically)
178
+ const maskShape = this.add.circle(0, 0, 100, 0xffffff);
179
+ sprite.enableFilters();
180
+ const mask = sprite.filters.internal.addMask(maskShape);
181
+
182
+ // Invert the mask
183
+ mask.invert = true;
184
+
185
+ // Control auto-updating for game object masks
186
+ mask.autoUpdate = true; // default: re-renders each frame
187
+ mask.needsUpdate = true; // force a one-time update
188
+
189
+ // Use a specific camera for viewing the mask object
190
+ sprite.filters.external.addMask(maskShape, false, this.cameras.main);
191
+ ```
192
+
193
+ Internal masks match the object being filtered. External masks match the camera context. Use a `viewCamera` parameter to control which camera renders the mask game object.
194
+
195
+ ### Wipe / Reveal Transitions
196
+
197
+ ```js
198
+ const camera = this.cameras.main;
199
+ const wipe = camera.filters.external.addWipe(0.1, 0, 0);
200
+
201
+ // Animate via tween
202
+ this.tweens.add({
203
+ targets: wipe,
204
+ progress: 1,
205
+ duration: 2000,
206
+ ease: 'Linear'
207
+ });
208
+
209
+ // Direction helpers
210
+ wipe.setLeftToRight();
211
+ wipe.setTopToBottom();
212
+ wipe.setRevealEffect(); // reveal mode
213
+ wipe.setWipeEffect(); // wipe mode
214
+
215
+ // Wipe to another texture (for scene transitions)
216
+ wipe.setTexture('nextSceneCapture');
217
+ ```
218
+
219
+ ### ParallelFilters (Custom Bloom and Compositing)
220
+
221
+ ParallelFilters splits the input into two paths, processes each independently, then blends the results. This replaces the dedicated Bloom filter from v3:
222
+
223
+ ```js
224
+ const camera = this.cameras.main;
225
+ const pf = camera.filters.internal.addParallelFilters();
226
+
227
+ // Top path: threshold bright areas, then blur them
228
+ pf.top.addThreshold(0.5, 1);
229
+ pf.top.addBlur();
230
+
231
+ // Configure the blend (how top combines onto bottom)
232
+ pf.blend.blendMode = Phaser.BlendModes.ADD;
233
+ pf.blend.amount = 0.5;
234
+
235
+ // Bottom path: left empty = uses original input
236
+ ```
237
+
238
+ ### CaptureFrame for Scene-Level Effects
239
+
240
+ `CaptureFrame` captures the current render state at the point it appears in the display list. Objects rendered before it are captured; objects after it are not:
241
+
242
+ ```js
243
+ // Requires composite mode on the camera
244
+ this.cameras.main.setForceComposite(true);
245
+
246
+ // Objects rendered before CaptureFrame are captured
247
+ const bg = this.add.image(400, 300, 'background');
248
+
249
+ // Create the capture point
250
+ const capture = this.add.captureFrame('myCapture');
251
+
252
+ // Display the captured texture with filters applied
253
+ const display = this.add.image(400, 300, 'myCapture');
254
+ display.enableFilters();
255
+ display.filters.internal.addBlur(0, 4, 4, 2);
256
+ ```
257
+
258
+ ---
259
+
260
+ ## All Built-in Filters
261
+
262
+ | Filter | Add Method | Description |
263
+ |---|---|---|
264
+ | Barrel | `addBarrel(amount)` | Pinch/expand distortion. `amount=1` is neutral. |
265
+ | Blend | `addBlend(texture, blendMode, amount, color)` | Blend another texture using a blend mode. Supports modes not available in standard WebGL. |
266
+ | Blocky | `addBlocky(config)` | Pixelation that preserves original colors (no blending). Best without anti-aliasing. |
267
+ | Blur | `addBlur(quality, x, y, strength, color, steps)` | Gaussian blur. Quality: 0=low, 1=medium, 2=high. |
268
+ | Bokeh | `addBokeh(radius, amount, contrast)` | Depth-of-field bokeh blur effect. |
269
+ | ColorMatrix | `addColorMatrix()` | Color manipulation via matrix. Access `.colorMatrix` for sepia, grayscale, brightness, hue, etc. |
270
+ | CombineColorMatrix | `addCombineColorMatrix(texture)` | Combine channels from two textures via color matrices. Useful for alpha transfer. |
271
+ | Displacement | `addDisplacement(texture, x, y)` | Pixel displacement using a displacement map texture. Values are very small floats (e.g. 0.005). |
272
+ | Glow | `addGlow(color, outerStrength, innerStrength, scale, knockout, quality, distance)` | Luminous halo around edges. Supports inner/outer glow and knockout mode. |
273
+ | GradientMap | `addGradientMap(config)` | Recolor image using a ColorRamp based on brightness. |
274
+ | ImageLight | `addImageLight(config)` | Image-based lighting using a panorama environment map and normal map. |
275
+ | Key | `addKey(config)` | Chroma key: remove or isolate a specific color. Config: `{ color, threshold, feather, isolate }`. |
276
+ | Mask | `addMask(mask, invert, viewCamera, viewTransform, scaleFactor)` | Alpha masking via texture or game object. |
277
+ | NormalTools | `addNormalTools(config)` | Manipulate normal maps: rotate, adjust facing power, output grayscale facing data. |
278
+ | PanoramaBlur | `addPanoramaBlur(config)` | Spherically-correct blur for panorama images. For use with ImageLight. Very slow. |
279
+ | ParallelFilters | `addParallelFilters()` | Split input into two filter paths, blend results. Use for custom bloom. |
280
+ | Pixelate | `addPixelate(amount)` | Mosaic/pixelation effect. Pixel size = 2 + amount. Blends colors (unlike Blocky). |
281
+ | Quantize | `addQuantize(config)` | Reduce color palette. Supports RGBA/HSVA modes, gamma, offset, dithering. |
282
+ | Sampler | `addSampler(callback, region)` | Extract pixel data from the render. Does not alter the image. Expensive. |
283
+ | Shadow | `addShadow(x, y, decay, power, color, samples, intensity)` | Drop shadow with offset, decay, and color. |
284
+ | Threshold | `addThreshold(edge1, edge2, invert)` | Binary threshold per channel. Edges can be arrays for per-channel control. |
285
+ | TiltShift | `addTiltShift(radius, amount, contrast, blurX, blurY, strength)` | Miniature/tilt-shift effect (uses Bokeh internally). |
286
+ | Vignette | `addVignette(x, y, radius, strength, color, blendMode)` | Edge darkening/coloring. Supports NORMAL, ADD, MULTIPLY, SCREEN blend modes. |
287
+ | Wipe | `addWipe(wipeWidth, direction, axis, reveal, wipeTexture)` | Wipe/reveal transition. Animate `progress` via tween. |
288
+
289
+ ---
290
+
291
+ ## API Quick Reference
292
+
293
+ ### Enabling and Accessing Filters
294
+
295
+ ```js
296
+ // Game objects: must enable first
297
+ gameObject.enableFilters();
298
+ gameObject.filters.internal.addBlur();
299
+ gameObject.filters.external.addGlow();
300
+
301
+ // Cameras: filters available immediately
302
+ camera.filters.internal.addBlur();
303
+ camera.filters.external.addGlow();
304
+ ```
305
+
306
+ ### FilterList Methods
307
+
308
+ ```js
309
+ const list = camera.filters.internal;
310
+
311
+ list.addBlur(); // Factory method (one per filter type)
312
+ list.add(controllerInstance); // Add a pre-built controller
313
+ list.add(controller, 2); // Insert at index 2
314
+ list.remove(controller); // Remove and destroy
315
+ list.clear(); // Remove and destroy all
316
+ list.getActive(); // Get all active controllers
317
+ list.list; // Raw array (reorder safely)
318
+ ```
319
+
320
+ ### Controller Common API
321
+
322
+ ```js
323
+ controller.active = false; // Disable without removing
324
+ controller.setActive(true); // Enable (returns this)
325
+ controller.setPaddingOverride(10, 10, 10, 10); // Override padding
326
+ controller.setPaddingOverride(null); // Clear override
327
+ controller.ignoreDestroy = true; // Survive FilterList.destroy()
328
+ controller.destroy(); // Manual cleanup
329
+ ```
330
+
331
+ ### Mask Filter API
332
+
333
+ ```js
334
+ const mask = list.addMask('texKey'); // From texture key
335
+ const mask = list.addMask(gameObject); // From game object
336
+ mask.invert = true; // Invert mask
337
+ mask.autoUpdate = false; // Stop auto-updating GO masks
338
+ mask.needsUpdate = true; // Force one update
339
+ mask.setTexture('newKey'); // Change texture source
340
+ mask.setGameObject(newGO); // Change GO source
341
+ mask.viewCamera = otherCamera; // Camera for GO rendering
342
+ mask.viewTransform = 'local'; // 'local' or 'world'
343
+ mask.scaleFactor = 0.5; // Scale mask texture size
344
+ ```
345
+
346
+ ### ColorMatrix Presets
347
+
348
+ ```js
349
+ const cm = list.addColorMatrix();
350
+ cm.colorMatrix.sepia();
351
+ cm.colorMatrix.grayscale(1);
352
+ cm.colorMatrix.brightness(0.3);
353
+ cm.colorMatrix.hue(90);
354
+ cm.colorMatrix.saturate(-0.5);
355
+ cm.colorMatrix.contrast(0.3);
356
+ cm.colorMatrix.blackWhite();
357
+ cm.colorMatrix.negative();
358
+ cm.colorMatrix.desaturate();
359
+ cm.colorMatrix.night(0.5);
360
+ cm.colorMatrix.lsd();
361
+ cm.colorMatrix.brown();
362
+ cm.colorMatrix.vintagePinhole();
363
+ cm.colorMatrix.kodachrome();
364
+ cm.colorMatrix.technicolor();
365
+ cm.colorMatrix.polaroid();
366
+ cm.colorMatrix.shiftToBGR();
367
+ ```
368
+
369
+ ---
370
+
371
+ ## Gotchas
372
+
373
+ 1. **WebGL only** -- Filters do not work in Canvas renderer. `enableFilters()` returns early if WebGL is not available.
374
+
375
+ 2. **enableFilters() required for game objects** -- Cameras have filters by default. Sprites, images, containers, and other game objects require `enableFilters()` before accessing `filters`.
376
+
377
+ 3. **Performance cost** -- Each object with active filters creates extra draw calls (one for the base render plus one per active filter). Use sparingly and performance test early.
378
+
379
+ 4. **Internal vs external matters** -- Internal filters are cheaper (object-region sized). External filters are full-screen. A blur that should rotate with the object must be internal; a blur that should stay screen-aligned must be external.
380
+
381
+ 5. **Filter order matters** -- Filters are applied sequentially in list order. The output of one feeds into the next.
382
+
383
+ 6. **Glow quality and distance are immutable** -- `quality` and `distance` on the Glow filter cannot be changed after creation. Destroy and recreate the filter to change them.
384
+
385
+ 7. **CaptureFrame requires forceComposite** -- The camera must have `setForceComposite(true)` or otherwise render into a framebuffer for CaptureFrame to work.
386
+
387
+ 8. **Padding for expanding effects** -- Filters like Blur, Glow, and Shadow can automatically calculate padding to expand the render texture. Override with `setPaddingOverride()` if needed. Pass `null` to clear the override. When used on a camera, use `camera.getPaddingWrapper(x)` to render more world outside the image edge.
388
+
389
+ 9. **Controller reuse** -- By default, controllers are destroyed when their FilterList is destroyed. Set `ignoreDestroy = true` to reuse a controller across multiple objects, but you must manage its lifecycle manually. Works best with external filters.
390
+
391
+ 10. **Mask game object rendering** -- When using a game object as a mask source, it is rendered to a DynamicTexture each frame (if `autoUpdate` is true). Set `autoUpdate = false` and use `needsUpdate = true` for one-shot updates to improve performance for static masks.
392
+
393
+ 11. **No Bloom filter** -- v4 does not have a dedicated Bloom filter. Use ParallelFilters with Threshold + Blur + ADD blend instead (see Common Patterns), or use `Phaser.Actions.AddEffectBloom` to automate the process.
394
+
395
+ ---
396
+
397
+ ## v4 Changes from v3
398
+
399
+ | v3 (FX) | v4 (Filters) | Notes |
400
+ |---|---|---|
401
+ | `gameObject.preFX` / `gameObject.postFX` | `gameObject.filters.internal` / `gameObject.filters.external` | `preFX`/`postFX` replaced by internal/external filter lists |
402
+ | `camera.postFX` | `camera.filters.internal` / `camera.filters.external` | Cameras now have both internal and external lists |
403
+ | `FX.addBloom()` | Use `ParallelFilters` + Threshold + Blur | No dedicated Bloom filter; build it with ParallelFilters or `Phaser.Actions.AddEffectBloom` |
404
+ | `FX.addCircle()` | Use Vignette or Mask | Circle effect removed; use Vignette with radius or a circular Mask, or automate with `Phaser.Actions.AddMaskShape` |
405
+ | `FX.addGradient()` | Use Gradient GameObject + Quantize | New Gradient GameObject renders gradients; Quantize adds steps if wanted |
406
+ | Glow `quality` was 0-1 fraction | Glow `quality` is an integer (default 10) | Stochastic sampling replaces line sampling; higher quality at lower values |
407
+ | `camera.setMask()` | `camera.filters.internal.addMask()` | Masks are now filters, not a separate system |
408
+ | `gameObject.setMask()` | `gameObject.filters.internal.addMask()` | Same unified filter system |
409
+ | FX controllers | `Phaser.Filters.Controller` subclasses | Same pattern: returned controller objects with mutable properties |
410
+ | -- | `enableFilters()` required for game objects | New explicit opt-in step for game objects |
411
+ | -- | Blocky, Quantize, Key, Blend, CombineColorMatrix, ImageLight, NormalTools, PanoramaBlur, ParallelFilters, Sampler | New filters added in v4 |
412
+
413
+ ---
414
+
415
+ ## Source File Map
416
+
417
+ | File | Description |
418
+ |---|---|
419
+ | `src/gameobjects/components/Filters.js` | Mixin that adds `enableFilters()`, `filterCamera`, `filters` to game objects |
420
+ | `src/gameobjects/components/FilterList.js` | FilterList class with all `add*()` factory methods |
421
+ | `src/filters/Controller.js` | Base Controller class for all filters |
422
+ | `src/filters/Barrel.js` | Barrel distortion filter |
423
+ | `src/filters/Blend.js` | Texture blend filter |
424
+ | `src/filters/Blocky.js` | Color-preserving pixelation filter |
425
+ | `src/filters/Blur.js` | Gaussian blur filter |
426
+ | `src/filters/Bokeh.js` | Bokeh / tilt shift filter |
427
+ | `src/filters/ColorMatrix.js` | Color matrix filter (sepia, grayscale, etc.) |
428
+ | `src/filters/CombineColorMatrix.js` | Dual-texture channel combining filter |
429
+ | `src/filters/Displacement.js` | Displacement map filter |
430
+ | `src/filters/Glow.js` | Glow/outline filter |
431
+ | `src/filters/GradientMap.js` | Gradient map recoloring filter |
432
+ | `src/filters/ImageLight.js` | Image-based lighting filter |
433
+ | `src/filters/Key.js` | Chroma key filter |
434
+ | `src/filters/Mask.js` | Alpha mask filter (texture or game object) |
435
+ | `src/filters/NormalTools.js` | Normal map manipulation filter |
436
+ | `src/filters/PanoramaBlur.js` | Spherical panorama blur filter |
437
+ | `src/filters/ParallelFilters.js` | Parallel filter paths with blend |
438
+ | `src/filters/Pixelate.js` | Pixelation filter |
439
+ | `src/filters/Quantize.js` | Color quantization filter |
440
+ | `src/filters/Sampler.js` | Pixel sampling/readback filter |
441
+ | `src/filters/Shadow.js` | Drop shadow filter |
442
+ | `src/filters/Threshold.js` | Threshold filter |
443
+ | `src/filters/Vignette.js` | Vignette filter |
444
+ | `src/filters/Wipe.js` | Wipe/reveal transition filter |
445
+ | `src/gameobjects/captureframe/CaptureFrame.js` | CaptureFrame game object for scene-level capture |
446
+
447
+ ---
448
+
449
+ Related: sprites-and-images.md, cameras.md, v4-new-features.md