@virid/core 0.0.1 → 0.1.1

package/dist/index.js

@@ -1,712 +1,32 @@
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-
-// index.ts
-var index_exports = {};
-__export(index_exports, {
-  AtomicModifyMessage: () => AtomicModifyMessage,
-  BaseMessage: () => BaseMessage,
-  Component: () => Component,
-  Controller: () => Controller,
-  ErrorMessage: () => ErrorMessage,
-  EventMessage: () => EventMessage,
-  Message: () => Message,
-  MessageInternal: () => MessageInternal,
-  MessageWriter: () => MessageWriter,
-  SingleMessage: () => SingleMessage,
-  System: () => System,
-  WarnMessage: () => WarnMessage,
-  activatInstance: () => activatInstance,
-  createVirid: () => createVirid,
-  publisher: () => publisher
-});
-module.exports = __toCommonJS(index_exports);
-
-// app.ts
-var import_inversify = require("inversify");
-
-// message/types.ts
-var BaseMessage = class {
-  static {
-    __name(this, "BaseMessage");
-  }
-  static send(...args) {
-    MessageWriter.write(this, ...args);
-  }
-  senderInfo;
-  constructor() {
-  }
-};
-var SingleMessage = class extends BaseMessage {
-  static {
-    __name(this, "SingleMessage");
-  }
-  // @ts-ignore 只用来区分的标识符
-  __kind = "SingleMessage";
-  constructor() {
-    super();
-  }
-};
-var EventMessage = class extends BaseMessage {
-  static {
-    __name(this, "EventMessage");
-  }
-  // @ts-ignore 只用来区分的标识符
-  __kind = "EventMessage";
-  constructor() {
-    super();
-  }
-};
-var ErrorMessage = class extends EventMessage {
-  static {
-    __name(this, "ErrorMessage");
-  }
-  error;
-  context;
-  constructor(error, context) {
-    super(), this.error = error, this.context = context;
-  }
-};
-var WarnMessage = class extends EventMessage {
-  static {
-    __name(this, "WarnMessage");
-  }
-  context;
-  constructor(context) {
-    super(), this.context = context;
-  }
-};
-var AtomicModifyMessage = class extends EventMessage {
-  static {
-    __name(this, "AtomicModifyMessage");
-  }
-  ComponentClass;
-  recipe;
-  label;
-  constructor(ComponentClass, recipe, label) {
-    super(), this.ComponentClass = ComponentClass, this.recipe = recipe, this.label = label;
-  }
-};
-
-// message/io.ts
-var activeInstance = null;
-function activatInstance(instance) {
-  activeInstance = instance;
-}
-__name(activatInstance, "activatInstance");
-var publisher = new Proxy({}, {
-  get(_, prop) {
-    if (prop === "dispatch") {
-      return (message) => {
-        if (!activeInstance) {
-          console.error(`[Virid] Message dispatched before system init: ${message.constructor.name}`);
-          return;
-        }
-        return activeInstance.dispatch(message);
-      };
-    }
-    return Reflect.get(activeInstance || {}, prop);
-  }
-});
-var MessageWriter = class {
-  static {
-    __name(this, "MessageWriter");
-  }
-  /**
-  * 核心入口：无论是类还是实例，统一交给 Internal 处理
-  */
-  static write(target, ...args) {
-    const instance = typeof target === "function" ? new target(...args) : target;
-    publisher.dispatch(instance);
-  }
-  /**
-  * 快捷方式：系统内部常用
-  */
-  static error(e, context) {
-    this.write(new ErrorMessage(e, context));
-  }
-  static warn(context) {
-    this.write(new WarnMessage(context));
-  }
-};
-
-// message/dispatcher.ts
-var ExecutionTask = class {
-  static {
-    __name(this, "ExecutionTask");
-  }
-  fn;
-  priority;
-  message;
-  context;
-  constructor(fn, priority, message, context) {
-    this.fn = fn;
-    this.priority = priority;
-    this.message = message;
-    this.context = context;
-  }
-  triggerHooks(hooks) {
-    const sample = Array.isArray(this.message) ? this.message[0] : this.message;
-    if (!sample) return;
-    for (const hook of hooks) {
-      if (sample instanceof hook.type) {
-        try {
-          const result = hook.handler(this.message, this.context);
-          if (result instanceof Promise) {
-            result.catch((e) => MessageWriter.error(e, `[Virid Hook] Async Hook Error:
-${hook.type.name}`));
-          }
-        } catch (e) {
-          MessageWriter.error(e, `[Virid Hook] Hook Execute Failed:
-Triggered by: ${sample.constructor.name}
- Registered type: ${hook.type.name}`);
-        }
-      }
-    }
-  }
-  execute(beforeHooks, afterHooks) {
-    this.triggerHooks(beforeHooks);
-    const runAfter = /* @__PURE__ */ __name(() => this.triggerHooks(afterHooks), "runAfter");
-    try {
-      const result = this.fn(this.message);
-      if (result instanceof Promise) {
-        return result.finally(() => runAfter());
-      }
-      runAfter();
-      return result;
-    } catch (e) {
-      runAfter();
-      throw e;
-    }
-  }
-};
-var Dispatcher = class {
-  static {
-    __name(this, "Dispatcher");
-  }
-  dirtySignalTypes = /* @__PURE__ */ new Set();
-  eventQueue = [];
-  isRunning = false;
-  tickCount = 0;
-  eventHub;
-  // 使用 MessageIdentifier 允许存入 BaseMessage, SingleMessage 等抽象类
-  beforeHooks = [];
-  afterHooks = [];
-  constructor(eventHub) {
-    this.eventHub = eventHub;
-  }
-  // 添加执行钩子
-  addBefore(type, hook) {
-    this.beforeHooks.push({
-      type,
-      handler: hook
-    });
-  }
-  addAfter(type, hook) {
-    this.afterHooks.push({
-      type,
-      handler: hook
-    });
-  }
-  cleanupHook = /* @__PURE__ */ __name(() => {
-  }, "cleanupHook");
-  setCleanupHook(hook) {
-    this.cleanupHook = hook;
-  }
-  /**
-  * 标记脏数据：根据基类判断进入哪个池子
-  */
-  markDirty(message) {
-    if (message instanceof EventMessage) {
-      this.eventQueue.push(message);
-    } else if (message instanceof SingleMessage) {
-      this.dirtySignalTypes.add(message.constructor);
-    }
-  }
-  tick(interestMap) {
-    if (this.isRunning || this.dirtySignalTypes.size === 0 && this.eventQueue.length === 0) return;
-    if (this.tickCount > 100) {
-      this.tickCount = 0;
-      this.dirtySignalTypes.clear();
-      this.eventQueue = [];
-      this.eventHub.reset();
-      MessageWriter.error(new Error("[Virid Dispatcher] Deadlock: Recursive loop detected."));
-      return;
-    }
-    this.isRunning = true;
-    this.tickCount++;
-    queueMicrotask(() => {
-      try {
-        this.eventHub.flip();
-        const signalSnapshot = new Set(this.dirtySignalTypes);
-        const eventSnapshot = [
-          ...this.eventQueue
-        ];
-        this.dirtySignalTypes.clear();
-        this.eventQueue = [];
-        const tasks = [];
-        for (const msg of eventSnapshot) {
-          const systems = interestMap.get(msg.constructor) || [];
-          systems.forEach((s) => {
-            tasks.push(new ExecutionTask(s.fn, s.priority, msg, s.fn.ccsContext));
-          });
-        }
-        const signalFnSet = /* @__PURE__ */ new Set();
-        for (const type of signalSnapshot) {
-          const systems = interestMap.get(type) || [];
-          systems.forEach((s) => {
-            if (!signalFnSet.has(s.fn)) {
-              tasks.push(new ExecutionTask(s.fn, s.priority, this.eventHub.peekSignal(type), s.fn.ccsContext));
-              signalFnSet.add(s.fn);
-            }
-          });
-        }
-        tasks.sort((a, b) => b.priority - a.priority);
-        for (const task of tasks) {
-          try {
-            const result = task.execute(this.beforeHooks, this.afterHooks);
-            if (result instanceof Promise) {
-              result.catch((e) => MessageWriter.error(e, `[Virid Dispatcher] Async Error:
-targetClass:${task.context.targetClass}
-methodName:${task.context.methodName}
-                `));
-            }
-          } catch (e) {
-            MessageWriter.error(e, `[Virid Dispatcher] Sync Error:
-targetClass:${task.context.targetClass}
-methodName:${task.context.methodName}
-                `);
-          }
-        }
-        const processedTypes = new Set(signalSnapshot);
-        eventSnapshot.forEach((m) => processedTypes.add(m.constructor));
-        this.cleanupHook(processedTypes);
-        this.isRunning = false;
-        if (this.dirtySignalTypes.size > 0 || this.eventQueue.length > 0) {
-          this.tick(interestMap);
-        } else {
-          this.tickCount = 0;
-        }
-      } catch (e) {
-        MessageWriter.error(e, "[Virid Dispatcher] Unhandled Error");
-      }
-    });
-  }
-};
-
-// message/eventHub.ts
-var EventHub = class {
-  static {
-    __name(this, "EventHub");
-  }
-  // --- SIGNAL 存储 (分类池) ---
-  signalActive = /* @__PURE__ */ new Map();
-  signalStaging = /* @__PURE__ */ new Map();
-  // --- EVENT 存储 (顺序流) ---
-  eventActive = [];
-  eventStaging = [];
-  /**
-  * 写入逻辑：根据消息策略分流
-  */
-  push(event) {
-    if (event instanceof SingleMessage) {
-      const type = event.constructor;
-      if (!this.signalStaging.has(type)) this.signalStaging.set(type, []);
-      this.signalStaging.get(type).push(event);
-    } else if (event instanceof EventMessage) {
-      this.eventStaging.push(event);
-    } else {
-      MessageWriter.error(new Error(`[Virid Message] Invalid Message:
-${event.constructor.name} must extend SingleMessage or EventMessage`));
-    }
-  }
-  /**
-  * 翻转缓冲区：在 Dispatcher 的 Tick 开始时调用
-  */
-  flip() {
-    this.signalActive = this.signalStaging;
-    this.signalStaging = /* @__PURE__ */ new Map();
-    this.eventActive = this.eventStaging;
-    this.eventStaging = [];
-  }
-  /**
-  * [SIGNAL专用] 批量读取某种类型的信号
-  */
-  peekSignal(type) {
-    return this.signalActive.get(type) || [];
-  }
-  /**
-  * [EVENT专用] 获取当前所有待处理的事件流
-  */
-  getEventStream() {
-    return this.eventActive;
-  }
-  /**
-  * [新增] 根据索引精准读取 EVENT 里的某个数据
-  * 配合 Dispatcher 逐条分发时使用
-  */
-  peekEventAt(index) {
-    return this.eventActive[index];
-  }
-  /**
-  * 清理已处理的内容
-  */
-  clearSignals(types) {
-    types.forEach((type) => this.signalActive.delete(type));
-  }
-  clearEvents() {
-    this.eventActive = [];
-  }
-  /**
-  * 重置所有池子
-  */
-  reset() {
-    this.signalActive.clear();
-    this.signalStaging.clear();
-    this.eventActive = [];
-    this.eventStaging = [];
-  }
-};
-
-// message/registry.ts
-var MessageRegistry = class {
-  static {
-    __name(this, "MessageRegistry");
-  }
-  interestMap = /* @__PURE__ */ new Map();
-  /**
-  * 注册消息并返回一个卸载函数
-  * 这种模式能完美适配 Controller 的生命周期销毁
-  */
-  register(eventClass, systemFn, priority = 0) {
-    const systems = this.interestMap.get(eventClass) || [];
-    const existingIndex = systems.findIndex((s) => s.fn === systemFn);
-    if (existingIndex === -1) {
-      systems.push({
-        fn: systemFn,
-        priority
-      });
-      systems.sort((a, b) => b.priority - a.priority);
-      this.interestMap.set(eventClass, systems);
-    } else {
-      const funcName = systemFn.name || "Anonymous";
-      MessageWriter.error(new Error(`[Virid Error] System Already Registered:
-Class ${eventClass.name}
-Function ${funcName}`));
-      return () => {
-      };
-    }
-    return () => {
-      const currentSystems = this.interestMap.get(eventClass);
-      if (currentSystems) {
-        const index = currentSystems.findIndex((s) => s.fn === systemFn);
-        if (index !== -1) {
-          currentSystems.splice(index, 1);
-          if (currentSystems.length === 0) {
-            this.interestMap.delete(eventClass);
-          }
-        }
-      }
-    };
-  }
-};
-
-// message/internal.ts
-var MessageInternal = class {
-  static {
-    __name(this, "MessageInternal");
-  }
-  eventHub = new EventHub();
-  dispatcher = new Dispatcher(this.eventHub);
-  registry = new MessageRegistry();
-  middlewares = [];
-  constructor() {
-    this.dispatcher.setCleanupHook((processedTypes) => {
-      this.eventHub.clearSignals(processedTypes);
-      this.eventHub.clearEvents();
-    });
-    activatInstance(this);
-  }
-  useMiddleware(mw) {
-    this.middlewares.push(mw);
-  }
-  onBeforeExecute(type, hook) {
-    this.dispatcher.addBefore(type, hook);
-  }
-  onAfterExecute(type, hook) {
-    this.dispatcher.addAfter(type, hook);
-  }
-  /**
-  * 消息进入系统的唯一入口
-  */
-  dispatch(message) {
-    if (!this.registry.interestMap.has(message.constructor)) {
-      MessageWriter.error(new Error(`[Virid Dispatch] No handler for message: ${message.constructor.name}`));
-      return;
-    }
-    this.pipeline(message, () => {
-      this.eventHub.push(message);
-      this.dispatcher.markDirty(message);
-      this.dispatcher.tick(this.registry.interestMap);
-    });
-  }
-  pipeline(message, finalAction) {
-    let index = 0;
-    const next = /* @__PURE__ */ __name(() => {
-      if (index < this.middlewares.length) {
-        this.middlewares[index++](message, next);
-      } else {
-        finalAction();
-      }
-    }, "next");
-    next();
-  }
-};
-
-// app.ts
-var installedPlugins = /* @__PURE__ */ new Set();
-var ViridApp = class {
-  static {
-    __name(this, "ViridApp");
-  }
-  container = new import_inversify.Container();
-  messageInternal = new MessageInternal();
-  bindBase(identifier) {
-    return this.container.bind(identifier).toSelf();
-  }
-  get(identifier) {
-    return this.container.get(identifier);
-  }
-  bindController(identifier) {
-    return this.bindBase(identifier);
-  }
-  bindComponent(identifier) {
-    return this.bindBase(identifier).inSingletonScope();
-  }
-  useMiddleware(mw) {
-    this.messageInternal.useMiddleware(mw);
-  }
-  onBeforeExecute(type, hook) {
-    this.messageInternal.onBeforeExecute(type, hook);
-  }
-  onAfterExecute(type, hook) {
-    this.messageInternal.onAfterExecute(type, hook);
-  }
-  register(eventClass, systemFn, priority = 0) {
-    return this.messageInternal.registry.register(eventClass, systemFn, priority);
-  }
-  use(plugin, options) {
-    if (installedPlugins.has(plugin.name)) {
-      MessageWriter.warn(`[Virid Plugin] Plugin ${plugin.name} has already been installed.`);
-      return this;
-    }
-    try {
-      plugin.install(this, options);
-      installedPlugins.add(plugin.name);
-    } catch (e) {
-      MessageWriter.error(e, `[Virid Plugin] ${plugin.name}`);
-    }
-    return this;
-  }
-};
-var viridApp = new ViridApp();
-function withContext(params, fn, methodName) {
-  const context = {
-    params,
-    targetClass: Object,
-    methodName,
-    originalMethod: fn
-  };
-  fn.ccsContext = context;
-  return fn;
-}
-__name(withContext, "withContext");
-var clr = {
-  reset: "\x1B[0m",
-  red: "\x1B[31m",
-  yellow: "\x1B[33m",
-  blue: "\x1B[34m",
-  magenta: "\x1B[35m",
-  cyan: "\x1B[36m",
-  gray: "\x1B[90m",
-  bold: "\x1B[1m"
-};
-var globalErrorHandler = /* @__PURE__ */ __name((err) => {
-  const header = `${clr.red}${clr.bold} \u2716 [Virid Error] ${clr.reset}`;
-  const context = `${clr.magenta}${err.context}${clr.reset}`;
-  console.error(`${header}${clr.gray}Global Error Caught:${clr.reset}
-  ${clr.red}Context:${clr.reset} ${context}
-  ${clr.red}Details:${clr.reset}`, err.error || "Unknown Error");
-}, "globalErrorHandler");
-viridApp.register(ErrorMessage, withContext(ErrorMessage, globalErrorHandler, "GlobalErrorHandler"), -999);
-var globalWarnHandler = /* @__PURE__ */ __name((warn) => {
-  const header = `${clr.yellow}${clr.bold} \u26A0 [Virid Warn] ${clr.reset}`;
-  const context = `${clr.cyan}${warn.context}${clr.reset}`;
-  console.warn(`${header}${clr.gray}Global Warn Caught:${clr.reset}
-  ${clr.yellow}Context:${clr.reset} ${context}`);
-}, "globalWarnHandler");
-viridApp.register(WarnMessage, withContext(WarnMessage, globalWarnHandler, "GlobalWarnHandler"), -999);
-var atomicModifyHandler = /* @__PURE__ */ __name((modifications) => {
-  const rawComponent = viridApp.container.get(modifications.ComponentClass);
-  if (!rawComponent) {
-    console.error(`[Virid Modify] Component Not Found:
- Component ${modifications.ComponentClass.name} not found in Registry.`);
-    return;
-  }
-  try {
-    modifications.recipe(rawComponent);
-    MessageWriter.warn(`[Virid Modify] Successfully:
-Modify on ${modifications.ComponentClass.name}
-label: ${modifications.label}`);
-  } catch (e) {
-    MessageWriter.error(e, `[Virid Error] Modify Failed:
-${modifications.label}`);
-  }
-}, "atomicModifyHandler");
-viridApp.register(AtomicModifyMessage, withContext(AtomicModifyMessage, atomicModifyHandler, "GlobalAtomicModifier"), 1e3);
-
-// decorators/constants.ts
-var virid_METADATA = {
-  SYSTEM: "virid:system_metadata",
-  MESSAGE: "virid:message",
-  CONTROLLER: "virid:controller",
-  COMPONENT: "virid:component"
-};
-
-// decorators/ccs.ts
-var import_inversify2 = require("inversify");
-var import_reflect_metadata = require("reflect-metadata");
-function System(priority = 0) {
-  return (target, key, descriptor) => {
-    const originalMethod = descriptor.value;
-    const types = Reflect.getMetadata("design:paramtypes", target, key) || [];
-    if (types.length === 0) {
-      MessageWriter.error(new Error(`[Virid System] System Parameter Loss:
-Unable to recognize system parameters, please confirm if import "reflection-metadata" was introduced at the beginning!`));
-    }
-    const readerConfigs = Reflect.getMetadata(virid_METADATA.MESSAGE, target, key) || [];
-    if (readerConfigs.length > 1) {
-      MessageWriter.warn(`[Virid System] Multiple Messages Are Not Allowed: ${key} has multiple @Message() decorators!`);
-      return;
-    }
-    const wrappedSystem = /* @__PURE__ */ __name(function(currentMessage) {
-      const args = types.map((type, index) => {
-        const config = readerConfigs.find((c) => c.index === index);
-        if (config) {
-          const { eventClass, single } = config;
-          const sample = Array.isArray(currentMessage) ? currentMessage[0] : currentMessage;
-          if (!(sample instanceof eventClass)) {
-            MessageWriter.error(new Error(`[Virid System] Type Mismatch: Expected ${eventClass.name}, but received ${sample?.constructor.name}`));
-            return null;
-          }
-          if (sample instanceof SingleMessage) {
-            if (single) {
-              return Array.isArray(currentMessage) ? currentMessage[currentMessage.length - 1] : currentMessage;
-            }
-            return Array.isArray(currentMessage) ? currentMessage : [
-              currentMessage
-            ];
-          }
-          if (sample instanceof EventMessage) {
-            return currentMessage;
-          }
-          return currentMessage;
-        }
-        const param = viridApp.get(type);
-        if (!param) MessageWriter.error(new Error(`[Virid System] Unknown Inject Data Types: ${type.name} is not registered in the container!`));
-        return param;
-      });
-      const result = originalMethod(...args);
-      const handleResult = /* @__PURE__ */ __name((res) => {
-        if (!res) return;
-        const messages = Array.isArray(res) ? res : [
-          res
-        ];
-        messages.forEach((m) => {
-          if (m instanceof BaseMessage) {
-            MessageWriter.write(m);
-          }
-        });
-      }, "handleResult");
-      return result instanceof Promise ? result.then(handleResult) : handleResult(result);
-    }, "wrappedSystem");
-    const taskContext = {
-      params: types,
-      targetClass: target,
-      methodName: key,
-      originalMethod
-    };
-    wrappedSystem.ccsContext = taskContext;
-    descriptor.value = wrappedSystem;
-    readerConfigs.forEach((config) => {
-      viridApp.register(config.eventClass, wrappedSystem, priority);
-    });
-  };
-}
-__name(System, "System");
-function Message(eventClass, single = true) {
-  return (target, key, index) => {
-    const configs = Reflect.getMetadata(virid_METADATA.MESSAGE, target, key) || [];
-    configs.push({
-      index,
-      eventClass,
-      single
-    });
-    Reflect.defineMetadata(virid_METADATA.MESSAGE, configs, target, key);
-  };
-}
-__name(Message, "Message");
-function Controller() {
-  return (target) => {
-    (0, import_inversify2.injectable)()(target);
-    Reflect.defineMetadata(virid_METADATA.CONTROLLER, true, target);
-  };
-}
-__name(Controller, "Controller");
-function Component() {
-  return (target) => {
-    (0, import_inversify2.injectable)()(target);
-    Reflect.defineMetadata(virid_METADATA.COMPONENT, true, target);
-  };
-}
-__name(Component, "Component");
-
-// index.ts
-function createVirid() {
-  return viridApp;
-}
-__name(createVirid, "createVirid");
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  AtomicModifyMessage,
-  BaseMessage,
-  Component,
-  Controller,
-  ErrorMessage,
-  EventMessage,
-  Message,
-  MessageInternal,
-  MessageWriter,
-  SingleMessage,
-  System,
-  WarnMessage,
-  activatInstance,
-  createVirid,
-  publisher
-});
+/**
+ *  @virid/core v0.0.1
+ *  A lightweight and powerful message core built using dependency injection and CCS concepts
+ */
+var se=Object.defineProperty;var he=(s,e,t)=>e in s?se(s,e,{enumerable:!0,configurable:!0,writable:!0,value:t}):s[e]=t;var o=(s,e)=>se(s,"name",{value:e,configurable:!0});var i=(s,e,t)=>he(s,typeof e!="symbol"?e+"":e,t);var G=class G{static send(...e){a.write(this,...e)}};o(G,"BaseMessage");var y=G,j=class j extends y{constructor(){super();i(this,"__kind","SingleMessage")}};o(j,"SingleMessage");var x=j,L=class L extends y{constructor(){super();i(this,"__kind","EventMessage")}};o(L,"EventMessage");var g=L,W=class W extends g{constructor(t,r){super();i(this,"error");i(this,"context");this.error=t,this.context=r}};o(W,"ErrorMessage");var v=W,F=class F extends g{constructor(t){super();i(this,"context");this.context=t}};o(F,"WarnMessage");var b=F,Q=class Q extends g{constructor(t){super();i(this,"context");this.context=t}};o(Q,"InfoMessage");var S=Q,z=class z extends g{constructor(t,r,n){super();i(this,"ComponentClass");i(this,"recipe");i(this,"label");this.ComponentClass=t,this.recipe=r,this.label=n}};o(z,"AtomicModifyMessage");var M=z;var V=null;function ne(s){V=s}o(ne,"activateInstance");var ue=new Proxy({},{get(s,e){return e==="dispatch"?t=>{if(!V){console.error(`[Virid] Message dispatched before system init: ${t.constructor.name}`);return}return V.dispatch(t)}:Reflect.get(V||{},e)}}),U=class U{static write(e,...t){let r=typeof e=="function"?new e(...t):e;ue.dispatch(r)}static error(e,t=""){this.write(new v(e,t))}static warn(e){this.write(new b(e))}static info(e){this.write(new S(e))}};o(U,"MessageWriter");var a=U;var J=class J{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 g?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==0&&(this.tickPayload={},this.executeTickHooks(this.beforeTickHooks));let n=this.prepareSnapshot();t=n.signalSnapshot,r=n.eventSnapshot;let u=this.collectTasks(r,t,e);this.executeTasks(u)}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(f=>{n.push(new D(f.fn,f.priority,l,{context:f.fn.systemContext,tick:this.globalTick,payload:{}}))});let u=new Set;for(let l of t)(r.get(l)||[]).forEach(f=>{u.has(f.fn)||(n.push(new D(f.fn,f.priority,this.eventHub.peekSignal(l),{context:f.fn.systemContext,tick:this.globalTick,payload:{}})),u.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.
+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.
+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(J,"Dispatcher");var I=J,Y=class Y{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(u=>{a.error(u,`[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(Y,"ExecutionTask");var D=Y;var q=class q{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 g?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(q,"EventHub");var O=q;var K=class K{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,d)=>d.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 d=l.findIndex(f=>f.fn===t);d!==-1&&(l.splice(d,1),l.length===0&&this.systemTaskMap.delete(e))}}}};o(K,"MessageRegistry");var A=K;var X=class X{constructor(){i(this,"eventHub",new O);i(this,"dispatcher",new I(this.eventHub));i(this,"registry",new A);i(this,"middlewares",[]);ne(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(X,"MessageInternal");var $=X;var Z=class Z{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,d=t(l);this.singletonInstances.set(e,d)}return this.singletonInstances.get(e)}let u=new n;return t(u)}};o(Z,"ViridContainer");var P=Z;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 N(s,e,t){let r={params:s,targetClass:Object,methodName:t,originalMethod:e};return e.ccsContext=r,e}o(N,"withContext");var de=o(s=>{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"),fe=o(s=>{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"),pe=o(s=>{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"),ge=o(s=>{let e=T.get(s.ComponentClass);if(!e){console.error(`[Virid Modify] Component Not Found:
+ Component ${s.ComponentClass.name} not found in Registry.`);return}try{s.recipe(e),a.warn(`[Virid Modify] Successfully:
+Modify on ${s.ComponentClass.name}
+label: ${s.label}`)}catch(t){a.error(t,`[Virid Error] Modify Failed:
+${s.label}`)}},"atomicModifyHandler");function oe(s){s.register(M,N(M,ge,"GlobalAtomicModifier"),1e3),s.register(b,N(b,pe,"GlobalWarnHandler"),-999),s.register(v,N(v,fe,"GlobalErrorHandler"),-999),s.register(S,N(S,de,"GlobalInfoHandler"),-999),T=s}o(oe,"initializeGlobalSystems");var T=null,qe=new Proxy({},{get(s,e){return(...t)=>{if(!T){console.warn(`[Virid Vue] App method "${String(e)}" called before initialization.`);return}let r=T[e];if(typeof r=="function")return r.apply(T,t)}}});var ie=new Set,te=class te{constructor(){i(this,"container",new P);i(this,"messageInternal",new $);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(te,"ViridApp");var ee=te,k=new ee;k.addActivationHook(_);oe(k);var m={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 C=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)=>{let n=r.value,u=Reflect.getMetadata("design:paramtypes",e,t),l=Reflect.getMetadata(m.MESSAGE,e,t)||null;if(!u){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(u.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: ${u.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 d=o(h=>{let w=u.map((H,ae)=>{if(l&&l.index==ae){let{messageClass:B,single:ce}=l,R=Array.isArray(h)?h[0]:h;if(!(R instanceof B)){let le=R.constructor.name;throw new Error(`[Virid System] Type Mismatch: Expected ${B.name}, but received ${le}`)}if(R instanceof x)return ce?Array.isArray(h)?h[h.length-1]:h:Array.isArray(h)?h:[h];if(R instanceof g)return h;throw new Error(`[Virid System] unknown Message Types: Message ${B.name} is not a subclass of SingleMessage or EventMessage!`)}let re=k.get(H);if(!re)throw new Error(`[Virid System] unknown Inject Data Types: ${H.name} is not registered in the container!`);return re}),E=n.apply(e,w);return E instanceof Promise?E.then(C):C(E)},"wrappedSystem"),f={params:u,targetClass:e,methodName:t,originalMethod:n};d.systemContext=f,r.value=d;let p=s.messageClass||l.messageClass;k.register(p,d,s.priority)}}o(lt,"System");function ht(s,e=!0){return(t,r,n)=>{if(Reflect.hasOwnMetadata(m.MESSAGE,t,r)){a.error(new Error(`[Virid Message] Multiple Messages Are Not Allowed: ${r} has multiple @Message() decorators!`));return}let u={index:n,messageClass:s,single:e};Reflect.defineMetadata(m.MESSAGE,u,t,r)}}o(ht,"Message");function ut(){return(s,e,t)=>{let r=Reflect.getMetadata(m.SAFE,s)||new Set;r.add(e),Reflect.defineMetadata(m.SAFE,r,s)}}o(ut,"Safe");function dt(s,[]){return(e,t)=>{let r=Reflect.getMetadata(m.OBSERVER,e)||[];r.push({key:t,callback:s}),Reflect.defineMetadata(m.OBSERVER,r,e)}}o(dt,"Observer");function ft(){return s=>{Reflect.defineMetadata(m.CONTROLLER,!0,s)}}o(ft,"Controller");function pt(){return s=>{Reflect.defineMetadata(m.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(m.OBSERVER,s.constructor)||[]).forEach(({propertyKey:t,callback:r})=>{let n={value:s[t]},u=new Proxy(n,{get(d,f){let p=d.value;return Array.isArray(p)&&me.includes(f)?(...h)=>{let w=[...p],E=p[f].apply(p,h),H=r.call(s,w,p);return C(H),E}:p},set(d,f,p){let h=d.value;if(p===h)return!0;d.value=p;let w=r.call(s,h,p);return C(w),!0}}),l=o(()=>u.value,"getter");l.__virid_box__=n,Object.defineProperty(s,t,{get:l,set:o(d=>{u.value=d},"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");function Ct(){return k}o(Ct,"createVirid");export{M as AtomicModifyMessage,y as BaseMessage,pt as Component,ft as Controller,v as ErrorMessage,g as EventMessage,S as InfoMessage,ht as Message,$ as MessageInternal,A as MessageRegistry,a as MessageWriter,dt as Observer,ut as Safe,x as SingleMessage,lt as System,m as VIRID_METADATA,b as WarnMessage,ne as activateInstance,_ as bindObservers,Ct as createVirid,C as handleResult,ue as publisher};
+//# sourceMappingURL=index.js.map