@virid/core 0.1.2 → 0.1.3
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 +43 -2
- package/README.zh.md +31 -2
- package/dist/index.cjs +14 -14
- package/dist/index.cjs.map +1 -1
- package/dist/index.d.cts +18 -6
- package/dist/index.d.ts +18 -6
- package/dist/index.js +14 -14
- package/dist/index.js.map +1 -1
- package/package.json +3 -2
package/README.md
CHANGED
|
@@ -286,7 +286,7 @@ app.onAfterTick((context) => {
|
|
|
286
286
|
|
|
287
287
|
------
|
|
288
288
|
|
|
289
|
-
### 🔬 Advanced
|
|
289
|
+
### 🔬 Advanced
|
|
290
290
|
|
|
291
291
|
#### **AtomicModifyMessage**
|
|
292
292
|
|
|
@@ -306,4 +306,45 @@ AtomicModifyMessage.send(
|
|
|
306
306
|
);
|
|
307
307
|
```
|
|
308
308
|
|
|
309
|
-
|
|
309
|
+
#### **DebounceMessage**
|
|
310
|
+
|
|
311
|
+
**Function:** Provides a framework-level native debouncing solution with built-in lifecycle management.
|
|
312
|
+
|
|
313
|
+
**Scenario:** When you need to throttle the frequency of message triggers or merge the data content of consecutive messages, this class offers an out-of-the-box mechanism to handle "intent evolution" without manual timer management.
|
|
314
|
+
|
|
315
|
+
**Example:**
|
|
316
|
+
|
|
317
|
+
```ts
|
|
318
|
+
// Derive your own message from the DebounceMessage class
|
|
319
|
+
class MoveMessage extends DebounceMessage {
|
|
320
|
+
readonly debounceTime = 100; // Set the debounce window to 100ms
|
|
321
|
+
|
|
322
|
+
constructor(
|
|
323
|
+
public x: number,
|
|
324
|
+
public y: number,
|
|
325
|
+
) {
|
|
326
|
+
super();
|
|
327
|
+
}
|
|
328
|
+
|
|
329
|
+
// This callback is triggered when debouncing occurs,
|
|
330
|
+
// providing the instance of the previously sent Message.
|
|
331
|
+
debounceCallback(previousMessage: MoveMessage) {
|
|
332
|
+
console.log(
|
|
333
|
+
`[Debounce] Merge displacement: Original(${previousMessage.x}, ${previousMessage.y}) -> New(${this.x}, ${this.y})`,
|
|
334
|
+
);
|
|
335
|
+
// Accumulate the state from the previous message
|
|
336
|
+
this.x += previousMessage.x;
|
|
337
|
+
this.y += previousMessage.y;
|
|
338
|
+
}
|
|
339
|
+
}
|
|
340
|
+
|
|
341
|
+
// Usage:
|
|
342
|
+
// Only the "evolved" message with a combined value will
|
|
343
|
+
// reach the System after the user stops sending for 100ms.
|
|
344
|
+
MoveMessage.send(10, 0);
|
|
345
|
+
```
|
|
346
|
+
|
|
347
|
+
|
|
348
|
+
|
|
349
|
+
|
|
350
|
+
|
package/README.zh.md
CHANGED
|
@@ -64,7 +64,7 @@ class CounterSystem {
|
|
|
64
64
|
|
|
65
65
|
### 4. 工业级健壮性
|
|
66
66
|
|
|
67
|
-
-
|
|
67
|
+
- **死循环熔断**：`Dispatcher` 内部设有 `internalDepth` 计数器。若逻辑链路产生超过 100 层的递归触发，系统将自动熔断并报错，防止环境假死。
|
|
68
68
|
- **执行优先级**：支持通过 `@System({ priority: number })` 明确多个系统处理同一消息时的先后顺序。
|
|
69
69
|
|
|
70
70
|
## 🛠️ @virid/core 核心 API 概览
|
|
@@ -258,7 +258,7 @@ app.onAfterTick((context) => {
|
|
|
258
258
|
|
|
259
259
|
------
|
|
260
260
|
|
|
261
|
-
## 🔬
|
|
261
|
+
## 🔬 进阶
|
|
262
262
|
|
|
263
263
|
#### `AtomicModifyMessage`
|
|
264
264
|
|
|
@@ -276,3 +276,32 @@ app.onAfterTick((context) => {
|
|
|
276
276
|
);
|
|
277
277
|
```
|
|
278
278
|
|
|
279
|
+
#### `DebounceMessage`
|
|
280
|
+
|
|
281
|
+
- **功能**：框架级原生防抖功能，提供简易的防抖触发和简单的防抖回调。
|
|
282
|
+
- **场景**：当你需要限制Message触发频率，或者需要融合前后两次Message的内容时使用，即可0行代码获得框架级原生支持。
|
|
283
|
+
- **示例**：
|
|
284
|
+
|
|
285
|
+
```ts
|
|
286
|
+
// 从DebounceMessage类型派生一个自己的消息
|
|
287
|
+
class MoveMessage extends DebounceMessage {
|
|
288
|
+
readonly debounceTime = 100; // 设置防抖时间为100ms
|
|
289
|
+
|
|
290
|
+
constructor(
|
|
291
|
+
public x: number,
|
|
292
|
+
public y: number,
|
|
293
|
+
) {
|
|
294
|
+
super();
|
|
295
|
+
}
|
|
296
|
+
|
|
297
|
+
// 当触发防抖时，该回调会被调用，并传入上次发送的Message实例
|
|
298
|
+
debounceCallback(previousMessage: MoveMessage) {
|
|
299
|
+
console.log(
|
|
300
|
+
`[Debounce] Merge displacement: Original(${previousMessage.x}, ${previousMessage.y}) -> New(${this.x}, ${this.y})`,
|
|
301
|
+
);
|
|
302
|
+
this.x += previousMessage.x;
|
|
303
|
+
this.y += previousMessage.y;
|
|
304
|
+
}
|
|
305
|
+
}
|
|
306
|
+
```
|
|
307
|
+
|
package/dist/index.cjs
CHANGED
|
@@ -1,32 +1,32 @@
|
|
|
1
1
|
/**
|
|
2
|
-
* @virid/core v0.1.
|
|
2
|
+
* @virid/core v0.1.3
|
|
3
3
|
* A lightweight and powerful message core built using dependency injection and CCS concepts
|
|
4
4
|
*/
|
|
5
|
-
var C=Object.defineProperty;var
|
|
5
|
+
var C=Object.defineProperty;var ge=Object.getOwnPropertyDescriptor;var me=Object.getOwnPropertyNames;var ye=Object.prototype.hasOwnProperty;var xe=(s,e,t)=>e in s?C(s,e,{enumerable:!0,configurable:!0,writable:!0,value:t}):s[e]=t;var o=(s,e)=>C(s,"name",{value:e,configurable:!0});var be=(s,e)=>{for(var t in e)C(s,t,{get:e[t],enumerable:!0})},ve=(s,e,t,r)=>{if(e&&typeof e=="object"||typeof e=="function")for(let n of me(e))!ye.call(s,n)&&n!==t&&C(s,n,{get:()=>e[n],enumerable:!(r=ge(e,n))||r.enumerable});return s};var Se=s=>ve(C({},"__esModule",{value:!0}),s);var i=(s,e,t)=>xe(s,typeof e!="symbol"?e+"":e,t);var De={};be(De,{AtomicModifyMessage:()=>k,BaseMessage:()=>x,Component:()=>Re,Controller:()=>He,DebounceMessage:()=>W,ErrorMessage:()=>b,EventMessage:()=>p,InfoMessage:()=>S,Message:()=>$e,MessageInternal:()=>M,MessageRegistry:()=>E,MessageWriter:()=>a,Observer:()=>Ce,Safe:()=>Te,SingleMessage:()=>y,System:()=>Ae,VIRID_METADATA:()=>g,WarnMessage:()=>v,activateInstance:()=>X,bindObservers:()=>R,createVirid:()=>Ie,handleResult:()=>A,publisher:()=>le});module.exports=Se(De);var F=class F{static send(...e){a.write(this,...e)}};o(F,"BaseMessage");var x=F,Q=class Q extends x{constructor(){super();i(this,"__kind","SingleMessage")}};o(Q,"SingleMessage");var y=Q,z=class z extends x{constructor(){super();i(this,"__kind","EventMessage")}};o(z,"EventMessage");var p=z,U=class U extends p{constructor(t,r){super();i(this,"error");i(this,"context");this.error=t,this.context=r}};o(U,"ErrorMessage");var b=U,J=class J extends p{constructor(t){super();i(this,"context");this.context=t}};o(J,"WarnMessage");var v=J,Y=class Y extends p{constructor(t){super();i(this,"context");this.context=t}};o(Y,"InfoMessage");var S=Y,q=class q extends p{constructor(t,r,n){super();i(this,"ComponentClass");i(this,"recipe");i(this,"label");this.ComponentClass=t,this.recipe=r,this.label=n}};o(q,"AtomicModifyMessage");var k=q,j=new Map,L=new Map,K=class K extends y{constructor(){super()}static send(...e){let t=new this(...e),r=t.debounceTime,n=j.get(this);if(n){t.debounceCallback(n);let c=L.get(this);c&&clearTimeout(c)}j.set(this,t);let h=setTimeout(()=>{j.delete(this),L.delete(this)},r);L.set(this,h),a.write(t)}debounceCallback(e){}};o(K,"DebounceMessage");var W=K;var D=null;function X(s){D=s}o(X,"activateInstance");var le=new Proxy({},{get(s,e){return e==="dispatch"?t=>{if(!D){console.error(`[Virid] Message dispatched before system init: ${t.constructor.name}`);return}return D.dispatch(t)}:Reflect.get(D||{},e)}}),Z=class Z{static write(e,...t){let r=typeof e=="function"?new e(...t):e;le.dispatch(r)}static error(e,t=""){this.write(new b(e,t))}static warn(e){this.write(new v(e))}static info(e){this.write(new S(e))}};o(Z,"MessageWriter");var a=Z;var ee=class ee{constructor(e){i(this,"dirtySignalTypes",new Set);i(this,"eventQueue",[]);i(this,"isRunning",!1);i(this,"globalTick",0);i(this,"internalDepth",0);i(this,"eventHub");i(this,"tickPayload",{});i(this,"beforeExecuteHooks",[]);i(this,"afterExecuteHooks",[]);i(this,"beforeTickHooks",[]);i(this,"afterTickHooks",[]);this.eventHub=e}addBeforeExecute(e,t,r){r?this.beforeExecuteHooks.unshift({type:e,handler:t}):this.beforeExecuteHooks.push({type:e,handler:t})}addAfterExecute(e,t,r){r?this.afterExecuteHooks.unshift({type:e,handler:t}):this.afterExecuteHooks.push({type:e,handler:t})}addBeforeTick(e,t){t?this.beforeTickHooks.unshift(e):this.beforeTickHooks.push(e)}addAfterTick(e,t){t?this.afterTickHooks.unshift(e):this.afterTickHooks.push(e)}markDirty(e){e instanceof p?this.eventQueue.push(e):e instanceof y&&this.dirtySignalTypes.add(e.constructor)}tick(e){if(!(this.isRunning||this.dirtySignalTypes.size===0&&this.eventQueue.length===0)){if(this.internalDepth>100){this.internalDepth=0,this.dirtySignalTypes.clear(),this.eventQueue=[],this.eventHub.reset(),a.error(new Error("[Virid Dispatcher] Deadlock: Recursive loop detected \u{1F4A5}."));return}this.isRunning=!0,this.internalDepth++,queueMicrotask(()=>{let t,r;try{this.internalDepth==0&&(this.tickPayload={},this.executeTickHooks(this.beforeTickHooks));let n=this.prepareSnapshot();t=n.signalSnapshot,r=n.eventSnapshot;let h=this.collectTasks(r,t,e);this.executeTasks(h)}catch(n){a.error(n,"[Virid Dispatcher] Unhandled Error")}finally{t&&r&&this.clear(r,t),this.isRunning=!1,this.dirtySignalTypes.size>0||this.eventQueue.length>0?this.tick(e):(this.executeTickHooks(this.afterTickHooks),this.globalTick++,this.internalDepth=0)}})}}collectTasks(e,t,r){let n=[];for(let c of e)(r.get(c.constructor)||[]).forEach(f=>{n.push(new P(f.fn,f.priority,c,{context:f.fn.systemContext,tick:this.globalTick,payload:{}}))});let h=new Set;for(let c of t)(r.get(c)||[]).forEach(f=>{h.has(f.fn)||(n.push(new P(f.fn,f.priority,this.eventHub.peekSignal(c),{context:f.fn.systemContext,tick:this.globalTick,payload:{}})),h.add(f.fn))});return n}executeTasks(e){e.sort((t,r)=>r.priority-t.priority);for(let t of e)try{let r=t.execute(this.beforeExecuteHooks,this.afterExecuteHooks);r instanceof Promise&&r.catch(n=>a.error(n,`[Virid Dispatcher]: Async System Error.
|
|
6
6
|
SystemLocation: ${t.hookContext.context.targetClass.name}.${t.hookContext.context.methodName}
|
|
7
7
|
MessageName: ${t.message.constructor.name}
|
|
8
8
|
MessageData: ${JSON.stringify(t.message)}`))}catch(r){a.error(r,`[Virid Dispatcher]: Sync System Error.
|
|
9
9
|
SystemLocation: ${t.hookContext.context.targetClass.name}.${t.hookContext.context.methodName}
|
|
10
10
|
MessageName: ${t.message.constructor.name}
|
|
11
|
-
MessageData: ${JSON.stringify(t.message)}`)}}prepareSnapshot(){this.eventHub.flip();let e=new Set(this.dirtySignalTypes),t=[...this.eventQueue];return this.dirtySignalTypes.clear(),this.eventQueue=[],{signalSnapshot:e,eventSnapshot:t}}clear(e,t){let r=new Set(t);e.forEach(n=>r.add(n.constructor)),this.eventHub.clearSignals(r),this.eventHub.clearEvents()}executeTickHooks(e){let t={tick:this.globalTick,timestamp:Date.now(),payload:this.tickPayload};e.forEach(r=>r(t))}};o(
|
|
11
|
+
MessageData: ${JSON.stringify(t.message)}`)}}prepareSnapshot(){this.eventHub.flip();let e=new Set(this.dirtySignalTypes),t=[...this.eventQueue];return this.dirtySignalTypes.clear(),this.eventQueue=[],{signalSnapshot:e,eventSnapshot:t}}clear(e,t){let r=new Set(t);e.forEach(n=>r.add(n.constructor)),this.eventHub.clearSignals(r),this.eventHub.clearEvents()}executeTickHooks(e){let t={tick:this.globalTick,timestamp:Date.now(),payload:this.tickPayload};e.forEach(r=>r(t))}};o(ee,"Dispatcher");var O=ee,te=class te{constructor(e,t,r,n){i(this,"fn");i(this,"priority");i(this,"message");i(this,"hookContext");this.fn=e,this.priority=t,this.message=r,this.hookContext=n}triggerHooks(e){let t=Array.isArray(this.message)?this.message[0]:this.message;if(t){for(let r of e)if(t instanceof r.type)try{let n=r.handler(this.message,this.hookContext);n instanceof Promise&&n.catch(h=>{a.error(h,`[Virid Hook] Async Hook Error:
|
|
12
12
|
It is prohibited to use asynchronous hooks within Hook:
|
|
13
13
|
${r.type.name}`)})}catch(n){a.error(n,`[Virid Hook] Hook Execute Failed:
|
|
14
14
|
Triggered by: ${t.constructor.name}
|
|
15
|
-
Registered type: ${r.type.name}`)}}}execute(e,t){this.triggerHooks(e);let r=o(()=>this.triggerHooks(t),"runAfter");try{let n=this.fn(this.message);return n instanceof Promise?n.finally(()=>r()):(r(),n)}catch(n){throw r(),n}}};o(
|
|
16
|
-
${e.constructor.name} must extend SingleMessage or EventMessage`))}flip(){this.signalActive=this.signalStaging,this.signalStaging=new Map,this.eventActive=this.eventStaging,this.eventStaging=[]}peekSignal(e){return this.signalActive.get(e)||[]}getEventStream(){return this.eventActive}peekEventAt(e){return this.eventActive[e]}clearSignals(e){e.forEach(t=>this.signalActive.delete(t))}clearEvents(){this.eventActive=[]}reset(){this.signalActive.clear(),this.signalStaging.clear(),this.eventActive=[],this.eventStaging=[]}};o(
|
|
15
|
+
Registered type: ${r.type.name}`)}}}execute(e,t){this.triggerHooks(e);let r=o(()=>this.triggerHooks(t),"runAfter");try{let n=this.fn(this.message);return n instanceof Promise?n.finally(()=>r()):(r(),n)}catch(n){throw r(),n}}};o(te,"ExecutionTask");var P=te;var re=class re{constructor(){i(this,"signalActive",new Map);i(this,"signalStaging",new Map);i(this,"eventActive",[]);i(this,"eventStaging",[])}push(e){if(e instanceof y){let t=e.constructor;this.signalStaging.has(t)||this.signalStaging.set(t,[]),this.signalStaging.get(t).push(e)}else e instanceof p?this.eventStaging.push(e):a.error(new Error(`[Virid Message] Invalid Message:
|
|
16
|
+
${e.constructor.name} must extend SingleMessage or EventMessage`))}flip(){this.signalActive=this.signalStaging,this.signalStaging=new Map,this.eventActive=this.eventStaging,this.eventStaging=[]}peekSignal(e){return this.signalActive.get(e)||[]}getEventStream(){return this.eventActive}peekEventAt(e){return this.eventActive[e]}clearSignals(e){e.forEach(t=>this.signalActive.delete(t))}clearEvents(){this.eventActive=[]}reset(){this.signalActive.clear(),this.signalStaging.clear(),this.eventActive=[],this.eventStaging=[]}};o(re,"EventHub");var N=re;var se=class se{constructor(){i(this,"systemTaskMap",new Map)}register(e,t,r=0){let n=this.systemTaskMap.get(e)||[];if(n.findIndex(c=>c.fn===t)===-1)n.push({fn:t,priority:r}),n.sort((c,d)=>d.priority-c.priority),this.systemTaskMap.set(e,n);else{let c=t.name||"Anonymous";return a.error(new Error(`[Virid Error] System Already Registered:
|
|
17
17
|
Class ${e.name}
|
|
18
|
-
Function ${
|
|
19
|
-
${
|
|
20
|
-
${
|
|
21
|
-
${
|
|
22
|
-
${
|
|
18
|
+
Function ${c}`)),()=>{}}return()=>{let c=this.systemTaskMap.get(e);if(c){let d=c.findIndex(f=>f.fn===t);d!==-1&&(c.splice(d,1),c.length===0&&this.systemTaskMap.delete(e))}}}};o(se,"MessageRegistry");var E=se;var ne=class ne{constructor(){i(this,"eventHub",new N);i(this,"dispatcher",new O(this.eventHub));i(this,"registry",new E);i(this,"middlewares",[]);X(this)}useMiddleware(e,t){this.middlewares.push(e)}onBeforeExecute(e,t,r){this.dispatcher.addBeforeExecute(e,t,r)}onAfterExecute(e,t,r){this.dispatcher.addAfterExecute(e,t,r)}onBeforeTick(e,t){this.dispatcher.addBeforeTick(e,t)}onAfterTick(e,t){this.dispatcher.addAfterTick(e,t)}dispatch(e){if(!(e instanceof x)){a.error(new Error(`[Virid Dispatch] Type Error: Message must be an instance of BaseMessage,message:${e}`));return}this.pipeline(e,()=>{if(!this.registry.systemTaskMap.has(e.constructor)){a.error(new Error(`[Virid Dispatch] No handler for message: ${e.constructor.name}`));return}this.eventHub.push(e),this.dispatcher.markDirty(e),this.dispatcher.tick(this.registry.systemTaskMap)})}pipeline(e,t){let r=0,n=o(()=>{r<this.middlewares.length?this.middlewares[r++](e,n):t()},"next");n()}register(e,t,r=0){return this.registry.register(e,t,r)}};o(ne,"MessageInternal");var M=ne;var oe=class oe{constructor(){i(this,"bindings",new Map);i(this,"singletonInstances",new Map)}bind(e){let t={type:"transient",ctor:e};return this.bindings.set(e,t),{toSelf:o(()=>({inSingletonScope:o(()=>(t.type="singleton",{onActivation:o(r=>{},"onActivation")}),"inSingletonScope")}),"toSelf")}}get(e,t){let r=this.bindings.get(e);if(!r)throw new Error(`[Virid Container] Unbound Constructor: No binding found for ${e.name}`);let n=r.ctor;if(r.type==="singleton"){if(!this.singletonInstances.has(e)){let c=new n,d=t(c);this.singletonInstances.set(e,d)}return this.singletonInstances.get(e)}let h=new n;return t(h)}};o(oe,"ViridContainer");var _=oe;var l={reset:"\x1B[0m",red:"\x1B[31m",yellow:"\x1B[33m",blue:"\x1B[34m",magenta:"\x1B[35m",cyan:"\x1B[36m",gray:"\x1B[90m",bold:"\x1B[1m",green:"\x1B[32m"};function B(s,e,t){let r={params:s,targetClass:Object,methodName:t,originalMethod:e};return e.ccsContext=r,e}o(B,"withContext");var we=o(s=>{let e=`${l.green}${l.bold} \u2714 [Virid Info] ${l.reset}`,t=`${l.magenta}${s.context}${l.reset}`;console.log(`${e}${l.gray}Global Info Caught:${l.reset}
|
|
19
|
+
${l.green}Details:${l.reset}`,s.context||"unknown Info")},"globalInfoHandler"),ke=o(s=>{let e=`${l.red}${l.bold} \u2716 [Virid Error] ${l.reset}`,t=`${l.magenta}${s.context}${l.reset}`;console.error(`${e}${l.gray}Global Error Caught:${l.reset}
|
|
20
|
+
${l.red}Context:${l.reset} ${t}
|
|
21
|
+
${l.red}Details:${l.reset}`,s.error||s||"unknown Error")},"globalErrorHandler"),Ee=o(s=>{let e=`${l.yellow}${l.bold} \u26A0 [Virid Warn] ${l.reset}`,t=`${l.cyan}${s.context}${l.reset}`;console.warn(`${e}${l.gray}Global Warn Caught:${l.reset}
|
|
22
|
+
${l.yellow}Context:${l.reset} ${t}`)},"globalWarnHandler"),Me=o(s=>{let e=H.get(s.ComponentClass);if(!e){console.error(`[Virid Modify] Component Not Found:
|
|
23
23
|
Component ${s.ComponentClass.name} not found in Registry.`);return}try{s.recipe(e),a.warn(`[Virid Modify] Successfully:
|
|
24
24
|
Modify on ${s.ComponentClass.name}
|
|
25
25
|
label: ${s.label}`)}catch(t){a.error(t,`[Virid Error] Modify Failed:
|
|
26
|
-
${s.label}`)}},"atomicModifyHandler");function
|
|
27
|
-
Unable to recognize system parameters, please confirm if import "reflection-metadata" was introduced at the beginning!`);a.error(
|
|
26
|
+
${s.label}`)}},"atomicModifyHandler");function he(s){s.register(k,B(k,Me,"GlobalAtomicModifier"),1e3),s.register(v,B(v,Ee,"GlobalWarnHandler"),-999),s.register(b,B(b,ke,"GlobalErrorHandler"),-999),s.register(S,B(S,we,"GlobalInfoHandler"),-999),H=s}o(he,"initializeGlobalSystems");var H=null,pt=new Proxy({},{get(s,e){return(...t)=>{if(!H){console.warn(`[Virid Vue] App method "${String(e)}" called before initialization.`);return}let r=H[e];if(typeof r=="function")return r.apply(H,t)}}});var ue=new Set,ae=class ae{constructor(){i(this,"container",new _);i(this,"messageInternal",new M);i(this,"activationHooks",[])}addActivationHook(e){this.activationHooks.push(e)}get(e){return e.length>0&&a.error(new Error(`[Virid Container] Violation: Component "${e.name}" should not have constructor arguments. Dependency Injection is only allowed in Systems.`)),this.container.get(e,t=>this.handleActivation(t))}handleActivation(e){return e&&this.activationHooks.reduce((t,r)=>{try{let n=r(t);return n===void 0&&a.warn(`[Virid Container] Hook Does Bot Return A Value: Hook "${r.name}" should return a instance to continue.`),n!==void 0?n:t}catch(n){return a.error(n,"[Virid Container] Activation Hook Failed"),t}},e)}bindController(e){return this.container.bind(e).toSelf(),{inSingletonScope:o(()=>({onActivation:o(()=>{},"onActivation")}),"inSingletonScope")}}bindComponent(e){return this.container.bind(e).toSelf().inSingletonScope(),{onActivation:o(()=>{},"onActivation")}}useMiddleware(e,t=!1){this.messageInternal.useMiddleware(e,t)}onBeforeExecute(e,t,r=!1){this.messageInternal.onBeforeExecute(e,t,r)}onAfterExecute(e,t,r=!1){this.messageInternal.onAfterExecute(e,t,r)}onBeforeTick(e,t=!1){this.messageInternal.onBeforeTick(e,t)}onAfterTick(e,t=!1){this.messageInternal.onAfterTick(e,t)}register(e,t,r=0){return this.messageInternal.register(e,t,r)}use(e,t){if(ue.has(e.name))return a.warn(`[Virid Plugin] Duplicate Installation: Plugin ${e.name} has already been installed.`),this;try{e.install(this,t),ue.add(e.name)}catch(r){a.error(r,`[Virid Plugin]: Install Failed: ${e.name}`)}return this}};o(ae,"ViridApp");var ie=ae,w=new ie;w.addActivationHook(R);he(w);var g={SYSTEM:"virid:core:system",MESSAGE:"virid:core:message",CONTROLLER:"virid:core:controller",COMPONENT:"virid:core:component",SAFE:"virid:core:safe",OBSERVER:"virid:core:observer"};var A=o(s=>{if(!s)return;(Array.isArray(s)?s:[s]).forEach(t=>{t instanceof x?a.write(t):a.warn("[Virid HandleResult] Invalid Return Type: Must return Message or Message[].")})},"handleResult");function Ae(s={priority:0,messageClass:null}){return(e,t,r)=>{let n=r.value,h=Reflect.getMetadata("design:paramtypes",e,t),c=Reflect.getMetadata(g.MESSAGE,e,t)||null;if(!h){let u=new Error(`[Virid System] System Parameter Loss:
|
|
27
|
+
Unable to recognize system parameters, please confirm if import "reflection-metadata" was introduced at the beginning!`);a.error(u);return}if(h.some(u=>u===void 0)){let u=new Error(`[Virid System] Parameter Metadata Loss in "${t}":
|
|
28
28
|
One or more parameters have 'undefined' types.
|
|
29
29
|
This usually happens when you forget to add a type annotation to a decorated parameter.
|
|
30
|
-
Check parameter at index: ${
|
|
31
|
-
Please declare the message type using the Message decorator`));return}let d=o(
|
|
30
|
+
Check parameter at index: ${h.indexOf(void 0)}`);a.error(u);return}if(s.messageClass&&c){a.error(new Error(`[Virid System] Multiple Messages Are Not Allowed: Cannot use @ message() and SystemParams simultaneously in ${t}`));return}if(!s.messageClass&&!c){a.error(new Error(`[Virid System] System Parameter Loss:
|
|
31
|
+
Please declare the message type using the Message decorator`));return}let d=o(u=>{let $=h.map((V,de)=>{if(c&&c.index==de){let{messageClass:G,single:fe}=c,I=Array.isArray(u)?u[0]:u;if(!(I instanceof G)){let pe=I.constructor.name;throw new Error(`[Virid System] Type Mismatch: Expected ${G.name}, but received ${pe}`)}if(I instanceof y)return fe?Array.isArray(u)?u[u.length-1]:u:Array.isArray(u)?u:[u];if(I instanceof p)return u;throw new Error(`[Virid System] unknown Message Types: Message ${G.name} is not a subclass of SingleMessage or EventMessage!`)}let ce=w.get(V);if(!ce)throw new Error(`[Virid System] unknown Inject Data Types: ${V.name} is not registered in the container!`);return ce}),T=n.apply(e,$);return T instanceof Promise?T.then(A):A(T)},"wrappedSystem"),f={params:h,targetClass:e,methodName:t,originalMethod:n};d.systemContext=f,r.value=d;let m=s.messageClass||c.messageClass;w.register(m,d,s.priority)}}o(Ae,"System");function $e(s,e=!0){return(t,r,n)=>{if(Reflect.hasOwnMetadata(g.MESSAGE,t,r)){a.error(new Error(`[Virid Message] Multiple Messages Are Not Allowed: ${r} has multiple @Message() decorators!`));return}let h={index:n,messageClass:s,single:e};Reflect.defineMetadata(g.MESSAGE,h,t,r)}}o($e,"Message");function Te(){return(s,e,t)=>{let r=Reflect.getMetadata(g.SAFE,s)||new Set;r.add(e),Reflect.defineMetadata(g.SAFE,r,s)}}o(Te,"Safe");function Ce(s,[]){return(e,t)=>{let r=Reflect.getMetadata(g.OBSERVER,e)||[];r.push({key:t,callback:s}),Reflect.defineMetadata(g.OBSERVER,r,e)}}o(Ce,"Observer");function He(){return s=>{Reflect.defineMetadata(g.CONTROLLER,!0,s)}}o(He,"Controller");function Re(){return s=>{Reflect.defineMetadata(g.COMPONENT,!0,s)}}o(Re,"Component");var Ve=["push","pop","shift","unshift","splice","sort","reverse"];function R(s){return!s||typeof s!="object"||Object.prototype.hasOwnProperty.call(s,"__virid_observer_processed__")||(Object.defineProperty(s,"__virid_observer_processed__",{value:!0,enumerable:!1,configurable:!0}),(Reflect.getMetadata(g.OBSERVER,s.constructor)||[]).forEach(({propertyKey:t,callback:r})=>{let n={value:s[t]},h=new Proxy(n,{get(d,f){let m=d.value;return Array.isArray(m)&&Ve.includes(f)?(...u)=>{let $=[...m],T=m[f].apply(m,u),V=r.call(s,$,m);return A(V),T}:m},set(d,f,m){let u=d.value;if(m===u)return!0;d.value=m;let $=r.call(s,u,m);return A($),!0}}),c=o(()=>h.value,"getter");c.__virid_box__=n,Object.defineProperty(s,t,{get:c,set:o(d=>{h.value=d},"set"),enumerable:!0,configurable:!0}),n.value&&typeof n.value=="object"&&R(n.value)}),Reflect.ownKeys(s).forEach(t=>{if(t==="__virid_observer_processed__")return;let r=Object.getOwnPropertyDescriptor(s,t);if(r&&r.get)return;let n=s[t];n&&typeof n=="object"&&R(n)})),s}o(R,"bindObservers");function Ie(){return w}o(Ie,"createVirid");0&&(module.exports={AtomicModifyMessage,BaseMessage,Component,Controller,DebounceMessage,ErrorMessage,EventMessage,InfoMessage,Message,MessageInternal,MessageRegistry,MessageWriter,Observer,Safe,SingleMessage,System,VIRID_METADATA,WarnMessage,activateInstance,bindObservers,createVirid,handleResult,publisher});
|
|
32
32
|
//# sourceMappingURL=index.cjs.map
|