@esengine/ecs-framework 2.2.20 → 2.3.0

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

@@ -0,0 +1,136 @@
+/**
+ * 序列化装饰器
+ *
+ * 提供组件级别的序列化支持，包括字段级装饰器和类级装饰器
+ */
+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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,216 @@
+/**
+ * 序列化装饰器
+ *
+ * 提供组件级别的序列化支持，包括字段级装饰器和类级装饰器
+ */
+/**
+ * 序列化元数据的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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,156 @@
+/**
+ * 版本迁移系统
+ *
+ * 提供组件和场景数据的版本迁移支持
+ */
+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

@@ -0,0 +1 @@
+{"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"}