@nitrostack/core 1.0.0

package/dist/core/tool.d.ts

@@ -0,0 +1,108 @@
+import { Tool as McpTool } from '@modelcontextprotocol/sdk/types.js';
+import { z } from 'zod';
+import { Component } from './component.js';
+import { ExecutionContext, JsonValue } from './types.js';
+import { GuardConstructor } from './guards/guard.interface.js';
+import { MiddlewareConstructor } from './middleware/middleware.interface.js';
+import { InterceptorConstructor } from './interceptors/interceptor.interface.js';
+import { PipeConstructor } from './pipes/pipe.interface.js';
+import { ExceptionFilterConstructor } from './filters/exception-filter.interface.js';
+/**
+ * JSON Schema representation for tool input
+ */
+export interface JsonSchema {
+    type?: string;
+    properties?: Record<string, JsonSchema>;
+    required?: string[];
+    items?: JsonSchema;
+    additionalProperties?: boolean | JsonSchema;
+    description?: string;
+    default?: JsonValue;
+    enum?: JsonValue[];
+    [key: string]: unknown;
+}
+/**
+ * Tool input schema - can be Zod schema or JSON Schema
+ */
+export type ToolInputSchema = z.ZodSchema | JsonSchema;
+/**
+ * Tool handler function type
+ */
+export type ToolHandler<TInput = unknown, TOutput = unknown> = (input: TInput, context: ExecutionContext) => Promise<TOutput>;
+/**
+ * Tool examples for documentation
+ */
+export interface ToolExamples {
+    request?: JsonValue;
+    response?: JsonValue;
+}
+export interface ToolOptions<TInput = unknown, TOutput = unknown> {
+    name: string;
+    description: string;
+    inputSchema: ToolInputSchema;
+    handler: ToolHandler<TInput, TOutput>;
+    guards?: GuardConstructor[];
+    middlewares?: MiddlewareConstructor[];
+    interceptors?: InterceptorConstructor[];
+    pipes?: PipeConstructor[];
+    filters?: ExceptionFilterConstructor[];
+    examples?: ToolExamples;
+    widget?: {
+        route: string;
+    };
+    outputTemplate?: string;
+    isInitial?: boolean;
+}
+export declare class Tool<TInput = unknown, TOutput = unknown> {
+    name: string;
+    description: string;
+    inputSchema: ToolInputSchema;
+    examples?: ToolExamples;
+    widget?: {
+        route: string;
+    };
+    outputTemplate?: string;
+    isInitial?: boolean;
+    private handler;
+    private guards;
+    private middlewares;
+    private interceptors;
+    private pipes;
+    private filters;
+    private component?;
+    constructor(options: ToolOptions<TInput, TOutput>);
+    /**
+     * Execute the tool with full pipeline:
+     * Exception Filters -> Guards -> Middleware -> Interceptors -> Pipes -> Handler
+     */
+    execute(input: TInput, context: ExecutionContext): Promise<TOutput>;
+    /**
+     * Execute with interceptor chain
+     */
+    private executeWithInterceptors;
+    /**
+     * Execute pipes and then the handler
+     */
+    private executeWithPipes;
+    /**
+     * Attach a UI component to this tool
+     */
+    setComponent(component: Component): void;
+    /**
+     * Check if tool has a component
+     */
+    hasComponent(): boolean;
+    /**
+     * Get the attached component
+     */
+    getComponent(): Component | undefined;
+    /**
+     * Check if schema is a Zod schema
+     */
+    private isZodSchema;
+    /**
+     * Convert to MCP tool format
+     */
+    toMcpTool(): Promise<McpTool>;
+}
+//# sourceMappingURL=tool.d.ts.map

package/dist/core/tool.d.ts.map

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

package/dist/core/tool.js

@@ -0,0 +1,241 @@
+import { DIContainer } from './di/container.js';
+export class Tool {
+    name;
+    description;
+    inputSchema;
+    examples;
+    widget;
+    outputTemplate;
+    isInitial;
+    handler;
+    guards;
+    middlewares;
+    interceptors;
+    pipes;
+    filters;
+    component;
+    constructor(options) {
+        this.name = options.name;
+        this.description = options.description;
+        this.inputSchema = options.inputSchema;
+        this.handler = options.handler;
+        this.guards = options.guards || [];
+        this.middlewares = options.middlewares || [];
+        this.interceptors = options.interceptors || [];
+        this.pipes = options.pipes || [];
+        this.filters = options.filters || [];
+        this.examples = options.examples;
+        this.widget = options.widget;
+        this.outputTemplate = options.outputTemplate;
+        this.isInitial = options.isInitial;
+    }
+    /**
+     * Execute the tool with full pipeline:
+     * Exception Filters -> Guards -> Middleware -> Interceptors -> Pipes -> Handler
+     */
+    async execute(input, context) {
+        const container = DIContainer.getInstance();
+        try {
+            // 1. Execute Guards
+            for (const GuardClass of this.guards) {
+                const guard = container.has(GuardClass)
+                    ? container.resolve(GuardClass)
+                    : new GuardClass();
+                const canActivate = await guard.canActivate(context);
+                if (!canActivate) {
+                    throw new Error('Access denied by guard');
+                }
+            }
+            // 2. Build Middleware Chain
+            const middlewareChain = async (chainInput) => {
+                let index = 0;
+                const middlewareInstances = this.middlewares.map(M => container.has(M) ? container.resolve(M) : new M());
+                const next = async () => {
+                    if (index >= middlewareInstances.length) {
+                        // 3. Build Interceptor Chain
+                        return await this.executeWithInterceptors(chainInput, context);
+                    }
+                    const middleware = middlewareInstances[index++];
+                    return await middleware.use(context, next);
+                };
+                return await next();
+            };
+            return await middlewareChain(input);
+        }
+        catch (error) {
+            // Execute Exception Filters
+            if (this.filters.length > 0) {
+                for (const FilterClass of this.filters) {
+                    const filter = container.has(FilterClass)
+                        ? container.resolve(FilterClass)
+                        : new FilterClass();
+                    return await filter.catch(error, context);
+                }
+            }
+            // Re-throw if no filters handled it
+            throw error;
+        }
+    }
+    /**
+     * Execute with interceptor chain
+     */
+    async executeWithInterceptors(input, context) {
+        const container = DIContainer.getInstance();
+        let index = 0;
+        const interceptorInstances = this.interceptors.map(I => container.has(I) ? container.resolve(I) : new I());
+        const next = async () => {
+            if (index >= interceptorInstances.length) {
+                // 4. Execute Pipes, then Handler
+                return await this.executeWithPipes(input, context);
+            }
+            const interceptor = interceptorInstances[index++];
+            return await interceptor.intercept(context, next);
+        };
+        return await next();
+    }
+    /**
+     * Execute pipes and then the handler
+     */
+    async executeWithPipes(input, context) {
+        const container = DIContainer.getInstance();
+        let transformedInput = input;
+        // Execute Pipes
+        for (const PipeClass of this.pipes) {
+            const pipe = container.has(PipeClass)
+                ? container.resolve(PipeClass)
+                : new PipeClass();
+            transformedInput = await pipe.transform(transformedInput, {
+                type: 'body',
+                metatype: undefined,
+                data: undefined,
+            });
+        }
+        // Finally, execute the actual handler
+        return await this.handler(transformedInput, context);
+    }
+    /**
+     * Attach a UI component to this tool
+     */
+    setComponent(component) {
+        this.component = component;
+    }
+    /**
+     * Check if tool has a component
+     */
+    hasComponent() {
+        return this.component !== undefined;
+    }
+    /**
+     * Get the attached component
+     */
+    getComponent() {
+        return this.component;
+    }
+    /**
+     * Check if schema is a Zod schema
+     */
+    isZodSchema(schema) {
+        return schema && typeof schema === 'object' && '_def' in schema;
+    }
+    /**
+     * Convert to MCP tool format
+     */
+    async toMcpTool() {
+        // Convert Zod schema to JSON Schema if needed
+        let jsonSchema = this.inputSchema;
+        // If it's a Zod schema, convert it
+        if (this.isZodSchema(this.inputSchema)) {
+            // It's a Zod schema, need to convert to JSON Schema
+            try {
+                // Dynamic import for ES modules
+                const zodToJsonSchemaModule = await import('zod-to-json-schema');
+                const zodToJsonSchema = zodToJsonSchemaModule.zodToJsonSchema || zodToJsonSchemaModule.default;
+                // Convert with $refStrategy: 'none' to inline all properties
+                const converted = zodToJsonSchema(this.inputSchema, {
+                    $refStrategy: 'none', // Don't use $refs, inline everything
+                    target: 'jsonSchema7',
+                });
+                jsonSchema = converted;
+            }
+            catch (error) {
+                // Error converting - use stderr to avoid corrupting MCP protocol
+                console.error('Error converting Zod schema:', error);
+                // Fallback: create a basic object schema
+                jsonSchema = {
+                    type: 'object',
+                    properties: {},
+                    additionalProperties: true,
+                };
+            }
+        }
+        // Ensure type is set to "object" if not present
+        if (!jsonSchema.type) {
+            jsonSchema = {
+                ...jsonSchema,
+                type: 'object',
+            };
+        }
+        // Construct the final schema, ensuring type is "object"
+        const { type: schemaType, ...restSchema } = jsonSchema;
+        const finalSchema = {
+            ...restSchema,
+            type: 'object',
+        };
+        const mcpTool = {
+            name: this.name,
+            description: this.description,
+            inputSchema: finalSchema,
+        };
+        // Initialize _meta if needed
+        mcpTool._meta = mcpTool._meta || {};
+        // Initial tool flag
+        if (this.isInitial) {
+            mcpTool._meta['tool/initial'] = true;
+        }
+        // Include examples if available
+        if (this.examples) {
+            mcpTool.examples = this.examples;
+            // CRITICAL: Also store examples in _meta to ensure they're preserved
+            // through MCP serialization/deserialization. The studio checks _meta
+            // fields, and custom top-level fields may be stripped by the MCP SDK.
+            mcpTool._meta['tool/examples'] = this.examples;
+        }
+        // Include widget if available (for backward compatibility)
+        if (this.widget) {
+            mcpTool.widget = this.widget;
+        }
+        // Include outputTemplate if available (for backward compatibility)
+        if (this.outputTemplate) {
+            mcpTool.outputTemplate = this.outputTemplate;
+        }
+        // CRITICAL: Also store widget info in _meta to ensure it's preserved
+        // through MCP serialization/deserialization. The studio checks _meta
+        // fields, and custom top-level fields may be stripped by the MCP SDK.
+        // 1. Check if we have an attached component (preferred)
+        if (this.component) {
+            const resourceUri = this.component.getResourceUri();
+            mcpTool._meta['ui/template'] = resourceUri;
+            mcpTool._meta['openai/outputTemplate'] = resourceUri;
+            // Add other component metadata
+            const componentMeta = this.component.getResourceMetadata();
+            if (componentMeta) {
+                // Merge relevant metadata
+                const widgetDesc = componentMeta['openai/widgetDescription'];
+                if (widgetDesc !== undefined) {
+                    mcpTool._meta['openai/widgetDescription'] = widgetDesc;
+                }
+            }
+        }
+        // 2. Fallback to legacy widget/outputTemplate options
+        else if (this.widget || this.outputTemplate) {
+            // Prioritize widget.route over outputTemplate
+            const widgetRoute = this.widget?.route || this.outputTemplate;
+            if (widgetRoute) {
+                mcpTool._meta['ui/template'] = widgetRoute;
+                mcpTool._meta['openai/outputTemplate'] = widgetRoute;
+            }
+        }
+        return mcpTool;
+    }
+}
+//# sourceMappingURL=tool.js.map

package/dist/core/tool.js.map

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

package/dist/core/transports/discovery-http-server.d.ts

@@ -0,0 +1,19 @@
+import http from 'http';
+interface Logger {
+    info(message: string, ...args: unknown[]): void;
+    warn(message: string, ...args: unknown[]): void;
+    error(message: string, ...args: unknown[]): void;
+}
+export declare class DiscoveryHttpServer {
+    private port;
+    private logger;
+    private server;
+    private handlers;
+    constructor(port: number, logger: Logger);
+    private handleRequest;
+    on(path: string, handler: http.RequestListener): void;
+    start(): Promise<void>;
+    stop(): Promise<void>;
+}
+export {};
+//# sourceMappingURL=discovery-http-server.d.ts.map

package/dist/core/transports/discovery-http-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"discovery-http-server.d.ts","sourceRoot":"","sources":["../../../src/core/transports/discovery-http-server.ts"],"names":[],"mappings":"AACA,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB,UAAU,MAAM;IACd,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAChD,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAChD,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;CAClD;AAED,qBAAa,mBAAmB;IAIlB,OAAO,CAAC,IAAI;IAAU,OAAO,CAAC,MAAM;IAHhD,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,QAAQ,CAAgD;gBAE5C,IAAI,EAAE,MAAM,EAAU,MAAM,EAAE,MAAM;IAIxD,OAAO,CAAC,aAAa;IAYd,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,eAAe;IAK9C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IActB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAY7B"}

package/dist/core/transports/discovery-http-server.js

@@ -0,0 +1,54 @@
+import http from 'http';
+export class DiscoveryHttpServer {
+    port;
+    logger;
+    server;
+    handlers = new Map();
+    constructor(port, logger) {
+        this.port = port;
+        this.logger = logger;
+        this.server = http.createServer(this.handleRequest.bind(this));
+    }
+    handleRequest(req, res) {
+        this.logger.info(`DiscoveryHttpServer: Received request for ${req.url}`);
+        const handler = this.handlers.get(req.url || '');
+        if (handler) {
+            handler(req, res);
+        }
+        else {
+            this.logger.warn(`DiscoveryHttpServer: No handler found for ${req.url}`);
+            res.writeHead(404);
+            res.end();
+        }
+    }
+    on(path, handler) {
+        this.logger.info(`DiscoveryHttpServer: Registering handler for ${path}`);
+        this.handlers.set(path, handler);
+    }
+    start() {
+        return new Promise((resolve, reject) => {
+            this.server.listen(this.port, () => {
+                this.logger.info(`🚀 OAuth discovery server running at http://localhost:${this.port}`);
+                resolve();
+            });
+            this.server.on('error', (err) => {
+                this.logger.error('OAuth discovery server error', err);
+                reject(err);
+            });
+        });
+    }
+    stop() {
+        return new Promise((resolve) => {
+            if (this.server.listening) {
+                this.server.close(() => {
+                    this.logger.info('OAuth discovery server stopped');
+                    resolve();
+                });
+            }
+            else {
+                resolve();
+            }
+        });
+    }
+}
+//# sourceMappingURL=discovery-http-server.js.map

package/dist/core/transports/discovery-http-server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"discovery-http-server.js","sourceRoot":"","sources":["../../../src/core/transports/discovery-http-server.ts"],"names":[],"mappings":"AACA,OAAO,IAAI,MAAM,MAAM,CAAC;AAQxB,MAAM,OAAO,mBAAmB;IAIV;IAAsB;IAHlC,MAAM,CAAc;IACpB,QAAQ,GAAsC,IAAI,GAAG,EAAE,CAAC;IAEhE,YAAoB,IAAY,EAAU,MAAc;QAApC,SAAI,GAAJ,IAAI,CAAQ;QAAU,WAAM,GAAN,MAAM,CAAQ;QACtD,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IACjE,CAAC;IAEO,aAAa,CAAC,GAAyB,EAAE,GAAwB;QACvE,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,6CAA6C,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC;QACzE,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,IAAI,EAAE,CAAC,CAAC;QACjD,IAAI,OAAO,EAAE,CAAC;YACZ,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;QACpB,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,6CAA6C,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC;YACzE,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;YACnB,GAAG,CAAC,GAAG,EAAE,CAAC;QACZ,CAAC;IACH,CAAC;IAEM,EAAE,CAAC,IAAY,EAAE,OAA6B;QACnD,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,gDAAgD,IAAI,EAAE,CAAC,CAAC;QACzE,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACnC,CAAC;IAEM,KAAK;QACV,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACrC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,EAAE;gBACjC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,yDAAyD,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;gBACvF,OAAO,EAAE,CAAC;YACZ,CAAC,CAAC,CAAC;YAEH,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;gBAC9B,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,8BAA8B,EAAE,GAAG,CAAC,CAAC;gBACvD,MAAM,CAAC,GAAG,CAAC,CAAC;YACd,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;IAEM,IAAI;QACT,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;YAC7B,IAAI,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC;gBAC1B,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE;oBACrB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,gCAAgC,CAAC,CAAC;oBACnD,OAAO,EAAE,CAAC;gBACZ,CAAC,CAAC,CAAC;YACL,CAAC;iBAAM,CAAC;gBACN,OAAO,EAAE,CAAC;YACZ,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/core/transports/http-server.d.ts

@@ -0,0 +1,108 @@
+/**
+ * HTTP Server Transport for MCP
+ *
+ * Implements HTTP transport with Server-Sent Events (SSE) for bidirectional communication.
+ * Required for OAuth 2.1 authentication as per MCP specification.
+ *
+ * This transport:
+ * - Exposes MCP over HTTP endpoints
+ * - Provides OAuth 2.1 metadata endpoints (RFC 9728)
+ * - Uses SSE for server-to-client messages
+ * - Uses POST for client-to-server messages
+ */
+import { Express, Request, Response } from 'express';
+import { Transport } from '@modelcontextprotocol/sdk/shared/transport.js';
+import { JSONRPCMessage } from '@modelcontextprotocol/sdk/types.js';
+export interface HttpServerTransportOptions {
+    /**
+     * Port to listen on (default: 3000)
+     */
+    port?: number;
+    /**
+     * Host to bind to (default: '0.0.0.0')
+     */
+    host?: string;
+    /**
+     * Base path for MCP endpoints (default: '/mcp')
+     */
+    basePath?: string;
+    /**
+     * OAuth configuration (if enabled)
+     */
+    oauth?: {
+        resourceUri: string;
+        authorizationServers: string[];
+        scopesSupported?: string[];
+    };
+    /**
+     * Custom Express app (optional - for integration with existing apps)
+     */
+    app?: Express;
+}
+/**
+ * HTTP Server Transport
+ *
+ * Implements MCP protocol over HTTP with SSE for real-time communication.
+ * Compatible with OAuth 2.1 authentication.
+ */
+export declare class HttpServerTransport implements Transport {
+    private app;
+    private server;
+    private sseClients;
+    private messageHandler?;
+    private closeHandler?;
+    private errorHandler?;
+    private options;
+    constructor(options?: HttpServerTransportOptions);
+    /**
+     * Setup HTTP routes for MCP protocol
+     */
+    private setupRoutes;
+    /**
+     * Handle SSE connection for server-to-client messages
+     */
+    private handleSSE;
+    /**
+     * Handle incoming message from client
+     */
+    private handleMessage;
+    /**
+     * Handle OAuth Protected Resource Metadata request (RFC 9728)
+     */
+    private handleProtectedResourceMetadata;
+    /**
+     * Start the HTTP server
+     */
+    start(): Promise<void>;
+    /**
+     * Send message to client(s)
+     */
+    send(message: JSONRPCMessage): Promise<void>;
+    /**
+     * Close the transport
+     */
+    close(): Promise<void>;
+    /**
+     * Set message handler
+     */
+    set onmessage(handler: (message: JSONRPCMessage) => Promise<void>);
+    /**
+     * Set close handler
+     */
+    set onclose(handler: () => void);
+    /**
+     * Set error handler
+     */
+    set onerror(handler: (error: Error) => void);
+    /**
+     * Get the Express app (for adding custom routes)
+     */
+    getApp(): Express;
+    /**
+     * Register a custom route handler (compatible with DiscoveryHttpServer interface)
+     * @param path - The route path
+     * @param handler - The request handler (Node.js http.RequestListener format)
+     */
+    on(path: string, handler: (req: Request, res: Response) => void): void;
+}
+//# sourceMappingURL=http-server.d.ts.map

package/dist/core/transports/http-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-server.d.ts","sourceRoot":"","sources":["../../../src/core/transports/http-server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAgB,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAE9D,OAAO,EAAE,SAAS,EAAE,MAAM,+CAA+C,CAAC;AAC1E,OAAO,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAEpE,MAAM,WAAW,0BAA0B;IACzC;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,KAAK,CAAC,EAAE;QACN,WAAW,EAAE,MAAM,CAAC;QACpB,oBAAoB,EAAE,MAAM,EAAE,CAAC;QAC/B,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;KAC5B,CAAC;IAEF;;OAEG;IACH,GAAG,CAAC,EAAE,OAAO,CAAC;CACf;AAED;;;;;GAKG;AACH,qBAAa,mBAAoB,YAAW,SAAS;IACnD,OAAO,CAAC,GAAG,CAAU;IACrB,OAAO,CAAC,MAAM,CAA2B;IACzC,OAAO,CAAC,UAAU,CAAoC;IACtD,OAAO,CAAC,cAAc,CAAC,CAA6C;IACpE,OAAO,CAAC,YAAY,CAAC,CAAa;IAClC,OAAO,CAAC,YAAY,CAAC,CAAyB;IAC9C,OAAO,CAAC,OAAO,CAAgH;gBAEnH,OAAO,GAAE,0BAA+B;IAYpD;;OAEG;IACH,OAAO,CAAC,WAAW;IA8DnB;;OAEG;IACH,OAAO,CAAC,SAAS;IAsBjB;;OAEG;YACW,aAAa;IAqB3B;;OAEG;IACH,OAAO,CAAC,+BAA+B;IAiBvC;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAqD5B;;OAEG;IACG,IAAI,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAclD;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IA2C5B;;OAEG;IACH,IAAI,SAAS,CAAC,OAAO,EAAE,CAAC,OAAO,EAAE,cAAc,KAAK,OAAO,CAAC,IAAI,CAAC,EAEhE;IAED;;OAEG;IACH,IAAI,OAAO,CAAC,OAAO,EAAE,MAAM,IAAI,EAE9B;IAED;;OAEG;IACH,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,EAE1C;IAED;;OAEG;IACH,MAAM,IAAI,OAAO;IAIjB;;;;OAIG;IACH,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,KAAK,IAAI,GAAG,IAAI;CAGvE"}