@esengine/ecs-framework 2.3.0 → 2.3.1

package/bin/ECS/Decorators/EntityRefDecorator.d.ts

@@ -1,46 +0,0 @@
-/**
- * EntityRef元数据的Symbol键
- */
-export declare const ENTITY_REF_METADATA: unique symbol;
-/**
- * EntityRef元数据
- */
-export interface EntityRefMetadata {
-    properties: Set<string>;
-}
-/**
- * Entity引用装饰器
- *
- * 标记Component属性为Entity引用，自动追踪引用关系。
- * 当被引用的Entity销毁时，该属性会自动设为null。
- *
- * @example
- * ```typescript
- * class ParentComponent extends Component {
- *     @EntityRef() parent: Entity | null = null;
- * }
- *
- * const parent = scene.createEntity('Parent');
- * const child = scene.createEntity('Child');
- * const comp = child.addComponent(new ParentComponent());
- *
- * comp.parent = parent;
- * parent.destroy(); // comp.parent 自动变为 null
- * ```
- */
-export declare function EntityRef(): PropertyDecorator;
-/**
- * 获取Component的EntityRef元数据
- *
- * @param component Component实例或Component类
- * @returns EntityRef元数据，如果不存在则返回null
- */
-export declare function getEntityRefMetadata(component: any): EntityRefMetadata | null;
-/**
- * 检查Component是否有EntityRef属性
- *
- * @param component Component实例或Component类
- * @returns 如果有EntityRef属性返回true
- */
-export declare function hasEntityRef(component: any): boolean;
-//# sourceMappingURL=EntityRefDecorator.d.ts.map

package/bin/ECS/Decorators/EntityRefDecorator.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"EntityRefDecorator.d.ts","sourceRoot":"","sources":["../../../src/ECS/Decorators/EntityRefDecorator.ts"],"names":[],"mappings":"AAOA;;GAEG;AACH,eAAO,MAAM,mBAAmB,eAA8B,CAAC;AAO/D;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAC9B,UAAU,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;CAC3B;AAcD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,SAAS,IAAI,iBAAiB,CA8D7C;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,GAAG,GAAG,iBAAiB,GAAG,IAAI,CAU7E;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,SAAS,EAAE,GAAG,GAAG,OAAO,CAEpD"}

package/bin/ECS/Decorators/EntityRefDecorator.js

@@ -1,118 +0,0 @@
-import { getSceneByEntityId } from '../Core/ReferenceTracker';
-import { createLogger } from '../../Utils/Logger';
-const logger = createLogger('EntityRefDecorator');
-/**
- * EntityRef元数据的Symbol键
- */
-export const ENTITY_REF_METADATA = Symbol('EntityRefMetadata');
-/**
- * EntityRef值存储的Symbol键
- */
-const ENTITY_REF_VALUES = Symbol('EntityRefValues');
-/**
- * 获取或创建组件的EntityRef值存储Map
- */
-function getValueMap(component) {
-    let map = component[ENTITY_REF_VALUES];
-    if (!map) {
-        map = new Map();
-        component[ENTITY_REF_VALUES] = map;
-    }
-    return map;
-}
-/**
- * Entity引用装饰器
- *
- * 标记Component属性为Entity引用，自动追踪引用关系。
- * 当被引用的Entity销毁时，该属性会自动设为null。
- *
- * @example
- * ```typescript
- * class ParentComponent extends Component {
- *     @EntityRef() parent: Entity | null = null;
- * }
- *
- * const parent = scene.createEntity('Parent');
- * const child = scene.createEntity('Child');
- * const comp = child.addComponent(new ParentComponent());
- *
- * comp.parent = parent;
- * parent.destroy(); // comp.parent 自动变为 null
- * ```
- */
-export function EntityRef() {
-    return function (target, propertyKey) {
-        const constructor = target.constructor;
-        let metadata = constructor[ENTITY_REF_METADATA];
-        if (!metadata) {
-            metadata = {
-                properties: new Set()
-            };
-            constructor[ENTITY_REF_METADATA] = metadata;
-        }
-        const propKeyString = typeof propertyKey === 'symbol' ? propertyKey.toString() : propertyKey;
-        metadata.properties.add(propKeyString);
-        Object.defineProperty(target, propertyKey, {
-            get: function () {
-                const valueMap = getValueMap(this);
-                return valueMap.get(propKeyString) || null;
-            },
-            set: function (newValue) {
-                const valueMap = getValueMap(this);
-                const oldValue = valueMap.get(propKeyString) || null;
-                if (oldValue === newValue) {
-                    return;
-                }
-                const scene = this.entityId !== null ? getSceneByEntityId(this.entityId) : null;
-                if (!scene || !scene.referenceTracker) {
-                    valueMap.set(propKeyString, newValue);
-                    return;
-                }
-                const tracker = scene.referenceTracker;
-                if (oldValue) {
-                    tracker.unregisterReference(oldValue, this, propKeyString);
-                }
-                if (newValue) {
-                    if (newValue.scene !== scene) {
-                        logger.error(`Cannot reference Entity from different Scene. Entity: ${newValue.name}, Scene: ${newValue.scene?.name || 'null'}`);
-                        return;
-                    }
-                    if (newValue.isDestroyed) {
-                        logger.warn(`Cannot reference destroyed Entity: ${newValue.name}`);
-                        valueMap.set(propKeyString, null);
-                        return;
-                    }
-                    tracker.registerReference(newValue, this, propKeyString);
-                }
-                valueMap.set(propKeyString, newValue);
-            },
-            enumerable: true,
-            configurable: true
-        });
-    };
-}
-/**
- * 获取Component的EntityRef元数据
- *
- * @param component Component实例或Component类
- * @returns EntityRef元数据，如果不存在则返回null
- */
-export function getEntityRefMetadata(component) {
-    if (!component) {
-        return null;
-    }
-    const constructor = typeof component === 'function'
-        ? component
-        : component.constructor;
-    return constructor[ENTITY_REF_METADATA] || null;
-}
-/**
- * 检查Component是否有EntityRef属性
- *
- * @param component Component实例或Component类
- * @returns 如果有EntityRef属性返回true
- */
-export function hasEntityRef(component) {
-    return getEntityRefMetadata(component) !== null;
-}
-//# sourceMappingURL=EntityRefDecorator.js.map

package/bin/ECS/Decorators/EntityRefDecorator.js.map

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

package/bin/ECS/Decorators/PropertyDecorator.d.ts

@@ -1,168 +0,0 @@
-import 'reflect-metadata';
-export type PropertyType = 'number' | 'integer' | 'string' | 'boolean' | 'color' | 'vector2' | 'vector3' | 'enum' | 'asset' | 'animationClips' | 'collisionLayer' | 'collisionMask';
-/**
- * 资源类型
- * Asset type for asset properties
- */
-export type AssetType = 'texture' | 'audio' | 'scene' | 'prefab' | 'animation' | 'any';
-/**
- * 枚举选项 - 支持简单字符串或带标签的对象
- * Enum option - supports simple string or labeled object
- */
-export type EnumOption = string | {
-    label: string;
-    value: any;
-};
-/**
- * Action button configuration for property fields
- * 属性字段的操作按钮配置
- */
-export interface PropertyAction {
-    /** Action identifier | 操作标识符 */
-    id: string;
-    /** Button label | 按钮标签 */
-    label: string;
-    /** Button tooltip | 按钮提示 */
-    tooltip?: string;
-    /** Icon name from Lucide | Lucide图标名称 */
-    icon?: string;
-}
-/**
- * 控制关系声明
- * Control relationship declaration
- */
-export interface PropertyControl {
-    /** 被控制的组件名称 | Target component name */
-    component: string;
-    /** 被控制的属性名称 | Target property name */
-    property: string;
-}
-/**
- * 属性基础选项
- * Base property options shared by all types
- */
-interface PropertyOptionsBase {
-    /** 显示标签 | Display label */
-    label?: string;
-    /** 是否只读 | Read-only flag */
-    readOnly?: boolean;
-    /** Action buttons | 操作按钮 */
-    actions?: PropertyAction[];
-    /** 此属性控制的其他组件属性 | Properties this field controls */
-    controls?: PropertyControl[];
-}
-/**
- * 数值类型属性选项
- * Number property options
- */
-interface NumberPropertyOptions extends PropertyOptionsBase {
-    type: 'number' | 'integer';
-    min?: number;
-    max?: number;
-    step?: number;
-}
-/**
- * 字符串类型属性选项
- * String property options
- */
-interface StringPropertyOptions extends PropertyOptionsBase {
-    type: 'string';
-    /** 多行文本 | Multiline text */
-    multiline?: boolean;
-}
-/**
- * 布尔类型属性选项
- * Boolean property options
- */
-interface BooleanPropertyOptions extends PropertyOptionsBase {
-    type: 'boolean';
-}
-/**
- * 颜色类型属性选项
- * Color property options
- */
-interface ColorPropertyOptions extends PropertyOptionsBase {
-    type: 'color';
-    /** 是否包含透明度 | Include alpha channel */
-    alpha?: boolean;
-}
-/**
- * 向量类型属性选项
- * Vector property options
- */
-interface VectorPropertyOptions extends PropertyOptionsBase {
-    type: 'vector2' | 'vector3';
-}
-/**
- * 枚举类型属性选项
- * Enum property options
- */
-interface EnumPropertyOptions extends PropertyOptionsBase {
-    type: 'enum';
-    /** 枚举选项列表 | Enum options list */
-    options: EnumOption[];
-}
-/**
- * 资源类型属性选项
- * Asset property options
- */
-interface AssetPropertyOptions extends PropertyOptionsBase {
-    type: 'asset';
-    /** 资源类型 | Asset type */
-    assetType?: AssetType;
-    /** 文件扩展名过滤 | File extension filter */
-    extensions?: string[];
-}
-/**
- * 动画剪辑类型属性选项
- * Animation clips property options
- */
-interface AnimationClipsPropertyOptions extends PropertyOptionsBase {
-    type: 'animationClips';
-}
-/**
- * 碰撞层属性选项
- * Collision layer property options
- */
-interface CollisionLayerPropertyOptions extends PropertyOptionsBase {
-    type: 'collisionLayer';
-}
-/**
- * 碰撞掩码属性选项
- * Collision mask property options
- */
-interface CollisionMaskPropertyOptions extends PropertyOptionsBase {
-    type: 'collisionMask';
-}
-/**
- * 属性选项联合类型
- * Property options union type
- */
-export type PropertyOptions = NumberPropertyOptions | StringPropertyOptions | BooleanPropertyOptions | ColorPropertyOptions | VectorPropertyOptions | EnumPropertyOptions | AssetPropertyOptions | AnimationClipsPropertyOptions | CollisionLayerPropertyOptions | CollisionMaskPropertyOptions;
-export declare const PROPERTY_METADATA: unique symbol;
-/**
- * 属性装饰器 - 声明组件属性的编辑器元数据
- *
- * @example
- * ```typescript
- * @ECSComponent('Transform')
- * export class TransformComponent extends Component {
- *     @Property({ type: 'vector3', label: 'Position' })
- *     public position: Vector3 = { x: 0, y: 0, z: 0 };
- *
- *     @Property({ type: 'number', label: 'Speed', min: 0, max: 100 })
- *     public speed: number = 10;
- * }
- * ```
- */
-export declare function Property(options: PropertyOptions): PropertyDecorator;
-/**
- * 获取组件类的所有属性元数据
- */
-export declare function getPropertyMetadata(target: Function): Record<string, PropertyOptions> | undefined;
-/**
- * 检查组件类是否有属性元数据
- */
-export declare function hasPropertyMetadata(target: Function): boolean;
-export {};
-//# sourceMappingURL=PropertyDecorator.d.ts.map

package/bin/ECS/Decorators/PropertyDecorator.d.ts.map

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

package/bin/ECS/Decorators/PropertyDecorator.js

@@ -1,40 +0,0 @@
-import 'reflect-metadata';
-// 使用 Symbol.for 创建全局 Symbol，确保跨包共享元数据
-// Use Symbol.for to create a global Symbol to ensure metadata sharing across packages
-export const PROPERTY_METADATA = Symbol.for('@esengine/property:metadata');
-/**
- * 属性装饰器 - 声明组件属性的编辑器元数据
- *
- * @example
- * ```typescript
- * @ECSComponent('Transform')
- * export class TransformComponent extends Component {
- *     @Property({ type: 'vector3', label: 'Position' })
- *     public position: Vector3 = { x: 0, y: 0, z: 0 };
- *
- *     @Property({ type: 'number', label: 'Speed', min: 0, max: 100 })
- *     public speed: number = 10;
- * }
- * ```
- */
-export function Property(options) {
-    return (target, propertyKey) => {
-        const constructor = target.constructor;
-        const existingMetadata = Reflect.getMetadata(PROPERTY_METADATA, constructor) || {};
-        existingMetadata[propertyKey] = options;
-        Reflect.defineMetadata(PROPERTY_METADATA, existingMetadata, constructor);
-    };
-}
-/**
- * 获取组件类的所有属性元数据
- */
-export function getPropertyMetadata(target) {
-    return Reflect.getMetadata(PROPERTY_METADATA, target);
-}
-/**
- * 检查组件类是否有属性元数据
- */
-export function hasPropertyMetadata(target) {
-    return Reflect.hasMetadata(PROPERTY_METADATA, target);
-}
-//# sourceMappingURL=PropertyDecorator.js.map

package/bin/ECS/Decorators/PropertyDecorator.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"PropertyDecorator.js","sourceRoot":"","sources":["../../../src/ECS/Decorators/PropertyDecorator.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAsK1B,sCAAsC;AACtC,sFAAsF;AACtF,MAAM,CAAC,MAAM,iBAAiB,GAAG,MAAM,CAAC,GAAG,CAAC,6BAA6B,CAAC,CAAC;AAE3E;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,QAAQ,CAAC,OAAwB;IAC7C,OAAO,CAAC,MAAc,EAAE,WAA4B,EAAE,EAAE;QACpD,MAAM,WAAW,GAAG,MAAM,CAAC,WAAW,CAAC;QACvC,MAAM,gBAAgB,GAAG,OAAO,CAAC,WAAW,CAAC,iBAAiB,EAAE,WAAW,CAAC,IAAI,EAAE,CAAC;QAEnF,gBAAgB,CAAC,WAAqB,CAAC,GAAG,OAAO,CAAC;QAElD,OAAO,CAAC,cAAc,CAAC,iBAAiB,EAAE,gBAAgB,EAAE,WAAW,CAAC,CAAC;IAC7E,CAAC,CAAC;AACN,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,MAAgB;IAChD,OAAO,OAAO,CAAC,WAAW,CAAC,iBAAiB,EAAE,MAAM,CAAC,CAAC;AAC1D,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,MAAgB;IAChD,OAAO,OAAO,CAAC,WAAW,CAAC,iBAAiB,EAAE,MAAM,CAAC,CAAC;AAC1D,CAAC"}

package/bin/ECS/Decorators/TypeDecorators.d.ts

@@ -1,124 +0,0 @@
-import type { Component } from '../Component';
-import type { EntitySystem } from '../Systems';
-import { ComponentType } from '../../Types';
-/**
- * 存储组件类型名称的Symbol键
- */
-export declare const COMPONENT_TYPE_NAME: unique symbol;
-/**
- * 存储组件依赖的Symbol键
- */
-export declare const COMPONENT_DEPENDENCIES: unique symbol;
-/**
- * 存储系统类型名称的Symbol键
- */
-export declare const SYSTEM_TYPE_NAME: unique symbol;
-/**
- * 组件装饰器配置选项
- */
-export interface ComponentOptions {
-    /** 依赖的其他组件名称列表 */
-    requires?: string[];
-}
-/**
- * 组件类型装饰器
- * 用于为组件类指定固定的类型名称，避免在代码混淆后失效
- *
- * @param typeName 组件类型名称
- * @param options 组件配置选项
- * @example
- * ```typescript
- * @ECSComponent('Position')
- * class PositionComponent extends Component {
- *     x: number = 0;
- *     y: number = 0;
- * }
- *
- * // 带依赖声明
- * @ECSComponent('SpriteAnimator', { requires: ['Sprite'] })
- * class SpriteAnimatorComponent extends Component {
- *     // ...
- * }
- * ```
- */
-export declare function ECSComponent(typeName: string, options?: ComponentOptions): <T extends new (...args: any[]) => Component>(target: T) => T;
-/**
- * 获取组件的依赖列表
- */
-export declare function getComponentDependencies(componentType: ComponentType): string[] | undefined;
-/**
- * System元数据配置
- */
-export interface SystemMetadata {
-    /**
-     * 更新顺序（数值越小越先执行，默认0）
-     */
-    updateOrder?: number;
-    /**
-     * 是否默认启用（默认true）
-     */
-    enabled?: boolean;
-}
-/**
- * 系统类型装饰器
- * 用于为系统类指定固定的类型名称，避免在代码混淆后失效
- *
- * @param typeName 系统类型名称
- * @param metadata 系统元数据配置
- * @example
- * ```typescript
- * // 基本使用
- * @ECSSystem('Movement')
- * class MovementSystem extends EntitySystem {
- *     protected process(entities: Entity[]): void {
- *         // 系统逻辑
- *     }
- * }
- *
- * // 配置更新顺序和依赖注入
- * @Injectable()
- * @ECSSystem('Physics', { updateOrder: 10 })
- * class PhysicsSystem extends EntitySystem {
- *     @InjectProperty(CollisionSystem)
- *     private collision!: CollisionSystem;
- *
- *     constructor() {
- *         super(Matcher.empty().all(Transform, RigidBody));
- *     }
- * }
- * ```
- */
-export declare function ECSSystem(typeName: string, metadata?: SystemMetadata): <T extends new (...args: any[]) => EntitySystem>(target: T) => T;
-/**
- * 获取System的元数据
- */
-export declare function getSystemMetadata(systemType: new (...args: any[]) => EntitySystem): SystemMetadata | undefined;
-/**
- * 获取组件类型的名称，优先使用装饰器指定的名称
- *
- * @param componentType 组件构造函数
- * @returns 组件类型名称
- */
-export declare function getComponentTypeName(componentType: ComponentType): string;
-/**
- * 获取系统类型的名称，优先使用装饰器指定的名称
- *
- * @param systemType 系统构造函数
- * @returns 系统类型名称
- */
-export declare function getSystemTypeName<T extends EntitySystem>(systemType: new (...args: any[]) => T): string;
-/**
- * 从组件实例获取类型名称
- *
- * @param component 组件实例
- * @returns 组件类型名称
- */
-export declare function getComponentInstanceTypeName(component: Component): string;
-/**
- * 从系统实例获取类型名称
- *
- * @param system 系统实例
- * @returns 系统类型名称
- */
-export declare function getSystemInstanceTypeName(system: EntitySystem): string;
-//# sourceMappingURL=TypeDecorators.d.ts.map

package/bin/ECS/Decorators/TypeDecorators.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"TypeDecorators.d.ts","sourceRoot":"","sources":["../../../src/ECS/Decorators/TypeDecorators.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C;;GAEG;AACH,eAAO,MAAM,mBAAmB,eAA8B,CAAC;AAE/D;;GAEG;AACH,eAAO,MAAM,sBAAsB,eAAkC,CAAC;AAEtE;;GAEG;AACH,eAAO,MAAM,gBAAgB,eAA2B,CAAC;AAEzD;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC7B,kBAAkB;IAClB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,gBAAgB,IACpD,CAAC,SAAS,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,SAAS,EAAE,QAAQ,CAAC,KAAG,CAAC,CAe9E;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,aAAa,EAAE,aAAa,GAAG,MAAM,EAAE,GAAG,SAAS,CAE3F;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC3B;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;CACrB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,cAAc,IAChD,CAAC,SAAS,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,YAAY,EAAE,QAAQ,CAAC,KAAG,CAAC,CAejF;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,YAAY,GAAG,cAAc,GAAG,SAAS,CAE9G;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAChC,aAAa,EAAE,aAAa,GAC7B,MAAM,CASR;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,YAAY,EACpD,UAAU,EAAE,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,GACtC,MAAM,CASR;AAED;;;;;GAKG;AACH,wBAAgB,4BAA4B,CAAC,SAAS,EAAE,SAAS,GAAG,MAAM,CAEzE;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CAEtE"}

package/bin/ECS/Decorators/TypeDecorators.js

@@ -1,151 +0,0 @@
-/**
- * 存储组件类型名称的Symbol键
- */
-export const COMPONENT_TYPE_NAME = Symbol('ComponentTypeName');
-/**
- * 存储组件依赖的Symbol键
- */
-export const COMPONENT_DEPENDENCIES = Symbol('ComponentDependencies');
-/**
- * 存储系统类型名称的Symbol键
- */
-export const SYSTEM_TYPE_NAME = Symbol('SystemTypeName');
-/**
- * 组件类型装饰器
- * 用于为组件类指定固定的类型名称，避免在代码混淆后失效
- *
- * @param typeName 组件类型名称
- * @param options 组件配置选项
- * @example
- * ```typescript
- * @ECSComponent('Position')
- * class PositionComponent extends Component {
- *     x: number = 0;
- *     y: number = 0;
- * }
- *
- * // 带依赖声明
- * @ECSComponent('SpriteAnimator', { requires: ['Sprite'] })
- * class SpriteAnimatorComponent extends Component {
- *     // ...
- * }
- * ```
- */
-export function ECSComponent(typeName, options) {
-    return function (target) {
-        if (!typeName || typeof typeName !== 'string') {
-            throw new Error('ECSComponent装饰器必须提供有效的类型名称');
-        }
-        // 在构造函数上存储类型名称
-        target[COMPONENT_TYPE_NAME] = typeName;
-        // 存储依赖关系
-        if (options?.requires) {
-            target[COMPONENT_DEPENDENCIES] = options.requires;
-        }
-        return target;
-    };
-}
-/**
- * 获取组件的依赖列表
- */
-export function getComponentDependencies(componentType) {
-    return componentType[COMPONENT_DEPENDENCIES];
-}
-/**
- * 系统类型装饰器
- * 用于为系统类指定固定的类型名称，避免在代码混淆后失效
- *
- * @param typeName 系统类型名称
- * @param metadata 系统元数据配置
- * @example
- * ```typescript
- * // 基本使用
- * @ECSSystem('Movement')
- * class MovementSystem extends EntitySystem {
- *     protected process(entities: Entity[]): void {
- *         // 系统逻辑
- *     }
- * }
- *
- * // 配置更新顺序和依赖注入
- * @Injectable()
- * @ECSSystem('Physics', { updateOrder: 10 })
- * class PhysicsSystem extends EntitySystem {
- *     @InjectProperty(CollisionSystem)
- *     private collision!: CollisionSystem;
- *
- *     constructor() {
- *         super(Matcher.empty().all(Transform, RigidBody));
- *     }
- * }
- * ```
- */
-export function ECSSystem(typeName, metadata) {
-    return function (target) {
-        if (!typeName || typeof typeName !== 'string') {
-            throw new Error('ECSSystem装饰器必须提供有效的类型名称');
-        }
-        // 在构造函数上存储类型名称
-        target[SYSTEM_TYPE_NAME] = typeName;
-        // 存储元数据
-        if (metadata) {
-            target.__systemMetadata__ = metadata;
-        }
-        return target;
-    };
-}
-/**
- * 获取System的元数据
- */
-export function getSystemMetadata(systemType) {
-    return systemType.__systemMetadata__;
-}
-/**
- * 获取组件类型的名称，优先使用装饰器指定的名称
- *
- * @param componentType 组件构造函数
- * @returns 组件类型名称
- */
-export function getComponentTypeName(componentType) {
-    // 优先使用装饰器指定的名称
-    const decoratorName = componentType[COMPONENT_TYPE_NAME];
-    if (decoratorName) {
-        return decoratorName;
-    }
-    // 回退到constructor.name
-    return componentType.name || 'UnknownComponent';
-}
-/**
- * 获取系统类型的名称，优先使用装饰器指定的名称
- *
- * @param systemType 系统构造函数
- * @returns 系统类型名称
- */
-export function getSystemTypeName(systemType) {
-    // 优先使用装饰器指定的名称
-    const decoratorName = systemType[SYSTEM_TYPE_NAME];
-    if (decoratorName) {
-        return decoratorName;
-    }
-    // 回退到constructor.name
-    return systemType.name || 'UnknownSystem';
-}
-/**
- * 从组件实例获取类型名称
- *
- * @param component 组件实例
- * @returns 组件类型名称
- */
-export function getComponentInstanceTypeName(component) {
-    return getComponentTypeName(component.constructor);
-}
-/**
- * 从系统实例获取类型名称
- *
- * @param system 系统实例
- * @returns 系统类型名称
- */
-export function getSystemInstanceTypeName(system) {
-    return getSystemTypeName(system.constructor);
-}
-//# sourceMappingURL=TypeDecorators.js.map

package/bin/ECS/Decorators/TypeDecorators.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"TypeDecorators.js","sourceRoot":"","sources":["../../../src/ECS/Decorators/TypeDecorators.ts"],"names":[],"mappings":"AAIA;;GAEG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,MAAM,CAAC,mBAAmB,CAAC,CAAC;AAE/D;;GAEG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,MAAM,CAAC,uBAAuB,CAAC,CAAC;AAEtE;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,MAAM,CAAC,gBAAgB,CAAC,CAAC;AAUzD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,YAAY,CAAC,QAAgB,EAAE,OAA0B;IACrE,OAAO,UAAuD,MAAS;QACnE,IAAI,CAAC,QAAQ,IAAI,OAAO,QAAQ,KAAK,QAAQ,EAAE,CAAC;YAC5C,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAC;QAClD,CAAC;QAED,eAAe;QACd,MAAc,CAAC,mBAAmB,CAAC,GAAG,QAAQ,CAAC;QAEhD,SAAS;QACT,IAAI,OAAO,EAAE,QAAQ,EAAE,CAAC;YACnB,MAAc,CAAC,sBAAsB,CAAC,GAAG,OAAO,CAAC,QAAQ,CAAC;QAC/D,CAAC;QAED,OAAO,MAAM,CAAC;IAClB,CAAC,CAAC;AACN,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,wBAAwB,CAAC,aAA4B;IACjE,OAAQ,aAAqB,CAAC,sBAAsB,CAAC,CAAC;AAC1D,CAAC;AAiBD;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,MAAM,UAAU,SAAS,CAAC,QAAgB,EAAE,QAAyB;IACjE,OAAO,UAA0D,MAAS;QACtE,IAAI,CAAC,QAAQ,IAAI,OAAO,QAAQ,KAAK,QAAQ,EAAE,CAAC;YAC5C,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;QAC/C,CAAC;QAED,eAAe;QACd,MAAc,CAAC,gBAAgB,CAAC,GAAG,QAAQ,CAAC;QAE7C,QAAQ;QACR,IAAI,QAAQ,EAAE,CAAC;YACV,MAAc,CAAC,kBAAkB,GAAG,QAAQ,CAAC;QAClD,CAAC;QAED,OAAO,MAAM,CAAC;IAClB,CAAC,CAAC;AACN,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,UAAgD;IAC9E,OAAQ,UAAkB,CAAC,kBAAkB,CAAC;AAClD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAChC,aAA4B;IAE5B,eAAe;IACf,MAAM,aAAa,GAAI,aAAqB,CAAC,mBAAmB,CAAC,CAAC;IAClE,IAAI,aAAa,EAAE,CAAC;QAChB,OAAO,aAAa,CAAC;IACzB,CAAC;IAED,sBAAsB;IACtB,OAAO,aAAa,CAAC,IAAI,IAAI,kBAAkB,CAAC;AACpD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAC7B,UAAqC;IAErC,eAAe;IACf,MAAM,aAAa,GAAI,UAAkB,CAAC,gBAAgB,CAAC,CAAC;IAC5D,IAAI,aAAa,EAAE,CAAC;QAChB,OAAO,aAAa,CAAC;IACzB,CAAC;IAED,sBAAsB;IACtB,OAAO,UAAU,CAAC,IAAI,IAAI,eAAe,CAAC;AAC9C,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,4BAA4B,CAAC,SAAoB;IAC7D,OAAO,oBAAoB,CAAC,SAAS,CAAC,WAA4B,CAAC,CAAC;AACxE,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,yBAAyB,CAAC,MAAoB;IAC1D,OAAO,iBAAiB,CAAC,MAAM,CAAC,WAAmD,CAAC,CAAC;AACzF,CAAC"}