functional-examples 0.0.0-alpha.1

package/dist/schema/index.d.ts

@@ -0,0 +1,4 @@
+export { mergeConfigSchema, mergeMetadataSchemas, type JSONSchema, type MergeConfigSchemaOptions, type MergeMetadataSchemasOptions, } from './merger.js';
+export { generateMetadataTypes, type GenerateMetadataTypesOptions, } from './typegen.js';
+export { createSchemaValidator } from './validator.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/schema/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/schema/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iBAAiB,EACjB,oBAAoB,EACpB,KAAK,UAAU,EACf,KAAK,wBAAwB,EAC7B,KAAK,2BAA2B,GACjC,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,qBAAqB,EACrB,KAAK,4BAA4B,GAClC,MAAM,cAAc,CAAC;AAEtB,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/schema/index.js

@@ -0,0 +1,4 @@
+export { mergeConfigSchema, mergeMetadataSchemas, } from './merger.js';
+export { generateMetadataTypes, } from './typegen.js';
+export { createSchemaValidator } from './validator.js';
+//# sourceMappingURL=index.js.map

package/dist/schema/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/schema/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iBAAiB,EACjB,oBAAoB,GAIrB,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,qBAAqB,GAEtB,MAAM,cAAc,CAAC;AAEtB,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/schema/merger.d.ts

@@ -0,0 +1,35 @@
+import type { PluginSchemaEntry } from '../plugins/registry.js';
+/**
+ * JSON Schema type (subset of JSON Schema spec).
+ */
+export interface JSONSchema {
+    $schema?: string;
+    $defs?: Record<string, JSONSchema>;
+    type?: string;
+    properties?: Record<string, JSONSchema>;
+    required?: string[];
+    items?: JSONSchema;
+    anyOf?: JSONSchema[];
+    $ref?: string;
+    description?: string;
+    [key: string]: unknown;
+}
+export interface MergeConfigSchemaOptions {
+    pluginSchemas: PluginSchemaEntry[];
+}
+export interface MergeMetadataSchemasOptions {
+    /** User-defined metadata schema from config (takes priority) */
+    configSchema?: JSONSchema;
+    /** Plugin metadata schemas */
+    pluginSchemas: PluginSchemaEntry[];
+}
+/**
+ * Merge plugin schemas into a complete config schema.
+ */
+export declare function mergeConfigSchema(options: MergeConfigSchemaOptions): JSONSchema;
+/**
+ * Merge metadata schemas from config and plugins.
+ * Config schema takes priority on conflicts.
+ */
+export declare function mergeMetadataSchemas(options: MergeMetadataSchemasOptions): JSONSchema;
+//# sourceMappingURL=merger.d.ts.map

package/dist/schema/merger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"merger.d.ts","sourceRoot":"","sources":["../../src/schema/merger.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAEhE;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACnC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACxC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB,KAAK,CAAC,EAAE,UAAU,EAAE,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,wBAAwB;IACvC,aAAa,EAAE,iBAAiB,EAAE,CAAC;CACpC;AAED,MAAM,WAAW,2BAA2B;IAC1C,gEAAgE;IAChE,YAAY,CAAC,EAAE,UAAU,CAAC;IAC1B,8BAA8B;IAC9B,aAAa,EAAE,iBAAiB,EAAE,CAAC;CACpC;AA6DD;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,wBAAwB,GAAG,UAAU,CA4C/E;AAoCD;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,2BAA2B,GACnC,UAAU,CA2BZ"}

package/dist/schema/merger.js

@@ -0,0 +1,161 @@
+/**
+ * Base config schema structure.
+ */
+function createBaseConfigSchema() {
+    return {
+        $schema: 'https://json-schema.org/draft/2020-12/schema',
+        type: 'object',
+        properties: {
+            plugins: {
+                type: 'array',
+                description: 'Plugins to use for scanning and parsing',
+                items: { type: 'object' }, // Will be replaced with anyOf
+            },
+            metadata: {
+                type: 'object',
+                description: 'JSON Schema defining the expected metadata structure for examples',
+            },
+            scan: {
+                type: 'object',
+                properties: {
+                    include: {
+                        type: 'array',
+                        items: { type: 'string' },
+                        description: 'Glob patterns to include',
+                    },
+                    exclude: {
+                        type: 'array',
+                        items: { type: 'string' },
+                        description: 'Glob patterns to exclude',
+                    },
+                },
+            },
+            pathMappings: {
+                type: 'array',
+                description: 'Path mappings for conflict resolution',
+                items: {
+                    type: 'object',
+                    properties: {
+                        pattern: { type: 'string' },
+                        extractor: { type: 'string' },
+                    },
+                    required: ['pattern', 'extractor'],
+                },
+            },
+            generate: {
+                type: 'object',
+                properties: {
+                    outputDir: {
+                        type: 'string',
+                        description: 'Output directory for generated files',
+                    },
+                },
+            },
+        },
+        $defs: {},
+    };
+}
+/**
+ * Merge plugin schemas into a complete config schema.
+ */
+export function mergeConfigSchema(options) {
+    const { pluginSchemas } = options;
+    const schema = createBaseConfigSchema();
+    const pluginRefs = [];
+    for (const { pluginName, options: optionsSchema } of pluginSchemas) {
+        if (!optionsSchema)
+            continue;
+        const defName = `${pluginName.replace(/[^a-zA-Z0-9]/g, '')}Options`;
+        try {
+            const parsed = JSON.parse(optionsSchema);
+            const defs = schema.$defs ?? {};
+            defs[defName] = {
+                ...parsed,
+                description: `Options for ${pluginName} plugin`,
+            };
+            schema.$defs = defs;
+            pluginRefs.push({
+                type: 'object',
+                properties: {
+                    name: { const: pluginName },
+                    options: { $ref: `#/$defs/${defName}` },
+                },
+            });
+        }
+        catch {
+            // Invalid JSON schema, skip
+            console.warn(`Invalid options schema for plugin ${pluginName}`);
+        }
+    }
+    // Update plugins array to use anyOf if we have plugin schemas
+    if (pluginRefs.length > 0) {
+        const properties = schema.properties ?? {};
+        properties.plugins = {
+            type: 'array',
+            description: 'Plugins to use for scanning and parsing',
+            items: { anyOf: pluginRefs },
+        };
+        schema.properties = properties;
+    }
+    return schema;
+}
+/**
+ * Deep merge two JSON Schema objects.
+ * Second schema (b) takes priority on conflicts.
+ */
+function deepMergeSchemas(a, b) {
+    const result = { ...a };
+    for (const [key, value] of Object.entries(b)) {
+        if (key === 'properties' &&
+            result.properties &&
+            typeof value === 'object') {
+            // Merge properties, b takes priority
+            result.properties = {
+                ...result.properties,
+                ...value,
+            };
+        }
+        else if (key === 'required' &&
+            Array.isArray(result.required) &&
+            Array.isArray(value)) {
+            // Union required arrays
+            result.required = [...new Set([...result.required, ...value])];
+        }
+        else {
+            // b takes priority for all other fields
+            result[key] = value;
+        }
+    }
+    return result;
+}
+/**
+ * Merge metadata schemas from config and plugins.
+ * Config schema takes priority on conflicts.
+ */
+export function mergeMetadataSchemas(options) {
+    const { configSchema, pluginSchemas } = options;
+    // Start with empty base or config schema
+    let merged = configSchema ?? {
+        type: 'object',
+        properties: {},
+    };
+    // Merge in plugin schemas (config already in merged, so it has priority)
+    for (const { pluginName, metadata } of pluginSchemas) {
+        if (!metadata)
+            continue;
+        try {
+            const pluginSchema = JSON.parse(metadata);
+            // Merge plugin into current, but then overlay config again for priority
+            const withPlugin = deepMergeSchemas(pluginSchema, merged);
+            // Re-apply config schema to ensure it wins on conflicts
+            merged = configSchema
+                ? deepMergeSchemas(withPlugin, configSchema)
+                : withPlugin;
+        }
+        catch {
+            console.warn(`Invalid metadata schema for plugin ${pluginName}`);
+        }
+    }
+    return merged;
+}
+//# sourceMappingURL=merger.js.map

package/dist/schema/merger.js.map

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

package/dist/schema/typegen.d.ts

@@ -0,0 +1,13 @@
+import type { JSONSchema } from './merger.js';
+export interface GenerateMetadataTypesOptions {
+    /** Pre-merged metadata schema (from mergeMetadataSchemas) */
+    mergedSchema?: JSONSchema;
+}
+/**
+ * Generate TypeScript type declarations from merged metadata schema.
+ *
+ * Outputs a module augmentation that extends ExampleMetadataRegistry,
+ * which automatically provides types for all Example<> usages.
+ */
+export declare function generateMetadataTypes(options: GenerateMetadataTypesOptions): string;
+//# sourceMappingURL=typegen.d.ts.map

package/dist/schema/typegen.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"typegen.d.ts","sourceRoot":"","sources":["../../src/schema/typegen.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C,MAAM,WAAW,4BAA4B;IAC3C,6DAA6D;IAC7D,YAAY,CAAC,EAAE,UAAU,CAAC;CAC3B;AA8HD;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,4BAA4B,GACpC,MAAM,CAqBR"}

package/dist/schema/typegen.js

@@ -0,0 +1,125 @@
+/**
+ * Convert JSON Schema type to TypeScript type.
+ * @param schema - The JSON Schema to convert
+ * @param indent - Current indentation level (number of spaces)
+ */
+function schemaTypeToTS(schema, indent = 0) {
+    const type = schema.type;
+    const pad = ' '.repeat(indent);
+    const innerPad = ' '.repeat(indent + 2);
+    if (schema.const !== undefined) {
+        return JSON.stringify(schema.const);
+    }
+    if (schema.enum) {
+        return schema.enum.map((v) => JSON.stringify(v)).join(' | ');
+    }
+    if (schema.anyOf) {
+        const variants = schema.anyOf.map((s) => schemaTypeToTS(s, indent));
+        return variants.join(' | ');
+    }
+    if (schema.oneOf) {
+        const variants = schema.oneOf.map((s) => schemaTypeToTS(s, indent));
+        return variants.join(' | ');
+    }
+    if (schema.allOf) {
+        const variants = schema.allOf.map((s) => schemaTypeToTS(s, indent));
+        return variants.join(' & ');
+    }
+    switch (type) {
+        case 'string':
+            return 'string';
+        case 'number':
+        case 'integer':
+            return 'number';
+        case 'boolean':
+            return 'boolean';
+        case 'null':
+            return 'null';
+        case 'array': {
+            const items = schema.items;
+            return items ? `Array<${schemaTypeToTS(items, indent)}>` : 'unknown[]';
+        }
+        case 'object': {
+            const properties = schema.properties;
+            const additionalProps = schema.additionalProperties;
+            // Dictionary type: { additionalProperties: { type: "string" } }
+            if (!properties && additionalProps && typeof additionalProps === 'object') {
+                return `Record<string, ${schemaTypeToTS(additionalProps, indent)}>`;
+            }
+            if (!properties)
+                return 'Record<string, unknown>';
+            const required = new Set(schema.required ?? []);
+            const props = Object.entries(properties)
+                .map(([key, propSchema]) => {
+                const optional = required.has(key) ? '' : '?';
+                return `${innerPad}${key}${optional}: ${schemaTypeToTS(propSchema, indent + 2)};`;
+            })
+                .join('\n');
+            return `{\n${props}\n${pad}}`;
+        }
+        default:
+            return 'unknown';
+    }
+}
+const HEADER = `/**
+ * Auto-generated metadata types from config and plugins.
+ * Do not edit manually - regenerate with: functional-examples generate
+ *
+ * This file augments the ExampleMetadataRegistry interface to provide
+ * type-safe metadata for all Example types in your project.
+ *
+ * Include this file in your tsconfig.json to enable type checking.
+ */
+
+// Import required to make this an augmentation rather than a replacement
+import '@functional-examples/devkit';
+
+`;
+/**
+ * Generate a metadata type object literal from JSON Schema.
+ * The output is indented to fit inside the ExampleMetadataRegistry interface.
+ */
+function generateMetadataType(schema) {
+    const properties = schema.properties;
+    if (!properties || Object.keys(properties).length === 0) {
+        return 'Record<string, unknown>';
+    }
+    const required = new Set(schema.required ?? []);
+    // Base indent is 6 spaces (inside `metadata: { ... }` which is inside the interface)
+    const baseIndent = 6;
+    const props = Object.entries(properties)
+        .map(([key, propSchema]) => {
+        const optional = required.has(key) ? '' : '?';
+        const tsType = schemaTypeToTS(propSchema, baseIndent);
+        return `${' '.repeat(baseIndent)}${key}${optional}: ${tsType};`;
+    })
+        .join('\n');
+    // Closing brace at 4 spaces (level of `metadata:`)
+    return `{\n${props}\n    }`;
+}
+/**
+ * Generate TypeScript type declarations from merged metadata schema.
+ *
+ * Outputs a module augmentation that extends ExampleMetadataRegistry,
+ * which automatically provides types for all Example<> usages.
+ */
+export function generateMetadataTypes(options) {
+    const { mergedSchema } = options;
+    if (!mergedSchema || !mergedSchema.properties) {
+        // No schema properties - output empty augmentation
+        return `${HEADER}declare module '@functional-examples/devkit' {
+  interface ExampleMetadataRegistry {
+    metadata: Record<string, unknown>;
+  }
+}
+`;
+    }
+    const metadataType = generateMetadataType(mergedSchema);
+    return `${HEADER}declare module '@functional-examples/devkit' {
+  interface ExampleMetadataRegistry {
+    metadata: ${metadataType};
+  }
+}
+`;
+}
+//# sourceMappingURL=typegen.js.map

package/dist/schema/typegen.js.map

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

package/dist/schema/validator.d.ts

@@ -0,0 +1,7 @@
+import type { JSONSchema } from './merger.js';
+import type { ValidationResult } from '../types/index.js';
+/**
+ * Create a validator function from a JSON Schema using AJV.
+ */
+export declare function createSchemaValidator(schema: JSONSchema): (value: unknown) => ValidationResult;
+//# sourceMappingURL=validator.d.ts.map

package/dist/schema/validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validator.d.ts","sourceRoot":"","sources":["../../src/schema/validator.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,KAAK,EAAE,gBAAgB,EAAmB,MAAM,mBAAmB,CAAC;AAM3E;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,UAAU,GACjB,CAAC,KAAK,EAAE,OAAO,KAAK,gBAAgB,CA6BtC"}

package/dist/schema/validator.js

@@ -0,0 +1,32 @@
+import AjvDefault from 'ajv';
+// Handle both ESM and CJS default exports
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+const Ajv = AjvDefault.default ?? AjvDefault;
+/**
+ * Create a validator function from a JSON Schema using AJV.
+ */
+export function createSchemaValidator(schema) {
+    const ajv = new Ajv({ allErrors: true });
+    const validate = ajv.compile(schema);
+    return (value) => {
+        const valid = validate(value);
+        if (valid) {
+            return { success: true, errors: [] };
+        }
+        const errors = (validate.errors ?? []).map((err) => {
+            // Build path from instancePath and params
+            const basePath = err.instancePath ? err.instancePath.slice(1) : '';
+            const missingProp = err.params?.missingProperty;
+            let path = basePath;
+            if (missingProp) {
+                path = basePath ? `${basePath}/${missingProp}` : missingProp;
+            }
+            return {
+                path,
+                message: err.message ?? 'Validation failed',
+            };
+        });
+        return { success: false, errors };
+    };
+}
+//# sourceMappingURL=validator.js.map

package/dist/schema/validator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validator.js","sourceRoot":"","sources":["../../src/schema/validator.ts"],"names":[],"mappings":"AAAA,OAAO,UAAU,MAAM,KAAK,CAAC;AAI7B,0CAA0C;AAC1C,8DAA8D;AAC9D,MAAM,GAAG,GAAI,UAAkB,CAAC,OAAO,IAAI,UAAU,CAAC;AAEtD;;GAEG;AACH,MAAM,UAAU,qBAAqB,CACnC,MAAkB;IAElB,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACzC,MAAM,QAAQ,GAAG,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IAErC,OAAO,CAAC,KAAc,EAAoB,EAAE;QAC1C,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;QAE9B,IAAI,KAAK,EAAE,CAAC;YACV,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;QACvC,CAAC;QAED,MAAM,MAAM,GAAsB,CAAC,QAAQ,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;YACpE,0CAA0C;YAC1C,MAAM,QAAQ,GAAG,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC,GAAG,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YACnE,MAAM,WAAW,GAAG,GAAG,CAAC,MAAM,EAAE,eAAqC,CAAC;YAEtE,IAAI,IAAI,GAAG,QAAQ,CAAC;YACpB,IAAI,WAAW,EAAE,CAAC;gBAChB,IAAI,GAAG,QAAQ,CAAC,CAAC,CAAC,GAAG,QAAQ,IAAI,WAAW,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC;YAC/D,CAAC;YAED,OAAO;gBACL,IAAI;gBACJ,OAAO,EAAE,GAAG,CAAC,OAAO,IAAI,mBAAmB;aAC5C,CAAC;QACJ,CAAC,CAAC,CAAC;QAEH,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;IACpC,CAAC,CAAC;AACJ,CAAC"}

package/dist/types/default-map.d.ts

@@ -0,0 +1,21 @@
+/**
+ * A Map that automatically creates default values when accessing missing keys.
+ *
+ * @example
+ * ```typescript
+ * const countsByCategory = new DefaultMap<string, number[]>(() => []);
+ * countsByCategory.get('fruits').push(1); // No need to check if key exists
+ * countsByCategory.get('fruits').push(2);
+ * console.log(countsByCategory.get('fruits')); // [1, 2]
+ * ```
+ */
+export declare class DefaultMap<K, V> extends Map<K, V> {
+    private defaultValueBuilder;
+    constructor(defaultValueBuilder: () => V);
+    /**
+     * Gets the value for a key. If the key doesn't exist, creates a default value,
+     * stores it, and returns it.
+     */
+    get(key: K): V;
+}
+//# sourceMappingURL=default-map.d.ts.map

package/dist/types/default-map.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"default-map.d.ts","sourceRoot":"","sources":["../../src/types/default-map.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,qBAAa,UAAU,CAAC,CAAC,EAAE,CAAC,CAAE,SAAQ,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC;IACjC,OAAO,CAAC,mBAAmB;gBAAnB,mBAAmB,EAAE,MAAM,CAAC;IAIhD;;;OAGG;IACM,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC;CASxB"}

package/dist/types/default-map.js

@@ -0,0 +1,32 @@
+/**
+ * A Map that automatically creates default values when accessing missing keys.
+ *
+ * @example
+ * ```typescript
+ * const countsByCategory = new DefaultMap<string, number[]>(() => []);
+ * countsByCategory.get('fruits').push(1); // No need to check if key exists
+ * countsByCategory.get('fruits').push(2);
+ * console.log(countsByCategory.get('fruits')); // [1, 2]
+ * ```
+ */
+export class DefaultMap extends Map {
+    defaultValueBuilder;
+    constructor(defaultValueBuilder) {
+        super();
+        this.defaultValueBuilder = defaultValueBuilder;
+    }
+    /**
+     * Gets the value for a key. If the key doesn't exist, creates a default value,
+     * stores it, and returns it.
+     */
+    get(key) {
+        const inMap = super.get(key);
+        if (inMap !== undefined) {
+            return inMap;
+        }
+        const defaultValue = this.defaultValueBuilder();
+        super.set(key, defaultValue);
+        return defaultValue;
+    }
+}
+//# sourceMappingURL=default-map.js.map

package/dist/types/default-map.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"default-map.js","sourceRoot":"","sources":["../../src/types/default-map.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,MAAM,OAAO,UAAiB,SAAQ,GAAS;IACzB;IAApB,YAAoB,mBAA4B;QAC9C,KAAK,EAAE,CAAC;QADU,wBAAmB,GAAnB,mBAAmB,CAAS;IAEhD,CAAC;IAED;;;OAGG;IACM,GAAG,CAAC,GAAM;QACjB,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAC7B,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,OAAO,KAAK,CAAC;QACf,CAAC;QACD,MAAM,YAAY,GAAG,IAAI,CAAC,mBAAmB,EAAE,CAAC;QAChD,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,YAAY,CAAC,CAAC;QAC7B,OAAO,YAAY,CAAC;IACtB,CAAC;CACF"}