typekro 0.4.0 → 0.5.0

package/dist/core/expressions/{parser.d.ts → analysis/parser.d.ts}

@@ -13,36 +13,9 @@
  *
  * @module parser
  */
-import { type Options } from 'acorn';
 import type { Node as ESTreeNode } from 'estree';
-/**
- * Custom error class for parser errors with enhanced information
- */
-export declare class ParserError extends Error {
-    /** Line number where the error occurred (1-indexed) */
-    readonly line: number;
-    /** Column number where the error occurred (0-indexed) */
-    readonly column: number;
-    /** The original expression that failed to parse */
-    readonly originalExpression: string;
-    /** Suggestions for fixing the error */
-    readonly suggestions: string[];
-    constructor(message: string, line: number, column: number, originalExpression: string, suggestions?: string[]);
-    /**
-     * Create a ParserError from an acorn SyntaxError
-     */
-    static fromAcornError(error: SyntaxError & {
-        loc?: {
-            line: number;
-            column: number;
-        };
-        pos?: number;
-    }, expression: string): ParserError;
-    /**
-     * Format the error with context for debugging
-     */
-    toDetailedString(): string;
-}
+import { DEFAULT_PARSER_OPTIONS, ParserError } from './parse-core.js';
+export { DEFAULT_PARSER_OPTIONS, ParserError };
 /**
  * Options for parsing expressions
  */
@@ -67,15 +40,6 @@ export interface ParseResult {
     /** Whether parsing was successful */
     success: boolean;
 }
-/**
- * Default parser options for TypeKro expression analysis
- *
- * These options provide:
- * - ES2022 support for modern syntax (optional chaining, nullish coalescing)
- * - Location information for error reporting
- * - Range information for source mapping
- */
-export declare const DEFAULT_PARSER_OPTIONS: Options;
 /**
  * Parse a JavaScript expression using acorn
  *

package/dist/core/expressions/analysis/parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../../../src/core/expressions/analysis/parser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAGH,OAAO,KAAK,EAAE,IAAI,IAAI,UAAU,EAAE,MAAM,QAAQ,CAAC;AAEjD,OAAO,EAAE,sBAAsB,EAAE,WAAW,EAAmB,MAAM,iBAAiB,CAAC;AAGvF,OAAO,EAAE,sBAAsB,EAAE,WAAW,EAAE,CAAC;AAE/C;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,qDAAqD;IACrD,UAAU,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAEjC,2DAA2D;IAC3D,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB,wDAAwD;IACxD,MAAM,CAAC,EAAE,OAAO,CAAC;IAEjB,gDAAgD;IAChD,WAAW,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,QAAQ,CAAC;CAChF;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,8CAA8C;IAC9C,GAAG,EAAE,UAAU,GAAG,IAAI,CAAC;IAEvB,+BAA+B;IAC/B,MAAM,EAAE,WAAW,EAAE,CAAC;IAEtB,qCAAqC;IACrC,OAAO,EAAE,OAAO,CAAC;CAClB;AA2BD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,eAAe,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,UAAU,CAmDtF;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,WAAW,CAuB3F;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CAG5E;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,UAAU,CAG9E;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,WAAW,CAuBnF"}

package/dist/core/expressions/{parser.js → analysis/parser.js}

@@ -14,77 +14,24 @@
  * @module parser
  */
 import { Parser } from 'acorn';
+import { validateFnToStringEnvironment } from './fn-toString-self-test.js';
+import { DEFAULT_PARSER_OPTIONS, ParserError, parseScriptCore } from './parse-core.js';
+// Re-export for backward compatibility — consumers import these from parser
+export { DEFAULT_PARSER_OPTIONS, ParserError };
 /**
- * Custom error class for parser errors with enhanced information
- */
-export class ParserError extends Error {
-    /** Line number where the error occurred (1-indexed) */
-    line;
-    /** Column number where the error occurred (0-indexed) */
-    column;
-    /** The original expression that failed to parse */
-    originalExpression;
-    /** Suggestions for fixing the error */
-    suggestions;
-    constructor(message, line, column, originalExpression, suggestions = []) {
-        super(message);
-        this.name = 'ParserError';
-        this.line = line;
-        this.column = column;
-        this.originalExpression = originalExpression;
-        this.suggestions = suggestions;
-        // Maintain proper stack trace in V8 environments
-        if (Error.captureStackTrace) {
-            Error.captureStackTrace(this, ParserError);
-        }
-    }
-    /**
-     * Create a ParserError from an acorn SyntaxError
-     */
-    static fromAcornError(error, expression) {
-        const line = error.loc?.line ?? 1;
-        const column = error.loc?.column ?? 0;
-        const suggestions = [
-            'Check for syntax errors in your expression',
-            'Consider using the explicit Cel API: Cel.expr(), Cel.template(), Cel.conditional()',
-            'Ensure all brackets and parentheses are balanced',
-            'Verify that all string literals are properly quoted',
-        ];
-        const enhancedMessage = `Parse error at line ${line}, column ${column}: ${error.message}`;
-        return new ParserError(enhancedMessage, line, column, expression, suggestions);
-    }
-    /**
-     * Format the error with context for debugging
-     */
-    toDetailedString() {
-        const lines = [
-            `ParserError: ${this.message}`,
-            `  at line ${this.line}, column ${this.column}`,
-            `  Expression: ${this.originalExpression.substring(0, 100)}${this.originalExpression.length > 100 ? '...' : ''}`,
-        ];
-        if (this.suggestions.length > 0) {
-            lines.push('  Suggestions:');
-            for (const suggestion of this.suggestions) {
-                lines.push(`    - ${suggestion}`);
-            }
-        }
-        return lines.join('\n');
-    }
-}
-/**
- * Default parser options for TypeKro expression analysis
+ * Lazy one-time validation of fn.toString() environment.
  *
- * These options provide:
- * - ES2022 support for modern syntax (optional chaining, nullish coalescing)
- * - Location information for error reporting
- * - Range information for source mapping
+ * Called on the first parse operation to detect incompatible build configurations
+ * (mangling, dead code elimination, etc.) before they cause subtle analysis failures.
+ * Subsequent calls are no-ops.
  */
-export const DEFAULT_PARSER_OPTIONS = {
-    ecmaVersion: 2022,
-    sourceType: 'script',
-    locations: true,
-    ranges: true,
-};
+let fnToStringValidated = false;
+function ensureFnToStringValidated() {
+    if (fnToStringValidated)
+        return;
+    fnToStringValidated = true;
+    validateFnToStringEnvironment();
+}
 /**
  * Merge user options with default options
  */
@@ -118,6 +65,7 @@ function mergeOptions(userOptions) {
  * ```
  */
 export function parseExpression(expression, options) {
+    ensureFnToStringValidated();
     const mergedOptions = mergeOptions(options);
     try {
         // First try parsing as a standalone expression wrapped in parentheses
@@ -133,7 +81,7 @@ export function parseExpression(expression, options) {
         if (firstBody) {
             return firstBody;
         }
-        throw new Error('Failed to extract expression from parsed AST');
+        throw new ParserError('Failed to extract expression from parsed AST', 1, 0, expression);
     }
     catch (error) {
         // Try parsing without wrapping (for statements or complex expressions)
@@ -146,7 +94,7 @@ export function parseExpression(expression, options) {
                 }
                 return firstStatement;
             }
-            throw new Error('Empty AST body');
+            throw new ParserError('Empty AST body', 1, 0, expression);
         }
         catch {
             // Use the original error for better error messages
@@ -231,16 +179,8 @@ export function canParse(expression, options) {
  * @throws ParserError if parsing fails
  */
 export function parseScript(source, options) {
-    const mergedOptions = mergeOptions(options);
-    try {
-        return Parser.parse(source, mergedOptions);
-    }
-    catch (error) {
-        if (error instanceof SyntaxError) {
-            throw ParserError.fromAcornError(error, source);
-        }
-        throw error;
-    }
+    ensureFnToStringValidated();
+    return parseScriptCore(source, options);
 }
 /**
  * Parse a complete JavaScript program/script with error handling

package/dist/core/expressions/analysis/parser.js.map

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

package/dist/core/expressions/analysis/scope-resolver.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Scope Resolver — Dependency extraction and resource reference resolution
+ *
+ * Extracted from analyzer.ts. Contains all methods that extract KubernetesRef
+ * dependencies from expression strings, resolve resource/schema references,
+ * and generate CEL field paths from KubernetesRef objects.
+ */
+import type { CelExpression, KubernetesRef } from '../../types/common.js';
+import type { Enhanced } from '../../types/kubernetes.js';
+import type { SchemaProxy } from '../../types/serialization.js';
+import type { AnalysisContext, CelConversionResult } from './shared-types.js';
+export { isResourceReference } from './cel-emitter.js';
+/**
+ * Generate CEL expression from KubernetesRef based on context.
+ * Handles the core KubernetesRef to CEL field path conversion (resourceId.fieldPath).
+ */
+export declare function generateCelFromKubernetesRef(ref: KubernetesRef<unknown>, context: AnalysisContext): string;
+/**
+ * Convert a KubernetesRef directly to a CEL expression.
+ * This is the main method for KubernetesRef to CEL field path conversion.
+ */
+export declare function convertKubernetesRefToCel(ref: KubernetesRef<unknown>, context: AnalysisContext, typeValidator?: {
+    validateKubernetesRef: (ref: KubernetesRef<unknown>, availableReferences: Record<string, Enhanced<unknown, unknown>>, schemaProxy?: SchemaProxy<Record<string, unknown>, Record<string, unknown>>) => {
+        valid: boolean;
+        errors: {
+            message: string;
+        }[];
+    };
+}): CelExpression;
+/**
+ * Extract resource reference strings from an expression.
+ * Returns array of strings like "deployment.status.readyReplicas".
+ */
+export declare function extractResourceReferencesFromExpression(expression: string): string[];
+/**
+ * Extract dependencies from JavaScript expression string and return them.
+ * Looks for resource references and schema references in the expression text.
+ */
+export declare function extractDependenciesFromExpressionString(expression: string, context: AnalysisContext): KubernetesRef<unknown>[];
+/**
+ * Extract dependencies from JavaScript expression and add them to context.dependencies.
+ * This is the mutation-based variant used by the special case handlers.
+ */
+export declare function extractDependenciesFromExpression(expression: string, context: AnalysisContext): void;
+/**
+ * Handle optional chaining expressions.
+ */
+export declare function handleOptionalChainingExpression(expression: string, context: AnalysisContext): CelConversionResult;
+/**
+ * Handle expressions with both optional chaining and nullish coalescing.
+ */
+export declare function handleMixedOptionalAndNullishExpression(expression: string, context: AnalysisContext): CelConversionResult;
+/**
+ * Handle nullish coalescing expressions.
+ */
+export declare function handleNullishCoalescingExpression(expression: string, context: AnalysisContext): CelConversionResult;
+//# sourceMappingURL=scope-resolver.d.ts.map

package/dist/core/expressions/analysis/scope-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scope-resolver.d.ts","sourceRoot":"","sources":["../../../../src/core/expressions/analysis/scope-resolver.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC1E,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAC1D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAGhE,OAAO,KAAK,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAI9E,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAIvD;;;GAGG;AACH,wBAAgB,4BAA4B,CAC1C,GAAG,EAAE,aAAa,CAAC,OAAO,CAAC,EAC3B,OAAO,EAAE,eAAe,GACvB,MAAM,CAwBR;AAID;;;GAGG;AACH,wBAAgB,yBAAyB,CACvC,GAAG,EAAE,aAAa,CAAC,OAAO,CAAC,EAC3B,OAAO,EAAE,eAAe,EACxB,aAAa,CAAC,EAAE;IACd,qBAAqB,EAAE,CACrB,GAAG,EAAE,aAAa,CAAC,OAAO,CAAC,EAC3B,mBAAmB,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,EAC/D,WAAW,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,KACxE;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE;YAAE,OAAO,EAAE,MAAM,CAAA;SAAE,EAAE,CAAA;KAAE,CAAC;CACxD,GACA,aAAa,CAsCf;AAID;;;GAGG;AACH,wBAAgB,uCAAuC,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,EAAE,CAcpF;AAID;;;GAGG;AACH,wBAAgB,uCAAuC,CACrD,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,eAAe,GACvB,aAAa,CAAC,OAAO,CAAC,EAAE,CAiE1B;AAID;;;GAGG;AACH,wBAAgB,iCAAiC,CAC/C,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,eAAe,GACvB,IAAI,CAuJN;AAID;;GAEG;AACH,wBAAgB,gCAAgC,CAC9C,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,eAAe,GACvB,mBAAmB,CAoErB;AAED;;GAEG;AACH,wBAAgB,uCAAuC,CACrD,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,eAAe,GACvB,mBAAmB,CAmErB;AAED;;GAEG;AACH,wBAAgB,iCAAiC,CAC/C,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,eAAe,GACvB,mBAAmB,CAmErB"}