vikunja-mcp-ng 0.4.0

package/dist/transforms/task.js

@@ -0,0 +1,259 @@
+"use strict";
+/**
+ * Task-specific transformers for different verbosity levels
+ * Handles transformation of Vikunja task objects based on verbosity settings
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.defaultTaskTransformer = exports.TaskTransformer = void 0;
+exports.transformTask = transformTask;
+exports.transformTasks = transformTasks;
+exports.createMinimalTask = createMinimalTask;
+exports.createStandardTask = createStandardTask;
+exports.createDetailedTask = createDetailedTask;
+exports.createCompleteTask = createCompleteTask;
+const base_1 = require("./base");
+const field_selector_1 = require("./field-selector");
+/**
+ * Task transformer class
+ */
+class TaskTransformer {
+    /**
+     * Transform a single task based on configuration
+     */
+    transformTask(task, config) {
+        const startTime = Date.now();
+        // Get available fields from the task
+        const availableFields = Object.keys(task).filter(key => typeof key === 'string');
+        // Select fields based on configuration
+        const fieldSelection = field_selector_1.defaultFieldSelector.selectFields(config, availableFields);
+        // Transform the task
+        const optimizedTask = this.applyTransformations(task, fieldSelection.fieldDefinitions);
+        const originalSize = base_1.SizeEstimator.estimateSize(task);
+        const optimizedSize = base_1.SizeEstimator.estimateSize(optimizedTask);
+        const processingTime = Date.now() - startTime;
+        return {
+            data: optimizedTask,
+            metrics: {
+                originalSize,
+                optimizedSize,
+                reductionPercentage: base_1.SizeEstimator.calculateReduction(originalSize, optimizedSize),
+                fieldsIncluded: fieldSelection.includedFields.length,
+                totalFields: availableFields.length,
+                fieldInclusionPercentage: Math.round((fieldSelection.includedFields.length / availableFields.length) * 100)
+            },
+            metadata: {
+                verbosity: config.verbosity,
+                categoriesIncluded: fieldSelection.activeCategories,
+                timestamp: new Date().toISOString(),
+                processingTimeMs: processingTime
+            }
+        };
+    }
+    /**
+     * Transform multiple tasks
+     */
+    transformTasks(tasks, config) {
+        const startTime = Date.now();
+        const transformedTasks = tasks.map(task => {
+            const taskResult = this.transformTask(task, config);
+            return taskResult.data;
+        });
+        const processingTime = Date.now() - startTime;
+        // Calculate combined metrics
+        const totalOriginalSize = tasks.reduce((sum, task) => sum + base_1.SizeEstimator.estimateSize(task), 0);
+        const totalOptimizedSize = transformedTasks.reduce((sum, task) => sum + base_1.SizeEstimator.estimateSize(task), 0);
+        // Get unique available fields across all tasks
+        const allAvailableFields = new Set();
+        tasks.forEach(task => Object.keys(task).forEach(field => allAvailableFields.add(field)));
+        const fieldSelection = field_selector_1.defaultFieldSelector.selectFields(config, Array.from(allAvailableFields));
+        return {
+            data: transformedTasks,
+            metrics: {
+                originalSize: totalOriginalSize,
+                optimizedSize: totalOptimizedSize,
+                reductionPercentage: base_1.SizeEstimator.calculateReduction(totalOriginalSize, totalOptimizedSize),
+                fieldsIncluded: fieldSelection.includedFields.length,
+                totalFields: allAvailableFields.size,
+                fieldInclusionPercentage: Math.round((fieldSelection.includedFields.length / allAvailableFields.size) * 100)
+            },
+            metadata: {
+                verbosity: config.verbosity,
+                categoriesIncluded: fieldSelection.activeCategories,
+                timestamp: new Date().toISOString(),
+                processingTimeMs: processingTime
+            }
+        };
+    }
+    /**
+     * Apply field transformations to a task
+     */
+    applyTransformations(task, fieldDefinitions) {
+        const optimizedTask = {};
+        fieldDefinitions.forEach(fieldDef => {
+            const sourceValue = task[fieldDef.fieldName];
+            if (sourceValue !== undefined && sourceValue !== null) {
+                // Apply field transformation if available
+                let transformedValue = sourceValue;
+                if (fieldDef.transformer) {
+                    transformedValue = fieldDef.transformer(sourceValue, task);
+                }
+                else {
+                    // Apply default transformations based on field type
+                    transformedValue = this.applyDefaultTransformation(fieldDef.fieldName, sourceValue);
+                }
+                // Use target name if specified, otherwise use field name
+                const targetName = fieldDef.targetName || fieldDef.fieldName;
+                optimizedTask[targetName] = transformedValue;
+            }
+        });
+        // Ensure required fields are present
+        if (optimizedTask.id === undefined)
+            optimizedTask.id = task.id;
+        if (optimizedTask.title === undefined)
+            optimizedTask.title = task.title;
+        return optimizedTask;
+    }
+    /**
+     * Apply default transformations for common fields
+     */
+    applyDefaultTransformation(fieldName, value) {
+        switch (fieldName) {
+            case 'done':
+                return value;
+            case 'priority':
+                return value;
+            case 'due_date':
+            case 'start_date':
+            case 'end_date':
+                if (!value)
+                    return undefined;
+                return new Date(value).toISOString();
+            case 'created_at':
+            case 'updated_at':
+            case 'completed_at':
+                if (!value)
+                    return undefined;
+                return new Date(value).toISOString();
+            case 'description':
+                return value;
+            case 'project_id':
+                return value;
+            case 'hex_color':
+                return value;
+            case 'position':
+            case 'index':
+                return typeof value === 'number' ? value : parseInt(String(value), 10);
+            default:
+                return value;
+        }
+    }
+    /**
+     * Create a minimal task representation
+     */
+    static createMinimalTask(task) {
+        return {
+            id: task.id,
+            title: task.title,
+            done: task.done
+        };
+    }
+    /**
+     * Create a standard task representation
+     */
+    static createStandardTask(task) {
+        const result = {
+            id: task.id,
+            title: task.title,
+            done: task.done,
+            priority: task.priority
+        };
+        if (task.description !== undefined) {
+            result.description = task.description;
+        }
+        if (task.project_id !== undefined) {
+            result.project_id = task.project_id;
+        }
+        return result;
+    }
+    /**
+     * Create a detailed task representation
+     */
+    static createDetailedTask(task) {
+        const result = {
+            id: task.id,
+            title: task.title,
+            done: task.done,
+            priority: task.priority
+        };
+        if (task.description !== undefined) {
+            result.description = task.description;
+        }
+        if (task.due_date) {
+            result.due_date = new Date(task.due_date).toISOString();
+        }
+        if (task.created_at) {
+            result.created_at = new Date(task.created_at).toISOString();
+        }
+        if (task.updated_at) {
+            result.updated_at = new Date(task.updated_at).toISOString();
+        }
+        if (task.project_id !== undefined) {
+            result.project_id = task.project_id;
+        }
+        if (task.hex_color !== undefined) {
+            result.hex_color = task.hex_color;
+        }
+        return result;
+    }
+    /**
+     * Create a complete task representation
+     */
+    static createCompleteTask(task) {
+        // Transform subtasks to IDs for optimized version
+        const { subtasks, ...taskWithoutSubtasks } = task;
+        const optimizedTaskData = {
+            ...taskWithoutSubtasks,
+            ...(subtasks && { subtasks: subtasks.map(subtask => subtask.id) })
+        };
+        const completeTask = optimizedTaskData;
+        // Normalize date fields
+        ['due_date', 'start_date', 'end_date', 'created_at', 'updated_at', 'completed_at'].forEach(dateField => {
+            if (completeTask[dateField]) {
+                completeTask[dateField] = new Date(completeTask[dateField]).toISOString();
+            }
+        });
+        return completeTask;
+    }
+}
+exports.TaskTransformer = TaskTransformer;
+/**
+ * Default task transformer instance
+ */
+exports.defaultTaskTransformer = new TaskTransformer();
+/**
+ * Utility functions for quick task transformation
+ */
+function transformTask(task, verbosity) {
+    const config = { verbosity };
+    return exports.defaultTaskTransformer.transformTask(task, config);
+}
+function transformTasks(tasks, verbosity) {
+    const config = { verbosity };
+    return exports.defaultTaskTransformer.transformTasks(tasks, config);
+}
+/**
+ * Quick transformation functions for common verbosity levels
+ */
+function createMinimalTask(task) {
+    return TaskTransformer.createMinimalTask(task);
+}
+function createStandardTask(task) {
+    return TaskTransformer.createStandardTask(task);
+}
+function createDetailedTask(task) {
+    return TaskTransformer.createDetailedTask(task);
+}
+function createCompleteTask(task) {
+    return TaskTransformer.createCompleteTask(task);
+}
+//# sourceMappingURL=task.js.map

package/dist/transforms/task.js.map

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

package/dist/types/errors.d.ts

@@ -0,0 +1,65 @@
+/**
+ * MCP Server Error Types and Utilities
+ */
+export declare enum ErrorCode {
+    AUTH_REQUIRED = "AUTH_REQUIRED",
+    AUTH_FAILED = "AUTH_FAILED",
+    NOT_FOUND = "NOT_FOUND",
+    PERMISSION_DENIED = "PERMISSION_DENIED",
+    VALIDATION_ERROR = "VALIDATION_ERROR",
+    API_ERROR = "API_ERROR",
+    NETWORK_ERROR = "NETWORK_ERROR",
+    NOT_IMPLEMENTED = "NOT_IMPLEMENTED",
+    INTERNAL_ERROR = "INTERNAL_ERROR",
+    RATE_LIMIT_EXCEEDED = "RATE_LIMIT_EXCEEDED",
+    REQUEST_TOO_LARGE = "REQUEST_TOO_LARGE",
+    TIMEOUT_ERROR = "TIMEOUT_ERROR"
+}
+interface MCPErrorDetails {
+    vikunjaError?: unknown;
+    statusCode?: number;
+    endpoint?: string;
+    rateLimitType?: string;
+    requestSize?: number;
+    responseSize?: number;
+    timeout?: number;
+    limit?: number;
+    current?: number;
+    resetTime?: number;
+    maxRequestSize?: number;
+    maxResponseSize?: number;
+    toolName?: string;
+    /**
+     * Set by network-layer failures wrapped into an MCPError (e.g.
+     * src/utils/vikunja-rest.ts) to record whether the original cause looked
+     * transient (connection reset, timeout, DNS failure, ...) BEFORE the
+     * original error's `.code`/`.cause.code` — which callers like a retry
+     * predicate need — got discarded by the string-formatted MCPError
+     * message. Absent for non-network failures (e.g. HTTP error responses,
+     * which use `statusCode` instead).
+     */
+    transient?: boolean;
+}
+export declare class MCPError extends Error {
+    code: ErrorCode;
+    details?: MCPErrorDetails;
+    constructor(code: ErrorCode, message: string, details?: MCPErrorDetails);
+    toJSON(): {
+        error: {
+            code: string;
+            message: string;
+            details?: unknown;
+        };
+    };
+}
+export interface MCPResponse<T = unknown> {
+    success: boolean;
+    data?: T;
+    error?: {
+        code: string;
+        message: string;
+        details?: unknown;
+    };
+}
+export {};
+//# sourceMappingURL=errors.d.ts.map

package/dist/types/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/types/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,oBAAY,SAAS;IACnB,aAAa,kBAAkB;IAC/B,WAAW,gBAAgB;IAC3B,SAAS,cAAc;IACvB,iBAAiB,sBAAsB;IACvC,gBAAgB,qBAAqB;IACrC,SAAS,cAAc;IACvB,aAAa,kBAAkB;IAC/B,eAAe,oBAAoB;IACnC,cAAc,mBAAmB;IACjC,mBAAmB,wBAAwB;IAC3C,iBAAiB,sBAAsB;IACvC,aAAa,kBAAkB;CAChC;AAED,UAAU,eAAe;IACvB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;;;;;OAQG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,qBAAa,QAAS,SAAQ,KAAK;IACjC,IAAI,EAAE,SAAS,CAAC;IAChB,OAAO,CAAC,EAAE,eAAe,CAAC;gBAEd,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,eAAe;IASvE,MAAM,IAAI;QAAE,KAAK,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,MAAM,CAAC;YAAC,OAAO,CAAC,EAAE,OAAO,CAAA;SAAE,CAAA;KAAE;CAS1E;AAED,MAAM,WAAW,WAAW,CAAC,CAAC,GAAG,OAAO;IACtC,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,CAAC,CAAC;IACT,KAAK,CAAC,EAAE;QACN,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,CAAC,EAAE,OAAO,CAAC;KACnB,CAAC;CACH"}

package/dist/types/errors.js

@@ -0,0 +1,44 @@
+"use strict";
+/**
+ * MCP Server Error Types and Utilities
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MCPError = exports.ErrorCode = void 0;
+var ErrorCode;
+(function (ErrorCode) {
+    ErrorCode["AUTH_REQUIRED"] = "AUTH_REQUIRED";
+    ErrorCode["AUTH_FAILED"] = "AUTH_FAILED";
+    ErrorCode["NOT_FOUND"] = "NOT_FOUND";
+    ErrorCode["PERMISSION_DENIED"] = "PERMISSION_DENIED";
+    ErrorCode["VALIDATION_ERROR"] = "VALIDATION_ERROR";
+    ErrorCode["API_ERROR"] = "API_ERROR";
+    ErrorCode["NETWORK_ERROR"] = "NETWORK_ERROR";
+    ErrorCode["NOT_IMPLEMENTED"] = "NOT_IMPLEMENTED";
+    ErrorCode["INTERNAL_ERROR"] = "INTERNAL_ERROR";
+    ErrorCode["RATE_LIMIT_EXCEEDED"] = "RATE_LIMIT_EXCEEDED";
+    ErrorCode["REQUEST_TOO_LARGE"] = "REQUEST_TOO_LARGE";
+    ErrorCode["TIMEOUT_ERROR"] = "TIMEOUT_ERROR";
+})(ErrorCode || (exports.ErrorCode = ErrorCode = {}));
+class MCPError extends Error {
+    code;
+    details;
+    constructor(code, message, details) {
+        super(message);
+        this.code = code;
+        if (details !== undefined) {
+            this.details = details;
+        }
+        this.name = 'MCPError';
+    }
+    toJSON() {
+        return {
+            error: {
+                code: this.code,
+                message: this.message,
+                details: this.details,
+            },
+        };
+    }
+}
+exports.MCPError = MCPError;
+//# sourceMappingURL=errors.js.map

package/dist/types/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/types/errors.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEH,IAAY,SAaX;AAbD,WAAY,SAAS;IACnB,4CAA+B,CAAA;IAC/B,wCAA2B,CAAA;IAC3B,oCAAuB,CAAA;IACvB,oDAAuC,CAAA;IACvC,kDAAqC,CAAA;IACrC,oCAAuB,CAAA;IACvB,4CAA+B,CAAA;IAC/B,gDAAmC,CAAA;IACnC,8CAAiC,CAAA;IACjC,wDAA2C,CAAA;IAC3C,oDAAuC,CAAA;IACvC,4CAA+B,CAAA;AACjC,CAAC,EAbW,SAAS,yBAAT,SAAS,QAapB;AA6BD,MAAa,QAAS,SAAQ,KAAK;IACjC,IAAI,CAAY;IAChB,OAAO,CAAmB;IAE1B,YAAY,IAAe,EAAE,OAAe,EAAE,OAAyB;QACrE,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;YAC1B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACzB,CAAC;QACD,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;IACzB,CAAC;IAED,MAAM;QACJ,OAAO;YACL,KAAK,EAAE;gBACL,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,OAAO,EAAE,IAAI,CAAC,OAAO;gBACrB,OAAO,EAAE,IAAI,CAAC,OAAO;aACtB;SACF,CAAC;IACJ,CAAC;CACF;AAtBD,4BAsBC"}

package/dist/types/filters.d.ts

@@ -0,0 +1,149 @@
+/**
+ * Filter-related type definitions for Vikunja MCP Server
+ */
+import type { components } from './generated/vikunja-openapi';
+import type { FilteringMetadata } from '../utils/filtering/types';
+/** `models.Task` per the OpenAPI spec — task shape carried in filter results. */
+type Task = components['schemas']['models.Task'];
+/**
+ * Supported filter operators
+ */
+export type FilterOperator = '=' | '!=' | '>' | '>=' | '<' | '<=' | 'like' | 'LIKE' | 'in' | 'not in';
+/**
+ * Logical operators for combining conditions
+ */
+export type LogicalOperator = '&&' | '||';
+/**
+ * Available fields for filtering tasks
+ */
+export type FilterField = 'done' | 'priority' | 'percentDone' | 'dueDate' | 'startDate' | 'endDate' | 'doneAt' | 'project' | 'assignees' | 'labels' | 'created' | 'updated' | 'title' | 'description';
+/**
+ * Valid field types for validation
+ */
+export declare const FIELD_TYPES: Record<FilterField, 'boolean' | 'number' | 'date' | 'string' | 'array'>;
+/**
+ * Represents a single filter condition
+ */
+export interface FilterCondition {
+    field: FilterField;
+    operator: FilterOperator;
+    value: string | number | boolean | string[] | number[];
+}
+/**
+ * Represents a group of filter conditions
+ */
+export interface FilterGroup {
+    conditions: FilterCondition[];
+    operator: LogicalOperator;
+}
+/**
+ * Represents a complete filter expression
+ */
+export interface FilterExpression {
+    groups: FilterGroup[];
+    operator?: LogicalOperator;
+}
+/**
+ * Represents a saved filter
+ */
+export interface SavedFilter {
+    id: string;
+    name: string;
+    description?: string;
+    filter: string;
+    expression?: FilterExpression;
+    created: Date;
+    updated: Date;
+    projectId?: number;
+    isGlobal: boolean;
+}
+/**
+ * Filter validation result
+ */
+export interface FilterValidationResult {
+    valid: boolean;
+    errors: string[];
+    warnings?: string[];
+}
+/**
+ * Parser error with position information
+ */
+export interface ParseError {
+    message: string;
+    position: number;
+    context?: string;
+}
+/**
+ * Result of parsing a filter string
+ */
+export interface ParseResult {
+    expression: FilterExpression | null;
+    error?: ParseError;
+}
+/**
+ * Configuration for filter validation
+ */
+export interface FilterValidationConfig {
+    /** Threshold for performance warning (default: 10) */
+    performanceWarningThreshold?: number;
+    /** Custom validator function */
+    customValidator?: (expression: FilterExpression) => FilterValidationResult;
+}
+/**
+ * Filter storage interface
+ */
+export interface FilterStorage {
+    list(): Promise<SavedFilter[]>;
+    get(id: string): Promise<SavedFilter | null>;
+    create(filter: Omit<SavedFilter, 'id' | 'created' | 'updated'>): Promise<SavedFilter>;
+    update(id: string, filter: Partial<Omit<SavedFilter, 'id' | 'created' | 'updated'>>): Promise<SavedFilter>;
+    delete(id: string): Promise<void>;
+    findByName(name: string): Promise<SavedFilter | null>;
+}
+/**
+ * Arguments for task listing operations
+ */
+export interface TaskListingArgs {
+    /** Filter expression to apply */
+    filter?: string;
+    /** Page number for pagination */
+    page?: number;
+    /** Number of items per page */
+    limit?: number;
+    /** Sort field */
+    sort?: string;
+    /** Sort order */
+    order?: 'asc' | 'desc';
+}
+/**
+ * Result of task filter execution
+ */
+export interface TaskFilterExecutionResult {
+    /** Whether filtering was successful */
+    success: boolean;
+    /** Filtered tasks (if successful) */
+    tasks?: Task[];
+    /** Error message (if failed) */
+    error?: string;
+    /** Number of tasks returned */
+    count?: number;
+    /** Total number of tasks matching filter */
+    total?: number;
+    /** Filtering metadata */
+    metadata?: FilteringMetadata;
+    /** Memory usage information */
+    memoryInfo?: {
+        actualCount: number;
+        maxAllowed: number;
+        estimatedMemoryMB: number;
+    };
+    /** Performance metrics */
+    performance?: {
+        filterTime: number;
+        fetchTime: number;
+        totalTime: number;
+        memoryUsage?: number;
+    };
+}
+export {};
+//# sourceMappingURL=filters.d.ts.map

package/dist/types/filters.d.ts.map

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

package/dist/types/filters.js

@@ -0,0 +1,26 @@
+"use strict";
+/**
+ * Filter-related type definitions for Vikunja MCP Server
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FIELD_TYPES = void 0;
+/**
+ * Valid field types for validation
+ */
+exports.FIELD_TYPES = {
+    done: 'boolean',
+    priority: 'number',
+    percentDone: 'number',
+    dueDate: 'date',
+    startDate: 'date',
+    endDate: 'date',
+    doneAt: 'date',
+    project: 'number',
+    assignees: 'array',
+    labels: 'array',
+    created: 'date',
+    updated: 'date',
+    title: 'string',
+    description: 'string',
+};
+//# sourceMappingURL=filters.js.map

package/dist/types/filters.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"filters.js","sourceRoot":"","sources":["../../src/types/filters.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAqCH;;GAEG;AACU,QAAA,WAAW,GAA4E;IAClG,IAAI,EAAE,SAAS;IACf,QAAQ,EAAE,QAAQ;IAClB,WAAW,EAAE,QAAQ;IACrB,OAAO,EAAE,MAAM;IACf,SAAS,EAAE,MAAM;IACjB,OAAO,EAAE,MAAM;IACf,MAAM,EAAE,MAAM;IACd,OAAO,EAAE,QAAQ;IACjB,SAAS,EAAE,OAAO;IAClB,MAAM,EAAE,OAAO;IACf,OAAO,EAAE,MAAM;IACf,OAAO,EAAE,MAAM;IACf,KAAK,EAAE,QAAQ;IACf,WAAW,EAAE,QAAQ;CACtB,CAAC"}