@formspec/cli 0.1.0-alpha.3

package/dist/generators/method-schema.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Method schema generator.
+ *
+ * Generates schemas for method parameters and return types:
+ * - Parameters using FormSpec (InferSchema<typeof X>) → runtime generation
+ * - Parameters with regular types → static type conversion
+ * - Return types → static type conversion
+ */
+import type * as ts from "typescript";
+import type { MethodInfo } from "../analyzer/class-analyzer.js";
+import { type JsonSchema } from "../analyzer/type-converter.js";
+import type { FormSpecSchemas } from "../runtime/formspec-loader.js";
+/**
+ * Generated schemas for a method.
+ */
+export interface MethodSchemas {
+    /** Method name */
+    name: string;
+    /** Parameter schemas (from FormSpec or static analysis) */
+    params: MethodParamsSchemas | null;
+    /** Return type schema */
+    returnType: JsonSchema;
+}
+/**
+ * Parameter schemas for a method.
+ */
+export interface MethodParamsSchemas {
+    /** JSON Schema for parameters */
+    jsonSchema: JsonSchema;
+    /** UI Schema / FormSpec for parameters (if available) */
+    uxSpec: object | null;
+    /** Name of the FormSpec export used (if any) */
+    formSpecExport: string | null;
+}
+/**
+ * Generates schemas for a method's parameters and return type.
+ *
+ * If a parameter references a FormSpec via `InferSchema<typeof X>`,
+ * the schemas are taken from the loaded FormSpec at runtime.
+ * Otherwise, schemas are generated from static type analysis.
+ *
+ * @param method - The method information from static analysis
+ * @param checker - TypeScript type checker
+ * @param loadedFormSpecs - Map of FormSpec export names to their schemas
+ * @returns Generated method schemas
+ */
+export declare function generateMethodSchemas(method: MethodInfo, checker: ts.TypeChecker, loadedFormSpecs: Map<string, FormSpecSchemas>): MethodSchemas;
+/**
+ * Collects all FormSpec export names referenced by methods.
+ *
+ * Use this to determine which exports to load at runtime.
+ *
+ * @param methods - Array of method infos
+ * @returns Set of FormSpec export names
+ */
+export declare function collectFormSpecReferences(methods: MethodInfo[]): Set<string>;
+//# sourceMappingURL=method-schema.d.ts.map

package/dist/generators/method-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"method-schema.d.ts","sourceRoot":"","sources":["../../src/generators/method-schema.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,KAAK,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,KAAK,EAAE,UAAU,EAAiB,MAAM,+BAA+B,CAAC;AAC/E,OAAO,EAAe,KAAK,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAC7E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAErE;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,kBAAkB;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,2DAA2D;IAC3D,MAAM,EAAE,mBAAmB,GAAG,IAAI,CAAC;IACnC,yBAAyB;IACzB,UAAU,EAAE,UAAU,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,iCAAiC;IACjC,UAAU,EAAE,UAAU,CAAC;IACvB,yDAAyD;IACzD,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,gDAAgD;IAChD,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,UAAU,EAClB,OAAO,EAAE,EAAE,CAAC,WAAW,EACvB,eAAe,EAAE,GAAG,CAAC,MAAM,EAAE,eAAe,CAAC,GAC5C,aAAa,CAYf;AAuED;;;;;;;GAOG;AACH,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,UAAU,EAAE,GACpB,GAAG,CAAC,MAAM,CAAC,CAYb"}

package/dist/generators/method-schema.js

@@ -0,0 +1,108 @@
+/**
+ * Method schema generator.
+ *
+ * Generates schemas for method parameters and return types:
+ * - Parameters using FormSpec (InferSchema<typeof X>) → runtime generation
+ * - Parameters with regular types → static type conversion
+ * - Return types → static type conversion
+ */
+import { convertType } from "../analyzer/type-converter.js";
+/**
+ * Generates schemas for a method's parameters and return type.
+ *
+ * If a parameter references a FormSpec via `InferSchema<typeof X>`,
+ * the schemas are taken from the loaded FormSpec at runtime.
+ * Otherwise, schemas are generated from static type analysis.
+ *
+ * @param method - The method information from static analysis
+ * @param checker - TypeScript type checker
+ * @param loadedFormSpecs - Map of FormSpec export names to their schemas
+ * @returns Generated method schemas
+ */
+export function generateMethodSchemas(method, checker, loadedFormSpecs) {
+    // Generate return type schema from static analysis
+    const returnType = convertType(method.returnType, checker).jsonSchema;
+    // Handle parameters
+    const params = generateParamsSchemas(method.parameters, checker, loadedFormSpecs);
+    return {
+        name: method.name,
+        params,
+        returnType,
+    };
+}
+/**
+ * Generates schemas for method parameters.
+ */
+function generateParamsSchemas(parameters, checker, loadedFormSpecs) {
+    if (parameters.length === 0) {
+        return null;
+    }
+    // Check if any parameter uses InferSchema<typeof X>
+    for (const param of parameters) {
+        if (param.formSpecExportName) {
+            const formSpec = loadedFormSpecs.get(param.formSpecExportName);
+            if (formSpec) {
+                // Use runtime-generated schemas from FormSpec
+                // Cast JSONSchema7 to our JsonSchema type (structurally compatible)
+                return {
+                    jsonSchema: formSpec.jsonSchema,
+                    uxSpec: formSpec.uiSchema,
+                    formSpecExport: param.formSpecExportName,
+                };
+            }
+            // FormSpec not found - fall back to static analysis
+            console.warn(`Warning: FormSpec export "${param.formSpecExportName}" not found, using static analysis`);
+        }
+    }
+    // Generate from static type analysis
+    if (parameters.length === 1 && parameters[0]) {
+        // Single parameter - use its type directly
+        const param = parameters[0];
+        const jsonSchema = convertType(param.type, checker).jsonSchema;
+        return {
+            jsonSchema,
+            uxSpec: null,
+            formSpecExport: null,
+        };
+    }
+    // Multiple parameters - create object schema
+    const properties = {};
+    const required = [];
+    for (const param of parameters) {
+        const paramSchema = convertType(param.type, checker).jsonSchema;
+        properties[param.name] = paramSchema;
+        // Only non-optional parameters should be marked as required
+        if (!param.optional) {
+            required.push(param.name);
+        }
+    }
+    return {
+        jsonSchema: {
+            type: "object",
+            properties,
+            required,
+        },
+        uxSpec: null,
+        formSpecExport: null,
+    };
+}
+/**
+ * Collects all FormSpec export names referenced by methods.
+ *
+ * Use this to determine which exports to load at runtime.
+ *
+ * @param methods - Array of method infos
+ * @returns Set of FormSpec export names
+ */
+export function collectFormSpecReferences(methods) {
+    const references = new Set();
+    for (const method of methods) {
+        for (const param of method.parameters) {
+            if (param.formSpecExportName) {
+                references.add(param.formSpecExportName);
+            }
+        }
+    }
+    return references;
+}
+//# sourceMappingURL=method-schema.js.map

package/dist/generators/method-schema.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,19 @@
+#!/usr/bin/env node
+/**
+ * FormSpec CLI - Generate JSON Schema and FormSpec from TypeScript
+ *
+ * Usage:
+ *   formspec generate <file> [className] [-o <outDir>]
+ *
+ * Examples:
+ *   # Generate schemas from a class with decorators
+ *   formspec generate ./src/forms.ts InstallmentPlan -o ./generated
+ *
+ *   # Generate schemas from all FormSpec exports in a file (chain DSL)
+ *   formspec generate ./src/forms.ts -o ./generated
+ *
+ *   # Generate schemas from both classes and FormSpec exports
+ *   formspec generate ./src/forms.ts MyClass -o ./generated
+ */
+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":";AACA;;;;;;;;;;;;;;;GAeG"}

package/dist/index.js

@@ -0,0 +1,282 @@
+#!/usr/bin/env node
+/**
+ * FormSpec CLI - Generate JSON Schema and FormSpec from TypeScript
+ *
+ * Usage:
+ *   formspec generate <file> [className] [-o <outDir>]
+ *
+ * Examples:
+ *   # Generate schemas from a class with decorators
+ *   formspec generate ./src/forms.ts InstallmentPlan -o ./generated
+ *
+ *   # Generate schemas from all FormSpec exports in a file (chain DSL)
+ *   formspec generate ./src/forms.ts -o ./generated
+ *
+ *   # Generate schemas from both classes and FormSpec exports
+ *   formspec generate ./src/forms.ts MyClass -o ./generated
+ */
+import { createProgramContext, findClassByName } from "./analyzer/program.js";
+import { analyzeClass } from "./analyzer/class-analyzer.js";
+import { generateClassSchemas } from "./generators/class-schema.js";
+import { generateMethodSchemas, collectFormSpecReferences, } from "./generators/method-schema.js";
+import { loadFormSpecs, loadNamedFormSpecs, resolveCompiledPath, } from "./runtime/formspec-loader.js";
+import { writeClassSchemas, writeFormSpecSchemas, } from "./output/writer.js";
+import { runCodegen } from "./codegen/index.js";
+/**
+ * Parses codegen command arguments.
+ */
+function parseCodegenArgs(args) {
+    const files = [];
+    let output = "./__formspec_types__.ts";
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        if (!arg)
+            continue;
+        if (arg === "-o" || arg === "--output") {
+            const nextArg = args[++i];
+            if (nextArg)
+                output = nextArg;
+        }
+        else if (arg.startsWith("-")) {
+            console.error(`Unknown option: ${arg}`);
+            process.exit(1);
+        }
+        else {
+            files.push(arg);
+        }
+    }
+    if (files.length === 0) {
+        console.error("Error: No source files provided");
+        console.error("Usage: formspec codegen <files...> [-o <output>]");
+        process.exit(1);
+    }
+    return { command: "codegen", files, output };
+}
+/**
+ * Parses command line arguments.
+ */
+function parseArgs(args) {
+    const [command, ...rest] = args;
+    if (!command || command === "--help" || command === "-h") {
+        printHelp();
+        process.exit(0);
+    }
+    // Handle codegen command
+    if (command === "codegen") {
+        return parseCodegenArgs(rest);
+    }
+    // Accept both "generate" (primary) and "analyze" (alias for backwards compatibility)
+    if (command !== "generate" && command !== "analyze") {
+        console.error(`Unknown command: ${command}`);
+        console.error('Use "formspec generate" or "formspec codegen"');
+        process.exit(1);
+    }
+    let filePath;
+    let className;
+    let outDir = "./generated";
+    let compiledPath;
+    for (let i = 0; i < rest.length; i++) {
+        const arg = rest[i];
+        if (!arg)
+            continue;
+        if (arg === "-o" || arg === "--output") {
+            const nextArg = rest[++i];
+            if (nextArg)
+                outDir = nextArg;
+        }
+        else if (arg === "--compiled" || arg === "-c") {
+            const nextArg = rest[++i];
+            if (nextArg)
+                compiledPath = nextArg;
+        }
+        else if (arg.startsWith("-")) {
+            console.error(`Unknown option: ${arg}`);
+            process.exit(1);
+        }
+        else if (!filePath) {
+            filePath = arg;
+        }
+        else if (!className) {
+            className = arg;
+        }
+    }
+    if (!filePath) {
+        console.error("Error: No file path provided");
+        console.error('Usage: formspec generate <file> [className] [-o <outDir>]');
+        process.exit(1);
+    }
+    return {
+        command,
+        filePath,
+        className,
+        outDir,
+        compiledPath,
+    };
+}
+/**
+ * Prints help message.
+ */
+function printHelp() {
+    console.log(`
+FormSpec CLI - Generate JSON Schema and FormSpec from TypeScript
+
+COMMANDS:
+  generate    Generate JSON Schema and UI Schema files from TypeScript
+  codegen     Generate type metadata file for runtime schema generation
+
+USAGE:
+  formspec generate <file> [className] [options]
+  formspec codegen <files...> [-o <output>]
+
+GENERATE COMMAND:
+  Arguments:
+    <file>        Path to TypeScript source file
+    [className]   Optional class name (if omitted, generates from FormSpec exports only)
+
+  Options:
+    -o, --output <dir>    Output directory (default: ./generated)
+    -c, --compiled <path> Path to compiled JS file (auto-detected if omitted)
+
+  Examples:
+    formspec generate ./src/forms.ts InstallmentPlan -o ./generated
+    formspec generate ./src/forms.ts -o ./generated
+
+CODEGEN COMMAND:
+  Generate a TypeScript file that patches decorated classes with type metadata.
+  This enables runtime schema generation with toFormSpec() from @formspec/decorators.
+
+  Arguments:
+    <files...>    TypeScript source files to analyze
+
+  Options:
+    -o, --output <file>   Output file (default: ./__formspec_types__.ts)
+
+  Examples:
+    formspec codegen ./src/forms.ts -o ./src/__formspec_types__.ts
+    formspec codegen ./src/**/*.ts -o ./src/__formspec_types__.ts
+
+  Usage in code:
+    // Import once at application entry point
+    import './__formspec_types__';
+
+    // Then use toFormSpec() normally
+    import { UserForm } from './forms';
+    import { toFormSpec } from '@formspec/decorators';
+    const spec = toFormSpec(UserForm);
+
+ALIASES:
+  formspec analyze      Same as 'generate' (for backwards compatibility)
+`);
+}
+/**
+ * Main CLI entry point.
+ */
+async function main() {
+    const args = process.argv.slice(2);
+    const options = parseArgs(args);
+    // Handle codegen command
+    if (options.command === "codegen") {
+        const codegenOptions = options;
+        runCodegen({
+            files: codegenOptions.files,
+            output: codegenOptions.output,
+        });
+        return;
+    }
+    // Handle generate command
+    const generateOptions = options;
+    console.log(`Generating schemas from: ${generateOptions.filePath}`);
+    if (generateOptions.className) {
+        console.log(`Class: ${generateOptions.className}`);
+    }
+    console.log(`Output: ${generateOptions.outDir}`);
+    console.log();
+    try {
+        // Step 1: Static analysis with TypeScript
+        const ctx = createProgramContext(generateOptions.filePath);
+        console.log("✓ Created TypeScript program");
+        // Step 2: Resolve compiled JS path for runtime loading
+        const compiledPath = generateOptions.compiledPath ?? resolveCompiledPath(generateOptions.filePath);
+        // Step 3: Load all FormSpec exports from compiled module
+        let loadedFormSpecs = new Map();
+        try {
+            const { formSpecs } = await loadFormSpecs(compiledPath);
+            loadedFormSpecs = formSpecs;
+            console.log(`✓ Loaded ${formSpecs.size} FormSpec export(s) from module`);
+        }
+        catch {
+            // This is not an error - runtime loading is only needed for:
+            // 1. Chain DSL FormSpec exports (formspec(...))
+            // 2. Method parameters using InferSchema<typeof X>
+            // Static class analysis works without compiled output
+        }
+        // Step 4: If className specified, analyze the class
+        if (!generateOptions.className && loadedFormSpecs.size === 0) {
+            // No class name and no FormSpec exports - warn the user
+            console.warn("⚠️  No class name specified and no FormSpec exports found.");
+            console.warn("   For decorated classes, specify the class name:");
+            console.warn(`     formspec generate ${generateOptions.filePath} <ClassName> -o ${generateOptions.outDir}`);
+            console.warn("   For chain DSL, export a FormSpec from your file:");
+            console.warn("     export const MyForm = formspec(...);");
+            console.warn();
+            process.exit(1);
+        }
+        if (generateOptions.className) {
+            const classDecl = findClassByName(ctx.sourceFile, generateOptions.className);
+            if (!classDecl) {
+                console.error(`Error: Class "${generateOptions.className}" not found in ${generateOptions.filePath}`);
+                process.exit(1);
+            }
+            // Analyze class
+            const analysis = analyzeClass(classDecl, ctx.checker);
+            console.log(`✓ Analyzed class "${analysis.name}" with ${analysis.fields.length} field(s)`);
+            console.log(`  Instance methods: ${analysis.instanceMethods.length}`);
+            console.log(`  Static methods: ${analysis.staticMethods.length}`);
+            // Collect FormSpec references from methods
+            const allMethods = [...analysis.instanceMethods, ...analysis.staticMethods];
+            const formSpecRefs = collectFormSpecReferences(allMethods);
+            if (formSpecRefs.size > 0) {
+                console.log(`  FormSpec refs: ${Array.from(formSpecRefs).join(", ")}`);
+                // Load specific FormSpecs if not already loaded
+                const missing = Array.from(formSpecRefs).filter((name) => !loadedFormSpecs.has(name));
+                if (missing.length > 0) {
+                    try {
+                        const namedFormSpecs = await loadNamedFormSpecs(compiledPath, missing);
+                        for (const [name, schemas] of namedFormSpecs) {
+                            loadedFormSpecs.set(name, schemas);
+                        }
+                    }
+                    catch {
+                        // Already warned about module loading
+                    }
+                }
+            }
+            // Generate class schemas
+            const classSchemas = generateClassSchemas(analysis, ctx.checker);
+            // Generate method schemas
+            const instanceMethodSchemas = analysis.instanceMethods.map((m) => generateMethodSchemas(m, ctx.checker, loadedFormSpecs));
+            const staticMethodSchemas = analysis.staticMethods.map((m) => generateMethodSchemas(m, ctx.checker, loadedFormSpecs));
+            // Write class output
+            const classResult = writeClassSchemas(analysis.name, classSchemas, instanceMethodSchemas, staticMethodSchemas, { outDir: generateOptions.outDir });
+            console.log(`✓ Wrote ${classResult.files.length} file(s) to ${classResult.dir}`);
+        }
+        // Step 5: Write standalone FormSpec exports (chain DSL)
+        if (loadedFormSpecs.size > 0) {
+            const formSpecResult = writeFormSpecSchemas(loadedFormSpecs, {
+                outDir: generateOptions.outDir,
+            });
+            if (formSpecResult.files.length > 0) {
+                console.log(`✓ Wrote ${formSpecResult.files.length} FormSpec file(s) to ${formSpecResult.dir}`);
+            }
+        }
+        console.log();
+        console.log("Done!");
+    }
+    catch (error) {
+        console.error("Error:", error instanceof Error ? error.message : error);
+        process.exit(1);
+    }
+}
+// Run CLI
+void main();
+//# 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/output/writer.d.ts

@@ -0,0 +1,82 @@
+/**
+ * Output writer for creating the schema folder structure.
+ *
+ * Creates directories and writes JSON files for:
+ * - Class schema and UI Schema
+ * - Instance method schemas
+ * - Static method schemas
+ * - Standalone FormSpec exports (chain DSL)
+ */
+import type { ClassSchemas } from "../generators/class-schema.js";
+import type { MethodSchemas } from "../generators/method-schema.js";
+import type { FormSpecSchemas } from "../runtime/formspec-loader.js";
+/**
+ * Options for writing output files.
+ */
+export interface WriteOptions {
+    /** Output directory path */
+    outDir: string;
+    /** JSON indentation (default: 2) */
+    indent?: number;
+}
+/**
+ * Result of writing a class's schemas.
+ */
+export interface ClassWriteResult {
+    /** Path to the class output directory */
+    dir: string;
+    /** Files that were written */
+    files: string[];
+}
+/**
+ * Result of writing standalone FormSpec schemas.
+ */
+export interface FormSpecWriteResult {
+    /** Path to the output directory */
+    dir: string;
+    /** Files that were written */
+    files: string[];
+}
+/**
+ * Writes all schemas for a class to the output directory.
+ *
+ * Creates the following structure:
+ * ```
+ * {outDir}/{className}/
+ * ├── schema.json
+ * ├── ux_spec.json
+ * ├── instance_methods/
+ * │   └── {methodName}/
+ * │       ├── params.schema.json
+ * │       ├── params.ux_spec.json (if FormSpec-based)
+ * │       └── return_type.schema.json
+ * └── static_methods/
+ *     └── {methodName}/
+ *         └── ...
+ * ```
+ *
+ * @param className - Name of the class
+ * @param classSchemas - Generated class schemas
+ * @param instanceMethods - Instance method schemas
+ * @param staticMethods - Static method schemas
+ * @param options - Write options
+ * @returns Write result with paths
+ */
+export declare function writeClassSchemas(className: string, classSchemas: ClassSchemas, instanceMethods: MethodSchemas[], staticMethods: MethodSchemas[], options: WriteOptions): ClassWriteResult;
+/**
+ * Writes standalone FormSpec schemas (chain DSL exports).
+ *
+ * Creates the following structure:
+ * ```
+ * {outDir}/formspecs/
+ * └── {exportName}/
+ *     ├── schema.json
+ *     └── ux_spec.json
+ * ```
+ *
+ * @param formSpecs - Map of FormSpec export names to their schemas
+ * @param options - Write options
+ * @returns Write result with paths
+ */
+export declare function writeFormSpecSchemas(formSpecs: Map<string, FormSpecSchemas>, options: WriteOptions): FormSpecWriteResult;
+//# sourceMappingURL=writer.d.ts.map

package/dist/output/writer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"writer.d.ts","sourceRoot":"","sources":["../../src/output/writer.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AACpE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAErE;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,4BAA4B;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,oCAAoC;IACpC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,yCAAyC;IACzC,GAAG,EAAE,MAAM,CAAC;IACZ,8BAA8B;IAC9B,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,mCAAmC;IACnC,GAAG,EAAE,MAAM,CAAC;IACZ,8BAA8B;IAC9B,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,YAAY,EAC1B,eAAe,EAAE,aAAa,EAAE,EAChC,aAAa,EAAE,aAAa,EAAE,EAC9B,OAAO,EAAE,YAAY,GACpB,gBAAgB,CAyClB;AAyCD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,eAAe,CAAC,EACvC,OAAO,EAAE,YAAY,GACpB,mBAAmB,CA2BrB"}