helm-env-delta 1.11.1 → 1.13.0

package/README.md

@@ -52,11 +52,11 @@ HelmEnvDelta (`hed`) automates environment synchronization for GitOps workflows
 
 🛡️ **Safety Rules** - Block major version upgrades, scaling violations, and forbidden patterns. Load validation rules from external files. Scan globally or target specific fields.
 
-🎨 **Format Enforcement** - Standardize YAML across all environments: key ordering, indentation, quoting, array sorting.
+🎨 **Format Enforcement** - Standardize YAML across all environments: key ordering, alphabetical key sorting, indentation, quoting, array sorting.
 
 📦 **Config Inheritance** - Reuse base configurations with environment-specific overrides.
 
-📊 **Multiple Reports** - Console, HTML (visual, self-contained), and JSON (CI/CD) output formats. HTML reports include collapsible diff stats dashboard, synchronized side-by-side scrolling, copy diff buttons, file search, and collapse/expand controls. Empty categories are automatically hidden.
+📊 **Multiple Reports** - Console, HTML (visual, self-contained), and JSON (CI/CD) output formats. HTML reports include collapsible diff stats dashboard, stop rule violations table (dry-run only), synchronized side-by-side scrolling, copy diff buttons, file search, and collapse/expand controls. Empty categories are automatically hidden.
 
 🔍 **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.
 
@@ -119,7 +119,7 @@ hed -c config.yaml
 hed -c config.yaml -H
 ```
 
-Self-contained HTML report — works offline, no CDN required. Includes collapsible diff stats dashboard, synchronized side-by-side scrolling, copy buttons, sidebar search, and collapse/expand controls. Empty categories are automatically hidden.
+Self-contained HTML report — works offline, no CDN required. Includes collapsible diff stats dashboard, stop rule violations table (shown in dry-run mode), synchronized side-by-side scrolling, copy buttons, sidebar search, and collapse/expand controls. Empty categories are automatically hidden.
 
 ### 5️⃣ Get Smart Suggestions (Optional)
 
@@ -208,6 +208,9 @@ outputFormat:
       - 'kind'
       - 'metadata'
       - 'spec'
+  keySort:
+    '**/*.yaml':
+      - path: 'spec.template.metadata.labels'
   arraySort:
     '**/*.yaml':
       - path: 'env'
@@ -410,10 +413,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)
@@ -664,6 +670,8 @@ stopRules:
 
 **Override:** Use `--force` to bypass stop rules when needed.
 
+**Visibility:** Stop rule violations appear in console output, JSON reports, and HTML reports (dry-run mode only, as a collapsible table in the header area).
+
 ---
 
 ### 🎨 Output Formatting
@@ -675,13 +683,18 @@ outputFormat:
   indent: 2 # Indentation size
   keySeparator: true # Blank line between top-level keys (or second-level keys when single top-level key)
 
-  keyOrders: # Custom key ordering
+  keyOrders: # Custom key ordering (pin specific keys to top)
     'apps/*.yaml':
       - 'apiVersion'
       - 'kind'
       - 'metadata'
       - 'spec'
 
+  keySort: # Sort all keys alphabetically at path
+    '**/*.yaml':
+      - path: 'spec.template.metadata.labels'
+      - path: 'env.vars'
+
   arraySort: # Sort arrays
     'services/**/values.yaml':
       - path: 'env'
@@ -767,7 +780,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)

package/dist/configFile.d.ts

@@ -77,6 +77,9 @@ declare const arraySortRuleSchema: z.ZodObject<{
         desc: "desc";
     }>>;
 }, z.core.$strip>;
+declare const keySortRuleSchema: z.ZodObject<{
+    path: z.ZodString;
+}, z.core.$strip>;
 declare const fixedValueRuleSchema: z.ZodObject<{
     path: z.ZodString;
     value: z.ZodUnknown;
@@ -99,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>>;
@@ -111,6 +115,9 @@ declare const baseConfigSchema: z.ZodObject<{
         keySeparator: z.ZodOptional<z.ZodBoolean>;
         quoteValues: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString>>>;
         keyOrders: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString>>>;
+        keySort: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodObject<{
+            path: z.ZodString;
+        }, z.core.$strip>>>>;
         arraySort: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodObject<{
             path: z.ZodString;
             sortBy: z.ZodString;
@@ -182,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>>>;
@@ -230,6 +238,9 @@ declare const finalConfigSchema: z.ZodObject<{
         keySeparator: z.ZodDefault<z.ZodBoolean>;
         quoteValues: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString>>>;
         keyOrders: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString>>>;
+        keySort: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodObject<{
+            path: z.ZodString;
+        }, z.core.$strip>>>>;
         arraySort: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodObject<{
             path: z.ZodString;
             sortBy: z.ZodString;
@@ -253,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>>>;
@@ -301,6 +313,9 @@ declare const formatOnlyConfigSchema: z.ZodObject<{
         keySeparator: z.ZodDefault<z.ZodBoolean>;
         quoteValues: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString>>>;
         keyOrders: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString>>>;
+        keySort: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodObject<{
+            path: z.ZodString;
+        }, z.core.$strip>>>>;
         arraySort: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodObject<{
             path: z.ZodString;
             sortBy: z.ZodString;
@@ -324,6 +339,7 @@ export type RegexFileRule = z.infer<typeof regexFileRuleSchema>;
 export type RegexFileKeyRule = z.infer<typeof regexFileKeyRuleSchema>;
 export type VersionFormatRule = z.infer<typeof versionFormatRuleSchema>;
 export type ArraySortRule = z.infer<typeof arraySortRuleSchema>;
+export type KeySortRule = z.infer<typeof keySortRuleSchema>;
 export type TransformRule = z.infer<typeof transformRuleSchema>;
 export type TransformRules = z.infer<typeof transformRulesSchema>;
 export type TransformConfig = Record<string, TransformRules>;

package/dist/configFile.js

@@ -79,6 +79,7 @@ const arraySortRuleSchema = zod_1.z.object({
     sortBy: zod_1.z.string().min(1),
     order: zod_1.z.enum(['asc', 'desc']).default('asc')
 });
+const keySortRuleSchema = zod_1.z.object({ path: zod_1.z.string().min(1) });
 const fixedValueRuleSchema = zod_1.z.object({
     path: zod_1.z.string().min(1).describe('JSONPath to the value to set'),
     value: zod_1.z.unknown().describe('The constant value to set (any type: string, number, boolean, null, object, array)')
@@ -115,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(),
@@ -128,6 +136,7 @@ const baseConfigSchema = zod_1.z.object({
         keySeparator: zod_1.z.boolean().optional(),
         quoteValues: zod_1.z.record(zod_1.z.string(), zod_1.z.array(zod_1.z.string())).optional(),
         keyOrders: zod_1.z.record(zod_1.z.string(), zod_1.z.array(zod_1.z.string())).optional(),
+        keySort: zod_1.z.record(zod_1.z.string(), zod_1.z.array(keySortRuleSchema)).optional(),
         arraySort: zod_1.z.record(zod_1.z.string(), zod_1.z.array(arraySortRuleSchema)).optional()
     })
         .optional(),
@@ -149,6 +158,7 @@ const finalConfigSchema = baseConfigSchema
         keySeparator: zod_1.z.boolean().default(false),
         quoteValues: zod_1.z.record(zod_1.z.string(), zod_1.z.array(zod_1.z.string())).optional(),
         keyOrders: zod_1.z.record(zod_1.z.string(), zod_1.z.array(zod_1.z.string())).optional(),
+        keySort: zod_1.z.record(zod_1.z.string(), zod_1.z.array(keySortRuleSchema)).optional(),
         arraySort: zod_1.z.record(zod_1.z.string(), zod_1.z.array(arraySortRuleSchema)).optional()
     })
         .optional()
@@ -176,6 +186,7 @@ const formatOnlyConfigSchema = baseConfigSchema
         keySeparator: zod_1.z.boolean().default(false),
         quoteValues: zod_1.z.record(zod_1.z.string(), zod_1.z.array(zod_1.z.string())).optional(),
         keyOrders: zod_1.z.record(zod_1.z.string(), zod_1.z.array(zod_1.z.string())).optional(),
+        keySort: zod_1.z.record(zod_1.z.string(), zod_1.z.array(keySortRuleSchema)).optional(),
         arraySort: zod_1.z.record(zod_1.z.string(), zod_1.z.array(arraySortRuleSchema)).optional()
     })
         .optional()

package/dist/configLoader.d.ts

@@ -1,6 +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

@@ -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 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.js

@@ -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/htmlReporter.d.ts

@@ -1,5 +1,6 @@
 import { Config } from './configFile';
 import { FileDiffResult } from './fileDiff';
+import type { ValidationResult } from './stopRulesValidator';
 export type { DiffStats, ReportMetadata } from './reporters/htmlTemplate';
 declare const HtmlReporterErrorClass: {
     new (message: string, options?: import("./utils/errors").ErrorOptions): {
@@ -19,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) => 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

@@ -118,7 +118,7 @@ const writeHtmlFile = async (htmlContent, outputPath) => {
         });
     }
 };
-const generateHtmlReport = async (diffResult, formattedFiles, config, dryRun, logger) => {
+const generateHtmlReport = async (diffResult, formattedFiles, config, dryRun, logger, validationResult) => {
     const reportPath = generateTemporaryFilePath();
     const metadata = {
         timestamp: new Date().toISOString(),
@@ -151,7 +151,17 @@ const generateHtmlReport = async (diffResult, formattedFiles, config, dryRun, lo
     }
     statsArray.sort((a, b) => b.added + b.removed - (a.added + a.removed));
     const diffStats = { totalAdded, totalRemoved, fileStats: statsArray };
-    const htmlContent = (0, htmlTemplate_1.generateHtmlTemplate)(diffResult, formattedFiles, trulyUnchangedFiles, metadata, changedSections, changedFileIds, addedSections, addedFileIds, diffStats);
+    const stopRuleViolations = validationResult && validationResult.violations.length > 0
+        ? validationResult.violations.map((violation) => ({
+            file: violation.file,
+            rule: { type: violation.rule.type, path: violation.rule.path },
+            path: violation.path,
+            oldValue: violation.oldValue,
+            updatedValue: violation.updatedValue,
+            message: violation.message
+        }))
+        : undefined;
+    const htmlContent = (0, htmlTemplate_1.generateHtmlTemplate)(diffResult, formattedFiles, trulyUnchangedFiles, metadata, changedSections, changedFileIds, addedSections, addedFileIds, diffStats, stopRuleViolations);
     await writeHtmlFile(htmlContent, reportPath);
     logger?.log(`✓ HTML report generated: ${reportPath}, opening in browser...`);
     try {

package/dist/index.js

@@ -326,7 +326,7 @@ const main = async () => {
     }
     const formattedFiles = await (0, fileUpdater_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);
+        await (0, htmlReporter_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);
 };
@@ -337,6 +337,8 @@ const main = async () => {
     catch (error) {
         if ((0, configMerger_1.isConfigMergerError)(error))
             console.error(error.message);
+        else if ((0, configLoader_1.isConfigLoaderError)(error))
+            console.error(error.message);
         else if ((0, ZodError_1.isZodValidationError)(error))
             console.error(error.message);
         else if ((0, fileLoader_1.isFileLoaderError)(error))

package/dist/reporters/htmlStyles.d.ts

@@ -1,3 +1,3 @@
 export declare const DIFF2HTML_STYLES: string;
-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  .file-section[open] > summary {\n    position: sticky;\n    top: 0;\n    z-index: 10;\n    border-bottom: 1px solid #d0d7de;\n    box-shadow: 0 2px 4px rgba(0,0,0,0.1);\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\n  /* Scroll-to-top button */\n  .scroll-to-top {\n    display: none;\n    position: fixed;\n    bottom: 30px;\n    right: 30px;\n    width: 40px;\n    height: 40px;\n    border: none;\n    border-radius: 50%;\n    background: #0969da;\n    color: white;\n    font-size: 18px;\n    cursor: pointer;\n    box-shadow: 0 2px 8px rgba(0,0,0,0.2);\n    transition: opacity 0.2s, background 0.2s;\n    z-index: 200;\n    line-height: 40px;\n    text-align: center;\n    padding: 0;\n  }\n\n  .scroll-to-top:hover {\n    background: #0550ae;\n  }\n\n  .scroll-to-top.visible {\n    display: block;\n  }\n\n  /* Content toolbar (collapse/expand buttons) */\n  .content-toolbar {\n    display: flex;\n    gap: 8px;\n    justify-content: flex-end;\n    margin-bottom: 12px;\n  }\n\n  .collapse-all-btn,\n  .expand-all-btn {\n    padding: 4px 12px;\n    border: 1px solid #d0d7de;\n    border-radius: 4px;\n    background: none;\n    cursor: pointer;\n    font-size: 12px;\n    color: #586069;\n    transition: all 0.2s;\n  }\n\n  .collapse-all-btn:hover,\n  .expand-all-btn:hover {\n    background: #f6f8fa;\n    color: #24292e;\n  }\n\n  /* Line change count badges */\n  .summary-badges {\n    float: right;\n    display: inline-flex;\n    gap: 6px;\n    margin-left: 12px;\n  }\n\n  .line-badge {\n    display: inline-block;\n    padding: 1px 8px;\n    border-radius: 10px;\n    font-size: 11px;\n    font-weight: 600;\n    font-family: ui-monospace, SFMono-Regular, \"SF Mono\", Menlo, Consolas, \"Liberation Mono\", monospace;\n    line-height: 18px;\n  }\n\n  .line-added {\n    background: #d4edda;\n    color: #155724;\n  }\n\n  .line-removed {\n    background: #f8d7da;\n    color: #721c24;\n  }\n\n  /* Diff toolbar */\n  .diff-toolbar {\n    display: flex;\n    justify-content: flex-end;\n    padding: 8px 16px;\n    border-bottom: 1px solid #d0d7de;\n    background: #f6f8fa;\n  }\n\n  .copy-diff-btn {\n    padding: 4px 12px;\n    border: 1px solid #d0d7de;\n    border-radius: 6px;\n    background: white;\n    cursor: pointer;\n    font-size: 12px;\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-diff-btn:hover {\n    background: #f3f4f6;\n    border-color: #b0b7be;\n  }\n\n  .copy-diff-btn.copied {\n    background: #d4edda;\n    border-color: #28a745;\n    color: #155724;\n  }\n\n  /* Sidebar search */\n  .sidebar-search {\n    width: 100%;\n    padding: 6px 8px;\n    border: 1px solid #d0d7de;\n    border-radius: 4px;\n    font-family: ui-monospace, SFMono-Regular, \"SF Mono\", Menlo, Consolas, \"Liberation Mono\", monospace;\n    font-size: 12px;\n    margin-bottom: 8px;\n    box-sizing: border-box;\n    position: sticky;\n    top: 0;\n    z-index: 1;\n    background: #fff;\n  }\n\n  .sidebar-search:focus {\n    outline: none;\n    border-color: #0969da;\n    box-shadow: 0 0 0 3px rgba(9,105,218,0.15);\n  }\n\n  /* Stats toggle button */\n  .stats-toggle-btn {\n    padding: 4px 12px;\n    border: 1px solid #d0d7de;\n    border-radius: 4px;\n    background: none;\n    cursor: pointer;\n    font-size: 12px;\n    color: #586069;\n    transition: all 0.2s;\n  }\n\n  .stats-toggle-btn:hover {\n    background: #f6f8fa;\n    color: #24292e;\n  }\n\n  /* Statistics dashboard */\n  .stats-dashboard {\n    margin: 15px 0 0;\n    padding: 12px 0 0;\n    border-top: 1px solid #e1e4e8;\n  }\n\n  .stats-summary {\n    display: flex;\n    gap: 16px;\n    align-items: center;\n    margin-bottom: 10px;\n  }\n\n  .stats-summary .total-added {\n    font-weight: 700;\n    color: #155724;\n    font-size: 16px;\n  }\n\n  .stats-summary .total-removed {\n    font-weight: 700;\n    color: #721c24;\n    font-size: 16px;\n  }\n\n  .stats-bar {\n    display: flex;\n    height: 8px;\n    border-radius: 4px;\n    overflow: hidden;\n    background: #e1e4e8;\n    margin-bottom: 10px;\n  }\n\n  .stats-segment {\n    height: 100%;\n    min-width: 2px;\n  }\n\n  .stats-segment.added-segment {\n    background: #28a745;\n  }\n\n  .stats-segment.removed-segment {\n    background: #d73a49;\n  }\n\n  .top-changed-files {\n    list-style: none;\n    padding: 0;\n    margin: 0;\n    font-size: 13px;\n  }\n\n  .top-changed-files li {\n    display: flex;\n    justify-content: space-between;\n    align-items: center;\n    padding: 3px 0;\n    font-family: ui-monospace, SFMono-Regular, \"SF Mono\", Menlo, Consolas, \"Liberation Mono\", monospace;\n    color: #586069;\n  }\n\n  .top-changed-files .file-path {\n    overflow: hidden;\n    text-overflow: ellipsis;\n    white-space: nowrap;\n    margin-right: 8px;\n  }\n\n  .top-changed-files .file-stats {\n    white-space: nowrap;\n    flex-shrink: 0;\n  }\n";
+export declare const HTML_STYLES = "\n  /* Custom styles */\n  body {\n    font-family: -apple-system, BlinkMacSystemFont, \"Segoe UI\", Roboto, Helvetica, Arial, sans-serif;\n    margin: 0;\n    padding: 20px;\n    background: #f6f8fa;\n  }\n\n  header {\n    background: white;\n    padding: 20px;\n    border-radius: 6px;\n    margin-bottom: 20px;\n    box-shadow: 0 1px 3px rgba(0,0,0,0.12);\n  }\n\n  h1 {\n    margin: 0 0 10px 0;\n    color: #24292e;\n  }\n\n  .metadata {\n    display: flex;\n    gap: 20px;\n    margin: 10px 0;\n    color: #586069;\n    font-size: 14px;\n  }\n\n  .dry-run-badge {\n    display: inline-block;\n    padding: 4px 8px;\n    background: #cfe2ff;\n    color: #084298;\n    border-radius: 4px;\n    font-weight: bold;\n    font-size: 12px;\n  }\n\n  .summary {\n    display: flex;\n    gap: 12px;\n    margin: 15px 0;\n  }\n\n  .stat {\n    padding: 8px 16px;\n    border-radius: 6px;\n    font-weight: 600;\n    font-size: 14px;\n  }\n\n  .stat.added { background: #d4edda; color: #155724; }\n  .stat.changed { background: #fff3cd; color: #856404; }\n  .stat.deleted { background: #f8d7da; color: #721c24; }\n  .stat.formatted { background: #d1ecf1; color: #0c5460; }\n  .stat.unchanged { background: #e2e3e5; color: #383d41; }\n\n  .tabs {\n    display: flex;\n    background: white;\n    border-radius: 6px 6px 0 0;\n    border-bottom: 1px solid #d0d7de;\n    box-shadow: 0 1px 3px rgba(0,0,0,0.12);\n  }\n\n  .tab {\n    padding: 12px 24px;\n    border: none;\n    background: transparent;\n    cursor: pointer;\n    font-size: 14px;\n    color: #586069;\n    transition: all 0.2s;\n  }\n\n  .tab:hover {\n    color: #24292e;\n  }\n\n  .tab.active {\n    border-bottom: 2px solid #0969da;\n    color: #0969da;\n    font-weight: 600;\n  }\n\n  main {\n    background: white;\n    padding: 20px;\n    border-radius: 0 0 6px 6px;\n    box-shadow: 0 1px 3px rgba(0,0,0,0.12);\n  }\n\n  .tab-content {\n    display: none;\n  }\n\n  .tab-content.active {\n    display: block;\n  }\n\n  .file-section {\n    margin: 12px 0;\n    border: 1px solid #d0d7de;\n    border-radius: 6px;\n  }\n\n  .file-section summary {\n    padding: 12px 16px;\n    background: #f6f8fa;\n    cursor: pointer;\n    font-weight: 600;\n    font-family: ui-monospace, SFMono-Regular, \"SF Mono\", Menlo, Consolas, \"Liberation Mono\", monospace;\n    font-size: 13px;\n    color: #24292e;\n  }\n\n  .file-section summary:hover {\n    background: #eaeef2;\n  }\n\n  .file-section[open] > summary {\n    position: sticky;\n    top: 0;\n    z-index: 10;\n    border-bottom: 1px solid #d0d7de;\n    box-shadow: 0 2px 4px rgba(0,0,0,0.1);\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\n  /* Scroll-to-top button */\n  .scroll-to-top {\n    display: none;\n    position: fixed;\n    bottom: 30px;\n    right: 30px;\n    width: 40px;\n    height: 40px;\n    border: none;\n    border-radius: 50%;\n    background: #0969da;\n    color: white;\n    font-size: 18px;\n    cursor: pointer;\n    box-shadow: 0 2px 8px rgba(0,0,0,0.2);\n    transition: opacity 0.2s, background 0.2s;\n    z-index: 200;\n    line-height: 40px;\n    text-align: center;\n    padding: 0;\n  }\n\n  .scroll-to-top:hover {\n    background: #0550ae;\n  }\n\n  .scroll-to-top.visible {\n    display: block;\n  }\n\n  /* Content toolbar (collapse/expand buttons) */\n  .content-toolbar {\n    display: flex;\n    gap: 8px;\n    justify-content: flex-end;\n    margin-bottom: 12px;\n  }\n\n  .collapse-all-btn,\n  .expand-all-btn {\n    padding: 4px 12px;\n    border: 1px solid #d0d7de;\n    border-radius: 4px;\n    background: none;\n    cursor: pointer;\n    font-size: 12px;\n    color: #586069;\n    transition: all 0.2s;\n  }\n\n  .collapse-all-btn:hover,\n  .expand-all-btn:hover {\n    background: #f6f8fa;\n    color: #24292e;\n  }\n\n  /* Line change count badges */\n  .summary-badges {\n    float: right;\n    display: inline-flex;\n    gap: 6px;\n    margin-left: 12px;\n  }\n\n  .line-badge {\n    display: inline-block;\n    padding: 1px 8px;\n    border-radius: 10px;\n    font-size: 11px;\n    font-weight: 600;\n    font-family: ui-monospace, SFMono-Regular, \"SF Mono\", Menlo, Consolas, \"Liberation Mono\", monospace;\n    line-height: 18px;\n  }\n\n  .line-added {\n    background: #d4edda;\n    color: #155724;\n  }\n\n  .line-removed {\n    background: #f8d7da;\n    color: #721c24;\n  }\n\n  /* Diff toolbar */\n  .diff-toolbar {\n    display: flex;\n    justify-content: flex-end;\n    padding: 8px 16px;\n    border-bottom: 1px solid #d0d7de;\n    background: #f6f8fa;\n  }\n\n  .copy-diff-btn {\n    padding: 4px 12px;\n    border: 1px solid #d0d7de;\n    border-radius: 6px;\n    background: white;\n    cursor: pointer;\n    font-size: 12px;\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-diff-btn:hover {\n    background: #f3f4f6;\n    border-color: #b0b7be;\n  }\n\n  .copy-diff-btn.copied {\n    background: #d4edda;\n    border-color: #28a745;\n    color: #155724;\n  }\n\n  /* Sidebar search */\n  .sidebar-search {\n    width: 100%;\n    padding: 6px 8px;\n    border: 1px solid #d0d7de;\n    border-radius: 4px;\n    font-family: ui-monospace, SFMono-Regular, \"SF Mono\", Menlo, Consolas, \"Liberation Mono\", monospace;\n    font-size: 12px;\n    margin-bottom: 8px;\n    box-sizing: border-box;\n    position: sticky;\n    top: 0;\n    z-index: 1;\n    background: #fff;\n  }\n\n  .sidebar-search:focus {\n    outline: none;\n    border-color: #0969da;\n    box-shadow: 0 0 0 3px rgba(9,105,218,0.15);\n  }\n\n  /* Stats toggle button */\n  .stats-toggle-btn {\n    padding: 4px 12px;\n    border: 1px solid #d0d7de;\n    border-radius: 4px;\n    background: none;\n    cursor: pointer;\n    font-size: 12px;\n    color: #586069;\n    transition: all 0.2s;\n  }\n\n  .stats-toggle-btn:hover {\n    background: #f6f8fa;\n    color: #24292e;\n  }\n\n  /* Statistics dashboard */\n  .stats-dashboard {\n    margin: 15px 0 0;\n    padding: 12px 0 0;\n    border-top: 1px solid #e1e4e8;\n  }\n\n  .stats-summary {\n    display: flex;\n    gap: 16px;\n    align-items: center;\n    margin-bottom: 10px;\n  }\n\n  .stats-summary .total-added {\n    font-weight: 700;\n    color: #155724;\n    font-size: 16px;\n  }\n\n  .stats-summary .total-removed {\n    font-weight: 700;\n    color: #721c24;\n    font-size: 16px;\n  }\n\n  .stats-bar {\n    display: flex;\n    height: 8px;\n    border-radius: 4px;\n    overflow: hidden;\n    background: #e1e4e8;\n    margin-bottom: 10px;\n  }\n\n  .stats-segment {\n    height: 100%;\n    min-width: 2px;\n  }\n\n  .stats-segment.added-segment {\n    background: #28a745;\n  }\n\n  .stats-segment.removed-segment {\n    background: #d73a49;\n  }\n\n  .top-changed-files {\n    list-style: none;\n    padding: 0;\n    margin: 0;\n    font-size: 13px;\n  }\n\n  .top-changed-files li {\n    display: flex;\n    justify-content: space-between;\n    align-items: center;\n    padding: 3px 0;\n    font-family: ui-monospace, SFMono-Regular, \"SF Mono\", Menlo, Consolas, \"Liberation Mono\", monospace;\n    color: #586069;\n  }\n\n  .top-changed-files .file-path {\n    overflow: hidden;\n    text-overflow: ellipsis;\n    white-space: nowrap;\n    margin-right: 8px;\n  }\n\n  .top-changed-files .file-stats {\n    white-space: nowrap;\n    flex-shrink: 0;\n  }\n\n  /* Stop rules violations badge */\n  .stat.violations { background: #f8d7da; color: #721c24; }\n\n  /* Violations section */\n  .violations-section {\n    margin: 15px 0 0;\n    padding: 12px 0 0;\n    border-top: 1px solid #e1e4e8;\n  }\n\n  .violations-toggle-btn {\n    padding: 4px 12px;\n    border: 1px solid #d0d7de;\n    border-radius: 4px;\n    background: none;\n    cursor: pointer;\n    font-size: 12px;\n    color: #586069;\n    transition: all 0.2s;\n  }\n\n  .violations-toggle-btn:hover {\n    background: #f6f8fa;\n    color: #24292e;\n  }\n\n  .violations-table {\n    width: 100%;\n    border-collapse: collapse;\n    font-size: 13px;\n    margin-top: 10px;\n  }\n\n  .violations-table th {\n    background: #f6f8fa;\n    text-align: left;\n    padding: 8px 12px;\n    border-bottom: 2px solid #d0d7de;\n    font-weight: 600;\n    color: #24292e;\n  }\n\n  .violations-table td {\n    padding: 8px 12px;\n    border-bottom: 1px solid #e1e4e8;\n    color: #24292e;\n    vertical-align: top;\n  }\n\n  .violations-table tr:hover td {\n    background: #f6f8fa;\n  }\n\n  .violation-rule-badge {\n    display: inline-block;\n    padding: 2px 8px;\n    border-radius: 10px;\n    font-size: 11px;\n    font-weight: 600;\n    background: #fff3cd;\n    color: #856404;\n    white-space: nowrap;\n  }\n\n  .violation-value {\n    font-family: ui-monospace, SFMono-Regular, \"SF Mono\", Menlo, Consolas, \"Liberation Mono\", monospace;\n    font-size: 12px;\n    background: #f6f8fa;\n    padding: 2px 6px;\n    border-radius: 3px;\n    border: 1px solid #e1e4e8;\n  }\n";
 export declare const TAB_SCRIPT: string;

package/dist/reporters/htmlStyles.js

@@ -617,6 +617,79 @@ exports.HTML_STYLES = `
     white-space: nowrap;
     flex-shrink: 0;
   }
+
+  /* Stop rules violations badge */
+  .stat.violations { background: #f8d7da; color: #721c24; }
+
+  /* Violations section */
+  .violations-section {
+    margin: 15px 0 0;
+    padding: 12px 0 0;
+    border-top: 1px solid #e1e4e8;
+  }
+
+  .violations-toggle-btn {
+    padding: 4px 12px;
+    border: 1px solid #d0d7de;
+    border-radius: 4px;
+    background: none;
+    cursor: pointer;
+    font-size: 12px;
+    color: #586069;
+    transition: all 0.2s;
+  }
+
+  .violations-toggle-btn:hover {
+    background: #f6f8fa;
+    color: #24292e;
+  }
+
+  .violations-table {
+    width: 100%;
+    border-collapse: collapse;
+    font-size: 13px;
+    margin-top: 10px;
+  }
+
+  .violations-table th {
+    background: #f6f8fa;
+    text-align: left;
+    padding: 8px 12px;
+    border-bottom: 2px solid #d0d7de;
+    font-weight: 600;
+    color: #24292e;
+  }
+
+  .violations-table td {
+    padding: 8px 12px;
+    border-bottom: 1px solid #e1e4e8;
+    color: #24292e;
+    vertical-align: top;
+  }
+
+  .violations-table tr:hover td {
+    background: #f6f8fa;
+  }
+
+  .violation-rule-badge {
+    display: inline-block;
+    padding: 2px 8px;
+    border-radius: 10px;
+    font-size: 11px;
+    font-weight: 600;
+    background: #fff3cd;
+    color: #856404;
+    white-space: nowrap;
+  }
+
+  .violation-value {
+    font-family: ui-monospace, SFMono-Regular, "SF Mono", Menlo, Consolas, "Liberation Mono", monospace;
+    font-size: 12px;
+    background: #f6f8fa;
+    padding: 2px 6px;
+    border-radius: 3px;
+    border: 1px solid #e1e4e8;
+  }
 `;
 exports.TAB_SCRIPT = String.raw `
   // Tab switching
@@ -915,6 +988,18 @@ exports.TAB_SCRIPT = String.raw `
     });
   }
 
+  // Violations section toggle
+  const violationsToggleBtn = document.getElementById('violations-toggle-btn');
+  const violationsContent = document.getElementById('violations-content');
+  if (violationsToggleBtn && violationsContent) {
+    violationsToggleBtn.addEventListener('click', () => {
+      const isHidden = violationsContent.style.display === 'none';
+      violationsContent.style.display = isHidden ? 'block' : 'none';
+      const count = violationsToggleBtn.textContent.match(/\d+/)?.[0] || '0';
+      violationsToggleBtn.textContent = isHidden ? 'Hide Violations (' + count + ')' : 'Show Violations (' + count + ')';
+    });
+  }
+
   // Synchronized horizontal scrolling for side-by-side diff panels
   document.querySelectorAll('.d2h-files-diff').forEach(container => {
     const panels = container.querySelectorAll('.d2h-file-side-diff');

package/dist/reporters/htmlTemplate.d.ts

@@ -1,4 +1,15 @@
 import { FileDiffResult } from '../fileDiff';
+export interface HtmlStopRuleViolation {
+    file: string;
+    rule: {
+        type: string;
+        path?: string;
+    };
+    path: string;
+    oldValue: unknown;
+    updatedValue: unknown;
+    message: string;
+}
 export interface ReportMetadata {
     timestamp: string;
     source: string;
@@ -14,4 +25,4 @@ export interface DiffStats {
         removed: number;
     }>;
 }
-export declare const generateHtmlTemplate: (diffResult: FileDiffResult, formattedFiles: string[], trulyUnchangedFiles: string[], metadata: ReportMetadata, changedSections: string[], changedFileIds?: Map<string, string>, addedSections?: string[], addedFileIds?: Map<string, string>, diffStats?: DiffStats) => 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>, diffStats?: DiffStats, stopRuleViolations?: HtmlStopRuleViolation[]) => string;

package/dist/reporters/htmlTemplate.js

@@ -4,6 +4,46 @@ exports.generateHtmlTemplate = void 0;
 const htmlStyles_1 = require("./htmlStyles");
 const treeBuilder_1 = require("./treeBuilder");
 const treeRenderer_1 = require("./treeRenderer");
+const formatViolationValue = (value) => {
+    if (value === undefined || value === null)
+        return '<span class="violation-value">-</span>';
+    return `<span class="violation-value">${(0, treeRenderer_1.escapeHtml)(String(value))}</span>`;
+};
+const renderStopRulesSection = (violations) => {
+    if (violations.length === 0)
+        return '';
+    const rows = violations
+        .map((v) => `<tr>
+          <td>${(0, treeRenderer_1.escapeHtml)(v.file)}</td>
+          <td><span class="violation-rule-badge">${(0, treeRenderer_1.escapeHtml)(v.rule.type)}</span></td>
+          <td>${(0, treeRenderer_1.escapeHtml)(v.path)}</td>
+          <td>${formatViolationValue(v.oldValue)}</td>
+          <td>${formatViolationValue(v.updatedValue)}</td>
+          <td>${(0, treeRenderer_1.escapeHtml)(v.message)}</td>
+        </tr>`)
+        .join('');
+    return `
+    <div class="violations-section">
+      <button class="violations-toggle-btn" id="violations-toggle-btn">Show Violations (${violations.length})</button>
+      <div id="violations-content" style="display: none">
+        <table class="violations-table">
+          <thead>
+            <tr>
+              <th>File</th>
+              <th>Rule</th>
+              <th>Path</th>
+              <th>Old Value</th>
+              <th>New Value</th>
+              <th>Message</th>
+            </tr>
+          </thead>
+          <tbody>
+            ${rows}
+          </tbody>
+        </table>
+      </div>
+    </div>`;
+};
 const renderStatsDashboard = (diffStats) => {
     const total = diffStats.totalAdded + diffStats.totalRemoved;
     if (total === 0)
@@ -31,7 +71,7 @@ const renderStatsDashboard = (diffStats) => {
       </div>
     </div>`;
 };
-const generateHtmlTemplate = (diffResult, formattedFiles, trulyUnchangedFiles, metadata, changedSections, changedFileIds = new Map(), addedSections = [], addedFileIds = new Map(), diffStats) => {
+const generateHtmlTemplate = (diffResult, formattedFiles, trulyUnchangedFiles, metadata, changedSections, changedFileIds = new Map(), addedSections = [], addedFileIds = new Map(), diffStats, stopRuleViolations) => {
     const changedFilePaths = diffResult.changedFiles.map((f) => f.path);
     const changedTree = (0, treeBuilder_1.buildFileTree)(changedFilePaths);
     const addedFilePaths = diffResult.addedFiles.map((f) => f.path);
@@ -48,9 +88,11 @@ const generateHtmlTemplate = (diffResult, formattedFiles, trulyUnchangedFiles, m
     ];
     const activeCategories = categories.filter((c) => c.count > 0);
     const firstActiveTab = activeCategories[0]?.id ?? 'changed';
-    const summaryBadges = activeCategories
-        .map((c) => `<span class="stat ${c.id}">${c.count} ${c.label}</span>`)
-        .join('\n      ');
+    const violationsBadge = stopRuleViolations && stopRuleViolations.length > 0
+        ? `<span class="stat violations">${stopRuleViolations.length} Violation${stopRuleViolations.length === 1 ? '' : 's'}</span>`
+        : '';
+    const summaryBadges = activeCategories.map((c) => `<span class="stat ${c.id}">${c.count} ${c.label}</span>`).join('\n      ') +
+        (violationsBadge ? `\n      ${violationsBadge}` : '');
     const tabButtons = activeCategories
         .map((c) => `<button class="tab${c.id === firstActiveTab ? ' active' : ''}" data-tab="${c.id}">${c.label} (${c.count})</button>`)
         .join('\n    ');
@@ -140,6 +182,7 @@ ${htmlStyles_1.HTML_STYLES}
       ${summaryBadges}
     </div>
     ${diffStats ? renderStatsDashboard(diffStats) : ''}
+    ${stopRuleViolations && stopRuleViolations.length > 0 ? renderStopRulesSection(stopRuleViolations) : ''}
   </header>
 
   <nav class="tabs">

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/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/dist/yamlFormatter.js

@@ -20,12 +20,16 @@ exports.YamlFormatterError = (0, errors_1.createErrorClass)('YAML Formatter Erro
 exports.isYamlFormatterError = (0, errors_1.createErrorTypeGuard)(exports.YamlFormatterError);
 const getFormattingRules = (filePath, outputFormat) => {
     const keyOrders = [];
+    const keySort = [];
     const arraySort = [];
     const quoteValues = [];
     const allPatterns = new Set();
     if (outputFormat?.keyOrders)
         for (const pattern of Object.keys(outputFormat.keyOrders))
             allPatterns.add(pattern);
+    if (outputFormat?.keySort)
+        for (const pattern of Object.keys(outputFormat.keySort))
+            allPatterns.add(pattern);
     if (outputFormat?.arraySort)
         for (const pattern of Object.keys(outputFormat.arraySort))
             allPatterns.add(pattern);
@@ -38,6 +42,9 @@ const getFormattingRules = (filePath, outputFormat) => {
         const keyOrder = outputFormat?.keyOrders?.[pattern];
         if (keyOrder)
             keyOrders.push(keyOrder);
+        const keySortRule = outputFormat?.keySort?.[pattern];
+        if (keySortRule)
+            keySort.push(keySortRule);
         const arrayRule = outputFormat?.arraySort?.[pattern];
         if (arrayRule)
             arraySort.push(arrayRule);
@@ -45,7 +52,7 @@ const getFormattingRules = (filePath, outputFormat) => {
         if (quoteValue)
             quoteValues.push(quoteValue);
     }
-    return { keyOrders, arraySort, quoteValues };
+    return { keyOrders, keySort, arraySort, quoteValues };
 };
 const preserveMultilineStrings = (yamlDocument) => {
     if (!yamlDocument.contents)
@@ -81,6 +88,8 @@ const formatYaml = (content, filePath, outputFormat) => {
         const rules = getFormattingRules(filePath, outputFormat);
         if (rules.keyOrders.length > 0)
             applyKeyOrdering(yamlDocument, rules.keyOrders);
+        if (rules.keySort.length > 0)
+            applyKeySort(yamlDocument, rules.keySort);
         if (rules.arraySort.length > 0)
             applyArraySorting(yamlDocument, rules.arraySort);
         if (rules.quoteValues.length > 0)
@@ -171,6 +180,43 @@ const applyOrderingToMap = (map, currentPath, orderHierarchy) => {
         }
     }
 };
+const applyKeySort = (yamlDocument, sortRules) => {
+    if (sortRules.length === 0)
+        return;
+    const allRules = sortRules.flat();
+    for (const rule of allRules) {
+        const pathParts = (0, jsonPath_1.parseJsonPath)(rule.path);
+        if (pathParts.length === 0)
+            continue;
+        if (yamlDocument.contents)
+            traverseAndSortKeys(yamlDocument.contents, [], pathParts);
+    }
+};
+const traverseAndSortKeys = (node, currentPath, targetPath) => {
+    if (!node || typeof node !== 'object')
+        return;
+    if (matchPath(currentPath, targetPath)) {
+        if ((0, yamlTypeGuards_1.isYamlMap)(node))
+            sortMapKeysAlphabetically(node);
+        return;
+    }
+    if ((0, yamlTypeGuards_1.isYamlMap)(node))
+        for (const item of node.items) {
+            const keyValue = (0, yamlTypeGuards_1.extractKeyValue)(item);
+            if (keyValue && item.value) {
+                const childPath = [...currentPath, keyValue];
+                if (isPotentialMatch(childPath, targetPath))
+                    traverseAndSortKeys(item.value, childPath, targetPath);
+            }
+        }
+};
+const sortMapKeysAlphabetically = (map) => {
+    map.items.sort((a, b) => {
+        const aKey = a.key && typeof a.key === 'object' && 'value' in a.key ? String(a.key.value) : '';
+        const bKey = b.key && typeof b.key === 'object' && 'value' in b.key ? String(b.key.value) : '';
+        return aKey.localeCompare(bKey);
+    });
+};
 const applyValueQuoting = (yamlDocument, quoteLists) => {
     if (quoteLists.length === 0)
         return;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "helm-env-delta",
-  "version": "1.11.1",
+  "version": "1.13.0",
   "description": "HelmEnvDelta – environment-aware YAML delta and sync for GitOps",
   "author": "BCsabaEngine",
   "license": "ISC",
@@ -68,15 +68,15 @@
   },
   "devDependencies": {
     "@types/hogan.js": "^3.0.5",
-    "@types/node": "^25.2.1",
+    "@types/node": "^25.2.3",
     "@types/picomatch": "^4.0.2",
-    "@typescript-eslint/eslint-plugin": "^8.54.0",
-    "@typescript-eslint/parser": "^8.54.0",
+    "@typescript-eslint/eslint-plugin": "^8.55.0",
+    "@typescript-eslint/parser": "^8.55.0",
     "@vitest/coverage-v8": "^4.0.18",
     "eslint": "^9.39.2",
     "eslint-config-prettier": "^10.1.8",
     "eslint-plugin-simple-import-sort": "^12.1.1",
-    "eslint-plugin-unicorn": "^62.0.0",
+    "eslint-plugin-unicorn": "^63.0.0",
     "prettier": "^3.8.1",
     "tsx": "^4.21.0",
     "typescript": "^5.9.3",