@celljs/ta 4.10.0 → 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 (559) 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 +23 -0
  6. package/dist/pi/package.json +1 -1
  7. package/dist/pi/packages/ta-agents/extension/index.mjs +166 -139
  8. package/dist/pi/packages/ta-agents/lib/acp-agent.js +30 -10
  9. package/dist/pi/packages/ta-agents/lib/agent-catalog.d.ts +2 -2
  10. package/dist/pi/packages/ta-agents/lib/agent-catalog.js +4 -4
  11. package/dist/pi/packages/ta-agents/lib/agent-prompt.d.ts +6 -0
  12. package/dist/pi/packages/ta-agents/lib/agent-prompt.js +19 -0
  13. package/dist/pi/packages/ta-agents/lib/agent-session.d.ts +2 -0
  14. package/dist/pi/packages/ta-agents/lib/agent-session.js +2 -0
  15. package/dist/pi/packages/ta-agents/lib/agent-streamer.js +7 -0
  16. package/dist/pi/packages/ta-agents/lib/agent-tool.js +3 -2
  17. package/dist/pi/packages/ta-agents/package.json +1 -1
  18. package/dist/pi/packages/ta-bots/extension/index.mjs +31 -299
  19. package/dist/pi/packages/ta-bots/host/index.mjs +143 -1
  20. package/dist/pi/packages/ta-bots/lib/bots-protocol.d.ts +2 -0
  21. package/dist/pi/packages/ta-bots/lib/bots-protocol.js +3 -1
  22. package/dist/pi/packages/ta-bots/lib/bots-view.js +24 -12
  23. package/dist/pi/packages/ta-bots/lib/composer.js +1 -0
  24. package/dist/pi/packages/ta-bots/lib/extension.js +10 -17
  25. package/dist/pi/packages/ta-bots/lib/i18n.d.ts +1 -0
  26. package/dist/pi/packages/ta-bots/lib/i18n.js +2 -0
  27. package/dist/pi/packages/ta-bots/lib/index.js +2 -0
  28. package/dist/pi/packages/ta-bots/lib/style.d.ts +1 -1
  29. package/dist/pi/packages/ta-bots/lib/style.js +1 -0
  30. package/dist/pi/packages/ta-bots/lib/text-util.js +8 -1
  31. package/dist/pi/packages/ta-bots/lib/tool-line.d.ts +8 -0
  32. package/dist/pi/packages/ta-bots/lib/tool-line.js +19 -0
  33. package/dist/pi/packages/ta-bots/package.json +1 -1
  34. package/dist/pi/packages/ta-bots/web/index.js +47 -16
  35. package/dist/pi/packages/ta-changes/extension/index.mjs +23 -13
  36. package/dist/pi/packages/ta-changes/lib/card.js +18 -4
  37. package/dist/pi/packages/ta-changes/lib/changes-protocol.d.ts +0 -4
  38. package/dist/pi/packages/ta-changes/lib/changes-protocol.js +1 -5
  39. package/dist/pi/packages/ta-changes/lib/extension.js +5 -13
  40. package/dist/pi/packages/ta-changes/package.json +1 -1
  41. package/dist/pi/packages/ta-changes/web/index.js +16 -3
  42. package/dist/pi/packages/ta-channels/README.en.md +4 -3
  43. package/dist/pi/packages/ta-channels/README.md +4 -3
  44. package/dist/pi/packages/ta-channels/extension/index.mjs +350 -28
  45. package/dist/pi/packages/ta-channels/host/index.mjs +588 -43
  46. package/dist/pi/packages/ta-channels/lib/agent-cards.d.ts +19 -0
  47. package/dist/pi/packages/ta-channels/lib/agent-cards.js +58 -0
  48. package/dist/pi/packages/ta-channels/lib/agent-menu.d.ts +2 -2
  49. package/dist/pi/packages/ta-channels/lib/agent-menu.js +20 -6
  50. package/dist/pi/packages/ta-channels/lib/card.d.ts +27 -0
  51. package/dist/pi/packages/ta-channels/lib/card.js +178 -0
  52. package/dist/pi/packages/ta-channels/lib/channels-model.d.ts +65 -13
  53. package/dist/pi/packages/ta-channels/lib/channels-model.js +15 -6
  54. package/dist/pi/packages/ta-channels/lib/channels-util.d.ts +31 -2
  55. package/dist/pi/packages/ta-channels/lib/channels-util.js +100 -6
  56. package/dist/pi/packages/ta-channels/lib/channels.d.ts +28 -18
  57. package/dist/pi/packages/ta-channels/lib/channels.js +65 -65
  58. package/dist/pi/packages/ta-channels/lib/create.js +3 -1
  59. package/dist/pi/packages/ta-channels/lib/extension.d.ts +8 -0
  60. package/dist/pi/packages/ta-channels/lib/extension.js +104 -18
  61. package/dist/pi/packages/ta-channels/lib/faces.d.ts +2 -0
  62. package/dist/pi/packages/ta-channels/lib/faces.js +6 -0
  63. package/dist/pi/packages/ta-channels/lib/handoff-view.d.ts +19 -0
  64. package/dist/pi/packages/ta-channels/lib/handoff-view.js +113 -0
  65. package/dist/pi/packages/ta-channels/lib/handoff.d.ts +67 -0
  66. package/dist/pi/packages/ta-channels/lib/handoff.js +114 -0
  67. package/dist/pi/packages/ta-channels/lib/host.d.ts +1 -1
  68. package/dist/pi/packages/ta-channels/lib/host.js +1 -1
  69. package/dist/pi/packages/ta-channels/lib/i18n.d.ts +45 -0
  70. package/dist/pi/packages/ta-channels/lib/i18n.js +90 -0
  71. package/dist/pi/packages/ta-channels/lib/index.js +10 -1
  72. package/dist/pi/packages/ta-channels/lib/member-tools.d.ts +23 -0
  73. package/dist/pi/packages/ta-channels/lib/member-tools.js +56 -0
  74. package/dist/pi/packages/ta-channels/lib/members.js +6 -2
  75. package/dist/pi/packages/ta-channels/lib/notice.d.ts +25 -0
  76. package/dist/pi/packages/ta-channels/lib/notice.js +101 -0
  77. package/dist/pi/packages/ta-channels/lib/room.js +13 -2
  78. package/dist/pi/packages/ta-channels/lib/sidebar.d.ts +1 -6
  79. package/dist/pi/packages/ta-channels/lib/sidebar.js +132 -69
  80. package/dist/pi/packages/ta-channels/lib/style.d.ts +1 -1
  81. package/dist/pi/packages/ta-channels/lib/style.js +69 -4
  82. package/dist/pi/packages/ta-channels/lib/team.d.ts +58 -10
  83. package/dist/pi/packages/ta-channels/lib/team.js +159 -38
  84. package/dist/pi/packages/ta-channels/lib/tool-lines.d.ts +22 -0
  85. package/dist/pi/packages/ta-channels/lib/tool-lines.js +113 -0
  86. package/dist/pi/packages/ta-channels/lib/views.d.ts +21 -16
  87. package/dist/pi/packages/ta-channels/lib/views.js +60 -31
  88. package/dist/pi/packages/ta-channels/package.json +2 -1
  89. package/dist/pi/packages/ta-channels/web/index.js +1507 -309
  90. package/dist/pi/packages/ta-computer-use/package.json +6 -1
  91. package/dist/pi/packages/ta-cron/README.en.md +4 -2
  92. package/dist/pi/packages/ta-cron/README.md +4 -2
  93. package/dist/pi/packages/ta-cron/extension/index.mjs +416 -44
  94. package/dist/pi/packages/ta-cron/host/index.mjs +24 -3
  95. package/dist/pi/packages/ta-cron/lib/chat-task.d.ts +48 -0
  96. package/dist/pi/packages/ta-cron/lib/chat-task.js +133 -0
  97. package/dist/pi/packages/ta-cron/lib/commands.d.ts +2 -1
  98. package/dist/pi/packages/ta-cron/lib/commands.js +10 -4
  99. package/dist/pi/packages/ta-cron/lib/composer.d.ts +11 -0
  100. package/dist/pi/packages/ta-cron/lib/composer.js +58 -0
  101. package/dist/pi/packages/ta-cron/lib/cron-protocol.d.ts +10 -3
  102. package/dist/pi/packages/ta-cron/lib/cron-protocol.js +6 -3
  103. package/dist/pi/packages/ta-cron/lib/editor.js +5 -3
  104. package/dist/pi/packages/ta-cron/lib/extension.d.ts +2 -0
  105. package/dist/pi/packages/ta-cron/lib/extension.js +33 -13
  106. package/dist/pi/packages/ta-cron/lib/i18n.d.ts +18 -0
  107. package/dist/pi/packages/ta-cron/lib/i18n.js +36 -0
  108. package/dist/pi/packages/ta-cron/lib/index.js +4 -0
  109. package/dist/pi/packages/ta-cron/lib/page.d.ts +5 -1
  110. package/dist/pi/packages/ta-cron/lib/page.js +12 -0
  111. package/dist/pi/packages/ta-cron/lib/react.d.ts +3 -0
  112. package/dist/pi/packages/ta-cron/lib/react.js +8 -0
  113. package/dist/pi/packages/ta-cron/lib/scheduler.js +3 -2
  114. package/dist/pi/packages/ta-cron/lib/style.d.ts +1 -1
  115. package/dist/pi/packages/ta-cron/lib/style.js +11 -13
  116. package/dist/pi/packages/ta-cron/lib/task-util.d.ts +2 -0
  117. package/dist/pi/packages/ta-cron/lib/task-util.js +20 -1
  118. package/dist/pi/packages/ta-cron/lib/tasks-view.js +6 -2
  119. package/dist/pi/packages/ta-cron/lib/tool-line.d.ts +9 -0
  120. package/dist/pi/packages/ta-cron/lib/tool-line.js +40 -0
  121. package/dist/pi/packages/ta-cron/lib/tool.d.ts +5 -1
  122. package/dist/pi/packages/ta-cron/lib/tool.js +6 -3
  123. package/dist/pi/packages/ta-cron/package.json +12 -1
  124. package/dist/pi/packages/ta-cron/web/index.js +661 -254
  125. package/dist/pi/packages/ta-extensions/README.en.md +1 -1
  126. package/dist/pi/packages/ta-extensions/README.md +1 -1
  127. package/dist/pi/packages/ta-extensions/host/index.mjs +3 -2
  128. package/dist/pi/packages/ta-extensions/lib/actions.d.ts +4 -0
  129. package/dist/pi/packages/ta-extensions/lib/actions.js +13 -4
  130. package/dist/pi/packages/ta-extensions/lib/extensions-util.d.ts +5 -0
  131. package/dist/pi/packages/ta-extensions/lib/extensions-util.js +10 -0
  132. package/dist/pi/packages/ta-extensions/lib/market-parts.js +8 -2
  133. package/dist/pi/packages/ta-extensions/lib/market-style.d.ts +1 -1
  134. package/dist/pi/packages/ta-extensions/lib/market-style.js +4 -5
  135. package/dist/pi/packages/ta-extensions/lib/market-util.d.ts +2 -2
  136. package/dist/pi/packages/ta-extensions/lib/market-util.js +2 -2
  137. package/dist/pi/packages/ta-extensions/lib/page.js +12 -7
  138. package/dist/pi/packages/ta-extensions/lib/react.d.ts +3 -0
  139. package/dist/pi/packages/ta-extensions/lib/react.js +8 -0
  140. package/dist/pi/packages/ta-extensions/lib/style.d.ts +1 -1
  141. package/dist/pi/packages/ta-extensions/lib/style.js +3 -2
  142. package/dist/pi/packages/ta-extensions/package.json +6 -1
  143. package/dist/pi/packages/ta-extensions/skills/ta-package/SKILL.md +19 -8
  144. package/dist/pi/packages/ta-extensions/web/index.js +191 -22
  145. package/dist/pi/packages/ta-games/README.en.md +47 -0
  146. package/dist/pi/packages/ta-games/README.md +47 -0
  147. package/dist/pi/packages/ta-games/host/index.mjs +65 -0
  148. package/dist/pi/packages/ta-games/lib/games-view.d.ts +16 -0
  149. package/dist/pi/packages/ta-games/lib/games-view.js +77 -0
  150. package/dist/pi/packages/ta-games/lib/host.d.ts +36 -0
  151. package/dist/pi/packages/ta-games/lib/host.js +83 -0
  152. package/dist/pi/packages/ta-games/lib/i18n.d.ts +35 -0
  153. package/dist/pi/packages/ta-games/lib/i18n.js +71 -0
  154. package/dist/pi/packages/ta-games/lib/ideas.d.ts +6 -0
  155. package/dist/pi/packages/ta-games/lib/ideas.js +62 -0
  156. package/dist/pi/packages/ta-games/lib/index.d.ts +7 -0
  157. package/dist/pi/packages/ta-games/lib/index.js +24 -0
  158. package/dist/pi/packages/ta-games/lib/make-game.d.ts +23 -0
  159. package/dist/pi/packages/ta-games/lib/make-game.js +67 -0
  160. package/dist/pi/packages/ta-games/lib/react.d.ts +11 -0
  161. package/dist/pi/packages/ta-games/lib/react.js +16 -0
  162. package/dist/pi/packages/ta-games/lib/style.d.ts +4 -0
  163. package/dist/pi/packages/ta-games/lib/style.js +33 -0
  164. package/dist/pi/packages/ta-games/package.json +60 -0
  165. package/dist/pi/packages/ta-games/skills/ta-game/SKILL.md +127 -0
  166. package/dist/pi/packages/ta-games/skills/ta-game/examples/dino-run/package.json +22 -0
  167. package/dist/pi/packages/ta-games/skills/ta-game/examples/dino-run/web.js +389 -0
  168. package/dist/pi/packages/ta-games/skills/ta-game/examples/stack/package.json +22 -0
  169. package/dist/pi/packages/ta-games/skills/ta-game/examples/stack/web.js +423 -0
  170. package/dist/pi/packages/ta-games/skills/ta-game/phaser/LICENSE.md +22 -0
  171. package/dist/pi/packages/ta-games/skills/ta-game/phaser/actions-and-utilities/SKILL.md +343 -0
  172. package/dist/pi/packages/ta-games/skills/ta-game/phaser/animations/SKILL.md +481 -0
  173. package/dist/pi/packages/ta-games/skills/ta-game/phaser/audio-and-sound/SKILL.md +453 -0
  174. package/dist/pi/packages/ta-games/skills/ta-game/phaser/cameras/SKILL.md +497 -0
  175. package/dist/pi/packages/ta-games/skills/ta-game/phaser/cameras/references/REFERENCE.md +128 -0
  176. package/dist/pi/packages/ta-games/skills/ta-game/phaser/curves-and-paths/SKILL.md +359 -0
  177. package/dist/pi/packages/ta-games/skills/ta-game/phaser/data-manager/SKILL.md +406 -0
  178. package/dist/pi/packages/ta-games/skills/ta-game/phaser/events-system/SKILL.md +497 -0
  179. package/dist/pi/packages/ta-games/skills/ta-game/phaser/filters-and-postfx/SKILL.md +449 -0
  180. package/dist/pi/packages/ta-games/skills/ta-game/phaser/game-object-components/SKILL.md +478 -0
  181. package/dist/pi/packages/ta-games/skills/ta-game/phaser/game-object-components/references/REFERENCE.md +76 -0
  182. package/dist/pi/packages/ta-games/skills/ta-game/phaser/game-setup-and-config/SKILL.md +485 -0
  183. package/dist/pi/packages/ta-games/skills/ta-game/phaser/geometry-and-math/SKILL.md +497 -0
  184. package/dist/pi/packages/ta-games/skills/ta-game/phaser/graphics-and-shapes/SKILL.md +473 -0
  185. package/dist/pi/packages/ta-games/skills/ta-game/phaser/groups-and-containers/SKILL.md +418 -0
  186. package/dist/pi/packages/ta-games/skills/ta-game/phaser/input-keyboard-mouse-touch/SKILL.md +500 -0
  187. package/dist/pi/packages/ta-games/skills/ta-game/phaser/input-keyboard-mouse-touch/references/REFERENCE.md +372 -0
  188. package/dist/pi/packages/ta-games/skills/ta-game/phaser/loading-assets/SKILL.md +474 -0
  189. package/dist/pi/packages/ta-games/skills/ta-game/phaser/loading-assets/references/REFERENCE.md +148 -0
  190. package/dist/pi/packages/ta-games/skills/ta-game/phaser/particles/SKILL.md +499 -0
  191. package/dist/pi/packages/ta-games/skills/ta-game/phaser/particles/references/REFERENCE.md +17 -0
  192. package/dist/pi/packages/ta-games/skills/ta-game/phaser/physics-arcade/SKILL.md +468 -0
  193. package/dist/pi/packages/ta-games/skills/ta-game/phaser/physics-matter/SKILL.md +499 -0
  194. package/dist/pi/packages/ta-games/skills/ta-game/phaser/render-textures/SKILL.md +441 -0
  195. package/dist/pi/packages/ta-games/skills/ta-game/phaser/scale-and-responsive/SKILL.md +371 -0
  196. package/dist/pi/packages/ta-games/skills/ta-game/phaser/scenes/SKILL.md +450 -0
  197. package/dist/pi/packages/ta-games/skills/ta-game/phaser/scenes/references/REFERENCE.md +78 -0
  198. package/dist/pi/packages/ta-games/skills/ta-game/phaser/sprites-and-images/SKILL.md +417 -0
  199. package/dist/pi/packages/ta-games/skills/ta-game/phaser/sprites-and-images/references/REFERENCE.md +160 -0
  200. package/dist/pi/packages/ta-games/skills/ta-game/phaser/text-and-bitmaptext/SKILL.md +460 -0
  201. package/dist/pi/packages/ta-games/skills/ta-game/phaser/tilemaps/SKILL.md +440 -0
  202. package/dist/pi/packages/ta-games/skills/ta-game/phaser/time-and-timers/SKILL.md +496 -0
  203. package/dist/pi/packages/ta-games/skills/ta-game/phaser/tweens/SKILL.md +414 -0
  204. package/dist/pi/packages/ta-games/skills/ta-game/phaser/v3-to-v4-migration/SKILL.md +430 -0
  205. package/dist/pi/packages/ta-games/skills/ta-game/phaser/v4-new-features/SKILL.md +384 -0
  206. package/dist/pi/packages/ta-games/skills/ta-game/phaser/v4-new-features/references/REFERENCE.md +69 -0
  207. package/dist/pi/packages/ta-games/web/index.js +431 -0
  208. package/dist/pi/packages/ta-glance/README.en.md +11 -0
  209. package/dist/pi/packages/ta-glance/README.md +11 -0
  210. package/dist/pi/packages/ta-glance/extension/index.mjs +67 -0
  211. package/dist/pi/packages/ta-glance/lib/card.d.ts +8 -0
  212. package/dist/pi/packages/ta-glance/lib/card.js +268 -0
  213. package/dist/pi/packages/ta-glance/lib/extension.d.ts +15 -0
  214. package/dist/pi/packages/ta-glance/lib/extension.js +24 -0
  215. package/dist/pi/packages/ta-glance/lib/glance-json.d.ts +9 -0
  216. package/dist/pi/packages/ta-glance/lib/glance-json.js +85 -0
  217. package/dist/pi/packages/ta-glance/lib/glance-prompt.d.ts +7 -0
  218. package/dist/pi/packages/ta-glance/lib/glance-prompt.js +34 -0
  219. package/dist/pi/packages/ta-glance/lib/glance-protocol.d.ts +98 -0
  220. package/dist/pi/packages/ta-glance/lib/glance-protocol.js +8 -0
  221. package/dist/pi/packages/ta-glance/lib/glance-spec.d.ts +6 -0
  222. package/dist/pi/packages/ta-glance/lib/glance-spec.js +204 -0
  223. package/dist/pi/packages/ta-glance/lib/glance-util.d.ts +3 -0
  224. package/dist/pi/packages/ta-glance/lib/glance-util.js +12 -0
  225. package/dist/pi/packages/ta-glance/lib/i18n.d.ts +22 -0
  226. package/dist/pi/packages/ta-glance/lib/i18n.js +41 -0
  227. package/dist/pi/packages/ta-glance/lib/index.d.ts +7 -0
  228. package/dist/pi/packages/ta-glance/lib/index.js +22 -0
  229. package/dist/pi/packages/ta-glance/lib/react.d.ts +8 -0
  230. package/dist/pi/packages/ta-glance/lib/react.js +8 -0
  231. package/dist/pi/packages/ta-glance/lib/style.d.ts +4 -0
  232. package/dist/pi/packages/ta-glance/lib/style.js +164 -0
  233. package/dist/pi/packages/ta-glance/package.json +53 -0
  234. package/dist/pi/packages/ta-glance/web/index.js +933 -0
  235. package/dist/pi/packages/ta-launcher/lib/actions.d.ts +4 -4
  236. package/dist/pi/packages/ta-launcher/lib/actions.js +7 -3
  237. package/dist/pi/packages/ta-launcher/lib/launcher-util.d.ts +7 -7
  238. package/dist/pi/packages/ta-launcher/lib/launcher-util.js +11 -8
  239. package/dist/pi/packages/ta-launcher/lib/launcher-view.js +13 -7
  240. package/dist/pi/packages/ta-launcher/lib/react.d.ts +3 -0
  241. package/dist/pi/packages/ta-launcher/lib/react.js +8 -0
  242. package/dist/pi/packages/ta-launcher/lib/style.d.ts +1 -1
  243. package/dist/pi/packages/ta-launcher/lib/style.js +6 -4
  244. package/dist/pi/packages/ta-launcher/package.json +1 -1
  245. package/dist/pi/packages/ta-launcher/web/index.js +34 -17
  246. package/dist/pi/packages/ta-manual/README.en.md +10 -0
  247. package/dist/pi/packages/ta-manual/README.md +10 -0
  248. package/dist/pi/packages/ta-manual/lib/i18n.d.ts +15 -0
  249. package/dist/pi/packages/ta-manual/lib/i18n.js +31 -0
  250. package/dist/pi/packages/ta-manual/lib/index.d.ts +7 -0
  251. package/dist/pi/packages/ta-manual/lib/index.js +24 -0
  252. package/dist/pi/packages/ta-manual/lib/manual-util.d.ts +18 -0
  253. package/dist/pi/packages/ta-manual/lib/manual-util.js +40 -0
  254. package/dist/pi/packages/ta-manual/lib/manual-view.d.ts +9 -0
  255. package/dist/pi/packages/ta-manual/lib/manual-view.js +81 -0
  256. package/dist/pi/packages/ta-manual/lib/pictures-a.d.ts +2 -0
  257. package/dist/pi/packages/ta-manual/lib/pictures-a.js +263 -0
  258. package/dist/pi/packages/ta-manual/lib/pictures-b.d.ts +2 -0
  259. package/dist/pi/packages/ta-manual/lib/pictures-b.js +216 -0
  260. package/dist/pi/packages/ta-manual/lib/pictures.d.ts +9 -0
  261. package/dist/pi/packages/ta-manual/lib/pictures.js +16 -0
  262. package/dist/pi/packages/ta-manual/lib/react.d.ts +8 -0
  263. package/dist/pi/packages/ta-manual/lib/react.js +8 -0
  264. package/dist/pi/packages/ta-manual/lib/scene.d.ts +68 -0
  265. package/dist/pi/packages/ta-manual/lib/scene.js +115 -0
  266. package/dist/pi/packages/ta-manual/lib/style.d.ts +4 -0
  267. package/dist/pi/packages/ta-manual/lib/style.js +47 -0
  268. package/dist/pi/packages/ta-manual/lib/topics.d.ts +42 -0
  269. package/dist/pi/packages/ta-manual/lib/topics.js +354 -0
  270. package/dist/pi/packages/ta-manual/package.json +54 -0
  271. package/dist/pi/packages/ta-manual/skills/ta-manual/SKILL.md +119 -0
  272. package/dist/pi/packages/ta-manual/web/index.js +2223 -0
  273. package/dist/pi/packages/ta-notify/README.en.md +29 -0
  274. package/dist/pi/packages/ta-notify/README.md +29 -0
  275. package/dist/pi/packages/ta-notify/extension/index.mjs +259 -0
  276. package/dist/pi/packages/ta-notify/host/index.mjs +163 -0
  277. package/dist/pi/packages/ta-notify/lib/ask-card.d.ts +9 -0
  278. package/dist/pi/packages/ta-notify/lib/ask-card.js +40 -0
  279. package/dist/pi/packages/ta-notify/lib/extension.d.ts +24 -0
  280. package/dist/pi/packages/ta-notify/lib/extension.js +102 -0
  281. package/dist/pi/packages/ta-notify/lib/host.d.ts +4 -0
  282. package/dist/pi/packages/ta-notify/lib/host.js +9 -0
  283. package/dist/pi/packages/ta-notify/lib/i18n.d.ts +31 -0
  284. package/dist/pi/packages/ta-notify/lib/i18n.js +63 -0
  285. package/dist/pi/packages/ta-notify/lib/index.d.ts +8 -0
  286. package/dist/pi/packages/ta-notify/lib/index.js +29 -0
  287. package/dist/pi/packages/ta-notify/lib/notify-protocol.d.ts +74 -0
  288. package/dist/pi/packages/ta-notify/lib/notify-protocol.js +23 -0
  289. package/dist/pi/packages/ta-notify/lib/notify-service.d.ts +21 -0
  290. package/dist/pi/packages/ta-notify/lib/notify-service.js +75 -0
  291. package/dist/pi/packages/ta-notify/lib/notify-util.d.ts +39 -0
  292. package/dist/pi/packages/ta-notify/lib/notify-util.js +119 -0
  293. package/dist/pi/packages/ta-notify/lib/react.d.ts +8 -0
  294. package/dist/pi/packages/ta-notify/lib/react.js +8 -0
  295. package/dist/pi/packages/ta-notify/lib/server-texts.d.ts +9 -0
  296. package/dist/pi/packages/ta-notify/lib/server-texts.js +22 -0
  297. package/dist/pi/packages/ta-notify/lib/settings.d.ts +8 -0
  298. package/dist/pi/packages/ta-notify/lib/settings.js +85 -0
  299. package/dist/pi/packages/ta-notify/lib/style.d.ts +4 -0
  300. package/dist/pi/packages/ta-notify/lib/style.js +29 -0
  301. package/dist/pi/packages/ta-notify/lib/tool-line.d.ts +9 -0
  302. package/dist/pi/packages/ta-notify/lib/tool-line.js +20 -0
  303. package/dist/pi/packages/ta-notify/lib/tool.d.ts +37 -0
  304. package/dist/pi/packages/ta-notify/lib/tool.js +46 -0
  305. package/dist/pi/packages/ta-notify/lib/watcher.d.ts +15 -0
  306. package/dist/pi/packages/ta-notify/lib/watcher.js +81 -0
  307. package/dist/pi/packages/ta-notify/package.json +55 -0
  308. package/dist/pi/packages/ta-notify/web/index.js +436 -0
  309. package/dist/pi/packages/ta-recall/README.en.md +19 -0
  310. package/dist/pi/packages/ta-recall/README.md +19 -0
  311. package/dist/pi/packages/ta-recall/extension/index.mjs +614 -0
  312. package/dist/pi/packages/ta-recall/host/index.mjs +820 -0
  313. package/dist/pi/packages/ta-recall/lib/brief-card.d.ts +21 -0
  314. package/dist/pi/packages/ta-recall/lib/brief-card.js +67 -0
  315. package/dist/pi/packages/ta-recall/lib/brief-home.d.ts +49 -0
  316. package/dist/pi/packages/ta-recall/lib/brief-home.js +143 -0
  317. package/dist/pi/packages/ta-recall/lib/brief-seen.d.ts +9 -0
  318. package/dist/pi/packages/ta-recall/lib/brief-seen.js +26 -0
  319. package/dist/pi/packages/ta-recall/lib/brief-util.d.ts +64 -0
  320. package/dist/pi/packages/ta-recall/lib/brief-util.js +179 -0
  321. package/dist/pi/packages/ta-recall/lib/chat-icons.d.ts +8 -0
  322. package/dist/pi/packages/ta-recall/lib/chat-icons.js +56 -0
  323. package/dist/pi/packages/ta-recall/lib/composer.d.ts +7 -0
  324. package/dist/pi/packages/ta-recall/lib/composer.js +38 -0
  325. package/dist/pi/packages/ta-recall/lib/conversation-index.d.ts +25 -0
  326. package/dist/pi/packages/ta-recall/lib/conversation-index.js +72 -0
  327. package/dist/pi/packages/ta-recall/lib/conversation-util.d.ts +16 -0
  328. package/dist/pi/packages/ta-recall/lib/conversation-util.js +109 -0
  329. package/dist/pi/packages/ta-recall/lib/conversations.d.ts +11 -0
  330. package/dist/pi/packages/ta-recall/lib/conversations.js +46 -0
  331. package/dist/pi/packages/ta-recall/lib/extension.d.ts +24 -0
  332. package/dist/pi/packages/ta-recall/lib/extension.js +131 -0
  333. package/dist/pi/packages/ta-recall/lib/host.d.ts +4 -0
  334. package/dist/pi/packages/ta-recall/lib/host.js +11 -0
  335. package/dist/pi/packages/ta-recall/lib/i18n.d.ts +41 -0
  336. package/dist/pi/packages/ta-recall/lib/i18n.js +83 -0
  337. package/dist/pi/packages/ta-recall/lib/index.d.ts +9 -0
  338. package/dist/pi/packages/ta-recall/lib/index.js +45 -0
  339. package/dist/pi/packages/ta-recall/lib/react.d.ts +11 -0
  340. package/dist/pi/packages/ta-recall/lib/react.js +16 -0
  341. package/dist/pi/packages/ta-recall/lib/recall-protocol.d.ts +186 -0
  342. package/dist/pi/packages/ta-recall/lib/recall-protocol.js +60 -0
  343. package/dist/pi/packages/ta-recall/lib/recall-service.d.ts +42 -0
  344. package/dist/pi/packages/ta-recall/lib/recall-service.js +241 -0
  345. package/dist/pi/packages/ta-recall/lib/search-source.d.ts +7 -0
  346. package/dist/pi/packages/ta-recall/lib/search-source.js +49 -0
  347. package/dist/pi/packages/ta-recall/lib/search-util.d.ts +30 -0
  348. package/dist/pi/packages/ta-recall/lib/search-util.js +167 -0
  349. package/dist/pi/packages/ta-recall/lib/server-texts.d.ts +7 -0
  350. package/dist/pi/packages/ta-recall/lib/server-texts.js +17 -0
  351. package/dist/pi/packages/ta-recall/lib/settings.d.ts +4 -0
  352. package/dist/pi/packages/ta-recall/lib/settings.js +77 -0
  353. package/dist/pi/packages/ta-recall/lib/skill-card.d.ts +9 -0
  354. package/dist/pi/packages/ta-recall/lib/skill-card.js +51 -0
  355. package/dist/pi/packages/ta-recall/lib/skill-util.d.ts +19 -0
  356. package/dist/pi/packages/ta-recall/lib/skill-util.js +110 -0
  357. package/dist/pi/packages/ta-recall/lib/stored.d.ts +5 -0
  358. package/dist/pi/packages/ta-recall/lib/stored.js +28 -0
  359. package/dist/pi/packages/ta-recall/lib/style.d.ts +4 -0
  360. package/dist/pi/packages/ta-recall/lib/style.js +48 -0
  361. package/dist/pi/packages/ta-recall/lib/tool-line.d.ts +10 -0
  362. package/dist/pi/packages/ta-recall/lib/tool-line.js +23 -0
  363. package/dist/pi/packages/ta-recall/lib/tool.d.ts +63 -0
  364. package/dist/pi/packages/ta-recall/lib/tool.js +71 -0
  365. package/dist/pi/packages/ta-recall/package.json +55 -0
  366. package/dist/pi/packages/ta-recall/web/index.js +1038 -0
  367. package/dist/pi/packages/ta-rooms/README.en.md +23 -0
  368. package/dist/pi/packages/ta-rooms/README.md +23 -0
  369. package/dist/pi/packages/ta-rooms/lib/dialogs.d.ts +39 -0
  370. package/dist/pi/packages/ta-rooms/lib/dialogs.js +235 -0
  371. package/dist/pi/packages/ta-rooms/lib/i18n.d.ts +101 -0
  372. package/dist/pi/packages/ta-rooms/lib/i18n.js +203 -0
  373. package/dist/pi/packages/ta-rooms/lib/index.d.ts +9 -0
  374. package/dist/pi/packages/ta-rooms/lib/index.js +85 -0
  375. package/dist/pi/packages/ta-rooms/lib/members-view.d.ts +3 -0
  376. package/dist/pi/packages/ta-rooms/lib/members-view.js +64 -0
  377. package/dist/pi/packages/ta-rooms/lib/page.d.ts +105 -0
  378. package/dist/pi/packages/ta-rooms/lib/page.js +306 -0
  379. package/dist/pi/packages/ta-rooms/lib/react.d.ts +8 -0
  380. package/dist/pi/packages/ta-rooms/lib/react.js +8 -0
  381. package/dist/pi/packages/ta-rooms/lib/room-view.d.ts +17 -0
  382. package/dist/pi/packages/ta-rooms/lib/room-view.js +150 -0
  383. package/dist/pi/packages/ta-rooms/lib/rooms-page.d.ts +8 -0
  384. package/dist/pi/packages/ta-rooms/lib/rooms-page.js +174 -0
  385. package/dist/pi/packages/ta-rooms/lib/style.d.ts +4 -0
  386. package/dist/pi/packages/ta-rooms/lib/style.js +154 -0
  387. package/dist/pi/packages/ta-rooms/package.json +50 -0
  388. package/dist/pi/packages/ta-rooms/web/index.js +1932 -0
  389. package/dist/pi/packages/ta-share/README.en.md +27 -0
  390. package/dist/pi/packages/ta-share/README.md +27 -0
  391. package/dist/pi/packages/ta-share/extension/index.mjs +184 -0
  392. package/dist/pi/packages/ta-share/host/index.mjs +364 -0
  393. package/dist/pi/packages/ta-share/lib/extension.d.ts +15 -0
  394. package/dist/pi/packages/ta-share/lib/extension.js +115 -0
  395. package/dist/pi/packages/ta-share/lib/host.d.ts +4 -0
  396. package/dist/pi/packages/ta-share/lib/host.js +9 -0
  397. package/dist/pi/packages/ta-share/lib/i18n.d.ts +106 -0
  398. package/dist/pi/packages/ta-share/lib/i18n.js +213 -0
  399. package/dist/pi/packages/ta-share/lib/index.d.ts +9 -0
  400. package/dist/pi/packages/ta-share/lib/index.js +77 -0
  401. package/dist/pi/packages/ta-share/lib/page.d.ts +48 -0
  402. package/dist/pi/packages/ta-share/lib/page.js +105 -0
  403. package/dist/pi/packages/ta-share/lib/react.d.ts +8 -0
  404. package/dist/pi/packages/ta-share/lib/react.js +8 -0
  405. package/dist/pi/packages/ta-share/lib/server-texts.d.ts +14 -0
  406. package/dist/pi/packages/ta-share/lib/server-texts.js +52 -0
  407. package/dist/pi/packages/ta-share/lib/share-dialog.d.ts +18 -0
  408. package/dist/pi/packages/ta-share/lib/share-dialog.js +233 -0
  409. package/dist/pi/packages/ta-share/lib/share-protocol.d.ts +86 -0
  410. package/dist/pi/packages/ta-share/lib/share-protocol.js +30 -0
  411. package/dist/pi/packages/ta-share/lib/share-service.d.ts +50 -0
  412. package/dist/pi/packages/ta-share/lib/share-service.js +130 -0
  413. package/dist/pi/packages/ta-share/lib/shared-view.d.ts +18 -0
  414. package/dist/pi/packages/ta-share/lib/shared-view.js +225 -0
  415. package/dist/pi/packages/ta-share/lib/shares-page.d.ts +3 -0
  416. package/dist/pi/packages/ta-share/lib/shares-page.js +54 -0
  417. package/dist/pi/packages/ta-share/lib/snapshot.d.ts +30 -0
  418. package/dist/pi/packages/ta-share/lib/snapshot.js +195 -0
  419. package/dist/pi/packages/ta-share/lib/style.d.ts +4 -0
  420. package/dist/pi/packages/ta-share/lib/style.js +111 -0
  421. package/dist/pi/packages/ta-share/package.json +56 -0
  422. package/dist/pi/packages/ta-share/web/index.js +1197 -0
  423. package/dist/pi/packages/ta-workspace/README.md +1 -1
  424. package/dist/pi/packages/ta-workspace/README.zh-cn.md +1 -1
  425. package/dist/pi/packages/ta-workspace/lib/browser-common.d.ts +1 -1
  426. package/dist/pi/packages/ta-workspace/lib/browser-common.js +29 -30
  427. package/dist/pi/packages/ta-workspace/lib/browser-tool-line.d.ts +15 -0
  428. package/dist/pi/packages/ta-workspace/lib/browser-tool-line.js +70 -0
  429. package/dist/pi/packages/ta-workspace/lib/editors.js +29 -2
  430. package/dist/pi/packages/ta-workspace/lib/i18n.d.ts +13 -2
  431. package/dist/pi/packages/ta-workspace/lib/i18n.js +29 -7
  432. package/dist/pi/packages/ta-workspace/lib/index.js +2 -0
  433. package/dist/pi/packages/ta-workspace/lib/preview.d.ts +10 -1
  434. package/dist/pi/packages/ta-workspace/lib/preview.js +136 -11
  435. package/dist/pi/packages/ta-workspace/lib/style.d.ts +1 -1
  436. package/dist/pi/packages/ta-workspace/lib/style.js +56 -40
  437. package/dist/pi/packages/ta-workspace/lib/terminal-sessions.d.ts +15 -4
  438. package/dist/pi/packages/ta-workspace/lib/terminal-sessions.js +31 -9
  439. package/dist/pi/packages/ta-workspace/lib/terminal.d.ts +3 -2
  440. package/dist/pi/packages/ta-workspace/lib/terminal.js +51 -21
  441. package/dist/pi/packages/ta-workspace/lib/util/preview.d.ts +27 -0
  442. package/dist/pi/packages/ta-workspace/lib/util/preview.js +74 -0
  443. package/dist/pi/packages/ta-workspace/lib/util/terminal.d.ts +5 -0
  444. package/dist/pi/packages/ta-workspace/lib/util/terminal.js +14 -0
  445. package/dist/pi/packages/ta-workspace/package.json +1 -1
  446. package/dist/pi/packages/ta-workspace/web/index.js +823 -341
  447. package/dist/public/assets/OrbitControls-DVf70a7w.js +1 -0
  448. package/dist/public/assets/{abnfDiagram-S7VZAUFO-BmIko5tV.js → abnfDiagram-S7VZAUFO-D9uU0Tx2.js} +1 -1
  449. package/dist/public/assets/{architecture-WOLXFQ4H-XgsdQ7ul.js → architecture-WOLXFQ4H-f7Nm7EIo.js} +1 -1
  450. package/dist/public/assets/{architectureDiagram-YGSQEFNW--sVhMS03.js → architectureDiagram-YGSQEFNW-DSAqlcms.js} +1 -1
  451. package/dist/public/assets/{blockDiagram-APKKGZFW-8f9b-9k2.js → blockDiagram-APKKGZFW-C0lPIW9g.js} +1 -1
  452. package/dist/public/assets/{browser-DOHZ0JCf.js → browser-WLpgVYno.js} +1 -1
  453. package/dist/public/assets/{c4Diagram-KJ2TOQU5-CwYQ0Jfy.js → c4Diagram-KJ2TOQU5-CDcZ7mJq.js} +1 -1
  454. package/dist/public/assets/{chunk-6MUBBAK2-7Y9ezehi.js → chunk-6MUBBAK2-CXPuyqPL.js} +1 -1
  455. package/dist/public/assets/{chunk-AXFCVDMN-CZIH4pWz.js → chunk-AXFCVDMN-Du6JRX1x.js} +1 -1
  456. package/dist/public/assets/{chunk-BG4553SI-DsNATY2m.js → chunk-BG4553SI-D592E55X.js} +1 -1
  457. package/dist/public/assets/{chunk-DQASFODM-CoXkfYE-.js → chunk-DQASFODM-BW2r2SL4.js} +1 -1
  458. package/dist/public/assets/{chunk-HFQBQIA3-C5OLqki8.js → chunk-HFQBQIA3-C3yoe54R.js} +1 -1
  459. package/dist/public/assets/{chunk-KQLB2F66-DMHuYGEF.js → chunk-KQLB2F66-DF8gfYCy.js} +1 -1
  460. package/dist/public/assets/{chunk-KS47KZWR-BKeOttO1.js → chunk-KS47KZWR-C8CRMTv1.js} +1 -1
  461. package/dist/public/assets/{chunk-LEVMRMFU-D6zCwkk7.js → chunk-LEVMRMFU-BDcMKiwj.js} +1 -1
  462. package/dist/public/assets/{chunk-M57EVK23-B5-QqcZg.js → chunk-M57EVK23-CKJPBygc.js} +1 -1
  463. package/dist/public/assets/{chunk-OY52VR5R-DQrq3n0T.js → chunk-OY52VR5R-B3ZWH07L.js} +1 -1
  464. package/dist/public/assets/{chunk-QB3YPZ4I-j6ZT7EDR.js → chunk-QB3YPZ4I-DI-z4UPL.js} +1 -1
  465. package/dist/public/assets/{chunk-R3KSYZAL-D5MXUO36.js → chunk-R3KSYZAL-Bg4-haAc.js} +1 -1
  466. package/dist/public/assets/{chunk-STOXU5M4-DaBkw4dD.js → chunk-STOXU5M4-l_SHib3p.js} +1 -1
  467. package/dist/public/assets/{chunk-TU62E6Q5-vXcRfGci.js → chunk-TU62E6Q5-BINu9tIm.js} +1 -1
  468. package/dist/public/assets/{chunk-X4PVCEUW-CIh6H4Y2.js → chunk-X4PVCEUW-BQn-mvV5.js} +1 -1
  469. package/dist/public/assets/{chunk-XXDRQBXY-C_Vwv1FM.js → chunk-XXDRQBXY-uvpAu0Ys.js} +1 -1
  470. package/dist/public/assets/{classDiagram-v2-L25IHNXF-DccDWEJn.js → classDiagram-v2-L25IHNXF-BIowooW1.js} +1 -1
  471. package/dist/public/assets/{cose-bilkent-JH36ORCC-BX47lumZ.js → cose-bilkent-JH36ORCC-BTyx1Mh2.js} +1 -1
  472. package/dist/public/assets/cynefin-EF2NZ3EQ-Dg54eFzZ.js +1 -0
  473. package/dist/public/assets/{cynefinDiagram-L36ESFBY-BE6WOGxW.js → cynefinDiagram-L36ESFBY-D64EU9I0.js} +1 -1
  474. package/dist/public/assets/{d3-selection-ZcE6yRN5.js → d3-selection-CN9k6_B9.js} +1 -1
  475. package/dist/public/assets/{dagre-SPEB5RXH-CE6SOOcN.js → dagre-SPEB5RXH-FCbz2-Kk.js} +1 -1
  476. package/dist/public/assets/{diagram-3B7GL73J-xC8VtiYL.js → diagram-3B7GL73J-OhHUSI7j.js} +1 -1
  477. package/dist/public/assets/{diagram-DNEMPZML-4dmcBbjL.js → diagram-DNEMPZML-Be4xMtp6.js} +1 -1
  478. package/dist/public/assets/{diagram-L3MUGCDN-D14Yn3sQ.js → diagram-L3MUGCDN-CmKSs3aG.js} +1 -1
  479. package/dist/public/assets/{diagram-LA4NIPWU-GxSXIhsK.js → diagram-LA4NIPWU-D1C32rMN.js} +1 -1
  480. package/dist/public/assets/{diagram-MHCOC4E2-Cm7Prlpc.js → diagram-MHCOC4E2-BjoE6JXs.js} +1 -1
  481. package/dist/public/assets/{diagram-XPFHEONP-mkUnnKFu.js → diagram-XPFHEONP-B22k4v8R.js} +1 -1
  482. package/dist/public/assets/{dist-acJS-BlA.js → dist-DcBP8Cf6.js} +1 -1
  483. package/dist/public/assets/{ebnfDiagram-UZSYDL2S-m77ua3UQ.js → ebnfDiagram-UZSYDL2S-Tn-K8-X7.js} +1 -1
  484. package/dist/public/assets/{editor.api-CljTm-EQ.js → editor.api-Bz4sjRz_.js} +1 -1
  485. package/dist/public/assets/{elk-XV6XMXQE-DsQY1hw9.js → elk-XV6XMXQE-COnQsWlN.js} +1 -1
  486. package/dist/public/assets/{erDiagram-EYBAPDEH-CV8gJM0P.js → erDiagram-EYBAPDEH-c53dJilq.js} +1 -1
  487. package/dist/public/assets/{eventmodeling-K75KTNOO-C1pymbUr.js → eventmodeling-K75KTNOO-DaFpPPks.js} +1 -1
  488. package/dist/public/assets/flowDiagram-MALGAFMO-V5qkYWIO.js +1 -0
  489. package/dist/public/assets/{freemarker2-DYJXaMHN.js → freemarker2-BLxfRHsw.js} +1 -1
  490. package/dist/public/assets/{ganttDiagram-23REXITY-CppxOWRh.js → ganttDiagram-23REXITY-Md-SavIS.js} +1 -1
  491. package/dist/public/assets/gitGraph-VSP46ZUC-1q8ldRXU.js +1 -0
  492. package/dist/public/assets/{gitGraphDiagram-STJD7YCW-CrQrZhcP.js → gitGraphDiagram-STJD7YCW-CMSwTghO.js} +1 -1
  493. package/dist/public/assets/{handlebars-DZCnH9e2.js → handlebars-sNpu01kP.js} +1 -1
  494. package/dist/public/assets/{html-DuzouNES.js → html-C_tKd-uP.js} +1 -1
  495. package/dist/public/assets/{index-B7OYKvCE.js → index-Bn86rI4n.js} +2 -2
  496. package/dist/public/assets/info-OHQRW6UA-Crere6sx.js +1 -0
  497. package/dist/public/assets/{infoDiagram-KBXO4MBG-6pby19tQ.js → infoDiagram-KBXO4MBG-CwgNj-7i.js} +1 -1
  498. package/dist/public/assets/{ishikawaDiagram-M35NCXHK-Duf8c8rQ.js → ishikawaDiagram-M35NCXHK-BSlzQNMN.js} +1 -1
  499. package/dist/public/assets/{javascript-2d_L6cVd.js → javascript-l3qKw0L-.js} +1 -1
  500. package/dist/public/assets/{journeyDiagram-OPLOXDXO-Dvv-xzNo.js → journeyDiagram-OPLOXDXO-B09LPEnF.js} +1 -1
  501. package/dist/public/assets/{jsonMode-CFadYXyI.js → jsonMode-5SQQn1EX.js} +1 -1
  502. package/dist/public/assets/{kanban-definition-BZKZHSQY-Dsk6F-TT.js → kanban-definition-BZKZHSQY-BiW4aJ29.js} +1 -1
  503. package/dist/public/assets/{liquid-Din4CF34.js → liquid-BGyTIIUt.js} +1 -1
  504. package/dist/public/assets/{mdx-DivDuCWI.js → mdx-8tGjz4em.js} +1 -1
  505. package/dist/public/assets/{mermaid-parser.core-BfCv4CYZ.js → mermaid-parser.core-CctN5b0z.js} +3 -3
  506. package/dist/public/assets/{mermaid.core-DC20ZwJj.js → mermaid.core-7ERSdZ4-.js} +4 -4
  507. package/dist/public/assets/{mindmap-definition-I2QAS2VK-DRZRrJU_.js → mindmap-definition-I2QAS2VK-D-GOUwW1.js} +1 -1
  508. package/dist/public/assets/module-DEqsdd00.js +1 -0
  509. package/dist/public/assets/module-TWc52XwT.js +2244 -0
  510. package/dist/public/assets/{monaco-D1d6MOPe.js → monaco-B_9hlk78.js} +3 -3
  511. package/dist/public/assets/packet-JDAUHWVQ-qMf5LkHT.js +1 -0
  512. package/dist/public/assets/{pegDiagram-FD4XPPHP-DcGr3Tbk.js → pegDiagram-FD4XPPHP-Dmy1fWB3.js} +1 -1
  513. package/dist/public/assets/phaser.esm-BxCDEWDb.js +3202 -0
  514. package/dist/public/assets/pie-XZMESJXO-BjqLn4qm.js +1 -0
  515. package/dist/public/assets/{pieDiagram-J4AKIIQI-GF7pu6ch.js → pieDiagram-J4AKIIQI-CXFHLYTg.js} +1 -1
  516. package/dist/public/assets/{python-BQbTTTT5.js → python-e-JK0s5M.js} +1 -1
  517. package/dist/public/assets/{quadrantDiagram-XTYBLID2-D-bcu7Ey.js → quadrantDiagram-XTYBLID2-RQvEpGWO.js} +1 -1
  518. package/dist/public/assets/radar-ABXABTNO-DWO6t_4C.js +1 -0
  519. package/dist/public/assets/railroad-I3PHUGI6-D1XOJPWy.js +1 -0
  520. package/dist/public/assets/{railroad-abnf-LNEFI6M7-BiBHsI-K.js → railroad-abnf-LNEFI6M7-CDOSPZwX.js} +1 -1
  521. package/dist/public/assets/{railroad-ebnf-DWYD2UWJ-zKjrfkHs.js → railroad-ebnf-DWYD2UWJ-BTrNQ0DX.js} +1 -1
  522. package/dist/public/assets/{railroad-peg-JR7BVNR7-DKuVn0GT.js → railroad-peg-JR7BVNR7-B7NtVofS.js} +1 -1
  523. package/dist/public/assets/{railroadDiagram-MRQ6NCDL-Cyn-16mJ.js → railroadDiagram-MRQ6NCDL-DsDrT0Jf.js} +1 -1
  524. package/dist/public/assets/{razor-DiLk54O0.js → razor-DtSPwumi.js} +1 -1
  525. package/dist/public/assets/{requirementDiagram-Y7LWUY3S-CwU2EBkW.js → requirementDiagram-Y7LWUY3S-BQh0hFuA.js} +1 -1
  526. package/dist/public/assets/{sankeyDiagram-WGJFYUXA-ajf00HyW.js → sankeyDiagram-WGJFYUXA-BUXNAQEF.js} +1 -1
  527. package/dist/public/assets/{sequenceDiagram-5NDRBG5M-DiX_OIAw.js → sequenceDiagram-5NDRBG5M-05f-N5V_.js} +1 -1
  528. package/dist/public/assets/{stateDiagram-v2-FJ4FJNEA-CV5bRqB7.js → stateDiagram-v2-FJ4FJNEA-D6V1fGWV.js} +1 -1
  529. package/dist/public/assets/{swimlanes-UMQ2AFYF-BGQKSlj7.js → swimlanes-UMQ2AFYF-DWhlPvKs.js} +1 -1
  530. package/dist/public/assets/swimlanesDiagram-OMPLPG4O-CRn5uHsY.js +8 -0
  531. package/dist/public/assets/three.module-CeVBJVoU.js +4225 -0
  532. package/dist/public/assets/{timeline-definition-SEUHKTQE-DhQoApff.js → timeline-definition-SEUHKTQE-CMdocOui.js} +1 -1
  533. package/dist/public/assets/treeView-D4JQ5SDB-D09wHNzT.js +1 -0
  534. package/dist/public/assets/treemap-SAJKECNS-ChxAT7Fq.js +1 -0
  535. package/dist/public/assets/{typescript-COQ1g-up.js → typescript-65jNyipU.js} +1 -1
  536. package/dist/public/assets/{usecaseDiagram-AFA6YXN4-CmLFzjie.js → usecaseDiagram-AFA6YXN4-BQTHUX1f.js} +1 -1
  537. package/dist/public/assets/{vennDiagram-NNMJR3RB-DOa6JR5K.js → vennDiagram-NNMJR3RB-BULkVTfA.js} +1 -1
  538. package/dist/public/assets/wardley-7MLQ67FV-DfSjKzbJ.js +1 -0
  539. package/dist/public/assets/{wardleyDiagram-S7YFUSEH-BV7EEShp.js → wardleyDiagram-S7YFUSEH-Cek6l8lz.js} +1 -1
  540. package/dist/public/assets/{xml-BbvtjuaG.js → xml-DWBejfu-.js} +1 -1
  541. package/dist/public/assets/{xychartDiagram-GGNKY7IX-DtMpPbsq.js → xychartDiagram-GGNKY7IX-ujnZQTWA.js} +1 -1
  542. package/dist/public/assets/{yaml-Bw8NFga9.js → yaml-CwRCT7q1.js} +1 -1
  543. package/dist/public/index.html +1 -1
  544. package/dist/serve/index.mjs +5853 -2164
  545. package/package.json +32 -25
  546. package/dist/public/assets/cynefin-EF2NZ3EQ-MaI-3dMQ.js +0 -1
  547. package/dist/public/assets/flowDiagram-MALGAFMO-shBnAQFk.js +0 -1
  548. package/dist/public/assets/gitGraph-VSP46ZUC-BtQWboBz.js +0 -1
  549. package/dist/public/assets/info-OHQRW6UA-CDSLjba_.js +0 -1
  550. package/dist/public/assets/module-BAQaY56j.js +0 -1
  551. package/dist/public/assets/module-DxRGg3ED.js +0 -1947
  552. package/dist/public/assets/packet-JDAUHWVQ-dYb4P9eU.js +0 -1
  553. package/dist/public/assets/pie-XZMESJXO-CIompBnc.js +0 -1
  554. package/dist/public/assets/radar-ABXABTNO-DiJl7BtK.js +0 -1
  555. package/dist/public/assets/railroad-I3PHUGI6-B5cRBukM.js +0 -1
  556. package/dist/public/assets/swimlanesDiagram-OMPLPG4O-DxXlavVT.js +0 -8
  557. package/dist/public/assets/treeView-D4JQ5SDB-BOP6mkZC.js +0 -1
  558. package/dist/public/assets/treemap-SAJKECNS-BJxuPMz3.js +0 -1
  559. package/dist/public/assets/wardley-7MLQ67FV-jqlowjVL.js +0 -1
@@ -0,0 +1,499 @@
1
+ ---
2
+ name: physics-matter
3
+ description: "Use this skill when using Matter.js physics in Phaser 4. Covers rigid bodies, constraints, composite bodies, sensors, collision filtering, world configuration, and advanced physics shapes. Triggers on: Matter, matter physics, constraint, joint, rigid body, sensor."
4
+ ---
5
+
6
+ # Matter.js Physics
7
+ > Setting up and using Matter.js physics in Phaser 4 -- full-body physics with rigid bodies, compound bodies, constraints, composites, sensors, collision filtering, pointer dragging, tilemap integration, and debug rendering.
8
+
9
+ **Key source paths:** `src/physics/matter-js/MatterPhysics.js`, `src/physics/matter-js/World.js`, `src/physics/matter-js/Factory.js`, `src/physics/matter-js/MatterSprite.js`, `src/physics/matter-js/MatterImage.js`, `src/physics/matter-js/MatterGameObject.js`, `src/physics/matter-js/PointerConstraint.js`, `src/physics/matter-js/MatterTileBody.js`, `src/physics/matter-js/components/`, `src/physics/matter-js/events/`, `src/physics/matter-js/typedefs/`
10
+ **Related skills:** ../game-setup-and-config/SKILL.md, ../sprites-and-images/SKILL.md, ../physics-arcade/SKILL.md, ../tilemaps/SKILL.md
11
+
12
+ ## Quick Start
13
+
14
+ ```js
15
+ class GameScene extends Phaser.Scene {
16
+ create() {
17
+ // Matter sprite (dynamic, has animation support)
18
+ this.player = this.matter.add.sprite(400, 200, 'player');
19
+ this.player.setBounce(0.5);
20
+ this.player.setFriction(0.05);
21
+
22
+ // Matter image (dynamic, no animation)
23
+ const box = this.matter.add.image(300, 100, 'crate');
24
+
25
+ // Static body from raw shape
26
+ this.matter.add.rectangle(400, 580, 800, 40, { isStatic: true });
27
+
28
+ // Enable pointer dragging on all bodies
29
+ this.matter.add.mouseSpring();
30
+
31
+ this.cursors = this.input.keyboard.createCursorKeys();
32
+ }
33
+
34
+ update() {
35
+ if (this.cursors.left.isDown) {
36
+ this.player.setVelocityX(-5);
37
+ } else if (this.cursors.right.isDown) {
38
+ this.player.setVelocityX(5);
39
+ }
40
+ if (this.cursors.up.isDown && this.player.body.velocity.y > -0.1) {
41
+ this.player.setVelocityY(-10);
42
+ }
43
+ }
44
+ }
45
+
46
+ // Enable Matter physics in game config
47
+ const config = {
48
+ type: Phaser.AUTO,
49
+ width: 800,
50
+ height: 600,
51
+ physics: {
52
+ default: 'matter',
53
+ matter: {
54
+ gravity: { y: 1 },
55
+ enableSleeping: true,
56
+ debug: true,
57
+ setBounds: true // walls around canvas edges
58
+ }
59
+ },
60
+ scene: GameScene
61
+ };
62
+
63
+ const game = new Phaser.Game(config);
64
+ ```
65
+
66
+ ## Core Concepts
67
+
68
+ ### Scene Plugin (`this.matter`)
69
+
70
+ The `MatterPhysics` class is the scene-level plugin. Key properties:
71
+
72
+ - **`this.matter.add`** -- `Factory` for creating bodies, constraints, Game Objects (auto-added to world).
73
+ - **`this.matter.world`** -- `World` instance managing the engine, bounds, debug rendering. Extends `EventEmitter`.
74
+ - **`this.matter.body`** / **`bodies`** / **`composite`** / **`composites`** / **`constraint`** -- Direct references to Matter.js modules for low-level use.
75
+ - **`this.matter.bodyBounds`** -- Helper for aligning bodies by visual bounds.
76
+
77
+ ### World (`this.matter.world`)
78
+
79
+ - **`engine`** -- The `MatterJS.Engine` instance.
80
+ - **`localWorld`** -- The `MatterJS.World` composite containing all bodies and constraints.
81
+ - **`enabled`** -- Boolean; `false` pauses simulation. **`autoUpdate`** -- `true` = engine updates each game step.
82
+ - **`walls`** -- `{ left, right, top, bottom }` boundary wall bodies (or null).
83
+
84
+ ### World Config (`MatterWorldConfig`)
85
+
86
+ Passed under `physics.matter` in game or scene config:
87
+
88
+ | Property | Default | Purpose |
89
+ |---|---|---|
90
+ | `gravity` | `{ x: 0, y: 1 }` | Gravity vector. Set `false` to disable |
91
+ | `setBounds` | `false` | `true` or `{ x, y, width, height, thickness, left, right, top, bottom }` |
92
+ | `enableSleeping` | `false` | Allow bodies to sleep when at rest |
93
+ | `positionIterations` | `6` | Position solving accuracy |
94
+ | `velocityIterations` | `4` | Velocity solving accuracy |
95
+ | `constraintIterations` | `2` | Constraint stability |
96
+ | `timing.timeScale` | `1` | `0` freezes, `0.5` slow-motion |
97
+ | `autoUpdate` | `true` | Auto-step each game frame |
98
+ | `debug` | `false` | `true` or `MatterDebugConfig` object |
99
+ | `runner` | `{}` | Use `runner.fps` for fixed timestep |
100
+
101
+ ### Matter Game Objects
102
+
103
+ Phaser provides two physics-aware Game Object classes and a function to add physics to any Game Object:
104
+
105
+ - **`Phaser.Physics.Matter.Sprite`** -- Extends `Sprite` with all Matter components. Created via `this.matter.add.sprite(x, y, key, frame, options)`. Supports animations.
106
+ - **`Phaser.Physics.Matter.Image`** -- Extends `Image` with all Matter components. Created via `this.matter.add.image(x, y, key, frame, options)`. No animation support, lighter weight.
107
+ - **`MatterGameObject(world, gameObject, options)`** -- Injects all Matter components into any existing Game Object. Created via `this.matter.add.gameObject(mySprite, options)`.
108
+
109
+ Both `MatterSprite` and `MatterImage` default to a rectangle body matching the texture size. Pass `options.shape` to override.
110
+
111
+ ### Matter Components (Mixins)
112
+
113
+ All Matter Game Objects have these component methods mixed in:
114
+
115
+ | Component | Key Methods |
116
+ |---|---|
117
+ | **Velocity** | `setVelocity(x, y)`, `setVelocityX(x)`, `setVelocityY(y)`, `getVelocity()`, `setAngularVelocity(v)`, `getAngularVelocity()`, `setAngularSpeed(s)`, `getAngularSpeed()` |
118
+ | **Force** | `applyForce(vec2)`, `applyForceFrom(position, force)`, `thrust(speed)`, `thrustLeft(speed)`, `thrustRight(speed)`, `thrustBack(speed)` |
119
+ | **Bounce** | `setBounce(value)` -- restitution, 0 to 1 |
120
+ | **Friction** | `setFriction(value, air?, fstatic?)`, `setFrictionAir(value)`, `setFrictionStatic(value)` |
121
+ | **Mass** | `setMass(value)`, `setDensity(value)`, `centerOfMass` (getter) |
122
+ | **Gravity** | `setIgnoreGravity(bool)` |
123
+ | **Sensor** | `setSensor(bool)`, `isSensor()` |
124
+ | **Static** | `setStatic(bool)`, `isStatic()` |
125
+ | **Sleep** | `setToSleep()`, `setAwake()`, `setSleepThreshold(n)`, `setSleepEvents(start, end)` |
126
+ | **Collision** | `setCollisionCategory(cat)`, `setCollisionGroup(group)`, `setCollidesWith(cats)`, `setOnCollide(cb)`, `setOnCollideEnd(cb)`, `setOnCollideActive(cb)`, `setOnCollideWith(body, cb)` |
127
+ | **SetBody** | `setRectangle(w, h, opts)`, `setCircle(r, opts)`, `setPolygon(r, sides, opts)`, `setTrapezoid(w, h, slope, opts)`, `setBody(config, opts)`, `setExistingBody(body)` |
128
+ | **Transform** | Position sync between Matter body and Game Object |
129
+
130
+ ## Common Patterns
131
+
132
+ ### Setup and World Configuration
133
+
134
+ ```js
135
+ // Runtime gravity and bounds
136
+ this.matter.world.setGravity(0, 2); // x, y, scale (default 0.001)
137
+ this.matter.world.disableGravity();
138
+ this.matter.world.setBounds(0, 0, 1600, 1200, 64, true, true, true, true);
139
+
140
+ this.matter.set60Hz(); // fixed timestep
141
+ this.matter.world.autoUpdate = false; // then manual: this.matter.step(16.666);
142
+ this.matter.pause(); // pause/resume
143
+ this.matter.resume();
144
+ ```
145
+
146
+ ### Creating Matter Sprites and Images
147
+
148
+ ```js
149
+ const player = this.matter.add.sprite(200, 300, 'hero'); // default rect body matching texture
150
+
151
+ // Custom body shapes via options.shape
152
+ const ball = this.matter.add.image(400, 100, 'ball', null, { shape: { type: 'circle', radius: 24 } });
153
+ const hex = this.matter.add.sprite(300, 100, 'hex', null, { shape: { type: 'polygon', sides: 6, radius: 32 } });
154
+ const ship = this.matter.add.sprite(400, 200, 'ship', null, {
155
+ shape: { type: 'fromVerts', verts: '0 0 40 0 40 40 20 60 0 40' }
156
+ });
157
+
158
+ // PhysicsEditor shape data
159
+ const shapes = this.cache.json.get('shapes');
160
+ const enemy = this.matter.add.sprite(500, 200, 'enemy', null, { shape: shapes.enemy });
161
+
162
+ // Add Matter physics to an existing Game Object
163
+ const existingSprite = this.add.sprite(100, 100, 'box');
164
+ this.matter.add.gameObject(existingSprite, { restitution: 0.8 });
165
+ // existingSprite now has setVelocity, setBounce, etc.
166
+ ```
167
+
168
+ ### Body Configuration Options (`MatterBodyConfig`)
169
+
170
+ Pass as the `options` parameter to any factory method or as the options for a Matter Game Object:
171
+
172
+ - `label`, `isStatic`, `isSensor`, `angle` (radians), `timeScale`, `ignoreGravity`, `ignorePointer`
173
+ - `density` (0.001 default, auto-calculates mass), `mass`, `restitution` (bounce 0-1)
174
+ - `friction` (0-1), `frictionAir` (air resistance), `frictionStatic` (stickiness when still)
175
+ - `slop` (overlap tolerance), `chamfer` (`{ radius: 5 }` for rounded corners)
176
+ - `collisionFilter: { category: 0x0001, mask: 0xFFFFFFFF, group: 0 }`
177
+ - `onCollideCallback`, `onCollideEndCallback`, `onCollideActiveCallback`
178
+ - `shape` (for Game Objects): `{ type: 'circle', radius: 24 }` or PhysicsEditor data
179
+
180
+ ### Velocity, Forces, and Thrust
181
+
182
+ ```js
183
+ sprite.setVelocity(3, -5); // units per step, not pixels/sec
184
+ sprite.setVelocityX(-3);
185
+ sprite.setAngularVelocity(0.05);
186
+ const vel = sprite.getVelocity(); // { x, y }
187
+
188
+ // Forces use very small values (0.01 - 0.1)
189
+ sprite.applyForce({ x: 0.05, y: 0 });
190
+ sprite.applyForceFrom(position, { x: 0.02, y: -0.02 });
191
+
192
+ // Directional thrust relative to body angle
193
+ sprite.thrust(0.05); // forward
194
+ sprite.thrustBack(0.05); // backward
195
+ sprite.thrustLeft(0.03); // strafe left
196
+ sprite.thrustRight(0.03); // strafe right
197
+
198
+ // Batch operations via this.matter
199
+ this.matter.setVelocity(arrayOfBodies, 2, -3);
200
+ this.matter.applyForce(arrayOfBodies, { x: 0.01, y: 0 });
201
+ ```
202
+
203
+ ### Constraints (Joints and Springs)
204
+
205
+ ```js
206
+ // constraint(bodyA, bodyB, length?, stiffness?, options?) -- aliases: joint, spring
207
+ const rigid = this.matter.add.constraint(bodyA, bodyB, 100, 1); // rigid joint
208
+ const spring = this.matter.add.constraint(bodyA, bodyB, 200, 0.02, { damping: 0.05 });
209
+ const pin = this.matter.add.constraint(bodyA, bodyB, 0, 0.9); // pin joint
210
+
211
+ // World constraint (one body pinned to world point)
212
+ this.matter.add.worldConstraint(body, 50, 0.5, { pointA: { x: 400, y: 100 } });
213
+
214
+ // Offset attachment points
215
+ this.matter.add.constraint(bodyA, bodyB, 80, 1, {
216
+ pointA: { x: 20, y: 0 }, // offset from bodyA center
217
+ pointB: { x: -20, y: 0 } // offset from bodyB center
218
+ });
219
+
220
+ this.matter.getConstraintLength(constraint); // distance between anchor points
221
+ this.matter.world.removeConstraint(constraint); // remove from world
222
+ ```
223
+
224
+ ### Composites (Stacks, Chains, Soft Bodies)
225
+
226
+ ```js
227
+ // Stack of bodies in a grid
228
+ const stack = this.matter.add.stack(100, 100, 5, 4, 10, 10, (x, y) => {
229
+ return this.matter.bodies.rectangle(x, y, 40, 40);
230
+ });
231
+
232
+ // Image stack (grid of Matter Images)
233
+ const imageStack = this.matter.add.imageStack('crate', null, 100, 100, 5, 4, 5, 5);
234
+
235
+ // Chain bodies in a composite together
236
+ this.matter.add.chain(stack, 0.5, 0, -0.5, 0, { stiffness: 0.7 });
237
+
238
+ // Mesh (grid with constraints, optional cross braces)
239
+ this.matter.add.mesh(stack, 5, 4, true, { stiffness: 0.5 });
240
+
241
+ // Soft body (cols, rows, gaps, crossBrace, particleRadius, bodyOpts, constraintOpts)
242
+ this.matter.add.softBody(200, 100, 5, 5, 0, 0, true, 10, { friction: 0.1 }, { stiffness: 0.5 });
243
+
244
+ // Pre-built composites: newtonsCradle, car, pyramid
245
+ this.matter.add.newtonsCradle(300, 50, 5, 20, 200);
246
+ this.matter.add.car(400, 300, 120, 30, 25);
247
+ ```
248
+
249
+ ### Compound Bodies
250
+
251
+ Combine multiple shapes into a single body. The first part is the parent.
252
+
253
+ ```js
254
+ const partA = this.matter.bodies.rectangle(0, 0, 60, 20);
255
+ const partB = this.matter.bodies.circle(0, -30, 15);
256
+ const compoundBody = this.matter.body.create({ parts: [partA, partB] });
257
+
258
+ // Attach to a Game Object
259
+ const player = this.matter.add.sprite(400, 200, 'hero');
260
+ player.setExistingBody(compoundBody);
261
+ ```
262
+
263
+ Parts share position, angle, and velocity. Constraints must target the parent body, not parts.
264
+
265
+ ### Sleep System
266
+
267
+ Bodies at rest can sleep to skip simulation. Requires `enableSleeping: true` in config.
268
+
269
+ ```js
270
+ if (body.isSleeping) { /* body is at rest */ }
271
+ sprite.setSleepThreshold(30); // lower = falls asleep faster (default 60)
272
+ sprite.setToSleep(); // force sleep
273
+ sprite.setAwake(); // force wake
274
+ sprite.setSleepEvents(true, true); // enable sleepstart/sleepend events
275
+
276
+ this.matter.world.on('sleepstart', (event, body) => { /* body slept */ });
277
+ this.matter.world.on('sleepend', (event, body) => { /* body woke */ });
278
+ ```
279
+
280
+ ### Sensors
281
+
282
+ Sensors detect collisions but do not physically react. Useful for trigger zones, pickups, detection areas.
283
+
284
+ ```js
285
+ const trigger = this.matter.add.rectangle(400, 300, 100, 100, { isSensor: true, isStatic: true });
286
+ sprite.setSensor(true); // toggle on Game Object
287
+ sprite.isSensor(); // check state
288
+
289
+ // Sensors fire normal collision events -- use collisionstart/end to detect entry/exit
290
+ ```
291
+
292
+ ### Collision Categories and Filtering
293
+
294
+ Matter uses bitmasks: `category` (which group this body belongs to, power of 2), `mask` (which categories it collides with), and `group` (shortcut: same positive = always collide, same negative = never collide, 0 = use category/mask).
295
+
296
+ ```js
297
+ const PLAYER = this.matter.world.nextCategory(); // 0x0002 (32 max)
298
+ const ENEMY = this.matter.world.nextCategory(); // 0x0004
299
+ const GROUND = this.matter.world.nextCategory(); // 0x0008
300
+
301
+ player.setCollisionCategory(PLAYER);
302
+ player.setCollidesWith([ENEMY, GROUND]);
303
+
304
+ bullet.setCollisionCategory(0x0010);
305
+ bullet.setCollidesWith([ENEMY, GROUND]); // bullets skip player
306
+
307
+ // Collision groups: same negative = never collide with each other
308
+ const noCollide = this.matter.world.nextGroup(true);
309
+ spriteA.setCollisionGroup(noCollide);
310
+ spriteB.setCollisionGroup(noCollide);
311
+
312
+ // Via body config: collisionFilter: { category, mask, group }
313
+ // Batch: this.matter.setCollisionCategory([bodyA, bodyB], ENEMY);
314
+ ```
315
+
316
+ ### Collision Callbacks
317
+
318
+ ```js
319
+ // Per-body callbacks (on Matter Game Objects)
320
+ player.setOnCollide((pair) => { /* pair.bodyA, pair.bodyB */ });
321
+ player.setOnCollideEnd((pair) => { /* collision ended */ });
322
+ player.setOnCollideActive((pair) => { /* still colliding */ });
323
+ player.setOnCollideWith(enemy, (body, pair) => { /* hit specific body */ });
324
+
325
+ // Game Object-level events (emitted on the Game Object itself)
326
+ player.on('collide', (bodyA, bodyB, pair) => {});
327
+ player.on('collideEnd', (bodyA, bodyB, pair) => {});
328
+ ```
329
+
330
+ ### Tilemap Integration
331
+
332
+ ```js
333
+ const map = this.make.tilemap({ key: 'level' });
334
+ const tileset = map.addTilesetImage('tiles', 'tiles-img');
335
+ const layer = map.createLayer('Ground', tileset, 0, 0);
336
+
337
+ layer.setCollisionByProperty({ collides: true }); // MUST set collision first
338
+ this.matter.world.convertTilemapLayer(layer); // creates MatterTileBody per colliding tile
339
+
340
+ // Uses Tiled collision shapes (rect, circle, polygon) if defined, otherwise tile bounds.
341
+ // Access: tile.physics.matterBody
342
+ // Individual tile: this.matter.add.tileBody(tile, { isStatic: true, friction: 0.5 });
343
+ // After map changes: this.matter.world.convertTiles([tile1, tile2]);
344
+ ```
345
+
346
+ ### Friction Types
347
+
348
+ Matter.js has three independent friction values:
349
+
350
+ ```js
351
+ sprite.setFriction(0.1); // dynamic: resistance during motion (0-1)
352
+ sprite.setFrictionStatic(0.5); // static: resistance before motion starts
353
+ sprite.setFrictionAir(0.05); // air: environmental drag (default 0.01)
354
+ sprite.setFriction(0.1, 0.02, 0.3); // set all three: dynamic, air, static
355
+ ```
356
+
357
+ ### Complex Shapes from Vertices
358
+
359
+ ```js
360
+ // Create body from vertex string (concave shapes auto-decomposed)
361
+ const body = this.matter.add.fromVertices(400, 300, '0 0 40 0 40 40 20 60 0 40');
362
+
363
+ // Multiple vertex sets for complex shapes
364
+ const vertexSets = [
365
+ [{ x: 0, y: 0 }, { x: 40, y: 0 }, { x: 40, y: 40 }],
366
+ [{ x: 40, y: 40 }, { x: 20, y: 60 }, { x: 0, y: 40 }]
367
+ ];
368
+ this.matter.add.fromVertices(300, 200, vertexSets);
369
+ ```
370
+
371
+ ### Pointer Constraint (Mouse/Touch Dragging)
372
+
373
+ ```js
374
+ // Enable click-and-drag on all Matter bodies
375
+ const pc = this.matter.add.mouseSpring({ stiffness: 0.2, damping: 0.1 });
376
+
377
+ pc.active = false; // disable temporarily
378
+ body.ignorePointer = true; // prevent specific body from being dragged
379
+ pc.stopDrag(); // release current drag programmatically
380
+ pc.destroy(); // remove entirely
381
+
382
+ // Drag events on the world
383
+ this.matter.world.on('dragstart', (body, part, constraint) => {});
384
+ this.matter.world.on('drag', (body, constraint) => {});
385
+ this.matter.world.on('dragend', (body, constraint) => {});
386
+ ```
387
+
388
+ ### Queries (Raycasting and Hit Testing)
389
+
390
+ ```js
391
+ const hits = this.matter.intersectPoint(pointer.x, pointer.y); // bodies at point
392
+ const contains = this.matter.containsPoint(body, x, y); // point-in-body test
393
+ const inRegion = this.matter.intersectRect(100, 100, 200, 200); // bodies in rect
394
+ const rayHits = this.matter.intersectRay(0, 300, 800, 300, 1); // raycast
395
+ const colliding = this.matter.intersectBody(playerBody); // body overlap
396
+
397
+ // Overlap with callbacks
398
+ this.matter.overlap(playerBody, enemyBodies, (bodyA, bodyB, info) => {
399
+ console.log('Overlapping', bodyA, bodyB);
400
+ });
401
+ ```
402
+
403
+ ### Debug Rendering
404
+
405
+ ```js
406
+ // Enable debug with specific options (pass as debug property in matter config)
407
+ // Boolean flags: showBody, showStaticBody, showVelocity, showCollisions, showSensors,
408
+ // showJoint, showPositions, showBounds, showAxes, showAngleIndicator, showSleeping,
409
+ // showConvexHulls, showInternalEdges, renderFill, renderLine
410
+ // Color/style: lineColor, lineThickness, fillColor, staticLineColor, staticFillColor,
411
+ // sensorLineColor, jointColor, pinColor, springColor, anchorColor, positionColor
412
+
413
+ // Toggle debug at runtime
414
+ this.matter.world.drawDebug = false;
415
+ this.matter.world.debugGraphic.visible = false;
416
+
417
+ // Set render style on individual body or constraint
418
+ this.matter.world.setBodyRenderStyle(body, 0xff0000, 1, 2, 0x00ff00, 0.5);
419
+ this.matter.world.setConstraintRenderStyle(constraint, 0xffff00, 1, 2);
420
+ ```
421
+
422
+ ## Events
423
+
424
+ All events are emitted on `this.matter.world` (which extends `EventEmitter`):
425
+
426
+ | Event | Callback Signature | When |
427
+ |---|---|---|
428
+ | `'collisionstart'` | `(event, bodyA, bodyB)` | Two bodies first start colliding |
429
+ | `'collisionactive'` | `(event, bodyA, bodyB)` | Two bodies are still colliding |
430
+ | `'collisionend'` | `(event, bodyA, bodyB)` | Two bodies stop colliding |
431
+ | `'beforeupdate'` | `(event)` | Before engine update step |
432
+ | `'afterupdate'` | `(event)` | After engine update step |
433
+ | `'beforeadd'` | `(event)` | Before a body/constraint is added |
434
+ | `'afteradd'` | `(event)` | After a body/constraint is added |
435
+ | `'beforeremove'` | `(event)` | Before a body/constraint is removed |
436
+ | `'afterremove'` | `(event)` | After a body/constraint is removed |
437
+ | `'dragstart'` | `(body, part, constraint)` | Pointer starts dragging body |
438
+ | `'drag'` | `(body, constraint)` | Pointer is dragging body |
439
+ | `'dragend'` | `(body, constraint)` | Pointer stops dragging body |
440
+ | `'sleepstart'` | `(event, body)` | Body goes to sleep (requires `setSleepEvents`) |
441
+ | `'sleepend'` | `(event, body)` | Body wakes up (requires `setSleepEvents`) |
442
+ | `'pause'` | none | World paused |
443
+ | `'resume'` | none | World resumed |
444
+
445
+ Collision events include `event.pairs` -- an array of collision pair objects with `bodyA`, `bodyB`, collision depth, and normal.
446
+
447
+ ## API Quick Reference
448
+
449
+ ### `this.matter.add` (Factory)
450
+
451
+ **Game Objects:** `sprite(x, y, key, frame?, opts?)`, `image(x, y, key, frame?, opts?)`, `gameObject(go, opts?)`, `tileBody(tile, opts?)`
452
+ **Body shapes:** `rectangle(x, y, w, h, opts?)`, `circle(x, y, r, opts?)`, `polygon(x, y, sides, r, opts?)`, `trapezoid(x, y, w, h, slope, opts?)`, `fromVertices(x, y, verts, opts?)`, `fromPhysicsEditor(x, y, config, opts?)`, `fromSVG(x, y, xml, scale?, opts?)`, `fromJSON(x, y, config, opts?)`
453
+ **Constraints:** `constraint(a, b, len?, stiff?, opts?)` (aliases: `joint`, `spring`), `worldConstraint(body, len?, stiff?, opts?)`, `mouseSpring(opts?)` (alias: `pointerConstraint`)
454
+ **Composites:** `stack(x, y, cols, rows, colGap, rowGap, cb)`, `imageStack(key, frame, x, y, cols, rows)`, `pyramid(...)`, `chain(composite, xA, yA, xB, yB, opts?)`, `mesh(composite, cols, rows, cross, opts?)`, `softBody(...)`, `car(x, y, w, h, wheelSize)`, `newtonsCradle(x, y, num, size, len)`
455
+
456
+ ### `this.matter` (MatterPhysics) -- batch and utility
457
+
458
+ `pause()`, `resume()`, `set60Hz()`, `set30Hz()`, `step(delta?)`, `setVelocity(bodies, x, y)`, `setAngularVelocity(bodies, v)`, `applyForce(bodies, force)`, `applyForceFromAngle(bodies, speed, angle?)`, `containsPoint(body, x, y)`, `intersectPoint(x, y)`, `intersectRect(x, y, w, h, outside?)`, `intersectRay(x1, y1, x2, y2, width?)`, `intersectBody(body)`, `overlap(target, bodies?, cb?)`, `setCollisionCategory(bodies, value)`, `setCollisionGroup(bodies, value)`, `setCollidesWith(bodies, cats)`, `alignBody(body, x, y, align)`
459
+
460
+ ### `this.matter.world` (World)
461
+
462
+ `setBounds(x?, y?, w?, h?, thickness?, l?, r?, t?, b?)`, `setGravity(x?, y?, scale?)`, `disableGravity()`, `add(object)`, `remove(object, deep?)`, `removeConstraint(constraint)`, `convertTilemapLayer(layer, opts?)`, `convertTiles(tiles, opts?)`, `nextCategory()`, `nextGroup(isNonColliding?)`, `getAllBodies()`, `has(body)`, `pause()`, `resume()`
463
+
464
+ ### Direct Matter.js module references on `this.matter`
465
+
466
+ `body` (Matter.Body), `bodies` (Matter.Bodies), `composite` (Matter.Composite), `composites` (Matter.Composites), `constraint` (Matter.Constraint), `detector`, `query`, `pair`, `pairs`, `resolver`, `axes`, `bounds`, `svg`, `vector`, `vertices`
467
+
468
+ ## Gotchas
469
+
470
+ - **Force values are tiny.** Use `0.01`-`0.1` for forces, `1`-`15` for velocity. Not pixel-based.
471
+ - **`setBody`/`setRectangle`/etc. resets all properties** -- mass, friction, collision filters, callbacks are wiped. Re-apply after changing shape.
472
+ - **Constraints must target parent body**, not compound body `parts`.
473
+ - **32 collision categories max.** Each `nextCategory()` uses one bit.
474
+ - **`collisionFilter.group` overrides category/mask.** Same positive = always collide; same negative = never collide; zero/different = use category/mask.
475
+ - **Sensors still need matching collision filters** to fire events.
476
+ - **Matter position is center of mass**, not top-left (unlike Arcade Physics).
477
+ - **Sleep events require opt-in:** `sprite.setSleepEvents(true, true)`.
478
+ - **Tilemap conversion requires collision set first** via `setCollisionByProperty` etc.
479
+ - **Restitution uses `Math.max(bodyA.restitution, bodyB.restitution)`** -- the bouncier value wins.
480
+ - **`body.ignorePointer = true`** prevents pointer constraint from dragging that body.
481
+
482
+ ## Source File Map
483
+
484
+ | Path | Purpose |
485
+ |---|---|
486
+ | `src/physics/matter-js/MatterPhysics.js` | Scene plugin (`this.matter`), exposes all Matter modules |
487
+ | `src/physics/matter-js/World.js` | World management, engine, bounds, debug, events proxy |
488
+ | `src/physics/matter-js/Factory.js` | `this.matter.add` -- all creation methods |
489
+ | `src/physics/matter-js/MatterSprite.js` | Physics sprite (Sprite + Matter components) |
490
+ | `src/physics/matter-js/MatterImage.js` | Physics image (Image + Matter components) |
491
+ | `src/physics/matter-js/MatterGameObject.js` | Injects Matter components into any Game Object |
492
+ | `src/physics/matter-js/MatterTileBody.js` | Wraps a Tile with a Matter body |
493
+ | `src/physics/matter-js/PointerConstraint.js` | Click-and-drag body constraint |
494
+ | `src/physics/matter-js/BodyBounds.js` | Body alignment by visual bounds |
495
+ | `src/physics/matter-js/PhysicsEditorParser.js` | Parses PhysicsEditor JSON into bodies |
496
+ | `src/physics/matter-js/components/` | Mixins: Velocity, Force, Collision, SetBody, Sensor, Bounce, Friction, Mass, Gravity, Static, Sleep, Transform |
497
+ | `src/physics/matter-js/events/` | Event constants (COLLISION_START, DRAG_START, SLEEP_START, etc.) |
498
+ | `src/physics/matter-js/typedefs/` | TypeDefs: MatterWorldConfig, MatterBodyConfig, MatterCollisionFilter, MatterConstraintConfig, etc. |
499
+ | `src/physics/matter-js/lib/` | Bundled Matter.js library modules |