@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,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/` |