@redocly/recheck 0.1.0

package/dist/config/load.d.ts

@@ -0,0 +1,20 @@
+import type { NormalizedRule, ValidationError } from '../types/index.js';
+export interface LoadResult {
+    success: boolean;
+    rules: NormalizedRule[];
+    errors: ValidationError[];
+    configPath?: string;
+}
+/**
+ * Loads and validates a recheck configuration file
+ */
+export declare function loadConfig(configPath: string): Promise<LoadResult>;
+/**
+ * Finds a recheck configuration file in the current directory or parent directories
+ */
+export declare function findConfigFile(startDir?: string): Promise<string | null>;
+/**
+ * Loads configuration with automatic discovery
+ */
+export declare function findAndLoadConfig(configPath?: string): Promise<LoadResult>;
+//# sourceMappingURL=load.d.ts.map

package/dist/config/load.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"load.d.ts","sourceRoot":"","sources":["../../src/config/load.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAIzE,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,cAAc,EAAE,CAAC;IACxB,MAAM,EAAE,eAAe,EAAE,CAAC;IAC1B,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAID;;GAEG;AACH,wBAAsB,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAiCxE;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,QAAQ,GAAE,MAAsB,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAuB7F;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAgBhF"}

package/dist/config/load.js

@@ -0,0 +1,85 @@
+import * as fs from 'fs/promises';
+import * as path from 'path';
+import * as yaml from 'js-yaml';
+import { validate } from './validate.js';
+const CONFIG_NAMES = ['recheck.yaml', 'recheck.yml'];
+/**
+ * Loads and validates a recheck configuration file
+ */
+export async function loadConfig(configPath) {
+    try {
+        const fileContent = await fs.readFile(configPath, 'utf8');
+        let config;
+        try {
+            config = yaml.load(fileContent);
+        }
+        catch (yamlError) {
+            return {
+                success: false,
+                rules: [],
+                errors: [{ message: `YAML parsing error: ${yamlError.message}` }],
+                configPath,
+            };
+        }
+        // Validate configuration
+        const validation = await validate(config);
+        return {
+            success: validation.isValid,
+            rules: validation.rules,
+            errors: validation.errors,
+            configPath,
+        };
+    }
+    catch (error) {
+        return {
+            success: false,
+            rules: [],
+            errors: [{ message: `Error loading configuration: ${error.message}` }],
+            configPath,
+        };
+    }
+}
+/**
+ * Finds a recheck configuration file in the current directory or parent directories
+ */
+export async function findConfigFile(startDir = process.cwd()) {
+    let currentDir = startDir;
+    while (true) {
+        for (const configName of CONFIG_NAMES) {
+            const configPath = path.join(currentDir, configName);
+            try {
+                await fs.access(configPath);
+                return configPath;
+            }
+            catch {
+                // not found, continue
+            }
+        }
+        const parentDir = path.dirname(currentDir);
+        if (parentDir === currentDir) {
+            // Reached root directory
+            break;
+        }
+        currentDir = parentDir;
+    }
+    return null;
+}
+/**
+ * Loads configuration with automatic discovery
+ */
+export async function findAndLoadConfig(configPath) {
+    const actualConfigPath = configPath || (await findConfigFile());
+    if (!actualConfigPath) {
+        return {
+            success: false,
+            rules: [],
+            errors: [
+                {
+                    message: `No recheck configuration file found. Looking for: ${CONFIG_NAMES.join(', ')}`,
+                },
+            ],
+        };
+    }
+    return loadConfig(actualConfigPath);
+}
+//# sourceMappingURL=load.js.map

package/dist/config/load.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"load.js","sourceRoot":"","sources":["../../src/config/load.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,aAAa,CAAC;AAClC,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,KAAK,IAAI,MAAM,SAAS,CAAC;AAIhC,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AASzC,MAAM,YAAY,GAAG,CAAC,cAAc,EAAE,aAAa,CAAC,CAAC;AAErD;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,UAAkB;IACjD,IAAI,CAAC;QACH,MAAM,WAAW,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;QAE1D,IAAI,MAAW,CAAC;QAChB,IAAI,CAAC;YACH,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QAClC,CAAC;QAAC,OAAO,SAAS,EAAE,CAAC;YACnB,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,EAAE;gBACT,MAAM,EAAE,CAAC,EAAE,OAAO,EAAE,uBAAuB,SAAS,CAAC,OAAO,EAAE,EAAE,CAAC;gBACjE,UAAU;aACX,CAAC;QACJ,CAAC;QAED,yBAAyB;QACzB,MAAM,UAAU,GAAG,MAAM,QAAQ,CAAC,MAAM,CAAC,CAAC;QAE1C,OAAO;YACL,OAAO,EAAE,UAAU,CAAC,OAAO;YAC3B,KAAK,EAAE,UAAU,CAAC,KAAK;YACvB,MAAM,EAAE,UAAU,CAAC,MAAM;YACzB,UAAU;SACX,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO;YACL,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,EAAE;YACT,MAAM,EAAE,CAAC,EAAE,OAAO,EAAE,gCAAgC,KAAK,CAAC,OAAO,EAAE,EAAE,CAAC;YACtE,UAAU;SACX,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,WAAmB,OAAO,CAAC,GAAG,EAAE;IACnE,IAAI,UAAU,GAAG,QAAQ,CAAC;IAE1B,OAAO,IAAI,EAAE,CAAC;QACZ,KAAK,MAAM,UAAU,IAAI,YAAY,EAAE,CAAC;YACtC,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;YACrD,IAAI,CAAC;gBACH,MAAM,EAAE,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;gBAC5B,OAAO,UAAU,CAAC;YACpB,CAAC;YAAC,MAAM,CAAC;gBACP,sBAAsB;YACxB,CAAC;QACH,CAAC;QAED,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QAC3C,IAAI,SAAS,KAAK,UAAU,EAAE,CAAC;YAC7B,yBAAyB;YACzB,MAAM;QACR,CAAC;QACD,UAAU,GAAG,SAAS,CAAC;IACzB,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,UAAmB;IACzD,MAAM,gBAAgB,GAAG,UAAU,IAAI,CAAC,MAAM,cAAc,EAAE,CAAC,CAAC;IAEhE,IAAI,CAAC,gBAAgB,EAAE,CAAC;QACtB,OAAO;YACL,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,EAAE;YACT,MAAM,EAAE;gBACN;oBACE,OAAO,EAAE,qDAAqD,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;iBACxF;aACF;SACF,CAAC;IACJ,CAAC;IAED,OAAO,UAAU,CAAC,gBAAgB,CAAC,CAAC;AACtC,CAAC"}

package/dist/config/schema.d.ts

@@ -0,0 +1,109 @@
+export declare const RECHECK_CONFIG_SCHEMA: {
+    $schema: string;
+    type: string;
+    patternProperties: {
+        '^recheck/[a-z0-9-_]+$': {
+            type: string;
+            properties: {
+                severity: {
+                    type: string;
+                    enum: string[];
+                    default: string;
+                };
+                message: {
+                    type: string;
+                    minLength: number;
+                };
+                enabled: {
+                    type: string;
+                    default: boolean;
+                };
+                autoFixable: {
+                    type: string;
+                    default: boolean;
+                };
+                tags: {
+                    type: string;
+                    items: {
+                        type: string;
+                    };
+                };
+                description: {
+                    type: string;
+                };
+                link: {
+                    type: string;
+                    format: string;
+                };
+                scope: {
+                    oneOf: ({
+                        type: string;
+                        anyOf: ({
+                            enum: string[];
+                            pattern?: undefined;
+                        } | {
+                            pattern: string;
+                            enum?: undefined;
+                        })[];
+                        items?: undefined;
+                        minItems?: undefined;
+                    } | {
+                        type: string;
+                        items: {
+                            type: string;
+                            anyOf: ({
+                                enum: string[];
+                                pattern?: undefined;
+                            } | {
+                                pattern: string;
+                                enum?: undefined;
+                            })[];
+                        };
+                        minItems: number;
+                        anyOf?: undefined;
+                    })[];
+                    default: string;
+                };
+                appliesTo: {
+                    type: string;
+                    items: {
+                        type: string;
+                    };
+                };
+                excludes: {
+                    type: string;
+                    items: {
+                        type: string;
+                    };
+                };
+                exceptions: {
+                    type: string;
+                    properties: {
+                        files: {
+                            type: string;
+                            items: {
+                                type: string;
+                            };
+                        };
+                        lines: {
+                            type: string;
+                            items: {
+                                type: string;
+                            };
+                        };
+                    };
+                    additionalProperties: boolean;
+                };
+                assertions: {
+                    type: string;
+                    additionalProperties: boolean;
+                    minProperties: number;
+                };
+            };
+            required: string[];
+            additionalProperties: boolean;
+        };
+    };
+    additionalProperties: boolean;
+};
+//# sourceMappingURL=schema.d.ts.map

package/dist/config/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/config/schema.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAqGjC,CAAC"}

package/dist/config/schema.js

@@ -0,0 +1,103 @@
+export const RECHECK_CONFIG_SCHEMA = {
+    $schema: 'http://json-schema.org/draft-07/schema#',
+    type: 'object',
+    patternProperties: {
+        '^recheck/[a-z0-9-_]+$': {
+            type: 'object',
+            properties: {
+                severity: {
+                    type: 'string',
+                    enum: ['off', 'info', 'warn', 'error'],
+                    default: 'error',
+                },
+                message: {
+                    type: 'string',
+                    minLength: 1,
+                },
+                enabled: {
+                    type: 'boolean',
+                    default: true,
+                },
+                autoFixable: {
+                    type: 'boolean',
+                    default: false,
+                },
+                tags: {
+                    type: 'array',
+                    items: {
+                        type: 'string',
+                    },
+                },
+                description: {
+                    type: 'string',
+                },
+                link: {
+                    type: 'string',
+                    format: 'uri',
+                },
+                scope: {
+                    oneOf: [
+                        {
+                            type: 'string',
+                            anyOf: [
+                                { enum: ['all', 'heading', 'sentence', 'paragraph', 'code', 'default', 'raw'] },
+                                { pattern: '^heading\\.h[1-6]$' },
+                            ],
+                        },
+                        {
+                            type: 'array',
+                            items: {
+                                type: 'string',
+                                anyOf: [
+                                    { enum: ['all', 'heading', 'sentence', 'paragraph', 'code', 'default', 'raw'] },
+                                    { pattern: '^heading\\.h[1-6]$' },
+                                ],
+                            },
+                            minItems: 1,
+                        },
+                    ],
+                    default: 'all',
+                },
+                appliesTo: {
+                    type: 'array',
+                    items: {
+                        type: 'string',
+                    },
+                },
+                excludes: {
+                    type: 'array',
+                    items: {
+                        type: 'string',
+                    },
+                },
+                exceptions: {
+                    type: 'object',
+                    properties: {
+                        files: {
+                            type: 'array',
+                            items: {
+                                type: 'string',
+                            },
+                        },
+                        lines: {
+                            type: 'array',
+                            items: {
+                                type: 'string',
+                            },
+                        },
+                    },
+                    additionalProperties: false,
+                },
+                assertions: {
+                    type: 'object',
+                    additionalProperties: true,
+                    minProperties: 1,
+                },
+            },
+            required: ['severity', 'message', 'assertions'],
+            additionalProperties: false,
+        },
+    },
+    additionalProperties: false,
+};
+//# sourceMappingURL=schema.js.map

package/dist/config/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/config/schema.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,OAAO,EAAE,yCAAyC;IAClD,IAAI,EAAE,QAAQ;IACd,iBAAiB,EAAE;QACjB,uBAAuB,EAAE;YACvB,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,QAAQ,EAAE;oBACR,IAAI,EAAE,QAAQ;oBACd,IAAI,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC;oBACtC,OAAO,EAAE,OAAO;iBACjB;gBACD,OAAO,EAAE;oBACP,IAAI,EAAE,QAAQ;oBACd,SAAS,EAAE,CAAC;iBACb;gBACD,OAAO,EAAE;oBACP,IAAI,EAAE,SAAS;oBACf,OAAO,EAAE,IAAI;iBACd;gBACD,WAAW,EAAE;oBACX,IAAI,EAAE,SAAS;oBACf,OAAO,EAAE,KAAK;iBACf;gBACD,IAAI,EAAE;oBACJ,IAAI,EAAE,OAAO;oBACb,KAAK,EAAE;wBACL,IAAI,EAAE,QAAQ;qBACf;iBACF;gBACD,WAAW,EAAE;oBACX,IAAI,EAAE,QAAQ;iBACf;gBACD,IAAI,EAAE;oBACJ,IAAI,EAAE,QAAQ;oBACd,MAAM,EAAE,KAAK;iBACd;gBACD,KAAK,EAAE;oBACL,KAAK,EAAE;wBACL;4BACE,IAAI,EAAE,QAAQ;4BACd,KAAK,EAAE;gCACL,EAAE,IAAI,EAAE,CAAC,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,CAAC,EAAE;gCAC/E,EAAE,OAAO,EAAE,oBAAoB,EAAE;6BAClC;yBACF;wBACD;4BACE,IAAI,EAAE,OAAO;4BACb,KAAK,EAAE;gCACL,IAAI,EAAE,QAAQ;gCACd,KAAK,EAAE;oCACL,EAAE,IAAI,EAAE,CAAC,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,CAAC,EAAE;oCAC/E,EAAE,OAAO,EAAE,oBAAoB,EAAE;iCAClC;6BACF;4BACD,QAAQ,EAAE,CAAC;yBACZ;qBACF;oBACD,OAAO,EAAE,KAAK;iBACf;gBACD,SAAS,EAAE;oBACT,IAAI,EAAE,OAAO;oBACb,KAAK,EAAE;wBACL,IAAI,EAAE,QAAQ;qBACf;iBACF;gBACD,QAAQ,EAAE;oBACR,IAAI,EAAE,OAAO;oBACb,KAAK,EAAE;wBACL,IAAI,EAAE,QAAQ;qBACf;iBACF;gBACD,UAAU,EAAE;oBACV,IAAI,EAAE,QAAQ;oBACd,UAAU,EAAE;wBACV,KAAK,EAAE;4BACL,IAAI,EAAE,OAAO;4BACb,KAAK,EAAE;gCACL,IAAI,EAAE,QAAQ;6BACf;yBACF;wBACD,KAAK,EAAE;4BACL,IAAI,EAAE,OAAO;4BACb,KAAK,EAAE;gCACL,IAAI,EAAE,QAAQ;6BACf;yBACF;qBACF;oBACD,oBAAoB,EAAE,KAAK;iBAC5B;gBACD,UAAU,EAAE;oBACV,IAAI,EAAE,QAAQ;oBACd,oBAAoB,EAAE,IAAI;oBAC1B,aAAa,EAAE,CAAC;iBACjB;aACF;YACD,QAAQ,EAAE,CAAC,UAAU,EAAE,SAAS,EAAE,YAAY,CAAC;YAC/C,oBAAoB,EAAE,KAAK;SAC5B;KACF;IACD,oBAAoB,EAAE,KAAK;CAC5B,CAAC"}

package/dist/config/validate.d.ts

@@ -0,0 +1,10 @@
+import type { NormalizedRule, ValidationError } from '../types/index.js';
+/**
+ * Full validation pipeline
+ */
+export declare function validate(config: any): Promise<{
+    isValid: boolean;
+    errors: ValidationError[];
+    rules: NormalizedRule[];
+}>;
+//# sourceMappingURL=validate.d.ts.map

package/dist/config/validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../src/config/validate.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAiB,cAAc,EAAE,eAAe,EAAY,MAAM,mBAAmB,CAAC;AA4HlG;;GAEG;AACH,wBAAsB,QAAQ,CAAC,MAAM,EAAE,GAAG,GAAG,OAAO,CAAC;IACnD,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,eAAe,EAAE,CAAC;IAC1B,KAAK,EAAE,cAAc,EAAE,CAAC;CACzB,CAAC,CAkBD"}

package/dist/config/validate.js

@@ -0,0 +1,129 @@
+import Ajv from '@redocly/ajv';
+import addFormats from 'ajv-formats';
+import { RECHECK_CONFIG_SCHEMA } from './schema.js';
+const ajv = new Ajv({
+    useDefaults: true,
+    allErrors: true,
+    verbose: true,
+});
+addFormats(ajv); // mismatching AJV typing due to fork
+ajv.addSchema(RECHECK_CONFIG_SCHEMA, 'recheck-config');
+/**
+ * Validates configuration structure using JSON Schema
+ */
+function validateStructure(config) {
+    const validate = ajv.getSchema('recheck-config');
+    if (!validate) {
+        throw new Error('Schema not loaded');
+    }
+    const valid = validate(config);
+    if (!valid && validate.errors) {
+        return validate.errors.map((error) => ({
+            message: `${error.instancePath || '/'}: ${error.message}`,
+            path: error.instancePath,
+            value: error.data,
+        }));
+    }
+    return [];
+}
+/**
+ * Validates assertions in a rule
+ */
+function validateAssertions(rule, name, errors) {
+    if (!rule.assertions || typeof rule.assertions !== 'object') {
+        errors.push({
+            message: `Rule "${name}": assertions must be an object`,
+            path: `${name}.assertions`,
+        });
+        return;
+    }
+    for (const [assertionType, _assertionConfig] of Object.entries(rule.assertions)) {
+        try {
+            switch (assertionType) {
+                case 'swap':
+                    break;
+                case 'pattern':
+                    break;
+                case 'max-image-size':
+                case 'max-line-length':
+                case 'no-trailing-spaces':
+                case 'bullet-style':
+                case 'semantic-line-breaks':
+                case 'no-hard-tabs':
+                case 'no-duplicate-headings':
+                case 'no-broken-fragment-links':
+                    break;
+                default:
+                    errors.push({
+                        message: `Rule "${name}": unknown assertion type "${assertionType}"`,
+                        path: `${name}.assertions.${assertionType}`,
+                    });
+            }
+        }
+        catch (error) {
+            errors.push({
+                message: `Rule "${name}": error validating assertion "${assertionType}": ${error.message}`,
+                path: `${name}.assertions.${assertionType}`,
+            });
+        }
+    }
+}
+/**
+ * Performs semantic validation and normalization
+ */
+function validateSemantics(config) {
+    const errors = [];
+    const rules = [];
+    for (const [key, rule] of Object.entries(config)) {
+        try {
+            // Derive name and shortName
+            const name = key;
+            const shortName = key.replace(/^recheck\//, '');
+            // Validate message placeholder count
+            const placeholderCount = (rule.message.match(/%s/g) || []).length;
+            if (placeholderCount > 2) {
+                errors.push({
+                    message: `Rule "${name}": message can have at most 2 %s placeholders, found ${placeholderCount}`,
+                    path: `${name}.message`,
+                });
+            }
+            // Assertions validation
+            validateAssertions(rule, name, errors);
+            // Create normalized rule
+            const normalizedRule = {
+                ...rule,
+                name,
+                shortName,
+            };
+            rules.push(normalizedRule);
+        }
+        catch (error) {
+            errors.push({
+                message: `Rule "${key}": ${error.message}`,
+                path: key,
+            });
+        }
+    }
+    return { errors, rules };
+}
+/**
+ * Full validation pipeline
+ */
+export async function validate(config) {
+    const structureErrors = validateStructure(config);
+    if (structureErrors.length > 0) {
+        return {
+            isValid: false,
+            errors: structureErrors,
+            rules: [],
+        };
+    }
+    // Then validate semantics
+    const { errors: semanticErrors, rules } = validateSemantics(config);
+    return {
+        isValid: semanticErrors.length === 0,
+        errors: semanticErrors,
+        rules,
+    };
+}
+//# sourceMappingURL=validate.js.map

package/dist/config/validate.js.map

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

package/dist/core/auto-fix.d.ts

@@ -0,0 +1,16 @@
+import type { Fix, NormalizedRule } from '../types/index.js';
+import type { Context } from '../assertions/index.js';
+export interface FixContext {
+    content: string;
+    segments: any;
+}
+/**
+ * Collect all fixes for the given files and rules
+ */
+export declare function collectFixes(files: string[], rules: NormalizedRule[], contentsByFile: Record<string, string>, segmentsByFile: Record<string, any>, metadataByFile?: Record<string, Context['fileMetadata']>): Promise<Fix[]>;
+/**
+ * Apply fixes grouped by file. Within each file, sort fixes in reverse order of line/column
+ * so that earlier edits don't shift positions of later edits.
+ */
+export declare function applyFixes(fixes: Fix[]): Promise<void>;
+//# sourceMappingURL=auto-fix.d.ts.map

package/dist/core/auto-fix.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auto-fix.d.ts","sourceRoot":"","sources":["../../src/core/auto-fix.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,GAAG,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAC7D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AAKtD,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,GAAG,CAAC;CACf;AAED;;GAEG;AACH,wBAAsB,YAAY,CAChC,KAAK,EAAE,MAAM,EAAE,EACf,KAAK,EAAE,cAAc,EAAE,EACvB,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EACtC,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EACnC,cAAc,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,cAAc,CAAC,CAAM,GAC3D,OAAO,CAAC,GAAG,EAAE,CAAC,CAwBhB;AAED;;;GAGG;AACH,wBAAsB,UAAU,CAAC,KAAK,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CA+C5D"}

package/dist/core/auto-fix.js

@@ -0,0 +1,82 @@
+import * as fs from 'fs/promises';
+import { shouldProcessFile } from '../assertions/utils.js';
+import { getAssertion } from '../assertions/index.js';
+/**
+ * Collect all fixes for the given files and rules
+ */
+export async function collectFixes(files, rules, contentsByFile, segmentsByFile, metadataByFile = {}) {
+    const allFixes = [];
+    for (const file of files) {
+        for (const rule of rules) {
+            if (!rule.autoFixable || !shouldProcessFile(file, rule))
+                continue;
+            console.log(`   Collecting fixes for: ${rule.shortName} on ${file}...`);
+            for (const [assertionType] of Object.entries(rule.assertions)) {
+                const assertion = getAssertion(assertionType);
+                if (assertion && assertion.fix) {
+                    const fixes = await assertion.fix(rule, file, {
+                        content: contentsByFile[file],
+                        segments: segmentsByFile[file],
+                        fileMetadata: metadataByFile[file],
+                    });
+                    allFixes.push(...fixes);
+                }
+            }
+        }
+    }
+    return allFixes;
+}
+/**
+ * Apply fixes grouped by file. Within each file, sort fixes in reverse order of line/column
+ * so that earlier edits don't shift positions of later edits.
+ */
+export async function applyFixes(fixes) {
+    const byFile = {};
+    for (const fix of fixes) {
+        if (!byFile[fix.file])
+            byFile[fix.file] = [];
+        byFile[fix.file].push(fix);
+    }
+    for (const [file, fileFixes] of Object.entries(byFile)) {
+        try {
+            let content = await fs.readFile(file, 'utf8');
+            const lines = content.split('\n');
+            // Sort fixes descending by line then column
+            fileFixes.sort((a, b) => (a.line !== b.line ? b.line - a.line : b.column - a.column));
+            for (const fix of fileFixes) {
+                const lineIdx = Math.max(0, fix.line - 1);
+                if (lineIdx >= lines.length)
+                    continue;
+                const lineText = lines[lineIdx];
+                // Apply the change at column (1-based). Replace oldText at that position if it matches; otherwise, fallback to global replace on the line end (for trailing spaces)
+                const colIdx = Math.max(0, fix.column - 1);
+                if (fix.oldText === '') {
+                    // Pure insertion
+                    lines[lineIdx] = lineText.slice(0, colIdx) + fix.newText + lineText.slice(colIdx);
+                }
+                else {
+                    // Replacement or deletion
+                    if (lineText.slice(colIdx, colIdx + fix.oldText.length) === fix.oldText) {
+                        lines[lineIdx] =
+                            lineText.slice(0, colIdx) + fix.newText + lineText.slice(colIdx + fix.oldText.length);
+                    }
+                    else if (/^[ \t]+$/.test(fix.oldText)) {
+                        // Trailing space fallback: strip trailing space at end of line
+                        lines[lineIdx] = lineText.replace(/[ \t]+$/, fix.newText);
+                    }
+                    else if (fix.oldText === '\t') {
+                        // Tab replacement fallback: replace all tabs with configured spaces on this line
+                        lines[lineIdx] = lineText.replace(/\t/g, fix.newText);
+                    }
+                }
+            }
+            content = lines.join('\n');
+            await fs.writeFile(file, content, 'utf8');
+        }
+        catch (_error) {
+            // Skip files we cannot modify
+            continue;
+        }
+    }
+}
+//# sourceMappingURL=auto-fix.js.map

package/dist/core/auto-fix.js.map

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

package/dist/core/files.d.ts

@@ -0,0 +1,6 @@
+export declare function discoverMarkdownFiles(inputPath: string): Promise<string[]>;
+/**
+ * Load list of changed files from either a file path or stdin
+ */
+export declare function loadChangedFiles(changedListPath?: string): Promise<string[]>;
+//# sourceMappingURL=files.d.ts.map

package/dist/core/files.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"files.d.ts","sourceRoot":"","sources":["../../src/core/files.ts"],"names":[],"mappings":"AAMA,wBAAsB,qBAAqB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAqChF;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,eAAe,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CA6BlF"}