yuzuha 0.2.0 → 0.3.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 (692) hide show
  1. package/CHANGELOG.md +29 -1
  2. package/README.md +22 -14
  3. package/VERSIONING.md +56 -7
  4. package/benchmarks/parser.mjs +1 -1
  5. package/benchmarks/run.mjs +3 -2
  6. package/dist/canvas/card.d.ts +10 -0
  7. package/dist/canvas/card.d.ts.map +1 -0
  8. package/dist/canvas/card.js +11 -0
  9. package/dist/canvas/card.js.map +1 -0
  10. package/dist/canvas.d.ts +30 -9
  11. package/dist/canvas.d.ts.map +1 -1
  12. package/dist/canvas.js +64 -9
  13. package/dist/canvas.js.map +1 -1
  14. package/dist/cli/config.d.ts.map +1 -1
  15. package/dist/cli/config.js +2 -1
  16. package/dist/cli/config.js.map +1 -1
  17. package/dist/cli/lint.d.ts.map +1 -1
  18. package/dist/cli/lint.js +1 -2
  19. package/dist/cli/lint.js.map +1 -1
  20. package/dist/cli/main.d.ts.map +1 -1
  21. package/dist/cli/main.js +8 -9
  22. package/dist/cli/main.js.map +1 -1
  23. package/dist/cli/scaffold.js +1 -1
  24. package/dist/cli/scaffold.js.map +1 -1
  25. package/dist/cli/scenarios.d.ts.map +1 -1
  26. package/dist/cli/scenarios.js +2 -1
  27. package/dist/cli/scenarios.js.map +1 -1
  28. package/dist/commands/context.d.ts.map +1 -1
  29. package/dist/commands/context.js +7 -2
  30. package/dist/commands/context.js.map +1 -1
  31. package/dist/domain/resource-batches.d.ts +6 -0
  32. package/dist/domain/resource-batches.d.ts.map +1 -1
  33. package/dist/domain/resource-batches.js +31 -0
  34. package/dist/domain/resource-batches.js.map +1 -1
  35. package/dist/framework/bot.d.ts +9 -5
  36. package/dist/framework/bot.d.ts.map +1 -1
  37. package/dist/framework/bot.js +51 -27
  38. package/dist/framework/bot.js.map +1 -1
  39. package/dist/framework/command-registry.d.ts +8 -7
  40. package/dist/framework/command-registry.d.ts.map +1 -1
  41. package/dist/framework/command-registry.js +14 -11
  42. package/dist/framework/command-registry.js.map +1 -1
  43. package/dist/framework/options.d.ts +3 -3
  44. package/dist/framework/options.d.ts.map +1 -1
  45. package/dist/framework/options.js.map +1 -1
  46. package/dist/{scripting → functions}/builtins/arguments.d.ts.map +1 -1
  47. package/dist/{scripting → functions}/builtins/arguments.js.map +1 -1
  48. package/dist/functions/builtins/canvas.d.ts +2 -0
  49. package/dist/functions/builtins/canvas.d.ts.map +1 -0
  50. package/dist/{scripting → functions}/builtins/canvas.js +1 -1
  51. package/dist/{scripting → functions}/builtins/canvas.js.map +1 -1
  52. package/dist/functions/builtins/context.d.ts +2 -0
  53. package/dist/functions/builtins/context.d.ts.map +1 -0
  54. package/dist/{scripting → functions}/builtins/context.js.map +1 -1
  55. package/dist/{scripting → functions}/builtins/definition.d.ts +1 -1
  56. package/dist/functions/builtins/definition.d.ts.map +1 -0
  57. package/dist/functions/builtins/definition.js.map +1 -0
  58. package/dist/functions/builtins/embeds.d.ts +3 -0
  59. package/dist/{scripting → functions}/builtins/embeds.d.ts.map +1 -1
  60. package/dist/{scripting → functions}/builtins/embeds.js +1 -1
  61. package/dist/functions/builtins/embeds.js.map +1 -0
  62. package/dist/functions/builtins/events.d.ts +2 -0
  63. package/dist/functions/builtins/events.d.ts.map +1 -0
  64. package/dist/{scripting → functions}/builtins/events.js.map +1 -1
  65. package/dist/functions/builtins/flow.d.ts +2 -0
  66. package/dist/functions/builtins/flow.d.ts.map +1 -0
  67. package/dist/{scripting → functions}/builtins/flow.js +2 -2
  68. package/dist/functions/builtins/flow.js.map +1 -0
  69. package/dist/functions/builtins/guards.d.ts +2 -0
  70. package/dist/functions/builtins/guards.d.ts.map +1 -0
  71. package/dist/{scripting → functions}/builtins/guards.js +1 -1
  72. package/dist/functions/builtins/guards.js.map +1 -0
  73. package/dist/functions/builtins/http.d.ts +2 -0
  74. package/dist/functions/builtins/http.d.ts.map +1 -0
  75. package/dist/{scripting → functions}/builtins/http.js +2 -2
  76. package/dist/functions/builtins/http.js.map +1 -0
  77. package/dist/functions/builtins/index.d.ts +5 -0
  78. package/dist/functions/builtins/index.d.ts.map +1 -0
  79. package/dist/functions/builtins/index.js.map +1 -0
  80. package/dist/functions/builtins/language/array-callbacks.d.ts +2 -0
  81. package/dist/functions/builtins/language/array-callbacks.d.ts.map +1 -0
  82. package/dist/{scripting → functions}/builtins/language/array-callbacks.js +1 -1
  83. package/dist/{scripting → functions}/builtins/language/array-callbacks.js.map +1 -1
  84. package/dist/functions/builtins/language/arrays.d.ts +2 -0
  85. package/dist/functions/builtins/language/arrays.d.ts.map +1 -0
  86. package/dist/{scripting → functions}/builtins/language/arrays.js +1 -1
  87. package/dist/{scripting → functions}/builtins/language/arrays.js.map +1 -1
  88. package/dist/{scripting → functions}/builtins/language/common.d.ts.map +1 -1
  89. package/dist/{scripting → functions}/builtins/language/common.js.map +1 -1
  90. package/dist/functions/builtins/language/decimals.d.ts +2 -0
  91. package/dist/functions/builtins/language/decimals.d.ts.map +1 -0
  92. package/dist/{scripting → functions}/builtins/language/decimals.js.map +1 -1
  93. package/dist/functions/builtins/language/index.d.ts +3 -0
  94. package/dist/functions/builtins/language/index.d.ts.map +1 -0
  95. package/dist/functions/builtins/language/index.js.map +1 -0
  96. package/dist/functions/builtins/language/loops.d.ts +4 -0
  97. package/dist/{scripting → functions}/builtins/language/loops.d.ts.map +1 -1
  98. package/dist/{scripting → functions}/builtins/language/loops.js +3 -3
  99. package/dist/{scripting → functions}/builtins/language/loops.js.map +1 -1
  100. package/dist/functions/builtins/language/numbers.d.ts +2 -0
  101. package/dist/functions/builtins/language/numbers.d.ts.map +1 -0
  102. package/dist/{scripting → functions}/builtins/language/numbers.js.map +1 -1
  103. package/dist/{scripting → functions}/builtins/language/objects.d.ts +1 -1
  104. package/dist/{scripting → functions}/builtins/language/objects.d.ts.map +1 -1
  105. package/dist/{scripting → functions}/builtins/language/objects.js.map +1 -1
  106. package/dist/functions/builtins/language/regex.d.ts +2 -0
  107. package/dist/functions/builtins/language/regex.d.ts.map +1 -0
  108. package/dist/{scripting → functions}/builtins/language/regex.js +1 -1
  109. package/dist/{scripting → functions}/builtins/language/regex.js.map +1 -1
  110. package/dist/functions/builtins/language/sort.d.ts +2 -0
  111. package/dist/functions/builtins/language/sort.d.ts.map +1 -0
  112. package/dist/{scripting → functions}/builtins/language/sort.js.map +1 -1
  113. package/dist/{scripting → functions}/builtins/language/state.d.ts +1 -1
  114. package/dist/{scripting → functions}/builtins/language/state.d.ts.map +1 -1
  115. package/dist/{scripting → functions}/builtins/language/state.js.map +1 -1
  116. package/dist/functions/builtins/language/texts.d.ts +2 -0
  117. package/dist/functions/builtins/language/texts.d.ts.map +1 -0
  118. package/dist/{scripting → functions}/builtins/language/texts.js.map +1 -1
  119. package/dist/functions/builtins/messages.d.ts +2 -0
  120. package/dist/functions/builtins/messages.d.ts.map +1 -0
  121. package/dist/{scripting → functions}/builtins/messages.js.map +1 -1
  122. package/dist/functions/builtins/moderation.d.ts +2 -0
  123. package/dist/functions/builtins/moderation.d.ts.map +1 -0
  124. package/dist/{scripting → functions}/builtins/moderation.js.map +1 -1
  125. package/dist/functions/builtins/native-channels.d.ts +2 -0
  126. package/dist/functions/builtins/native-channels.d.ts.map +1 -0
  127. package/dist/{scripting → functions}/builtins/native-channels.js.map +1 -1
  128. package/dist/functions/builtins/native-collectors.d.ts +2 -0
  129. package/dist/functions/builtins/native-collectors.d.ts.map +1 -0
  130. package/dist/{scripting → functions}/builtins/native-collectors.js.map +1 -1
  131. package/dist/functions/builtins/native-expressions.d.ts +2 -0
  132. package/dist/functions/builtins/native-expressions.d.ts.map +1 -0
  133. package/dist/{scripting → functions}/builtins/native-expressions.js.map +1 -1
  134. package/dist/functions/builtins/native-invites.d.ts +2 -0
  135. package/dist/functions/builtins/native-invites.d.ts.map +1 -0
  136. package/dist/{scripting → functions}/builtins/native-invites.js.map +1 -1
  137. package/dist/functions/builtins/native-messages.d.ts +2 -0
  138. package/dist/functions/builtins/native-messages.d.ts.map +1 -0
  139. package/dist/{scripting → functions}/builtins/native-messages.js.map +1 -1
  140. package/dist/functions/builtins/native-roles.d.ts +2 -0
  141. package/dist/functions/builtins/native-roles.d.ts.map +1 -0
  142. package/dist/{scripting → functions}/builtins/native-roles.js.map +1 -1
  143. package/dist/functions/builtins/native-threads.d.ts +2 -0
  144. package/dist/functions/builtins/native-threads.d.ts.map +1 -0
  145. package/dist/{scripting → functions}/builtins/native-threads.js.map +1 -1
  146. package/dist/functions/builtins/native-users.d.ts +2 -0
  147. package/dist/functions/builtins/native-users.d.ts.map +1 -0
  148. package/dist/{scripting → functions}/builtins/native-users.js.map +1 -1
  149. package/dist/functions/builtins/native-webhooks.d.ts +2 -0
  150. package/dist/functions/builtins/native-webhooks.d.ts.map +1 -0
  151. package/dist/{scripting → functions}/builtins/native-webhooks.js.map +1 -1
  152. package/dist/{scripting → functions}/builtins/payload.d.ts +2 -2
  153. package/dist/functions/builtins/payload.d.ts.map +1 -0
  154. package/dist/{scripting → functions}/builtins/payload.js +1 -1
  155. package/dist/functions/builtins/payload.js.map +1 -0
  156. package/dist/functions/builtins/resource-extras.d.ts +2 -0
  157. package/dist/functions/builtins/resource-extras.d.ts.map +1 -0
  158. package/dist/{scripting → functions}/builtins/resource-extras.js.map +1 -1
  159. package/dist/functions/builtins/schedule.d.ts +2 -0
  160. package/dist/functions/builtins/schedule.d.ts.map +1 -0
  161. package/dist/{scripting → functions}/builtins/schedule.js.map +1 -1
  162. package/dist/functions/builtins/storage.d.ts +2 -0
  163. package/dist/functions/builtins/storage.d.ts.map +1 -0
  164. package/dist/{scripting → functions}/builtins/storage.js.map +1 -1
  165. package/dist/functions/builtins/values.d.ts +2 -0
  166. package/dist/functions/builtins/values.d.ts.map +1 -0
  167. package/dist/{scripting → functions}/builtins/values.js +1 -1
  168. package/dist/functions/builtins/values.js.map +1 -0
  169. package/dist/functions/runtime/ast.d.ts.map +1 -0
  170. package/dist/functions/runtime/ast.js.map +1 -0
  171. package/dist/{scripting → functions/runtime}/canvas-execution.d.ts +1 -1
  172. package/dist/functions/runtime/canvas-execution.d.ts.map +1 -0
  173. package/dist/functions/runtime/canvas-execution.js.map +1 -0
  174. package/dist/functions/runtime/control-flow.d.ts.map +1 -0
  175. package/dist/functions/runtime/control-flow.js.map +1 -0
  176. package/dist/{scripting → functions/runtime}/evaluator.d.ts +1 -1
  177. package/dist/functions/runtime/evaluator.d.ts.map +1 -0
  178. package/dist/{scripting → functions/runtime}/evaluator.js +1 -1
  179. package/dist/functions/runtime/evaluator.js.map +1 -0
  180. package/dist/functions/runtime/limits.d.ts.map +1 -0
  181. package/dist/{scripting → functions/runtime}/limits.js +1 -1
  182. package/dist/functions/runtime/limits.js.map +1 -0
  183. package/dist/functions/runtime/parser.d.ts.map +1 -0
  184. package/dist/{scripting → functions/runtime}/parser.js +1 -1
  185. package/dist/functions/runtime/parser.js.map +1 -0
  186. package/dist/functions/runtime/regex.d.ts.map +1 -0
  187. package/dist/{scripting → functions/runtime}/regex.js +1 -1
  188. package/dist/functions/runtime/regex.js.map +1 -0
  189. package/dist/functions/runtime/registry.d.ts.map +1 -0
  190. package/dist/{scripting → functions/runtime}/registry.js +1 -1
  191. package/dist/functions/runtime/registry.js.map +1 -0
  192. package/dist/{scripting → functions/runtime}/runtime.d.ts +3 -1
  193. package/dist/functions/runtime/runtime.d.ts.map +1 -0
  194. package/dist/{scripting → functions/runtime}/runtime.js +3 -0
  195. package/dist/functions/runtime/runtime.js.map +1 -0
  196. package/dist/{scripting → functions/runtime}/types.d.ts +1 -1
  197. package/dist/functions/runtime/types.d.ts.map +1 -0
  198. package/dist/functions/runtime/types.js.map +1 -0
  199. package/dist/functions/runtime/values.d.ts.map +1 -0
  200. package/dist/functions/runtime/values.js.map +1 -0
  201. package/dist/functions.d.ts +19 -8
  202. package/dist/functions.d.ts.map +1 -1
  203. package/dist/functions.js +18 -6
  204. package/dist/functions.js.map +1 -1
  205. package/dist/index.d.ts +7 -2
  206. package/dist/index.d.ts.map +1 -1
  207. package/dist/index.js.map +1 -1
  208. package/dist/infrastructure/canvas/napi.d.ts +4 -0
  209. package/dist/infrastructure/canvas/napi.d.ts.map +1 -0
  210. package/dist/infrastructure/canvas/napi.js +17 -0
  211. package/dist/infrastructure/canvas/napi.js.map +1 -0
  212. package/dist/infrastructure/fluxer/resources/cache.d.ts +4 -0
  213. package/dist/infrastructure/fluxer/resources/cache.d.ts.map +1 -0
  214. package/dist/infrastructure/fluxer/resources/cache.js +68 -0
  215. package/dist/infrastructure/fluxer/resources/cache.js.map +1 -0
  216. package/dist/infrastructure/fluxer/resources/channels.d.ts +3 -2
  217. package/dist/infrastructure/fluxer/resources/channels.d.ts.map +1 -1
  218. package/dist/infrastructure/fluxer/resources/channels.js +54 -2
  219. package/dist/infrastructure/fluxer/resources/channels.js.map +1 -1
  220. package/dist/infrastructure/fluxer/resources/collectors.d.ts.map +1 -1
  221. package/dist/infrastructure/fluxer/resources/collectors.js +86 -4
  222. package/dist/infrastructure/fluxer/resources/collectors.js.map +1 -1
  223. package/dist/infrastructure/fluxer/resources/expressions.d.ts.map +1 -1
  224. package/dist/infrastructure/fluxer/resources/expressions.js +8 -1
  225. package/dist/infrastructure/fluxer/resources/expressions.js.map +1 -1
  226. package/dist/infrastructure/fluxer/resources/gateway.d.ts +4 -0
  227. package/dist/infrastructure/fluxer/resources/gateway.d.ts.map +1 -0
  228. package/dist/infrastructure/fluxer/resources/gateway.js +31 -0
  229. package/dist/infrastructure/fluxer/resources/gateway.js.map +1 -0
  230. package/dist/infrastructure/fluxer/resources/instance.d.ts +4 -0
  231. package/dist/infrastructure/fluxer/resources/instance.d.ts.map +1 -0
  232. package/dist/infrastructure/fluxer/resources/instance.js +96 -0
  233. package/dist/infrastructure/fluxer/resources/instance.js.map +1 -0
  234. package/dist/infrastructure/fluxer/resources/messages.d.ts +3 -1
  235. package/dist/infrastructure/fluxer/resources/messages.d.ts.map +1 -1
  236. package/dist/infrastructure/fluxer/resources/messages.js +91 -36
  237. package/dist/infrastructure/fluxer/resources/messages.js.map +1 -1
  238. package/dist/infrastructure/fluxer/resources/roles.d.ts.map +1 -1
  239. package/dist/infrastructure/fluxer/resources/roles.js +8 -0
  240. package/dist/infrastructure/fluxer/resources/roles.js.map +1 -1
  241. package/dist/infrastructure/fluxer/resources/self.d.ts +4 -0
  242. package/dist/infrastructure/fluxer/resources/self.d.ts.map +1 -0
  243. package/dist/infrastructure/fluxer/resources/self.js +36 -0
  244. package/dist/infrastructure/fluxer/resources/self.js.map +1 -0
  245. package/dist/infrastructure/fluxer/resources/threads.d.ts.map +1 -1
  246. package/dist/infrastructure/fluxer/resources/threads.js +15 -0
  247. package/dist/infrastructure/fluxer/resources/threads.js.map +1 -1
  248. package/dist/infrastructure/fluxer/resources/users.d.ts +5 -2
  249. package/dist/infrastructure/fluxer/resources/users.d.ts.map +1 -1
  250. package/dist/infrastructure/fluxer/resources/users.js +36 -3
  251. package/dist/infrastructure/fluxer/resources/users.js.map +1 -1
  252. package/dist/infrastructure/fluxer/resources/webhooks.d.ts.map +1 -1
  253. package/dist/infrastructure/fluxer/resources/webhooks.js +9 -0
  254. package/dist/infrastructure/fluxer/resources/webhooks.js.map +1 -1
  255. package/dist/infrastructure/fluxer/resources.d.ts +4 -0
  256. package/dist/infrastructure/fluxer/resources.d.ts.map +1 -1
  257. package/dist/infrastructure/fluxer/resources.js +12 -0
  258. package/dist/infrastructure/fluxer/resources.js.map +1 -1
  259. package/dist/ports/resources/cache.d.ts +74 -0
  260. package/dist/ports/resources/cache.d.ts.map +1 -0
  261. package/dist/ports/resources/cache.js +2 -0
  262. package/dist/ports/resources/cache.js.map +1 -0
  263. package/dist/ports/resources/channels.d.ts +17 -0
  264. package/dist/ports/resources/channels.d.ts.map +1 -1
  265. package/dist/ports/resources/channels.js.map +1 -1
  266. package/dist/ports/resources/collectors.d.ts +18 -0
  267. package/dist/ports/resources/collectors.d.ts.map +1 -1
  268. package/dist/ports/resources/collectors.js.map +1 -1
  269. package/dist/ports/resources/common.d.ts +2 -0
  270. package/dist/ports/resources/common.d.ts.map +1 -1
  271. package/dist/ports/resources/common.js.map +1 -1
  272. package/dist/ports/resources/expressions.d.ts +8 -0
  273. package/dist/ports/resources/expressions.d.ts.map +1 -1
  274. package/dist/ports/resources/expressions.js.map +1 -1
  275. package/dist/ports/resources/gateway.d.ts +48 -0
  276. package/dist/ports/resources/gateway.d.ts.map +1 -0
  277. package/dist/ports/resources/gateway.js +2 -0
  278. package/dist/ports/resources/gateway.js.map +1 -0
  279. package/dist/ports/resources/instance.d.ts +101 -0
  280. package/dist/ports/resources/instance.d.ts.map +1 -0
  281. package/dist/ports/resources/instance.js +2 -0
  282. package/dist/ports/resources/instance.js.map +1 -0
  283. package/dist/ports/resources/messages.d.ts +27 -0
  284. package/dist/ports/resources/messages.d.ts.map +1 -1
  285. package/dist/ports/resources/messages.js.map +1 -1
  286. package/dist/ports/resources/roles.d.ts +6 -0
  287. package/dist/ports/resources/roles.d.ts.map +1 -1
  288. package/dist/ports/resources/roles.js.map +1 -1
  289. package/dist/ports/resources/self.d.ts +30 -0
  290. package/dist/ports/resources/self.d.ts.map +1 -0
  291. package/dist/ports/resources/self.js +2 -0
  292. package/dist/ports/resources/self.js.map +1 -0
  293. package/dist/ports/resources/threads.d.ts +16 -0
  294. package/dist/ports/resources/threads.d.ts.map +1 -1
  295. package/dist/ports/resources/threads.js.map +1 -1
  296. package/dist/ports/resources/users.d.ts +30 -0
  297. package/dist/ports/resources/users.d.ts.map +1 -1
  298. package/dist/ports/resources/users.js.map +1 -1
  299. package/dist/ports/resources/webhooks.d.ts +5 -0
  300. package/dist/ports/resources/webhooks.d.ts.map +1 -1
  301. package/dist/ports/resources/webhooks.js.map +1 -1
  302. package/dist/ports/resources.d.ts +8 -0
  303. package/dist/ports/resources.d.ts.map +1 -1
  304. package/dist/ports/resources.js.map +1 -1
  305. package/dist/ports/script-engine.d.ts +45 -0
  306. package/dist/ports/script-engine.d.ts.map +1 -0
  307. package/dist/ports/script-engine.js +2 -0
  308. package/dist/ports/script-engine.js.map +1 -0
  309. package/dist/sdk/builders.d.ts +2 -0
  310. package/dist/sdk/builders.d.ts.map +1 -0
  311. package/dist/sdk/builders.js +2 -0
  312. package/dist/sdk/builders.js.map +1 -0
  313. package/dist/sdk/client.d.ts +2 -0
  314. package/dist/sdk/client.d.ts.map +1 -0
  315. package/dist/sdk/client.js +2 -0
  316. package/dist/sdk/client.js.map +1 -0
  317. package/dist/sdk/cluster.d.ts +2 -0
  318. package/dist/sdk/cluster.d.ts.map +1 -0
  319. package/dist/sdk/cluster.js +2 -0
  320. package/dist/sdk/cluster.js.map +1 -0
  321. package/dist/sdk/collection.d.ts +2 -0
  322. package/dist/sdk/collection.d.ts.map +1 -0
  323. package/dist/sdk/collection.js +2 -0
  324. package/dist/sdk/collection.js.map +1 -0
  325. package/dist/sdk/errors.d.ts +2 -0
  326. package/dist/sdk/errors.d.ts.map +1 -0
  327. package/dist/sdk/errors.js +2 -0
  328. package/dist/sdk/errors.js.map +1 -0
  329. package/dist/sdk/internal.d.ts +2 -0
  330. package/dist/sdk/internal.d.ts.map +1 -0
  331. package/dist/sdk/internal.js +2 -0
  332. package/dist/sdk/internal.js.map +1 -0
  333. package/dist/sdk/message.d.ts +2 -0
  334. package/dist/sdk/message.d.ts.map +1 -0
  335. package/dist/sdk/message.js +2 -0
  336. package/dist/sdk/message.js.map +1 -0
  337. package/dist/sdk/rest/request-manager.d.ts +2 -0
  338. package/dist/sdk/rest/request-manager.d.ts.map +1 -0
  339. package/dist/sdk/rest/request-manager.js +2 -0
  340. package/dist/sdk/rest/request-manager.js.map +1 -0
  341. package/dist/sdk/rest.d.ts +2 -0
  342. package/dist/sdk/rest.d.ts.map +1 -0
  343. package/dist/sdk/rest.js +2 -0
  344. package/dist/sdk/rest.js.map +1 -0
  345. package/dist/sdk/sharding.d.ts +2 -0
  346. package/dist/sdk/sharding.d.ts.map +1 -0
  347. package/dist/sdk/sharding.js +2 -0
  348. package/dist/sdk/sharding.js.map +1 -0
  349. package/dist/sdk/types/routes.d.ts +2 -0
  350. package/dist/sdk/types/routes.d.ts.map +1 -0
  351. package/dist/sdk/types/routes.js +2 -0
  352. package/dist/sdk/types/routes.js.map +1 -0
  353. package/dist/sdk/types.d.ts +2 -0
  354. package/dist/sdk/types.d.ts.map +1 -0
  355. package/dist/sdk/types.js +2 -0
  356. package/dist/sdk/types.js.map +1 -0
  357. package/dist/sdk/util.d.ts +2 -0
  358. package/dist/sdk/util.d.ts.map +1 -0
  359. package/dist/sdk/util.js +2 -0
  360. package/dist/sdk/util.js.map +1 -0
  361. package/dist/sdk/voice.d.ts +2 -0
  362. package/dist/sdk/voice.d.ts.map +1 -0
  363. package/dist/sdk/voice.js +2 -0
  364. package/dist/sdk/voice.js.map +1 -0
  365. package/dist/sdk/ws.d.ts +2 -0
  366. package/dist/sdk/ws.d.ts.map +1 -0
  367. package/dist/sdk/ws.js +2 -0
  368. package/dist/sdk/ws.js.map +1 -0
  369. package/dist/services/canvas-image.d.ts +12 -0
  370. package/dist/services/canvas-image.d.ts.map +1 -0
  371. package/dist/services/canvas-image.js +56 -0
  372. package/dist/services/canvas-image.js.map +1 -0
  373. package/dist/services/canvas.d.ts +12 -2
  374. package/dist/services/canvas.d.ts.map +1 -1
  375. package/dist/services/canvas.js +91 -5
  376. package/dist/services/canvas.js.map +1 -1
  377. package/dist/services/moderation.d.ts +1 -0
  378. package/dist/services/moderation.d.ts.map +1 -1
  379. package/dist/services/moderation.js +11 -0
  380. package/dist/services/moderation.js.map +1 -1
  381. package/dist/services/native-moderation.d.ts +6 -1
  382. package/dist/services/native-moderation.d.ts.map +1 -1
  383. package/dist/services/native-moderation.js +11 -1
  384. package/dist/services/native-moderation.js.map +1 -1
  385. package/dist/services/resource-authorization.d.ts.map +1 -1
  386. package/dist/services/resource-authorization.js +95 -3
  387. package/dist/services/resource-authorization.js.map +1 -1
  388. package/dist/testing.d.ts.map +1 -1
  389. package/dist/testing.js +4 -0
  390. package/dist/testing.js.map +1 -1
  391. package/docs/API.md +8 -7
  392. package/docs/ARCHITECTURE.md +14 -9
  393. package/docs/BENCHMARKS.md +1 -1
  394. package/docs/CANVAS.md +70 -15
  395. package/docs/EDITOR.md +1 -1
  396. package/docs/FRAMEWORK.md +2 -3
  397. package/docs/HTTP.md +1 -1
  398. package/docs/IMAGES.md +2 -1
  399. package/docs/NATIVE.md +45 -14
  400. package/docs/PARITY-MATRIX.md +853 -843
  401. package/docs/PARITY.md +24 -12
  402. package/docs/PLAN.md +14 -3
  403. package/docs/QUICKSTART.md +5 -5
  404. package/docs/README.md +7 -7
  405. package/docs/REPOSITORY.md +1 -1
  406. package/docs/SCHEDULER.md +1 -1
  407. package/docs/TROUBLESHOOTING.md +1 -1
  408. package/docs/VALIDATION.md +5 -5
  409. package/docs/{FUNCTION-GAPS.md → functions/FUNCTION-GAPS.md} +18 -13
  410. package/docs/{LANGUAGE.md → functions/LANGUAGE.md} +7 -7
  411. package/docs/functions/README.md +33 -0
  412. package/docs/tutorials/DATA.md +2 -2
  413. package/docs/tutorials/FUNCTION-MODE.md +2 -2
  414. package/examples/canvas/napi-style.ts +24 -0
  415. package/examples/canvas/output/napi-style.png +0 -0
  416. package/examples/canvas/profile.d.mts +1 -1
  417. package/examples/canvas/profile.mjs +2 -2
  418. package/examples/canvas/profile.ts +3 -3
  419. package/examples/canvas/ranking.d.mts +1 -1
  420. package/examples/canvas/ranking.mjs +2 -2
  421. package/examples/canvas/ranking.ts +3 -3
  422. package/examples/canvas/render.ts +2 -1
  423. package/examples/canvas/welcome.d.mts +1 -1
  424. package/examples/canvas/welcome.mjs +2 -2
  425. package/examples/canvas/welcome.ts +3 -3
  426. package/examples/embeds/complete-embed-functions.ts +2 -2
  427. package/examples/function-mode.ts +3 -3
  428. package/examples/yuzuha.config.js +2 -0
  429. package/package.json +26 -1
  430. package/src/canvas/card.ts +20 -0
  431. package/src/canvas.ts +69 -17
  432. package/src/cli/config.ts +2 -1
  433. package/src/cli/lint.ts +1 -2
  434. package/src/cli/main.ts +8 -9
  435. package/src/cli/scaffold.ts +1 -1
  436. package/src/cli/scenarios.ts +2 -1
  437. package/src/commands/context.ts +9 -2
  438. package/src/domain/resource-batches.ts +31 -0
  439. package/src/framework/bot.ts +44 -27
  440. package/src/framework/command-registry.ts +15 -10
  441. package/src/framework/options.ts +3 -3
  442. package/src/{scripting → functions}/builtins/canvas.ts +2 -2
  443. package/src/{scripting → functions}/builtins/context.ts +1 -1
  444. package/src/{scripting → functions}/builtins/definition.ts +1 -1
  445. package/src/{scripting → functions}/builtins/embeds.ts +1 -1
  446. package/src/{scripting → functions}/builtins/flow.ts +2 -2
  447. package/src/{scripting → functions}/builtins/guards.ts +1 -1
  448. package/src/{scripting → functions}/builtins/http.ts +2 -2
  449. package/src/{scripting → functions}/builtins/index.ts +2 -2
  450. package/src/{scripting → functions}/builtins/language/array-callbacks.ts +2 -2
  451. package/src/{scripting → functions}/builtins/language/arrays.ts +1 -1
  452. package/src/{scripting → functions}/builtins/language/index.ts +1 -1
  453. package/src/{scripting → functions}/builtins/language/loops.ts +4 -4
  454. package/src/{scripting → functions}/builtins/language/regex.ts +1 -1
  455. package/src/{scripting → functions}/builtins/moderation.ts +1 -1
  456. package/src/{scripting → functions}/builtins/native-channels.ts +1 -1
  457. package/src/{scripting → functions}/builtins/native-roles.ts +1 -1
  458. package/src/{scripting → functions}/builtins/native-users.ts +1 -1
  459. package/src/{scripting → functions}/builtins/payload.ts +2 -2
  460. package/src/{scripting → functions}/builtins/resource-extras.ts +1 -1
  461. package/src/{scripting → functions}/builtins/values.ts +1 -1
  462. package/src/{scripting → functions/runtime}/canvas-execution.ts +1 -1
  463. package/src/{scripting → functions/runtime}/evaluator.ts +2 -2
  464. package/src/{scripting → functions/runtime}/limits.ts +1 -1
  465. package/src/{scripting → functions/runtime}/parser.ts +1 -1
  466. package/src/{scripting → functions/runtime}/regex.ts +1 -1
  467. package/src/{scripting → functions/runtime}/registry.ts +1 -1
  468. package/src/{scripting → functions/runtime}/runtime.ts +6 -1
  469. package/src/{scripting → functions/runtime}/types.ts +1 -1
  470. package/src/functions.ts +28 -8
  471. package/src/index.ts +9 -2
  472. package/src/infrastructure/canvas/napi.ts +17 -0
  473. package/src/infrastructure/fluxer/resources/cache.ts +69 -0
  474. package/src/infrastructure/fluxer/resources/channels.ts +51 -3
  475. package/src/infrastructure/fluxer/resources/collectors.ts +87 -4
  476. package/src/infrastructure/fluxer/resources/expressions.ts +7 -1
  477. package/src/infrastructure/fluxer/resources/gateway.ts +33 -0
  478. package/src/infrastructure/fluxer/resources/instance.ts +105 -0
  479. package/src/infrastructure/fluxer/resources/messages.ts +84 -36
  480. package/src/infrastructure/fluxer/resources/roles.ts +8 -0
  481. package/src/infrastructure/fluxer/resources/self.ts +39 -0
  482. package/src/infrastructure/fluxer/resources/threads.ts +14 -0
  483. package/src/infrastructure/fluxer/resources/users.ts +40 -4
  484. package/src/infrastructure/fluxer/resources/webhooks.ts +9 -0
  485. package/src/infrastructure/fluxer/resources.ts +12 -0
  486. package/src/ports/resources/cache.ts +81 -0
  487. package/src/ports/resources/channels.ts +12 -0
  488. package/src/ports/resources/collectors.ts +20 -0
  489. package/src/ports/resources/common.ts +2 -0
  490. package/src/ports/resources/expressions.ts +6 -0
  491. package/src/ports/resources/gateway.ts +49 -0
  492. package/src/ports/resources/instance.ts +109 -0
  493. package/src/ports/resources/messages.ts +30 -0
  494. package/src/ports/resources/roles.ts +3 -0
  495. package/src/ports/resources/self.ts +30 -0
  496. package/src/ports/resources/threads.ts +15 -0
  497. package/src/ports/resources/users.ts +33 -0
  498. package/src/ports/resources/webhooks.ts +6 -0
  499. package/src/ports/resources.ts +8 -0
  500. package/src/ports/script-engine.ts +42 -0
  501. package/src/sdk/builders.ts +1 -0
  502. package/src/sdk/client.ts +1 -0
  503. package/src/sdk/cluster.ts +1 -0
  504. package/src/sdk/collection.ts +1 -0
  505. package/src/sdk/errors.ts +1 -0
  506. package/src/sdk/internal.ts +1 -0
  507. package/src/sdk/message.ts +1 -0
  508. package/src/sdk/rest/request-manager.ts +1 -0
  509. package/src/sdk/rest.ts +1 -0
  510. package/src/sdk/sharding.ts +1 -0
  511. package/src/sdk/types/routes.ts +1 -0
  512. package/src/sdk/types.ts +1 -0
  513. package/src/sdk/util.ts +1 -0
  514. package/src/sdk/voice.ts +1 -0
  515. package/src/sdk/ws.ts +1 -0
  516. package/src/services/canvas-image.ts +54 -0
  517. package/src/services/canvas.ts +89 -6
  518. package/src/services/moderation.ts +4 -0
  519. package/src/services/native-moderation.ts +11 -1
  520. package/src/services/resource-authorization.ts +89 -3
  521. package/src/testing.ts +4 -0
  522. package/dist/parser.d.ts +0 -3
  523. package/dist/parser.d.ts.map +0 -1
  524. package/dist/parser.js +0 -2
  525. package/dist/parser.js.map +0 -1
  526. package/dist/runtime.d.ts +0 -5
  527. package/dist/runtime.d.ts.map +0 -1
  528. package/dist/runtime.js +0 -4
  529. package/dist/runtime.js.map +0 -1
  530. package/dist/scripting/ast.d.ts.map +0 -1
  531. package/dist/scripting/ast.js.map +0 -1
  532. package/dist/scripting/builtins/canvas.d.ts +0 -2
  533. package/dist/scripting/builtins/canvas.d.ts.map +0 -1
  534. package/dist/scripting/builtins/context.d.ts +0 -2
  535. package/dist/scripting/builtins/context.d.ts.map +0 -1
  536. package/dist/scripting/builtins/definition.d.ts.map +0 -1
  537. package/dist/scripting/builtins/definition.js.map +0 -1
  538. package/dist/scripting/builtins/embeds.d.ts +0 -3
  539. package/dist/scripting/builtins/embeds.js.map +0 -1
  540. package/dist/scripting/builtins/events.d.ts +0 -2
  541. package/dist/scripting/builtins/events.d.ts.map +0 -1
  542. package/dist/scripting/builtins/flow.d.ts +0 -2
  543. package/dist/scripting/builtins/flow.d.ts.map +0 -1
  544. package/dist/scripting/builtins/flow.js.map +0 -1
  545. package/dist/scripting/builtins/guards.d.ts +0 -2
  546. package/dist/scripting/builtins/guards.d.ts.map +0 -1
  547. package/dist/scripting/builtins/guards.js.map +0 -1
  548. package/dist/scripting/builtins/http.d.ts +0 -2
  549. package/dist/scripting/builtins/http.d.ts.map +0 -1
  550. package/dist/scripting/builtins/http.js.map +0 -1
  551. package/dist/scripting/builtins/index.d.ts +0 -5
  552. package/dist/scripting/builtins/index.d.ts.map +0 -1
  553. package/dist/scripting/builtins/index.js.map +0 -1
  554. package/dist/scripting/builtins/language/array-callbacks.d.ts +0 -2
  555. package/dist/scripting/builtins/language/array-callbacks.d.ts.map +0 -1
  556. package/dist/scripting/builtins/language/arrays.d.ts +0 -2
  557. package/dist/scripting/builtins/language/arrays.d.ts.map +0 -1
  558. package/dist/scripting/builtins/language/decimals.d.ts +0 -2
  559. package/dist/scripting/builtins/language/decimals.d.ts.map +0 -1
  560. package/dist/scripting/builtins/language/index.d.ts +0 -3
  561. package/dist/scripting/builtins/language/index.d.ts.map +0 -1
  562. package/dist/scripting/builtins/language/index.js.map +0 -1
  563. package/dist/scripting/builtins/language/loops.d.ts +0 -4
  564. package/dist/scripting/builtins/language/numbers.d.ts +0 -2
  565. package/dist/scripting/builtins/language/numbers.d.ts.map +0 -1
  566. package/dist/scripting/builtins/language/regex.d.ts +0 -2
  567. package/dist/scripting/builtins/language/regex.d.ts.map +0 -1
  568. package/dist/scripting/builtins/language/sort.d.ts +0 -2
  569. package/dist/scripting/builtins/language/sort.d.ts.map +0 -1
  570. package/dist/scripting/builtins/language/texts.d.ts +0 -2
  571. package/dist/scripting/builtins/language/texts.d.ts.map +0 -1
  572. package/dist/scripting/builtins/messages.d.ts +0 -2
  573. package/dist/scripting/builtins/messages.d.ts.map +0 -1
  574. package/dist/scripting/builtins/moderation.d.ts +0 -2
  575. package/dist/scripting/builtins/moderation.d.ts.map +0 -1
  576. package/dist/scripting/builtins/native-channels.d.ts +0 -2
  577. package/dist/scripting/builtins/native-channels.d.ts.map +0 -1
  578. package/dist/scripting/builtins/native-collectors.d.ts +0 -2
  579. package/dist/scripting/builtins/native-collectors.d.ts.map +0 -1
  580. package/dist/scripting/builtins/native-expressions.d.ts +0 -2
  581. package/dist/scripting/builtins/native-expressions.d.ts.map +0 -1
  582. package/dist/scripting/builtins/native-invites.d.ts +0 -2
  583. package/dist/scripting/builtins/native-invites.d.ts.map +0 -1
  584. package/dist/scripting/builtins/native-messages.d.ts +0 -2
  585. package/dist/scripting/builtins/native-messages.d.ts.map +0 -1
  586. package/dist/scripting/builtins/native-roles.d.ts +0 -2
  587. package/dist/scripting/builtins/native-roles.d.ts.map +0 -1
  588. package/dist/scripting/builtins/native-threads.d.ts +0 -2
  589. package/dist/scripting/builtins/native-threads.d.ts.map +0 -1
  590. package/dist/scripting/builtins/native-users.d.ts +0 -2
  591. package/dist/scripting/builtins/native-users.d.ts.map +0 -1
  592. package/dist/scripting/builtins/native-webhooks.d.ts +0 -2
  593. package/dist/scripting/builtins/native-webhooks.d.ts.map +0 -1
  594. package/dist/scripting/builtins/payload.d.ts.map +0 -1
  595. package/dist/scripting/builtins/payload.js.map +0 -1
  596. package/dist/scripting/builtins/resource-extras.d.ts +0 -2
  597. package/dist/scripting/builtins/resource-extras.d.ts.map +0 -1
  598. package/dist/scripting/builtins/schedule.d.ts +0 -2
  599. package/dist/scripting/builtins/schedule.d.ts.map +0 -1
  600. package/dist/scripting/builtins/storage.d.ts +0 -2
  601. package/dist/scripting/builtins/storage.d.ts.map +0 -1
  602. package/dist/scripting/builtins/values.d.ts +0 -2
  603. package/dist/scripting/builtins/values.d.ts.map +0 -1
  604. package/dist/scripting/builtins/values.js.map +0 -1
  605. package/dist/scripting/canvas-execution.d.ts.map +0 -1
  606. package/dist/scripting/canvas-execution.js.map +0 -1
  607. package/dist/scripting/control-flow.d.ts.map +0 -1
  608. package/dist/scripting/control-flow.js.map +0 -1
  609. package/dist/scripting/evaluator.d.ts.map +0 -1
  610. package/dist/scripting/evaluator.js.map +0 -1
  611. package/dist/scripting/limits.d.ts.map +0 -1
  612. package/dist/scripting/limits.js.map +0 -1
  613. package/dist/scripting/parser.d.ts.map +0 -1
  614. package/dist/scripting/parser.js.map +0 -1
  615. package/dist/scripting/regex.d.ts.map +0 -1
  616. package/dist/scripting/regex.js.map +0 -1
  617. package/dist/scripting/registry.d.ts.map +0 -1
  618. package/dist/scripting/registry.js.map +0 -1
  619. package/dist/scripting/runtime.d.ts.map +0 -1
  620. package/dist/scripting/runtime.js.map +0 -1
  621. package/dist/scripting/types.d.ts.map +0 -1
  622. package/dist/scripting/types.js.map +0 -1
  623. package/dist/scripting/values.d.ts.map +0 -1
  624. package/dist/scripting/values.js.map +0 -1
  625. package/src/parser.ts +0 -2
  626. package/src/runtime.ts +0 -4
  627. /package/dist/{scripting → functions}/builtins/arguments.d.ts +0 -0
  628. /package/dist/{scripting → functions}/builtins/arguments.js +0 -0
  629. /package/dist/{scripting → functions}/builtins/context.js +0 -0
  630. /package/dist/{scripting → functions}/builtins/definition.js +0 -0
  631. /package/dist/{scripting → functions}/builtins/events.js +0 -0
  632. /package/dist/{scripting → functions}/builtins/index.js +0 -0
  633. /package/dist/{scripting → functions}/builtins/language/common.d.ts +0 -0
  634. /package/dist/{scripting → functions}/builtins/language/common.js +0 -0
  635. /package/dist/{scripting → functions}/builtins/language/decimals.js +0 -0
  636. /package/dist/{scripting → functions}/builtins/language/index.js +0 -0
  637. /package/dist/{scripting → functions}/builtins/language/numbers.js +0 -0
  638. /package/dist/{scripting → functions}/builtins/language/objects.js +0 -0
  639. /package/dist/{scripting → functions}/builtins/language/sort.js +0 -0
  640. /package/dist/{scripting → functions}/builtins/language/state.js +0 -0
  641. /package/dist/{scripting → functions}/builtins/language/texts.js +0 -0
  642. /package/dist/{scripting → functions}/builtins/messages.js +0 -0
  643. /package/dist/{scripting → functions}/builtins/moderation.js +0 -0
  644. /package/dist/{scripting → functions}/builtins/native-channels.js +0 -0
  645. /package/dist/{scripting → functions}/builtins/native-collectors.js +0 -0
  646. /package/dist/{scripting → functions}/builtins/native-expressions.js +0 -0
  647. /package/dist/{scripting → functions}/builtins/native-invites.js +0 -0
  648. /package/dist/{scripting → functions}/builtins/native-messages.js +0 -0
  649. /package/dist/{scripting → functions}/builtins/native-roles.js +0 -0
  650. /package/dist/{scripting → functions}/builtins/native-threads.js +0 -0
  651. /package/dist/{scripting → functions}/builtins/native-users.js +0 -0
  652. /package/dist/{scripting → functions}/builtins/native-webhooks.js +0 -0
  653. /package/dist/{scripting → functions}/builtins/resource-extras.js +0 -0
  654. /package/dist/{scripting → functions}/builtins/schedule.js +0 -0
  655. /package/dist/{scripting → functions}/builtins/storage.js +0 -0
  656. /package/dist/{scripting → functions/runtime}/ast.d.ts +0 -0
  657. /package/dist/{scripting → functions/runtime}/ast.js +0 -0
  658. /package/dist/{scripting → functions/runtime}/canvas-execution.js +0 -0
  659. /package/dist/{scripting → functions/runtime}/control-flow.d.ts +0 -0
  660. /package/dist/{scripting → functions/runtime}/control-flow.js +0 -0
  661. /package/dist/{scripting → functions/runtime}/limits.d.ts +0 -0
  662. /package/dist/{scripting → functions/runtime}/parser.d.ts +0 -0
  663. /package/dist/{scripting → functions/runtime}/regex-worker.mjs +0 -0
  664. /package/dist/{scripting → functions/runtime}/regex.d.ts +0 -0
  665. /package/dist/{scripting → functions/runtime}/registry.d.ts +0 -0
  666. /package/dist/{scripting → functions/runtime}/types.js +0 -0
  667. /package/dist/{scripting → functions/runtime}/values.d.ts +0 -0
  668. /package/dist/{scripting → functions/runtime}/values.js +0 -0
  669. /package/docs/{FUNCTIONS.md → functions/FUNCTIONS.md} +0 -0
  670. /package/docs/{LANGUAGE-EXTENSIONS.md → functions/LANGUAGE-EXTENSIONS.md} +0 -0
  671. /package/src/{scripting → functions}/builtins/arguments.ts +0 -0
  672. /package/src/{scripting → functions}/builtins/events.ts +0 -0
  673. /package/src/{scripting → functions}/builtins/language/common.ts +0 -0
  674. /package/src/{scripting → functions}/builtins/language/decimals.ts +0 -0
  675. /package/src/{scripting → functions}/builtins/language/numbers.ts +0 -0
  676. /package/src/{scripting → functions}/builtins/language/objects.ts +0 -0
  677. /package/src/{scripting → functions}/builtins/language/sort.ts +0 -0
  678. /package/src/{scripting → functions}/builtins/language/state.ts +0 -0
  679. /package/src/{scripting → functions}/builtins/language/texts.ts +0 -0
  680. /package/src/{scripting → functions}/builtins/messages.ts +0 -0
  681. /package/src/{scripting → functions}/builtins/native-collectors.ts +0 -0
  682. /package/src/{scripting → functions}/builtins/native-expressions.ts +0 -0
  683. /package/src/{scripting → functions}/builtins/native-invites.ts +0 -0
  684. /package/src/{scripting → functions}/builtins/native-messages.ts +0 -0
  685. /package/src/{scripting → functions}/builtins/native-threads.ts +0 -0
  686. /package/src/{scripting → functions}/builtins/native-webhooks.ts +0 -0
  687. /package/src/{scripting → functions}/builtins/schedule.ts +0 -0
  688. /package/src/{scripting → functions}/builtins/storage.ts +0 -0
  689. /package/src/{scripting → functions/runtime}/ast.ts +0 -0
  690. /package/src/{scripting → functions/runtime}/control-flow.ts +0 -0
  691. /package/src/{scripting → functions/runtime}/regex-worker.mjs +0 -0
  692. /package/src/{scripting → functions/runtime}/values.ts +0 -0
package/docs/PARITY.md CHANGED
@@ -17,39 +17,51 @@ públicos da raiz do pacote e seus tipos. `bot.client` é uma instância real de
17
17
  `Client`; `SDK` na raiz do Yuzuha é um namespace do mesmo pacote. O acesso nativo
18
18
  não é uma reprodução parcial do client.
19
19
 
20
- Isso não significa que cada método tem uma função `$...`, nem que pacotes opcionais
21
- ou subpaths do SDK foram incorporados à raiz. O teste de consumidor compara os
22
- exports de `yuzuha/sdk` aos da dependência instalada.
20
+ Os subpaths do pacote e os pacotes satélites do monorepo também são espelhados:
21
+ `yuzuha/sdk/client`, `yuzuha/sdk/errors`, `yuzuha/sdk/message`,
22
+ `yuzuha/sdk/cluster` e `yuzuha/sdk/internal` equivalem a `@fluxerjs/core/*`;
23
+ `yuzuha/sdk/types`, `yuzuha/sdk/types/routes`, `yuzuha/sdk/rest`,
24
+ `yuzuha/sdk/rest/request-manager`, `yuzuha/sdk/ws`, `yuzuha/sdk/builders`,
25
+ `yuzuha/sdk/collection` e `yuzuha/sdk/util` reexportam os pacotes homônimos, que
26
+ passam a ser dependências diretas do Yuzuha. `yuzuha/sdk/voice` e
27
+ `yuzuha/sdk/sharding` reexportam os pacotes opcionais homônimos, exigindo o peer
28
+ instalado. O teste de consumidor compara os exports de cada subpath `yuzuha/sdk*`
29
+ aos do pacote correspondente instalado.
30
+
31
+ Isso não significa que cada método tem uma função `$...`. `@fluxerjs/sharding`
32
+ declara peer em `@fluxerjs/core` 3.0.0 exato; consumidores que o instalarem
33
+ precisam de `overrides` para o core fixado, como no manifesto do Yuzuha.
23
34
 
24
35
  | Área | JS/TS pelo client/SDK | Function mode |
25
36
  |---|---|---|
26
- | Gateway, conexão, heartbeat e reconexão | Herdado do SDK | Via inicialização do bot |
37
+ | Gateway, conexão, heartbeat e reconexão | Herdado do SDK; pedidos brutos por `ctx.resources.gateway` (membros, contagens, não lidos de fórum, assinatura de threads, envio por shard) | Via inicialização do bot |
27
38
  | Eventos | `bot.on/once/off`, `bot.event`, `bot.scriptEvent` e `bot.client.on` | Eventos de membros, edição/exclusão de mensagens e reações, com contexto próprio |
28
39
  | Mensagens e replies | API completa do SDK | reply, sendMessage, editMessage, deleteMessage, fetchMessage, messages com cursores, pin/unpin, pinnedMessagesPage, dm, forward, searchMessages, searchMessagesAdvanced e preloadMessages |
29
- | Reações e collectors | API do SDK | react, removeReaction, clearReactions, reactionUsers e reactionUsersPage com metadados de paginação, awaitMessage, awaitReaction, confirm |
40
+ | Reações e collectors | API do SDK; streams `collectMessages`/`collectReactions` como `AsyncIterable` | react, removeReaction, clearReactions, reactionUsers e reactionUsersPage com metadados de paginação, awaitMessage, awaitReaction, confirm |
30
41
  | Embeds e anexos | Builders do SDK, sendBytes e sendAttachments | Embeds completos (autor, link, data, campos, alt text e rodapé com ícone), até 10 embeds, opções de envio com autorização, anexos URL/base64 e múltiplos anexos; leitura normalizada em `$fetchMessage` |
31
42
  | Membros, cargos, canais e permissões | API do SDK e `ctx.members` | User/member, perfil completo, contagens ao vivo, nickname, roles, canais de link, avisos, posição, categorias e overwrites |
32
43
  | Ban, kick, timeout, unban e moderação de voz | SDK + `ctx.mod` e `ctx.moderate` | Versões simples e mod* com casos, incluindo move/mute/deafen |
33
44
  | Servidor, convites, webhooks e expressões | API do SDK e auxiliares autorizados | guildFeatures, leaveGuild, editGuild, convites/vanity, clonagem e mutações de emojis/stickers, createEmojisBulk; CRUD e envio de webhooks |
34
45
  | Threads e fóruns | API do SDK | Criação, edição, busca, posts, membros, threadMember e listagens ativas/arquivadas com paginação |
35
46
  | Presença | `client.user.setPresence` | setPresence, setStatus e setActivity |
36
- | Cache e presença | Opções e métodos do SDK | Acesso nativo |
37
- | Instância própria/discovery | `Client.fromDiscovery`, client injetado | Mesmo adaptador do client |
47
+ | Cache e presença | `ctx.resources.cache` (estatísticas, limites e limpezas) e opções do SDK | Acesso nativo |
48
+ | Usuário autenticado | `ctx.resources.self` (fetch, guilds, saída e limpeza com verificação sudo) | setPresence, setStatus, setActivity e leaveGuild |
49
+ | Instância e aplicação | `ctx.resources.instance` (describe, gatewayInfo, application, oauthApplications, metadados de emoji/sticker, resolveEmoji); `Client.fromDiscovery`, client injetado | Mesmo adaptador do client |
38
50
  | Áudio em voz | `FluxerVoice` sobre `@fluxerjs/voice` opcional; Lavalink v4 com plugin de áudio, `FluxerLavalinkBridge`, filas editáveis e recuperação em `yuzuha/music` | Sem wrappers de reprodução; moderação de membros usa o SDK core |
39
- | Sharding | Pacote separado `@fluxerjs/sharding` | Sem coordenação própria |
40
- | Cluster/subpaths | Imports diretos de `@fluxerjs/core/cluster` | Sem wrapper próprio |
51
+ | Sharding | `yuzuha/sdk/sharding` reexporta `@fluxerjs/sharding` (peer opcional) | Sem coordenação própria |
52
+ | Cluster/subpaths | `yuzuha/sdk/cluster` e demais subpaths `yuzuha/sdk/*` espelham `@fluxerjs/core/*` e os pacotes satélites | Sem wrapper próprio |
41
53
  | Estado e casos | `ctx.data`, TTL, userFor, transaction entre chaves e stores | Variáveis, TTL, incrementos, listas, casos e dataTransaction com operações declarativas |
42
54
  | Agendamentos | `ctx.scheduler`, cron/fusos, concorrência limitada, histórico, heartbeat e controles | schedule, scheduleEvery, scheduleCron, controles, histórico, reexecução e retry com jitter |
43
55
  | HTTP | `request`, `requestBytes`, `stream`, `multipart`, `withPolicy` e cancelamento | `$http`, `$httpJson`, `$httpMultipart` e download de imagens com política de rede por comando |
44
56
  | CLI, plugins, comandos e middleware | Recursos próprios do Yuzuha; lint/catálogos/cenários e manutenção de dados | 336 funções canônicas; comandos e eventos de script |
45
- | Composição de cartões | `ctx.canvas` e `yuzuha/canvas`, com peer opcional `@napi-rs/canvas`; envio pelo contexto | 12 funções `$canvas*` para cenas privadas por execução; envio sem retorno automático |
57
+ | Composição de cartões | `ctx.canvas`, `yuzuha/canvas` (napi em processo) e `yuzuha/canvas/card` (builder isolado), com peer opcional `@napi-rs/canvas`; envio pelo contexto | 12 funções `$canvas*` para cenas privadas por execução; envio sem retorno automático |
46
58
 
47
59
  A camada nativa do Yuzuha — o caminho principal — acrescenta schemas de argumentos
48
60
  e flags com inferência, subcomandos, ajuda detalhada, checks e middleware por comando, eventos com encaminhamento de
49
61
  erros e plugins que agrupam comandos e eventos. Os mesmos contratos de recursos atendem scripts
50
62
  e comandos nativos, e `ctx.scheduler`/`ctx.http` expõem agendamento e rede sem
51
63
  duplicar regras. Veja o [guia nativo](NATIVE.md) e o
52
- [inventário de lacunas](FUNCTION-GAPS.md), que separa wrappers ausentes de
64
+ [inventário de lacunas](functions/FUNCTION-GAPS.md), que separa wrappers ausentes de
53
65
  recursos já acessíveis no SDK.
54
66
 
55
67
  Canvas é um módulo de composição com builder, imagens, texto e formas. Ele não
@@ -114,7 +126,7 @@ retorno e limites próprios, publicados na referência gerada:
114
126
  acrescentam casos e definem `$caseID`.
115
127
 
116
128
  Ao adaptar um script, revise cada chamada com a referência gerada em
117
- [FUNCTIONS.md](FUNCTIONS.md). Use a matriz acima para distinguir funções de script
129
+ [FUNCTIONS.md](functions/FUNCTIONS.md). Use a matriz acima para distinguir funções de script
118
130
  dos recursos acessíveis pelo SDK nativo.
119
131
 
120
132
  ## Extensões opcionais e ferramentas
package/docs/PLAN.md CHANGED
@@ -43,9 +43,9 @@ recursos. O runtime de scripts só é registrado quando o function mode é usado
43
43
  2. Entrypoints: `yuzuha` é nativo; `yuzuha/functions` contém parser, AST,
44
44
  evaluator, `Runtime`, `registerBuiltins` e `script()`. `yuzuha/sdk`,
45
45
  `yuzuha/testing` e os auxiliares de editor em `yuzuha/tooling` completam a superfície pública.
46
- 3. Ativação do function mode: registrar um comando com `code` ou um evento de script chama
47
- `bot.enableFunctions()` automaticamente. `bot.enableFunctions()` é idempotente
48
- e permite pré-carregar o runtime. Comandos 100% nativos não registram builtins.
46
+ 3. Ativação do function mode: comandos com `code` e eventos de script exigem um
47
+ engine explícito — `engine: functions()` nas opções ou `bot.useEngine(engine)`.
48
+ A CLI injeta `functions()` automaticamente. Bots 100% nativos não carregam o runtime.
49
49
  4. Transporte: interface pequena, tipada e substituível. Adaptador Fluxer real e
50
50
  adaptador em memória para testes sem token. Objetos de mensagens preservam os
51
51
  dados usados pelo contexto; acesso ao objeto original é explícito.
@@ -73,6 +73,17 @@ recursos. O runtime de scripts só é registrado quando o function mode é usado
73
73
 
74
74
  ## Entregas e dependências
75
75
 
76
+ A atualização 0.3.0 isola o function mode da raiz e abre o canvas em processo:
77
+ `yuzuha/canvas` passa a espelhar `@napi-rs/canvas` com `createCanvas`,
78
+ `loadImage` via `HttpService` e `registerFonts`, enquanto o builder de cartões
79
+ vai para `yuzuha/canvas/card` como `createCard`. O runtime de scripts migra para
80
+ `src/functions/` atrás do port `ScriptEngine` (`src/ports/script-engine.ts`) —
81
+ bots com `code` ou `scriptEvent` instalam `engine: functions()` ou
82
+ `bot.useEngine(...)`, e a CLI injeta o engine sozinha. `bot.runtime`,
83
+ `enableFunctions()` e `YuzuhaOptions.limits` saem. A documentação passa a tratar
84
+ JS/TS como experiência principal e move os guias do function mode para
85
+ `docs/functions/`.
86
+
76
87
  A atualização 0.2.0 completa os embeds: `url`, `timestamp`, `author`, ícones, alt
77
88
  text em imagem e miniatura, campos incrementais e `$embedFromObject`. Mensagens
78
89
  passam a aceitar até 10 embeds, `tts`, `stickerIds`, `flags` e `allowedMentions`
@@ -10,13 +10,13 @@ Use Node >=22.13 e npm. Em um projeto ESM existente, instale a versão desta
10
10
  documentação:
11
11
 
12
12
  ```sh
13
- npm install yuzuha@0.2.0
13
+ npm install yuzuha@0.3.0
14
14
  ```
15
15
 
16
16
  Para gerar um bot em uma pasta nova, execute:
17
17
 
18
18
  ```sh
19
- npx yuzuha@0.2.0 init ./meu-bot --ts
19
+ npx yuzuha@0.3.0 init ./meu-bot --ts
20
20
  cd meu-bot
21
21
  npm install
22
22
  npm run check
@@ -156,12 +156,12 @@ export default script({
156
156
  });
157
157
  ```
158
158
 
159
- O runtime de funções é ativado automaticamente no primeiro comando com `code`.
160
- Para pré-carregá-lo, chame `bot.enableFunctions()`. Um comando executável aceita
159
+ Comandos com `code` exigem um engine de function mode: passe
160
+ `engine: functions()` de `yuzuha/functions` nas opções do bot. Um comando executável aceita
161
161
  exatamente um entre `code` e `run`. Grupos também podem declarar somente
162
162
  `subcommands`.
163
163
 
164
- Consulte a [sintaxe do function mode](LANGUAGE.md), o
164
+ Consulte a [sintaxe do function mode](functions/LANGUAGE.md), o
165
165
  [tutorial do primeiro script](tutorials/FUNCTION-MODE.md) e os
166
166
  [grupos e subcomandos nativos](NATIVE.md).
167
167
 
package/docs/README.md CHANGED
@@ -1,6 +1,6 @@
1
1
  # Documentação da Yuzuha
2
2
 
3
- Esta documentação cobre a Yuzuha 0.2.0, em JavaScript ESM e TypeScript, para
3
+ Esta documentação cobre a Yuzuha 0.3.0, em JavaScript ESM e TypeScript, para
4
4
  Node >=22.13. O pacote usa `@fluxerjs/core` 3.3.0.
5
5
 
6
6
  JS/TS é o caminho principal da biblioteca. Function mode (`$...`) é opcional e
@@ -14,8 +14,8 @@ conectam ao Fluxer.
14
14
  |---|---|
15
15
  | Criar o primeiro bot | [Instale e gere o projeto](QUICKSTART.md), depois [crie e teste o comando `!hello`](tutorials/FIRST-COMMAND.md) |
16
16
  | Programar com a API nativa | Aprenda [comandos, eventos e plugins em JS/TS](NATIVE.md) e consulte os [contratos da API pública](API.md) |
17
- | Escrever comandos em function mode | [Crie o primeiro script](tutorials/FUNCTION-MODE.md) e consulte a [sintaxe e as regras de avaliação](LANGUAGE.md) |
18
- | Consultar referências | Use a [referência da API pública](API.md), o [catálogo de funções](FUNCTIONS.md) e a [referência da CLI](CLI.md) |
17
+ | Escrever comandos em function mode | [Crie o primeiro script](tutorials/FUNCTION-MODE.md) e consulte a [sintaxe e as regras de avaliação](functions/LANGUAGE.md) |
18
+ | Consultar referências | Use a [referência da API pública](API.md), o [catálogo de funções](functions/FUNCTIONS.md) e a [referência da CLI](CLI.md) |
19
19
 
20
20
  ## Desenvolver e integrar
21
21
 
@@ -24,9 +24,9 @@ conectam ao Fluxer.
24
24
  | [Guia nativo JS/TS](NATIVE.md) | Argumentos inferidos, contexto, moderação, dados, eventos e plugins |
25
25
  | [Framework](FRAMEWORK.md) | Registro de comandos, contexto, plugins, middleware e function mode |
26
26
  | [API pública](API.md) | Entrypoints, opções, métodos, contratos e erros |
27
- | [Function mode](LANGUAGE.md) | Sintaxe, funções, escopo e limites dos scripts |
28
- | [Referência de funções](FUNCTIONS.md) | Assinaturas geradas do registro executável |
29
- | [Funções ausentes](FUNCTION-GAPS.md) | Inventário auditado, propostas de wrappers e limites de cobertura |
27
+ | [Function mode](functions/LANGUAGE.md) | Sintaxe, funções, escopo e limites dos scripts |
28
+ | [Referência de funções](functions/FUNCTIONS.md) | Assinaturas geradas do registro executável |
29
+ | [Funções ausentes](functions/FUNCTION-GAPS.md) | Inventário auditado, propostas de wrappers e limites de cobertura |
30
30
  | [Contador e dados por escopo](tutorials/DATA.md) | Incrementos atômicos, leitura, escrita, TTL e escolha do store |
31
31
  | [Estado e execução](STORAGE.md) | JSON/SQLite, transações, fechamento, limites e falhas parciais |
32
32
  | [Eventos de scripts](EVENTS.md) | Payloads, contexto, guards e ciclo de vida |
@@ -66,7 +66,7 @@ Os exemplos usam imports públicos de `yuzuha`, `yuzuha/functions`, `yuzuha/sdk`
66
66
  `yuzuha/testing`. Caminhos em `src/` aparecem para explicar a implementação e
67
67
  não são subpaths novos do pacote.
68
68
 
69
- Consulte também os guias de [loops, regex e decimais](LANGUAGE-EXTENSIONS.md),
69
+ Consulte também os guias de [loops, regex e decimais](functions/LANGUAGE-EXTENSIONS.md),
70
70
  [transformação de imagens e streams de anexos](IMAGES.md) e
71
71
  [integrações e sharding](INTEGRATIONS.md).
72
72
 
@@ -45,7 +45,7 @@ padrão e os exemplos de consumidor estão no [guia inicial](QUICKSTART.md).
45
45
 
46
46
  ## Editar a documentação
47
47
 
48
- Edite os guias em `docs/`. A referência de funções em `docs/FUNCTIONS.md` e o
48
+ Edite os guias em `docs/`. A referência de funções em `docs/functions/FUNCTIONS.md` e o
49
49
  catálogo do editor são gerados a partir dos metadados dos builtins:
50
50
 
51
51
  ```sh
package/docs/SCHEDULER.md CHANGED
@@ -123,4 +123,4 @@ local: comandos com efeitos externos devem ser idempotentes. Falhas automáticas
123
123
  de store chegam a `onError` e aos eventos do scheduler; não são descartadas.
124
124
 
125
125
  Veja também [armazenamento](STORAGE.md), [observabilidade](OBSERVABILITY.md) e
126
- [referência de funções](FUNCTIONS.md).
126
+ [referência de funções](functions/FUNCTIONS.md).
@@ -46,7 +46,7 @@ comprova validade do token, disponibilidade do servidor ou permissões remotas.
46
46
 
47
47
  Funções não distinguem maiúsculas e minúsculas; variáveis distinguem.
48
48
  `$reply[]` não possui argumento e é inválido. Consulte a
49
- [linguagem](LANGUAGE.md) e a [referência gerada](FUNCTIONS.md).
49
+ [linguagem](functions/LANGUAGE.md) e a [referência gerada](functions/FUNCTIONS.md).
50
50
 
51
51
  Se o script usa uma função de plugin, valide a config em vez da pasta isolada:
52
52
  `yuzuha check yuzuha.config.ts`.
@@ -99,7 +99,7 @@ O índice SQLite é derivado e reconstruído na primeira consulta após escrita;
99
99
  as escritas ainda serializam o estado integral. Anexos recebidos por stream
100
100
  são acumulados antes do upload exigido pelo SDK. Componentes interativos e
101
101
  comandos de aplicação continuam sem contrato equivalente verificado.
102
- [FUNCTION-GAPS.md](FUNCTION-GAPS.md) e [INTEGRATIONS.md](INTEGRATIONS.md)
102
+ [FUNCTION-GAPS.md](functions/FUNCTION-GAPS.md) e [INTEGRATIONS.md](INTEGRATIONS.md)
103
103
  registram essas limitações. Não houve publicação ou ações reais de bot.
104
104
 
105
105
  ## Monorepo e documentação web — rodada anterior
@@ -259,7 +259,7 @@ no Fluxer real. Ambiente: Linux, Node **26.11.1**, npm **12.2.1** e
259
259
  |---|---|
260
260
  | `npm run check` | PASS: tipos, arquitetura, testes, build, editor, referência e documentação |
261
261
  | Testes de comportamento | PASS: **386 testes**, nenhuma falha, cancelamento ou skip |
262
- | Dependências entre camadas | PASS: **147 módulos**; domínio, ports, serviços e scripting isolados |
262
+ | Dependências entre camadas | PASS: **147 módulos**; domínio, ports, serviços e functions isolados |
263
263
  | Referência e documentação | PASS: **288 funções**, 28 arquivos Markdown e links locais |
264
264
  | Manifest, lockfile e changelog | PASS: versão `0.1.4`, título Hory `v0.1.4` |
265
265
  | `npm run smoke:package` | PASS: tarball instalado em consumidor externo e scaffolds JS/TS |
@@ -322,9 +322,9 @@ reabertura JSON/SQLite, histórico/retry de tarefas e isolamento por autor/guild
322
322
  Também inclui parser e limites, dados de usuário inertes, caminhos/propriedades
323
323
  próprias, diagnósticos UTF-16 e o host simulado da extensão VS Code.
324
324
 
325
- A raiz nativa continua sem exports de parser/runtime; bots nativos não registram
326
- builtins. Comandos com `code`, eventos de script e `enableFunctions()` ativam o
327
- function mode sob demanda. Reload, fechamento, store injetado e identidade das
325
+ A raiz nativa continua sem exports de parser/runtime e não carrega o function mode;
326
+ comandos com `code` e eventos de script exigem `engine: functions()` de `yuzuha/functions`.
327
+ Reload, fechamento, store injetado e identidade das
328
328
  classes públicas em configs/comandos TS continuam cobertos.
329
329
 
330
330
  ## Limites da evidência
@@ -1,6 +1,6 @@
1
1
  # Funções que ainda faltam
2
2
 
3
- Inventário da versão **0.2.0**, comparando o registro executável do Yuzuha com os
3
+ Inventário da versão **0.2.1**, comparando o registro executável do Yuzuha com os
4
4
  tipos públicos de **@fluxerjs/core 3.3.0**, fixado no lockfile. O inventário tem
5
5
  **336 funções canônicas**; aliases não aumentam esse número.
6
6
 
@@ -10,10 +10,15 @@ ideias de API: **não estão registrados e não podem ser usados em scripts**.
10
10
 
11
11
  ## Cobertura atual
12
12
 
13
- O function mode tem 336 funções canônicas, 26 a mais que na 0.1.8. O SDK continua
13
+ O function mode tem 336 funções canônicas. O SDK continua
14
14
  disponível em JS/TS, com recursos injetáveis e testáveis offline.
15
15
  Esta tabela é um mapa dos recursos entregues pelo Yuzuha e das APIs nativas
16
- disponíveis para escrever novos comandos.
16
+ disponíveis para escrever novos comandos. Desde a 0.2.1, `ctx.resources` inclui
17
+ as áreas `gateway` (pedidos brutos), `instance` (descoberta e aplicação), `self`
18
+ (usuário autenticado com verificação sudo) e `cache` (estatísticas e limpezas);
19
+ `collectors` ganhou streams `AsyncIterable` e `messages` ganhou `bulkFetch` e
20
+ `searchAll`. Os subpaths `yuzuha/sdk/*` espelham `@fluxerjs/core/*` e os pacotes
21
+ satélites do monorepo.
17
22
 
18
23
  | Área | Funções | Cobertura |
19
24
  |---|---|---|
@@ -21,7 +26,7 @@ disponíveis para escrever novos comandos.
21
26
  | Cargos | `$role`, `$roles`, `$hasRole`, `$addRole`, `$removeRole`, `$createRole`, `$editRole`, `$deleteRole`, `$moveRole` | Resolução por nome, ID ou menção, mutações e posição |
22
27
  | Canais | `$channel`, `$channels`, `$createChannel`, `$editChannel`, `$deleteChannel`, `$channelPerms`, `$channelPermsOf`, `$slowmode`, `$moveChannel`, `$setCategory` | Criação, edição, exclusão, posição, categoria, overwrites e permissões efetivas |
23
28
  | Mensagens | `$fetchMessage`, `$messages`, `$pin`, `$unpin`, `$pinnedMessages`, `$pinnedMessagesPage`, `$searchMessagesAdvanced`, `$sendFiles`, `$removeReaction`, `$clearReactions`, `$reactionUsers`, `$reactionUsersPage` | Histórico, páginas de fixadas por timestamp, busca com filtros do SDK, anexos por URL e reações com metadados de paginação |
24
- | Embeds | `$embed`, `$author`, `$url`, `$embedTimestamp`, `$footerIcon`, `$imageAlt`, `$fields`, `$addField`, `$removeField`, `$editField`, `$embedFromObject`, `$embeds`, `$addEmbed`, `$messageOptions` | Partes tipadas, campos incrementais, lista de até 10 embeds, URLs HTTP(S), limites do SDK e opções de envio com permissão; detalhes em [EMBEDS.md](EMBEDS.md) |
29
+ | Embeds | `$embed`, `$author`, `$url`, `$embedTimestamp`, `$footerIcon`, `$imageAlt`, `$fields`, `$addField`, `$removeField`, `$editField`, `$embedFromObject`, `$embeds`, `$addEmbed`, `$messageOptions` | Partes tipadas, campos incrementais, lista de até 10 embeds, URLs HTTP(S), limites do SDK e opções de envio com permissão; detalhes em [EMBEDS.md](../EMBEDS.md) |
25
30
  | Coletores | `$awaitMessage`, `$awaitReaction`, `$confirm` | Espera com timeout, filtro por autor e múltiplos emojis |
26
31
  | Servidor e convites | `$invite`, `$createInvite`, `$deleteInvite` | Convite por código/URL e criação com duração |
27
32
  | Webhooks | `$webhooks`, `$createWebhook`, `$sendWebhook`, `$editWebhook`, `$deleteWebhook` | CRUD e envio com ou sem token |
@@ -76,12 +81,12 @@ assíncronos dentro do store. A extensão cobre as 336 funções internas.
76
81
  | Mensagens | `$preloadMessages` | Última mensagem por canal; array de 1 a 100 IDs, com entradas ausentes normalizadas como null |
77
82
  | Expressões | `$createEmojisBulk` | 1 a 50 objetos name/image base64, até 10 MB; success/failed preservam falhas parciais |
78
83
  | Autorização | Cargos, canais e webhooks em `ctx.resources` | Guards de autor/bot compartilhados entre nativo e script, servidor, permissões locais e hierarquia; token de webhook não contorna a política |
79
- | Eventos | `$eventName`, `$eventUserID`, `$eventGuildID`, `$eventChannelID`, `$eventMessageID`, `$eventContent`, `$eventOldContent`, `$eventEmoji` | Seis eventos de SDK, ausências null, metadados imutáveis, ator explícito e cancelamento; veja [EVENTS.md](EVENTS.md) |
84
+ | Eventos | `$eventName`, `$eventUserID`, `$eventGuildID`, `$eventChannelID`, `$eventMessageID`, `$eventContent`, `$eventOldContent`, `$eventEmoji` | Seis eventos de SDK, ausências null, metadados imutáveis, ator explícito e cancelamento; veja [EVENTS.md](../EVENTS.md) |
80
85
  | Arrays | `$arrayUnion`, `$arrayIntersection`, `$arrayDifference` | Operações de conjuntos preservando ordem e igualdade profunda |
81
86
  | Números | `$formatBytes`, `$percent`, `$toBase`, `$fromBase` | Bytes SI/IEC, percentuais e conversão exata de inteiros em bases 2–36 |
82
- | Agendamentos | `$scheduleCron` | Cron de cinco campos em fuso IANA, missedRun e retryJitter; veja [SCHEDULER.md](SCHEDULER.md) |
83
- | HTTP | `$httpMultipart`; `HttpService.stream`/`withPolicy` nativos | Upload limitado, streaming cancelável e políticas restritivas por comando; veja [HTTP.md](HTTP.md) |
84
- | Ferramentas e estado | `lint`, catálogos JSON, cenários offline e `StateMaintenance` | Diagnósticos sem importar módulos; estatísticas, limpeza limitada, backup e restauração simulável; veja [STORAGE.md](STORAGE.md) |
87
+ | Agendamentos | `$scheduleCron` | Cron de cinco campos em fuso IANA, missedRun e retryJitter; veja [SCHEDULER.md](../SCHEDULER.md) |
88
+ | HTTP | `$httpMultipart`; `HttpService.stream`/`withPolicy` nativos | Upload limitado, streaming cancelável e políticas restritivas por comando; veja [HTTP.md](../HTTP.md) |
89
+ | Ferramentas e estado | `lint`, catálogos JSON, cenários offline e `StateMaintenance` | Diagnósticos sem importar módulos; estatísticas, limpeza limitada, backup e restauração simulável; veja [STORAGE.md](../STORAGE.md) |
85
90
 
86
91
  ## Cobertura adicional da 0.1.7
87
92
 
@@ -100,11 +105,11 @@ assíncronos dentro do store. A extensão cobre as 336 funções internas.
100
105
  - `$httpStream`, `$httpChunk` e `$httpChunkIndex` processam trechos UTF-8 sem
101
106
  carregar a resposta inteira e preservam política HTTP e cancelamento.
102
107
  - Agendamentos têm prioridade e capacidade compartilhada por claims SQLite;
103
- veja os requisitos de configuração no [guia](SCHEDULER.md).
108
+ veja os requisitos de configuração no [guia](../SCHEDULER.md).
104
109
 
105
110
  - `yuzuha/images` transforma PNG/JPEG/WebP por processos isolados com Sharp opcional.
106
111
  `ctx.sendStream` recebe anexos por stream com limite, acumulando antes do upload
107
- exigido pelo SDK. Veja [IMAGES.md](IMAGES.md).
112
+ exigido pelo SDK. Veja [IMAGES.md](../IMAGES.md).
108
113
 
109
114
  Veja contratos e exemplos no [guia de operações de dados](LANGUAGE-EXTENSIONS.md).
110
115
 
@@ -132,7 +137,7 @@ nomes novos para métodos do SDK.
132
137
 
133
138
  Não há `$eval` de JavaScript nem reinterpretação de texto de usuário como código.
134
139
  Funções JS/TS próprias podem ser registradas explicitamente. Para operações
135
- complexas, use o [guia nativo](NATIVE.md).
140
+ complexas, use o [guia nativo](../NATIVE.md).
136
141
 
137
142
  ## Limites de escopo do Yuzuha
138
143
 
@@ -142,7 +147,7 @@ complexas, use o [guia nativo](NATIVE.md).
142
147
  voz oficial opcional e controle Lavalink em `yuzuha/music`, sem wrappers de
143
148
  reprodução em scripts. O core aceita configuração de shards via clientOptions;
144
149
  gerência de processos exige `@fluxerjs/sharding`, não incluído no pacote.
145
- Veja a [auditoria de integrações](INTEGRATIONS.md).
150
+ Veja a [auditoria de integrações](../INTEGRATIONS.md).
146
151
  - Economia, XP, rankings e tickets são sistemas de produto. Ter variáveis,
147
152
  moderação ou acesso ao SDK não significa que esses sistemas já estejam prontos.
148
153
  - LSP e migração automática de scripts de outros runtimes ainda não são ferramentas entregues.
@@ -162,7 +167,7 @@ dependência instalada. Não mede compatibilidade com catálogos de outros runti
162
167
 
163
168
  ## Evidências
164
169
 
165
- O inventário vem de `src/scripting/builtins/` e [FUNCTIONS.md](FUNCTIONS.md).
170
+ O inventário vem de `src/functions/builtins/` e [FUNCTIONS.md](FUNCTIONS.md).
166
171
  Os recursos nativos foram conferidos nas declarações distribuídas em
167
172
  `node_modules/@fluxerjs/core/dist/index.d.ts` e nos arquivos `.d.ts` reexportados
168
173
  por ela, incluindo `Guild`, `GuildMember`, `Channel`, `Message`, `Webhook` e
@@ -1,8 +1,8 @@
1
1
  # Function mode: linguagem de scripts
2
2
 
3
- O function mode é opcional. Importe `script` de `yuzuha/functions` ou registre
4
- um comando com `code`; o runtime é ativado sob demanda. Comandos nativos não
5
- usam esta linguagem.
3
+ O function mode é opcional e exige um engine: passe `engine: functions()`
4
+ de `yuzuha/functions` nas opções do bot (ou `bot.useEngine(...)`); a CLI injeta
5
+ o engine automaticamente. Comandos nativos não usam esta linguagem.
6
6
 
7
7
  ## Sintaxe
8
8
 
@@ -411,7 +411,7 @@ $reply[Prazo restante: $ttlGuildVar[evento] ms]
411
411
  As variantes `Var` e `UserVar` seguem as mesmas regras. `$dataTransaction` recebe
412
412
  um array de até 100 operações JSON para ler, escrever, apagar, incrementar e
413
413
  alterar/consultar TTL em vários escopos atomicamente. Uma operação inválida ou
414
- saída acima do orçamento desfaz tudo; veja [STORAGE.md](STORAGE.md).
414
+ saída acima do orçamento desfaz tudo; veja [STORAGE.md](../STORAGE.md).
415
415
  Não há execução de scripts assíncronos dentro de transações do store.
416
416
 
417
417
  `$modMoveMember[usuário;canal;motivo]`, `$modMuteMember[usuário;true;motivo]`
@@ -520,7 +520,7 @@ separados por vírgula ou quebra de linha.
520
520
  O cliente bloqueia por padrão loopback, redes privadas e endereços de metadados,
521
521
  inclusive após redirecionamentos. Também aplica timeout, limite de bytes e uma
522
522
  allowlist opcional de hosts. As opções ficam em `new HttpService({ ... })`;
523
- veja [API](API.md). Use `http: false` para remover o serviço do contexto.
523
+ veja [API](../API.md). Use `http: false` para remover o serviço do contexto.
524
524
 
525
525
  ## Diagnóstico e limites
526
526
 
@@ -528,7 +528,7 @@ Scripts são analisados antes de registrar os comandos. Função desconhecida,
528
528
  aridade incorreta e delimitadores incompletos são erros com arquivo/linha/coluna.
529
529
  O runtime envolve falhas com o local da chamada e mantém a causa para o handler.
530
530
  O editor também aponta esses problemas enquanto digita e pode ler metadados de
531
- plugins em JSON, conforme [EDITOR.md](EDITOR.md). Cancelamento HTTP/collectors
531
+ plugins em JSON, conforme [EDITOR.md](../EDITOR.md). Cancelamento HTTP/collectors
532
532
  do contexto interrompe a espera e não é capturado por `$try`.
533
533
  O usuário recebe um erro genérico nas falhas internas; guards usam suas próprias
534
- mensagens. Confira os limites e o modelo de confiança em [STORAGE.md](STORAGE.md).
534
+ mensagens. Confira os limites e o modelo de confiança em [STORAGE.md](../STORAGE.md).
@@ -0,0 +1,33 @@
1
+ # Function mode (opcional)
2
+
3
+ O function mode é uma linguagem de scripts declarativa opcional. Ele não faz
4
+ parte da superfície nativa: a raiz `yuzuha` não carrega parser, runtime nem
5
+ builtins. Para usá-lo em comandos com `code`, eventos de script ou plugins com
6
+ `functions`, instale um engine explicitamente:
7
+
8
+ Uma engine compila programas opacos; cada programa executa sempre na engine que o compilou.
9
+
10
+ ```ts
11
+ import { Yuzuha, MemoryStore } from 'yuzuha';
12
+ import { functions, script } from 'yuzuha/functions';
13
+
14
+ const bot = new Yuzuha({
15
+ transport,
16
+ store: new MemoryStore(),
17
+ engine: functions(),
18
+ });
19
+
20
+ bot.command(script({ name: 'ola', code: '$reply[Olá, $username!]' }));
21
+ ```
22
+
23
+ Também é possível instalar depois com `bot.useEngine(engine)`. Registrar
24
+ `code` ou `scriptEvent` sem engine falha com `FUNCTIONS_REQUIRED`. A CLI injeta
25
+ `functions()` automaticamente, então `yuzuha.config.js` e `init --functions`
26
+ não exigem configuração extra.
27
+
28
+ ## Documentos
29
+
30
+ - [LANGUAGE.md](LANGUAGE.md): sintaxe da linguagem de scripts.
31
+ - [FUNCTIONS.md](FUNCTIONS.md): referência gerada das 336 funções.
32
+ - [LANGUAGE-EXTENSIONS.md](LANGUAGE-EXTENSIONS.md): operações de dados e extensões.
33
+ - [FUNCTION-GAPS.md](FUNCTION-GAPS.md): lacunas conhecidas e como contorná-las.
@@ -96,5 +96,5 @@ da configuração durante seu próprio ciclo de vida.
96
96
 
97
97
  Para transações entre chaves, backup, restauração e falhas parciais, consulte o
98
98
  [guia de estado e persistência](../STORAGE.md). Para scripts, veja as
99
- [transações declarativas](../LANGUAGE.md) e a assinatura de
100
- [`$dataTransaction` no catálogo de funções](../FUNCTIONS.md).
99
+ [transações declarativas](../functions/LANGUAGE.md) e a assinatura de
100
+ [`$dataTransaction` no catálogo de funções](../functions/FUNCTIONS.md).
@@ -95,6 +95,6 @@ A busca ignora maiúsculas e procura nome, aliases e descrição. Na documentaç
95
95
  a área Funções separa o catálogo por categoria e oferece uma página para cada
96
96
  assinatura. Aliases não aumentam a contagem canônica de funções.
97
97
 
98
- Consulte a [sintaxe e as regras de avaliação](../LANGUAGE.md), o
99
- [catálogo completo de funções](../FUNCTIONS.md) e os
98
+ Consulte a [sintaxe e as regras de avaliação](../functions/LANGUAGE.md), o
99
+ [catálogo completo de funções](../functions/FUNCTIONS.md) e os
100
100
  [eventos de script](../EVENTS.md).
@@ -0,0 +1,24 @@
1
+ import { mkdir, readFile, writeFile } from 'node:fs/promises';
2
+ import { createCanvas, loadImage, registerFonts } from 'yuzuha/canvas';
3
+
4
+ const output = new URL('./output/', import.meta.url);
5
+ await mkdir(output, { recursive: true });
6
+
7
+ registerFonts(new URL('../../assets/canvas/', import.meta.url).pathname);
8
+
9
+ const avatar = await loadImage(new URL('./fixtures/avatar.png', import.meta.url).pathname);
10
+ const canvas = createCanvas(640, 240);
11
+ const ctx = canvas.getContext('2d');
12
+ ctx.fillStyle = '#101722';
13
+ ctx.fillRect(0, 0, 640, 240);
14
+ ctx.drawImage(avatar, 24, 56, 128, 128);
15
+ ctx.font = '700 48px Inter';
16
+ ctx.fillStyle = '#f2f4f5';
17
+ ctx.fillText('Ada Monteiro', 184, 110);
18
+ ctx.font = '24px Inter';
19
+ ctx.fillStyle = '#aebac6';
20
+ ctx.fillText('Desenho direto com a API napi.', 184, 152);
21
+
22
+ const png = new Uint8Array(await canvas.encode('png'));
23
+ await writeFile(new URL('napi-style.png', output), png);
24
+ console.log(`PNG gravado em ${new URL('napi-style.png', output).pathname}`);
@@ -1,3 +1,3 @@
1
- import type { CanvasBuilder, CanvasSource } from 'yuzuha/canvas';
1
+ import type { CanvasBuilder, CanvasSource } from 'yuzuha/canvas/card';
2
2
 
3
3
  export function buildProfile(name: string, avatar: CanvasSource): CanvasBuilder;
@@ -1,7 +1,7 @@
1
- import { createCanvas } from 'yuzuha/canvas';
1
+ import { createCard } from 'yuzuha/canvas/card';
2
2
 
3
3
  export function buildProfile(name, avatar) {
4
- return createCanvas(1000, 340, { scale: 2, background: '#101722' })
4
+ return createCard(1000, 340, { scale: 2, background: '#101722' })
5
5
  .rect({ x: 0, y: 0, width: 8, height: 340, fill: '#70d8bc' })
6
6
  .avatar(avatar, { x: 44, y: 92, size: 156, border: { color: '#8ce5c9', width: 3 } })
7
7
  .text('COMMUNITY MEMBER', { x: 230, y: 38, maxWidth: 600, fontSize: 14, weight: 700, color: '#70d8bc' })
@@ -1,5 +1,5 @@
1
- import { createCanvas } from 'yuzuha/canvas';
2
- import type { CanvasBuilder, CanvasCreateOptions, CanvasSource } from 'yuzuha/canvas';
1
+ import { createCard } from 'yuzuha/canvas/card';
2
+ import type { CanvasBuilder, CanvasCreateOptions, CanvasSource } from 'yuzuha/canvas/card';
3
3
  import type { CommandContext } from 'yuzuha';
4
4
 
5
5
  type CanvasCreate = (width: number, height: number, options?: CanvasCreateOptions) => CanvasBuilder;
@@ -24,7 +24,7 @@ function composeProfile(create: CanvasCreate, name: string, avatar: CanvasSource
24
24
  }
25
25
 
26
26
  export function buildProfile(name: string, avatar: CanvasSource): CanvasBuilder {
27
- return composeProfile(createCanvas, name, avatar);
27
+ return composeProfile(createCard, name, avatar);
28
28
  }
29
29
 
30
30
  export async function sendProfile(ctx: CommandContext, avatar: CanvasSource = 'asset:avatar'): Promise<string> {
@@ -1,4 +1,4 @@
1
- import type { CanvasBuilder } from 'yuzuha/canvas';
1
+ import type { CanvasBuilder } from 'yuzuha/canvas/card';
2
2
 
3
3
  export interface RankingEntry { name: string; score: number }
4
4
 
@@ -1,4 +1,4 @@
1
- import { createCanvas } from 'yuzuha/canvas';
1
+ import { createCard } from 'yuzuha/canvas/card';
2
2
 
3
3
  const sampleEntries = [
4
4
  { name: 'Lia', score: 96 }, { name: 'Domingos Ribeiro', score: 88 }, { name: 'Samira', score: 82 },
@@ -9,7 +9,7 @@ const sampleEntries = [
9
9
 
10
10
  export function buildRanking(entries = sampleEntries) {
11
11
  if (entries.length !== 10) throw new RangeError('O exemplo de ranking recebe dez posições.');
12
- const canvas = createCanvas(1000, 700, { background: '#101722' })
12
+ const canvas = createCard(1000, 700, { background: '#101722' })
13
13
  .rect({ x: 0, y: 0, width: 8, height: 700, fill: '#70d8bc' })
14
14
  .text('Community activity', { x: 42, y: 34, maxWidth: 600, fontSize: 34, weight: 700, color: '#f2f4f5' })
15
15
  .text('Ten sample positions · demonstration data', { x: 42, y: 78, maxWidth: 700, fontSize: 16, color: '#9ca9b5' })
@@ -1,5 +1,5 @@
1
- import { createCanvas } from 'yuzuha/canvas';
2
- import type { CanvasBuilder, CanvasCreateOptions } from 'yuzuha/canvas';
1
+ import { createCard } from 'yuzuha/canvas/card';
2
+ import type { CanvasBuilder, CanvasCreateOptions } from 'yuzuha/canvas/card';
3
3
  import type { CommandContext } from 'yuzuha';
4
4
 
5
5
  export interface RankingEntry { name: string; score: number }
@@ -31,7 +31,7 @@ function composeRanking(create: CanvasCreate, entries: readonly RankingEntry[]):
31
31
  }
32
32
 
33
33
  export function buildRanking(entries: readonly RankingEntry[] = sampleEntries): CanvasBuilder {
34
- return composeRanking(createCanvas, entries);
34
+ return composeRanking(createCard, entries);
35
35
  }
36
36
 
37
37
  export async function sendRanking(ctx: CommandContext, entries: readonly RankingEntry[] = sampleEntries): Promise<string> {
@@ -1,6 +1,7 @@
1
1
  import { mkdir, readFile, writeFile } from 'node:fs/promises';
2
2
  import { resolve } from 'node:path';
3
3
  import { MemoryStore, Yuzuha } from 'yuzuha';
4
+ import { functions } from 'yuzuha/functions';
4
5
  import { MockTransport, mockMessage, mockResources } from 'yuzuha/testing';
5
6
  import { buildProfile } from './profile.js';
6
7
  import { buildWelcome } from './welcome.js';
@@ -28,7 +29,7 @@ for (const name of ['profile', 'welcome', 'ranking']) {
28
29
  const source = await readFile(new URL(`./functions/${name}.yuzuha`, directory), 'utf8');
29
30
  let data: Uint8Array | undefined;
30
31
  const bot = new Yuzuha({ prefix: '!', store: new MemoryStore(), scheduler: false, http: false,
31
- transport: new MockTransport(), canvas: { assets: { avatar } },
32
+ engine: functions(), transport: new MockTransport(), canvas: { assets: { avatar } },
32
33
  resources: mockResources({ messages: { async sendBytes(_channelID, files) { data = new Uint8Array(files[0]!.data); return 'offline'; } } }) });
33
34
  try {
34
35
  if (name === 'welcome') {
@@ -1,3 +1,3 @@
1
- import type { CanvasBuilder, CanvasSource } from 'yuzuha/canvas';
1
+ import type { CanvasBuilder, CanvasSource } from 'yuzuha/canvas/card';
2
2
 
3
3
  export function buildWelcome(name: string, avatar: CanvasSource): CanvasBuilder;
@@ -1,7 +1,7 @@
1
- import { createCanvas } from 'yuzuha/canvas';
1
+ import { createCard } from 'yuzuha/canvas/card';
2
2
 
3
3
  export function buildWelcome(name, avatar) {
4
- return createCanvas(980, 300, { background: '#111923' })
4
+ return createCard(980, 300, { background: '#111923' })
5
5
  .rect({ x: 0, y: 0, width: 12, height: 300, fill: '#d8a36b' })
6
6
  .avatar(avatar, { x: 42, y: 74, size: 152, border: { color: '#f0c38c', width: 3 } })
7
7
  .text('A NEW VOICE IN THE ROOM', { x: 232, y: 42, maxWidth: 700, fontSize: 13, weight: 700, color: '#e9b87e' })
@@ -1,5 +1,5 @@
1
- import { createCanvas } from 'yuzuha/canvas';
2
- import type { CanvasBuilder, CanvasCreateOptions, CanvasSource } from 'yuzuha/canvas';
1
+ import { createCard } from 'yuzuha/canvas/card';
2
+ import type { CanvasBuilder, CanvasCreateOptions, CanvasSource } from 'yuzuha/canvas/card';
3
3
  import type { EventContext } from 'yuzuha';
4
4
 
5
5
  type CanvasCreate = (width: number, height: number, options?: CanvasCreateOptions) => CanvasBuilder;
@@ -18,7 +18,7 @@ function composeWelcome(create: CanvasCreate, name: string, avatar: CanvasSource
18
18
  }
19
19
 
20
20
  export function buildWelcome(name: string, avatar: CanvasSource): CanvasBuilder {
21
- return composeWelcome(createCanvas, name, avatar);
21
+ return composeWelcome(createCard, name, avatar);
22
22
  }
23
23
 
24
24
  export async function welcomeEvent(ctx: EventContext, avatar: CanvasSource = 'asset:avatar'): Promise<string> {
@@ -1,5 +1,5 @@
1
1
  import { MemoryStore, Yuzuha } from 'yuzuha';
2
- import { script } from 'yuzuha/functions';
2
+ import { functions, script } from 'yuzuha/functions';
3
3
  import { MockTransport, mockMessage } from 'yuzuha/testing';
4
4
 
5
5
  // Mesmo embed do exemplo nativo, montado em function mode. Cada parte é validada pelas mesmas regras.
@@ -22,7 +22,7 @@ const code = [
22
22
  ].join('');
23
23
 
24
24
  const transport = new MockTransport();
25
- const bot = new Yuzuha({ transport, store: new MemoryStore() });
25
+ const bot = new Yuzuha({ transport, store: new MemoryStore(), engine: functions() });
26
26
 
27
27
  bot.command(script({ name: 'relatorio', code }));
28
28
 
@@ -1,11 +1,11 @@
1
1
  import { MemoryStore, Yuzuha } from 'yuzuha';
2
- import { script } from 'yuzuha/functions';
2
+ import { functions, script } from 'yuzuha/functions';
3
3
  import { MockTransport, mockMessage } from 'yuzuha/testing';
4
4
 
5
5
  const transport = new MockTransport();
6
- const bot = new Yuzuha({ transport, store: new MemoryStore() });
6
+ const bot = new Yuzuha({ transport, store: new MemoryStore(), engine: functions() });
7
7
 
8
- // Function mode é ativado automaticamente ao registrar um comando com `code`.
8
+ // Comandos com `code` exigem um engine de function mode instalado no bot.
9
9
  bot.command(script({
10
10
  name: 'ban',
11
11
  code: '$modBan[$mentioned[1];$messageSlice[1]]$reply[Membro banido. Caso #$caseID.]',