@g1cloud/api-gen 1.0.0

package/dist/generator/openapiGenerator.js

@@ -0,0 +1,340 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateOpenAPISpec = generateOpenAPISpec;
+exports.generateOpenAPISpecForController = generateOpenAPISpecForController;
+exports.writeOpenAPISpec = writeOpenAPISpec;
+const fs = __importStar(require("fs"));
+const yaml = __importStar(require("js-yaml"));
+const schemaGenerator_1 = require("../analyzer/schemaGenerator");
+/**
+ * Generate OpenAPI YAML from analyzed controllers
+ */
+function generateOpenAPISpec(controllers, context, options) {
+    // Generate schemas for all referenced types
+    const schemas = (0, schemaGenerator_1.generateSchemas)(context);
+    // Build tags from controllers
+    const tags = controllers.map(controller => ({
+        name: controller.className,
+        description: controller.javaClass.javadoc || `Endpoints for ${controller.className}`,
+    }));
+    // Build paths
+    const paths = {};
+    for (const controller of controllers) {
+        for (const endpoint of controller.endpoints) {
+            const path = endpoint.path;
+            if (!paths[path]) {
+                paths[path] = {};
+            }
+            paths[path][endpoint.method] = buildOperation(endpoint, controller.className);
+        }
+    }
+    // Convert schema Map to object
+    const schemaObject = {};
+    for (const [name, schema] of schemas) {
+        schemaObject[name] = schema;
+    }
+    // Build the spec
+    const spec = {
+        openapi: '3.0.0',
+        info: {
+            title: options.title,
+            version: options.version,
+        },
+        tags,
+        paths,
+        components: {
+            schemas: schemaObject,
+            securitySchemes: {
+                bearerAuth: {
+                    type: 'http',
+                    scheme: 'bearer',
+                    bearerFormat: 'JWT',
+                },
+            },
+        },
+    };
+    // Add servers if base path is specified
+    if (options.basePath) {
+        spec.servers = [{ url: `http://localhost:8080${options.basePath}` }];
+    }
+    return spec;
+}
+/**
+ * Build operation object for an endpoint
+ */
+function buildOperation(endpoint, controllerName) {
+    const operation = {
+        summary: endpoint.summary,
+        operationId: endpoint.operationId,
+        responses: {},
+    };
+    // Add tag for controller grouping
+    if (controllerName) {
+        operation.tags = [controllerName];
+    }
+    // Build description with javadoc, @return, and security info
+    const descriptionParts = [];
+    if (endpoint.description) {
+        descriptionParts.push(endpoint.description);
+    }
+    // Add @return description from javadoc
+    if (endpoint.returnDescription) {
+        descriptionParts.push(`\n\n**Returns:** ${endpoint.returnDescription}`);
+    }
+    // Add security info to description
+    if (endpoint.security.roles.length > 0) {
+        descriptionParts.push(`\n\n**Required Roles:** ${endpoint.security.roles.join(', ')}`);
+    }
+    if (endpoint.security.securityExpression) {
+        descriptionParts.push(`\n\n**Security Expression:** \`${endpoint.security.securityExpression}\``);
+    }
+    if (descriptionParts.length > 0) {
+        operation.description = descriptionParts.join('');
+    }
+    // Add parameters
+    if (endpoint.parameters.length > 0) {
+        operation.parameters = endpoint.parameters.map(buildParameter);
+    }
+    // Add request body
+    if (endpoint.requestBody) {
+        operation.requestBody = buildRequestBody(endpoint.requestBody);
+    }
+    // Add responses
+    for (const response of endpoint.responses) {
+        operation.responses[response.statusCode] = buildResponse(response);
+    }
+    // Add security
+    if (endpoint.security.roles.length > 0 || endpoint.security.authorities.length > 0) {
+        operation.security = [{ bearerAuth: [] }];
+    }
+    // Add x-required-roles
+    if (endpoint.security.roles.length > 0) {
+        operation['x-required-roles'] = endpoint.security.roles;
+    }
+    // Add x-security-expression for complex expressions
+    if (endpoint.security.hasComplexExpression && endpoint.security.securityExpression) {
+        operation['x-security-expression'] = endpoint.security.securityExpression;
+    }
+    return operation;
+}
+/**
+ * Build parameter object
+ */
+function buildParameter(param) {
+    const parameter = {
+        name: param.name,
+        in: param.in,
+        schema: param.schema || { type: param.type },
+    };
+    if (param.required) {
+        parameter.required = true;
+    }
+    if (param.description) {
+        parameter.description = param.description;
+    }
+    return parameter;
+}
+/**
+ * Build request body object
+ */
+function buildRequestBody(requestBody) {
+    const body = {
+        required: requestBody.required,
+        content: {
+            [requestBody.contentType]: {
+                schema: requestBody.schema,
+            },
+        },
+    };
+    // Add description from @param javadoc if available
+    if (requestBody.description) {
+        body.description = requestBody.description;
+    }
+    return body;
+}
+/**
+ * Build response object
+ */
+function buildResponse(response) {
+    const responseObj = {
+        description: response.description,
+    };
+    // Add headers
+    if (response.headers) {
+        responseObj.headers = {};
+        for (const [name, header] of Object.entries(response.headers)) {
+            responseObj.headers[name] = {
+                schema: header.schema,
+                description: header.description,
+            };
+        }
+    }
+    // Add content
+    if (response.contentType && response.schema) {
+        responseObj.content = {
+            [response.contentType]: {
+                schema: response.schema,
+            },
+        };
+    }
+    return responseObj;
+}
+/**
+ * Recursively extract all $ref types from a schema
+ */
+function extractRefsFromSchema(schema, refs) {
+    if (!schema || typeof schema !== 'object') {
+        return;
+    }
+    // Direct $ref
+    if (schema.$ref && typeof schema.$ref === 'string') {
+        const typeName = schema.$ref.replace('#/components/schemas/', '');
+        refs.add(typeName);
+    }
+    // Array items
+    if (schema.items) {
+        extractRefsFromSchema(schema.items, refs);
+    }
+    // Object properties
+    if (schema.properties) {
+        for (const prop of Object.values(schema.properties)) {
+            extractRefsFromSchema(prop, refs);
+        }
+    }
+    // additionalProperties
+    if (schema.additionalProperties && typeof schema.additionalProperties === 'object') {
+        extractRefsFromSchema(schema.additionalProperties, refs);
+    }
+    // allOf, anyOf, oneOf
+    for (const key of ['allOf', 'anyOf', 'oneOf']) {
+        if (Array.isArray(schema[key])) {
+            for (const subSchema of schema[key]) {
+                extractRefsFromSchema(subSchema, refs);
+            }
+        }
+    }
+}
+/**
+ * Generate OpenAPI spec for a single controller
+ */
+function generateOpenAPISpecForController(controller, context, options) {
+    // Create a temporary context with only this controller to generate relevant schemas
+    const singleControllerContext = {
+        javaClasses: context.javaClasses,
+        controllers: [controller],
+        dtoSchemas: new Map(),
+        referencedTypes: new Set(),
+    };
+    // Collect referenced types from this controller's endpoints
+    for (const endpoint of controller.endpoints) {
+        // Extract refs from request body schema (including nested refs like array items)
+        if (endpoint.requestBody?.schema) {
+            extractRefsFromSchema(endpoint.requestBody.schema, singleControllerContext.referencedTypes);
+        }
+        // Extract refs from response schemas
+        for (const response of endpoint.responses) {
+            if (response.schema) {
+                extractRefsFromSchema(response.schema, singleControllerContext.referencedTypes);
+            }
+        }
+        // Extract refs from parameter schemas
+        for (const param of endpoint.parameters) {
+            if (param.schema) {
+                extractRefsFromSchema(param.schema, singleControllerContext.referencedTypes);
+            }
+        }
+    }
+    // Generate schemas for referenced types
+    const schemas = (0, schemaGenerator_1.generateSchemas)(singleControllerContext);
+    // Build paths for this controller only
+    const paths = {};
+    for (const endpoint of controller.endpoints) {
+        const path = endpoint.path;
+        if (!paths[path]) {
+            paths[path] = {};
+        }
+        paths[path][endpoint.method] = buildOperation(endpoint, controller.className);
+    }
+    // Build tag for this controller
+    const tags = [{
+            name: controller.className,
+            description: controller.javaClass.javadoc || `Endpoints for ${controller.className}`,
+        }];
+    // Convert schema Map to object
+    const schemaObject = {};
+    for (const [name, schema] of schemas) {
+        schemaObject[name] = schema;
+    }
+    // Build the spec with controller name as title
+    const spec = {
+        openapi: '3.0.0',
+        info: {
+            title: controller.className,
+            version: options.version,
+        },
+        tags,
+        paths,
+        components: {
+            schemas: schemaObject,
+            securitySchemes: {
+                bearerAuth: {
+                    type: 'http',
+                    scheme: 'bearer',
+                    bearerFormat: 'JWT',
+                },
+            },
+        },
+    };
+    // Add servers if base path is specified
+    if (options.basePath) {
+        spec.servers = [{ url: `http://localhost:8080${options.basePath}` }];
+    }
+    return spec;
+}
+/**
+ * Write OpenAPI spec to YAML file
+ */
+function writeOpenAPISpec(spec, outputPath) {
+    const yamlContent = yaml.dump(spec, {
+        indent: 2,
+        lineWidth: -1,
+        noRefs: true,
+        sortKeys: false,
+    });
+    fs.writeFileSync(outputPath, yamlContent, 'utf-8');
+    console.log(`  Written: ${outputPath}`);
+}
+//# sourceMappingURL=openapiGenerator.js.map

package/dist/generator/openapiGenerator.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,218 @@
+#!/usr/bin/env node
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+const commander_1 = require("commander");
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const javaParser_1 = require("./parser/javaParser");
+const controllerAnalyzer_1 = require("./analyzer/controllerAnalyzer");
+const openapiGenerator_1 = require("./generator/openapiGenerator");
+const program = new commander_1.Command();
+// Helper to collect multiple values for an option
+function collect(value, previous) {
+    return previous.concat([value]);
+}
+program
+    .name('spring-to-openapi')
+    .description('Generate OpenAPI v3 YAML from Spring Boot Java source code')
+    .version('1.0.0')
+    .requiredOption('-s, --source <path...>', 'Java source code directory path(s) (can be specified multiple times)', collect, [])
+    .option('-a, --api-source <path>', 'Directory to search for RestControllers (defaults to first --source)')
+    .option('-o, --output <path>', 'Output YAML file path (generates single combined file)')
+    .option('-d, --out-dir <path>', 'Output directory path (generates separate YAML per controller)')
+    .option('-t, --title <title>', 'API title', 'API Documentation')
+    .option('--api-version <version>', 'API version', '1.0.0')
+    .option('-b, --base-path <path>', 'API base path')
+    .action(async (options) => {
+    try {
+        await run(options);
+    }
+    catch (error) {
+        console.error('Error:', error instanceof Error ? error.message : error);
+        process.exit(1);
+    }
+});
+async function run(options) {
+    const startTime = Date.now();
+    // Validate output options
+    if (!options.output && !options.outDir) {
+        options.output = 'openapi.yaml'; // default to single file
+    }
+    if (options.output && options.outDir) {
+        console.error('Error: Cannot use both --output and --out-dir. Choose one output mode.');
+        process.exit(1);
+    }
+    // Normalize source to array
+    const sources = Array.isArray(options.source) ? options.source : [options.source];
+    if (sources.length === 0) {
+        console.error('Error: At least one --source path is required.');
+        process.exit(1);
+    }
+    // Normalize options
+    const cliOptions = {
+        source: sources,
+        apiSource: options.apiSource, // Optional: specific directory for RestController search
+        output: options.output,
+        outDir: options.outDir,
+        title: options.title,
+        version: options.apiVersion,
+        basePath: options.basePath,
+    };
+    const isDirectoryMode = !!cliOptions.outDir;
+    console.log('='.repeat(60));
+    console.log('Spring Boot to OpenAPI Generator');
+    console.log('='.repeat(60));
+    if (cliOptions.source.length === 1) {
+        console.log(`\nSource directory: ${cliOptions.source[0]}`);
+    }
+    else {
+        console.log(`\nSource directories:`);
+        for (const src of cliOptions.source) {
+            console.log(`  - ${src}`);
+        }
+    }
+    if (cliOptions.apiSource) {
+        console.log(`API source directory: ${cliOptions.apiSource} (RestController search)`);
+    }
+    if (isDirectoryMode) {
+        console.log(`Output directory: ${cliOptions.outDir} (per-controller mode)`);
+    }
+    else {
+        console.log(`Output file: ${cliOptions.output}`);
+    }
+    console.log(`API title: ${cliOptions.title}`);
+    console.log(`API version: ${cliOptions.version}`);
+    if (cliOptions.basePath) {
+        console.log(`Base path: ${cliOptions.basePath}`);
+    }
+    console.log();
+    // Resolve paths
+    const sourcePaths = cliOptions.source.map(s => path.resolve(s));
+    const apiSourcePath = cliOptions.apiSource ? path.resolve(cliOptions.apiSource) : undefined;
+    // Step 1: Parse Java files from all source directories
+    console.log('Step 1: Parsing Java source files...');
+    const javaClasses = new Map();
+    for (const sourcePath of sourcePaths) {
+        const classes = await (0, javaParser_1.parseJavaSource)(sourcePath);
+        console.log(`  Found ${classes.size} class(es) in ${sourcePath}`);
+        // Merge classes (later sources override earlier ones for same class name)
+        for (const [name, cls] of classes) {
+            javaClasses.set(name, cls);
+        }
+    }
+    console.log(`  Total: ${javaClasses.size} Java class(es)`);
+    if (javaClasses.size === 0) {
+        console.warn('Warning: No Java files found in the specified directory.');
+        return;
+    }
+    // Step 2: Initialize processing context
+    const context = {
+        javaClasses,
+        controllers: [],
+        dtoSchemas: new Map(),
+        referencedTypes: new Set(),
+        apiSourcePath, // Pass apiSourcePath to filter RestControllers
+    };
+    // Step 3: Analyze controllers
+    console.log('\nStep 2: Analyzing REST controllers...');
+    const controllers = (0, controllerAnalyzer_1.analyzeControllers)(context);
+    context.controllers = controllers;
+    const totalEndpoints = controllers.reduce((sum, c) => sum + c.endpoints.length, 0);
+    console.log(`\n  Found ${controllers.length} controller(s) with ${totalEndpoints} endpoint(s)`);
+    if (controllers.length === 0) {
+        console.warn('Warning: No REST controllers found in the source files.');
+        return;
+    }
+    // Step 4: Generate and write OpenAPI spec(s)
+    console.log('\nStep 3: Generating OpenAPI specification...');
+    if (isDirectoryMode) {
+        // Directory mode: generate separate YAML file per controller
+        const outDirPath = path.resolve(cliOptions.outDir);
+        // Create output directory if it doesn't exist
+        if (!fs.existsSync(outDirPath)) {
+            fs.mkdirSync(outDirPath, { recursive: true });
+        }
+        console.log('\nStep 4: Writing YAML files (per controller)...');
+        let totalSchemas = 0;
+        for (const controller of controllers) {
+            const spec = (0, openapiGenerator_1.generateOpenAPISpecForController)(controller, context, cliOptions);
+            const fileName = `${controller.className}.yaml`;
+            const outputPath = path.join(outDirPath, fileName);
+            (0, openapiGenerator_1.writeOpenAPISpec)(spec, outputPath);
+            totalSchemas += Object.keys(spec.components.schemas).length;
+        }
+        const endTime = Date.now();
+        console.log(`\nCompleted in ${endTime - startTime}ms`);
+        console.log('='.repeat(60));
+        // Print summary
+        console.log('\nSummary:');
+        console.log(`  Controllers: ${controllers.length}`);
+        console.log(`  Endpoints: ${totalEndpoints}`);
+        console.log(`  Files generated: ${controllers.length}`);
+        // Print generated files
+        console.log('\nGenerated files:');
+        for (const controller of controllers) {
+            const endpointCount = controller.endpoints.length;
+            console.log(`  ${controller.className}.yaml (${endpointCount} endpoint${endpointCount !== 1 ? 's' : ''})`);
+        }
+    }
+    else {
+        // Single file mode: generate combined YAML
+        const spec = (0, openapiGenerator_1.generateOpenAPISpec)(controllers, context, cliOptions);
+        const outputPath = path.resolve(cliOptions.output);
+        console.log('\nStep 4: Writing YAML output...');
+        (0, openapiGenerator_1.writeOpenAPISpec)(spec, outputPath);
+        const endTime = Date.now();
+        console.log(`\nCompleted in ${endTime - startTime}ms`);
+        console.log('='.repeat(60));
+        // Print summary
+        console.log('\nSummary:');
+        console.log(`  Controllers: ${controllers.length}`);
+        console.log(`  Endpoints: ${totalEndpoints}`);
+        console.log(`  Schemas: ${Object.keys(spec.components.schemas).length}`);
+        // Print endpoints by path
+        console.log('\nEndpoints:');
+        const paths = Object.keys(spec.paths).sort();
+        for (const p of paths) {
+            const methods = Object.keys(spec.paths[p]).sort();
+            for (const method of methods) {
+                console.log(`  ${method.toUpperCase().padEnd(7)} ${p}`);
+            }
+        }
+    }
+}
+program.parse();
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/lib.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Library entry point for programmatic API generation
+ * This module exports the core functionality for use by MCP server and other integrations
+ */
+import { OpenAPISpec } from './types';
+export interface GenerateOptions {
+    /** Java source directories to parse */
+    source: string[];
+    /** Optional: specific directory to search for RestControllers */
+    apiSource?: string;
+    /** API title */
+    title?: string;
+    /** API version */
+    version?: string;
+    /** API base path */
+    basePath?: string;
+}
+export interface GenerateResult {
+    /** Generated OpenAPI spec object */
+    spec: OpenAPISpec;
+    /** YAML string of the spec */
+    yaml: string;
+    /** Summary information */
+    summary: {
+        controllerCount: number;
+        endpointCount: number;
+        schemaCount: number;
+        controllers: Array<{
+            name: string;
+            endpointCount: number;
+        }>;
+    };
+}
+export interface GeneratePerControllerResult {
+    /** Map of controller name to generated spec */
+    specs: Map<string, {
+        spec: OpenAPISpec;
+        yaml: string;
+    }>;
+    /** Summary information */
+    summary: {
+        controllerCount: number;
+        totalEndpointCount: number;
+        controllers: Array<{
+            name: string;
+            endpointCount: number;
+            schemaCount: number;
+        }>;
+    };
+}
+/**
+ * Generate OpenAPI specification from Spring Boot Java source code
+ * Returns a single combined spec for all controllers
+ */
+export declare function generateOpenAPI(options: GenerateOptions): Promise<GenerateResult>;
+/**
+ * Generate separate OpenAPI specifications per controller
+ */
+export declare function generateOpenAPIPerController(options: GenerateOptions): Promise<GeneratePerControllerResult>;
+export type { CLIOptions, ProcessingContext, OpenAPISpec, ControllerInfo } from './types';
+//# sourceMappingURL=lib.d.ts.map

package/dist/lib.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lib.d.ts","sourceRoot":"","sources":["../src/lib.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,OAAO,EAAiC,WAAW,EAAkB,MAAM,SAAS,CAAC;AAKrF,MAAM,WAAW,eAAe;IAC9B,uCAAuC;IACvC,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,iEAAiE;IACjE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gBAAgB;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,kBAAkB;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,oBAAoB;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,cAAc;IAC7B,oCAAoC;IACpC,IAAI,EAAE,WAAW,CAAC;IAClB,8BAA8B;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,0BAA0B;IAC1B,OAAO,EAAE;QACP,eAAe,EAAE,MAAM,CAAC;QACxB,aAAa,EAAE,MAAM,CAAC;QACtB,WAAW,EAAE,MAAM,CAAC;QACpB,WAAW,EAAE,KAAK,CAAC;YACjB,IAAI,EAAE,MAAM,CAAC;YACb,aAAa,EAAE,MAAM,CAAC;SACvB,CAAC,CAAC;KACJ,CAAC;CACH;AAED,MAAM,WAAW,2BAA2B;IAC1C,+CAA+C;IAC/C,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE;QAAE,IAAI,EAAE,WAAW,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACxD,0BAA0B;IAC1B,OAAO,EAAE;QACP,eAAe,EAAE,MAAM,CAAC;QACxB,kBAAkB,EAAE,MAAM,CAAC;QAC3B,WAAW,EAAE,KAAK,CAAC;YACjB,IAAI,EAAE,MAAM,CAAC;YACb,aAAa,EAAE,MAAM,CAAC;YACtB,WAAW,EAAE,MAAM,CAAC;SACrB,CAAC,CAAC;KACJ,CAAC;CACH;AAED;;;GAGG;AACH,wBAAsB,eAAe,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC,CAkFvF;AAED;;GAEG;AACH,wBAAsB,4BAA4B,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,2BAA2B,CAAC,CAuFjH;AAGD,YAAY,EAAE,UAAU,EAAE,iBAAiB,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC"}