timonel 2.9.1 → 2.9.2

package/CHANGELOG.md

@@ -1,3 +1,9 @@
+## [2.9.2](https://github.com/KenkoGeek/timonel/compare/v2.9.1...v2.9.2) (2025-09-19)
+
+### Bug Fixes
+
+- **helm:** implement Helm-aware YAML serializer ([#112](https://github.com/KenkoGeek/timonel/issues/112)) ([daf4276](https://github.com/KenkoGeek/timonel/commit/daf427618eea73db832682f6b37287a9176bc31e))
+
 ## [2.9.1](https://github.com/KenkoGeek/timonel/compare/v2.9.0...v2.9.1) (2025-09-19)
 
 ### Bug Fixes

package/dist/cli.js

@@ -13,41 +13,50 @@ function log(msg, silent = false) {
         console.log(msg);
     }
 }
-function usageAndExit(msg) {
+function logError(msg, silent = false) {
+    if (!silent) {
+        console.error(msg);
+    }
+}
+function usageAndExit(msg, silent = false) {
     if (msg) {
-        console.error(`Error: ${msg}`);
-    }
-    console.log([
-        'Usage: tl <command> [options]',
-        '',
-        'Commands:',
-        '  tl init <chart-name>              Create new chart',
-        '  tl synth [outDir]                 Generate Helm chart',
-        '  tl validate                       Validate chart',
-        '  tl deploy <release> [namespace]   Deploy chart',
-        '  tl templates                      List available templates',
-        '',
-        'Umbrella Charts:',
-        '  tl umbrella init <n>              Create umbrella chart structure',
-        '  tl umbrella add <subchart>           Add subchart to umbrella',
-        '  tl umbrella synth [outDir]           Generate umbrella chart',
-        '',
-        'Flags:',
-        '  --dry-run                            Show what would be done without executing',
-        '  --silent                             Suppress output (useful for CI)',
-        '  --env <environment>                  Use environment-specific values',
-        '  --set <key=value>                    Override values (can be used multiple times)',
-        '  --help, -h                           Show this help message',
-        '',
-        'Examples:',
-        '  tl init my-app',
-        '  tl synth my-app my-app/dist',
-        '  tl validate my-app',
-        '  tl deploy my-app my-release --env prod',
-        '  tl synth my-app --dry-run --silent',
-        '  tl synth my-app --set replicas=5 --set image.tag=v2.0.0',
-        '  tl deploy my-app my-release --set service.port=8080',
-    ].join('\n'));
+        logError(`Error: ${msg}`, silent);
+    }
+    if (!silent) {
+        console.log([
+            'Usage: tl <command> [options]',
+            '',
+            'Commands:',
+            '  tl init <chart-name>              Create new chart',
+            '  tl synth [outDir]                 Generate Helm chart',
+            '  tl validate                       Validate chart',
+            '  tl deploy <release> [namespace]   Deploy chart',
+            '  tl templates                      List available templates',
+            '  tl help                           Show this help message',
+            '',
+            'Umbrella Charts:',
+            '  tl umbrella init <n>              Create umbrella chart structure',
+            '  tl umbrella add <subchart>           Add subchart to umbrella',
+            '  tl umbrella synth [outDir]           Generate umbrella chart',
+            '',
+            'Flags:',
+            '  --dry-run                            Show what would be done without executing',
+            '  --silent                             Suppress output (useful for CI)',
+            '  --env <environment>                  Use environment-specific values',
+            '  --set <key=value>                    Override values (can be used multiple times)',
+            '  --help, -h                           Show this help message',
+            '  --version, -v                        Show version information',
+            '',
+            'Examples:',
+            '  tl init my-app',
+            '  tl synth my-app my-app/dist',
+            '  tl validate my-app',
+            '  tl deploy my-app my-release --env prod',
+            '  tl synth --dry-run --silent',
+            '  tl synth --set replicas=5 --set image.tag=v2.0.0',
+            '  tl deploy my-app my-release --set service.port=8080',
+        ].join('\n'));
+    }
     process.exit(msg ? 1 : 0);
 }
 async function cmdInit(name, silent = false) {
@@ -165,14 +174,13 @@ async function cmdTemplates(flags) {
         },
     ];
     if (flags?.silent) {
-        console.log(JSON.stringify(templates));
+        console.log(JSON.stringify(templates, null, 2));
     }
     else {
         console.log('Available templates:');
         templates.forEach((t) => {
-            console.log(`\n${t.name}`);
-            console.log(`  Description: ${t.description}`);
-            console.log(`  Usage: ${t.usage}`);
+            console.log(`  ${t.name.padEnd(15)} - ${t.description}`);
+            console.log(`  ${''.padEnd(15)}   Usage: ${t.usage}`);
         });
     }
 }
@@ -388,15 +396,17 @@ function parseFlags(args) {
             }
             case '--version':
             case '-v':
-                console.log('Timonel v0.1.0');
+                if (!flags.silent) {
+                    console.log('Timonel v0.1.0');
+                }
                 process.exit(0);
                 break;
             case '--help':
             case '-h':
-                usageAndExit();
+                usageAndExit(undefined, flags.silent);
                 break;
             default:
-                usageAndExit(`Unknown flag: ${flag}`);
+                usageAndExit(`Unknown flag: ${flag}`, flags.silent);
         }
     }
     return flags;
@@ -421,20 +431,35 @@ async function executeCommand(command, args, flags) {
         case 'umbrella':
             await cmdUmbrella(args[0], args.slice(1), flags);
             break;
+        case 'help':
         case undefined:
-            usageAndExit('Missing command');
+            usageAndExit(undefined, flags.silent);
             break;
         default:
-            usageAndExit(`Unknown command: ${command}`);
+            usageAndExit(`Unknown command: ${command}`, flags.silent);
     }
 }
 async function main() {
     const args = process.argv.slice(2);
+    const isSilent = args.includes('--silent');
+    if (args.includes('--help') || args.includes('-h')) {
+        usageAndExit(undefined, isSilent);
+        return;
+    }
+    if (args.includes('--version') || args.includes('-v')) {
+        if (!isSilent) {
+            console.log('Timonel v0.1.0');
+        }
+        process.exit(0);
+    }
     const command = args.shift();
     const flags = parseFlags(args);
     await executeCommand(command, args, flags);
 }
 main().catch((error) => {
-    console.error('Error:', error.message);
+    const flags = parseFlags(process.argv.slice(2));
+    if (!flags.silent) {
+        console.error('Error:', error.message);
+    }
     process.exit(1);
 });

package/dist/lib/helmChartWriter.js

@@ -1,7 +1,7 @@
 import * as fs from 'fs';
 import * as path from 'path';
-import YAML from 'yaml';
 import { SecurityUtils } from './security.js';
+import { dumpHelmAwareYaml } from './utils/helmYamlSerializer.js';
 export class HelmChartWriter {
     static write(opts) {
         const { outDir, meta, defaultValues = {}, envValues = {}, assets, helpersTpl, notesTpl, valuesSchema, } = opts;
@@ -21,7 +21,7 @@ export class HelmChartWriter {
         fs.mkdirSync(path.join(outDir, 'templates'), { recursive: true });
     }
     static writeChartYaml(outDir, meta) {
-        const chartYaml = YAML.stringify({
+        const chartYaml = dumpHelmAwareYaml({
             apiVersion: 'v2',
             name: meta.name,
             version: meta.version,
@@ -39,10 +39,10 @@ export class HelmChartWriter {
         fs.writeFileSync(path.join(outDir, 'Chart.yaml'), chartYaml);
     }
     static writeValuesFiles(outDir, defaultValues, envValues) {
-        fs.writeFileSync(path.join(outDir, 'values.yaml'), YAML.stringify(defaultValues));
+        fs.writeFileSync(path.join(outDir, 'values.yaml'), dumpHelmAwareYaml(defaultValues));
         for (const [env, values] of Object.entries(envValues)) {
             const sanitizedEnv = SecurityUtils.sanitizeEnvironmentName(env);
-            fs.writeFileSync(path.join(outDir, `values-${sanitizedEnv}.yaml`), YAML.stringify(values));
+            fs.writeFileSync(path.join(outDir, `values-${sanitizedEnv}.yaml`), dumpHelmAwareYaml(values));
         }
     }
     static writeAssets(outDir, assets) {

package/dist/lib/rutter.js

@@ -1,8 +1,8 @@
 import { ApiObject, App, Chart, Testing } from 'cdk8s';
-import Handlebars from 'handlebars';
-import YAML from 'yaml';
+import * as jsYaml from 'js-yaml';
 import { include } from './helm.js';
 import { HelmChartWriter } from './helmChartWriter.js';
+import { dumpHelmAwareYaml } from './utils/helmYamlSerializer.js';
 import { AWSResources } from './resources/cloud/aws/awsResources.js';
 import { KarpenterResources } from './resources/cloud/aws/karpenterResources.js';
 import { generateHelpersTemplate } from './utils/helmHelpers.js';
@@ -56,7 +56,7 @@ export class Rutter {
         let manifestObject;
         if (typeof yamlOrObject === 'string') {
             try {
-                manifestObject = YAML.parse(yamlOrObject);
+                manifestObject = jsYaml.load(yamlOrObject);
             }
             catch (error) {
                 throw new Error(`Invalid YAML provided to addManifest(): ${error instanceof Error ? error.message : 'Unknown error'}`);
@@ -102,20 +102,12 @@ export class Rutter {
             helmCondition = `.Values.${condition}`;
         }
         try {
-            const yamlContent = YAML.stringify(manifestObject, {
+            const yamlContent = dumpHelmAwareYaml(manifestObject, {
                 lineWidth: 0,
-                doubleQuotedAsJSON: false,
-                simpleKeys: true,
-            });
-            const conditionalTemplate = `\\{{- if ${helmCondition} }}
-{{{manifestYaml}}}
-\\{{- end }}`;
-            const template = Handlebars.compile(conditionalTemplate, {
-                noEscape: true,
-            });
-            const conditionalYaml = template({
-                manifestYaml: yamlContent.trim(),
             });
+            const conditionalYaml = `{{- if ${helmCondition} }}
+${yamlContent.trim()}
+{{- end }}`;
             const conditionalAsset = {
                 id,
                 yaml: conditionalYaml,
@@ -124,7 +116,7 @@ export class Rutter {
             this.assets.push(conditionalAsset);
         }
         catch (error) {
-            throw new Error(`Failed to compile Handlebars template for manifest '${id}': ${error instanceof Error ? error.message : 'Unknown error'}`);
+            throw new Error(`Failed to generate conditional template for manifest '${id}': ${error instanceof Error ? error.message : 'Unknown error'}`);
         }
         return new ApiObject(this.chart, `${id}-placeholder`, {
             apiVersion: manifestObject['apiVersion'],
@@ -218,7 +210,7 @@ export class Rutter {
         const synthAssets = [];
         if (this.props.singleManifestFile) {
             const combinedYaml = enriched
-                .map((obj) => this.processHelmTemplates(YAML.stringify(obj).trim()))
+                .map((obj) => this.processHelmTemplates(dumpHelmAwareYaml(obj).trim()))
                 .filter(Boolean)
                 .join('\n---\n');
             const manifestId = this.props.manifestPrefix ?? 'manifests';
@@ -228,7 +220,7 @@ export class Rutter {
             enriched.forEach((obj, index) => {
                 const apiObjectId = apiObjectIds[index];
                 const manifestId = apiObjectId || `manifest-${index + 1}`;
-                const yaml = this.processHelmTemplates(YAML.stringify(obj).trim());
+                const yaml = this.processHelmTemplates(dumpHelmAwareYaml(obj).trim());
                 if (yaml) {
                     synthAssets.push({ id: manifestId, yaml });
                 }

package/dist/lib/templates/basic-chart.js

@@ -1,5 +1,6 @@
 import { Chart, ApiObject } from 'cdk8s';
 import { Rutter } from '../rutter.js';
+import { generateHelpersTemplate } from '../utils/helmHelpers.js';
 export class BasicChart extends Chart {
     constructor(scope, id, props = {}) {
         super(scope, id, props);
@@ -24,6 +25,10 @@ export class BasicChart extends Chart {
                 replicas,
                 createNamespace,
             },
+            helpersTpl: generateHelpersTemplate('aws', undefined, {
+                includeKubernetes: true,
+                includeSprig: true,
+            }),
         });
         if (createNamespace) {
             this.rutter.addConditionalManifest({
@@ -41,6 +46,11 @@ export class BasicChart extends Chart {
                 name: `{{ .Values.appName }}`,
                 labels: {
                     app: `{{ .Values.appName }}`,
+                    'helm.sh/chart': `{{ .Chart.Name }}-{{ .Chart.Version }}`,
+                    'app.kubernetes.io/name': `{{ .Chart.Name }}`,
+                    'app.kubernetes.io/instance': `{{ .Release.Name }}`,
+                    'app.kubernetes.io/version': `{{ .Chart.AppVersion }}`,
+                    'app.kubernetes.io/managed-by': `{{ .Release.Service }}`,
                 },
             },
             spec: {
@@ -48,12 +58,16 @@ export class BasicChart extends Chart {
                 selector: {
                     matchLabels: {
                         app: `{{ .Values.appName }}`,
+                        'app.kubernetes.io/name': `{{ .Chart.Name }}`,
+                        'app.kubernetes.io/instance': `{{ .Release.Name }}`,
                     },
                 },
                 template: {
                     metadata: {
                         labels: {
                             app: `{{ .Values.appName }}`,
+                            'app.kubernetes.io/name': `{{ .Chart.Name }}`,
+                            'app.kubernetes.io/instance': `{{ .Release.Name }}`,
                         },
                     },
                     spec: {
@@ -79,6 +93,11 @@ export class BasicChart extends Chart {
                 name: `{{ .Values.appName }}`,
                 labels: {
                     app: `{{ .Values.appName }}`,
+                    'helm.sh/chart': `{{ .Chart.Name }}-{{ .Chart.Version }}`,
+                    'app.kubernetes.io/name': `{{ .Chart.Name }}`,
+                    'app.kubernetes.io/instance': `{{ .Release.Name }}`,
+                    'app.kubernetes.io/version': `{{ .Chart.AppVersion }}`,
+                    'app.kubernetes.io/managed-by': `{{ .Release.Service }}`,
                 },
             },
             spec: {
@@ -90,6 +109,8 @@ export class BasicChart extends Chart {
                 ],
                 selector: {
                     app: `{{ .Values.appName }}`,
+                    'app.kubernetes.io/name': `{{ .Chart.Name }}`,
+                    'app.kubernetes.io/instance': `{{ .Release.Name }}`,
                 },
             },
         }, 'service');

package/dist/lib/templates/subchart.js

@@ -1,5 +1,6 @@
 import { App, Chart } from 'cdk8s';
 import { Rutter } from '../rutter.js';
+import { generateHelpersTemplate } from '../utils/helmHelpers.js';
 export class Subchart extends Chart {
     constructor(scope, id, props = {}) {
         super(scope, id, props);
@@ -39,6 +40,10 @@ export class Subchart extends Chart {
                     tls: [],
                 },
             },
+            helpersTpl: generateHelpersTemplate('aws', undefined, {
+                includeKubernetes: true,
+                includeSprig: true,
+            }),
         });
         this.rutter.addManifest({
             apiVersion: 'v1',
@@ -131,54 +136,47 @@ export class Subchart extends Chart {
                 },
             },
         }, 'service');
-        this.rutter.addTemplateManifest(`{{- if .Values.enableIngress }}
-apiVersion: networking.k8s.io/v1
-kind: Ingress
-metadata:
-  name: {{ include "chart.fullname" . }}
-  labels:
-    {{- include "chart.labels" . | nindent 4 }}
-  {{- with .Values.ingress.annotations }}
-  annotations:
-    {{- toYaml . | nindent 4 }}
-  {{- end }}
-spec:
-  {{- if and .Values.ingress.className (not (hasKey .Values.ingress.annotations "kubernetes.io/ingress.class")) }}
-  ingressClassName: {{ .Values.ingress.className }}
-  {{- end }}
-  {{- if .Values.ingress.tls }}
-  tls:
-    {{- range .Values.ingress.tls }}
-    - hosts:
-        {{- range .hosts }}
-        - {{ . | quote }}
-        {{- end }}
-      secretName: {{ .secretName }}
-    {{- end }}
-  {{- end }}
-  rules:
-    {{- range .Values.ingress.hosts }}
-    - host: {{ .host | quote }}
-      http:
-        paths:
-          {{- range .paths }}
-          - path: {{ .path }}
-            {{- if and .pathType (semverCompare ">=1.18-0" $.Capabilities.KubeVersion.GitVersion) }}
-            pathType: {{ .pathType }}
-            {{- end }}
-            backend:
-              {{- if semverCompare ">=1.19-0" $.Capabilities.KubeVersion.GitVersion }}
-              service:
-                name: {{ include "chart.fullname" $ }}
-                port:
-                  number: {{ $.Values.port | int }}
-              {{- else }}
-              serviceName: {{ include "chart.fullname" $ }}
-              servicePort: {{ $.Values.port | int }}
-              {{- end }}
-          {{- end }}
-    {{- end }}
-{{- end }}`, 'ingress');
+        this.rutter.addConditionalManifest({
+            apiVersion: 'networking.k8s.io/v1',
+            kind: 'Ingress',
+            metadata: {
+                name: `{{ .Release.Name }}-{{ .Values.appName }}`,
+                labels: {
+                    app: `{{ .Values.appName }}`,
+                    'helm.sh/chart': `{{ .Chart.Name }}-{{ .Chart.Version }}`,
+                    'app.kubernetes.io/name': `{{ .Chart.Name }}`,
+                    'app.kubernetes.io/instance': `{{ .Release.Name }}`,
+                    'app.kubernetes.io/version': `{{ .Chart.AppVersion }}`,
+                    'app.kubernetes.io/managed-by': `{{ .Release.Service }}`,
+                },
+                annotations: `{{ toYaml .Values.ingress.annotations | nindent 4 }}`,
+            },
+            spec: {
+                ingressClassName: `{{ .Values.ingress.className }}`,
+                tls: `{{ toYaml .Values.ingress.tls | nindent 4 }}`,
+                rules: [
+                    {
+                        host: `{{ .Values.ingressHost }}`,
+                        http: {
+                            paths: [
+                                {
+                                    path: '/',
+                                    pathType: 'Prefix',
+                                    backend: {
+                                        service: {
+                                            name: `{{ .Release.Name }}-{{ .Values.appName }}`,
+                                            port: {
+                                                number: `{{ .Values.port }}`,
+                                            },
+                                        },
+                                    },
+                                },
+                            ],
+                        },
+                    },
+                ],
+            },
+        }, 'enableIngress', 'ingress');
     }
     get rutterInstance() {
         return this.rutter;

package/dist/lib/templates/umbrella-chart.js

@@ -1,7 +1,8 @@
 import { writeFileSync, mkdirSync, existsSync } from 'fs';
 import { join } from 'path';
 import { Chart, ApiObject } from 'cdk8s';
-import YAML from 'yaml';
+import { dumpHelmAwareYaml } from '../utils/helmYamlSerializer.js';
+import { generateHelpersTemplate } from '../utils/helmHelpers.js';
 export function generateUmbrellaChart(name) {
     return `import { App } from 'cdk8s';
 import { UmbrellaChart } from 'timonel';
@@ -110,7 +111,7 @@ export class UmbrellaChartTemplate extends Chart {
                 repository: 'file://./charts/' + subchart.name,
             })) || [],
         };
-        writeFileSync(join(outputDir, 'Chart.yaml'), YAML.stringify(chartYaml));
+        writeFileSync(join(outputDir, 'Chart.yaml'), dumpHelmAwareYaml(chartYaml));
         const valuesYaml = {
             global: {
                 namespace: this.config.name,
@@ -122,7 +123,7 @@ export class UmbrellaChartTemplate extends Chart {
                 },
             ]) || []),
         };
-        writeFileSync(join(outputDir, 'values.yaml'), YAML.stringify(valuesYaml));
+        writeFileSync(join(outputDir, 'values.yaml'), dumpHelmAwareYaml(valuesYaml));
         const chartsDir = join(outputDir, 'charts');
         if (!existsSync(chartsDir)) {
             mkdirSync(chartsDir, { recursive: true });
@@ -159,64 +160,18 @@ export class UmbrellaChartTemplate extends Chart {
             metadata: {
                 name: '{{ .Values.global.namespace | default .Release.Name }}',
                 labels: {
-                    'app.kubernetes.io/name': '{{ include "chart.name" . }}',
+                    'app.kubernetes.io/name': '{{ .Chart.Name }}',
                     'app.kubernetes.io/instance': '{{ .Release.Name }}',
                     'app.kubernetes.io/version': '{{ .Chart.AppVersion }}',
                     'app.kubernetes.io/managed-by': '{{ .Release.Service }}',
                 },
             },
         };
-        writeFileSync(join(templatesDir, 'namespace.yaml'), YAML.stringify(namespaceYaml));
-        const helpersTpl = `{{/*
-Expand the name of the chart.
-*/}}
-{{- define "chart.name" -}}
-{{- default .Chart.Name .Values.nameOverride | trunc 63 | trimSuffix "-" }}
-{{- end }}
-
-{{/*
-Create a default fully qualified app name.
-*/}}
-{{- define "chart.fullname" -}}
-{{- if .Values.fullnameOverride }}
-{{- .Values.fullnameOverride | trunc 63 | trimSuffix "-" }}
-{{- else }}
-{{- $name := default .Chart.Name .Values.nameOverride }}
-{{- if contains $name .Release.Name }}
-{{- .Release.Name | trunc 63 | trimSuffix "-" }}
-{{- else }}
-{{- printf "%s-%s" .Release.Name $name | trunc 63 | trimSuffix "-" }}
-{{- end }}
-{{- end }}
-{{- end }}
-
-{{/*
-Create chart name and version as used by the chart label.
-*/}}
-{{- define "chart.chart" -}}
-{{- printf "%s-%s" .Chart.Name .Chart.Version | replace "+" "_" | trunc 63 | trimSuffix "-" }}
-{{- end }}
-
-{{/*
-Common labels
-*/}}
-{{- define "chart.labels" -}}
-helm.sh/chart: {{ include "chart.chart" . }}
-{{ include "chart.selectorLabels" . }}
-{{- if .Chart.AppVersion }}
-app.kubernetes.io/version: {{ .Chart.AppVersion | quote }}
-{{- end }}
-app.kubernetes.io/managed-by: {{ .Release.Service }}
-{{- end }}
-
-{{/*
-Selector labels
-*/}}
-{{- define "chart.selectorLabels" -}}
-app.kubernetes.io/name: {{ include "chart.name" . }}
-app.kubernetes.io/instance: {{ .Release.Name }}
-{{- end }}
-`;
+        writeFileSync(join(templatesDir, 'namespace.yaml'), dumpHelmAwareYaml(namespaceYaml));
+        const helpersTpl = generateHelpersTemplate('aws', undefined, {
+            includeKubernetes: true,
+            includeSprig: true,
+        });
         writeFileSync(join(templatesDir, '_helpers.tpl'), helpersTpl);
     }
 }

package/dist/lib/umbrellaRutter.js

@@ -1,7 +1,7 @@
 import { writeFileSync, mkdirSync } from 'fs';
 import { join } from 'path';
-import YAML from 'yaml';
 import { SecurityUtils } from './security.js';
+import { dumpHelmAwareYaml } from './utils/helmYamlSerializer.js';
 export class UmbrellaRutter {
     constructor(props) {
         this.validateMetadata(props.meta);
@@ -54,7 +54,7 @@ export class UmbrellaRutter {
                 };
             }),
         };
-        writeFileSync(join(outDir, 'Chart.yaml'), YAML.stringify(chartYaml));
+        writeFileSync(join(outDir, 'Chart.yaml'), dumpHelmAwareYaml(chartYaml));
     }
     writeParentValues(outDir) {
         const values = {
@@ -68,12 +68,12 @@ export class UmbrellaRutter {
                 };
             }
         }
-        writeFileSync(join(outDir, 'values.yaml'), YAML.stringify(values));
+        writeFileSync(join(outDir, 'values.yaml'), dumpHelmAwareYaml(values));
         if (this.props.envValues) {
             for (const [env, envVals] of Object.entries(this.props.envValues)) {
                 const sanitizedEnv = SecurityUtils.sanitizeEnvironmentName(env);
                 const envValues = this.deepMerge(values, envVals);
-                writeFileSync(join(outDir, `values-${sanitizedEnv}.yaml`), YAML.stringify(envValues));
+                writeFileSync(join(outDir, `values-${sanitizedEnv}.yaml`), dumpHelmAwareYaml(envValues));
             }
         }
     }

package/dist/lib/utils/helmYamlSerializer.d.ts

@@ -0,0 +1,8 @@
+import * as jsYaml from 'js-yaml';
+export declare function dumpHelmAwareYaml(obj: unknown, options?: jsYaml.DumpOptions): string;
+export declare function stringify(obj: unknown, options?: {
+    lineWidth?: number;
+    doubleQuotedAsJSON?: boolean;
+    simpleKeys?: boolean;
+}): string;
+export declare function validateHelmExpressions(yaml: string): boolean;

package/dist/lib/utils/helmYamlSerializer.js

@@ -0,0 +1,88 @@
+import * as jsYaml from 'js-yaml';
+const HELM_EXPRESSION_PATTERNS = [
+    /\{\{\s*[^}]+\s*\}\}/g,
+    /\{\{\s*include\s+[^}]+\s*\}\}/g,
+    /\{\{\s*if\s+[^}]+\s*\}\}/g,
+    /\{\{\s*else\s*\}\}/g,
+    /\{\{\s*end\s*\}\}/g,
+    /\{\{\s*range\s+[^}]+\s*\}\}/g,
+    /\{\{\s*with\s+[^}]+\s*\}\}/g,
+    /\{\{\s*\$[^}]+\s*\}\}/g,
+    /\{\{\s*[^}]*\|\s*[^}]+\s*\}\}/g,
+];
+function createHelmExpression(value) {
+    return {
+        __helmExpression: true,
+        value,
+    };
+}
+function isHelmExpression(value) {
+    return (typeof value === 'object' &&
+        value !== null &&
+        '__helmExpression' in value &&
+        value.__helmExpression === true);
+}
+function containsHelmExpression(str) {
+    return HELM_EXPRESSION_PATTERNS.some((pattern) => pattern.test(str));
+}
+function preprocessHelmExpressions(obj) {
+    if (typeof obj === 'string') {
+        if (containsHelmExpression(obj)) {
+            return createHelmExpression(obj);
+        }
+        return obj;
+    }
+    if (Array.isArray(obj)) {
+        return obj.map(preprocessHelmExpressions);
+    }
+    if (obj && typeof obj === 'object') {
+        const result = {};
+        for (const [key, value] of Object.entries(obj)) {
+            Object.defineProperty(result, key, {
+                value: preprocessHelmExpressions(value),
+                writable: true,
+                enumerable: true,
+                configurable: true,
+            });
+        }
+        return result;
+    }
+    return obj;
+}
+function helmAwareReplacer(key, value) {
+    if (isHelmExpression(value)) {
+        return value.value;
+    }
+    return value;
+}
+export function dumpHelmAwareYaml(obj, options = {}) {
+    const preprocessed = preprocessHelmExpressions(obj);
+    const helmOptions = {
+        forceQuotes: false,
+        lineWidth: options.lineWidth ?? 0,
+        flowLevel: options.flowLevel ?? -1,
+        replacer: helmAwareReplacer,
+        ...options,
+    };
+    let yamlOutput = jsYaml.dump(preprocessed, helmOptions);
+    yamlOutput = postProcessHelmExpressions(yamlOutput);
+    return yamlOutput;
+}
+function postProcessHelmExpressions(yaml) {
+    let processed = yaml;
+    processed = processed.replace(/'(\{\{[^}]*\}\})'/g, '$1');
+    processed = processed.replace(/"(\{\{[^}]*\}\})"/g, '$1');
+    processed = processed.replace(/\\(\{\{[^}]*\}\})/g, '$1');
+    return processed;
+}
+export function stringify(obj, options = {}) {
+    const jsYamlOptions = {
+        lineWidth: options.lineWidth ?? 0,
+        quotingType: options.doubleQuotedAsJSON ? '"' : "'",
+    };
+    return dumpHelmAwareYaml(obj, jsYamlOptions);
+}
+export function validateHelmExpressions(yaml) {
+    const quotedHelmExpressions = [/'(\{\{[^}]*\}\})'/g, /"(\{\{[^}]*\}\})"/g];
+    return !quotedHelmExpressions.some((pattern) => pattern.test(yaml));
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "timonel",
   "type": "module",
-  "version": "2.9.1",
+  "version": "2.9.2",
   "description": "Timonel: programmatic Helm chart generator using cdk8s (TypeScript)",
   "bin": {
     "timonel": "dist/cli.js",
@@ -85,6 +85,7 @@
     "cdk8s-plus-33": "^2.3.5",
     "constructs": "^10.4.2",
     "handlebars": "^4.7.8",
+    "js-yaml": "^4.1.0",
     "timonel": "^2.9.0",
     "ts-node": "^10.9.2",
     "yaml": "^2.8.1"
@@ -96,6 +97,7 @@
     "@semantic-release/changelog": "^6.0.3",
     "@semantic-release/exec": "^7.1.0",
     "@semantic-release/git": "^10.0.1",
+    "@types/js-yaml": "^4.0.9",
     "@types/node": "^24.3.0",
     "@typescript-eslint/eslint-plugin": "^8.42.0",
     "@typescript-eslint/parser": "^8.42.0",