@esengine/ecs-framework 2.2.21 → 2.3.0

package/bin/Core/DI/Decorators.d.ts

@@ -0,0 +1,206 @@
+/**
+ * 依赖注入装饰器
+ *
+ * 提供 @Injectable、@InjectProperty 和 @Updatable 装饰器，用于标记可注入的类和依赖注入点
+ */
+import type { ServiceContainer } from '../ServiceContainer';
+import type { IService, ServiceType } from '../ServiceContainer';
+/**
+ * 依赖注入元数据存储
+ */
+type Constructor = abstract new (...args: unknown[]) => unknown;
+/**
+ * 可注入元数据接口
+ */
+export interface InjectableMetadata {
+    /**
+     * 是否可注入
+     */
+    injectable: boolean;
+    /**
+     * 依赖列表
+     */
+    dependencies: Array<ServiceType<IService> | string | symbol>;
+    /**
+     * 属性注入映射
+     * key: 属性名, value: 服务类型
+     */
+    properties?: Map<string | symbol, ServiceType<IService>>;
+}
+/**
+ * 可更新元数据接口
+ */
+export interface UpdatableMetadata {
+    /**
+     * 是否可更新
+     */
+    updatable: boolean;
+    /**
+     * 更新优先级（数值越小越先执行，默认0）
+     */
+    priority: number;
+}
+/**
+ * @Injectable() 装饰器
+ *
+ * 标记类为可注入的服务，使其可以通过ServiceContainer进行依赖注入
+ *
+ * @example
+ * ```typescript
+ * @Injectable()
+ * class TimeService implements IService {
+ *     constructor() {}
+ *     dispose() {}
+ * }
+ *
+ * @Injectable()
+ * class PhysicsSystem extends EntitySystem {
+ *     @InjectProperty(TimeService)
+ *     private timeService!: TimeService;
+ *
+ *     constructor() {
+ *         super(Matcher.empty());
+ *     }
+ * }
+ * ```
+ */
+export declare function Injectable(): ClassDecorator;
+/**
+ * @Updatable() 装饰器
+ *
+ * 标记服务类为可更新的，使其在每帧自动被ServiceContainer调用update方法。
+ * 使用此装饰器的类必须实现IUpdatable接口（包含update方法）。
+ *
+ * @param priority - 更新优先级（数值越小越先执行，默认0）
+ * @throws 如果类没有实现update方法，将在运行时抛出错误
+ *
+ * @example
+ * ```typescript
+ * @Injectable()
+ * @Updatable()
+ * class TimerManager implements IService, IUpdatable {
+ *     update(deltaTime?: number) {
+ *         // 每帧更新逻辑
+ *     }
+ *     dispose() {}
+ * }
+ *
+ * // 指定优先级
+ * @Injectable()
+ * @Updatable(10)
+ * class PhysicsManager implements IService, IUpdatable {
+ *     update() { }
+ *     dispose() {}
+ * }
+ * ```
+ */
+export declare function Updatable(priority?: number): ClassDecorator;
+/**
+ * @InjectProperty() 装饰器
+ *
+ * 通过属性装饰器注入依赖
+ *
+ * 注入时机：在构造函数执行后、onInitialize() 调用前完成
+ *
+ * @param serviceType 服务类型
+ *
+ * @example
+ * ```typescript
+ * @Injectable()
+ * class PhysicsSystem extends EntitySystem {
+ *     @InjectProperty(TimeService)
+ *     private timeService!: TimeService;
+ *
+ *     @InjectProperty(CollisionService)
+ *     private collision!: CollisionService;
+ *
+ *     constructor() {
+ *         super(Matcher.empty());
+ *     }
+ *
+ *     public onInitialize(): void {
+ *         // 此时属性已注入完成，可以安全使用
+ *         console.log(this.timeService.getDeltaTime());
+ *     }
+ * }
+ * ```
+ */
+export declare function InjectProperty(serviceType: ServiceType<IService>): PropertyDecorator;
+/**
+ * 检查类是否标记为可注入
+ *
+ * @param target 目标类
+ * @returns 是否可注入
+ */
+export declare function isInjectable(target: Constructor): boolean;
+/**
+ * 获取类的依赖注入元数据
+ *
+ * @param target 目标类
+ * @returns 依赖注入元数据
+ */
+export declare function getInjectableMetadata(target: Constructor): InjectableMetadata | undefined;
+/**
+ * 获取属性注入元数据
+ *
+ * @param target 目标类
+ * @returns 属性名到服务类型的映射
+ */
+export declare function getPropertyInjectMetadata(target: Constructor): Map<string | symbol, ServiceType<IService>>;
+/**
+ * 创建实例并自动注入依赖
+ *
+ * @param constructor 构造函数
+ * @param container 服务容器
+ * @returns 创建的实例
+ *
+ * @example
+ * ```typescript
+ * const instance = createInstance(MySystem, container);
+ * ```
+ */
+export declare function createInstance<T>(constructor: new (...args: any[]) => T, container: ServiceContainer): T;
+/**
+ * 为实例注入属性依赖
+ *
+ * @param instance 目标实例
+ * @param container 服务容器
+ */
+export declare function injectProperties<T extends object>(instance: T, container: ServiceContainer): void;
+/**
+ * 检查类是否标记为可更新
+ *
+ * @param target 目标类
+ * @returns 是否可更新
+ */
+export declare function isUpdatable(target: Constructor): boolean;
+/**
+ * 获取类的可更新元数据
+ *
+ * @param target 目标类
+ * @returns 可更新元数据
+ */
+export declare function getUpdatableMetadata(target: Constructor): UpdatableMetadata | undefined;
+/**
+ * 注册可注入的服务到容器
+ *
+ * 自动检测@Injectable装饰器并注册服务
+ *
+ * @param container 服务容器
+ * @param serviceType 服务类型
+ * @param singleton 是否注册为单例（默认true）
+ *
+ * @example
+ * ```typescript
+ * @Injectable()
+ * class MyService implements IService {
+ *     dispose() {}
+ * }
+ *
+ * // 自动注册
+ * registerInjectable(Core.services, MyService);
+ * ```
+ */
+export declare function registerInjectable<T extends IService>(container: ServiceContainer, serviceType: ServiceType<T>, singleton?: boolean): void;
+export {};
+//# sourceMappingURL=Decorators.d.ts.map

package/bin/Core/DI/Decorators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Decorators.d.ts","sourceRoot":"","sources":["../../../src/Core/DI/Decorators.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAEjE;;GAEG;AACH,KAAK,WAAW,GAAG,QAAQ,MAAM,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC;AAKhE;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAC/B;;OAEG;IACH,UAAU,EAAE,OAAO,CAAC;IAEpB;;OAEG;IACH,YAAY,EAAE,KAAK,CAAC,WAAW,CAAC,QAAQ,CAAC,GAAG,MAAM,GAAG,MAAM,CAAC,CAAC;IAE7D;;;OAGG;IACH,UAAU,CAAC,EAAE,GAAG,CAAC,MAAM,GAAG,MAAM,EAAE,WAAW,CAAC,QAAQ,CAAC,CAAC,CAAC;CAC5D;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAC9B;;OAEG;IACH,SAAS,EAAE,OAAO,CAAC;IAEnB;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,UAAU,IAAI,cAAc,CAU3C;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,SAAS,CAAC,QAAQ,GAAE,MAAU,GAAG,cAAc,CAiB9D;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAgB,cAAc,CAAC,WAAW,EAAE,WAAW,CAAC,QAAQ,CAAC,GAAG,iBAAiB,CAkBpF;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAGzD;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,WAAW,GAAG,kBAAkB,GAAG,SAAS,CAEzF;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,WAAW,GAAG,GAAG,CAAC,MAAM,GAAG,MAAM,EAAE,WAAW,CAAC,QAAQ,CAAC,CAAC,CAG1G;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAC5B,WAAW,EAAE,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,EACtC,SAAS,EAAE,gBAAgB,GAC5B,CAAC,CAQH;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,MAAM,EAAE,QAAQ,EAAE,CAAC,EAAE,SAAS,EAAE,gBAAgB,GAAG,IAAI,CAejG;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAGxD;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,WAAW,GAAG,iBAAiB,GAAG,SAAS,CAEvF;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,SAAS,QAAQ,EACjD,SAAS,EAAE,gBAAgB,EAC3B,WAAW,EAAE,WAAW,CAAC,CAAC,CAAC,EAC3B,SAAS,GAAE,OAAc,GAC1B,IAAI,CAiBN"}

package/bin/Core/DI/Decorators.js

@@ -0,0 +1,253 @@
+/**
+ * 依赖注入装饰器
+ *
+ * 提供 @Injectable、@InjectProperty 和 @Updatable 装饰器，用于标记可注入的类和依赖注入点
+ */
+const injectableMetadata = new WeakMap();
+const updatableMetadata = new WeakMap();
+/**
+ * @Injectable() 装饰器
+ *
+ * 标记类为可注入的服务，使其可以通过ServiceContainer进行依赖注入
+ *
+ * @example
+ * ```typescript
+ * @Injectable()
+ * class TimeService implements IService {
+ *     constructor() {}
+ *     dispose() {}
+ * }
+ *
+ * @Injectable()
+ * class PhysicsSystem extends EntitySystem {
+ *     @InjectProperty(TimeService)
+ *     private timeService!: TimeService;
+ *
+ *     constructor() {
+ *         super(Matcher.empty());
+ *     }
+ * }
+ * ```
+ */
+export function Injectable() {
+    return function (target) {
+        const existing = injectableMetadata.get(target);
+        injectableMetadata.set(target, {
+            injectable: true,
+            dependencies: [],
+            ...(existing?.properties && { properties: existing.properties })
+        });
+    };
+}
+/**
+ * @Updatable() 装饰器
+ *
+ * 标记服务类为可更新的，使其在每帧自动被ServiceContainer调用update方法。
+ * 使用此装饰器的类必须实现IUpdatable接口（包含update方法）。
+ *
+ * @param priority - 更新优先级（数值越小越先执行，默认0）
+ * @throws 如果类没有实现update方法，将在运行时抛出错误
+ *
+ * @example
+ * ```typescript
+ * @Injectable()
+ * @Updatable()
+ * class TimerManager implements IService, IUpdatable {
+ *     update(deltaTime?: number) {
+ *         // 每帧更新逻辑
+ *     }
+ *     dispose() {}
+ * }
+ *
+ * // 指定优先级
+ * @Injectable()
+ * @Updatable(10)
+ * class PhysicsManager implements IService, IUpdatable {
+ *     update() { }
+ *     dispose() {}
+ * }
+ * ```
+ */
+export function Updatable(priority = 0) {
+    return function (target) {
+        // 验证类原型上是否有update方法
+        const prototype = target.prototype;
+        if (!prototype || typeof prototype.update !== 'function') {
+            throw new Error(`@Updatable() decorator requires class ${target.name} to implement IUpdatable interface with update() method. ` +
+                'Please add \'implements IUpdatable\' and define update(deltaTime?: number): void method.');
+        }
+        // 标记为可更新
+        updatableMetadata.set(target, {
+            updatable: true,
+            priority
+        });
+    };
+}
+/**
+ * @InjectProperty() 装饰器
+ *
+ * 通过属性装饰器注入依赖
+ *
+ * 注入时机：在构造函数执行后、onInitialize() 调用前完成
+ *
+ * @param serviceType 服务类型
+ *
+ * @example
+ * ```typescript
+ * @Injectable()
+ * class PhysicsSystem extends EntitySystem {
+ *     @InjectProperty(TimeService)
+ *     private timeService!: TimeService;
+ *
+ *     @InjectProperty(CollisionService)
+ *     private collision!: CollisionService;
+ *
+ *     constructor() {
+ *         super(Matcher.empty());
+ *     }
+ *
+ *     public onInitialize(): void {
+ *         // 此时属性已注入完成，可以安全使用
+ *         console.log(this.timeService.getDeltaTime());
+ *     }
+ * }
+ * ```
+ */
+export function InjectProperty(serviceType) {
+    return function (target, propertyKey) {
+        let metadata = injectableMetadata.get(target.constructor);
+        if (!metadata) {
+            metadata = {
+                injectable: true,
+                dependencies: []
+            };
+            injectableMetadata.set(target.constructor, metadata);
+        }
+        if (!metadata.properties) {
+            metadata.properties = new Map();
+        }
+        metadata.properties.set(propertyKey, serviceType);
+    };
+}
+/**
+ * 检查类是否标记为可注入
+ *
+ * @param target 目标类
+ * @returns 是否可注入
+ */
+export function isInjectable(target) {
+    const metadata = injectableMetadata.get(target);
+    return metadata?.injectable ?? false;
+}
+/**
+ * 获取类的依赖注入元数据
+ *
+ * @param target 目标类
+ * @returns 依赖注入元数据
+ */
+export function getInjectableMetadata(target) {
+    return injectableMetadata.get(target);
+}
+/**
+ * 获取属性注入元数据
+ *
+ * @param target 目标类
+ * @returns 属性名到服务类型的映射
+ */
+export function getPropertyInjectMetadata(target) {
+    const metadata = injectableMetadata.get(target);
+    return metadata?.properties || new Map();
+}
+/**
+ * 创建实例并自动注入依赖
+ *
+ * @param constructor 构造函数
+ * @param container 服务容器
+ * @returns 创建的实例
+ *
+ * @example
+ * ```typescript
+ * const instance = createInstance(MySystem, container);
+ * ```
+ */
+export function createInstance(constructor, container) {
+    // 创建实例（无参数注入）
+    const instance = new constructor();
+    // 注入属性依赖
+    injectProperties(instance, container);
+    return instance;
+}
+/**
+ * 为实例注入属性依赖
+ *
+ * @param instance 目标实例
+ * @param container 服务容器
+ */
+export function injectProperties(instance, container) {
+    const constructor = instance.constructor;
+    const metadata = getInjectableMetadata(constructor);
+    if (!metadata?.properties || metadata.properties.size === 0) {
+        return;
+    }
+    for (const [propertyKey, serviceType] of metadata.properties) {
+        const service = container.resolve(serviceType);
+        if (service !== null) {
+            instance[propertyKey] = service;
+        }
+    }
+}
+/**
+ * 检查类是否标记为可更新
+ *
+ * @param target 目标类
+ * @returns 是否可更新
+ */
+export function isUpdatable(target) {
+    const metadata = updatableMetadata.get(target);
+    return metadata?.updatable ?? false;
+}
+/**
+ * 获取类的可更新元数据
+ *
+ * @param target 目标类
+ * @returns 可更新元数据
+ */
+export function getUpdatableMetadata(target) {
+    return updatableMetadata.get(target);
+}
+/**
+ * 注册可注入的服务到容器
+ *
+ * 自动检测@Injectable装饰器并注册服务
+ *
+ * @param container 服务容器
+ * @param serviceType 服务类型
+ * @param singleton 是否注册为单例（默认true）
+ *
+ * @example
+ * ```typescript
+ * @Injectable()
+ * class MyService implements IService {
+ *     dispose() {}
+ * }
+ *
+ * // 自动注册
+ * registerInjectable(Core.services, MyService);
+ * ```
+ */
+export function registerInjectable(container, serviceType, singleton = true) {
+    if (!isInjectable(serviceType)) {
+        throw new Error(`${serviceType.name} is not marked as @Injectable(). ` +
+            'Please add @Injectable() decorator to the class.');
+    }
+    // 创建工厂函数，使用createInstance自动解析依赖
+    const factory = (c) => createInstance(serviceType, c);
+    // 注册到容器
+    if (singleton) {
+        container.registerSingleton(serviceType, factory);
+    }
+    else {
+        container.registerTransient(serviceType, factory);
+    }
+}
+//# sourceMappingURL=Decorators.js.map

package/bin/Core/DI/Decorators.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Decorators.js","sourceRoot":"","sources":["../../../src/Core/DI/Decorators.ts"],"names":[],"mappings":"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"}

package/bin/Core/DI/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * 依赖注入模块
+ *
+ * 提供装饰器和工具函数，用于实现依赖注入模式
+ */
+export { Injectable, InjectProperty, Updatable, isInjectable, getInjectableMetadata, getPropertyInjectMetadata, isUpdatable, getUpdatableMetadata, createInstance, injectProperties, registerInjectable } from './Decorators';
+export type { InjectableMetadata, UpdatableMetadata } from './Decorators';
+//# sourceMappingURL=index.d.ts.map

package/bin/Core/DI/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/Core/DI/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACH,UAAU,EACV,cAAc,EACd,SAAS,EACT,YAAY,EACZ,qBAAqB,EACrB,yBAAyB,EACzB,WAAW,EACX,oBAAoB,EACpB,cAAc,EACd,gBAAgB,EAChB,kBAAkB,EACrB,MAAM,cAAc,CAAC;AAEtB,YAAY,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC"}

package/bin/Core/DI/index.js

@@ -0,0 +1,7 @@
+/**
+ * 依赖注入模块
+ *
+ * 提供装饰器和工具函数，用于实现依赖注入模式
+ */
+export { Injectable, InjectProperty, Updatable, isInjectable, getInjectableMetadata, getPropertyInjectMetadata, isUpdatable, getUpdatableMetadata, createInstance, injectProperties, registerInjectable } from './Decorators';
+//# sourceMappingURL=index.js.map

package/bin/Core/DI/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/Core/DI/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACH,UAAU,EACV,cAAc,EACd,SAAS,EACT,YAAY,EACZ,qBAAqB,EACrB,yBAAyB,EACzB,WAAW,EACX,oBAAoB,EACpB,cAAc,EACd,gBAAgB,EAChB,kBAAkB,EACrB,MAAM,cAAc,CAAC"}

package/bin/Core/Plugin.d.ts

@@ -0,0 +1,112 @@
+import type { Core } from '../Core';
+import type { ServiceContainer } from './ServiceContainer';
+/**
+ * 插件状态
+ */
+export declare enum PluginState {
+    /**
+     * 未安装
+     */
+    NotInstalled = "not_installed",
+    /**
+     * 已安装
+     */
+    Installed = "installed",
+    /**
+     * 安装失败
+     */
+    Failed = "failed"
+}
+/**
+ * 插件接口
+ *
+ * 所有插件都必须实现此接口。
+ * 插件提供了一种扩展框架功能的标准方式。
+ *
+ * @example
+ * ```typescript
+ * class MyPlugin implements IPlugin {
+ *     readonly name = 'my-plugin';
+ *     readonly version = '1.0.0';
+ *     readonly dependencies = ['other-plugin'];
+ *
+ *     async install(core: Core, services: ServiceContainer) {
+ *         // 注册服务
+ *         services.registerSingleton(MyService);
+ *
+ *         // 添加系统
+ *         const world = core.getWorld();
+ *         if (world) {
+ *             world.addSystem(new MySystem());
+ *         }
+ *     }
+ *
+ *     async uninstall() {
+ *         // 清理资源
+ *     }
+ * }
+ * ```
+ */
+export interface IPlugin {
+    /**
+     * 插件唯一名称
+     *
+     * 用于依赖解析和插件管理。
+     */
+    readonly name: string;
+    /**
+     * 插件版本
+     *
+     * 遵循语义化版本规范 (semver)。
+     */
+    readonly version: string;
+    /**
+     * 依赖的其他插件名称列表
+     *
+     * 这些插件必须在当前插件之前安装。
+     */
+    readonly dependencies?: readonly string[];
+    /**
+     * 安装插件
+     *
+     * 在此方法中初始化插件，注册服务、系统等。
+     * 可以是同步或异步的。
+     *
+     * @param core - Core实例，用于访问World等
+     * @param services - 服务容器，用于注册服务
+     */
+    install(core: Core, services: ServiceContainer): void | Promise<void>;
+    /**
+     * 卸载插件
+     *
+     * 清理插件占用的资源。
+     * 可以是同步或异步的。
+     */
+    uninstall(): void | Promise<void>;
+}
+/**
+ * 插件元数据
+ */
+export interface IPluginMetadata {
+    /**
+     * 插件名称
+     */
+    name: string;
+    /**
+     * 插件版本
+     */
+    version: string;
+    /**
+     * 插件状态
+     */
+    state: PluginState;
+    /**
+     * 安装时间戳
+     */
+    installedAt?: number;
+    /**
+     * 错误信息（如果安装失败）
+     */
+    error?: string;
+}
+//# sourceMappingURL=Plugin.d.ts.map

package/bin/Core/Plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Plugin.d.ts","sourceRoot":"","sources":["../../src/Core/Plugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AACpC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAE3D;;GAEG;AACH,oBAAY,WAAW;IACnB;;OAEG;IACH,YAAY,kBAAkB;IAE9B;;OAEG;IACH,SAAS,cAAc;IAEvB;;OAEG;IACH,MAAM,WAAW;CACpB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,MAAM,WAAW,OAAO;IACpB;;;;OAIG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB;;;;OAIG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAEzB;;;;OAIG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAE1C;;;;;;;;OAQG;IACH,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,gBAAgB,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEtE;;;;;OAKG;IACH,SAAS,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACrC;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC5B;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,KAAK,EAAE,WAAW,CAAC;IAEnB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB"}

package/bin/Core/Plugin.js

@@ -0,0 +1,19 @@
+/**
+ * 插件状态
+ */
+export var PluginState;
+(function (PluginState) {
+    /**
+     * 未安装
+     */
+    PluginState["NotInstalled"] = "not_installed";
+    /**
+     * 已安装
+     */
+    PluginState["Installed"] = "installed";
+    /**
+     * 安装失败
+     */
+    PluginState["Failed"] = "failed";
+})(PluginState || (PluginState = {}));
+//# sourceMappingURL=Plugin.js.map

package/bin/Core/Plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Plugin.js","sourceRoot":"","sources":["../../src/Core/Plugin.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,MAAM,CAAN,IAAY,WAeX;AAfD,WAAY,WAAW;IACnB;;OAEG;IACH,6CAA8B,CAAA;IAE9B;;OAEG;IACH,sCAAuB,CAAA;IAEvB;;OAEG;IACH,gCAAiB,CAAA;AACrB,CAAC,EAfW,WAAW,KAAX,WAAW,QAetB"}