typekro 0.4.0 → 0.5.0

package/dist/core/expressions/factory/status-builder-analyzer.js

@@ -0,0 +1,374 @@
+/**
+ * Status Builder Analyzer — Orchestrator
+ *
+ * Analyzes status builder functions used in toResourceGraph, detecting
+ * KubernetesRef objects from the magic proxy system and converting
+ * JavaScript expressions to appropriate CEL expressions.
+ *
+ * Implementation is decomposed into:
+ * - status-ast-utils.ts — AST parsing, source extraction, pattern detection
+ * - status-cel-generation.ts — CEL generation with status-specific transformations
+ * - status-field-analysis.ts — per-field analysis (AST-based and runtime)
+ */
+import { containsKubernetesRefs } from '../../../utils/type-guards.js';
+import { DEFAULT_MAX_ANALYSIS_DEPTH } from '../../config/defaults.js';
+import { ConversionError, ensureError } from '../../errors.js';
+import { getComponentLogger } from '../../logging/index.js';
+import { JavaScriptToCelAnalyzer } from '../analysis/analyzer.js';
+import { MagicProxyAnalyzer } from '../magic-proxy/magic-proxy-analyzer.js';
+import { EnhancedTypeOptionalityHandler, } from '../magic-proxy/optionality-handler.js';
+import { analyzeReturnStatement as analyzeReturnStatementFn, parseStatusBuilderFunction as parseStatusBuilderFunctionFn, } from './status-ast-utils.js';
+import { convertStaticValueToCel, generateFallbackStatusCel, generateStatusContextCelWithAdvancedFeatures, } from './status-cel-generation.js';
+import { analyzeReturnObjectField as analyzeReturnObjectFieldFn, analyzeStatusField as analyzeStatusFieldFn, categorizeDependencies, } from './status-field-analysis.js';
+/**
+ * Default analysis options
+ */
+const DEFAULT_ANALYSIS_OPTIONS = {
+    deepAnalysis: true,
+    includeSourceMapping: true,
+    validateReferences: true,
+    performOptionalityAnalysis: true,
+    factoryType: 'kro',
+    maxDepth: DEFAULT_MAX_ANALYSIS_DEPTH,
+    hydrationStates: new Map(),
+    conservativeNullSafety: true,
+};
+/**
+ * Status Builder Analyzer
+ *
+ * Analyzes status builder functions to extract KubernetesRef dependencies
+ * and convert JavaScript expressions to CEL for status field population.
+ */
+export class StatusBuilderAnalyzer {
+    expressionAnalyzer;
+    magicProxyAnalyzer;
+    optionalityHandler;
+    options;
+    logger = getComponentLogger('status-builder-analyzer');
+    constructor(expressionAnalyzer, options) {
+        this.expressionAnalyzer = expressionAnalyzer || new JavaScriptToCelAnalyzer();
+        this.magicProxyAnalyzer = new MagicProxyAnalyzer();
+        this.optionalityHandler = new EnhancedTypeOptionalityHandler();
+        this.options = { ...DEFAULT_ANALYSIS_OPTIONS, ...options };
+    }
+    // ── Main orchestration ─────────────────────────────────────────────
+    /**
+     * Analyze status builder function for toResourceGraph integration
+     */
+    analyzeStatusBuilder(statusBuilder, resources, schemaProxy) {
+        try {
+            this.logger.debug('Analyzing status builder function', {
+                resourceCount: Object.keys(resources).length,
+                hasSchemaProxy: !!schemaProxy,
+                factoryType: this.options.factoryType,
+            });
+            const originalSource = statusBuilder.toString();
+            // Parse the status builder function (delegates to status-ast-utils)
+            const ast = parseStatusBuilderFunctionFn(originalSource);
+            // Analyze the return statement (delegates to status-ast-utils)
+            const returnStatement = analyzeReturnStatementFn(ast, originalSource);
+            if (!returnStatement || !returnStatement.returnsObject) {
+                throw new ConversionError('Status builder must return an object literal', originalSource, 'function-call');
+            }
+            // Analyze each property in the returned object
+            const fieldAnalysis = new Map();
+            const statusMappings = {};
+            const allDependencies = [];
+            const allSourceMap = [];
+            const allErrors = [];
+            let overallValid = true;
+            for (const property of returnStatement.properties) {
+                try {
+                    // Delegates to status-field-analysis
+                    const fieldResult = analyzeStatusFieldFn(property, resources, originalSource, this.expressionAnalyzer, this.optionalityHandler, this.options, schemaProxy);
+                    fieldAnalysis.set(property.name, fieldResult);
+                    if (fieldResult.valid) {
+                        if (fieldResult.celExpression) {
+                            statusMappings[property.name] = fieldResult.celExpression;
+                        }
+                        else if (fieldResult.staticValue !== undefined) {
+                            statusMappings[property.name] = fieldResult.staticValue;
+                        }
+                        else if (property.valueNode.type === 'Literal') {
+                            statusMappings[property.name] = property.valueNode.value;
+                        }
+                        else if (property.valueNode.type === 'Identifier' &&
+                            property.valueNode.name === 'undefined') {
+                            statusMappings[property.name] = undefined;
+                        }
+                        else if (property.valueNode.type === 'UnaryExpression' &&
+                            property.valueNode.operator === '!' &&
+                            property.valueNode.argument?.type === 'Literal' &&
+                            typeof property.valueNode.argument.value === 'number') {
+                            const booleanValue = property.valueNode.argument.value === 0;
+                            statusMappings[property.name] = booleanValue;
+                        }
+                    }
+                    allDependencies.push(...fieldResult.dependencies);
+                    allSourceMap.push(...fieldResult.sourceMap);
+                    allErrors.push(...fieldResult.errors);
+                    if (!fieldResult.valid) {
+                        overallValid = false;
+                    }
+                }
+                catch (error) {
+                    const fieldError = new ConversionError(`Failed to analyze status field '${property.name}': ${ensureError(error).message}`, property.valueSource, 'unknown');
+                    allErrors.push(fieldError);
+                    overallValid = false;
+                    this.logger.debug('Status field analysis using fallback', {
+                        fieldName: property.name,
+                        reason: 'Field contains patterns that cannot be converted to CEL',
+                        fallbackBehavior: 'Static evaluation will be used',
+                        error: ensureError(error).message,
+                    });
+                }
+            }
+            // Categorize dependencies (delegates to status-field-analysis)
+            const { resourceReferences, schemaReferences } = categorizeDependencies(allDependencies);
+            this.logger.debug('Status builder analysis complete', {
+                fieldCount: returnStatement.properties.length,
+                validFields: Object.keys(statusMappings).length,
+                totalDependencies: allDependencies.length,
+                resourceReferences: resourceReferences.length,
+                schemaReferences: schemaReferences.length,
+                overallValid,
+            });
+            // Aggregate warnings from all field analyses
+            const allWarnings = [];
+            for (const fieldResult of fieldAnalysis.values()) {
+                allWarnings.push(...fieldResult.warnings);
+            }
+            return {
+                fieldAnalysis,
+                statusMappings,
+                allDependencies,
+                resourceReferences,
+                schemaReferences,
+                sourceMap: allSourceMap,
+                errors: allErrors,
+                valid: overallValid,
+                warnings: allWarnings,
+                originalSource,
+                ast,
+                returnStatement,
+            };
+        }
+        catch (error) {
+            const analysisError = new ConversionError(`Failed to analyze status builder: ${ensureError(error).message}`, statusBuilder.toString(), 'function-call');
+            this.logger.info('Status builder analysis using fallback - this is normal for certain patterns', {
+                reason: 'Status builder contains patterns that cannot be converted to CEL expressions',
+                fallbackBehavior: 'Static evaluation will be used instead',
+                error: ensureError(error).message,
+            });
+            return {
+                fieldAnalysis: new Map(),
+                statusMappings: {},
+                allDependencies: [],
+                resourceReferences: [],
+                schemaReferences: [],
+                sourceMap: [],
+                errors: [analysisError],
+                valid: false,
+                warnings: [],
+                originalSource: statusBuilder.toString(),
+            };
+        }
+    }
+    // ── Runtime object analysis ────────────────────────────────────────
+    /**
+     * Analyze return object expressions with magic proxy support
+     */
+    analyzeReturnObjectWithMagicProxy(returnObject, resources, schemaProxy) {
+        const statusMappings = {};
+        const dependencies = [];
+        const errors = [];
+        if (!returnObject || typeof returnObject !== 'object') {
+            errors.push(new ConversionError('Return object must be a valid object', String(returnObject), 'unknown'));
+            return { statusMappings, dependencies, errors };
+        }
+        for (const [fieldName, fieldValue] of Object.entries(returnObject)) {
+            try {
+                const fieldResult = analyzeReturnObjectFieldFn(fieldName, fieldValue, resources, this.optionalityHandler, this.options, schemaProxy);
+                if (fieldResult.celExpression) {
+                    statusMappings[fieldName] = fieldResult.celExpression;
+                }
+                dependencies.push(...fieldResult.dependencies);
+                errors.push(...fieldResult.errors);
+            }
+            catch (error) {
+                errors.push(new ConversionError(`Failed to analyze field '${fieldName}': ${ensureError(error).message}`, String(fieldValue), 'unknown'));
+            }
+        }
+        return { statusMappings, dependencies, errors };
+    }
+    // ── Nested structure analysis ──────────────────────────────────────
+    /**
+     * Perform deep analysis of nested return object structures
+     */
+    analyzeNestedReturnObjectStructure(returnObject, resources, schemaProxy, depth = 0) {
+        const flattenedMappings = {};
+        const nestedDependencies = new Map();
+        const structureErrors = [];
+        if (depth > this.options.maxDepth) {
+            structureErrors.push(new ConversionError(`Maximum analysis depth (${this.options.maxDepth}) exceeded`, String(returnObject), 'unknown'));
+            return { flattenedMappings, nestedDependencies, structureErrors };
+        }
+        try {
+            this.analyzeObjectStructureRecursively(returnObject, '', flattenedMappings, nestedDependencies, structureErrors, resources, schemaProxy, depth);
+        }
+        catch (error) {
+            structureErrors.push(new ConversionError(`Failed to analyze nested structure: ${ensureError(error).message}`, String(returnObject), 'unknown'));
+        }
+        return { flattenedMappings, nestedDependencies, structureErrors };
+    }
+    /**
+     * Recursively analyze object structure for KubernetesRef objects
+     */
+    analyzeObjectStructureRecursively(obj, pathPrefix, flattenedMappings, nestedDependencies, errors, resources, schemaProxy, depth = 0) {
+        if (!obj || typeof obj !== 'object' || Array.isArray(obj)) {
+            return;
+        }
+        for (const [key, value] of Object.entries(obj)) {
+            const fullPath = pathPrefix ? `${pathPrefix}.${key}` : key;
+            try {
+                if (containsKubernetesRefs(value)) {
+                    const fieldResult = analyzeReturnObjectFieldFn(fullPath, value, resources, this.optionalityHandler, this.options, schemaProxy);
+                    if (fieldResult.celExpression) {
+                        flattenedMappings[fullPath] = fieldResult.celExpression;
+                    }
+                    if (fieldResult.dependencies.length > 0) {
+                        nestedDependencies.set(fullPath, fieldResult.dependencies);
+                    }
+                    errors.push(...fieldResult.errors);
+                }
+                else if (value && typeof value === 'object' && !Array.isArray(value)) {
+                    this.analyzeObjectStructureRecursively(value, fullPath, flattenedMappings, nestedDependencies, errors, resources, schemaProxy, depth + 1);
+                }
+                else {
+                    flattenedMappings[fullPath] = convertStaticValueToCel(value);
+                }
+            }
+            catch (error) {
+                errors.push(new ConversionError(`Failed to analyze nested field '${fullPath}': ${ensureError(error).message}`, String(value), 'unknown'));
+            }
+        }
+    }
+    // ── CEL generation (delegates to status-cel-generation) ────────────
+    /**
+     * Generate status context-specific CEL from KubernetesRef objects
+     */
+    generateStatusContextCel(kubernetesRef, context) {
+        try {
+            return generateStatusContextCelWithAdvancedFeatures(kubernetesRef, context);
+        }
+        catch (error) {
+            this.logger.debug('Status context CEL generation using fallback', {
+                resourceId: kubernetesRef.resourceId,
+                fieldPath: kubernetesRef.fieldPath,
+                reason: 'Reference pattern cannot be converted to CEL',
+                fallbackBehavior: 'Static reference will be used',
+                error: ensureError(error).message,
+            });
+            return generateFallbackStatusCel(kubernetesRef);
+        }
+    }
+}
+// ── Standalone convenience functions ─────────────────────────────────
+/**
+ * Analyze status builder function for toResourceGraph integration with KubernetesRef detection
+ */
+export function analyzeStatusBuilderForToResourceGraph(statusBuilder, resources, schemaProxy, factoryType = 'kro') {
+    const options = {
+        deepAnalysis: true,
+        includeSourceMapping: true,
+        validateReferences: true,
+        performOptionalityAnalysis: true,
+        factoryType,
+        conservativeNullSafety: true,
+    };
+    const analyzer = new StatusBuilderAnalyzer(undefined, options);
+    const result = analyzer.analyzeStatusBuilder(statusBuilder, resources, schemaProxy);
+    // Calculate hydration order based on dependencies
+    const hydrationOrder = calculateStatusFieldHydrationOrder(result.fieldAnalysis);
+    // Determine if any conversion is required
+    const requiresConversion = Array.from(result.fieldAnalysis.values()).some((field) => field.requiresConversion);
+    return {
+        statusMappings: result.statusMappings,
+        dependencies: result.allDependencies,
+        hydrationOrder,
+        errors: result.errors,
+        warnings: result.warnings,
+        valid: result.valid,
+        requiresConversion,
+    };
+}
+/**
+ * Calculate hydration order for status fields based on their dependencies
+ */
+function calculateStatusFieldHydrationOrder(fieldAnalysis) {
+    const fieldDependencies = new Map();
+    const allFields = Array.from(fieldAnalysis.keys());
+    // Build field-to-field dependencies
+    for (const [fieldName, analysis] of fieldAnalysis) {
+        const fieldDeps = new Set();
+        for (const dep of analysis.dependencies) {
+            if (dep.resourceId !== '__schema__') {
+                for (const [otherField, otherAnalysis] of fieldAnalysis) {
+                    if (otherField !== fieldName) {
+                        const hasMatchingResource = otherAnalysis.dependencies.some((otherDep) => otherDep.resourceId === dep.resourceId);
+                        if (hasMatchingResource) {
+                            fieldDeps.add(otherField);
+                        }
+                    }
+                }
+            }
+        }
+        fieldDependencies.set(fieldName, fieldDeps);
+    }
+    // Perform topological sort
+    const visited = new Set();
+    const visiting = new Set();
+    const result = [];
+    const visit = (field) => {
+        if (visiting.has(field)) {
+            return; // Circular dependency - add to result anyway
+        }
+        if (visited.has(field)) {
+            return;
+        }
+        visiting.add(field);
+        const deps = fieldDependencies.get(field) || new Set();
+        for (const dep of deps) {
+            visit(dep);
+        }
+        visiting.delete(field);
+        visited.add(field);
+        result.push(field);
+    };
+    for (const field of allFields) {
+        visit(field);
+    }
+    return result;
+}
+/**
+ * Convenience function to analyze status builder functions
+ */
+export function analyzeStatusBuilder(statusBuilder, resources, schemaProxy, options) {
+    const analyzer = new StatusBuilderAnalyzer(undefined, options);
+    return analyzer.analyzeStatusBuilder(statusBuilder, resources, schemaProxy);
+}
+/**
+ * Convenience function to analyze return objects with magic proxy support
+ */
+export function analyzeReturnObjectWithMagicProxy(returnObject, resources, schemaProxy, options) {
+    const analyzer = new StatusBuilderAnalyzer(undefined, options);
+    return analyzer.analyzeReturnObjectWithMagicProxy(returnObject, resources, schemaProxy);
+}
+/**
+ * Convenience function to generate status context-specific CEL
+ */
+export function generateStatusContextCel(kubernetesRef, context, options) {
+    const analyzer = new StatusBuilderAnalyzer(undefined, options);
+    return analyzer.generateStatusContextCel(kubernetesRef, context);
+}
+//# sourceMappingURL=status-builder-analyzer.js.map

package/dist/core/expressions/factory/status-builder-analyzer.js.map

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

package/dist/core/expressions/factory/status-builder-types.d.ts

@@ -0,0 +1,166 @@
+/**
+ * Type definitions for the Status Builder Analyzer.
+ *
+ * These types define the interfaces for status builder function analysis,
+ * field-level analysis results, and status field handling strategies.
+ */
+import type { Node as ESTreeNode, ReturnStatement } from 'estree';
+import type { ConversionError } from '../../errors.js';
+import type { CelExpression, KubernetesRef } from '../../types/common.js';
+import type { Enhanced } from '../../types/kubernetes.js';
+import type { SchemaProxy } from '../../types/serialization.js';
+import type { SourceMapEntry } from '../analysis/source-map.js';
+import type { FieldHydrationState, OptionalityAnalysisResult } from '../magic-proxy/optionality-types.js';
+/**
+ * Status builder function type for analysis
+ */
+export type StatusBuilderFunction<TSpec extends Record<string, any> = any, TStatus = any> = (schema: SchemaProxy<TSpec, any>, resources: Record<string, Enhanced<any, any>>) => TStatus;
+/**
+ * Status field analysis result
+ */
+export interface StatusFieldAnalysisResult {
+    /** Field name in the status object */
+    fieldName: string;
+    /** Original JavaScript expression */
+    originalExpression: unknown;
+    /** Converted CEL expression */
+    celExpression: CelExpression | null;
+    /** KubernetesRef dependencies detected */
+    dependencies: KubernetesRef<unknown>[];
+    /** Whether the expression requires conversion */
+    requiresConversion: boolean;
+    /** Whether the expression is valid */
+    valid: boolean;
+    /** Conversion errors */
+    errors: ConversionError[];
+    /** Source mapping entries */
+    sourceMap: SourceMapEntry[];
+    /** Optionality analysis results */
+    optionalityAnalysis: OptionalityAnalysisResult[];
+    /** Type information */
+    inferredType: string | undefined;
+    /** Confidence level of the analysis */
+    confidence: number;
+    /** Static value for object expressions that can be evaluated at compile time */
+    staticValue?: unknown;
+    /** Warnings about patterns that may produce unexpected results */
+    warnings: string[];
+}
+/**
+ * Status builder analysis result
+ */
+export interface StatusBuilderAnalysisResult {
+    /** Analysis results for each status field */
+    fieldAnalysis: Map<string, StatusFieldAnalysisResult>;
+    /** Overall status mappings (field name -> CEL expression or static value) */
+    statusMappings: Record<string, unknown>;
+    /** All KubernetesRef dependencies found */
+    allDependencies: KubernetesRef<unknown>[];
+    /** All resource references */
+    resourceReferences: KubernetesRef<unknown>[];
+    /** All schema references */
+    schemaReferences: KubernetesRef<unknown>[];
+    /** Overall source mapping */
+    sourceMap: SourceMapEntry[];
+    /** All errors encountered */
+    errors: ConversionError[];
+    /** Whether the analysis was successful */
+    valid: boolean;
+    /** Warnings about patterns that may produce unexpected results (e.g., ||/&& with KubernetesRef) */
+    warnings: string[];
+    /** Original status builder function source */
+    originalSource: string;
+    /** Parsed AST of the status builder */
+    ast?: ESTreeNode;
+    /** Return statement analysis */
+    returnStatement?: ReturnStatementAnalysis;
+}
+/**
+ * Return statement analysis
+ */
+export interface ReturnStatementAnalysis {
+    /** The return statement node */
+    node: ReturnStatement;
+    /** Whether it returns an object expression */
+    returnsObject: boolean;
+    /** Properties in the returned object */
+    properties: PropertyAnalysis[];
+    /** Source location information */
+    sourceLocation: {
+        line: number;
+        column: number;
+        length: number;
+    };
+}
+/**
+ * Property analysis for object expressions
+ */
+export interface PropertyAnalysis {
+    /** Property name */
+    name: string;
+    /** Property value node */
+    valueNode: ESTreeNode;
+    /** Property value as string */
+    valueSource: string;
+    /** Whether the property contains KubernetesRef objects */
+    containsKubernetesRefs: boolean;
+    /** Source location */
+    sourceLocation: {
+        line: number;
+        column: number;
+        length: number;
+    };
+}
+/**
+ * Status field handling information
+ */
+export interface StatusFieldHandlingInfo {
+    /** The KubernetesRef being handled */
+    kubernetesRef: KubernetesRef<unknown>;
+    /** Whether this field requires hydration */
+    requiresHydration: boolean;
+    /** Whether this field is optional */
+    isOptional: boolean;
+    /** Handling strategy for this field */
+    strategy: StatusHandlingStrategy;
+    /** Priority for evaluation (lower = higher priority) */
+    priority: number;
+    /** Category of the status field */
+    fieldCategory: StatusFieldCategory;
+    /** Expected availability timing */
+    expectedAvailability: FieldAvailabilityEstimate;
+}
+/**
+ * Status handling strategy
+ */
+export type StatusHandlingStrategy = 'direct-access' | 'null-safety-only' | 'hydration-required' | 'hydration-with-null-safety';
+/**
+ * Status field category
+ */
+export type StatusFieldCategory = 'readiness-indicator' | 'condition-status' | 'replica-status' | 'network-status' | 'lifecycle-status' | 'general-status';
+/**
+ * Field availability estimate
+ */
+export type FieldAvailabilityEstimate = 'immediate' | 'delayed' | 'very-delayed';
+/**
+ * Options for status builder analysis
+ */
+export interface StatusBuilderAnalysisOptions {
+    /** Whether to perform deep analysis */
+    deepAnalysis?: boolean;
+    /** Whether to include source mapping */
+    includeSourceMapping?: boolean;
+    /** Whether to validate resource references */
+    validateReferences?: boolean;
+    /** Whether to perform optionality analysis */
+    performOptionalityAnalysis?: boolean;
+    /** Factory type for CEL generation */
+    factoryType?: 'direct' | 'kro';
+    /** Maximum analysis depth */
+    maxDepth?: number;
+    /** Field hydration states for optionality analysis */
+    hydrationStates?: Map<string, FieldHydrationState>;
+    /** Whether to use conservative null-safety */
+    conservativeNullSafety?: boolean;
+}
+//# sourceMappingURL=status-builder-types.d.ts.map

package/dist/core/expressions/factory/status-builder-types.d.ts.map

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

package/dist/core/expressions/factory/status-builder-types.js

@@ -0,0 +1,8 @@
+/**
+ * Type definitions for the Status Builder Analyzer.
+ *
+ * These types define the interfaces for status builder function analysis,
+ * field-level analysis results, and status field handling strategies.
+ */
+export {};
+//# sourceMappingURL=status-builder-types.js.map

package/dist/core/expressions/factory/status-builder-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"status-builder-types.js","sourceRoot":"","sources":["../../../../src/core/expressions/factory/status-builder-types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/core/expressions/factory/status-cel-generation.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Status CEL Generation — Status context-specific CEL expression generation
+ *
+ * Extracted from status-builder-analyzer.ts. Contains methods for generating
+ * CEL expressions with status-specific transformations, including null-safety,
+ * hydration handling, field categorization, and type inference.
+ */
+import type { CelExpression, KubernetesRef } from '../../types/common.js';
+import type { OptionalityContext } from '../magic-proxy/optionality-handler.js';
+import type { FieldAvailabilityEstimate, StatusFieldCategory, StatusFieldHandlingInfo } from './status-builder-types.js';
+/**
+ * Convert static values (no KubernetesRef objects) to CEL expressions
+ */
+export declare function convertStaticValueToCel(value: unknown): CelExpression;
+/**
+ * Create a CelExpression for a static value
+ */
+export declare function createStaticCelExpression(value: string): CelExpression;
+/**
+ * Generate fallback status CEL expression
+ */
+export declare function generateFallbackStatusCel(kubernetesRef: KubernetesRef<unknown>): CelExpression;
+/**
+ * Generate advanced status context CEL with full feature support
+ */
+export declare function generateStatusContextCelWithAdvancedFeatures(kubernetesRef: KubernetesRef<unknown>, context: OptionalityContext): CelExpression;
+/**
+ * Analyze status field handling requirements
+ */
+export declare function analyzeStatusFieldHandlingRequirements(kubernetesRef: KubernetesRef<unknown>, context: OptionalityContext): StatusFieldHandlingInfo;
+/**
+ * Apply status context-specific transformations to CEL expression
+ */
+export declare function applyStatusContextTransformations(baseCelExpression: string, handlingInfo: StatusFieldHandlingInfo, context: OptionalityContext): string;
+/**
+ * Apply hydration with null-safety transformation
+ */
+export declare function applyHydrationWithNullSafety(baseCelExpression: string, context: OptionalityContext): string;
+/**
+ * Apply hydration required transformation
+ */
+export declare function applyHydrationRequired(baseCelExpression: string, handlingInfo: StatusFieldHandlingInfo): string;
+/**
+ * Apply null-safety only transformation
+ */
+export declare function applyNullSafetyOnly(baseCelExpression: string, context: OptionalityContext): string;
+/**
+ * Check if a field is optional in status context
+ */
+export declare function isFieldOptionalInStatusContext(kubernetesRef: KubernetesRef<unknown>): boolean;
+/**
+ * Calculate priority for status field evaluation
+ */
+export declare function calculateStatusFieldPriority(kubernetesRef: KubernetesRef<unknown>): number;
+/**
+ * Categorize status field type
+ */
+export declare function categorizeStatusField(fieldPath: string): StatusFieldCategory;
+/**
+ * Estimate field availability timing
+ */
+export declare function estimateFieldAvailability(kubernetesRef: KubernetesRef<unknown>): FieldAvailabilityEstimate;
+/**
+ * Infer the type of a status field
+ */
+export declare function inferStatusFieldType(kubernetesRef: KubernetesRef<unknown>): string;
+//# sourceMappingURL=status-cel-generation.d.ts.map

package/dist/core/expressions/factory/status-cel-generation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status-cel-generation.d.ts","sourceRoot":"","sources":["../../../../src/core/expressions/factory/status-cel-generation.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC1E,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,uCAAuC,CAAC;AAChF,OAAO,KAAK,EACV,yBAAyB,EACzB,mBAAmB,EACnB,uBAAuB,EAExB,MAAM,2BAA2B,CAAC;AAInC;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,OAAO,GAAG,aAAa,CAwCrE;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,MAAM,GAAG,aAAa,CAKtE;AAID;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,aAAa,EAAE,aAAa,CAAC,OAAO,CAAC,GAAG,aAAa,CAW9F;AAID;;GAEG;AACH,wBAAgB,4CAA4C,CAC1D,aAAa,EAAE,aAAa,CAAC,OAAO,CAAC,EACrC,OAAO,EAAE,kBAAkB,GAC1B,aAAa,CAoCf;AAID;;GAEG;AACH,wBAAgB,sCAAsC,CACpD,aAAa,EAAE,aAAa,CAAC,OAAO,CAAC,EACrC,OAAO,EAAE,kBAAkB,GAC1B,uBAAuB,CAmCzB;AAID;;GAEG;AACH,wBAAgB,iCAAiC,CAC/C,iBAAiB,EAAE,MAAM,EACzB,YAAY,EAAE,uBAAuB,EACrC,OAAO,EAAE,kBAAkB,GAC1B,MAAM,CAsBR;AAED;;GAEG;AACH,wBAAgB,4BAA4B,CAC1C,iBAAiB,EAAE,MAAM,EACzB,OAAO,EAAE,kBAAkB,GAC1B,MAAM,CAkBR;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,iBAAiB,EAAE,MAAM,EACzB,YAAY,EAAE,uBAAuB,GACpC,MAAM,CAOR;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,iBAAiB,EAAE,MAAM,EACzB,OAAO,EAAE,kBAAkB,GAC1B,MAAM,CAMR;AAID;;GAEG;AACH,wBAAgB,8BAA8B,CAAC,aAAa,EAAE,aAAa,CAAC,OAAO,CAAC,GAAG,OAAO,CA4B7F;AAED;;GAEG;AACH,wBAAgB,4BAA4B,CAAC,aAAa,EAAE,aAAa,CAAC,OAAO,CAAC,GAAG,MAAM,CAyB1F;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,MAAM,GAAG,mBAAmB,CAsB5E;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,aAAa,EAAE,aAAa,CAAC,OAAO,CAAC,GACpC,yBAAyB,CAwB3B;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,aAAa,EAAE,aAAa,CAAC,OAAO,CAAC,GAAG,MAAM,CAwBlF"}