vikunja-mcp-ng 0.4.0

package/dist/tools/tasks/crud/index.js

@@ -0,0 +1,20 @@
+"use strict";
+/**
+ * CRUD Operations for Tasks
+ * Centralized exports for all task CRUD operations with clean modular architecture
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createTaskResponse = exports.getTask = exports.deleteTask = exports.updateTask = exports.createTask = void 0;
+// Export all service functions with their original signatures for backward compatibility
+var TaskCreationService_1 = require("./TaskCreationService");
+Object.defineProperty(exports, "createTask", { enumerable: true, get: function () { return TaskCreationService_1.createTask; } });
+var TaskUpdateService_1 = require("./TaskUpdateService");
+Object.defineProperty(exports, "updateTask", { enumerable: true, get: function () { return TaskUpdateService_1.updateTask; } });
+var TaskDeletionService_1 = require("./TaskDeletionService");
+Object.defineProperty(exports, "deleteTask", { enumerable: true, get: function () { return TaskDeletionService_1.deleteTask; } });
+var TaskReadService_1 = require("./TaskReadService");
+Object.defineProperty(exports, "getTask", { enumerable: true, get: function () { return TaskReadService_1.getTask; } });
+// Export the response formatter for use in other modules
+var TaskResponseFormatter_1 = require("./TaskResponseFormatter");
+Object.defineProperty(exports, "createTaskResponse", { enumerable: true, get: function () { return TaskResponseFormatter_1.createTaskResponse; } });
+//# sourceMappingURL=index.js.map

package/dist/tools/tasks/crud/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/tools/tasks/crud/index.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAEH,yFAAyF;AACzF,6DAAmD;AAA1C,iHAAA,UAAU,OAAA;AACnB,yDAAiD;AAAxC,+GAAA,UAAU,OAAA;AACnB,6DAAmD;AAA1C,iHAAA,UAAU,OAAA;AACnB,qDAA4C;AAAnC,0GAAA,OAAO,OAAA;AAEhB,yDAAyD;AACzD,iEAA6D;AAApD,2HAAA,kBAAkB,OAAA"}

package/dist/tools/tasks/duplicate.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Task duplication
+ *
+ * Implements `duplicate` (`PUT /tasks/{taskID}/duplicate`), which copies a
+ * task with all its properties (labels, assignees, attachments, reminders)
+ * into the same project and creates a "copied from" relation between the
+ * new and original task. Direct parallel to the already-shipped
+ * `vikunja_projects duplicate` (`src/tools/projects/duplicate.ts`) — see
+ * docs/ENDPOINT-TAIL-RETRIAGE.md item G2. No request body; the endpoint
+ * takes only the path parameter.
+ */
+import type { AuthManager } from '../../auth/AuthManager';
+export interface DuplicateTaskArgs {
+    /** Id of the task to duplicate. */
+    id?: number;
+    /** Session id for response tracking. */
+    sessionId?: string;
+}
+/**
+ * Duplicates a task.
+ */
+export declare function duplicateTask(args: DuplicateTaskArgs, authManager: AuthManager): Promise<{
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+}>;
+//# sourceMappingURL=duplicate.d.ts.map

package/dist/tools/tasks/duplicate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"duplicate.d.ts","sourceRoot":"","sources":["../../../src/tools/tasks/duplicate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAa1D,MAAM,WAAW,iBAAiB;IAChC,mCAAmC;IACnC,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,wCAAwC;IACxC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,wBAAsB,aAAa,CACjC,IAAI,EAAE,iBAAiB,EACvB,WAAW,EAAE,WAAW,GACvB,OAAO,CAAC;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,CAAC,CAgC7D"}

package/dist/tools/tasks/duplicate.js

@@ -0,0 +1,41 @@
+"use strict";
+/**
+ * Task duplication
+ *
+ * Implements `duplicate` (`PUT /tasks/{taskID}/duplicate`), which copies a
+ * task with all its properties (labels, assignees, attachments, reminders)
+ * into the same project and creates a "copied from" relation between the
+ * new and original task. Direct parallel to the already-shipped
+ * `vikunja_projects duplicate` (`src/tools/projects/duplicate.ts`) — see
+ * docs/ENDPOINT-TAIL-RETRIAGE.md item G2. No request body; the endpoint
+ * takes only the path parameter.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.duplicateTask = duplicateTask;
+const types_1 = require("../../types");
+const validation_1 = require("../../utils/validation");
+const response_factory_1 = require("../../utils/response-factory");
+const vikunja_rest_1 = require("../../utils/vikunja-rest");
+/**
+ * Duplicates a task.
+ */
+async function duplicateTask(args, authManager) {
+    if (!args.id) {
+        throw new types_1.MCPError(types_1.ErrorCode.VALIDATION_ERROR, 'Task id is required for duplicate operation');
+    }
+    (0, validation_1.validateId)(args.id, 'id');
+    const result = await (0, vikunja_rest_1.vikunjaRestRequest)(authManager, 'PUT', `/tasks/${args.id}/duplicate`);
+    const duplicated = result?.duplicated_task;
+    const response = (0, response_factory_1.createStandardResponse)('duplicate', duplicated?.id !== undefined
+        ? `Task ${args.id} duplicated as task ${duplicated.id}`
+        : `Task ${args.id} duplicated`, {
+        sourceTaskId: args.id,
+        duplicatedTask: duplicated,
+    }, {
+        timestamp: new Date().toISOString(),
+    }, args.sessionId);
+    return {
+        content: [{ type: 'text', text: (0, response_factory_1.formatAorpAsMarkdown)(response) }],
+    };
+}
+//# sourceMappingURL=duplicate.js.map

package/dist/tools/tasks/duplicate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"duplicate.js","sourceRoot":"","sources":["../../../src/tools/tasks/duplicate.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;GAUG;;AAyBH,sCAmCC;AAzDD,uCAAkD;AAClD,uDAAoD;AACpD,mEAA4F;AAC5F,2DAA8D;AAgB9D;;GAEG;AACI,KAAK,UAAU,aAAa,CACjC,IAAuB,EACvB,WAAwB;IAExB,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC;QACb,MAAM,IAAI,gBAAQ,CAAC,iBAAS,CAAC,gBAAgB,EAAE,6CAA6C,CAAC,CAAC;IAChG,CAAC;IACD,IAAA,uBAAU,EAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;IAE1B,MAAM,MAAM,GAAG,MAAM,IAAA,iCAAkB,EACrC,WAAW,EACX,KAAK,EACL,UAAU,IAAI,CAAC,EAAE,YAAY,CAC9B,CAAC;IAEF,MAAM,UAAU,GAAG,MAAM,EAAE,eAAe,CAAC;IAE3C,MAAM,QAAQ,GAAG,IAAA,yCAAsB,EACrC,WAAW,EACX,UAAU,EAAE,EAAE,KAAK,SAAS;QAC1B,CAAC,CAAC,QAAQ,IAAI,CAAC,EAAE,uBAAuB,UAAU,CAAC,EAAE,EAAE;QACvD,CAAC,CAAC,QAAQ,IAAI,CAAC,EAAE,aAAa,EAChC;QACE,YAAY,EAAE,IAAI,CAAC,EAAE;QACrB,cAAc,EAAE,UAAU;KAC3B,EACD;QACE,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;KACpC,EACD,IAAI,CAAC,SAAS,CACf,CAAC;IAEF,OAAO;QACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAA,uCAAoB,EAAC,QAAQ,CAAC,EAAE,CAAC;KAC3E,CAAC;AACJ,CAAC"}

package/dist/tools/tasks/filtering/FilterExecutor.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Filter execution engine for task filtering operations
+ * Handles the execution of filters and applies additional post-processing
+ */
+import type { FilterExpression } from '../../../types/filters';
+import type { VikunjaTask as Task, TaskListApiParams as GetTasksParams } from '../../../utils/filtering/types';
+import type { TaskListingArgs, TaskFilterExecutionResult } from '../types/filters';
+import type { TaskFilterStorage, FilteringMetadata } from '../types/filters';
+import type { AuthManager } from '../../../auth/AuthManager';
+/**
+ * Executes filtering operations on tasks with comprehensive error handling
+ */
+export declare const FilterExecutor: {
+    /**
+     * Executes task filtering with the provided parameters
+     */
+    executeFiltering(args: TaskListingArgs, filterExpression: FilterExpression | null, filterString: string | undefined, params: GetTasksParams, _storage: TaskFilterStorage, authManager?: AuthManager): Promise<TaskFilterExecutionResult>;
+    /**
+     * Applies post-processing filters that aren't handled by the main filtering strategies
+     */
+    applyPostProcessingFilters(tasks: Task[], args: TaskListingArgs): Task[];
+    /**
+     * Creates filtering metadata for response formatting
+     */
+    createFilteringMetadata(filterString: string | undefined, serverSideFilteringUsed: boolean, serverSideFilteringAttempted: boolean, filteringNote: string): FilteringMetadata;
+    /**
+     * Prepares query parameters for API calls
+     */
+    prepareQueryParameters(args: TaskListingArgs): GetTasksParams;
+    /**
+     * Validates loaded tasks against memory constraints
+     */
+    validateLoadedTaskCount(tasks: Task[]): {
+        isValid: boolean;
+        warnings: string[];
+        shouldThrow: boolean;
+    };
+};
+//# sourceMappingURL=FilterExecutor.d.ts.map

package/dist/tools/tasks/filtering/FilterExecutor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FilterExecutor.d.ts","sourceRoot":"","sources":["../../../../src/tools/tasks/filtering/FilterExecutor.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,KAAK,EAAE,WAAW,IAAI,IAAI,EAAE,iBAAiB,IAAI,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAC/G,OAAO,KAAK,EAAE,eAAe,EAAE,yBAAyB,EAAE,MAAM,kBAAkB,CAAC;AACnF,OAAO,KAAK,EAAE,iBAAiB,EAAmB,iBAAiB,EAAiB,MAAM,kBAAkB,CAAC;AAC7G,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAgB7D;;GAEG;AACH,eAAO,MAAM,cAAc;IACzB;;OAEG;2BAEK,eAAe,oBACH,gBAAgB,GAAG,IAAI,gBAC3B,MAAM,GAAG,SAAS,UACxB,cAAc,YACZ,iBAAiB,gBACb,WAAW,GACxB,OAAO,CAAC,yBAAyB,CAAC;IAwGrC;;OAEG;sCAC+B,IAAI,EAAE,QAAQ,eAAe,GAAG,IAAI,EAAE;IAWxE;;OAEG;0CAEa,MAAM,GAAG,SAAS,2BACP,OAAO,gCACF,OAAO,iBACtB,MAAM,GACpB,iBAAiB;IAkCpB;;OAEG;iCAC0B,eAAe,GAAG,cAAc;IA2B7D;;OAEG;mCAC4B,IAAI,EAAE,GAAG;QACtC,OAAO,EAAE,OAAO,CAAC;QACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;QACnB,WAAW,EAAE,OAAO,CAAC;KACtB;CAkCF,CAAC"}

package/dist/tools/tasks/filtering/FilterExecutor.js

@@ -0,0 +1,214 @@
+"use strict";
+/**
+ * Filter execution engine for task filtering operations
+ * Handles the execution of filters and applies additional post-processing
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FilterExecutor = void 0;
+const filtering_1 = require("../../../utils/filtering");
+const memory_1 = require("../../../utils/memory");
+const types_1 = require("../../../types");
+const logger_1 = require("../../../utils/logger");
+/**
+ * True when a task listing spans every accessible project: no `projectId`
+ * supplied, or `allProjects: true`. Matches the predicate already used
+ * consistently by `ClientSideFilteringStrategy`/`ServerSideFilteringStrategy`
+ * to pick their single-project vs. aggregate-across-projects branch.
+ */
+function isCrossProjectListing(args) {
+    return args.projectId === undefined || args.allProjects === true;
+}
+/**
+ * Executes filtering operations on tasks with comprehensive error handling
+ */
+exports.FilterExecutor = {
+    /**
+     * Executes task filtering with the provided parameters
+     */
+    async executeFiltering(args, filterExpression, filterString, params, _storage, authManager) {
+        try {
+            // Execute filtering using strategy pattern. Cross-project listings
+            // always route through the direct-REST GET /tasks strategy (falling
+            // back to per-project aggregation on failure) regardless of whether a
+            // filter is present — see RestCrossProjectFilteringStrategy.
+            const filteringContext = new filtering_1.FilteringContext({
+                enableServerSide: Boolean(filterString),
+                crossProject: isCrossProjectListing(args)
+            });
+            const filteringParams = {
+                args: args,
+                filterExpression,
+                filterString,
+                params,
+                ...(authManager !== undefined ? { authManager } : {})
+            };
+            const filteringResult = await filteringContext.execute(filteringParams);
+            const tasks = filteringResult.tasks;
+            // Extract metadata for response formatting
+            const { serverSideFilteringUsed, serverSideFilteringAttempted, } = filteringResult.metadata;
+            // Additional memory protection: validate actual loaded task count
+            const actualTaskCount = tasks.length;
+            const finalTaskCountValidation = (0, memory_1.validateTaskCountLimit)(actualTaskCount);
+            let memoryInfo;
+            if (!finalTaskCountValidation.allowed) {
+                // Log warning but don't fail since tasks are already loaded
+                logger_1.logger.warn('Loaded task count exceeds recommended limits', {
+                    actualCount: actualTaskCount,
+                    maxRecommended: finalTaskCountValidation.maxAllowed,
+                    estimatedMemoryMB: finalTaskCountValidation.estimatedMemoryMB
+                });
+                memoryInfo = {
+                    actualCount: actualTaskCount,
+                    maxAllowed: finalTaskCountValidation.maxAllowed,
+                    estimatedMemoryMB: finalTaskCountValidation.estimatedMemoryMB
+                };
+                // For extremely large datasets, still enforce hard limits
+                if (actualTaskCount > finalTaskCountValidation.maxAllowed * 1.5) {
+                    throw new types_1.MCPError(types_1.ErrorCode.INTERNAL_ERROR, (0, memory_1.createTaskLimitExceededMessage)('process loaded tasks', actualTaskCount));
+                }
+            }
+            // Log memory usage for monitoring
+            (0, memory_1.logMemoryUsage)('task listing', actualTaskCount);
+            // Apply post-processing filters
+            const processedTasks = exports.FilterExecutor.applyPostProcessingFilters(tasks, args);
+            // Determine filtering method message and metadata from strategy result
+            const filteringMetadata = exports.FilterExecutor.createFilteringMetadata(filterString, serverSideFilteringUsed, serverSideFilteringAttempted, filteringResult.metadata.filteringNote);
+            // Build return object, only including defined properties to satisfy exactOptionalPropertyTypes
+            const result = {
+                success: true,
+                tasks: processedTasks,
+                metadata: filteringMetadata,
+            };
+            if (memoryInfo !== undefined) {
+                result.memoryInfo = memoryInfo;
+            }
+            return result;
+        }
+        catch (error) {
+            if (error instanceof types_1.MCPError) {
+                throw error;
+            }
+            // Log the full error for debugging filter issues
+            logger_1.logger.error('Task filtering execution error:', {
+                error: error instanceof Error ? error.message : String(error),
+                params: params,
+                filter: args.filter,
+                filterId: args.filterId,
+            });
+            // Re-throw original error to be handled by main function
+            throw error;
+        }
+    },
+    /**
+     * Applies post-processing filters that aren't handled by the main filtering strategies
+     */
+    applyPostProcessingFilters(tasks, args) {
+        let filteredTasks = [...tasks];
+        // Filter by done status if specified (this is a simpler filter that works)
+        if (args.done !== undefined) {
+            filteredTasks = filteredTasks.filter((task) => task.done === args.done);
+        }
+        return filteredTasks;
+    },
+    /**
+     * Creates filtering metadata for response formatting
+     */
+    createFilteringMetadata(filterString, serverSideFilteringUsed, serverSideFilteringAttempted, filteringNote) {
+        if (filterString) {
+            if (serverSideFilteringUsed) {
+                return {
+                    serverSideFilteringUsed: true,
+                    serverSideFilteringAttempted: true,
+                    clientSideFiltering: false,
+                    filteringNote,
+                };
+            }
+            else if (serverSideFilteringAttempted) {
+                return {
+                    serverSideFilteringUsed: false,
+                    serverSideFilteringAttempted: true,
+                    clientSideFiltering: true,
+                    filteringNote,
+                };
+            }
+            else {
+                return {
+                    serverSideFilteringUsed: false,
+                    serverSideFilteringAttempted: false,
+                    clientSideFiltering: true,
+                    filteringNote,
+                };
+            }
+        }
+        else {
+            return {
+                serverSideFilteringUsed: false,
+                serverSideFilteringAttempted: false,
+                clientSideFiltering: false,
+                filteringNote,
+            };
+        }
+    },
+    /**
+     * Prepares query parameters for API calls
+     */
+    prepareQueryParameters(args) {
+        const params = {};
+        // Build query parameters
+        if (args.page !== undefined)
+            params.page = args.page;
+        if (args.perPage !== undefined)
+            params.per_page = args.perPage;
+        if (args.search !== undefined)
+            params.s = args.search;
+        if (args.sort !== undefined)
+            params.sort_by = args.sort;
+        // Memory protection: Check if we should implement pagination limits
+        // Note: Vikunja API doesn't provide task count endpoints, so we use conservative defaults
+        // and rely on user-provided pagination parameters
+        if (!params.per_page) {
+            // Set default pagination to prevent unbounded loading
+            params.per_page = 1000; // Conservative default
+            if (!params.page) {
+                params.page = 1;
+            }
+            logger_1.logger.info('Applied default pagination for memory protection', {
+                per_page: params.per_page,
+                page: params.page
+            });
+        }
+        return params;
+    },
+    /**
+     * Validates loaded tasks against memory constraints
+     */
+    validateLoadedTaskCount(tasks) {
+        const actualTaskCount = tasks.length;
+        const finalTaskCountValidation = (0, memory_1.validateTaskCountLimit)(actualTaskCount);
+        const warnings = [];
+        if (!finalTaskCountValidation.allowed) {
+            // Log warning but don't fail since tasks are already loaded
+            logger_1.logger.warn('Loaded task count exceeds recommended limits', {
+                actualCount: actualTaskCount,
+                maxRecommended: finalTaskCountValidation.maxAllowed,
+                estimatedMemoryMB: finalTaskCountValidation.estimatedMemoryMB
+            });
+            warnings.push(`Loaded ${actualTaskCount} tasks, which exceeds recommended limit of ${finalTaskCountValidation.maxAllowed}. ` +
+                `Estimated memory usage: ${finalTaskCountValidation.estimatedMemoryMB}MB.`);
+            // For extremely large datasets, still enforce hard limits
+            if (actualTaskCount > finalTaskCountValidation.maxAllowed * 1.5) {
+                return {
+                    isValid: false,
+                    warnings,
+                    shouldThrow: true
+                };
+            }
+        }
+        return {
+            isValid: true,
+            warnings,
+            shouldThrow: false
+        };
+    },
+};
+//# sourceMappingURL=FilterExecutor.js.map

package/dist/tools/tasks/filtering/FilterExecutor.js.map

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

package/dist/tools/tasks/filtering/FilterValidator.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Filter validation for task filtering operations
+ * Handles validation of filter expressions and task listing parameters
+ */
+import type { components } from '../../../types/generated/vikunja-openapi';
+import type { FilterExpression } from '../../../types/filters';
+import type { TaskListingArgs, TaskFilterValidationConfig, TaskFilterStorage } from '../types/filters';
+/** `models.Task` per the OpenAPI spec — sample task for memory estimation. */
+type Task = components['schemas']['models.Task'];
+/**
+ * Validates filter parameters for task listing operations
+ */
+export declare const FilterValidator: {
+    /**
+     * Validates and processes filter string or filter ID
+     */
+    validateAndParseFilter(args: TaskListingArgs, storage: TaskFilterStorage): Promise<{
+        filterExpression: FilterExpression | null;
+        filterString: string | undefined;
+        validationWarnings: string[];
+    }>;
+    /**
+     * Validates pagination and memory constraints
+     */
+    validateMemoryConstraints(args: TaskListingArgs, requestedPageSize: number): {
+        isValid: boolean;
+        warnings: string[];
+        maxAllowed?: number;
+    };
+    /**
+     * Validates the actual loaded task count against limits
+     */
+    validateLoadedTasks(actualTaskCount: number, sampleTask?: Task): {
+        isValid: boolean;
+        warnings: string[];
+        shouldThrow: boolean;
+        riskLevel?: "low" | "medium" | "high";
+        estimatedMemoryMB?: number;
+    };
+    /**
+     * Validates task listing arguments
+     */
+    validateTaskListingArgs(args: TaskListingArgs): string[];
+    /**
+     * Performs comprehensive validation of task filtering parameters
+     */
+    validateTaskFiltering(args: TaskListingArgs, storage: TaskFilterStorage, _config?: TaskFilterValidationConfig): Promise<{
+        filterExpression: FilterExpression | null;
+        filterString: string | undefined;
+        validationWarnings: string[];
+        memoryValidation: {
+            isValid: boolean;
+            warnings: string[];
+            maxAllowed?: number;
+        };
+    }>;
+};
+export {};
+//# sourceMappingURL=FilterValidator.d.ts.map

package/dist/tools/tasks/filtering/FilterValidator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FilterValidator.d.ts","sourceRoot":"","sources":["../../../../src/tools/tasks/filtering/FilterValidator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0CAA0C,CAAC;AAC3E,OAAO,KAAK,EAAE,gBAAgB,EAA4B,MAAM,wBAAwB,CAAC;AACzF,OAAO,KAAK,EAAE,eAAe,EAAE,0BAA0B,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAOvG,8EAA8E;AAC9E,KAAK,IAAI,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC,aAAa,CAAC,CAAC;AA4BjD;;GAEG;AACH,eAAO,MAAM,eAAe;IAC1B;;OAEG;iCAEK,eAAe,WACZ,iBAAiB,GACzB,OAAO,CAAC;QACT,gBAAgB,EAAE,gBAAgB,GAAG,IAAI,CAAC;QAC1C,YAAY,EAAE,MAAM,GAAG,SAAS,CAAC;QACjC,kBAAkB,EAAE,MAAM,EAAE,CAAC;KAC9B,CAAC;IAsFF;;OAEG;oCAEK,eAAe,qBACF,MAAM,GACxB;QACD,OAAO,EAAE,OAAO,CAAC;QACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;QACnB,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB;IA6CD;;OAEG;yCACkC,MAAM,eAAe,IAAI,GAAG;QAC/D,OAAO,EAAE,OAAO,CAAC;QACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;QACnB,WAAW,EAAE,OAAO,CAAC;QACrB,SAAS,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;QACtC,iBAAiB,CAAC,EAAE,MAAM,CAAC;KAC5B;IA4CD;;OAEG;kCAC2B,eAAe,GAAG,MAAM,EAAE;IAsDxD;;OAEG;gCAEK,eAAe,WACZ,iBAAiB,YACjB,0BAA0B,GAClC,OAAO,CAAC;QACT,gBAAgB,EAAE,gBAAgB,GAAG,IAAI,CAAC;QAC1C,YAAY,EAAE,MAAM,GAAG,SAAS,CAAC;QACjC,kBAAkB,EAAE,MAAM,EAAE,CAAC;QAC7B,gBAAgB,EAAE;YAChB,OAAO,EAAE,OAAO,CAAC;YACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;YACnB,UAAU,CAAC,EAAE,MAAM,CAAC;SACrB,CAAC;KACH,CAAC;CA4BH,CAAC"}