@virid/std 0.0.1

package/LICENSE

@@ -0,0 +1,190 @@
+   Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   Copyright 2026 Ailrid
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/README.md

@@ -0,0 +1,98 @@
+# @virid/std
+
+`@virid/std` 是 `@virid/core`的官方标准库，负责提供一组开箱即用的实用消息控制流操作。提供了原生的异步流、消息组、防抖节流等支持。
+
+## 🔌启用插件
+
+```ts
+import { createVirid, Component, System, EventMessage } from "@virid/core";
+import { nextTick, StdPlugin } from "@virid/std";
+
+const app = createVirid().use(StdPlugin, {});
+```
+
+## 🛠️ @virid/std 核心 API 概览
+
+### nextTick
+
+- **功能**：类似于`vue`中的`nextTick`，但该`Tick`指的是一个`virid`的宏观`Tick`，因此，当执行时该`Tick`内的所有同步`System`已经全部执行完毕，对于异步控制，则需要使用`@AsyncQueue`装饰器
+- **示例：**
+
+```ts
+nextTick(() => {
+  IncreaseBMessage.send();
+  IncreaseAMessage.send();
+  IncreaseBMessage.send();
+});
+```
+
+### `@AsyncQueue()`
+
+- **功能**：`@AsyncQueue()`提供了一个开箱即用的异步消息控制，该装饰器接受一个参数key，对于key相同的message，将严格按照先后顺序执行，而不会出现异步竟态问题。
+- **示例：**
+
+```ts
+@AsyncQueue("increase")
+class IncreaseAMessage extends EventMessage {}
+@AsyncQueue("increase")
+class IncreaseBMessage extends EventMessage {}
+@AsyncQueue("decrease")
+class DecreaseMessage extends EventMessage {}
+
+// 按以下顺序发送消息
+// 由于IncreaseMessage和IncreaseBMessage的key是相同的，
+// 即使存在异步操作，以下三条消息也必须按顺序执行
+IncreaseAMessage.send();
+IncreaseBMessage.send();
+IncreaseAMessage.send();
+// 由于DecaseMessage和其他消息之间的key不同
+// DecaseMessage不会等待上述消息
+// 但是，以下三条消息将按顺序执行
+DecreaseMessage.send();
+DecreaseMessage.send();
+DecreaseMessage.send();
+```
+
+### `executeGroup`
+
+- **功能**：`executeGroup`是一组消息的集合，将一组消息严格按照先后顺序一次性执行，并且当途中出错时取消后续逻辑。
+- **示例：**
+
+```ts
+const a = await executeGroup(
+[
+  new IncreaseAMessage(),
+  new IncreaseBMessage(),
+  new IncreaseAMessage(),
+  new DecreaseMessage(),
+],
+"first",
+);
+if (a) {
+console.log("[ExecuteGroup] Success");
+} else {
+console.log("[ExecuteGroup] Failed");
+}
+```
+
+### `@Debounce（）/@Throttle`
+
+- **功能**：开箱即用的防抖与节流支持。只需要一行代码即可实现。
+- **示例：**
+
+```ts
+// 100ms防抖：停止触发100ms后只执行一次
+// 后一个参数用于聚合消息
+@Debounce(100, (current, next) => {
+  current.val += next.val;
+})
+class SetTimerAMessage extends EventMessage {
+  constructor(public val: number) {
+    super();
+  }
+}
+
+// 100ms节流：100ms内只允许一次触发
+@Throttle(500)
+class IncreaseBMessage extends EventMessage {}
+```

package/README.zh.md

@@ -0,0 +1,109 @@
+# @virid/std
+
+**@virid/std** is the official standard library for **@virid/core**. It provides a set of out-of-the-box utility message control flow operations, featuring native support for asynchronous streams, message grouping, debouncing, throttling, and more.
+
+### 🔌 Enabling the Plugin
+
+```ts
+import { createVirid, Component, System, EventMessage } from "@virid/core";
+import { nextTick, StdPlugin } from "@virid/std";
+
+const app = createVirid().use(StdPlugin, {});
+```
+
+## 🛠️ @virid/std Core API Overview
+
+### `nextTick`
+
+- **Function**: Similar to `nextTick` in Vue, but refers to a **Virid Macro Tick**. When executed, all synchronous Systems within the current Tick have finished running. For asynchronous control, use the `@AsyncQueue` decorator.
+- **Example**:
+
+```ts
+nextTick(() => {
+  IncreaseBMessage.send();
+  IncreaseAMessage.send();
+  IncreaseBMessage.send();
+});
+```
+
+------
+
+### `@AsyncQueue(key: string)`
+
+- **Function**: Provides out-of-the-box asynchronous message control. It accepts a `key` parameter; messages sharing the same `key` are executed in strict sequential order, preventing asynchronous race conditions.
+- **Example**:
+
+TypeScript
+
+```ts
+@AsyncQueue("increase")
+class IncreaseAMessage extends EventMessage {}
+
+@AsyncQueue("increase")
+class IncreaseBMessage extends EventMessage {}
+
+@AsyncQueue("decrease")
+class DecreaseMessage extends EventMessage {}
+
+// Messages sent in the following order:
+// Because IncreaseAMessage and IncreaseBMessage share the same key,
+// they will execute sequentially even if they contain async operations.
+IncreaseAMessage.send();
+IncreaseBMessage.send();
+IncreaseAMessage.send();
+
+// Since DecreaseMessage has a different key, it does not wait for the above.
+// However, the three DecreaseMessages below will execute in their own sequence.
+DecreaseMessage.send();
+DecreaseMessage.send();
+DecreaseMessage.send();
+```
+
+------
+
+### **`executeGroup`**
+
+- **Function**: A collection of messages that executes a group in strict sequential order. If an error occurs during execution, subsequent logic is cancelled.
+- **Example**:
+
+```ts
+const success = await executeGroup(
+  [
+    new IncreaseAMessage(),
+    new IncreaseBMessage(),
+    new IncreaseAMessage(),
+    new DecreaseMessage(),
+  ],
+  "first"
+);
+
+if (success) {
+  console.log("[ExecuteGroup] Success");
+} else {
+  console.log("[ExecuteGroup] Failed");
+}
+```
+
+------
+
+### `@Debounce()` / `@Throttle()`
+
+- **Function**: Out-of-the-box support for debouncing and throttling. Can be implemented with a single line of code.
+- **Example**:
+
+```ts
+// 100ms Debounce: Executes only once after 100ms of inactivity.
+// The second parameter is used to aggregate messages.
+@Debounce(100, (current, next) => {
+  current.val += next.val;
+})
+class SetTimerAMessage extends EventMessage {
+  constructor(public val: number) {
+    super();
+  }
+}
+
+// 500ms Throttle: Limits execution to once every 500ms.
+@Throttle(500)
+class IncreaseBMessage extends EventMessage {}
+```

package/dist/index.cjs

@@ -0,0 +1,6 @@
+/**
+ *  @virid/std v0.0.1
+ *  The virid standard library provides commonly used features in development
+ */
+var f=Object.defineProperty;var P=Object.getOwnPropertyDescriptor;var _=Object.getOwnPropertyNames;var $=Object.prototype.hasOwnProperty;var n=(e,t)=>f(e,"name",{value:t,configurable:!0});var H=(e,t)=>{for(var o in t)f(e,o,{get:t[o],enumerable:!0})},U=(e,t,o,r)=>{if(t&&typeof t=="object"||typeof t=="function")for(let c of _(t))!$.call(e,c)&&c!==o&&f(e,c,{get:()=>t[c],enumerable:!(r=P(t,c))||r.enumerable});return e};var W=e=>U(f({},"__esModule",{value:!0}),e);var L={};H(L,{AsyncQueue:()=>F,Debounce:()=>R,StdPlugin:()=>J,Throttle:()=>j,activateAsyncQueue:()=>E,activateDeTh:()=>A,activateGroupMessages:()=>h,activateMessages:()=>G,activateNextTick:()=>M,activateUtils:()=>w,executeGroup:()=>B,nextTick:()=>V});module.exports=W(L);var p=[];function N(){if(p.length!=0){for(let e of p)e();p=[]}}n(N,"afterTickHook");function V(e){p.push(e)}n(V,"nextTick");function M(e){e.onAfterTick(N)}n(M,"activateNextTick");var u=require("@virid/core");var l=new Map,v=new Map,d=new Map,m=new Map;function Q(e){for(let t of d.get(e))v.delete(t);d.delete(e),l.delete(e),m.delete(e)}n(Q,"clearGroup");function z(e,t,o){let r=v.get(e);if(r){let c=l.get(r);if(o){if(c.length>0){let{resolve:i}=c.shift();i(),c.length==0&&(m.get(r)(!0),Q(r))}}else m.get(r)(!1),Q(r),u.MessageWriter.error(new Error(`[ExecuteGroup] Queue Execution Failed: Due to an error in the System execution triggered by ${e.constructor.name}, the message group '${r}' has been cancelled`))}}n(z,"afterExecuteHook");async function B(e,t="default"){if(l.has(t))return u.MessageWriter.error(new Error(`[ExecuteGroup] Unavailable ID: The id '${t}' not yet executed`)),Promise.resolve(!1);let o=[];d.set(t,e),e.forEach((i,s)=>{let x;s==e.length-1?x=n(()=>{},"resolve"):x=n(()=>u.MessageWriter.write(e[s+1]),"resolve"),o.push({message:i,resolve:x}),v.set(i,t)});let r,c=new Promise(i=>{r=i});return m.set(t,r),l.set(t,o),u.MessageWriter.write(e[0]),c}n(B,"executeGroup");function h(e){e.onAfterExecute(u.EventMessage,z)}n(h,"activateGroupMessages");function w(e){M(e),h(e)}n(w,"activateUtils");var T=require("@virid/core");var y=new Map,k=new Map;function F(e="default"){return function(t){y.set(t,e)}}n(F,"AsyncQueue");function I(e,t){let o=y.get(e.constructor);if(o&&e instanceof T.EventMessage){let r=k.get(o)||[];r.push({message:e,next:t}),k.set(o,r),r.length==1&&t()}else t()}n(I,"middleWare");function K(e,t){let o=y.get(e.constructor);if(o){let r=k.get(o);r.at(0)?.message===e&&(r.shift(),r.at(0)?.next())}}n(K,"afterExecuteHook");function E(e){e.useMiddleware(I),e.onAfterExecute(T.EventMessage,K)}n(E,"activateAsyncQueue");var D=new Map,a=new Map,C=new Map,b=new Map;function R(e=100,t=()=>{}){return function(o){D.set(o,{time:e,merge:t})}}n(R,"Debounce");function j(e=100){return function(t){C.set(t,e)}}n(j,"Throttle");function q(e,t){let o=e.constructor,r=D.get(o);if(r){let i=a.get(o);if(i){clearTimeout(i.timer),r.merge(e,i.message);let s=setTimeout(()=>{a.delete(o),t()},r.time);a.set(o,{message:e,timer:s})}else{let s=setTimeout(()=>{a.delete(o),t()},r.time);a.set(o,{message:e,timer:s})}return}let c=C.get(o);if(c){let i=Date.now(),s=b.get(o)||0;if(i-s>=c)b.set(o,i),t();else return;return}t()}n(q,"middleWare");function A(e){e.useMiddleware(q)}n(A,"activateDeTh");function G(e){E(e),A(e)}n(G,"activateMessages");var g=null;function S(e){w(e),G(e),g=e}n(S,"activateApp");var he=new Proxy({},{get(e,t){return(...o)=>{if(!g)return console.warn(`[Virid Std] App method "${String(t)}" called before initialization.`),t==="register"?()=>{console.warn("[Virid Std] Cleanup ignored: source listener was never registered.")}:void 0;let r=g[t];if(typeof r=="function")return Reflect.apply(r,g,o)}}});var J={name:"@virid/std",install(e,t){S(e)}};0&&(module.exports={AsyncQueue,Debounce,StdPlugin,Throttle,activateAsyncQueue,activateDeTh,activateGroupMessages,activateMessages,activateNextTick,activateUtils,executeGroup,nextTick});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/utils/nexttick.ts","../src/utils/message-group.ts","../src/utils/index.ts","../src/messages/async.ts","../src/messages/deth.ts","../src/messages/index.ts","../src/app.ts"],"sourcesContent":["/*\n * Copyright (c) 2026-present Ailrid\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n *\n * Description: The virid standard library provides commonly used features in development.\n */\nimport { ViridPlugin, type ViridApp } from \"@virid/core\";\nexport * from \"./utils\";\nexport * from \"./messages\";\nimport { activateApp } from \"./app\";\nexport const StdPlugin: ViridPlugin = {\n  name: \"@virid/std\",\n  install(app: ViridApp, _options) {\n    activateApp(app);\n  },\n};\n","import { type ViridApp } from \"@virid/core\";\n\n// 一个简单的nextTick函数\nlet tickTaskQueue: Array<() => void> = [];\n\nfunction afterTickHook() {\n  if (tickTaskQueue.length == 0) return;\n  for (const task of tickTaskQueue) {\n    task();\n  }\n  tickTaskQueue = [];\n}\n\nexport function nextTick(task: () => void) {\n  tickTaskQueue.push(task);\n}\n\nexport function activateNextTick(app: ViridApp) {\n  app.onAfterTick(afterTickHook);\n}\n","import {\n  EventMessage,\n  type ViridApp,\n  type ExecuteHookContext,\n  MessageWriter,\n} from \"@virid/core\";\ninterface ExecuteContext {\n  message: EventMessage;\n  resolve: () => void;\n}\n// 每个key中缓存的执行组队列\nconst executeGroupMap = new Map<string, ExecuteContext[]>();\nconst messageKeyMap = new Map<EventMessage, string>();\nconst keyMessageMap = new Map<string, EventMessage[]>();\nconst callBackMap = new Map<string, (success: boolean) => void>();\n\nfunction clearGroup(id: string) {\n  for (const message of keyMessageMap.get(id)!) {\n    messageKeyMap.delete(message);\n  }\n  keyMessageMap.delete(id);\n  executeGroupMap.delete(id);\n  callBackMap.delete(id);\n}\n\nfunction afterExecuteHook(\n  message: EventMessage,\n  _hookContext: ExecuteHookContext,\n  success: boolean,\n) {\n  const key = messageKeyMap.get(message);\n  if (key) {\n    const executeGroup = executeGroupMap.get(key)!;\n    if (success) {\n      // 只有当前任务执行成功，才继续下一个\n      if (executeGroup.length > 0) {\n        const { resolve } = executeGroup.shift()!;\n        resolve();\n        if (executeGroup.length == 0) {\n          callBackMap.get(key)!(true);\n          clearGroup(key);\n        }\n      }\n    } else {\n      callBackMap.get(key)!(false);\n      clearGroup(key);\n      // 如果出错了，直接取消执行队列\n      MessageWriter.error(\n        new Error(\n          `[ExecuteGroup] Queue Execution Failed: Due to an error in the System execution triggered by ${message.constructor.name}, the message group '${key}' has been cancelled`,\n        ),\n      );\n    }\n  }\n}\nexport async function executeGroup(\n  messages: EventMessage[],\n  id: string = \"default\",\n): Promise<boolean> {\n  // 构造一串promise并且把resolve存起来,每个resolve会启动下一个promise\n  if (executeGroupMap.has(id)) {\n    MessageWriter.error(\n      new Error(\n        `[ExecuteGroup] Unavailable ID: The id '${id}' not yet executed`,\n      ),\n    );\n    return Promise.resolve(false);\n  }\n  // 注册这一个执行组\n  const executeChain: ExecuteContext[] = [];\n  keyMessageMap.set(id, messages);\n  messages.forEach((message, index) => {\n    let resolve: () => void;\n    if (index == messages.length - 1) {\n      resolve = () => {};\n    } else {\n      resolve = () => MessageWriter.write(messages[index + 1]);\n    }\n    executeChain.push({\n      message,\n      resolve,\n    });\n    messageKeyMap.set(message, id);\n  });\n  let resolver: (success: boolean) => void;\n  const promise = new Promise<boolean>((res) => {\n    resolver = res;\n  });\n  callBackMap.set(id, resolver!);\n\n  executeGroupMap.set(id, executeChain);\n\n  // 立刻触发第一个\n  MessageWriter.write(messages[0]);\n  return promise;\n}\n\nexport function activateGroupMessages(app: ViridApp) {\n  app.onAfterExecute(EventMessage, afterExecuteHook);\n}\n","import { activateNextTick } from \"./nexttick\";\nimport { activateGroupMessages } from \"./message-group\";\nimport { type ViridApp } from \"@virid/core\";\nexport function activateUtils(app: ViridApp) {\n  activateNextTick(app)\n  activateGroupMessages(app);\n}\n\nexport * from \"./message-group\";\nexport * from \"./nexttick\";\n","import {\n  EventMessage,\n  type ViridApp,\n  type ExecuteHookContext,\n  type Newable,\n  BaseMessage,\n} from \"@virid/core\";\ninterface QueueContext {\n  message: EventMessage;\n  next: () => void;\n}\n\n// 消息和key的对应关系\nconst asyncMessageMap = new Map<Newable<EventMessage>, string>();\n// 每个key中缓存的消息序列\nconst asyncMessageQueue = new Map<string, QueueContext[]>();\n\n/**\n * * 注册异步队列消息\n */\nexport function AsyncQueue(key: string = \"default\") {\n  return function (target: Newable<EventMessage>) {\n    asyncMessageMap.set(target, key);\n  };\n}\n\n/**\n * * 拦截所有异步消息\n */\nfunction middleWare(message: BaseMessage, next: () => void): void {\n  const key = asyncMessageMap.get(message.constructor as Newable<EventMessage>);\n  if (key && message instanceof EventMessage) {\n    const currentQueue = asyncMessageQueue.get(key) || [];\n    currentQueue.push({ message, next });\n    asyncMessageQueue.set(key, currentQueue);\n    // 如果没有暂存队列，立刻放行\n    if (currentQueue.length == 1) next();\n  } else {\n    next();\n  }\n}\n\nfunction afterExecuteHook(\n  message: EventMessage,\n  _hookContext: ExecuteHookContext,\n) {\n  // 当前消息是否是需要排序的\n  const key = asyncMessageMap.get(message.constructor as Newable<EventMessage>);\n  if (key) {\n    // 如果此消息正是队列头部记录的message\n    // 那么立刻这一个，然后投递另一个后继消息\n    const currentQueue = asyncMessageQueue.get(key)!;\n    if (currentQueue.at(0)?.message === message) {\n      currentQueue.shift();\n      currentQueue.at(0)?.next();\n    }\n  }\n}\n\nexport function activateAsyncQueue(app: ViridApp) {\n  app.useMiddleware(middleWare);\n  app.onAfterExecute(EventMessage, afterExecuteHook);\n}\n","import { type ViridApp, type Newable, BaseMessage } from \"@virid/core\";\n\ninterface DebounceContext<T> {\n  time: number;\n  merge: (currentMessage: T, nextMessage: T) => void;\n}\n\ninterface DebounceTask {\n  message: BaseMessage;\n  timer: any;\n}\n\nconst debounceMap = new Map<Newable<BaseMessage>, DebounceContext<any>>();\n// 存储每个消息类对应的当前防抖任务（包含合并后的消息内容和计时器）\nconst prevDebounceTask = new Map<Newable<BaseMessage>, DebounceTask>();\n\nconst throttleMap = new Map<Newable<BaseMessage>, number>();\n// 存储每个消息类上一次真正执行的时间戳\nconst prevThTime = new Map<Newable<BaseMessage>, number>();\n\n/**\n * 防抖装饰器：连续触发的消息会合并，直到停止触发一段时间后才执行\n */\nexport function Debounce<T extends BaseMessage>(\n  time: number = 100,\n  merge: (currentMessage: T, nextMessage: T) => void = () => {},\n) {\n  return function (target: Newable<T>) {\n    debounceMap.set(target, {\n      time,\n      merge,\n    });\n  };\n}\n\n/**\n * 节流装饰器：限制消息触发的频率\n */\nexport function Throttle(time: number = 100) {\n  return function (target: Newable<BaseMessage>) {\n    throttleMap.set(target, time);\n  };\n}\n\nfunction middleWare(message: BaseMessage, next: () => void): void {\n  const messageClass = message.constructor as Newable<BaseMessage>;\n  // 处理防抖\n  const de = debounceMap.get(messageClass);\n\n  if (de) {\n    const prevTask = prevDebounceTask.get(messageClass);\n    // 如果之前已经有在排队的任务，清除旧计时器并合并消息\n    if (prevTask) {\n      clearTimeout(prevTask.timer);\n      de.merge(message, prevTask.message);\n      const newTimer = setTimeout(() => {\n        prevDebounceTask.delete(messageClass);\n        next();\n      }, de.time);\n\n      prevDebounceTask.set(messageClass, {\n        message: message,\n        timer: newTimer,\n      });\n    } else {\n      // 第一次触发\n      const timer = setTimeout(() => {\n        prevDebounceTask.delete(messageClass);\n        next();\n      }, de.time);\n      prevDebounceTask.set(messageClass, { message, timer });\n    }\n    return; // 拦截当前消息，不立即向下执行\n  }\n  // 处理节流\n  const th = throttleMap.get(messageClass);\n  if (th) {\n    const now = Date.now();\n    const lastTime = prevThTime.get(messageClass) || 0;\n    if (now - lastTime >= th) {\n      prevThTime.set(messageClass, now);\n      next();\n    } else {\n      // 时间不够，直接丢弃该消息\n      return;\n    }\n    return;\n  }\n  next();\n}\n\nexport function activateDeTh(app: ViridApp) {\n  app.useMiddleware(middleWare);\n}\n","import { type ViridApp } from \"@virid/core\";\nimport { activateAsyncQueue } from \"./async\";\nimport { activateDeTh } from \"./deth\";\nexport * from \"./async\";\nexport * from \"./deth\";\n\nexport function activateMessages(app: ViridApp) {\n  activateAsyncQueue(app);\n  activateDeTh(app);\n}\n","/*\n * Copyright (c) 2026-present Ailrid.\n * Licensed under the Apache License, Version 2.0.\n * Project: Virid Std\n */\n\nimport { type ViridApp } from \"@virid/core\";\nimport { activateUtils } from \"./utils\";\nimport { activateMessages } from \"./messages\";\nlet activeApp: ViridApp | null = null;\n\n/**\n * 激活真正的 App 实例\n */\nexport function activateApp(app: ViridApp) {\n  activateUtils(app);\n  activateMessages(app);\n  activeApp = app;\n}\n\n/**\n * viridApp 代理\n */\nexport const viridApp: ViridApp = new Proxy({} as ViridApp, {\n  get(_, prop: keyof ViridApp) {\n    return (...args: any[]) => {\n      if (!activeApp) {\n        console.warn(\n          `[Virid Std] App method \"${String(prop)}\" called before initialization.`,\n        );\n\n        if (prop === \"register\") {\n          return () => {\n            console.warn(\n              \"[Virid Std] Cleanup ignored: source listener was never registered.\",\n            );\n          };\n        }\n        return undefined;\n      }\n      const targetMethod = activeApp[prop];\n      if (typeof targetMethod === \"function\") {\n        return Reflect.apply(targetMethod, activeApp, args);\n      }\n    };\n  },\n});\n"],"mappings":"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","names":["index_exports","__export","AsyncQueue","Debounce","StdPlugin","Throttle","activateAsyncQueue","activateDeTh","activateGroupMessages","activateMessages","activateNextTick","activateUtils","executeGroup","nextTick","__toCommonJS","tickTaskQueue","afterTickHook","length","task","nextTick","push","activateNextTick","app","onAfterTick","import_core","executeGroupMap","Map","messageKeyMap","keyMessageMap","callBackMap","clearGroup","id","message","get","delete","afterExecuteHook","_hookContext","success","key","executeGroup","length","resolve","shift","MessageWriter","error","Error","name","messages","has","Promise","executeChain","set","forEach","index","__name","write","push","resolver","promise","res","activateGroupMessages","app","onAfterExecute","EventMessage","activateUtils","app","activateNextTick","activateGroupMessages","import_core","asyncMessageMap","Map","asyncMessageQueue","AsyncQueue","key","target","set","middleWare","message","next","get","EventMessage","currentQueue","push","length","afterExecuteHook","_hookContext","at","shift","activateAsyncQueue","app","useMiddleware","onAfterExecute","debounceMap","Map","prevDebounceTask","throttleMap","prevThTime","Debounce","time","merge","target","set","Throttle","middleWare","message","next","messageClass","de","get","prevTask","clearTimeout","timer","newTimer","setTimeout","delete","th","now","Date","lastTime","activateDeTh","app","useMiddleware","activateMessages","app","activateAsyncQueue","activateDeTh","activeApp","activateApp","app","activateUtils","activateMessages","viridApp","Proxy","get","_","prop","args","console","warn","String","targetMethod","Reflect","apply","StdPlugin","name","install","app","_options","activateApp"]}

package/dist/index.d.cts

@@ -0,0 +1,31 @@
+import { ViridApp, EventMessage, Newable, BaseMessage, ViridPlugin } from '@virid/core';
+
+declare function executeGroup(messages: EventMessage[], id?: string): Promise<boolean>;
+declare function activateGroupMessages(app: ViridApp): void;
+
+declare function nextTick(task: () => void): void;
+declare function activateNextTick(app: ViridApp): void;
+
+declare function activateUtils(app: ViridApp): void;
+
+/**
+ * * 注册异步队列消息
+ */
+declare function AsyncQueue(key?: string): (target: Newable<EventMessage>) => void;
+declare function activateAsyncQueue(app: ViridApp): void;
+
+/**
+ * 防抖装饰器：连续触发的消息会合并，直到停止触发一段时间后才执行
+ */
+declare function Debounce<T extends BaseMessage>(time?: number, merge?: (currentMessage: T, nextMessage: T) => void): (target: Newable<T>) => void;
+/**
+ * 节流装饰器：限制消息触发的频率
+ */
+declare function Throttle(time?: number): (target: Newable<BaseMessage>) => void;
+declare function activateDeTh(app: ViridApp): void;
+
+declare function activateMessages(app: ViridApp): void;
+
+declare const StdPlugin: ViridPlugin;
+
+export { AsyncQueue, Debounce, StdPlugin, Throttle, activateAsyncQueue, activateDeTh, activateGroupMessages, activateMessages, activateNextTick, activateUtils, executeGroup, nextTick };

package/dist/index.d.ts

@@ -0,0 +1,31 @@
+import { ViridApp, EventMessage, Newable, BaseMessage, ViridPlugin } from '@virid/core';
+
+declare function executeGroup(messages: EventMessage[], id?: string): Promise<boolean>;
+declare function activateGroupMessages(app: ViridApp): void;
+
+declare function nextTick(task: () => void): void;
+declare function activateNextTick(app: ViridApp): void;
+
+declare function activateUtils(app: ViridApp): void;
+
+/**
+ * * 注册异步队列消息
+ */
+declare function AsyncQueue(key?: string): (target: Newable<EventMessage>) => void;
+declare function activateAsyncQueue(app: ViridApp): void;
+
+/**
+ * 防抖装饰器：连续触发的消息会合并，直到停止触发一段时间后才执行
+ */
+declare function Debounce<T extends BaseMessage>(time?: number, merge?: (currentMessage: T, nextMessage: T) => void): (target: Newable<T>) => void;
+/**
+ * 节流装饰器：限制消息触发的频率
+ */
+declare function Throttle(time?: number): (target: Newable<BaseMessage>) => void;
+declare function activateDeTh(app: ViridApp): void;
+
+declare function activateMessages(app: ViridApp): void;
+
+declare const StdPlugin: ViridPlugin;
+
+export { AsyncQueue, Debounce, StdPlugin, Throttle, activateAsyncQueue, activateDeTh, activateGroupMessages, activateMessages, activateNextTick, activateUtils, executeGroup, nextTick };

package/dist/index.js

@@ -0,0 +1,6 @@
+/**
+ *  @virid/std v0.0.1
+ *  The virid standard library provides commonly used features in development
+ */
+var S=Object.defineProperty;var o=(e,t)=>S(e,"name",{value:t,configurable:!0});var a=[];function P(){if(a.length!=0){for(let e of a)e();a=[]}}o(P,"afterTickHook");function V(e){a.push(e)}o(V,"nextTick");function h(e){e.onAfterTick(P)}o(h,"activateNextTick");import{EventMessage as _,MessageWriter as f}from"@virid/core";var p=new Map,M=new Map,x=new Map,l=new Map;function w(e){for(let t of x.get(e))M.delete(t);x.delete(e),p.delete(e),l.delete(e)}o(w,"clearGroup");function $(e,t,n){let r=M.get(e);if(r){let i=p.get(r);if(n){if(i.length>0){let{resolve:c}=i.shift();c(),i.length==0&&(l.get(r)(!0),w(r))}}else l.get(r)(!1),w(r),f.error(new Error(`[ExecuteGroup] Queue Execution Failed: Due to an error in the System execution triggered by ${e.constructor.name}, the message group '${r}' has been cancelled`))}}o($,"afterExecuteHook");async function I(e,t="default"){if(p.has(t))return f.error(new Error(`[ExecuteGroup] Unavailable ID: The id '${t}' not yet executed`)),Promise.resolve(!1);let n=[];x.set(t,e),e.forEach((c,s)=>{let g;s==e.length-1?g=o(()=>{},"resolve"):g=o(()=>f.write(e[s+1]),"resolve"),n.push({message:c,resolve:g}),M.set(c,t)});let r,i=new Promise(c=>{r=c});return l.set(t,r),p.set(t,n),f.write(e[0]),i}o(I,"executeGroup");function k(e){e.onAfterExecute(_,$)}o(k,"activateGroupMessages");function T(e){h(e),k(e)}o(T,"activateUtils");import{EventMessage as y}from"@virid/core";var v=new Map,d=new Map;function Z(e="default"){return function(t){v.set(t,e)}}o(Z,"AsyncQueue");function H(e,t){let n=v.get(e.constructor);if(n&&e instanceof y){let r=d.get(n)||[];r.push({message:e,next:t}),d.set(n,r),r.length==1&&t()}else t()}o(H,"middleWare");function U(e,t){let n=v.get(e.constructor);if(n){let r=d.get(n);r.at(0)?.message===e&&(r.shift(),r.at(0)?.next())}}o(U,"afterExecuteHook");function E(e){e.useMiddleware(H),e.onAfterExecute(y,U)}o(E,"activateAsyncQueue");var G=new Map,u=new Map,Q=new Map,A=new Map;function oe(e=100,t=()=>{}){return function(n){G.set(n,{time:e,merge:t})}}o(oe,"Debounce");function re(e=100){return function(t){Q.set(t,e)}}o(re,"Throttle");function W(e,t){let n=e.constructor,r=G.get(n);if(r){let c=u.get(n);if(c){clearTimeout(c.timer),r.merge(e,c.message);let s=setTimeout(()=>{u.delete(n),t()},r.time);u.set(n,{message:e,timer:s})}else{let s=setTimeout(()=>{u.delete(n),t()},r.time);u.set(n,{message:e,timer:s})}return}let i=Q.get(n);if(i){let c=Date.now(),s=A.get(n)||0;if(c-s>=i)A.set(n,c),t();else return;return}t()}o(W,"middleWare");function b(e){e.useMiddleware(W)}o(b,"activateDeTh");function D(e){E(e),b(e)}o(D,"activateMessages");var m=null;function C(e){T(e),D(e),m=e}o(C,"activateApp");var ge=new Proxy({},{get(e,t){return(...n)=>{if(!m)return console.warn(`[Virid Std] App method "${String(t)}" called before initialization.`),t==="register"?()=>{console.warn("[Virid Std] Cleanup ignored: source listener was never registered.")}:void 0;let r=m[t];if(typeof r=="function")return Reflect.apply(r,m,n)}}});var ve={name:"@virid/std",install(e,t){C(e)}};export{Z as AsyncQueue,oe as Debounce,ve as StdPlugin,re as Throttle,E as activateAsyncQueue,b as activateDeTh,k as activateGroupMessages,D as activateMessages,h as activateNextTick,T as activateUtils,I as executeGroup,V as nextTick};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/utils/nexttick.ts","../src/utils/message-group.ts","../src/utils/index.ts","../src/messages/async.ts","../src/messages/deth.ts","../src/messages/index.ts","../src/app.ts","../src/index.ts"],"sourcesContent":["import { type ViridApp } from \"@virid/core\";\n\n// 一个简单的nextTick函数\nlet tickTaskQueue: Array<() => void> = [];\n\nfunction afterTickHook() {\n  if (tickTaskQueue.length == 0) return;\n  for (const task of tickTaskQueue) {\n    task();\n  }\n  tickTaskQueue = [];\n}\n\nexport function nextTick(task: () => void) {\n  tickTaskQueue.push(task);\n}\n\nexport function activateNextTick(app: ViridApp) {\n  app.onAfterTick(afterTickHook);\n}\n","import {\n  EventMessage,\n  type ViridApp,\n  type ExecuteHookContext,\n  MessageWriter,\n} from \"@virid/core\";\ninterface ExecuteContext {\n  message: EventMessage;\n  resolve: () => void;\n}\n// 每个key中缓存的执行组队列\nconst executeGroupMap = new Map<string, ExecuteContext[]>();\nconst messageKeyMap = new Map<EventMessage, string>();\nconst keyMessageMap = new Map<string, EventMessage[]>();\nconst callBackMap = new Map<string, (success: boolean) => void>();\n\nfunction clearGroup(id: string) {\n  for (const message of keyMessageMap.get(id)!) {\n    messageKeyMap.delete(message);\n  }\n  keyMessageMap.delete(id);\n  executeGroupMap.delete(id);\n  callBackMap.delete(id);\n}\n\nfunction afterExecuteHook(\n  message: EventMessage,\n  _hookContext: ExecuteHookContext,\n  success: boolean,\n) {\n  const key = messageKeyMap.get(message);\n  if (key) {\n    const executeGroup = executeGroupMap.get(key)!;\n    if (success) {\n      // 只有当前任务执行成功，才继续下一个\n      if (executeGroup.length > 0) {\n        const { resolve } = executeGroup.shift()!;\n        resolve();\n        if (executeGroup.length == 0) {\n          callBackMap.get(key)!(true);\n          clearGroup(key);\n        }\n      }\n    } else {\n      callBackMap.get(key)!(false);\n      clearGroup(key);\n      // 如果出错了，直接取消执行队列\n      MessageWriter.error(\n        new Error(\n          `[ExecuteGroup] Queue Execution Failed: Due to an error in the System execution triggered by ${message.constructor.name}, the message group '${key}' has been cancelled`,\n        ),\n      );\n    }\n  }\n}\nexport async function executeGroup(\n  messages: EventMessage[],\n  id: string = \"default\",\n): Promise<boolean> {\n  // 构造一串promise并且把resolve存起来,每个resolve会启动下一个promise\n  if (executeGroupMap.has(id)) {\n    MessageWriter.error(\n      new Error(\n        `[ExecuteGroup] Unavailable ID: The id '${id}' not yet executed`,\n      ),\n    );\n    return Promise.resolve(false);\n  }\n  // 注册这一个执行组\n  const executeChain: ExecuteContext[] = [];\n  keyMessageMap.set(id, messages);\n  messages.forEach((message, index) => {\n    let resolve: () => void;\n    if (index == messages.length - 1) {\n      resolve = () => {};\n    } else {\n      resolve = () => MessageWriter.write(messages[index + 1]);\n    }\n    executeChain.push({\n      message,\n      resolve,\n    });\n    messageKeyMap.set(message, id);\n  });\n  let resolver: (success: boolean) => void;\n  const promise = new Promise<boolean>((res) => {\n    resolver = res;\n  });\n  callBackMap.set(id, resolver!);\n\n  executeGroupMap.set(id, executeChain);\n\n  // 立刻触发第一个\n  MessageWriter.write(messages[0]);\n  return promise;\n}\n\nexport function activateGroupMessages(app: ViridApp) {\n  app.onAfterExecute(EventMessage, afterExecuteHook);\n}\n","import { activateNextTick } from \"./nexttick\";\nimport { activateGroupMessages } from \"./message-group\";\nimport { type ViridApp } from \"@virid/core\";\nexport function activateUtils(app: ViridApp) {\n  activateNextTick(app)\n  activateGroupMessages(app);\n}\n\nexport * from \"./message-group\";\nexport * from \"./nexttick\";\n","import {\n  EventMessage,\n  type ViridApp,\n  type ExecuteHookContext,\n  type Newable,\n  BaseMessage,\n} from \"@virid/core\";\ninterface QueueContext {\n  message: EventMessage;\n  next: () => void;\n}\n\n// 消息和key的对应关系\nconst asyncMessageMap = new Map<Newable<EventMessage>, string>();\n// 每个key中缓存的消息序列\nconst asyncMessageQueue = new Map<string, QueueContext[]>();\n\n/**\n * * 注册异步队列消息\n */\nexport function AsyncQueue(key: string = \"default\") {\n  return function (target: Newable<EventMessage>) {\n    asyncMessageMap.set(target, key);\n  };\n}\n\n/**\n * * 拦截所有异步消息\n */\nfunction middleWare(message: BaseMessage, next: () => void): void {\n  const key = asyncMessageMap.get(message.constructor as Newable<EventMessage>);\n  if (key && message instanceof EventMessage) {\n    const currentQueue = asyncMessageQueue.get(key) || [];\n    currentQueue.push({ message, next });\n    asyncMessageQueue.set(key, currentQueue);\n    // 如果没有暂存队列，立刻放行\n    if (currentQueue.length == 1) next();\n  } else {\n    next();\n  }\n}\n\nfunction afterExecuteHook(\n  message: EventMessage,\n  _hookContext: ExecuteHookContext,\n) {\n  // 当前消息是否是需要排序的\n  const key = asyncMessageMap.get(message.constructor as Newable<EventMessage>);\n  if (key) {\n    // 如果此消息正是队列头部记录的message\n    // 那么立刻这一个，然后投递另一个后继消息\n    const currentQueue = asyncMessageQueue.get(key)!;\n    if (currentQueue.at(0)?.message === message) {\n      currentQueue.shift();\n      currentQueue.at(0)?.next();\n    }\n  }\n}\n\nexport function activateAsyncQueue(app: ViridApp) {\n  app.useMiddleware(middleWare);\n  app.onAfterExecute(EventMessage, afterExecuteHook);\n}\n","import { type ViridApp, type Newable, BaseMessage } from \"@virid/core\";\n\ninterface DebounceContext<T> {\n  time: number;\n  merge: (currentMessage: T, nextMessage: T) => void;\n}\n\ninterface DebounceTask {\n  message: BaseMessage;\n  timer: any;\n}\n\nconst debounceMap = new Map<Newable<BaseMessage>, DebounceContext<any>>();\n// 存储每个消息类对应的当前防抖任务（包含合并后的消息内容和计时器）\nconst prevDebounceTask = new Map<Newable<BaseMessage>, DebounceTask>();\n\nconst throttleMap = new Map<Newable<BaseMessage>, number>();\n// 存储每个消息类上一次真正执行的时间戳\nconst prevThTime = new Map<Newable<BaseMessage>, number>();\n\n/**\n * 防抖装饰器：连续触发的消息会合并，直到停止触发一段时间后才执行\n */\nexport function Debounce<T extends BaseMessage>(\n  time: number = 100,\n  merge: (currentMessage: T, nextMessage: T) => void = () => {},\n) {\n  return function (target: Newable<T>) {\n    debounceMap.set(target, {\n      time,\n      merge,\n    });\n  };\n}\n\n/**\n * 节流装饰器：限制消息触发的频率\n */\nexport function Throttle(time: number = 100) {\n  return function (target: Newable<BaseMessage>) {\n    throttleMap.set(target, time);\n  };\n}\n\nfunction middleWare(message: BaseMessage, next: () => void): void {\n  const messageClass = message.constructor as Newable<BaseMessage>;\n  // 处理防抖\n  const de = debounceMap.get(messageClass);\n\n  if (de) {\n    const prevTask = prevDebounceTask.get(messageClass);\n    // 如果之前已经有在排队的任务，清除旧计时器并合并消息\n    if (prevTask) {\n      clearTimeout(prevTask.timer);\n      de.merge(message, prevTask.message);\n      const newTimer = setTimeout(() => {\n        prevDebounceTask.delete(messageClass);\n        next();\n      }, de.time);\n\n      prevDebounceTask.set(messageClass, {\n        message: message,\n        timer: newTimer,\n      });\n    } else {\n      // 第一次触发\n      const timer = setTimeout(() => {\n        prevDebounceTask.delete(messageClass);\n        next();\n      }, de.time);\n      prevDebounceTask.set(messageClass, { message, timer });\n    }\n    return; // 拦截当前消息，不立即向下执行\n  }\n  // 处理节流\n  const th = throttleMap.get(messageClass);\n  if (th) {\n    const now = Date.now();\n    const lastTime = prevThTime.get(messageClass) || 0;\n    if (now - lastTime >= th) {\n      prevThTime.set(messageClass, now);\n      next();\n    } else {\n      // 时间不够，直接丢弃该消息\n      return;\n    }\n    return;\n  }\n  next();\n}\n\nexport function activateDeTh(app: ViridApp) {\n  app.useMiddleware(middleWare);\n}\n","import { type ViridApp } from \"@virid/core\";\nimport { activateAsyncQueue } from \"./async\";\nimport { activateDeTh } from \"./deth\";\nexport * from \"./async\";\nexport * from \"./deth\";\n\nexport function activateMessages(app: ViridApp) {\n  activateAsyncQueue(app);\n  activateDeTh(app);\n}\n","/*\n * Copyright (c) 2026-present Ailrid.\n * Licensed under the Apache License, Version 2.0.\n * Project: Virid Std\n */\n\nimport { type ViridApp } from \"@virid/core\";\nimport { activateUtils } from \"./utils\";\nimport { activateMessages } from \"./messages\";\nlet activeApp: ViridApp | null = null;\n\n/**\n * 激活真正的 App 实例\n */\nexport function activateApp(app: ViridApp) {\n  activateUtils(app);\n  activateMessages(app);\n  activeApp = app;\n}\n\n/**\n * viridApp 代理\n */\nexport const viridApp: ViridApp = new Proxy({} as ViridApp, {\n  get(_, prop: keyof ViridApp) {\n    return (...args: any[]) => {\n      if (!activeApp) {\n        console.warn(\n          `[Virid Std] App method \"${String(prop)}\" called before initialization.`,\n        );\n\n        if (prop === \"register\") {\n          return () => {\n            console.warn(\n              \"[Virid Std] Cleanup ignored: source listener was never registered.\",\n            );\n          };\n        }\n        return undefined;\n      }\n      const targetMethod = activeApp[prop];\n      if (typeof targetMethod === \"function\") {\n        return Reflect.apply(targetMethod, activeApp, args);\n      }\n    };\n  },\n});\n","/*\n * Copyright (c) 2026-present Ailrid\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n *\n * Description: The virid standard library provides commonly used features in development.\n */\nimport { ViridPlugin, type ViridApp } from \"@virid/core\";\nexport * from \"./utils\";\nexport * from \"./messages\";\nimport { activateApp } from \"./app\";\nexport const StdPlugin: ViridPlugin = {\n  name: \"@virid/std\",\n  install(app: ViridApp, _options) {\n    activateApp(app);\n  },\n};\n"],"mappings":"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","names":["tickTaskQueue","afterTickHook","length","task","nextTick","push","activateNextTick","app","onAfterTick","EventMessage","MessageWriter","executeGroupMap","Map","messageKeyMap","keyMessageMap","callBackMap","clearGroup","id","message","get","delete","afterExecuteHook","_hookContext","success","key","executeGroup","length","resolve","shift","MessageWriter","error","Error","name","messages","has","Promise","executeChain","set","forEach","index","__name","write","push","resolver","promise","res","activateGroupMessages","app","onAfterExecute","EventMessage","activateUtils","app","activateNextTick","activateGroupMessages","EventMessage","asyncMessageMap","Map","asyncMessageQueue","AsyncQueue","key","target","set","middleWare","message","next","get","EventMessage","currentQueue","push","length","afterExecuteHook","_hookContext","at","shift","activateAsyncQueue","app","useMiddleware","onAfterExecute","debounceMap","Map","prevDebounceTask","throttleMap","prevThTime","Debounce","time","merge","target","set","Throttle","middleWare","message","next","messageClass","de","get","prevTask","clearTimeout","timer","newTimer","setTimeout","delete","th","now","Date","lastTime","activateDeTh","app","useMiddleware","activateMessages","app","activateAsyncQueue","activateDeTh","activeApp","activateApp","app","activateUtils","activateMessages","viridApp","Proxy","get","_","prop","args","console","warn","String","targetMethod","Reflect","apply","StdPlugin","name","install","app","_options","activateApp"]}

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@virid/std",
+  "type": "module",
+  "version": "0.0.1",
+  "description": "The virid standard library provides commonly used features in development",
+  "author": "Ailrid",
+  "license": "Apache 2.0",
+  "keywords": [
+    "virid",
+    "std"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Ailrid/virid.git"
+  },
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "dependencies": {},
+  "peerDependencies": {
+    "@virid/core": "0.2.5"
+  },
+  "scripts": {
+    "build": "tsup --config tsup.config.ts",
+    "dev": "tsup --config tsup.config.ts --watch",
+    "typecheck": "tsc --noEmit"
+  }
+}