@cloudbase/agent-tools 0.0.2

package/dist/fs/operator/transaction/snapshot-strategies.js

@@ -0,0 +1,278 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SandboxSnapshotStrategy = exports.MemorySnapshotStrategy = exports.LocalSnapshotStrategy = exports.SnapshotStrategy = void 0;
+const fs = __importStar(require("fs"));
+const memfs_1 = require("memfs");
+class SnapshotStrategy {
+}
+exports.SnapshotStrategy = SnapshotStrategy;
+class LocalSnapshotStrategy extends SnapshotStrategy {
+    constructor() {
+        super(...arguments);
+        this.backupDir = "";
+        this.backupPaths = new Map();
+        this.createdPaths = new Set();
+    }
+    async initialize() {
+        this.backupDir = `/tmp/transaction-backup-${Date.now()}-${Math.random().toString(36).substr(2, 9)}`;
+        await fs.promises.mkdir(this.backupDir, { recursive: true });
+        return { backupDir: this.backupDir, backupPaths: this.backupPaths };
+    }
+    async saveFile(path, fileState) {
+        if (fileState.exists) {
+            if (!fileState.isDirectory) {
+                // 备份已存在的文件
+                const backupPath = `${this.backupDir}/${path.replace(/\//g, "_")}`;
+                try {
+                    await fs.promises.copyFile(path, backupPath);
+                    this.backupPaths.set(path, backupPath);
+                }
+                catch (error) {
+                    console.warn(`Failed to backup ${path}:`, error);
+                }
+            }
+        }
+        else {
+            // 标记为新创建的路径，回滚时需要删除
+            this.createdPaths.add(path);
+        }
+    }
+    async rollback(operations) {
+        // 按操作顺序反向处理
+        const reversedOperations = [...operations].reverse();
+        for (const operation of reversedOperations) {
+            try {
+                await this.rollbackOperation(operation);
+            }
+            catch (error) {
+                console.warn(`Failed to rollback operation ${operation.type} on ${operation.path}:`, error);
+            }
+        }
+        // 恢复备份的文件
+        const restorePromises = Array.from(this.backupPaths.entries()).map(([originalPath, backupPath]) => this.restoreFile(originalPath, backupPath));
+        await Promise.all(restorePromises);
+    }
+    async rollbackOperation(operation) {
+        switch (operation.type) {
+            case "write":
+                if (this.createdPaths.has(operation.path)) {
+                    // 删除新创建的文件
+                    await fs.promises.unlink(operation.path);
+                }
+                // 已存在文件的恢复在后面统一处理
+                break;
+            case "mkdir":
+                if (this.createdPaths.has(operation.path)) {
+                    // 删除新创建的目录
+                    await fs.promises.rmdir(operation.path);
+                }
+                break;
+            case "unlink":
+                // 文件删除的恢复在后面统一处理
+                break;
+            case "rmdir":
+                // 目录删除的恢复比较复杂，这里简化处理
+                break;
+            case "rename":
+                if (operation.oldPath) {
+                    try {
+                        // 尝试反向重命名
+                        await fs.promises.rename(operation.path, operation.oldPath);
+                    }
+                    catch (error) {
+                        // 如果反向重命名失败，记录警告
+                        console.warn(`Failed to reverse rename from ${operation.path} to ${operation.oldPath}:`, error);
+                    }
+                }
+                break;
+        }
+    }
+    async restoreFile(originalPath, backupPath) {
+        try {
+            await fs.promises.copyFile(backupPath, originalPath);
+        }
+        catch (error) {
+            console.warn(`Failed to restore ${originalPath}:`, error);
+        }
+    }
+    async cleanup() {
+        try {
+            await fs.promises.rm(this.backupDir, { recursive: true, force: true });
+        }
+        catch (error) {
+            console.warn("Failed to cleanup backup directory:", error);
+        }
+    }
+}
+exports.LocalSnapshotStrategy = LocalSnapshotStrategy;
+class MemorySnapshotStrategy extends SnapshotStrategy {
+    constructor(operator) {
+        super();
+        this.operator = operator;
+        this.vol =
+            operator.fileSystem.__vol ||
+                (operator.fileSystem instanceof memfs_1.Volume ? operator.fileSystem : undefined);
+        this.fs = operator.fileSystem;
+        if (!this.vol) {
+            throw new Error("MemorySnapshotStrategy requires an InMemoryFileOperator with a memfs Volume");
+        }
+    }
+    async initialize() {
+        // this.snapshot = toBinarySnapshotSync({ fs: this.fs, path: "/" });
+        this.snapshot = this.vol.toJSON();
+        return { snapshot: this.snapshot };
+    }
+    async saveFile(path, fileState) { }
+    async rollback(operations) {
+        try {
+            if (this.snapshot) {
+                this.vol.reset();
+                // fromBinarySnapshotSync(this.snapshot, { fs: this.fs, path: "/" });
+                this.vol.fromJSON(this.snapshot, "/");
+            }
+        }
+        catch (error) {
+            console.warn("Failed to restore memfs state:", error);
+        }
+    }
+    async cleanup() {
+        this.snapshot = undefined;
+    }
+}
+exports.MemorySnapshotStrategy = MemorySnapshotStrategy;
+class SandboxSnapshotStrategy extends SnapshotStrategy {
+    constructor(operator) {
+        super();
+        this.operator = operator;
+        this.fileSnapshots = new Map();
+        this.createdPaths = new Set();
+    }
+    async initialize() {
+        return {
+            fileSnapshots: this.fileSnapshots,
+            createdPaths: this.createdPaths,
+        };
+    }
+    async saveFile(path, fileState) {
+        if (fileState.exists) {
+            // 保存已存在文件的内容
+            if (!fileState.isDirectory && fileState.contentLoader) {
+                try {
+                    const content = await fileState.contentLoader();
+                    this.fileSnapshots.set(path, content);
+                }
+                catch (error) {
+                    this.fileSnapshots.set(path, null);
+                }
+            }
+        }
+        else {
+            // 标记为新创建的路径
+            this.createdPaths.add(path);
+        }
+    }
+    async rollback(operations) {
+        // 按操作顺序反向处理
+        const reversedOperations = [...operations].reverse();
+        for (const operation of reversedOperations) {
+            try {
+                await this.rollbackOperation(operation);
+            }
+            catch (error) {
+                console.warn(`Failed to rollback operation ${operation.type} on ${operation.path}:`, error);
+            }
+        }
+        // 恢复已存在文件的原始内容
+        const restorePromises = Array.from(this.fileSnapshots.entries()).map(([filePath, originalContent]) => this.restoreFile(filePath, originalContent));
+        await Promise.all(restorePromises);
+    }
+    async rollbackOperation(operation) {
+        switch (operation.type) {
+            case "write":
+                if (this.createdPaths.has(operation.path)) {
+                    // 删除新创建的文件
+                    if (await this.operator.exists(operation.path)) {
+                        await this.operator.unlink(operation.path);
+                    }
+                }
+                // 已存在文件的恢复在后面统一处理
+                break;
+            case "mkdir":
+                if (this.createdPaths.has(operation.path)) {
+                    // 删除新创建的目录
+                    if (await this.operator.exists(operation.path)) {
+                        await this.operator.rmdir(operation.path);
+                    }
+                }
+                break;
+            case "unlink":
+                // 文件删除的恢复在后面统一处理
+                break;
+            case "rmdir":
+                // 目录删除的恢复比较复杂，这里简化处理
+                break;
+            case "rename":
+                if (operation.oldPath) {
+                    try {
+                        // 尝试反向重命名
+                        if (await this.operator.exists(operation.path)) {
+                            await this.operator.rename(operation.path, operation.oldPath);
+                        }
+                    }
+                    catch (error) {
+                        console.warn(`Failed to reverse rename from ${operation.path} to ${operation.oldPath}:`, error);
+                    }
+                }
+                break;
+        }
+    }
+    async restoreFile(filePath, originalContent) {
+        try {
+            if (originalContent !== null && originalContent !== undefined) {
+                await this.operator.writeFile(filePath, originalContent);
+            }
+        }
+        catch (error) {
+            console.warn(`Failed to restore file ${filePath}:`, error);
+        }
+    }
+    async cleanup() {
+        this.createdPaths.clear();
+        this.fileSnapshots.clear();
+    }
+}
+exports.SandboxSnapshotStrategy = SandboxSnapshotStrategy;
+//# sourceMappingURL=snapshot-strategies.js.map

package/dist/fs/operator/transaction/snapshot-strategies.js.map

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

package/dist/fs/operator/transaction/transaction-operator.d.ts

@@ -0,0 +1,53 @@
+import * as fs from "fs";
+import type { Stats as MemfsStats } from "memfs/lib/node/Stats";
+import { IWriteFileOptions } from "memfs/lib/node/types/options";
+import { BaseFileOperator } from "../base-operator";
+import { TransactionOperation } from "./snapshot-strategies";
+export declare enum EOperatorType {
+    LOCAL = "local",
+    MEMORY = "memory",
+    SANDBOX = "sandbox"
+}
+export interface ITransactionFileOperatorConfig {
+    batchSize: number;
+    maxConcurrency: number;
+    enableLazyLoading: boolean;
+}
+export declare class TransactionFileOperator extends BaseFileOperator {
+    private baseOperator;
+    private operatorType;
+    private snapshotStrategy;
+    private isInTransaction;
+    private transactionOperations;
+    private fileStates;
+    private config;
+    constructor(baseOperator: BaseFileOperator, operatorType?: EOperatorType);
+    private detectOperatorType;
+    private createSnapshotStrategy;
+    beginTransaction(): Promise<void>;
+    commitTransaction(): Promise<void>;
+    rollbackTransaction(): Promise<void>;
+    resetTransactionState(): void;
+    private saveFileState;
+    private recordOperation;
+    resolvePath(filePath: fs.PathLike): string;
+    access(path: fs.PathLike): Promise<void>;
+    readFile(path: fs.PathLike): Promise<Buffer>;
+    readFile(path: fs.PathLike, encoding: BufferEncoding): Promise<string>;
+    writeFile(path: fs.PathLike, data: string | NodeJS.ArrayBufferView, options?: fs.WriteFileOptions | IWriteFileOptions): Promise<void>;
+    mkdir(path: fs.PathLike, options?: fs.MakeDirectoryOptions): Promise<string | undefined>;
+    readdir(path: fs.PathLike): Promise<string[]>;
+    readdir(path: fs.PathLike, options: {
+        withFileTypes: true;
+    }): Promise<fs.Dirent[]>;
+    stat(path: fs.PathLike): Promise<fs.Stats | MemfsStats<number | bigint>>;
+    exists(path: fs.PathLike): Promise<boolean>;
+    unlink(path: fs.PathLike): Promise<void>;
+    rmdir(path: fs.PathLike): Promise<void>;
+    rename(oldPath: fs.PathLike, newPath: fs.PathLike): Promise<void>;
+    isTransactionActive(): boolean;
+    getTransactionOperations(): readonly TransactionOperation[];
+    setConfig(config: Partial<ITransactionFileOperatorConfig>): void;
+    getConfig(): ITransactionFileOperatorConfig;
+}
+//# sourceMappingURL=transaction-operator.d.ts.map

package/dist/fs/operator/transaction/transaction-operator.d.ts.map

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

package/dist/fs/operator/transaction/transaction-operator.js

@@ -0,0 +1,195 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TransactionFileOperator = exports.EOperatorType = void 0;
+const base_operator_1 = require("../base-operator");
+const local_operator_1 = require("../local-operator");
+const in_memory_operator_1 = require("../in-memory-operator");
+const sanbox_operator_1 = require("../sanbox-operator");
+const snapshot_strategies_1 = require("./snapshot-strategies");
+var EOperatorType;
+(function (EOperatorType) {
+    EOperatorType["LOCAL"] = "local";
+    EOperatorType["MEMORY"] = "memory";
+    EOperatorType["SANDBOX"] = "sandbox";
+})(EOperatorType || (exports.EOperatorType = EOperatorType = {}));
+class TransactionFileOperator extends base_operator_1.BaseFileOperator {
+    constructor(baseOperator, operatorType) {
+        super();
+        // 事务状态
+        this.isInTransaction = false;
+        this.transactionOperations = [];
+        this.fileStates = new Map();
+        // 配置
+        this.config = {
+            batchSize: 100,
+            maxConcurrency: 10,
+            enableLazyLoading: true,
+        };
+        this.baseOperator = baseOperator;
+        this.operatorType = operatorType || this.detectOperatorType(baseOperator);
+        this.snapshotStrategy = this.createSnapshotStrategy();
+        this.workspaceRoot = baseOperator.workspaceRoot;
+    }
+    detectOperatorType(operator) {
+        if (operator instanceof local_operator_1.LocalFileOperator)
+            return EOperatorType.LOCAL;
+        if (operator instanceof in_memory_operator_1.InMemoryFileOperator)
+            return EOperatorType.MEMORY;
+        if (operator instanceof sanbox_operator_1.SandboxFileOperator)
+            return EOperatorType.SANDBOX;
+        return EOperatorType.LOCAL;
+    }
+    createSnapshotStrategy() {
+        switch (this.operatorType) {
+            case EOperatorType.LOCAL:
+                return new snapshot_strategies_1.LocalSnapshotStrategy();
+            case EOperatorType.MEMORY:
+                return new snapshot_strategies_1.MemorySnapshotStrategy(this.baseOperator);
+            case EOperatorType.SANDBOX:
+                return new snapshot_strategies_1.SandboxSnapshotStrategy(this.baseOperator);
+            default:
+                return new snapshot_strategies_1.LocalSnapshotStrategy();
+        }
+    }
+    // ==================== 事务管理 ====================
+    async beginTransaction() {
+        if (this.isInTransaction) {
+            throw new Error("事务已经开始");
+        }
+        this.isInTransaction = true;
+        await this.snapshotStrategy.initialize();
+        this.transactionOperations = [];
+        this.fileStates.clear();
+    }
+    async commitTransaction() {
+        if (!this.isInTransaction) {
+            throw new Error("没有活跃的事务");
+        }
+        await this.snapshotStrategy.cleanup();
+        this.resetTransactionState();
+    }
+    async rollbackTransaction() {
+        if (!this.isInTransaction) {
+            throw new Error("没有活跃的事务");
+        }
+        await this.snapshotStrategy.rollback(this.transactionOperations);
+        await this.snapshotStrategy.cleanup();
+        this.resetTransactionState();
+    }
+    resetTransactionState() {
+        this.isInTransaction = false;
+        this.transactionOperations = [];
+        this.fileStates.clear();
+    }
+    // ==================== 文件状态管理 ====================
+    async saveFileState(path) {
+        if (!this.isInTransaction || this.fileStates.has(path))
+            return;
+        try {
+            const exists = await this.baseOperator.exists(path);
+            const fileState = { exists, isDirectory: false };
+            if (exists) {
+                const stat = await this.baseOperator.stat(path);
+                fileState.isDirectory = stat.isDirectory();
+                // 延迟加载内容
+                if (this.config.enableLazyLoading && !fileState.isDirectory) {
+                    fileState.contentLoader = async () => {
+                        const content = await this.baseOperator.readFile(path);
+                        return Buffer.isBuffer(content) ? content : Buffer.from(content);
+                    };
+                }
+            }
+            this.fileStates.set(path, fileState);
+            await this.snapshotStrategy.saveFile(path, fileState);
+        }
+        catch (error) {
+            this.fileStates.set(path, { exists: false, isDirectory: false });
+        }
+    }
+    recordOperation(type, path, oldPath) {
+        this.transactionOperations.push({
+            type,
+            path,
+            oldPath,
+            timestamp: Date.now(),
+        });
+    }
+    // ==================== BaseFileOperator 实现 ====================
+    resolvePath(filePath) {
+        return this.baseOperator.resolvePath(filePath);
+    }
+    async access(path) {
+        return this.baseOperator.access(path);
+    }
+    async readFile(path, encoding) {
+        // 直接读取，因为所有操作都已应用到磁盘
+        return this.baseOperator.readFile(path, encoding);
+    }
+    async writeFile(path, data, options) {
+        if (this.isInTransaction) {
+            const pathStr = this.resolvePath(path);
+            await this.saveFileState(pathStr);
+            this.recordOperation("write", pathStr);
+        }
+        return this.baseOperator.writeFile(path, data, options);
+    }
+    async mkdir(path, options) {
+        if (this.isInTransaction) {
+            const pathStr = this.resolvePath(path);
+            await this.saveFileState(pathStr);
+            this.recordOperation("mkdir", pathStr);
+        }
+        return this.baseOperator.mkdir(path, options);
+    }
+    async readdir(path, options) {
+        return this.baseOperator.readdir(path, options);
+    }
+    async stat(path) {
+        return this.baseOperator.stat(path);
+    }
+    async exists(path) {
+        // 直接检查，因为所有操作都已应用到磁盘
+        return this.baseOperator.exists(path);
+    }
+    async unlink(path) {
+        if (this.isInTransaction) {
+            const pathStr = this.resolvePath(path);
+            await this.saveFileState(pathStr);
+            this.recordOperation("unlink", pathStr);
+        }
+        return this.baseOperator.unlink(path);
+    }
+    async rmdir(path) {
+        if (this.isInTransaction) {
+            const pathStr = this.resolvePath(path);
+            await this.saveFileState(pathStr);
+            this.recordOperation("rmdir", pathStr);
+        }
+        return this.baseOperator.rmdir(path);
+    }
+    async rename(oldPath, newPath) {
+        if (this.isInTransaction) {
+            const oldPathStr = this.resolvePath(oldPath);
+            const newPathStr = this.resolvePath(newPath);
+            await this.saveFileState(oldPathStr);
+            await this.saveFileState(newPathStr);
+            this.recordOperation("rename", newPathStr, oldPathStr);
+        }
+        return this.baseOperator.rename(oldPath, newPath);
+    }
+    // ==================== 公共接口 ====================
+    isTransactionActive() {
+        return this.isInTransaction;
+    }
+    getTransactionOperations() {
+        return [...this.transactionOperations];
+    }
+    setConfig(config) {
+        this.config = { ...this.config, ...config };
+    }
+    getConfig() {
+        return { ...this.config };
+    }
+}
+exports.TransactionFileOperator = TransactionFileOperator;
+//# sourceMappingURL=transaction-operator.js.map

package/dist/fs/operator/transaction/transaction-operator.js.map

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

package/dist/fs/operator/transaction/transaction-utils.d.ts

@@ -0,0 +1,80 @@
+import { BaseFileOperator } from "../base-operator";
+import { TransactionFileOperator } from "./transaction-operator";
+/**
+ * 事务执行器 - 提供便捷的事务操作方法
+ */
+export declare class TransactionExecutor {
+    private transactionOperator;
+    private operations;
+    constructor(baseOperator: BaseFileOperator);
+    /**
+     * 获取事务操作器
+     */
+    getOperator(): TransactionFileOperator;
+    /**
+     * 添加文件写入操作
+     */
+    writeFile(path: string, data: string | Buffer, options?: any): TransactionExecutor;
+    /**
+     * 添加目录创建操作
+     */
+    mkdir(path: string, options?: any): TransactionExecutor;
+    /**
+     * 添加自定义操作
+     */
+    custom(operation: (op: TransactionFileOperator) => Promise<void>): TransactionExecutor;
+    /**
+     * 执行所有操作
+     */
+    execute(): Promise<{
+        success: boolean;
+        error?: Error;
+    }>;
+    /**
+     * 在事务中执行操作
+     * @param operation 要执行的操作函数
+     * @returns 操作结果
+     */
+    executeInTransaction<T>(operation: (operator: TransactionFileOperator) => Promise<T>): Promise<T>;
+    /**
+     * 手动控制的事务 - 返回事务控制器
+     */
+    createTransaction(): Promise<TransactionController>;
+}
+/**
+ * 事务控制器 - 用于手动控制事务的提交和回滚
+ */
+export declare class TransactionController {
+    private transactionOperator;
+    private isCompleted;
+    constructor(transactionOperator: TransactionFileOperator);
+    /**
+     * 获取事务操作器
+     */
+    getOperator(): TransactionFileOperator;
+    /**
+     * 提交事务
+     */
+    commit(): Promise<void>;
+    /**
+     * 回滚事务
+     */
+    rollback(): Promise<void>;
+    /**
+     * 检查事务是否已完成
+     */
+    isTransactionCompleted(): boolean;
+    /**
+     * 获取事务操作历史
+     */
+    getOperationHistory(): readonly any[];
+}
+/**
+ * 创建事务执行器的便捷函数
+ */
+export declare function createTransactionExecutor(baseOperator: BaseFileOperator): TransactionExecutor;
+/**
+ * 直接在事务中执行操作的便捷函数
+ */
+export declare function withTransaction<T>(baseOperator: BaseFileOperator, operation: (operator: TransactionFileOperator) => Promise<T>): Promise<T>;
+//# sourceMappingURL=transaction-utils.d.ts.map

package/dist/fs/operator/transaction/transaction-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transaction-utils.d.ts","sourceRoot":"","sources":["../../../../src/fs/operator/transaction/transaction-utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AAEjE;;GAEG;AACH,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,mBAAmB,CAA0B;IACrD,OAAO,CAAC,UAAU,CACb;gBAEO,YAAY,EAAE,gBAAgB;IAI1C;;OAEG;IACH,WAAW,IAAI,uBAAuB;IAItC;;OAEG;IACH,SAAS,CACP,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,GAAG,MAAM,EACrB,OAAO,CAAC,EAAE,GAAG,GACZ,mBAAmB;IAOtB;;OAEG;IACH,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,GAAG,mBAAmB;IAOvD;;OAEG;IACH,MAAM,CACJ,SAAS,EAAE,CAAC,EAAE,EAAE,uBAAuB,KAAK,OAAO,CAAC,IAAI,CAAC,GACxD,mBAAmB;IAKtB;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,KAAK,CAAA;KAAE,CAAC;IAiB7D;;;;OAIG;IACG,oBAAoB,CAAC,CAAC,EAC1B,SAAS,EAAE,CAAC,QAAQ,EAAE,uBAAuB,KAAK,OAAO,CAAC,CAAC,CAAC,GAC3D,OAAO,CAAC,CAAC,CAAC;IAab;;OAEG;IACG,iBAAiB,IAAI,OAAO,CAAC,qBAAqB,CAAC;CAI1D;AAED;;GAEG;AACH,qBAAa,qBAAqB;IAChC,OAAO,CAAC,mBAAmB,CAA0B;IACrD,OAAO,CAAC,WAAW,CAAkB;gBAEzB,mBAAmB,EAAE,uBAAuB;IAIxD;;OAEG;IACH,WAAW,IAAI,uBAAuB;IAOtC;;OAEG;IACG,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAS7B;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAS/B;;OAEG;IACH,sBAAsB,IAAI,OAAO;IAIjC;;OAEG;IACH,mBAAmB,IAAI,SAAS,GAAG,EAAE;CAGtC;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,YAAY,EAAE,gBAAgB,GAC7B,mBAAmB,CAErB;AAED;;GAEG;AACH,wBAAsB,eAAe,CAAC,CAAC,EACrC,YAAY,EAAE,gBAAgB,EAC9B,SAAS,EAAE,CAAC,QAAQ,EAAE,uBAAuB,KAAK,OAAO,CAAC,CAAC,CAAC,GAC3D,OAAO,CAAC,CAAC,CAAC,CAGZ"}