typekro 0.2.2 → 0.3.1

package/dist/core/expressions/context-switcher.d.ts

@@ -0,0 +1,185 @@
+/**
+ * Context Switching for Nested Expressions with KubernetesRef Objects
+ *
+ * This module provides functionality to handle context switching when analyzing
+ * nested JavaScript expressions that contain KubernetesRef objects, ensuring
+ * that each part of a complex expression is converted using the appropriate context.
+ */
+import type { CelExpression, KubernetesRef } from '../types/common.js';
+import type { Enhanced } from '../types/kubernetes.js';
+import type { SchemaProxy } from '../types/serialization.js';
+import type { ExpressionContext, ExpressionContextDetector } from './context-detector.js';
+import type { ContextAwareCelGenerator } from './context-aware-generator.js';
+import type { ContextExpressionValidator, ContextValidationReport } from './context-validator.js';
+/**
+ * Context switching configuration
+ */
+export interface ContextSwitchingConfig {
+    /** Primary context for the expression */
+    primaryContext: ExpressionContext;
+    /** Available resources for context analysis */
+    availableResources?: Record<string, Enhanced<any, any>>;
+    /** Schema proxy for schema field analysis */
+    schemaProxy?: SchemaProxy<any, any>;
+    /** Factory type being used */
+    factoryType?: 'direct' | 'kro';
+    /** Whether to enable automatic context detection */
+    autoDetectContext?: boolean;
+    /** Whether to validate context switches */
+    validateContextSwitches?: boolean;
+    /** Maximum nesting depth to analyze */
+    maxNestingDepth?: number;
+    /** Whether to optimize context switches */
+    optimizeContextSwitches?: boolean;
+    /** Custom context detection rules */
+    customContextRules?: ContextSwitchingRule[];
+}
+/**
+ * Context switching rule
+ */
+export interface ContextSwitchingRule {
+    /** Rule identifier */
+    id: string;
+    /** Rule name */
+    name: string;
+    /** When this rule should be applied */
+    condition: (expression: any, currentContext: ExpressionContext, parentContext: ExpressionContext, depth: number) => boolean;
+    /** What context to switch to */
+    targetContext: ExpressionContext;
+    /** Priority of this rule (higher = more important) */
+    priority: number;
+}
+/**
+ * Context switch point in an expression
+ */
+export interface ContextSwitchPoint {
+    /** Path to the expression part that needs context switching */
+    path: string[];
+    /** Current context */
+    currentContext: ExpressionContext;
+    /** Target context */
+    targetContext: ExpressionContext;
+    /** Reason for the context switch */
+    reason: string;
+    /** Expression part that triggered the switch */
+    expression: any;
+    /** KubernetesRef objects in this part */
+    kubernetesRefs: KubernetesRef<any>[];
+    /** Nesting depth */
+    depth: number;
+}
+/**
+ * Context switching result
+ */
+export interface ContextSwitchingResult {
+    /** Original expression */
+    originalExpression: any;
+    /** Primary context used */
+    primaryContext: ExpressionContext;
+    /** Context switch points found */
+    switchPoints: ContextSwitchPoint[];
+    /** Generated CEL expressions by context */
+    celExpressions: Map<string, CelExpression>;
+    /** Final combined CEL expression */
+    finalCelExpression: CelExpression;
+    /** All dependencies found */
+    allDependencies: KubernetesRef<any>[];
+    /** Validation reports by context */
+    validationReports: Map<ExpressionContext, ContextValidationReport>;
+    /** Warnings generated during context switching */
+    warnings: string[];
+    /** Performance metrics */
+    performanceMetrics?: ContextSwitchingMetrics;
+}
+/**
+ * Performance metrics for context switching
+ */
+export interface ContextSwitchingMetrics {
+    /** Total analysis time */
+    totalTimeMs: number;
+    /** Time spent on context detection */
+    contextDetectionTimeMs: number;
+    /** Time spent on CEL generation */
+    celGenerationTimeMs: number;
+    /** Time spent on validation */
+    validationTimeMs: number;
+    /** Number of context switches performed */
+    contextSwitchCount: number;
+    /** Maximum nesting depth reached */
+    maxDepthReached: number;
+}
+/**
+ * Context switcher for nested expressions
+ */
+export declare class ExpressionContextSwitcher {
+    private contextDetector;
+    private celGenerator;
+    private validator;
+    constructor(contextDetector: ExpressionContextDetector, celGenerator: ContextAwareCelGenerator, validator: ContextExpressionValidator);
+    /**
+     * Analyze and convert a nested expression with context switching
+     */
+    analyzeWithContextSwitching(expression: any, config: ContextSwitchingConfig): ContextSwitchingResult;
+    /**
+     * Find context switch points in a nested expression
+     */
+    private findContextSwitchPoints;
+    /**
+     * Analyze string expressions for context switching patterns
+     */
+    private analyzeStringExpression;
+    /**
+     * Parse template literal into parts
+     */
+    private parseTemplateLiteral;
+    /**
+     * Parse conditional expression
+     */
+    private parseConditionalExpression;
+    /**
+     * Find matching closing brace
+     */
+    private findMatchingBrace;
+    /**
+     * Group switch points by context
+     */
+    private groupSwitchPointsByContext;
+    /**
+     * Determine CEL generation strategy for context
+     */
+    private determineCelStrategy;
+    /**
+     * Combine CEL expressions from different contexts
+     */
+    private combineCelExpressions;
+    /**
+     * Extract KubernetesRef objects from expression
+     */
+    private extractKubernetesRefs;
+    /**
+     * Recursively extract KubernetesRef objects
+     */
+    private recursivelyExtractRefs;
+}
+/**
+ * Context switching utilities
+ */
+export declare class ContextSwitchingUtils {
+    /**
+     * Create default context switching rules
+     */
+    static createDefaultRules(): ContextSwitchingRule[];
+    /**
+     * Optimize context switching configuration
+     */
+    static optimizeConfig(config: ContextSwitchingConfig): ContextSwitchingConfig;
+    /**
+     * Analyze context switching performance
+     */
+    static analyzePerformance(result: ContextSwitchingResult): string;
+}
+/**
+ * Create a context switcher with default dependencies
+ */
+export declare function createContextSwitcher(contextDetector: ExpressionContextDetector, celGenerator: ContextAwareCelGenerator, validator: ContextExpressionValidator): ExpressionContextSwitcher;
+//# sourceMappingURL=context-switcher.d.ts.map

package/dist/core/expressions/context-switcher.d.ts.map

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