superdb-mcp 0.51231.0

package/dist/lib/lsp-client.d.ts

@@ -0,0 +1,86 @@
+interface Position {
+    line: number;
+    character: number;
+}
+interface CompletionItem {
+    label: string;
+    kind?: number;
+    detail?: string;
+    documentation?: string | {
+        kind: string;
+        value: string;
+    };
+    insertText?: string;
+}
+interface Diagnostic {
+    range: {
+        start: Position;
+        end: Position;
+    };
+    severity?: number;
+    message: string;
+    source?: string;
+}
+interface HoverResult {
+    contents: string | {
+        kind: string;
+        value: string;
+    };
+    range?: {
+        start: Position;
+        end: Position;
+    };
+}
+export interface LSPClientOptions {
+    lspPath?: string;
+    timeout?: number;
+}
+export interface LSPAvailability {
+    available: boolean;
+    path: string | null;
+    error: string | null;
+}
+/**
+ * Get the path to the LSP server
+ */
+export declare function getLspPath(): string | null;
+/**
+ * Check if the LSP server is available
+ */
+export declare function checkLspAvailability(): LSPAvailability;
+/**
+ * Simple LSP client that spawns the server, sends a request, and gets a response
+ * Uses a fresh process per request for simplicity
+ */
+export declare class LSPClient {
+    private lspPath;
+    private timeout;
+    private messageId;
+    constructor(options?: LSPClientOptions);
+    /**
+     * Send a request to the LSP and get a response
+     */
+    private sendRequest;
+    /**
+     * Format a JSON-RPC message with Content-Length header
+     */
+    private formatMessage;
+    /**
+     * Get completions at a position in a query
+     */
+    getCompletions(query: string, line: number, character: number): Promise<CompletionItem[]>;
+    /**
+     * Get hover documentation at a position
+     */
+    getHover(query: string, line: number, character: number): Promise<HoverResult | null>;
+    /**
+     * Get diagnostics for a query
+     */
+    getDiagnostics(query: string): Promise<Diagnostic[]>;
+}
+/**
+ * Get the LSP client, or null if not available
+ */
+export declare function getLspClient(): LSPClient | null;
+export {};
+//# sourceMappingURL=lsp-client.d.ts.map

package/dist/lib/lsp-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lsp-client.d.ts","sourceRoot":"","sources":["../../src/lib/lsp-client.ts"],"names":[],"mappings":"AAkBA,UAAU,QAAQ;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,UAAU,cAAc;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,GAAG;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IACzD,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,UAAU,UAAU;IAClB,KAAK,EAAE;QACL,KAAK,EAAE,QAAQ,CAAC;QAChB,GAAG,EAAE,QAAQ,CAAC;KACf,CAAC;IACF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,UAAU,WAAW;IACnB,QAAQ,EAAE,MAAM,GAAG;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IACnD,KAAK,CAAC,EAAE;QACN,KAAK,EAAE,QAAQ,CAAC;QAChB,GAAG,EAAE,QAAQ,CAAC;KACf,CAAC;CACH;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,OAAO,CAAC;IACnB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AAED;;GAEG;AACH,wBAAgB,UAAU,IAAI,MAAM,GAAG,IAAI,CAE1C;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,eAAe,CAsCtD;AAED;;;GAGG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,SAAS,CAAa;gBAElB,OAAO,GAAE,gBAAqB;IAS1C;;OAEG;YACW,WAAW;IAyGzB;;OAEG;IACH,OAAO,CAAC,aAAa;IAKrB;;OAEG;IACG,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IAkC/F;;OAEG;IACG,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IAyB3F;;OAEG;IACG,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;CAM3D;AASD;;GAEG;AACH,wBAAgB,YAAY,IAAI,SAAS,GAAG,IAAI,CAqB/C"}

package/dist/lib/lsp-client.js

@@ -0,0 +1,267 @@
+import { spawn } from 'child_process';
+/**
+ * Get the path to the LSP server
+ */
+export function getLspPath() {
+    return process.env.SUPERDB_LSP_PATH || null;
+}
+/**
+ * Check if the LSP server is available
+ */
+export function checkLspAvailability() {
+    const lspPath = getLspPath();
+    if (!lspPath) {
+        return {
+            available: false,
+            path: null,
+            error: 'SUPERDB_LSP_PATH environment variable not set. Install superdb-lsp for enhanced features.',
+        };
+    }
+    try {
+        const { spawnSync } = require('child_process');
+        const result = spawnSync(lspPath, ['--help'], {
+            timeout: 2000,
+            encoding: 'utf-8',
+        });
+        if (result.error || result.status !== 0) {
+            return {
+                available: false,
+                path: lspPath,
+                error: `LSP server at ${lspPath} is not working: ${result.error?.message || 'unknown error'}`,
+            };
+        }
+        return {
+            available: true,
+            path: lspPath,
+            error: null,
+        };
+    }
+    catch (e) {
+        return {
+            available: false,
+            path: lspPath,
+            error: `Failed to check LSP: ${e instanceof Error ? e.message : String(e)}`,
+        };
+    }
+}
+/**
+ * Simple LSP client that spawns the server, sends a request, and gets a response
+ * Uses a fresh process per request for simplicity
+ */
+export class LSPClient {
+    lspPath;
+    timeout;
+    messageId = 0;
+    constructor(options = {}) {
+        const path = options.lspPath || getLspPath();
+        if (!path) {
+            throw new Error('LSP path not configured. Set SUPERDB_LSP_PATH environment variable.');
+        }
+        this.lspPath = path;
+        this.timeout = options.timeout || 5000;
+    }
+    /**
+     * Send a request to the LSP and get a response
+     */
+    async sendRequest(method, params) {
+        return new Promise((resolve, reject) => {
+            const proc = spawn(this.lspPath, [], {
+                stdio: ['pipe', 'pipe', 'pipe'],
+            });
+            let stdout = '';
+            let stderr = '';
+            let resolved = false;
+            const timeoutId = setTimeout(() => {
+                if (!resolved) {
+                    resolved = true;
+                    proc.kill();
+                    reject(new Error(`LSP request timed out after ${this.timeout}ms`));
+                }
+            }, this.timeout);
+            proc.stdout.on('data', (chunk) => {
+                stdout += chunk.toString();
+                // Try to parse response
+                const match = stdout.match(/Content-Length: (\d+)\r\n\r\n([\s\S]*)/);
+                if (match) {
+                    const contentLength = parseInt(match[1]);
+                    const body = match[2];
+                    if (body.length >= contentLength) {
+                        try {
+                            const response = JSON.parse(body.slice(0, contentLength));
+                            if (response.id === this.messageId) {
+                                clearTimeout(timeoutId);
+                                resolved = true;
+                                proc.kill();
+                                if (response.error) {
+                                    reject(new Error(response.error.message));
+                                }
+                                else {
+                                    resolve(response.result);
+                                }
+                            }
+                        }
+                        catch {
+                            // Continue reading
+                        }
+                    }
+                }
+            });
+            proc.stderr.on('data', (chunk) => {
+                stderr += chunk.toString();
+            });
+            proc.on('error', (err) => {
+                if (!resolved) {
+                    clearTimeout(timeoutId);
+                    resolved = true;
+                    reject(new Error(`LSP process error: ${err.message}`));
+                }
+            });
+            proc.on('close', (code) => {
+                if (!resolved) {
+                    clearTimeout(timeoutId);
+                    resolved = true;
+                    if (code !== 0) {
+                        reject(new Error(`LSP process exited with code ${code}: ${stderr}`));
+                    }
+                }
+            });
+            // Send initialize request first
+            this.messageId++;
+            const initMessage = this.formatMessage({
+                jsonrpc: '2.0',
+                id: this.messageId,
+                method: 'initialize',
+                params: {
+                    processId: process.pid,
+                    capabilities: {},
+                    rootUri: null,
+                },
+            });
+            proc.stdin.write(initMessage);
+            // Wait a bit then send the actual request
+            setTimeout(() => {
+                // Send initialized notification
+                const initializedMessage = this.formatMessage({
+                    jsonrpc: '2.0',
+                    method: 'initialized',
+                    params: {},
+                });
+                proc.stdin.write(initializedMessage);
+                // Send the actual request
+                this.messageId++;
+                const requestMessage = this.formatMessage({
+                    jsonrpc: '2.0',
+                    id: this.messageId,
+                    method,
+                    params,
+                });
+                proc.stdin.write(requestMessage);
+            }, 100);
+        });
+    }
+    /**
+     * Format a JSON-RPC message with Content-Length header
+     */
+    formatMessage(message) {
+        const content = JSON.stringify(message);
+        return `Content-Length: ${content.length}\r\n\r\n${content}`;
+    }
+    /**
+     * Get completions at a position in a query
+     */
+    async getCompletions(query, line, character) {
+        try {
+            // Create a virtual document
+            const uri = 'file:///virtual/query.spq';
+            // Open the document
+            await this.sendRequest('textDocument/didOpen', {
+                textDocument: {
+                    uri,
+                    languageId: 'spq',
+                    version: 1,
+                    text: query,
+                },
+            });
+            // Request completions
+            const result = await this.sendRequest('textDocument/completion', {
+                textDocument: { uri },
+                position: { line, character },
+            });
+            if (Array.isArray(result)) {
+                return result;
+            }
+            if (result && typeof result === 'object' && 'items' in result) {
+                return result.items;
+            }
+            return [];
+        }
+        catch (e) {
+            console.error('LSP completion error:', e);
+            return [];
+        }
+    }
+    /**
+     * Get hover documentation at a position
+     */
+    async getHover(query, line, character) {
+        try {
+            const uri = 'file:///virtual/query.spq';
+            await this.sendRequest('textDocument/didOpen', {
+                textDocument: {
+                    uri,
+                    languageId: 'spq',
+                    version: 1,
+                    text: query,
+                },
+            });
+            const result = await this.sendRequest('textDocument/hover', {
+                textDocument: { uri },
+                position: { line, character },
+            });
+            return result;
+        }
+        catch (e) {
+            console.error('LSP hover error:', e);
+            return null;
+        }
+    }
+    /**
+     * Get diagnostics for a query
+     */
+    async getDiagnostics(query) {
+        // The LSP sends diagnostics via notifications after didOpen
+        // For now, we use super compile for validation
+        // This is a placeholder for future LSP diagnostic support
+        return [];
+    }
+}
+/**
+ * Singleton instance with lazy initialization
+ */
+let lspClient = null;
+let lspCheckDone = false;
+let lspAvailable = false;
+/**
+ * Get the LSP client, or null if not available
+ */
+export function getLspClient() {
+    if (!lspCheckDone) {
+        const availability = checkLspAvailability();
+        lspAvailable = availability.available;
+        lspCheckDone = true;
+    }
+    if (!lspAvailable) {
+        return null;
+    }
+    if (!lspClient) {
+        try {
+            lspClient = new LSPClient();
+        }
+        catch {
+            lspAvailable = false;
+            return null;
+        }
+    }
+    return lspClient;
+}
+//# sourceMappingURL=lsp-client.js.map

package/dist/lib/lsp-client.js.map

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

package/dist/lib/super.d.ts

@@ -0,0 +1,26 @@
+export interface SuperResult {
+    stdout: string;
+    stderr: string;
+    exitCode: number;
+}
+/**
+ * Get the path to the super binary
+ */
+export declare function getSuperPath(): string;
+/**
+ * Execute the super binary with given arguments
+ */
+export declare function runSuper(args: string[], stdin?: string): Promise<SuperResult>;
+/**
+ * Execute super db commands
+ */
+export declare function runSuperDb(subcommand: string, args: string[], lake?: string): Promise<SuperResult>;
+/**
+ * Parse newline-delimited JSON output from super
+ */
+export declare function parseNDJSON(output: string): unknown[];
+/**
+ * Safely parse JSON, returning null on failure
+ */
+export declare function tryParseJSON(text: string): unknown | null;
+//# sourceMappingURL=super.d.ts.map

package/dist/lib/super.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"super.d.ts","sourceRoot":"","sources":["../../src/lib/super.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,wBAAgB,YAAY,IAAI,MAAM,CAErC;AAED;;GAEG;AACH,wBAAsB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CA2BnF;AAED;;GAEG;AACH,wBAAsB,UAAU,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAOxG;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,EAAE,CAGrD;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI,CAMzD"}

package/dist/lib/super.js

@@ -0,0 +1,63 @@
+import { spawn } from 'child_process';
+/**
+ * Get the path to the super binary
+ */
+export function getSuperPath() {
+    return process.env.SUPER_PATH || 'super';
+}
+/**
+ * Execute the super binary with given arguments
+ */
+export async function runSuper(args, stdin) {
+    return new Promise((resolve, reject) => {
+        const proc = spawn(getSuperPath(), args);
+        let stdout = '';
+        let stderr = '';
+        if (stdin !== undefined) {
+            proc.stdin.write(stdin);
+            proc.stdin.end();
+        }
+        proc.stdout.on('data', (chunk) => {
+            stdout += chunk.toString();
+        });
+        proc.stderr.on('data', (chunk) => {
+            stderr += chunk.toString();
+        });
+        proc.on('close', (code) => {
+            resolve({ stdout, stderr, exitCode: code ?? 1 });
+        });
+        proc.on('error', (err) => {
+            reject(new Error(`Failed to spawn super: ${err.message}`));
+        });
+    });
+}
+/**
+ * Execute super db commands
+ */
+export async function runSuperDb(subcommand, args, lake) {
+    const fullArgs = ['db', subcommand];
+    if (lake) {
+        fullArgs.push('-lake', lake);
+    }
+    fullArgs.push(...args);
+    return runSuper(fullArgs);
+}
+/**
+ * Parse newline-delimited JSON output from super
+ */
+export function parseNDJSON(output) {
+    const lines = output.trim().split('\n').filter(Boolean);
+    return lines.map(line => JSON.parse(line));
+}
+/**
+ * Safely parse JSON, returning null on failure
+ */
+export function tryParseJSON(text) {
+    try {
+        return JSON.parse(text);
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=super.js.map

package/dist/lib/super.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"super.js","sourceRoot":"","sources":["../../src/lib/super.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AAQtC;;GAEG;AACH,MAAM,UAAU,YAAY;IAC1B,OAAO,OAAO,CAAC,GAAG,CAAC,UAAU,IAAI,OAAO,CAAC;AAC3C,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,IAAc,EAAE,KAAc;IAC3D,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,MAAM,IAAI,GAAG,KAAK,CAAC,YAAY,EAAE,EAAE,IAAI,CAAC,CAAC;QACzC,IAAI,MAAM,GAAG,EAAE,CAAC;QAChB,IAAI,MAAM,GAAG,EAAE,CAAC;QAEhB,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YACxB,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC;QACnB,CAAC;QAED,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE;YAC/B,MAAM,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;QAC7B,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE;YAC/B,MAAM,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;QAC7B,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE;YACxB,OAAO,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,IAAI,CAAC,EAAE,CAAC,CAAC;QACnD,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;YACvB,MAAM,CAAC,IAAI,KAAK,CAAC,0BAA0B,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;QAC7D,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,UAAkB,EAAE,IAAc,EAAE,IAAa;IAChF,MAAM,QAAQ,GAAG,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IACpC,IAAI,IAAI,EAAE,CAAC;QACT,QAAQ,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IAC/B,CAAC;IACD,QAAQ,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC;IACvB,OAAO,QAAQ,CAAC,QAAQ,CAAC,CAAC;AAC5B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,MAAc;IACxC,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACxD,OAAO,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;AAC7C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,IAAY;IACvC,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/lib/version.d.ts

@@ -0,0 +1,57 @@
+export interface VersionInfo {
+    version: string;
+    raw: string;
+    date: Date | null;
+    sha: string | null;
+    timestamp: string | null;
+    path: string;
+    source: 'env' | 'path' | 'override';
+}
+export interface VersionComparison {
+    current: VersionInfo;
+    compareTo: VersionInfo;
+    daysDiff: number;
+    currentIsNewer: boolean;
+    compatible: boolean;
+    warnings: string[];
+}
+/**
+ * Get the path to the super binary
+ */
+export declare function getSuperPath(): string;
+/**
+ * Detect the SuperDB version from the configured binary
+ */
+export declare function detectVersion(superPath?: string): VersionInfo;
+/**
+ * Parse a YMMDD version string to a Date
+ * Format: 0.YMMDD (e.g., 0.51231 = 2025-12-31)
+ */
+export declare function parseYMMDDVersion(version: string): Date | null;
+/**
+ * Compare two version strings
+ * Returns: -1 if a < b, 0 if a == b, 1 if a > b
+ */
+export declare function compareVersions(a: string, b: string): -1 | 0 | 1;
+/**
+ * Check if the current version is at least the required version
+ */
+export declare function isVersionAtLeast(required: string, current?: string): boolean;
+/**
+ * Compare two SuperDB versions and return detailed info
+ */
+export declare function compareVersionInfo(currentPath?: string, compareToPath?: string): VersionComparison;
+/**
+ * Read version from embedded docs frontmatter
+ */
+export declare function getDocsVersion(): string;
+/**
+ * Check compatibility between runtime and docs
+ */
+export declare function checkDocsCompatibility(): {
+    runtime: VersionInfo;
+    docs: string;
+    compatible: boolean;
+    warnings: string[];
+};
+//# sourceMappingURL=version.d.ts.map

package/dist/lib/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../src/lib/version.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,IAAI,GAAG,IAAI,CAAC;IAClB,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,KAAK,GAAG,MAAM,GAAG,UAAU,CAAC;CACrC;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,WAAW,CAAC;IACrB,SAAS,EAAE,WAAW,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,OAAO,CAAC;IACxB,UAAU,EAAE,OAAO,CAAC;IACpB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED;;GAEG;AACH,wBAAgB,YAAY,IAAI,MAAM,CAErC;AAmDD;;GAEG;AACH,wBAAgB,aAAa,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,WAAW,CA8C7D;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAS9D;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAqBhE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAG5E;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,WAAW,CAAC,EAAE,MAAM,EACpB,aAAa,CAAC,EAAE,MAAM,GACrB,iBAAiB,CAqCnB;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,MAAM,CAIvC;AAED;;GAEG;AACH,wBAAgB,sBAAsB,IAAI;IACxC,OAAO,EAAE,WAAW,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,OAAO,CAAC;IACpB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB,CA0BA"}