@celljs/ta 4.9.1 → 4.11.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (673) hide show
  1. package/README.en.md +3 -1
  2. package/README.md +3 -1
  3. package/dist/cli.mjs +1753 -75
  4. package/dist/gateway.mjs +311 -25
  5. package/dist/pi/CHANGELOG.md +30 -0
  6. package/dist/pi/dist/bundle/chunks/anthropic-messages-CA3HHOL3.js +6 -0
  7. package/dist/pi/dist/bundle/chunks/{azure-openai-responses-FSC6BAW3.js → azure-openai-responses-76TWS6DT.js} +1 -1
  8. package/dist/pi/dist/bundle/chunks/bedrock-converse-stream.js +3 -3
  9. package/dist/pi/dist/bundle/chunks/chunk-4KSTFUIK.js +19 -0
  10. package/dist/pi/dist/bundle/chunks/chunk-4UNPP53I.js +55 -0
  11. package/dist/pi/dist/bundle/chunks/chunk-AUUCDC7R.js +4 -0
  12. package/dist/pi/dist/bundle/chunks/{chunk-V6KH5QG4.js → chunk-BAC3QPNW.js} +1 -1
  13. package/dist/pi/dist/bundle/chunks/{chunk-4EYXVSA5.js → chunk-FF6XOTWB.js} +9 -9
  14. package/dist/pi/dist/bundle/chunks/chunk-FMPAMX2W.js +82 -0
  15. package/dist/pi/dist/bundle/chunks/chunk-GFUN2N5K.js +2 -0
  16. package/dist/pi/dist/bundle/chunks/chunk-IEBK4HQA.js +2 -0
  17. package/dist/pi/dist/bundle/chunks/{chunk-C2WU32PX.js → chunk-IQUU5XIT.js} +1 -1
  18. package/dist/pi/dist/bundle/chunks/{chunk-EBFHJFEE.js → chunk-LQLJ7CDW.js} +1 -1
  19. package/dist/pi/dist/bundle/chunks/chunk-MMDXLZVS.js +30 -0
  20. package/dist/pi/dist/bundle/chunks/{chunk-GN3QYODH.js → chunk-QN4TOIZN.js} +1 -1
  21. package/dist/pi/dist/bundle/chunks/chunk-RKNK4Y6L.js +2 -0
  22. package/dist/pi/dist/bundle/chunks/{chunk-B46VJEHW.js → chunk-V7SLUK6A.js} +1 -1
  23. package/dist/pi/dist/bundle/chunks/chunk-VEJDBY3O.js +1237 -0
  24. package/dist/pi/dist/bundle/chunks/chunk-VKJQ6CME.js +8 -0
  25. package/dist/pi/dist/bundle/chunks/{chunk-3TGLJEWK.js → chunk-WL4TUXY7.js} +1 -1
  26. package/dist/pi/dist/bundle/chunks/{chunk-YZKQS34S.js → chunk-Y55SJART.js} +5 -1
  27. package/dist/pi/dist/bundle/chunks/{chunk-EOO47QGR.js → chunk-ZBIZYD6W.js} +1 -1
  28. package/dist/pi/dist/bundle/chunks/chunk-ZG74NES2.js +2 -0
  29. package/dist/pi/dist/bundle/chunks/chunk-ZGYS4UTC.js +2 -0
  30. package/dist/pi/dist/bundle/chunks/{cli-MCOUW5WS.js → cli-7RHMDOHL.js} +7 -7
  31. package/dist/pi/dist/bundle/chunks/{cloudflare-workers-ai-system-one-WLAFJSP6.js → cloudflare-workers-ai-system-one-U4J7D646.js} +1 -1
  32. package/dist/pi/dist/bundle/chunks/codemode-worker.js +2 -0
  33. package/dist/pi/dist/bundle/chunks/{easter-egg-3d-WMBNSJ4M.js → easter-egg-3d-GEVPKQF6.js} +1 -1
  34. package/dist/pi/dist/bundle/chunks/{execute-4CEBORGZ.js → execute-L2EEDV3L.js} +5 -3
  35. package/dist/pi/dist/bundle/chunks/github-copilot.js +1 -1
  36. package/dist/pi/dist/bundle/chunks/{google-generative-ai-INGKNW72.js → google-generative-ai-D5B6W47J.js} +1 -1
  37. package/dist/pi/dist/bundle/chunks/{google-vertex-IBTX6MBF.js → google-vertex-U4H5YDEW.js} +1 -1
  38. package/dist/pi/dist/bundle/chunks/{llama-cpp-classify-V5U3QKXI.js → llama-cpp-classify-EJXCQRUQ.js} +1 -1
  39. package/dist/pi/dist/bundle/chunks/{mistral-conversations-S4OWXIXQ.js → mistral-conversations-S277EKLB.js} +1 -1
  40. package/dist/pi/dist/bundle/chunks/openai-codex-responses-TEQRB65N.js +10 -0
  41. package/dist/pi/dist/bundle/chunks/{openai-completions-EJNYB6IX.js → openai-completions-HRZOSLBO.js} +3 -3
  42. package/dist/pi/dist/bundle/chunks/{openai-decisions-IXI34BYG.js → openai-decisions-F66BDLOM.js} +1 -1
  43. package/dist/pi/dist/bundle/chunks/openai-responses-BAKFWTGE.js +4 -0
  44. package/dist/pi/dist/bundle/chunks/{openrouter-images-PISKSFMS.js → openrouter-images-VXF5TVIK.js} +1 -1
  45. package/dist/pi/dist/bundle/chunks/{pi-messages-NORUKF4E.js → pi-messages-UBJKNDRN.js} +1 -1
  46. package/dist/pi/dist/bundle/chunks/{runtime-FQB7RU7U.js → runtime-J5ZSBGTX.js} +1 -1
  47. package/dist/pi/dist/bundle/chunks/{typesafe-system-one-CHVC2UUI.js → typesafe-system-one-56TEMIHL.js} +1 -1
  48. package/dist/pi/dist/bundle/chunks/virtual-modules-KITQRTYM.js +2 -0
  49. package/dist/pi/dist/bundle/cli-runtime.js +1 -1
  50. package/dist/pi/dist/bundle/index.js +1 -1
  51. package/dist/pi/dist/bundle/rpc-entry.js +1 -1
  52. package/dist/pi/docs/cli.md +14 -1
  53. package/dist/pi/docs/extensions.md +27 -7
  54. package/dist/pi/docs/keybindings.md +1 -1
  55. package/dist/pi/docs/llama-cpp.md +5 -8
  56. package/dist/pi/docs/models-configuration.md +6 -1
  57. package/dist/pi/docs/models.md +2 -1
  58. package/dist/pi/docs/prompt-templates.md +1 -1
  59. package/dist/pi/docs/providers.md +1 -1
  60. package/dist/pi/docs/rpc.md +4 -2
  61. package/dist/pi/docs/sessions.md +7 -1
  62. package/dist/pi/docs/settings.md +1 -1
  63. package/dist/pi/docs/tui.md +1 -1
  64. package/dist/pi/examples/extensions/custom-provider-anthropic/package-lock.json +2 -2
  65. package/dist/pi/examples/extensions/custom-provider-anthropic/package.json +1 -1
  66. package/dist/pi/examples/extensions/custom-provider-gitlab-duo/package.json +1 -1
  67. package/dist/pi/examples/extensions/gondolin/package-lock.json +2 -2
  68. package/dist/pi/examples/extensions/gondolin/package.json +1 -1
  69. package/dist/pi/examples/extensions/plan-mode/index.ts +23 -13
  70. package/dist/pi/examples/extensions/plan-mode/utils.ts +42 -16
  71. package/dist/pi/examples/extensions/subagent/README.md +14 -11
  72. package/dist/pi/examples/extensions/subagent/index.ts +392 -171
  73. package/dist/pi/examples/extensions/with-deps/package-lock.json +2 -2
  74. package/dist/pi/examples/extensions/with-deps/package.json +1 -1
  75. package/dist/pi/examples/tsconfig.json +63 -35
  76. package/dist/pi/package.json +1 -1
  77. package/dist/pi/packages/ta-agents/extension/index.mjs +185 -140
  78. package/dist/pi/packages/ta-agents/lib/acp-agent.js +30 -10
  79. package/dist/pi/packages/ta-agents/lib/agent-bindings.d.ts +2 -0
  80. package/dist/pi/packages/ta-agents/lib/agent-bindings.js +4 -0
  81. package/dist/pi/packages/ta-agents/lib/agent-catalog.d.ts +2 -2
  82. package/dist/pi/packages/ta-agents/lib/agent-catalog.js +4 -4
  83. package/dist/pi/packages/ta-agents/lib/agent-prompt.d.ts +6 -0
  84. package/dist/pi/packages/ta-agents/lib/agent-prompt.js +19 -0
  85. package/dist/pi/packages/ta-agents/lib/agent-session.d.ts +2 -0
  86. package/dist/pi/packages/ta-agents/lib/agent-session.js +2 -0
  87. package/dist/pi/packages/ta-agents/lib/agent-streamer.js +7 -0
  88. package/dist/pi/packages/ta-agents/lib/agent-tool.js +3 -2
  89. package/dist/pi/packages/ta-agents/lib/extension.js +15 -1
  90. package/dist/pi/packages/ta-agents/lib/texts.d.ts +4 -0
  91. package/dist/pi/packages/ta-agents/lib/texts.js +4 -0
  92. package/dist/pi/packages/ta-agents/package.json +3 -3
  93. package/dist/pi/packages/ta-bots/extension/index.mjs +31 -253
  94. package/dist/pi/packages/ta-bots/host/index.mjs +189 -1
  95. package/dist/pi/packages/ta-bots/lib/bots-protocol.d.ts +2 -0
  96. package/dist/pi/packages/ta-bots/lib/bots-protocol.js +3 -1
  97. package/dist/pi/packages/ta-bots/lib/bots-view.js +24 -12
  98. package/dist/pi/packages/ta-bots/lib/composer.js +1 -0
  99. package/dist/pi/packages/ta-bots/lib/extension.js +10 -17
  100. package/dist/pi/packages/ta-bots/lib/i18n.d.ts +1 -0
  101. package/dist/pi/packages/ta-bots/lib/i18n.js +2 -0
  102. package/dist/pi/packages/ta-bots/lib/index.js +2 -0
  103. package/dist/pi/packages/ta-bots/lib/style.d.ts +1 -1
  104. package/dist/pi/packages/ta-bots/lib/style.js +1 -0
  105. package/dist/pi/packages/ta-bots/lib/text-util.js +8 -1
  106. package/dist/pi/packages/ta-bots/lib/tool-line.d.ts +8 -0
  107. package/dist/pi/packages/ta-bots/lib/tool-line.js +19 -0
  108. package/dist/pi/packages/ta-bots/package.json +1 -1
  109. package/dist/pi/packages/ta-bots/web/index.js +47 -16
  110. package/dist/pi/packages/ta-changes/extension/index.mjs +23 -13
  111. package/dist/pi/packages/ta-changes/lib/card.js +18 -4
  112. package/dist/pi/packages/ta-changes/lib/changes-protocol.d.ts +0 -4
  113. package/dist/pi/packages/ta-changes/lib/changes-protocol.js +1 -5
  114. package/dist/pi/packages/ta-changes/lib/extension.js +5 -13
  115. package/dist/pi/packages/ta-changes/package.json +1 -1
  116. package/dist/pi/packages/ta-changes/web/index.js +16 -3
  117. package/dist/pi/packages/ta-channels/README.en.md +6 -5
  118. package/dist/pi/packages/ta-channels/README.md +6 -5
  119. package/dist/pi/packages/ta-channels/extension/index.mjs +350 -28
  120. package/dist/pi/packages/ta-channels/host/index.mjs +638 -43
  121. package/dist/pi/packages/ta-channels/lib/agent-cards.d.ts +19 -0
  122. package/dist/pi/packages/ta-channels/lib/agent-cards.js +58 -0
  123. package/dist/pi/packages/ta-channels/lib/agent-menu.d.ts +2 -2
  124. package/dist/pi/packages/ta-channels/lib/agent-menu.js +20 -6
  125. package/dist/pi/packages/ta-channels/lib/card.d.ts +27 -0
  126. package/dist/pi/packages/ta-channels/lib/card.js +178 -0
  127. package/dist/pi/packages/ta-channels/lib/channels-model.d.ts +65 -13
  128. package/dist/pi/packages/ta-channels/lib/channels-model.js +15 -6
  129. package/dist/pi/packages/ta-channels/lib/channels-util.d.ts +31 -2
  130. package/dist/pi/packages/ta-channels/lib/channels-util.js +100 -6
  131. package/dist/pi/packages/ta-channels/lib/channels.d.ts +28 -18
  132. package/dist/pi/packages/ta-channels/lib/channels.js +65 -65
  133. package/dist/pi/packages/ta-channels/lib/create.js +14 -4
  134. package/dist/pi/packages/ta-channels/lib/extension.d.ts +8 -0
  135. package/dist/pi/packages/ta-channels/lib/extension.js +104 -18
  136. package/dist/pi/packages/ta-channels/lib/faces.d.ts +2 -0
  137. package/dist/pi/packages/ta-channels/lib/faces.js +7 -1
  138. package/dist/pi/packages/ta-channels/lib/handoff-view.d.ts +19 -0
  139. package/dist/pi/packages/ta-channels/lib/handoff-view.js +113 -0
  140. package/dist/pi/packages/ta-channels/lib/handoff.d.ts +67 -0
  141. package/dist/pi/packages/ta-channels/lib/handoff.js +114 -0
  142. package/dist/pi/packages/ta-channels/lib/host.d.ts +1 -1
  143. package/dist/pi/packages/ta-channels/lib/host.js +1 -1
  144. package/dist/pi/packages/ta-channels/lib/i18n.d.ts +49 -8
  145. package/dist/pi/packages/ta-channels/lib/i18n.js +98 -16
  146. package/dist/pi/packages/ta-channels/lib/index.js +10 -1
  147. package/dist/pi/packages/ta-channels/lib/member-tools.d.ts +23 -0
  148. package/dist/pi/packages/ta-channels/lib/member-tools.js +56 -0
  149. package/dist/pi/packages/ta-channels/lib/members.js +6 -2
  150. package/dist/pi/packages/ta-channels/lib/more-menu.d.ts +3 -2
  151. package/dist/pi/packages/ta-channels/lib/more-menu.js +21 -29
  152. package/dist/pi/packages/ta-channels/lib/notice.d.ts +25 -0
  153. package/dist/pi/packages/ta-channels/lib/notice.js +101 -0
  154. package/dist/pi/packages/ta-channels/lib/room.js +26 -10
  155. package/dist/pi/packages/ta-channels/lib/sidebar.d.ts +1 -6
  156. package/dist/pi/packages/ta-channels/lib/sidebar.js +257 -84
  157. package/dist/pi/packages/ta-channels/lib/style.d.ts +1 -1
  158. package/dist/pi/packages/ta-channels/lib/style.js +151 -40
  159. package/dist/pi/packages/ta-channels/lib/tasks.js +3 -4
  160. package/dist/pi/packages/ta-channels/lib/team.d.ts +58 -10
  161. package/dist/pi/packages/ta-channels/lib/team.js +159 -38
  162. package/dist/pi/packages/ta-channels/lib/tool-lines.d.ts +22 -0
  163. package/dist/pi/packages/ta-channels/lib/tool-lines.js +113 -0
  164. package/dist/pi/packages/ta-channels/lib/views.d.ts +54 -1
  165. package/dist/pi/packages/ta-channels/lib/views.js +129 -1
  166. package/dist/pi/packages/ta-channels/package.json +2 -1
  167. package/dist/pi/packages/ta-channels/web/index.js +1792 -439
  168. package/dist/pi/packages/ta-computer-use/package.json +7 -2
  169. package/dist/pi/packages/ta-cron/README.en.md +6 -4
  170. package/dist/pi/packages/ta-cron/README.md +6 -4
  171. package/dist/pi/packages/ta-cron/extension/index.mjs +416 -44
  172. package/dist/pi/packages/ta-cron/host/index.mjs +30 -3
  173. package/dist/pi/packages/ta-cron/lib/chat-task.d.ts +48 -0
  174. package/dist/pi/packages/ta-cron/lib/chat-task.js +133 -0
  175. package/dist/pi/packages/ta-cron/lib/commands.d.ts +2 -1
  176. package/dist/pi/packages/ta-cron/lib/commands.js +10 -4
  177. package/dist/pi/packages/ta-cron/lib/composer.d.ts +11 -0
  178. package/dist/pi/packages/ta-cron/lib/composer.js +58 -0
  179. package/dist/pi/packages/ta-cron/lib/cron-protocol.d.ts +10 -3
  180. package/dist/pi/packages/ta-cron/lib/cron-protocol.js +6 -3
  181. package/dist/pi/packages/ta-cron/lib/editor.js +65 -30
  182. package/dist/pi/packages/ta-cron/lib/extension.d.ts +2 -0
  183. package/dist/pi/packages/ta-cron/lib/extension.js +33 -13
  184. package/dist/pi/packages/ta-cron/lib/i18n.d.ts +30 -1
  185. package/dist/pi/packages/ta-cron/lib/i18n.js +60 -2
  186. package/dist/pi/packages/ta-cron/lib/index.js +4 -0
  187. package/dist/pi/packages/ta-cron/lib/page.d.ts +38 -4
  188. package/dist/pi/packages/ta-cron/lib/page.js +131 -4
  189. package/dist/pi/packages/ta-cron/lib/react.d.ts +3 -0
  190. package/dist/pi/packages/ta-cron/lib/react.js +8 -0
  191. package/dist/pi/packages/ta-cron/lib/scheduler.js +3 -2
  192. package/dist/pi/packages/ta-cron/lib/style.d.ts +1 -1
  193. package/dist/pi/packages/ta-cron/lib/style.js +168 -50
  194. package/dist/pi/packages/ta-cron/lib/task-extension.d.ts +15 -0
  195. package/dist/pi/packages/ta-cron/lib/task-extension.js +56 -0
  196. package/dist/pi/packages/ta-cron/lib/task-util.d.ts +4 -0
  197. package/dist/pi/packages/ta-cron/lib/task-util.js +31 -1
  198. package/dist/pi/packages/ta-cron/lib/tasks-view.d.ts +4 -1
  199. package/dist/pi/packages/ta-cron/lib/tasks-view.js +107 -67
  200. package/dist/pi/packages/ta-cron/lib/tool-line.d.ts +9 -0
  201. package/dist/pi/packages/ta-cron/lib/tool-line.js +40 -0
  202. package/dist/pi/packages/ta-cron/lib/tool.d.ts +5 -1
  203. package/dist/pi/packages/ta-cron/lib/tool.js +6 -3
  204. package/dist/pi/packages/ta-cron/package.json +12 -1
  205. package/dist/pi/packages/ta-cron/web/index.js +1346 -415
  206. package/dist/pi/packages/ta-extensions/README.en.md +4 -2
  207. package/dist/pi/packages/ta-extensions/README.md +4 -2
  208. package/dist/pi/packages/ta-extensions/host/index.mjs +3 -2
  209. package/dist/pi/packages/ta-extensions/lib/actions.d.ts +4 -0
  210. package/dist/pi/packages/ta-extensions/lib/actions.js +16 -5
  211. package/dist/pi/packages/ta-extensions/lib/composer.d.ts +17 -0
  212. package/dist/pi/packages/ta-extensions/lib/composer.js +84 -0
  213. package/dist/pi/packages/ta-extensions/lib/extensions-util.d.ts +5 -0
  214. package/dist/pi/packages/ta-extensions/lib/extensions-util.js +10 -0
  215. package/dist/pi/packages/ta-extensions/lib/i18n.d.ts +9 -0
  216. package/dist/pi/packages/ta-extensions/lib/i18n.js +18 -0
  217. package/dist/pi/packages/ta-extensions/lib/index.js +4 -0
  218. package/dist/pi/packages/ta-extensions/lib/make-model.d.ts +20 -0
  219. package/dist/pi/packages/ta-extensions/lib/make-model.js +43 -0
  220. package/dist/pi/packages/ta-extensions/lib/market-parts.js +8 -2
  221. package/dist/pi/packages/ta-extensions/lib/market-style.d.ts +1 -1
  222. package/dist/pi/packages/ta-extensions/lib/market-style.js +4 -5
  223. package/dist/pi/packages/ta-extensions/lib/market-util.d.ts +2 -2
  224. package/dist/pi/packages/ta-extensions/lib/market-util.js +2 -2
  225. package/dist/pi/packages/ta-extensions/lib/page.js +52 -23
  226. package/dist/pi/packages/ta-extensions/lib/react.d.ts +3 -0
  227. package/dist/pi/packages/ta-extensions/lib/react.js +8 -0
  228. package/dist/pi/packages/ta-extensions/lib/settings.d.ts +4 -0
  229. package/dist/pi/packages/ta-extensions/lib/settings.js +44 -0
  230. package/dist/pi/packages/ta-extensions/lib/style.d.ts +1 -1
  231. package/dist/pi/packages/ta-extensions/lib/style.js +13 -6
  232. package/dist/pi/packages/ta-extensions/package.json +6 -1
  233. package/dist/pi/packages/ta-extensions/skills/ta-package/SKILL.md +25 -10
  234. package/dist/pi/packages/ta-extensions/web/index.js +459 -47
  235. package/dist/pi/packages/ta-games/README.en.md +47 -0
  236. package/dist/pi/packages/ta-games/README.md +47 -0
  237. package/dist/pi/packages/ta-games/host/index.mjs +65 -0
  238. package/dist/pi/packages/ta-games/lib/games-view.d.ts +16 -0
  239. package/dist/pi/packages/ta-games/lib/games-view.js +77 -0
  240. package/dist/pi/packages/ta-games/lib/host.d.ts +36 -0
  241. package/dist/pi/packages/ta-games/lib/host.js +83 -0
  242. package/dist/pi/packages/ta-games/lib/i18n.d.ts +35 -0
  243. package/dist/pi/packages/ta-games/lib/i18n.js +71 -0
  244. package/dist/pi/packages/ta-games/lib/ideas.d.ts +6 -0
  245. package/dist/pi/packages/ta-games/lib/ideas.js +62 -0
  246. package/dist/pi/packages/ta-games/lib/index.d.ts +7 -0
  247. package/dist/pi/packages/ta-games/lib/index.js +24 -0
  248. package/dist/pi/packages/ta-games/lib/make-game.d.ts +23 -0
  249. package/dist/pi/packages/ta-games/lib/make-game.js +67 -0
  250. package/dist/pi/packages/ta-games/lib/react.d.ts +11 -0
  251. package/dist/pi/packages/ta-games/lib/react.js +16 -0
  252. package/dist/pi/packages/ta-games/lib/style.d.ts +4 -0
  253. package/dist/pi/packages/ta-games/lib/style.js +33 -0
  254. package/dist/pi/packages/ta-games/package.json +60 -0
  255. package/dist/pi/packages/ta-games/skills/ta-game/SKILL.md +127 -0
  256. package/dist/pi/packages/ta-games/skills/ta-game/examples/dino-run/package.json +22 -0
  257. package/dist/pi/packages/ta-games/skills/ta-game/examples/dino-run/web.js +389 -0
  258. package/dist/pi/packages/ta-games/skills/ta-game/examples/stack/package.json +22 -0
  259. package/dist/pi/packages/ta-games/skills/ta-game/examples/stack/web.js +423 -0
  260. package/dist/pi/packages/ta-games/skills/ta-game/phaser/LICENSE.md +22 -0
  261. package/dist/pi/packages/ta-games/skills/ta-game/phaser/actions-and-utilities/SKILL.md +343 -0
  262. package/dist/pi/packages/ta-games/skills/ta-game/phaser/animations/SKILL.md +481 -0
  263. package/dist/pi/packages/ta-games/skills/ta-game/phaser/audio-and-sound/SKILL.md +453 -0
  264. package/dist/pi/packages/ta-games/skills/ta-game/phaser/cameras/SKILL.md +497 -0
  265. package/dist/pi/packages/ta-games/skills/ta-game/phaser/cameras/references/REFERENCE.md +128 -0
  266. package/dist/pi/packages/ta-games/skills/ta-game/phaser/curves-and-paths/SKILL.md +359 -0
  267. package/dist/pi/packages/ta-games/skills/ta-game/phaser/data-manager/SKILL.md +406 -0
  268. package/dist/pi/packages/ta-games/skills/ta-game/phaser/events-system/SKILL.md +497 -0
  269. package/dist/pi/packages/ta-games/skills/ta-game/phaser/filters-and-postfx/SKILL.md +449 -0
  270. package/dist/pi/packages/ta-games/skills/ta-game/phaser/game-object-components/SKILL.md +478 -0
  271. package/dist/pi/packages/ta-games/skills/ta-game/phaser/game-object-components/references/REFERENCE.md +76 -0
  272. package/dist/pi/packages/ta-games/skills/ta-game/phaser/game-setup-and-config/SKILL.md +485 -0
  273. package/dist/pi/packages/ta-games/skills/ta-game/phaser/geometry-and-math/SKILL.md +497 -0
  274. package/dist/pi/packages/ta-games/skills/ta-game/phaser/graphics-and-shapes/SKILL.md +473 -0
  275. package/dist/pi/packages/ta-games/skills/ta-game/phaser/groups-and-containers/SKILL.md +418 -0
  276. package/dist/pi/packages/ta-games/skills/ta-game/phaser/input-keyboard-mouse-touch/SKILL.md +500 -0
  277. package/dist/pi/packages/ta-games/skills/ta-game/phaser/input-keyboard-mouse-touch/references/REFERENCE.md +372 -0
  278. package/dist/pi/packages/ta-games/skills/ta-game/phaser/loading-assets/SKILL.md +474 -0
  279. package/dist/pi/packages/ta-games/skills/ta-game/phaser/loading-assets/references/REFERENCE.md +148 -0
  280. package/dist/pi/packages/ta-games/skills/ta-game/phaser/particles/SKILL.md +499 -0
  281. package/dist/pi/packages/ta-games/skills/ta-game/phaser/particles/references/REFERENCE.md +17 -0
  282. package/dist/pi/packages/ta-games/skills/ta-game/phaser/physics-arcade/SKILL.md +468 -0
  283. package/dist/pi/packages/ta-games/skills/ta-game/phaser/physics-matter/SKILL.md +499 -0
  284. package/dist/pi/packages/ta-games/skills/ta-game/phaser/render-textures/SKILL.md +441 -0
  285. package/dist/pi/packages/ta-games/skills/ta-game/phaser/scale-and-responsive/SKILL.md +371 -0
  286. package/dist/pi/packages/ta-games/skills/ta-game/phaser/scenes/SKILL.md +450 -0
  287. package/dist/pi/packages/ta-games/skills/ta-game/phaser/scenes/references/REFERENCE.md +78 -0
  288. package/dist/pi/packages/ta-games/skills/ta-game/phaser/sprites-and-images/SKILL.md +417 -0
  289. package/dist/pi/packages/ta-games/skills/ta-game/phaser/sprites-and-images/references/REFERENCE.md +160 -0
  290. package/dist/pi/packages/ta-games/skills/ta-game/phaser/text-and-bitmaptext/SKILL.md +460 -0
  291. package/dist/pi/packages/ta-games/skills/ta-game/phaser/tilemaps/SKILL.md +440 -0
  292. package/dist/pi/packages/ta-games/skills/ta-game/phaser/time-and-timers/SKILL.md +496 -0
  293. package/dist/pi/packages/ta-games/skills/ta-game/phaser/tweens/SKILL.md +414 -0
  294. package/dist/pi/packages/ta-games/skills/ta-game/phaser/v3-to-v4-migration/SKILL.md +430 -0
  295. package/dist/pi/packages/ta-games/skills/ta-game/phaser/v4-new-features/SKILL.md +384 -0
  296. package/dist/pi/packages/ta-games/skills/ta-game/phaser/v4-new-features/references/REFERENCE.md +69 -0
  297. package/dist/pi/packages/ta-games/web/index.js +431 -0
  298. package/dist/pi/packages/ta-glance/README.en.md +11 -0
  299. package/dist/pi/packages/ta-glance/README.md +11 -0
  300. package/dist/pi/packages/ta-glance/extension/index.mjs +67 -0
  301. package/dist/pi/packages/ta-glance/lib/card.d.ts +8 -0
  302. package/dist/pi/packages/ta-glance/lib/card.js +268 -0
  303. package/dist/pi/packages/ta-glance/lib/extension.d.ts +15 -0
  304. package/dist/pi/packages/ta-glance/lib/extension.js +24 -0
  305. package/dist/pi/packages/ta-glance/lib/glance-json.d.ts +9 -0
  306. package/dist/pi/packages/ta-glance/lib/glance-json.js +85 -0
  307. package/dist/pi/packages/ta-glance/lib/glance-prompt.d.ts +7 -0
  308. package/dist/pi/packages/ta-glance/lib/glance-prompt.js +34 -0
  309. package/dist/pi/packages/ta-glance/lib/glance-protocol.d.ts +98 -0
  310. package/dist/pi/packages/ta-glance/lib/glance-protocol.js +8 -0
  311. package/dist/pi/packages/ta-glance/lib/glance-spec.d.ts +6 -0
  312. package/dist/pi/packages/ta-glance/lib/glance-spec.js +204 -0
  313. package/dist/pi/packages/ta-glance/lib/glance-util.d.ts +3 -0
  314. package/dist/pi/packages/ta-glance/lib/glance-util.js +12 -0
  315. package/dist/pi/packages/ta-glance/lib/i18n.d.ts +22 -0
  316. package/dist/pi/packages/ta-glance/lib/i18n.js +41 -0
  317. package/dist/pi/packages/ta-glance/lib/index.d.ts +7 -0
  318. package/dist/pi/packages/ta-glance/lib/index.js +22 -0
  319. package/dist/pi/packages/ta-glance/lib/react.d.ts +8 -0
  320. package/dist/pi/packages/ta-glance/lib/react.js +8 -0
  321. package/dist/pi/packages/ta-glance/lib/style.d.ts +4 -0
  322. package/dist/pi/packages/ta-glance/lib/style.js +164 -0
  323. package/dist/pi/packages/ta-glance/package.json +53 -0
  324. package/dist/pi/packages/ta-glance/web/index.js +933 -0
  325. package/dist/pi/packages/ta-launcher/lib/actions.d.ts +4 -4
  326. package/dist/pi/packages/ta-launcher/lib/actions.js +7 -3
  327. package/dist/pi/packages/ta-launcher/lib/launcher-util.d.ts +7 -7
  328. package/dist/pi/packages/ta-launcher/lib/launcher-util.js +11 -8
  329. package/dist/pi/packages/ta-launcher/lib/launcher-view.js +13 -7
  330. package/dist/pi/packages/ta-launcher/lib/react.d.ts +3 -0
  331. package/dist/pi/packages/ta-launcher/lib/react.js +8 -0
  332. package/dist/pi/packages/ta-launcher/lib/style.d.ts +1 -1
  333. package/dist/pi/packages/ta-launcher/lib/style.js +6 -4
  334. package/dist/pi/packages/ta-launcher/package.json +1 -1
  335. package/dist/pi/packages/ta-launcher/web/index.js +34 -17
  336. package/dist/pi/packages/ta-manual/README.en.md +10 -0
  337. package/dist/pi/packages/ta-manual/README.md +10 -0
  338. package/dist/pi/packages/ta-manual/lib/i18n.d.ts +15 -0
  339. package/dist/pi/packages/ta-manual/lib/i18n.js +31 -0
  340. package/dist/pi/packages/ta-manual/lib/index.d.ts +7 -0
  341. package/dist/pi/packages/ta-manual/lib/index.js +24 -0
  342. package/dist/pi/packages/ta-manual/lib/manual-util.d.ts +18 -0
  343. package/dist/pi/packages/ta-manual/lib/manual-util.js +40 -0
  344. package/dist/pi/packages/ta-manual/lib/manual-view.d.ts +9 -0
  345. package/dist/pi/packages/ta-manual/lib/manual-view.js +81 -0
  346. package/dist/pi/packages/ta-manual/lib/pictures-a.d.ts +2 -0
  347. package/dist/pi/packages/ta-manual/lib/pictures-a.js +263 -0
  348. package/dist/pi/packages/ta-manual/lib/pictures-b.d.ts +2 -0
  349. package/dist/pi/packages/ta-manual/lib/pictures-b.js +216 -0
  350. package/dist/pi/packages/ta-manual/lib/pictures.d.ts +9 -0
  351. package/dist/pi/packages/ta-manual/lib/pictures.js +16 -0
  352. package/dist/pi/packages/ta-manual/lib/react.d.ts +8 -0
  353. package/dist/pi/packages/ta-manual/lib/react.js +8 -0
  354. package/dist/pi/packages/ta-manual/lib/scene.d.ts +68 -0
  355. package/dist/pi/packages/ta-manual/lib/scene.js +115 -0
  356. package/dist/pi/packages/ta-manual/lib/style.d.ts +4 -0
  357. package/dist/pi/packages/ta-manual/lib/style.js +47 -0
  358. package/dist/pi/packages/ta-manual/lib/topics.d.ts +42 -0
  359. package/dist/pi/packages/ta-manual/lib/topics.js +354 -0
  360. package/dist/pi/packages/ta-manual/package.json +54 -0
  361. package/dist/pi/packages/ta-manual/skills/ta-manual/SKILL.md +119 -0
  362. package/dist/pi/packages/ta-manual/web/index.js +2223 -0
  363. package/dist/pi/packages/ta-notify/README.en.md +29 -0
  364. package/dist/pi/packages/ta-notify/README.md +29 -0
  365. package/dist/pi/packages/ta-notify/extension/index.mjs +259 -0
  366. package/dist/pi/packages/ta-notify/host/index.mjs +163 -0
  367. package/dist/pi/packages/ta-notify/lib/ask-card.d.ts +9 -0
  368. package/dist/pi/packages/ta-notify/lib/ask-card.js +40 -0
  369. package/dist/pi/packages/ta-notify/lib/extension.d.ts +24 -0
  370. package/dist/pi/packages/ta-notify/lib/extension.js +102 -0
  371. package/dist/pi/packages/ta-notify/lib/host.d.ts +4 -0
  372. package/dist/pi/packages/ta-notify/lib/host.js +9 -0
  373. package/dist/pi/packages/ta-notify/lib/i18n.d.ts +31 -0
  374. package/dist/pi/packages/ta-notify/lib/i18n.js +63 -0
  375. package/dist/pi/packages/ta-notify/lib/index.d.ts +8 -0
  376. package/dist/pi/packages/ta-notify/lib/index.js +29 -0
  377. package/dist/pi/packages/ta-notify/lib/notify-protocol.d.ts +74 -0
  378. package/dist/pi/packages/ta-notify/lib/notify-protocol.js +23 -0
  379. package/dist/pi/packages/ta-notify/lib/notify-service.d.ts +21 -0
  380. package/dist/pi/packages/ta-notify/lib/notify-service.js +75 -0
  381. package/dist/pi/packages/ta-notify/lib/notify-util.d.ts +39 -0
  382. package/dist/pi/packages/ta-notify/lib/notify-util.js +119 -0
  383. package/dist/pi/packages/ta-notify/lib/react.d.ts +8 -0
  384. package/dist/pi/packages/ta-notify/lib/react.js +8 -0
  385. package/dist/pi/packages/ta-notify/lib/server-texts.d.ts +9 -0
  386. package/dist/pi/packages/ta-notify/lib/server-texts.js +22 -0
  387. package/dist/pi/packages/ta-notify/lib/settings.d.ts +8 -0
  388. package/dist/pi/packages/ta-notify/lib/settings.js +85 -0
  389. package/dist/pi/packages/ta-notify/lib/style.d.ts +4 -0
  390. package/dist/pi/packages/ta-notify/lib/style.js +29 -0
  391. package/dist/pi/packages/ta-notify/lib/tool-line.d.ts +9 -0
  392. package/dist/pi/packages/ta-notify/lib/tool-line.js +20 -0
  393. package/dist/pi/packages/ta-notify/lib/tool.d.ts +37 -0
  394. package/dist/pi/packages/ta-notify/lib/tool.js +46 -0
  395. package/dist/pi/packages/ta-notify/lib/watcher.d.ts +15 -0
  396. package/dist/pi/packages/ta-notify/lib/watcher.js +81 -0
  397. package/dist/pi/packages/ta-notify/package.json +55 -0
  398. package/dist/pi/packages/ta-notify/web/index.js +436 -0
  399. package/dist/pi/packages/ta-recall/README.en.md +19 -0
  400. package/dist/pi/packages/ta-recall/README.md +19 -0
  401. package/dist/pi/packages/ta-recall/extension/index.mjs +614 -0
  402. package/dist/pi/packages/ta-recall/host/index.mjs +820 -0
  403. package/dist/pi/packages/ta-recall/lib/brief-card.d.ts +21 -0
  404. package/dist/pi/packages/ta-recall/lib/brief-card.js +67 -0
  405. package/dist/pi/packages/ta-recall/lib/brief-home.d.ts +49 -0
  406. package/dist/pi/packages/ta-recall/lib/brief-home.js +143 -0
  407. package/dist/pi/packages/ta-recall/lib/brief-seen.d.ts +9 -0
  408. package/dist/pi/packages/ta-recall/lib/brief-seen.js +26 -0
  409. package/dist/pi/packages/ta-recall/lib/brief-util.d.ts +64 -0
  410. package/dist/pi/packages/ta-recall/lib/brief-util.js +179 -0
  411. package/dist/pi/packages/ta-recall/lib/chat-icons.d.ts +8 -0
  412. package/dist/pi/packages/ta-recall/lib/chat-icons.js +56 -0
  413. package/dist/pi/packages/ta-recall/lib/composer.d.ts +7 -0
  414. package/dist/pi/packages/ta-recall/lib/composer.js +38 -0
  415. package/dist/pi/packages/ta-recall/lib/conversation-index.d.ts +25 -0
  416. package/dist/pi/packages/ta-recall/lib/conversation-index.js +72 -0
  417. package/dist/pi/packages/ta-recall/lib/conversation-util.d.ts +16 -0
  418. package/dist/pi/packages/ta-recall/lib/conversation-util.js +109 -0
  419. package/dist/pi/packages/ta-recall/lib/conversations.d.ts +11 -0
  420. package/dist/pi/packages/ta-recall/lib/conversations.js +46 -0
  421. package/dist/pi/packages/ta-recall/lib/extension.d.ts +24 -0
  422. package/dist/pi/packages/ta-recall/lib/extension.js +131 -0
  423. package/dist/pi/packages/ta-recall/lib/host.d.ts +4 -0
  424. package/dist/pi/packages/ta-recall/lib/host.js +11 -0
  425. package/dist/pi/packages/ta-recall/lib/i18n.d.ts +41 -0
  426. package/dist/pi/packages/ta-recall/lib/i18n.js +83 -0
  427. package/dist/pi/packages/ta-recall/lib/index.d.ts +9 -0
  428. package/dist/pi/packages/ta-recall/lib/index.js +45 -0
  429. package/dist/pi/packages/ta-recall/lib/react.d.ts +11 -0
  430. package/dist/pi/packages/ta-recall/lib/react.js +16 -0
  431. package/dist/pi/packages/ta-recall/lib/recall-protocol.d.ts +186 -0
  432. package/dist/pi/packages/ta-recall/lib/recall-protocol.js +60 -0
  433. package/dist/pi/packages/ta-recall/lib/recall-service.d.ts +42 -0
  434. package/dist/pi/packages/ta-recall/lib/recall-service.js +241 -0
  435. package/dist/pi/packages/ta-recall/lib/search-source.d.ts +7 -0
  436. package/dist/pi/packages/ta-recall/lib/search-source.js +49 -0
  437. package/dist/pi/packages/ta-recall/lib/search-util.d.ts +30 -0
  438. package/dist/pi/packages/ta-recall/lib/search-util.js +167 -0
  439. package/dist/pi/packages/ta-recall/lib/server-texts.d.ts +7 -0
  440. package/dist/pi/packages/ta-recall/lib/server-texts.js +17 -0
  441. package/dist/pi/packages/ta-recall/lib/settings.d.ts +4 -0
  442. package/dist/pi/packages/ta-recall/lib/settings.js +77 -0
  443. package/dist/pi/packages/ta-recall/lib/skill-card.d.ts +9 -0
  444. package/dist/pi/packages/ta-recall/lib/skill-card.js +51 -0
  445. package/dist/pi/packages/ta-recall/lib/skill-util.d.ts +19 -0
  446. package/dist/pi/packages/ta-recall/lib/skill-util.js +110 -0
  447. package/dist/pi/packages/ta-recall/lib/stored.d.ts +5 -0
  448. package/dist/pi/packages/ta-recall/lib/stored.js +28 -0
  449. package/dist/pi/packages/ta-recall/lib/style.d.ts +4 -0
  450. package/dist/pi/packages/ta-recall/lib/style.js +48 -0
  451. package/dist/pi/packages/ta-recall/lib/tool-line.d.ts +10 -0
  452. package/dist/pi/packages/ta-recall/lib/tool-line.js +23 -0
  453. package/dist/pi/packages/ta-recall/lib/tool.d.ts +63 -0
  454. package/dist/pi/packages/ta-recall/lib/tool.js +71 -0
  455. package/dist/pi/packages/ta-recall/package.json +55 -0
  456. package/dist/pi/packages/ta-recall/web/index.js +1038 -0
  457. package/dist/pi/packages/ta-rooms/README.en.md +23 -0
  458. package/dist/pi/packages/ta-rooms/README.md +23 -0
  459. package/dist/pi/packages/ta-rooms/lib/dialogs.d.ts +39 -0
  460. package/dist/pi/packages/ta-rooms/lib/dialogs.js +235 -0
  461. package/dist/pi/packages/ta-rooms/lib/i18n.d.ts +101 -0
  462. package/dist/pi/packages/ta-rooms/lib/i18n.js +203 -0
  463. package/dist/pi/packages/ta-rooms/lib/index.d.ts +9 -0
  464. package/dist/pi/packages/ta-rooms/lib/index.js +85 -0
  465. package/dist/pi/packages/ta-rooms/lib/members-view.d.ts +3 -0
  466. package/dist/pi/packages/ta-rooms/lib/members-view.js +64 -0
  467. package/dist/pi/packages/ta-rooms/lib/page.d.ts +105 -0
  468. package/dist/pi/packages/ta-rooms/lib/page.js +306 -0
  469. package/dist/pi/packages/ta-rooms/lib/react.d.ts +8 -0
  470. package/dist/pi/packages/ta-rooms/lib/react.js +8 -0
  471. package/dist/pi/packages/ta-rooms/lib/room-view.d.ts +17 -0
  472. package/dist/pi/packages/ta-rooms/lib/room-view.js +150 -0
  473. package/dist/pi/packages/ta-rooms/lib/rooms-page.d.ts +8 -0
  474. package/dist/pi/packages/ta-rooms/lib/rooms-page.js +174 -0
  475. package/dist/pi/packages/ta-rooms/lib/style.d.ts +4 -0
  476. package/dist/pi/packages/ta-rooms/lib/style.js +154 -0
  477. package/dist/pi/packages/ta-rooms/package.json +50 -0
  478. package/dist/pi/packages/ta-rooms/web/index.js +1932 -0
  479. package/dist/pi/packages/ta-share/README.en.md +27 -0
  480. package/dist/pi/packages/ta-share/README.md +27 -0
  481. package/dist/pi/packages/ta-share/extension/index.mjs +184 -0
  482. package/dist/pi/packages/ta-share/host/index.mjs +364 -0
  483. package/dist/pi/packages/ta-share/lib/extension.d.ts +15 -0
  484. package/dist/pi/packages/ta-share/lib/extension.js +115 -0
  485. package/dist/pi/packages/ta-share/lib/host.d.ts +4 -0
  486. package/dist/pi/packages/ta-share/lib/host.js +9 -0
  487. package/dist/pi/packages/ta-share/lib/i18n.d.ts +106 -0
  488. package/dist/pi/packages/ta-share/lib/i18n.js +213 -0
  489. package/dist/pi/packages/ta-share/lib/index.d.ts +9 -0
  490. package/dist/pi/packages/ta-share/lib/index.js +77 -0
  491. package/dist/pi/packages/ta-share/lib/page.d.ts +48 -0
  492. package/dist/pi/packages/ta-share/lib/page.js +105 -0
  493. package/dist/pi/packages/ta-share/lib/react.d.ts +8 -0
  494. package/dist/pi/packages/ta-share/lib/react.js +8 -0
  495. package/dist/pi/packages/ta-share/lib/server-texts.d.ts +14 -0
  496. package/dist/pi/packages/ta-share/lib/server-texts.js +52 -0
  497. package/dist/pi/packages/ta-share/lib/share-dialog.d.ts +18 -0
  498. package/dist/pi/packages/ta-share/lib/share-dialog.js +233 -0
  499. package/dist/pi/packages/ta-share/lib/share-protocol.d.ts +86 -0
  500. package/dist/pi/packages/ta-share/lib/share-protocol.js +30 -0
  501. package/dist/pi/packages/ta-share/lib/share-service.d.ts +50 -0
  502. package/dist/pi/packages/ta-share/lib/share-service.js +130 -0
  503. package/dist/pi/packages/ta-share/lib/shared-view.d.ts +18 -0
  504. package/dist/pi/packages/ta-share/lib/shared-view.js +225 -0
  505. package/dist/pi/packages/ta-share/lib/shares-page.d.ts +3 -0
  506. package/dist/pi/packages/ta-share/lib/shares-page.js +54 -0
  507. package/dist/pi/packages/ta-share/lib/snapshot.d.ts +30 -0
  508. package/dist/pi/packages/ta-share/lib/snapshot.js +195 -0
  509. package/dist/pi/packages/ta-share/lib/style.d.ts +4 -0
  510. package/dist/pi/packages/ta-share/lib/style.js +111 -0
  511. package/dist/pi/packages/ta-share/package.json +56 -0
  512. package/dist/pi/packages/ta-share/web/index.js +1197 -0
  513. package/dist/pi/packages/ta-workspace/README.md +2 -2
  514. package/dist/pi/packages/ta-workspace/README.zh-cn.md +2 -2
  515. package/dist/pi/packages/ta-workspace/lib/browser-common.d.ts +1 -1
  516. package/dist/pi/packages/ta-workspace/lib/browser-common.js +29 -30
  517. package/dist/pi/packages/ta-workspace/lib/browser-tool-line.d.ts +15 -0
  518. package/dist/pi/packages/ta-workspace/lib/browser-tool-line.js +70 -0
  519. package/dist/pi/packages/ta-workspace/lib/bytes.d.ts +11 -0
  520. package/dist/pi/packages/ta-workspace/lib/bytes.js +40 -0
  521. package/dist/pi/packages/ta-workspace/lib/common.d.ts +2 -1
  522. package/dist/pi/packages/ta-workspace/lib/common.js +15 -37
  523. package/dist/pi/packages/ta-workspace/lib/editors.js +40 -4
  524. package/dist/pi/packages/ta-workspace/lib/i18n.d.ts +14 -4
  525. package/dist/pi/packages/ta-workspace/lib/i18n.js +31 -11
  526. package/dist/pi/packages/ta-workspace/lib/index.js +17 -0
  527. package/dist/pi/packages/ta-workspace/lib/launcher.d.ts +9 -0
  528. package/dist/pi/packages/ta-workspace/lib/launcher.js +39 -0
  529. package/dist/pi/packages/ta-workspace/lib/preview.d.ts +22 -3
  530. package/dist/pi/packages/ta-workspace/lib/preview.js +150 -22
  531. package/dist/pi/packages/ta-workspace/lib/style.d.ts +1 -1
  532. package/dist/pi/packages/ta-workspace/lib/style.js +70 -41
  533. package/dist/pi/packages/ta-workspace/lib/terminal-sessions.d.ts +15 -4
  534. package/dist/pi/packages/ta-workspace/lib/terminal-sessions.js +31 -9
  535. package/dist/pi/packages/ta-workspace/lib/terminal.d.ts +3 -2
  536. package/dist/pi/packages/ta-workspace/lib/terminal.js +51 -21
  537. package/dist/pi/packages/ta-workspace/lib/util/keys.d.ts +18 -0
  538. package/dist/pi/packages/ta-workspace/lib/util/keys.js +23 -0
  539. package/dist/pi/packages/ta-workspace/lib/util/preview.d.ts +46 -0
  540. package/dist/pi/packages/ta-workspace/lib/util/preview.js +106 -1
  541. package/dist/pi/packages/ta-workspace/lib/util/terminal.d.ts +5 -0
  542. package/dist/pi/packages/ta-workspace/lib/util/terminal.js +14 -0
  543. package/dist/pi/packages/ta-workspace/package.json +1 -1
  544. package/dist/pi/packages/ta-workspace/web/index.js +1032 -382
  545. package/dist/public/assets/OrbitControls-DVf70a7w.js +1 -0
  546. package/dist/public/assets/{abnfDiagram-S7VZAUFO-EVMX_yOb.js → abnfDiagram-S7VZAUFO-D9uU0Tx2.js} +1 -1
  547. package/dist/public/assets/{architecture-WOLXFQ4H-CDgbgZ_o.js → architecture-WOLXFQ4H-f7Nm7EIo.js} +1 -1
  548. package/dist/public/assets/{architectureDiagram-YGSQEFNW-dHreaCWz.js → architectureDiagram-YGSQEFNW-DSAqlcms.js} +1 -1
  549. package/dist/public/assets/{blockDiagram-APKKGZFW-D6FhzBDq.js → blockDiagram-APKKGZFW-C0lPIW9g.js} +1 -1
  550. package/dist/public/assets/browser-WLpgVYno.js +12 -0
  551. package/dist/public/assets/{c4Diagram-KJ2TOQU5-BFpcr8Cs.js → c4Diagram-KJ2TOQU5-CDcZ7mJq.js} +1 -1
  552. package/dist/public/assets/{chunk-6MUBBAK2-BczXkMV-.js → chunk-6MUBBAK2-CXPuyqPL.js} +1 -1
  553. package/dist/public/assets/{chunk-AXFCVDMN-CjJsv3jB.js → chunk-AXFCVDMN-Du6JRX1x.js} +1 -1
  554. package/dist/public/assets/{chunk-BG4553SI-FBaleaLz.js → chunk-BG4553SI-D592E55X.js} +1 -1
  555. package/dist/public/assets/{chunk-DQASFODM-BFdXY5sX.js → chunk-DQASFODM-BW2r2SL4.js} +1 -1
  556. package/dist/public/assets/{chunk-HFQBQIA3-C5cwK-Fg.js → chunk-HFQBQIA3-C3yoe54R.js} +1 -1
  557. package/dist/public/assets/{chunk-KQLB2F66-BUek3IRk.js → chunk-KQLB2F66-DF8gfYCy.js} +1 -1
  558. package/dist/public/assets/{chunk-KS47KZWR-BxsYBzt6.js → chunk-KS47KZWR-C8CRMTv1.js} +1 -1
  559. package/dist/public/assets/{chunk-LEVMRMFU-Bdcwz9fS.js → chunk-LEVMRMFU-BDcMKiwj.js} +1 -1
  560. package/dist/public/assets/{chunk-M57EVK23-kkpP5oug.js → chunk-M57EVK23-CKJPBygc.js} +1 -1
  561. package/dist/public/assets/{chunk-OY52VR5R-CFhQgxmD.js → chunk-OY52VR5R-B3ZWH07L.js} +1 -1
  562. package/dist/public/assets/{chunk-QB3YPZ4I-BVXqu0eC.js → chunk-QB3YPZ4I-DI-z4UPL.js} +1 -1
  563. package/dist/public/assets/{chunk-R3KSYZAL-B7SUqqLI.js → chunk-R3KSYZAL-Bg4-haAc.js} +1 -1
  564. package/dist/public/assets/{chunk-STOXU5M4-B3abfbnH.js → chunk-STOXU5M4-l_SHib3p.js} +1 -1
  565. package/dist/public/assets/{chunk-TU62E6Q5-C9NqnUav.js → chunk-TU62E6Q5-BINu9tIm.js} +1 -1
  566. package/dist/public/assets/{chunk-X4PVCEUW-BeLfETDx.js → chunk-X4PVCEUW-BQn-mvV5.js} +1 -1
  567. package/dist/public/assets/{chunk-XXDRQBXY-DXai1i8p.js → chunk-XXDRQBXY-uvpAu0Ys.js} +1 -1
  568. package/dist/public/assets/{classDiagram-v2-L25IHNXF-Zj6ne_tC.js → classDiagram-v2-L25IHNXF-BIowooW1.js} +1 -1
  569. package/dist/public/assets/{cose-bilkent-JH36ORCC-C0-TjqfJ.js → cose-bilkent-JH36ORCC-BTyx1Mh2.js} +1 -1
  570. package/dist/public/assets/cynefin-EF2NZ3EQ-Dg54eFzZ.js +1 -0
  571. package/dist/public/assets/{cynefinDiagram-L36ESFBY-BnqxfzPa.js → cynefinDiagram-L36ESFBY-D64EU9I0.js} +1 -1
  572. package/dist/public/assets/{d3-selection-DfFLTR9d.js → d3-selection-CN9k6_B9.js} +1 -1
  573. package/dist/public/assets/{dagre-SPEB5RXH-kI17e5cH.js → dagre-SPEB5RXH-FCbz2-Kk.js} +1 -1
  574. package/dist/public/assets/{diagram-3B7GL73J-DgPjeLA5.js → diagram-3B7GL73J-OhHUSI7j.js} +1 -1
  575. package/dist/public/assets/{diagram-DNEMPZML-CRhPfa0I.js → diagram-DNEMPZML-Be4xMtp6.js} +1 -1
  576. package/dist/public/assets/{diagram-L3MUGCDN-ExuTg12b.js → diagram-L3MUGCDN-CmKSs3aG.js} +1 -1
  577. package/dist/public/assets/{diagram-LA4NIPWU-Dgx5xNiY.js → diagram-LA4NIPWU-D1C32rMN.js} +1 -1
  578. package/dist/public/assets/{diagram-MHCOC4E2-BuifkUTl.js → diagram-MHCOC4E2-BjoE6JXs.js} +1 -1
  579. package/dist/public/assets/{diagram-XPFHEONP-CFEaBo7z.js → diagram-XPFHEONP-B22k4v8R.js} +1 -1
  580. package/dist/public/assets/{dist-C-iJHcSK.js → dist-DcBP8Cf6.js} +1 -1
  581. package/dist/public/assets/{ebnfDiagram-UZSYDL2S-D-hp5yNt.js → ebnfDiagram-UZSYDL2S-Tn-K8-X7.js} +1 -1
  582. package/dist/public/assets/{editor.api-BopUWpqY.js → editor.api-Bz4sjRz_.js} +1 -1
  583. package/dist/public/assets/{elk-XV6XMXQE-CBbk_IpU.js → elk-XV6XMXQE-COnQsWlN.js} +1 -1
  584. package/dist/public/assets/{erDiagram-EYBAPDEH-B02R_WWE.js → erDiagram-EYBAPDEH-c53dJilq.js} +1 -1
  585. package/dist/public/assets/{eventmodeling-K75KTNOO-aCZfYnCI.js → eventmodeling-K75KTNOO-DaFpPPks.js} +1 -1
  586. package/dist/public/assets/flowDiagram-MALGAFMO-V5qkYWIO.js +1 -0
  587. package/dist/public/assets/{freemarker2-DMN60LeK.js → freemarker2-BLxfRHsw.js} +1 -1
  588. package/dist/public/assets/{ganttDiagram-23REXITY-DioU8TlD.js → ganttDiagram-23REXITY-Md-SavIS.js} +1 -1
  589. package/dist/public/assets/gitGraph-VSP46ZUC-1q8ldRXU.js +1 -0
  590. package/dist/public/assets/{gitGraphDiagram-STJD7YCW--q3ctg6y.js → gitGraphDiagram-STJD7YCW-CMSwTghO.js} +1 -1
  591. package/dist/public/assets/{handlebars-B_-qdvpB.js → handlebars-sNpu01kP.js} +1 -1
  592. package/dist/public/assets/{html-BN8Ah3Js.js → html-C_tKd-uP.js} +1 -1
  593. package/dist/public/assets/{index-B3A--ac8.js → index-Bn86rI4n.js} +2 -2
  594. package/dist/public/assets/info-OHQRW6UA-Crere6sx.js +1 -0
  595. package/dist/public/assets/{infoDiagram-KBXO4MBG-CGXteYo9.js → infoDiagram-KBXO4MBG-CwgNj-7i.js} +1 -1
  596. package/dist/public/assets/{ishikawaDiagram-M35NCXHK-DM2LmOAc.js → ishikawaDiagram-M35NCXHK-BSlzQNMN.js} +1 -1
  597. package/dist/public/assets/{javascript-BlizGb0q.js → javascript-l3qKw0L-.js} +1 -1
  598. package/dist/public/assets/{journeyDiagram-OPLOXDXO-CNITRtGl.js → journeyDiagram-OPLOXDXO-B09LPEnF.js} +1 -1
  599. package/dist/public/assets/{jsonMode-CEUmT5sN.js → jsonMode-5SQQn1EX.js} +1 -1
  600. package/dist/public/assets/{kanban-definition-BZKZHSQY-BPUuS9um.js → kanban-definition-BZKZHSQY-BiW4aJ29.js} +1 -1
  601. package/dist/public/assets/{liquid-BbyLjUbE.js → liquid-BGyTIIUt.js} +1 -1
  602. package/dist/public/assets/{mdx-DiQz7Q35.js → mdx-8tGjz4em.js} +1 -1
  603. package/dist/public/assets/{mermaid-parser.core-Dum100hC.js → mermaid-parser.core-CctN5b0z.js} +3 -3
  604. package/dist/public/assets/{mermaid.core-BWmWf6XO.js → mermaid.core-7ERSdZ4-.js} +4 -4
  605. package/dist/public/assets/{mindmap-definition-I2QAS2VK-L8HyYUDY.js → mindmap-definition-I2QAS2VK-D-GOUwW1.js} +1 -1
  606. package/dist/public/assets/module-DEqsdd00.js +1 -0
  607. package/dist/public/assets/module-TWc52XwT.js +2244 -0
  608. package/dist/public/assets/{monaco-zOOyBmxy.js → monaco-B_9hlk78.js} +3 -3
  609. package/dist/public/assets/packet-JDAUHWVQ-qMf5LkHT.js +1 -0
  610. package/dist/public/assets/{pegDiagram-FD4XPPHP-CTZKPo0Z.js → pegDiagram-FD4XPPHP-Dmy1fWB3.js} +1 -1
  611. package/dist/public/assets/phaser.esm-BxCDEWDb.js +3202 -0
  612. package/dist/public/assets/pie-XZMESJXO-BjqLn4qm.js +1 -0
  613. package/dist/public/assets/{pieDiagram-J4AKIIQI-DAeT3dFi.js → pieDiagram-J4AKIIQI-CXFHLYTg.js} +1 -1
  614. package/dist/public/assets/{python-C984gt98.js → python-e-JK0s5M.js} +1 -1
  615. package/dist/public/assets/{quadrantDiagram-XTYBLID2--PXxwV1Z.js → quadrantDiagram-XTYBLID2-RQvEpGWO.js} +1 -1
  616. package/dist/public/assets/radar-ABXABTNO-DWO6t_4C.js +1 -0
  617. package/dist/public/assets/railroad-I3PHUGI6-D1XOJPWy.js +1 -0
  618. package/dist/public/assets/{railroad-abnf-LNEFI6M7-BYcFfrCa.js → railroad-abnf-LNEFI6M7-CDOSPZwX.js} +1 -1
  619. package/dist/public/assets/{railroad-ebnf-DWYD2UWJ-Cd33qxAm.js → railroad-ebnf-DWYD2UWJ-BTrNQ0DX.js} +1 -1
  620. package/dist/public/assets/{railroad-peg-JR7BVNR7-C5TpzaU8.js → railroad-peg-JR7BVNR7-B7NtVofS.js} +1 -1
  621. package/dist/public/assets/{railroadDiagram-MRQ6NCDL-DlWwjbhH.js → railroadDiagram-MRQ6NCDL-DsDrT0Jf.js} +1 -1
  622. package/dist/public/assets/{razor-BBqMR1Qn.js → razor-DtSPwumi.js} +1 -1
  623. package/dist/public/assets/{requirementDiagram-Y7LWUY3S-CsYBy9HS.js → requirementDiagram-Y7LWUY3S-BQh0hFuA.js} +1 -1
  624. package/dist/public/assets/{sankeyDiagram-WGJFYUXA-Baxyb5p9.js → sankeyDiagram-WGJFYUXA-BUXNAQEF.js} +1 -1
  625. package/dist/public/assets/{sequenceDiagram-5NDRBG5M-Cq6VeBT_.js → sequenceDiagram-5NDRBG5M-05f-N5V_.js} +1 -1
  626. package/dist/public/assets/{stateDiagram-v2-FJ4FJNEA-O60WKaE7.js → stateDiagram-v2-FJ4FJNEA-D6V1fGWV.js} +1 -1
  627. package/dist/public/assets/{swimlanes-UMQ2AFYF-C2nf1-Cc.js → swimlanes-UMQ2AFYF-DWhlPvKs.js} +1 -1
  628. package/dist/public/assets/swimlanesDiagram-OMPLPG4O-CRn5uHsY.js +8 -0
  629. package/dist/public/assets/three.module-CeVBJVoU.js +4225 -0
  630. package/dist/public/assets/{timeline-definition-SEUHKTQE-DEfUG6YH.js → timeline-definition-SEUHKTQE-CMdocOui.js} +1 -1
  631. package/dist/public/assets/treeView-D4JQ5SDB-D09wHNzT.js +1 -0
  632. package/dist/public/assets/treemap-SAJKECNS-ChxAT7Fq.js +1 -0
  633. package/dist/public/assets/{typescript-Gtq7f0aU.js → typescript-65jNyipU.js} +1 -1
  634. package/dist/public/assets/{usecaseDiagram-AFA6YXN4-Gw9DyJcx.js → usecaseDiagram-AFA6YXN4-BQTHUX1f.js} +1 -1
  635. package/dist/public/assets/{vennDiagram-NNMJR3RB-Clb3MLWF.js → vennDiagram-NNMJR3RB-BULkVTfA.js} +1 -1
  636. package/dist/public/assets/wardley-7MLQ67FV-DfSjKzbJ.js +1 -0
  637. package/dist/public/assets/{wardleyDiagram-S7YFUSEH-BrTRpwu2.js → wardleyDiagram-S7YFUSEH-Cek6l8lz.js} +1 -1
  638. package/dist/public/assets/{xml-Bx3nk7iG.js → xml-DWBejfu-.js} +1 -1
  639. package/dist/public/assets/{xychartDiagram-GGNKY7IX-BfjTcIsb.js → xychartDiagram-GGNKY7IX-ujnZQTWA.js} +1 -1
  640. package/dist/public/assets/{yaml-dFLE_rSl.js → yaml-CwRCT7q1.js} +1 -1
  641. package/dist/public/index.html +1 -1
  642. package/dist/public/launch.svg +46 -42
  643. package/dist/serve/index.mjs +8244 -3756
  644. package/package.json +33 -26
  645. package/dist/pi/dist/bundle/chunks/anthropic-messages-BWGCKOF4.js +0 -6
  646. package/dist/pi/dist/bundle/chunks/chunk-44DLKSKE.js +0 -1232
  647. package/dist/pi/dist/bundle/chunks/chunk-62VOPMLK.js +0 -65
  648. package/dist/pi/dist/bundle/chunks/chunk-7O7QKK6A.js +0 -2
  649. package/dist/pi/dist/bundle/chunks/chunk-CHWNPHIS.js +0 -82
  650. package/dist/pi/dist/bundle/chunks/chunk-NL4X6LBY.js +0 -4
  651. package/dist/pi/dist/bundle/chunks/chunk-NZY7EIPA.js +0 -4
  652. package/dist/pi/dist/bundle/chunks/chunk-R2EGYMOO.js +0 -7
  653. package/dist/pi/dist/bundle/chunks/chunk-UKVNB6C4.js +0 -2
  654. package/dist/pi/dist/bundle/chunks/chunk-USJZMAIR.js +0 -2
  655. package/dist/pi/dist/bundle/chunks/chunk-VOLAXWGI.js +0 -2
  656. package/dist/pi/dist/bundle/chunks/openai-codex-responses-QAWLOQSN.js +0 -10
  657. package/dist/pi/dist/bundle/chunks/openai-responses-MD3562FB.js +0 -4
  658. package/dist/pi/dist/bundle/chunks/virtual-modules-O76XM3OB.js +0 -2
  659. package/dist/public/assets/browser-y6EDNUmc.js +0 -12
  660. package/dist/public/assets/cynefin-EF2NZ3EQ-CoY4CrZu.js +0 -1
  661. package/dist/public/assets/flowDiagram-MALGAFMO-CATkJShO.js +0 -1
  662. package/dist/public/assets/gitGraph-VSP46ZUC-g4yHXXxx.js +0 -1
  663. package/dist/public/assets/info-OHQRW6UA-CKADJjz4.js +0 -1
  664. package/dist/public/assets/module-CH7IXa5L.js +0 -1781
  665. package/dist/public/assets/module-DNAasuMC.js +0 -1
  666. package/dist/public/assets/packet-JDAUHWVQ-CpKMhX4K.js +0 -1
  667. package/dist/public/assets/pie-XZMESJXO-CW-zGDRd.js +0 -1
  668. package/dist/public/assets/radar-ABXABTNO-Cg8W433p.js +0 -1
  669. package/dist/public/assets/railroad-I3PHUGI6-DriMt2PQ.js +0 -1
  670. package/dist/public/assets/swimlanesDiagram-OMPLPG4O-B46JxqS8.js +0 -8
  671. package/dist/public/assets/treeView-D4JQ5SDB-1LhEWwC9.js +0 -1
  672. package/dist/public/assets/treemap-SAJKECNS-D3t3N7nS.js +0 -1
  673. package/dist/public/assets/wardley-7MLQ67FV-D3sAsd8p.js +0 -1
@@ -0,0 +1,343 @@
1
+ ---
2
+ name: actions-and-utilities
3
+ description: "Use this skill when working with Phaser 4 utility functions, actions, alignment, grid layout, or batch operations on game objects. Triggers on: align, grid layout, actions, set operations on groups of game objects."
4
+ ---
5
+
6
+ # Phaser 4 -- Actions & Utility Functions
7
+
8
+ > Phaser.Actions namespace for batch operations on Game Object arrays, plus Phaser.Utils.Array, Phaser.Utils.Objects, and Phaser.Utils.String helper functions.
9
+
10
+ **Related skills:** ../groups-and-containers/SKILL.md, ../sprites-and-images/SKILL.md
11
+
12
+ ---
13
+
14
+ ## Quick Start
15
+
16
+ ```js
17
+ // Create 20 sprites and batch-position them in a grid
18
+ const sprites = [];
19
+ for (let i = 0; i < 20; i++) {
20
+ sprites.push(this.add.sprite(0, 0, 'gem'));
21
+ }
22
+
23
+ // Arrange into a 5x4 grid
24
+ Phaser.Actions.GridAlign(sprites, {
25
+ width: 5,
26
+ height: 4,
27
+ cellWidth: 64,
28
+ cellHeight: 64,
29
+ x: 100,
30
+ y: 100
31
+ });
32
+
33
+ // Fade alpha from 0 to 1 across all sprites
34
+ Phaser.Actions.Spread(sprites, 'alpha', 0, 1);
35
+
36
+ // Offset each sprite's x by 10, with a step of 2 per item
37
+ Phaser.Actions.IncX(sprites, 10, 2);
38
+
39
+ // Works with Groups too
40
+ const group = this.add.group({ key: 'star', repeat: 11 });
41
+ Phaser.Actions.PlaceOnCircle(group.getChildren(), new Phaser.Geom.Circle(400, 300, 200));
42
+ ```
43
+
44
+ ---
45
+
46
+ ## Core Concepts
47
+
48
+ ### The Actions Pattern
49
+
50
+ Every Action in `Phaser.Actions` follows the same pattern:
51
+
52
+ 1. **First argument is always an array** of Game Objects (or any objects with the required public properties like `x`, `y`, `alpha`, etc.).
53
+ 2. **Returns the same array**, enabling chaining or pass-through.
54
+ 3. **Works with Groups** by passing `group.getChildren()`.
55
+ 4. Actions do NOT store state. They are one-shot batch operations.
56
+
57
+ ### PropertyValueSet and PropertyValueInc
58
+
59
+ Most Set/Inc actions delegate to two core functions:
60
+
61
+ - **`PropertyValueSet(items, key, value, step, index, direction)`** -- Sets `items[i][key] = value + (i * step)`.
62
+ - **`PropertyValueInc(items, key, value, step, index, direction)`** -- Adds `items[i][key] += value + (i * step)`.
63
+
64
+ The `step` parameter adds an incremental offset per item. The `index` and `direction` parameters control iteration start point and order (1 = forward, -1 = backward).
65
+
66
+ ### Geometry-Based Placement
67
+
68
+ Actions like `PlaceOnCircle`, `PlaceOnLine`, `RandomRectangle`, etc. accept Phaser geometry objects (`Phaser.Geom.Circle`, `Phaser.Geom.Line`, etc.), NOT Game Object shapes. If using a `Phaser.GameObjects.Circle`, pass its `.geom` property instead.
69
+
70
+ ---
71
+
72
+ ## All Actions
73
+
74
+ ### Property Setters
75
+
76
+ | Action | Signature | Description |
77
+ |---|---|---|
78
+ | `SetX` | `(items, value, step?, index?, direction?)` | Set `x` property |
79
+ | `SetY` | `(items, value, step?, index?, direction?)` | Set `y` property |
80
+ | `SetXY` | `(items, x, y?, stepX?, stepY?, index?, direction?)` | Set both `x` and `y`; `y` defaults to `x` |
81
+ | `SetAlpha` | `(items, value, step?, index?, direction?)` | Set `alpha` |
82
+ | `SetBlendMode` | `(items, value, index?, direction?)` | Set blend mode |
83
+ | `SetDepth` | `(items, value, step?, index?, direction?)` | Set render depth |
84
+ | `SetHitArea` | `(items, hitArea?, callback?)` | Set interactive hit area |
85
+ | `SetOrigin` | `(items, originX, originY?, stepX?, stepY?, index?, direction?)` | Set origin point |
86
+ | `SetRotation` | `(items, value, step?, index?, direction?)` | Set rotation (radians) |
87
+ | `SetScale` | `(items, scaleX, scaleY?, stepX?, stepY?, index?, direction?)` | Set both scale axes |
88
+ | `SetScaleX` | `(items, value, step?, index?, direction?)` | Set `scaleX` |
89
+ | `SetScaleY` | `(items, value, step?, index?, direction?)` | Set `scaleY` |
90
+ | `SetScrollFactor` | `(items, x, y?, stepX?, stepY?, index?, direction?)` | Set scroll factor |
91
+ | `SetScrollFactorX` | `(items, value, step?, index?, direction?)` | Set horizontal scroll factor |
92
+ | `SetScrollFactorY` | `(items, value, step?, index?, direction?)` | Set vertical scroll factor |
93
+ | `SetTint` | `(items, topLeft, topRight?, bottomLeft?, bottomRight?)` | Set tint color(s) |
94
+ | `SetVisible` | `(items, value, index?, direction?)` | Set visibility |
95
+ | `PropertyValueSet` | `(items, key, value, step?, index?, direction?)` | Generic: set any named property |
96
+
97
+ ### Property Incrementers
98
+
99
+ | Action | Signature | Description |
100
+ |---|---|---|
101
+ | `IncX` | `(items, value, step?, index?, direction?)` | Add to `x` |
102
+ | `IncXY` | `(items, x, y?, stepX?, stepY?, index?, direction?)` | Add to `x` and `y` |
103
+ | `IncY` | `(items, value, step?, index?, direction?)` | Add to `y` |
104
+ | `IncAlpha` | `(items, value, step?, index?, direction?)` | Add to `alpha` |
105
+ | `Angle` | `(items, value, step?, index?, direction?)` | Add to `angle` (degrees) |
106
+ | `Rotate` | `(items, value, step?, index?, direction?)` | Add to `rotation` (radians) |
107
+ | `ScaleX` | `(items, value, step?, index?, direction?)` | Add to `scaleX` |
108
+ | `ScaleXY` | `(items, scaleX, scaleY?, stepX?, stepY?, index?, direction?)` | Add to both scale axes |
109
+ | `ScaleY` | `(items, value, step?, index?, direction?)` | Add to `scaleY` |
110
+ | `PropertyValueInc` | `(items, key, value, step?, index?, direction?)` | Generic: increment any named property |
111
+
112
+ ### Placement on Geometry
113
+
114
+ | Action | Signature | Description |
115
+ |---|---|---|
116
+ | `PlaceOnCircle` | `(items, circle, startAngle?, endAngle?)` | Evenly space on circle perimeter |
117
+ | `PlaceOnEllipse` | `(items, ellipse, startAngle?, endAngle?)` | Evenly space on ellipse perimeter |
118
+ | `PlaceOnLine` | `(items, line)` | Evenly space along a line |
119
+ | `PlaceOnRectangle` | `(items, rect, shift?)` | Evenly space on rectangle perimeter |
120
+ | `PlaceOnTriangle` | `(items, triangle, stepRate?)` | Evenly space on triangle perimeter |
121
+ | `RandomCircle` | `(items, circle)` | Random positions within a circle |
122
+ | `RandomEllipse` | `(items, ellipse)` | Random positions within an ellipse |
123
+ | `RandomLine` | `(items, line)` | Random positions along a line |
124
+ | `RandomRectangle` | `(items, rect)` | Random positions within a rectangle |
125
+ | `RandomTriangle` | `(items, triangle)` | Random positions within a triangle |
126
+
127
+ ### Layout and Alignment
128
+
129
+ | Action | Signature | Description |
130
+ |---|---|---|
131
+ | `GridAlign` | `(items, config)` | Arrange in grid; config: `{ width, height, cellWidth, cellHeight, position, x, y }` |
132
+ | `AlignTo` | `(items, position, offsetX?, offsetY?)` | Chain-align each item next to the previous one using `Phaser.Display.Align` constants |
133
+ | `FitToRegion` | `(items, scaleMode?, region?, itemCoverage?)` | Scale/position each GO to fill a rectangle (v4.0.0+). scaleMode: 0=stretch, -1=fit inside, 1=cover outside |
134
+
135
+ ### Distribution and Interpolation
136
+
137
+ | Action | Signature | Description |
138
+ |---|---|---|
139
+ | `Spread` | `(items, property, min, max, inc?)` | Linearly distribute a property from `min` to `max` across all items |
140
+ | `SmoothStep` | `(items, property, min, max, inc?)` | Distribute using Hermite smoothstep interpolation |
141
+ | `SmootherStep` | `(items, property, min, max, inc?)` | Distribute using Ken Perlin's smootherstep |
142
+
143
+ ### Rotation and Movement
144
+
145
+ | Action | Signature | Description |
146
+ |---|---|---|
147
+ | `RotateAround` | `(items, point, angle)` | Rotate all items around a point (radians) |
148
+ | `RotateAroundDistance` | `(items, point, angle, distance)` | Rotate around a point at a fixed distance |
149
+ | `ShiftPosition` | `(items, x, y, direction?, output?)` | Snake-like: move head to x/y, each item takes position of the previous |
150
+ | `WrapInRectangle` | `(items, rect, padding?)` | Wrap x/y to stay within rectangle bounds |
151
+
152
+ ### Queries and Iteration
153
+
154
+ | Action | Signature | Description |
155
+ |---|---|---|
156
+ | `GetFirst` | `(items, compare, index?)` | Find first item matching all properties in `compare` object |
157
+ | `GetLast` | `(items, compare, index?)` | Find last item matching all properties in `compare` object |
158
+ | `Call` | `(items, callback, context)` | Invoke callback for each item |
159
+ | `Shuffle` | `(items)` | Randomly reorder the array (Fisher-Yates) |
160
+ | `ToggleVisible` | `(items)` | Toggle `visible` on each item |
161
+ | `PlayAnimation` | `(items, key, ignoreIfPlaying?)` | Play animation on all items with an `anims` component |
162
+
163
+ ### Effects (v4.0.0+)
164
+
165
+ | Action | Signature | Description |
166
+ |---|---|---|
167
+ | `AddEffectBloom` | `(items, config?)` | Add Bloom filter effect to a Camera or GO. Returns `{ parallelFilters, threshold, blur }[]` |
168
+ | `AddEffectShine` | `(items, config?)` | Add Shine filter effect |
169
+ | `AddMaskShape` | `(items, config?)` | Apply a shape-based mask (circle, square, rectangle, ellipse) with optional blur |
170
+
171
+ ---
172
+
173
+ ## Array Utilities
174
+
175
+ Namespace: `Phaser.Utils.Array`
176
+
177
+ | Function | Signature | Description |
178
+ |---|---|---|
179
+ | `Add` | `(array, item, limit?, callback?, context?)` | Add item(s) if not already present; optional size limit |
180
+ | `AddAt` | `(array, item, index?, limit?, callback?, context?)` | Insert item(s) at index |
181
+ | `BringToTop` | `(array, item)` | Move item to end of array |
182
+ | `CountAllMatching` | `(array, property, value, startIndex?, endIndex?)` | Count items where property equals value |
183
+ | `Each` | `(array, callback, context, ...args)` | Iterate with callback; passes item + extra args |
184
+ | `EachInRange` | `(array, callback, context, startIndex, endIndex, ...args)` | Iterate a slice with callback |
185
+ | `FindClosestInSorted` | `(value, array, key?)` | Binary-search style closest match in sorted array |
186
+ | `Flatten` | `(array, output?)` | Flatten nested arrays into a single array |
187
+ | `GetAll` | `(array, property?, value?, startIndex?, endIndex?)` | Filter items matching property/value |
188
+ | `GetFirst` | `(array, property?, value?, startIndex?, endIndex?)` | First item matching property/value |
189
+ | `GetRandom` | `(array, startIndex?, length?)` | Return a random element |
190
+ | `MoveAbove` | `(array, item1, item2)` | Move item2 directly above item1 |
191
+ | `MoveBelow` | `(array, item1, item2)` | Move item2 directly below item1 |
192
+ | `MoveDown` | `(array, item)` | Move item one position toward index 0 |
193
+ | `MoveTo` | `(array, item, index)` | Move item to specific index |
194
+ | `MoveUp` | `(array, item)` | Move item one position toward end |
195
+ | `NumberArray` | `(start, end, prefix?, suffix?)` | Generate `[start..end]` range; optional string prefix/suffix |
196
+ | `NumberArrayStep` | `(start?, end?, step?)` | Generate range with custom step size |
197
+ | `QuickSelect` | `(array, k, left?, right?, compare?)` | Partial sort: kth smallest element in-place |
198
+ | `Range` | `(a, b, options?)` | Generate array from range config |
199
+ | `Remove` | `(array, item, callback?, context?)` | Remove item(s) from array |
200
+ | `RemoveAt` | `(array, index, callback?, context?)` | Remove item at index |
201
+ | `RemoveBetween` | `(array, startIndex, endIndex, callback?, context?)` | Remove items in range |
202
+ | `RemoveRandomElement` | `(array, startIndex?, length?)` | Remove and return a random element |
203
+ | `Replace` | `(array, oldItem, newItem)` | Swap one item for another |
204
+ | `RotateLeft` | `(array, total?)` | Shift elements left; last wraps to front |
205
+ | `RotateRight` | `(array, total?)` | Shift elements right; first wraps to end |
206
+ | `SafeRange` | `(array, startIndex, endIndex, throwError?)` | Validate index range is within bounds |
207
+ | `SendToBack` | `(array, item)` | Move item to index 0 |
208
+ | `SetAll` | `(array, property, value, startIndex?, endIndex?)` | Set a property on all items in range |
209
+ | `Shuffle` | `(array)` | Fisher-Yates shuffle; modifies in-place |
210
+ | `SortByDigits` | `(array)` | Sort strings by embedded numeric values |
211
+ | `SpliceOne` | `(array, index)` | Fast single-element splice |
212
+ | `StableSort` | `(array, compare?)` | Guaranteed stable sort (merge sort fallback for engines without native stable sort) |
213
+ | `Swap` | `(array, item1, item2)` | Swap two items in-place |
214
+
215
+ Also includes `Phaser.Utils.Array.Matrix` sub-namespace for 2D matrix operations.
216
+
217
+ ---
218
+
219
+ ## Object Utilities
220
+
221
+ Namespace: `Phaser.Utils.Objects`
222
+
223
+ | Function | Signature | Description |
224
+ |---|---|---|
225
+ | `Clone` | `(obj)` | Shallow clone of object |
226
+ | `DeepCopy` | `(obj)` | Recursive deep copy of object or array |
227
+ | `Extend` | `(target, ...sources)` | jQuery-style extend; copies properties from sources to target |
228
+ | `GetAdvancedValue` | `(source, key, defaultValue)` | Like `GetValue` but resolves random/callback config values |
229
+ | `GetFastValue` | `(source, key, defaultValue?)` | Top-level-only property lookup; no dot-path support. Faster than `GetValue` |
230
+ | `GetMinMaxValue` | `(source, key, min, max, defaultValue)` | Get value clamped between min and max |
231
+ | `GetValue` | `(source, key, defaultValue, altSource?)` | Dot-path property lookup (e.g. `'render.screen.width'`). Falls back to altSource then defaultValue |
232
+ | `HasAll` | `(source, keys)` | True if source has ALL listed keys |
233
+ | `HasAny` | `(source, keys)` | True if source has ANY listed key |
234
+ | `HasValue` | `(source, key)` | True if source has the key |
235
+ | `IsPlainObject` | `(obj)` | True if obj is a plain `{}` object (not DOM, not window) |
236
+ | `Merge` | `(obj1, obj2)` | Merge obj2 into a clone of obj1 |
237
+ | `MergeRight` | `(obj1, obj2)` | Merge obj1 into a clone of obj2 |
238
+ | `Pick` | `(source, keys)` | Return new object with only the specified keys |
239
+ | `SetValue` | `(source, key, value)` | Set a dot-path property value |
240
+
241
+ ---
242
+
243
+ ## String Utilities
244
+
245
+ Namespace: `Phaser.Utils.String`
246
+
247
+ | Function | Signature | Description |
248
+ |---|---|---|
249
+ | `Format` | `(string, values)` | Replace `%1`, `%2`, etc. markers with array values |
250
+ | `Pad` | `(str, len?, pad?, dir?)` | Pad string to length. dir: 1=left, 2=right, default=both |
251
+ | `RemoveAt` | `(string, index)` | Remove character at index |
252
+ | `Reverse` | `(string)` | Reverse the string |
253
+ | `UppercaseFirst` | `(string)` | Capitalize first character |
254
+ | `UUID` | `()` | Generate RFC4122 v4 UUID string |
255
+
256
+ ---
257
+
258
+ ## Common Patterns
259
+
260
+ ### Using Actions with Groups
261
+
262
+ ```js
263
+ const enemies = this.add.group({ key: 'enemy', repeat: 9 });
264
+
265
+ // Position all children in a grid
266
+ Phaser.Actions.GridAlign(enemies.getChildren(), {
267
+ width: 5, height: 2,
268
+ cellWidth: 80, cellHeight: 80,
269
+ x: 100, y: 50
270
+ });
271
+
272
+ // Fan out alpha across all enemies
273
+ Phaser.Actions.Spread(enemies.getChildren(), 'alpha', 0.3, 1);
274
+ ```
275
+
276
+ ### Step Parameter for Staggered Values
277
+
278
+ ```js
279
+ // Place sprites starting at x=100, each one 50px further right
280
+ Phaser.Actions.SetX(sprites, 100, 50);
281
+ // Result: items[0].x=100, items[1].x=150, items[2].x=200, ...
282
+
283
+ // Increment rotation with increasing step
284
+ Phaser.Actions.Rotate(sprites, 0.1, 0.05);
285
+ // Result: items[0].rotation += 0.1, items[1].rotation += 0.15, items[2].rotation += 0.2, ...
286
+ ```
287
+
288
+ ### Scatter Then Constrain
289
+
290
+ ```js
291
+ const bounds = new Phaser.Geom.Rectangle(0, 0, 800, 600);
292
+ // Random scatter
293
+ Phaser.Actions.RandomRectangle(sprites, bounds);
294
+ // Keep wrapped in bounds during update
295
+ Phaser.Actions.WrapInRectangle(sprites, bounds);
296
+ ```
297
+
298
+ ### GetValue for Config Parsing
299
+
300
+ ```js
301
+ // Deep property access with fallback
302
+ const width = Phaser.Utils.Objects.GetValue(config, 'render.screen.width', 800);
303
+
304
+ // Fast top-level lookup (no dot-path, better performance)
305
+ const speed = Phaser.Utils.Objects.GetFastValue(config, 'speed', 100);
306
+ ```
307
+
308
+ ### NumberArray for Asset Keys
309
+
310
+ ```js
311
+ // Generate frame key strings
312
+ const keys = Phaser.Utils.Array.NumberArray(1, 10, 'frame_', '.png');
313
+ // Result: ['frame_1.png', 'frame_2.png', ..., 'frame_10.png']
314
+ ```
315
+
316
+ ---
317
+
318
+ ## Gotchas
319
+
320
+ - **Actions operate on plain arrays, not Groups directly.** Always call `group.getChildren()` to get the array.
321
+ - **PlaceOn/Random geometry actions need `Phaser.Geom` objects**, not Game Object shapes. For a `Phaser.GameObjects.Circle`, pass `circle.geom`.
322
+ - **`SetXY` defaults `y` to `x`** if `y` is `undefined` or `null`. Pass `0` explicitly if you want y=0 and x=something else.
323
+ - **`Spread` with a single item** places it at the midpoint `(min + max) / 2`, not at `min`.
324
+ - **`step` is multiplied by iteration index**, not added cumulatively. Item 0 gets `value + 0*step`, item 1 gets `value + 1*step`, etc.
325
+ - **`StableSort` uses native `Array.sort` when the engine supports stable sorting**, falling back to merge sort only when needed.
326
+ - **`Shuffle` (both Actions and Utils.Array) modifies the array in-place** and returns it.
327
+ - **`GetValue` vs `GetFastValue`**: Use `GetFastValue` when the key is always top-level (no dots). It skips dot-path parsing and is faster in hot loops.
328
+ - **`AddEffectBloom` / `AddEffectShine` / `AddMaskShape` are v4-only** filter-based effects. They return arrays of created effects instead of the input.
329
+
330
+ ---
331
+
332
+ ## Source File Map
333
+
334
+ | Area | Path |
335
+ |---|---|
336
+ | All Actions | `src/actions/` |
337
+ | Actions index | `src/actions/index.js` |
338
+ | Core set/inc helpers | `src/actions/PropertyValueSet.js`, `src/actions/PropertyValueInc.js` |
339
+ | GridAlign config typedef | `src/actions/typedefs/` |
340
+ | Array utilities | `src/utils/array/` |
341
+ | Array matrix utils | `src/utils/array/matrix/` |
342
+ | Object utilities | `src/utils/object/` |
343
+ | String utilities | `src/utils/string/` |