@roomkit/state 1.1.2 → 1.1.3

package/dist/collections/TrackedMap.d.ts

@@ -0,0 +1,77 @@
+/**
+ * TrackedMap - 自动追踪变化的 Map 集合
+ * 类似 Colyseus 的 MapSchema
+ */
+import type { Patch } from '../types.js';
+export interface ChangeCallback {
+    (patches: Patch[]): void;
+}
+/**
+ * TrackedMap - 自动追踪所有修改操作的 Map
+ *
+ * @example
+ * ```typescript
+ * const players = new TrackedMap<string, Player>();
+ *
+ * players.onChange((patches) => {
+ *   console.log('Changes:', patches);
+ * });
+ *
+ * players.set('p1', new Player()); // 触发 onChange
+ * ```
+ */
+export declare class TrackedMap<K = any, V = any> extends Map<K, V> {
+    private basePath;
+    private changeCallbacks;
+    private pendingChanges;
+    private tracking;
+    constructor(basePath?: string, entries?: readonly (readonly [K, V])[] | null);
+    /**
+     * 开始追踪变化
+     */
+    startTracking(): void;
+    /**
+     * 停止追踪变化
+     */
+    stopTracking(): void;
+    /**
+     * 注册变化回调
+     */
+    onChange(callback: ChangeCallback): () => void;
+    /**
+     * 记录变化
+     */
+    private recordChange;
+    /**
+     * 触发变化回调
+     */
+    private emitChanges;
+    /**
+     * 获取待处理的变化
+     */
+    getChanges(): Patch[];
+    /**
+     * 清除待处理的变化
+     */
+    clearChanges(): void;
+    set(key: K, value: V): this;
+    delete(key: K): boolean;
+    clear(): void;
+    /**
+     * 批量更新（不触发中间变化）
+     */
+    batch(fn: () => void): void;
+    /**
+     * 克隆
+     */
+    clone(): TrackedMap<K, V>;
+    /**
+     * 转换为普通对象
+     */
+    toJSON(): Record<string, V>;
+    /**
+     * 从普通对象创建
+     */
+    static fromJSON<K, V>(obj: Record<string, V>, basePath?: string): TrackedMap<K, V>;
+}
+//# sourceMappingURL=TrackedMap.d.ts.map

package/dist/collections/TrackedMap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TrackedMap.d.ts","sourceRoot":"","sources":["../../src/collections/TrackedMap.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAEzC,MAAM,WAAW,cAAc;IAC7B,CAAC,OAAO,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC;CAC1B;AAED;;;;;;;;;;;;;GAaG;AACH,qBAAa,UAAU,CAAC,CAAC,GAAG,GAAG,EAAE,CAAC,GAAG,GAAG,CAAE,SAAQ,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC;IACzD,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,eAAe,CAAkC;IACzD,OAAO,CAAC,cAAc,CAAiC;IACvD,OAAO,CAAC,QAAQ,CAAS;gBAEb,QAAQ,GAAE,MAAW,EAAE,OAAO,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI;IAKhF;;OAEG;IACH,aAAa,IAAI,IAAI;IAIrB;;OAEG;IACH,YAAY,IAAI,IAAI;IAIpB;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,cAAc,GAAG,MAAM,IAAI;IAO9C;;OAEG;IACH,OAAO,CAAC,YAAY;IA2BpB;;OAEG;IACH,OAAO,CAAC,WAAW;IAenB;;OAEG;IACH,UAAU,IAAI,KAAK,EAAE;IAIrB;;OAEG;IACH,YAAY,IAAI,IAAI;IAMpB,GAAG,CAAC,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI;IAe3B,MAAM,CAAC,GAAG,EAAE,CAAC,GAAG,OAAO;IAavB,KAAK,IAAI,IAAI;IASb;;OAEG;IACH,KAAK,CAAC,EAAE,EAAE,MAAM,IAAI,GAAG,IAAI;IAgB3B;;OAEG;IACH,KAAK,IAAI,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC;IAMzB;;OAEG;IACH,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;IAQ3B;;OAEG;IACH,MAAM,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,EAAE,QAAQ,GAAE,MAAW,GAAG,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC;CAOvF"}

package/dist/collections/TrackedMap.js

@@ -0,0 +1,183 @@
+/**
+ * TrackedMap - 自动追踪变化的 Map 集合
+ * 类似 Colyseus 的 MapSchema
+ */
+import { ChangeOp } from '../types.js';
+/**
+ * TrackedMap - 自动追踪所有修改操作的 Map
+ *
+ * @example
+ * ```typescript
+ * const players = new TrackedMap<string, Player>();
+ *
+ * players.onChange((patches) => {
+ *   console.log('Changes:', patches);
+ * });
+ *
+ * players.set('p1', new Player()); // 触发 onChange
+ * ```
+ */
+export class TrackedMap extends Map {
+    basePath;
+    changeCallbacks = new Set();
+    pendingChanges = new Map();
+    tracking = false;
+    constructor(basePath = '', entries) {
+        super(entries);
+        this.basePath = basePath;
+    }
+    /**
+     * 开始追踪变化
+     */
+    startTracking() {
+        this.tracking = true;
+    }
+    /**
+     * 停止追踪变化
+     */
+    stopTracking() {
+        this.tracking = false;
+    }
+    /**
+     * 注册变化回调
+     */
+    onChange(callback) {
+        this.changeCallbacks.add(callback);
+        return () => {
+            this.changeCallbacks.delete(callback);
+        };
+    }
+    /**
+     * 记录变化
+     */
+    recordChange(key, op, value, oldValue) {
+        if (!this.tracking)
+            return;
+        const path = this.basePath ? `${this.basePath}/${String(key)}` : `/${String(key)}`;
+        const patch = {
+            op,
+            path,
+            value,
+            oldValue,
+        };
+        this.pendingChanges.set(path, patch);
+        // 如果有 onChange 回调，立即通知
+        if (this.changeCallbacks.size > 0) {
+            const patches = [patch];
+            this.changeCallbacks.forEach(callback => {
+                try {
+                    callback(patches);
+                }
+                catch (e) {
+                    console.error('[TrackedMap] Error in change callback:', e);
+                }
+            });
+        }
+    }
+    /**
+     * 触发变化回调
+     */
+    emitChanges() {
+        if (this.pendingChanges.size === 0)
+            return;
+        const patches = Array.from(this.pendingChanges.values());
+        this.changeCallbacks.forEach(callback => {
+            try {
+                callback(patches);
+            }
+            catch (e) {
+                console.error('[TrackedMap] Error in change callback:', e);
+            }
+        });
+        this.pendingChanges.clear();
+    }
+    /**
+     * 获取待处理的变化
+     */
+    getChanges() {
+        return Array.from(this.pendingChanges.values());
+    }
+    /**
+     * 清除待处理的变化
+     */
+    clearChanges() {
+        this.pendingChanges.clear();
+    }
+    // ============ Map 方法重写 ============
+    set(key, value) {
+        const hadKey = super.has(key);
+        const oldValue = super.get(key);
+        super.set(key, value);
+        if (hadKey) {
+            this.recordChange(key, ChangeOp.REPLACE, value, oldValue);
+        }
+        else {
+            this.recordChange(key, ChangeOp.ADD, value);
+        }
+        return this;
+    }
+    delete(key) {
+        if (!super.has(key))
+            return false;
+        const oldValue = super.get(key);
+        const result = super.delete(key);
+        if (result) {
+            this.recordChange(key, ChangeOp.REMOVE, undefined, oldValue);
+        }
+        return result;
+    }
+    clear() {
+        // 记录所有删除操作
+        for (const [key, value] of this) {
+            this.recordChange(key, ChangeOp.REMOVE, undefined, value);
+        }
+        super.clear();
+    }
+    /**
+     * 批量更新（不触发中间变化）
+     */
+    batch(fn) {
+        const wasTracking = this.tracking;
+        this.tracking = false;
+        const initialChanges = this.pendingChanges.size;
+        try {
+            fn();
+        }
+        finally {
+            this.tracking = wasTracking;
+            // 如果有新变化，立即发出
+            if (wasTracking && this.pendingChanges.size > initialChanges) {
+                this.emitChanges();
+            }
+        }
+    }
+    /**
+     * 克隆
+     */
+    clone() {
+        const cloned = new TrackedMap(this.basePath, Array.from(this.entries()));
+        cloned.tracking = this.tracking;
+        return cloned;
+    }
+    /**
+     * 转换为普通对象
+     */
+    toJSON() {
+        const obj = {};
+        for (const [key, value] of this) {
+            obj[String(key)] = value;
+        }
+        return obj;
+    }
+    /**
+     * 从普通对象创建
+     */
+    static fromJSON(obj, basePath = '') {
+        const map = new TrackedMap(basePath);
+        for (const [key, value] of Object.entries(obj)) {
+            map.set(key, value);
+        }
+        return map;
+    }
+}
+//# sourceMappingURL=TrackedMap.js.map

package/dist/collections/TrackedMap.js.map

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

package/dist/collections/TrackedSet.d.ts

@@ -0,0 +1,81 @@
+/**
+ * TrackedSet - 自动追踪变化的 Set 集合
+ * 类似 Colyseus 的 SetSchema
+ */
+import type { Patch } from '../types.js';
+export interface ChangeCallback {
+    (patches: Patch[]): void;
+}
+/**
+ * TrackedSet - 自动追踪所有修改操作的 Set
+ *
+ * @example
+ * ```typescript
+ * const tags = new TrackedSet<string>();
+ *
+ * tags.onChange((patches) => {
+ *   console.log('Changes:', patches);
+ * });
+ *
+ * tags.add('tag1'); // 触发 onChange
+ * ```
+ */
+export declare class TrackedSet<T = any> extends Set<T> {
+    private basePath;
+    private changeCallbacks;
+    private pendingChanges;
+    private tracking;
+    constructor(basePath?: string, values?: readonly T[] | null);
+    /**
+     * 开始追踪变化
+     */
+    startTracking(): void;
+    /**
+     * 停止追踪变化
+     */
+    stopTracking(): void;
+    /**
+     * 注册变化回调
+     */
+    onChange(callback: ChangeCallback): () => void;
+    /**
+     * 记录变化
+     */
+    private recordChange;
+    /**
+     * 触发变化回调
+     */
+    private emitChanges;
+    /**
+     * 获取待处理的变化
+     */
+    getChanges(): Patch[];
+    /**
+     * 清除待处理的变化
+     */
+    clearChanges(): void;
+    add(value: T): this;
+    delete(value: T): boolean;
+    clear(): void;
+    /**
+     * 批量更新（不触发中间变化）
+     */
+    batch(fn: () => void): void;
+    /**
+     * 克隆
+     */
+    clone(): TrackedSet<T>;
+    /**
+     * 转换为数组
+     */
+    toArray(): T[];
+    /**
+     * 转换为普通对象（用于序列化）
+     */
+    toJSON(): T[];
+    /**
+     * 从数组创建
+     */
+    static fromArray<T>(arr: T[], basePath?: string): TrackedSet<T>;
+}
+//# sourceMappingURL=TrackedSet.d.ts.map

package/dist/collections/TrackedSet.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TrackedSet.d.ts","sourceRoot":"","sources":["../../src/collections/TrackedSet.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAEzC,MAAM,WAAW,cAAc;IAC7B,CAAC,OAAO,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC;CAC1B;AAED;;;;;;;;;;;;;GAaG;AACH,qBAAa,UAAU,CAAC,CAAC,GAAG,GAAG,CAAE,SAAQ,GAAG,CAAC,CAAC,CAAC;IAC7C,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,eAAe,CAAkC;IACzD,OAAO,CAAC,cAAc,CAAiC;IACvD,OAAO,CAAC,QAAQ,CAAS;gBAEb,QAAQ,GAAE,MAAW,EAAE,MAAM,CAAC,EAAE,SAAS,CAAC,EAAE,GAAG,IAAI;IAK/D;;OAEG;IACH,aAAa,IAAI,IAAI;IAIrB;;OAEG;IACH,YAAY,IAAI,IAAI;IAIpB;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,cAAc,GAAG,MAAM,IAAI;IAO9C;;OAEG;IACH,OAAO,CAAC,YAAY;IA4BpB;;OAEG;IACH,OAAO,CAAC,WAAW;IAenB;;OAEG;IACH,UAAU,IAAI,KAAK,EAAE;IAIrB;;OAEG;IACH,YAAY,IAAI,IAAI;IAMpB,GAAG,CAAC,KAAK,EAAE,CAAC,GAAG,IAAI;IAYnB,MAAM,CAAC,KAAK,EAAE,CAAC,GAAG,OAAO;IAYzB,KAAK,IAAI,IAAI;IASb;;OAEG;IACH,KAAK,CAAC,EAAE,EAAE,MAAM,IAAI,GAAG,IAAI;IAc3B;;OAEG;IACH,KAAK,IAAI,UAAU,CAAC,CAAC,CAAC;IAMtB;;OAEG;IACH,OAAO,IAAI,CAAC,EAAE;IAId;;OAEG;IACH,MAAM,IAAI,CAAC,EAAE;IAIb;;OAEG;IACH,MAAM,CAAC,SAAS,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,EAAE,QAAQ,GAAE,MAAW,GAAG,UAAU,CAAC,CAAC,CAAC;CAGpE"}

package/dist/collections/TrackedSet.js

@@ -0,0 +1,175 @@
+/**
+ * TrackedSet - 自动追踪变化的 Set 集合
+ * 类似 Colyseus 的 SetSchema
+ */
+import { ChangeOp } from '../types.js';
+/**
+ * TrackedSet - 自动追踪所有修改操作的 Set
+ *
+ * @example
+ * ```typescript
+ * const tags = new TrackedSet<string>();
+ *
+ * tags.onChange((patches) => {
+ *   console.log('Changes:', patches);
+ * });
+ *
+ * tags.add('tag1'); // 触发 onChange
+ * ```
+ */
+export class TrackedSet extends Set {
+    basePath;
+    changeCallbacks = new Set();
+    pendingChanges = new Map();
+    tracking = false;
+    constructor(basePath = '', values) {
+        super(values);
+        this.basePath = basePath;
+    }
+    /**
+     * 开始追踪变化
+     */
+    startTracking() {
+        this.tracking = true;
+    }
+    /**
+     * 停止追踪变化
+     */
+    stopTracking() {
+        this.tracking = false;
+    }
+    /**
+     * 注册变化回调
+     */
+    onChange(callback) {
+        this.changeCallbacks.add(callback);
+        return () => {
+            this.changeCallbacks.delete(callback);
+        };
+    }
+    /**
+     * 记录变化
+     */
+    recordChange(value, op, _unused, oldValue) {
+        if (!this.tracking)
+            return;
+        // Set 使用值本身作为路径的一部分
+        const path = this.basePath ? `${this.basePath}/${String(value)}` : `/${String(value)}`;
+        const patch = {
+            op,
+            path,
+            value,
+            oldValue,
+        };
+        this.pendingChanges.set(path, patch);
+        // 如果有 onChange 回调，立即通知
+        if (this.changeCallbacks.size > 0) {
+            const patches = [patch];
+            this.changeCallbacks.forEach(callback => {
+                try {
+                    callback(patches);
+                }
+                catch (e) {
+                    console.error('[TrackedSet] Error in change callback:', e);
+                }
+            });
+        }
+    }
+    /**
+     * 触发变化回调
+     */
+    emitChanges() {
+        if (this.pendingChanges.size === 0)
+            return;
+        const patches = Array.from(this.pendingChanges.values());
+        this.changeCallbacks.forEach(callback => {
+            try {
+                callback(patches);
+            }
+            catch (e) {
+                console.error('[TrackedSet] Error in change callback:', e);
+            }
+        });
+        this.pendingChanges.clear();
+    }
+    /**
+     * 获取待处理的变化
+     */
+    getChanges() {
+        return Array.from(this.pendingChanges.values());
+    }
+    /**
+     * 清除待处理的变化
+     */
+    clearChanges() {
+        this.pendingChanges.clear();
+    }
+    // ============ Set 方法重写 ============
+    add(value) {
+        const hadValue = super.has(value);
+        super.add(value);
+        if (!hadValue) {
+            this.recordChange(value, ChangeOp.ADD);
+        }
+        return this;
+    }
+    delete(value) {
+        if (!super.has(value))
+            return false;
+        const result = super.delete(value);
+        if (result) {
+            this.recordChange(value, ChangeOp.REMOVE, undefined, value);
+        }
+        return result;
+    }
+    clear() {
+        // 记录所有删除操作
+        for (const value of this) {
+            this.recordChange(value, ChangeOp.REMOVE, undefined, value);
+        }
+        super.clear();
+    }
+    /**
+     * 批量更新（不触发中间变化）
+     */
+    batch(fn) {
+        const wasTracking = this.tracking;
+        this.tracking = false;
+        try {
+            fn();
+        }
+        finally {
+            this.tracking = wasTracking;
+            if (wasTracking) {
+                this.emitChanges();
+            }
+        }
+    }
+    /**
+     * 克隆
+     */
+    clone() {
+        const cloned = new TrackedSet(this.basePath, Array.from(this));
+        cloned.tracking = this.tracking;
+        return cloned;
+    }
+    /**
+     * 转换为数组
+     */
+    toArray() {
+        return Array.from(this);
+    }
+    /**
+     * 转换为普通对象（用于序列化）
+     */
+    toJSON() {
+        return Array.from(this);
+    }
+    /**
+     * 从数组创建
+     */
+    static fromArray(arr, basePath = '') {
+        return new TrackedSet(basePath, arr);
+    }
+}
+//# sourceMappingURL=TrackedSet.js.map

package/dist/collections/TrackedSet.js.map

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

package/dist/collections/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Tracked Collections
+ * 自动追踪变化的集合类型
+ */
+export { TrackedMap } from './TrackedMap.js';
+export { TrackedArray } from './TrackedArray.js';
+export { TrackedSet } from './TrackedSet.js';
+export type { ChangeCallback } from './TrackedMap.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/collections/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/collections/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,YAAY,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/collections/index.js

@@ -0,0 +1,8 @@
+/**
+ * Tracked Collections
+ * 自动追踪变化的集合类型
+ */
+export { TrackedMap } from './TrackedMap.js';
+export { TrackedArray } from './TrackedArray.js';
+export { TrackedSet } from './TrackedSet.js';
+//# sourceMappingURL=index.js.map

package/dist/collections/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/collections/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/compression/CompressionStrategy.d.ts

@@ -0,0 +1,81 @@
+/**
+ * 压缩策略管理器
+ * 根据数据大小和类型智能选择压缩方案
+ */
+export interface CompressionResult {
+    data: Uint8Array;
+    compressed: boolean;
+    originalSize: number;
+    compressedSize: number;
+    compressionRatio: number;
+}
+export interface CompressionOptions {
+    /**
+     * 压缩阈值（字节），小于此值不压缩
+     */
+    threshold?: number;
+    /**
+     * 最小压缩率，低于此值不使用压缩结果
+     */
+    minCompressionRatio?: number;
+    /**
+     * 压缩级别 (1-9)
+     */
+    level?: number;
+    /**
+     * 是否强制压缩
+     */
+    force?: boolean;
+    /**
+     * 是否启用自适应压缩
+     */
+    adaptive?: boolean;
+}
+/**
+ * 压缩策略
+ */
+export declare class CompressionStrategy {
+    private defaultOptions;
+    private stats;
+    constructor(options?: CompressionOptions);
+    /**
+     * 压缩数据
+     */
+    compress(data: Uint8Array, options?: CompressionOptions): CompressionResult;
+    /**
+     * 解压数据
+     */
+    decompress(data: Uint8Array, compressed: boolean): Uint8Array;
+    /**
+     * 批量压缩（用于多个小对象）
+     */
+    compressBatch(dataArray: Uint8Array[]): CompressionResult;
+    /**
+     * 获取压缩统计
+     */
+    getStats(): {
+        compressionRate: number;
+        averageSaving: number;
+        totalAttempts: number;
+        totalCompressed: number;
+        totalSaved: number;
+        averageRatio: number;
+    };
+    /**
+     * 重置统计
+     */
+    resetStats(): void;
+    /**
+     * 根据数据类型建议压缩级别
+     */
+    static suggestLevel(dataType: 'text' | 'binary' | 'mixed'): number;
+    /**
+     * 估算压缩后大小（不实际压缩）
+     */
+    static estimateSize(data: Uint8Array): number;
+}
+/**
+ * 全局压缩策略实例
+ */
+export declare const globalCompressionStrategy: CompressionStrategy;
+//# sourceMappingURL=CompressionStrategy.d.ts.map

package/dist/compression/CompressionStrategy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CompressionStrategy.d.ts","sourceRoot":"","sources":["../../src/compression/CompressionStrategy.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,UAAU,CAAC;IACjB,UAAU,EAAE,OAAO,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,kBAAkB;IACjC;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAE7B;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;IAEhB;;OAEG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;GAEG;AACH,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,cAAc,CAMpB;IAGF,OAAO,CAAC,KAAK,CAKX;gBAEU,OAAO,CAAC,EAAE,kBAAkB;IAMxC;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,UAAU,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,iBAAiB;IA8E3E;;OAEG;IACH,UAAU,CAAC,IAAI,EAAE,UAAU,EAAE,UAAU,EAAE,OAAO,GAAG,UAAU;IAW7D;;OAEG;IACH,aAAa,CAAC,SAAS,EAAE,UAAU,EAAE,GAAG,iBAAiB;IAezD;;OAEG;IACH,QAAQ;;;;;;;;IAYR;;OAEG;IACH,UAAU,IAAI,IAAI;IASlB;;OAEG;IACH,MAAM,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,QAAQ,GAAG,OAAO,GAAG,MAAM;IAYlE;;OAEG;IACH,MAAM,CAAC,YAAY,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM;CAsB9C;AAED;;GAEG;AACH,eAAO,MAAM,yBAAyB,qBAA4B,CAAC"}