@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,497 @@
1
+ ---
2
+ name: cameras
3
+ description: "Use this skill when working with cameras in Phaser 4. Covers camera effects (shake, fade, flash, pan, zoom), following sprites, scroll, bounds, viewports, multiple cameras, and minimap. Triggers on: camera, viewport, scroll, zoom, follow, shake, fade."
4
+ ---
5
+
6
+ # Cameras
7
+ > Camera system in Phaser 4 -- CameraManager, main camera, viewport vs scroll, zoom, bounds, following sprites, camera effects (fade, flash, shake, pan, zoomTo, rotateTo), ignore lists, filters, and keyboard controls.
8
+
9
+ **Key source paths:** `src/cameras/2d/CameraManager.js`, `src/cameras/2d/BaseCamera.js`, `src/cameras/2d/Camera.js`, `src/cameras/2d/effects/`, `src/cameras/controls/`
10
+ **Related skills:** ../game-setup-and-config/SKILL.md, ../sprites-and-images/SKILL.md, ../filters-and-postfx/SKILL.md
11
+
12
+ ## Quick Start
13
+
14
+ ```js
15
+ // In a Scene's create() method:
16
+
17
+ // Access the default camera (created automatically)
18
+ const cam = this.cameras.main;
19
+
20
+ // Scroll the camera to look at a different part of the world
21
+ cam.setScroll(200, 100);
22
+
23
+ // Center camera on a world coordinate
24
+ cam.centerOn(400, 300);
25
+
26
+ // Zoom in (2x) -- values < 1 zoom out, > 1 zoom in
27
+ cam.setZoom(2);
28
+
29
+ // Follow a sprite with smooth lerp
30
+ cam.startFollow(player, false, 0.1, 0.1);
31
+
32
+ // Constrain the camera to the world bounds
33
+ cam.setBounds(0, 0, 2048, 2048);
34
+
35
+ // Fade in from black over 1 second
36
+ cam.fadeIn(1000);
37
+
38
+ // Add a filter to the camera (v4 feature)
39
+ cam.filters.external.addBlur(1, 2);
40
+ ```
41
+
42
+ ## Core Concepts
43
+
44
+ ### CameraManager
45
+
46
+ Every Scene has a `CameraManager` accessible via `this.cameras`. It manages all cameras for that Scene and is registered as a plugin under the key `'CameraManager'`.
47
+
48
+ ```js
49
+ // The manager is at this.cameras (not this.camera)
50
+ this.cameras // CameraManager instance
51
+ this.cameras.cameras // Array of Camera objects (render order)
52
+ this.cameras.main // Reference to the "main" camera (first one by default)
53
+ this.cameras.default // Un-transformed utility camera (not in the cameras array)
54
+ ```
55
+
56
+ **Key methods on CameraManager:**
57
+
58
+ | Method | Signature | Description |
59
+ |---|---|---|
60
+ | `add` | `(x?, y?, width?, height?, makeMain?, name?)` | Create a new Camera. Defaults to full game size at 0,0. Returns `Camera`. |
61
+ | `addExisting` | `(camera, makeMain?)` | Add a pre-built Camera instance. Returns the Camera or `null` if it already exists. |
62
+ | `remove` | `(camera, runDestroy?)` | Remove and optionally destroy a Camera or array of Cameras. If main is removed, resets to cameras[0]. |
63
+ | `getCamera` | `(name)` | Find a Camera by its `name` string. Returns Camera or `null`. |
64
+ | `getTotal` | `(isVisible?)` | Count cameras. Pass `true` to count only visible ones. |
65
+ | `fromJSON` | `(config)` | Create cameras from a config object or array. Used for scene-level camera config. |
66
+ | `resetAll` | `()` | Destroy all cameras and create one fresh default camera. |
67
+ | `resize` | `(width, height)` | Resize all cameras to given dimensions. |
68
+
69
+ **Camera limit:** The manager supports up to 32 cameras that can use `ignore()` for Game Object exclusion (IDs are bitmasks). Cameras beyond 32 get ID 0 and cannot exclude objects.
70
+
71
+ ### Main Camera
72
+
73
+ The `main` property is a convenience reference to a Camera, typically `cameras[0]`. It is set automatically when:
74
+ - The scene boots (first camera created becomes main)
75
+ - You pass `makeMain: true` to `add()` or `addExisting()`
76
+ - The current main camera is removed (falls back to `cameras[0]`)
77
+
78
+ ### Viewport vs World (Scroll)
79
+
80
+ A Camera has two independent coordinate concepts:
81
+
82
+ 1. **Viewport** -- The physical rectangle on the canvas where the Camera renders. Controlled by `setPosition(x, y)`, `setSize(w, h)`, or `setViewport(x, y, w, h)`. By default, fills the entire game canvas.
83
+
84
+ 2. **Scroll** -- Where the Camera is "looking" in the game world. Controlled by `scrollX` / `scrollY` properties or `setScroll(x, y)`. Scrolling does not affect the viewport rectangle.
85
+
86
+ ```js
87
+ // Viewport: a 320x200 mini-map in the top-right corner
88
+ const miniCam = this.cameras.add(480, 0, 320, 200);
89
+
90
+ // Scroll: make the mini-map look at a different world area
91
+ miniCam.setScroll(1000, 500);
92
+
93
+ // Zoom: the mini-cam shows more of the world
94
+ miniCam.setZoom(0.25);
95
+ ```
96
+
97
+ **worldView** is a read-only `Rectangle` updated each frame that reflects what area of the world the camera can currently see, accounting for scroll, zoom, and bounds. Use it for culling or intersection checks.
98
+
99
+ ```js
100
+ const view = cam.worldView; // { x, y, width, height }
101
+ ```
102
+
103
+ ## Common Patterns
104
+
105
+ ### Scrolling the Camera
106
+
107
+ ```js
108
+ // Direct property access
109
+ cam.scrollX = 100;
110
+ cam.scrollY = 200;
111
+
112
+ // Chainable setter
113
+ cam.setScroll(100, 200);
114
+
115
+ // Center the camera on a world coordinate
116
+ cam.centerOn(500, 400);
117
+
118
+ // Get the scroll values needed to center on a point (without moving)
119
+ const point = cam.getScroll(500, 400); // returns Vector2
120
+ ```
121
+
122
+ ### Following a Sprite
123
+
124
+ ```js
125
+ // Instant follow (lerp = 1, the default)
126
+ cam.startFollow(player);
127
+
128
+ // Smooth follow with lerp (0..1, lower = smoother)
129
+ cam.startFollow(player, false, 0.1, 0.1);
130
+
131
+ // Full signature:
132
+ // startFollow(target, roundPixels?, lerpX?, lerpY?, offsetX?, offsetY?)
133
+ cam.startFollow(player, true, 0.05, 0.05, 0, -50);
134
+
135
+ // Change lerp or offset after starting follow
136
+ cam.setLerp(0.08, 0.08);
137
+ cam.setFollowOffset(0, -50);
138
+
139
+ // Dead zone: camera only scrolls when target leaves this rectangle
140
+ cam.setDeadzone(200, 150);
141
+
142
+ // Stop following
143
+ cam.stopFollow();
144
+ ```
145
+
146
+ `startFollow` accepts any object with `x` and `y` properties -- it does not have to be a Game Object. Lerp of `1` snaps instantly; `0.1` gives smooth tracking. A lerp of `0` on an axis disables tracking on that axis.
147
+
148
+ When a deadzone is set, the camera does not scroll while the target remains inside the deadzone rectangle. The deadzone is re-centered on the camera midpoint each frame.
149
+
150
+ ### Zoom
151
+
152
+ ```js
153
+ // Uniform zoom
154
+ cam.setZoom(2); // 2x zoom in
155
+ cam.setZoom(0.5); // zoom out (see twice as much)
156
+
157
+ // Independent horizontal/vertical zoom
158
+ cam.setZoom(2, 1); // stretch horizontally
159
+
160
+ // Read current zoom
161
+ cam.zoom; // shortcut -- reads zoomX (assumes uniform)
162
+ cam.zoomX;
163
+ cam.zoomY;
164
+ ```
165
+
166
+ **Never set zoom to 0.** The minimum is clamped to 0.001.
167
+
168
+ ### Bounds
169
+
170
+ ```js
171
+ // Constrain scrolling to a world area
172
+ cam.setBounds(0, 0, worldWidth, worldHeight);
173
+
174
+ // Center on the new bounds immediately
175
+ cam.setBounds(0, 0, 2048, 2048, true);
176
+
177
+ // Temporarily disable bounds without removing them
178
+ cam.useBounds = false;
179
+
180
+ // Remove bounds entirely
181
+ cam.removeBounds();
182
+
183
+ // Read the current bounds
184
+ const rect = cam.getBounds(); // returns a new Rectangle copy
185
+ ```
186
+
187
+ Bounds only restrict scrolling. They do not prevent Game Objects from being placed outside the bounds, and they do not affect the viewport position.
188
+
189
+ ### Multiple Cameras
190
+
191
+ ```js
192
+ // Full-screen main camera
193
+ const main = this.cameras.main;
194
+
195
+ // Mini-map in top-right corner
196
+ const minimap = this.cameras.add(600, 0, 200, 150).setZoom(0.2).setName('minimap');
197
+ minimap.setScroll(0, 0);
198
+ minimap.setBackgroundColor('rgba(0,0,0,0.5)');
199
+
200
+ // HUD camera that doesn't scroll (ignores world objects, shows HUD layer only)
201
+ const hudCam = this.cameras.add(0, 0, 800, 600).setName('hud');
202
+ hudCam.setScroll(0, 0);
203
+
204
+ // Make the main camera ignore HUD objects
205
+ main.ignore(hudGroup);
206
+ // Make the HUD camera ignore world objects
207
+ hudCam.ignore(worldGroup);
208
+
209
+ // Find a camera by name
210
+ const found = this.cameras.getCamera('minimap');
211
+
212
+ // Remove a camera
213
+ this.cameras.remove(minimap);
214
+ ```
215
+
216
+ ### Camera Effects
217
+
218
+ All effects are on the `Camera` class (not `BaseCamera`). Each returns `this` for chaining. Effects that are already running will not restart unless you pass `force: true`.
219
+
220
+ #### Fade
221
+
222
+ ```js
223
+ // Fade out to black over 1 second
224
+ cam.fadeOut(1000);
225
+
226
+ // Fade out to red
227
+ cam.fadeOut(1000, 255, 0, 0);
228
+
229
+ // Fade in from black over 500ms
230
+ cam.fadeIn(500);
231
+
232
+ // Lower-level: fade (out direction) and fadeFrom (in direction)
233
+ // with a force parameter
234
+ cam.fade(1000, 0, 0, 0, true); // force start even if running
235
+ cam.fadeFrom(1000, 0, 0, 0, true);
236
+
237
+ // With per-frame callback
238
+ cam.fadeOut(1000, 0, 0, 0, (cam, progress) => {
239
+ // progress goes from 0 to 1
240
+ });
241
+ ```
242
+
243
+ Fade direction: `fadeOut` / `fade` goes transparent-to-color. `fadeIn` / `fadeFrom` goes color-to-transparent.
244
+
245
+ #### Flash
246
+
247
+ ```js
248
+ // White flash over 250ms (default)
249
+ cam.flash(250);
250
+
251
+ // Red flash over 500ms
252
+ cam.flash(500, 255, 0, 0);
253
+
254
+ // Full signature: flash(duration?, r?, g?, b?, force?, callback?, context?)
255
+ cam.flash(300, 255, 255, 255, true, (cam, progress) => {});
256
+ ```
257
+
258
+ #### Shake
259
+
260
+ ```js
261
+ // Default shake: 100ms at intensity 0.05
262
+ cam.shake(100);
263
+
264
+ // Stronger shake for 500ms
265
+ cam.shake(500, 0.02);
266
+
267
+ // Independent x/y intensity using a Vector2
268
+ cam.shake(300, new Phaser.Math.Vector2(0.1, 0.02));
269
+
270
+ // Full signature: shake(duration?, intensity?, force?, callback?, context?)
271
+ ```
272
+
273
+ The `intensity` value is a small float. The default 0.05 means the camera shifts up to 5% of the viewport size.
274
+
275
+ #### Pan
276
+
277
+ ```js
278
+ // Pan camera center to world coordinate (400, 300) over 2 seconds
279
+ cam.pan(400, 300, 2000);
280
+
281
+ // With easing
282
+ cam.pan(400, 300, 2000, 'Power2');
283
+
284
+ // Full signature: pan(x, y, duration?, ease?, force?, callback?, context?)
285
+ cam.pan(800, 600, 1500, 'Sine.easeInOut', false, (cam, progress, x, y) => {});
286
+ ```
287
+
288
+ Pan scrolls the camera so its viewport center finishes at the given world coordinate.
289
+
290
+ #### ZoomTo
291
+
292
+ ```js
293
+ // Animate zoom to 2x over 1 second
294
+ cam.zoomTo(2, 1000);
295
+
296
+ // With easing
297
+ cam.zoomTo(0.5, 2000, 'Cubic.easeOut');
298
+
299
+ // Full signature: zoomTo(zoom, duration?, ease?, force?, callback?, context?)
300
+ ```
301
+
302
+ #### RotateTo
303
+
304
+ ```js
305
+ // Rotate camera to 45 degrees (in radians) over 1 second
306
+ cam.rotateTo(Phaser.Math.DegToRad(45), false, 1000);
307
+
308
+ // Shortest path rotation
309
+ cam.rotateTo(Math.PI, true, 1500, 'Quad.easeInOut');
310
+
311
+ // Full signature: rotateTo(angle, shortestPath?, duration?, ease?, force?, callback?, context?)
312
+ ```
313
+
314
+ The angle is in **radians**. Set `shortestPath` to `true` to take the shortest rotation direction.
315
+
316
+ #### Reset All Effects
317
+
318
+ ```js
319
+ cam.resetFX(); // stops and resets all running effects (rotate, pan, shake, flash, fade)
320
+ ```
321
+
322
+ ### Keyboard Controls
323
+
324
+ Phaser provides two built-in camera control classes. Both require you to call `update(delta)` in your scene's `update` method.
325
+
326
+ #### FixedKeyControl
327
+
328
+ Moves at a fixed speed per frame. No smoothing.
329
+
330
+ ```js
331
+ // In create():
332
+ const cursors = this.input.keyboard.createCursorKeys();
333
+ this.camControl = new Phaser.Cameras.Controls.FixedKeyControl({
334
+ camera: this.cameras.main,
335
+ left: cursors.left,
336
+ right: cursors.right,
337
+ up: cursors.up,
338
+ down: cursors.down,
339
+ speed: 0.5 // can also be { x: 0.5, y: 0.3 }
340
+ });
341
+
342
+ // In update(time, delta):
343
+ this.camControl.update(delta);
344
+ ```
345
+
346
+ #### SmoothedKeyControl
347
+
348
+ Applies acceleration, drag, and max speed for smooth camera movement.
349
+
350
+ ```js
351
+ this.camControl = new Phaser.Cameras.Controls.SmoothedKeyControl({
352
+ camera: this.cameras.main,
353
+ left: cursors.left,
354
+ right: cursors.right,
355
+ up: cursors.up,
356
+ down: cursors.down,
357
+ zoomIn: this.input.keyboard.addKey('Q'),
358
+ zoomOut: this.input.keyboard.addKey('E'),
359
+ zoomSpeed: 0.02,
360
+ acceleration: 0.06,
361
+ drag: 0.0005,
362
+ maxSpeed: 1.0
363
+ });
364
+
365
+ // In update(time, delta):
366
+ this.camControl.update(delta);
367
+ ```
368
+
369
+ Both controls support `zoomIn` and `zoomOut` keys and a `zoomSpeed` config value.
370
+
371
+ ### Ignore Lists
372
+
373
+ The `ignore` method updates a Game Object's `cameraFilter` bitmask so the camera skips rendering it.
374
+
375
+ ```js
376
+ // Ignore a single object
377
+ cam.ignore(uiText);
378
+
379
+ // Ignore an array
380
+ cam.ignore([scoreText, livesIcon, pauseButton]);
381
+
382
+ // Ignore all children in a Group
383
+ cam.ignore(uiGroup);
384
+
385
+ // Ignore a Layer and all its children
386
+ cam.ignore(uiLayer);
387
+ ```
388
+
389
+ This is the primary mechanism for HUD-style setups: one camera ignores world objects, another ignores HUD objects.
390
+
391
+ ### Camera Deadzone
392
+
393
+ The deadzone defines a rectangular area around the follow target where the camera does not scroll. The camera only moves when the target leaves this rectangle.
394
+
395
+ ```js
396
+ // Set a deadzone of 200x150 pixels centered on the camera viewport
397
+ cam.setDeadzone(200, 150);
398
+
399
+ // Access the deadzone rectangle (read-only, updated internally)
400
+ console.log(cam.deadzone); // Phaser.Geom.Rectangle or null
401
+
402
+ // Remove the deadzone
403
+ cam.setDeadzone();
404
+ ```
405
+
406
+ ### World Point Conversion
407
+
408
+ Convert screen (pointer) coordinates to world coordinates, accounting for scroll, zoom, and rotation:
409
+
410
+ ```js
411
+ const worldPoint = cam.getWorldPoint(pointer.x, pointer.y);
412
+ // Reuse an output object to avoid allocation
413
+ const output = new Phaser.Math.Vector2();
414
+ cam.getWorldPoint(pointer.x, pointer.y, output);
415
+ ```
416
+
417
+ Essential when working with scrolled/zoomed cameras -- raw pointer coordinates are screen space, not world space.
418
+
419
+ ### Camera Render List
420
+
421
+ Each frame, `renderList` is populated with Game Objects visible to this camera. Rebuilt every frame.
422
+
423
+ ```js
424
+ const visible = cam.renderList; // array of GameObjects rendered this frame
425
+ ```
426
+
427
+ ### Force Composite (Offscreen Framebuffer)
428
+
429
+ Force the camera to render to an offscreen framebuffer. Required for `CaptureFrame` and similar features.
430
+
431
+ ```js
432
+ cam.setForceComposite(true); // enable offscreen framebuffer
433
+ cam.setForceComposite(false); // disable
434
+ ```
435
+
436
+ Filters enable framebuffer rendering automatically. Use `setForceComposite(true)` when you need it without filters.
437
+
438
+ ### Filters on Cameras (v4)
439
+
440
+ In Phaser 4, `Camera` has a `filters` property with two `FilterList` instances:
441
+
442
+ ```js
443
+ cam.filters.internal // FilterList -- applied by the system
444
+ cam.filters.external // FilterList -- for user-added filters
445
+ ```
446
+
447
+ Add post-processing effects to a camera the same way you add them to Game Objects:
448
+
449
+ ```js
450
+ // Add a blur filter to the camera
451
+ cam.filters.external.addBlur(1, 2);
452
+
453
+ // Add a glow
454
+ cam.filters.external.addGlow(0xff0000, 4, 0, false, 0.1, 10);
455
+
456
+ // Add a color matrix filter
457
+ const fx = cam.filters.external.addColorMatrix();
458
+ fx.grayscale();
459
+
460
+ // Remove all external filters
461
+ cam.filters.external.clear();
462
+ ```
463
+
464
+ Filters require WebGL. The camera must render via a framebuffer when filters are active. See `setForceComposite(true)` to explicitly enable this even without filters.
465
+
466
+ ## Events
467
+
468
+ Camera events are emitted on the Camera instance itself (it extends `EventEmitter`). Listen with `cam.on(event, handler)`.
469
+
470
+ | Event constant | Dispatched when |
471
+ |---|---|
472
+ | `Phaser.Cameras.Scene2D.Events.FADE_IN_START` | `fadeIn` / `fadeFrom` begins |
473
+ | `Phaser.Cameras.Scene2D.Events.FADE_IN_COMPLETE` | Fade-in finishes |
474
+ | `Phaser.Cameras.Scene2D.Events.FADE_OUT_START` | `fadeOut` / `fade` begins |
475
+ | `Phaser.Cameras.Scene2D.Events.FADE_OUT_COMPLETE` | Fade-out finishes |
476
+ | `Phaser.Cameras.Scene2D.Events.FLASH_START` | Flash begins |
477
+ | `Phaser.Cameras.Scene2D.Events.FLASH_COMPLETE` | Flash finishes |
478
+ | `Phaser.Cameras.Scene2D.Events.SHAKE_START` | Shake begins |
479
+ | `Phaser.Cameras.Scene2D.Events.SHAKE_COMPLETE` | Shake finishes |
480
+ | `Phaser.Cameras.Scene2D.Events.PAN_START` | Pan begins |
481
+ | `Phaser.Cameras.Scene2D.Events.PAN_COMPLETE` | Pan finishes |
482
+ | `Phaser.Cameras.Scene2D.Events.ZOOM_START` | Zoom effect begins |
483
+ | `Phaser.Cameras.Scene2D.Events.ZOOM_COMPLETE` | Zoom effect finishes |
484
+ | `Phaser.Cameras.Scene2D.Events.ROTATE_START` | RotateTo begins |
485
+ | `Phaser.Cameras.Scene2D.Events.ROTATE_COMPLETE` | RotateTo finishes |
486
+ | `Phaser.Cameras.Scene2D.Events.FOLLOW_UPDATE` | Camera updates its follow position (each frame while following). Args: `(camera, target)` |
487
+ | `Phaser.Cameras.Scene2D.Events.PRE_RENDER` | Before the camera renders |
488
+ | `Phaser.Cameras.Scene2D.Events.POST_RENDER` | After the camera renders |
489
+ | `Phaser.Cameras.Scene2D.Events.DESTROY` | Camera is destroyed |
490
+
491
+ ```js
492
+ cam.on(Phaser.Cameras.Scene2D.Events.FADE_OUT_COMPLETE, () => {
493
+ this.scene.start('GameOver');
494
+ });
495
+ ```
496
+
497
+ For detailed configuration options, API reference tables, and source file maps, see [the reference guide](references/REFERENCE..//SKILL.md).
@@ -0,0 +1,128 @@
1
+ # Cameras — Reference
2
+
3
+ > Detailed configuration, API tables, and source file maps for the cameras skill.
4
+
5
+ ## API Quick Reference
6
+
7
+ ### BaseCamera Properties (inherited by Camera)
8
+
9
+ | Property | Type | Default | Description |
10
+ |---|---|---|---|
11
+ | `scrollX` / `scrollY` | number | 0 | World position the camera is looking at |
12
+ | `zoomX` / `zoomY` | number | 1 | Zoom level per axis |
13
+ | `zoom` | number | 1 | Shortcut: sets/gets both zoomX and zoomY |
14
+ | `rotation` | number | 0 | Rotation in radians |
15
+ | `originX` / `originY` | number | 0.5 | Rotation origin within the viewport (0..1) |
16
+ | `x` / `y` | number | 0 | Viewport position on the canvas |
17
+ | `width` / `height` | number | game size | Viewport dimensions |
18
+ | `worldView` | Rectangle | -- | Read-only rect of visible world area |
19
+ | `midPoint` | Vector2 | -- | Read-only center of camera in world coords |
20
+ | `alpha` | number | 1 | Opacity of everything rendered by this camera |
21
+ | `visible` | boolean | true | Whether the camera renders at all |
22
+ | `backgroundColor` | Color | transparent | Background fill color |
23
+ | `transparent` | boolean | true | False when backgroundColor has alpha > 0 |
24
+ | `roundPixels` | boolean | false | Round positions to integers during render |
25
+ | `name` | string | '' | Optional name for lookup |
26
+ | `id` | number | bitmask | Assigned by manager for ignore-list filtering |
27
+ | `useBounds` | boolean | false | Whether scroll bounds are active |
28
+ | `inputEnabled` | boolean | true | Whether objects through this camera receive input |
29
+ | `disableCull` | boolean | false | Skip culling before input hit tests |
30
+ | `mask` | GeometryMask | null | Canvas-only mask. In WebGL, use filters instead. |
31
+ | `forceComposite` | boolean | false | Force framebuffer rendering (WebGL only, v4) |
32
+
33
+ ### BaseCamera Methods
34
+
35
+ | Method | Signature |
36
+ |---|---|
37
+ | `setScroll` | `(x, y?)` |
38
+ | `setZoom` | `(x?, y?)` |
39
+ | `setRotation` | `(radians?)` |
40
+ | `setAngle` | `(degrees?)` |
41
+ | `setPosition` | `(x, y?)` -- viewport position |
42
+ | `setSize` | `(width, height?)` -- viewport size |
43
+ | `setViewport` | `(x, y, width, height?)` -- position + size |
44
+ | `setOrigin` | `(x?, y?)` -- rotation origin |
45
+ | `setBounds` | `(x, y, width, height, centerOn?)` |
46
+ | `removeBounds` | `()` |
47
+ | `getBounds` | `(out?)` -- returns Rectangle copy |
48
+ | `centerOn` | `(x, y)` |
49
+ | `centerOnX` | `(x)` |
50
+ | `centerOnY` | `(y)` |
51
+ | `getScroll` | `(x, y, out?)` -- returns Vector2 |
52
+ | `getWorldPoint` | `(x, y, output?)` -- screen to world coords |
53
+ | `ignore` | `(entries)` -- GameObject, array, Group, or Layer |
54
+ | `setBackgroundColor` | `(color?)` |
55
+ | `setAlpha` | `(value?)` |
56
+ | `setVisible` | `(value)` |
57
+ | `setName` | `(value?)` |
58
+ | `setRoundPixels` | `(value)` |
59
+ | `setMask` | `(mask, fixedPosition?)` -- Canvas only |
60
+ | `clearMask` | `(destroyMask?)` |
61
+ | `setForceComposite` | `(value)` -- WebGL only, v4 |
62
+
63
+ ### Camera Methods (extends BaseCamera)
64
+
65
+ | Method | Signature |
66
+ |---|---|
67
+ | `startFollow` | `(target, roundPixels?, lerpX?, lerpY?, offsetX?, offsetY?)` |
68
+ | `stopFollow` | `()` |
69
+ | `setLerp` | `(x?, y?)` |
70
+ | `setFollowOffset` | `(x?, y?)` |
71
+ | `setDeadzone` | `(width?, height?)` -- omit args to clear |
72
+ | `fadeIn` | `(duration?, r?, g?, b?, callback?, context?)` |
73
+ | `fadeOut` | `(duration?, r?, g?, b?, callback?, context?)` |
74
+ | `fade` | `(duration?, r?, g?, b?, force?, callback?, context?)` |
75
+ | `fadeFrom` | `(duration?, r?, g?, b?, force?, callback?, context?)` |
76
+ | `flash` | `(duration?, r?, g?, b?, force?, callback?, context?)` |
77
+ | `shake` | `(duration?, intensity?, force?, callback?, context?)` |
78
+ | `pan` | `(x, y, duration?, ease?, force?, callback?, context?)` |
79
+ | `zoomTo` | `(zoom, duration?, ease?, force?, callback?, context?)` |
80
+ | `rotateTo` | `(angle, shortestPath?, duration?, ease?, force?, callback?, context?)` |
81
+ | `resetFX` | `()` |
82
+
83
+ ### Effect Handler Properties
84
+
85
+ Each effect is accessible as a property on Camera: `fadeEffect`, `flashEffect`, `shakeEffect`, `panEffect`, `zoomEffect`, `rotateToEffect`. All have `isRunning` (boolean) and `progress` (0..1) properties you can check.
86
+
87
+ ## Gotchas
88
+
89
+ 1. **`this.cameras` is the CameraManager, not an array.** The array of cameras is `this.cameras.cameras`. The main camera is `this.cameras.main`.
90
+
91
+ 2. **Viewport vs Scroll confusion.** `setPosition` / `setViewport` move the camera's rendering rectangle on screen. `setScroll` / `scrollX` / `scrollY` move what the camera is *looking at* in the world. These are independent.
92
+
93
+ 3. **Zoom of 0 will break rendering.** `setZoom(0)` is clamped to 0.001 internally, but avoid passing 0.
94
+
95
+ 4. **Effects do not restart by default.** Calling `cam.fade()` while a fade is running does nothing unless you pass `force: true`. The same applies to flash, shake, pan, zoomTo, and rotateTo.
96
+
97
+ 5. **`startFollow` snaps immediately on first call.** The camera jumps to the target position, then lerps from there. To avoid a visible snap, set scroll to the target position before calling `startFollow`.
98
+
99
+ 6. **Ignore list limit of 32 cameras.** Only the first 32 cameras created get unique bitmask IDs for `ignore()`. Camera 33+ gets ID 0 and cannot use Game Object exclusion.
100
+
101
+ 7. **`roundPixels` and non-integer zoom.** Setting `roundPixels: true` only works correctly when zoom is an integer. Non-integer zoom with `roundPixels` causes jitter.
102
+
103
+ 8. **Camera rotation does not rotate the viewport rectangle.** The viewport is always axis-aligned. Rotation is applied during rendering only.
104
+
105
+ 9. **Masks vs Filters in v4.** `setMask` only works with Canvas renderer (GeometryMask). For WebGL, use `cam.filters.external` (FilterList) instead.
106
+
107
+ 10. **Keyboard controls require manual `update` call.** Both `FixedKeyControl` and `SmoothedKeyControl` must have their `update(delta)` called in your Scene's `update` method -- they do not auto-update.
108
+
109
+ 11. **`pan()` overrides follow.** While a pan effect is running, the follow logic is paused. It resumes after the pan completes.
110
+
111
+ 12. **Camera setViewport caveats.** The viewport is limited to an axis-aligned rectangle, cannot be rotated, and filters/masks may render incorrectly with non-default viewports. For mini-cam effects, consider using `RenderTexture` or `DynamicTexture` instead.
112
+
113
+ ## Source File Map
114
+
115
+ | File | Description |
116
+ |---|---|
117
+ | `src/cameras/2d/CameraManager.js` | Scene plugin managing all cameras. Access via `this.cameras`. |
118
+ | `src/cameras/2d/BaseCamera.js` | Base class with scroll, zoom, bounds, viewport, ignore, mask, background. |
119
+ | `src/cameras/2d/Camera.js` | Extends BaseCamera. Adds effects (fade, flash, shake, pan, zoomTo, rotateTo), follow, deadzone, filters. |
120
+ | `src/cameras/2d/effects/Fade.js` | Fade effect implementation. |
121
+ | `src/cameras/2d/effects/Flash.js` | Flash effect implementation. |
122
+ | `src/cameras/2d/effects/Shake.js` | Shake effect implementation. |
123
+ | `src/cameras/2d/effects/Pan.js` | Pan effect implementation. |
124
+ | `src/cameras/2d/effects/Zoom.js` | Zoom effect implementation. |
125
+ | `src/cameras/2d/effects/RotateTo.js` | RotateTo effect implementation. |
126
+ | `src/cameras/2d/events/` | Event constant modules (FADE_IN_START, FLASH_COMPLETE, etc.). |
127
+ | `src/cameras/controls/FixedKeyControl.js` | Fixed-speed keyboard camera control. |
128
+ | `src/cameras/controls/SmoothedKeyControl.js` | Smoothed (acceleration/drag) keyboard camera control. |