@virid/core 0.2.3 → 0.3.0

package/dist/index.d.ts

@@ -1,170 +1,139 @@
 type Newable<TInstance = unknown, TArgs extends unknown[] = any[]> = new (...args: TArgs) => TInstance;
 interface AppConfig {
-    enableLog: boolean;
-}
-declare const defaultConfig: {
-    enableLog: boolean;
-};
-
-interface SystemParams {
-    priority?: number;
-    messageClass?: Newable<BaseMessage> | null;
-}
-interface MessageMetadata {
-    index: number;
-    messageClass: Newable<BaseMessage>;
-    single: boolean;
-}
-interface ObserverItem {
-    propertyKey: string;
-    callback: (oldVal: any, newVal: any) => void | BaseMessage | BaseMessage;
-}
-type ObserverMetadata = ObserverItem[];
-type SafeMetadata = Set<string>;
-
-type Middleware = (message: BaseMessage, next: () => void) => void;
-type ExecuteHook<T extends BaseMessage> = (message: [BaseMessage] extends [T] ? SingleMessage[] | EventMessage : T extends SingleMessage ? T[] : T, context: ExecuteHookContext) => void | Promise<void>;
-interface ExecuteHookContext {
-    context: SystemContext;
-    tick: number;
-    payload: {
-        [key: string]: any;
-    };
-}
-interface SystemContext {
-    params: any[];
-    targetClass: any;
-    methodName: string;
-    originalMethod: (...args: any[]) => any;
-}
-interface SystemTask {
-    fn: (...args: any[]) => any;
-    priority: number;
-}
-type MessagePayload<T> = T extends SingleMessage ? T[] : T extends EventMessage ? T : T | T[];
-type MessageIdentifier<T> = (abstract new (...args: any[]) => T) | Newable<T>;
-type TickHook = (context: TickHookContext) => void | Promise<void>;
-interface TickHookContext {
-    tick: number;
-    timestamp: number;
-    payload: {
-        [key: string]: any;
-    };
+    maxDepth?: number;
+    enableLog?: boolean;
+    manual?: boolean;
 }
+declare const defaultConfig: AppConfig;
 
 declare abstract class BaseMessage {
     static send<T extends Newable<any>>(this: T, ...args: ConstructorParameters<T>): void;
 }
-/**
- * 可合并的信号基类
- */
 declare abstract class SingleMessage extends BaseMessage {
-    private readonly __kind;
     constructor();
 }
-/**
- * 不可合并的消息基类
- */
 declare abstract class EventMessage extends BaseMessage {
-    private readonly __kind;
     constructor();
 }
-/**
- * 基础错误消息：不可合并，必须被精准捕获
- */
 declare class ErrorMessage extends EventMessage {
     readonly error: Error;
     readonly context?: string | undefined;
     constructor(error: Error, context?: string | undefined);
 }
-/**
- * 基础警告消息：不可合并，必须被精准捕获
- */
 declare class WarnMessage extends EventMessage {
     readonly context: string;
     constructor(context: string);
 }
-/**
- * 基础信息消息：不可合并，必须被精准捕获
- */
 declare class InfoMessage extends EventMessage {
     readonly context: string;
     constructor(context: string);
 }
 
-declare class MessageInternal {
-    private eventHub;
+declare class MessageEngine {
     private dispatcher;
     private registry;
     private middlewares;
-    constructor();
+    private manual;
+    constructor(maxDepth: number, manual: boolean);
     useMiddleware(mw: Middleware, front: boolean): void;
     onBeforeExecute<T extends BaseMessage>(type: MessageIdentifier<T>, hook: ExecuteHook<T>, front: boolean): void;
     onAfterExecute<T extends BaseMessage>(type: MessageIdentifier<T>, hook: ExecuteHook<T>, front: boolean): void;
     onBeforeTick(hook: TickHook, front: boolean): void;
     onAfterTick(hook: TickHook, front: boolean): void;
-    /**
-     * 消息进入系统的唯一入口
-     */
+    tick(): void;
     dispatch(message: BaseMessage): void;
     private pipeline;
     register(messageClass: any, systemFn: (...args: any[]) => any, priority?: number): () => void;
 }
 
-/**
- * @description: 消息注册器 - 负责将系统函数或监听器与消息类型关联
- */
 declare class MessageRegistry {
     systemTaskMap: Map<any, SystemTask[]>;
     /**
-     * 注册消息并返回一个卸载函数
-     * 这种模式能完美适配 Controller 的生命周期销毁
+     * Register the message and corresponding system and return an uninstallation function
      */
     register(messageClass: any, systemFn: (...args: any[]) => any, priority?: number): () => void;
 }
 
-interface IMessagePublisher {
-    dispatch(message: BaseMessage): void;
-}
-declare function activateInstance(instance: MessageInternal): void;
-declare const publisher: IMessagePublisher;
+declare function activateInstance(instance: MessageEngine): void;
 declare class MessageWriter {
-    /**
-     * 核心入口：无论是类还是实例，统一交给 Internal 处理
-     */
     static write<T extends BaseMessage, K extends Newable<T>>(target: K | T, ...args: ConstructorParameters<K>): void;
-    /**
-     * 快捷方式：系统内部常用
-     */
     static error(e: Error, context?: string): void;
     static warn(context: string): void;
     static info(context: string): void;
 }
 
-declare const handleResult: (res: any) => void;
+interface SystemParams {
+    priority?: number;
+    messageClass?: Newable<BaseMessage> | null;
+}
+interface MessageMetadata {
+    index: number;
+    messageClass: Newable<BaseMessage>;
+    single: boolean;
+}
+interface ObserverItem {
+    propertyKey: string;
+    callback: (oldVal: any, newVal: any) => void | BaseMessage | BaseMessage;
+}
+type ObserverMetadata = ObserverItem[];
+type SafeMetadata = Set<string>;
+
+type Middleware = (message: BaseMessage, next: () => void) => void;
+type ExecuteHook<T extends BaseMessage> = (message: [BaseMessage] extends [T] ? SingleMessage[] | EventMessage : T extends SingleMessage ? T[] : T, context: ExecuteHookContext, success: boolean) => void | Promise<void>;
+interface ExecuteHookContext {
+    context: SystemContext;
+    tick: number;
+    payload: {
+        [key: string]: any;
+    };
+}
+interface SystemContext {
+    params: any[];
+    targetClass: any;
+    methodName: string;
+    originalMethod: (...args: any[]) => any;
+}
+interface SystemConfig {
+    priority: number;
+    messageClass: Newable<BaseMessage>;
+    messageIdx: number;
+    batchMode: boolean;
+}
+interface SystemTask {
+    fn: (...args: any[]) => any;
+    priority: number;
+}
+type MessagePayload<T> = T extends SingleMessage ? T[] : T extends EventMessage ? T : T | T[];
+type MessageIdentifier<T> = (abstract new (...args: any[]) => T) | Newable<T>;
+type TickHook = (context: TickHookContext) => void | Promise<void>;
+interface TickHookContext {
+    tick: number;
+    timestamp: number;
+    payload: {
+        [key: string]: any;
+    };
+}
+
+declare function handleResult(res: any): void;
 /**
- * @description: 系统装饰器
- * @param priority 优先级，数值越大越早执行
+ * System Decorator
+ * @param params Priority and MessageClass config
  */
 declare function System(params?: SystemParams): (target: any, key: string, descriptor: PropertyDescriptor) => void;
 /**
- * @description: 标记参数为 MessageReader 并锁定其消息类型
- */
-declare function Message<T extends BaseMessage>(messageClass: Newable<T>, single?: boolean): (target: any, key: string, index: number) => void;
-/**
- * @description: 标识controller或者组件的方法是否是安全的，可被其他controller直接调用
+ * Is the method used to identify the controller or component safe and can be directly called by other controllers
  */
 declare function Safe(): (target: any, key: string, _descriptor: PropertyDescriptor) => void;
 /**
- * @description: 标识Component里的这个属性被改了之后需要调用一个回调
+ * Observer Decorator
  */
 declare function Observer(callback: (oldVal: any, newVale: any) => void | BaseMessage | BaseMessage[]): (target: any, propertyKey: string) => void;
 /**
- * @description: 标记Controller身份
+ * Controller Decorator
  */
 declare function Controller(): (target: any) => void;
 /**
- * @description: 标记Component身份
+ * Component Decorator
  */
 declare function Component(): (target: any) => void;
 
@@ -182,53 +151,78 @@ declare const VIRID_METADATA: {
 declare class ViridContainer {
     private bindings;
     private singletonInstances;
-    bind<T>(identifier: Newable<T>): {
-        toSelf: () => {
-            inSingletonScope: () => {
-                onActivation: (fn: any) => void;
-            };
-        };
-    };
-    get<T>(identifier: Newable<T>, onActivate: (instance: T) => T): T;
+    private activationHooks;
+    /**
+     * Register an activation hook
+     * @param hook An activation hook
+     * @param front Is the hook order inserted from the front or added
+     */
+    addActivationHook(hook: (instance: any) => any, front: boolean): void;
+    /**
+     * Static binding component or controller
+     * @param identifier Constructor of components or controllers
+     */
+    bind<T>(identifier: Newable<T>): void;
+    /**
+     * Dynamically register a component
+     * @param instance Component instance
+     */
+    spawn(instance: object): void;
+    /**
+     * Obtain a Component or Controller instance
+     * @param identifier Constructor of components or controllers
+     */
+    get<T>(identifier: Newable<T>): T;
+    private handleActivation;
 }
 
-interface ViridPlugin<T = void> {
+interface ViridPlugin<T = any> {
     name: string;
     install: (app: ViridApp, options: T) => void;
 }
-/**
- * 创建 virid 核心实例
- */
 declare class ViridApp {
     container: ViridContainer;
-    private messageInternal;
-    private activationHooks;
-    addActivationHook(hook: (instance: any) => any): void;
+    engine: MessageEngine;
+    private installedPlugins;
+    constructor(maxDepth: number, manual: boolean);
+    /**
+     * Register an activation hook
+     * @param hook An activation hook
+     * @param front Is the hook order inserted from the front or added
+     */
+    onActivate(hook: (instance: any) => any, front?: boolean): void;
+    /**
+     * Opening a new tick
+     */
+    tick(): void;
+    /**
+     * Obtain a Component or Controller instance
+     * @param identifier Constructor of components or controllers
+     */
     get<T>(identifier: Newable<T>): T;
-    private handleActivation;
     /**
-     * 绑定多例 (Controller 通常是多例)
+     * Static binding component or controller
+     * @param identifier Constructor of components or controllers
      */
-    bindController<T>(identifier: Newable<T>): {
-        inSingletonScope: () => {
-            onActivation: () => void;
-        };
-    };
+    bind<T>(identifier: Newable<T>): void;
     /**
-     * 绑定单例 (Component 是单例)
+     * Dynamically register a component
+     * @param instance Component instance
      */
-    bindComponent<T>(identifier: Newable<T>): {
-        onActivation: () => void;
-    };
+    spawn(instance: object): void;
     useMiddleware(mw: Middleware, front?: boolean): void;
     onBeforeExecute<T extends BaseMessage>(type: MessageIdentifier<T>, hook: ExecuteHook<T>, front?: boolean): void;
     onAfterExecute<T extends BaseMessage>(type: MessageIdentifier<T>, hook: ExecuteHook<T>, front?: boolean): void;
     onBeforeTick(hook: TickHook, front?: boolean): void;
     onAfterTick(hook: TickHook, front?: boolean): void;
-    register(messageClass: any, systemFn: (...args: any[]) => any, priority?: number): () => void;
     use<T>(plugin: ViridPlugin<T>, options: T): this;
+    /**
+     * Register message to registrar
+     * @param systemFn System functions
+     */
+    register(systemFn: (...args: any[]) => any): () => void;
 }
 
 declare function createVirid(config?: AppConfig): ViridApp;
 
-export { type AppConfig, BaseMessage, Component, Controller, ErrorMessage, EventMessage, type ExecuteHook, type ExecuteHookContext, type IMessagePublisher, InfoMessage, Message, type MessageIdentifier, MessageInternal, type MessageMetadata, type MessagePayload, MessageRegistry, MessageWriter, type Middleware, type Newable, Observer, type ObserverItem, type ObserverMetadata, Safe, type SafeMetadata, SingleMessage, System, type SystemContext, type SystemParams, type SystemTask, type TickHook, type TickHookContext, VIRID_METADATA, ViridApp, type ViridPlugin, WarnMessage, activateInstance, bindObservers, createVirid, defaultConfig, handleResult, publisher };
+export { type AppConfig, BaseMessage, Component, Controller, ErrorMessage, EventMessage, type ExecuteHook, type ExecuteHookContext, InfoMessage, MessageEngine, type MessageIdentifier, type MessageMetadata, type MessagePayload, MessageRegistry, MessageWriter, type Middleware, type Newable, Observer, type ObserverItem, type ObserverMetadata, Safe, type SafeMetadata, SingleMessage, System, type SystemConfig, type SystemContext, type SystemParams, type SystemTask, type TickHook, type TickHookContext, VIRID_METADATA, ViridApp, type ViridPlugin, WarnMessage, activateInstance, bindObservers, createVirid, defaultConfig, handleResult };

package/dist/index.js

@@ -1,29 +1,17 @@
 /**
- *  @virid/core v0.2.3
+ *  @virid/core v0.3.0
  *  A lightweight and powerful message core built using dependency injection and CCS concepts
  */
-var re=Object.defineProperty;var fe=(s,e,t)=>e in s?re(s,e,{enumerable:!0,configurable:!0,writable:!0,value:t}):s[e]=t;var o=(s,e)=>re(s,"name",{value:e,configurable:!0});var i=(s,e,t)=>fe(s,typeof e!="symbol"?e+"":e,t);var B=class B{static send(...e){a.write(this,...e)}};o(B,"BaseMessage");var y=B,G=class G extends y{constructor(){super();i(this,"__kind","SingleMessage")}};o(G,"SingleMessage");var x=G,L=class L extends y{constructor(){super();i(this,"__kind","EventMessage")}};o(L,"EventMessage");var m=L,j=class j extends m{constructor(t,r){super();i(this,"error");i(this,"context");this.error=t,this.context=r}};o(j,"ErrorMessage");var v=j,W=class W extends m{constructor(t){super();i(this,"context");this.context=t}};o(W,"WarnMessage");var S=W,Q=class Q extends m{constructor(t){super();i(this,"context");this.context=t}};o(Q,"InfoMessage");var b=Q;var C=null;function se(s){C=s}o(se,"activateInstance");var ue=new Proxy({},{get(s,e){return e==="dispatch"?t=>{if(!C){console.error(`[Virid] Message dispatched before system init: ${t.constructor.name}`);return}return C.dispatch(t)}:Reflect.get(C||{},e)}}),z=class z{static write(e,...t){let r=typeof e=="function"?new e(...t):e;ue.dispatch(r)}static error(e,t=""){let r=e instanceof Error?e:new Error(String(e));this.write(new v(r,t))}static warn(e){this.write(new S(e))}static info(e){this.write(new b(e))}};o(z,"MessageWriter");var a=z;var F=class F{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 m?this.eventQueue.push(e):e instanceof x&&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==1&&(this.tickPayload={},this.executeTickHooks(this.beforeTickHooks));let n=this.prepareSnapshot();t=n.signalSnapshot,r=n.eventSnapshot;let f=this.collectTasks(r,t,e);this.executeTasks(f)}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 l of e)(r.get(l.constructor)||[]).forEach(d=>{n.push(new V(d.fn,d.priority,l,{context:d.fn.systemContext,tick:this.globalTick,payload:{}}))});let f=new Set;for(let l of t)(r.get(l)||[]).forEach(d=>{f.has(d.fn)||(n.push(new V(d.fn,d.priority,this.eventHub.peekSignal(l),{context:d.fn.systemContext,tick:this.globalTick,payload:{}})),f.add(d.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.
+var ce=Object.defineProperty;var ge=(r,e,t)=>e in r?ce(r,e,{enumerable:!0,configurable:!0,writable:!0,value:t}):r[e]=t;var o=(r,e)=>ce(r,"name",{value:e,configurable:!0});var a=(r,e,t)=>ge(r,typeof e!="symbol"?e+"":e,t);var z={maxDepth:100,enableLog:!0,manual:!1};var F=null;function le(r){F=r}o(le,"activateInstance");function me(r){F?F.dispatch(r):console.error("[Virid MessageWriter] No active instance found.")}o(me,"dispatch");var J=class J{static write(e,...t){let s=typeof e=="function"?new e(...t):e;me(s)}static error(e,t=""){this.write(new v(e,t))}static warn(e){this.write(new $(e))}static info(e){this.write(new C(e))}};o(J,"MessageWriter");var d=J;var Y=class Y{static send(...e){d.write(this,...e)}};o(Y,"BaseMessage");var w=Y,q=class q extends w{constructor(){super()}};o(q,"SingleMessage");var S=q,K=class K extends w{constructor(){super()}};o(K,"EventMessage");var T=K,Q=class Q extends T{constructor(t,s){super();a(this,"error");a(this,"context");this.error=t,this.context=s}};o(Q,"ErrorMessage");var v=Q,X=class X extends T{constructor(t){super();a(this,"context");this.context=t}};o(X,"WarnMessage");var $=X,Z=class Z extends T{constructor(t){super();a(this,"context");this.context=t}};o(Z,"InfoMessage");var C=Z;var ee=class ee{constructor(){a(this,"systemTaskMap",new Map)}register(e,t,s=0){let i=this.systemTaskMap.get(e)||[];if(i.findIndex(c=>c.fn.systemContext.originalMethod===t.systemContext.originalMethod)===-1)i.push({fn:t,priority:s}),i.sort((c,l)=>l.priority-c.priority),this.systemTaskMap.set(e,i);else{let c=t.methodName,l=t.targetClass;return d.error(new Error(`[Virid Error] System Already Registered: Message Class ${e.name}, Location ${l.name}.${c}`)),()=>{}}return()=>{let c=this.systemTaskMap.get(e);if(c){let l=c.findIndex(m=>m.fn===t);l!==-1&&(c.splice(l,1),c.length===0&&this.systemTaskMap.delete(e))}}}};o(ee,"MessageRegistry");var I=ee;var te=class te{constructor(){a(this,"signalActive",new Map);a(this,"eventActive",[]);a(this,"signalStaging",new Map);a(this,"eventStaging",[])}stage(e){if(e instanceof S){let t=e.constructor;this.signalStaging.has(t)||this.signalStaging.set(t,[]),this.signalStaging.get(t).push(e)}else e instanceof T?this.eventStaging.push(e):d.error(new Error(`[Virid Message] Invalid Message:
+${e.constructor.name} must extend SingleMessage or EventMessage`))}flip(){this.signalActive=this.signalStaging,this.eventActive=this.eventStaging,this.signalStaging=new Map,this.eventStaging=[]}clearSignals(){this.signalActive=new Map}clearEvents(){this.eventActive=[]}isEmpty(){return this.signalStaging.size===0&&this.eventStaging.length===0}reset(){this.signalActive=new Map,this.signalStaging=new Map,this.eventStaging=[],this.eventActive=[]}};o(te,"Staging");var N=te;var se=class se{constructor(e){a(this,"maxDepth");a(this,"isRunning",!1);a(this,"globalTick",0);a(this,"internalDepth",0);a(this,"staging",new N);a(this,"tickPayload",{});a(this,"beforeExecuteHooks",[]);a(this,"afterExecuteHooks",[]);a(this,"beforeTickHooks",[]);a(this,"afterTickHooks",[]);this.maxDepth=e}addBeforeExecute(e,t,s){s?this.beforeExecuteHooks.unshift({type:e,handler:t}):this.beforeExecuteHooks.push({type:e,handler:t})}addAfterExecute(e,t,s){s?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)}stage(e){this.staging.stage(e)}tick(e){if(!(this.isRunning||this.staging.isEmpty())){if(this.internalDepth>this.maxDepth){this.internalDepth=0,this.staging.reset(),console.error(new Error(`[Virid Dispatcher] Deadlock: Max depth reached ${this.maxDepth}, Possible infinite loop detected. The dispatcher will stop processing this tick.`));return}this.isRunning=!0,this.internalDepth++,queueMicrotask(()=>{try{this.internalDepth==1&&(this.tickPayload={},this.executeTickHooks(this.beforeTickHooks)),this.staging.flip();let t=this.collectTasks(e);this.executeTasks(t)}catch(t){d.error(t,"[Virid Dispatcher] Unhandled Error")}finally{this.isRunning=!1,this.staging.isEmpty()?(this.staging.reset(),this.internalDepth=0,this.executeTickHooks(this.afterTickHooks),this.globalTick++):this.tick(e)}})}}tickSync(e){if(!this.staging.isEmpty()){for(this.internalDepth=0,this.tickPayload={},this.executeTickHooks(this.beforeTickHooks);!this.staging.isEmpty();){if(this.internalDepth>this.maxDepth){this.staging.reset(),this.internalDepth=0,console.error(new Error(`[Virid Dispatcher] Deadlock: Max depth reached ${this.maxDepth}, Possible infinite loop detected. Ticking aborted.`));return}this.internalDepth++;try{this.staging.flip();let t=this.collectTasks(e);this.executeTasks(t)}catch(t){d.error(t,"[Virid Dispatcher] Sub-Tick Unhandled Error");break}}this.staging.reset(),this.internalDepth=0,this.executeTickHooks(this.afterTickHooks),this.globalTick++}}collectTasks(e){let t=[];for(let s of this.staging.eventActive)(e.get(s.constructor)||[]).forEach(n=>{t.push(new B(n.fn,n.priority,s,{context:n.fn.systemContext,tick:this.globalTick,payload:{}},this.beforeExecuteHooks,this.afterExecuteHooks))});for(let[s,i]of this.staging.signalActive.entries())(e.get(s)||[]).forEach(c=>{t.push(new B(c.fn,c.priority,i,{context:c.fn.systemContext,tick:this.globalTick,payload:{}},this.beforeExecuteHooks,this.afterExecuteHooks))});return t}executeTasks(e){e.sort((t,s)=>s.priority-t.priority);for(let t of e){let s=Array.isArray(t.message)?t.message[0]:t.message;try{let i=t.execute();i instanceof Promise&&i.catch(n=>d.error(n,`[Virid Dispatcher]: Async System Error.
 SystemLocation: ${t.hookContext.context.targetClass.name}.${t.hookContext.context.methodName}
-MessageName:    ${t.message.constructor.name}
-MessageData:    ${JSON.stringify(t.message)}`))}catch(r){a.error(r,`[Virid Dispatcher]: Sync System Error.
+MessageName:    ${s.constructor.name}
+MessageData:    ${JSON.stringify(t.message)}`))}catch(i){d.error(i,`[Virid Dispatcher]: Sync System Error.
 SystemLocation: ${t.hookContext.context.targetClass.name}.${t.hookContext.context.methodName}
-MessageName:    ${t.message.constructor.name}
-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(F,"Dispatcher");var R=F,U=class U{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(f=>{a.error(f,`[Virid Hook] Async Hook Error:
-It is prohibited to use asynchronous hooks within Hook:
-${r.type.name}`)})}catch(n){a.error(n,`[Virid Hook] Hook Execute Failed:
-Triggered by: ${t.constructor.name}
- 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(U,"ExecutionTask");var V=U;var J=class J{constructor(){i(this,"signalActive",new Map);i(this,"signalStaging",new Map);i(this,"eventActive",[]);i(this,"eventStaging",[])}push(e){if(e instanceof x){let t=e.constructor;this.signalStaging.has(t)||this.signalStaging.set(t,[]),this.signalStaging.get(t).push(e)}else e instanceof m?this.eventStaging.push(e):a.error(new Error(`[Virid Message] Invalid Message:
-${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(J,"EventHub");var I=J;var Y=class Y{constructor(){i(this,"systemTaskMap",new Map)}register(e,t,r=0){let n=this.systemTaskMap.get(e)||[];if(n.findIndex(l=>l.fn===t)===-1)n.push({fn:t,priority:r}),n.sort((l,u)=>u.priority-l.priority),this.systemTaskMap.set(e,n);else{let l=t.name||"Anonymous";return a.error(new Error(`[Virid Error] System Already Registered:
-Class ${e.name}
-Function ${l}`)),()=>{}}return()=>{let l=this.systemTaskMap.get(e);if(l){let u=l.findIndex(d=>d.fn===t);u!==-1&&(l.splice(u,1),l.length===0&&this.systemTaskMap.delete(e))}}}};o(Y,"MessageRegistry");var M=Y;var q=class q{constructor(){i(this,"eventHub",new I);i(this,"dispatcher",new R(this.eventHub));i(this,"registry",new M);i(this,"middlewares",[]);se(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 y)){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(q,"MessageInternal");var A=q;var K=class K{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 l=new n,u=t(l);this.singletonInstances.set(e,u)}return this.singletonInstances.get(e)}let f=new n;return t(f)}};o(K,"ViridContainer");var D=K;var P=!0;function ne(s){P=s}o(ne,"toggleSwitch");var c={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 X(s,e,t){let r={params:s,targetClass:Object,methodName:t,originalMethod:e};return e.ccsContext=r,e}o(X,"withContext");var de=o(s=>{if(!P)return;let e=`${c.green}${c.bold} \u2714 [Virid Info] ${c.reset}`,t=`${c.magenta}${s.context}${c.reset}`;console.log(`${e}${c.gray}Global Info Caught:${c.reset}
-  ${c.green}Details:${c.reset}`,s.context||"unknown Info")},"globalInfoHandler"),pe=o(s=>{if(!P)return;let e=`${c.red}${c.bold} \u2716 [Virid Error] ${c.reset}`,t=`${c.magenta}${s.context}${c.reset}`;console.error(`${e}${c.gray}Global Error Caught:${c.reset}
-  ${c.red}Context:${c.reset} ${t}
-  ${c.red}Details:${c.reset}`,s.error||s||"unknown Error")},"globalErrorHandler"),ge=o(s=>{if(!P)return;let e=`${c.yellow}${c.bold} \u26A0 [Virid Warn] ${c.reset}`,t=`${c.cyan}${s.context}${c.reset}`;console.warn(`${e}${c.gray}Global Warn Caught:${c.reset}
-  ${c.yellow}Context:${c.reset} ${t}`)},"globalWarnHandler");function oe(s){s.register(S,X(S,ge,"GlobalWarnHandler"),-999),s.register(v,X(v,pe,"GlobalErrorHandler"),-999),s.register(b,X(b,de,"GlobalInfoHandler"),-999),O=s}o(oe,"initializeGlobalSystems");var O=null,qe=new Proxy({},{get(s,e){return(...t)=>{if(!O){console.warn(`[Virid Vue] App method "${String(e)}" called before initialization.`);return}let r=O[e];if(typeof r=="function")return Reflect.apply(r,O,t)}}});var ie=new Set,ee=class ee{constructor(){i(this,"container",new D);i(this,"messageInternal",new A);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(ie.has(e.name))return a.warn(`[Virid Plugin] Duplicate Installation: Plugin ${e.name} has already been installed.`),this;try{e.install(this,t),ie.add(e.name)}catch(r){a.error(r,`[Virid Plugin]: Install Failed: ${e.name}`)}return this}};o(ee,"ViridApp");var Z=ee,w=new Z;w.addActivationHook(_);oe(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 $=o(s=>{if(!s)return;(Array.isArray(s)?s:[s]).forEach(t=>{t instanceof y?a.write(t):a.warn("[Virid HandleResult] Invalid Return Type: Must return Message or  Message[].")})},"handleResult");function lt(s={priority:0,messageClass:null}){return(e,t,r)=>{if(typeof e!="function"){let h=new Error(`[Virid System] Method Type Error:
-The Method ${t} is not a static method, please check if there is a static keyword tag`);a.error(h);return}let n=r.value,f=Reflect.getMetadata("design:paramtypes",e,t),l=Reflect.getMetadata(g.MESSAGE,e,t)||null;if(!f){let h=new Error(`[Virid System] System Parameter Loss:
-Unable to recognize system parameters, please confirm if import "reflection-metadata" was introduced at the beginning!`);a.error(h);return}if(f.some(h=>h===void 0)){let h=new Error(`[Virid System] Parameter Metadata Loss in "${t}": 
-  One or more parameters have 'undefined' types. 
-  This usually happens when you forget to add a type annotation to a decorated parameter.
-  Check parameter at index: ${f.indexOf(void 0)}`);a.error(h);return}if(s.messageClass&&l){a.error(new Error(`[Virid System] Multiple Messages Are Not Allowed: Cannot use @ message() and SystemParams simultaneously in ${t}`));return}if(!s.messageClass&&!l){a.error(new Error(`[Virid System] System Parameter Loss:
-Please declare the message type using the Message decorator`));return}let u=o(h=>{let E=f.map((T,ce)=>{if(l&&l.index==ce){let{messageClass:N,single:le}=l,H=Array.isArray(h)?h[0]:h;if(!(H instanceof N)){let he=H.constructor.name;throw new Error(`[Virid System] Type Mismatch: Expected ${N.name}, but received ${he}`)}if(H instanceof x)return le?Array.isArray(h)?h[h.length-1]:h:Array.isArray(h)?h:[h];if(H instanceof m)return h;throw new Error(`[Virid System] unknown Message Types: Message ${N.name} is not a subclass of SingleMessage or EventMessage!`)}let te=w.get(T);if(!te)throw new Error(`[Virid System] unknown Inject Data Types: ${T.name} is not registered in the container!`);return te}),k=n.apply(e,E);return k instanceof Promise?k.then($):$(k)},"wrappedSystem"),d={params:f,targetClass:e,methodName:t,originalMethod:n};u.systemContext=d,r.value=u;let p=s.messageClass||l.messageClass;w.register(p,u,s.priority)}}o(lt,"System");function ht(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 f={index:n,messageClass:s,single:e};Reflect.defineMetadata(g.MESSAGE,f,t,r)}}o(ht,"Message");function ft(){return(s,e,t)=>{let r=Reflect.getMetadata(g.SAFE,s)||new Set;r.add(e),Reflect.defineMetadata(g.SAFE,r,s)}}o(ft,"Safe");function ut(s){return(e,t)=>{let r=Reflect.getMetadata(g.OBSERVER,e)||[];r.push({propertyKey:t,callback:s}),Reflect.defineMetadata(g.OBSERVER,r,e)}}o(ut,"Observer");function dt(){return s=>{Reflect.defineMetadata(g.CONTROLLER,!0,s)}}o(dt,"Controller");function pt(){return s=>{Reflect.defineMetadata(g.COMPONENT,!0,s)}}o(pt,"Component");var me=["push","pop","shift","unshift","splice","sort","reverse"];function _(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)||[]).forEach(({propertyKey:t,callback:r})=>{let n={value:s[t]},f=new Proxy(n,{get(u,d){let p=u.value;return Array.isArray(p)&&me.includes(d)?(...h)=>{let E=[...p],k=p[d].apply(p,h),T=r.call(s,E,p);return $(T),k}:p},set(u,d,p){let h=u.value;if(p===h)return!0;u.value=p;let E=r.call(s,h,p);return $(E),!0}}),l=o(()=>f.value,"getter");l.__virid_box__=n,Object.defineProperty(s,t,{get:l,set:o(u=>{f.value=u},"set"),enumerable:!0,configurable:!0}),n.value&&typeof n.value=="object"&&_(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"&&_(n)})),s}o(_,"bindObservers");var ae={enableLog:!0};function It(s=ae){return ne(s.enableLog),w}o(It,"createVirid");export{y as BaseMessage,pt as Component,dt as Controller,v as ErrorMessage,m as EventMessage,b as InfoMessage,ht as Message,A as MessageInternal,M as MessageRegistry,a as MessageWriter,ut as Observer,ft as Safe,x as SingleMessage,lt as System,g as VIRID_METADATA,S as WarnMessage,se as activateInstance,_ as bindObservers,It as createVirid,ae as defaultConfig,$ as handleResult,ue as publisher};
+MessageName:    ${s.constructor.name}
+MessageData:    ${JSON.stringify(t.message)}`)}}}executeTickHooks(e){let t={tick:this.globalTick,timestamp:Date.now(),payload:this.tickPayload};e.forEach(s=>s(t))}};o(se,"Dispatcher");var _=se,re=class re{constructor(e,t,s,i,n,c){a(this,"fn");a(this,"priority");a(this,"message");a(this,"hookContext");a(this,"beforeExecuteHooks");a(this,"afterExecuteHooks");a(this,"success",!0);this.fn=e,this.priority=t,this.message=s,this.hookContext=i,this.beforeExecuteHooks=n,this.afterExecuteHooks=c}triggerHooks(e){let t=Array.isArray(this.message)?this.message[0]:this.message;if(t){for(let s of e)if(t instanceof s.type)try{let i=s.handler(this.message,this.hookContext,this.success);i instanceof Promise&&i.catch(n=>{d.error(n,`[Virid Hook] Async Hook Error: It is prohibited to use asynchronous hooks within Hook: ${s.type.name}`)})}catch(i){d.error(i,`[Virid Hook] Hook Execute Failed: Triggered by: ${t.constructor.name}, Registered type: ${s.type.name}`)}}}execute(){this.triggerHooks(this.beforeExecuteHooks);let e=o(()=>this.triggerHooks(this.afterExecuteHooks),"runAfter");try{let t=this.fn(this.message);return t instanceof Promise?t.catch(()=>this.success=!1).finally(e):(e(),t)}catch(t){throw this.success=!1,e(),t}}};o(re,"ExecutionTask");var B=re;var oe=class oe{constructor(e,t){a(this,"dispatcher");a(this,"registry",new I);a(this,"middlewares",[]);a(this,"manual");this.dispatcher=new _(e),this.manual=t,le(this)}useMiddleware(e,t){this.middlewares.push(e)}onBeforeExecute(e,t,s){this.dispatcher.addBeforeExecute(e,t,s)}onAfterExecute(e,t,s){this.dispatcher.addAfterExecute(e,t,s)}onBeforeTick(e,t){this.dispatcher.addBeforeTick(e,t)}onAfterTick(e,t){this.dispatcher.addAfterTick(e,t)}tick(){this.dispatcher.tickSync(this.registry.systemTaskMap)}dispatch(e){if(!(e instanceof w)){d.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)){d.error(new Error(`[Virid Dispatch] No handler for message: ${e.constructor.name}`));return}this.dispatcher.stage(e),this.manual||this.dispatcher.tick(this.registry.systemTaskMap)})}pipeline(e,t){let s=0,i=o(()=>{s<this.middlewares.length?this.middlewares[s++](e,i):t()},"next");i()}register(e,t,s=0){return this.registry.register(e,t,s)}};o(oe,"MessageEngine");var P=oe;var y={SYSTEM:"virid:core:system",MESSAGE:"virid:core:message",CONTROLLER:"virid:core:controller",COMPONENT:"virid:core:component",SAFE:"virid:core:safe",OBSERVER:"virid:core:observer"};function R(r){if(!r)return;(Array.isArray(r)?r:[r]).forEach(t=>{t instanceof w?d.write(t):d.warn("[Virid HandleResult] Invalid Return Type: Must return Message or  Message[].")})}o(R,"handleResult");function ue(r){let e=[];if(r.forEach((t,s)=>{(t===w||t&&t.prototype instanceof w)&&e.push({type:t,idx:s})}),e.length===0)return null;if(e.length>1){let t=e.map(s=>`[Index: ${s.idx}, Name: ${s.type.name}]`).join(", ");throw new Error(`[Virid System] Multiple Messages: Multiple Message type parameters detected, this is not allowed! specific location: ${t}`)}return e[0]}o(ue,"checkMessageParam");function j(r={messageClass:null,priority:0}){return(e,t,s)=>{if(typeof e!="function")throw new Error(`[Virid System] Method Type Error: The Method ${t} is not a static method, please check if there is a static keyword tag.`);let i=s.value,n=Reflect.getMetadata("design:paramtypes",e,t);if(!n)throw new Error('[Virid System] System Parameter Loss: Unable to recognize system parameters, please confirm if import "reflect-metadata" was introduced at the beginning.');let c=n.map((g,A)=>g===void 0?A:-1).filter(g=>g!==-1);if(c.length>0)throw new Error(`[Virid System] Parameter Metadata Loss in "${t}": One or more parameters have 'undefined' types. This usually happens when you forget to add a type annotation or due to circular dependencies. Check parameter at indices: [${c.join(", ")}]`);let l,m=-1,u=!1,x=n.indexOf(Array);if(x!==-1){if(!r.messageClass)throw new Error("[Virid System] System Parameter Loss: When using batch processing mode with Array, the messageClass parameter must be specified in decorator options.");if(!(r.messageClass.prototype instanceof S))throw new Error("[Virid System] System Parameter Loss: When using the batch processing mode, the messageClass parameter must inherit from SingleMessage.");l=r.messageClass,m=x,u=!0}else{let g=ue(n);if(g&&r.messageClass)throw new Error(`[Virid System] Multiple Messages Are Not Allowed: Cannot specify messageClass in decorator options while already declaring it in method parameters at index ${g.idx} in ${t}.`);if(g)l=g.type,m=g.idx;else if(r.messageClass)l=r.messageClass,m=-1;else throw new Error("[Virid System] System Parameter Loss: Please declare the message type either in method parameters or via the Message decorator options.")}let E={params:n,targetClass:e,methodName:t,originalMethod:i},b={messageClass:l,messageIdx:m,priority:r.priority||0,batchMode:u};s.value.systemContext=E,s.value.systemConfig=b}}o(j,"System");function st(){return(r,e,t)=>{let s=Reflect.getMetadata(y.SAFE,r)||new Set;s.add(e),Reflect.defineMetadata(y.SAFE,s,r)}}o(st,"Safe");function rt(r){return(e,t)=>{let s=Reflect.getMetadata(y.OBSERVER,e)||[];s.push({propertyKey:t,callback:r}),Reflect.defineMetadata(y.OBSERVER,s,e)}}o(rt,"Observer");function ot(){return r=>{Reflect.defineMetadata(y.CONTROLLER,!0,r)}}o(ot,"Controller");function he(){return r=>{Reflect.defineMetadata(y.COMPONENT,!0,r)}}o(he,"Component");var ye=["push","pop","shift","unshift","splice","sort","reverse"];function L(r){return!r||typeof r!="object"||Object.prototype.hasOwnProperty.call(r,"__virid_observer_processed__")||(Object.defineProperty(r,"__virid_observer_processed__",{value:!0,enumerable:!1,configurable:!0}),(Reflect.getMetadata(y.OBSERVER,r)||[]).forEach(({propertyKey:t,callback:s})=>{let i={value:r[t]},n=new Proxy(i,{get(l,m){let u=l.value;return Array.isArray(u)&&ye.includes(m)?(...x)=>{let E=[...u],b=u[m].apply(u,x),g=s.call(r,E,u);return R(g),b}:u},set(l,m,u){let x=l.value;if(u===x)return!0;l.value=u;let E=s.call(r,x,u);return R(E),!0}}),c=o(()=>n.value,"getter");c.__virid_box__=i,Object.defineProperty(r,t,{get:c,set:o(l=>{n.value=l},"set"),enumerable:!0,configurable:!0}),i.value&&typeof i.value=="object"&&L(i.value)}),Reflect.ownKeys(r).forEach(t=>{if(t==="__virid_observer_processed__")return;let s=Object.getOwnPropertyDescriptor(r,t);if(s&&s.get)return;let i=r[t];i&&typeof i=="object"&&L(i)})),r}o(L,"bindObservers");var ie=class ie{constructor(){a(this,"bindings",new Map);a(this,"singletonInstances",new Map);a(this,"activationHooks",[])}addActivationHook(e,t){t?this.activationHooks.unshift(e):this.activationHooks.push(e)}bind(e){if(e.length>0)throw new Error(`[Virid Container] Cannot Bind Component Or Controller: The Class ${e.name} should not have mandatory parameters.`);if(Reflect.getMetadata(y.COMPONENT,e)){let t={type:"singleton",ctor:e};this.bindings.set(e,t)}else if(Reflect.getMetadata(y.CONTROLLER,e)){let t={type:"transient",ctor:e};this.bindings.set(e,t)}else throw new Error(`[Virid Container] Cannot Bind Component Or Controller: The Class ${e.name} is not decorated with @Component or @Controller`)}spawn(e){let t=e.constructor;if(Reflect.hasMetadata(y.COMPONENT,t)){let s={type:"singleton",ctor:t};this.bindings.set(t,s),this.singletonInstances.set(t,e)}else throw new Error(`[Virid Container] Cannot spawn Component: The Class ${t.name} is not decorated with @Component`)}get(e){let t=this.bindings.get(e);if(!t)throw new Error(`[Virid Container] Cannot Get Component Or Controller: No binding found for ${e}`);let s=t.ctor;if(t.type==="singleton"){if(!this.singletonInstances.has(e)){let n=new s,c=this.handleActivation(n);this.singletonInstances.set(e,c)}return this.singletonInstances.get(e)}let i=new s;return this.handleActivation(i)}handleActivation(e){for(let t of this.activationHooks)e=t(e);return e}};o(ie,"ViridContainer");var W=ie;function xe(r,e,t,s){var i=arguments.length,n=i<3?e:s===null?s=Object.getOwnPropertyDescriptor(e,t):s,c;if(typeof Reflect=="object"&&typeof Reflect.decorate=="function")n=Reflect.decorate(r,e,t,s);else for(var l=r.length-1;l>=0;l--)(c=r[l])&&(n=(i<3?c(n):i>3?c(e,t,n):c(e,t))||n);return i>3&&n&&Object.defineProperty(e,t,n),n}o(xe,"_ts_decorate");function fe(r,e){if(typeof Reflect=="object"&&typeof Reflect.metadata=="function")return Reflect.metadata(r,e)}o(fe,"_ts_metadata");var ne=class ne{constructor(e,t){a(this,"container",new W);a(this,"engine");a(this,"installedPlugins",new Set);this.engine=new P(e,t),this.container.spawn(this)}onActivate(e,t=!1){this.container.addActivationHook(e,t)}tick(){this.engine.tick()}get(e){return this.container.get(e)}bind(e){this.container.bind(e)}spawn(e){this.container.spawn(e)}useMiddleware(e,t=!1){this.engine.useMiddleware(e,t)}onBeforeExecute(e,t,s=!1){this.engine.onBeforeExecute(e,t,s)}onAfterExecute(e,t,s=!1){this.engine.onAfterExecute(e,t,s)}onBeforeTick(e,t=!1){this.engine.onBeforeTick(e,t)}onAfterTick(e,t=!1){this.engine.onAfterTick(e,t)}use(e,t){if(this.installedPlugins.has(e.name))return d.warn(`[Virid Plugin] Duplicate Installation: Plugin ${e.name} has already been installed.`),this;try{e.install(this,t),this.installedPlugins.add(e.name)}catch(s){d.error(s,`[Virid Plugin]: Install Failed: ${e.name}`)}return this}register(e){let t=e.systemContext,s=e.systemConfig;if(!t||!s)throw new Error(`[Virid System] System Parameter Loss: Please declare ${e.name} using the @System decorator first.`);let{params:i,targetClass:n,originalMethod:c}=t,{messageClass:l,messageIdx:m,priority:u,batchMode:x}=s,E=typeof R=="function"?R:h=>h,b=o(h=>h instanceof Promise?h.then(E):E(h),"processResult"),g=new Array(i.length),A=!1,U=o(()=>{for(let h=0;h<i.length;h++)if(h!==m){let p=this.get(i[h]);if(!p)throw new Error(`[Virid System] Unknown Inject Data Types: ${i[h].name||i[h]} is not registered in the container for system '${e.name}'!`);g[h]=p}A=!0},"initDeps"),M;return m===-1?M=o(()=>(A||U(),b(c.apply(n,g))),"wrappedSystem"):i.length===1?x?M=o(h=>{let p=Array.isArray(h)?h:[h];if(p.length>0&&!(p[0]instanceof l))throw new Error(`[Virid System] Type Mismatch: Expected list of ${l.name}, but got ${p[0]?.constructor?.name}`);return b(c.call(n,p))},"wrappedSystem"):M=o(h=>{let p=Array.isArray(h)?h[h.length-1]:h;if(!(p instanceof l))throw new Error(`[Virid System] Type Mismatch: Expected ${l.name}, but got ${p?.constructor?.name}`);return b(c.call(n,p))},"wrappedSystem"):x?M=o(h=>{A||U();let p=Array.isArray(h)?h:[h];if(p.length>0&&!(p[0]instanceof l))throw new Error(`[Virid System] Type Mismatch: Expected list of ${l.name}, but got ${p[0]?.constructor?.name}`);let O=[...g];return O[m]=p,b(c.apply(n,O))},"wrappedSystem"):M=o(h=>{A||U();let p=Array.isArray(h)?h[h.length-1]:h;if(!(p instanceof l))throw new Error(`[Virid System] Type Mismatch: Expected ${l.name}, but got ${p?.constructor?.name}`);let O=[...g];return O[m]=p,b(c.apply(n,O))},"wrappedSystem"),M.systemContext=t,this.engine.register(l,M,u)}};o(ne,"ViridApp");var H=ne;H=xe([he(),fe("design:type",Function),fe("design:paramtypes",[Number,Boolean])],H);function ae(r,e,t,s){var i=arguments.length,n=i<3?e:s===null?s=Object.getOwnPropertyDescriptor(e,t):s,c;if(typeof Reflect=="object"&&typeof Reflect.decorate=="function")n=Reflect.decorate(r,e,t,s);else for(var l=r.length-1;l>=0;l--)(c=r[l])&&(n=(i<3?c(n):i>3?c(e,t,n):c(e,t))||n);return i>3&&n&&Object.defineProperty(e,t,n),n}o(ae,"_ts_decorate");function k(r,e){if(typeof Reflect=="object"&&typeof Reflect.metadata=="function")return Reflect.metadata(r,e)}o(k,"_ts_metadata");var G=!0;function de(r){G=r}o(de,"toggleSwitch");var f={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"},V,D=(V=class{static globalInfoHandler(e){if(!G)return;let t=`${f.green}${f.bold} \u2714 [Virid Info] ${f.reset}`,s=`${f.magenta}${e.context}${f.reset}`;console.log(`${t}${f.gray}Global Info Caught:${f.reset}
+${f.green}Details:${f.reset}`,s||"unknown Info")}static globalErrorHandler(e){if(!G)return;let t=`${f.red}${f.bold} \u2716 [Virid Error] ${f.reset}`,s=`${f.magenta}${e.context}${f.reset}`;console.error(`${t}${f.gray}Global Error Caught:${f.reset}
+${f.red}Context:${f.reset} ${s}
+${f.red}Details:${f.reset}`,e.error||e||"unknown Error")}static globalWarnHandler(e){if(!G)return;let t=`${f.yellow}${f.bold} \u26A0 [Virid Warn] ${f.reset}`,s=`${f.cyan}${e.context}${f.reset}`;console.warn(`${t}${f.gray}Global Warn Caught:${f.reset}
+${f.yellow}Context:${f.reset} ${s}`)}},o(V,"ViridLogHandler"),V);ae([j(),k("design:type",Function),k("design:paramtypes",[typeof C>"u"?Object:C]),k("design:returntype",void 0)],D,"globalInfoHandler",null);ae([j(),k("design:type",Function),k("design:paramtypes",[typeof v>"u"?Object:v]),k("design:returntype",void 0)],D,"globalErrorHandler",null);ae([j(),k("design:type",Function),k("design:paramtypes",[typeof $>"u"?Object:$]),k("design:returntype",void 0)],D,"globalWarnHandler",null);function pe(r){r.register(D.globalInfoHandler),r.register(D.globalErrorHandler),r.register(D.globalWarnHandler)}o(pe,"registerBasicSystems");function Ht(r=z){r={...z,...r};let e=new H(r.maxDepth,r.manual);pe(e),de(r.enableLog),e.onActivate(L);let t=e;return e.spawn(t),e}o(Ht,"createVirid");export{w as BaseMessage,he as Component,ot as Controller,v as ErrorMessage,T as EventMessage,C as InfoMessage,P as MessageEngine,I as MessageRegistry,d as MessageWriter,rt as Observer,st as Safe,S as SingleMessage,j as System,y as VIRID_METADATA,H as ViridApp,$ as WarnMessage,le as activateInstance,L as bindObservers,Ht as createVirid,z as defaultConfig,R as handleResult};
 //# sourceMappingURL=index.js.map