@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,450 @@
1
+ ---
2
+ name: scenes
3
+ description: "Use this skill when working with Phaser 4 scenes. Covers scene lifecycle methods, scene transitions, parallel scenes, scene communication, sleeping, pausing, restarting, and the SceneManager. Triggers on: Scene, scene lifecycle, preload, create, update, scene transition, SceneManager."
4
+ ---
5
+
6
+ # Scenes
7
+
8
+ > Scenes are the organizational backbone of a Phaser game. Each Scene has its own lifecycle (init, preload, create, update), its own set of injected systems (this.add, this.input, this.cameras, etc.), and can be started, stopped, paused, slept, or run in parallel with other Scenes. The ScenePlugin (`this.scene`) controls all multi-scene orchestration.
9
+
10
+ **Key source paths:** `src/scene/Scene.js`, `src/scene/Systems.js`, `src/scene/SceneManager.js`, `src/scene/ScenePlugin.js`, `src/scene/Settings.js`, `src/scene/const.js`, `src/scene/events/`, `src/scene/InjectionMap.js`
11
+ **Related skills:** ../game-setup-and-config/SKILL.md, ../loading-assets/SKILL.md, ../events-system/SKILL.md
12
+
13
+ ## Quick Start
14
+
15
+ ```js
16
+ // Minimal scene with all lifecycle methods
17
+ class GameScene extends Phaser.Scene {
18
+ constructor() {
19
+ super('GameScene');
20
+ }
21
+
22
+ init(data) {
23
+ // Called first. Receives data passed from other scenes.
24
+ // 'data' is whatever was passed via scene.start('GameScene', { level: 1 })
25
+ this.level = data.level || 1;
26
+ }
27
+
28
+ preload() {
29
+ // Called after init. Load assets here.
30
+ this.load.image('logo', 'assets/logo.png');
31
+ }
32
+
33
+ create(data) {
34
+ // Called after preload completes. Set up game objects.
35
+ // 'data' is the same object passed to init.
36
+ this.add.image(400, 300, 'logo');
37
+ }
38
+
39
+ update(time, delta) {
40
+ // Called every frame while scene is RUNNING.
41
+ // time: current time (ms), delta: ms since last frame (smoothed)
42
+ }
43
+ }
44
+
45
+ const config = {
46
+ width: 800,
47
+ height: 600,
48
+ scene: [GameScene]
49
+ };
50
+
51
+ const game = new Phaser.Game(config);
52
+ ```
53
+
54
+ ## Core Concepts
55
+
56
+ ### Scene Lifecycle
57
+
58
+ The lifecycle is driven by `SceneManager.bootScene()` and `SceneManager.create()`:
59
+
60
+ 1. **PENDING (0)** - Scene is registered but not yet started.
61
+ 2. **INIT (1)** - `scene.init(data)` is called if defined. Data comes from `settings.data`.
62
+ 3. **START (2)** - `Systems.start()` fires. Events `start` and `ready` are emitted.
63
+ 4. **LOADING (3)** - `scene.preload()` is called if defined. Loader runs. On completion, proceeds to create.
64
+ 5. **CREATING (4)** - `scene.create(data)` is called if defined. Same `data` as init.
65
+ 6. **RUNNING (5)** - `scene.update(time, delta)` called every frame. Scene renders.
66
+ 7. **PAUSED (6)** - No update, but still renders.
67
+ 8. **SLEEPING (7)** - No update, no render. State preserved in memory.
68
+ 9. **SHUTDOWN (8)** - Scene is shut down, systems emit `shutdown`. Can be restarted.
69
+ 10. **DESTROYED (9)** - Scene is fully destroyed. Cannot be restarted.
70
+
71
+ State constants are on `Phaser.Scenes`: `Phaser.Scenes.PENDING`, `Phaser.Scenes.RUNNING`, etc.
72
+
73
+ **Flow when no preload exists:** `init()` -> `create()` -> `update()` loop (preload is skipped entirely).
74
+
75
+ **Flow with preload:** `init()` -> `preload()` -> loader runs -> `create()` -> `update()` loop.
76
+
77
+ ### Scene-Injected Properties
78
+
79
+ These properties are injected into every Scene instance via the InjectionMap (`src/scene/InjectionMap.js`). The left side is the Systems key, the right is the Scene property name.
80
+
81
+ #### Global Managers (shared across all scenes)
82
+
83
+ | Scene Property | Type | Description |
84
+ |---|---|---|
85
+ | `this.game` | `Phaser.Game` | The Game instance |
86
+ | `this.renderer` | `CanvasRenderer \| WebGLRenderer` | The active renderer |
87
+ | `this.anims` | `Phaser.Animations.AnimationManager` | Global animation manager |
88
+ | `this.cache` | `Phaser.Cache.CacheManager` | Global cache for non-image assets |
89
+ | `this.plugins` | `Phaser.Plugins.PluginManager` | Global plugin manager |
90
+ | `this.registry` | `Phaser.Data.DataManager` | Global data manager (shared between scenes) |
91
+ | `this.scale` | `Phaser.Scale.ScaleManager` | Global scale manager |
92
+ | `this.sound` | `NoAudio \| HTML5Audio \| WebAudioSoundManager` | Sound manager |
93
+ | `this.textures` | `Phaser.Textures.TextureManager` | Global texture manager |
94
+
95
+ #### Scene-Specific Systems (unique per scene)
96
+
97
+ | Scene Property | Type | Description |
98
+ |---|---|---|
99
+ | `this.sys` | `Phaser.Scenes.Systems` | Scene systems (never overwrite) |
100
+ | `this.events` | `Phaser.Events.EventEmitter` | Scene-specific event emitter |
101
+ | `this.cameras` | `Phaser.Cameras.Scene2D.CameraManager` | Scene camera manager |
102
+ | `this.add` | `Phaser.GameObjects.GameObjectFactory` | Factory: creates and adds to display list |
103
+ | `this.make` | `Phaser.GameObjects.GameObjectCreator` | Creator: creates but does NOT add to display list |
104
+ | `this.scene` | `Phaser.Scenes.ScenePlugin` | Scene manager plugin (start/stop/launch) |
105
+ | `this.children` | `Phaser.GameObjects.DisplayList` | The scene display list |
106
+ | `this.lights` | `Phaser.GameObjects.LightsManager` | Scene lights (plugin) |
107
+ | `this.data` | `Phaser.Data.DataManager` | Scene-specific data manager |
108
+ | `this.input` | `Phaser.Input.InputPlugin` | Scene input manager (plugin) |
109
+ | `this.load` | `Phaser.Loader.LoaderPlugin` | Scene loader (plugin) |
110
+ | `this.time` | `Phaser.Time.Clock` | Scene time/clock (plugin) |
111
+ | `this.tweens` | `Phaser.Tweens.TweenManager` | Scene tween manager (plugin) |
112
+ | `this.physics` | `Phaser.Physics.Arcade.ArcadePhysics` | Arcade physics (if configured) |
113
+ | `this.matter` | `Phaser.Physics.Matter.MatterPhysics` | Matter physics (if configured) |
114
+
115
+ #### Customizing the Injection Map
116
+
117
+ ```js
118
+ // Rename injected properties via scene config
119
+ const config = {
120
+ key: 'MyScene',
121
+ map: {
122
+ add: 'makeStuff', // this.makeStuff instead of this.add
123
+ load: 'loader' // this.loader instead of this.load
124
+ }
125
+ };
126
+ ```
127
+
128
+ ### Scene Manager
129
+
130
+ The `SceneManager` (`src/scene/SceneManager.js`) is a game-level system. Do not call its methods directly -- use `this.scene` (the ScenePlugin) instead. The SceneManager:
131
+
132
+ - Maintains an ordered array of scenes (determines render/update order)
133
+ - Processes a queue of operations (start, stop, sleep, etc.) at the start of each game step
134
+ - All ScenePlugin methods are queued, not immediate (they execute next frame)
135
+
136
+ ## Common Patterns
137
+
138
+ ### Switching Between Scenes
139
+
140
+ ```js
141
+ // start() -- shuts down current scene, starts target scene
142
+ // Current scene gets SHUTDOWN event; target gets full lifecycle
143
+ this.scene.start('LevelTwo', { score: 100 });
144
+
145
+ // restart() -- shuts down and restarts the same scene
146
+ this.scene.restart({ score: 0 });
147
+
148
+ // switch() -- sleeps current scene, starts/wakes target scene
149
+ // Current scene state is preserved in memory
150
+ this.scene.switch('PauseMenu', { fromScene: 'GameScene' });
151
+
152
+ // transition() -- animated transition with duration
153
+ this.scene.transition({
154
+ target: 'LevelTwo',
155
+ duration: 1000,
156
+ moveAbove: true, // render target above this scene
157
+ sleep: false, // false = stop this scene (default), true = sleep it
158
+ remove: false, // true = remove this scene from manager after transition
159
+ allowInput: false, // allow input on this scene during transition
160
+ data: { score: 100 },
161
+ onUpdate: function (progress) {
162
+ // progress: 0 to 1 over duration
163
+ }
164
+ });
165
+ ```
166
+
167
+ ### Running Scenes in Parallel
168
+
169
+ ```js
170
+ // launch() -- starts another scene in parallel (does NOT stop current scene)
171
+ this.scene.launch('UIScene', { lives: 3 });
172
+
173
+ // run() -- smart launcher: starts if not running, resumes if paused, wakes if sleeping
174
+ this.scene.run('UIScene', { lives: 3 });
175
+
176
+ // Control render order of parallel scenes
177
+ this.scene.bringToTop('UIScene'); // render last (on top)
178
+ this.scene.sendToBack('Background'); // render first (behind)
179
+ this.scene.moveAbove('GameScene', 'UIScene'); // UIScene renders above GameScene
180
+ this.scene.moveBelow('GameScene', 'Background');
181
+ this.scene.moveUp('UIScene'); // move one position up
182
+ this.scene.moveDown('UIScene'); // move one position down
183
+ this.scene.swapPosition('SceneA', 'SceneB');
184
+ ```
185
+
186
+ ### Passing Data Between Scenes
187
+
188
+ ```js
189
+ // Method 1: Pass data via start/launch/restart/switch/wake/run
190
+ this.scene.start('LevelScene', { level: 5, score: 1200 });
191
+ // In LevelScene:
192
+ // init(data) { data.level === 5 }
193
+ // create(data) { data.score === 1200 }
194
+
195
+ // Method 2: Access data later via sys.getData()
196
+ // In receiving scene, at any time:
197
+ const data = this.sys.getData(); // returns settings.data
198
+
199
+ // Method 3: Global registry (shared across ALL scenes)
200
+ // In Scene A:
201
+ this.registry.set('playerHP', 100);
202
+ // In Scene B:
203
+ const hp = this.registry.get('playerHP'); // 100
204
+
205
+ // Method 4: Scene-specific data manager
206
+ this.data.set('localValue', 42);
207
+ this.data.get('localValue'); // 42
208
+
209
+ // Method 5: Direct scene reference
210
+ const otherScene = this.scene.get('OtherScene');
211
+ otherScene.somePublicProperty;
212
+
213
+ // Method 6: Events on the global registry
214
+ // In Scene A:
215
+ this.registry.events.on('changedata-playerHP', (parent, value, previousValue) => {
216
+ // react to change
217
+ });
218
+ // In Scene B:
219
+ this.registry.set('playerHP', 50); // triggers the event in Scene A
220
+ ```
221
+
222
+ ### Pausing and Resuming
223
+
224
+ ```js
225
+ // Pause: stops update loop, still renders
226
+ this.scene.pause(); // pause this scene
227
+ this.scene.pause('OtherScene'); // pause another scene
228
+
229
+ // Resume: restart update loop
230
+ this.scene.resume();
231
+ this.scene.resume('OtherScene', { message: 'welcome back' });
232
+
233
+ // Sleep: no update AND no render, but state preserved
234
+ this.scene.sleep();
235
+ this.scene.sleep('OtherScene');
236
+
237
+ // Wake: restore from sleep
238
+ this.scene.wake();
239
+ this.scene.wake('OtherScene', { data: 'here' });
240
+
241
+ // Stop: full shutdown, clears display list and timers
242
+ this.scene.stop();
243
+ this.scene.stop('OtherScene');
244
+
245
+ // Check state
246
+ this.scene.isActive('OtherScene'); // boolean
247
+ this.scene.isPaused('OtherScene'); // boolean
248
+ this.scene.isSleeping('OtherScene'); // boolean
249
+ this.scene.isVisible('OtherScene'); // boolean
250
+
251
+ // Control visibility/activity independently
252
+ this.scene.setActive(false); // pause
253
+ this.scene.setActive(true); // resume
254
+ this.scene.setVisible(false); // hide but still update
255
+ this.scene.setVisible(true); // show
256
+ ```
257
+
258
+ ### Adding and Removing Scenes at Runtime
259
+
260
+ ```js
261
+ // Add a new scene dynamically
262
+ this.scene.add('BonusLevel', BonusLevelScene, false, { someData: true });
263
+ // args: key, sceneConfig, autoStart, data
264
+
265
+ // Remove a scene entirely (destroyed, cannot be restarted)
266
+ this.scene.remove('BonusLevel');
267
+
268
+ // Spawn multiple instances from one class
269
+ for (let i = 0; i < 5; i++) {
270
+ this.scene.add('Level' + i, new LevelScene('Level' + i), false);
271
+ }
272
+ ```
273
+
274
+ ### Cross-Scene Event Communication
275
+
276
+ One scene emits custom events; another listens. The emitting scene is decoupled.
277
+
278
+ ```js
279
+ // GameScene emits events
280
+ class GameScene extends Phaser.Scene {
281
+ collectCoin(coin) {
282
+ coin.destroy();
283
+ this.events.emit('addScore', 10);
284
+ }
285
+ }
286
+
287
+ // UIScene listens (launched in parallel with { active: true })
288
+ class UIScene extends Phaser.Scene {
289
+ constructor() {
290
+ super({ key: 'UIScene', active: true });
291
+ }
292
+
293
+ create() {
294
+ this.score = 0;
295
+ this.scoreText = this.add.text(10, 10, 'Score: 0');
296
+
297
+ // Listen for events from GameScene
298
+ const gameScene = this.scene.get('GameScene');
299
+ gameScene.events.on('addScore', (points) => {
300
+ this.score += points;
301
+ this.scoreText.setText('Score: ' + this.score);
302
+ });
303
+ }
304
+ }
305
+ ```
306
+
307
+ ### Configuring Plugins Per Scene
308
+
309
+ Disable all default plugins (only core plugins remain):
310
+ ```js
311
+ super({ key: 'MinimalScene', plugins: [] });
312
+ // No this.load, this.tweens, this.time, this.input, this.data, this.lights
313
+ ```
314
+
315
+ Include only specific plugins:
316
+ ```js
317
+ super({ key: 'PreloadScene', plugins: ['Loader'] });
318
+ // Only this.load is available; this.tweens, this.time, etc. are undefined
319
+ ```
320
+
321
+ ### Scene Config in Constructor
322
+
323
+ Pass config to `super()` for per-scene physics, loader, or preloaded files:
324
+ ```js
325
+ class Level1 extends Phaser.Scene {
326
+ constructor() {
327
+ super({
328
+ key: 'Level1',
329
+ physics: { arcade: { debug: true, gravity: { y: 200 } } },
330
+ loader: { path: 'assets/levels/1/' },
331
+ // 'pack' loads files before preload() runs -- good for progress bar assets
332
+ pack: {
333
+ files: [
334
+ { type: 'image', key: 'bar', url: 'loaderBar.png' }
335
+ ]
336
+ }
337
+ });
338
+ }
339
+ }
340
+ ```
341
+
342
+ ### Safely Restarting Scenes
343
+
344
+ Reset state in `init()`, not the constructor. The constructor runs once; `init()` runs every start.
345
+
346
+ ```js
347
+ class GameScene extends Phaser.Scene {
348
+ constructor() {
349
+ super('GameScene');
350
+ // BAD: this.gameOver = false; -- only set once, not on restart
351
+ }
352
+
353
+ init() {
354
+ // GOOD: reset state every time the scene starts
355
+ this.gameOver = false;
356
+ this.score = 0;
357
+ }
358
+
359
+ create() {
360
+ // Clean up on shutdown to avoid stale references
361
+ this.events.once('shutdown', () => {
362
+ // Clear any arrays holding game object references
363
+ this.enemies = [];
364
+ });
365
+ }
366
+ }
367
+ ```
368
+
369
+ ## Events
370
+
371
+ All events are emitted on `this.events` (the scene-specific EventEmitter) and have string values. Listen via `this.events.on('eventname', callback)`.
372
+
373
+ ### Lifecycle Events
374
+
375
+ | Event String | Constant | Callback Signature | When |
376
+ |---|---|---|---|
377
+ | `'boot'` | `Phaser.Scenes.Events.BOOT` | `(sys)` | Once, when scene is first instantiated (for plugins) |
378
+ | `'start'` | `Phaser.Scenes.Events.START` | `(sys)` | Scene systems start (for plugins) |
379
+ | `'ready'` | `Phaser.Scenes.Events.READY` | `(sys, data)` | After start, for user code |
380
+ | `'create'` | `Phaser.Scenes.Events.CREATE` | `(scene)` | After `create()` method runs, scene is now RUNNING |
381
+ | `'preupdate'` | `Phaser.Scenes.Events.PRE_UPDATE` | `(time, delta)` | Before update each frame |
382
+ | `'update'` | `Phaser.Scenes.Events.UPDATE` | `(time, delta)` | During update each frame |
383
+ | `'postupdate'` | `Phaser.Scenes.Events.POST_UPDATE` | `(time, delta)` | After update each frame |
384
+ | `'prerender'` | `Phaser.Scenes.Events.PRE_RENDER` | `(renderer)` | Before scene renders |
385
+ | `'render'` | `Phaser.Scenes.Events.RENDER` | `(renderer)` | After scene renders |
386
+
387
+ ### State-Change Events
388
+
389
+ | Event String | Constant | Callback Signature | When |
390
+ |---|---|---|---|
391
+ | `'pause'` | `Phaser.Scenes.Events.PAUSE` | `(sys, data)` | Scene is paused |
392
+ | `'resume'` | `Phaser.Scenes.Events.RESUME` | `(sys, data)` | Scene is resumed |
393
+ | `'sleep'` | `Phaser.Scenes.Events.SLEEP` | `(sys, data)` | Scene is sent to sleep |
394
+ | `'wake'` | `Phaser.Scenes.Events.WAKE` | `(sys, data)` | Scene is woken up |
395
+ | `'shutdown'` | `Phaser.Scenes.Events.SHUTDOWN` | `(sys, data)` | Scene is shutting down |
396
+ | `'destroy'` | `Phaser.Scenes.Events.DESTROY` | `(sys)` | Scene is being destroyed |
397
+
398
+ ### Transition Events
399
+
400
+ | Event String | Constant | Callback Signature | Emitted On |
401
+ |---|---|---|---|
402
+ | `'transitionout'` | `TRANSITION_OUT` | `(targetScene, duration)` | Source scene |
403
+ | `'transitioninit'` | `TRANSITION_INIT` | `(fromScene, duration)` | Target scene (during init) |
404
+ | `'transitionstart'` | `TRANSITION_START` | `(fromScene, duration)` | Target scene (after create) |
405
+ | `'transitionwake'` | `TRANSITION_WAKE` | `(fromScene, duration)` | Target scene (if woken from sleep) |
406
+ | `'transitioncomplete'` | `TRANSITION_COMPLETE` | `(scene)` | Target scene (when done) |
407
+
408
+ ### Game Object Events
409
+
410
+ | Event String | Constant | Callback Signature |
411
+ |---|---|---|
412
+ | `'addedtoscene'` | `ADDED_TO_SCENE` | `(gameObject, scene)` |
413
+ | `'removedfromscene'` | `REMOVED_FROM_SCENE` | `(gameObject, scene)` |
414
+
415
+ For detailed API reference tables and source file maps, see [the reference guide](references/REFERENCE.md).
416
+
417
+ ## Gotchas and Common Mistakes
418
+
419
+ 1. **Operations are queued, not immediate.** Calling `this.scene.start('X')` does not start X synchronously. It happens at the next SceneManager update. Do not rely on the target scene's state within the same frame.
420
+
421
+ 2. **`start()` shuts down the calling scene.** `this.scene.start('X')` stops the current scene and starts X. If you want both running, use `launch()` or `run()`.
422
+
423
+ 3. **`switch()` sleeps, `start()` shuts down.** `switch()` preserves the current scene in memory (sleep), while `start()` triggers a full shutdown. Sleeping scenes still have their events and references live.
424
+
425
+ 4. **Paused scenes still render.** `pause()` only stops the update loop. The scene is still drawn. Use `sleep()` to stop both update and render.
426
+
427
+ 5. **Do not overwrite `this.sys`.** The Scene class JSDoc explicitly warns: overwriting `this.sys` will break everything.
428
+
429
+ 6. **`this.scene.start()` with no key restarts the current scene.** This is equivalent to `this.scene.restart()`.
430
+
431
+ 7. **Data passed to `start()`/`launch()` is available in both `init(data)` and `create(data)`.** It is stored in `settings.data` and accessible later via `this.sys.getData()`.
432
+
433
+ 8. **Sleeping scenes can still receive events from other scenes.** If Scene A is sleeping but Scene B emits on the global registry, Scene A's listeners still fire. Be careful with active listeners on sleeping scenes.
434
+
435
+ 9. **Scene render order = array order.** Scenes later in the array render on top. Use `bringToTop()`, `sendToBack()`, `moveAbove()`, `moveBelow()` to control layering.
436
+
437
+ 10. **`shutdown` vs `destroy`.** Shutdown puts a scene into hibernation (can restart). Destroy permanently removes it. Listen to `'shutdown'` to free resources that should be recreated on restart. Listen to `'destroy'` for final cleanup.
438
+
439
+ 11. **Plugin properties like `this.physics` and `this.matter` are only available if the physics system is configured.** They will be undefined otherwise.
440
+
441
+ 12. **The `create` event fires AFTER the `create()` method returns**, and after the status changes to RUNNING. If you need to do post-create setup, listen for this event.
442
+
443
+ 13. **Reset state in `init()`, not the constructor.** The constructor only runs once when the scene is first instantiated. `init()` runs every time the scene starts/restarts. Place state resets there.
444
+
445
+ 14. **Clean up on `shutdown` to avoid stale references.** Listen for `this.events.once('shutdown', ...)` to clear arrays holding game objects, remove external event listeners, etc. Stale references to destroyed game objects cause errors on restart.
446
+
447
+ 15. **`switch()` restarts a paused scene, never resumes it.** If you need resume behavior, use `run()` instead.
448
+
449
+ 16. **Scenes update in reverse order, render in forward order.** The top scene updates first (gets input priority), but renders last (appears on top). Establish render order in the game config scene array.
450
+
@@ -0,0 +1,78 @@
1
+ # Scenes — Reference
2
+
3
+ > API reference tables and source file maps for the scenes skill.
4
+
5
+ ## API Quick Reference
6
+
7
+ ### ScenePlugin Methods (`this.scene`)
8
+
9
+ All methods are queued and execute on the next Scene Manager update, not immediately.
10
+
11
+ | Method | Signature | Description |
12
+ |---|---|---|
13
+ | `start` | `(key?, data?) => this` | Stop this scene, start target. No key = restart self. |
14
+ | `restart` | `(data?) => this` | Stop and restart this scene |
15
+ | `launch` | `(key, data?) => this` | Start another scene in parallel |
16
+ | `run` | `(key, data?) => this` | Start/resume/wake another scene (smart) |
17
+ | `pause` | `(key?, data?) => this` | Pause scene (no key = this scene) |
18
+ | `resume` | `(key?, data?) => this` | Resume paused scene |
19
+ | `sleep` | `(key?, data?) => this` | Sleep scene (no update, no render) |
20
+ | `wake` | `(key?, data?) => this` | Wake sleeping scene |
21
+ | `switch` | `(key, data?) => this` | Sleep this scene, start/wake target |
22
+ | `stop` | `(key?, data?) => this` | Shutdown scene (no key = this scene) |
23
+ | `transition` | `(config) => boolean` | Animated transition to target scene |
24
+ | `get` | `(key) => Scene` | Get a scene reference by key |
25
+ | `getStatus` | `(key) => number` | Get scene status constant |
26
+ | `getIndex` | `(key?) => number` | Get scene position in scenes array |
27
+ | `add` | `(key, sceneConfig, autoStart?, data?) => Scene?` | Add new scene to manager |
28
+ | `remove` | `(key?) => this` | Remove and destroy scene |
29
+ | `setActive` | `(value, key?, data?) => this` | Set active state (true=resume, false=pause) |
30
+ | `setVisible` | `(value, key?) => this` | Set visible state |
31
+ | `isActive` | `(key?) => boolean` | Check if scene is running |
32
+ | `isPaused` | `(key?) => boolean` | Check if scene is paused |
33
+ | `isSleeping` | `(key?) => boolean` | Check if scene is sleeping |
34
+ | `isVisible` | `(key?) => boolean` | Check if scene is visible |
35
+ | `bringToTop` | `(key?) => this` | Render above all others |
36
+ | `sendToBack` | `(key?) => this` | Render below all others |
37
+ | `moveUp` | `(key?) => this` | Move one position up in render order |
38
+ | `moveDown` | `(key?) => this` | Move one position down in render order |
39
+ | `moveAbove` | `(keyA, keyB?) => this` | Move keyB above keyA |
40
+ | `moveBelow` | `(keyA, keyB?) => this` | Move keyB below keyA |
41
+ | `swapPosition` | `(keyA, keyB?) => this` | Swap positions of two scenes |
42
+
43
+ ### Systems Methods (`this.sys`)
44
+
45
+ | Method | Returns | Description |
46
+ |---|---|---|
47
+ | `getData()` | `any` | Get data passed to this scene |
48
+ | `getStatus()` | `number` | Current status constant |
49
+ | `isActive()` | `boolean` | Is RUNNING? |
50
+ | `isPaused()` | `boolean` | Is PAUSED? |
51
+ | `isSleeping()` | `boolean` | Is SLEEPING? |
52
+ | `isVisible()` | `boolean` | Is visible? |
53
+ | `isTransitioning()` | `boolean` | Is transitioning in or out? |
54
+ | `isTransitionOut()` | `boolean` | Is transitioning out? |
55
+ | `isTransitionIn()` | `boolean` | Is transitioning in? |
56
+ | `canInput()` | `boolean` | Can receive input? (status between PENDING and RUNNING) |
57
+ | `setActive(value, data?)` | `Systems` | Resume (true) or pause (false) |
58
+ | `setVisible(value)` | `Systems` | Set render visibility |
59
+ | `pause(data?)` | `Systems` | Pause this scene |
60
+ | `resume(data?)` | `Systems` | Resume this scene |
61
+ | `sleep(data?)` | `Systems` | Put to sleep |
62
+ | `wake(data?)` | `Systems` | Wake from sleep |
63
+
64
+ ## Source File Map
65
+
66
+ | File | Purpose |
67
+ |---|---|
68
+ | `src/scene/Scene.js` | Base Scene class with all injected property declarations |
69
+ | `src/scene/Systems.js` | Scene systems: lifecycle management, pause/resume/sleep/wake |
70
+ | `src/scene/SceneManager.js` | Game-level manager: boots scenes, runs lifecycle, processes queue |
71
+ | `src/scene/ScenePlugin.js` | `this.scene` plugin: user-facing API for scene operations |
72
+ | `src/scene/Settings.js` | Creates scene settings object from config |
73
+ | `src/scene/const.js` | Scene state constants (PENDING=0 through DESTROYED=9) |
74
+ | `src/scene/InjectionMap.js` | Maps Systems properties to Scene properties |
75
+ | `src/scene/events/index.js` | Event name exports |
76
+ | `src/scene/events/*_EVENT.js` | Individual event definitions with JSDoc signatures |
77
+ | `src/scene/GetPhysicsPlugins.js` | Resolves physics plugins for a scene |
78
+ | `src/scene/GetScenePlugins.js` | Resolves scene plugins |