mejora 2.4.0 → 3.0.0

package/README.md

@@ -122,29 +122,26 @@ Create one of:
 - `mejora.config.mjs`
 - `mejora.config.mts`
 
-Example:
-
 ```ts
 import { defineConfig, eslint, regex, typescript } from "mejora";
 
 export default defineConfig({
-  checks: {
-    "eslint > no-nested-ternary": eslint({
+  checks: [
+    eslint({
+      name: "no-nested-ternary",
       files: ["src/**/*.{ts,tsx,js,jsx}"],
-      overrides: {
-        rules: {
-          "no-nested-ternary": "error",
-        },
+      rules: {
+        "no-nested-ternary": "error",
       },
     }),
-    "typescript > noImplicitAny": typescript({
-      overrides: {
-        compilerOptions: {
-          noImplicitAny: true,
-        },
+    typescript({
+      name: "no-implicit-any",
+      compilerOptions: {
+        noImplicitAny: true,
       },
     }),
-    "no-todos": regex({
+    regex({
+      name: "no-todos",
       files: ["src/**/*"],
       patterns: [
         {
@@ -161,13 +158,11 @@ export default defineConfig({
         },
       ],
     }),
-  },
+  ],
 });
 ```
 
-Each entry in `checks` is an explicit check.
-
-The object key is the check identifier and is used in the baseline.
+Each check’s `name` is used as its ID in the baseline and output.
 
 ## Supported Checks
 
@@ -199,46 +194,52 @@ The object key is the check identifier and is used in the baseline.
 
 ### Custom Checks
 
-You can add your own checks by implementing `CheckRunner` and returning an `"items"` snapshot.
-
-A custom check is made of two pieces:
-
-- A **runner** (registered in `runners`) that knows how to execute your check type
-- A **check config** (declared in `checks`) that includes a matching `type` and any options your runner needs
+Define custom checks using `defineCheck()`:
 
 ```ts
-import type { CheckRunner, IssueInput } from "mejora";
-
-interface CustomCheckConfig {
-  files: string[];
-  // your custom options
-}
-
-class CustomCheckRunner implements CheckRunner {
-  readonly type = "custom";
-
-  async run(config: CustomCheckConfig) {
-    const items: IssueInput[] = [];
-    // ...produce IssueInput entries (file/line/column/rule/message)
-    return { type: "items", items };
-  }
-}
-```
-
-Register the runner and declare a check that uses it:
+import { defineConfig, defineCheck } from "mejora";
+import { glob, readFile } from "node:fs/promises";
+
+const noHardcodedUrls = defineCheck<{ files: string[] }>({
+  type: "no-hardcoded-urls",
+  async run(config) {
+    const violations = [];
+
+    for await (const file of glob(config.files, { cwd: process.cwd() })) {
+      const content = await readFile(file, "utf-8");
+      const lines = content.split("\n");
+
+      for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        const matches = line.matchAll(/https?:\/\/[^\s'"]+/g);
+
+        for (const match of matches) {
+          violations.push({
+            file,
+            line: i + 1,
+            column: match.index + 1,
+            rule: "no-hardcoded-urls",
+            message: `Hardcoded URL found: ${match[0]}`,
+          });
+        }
+      }
+    }
 
-```ts
-import { defineConfig } from "mejora";
+    return violations;
+  },
+});
 
 export default defineConfig({
-  runners: [new CustomCheckRunner()],
-  checks: {
-    "my-custom-check": {
-      type: "custom",
+  checks: [
+    noHardcodedUrls({
+      name: "urls-in-src",
       files: ["src/**/*.ts"],
-      // your custom options
-    },
-  },
+    }),
+    noHardcodedUrls({
+      name: "urls-in-lib",
+      files: ["lib/**/*.ts"],
+    }),
+  ],
 });
 ```
 

package/dist/check-registry-mjn8FfPF.mjs

@@ -0,0 +1 @@
+var e=class{runners=new Map;static getRequiredTypes(e){return new Set(e.map(e=>e.config.type))}get(e){let t=this.runners.get(e);if(!t)throw Error(`Unknown check type: ${e}`);return t}getTypes(){return new Set(this.runners.keys())}has(e){return this.runners.has(e)}init(e={}){if(e.runners)for(let t of e.runners)this.register(t)}register(e){this.runners.has(e.type)||this.runners.set(e.type,e)}async setup(e){await this.runLifecycle(e,`setup`)}async validate(e){await this.runLifecycle(e,`validate`)}async runLifecycle(e,t){let n=[];for(let r of e){let e=this.get(r)[t]?.();e&&n.push(e)}await Promise.all(n)}};export{e as t};

package/dist/config-C0qrgNuO.mjs

@@ -0,0 +1 @@
+import{createRequire as e}from"node:module";import{pathToFileURL as t}from"node:url";var n=(e,t)=>()=>(t||e((t={exports:{}}).exports,t),t.exports),r=e(import.meta.url),i=n(((e,t)=>{let n=r(`path`),i=r(`fs`),a=r(`os`),o=r(`url`),s=i.promises.readFile;function c(e,t){return[`package.json`,`.${e}rc.json`,`.${e}rc.js`,`.${e}rc.cjs`,...t?[]:[`.${e}rc.mjs`],`.config/${e}rc`,`.config/${e}rc.json`,`.config/${e}rc.js`,`.config/${e}rc.cjs`,...t?[]:[`.config/${e}rc.mjs`],`${e}.config.js`,`${e}.config.cjs`,...t?[]:[`${e}.config.mjs`]]}function l(e){return n.dirname(e)||n.sep}let u=(e,t)=>JSON.parse(t),d=typeof __webpack_require__==`function`?__non_webpack_require__:r,f=Object.freeze({".js":d,".json":d,".cjs":d,noExt:u});t.exports.defaultLoadersSync=f;let p=async e=>{try{return(await import(o.pathToFileURL(e).href)).default}catch(t){try{return d(e)}catch(e){throw e.code===`ERR_REQUIRE_ESM`||e instanceof SyntaxError&&e.toString().includes(`Cannot use import statement outside a module`)?t:e}}},m=Object.freeze({".js":p,".mjs":p,".cjs":p,".json":u,noExt:u});t.exports.defaultLoaders=m;function h(e,t,r){let i={stopDir:a.homedir(),searchPlaces:c(e,r),ignoreEmptySearchPlaces:!0,cache:!0,transform:e=>e,packageProp:[e],...t,loaders:{...r?f:m,...t.loaders}};return i.searchPlaces.forEach(e=>{let t=n.extname(e)||`noExt`,r=i.loaders[t];if(!r)throw Error(`Missing loader for extension "${e}"`);if(typeof r!=`function`)throw Error(`Loader for extension "${e}" is not a function: Received ${typeof r}.`)}),i}function g(e,t){return typeof e==`string`&&e in t?t[e]:(Array.isArray(e)?e:e.split(`.`)).reduce((e,t)=>e===void 0?e:e[t],t)||null}function _(e){if(!e)throw Error(`load must pass a non-empty string`)}function v(e,t){if(!e)throw Error(`No loader specified for extension "${t}"`);if(typeof e!=`function`)throw Error(`loader is not a function`)}let y=e=>(t,n,r)=>(e&&t.set(n,r),r);t.exports.lilconfig=function(e,t){let{ignoreEmptySearchPlaces:r,loaders:a,packageProp:o,searchPlaces:c,stopDir:u,transform:d,cache:f}=h(e,t??{},!1),p=new Map,m=new Map,b=y(f);return{async search(e=process.cwd()){let t={config:null,filepath:``},m=new Set,h=e;dirLoop:for(;;){if(f){let e=p.get(h);if(e!==void 0){for(let t of m)p.set(t,e);return e}m.add(h)}for(let e of c){let c=n.join(h,e);try{await i.promises.access(c)}catch{continue}let l=String(await s(c)),u=n.extname(e)||`noExt`,d=a[u];if(e===`package.json`){let e=g(o,await d(c,l));if(e!=null){t.config=e,t.filepath=c;break dirLoop}continue}let f=l.trim()===``;if(!(f&&r)){f?(t.isEmpty=!0,t.config=void 0):(v(d,u),t.config=await d(c,l)),t.filepath=c;break dirLoop}}if(h===u||h===l(h))break dirLoop;h=l(h)}let _=t.filepath===``&&t.config===null?d(null):d(t);if(f)for(let e of m)p.set(e,_);return _},async load(e){_(e);let t=n.resolve(process.cwd(),e);if(f&&m.has(t))return m.get(t);let{base:i,ext:c}=n.parse(t),l=c||`noExt`,u=a[l];v(u,l);let p=String(await s(t));if(i===`package.json`)return b(m,t,d({config:g(o,await u(t,p)),filepath:t}));let h={config:null,filepath:t},y=p.trim()===``;return y&&r?b(m,t,d({config:void 0,filepath:t,isEmpty:!0})):(h.config=y?void 0:await u(t,p),b(m,t,d(y?{...h,isEmpty:y,config:void 0}:h)))},clearLoadCache(){f&&m.clear()},clearSearchCache(){f&&p.clear()},clearCaches(){f&&(m.clear(),p.clear())}}},t.exports.lilconfigSync=function(e,t){let{ignoreEmptySearchPlaces:r,loaders:a,packageProp:o,searchPlaces:s,stopDir:c,transform:u,cache:d}=h(e,t??{},!0),f=new Map,p=new Map,m=y(d);return{search(e=process.cwd()){let t={config:null,filepath:``},p=new Set,m=e;dirLoop:for(;;){if(d){let e=f.get(m);if(e!==void 0){for(let t of p)f.set(t,e);return e}p.add(m)}for(let e of s){let s=n.join(m,e);try{i.accessSync(s)}catch{continue}let c=n.extname(e)||`noExt`,l=a[c],u=String(i.readFileSync(s));if(e===`package.json`){let e=g(o,l(s,u));if(e!=null){t.config=e,t.filepath=s;break dirLoop}continue}let d=u.trim()===``;if(!(d&&r)){d?(t.isEmpty=!0,t.config=void 0):(v(l,c),t.config=l(s,u)),t.filepath=s;break dirLoop}}if(m===c||m===l(m))break dirLoop;m=l(m)}let h=t.filepath===``&&t.config===null?u(null):u(t);if(d)for(let e of p)f.set(e,h);return h},load(e){_(e);let t=n.resolve(process.cwd(),e);if(d&&p.has(t))return p.get(t);let{base:s,ext:c}=n.parse(t),l=c||`noExt`,f=a[l];v(f,l);let h=String(i.readFileSync(t));if(s===`package.json`)return u({config:g(o,f(t,h)),filepath:t});let y={config:null,filepath:t},b=h.trim()===``;return b&&r?m(p,t,u({filepath:t,config:void 0,isEmpty:!0})):(y.config=b?void 0:f(t,h),m(p,t,u(b?{...y,isEmpty:b,config:void 0}:y)))},clearLoadCache(){d&&p.clear()},clearSearchCache(){d&&f.clear()},clearCaches(){d&&(p.clear(),f.clear())}}}}))();const a=async e=>{let n=await import(t(e).href);return n&&typeof n==`object`&&`default`in n?n.default:n};function o(e){let t=[],n=new Set;for(let r of e.checks)if(r.__runnerFactory&&!n.has(r.config.type)){n.add(r.config.type);let e=r.__runnerFactory();t.push(e)}return{checks:e.checks,runners:t}}const s=async()=>{let e=await(0,i.lilconfig)(`mejora`,{loaders:{".js":a,".mjs":a,".mts":a,".ts":a},searchPlaces:[`mejora.config.ts`,`mejora.config.mts`,`mejora.config.js`,`mejora.config.mjs`]}).search(process.cwd());if(!e?.config)throw Error(`No configuration file found.`);return e.config};export{s as n,o as t};

package/dist/hash-BaLFZO2A.mjs

@@ -0,0 +1 @@
+import{hash as e}from"node:crypto";const t=/^[A-Za-z]:\//;function n(e=``){return e&&e.replace(/\\/g,`/`).replace(t,e=>e.toUpperCase())}const r=/^[/\\]{2}/,i=/^[/\\](?![/\\])|^[/\\]{2}(?!\.)|^[A-Za-z]:[/\\]/,a=/^[A-Za-z]:$/,o=/^\/([A-Za-z]:)?$/,s=`/`,c=function(e){if(e.length===0)return`.`;e=n(e);let t=e.match(r),i=p(e),o=e[e.length-1]===`/`;return e=f(e,!i),e.length===0?i?`/`:o?`./`:`.`:(o&&(e+=`/`),a.test(e)&&(e+=`/`),t?i?`//${e}`:`//./${e}`:i&&!p(e)?`/${e}`:e)},l=function(...e){let t=``;for(let n of e)if(n)if(t.length>0){let e=t[t.length-1]===`/`,r=n[0]===`/`;e&&r?t+=n.slice(1):t+=e||r?n:`/${n}`}else t+=n;return c(t)};function u(){return typeof process<`u`&&typeof process.cwd==`function`?process.cwd().replace(/\\/g,`/`):`/`}const d=function(...e){e=e.map(e=>n(e));let t=``,r=!1;for(let n=e.length-1;n>=-1&&!r;n--){let i=n>=0?e[n]:u();!i||i.length===0||(t=`${i}/${t}`,r=p(i))}return t=f(t,!r),r&&!p(t)?`/${t}`:t.length>0?t:`.`};function f(e,t){let n=``,r=0,i=-1,a=0,o=null;for(let s=0;s<=e.length;++s){if(s<e.length)o=e[s];else if(o===`/`)break;else o=`/`;if(o===`/`){if(!(i===s-1||a===1))if(a===2){if(n.length<2||r!==2||n[n.length-1]!==`.`||n[n.length-2]!==`.`){if(n.length>2){let e=n.lastIndexOf(`/`);e===-1?(n=``,r=0):(n=n.slice(0,e),r=n.length-1-n.lastIndexOf(`/`)),i=s,a=0;continue}else if(n.length>0){n=``,r=0,i=s,a=0;continue}}t&&(n+=n.length>0?`/..`:`..`,r=2)}else n.length>0?n+=`/${e.slice(i+1,s)}`:n=e.slice(i+1,s),r=s-i-1;i=s,a=0}else o===`.`&&a!==-1?++a:a=-1}return n}const p=function(e){return i.test(e)},m=function(e,t){let n=d(e).replace(o,`$1`).split(`/`),r=d(t).replace(o,`$1`).split(`/`);if(r[0][1]===`:`&&n[0][1]===`:`&&n[0]!==r[0])return r.join(`/`);let i=[...n];for(let e of i){if(r[0]!==e)break;n.shift(),r.shift()}return[...n.map(()=>`..`),...r].join(`/`)},h=function(e){let t=n(e).replace(/\/$/,``).split(`/`).slice(0,-1);return t.length===1&&a.test(t[0])&&(t[0]+=`/`),t.join(`/`)||(p(e)?`/`:`.`)},g=function(e,t){let r=n(e).split(`/`),i=``;for(let e=r.length-1;e>=0;e--){let t=r[e];if(t){i=t;break}}return t&&i.endsWith(t)?i.slice(0,-t.length):i},_=t=>e(`sha256`,t,`hex`);export{l as a,s as c,p as i,g as n,m as o,h as r,d as s,_ as t};

package/dist/index-BNOgTD7N.d.mts

@@ -0,0 +1,520 @@
+import { Linter } from "eslint";
+import { CompilerOptions } from "typescript";
+
+//#region src/types.d.ts
+interface Issue {
+  /**
+   * 1-indexed column number for display.
+   */
+  column: number;
+  /**
+   * Relative path from cwd.
+   */
+  file: string;
+  /**
+   * Hash of canonical representation.
+   *
+   * @example "a1b2c3d4e5f6g7h8i9j0"
+   */
+  id: string;
+  /**
+   * 1-indexed line number for display.
+   */
+  line: number;
+  /**
+   *  The message.
+   */
+  message: string;
+  /**
+   * Identifier for the issue (rule name, diagnostic code, etc).
+   *
+   * @example "no-nested-ternary" (ESLint)
+   *
+   * @example "TS2345" (TypeScript)
+   */
+  rule: string;
+}
+/**
+ * Issue produced by a check runner.
+ */
+type IssueInput = Omit<Issue, "id">;
+type SnapshotType = "items";
+interface RawSnapshot {
+  /**
+   * Snapshot items (each item represents an issue produced by the check).
+   */
+  items: IssueInput[];
+  type: SnapshotType;
+}
+interface Snapshot {
+  items: Issue[];
+  type: SnapshotType;
+}
+/**
+ * Configuration for an ESLint check.
+ *
+ * All ESLint configuration fields (rules, languageOptions, plugins, etc.)
+ * are passed directly to ESLint's `overrideConfig` option.
+ *
+ * @example
+ * ```ts
+ * eslint({
+ *   name: "no-console",
+ *   files: ["src/**\/*.{ts,tsx}"],
+ *   rules: {
+ *     "no-console": "error",
+ *   },
+ * })
+ * ```
+ *
+ * @example Advanced with custom parser
+ * ```ts
+ * eslint({
+ *   name: "typescript-strict",
+ *   files: ["src/**\/*.ts"],
+ *   rules: {
+ *     "@typescript-eslint/no-explicit-any": "error"
+ *   },
+ *   languageOptions: {
+ *     parser: typescriptParser
+ *   }
+ * })
+ * ```
+ */
+interface ESLintCheckConfig extends Linter.Config {
+  /**
+   * Concurrency setting for ESLint.
+   *
+   * @see https://eslint.org/blog/2025/08/multithread-linting/#cli-multithreading-support
+   *
+   * @default "auto"
+   */
+  concurrency?: "auto" | "off" | number;
+  /**
+   * Glob patterns for files to lint.
+   *
+   * Passed directly to ESLint's `lintFiles()` method.
+   *
+   * @example ["src/**\/*.ts", "src/**\/*.tsx"]
+   */
+  files: string[];
+}
+/**
+ * Configuration for a TypeScript diagnostics check.
+ *
+ * @example
+ * ```ts
+ * typescript({
+ *   name: "strict",
+ *   compilerOptions: {
+ *     noImplicitAny: true,
+ *   },
+ * })
+ * ```
+ */
+interface TypeScriptCheckConfig {
+  /**
+   * Compiler options to merge with the base tsconfig.
+   *
+   * These options are merged with (not replacing) the compiler options
+   * from your tsconfig file.
+   */
+  compilerOptions?: CompilerOptions;
+  /**
+   * Path to a TypeScript config file.
+   *
+   * If not provided, mejora will search for the nearest `tsconfig.json`
+   * starting from the current working directory.
+   *
+   * @example "tsconfig.strict.json"
+   */
+  tsconfig?: string;
+}
+/**
+ * A regex pattern configuration.
+ */
+interface RegexPattern {
+  /**
+   * Human-readable message for matches.
+   *
+   * @example "TODO comment found"
+   *
+   * @example "console.log statement"
+   *
+   * @example (match) => `Found TODO at line ${match.index + 1}`
+   */
+  message?: ((match: RegExpExecArray) => string) | string;
+  /**
+   * The regex pattern to match.
+   *
+   * @example /\/\/\s*TODO:/gi
+   *
+   * @example /console\.log/g
+   */
+  pattern: RegExp;
+  /**
+   * Rule identifier for this pattern.
+   * If not provided, uses the pattern source as the rule ID.
+   *
+   * @example "no-todos"
+   *
+   * @example "no-console-log"
+   */
+  rule?: string;
+}
+/**
+ * Configuration for regex pattern matching check.
+ */
+interface RegexCheckConfig {
+  /**
+   * Concurrency for processing files.
+   *
+   * @default 10
+   */
+  concurrency?: number;
+  /**
+   * Array of glob patterns for files to check.
+   *
+   * @example ["src/**\/*.ts", "lib/**\/*.js"]
+   */
+  files: string[];
+  /**
+   * Array of glob patterns to ignore.
+   *
+   * @default ["**\/node_modules/**", "**\/dist/**", "**\/.git/**"]
+   */
+  ignore?: string[];
+  /**
+   * Array of regex patterns to match.
+   */
+  patterns: RegexPattern[];
+}
+type CustomCheckConfig = Record<string, unknown> & {
+  type: string;
+};
+type CheckConfig = (ESLintCheckConfig & {
+  type: "eslint";
+}) | (TypeScriptCheckConfig & {
+  type: "typescript";
+}) | CustomCheckConfig;
+/**
+ * A check object that can be passed to mejora().
+ * Created by factory functions like eslint(), typescript(), regex(), or defineCheck().
+ */
+interface Check {
+  /**
+   * Internal factory for creating the check runner.
+   * Used by defineConfig() for auto-registration.
+   *
+   * @internal
+   */
+  __runnerFactory?: () => CheckRunner;
+  /**
+   * The underlying check configuration.
+   */
+  config: CheckConfig;
+  /**
+   * Unique identifier for this check.
+   * Used in baseline tracking and output.
+   */
+  id: string;
+}
+/**
+ * mejora configuration.
+ *
+ * Define checks to run and track for regressions.
+ *
+ * @example
+ * ```ts
+ * import { defineConfig, eslint, typescript } from "mejora";
+ *
+ * export default defineConfig({
+ *   checks: [
+ *     eslint({
+ *       name: "no-nested-ternary",
+ *       files: ["src/**\/*.{ts,tsx}"],
+ *       rules: {
+ *         "no-nested-ternary": "error",
+ *       },
+ *     }),
+ *     typescript({
+ *       name: "strict",
+ *       compilerOptions: {
+ *         noImplicitAny: true,
+ *       },
+ *     }),
+ *   ]
+ * });
+ * ```
+ */
+interface Config {
+  /**
+   * Array of checks to run.
+   */
+  checks: Check[];
+  /**
+   * Optional custom check runners.
+   */
+  runners?: CheckRunner[];
+}
+/**
+ * Interface that all check runners must implement.
+ *
+ * Each check type (eslint, typescript, custom) implements this interface
+ * to provide consistent lifecycle hooks for execution.
+ */
+interface CheckRunner<TConfig = unknown> {
+  /**
+   * Execute the check and return a snapshot of issues.
+   *
+   * @param config - Check-specific configuration
+   *
+   * @returns Snapshot containing all issues found
+   */
+  run(config: TConfig): Promise<RawSnapshot>;
+  /**
+   * Setup any infrastructure needed for this check.
+   * Called once during runner setup, in parallel with other checks.
+   *
+   * Examples: creating cache directories, initializing compilation state.
+   *
+   * Optional - not all checks need infrastructure setup.
+   */
+  setup?(): Promise<void>;
+  /**
+   * Unique identifier for this check type.
+   * Must match the `type` field in CheckConfig.
+   *
+   * @example "eslint"
+   *
+   * @example "typescript"
+   */
+  readonly type: string;
+  /**
+   * Validate that all dependencies for this check are available.
+   * Called once during runner setup before any checks execute.
+   *
+   * Should throw a descriptive error if dependencies are missing.
+   *
+   * @throws {Error} If required dependencies are not installed
+   */
+  validate?(): Promise<void>;
+}
+/**
+ * Custom check definition for defineCheck().
+ */
+interface CustomCheckDefinition<TConfig extends Record<string, unknown> = Record<string, unknown>> {
+  /**
+   * Optional default configuration values.
+   * These will be merged with user-provided config.
+   */
+  defaults?: Partial<TConfig>;
+  /**
+   * Execute the check and return violations.
+   *
+   * @param config - The full check configuration object
+   *
+   * @returns Array of violations found
+   */
+  run(config: TConfig): Promise<IssueInput[]>;
+  /**
+   * Setup any infrastructure needed for this check type.
+   * Called once per type during runner setup, in parallel with other checks.
+   *
+   * Examples: creating cache directories, initializing compilation state.
+   *
+   * Optional - not all checks need infrastructure setup.
+   */
+  setup?(): Promise<void>;
+  /**
+   * Unique identifier for this check type.
+   * Multiple check instances can share the same type and runner.
+   *
+   * @example "eslint"
+   *
+   * @example "typescript"
+   *
+   * @example "no-hardcoded-urls"
+   */
+  type: string;
+  /**
+   * Validate that all dependencies for this check type are available.
+   * Called once per type during runner setup before any checks execute.
+   *
+   * Should throw a descriptive error if dependencies are missing.
+   *
+   * @throws {Error} If required dependencies are not installed
+   */
+  validate?(): Promise<void>;
+}
+//#endregion
+//#region src/core/config.d.ts
+/**
+ * Define a mejora configuration.
+ *
+ * @param config - Configuration object
+ *
+ * @param config.checks - Array of checks to run
+ *
+ * @returns A mejora configuration object
+ *
+ * @example
+ * ```ts
+ * import { defineConfig, eslint, typescript, regex } from "mejora";
+ *
+ * export default defineConfig({
+ *   checks: [
+ *     eslint({
+ *       name: "no-console",
+ *       files: ["src/**\/*.ts"],
+ *       rules: { "no-console": "error" }
+ *     }),
+ *     typescript({
+ *       name: "strict",
+ *       compilerOptions: { noImplicitAny: true }
+ *     }),
+ *     regex({
+ *       name: "no-todos",
+ *       files: ["**\/*"],
+ *       patterns: [{ pattern: /TODO/g }]
+ *     })
+ *   ]
+ * });
+ * ```
+ */
+declare function defineConfig(config: {
+  checks: Check[];
+}): {
+  checks: Check[];
+  runners: CheckRunner<unknown>[];
+};
+//#endregion
+//#region src/core/define-check.d.ts
+/**
+ * Configuration for a check instance, combining the check-specific config
+ * with required metadata fields.
+ */
+type UserCheckConfig<TConfig> = TConfig & {
+  /**
+   * Unique identifier for this check instance.
+   * Used in baseline tracking and output.
+   */
+  name: string;
+};
+/**
+ * Define a custom check for use with mejora().
+ *
+ * This is the primitive used by all checks (built-in and custom) to create
+ * reusable check definitions. Multiple check instances with the same type
+ * share a single runner for optimal performance.
+ *
+ * @param definition - Custom check definition with type, run function, and optional hooks.
+ *
+ * @returns A factory function that creates Check objects with different configurations.
+ *
+ * @example
+ * ```ts
+ * import { defineConfig, defineCheck } from "mejora";
+ *
+ * const noHardcodedUrls = defineCheck<{ files: string[] }>({
+ *   type: "no-hardcoded-urls",
+ *   async run(config) {
+ *     const violations: IssueInput[] = [];
+ *     // Custom checking logic using config.files
+ *     return violations;
+ *   }
+ * });
+ *
+ * export default defineConfig({
+ *   checks: [
+ *     noHardcodedUrls({ name: "urls-in-src", files: ["src/**\/*.ts"] }),
+ *     noHardcodedUrls({ name: "urls-in-lib", files: ["lib/**\/*.ts"] }),
+ *   ]
+ * });
+ * ```
+ */
+declare function defineCheck<TConfig extends Record<string, any> = Record<string, any>>(definition: CustomCheckDefinition<TConfig>): (userConfig: UserCheckConfig<TConfig>) => Check;
+//#endregion
+//#region src/runners/eslint.d.ts
+/**
+ * Create an ESLint check for use with mejora().
+ *
+ * @param config - ESLint check configuration options including name.
+ *
+ * @returns A Check object for use with mejora().
+ *
+ * @example
+ * ```ts
+ * import { defineConfig, eslint } from "mejora";
+ *
+ * export default defineConfig({
+ *   checks: [
+ *     eslint({
+ *       name: "no-console",
+ *       files: ["src/**\/*.ts"],
+ *       rules: { "no-console": "error" }
+ *     })
+ *   ]
+ * });
+ * ```
+ */
+declare const eslint: (userConfig: ESLintCheckConfig & {
+  name: string;
+}) => Check;
+//#endregion
+//#region src/runners/regex.d.ts
+/**
+ * Create a regex check for use with mejora().
+ *
+ * @param config - Regex check configuration options including name.
+ *
+ * @returns A Check object for use with mejora().
+ *
+ * @example
+ * ```ts
+ * import { defineConfig, regex } from "mejora";
+ *
+ * export default defineConfig({
+ *   checks: [
+ *     regex({
+ *       name: "no-todos",
+ *       files: ["src/**\/*.ts"],
+ *       patterns: [
+ *         { pattern: /TODO/g, message: "TODO comment found" }
+ *       ]
+ *     })
+ *   ]
+ * });
+ * ```
+ */
+declare const regex: (userConfig: RegexCheckConfig & {
+  name: string;
+}) => Check;
+//#endregion
+//#region src/runners/typescript.d.ts
+/**
+ * Create a TypeScript check for use with mejora().
+ *
+ * @param config - TypeScript check configuration options including name.
+ *
+ * @returns A Check object for use with mejora().
+ *
+ * @example
+ * ```ts
+ * import { defineConfig, typescript } from "mejora";
+ *
+ * export default defineConfig({
+ *   checks: [
+ *     typescript({
+ *       name: "strict-types",
+ *       compilerOptions: { noImplicitAny: true }
+ *     })
+ *   ]
+ * });
+ * ```
+ */
+declare const typescript: (userConfig: TypeScriptCheckConfig & {
+  name: string;
+}) => Check;
+//#endregion
+export { defineConfig as a, Config as c, RawSnapshot as d, Snapshot as f, defineCheck as i, Issue as l, regex as n, Check as o, eslint as r, CheckRunner as s, typescript as t, IssueInput as u };

package/dist/index.d.mts

@@ -1,2 +1,2 @@
-import { a as eslintCheck, c as Issue, d as Snapshot, i as regexRunner, l as IssueInput, n as typescriptCheck, o as CheckRunner, r as regexCheck, s as Config, t as defineConfig, u as RawSnapshot } from "./index-BHX-tY_Y.mjs";
-export { CheckRunner, Config, Issue, IssueInput, RawSnapshot, Snapshot, defineConfig, eslintCheck as eslint, eslintCheck, regexCheck as regex, regexCheck, regexRunner, typescriptCheck as typescript, typescriptCheck };
+import { a as defineConfig, c as Config, d as RawSnapshot, f as Snapshot, i as defineCheck, l as Issue, n as regex, o as Check, r as eslint, s as CheckRunner, t as typescript, u as IssueInput } from "./index-BNOgTD7N.mjs";
+export { Check, CheckRunner, Config, Issue, IssueInput, RawSnapshot, Snapshot, defineCheck, defineConfig, eslint, regex, typescript };

package/dist/index.mjs

@@ -1 +1,3 @@
-import{a as e,f as t,i as n,n as r,s as i}from"./typescript-BG8_PZiP.mjs";export{t as defineConfig,i as eslint,i as eslintCheck,n as regex,n as regexCheck,e as regexRunner,r as typescript,r as typescriptCheck};
+import{t as e}from"./config-C0qrgNuO.mjs";import{a as t,c as n,i as r,o as i,s as a,t as o}from"./hash-BaLFZO2A.mjs";import{glob as s,mkdir as c,readFile as l,stat as u,writeFile as d}from"node:fs/promises";import{createReadStream as f}from"node:fs";import{createInterface as p}from"node:readline/promises";function m(e){let{defaults:t,type:n}=e,r=()=>{let t={async run(t){let{type:n,...r}=t;return{items:await e.run(r),type:`items`}},type:n};return e.setup&&(t.setup=e.setup),e.validate&&(t.validate=e.validate),t};return e=>{let{name:i,...a}=e;return{__runnerFactory:r,config:{type:n,...t,...a},id:i}}}function h(){let e=new WeakSet;return(t,n)=>{if(n&&typeof n==`object`){if(e.has(n))return`[Circular]`;if(e.add(n),!Array.isArray(n)){let e=n,t={};for(let n of Object.keys(e).toSorted()){let r=e[n];typeof r==`function`||typeof r==`symbol`||(t[n]=r)}return t}}return n}}function g(e){return o(JSON.stringify(e??null,h()))}function _(e,t=process.cwd()){return a(t,`node_modules`,`.cache`,`mejora`,e)}async function v(e){try{let t=await l(e,`utf8`);return JSON.parse(t)}catch{return{}}}async function y(e,t){try{await d(e,JSON.stringify(t,null,2),`utf8`)}catch{}}async function b(e){try{let t=await u(e);return`${t.mtimeMs}-${t.size}`}catch{return null}}const x=m({async run(e){let{ESLint:t}=await import(`eslint`),n=process.cwd(),r=_(`eslint`,n),a=g(e),{concurrency:o,files:s,...c}=e,l=new Set;if(c.rules)for(let e of Object.keys(c.rules))l.add(e);let u=l.size>0,d=await new t({cache:!0,cacheLocation:`${r}/${a}.eslintcache`,overrideConfig:c,...!u&&{concurrency:o??`auto`},...u&&{ruleFilter:({ruleId:e})=>l.has(e)}}).lintFiles(s),f=[];for(let{filePath:e,messages:t}of d){let r=i(n,e);for(let{column:e,line:n,message:i,ruleId:a}of t)a&&f.push({column:e,file:r,line:n,message:i,rule:a})}return f},async setup(){let e=_(`eslint`,process.cwd()),{mkdir:t}=await import(`node:fs/promises`);await t(e,{recursive:!0})},type:`eslint`,async validate(){try{await import(`eslint`)}catch{throw Error(`eslint check requires "eslint" package to be installed. Run: npm install eslint`)}}}),S=[`**/node_modules/**`,`**/dist/**`,`**/.git/**`];function C(e,t){if(t?.length)return t;let n=e.map(e=>/^([^*]+\/)/.exec(e)?.[1]).filter(e=>e!==void 0);return[...S,...n.flatMap(e=>S.map(t=>t.replace(/^\*\*\//,e)))]}async function w(e,t,n){let r=Array.from({length:e.length}),i=0;return await Promise.all(Array.from({length:Math.min(t,e.length)},async()=>{for(;i<e.length;){let t=i++;r[t]=await n(e[t])}})),r}const T=m({async run(e){let n=process.cwd(),r=Array.isArray(e.files)?e.files:[e.files],i=C(r,e.ignore),a=new Set;for(let e of r){let t=s(e,{cwd:n,exclude:i});for await(let e of t)a.add(e)}let o=[...a],c=e.patterns.map(({message:e,pattern:t,rule:n})=>{let r=t.flags.includes(`g`)?t.flags:`${t.flags}g`;return{message:e,regex:new RegExp(t.source,r),ruleText:n??t.source}}),l=t(_(`regex`,n),`${g(e)}.json`),u=await v(l),d={},m=await w(o,e.concurrency??10,async e=>{let r=t(n,e),i=await b(r);if(!i)return[];let a=u[e];if(a?.hash===i)return d[e]=a,a.items;try{let t=[],n=p({crlfDelay:1/0,input:f(r,{encoding:`utf8`})}),a=0;try{for await(let r of n){a++;for(let n of c){n.regex.lastIndex=0;let i;for(;(i=n.regex.exec(r))!==null;){let r=i.index+1,o=typeof n.message==`function`?n.message(i):n.message??`Pattern matched: ${i[0]}`;t.push({column:r,file:e,line:a,message:o,rule:n.ruleText})}}}}finally{n.close()}return d[e]={hash:i,items:t},t}catch{return[]}}),h=[];for(let e of m)h.push(...e);return await y(l,d),h},async setup(){await c(_(`regex`,process.cwd()),{recursive:!0})},type:`regex`});function E(e,t){return e.replaceAll(/import\("([^"]+)"\)/g,(e,n)=>{try{if(r(n)){let e=i(t,n);if(!e.startsWith(`..`))return`import("${e||`.`}")`}}catch{}return e})}const D=m({async run(e){let{createIncrementalCompilerHost:t,createIncrementalProgram:r,findConfigFile:o,flattenDiagnosticMessageText:s,getPreEmitDiagnostics:c,parseJsonConfigFileContent:l,readConfigFile:u,sys:d,version:f}=await import(`typescript`),p=process.cwd(),m=d.fileExists.bind(d),h=d.readFile.bind(d),v=e.tsconfig?a(e.tsconfig):o(p,m,`tsconfig.json`);if(!v)throw Error(`TypeScript config file not found`);let{config:y,error:b}=u(v,h);if(b){let e=typeof b.messageText==`string`?b.messageText:s(b.messageText,`
+`);throw TypeError(`Failed to read TypeScript config: ${e}`)}let x=l(y,d,p,e.compilerOptions),S=a(_(`typescript`,p),`${g({compilerOptions:e.compilerOptions??{},configPath:v,parsedOptions:x.options,typescriptVersion:f})}.tsbuildinfo`),C={...x.options,incremental:!0,noEmit:!0,skipLibCheck:x.options.skipLibCheck??!0,tsBuildInfoFile:S},w=t(C,d),T=w.writeFile.bind(w);w.writeFile=(e,t,...n)=>{a(e)===S&&T(e,t,...n)};let D=r({host:w,options:C,projectReferences:x.projectReferences??[],rootNames:x.fileNames}),O=c(D.getProgram());D.emit();let k=a(p),A=k+n,j=O.filter(e=>{if(!e.file)return!0;let t=a(e.file.fileName);return t===k||t.startsWith(A)}),M=[];for(let e of j){let t=s(e.messageText,`
+`),n=`TS${e.code}`;if(e.file&&e.start!==void 0){let{character:r,line:a}=e.file.getLineAndCharacterOfPosition(e.start),o=i(p,e.file.fileName);M.push({column:r+1,file:o,line:a+1,message:E(t,p),rule:n})}else M.push({column:0,file:`(global)`,line:0,message:E(t,p),rule:n})}return M},async setup(){let e=_(`typescript`,process.cwd()),{mkdir:t}=await import(`node:fs/promises`);await t(e,{recursive:!0})},type:`typescript`,async validate(){try{await import(`typescript`)}catch{throw Error(`typescript check requires "typescript" package to be installed. Run: npm install typescript`)}}});export{m as defineCheck,e as defineConfig,x as eslint,T as regex,D as typescript};

package/dist/run.mjs

@@ -1,8 +1,8 @@
 #!/usr/bin/env node
-import{c as e,d as t,l as n,p as r,u as i}from"./typescript-BG8_PZiP.mjs";import{t as a}from"./check-registry-D0NGvrkK.mjs";import{fileURLToPath as o}from"node:url";import{mkdir as s,readFile as c,writeFile as l}from"node:fs/promises";import{inspect as u,parseArgs as d,styleText as f}from"node:util";import{Worker as p}from"node:worker_threads";import{env as m}from"node:process";const h=e=>t=>f(e,typeof t==`number`?t.toString():t),g=h(`blue`),_=h(`bold`),v=h(`cyan`),y=h(`dim`),b=h(`green`),x=h(`red`),S=h(`gray`),ee=h(`underline`),te=h(`yellow`);function ne(e){let t=[e.message];if(e.stack){let n=e.stack.split(`
+import{n as e}from"./config-C0qrgNuO.mjs";import{n as t,o as n,r,t as i}from"./hash-BaLFZO2A.mjs";import{t as a}from"./check-registry-mjn8FfPF.mjs";import{fileURLToPath as o}from"node:url";import{mkdir as s,readFile as c,writeFile as l}from"node:fs/promises";import{inspect as u,parseArgs as d,styleText as f}from"node:util";import{Worker as p}from"node:worker_threads";import{env as m}from"node:process";const h=e=>t=>f(e,typeof t==`number`?t.toString():t),g=h(`blue`),_=h(`bold`),v=h(`cyan`),y=h(`dim`),b=h(`green`),x=h(`red`),S=h(`gray`),ee=h(`underline`),te=h(`yellow`);function ne(e){let t=[e.message];if(e.stack){let n=e.stack.split(`
 `).slice(1).map(e=>y(e.trim())).join(`
 `);t.push(n)}return t.join(`
-`)}function C(...e){return e.map(e=>typeof e==`string`?e:e instanceof Error?ne(e):u(e,{colors:!1,depth:10})).join(` `)}const w={error:(...e)=>{console.error(x(`✖`),C(...e))},log:(...e)=>{console.log(C(...e))},start:(...e)=>{console.log(v(`◐`),C(...e))},success:(...e)=>{console.log(b(`✔`),C(...e))}};function T(e,t){return e.file===t.file?e.line===t.line?e.column-t.column:e.line-t.line:e.file.localeCompare(t.file)}function re(t){let n=Map.groupBy(t,e=>e.signature),r=[];for(let[t,i]of n){i.sort(T);for(let[n,{signature:a,...o}]of i.entries())r.push({...o,id:e(`${t}:${n}`)})}return r}function E(e){return{items:re(e.items.map(e=>({...e,signature:`${e.file} - ${e.rule}: ${e.message}`}))).toSorted(T),type:`items`}}function D(e,t){return e===1?t:`${t}s`}const O=`__unparsable__`;function k(e){return e.replaceAll(`<`,`&lt;`).replaceAll(`>`,`&gt;`).replaceAll(`[`,`&#91;`).replaceAll(`]`,`&#93;`)}function A(e,n,r){let i=t(n,e);return r?`${i}#L${r}`:i}function j(e,t){return`[${e}](${t})`}function ie(e,t){let n=A(e.file,t,e.line);return`- ${j(e.line?`Line ${e.line}`:e.file,n)} - ${`${e.rule}: ${k(e.message)}`}`}function ae(e){let t=Object.groupBy(e,e=>e.file||O);return Object.entries(t).map(([e,t=[]])=>({filePath:e,items:t})).toSorted((e,t)=>e.filePath===O?1:t.filePath===O?-1:e.filePath.localeCompare(t.filePath))}function oe(e,t){let n=e.length,r=D(n,`issue`),i=[`\n### Other Issues · ${t}\n`];for(let t of e)i.push(`- ${t.rule}: ${k(t.message)}`);return i.push(`\n${n} ${r} in Other Issues`,``),i.join(`
+`)}function C(...e){return e.map(e=>typeof e==`string`?e:e instanceof Error?ne(e):u(e,{colors:!1,depth:10})).join(` `)}const w={error:(...e)=>{console.error(x(`✖`),C(...e))},log:(...e)=>{console.log(C(...e))},start:(...e)=>{console.log(v(`◐`),C(...e))},success:(...e)=>{console.log(b(`✔`),C(...e))}};function T(e,t){return e.file===t.file?e.line===t.line?e.column-t.column:e.line-t.line:e.file.localeCompare(t.file)}function re(e){let t=Map.groupBy(e,e=>e.signature),n=[];for(let[e,r]of t){r.sort(T);for(let[t,{signature:a,...o}]of r.entries())n.push({...o,id:i(`${e}:${t}`)})}return n}function E(e){return{items:re(e.items.map(e=>({...e,signature:`${e.file} - ${e.rule}: ${e.message}`}))).toSorted(T),type:`items`}}function D(e,t){return e===1?t:`${t}s`}const O=`__unparsable__`;function k(e){return e.replaceAll(`<`,`&lt;`).replaceAll(`>`,`&gt;`).replaceAll(`[`,`&#91;`).replaceAll(`]`,`&#93;`)}function A(e,t,r){let i=n(t,e);return r?`${i}#L${r}`:i}function j(e,t){return`[${e}](${t})`}function ie(e,t){let n=A(e.file,t,e.line);return`- ${j(e.line?`Line ${e.line}`:e.file,n)} - ${`${e.rule}: ${k(e.message)}`}`}function ae(e){let t=Object.groupBy(e,e=>e.file||O);return Object.entries(t).map(([e,t=[]])=>({filePath:e,items:t})).toSorted((e,t)=>e.filePath===O?1:t.filePath===O?-1:e.filePath.localeCompare(t.filePath))}function oe(e,t){let n=e.length,r=D(n,`issue`),i=[`\n### Other Issues · ${t}\n`];for(let t of e)i.push(`- ${t.rule}: ${k(t.message)}`);return i.push(`\n${n} ${r} in Other Issues`,``),i.join(`
 `)}function M(e,t,n){if(e.filePath===O)return oe(e.items,n);let r=A(e.filePath,t),i=j(e.filePath,r),a=e.items.length,o=D(a,`issue`),s=[`\n### ${i} · ${n}\n`];for(let n of e.items)s.push(ie(n,t));return s.push(`\n${a} ${o} in ${e.filePath}`,``),s.join(`
 `)}function se(e,t,n){let r=t.length,i=D(r,`issue`),a=[`\n## ${e}\n`];if(t.length===0)return a.push(`No issues`),a.join(`
 `);let o=ae(t);for(let t of o)a.push(M(t,n,e));return a.push(`---\n${r} total ${i} for ${e}`),a.join(`
@@ -16,7 +16,7 @@ import{c as e,d as t,l as n,p as r,u as i}from"./typescript-BG8_PZiP.mjs";import
 }`.repeat(t)}`}function fe(e){let t=(e.match(/\{/g)?.length??0)-(e.match(/\}/g)?.length??0);return t===0?e:t<0?V(e,-t):H(e,t)}function pe(e){try{return JSON.parse(e)}catch{return}}function U(e){let t=e.trim();return t.endsWith(`,`)?t.slice(0,-1):t}function me(e){return`{
   "version": 2,
   ${U(e)}
-}`}function W(e){if(typeof e!=`object`||!e)throw TypeError(`Baseline must be an object`);if(`checks`in e&&e.checks&&typeof e.checks==`object`)return{checks:e.checks,version:2};let t={};for(let[n,r]of Object.entries(e))n!==`version`&&(t[n]=r);return{checks:t,version:2}}function G(e){try{let t=pe(e.trim());if(t)return W(t);let n=me(fe(U(e)));return W(JSON.parse(n))}catch(e){let t=e instanceof Error?e.message:String(e);throw Error(`Failed to parse baseline during conflict resolution: ${t}`,{cause:e})}}function he(e){let t=[...e.matchAll(/<<<<<<< .*\n([\s\S]*?)\n=======\n([\s\S]*?)\n>>>>>>> .*$/gm)];if(t.length===0)throw Error(`Could not parse conflict markers in baseline`);return t.map(([,e=``,t=``])=>({ours:e,theirs:t}))}function ge(e){let t=new Map;for(let n of e)for(let[e,{items:r=[]}]of Object.entries(n.checks)){if(r.length===0)continue;let n=t.get(e);n||(n=new Map,t.set(e,n));for(let e of r)n.set(e.id,e)}let n={};for(let[e,r]of t)n[e]={items:[...r.values()].toSorted((e,t)=>e.id.localeCompare(t.id)),type:`items`};return{checks:n,version:2}}function _e(e){let t=he(e),n=[];for(let{ours:e,theirs:r}of t)n.push(G(e),G(r));return ge(n)}var K=class e{baselinePath;constructor(e=`.mejora/baseline.json`){this.baselinePath=e}static create(e){return{checks:e,version:2}}static getEntry(e,t){return e?.checks[t]}static update(t,n,r){let i=t??e.create({}),a=i.checks[n];return B(r,a)?i:{...i,checks:{...i.checks,[n]:r}}}async load(){try{let e=await c(this.baselinePath,`utf8`);if(e.includes(`<<<<<<<`)){w.start(`Merge conflict detected in baseline, auto-resolving...`);let t=_e(e);return await this.save(t,!0),w.success(`Baseline conflict resolved`),t}return await this.resolveMarkdownConflictIfNeeded(e),JSON.parse(e)}catch(e){if(e.code===`ENOENT`)return null;throw e}}async save(e,t=!1){if(le&&!t)return;let n=`${JSON.stringify(e,null,2)}\n`,r=this.baselinePath.replace(`.json`,`.md`),a=N(e,i(this.baselinePath));await s(i(this.baselinePath),{recursive:!0}),await Promise.all([l(this.baselinePath,n,`utf8`),l(r,a,`utf8`)])}async resolveMarkdownConflictIfNeeded(e){let t=this.baselinePath.replace(`.json`,`.md`);try{(await c(t,`utf8`)).includes(`<<<<<<<`)&&(w.start(`Merge conflict detected in markdown report, regenerating...`),await l(t,N(JSON.parse(e),i(this.baselinePath)),`utf8`),w.success(`Markdown report regenerated`))}catch{}}};const ve=o(new URL(`workers/check.mjs`,import.meta.url));var ye=class e{baselineManager;registry;constructor(e,t){this.registry=e,this.baselineManager=new K(t)}static async executeChecksParallel(t,n){let r=Object.keys(t);try{let t=r.map(async t=>{let r=await e.executeWorker(t),i=E(r.snapshot),a=K.getEntry(n,t),o=z(i,a);return{baseline:a,checkId:t,duration:r.duration,hasImprovement:o.hasImprovement,hasRegression:o.hasRegression,hasRelocation:o.hasRelocation,isInitial:o.isInitial,newIssues:o.newIssues,removedIssues:o.removedIssues,snapshot:i}});return await Promise.all(t)}catch(e){return w.error(`Parallel execution failed:`,e),null}}static async executeWorker(e){return new Promise((t,n)=>{let r=new p(ve,{workerData:{checkId:e}});r.on(`message`,t),r.on(`error`,n),r.on(`exit`,e=>{e!==0&&n(Error(`Worker stopped with exit code ${e}`))})})}static filterChecks=(t,n)=>{let r=n.only?e.resolveRegex(n.only,`--only`):null,i=n.skip?e.resolveRegex(n.skip,`--skip`):null;return!r&&!i?t:Object.fromEntries(Object.entries(t).filter(([e])=>!(r&&!r.test(e)||i?.test(e))))};static resolveRegex(e,t){try{return new RegExp(e)}catch{throw Error(`Invalid regex pattern for ${t}: "${e}"`)}}async run(t,n={}){let r=performance.now(),i=await this.baselineManager.load(),a=e.filterChecks(t.checks,n),o=Object.keys(a).length;w.start(`Running ${o} check${o===1?``:`s`}...`);let s=o>1?await e.executeChecksParallel(a,i):await this.executeChecksSequential(a,i);if(!s)return{exitCode:2,hasImprovement:!1,hasRegression:!0,results:[],totalDuration:performance.now()-r};let c=i,l=!1,u=!1,d=!1;for(let e of s)e.hasRegression&&(l=!0),e.hasImprovement&&(u=!0),e.isInitial&&(d=!0),(e.hasImprovement||e.hasRelocation||n.force||e.isInitial)&&(c=K.update(c,e.checkId,{items:e.snapshot.items,type:e.snapshot.type}));return c&&c!==i&&(!l||n.force||d)&&await this.baselineManager.save(c,n.force),{exitCode:l&&!n.force?1:0,hasImprovement:u,hasRegression:l,results:s,totalDuration:performance.now()-r}}async executeChecksSequential(e,t){try{let t=a.getRequiredTypes(e);await Promise.all([this.registry.setup(t),this.registry.validate(t)])}catch(e){return w.error(`Setup failed:`,e),null}let n=[];for(let[r,i]of Object.entries(e))try{let e=performance.now(),a=await this.registry.get(i.type).run(i),o=performance.now()-e,s=E(a),c=K.getEntry(t,r),l=z(s,c);n.push({baseline:c,checkId:r,duration:o,hasImprovement:l.hasImprovement,hasRegression:l.hasRegression,hasRelocation:l.hasRelocation,isInitial:l.isInitial,newIssues:l.newIssues,removedIssues:l.removedIssues,snapshot:s})}catch(e){return w.error(`Error running check "${r}":`,e),null}return n}};function q(e,t){if(!(e===void 0||t===0))return e/t}function be(e){let{results:t,totalDuration:n}=e,r=t.length,i=[],a=[],o=[],s=[],c=0,l=0,u=0,d=0,f=0,p=[];for(let e of t){let t=e.snapshot.items.length;f+=t,e.isInitial?(u+=t,o.push(e.checkId)):(e.hasImprovement&&(c+=e.removedIssues.length,i.push(e.checkId)),e.hasRegression&&(l+=e.newIssues.length,a.push(e.checkId)),!e.hasImprovement&&!e.hasRegression&&(d+=t,s.push(e.checkId))),p.push({checkId:e.checkId,duration:e.duration,hasImprovement:e.hasImprovement,hasRegression:e.hasRegression,isInitial:e.isInitial,newIssues:e.newIssues,removedIssues:e.removedIssues,totalIssues:t})}let m={checks:p,exitCode:e.exitCode,hasImprovement:e.hasImprovement,hasRegression:e.hasRegression,summary:{avgDuration:q(n,r),checksRun:r,improvementChecks:i,improvements:c,initial:u,initialChecks:o,regressionChecks:a,regressions:l,totalIssues:f,unchanged:d,unchangedChecks:s},totalDuration:n};return JSON.stringify(m,null,2)}function xe(e){if(e<1e3)return`${e}ms`;let t=e/1e3;if(t<60)return t%1==0?`${t}s`:`${t.toFixed(1)}s`;let n=e/6e4;if(n<60)return n%1==0?`${n}m`:`${n.toFixed(1)}m`;let r=e/36e5;return r%1==0?`${r}h`:`${r.toFixed(1)}h`}function J(e){let t=Math.round(e);return t<1?`<1ms`:xe(t)}const Y=`     `,Se=`${Y}  `;function Ce(e){return e===`initial`?y(`→`):e===`improvement`?b(`↑`):x(`↓`)}function we(e,t,r){let a=i(e),o=n(e),s=t>0?`:${t}:${r>0?r:1}`:``;return`${a===`.`?``:y(`${a}/`)}${ee(o)}${s?y(s):``}`}function Te(e,t){return[`${Ce(t)} ${we(e.file,e.line,e.column)}  ${y(e.rule)}`,e.message]}function X(e,t){let n=[],r=e.slice(0,10);for(let e of r){let[r,i]=Te(e,t);n.push(`${Y}${r}`,`${Se}${i}`)}let i=e.length-r.length;return i>0&&n.push(`${Y}${y(`... and ${i} more`)}`),n}function Ee(e){return e===void 0?[]:[`  ${y(`Duration`)}  ${J(e)}`]}function De(e){return[`    ${y(`Issues`)}  ${_(e)}`]}function Z(e){return[...Ee(e.duration),...De(e.snapshot.items.length)]}function Oe(e){if(!e.hasRegression)return[];let t=e.newIssues.length;return[`  ${x(t)} new ${D(t,`issue`)} (${D(t,`regression`)}):`,...X(e.newIssues,`regression`)]}function Q(e){if(!e.hasImprovement)return[];let t=e.removedIssues.length;return[`  ${b(t)} ${D(t,`issue`)} fixed (${D(t,`improvement`)}):`,...X(e.removedIssues,`improvement`)]}function ke(e,t){let n=t?``:`
+}`}function W(e){if(typeof e!=`object`||!e)throw TypeError(`Baseline must be an object`);if(`checks`in e&&e.checks&&typeof e.checks==`object`)return{checks:e.checks,version:2};let t={};for(let[n,r]of Object.entries(e))n!==`version`&&(t[n]=r);return{checks:t,version:2}}function G(e){try{let t=pe(e.trim());if(t)return W(t);let n=me(fe(U(e)));return W(JSON.parse(n))}catch(e){let t=e instanceof Error?e.message:String(e);throw Error(`Failed to parse baseline during conflict resolution: ${t}`,{cause:e})}}function he(e){let t=[...e.matchAll(/<<<<<<< .*\n([\s\S]*?)\n=======\n([\s\S]*?)\n>>>>>>> .*$/gm)];if(t.length===0)throw Error(`Could not parse conflict markers in baseline`);return t.map(([,e=``,t=``])=>({ours:e,theirs:t}))}function ge(e){let t=new Map;for(let n of e)for(let[e,{items:r=[]}]of Object.entries(n.checks)){if(r.length===0)continue;let n=t.get(e);n||(n=new Map,t.set(e,n));for(let e of r)n.set(e.id,e)}let n={};for(let[e,r]of t)n[e]={items:[...r.values()].toSorted((e,t)=>e.id.localeCompare(t.id)),type:`items`};return{checks:n,version:2}}function _e(e){let t=he(e),n=[];for(let{ours:e,theirs:r}of t)n.push(G(e),G(r));return ge(n)}var K=class e{baselinePath;constructor(e=`.mejora/baseline.json`){this.baselinePath=e}static create(e){return{checks:e,version:2}}static getEntry(e,t){return e?.checks[t]}static update(t,n,r){let i=t??e.create({}),a=i.checks[n];return B(r,a)?i:{...i,checks:{...i.checks,[n]:r}}}async load(){try{let e=await c(this.baselinePath,`utf8`);if(e.includes(`<<<<<<<`)){w.start(`Merge conflict detected in baseline, auto-resolving...`);let t=_e(e);return await this.save(t,!0),w.success(`Baseline conflict resolved`),t}return await this.resolveMarkdownConflictIfNeeded(e),JSON.parse(e)}catch(e){if(e.code===`ENOENT`)return null;throw e}}async save(e,t=!1){if(le&&!t)return;let n=`${JSON.stringify(e,null,2)}\n`,i=this.baselinePath.replace(`.json`,`.md`),a=N(e,r(this.baselinePath));await s(r(this.baselinePath),{recursive:!0}),await Promise.all([l(this.baselinePath,n,`utf8`),l(i,a,`utf8`)])}async resolveMarkdownConflictIfNeeded(e){let t=this.baselinePath.replace(`.json`,`.md`);try{(await c(t,`utf8`)).includes(`<<<<<<<`)&&(w.start(`Merge conflict detected in markdown report, regenerating...`),await l(t,N(JSON.parse(e),r(this.baselinePath)),`utf8`),w.success(`Markdown report regenerated`))}catch{}}};const ve=o(new URL(`workers/check.mjs`,import.meta.url));var ye=class e{baselineManager;registry;constructor(e,t){this.registry=e,this.baselineManager=new K(t)}static async executeChecksParallel(t,n){try{let r=t.map(async t=>{let r=await e.executeWorker(t.id),i=E(r.snapshot),a=K.getEntry(n,t.id),o=z(i,a);return{baseline:a,checkId:t.id,duration:r.duration,hasImprovement:o.hasImprovement,hasRegression:o.hasRegression,hasRelocation:o.hasRelocation,isInitial:o.isInitial,newIssues:o.newIssues,removedIssues:o.removedIssues,snapshot:i}});return await Promise.all(r)}catch(e){return w.error(`Parallel execution failed:`,e),null}}static async executeWorker(e){return new Promise((t,n)=>{let r=new p(ve,{workerData:{checkId:e}});r.on(`message`,t),r.on(`error`,n),r.on(`exit`,e=>{e!==0&&n(Error(`Worker stopped with exit code ${e}`))})})}static filterChecks=(t,n)=>{let r=n.only?e.resolveRegex(n.only,`--only`):null,i=n.skip?e.resolveRegex(n.skip,`--skip`):null;return!r&&!i?t:t.filter(e=>!(r&&!r.test(e.id)||i?.test(e.id)))};static resolveRegex(e,t){try{return new RegExp(e)}catch{throw Error(`Invalid regex pattern for ${t}: "${e}"`)}}async run(t,n={}){let r=performance.now(),i=await this.baselineManager.load(),a=e.filterChecks(t.checks,n),o=a.length;w.start(`Running ${o} check${o===1?``:`s`}...`);let s=o>1?await e.executeChecksParallel(a,i):await this.executeChecksSequential(a,i);if(!s)return{exitCode:2,hasImprovement:!1,hasRegression:!0,results:[],totalDuration:performance.now()-r};let c=i,l=!1,u=!1,d=!1;for(let e of s)e.hasRegression&&(l=!0),e.hasImprovement&&(u=!0),e.isInitial&&(d=!0),(e.hasImprovement||e.hasRelocation||n.force||e.isInitial)&&(c=K.update(c,e.checkId,{items:e.snapshot.items,type:e.snapshot.type}));return c&&c!==i&&(!l||n.force||d)&&await this.baselineManager.save(c,n.force),{exitCode:l&&!n.force?1:0,hasImprovement:u,hasRegression:l,results:s,totalDuration:performance.now()-r}}async executeChecksSequential(e,t){try{let t=a.getRequiredTypes(e);await Promise.all([this.registry.setup(t),this.registry.validate(t)])}catch(e){return w.error(`Setup failed:`,e),null}let n=[];for(let r of e)try{let e=performance.now(),i=await this.registry.get(r.config.type).run(r.config),a=performance.now()-e,o=E(i),s=K.getEntry(t,r.id),c=z(o,s);n.push({baseline:s,checkId:r.id,duration:a,hasImprovement:c.hasImprovement,hasRegression:c.hasRegression,hasRelocation:c.hasRelocation,isInitial:c.isInitial,newIssues:c.newIssues,removedIssues:c.removedIssues,snapshot:o})}catch(e){return w.error(`Error running check "${r.id}":`,e),null}return n}};function q(e,t){if(!(e===void 0||t===0))return e/t}function be(e){let{results:t,totalDuration:n}=e,r=t.length,i=[],a=[],o=[],s=[],c=0,l=0,u=0,d=0,f=0,p=[];for(let e of t){let t=e.snapshot.items.length;f+=t,e.isInitial?(u+=t,o.push(e.checkId)):(e.hasImprovement&&(c+=e.removedIssues.length,i.push(e.checkId)),e.hasRegression&&(l+=e.newIssues.length,a.push(e.checkId)),!e.hasImprovement&&!e.hasRegression&&(d+=t,s.push(e.checkId))),p.push({checkId:e.checkId,duration:e.duration,hasImprovement:e.hasImprovement,hasRegression:e.hasRegression,isInitial:e.isInitial,newIssues:e.newIssues,removedIssues:e.removedIssues,totalIssues:t})}let m={checks:p,exitCode:e.exitCode,hasImprovement:e.hasImprovement,hasRegression:e.hasRegression,summary:{avgDuration:q(n,r),checksRun:r,improvementChecks:i,improvements:c,initial:u,initialChecks:o,regressionChecks:a,regressions:l,totalIssues:f,unchanged:d,unchangedChecks:s},totalDuration:n};return JSON.stringify(m,null,2)}function xe(e){if(e<1e3)return`${e}ms`;let t=e/1e3;if(t<60)return t%1==0?`${t}s`:`${t.toFixed(1)}s`;let n=e/6e4;if(n<60)return n%1==0?`${n}m`:`${n.toFixed(1)}m`;let r=e/36e5;return r%1==0?`${r}h`:`${r.toFixed(1)}h`}function J(e){let t=Math.round(e);return t<1?`<1ms`:xe(t)}const Y=`     `,Se=`${Y}  `;function Ce(e){return e===`initial`?y(`→`):e===`improvement`?b(`↑`):x(`↓`)}function we(e,n,i){let a=r(e),o=t(e),s=n>0?`:${n}:${i>0?i:1}`:``;return`${a===`.`?``:y(`${a}/`)}${ee(o)}${s?y(s):``}`}function Te(e,t){return[`${Ce(t)} ${we(e.file,e.line,e.column)}  ${y(e.rule)}`,e.message]}function X(e,t){let n=[],r=e.slice(0,10);for(let e of r){let[r,i]=Te(e,t);n.push(`${Y}${r}`,`${Se}${i}`)}let i=e.length-r.length;return i>0&&n.push(`${Y}${y(`... and ${i} more`)}`),n}function Ee(e){return e===void 0?[]:[`  ${y(`Duration`)}  ${J(e)}`]}function De(e){return[`    ${y(`Issues`)}  ${_(e)}`]}function Z(e){return[...Ee(e.duration),...De(e.snapshot.items.length)]}function Oe(e){if(!e.hasRegression)return[];let t=e.newIssues.length;return[`  ${x(t)} new ${D(t,`issue`)} (${D(t,`regression`)}):`,...X(e.newIssues,`regression`)]}function Q(e){if(!e.hasImprovement)return[];let t=e.removedIssues.length;return[`  ${b(t)} ${D(t,`issue`)} fixed (${D(t,`improvement`)}):`,...X(e.removedIssues,`improvement`)]}function ke(e,t){let n=t?``:`
 `,r=e.snapshot.items.length,i=[`${n}${g(`ℹ`)} ${e.checkId}:`,`  Initial baseline created with ${g(r)} ${D(r,`issue`)}`];return e.snapshot.items.length>0&&i.push(...X(e.snapshot.items,`initial`)),i.push(``,...Z(e)),i}function Ae(e,t){return[`${t?``:`
 `}${e.hasRegression?x(`✖`):b(`✔`)} ${e.checkId}:`,...Oe(e),...Q(e),``,...Z(e)]}function je(e,t){let n=t?``:`
 `,r=e.snapshot.items.length;return e.duration===void 0?[`${n}${S(`ℹ`)} ${e.checkId} (${_(r)})`]:[`${n}${S(`ℹ`)} ${e.checkId} (${_(r)}) ${y(J(e.duration))}`]}function Me(e,t){return e.isInitial?ke(e,t):e.hasRegression||e.hasImprovement?Ae(e,t):je(e,t)}function Ne(e,t,n){return t?g(`✔ Initial baseline created successfully`):e.hasRegression?n?te(`⚠ Regressions detected (forced)`):`${x(`✗ Regressions detected`)} - Run failed`:e.hasImprovement?`${b(`✔ Improvements detected`)} - Baseline updated`:b(`✔ All checks passed`)}function Pe(e,t){let n={hasAnyInitial:!1,totalImprovements:0,totalInitial:0,totalIssues:0,totalRegressions:0};for(let t of e.results){let e=t.snapshot.items.length;if(n.totalIssues+=e,t.isInitial){n.hasAnyInitial=!0,n.totalInitial+=e;continue}let{hasImprovement:r,hasRegression:i}=t;r&&(n.totalImprovements+=t.removedIssues.length),i&&(n.totalRegressions+=t.newIssues.length)}let r=[`  ${y(`Improvements`)}  ${b(n.totalImprovements)}`,`   ${y(`Regressions`)}  ${x(n.totalRegressions)}`,`       ${y(`Initial`)}  ${g(n.totalInitial)}`,`        ${y(`Checks`)}  ${e.results.length}`,`        ${y(`Issues`)}  ${_(n.totalIssues)}`],i=q(e.totalDuration,e.results.length);return e.totalDuration!==void 0&&i!==void 0&&r.push(`      ${y(`Duration`)}  ${J(e.totalDuration)} ${S(`(avg ${J(i)})`)}`),r.push(``,Ne(e,n.hasAnyInitial,t)),r.join(`
@@ -40,4 +40,4 @@ Examples:
   mejora --json
   mejora --only "eslint > *"
   mejora --skip typescript
-`),process.exit(0));try{let e=new a,t=await r();e.init(t);let n=await new ye(e).run(t,{force:$.force,json:$.json,only:$.only,skip:$.skip});$.json?w.log(be(n)):(w.log(``),w.log(Fe(n,$.force))),process.exit(n.exitCode)}catch(e){e instanceof Error?w.error(e.message):w.error(e),process.exit(2)}export{};
+`),process.exit(0));try{let t=new a,n=await e();t.init(n);let r=await new ye(t).run(n,{force:$.force,json:$.json,only:$.only,skip:$.skip});$.json?w.log(be(r)):(w.log(``),w.log(Fe(r,$.force))),process.exit(r.exitCode)}catch(e){e instanceof Error?w.error(e.message):w.error(e),process.exit(2)}export{};

package/dist/workers/check.d.mts

@@ -1,4 +1,4 @@
-import { u as RawSnapshot } from "../index-BHX-tY_Y.mjs";
+import { d as RawSnapshot } from "../index-BNOgTD7N.mjs";
 
 //#region src/workers/check.d.ts
 declare function checkWorker({

package/dist/workers/check.mjs

@@ -1 +1 @@
-import{p as e}from"../typescript-BG8_PZiP.mjs";import{t}from"../check-registry-D0NGvrkK.mjs";import{parentPort as n,workerData as r}from"node:worker_threads";let i=null,a=null;const o=new Map;async function s({checkId:n}){i||(a??=(async()=>{i=await e()})(),await a);let r=i?.checks[n];if(!r)throw Error(`Check not found in config: ${n}`);let s=o.get(r.type);if(!s){s=new t,s.init(i);let e=new Set([r.type]);await Promise.all([s.setup(e),s.validate(e)]),o.set(r.type,s)}let c=performance.now(),l=await s.get(r.type).run(r);return{duration:performance.now()-c,snapshot:l}}if(n){let e=await s(r);n.postMessage(e)}export{s as checkWorker};
+import{n as e}from"../config-C0qrgNuO.mjs";import{t}from"../check-registry-mjn8FfPF.mjs";import{parentPort as n,workerData as r}from"node:worker_threads";let i=null,a=null;const o=new Map;async function s({checkId:n}){i||(a??=(async()=>{i=await e()})(),await a);let r=i?.checks.find(e=>e.id===n);if(!r)throw Error(`Check not found in config: ${n}`);let s=r.config,c=o.get(s.type);if(!c){c=new t,c.init(i);let e=new Set([s.type]);await Promise.all([c.setup(e),c.validate(e)]),o.set(s.type,c)}let l=performance.now(),u=await c.get(s.type).run(s);return{duration:performance.now()-l,snapshot:u}}if(n){let e=await s(r);n.postMessage(e)}export{s as checkWorker};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mejora",
-  "version": "2.4.0",
+  "version": "3.0.0",
   "description": "Prevent regressions. Allow improvement.",
   "keywords": [
     "regression",

package/dist/check-registry-D0NGvrkK.mjs

@@ -1 +0,0 @@
-import{o as e,r as t,t as n}from"./typescript-BG8_PZiP.mjs";var r=class{runners=new Map;static getRequiredTypes(e){return new Set(Object.values(e).map(e=>e.type))}get(e){let t=this.runners.get(e);if(!t)throw Error(`Unknown check type: ${e}`);return t}getTypes(){return new Set(this.runners.keys())}has(e){return this.runners.has(e)}init(r={}){if(this.register(new e),this.register(new n),this.register(new t),r.runners)for(let e of r.runners)this.register(e)}register(e){this.runners.has(e.type)||this.runners.set(e.type,e)}async setup(e){await this.runLifecycle(e,`setup`)}async validate(e){await this.runLifecycle(e,`validate`)}async runLifecycle(e,t){let n=[];for(let r of e){let e=this.get(r)[t]?.();e&&n.push(e)}await Promise.all(n)}};export{r as t};

package/dist/index-BHX-tY_Y.d.mts

@@ -1,427 +0,0 @@
-import * as eslint from "eslint";
-import { Linter } from "eslint";
-import * as typescript from "typescript";
-import { CompilerOptions } from "typescript";
-
-//#region src/types.d.ts
-interface Issue {
-  /**
-   * 1-indexed column number for display.
-   */
-  column: number;
-  /**
-   * Relative path from cwd.
-   */
-  file: string;
-  /**
-   * Hash of canonical representation.
-   *
-   * @example "a1b2c3d4e5f6g7h8i9j0"
-   */
-  id: string;
-  /**
-   * 1-indexed line number for display.
-   */
-  line: number;
-  /**
-   *  The message.
-   */
-  message: string;
-  /**
-   * Identifier for the issue (rule name, diagnostic code, etc).
-   *
-   * @example "no-nested-ternary" (ESLint)
-   *
-   * @example "TS2345" (TypeScript)
-   */
-  rule: string;
-}
-/**
- * Issue produced by a check runner.
- */
-type IssueInput = Omit<Issue, "id">;
-type SnapshotType = "items";
-interface RawSnapshot {
-  /**
-   * Snapshot items (each item represents an issue produced by the check).
-   */
-  items: IssueInput[];
-  type: SnapshotType;
-}
-interface Snapshot {
-  items: Issue[];
-  type: SnapshotType;
-}
-/**
- * Configuration for an ESLint check.
- *
- * @example
- * ```ts
- * eslint({
- *   files: ["src/**\/*.{ts,tsx}"],
- *   overrides: {
- *     rules: {
- *       "no-nested-ternary": "error",
- *     },
- *   },
- * })
- * ```
- */
-interface ESLintCheckConfig {
-  /**
-   * Concurrency setting for ESLint.
-   *
-   * @see https://eslint.org/blog/2025/08/multithread-linting/#cli-multithreading-support
-   *
-   * @default "auto"
-   */
-  concurrency?: "auto" | "off" | number;
-  /**
-   * Glob patterns for files to lint.
-   *
-   * Passed directly to ESLint's `lintFiles()` method.
-   *
-   * @example ["src/**\/*.ts", "src/**\/*.tsx"]
-   */
-  files: string[];
-  /**
-   * ESLint configuration to merge with the base config.
-   *
-   * This is passed to ESLint's `overrideConfig` option and merged with
-   * your existing ESLint configuration.
-   *
-   * Can be a single config object or an array of config objects.
-   *
-   * @example
-   * ```ts
-   * {
-   *   rules: {
-   *     "no-console": "error",
-   *   },
-   * }
-   * ```
-   */
-  overrides?: Linter.Config | Linter.Config[];
-}
-/**
- * Configuration for a TypeScript diagnostics check.
- *
- * @example
- * ```ts
- * typescript({
- *   overrides: {
- *     compilerOptions: {
- *       noImplicitAny: true,
- *     },
- *   },
- * })
- * ```
- */
-interface TypeScriptCheckConfig {
-  /**
-   * Compiler options to merge with the base tsconfig.
-   *
-   * These options are merged with (not replacing) the compiler options
-   * from your tsconfig file.
-   */
-  overrides?: {
-    compilerOptions?: CompilerOptions;
-  };
-  /**
-   * Path to a TypeScript config file.
-   *
-   * If not provided, mejora will search for the nearest `tsconfig.json`
-   * starting from the current working directory.
-   *
-   * @example "tsconfig.strict.json"
-   */
-  tsconfig?: string;
-}
-/**
- * A regex pattern configuration.
- */
-interface RegexPattern {
-  /**
-   * Human-readable message for matches.
-   *
-   * @example "TODO comment found"
-   *
-   * @example "console.log statement"
-   *
-   * @example (match) => `Found TODO at line ${match.index + 1}`
-   */
-  message?: ((match: RegExpExecArray) => string) | string;
-  /**
-   * The regex pattern to match.
-   *
-   * @example /\/\/\s*TODO:/gi
-   *
-   * @example /console\.log/g
-   */
-  pattern: RegExp;
-  /**
-   * Rule identifier for this pattern.
-   * If not provided, uses the pattern source as the rule ID.
-   *
-   * @example "no-todos"
-   *
-   * @example "no-console-log"
-   */
-  rule?: string;
-}
-/**
- * Configuration for regex pattern matching check.
- */
-interface RegexCheckConfig {
-  /**
-   * Concurrency for processing files.
-   *
-   * @default 10
-   */
-  concurrency?: number;
-  /**
-   * Array of glob patterns for files to check.
-   *
-   * @example ["src/**\/*.ts", "lib/**\/*.js"]
-   */
-  files: string[];
-  /**
-   * Array of glob patterns to ignore.
-   *
-   * @default ["**\/node_modules/**", "**\/dist/**", "**\/.git/**"]
-   */
-  ignore?: string[];
-  /**
-   * Array of regex patterns to match.
-   */
-  patterns: RegexPattern[];
-}
-type CustomCheckConfig = Record<string, unknown> & {
-  type: string;
-};
-type CheckConfig$1 = (ESLintCheckConfig & {
-  type: "eslint";
-}) | (TypeScriptCheckConfig & {
-  type: "typescript";
-}) | CustomCheckConfig;
-/**
- * mejora configuration.
- *
- * Define checks to run and track for regressions.
- *
- * @example
- * ```ts
- * import { defineConfig, eslint, typescript } from "mejora";
- *
- * export default defineConfig({
- *   checks: {
- *     "eslint > no-nested-ternary": eslint({
- *       files: ["src/**\/*.{ts,tsx}"],
- *       overrides: {
- *         rules: {
- *           "no-nested-ternary": "error",
- *         },
- *       },
- *     }),
- *     "typescript": typescript({
- *       overrides: {
- *         compilerOptions: {
- *           noImplicitAny: true,
- *         },
- *       },
- *     }),
- *   },
- * });
- * ```
- */
-interface Config {
-  /**
-   * Check definitions.
-   *
-   * Each key is a check identifier used in the baseline and output.
-   * The identifier can contain any characters.
-   *
-   * Use `eslint()` and `typescript()` helpers to create check configs.
-   *
-   * @example
-   * ```ts
-   * {
-   *   "eslint > no-console": eslint({ ... }),
-   *   "typescript": typescriptCheck({ ... }),
-   * }
-   * ```
-   */
-  checks: Record<string, CheckConfig$1>;
-  /**
-   * Runners to register custom check types.
-   *
-   * Built-in checks (eslint, typescript) are always available.
-   *
-   * @example
-   * ```ts
-   * {
-   *   runners: [myCustomRunner()],
-   *   checks: {
-   *     "custom": myCheck({ ... })
-   *   }
-   * }
-   * ```
-   */
-  runners?: CheckRunner[];
-}
-/**
- * Interface that all check runners must implement.
- *
- * Each check type (eslint, typescript, custom) implements this interface
- * to provide consistent lifecycle hooks for execution.
- */
-interface CheckRunner<TConfig = unknown> {
-  /**
-   * Execute the check and return a snapshot of issues.
-   *
-   * @param config - Check-specific configuration
-   *
-   * @returns Snapshot containing all issues found
-   */
-  run(config: TConfig): Promise<RawSnapshot>;
-  /**
-   * Setup any infrastructure needed for this check.
-   * Called once during runner setup, in parallel with other checks.
-   *
-   * Examples: creating cache directories, initializing compilation state.
-   *
-   * Optional - not all checks need infrastructure setup.
-   */
-  setup?(): Promise<void>;
-  /**
-   * Unique identifier for this check type.
-   * Must match the `type` field in CheckConfig.
-   *
-   * @example "eslint"
-   *
-   * @example "typescript"
-   */
-  readonly type: string;
-  /**
-   * Validate that all dependencies for this check are available.
-   * Called once during runner setup before any checks execute.
-   *
-   * Should throw a descriptive error if dependencies are missing.
-   *
-   * @throws {Error} If required dependencies are not installed
-   */
-  validate?(): Promise<void>;
-}
-//#endregion
-//#region src/runners/eslint.d.ts
-/**
- * Check runner for ESLint.
- */
-declare class ESLintCheckRunner implements CheckRunner {
-  readonly type = "eslint";
-  run(eslintConfig: ESLintCheckConfig): Promise<{
-    items: IssueInput[];
-    type: "items";
-  }>;
-  setup(): Promise<void>;
-  validate(): Promise<void>;
-}
-/**
- * Create an ESLint check configuration.
- *
- * @param config - ESLint check configuration options.
- *
- * @returns An ESLint check configuration object.
- */
-declare function eslintCheck(config: ESLintCheckConfig): {
-  concurrency?: "auto" | "off" | number;
-  files: string[];
-  overrides?: eslint.Linter.Config | eslint.Linter.Config[];
-  type: "eslint";
-};
-//#endregion
-//#region src/runners/regex.d.ts
-/**
- * Check runner for regex pattern matching.
- */
-declare class RegexCheckRunner implements CheckRunner {
-  readonly type = "regex";
-  run(config: RegexCheckConfig): Promise<{
-    items: IssueInput[];
-    type: "items";
-  }>;
-  setup(): Promise<void>;
-}
-declare const regexRunner: () => RegexCheckRunner;
-/**
- * Create a regex check configuration.
- *
- * @param config - Regex check configuration options.
- *
- * @returns A regex check configuration object.
- */
-declare function regexCheck(config: RegexCheckConfig): {
-  concurrency?: number;
-  files: string[];
-  ignore?: string[];
-  patterns: RegexPattern[];
-  type: "regex";
-};
-//#endregion
-//#region src/runners/typescript.d.ts
-/**
- * Check runner for TypeScript.
- */
-declare class TypeScriptCheckRunner implements CheckRunner {
-  readonly type = "typescript";
-  run(typescriptConfig: TypeScriptCheckConfig): Promise<{
-    items: IssueInput[];
-    type: "items";
-  }>;
-  setup(): Promise<void>;
-  validate(): Promise<void>;
-}
-/**
- * Create a TypeScript check configuration.
- *
- * @param config - TypeScript check configuration options.
- *
- * @returns A TypeScript check configuration object.
- */
-declare function typescriptCheck(config: TypeScriptCheckConfig): {
-  overrides?: {
-    compilerOptions?: typescript.CompilerOptions;
-  };
-  tsconfig?: string;
-  type: "typescript";
-};
-//#endregion
-//#region src/core/config.d.ts
-type ExtractRunnerByType<TRunners extends readonly CheckRunner[], TType extends string> = Extract<TRunners[number], {
-  type: TType;
-}>;
-type ExtractConfig<TRunner> = TRunner extends CheckRunner<infer C> ? C : never;
-type CheckConfig<TRunners extends readonly CheckRunner[], TType extends TRunners[number]["type"]> = ExtractConfig<ExtractRunnerByType<TRunners, TType>> & {
-  type: TType;
-};
-type InternalRunners = readonly [ESLintCheckRunner, TypeScriptCheckRunner, RegexCheckRunner];
-/**
- * Define mejora configuration.
- *
- * @param config - mejora configuration object.
- *
- * @param config.runners - Optional array of custom check runners to register.
- *
- * @param config.checks - Map of check names to their configurations.
- *
- * @returns The provided configuration object.
- */
-declare function defineConfig<const TRunners extends readonly CheckRunner[]>(config: {
-  checks: Record<string, CheckConfig<[...InternalRunners, ...TRunners], [...InternalRunners, ...TRunners][number]["type"]>>;
-  runners?: TRunners;
-}): {
-  checks: Record<string, CheckConfig<[...InternalRunners, ...TRunners], [...InternalRunners, ...TRunners][number]["type"]>>;
-  runners?: TRunners;
-};
-//#endregion
-export { eslintCheck as a, Issue as c, Snapshot as d, regexRunner as i, IssueInput as l, typescriptCheck as n, CheckRunner as o, regexCheck as r, Config as s, defineConfig as t, RawSnapshot as u };

package/dist/typescript-BG8_PZiP.mjs

@@ -1,3 +0,0 @@
-import{createRequire as e}from"node:module";import{pathToFileURL as t}from"node:url";import{glob as n,mkdir as r,readFile as i,stat as a,writeFile as o}from"node:fs/promises";import{hash as s}from"node:crypto";import{createReadStream as c}from"node:fs";import{createInterface as l}from"node:readline/promises";var u=(e,t)=>()=>(t||e((t={exports:{}}).exports,t),t.exports),d=e(import.meta.url),f=u(((e,t)=>{let n=d(`path`),r=d(`fs`),i=d(`os`),a=d(`url`),o=r.promises.readFile;function s(e,t){return[`package.json`,`.${e}rc.json`,`.${e}rc.js`,`.${e}rc.cjs`,...t?[]:[`.${e}rc.mjs`],`.config/${e}rc`,`.config/${e}rc.json`,`.config/${e}rc.js`,`.config/${e}rc.cjs`,...t?[]:[`.config/${e}rc.mjs`],`${e}.config.js`,`${e}.config.cjs`,...t?[]:[`${e}.config.mjs`]]}function c(e){return n.dirname(e)||n.sep}let l=(e,t)=>JSON.parse(t),u=typeof __webpack_require__==`function`?__non_webpack_require__:d,f=Object.freeze({".js":u,".json":u,".cjs":u,noExt:l});t.exports.defaultLoadersSync=f;let p=async e=>{try{return(await import(a.pathToFileURL(e).href)).default}catch(t){try{return u(e)}catch(e){throw e.code===`ERR_REQUIRE_ESM`||e instanceof SyntaxError&&e.toString().includes(`Cannot use import statement outside a module`)?t:e}}},m=Object.freeze({".js":p,".mjs":p,".cjs":p,".json":l,noExt:l});t.exports.defaultLoaders=m;function h(e,t,r){let a={stopDir:i.homedir(),searchPlaces:s(e,r),ignoreEmptySearchPlaces:!0,cache:!0,transform:e=>e,packageProp:[e],...t,loaders:{...r?f:m,...t.loaders}};return a.searchPlaces.forEach(e=>{let t=n.extname(e)||`noExt`,r=a.loaders[t];if(!r)throw Error(`Missing loader for extension "${e}"`);if(typeof r!=`function`)throw Error(`Loader for extension "${e}" is not a function: Received ${typeof r}.`)}),a}function g(e,t){return typeof e==`string`&&e in t?t[e]:(Array.isArray(e)?e:e.split(`.`)).reduce((e,t)=>e===void 0?e:e[t],t)||null}function _(e){if(!e)throw Error(`load must pass a non-empty string`)}function v(e,t){if(!e)throw Error(`No loader specified for extension "${t}"`);if(typeof e!=`function`)throw Error(`loader is not a function`)}let y=e=>(t,n,r)=>(e&&t.set(n,r),r);t.exports.lilconfig=function(e,t){let{ignoreEmptySearchPlaces:i,loaders:a,packageProp:s,searchPlaces:l,stopDir:u,transform:d,cache:f}=h(e,t??{},!1),p=new Map,m=new Map,b=y(f);return{async search(e=process.cwd()){let t={config:null,filepath:``},m=new Set,h=e;dirLoop:for(;;){if(f){let e=p.get(h);if(e!==void 0){for(let t of m)p.set(t,e);return e}m.add(h)}for(let e of l){let c=n.join(h,e);try{await r.promises.access(c)}catch{continue}let l=String(await o(c)),u=n.extname(e)||`noExt`,d=a[u];if(e===`package.json`){let e=g(s,await d(c,l));if(e!=null){t.config=e,t.filepath=c;break dirLoop}continue}let f=l.trim()===``;if(!(f&&i)){f?(t.isEmpty=!0,t.config=void 0):(v(d,u),t.config=await d(c,l)),t.filepath=c;break dirLoop}}if(h===u||h===c(h))break dirLoop;h=c(h)}let _=t.filepath===``&&t.config===null?d(null):d(t);if(f)for(let e of m)p.set(e,_);return _},async load(e){_(e);let t=n.resolve(process.cwd(),e);if(f&&m.has(t))return m.get(t);let{base:r,ext:c}=n.parse(t),l=c||`noExt`,u=a[l];v(u,l);let p=String(await o(t));if(r===`package.json`)return b(m,t,d({config:g(s,await u(t,p)),filepath:t}));let h={config:null,filepath:t},y=p.trim()===``;return y&&i?b(m,t,d({config:void 0,filepath:t,isEmpty:!0})):(h.config=y?void 0:await u(t,p),b(m,t,d(y?{...h,isEmpty:y,config:void 0}:h)))},clearLoadCache(){f&&m.clear()},clearSearchCache(){f&&p.clear()},clearCaches(){f&&(m.clear(),p.clear())}}},t.exports.lilconfigSync=function(e,t){let{ignoreEmptySearchPlaces:i,loaders:a,packageProp:o,searchPlaces:s,stopDir:l,transform:u,cache:d}=h(e,t??{},!0),f=new Map,p=new Map,m=y(d);return{search(e=process.cwd()){let t={config:null,filepath:``},p=new Set,m=e;dirLoop:for(;;){if(d){let e=f.get(m);if(e!==void 0){for(let t of p)f.set(t,e);return e}p.add(m)}for(let e of s){let s=n.join(m,e);try{r.accessSync(s)}catch{continue}let c=n.extname(e)||`noExt`,l=a[c],u=String(r.readFileSync(s));if(e===`package.json`){let e=g(o,l(s,u));if(e!=null){t.config=e,t.filepath=s;break dirLoop}continue}let d=u.trim()===``;if(!(d&&i)){d?(t.isEmpty=!0,t.config=void 0):(v(l,c),t.config=l(s,u)),t.filepath=s;break dirLoop}}if(m===l||m===c(m))break dirLoop;m=c(m)}let h=t.filepath===``&&t.config===null?u(null):u(t);if(d)for(let e of p)f.set(e,h);return h},load(e){_(e);let t=n.resolve(process.cwd(),e);if(d&&p.has(t))return p.get(t);let{base:s,ext:c}=n.parse(t),l=c||`noExt`,f=a[l];v(f,l);let h=String(r.readFileSync(t));if(s===`package.json`)return u({config:g(o,f(t,h)),filepath:t});let y={config:null,filepath:t},b=h.trim()===``;return b&&i?m(p,t,u({filepath:t,config:void 0,isEmpty:!0})):(y.config=b?void 0:f(t,h),m(p,t,u(b?{...y,isEmpty:b,config:void 0}:y)))},clearLoadCache(){d&&p.clear()},clearSearchCache(){d&&f.clear()},clearCaches(){d&&(p.clear(),f.clear())}}}}))();const p=async e=>{let n=await import(t(e).href);return n&&typeof n==`object`&&`default`in n?n.default:n};function m(e){return e}const h=async()=>{let e=await(0,f.lilconfig)(`mejora`,{loaders:{".js":p,".mjs":p,".mts":p,".ts":p},searchPlaces:[`mejora.config.ts`,`mejora.config.mts`,`mejora.config.js`,`mejora.config.mjs`]}).search(process.cwd());if(!e?.config)throw Error(`No configuration file found.`);return e.config},g=/^[A-Za-z]:\//;function _(e=``){return e&&e.replace(/\\/g,`/`).replace(g,e=>e.toUpperCase())}const v=/^[/\\]{2}/,y=/^[/\\](?![/\\])|^[/\\]{2}(?!\.)|^[A-Za-z]:[/\\]/,b=/^[A-Za-z]:$/,x=/^\/([A-Za-z]:)?$/,S=function(e){if(e.length===0)return`.`;e=_(e);let t=e.match(v),n=D(e),r=e[e.length-1]===`/`;return e=E(e,!n),e.length===0?n?`/`:r?`./`:`.`:(r&&(e+=`/`),b.test(e)&&(e+=`/`),t?n?`//${e}`:`//./${e}`:n&&!D(e)?`/${e}`:e)},C=function(...e){let t=``;for(let n of e)if(n)if(t.length>0){let e=t[t.length-1]===`/`,r=n[0]===`/`;e&&r?t+=n.slice(1):t+=e||r?n:`/${n}`}else t+=n;return S(t)};function w(){return typeof process<`u`&&typeof process.cwd==`function`?process.cwd().replace(/\\/g,`/`):`/`}const T=function(...e){e=e.map(e=>_(e));let t=``,n=!1;for(let r=e.length-1;r>=-1&&!n;r--){let i=r>=0?e[r]:w();!i||i.length===0||(t=`${i}/${t}`,n=D(i))}return t=E(t,!n),n&&!D(t)?`/${t}`:t.length>0?t:`.`};function E(e,t){let n=``,r=0,i=-1,a=0,o=null;for(let s=0;s<=e.length;++s){if(s<e.length)o=e[s];else if(o===`/`)break;else o=`/`;if(o===`/`){if(!(i===s-1||a===1))if(a===2){if(n.length<2||r!==2||n[n.length-1]!==`.`||n[n.length-2]!==`.`){if(n.length>2){let e=n.lastIndexOf(`/`);e===-1?(n=``,r=0):(n=n.slice(0,e),r=n.length-1-n.lastIndexOf(`/`)),i=s,a=0;continue}else if(n.length>0){n=``,r=0,i=s,a=0;continue}}t&&(n+=n.length>0?`/..`:`..`,r=2)}else n.length>0?n+=`/${e.slice(i+1,s)}`:n=e.slice(i+1,s),r=s-i-1;i=s,a=0}else o===`.`&&a!==-1?++a:a=-1}return n}const D=function(e){return y.test(e)},O=function(e,t){let n=T(e).replace(x,`$1`).split(`/`),r=T(t).replace(x,`$1`).split(`/`);if(r[0][1]===`:`&&n[0][1]===`:`&&n[0]!==r[0])return r.join(`/`);let i=[...n];for(let e of i){if(r[0]!==e)break;n.shift(),r.shift()}return[...n.map(()=>`..`),...r].join(`/`)},k=function(e){let t=_(e).replace(/\/$/,``).split(`/`).slice(0,-1);return t.length===1&&b.test(t[0])&&(t[0]+=`/`),t.join(`/`)||(D(e)?`/`:`.`)},A=function(e,t){let n=_(e).split(`/`),r=``;for(let e=n.length-1;e>=0;e--){let t=n[e];if(t){r=t;break}}return t&&r.endsWith(t)?r.slice(0,-t.length):r},j=e=>s(`sha256`,e,`hex`);function M(){let e=new WeakSet;return(t,n)=>{if(n&&typeof n==`object`){if(e.has(n))return`[Circular]`;if(e.add(n),!Array.isArray(n)){let e=n,t={};for(let n of Object.keys(e).toSorted()){let r=e[n];typeof r==`function`||typeof r==`symbol`||(t[n]=r)}return t}}return n}}function N(e){return j(JSON.stringify(e??null,M()))}function P(e,t=process.cwd()){return T(t,`node_modules`,`.cache`,`mejora`,e)}async function F(e){try{let t=await i(e,`utf8`);return JSON.parse(t)}catch{return{}}}async function I(e,t){try{await o(e,JSON.stringify(t,null,2),`utf8`)}catch{}}async function L(e){try{let t=await a(e);return`${t.mtimeMs}-${t.size}`}catch{return null}}var R=class{type=`eslint`;async run(e){let{ESLint:t}=await import(`eslint`),n=process.cwd(),r=P(this.type,n),i=N(e),a=new Set;if(e.overrides){let t=Array.isArray(e.overrides)?e.overrides:[e.overrides];for(let e of t)if(e.rules)for(let t of Object.keys(e.rules))a.add(t)}let o=a.size>0,s=await new t({cache:!0,cacheLocation:`${r}/${i}.eslintcache`,overrideConfig:e.overrides,...!o&&{concurrency:e.concurrency??`auto`},...o&&{ruleFilter:({ruleId:e})=>a.has(e)}}).lintFiles(e.files),c=[];for(let{filePath:e,messages:t}of s){let r=O(n,e);for(let{column:e,line:n,message:i,ruleId:a}of t)a&&c.push({column:e,file:r,line:n,message:i,rule:a})}return{items:c,type:`items`}}async setup(){let e=process.cwd(),t=P(this.type,e),{mkdir:n}=await import(`node:fs/promises`);await n(t,{recursive:!0})}async validate(){try{await import(`eslint`)}catch{throw Error(`${this.type} check requires "eslint" package to be installed. Run: npm install eslint`)}}};function z(e){return{type:`eslint`,...e}}const B=[`**/node_modules/**`,`**/dist/**`,`**/.git/**`];function V(e,t){if(t?.length)return t;let n=e.map(e=>/^([^*]+\/)/.exec(e)?.[1]).filter(e=>e!==void 0);return[...B,...n.flatMap(e=>B.map(t=>t.replace(/^\*\*\//,e)))]}async function H(e,t,n){let r=Array.from({length:e.length}),i=0;return await Promise.all(Array.from({length:Math.min(t,e.length)},async()=>{for(;i<e.length;){let t=i++;r[t]=await n(e[t])}})),r}var U=class{type=`regex`;async run(e){let t=process.cwd(),r=Array.isArray(e.files)?e.files:[e.files],i=V(r,e.ignore),a=new Set;for(let e of r){let r=n(e,{cwd:t,exclude:i});for await(let e of r)a.add(e)}let o=[...a],s=e.patterns.map(({message:e,pattern:t,rule:n})=>{let r=t.flags.includes(`g`)?t.flags:`${t.flags}g`;return{message:e,regex:new RegExp(t.source,r),ruleText:n??t.source}}),u=C(P(this.type,t),`${N(e)}.json`),d=await F(u),f={},p=await H(o,e.concurrency??10,async e=>{let n=C(t,e),r=await L(n);if(!r)return[];let i=d[e];if(i?.hash===r)return f[e]=i,i.items;try{let t=[],i=l({crlfDelay:1/0,input:c(n,{encoding:`utf8`})}),a=0;try{for await(let n of i){a++;for(let r of s){r.regex.lastIndex=0;let i;for(;(i=r.regex.exec(n))!==null;){let n=i.index+1,o=typeof r.message==`function`?r.message(i):r.message??`Pattern matched: ${i[0]}`;t.push({column:n,file:e,line:a,message:o,rule:r.ruleText})}}}}finally{i.close()}return f[e]={hash:r,items:t},t}catch{return[]}}),m=[];for(let e of p)m.push(...e);return await I(u,f),{items:m,type:`items`}}async setup(){let e=process.cwd();await r(P(this.type,e),{recursive:!0})}};const W=()=>new U;function G(e){return{type:`regex`,...e}}function K(e,t){return e.replaceAll(/import\("([^"]+)"\)/g,(e,n)=>{try{if(D(n)){let e=O(t,n);if(!e.startsWith(`..`))return`import("${e||`.`}")`}}catch{}return e})}var q=class{type=`typescript`;async run(e){let{createIncrementalCompilerHost:t,createIncrementalProgram:n,findConfigFile:r,flattenDiagnosticMessageText:i,getPreEmitDiagnostics:a,parseJsonConfigFileContent:o,readConfigFile:s,sys:c,version:l}=await import(`typescript`),u=process.cwd(),d=c.fileExists.bind(c),f=c.readFile.bind(c),p=e.tsconfig?T(e.tsconfig):r(u,d,`tsconfig.json`);if(!p)throw Error(`TypeScript config file not found`);let{config:m,error:h}=s(p,f);if(h){let e=typeof h.messageText==`string`?h.messageText:i(h.messageText,`
-`);throw TypeError(`Failed to read TypeScript config: ${e}`)}let g=o(m,c,u,e.overrides?.compilerOptions),_=T(P(this.type,u),`${N({configPath:p,overrides:e.overrides?.compilerOptions??{},parsedOptions:g.options,typescriptVersion:l})}.tsbuildinfo`),v={...g.options,incremental:!0,noEmit:!0,skipLibCheck:g.options.skipLibCheck??!0,tsBuildInfoFile:_},y=t(v,c),b=y.writeFile.bind(y);y.writeFile=(e,t,...n)=>{T(e)===_&&b(e,t,...n)};let x=n({host:y,options:v,projectReferences:g.projectReferences??[],rootNames:g.fileNames}),S=a(x.getProgram());x.emit();let C=T(u),w=C+`/`,E=S.filter(e=>{if(!e.file)return!0;let t=T(e.file.fileName);return t===C||t.startsWith(w)}),D=[];for(let e of E){let t=i(e.messageText,`
-`),n=`TS${e.code}`;if(e.file&&e.start!==void 0){let{character:r,line:i}=e.file.getLineAndCharacterOfPosition(e.start),a=O(u,e.file.fileName);D.push({column:r+1,file:a,line:i+1,message:K(t,u),rule:n})}else D.push({column:0,file:`(global)`,line:0,message:K(t,u),rule:n})}return{items:D,type:`items`}}async setup(){let e=process.cwd(),t=P(this.type,e),{mkdir:n}=await import(`node:fs/promises`);await n(t,{recursive:!0})}async validate(){try{await import(`typescript`)}catch{throw Error(`${this.type} check requires "typescript" package to be installed. Run: npm install typescript`)}}};function J(e){return{type:`typescript`,...e}}export{W as a,j as c,O as d,m as f,G as i,A as l,J as n,R as o,h as p,U as r,z as s,q as t,k as u};