typekro 0.1.0

package/dist/core/references/cel-evaluator.js

@@ -0,0 +1,288 @@
+/**
+ * CEL Expression Runtime Evaluator
+ *
+ * This module provides ACTUAL runtime CEL expression evaluation using the cel-js library.
+ * This is used for Direct mode deployment where CEL expressions must be evaluated
+ * by TypeKro before creating Kubernetes manifests.
+ *
+ * Purpose:
+ * - Evaluate CEL expressions at runtime using live cluster data
+ * - Resolve resource references to actual values from deployed resources
+ * - Support standard CEL functions and operations
+ *
+ * When to use:
+ * - Direct mode deployment (DeploymentMode.DIRECT)
+ * - When CEL expressions need to be resolved to concrete values
+ * - For status field evaluation that references live cluster resources
+ *
+ * NOT used for:
+ * - Kro mode deployment (Kro operator handles CEL evaluation)
+ * - Compile-time optimization (see cel-optimizer.ts)
+ */
+import { evaluate, parse } from 'cel-js';
+import { isKubernetesRef } from '../../utils/index.js';
+import { CEL_EXPRESSION_BRAND } from '../constants/brands.js';
+import { CelEvaluationError } from '../types/references.js';
+export class CelEvaluator {
+    /**
+     * Evaluate a CEL expression with the given context
+     */
+    async evaluate(expression, context) {
+        try {
+            // Build the evaluation context for cel-js
+            const celContext = await this.buildCelContext(expression, context);
+            // Use cel-js to evaluate the expression with standard functions
+            const functions = {
+                // Standard CEL functions
+                string: (value) => String(value),
+                int: (value) => parseInt(String(value), 10),
+                double: (value) => parseFloat(String(value)),
+                size: (collection) => {
+                    if (Array.isArray(collection))
+                        return collection.length;
+                    if (typeof collection === 'string')
+                        return collection.length;
+                    if (collection && typeof collection === 'object')
+                        return Object.keys(collection).length;
+                    return 0;
+                },
+                has: (obj, field) => {
+                    if (field) {
+                        return obj && typeof obj === 'object' && field in obj;
+                    }
+                    // For expressions like has(config.debug), the field access is already resolved
+                    return obj !== undefined && obj !== null;
+                },
+                concat: (...args) => args.join(''),
+                ...context.functions,
+            };
+            const result = evaluate(expression.expression, celContext, functions);
+            return result;
+        }
+        catch (error) {
+            throw new CelEvaluationError(expression, error);
+        }
+    }
+    /**
+     * Parse a CEL expression for validation or reuse
+     */
+    parse(expression) {
+        try {
+            const parseResult = parse(expression.expression);
+            if (!parseResult.isSuccess) {
+                throw new Error('Failed to parse CEL expression');
+            }
+            return async (context) => {
+                const celContext = await this.buildCelContext(expression, context);
+                const functions = {
+                    // Standard CEL functions
+                    string: (value) => String(value),
+                    int: (value) => parseInt(String(value), 10),
+                    double: (value) => parseFloat(String(value)),
+                    size: (collection) => {
+                        if (Array.isArray(collection))
+                            return collection.length;
+                        if (typeof collection === 'string')
+                            return collection.length;
+                        if (collection && typeof collection === 'object')
+                            return Object.keys(collection).length;
+                        return 0;
+                    },
+                    has: (obj, field) => {
+                        if (field) {
+                            return obj && typeof obj === 'object' && field in obj;
+                        }
+                        // For expressions like has(config.debug), the field access is already resolved
+                        return obj !== undefined && obj !== null;
+                    },
+                    concat: (...args) => args.join(''),
+                    ...context.functions,
+                };
+                return evaluate(parseResult.cst, celContext, functions);
+            };
+        }
+        catch (error) {
+            throw new CelEvaluationError(expression, error);
+        }
+    }
+    /**
+     * Validate that a CEL expression can be parsed
+     */
+    validate(expression) {
+        try {
+            const parseResult = parse(expression.expression);
+            if (parseResult.isSuccess) {
+                return { valid: true };
+            }
+            else {
+                return {
+                    valid: false,
+                    error: 'Failed to parse CEL expression',
+                };
+            }
+        }
+        catch (error) {
+            return {
+                valid: false,
+                error: error instanceof Error ? error.message : String(error),
+            };
+        }
+    }
+    /**
+     * Build the context object for cel-js evaluation
+     */
+    async buildCelContext(expression, context) {
+        const celContext = {};
+        // Add variables to context
+        if (context.variables) {
+            Object.assign(celContext, context.variables);
+        }
+        // Resolve resource references and add them to context
+        const resourceRefs = this.extractResourceReferences(expression.expression);
+        for (const ref of resourceRefs) {
+            const resource = context.resources.get(ref.resourceId);
+            if (!resource) {
+                throw new Error(`Resource '${ref.resourceId}' not found in context`);
+            }
+            // Add the entire resource to context using its ID
+            if (!celContext[ref.resourceId]) {
+                celContext[ref.resourceId] = resource;
+            }
+        }
+        return celContext;
+    }
+    /**
+     * Extract resource references from a CEL expression
+     */
+    extractResourceReferences(expression) {
+        const refs = [];
+        // Pattern to match resource references: resourceId.section.field
+        const refPattern = /(\w+)\.(\w+)\.(\w+(?:\[\d+\])?(?:\.\w+)*)/g;
+        let match = refPattern.exec(expression);
+        while (match !== null) {
+            const [, resourceId, section, fieldPath] = match;
+            if (resourceId && section && fieldPath) {
+                refs.push({
+                    resourceId,
+                    fieldPath: `${section}.${fieldPath}`,
+                });
+            }
+            match = refPattern.exec(expression);
+        }
+        return refs;
+    }
+    /**
+     * Create a CEL expression from a template string with resource references
+     */
+    static createExpression(template, ...refs) {
+        let expression = template;
+        // Replace placeholders with actual resource references
+        refs.forEach((ref, index) => {
+            const placeholder = `$${index}`;
+            const refExpression = `${ref.resourceId}.${ref.fieldPath}`;
+            expression = expression.replace(placeholder, refExpression);
+        });
+        return {
+            [CEL_EXPRESSION_BRAND]: true,
+            expression,
+        };
+    }
+    /**
+     * Common CEL expression builders
+     */
+    static expressions = {
+        /**
+         * Concatenate strings: concat("prefix", resource.field, "suffix")
+         */
+        concat: (...parts) => {
+            const args = parts
+                .map((part) => {
+                if (isKubernetesRef(part)) {
+                    return `${part.resourceId}.${part.fieldPath}`;
+                }
+                return `"${part}"`;
+            })
+                .join(', ');
+            return {
+                [CEL_EXPRESSION_BRAND]: true,
+                expression: `concat(${args})`,
+            };
+        },
+        /**
+         * Conditional expression: condition ? trueValue : falseValue
+         */
+        conditional: (condition, trueValue, falseValue) => {
+            const conditionExpr = isKubernetesRef(condition)
+                ? `${condition.resourceId}.${condition.fieldPath}`
+                : condition;
+            return {
+                [CEL_EXPRESSION_BRAND]: true,
+                expression: `${conditionExpr} ? ${JSON.stringify(trueValue)} : ${JSON.stringify(falseValue)}`,
+            };
+        },
+        /**
+         * Check if a field exists: has(resource.field)
+         */
+        has: (ref) => ({
+            [CEL_EXPRESSION_BRAND]: true,
+            expression: `has(${ref.resourceId}.${ref.fieldPath})`,
+        }),
+        /**
+         * Get size/length: size(resource.field)
+         */
+        size: (ref) => ({
+            [CEL_EXPRESSION_BRAND]: true,
+            expression: `size(${ref.resourceId}.${ref.fieldPath})`,
+        }),
+        /**
+         * String contains check: resource.field.contains("substring")
+         */
+        contains: (ref, substring) => ({
+            [CEL_EXPRESSION_BRAND]: true,
+            expression: `${ref.resourceId}.${ref.fieldPath}.contains("${substring}")`,
+        }),
+        /**
+         * String starts with check: resource.field.startsWith("prefix")
+         */
+        startsWith: (ref, prefix) => ({
+            [CEL_EXPRESSION_BRAND]: true,
+            expression: `${ref.resourceId}.${ref.fieldPath}.startsWith("${prefix}")`,
+        }),
+        /**
+         * String ends with check: resource.field.endsWith("suffix")
+         */
+        endsWith: (ref, suffix) => ({
+            [CEL_EXPRESSION_BRAND]: true,
+            expression: `${ref.resourceId}.${ref.fieldPath}.endsWith("${suffix}")`,
+        }),
+        /**
+         * List/array operations: resource.field.all(x, x > 0)
+         */
+        all: (ref, predicate) => ({
+            [CEL_EXPRESSION_BRAND]: true,
+            expression: `${ref.resourceId}.${ref.fieldPath}.all(x, ${predicate})`,
+        }),
+        /**
+         * List/array operations: resource.field.exists(x, x > 0)
+         */
+        exists: (ref, predicate) => ({
+            [CEL_EXPRESSION_BRAND]: true,
+            expression: `${ref.resourceId}.${ref.fieldPath}.exists(x, ${predicate})`,
+        }),
+        /**
+         * List/array filter: resource.field.filter(x, x > 0)
+         */
+        filter: (ref, predicate) => ({
+            [CEL_EXPRESSION_BRAND]: true,
+            expression: `${ref.resourceId}.${ref.fieldPath}.filter(x, ${predicate})`,
+        }),
+        /**
+         * List/array map: resource.field.map(x, x * 2)
+         */
+        map: (ref, transform) => ({
+            [CEL_EXPRESSION_BRAND]: true,
+            expression: `${ref.resourceId}.${ref.fieldPath}.map(x, ${transform})`,
+        }),
+    };
+}
+//# sourceMappingURL=cel-evaluator.js.map

package/dist/core/references/cel-evaluator.js.map

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

package/dist/core/references/cel.d.ts

@@ -0,0 +1,75 @@
+import type { CelExpression, RefOrValue, SerializationContext } from '../types.js';
+declare function expr<T = unknown>(...parts: RefOrValue<unknown>[]): CelExpression<T> & T;
+declare function expr<T = unknown>(context: SerializationContext, ...parts: RefOrValue<unknown>[]): CelExpression<T> & T;
+/**
+ * Convenience method for joining parts with automatic spacing.
+ * Useful for building readable CEL expressions.
+ */
+declare function join<T = unknown>(...parts: RefOrValue<unknown>[]): CelExpression<T> & T;
+declare function join<T = unknown>(context: SerializationContext, ...parts: RefOrValue<unknown>[]): CelExpression<T> & T;
+type CelValue = string | number | boolean | null | undefined;
+/**
+ * Creates a conditional CEL expression: condition ? trueValue : falseValue
+ */
+declare function conditional<T = unknown>(condition: RefOrValue<CelValue>, trueValue: RefOrValue<CelValue>, falseValue: RefOrValue<CelValue>): CelExpression<T> & T;
+declare function conditional<T = unknown>(context: SerializationContext, condition: RefOrValue<CelValue>, trueValue: RefOrValue<CelValue>, falseValue: RefOrValue<CelValue>): CelExpression<T> & T;
+/**
+ * Creates a CEL expression for mathematical operations
+ */
+declare function math<T = unknown>(operation: string, ...operands: RefOrValue<CelValue>[]): CelExpression<T> & T;
+declare function math<T = unknown>(context: SerializationContext, operation: string, ...operands: RefOrValue<CelValue>[]): CelExpression<T> & T;
+/**
+ * Creates a mixed string template that combines literal strings with CEL expressions
+ *
+ * This function creates YAML strings with embedded CEL expressions.
+ *
+ * Examples:
+ * - template('http://%s', schema.spec.name) -> "http://${schema.spec.name}"
+ * - template('%s-%s', prefix, suffix) -> "${prefix}-${suffix}"
+ */
+declare function template(templateString: string, ...values: RefOrValue<CelValue>[]): CelExpression<string> & string;
+declare function template(context: SerializationContext, templateString: string, ...values: RefOrValue<CelValue>[]): CelExpression<string> & string;
+/**
+ * Creates a CEL string concatenation expression using the + operator
+ *
+ * This function automatically quotes string literals and joins all parts with +
+ *
+ * Examples:
+ * - concat('http://', serviceName) -> "http://" + serviceName
+ * - concat(prefix, '-', suffix) -> prefix + "-" + suffix
+ */
+declare function concat(...parts: RefOrValue<CelValue>[]): CelExpression<string> & string;
+declare function concat(context: SerializationContext, ...parts: RefOrValue<CelValue>[]): CelExpression<string> & string;
+/**
+ * CEL utility functions
+ */
+export declare const Cel: {
+    expr: typeof expr;
+    join: typeof join;
+    conditional: typeof conditional;
+    math: typeof math;
+    template: typeof template;
+    concat: typeof concat;
+    min: (...values: RefOrValue<CelValue>[]) => CelExpression<number> & number;
+    max: (...values: RefOrValue<CelValue>[]) => CelExpression<number> & number;
+    size: (collection: RefOrValue<CelValue>) => CelExpression<number> & number;
+    string: (value: RefOrValue<CelValue>) => CelExpression<string> & string;
+    int: (value: RefOrValue<CelValue>) => CelExpression<number> & number;
+    double: (value: RefOrValue<CelValue>) => CelExpression<number> & number;
+    withContext: (context: SerializationContext) => {
+        expr: (...parts: RefOrValue<CelValue>[]) => CelExpression<unknown>;
+        join: (...parts: RefOrValue<CelValue>[]) => CelExpression<unknown>;
+        conditional: (condition: RefOrValue<CelValue>, trueValue: RefOrValue<CelValue>, falseValue: RefOrValue<CelValue>) => CelExpression<unknown>;
+        math: (operation: string, ...operands: RefOrValue<CelValue>[]) => CelExpression<unknown>;
+        template: (templateString: string, ...values: RefOrValue<CelValue>[]) => CelExpression<string> & string;
+        concat: (...parts: RefOrValue<CelValue>[]) => CelExpression<string> & string;
+        min: (...values: RefOrValue<CelValue>[]) => CelExpression<number> & number;
+        max: (...values: RefOrValue<CelValue>[]) => CelExpression<number> & number;
+        size: (collection: RefOrValue<CelValue>) => CelExpression<number> & number;
+        string: (value: RefOrValue<CelValue>) => CelExpression<string> & string;
+        int: (value: RefOrValue<CelValue>) => CelExpression<number> & number;
+        double: (value: RefOrValue<CelValue>) => CelExpression<number> & number;
+    };
+};
+export {};
+//# sourceMappingURL=cel.d.ts.map

package/dist/core/references/cel.d.ts.map

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

package/dist/core/references/cel.js

@@ -0,0 +1,213 @@
+import { getInnerCelPath, isCelExpression, isKubernetesRef } from '../../utils/index.js';
+import { CEL_EXPRESSION_BRAND } from '../constants/brands.js';
+function expr(contextOrFirstPart, ...parts) {
+    let _context;
+    let actualParts;
+    // Check if first argument is a context object
+    if (contextOrFirstPart &&
+        typeof contextOrFirstPart === 'object' &&
+        'celPrefix' in contextOrFirstPart) {
+        _context = contextOrFirstPart;
+        actualParts = parts;
+    }
+    else {
+        actualParts = [contextOrFirstPart, ...parts];
+    }
+    const celParts = actualParts.map((part) => {
+        if (isKubernetesRef(part)) {
+            // Use inner reference without ${} wrapper for building expressions
+            return getInnerCelPath(part);
+        }
+        if (isCelExpression(part)) {
+            return part.expression;
+        }
+        if (typeof part === 'string') {
+            return part;
+        }
+        if (typeof part === 'number' || typeof part === 'boolean') {
+            return String(part);
+        }
+        // For other types, convert to string
+        return String(part);
+    });
+    const expression = celParts.join('');
+    return {
+        [CEL_EXPRESSION_BRAND]: true,
+        expression,
+    };
+}
+function join(contextOrFirstPart, ...parts) {
+    let context;
+    let actualParts;
+    // Check if first argument is a context object
+    if (contextOrFirstPart &&
+        typeof contextOrFirstPart === 'object' &&
+        'celPrefix' in contextOrFirstPart) {
+        context = contextOrFirstPart;
+        actualParts = parts;
+    }
+    else {
+        actualParts = [contextOrFirstPart, ...parts];
+    }
+    // Add spaces between parts for readability
+    const spacedParts = [];
+    for (let i = 0; i < actualParts.length; i++) {
+        spacedParts.push(actualParts[i]);
+        if (i < actualParts.length - 1) {
+            spacedParts.push(' ');
+        }
+    }
+    // Pass the generic type <T> to the expr call
+    return context ? expr(context, ...spacedParts) : expr(...spacedParts);
+}
+function conditional(contextOrCondition, conditionOrTrueValue, trueValueOrFalseValue, falseValue) {
+    if (falseValue !== undefined) {
+        // Context overload: Pass the generic type <T> to the expr call
+        const context = contextOrCondition;
+        return expr(context, conditionOrTrueValue, ' ? ', trueValueOrFalseValue, ' : ', falseValue);
+    }
+    else {
+        // No context overload: Pass the generic type <T> to the expr call
+        return expr(contextOrCondition, ' ? ', conditionOrTrueValue, ' : ', trueValueOrFalseValue);
+    }
+}
+function math(contextOrOperation, operationOrFirstOperand, ...operands) {
+    let context;
+    let operation;
+    let actualOperands;
+    if (typeof contextOrOperation === 'string') {
+        // No context overload
+        operation = contextOrOperation;
+        actualOperands = operationOrFirstOperand ? [operationOrFirstOperand, ...operands] : operands;
+    }
+    else {
+        // Context overload
+        context = contextOrOperation;
+        operation = operationOrFirstOperand;
+        actualOperands = operands;
+    }
+    const operandStrings = actualOperands.map((op) => {
+        if (isKubernetesRef(op)) {
+            return getInnerCelPath(op);
+        }
+        if (isCelExpression(op)) {
+            return op.expression;
+        }
+        return String(op);
+    });
+    const result = context
+        ? expr(context, `${operation}(${operandStrings.join(', ')})`)
+        : expr(`${operation}(${operandStrings.join(', ')})`);
+    return result;
+}
+function template(contextOrTemplateString, templateStringOrFirstValue, ...values) {
+    let _context;
+    let templateString;
+    let actualValues;
+    if (typeof contextOrTemplateString === 'string') {
+        // No context overload
+        templateString = contextOrTemplateString;
+        actualValues = templateStringOrFirstValue ? [templateStringOrFirstValue, ...values] : values;
+    }
+    else {
+        // Context overload
+        _context = contextOrTemplateString;
+        templateString = templateStringOrFirstValue;
+        actualValues = values;
+    }
+    let result = templateString;
+    let valueIndex = 0;
+    // Replace %s placeholders with ${...} CEL expressions
+    result = result.replace(/%s/g, () => {
+        if (valueIndex < actualValues.length) {
+            const value = actualValues[valueIndex++];
+            if (isKubernetesRef(value)) {
+                // For KubernetesRef, create a ${...} placeholder
+                return `\${${getInnerCelPath(value)}}`;
+            }
+            if (isCelExpression(value)) {
+                // For CEL expressions, wrap in ${...}
+                return `\${${value.expression}}`;
+            }
+            // For literal values, just insert them directly
+            return String(value);
+        }
+        return '%s';
+    });
+    // Mark this as a special template expression that should not be wrapped in ${...}
+    return {
+        [CEL_EXPRESSION_BRAND]: true,
+        expression: result,
+        __isTemplate: true, // Special flag to indicate this is a mixed template
+    };
+}
+function concat(contextOrFirstPart, ...parts) {
+    let _context;
+    let actualParts;
+    // Check if first argument is a context object
+    if (contextOrFirstPart &&
+        typeof contextOrFirstPart === 'object' &&
+        'celPrefix' in contextOrFirstPart) {
+        _context = contextOrFirstPart;
+        actualParts = parts;
+    }
+    else {
+        actualParts = [contextOrFirstPart, ...parts];
+    }
+    const celParts = actualParts.map((part) => {
+        if (isKubernetesRef(part)) {
+            return getInnerCelPath(part);
+        }
+        if (isCelExpression(part)) {
+            return part.expression;
+        }
+        if (typeof part === 'string') {
+            // Quote string literals for CEL
+            return `"${part}"`;
+        }
+        if (typeof part === 'number' || typeof part === 'boolean') {
+            return String(part);
+        }
+        // For other types, convert to string and quote
+        return `"${String(part)}"`;
+    });
+    const expression = celParts.join(' + ');
+    return {
+        [CEL_EXPRESSION_BRAND]: true,
+        expression,
+    };
+}
+/**
+ * CEL utility functions
+ */
+export const Cel = {
+    expr,
+    join,
+    conditional,
+    math,
+    template,
+    concat,
+    // Common CEL functions as utilities
+    min: (...values) => math('min', ...values),
+    max: (...values) => math('max', ...values),
+    size: (collection) => math('size', collection),
+    string: (value) => math('string', value),
+    int: (value) => math('int', value),
+    double: (value) => math('double', value),
+    // Context-aware versions
+    withContext: (context) => ({
+        expr: (...parts) => expr(context, ...parts),
+        join: (...parts) => join(context, ...parts),
+        conditional: (condition, trueValue, falseValue) => conditional(context, condition, trueValue, falseValue),
+        math: (operation, ...operands) => math(context, operation, ...operands),
+        template: (templateString, ...values) => template(context, templateString, ...values),
+        concat: (...parts) => concat(context, ...parts),
+        min: (...values) => math(context, 'min', ...values),
+        max: (...values) => math(context, 'max', ...values),
+        size: (collection) => math(context, 'size', collection),
+        string: (value) => math(context, 'string', value),
+        int: (value) => math(context, 'int', value),
+        double: (value) => math(context, 'double', value),
+    }),
+};
+//# sourceMappingURL=cel.js.map

package/dist/core/references/cel.js.map

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

package/dist/core/references/external-refs.d.ts

@@ -0,0 +1,37 @@
+/**
+ * External reference support for Kro Factory Pattern
+ *
+ * This module provides functionality to create external references to CRD instances
+ * for composition between ResourceGraphDefinitions.
+ */
+import type { Enhanced } from '../types.js';
+/**
+ * Create external reference to CRD instance for composition between ResourceGraphDefinitions
+ *
+ * @param apiVersion - API version of the external CRD
+ * @param kind - Kind of the external CRD
+ * @param instanceName - Name of the CRD instance to reference
+ * @param namespace - Optional namespace of the CRD instance
+ * @returns Enhanced proxy that can be used in resource templates
+ *
+ * @example
+ * ```typescript
+ * // Reference an external database instance
+ * const database = externalRef<DatabaseSpec, DatabaseStatus>(
+ *   'v1alpha1',
+ *   'Database',
+ *   'production-db'
+ * );
+ *
+ * // Use in resource template
+ * const webapp = simpleDeployment({
+ *   name: 'webapp',
+ *   image: 'nginx',
+ *   env: {
+ *     DATABASE_URL: database.status.connectionString
+ *   }
+ * });
+ * ```
+ */
+export declare function externalRef<TSpec extends object, TStatus extends object>(apiVersion: string, kind: string, instanceName: string, namespace?: string): Enhanced<TSpec, TStatus>;
+//# sourceMappingURL=external-refs.d.ts.map

package/dist/core/references/external-refs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"external-refs.d.ts","sourceRoot":"","sources":["../../../src/core/references/external-refs.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,QAAQ,EAAsB,MAAM,aAAa,CAAC;AAEhE;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,WAAW,CAAC,KAAK,SAAS,MAAM,EAAE,OAAO,SAAS,MAAM,EACtE,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,EACZ,YAAY,EAAE,MAAM,EACpB,SAAS,CAAC,EAAE,MAAM,GACjB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC,CAiB1B"}