@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,417 @@
1
+ ---
2
+ name: sprites-and-images
3
+ description: "Use this skill when creating Sprites or Images in Phaser 4. Covers factory methods, texture/frame selection, position, scale, rotation, tint, flip, alpha, origin, depth, and the component mixin system. Triggers on: Sprite, Image, this.add.sprite, this.add.image, texture, setTint, setAlpha."
4
+ ---
5
+
6
+ # Sprites and Images
7
+ > Creating and manipulating Sprite and Image game objects in Phaser 4 -- factory methods, texture/frame selection, the component mixin system, and common visual operations (position, scale, rotation, tint, flip, alpha, origin, depth).
8
+
9
+ **Key source paths:** `src/gameobjects/sprite/`, `src/gameobjects/image/`, `src/gameobjects/GameObject.js`, `src/gameobjects/components/`
10
+ **Related skills:** ../loading-assets/SKILL.md, ../animations/SKILL.md, ../physics-arcade/SKILL.md, ../game-object-components/SKILL.md
11
+
12
+ ## Quick Start
13
+
14
+ ```js
15
+ // In a Scene's create() method:
16
+
17
+ // Static image (no animation support, slightly cheaper)
18
+ const bg = this.add.image(400, 300, 'background');
19
+
20
+ // Sprite (supports animations)
21
+ const player = this.add.sprite(100, 200, 'player', 'idle-0');
22
+
23
+ // Common operations -- all methods return `this` for chaining
24
+ player.setPosition(200, 300);
25
+ player.setScale(2);
26
+ player.setAngle(45);
27
+ player.setTint(0xff0000);
28
+ player.setAlpha(0.8);
29
+ player.setOrigin(0, 1); // bottom-left
30
+ player.setDepth(10);
31
+ player.setFlip(true, false); // flip horizontally
32
+ player.setVisible(false);
33
+
34
+ // Chained
35
+ this.add.sprite(100, 100, 'coin')
36
+ .setScale(0.5)
37
+ .setTint(0xffff00)
38
+ .play('spin');
39
+ ```
40
+
41
+ ## Core Concepts
42
+
43
+ ### Sprite vs Image
44
+
45
+ Both extend `GameObject` and share the **same set of component mixins**. The only difference is that Sprite includes an `AnimationState` instance (`sprite.anims`) and animation convenience methods (`play`, `stop`, `chain`, etc.).
46
+
47
+ | Feature | Image | Sprite |
48
+ |---|---|---|
49
+ | Static texture display | Yes | Yes |
50
+ | Tint, alpha, flip, scale, rotate | Yes | Yes |
51
+ | Physics body | Yes | Yes |
52
+ | Input / hit area | Yes | Yes |
53
+ | Animation (`play`, `stop`, `chain`) | **No** | **Yes** |
54
+ | `preUpdate` called each frame | No | Yes (updates animation) |
55
+ | Added to Scene `updateList` | No | Yes |
56
+
57
+ **Rule of thumb:** Use `Image` for anything that does not need frame-by-frame animation. It skips the per-frame `preUpdate` cost and has a smaller API surface. Use `Sprite` only when you need the Animation component.
58
+
59
+ ### The Component Mixin System
60
+
61
+ Phaser builds Game Object classes by mixing component objects into the prototype. Both `Sprite` and `Image` share this identical Mixins array (sourced from `src/gameobjects/sprite/Sprite.js` and `src/gameobjects/image/Image.js`):
62
+
63
+ ```
64
+ Mixins: [
65
+ Components.Alpha,
66
+ Components.BlendMode,
67
+ Components.Depth,
68
+ Components.Flip,
69
+ Components.GetBounds,
70
+ Components.Lighting,
71
+ Components.Mask,
72
+ Components.Origin,
73
+ Components.RenderNodes,
74
+ Components.ScrollFactor,
75
+ Components.Size,
76
+ Components.TextureCrop,
77
+ Components.Tint,
78
+ Components.Transform,
79
+ Components.Visible,
80
+ SpriteRender / ImageRender // render-specific (differs per class)
81
+ ]
82
+ ```
83
+
84
+ The base `GameObject` class itself mixes in:
85
+ ```
86
+ Mixins: [
87
+ Components.Filters,
88
+ Components.RenderSteps
89
+ ]
90
+ ```
91
+
92
+ Each component adds specific properties and methods to every instance. For example, `Components.Transform` adds `x`, `y`, `scale`, `rotation`, `setPosition()`, etc. The full list of available components is in `src/gameobjects/components/index.js`.
93
+
94
+ **Key point for agents:** When you see a method like `setAlpha()` on a Sprite, it comes from `Components.Alpha`, not from the Sprite class itself. The component source file is the authoritative reference for that method's signature and behavior.
95
+
96
+ ### Texture and Frame
97
+
98
+ Both Sprite and Image use the `TextureCrop` component which provides:
99
+
100
+ - `texture` -- the `Phaser.Textures.Texture` instance
101
+ - `frame` -- the current `Phaser.Textures.Frame` instance
102
+ - `setTexture(key, frame)` -- change the texture (and optionally the frame)
103
+ - `setFrame(frame, updateSize, updateOrigin)` -- change only the frame
104
+ - `setCrop(x, y, width, height)` -- crop a rectangular region of the texture
105
+ - `isCropped` -- boolean, toggle cropping on/off after `setCrop`
106
+
107
+ The `texture` parameter in factory methods and constructors accepts either a string key (as registered in the Texture Manager) or a `Phaser.Textures.Texture` instance.
108
+
109
+ The `frame` parameter accepts a string name or numeric index into the texture's frame collection. If omitted, the base frame (frame 0 / `'__BASE'`) is used.
110
+
111
+ ```js
112
+ // Change texture at runtime
113
+ sprite.setTexture('enemies', 'goblin-walk-1');
114
+
115
+ // Change only the frame (must belong to current texture)
116
+ sprite.setFrame('goblin-walk-2');
117
+
118
+ // setFrame signature:
119
+ // setFrame(frame, updateSize=true, updateOrigin=true)
120
+ // Pass false to prevent automatic resize/origin recalculation
121
+ sprite.setFrame('small-frame', false, false);
122
+
123
+ // Crop to show only a 50x50 region starting at (10, 10)
124
+ sprite.setCrop(10, 10, 50, 50);
125
+ // Reset crop
126
+ sprite.setCrop();
127
+ ```
128
+
129
+ ## Common Patterns
130
+
131
+ ### Creating and Positioning
132
+
133
+ **Transform component** (`src/gameobjects/components/Transform.js`):
134
+
135
+ ```js
136
+ // Properties (all read/write)
137
+ sprite.x // horizontal position (default: 0)
138
+ sprite.y // vertical position (default: 0)
139
+ sprite.z // z position (does NOT control render order -- use depth)
140
+ sprite.w // w position
141
+
142
+ // Methods
143
+ sprite.setPosition(x, y, z, w) // y defaults to x if omitted
144
+ sprite.setRandomPosition(x, y, w, h) // random within area; defaults to game size
145
+ sprite.copyPosition(source) // copy from any {x, y} object
146
+ ```
147
+
148
+ **Size component** (`src/gameobjects/components/Size.js`):
149
+
150
+ ```js
151
+ sprite.width // native (un-scaled) width
152
+ sprite.height // native (un-scaled) height
153
+ sprite.displayWidth // scaled width (read/write -- setting adjusts scaleX)
154
+ sprite.displayHeight // scaled height (read/write -- setting adjusts scaleY)
155
+
156
+ sprite.setSize(width, height) // set internal size (not visual)
157
+ sprite.setDisplaySize(width, height) // set visual size (adjusts scale)
158
+ sprite.setSizeToFrame(frame) // reset size to match frame
159
+ ```
160
+
161
+ ### Scaling and Rotation
162
+
163
+ **Transform component** (continued):
164
+
165
+ ```js
166
+ // Scale properties
167
+ sprite.scale // uniform scale (getter returns average of scaleX+scaleY)
168
+ sprite.scaleX // horizontal scale (default: 1)
169
+ sprite.scaleY // vertical scale (default: 1)
170
+
171
+ // Scale methods
172
+ sprite.setScale(x, y) // y defaults to x if omitted
173
+
174
+ // Rotation properties
175
+ sprite.rotation // in radians (right-hand clockwise: 0=right, PI/2=down)
176
+ sprite.angle // in degrees (0=right, 90=down, 180/-180=left, -90=up)
177
+
178
+ // Rotation methods
179
+ sprite.setRotation(radians) // defaults to 0
180
+ sprite.setAngle(degrees) // defaults to 0
181
+ ```
182
+
183
+ ### Tinting and Alpha
184
+
185
+ **Tint component** (`src/gameobjects/components/Tint.js`) -- WebGL only:
186
+
187
+ ```js
188
+ // Properties
189
+ sprite.tint // overall tint (getter returns tintTopLeft)
190
+ sprite.tintTopLeft // default: 0xffffff
191
+ sprite.tintTopRight // default: 0xffffff
192
+ sprite.tintBottomLeft // default: 0xffffff
193
+ sprite.tintBottomRight // default: 0xffffff
194
+ sprite.tintMode // default: Phaser.TintModes.MULTIPLY
195
+ sprite.isTinted // read-only boolean
196
+
197
+ // Methods
198
+ sprite.setTint(topLeft, topRight, bottomLeft, bottomRight)
199
+ // If only topLeft given, applies uniformly to all four corners
200
+ sprite.setTintMode(mode) // Phaser.TintModes.MULTIPLY | FILL | ADD | SCREEN | OVERLAY | HARD_LIGHT
201
+ sprite.clearTint() // resets to 0xffffff + MULTIPLY mode
202
+ ```
203
+
204
+ **Phaser 4 change:** `setTintFill()` is removed. Use `setTint(color).setTintMode(Phaser.TintModes.FILL)` instead.
205
+
206
+ **Alpha component** (`src/gameobjects/components/Alpha.js`):
207
+
208
+ ```js
209
+ // Properties
210
+ sprite.alpha // global alpha 0-1 (default: 1)
211
+ sprite.alphaTopLeft // per-corner alpha (WebGL only)
212
+ sprite.alphaTopRight
213
+ sprite.alphaBottomLeft
214
+ sprite.alphaBottomRight
215
+
216
+ // Methods
217
+ sprite.setAlpha(topLeft, topRight, bottomLeft, bottomRight)
218
+ // If only topLeft given, applies uniformly to whole object
219
+ sprite.clearAlpha() // resets to 1 (fully opaque)
220
+ ```
221
+
222
+ Setting `alpha` to 0 clears the render flag so the object is not drawn. Setting it back to any non-zero value restores it.
223
+
224
+ ### Flipping
225
+
226
+ **Flip component** (`src/gameobjects/components/Flip.js`):
227
+
228
+ ```js
229
+ // Properties
230
+ sprite.flipX // boolean (default: false)
231
+ sprite.flipY // boolean (default: false)
232
+
233
+ // Methods
234
+ sprite.setFlipX(value) // set horizontal flip
235
+ sprite.setFlipY(value) // set vertical flip
236
+ sprite.setFlip(x, y) // set both at once
237
+ sprite.toggleFlipX() // invert current horizontal flip
238
+ sprite.toggleFlipY() // invert current vertical flip
239
+ sprite.resetFlip() // set both to false
240
+ ```
241
+
242
+ Flipping is a rendering toggle only. It does not affect physics bodies or hit areas. Flip occurs from the middle of the texture and does not change the scale value.
243
+
244
+ ### Origin and Depth
245
+
246
+ **Origin component** (`src/gameobjects/components/Origin.js`):
247
+
248
+ ```js
249
+ // Properties (normalized 0-1)
250
+ sprite.originX // default: 0.5 (center)
251
+ sprite.originY // default: 0.5 (center)
252
+ sprite.displayOriginX // pixel value (originX * width)
253
+ sprite.displayOriginY // pixel value (originY * height)
254
+
255
+ // Methods
256
+ sprite.setOrigin(x, y) // y defaults to x; defaults to 0.5
257
+ sprite.setDisplayOrigin(x, y) // set origin in pixels; y defaults to x
258
+ sprite.setOriginFromFrame() // use Frame pivot if set, else 0.5
259
+ sprite.updateDisplayOrigin() // recalculate pixel origin from normalized
260
+ ```
261
+
262
+ **Depth component** (`src/gameobjects/components/Depth.js`):
263
+
264
+ ```js
265
+ // Properties
266
+ sprite.depth // default: 0 (higher = renders on top)
267
+
268
+ // Methods
269
+ sprite.setDepth(value)
270
+ sprite.setToTop() // move to top of display list (no depth change)
271
+ sprite.setToBack() // move to back of display list (no depth change)
272
+ sprite.setAbove(gameObject) // position above another object in the list
273
+ sprite.setBelow(gameObject) // position below another object in the list
274
+ ```
275
+
276
+ Setting `depth` queues a depth sort in the Scene. The `setToTop`/`setToBack`/`setAbove`/`setBelow` methods change display list position without modifying the `depth` value.
277
+
278
+ ### Destroying Game Objects
279
+
280
+ ```js
281
+ sprite.destroy(); // removes from display list, update list, and cleans up
282
+ sprite.ignoreDestroy = true; // prevent destruction (you manage lifecycle manually)
283
+ sprite.isDestroyed // boolean, true after destroy() has been called
284
+ ```
285
+
286
+ For Sprites, `destroy()` also calls `this.anims.destroy()` to clean up the AnimationState.
287
+
288
+ ## Additional Components
289
+
290
+ **Visible** (`src/gameobjects/components/Visible.js`):
291
+ ```js
292
+ sprite.visible // boolean (default: true)
293
+ sprite.setVisible(value) // invisible objects skip rendering but still update
294
+ ```
295
+
296
+ **ScrollFactor** (`src/gameobjects/components/ScrollFactor.js`):
297
+ ```js
298
+ sprite.scrollFactorX // default: 1 (moves with camera)
299
+ sprite.scrollFactorY // default: 1
300
+ sprite.setScrollFactor(x, y) // 0 = fixed to camera; y defaults to x
301
+ ```
302
+
303
+ **BlendMode** (`src/gameobjects/components/BlendMode.js`):
304
+ ```js
305
+ sprite.blendMode // default: Phaser.BlendModes.NORMAL
306
+ sprite.setBlendMode(value) // Phaser.BlendModes.ADD, MULTIPLY, SCREEN, ERASE, etc.
307
+ ```
308
+
309
+ **Performance note:** Changing blend mode breaks WebGL batches. Group objects by blend mode when possible (e.g., render all ADD-mode sprites together) to minimize draw calls.
310
+
311
+ ## Factory Methods
312
+
313
+ ### this.add.sprite
314
+
315
+ Source: `src/gameobjects/sprite/SpriteFactory.js`
316
+
317
+ ```js
318
+ // Signature
319
+ this.add.sprite(x, y, texture, frame);
320
+ ```
321
+
322
+ | Param | Type | Required | Description |
323
+ |---|---|---|---|
324
+ | `x` | `number` | Yes | Horizontal position in world coordinates |
325
+ | `y` | `number` | Yes | Vertical position in world coordinates |
326
+ | `texture` | `string \| Phaser.Textures.Texture` | Yes | Texture key or Texture instance |
327
+ | `frame` | `string \| number` | No | Frame name or index within the texture |
328
+
329
+ Returns: `Phaser.GameObjects.Sprite`
330
+
331
+ Internally does: `this.displayList.add(new Sprite(this.scene, x, y, texture, frame))`
332
+
333
+ The Sprite constructor calls: `setTexture` -> `setPosition` -> `setSizeToFrame` -> `setOriginFromFrame` -> `initRenderNodes`.
334
+
335
+ ### this.add.image
336
+
337
+ Source: `src/gameobjects/image/ImageFactory.js`
338
+
339
+ ```js
340
+ // Signature
341
+ this.add.image(x, y, texture, frame);
342
+ ```
343
+
344
+ | Param | Type | Required | Description |
345
+ |---|---|---|---|
346
+ | `x` | `number` | Yes | Horizontal position in world coordinates |
347
+ | `y` | `number` | Yes | Vertical position in world coordinates |
348
+ | `texture` | `string \| Phaser.Textures.Texture` | Yes | Texture key or Texture instance |
349
+ | `frame` | `string \| number` | No | Frame name or index within the texture |
350
+
351
+ Returns: `Phaser.GameObjects.Image`
352
+
353
+ Internally does: `this.displayList.add(new Image(this.scene, x, y, texture, frame))`
354
+
355
+ The Image constructor calls the same init sequence as Sprite: `setTexture` -> `setPosition` -> `setSizeToFrame` -> `setOriginFromFrame` -> `initRenderNodes`.
356
+
357
+ ## Specialized Game Objects
358
+
359
+ ### NineSlice
360
+
361
+ Scalable UI panels with fixed-size corners and stretchable edges/center. Ideal for buttons, panels, and dialog boxes that need to resize without distorting borders.
362
+
363
+ ```js
364
+ // nineslice(x, y, texture, frame, width, height, leftWidth, rightWidth, topHeight, bottomHeight)
365
+ const panel = this.add.nineslice(400, 300, 'panel', null, 300, 200, 20, 20, 20, 20);
366
+
367
+ // Resize at runtime -- corners stay fixed, edges stretch
368
+ panel.setSize(500, 400);
369
+ ```
370
+
371
+ ### TileSprite
372
+
373
+ Repeating texture that fills an area. Supports atlas frames in v4 and a new `tileRotation` property.
374
+
375
+ ```js
376
+ const bg = this.add.tileSprite(400, 300, 800, 600, 'grass');
377
+
378
+ // Scroll the tile in update() for parallax backgrounds
379
+ bg.tilePositionX += 0.5;
380
+ bg.tilePositionY += 0.25;
381
+
382
+ // v4: rotate the tile pattern
383
+ bg.tileRotation = 0.1;
384
+ ```
385
+
386
+ ### Blitter
387
+
388
+ High-performance batched rendering for large numbers of static or semi-static sprites. Blitter children (Bobs) have no rotation, scale, or physics, but render significantly faster than individual Sprites.
389
+
390
+ ```js
391
+ const blitter = this.add.blitter(0, 0, 'particles');
392
+
393
+ // Create Bobs (lightweight display objects)
394
+ for (let i = 0; i < 1000; i++) {
395
+ const bob = blitter.create(
396
+ Phaser.Math.Between(0, 800),
397
+ Phaser.Math.Between(0, 600),
398
+ 'particle_01' // frame name within the texture
399
+ );
400
+ bob.setAlpha(Math.random());
401
+ }
402
+ ```
403
+
404
+ ### Video
405
+
406
+ Video playback as a game object with position, scale, and filter support.
407
+
408
+ ```js
409
+ // Load in preload:
410
+ this.load.video('intro', 'intro.mp4');
411
+
412
+ // Create in create:
413
+ const video = this.add.video(400, 300, 'intro');
414
+ video.play();
415
+ ```
416
+
417
+ For detailed configuration options, API reference tables, and source file maps, see [the reference guide](references/REFERENCE..//SKILL.md).
@@ -0,0 +1,160 @@
1
+ # Sprites And Images — Reference
2
+
3
+ > Detailed configuration, API tables, and source file maps for the sprites-and-images skill.
4
+
5
+ ## API Quick Reference
6
+
7
+ Most-used properties and methods across all mixed-in components. All setter methods return `this` for chaining.
8
+
9
+ ### Transform
10
+ | API | Type | Description |
11
+ |---|---|---|
12
+ | `x`, `y` | `number` | World position |
13
+ | `z`, `w` | `number` | Extra position axes (z does NOT control render order) |
14
+ | `scale` | `number` | Uniform scale (read: avg of scaleX+scaleY; write: sets both) |
15
+ | `scaleX`, `scaleY` | `number` | Per-axis scale |
16
+ | `angle` | `number` | Rotation in degrees (clockwise, 0=right) |
17
+ | `rotation` | `number` | Rotation in radians |
18
+ | `setPosition(x, y, z, w)` | method | Set position |
19
+ | `setScale(x, y)` | method | Set scale (y defaults to x) |
20
+ | `setRotation(radians)` | method | Set rotation in radians |
21
+ | `setAngle(degrees)` | method | Set rotation in degrees |
22
+ | `setRandomPosition(x, y, w, h)` | method | Randomize position within area |
23
+ | `copyPosition(source)` | method | Copy x/y/z/w from another object |
24
+
25
+ ### Alpha
26
+ | API | Type | Description |
27
+ |---|---|---|
28
+ | `alpha` | `number` | Global opacity 0-1 |
29
+ | `alphaTopLeft/TR/BL/BR` | `number` | Per-corner alpha (WebGL) |
30
+ | `setAlpha(tl, tr, bl, br)` | method | Set alpha (single value or per-corner) |
31
+ | `clearAlpha()` | method | Reset to fully opaque |
32
+
33
+ ### Tint (WebGL only)
34
+ | API | Type | Description |
35
+ |---|---|---|
36
+ | `tint` | `number` | Overall tint color (hex) |
37
+ | `tintTopLeft/TR/BL/BR` | `number` | Per-corner tint |
38
+ | `tintMode` | `number` | Tint blend mode |
39
+ | `isTinted` | `boolean` | Read-only: is any tint applied? |
40
+ | `setTint(tl, tr, bl, br)` | method | Set tint (single or per-corner) |
41
+ | `setTintMode(mode)` | method | Set tint blend mode |
42
+ | `clearTint()` | method | Reset tint to white + MULTIPLY |
43
+
44
+ ### Origin
45
+ | API | Type | Description |
46
+ |---|---|---|
47
+ | `originX`, `originY` | `number` | Normalized origin 0-1 |
48
+ | `displayOriginX`, `displayOriginY` | `number` | Pixel origin values |
49
+ | `setOrigin(x, y)` | method | Set normalized origin |
50
+ | `setDisplayOrigin(x, y)` | method | Set pixel origin |
51
+
52
+ ### Depth
53
+ | API | Type | Description |
54
+ |---|---|---|
55
+ | `depth` | `number` | Z-index for rendering |
56
+ | `setDepth(value)` | method | Set depth |
57
+ | `setToTop()` | method | Move to top of display list |
58
+ | `setToBack()` | method | Move to back of display list |
59
+ | `setAbove(gameObject)` | method | Position above another object |
60
+ | `setBelow(gameObject)` | method | Position below another object |
61
+
62
+ ### Flip
63
+ | API | Type | Description |
64
+ |---|---|---|
65
+ | `flipX`, `flipY` | `boolean` | Flip state |
66
+ | `setFlip(x, y)` | method | Set both flip values |
67
+ | `setFlipX(value)` | method | Set horizontal flip |
68
+ | `setFlipY(value)` | method | Set vertical flip |
69
+ | `toggleFlipX()`, `toggleFlipY()` | method | Toggle flip state |
70
+ | `resetFlip()` | method | Reset both to false |
71
+
72
+ ### Size
73
+ | API | Type | Description |
74
+ |---|---|---|
75
+ | `width`, `height` | `number` | Native (un-scaled) dimensions |
76
+ | `displayWidth`, `displayHeight` | `number` | Scaled dimensions (setting adjusts scale) |
77
+ | `setSize(w, h)` | method | Set internal size |
78
+ | `setDisplaySize(w, h)` | method | Set visual size (adjusts scale) |
79
+ | `setSizeToFrame(frame)` | method | Match size to frame |
80
+
81
+ ### Texture (TextureCrop)
82
+ | API | Type | Description |
83
+ |---|---|---|
84
+ | `texture` | `Texture` | Current texture reference |
85
+ | `frame` | `Frame` | Current frame reference |
86
+ | `setTexture(key, frame)` | method | Change texture and frame |
87
+ | `setFrame(frame, updateSize, updateOrigin)` | method | Change frame only |
88
+ | `setCrop(x, y, w, h)` | method | Crop visible region |
89
+ | `isCropped` | `boolean` | Toggle crop on/off |
90
+
91
+ ### Other
92
+ | API | Type | Description |
93
+ |---|---|---|
94
+ | `visible` / `setVisible(bool)` | | Visibility toggle |
95
+ | `scrollFactorX`, `scrollFactorY` / `setScrollFactor(x, y)` | | Camera scroll influence |
96
+ | `blendMode` / `setBlendMode(mode)` | | Blend mode |
97
+ | `destroy()` | method | Remove and clean up |
98
+ | `active` | `boolean` | Update-list processing flag (from GameObject) |
99
+ | `name` | `string` | Developer-assigned name (from GameObject) |
100
+ | `state` | `number\|string` | Developer-assigned state (from GameObject) |
101
+ | `setInteractive()` | method | Enable input (from GameObject) |
102
+ | `setData(key, value)` | method | Store custom data (from GameObject) |
103
+
104
+ ## Gotchas and Common Mistakes
105
+
106
+ 1. **Using Sprite when Image suffices.** Sprites are added to the Scene `updateList` and run `preUpdate` every frame for animation ticking. If you do not need animation, use `Image` instead to avoid unnecessary overhead.
107
+
108
+ 2. **`z` does not control render order.** The `z` property on Transform is a generic coordinate, not a z-index. Use `depth` or the display list ordering methods (`setToTop`, `setAbove`, etc.) to control what renders on top.
109
+
110
+ 3. **`scale` getter returns the average.** Reading `sprite.scale` returns `(scaleX + scaleY) / 2`. If scaleX and scaleY differ, this may be misleading. Check `scaleX`/`scaleY` individually when non-uniform scaling is used.
111
+
112
+ 4. **Setting scale to 0 hides the object.** Setting `scale`, `scaleX`, or `scaleY` to 0 clears a render flag. The object will not render until scale is set back to a non-zero value.
113
+
114
+ 5. **Setting alpha to 0 hides the object.** Same render-flag behavior as scale. Alpha of exactly 0 prevents rendering. Use `setVisible(false)` if you want to explicitly hide without changing alpha.
115
+
116
+ 6. **`setTintFill` is removed in Phaser 4.** Use `sprite.setTint(color).setTintMode(Phaser.TintModes.FILL)` instead. Calling `setTintFill()` will log an error to the console.
117
+
118
+ 7. **Tint and tintMode are now separate in Phaser 4.** In Phaser 3 they were set together. In Phaser 4, `setTint()` only sets the color; use `setTintMode()` to change the blend operation.
119
+
120
+ 8. **Flip does not affect physics bodies.** Flipping is a rendering toggle only. If your game logic depends on facing direction, track it separately from `flipX`/`flipY`.
121
+
122
+ 9. **`setFrame` resets size and origin by default.** Calling `setFrame('new-frame')` will resize the object and recalculate origin. Pass `false` for `updateSize` and `updateOrigin` to prevent this: `setFrame('f', false, false)`.
123
+
124
+ 10. **ScrollFactor and physics.** Scroll factor is a visual offset only. Physics collisions always use world position regardless of scroll factor. A scroll factor other than 1 can cause visual misalignment with physics bodies.
125
+
126
+ 11. **Origin default is center (0.5, 0.5).** Position coordinates refer to the center of the object by default. Set `setOrigin(0, 0)` if you want position to refer to the top-left corner.
127
+
128
+ 12. **Rotation direction.** Phaser uses right-hand clockwise rotation: 0 = right, 90 degrees (PI/2) = down, 180 = left, -90 (or 270) = up.
129
+
130
+ ## Source File Map
131
+
132
+ | File | Purpose |
133
+ |---|---|
134
+ | `src/gameobjects/sprite/Sprite.js` | Sprite class definition and Mixins array |
135
+ | `src/gameobjects/sprite/SpriteFactory.js` | `this.add.sprite` factory registration |
136
+ | `src/gameobjects/sprite/SpriteRender.js` | Sprite render methods |
137
+ | `src/gameobjects/image/Image.js` | Image class definition and Mixins array |
138
+ | `src/gameobjects/image/ImageFactory.js` | `this.add.image` factory registration |
139
+ | `src/gameobjects/image/ImageRender.js` | Image render methods |
140
+ | `src/gameobjects/GameObject.js` | Base class (scene, active, name, state, data, destroy) |
141
+ | `src/gameobjects/GameObjectFactory.js` | Factory registry (`this.add`) |
142
+ | `src/gameobjects/components/index.js` | Component module exports |
143
+ | `src/gameobjects/components/Transform.js` | Position, scale, rotation |
144
+ | `src/gameobjects/components/Alpha.js` | Alpha / opacity |
145
+ | `src/gameobjects/components/Tint.js` | Tint color and mode |
146
+ | `src/gameobjects/components/Origin.js` | Origin / anchor point |
147
+ | `src/gameobjects/components/Depth.js` | Depth / z-ordering |
148
+ | `src/gameobjects/components/Flip.js` | Horizontal/vertical flip |
149
+ | `src/gameobjects/components/Visible.js` | Visibility toggle |
150
+ | `src/gameobjects/components/Size.js` | Width, height, display size |
151
+ | `src/gameobjects/components/ScrollFactor.js` | Camera scroll factor |
152
+ | `src/gameobjects/components/BlendMode.js` | Blend mode |
153
+ | `src/gameobjects/components/TextureCrop.js` | Texture, frame, and crop |
154
+ | `src/gameobjects/components/GetBounds.js` | Bounding box calculations |
155
+ | `src/gameobjects/components/Mask.js` | Bitmap and geometry masks |
156
+ | `src/gameobjects/components/Lighting.js` | Normal map lighting |
157
+ | `src/gameobjects/components/RenderNodes.js` | WebGL render node setup |
158
+ | `src/gameobjects/components/Filters.js` | Post-processing filters |
159
+ | `src/gameobjects/components/RenderSteps.js` | Render step pipeline |
160
+ | `src/animations/AnimationState.js` | Animation state machine (Sprite only) |