typekro 0.4.0 → 0.7.0

package/dist/core/references/cel.js

@@ -1,19 +1,93 @@
-import { getInnerCelPath, isCelExpression, isKubernetesRef } from '../../utils/index';
+import { isCelExpression, isKubernetesRef } from '../../utils/type-guards.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];
+import { TypeKroError } from '../errors.js';
+import { getComponentLogger } from '../logging/index.js';
+import { getInnerCelPath } from '../serialization/cel-references.js';
+const logger = getComponentLogger('cel');
+/**
+ * Escape a string for safe embedding in a CEL string literal.
+ * Prevents CEL injection by escaping backslashes first, then double quotes.
+ */
+function escapeCelString(value) {
+    return value.replace(/\\/g, '\\\\').replace(/"/g, '\\"');
+}
+/** Patterns that indicate raw JavaScript operators were used instead of CEL operators.
+ * Note: && and || are valid CEL operators, so only === and !== are flagged. */
+const SUSPICIOUS_JS_PATTERNS = [/===/, /!==/];
+/**
+ * Regex matching string parts that look like CEL operators but lack a leading space.
+ * Matches strings starting with >, <, ==, !=, >=, <=, &&, ||, +, -, *, / followed
+ * by a space character. The trailing space distinguishes operator-like strings
+ * (e.g., `'> 0'` meant as `' > 0'`) from string suffixes (e.g., `'-db'`).
+ * Does NOT match strings starting with a space (correct usage) or
+ * method-call-style strings like '.exists(...)'.
+ */
+const MISSING_LEADING_SPACE = /^(?:>=|<=|==|!=|&&|\|\||[><!+\-*/]) /;
+/**
+ * Validates inputs to Cel.expr() and warns about suspicious patterns.
+ * @throws {TypeKroError} if inputs are null, undefined, or empty strings
+ */
+function validateExprParts(parts) {
+    for (let i = 0; i < parts.length; i++) {
+        const part = parts[i];
+        if (part === null || part === undefined) {
+            throw new TypeKroError(`Cel.expr() received ${part === null ? 'null' : 'undefined'} at argument index ${i}. ` +
+                'All parts must be valid values (string, number, boolean, KubernetesRef, or CelExpression).', 'CEL_INVALID_INPUT');
+        }
+        if (typeof part === 'string') {
+            if (part.length === 0) {
+                throw new TypeKroError(`Cel.expr() received an empty string at argument index ${i}. ` +
+                    'Use a non-empty CEL expression or literal value.', 'CEL_INVALID_INPUT');
+            }
+            for (const pattern of SUSPICIOUS_JS_PATTERNS) {
+                if (pattern.test(part)) {
+                    throw new TypeKroError(`Cel.expr() argument at index ${i} contains JavaScript operator '${pattern.source}' which is not valid in CEL. ` +
+                        'Use CEL equivalents instead: === -> ==, !== -> !=.', 'CEL_INVALID_JS_OPERATOR');
+                }
+            }
+            // Warn about missing leading space in operator parts.
+            // Only check parts after the first one — the first part is often a standalone
+            // CEL expression (e.g., 'true', '1 > 0') where a leading space makes no sense.
+            if (i > 0 && MISSING_LEADING_SPACE.test(part)) {
+                logger.warn(`Cel.expr() operator string at argument index ${i} is missing a leading space. ` +
+                    `Got "${part}" — did you mean " ${part}"? Without the space, the generated CEL ` +
+                    'expression will concatenate the operator directly against the previous token, ' +
+                    'producing invalid CEL (e.g., "field> 0" instead of "field > 0").', {
+                    argumentIndex: i,
+                    input: part,
+                });
+            }
+        }
     }
-    const celParts = actualParts.map((part) => {
+}
+/**
+ * Build a CEL expression from parts. Accepts resource references (`schema.spec.*`,
+ * `resources.*.status.*`), other CEL expressions, and literal strings/numbers/booleans.
+ * Parts are concatenated directly (no spaces). Use `Cel.join` for spaced joining.
+ *
+ * The type parameter `T` constrains what the expression evaluates to at runtime,
+ * ensuring type safety through the serialization pipeline.
+ *
+ * @typeParam T - The CEL expression's result type (e.g., `boolean`, `string`, `number`)
+ *
+ * @example Status readiness check
+ * ```typescript
+ * ready: Cel.expr<boolean>(resources.deployment.status.readyReplicas, ' > 0')
+ * ```
+ *
+ * @example Conditional phase
+ * ```typescript
+ * phase: Cel.expr<string>(resources.helm.status.phase, ' == "Ready" ? "Ready" : "Installing"')
+ * ```
+ *
+ * @example Static value (backtick + quotes)
+ * ```typescript
+ * phase: Cel.expr<string>`'running'`
+ * ```
+ */
+function expr(...parts) {
+    validateExprParts(parts);
+    const celParts = parts.map((part) => {
         if (isKubernetesRef(part)) {
             // Use inner reference without ${} wrapper for building expressions
             return getInnerCelPath(part);
@@ -36,57 +110,32 @@ function expr(contextOrFirstPart, ...parts) {
         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];
-    }
+/**
+ * Convenience method for joining parts with automatic spacing.
+ * Useful for building readable CEL expressions.
+ */
+function join(...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) {
+    for (let i = 0; i < parts.length; i++) {
+        spacedParts.push(parts[i]);
+        if (i < parts.length - 1) {
             spacedParts.push(' ');
         }
     }
-    // Pass the generic type <T> to the expr call
-    return context ? expr(context, ...spacedParts) : expr(...spacedParts);
+    return 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);
-    }
+/**
+ * Creates a conditional CEL expression: condition ? trueValue : falseValue
+ */
+function conditional(condition, trueValue, falseValue) {
+    return expr(condition, ' ? ', trueValue, ' : ', falseValue);
 }
-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) => {
+/**
+ * Creates a CEL expression for mathematical operations
+ */
+function math(operation, ...operands) {
+    const operandStrings = operands.map((op) => {
         if (isKubernetesRef(op)) {
             return getInnerCelPath(op);
         }
@@ -95,32 +144,24 @@ function math(contextOrOperation, operationOrFirstOperand, ...operands) {
         }
         return String(op);
     });
-    const result = context
-        ? expr(context, `${operation}(${operandStrings.join(', ')})`)
-        : expr(`${operation}(${operandStrings.join(', ')})`);
-    return result;
+    return expr(`${operation}(${operandStrings.join(', ')})`);
 }
-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;
-    }
+/**
+ * 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}"
+ */
+function template(templateString, ...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 (valueIndex < values.length) {
+            const value = values[valueIndex++];
             if (isKubernetesRef(value)) {
                 // For KubernetesRef, create a ${...} placeholder
                 return `\${${getInnerCelPath(value)}}`;
@@ -129,8 +170,13 @@ function template(contextOrTemplateString, templateStringOrFirstValue, ...values
                 // For CEL expressions, wrap in ${...}
                 return `\${${value.expression}}`;
             }
-            // For literal values, just insert them directly
-            return String(value);
+            // For literal values, escape any ${...} sequences that could be
+            // misinterpreted as CEL expression placeholders during serialization.
+            // Defense-in-depth: user-supplied strings may contain "${" (e.g. shell
+            // script snippets). Escaping here prevents the serializer from treating
+            // them as CEL injection points. This is intentionally kept even if no
+            // caller currently passes such strings.
+            return String(value).replace(/\$\{/g, '\\${');
         }
         return '%s';
     });
@@ -141,20 +187,17 @@ function template(contextOrTemplateString, templateStringOrFirstValue, ...values
         __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) => {
+/**
+ * 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
+ */
+function concat(...parts) {
+    const celParts = parts.map((part) => {
         if (isKubernetesRef(part)) {
             return getInnerCelPath(part);
         }
@@ -162,14 +205,14 @@ function concat(contextOrFirstPart, ...parts) {
             return part.expression;
         }
         if (typeof part === 'string') {
-            // Quote string literals for CEL
-            return `"${part}"`;
+            // Quote string literals for CEL, escaping special characters
+            return `"${escapeCelString(part)}"`;
         }
         if (typeof part === 'number' || typeof part === 'boolean') {
             return String(part);
         }
         // For other types, convert to string and quote
-        return `"${String(part)}"`;
+        return `"${escapeCelString(String(part))}"`;
     });
     const expression = celParts.join(' + ');
     return {
@@ -192,7 +235,7 @@ function cel(strings, ...values) {
     for (let i = 0; i < strings.length; i++) {
         // Add the string literal part
         if (strings[i]) {
-            parts.push(`"${strings[i]?.replace(/"/g, '\\"')}"`);
+            parts.push(`"${escapeCelString(strings[i] ?? '')}"`);
         }
         // Add the interpolated value if it exists
         if (i < values.length) {
@@ -210,7 +253,7 @@ function cel(strings, ...values) {
                 parts.push(value.expression);
             }
             else if (typeof value === 'string') {
-                parts.push(`"${value.replace(/"/g, '\\"')}"`);
+                parts.push(`"${escapeCelString(value)}"`);
             }
             else {
                 parts.push(String(value));
@@ -225,7 +268,32 @@ function cel(strings, ...values) {
     };
 }
 /**
- * CEL utility functions
+ * CEL (Common Expression Language) utilities for building type-safe expressions
+ * in resource graph status builders.
+ *
+ * In Kro mode, CEL expressions are serialized into the RGD YAML and evaluated
+ * by the Kro operator at runtime. In Direct mode, they are evaluated locally
+ * using the `cel-js` library.
+ *
+ * @example Basic usage
+ * ```typescript
+ * import { Cel } from 'typekro';
+ *
+ * // Boolean expression
+ * ready: Cel.expr<boolean>(resources.deploy.status.readyReplicas, ' > 0')
+ *
+ * // String template with %s placeholders
+ * url: Cel.template('https://%s/api', schema.spec.hostname)
+ *
+ * // Tagged template literal
+ * greeting: Cel.tag`Hello ${schema.spec.name}`
+ *
+ * // Conditional
+ * phase: Cel.conditional(resources.deploy.status.readyReplicas, '"Ready"', '"Pending"')
+ *
+ * // CEL built-in functions
+ * count: Cel.size(resources.deploy.status.readyReplicas)
+ * ```
  */
 export const Cel = {
     expr,
@@ -234,29 +302,28 @@ export const Cel = {
     math,
     template,
     concat,
-    cel,
+    /** Tagged template literal for CEL expressions. Alias: standalone `cel` export. */
+    tag: cel,
+    // Typed convenience methods — pre-bound type parameters for Cel.expr
+    /** Create a boolean CEL expression. Shorthand for Cel.expr<boolean>(...). */
+    boolean: (...parts) => expr(...parts),
+    /** Create a string CEL expression. Shorthand for Cel.expr<string>(...). */
+    str: (...parts) => expr(...parts),
+    /** Create a number CEL expression. Shorthand for Cel.expr<number>(...). */
+    number: (...parts) => expr(...parts),
     // Common CEL functions as utilities
+    /** CEL `min()` — returns the smallest of the given values. */
     min: (...values) => math('min', ...values),
+    /** CEL `max()` — returns the largest of the given values. */
     max: (...values) => math('max', ...values),
+    /** CEL `size()` — returns the length of a list, map, or string. */
     size: (collection) => math('size', collection),
+    /** CEL `string()` — converts a value to its string representation. */
     string: (value) => math('string', value),
+    /** CEL `int()` — converts a value to an integer. */
     int: (value) => math('int', value),
+    /** CEL `double()` — converts a value to a floating-point number. */
     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),
-    }),
 };
 // Export cel as a standalone function for template literal usage
 export { cel };

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

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

@@ -3,35 +3,55 @@
  *
  * This module provides functionality to create external references to CRD instances
  * for composition between ResourceGraphDefinitions.
+ *
+ * Supports two calling conventions:
+ * 1. Positional: externalRef(apiVersion, kind, instanceName, namespace?)
+ * 2. Object-form: externalRef({ apiVersion, kind, metadata: { name, namespace? } })
  */
 import type { Enhanced } from '../types.js';
 /**
- * Create external reference to CRD instance for composition between ResourceGraphDefinitions
+ * Object-form configuration for creating an external reference.
+ * Mirrors the Kro v0.8.x externalRef spec structure.
+ */
+export interface ExternalRefConfig {
+    apiVersion: string;
+    kind: string;
+    metadata: {
+        name: string;
+        namespace?: string;
+    };
+    /** Explicit resource ID for composition tracking. Required when name is dynamic. */
+    id?: string;
+}
+/**
+ * Create external reference to a pre-existing resource that is not managed by Kro.
  *
- * @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
+ * When called inside a `kubernetesComposition` callback, the external reference is
+ * automatically registered with the composition context so it appears in the Kro YAML
+ * as an `externalRef` entry.
  *
- * @example
+ * @example Object form (Kro v0.8.x style):
  * ```typescript
- * // Reference an external database instance
- * const database = externalRef<DatabaseSpec, DatabaseStatus>(
- *   'v1alpha1',
- *   'Database',
- *   'production-db'
- * );
- *
- * // Use in resource template
- * const webapp = simple.Deployment({
- *   name: 'webapp',
- *   image: 'nginx',
- *   env: {
- *     DATABASE_URL: database.status.connectionString
- *   }
+ * const config = externalRef({
+ *   apiVersion: 'v1',
+ *   kind: 'ConfigMap',
+ *   metadata: { name: 'platform-config', namespace: 'platform-system' },
  * });
  * ```
+ *
+ * @example Positional form (legacy):
+ * ```typescript
+ * const database = externalRef('v1alpha1', 'Database', 'production-db');
+ * ```
  */
+export declare function externalRef<TSpec extends object, TStatus extends object>(config: ExternalRefConfig): Enhanced<TSpec, TStatus>;
 export declare function externalRef<TSpec extends object, TStatus extends object>(apiVersion: string, kind: string, instanceName: string, namespace?: string): Enhanced<TSpec, TStatus>;
+/**
+ * Create an external reference WITHOUT registering in the composition context.
+ * Used by the cross-composition magic proxy to create references to resources
+ * in other compositions without polluting the current composition's resource list.
+ *
+ * @internal
+ */
+export declare function createExternalRefWithoutRegistration<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

@@ -1 +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"}
+{"version":3,"file":"external-refs.d.ts","sourceRoot":"","sources":["../../../src/core/references/external-refs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAMH,OAAO,KAAK,EAAE,QAAQ,EAAsB,MAAM,aAAa,CAAC;AAWhE;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE;QACR,IAAI,EAAE,MAAM,CAAC;QACb,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC;IACF,oFAAoF;IACpF,EAAE,CAAC,EAAE,MAAM,CAAC;CACb;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,WAAW,CAAC,KAAK,SAAS,MAAM,EAAE,OAAO,SAAS,MAAM,EACtE,MAAM,EAAE,iBAAiB,GACxB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;AAC5B,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,CAAC;AA+D5B;;;;;;GAMG;AACH,wBAAgB,oCAAoC,CAAC,KAAK,SAAS,MAAM,EAAE,OAAO,SAAS,MAAM,EAC/F,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,EACZ,YAAY,EAAE,MAAM,EACpB,SAAS,CAAC,EAAE,MAAM,GACjB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC,CAe1B"}

package/dist/core/references/external-refs.js

@@ -3,38 +3,82 @@
  *
  * This module provides functionality to create external references to CRD instances
  * for composition between ResourceGraphDefinitions.
+ *
+ * Supports two calling conventions:
+ * 1. Positional: externalRef(apiVersion, kind, instanceName, namespace?)
+ * 2. Object-form: externalRef({ apiVersion, kind, metadata: { name, namespace? } })
  */
-import { createResource } from '../../factories/shared.js';
+import { getCurrentCompositionContext } from '../composition/context.js';
+import { getResourceId } from '../metadata/index.js';
+import { createResource } from '../proxy/create-resource.js';
+import { registerFactory } from '../resources/factory-registry.js';
+// Self-register so the composition analyzer recognizes `externalRef(...)` calls
+// in the AST. The kind/apiVersion are placeholders — externalRef creates resources
+// of user-specified kinds, but we need the factoryName 'externalRef' in the registry.
+registerFactory({
+    factoryName: 'externalRef',
+    kind: 'ExternalRef',
+    apiVersion: 'typekro/v1',
+});
+export function externalRef(configOrApiVersion, kind, instanceName, namespace) {
+    let apiVersion;
+    let resolvedKind;
+    let resolvedName;
+    let resolvedNamespace;
+    if (typeof configOrApiVersion === 'object') {
+        // Object-form: externalRef({ apiVersion, kind, metadata: { name, namespace } })
+        apiVersion = configOrApiVersion.apiVersion;
+        resolvedKind = configOrApiVersion.kind;
+        resolvedName = configOrApiVersion.metadata.name;
+        resolvedNamespace = configOrApiVersion.metadata.namespace;
+    }
+    else {
+        // Positional form: externalRef(apiVersion, kind, instanceName, namespace?)
+        apiVersion = configOrApiVersion;
+        resolvedKind = kind;
+        resolvedName = instanceName;
+        resolvedNamespace = namespace;
+    }
+    // Extract id from object-form config
+    const resolvedId = typeof configOrApiVersion === 'object' ? configOrApiVersion.id : undefined;
+    // Create a KubernetesResource marked as external reference
+    const resource = {
+        apiVersion,
+        kind: resolvedKind,
+        metadata: {
+            name: resolvedName,
+            ...(resolvedNamespace && { namespace: resolvedNamespace }),
+        },
+        spec: {},
+        status: {},
+        // Mark this as an external reference for serialization
+        __externalRef: true,
+        ...(resolvedId && { id: resolvedId }),
+    };
+    // Use existing createResource function to get Enhanced proxy
+    // (createResource skips context registration for __externalRef resources)
+    const enhanced = createResource(resource);
+    // Explicitly register with composition context so externalRef appears in Kro YAML.
+    // This only happens when called directly from user code inside kubernetesComposition.
+    // Cross-composition auto-refs (from core.ts Proxy get trap) go through
+    // createExternalRefWithoutRegistration() instead.
+    const context = getCurrentCompositionContext();
+    if (context) {
+        const resourceId = getResourceId(enhanced);
+        if (resourceId) {
+            context.addResource(resourceId, enhanced);
+        }
+    }
+    return enhanced;
+}
 /**
- * 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
+ * Create an external reference WITHOUT registering in the composition context.
+ * Used by the cross-composition magic proxy to create references to resources
+ * in other compositions without polluting the current composition's resource list.
  *
- * @example
- * ```typescript
- * // Reference an external database instance
- * const database = externalRef<DatabaseSpec, DatabaseStatus>(
- *   'v1alpha1',
- *   'Database',
- *   'production-db'
- * );
- *
- * // Use in resource template
- * const webapp = simple.Deployment({
- *   name: 'webapp',
- *   image: 'nginx',
- *   env: {
- *     DATABASE_URL: database.status.connectionString
- *   }
- * });
- * ```
+ * @internal
  */
-export function externalRef(apiVersion, kind, instanceName, namespace) {
-    // Create a KubernetesResource marked as external reference
+export function createExternalRefWithoutRegistration(apiVersion, kind, instanceName, namespace) {
     const resource = {
         apiVersion,
         kind,
@@ -44,10 +88,9 @@ export function externalRef(apiVersion, kind, instanceName, namespace) {
         },
         spec: {},
         status: {},
-        // Mark this as an external reference for serialization
         __externalRef: true,
     };
-    // Use existing createResource function to get Enhanced proxy
+    // createResource skips context registration for __externalRef resources
     return createResource(resource);
 }
 //# sourceMappingURL=external-refs.js.map