@shepherdjerred/helm-types 1.7.0 → 2.0.0

package/dist/yaml-comment-regex-parser.js

@@ -0,0 +1,120 @@
+/**
+ * Regex-based fallback parser for comments that the YAML AST loses
+ * This handles cases with commented-out YAML keys and inconsistent indentation
+ * Returns comments with metadata for debugging
+ */
+export function parseCommentsWithRegex(yamlContent) {
+    const comments = new Map();
+    const lines = yamlContent.split("\n");
+    let pendingComment = [];
+    let pendingCommentIndent = -1;
+    let pendingDebugInfo = [];
+    lines.forEach((line, lineNum) => {
+        const trimmed = line.trim();
+        // Skip empty lines - blank lines reset pending comments
+        // This ensures comments for commented-out keys don't leak to next real key
+        if (!trimmed) {
+            // Only reset if we had a commented-out key (pendingCommentIndent === -1)
+            // This allows multi-line comments for real keys to work
+            if (pendingCommentIndent === -1 && pendingComment.length > 0) {
+                pendingDebugInfo.push(`Line ${String(lineNum)}: Blank line after commented-out key, resetting pending`);
+                pendingComment = [];
+                pendingDebugInfo = [];
+            }
+            return;
+        }
+        // Check if this is a comment line
+        if (trimmed.startsWith("#")) {
+            // Extract comment text (handle multiple # characters)
+            let commentText = trimmed;
+            while (commentText.startsWith("#")) {
+                commentText = commentText.slice(1);
+            }
+            commentText = commentText.trim();
+            // Skip commented-out YAML keys (these are not documentation)
+            // Match patterns like "key: value" or "key:" but NOT prose-like text
+            // This includes quoted values like: key: "value"
+            const looksLikeYAMLKeyLocal = /^[\w.-]+:\s*(?:\||$|[\w.-]+$|"[^"]*"$|'[^']*'$|[[{])/.test(commentText);
+            if (looksLikeYAMLKeyLocal) {
+                // This is a commented-out YAML key, which means the pending comments
+                // were describing this commented-out section, not a future real key
+                // So we should discard them
+                pendingDebugInfo.push(`Line ${String(lineNum)}: Commented-out YAML key detected: "${commentText}", discarding pending`);
+                pendingComment = [];
+                pendingCommentIndent = -1;
+                pendingDebugInfo = [];
+            }
+            else {
+                const commentIndent = line.search(/\S/);
+                // If we just discarded comments (indent === -1), this is a fresh start
+                if (pendingCommentIndent === -1) {
+                    pendingComment = [commentText];
+                    pendingCommentIndent = commentIndent;
+                    pendingDebugInfo = [
+                        `Line ${String(lineNum)}: Fresh start (indent=${String(commentIndent)}): "${commentText}"`,
+                    ];
+                }
+                else if (commentIndent === pendingCommentIndent ||
+                    Math.abs(commentIndent - pendingCommentIndent) <= 2) {
+                    // Same indent level, add to pending
+                    pendingComment.push(commentText);
+                    pendingDebugInfo.push(`Line ${String(lineNum)}: Continuing (indent=${String(commentIndent)}): "${commentText}"`);
+                }
+                else {
+                    // Different indent, reset
+                    pendingDebugInfo.push(`Line ${String(lineNum)}: Different indent (${String(commentIndent)} vs ${String(pendingCommentIndent)}), resetting`);
+                    pendingComment = [commentText];
+                    pendingCommentIndent = commentIndent;
+                    pendingDebugInfo.push(`Line ${String(lineNum)}: New start: "${commentText}"`);
+                }
+            }
+            return;
+        }
+        // Check if this is a YAML key line
+        const keyMatchRegex = /^([\w.-]+):\s/;
+        const keyMatch = keyMatchRegex.exec(trimmed);
+        if (keyMatch && pendingComment.length > 0) {
+            const key = keyMatch[1];
+            if (key !== "" && key != null) {
+                const keyIndent = line.search(/\S/);
+                // Only associate comment if indentation matches closely
+                // Allow 2 space difference (for comment being indented slightly different)
+                if (pendingCommentIndent === -1 ||
+                    Math.abs(keyIndent - pendingCommentIndent) <= 2) {
+                    const commentText = pendingComment.join("\n");
+                    const debugInfo = [
+                        ...pendingDebugInfo,
+                        `Line ${String(lineNum)}: Associating with key "${key}"`,
+                    ].join("\n");
+                    comments.set(key, {
+                        text: commentText,
+                        metadata: {
+                            source: "REGEX",
+                            rawComment: commentText,
+                            indent: keyIndent,
+                            debugInfo,
+                        },
+                    });
+                }
+                else {
+                    pendingDebugInfo.push(`Line ${String(lineNum)}: Skipping key "${key}" due to indent mismatch (${String(keyIndent)} vs ${String(pendingCommentIndent)})`);
+                }
+                // Reset for next key
+                pendingComment = [];
+                pendingCommentIndent = -1;
+                pendingDebugInfo = [];
+            }
+        }
+        else if (!trimmed.startsWith("#")) {
+            // Non-comment, non-key line - reset pending comment
+            if (pendingComment.length > 0) {
+                pendingDebugInfo.push(`Line ${String(lineNum)}: Non-comment/non-key line, resetting pending`);
+            }
+            pendingComment = [];
+            pendingCommentIndent = -1;
+            pendingDebugInfo = [];
+        }
+    });
+    return comments;
+}
+//# sourceMappingURL=yaml-comment-regex-parser.js.map

package/dist/yaml-comment-regex-parser.js.map

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

package/dist/yaml-comments.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Metadata about how a comment was extracted
+ */
+export type CommentMetadata = {
+    source: "AST" | "REGEX";
+    rawComment?: string;
+    indent?: number;
+    debugInfo?: string;
+};
+/**
+ * Comment with metadata for debugging
+ */
+export type CommentWithMetadata = {
+    text: string;
+    metadata: CommentMetadata;
+};
+/**
+ * Helper: Check if a line looks like a YAML key (e.g., "key: value" or "key:")
+ * Exported for testing purposes
+ */
+export declare function isYAMLKey(line: string): boolean;
+/**
+ * Helper: Check if a line looks like a simple YAML value assignment
+ * Exported for testing purposes
+ */
+export declare function isSimpleYAMLValue(line: string): boolean;
+/**
+ * Helper: Check if a line is a section header (short line followed by YAML config)
+ * Exported for testing purposes
+ */
+export declare function isSectionHeader(line: string, nextLine?: string): boolean;
+/**
+ * Helper: Check if a line looks like code/YAML example
+ * Exported for testing purposes
+ */
+export declare function isCodeExample(line: string, wordCount: number): boolean;
+/**
+ * Helper: Check if a line looks like prose (real documentation)
+ * Exported for testing purposes
+ */
+export declare function looksLikeProse(line: string, wordCount: number): boolean;
+/**
+ * Helper: Normalize a comment line by removing markers
+ * Exported for testing purposes
+ */
+export declare function normalizeCommentLine(line: string): string;
+/**
+ * Clean up YAML comment text for use in JSDoc
+ * Removes Helm-specific markers and filters out code examples and section headers
+ */
+export declare function cleanYAMLComment(comment: string): string;
+/**
+ * Parse Bitnami-style @param directives from a comment
+ * Format: @param key.path Description
+ * Returns: Map of extracted params and remaining non-param lines
+ * Exported for testing purposes
+ */
+export declare function parseBitnamiParams(comment: string): {
+    params: Map<string, string>;
+    remainingLines: string[];
+};
+/**
+ * Parse YAML comments with metadata for debugging
+ * Returns comments with information about how they were extracted
+ * Exported for testing purposes
+ */
+export declare function parseYAMLCommentsWithMetadata(yamlContent: string): Map<string, CommentWithMetadata>;
+/**
+ * Parse YAML comments and associate them with keys
+ * Returns a simple Map<string, string> for backward compatibility
+ * Exported for testing purposes
+ */
+export declare function parseYAMLComments(yamlContent: string): Map<string, string>;
+//# sourceMappingURL=yaml-comments.d.ts.map

package/dist/yaml-comments.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"yaml-comments.d.ts","sourceRoot":"","sources":["../src/yaml-comments.ts"],"names":[],"mappings":"AAMA;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG;IAC5B,MAAM,EAAE,KAAK,GAAG,OAAO,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,eAAe,CAAC;CAC3B,CAAC;AAEF;;;GAGG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAE/C;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAIvD;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAiCxE;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CA0BtE;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAsBvE;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAOzD;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CA2ExD;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG;IACnD,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC5B,cAAc,EAAE,MAAM,EAAE,CAAC;CAC1B,CA4BA;AAED;;;;GAIG;AACH,wBAAgB,6BAA6B,CAC3C,WAAW,EAAE,MAAM,GAClB,GAAG,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAiNlC;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAS1E"}

package/dist/yaml-comments.js

@@ -0,0 +1,406 @@
+import { parseDocument } from "yaml";
+import { z } from "zod";
+import { filterCommentedOutYAML } from "./yaml-comment-filters.js";
+import { parseCommentsWithRegex } from "./yaml-comment-regex-parser.js";
+import { preprocessYAMLComments } from "./yaml-preprocess.js";
+/**
+ * Helper: Check if a line looks like a YAML key (e.g., "key: value" or "key:")
+ * Exported for testing purposes
+ */
+export function isYAMLKey(line) {
+    return /^[\w.-]+:\s*(?:\||$)/.test(line);
+}
+/**
+ * Helper: Check if a line looks like a simple YAML value assignment
+ * Exported for testing purposes
+ */
+export function isSimpleYAMLValue(line) {
+    const hasURL = line.includes("http://") || line.includes("https://");
+    const isRef = /^ref:/i.test(line);
+    return /^[\w.-]+:\s[^:]+$/.test(line) && !hasURL && !isRef;
+}
+/**
+ * Helper: Check if a line is a section header (short line followed by YAML config)
+ * Exported for testing purposes
+ */
+export function isSectionHeader(line, nextLine) {
+    if (nextLine === "" || nextLine == null) {
+        return false;
+    }
+    const isFollowedByYAMLKey = /^[\w.-]+:\s*\|/.test(nextLine) ||
+        /^[\w.-]+:\s*$/.test(nextLine) ||
+        /^[\w.-]+:\s+/.test(nextLine);
+    if (!isFollowedByYAMLKey) {
+        return false;
+    }
+    const wordCount = line.split(/\s+/).length;
+    const hasConfigKeywords = /\b(?:configuration|config|example|setup|settings?|options?|alternative)\b/i.test(line);
+    const endsWithPunctuation = /[.!?]$/.test(line);
+    const hasURL = line.includes("http://") || line.includes("https://");
+    const startsWithArticle = /^(?:This|The|A|An)\s/i.test(line);
+    const startsWithCommonWord = /^(?:This|The|A|An|It|For|To|If|When|You|We|Use|Configure)\s/i.test(line);
+    return (((wordCount === 2 && !startsWithCommonWord) ||
+        (hasConfigKeywords && !startsWithCommonWord)) &&
+        !endsWithPunctuation &&
+        !hasURL &&
+        !/^ref:/i.test(line) &&
+        !startsWithArticle);
+}
+/**
+ * Helper: Check if a line looks like code/YAML example
+ * Exported for testing purposes
+ */
+export function isCodeExample(line, wordCount) {
+    const looksLikeYAMLKey = isYAMLKey(line);
+    const looksLikeSimpleYAMLValue = isSimpleYAMLValue(line);
+    const looksLikeYAMLList = line.startsWith("-") && (line.includes(":") || /^-\s+\|/.test(line));
+    const looksLikePolicyRule = /^[pg],\s*/.test(line);
+    const hasIndentation = /^\s{2,}/.test(line);
+    const looksLikeCommand = /^echo\s+/.test(line) ||
+        line.includes("$ARGOCD_") ||
+        line.includes("$KUBE_");
+    const isSeparator = /^-{3,}/.test(line) ||
+        /^BEGIN .*(?:KEY|CERTIFICATE)/.test(line) ||
+        /^END .*(?:KEY|CERTIFICATE)/.test(line);
+    return (isSeparator ||
+        looksLikeYAMLKey ||
+        (looksLikeSimpleYAMLValue && wordCount <= 4) ||
+        looksLikeYAMLList ||
+        looksLikePolicyRule ||
+        hasIndentation ||
+        looksLikeCommand ||
+        line.startsWith("|"));
+}
+/**
+ * Helper: Check if a line looks like prose (real documentation)
+ * Exported for testing purposes
+ */
+export function looksLikeProse(line, wordCount) {
+    const hasURL = line.includes("http://") || line.includes("https://");
+    const startsWithCapital = /^[A-Z]/.test(line);
+    const hasEndPunctuation = /[.!?:]$/.test(line);
+    const notYamlKey = !(!hasURL && isYAMLKey(line) && !/^ref:/i.test(line));
+    const reasonableLength = line.length > 10;
+    const hasMultipleWords = wordCount >= 3;
+    const startsWithArticle = /^(?:This|The|A|An)\s/i.test(line);
+    // Lines starting with markers like ^, ->, etc. are documentation references
+    const isReferenceMarker = /^(?:\^|->|→)\s/.test(line);
+    return ((startsWithCapital || isReferenceMarker) &&
+        (hasEndPunctuation ||
+            hasURL ||
+            startsWithArticle ||
+            hasMultipleWords ||
+            isReferenceMarker) &&
+        notYamlKey &&
+        reasonableLength);
+}
+/**
+ * Helper: Normalize a comment line by removing markers
+ * Exported for testing purposes
+ */
+export function normalizeCommentLine(line) {
+    let normalized = line.trim();
+    normalized = normalized.replace(/^#+\s*/, ""); // Remove leading # symbols
+    normalized = normalized.replace(/^--\s*/, ""); // Remove Helm's -- marker
+    normalized = normalized.replace(/^@param\s+[\w.-]+\s+/, ""); // Remove Bitnami's @param prefix
+    normalized = normalized.replace(/^@section\s+/, ""); // Remove Bitnami's @section prefix
+    return normalized.trim();
+}
+/**
+ * Clean up YAML comment text for use in JSDoc
+ * Removes Helm-specific markers and filters out code examples and section headers
+ */
+export function cleanYAMLComment(comment) {
+    if (!comment) {
+        return "";
+    }
+    // Normalize all lines
+    const lines = comment.split("\n").map((line) => normalizeCommentLine(line));
+    // Filter out code examples and section headers, keep documentation
+    const cleaned = [];
+    let inCodeBlock = false;
+    let inExample = false; // Track if we're in an "Example:" section (keep these!)
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i] ?? "";
+        // Empty lines end code blocks (but not examples)
+        if (!line) {
+            if (inCodeBlock && !inExample) {
+                inCodeBlock = false;
+            }
+            continue;
+        }
+        // Skip @default lines (we'll generate our own)
+        if (line.startsWith("@default")) {
+            continue;
+        }
+        // Check if this line starts an Example section (preserve these!)
+        if (/^Example:?$/i.test(line.trim())) {
+            inExample = true;
+            inCodeBlock = true; // Treat examples as special code blocks
+            cleaned.push(line);
+            continue;
+        }
+        const nextLine = lines[i + 1];
+        const wordCount = line.split(/\s+/).length;
+        // Skip section headers
+        if (isSectionHeader(line, nextLine)) {
+            continue;
+        }
+        // If we're in an example section, keep all lines (including code)
+        if (inExample) {
+            cleaned.push(line);
+            // Check if we're exiting the example section
+            if (line.startsWith("For more information") || line.startsWith("Ref:")) {
+                inExample = false;
+                inCodeBlock = false;
+            }
+            continue;
+        }
+        // Check if this line is a code example
+        if (isCodeExample(line, wordCount)) {
+            inCodeBlock = true;
+            continue;
+        }
+        // Resume prose when we hit a proper sentence
+        if (inCodeBlock) {
+            if (looksLikeProse(line, wordCount)) {
+                inCodeBlock = false;
+            }
+            else {
+                continue;
+            }
+        }
+        cleaned.push(line);
+    }
+    return cleaned.join("\n").trim();
+}
+/**
+ * Parse Bitnami-style @param directives from a comment
+ * Format: @param key.path Description
+ * Returns: Map of extracted params and remaining non-param lines
+ * Exported for testing purposes
+ */
+export function parseBitnamiParams(comment) {
+    const lines = comment.split("\n");
+    const params = new Map();
+    const remainingLines = [];
+    for (const line of lines) {
+        const trimmedLine = line
+            .trim()
+            .replace(/^#+\s*/, "")
+            .replace(/^--\s*/, "");
+        const paramMatch = /^@param\s+([\w.-]+)\s+(\S.*)$/.exec(trimmedLine);
+        if (paramMatch) {
+            const [, paramKey, description] = paramMatch;
+            if (paramKey !== "" &&
+                description !== "" &&
+                paramKey != null &&
+                description != null) {
+                params.set(paramKey, description);
+            }
+        }
+        else if (trimmedLine) {
+            remainingLines.push(trimmedLine);
+        }
+    }
+    return { params, remainingLines };
+}
+/**
+ * Parse YAML comments with metadata for debugging
+ * Returns comments with information about how they were extracted
+ * Exported for testing purposes
+ */
+export function parseYAMLCommentsWithMetadata(yamlContent) {
+    const comments = new Map();
+    try {
+        // Pre-process to uncomment commented-out keys
+        // This allows Helm chart commented-out options to be parsed as real keys
+        const preprocessedYaml = preprocessYAMLComments(yamlContent);
+        const doc = parseDocument(preprocessedYaml);
+        // Build a regex-based fallback map for cases where YAML parser loses comments
+        // Use preprocessed YAML so commented-out keys are treated as real keys
+        const regexComments = parseCommentsWithRegex(preprocessedYaml);
+        // Zod schemas for YAML AST parsing, defined once
+        const MapNodeSchema = z.object({
+            items: z.array(z.unknown()),
+            commentBefore: z.unknown().optional(),
+        });
+        const PairSchema = z.object({ key: z.unknown(), value: z.unknown() });
+        const KeyValueSchema = z.object({ value: z.string() });
+        const CommentBeforeSchema = z.object({ commentBefore: z.unknown() });
+        const InlineCommentSchema = z.object({ comment: z.unknown() });
+        /**
+         * Extract the commentBefore string from a YAML node
+         */
+        function extractCommentBefore(node) {
+            const check = CommentBeforeSchema.safeParse(node);
+            if (!check.success) {
+                return "";
+            }
+            const strCheck = z.string().safeParse(check.data.commentBefore);
+            return strCheck.success ? strCheck.data : "";
+        }
+        /**
+         * Extract the inline comment string from a YAML value node
+         */
+        function extractInlineComment(node) {
+            const check = InlineCommentSchema.safeParse(node);
+            if (!check.success) {
+                return "";
+            }
+            const strCheck = z.string().safeParse(check.data.comment);
+            return strCheck.success ? strCheck.data : "";
+        }
+        /**
+         * Collect all comment sources for a YAML pair (key comment, pair comment, inline comment)
+         */
+        function collectItemComment(pairData, context) {
+            let comment = extractCommentBefore(pairData.keyNode);
+            const pairComment = extractCommentBefore(pairData.item);
+            if (pairComment) {
+                comment = comment ? `${pairComment}\n${comment}` : pairComment;
+            }
+            const inlineComment = extractInlineComment(pairData.valueNode);
+            if (inlineComment) {
+                comment = comment ? `${comment}\n${inlineComment}` : inlineComment;
+            }
+            // First item inherits map comment if it has none
+            if (!comment && context.index === 0 && context.mapComment) {
+                comment = context.mapComment;
+            }
+            if (comment) {
+                comment = filterCommentedOutYAML(comment);
+            }
+            return comment;
+        }
+        /**
+         * Store a comment (with @param handling) into the comments map
+         */
+        function storeComment(comment, fullKey) {
+            const hasParamDirective = comment.includes("@param ");
+            if (hasParamDirective) {
+                const { params, remainingLines } = parseBitnamiParams(comment);
+                for (const [paramKey, description] of params.entries()) {
+                    comments.set(paramKey, {
+                        text: description,
+                        metadata: {
+                            source: "AST",
+                            rawComment: comment,
+                            debugInfo: `Bitnami @param directive for ${paramKey}`,
+                        },
+                    });
+                }
+                const remainingCleaned = remainingLines.length > 0
+                    ? cleanYAMLComment(remainingLines.join("\n"))
+                    : "";
+                if (remainingCleaned) {
+                    comments.set(fullKey, {
+                        text: remainingCleaned,
+                        metadata: {
+                            source: "AST",
+                            rawComment: comment,
+                            debugInfo: `AST comment after extracting @param directives`,
+                        },
+                    });
+                }
+            }
+            else if (comment) {
+                const cleaned = cleanYAMLComment(comment);
+                if (cleaned) {
+                    comments.set(fullKey, {
+                        text: cleaned,
+                        metadata: {
+                            source: "AST",
+                            rawComment: comment,
+                            debugInfo: `Direct AST comment for ${fullKey}`,
+                        },
+                    });
+                }
+            }
+        }
+        // Recursively walk the YAML AST and extract comments
+        function visitNode(node, keyPath = [], inheritedComment = "") {
+            if (node == null) {
+                return;
+            }
+            const mapNodeCheck = MapNodeSchema.safeParse(node);
+            if (!mapNodeCheck.success) {
+                return;
+            }
+            // Extract the map's own comment (to be inherited by first child if needed)
+            let mapComment = inheritedComment;
+            const mapCommentCheck = z
+                .string()
+                .safeParse(mapNodeCheck.data.commentBefore);
+            if (mapCommentCheck.success) {
+                mapComment = mapCommentCheck.data;
+            }
+            for (let i = 0; i < mapNodeCheck.data.items.length; i++) {
+                const item = mapNodeCheck.data.items[i];
+                const itemCheck = PairSchema.safeParse(item);
+                if (!itemCheck.success) {
+                    continue;
+                }
+                const keyNodeCheck = KeyValueSchema.safeParse(itemCheck.data.key);
+                if (!keyNodeCheck.success) {
+                    continue;
+                }
+                const key = keyNodeCheck.data.value;
+                const newPath = [...keyPath, key];
+                const fullKey = newPath.join(".");
+                const comment = collectItemComment({
+                    keyNode: itemCheck.data.key,
+                    item,
+                    valueNode: itemCheck.data.value,
+                }, { index: i, mapComment });
+                storeComment(comment, fullKey);
+                const valueInheritedComment = extractCommentBefore(itemCheck.data.value);
+                if (itemCheck.data.value != null) {
+                    visitNode(itemCheck.data.value, newPath, valueInheritedComment);
+                }
+            }
+        }
+        // Start with the document contents
+        if (doc.contents) {
+            visitNode(doc.contents, []);
+        }
+        // Merge regex comments as fallback - only use them if AST parsing didn't find a comment
+        // This handles cases where YAML parser loses comments due to:
+        // - Inconsistent indentation
+        // - Commented-out YAML keys mixed with documentation
+        // - Other edge cases
+        for (const [key, commentWithMeta] of regexComments.entries()) {
+            if (!comments.has(key)) {
+                const cleaned = cleanYAMLComment(commentWithMeta.text);
+                if (cleaned) {
+                    comments.set(key, {
+                        text: cleaned,
+                        metadata: {
+                            ...commentWithMeta.metadata,
+                            debugInfo: `${commentWithMeta.metadata.debugInfo ?? ""}\nCleaned from: "${commentWithMeta.text}"`,
+                        },
+                    });
+                }
+            }
+        }
+    }
+    catch (error) {
+        // If YAML parsing fails, fall back to empty map
+        console.warn("Failed to parse YAML comments:", error);
+    }
+    return comments;
+}
+/**
+ * Parse YAML comments and associate them with keys
+ * Returns a simple Map<string, string> for backward compatibility
+ * Exported for testing purposes
+ */
+export function parseYAMLComments(yamlContent) {
+    const commentsWithMetadata = parseYAMLCommentsWithMetadata(yamlContent);
+    const simpleComments = new Map();
+    for (const [key, commentWithMeta] of commentsWithMetadata.entries()) {
+        simpleComments.set(key, commentWithMeta.text);
+    }
+    return simpleComments;
+}
+//# sourceMappingURL=yaml-comments.js.map

package/dist/yaml-comments.js.map

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

package/dist/yaml-preprocess.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Pre-process YAML to uncomment commented-out keys
+ * In Helm charts, commented-out keys are documentation of available options
+ * e.g., "## key: value" or "# key: value"
+ *
+ * This allows us to parse them as real keys and associate their comments
+ *
+ * Only uncomments keys that are:
+ * - At root level or similar indentation to real keys
+ * - Not part of "Example:" blocks
+ * - Not part of documentation prose (have their own dedicated comment block)
+ * - Not deeply nested (which would indicate example YAML)
+ */
+export declare function preprocessYAMLComments(yamlContent: string): string;
+//# sourceMappingURL=yaml-preprocess.d.ts.map

package/dist/yaml-preprocess.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"yaml-preprocess.d.ts","sourceRoot":"","sources":["../src/yaml-preprocess.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AA4JH,wBAAgB,sBAAsB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAkElE"}