typekro 0.3.1 → 0.5.0

package/dist/core/serialization/yaml.js

@@ -1,11 +1,445 @@
 /**
  * YAML generation functionality for Kro ResourceGraphDefinitions
+ *
+ * Supports Kro v0.8.x features: forEach, includeWhen, readyWhen, externalRef,
+ * schema group, and allowBreakingChanges annotation.
  */
 import * as yaml from 'js-yaml';
-import { extractResourceReferences, generateDeterministicResourceId, processResourceReferences, } from '../../utils/index';
+import { escapeRegExp } from '../../utils/helpers.js';
+import { extractResourceReferences, isCelExpression, isKubernetesRef, } from '../../utils/type-guards.js';
+import { getForEach, getIncludeWhen, getReadyWhen, getResourceId, getTemplateOverrides, } from '../metadata/index.js';
+import { generateDeterministicResourceId } from '../resources/id.js';
+import { getInnerCelPath, processResourceReferences } from './cel-references.js';
 import { generateKroSchema } from './schema.js';
 /**
- * Serializes resources to Kro YAML
+ * Read a non-enumerable property from an Enhanced resource.
+ *
+ * Used only for `__externalRef` which is NOT part of the WeakMap migration
+ * (it's an enumerable direct-assign property). Tier 2 properties (includeWhen,
+ * readyWhen, forEach, __templateOverrides) use WeakMap getters instead.
+ */
+function readNonEnumerable(resource, key) {
+    return Reflect.get(resource, key);
+}
+/**
+ * Read a Tier 2 metadata property from a resource.
+ * Checks WeakMap metadata first, falls back to legacy non-enumerable property.
+ *
+ * The fallback MUST validate the value is an array because Enhanced proxy
+ * resources intercept ALL property access and return KubernetesRef proxies
+ * (functions) for unknown keys. Without this guard, accessing `.includeWhen`
+ * on a proxy resource would return a truthy proxy function — causing a
+ * spurious self-referencing `includeWhen` condition in the Kro YAML.
+ */
+function readIncludeWhen(resource) {
+    const fromWeakMap = getIncludeWhen(resource);
+    if (fromWeakMap)
+        return fromWeakMap;
+    const legacy = readNonEnumerable(resource, 'includeWhen');
+    return Array.isArray(legacy) ? legacy : undefined;
+}
+function readReadyWhen(resource) {
+    const fromWeakMap = getReadyWhen(resource);
+    if (fromWeakMap)
+        return fromWeakMap;
+    const legacy = readNonEnumerable(resource, 'readyWhen');
+    return Array.isArray(legacy) ? legacy : undefined;
+}
+function readForEachDimensions(resource) {
+    const fromWeakMap = getForEach(resource);
+    if (fromWeakMap)
+        return fromWeakMap;
+    const legacy = readNonEnumerable(resource, 'forEach');
+    return Array.isArray(legacy) ? legacy : undefined;
+}
+function readTemplateOverrides(resource) {
+    return (getTemplateOverrides(resource) ??
+        readNonEnumerable(resource, '__templateOverrides'));
+}
+// ---------------------------------------------------------------------------
+// includeWhen → CEL conversion
+// ---------------------------------------------------------------------------
+/**
+ * Convert a single includeWhen value to a CEL expression string.
+ *
+ * Accepted input types:
+ *  - KubernetesRef proxy  → `${schema.spec.field}`
+ *  - CelExpression object → `${expression}`
+ *  - string (already CEL) → pass-through
+ *  - string with __KUBERNETES_REF__ markers → convert markers to CEL
+ */
+function convertIncludeWhenValueToCel(value) {
+    if (typeof value === 'string') {
+        if (value.includes('__KUBERNETES_REF_')) {
+            return convertRefMarkersInString(value);
+        }
+        return value;
+    }
+    if (isKubernetesRef(value)) {
+        const celPath = getInnerCelPath(value);
+        return `\${${celPath}}`;
+    }
+    if (isCelExpression(value)) {
+        return `\${${value.expression}}`;
+    }
+    // Fallback — coerce to string
+    if (value !== undefined && value !== null) {
+        return String(value);
+    }
+    return undefined;
+}
+/**
+ * Resolve the includeWhen property from an Enhanced resource to an array of CEL strings.
+ *
+ * The stored value can be:
+ *  - A single KubernetesRef / CelExpression / string
+ *  - An array of the above
+ *  - undefined (no condition)
+ */
+function resolveIncludeWhen(raw) {
+    if (raw === undefined || raw === null)
+        return undefined;
+    const items = Array.isArray(raw) ? raw : [raw];
+    const celStrings = [];
+    for (const item of items) {
+        const cel = convertIncludeWhenValueToCel(item);
+        if (cel)
+            celStrings.push(cel);
+    }
+    return celStrings.length > 0 ? celStrings : undefined;
+}
+// ---------------------------------------------------------------------------
+// readyWhen → CEL conversion
+// ---------------------------------------------------------------------------
+/**
+ * Convert a readyWhen callback function to a CEL expression string by parsing its source.
+ *
+ * Strategy: use fn.toString() and simple regex/string transforms to convert
+ * JavaScript expressions to CEL, replacing the callback parameter with the resource id.
+ *
+ * Examples:
+ *   (self) => self.status.readyReplicas > 0
+ *   → "web.status.readyReplicas > 0"
+ *
+ *   (self) => self.status.phase === 'Running'
+ *   → 'app.status.phase == "Running"'
+ *
+ *   (self) => self.status.conditions.exists((c) => c.type === 'Ready' && c.status === 'True')
+ *   → 'db.status.conditions.exists(c, c.type == "Ready" && c.status == "True")'
+ */
+function convertReadyWhenCallbackToCel(fn, resourceId) {
+    const fnStr = fn.toString();
+    // Extract parameter name and body from arrow function
+    // Patterns:
+    //   (self) => self.status.readyReplicas > 0
+    //   self => self.status.readyReplicas > 0
+    //   (self) => { return self.status.readyReplicas > 0; }
+    const arrowMatch = fnStr.match(/^\s*\(?([a-zA-Z_$][a-zA-Z0-9_$]*)\)?\s*=>\s*(?:\{\s*(?:return\s+)?)?([\s\S]+?)(?:\s*;?\s*\})?$/);
+    let paramName;
+    let bodyStr;
+    if (arrowMatch?.[1] && arrowMatch[2]) {
+        paramName = arrowMatch[1];
+        bodyStr = arrowMatch[2].trim();
+        // Remove trailing semicolons and closing braces
+        bodyStr = bodyStr
+            .replace(/;\s*$/, '')
+            .replace(/\}\s*$/, '')
+            .trim();
+    }
+    else {
+        // Fallback: try regular function syntax
+        const funcMatch = fnStr.match(/function\s*\w*\s*\(\s*([a-zA-Z_$][a-zA-Z0-9_$]*)\s*\)\s*\{\s*(?:return\s+)?([\s\S]+?);\s*\}/);
+        if (funcMatch?.[1] && funcMatch[2]) {
+            paramName = funcMatch[1];
+            bodyStr = funcMatch[2].trim();
+        }
+        else {
+            // Cannot parse — return as-is
+            return fnStr;
+        }
+    }
+    // Replace parameter name with resource id (word boundary to avoid substrings)
+    let celExpr = bodyStr.replace(new RegExp(`\\b${escapeRegExp(paramName)}\\b`, 'g'), resourceId);
+    // JS → CEL operator conversions (must happen before inner callback processing)
+    celExpr = celExpr.replace(/===/g, '==');
+    celExpr = celExpr.replace(/!==/g, '!=');
+    // Convert JS arrow function callbacks inside .exists(), .filter(), .all(), .map()
+    // Pattern: .exists((c) => c.type === 'Ready' && c.status === 'True')
+    // → .exists(c, c.type == "Ready" && c.status == "True")
+    celExpr = celExpr.replace(/\.\s*(exists|all|filter|map)\s*\(\s*\(?([a-zA-Z_$][a-zA-Z0-9_$]*)\)?\s*(?::\s*\w+)?\s*=>\s*([\s\S]+?)\)/g, (_match, method, innerParam, innerBody) => {
+        let cleanBody = innerBody.trim();
+        // Fix operators in inner body too
+        cleanBody = cleanBody.replace(/===/g, '==').replace(/!==/g, '!=');
+        // Convert single quotes to double quotes for string literals
+        cleanBody = cleanBody.replace(/'([^']+)'/g, '"$1"');
+        return `.${method}(${innerParam}, ${cleanBody})`;
+    });
+    // Convert remaining single-quoted strings to double-quoted for CEL
+    celExpr = celExpr.replace(/'([^']+)'/g, '"$1"');
+    return celExpr;
+}
+/**
+ * Convert a readyWhen value to a CEL expression string.
+ *
+ * Accepted input types:
+ *  - Function (callback)  → parse source to produce CEL
+ *  - KubernetesRef proxy  → `${resourceId.fieldPath}`
+ *  - CelExpression object → `${expression}`
+ *  - string (already CEL) → pass-through
+ */
+function convertReadyWhenValueToCel(value, resourceId, hasForEach) {
+    // Callback function — parse source to extract CEL expression
+    if (typeof value === 'function') {
+        const baseId = hasForEach ? 'each' : resourceId;
+        const celExpr = convertReadyWhenCallbackToCel(value, baseId);
+        return `\${${celExpr}}`;
+    }
+    if (isKubernetesRef(value)) {
+        const celPath = getInnerCelPath(value);
+        return `\${${celPath}}`;
+    }
+    if (isCelExpression(value)) {
+        return `\${${value.expression}}`;
+    }
+    if (typeof value === 'string') {
+        if (value.includes('__KUBERNETES_REF_')) {
+            return `\${${convertRefMarkersInString(value)}}`;
+        }
+        return value;
+    }
+    if (value !== undefined && value !== null) {
+        return String(value);
+    }
+    return undefined;
+}
+/**
+ * Resolve the readyWhen property from an Enhanced resource to an array of CEL strings.
+ */
+function resolveReadyWhen(raw, resourceId, hasForEach) {
+    if (raw === undefined || raw === null)
+        return undefined;
+    const items = Array.isArray(raw) ? raw : [raw];
+    const celStrings = [];
+    for (const item of items) {
+        const cel = convertReadyWhenValueToCel(item, resourceId, hasForEach);
+        if (cel)
+            celStrings.push(cel);
+    }
+    return celStrings.length > 0 ? celStrings : undefined;
+}
+// ---------------------------------------------------------------------------
+// Shared helpers
+// ---------------------------------------------------------------------------
+/**
+ * Convert __KUBERNETES_REF__ markers in a string to plain CEL references (no ${} wrapper).
+ *
+ * Input:  "__KUBERNETES_REF_web_status.readyReplicas__ > 0"
+ * Output: "web.status.readyReplicas > 0"
+ */
+function convertRefMarkersInString(str) {
+    // Pattern: __KUBERNETES_REF_{resourceId}_{fieldPath}__
+    // For schema: __KUBERNETES_REF___schema___{fieldPath}__
+    const refPattern = /__KUBERNETES_REF_(__schema__|[^_]+)_([a-zA-Z0-9.$]+)__/g;
+    return str.replace(refPattern, (_match, resourceId, fieldPath) => {
+        if (resourceId === '__schema__') {
+            return `schema.${fieldPath}`;
+        }
+        return `${resourceId}.${fieldPath}`;
+    });
+}
+// ---------------------------------------------------------------------------
+// forEach $item sentinel substitution
+// ---------------------------------------------------------------------------
+/**
+ * Recursively walk a template object and replace forEach sentinel references.
+ *
+ * During proxy-based tracing, element accesses on schema arrays produce
+ * KubernetesRef field paths that include the `$item` sentinel. For example,
+ * iterating `schema.spec.workers` yields refs like `schema.spec.workers.$item.name`.
+ *
+ * In the serialized Kro YAML these must become the forEach variable name, e.g.,
+ * `worker.name` (where `worker` is the forEach dimension key).
+ *
+ * This function handles both:
+ * - CEL expression strings wrapped in `${}`: `${schema.spec.workers.$item.name}` → `${worker.name}`
+ * - Raw reference strings: `schema.spec.workers.$item.name` → `worker.name`
+ * - Concatenated CEL: `${schema.spec.name + "-" + schema.spec.workers.$item}` →
+ *   `${schema.spec.name + "-" + worker}`
+ *
+ * @param template The resource template (object, array, or primitive)
+ * @param basePath The schema base path WITHOUT $item (e.g., `schema.spec.workers`)
+ * @param varName  The forEach variable name (e.g., `worker`)
+ */
+function substituteForEachSentinels(template, basePath, varName) {
+    if (typeof template === 'string') {
+        // Replace "basePath.$item.field" with "varName.field"
+        // Replace "basePath.$item" (no trailing field) with "varName"
+        // The basePath may contain dots, so we escape them for the regex.
+        const escaped = basePath.replace(/\./g, '\\.');
+        // Match basePath.$item followed by optional .field... or end of reference
+        const pattern = new RegExp(`${escaped}\\.\\$item(?:\\.([a-zA-Z0-9_.]+))?`, 'g');
+        return template.replace(pattern, (_match, fieldTail) => {
+            return fieldTail ? `${varName}.${fieldTail}` : varName;
+        });
+    }
+    if (Array.isArray(template)) {
+        return template.map((item) => substituteForEachSentinels(item, basePath, varName));
+    }
+    if (template !== null && typeof template === 'object') {
+        const result = {};
+        for (const [key, value] of Object.entries(template)) {
+            result[key] = substituteForEachSentinels(value, basePath, varName);
+        }
+        return result;
+    }
+    // Primitives (number, boolean, null, undefined) pass through unchanged
+    return template;
+}
+// ---------------------------------------------------------------------------
+// Template override application
+// ---------------------------------------------------------------------------
+/**
+ * Apply template overrides to a processed resource template.
+ *
+ * Template overrides are CEL expressions that should replace literal values
+ * in the template. They are generated by the composition body analyzer when
+ * it detects ternary expressions in factory arguments that evaluated to a
+ * literal at runtime (because `===` on proxies fails).
+ *
+ * @param template - The processed template object (after processResourceReferences)
+ * @param overrides - Array of {propertyPath, celExpression} overrides
+ */
+function applyTemplateOverrides(template, overrides) {
+    for (const { propertyPath, celExpression } of overrides) {
+        const parts = propertyPath.split('.');
+        let target = template;
+        // Walk to the parent of the target property
+        for (let i = 0; i < parts.length - 1; i++) {
+            const part = parts[i];
+            if (!part)
+                continue;
+            const next = target[part];
+            if (next && typeof next === 'object' && !Array.isArray(next)) {
+                target = next;
+            }
+            else {
+                // Path doesn't exist in the template — skip this override
+                target = undefined;
+                break;
+            }
+        }
+        if (!target)
+            continue;
+        const lastKey = parts[parts.length - 1];
+        if (lastKey && lastKey in target) {
+            target[lastKey] = celExpression;
+        }
+    }
+}
+// ---------------------------------------------------------------------------
+// Resource entry builder
+// ---------------------------------------------------------------------------
+/**
+ * Build a KroResourceTemplate entry for a single resource.
+ *
+ * - If the resource has `__externalRef`, emits `externalRef` instead of `template`.
+ * - Reads non-enumerable `includeWhen` and `readyWhen` arrays and converts to CEL.
+ * - Reads non-enumerable `forEach` dimensions (populated by proxy layer / AST analysis).
+ * - Reads non-enumerable `__templateOverrides` for ternary CEL substitution.
+ */
+function buildResourceEntry(id, resource, context) {
+    const isExternalRef = readNonEnumerable(resource, '__externalRef');
+    if (isExternalRef) {
+        // externalRef resources: emit externalRef metadata, NOT template.
+        // Use Object.getOwnPropertyDescriptor to bypass the Enhanced proxy's get trap
+        // and read the actual underlying values. Going through the proxy would cause
+        // metadata.namespace to return a KubernetesRef function proxy when namespace
+        // doesn't exist, which yaml.dump cannot serialize.
+        const apiVersionDesc = Object.getOwnPropertyDescriptor(resource, 'apiVersion');
+        const kindDesc = Object.getOwnPropertyDescriptor(resource, 'kind');
+        const metadataDesc = Object.getOwnPropertyDescriptor(resource, 'metadata');
+        const rawMeta = metadataDesc?.value;
+        const extRef = {
+            apiVersion: String(apiVersionDesc?.value ?? ''),
+            kind: String(kindDesc?.value ?? ''),
+            metadata: {
+                name: typeof rawMeta?.name === 'string' ? rawMeta.name : '',
+                ...(typeof rawMeta?.namespace === 'string' && { namespace: rawMeta.namespace }),
+            },
+        };
+        const entry = { id, externalRef: extRef };
+        // externalRef can still have includeWhen (but NOT forEach — mutually exclusive)
+        const rawIncludeWhen = readIncludeWhen(resource);
+        const includeWhen = resolveIncludeWhen(rawIncludeWhen);
+        if (includeWhen) {
+            entry.includeWhen = includeWhen;
+        }
+        return entry;
+    }
+    // Regular resource: emit template
+    const entry = {
+        id,
+        template: processResourceReferences(resource, context),
+    };
+    // forEach — collection dimensions (populated by proxy layer / AST analysis)
+    const forEach = readForEachDimensions(resource);
+    const hasForEach = forEach !== undefined && forEach.length > 0;
+    if (hasForEach) {
+        entry.forEach = forEach;
+        // Replace $item sentinel references in the template with actual forEach variable names.
+        // During runtime, schema array element proxies produce refs with `$item` in the field path
+        // (e.g., `schema.spec.workers.$item.name`). We replace these with the forEach variable name
+        // (e.g., `worker.name`) based on the forEach dimensions.
+        if (entry.template) {
+            for (const dimension of forEach) {
+                const [varName, sourceExpr] = Object.entries(dimension)[0] ?? [];
+                if (varName && sourceExpr) {
+                    // sourceExpr is like "${schema.spec.workers}" or "${schema.spec.workers.filter(...)}"
+                    // Extract the base path: "schema.spec.workers"
+                    const basePath = sourceExpr
+                        .replace(/^\$\{/, '')
+                        .replace(/\}$/, '')
+                        .replace(/\.filter\(.*$/, '')
+                        .replace(/\.map\(.*$/, '');
+                    // Replace "basePath.$item.X" with "varName.X" and "basePath.$item" with "varName"
+                    entry.template = substituteForEachSentinels(entry.template, basePath, varName);
+                }
+            }
+        }
+    }
+    // Template overrides — ternary expressions in factory args that evaluated to
+    // literals at runtime but should be CEL conditionals in the output.
+    const templateOverrides = readTemplateOverrides(resource);
+    if (templateOverrides && templateOverrides.length > 0 && entry.template) {
+        applyTemplateOverrides(entry.template, templateOverrides);
+    }
+    // includeWhen — conditional resource creation (convert raw values to CEL)
+    const rawIncludeWhen = readIncludeWhen(resource);
+    const includeWhen = resolveIncludeWhen(rawIncludeWhen);
+    if (includeWhen) {
+        entry.includeWhen = includeWhen;
+    }
+    // readyWhen — resource readiness conditions (convert callbacks/refs to CEL)
+    const rawReadyWhen = readReadyWhen(resource);
+    const readyWhen = resolveReadyWhen(rawReadyWhen, id, hasForEach);
+    if (readyWhen) {
+        entry.readyWhen = readyWhen;
+    }
+    return entry;
+}
+// ---------------------------------------------------------------------------
+// Main serialization function
+// ---------------------------------------------------------------------------
+/**
+ * Serializes resources to Kro YAML (ResourceGraphDefinition).
+ *
+ * Supports Kro v0.8.x features:
+ * - externalRef: Resources marked with __externalRef emit `externalRef` instead of `template`
+ * - includeWhen: Non-enumerable includeWhen arrays are emitted per resource
+ * - readyWhen: Non-enumerable readyWhen arrays are emitted per resource
+ * - forEach: Non-enumerable forEach dimensions are emitted per resource
+ * - group: Custom API group in schema (passed through customSchema)
+ * - allowBreakingChanges: Emits annotation on RGD metadata
  */
 export function serializeResourceGraphToYaml(name, resources, options, customSchema) {
     // Create serialization context
@@ -20,7 +454,7 @@ export function serializeResourceGraphToYaml(name, resources, options, customSch
     // 2. Process each resource and extract references
     for (const [resourceName, resource] of Object.entries(resources)) {
         // Use the embedded resource ID if available, otherwise generate deterministic one
-        const resourceId = resource.__resourceId ||
+        const resourceId = getResourceId(resource) ||
             generateDeterministicResourceId(resource.kind || 'Resource', resource.metadata?.name || resourceName, resource.metadata?.namespace || options?.namespace);
         resourceMap.set(resourceName, { id: resourceId, resource });
         // Extract all ResourceReference objects from the resource
@@ -34,23 +468,28 @@ export function serializeResourceGraphToYaml(name, resources, options, customSch
             });
         }
     }
-    // 3. Generate Kro ResourceGraphDefinition
+    // 3. Build metadata with optional annotations
+    const metadata = {
+        name,
+        namespace: options?.namespace || 'default',
+    };
+    if (options?.allowBreakingChanges) {
+        metadata.annotations = {
+            ...metadata.annotations,
+            'kro.run/allow-breaking-changes': 'true',
+        };
+    }
+    // 4. Generate Kro ResourceGraphDefinition
     const kroDefinition = {
         apiVersion: 'kro.run/v1alpha1',
         kind: 'ResourceGraphDefinition',
-        metadata: {
-            name,
-            namespace: options?.namespace || 'default',
-        },
+        metadata,
         spec: {
             schema: customSchema || generateKroSchema(name, resources),
-            resources: Array.from(resourceMap.values()).map(({ id, resource }) => ({
-                id,
-                template: processResourceReferences(resource, context),
-            })),
+            resources: Array.from(resourceMap.values()).map(({ id, resource }) => buildResourceEntry(id, resource, context)),
         },
     };
-    // 4. Convert to YAML
+    // 5. Convert to YAML
     return yaml.dump(kroDefinition, {
         indent: options?.indent || 2,
         lineWidth: options?.lineWidth || -1,
@@ -58,6 +497,7 @@ export function serializeResourceGraphToYaml(name, resources, options, customSch
         sortKeys: false,
         quotingType: '"',
         forceQuotes: false,
+        schema: yaml.JSON_SCHEMA,
     });
 }
 //# sourceMappingURL=yaml.js.map

package/dist/core/serialization/yaml.js.map

@@ -1 +1 @@
-{"version":3,"file":"yaml.js","sourceRoot":"","sources":["../../../src/core/serialization/yaml.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,IAAI,MAAM,SAAS,CAAC;AAChC,OAAO,EACL,yBAAyB,EACzB,+BAA+B,EAC/B,yBAAyB,GAC1B,MAAM,mBAAmB,CAAC;AAO3B,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAEhD;;GAEG;AACH,MAAM,UAAU,4BAA4B,CAC1C,IAAY,EACZ,SAA6C,EAC7C,OAA8B,EAC9B,YAA8B;IAE9B,+BAA+B;IAC/B,MAAM,OAAO,GAAyB;QACpC,SAAS,EAAE,WAAW,EAAE,2CAA2C;QACnE,GAAG,CAAC,OAAO,EAAE,SAAS,IAAI,EAAE,SAAS,EAAE,OAAO,CAAC,SAAS,EAAE,CAAC;QAC3D,kBAAkB,EAAE,eAAe;KACpC,CAAC;IAEF,0DAA0D;IAC1D,MAAM,WAAW,GAAG,IAAI,GAAG,EAAwD,CAAC;IACpF,MAAM,YAAY,GAAyB,EAAE,CAAC;IAE9C,kDAAkD;IAClD,KAAK,MAAM,CAAC,YAAY,EAAE,QAAQ,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;QACjE,kFAAkF;QAClF,MAAM,UAAU,GACb,QAAsC,CAAC,YAAY;YACpD,+BAA+B,CAC7B,QAAQ,CAAC,IAAI,IAAI,UAAU,EAC3B,QAAQ,CAAC,QAAQ,EAAE,IAAI,IAAI,YAAY,EACvC,QAAQ,CAAC,QAAQ,EAAE,SAAS,IAAI,OAAO,EAAE,SAAS,CACnD,CAAC;QACJ,WAAW,CAAC,GAAG,CAAC,YAAY,EAAE,EAAE,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,CAAC,CAAC;QAE5D,0DAA0D;QAC1D,MAAM,IAAI,GAAG,yBAAyB,CAAC,QAAQ,CAAC,CAAC;QACjD,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACvB,YAAY,CAAC,IAAI,CAAC;gBAChB,IAAI,EAAE,UAAU;gBAChB,EAAE,EAAE,GAAG,CAAC,UAAU;gBAClB,KAAK,EAAE,GAAG,CAAC,SAAS;gBACpB,QAAQ,EAAE,IAAI;aACf,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,0CAA0C;IAC1C,MAAM,aAAa,GAA+B;QAChD,UAAU,EAAE,kBAAkB;QAC9B,IAAI,EAAE,yBAAyB;QAC/B,QAAQ,EAAE;YACR,IAAI;YACJ,SAAS,EAAE,OAAO,EAAE,SAAS,IAAI,SAAS;SAC3C;QACD,IAAI,EAAE;YACJ,MAAM,EAAE,YAAY,IAAI,iBAAiB,CAAC,IAAI,EAAE,SAAS,CAAC;YAC1D,SAAS,EAAE,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC,CAAC;gBACrE,EAAE;gBACF,QAAQ,EAAE,yBAAyB,CAAC,QAAQ,EAAE,OAAO,CAAC;aACvD,CAAC,CAAC;SACJ;KACF,CAAC;IAEF,qBAAqB;IACrB,OAAO,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE;QAC9B,MAAM,EAAE,OAAO,EAAE,MAAM,IAAI,CAAC;QAC5B,SAAS,EAAE,OAAO,EAAE,SAAS,IAAI,CAAC,CAAC;QACnC,MAAM,EAAE,OAAO,EAAE,MAAM,IAAI,IAAI;QAC/B,QAAQ,EAAE,KAAK;QACf,WAAW,EAAE,GAAG;QAChB,WAAW,EAAE,KAAK;KACnB,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"yaml.js","sourceRoot":"","sources":["../../../src/core/serialization/yaml.ts"],"names":[],"mappings":"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"}

package/dist/core/types/common.d.ts

@@ -6,10 +6,32 @@
  * while maintaining type safety with KubernetesRef types.
  */
 import { CEL_EXPRESSION_BRAND, KUBERNETES_REF_BRAND } from '../constants/brands.js';
+/**
+ * A branded type representing a Common Expression Language (CEL) expression
+ * that evaluates to a value of type `T` at Kro runtime.
+ *
+ * CEL expressions are used in status builders and conditional directives
+ * to define dynamic logic that Kro evaluates server-side.
+ *
+ * Create instances with {@link Cel.expr}, {@link Cel.template}, or {@link Cel.string}.
+ *
+ * @typeParam T - The TypeScript type this expression evaluates to at runtime.
+ *
+ * @example
+ * ```ts
+ * // Boolean expression checking deployment readiness
+ * Cel.expr<boolean>(resources.deployment.status.readyReplicas, ' > 0')
+ *
+ * // String template interpolation
+ * Cel.template('https://%s/api', schema.spec.hostname)
+ * ```
+ */
 export interface CelExpression<T = unknown> {
     [CEL_EXPRESSION_BRAND]: true;
     expression: string;
     _type?: T;
+    /** When true, the expression is a mixed template containing `${...}` placeholders. */
+    __isTemplate?: boolean;
 }
 /**
  * Magic type that makes composition functions work transparently with KubernetesRef and CelExpression
@@ -20,22 +42,57 @@ export type MagicValue<T> = T extends string ? string | KubernetesRef<string> |
  * This prevents KubernetesRef<number> from being assigned to env vars without explicit conversion
  */
 export type EnvVarValue = string | KubernetesRef<string> | KubernetesRef<string | undefined> | CelExpression<string>;
-export type MagicAssignable<T> = T | undefined | KubernetesRef<T> | KubernetesRef<T | undefined> | CelExpression<T>;
+/**
+ * MagicAssignable allows assignment of plain values, KubernetesRef-wrapped values,
+ * and CEL expressions to composition properties.
+ *
+ * Note: We avoid recursive DeepKubernetesRef wrapping to prevent infinite type expansion.
+ */
+export type MagicAssignable<T> = T | undefined | CelExpression<T> | KubernetesRef<T> | KubernetesRef<T | undefined> | (T extends DeepKubernetesRef<any> ? never : DeepKubernetesRef<T>) | (T extends DeepKubernetesRef<any> ? never : DeepKubernetesRef<T | undefined>);
 export type MagicString = string | KubernetesRef<string> | CelExpression<string>;
 export type MagicNumber = number | KubernetesRef<number> | CelExpression<number>;
 export type MagicBoolean = boolean | KubernetesRef<boolean> | CelExpression<boolean>;
-declare global {
-    namespace TypeKro {
-        interface MagicTypeCompatibility {
-            KubernetesRefString: KubernetesRef<string> extends string ? true : false;
-            CelExpressionString: CelExpression<string> extends string ? true : false;
-        }
-    }
-}
+/**
+ * A branded type representing a reference to a Kubernetes resource field.
+ *
+ * At composition time, property accesses on schema and resource proxies
+ * produce `KubernetesRef` values that are serialized into CEL `${...}`
+ * references in the Kro manifest. This enables type-safe cross-resource
+ * references without string manipulation.
+ *
+ * Users typically never construct these directly; they are created
+ * automatically by the MagicProxy system when accessing proxy properties
+ * (e.g., `schema.spec.replicas` or `resources.deployment.status.readyReplicas`).
+ *
+ * @typeParam T - The TypeScript type of the referenced field value.
+ *
+ * @example
+ * ```ts
+ * // These produce KubernetesRef values automatically:
+ * const replicas = schema.spec.replicas;      // KubernetesRef<number>
+ * const phase = resources.deploy.status.phase; // KubernetesRef<string>
+ * ```
+ */
 export interface KubernetesRef<T = unknown> {
     readonly [KUBERNETES_REF_BRAND]: true;
     readonly resourceId: string;
     readonly fieldPath: string;
     readonly _type?: T;
 }
+/**
+ * Deep proxy type for KubernetesRef that allows nested property access
+ * AND primitive value operations (boolean expressions, arithmetic, etc.)
+ *
+ * This makes the type system match the runtime Proxy behavior where:
+ * - Nested objects: Can access properties like .field.subfield
+ * - Primitives: Can be used in expressions like && || + - etc.
+ *
+ * The union with primitive types (T) allows the magic proxy system to work:
+ * - KubernetesRef<boolean> | boolean → can be used in boolean expressions
+ * - KubernetesRef<number> | number → can be used in arithmetic
+ * - KubernetesRef<string> | string → can be used in string operations
+ */
+export type DeepKubernetesRef<T> = T extends any ? T extends boolean ? KubernetesRef<boolean> | boolean : T extends number ? KubernetesRef<T> | number : T extends string ? KubernetesRef<T> | string : T extends object ? {
+    [K in keyof T]: DeepKubernetesRef<T[K]>;
+} & KubernetesRef<T> : KubernetesRef<T> | T : never;
 //# sourceMappingURL=common.d.ts.map

package/dist/core/types/common.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"common.d.ts","sourceRoot":"","sources":["../../../src/core/types/common.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;GAGG;AACH,OAAO,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAEpF,MAAM,WAAW,aAAa,CAAC,CAAC,GAAG,OAAO;IACxC,CAAC,oBAAoB,CAAC,EAAE,IAAI,CAAC;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,CAAC,CAAC;CACX;AAED;;GAEG;AACH,MAAM,MAAM,UAAU,CAAC,CAAC,IAAI,CAAC,SAAS,MAAM,GACxC,MAAM,GAAG,aAAa,CAAC,MAAM,CAAC,GAAG,aAAa,CAAC,MAAM,CAAC,GACtD,CAAC,SAAS,MAAM,GACd,MAAM,GAAG,aAAa,CAAC,MAAM,CAAC,GAAG,aAAa,CAAC,MAAM,CAAC,GACtD,CAAC,SAAS,OAAO,GACf,OAAO,GAAG,aAAa,CAAC,OAAO,CAAC,GAAG,aAAa,CAAC,OAAO,CAAC,GACzD,CAAC,CAAC;AAEV;;;GAGG;AACH,MAAM,MAAM,WAAW,GACnB,MAAM,GACN,aAAa,CAAC,MAAM,CAAC,GACrB,aAAa,CAAC,MAAM,GAAG,SAAS,CAAC,GACjC,aAAa,CAAC,MAAM,CAAC,CAAC;AAE1B,MAAM,MAAM,eAAe,CAAC,CAAC,IACzB,CAAC,GACD,SAAS,GACT,aAAa,CAAC,CAAC,CAAC,GAChB,aAAa,CAAC,CAAC,GAAG,SAAS,CAAC,GAC5B,aAAa,CAAC,CAAC,CAAC,CAAC;AAGrB,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,aAAa,CAAC,MAAM,CAAC,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;AACjF,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,aAAa,CAAC,MAAM,CAAC,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;AACjF,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,aAAa,CAAC,OAAO,CAAC,GAAG,aAAa,CAAC,OAAO,CAAC,CAAC;AAIrF,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,OAAO,CAAC;QAChB,UAAU,sBAAsB;YAE9B,mBAAmB,EAAE,aAAa,CAAC,MAAM,CAAC,SAAS,MAAM,GAAG,IAAI,GAAG,KAAK,CAAC;YAEzE,mBAAmB,EAAE,aAAa,CAAC,MAAM,CAAC,SAAS,MAAM,GAAG,IAAI,GAAG,KAAK,CAAC;SAC1E;KACF;CACF;AAGD,MAAM,WAAW,aAAa,CAAC,CAAC,GAAG,OAAO;IACxC,QAAQ,CAAC,CAAC,oBAAoB,CAAC,EAAE,IAAI,CAAC;IACtC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;CACpB"}
+{"version":3,"file":"common.d.ts","sourceRoot":"","sources":["../../../src/core/types/common.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;GAGG;AACH,OAAO,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAEpF;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,WAAW,aAAa,CAAC,CAAC,GAAG,OAAO;IACxC,CAAC,oBAAoB,CAAC,EAAE,IAAI,CAAC;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,CAAC,CAAC;IACV,sFAAsF;IACtF,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,MAAM,UAAU,CAAC,CAAC,IAAI,CAAC,SAAS,MAAM,GACxC,MAAM,GAAG,aAAa,CAAC,MAAM,CAAC,GAAG,aAAa,CAAC,MAAM,CAAC,GACtD,CAAC,SAAS,MAAM,GACd,MAAM,GAAG,aAAa,CAAC,MAAM,CAAC,GAAG,aAAa,CAAC,MAAM,CAAC,GACtD,CAAC,SAAS,OAAO,GACf,OAAO,GAAG,aAAa,CAAC,OAAO,CAAC,GAAG,aAAa,CAAC,OAAO,CAAC,GACzD,CAAC,CAAC;AAEV;;;GAGG;AACH,MAAM,MAAM,WAAW,GACnB,MAAM,GACN,aAAa,CAAC,MAAM,CAAC,GACrB,aAAa,CAAC,MAAM,GAAG,SAAS,CAAC,GACjC,aAAa,CAAC,MAAM,CAAC,CAAC;AAE1B;;;;;GAKG;AACH,MAAM,MAAM,eAAe,CAAC,CAAC,IACzB,CAAC,GACD,SAAS,GACT,aAAa,CAAC,CAAC,CAAC,GAChB,aAAa,CAAC,CAAC,CAAC,GAChB,aAAa,CAAC,CAAC,GAAG,SAAS,CAAC,GAC5B,CAAC,CAAC,SAAS,iBAAiB,CAAC,GAAG,CAAC,GAAG,KAAK,GAAG,iBAAiB,CAAC,CAAC,CAAC,CAAC,GACjE,CAAC,CAAC,SAAS,iBAAiB,CAAC,GAAG,CAAC,GAAG,KAAK,GAAG,iBAAiB,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC,CAAC;AAGlF,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,aAAa,CAAC,MAAM,CAAC,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;AACjF,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,aAAa,CAAC,MAAM,CAAC,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;AACjF,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,aAAa,CAAC,OAAO,CAAC,GAAG,aAAa,CAAC,OAAO,CAAC,CAAC;AAErF;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,WAAW,aAAa,CAAC,CAAC,GAAG,OAAO;IACxC,QAAQ,CAAC,CAAC,oBAAoB,CAAC,EAAE,IAAI,CAAC;IACtC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;CACpB;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,iBAAiB,CAAC,CAAC,IAAI,CAAC,SAAS,GAAG,GAC5C,CAAC,SAAS,OAAO,GACf,aAAa,CAAC,OAAO,CAAC,GAAG,OAAO,GAChC,CAAC,SAAS,MAAM,GACd,aAAa,CAAC,CAAC,CAAC,GAAG,MAAM,GACzB,CAAC,SAAS,MAAM,GACd,aAAa,CAAC,CAAC,CAAC,GAAG,MAAM,GACzB,CAAC,SAAS,MAAM,GACd;KACG,CAAC,IAAI,MAAM,CAAC,GAAG,iBAAiB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CACxC,GAAG,aAAa,CAAC,CAAC,CAAC,GACpB,aAAa,CAAC,CAAC,CAAC,GAAG,CAAC,GAC5B,KAAK,CAAC"}