helm-env-delta 1.9.3 → 1.10.0

package/README.md

@@ -56,7 +56,7 @@ HelmEnvDelta (`hed`) automates environment synchronization for GitOps workflows
 
 📊 **Multiple Reports** - Console, HTML (visual), and JSON (CI/CD) output formats.
 
-🔍 **Discovery Tools** - Preview files (`--list-files`), inspect config (`--show-config`), validate with comprehensive warnings including unused pattern detection.
+🔍 **Discovery Tools** - Preview files (`-l`), inspect config (`--show-config`), filter by filename/content (`-f`), filter by change type (`-m`), validate with comprehensive warnings including unused pattern detection.
 
 💡 **Smart Suggestions** - Heuristic analysis (`--suggest`) detects patterns and recommends transforms and stop rules automatically. Control sensitivity with `--suggest-threshold`.
 
@@ -102,28 +102,28 @@ transforms:
 ### 2️⃣ Preview Changes
 
 ```bash
-helm-env-delta --config config.yaml --dry-run --diff
+hed -c config.yaml -D -d
 ```
 
 ### 3️⃣ Execute Sync
 
 ```bash
-helm-env-delta --config config.yaml
+hed -c config.yaml
 ```
 
 ### 4️⃣ Review in Browser
 
 ```bash
-helm-env-delta --config config.yaml --diff-html
+hed -c config.yaml -H
 ```
 
 ### 5️⃣ Get Smart Suggestions (Optional)
 
 ```bash
-helm-env-delta --config config.yaml --suggest
+hed -c config.yaml --suggest
 
 # Control suggestion sensitivity (0-1, default: 0.3)
-helm-env-delta --config config.yaml --suggest --suggest-threshold 0.7
+hed -c config.yaml --suggest --suggest-threshold 0.7
 ```
 
 Analyzes differences and suggests transforms and stop rules automatically with configurable confidence filtering.
@@ -753,66 +753,80 @@ hed --config <file> [options]  # Short alias
 
 ### Options
 
-| Flag                        | Description                                                         |
-| --------------------------- | ------------------------------------------------------------------- |
-| `--config <path>`           | **Required** - Configuration file                                   |
-| `--validate`                | Validate config and pattern usage (shows warnings)                  |
-| `--suggest`                 | Analyze differences and suggest config updates                      |
-| `--suggest-threshold <0-1>` | Minimum confidence for suggestions (default: 0.3)                   |
-| `--dry-run`                 | Preview changes without writing files                               |
-| `--force`                   | Override stop rules                                                 |
-| `--diff`                    | Show console diff                                                   |
-| `--diff-html`               | Generate HTML report (opens in browser)                             |
-| `--diff-json`               | Output JSON to stdout (pipe to jq)                                  |
-| `--list-files`              | List files without processing (takes precedence over --format-only) |
-| `--show-config`             | Display resolved config after inheritance                           |
-| `--format-only`             | Format destination files only (source not required)                 |
-| `--skip-format`             | Skip YAML formatting during sync                                    |
-| `--no-color`                | Disable colored output (CI/accessibility)                           |
-| `--verbose`                 | Show detailed debug info                                            |
-| `--quiet`                   | Suppress output except errors                                       |
+| Flag                        | Short | Description                                                         |
+| --------------------------- | ----- | ------------------------------------------------------------------- |
+| `--config <path>`           | `-c`  | **Required** - Configuration file                                   |
+| `--validate`                |       | Validate config and pattern usage (shows warnings)                  |
+| `--suggest`                 |       | Analyze differences and suggest config updates                      |
+| `--suggest-threshold <0-1>` |       | Minimum confidence for suggestions (default: 0.3)                   |
+| `--dry-run`                 | `-D`  | Preview changes without writing files                               |
+| `--force`                   |       | Override stop rules                                                 |
+| `--diff`                    | `-d`  | Show console diff                                                   |
+| `--diff-html`               | `-H`  | Generate HTML report (opens in browser)                             |
+| `--diff-json`               | `-J`  | Output JSON to stdout (pipe to jq)                                  |
+| `--list-files`              | `-l`  | List files without processing (takes precedence over --format-only) |
+| `--show-config`             |       | Display resolved config after inheritance                           |
+| `--format-only`             |       | Format destination files only (source not required)                 |
+| `--skip-format`             | `-S`  | Skip YAML formatting during sync                                    |
+| `--filter <string>`         | `-f`  | Filter files by filename or content (case-insensitive)              |
+| `--mode <type>`             | `-m`  | Filter by change type: new, modified, deleted, all (default: all)   |
+| `--no-color`                |       | Disable colored output (CI/accessibility)                           |
+| `--verbose`                 |       | Show detailed debug info                                            |
+| `--quiet`                   |       | Suppress output except errors                                       |
 
 ### Examples
 
 ```bash
 # Validate configuration (shows warnings)
-hed --config config.yaml --validate
+hed -c config.yaml --validate
 
 # Get smart configuration suggestions
-hed --config config.yaml --suggest
+hed -c config.yaml --suggest
 
 # Get only high-confidence suggestions
-hed --config config.yaml --suggest --suggest-threshold 0.7
+hed -c config.yaml --suggest --suggest-threshold 0.7
 
 # Preview files that will be synced
-hed --config config.yaml --list-files
+hed -c config.yaml -l
 
 # Display resolved config (after inheritance)
-hed --config config.yaml --show-config
+hed -c config.yaml --show-config
 
 # Preview with diff
-hed --config config.yaml --dry-run --diff
+hed -c config.yaml -D -d
 
 # Visual HTML report
-hed --config config.yaml --diff-html
+hed -c config.yaml -H
 
 # CI/CD integration (no colors)
-hed --config config.yaml --diff-json --no-color | jq '.summary'
+hed -c config.yaml -J --no-color | jq '.summary'
 
 # Execute sync
-hed --config config.yaml
+hed -c config.yaml
 
 # Force override stop rules
-hed --config config.yaml --force
+hed -c config.yaml --force
+
+# Filter to only process files matching 'prod'
+hed -c config.yaml -f prod -d
+
+# Sync only new files
+hed -c config.yaml -m new
+
+# Preview modified files only
+hed -c config.yaml -m modified -D -d
+
+# Combine filter and mode
+hed -c config.yaml -f deployment -m modified -D -d
 
 # Format destination files only (no sync, source not required in config)
-hed --config config.yaml --format-only
+hed -c config.yaml --format-only
 
 # Preview format changes
-hed --config config.yaml --format-only --dry-run
+hed -c config.yaml --format-only -D
 
 # List files that would be formatted (--list-files takes precedence)
-hed --config config.yaml --format-only --list-files
+hed -c config.yaml --format-only -l
 
 # Format-only config example (no source needed):
 # destination: './prod'
@@ -841,13 +855,13 @@ flowchart LR
 
 ```bash
 # 1. Preview changes
-hed --config config.yaml --dry-run --diff
+hed -c config.yaml -D -d
 
 # 2. Review in browser
-hed --config config.yaml --diff-html
+hed -c config.yaml -H
 
 # 3. Execute sync
-hed --config config.yaml
+hed -c config.yaml
 
 # 4. Git workflow
 git add prod/

package/dist/commandLine.d.ts

@@ -1,3 +1,4 @@
+export type ChangeMode = 'new' | 'modified' | 'deleted' | 'all';
 export type SyncCommand = {
     config: string;
     dryRun: boolean;
@@ -15,5 +16,7 @@ export type SyncCommand = {
     noColor: boolean;
     suggest: boolean;
     suggestThreshold: number;
+    filter?: string;
+    mode: ChangeMode;
 };
 export declare const parseCommandLine: (argv?: string[]) => SyncCommand;

package/dist/commandLine.js

@@ -13,19 +13,21 @@ const parseCommandLine = (argv) => {
         .description('Environment-aware YAML delta and sync for GitOps workflows')
         .version(package_json_1.default.version)
         .requiredOption('-c, --config <file>', 'Path to YAML configuration file')
-        .option('--dry-run', 'Preview changes without writing files', false)
+        .option('-D, --dry-run', 'Preview changes without writing files', false)
         .option('--force', 'Override stop rules and proceed with changes', false)
-        .option('--diff', 'Display console diff for changed files', false)
-        .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('-d, --diff', 'Display console diff for changed files', false)
+        .option('-H, --diff-html', 'Generate and open HTML diff report in browser', false)
+        .option('-J, --diff-json', 'Output diff as JSON to stdout', false)
+        .option('-S, --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('-l, --list-files', 'List files that would be synced without processing diffs', false)
         .option('--show-config', 'Display resolved configuration after inheritance and exit', false)
         .option('--suggest', 'Analyze differences and suggest transforms and stop rules', false)
         .option('--suggest-threshold <number>', 'Minimum confidence for suggestions (0-1, default: 0.3)', '0.3')
         .option('--no-color', 'Disable colored output')
+        .option('-f, --filter <string>', 'Filter files by filename or content (case-insensitive)')
+        .option('-m, --mode <type>', 'Filter by change type: new, modified, deleted, all', 'all')
         .option('--verbose', 'Show detailed debug information', false)
         .option('--quiet', 'Suppress all output except critical errors', false)
         .addHelpText('after', `
@@ -45,6 +47,15 @@ Examples:
   # CI/CD usage with JSON output
   $ helm-env-delta --config config.yaml --diff-json | jq '.summary'
 
+  # Filter to only process files matching 'prod'
+  $ helm-env-delta --config config.yaml -f prod --diff
+
+  # Sync only new files
+  $ helm-env-delta --config config.yaml --mode new
+
+  # Preview modified files only
+  $ helm-env-delta --config config.yaml --mode modified --dry-run --diff
+
 Documentation: https://github.com/balazscsaba2006/helm-env-delta
 `);
     program.showSuggestionAfterError(true);
@@ -63,6 +74,11 @@ Documentation: https://github.com/balazscsaba2006/helm-env-delta
         console.error('Error: --suggest-threshold must be a number between 0 and 1');
         process.exit(1);
     }
+    const validModes = ['new', 'modified', 'deleted', 'all'];
+    if (!validModes.includes(options['mode'])) {
+        console.error('Error: --mode must be one of: ' + validModes.join(', '));
+        process.exit(1);
+    }
     return {
         config: options['config'],
         dryRun: options['dryRun'],
@@ -79,7 +95,9 @@ Documentation: https://github.com/balazscsaba2006/helm-env-delta
         verbose: options['verbose'],
         quiet: options['quiet'],
         suggest: options['suggest'],
-        suggestThreshold: threshold
+        suggestThreshold: threshold,
+        filter: options['filter'],
+        mode: options['mode']
     };
 };
 exports.parseCommandLine = parseCommandLine;

package/dist/consoleDiffReporter.js

@@ -5,9 +5,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.showConsoleDiff = void 0;
 const chalk_1 = __importDefault(require("chalk"));
-const yaml_1 = __importDefault(require("yaml"));
 const fileDiff_1 = require("./fileDiff");
-const arrayDiffProcessor_1 = require("./utils/arrayDiffProcessor");
 const diffGenerator_1 = require("./utils/diffGenerator");
 const fileType_1 = require("./utils/fileType");
 const serialization_1 = require("./utils/serialization");
@@ -29,7 +27,7 @@ const formatAddedFiles = (files) => {
     if (files.length === 0)
         return '';
     const header = chalk_1.default.green.bold(`\nAdded Files (${files.length}):`);
-    const fileList = files.map((file) => chalk_1.default.green(`  + ${file}`)).join('\n');
+    const fileList = files.map((file) => chalk_1.default.green(`  + ${file.path}`)).join('\n');
     return `${header}\n${fileList}\n`;
 };
 const formatDeletedFiles = (files) => {
@@ -39,30 +37,6 @@ const formatDeletedFiles = (files) => {
     const fileList = files.map((file) => chalk_1.default.red(`  - ${file}`)).join('\n');
     return `${header}\n${fileList}\n`;
 };
-const formatArrayDiff = (change) => {
-    let output = '';
-    if (change.removed.length > 0) {
-        output += chalk_1.default.red.bold(`\n  Removed (${change.removed.length}):\n`);
-        for (const item of change.removed) {
-            const yaml = yaml_1.default.stringify(item, { indent: 4 });
-            const lines = yaml.split('\n').filter((l) => l.trim());
-            output += lines.map((l) => chalk_1.default.red(`    - ${l}`)).join('\n');
-            output += '\n';
-        }
-    }
-    if (change.added.length > 0) {
-        output += chalk_1.default.green.bold(`\n  Added (${change.added.length}):\n`);
-        for (const item of change.added) {
-            const yaml = yaml_1.default.stringify(item, { indent: 4 });
-            const lines = yaml.split('\n').filter((l) => l.trim());
-            output += lines.map((l) => chalk_1.default.green(`    + ${l}`)).join('\n');
-            output += '\n';
-        }
-    }
-    if (change.unchanged.length > 0)
-        output += chalk_1.default.gray(`\n  Unchanged: ${change.unchanged.length} items\n`);
-    return output;
-};
 const formatChangedFile = (file, config) => {
     const isYaml = (0, fileType_1.isYamlFile)(file.path);
     const separator = chalk_1.default.yellow('━'.repeat(60));
@@ -70,48 +44,21 @@ const formatChangedFile = (file, config) => {
     const skipPathInfo = skipPaths.length > 0
         ? chalk_1.default.dim(`SkipPath patterns applied: ${skipPaths.join(', ')}`)
         : chalk_1.default.dim('No skipPath patterns applied');
-    if (!isYaml) {
-        const destinationContent = String(file.processedDestContent);
-        const sourceContent = String(file.processedSourceContent);
-        const unifiedDiff = (0, diffGenerator_1.generateUnifiedDiff)(file.path, destinationContent, sourceContent);
-        const colorizedDiff = colorizeUnifiedDiff(unifiedDiff);
-        return `
-${separator}
-${chalk_1.default.yellow.bold(`File: ${file.path}`)}
-${skipPathInfo}
-
-${colorizedDiff}
-`;
-    }
-    const arrayInfo = (0, arrayDiffProcessor_1.detectArrayChanges)(file);
-    if (!arrayInfo.hasArrays) {
-        const destinationContent = (0, serialization_1.serializeForDiff)(file.processedDestContent, true);
-        const sourceContent = (0, serialization_1.serializeForDiff)(file.processedSourceContent, true);
-        const unifiedDiff = (0, diffGenerator_1.generateUnifiedDiff)(file.path, destinationContent, sourceContent);
-        const colorizedDiff = colorizeUnifiedDiff(unifiedDiff);
-        return `
+    const destinationContent = isYaml
+        ? (0, serialization_1.serializeForDiff)(file.processedDestContent, true)
+        : String(file.processedDestContent);
+    const sourceContent = isYaml
+        ? (0, serialization_1.serializeForDiff)(file.processedSourceContent, true)
+        : String(file.processedSourceContent);
+    const unifiedDiff = (0, diffGenerator_1.generateUnifiedDiff)(file.path, destinationContent, sourceContent);
+    const colorizedDiff = colorizeUnifiedDiff(unifiedDiff);
+    return `
 ${separator}
 ${chalk_1.default.yellow.bold(`File: ${file.path}`)}
 ${skipPathInfo}
 
 ${colorizedDiff}
 `;
-    }
-    let output = `\n${separator}\n${chalk_1.default.yellow.bold(`File: ${file.path}`)}\n${skipPathInfo}\n`;
-    const destinationContent = (0, serialization_1.serializeForDiff)(file.processedDestContent, true);
-    const sourceContent = (0, serialization_1.serializeForDiff)(file.processedSourceContent, true);
-    const unifiedDiff = (0, diffGenerator_1.generateUnifiedDiff)(file.path, destinationContent, sourceContent);
-    const colorizedDiff = colorizeUnifiedDiff(unifiedDiff);
-    output += `\n${colorizedDiff}\n`;
-    if (arrayInfo.hasChanges) {
-        output += chalk_1.default.cyan.bold('\nArray-specific details:\n');
-        for (const change of arrayInfo.changes) {
-            const pathString = change.path.join('.');
-            output += chalk_1.default.cyan(`\n  ${pathString}:\n`);
-            output += formatArrayDiff(change);
-        }
-    }
-    return output;
 };
 const formatChangedFiles = (files, config) => {
     if (files.length === 0)

package/dist/fileDiff.d.ts

@@ -1,7 +1,7 @@
 import { Config, FixedValueConfig, TransformConfig } from './configFile';
 import { FileMap } from './fileLoader';
 export interface FileDiffResult {
-    addedFiles: string[];
+    addedFiles: AddedFile[];
     deletedFiles: string[];
     changedFiles: ChangedFile[];
     unchangedFiles: string[];
@@ -21,6 +21,12 @@ export interface ChangedFile {
     parsedSource?: unknown;
     parsedDest?: unknown;
 }
+export interface AddedFile {
+    path: string;
+    originalPath?: string;
+    content: string;
+    processedContent: string;
+}
 export interface ProcessYamlOptions {
     filePath: string;
     sourceContent: string;

package/dist/fileDiff.js

@@ -14,6 +14,7 @@ const jsonPath_1 = require("./utils/jsonPath");
 const patternMatcher_1 = require("./utils/patternMatcher");
 const serialization_1 = require("./utils/serialization");
 const transformer_1 = require("./utils/transformer");
+const yamlFormatter_1 = require("./yamlFormatter");
 const FileDiffErrorClass = (0, errors_1.createErrorClass)('File Diff Error', {
     YAML_PARSE_ERROR: 'YAML file could not be parsed'
 });
@@ -21,11 +22,36 @@ class FileDiffError extends FileDiffErrorClass {
 }
 exports.FileDiffError = FileDiffError;
 exports.isFileDiffError = (0, errors_1.createErrorTypeGuard)(FileDiffError);
-const detectAddedFiles = (sourceFiles, destinationFiles) => {
+const processAddedFileContent = (filePath, content, transforms, fixedValues, outputFormat) => {
+    if (!(0, fileType_1.isYamlFile)(filePath))
+        return content;
+    try {
+        const parsed = yaml_1.default.parse(content);
+        const transformed = (0, transformer_1.applyTransforms)(parsed, filePath, transforms);
+        const fixedValueRules = (0, fixedValues_1.getFixedValuesForFile)(filePath, fixedValues);
+        if (fixedValueRules.length > 0)
+            (0, fixedValues_1.applyFixedValues)(transformed, fixedValueRules);
+        let processed = yaml_1.default.stringify(transformed);
+        processed = (0, yamlFormatter_1.formatYaml)(processed, filePath, outputFormat);
+        return processed;
+    }
+    catch {
+        return content;
+    }
+};
+const detectAddedFiles = (sourceFiles, destinationFiles, config, originalPaths) => {
     const addedFiles = [];
-    for (const path of sourceFiles.keys())
-        if (!destinationFiles.has(path))
-            addedFiles.push(path);
+    for (const [path, content] of sourceFiles.entries())
+        if (!destinationFiles.has(path)) {
+            const originalPath = originalPaths?.get(path);
+            const processedContent = processAddedFileContent(path, content, config.transforms, config.fixedValues, config.outputFormat);
+            addedFiles.push({
+                path,
+                originalPath,
+                content,
+                processedContent
+            });
+        }
     return addedFiles;
 };
 const detectDeletedFiles = (sourceFiles, destinationFiles) => {
@@ -228,7 +254,7 @@ const computeFileDiff = (sourceFiles, destinationFiles, config, logger, original
         if (skipPathCount > 0)
             logger.debug(`  SkipPath patterns: ${skipPathCount}`);
     }
-    const addedFiles = detectAddedFiles(sourceFiles, destinationFiles);
+    const addedFiles = detectAddedFiles(sourceFiles, destinationFiles, config, originalPaths);
     const deletedFiles = config.prune ? detectDeletedFiles(sourceFiles, destinationFiles) : [];
     const { changedFiles, unchangedFiles } = processChangedFiles(sourceFiles, destinationFiles, config.skipPath, config.transforms, config.fixedValues, originalPaths);
     return { addedFiles, deletedFiles, changedFiles, unchangedFiles };

package/dist/fileUpdater.js

@@ -249,11 +249,11 @@ const deleteFile = async (relativePath, absoluteDestinationDirectory, dryRun, lo
 const addNewFiles = async (files, sourceFiles, context) => {
     if (context.logger.shouldShow('debug'))
         context.logger.debug(`Processing ${files.length} new files`);
-    for (const relativePath of files)
+    for (const addedFile of files)
         try {
-            const content = sourceFiles.get(relativePath);
+            const content = sourceFiles.get(addedFile.path);
             await addFile({
-                relativePath,
+                relativePath: addedFile.path,
                 content,
                 absoluteDestinationDirectory: context.absoluteDestinationDirectory,
                 config: context.config,
@@ -263,7 +263,7 @@ const addNewFiles = async (files, sourceFiles, context) => {
             });
         }
         catch (error) {
-            context.errors.push({ operation: 'add', path: relativePath, error: error });
+            context.errors.push({ operation: 'add', path: addedFile.path, error: error });
         }
 };
 const updateChangedFiles = async (files, context) => {

package/dist/htmlReporter.js

@@ -11,6 +11,7 @@ const node_path_1 = __importDefault(require("node:path"));
 const diff2html_1 = require("diff2html");
 const browserLauncher_1 = require("./reporters/browserLauncher");
 const htmlTemplate_1 = require("./reporters/htmlTemplate");
+const treeRenderer_1 = require("./reporters/treeRenderer");
 const diffGenerator_1 = require("./utils/diffGenerator");
 const errors_1 = require("./utils/errors");
 const fileType_1 = require("./utils/fileType");
@@ -42,6 +43,28 @@ const generateFileSummary = (file) => {
         return file.path;
     return `<span class="filename-transform">${file.originalPath} → ${file.path}</span>`;
 };
+const generateAddedFileSummary = (file) => {
+    if (!file.originalPath)
+        return file.path;
+    return `<span class="filename-transform">${file.originalPath} → ${file.path}</span>`;
+};
+const generateAddedFileSection = (file, fileId) => {
+    const summary = generateAddedFileSummary(file);
+    const escapedContent = (0, treeRenderer_1.escapeHtml)(file.processedContent);
+    const filename = file.path.split('/').pop() || file.path;
+    return `
+    <details class="file-section" id="${fileId}" data-file-id="${fileId}" open>
+      <summary>${summary}</summary>
+      <div class="content-container">
+        <div class="content-actions">
+          <button class="copy-btn" data-file-id="${fileId}" title="Copy to clipboard">📋 Copy</button>
+          <button class="download-btn" data-file-id="${fileId}" data-filename="${(0, treeRenderer_1.escapeHtml)(filename)}" title="Download file">⬇ Download</button>
+        </div>
+        <pre class="file-content"><code>${escapedContent}</code></pre>
+      </div>
+    </details>
+  `;
+};
 const generateChangedFileSection = (file, fileId) => {
     const isYaml = (0, fileType_1.isYamlFile)(file.path);
     const summary = generateFileSummary(file);
@@ -91,7 +114,11 @@ const generateHtmlReport = async (diffResult, formattedFiles, config, dryRun, lo
     for (const [index, file] of diffResult.changedFiles.entries())
         changedFileIds.set(file.path, `file-${index}`);
     const changedSections = diffResult.changedFiles.map((file, index) => generateChangedFileSection(file, `file-${index}`));
-    const htmlContent = (0, htmlTemplate_1.generateHtmlTemplate)(diffResult, formattedFiles, trulyUnchangedFiles, metadata, changedSections, changedFileIds);
+    const addedFileIds = new Map();
+    for (const [index, file] of diffResult.addedFiles.entries())
+        addedFileIds.set(file.path, `added-file-${index}`);
+    const addedSections = diffResult.addedFiles.map((file, index) => generateAddedFileSection(file, `added-file-${index}`));
+    const htmlContent = (0, htmlTemplate_1.generateHtmlTemplate)(diffResult, formattedFiles, trulyUnchangedFiles, metadata, changedSections, changedFileIds, addedSections, addedFileIds);
     await writeHtmlFile(htmlContent, reportPath);
     logger?.log(`✓ HTML report generated: ${reportPath}, opening in browser...`);
     try {

package/dist/index.js

@@ -60,6 +60,7 @@ const stopRulesValidator_1 = require("./stopRulesValidator");
 const suggestionEngine_1 = require("./suggestionEngine");
 const collisionDetector_1 = require("./utils/collisionDetector");
 const commentOnlyDetector_1 = require("./utils/commentOnlyDetector");
+const fileFilter_1 = require("./utils/fileFilter");
 const filenameTransformer_1 = require("./utils/filenameTransformer");
 const fileType_1 = require("./utils/fileType");
 const versionChecker_1 = require("./utils/versionChecker");
@@ -113,14 +114,19 @@ const main = async () => {
             transforms: validationConfig.transforms,
             skipExclude: true
         }, logger);
-        const sourceFiles = sourceResult.fileMap;
+        let sourceFiles = sourceResult.fileMap;
         const destinationResult = await (0, fileLoader_1.loadFiles)({
             baseDirectory: validationConfig.destination,
             include: validationConfig.include,
             exclude: validationConfig.exclude,
             skipExclude: true
         }, logger);
-        const destinationFiles = destinationResult.fileMap;
+        let destinationFiles = destinationResult.fileMap;
+        if (command.filter) {
+            const filtered = (0, fileFilter_1.filterFileMaps)(sourceFiles, destinationFiles, command.filter);
+            sourceFiles = filtered.sourceFiles;
+            destinationFiles = filtered.destinationFiles;
+        }
         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)(validationConfig, sourceFiles, destinationFiles);
@@ -159,7 +165,9 @@ const main = async () => {
             include: config.include,
             exclude: config.exclude
         }, logger);
-        const destinationFiles = destinationResult.fileMap;
+        let destinationFiles = destinationResult.fileMap;
+        if (command.filter)
+            destinationFiles = (0, fileFilter_1.filterFileMap)(destinationFiles, command.filter);
         logger.progress(`Loaded ${destinationFiles.size} destination file(s)`, 'success');
         if (command.listFiles) {
             const filesList = [...destinationFiles.keys()].toSorted();
@@ -218,7 +226,7 @@ const main = async () => {
         exclude: syncConfig.exclude,
         transforms: syncConfig.transforms
     }, logger);
-    const sourceFiles = sourceResult.fileMap;
+    let sourceFiles = sourceResult.fileMap;
     const originalPaths = sourceResult.originalPaths;
     logger.progress(`Loaded ${sourceFiles.size} source file(s)`, 'success');
     const collisions = (0, collisionDetector_1.detectCollisions)(sourceFiles, syncConfig.transforms);
@@ -231,8 +239,14 @@ const main = async () => {
         include: syncConfig.include,
         exclude: syncConfig.exclude
     }, logger);
-    const destinationFiles = destinationResult.fileMap;
+    let destinationFiles = destinationResult.fileMap;
     logger.progress(`Loaded ${destinationFiles.size} destination file(s)`, 'success');
+    if (command.filter) {
+        const filtered = (0, fileFilter_1.filterFileMaps)(sourceFiles, destinationFiles, command.filter);
+        sourceFiles = filtered.sourceFiles;
+        destinationFiles = filtered.destinationFiles;
+        logger.progress(`Filter '${command.filter}' matched ${sourceFiles.size} source, ${destinationFiles.size} destination file(s)`, 'info');
+    }
     if (command.listFiles) {
         const sourceFilesList = [...sourceFiles.keys()].toSorted();
         const destinationFilesList = [...destinationFiles.keys()].toSorted();
@@ -246,7 +260,8 @@ const main = async () => {
         return;
     }
     logger.log('\n' + (0, consoleFormatter_1.formatProgressMessage)('Computing differences...', 'info'));
-    const diffResult = (0, fileDiff_1.computeFileDiff)(sourceFiles, destinationFiles, syncConfig, logger, originalPaths);
+    const rawDiffResult = (0, fileDiff_1.computeFileDiff)(sourceFiles, destinationFiles, syncConfig, logger, originalPaths);
+    const diffResult = (0, fileFilter_1.filterDiffResultByMode)(rawDiffResult, command.mode);
     if (logger.shouldShow('debug'))
         logger.debug('Diff pipeline: parse → transforms → skipPath → normalize → compare');
     if (command.diff && !command.quiet)

package/dist/jsonReporter.d.ts

@@ -43,8 +43,13 @@ export interface ChangedFileDetail {
     diff: string;
     changes: FieldChange[];
 }
+export interface AddedFileDetail {
+    path: string;
+    originalPath?: string;
+    content: string;
+}
 export interface JsonReportFiles {
-    added: string[];
+    added: AddedFileDetail[];
     deleted: string[];
     changed: ChangedFileDetail[];
     formatted: string[];

package/dist/jsonReporter.js

@@ -81,8 +81,13 @@ const generateJsonReport = (diffResult, formattedFiles, validationResult, config
             unchanged: diffResult.unchangedFiles.length
         };
         const changedFileDetails = diffResult.changedFiles.map((file) => generateChangedFileDetail(file));
+        const addedFileDetails = diffResult.addedFiles.map((file) => ({
+            path: file.path,
+            originalPath: file.originalPath,
+            content: file.processedContent
+        }));
         const files = {
-            added: diffResult.addedFiles,
+            added: addedFileDetails,
             deleted: diffResult.deletedFiles,
             changed: changedFileDetails,
             formatted: formattedFiles,

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  .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  /* Treeview styles */\n  .tree-root {\n    list-style: none;\n    padding: 0;\n    margin: 10px 0;\n    font-family: ui-monospace, SFMono-Regular, \"SF Mono\", Menlo, Consolas, \"Liberation Mono\", monospace;\n    font-size: 13px;\n  }\n\n  .tree-root ul {\n    list-style: none;\n    padding-left: 20px;\n    margin: 0;\n  }\n\n  .tree-folder,\n  .tree-file {\n    padding: 4px 8px;\n    border-radius: 4px;\n    cursor: default;\n  }\n\n  .tree-folder:hover,\n  .tree-file:hover {\n    background: #f6f8fa;\n  }\n\n  .tree-toggle {\n    display: inline-block;\n    width: 16px;\n    cursor: pointer;\n    color: #586069;\n    font-size: 10px;\n    user-select: none;\n  }\n\n  .tree-folder.collapsed > .tree-toggle {\n    transform: rotate(-90deg);\n  }\n\n  .tree-folder.collapsed > .tree-children {\n    display: none;\n  }\n\n  .tree-folder-name {\n    color: #0969da;\n    font-weight: 500;\n  }\n\n  .tree-file-name {\n    color: #586069;\n    padding-left: 16px;\n  }\n\n  /* Sidebar styles */\n  .sidebar-container {\n    display: flex;\n    gap: 0;\n  }\n\n  .sidebar {\n    width: 280px;\n    min-width: 280px;\n    border-right: 1px solid #d0d7de;\n    background: #f6f8fa;\n    transition: width 0.2s, min-width 0.2s, padding 0.2s, opacity 0.2s;\n  }\n\n  .sidebar.collapsed {\n    width: 0;\n    min-width: 0;\n    padding: 0;\n    overflow: hidden;\n    border-right: none;\n  }\n\n  .sidebar-header {\n    display: flex;\n    justify-content: space-between;\n    align-items: center;\n    padding: 12px 16px;\n    border-bottom: 1px solid #d0d7de;\n    background: #fff;\n    font-weight: 600;\n    font-size: 14px;\n    color: #24292e;\n    position: sticky;\n    top: 0;\n    z-index: 1;\n  }\n\n  .sidebar-toggle {\n    background: none;\n    border: 1px solid #d0d7de;\n    border-radius: 4px;\n    cursor: pointer;\n    padding: 4px 8px;\n    color: #586069;\n    font-size: 12px;\n  }\n\n  .sidebar-toggle:hover {\n    background: #f6f8fa;\n    color: #24292e;\n  }\n\n  .sidebar-content {\n    padding: 8px;\n  }\n\n  .sidebar-tree .tree-file-link {\n    color: #586069;\n    text-decoration: none;\n    padding-left: 16px;\n    display: block;\n  }\n\n  .sidebar-tree .tree-file-link:hover {\n    color: #0969da;\n  }\n\n  .sidebar-tree .tree-file.active .tree-file-link {\n    color: #0969da;\n    font-weight: 600;\n  }\n\n  .changed-content {\n    flex: 1;\n    min-width: 0;\n    padding-left: 20px;\n  }\n\n  .sidebar-expand-btn {\n    display: none;\n    position: fixed;\n    left: 0;\n    top: 50%;\n    transform: translateY(-50%);\n    background: #f6f8fa;\n    border: 1px solid #d0d7de;\n    border-left: none;\n    border-radius: 0 4px 4px 0;\n    padding: 8px 4px;\n    cursor: pointer;\n    color: #586069;\n    z-index: 100;\n  }\n\n  .sidebar-expand-btn:hover {\n    background: #eaeef2;\n    color: #24292e;\n  }\n\n  .sidebar.collapsed ~ .sidebar-expand-btn {\n    display: block;\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  /* Treeview styles */\n  .tree-root {\n    list-style: none;\n    padding: 0;\n    margin: 10px 0;\n    font-family: ui-monospace, SFMono-Regular, \"SF Mono\", Menlo, Consolas, \"Liberation Mono\", monospace;\n    font-size: 13px;\n  }\n\n  .tree-root ul {\n    list-style: none;\n    padding-left: 20px;\n    margin: 0;\n  }\n\n  .tree-folder,\n  .tree-file {\n    padding: 4px 8px;\n    border-radius: 4px;\n    cursor: default;\n  }\n\n  .tree-folder:hover,\n  .tree-file:hover {\n    background: #f6f8fa;\n  }\n\n  .tree-toggle {\n    display: inline-block;\n    width: 16px;\n    cursor: pointer;\n    color: #586069;\n    font-size: 10px;\n    user-select: none;\n  }\n\n  .tree-folder.collapsed > .tree-toggle {\n    transform: rotate(-90deg);\n  }\n\n  .tree-folder.collapsed > .tree-children {\n    display: none;\n  }\n\n  .tree-folder-name {\n    color: #0969da;\n    font-weight: 500;\n  }\n\n  .tree-file-name {\n    color: #586069;\n    padding-left: 16px;\n  }\n\n  /* Sidebar styles */\n  .sidebar-container {\n    display: flex;\n    gap: 0;\n  }\n\n  .sidebar {\n    width: 280px;\n    min-width: 280px;\n    border-right: 1px solid #d0d7de;\n    background: #f6f8fa;\n    transition: width 0.2s, min-width 0.2s, padding 0.2s, opacity 0.2s;\n  }\n\n  .sidebar.collapsed {\n    width: 0;\n    min-width: 0;\n    padding: 0;\n    overflow: hidden;\n    border-right: none;\n  }\n\n  .sidebar-header {\n    display: flex;\n    justify-content: space-between;\n    align-items: center;\n    padding: 12px 16px;\n    border-bottom: 1px solid #d0d7de;\n    background: #fff;\n    font-weight: 600;\n    font-size: 14px;\n    color: #24292e;\n    position: sticky;\n    top: 0;\n    z-index: 1;\n  }\n\n  .sidebar-toggle {\n    background: none;\n    border: 1px solid #d0d7de;\n    border-radius: 4px;\n    cursor: pointer;\n    padding: 4px 8px;\n    color: #586069;\n    font-size: 12px;\n  }\n\n  .sidebar-toggle:hover {\n    background: #f6f8fa;\n    color: #24292e;\n  }\n\n  .sidebar-content {\n    padding: 8px;\n  }\n\n  .sidebar-tree .tree-file-link {\n    color: #586069;\n    text-decoration: none;\n    padding-left: 16px;\n    display: block;\n  }\n\n  .sidebar-tree .tree-file-link:hover {\n    color: #0969da;\n  }\n\n  .sidebar-tree .tree-file.active .tree-file-link {\n    color: #0969da;\n    font-weight: 600;\n  }\n\n  .changed-content {\n    flex: 1;\n    min-width: 0;\n    padding-left: 20px;\n  }\n\n  .sidebar-expand-btn {\n    display: none;\n    position: fixed;\n    left: 0;\n    top: 50%;\n    transform: translateY(-50%);\n    background: #f6f8fa;\n    border: 1px solid #d0d7de;\n    border-left: none;\n    border-radius: 0 4px 4px 0;\n    padding: 8px 4px;\n    cursor: pointer;\n    color: #586069;\n    z-index: 100;\n  }\n\n  .sidebar-expand-btn:hover {\n    background: #eaeef2;\n    color: #24292e;\n  }\n\n  .sidebar.collapsed ~ .sidebar-expand-btn {\n    display: block;\n  }\n\n  /* Added content area (same as changed-content) */\n  .added-content {\n    flex: 1;\n    min-width: 0;\n    padding-left: 20px;\n  }\n\n  /* Content container for added files */\n  .content-container {\n    padding: 16px;\n    background: #f6f8fa;\n    border-top: 1px solid #d0d7de;\n  }\n\n  .content-actions {\n    display: flex;\n    gap: 8px;\n    margin-bottom: 12px;\n  }\n\n  .copy-btn,\n  .download-btn {\n    padding: 6px 12px;\n    border: 1px solid #d0d7de;\n    border-radius: 6px;\n    background: white;\n    cursor: pointer;\n    font-size: 13px;\n    font-family: -apple-system, BlinkMacSystemFont, \"Segoe UI\", Roboto, Helvetica, Arial, sans-serif;\n    color: #24292e;\n    transition: all 0.2s;\n  }\n\n  .copy-btn:hover,\n  .download-btn:hover {\n    background: #f3f4f6;\n    border-color: #b0b7be;\n  }\n\n  .copy-btn.copied {\n    background: #d4edda;\n    border-color: #28a745;\n    color: #155724;\n  }\n\n  .file-content {\n    margin: 0;\n    padding: 16px;\n    background: white;\n    border: 1px solid #d0d7de;\n    border-radius: 6px;\n    overflow-x: auto;\n    font-family: ui-monospace, SFMono-Regular, \"SF Mono\", Menlo, Consolas, \"Liberation Mono\", monospace;\n    font-size: 12px;\n    line-height: 1.5;\n    white-space: pre;\n  }\n\n  .file-content code {\n    font-family: inherit;\n  }\n";
 export declare const TAB_SCRIPT: string;

package/dist/reporters/htmlStyles.js

@@ -314,6 +314,68 @@ exports.HTML_STYLES = `
   .sidebar.collapsed ~ .sidebar-expand-btn {
     display: block;
   }
+
+  /* Added content area (same as changed-content) */
+  .added-content {
+    flex: 1;
+    min-width: 0;
+    padding-left: 20px;
+  }
+
+  /* Content container for added files */
+  .content-container {
+    padding: 16px;
+    background: #f6f8fa;
+    border-top: 1px solid #d0d7de;
+  }
+
+  .content-actions {
+    display: flex;
+    gap: 8px;
+    margin-bottom: 12px;
+  }
+
+  .copy-btn,
+  .download-btn {
+    padding: 6px 12px;
+    border: 1px solid #d0d7de;
+    border-radius: 6px;
+    background: white;
+    cursor: pointer;
+    font-size: 13px;
+    font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, Helvetica, Arial, sans-serif;
+    color: #24292e;
+    transition: all 0.2s;
+  }
+
+  .copy-btn:hover,
+  .download-btn:hover {
+    background: #f3f4f6;
+    border-color: #b0b7be;
+  }
+
+  .copy-btn.copied {
+    background: #d4edda;
+    border-color: #28a745;
+    color: #155724;
+  }
+
+  .file-content {
+    margin: 0;
+    padding: 16px;
+    background: white;
+    border: 1px solid #d0d7de;
+    border-radius: 6px;
+    overflow-x: auto;
+    font-family: ui-monospace, SFMono-Regular, "SF Mono", Menlo, Consolas, "Liberation Mono", monospace;
+    font-size: 12px;
+    line-height: 1.5;
+    white-space: pre;
+  }
+
+  .file-content code {
+    font-family: inherit;
+  }
 `;
 exports.TAB_SCRIPT = String.raw `
   // Tab switching
@@ -343,28 +405,36 @@ exports.TAB_SCRIPT = String.raw `
     });
   });
 
-  // Sidebar toggle
-  const sidebarToggle = document.querySelector('.sidebar-toggle');
-  const sidebar = document.querySelector('.sidebar');
-  const expandBtn = document.querySelector('.sidebar-expand-btn');
-
-  if (sidebarToggle && sidebar) {
-    sidebarToggle.addEventListener('click', () => {
-      sidebar.classList.toggle('collapsed');
-      sidebarToggle.textContent = sidebar.classList.contains('collapsed') ? '\u25B6' : '\u25C0';
+  // Sidebar toggle (supports multiple sidebars)
+  document.querySelectorAll('.sidebar-toggle').forEach(toggle => {
+    toggle.addEventListener('click', () => {
+      const container = toggle.closest('.sidebar-container');
+      if (!container) return;
+      const sidebar = container.querySelector('.sidebar');
+      if (sidebar) {
+        sidebar.classList.toggle('collapsed');
+        toggle.textContent = sidebar.classList.contains('collapsed') ? '\u25B6' : '\u25C0';
+      }
     });
-  }
+  });
 
-  if (expandBtn && sidebar) {
+  // Sidebar expand button (supports multiple sidebars)
+  document.querySelectorAll('.sidebar-expand-btn').forEach(expandBtn => {
     expandBtn.addEventListener('click', () => {
-      sidebar.classList.remove('collapsed');
-      if (sidebarToggle) {
-        sidebarToggle.textContent = '\u25C0';
+      const container = expandBtn.closest('.sidebar-container');
+      if (!container) return;
+      const sidebar = container.querySelector('.sidebar');
+      const toggle = container.querySelector('.sidebar-toggle');
+      if (sidebar) {
+        sidebar.classList.remove('collapsed');
+        if (toggle) {
+          toggle.textContent = '\u25C0';
+        }
       }
     });
-  }
+  });
 
-  // Sidebar file click - scroll to diff
+  // Sidebar file click - scroll to diff/content
   document.querySelectorAll('.sidebar-tree .tree-file-link').forEach(link => {
     link.addEventListener('click', (e) => {
       e.preventDefault();
@@ -376,8 +446,11 @@ exports.TAB_SCRIPT = String.raw `
         if (target.tagName === 'DETAILS' && !target.open) {
           target.open = true;
         }
-        // Highlight active file in sidebar
-        document.querySelectorAll('.sidebar-tree .tree-file').forEach(f => f.classList.remove('active'));
+        // Highlight active file in sidebar (within same container)
+        const container = link.closest('.sidebar-container');
+        if (container) {
+          container.querySelectorAll('.sidebar-tree .tree-file').forEach(f => f.classList.remove('active'));
+        }
         link.closest('.tree-file').classList.add('active');
       }
     });
@@ -390,18 +463,94 @@ exports.TAB_SCRIPT = String.raw `
       entries.forEach(entry => {
         if (entry.isIntersecting) {
           const fileId = entry.target.id;
-          document.querySelectorAll('.sidebar-tree .tree-file').forEach(f => {
-            const link = f.querySelector('.tree-file-link');
-            if (link && link.getAttribute('href') === '#' + fileId) {
-              f.classList.add('active');
-            } else {
-              f.classList.remove('active');
-            }
-          });
+          // Find the corresponding sidebar container
+          const tabContent = entry.target.closest('.tab-content');
+          if (tabContent) {
+            tabContent.querySelectorAll('.sidebar-tree .tree-file').forEach(f => {
+              const link = f.querySelector('.tree-file-link');
+              if (link && link.getAttribute('href') === '#' + fileId) {
+                f.classList.add('active');
+              } else {
+                f.classList.remove('active');
+              }
+            });
+          }
         }
       });
     }, { threshold: 0.3, rootMargin: '-100px 0px -50% 0px' });
 
     fileSections.forEach(section => observer.observe(section));
   }
+
+  // Copy button functionality
+  document.querySelectorAll('.copy-btn').forEach(btn => {
+    btn.addEventListener('click', async () => {
+      const fileId = btn.getAttribute('data-file-id');
+      const section = document.getElementById(fileId);
+      if (!section) return;
+
+      const codeElement = section.querySelector('.file-content code');
+      if (!codeElement) return;
+
+      const content = codeElement.textContent || '';
+
+      try {
+        // Try modern clipboard API first
+        if (navigator.clipboard && navigator.clipboard.writeText) {
+          await navigator.clipboard.writeText(content);
+        } else {
+          // Fallback for older browsers
+          const textarea = document.createElement('textarea');
+          textarea.value = content;
+          textarea.style.position = 'fixed';
+          textarea.style.opacity = '0';
+          document.body.appendChild(textarea);
+          textarea.select();
+          document.execCommand('copy');
+          document.body.removeChild(textarea);
+        }
+
+        // Visual feedback
+        const originalText = btn.textContent;
+        btn.textContent = '\u2713 Copied!';
+        btn.classList.add('copied');
+        setTimeout(() => {
+          btn.textContent = originalText;
+          btn.classList.remove('copied');
+        }, 2000);
+      } catch (err) {
+        console.error('Failed to copy:', err);
+        btn.textContent = '\u2717 Failed';
+        setTimeout(() => {
+          btn.textContent = '\ud83d\udccb Copy';
+        }, 2000);
+      }
+    });
+  });
+
+  // Download button functionality
+  document.querySelectorAll('.download-btn').forEach(btn => {
+    btn.addEventListener('click', () => {
+      const fileId = btn.getAttribute('data-file-id');
+      const filename = btn.getAttribute('data-filename') || 'file.yaml';
+      const section = document.getElementById(fileId);
+      if (!section) return;
+
+      const codeElement = section.querySelector('.file-content code');
+      if (!codeElement) return;
+
+      const content = codeElement.textContent || '';
+
+      // Create blob and download
+      const blob = new Blob([content], { type: 'text/plain;charset=utf-8' });
+      const url = URL.createObjectURL(blob);
+      const link = document.createElement('a');
+      link.href = url;
+      link.download = filename;
+      document.body.appendChild(link);
+      link.click();
+      document.body.removeChild(link);
+      URL.revokeObjectURL(url);
+    });
+  });
 `;

package/dist/reporters/htmlTemplate.d.ts

@@ -5,4 +5,4 @@ export interface ReportMetadata {
     destination: string;
     dryRun: boolean;
 }
-export declare const generateHtmlTemplate: (diffResult: FileDiffResult, formattedFiles: string[], trulyUnchangedFiles: string[], metadata: ReportMetadata, changedSections: string[], changedFileIds?: Map<string, string>) => string;
+export declare const generateHtmlTemplate: (diffResult: FileDiffResult, formattedFiles: string[], trulyUnchangedFiles: string[], metadata: ReportMetadata, changedSections: string[], changedFileIds?: Map<string, string>, addedSections?: string[], addedFileIds?: Map<string, string>) => string;

package/dist/reporters/htmlTemplate.js

@@ -4,10 +4,11 @@ exports.generateHtmlTemplate = void 0;
 const htmlStyles_1 = require("./htmlStyles");
 const treeBuilder_1 = require("./treeBuilder");
 const treeRenderer_1 = require("./treeRenderer");
-const generateHtmlTemplate = (diffResult, formattedFiles, trulyUnchangedFiles, metadata, changedSections, changedFileIds = new Map()) => {
+const generateHtmlTemplate = (diffResult, formattedFiles, trulyUnchangedFiles, metadata, changedSections, changedFileIds = new Map(), addedSections = [], addedFileIds = new Map()) => {
     const changedFilePaths = diffResult.changedFiles.map((f) => f.path);
     const changedTree = (0, treeBuilder_1.buildFileTree)(changedFilePaths);
-    const addedTree = (0, treeBuilder_1.buildFileTree)(diffResult.addedFiles);
+    const addedFilePaths = diffResult.addedFiles.map((f) => f.path);
+    const addedTree = (0, treeBuilder_1.buildFileTree)(addedFilePaths);
     const deletedTree = (0, treeBuilder_1.buildFileTree)(diffResult.deletedFiles);
     const formattedTree = (0, treeBuilder_1.buildFileTree)(formattedFiles);
     const unchangedTree = (0, treeBuilder_1.buildFileTree)(trulyUnchangedFiles);
@@ -72,10 +73,22 @@ ${htmlStyles_1.HTML_STYLES}
     </section>
 
     <section id="added" class="tab-content">
-      ${diffResult.addedFiles.length > 0
+      ${addedSections.length > 0
         ? `
-        <div class="file-list">
-          ${(0, treeRenderer_1.renderTreeview)(addedTree)}
+        <div class="sidebar-container">
+          <aside class="sidebar" id="added-sidebar">
+            <div class="sidebar-header">
+              <span>Added Files</span>
+              <button class="sidebar-toggle" data-sidebar="added">&#9664;</button>
+            </div>
+            <div class="sidebar-content">
+              ${(0, treeRenderer_1.renderSidebarTree)(addedTree, addedFileIds)}
+            </div>
+          </aside>
+          <button class="sidebar-expand-btn" data-sidebar="added">&#9654;</button>
+          <div class="added-content">
+            ${addedSections.join('\n')}
+          </div>
         </div>
       `
         : '<p style="color: #586069; text-align: center; padding: 40px;">No added files</p>'}

package/dist/reporters/treeRenderer.d.ts

@@ -1,3 +1,4 @@
 import { TreeNode } from './treeBuilder';
 export declare const renderTreeview: (nodes: TreeNode[]) => string;
 export declare const renderSidebarTree: (nodes: TreeNode[], fileIds: Map<string, string>) => string;
+export declare const escapeHtml: (text: string) => string;

package/dist/reporters/treeRenderer.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.renderSidebarTree = exports.renderTreeview = void 0;
+exports.escapeHtml = exports.renderSidebarTree = exports.renderTreeview = void 0;
 const renderTreeview = (nodes) => {
     if (nodes.length === 0)
         return '';
@@ -11,15 +11,15 @@ const renderTreeNode = (node) => {
     if (node.isFolder) {
         const children = node.children ? node.children.map((child) => renderTreeNode(child)).join('') : '';
         return `
-      <li class="tree-folder" data-path="${escapeHtml(node.path)}">
+      <li class="tree-folder" data-path="${(0, exports.escapeHtml)(node.path)}">
         <span class="tree-toggle">&#9660;</span>
-        <span class="tree-folder-name">${escapeHtml(node.name)}</span>
+        <span class="tree-folder-name">${(0, exports.escapeHtml)(node.name)}</span>
         <ul class="tree-children">${children}</ul>
       </li>`;
     }
     return `
-    <li class="tree-file" data-path="${escapeHtml(node.path)}">
-      <span class="tree-file-name">${escapeHtml(node.name)}</span>
+    <li class="tree-file" data-path="${(0, exports.escapeHtml)(node.path)}">
+      <span class="tree-file-name">${(0, exports.escapeHtml)(node.name)}</span>
     </li>`;
 };
 const renderSidebarTree = (nodes, fileIds) => {
@@ -32,16 +32,16 @@ const renderSidebarNode = (node, fileIds) => {
     if (node.isFolder) {
         const children = node.children ? node.children.map((child) => renderSidebarNode(child, fileIds)).join('') : '';
         return `
-      <li class="tree-folder" data-path="${escapeHtml(node.path)}">
+      <li class="tree-folder" data-path="${(0, exports.escapeHtml)(node.path)}">
         <span class="tree-toggle">&#9660;</span>
-        <span class="tree-folder-name">${escapeHtml(node.name)}</span>
+        <span class="tree-folder-name">${(0, exports.escapeHtml)(node.name)}</span>
         <ul class="tree-children">${children}</ul>
       </li>`;
     }
     const fileId = fileIds.get(node.path) || '';
     return `
-    <li class="tree-file" data-path="${escapeHtml(node.path)}" data-file-id="${escapeHtml(fileId)}">
-      <a href="#${escapeHtml(fileId)}" class="tree-file-link">${escapeHtml(node.name)}</a>
+    <li class="tree-file" data-path="${(0, exports.escapeHtml)(node.path)}" data-file-id="${(0, exports.escapeHtml)(fileId)}">
+      <a href="#${(0, exports.escapeHtml)(fileId)}" class="tree-file-link">${(0, exports.escapeHtml)(node.name)}</a>
     </li>`;
 };
 const escapeHtml = (text) => text
@@ -50,3 +50,4 @@ const escapeHtml = (text) => text
     .replaceAll('>', '&gt;')
     .replaceAll('"', '&quot;')
     .replaceAll("'", '&#39;');
+exports.escapeHtml = escapeHtml;

package/dist/utils/fileFilter.d.ts

@@ -0,0 +1,9 @@
+import type { FileDiffResult } from '../fileDiff';
+import type { FileMap } from '../fileLoader';
+export type ChangeMode = 'new' | 'modified' | 'deleted' | 'all';
+export declare const filterDiffResultByMode: (diffResult: FileDiffResult, mode: ChangeMode) => FileDiffResult;
+export declare const filterFileMap: (fileMap: FileMap, filter: string | undefined) => FileMap;
+export declare const filterFileMaps: (sourceFiles: FileMap, destinationFiles: FileMap, filter: string | undefined) => {
+    sourceFiles: FileMap;
+    destinationFiles: FileMap;
+};

package/dist/utils/fileFilter.js

@@ -0,0 +1,50 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.filterFileMaps = exports.filterFileMap = exports.filterDiffResultByMode = void 0;
+const filterDiffResultByMode = (diffResult, mode) => {
+    if (mode === 'all')
+        return diffResult;
+    return {
+        addedFiles: mode === 'new' ? diffResult.addedFiles : [],
+        deletedFiles: mode === 'deleted' ? diffResult.deletedFiles : [],
+        changedFiles: mode === 'modified' ? diffResult.changedFiles : [],
+        unchangedFiles: diffResult.unchangedFiles
+    };
+};
+exports.filterDiffResultByMode = filterDiffResultByMode;
+const filterFileMap = (fileMap, filter) => {
+    if (!filter)
+        return fileMap;
+    const lowerFilter = filter.toLowerCase();
+    const filteredMap = new Map();
+    for (const [filePath, content] of fileMap) {
+        const filenameMatches = filePath.toLowerCase().includes(lowerFilter);
+        const contentMatches = content.toLowerCase().includes(lowerFilter);
+        if (filenameMatches || contentMatches)
+            filteredMap.set(filePath, content);
+    }
+    return filteredMap;
+};
+exports.filterFileMap = filterFileMap;
+const filterFileMaps = (sourceFiles, destinationFiles, filter) => {
+    if (!filter)
+        return { sourceFiles, destinationFiles };
+    const lowerFilter = filter.toLowerCase();
+    const matchingPaths = new Set();
+    for (const [filePath, content] of sourceFiles)
+        if (filePath.toLowerCase().includes(lowerFilter) || content.toLowerCase().includes(lowerFilter))
+            matchingPaths.add(filePath);
+    for (const [filePath, content] of destinationFiles)
+        if (filePath.toLowerCase().includes(lowerFilter) || content.toLowerCase().includes(lowerFilter))
+            matchingPaths.add(filePath);
+    const filteredSource = new Map();
+    const filteredDestination = new Map();
+    for (const [filePath, content] of sourceFiles)
+        if (matchingPaths.has(filePath))
+            filteredSource.set(filePath, content);
+    for (const [filePath, content] of destinationFiles)
+        if (matchingPaths.has(filePath))
+            filteredDestination.set(filePath, content);
+    return { sourceFiles: filteredSource, destinationFiles: filteredDestination };
+};
+exports.filterFileMaps = filterFileMaps;

package/dist/utils/index.d.ts

@@ -7,7 +7,6 @@ export { clearJsonPathCache, getValueAtPath, isFilterSegment, matchesFilter, par
 export { isYamlFile } from './fileType';
 export { globalMatcher, PatternMatcher } from './patternMatcher';
 export { generateUnifiedDiff } from './diffGenerator';
-export { type ArrayChange, type ArrayChangeInfo, detectArrayChanges } from './arrayDiffProcessor';
 export { checkForUpdates, isVersionCheckerError, VersionCheckerError } from './versionChecker';
 export { escapeRegex, isYamlFileLoaderError, loadYamlFile, YamlFileLoaderError } from './yamlFileLoader';
 export { isTransformFileLoaderError, loadTransformFile, loadTransformFiles, TransformFileLoaderError } from './transformFileLoader';
@@ -21,3 +20,4 @@ export { applyFixedValues, getFixedValuesForFile, setValueAtPath } from './fixed
 export type { ApplicableFilter } from './arrayMerger';
 export { findMatchingTargetItem, getApplicableArrayFilters, itemMatchesAnyFilter, shouldPreserveItem } from './arrayMerger';
 export { isCommentOnlyContent } from './commentOnlyDetector';
+export { filterFileMap, filterFileMaps } from './fileFilter';

package/dist/utils/index.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-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.matchesFilter = exports.isFilterSegment = exports.getValueAtPath = exports.clearJsonPathCache = exports.serializeForDiff = exports.normalizeForComparison = exports.deepEqual = exports.createErrorTypeGuard = exports.createErrorClass = void 0;
-exports.isCommentOnlyContent = exports.shouldPreserveItem = exports.itemMatchesAnyFilter = exports.getApplicableArrayFilters = exports.findMatchingTargetItem = exports.setValueAtPath = exports.getFixedValuesForFile = exports.applyFixedValues = exports.UUID_PATTERN = exports.SEMVER_PATTERN = exports.SEMANTIC_PATTERNS = exports.SEMANTIC_KEYWORDS = exports.PROBLEMATIC_REGEX_CHARS = exports.NUMERIC_MIN_MULTIPLIER = 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.generateUnifiedDiff = exports.PatternMatcher = exports.globalMatcher = exports.isYamlFile = exports.parseJsonPath = exports.parseFilterSegment = exports.matchesFilter = exports.isFilterSegment = exports.getValueAtPath = exports.clearJsonPathCache = exports.serializeForDiff = exports.normalizeForComparison = exports.deepEqual = exports.createErrorTypeGuard = exports.createErrorClass = void 0;
+exports.filterFileMaps = exports.filterFileMap = exports.isCommentOnlyContent = exports.shouldPreserveItem = exports.itemMatchesAnyFilter = exports.getApplicableArrayFilters = exports.findMatchingTargetItem = exports.setValueAtPath = exports.getFixedValuesForFile = exports.applyFixedValues = 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; } });
@@ -24,8 +24,6 @@ Object.defineProperty(exports, "globalMatcher", { enumerable: true, get: functio
 Object.defineProperty(exports, "PatternMatcher", { enumerable: true, get: function () { return patternMatcher_1.PatternMatcher; } });
 var diffGenerator_1 = require("./diffGenerator");
 Object.defineProperty(exports, "generateUnifiedDiff", { enumerable: true, get: function () { return diffGenerator_1.generateUnifiedDiff; } });
-var arrayDiffProcessor_1 = require("./arrayDiffProcessor");
-Object.defineProperty(exports, "detectArrayChanges", { enumerable: true, get: function () { return arrayDiffProcessor_1.detectArrayChanges; } });
 var versionChecker_1 = require("./versionChecker");
 Object.defineProperty(exports, "checkForUpdates", { enumerable: true, get: function () { return versionChecker_1.checkForUpdates; } });
 Object.defineProperty(exports, "isVersionCheckerError", { enumerable: true, get: function () { return versionChecker_1.isVersionCheckerError; } });
@@ -86,3 +84,6 @@ Object.defineProperty(exports, "itemMatchesAnyFilter", { enumerable: true, get:
 Object.defineProperty(exports, "shouldPreserveItem", { enumerable: true, get: function () { return arrayMerger_1.shouldPreserveItem; } });
 var commentOnlyDetector_1 = require("./commentOnlyDetector");
 Object.defineProperty(exports, "isCommentOnlyContent", { enumerable: true, get: function () { return commentOnlyDetector_1.isCommentOnlyContent; } });
+var fileFilter_1 = require("./fileFilter");
+Object.defineProperty(exports, "filterFileMap", { enumerable: true, get: function () { return fileFilter_1.filterFileMap; } });
+Object.defineProperty(exports, "filterFileMaps", { enumerable: true, get: function () { return fileFilter_1.filterFileMaps; } });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "helm-env-delta",
-  "version": "1.9.3",
+  "version": "1.10.0",
   "description": "HelmEnvDelta – environment-aware YAML delta and sync for GitOps",
   "author": "BCsabaEngine",
   "license": "ISC",
@@ -68,7 +68,7 @@
   },
   "devDependencies": {
     "@types/hogan.js": "^3.0.5",
-    "@types/node": "^25.0.10",
+    "@types/node": "^25.1.0",
     "@types/picomatch": "^4.0.2",
     "@typescript-eslint/eslint-plugin": "^8.54.0",
     "@typescript-eslint/parser": "^8.54.0",

package/dist/utils/arrayDiffProcessor.d.ts

@@ -1,14 +0,0 @@
-import { ChangedFile } from '../fileDiff';
-export interface ArrayChange {
-    path: string[];
-    added: unknown[];
-    removed: unknown[];
-    unchanged: unknown[];
-}
-export interface ArrayChangeInfo {
-    hasArrays: boolean;
-    hasChanges: boolean;
-    arrayPaths: string[][];
-    changes: ArrayChange[];
-}
-export declare const detectArrayChanges: (file: ChangedFile) => ArrayChangeInfo;

package/dist/utils/arrayDiffProcessor.js

@@ -1,43 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.detectArrayChanges = void 0;
-const arrayDiffer_1 = require("../arrayDiffer");
-const deepEqual_1 = require("./deepEqual");
-const jsonPath_1 = require("./jsonPath");
-const serialization_1 = require("./serialization");
-const detectArrayChanges = (file) => {
-    const hasArraysInFile = (0, arrayDiffer_1.hasArrays)(file.rawParsedSource) || (0, arrayDiffer_1.hasArrays)(file.rawParsedDest);
-    if (!hasArraysInFile)
-        return {
-            hasArrays: false,
-            hasChanges: false,
-            arrayPaths: [],
-            changes: []
-        };
-    const arrayPaths = (0, arrayDiffer_1.findArrayPaths)(file.rawParsedSource);
-    const changes = [];
-    for (const path of arrayPaths) {
-        const sourceArray = (0, jsonPath_1.getValueAtPath)(file.rawParsedSource, path);
-        const destinationArray = (0, jsonPath_1.getValueAtPath)(file.rawParsedDest, path);
-        if (!Array.isArray(sourceArray) || !Array.isArray(destinationArray))
-            continue;
-        const normalizedSource = (0, serialization_1.normalizeForComparison)(sourceArray);
-        const normalizedDestination = (0, serialization_1.normalizeForComparison)(destinationArray);
-        if ((0, deepEqual_1.deepEqual)(normalizedSource, normalizedDestination))
-            continue;
-        const diff = (0, arrayDiffer_1.diffArrays)(normalizedSource, normalizedDestination);
-        changes.push({
-            path,
-            added: diff.added,
-            removed: diff.removed,
-            unchanged: diff.unchanged
-        });
-    }
-    return {
-        hasArrays: true,
-        hasChanges: changes.length > 0,
-        arrayPaths,
-        changes
-    };
-};
-exports.detectArrayChanges = detectArrayChanges;