@crypto512/jicon-mcp 0.7.1 → 1.0.0

package/dist/utils/plantuml/docker-manager.js

@@ -0,0 +1,280 @@
+/**
+ * PlantUML Docker Container Manager
+ *
+ * Manages the lifecycle of PlantUML server Docker containers.
+ * - Lazy initialization on first use
+ * - Dynamic port allocation
+ * - Graceful shutdown on process exit
+ * - Multi-instance support (each MCP gets unique container)
+ */
+import Docker from "dockerode";
+import getPort from "get-port";
+import { DEFAULT_PLANTUML_CONFIG } from "./types.js";
+const docker = new Docker();
+/**
+ * Container manager instance - singleton per process
+ */
+let containerState = null;
+let startupPromise = null;
+let shutdownRegistered = false;
+/**
+ * Generate unique container name for this MCP instance
+ */
+function generateContainerName() {
+    return `jicon-plantuml-${process.pid}-${Date.now()}`;
+}
+/**
+ * Wait for container to be healthy (PlantUML server responding)
+ */
+async function waitForHealthy(baseUrl, timeoutMs) {
+    const startTime = Date.now();
+    const checkInterval = 500;
+    while (Date.now() - startTime < timeoutMs) {
+        try {
+            const response = await fetch(baseUrl, {
+                method: "GET",
+                signal: AbortSignal.timeout(2000),
+            });
+            if (response.ok) {
+                return true;
+            }
+        }
+        catch {
+            // Server not ready yet, continue polling
+        }
+        await new Promise((resolve) => setTimeout(resolve, checkInterval));
+    }
+    return false;
+}
+/**
+ * Register shutdown handlers to clean up container on process exit
+ */
+function registerShutdownHandlers() {
+    if (shutdownRegistered)
+        return;
+    shutdownRegistered = true;
+    const cleanup = async () => {
+        if (containerState) {
+            try {
+                const container = docker.getContainer(containerState.containerId);
+                await container.stop({ t: 5 });
+                await container.remove({ force: true });
+            }
+            catch {
+                // Container may already be stopped/removed
+            }
+            containerState = null;
+        }
+    };
+    // Handle graceful shutdown
+    process.on("SIGINT", async () => {
+        await cleanup();
+        process.exit(0);
+    });
+    process.on("SIGTERM", async () => {
+        await cleanup();
+        process.exit(0);
+    });
+    // Handle unexpected exits
+    process.on("beforeExit", async () => {
+        await cleanup();
+    });
+    // Handle uncaught exceptions - try to cleanup
+    process.on("uncaughtException", async (err) => {
+        console.error("Uncaught exception, cleaning up PlantUML container:", err);
+        await cleanup();
+        process.exit(1);
+    });
+}
+/**
+ * Pull Docker image if not present
+ */
+async function ensureImage(imageName) {
+    try {
+        await docker.getImage(imageName).inspect();
+    }
+    catch {
+        // Image not found, pull it
+        console.error(`Pulling PlantUML image: ${imageName}...`);
+        await new Promise((resolve, reject) => {
+            docker.pull(imageName, (err, stream) => {
+                if (err) {
+                    reject(err);
+                    return;
+                }
+                docker.modem.followProgress(stream, (err) => {
+                    if (err)
+                        reject(err);
+                    else
+                        resolve();
+                });
+            });
+        });
+    }
+}
+/**
+ * Start a new PlantUML container
+ */
+export async function startContainer(config = {}) {
+    // If already started or starting, return existing/pending state
+    if (containerState?.ready) {
+        return containerState;
+    }
+    if (startupPromise) {
+        return startupPromise;
+    }
+    const mergedConfig = { ...DEFAULT_PLANTUML_CONFIG, ...config };
+    startupPromise = (async () => {
+        try {
+            // Register cleanup handlers
+            registerShutdownHandlers();
+            // Ensure image is available
+            await ensureImage(mergedConfig.image);
+            // Find available port
+            const port = await getPort({
+                port: Array.from({ length: mergedConfig.portRangeEnd - mergedConfig.portRangeStart }, (_, i) => mergedConfig.portRangeStart + i),
+            });
+            const containerName = generateContainerName();
+            const baseUrl = `http://localhost:${port}`;
+            // Create and start container
+            const container = await docker.createContainer({
+                name: containerName,
+                Image: mergedConfig.image,
+                ExposedPorts: {
+                    "8080/tcp": {},
+                },
+                HostConfig: {
+                    PortBindings: {
+                        "8080/tcp": [{ HostPort: port.toString() }],
+                    },
+                    AutoRemove: true,
+                },
+                Labels: {
+                    "jicon.managed": "true",
+                    "jicon.pid": process.pid.toString(),
+                },
+            });
+            await container.start();
+            // Wait for PlantUML server to be ready
+            const healthy = await waitForHealthy(baseUrl, mergedConfig.startupTimeout);
+            if (!healthy) {
+                // Cleanup failed container
+                try {
+                    await container.stop({ t: 1 });
+                    await container.remove({ force: true });
+                }
+                catch {
+                    // Ignore cleanup errors
+                }
+                throw new Error(`PlantUML container failed to become healthy within ${mergedConfig.startupTimeout}ms`);
+            }
+            containerState = {
+                containerId: container.id,
+                containerName,
+                port,
+                baseUrl,
+                ready: true,
+            };
+            return containerState;
+        }
+        catch (error) {
+            startupPromise = null;
+            throw error;
+        }
+    })();
+    return startupPromise;
+}
+/**
+ * Get current container state (if running)
+ */
+export function getContainerState() {
+    return containerState;
+}
+/**
+ * Check if container is running and healthy
+ */
+export async function isContainerHealthy() {
+    if (!containerState?.ready) {
+        return false;
+    }
+    try {
+        const response = await fetch(containerState.baseUrl, {
+            method: "GET",
+            signal: AbortSignal.timeout(2000),
+        });
+        return response.ok;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Stop and remove the container
+ */
+export async function stopContainer() {
+    if (!containerState) {
+        return;
+    }
+    try {
+        const container = docker.getContainer(containerState.containerId);
+        await container.stop({ t: 5 });
+        // AutoRemove is set, so container will be removed automatically
+    }
+    catch {
+        // Container may already be stopped
+    }
+    containerState = null;
+    startupPromise = null;
+}
+/**
+ * Ensure container is running (start if needed)
+ */
+export async function ensureContainer(config) {
+    // Check if existing container is healthy
+    if (containerState?.ready) {
+        const healthy = await isContainerHealthy();
+        if (healthy) {
+            return containerState;
+        }
+        // Container died, reset state
+        containerState = null;
+        startupPromise = null;
+    }
+    return startContainer(config);
+}
+/**
+ * Clean up any orphaned Jicon PlantUML containers from previous runs
+ */
+export async function cleanupOrphanedContainers() {
+    let cleaned = 0;
+    try {
+        const containers = await docker.listContainers({
+            all: true,
+            filters: {
+                label: ["jicon.managed=true"],
+            },
+        });
+        for (const containerInfo of containers) {
+            // Don't remove our own container
+            if (containerState && containerInfo.Id === containerState.containerId) {
+                continue;
+            }
+            try {
+                const container = docker.getContainer(containerInfo.Id);
+                if (containerInfo.State === "running") {
+                    await container.stop({ t: 1 });
+                }
+                await container.remove({ force: true });
+                cleaned++;
+            }
+            catch {
+                // Ignore errors for individual containers
+            }
+        }
+    }
+    catch {
+        // Docker may not be available
+    }
+    return cleaned;
+}
+//# sourceMappingURL=docker-manager.js.map

package/dist/utils/plantuml/docker-manager.js.map

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

package/dist/utils/plantuml/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * PlantUML Module Exports
+ *
+ * Docker-based PlantUML validation and rendering service.
+ */
+export * from "./types.js";
+export { validate, render, isAvailable, getStatus, shutdown, configure, normalizePlantUml, detectDiagramType, } from "./service.js";
+export { startContainer, stopContainer, ensureContainer, getContainerState, isContainerHealthy, cleanupOrphanedContainers, } from "./docker-manager.js";
+export { PlantUmlClient, encodePlantUml } from "./client.js";
+export { createPlantUmlTools, PLANTUML_TOOLS } from "./tools.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/utils/plantuml/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/plantuml/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,cAAc,YAAY,CAAC;AAG3B,OAAO,EACL,QAAQ,EACR,MAAM,EACN,WAAW,EACX,SAAS,EACT,QAAQ,EACR,SAAS,EACT,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,cAAc,CAAC;AAGtB,OAAO,EACL,cAAc,EACd,aAAa,EACb,eAAe,EACf,iBAAiB,EACjB,kBAAkB,EAClB,yBAAyB,GAC1B,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAG7D,OAAO,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC"}

package/dist/utils/plantuml/index.js

@@ -0,0 +1,16 @@
+/**
+ * PlantUML Module Exports
+ *
+ * Docker-based PlantUML validation and rendering service.
+ */
+// Types
+export * from "./types.js";
+// Service (main API)
+export { validate, render, isAvailable, getStatus, shutdown, configure, normalizePlantUml, detectDiagramType, } from "./service.js";
+// Docker manager (for lifecycle control)
+export { startContainer, stopContainer, ensureContainer, getContainerState, isContainerHealthy, cleanupOrphanedContainers, } from "./docker-manager.js";
+// HTTP client (for direct access if needed)
+export { PlantUmlClient, encodePlantUml } from "./client.js";
+// MCP Tools
+export { createPlantUmlTools, PLANTUML_TOOLS } from "./tools.js";
+//# sourceMappingURL=index.js.map

package/dist/utils/plantuml/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/utils/plantuml/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,QAAQ;AACR,cAAc,YAAY,CAAC;AAE3B,qBAAqB;AACrB,OAAO,EACL,QAAQ,EACR,MAAM,EACN,WAAW,EACX,SAAS,EACT,QAAQ,EACR,SAAS,EACT,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,cAAc,CAAC;AAEtB,yCAAyC;AACzC,OAAO,EACL,cAAc,EACd,aAAa,EACb,eAAe,EACf,iBAAiB,EACjB,kBAAkB,EAClB,yBAAyB,GAC1B,MAAM,qBAAqB,CAAC;AAE7B,4CAA4C;AAC5C,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAE7D,YAAY;AACZ,OAAO,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC"}

package/dist/utils/plantuml/service.d.ts

@@ -0,0 +1,46 @@
+/**
+ * PlantUML Service
+ *
+ * Unified service facade for PlantUML operations.
+ * Handles lazy container initialization and provides high-level API.
+ */
+import { normalizePlantUml, detectDiagramType } from "./client.js";
+import type { PlantUmlConfig, PlantUmlValidationResult, PlantUmlRenderResult, RenderFormat } from "./types.js";
+/**
+ * Configure the PlantUML service
+ */
+export declare function configure(config: PlantUmlConfig): void;
+/**
+ * Validate PlantUML syntax
+ *
+ * Starts the Docker container on first call if not already running.
+ */
+export declare function validate(code: string): Promise<PlantUmlValidationResult>;
+/**
+ * Render PlantUML diagram to specified format
+ *
+ * Starts the Docker container on first call if not already running.
+ */
+export declare function render(code: string, format: RenderFormat): Promise<PlantUmlRenderResult>;
+/**
+ * Check if PlantUML service is available (container running)
+ */
+export declare function isAvailable(): boolean;
+/**
+ * Get current service status
+ */
+export declare function getStatus(): {
+    available: boolean;
+    containerId?: string;
+    port?: number;
+    baseUrl?: string;
+};
+/**
+ * Shutdown the PlantUML service (stop container)
+ */
+export declare function shutdown(): Promise<void>;
+/**
+ * Re-export utility functions for convenience
+ */
+export { normalizePlantUml, detectDiagramType };
+//# sourceMappingURL=service.d.ts.map

package/dist/utils/plantuml/service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../../src/utils/plantuml/service.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAkB,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AACnF,OAAO,KAAK,EACV,cAAc,EACd,wBAAwB,EACxB,oBAAoB,EACpB,YAAY,EACb,MAAM,YAAY,CAAC;AAapB;;GAEG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,cAAc,GAAG,IAAI,CAItD;AAyBD;;;;GAIG;AACH,wBAAsB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,wBAAwB,CAAC,CAG9E;AAED;;;;GAIG;AACH,wBAAsB,MAAM,CAC1B,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,YAAY,GACnB,OAAO,CAAC,oBAAoB,CAAC,CAG/B;AAED;;GAEG;AACH,wBAAgB,WAAW,IAAI,OAAO,CAGrC;AAED;;GAEG;AACH,wBAAgB,SAAS,IAAI;IAC3B,SAAS,EAAE,OAAO,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAWA;AAED;;GAEG;AACH,wBAAsB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAG9C;AAED;;GAEG;AACH,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,CAAC"}

package/dist/utils/plantuml/service.js

@@ -0,0 +1,96 @@
+/**
+ * PlantUML Service
+ *
+ * Unified service facade for PlantUML operations.
+ * Handles lazy container initialization and provides high-level API.
+ */
+import { ensureContainer, stopContainer, getContainerState } from "./docker-manager.js";
+import { PlantUmlClient, normalizePlantUml, detectDiagramType } from "./client.js";
+import { DEFAULT_PLANTUML_CONFIG } from "./types.js";
+/**
+ * Cached client instance
+ */
+let clientInstance = null;
+/**
+ * Service configuration
+ */
+let serviceConfig = { ...DEFAULT_PLANTUML_CONFIG };
+/**
+ * Configure the PlantUML service
+ */
+export function configure(config) {
+    serviceConfig = { ...DEFAULT_PLANTUML_CONFIG, ...config };
+    // Reset client to pick up new config
+    clientInstance = null;
+}
+/**
+ * Get or create the PlantUML client (starts container if needed)
+ */
+async function getClient() {
+    // Check if we have a valid client
+    if (clientInstance) {
+        const healthy = await clientInstance.healthCheck();
+        if (healthy) {
+            return clientInstance;
+        }
+        // Client unhealthy, reset and recreate
+        clientInstance = null;
+    }
+    // Ensure container is running
+    const state = await ensureContainer(serviceConfig);
+    // Create new client
+    clientInstance = new PlantUmlClient(state.baseUrl, serviceConfig.requestTimeout);
+    return clientInstance;
+}
+/**
+ * Validate PlantUML syntax
+ *
+ * Starts the Docker container on first call if not already running.
+ */
+export async function validate(code) {
+    const client = await getClient();
+    return client.validate(code);
+}
+/**
+ * Render PlantUML diagram to specified format
+ *
+ * Starts the Docker container on first call if not already running.
+ */
+export async function render(code, format) {
+    const client = await getClient();
+    return client.render(code, format);
+}
+/**
+ * Check if PlantUML service is available (container running)
+ */
+export function isAvailable() {
+    const state = getContainerState();
+    return state?.ready ?? false;
+}
+/**
+ * Get current service status
+ */
+export function getStatus() {
+    const state = getContainerState();
+    if (!state?.ready) {
+        return { available: false };
+    }
+    return {
+        available: true,
+        containerId: state.containerId,
+        port: state.port,
+        baseUrl: state.baseUrl,
+    };
+}
+/**
+ * Shutdown the PlantUML service (stop container)
+ */
+export async function shutdown() {
+    clientInstance = null;
+    await stopContainer();
+}
+/**
+ * Re-export utility functions for convenience
+ */
+export { normalizePlantUml, detectDiagramType };
+//# sourceMappingURL=service.js.map

package/dist/utils/plantuml/service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.js","sourceRoot":"","sources":["../../../src/utils/plantuml/service.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxF,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAOnF,OAAO,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAErD;;GAEG;AACH,IAAI,cAAc,GAA0B,IAAI,CAAC;AAEjD;;GAEG;AACH,IAAI,aAAa,GAA6B,EAAE,GAAG,uBAAuB,EAAE,CAAC;AAE7E;;GAEG;AACH,MAAM,UAAU,SAAS,CAAC,MAAsB;IAC9C,aAAa,GAAG,EAAE,GAAG,uBAAuB,EAAE,GAAG,MAAM,EAAE,CAAC;IAC1D,qCAAqC;IACrC,cAAc,GAAG,IAAI,CAAC;AACxB,CAAC;AAED;;GAEG;AACH,KAAK,UAAU,SAAS;IACtB,kCAAkC;IAClC,IAAI,cAAc,EAAE,CAAC;QACnB,MAAM,OAAO,GAAG,MAAM,cAAc,CAAC,WAAW,EAAE,CAAC;QACnD,IAAI,OAAO,EAAE,CAAC;YACZ,OAAO,cAAc,CAAC;QACxB,CAAC;QACD,uCAAuC;QACvC,cAAc,GAAG,IAAI,CAAC;IACxB,CAAC;IAED,8BAA8B;IAC9B,MAAM,KAAK,GAAG,MAAM,eAAe,CAAC,aAAa,CAAC,CAAC;IAEnD,oBAAoB;IACpB,cAAc,GAAG,IAAI,cAAc,CAAC,KAAK,CAAC,OAAO,EAAE,aAAa,CAAC,cAAc,CAAC,CAAC;IAEjF,OAAO,cAAc,CAAC;AACxB,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,IAAY;IACzC,MAAM,MAAM,GAAG,MAAM,SAAS,EAAE,CAAC;IACjC,OAAO,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;AAC/B,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,MAAM,CAC1B,IAAY,EACZ,MAAoB;IAEpB,MAAM,MAAM,GAAG,MAAM,SAAS,EAAE,CAAC;IACjC,OAAO,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;AACrC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW;IACzB,MAAM,KAAK,GAAG,iBAAiB,EAAE,CAAC;IAClC,OAAO,KAAK,EAAE,KAAK,IAAI,KAAK,CAAC;AAC/B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,SAAS;IAMvB,MAAM,KAAK,GAAG,iBAAiB,EAAE,CAAC;IAClC,IAAI,CAAC,KAAK,EAAE,KAAK,EAAE,CAAC;QAClB,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;IAC9B,CAAC;IACD,OAAO;QACL,SAAS,EAAE,IAAI;QACf,WAAW,EAAE,KAAK,CAAC,WAAW;QAC9B,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,OAAO,EAAE,KAAK,CAAC,OAAO;KACvB,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ;IAC5B,cAAc,GAAG,IAAI,CAAC;IACtB,MAAM,aAAa,EAAE,CAAC;AACxB,CAAC;AAED;;GAEG;AACH,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,CAAC"}

package/dist/utils/plantuml/tools.d.ts

@@ -0,0 +1,65 @@
+/**
+ * PlantUML MCP Tools
+ *
+ * Tool definitions for PlantUML validation and rendering.
+ */
+import { z } from "zod";
+import type { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
+import { type RenderFormat } from "./types.js";
+/**
+ * Create PlantUML tools for MCP server
+ */
+export declare function createPlantUmlTools(): {
+    plantuml_validate: {
+        description: string;
+        inputSchema: z.ZodObject<{
+            code: z.ZodOptional<z.ZodString>;
+            bufferId: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            bufferId?: string | undefined;
+            code?: string | undefined;
+        }, {
+            bufferId?: string | undefined;
+            code?: string | undefined;
+        }>;
+        handler: (args: {
+            code?: string;
+            bufferId?: string;
+        }) => Promise<CallToolResult>;
+    };
+    plantuml_render: {
+        description: string;
+        inputSchema: z.ZodObject<{
+            code: z.ZodOptional<z.ZodString>;
+            bufferId: z.ZodOptional<z.ZodString>;
+            format: z.ZodDefault<z.ZodEnum<["ascii", "png", "svg", "eps"]>>;
+            maxWidth: z.ZodOptional<z.ZodNumber>;
+        }, "strip", z.ZodTypeAny, {
+            format: "ascii" | "png" | "svg" | "eps";
+            bufferId?: string | undefined;
+            code?: string | undefined;
+            maxWidth?: number | undefined;
+        }, {
+            bufferId?: string | undefined;
+            code?: string | undefined;
+            format?: "ascii" | "png" | "svg" | "eps" | undefined;
+            maxWidth?: number | undefined;
+        }>;
+        handler: (args: {
+            code?: string;
+            bufferId?: string;
+            format?: RenderFormat;
+            maxWidth?: number;
+        }) => Promise<CallToolResult>;
+    };
+    plantuml_status: {
+        description: string;
+        inputSchema: z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
+        handler: () => Promise<CallToolResult>;
+    };
+};
+/**
+ * Tool names for registry
+ */
+export declare const PLANTUML_TOOLS: readonly ["plantuml_validate", "plantuml_render", "plantuml_status"];
+//# sourceMappingURL=tools.d.ts.map

package/dist/utils/plantuml/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../../src/utils/plantuml/tools.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAIzE,OAAO,EAGL,KAAK,YAAY,EAClB,MAAM,YAAY,CAAC;AA2CpB;;GAEG;AACH,wBAAgB,mBAAmB;;;;;;;;;;;;;wBAkBP;YACpB,IAAI,CAAC,EAAE,MAAM,CAAC;YACd,QAAQ,CAAC,EAAE,MAAM,CAAC;SACnB,KAAG,OAAO,CAAC,cAAc,CAAC;;;;;;;;;;;;;;;;;;;;wBAsHL;YACpB,IAAI,CAAC,EAAE,MAAM,CAAC;YACd,QAAQ,CAAC,EAAE,MAAM,CAAC;YAClB,MAAM,CAAC,EAAE,YAAY,CAAC;YACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;SACnB,KAAG,OAAO,CAAC,cAAc,CAAC;;;;;uBAsFR,OAAO,CAAC,cAAc,CAAC;;EAqB/C;AAED;;GAEG;AACH,eAAO,MAAM,cAAc,sEAIjB,CAAC"}