@esengine/ecs-framework 2.3.0 → 2.3.1

package/bin/ECS/Serialization/SerializationDecorators.d.ts

@@ -1,136 +0,0 @@
-/**
- * 序列化装饰器
- *
- * 提供组件级别的序列化支持，包括字段级装饰器和类级装饰器
- */
-import { Component } from '../Component';
-/**
- * 序列化元数据的Symbol键
- */
-export declare const SERIALIZABLE_METADATA: unique symbol;
-export declare const SERIALIZE_FIELD: unique symbol;
-export declare const SERIALIZE_OPTIONS: unique symbol;
-/**
- * 可序列化配置选项
- */
-export interface SerializableOptions {
-    /**
-     * 序列化版本号，用于数据迁移
-     */
-    version: number;
-    /**
-     * 组件类型标识符（可选，默认使用类名）
-     */
-    typeId?: string;
-}
-/**
- * 字段序列化配置
- */
-export interface FieldSerializeOptions {
-    /**
-     * 自定义序列化器
-     */
-    serializer?: (value: any) => any;
-    /**
-     * 自定义反序列化器
-     */
-    deserializer?: (value: any) => any;
-    /**
-     * 字段别名（用于序列化后的键名）
-     */
-    alias?: string;
-}
-/**
- * 序列化元数据
- */
-export interface SerializationMetadata {
-    options: SerializableOptions;
-    fields: Map<string | symbol, FieldSerializeOptions>;
-    ignoredFields: Set<string | symbol>;
-}
-/**
- * 组件可序列化装饰器
- *
- * 标记组件类为可序列化，必须与字段装饰器配合使用
- *
- * @param options 序列化配置选项
- *
- * @example
- * ```typescript
- * @ECSComponent('Player')
- * @Serializable({ version: 1 })
- * class PlayerComponent extends Component {
- *     @Serialize() name: string = 'Player';
- *     @Serialize() level: number = 1;
- * }
- * ```
- */
-export declare function Serializable(options: SerializableOptions): <T extends new (...args: any[]) => Component>(target: T) => T;
-/**
- * 字段序列化装饰器
- *
- * 标记字段为可序列化
- *
- * @param options 字段序列化选项（可选）
- *
- * @example
- * ```typescript
- * @Serialize()
- * name: string = 'Player';
- *
- * @Serialize({ alias: 'hp' })
- * health: number = 100;
- * ```
- */
-export declare function Serialize(options?: FieldSerializeOptions): (target: any, propertyKey: string | symbol) => void;
-/**
- * Map序列化装饰器
- *
- * 专门用于序列化Map类型字段
- *
- * @example
- * ```typescript
- * @SerializeAsMap()
- * inventory: Map<string, number> = new Map();
- * ```
- */
-export declare function SerializeAsMap(): (target: any, propertyKey: string | symbol) => void;
-/**
- * Set序列化装饰器
- *
- * 专门用于序列化Set类型字段
- *
- * @example
- * ```typescript
- * @SerializeAsSet()
- * tags: Set<string> = new Set();
- * ```
- */
-export declare function SerializeAsSet(): (target: any, propertyKey: string | symbol) => void;
-/**
- * 忽略序列化装饰器
- *
- * 标记字段不参与序列化
- *
- * @example
- * ```typescript
- * @IgnoreSerialization()
- * tempCache: any = null;
- * ```
- */
-export declare function IgnoreSerialization(): (target: any, propertyKey: string | symbol) => void;
-/**
- * 获取组件的序列化元数据
- *
- * @param componentClass 组件类或组件实例
- * @returns 序列化元数据，如果组件不可序列化则返回null
- */
-export declare function getSerializationMetadata(componentClass: any): SerializationMetadata | null;
-/**
- * 检查组件是否可序列化
- *
- * @param component 组件类或组件实例
- * @returns 如果组件可序列化返回true
- */
-export declare function isSerializable(component: any): boolean;
-//# sourceMappingURL=SerializationDecorators.d.ts.map

package/bin/ECS/Serialization/SerializationDecorators.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"SerializationDecorators.d.ts","sourceRoot":"","sources":["../../../src/ECS/Serialization/SerializationDecorators.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAEzC;;GAEG;AACH,eAAO,MAAM,qBAAqB,eAAiC,CAAC;AACpE,eAAO,MAAM,eAAe,eAA2B,CAAC;AACxD,eAAO,MAAM,iBAAiB,eAA6B,CAAC;AAE5D;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAChC;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IAClC;;OAEG;IACH,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,KAAK,GAAG,CAAC;IAEjC;;OAEG;IACH,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,KAAK,GAAG,CAAC;IAEnC;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IAClC,OAAO,EAAE,mBAAmB,CAAC;IAC7B,MAAM,EAAE,GAAG,CAAC,MAAM,GAAG,MAAM,EAAE,qBAAqB,CAAC,CAAC;IACpD,aAAa,EAAE,GAAG,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC;CACvC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,mBAAmB,IACpC,CAAC,SAAS,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,SAAS,EAAE,QAAQ,CAAC,KAAG,CAAC,CA6B9E;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,SAAS,CAAC,OAAO,CAAC,EAAE,qBAAqB,IACpC,QAAQ,GAAG,EAAE,aAAa,MAAM,GAAG,MAAM,UA0B7D;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,KACT,QAAQ,GAAG,EAAE,aAAa,MAAM,GAAG,MAAM,UAgB7D;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,KACT,QAAQ,GAAG,EAAE,aAAa,MAAM,GAAG,MAAM,UAgB7D;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,KACd,QAAQ,GAAG,EAAE,aAAa,MAAM,GAAG,MAAM,UA0B7D;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,cAAc,EAAE,GAAG,GAAG,qBAAqB,GAAG,IAAI,CAW1F;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,GAAG,GAAG,OAAO,CAEtD"}

package/bin/ECS/Serialization/SerializationDecorators.js

@@ -1,216 +0,0 @@
-/**
- * 序列化装饰器
- *
- * 提供组件级别的序列化支持，包括字段级装饰器和类级装饰器
- */
-/**
- * 序列化元数据的Symbol键
- */
-export const SERIALIZABLE_METADATA = Symbol('SerializableMetadata');
-export const SERIALIZE_FIELD = Symbol('SerializeField');
-export const SERIALIZE_OPTIONS = Symbol('SerializeOptions');
-/**
- * 组件可序列化装饰器
- *
- * 标记组件类为可序列化，必须与字段装饰器配合使用
- *
- * @param options 序列化配置选项
- *
- * @example
- * ```typescript
- * @ECSComponent('Player')
- * @Serializable({ version: 1 })
- * class PlayerComponent extends Component {
- *     @Serialize() name: string = 'Player';
- *     @Serialize() level: number = 1;
- * }
- * ```
- */
-export function Serializable(options) {
-    return function (target) {
-        if (!options || typeof options.version !== 'number') {
-            throw new Error('Serializable装饰器必须提供有效的版本号');
-        }
-        // 检查是否有自己的元数据（不是从父类继承的）
-        const hasOwnMetadata = Object.prototype.hasOwnProperty.call(target, SERIALIZABLE_METADATA);
-        let metadata;
-        if (hasOwnMetadata) {
-            // 已有自己的元数据，更新 options
-            metadata = target[SERIALIZABLE_METADATA];
-            metadata.options = options;
-        }
-        else {
-            // 没有自己的元数据，检查是否有继承的元数据
-            const inheritedMetadata = target[SERIALIZABLE_METADATA];
-            // 创建新的元数据对象（从继承的元数据复制字段，但使用新的 options）
-            metadata = {
-                options,
-                fields: inheritedMetadata ? new Map(inheritedMetadata.fields) : new Map(),
-                ignoredFields: inheritedMetadata ? new Set(inheritedMetadata.ignoredFields) : new Set()
-            };
-            target[SERIALIZABLE_METADATA] = metadata;
-        }
-        return target;
-    };
-}
-/**
- * 字段序列化装饰器
- *
- * 标记字段为可序列化
- *
- * @param options 字段序列化选项（可选）
- *
- * @example
- * ```typescript
- * @Serialize()
- * name: string = 'Player';
- *
- * @Serialize({ alias: 'hp' })
- * health: number = 100;
- * ```
- */
-export function Serialize(options) {
-    return function (target, propertyKey) {
-        const constructor = target.constructor;
-        // 检查是否有自己的元数据（不是从父类继承的）
-        const hasOwnMetadata = Object.prototype.hasOwnProperty.call(constructor, SERIALIZABLE_METADATA);
-        let metadata;
-        if (hasOwnMetadata) {
-            // 已有自己的元数据
-            metadata = constructor[SERIALIZABLE_METADATA];
-        }
-        else {
-            // 没有自己的元数据，检查是否有继承的元数据
-            const inheritedMetadata = constructor[SERIALIZABLE_METADATA];
-            // 创建新的元数据对象（从继承的元数据复制）
-            metadata = {
-                options: inheritedMetadata ? { ...inheritedMetadata.options } : { version: 1 },
-                fields: inheritedMetadata ? new Map(inheritedMetadata.fields) : new Map(),
-                ignoredFields: inheritedMetadata ? new Set(inheritedMetadata.ignoredFields) : new Set()
-            };
-            constructor[SERIALIZABLE_METADATA] = metadata;
-        }
-        // 记录字段
-        metadata.fields.set(propertyKey, options || {});
-    };
-}
-/**
- * Map序列化装饰器
- *
- * 专门用于序列化Map类型字段
- *
- * @example
- * ```typescript
- * @SerializeAsMap()
- * inventory: Map<string, number> = new Map();
- * ```
- */
-export function SerializeAsMap() {
-    return function (target, propertyKey) {
-        Serialize({
-            serializer: (value) => {
-                if (!(value instanceof Map)) {
-                    return null;
-                }
-                return Array.from(value.entries());
-            },
-            deserializer: (value) => {
-                if (!Array.isArray(value)) {
-                    return new Map();
-                }
-                return new Map(value);
-            }
-        })(target, propertyKey);
-    };
-}
-/**
- * Set序列化装饰器
- *
- * 专门用于序列化Set类型字段
- *
- * @example
- * ```typescript
- * @SerializeAsSet()
- * tags: Set<string> = new Set();
- * ```
- */
-export function SerializeAsSet() {
-    return function (target, propertyKey) {
-        Serialize({
-            serializer: (value) => {
-                if (!(value instanceof Set)) {
-                    return null;
-                }
-                return Array.from(value);
-            },
-            deserializer: (value) => {
-                if (!Array.isArray(value)) {
-                    return new Set();
-                }
-                return new Set(value);
-            }
-        })(target, propertyKey);
-    };
-}
-/**
- * 忽略序列化装饰器
- *
- * 标记字段不参与序列化
- *
- * @example
- * ```typescript
- * @IgnoreSerialization()
- * tempCache: any = null;
- * ```
- */
-export function IgnoreSerialization() {
-    return function (target, propertyKey) {
-        const constructor = target.constructor;
-        // 检查是否有自己的元数据（不是从父类继承的）
-        const hasOwnMetadata = Object.prototype.hasOwnProperty.call(constructor, SERIALIZABLE_METADATA);
-        let metadata;
-        if (hasOwnMetadata) {
-            // 已有自己的元数据
-            metadata = constructor[SERIALIZABLE_METADATA];
-        }
-        else {
-            // 没有自己的元数据，检查是否有继承的元数据
-            const inheritedMetadata = constructor[SERIALIZABLE_METADATA];
-            // 创建新的元数据对象（从继承的元数据复制）
-            metadata = {
-                options: inheritedMetadata ? { ...inheritedMetadata.options } : { version: 1 },
-                fields: inheritedMetadata ? new Map(inheritedMetadata.fields) : new Map(),
-                ignoredFields: inheritedMetadata ? new Set(inheritedMetadata.ignoredFields) : new Set()
-            };
-            constructor[SERIALIZABLE_METADATA] = metadata;
-        }
-        // 记录忽略字段
-        metadata.ignoredFields.add(propertyKey);
-    };
-}
-/**
- * 获取组件的序列化元数据
- *
- * @param componentClass 组件类或组件实例
- * @returns 序列化元数据，如果组件不可序列化则返回null
- */
-export function getSerializationMetadata(componentClass) {
-    if (!componentClass) {
-        return null;
-    }
-    // 如果是实例，获取其构造函数
-    const constructor = typeof componentClass === 'function'
-        ? componentClass
-        : componentClass.constructor;
-    return constructor[SERIALIZABLE_METADATA] || null;
-}
-/**
- * 检查组件是否可序列化
- *
- * @param component 组件类或组件实例
- * @returns 如果组件可序列化返回true
- */
-export function isSerializable(component) {
-    return getSerializationMetadata(component) !== null;
-}
-//# sourceMappingURL=SerializationDecorators.js.map

package/bin/ECS/Serialization/SerializationDecorators.js.map

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

package/bin/ECS/Serialization/VersionMigration.d.ts

@@ -1,156 +0,0 @@
-/**
- * 版本迁移系统
- *
- * 提供组件和场景数据的版本迁移支持
- */
-import { SerializedComponent } from './ComponentSerializer';
-import { SerializedScene } from './SceneSerializer';
-/**
- * 组件迁移函数
- */
-export type ComponentMigrationFunction = (data: any, fromVersion: number, toVersion: number) => any;
-/**
- * 场景迁移函数
- */
-export type SceneMigrationFunction = (scene: SerializedScene, fromVersion: number, toVersion: number) => SerializedScene;
-/**
- * 版本迁移管理器
- */
-export declare class VersionMigrationManager {
-    /**
-     * 组件迁移函数注册表
-     * Map<组件类型名, Map<版本号, 迁移函数>>
-     */
-    private static componentMigrations;
-    /**
-     * 场景迁移函数注册表
-     * Map<版本号, 迁移函数>
-     */
-    private static sceneMigrations;
-    /**
-     * 注册组件迁移函数
-     *
-     * @param componentType 组件类型名称
-     * @param fromVersion 源版本号
-     * @param toVersion 目标版本号
-     * @param migration 迁移函数
-     *
-     * @example
-     * ```typescript
-     * // 从版本1迁移到版本2
-     * VersionMigrationManager.registerComponentMigration(
-     *     'PlayerComponent',
-     *     1,
-     *     2,
-     *     (data) => {
-     *         // 添加新字段
-     *         data.experience = 0;
-     *         return data;
-     *     }
-     * );
-     * ```
-     */
-    static registerComponentMigration(componentType: string, fromVersion: number, _toVersion: number, migration: ComponentMigrationFunction): void;
-    /**
-     * 注册场景迁移函数
-     *
-     * @param fromVersion 源版本号
-     * @param toVersion 目标版本号
-     * @param migration 迁移函数
-     *
-     * @example
-     * ```typescript
-     * VersionMigrationManager.registerSceneMigration(
-     *     1,
-     *     2,
-     *     (scene) => {
-     *         // 迁移场景结构
-     *         scene.metadata = { ...scene.metadata, migratedFrom: 1 };
-     *         return scene;
-     *     }
-     * );
-     * ```
-     */
-    static registerSceneMigration(fromVersion: number, _toVersion: number, migration: SceneMigrationFunction): void;
-    /**
-     * 迁移组件数据
-     *
-     * @param component 序列化的组件数据
-     * @param targetVersion 目标版本号
-     * @returns 迁移后的组件数据
-     */
-    static migrateComponent(component: SerializedComponent, targetVersion: number): SerializedComponent;
-    /**
-     * 迁移场景数据
-     *
-     * @param scene 序列化的场景数据
-     * @param targetVersion 目标版本号
-     * @returns 迁移后的场景数据
-     */
-    static migrateScene(scene: SerializedScene, targetVersion: number): SerializedScene;
-    /**
-     * 迁移场景中所有组件的版本
-     */
-    private static migrateSceneComponents;
-    /**
-     * 递归迁移实体的组件
-     */
-    private static migrateEntitiesComponents;
-    /**
-     * 清除所有迁移函数
-     */
-    static clearMigrations(): void;
-    /**
-     * 获取组件的迁移路径
-     *
-     * @param componentType 组件类型名称
-     * @returns 可用的迁移版本列表
-     */
-    static getComponentMigrationPath(componentType: string): number[];
-    /**
-     * 获取场景的迁移路径
-     *
-     * @returns 可用的场景迁移版本列表
-     */
-    static getSceneMigrationPath(): number[];
-    /**
-     * 检查是否可以迁移组件
-     *
-     * @param componentType 组件类型名称
-     * @param fromVersion 源版本
-     * @param toVersion 目标版本
-     * @returns 是否存在完整的迁移路径
-     */
-    static canMigrateComponent(componentType: string, fromVersion: number, toVersion: number): boolean;
-    /**
-     * 检查是否可以迁移场景
-     *
-     * @param fromVersion 源版本
-     * @param toVersion 目标版本
-     * @returns 是否存在完整的迁移路径
-     */
-    static canMigrateScene(fromVersion: number, toVersion: number): boolean;
-}
-/**
- * 便捷的迁移构建器
- *
- * 提供链式API来定义迁移
- */
-export declare class MigrationBuilder {
-    private componentType?;
-    private fromVersion;
-    private toVersion;
-    /**
-     * 设置组件类型
-     */
-    forComponent(componentType: string): this;
-    /**
-     * 设置版本范围
-     */
-    fromVersionToVersion(from: number, to: number): this;
-    /**
-     * 注册迁移函数
-     */
-    migrate(migration: ComponentMigrationFunction | SceneMigrationFunction): void;
-}
-//# sourceMappingURL=VersionMigration.d.ts.map

package/bin/ECS/Serialization/VersionMigration.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"VersionMigration.d.ts","sourceRoot":"","sources":["../../../src/ECS/Serialization/VersionMigration.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEpD;;GAEG;AACH,MAAM,MAAM,0BAA0B,GAAG,CAAC,IAAI,EAAE,GAAG,EAAE,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,KAAK,GAAG,CAAC;AAEpG;;GAEG;AACH,MAAM,MAAM,sBAAsB,GAAG,CACjC,KAAK,EAAE,eAAe,EACtB,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,KAChB,eAAe,CAAC;AAErB;;GAEG;AACH,qBAAa,uBAAuB;IAChC;;;OAGG;IACH,OAAO,CAAC,MAAM,CAAC,mBAAmB,CAA8D;IAEhG;;;OAGG;IACH,OAAO,CAAC,MAAM,CAAC,eAAe,CAA6C;IAE3E;;;;;;;;;;;;;;;;;;;;;;OAsBG;WACW,0BAA0B,CACpC,aAAa,EAAE,MAAM,EACrB,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,0BAA0B,GACtC,IAAI;IAWP;;;;;;;;;;;;;;;;;;;OAmBG;WACW,sBAAsB,CAChC,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,sBAAsB,GAClC,IAAI;IAIP;;;;;;OAMG;WACW,gBAAgB,CAC1B,SAAS,EAAE,mBAAmB,EAC9B,aAAa,EAAE,MAAM,GACtB,mBAAmB;IAmCtB;;;;;;OAMG;WACW,YAAY,CAAC,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,GAAG,eAAe;IA+B1F;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,sBAAsB;IAuBrC;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,yBAAyB;IAmBxC;;OAEG;WACW,eAAe,IAAI,IAAI;IAKrC;;;;;OAKG;WACW,yBAAyB,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,EAAE;IASxE;;;;OAIG;WACW,qBAAqB,IAAI,MAAM,EAAE;IAI/C;;;;;;;OAOG;WACW,mBAAmB,CAC7B,aAAa,EAAE,MAAM,EACrB,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,GAClB,OAAO;IAoBV;;;;;;OAMG;WACW,eAAe,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO;CAcjF;AAED;;;;GAIG;AACH,qBAAa,gBAAgB;IACzB,OAAO,CAAC,aAAa,CAAC,CAAS;IAC/B,OAAO,CAAC,WAAW,CAAa;IAChC,OAAO,CAAC,SAAS,CAAa;IAE9B;;OAEG;IACI,YAAY,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI;IAKhD;;OAEG;IACI,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI;IAM3D;;OAEG;IACI,OAAO,CAAC,SAAS,EAAE,0BAA0B,GAAG,sBAAsB,GAAG,IAAI;CAgBvF"}