helm-env-delta 1.12.0 → 1.13.1

package/README.md

@@ -226,6 +226,14 @@ outputFormat:
 
 The repository includes ready-to-run examples:
 
+### 🟢 Example 0: Basic
+
+The simplest possible setup — syncs changes from UAT to Production while preserving environment-specific values.
+
+```bash
+helm-env-delta --config example/0-basic/config.yaml --dry-run --diff
+```
+
 ### 📁 Example 1: Config Inheritance
 
 Shows how to reuse base configuration across multiple environment pairs.
@@ -236,7 +244,7 @@ helm-env-delta --config example/1-config-inheritance/config.uat-to-prod.yaml --d
 
 ### 🚦 Example 2: Stop Rules
 
-Demonstrates all 5 stop rule types and how violations block execution.
+Demonstrates all 7 stop rule types and how violations block execution.
 
 ```bash
 helm-env-delta --config example/2-stop-rules/config.yaml --dry-run --diff
@@ -331,7 +339,7 @@ helm-env-delta --config config.yaml --suggest --suggest-threshold 0.7
 - 🎯 Suggests transform patterns (regex find/replace) based on semantic patterns
 - 🛡️ Recommends stop rules for safety validation using pattern recognition
 - 📊 Provides confidence scores and occurrence counts for each suggestion
-- 🎛️ **NEW:** Configurable threshold filters suggestions by confidence level (0-1)
+- 🎛️ Configurable threshold filters suggestions by confidence level (0-1)
 - 📝 Outputs copy-paste ready YAML configuration
 - ✨ **Enhanced noise filtering:**
   - Ignores UUIDs, timestamps, single-character changes
@@ -413,10 +421,13 @@ exclude: # Optional: Exclude patterns
 
 prune: false # Optional: Delete dest files not in source
 confirmationDelay: 3000 # Optional: Delay in ms before sync (default: 3000, 0 to disable)
+requiredVersion: '1.10.0' # Optional: Minimum tool version required to process this config
 ```
 
 **Note:** Source and destination paths cannot resolve to the same folder.
 
+**`requiredVersion`:** When set, the CLI checks that the installed version of helm-env-delta meets this minimum. If the installed version is older, the CLI exits immediately with a clear upgrade message. This prevents running configs that depend on newer features with an outdated tool version. Supports `"1.2.3"` or `"v1.2.3"` format.
+
 ---
 
 ### 🔒 Path Filtering (skipPath)
@@ -624,7 +635,7 @@ stopRules:
       path: 'image.tag'
       regex: '^v0\.'
 
-    # NEW: Regex without path (global - scans all values)
+    # Regex without path (global - scans all values)
     - type: 'regex'
       regex: '^127\.' # Block localhost IPs anywhere
 ```
@@ -777,7 +788,7 @@ stopRules: # Add production safety rules
 
 **Merging:**
 
-- Primitives (`source`, `destination`, `prune`, `confirmationDelay`): Child overrides parent
+- Primitives (`source`, `destination`, `prune`, `confirmationDelay`, `requiredVersion`): Child overrides parent
 - Arrays (`include`, `exclude`): Concatenated (parent + child)
 - Per-file Records (`skipPath`, `transforms`, `stopRules`, `fixedValues`): Keys merged, arrays concatenated
 - `outputFormat`: Shallow merged (child fields override parent)
@@ -951,7 +962,7 @@ git push origin main
 
 ✅ **Flexibility** - Per-file patterns. Config inheritance. Regex transforms.
 
-✅ **Reliability** - 1150+ tests, 84% coverage. Battle-tested.
+✅ **Reliability** - 1400+ tests, 92% coverage. Battle-tested.
 
 ---
 

package/dist/{configFile.d.ts → config/configFile.d.ts}

@@ -102,6 +102,7 @@ declare const transformRulesSchema: z.ZodObject<{
 }, z.core.$strip>;
 declare const baseConfigSchema: z.ZodObject<{
     extends: z.ZodOptional<z.ZodString>;
+    requiredVersion: z.ZodOptional<z.ZodString>;
     source: z.ZodOptional<z.ZodString>;
     destination: z.ZodOptional<z.ZodString>;
     include: z.ZodOptional<z.ZodArray<z.ZodString>>;
@@ -188,6 +189,7 @@ declare const finalConfigSchema: z.ZodObject<{
         contentFile: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>>;
         filenameFile: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>>;
     }, z.core.$strip>>>;
+    requiredVersion: z.ZodOptional<z.ZodString>;
     source: z.ZodNonOptional<z.ZodOptional<z.ZodString>>;
     destination: z.ZodNonOptional<z.ZodOptional<z.ZodString>>;
     skipPath: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString>>>;
@@ -262,6 +264,7 @@ declare const formatOnlyConfigSchema: z.ZodObject<{
         contentFile: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>>;
         filenameFile: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>>;
     }, z.core.$strip>>>;
+    requiredVersion: z.ZodOptional<z.ZodString>;
     source: z.ZodOptional<z.ZodString>;
     destination: z.ZodNonOptional<z.ZodOptional<z.ZodString>>;
     skipPath: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString>>>;

package/dist/{configFile.js → config/configFile.js}

@@ -116,6 +116,13 @@ const transformRulesSchema = zod_1.z
 });
 const baseConfigSchema = zod_1.z.object({
     extends: zod_1.z.string().min(1).optional(),
+    requiredVersion: zod_1.z
+        .string()
+        .min(1)
+        .regex(/^v?(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)$/, {
+        message: 'Must be a valid semver version (e.g., "1.2.3" or "v1.2.3")'
+    })
+        .optional(),
     source: zod_1.z.string().min(1).optional(),
     destination: zod_1.z.string().min(1).optional(),
     include: zod_1.z.array(zod_1.z.string().min(1)).optional(),

package/dist/config/configLoader.d.ts

@@ -0,0 +1,25 @@
+import { type FinalConfig, type FormatOnlyConfig } from './configFile';
+declare const ConfigLoaderErrorClass: {
+    new (message: string, options?: import("../utils").ErrorOptions): {
+        [key: string]: unknown;
+        readonly code?: string;
+        readonly path?: string;
+        readonly cause?: Error;
+        readonly hints?: string[];
+        name: string;
+        message: string;
+        stack?: string;
+    };
+    captureStackTrace(targetObject: object, constructorOpt?: Function): void;
+    prepareStackTrace(err: Error, stackTraces: NodeJS.CallSite[]): any;
+    stackTraceLimit: number;
+};
+export declare class ConfigLoaderError extends ConfigLoaderErrorClass {
+}
+export declare const isConfigLoaderError: (error: unknown) => error is ConfigLoaderError;
+export type Config = FinalConfig;
+export type LoadConfigOptions = {
+    formatOnly?: boolean;
+};
+export declare const loadConfigFile: (configPath: string, quiet?: boolean, logger?: import("../logger").Logger, options?: LoadConfigOptions) => FinalConfig | FormatOnlyConfig;
+export {};

package/dist/{configLoader.js → config/configLoader.js}

@@ -3,11 +3,36 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.loadConfigFile = void 0;
+exports.loadConfigFile = exports.isConfigLoaderError = exports.ConfigLoaderError = void 0;
 const node_path_1 = __importDefault(require("node:path"));
+const package_json_1 = __importDefault(require("../../package.json"));
+const utils_1 = require("../utils");
 const configFile_1 = require("./configFile");
 const configMerger_1 = require("./configMerger");
-const utils_1 = require("./utils");
+const ConfigLoaderErrorClass = (0, utils_1.createErrorClass)('Config Loader Error', {
+    VERSION_REQUIREMENT: 'Installed version does not meet the required version'
+}, (message, options) => {
+    let fullMessage = `Config Loader Error: ${message}`;
+    if (options['requiredVersion'])
+        fullMessage += `\n  Required version: ${options['requiredVersion']}`;
+    if (options['currentVersion'])
+        fullMessage += `\n  Current version: ${options['currentVersion']}`;
+    fullMessage += '\n\n  Hint: Run "npm install" to update helm-env-delta to the required version.';
+    return fullMessage;
+});
+class ConfigLoaderError extends ConfigLoaderErrorClass {
+}
+exports.ConfigLoaderError = ConfigLoaderError;
+exports.isConfigLoaderError = (0, utils_1.createErrorTypeGuard)(ConfigLoaderError);
+const checkRequiredVersion = (requiredVersion) => {
+    const currentVersion = package_json_1.default.version;
+    if ((0, utils_1.isNewerVersion)(currentVersion, requiredVersion))
+        throw new ConfigLoaderError(`This config requires helm-env-delta v${requiredVersion} or newer`, {
+            code: 'VERSION_REQUIREMENT',
+            requiredVersion,
+            currentVersion
+        });
+};
 const expandTransformFiles = (config, configDirectory) => {
     if (!config.transforms)
         return config;
@@ -34,6 +59,8 @@ const loadConfigFile = (configPath, quiet = false, logger, options = {}) => {
     const configDirectory = node_path_1.default.dirname(node_path_1.default.resolve(configPath));
     const mergedConfig = (0, configMerger_1.resolveConfigWithExtends)(configPath, new Set(), 0, logger);
     const expandedConfig = expandTransformFiles(mergedConfig, configDirectory);
+    if (expandedConfig.requiredVersion)
+        checkRequiredVersion(expandedConfig.requiredVersion);
     const config = options.formatOnly
         ? (0, configFile_1.parseFormatOnlyConfig)(expandedConfig, configPath)
         : (0, configFile_1.parseFinalConfig)(expandedConfig, configPath);

package/dist/{configMerger.d.ts → config/configMerger.d.ts}

@@ -1,6 +1,6 @@
 import { type BaseConfig } from './configFile';
 declare const ConfigMergerErrorClass: {
-    new (message: string, options?: import("./utils/errors").ErrorOptions): {
+    new (message: string, options?: import("../utils/errors").ErrorOptions): {
         [key: string]: unknown;
         readonly code?: string;
         readonly path?: string;
@@ -18,5 +18,5 @@ export declare class ConfigMergerError extends ConfigMergerErrorClass {
 }
 export declare const isConfigMergerError: (error: unknown) => error is ConfigMergerError;
 export declare const mergeConfigs: (parent: BaseConfig, child: BaseConfig) => BaseConfig;
-export declare const resolveConfigWithExtends: (configPath: string, visited?: Set<string>, depth?: number, logger?: import("./logger").Logger) => BaseConfig;
+export declare const resolveConfigWithExtends: (configPath: string, visited?: Set<string>, depth?: number, logger?: import("../logger").Logger) => BaseConfig;
 export {};

package/dist/{configMerger.js → config/configMerger.js}

@@ -40,9 +40,9 @@ exports.resolveConfigWithExtends = exports.mergeConfigs = exports.isConfigMerger
 const node_fs_1 = require("node:fs");
 const node_path_1 = __importDefault(require("node:path"));
 const YAML = __importStar(require("yaml"));
+const constants_1 = require("../constants");
+const errors_1 = require("../utils/errors");
 const configFile_1 = require("./configFile");
-const constants_1 = require("./constants");
-const errors_1 = require("./utils/errors");
 const ConfigMergerErrorClass = (0, errors_1.createErrorClass)('Config Merger Error', {
     CIRCULAR_DEPENDENCY: 'Circular dependency detected in extends chain',
     MAX_DEPTH_EXCEEDED: 'Extends chain exceeds maximum depth',
@@ -88,6 +88,10 @@ const mergeConfigs = (parent, child) => {
         merged.confirmationDelay = child.confirmationDelay;
     else if (parent.confirmationDelay !== undefined)
         merged.confirmationDelay = parent.confirmationDelay;
+    if (child.requiredVersion !== undefined)
+        merged.requiredVersion = child.requiredVersion;
+    else if (parent.requiredVersion !== undefined)
+        merged.requiredVersion = parent.requiredVersion;
     const parentInclude = parent.include ?? [];
     const childInclude = child.include ?? [];
     if (parentInclude.length > 0 || childInclude.length > 0)

package/dist/config/index.d.ts

@@ -0,0 +1,8 @@
+export { isZodValidationError, ZodValidationError } from './ZodError';
+export type { ArraySortRule, BaseConfig, Config, FinalConfig, FixedValueConfig, FixedValueRule, FormatOnlyConfig, KeySortRule, NumericRule, OutputFormat, RegexFileKeyRule, RegexFileRule, RegexRule, SemverDowngradeRule, SemverMajorUpgradeRule, StopRule, TransformConfig, TransformRule, TransformRules, VersionFormatRule } from './configFile';
+export { ConfigValidationError, isConfigValidationError, parseBaseConfig, parseConfig, parseFinalConfig, parseFormatOnlyConfig } from './configFile';
+export type { LoadConfigOptions } from './configLoader';
+export { ConfigLoaderError, isConfigLoaderError, loadConfigFile } from './configLoader';
+export { ConfigMergerError, isConfigMergerError, mergeConfigs, resolveConfigWithExtends } from './configMerger';
+export type { WarningResult } from './configWarnings';
+export { validateConfigWarnings } from './configWarnings';

package/dist/config/index.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateConfigWarnings = exports.resolveConfigWithExtends = exports.mergeConfigs = exports.isConfigMergerError = exports.ConfigMergerError = exports.loadConfigFile = exports.isConfigLoaderError = exports.ConfigLoaderError = exports.parseFormatOnlyConfig = exports.parseFinalConfig = exports.parseConfig = exports.parseBaseConfig = exports.isConfigValidationError = exports.ConfigValidationError = exports.ZodValidationError = exports.isZodValidationError = void 0;
+var ZodError_1 = require("./ZodError");
+Object.defineProperty(exports, "isZodValidationError", { enumerable: true, get: function () { return ZodError_1.isZodValidationError; } });
+Object.defineProperty(exports, "ZodValidationError", { enumerable: true, get: function () { return ZodError_1.ZodValidationError; } });
+var configFile_1 = require("./configFile");
+Object.defineProperty(exports, "ConfigValidationError", { enumerable: true, get: function () { return configFile_1.ConfigValidationError; } });
+Object.defineProperty(exports, "isConfigValidationError", { enumerable: true, get: function () { return configFile_1.isConfigValidationError; } });
+Object.defineProperty(exports, "parseBaseConfig", { enumerable: true, get: function () { return configFile_1.parseBaseConfig; } });
+Object.defineProperty(exports, "parseConfig", { enumerable: true, get: function () { return configFile_1.parseConfig; } });
+Object.defineProperty(exports, "parseFinalConfig", { enumerable: true, get: function () { return configFile_1.parseFinalConfig; } });
+Object.defineProperty(exports, "parseFormatOnlyConfig", { enumerable: true, get: function () { return configFile_1.parseFormatOnlyConfig; } });
+var configLoader_1 = require("./configLoader");
+Object.defineProperty(exports, "ConfigLoaderError", { enumerable: true, get: function () { return configLoader_1.ConfigLoaderError; } });
+Object.defineProperty(exports, "isConfigLoaderError", { enumerable: true, get: function () { return configLoader_1.isConfigLoaderError; } });
+Object.defineProperty(exports, "loadConfigFile", { enumerable: true, get: function () { return configLoader_1.loadConfigFile; } });
+var configMerger_1 = require("./configMerger");
+Object.defineProperty(exports, "ConfigMergerError", { enumerable: true, get: function () { return configMerger_1.ConfigMergerError; } });
+Object.defineProperty(exports, "isConfigMergerError", { enumerable: true, get: function () { return configMerger_1.isConfigMergerError; } });
+Object.defineProperty(exports, "mergeConfigs", { enumerable: true, get: function () { return configMerger_1.mergeConfigs; } });
+Object.defineProperty(exports, "resolveConfigWithExtends", { enumerable: true, get: function () { return configMerger_1.resolveConfigWithExtends; } });
+var configWarnings_1 = require("./configWarnings");
+Object.defineProperty(exports, "validateConfigWarnings", { enumerable: true, get: function () { return configWarnings_1.validateConfigWarnings; } });

package/dist/consoleFormatter.d.ts

@@ -1,4 +1,4 @@
-import { StopRuleViolation } from './stopRulesValidator';
+import { StopRuleViolation } from './pipeline/stopRulesValidator';
 export type BoxStyle = 'success' | 'warning' | 'error' | 'info';
 export type ProgressStyle = 'loading' | 'success' | 'info';
 export type ViolationMode = 'error' | 'warning' | 'force';

package/dist/index.js

@@ -44,19 +44,11 @@ const chalk_1 = __importDefault(require("chalk"));
 const YAML = __importStar(require("yaml"));
 const package_json_1 = __importDefault(require("../package.json"));
 const commandLine_1 = require("./commandLine");
-const configLoader_1 = require("./configLoader");
-const configMerger_1 = require("./configMerger");
-const configWarnings_1 = require("./configWarnings");
-const consoleDiffReporter_1 = require("./consoleDiffReporter");
+const config_1 = require("./config");
 const consoleFormatter_1 = require("./consoleFormatter");
-const fileDiff_1 = require("./fileDiff");
-const fileLoader_1 = require("./fileLoader");
-const fileUpdater_1 = require("./fileUpdater");
-const htmlReporter_1 = require("./htmlReporter");
-const jsonReporter_1 = require("./jsonReporter");
 const logger_1 = require("./logger");
-const patternUsageValidator_1 = require("./patternUsageValidator");
-const stopRulesValidator_1 = require("./stopRulesValidator");
+const pipeline_1 = require("./pipeline");
+const reporters_1 = require("./reporters");
 const suggestionEngine_1 = require("./suggestionEngine");
 const collisionDetector_1 = require("./utils/collisionDetector");
 const commentOnlyDetector_1 = require("./utils/commentOnlyDetector");
@@ -64,8 +56,6 @@ const fileFilter_1 = require("./utils/fileFilter");
 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)();
     if (command.noColor)
@@ -86,7 +76,7 @@ const main = async () => {
         (0, node_fs_1.mkdirSync)(configDirectory, { recursive: true });
         (0, node_fs_1.writeFileSync)(firstRunMarker, new Date().toISOString());
     }
-    const config = (0, configLoader_1.loadConfigFile)(command.config, command.quiet, logger, { formatOnly: command.formatOnly });
+    const config = (0, config_1.loadConfigFile)(command.config, command.quiet, logger, { formatOnly: command.formatOnly });
     if (command.showConfig) {
         console.log(chalk_1.default.cyan('\n⚙️  Resolved Configuration:\n'));
         console.log(YAML.stringify(config, { indent: 2 }));
@@ -99,7 +89,7 @@ const main = async () => {
         }
         const validationConfig = config;
         logger.log('\n' + (0, consoleFormatter_1.formatProgressMessage)('Validating configuration...', 'info'));
-        const warningResult = (0, configWarnings_1.validateConfigWarnings)(validationConfig);
+        const warningResult = (0, config_1.validateConfigWarnings)(validationConfig);
         let hasAnyWarnings = warningResult.hasWarnings;
         if (warningResult.hasWarnings) {
             console.warn(chalk_1.default.yellow('\n⚠️  Configuration Warnings (non-fatal):\n'));
@@ -107,7 +97,7 @@ const main = async () => {
                 console.warn(chalk_1.default.yellow(`  • ${warning}`));
         }
         logger.log('\n' + (0, consoleFormatter_1.formatProgressMessage)('Loading files for validation...', 'loading'));
-        const sourceResult = await (0, fileLoader_1.loadFiles)({
+        const sourceResult = await (0, pipeline_1.loadFiles)({
             baseDirectory: validationConfig.source,
             include: validationConfig.include,
             exclude: validationConfig.exclude,
@@ -115,7 +105,7 @@ const main = async () => {
             skipExclude: true
         }, logger);
         let sourceFiles = sourceResult.fileMap;
-        const destinationResult = await (0, fileLoader_1.loadFiles)({
+        const destinationResult = await (0, pipeline_1.loadFiles)({
             baseDirectory: validationConfig.destination,
             include: validationConfig.include,
             exclude: validationConfig.exclude,
@@ -129,7 +119,7 @@ const main = async () => {
         }
         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);
+        const usageResult = (0, pipeline_1.validatePatternUsage)(validationConfig, sourceFiles, destinationFiles);
         hasAnyWarnings = hasAnyWarnings || usageResult.hasWarnings;
         if (usageResult.hasWarnings) {
             console.warn(chalk_1.default.yellow('\n⚠️  Pattern Usage Warnings (non-fatal):\n'));
@@ -160,7 +150,7 @@ const main = async () => {
             return;
         }
         logger.log('\n' + (0, consoleFormatter_1.formatProgressMessage)('Loading destination files...', 'loading'));
-        const destinationResult = await (0, fileLoader_1.loadFiles)({
+        const destinationResult = await (0, pipeline_1.loadFiles)({
             baseDirectory: config.destination,
             include: config.include,
             exclude: config.exclude
@@ -186,7 +176,7 @@ const main = async () => {
             if ((0, commentOnlyDetector_1.isCommentOnlyContent)(content))
                 continue;
             try {
-                const formatted = (0, yamlFormatter_1.formatYaml)(content, relativePath, config.outputFormat);
+                const formatted = (0, pipeline_1.formatYaml)(content, relativePath, config.outputFormat);
                 if (formatted !== content) {
                     const absolutePath = node_path_1.default.join(config.destination, relativePath);
                     if (command.dryRun)
@@ -220,7 +210,7 @@ const main = async () => {
     }
     const syncConfig = config;
     logger.log('\n' + (0, consoleFormatter_1.formatProgressMessage)('Loading files...', 'loading'));
-    const sourceResult = await (0, fileLoader_1.loadFiles)({
+    const sourceResult = await (0, pipeline_1.loadFiles)({
         baseDirectory: syncConfig.source,
         include: syncConfig.include,
         exclude: syncConfig.exclude,
@@ -234,7 +224,7 @@ const main = async () => {
         (0, collisionDetector_1.validateNoCollisions)(collisions);
     if (logger.shouldShow('debug'))
         logger.debug('Filename collision check: passed');
-    const destinationResult = await (0, fileLoader_1.loadFiles)({
+    const destinationResult = await (0, pipeline_1.loadFiles)({
         baseDirectory: syncConfig.destination,
         include: syncConfig.include,
         exclude: syncConfig.exclude
@@ -260,12 +250,12 @@ const main = async () => {
         return;
     }
     logger.log('\n' + (0, consoleFormatter_1.formatProgressMessage)('Computing differences...', 'info'));
-    const rawDiffResult = (0, fileDiff_1.computeFileDiff)(sourceFiles, destinationFiles, syncConfig, logger, originalPaths);
+    const rawDiffResult = (0, pipeline_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)
-        (0, consoleDiffReporter_1.showConsoleDiff)(diffResult, syncConfig);
+        (0, reporters_1.showConsoleDiff)(diffResult, syncConfig);
     else {
         logger.log(`  New files: ${diffResult.addedFiles.length}`);
         logger.log(`  Deleted files: ${diffResult.deletedFiles.length}`);
@@ -296,7 +286,7 @@ const main = async () => {
         }
     }
     const configFileDirectory = node_path_1.default.dirname(node_path_1.default.resolve(command.config));
-    const validationResult = (0, stopRulesValidator_1.validateStopRules)(diffResult, syncConfig.stopRules, configFileDirectory, logger);
+    const validationResult = (0, pipeline_1.validateStopRules)(diffResult, syncConfig.stopRules, configFileDirectory, logger);
     if (validationResult.violations.length > 0)
         if (command.force)
             for (const violation of validationResult.violations)
@@ -324,34 +314,36 @@ const main = async () => {
         if (syncConfig.confirmationDelay > 0)
             await new Promise((resolve) => setTimeout(resolve, syncConfig.confirmationDelay));
     }
-    const formattedFiles = await (0, fileUpdater_1.updateFiles)(diffResult, sourceFiles, destinationFiles, syncConfig, command.dryRun, command.skipFormat, logger);
+    const formattedFiles = await (0, pipeline_1.updateFiles)(diffResult, sourceFiles, destinationFiles, syncConfig, command.dryRun, command.skipFormat, logger);
     if (command.diffHtml && !command.quiet)
-        await (0, htmlReporter_1.generateHtmlReport)(diffResult, formattedFiles, syncConfig, command.dryRun, logger, command.dryRun ? validationResult : undefined);
+        await (0, reporters_1.generateHtmlReport)(diffResult, formattedFiles, syncConfig, command.dryRun, logger, command.dryRun ? validationResult : undefined);
     if (command.diffJson)
-        (0, jsonReporter_1.generateJsonReport)(diffResult, formattedFiles, validationResult, syncConfig, command.dryRun, package_json_1.default.version);
+        (0, reporters_1.generateJsonReport)(diffResult, formattedFiles, validationResult, syncConfig, command.dryRun, package_json_1.default.version);
 };
 (async () => {
     try {
         await main();
     }
     catch (error) {
-        if ((0, configMerger_1.isConfigMergerError)(error))
+        if ((0, config_1.isConfigMergerError)(error))
             console.error(error.message);
-        else if ((0, ZodError_1.isZodValidationError)(error))
+        else if ((0, config_1.isConfigLoaderError)(error))
             console.error(error.message);
-        else if ((0, fileLoader_1.isFileLoaderError)(error))
+        else if ((0, config_1.isZodValidationError)(error))
+            console.error(error.message);
+        else if ((0, pipeline_1.isFileLoaderError)(error))
             console.error(error.message);
         else if ((0, filenameTransformer_1.isFilenameTransformerError)(error))
             console.error(error.message);
         else if ((0, collisionDetector_1.isCollisionDetectorError)(error))
             console.error(error.message);
-        else if ((0, fileDiff_1.isFileDiffError)(error))
+        else if ((0, pipeline_1.isFileDiffError)(error))
             console.error(error.message);
-        else if ((0, fileUpdater_1.isFileUpdaterError)(error))
+        else if ((0, pipeline_1.isFileUpdaterError)(error))
             console.error(error.message);
-        else if ((0, htmlReporter_1.isHtmlReporterError)(error))
+        else if ((0, reporters_1.isHtmlReporterError)(error))
             console.error(error.message);
-        else if ((0, jsonReporter_1.isJsonReporterError)(error))
+        else if ((0, reporters_1.isJsonReporterError)(error))
             console.error(error.message);
         else if ((0, suggestionEngine_1.isSuggestionEngineError)(error))
             console.error(error.message);

package/dist/logger.d.ts

@@ -1,5 +1,5 @@
 import { FileOperation, ProgressStyle, ViolationMode } from './consoleFormatter';
-import { StopRuleViolation } from './stopRulesValidator';
+import { StopRuleViolation } from './pipeline/stopRulesValidator';
 export type VerbosityLevel = 'quiet' | 'normal' | 'verbose';
 export type OutputCategory = 'critical' | 'normal' | 'debug' | 'special';
 export type LoggerOptions = {

package/dist/{fileDiff.d.ts → pipeline/fileDiff.d.ts}

@@ -1,4 +1,4 @@
-import { Config, FixedValueConfig, TransformConfig } from './configFile';
+import { Config, FixedValueConfig, TransformConfig } from '../config';
 import { FileMap } from './fileLoader';
 export interface FileDiffResult {
     addedFiles: AddedFile[];
@@ -36,7 +36,7 @@ export interface ProcessYamlOptions {
     fixedValues?: FixedValueConfig;
 }
 declare const FileDiffErrorClass: {
-    new (message: string, options?: import("./utils/errors").ErrorOptions): {
+    new (message: string, options?: import("../utils/errors").ErrorOptions): {
         [key: string]: unknown;
         readonly code?: string;
         readonly path?: string;
@@ -54,5 +54,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, originalPaths?: Map<string, string>) => 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 → pipeline/fileDiff.js}

@@ -5,15 +5,15 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.computeFileDiff = exports.getSkipPathsForFile = exports.isFileDiffError = exports.FileDiffError = void 0;
 const yaml_1 = __importDefault(require("yaml"));
-const commentOnlyDetector_1 = require("./utils/commentOnlyDetector");
-const deepEqual_1 = require("./utils/deepEqual");
-const errors_1 = require("./utils/errors");
-const fileType_1 = require("./utils/fileType");
-const fixedValues_1 = require("./utils/fixedValues");
-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 commentOnlyDetector_1 = require("../utils/commentOnlyDetector");
+const deepEqual_1 = require("../utils/deepEqual");
+const errors_1 = require("../utils/errors");
+const fileType_1 = require("../utils/fileType");
+const fixedValues_1 = require("../utils/fixedValues");
+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'

package/dist/{fileLoader.d.ts → pipeline/fileLoader.d.ts}

@@ -1,4 +1,4 @@
-import type { TransformConfig } from './configFile';
+import type { TransformConfig } from '../config';
 export interface FileLoaderOptions {
     baseDirectory: string;
     include: string[];
@@ -12,7 +12,7 @@ export interface FileLoaderResult {
     originalPaths: Map<string, string>;
 }
 declare const FileLoaderErrorClass: {
-    new (message: string, options?: import("./utils/errors").ErrorOptions): {
+    new (message: string, options?: import("../utils/errors").ErrorOptions): {
         [key: string]: unknown;
         readonly code?: string;
         readonly path?: string;
@@ -29,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<FileLoaderResult>;
+export declare const loadFiles: (options: FileLoaderOptions, logger?: import("../logger").Logger) => Promise<FileLoaderResult>;
 export {};

package/dist/{fileLoader.js → pipeline/fileLoader.js}

@@ -7,9 +7,9 @@ exports.loadFiles = exports.isFileLoaderError = exports.FileLoaderError = void 0
 const promises_1 = require("node:fs/promises");
 const node_path_1 = __importDefault(require("node:path"));
 const tinyglobby_1 = require("tinyglobby");
-const errors_1 = require("./utils/errors");
-const filenameTransformer_1 = require("./utils/filenameTransformer");
-const patternMatcher_1 = require("./utils/patternMatcher");
+const errors_1 = require("../utils/errors");
+const filenameTransformer_1 = require("../utils/filenameTransformer");
+const patternMatcher_1 = require("../utils/patternMatcher");
 const FileLoaderErrorClass = (0, errors_1.createErrorClass)('File Loader Error', {
     ENOENT: 'File or directory not found',
     EACCES: 'Permission denied',

package/dist/{fileUpdater.d.ts → pipeline/fileUpdater.d.ts}

@@ -1,7 +1,7 @@
-import { Config } from './configFile';
+import { Config } from '../config';
+import { Logger } from '../logger';
 import { ChangedFile, FileDiffResult } from './fileDiff';
 import { FileMap } from './fileLoader';
-import { Logger } from './logger';
 export interface FileUpdateError {
     operation: 'add' | 'update' | 'delete';
     path: string;
@@ -25,7 +25,7 @@ export interface UpdateFileOptions {
     logger: Logger;
 }
 declare const FileUpdaterErrorClass: {
-    new (message: string, options?: import("./utils/errors").ErrorOptions): {
+    new (message: string, options?: import("../utils/errors").ErrorOptions): {
         [key: string]: unknown;
         readonly code?: string;
         readonly path?: string;

package/dist/{fileUpdater.js → pipeline/fileUpdater.js}

@@ -7,13 +7,13 @@ exports.updateFiles = exports.isFileUpdaterError = exports.FileUpdaterError = vo
 const promises_1 = require("node:fs/promises");
 const node_path_1 = __importDefault(require("node:path"));
 const yaml_1 = __importDefault(require("yaml"));
-const consoleFormatter_1 = require("./consoleFormatter");
-const arrayMerger_1 = require("./utils/arrayMerger");
-const commentOnlyDetector_1 = require("./utils/commentOnlyDetector");
-const errors_1 = require("./utils/errors");
-const fileType_1 = require("./utils/fileType");
-const fixedValues_1 = require("./utils/fixedValues");
-const transformer_1 = require("./utils/transformer");
+const consoleFormatter_1 = require("../consoleFormatter");
+const arrayMerger_1 = require("../utils/arrayMerger");
+const commentOnlyDetector_1 = require("../utils/commentOnlyDetector");
+const errors_1 = require("../utils/errors");
+const fileType_1 = require("../utils/fileType");
+const fixedValues_1 = require("../utils/fixedValues");
+const transformer_1 = require("../utils/transformer");
 const yamlFormatter_1 = require("./yamlFormatter");
 const FileUpdaterErrorClass = (0, errors_1.createErrorClass)('File Updater Error', {
     WRITE_FAILED: 'File write operation failed',

package/dist/pipeline/index.d.ts

@@ -0,0 +1,11 @@
+export type { FileLoaderOptions, FileLoaderResult, FileMap } from './fileLoader';
+export { FileLoaderError, isFileLoaderError, loadFiles } from './fileLoader';
+export type { AddedFile, ChangedFile, FileDiffResult, ProcessYamlOptions } from './fileDiff';
+export { computeFileDiff, FileDiffError, getSkipPathsForFile, isFileDiffError } from './fileDiff';
+export type { FileOperationOptions, FileUpdateError, UpdateFileOptions } from './fileUpdater';
+export { FileUpdaterError, isFileUpdaterError, updateFiles } from './fileUpdater';
+export { formatYaml, isYamlFormatterError, YamlFormatterError } from './yamlFormatter';
+export type { StopRuleViolation, ValidationContext, ValidationResult } from './stopRulesValidator';
+export { isStopRulesValidatorError, StopRulesValidatorError, validateStopRules } from './stopRulesValidator';
+export type { PatternUsageResult, PatternUsageWarning } from './patternUsageValidator';
+export { validatePatternUsage } from './patternUsageValidator';

package/dist/pipeline/index.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validatePatternUsage = exports.validateStopRules = exports.StopRulesValidatorError = exports.isStopRulesValidatorError = exports.YamlFormatterError = exports.isYamlFormatterError = exports.formatYaml = exports.updateFiles = exports.isFileUpdaterError = exports.FileUpdaterError = exports.isFileDiffError = exports.getSkipPathsForFile = exports.FileDiffError = exports.computeFileDiff = exports.loadFiles = exports.isFileLoaderError = exports.FileLoaderError = void 0;
+var fileLoader_1 = require("./fileLoader");
+Object.defineProperty(exports, "FileLoaderError", { enumerable: true, get: function () { return fileLoader_1.FileLoaderError; } });
+Object.defineProperty(exports, "isFileLoaderError", { enumerable: true, get: function () { return fileLoader_1.isFileLoaderError; } });
+Object.defineProperty(exports, "loadFiles", { enumerable: true, get: function () { return fileLoader_1.loadFiles; } });
+var fileDiff_1 = require("./fileDiff");
+Object.defineProperty(exports, "computeFileDiff", { enumerable: true, get: function () { return fileDiff_1.computeFileDiff; } });
+Object.defineProperty(exports, "FileDiffError", { enumerable: true, get: function () { return fileDiff_1.FileDiffError; } });
+Object.defineProperty(exports, "getSkipPathsForFile", { enumerable: true, get: function () { return fileDiff_1.getSkipPathsForFile; } });
+Object.defineProperty(exports, "isFileDiffError", { enumerable: true, get: function () { return fileDiff_1.isFileDiffError; } });
+var fileUpdater_1 = require("./fileUpdater");
+Object.defineProperty(exports, "FileUpdaterError", { enumerable: true, get: function () { return fileUpdater_1.FileUpdaterError; } });
+Object.defineProperty(exports, "isFileUpdaterError", { enumerable: true, get: function () { return fileUpdater_1.isFileUpdaterError; } });
+Object.defineProperty(exports, "updateFiles", { enumerable: true, get: function () { return fileUpdater_1.updateFiles; } });
+var yamlFormatter_1 = require("./yamlFormatter");
+Object.defineProperty(exports, "formatYaml", { enumerable: true, get: function () { return yamlFormatter_1.formatYaml; } });
+Object.defineProperty(exports, "isYamlFormatterError", { enumerable: true, get: function () { return yamlFormatter_1.isYamlFormatterError; } });
+Object.defineProperty(exports, "YamlFormatterError", { enumerable: true, get: function () { return yamlFormatter_1.YamlFormatterError; } });
+var stopRulesValidator_1 = require("./stopRulesValidator");
+Object.defineProperty(exports, "isStopRulesValidatorError", { enumerable: true, get: function () { return stopRulesValidator_1.isStopRulesValidatorError; } });
+Object.defineProperty(exports, "StopRulesValidatorError", { enumerable: true, get: function () { return stopRulesValidator_1.StopRulesValidatorError; } });
+Object.defineProperty(exports, "validateStopRules", { enumerable: true, get: function () { return stopRulesValidator_1.validateStopRules; } });
+var patternUsageValidator_1 = require("./patternUsageValidator");
+Object.defineProperty(exports, "validatePatternUsage", { enumerable: true, get: function () { return patternUsageValidator_1.validatePatternUsage; } });

package/dist/{patternUsageValidator.d.ts → pipeline/patternUsageValidator.d.ts}

@@ -1,4 +1,4 @@
-import type { FinalConfig } from './configFile';
+import type { FinalConfig } from '../config';
 import type { FileMap } from './fileLoader';
 export interface PatternUsageResult {
     warnings: PatternUsageWarning[];

package/dist/{patternUsageValidator.js → pipeline/patternUsageValidator.js}

@@ -5,8 +5,8 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.validatePatternUsage = void 0;
 const yaml_1 = __importDefault(require("yaml"));
-const jsonPath_1 = require("./utils/jsonPath");
-const patternMatcher_1 = require("./utils/patternMatcher");
+const jsonPath_1 = require("../utils/jsonPath");
+const patternMatcher_1 = require("../utils/patternMatcher");
 const validatePatternUsage = (config, sourceFiles, destinationFiles) => {
     const warnings = [
         ...validateExcludePatterns(config, sourceFiles, destinationFiles),

package/dist/{stopRulesValidator.d.ts → pipeline/stopRulesValidator.d.ts}

@@ -1,7 +1,7 @@
-import type { StopRule } from './configFile';
+import type { StopRule } from '../config';
 import type { FileDiffResult } from './fileDiff';
 declare const StopRulesValidatorErrorClass: {
-    new (message: string, options?: import("./utils").ErrorOptions): {
+    new (message: string, options?: import("../utils").ErrorOptions): {
         [key: string]: unknown;
         readonly code?: string;
         readonly path?: string;
@@ -37,5 +37,5 @@ export interface ValidationContext {
     filePath: string;
     configDirectory?: string;
 }
-export declare const validateStopRules: (diffResult: FileDiffResult, stopRulesConfig?: Record<string, StopRule[]>, configDirectory?: string, logger?: import("./logger").Logger) => ValidationResult;
+export declare const validateStopRules: (diffResult: FileDiffResult, stopRulesConfig?: Record<string, StopRule[]>, configDirectory?: string, logger?: import("../logger").Logger) => ValidationResult;
 export {};

package/dist/{stopRulesValidator.js → pipeline/stopRulesValidator.js}

@@ -1,10 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.validateStopRules = exports.isStopRulesValidatorError = exports.StopRulesValidatorError = void 0;
-const utils_1 = require("./utils");
-const errors_1 = require("./utils/errors");
-const jsonPath_1 = require("./utils/jsonPath");
-const patternMatcher_1 = require("./utils/patternMatcher");
+const utils_1 = require("../utils");
+const errors_1 = require("../utils/errors");
+const jsonPath_1 = require("../utils/jsonPath");
+const patternMatcher_1 = require("../utils/patternMatcher");
 const StopRulesValidatorErrorClass = (0, errors_1.createErrorClass)('Stop Rules Validator Error', {}, (message, options) => {
     let fullMessage = `Stop Rules Validator Error: ${message}`;
     if (options.code)

package/dist/{yamlFormatter.d.ts → pipeline/yamlFormatter.d.ts}

@@ -1,6 +1,6 @@
-import { OutputFormat } from './configFile';
+import { OutputFormat } from '../config';
 export declare const YamlFormatterError: {
-    new (message: string, options?: import("./utils/errors").ErrorOptions): {
+    new (message: string, options?: import("../utils/errors").ErrorOptions): {
         [key: string]: unknown;
         readonly code?: string;
         readonly path?: string;

package/dist/{yamlFormatter.js → pipeline/yamlFormatter.js}

@@ -5,12 +5,12 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.formatYaml = exports.isYamlFormatterError = exports.YamlFormatterError = void 0;
 const yaml_1 = __importDefault(require("yaml"));
-const constants_1 = require("./constants");
-const commentOnlyDetector_1 = require("./utils/commentOnlyDetector");
-const errors_1 = require("./utils/errors");
-const jsonPath_1 = require("./utils/jsonPath");
-const patternMatcher_1 = require("./utils/patternMatcher");
-const yamlTypeGuards_1 = require("./utils/yamlTypeGuards");
+const constants_1 = require("../constants");
+const commentOnlyDetector_1 = require("../utils/commentOnlyDetector");
+const errors_1 = require("../utils/errors");
+const jsonPath_1 = require("../utils/jsonPath");
+const patternMatcher_1 = require("../utils/patternMatcher");
+const yamlTypeGuards_1 = require("../utils/yamlTypeGuards");
 exports.YamlFormatterError = (0, errors_1.createErrorClass)('YAML Formatter Error', {
     YAML_PARSE_ERROR: 'YAML file could not be parsed',
     YAML_FORMAT_ERROR: 'Failed to apply formatting',
@@ -343,7 +343,7 @@ const compareSortKeys = (a, b, order) => {
         return 1;
     if (b === undefined)
         return -1;
-    let result = 0;
+    let result;
     if (typeof a === 'string' && typeof b === 'string')
         result = a.toLowerCase().localeCompare(b.toLowerCase());
     else if (typeof a === 'number' && typeof b === 'number')

package/dist/{consoleDiffReporter.d.ts → reporters/consoleDiffReporter.d.ts}

@@ -1,3 +1,3 @@
-import { Config } from './configFile';
-import { FileDiffResult } from './fileDiff';
+import { Config } from '../config';
+import { FileDiffResult } from '../pipeline';
 export declare const showConsoleDiff: (diffResult: FileDiffResult, config: Config) => void;

package/dist/{consoleDiffReporter.js → reporters/consoleDiffReporter.js}

@@ -5,10 +5,10 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.showConsoleDiff = void 0;
 const chalk_1 = __importDefault(require("chalk"));
-const fileDiff_1 = require("./fileDiff");
-const diffGenerator_1 = require("./utils/diffGenerator");
-const fileType_1 = require("./utils/fileType");
-const serialization_1 = require("./utils/serialization");
+const pipeline_1 = require("../pipeline");
+const diffGenerator_1 = require("../utils/diffGenerator");
+const fileType_1 = require("../utils/fileType");
+const serialization_1 = require("../utils/serialization");
 const colorizeUnifiedDiff = (diff) => {
     return diff
         .split('\n')
@@ -40,7 +40,7 @@ const formatDeletedFiles = (files) => {
 const formatChangedFile = (file, config) => {
     const isYaml = (0, fileType_1.isYamlFile)(file.path);
     const separator = chalk_1.default.yellow('━'.repeat(60));
-    const skipPaths = (0, fileDiff_1.getSkipPathsForFile)(file.path, config.skipPath);
+    const skipPaths = (0, pipeline_1.getSkipPathsForFile)(file.path, config.skipPath);
     const skipPathInfo = skipPaths.length > 0
         ? chalk_1.default.dim(`SkipPath patterns applied: ${skipPaths.join(', ')}`)
         : chalk_1.default.dim('No skipPath patterns applied');

package/dist/{htmlReporter.d.ts → reporters/htmlReporter.d.ts}

@@ -1,9 +1,9 @@
-import { Config } from './configFile';
-import { FileDiffResult } from './fileDiff';
-import type { ValidationResult } from './stopRulesValidator';
-export type { DiffStats, ReportMetadata } from './reporters/htmlTemplate';
+import { Config } from '../config';
+import type { ValidationResult } from '../pipeline';
+import { FileDiffResult } from '../pipeline';
+export type { DiffStats, ReportMetadata } from './htmlTemplate';
 declare const HtmlReporterErrorClass: {
-    new (message: string, options?: import("./utils/errors").ErrorOptions): {
+    new (message: string, options?: import("../utils/errors").ErrorOptions): {
         [key: string]: unknown;
         readonly code?: string;
         readonly path?: string;
@@ -20,4 +20,4 @@ declare const HtmlReporterErrorClass: {
 export declare class HtmlReporterError extends HtmlReporterErrorClass {
 }
 export declare const isHtmlReporterError: (error: unknown) => error is HtmlReporterError;
-export declare const generateHtmlReport: (diffResult: FileDiffResult, formattedFiles: string[], config: Config, dryRun: boolean, logger?: import("./logger").Logger, validationResult?: ValidationResult) => Promise<void>;
+export declare const generateHtmlReport: (diffResult: FileDiffResult, formattedFiles: string[], config: Config, dryRun: boolean, logger?: import("../logger").Logger, validationResult?: ValidationResult) => Promise<void>;

package/dist/{htmlReporter.js → reporters/htmlReporter.js}

@@ -9,13 +9,13 @@ const promises_1 = require("node:fs/promises");
 const node_os_1 = require("node:os");
 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");
-const serialization_1 = require("./utils/serialization");
+const diffGenerator_1 = require("../utils/diffGenerator");
+const errors_1 = require("../utils/errors");
+const fileType_1 = require("../utils/fileType");
+const serialization_1 = require("../utils/serialization");
+const browserLauncher_1 = require("./browserLauncher");
+const htmlTemplate_1 = require("./htmlTemplate");
+const treeRenderer_1 = require("./treeRenderer");
 const HtmlReporterErrorClass = (0, errors_1.createErrorClass)('HTML Reporter Error', {
     WRITE_FAILED: 'Failed to write HTML report file',
     BROWSER_OPEN_FAILED: 'Failed to open report in browser',

package/dist/reporters/htmlTemplate.d.ts

@@ -1,4 +1,4 @@
-import { FileDiffResult } from '../fileDiff';
+import { FileDiffResult } from '../pipeline';
 export interface HtmlStopRuleViolation {
     file: string;
     rule: {

package/dist/reporters/index.d.ts

@@ -0,0 +1,14 @@
+export type { ArrayDiffResult } from './arrayDiffer';
+export { diffArrays, findArrayPaths, hasArrays } from './arrayDiffer';
+export { showConsoleDiff } from './consoleDiffReporter';
+export type { DiffStats, ReportMetadata } from './htmlReporter';
+export { generateHtmlReport, HtmlReporterError, isHtmlReporterError } from './htmlReporter';
+export type { AddedFileDetail, ChangedFileDetail, FieldChange, JsonReport, JsonReportFiles, JsonReportMetadata, JsonReportSummary, StopRuleViolationJson } from './jsonReporter';
+export { generateJsonReport, isJsonReporterError, JsonReporterError } from './jsonReporter';
+export type { HtmlStopRuleViolation } from './htmlTemplate';
+export { generateHtmlTemplate } from './htmlTemplate';
+export { DIFF2HTML_STYLES, HTML_STYLES, TAB_SCRIPT } from './htmlStyles';
+export type { TreeNode } from './treeBuilder';
+export { buildFileTree } from './treeBuilder';
+export { escapeHtml, renderSidebarTree, renderTreeview } from './treeRenderer';
+export { BrowserLauncherError, isBrowserLauncherError, openInBrowser } from './browserLauncher';

package/dist/reporters/index.js

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.openInBrowser = exports.isBrowserLauncherError = exports.BrowserLauncherError = exports.renderTreeview = exports.renderSidebarTree = exports.escapeHtml = exports.buildFileTree = exports.TAB_SCRIPT = exports.HTML_STYLES = exports.DIFF2HTML_STYLES = exports.generateHtmlTemplate = exports.JsonReporterError = exports.isJsonReporterError = exports.generateJsonReport = exports.isHtmlReporterError = exports.HtmlReporterError = exports.generateHtmlReport = exports.showConsoleDiff = exports.hasArrays = exports.findArrayPaths = exports.diffArrays = void 0;
+var arrayDiffer_1 = require("./arrayDiffer");
+Object.defineProperty(exports, "diffArrays", { enumerable: true, get: function () { return arrayDiffer_1.diffArrays; } });
+Object.defineProperty(exports, "findArrayPaths", { enumerable: true, get: function () { return arrayDiffer_1.findArrayPaths; } });
+Object.defineProperty(exports, "hasArrays", { enumerable: true, get: function () { return arrayDiffer_1.hasArrays; } });
+var consoleDiffReporter_1 = require("./consoleDiffReporter");
+Object.defineProperty(exports, "showConsoleDiff", { enumerable: true, get: function () { return consoleDiffReporter_1.showConsoleDiff; } });
+var htmlReporter_1 = require("./htmlReporter");
+Object.defineProperty(exports, "generateHtmlReport", { enumerable: true, get: function () { return htmlReporter_1.generateHtmlReport; } });
+Object.defineProperty(exports, "HtmlReporterError", { enumerable: true, get: function () { return htmlReporter_1.HtmlReporterError; } });
+Object.defineProperty(exports, "isHtmlReporterError", { enumerable: true, get: function () { return htmlReporter_1.isHtmlReporterError; } });
+var jsonReporter_1 = require("./jsonReporter");
+Object.defineProperty(exports, "generateJsonReport", { enumerable: true, get: function () { return jsonReporter_1.generateJsonReport; } });
+Object.defineProperty(exports, "isJsonReporterError", { enumerable: true, get: function () { return jsonReporter_1.isJsonReporterError; } });
+Object.defineProperty(exports, "JsonReporterError", { enumerable: true, get: function () { return jsonReporter_1.JsonReporterError; } });
+var htmlTemplate_1 = require("./htmlTemplate");
+Object.defineProperty(exports, "generateHtmlTemplate", { enumerable: true, get: function () { return htmlTemplate_1.generateHtmlTemplate; } });
+var htmlStyles_1 = require("./htmlStyles");
+Object.defineProperty(exports, "DIFF2HTML_STYLES", { enumerable: true, get: function () { return htmlStyles_1.DIFF2HTML_STYLES; } });
+Object.defineProperty(exports, "HTML_STYLES", { enumerable: true, get: function () { return htmlStyles_1.HTML_STYLES; } });
+Object.defineProperty(exports, "TAB_SCRIPT", { enumerable: true, get: function () { return htmlStyles_1.TAB_SCRIPT; } });
+var treeBuilder_1 = require("./treeBuilder");
+Object.defineProperty(exports, "buildFileTree", { enumerable: true, get: function () { return treeBuilder_1.buildFileTree; } });
+var treeRenderer_1 = require("./treeRenderer");
+Object.defineProperty(exports, "escapeHtml", { enumerable: true, get: function () { return treeRenderer_1.escapeHtml; } });
+Object.defineProperty(exports, "renderSidebarTree", { enumerable: true, get: function () { return treeRenderer_1.renderSidebarTree; } });
+Object.defineProperty(exports, "renderTreeview", { enumerable: true, get: function () { return treeRenderer_1.renderTreeview; } });
+var browserLauncher_1 = require("./browserLauncher");
+Object.defineProperty(exports, "BrowserLauncherError", { enumerable: true, get: function () { return browserLauncher_1.BrowserLauncherError; } });
+Object.defineProperty(exports, "isBrowserLauncherError", { enumerable: true, get: function () { return browserLauncher_1.isBrowserLauncherError; } });
+Object.defineProperty(exports, "openInBrowser", { enumerable: true, get: function () { return browserLauncher_1.openInBrowser; } });

package/dist/{jsonReporter.d.ts → reporters/jsonReporter.d.ts}

@@ -1,8 +1,7 @@
-import { Config } from './configFile';
-import { FileDiffResult } from './fileDiff';
-import { ValidationResult } from './stopRulesValidator';
+import { Config } from '../config';
+import { FileDiffResult, ValidationResult } from '../pipeline';
 declare const JsonReporterErrorClass: {
-    new (message: string, options?: import("./utils/errors").ErrorOptions): {
+    new (message: string, options?: import("../utils/errors").ErrorOptions): {
         [key: string]: unknown;
         readonly code?: string;
         readonly path?: string;

package/dist/{jsonReporter.js → reporters/jsonReporter.js}

@@ -1,9 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.generateJsonReport = exports.isJsonReporterError = exports.JsonReporterError = void 0;
-const deepEqual_1 = require("./utils/deepEqual");
-const diffGenerator_1 = require("./utils/diffGenerator");
-const errors_1 = require("./utils/errors");
+const deepEqual_1 = require("../utils/deepEqual");
+const diffGenerator_1 = require("../utils/diffGenerator");
+const errors_1 = require("../utils/errors");
 const JsonReporterErrorClass = (0, errors_1.createErrorClass)('JSON Reporter Error', {});
 class JsonReporterError extends JsonReporterErrorClass {
 }

package/dist/suggestionEngine.d.ts

@@ -1,5 +1,5 @@
-import { Config, StopRule } from './configFile';
-import { FileDiffResult } from './fileDiff';
+import { Config, StopRule } from './config';
+import { FileDiffResult } from './pipeline';
 export interface ValuePair {
     oldValue: string;
     targetValue: string;

package/dist/suggestionEngine.js

@@ -316,7 +316,7 @@ const shouldIgnoreValue = (oldValue, targetValue) => {
 const calculateTransformConfidence = (occurrence) => {
     const fileCount = occurrence.files.size;
     const occurrenceCount = occurrence.examples.length;
-    let confidence = 0;
+    let confidence;
     if (fileCount === 1)
         confidence =
             occurrenceCount >= suggestionConstants_1.FILTER_THRESHOLDS.MIN_SINGLE_FILE_OCCURRENCES

package/dist/utils/collisionDetector.d.ts

@@ -1,4 +1,4 @@
-import type { TransformConfig } from '../configFile';
+import type { TransformConfig } from '../config';
 declare const CollisionDetectorErrorClass: {
     new (message: string, options?: import("./errors").ErrorOptions): {
         [key: string]: unknown;

package/dist/utils/fileFilter.d.ts

@@ -1,5 +1,4 @@
-import type { FileDiffResult } from '../fileDiff';
-import type { FileMap } from '../fileLoader';
+import type { FileDiffResult, FileMap } from '../pipeline';
 export type ChangeMode = 'new' | 'modified' | 'deleted' | 'all';
 export type FilterLogicalOperator = 'AND' | 'OR' | 'NONE';
 export interface ParsedFilter {

package/dist/utils/filenameTransformer.d.ts

@@ -1,4 +1,4 @@
-import type { TransformConfig, TransformRule } from '../configFile';
+import type { TransformConfig, TransformRule } from '../config';
 export declare const FilenameTransformerError: {
     new (message: string, options?: import("./errors").ErrorOptions): {
         [key: string]: unknown;

package/dist/utils/fixedValues.d.ts

@@ -1,4 +1,4 @@
-import type { FixedValueConfig, FixedValueRule } from '../configFile';
+import type { FixedValueConfig, FixedValueRule } from '../config';
 export declare const getFixedValuesForFile: (filePath: string, fixedValues?: FixedValueConfig) => FixedValueRule[];
 export declare const setValueAtPath: (object: unknown, pathParts: string[], value: unknown) => boolean;
 export declare const applyFixedValues: (data: unknown, rules: FixedValueRule[]) => void;

package/dist/utils/index.d.ts

@@ -7,7 +7,8 @@ export { clearJsonPathCache, getValueAtPath, isFilterSegment, matchesFilter, par
 export { isYamlFile } from './fileType';
 export { globalMatcher, PatternMatcher } from './patternMatcher';
 export { generateUnifiedDiff } from './diffGenerator';
-export { checkForUpdates, isVersionCheckerError, VersionCheckerError } from './versionChecker';
+export type { SemverParts } from './versionChecker';
+export { checkForUpdates, isNewerVersion, isVersionCheckerError, parseVersion, VersionCheckerError } from './versionChecker';
 export { escapeRegex, isYamlFileLoaderError, loadYamlFile, YamlFileLoaderError } from './yamlFileLoader';
 export { isTransformFileLoaderError, loadTransformFile, loadTransformFiles, TransformFileLoaderError } from './transformFileLoader';
 export { isRegexPatternFileLoaderError, loadRegexPatternArray, loadRegexPatternsFromKeys, RegexPatternFileLoaderError } from './regexPatternFileLoader';

package/dist/utils/index.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-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.parseFilterExpression = exports.isFilterParseError = exports.FilterParseError = exports.filterFileMaps = exports.filterFileMap = exports.fileMatchesFilter = 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;
+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.parseVersion = exports.isVersionCheckerError = exports.isNewerVersion = 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.parseFilterExpression = exports.isFilterParseError = exports.FilterParseError = exports.filterFileMaps = exports.filterFileMap = exports.fileMatchesFilter = 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 = exports.NUMERIC_MIN_FLOOR = 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; } });
@@ -26,7 +26,9 @@ var diffGenerator_1 = require("./diffGenerator");
 Object.defineProperty(exports, "generateUnifiedDiff", { enumerable: true, get: function () { return diffGenerator_1.generateUnifiedDiff; } });
 var versionChecker_1 = require("./versionChecker");
 Object.defineProperty(exports, "checkForUpdates", { enumerable: true, get: function () { return versionChecker_1.checkForUpdates; } });
+Object.defineProperty(exports, "isNewerVersion", { enumerable: true, get: function () { return versionChecker_1.isNewerVersion; } });
 Object.defineProperty(exports, "isVersionCheckerError", { enumerable: true, get: function () { return versionChecker_1.isVersionCheckerError; } });
+Object.defineProperty(exports, "parseVersion", { enumerable: true, get: function () { return versionChecker_1.parseVersion; } });
 Object.defineProperty(exports, "VersionCheckerError", { enumerable: true, get: function () { return versionChecker_1.VersionCheckerError; } });
 var yamlFileLoader_1 = require("./yamlFileLoader");
 Object.defineProperty(exports, "escapeRegex", { enumerable: true, get: function () { return yamlFileLoader_1.escapeRegex; } });

package/dist/utils/regexTransform.d.ts

@@ -1,2 +1,2 @@
-import type { TransformRule } from '../configFile';
+import type { TransformRule } from '../config';
 export declare const applyRegexRulesSequentially: (value: string, rules: TransformRule[], throwOnError?: boolean) => string;

package/dist/utils/regexValidator.d.ts

@@ -1,4 +1,4 @@
-import type { StopRule } from '../configFile';
+import type { StopRule } from '../config';
 export interface StopRuleViolation {
     file: string;
     rule: StopRule;

package/dist/utils/transformFileLoader.d.ts

@@ -1,4 +1,4 @@
-import type { TransformRule } from '../configFile';
+import type { TransformRule } from '../config';
 export declare const TransformFileLoaderError: {
     new (message: string, options?: import("./errors").ErrorOptions): {
         [key: string]: unknown;

package/dist/utils/transformer.d.ts

@@ -1,4 +1,4 @@
-import type { TransformConfig, TransformRule } from '../configFile';
+import type { TransformConfig, TransformRule } from '../config';
 declare const TransformerErrorClass: {
     new (message: string, options?: import("./errors").ErrorOptions): {
         [key: string]: unknown;

package/dist/utils/versionChecker.d.ts

@@ -16,5 +16,12 @@ declare const VersionCheckerErrorClass: {
 export declare class VersionCheckerError extends VersionCheckerErrorClass {
 }
 export declare const isVersionCheckerError: (error: unknown) => error is VersionCheckerError;
+export interface SemverParts {
+    major: number;
+    minor: number;
+    patch: number;
+}
+export declare const parseVersion: (version: string) => SemverParts | undefined;
+export declare const isNewerVersion: (current: string, latest: string) => boolean;
 export declare const checkForUpdates: (currentVersion: string) => Promise<void>;
 export {};

package/dist/utils/versionChecker.js

@@ -3,7 +3,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.checkForUpdates = exports.isVersionCheckerError = exports.VersionCheckerError = void 0;
+exports.checkForUpdates = exports.isNewerVersion = exports.parseVersion = exports.isVersionCheckerError = exports.VersionCheckerError = void 0;
 const node_https_1 = __importDefault(require("node:https"));
 const chalk_1 = __importDefault(require("chalk"));
 const package_json_1 = __importDefault(require("../../package.json"));
@@ -44,9 +44,10 @@ const parseVersion = (version) => {
         patch: Number.parseInt(match[3], 10)
     };
 };
+exports.parseVersion = parseVersion;
 const isNewerVersion = (current, latest) => {
-    const currentParts = parseVersion(current);
-    const latestParts = parseVersion(latest);
+    const currentParts = (0, exports.parseVersion)(current);
+    const latestParts = (0, exports.parseVersion)(latest);
     if (!currentParts || !latestParts)
         return false;
     if (latestParts.major > currentParts.major)
@@ -59,6 +60,7 @@ const isNewerVersion = (current, latest) => {
         return false;
     return latestParts.patch > currentParts.patch;
 };
+exports.isNewerVersion = isNewerVersion;
 const fetchLatestVersion = (packageName, timeout) => {
     return new Promise((resolve, reject) => {
         const url = `https://registry.npmjs.org/${packageName}/latest`;
@@ -108,7 +110,7 @@ const checkForUpdates = async (currentVersion) => {
         return;
     try {
         const latestVersion = await fetchLatestVersion('helm-env-delta', 3000);
-        if (isNewerVersion(currentVersion, latestVersion))
+        if ((0, exports.isNewerVersion)(currentVersion, latestVersion))
             displayUpdateNotification(currentVersion, latestVersion);
     }
     catch {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "helm-env-delta",
-  "version": "1.12.0",
+  "version": "1.13.1",
   "description": "HelmEnvDelta – environment-aware YAML delta and sync for GitOps",
   "author": "BCsabaEngine",
   "license": "ISC",
@@ -40,9 +40,9 @@
     "test:coverage": "vitest run --coverage",
     "test:perf": "vitest bench --run",
     "test:perf:json": "vitest bench --run --reporter=json --outputFile=benchmark-results.json",
-    "test:all": "npm test && npm run test:perf",
+    "test:all": "node --run test && node --run test:perf",
     "clean": "tsc --build --clean",
-    "build": "tsc --build --clean && tsc --build --force",
+    "build": "tsc --build --clean && tsc --build",
     "format:check": "prettier --check .",
     "format:fix": "prettier --write . | grep -v 'unchanged' | sed G",
     "lint:check": "eslint .",
@@ -63,17 +63,13 @@
     "sync",
     "automation"
   ],
-  "overrides": {
-    "mkdirp": "3.0.1"
-  },
   "devDependencies": {
-    "@types/hogan.js": "^3.0.5",
-    "@types/node": "^25.2.3",
+    "@eslint/js": "^10.0.0",
+    "@types/node": "^25.3.0",
     "@types/picomatch": "^4.0.2",
-    "@typescript-eslint/eslint-plugin": "^8.55.0",
-    "@typescript-eslint/parser": "^8.55.0",
+    "@typescript-eslint/eslint-plugin": "^8.56.0",
     "@vitest/coverage-v8": "^4.0.18",
-    "eslint": "^9.39.2",
+    "eslint": "^10.0.0",
     "eslint-config-prettier": "^10.1.8",
     "eslint-plugin-simple-import-sort": "^12.1.1",
     "eslint-plugin-unicorn": "^63.0.0",

package/dist/configLoader.d.ts

@@ -1,6 +0,0 @@
-import { type FinalConfig, type FormatOnlyConfig } from './configFile';
-export type Config = FinalConfig;
-export type LoadConfigOptions = {
-    formatOnly?: boolean;
-};
-export declare const loadConfigFile: (configPath: string, quiet?: boolean, logger?: import("./logger").Logger, options?: LoadConfigOptions) => FinalConfig | FormatOnlyConfig;