@maxax/x-plugins-mitt 1.0.0

package/dist/index.mjs

@@ -0,0 +1,252 @@
+var __defProp = Object.defineProperty;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
+
+// src/core.ts
+import mitt from "mitt";
+var MaxEventBus = class {
+  constructor() {
+    __publicField(this, "emitter");
+    this.emitter = mitt();
+  }
+  /**
+   * 发布事件
+   * @param type 事件类型
+   * @param data 事件数据
+   */
+  emit(type, data) {
+    this.emitter.emit(type, data);
+  }
+  /**
+   * 发布事件（不指定类型）
+   * @param type 事件类型
+   * @param data 事件数据
+   */
+  emitWithout(type) {
+    this.emitter.emit(type);
+  }
+  /**
+   * 订阅事件
+   * @param event 事件名称
+   * @param callback 回调函数
+   * @returns 取消订阅函数
+   */
+  on(event, callback) {
+    this.emitter.on(event, callback);
+    return () => this.off(event, callback);
+  }
+  /**
+   * 订阅所有事件
+   * @param type 事件类型
+   * @param handler 回调函数
+   * @returns 取消订阅函数
+   */
+  onBoth(handler) {
+    this.emitter.on("*", handler);
+    return () => this.offBoth("*", handler);
+  }
+  /**
+   * 订阅事件（只触发一次）
+   * @param event 事件名称
+   * @param callback 回调函数
+   */
+  once(event, callback) {
+    const wrapper = (data) => {
+      this.off(event, wrapper);
+      callback(data);
+    };
+    this.emitter.on(event, wrapper);
+    return () => this.off(event, wrapper);
+  }
+  /**
+   * 取消订阅
+   * @param event 事件名称
+   * @param callback 回调函数（可选，不传则取消所有该事件的监听器）
+   */
+  off(event, callback) {
+    this.emitter.off(event, callback);
+  }
+  /**
+   * 取消订阅所有事件
+   * @param type 事件类型
+   * @param handler 回调函数
+   */
+  offBoth(type, handler) {
+    this.emitter.off(type, handler);
+  }
+  /**
+   * 清空所有监听器
+   */
+  clear() {
+    var _a;
+    (_a = this.emitter.all) == null ? void 0 : _a.clear();
+  }
+};
+var eventBusInstance = null;
+function getEventBus() {
+  if (!eventBusInstance) {
+    eventBusInstance = new MaxEventBus();
+  }
+  return eventBusInstance;
+}
+function createEventBus() {
+  return new MaxEventBus();
+}
+function resetEventBus() {
+  if (eventBusInstance) {
+    eventBusInstance.clear();
+    eventBusInstance = null;
+  }
+}
+
+// src/manager.ts
+var MaxEventBusManager = class {
+  constructor() {
+    __publicField(this, "masterEventBus");
+    __publicField(this, "slaveEventBus", /* @__PURE__ */ new Map());
+    this.masterEventBus = createEventBus();
+  }
+  /**
+   * 获取主应用事件总线实例
+   */
+  getMasterBus() {
+    return this.masterEventBus;
+  }
+  /**
+   * 注册子应用事件总线
+   * @param appName 子应用名称
+   * @param masterEventBus 子应用的事件总线实例
+   */
+  registerSlaveBus(appName, masterEventBus) {
+    this.slaveEventBus.set(appName, masterEventBus);
+  }
+  /**
+   * 注销子应用事件总线
+   * @param appName 子应用名称
+   */
+  unregisterSlaveBus(appName) {
+    this.slaveEventBus.delete(appName);
+  }
+  /**
+   * 向所有应用（主应用 + 子应用）广播事件
+   * @param event 事件名称
+   * @param data 事件数据
+   */
+  broadcast(event, data) {
+    this.masterEventBus.emit(event, data);
+    this.slaveEventBus.forEach((bus) => {
+      bus.emit(event, data);
+    });
+  }
+  /**
+   * 向主应用发送事件
+   * @param event 事件名称
+   * @param data 事件数据
+   */
+  toMaster(event, data) {
+    this.masterEventBus.emit(event, data);
+  }
+  /**
+   * 向特定子应用发送事件
+   * @param appName 子应用名称
+   * @param event 事件名称
+   * @param data 事件数据
+   */
+  toSlave(appName, event, data) {
+    const bus = this.slaveEventBus.get(appName);
+    if (bus) {
+      bus.emit(event, data);
+    }
+  }
+  /**
+   * 向多个子应用发送事件
+   * @param appNames 子应用名称列表
+   * @param event 事件名称
+   * @param data 事件数据
+   */
+  toSlaves(appNames, event, data) {
+    appNames.forEach((appName) => {
+      this.toSlave(appName, event, data);
+    });
+  }
+  /**
+   * 监听主应用事件
+   * @param event 事件名称
+   * @param callback 回调函数
+   */
+  onMaster(event, callback) {
+    return this.masterEventBus.on(event, callback);
+  }
+  /**
+   * 监听来自特定子应用的事件
+   * @param appName 子应用名称
+   * @param event 事件名称
+   * @param callback 回调函数
+   */
+  onSlave(appName, event, callback) {
+    const bus = this.slaveEventBus.get(appName);
+    if (bus) {
+      return bus.on(event, callback);
+    }
+    return () => {
+    };
+  }
+  /**
+   * 监听所有子应用事件（任何子应用发送的事件）
+   * @param event 事件名称
+   * @param callback 回调函数
+   */
+  onAnySlave(event, callback) {
+    const unSubscribers = [];
+    this.slaveEventBus.forEach((bus, name) => {
+      const unSub = bus.on(event, (data) => callback(data, name));
+      unSubscribers.push(unSub);
+    });
+    return () => {
+      unSubscribers.forEach((unSub) => unSub());
+    };
+  }
+  /**
+   * 获取已注册的子应用列表
+   */
+  getRegisteredApps() {
+    return Array.from(this.slaveEventBus.keys());
+  }
+  /**
+   * 清空所有监听器
+   */
+  clear() {
+    this.masterEventBus.clear();
+    this.slaveEventBus.forEach((bus) => bus.clear());
+  }
+  /**
+   * 销毁管理器
+   */
+  destroy() {
+    this.clear();
+    this.slaveEventBus.clear();
+  }
+};
+var managerInstance = null;
+function getMaxEventBusManager() {
+  if (!managerInstance) {
+    managerInstance = new MaxEventBusManager();
+  }
+  return managerInstance;
+}
+function resetMaxEventBusManager() {
+  if (managerInstance) {
+    managerInstance.destroy();
+    managerInstance = null;
+  }
+}
+export {
+  MaxEventBus,
+  MaxEventBusManager,
+  createEventBus,
+  getEventBus,
+  getMaxEventBusManager,
+  resetEventBus,
+  resetMaxEventBusManager
+};
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/core.ts","../src/manager.ts"],"sourcesContent":["import type { Emitter, Handler, WildcardHandler } from 'mitt'\nimport mitt from 'mitt'\nimport type { MaxEvents } from './types'\n/**\n * Mitt 事件总线核心实现\n */\nexport class MaxEventBus {\n  private emitter: Emitter<MaxEvents>\n\n  constructor() {\n    this.emitter = mitt<MaxEvents>()\n  }\n\n  /**\n   * 发布事件\n   * @param type 事件类型\n   * @param data 事件数据\n   */\n  emit<Key extends keyof MaxEvents>(type: Key, data: MaxEvents[Key]): void {\n    this.emitter.emit(type, data)\n  }\n\n  /**\n   * 发布事件（不指定类型）\n   * @param type 事件类型\n   * @param data 事件数据\n   */\n  emitWithout<Key extends keyof MaxEvents>(type: undefined extends MaxEvents[Key] ? Key : never): void {\n    this.emitter.emit(type)\n  }\n\n  /**\n   * 订阅事件\n   * @param event 事件名称\n   * @param callback 回调函数\n   * @returns 取消订阅函数\n   */\n  on<Key extends keyof MaxEvents>(event: Key, callback: Handler<MaxEvents[Key]>): () => void {\n    this.emitter.on(event, callback)\n    return () => this.off(event, callback)\n  }\n\n  /**\n   * 订阅所有事件\n   * @param type 事件类型\n   * @param handler 回调函数\n   * @returns 取消订阅函数\n   */\n  onBoth(handler: WildcardHandler<MaxEvents>): () => void {\n    this.emitter.on('*', handler)\n    return () => this.offBoth('*', handler)\n  }\n\n  /**\n   * 订阅事件（只触发一次）\n   * @param event 事件名称\n   * @param callback 回调函数\n   */\n  once<Key extends keyof MaxEvents>(event: Key, callback: Handler<MaxEvents[Key]>): () => void {\n    const wrapper: Handler<MaxEvents[Key]> = (data: MaxEvents[Key]) => {\n      this.off(event, wrapper)\n      callback(data)\n    }\n    this.emitter.on(event, wrapper)\n    return () => this.off(event, wrapper)\n  }\n\n  /**\n   * 取消订阅\n   * @param event 事件名称\n   * @param callback 回调函数（可选，不传则取消所有该事件的监听器）\n   */\n  off<Key extends keyof MaxEvents>(event: Key, callback?: Handler<MaxEvents[Key]>): void {\n    this.emitter.off(event, callback)\n  }\n\n  /**\n   * 取消订阅所有事件\n   * @param type 事件类型\n   * @param handler 回调函数\n   */\n  offBoth(type: '*', handler: WildcardHandler<MaxEvents>): void {\n    this.emitter.off(type, handler)\n  }\n\n  /**\n   * 清空所有监听器\n   */\n  clear(): void {\n    this.emitter.all?.clear()\n  }\n}\n\n// 导出单例实例工厂\nlet eventBusInstance: MaxEventBus | null = null\n\n/**\n * 获取事件总线单例\n */\nexport function getEventBus() {\n  if (!eventBusInstance) {\n    eventBusInstance = new MaxEventBus()\n  }\n  return eventBusInstance\n}\n\n/**\n * 创建新的事件总线实例\n */\nexport function createEventBus() {\n  return new MaxEventBus()\n}\n\n/**\n * 重置事件总线单例\n */\nexport function resetEventBus(): void {\n  if (eventBusInstance) {\n    eventBusInstance.clear()\n    eventBusInstance = null\n  }\n}\n","import type { MaxEventBus } from './core'\nimport { createEventBus } from './core'\n\n/**\n * 主应用事件总线管理器\n * 负责在主应用中创建和分发事件总线给子应用\n */\nclass MaxEventBusManager {\n  private masterEventBus: MaxEventBus\n  private slaveEventBus: Map<string, MaxEventBus> = new Map()\n\n  constructor() {\n    this.masterEventBus = createEventBus()\n  }\n\n  /**\n   * 获取主应用事件总线实例\n   */\n  getMasterBus(): MaxEventBus {\n    return this.masterEventBus\n  }\n\n  /**\n   * 注册子应用事件总线\n   * @param appName 子应用名称\n   * @param masterEventBus 子应用的事件总线实例\n   */\n  registerSlaveBus(appName: string, masterEventBus: MaxEventBus): void {\n    this.slaveEventBus.set(appName, masterEventBus)\n  }\n\n  /**\n   * 注销子应用事件总线\n   * @param appName 子应用名称\n   */\n  unregisterSlaveBus(appName: string): void {\n    this.slaveEventBus.delete(appName)\n  }\n\n  /**\n   * 向所有应用（主应用 + 子应用）广播事件\n   * @param event 事件名称\n   * @param data 事件数据\n   */\n  broadcast<K extends string>(event: K, data?: any): void {\n    // 主应用\n    this.masterEventBus.emit(event, data)\n\n    // 所有子应用\n    this.slaveEventBus.forEach(bus => {\n      bus.emit(event, data)\n    })\n  }\n\n  /**\n   * 向主应用发送事件\n   * @param event 事件名称\n   * @param data 事件数据\n   */\n  toMaster<K extends string>(event: K, data?: any): void {\n    this.masterEventBus.emit(event, data)\n  }\n\n  /**\n   * 向特定子应用发送事件\n   * @param appName 子应用名称\n   * @param event 事件名称\n   * @param data 事件数据\n   */\n  toSlave<K extends string>(appName: string, event: K, data?: any): void {\n    const bus = this.slaveEventBus.get(appName)\n    if (bus) {\n      bus.emit(event, data)\n    }\n  }\n\n  /**\n   * 向多个子应用发送事件\n   * @param appNames 子应用名称列表\n   * @param event 事件名称\n   * @param data 事件数据\n   */\n  toSlaves<K extends string>(appNames: string[], event: K, data?: any): void {\n    appNames.forEach(appName => {\n      this.toSlave(appName, event, data)\n    })\n  }\n\n  /**\n   * 监听主应用事件\n   * @param event 事件名称\n   * @param callback 回调函数\n   */\n  onMaster<K extends string>(event: K, callback: (data: any) => void): () => void {\n    return this.masterEventBus.on(event, callback)\n  }\n\n  /**\n   * 监听来自特定子应用的事件\n   * @param appName 子应用名称\n   * @param event 事件名称\n   * @param callback 回调函数\n   */\n  onSlave<K extends string>(appName: string, event: K, callback: (data: any) => void): () => void {\n    const bus = this.slaveEventBus.get(appName)\n    if (bus) {\n      return bus.on(event, callback)\n    }\n    return () => {\n      //\n    }\n  }\n\n  /**\n   * 监听所有子应用事件（任何子应用发送的事件）\n   * @param event 事件名称\n   * @param callback 回调函数\n   */\n  onAnySlave<K extends string>(event: K, callback: (data: any, appName: string) => void): () => void {\n    const unSubscribers: (() => void)[] = []\n\n    this.slaveEventBus.forEach((bus, name) => {\n      const unSub = bus.on(event, data => callback(data, name))\n      unSubscribers.push(unSub)\n    })\n\n    // 返回取消所有订阅的函数\n    return () => {\n      unSubscribers.forEach(unSub => unSub())\n    }\n  }\n\n  /**\n   * 获取已注册的子应用列表\n   */\n  getRegisteredApps(): string[] {\n    return Array.from(this.slaveEventBus.keys())\n  }\n\n  /**\n   * 清空所有监听器\n   */\n  clear(): void {\n    this.masterEventBus.clear()\n    this.slaveEventBus.forEach(bus => bus.clear())\n  }\n\n  /**\n   * 销毁管理器\n   */\n  destroy(): void {\n    this.clear()\n    this.slaveEventBus.clear()\n  }\n}\n\n// 单例实例\nlet managerInstance: MaxEventBusManager | null = null\n\n/**\n * 获取主应用事件总线管理器单例\n */\nexport function getMaxEventBusManager(): MaxEventBusManager {\n  if (!managerInstance) {\n    managerInstance = new MaxEventBusManager()\n  }\n  return managerInstance\n}\n\n/**\n * 重置管理器单例\n */\nexport function resetMaxEventBusManager(): void {\n  if (managerInstance) {\n    managerInstance.destroy()\n    managerInstance = null\n  }\n}\n\nexport { MaxEventBusManager }\n"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "@maxax/x-plugins-mitt",
+  "version": "1.0.0",
+  "description": "A lightweight event bus wrapper based on mitt for Maxax projects",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "sideEffects": false,
+  "keywords": [
+    "event-bus",
+    "events",
+    "mitt",
+    "emitter",
+    "maxax"
+  ],
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "mitt": "^3.0.1"
+  },
+  "scripts": {
+    "bump-version": "maxax bump-version",
+    "dev": "tsup --watch",
+    "build": "tsup",
+    "clean": "rm -rf dist"
+  }
+}