@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,496 @@
1
+ ---
2
+ name: time-and-timers
3
+ description: "Use this skill when using timers and time-based events in Phaser 4. Covers TimerEvent, delayed calls, looping timers, the Clock plugin, and time scaling. Triggers on: timer, delay, delayedCall, TimerEvent, Clock, time event."
4
+ ---
5
+
6
+ # Time and Timers
7
+ > Clock plugin, TimerEvent, delays, loops, Timeline event sequencing, pausing time, time scale, and delta time in Phaser 4.
8
+
9
+ **Key source paths:** `src/time/Clock.js`, `src/time/TimerEvent.js`, `src/time/Timeline.js`, `src/time/typedefs/`, `src/time/events/`
10
+ **Related skills:** ../scenes/SKILL.md, ../tweens/SKILL.md
11
+
12
+ ## Quick Start
13
+
14
+ ```js
15
+ // In a Scene's create() method:
16
+
17
+ // One-shot delayed call (fires once after 1 second)
18
+ this.time.delayedCall(1000, () => {
19
+ console.log('One second later');
20
+ });
21
+
22
+ // Repeating timer (fires 5 times, once every 500ms)
23
+ this.time.addEvent({
24
+ delay: 500,
25
+ callback: () => { console.log('tick'); },
26
+ repeat: 4 // 4 repeats = 5 total fires
27
+ });
28
+
29
+ // Infinite loop timer
30
+ this.time.addEvent({
31
+ delay: 1000,
32
+ callback: this.spawnEnemy,
33
+ callbackScope: this,
34
+ loop: true
35
+ });
36
+ ```
37
+
38
+ `this.time` is the scene's `Clock` instance (registered as the `'Clock'` plugin under the key `time`). It creates and manages `TimerEvent` objects that fire callbacks based on game time.
39
+
40
+ ## Core Concepts
41
+
42
+ ### Clock (this.time)
43
+
44
+ The Clock is a Scene-level plugin that tracks game time and updates all of its TimerEvents each frame. Key properties:
45
+
46
+ - **`now`** -- current time in ms (equivalent to `time` passed to the scene `update` method).
47
+ - **`startTime`** -- timestamp when the scene started.
48
+ - **`timeScale`** -- multiplier applied to delta time. Default `1`. Values above 1 speed up all timers; below 1 slow them down; `0` freezes time.
49
+ - **`paused`** -- when `true`, no TimerEvents are updated.
50
+
51
+ The Clock listens to `PRE_UPDATE` (to flush pending additions/removals) and `UPDATE` (to tick active events). It is automatically shut down and destroyed with the scene.
52
+
53
+ ### TimerEvent
54
+
55
+ A TimerEvent accumulates elapsed time each frame: `elapsed += delta * clock.timeScale * event.timeScale`. When `elapsed >= delay`, the callback fires. After all repeats are exhausted the event is removed from the Clock on the next frame.
56
+
57
+ Key properties set via config: `delay`, `repeat`, `loop`, `callback`, `callbackScope`, `args`, `timeScale`, `startAt`, `paused`.
58
+
59
+ ### Timeline (this.add.timeline)
60
+
61
+ A Timeline is a sequencer for scheduling actions at specific points in time. Unlike the Clock (which manages independent timers), a Timeline runs a linear sequence of events keyed by absolute or relative timestamps.
62
+
63
+ ```js
64
+ const timeline = this.add.timeline([
65
+ { at: 0, run: () => { /* immediate */ } },
66
+ { at: 1000, run: () => { /* at 1s */ } },
67
+ { at: 2500, tween: { targets: sprite, alpha: 0, duration: 500 } }
68
+ ]);
69
+ timeline.play();
70
+ ```
71
+
72
+ Timelines always start **paused**. You must call `play()` to start them. They are created via the GameObjectFactory and destroyed automatically when the scene shuts down.
73
+
74
+ ## Common Patterns
75
+
76
+ ### Delayed Call
77
+
78
+ ```js
79
+ // Shorthand -- fires once, no repeat
80
+ this.time.delayedCall(2000, () => {
81
+ this.scene.start('GameOver');
82
+ });
83
+ ```
84
+
85
+ ### Repeating Timer with Finite Count
86
+
87
+ ```js
88
+ // repeat: 9 means 10 total fires (1 initial + 9 repeats)
89
+ const timer = this.time.addEvent({
90
+ delay: 200,
91
+ callback: this.fireBullet,
92
+ callbackScope: this,
93
+ repeat: 9
94
+ });
95
+
96
+ // Check progress
97
+ timer.getRepeatCount(); // repeats remaining
98
+ timer.getOverallProgress(); // 0..1 across all repeats
99
+ ```
100
+
101
+ ### Infinite Loop
102
+
103
+ ```js
104
+ const spawner = this.time.addEvent({
105
+ delay: 3000,
106
+ callback: this.spawnWave,
107
+ callbackScope: this,
108
+ loop: true
109
+ });
110
+
111
+ // Stop it later
112
+ spawner.remove(); // or spawner.paused = true to pause
113
+ ```
114
+
115
+ Setting `repeat: -1` is equivalent to `loop: true`.
116
+
117
+ ### First-Fire Shortcut with startAt
118
+
119
+ ```js
120
+ // First fire happens quickly (after 100ms), then every 2s
121
+ this.time.addEvent({
122
+ delay: 2000,
123
+ callback: this.heartbeat,
124
+ callbackScope: this,
125
+ loop: true,
126
+ startAt: 1900 // pre-fill elapsed so first fire is at 100ms
127
+ });
128
+ ```
129
+
130
+ ### Stopping and Removing Timers
131
+
132
+ ```js
133
+ const timer = this.time.addEvent({ delay: 1000, loop: true, callback: fn });
134
+
135
+ // Option 1: Remove from clock (schedules removal next frame)
136
+ timer.remove(); // silently expires
137
+ timer.remove(true); // fires callback one last time, then expires
138
+
139
+ // Option 2: Remove via Clock
140
+ this.time.removeEvent(timer);
141
+
142
+ // Option 3: Remove all timers
143
+ this.time.removeAllEvents();
144
+ ```
145
+
146
+ ### Pausing and Resuming
147
+
148
+ ```js
149
+ // Pause the entire Clock (all timers freeze)
150
+ this.time.paused = true;
151
+ this.time.paused = false;
152
+
153
+ // Pause a single timer
154
+ timer.paused = true;
155
+ timer.paused = false;
156
+ ```
157
+
158
+ ### Time Scale (Slow Motion / Fast Forward)
159
+
160
+ ```js
161
+ // Slow all timers in this scene to half speed
162
+ this.time.timeScale = 0.5;
163
+
164
+ // Speed up a single timer to 2x
165
+ timer.timeScale = 2;
166
+
167
+ // Combined: effective scale = clock.timeScale * event.timeScale
168
+ // So 0.5 * 2 = 1x for that specific timer
169
+ ```
170
+
171
+ ### Reading Timer State
172
+
173
+ ```js
174
+ timer.getProgress(); // 0..1 for current iteration
175
+ timer.getOverallProgress(); // 0..1 across all repeats
176
+ timer.getElapsed(); // ms elapsed this iteration
177
+ timer.getElapsedSeconds(); // seconds elapsed this iteration
178
+ timer.getRemaining(); // ms until next fire
179
+ timer.getRemainingSeconds(); // seconds until next fire
180
+ timer.getOverallRemaining(); // ms until final fire
181
+ timer.getOverallRemainingSeconds(); // seconds until final fire
182
+ timer.getRepeatCount(); // repeats left
183
+ ```
184
+
185
+ ### Timeline: Sequencing Events
186
+
187
+ ```js
188
+ const timeline = this.add.timeline([
189
+ {
190
+ at: 0,
191
+ run: () => { this.title.setAlpha(1); },
192
+ sound: 'intro'
193
+ },
194
+ {
195
+ at: 2000,
196
+ tween: { targets: this.title, y: 100, duration: 1000 },
197
+ sound: { key: 'whoosh', config: { volume: 0.5 } }
198
+ },
199
+ {
200
+ at: 4000,
201
+ set: { alpha: 0 },
202
+ target: this.title,
203
+ event: 'INTRO_DONE'
204
+ }
205
+ ]);
206
+
207
+ timeline.on('INTRO_DONE', (target) => { /* custom event */ });
208
+ timeline.on('complete', (tl) => { /* all events ran */ });
209
+ timeline.play();
210
+ ```
211
+
212
+ ### Timeline: Relative Timing with `from` and `in`
213
+
214
+ ```js
215
+ const timeline = this.add.timeline([
216
+ { at: 1000, run: stepOne }, // absolute: 1s from start
217
+ { from: 500, run: stepTwo }, // relative: 500ms after previous (1.5s)
218
+ { from: 1000, run: stepThree } // relative: 1000ms after previous (2.5s)
219
+ ]);
220
+ ```
221
+
222
+ - **`at`** -- absolute ms from timeline start (default 0).
223
+ - **`in`** -- offset from current `elapsed` time (useful when adding events to a running timeline).
224
+ - **`from`** -- offset from the previous event's start time.
225
+
226
+ Priority: `from` overrides `in`, which overrides `at`.
227
+
228
+ ### Timeline: Conditional Events
229
+
230
+ ```js
231
+ const timeline = this.add.timeline([
232
+ {
233
+ at: 5000,
234
+ if: () => this.player.health > 0,
235
+ run: () => { this.showBonusRound(); }
236
+ }
237
+ ]);
238
+ ```
239
+
240
+ If the `if` callback returns `false`, the event is skipped (marked complete but actions are not executed).
241
+
242
+ ### Timeline: Looping
243
+
244
+ ```js
245
+ const timeline = this.add.timeline([
246
+ { at: 0, run: () => console.log('start') },
247
+ { at: 1000, run: () => console.log('end') }
248
+ ]);
249
+
250
+ timeline.repeat().play(); // infinite loop
251
+ timeline.repeat(3).play(); // loop 3 additional times (4 total runs)
252
+ timeline.repeat(false).play(); // no looping
253
+ ```
254
+
255
+ The `loop` callback on a TimelineEventConfig fires on repeat iterations (not the first run).
256
+
257
+ ### Timeline: Pause, Resume, Stop, Reset
258
+
259
+ ```js
260
+ timeline.pause(); // freezes elapsed counter and pauses spawned tweens
261
+ timeline.resume(); // resumes elapsed counter and unpauses spawned tweens
262
+ timeline.stop(); // sets paused=true, complete=true
263
+ timeline.reset(); // elapsed=0, all events marked incomplete, starts playing
264
+ timeline.isPlaying(); // true if not paused and not complete
265
+ timeline.getProgress(); // 0..1 based on events completed / total events
266
+ ```
267
+
268
+ ### Timeline: Time Scale
269
+
270
+ ```js
271
+ timeline.timeScale = 2; // double speed
272
+ timeline.timeScale = 0.5; // half speed
273
+ ```
274
+
275
+ Note: Timeline `timeScale` does not affect tweens created by the timeline. Set tween timeScale separately.
276
+
277
+ ### Timeline: Full Cutscene Example
278
+
279
+ Timelines excel at choreographing cutscenes with mixed actions (callbacks, tweens, sounds, property sets, and custom events):
280
+
281
+ ```js
282
+ class CutsceneScene extends Phaser.Scene {
283
+ create() {
284
+ const timeline = this.add.timeline([
285
+ {
286
+ at: 0,
287
+ run: () => { console.log('Start!'); }
288
+ },
289
+ {
290
+ at: 1000,
291
+ tween: {
292
+ targets: this.player,
293
+ x: 400,
294
+ duration: 500,
295
+ ease: 'Power2'
296
+ }
297
+ },
298
+ {
299
+ at: 1500,
300
+ sound: 'doorOpen'
301
+ },
302
+ {
303
+ at: 2000,
304
+ set: { visible: true },
305
+ target: this.door
306
+ },
307
+ {
308
+ from: 500,
309
+ run: () => { console.log('Relative timing'); }
310
+ },
311
+ {
312
+ at: 5000,
313
+ event: 'cutsceneDone',
314
+ stop: true
315
+ }
316
+ ]);
317
+
318
+ timeline.on('cutsceneDone', () => {
319
+ this.scene.start('GameScene');
320
+ });
321
+
322
+ timeline.play();
323
+ }
324
+ }
325
+ ```
326
+
327
+ ### Timer Reset and Reuse
328
+
329
+ A completed `TimerEvent` can be reset with a new config and re-added to the Clock:
330
+
331
+ ```js
332
+ const timer = this.time.addEvent({
333
+ delay: 1000,
334
+ callback: this.phase1,
335
+ callbackScope: this,
336
+ repeat: 2
337
+ });
338
+
339
+ // Later, after it completes, reconfigure and re-add:
340
+ timer.reset({
341
+ delay: 500,
342
+ callback: this.phase2,
343
+ callbackScope: this,
344
+ repeat: 4
345
+ });
346
+ this.time.addEvent(timer); // must re-add; reset() alone does not schedule it
347
+ ```
348
+
349
+ ## Configuration Reference
350
+
351
+ ### TimerEventConfig
352
+
353
+ | Property | Type | Default | Description |
354
+ |---|---|---|---|
355
+ | `delay` | number | `0` | Delay in ms before the callback fires |
356
+ | `repeat` | number | `0` | Times to repeat after first fire. Use `-1` for infinite |
357
+ | `loop` | boolean | `false` | If `true`, repeats indefinitely (same as `repeat: -1`) |
358
+ | `callback` | function | -- | Function called when the timer fires |
359
+ | `callbackScope` | any | TimerEvent | The `this` context for the callback |
360
+ | `args` | Array | `[]` | Extra arguments passed to the callback |
361
+ | `timeScale` | number | `1` | Per-event time multiplier |
362
+ | `startAt` | number | `0` | Pre-fill elapsed time in ms (makes first fire happen sooner) |
363
+ | `paused` | boolean | `false` | Start the timer in a paused state |
364
+
365
+ ### TimelineEventConfig
366
+
367
+ | Property | Type | Default | Description |
368
+ |---|---|---|---|
369
+ | `at` | number | `0` | Absolute time in ms from timeline start |
370
+ | `in` | number | -- | Offset from current elapsed (overrides `at`) |
371
+ | `from` | number | -- | Offset from previous event time (overrides `at` and `in`) |
372
+ | `run` | function | -- | Callback invoked when event fires |
373
+ | `loop` | function | -- | Callback invoked on repeat iterations (not first run) |
374
+ | `if` | function | -- | Guard function; return `false` to skip the event |
375
+ | `event` | string | -- | Event name emitted on the Timeline instance |
376
+ | `target` | any | -- | Scope for `run`/`loop`/`if` and target for `set` |
377
+ | `set` | object | -- | Key-value pairs applied to `target` when event fires |
378
+ | `tween` | TweenConfig | -- | Tween config or instance created when event fires |
379
+ | `sound` | string/object | -- | Sound key or `{ key, config }` to play |
380
+ | `once` | boolean | `false` | Remove this event after it fires |
381
+ | `stop` | boolean | `false` | Stop the entire timeline when this event fires |
382
+
383
+ ### TimelineEvent (Internal)
384
+
385
+ The processed event object stored in `timeline.events[]`. Extends config with:
386
+
387
+ | Property | Type | Description |
388
+ |---|---|---|
389
+ | `complete` | boolean | Whether this event has fired |
390
+ | `time` | number | Resolved absolute time in ms |
391
+ | `repeat` | number | How many times this event has repeated |
392
+ | `tweenInstance` | Tween/TweenChain | Reference to spawned tween (if any) |
393
+
394
+ ## Events
395
+
396
+ ### Timeline Events
397
+
398
+ | Event | Constant | Listener Signature | Fired When |
399
+ |---|---|---|---|
400
+ | `'complete'` | `Phaser.Time.Events.COMPLETE` | `(timeline)` | All timeline events have been run |
401
+
402
+ Custom events via the `event` property in TimelineEventConfig are also emitted on the Timeline instance with signature `(target)`.
403
+
404
+ ### TimerEvent / Clock
405
+
406
+ TimerEvent and Clock do not emit EventEmitter events. Timers use the `callback` property directly. The Clock is managed by scene lifecycle events (`PRE_UPDATE`, `UPDATE`, `SHUTDOWN`, `DESTROY`).
407
+
408
+ ## API Quick Reference
409
+
410
+ ### Clock (this.time)
411
+
412
+ | Method | Signature | Returns | Description |
413
+ |---|---|---|---|
414
+ | `addEvent` | `(config \| TimerEvent)` | `TimerEvent` | Create and schedule a timer event |
415
+ | `delayedCall` | `(delay, callback, args?, scope?)` | `TimerEvent` | Shorthand for a one-shot delayed call |
416
+ | `removeEvent` | `(event \| event[])` | `this` | Remove specific timer(s) |
417
+ | `removeAllEvents` | `()` | `this` | Schedule removal of all active timers |
418
+ | `clearPendingEvents` | `()` | `this` | Clear timers not yet added to active list |
419
+
420
+ | Property | Type | Description |
421
+ |---|---|---|
422
+ | `now` | number | Current clock time in ms |
423
+ | `startTime` | number | Time the scene started |
424
+ | `timeScale` | number | Delta multiplier for all timers |
425
+ | `paused` | boolean | Freeze all timers |
426
+
427
+ ### TimerEvent
428
+
429
+ | Method | Returns | Description |
430
+ |---|---|---|
431
+ | `getProgress()` | number | 0..1 progress of current iteration |
432
+ | `getOverallProgress()` | number | 0..1 progress across all repeats |
433
+ | `getElapsed()` | number | Elapsed ms this iteration |
434
+ | `getElapsedSeconds()` | number | Elapsed seconds this iteration |
435
+ | `getRemaining()` | number | Ms until next fire |
436
+ | `getRemainingSeconds()` | number | Seconds until next fire |
437
+ | `getOverallRemaining()` | number | Ms until final fire |
438
+ | `getOverallRemainingSeconds()` | number | Seconds until final fire |
439
+ | `getRepeatCount()` | number | Repeats remaining |
440
+ | `remove(dispatchCallback?)` | void | Expire the timer (optionally fire callback) |
441
+ | `reset(config)` | TimerEvent | Reinitialize with new config |
442
+ | `destroy()` | void | Null out callback references |
443
+
444
+ ### Timeline (this.add.timeline)
445
+
446
+ | Method | Signature | Returns | Description |
447
+ |---|---|---|---|
448
+ | `add` | `(config \| config[])` | `this` | Append events to the timeline |
449
+ | `play` | `(fromStart?)` | `this` | Start playing (default resets to start) |
450
+ | `pause` | `()` | `this` | Pause timeline and spawned tweens |
451
+ | `resume` | `()` | `this` | Resume timeline and spawned tweens |
452
+ | `stop` | `()` | `this` | Stop (sets paused + complete) |
453
+ | `reset` | `(loop?)` | `this` | Reset elapsed and all events to incomplete |
454
+ | `repeat` | `(amount?)` | `this` | Set loop count (-1/true=infinite, false=none) |
455
+ | `clear` | `()` | `this` | Remove all events, reset elapsed, pause |
456
+ | `isPlaying` | `()` | boolean | True if not paused and not complete |
457
+ | `getProgress` | `()` | number | 0..1 based on completed event count |
458
+
459
+ | Property | Type | Description |
460
+ |---|---|---|
461
+ | `elapsed` | number | Current elapsed time in ms |
462
+ | `timeScale` | number | Delta multiplier (does not affect spawned tweens) |
463
+ | `paused` | boolean | Whether timeline is paused |
464
+ | `complete` | boolean | Whether all events have run |
465
+ | `loop` | number | Number of additional loops (0=none, -1=infinite) |
466
+ | `iteration` | number | Current loop iteration |
467
+ | `totalComplete` | number | Count of events that have fired |
468
+ | `events` | TimelineEvent[] | The internal event array |
469
+
470
+ ## Gotchas
471
+
472
+ 1. **repeat vs total fires.** `repeat: 4` means 5 total callback invocations (1 initial + 4 repeats). This is a common off-by-one source.
473
+ 2. **Zero delay with repeat throws.** A `TimerEvent` with `delay: 0` and any repeat/loop will throw `'TimerEvent infinite loop created via zero delay'`.
474
+ 3. **Timelines start paused.** You must call `timeline.play()` after creation. Forgetting this is a frequent mistake.
475
+ 4. **Timeline timeScale does not affect tweens.** Setting `timeline.timeScale` only scales the timeline's own elapsed counter. Tweens created by the timeline run at their own speed. Set tween `timeScale` separately or use the TweenManager.
476
+ 5. **once events are removed permanently.** Timeline events with `once: true` are spliced out after firing and will not reappear on `reset()` or when looping.
477
+ 6. **Timer additions are deferred.** `addEvent()` pushes to a pending list processed in `preUpdate`. The timer will not be active until the next frame.
478
+ 7. **Clock paused vs timeScale 0.** Both freeze timers, but `paused = true` skips the update loop entirely, while `timeScale = 0` still runs the loop with zero delta. Prefer `paused` for a full freeze.
479
+ 8. **callbackScope default.** If you omit `callbackScope`, the TimerEvent itself becomes `this` inside the callback, not the scene. Use arrow functions or pass `callbackScope: this` explicitly.
480
+ 9. **Reusing TimerEvent instances.** You can pass a `TimerEvent` object to `addEvent()`, but it must not be in a completed state. The Clock will reset its elapsed and dispatch state.
481
+ 10. **Timeline `from` chains.** Each `from` offset is relative to the previous event's resolved time, not the previous `from` value. Events are processed in array order.
482
+ 11. **Scene pause pauses the Timeline.** When a scene is paused (`scene.pause()`), the Timeline's update loop stops too, since Timeline updates are driven by the scene's update step.
483
+ 12. **`timer.reset()` does not re-add to Clock.** Calling `timer.reset(config)` reinitializes the timer but does not schedule it. You must call `this.time.addEvent(timer)` again after resetting.
484
+
485
+ ## Source File Map
486
+
487
+ | File | Description |
488
+ |---|---|
489
+ | `src/time/Clock.js` | Scene Clock plugin -- creates, updates, removes TimerEvents |
490
+ | `src/time/TimerEvent.js` | Individual timer -- delay, repeat, loop, progress tracking |
491
+ | `src/time/Timeline.js` | Event sequencer -- scheduled actions, tweens, sounds, looping |
492
+ | `src/time/typedefs/TimerEventConfig.js` | Config typedef for `addEvent()` |
493
+ | `src/time/typedefs/TimelineEventConfig.js` | Config typedef for `timeline.add()` |
494
+ | `src/time/typedefs/TimelineEvent.js` | Internal event object typedef |
495
+ | `src/time/events/COMPLETE_EVENT.js` | `'complete'` event constant for Timeline |
496
+ | `src/time/events/index.js` | Events namespace barrel file |