@esengine/ecs-framework 2.2.20 → 2.3.0

package/bin/ECS/Utils/Bits.d.ts

@@ -0,0 +1,154 @@
+import { BitMask64Data } from './BigIntCompatibility';
+/**
+ * 位集合类，用于高效的位操作
+ * 支持任意位的位运算操作.
+ */
+export declare class Bits {
+    /** 存储位数据的掩码，支持扩展 */
+    private _value;
+    /**
+     * 构造函数，创建位集合
+     * @param initialValue 初始值，可以是BitMask64Data对象、数字或字符串
+     */
+    constructor(initialValue?: BitMask64Data | number | string);
+    /**
+     * 设置指定位为1
+     * 自动扩展：当索引超过 64 时，自动扩展到 128/256 位
+     * @param index 位索引（0-based）
+     * @throws 当位索引为负数时抛出错误
+     */
+    set(index: number): void;
+    /**
+     * 清除指定位为0
+     * @param index 位索引
+     * @throws 当位索引为负数时抛出错误
+     */
+    clear(index: number): void;
+    /**
+     * 获取指定位的值
+     * @param index 位索引
+     * @returns 如果位被设置为1则返回true，否则返回false
+     */
+    get(index: number): boolean;
+    /**
+     * 检查是否包含另一个位集合的所有位
+     * @param other 另一个位集合
+     * @returns 如果包含other的所有设置位则返回true
+     */
+    containsAll(other: Bits): boolean;
+    /**
+     * 检查是否与另一个位集合有交集
+     * @param other 另一个位集合
+     * @returns 如果有共同的设置位则返回true
+     */
+    intersects(other: Bits): boolean;
+    /**
+     * 检查是否与另一个位集合没有交集
+     * @param other 另一个位集合
+     * @returns 如果没有共同的设置位则返回true
+     */
+    excludes(other: Bits): boolean;
+    /**
+     * 清除所有位为0
+     */
+    clearAll(): void;
+    /**
+     * 检查位集合是否为空
+     * @returns 如果所有位都为0则返回true
+     */
+    isEmpty(): boolean;
+    /**
+     * 计算设置为1的位数
+     * @returns 设置位的总数
+     */
+    cardinality(): number;
+    /**
+     * 与另一个位集合执行按位与操作
+     * @param other 另一个位集合
+     * @returns 新的位集合，包含按位与的结果
+     */
+    and(other: Bits): Bits;
+    /**
+     * 与另一个位集合执行按位或操作
+     * @param other 另一个位集合
+     * @returns 新的位集合，包含按位或的结果
+     */
+    or(other: Bits): Bits;
+    /**
+     * 与另一个位集合执行按位异或操作
+     * @param other 另一个位集合
+     * @returns 新的位集合，包含按位异或的结果
+     */
+    xor(other: Bits): Bits;
+    /**
+     * 执行按位取反操作
+     * @param maxBits 最大位数，默认为64
+     * @returns 新的位集合，包含按位取反的结果
+     */
+    not(maxBits?: number): Bits;
+    /**
+     * 从另一个位集合复制值
+     * @param other 源位集合
+     */
+    copyFrom(other: Bits): void;
+    /**
+     * 创建当前位集合的深拷贝
+     * @returns 新的位集合，内容与当前位集合相同
+     */
+    clone(): Bits;
+    /**
+     * 获取内部的64位掩码数据
+     * @returns 内部存储的BitMask64Data对象
+     */
+    getValue(): BitMask64Data;
+    /**
+     * 设置位集合的值
+     * @param value 新值，可以是BitMask64Data对象、数字或字符串
+     */
+    setValue(value: BitMask64Data | number | string): void;
+    /**
+     * 将位集合转换为可读字符串
+     * @returns 格式为"Bits[index1, index2, ...]"的字符串
+     */
+    toString(): string;
+    /**
+     * 将位集合转换为二进制字符串
+     * @param maxBits 最大位数，默认为64
+     * @returns 二进制字符串表示，每8位用空格分隔
+     */
+    toBinaryString(maxBits?: number): string;
+    /**
+     * 将位集合转换为十六进制字符串
+     * @returns 十六进制字符串表示，带0x前缀
+     */
+    toHexString(): string;
+    /**
+     * 从二进制字符串创建位集合
+     * @param binaryString 二进制字符串，可以包含空格
+     * @returns 新的位集合对象
+     */
+    static fromBinaryString(binaryString: string): Bits;
+    /**
+     * 从十六进制字符串创建位集合
+     * @param hexString 十六进制字符串，可以带或不带0x前缀
+     * @returns 新的位集合对象
+     */
+    static fromHexString(hexString: string): Bits;
+    /**
+     * 检查是否与另一个位集合相等
+     * @param other 另一个位集合
+     * @returns 如果两个位集合完全相同则返回true
+     */
+    equals(other: Bits): boolean;
+    /**
+     * 获取最高位设置位的索引
+     * @returns 最高位设置位的索引，如果位集合为空则返回-1
+     */
+    getHighestBitIndex(): number;
+    /**
+     * 获取最低位设置位的索引
+     * @returns 最低位设置位的索引，如果位集合为空则返回-1
+     */
+    getLowestBitIndex(): number;
+}
+//# sourceMappingURL=Bits.d.ts.map

package/bin/ECS/Utils/Bits.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Bits.d.ts","sourceRoot":"","sources":["../../../src/ECS/Utils/Bits.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,aAAa,EAAkB,MAAM,uBAAuB,CAAC;AAEnF;;;GAGG;AACH,qBAAa,IAAI;IACb,oBAAoB;IACpB,OAAO,CAAC,MAAM,CAAgB;IAE9B;;;OAGG;gBACS,YAAY,CAAC,EAAE,aAAa,GAAG,MAAM,GAAG,MAAM;IAa1D;;;;;OAKG;IACI,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAQ/B;;;;OAIG;IACI,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAQjC;;;;OAIG;IACI,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAIlC;;;;OAIG;IACI,WAAW,CAAC,KAAK,EAAE,IAAI,GAAG,OAAO;IAIxC;;;;OAIG;IACI,UAAU,CAAC,KAAK,EAAE,IAAI,GAAG,OAAO;IAIvC;;;;OAIG;IACI,QAAQ,CAAC,KAAK,EAAE,IAAI,GAAG,OAAO;IAIrC;;OAEG;IACI,QAAQ,IAAI,IAAI;IAIvB;;;OAGG;IACI,OAAO,IAAI,OAAO;IAIzB;;;OAGG;IACI,WAAW,IAAI,MAAM;IAI5B;;;;OAIG;IACI,GAAG,CAAC,KAAK,EAAE,IAAI,GAAG,IAAI;IAO7B;;;;OAIG;IACI,EAAE,CAAC,KAAK,EAAE,IAAI,GAAG,IAAI;IAO5B;;;;OAIG;IACI,GAAG,CAAC,KAAK,EAAE,IAAI,GAAG,IAAI;IAO7B;;;;OAIG;IACI,GAAG,CAAC,OAAO,GAAE,MAAW,GAAG,IAAI;IA0BtC;;;OAGG;IACI,QAAQ,CAAC,KAAK,EAAE,IAAI,GAAG,IAAI;IAIlC;;;OAGG;IACI,KAAK,IAAI,IAAI;IAIpB;;;OAGG;IACI,QAAQ,IAAI,aAAa;IAIhC;;;OAGG;IACI,QAAQ,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM,GAAG,MAAM,GAAG,IAAI;IAW7D;;;OAGG;IACI,QAAQ,IAAI,MAAM;IAUzB;;;;OAIG;IACI,cAAc,CAAC,OAAO,GAAE,MAAU,GAAG,MAAM;IAclD;;;OAGG;IACI,WAAW,IAAI,MAAM;IAI5B;;;;OAIG;WACW,gBAAgB,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI;IAgB1D;;;;OAIG;WACW,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAgBpD;;;;OAIG;IACI,MAAM,CAAC,KAAK,EAAE,IAAI,GAAG,OAAO;IAInC;;;OAGG;IACI,kBAAkB,IAAI,MAAM;IAsBnC;;;OAGG;IACI,iBAAiB,IAAI,MAAM;CAmBrC"}

package/bin/ECS/Utils/Bits.js

@@ -0,0 +1,331 @@
+import { SegmentPart, BitMask64Utils } from './BigIntCompatibility';
+/**
+ * 位集合类，用于高效的位操作
+ * 支持任意位的位运算操作.
+ */
+export class Bits {
+    /**
+     * 构造函数，创建位集合
+     * @param initialValue 初始值，可以是BitMask64Data对象、数字或字符串
+     */
+    constructor(initialValue) {
+        if (initialValue && typeof initialValue === 'object') {
+            this._value = BitMask64Utils.clone(initialValue);
+        }
+        else if (typeof initialValue === 'number') {
+            this._value = BitMask64Utils.fromNumber(initialValue);
+        }
+        else if (typeof initialValue === 'string') {
+            const num = parseInt(initialValue, 10);
+            this._value = BitMask64Utils.fromNumber(num);
+        }
+        else {
+            this._value = BitMask64Utils.clone(BitMask64Utils.ZERO);
+        }
+    }
+    /**
+     * 设置指定位为1
+     * 自动扩展：当索引超过 64 时，自动扩展到 128/256 位
+     * @param index 位索引（0-based）
+     * @throws 当位索引为负数时抛出错误
+     */
+    set(index) {
+        if (index < 0) {
+            throw new Error('Bit index cannot be negative');
+        }
+        BitMask64Utils.setBit(this._value, index);
+    }
+    /**
+     * 清除指定位为0
+     * @param index 位索引
+     * @throws 当位索引为负数时抛出错误
+     */
+    clear(index) {
+        if (index < 0) {
+            throw new Error('Bit index cannot be negative');
+        }
+        BitMask64Utils.clearBit(this._value, index);
+    }
+    /**
+     * 获取指定位的值
+     * @param index 位索引
+     * @returns 如果位被设置为1则返回true，否则返回false
+     */
+    get(index) {
+        return BitMask64Utils.getBit(this._value, index);
+    }
+    /**
+     * 检查是否包含另一个位集合的所有位
+     * @param other 另一个位集合
+     * @returns 如果包含other的所有设置位则返回true
+     */
+    containsAll(other) {
+        return BitMask64Utils.hasAll(this._value, other._value);
+    }
+    /**
+     * 检查是否与另一个位集合有交集
+     * @param other 另一个位集合
+     * @returns 如果有共同的设置位则返回true
+     */
+    intersects(other) {
+        return BitMask64Utils.hasAny(this._value, other._value);
+    }
+    /**
+     * 检查是否与另一个位集合没有交集
+     * @param other 另一个位集合
+     * @returns 如果没有共同的设置位则返回true
+     */
+    excludes(other) {
+        return BitMask64Utils.hasNone(this._value, other._value);
+    }
+    /**
+     * 清除所有位为0
+     */
+    clearAll() {
+        BitMask64Utils.clear(this._value);
+    }
+    /**
+     * 检查位集合是否为空
+     * @returns 如果所有位都为0则返回true
+     */
+    isEmpty() {
+        return BitMask64Utils.isZero(this._value);
+    }
+    /**
+     * 计算设置为1的位数
+     * @returns 设置位的总数
+     */
+    cardinality() {
+        return BitMask64Utils.popCount(this._value);
+    }
+    /**
+     * 与另一个位集合执行按位与操作
+     * @param other 另一个位集合
+     * @returns 新的位集合，包含按位与的结果
+     */
+    and(other) {
+        const result = new Bits();
+        BitMask64Utils.copy(this._value, result._value);
+        BitMask64Utils.andInPlace(result._value, other._value);
+        return result;
+    }
+    /**
+     * 与另一个位集合执行按位或操作
+     * @param other 另一个位集合
+     * @returns 新的位集合，包含按位或的结果
+     */
+    or(other) {
+        const result = new Bits();
+        BitMask64Utils.copy(this._value, result._value);
+        BitMask64Utils.orInPlace(result._value, other._value);
+        return result;
+    }
+    /**
+     * 与另一个位集合执行按位异或操作
+     * @param other 另一个位集合
+     * @returns 新的位集合，包含按位异或的结果
+     */
+    xor(other) {
+        const result = new Bits();
+        BitMask64Utils.copy(this._value, result._value);
+        BitMask64Utils.xorInPlace(result._value, other._value);
+        return result;
+    }
+    /**
+     * 执行按位取反操作
+     * @param maxBits 最大位数，默认为64
+     * @returns 新的位集合，包含按位取反的结果
+     */
+    not(maxBits = 64) {
+        if (maxBits > 64) {
+            maxBits = 64;
+        }
+        const result = new Bits();
+        BitMask64Utils.copy(this._value, result._value);
+        if (maxBits <= 32) {
+            const mask = (1 << maxBits) - 1;
+            result._value.base[SegmentPart.LOW] = (~result._value.base[SegmentPart.LOW]) & mask;
+            result._value.base[SegmentPart.HIGH] = 0;
+        }
+        else {
+            result._value.base[SegmentPart.LOW] = ~result._value.base[SegmentPart.LOW];
+            if (maxBits < 64) {
+                const remainingBits = maxBits - 32;
+                const mask = (1 << remainingBits) - 1;
+                result._value.base[SegmentPart.HIGH] = (~result._value.base[SegmentPart.HIGH]) & mask;
+            }
+            else {
+                result._value.base[SegmentPart.HIGH] = ~result._value.base[SegmentPart.HIGH];
+            }
+        }
+        return result;
+    }
+    /**
+     * 从另一个位集合复制值
+     * @param other 源位集合
+     */
+    copyFrom(other) {
+        BitMask64Utils.copy(other._value, this._value);
+    }
+    /**
+     * 创建当前位集合的深拷贝
+     * @returns 新的位集合，内容与当前位集合相同
+     */
+    clone() {
+        return new Bits(this._value);
+    }
+    /**
+     * 获取内部的64位掩码数据
+     * @returns 内部存储的BitMask64Data对象
+     */
+    getValue() {
+        return this._value;
+    }
+    /**
+     * 设置位集合的值
+     * @param value 新值，可以是BitMask64Data对象、数字或字符串
+     */
+    setValue(value) {
+        if (typeof value === 'object') {
+            BitMask64Utils.copy(value, this._value);
+        }
+        else if (typeof value === 'number') {
+            this._value = BitMask64Utils.fromNumber(value);
+        }
+        else {
+            const num = parseInt(value, 10);
+            this._value = BitMask64Utils.fromNumber(num);
+        }
+    }
+    /**
+     * 将位集合转换为可读字符串
+     * @returns 格式为"Bits[index1, index2, ...]"的字符串
+     */
+    toString() {
+        const bits = [];
+        for (let i = 0; i < 64; i++) {
+            if (this.get(i)) {
+                bits.push(i.toString());
+            }
+        }
+        return `Bits[${bits.join(', ')}]`;
+    }
+    /**
+     * 将位集合转换为二进制字符串
+     * @param maxBits 最大位数，默认为64
+     * @returns 二进制字符串表示，每8位用空格分隔
+     */
+    toBinaryString(maxBits = 0) {
+        if (maxBits == 0) {
+            maxBits = 64 + (this._value.segments ? this._value.segments.length * 64 : 0);
+        }
+        let result = '';
+        for (let i = maxBits - 1; i >= 0; i--) {
+            result += this.get(i) ? '1' : '0';
+            if (i % 8 === 0 && i > 0) {
+                result += ' ';
+            }
+        }
+        return result;
+    }
+    /**
+     * 将位集合转换为十六进制字符串
+     * @returns 十六进制字符串表示，带0x前缀
+     */
+    toHexString() {
+        return BitMask64Utils.toString(this._value, 16);
+    }
+    /**
+     * 从二进制字符串创建位集合
+     * @param binaryString 二进制字符串，可以包含空格
+     * @returns 新的位集合对象
+     */
+    static fromBinaryString(binaryString) {
+        const cleanString = binaryString.replace(/\s/g, '');
+        let data;
+        if (cleanString.length <= 32) {
+            const num = parseInt(cleanString, 2);
+            data = { base: [num >>> 0, 0] };
+        }
+        else {
+            const loBits = cleanString.substring(cleanString.length - 32);
+            const hiBits = cleanString.substring(0, cleanString.length - 32);
+            const lo = parseInt(loBits, 2);
+            const hi = parseInt(hiBits, 2);
+            data = { base: [lo >>> 0, hi >>> 0] };
+        }
+        return new Bits(data);
+    }
+    /**
+     * 从十六进制字符串创建位集合
+     * @param hexString 十六进制字符串，可以带或不带0x前缀
+     * @returns 新的位集合对象
+     */
+    static fromHexString(hexString) {
+        const cleanString = hexString.replace(/^0x/i, '');
+        let data;
+        if (cleanString.length <= 8) {
+            const num = parseInt(cleanString, 16);
+            data = { base: [num >>> 0, 0] };
+        }
+        else {
+            const loBits = cleanString.substring(cleanString.length - 8);
+            const hiBits = cleanString.substring(0, cleanString.length - 8);
+            const lo = parseInt(loBits, 16);
+            const hi = parseInt(hiBits, 16);
+            data = { base: [lo >>> 0, hi >>> 0] };
+        }
+        return new Bits(data);
+    }
+    /**
+     * 检查是否与另一个位集合相等
+     * @param other 另一个位集合
+     * @returns 如果两个位集合完全相同则返回true
+     */
+    equals(other) {
+        return BitMask64Utils.equals(this._value, other._value);
+    }
+    /**
+     * 获取最高位设置位的索引
+     * @returns 最高位设置位的索引，如果位集合为空则返回-1
+     */
+    getHighestBitIndex() {
+        if (BitMask64Utils.isZero(this._value)) {
+            return -1;
+        }
+        if (this._value.base[SegmentPart.HIGH] !== 0) {
+            for (let i = 31; i >= 0; i--) {
+                if ((this._value.base[SegmentPart.HIGH] & (1 << i)) !== 0) {
+                    return i + 32;
+                }
+            }
+        }
+        for (let i = 31; i >= 0; i--) {
+            if ((this._value.base[SegmentPart.LOW] & (1 << i)) !== 0) {
+                return i;
+            }
+        }
+        return -1;
+    }
+    /**
+     * 获取最低位设置位的索引
+     * @returns 最低位设置位的索引，如果位集合为空则返回-1
+     */
+    getLowestBitIndex() {
+        if (BitMask64Utils.isZero(this._value)) {
+            return -1;
+        }
+        for (let i = 0; i < 32; i++) {
+            if ((this._value.base[SegmentPart.LOW] & (1 << i)) !== 0) {
+                return i;
+            }
+        }
+        for (let i = 0; i < 32; i++) {
+            if ((this._value.base[SegmentPart.HIGH] & (1 << i)) !== 0) {
+                return i + 32;
+            }
+        }
+        return -1;
+    }
+}
+//# sourceMappingURL=Bits.js.map

package/bin/ECS/Utils/Bits.js.map

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

package/bin/ECS/Utils/ComponentSparseSet.d.ts

@@ -0,0 +1,143 @@
+import { Entity } from '../Entity';
+import { ComponentType } from '../Core/ComponentStorage';
+import { BitMask64Data } from './BigIntCompatibility';
+/**
+ * 组件稀疏集合实现
+ *
+ * 结合通用稀疏集合和组件位掩码
+ *
+ * 存储结构：
+ * - 稀疏集合存储实体
+ * - 位掩码数组存储组件信息
+ * - 组件类型映射表
+ */
+export declare class ComponentSparseSet {
+    /**
+     * 实体稀疏集合
+     *
+     * 存储所有拥有组件的实体，提供O(1)的实体操作。
+     */
+    private _entities;
+    /**
+     * 组件位掩码数组
+     *
+     * 与实体稀疏集合的密集数组对应，存储每个实体的组件位掩码。
+     * 数组索引与稀疏集合的密集数组索引一一对应。
+     */
+    private _componentMasks;
+    /**
+     * 组件类型到实体集合的映射
+     *
+     * 维护每个组件类型对应的实体集合，用于快速的单组件查询。
+     */
+    private _componentToEntities;
+    /**
+     * 实体集合对象池
+     *
+     * 使用core库的Pool系统来管理PoolableEntitySet对象的复用。
+     */
+    private static _entitySetPool;
+    constructor();
+    /**
+     * 添加实体到组件索引
+     *
+     * 分析实体的组件组成，生成位掩码，并更新所有相关索引。
+     *
+     * @param entity 要添加的实体
+     */
+    addEntity(entity: Entity): void;
+    /**
+     * 从组件索引中移除实体
+     *
+     * 清理实体相关的所有索引数据，保持数据结构的紧凑性。
+     *
+     * @param entity 要移除的实体
+     */
+    removeEntity(entity: Entity): void;
+    /**
+     * 查询包含指定组件的所有实体
+     *
+     * @param componentType 组件类型
+     * @returns 包含该组件的实体集合
+     */
+    queryByComponent(componentType: ComponentType): Set<Entity>;
+    /**
+     * 多组件查询（AND操作）
+     *
+     * 查找同时包含所有指定组件的实体。
+     *
+     * @param componentTypes 组件类型数组
+     * @returns 满足条件的实体集合
+     */
+    queryMultipleAnd(componentTypes: ComponentType[]): Set<Entity>;
+    /**
+     * 多组件查询（OR操作）
+     *
+     * 查找包含任意一个指定组件的实体。
+     *
+     * @param componentTypes 组件类型数组
+     * @returns 满足条件的实体集合
+     */
+    queryMultipleOr(componentTypes: ComponentType[]): Set<Entity>;
+    /**
+     * 检查实体是否包含指定组件
+     *
+     * @param entity 实体
+     * @param componentType 组件类型
+     * @returns 是否包含该组件
+     */
+    hasComponent(entity: Entity, componentType: ComponentType): boolean;
+    /**
+     * 获取实体的组件位掩码
+     *
+     * @param entity 实体
+     * @returns 组件位掩码，如果实体不存在则返回undefined
+     */
+    getEntityMask(entity: Entity): BitMask64Data | undefined;
+    /**
+     * 获取所有实体
+     *
+     * @returns 所有实体的数组
+     */
+    getAllEntities(): Entity[];
+    /**
+     * 获取实体数量
+     */
+    get size(): number;
+    /**
+     * 检查是否为空
+     */
+    get isEmpty(): boolean;
+    /**
+     * 遍历所有实体
+     *
+     * @param callback 遍历回调函数
+     */
+    forEach(callback: (entity: Entity, mask: BitMask64Data, index: number) => void): void;
+    /**
+     * 清空所有数据
+     */
+    clear(): void;
+    /**
+     * 获取内存使用统计
+     */
+    getMemoryStats(): {
+        entitiesMemory: number;
+        masksMemory: number;
+        mappingsMemory: number;
+        totalMemory: number;
+    };
+    /**
+     * 验证数据结构完整性
+     */
+    validate(): boolean;
+    /**
+     * 获取实体的组件类型集合
+     */
+    private getEntityComponentTypes;
+    /**
+     * 更新组件类型到实体的映射
+     */
+    private updateComponentMappings;
+}
+//# sourceMappingURL=ComponentSparseSet.d.ts.map

package/bin/ECS/Utils/ComponentSparseSet.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ComponentSparseSet.d.ts","sourceRoot":"","sources":["../../../src/ECS/Utils/ComponentSparseSet.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AACnC,OAAO,EAAE,aAAa,EAAqB,MAAM,0BAA0B,CAAC;AAC5E,OAAO,EAAkB,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAoBtE;;;;;;;;;GASG;AACH,qBAAa,kBAAkB;IAC3B;;;;OAIG;IACH,OAAO,CAAC,SAAS,CAAoB;IAErC;;;;;OAKG;IACH,OAAO,CAAC,eAAe,CAAuB;IAE9C;;;;OAIG;IACH,OAAO,CAAC,oBAAoB,CAA+C;IAE3E;;;;OAIG;IACH,OAAO,CAAC,MAAM,CAAC,cAAc,CAA4C;;IAMzE;;;;;;OAMG;IACI,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAsCtC;;;;;;OAMG;IACI,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAwBzC;;;;;OAKG;IACI,gBAAgB,CAAC,aAAa,EAAE,aAAa,GAAG,GAAG,CAAC,MAAM,CAAC;IAKlE;;;;;;;OAOG;IACI,gBAAgB,CAAC,cAAc,EAAE,aAAa,EAAE,GAAG,GAAG,CAAC,MAAM,CAAC;IAgCrE;;;;;;;OAOG;IACI,eAAe,CAAC,cAAc,EAAE,aAAa,EAAE,GAAG,GAAG,CAAC,MAAM,CAAC;IAmCpE;;;;;;OAMG;IACI,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,aAAa,GAAG,OAAO;IAgB1E;;;;;OAKG;IACI,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS;IAQ/D;;;;OAIG;IACI,cAAc,IAAI,MAAM,EAAE;IAIjC;;OAEG;IACH,IAAW,IAAI,IAAI,MAAM,CAExB;IAED;;OAEG;IACH,IAAW,OAAO,IAAI,OAAO,CAE5B;IAED;;;;OAIG;IACI,OAAO,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI;IAM5F;;OAEG;IACI,KAAK,IAAI,IAAI;IAWpB;;OAEG;IACI,cAAc,IAAI;QACrB,cAAc,EAAE,MAAM,CAAC;QACvB,WAAW,EAAE,MAAM,CAAC;QACpB,cAAc,EAAE,MAAM,CAAC;QACvB,WAAW,EAAE,MAAM,CAAC;KACnB;IAiBL;;OAEG;IACI,QAAQ,IAAI,OAAO;IA6B1B;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAQ/B;;OAEG;IACH,OAAO,CAAC,uBAAuB;CA0BlC"}