helm-env-delta 1.7.0 → 1.7.2

package/README.md

@@ -374,7 +374,26 @@ skipPath:
     - 'resources.limits'
 ```
 
-**Use cases:** Namespaces, replicas, resource limits, secrets, URLs.
+#### Filter Expressions (Skip by Name)
+
+Skip specific array items by property value using filter syntax:
+
+```yaml
+skipPath:
+  '**/*.yaml':
+    - 'env[name=SECRET_KEY]' # Skip item where name=SECRET_KEY
+    - 'env[name=INTERNAL_TOKEN].value' # Skip nested field in matching item
+    - 'containers[name=sidecar]' # Skip entire sidecar container
+    - 'spec.containers[name=app].env[name=DEBUG]' # Nested filters
+```
+
+**Syntax:**
+
+- `array[prop=value]` - Match items where property equals value
+- `array[prop="value with spaces"]` - Quoted values for special characters
+- Combine with wildcards: `containers[name=app].env[*].value`
+
+**Use cases:** Namespaces, replicas, resource limits, secrets, URLs, environment-specific array items.
 
 ---
 
@@ -623,7 +642,8 @@ hed --config <file> [options]  # Short alias
 | `--diff-json`               | Output JSON to stdout (pipe to jq)                 |
 | `--list-files`              | List source/destination files without processing   |
 | `--show-config`             | Display resolved config after inheritance          |
-| `--skip-format`             | Skip YAML formatting                               |
+| `--format-only`             | Format destination files without syncing           |
+| `--skip-format`             | Skip YAML formatting during sync                   |
 | `--no-color`                | Disable colored output (CI/accessibility)          |
 | `--verbose`                 | Show detailed debug info                           |
 | `--quiet`                   | Suppress output except errors                      |
@@ -660,6 +680,12 @@ hed --config config.yaml
 
 # Force override stop rules
 hed --config config.yaml --force
+
+# Format destination files only (no sync)
+hed --config config.yaml --format-only
+
+# Preview format changes
+hed --config config.yaml --format-only --dry-run
 ```
 
 ---
@@ -730,7 +756,7 @@ git push origin main
 
 ✅ **Flexibility** - Per-file patterns. Config inheritance. Regex transforms.
 
-✅ **Reliability** - 847 tests, 84% coverage. Battle-tested.
+✅ **Reliability** - 920 tests, 84% coverage. Battle-tested.
 
 ---
 
@@ -840,6 +866,7 @@ helm-env-delta --config config.yaml --validate
 2. **skipPath patterns** - Two-level validation:
    - Glob pattern must match at least one file
    - JSONPath must exist in at least one matched file
+   - Filter expressions `[prop=value]` validated against actual array items
 3. **stopRules patterns** - Two-level validation:
    - Glob pattern must match at least one file
    - JSONPath (if specified) must exist in at least one matched file
@@ -930,6 +957,8 @@ spec:
 # ✅ Correct
 - 'spec.replicas' # No prefix
 - 'env[*].name' # Array wildcard
+- 'env[name=DEBUG]' # Filter by property value
+- 'containers[name=app].env[name=SECRET]' # Nested filters
 ```
 
 ---

package/dist/commandLine.d.ts

@@ -6,6 +6,7 @@ export type SyncCommand = {
     diffHtml: boolean;
     diffJson: boolean;
     skipFormat: boolean;
+    formatOnly: boolean;
     validate: boolean;
     verbose: boolean;
     quiet: boolean;

package/dist/commandLine.js

@@ -19,6 +19,7 @@ const parseCommandLine = (argv) => {
         .option('--diff-html', 'Generate and open HTML diff report in browser', false)
         .option('--diff-json', 'Output diff as JSON to stdout', false)
         .option('--skip-format', 'Skip YAML formatting (outputFormat section)', false)
+        .option('--format-only', 'Format YAML files in destination without syncing', false)
         .option('--validate', 'Validate configuration file and exit', false)
         .option('--list-files', 'List files that would be synced without processing diffs', false)
         .option('--show-config', 'Display resolved configuration after inheritance and exit', false)
@@ -53,6 +54,10 @@ Documentation: https://github.com/balazscsaba2006/helm-env-delta
         console.error('Error: --verbose and --quiet flags are mutually exclusive');
         process.exit(1);
     }
+    if (options['formatOnly'] && options['skipFormat']) {
+        console.error('Error: --format-only and --skip-format flags are mutually exclusive');
+        process.exit(1);
+    }
     const threshold = Number.parseFloat(options['suggestThreshold']);
     if (Number.isNaN(threshold) || threshold < 0 || threshold > 1) {
         console.error('Error: --suggest-threshold must be a number between 0 and 1');
@@ -66,6 +71,7 @@ Documentation: https://github.com/balazscsaba2006/helm-env-delta
         diffHtml: options['diffHtml'],
         diffJson: options['diffJson'],
         skipFormat: options['skipFormat'],
+        formatOnly: options['formatOnly'],
         validate: options['validate'],
         listFiles: options['listFiles'],
         showConfig: options['showConfig'],

package/dist/fileDiff.d.ts

@@ -8,6 +8,7 @@ export interface FileDiffResult {
 }
 export interface ChangedFile {
     path: string;
+    originalPath?: string;
     sourceContent: string;
     destinationContent: string;
     processedSourceContent: unknown;
@@ -46,5 +47,5 @@ export declare class FileDiffError extends FileDiffErrorClass {
 }
 export declare const isFileDiffError: (error: unknown) => error is FileDiffError;
 export declare const getSkipPathsForFile: (filePath: string, skipPath?: Record<string, string[]>) => string[];
-export declare const computeFileDiff: (sourceFiles: FileMap, destinationFiles: FileMap, config: Config, logger?: import("./logger").Logger) => FileDiffResult;
+export declare const computeFileDiff: (sourceFiles: FileMap, destinationFiles: FileMap, config: Config, logger?: import("./logger").Logger, originalPaths?: Map<string, string>) => FileDiffResult;
 export {};

package/dist/fileDiff.js

@@ -41,6 +41,30 @@ const deleteJsonPathRecursive = (object, parts, index) => {
     const currentPart = parts[index];
     if (!currentPart)
         return;
+    if ((0, jsonPath_1.isFilterSegment)(currentPart)) {
+        if (!Array.isArray(object))
+            return;
+        const filter = (0, jsonPath_1.parseFilterSegment)(currentPart);
+        if (!filter)
+            return;
+        if (index === parts.length - 1)
+            for (let index_ = object.length - 1; index_ >= 0; index_--) {
+                const item = object[index_];
+                if (item && typeof item === 'object') {
+                    const itemValue = item[filter.property];
+                    if (String(itemValue) === filter.value)
+                        object.splice(index_, 1);
+                }
+            }
+        else
+            for (const item of object)
+                if (item && typeof item === 'object') {
+                    const itemValue = item[filter.property];
+                    if (String(itemValue) === filter.value)
+                        deleteJsonPathRecursive(item, parts, index + 1);
+                }
+        return;
+    }
     if (index === parts.length - 1) {
         if (currentPart === '*' && Array.isArray(object))
             object.length = 0;
@@ -142,13 +166,14 @@ const processYamlFile = (options) => {
         parsedDest: destinationParsed
     };
 };
-const processChangedFiles = (sourceFiles, destinationFiles, skipPath, transforms) => {
+const processChangedFiles = (sourceFiles, destinationFiles, skipPath, transforms, originalPaths) => {
     const changedFiles = [];
     const unchangedFiles = [];
     for (const [path, sourceContent] of sourceFiles.entries()) {
         if (!destinationFiles.has(path))
             continue;
         const destinationContent = destinationFiles.get(path);
+        const originalPath = originalPaths?.get(path);
         const isYaml = (0, fileType_1.isYamlFile)(path);
         if (isYaml) {
             const changed = processYamlFile({
@@ -158,8 +183,11 @@ const processChangedFiles = (sourceFiles, destinationFiles, skipPath, transforms
                 skipPath,
                 transforms
             });
-            if (changed)
+            if (changed) {
+                if (originalPath)
+                    changed.originalPath = originalPath;
                 changedFiles.push(changed);
+            }
             else
                 unchangedFiles.push(path);
         }
@@ -168,6 +196,7 @@ const processChangedFiles = (sourceFiles, destinationFiles, skipPath, transforms
         else
             changedFiles.push({
                 path,
+                originalPath,
                 sourceContent,
                 destinationContent: destinationContent,
                 processedSourceContent: sourceContent,
@@ -179,7 +208,7 @@ const processChangedFiles = (sourceFiles, destinationFiles, skipPath, transforms
     }
     return { changedFiles, unchangedFiles };
 };
-const computeFileDiff = (sourceFiles, destinationFiles, config, logger) => {
+const computeFileDiff = (sourceFiles, destinationFiles, config, logger, originalPaths) => {
     if (logger?.shouldShow('debug')) {
         logger.debug('Computing file differences:');
         logger.debug(`  Source files: ${sourceFiles.size}`);
@@ -193,7 +222,7 @@ const computeFileDiff = (sourceFiles, destinationFiles, config, logger) => {
     }
     const addedFiles = detectAddedFiles(sourceFiles, destinationFiles);
     const deletedFiles = config.prune ? detectDeletedFiles(sourceFiles, destinationFiles) : [];
-    const { changedFiles, unchangedFiles } = processChangedFiles(sourceFiles, destinationFiles, config.skipPath, config.transforms);
+    const { changedFiles, unchangedFiles } = processChangedFiles(sourceFiles, destinationFiles, config.skipPath, config.transforms, originalPaths);
     return { addedFiles, deletedFiles, changedFiles, unchangedFiles };
 };
 exports.computeFileDiff = computeFileDiff;

package/dist/fileLoader.d.ts

@@ -4,8 +4,13 @@ export interface FileLoaderOptions {
     include: string[];
     exclude: string[];
     transforms?: TransformConfig;
+    skipExclude?: boolean;
 }
 export type FileMap = Map<string, string>;
+export interface FileLoaderResult {
+    fileMap: FileMap;
+    originalPaths: Map<string, string>;
+}
 declare const FileLoaderErrorClass: {
     new (message: string, options?: import("./utils/errors").ErrorOptions): {
         [key: string]: unknown;
@@ -24,5 +29,5 @@ declare const FileLoaderErrorClass: {
 export declare class FileLoaderError extends FileLoaderErrorClass {
 }
 export declare const isFileLoaderError: (error: unknown) => error is FileLoaderError;
-export declare const loadFiles: (options: FileLoaderOptions, logger?: import("./logger").Logger) => Promise<FileMap>;
+export declare const loadFiles: (options: FileLoaderOptions, logger?: import("./logger").Logger) => Promise<FileLoaderResult>;
 export {};

package/dist/fileLoader.js

@@ -67,10 +67,12 @@ const validateAndResolveBaseDirectory = async (baseDirectory) => {
         throw accessError;
     }
 };
-const findMatchingFiles = async (baseDirectory, includePatterns, excludePatterns, transforms) => {
+const findMatchingFiles = async (baseDirectory, includePatterns, excludePatterns, transforms, skipExclude) => {
     try {
         if (!transforms) {
-            const allPatterns = [...includePatterns, ...excludePatterns.map((pattern) => `!${pattern}`)];
+            const allPatterns = skipExclude
+                ? [...includePatterns]
+                : [...includePatterns, ...excludePatterns.map((pattern) => `!${pattern}`)];
             const matchedFiles = await (0, tinyglobby_1.glob)(allPatterns, {
                 cwd: baseDirectory,
                 absolute: true,
@@ -94,9 +96,11 @@ const findMatchingFiles = async (baseDirectory, includePatterns, excludePatterns
             const included = includePatterns.some((pattern) => patternMatcher_1.globalMatcher.match(transformedPath, pattern));
             if (!included)
                 continue;
-            const excluded = excludePatterns.some((pattern) => patternMatcher_1.globalMatcher.match(transformedPath, pattern));
-            if (excluded)
-                continue;
+            if (!skipExclude) {
+                const excluded = excludePatterns.some((pattern) => patternMatcher_1.globalMatcher.match(transformedPath, pattern));
+                if (excluded)
+                    continue;
+            }
             filtered.push(absolutePath);
         }
         return filtered;
@@ -153,7 +157,7 @@ const loadFiles = async (options, logger) => {
     const absoluteBaseDirectory = await validateAndResolveBaseDirectory(options.baseDirectory);
     const includePatterns = options.include ?? ['**/*'];
     const excludePatterns = options.exclude ?? [];
-    const files = await findMatchingFiles(absoluteBaseDirectory, includePatterns, excludePatterns, options.transforms);
+    const files = await findMatchingFiles(absoluteBaseDirectory, includePatterns, excludePatterns, options.transforms, options.skipExclude);
     if (logger?.shouldShow('debug')) {
         logger.debug('Glob matching:');
         logger.debug(`  Directory: ${absoluteBaseDirectory}`);
@@ -162,20 +166,20 @@ const loadFiles = async (options, logger) => {
         logger.debug(`  Matched: ${files.length} file(s)`);
     }
     const fileMap = await readFilesIntoMap(absoluteBaseDirectory, files);
-    const transformedMap = options.transforms ? (0, filenameTransformer_1.transformFilenameMap)(fileMap, options.transforms) : fileMap;
+    const transformResult = (0, filenameTransformer_1.transformFilenameMap)(fileMap, options.transforms);
     if (options.transforms && logger?.shouldShow('debug')) {
-        logger.debug(`Filename transforms applied: ${fileMap.size} → ${transformedMap.size} files`);
+        logger.debug(`Filename transforms applied: ${fileMap.size} → ${transformResult.fileMap.size} files`);
         let exampleCount = 0;
-        for (const [transformed, content] of transformedMap.entries()) {
-            const original = [...fileMap.entries()].find(([_key, c]) => c === content)?.[0];
-            if (original && original !== transformed) {
-                logger.debug(`  ${original} → ${transformed}`);
-                exampleCount++;
-                if (exampleCount >= 3)
-                    break;
-            }
+        for (const [transformedPath, originalPath] of transformResult.originalPaths.entries()) {
+            logger.debug(`  ${originalPath} → ${transformedPath}`);
+            exampleCount++;
+            if (exampleCount >= 3)
+                break;
         }
     }
-    return sortMapByKeys(transformedMap);
+    return {
+        fileMap: sortMapByKeys(transformResult.fileMap),
+        originalPaths: transformResult.originalPaths
+    };
 };
 exports.loadFiles = loadFiles;

package/dist/htmlReporter.js

@@ -72,8 +72,14 @@ const generateArrayDiffHtml = (change) => {
     html += '</div>';
     return html;
 };
+const generateFileSummary = (file) => {
+    if (!file.originalPath)
+        return file.path;
+    return `<span class="filename-transform">${file.originalPath} → ${file.path}</span>`;
+};
 const generateChangedFileSection = (file) => {
     const isYaml = (0, fileType_1.isYamlFile)(file.path);
+    const summary = generateFileSummary(file);
     if (!isYaml) {
         const destinationContent = (0, serialization_1.serializeForDiff)(file.processedDestContent, false);
         const sourceContent = (0, serialization_1.serializeForDiff)(file.processedSourceContent, false);
@@ -81,7 +87,7 @@ const generateChangedFileSection = (file) => {
         const diffHtml = generateDiffHtml(unifiedDiff);
         return `
     <details class="file-section" open>
-      <summary>${file.path}</summary>
+      <summary>${summary}</summary>
       <div class="diff-container">
         ${diffHtml}
       </div>
@@ -96,7 +102,7 @@ const generateChangedFileSection = (file) => {
         const diffHtml = generateDiffHtml(unifiedDiff);
         return `
     <details class="file-section" open>
-      <summary>${file.path}</summary>
+      <summary>${summary}</summary>
       <div class="diff-container">
         ${diffHtml}
       </div>
@@ -109,18 +115,18 @@ const generateChangedFileSection = (file) => {
     const diffHtml = generateDiffHtml(unifiedDiff);
     let arrayDiffsHtml = '';
     if (arrayInfo.hasChanges) {
-        arrayDiffsHtml = '<div class="array-details"><h3>Array-specific details:</h3>';
+        arrayDiffsHtml = '<details class="array-details"><summary>Array-specific details:</summary>';
         for (const change of arrayInfo.changes) {
             const pathString = change.path.join('.');
             arrayDiffsHtml += `<div class="array-section"><h4>${pathString}:</h4>`;
             arrayDiffsHtml += generateArrayDiffHtml(change);
             arrayDiffsHtml += '</div>';
         }
-        arrayDiffsHtml += '</div>';
+        arrayDiffsHtml += '</details>';
     }
     return `
     <details class="file-section" open>
-      <summary>${file.path}</summary>
+      <summary>${summary}</summary>
       <div class="diff-container">
         ${diffHtml}
         ${arrayDiffsHtml}

package/dist/index.js

@@ -37,6 +37,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 const node_fs_1 = require("node:fs");
+const promises_1 = require("node:fs/promises");
 const node_os_1 = require("node:os");
 const node_path_1 = __importDefault(require("node:path"));
 const chalk_1 = __importDefault(require("chalk"));
@@ -60,7 +61,9 @@ const stopRulesValidator_1 = require("./stopRulesValidator");
 const suggestionEngine_1 = require("./suggestionEngine");
 const collisionDetector_1 = require("./utils/collisionDetector");
 const filenameTransformer_1 = require("./utils/filenameTransformer");
+const fileType_1 = require("./utils/fileType");
 const versionChecker_1 = require("./utils/versionChecker");
+const yamlFormatter_1 = require("./yamlFormatter");
 const ZodError_1 = require("./ZodError");
 const main = async () => {
     const command = (0, commandLine_1.parseCommandLine)();
@@ -98,17 +101,21 @@ const main = async () => {
                 console.warn(chalk_1.default.yellow(`  • ${warning}`));
         }
         logger.log('\n' + (0, consoleFormatter_1.formatProgressMessage)('Loading files for validation...', 'loading'));
-        const sourceFiles = await (0, fileLoader_1.loadFiles)({
+        const sourceResult = await (0, fileLoader_1.loadFiles)({
             baseDirectory: config.source,
             include: config.include,
             exclude: config.exclude,
-            transforms: config.transforms
+            transforms: config.transforms,
+            skipExclude: true
         }, logger);
-        const destinationFiles = await (0, fileLoader_1.loadFiles)({
+        const sourceFiles = sourceResult.fileMap;
+        const destinationResult = await (0, fileLoader_1.loadFiles)({
             baseDirectory: config.destination,
             include: config.include,
-            exclude: config.exclude
+            exclude: config.exclude,
+            skipExclude: true
         }, logger);
+        const destinationFiles = destinationResult.fileMap;
         logger.progress(`Loaded ${sourceFiles.size} source, ${destinationFiles.size} destination file(s)`, 'success');
         logger.log('\n' + (0, consoleFormatter_1.formatProgressMessage)('Validating pattern usage...', 'info'));
         const usageResult = (0, patternUsageValidator_1.validatePatternUsage)(config, sourceFiles, destinationFiles);
@@ -136,23 +143,26 @@ const main = async () => {
         logger.debug(`  Prune enabled: ${config.prune}`);
     }
     logger.log('\n' + (0, consoleFormatter_1.formatProgressMessage)('Loading files...', 'loading'));
-    const sourceFiles = await (0, fileLoader_1.loadFiles)({
+    const sourceResult = await (0, fileLoader_1.loadFiles)({
         baseDirectory: config.source,
         include: config.include,
         exclude: config.exclude,
         transforms: config.transforms
     }, logger);
+    const sourceFiles = sourceResult.fileMap;
+    const originalPaths = sourceResult.originalPaths;
     logger.progress(`Loaded ${sourceFiles.size} source file(s)`, 'success');
     const collisions = (0, collisionDetector_1.detectCollisions)(sourceFiles, config.transforms);
     if (collisions.length > 0)
         (0, collisionDetector_1.validateNoCollisions)(collisions);
     if (logger.shouldShow('debug'))
         logger.debug('Filename collision check: passed');
-    const destinationFiles = await (0, fileLoader_1.loadFiles)({
+    const destinationResult = await (0, fileLoader_1.loadFiles)({
         baseDirectory: config.destination,
         include: config.include,
         exclude: config.exclude
     }, logger);
+    const destinationFiles = destinationResult.fileMap;
     logger.progress(`Loaded ${destinationFiles.size} destination file(s)`, 'success');
     if (command.listFiles) {
         const sourceFilesList = [...sourceFiles.keys()].toSorted();
@@ -166,8 +176,48 @@ const main = async () => {
             console.log(`  ${chalk_1.default.dim(file)}`);
         return;
     }
+    if (command.formatOnly) {
+        if (!config.outputFormat) {
+            logger.log(chalk_1.default.yellow('\n⚠️  No outputFormat configured. Nothing to format.'));
+            return;
+        }
+        logger.log('\n' + (0, consoleFormatter_1.formatProgressMessage)('Formatting files...', 'info'));
+        let formattedCount = 0;
+        const errors = [];
+        for (const [relativePath, content] of destinationFiles) {
+            if (!(0, fileType_1.isYamlFile)(relativePath))
+                continue;
+            try {
+                const formatted = (0, yamlFormatter_1.formatYaml)(content, relativePath, config.outputFormat);
+                if (formatted !== content) {
+                    const absolutePath = node_path_1.default.join(config.destination, relativePath);
+                    if (command.dryRun)
+                        logger.fileOp('format', relativePath, true);
+                    else {
+                        await (0, promises_1.writeFile)(absolutePath, formatted, 'utf8');
+                        logger.fileOp('format', relativePath, false);
+                    }
+                    formattedCount++;
+                }
+            }
+            catch (error) {
+                errors.push({ path: relativePath, error: error });
+            }
+        }
+        if (command.dryRun)
+            logger.log(`\n[DRY RUN] Would format ${formattedCount} file(s)`);
+        else
+            logger.log(`\n✓ Formatted ${formattedCount} file(s)`);
+        if (errors.length > 0) {
+            logger.error(`\n❌ Encountered ${errors.length} error(s):`, 'critical');
+            for (const { path: errorPath, error } of errors)
+                logger.error(`  ${errorPath}: ${error.message}`, 'critical');
+            process.exit(1);
+        }
+        return;
+    }
     logger.log('\n' + (0, consoleFormatter_1.formatProgressMessage)('Computing differences...', 'info'));
-    const diffResult = (0, fileDiff_1.computeFileDiff)(sourceFiles, destinationFiles, config, logger);
+    const diffResult = (0, fileDiff_1.computeFileDiff)(sourceFiles, destinationFiles, config, logger, originalPaths);
     if (logger.shouldShow('debug'))
         logger.debug('Diff pipeline: parse → transforms → skipPath → normalize → compare');
     if (command.diff && !command.quiet)

package/dist/patternUsageValidator.js

@@ -99,6 +99,44 @@ const validateStopRulePatterns = (config, sourceFiles, destinationFiles) => {
     return warnings;
 };
 const hasPathField = (rule) => 'path' in rule && typeof rule.path === 'string';
+const pathCouldMatch = (object, pathParts) => {
+    let current = object;
+    for (const part of pathParts) {
+        if (!current || typeof current !== 'object')
+            return false;
+        if ((0, jsonPath_1.isFilterSegment)(part)) {
+            if (!Array.isArray(current))
+                return false;
+            const filter = (0, jsonPath_1.parseFilterSegment)(part);
+            if (!filter)
+                return false;
+            const matched = current.find((item) => {
+                if (!item || typeof item !== 'object')
+                    return false;
+                const itemValue = item[filter.property];
+                return String(itemValue) === filter.value;
+            });
+            if (!matched)
+                return false;
+            current = matched;
+            continue;
+        }
+        if (Array.isArray(current)) {
+            if (part === '*') {
+                if (pathParts.indexOf(part) === pathParts.length - 1)
+                    return true;
+                return current.some((item) => item !== undefined);
+            }
+            const index = Number(part);
+            if (Number.isNaN(index))
+                return false;
+            current = current[index];
+        }
+        else
+            current = current[part];
+    }
+    return current !== undefined;
+};
 const validateJsonPathInFiles = (jsonPath, filePaths, sourceFiles, destinationFiles) => {
     const pathParts = (0, jsonPath_1.parseJsonPath)(jsonPath);
     for (const filePath of filePaths) {
@@ -107,8 +145,7 @@ const validateJsonPathInFiles = (jsonPath, filePaths, sourceFiles, destinationFi
             continue;
         try {
             const parsed = yaml_1.default.parse(content);
-            const value = (0, jsonPath_1.getValueAtPath)(parsed, pathParts);
-            if (value !== undefined)
+            if (pathCouldMatch(parsed, pathParts))
                 return true;
         }
         catch {

package/dist/reporters/htmlStyles.d.ts

@@ -1,2 +1,2 @@
-export declare const HTML_STYLES = "\n  /* Custom styles */\n  body {\n    font-family: -apple-system, BlinkMacSystemFont, \"Segoe UI\", Roboto, Helvetica, Arial, sans-serif;\n    margin: 0;\n    padding: 20px;\n    background: #f6f8fa;\n  }\n\n  header {\n    background: white;\n    padding: 20px;\n    border-radius: 6px;\n    margin-bottom: 20px;\n    box-shadow: 0 1px 3px rgba(0,0,0,0.12);\n  }\n\n  h1 {\n    margin: 0 0 10px 0;\n    color: #24292e;\n  }\n\n  .metadata {\n    display: flex;\n    gap: 20px;\n    margin: 10px 0;\n    color: #586069;\n    font-size: 14px;\n  }\n\n  .dry-run-badge {\n    display: inline-block;\n    padding: 4px 8px;\n    background: #cfe2ff;\n    color: #084298;\n    border-radius: 4px;\n    font-weight: bold;\n    font-size: 12px;\n  }\n\n  .summary {\n    display: flex;\n    gap: 12px;\n    margin: 15px 0;\n  }\n\n  .stat {\n    padding: 8px 16px;\n    border-radius: 6px;\n    font-weight: 600;\n    font-size: 14px;\n  }\n\n  .stat.added { background: #d4edda; color: #155724; }\n  .stat.changed { background: #fff3cd; color: #856404; }\n  .stat.deleted { background: #f8d7da; color: #721c24; }\n  .stat.formatted { background: #d1ecf1; color: #0c5460; }\n  .stat.unchanged { background: #e2e3e5; color: #383d41; }\n\n  .tabs {\n    display: flex;\n    background: white;\n    border-radius: 6px 6px 0 0;\n    border-bottom: 1px solid #d0d7de;\n    box-shadow: 0 1px 3px rgba(0,0,0,0.12);\n  }\n\n  .tab {\n    padding: 12px 24px;\n    border: none;\n    background: transparent;\n    cursor: pointer;\n    font-size: 14px;\n    color: #586069;\n    transition: all 0.2s;\n  }\n\n  .tab:hover {\n    color: #24292e;\n  }\n\n  .tab.active {\n    border-bottom: 2px solid #0969da;\n    color: #0969da;\n    font-weight: 600;\n  }\n\n  main {\n    background: white;\n    padding: 20px;\n    border-radius: 0 0 6px 6px;\n    box-shadow: 0 1px 3px rgba(0,0,0,0.12);\n  }\n\n  .tab-content {\n    display: none;\n  }\n\n  .tab-content.active {\n    display: block;\n  }\n\n  .file-section {\n    margin: 12px 0;\n    border: 1px solid #d0d7de;\n    border-radius: 6px;\n  }\n\n  .file-section summary {\n    padding: 12px 16px;\n    background: #f6f8fa;\n    cursor: pointer;\n    font-weight: 600;\n    font-family: ui-monospace, SFMono-Regular, \"SF Mono\", Menlo, Consolas, \"Liberation Mono\", monospace;\n    font-size: 13px;\n    color: #24292e;\n  }\n\n  .file-section summary:hover {\n    background: #eaeef2;\n  }\n\n  .diff-container {\n    padding: 0;\n  }\n\n  /* Hide diff2html file header with rename badge */\n  .d2h-file-header {\n    display: none;\n  }\n\n  .file-list {\n    margin: 20px 0;\n  }\n\n  .file-list ul {\n    list-style: none;\n    padding: 0;\n    margin: 10px 0;\n  }\n\n  .file-list li {\n    padding: 8px 16px;\n    font-family: ui-monospace, SFMono-Regular, \"SF Mono\", Menlo, Consolas, \"Liberation Mono\", monospace;\n    font-size: 13px;\n    color: #586069;\n    border-bottom: 1px solid #f6f8fa;\n  }\n\n  .file-list li:hover {\n    background: #f6f8fa;\n  }\n\n  .array-details {\n    margin: 20px 0;\n    padding: 15px;\n    background: #f6f8fa;\n    border-radius: 6px;\n    border-left: 3px solid #0969da;\n  }\n\n  .array-details h3 {\n    margin: 0 0 15px 0;\n    color: #0969da;\n    font-size: 16px;\n  }\n\n  .array-section {\n    margin: 15px 0;\n    padding: 10px;\n    background: white;\n    border-radius: 4px;\n    border: 1px solid #d0d7de;\n  }\n\n  .array-section h4 {\n    margin: 0 0 10px 0;\n    color: #24292e;\n    font-size: 14px;\n    font-family: ui-monospace, SFMono-Regular, \"SF Mono\", Menlo, Consolas, \"Liberation Mono\", monospace;\n  }\n\n  .array-unchanged {\n    padding: 8px;\n    color: #586069;\n    font-family: ui-monospace, SFMono-Regular, \"SF Mono\", Menlo, Consolas, \"Liberation Mono\", monospace;\n    font-size: 12px;\n  }\n\n  .added-items, .removed-items {\n    margin: 10px 0;\n  }\n\n  .added-items h4 {\n    color: #1a7f37;\n    margin: 0 0 8px 0;\n    font-size: 13px;\n  }\n\n  .removed-items h4 {\n    color: #cf222e;\n    margin: 0 0 8px 0;\n    font-size: 13px;\n  }\n\n  .added-items ul, .removed-items ul {\n    list-style: none;\n    padding: 0;\n    margin: 0;\n  }\n\n  .added-items li {\n    padding: 6px 10px;\n    background: #dafbe1;\n    border-left: 3px solid #1a7f37;\n    margin: 4px 0;\n    font-family: ui-monospace, SFMono-Regular, \"SF Mono\", Menlo, Consolas, \"Liberation Mono\", monospace;\n    font-size: 12px;\n  }\n\n  .removed-items li {\n    padding: 6px 10px;\n    background: #ffebe9;\n    border-left: 3px solid #cf222e;\n    margin: 4px 0;\n    font-family: ui-monospace, SFMono-Regular, \"SF Mono\", Menlo, Consolas, \"Liberation Mono\", monospace;\n    font-size: 12px;\n  }\n\n  .added-items pre, .removed-items pre {\n    margin: 0;\n    white-space: pre-wrap;\n    word-wrap: break-word;\n  }\n\n  .unchanged-count {\n    padding: 8px 10px;\n    color: #586069;\n    font-size: 12px;\n    font-family: ui-monospace, SFMono-Regular, \"SF Mono\", Menlo, Consolas, \"Liberation Mono\", monospace;\n    background: #f6f8fa;\n    border-radius: 4px;\n    margin: 10px 0;\n  }\n";
+export declare const HTML_STYLES = "\n  /* Custom styles */\n  body {\n    font-family: -apple-system, BlinkMacSystemFont, \"Segoe UI\", Roboto, Helvetica, Arial, sans-serif;\n    margin: 0;\n    padding: 20px;\n    background: #f6f8fa;\n  }\n\n  header {\n    background: white;\n    padding: 20px;\n    border-radius: 6px;\n    margin-bottom: 20px;\n    box-shadow: 0 1px 3px rgba(0,0,0,0.12);\n  }\n\n  h1 {\n    margin: 0 0 10px 0;\n    color: #24292e;\n  }\n\n  .metadata {\n    display: flex;\n    gap: 20px;\n    margin: 10px 0;\n    color: #586069;\n    font-size: 14px;\n  }\n\n  .dry-run-badge {\n    display: inline-block;\n    padding: 4px 8px;\n    background: #cfe2ff;\n    color: #084298;\n    border-radius: 4px;\n    font-weight: bold;\n    font-size: 12px;\n  }\n\n  .summary {\n    display: flex;\n    gap: 12px;\n    margin: 15px 0;\n  }\n\n  .stat {\n    padding: 8px 16px;\n    border-radius: 6px;\n    font-weight: 600;\n    font-size: 14px;\n  }\n\n  .stat.added { background: #d4edda; color: #155724; }\n  .stat.changed { background: #fff3cd; color: #856404; }\n  .stat.deleted { background: #f8d7da; color: #721c24; }\n  .stat.formatted { background: #d1ecf1; color: #0c5460; }\n  .stat.unchanged { background: #e2e3e5; color: #383d41; }\n\n  .tabs {\n    display: flex;\n    background: white;\n    border-radius: 6px 6px 0 0;\n    border-bottom: 1px solid #d0d7de;\n    box-shadow: 0 1px 3px rgba(0,0,0,0.12);\n  }\n\n  .tab {\n    padding: 12px 24px;\n    border: none;\n    background: transparent;\n    cursor: pointer;\n    font-size: 14px;\n    color: #586069;\n    transition: all 0.2s;\n  }\n\n  .tab:hover {\n    color: #24292e;\n  }\n\n  .tab.active {\n    border-bottom: 2px solid #0969da;\n    color: #0969da;\n    font-weight: 600;\n  }\n\n  main {\n    background: white;\n    padding: 20px;\n    border-radius: 0 0 6px 6px;\n    box-shadow: 0 1px 3px rgba(0,0,0,0.12);\n  }\n\n  .tab-content {\n    display: none;\n  }\n\n  .tab-content.active {\n    display: block;\n  }\n\n  .file-section {\n    margin: 12px 0;\n    border: 1px solid #d0d7de;\n    border-radius: 6px;\n  }\n\n  .file-section summary {\n    padding: 12px 16px;\n    background: #f6f8fa;\n    cursor: pointer;\n    font-weight: 600;\n    font-family: ui-monospace, SFMono-Regular, \"SF Mono\", Menlo, Consolas, \"Liberation Mono\", monospace;\n    font-size: 13px;\n    color: #24292e;\n  }\n\n  .file-section summary:hover {\n    background: #eaeef2;\n  }\n\n  .filename-transform {\n    color: #0969da;\n  }\n\n  .diff-container {\n    padding: 0;\n  }\n\n  /* Hide diff2html file header with rename badge */\n  .d2h-file-header {\n    display: none;\n  }\n\n  .file-list {\n    margin: 20px 0;\n  }\n\n  .file-list ul {\n    list-style: none;\n    padding: 0;\n    margin: 10px 0;\n  }\n\n  .file-list li {\n    padding: 8px 16px;\n    font-family: ui-monospace, SFMono-Regular, \"SF Mono\", Menlo, Consolas, \"Liberation Mono\", monospace;\n    font-size: 13px;\n    color: #586069;\n    border-bottom: 1px solid #f6f8fa;\n  }\n\n  .file-list li:hover {\n    background: #f6f8fa;\n  }\n\n  .array-details {\n    margin: 20px 0;\n    background: #f6f8fa;\n    border-radius: 6px;\n    border-left: 3px solid #0969da;\n  }\n\n  .array-details summary {\n    padding: 12px 15px;\n    cursor: pointer;\n    color: #0969da;\n    font-size: 13px;\n    font-weight: 600;\n  }\n\n  .array-details summary:hover {\n    background: #eaeef2;\n  }\n\n  .array-details > .array-section {\n    margin: 0 15px 15px 15px;\n  }\n\n  .array-section {\n    margin: 15px 0;\n    padding: 10px;\n    background: white;\n    border-radius: 4px;\n    border: 1px solid #d0d7de;\n  }\n\n  .array-section h4 {\n    margin: 0 0 10px 0;\n    color: #24292e;\n    font-size: 14px;\n    font-family: ui-monospace, SFMono-Regular, \"SF Mono\", Menlo, Consolas, \"Liberation Mono\", monospace;\n  }\n\n  .array-unchanged {\n    padding: 8px;\n    color: #586069;\n    font-family: ui-monospace, SFMono-Regular, \"SF Mono\", Menlo, Consolas, \"Liberation Mono\", monospace;\n    font-size: 12px;\n  }\n\n  .added-items, .removed-items {\n    margin: 10px 0;\n  }\n\n  .added-items h4 {\n    color: #1a7f37;\n    margin: 0 0 8px 0;\n    font-size: 13px;\n  }\n\n  .removed-items h4 {\n    color: #cf222e;\n    margin: 0 0 8px 0;\n    font-size: 13px;\n  }\n\n  .added-items ul, .removed-items ul {\n    list-style: none;\n    padding: 0;\n    margin: 0;\n  }\n\n  .added-items li {\n    padding: 6px 10px;\n    background: #dafbe1;\n    border-left: 3px solid #1a7f37;\n    margin: 4px 0;\n    font-family: ui-monospace, SFMono-Regular, \"SF Mono\", Menlo, Consolas, \"Liberation Mono\", monospace;\n    font-size: 12px;\n  }\n\n  .removed-items li {\n    padding: 6px 10px;\n    background: #ffebe9;\n    border-left: 3px solid #cf222e;\n    margin: 4px 0;\n    font-family: ui-monospace, SFMono-Regular, \"SF Mono\", Menlo, Consolas, \"Liberation Mono\", monospace;\n    font-size: 12px;\n  }\n\n  .added-items pre, .removed-items pre {\n    margin: 0;\n    white-space: pre-wrap;\n    word-wrap: break-word;\n  }\n\n  .unchanged-count {\n    padding: 8px 10px;\n    color: #586069;\n    font-size: 12px;\n    font-family: ui-monospace, SFMono-Regular, \"SF Mono\", Menlo, Consolas, \"Liberation Mono\", monospace;\n    background: #f6f8fa;\n    border-radius: 4px;\n    margin: 10px 0;\n  }\n";
 export declare const TAB_SCRIPT = "\n  // Tab switching\n  document.querySelectorAll('.tab').forEach(tab => {\n    tab.addEventListener('click', () => {\n      const tabName = tab.getAttribute('data-tab');\n\n      // Update tabs\n      document.querySelectorAll('.tab').forEach(t => t.classList.remove('active'));\n      tab.classList.add('active');\n\n      // Update content\n      document.querySelectorAll('.tab-content').forEach(content => {\n        content.classList.remove('active');\n      });\n      document.getElementById(tabName).classList.add('active');\n    });\n  });\n";

package/dist/reporters/htmlStyles.js

@@ -123,6 +123,10 @@ exports.HTML_STYLES = `
     background: #eaeef2;
   }
 
+  .filename-transform {
+    color: #0969da;
+  }
+
   .diff-container {
     padding: 0;
   }
@@ -156,16 +160,25 @@ exports.HTML_STYLES = `
 
   .array-details {
     margin: 20px 0;
-    padding: 15px;
     background: #f6f8fa;
     border-radius: 6px;
     border-left: 3px solid #0969da;
   }
 
-  .array-details h3 {
-    margin: 0 0 15px 0;
+  .array-details summary {
+    padding: 12px 15px;
+    cursor: pointer;
     color: #0969da;
-    font-size: 16px;
+    font-size: 13px;
+    font-weight: 600;
+  }
+
+  .array-details summary:hover {
+    background: #eaeef2;
+  }
+
+  .array-details > .array-section {
+    margin: 0 15px 15px 15px;
   }
 
   .array-section {

package/dist/utils/filenameTransformer.d.ts

@@ -26,4 +26,8 @@ export declare const isFilenameTransformerError: (error: unknown) => error is {
 };
 export declare const getFilenameTransformsForFile: (filePath: string, transforms?: TransformConfig) => TransformRule[];
 export declare const transformFilename: (filePath: string, transforms?: TransformConfig) => string;
-export declare const transformFilenameMap: (fileMap: Map<string, string>, transforms?: TransformConfig) => Map<string, string>;
+export interface TransformMapResult {
+    fileMap: Map<string, string>;
+    originalPaths: Map<string, string>;
+}
+export declare const transformFilenameMap: (fileMap: Map<string, string>, transforms?: TransformConfig) => TransformMapResult;

package/dist/utils/filenameTransformer.js

@@ -92,13 +92,16 @@ const transformFilename = (filePath, transforms) => {
 };
 exports.transformFilename = transformFilename;
 const transformFilenameMap = (fileMap, transforms) => {
+    const originalPaths = new Map();
     if (!transforms)
-        return fileMap;
+        return { fileMap, originalPaths };
     const transformed = new Map();
     for (const [originalPath, content] of fileMap.entries()) {
         const transformedPath = (0, exports.transformFilename)(originalPath, transforms);
         transformed.set(transformedPath, content);
+        if (transformedPath !== originalPath)
+            originalPaths.set(transformedPath, originalPath);
     }
-    return transformed;
+    return { fileMap: transformed, originalPaths };
 };
 exports.transformFilenameMap = transformFilenameMap;

package/dist/utils/index.d.ts

@@ -2,7 +2,7 @@ export type { ErrorOptions } from './errors';
 export { createErrorClass, createErrorTypeGuard } from './errors';
 export { deepEqual } from './deepEqual';
 export { normalizeForComparison, serializeForDiff } from './serialization';
-export { clearJsonPathCache, getValueAtPath, parseJsonPath } from './jsonPath';
+export { clearJsonPathCache, getValueAtPath, isFilterSegment, parseFilterSegment, parseJsonPath } from './jsonPath';
 export { isYamlFile } from './fileType';
 export { globalMatcher, PatternMatcher } from './patternMatcher';
 export { generateUnifiedDiff } from './diffGenerator';

package/dist/utils/index.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.SEMANTIC_KEYWORDS = exports.PROBLEMATIC_REGEX_CHARS = exports.NUMERIC_MIN_MULTIPLIER = exports.NUMERIC_MIN_FLOOR = exports.MAX_EXAMPLES_PER_SUGGESTION = exports.ISO_TIMESTAMP_PATTERN = exports.FILTER_THRESHOLDS = exports.CONSTRAINT_FIELD_NAMES = exports.CONFIDENCE_DEFAULTS = exports.ARRAY_KEY_FIELDS = exports.ANTONYM_PAIRS = exports.isYamlSeq = exports.isYamlMap = exports.isYamlCollection = exports.isScalar = exports.extractScalarValue = exports.extractKeyValue = exports.validateVersionString = exports.applyRegexRulesSequentially = exports.validateTargetedRegex = exports.validatePathlessRegex = exports.getAllValuesRecursive = exports.RegexPatternFileLoaderError = exports.loadRegexPatternsFromKeys = exports.loadRegexPatternArray = exports.isRegexPatternFileLoaderError = exports.TransformFileLoaderError = exports.loadTransformFiles = exports.loadTransformFile = exports.isTransformFileLoaderError = exports.YamlFileLoaderError = exports.loadYamlFile = exports.isYamlFileLoaderError = exports.escapeRegex = exports.VersionCheckerError = exports.isVersionCheckerError = exports.checkForUpdates = exports.detectArrayChanges = exports.generateUnifiedDiff = exports.PatternMatcher = exports.globalMatcher = exports.isYamlFile = exports.parseJsonPath = exports.getValueAtPath = exports.clearJsonPathCache = exports.serializeForDiff = exports.normalizeForComparison = exports.deepEqual = exports.createErrorTypeGuard = exports.createErrorClass = void 0;
-exports.UUID_PATTERN = exports.SEMVER_PATTERN = exports.SEMANTIC_PATTERNS = void 0;
+exports.NUMERIC_MIN_MULTIPLIER = exports.NUMERIC_MIN_FLOOR = exports.MAX_EXAMPLES_PER_SUGGESTION = exports.ISO_TIMESTAMP_PATTERN = exports.FILTER_THRESHOLDS = exports.CONSTRAINT_FIELD_NAMES = exports.CONFIDENCE_DEFAULTS = exports.ARRAY_KEY_FIELDS = exports.ANTONYM_PAIRS = exports.isYamlSeq = exports.isYamlMap = exports.isYamlCollection = exports.isScalar = exports.extractScalarValue = exports.extractKeyValue = exports.validateVersionString = exports.applyRegexRulesSequentially = exports.validateTargetedRegex = exports.validatePathlessRegex = exports.getAllValuesRecursive = exports.RegexPatternFileLoaderError = exports.loadRegexPatternsFromKeys = exports.loadRegexPatternArray = exports.isRegexPatternFileLoaderError = exports.TransformFileLoaderError = exports.loadTransformFiles = exports.loadTransformFile = exports.isTransformFileLoaderError = exports.YamlFileLoaderError = exports.loadYamlFile = exports.isYamlFileLoaderError = exports.escapeRegex = exports.VersionCheckerError = exports.isVersionCheckerError = exports.checkForUpdates = exports.detectArrayChanges = exports.generateUnifiedDiff = exports.PatternMatcher = exports.globalMatcher = exports.isYamlFile = exports.parseJsonPath = exports.parseFilterSegment = exports.isFilterSegment = exports.getValueAtPath = exports.clearJsonPathCache = exports.serializeForDiff = exports.normalizeForComparison = exports.deepEqual = exports.createErrorTypeGuard = exports.createErrorClass = void 0;
+exports.UUID_PATTERN = exports.SEMVER_PATTERN = exports.SEMANTIC_PATTERNS = exports.SEMANTIC_KEYWORDS = exports.PROBLEMATIC_REGEX_CHARS = void 0;
 var errors_1 = require("./errors");
 Object.defineProperty(exports, "createErrorClass", { enumerable: true, get: function () { return errors_1.createErrorClass; } });
 Object.defineProperty(exports, "createErrorTypeGuard", { enumerable: true, get: function () { return errors_1.createErrorTypeGuard; } });
@@ -13,6 +13,8 @@ Object.defineProperty(exports, "serializeForDiff", { enumerable: true, get: func
 var jsonPath_1 = require("./jsonPath");
 Object.defineProperty(exports, "clearJsonPathCache", { enumerable: true, get: function () { return jsonPath_1.clearJsonPathCache; } });
 Object.defineProperty(exports, "getValueAtPath", { enumerable: true, get: function () { return jsonPath_1.getValueAtPath; } });
+Object.defineProperty(exports, "isFilterSegment", { enumerable: true, get: function () { return jsonPath_1.isFilterSegment; } });
+Object.defineProperty(exports, "parseFilterSegment", { enumerable: true, get: function () { return jsonPath_1.parseFilterSegment; } });
 Object.defineProperty(exports, "parseJsonPath", { enumerable: true, get: function () { return jsonPath_1.parseJsonPath; } });
 var fileType_1 = require("./fileType");
 Object.defineProperty(exports, "isYamlFile", { enumerable: true, get: function () { return fileType_1.isYamlFile; } });

package/dist/utils/jsonPath.d.ts

@@ -1,3 +1,8 @@
+export declare const isFilterSegment: (segment: string) => boolean;
+export declare const parseFilterSegment: (segment: string) => {
+    property: string;
+    value: string;
+} | undefined;
 export declare const parseJsonPath: (path: string) => string[];
 export declare const clearJsonPathCache: () => void;
 export declare const getValueAtPath: (object: unknown, path: string[]) => unknown;

package/dist/utils/jsonPath.js

@@ -1,15 +1,70 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getValueAtPath = exports.clearJsonPathCache = exports.parseJsonPath = void 0;
+exports.getValueAtPath = exports.clearJsonPathCache = exports.parseJsonPath = exports.parseFilterSegment = exports.isFilterSegment = void 0;
 const pathCache = new Map();
+const FILTER_PREFIX = 'filter:';
+const FILTER_REGEX = /^\[([A-Z_a-z]\w*)=("([^"]*)"|([^\]]*))]/;
+const isFilterSegment = (segment) => segment.startsWith(FILTER_PREFIX);
+exports.isFilterSegment = isFilterSegment;
+const parseFilterSegment = (segment) => {
+    if (!(0, exports.isFilterSegment)(segment))
+        return undefined;
+    const content = segment.slice(FILTER_PREFIX.length);
+    const equalIndex = content.indexOf('=');
+    if (equalIndex === -1)
+        return undefined;
+    return {
+        property: content.slice(0, equalIndex),
+        value: content.slice(equalIndex + 1)
+    };
+};
+exports.parseFilterSegment = parseFilterSegment;
 const parseJsonPath = (path) => {
     const cached = pathCache.get(path);
     if (cached !== undefined)
         return cached;
-    const parsed = path
-        .replaceAll(/\[(\*|\d+)]/g, '.$1')
-        .split('.')
-        .filter((part) => part.length > 0);
+    const result = [];
+    let index = 0;
+    let currentSegment = '';
+    while (index < path.length) {
+        const char = path[index];
+        if (char === '.') {
+            if (currentSegment) {
+                result.push(currentSegment);
+                currentSegment = '';
+            }
+            index++;
+        }
+        else if (char === '[') {
+            if (currentSegment) {
+                result.push(currentSegment);
+                currentSegment = '';
+            }
+            const remaining = path.slice(index);
+            const filterMatch = FILTER_REGEX.exec(remaining);
+            if (filterMatch) {
+                const property = filterMatch[1];
+                const value = filterMatch[3] === undefined ? filterMatch[4] : filterMatch[3];
+                result.push(`${FILTER_PREFIX}${property}=${value}`);
+                index += filterMatch[0].length;
+                continue;
+            }
+            const indexMatch = /^\[(\*|\d+)]/.exec(remaining);
+            if (indexMatch?.[1]) {
+                result.push(indexMatch[1]);
+                index += indexMatch[0].length;
+                continue;
+            }
+            index++;
+        }
+        else {
+            currentSegment += char;
+            index++;
+        }
+    }
+    if (currentSegment)
+        result.push(currentSegment);
+    const parsed = result.filter((part) => part.length > 0);
     pathCache.set(path, parsed);
     return parsed;
 };
@@ -23,6 +78,21 @@ const getValueAtPath = (object, path) => {
     for (const part of path) {
         if (!current || typeof current !== 'object')
             return undefined;
+        if ((0, exports.isFilterSegment)(part)) {
+            if (!Array.isArray(current))
+                return undefined;
+            const filter = (0, exports.parseFilterSegment)(part);
+            if (!filter)
+                return undefined;
+            const matched = current.find((item) => {
+                if (!item || typeof item !== 'object')
+                    return false;
+                const itemValue = item[filter.property];
+                return String(itemValue) === filter.value;
+            });
+            current = matched;
+            continue;
+        }
         if (Array.isArray(current)) {
             if (part === '*')
                 return undefined;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "helm-env-delta",
-  "version": "1.7.0",
+  "version": "1.7.2",
   "description": "HelmEnvDelta – environment-aware YAML delta and sync for GitOps",
   "author": "BCsabaEngine",
   "license": "ISC",
@@ -62,24 +62,24 @@
   },
   "devDependencies": {
     "@types/hogan.js": "^3.0.5",
-    "@types/node": "^25.0.3",
+    "@types/node": "^25.0.10",
     "@types/picomatch": "^4.0.2",
-    "@typescript-eslint/eslint-plugin": "^8.52.0",
-    "@typescript-eslint/parser": "^8.52.0",
-    "@vitest/coverage-v8": "^4.0.16",
+    "@typescript-eslint/eslint-plugin": "^8.53.1",
+    "@typescript-eslint/parser": "^8.53.1",
+    "@vitest/coverage-v8": "^4.0.17",
     "eslint": "^9.39.2",
     "eslint-config-prettier": "^10.1.8",
     "eslint-plugin-simple-import-sort": "^12.1.1",
     "eslint-plugin-unicorn": "^62.0.0",
-    "prettier": "^3.7.4",
+    "prettier": "^3.8.1",
     "tsx": "^4.21.0",
     "typescript": "^5.9.3",
-    "vitest": "^4.0.16"
+    "vitest": "^4.0.17"
   },
   "dependencies": {
     "chalk": "^5.6.2",
     "commander": "^14.0.2",
-    "diff": "^8.0.2",
+    "diff": "^8.0.3",
     "diff2html": "3.4.52",
     "open": "^11.0.0",
     "picomatch": "^4.0.3",