@slbdn/mcp-tester 1.0.2 → 1.2.0

package/dist/matchers.js

@@ -0,0 +1,527 @@
+import { AssertionError } from './assert.js';
+// ─── Helpers ────────────────────────────────────────────────────────────────
+function extractTextFromContent(result) {
+    const item = result.content[0];
+    return item && 'text' in item ? item.text : undefined;
+}
+function formatList(items) {
+    return items.length > 0 ? items.join(', ') : '(none)';
+}
+// ─── Collection Matchers ────────────────────────────────────────────────────
+/**
+ * Check if a tool with the given name exists in the tools array.
+ * Works with `.not` for negation.
+ *
+ *   expect(tools).toHaveTool('echo');
+ *   expect(tools).not.toHaveTool('deprecated_tool');
+ */
+export const toHaveTool = (received, toolName) => {
+    const hasTool = received.some((tool) => tool.name === toolName);
+    return {
+        pass: hasTool,
+        message: () => hasTool
+            ? `Expected tools to NOT have "${toolName}"`
+            : `Expected tools to have "${toolName}", found: ${formatList(received.map((t) => t.name))}`,
+    };
+};
+/**
+ * Check if a resource with the given URI exists.
+ *
+ *   expect(resources).toHaveResource('config://settings');
+ */
+export const toHaveResource = (received, uri) => {
+    const hasResource = received.some((resource) => resource.uri === uri);
+    return {
+        pass: hasResource,
+        message: () => hasResource
+            ? `Expected resources to NOT have "${uri}"`
+            : `Expected resources to have "${uri}", found: ${formatList(received.map((r) => r.uri))}`,
+    };
+};
+/**
+ * Check if a prompt with the given name exists.
+ *
+ *   expect(prompts).toHavePrompt('greet');
+ */
+export const toHavePrompt = (received, promptName) => {
+    const hasPrompt = received.some((prompt) => prompt.name === promptName);
+    return {
+        pass: hasPrompt,
+        message: () => hasPrompt
+            ? `Expected prompts to NOT have "${promptName}"`
+            : `Expected prompts to have "${promptName}", found: ${formatList(received.map((p) => p.name))}`,
+    };
+};
+/**
+ * Check if a tool exists and has an input schema.
+ *
+ *   expect(tools).toHaveToolWithSchema('echo');
+ */
+export const toHaveToolWithSchema = (received, toolName) => {
+    const tool = received.find((t) => t.name === toolName);
+    if (!tool) {
+        return {
+            pass: false,
+            message: () => `Expected tools to have "${toolName}", found: ${formatList(received.map((t) => t.name))}`,
+        };
+    }
+    const hasSchema = !!tool.inputSchema;
+    return {
+        pass: hasSchema,
+        message: () => hasSchema
+            ? `Expected tool "${toolName}" to NOT have input schema`
+            : `Expected tool "${toolName}" to have input schema`,
+    };
+};
+/**
+ * Check that the tools array has exactly `count` items.
+ *
+ *   expect(tools).toHaveToolCount(5);
+ */
+export const toHaveToolCount = (received, count) => {
+    const actual = received.length;
+    return {
+        pass: actual === count,
+        message: () => actual === count
+            ? `Expected tools to NOT have exactly ${count} items`
+            : `Expected tools to have ${count} items, but found ${actual}: ${formatList(received.map((t) => t.name))}`,
+    };
+};
+/**
+ * Check that the resources array has exactly `count` items.
+ *
+ *   expect(resources).toHaveResourceCount(3);
+ */
+export const toHaveResourceCount = (received, count) => {
+    const actual = received.length;
+    return {
+        pass: actual === count,
+        message: () => actual === count
+            ? `Expected resources to NOT have exactly ${count} items`
+            : `Expected resources to have ${count} items, but found ${actual}: ${formatList(received.map((r) => r.uri))}`,
+    };
+};
+/**
+ * Check that the prompts array has exactly `count` items.
+ *
+ *   expect(prompts).toHavePromptCount(2);
+ */
+export const toHavePromptCount = (received, count) => {
+    const actual = received.length;
+    return {
+        pass: actual === count,
+        message: () => actual === count
+            ? `Expected prompts to NOT have exactly ${count} items`
+            : `Expected prompts to have ${count} items, but found ${actual}: ${formatList(received.map((p) => p.name))}`,
+    };
+};
+/**
+ * Check if a resource with the given display name exists.
+ *
+ *   expect(resources).toHaveResourceByName('Settings');
+ */
+export const toHaveResourceByName = (received, name) => {
+    const hasResource = received.some((resource) => resource.name === name);
+    return {
+        pass: hasResource,
+        message: () => hasResource
+            ? `Expected resources to NOT have "${name}"`
+            : `Expected resources to have "${name}", found: ${formatList(received.map((r) => r.name))}`,
+    };
+};
+/**
+ * Check if a prompt exists and has defined arguments (is parameterized).
+ *
+ *   expect(prompts).toHavePromptWithArgs('greet');
+ */
+export const toHavePromptWithArgs = (received, promptName) => {
+    const prompt = received.find((p) => p.name === promptName);
+    if (!prompt) {
+        return {
+            pass: false,
+            message: () => `Expected prompts to have "${promptName}", found: ${formatList(received.map((p) => p.name))}`,
+        };
+    }
+    const hasArgs = !!(prompt.arguments && prompt.arguments.length > 0);
+    return {
+        pass: hasArgs,
+        message: () => hasArgs
+            ? `Expected prompt "${promptName}" to NOT have arguments`
+            : `Expected prompt "${promptName}" to have arguments, but it has none`,
+    };
+};
+// ─── Tool Result Matchers ───────────────────────────────────────────────────
+/**
+ * Check that a tool result has text content.
+ * Optionally check that the text equals an exact string.
+ *
+ *   expect(result).toReturnText();               // has any text
+ *   expect(result).toReturnText('Hello World');    // text equals exactly
+ */
+export const toReturnText = (received, expected) => {
+    const text = extractTextFromContent(received);
+    if (text === undefined) {
+        return {
+            pass: false,
+            message: () => `Expected tool result to have text content, but got: ${JSON.stringify(received.content[0]?.type ?? 'empty')}`,
+        };
+    }
+    if (expected === undefined) {
+        return {
+            pass: true,
+            message: () => `Expected tool result to NOT have text content, but got: "${text}"`,
+        };
+    }
+    const matches = text === expected;
+    return {
+        pass: matches,
+        message: () => matches
+            ? `Expected tool text to NOT equal "${expected}"`
+            : `Expected tool text to equal "${expected}", but got: "${text}"`,
+    };
+};
+/**
+ * Check that a tool result's text contains a substring.
+ *
+ *   expect(result).toReturnTextContaining('hello');
+ */
+export const toReturnTextContaining = (received, substring) => {
+    const text = extractTextFromContent(received);
+    if (text === undefined) {
+        return {
+            pass: false,
+            message: () => `Expected tool result to contain "${substring}", but result has no text content`,
+        };
+    }
+    const contains = text.includes(substring);
+    return {
+        pass: contains,
+        message: () => contains
+            ? `Expected tool text to NOT contain "${substring}"`
+            : `Expected tool text to contain "${substring}", but got: "${text}"`,
+    };
+};
+/**
+ * Check that a tool result indicates an error (isError flag or "error" in text).
+ *
+ *   expect(result).toReturnError();
+ */
+export const toReturnError = (received) => {
+    const isError = received.isError ||
+        (extractTextFromContent(received)?.toLowerCase().includes('error') ?? false);
+    return {
+        pass: isError,
+        message: () => isError
+            ? `Expected tool result to NOT be an error`
+            : `Expected tool result to be an error, but it succeeded`,
+    };
+};
+/**
+ * Check that a tool result indicates success (no error).
+ *
+ *   expect(result).toReturnOk();
+ */
+export const toReturnOk = (received) => {
+    const isError = received.isError ||
+        (extractTextFromContent(received)?.toLowerCase().includes('error') ?? false);
+    return {
+        pass: !isError,
+        message: () => !isError
+            ? `Expected tool result to be an error, but it succeeded`
+            : `Expected tool result to be successful, but got error: ${extractTextFromContent(received) ?? '(no text)'}`,
+    };
+};
+/**
+ * Parse tool result text as JSON and deep-compare to expected object.
+ *
+ *   expect(result).toReturnJson({ status: 'ok', count: 5 });
+ */
+export const toReturnJson = (received, expected) => {
+    const text = extractTextFromContent(received);
+    if (text === undefined) {
+        return {
+            pass: false,
+            message: () => `Expected tool result to contain JSON, but result has no text content`,
+        };
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(text);
+    }
+    catch {
+        return {
+            pass: false,
+            message: () => `Expected tool result to be valid JSON, but got: "${text.substring(0, 100)}${text.length > 100 ? '...' : ''}"`,
+        };
+    }
+    const matches = JSON.stringify(parsed) === JSON.stringify(expected);
+    return {
+        pass: matches,
+        message: () => matches
+            ? `Expected tool JSON to NOT equal ${JSON.stringify(expected)}`
+            : `Expected tool JSON to equal:\n  ${JSON.stringify(expected)}\n\nReceived:\n  ${JSON.stringify(parsed)}`,
+    };
+};
+/**
+ * Check that a tool result has exactly `count` content items.
+ *
+ *   expect(result).toReturnContentCount(2);  // e.g. text + image
+ */
+export const toReturnContentCount = (received, count) => {
+    const actual = received.content.length;
+    return {
+        pass: actual === count,
+        message: () => actual === count
+            ? `Expected tool result to NOT have ${count} content items`
+            : `Expected tool result to have ${count} content items, but found ${actual}`,
+    };
+};
+/**
+ * Check that a tool result contains at least one image content item.
+ *
+ *   expect(result).toReturnImage();
+ */
+export const toReturnImage = (received) => {
+    const hasImage = received.content.some((item) => 'type' in item && item.type === 'image');
+    const types = received.content.map((c) => ('type' in c ? c.type : 'embedded')).join(', ');
+    return {
+        pass: hasImage,
+        message: () => hasImage
+            ? `Expected tool result to NOT contain an image`
+            : `Expected tool result to contain an image, but found types: ${types}`,
+    };
+};
+// ─── Resource Result Matchers ────────────────────────────────────────────────
+/**
+ * Check that a resource result has text content.
+ * Optionally check that the text equals an exact string.
+ *
+ *   expect(result).toReturnResourceText();              // has any text
+ *   expect(result).toReturnResourceText('expected');    // text equals exactly
+ */
+export const toReturnResourceText = (received, expected) => {
+    const item = received.contents[0];
+    if (!item || !('text' in item)) {
+        return {
+            pass: false,
+            message: () => 'Expected resource result to have text content',
+        };
+    }
+    const text = item.text;
+    if (expected === undefined) {
+        return {
+            pass: true,
+            message: () => `Expected resource result to NOT have text content, but got: "${text.substring(0, 50)}"`,
+        };
+    }
+    const matches = text === expected;
+    return {
+        pass: matches,
+        message: () => matches
+            ? `Expected resource text to NOT equal "${expected}"`
+            : `Expected resource text to equal "${expected}", but got: "${text}"`,
+    };
+};
+/**
+ * Check that a resource result's text contains a substring.
+ *
+ *   expect(result).toReturnResourceTextContaining('connection');
+ */
+export const toReturnResourceTextContaining = (received, substring) => {
+    const item = received.contents[0];
+    if (!item || !('text' in item)) {
+        return {
+            pass: false,
+            message: () => `Expected resource text to contain "${substring}", but result has no text content`,
+        };
+    }
+    const text = item.text;
+    const contains = text.includes(substring);
+    return {
+        pass: contains,
+        message: () => contains
+            ? `Expected resource text to NOT contain "${substring}"`
+            : `Expected resource text to contain "${substring}", but got: "${text.substring(0, 100)}${text.length > 100 ? '...' : ''}"`,
+    };
+};
+// ─── Prompt Result Matchers ─────────────────────────────────────────────────
+/**
+ * Check that a prompt result's first message text contains a substring.
+ *
+ *   expect(result).toReturnPromptTextContaining('Alice');
+ */
+export const toReturnPromptTextContaining = (received, substring) => {
+    const item = received.messages[0]?.content;
+    if (!item || !('text' in item)) {
+        return {
+            pass: false,
+            message: () => `Expected prompt message to contain "${substring}", but result has no text content`,
+        };
+    }
+    const text = item.text;
+    const contains = text.includes(substring);
+    return {
+        pass: contains,
+        message: () => contains
+            ? `Expected prompt text to NOT contain "${substring}"`
+            : `Expected prompt text to contain "${substring}", but got: "${text}"`,
+    };
+};
+/**
+ * Check that a prompt result has exactly `count` messages.
+ *
+ *   expect(result).toReturnPromptMessageCount(2);
+ */
+export const toReturnPromptMessageCount = (received, count) => {
+    const actual = received.messages.length;
+    return {
+        pass: actual === count,
+        message: () => actual === count
+            ? `Expected prompt to NOT have ${count} messages`
+            : `Expected prompt to have ${count} messages, but found ${actual}`,
+    };
+};
+// ─── Setup ──────────────────────────────────────────────────────────────────
+/**
+ * Register all custom matchers with Jest.
+ * Call once in test setup:
+ *
+ *   import { setupJestMatchers } from '@slbdn/mcp-tester';
+ *   beforeAll(() => setupJestMatchers());
+ *
+ * Or add to jest.setup.js for global availability.
+ *
+ * Also works as `setupCustomMatchers()` (alias kept for backward compat).
+ */
+export const setupJestMatchers = () => {
+    expect.extend({
+        // Collection
+        toHaveTool,
+        toHaveResource,
+        toHavePrompt,
+        toHaveToolWithSchema,
+        toHaveToolCount,
+        toHaveResourceCount,
+        toHavePromptCount,
+        toHaveResourceByName,
+        toHavePromptWithArgs,
+        // Tool results
+        toReturnText,
+        toReturnTextContaining,
+        toReturnError,
+        toReturnOk,
+        toReturnJson,
+        toReturnContentCount,
+        toReturnImage,
+        // Resource results
+        toReturnResourceText,
+        toReturnResourceTextContaining,
+        // Prompt results
+        toReturnPromptTextContaining,
+        toReturnPromptMessageCount,
+    });
+};
+/** @deprecated Use setupJestMatchers() instead */
+export const setupCustomMatchers = setupJestMatchers;
+/**
+ * Register all custom matchers with Vitest.
+ * Call once in test setup:
+ *
+ *   import { setupVitestMatchers } from '@slbdn/mcp-tester';
+ *   import { beforeAll } from 'vitest';
+ *   beforeAll(() => setupVitestMatchers());
+ */
+export const setupVitestMatchers = () => {
+    // Vitest's expect.extend is compatible with Jest's format
+    // eslint-disable-next-line @typescript-eslint/no-require-imports, @typescript-eslint/no-explicit-any
+    const vitestExpect = globalThis.expect;
+    if (!vitestExpect || typeof vitestExpect.extend !== 'function') {
+        throw new Error('setupVitestMatchers() must be called in a Vitest environment. ' +
+            'Make sure vitest is imported before calling this.');
+    }
+    vitestExpect.extend({
+        // Collection
+        toHaveTool,
+        toHaveResource,
+        toHavePrompt,
+        toHaveToolWithSchema,
+        toHaveToolCount,
+        toHaveResourceCount,
+        toHavePromptCount,
+        toHaveResourceByName,
+        toHavePromptWithArgs,
+        // Tool results
+        toReturnText,
+        toReturnTextContaining,
+        toReturnError,
+        toReturnOk,
+        toReturnJson,
+        toReturnContentCount,
+        toReturnImage,
+        // Resource results
+        toReturnResourceText,
+        toReturnResourceTextContaining,
+        // Prompt results
+        toReturnPromptTextContaining,
+        toReturnPromptMessageCount,
+    });
+};
+// Auto-setup for Jest environments (no-op outside Jest)
+if (typeof expect !== 'undefined' && typeof expect.extend === 'function') {
+    setupJestMatchers();
+}
+// ─── Standalone Assertion Wrappers ──────────────────────────────────────────
+// Thin wrappers that throw AssertionError — usable outside Jest with any test runner.
+/**
+ * Assert that a tool result has text content (optionally matching exactly).
+ * Works with any test runner — throws AssertionError on failure.
+ */
+export function assertToolText(result, expected, msg) {
+    const text = extractTextFromContent(result);
+    if (text === undefined)
+        throw new AssertionError(msg ?? 'Expected tool result to have text content');
+    if (expected !== undefined && text !== expected) {
+        throw new AssertionError(msg ?? `Expected tool text "${expected}", got "${text}"`);
+    }
+}
+/**
+ * Assert that a tool result text contains a substring.
+ * Works with any test runner — throws AssertionError on failure.
+ */
+export function assertToolTextContains(result, substring, msg) {
+    const text = extractTextFromContent(result);
+    if (text === undefined)
+        throw new AssertionError(msg ?? 'Expected tool result to have text content');
+    if (!text.includes(substring)) {
+        throw new AssertionError(msg ?? `Expected tool text to contain "${substring}", got: "${text}"`);
+    }
+}
+/**
+ * Assert that tools list contains a tool with the given name.
+ * Works with any test runner — throws AssertionError on failure.
+ */
+export function assertHasTool(tools, name, msg) {
+    if (!tools.some((t) => t.name === name)) {
+        throw new AssertionError(msg ?? `Expected tools to have "${name}", found: ${formatList(tools.map((t) => t.name))}`);
+    }
+}
+/**
+ * Assert that resources list contains a resource with the given URI.
+ * Works with any test runner — throws AssertionError on failure.
+ */
+export function assertHasResource(resources, uri, msg) {
+    if (!resources.some((r) => r.uri === uri)) {
+        throw new AssertionError(msg ??
+            `Expected resources to have "${uri}", found: ${formatList(resources.map((r) => r.uri))}`);
+    }
+}
+/**
+ * Assert that prompts list contains a prompt with the given name.
+ * Works with any test runner — throws AssertionError on failure.
+ */
+export function assertHasPrompt(prompts, name, msg) {
+    if (!prompts.some((p) => p.name === name)) {
+        throw new AssertionError(msg ?? `Expected prompts to have "${name}", found: ${formatList(prompts.map((p) => p.name))}`);
+    }
+}
+//# sourceMappingURL=matchers.js.map

package/dist/matchers.js.map

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

package/dist/utils/errors.d.ts

@@ -1,21 +1,97 @@
+/**
+ * Error classes for MCPClient operations.
+ *
+ * All errors include a descriptive message, error code, and proper stack trace.
+ * Timeout and connection errors include actionable suggestions for debugging.
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   await client.callTool({ name: 'invalid-tool', arguments: {} });
+ * } catch (error) {
+ *   if (error instanceof MCPServerError) {
+ *     console.error(`Server error: ${error.message}`);
+ *     console.error(`Operation: ${error.operation}`);
+ *   } else if (error instanceof MCPTimeoutError) {
+ *     console.error(`Timeout after ${error.timeout}ms on ${error.operation}`);
+ *     console.error(`Suggestions: ${error.suggestions.join(', ')}`);
+ *   } else if (error instanceof MCPConnectionError) {
+ *     console.error(`Connection failed: ${error.message}`);
+ *     console.error(`Command: ${error.command}`);
+ *   }
+ * }
+ * ```
+ */
+/**
+ * Base error class for all MCP client errors.
+ */
 export declare class MCPClientError extends Error {
+    /** Error code for programmatic error handling. */
     readonly code: string;
     constructor(message: string, code?: string);
 }
+/**
+ * Error thrown when a request times out.
+ *
+ * Includes the operation that timed out, the timeout value, and
+ * actionable suggestions for resolving the timeout.
+ */
 export declare class MCPTimeoutError extends MCPClientError {
+    /** The timeout value in milliseconds. */
     readonly timeout: number;
-    constructor(message: string, timeout: number);
+    /** The operation that timed out (e.g., "Call tool echo", "List tools"). */
+    readonly operation: string;
+    /** Actionable suggestions for resolving the timeout. */
+    readonly suggestions: string[];
+    constructor(message: string, timeout: number, operation?: string, suggestions?: string[]);
+    /**
+     * Generate default suggestions based on timeout value.
+     */
+    private static defaultSuggestions;
 }
+/**
+ * Error thrown when the client fails to connect to the MCP server.
+ *
+ * Includes the server command and actionable suggestions for resolving
+ * connection failures.
+ */
 export declare class MCPConnectionError extends MCPClientError {
-    constructor(message: string);
+    /** The command that was used to start the server. */
+    readonly command: string;
+    /** Actionable suggestions for resolving the connection failure. */
+    readonly suggestions: string[];
+    constructor(message: string, command?: string, suggestions?: string[]);
+    /**
+     * Generate default suggestions based on the server command.
+     */
+    private static defaultSuggestions;
 }
+/**
+ * Error thrown when a client method is called before start().
+ *
+ * Includes which method was called to help identify the issue.
+ */
 export declare class MCPNotStartedError extends MCPClientError {
-    constructor();
+    /** The method that was called on the unstarted client. */
+    readonly method: string;
+    constructor(method?: string);
 }
+/**
+ * Error thrown when start() is called on an already-started client.
+ */
 export declare class MCPAlreadyStartedError extends MCPClientError {
     constructor();
 }
+/**
+ * Error thrown when the MCP server returns an error response.
+ *
+ * Includes the operation that failed and the server error code if available.
+ */
 export declare class MCPServerError extends MCPClientError {
-    constructor(message: string);
+    /** The operation that failed (e.g., "Call tool echo", "Read resource config://settings"). */
+    readonly operation: string;
+    /** The MCP error code from the server response, if available. */
+    readonly serverCode?: number | string;
+    constructor(message: string, operation?: string, serverCode?: number | string);
 }
 //# sourceMappingURL=errors.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AAAA,qBAAa,cAAe,SAAQ,KAAK;IACvC,SAAgB,IAAI,EAAE,MAAM,CAAC;gBAEjB,OAAO,EAAE,MAAM,EAAE,IAAI,GAAE,MAA2B;CAM/D;AAED,qBAAa,eAAgB,SAAQ,cAAc;IACjD,SAAgB,OAAO,EAAE,MAAM,CAAC;gBAEpB,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;CAM7C;AAED,qBAAa,kBAAmB,SAAQ,cAAc;gBACxC,OAAO,EAAE,MAAM;CAK5B;AAED,qBAAa,kBAAmB,SAAQ,cAAc;;CAMrD;AAED,qBAAa,sBAAuB,SAAQ,cAAc;;CAMzD;AAED,qBAAa,cAAe,SAAQ,cAAc;gBACpC,OAAO,EAAE,MAAM;CAK5B"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH;;GAEG;AACH,qBAAa,cAAe,SAAQ,KAAK;IACvC,kDAAkD;IAClD,SAAgB,IAAI,EAAE,MAAM,CAAC;gBAEjB,OAAO,EAAE,MAAM,EAAE,IAAI,GAAE,MAA2B;CAM/D;AAED;;;;;GAKG;AACH,qBAAa,eAAgB,SAAQ,cAAc;IACjD,yCAAyC;IACzC,SAAgB,OAAO,EAAE,MAAM,CAAC;IAEhC,2EAA2E;IAC3E,SAAgB,SAAS,EAAE,MAAM,CAAC;IAElC,wDAAwD;IACxD,SAAgB,WAAW,EAAE,MAAM,EAAE,CAAC;gBAE1B,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,EAAE;IASxF;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,kBAAkB;CAoBlC;AAED;;;;;GAKG;AACH,qBAAa,kBAAmB,SAAQ,cAAc;IACpD,qDAAqD;IACrD,SAAgB,OAAO,EAAE,MAAM,CAAC;IAEhC,mEAAmE;IACnE,SAAgB,WAAW,EAAE,MAAM,EAAE,CAAC;gBAE1B,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,EAAE;IAQrE;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,kBAAkB;CA0BlC;AAED;;;;GAIG;AACH,qBAAa,kBAAmB,SAAQ,cAAc;IACpD,0DAA0D;IAC1D,SAAgB,MAAM,EAAE,MAAM,CAAC;gBAEnB,MAAM,CAAC,EAAE,MAAM;CAU5B;AAED;;GAEG;AACH,qBAAa,sBAAuB,SAAQ,cAAc;;CASzD;AAED;;;;GAIG;AACH,qBAAa,cAAe,SAAQ,cAAc;IAChD,6FAA6F;IAC7F,SAAgB,SAAS,EAAE,MAAM,CAAC;IAElC,iEAAiE;IACjE,SAAgB,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;gBAEjC,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM;CAO9E"}