@virid/std 0.0.1 → 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.
- package/README.md +46 -35
- package/README.zh.md +35 -46
- package/dist/index.cjs +2 -2
- package/dist/index.cjs.map +1 -1
- package/dist/index.d.cts +8 -5
- package/dist/index.d.ts +8 -5
- package/dist/index.js +2 -2
- package/dist/index.js.map +1 -1
- package/package.json +2 -2
package/README.md
CHANGED
|
@@ -1,8 +1,8 @@
|
|
|
1
1
|
# @virid/std
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
**@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.
|
|
4
4
|
|
|
5
|
-
|
|
5
|
+
### 🔌 Enabling the Plugin
|
|
6
6
|
|
|
7
7
|
```ts
|
|
8
8
|
import { createVirid, Component, System, EventMessage } from "@virid/core";
|
|
@@ -11,12 +11,12 @@ import { nextTick, StdPlugin } from "@virid/std";
|
|
|
11
11
|
const app = createVirid().use(StdPlugin, {});
|
|
12
12
|
```
|
|
13
13
|
|
|
14
|
-
## 🛠️ @virid/std
|
|
14
|
+
## 🛠️ @virid/std Core API Overview
|
|
15
15
|
|
|
16
|
-
### nextTick
|
|
16
|
+
### `nextTick`
|
|
17
17
|
|
|
18
|
-
-
|
|
19
|
-
-
|
|
18
|
+
- **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.
|
|
19
|
+
- **Example**:
|
|
20
20
|
|
|
21
21
|
```ts
|
|
22
22
|
nextTick(() => {
|
|
@@ -26,63 +26,74 @@ nextTick(() => {
|
|
|
26
26
|
});
|
|
27
27
|
```
|
|
28
28
|
|
|
29
|
-
|
|
29
|
+
------
|
|
30
30
|
|
|
31
|
-
|
|
32
|
-
|
|
31
|
+
### `@AsyncQueue(key: string)`
|
|
32
|
+
|
|
33
|
+
- **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.
|
|
34
|
+
- **Example**:
|
|
35
|
+
|
|
36
|
+
TypeScript
|
|
33
37
|
|
|
34
38
|
```ts
|
|
35
39
|
@AsyncQueue("increase")
|
|
36
40
|
class IncreaseAMessage extends EventMessage {}
|
|
41
|
+
|
|
37
42
|
@AsyncQueue("increase")
|
|
38
43
|
class IncreaseBMessage extends EventMessage {}
|
|
44
|
+
|
|
39
45
|
@AsyncQueue("decrease")
|
|
40
46
|
class DecreaseMessage extends EventMessage {}
|
|
41
47
|
|
|
42
|
-
//
|
|
43
|
-
//
|
|
44
|
-
//
|
|
48
|
+
// Messages sent in the following order:
|
|
49
|
+
// Because IncreaseAMessage and IncreaseBMessage share the same key,
|
|
50
|
+
// they will execute sequentially even if they contain async operations.
|
|
45
51
|
IncreaseAMessage.send();
|
|
46
52
|
IncreaseBMessage.send();
|
|
47
53
|
IncreaseAMessage.send();
|
|
48
|
-
|
|
49
|
-
//
|
|
50
|
-
//
|
|
54
|
+
|
|
55
|
+
// Since DecreaseMessage has a different key, it does not wait for the above.
|
|
56
|
+
// However, the three DecreaseMessages below will execute in their own sequence.
|
|
51
57
|
DecreaseMessage.send();
|
|
52
58
|
DecreaseMessage.send();
|
|
53
59
|
DecreaseMessage.send();
|
|
54
60
|
```
|
|
55
61
|
|
|
56
|
-
|
|
62
|
+
------
|
|
63
|
+
|
|
64
|
+
### **`executeGroup`**
|
|
57
65
|
|
|
58
|
-
-
|
|
59
|
-
-
|
|
66
|
+
- **Function**: A collection of messages that executes a group in strict sequential order. If an error occurs during execution, subsequent logic is cancelled.
|
|
67
|
+
- **Example**:
|
|
60
68
|
|
|
61
69
|
```ts
|
|
62
|
-
const
|
|
63
|
-
[
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
],
|
|
69
|
-
"first"
|
|
70
|
+
const success = await executeGroup(
|
|
71
|
+
[
|
|
72
|
+
new IncreaseAMessage(),
|
|
73
|
+
new IncreaseBMessage(),
|
|
74
|
+
new IncreaseAMessage(),
|
|
75
|
+
new DecreaseMessage(),
|
|
76
|
+
],
|
|
77
|
+
"first"
|
|
70
78
|
);
|
|
71
|
-
|
|
72
|
-
|
|
79
|
+
|
|
80
|
+
if (success) {
|
|
81
|
+
console.log("[ExecuteGroup] Success");
|
|
73
82
|
} else {
|
|
74
|
-
console.log("[ExecuteGroup] Failed");
|
|
83
|
+
console.log("[ExecuteGroup] Failed");
|
|
75
84
|
}
|
|
76
85
|
```
|
|
77
86
|
|
|
78
|
-
|
|
87
|
+
------
|
|
88
|
+
|
|
89
|
+
### `@Debounce()` / `@Throttle()`
|
|
79
90
|
|
|
80
|
-
-
|
|
81
|
-
-
|
|
91
|
+
- **Function**: Out-of-the-box support for debouncing and throttling. Can be implemented with a single line of code.
|
|
92
|
+
- **Example**:
|
|
82
93
|
|
|
83
94
|
```ts
|
|
84
|
-
// 100ms
|
|
85
|
-
//
|
|
95
|
+
// 100ms Debounce: Executes only once after 100ms of inactivity.
|
|
96
|
+
// The second parameter is used to aggregate messages.
|
|
86
97
|
@Debounce(100, (current, next) => {
|
|
87
98
|
current.val += next.val;
|
|
88
99
|
})
|
|
@@ -92,7 +103,7 @@ class SetTimerAMessage extends EventMessage {
|
|
|
92
103
|
}
|
|
93
104
|
}
|
|
94
105
|
|
|
95
|
-
//
|
|
106
|
+
// 500ms Throttle: Limits execution to once every 500ms.
|
|
96
107
|
@Throttle(500)
|
|
97
108
|
class IncreaseBMessage extends EventMessage {}
|
|
98
109
|
```
|
package/README.zh.md
CHANGED
|
@@ -1,8 +1,8 @@
|
|
|
1
1
|
# @virid/std
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
`@virid/std` 是 `@virid/core`的官方标准库,负责提供一组开箱即用的实用消息控制流操作。提供了原生的异步流、消息组、防抖节流等支持。
|
|
4
4
|
|
|
5
|
-
|
|
5
|
+
## 🔌启用插件
|
|
6
6
|
|
|
7
7
|
```ts
|
|
8
8
|
import { createVirid, Component, System, EventMessage } from "@virid/core";
|
|
@@ -11,12 +11,12 @@ import { nextTick, StdPlugin } from "@virid/std";
|
|
|
11
11
|
const app = createVirid().use(StdPlugin, {});
|
|
12
12
|
```
|
|
13
13
|
|
|
14
|
-
## 🛠️ @virid/std
|
|
14
|
+
## 🛠️ @virid/std 核心 API 概览
|
|
15
15
|
|
|
16
|
-
###
|
|
16
|
+
### nextTick
|
|
17
17
|
|
|
18
|
-
-
|
|
19
|
-
-
|
|
18
|
+
- **功能**:类似于`vue`中的`nextTick`,但该`Tick`指的是一个`virid`的宏观`Tick`,因此,当执行时该`Tick`内的所有同步`System`已经全部执行完毕,对于异步控制,则需要使用`@AsyncQueue`装饰器
|
|
19
|
+
- **示例:**
|
|
20
20
|
|
|
21
21
|
```ts
|
|
22
22
|
nextTick(() => {
|
|
@@ -26,74 +26,63 @@ nextTick(() => {
|
|
|
26
26
|
});
|
|
27
27
|
```
|
|
28
28
|
|
|
29
|
-
|
|
29
|
+
### `@AsyncQueue()`
|
|
30
30
|
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
- **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.
|
|
34
|
-
- **Example**:
|
|
35
|
-
|
|
36
|
-
TypeScript
|
|
31
|
+
- **功能**:`@AsyncQueue()`提供了一个开箱即用的异步消息控制,该装饰器接受一个参数key,对于key相同的message,将严格按照先后顺序执行,而不会出现异步竟态问题。
|
|
32
|
+
- **示例:**
|
|
37
33
|
|
|
38
34
|
```ts
|
|
39
35
|
@AsyncQueue("increase")
|
|
40
36
|
class IncreaseAMessage extends EventMessage {}
|
|
41
|
-
|
|
42
37
|
@AsyncQueue("increase")
|
|
43
38
|
class IncreaseBMessage extends EventMessage {}
|
|
44
|
-
|
|
45
39
|
@AsyncQueue("decrease")
|
|
46
40
|
class DecreaseMessage extends EventMessage {}
|
|
47
41
|
|
|
48
|
-
//
|
|
49
|
-
//
|
|
50
|
-
//
|
|
42
|
+
// 按以下顺序发送消息
|
|
43
|
+
// 由于IncreaseMessage和IncreaseBMessage的key是相同的,
|
|
44
|
+
// 即使存在异步操作,以下三条消息也必须按顺序执行
|
|
51
45
|
IncreaseAMessage.send();
|
|
52
46
|
IncreaseBMessage.send();
|
|
53
47
|
IncreaseAMessage.send();
|
|
54
|
-
|
|
55
|
-
//
|
|
56
|
-
//
|
|
48
|
+
// 由于DecaseMessage和其他消息之间的key不同
|
|
49
|
+
// DecaseMessage不会等待上述消息
|
|
50
|
+
// 但是,以下三条消息将按顺序执行
|
|
57
51
|
DecreaseMessage.send();
|
|
58
52
|
DecreaseMessage.send();
|
|
59
53
|
DecreaseMessage.send();
|
|
60
54
|
```
|
|
61
55
|
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
### **`executeGroup`**
|
|
56
|
+
### `executeGroup`
|
|
65
57
|
|
|
66
|
-
-
|
|
67
|
-
-
|
|
58
|
+
- **功能**:`executeGroup`是一组消息的集合,将一组消息严格按照先后顺序一次性执行,并且当途中出错时取消后续逻辑。
|
|
59
|
+
- **示例:**
|
|
68
60
|
|
|
69
61
|
```ts
|
|
70
|
-
const
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
|
|
62
|
+
const a = await executeGroup(
|
|
63
|
+
[
|
|
64
|
+
new IncreaseAMessage(),
|
|
65
|
+
new IncreaseBMessage(),
|
|
66
|
+
new IncreaseAMessage(),
|
|
67
|
+
new DecreaseMessage(),
|
|
68
|
+
],
|
|
69
|
+
"first",
|
|
78
70
|
);
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
console.log("[ExecuteGroup] Success");
|
|
71
|
+
if (a) {
|
|
72
|
+
console.log("[ExecuteGroup] Success");
|
|
82
73
|
} else {
|
|
83
|
-
|
|
74
|
+
console.log("[ExecuteGroup] Failed");
|
|
84
75
|
}
|
|
85
76
|
```
|
|
86
77
|
|
|
87
|
-
|
|
88
|
-
|
|
89
|
-
### `@Debounce()` / `@Throttle()`
|
|
78
|
+
### `@Debounce()/@Throttle`
|
|
90
79
|
|
|
91
|
-
-
|
|
92
|
-
-
|
|
80
|
+
- **功能**:开箱即用的防抖与节流支持。只需要一行代码即可实现。
|
|
81
|
+
- **示例:**
|
|
93
82
|
|
|
94
83
|
```ts
|
|
95
|
-
// 100ms
|
|
96
|
-
//
|
|
84
|
+
// 100ms防抖:停止触发100ms后只执行一次
|
|
85
|
+
// 后一个参数用于聚合消息
|
|
97
86
|
@Debounce(100, (current, next) => {
|
|
98
87
|
current.val += next.val;
|
|
99
88
|
})
|
|
@@ -103,7 +92,7 @@ class SetTimerAMessage extends EventMessage {
|
|
|
103
92
|
}
|
|
104
93
|
}
|
|
105
94
|
|
|
106
|
-
//
|
|
95
|
+
// 100ms节流:100ms内只允许一次触发
|
|
107
96
|
@Throttle(500)
|
|
108
97
|
class IncreaseBMessage extends EventMessage {}
|
|
109
98
|
```
|
package/dist/index.cjs
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
/**
|
|
2
|
-
* @virid/std v0.0
|
|
2
|
+
* @virid/std v0.3.0
|
|
3
3
|
* The virid standard library provides commonly used features in development
|
|
4
4
|
*/
|
|
5
|
-
var
|
|
5
|
+
var u=Object.defineProperty;var $=Object.getOwnPropertyDescriptor;var N=Object.getOwnPropertyNames;var _=Object.prototype.hasOwnProperty;var z=(e,t,o)=>t in e?u(e,t,{enumerable:!0,configurable:!0,writable:!0,value:o}):e[t]=o;var r=(e,t)=>u(e,"name",{value:t,configurable:!0});var B=(e,t)=>{for(var o in t)u(e,o,{get:t[o],enumerable:!0})},F=(e,t,o,n)=>{if(t&&typeof t=="object"||typeof t=="function")for(let c of N(t))!_.call(e,c)&&c!==o&&u(e,c,{get:()=>t[c],enumerable:!(n=$(t,c))||n.enumerable});return e};var I=e=>F(u({},"__esModule",{value:!0}),e);var D=(e,t,o)=>z(e,typeof t!="symbol"?t+"":t,o);var X={};B(X,{AsyncQueue:()=>L,Debounce:()=>R,StdPlugin:()=>G,Throttle:()=>S,activateAsyncQueue:()=>d,activateDeTh:()=>E,activateGroupMessages:()=>v,activateMessages:()=>A,activateNextTick:()=>M,activateUtils:()=>k,executeGroup:()=>J,nextTick:()=>j});module.exports=I(X);var p=[];function K(){if(p.length!=0){for(let e of p)e();p=[]}}r(K,"afterTickHook");function j(e){p.push(e)}r(j,"nextTick");function M(e){e.onAfterTick(K)}r(M,"activateNextTick");var a=require("@virid/core");var l=new Map,h=new Map,g=new Map,m=new Map;function b(e){for(let t of g.get(e))h.delete(t);g.delete(e),l.delete(e),m.delete(e)}r(b,"clearGroup");function q(e,t,o){let n=h.get(e);if(n){let c=l.get(n);if(o){if(c.length>0){let{resolve:s}=c.shift();s()}c.length==0&&(m.get(n)(!0),b(n))}else m.get(n)(!1),b(n),a.MessageWriter.error(new Error(`[ExecuteGroup] Queue Execution Failed: Due to an error in the System execution triggered by ${e.constructor.name}, the message group '${n}' has been cancelled`))}}r(q,"afterExecuteHook");async function J(e,t="default"){if(l.has(t))return a.MessageWriter.error(new Error(`[ExecuteGroup] Unavailable ID: The id '${t}' not yet executed`)),Promise.resolve(!1);let o=[];g.set(t,e),e.forEach((s,i)=>{let x;i==e.length-1?x=r(()=>{},"resolve"):x=r(()=>a.MessageWriter.write(e[i+1]),"resolve"),o.push({message:s,resolve:x}),h.set(s,t)});let n,c=new Promise(s=>{n=s});return m.set(t,n),l.set(t,o),a.MessageWriter.write(e[0]),c}r(J,"executeGroup");function v(e){e.onAfterExecute(a.EventMessage,q)}r(v,"activateGroupMessages");function k(e){M(e),v(e)}r(k,"activateUtils");var T=require("@virid/core");var y=new Map,w=new Map;function L(e="default",t=1){return function(o){y.set(o,{key:e,maxSize:t})}}r(L,"AsyncQueue");function O(e,t){let o=y.get(e.constructor);if(o&&e instanceof T.EventMessage){let n=w.get(o.key)||[];if(n.length>=o.maxSize)return;n.push({message:e,next:t}),w.set(o.key,n),n.length==1&&t()}else t()}r(O,"middleWare");function P(e,t){let o=y.get(e.constructor);if(o){let n=w.get(o.key);n.at(0)?.message===e&&(n.shift(),n.at(0)?.next())}}r(P,"afterExecuteHook");function d(e){e.useMiddleware(O),e.onAfterExecute(T.EventMessage,P)}r(d,"activateAsyncQueue");var H=new Map,f=new Map,U=new Map,C=new Map;function R(e=100,t=()=>{}){return function(o){H.set(o,{time:e,merge:t})}}r(R,"Debounce");function S(e=100){return function(t){U.set(t,e)}}r(S,"Throttle");function V(e,t){let o=e.constructor,n=H.get(o);if(n){let s=f.get(o);if(s){clearTimeout(s.timer),n.merge(e,s.message);let i=setTimeout(()=>{f.delete(o),t()},n.time);f.set(o,{message:e,timer:i})}else{let i=setTimeout(()=>{f.delete(o),t()},n.time);f.set(o,{message:e,timer:i})}return}let c=U.get(o);if(c){let s=Date.now(),i=C.get(o)||0;if(s-i>=c)C.set(o,s),t();else return;return}t()}r(V,"middleWare");function E(e){e.useMiddleware(V)}r(E,"activateDeTh");function A(e){d(e),E(e)}r(A,"activateMessages");function W(e){k(e),A(e)}r(W,"activateApp");var Q=class Q{constructor(){D(this,"name","@virid/std")}install(t,o){W(t)}};r(Q,"StdPlugin");var G=Q;0&&(module.exports={AsyncQueue,Debounce,StdPlugin,Throttle,activateAsyncQueue,activateDeTh,activateGroupMessages,activateMessages,activateNextTick,activateUtils,executeGroup,nextTick});
|
|
6
6
|
//# sourceMappingURL=index.cjs.map
|
package/dist/index.cjs.map
CHANGED
|
@@ -1 +1 @@
|
|
|
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"]}
|
|
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\";\n\nexport class StdPlugin implements ViridPlugin<null> {\n name = \"@virid/std\";\n install(app: ViridApp, _options: null) {\n activateApp(app);\n }\n}\n","import { type ViridApp } from \"@virid/core\";\n\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// Execution team columns cached in each 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 // Only when the current task is successfully executed, will we proceed to the next one\n if (executeGroup.length > 0) {\n const { resolve } = executeGroup.shift()!;\n resolve();\n }\n if (executeGroup.length == 0) {\n callBackMap.get(key)!(true);\n clearGroup(key);\n }\n } else {\n callBackMap.get(key)!(false);\n clearGroup(key);\n // If there is an error, cancel the execution queue directly\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 // Construct a string of promises and store the resolutions, with each resolution initiating the next 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 // Register this execution group\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 // Immediately trigger the first one\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}\ninterface AsyncMessageKey {\n key: string;\n maxSize: number;\n}\n\n// The correspondence between messages and keys\nconst asyncMessageMap = new Map<Newable<EventMessage>, AsyncMessageKey>();\n// The message sequence cached in each key\nconst asyncMessageQueue = new Map<string, QueueContext[]>();\n\n/**\n * Register asynchronous queue messages\n */\nexport function AsyncQueue(key: string = \"default\", maxSize: number = 1) {\n return function (target: Newable<EventMessage>) {\n asyncMessageMap.set(target, { key, maxSize });\n };\n}\n\n/**\n * Intercept all asynchronous messages\n */\nfunction middleWare(message: BaseMessage, next: () => void): void {\n const item = asyncMessageMap.get(\n message.constructor as Newable<EventMessage>,\n );\n if (item && message instanceof EventMessage) {\n const currentQueue = asyncMessageQueue.get(item.key) || [];\n // check the maximum length\n if (currentQueue.length >= item.maxSize) return;\n currentQueue.push({ message, next });\n asyncMessageQueue.set(item.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 // Is the current message to be sorted\n const item = asyncMessageMap.get(\n message.constructor as Newable<EventMessage>,\n );\n if (item) {\n // If this message is exactly the message recorded at the head of the queue\n // So immediately send this one, and then deliver another follow-up message\n const currentQueue = asyncMessageQueue.get(item.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// Store the current anti shake task corresponding to each message class (including merged message content and timer)\nconst prevDebounceTask = new Map<Newable<BaseMessage>, DebounceTask>();\n\nconst throttleMap = new Map<Newable<BaseMessage>, number>();\n// Store the timestamp of the last actual execution of each message class\nconst prevThTime = new Map<Newable<BaseMessage>, number>();\n\n/**\n * Anti shake decorator: Messages triggered continuously will be merged until they stop triggering for a period of time before execution\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 * Throttle decorator: Limit the frequency of message triggering\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 // First trigger\n const timer = setTimeout(() => {\n prevDebounceTask.delete(messageClass);\n next();\n }, de.time);\n prevDebounceTask.set(messageClass, { message, timer });\n }\n return; // Intercept the current message without immediately executing downwards\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 // Time is not enough, discard the message directly\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\";\n\nexport function activateApp(app: ViridApp) {\n activateUtils(app);\n activateMessages(app);\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","maxSize","target","set","middleWare","message","next","item","get","EventMessage","currentQueue","length","push","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","activateApp","app","activateUtils","activateMessages","StdPlugin","name","install","app","_options","activateApp","_StdPlugin"]}
|
package/dist/index.d.cts
CHANGED
|
@@ -9,23 +9,26 @@ declare function activateNextTick(app: ViridApp): void;
|
|
|
9
9
|
declare function activateUtils(app: ViridApp): void;
|
|
10
10
|
|
|
11
11
|
/**
|
|
12
|
-
*
|
|
12
|
+
* Register asynchronous queue messages
|
|
13
13
|
*/
|
|
14
|
-
declare function AsyncQueue(key?: string): (target: Newable<EventMessage>) => void;
|
|
14
|
+
declare function AsyncQueue(key?: string, maxSize?: number): (target: Newable<EventMessage>) => void;
|
|
15
15
|
declare function activateAsyncQueue(app: ViridApp): void;
|
|
16
16
|
|
|
17
17
|
/**
|
|
18
|
-
*
|
|
18
|
+
* Anti shake decorator: Messages triggered continuously will be merged until they stop triggering for a period of time before execution
|
|
19
19
|
*/
|
|
20
20
|
declare function Debounce<T extends BaseMessage>(time?: number, merge?: (currentMessage: T, nextMessage: T) => void): (target: Newable<T>) => void;
|
|
21
21
|
/**
|
|
22
|
-
*
|
|
22
|
+
* Throttle decorator: Limit the frequency of message triggering
|
|
23
23
|
*/
|
|
24
24
|
declare function Throttle(time?: number): (target: Newable<BaseMessage>) => void;
|
|
25
25
|
declare function activateDeTh(app: ViridApp): void;
|
|
26
26
|
|
|
27
27
|
declare function activateMessages(app: ViridApp): void;
|
|
28
28
|
|
|
29
|
-
declare
|
|
29
|
+
declare class StdPlugin implements ViridPlugin<null> {
|
|
30
|
+
name: string;
|
|
31
|
+
install(app: ViridApp, _options: null): void;
|
|
32
|
+
}
|
|
30
33
|
|
|
31
34
|
export { AsyncQueue, Debounce, StdPlugin, Throttle, activateAsyncQueue, activateDeTh, activateGroupMessages, activateMessages, activateNextTick, activateUtils, executeGroup, nextTick };
|
package/dist/index.d.ts
CHANGED
|
@@ -9,23 +9,26 @@ declare function activateNextTick(app: ViridApp): void;
|
|
|
9
9
|
declare function activateUtils(app: ViridApp): void;
|
|
10
10
|
|
|
11
11
|
/**
|
|
12
|
-
*
|
|
12
|
+
* Register asynchronous queue messages
|
|
13
13
|
*/
|
|
14
|
-
declare function AsyncQueue(key?: string): (target: Newable<EventMessage>) => void;
|
|
14
|
+
declare function AsyncQueue(key?: string, maxSize?: number): (target: Newable<EventMessage>) => void;
|
|
15
15
|
declare function activateAsyncQueue(app: ViridApp): void;
|
|
16
16
|
|
|
17
17
|
/**
|
|
18
|
-
*
|
|
18
|
+
* Anti shake decorator: Messages triggered continuously will be merged until they stop triggering for a period of time before execution
|
|
19
19
|
*/
|
|
20
20
|
declare function Debounce<T extends BaseMessage>(time?: number, merge?: (currentMessage: T, nextMessage: T) => void): (target: Newable<T>) => void;
|
|
21
21
|
/**
|
|
22
|
-
*
|
|
22
|
+
* Throttle decorator: Limit the frequency of message triggering
|
|
23
23
|
*/
|
|
24
24
|
declare function Throttle(time?: number): (target: Newable<BaseMessage>) => void;
|
|
25
25
|
declare function activateDeTh(app: ViridApp): void;
|
|
26
26
|
|
|
27
27
|
declare function activateMessages(app: ViridApp): void;
|
|
28
28
|
|
|
29
|
-
declare
|
|
29
|
+
declare class StdPlugin implements ViridPlugin<null> {
|
|
30
|
+
name: string;
|
|
31
|
+
install(app: ViridApp, _options: null): void;
|
|
32
|
+
}
|
|
30
33
|
|
|
31
34
|
export { AsyncQueue, Debounce, StdPlugin, Throttle, activateAsyncQueue, activateDeTh, activateGroupMessages, activateMessages, activateNextTick, activateUtils, executeGroup, nextTick };
|
package/dist/index.js
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
/**
|
|
2
|
-
* @virid/std v0.0
|
|
2
|
+
* @virid/std v0.3.0
|
|
3
3
|
* The virid standard library provides commonly used features in development
|
|
4
4
|
*/
|
|
5
|
-
var
|
|
5
|
+
var k=Object.defineProperty;var $=(e,t,o)=>t in e?k(e,t,{enumerable:!0,configurable:!0,writable:!0,value:o}):e[t]=o;var r=(e,t)=>k(e,"name",{value:t,configurable:!0});var w=(e,t,o)=>$(e,typeof t!="symbol"?t+"":t,o);var u=[];function N(){if(u.length!=0){for(let e of u)e();u=[]}}r(N,"afterTickHook");function j(e){u.push(e)}r(j,"nextTick");function T(e){e.onAfterTick(N)}r(T,"activateNextTick");import{EventMessage as _,MessageWriter as f}from"@virid/core";var p=new Map,M=new Map,x=new Map,l=new Map;function y(e){for(let t of x.get(e))M.delete(t);x.delete(e),p.delete(e),l.delete(e)}r(y,"clearGroup");function z(e,t,o){let n=M.get(e);if(n){let s=p.get(n);if(o){if(s.length>0){let{resolve:c}=s.shift();c()}s.length==0&&(l.get(n)(!0),y(n))}else l.get(n)(!1),y(n),f.error(new Error(`[ExecuteGroup] Queue Execution Failed: Due to an error in the System execution triggered by ${e.constructor.name}, the message group '${n}' has been cancelled`))}}r(z,"afterExecuteHook");async function O(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 o=[];x.set(t,e),e.forEach((c,i)=>{let m;i==e.length-1?m=r(()=>{},"resolve"):m=r(()=>f.write(e[i+1]),"resolve"),o.push({message:c,resolve:m}),M.set(c,t)});let n,s=new Promise(c=>{n=c});return l.set(t,n),p.set(t,o),f.write(e[0]),s}r(O,"executeGroup");function d(e){e.onAfterExecute(_,z)}r(d,"activateGroupMessages");function E(e){T(e),d(e)}r(E,"activateUtils");import{EventMessage as A}from"@virid/core";var h=new Map,g=new Map;function oe(e="default",t=1){return function(o){h.set(o,{key:e,maxSize:t})}}r(oe,"AsyncQueue");function B(e,t){let o=h.get(e.constructor);if(o&&e instanceof A){let n=g.get(o.key)||[];if(n.length>=o.maxSize)return;n.push({message:e,next:t}),g.set(o.key,n),n.length==1&&t()}else t()}r(B,"middleWare");function F(e,t){let o=h.get(e.constructor);if(o){let n=g.get(o.key);n.at(0)?.message===e&&(n.shift(),n.at(0)?.next())}}r(F,"afterExecuteHook");function G(e){e.useMiddleware(B),e.onAfterExecute(A,F)}r(G,"activateAsyncQueue");var D=new Map,a=new Map,b=new Map,Q=new Map;function ce(e=100,t=()=>{}){return function(o){D.set(o,{time:e,merge:t})}}r(ce,"Debounce");function se(e=100){return function(t){b.set(t,e)}}r(se,"Throttle");function I(e,t){let o=e.constructor,n=D.get(o);if(n){let c=a.get(o);if(c){clearTimeout(c.timer),n.merge(e,c.message);let i=setTimeout(()=>{a.delete(o),t()},n.time);a.set(o,{message:e,timer:i})}else{let i=setTimeout(()=>{a.delete(o),t()},n.time);a.set(o,{message:e,timer:i})}return}let s=b.get(o);if(s){let c=Date.now(),i=Q.get(o)||0;if(c-i>=s)Q.set(o,c),t();else return;return}t()}r(I,"middleWare");function C(e){e.useMiddleware(I)}r(C,"activateDeTh");function H(e){G(e),C(e)}r(H,"activateMessages");function U(e){E(e),H(e)}r(U,"activateApp");var v=class v{constructor(){w(this,"name","@virid/std")}install(t,o){U(t)}};r(v,"StdPlugin");var W=v;export{oe as AsyncQueue,ce as Debounce,W as StdPlugin,se as Throttle,G as activateAsyncQueue,C as activateDeTh,d as activateGroupMessages,H as activateMessages,T as activateNextTick,E as activateUtils,O as executeGroup,j as nextTick};
|
|
6
6
|
//# sourceMappingURL=index.js.map
|
package/dist/index.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
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"]}
|
|
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\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// Execution team columns cached in each 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 // Only when the current task is successfully executed, will we proceed to the next one\n if (executeGroup.length > 0) {\n const { resolve } = executeGroup.shift()!;\n resolve();\n }\n if (executeGroup.length == 0) {\n callBackMap.get(key)!(true);\n clearGroup(key);\n }\n } else {\n callBackMap.get(key)!(false);\n clearGroup(key);\n // If there is an error, cancel the execution queue directly\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 // Construct a string of promises and store the resolutions, with each resolution initiating the next 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 // Register this execution group\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 // Immediately trigger the first one\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}\ninterface AsyncMessageKey {\n key: string;\n maxSize: number;\n}\n\n// The correspondence between messages and keys\nconst asyncMessageMap = new Map<Newable<EventMessage>, AsyncMessageKey>();\n// The message sequence cached in each key\nconst asyncMessageQueue = new Map<string, QueueContext[]>();\n\n/**\n * Register asynchronous queue messages\n */\nexport function AsyncQueue(key: string = \"default\", maxSize: number = 1) {\n return function (target: Newable<EventMessage>) {\n asyncMessageMap.set(target, { key, maxSize });\n };\n}\n\n/**\n * Intercept all asynchronous messages\n */\nfunction middleWare(message: BaseMessage, next: () => void): void {\n const item = asyncMessageMap.get(\n message.constructor as Newable<EventMessage>,\n );\n if (item && message instanceof EventMessage) {\n const currentQueue = asyncMessageQueue.get(item.key) || [];\n // check the maximum length\n if (currentQueue.length >= item.maxSize) return;\n currentQueue.push({ message, next });\n asyncMessageQueue.set(item.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 // Is the current message to be sorted\n const item = asyncMessageMap.get(\n message.constructor as Newable<EventMessage>,\n );\n if (item) {\n // If this message is exactly the message recorded at the head of the queue\n // So immediately send this one, and then deliver another follow-up message\n const currentQueue = asyncMessageQueue.get(item.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// Store the current anti shake task corresponding to each message class (including merged message content and timer)\nconst prevDebounceTask = new Map<Newable<BaseMessage>, DebounceTask>();\n\nconst throttleMap = new Map<Newable<BaseMessage>, number>();\n// Store the timestamp of the last actual execution of each message class\nconst prevThTime = new Map<Newable<BaseMessage>, number>();\n\n/**\n * Anti shake decorator: Messages triggered continuously will be merged until they stop triggering for a period of time before execution\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 * Throttle decorator: Limit the frequency of message triggering\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 // First trigger\n const timer = setTimeout(() => {\n prevDebounceTask.delete(messageClass);\n next();\n }, de.time);\n prevDebounceTask.set(messageClass, { message, timer });\n }\n return; // Intercept the current message without immediately executing downwards\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 // Time is not enough, discard the message directly\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\";\n\nexport function activateApp(app: ViridApp) {\n activateUtils(app);\n activateMessages(app);\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\";\n\nexport class StdPlugin implements ViridPlugin<null> {\n name = \"@virid/std\";\n install(app: ViridApp, _options: null) {\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","maxSize","target","set","middleWare","message","next","item","get","EventMessage","currentQueue","length","push","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","activateApp","app","activateUtils","activateMessages","StdPlugin","name","install","app","_options","activateApp","_StdPlugin"]}
|
package/package.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@virid/std",
|
|
3
3
|
"type": "module",
|
|
4
|
-
"version": "0.0
|
|
4
|
+
"version": "0.3.0",
|
|
5
5
|
"description": "The virid standard library provides commonly used features in development",
|
|
6
6
|
"author": "Ailrid",
|
|
7
7
|
"license": "Apache 2.0",
|
|
@@ -32,7 +32,7 @@
|
|
|
32
32
|
},
|
|
33
33
|
"dependencies": {},
|
|
34
34
|
"peerDependencies": {
|
|
35
|
-
"@virid/core": "0.
|
|
35
|
+
"@virid/core": "0.3.0"
|
|
36
36
|
},
|
|
37
37
|
"scripts": {
|
|
38
38
|
"build": "tsup --config tsup.config.ts",
|