typekro 0.1.0

package/dist/utils/helpers.js

@@ -0,0 +1,405 @@
+/**
+ * General utility functions for TypeKro
+ *
+ * This module contains helper functions that are used across the codebase
+ * for common operations like string manipulation, ID generation, and
+ * data processing.
+ */
+import { isKubernetesRef, isCelExpression } from './type-guards.js';
+import { ReadinessEvaluatorRegistry } from '../core/readiness/index.js';
+/**
+ * Generate deterministic resource ID based on resource metadata
+ * This ensures stable IDs across multiple applications for GitOps workflows
+ */
+export function generateDeterministicResourceId(kind, name, _namespace) {
+    const cleanKind = kind.toLowerCase().replace(/[^a-zA-Z0-9]/g, '');
+    // Handle case where name is a KubernetesRef (schema reference)
+    if (isKubernetesRef(name)) {
+        // For schema references, we can't generate a deterministic ID without evaluation
+        // Throw an error suggesting the user provide an explicit ID
+        throw new Error(`Cannot generate deterministic resource ID for ${kind} with KubernetesRef name. ` +
+            `Please provide an explicit 'id' field in the resource config, e.g.: ` +
+            `simpleDeployment({ name: schema.spec.name, image: 'nginx', id: 'my-deployment' })`);
+    }
+    // Handle case where name is a CEL expression
+    if (isCelExpression(name)) {
+        // For CEL expressions, we can't generate a deterministic ID without evaluation
+        // Throw an error suggesting the user provide an explicit ID
+        throw new Error(`Cannot generate deterministic resource ID for ${kind} with CEL expression name. ` +
+            `Please provide an explicit 'id' field in the resource config, e.g.: ` +
+            `simpleDeployment({ name: Cel.expr('my-', schema.spec.name), image: 'nginx', id: 'my-deployment' })`);
+    }
+    // Handle normal string names - these are safe for deterministic ID generation
+    const nameStr = name;
+    // Check if the name contains template expressions (legacy string templates)
+    if (nameStr.includes('${') || nameStr.includes('{{')) {
+        throw new Error(`Cannot generate deterministic resource ID for ${kind} with template expression in name: "${nameStr}". ` +
+            `Please either use static names or provide an explicit 'id' in the resource factory options.`);
+    }
+    // For static names, generate a clean, deterministic ID
+    // If the name already contains the kind, just use the name
+    if (nameStr.toLowerCase().includes(cleanKind)) {
+        return toCamelCase(nameStr);
+    }
+    // Otherwise, prefix with kind for clarity
+    return toCamelCase(`${cleanKind}-${nameStr}`);
+}
+/**
+ * Converts a kebab-case or snake_case string to camelCase
+ */
+export function toCamelCase(str) {
+    // Return early for empty strings to avoid errors.
+    if (!str) {
+        return '';
+    }
+    return str
+        .split(/[-_]/)
+        .map((word, index) => {
+        // If it's the first word, just lowercase the first letter and keep the rest.
+        if (index === 0) {
+            return word.charAt(0).toLowerCase() + word.slice(1);
+        }
+        // For all subsequent words, capitalize the first letter and lowercase the rest.
+        return word.charAt(0).toUpperCase() + word.slice(1).toLowerCase();
+    })
+        .join('');
+}
+/**
+ * Generates a unique resource ID (legacy random version for development)
+ */
+export function generateResourceId(name) {
+    const timestamp = Date.now().toString(36);
+    const random = Math.random().toString(36).substring(2, 8);
+    return name
+        ? `${name.replace(/[^a-zA-Z0-9-]/g, '')}-${timestamp}-${random}`
+        : `resource-${timestamp}-${random}`;
+}
+/**
+ * Converts a string to PascalCase.
+ */
+export function pascalCase(str) {
+    return str
+        .split(/[-_\s]+/)
+        .map((word) => word.charAt(0).toUpperCase() + word.slice(1).toLowerCase())
+        .join('');
+}
+/**
+ * Generate CEL expression with configurable context.
+ * This now uses the shared helper function from cel.ts.
+ */
+function generateCelExpression(ref, _context) {
+    // Use the single, authoritative function to get the correct path.
+    const expression = getInnerCelPath(ref);
+    return `\${${expression}}`;
+}
+/**
+ * Generate inner CEL reference without ${} wrapper for building expressions
+ */
+export function generateCelReference(ref) {
+    const resourceId = ref.resourceId === '__schema__' ? 'schema' : ref.resourceId;
+    return `${resourceId}.${ref.fieldPath}`;
+}
+/**
+ * Gets the inner CEL path for a KubernetesRef, handling special cases like schema refs.
+ * This is the new, authoritative function.
+ */
+export function getInnerCelPath(ref) {
+    const resourceId = ref.resourceId === '__schema__' ? 'schema' : ref.resourceId;
+    return `${resourceId}.${ref.fieldPath}`;
+}
+/**
+ * Recursively replaces all KubernetesRef objects with CEL expressions for Kro.
+ * This is the ONLY function that should perform this transformation.
+ */
+export function processResourceReferences(obj, context) {
+    if (isKubernetesRef(obj)) {
+        // Use configurable CEL expression format instead of hardcoded "resources."
+        return generateCelExpression(obj, context);
+    }
+    if (isCelExpression(obj)) {
+        // Check if this is a template expression (mixed string with embedded CEL)
+        if (obj.__isTemplate) {
+            // Template expressions already contain ${...} placeholders, don't wrap again
+            return obj.expression;
+        }
+        // Regular CEL expressions need to be wrapped with ${} for Kro
+        return `\${${obj.expression}}`;
+    }
+    if (Array.isArray(obj)) {
+        return obj.map((item) => processResourceReferences(item, context));
+    }
+    if (obj && typeof obj === 'object') {
+        const result = {};
+        // Use Object.entries to get enumerable properties
+        for (const [key, value] of Object.entries(obj)) {
+            // Exclude the hidden resourceId property and id field from the final template
+            if (key === '__resourceId' || key === 'id')
+                continue;
+            result[key] = processResourceReferences(value, context);
+        }
+        // Preserve the readinessEvaluator function if it exists (it's non-enumerable)
+        const originalObj = obj;
+        if (originalObj.readinessEvaluator && typeof originalObj.readinessEvaluator === 'function') {
+            Object.defineProperty(result, 'readinessEvaluator', {
+                value: originalObj.readinessEvaluator,
+                enumerable: false,
+                configurable: true,
+                writable: false,
+            });
+        }
+        return result;
+    }
+    return obj;
+}
+/**
+ * Converts an Arktype JSON AST node into a Kro-compatible type string.
+ * This is the final version, corrected to handle single-quoted literals.
+ * @param node The Arktype JSON AST node.
+ * @returns A string representing the Kro type.
+ */
+function getKroTypeFromJson(node) {
+    // Case 1: The node is an object describing a type.
+    if (typeof node === 'object' && node !== null && !Array.isArray(node)) {
+        const nodeObj = node;
+        if (nodeObj.proto === 'Array' && nodeObj.sequence) {
+            return `[]${getKroTypeFromJson(nodeObj.sequence)}`;
+        }
+        if (nodeObj.domain === 'number' && nodeObj.divisor === 1) {
+            return 'integer';
+        }
+    }
+    // Case 2: The node is an array, representing a union of literals.
+    if (Array.isArray(node)) {
+        if (node.length === 2 &&
+            node.some((branch) => branch.unit === true) &&
+            node.some((branch) => branch.unit === false)) {
+            return 'boolean';
+        }
+        // Handle literal unions - use Kro Simple Schema enum format
+        const enumValues = node.map((branch) => {
+            if (typeof branch.unit === 'string') {
+                return branch.unit;
+            }
+            return String(branch.unit);
+        });
+        // Return as Kro Simple Schema enum format: string | enum="value1,value2,value3"
+        return `string | enum="${enumValues.join(',')}"`;
+    }
+    // Case 3: The node is a simple string representing a primitive type.
+    if (typeof node === 'string') {
+        if (node.includes('%')) {
+            const [domain] = node.split('%');
+            if (domain === 'number')
+                return 'integer';
+        }
+        switch (node) {
+            case 'number':
+                return 'integer';
+            case 'string':
+            case 'boolean':
+                return node;
+        }
+    }
+    // Fallback for safety.
+    return 'string';
+}
+function arktypeJsonToKroFields(node, prefix = '') {
+    let fields = {};
+    // Handle case where node doesn't have required/optional structure
+    if (!node || typeof node !== 'object') {
+        return fields;
+    }
+    const nodeObj = node;
+    if (!nodeObj.required && !nodeObj.optional) {
+        return fields;
+    }
+    const required = Array.isArray(nodeObj.required) ? nodeObj.required : [];
+    const optional = Array.isArray(nodeObj.optional) ? nodeObj.optional : [];
+    const props = [...required, ...optional];
+    for (const prop of props) {
+        // THIS IS THE CORRECTED LOGIC FOR CREATING THE KEY
+        // It correctly joins camelCased keys like "connection" and "poolSize".
+        const newKey = prefix
+            ? `${prefix}${prop.key.charAt(0).toUpperCase() + prop.key.slice(1)}`
+            : prop.key;
+        const childNode = prop.value;
+        if (typeof childNode === 'object' &&
+            childNode !== null &&
+            (childNode.required || childNode.optional)) {
+            const nestedFields = arktypeJsonToKroFields(childNode, newKey);
+            fields = { ...fields, ...nestedFields };
+        }
+        else {
+            fields[newKey] = getKroTypeFromJson(childNode);
+        }
+    }
+    return fields;
+}
+/**
+ * Serialize user-defined status mappings to CEL expressions for Kro schema
+ * Only processes dynamic fields that require Kro resolution
+ */
+function serializeStatusMappingsToCel(statusMappings) {
+    const celExpressions = {};
+    function serializeValue(value) {
+        // Handle KubernetesRef objects (can be functions due to proxy)
+        if (isKubernetesRef(value)) {
+            return `\${${value.resourceId}.${value.fieldPath}}`;
+        }
+        // Handle CelExpression objects
+        if (isCelExpression(value)) {
+            // Check if this is a template expression (mixed string with embedded CEL)
+            if (value.__isTemplate) {
+                // Template expressions already contain ${...} placeholders, don't wrap again
+                return value.expression;
+            }
+            return `\${${value.expression}}`;
+        }
+        // Handle nested objects recursively
+        if (value && typeof value === 'object' && !Array.isArray(value)) {
+            const nestedExpressions = {};
+            for (const [key, nestedValue] of Object.entries(value)) {
+                nestedExpressions[key] = serializeValue(nestedValue);
+            }
+            return nestedExpressions; // Return as any for nested objects
+        }
+        // Handle primitive values
+        if (typeof value === 'string') {
+            return `\${"${value}"}`;
+        }
+        if (typeof value === 'number') {
+            return `\${${value}}`;
+        }
+        if (typeof value === 'boolean') {
+            return `\${${value}}`;
+        }
+        // Fallback for unknown types
+        return `\${""}`;
+    }
+    for (const [fieldName, fieldValue] of Object.entries(statusMappings)) {
+        celExpressions[fieldName] = serializeValue(fieldValue);
+    }
+    return celExpressions;
+}
+/**
+ * Determines if a status field value requires Kro resolution (contains Kubernetes references or CEL expressions)
+ */
+function _requiresKroResolution(value) {
+    if (isKubernetesRef(value)) {
+        return true;
+    }
+    if (isCelExpression(value)) {
+        // Check if the CEL expression contains resource references
+        const expression = value.expression;
+        const resourceRefPattern = /([a-zA-Z][a-zA-Z0-9]*)\.(status|spec|metadata)\./;
+        return resourceRefPattern.test(expression);
+    }
+    if (value && typeof value === 'object' && !Array.isArray(value) && !isCelExpression(value)) {
+        // Recursively check nested objects
+        return Object.values(value).some(_requiresKroResolution);
+    }
+    return false;
+}
+/**
+ * Convert kebab-case or snake_case to camelCase and ensure a readiness evaluator by using the appropriate factory function
+ * This leverages existing factory functions that already have readiness evaluators defined
+ */
+export function ensureReadinessEvaluator(resource) {
+    // First: Check if resource already has attached evaluator
+    if (typeof resource.readinessEvaluator === 'function') {
+        return resource;
+    }
+    // Second: Look up in registry by KIND
+    const registry = ReadinessEvaluatorRegistry.getInstance();
+    const evaluator = registry.getEvaluatorForKind(resource.kind);
+    if (evaluator) {
+        // Attach the registry evaluator to this resource instance
+        Object.defineProperty(resource, 'readinessEvaluator', {
+            value: evaluator,
+            enumerable: false,
+            configurable: true,
+            writable: false,
+        });
+        return resource;
+    }
+    // Third: No evaluator found anywhere
+    throw new Error(`No readiness evaluator found for ${resource.kind}/${resource.metadata?.name}. ` +
+        `Use a factory function like deployment(), configMap(), etc., or call .withReadinessEvaluator().`);
+}
+/**
+ * Recursively converts an Enhanced resource proxy into a plain JavaScript object.
+ * This is a safe way to serialize the object for the Kubernetes client, preserving
+ * all nested properties and stripping any remaining proxy logic.
+ * @param obj The object to convert.
+ * @param visited A set to track circular references.
+ * @returns A plain JavaScript object.
+ */
+export function toPlainObject(obj, visited = new Set()) {
+    if (obj === null || typeof obj !== 'object') {
+        return obj;
+    }
+    if (visited.has(obj)) {
+        return obj; // Avoid circular loops
+    }
+    visited.add(obj);
+    // Handle arrays by converting each item
+    if (Array.isArray(obj)) {
+        const plainArray = obj.map((item) => toPlainObject(item, visited));
+        visited.delete(obj);
+        return plainArray;
+    }
+    // Use getOwnPropertyNames and getOwnPropertySymbols to capture all keys,
+    // including non-enumerable ones (like our brand symbols) if needed.
+    const plainObj = {};
+    const keys = Reflect.ownKeys(obj);
+    for (const key of keys) {
+        const value = obj[key];
+        // Preserve readinessEvaluator function as-is
+        if (key === 'readinessEvaluator') {
+            plainObj[key] = value;
+        }
+        // Skip other functions like 'withReadinessEvaluator'
+        else if (typeof value !== 'function') {
+            plainObj[key] = toPlainObject(value, visited);
+        }
+    }
+    visited.delete(obj);
+    return plainObj;
+}
+/**
+ * Converts an Arktype schema to a Kro-compatible schema definition
+ *
+ * IMPORTANT: Status fields in Kro now use user-defined mappings from the StatusBuilder function
+ * instead of auto-generated CEL expressions.
+ */
+export function arktypeToKroSchema(name, schemaDefinition, _resources, statusMappings) {
+    const specFields = arktypeJsonToKroFields(schemaDefinition.spec.json);
+    if (!specFields.name) {
+        specFields.name = `string | default="${name}"`;
+    }
+    // Separate static and dynamic status fields
+    const { dynamicFields } = statusMappings
+        ? separateStatusFields(statusMappings)
+        : { dynamicFields: {} };
+    // Only serialize dynamic fields that need Kro resolution
+    const statusCelExpressions = Object.keys(dynamicFields).length > 0 ? serializeStatusMappingsToCel(dynamicFields) : {};
+    // Extract just the version part for the schema (Kro expects v1alpha1, not kro.run/v1alpha1)
+    const schemaApiVersion = schemaDefinition.apiVersion.includes('/')
+        ? schemaDefinition.apiVersion.split('/')[1] || schemaDefinition.apiVersion
+        : schemaDefinition.apiVersion;
+    return {
+        apiVersion: schemaApiVersion,
+        kind: schemaDefinition.kind,
+        spec: specFields,
+        status: {
+            // Only dynamic status field mappings as CEL expressions
+            // Static fields will be hydrated directly by TypeKro
+            // Kro automatically injects default fields (phase, message, observedGeneration, conditions, state)
+            ...statusCelExpressions,
+        },
+    };
+}
+// Function removed - status mappings are now user-defined via StatusBuilder
+// Import type guards from the type-guards module (removed duplicate import)
+import { separateStatusFields } from '../core/validation/cel-validator.js';
+//# sourceMappingURL=helpers.js.map

package/dist/utils/helpers.js.map

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

package/dist/utils/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Utilities Module
+ *
+ * This module provides general utility functions and type guards
+ * that are used throughout the TypeKro codebase.
+ */
+export { arktypeToKroSchema, generateCelReference, generateDeterministicResourceId, generateResourceId, getInnerCelPath, pascalCase, processResourceReferences, } from './helpers.js';
+export { extractResourceReferences, isCelExpression, isKubernetesRef, isResourceReference, } from './type-guards.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EACL,kBAAkB,EAClB,oBAAoB,EACpB,+BAA+B,EAC/B,kBAAkB,EAClB,eAAe,EACf,UAAU,EACV,yBAAyB,GAC1B,MAAM,cAAc,CAAC;AAGtB,OAAO,EACL,yBAAyB,EACzB,eAAe,EACf,eAAe,EACf,mBAAmB,GACpB,MAAM,kBAAkB,CAAC"}

package/dist/utils/index.js

@@ -0,0 +1,11 @@
+/**
+ * Utilities Module
+ *
+ * This module provides general utility functions and type guards
+ * that are used throughout the TypeKro codebase.
+ */
+// Export helper functions
+export { arktypeToKroSchema, generateCelReference, generateDeterministicResourceId, generateResourceId, getInnerCelPath, pascalCase, processResourceReferences, } from './helpers.js';
+// Export type guard functions
+export { extractResourceReferences, isCelExpression, isKubernetesRef, isResourceReference, } from './type-guards.js';
+//# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,0BAA0B;AAC1B,OAAO,EACL,kBAAkB,EAClB,oBAAoB,EACpB,+BAA+B,EAC/B,kBAAkB,EAClB,eAAe,EACf,UAAU,EACV,yBAAyB,GAC1B,MAAM,cAAc,CAAC;AAEtB,8BAA8B;AAC9B,OAAO,EACL,yBAAyB,EACzB,eAAe,EACf,eAAe,EACf,mBAAmB,GACpB,MAAM,kBAAkB,CAAC"}

package/dist/utils/type-guards.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Type guard functions for TypeKro
+ *
+ * This module contains type guard functions that are used throughout
+ * the codebase to safely check and narrow types at runtime.
+ */
+import type { CelExpression, KubernetesRef, ResourceReference } from '../core/types.js';
+import { MIXED_TEMPLATE_BRAND } from '../core/constants/brands.js';
+/**
+ * Type guard to check if a value is a compile-time KubernetesRef.
+ * Note: At runtime, these are the objects created by the proxy.
+ */
+export declare function isKubernetesRef(obj: unknown): obj is KubernetesRef<unknown>;
+/**
+ * Type guard to check if a value is a runtime ResourceReference.
+ * This is what the serializer looks for.
+ */
+export declare function isResourceReference(obj: unknown): obj is ResourceReference<unknown>;
+/**
+ * Type guard to check if a value is a CEL expression
+ */
+export declare function isCelExpression<T = unknown>(value: unknown): value is CelExpression<T>;
+/**
+ * Type guard to check if a value is a mixed template (literal string with embedded CEL)
+ */
+export declare function isMixedTemplate(value: unknown): value is {
+    [MIXED_TEMPLATE_BRAND]: true;
+    expression: string;
+};
+/**
+ * Recursively extracts all KubernetesRef objects from a resource definition.
+ */
+export declare function extractResourceReferences(obj: unknown): KubernetesRef<unknown>[];
+//# sourceMappingURL=type-guards.d.ts.map

package/dist/utils/type-guards.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"type-guards.d.ts","sourceRoot":"","sources":["../../src/utils/type-guards.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAExF,OAAO,EAA8C,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AAE/G;;;GAGG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,aAAa,CAAC,OAAO,CAAC,CAS3E;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,iBAAiB,CAAC,OAAO,CAAC,CAInF;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,CAAC,GAAG,OAAO,EAAE,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,aAAa,CAAC,CAAC,CAAC,CAOtF;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI;IAAE,CAAC,oBAAoB,CAAC,EAAE,IAAI,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAO7G;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,OAAO,GAAG,aAAa,CAAC,OAAO,CAAC,EAAE,CAmBhF"}

package/dist/utils/type-guards.js

@@ -0,0 +1,66 @@
+/**
+ * Type guard functions for TypeKro
+ *
+ * This module contains type guard functions that are used throughout
+ * the codebase to safely check and narrow types at runtime.
+ */
+import { KUBERNETES_REF_BRAND, CEL_EXPRESSION_BRAND, MIXED_TEMPLATE_BRAND } from '../core/constants/brands.js';
+/**
+ * Type guard to check if a value is a compile-time KubernetesRef.
+ * Note: At runtime, these are the objects created by the proxy.
+ */
+export function isKubernetesRef(obj) {
+    // A KubernetesRef is an object that has our specific brand property.
+    // We check for the function type as well, since our ref factory is a proxy around a function.
+    // Note: We access the property directly since it's defined as non-enumerable
+    return ((typeof obj === 'object' || typeof obj === 'function') &&
+        obj !== null &&
+        KUBERNETES_REF_BRAND in obj);
+}
+/**
+ * Type guard to check if a value is a runtime ResourceReference.
+ * This is what the serializer looks for.
+ */
+export function isResourceReference(obj) {
+    return (obj !== null && typeof obj === 'object' && '__type' in obj && obj.__type === 'ResourceReference');
+}
+/**
+ * Type guard to check if a value is a CEL expression
+ */
+export function isCelExpression(value) {
+    return Boolean(value &&
+        typeof value === 'object' &&
+        value !== null &&
+        CEL_EXPRESSION_BRAND in value);
+}
+/**
+ * Type guard to check if a value is a mixed template (literal string with embedded CEL)
+ */
+export function isMixedTemplate(value) {
+    return Boolean(value &&
+        typeof value === 'object' &&
+        value !== null &&
+        MIXED_TEMPLATE_BRAND in value);
+}
+/**
+ * Recursively extracts all KubernetesRef objects from a resource definition.
+ */
+export function extractResourceReferences(obj) {
+    const refs = [];
+    if (isKubernetesRef(obj)) {
+        refs.push(obj);
+        return refs;
+    }
+    if (Array.isArray(obj)) {
+        obj.forEach((item) => {
+            refs.push(...extractResourceReferences(item));
+        });
+    }
+    else if (obj && typeof obj === 'object') {
+        for (const value of Object.values(obj)) {
+            refs.push(...extractResourceReferences(value));
+        }
+    }
+    return refs;
+}
+//# sourceMappingURL=type-guards.js.map

package/dist/utils/type-guards.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"type-guards.js","sourceRoot":"","sources":["../../src/utils/type-guards.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AAE/G;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,GAAY;IAC1C,qEAAqE;IACrE,8FAA8F;IAC9F,6EAA6E;IAC7E,OAAO,CACL,CAAC,OAAO,GAAG,KAAK,QAAQ,IAAI,OAAO,GAAG,KAAK,UAAU,CAAC;QACtD,GAAG,KAAK,IAAI;QACZ,oBAAoB,IAAI,GAAG,CAC5B,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,GAAY;IAC9C,OAAO,CACL,GAAG,KAAK,IAAI,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,QAAQ,IAAI,GAAG,IAAI,GAAG,CAAC,MAAM,KAAK,mBAAmB,CACjG,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAc,KAAc;IACzD,OAAO,OAAO,CACZ,KAAK;QACH,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACd,oBAAoB,IAAI,KAAK,CAChC,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,KAAc;IAC5C,OAAO,OAAO,CACZ,KAAK;QACH,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACd,oBAAoB,IAAI,KAAK,CAChC,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,yBAAyB,CAAC,GAAY;IACpD,MAAM,IAAI,GAA6B,EAAE,CAAC;IAE1C,IAAI,eAAe,CAAC,GAAG,CAAC,EAAE,CAAC;QACzB,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACf,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QACvB,GAAG,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE;YACnB,IAAI,CAAC,IAAI,CAAC,GAAG,yBAAyB,CAAC,IAAI,CAAC,CAAC,CAAC;QAChD,CAAC,CAAC,CAAC;IACL,CAAC;SAAM,IAAI,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;QAC1C,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;YACvC,IAAI,CAAC,IAAI,CAAC,GAAG,yBAAyB,CAAC,KAAK,CAAC,CAAC,CAAC;QACjD,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC"}