@archest/jest 1.0.1

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export type { ClassData, ClassQueryOptions, FileData, FileQueryOptions, FunctionData, FunctionQueryOptions, ProjectData, PropertyData, PropertyQueryOptions, } from '@archest/core';
+export { type ParseProjectOptions, parseProject, } from '@archest/core';
+export { type ArchestMatchers, setupMatchers } from './matchers';

package/dist/index.js

@@ -0,0 +1,2 @@
+(function(e,t){typeof exports==`object`&&typeof module<`u`?t(exports,require(`@archest/core`)):typeof define==`function`&&define.amd?define([`exports`,`@archest/core`],t):(e=typeof globalThis<`u`?globalThis:e||self,t(e.JestArch={},e._archest_core))})(this,function(e,t){Object.defineProperty(e,Symbol.toStringTag,{value:`Module`});function n(){expect.extend({toPass(e){let n;n=e?.data&&e.data.type===`LayeredArchitecture`?(0,t.checkLayeredArchitecture)(e.data):e;let{pass:r,message:i}=n;return{pass:this.isNot?!r:r,message:r?()=>`Expected rule not to pass`:()=>i()}},toResideInFolder(e,n){let r;if(e.type===`ClassLocator`)r=(0,t.classCheckResideInFolder)(e,n,!!this.isNot);else throw Error(`toResideInFolder matcher does not support ${e.type}`);return{pass:this.isNot?!r.pass:r.pass,message:r.message}},toHaveModifier(e,n){let r;if(e.type===`ClassLocator`)r=(0,t.classCheckHaveModifier)(e,n,!!this.isNot);else if(e.type===`FunctionLocator`)r=(0,t.functionCheckHaveModifier)(e,n,!!this.isNot);else throw Error(`toHaveModifier matcher does not support ${e.type}`);return{pass:this.isNot?!r.pass:r.pass,message:r.message}},toExtendClass(e,n){let r;if(e.type===`ClassLocator`)r=(0,t.classCheckExtendClass)(e,n,!!this.isNot);else throw Error(`toExtendClass matcher does not support ${e.type}`);return{pass:this.isNot?!r.pass:r.pass,message:r.message}},toImplementInterface(e,n){let r;if(e.type===`ClassLocator`)r=(0,t.classCheckImplementInterface)(e,n,!!this.isNot);else throw Error(`toImplementInterface matcher does not support ${e.type}`);return{pass:this.isNot?!r.pass:r.pass,message:r.message}},toHaveExplicitReturnType(e){let n;if(e.type===`FunctionLocator`)n=(0,t.functionCheckHaveExplicitReturnType)(e,!!this.isNot);else throw Error(`toHaveExplicitReturnType matcher does not support ${e.type}`);return{pass:this.isNot?!n.pass:n.pass,message:n.message}},toBeReadonly(e){let n;if(e.type===`PropertyLocator`)n=(0,t.propertyCheckBeReadonly)(e,!!this.isNot);else throw Error(`toBeReadonly matcher does not support ${e.type}`);return{pass:this.isNot?!n.pass:n.pass,message:n.message}},toDependOnFilesInFolder(e,n){let r;if(e.type===`FileLocator`)r=(0,t.checkDependOnFilesInFolder)(e,n,!!this.isNot);else throw Error(`toDependOnFilesInFolder matcher does not support ${e.type}`);return{pass:this.isNot?!r.pass:r.pass,message:r.message}},toDependOnExternalModule(e,n){let r;if(e.type===`FileLocator`)r=(0,t.checkDependOnExternalModule)(e,n,!!this.isNot);else throw Error(`toDependOnExternalModule matcher does not support ${e.type}`);return{pass:this.isNot?!r.pass:r.pass,message:r.message}},toBeFreeOfCycles(e){let n;if(e.type===`FileLocator`)n=(0,t.fileCheckBeFreeOfCycles)(e,!!this.isNot);else if(e.type===`SliceLocator`)n=(0,t.sliceCheckBeFreeOfCycles)(e,!!this.isNot);else throw Error(`toBeFreeOfCycles matcher does not support ${e.type}`);return{pass:this.isNot?!n.pass:n.pass,message:n.message}},toMatchNamePattern(e,n){let r;if(e.type===`FileLocator`)r=(0,t.fileCheckMatchNamePattern)(e,n,!!this.isNot);else if(e.type===`ClassLocator`)r=(0,t.classCheckMatchNamePattern)(e,n,!!this.isNot);else if(e.type===`FunctionLocator`)r=(0,t.functionCheckMatchNamePattern)(e,n,!!this.isNot);else throw Error(`toMatchNamePattern matcher does not support ${e.type}`);return{pass:this.isNot?!r.pass:r.pass,message:r.message}},toHaveMaxCyclomaticComplexity(e,n){let r;if(e.type===`FileLocator`)r=(0,t.fileCheckHaveMaxCyclomaticComplexity)(e,n,!!this.isNot);else if(e.type===`ClassLocator`)r=(0,t.classCheckHaveMaxCyclomaticComplexity)(e,n,!!this.isNot);else if(e.type===`FunctionLocator`)r=(0,t.functionCheckHaveMaxCyclomaticComplexity)(e,n,!!this.isNot);else throw Error(`toHaveMaxCyclomaticComplexity matcher does not support ${e.type}`);return{pass:this.isNot?!r.pass:r.pass,message:r.message}},toHaveMinMaintainabilityIndex(e,n){let r;if(e.type===`FileLocator`)r=(0,t.fileCheckHaveMinMaintainabilityIndex)(e,n,!!this.isNot);else if(e.type===`FunctionLocator`)r=(0,t.functionCheckHaveMinMaintainabilityIndex)(e,n,!!this.isNot);else throw Error(`toHaveMinMaintainabilityIndex matcher does not support ${e.type}`);return{pass:this.isNot?!r.pass:r.pass,message:r.message}},toHaveMaxDistanceFromMainSequence(e,n){let r;if(e.type===`SliceLocator`)r=(0,t.sliceCheckHaveMaxDistanceFromMainSequence)(e,n,!!this.isNot);else throw Error(`toHaveMaxDistanceFromMainSequence matcher does not support ${e.type}`);return{pass:this.isNot?!r.pass:r.pass,message:r.message}},toHaveNameMatchingFileName(e){let n;if(e.type===`FunctionLocator`)n=(0,t.functionCheckHaveNameMatchingFileName)(e,!!this.isNot);else if(e.type===`ClassLocator`)n=(0,t.classCheckHaveNameMatchingFileName)(e,!!this.isNot);else throw Error(`toHaveNameMatchingFileName matcher does not support ${e.type}`);return{pass:this.isNot?!n.pass:n.pass,message:n.message}},toHaveMaxExportedFunctions(e,n){let r;if(e.type===`FileLocator`)r=(0,t.fileCheckHaveMaxExportedFunctions)(e,n,!!this.isNot);else throw Error(`toHaveMaxExportedFunctions matcher does not support ${e.type}`);return{pass:this.isNot?!r.pass:r.pass,message:r.message}}})}Object.defineProperty(e,`parseProject`,{enumerable:!0,get:function(){return t.parseProject}}),e.setupMatchers=n});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../src/matchers/index.ts"],"sourcesContent":["/// <reference types=\"jest\" />\nimport {\n  checkDependOnExternalModule,\n  checkDependOnFilesInFolder,\n  checkLayeredArchitecture,\n  classCheckExtendClass,\n  classCheckHaveMaxCyclomaticComplexity,\n  classCheckHaveModifier,\n  classCheckHaveNameMatchingFileName,\n  classCheckImplementInterface,\n  classCheckMatchNamePattern,\n  classCheckResideInFolder,\n  fileCheckBeFreeOfCycles,\n  fileCheckHaveMaxCyclomaticComplexity,\n  fileCheckHaveMaxExportedFunctions,\n  fileCheckHaveMinMaintainabilityIndex,\n  fileCheckMatchNamePattern,\n  functionCheckHaveExplicitReturnType,\n  functionCheckHaveMaxCyclomaticComplexity,\n  functionCheckHaveMinMaintainabilityIndex,\n  functionCheckHaveModifier,\n  functionCheckHaveNameMatchingFileName,\n  functionCheckMatchNamePattern,\n  type LocatorData,\n  propertyCheckBeReadonly,\n  type RuleResult,\n  sliceCheckBeFreeOfCycles,\n  sliceCheckHaveMaxDistanceFromMainSequence,\n} from '@archest/core';\nimport type { ArchestMatchers } from './models';\n\nexport * from './models';\n\n/**\n * Registers all Archest custom matchers (e.g., `toResideInFolder`, `toHaveModifier`)\n * with the global Vitest `expect` instance.\n *\n * This function must be called exactly once before any architectural tests are run.\n * The standard way to do this is to add it to a Vitest setup file.\n *\n * @example\n * ```typescript\n * // test/setup.ts\n * import { setupMatchers } from '@archest/jest';\n * setupMatchers();\n * ```\n */\nexport function setupMatchers() {\n  expect.extend({\n    // biome-ignore lint/suspicious/noExplicitAny: Matcher signature\n    toPass(received: any) {\n      let result: RuleResult;\n\n      if (received?.data && received.data.type === 'LayeredArchitecture') {\n        result = checkLayeredArchitecture(received.data);\n      } else {\n        result = received as RuleResult;\n      }\n\n      const { pass, message } = result;\n      return {\n        pass: this.isNot ? !pass : pass,\n        message: pass ? () => 'Expected rule not to pass' : () => message(),\n      };\n    },\n\n    toResideInFolder(received: LocatorData, folder: string) {\n      let result: RuleResult;\n      if (received.type === 'ClassLocator') {\n        result = classCheckResideInFolder(received, folder, !!this.isNot);\n      } else {\n        throw new Error(\n          `toResideInFolder matcher does not support ${received.type}`,\n        );\n      }\n      return {\n        pass: this.isNot ? !result.pass : result.pass,\n        message: result.message,\n      };\n    },\n\n    toHaveModifier(received: LocatorData, modifier: string) {\n      let result: RuleResult;\n      if (received.type === 'ClassLocator') {\n        result = classCheckHaveModifier(received, modifier, !!this.isNot);\n      } else if (received.type === 'FunctionLocator') {\n        result = functionCheckHaveModifier(received, modifier, !!this.isNot);\n      } else {\n        throw new Error(\n          `toHaveModifier matcher does not support ${received.type}`,\n        );\n      }\n      return {\n        pass: this.isNot ? !result.pass : result.pass,\n        message: result.message,\n      };\n    },\n\n    toExtendClass(received: LocatorData, className: string) {\n      let result: RuleResult;\n      if (received.type === 'ClassLocator') {\n        result = classCheckExtendClass(received, className, !!this.isNot);\n      } else {\n        throw new Error(\n          `toExtendClass matcher does not support ${received.type}`,\n        );\n      }\n      return {\n        pass: this.isNot ? !result.pass : result.pass,\n        message: result.message,\n      };\n    },\n\n    toImplementInterface(received: LocatorData, interfaceName: string) {\n      let result: RuleResult;\n      if (received.type === 'ClassLocator') {\n        result = classCheckImplementInterface(\n          received,\n          interfaceName,\n          !!this.isNot,\n        );\n      } else {\n        throw new Error(\n          `toImplementInterface matcher does not support ${received.type}`,\n        );\n      }\n      return {\n        pass: this.isNot ? !result.pass : result.pass,\n        message: result.message,\n      };\n    },\n\n    toHaveExplicitReturnType(received: LocatorData) {\n      let result: RuleResult;\n      if (received.type === 'FunctionLocator') {\n        result = functionCheckHaveExplicitReturnType(received, !!this.isNot);\n      } else {\n        throw new Error(\n          `toHaveExplicitReturnType matcher does not support ${received.type}`,\n        );\n      }\n      return {\n        pass: this.isNot ? !result.pass : result.pass,\n        message: result.message,\n      };\n    },\n\n    toBeReadonly(received: LocatorData) {\n      let result: RuleResult;\n      if (received.type === 'PropertyLocator') {\n        result = propertyCheckBeReadonly(received, !!this.isNot);\n      } else {\n        throw new Error(\n          `toBeReadonly matcher does not support ${received.type}`,\n        );\n      }\n      return {\n        pass: this.isNot ? !result.pass : result.pass,\n        message: result.message,\n      };\n    },\n\n    toDependOnFilesInFolder(received: LocatorData, folder: string) {\n      let result: RuleResult;\n      if (received.type === 'FileLocator') {\n        result = checkDependOnFilesInFolder(received, folder, !!this.isNot);\n      } else {\n        throw new Error(\n          `toDependOnFilesInFolder matcher does not support ${received.type}`,\n        );\n      }\n      return {\n        pass: this.isNot ? !result.pass : result.pass,\n        message: result.message,\n      };\n    },\n\n    toDependOnExternalModule(\n      received: LocatorData,\n      moduleName: string | RegExp,\n    ) {\n      let result: RuleResult;\n      if (received.type === 'FileLocator') {\n        result = checkDependOnExternalModule(\n          received,\n          moduleName,\n          !!this.isNot,\n        );\n      } else {\n        throw new Error(\n          `toDependOnExternalModule matcher does not support ${received.type}`,\n        );\n      }\n      return {\n        pass: this.isNot ? !result.pass : result.pass,\n        message: result.message,\n      };\n    },\n\n    toBeFreeOfCycles(received: LocatorData) {\n      let result: RuleResult;\n      if (received.type === 'FileLocator') {\n        result = fileCheckBeFreeOfCycles(received, !!this.isNot);\n      } else if (received.type === 'SliceLocator') {\n        result = sliceCheckBeFreeOfCycles(received, !!this.isNot);\n      } else {\n        throw new Error(\n          `toBeFreeOfCycles matcher does not support ${received.type}`,\n        );\n      }\n      return {\n        pass: this.isNot ? !result.pass : result.pass,\n        message: result.message,\n      };\n    },\n\n    toMatchNamePattern(received: LocatorData, pattern: string | RegExp) {\n      let result: RuleResult;\n      if (received.type === 'FileLocator') {\n        result = fileCheckMatchNamePattern(received, pattern, !!this.isNot);\n      } else if (received.type === 'ClassLocator') {\n        result = classCheckMatchNamePattern(received, pattern, !!this.isNot);\n      } else if (received.type === 'FunctionLocator') {\n        result = functionCheckMatchNamePattern(received, pattern, !!this.isNot);\n      } else {\n        throw new Error(\n          `toMatchNamePattern matcher does not support ${received.type}`,\n        );\n      }\n      return {\n        pass: this.isNot ? !result.pass : result.pass,\n        message: result.message,\n      };\n    },\n\n    toHaveMaxCyclomaticComplexity(received: LocatorData, max: number) {\n      let result: RuleResult;\n      if (received.type === 'FileLocator') {\n        result = fileCheckHaveMaxCyclomaticComplexity(\n          received,\n          max,\n          !!this.isNot,\n        );\n      } else if (received.type === 'ClassLocator') {\n        result = classCheckHaveMaxCyclomaticComplexity(\n          received,\n          max,\n          !!this.isNot,\n        );\n      } else if (received.type === 'FunctionLocator') {\n        result = functionCheckHaveMaxCyclomaticComplexity(\n          received,\n          max,\n          !!this.isNot,\n        );\n      } else {\n        throw new Error(\n          `toHaveMaxCyclomaticComplexity matcher does not support ${received.type}`,\n        );\n      }\n      return {\n        pass: this.isNot ? !result.pass : result.pass,\n        message: result.message,\n      };\n    },\n\n    toHaveMinMaintainabilityIndex(received: LocatorData, min: number) {\n      let result: RuleResult;\n      if (received.type === 'FileLocator') {\n        result = fileCheckHaveMinMaintainabilityIndex(\n          received,\n          min,\n          !!this.isNot,\n        );\n      } else if (received.type === 'FunctionLocator') {\n        result = functionCheckHaveMinMaintainabilityIndex(\n          received,\n          min,\n          !!this.isNot,\n        );\n      } else {\n        throw new Error(\n          `toHaveMinMaintainabilityIndex matcher does not support ${received.type}`,\n        );\n      }\n      return {\n        pass: this.isNot ? !result.pass : result.pass,\n        message: result.message,\n      };\n    },\n\n    toHaveMaxDistanceFromMainSequence(received: LocatorData, max: number) {\n      let result: RuleResult;\n      if (received.type === 'SliceLocator') {\n        result = sliceCheckHaveMaxDistanceFromMainSequence(\n          received,\n          max,\n          !!this.isNot,\n        );\n      } else {\n        throw new Error(\n          `toHaveMaxDistanceFromMainSequence matcher does not support ${received.type}`,\n        );\n      }\n      return {\n        pass: this.isNot ? !result.pass : result.pass,\n        message: result.message,\n      };\n    },\n\n    toHaveNameMatchingFileName(received: LocatorData) {\n      let result: RuleResult;\n      if (received.type === 'FunctionLocator') {\n        result = functionCheckHaveNameMatchingFileName(received, !!this.isNot);\n      } else if (received.type === 'ClassLocator') {\n        result = classCheckHaveNameMatchingFileName(received, !!this.isNot);\n      } else {\n        throw new Error(\n          `toHaveNameMatchingFileName matcher does not support ${received.type}`,\n        );\n      }\n      return {\n        pass: this.isNot ? !result.pass : result.pass,\n        message: result.message,\n      };\n    },\n\n    toHaveMaxExportedFunctions(received: LocatorData, max: number) {\n      let result: RuleResult;\n      if (received.type === 'FileLocator') {\n        result = fileCheckHaveMaxExportedFunctions(received, max, !!this.isNot);\n      } else {\n        throw new Error(\n          `toHaveMaxExportedFunctions matcher does not support ${received.type}`,\n        );\n      }\n      return {\n        pass: this.isNot ? !result.pass : result.pass,\n        message: result.message,\n      };\n    },\n  });\n}\n\ndeclare global {\n  namespace jest {\n    interface Matchers<R> extends ArchestMatchers<R> {}\n  }\n}\n"],"mappings":"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"}

package/dist/index.mjs

@@ -0,0 +1,162 @@
+import { checkDependOnExternalModule as e, checkDependOnFilesInFolder as t, checkLayeredArchitecture as n, classCheckExtendClass as r, classCheckHaveMaxCyclomaticComplexity as i, classCheckHaveModifier as a, classCheckHaveNameMatchingFileName as o, classCheckImplementInterface as s, classCheckMatchNamePattern as c, classCheckResideInFolder as l, fileCheckBeFreeOfCycles as u, fileCheckHaveMaxCyclomaticComplexity as d, fileCheckHaveMaxExportedFunctions as f, fileCheckHaveMinMaintainabilityIndex as p, fileCheckMatchNamePattern as m, functionCheckHaveExplicitReturnType as h, functionCheckHaveMaxCyclomaticComplexity as g, functionCheckHaveMinMaintainabilityIndex as _, functionCheckHaveModifier as v, functionCheckHaveNameMatchingFileName as y, functionCheckMatchNamePattern as b, parseProject as x, propertyCheckBeReadonly as S, sliceCheckBeFreeOfCycles as C, sliceCheckHaveMaxDistanceFromMainSequence as w } from "@archest/core";
+//#region src/matchers/index.ts
+function T() {
+	expect.extend({
+		toPass(e) {
+			let t;
+			t = e?.data && e.data.type === "LayeredArchitecture" ? n(e.data) : e;
+			let { pass: r, message: i } = t;
+			return {
+				pass: this.isNot ? !r : r,
+				message: r ? () => "Expected rule not to pass" : () => i()
+			};
+		},
+		toResideInFolder(e, t) {
+			let n;
+			if (e.type === "ClassLocator") n = l(e, t, !!this.isNot);
+			else throw Error(`toResideInFolder matcher does not support ${e.type}`);
+			return {
+				pass: this.isNot ? !n.pass : n.pass,
+				message: n.message
+			};
+		},
+		toHaveModifier(e, t) {
+			let n;
+			if (e.type === "ClassLocator") n = a(e, t, !!this.isNot);
+			else if (e.type === "FunctionLocator") n = v(e, t, !!this.isNot);
+			else throw Error(`toHaveModifier matcher does not support ${e.type}`);
+			return {
+				pass: this.isNot ? !n.pass : n.pass,
+				message: n.message
+			};
+		},
+		toExtendClass(e, t) {
+			let n;
+			if (e.type === "ClassLocator") n = r(e, t, !!this.isNot);
+			else throw Error(`toExtendClass matcher does not support ${e.type}`);
+			return {
+				pass: this.isNot ? !n.pass : n.pass,
+				message: n.message
+			};
+		},
+		toImplementInterface(e, t) {
+			let n;
+			if (e.type === "ClassLocator") n = s(e, t, !!this.isNot);
+			else throw Error(`toImplementInterface matcher does not support ${e.type}`);
+			return {
+				pass: this.isNot ? !n.pass : n.pass,
+				message: n.message
+			};
+		},
+		toHaveExplicitReturnType(e) {
+			let t;
+			if (e.type === "FunctionLocator") t = h(e, !!this.isNot);
+			else throw Error(`toHaveExplicitReturnType matcher does not support ${e.type}`);
+			return {
+				pass: this.isNot ? !t.pass : t.pass,
+				message: t.message
+			};
+		},
+		toBeReadonly(e) {
+			let t;
+			if (e.type === "PropertyLocator") t = S(e, !!this.isNot);
+			else throw Error(`toBeReadonly matcher does not support ${e.type}`);
+			return {
+				pass: this.isNot ? !t.pass : t.pass,
+				message: t.message
+			};
+		},
+		toDependOnFilesInFolder(e, n) {
+			let r;
+			if (e.type === "FileLocator") r = t(e, n, !!this.isNot);
+			else throw Error(`toDependOnFilesInFolder matcher does not support ${e.type}`);
+			return {
+				pass: this.isNot ? !r.pass : r.pass,
+				message: r.message
+			};
+		},
+		toDependOnExternalModule(t, n) {
+			let r;
+			if (t.type === "FileLocator") r = e(t, n, !!this.isNot);
+			else throw Error(`toDependOnExternalModule matcher does not support ${t.type}`);
+			return {
+				pass: this.isNot ? !r.pass : r.pass,
+				message: r.message
+			};
+		},
+		toBeFreeOfCycles(e) {
+			let t;
+			if (e.type === "FileLocator") t = u(e, !!this.isNot);
+			else if (e.type === "SliceLocator") t = C(e, !!this.isNot);
+			else throw Error(`toBeFreeOfCycles matcher does not support ${e.type}`);
+			return {
+				pass: this.isNot ? !t.pass : t.pass,
+				message: t.message
+			};
+		},
+		toMatchNamePattern(e, t) {
+			let n;
+			if (e.type === "FileLocator") n = m(e, t, !!this.isNot);
+			else if (e.type === "ClassLocator") n = c(e, t, !!this.isNot);
+			else if (e.type === "FunctionLocator") n = b(e, t, !!this.isNot);
+			else throw Error(`toMatchNamePattern matcher does not support ${e.type}`);
+			return {
+				pass: this.isNot ? !n.pass : n.pass,
+				message: n.message
+			};
+		},
+		toHaveMaxCyclomaticComplexity(e, t) {
+			let n;
+			if (e.type === "FileLocator") n = d(e, t, !!this.isNot);
+			else if (e.type === "ClassLocator") n = i(e, t, !!this.isNot);
+			else if (e.type === "FunctionLocator") n = g(e, t, !!this.isNot);
+			else throw Error(`toHaveMaxCyclomaticComplexity matcher does not support ${e.type}`);
+			return {
+				pass: this.isNot ? !n.pass : n.pass,
+				message: n.message
+			};
+		},
+		toHaveMinMaintainabilityIndex(e, t) {
+			let n;
+			if (e.type === "FileLocator") n = p(e, t, !!this.isNot);
+			else if (e.type === "FunctionLocator") n = _(e, t, !!this.isNot);
+			else throw Error(`toHaveMinMaintainabilityIndex matcher does not support ${e.type}`);
+			return {
+				pass: this.isNot ? !n.pass : n.pass,
+				message: n.message
+			};
+		},
+		toHaveMaxDistanceFromMainSequence(e, t) {
+			let n;
+			if (e.type === "SliceLocator") n = w(e, t, !!this.isNot);
+			else throw Error(`toHaveMaxDistanceFromMainSequence matcher does not support ${e.type}`);
+			return {
+				pass: this.isNot ? !n.pass : n.pass,
+				message: n.message
+			};
+		},
+		toHaveNameMatchingFileName(e) {
+			let t;
+			if (e.type === "FunctionLocator") t = y(e, !!this.isNot);
+			else if (e.type === "ClassLocator") t = o(e, !!this.isNot);
+			else throw Error(`toHaveNameMatchingFileName matcher does not support ${e.type}`);
+			return {
+				pass: this.isNot ? !t.pass : t.pass,
+				message: t.message
+			};
+		},
+		toHaveMaxExportedFunctions(e, t) {
+			let n;
+			if (e.type === "FileLocator") n = f(e, t, !!this.isNot);
+			else throw Error(`toHaveMaxExportedFunctions matcher does not support ${e.type}`);
+			return {
+				pass: this.isNot ? !n.pass : n.pass,
+				message: n.message
+			};
+		}
+	});
+}
+//#endregion
+export { x as parseProject, T as setupMatchers };
+
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../src/matchers/index.ts"],"sourcesContent":["/// <reference types=\"jest\" />\nimport {\n  checkDependOnExternalModule,\n  checkDependOnFilesInFolder,\n  checkLayeredArchitecture,\n  classCheckExtendClass,\n  classCheckHaveMaxCyclomaticComplexity,\n  classCheckHaveModifier,\n  classCheckHaveNameMatchingFileName,\n  classCheckImplementInterface,\n  classCheckMatchNamePattern,\n  classCheckResideInFolder,\n  fileCheckBeFreeOfCycles,\n  fileCheckHaveMaxCyclomaticComplexity,\n  fileCheckHaveMaxExportedFunctions,\n  fileCheckHaveMinMaintainabilityIndex,\n  fileCheckMatchNamePattern,\n  functionCheckHaveExplicitReturnType,\n  functionCheckHaveMaxCyclomaticComplexity,\n  functionCheckHaveMinMaintainabilityIndex,\n  functionCheckHaveModifier,\n  functionCheckHaveNameMatchingFileName,\n  functionCheckMatchNamePattern,\n  type LocatorData,\n  propertyCheckBeReadonly,\n  type RuleResult,\n  sliceCheckBeFreeOfCycles,\n  sliceCheckHaveMaxDistanceFromMainSequence,\n} from '@archest/core';\nimport type { ArchestMatchers } from './models';\n\nexport * from './models';\n\n/**\n * Registers all Archest custom matchers (e.g., `toResideInFolder`, `toHaveModifier`)\n * with the global Vitest `expect` instance.\n *\n * This function must be called exactly once before any architectural tests are run.\n * The standard way to do this is to add it to a Vitest setup file.\n *\n * @example\n * ```typescript\n * // test/setup.ts\n * import { setupMatchers } from '@archest/jest';\n * setupMatchers();\n * ```\n */\nexport function setupMatchers() {\n  expect.extend({\n    // biome-ignore lint/suspicious/noExplicitAny: Matcher signature\n    toPass(received: any) {\n      let result: RuleResult;\n\n      if (received?.data && received.data.type === 'LayeredArchitecture') {\n        result = checkLayeredArchitecture(received.data);\n      } else {\n        result = received as RuleResult;\n      }\n\n      const { pass, message } = result;\n      return {\n        pass: this.isNot ? !pass : pass,\n        message: pass ? () => 'Expected rule not to pass' : () => message(),\n      };\n    },\n\n    toResideInFolder(received: LocatorData, folder: string) {\n      let result: RuleResult;\n      if (received.type === 'ClassLocator') {\n        result = classCheckResideInFolder(received, folder, !!this.isNot);\n      } else {\n        throw new Error(\n          `toResideInFolder matcher does not support ${received.type}`,\n        );\n      }\n      return {\n        pass: this.isNot ? !result.pass : result.pass,\n        message: result.message,\n      };\n    },\n\n    toHaveModifier(received: LocatorData, modifier: string) {\n      let result: RuleResult;\n      if (received.type === 'ClassLocator') {\n        result = classCheckHaveModifier(received, modifier, !!this.isNot);\n      } else if (received.type === 'FunctionLocator') {\n        result = functionCheckHaveModifier(received, modifier, !!this.isNot);\n      } else {\n        throw new Error(\n          `toHaveModifier matcher does not support ${received.type}`,\n        );\n      }\n      return {\n        pass: this.isNot ? !result.pass : result.pass,\n        message: result.message,\n      };\n    },\n\n    toExtendClass(received: LocatorData, className: string) {\n      let result: RuleResult;\n      if (received.type === 'ClassLocator') {\n        result = classCheckExtendClass(received, className, !!this.isNot);\n      } else {\n        throw new Error(\n          `toExtendClass matcher does not support ${received.type}`,\n        );\n      }\n      return {\n        pass: this.isNot ? !result.pass : result.pass,\n        message: result.message,\n      };\n    },\n\n    toImplementInterface(received: LocatorData, interfaceName: string) {\n      let result: RuleResult;\n      if (received.type === 'ClassLocator') {\n        result = classCheckImplementInterface(\n          received,\n          interfaceName,\n          !!this.isNot,\n        );\n      } else {\n        throw new Error(\n          `toImplementInterface matcher does not support ${received.type}`,\n        );\n      }\n      return {\n        pass: this.isNot ? !result.pass : result.pass,\n        message: result.message,\n      };\n    },\n\n    toHaveExplicitReturnType(received: LocatorData) {\n      let result: RuleResult;\n      if (received.type === 'FunctionLocator') {\n        result = functionCheckHaveExplicitReturnType(received, !!this.isNot);\n      } else {\n        throw new Error(\n          `toHaveExplicitReturnType matcher does not support ${received.type}`,\n        );\n      }\n      return {\n        pass: this.isNot ? !result.pass : result.pass,\n        message: result.message,\n      };\n    },\n\n    toBeReadonly(received: LocatorData) {\n      let result: RuleResult;\n      if (received.type === 'PropertyLocator') {\n        result = propertyCheckBeReadonly(received, !!this.isNot);\n      } else {\n        throw new Error(\n          `toBeReadonly matcher does not support ${received.type}`,\n        );\n      }\n      return {\n        pass: this.isNot ? !result.pass : result.pass,\n        message: result.message,\n      };\n    },\n\n    toDependOnFilesInFolder(received: LocatorData, folder: string) {\n      let result: RuleResult;\n      if (received.type === 'FileLocator') {\n        result = checkDependOnFilesInFolder(received, folder, !!this.isNot);\n      } else {\n        throw new Error(\n          `toDependOnFilesInFolder matcher does not support ${received.type}`,\n        );\n      }\n      return {\n        pass: this.isNot ? !result.pass : result.pass,\n        message: result.message,\n      };\n    },\n\n    toDependOnExternalModule(\n      received: LocatorData,\n      moduleName: string | RegExp,\n    ) {\n      let result: RuleResult;\n      if (received.type === 'FileLocator') {\n        result = checkDependOnExternalModule(\n          received,\n          moduleName,\n          !!this.isNot,\n        );\n      } else {\n        throw new Error(\n          `toDependOnExternalModule matcher does not support ${received.type}`,\n        );\n      }\n      return {\n        pass: this.isNot ? !result.pass : result.pass,\n        message: result.message,\n      };\n    },\n\n    toBeFreeOfCycles(received: LocatorData) {\n      let result: RuleResult;\n      if (received.type === 'FileLocator') {\n        result = fileCheckBeFreeOfCycles(received, !!this.isNot);\n      } else if (received.type === 'SliceLocator') {\n        result = sliceCheckBeFreeOfCycles(received, !!this.isNot);\n      } else {\n        throw new Error(\n          `toBeFreeOfCycles matcher does not support ${received.type}`,\n        );\n      }\n      return {\n        pass: this.isNot ? !result.pass : result.pass,\n        message: result.message,\n      };\n    },\n\n    toMatchNamePattern(received: LocatorData, pattern: string | RegExp) {\n      let result: RuleResult;\n      if (received.type === 'FileLocator') {\n        result = fileCheckMatchNamePattern(received, pattern, !!this.isNot);\n      } else if (received.type === 'ClassLocator') {\n        result = classCheckMatchNamePattern(received, pattern, !!this.isNot);\n      } else if (received.type === 'FunctionLocator') {\n        result = functionCheckMatchNamePattern(received, pattern, !!this.isNot);\n      } else {\n        throw new Error(\n          `toMatchNamePattern matcher does not support ${received.type}`,\n        );\n      }\n      return {\n        pass: this.isNot ? !result.pass : result.pass,\n        message: result.message,\n      };\n    },\n\n    toHaveMaxCyclomaticComplexity(received: LocatorData, max: number) {\n      let result: RuleResult;\n      if (received.type === 'FileLocator') {\n        result = fileCheckHaveMaxCyclomaticComplexity(\n          received,\n          max,\n          !!this.isNot,\n        );\n      } else if (received.type === 'ClassLocator') {\n        result = classCheckHaveMaxCyclomaticComplexity(\n          received,\n          max,\n          !!this.isNot,\n        );\n      } else if (received.type === 'FunctionLocator') {\n        result = functionCheckHaveMaxCyclomaticComplexity(\n          received,\n          max,\n          !!this.isNot,\n        );\n      } else {\n        throw new Error(\n          `toHaveMaxCyclomaticComplexity matcher does not support ${received.type}`,\n        );\n      }\n      return {\n        pass: this.isNot ? !result.pass : result.pass,\n        message: result.message,\n      };\n    },\n\n    toHaveMinMaintainabilityIndex(received: LocatorData, min: number) {\n      let result: RuleResult;\n      if (received.type === 'FileLocator') {\n        result = fileCheckHaveMinMaintainabilityIndex(\n          received,\n          min,\n          !!this.isNot,\n        );\n      } else if (received.type === 'FunctionLocator') {\n        result = functionCheckHaveMinMaintainabilityIndex(\n          received,\n          min,\n          !!this.isNot,\n        );\n      } else {\n        throw new Error(\n          `toHaveMinMaintainabilityIndex matcher does not support ${received.type}`,\n        );\n      }\n      return {\n        pass: this.isNot ? !result.pass : result.pass,\n        message: result.message,\n      };\n    },\n\n    toHaveMaxDistanceFromMainSequence(received: LocatorData, max: number) {\n      let result: RuleResult;\n      if (received.type === 'SliceLocator') {\n        result = sliceCheckHaveMaxDistanceFromMainSequence(\n          received,\n          max,\n          !!this.isNot,\n        );\n      } else {\n        throw new Error(\n          `toHaveMaxDistanceFromMainSequence matcher does not support ${received.type}`,\n        );\n      }\n      return {\n        pass: this.isNot ? !result.pass : result.pass,\n        message: result.message,\n      };\n    },\n\n    toHaveNameMatchingFileName(received: LocatorData) {\n      let result: RuleResult;\n      if (received.type === 'FunctionLocator') {\n        result = functionCheckHaveNameMatchingFileName(received, !!this.isNot);\n      } else if (received.type === 'ClassLocator') {\n        result = classCheckHaveNameMatchingFileName(received, !!this.isNot);\n      } else {\n        throw new Error(\n          `toHaveNameMatchingFileName matcher does not support ${received.type}`,\n        );\n      }\n      return {\n        pass: this.isNot ? !result.pass : result.pass,\n        message: result.message,\n      };\n    },\n\n    toHaveMaxExportedFunctions(received: LocatorData, max: number) {\n      let result: RuleResult;\n      if (received.type === 'FileLocator') {\n        result = fileCheckHaveMaxExportedFunctions(received, max, !!this.isNot);\n      } else {\n        throw new Error(\n          `toHaveMaxExportedFunctions matcher does not support ${received.type}`,\n        );\n      }\n      return {\n        pass: this.isNot ? !result.pass : result.pass,\n        message: result.message,\n      };\n    },\n  });\n}\n\ndeclare global {\n  namespace jest {\n    interface Matchers<R> extends ArchestMatchers<R> {}\n  }\n}\n"],"mappings":";;AA+CA,SAAgB,IAAgB;AAC9B,QAAO,OAAO;EAEZ,OAAO,GAAe;GACpB,IAAI;AAEJ,GAGE,IAHE,GAAU,QAAQ,EAAS,KAAK,SAAS,wBAClC,EAAyB,EAAS,KAAK,GAEvC;GAGX,IAAM,EAAE,SAAM,eAAY;AAC1B,UAAO;IACL,MAAM,KAAK,QAAQ,CAAC,IAAO;IAC3B,SAAS,UAAa,oCAAoC,GAAS;IACpE;;EAGH,iBAAiB,GAAuB,GAAgB;GACtD,IAAI;AACJ,OAAI,EAAS,SAAS,eACpB,KAAS,EAAyB,GAAU,GAAQ,CAAC,CAAC,KAAK,MAAM;OAEjE,OAAU,MACR,6CAA6C,EAAS,OACvD;AAEH,UAAO;IACL,MAAM,KAAK,QAAQ,CAAC,EAAO,OAAO,EAAO;IACzC,SAAS,EAAO;IACjB;;EAGH,eAAe,GAAuB,GAAkB;GACtD,IAAI;AACJ,OAAI,EAAS,SAAS,eACpB,KAAS,EAAuB,GAAU,GAAU,CAAC,CAAC,KAAK,MAAM;YACxD,EAAS,SAAS,kBAC3B,KAAS,EAA0B,GAAU,GAAU,CAAC,CAAC,KAAK,MAAM;OAEpE,OAAU,MACR,2CAA2C,EAAS,OACrD;AAEH,UAAO;IACL,MAAM,KAAK,QAAQ,CAAC,EAAO,OAAO,EAAO;IACzC,SAAS,EAAO;IACjB;;EAGH,cAAc,GAAuB,GAAmB;GACtD,IAAI;AACJ,OAAI,EAAS,SAAS,eACpB,KAAS,EAAsB,GAAU,GAAW,CAAC,CAAC,KAAK,MAAM;OAEjE,OAAU,MACR,0CAA0C,EAAS,OACpD;AAEH,UAAO;IACL,MAAM,KAAK,QAAQ,CAAC,EAAO,OAAO,EAAO;IACzC,SAAS,EAAO;IACjB;;EAGH,qBAAqB,GAAuB,GAAuB;GACjE,IAAI;AACJ,OAAI,EAAS,SAAS,eACpB,KAAS,EACP,GACA,GACA,CAAC,CAAC,KAAK,MACR;OAED,OAAU,MACR,iDAAiD,EAAS,OAC3D;AAEH,UAAO;IACL,MAAM,KAAK,QAAQ,CAAC,EAAO,OAAO,EAAO;IACzC,SAAS,EAAO;IACjB;;EAGH,yBAAyB,GAAuB;GAC9C,IAAI;AACJ,OAAI,EAAS,SAAS,kBACpB,KAAS,EAAoC,GAAU,CAAC,CAAC,KAAK,MAAM;OAEpE,OAAU,MACR,qDAAqD,EAAS,OAC/D;AAEH,UAAO;IACL,MAAM,KAAK,QAAQ,CAAC,EAAO,OAAO,EAAO;IACzC,SAAS,EAAO;IACjB;;EAGH,aAAa,GAAuB;GAClC,IAAI;AACJ,OAAI,EAAS,SAAS,kBACpB,KAAS,EAAwB,GAAU,CAAC,CAAC,KAAK,MAAM;OAExD,OAAU,MACR,yCAAyC,EAAS,OACnD;AAEH,UAAO;IACL,MAAM,KAAK,QAAQ,CAAC,EAAO,OAAO,EAAO;IACzC,SAAS,EAAO;IACjB;;EAGH,wBAAwB,GAAuB,GAAgB;GAC7D,IAAI;AACJ,OAAI,EAAS,SAAS,cACpB,KAAS,EAA2B,GAAU,GAAQ,CAAC,CAAC,KAAK,MAAM;OAEnE,OAAU,MACR,oDAAoD,EAAS,OAC9D;AAEH,UAAO;IACL,MAAM,KAAK,QAAQ,CAAC,EAAO,OAAO,EAAO;IACzC,SAAS,EAAO;IACjB;;EAGH,yBACE,GACA,GACA;GACA,IAAI;AACJ,OAAI,EAAS,SAAS,cACpB,KAAS,EACP,GACA,GACA,CAAC,CAAC,KAAK,MACR;OAED,OAAU,MACR,qDAAqD,EAAS,OAC/D;AAEH,UAAO;IACL,MAAM,KAAK,QAAQ,CAAC,EAAO,OAAO,EAAO;IACzC,SAAS,EAAO;IACjB;;EAGH,iBAAiB,GAAuB;GACtC,IAAI;AACJ,OAAI,EAAS,SAAS,cACpB,KAAS,EAAwB,GAAU,CAAC,CAAC,KAAK,MAAM;YAC/C,EAAS,SAAS,eAC3B,KAAS,EAAyB,GAAU,CAAC,CAAC,KAAK,MAAM;OAEzD,OAAU,MACR,6CAA6C,EAAS,OACvD;AAEH,UAAO;IACL,MAAM,KAAK,QAAQ,CAAC,EAAO,OAAO,EAAO;IACzC,SAAS,EAAO;IACjB;;EAGH,mBAAmB,GAAuB,GAA0B;GAClE,IAAI;AACJ,OAAI,EAAS,SAAS,cACpB,KAAS,EAA0B,GAAU,GAAS,CAAC,CAAC,KAAK,MAAM;YAC1D,EAAS,SAAS,eAC3B,KAAS,EAA2B,GAAU,GAAS,CAAC,CAAC,KAAK,MAAM;YAC3D,EAAS,SAAS,kBAC3B,KAAS,EAA8B,GAAU,GAAS,CAAC,CAAC,KAAK,MAAM;OAEvE,OAAU,MACR,+CAA+C,EAAS,OACzD;AAEH,UAAO;IACL,MAAM,KAAK,QAAQ,CAAC,EAAO,OAAO,EAAO;IACzC,SAAS,EAAO;IACjB;;EAGH,8BAA8B,GAAuB,GAAa;GAChE,IAAI;AACJ,OAAI,EAAS,SAAS,cACpB,KAAS,EACP,GACA,GACA,CAAC,CAAC,KAAK,MACR;YACQ,EAAS,SAAS,eAC3B,KAAS,EACP,GACA,GACA,CAAC,CAAC,KAAK,MACR;YACQ,EAAS,SAAS,kBAC3B,KAAS,EACP,GACA,GACA,CAAC,CAAC,KAAK,MACR;OAED,OAAU,MACR,0DAA0D,EAAS,OACpE;AAEH,UAAO;IACL,MAAM,KAAK,QAAQ,CAAC,EAAO,OAAO,EAAO;IACzC,SAAS,EAAO;IACjB;;EAGH,8BAA8B,GAAuB,GAAa;GAChE,IAAI;AACJ,OAAI,EAAS,SAAS,cACpB,KAAS,EACP,GACA,GACA,CAAC,CAAC,KAAK,MACR;YACQ,EAAS,SAAS,kBAC3B,KAAS,EACP,GACA,GACA,CAAC,CAAC,KAAK,MACR;OAED,OAAU,MACR,0DAA0D,EAAS,OACpE;AAEH,UAAO;IACL,MAAM,KAAK,QAAQ,CAAC,EAAO,OAAO,EAAO;IACzC,SAAS,EAAO;IACjB;;EAGH,kCAAkC,GAAuB,GAAa;GACpE,IAAI;AACJ,OAAI,EAAS,SAAS,eACpB,KAAS,EACP,GACA,GACA,CAAC,CAAC,KAAK,MACR;OAED,OAAU,MACR,8DAA8D,EAAS,OACxE;AAEH,UAAO;IACL,MAAM,KAAK,QAAQ,CAAC,EAAO,OAAO,EAAO;IACzC,SAAS,EAAO;IACjB;;EAGH,2BAA2B,GAAuB;GAChD,IAAI;AACJ,OAAI,EAAS,SAAS,kBACpB,KAAS,EAAsC,GAAU,CAAC,CAAC,KAAK,MAAM;YAC7D,EAAS,SAAS,eAC3B,KAAS,EAAmC,GAAU,CAAC,CAAC,KAAK,MAAM;OAEnE,OAAU,MACR,uDAAuD,EAAS,OACjE;AAEH,UAAO;IACL,MAAM,KAAK,QAAQ,CAAC,EAAO,OAAO,EAAO;IACzC,SAAS,EAAO;IACjB;;EAGH,2BAA2B,GAAuB,GAAa;GAC7D,IAAI;AACJ,OAAI,EAAS,SAAS,cACpB,KAAS,EAAkC,GAAU,GAAK,CAAC,CAAC,KAAK,MAAM;OAEvE,OAAU,MACR,uDAAuD,EAAS,OACjE;AAEH,UAAO;IACL,MAAM,KAAK,QAAQ,CAAC,EAAO,OAAO,EAAO;IACzC,SAAS,EAAO;IACjB;;EAEJ,CAAC"}

package/dist/matchers/index.d.ts

@@ -0,0 +1,23 @@
+import { ArchestMatchers } from './models';
+export * from './models';
+/**
+ * Registers all Archest custom matchers (e.g., `toResideInFolder`, `toHaveModifier`)
+ * with the global Vitest `expect` instance.
+ *
+ * This function must be called exactly once before any architectural tests are run.
+ * The standard way to do this is to add it to a Vitest setup file.
+ *
+ * @example
+ * ```typescript
+ * // test/setup.ts
+ * import { setupMatchers } from '@archest/jest';
+ * setupMatchers();
+ * ```
+ */
+export declare function setupMatchers(): void;
+declare global {
+    namespace jest {
+        interface Matchers<R> extends ArchestMatchers<R> {
+        }
+    }
+}

package/dist/matchers/models.d.ts

@@ -0,0 +1,201 @@
+/**
+ * Native Vitest Matchers provided by Archest for architectural testing.
+ *
+ * This interface extends Vitest's `Assertion` interface to provide fluent assertions
+ * on your codebase's architectural structure.
+ */
+export interface ArchestMatchers<R = unknown> {
+    /**
+     * Asserts that the evaluated architectural rule passes.
+     * Primarily used for complex rules like LayeredArchitecture.
+     *
+     * @example
+     * ```typescript
+     * const architecture = project.layeredArchitecture()
+     *   .layer('Domain', 'domain')
+     *   .layer('Infrastructure', 'infrastructure');
+     *
+     * expect(architecture.whereLayer('Domain').shouldNotAccessAnyLayer().check()).toPass();
+     * ```
+     */
+    toPass(): void;
+    /**
+     * Asserts that the located elements physically reside within the specified folder.
+     * Supports ClassLocators.
+     *
+     * @param folder - The folder name or path pattern the elements must reside in.
+     * @example
+     * ```typescript
+     * const controllers = project.getClasses({ matchNamePattern: /Controller$/ });
+     * expect(controllers).toResideInFolder('controllers');
+     * ```
+     */
+    toResideInFolder(folder: string): void;
+    /**
+     * Asserts that the located elements have the specified TypeScript modifier.
+     * Supports ClassLocators and FunctionLocators.
+     *
+     * @param modifier - The AST modifier to enforce (e.g., 'export', 'abstract', 'async').
+     * @example
+     * ```typescript
+     * const helpers = project.getFunctions({ inFolder: 'utils' });
+     * expect(helpers).toHaveModifier('export');
+     * ```
+     */
+    toHaveModifier(modifier: 'export' | 'default' | 'abstract' | 'async' | 'private' | 'public'): void;
+    /**
+     * Asserts that the located classes extend the specified base class.
+     * Supports ClassLocators.
+     *
+     * @param className - The name of the class that must be extended.
+     * @example
+     * ```typescript
+     * const repositories = project.getClasses({ matchNamePattern: /Repository$/ });
+     * expect(repositories).toExtendClass('BaseRepository');
+     * ```
+     */
+    toExtendClass(className: string): void;
+    /**
+     * Asserts that the located classes implement the specified interface.
+     * Supports ClassLocators.
+     *
+     * @param interfaceName - The name of the interface that must be implemented.
+     * @example
+     * ```typescript
+     * const useCases = project.getClasses({ inFolder: 'use-cases' });
+     * expect(useCases).toImplementInterface('IUseCase');
+     * ```
+     */
+    toImplementInterface(interfaceName: string): void;
+    /**
+     * Asserts that the located functions have an explicit TypeScript return type.
+     * Supports FunctionLocators.
+     *
+     * @example
+     * ```typescript
+     * const domainFunctions = project.getFunctions({ inFolder: 'domain' });
+     * expect(domainFunctions).toHaveExplicitReturnType();
+     * ```
+     */
+    toHaveExplicitReturnType(): void;
+    /**
+     * Asserts that the located properties are marked as readonly.
+     * Supports PropertyLocators.
+     *
+     * @example
+     * ```typescript
+     * const dtoProps = project.getProperties({ classPattern: /Dto$/ });
+     * expect(dtoProps).toBeReadonly();
+     * ```
+     */
+    toBeReadonly(): void;
+    /**
+     * Asserts that the located files import dependencies from the specified folder.
+     * Supports FileLocators.
+     *
+     * @param folder - The target folder that must be imported.
+     * @example
+     * ```typescript
+     * const uiFiles = project.getFiles({ inFolder: 'ui' });
+     * expect(uiFiles).not.toDependOnFilesInFolder('database');
+     * ```
+     */
+    toDependOnFilesInFolder(folder: string): void;
+    /**
+     * Asserts that a file locator depends on a specific external module (e.g. from node_modules).
+     * Supports FileLocators.
+     *
+     * @param moduleName - The exact string name or RegExp of the external package (e.g. 'vue', 'lodash').
+     * @example
+     * ```typescript
+     * it('should only use gql-tada inside the graphql module', () => {
+     *   expect(
+     *     project.files().not.matching(/src\/graphql\//)
+     *   ).not.toDependOnExternalModule('gql-tada');
+     * });
+     * ```
+     */
+    toDependOnExternalModule(moduleName: string | RegExp): void;
+    /**
+     * Analyzes the AST dependency graph and asserts that the queried elements are entirely free of circular dependencies.
+     * Supports FileLocators and SliceLocators.
+     *
+     * @example
+     * ```typescript
+     * const domainFiles = project.getFiles({ inFolder: 'domain' });
+     * expect(domainFiles).toBeFreeOfCycles();
+     * ```
+     */
+    toBeFreeOfCycles(): void;
+    /**
+     * Asserts that the name of the located element matches the provided string or RegExp pattern.
+     * Supports FileLocators, ClassLocators, and FunctionLocators.
+     *
+     * @param pattern - The string or RegExp pattern that must match the name.
+     * @example
+     * ```typescript
+     * const controllers = project.getClasses({ withDecorator: 'Controller' });
+     * expect(controllers).toMatchNamePattern(/Controller$/);
+     * ```
+     */
+    toMatchNamePattern(pattern: string | RegExp): void;
+    /**
+     * Computes the cyclomatic complexity of the AST and asserts it is less than or equal to the maximum.
+     * Supports FileLocators, ClassLocators, and FunctionLocators.
+     *
+     * @param max - The maximum allowed cyclomatic complexity.
+     * @example
+     * ```typescript
+     * const coreFunctions = project.getFunctions({ inFolder: 'core' });
+     * expect(coreFunctions).toHaveMaxCyclomaticComplexity(10);
+     * ```
+     */
+    toHaveMaxCyclomaticComplexity(max: number): void;
+    /**
+     * Computes the maintainability index based on Halstead metrics and asserts it is greater than or equal to the minimum.
+     * Supports FileLocators and FunctionLocators.
+     *
+     * @param min - The minimum acceptable maintainability index (0-100).
+     * @example
+     * ```typescript
+     * const coreFiles = project.getFiles({ inFolder: 'core' });
+     * expect(coreFiles).toHaveMinMaintainabilityIndex(65);
+     * ```
+     */
+    toHaveMinMaintainabilityIndex(min: number): void;
+    /**
+     * Computes the Robert C. Martin Distance from the Main Sequence for the slice and asserts it is less than or equal to the maximum.
+     * Supports SliceLocators.
+     *
+     * @param max - The maximum allowed distance from the main sequence (0 to 1).
+     * @example
+     * ```typescript
+     * const slices = project.getSlices('modules/(*)/');
+     * expect(slices).toHaveMaxDistanceFromMainSequence(0.3);
+     * ```
+     */
+    toHaveMaxDistanceFromMainSequence(max: number): void;
+    /**
+     * Asserts that the exported class or function name exactly matches the name of its parent file.
+     * Supports ClassLocators and FunctionLocators.
+     *
+     * @example
+     * ```typescript
+     * const allFunctions = project.getFunctions();
+     * expect(allFunctions).toHaveNameMatchingFileName();
+     * ```
+     */
+    toHaveNameMatchingFileName(): void;
+    /**
+     * Asserts that the located file does not export more than the specified maximum number of functions.
+     * Supports FileLocators.
+     *
+     * @param max - The maximum number of allowed exported functions per file.
+     * @example
+     * ```typescript
+     * const utils = project.getFiles({ inFolder: 'utils' });
+     * expect(utils).toHaveMaxExportedFunctions(5);
+     * ```
+     */
+    toHaveMaxExportedFunctions(max: number): void;
+}

package/node_modules/@archest/core/dist/classes/classCheckExtendClass.d.ts

@@ -0,0 +1,3 @@
+import { RuleResult } from '../types';
+import { ClassLocatorData } from './types';
+export declare function classCheckExtendClass(locator: ClassLocatorData, className: string, isNot: boolean): RuleResult;

package/node_modules/@archest/core/dist/classes/classCheckHaveMaxCyclomaticComplexity.d.ts

@@ -0,0 +1,3 @@
+import { RuleResult } from '../types';
+import { ClassLocatorData } from './types';
+export declare function classCheckHaveMaxCyclomaticComplexity(locator: ClassLocatorData, max: number, isNot: boolean): RuleResult;

package/node_modules/@archest/core/dist/classes/classCheckHaveModifier.d.ts

@@ -0,0 +1,3 @@
+import { RuleResult } from '../types';
+import { ClassLocatorData } from './types';
+export declare function classCheckHaveModifier(locator: ClassLocatorData, modifierStr: string, isNot: boolean): RuleResult;

package/node_modules/@archest/core/dist/classes/classCheckHaveNameMatchingFileName.d.ts

@@ -0,0 +1,3 @@
+import { RuleResult } from '../types';
+import { ClassLocatorData } from './types';
+export declare function classCheckHaveNameMatchingFileName(locator: ClassLocatorData, isNot: boolean): RuleResult;

package/node_modules/@archest/core/dist/classes/classCheckImplementInterface.d.ts

@@ -0,0 +1,3 @@
+import { RuleResult } from '../types';
+import { ClassLocatorData } from './types';
+export declare function classCheckImplementInterface(locator: ClassLocatorData, interfaceName: string, isNot: boolean): RuleResult;

package/node_modules/@archest/core/dist/classes/classCheckMatchNamePattern.d.ts

@@ -0,0 +1,3 @@
+import { RuleResult } from '../types';
+import { ClassLocatorData } from './types';
+export declare function classCheckMatchNamePattern(locator: ClassLocatorData, pattern: string | RegExp, isNot: boolean): RuleResult;

package/node_modules/@archest/core/dist/classes/classCheckResideInFolder.d.ts

@@ -0,0 +1,3 @@
+import { RuleResult } from '../types';
+import { ClassLocatorData } from './types';
+export declare function classCheckResideInFolder(locator: ClassLocatorData, targetFolder: string, isNot: boolean): RuleResult;

package/node_modules/@archest/core/dist/classes/locateClasses.d.ts

@@ -0,0 +1,5 @@
+import { ClassData, ProjectData } from '../dto';
+import { ClassLocatorData, ClassQueryOptions } from './types';
+export declare function locateClasses(classes: (ClassData & {
+    _filePath: string;
+})[], projectData: ProjectData, options?: ClassQueryOptions): ClassLocatorData;

package/node_modules/@archest/core/dist/classes/types.d.ts

@@ -0,0 +1,25 @@
+import { ClassData, ProjectData } from '../dto';
+export interface ClassLocatorData {
+    type: 'ClassLocator';
+    classes: (ClassData & {
+        _filePath: string;
+    })[];
+    projectData: ProjectData;
+}
+/**
+ * Options to filter classes when querying the AST via `getClasses()`.
+ */
+export interface ClassQueryOptions {
+    /** Filters classes to only include those residing in a specific folder path. */
+    inFolder?: string;
+    /** Filters classes by a string or RegExp matching their name. */
+    matchNamePattern?: string | RegExp;
+    /** Filters classes to only include those that have the specified decorator applied. */
+    withDecorator?: string;
+    /** Filters classes to only include those extending the specified base class. */
+    extending?: string;
+    /** Filters classes to only include those implementing the specified interface. */
+    implementing?: string;
+    /** Filters classes to only include those with the specified AST modifier (e.g., 'export', 'abstract'). */
+    havingModifier?: string;
+}

package/node_modules/@archest/core/dist/dto.d.ts

@@ -0,0 +1,78 @@
+/**
+ * Represents the entire parsed project structure containing all analyzed files.
+ * This is the root node returned by the native Rust parser.
+ */
+export interface ProjectData {
+    /** A list of all files that were successfully parsed in the project workspace. */
+    files: FileData[];
+}
+/**
+ * Represents a single source file in the project.
+ * Contains information about its path, dependencies, and all nested code blocks.
+ */
+export interface FileData {
+    /** The absolute path to the file. */
+    path: string;
+    /** An array of all classes defined within this file. */
+    classes: ClassData[];
+    /** An array of all top-level or exported functions defined within this file. */
+    functions: FunctionData[];
+    /** An array of properties extracted from classes or objects in the file. */
+    properties: PropertyData[];
+    /** An array of raw module paths this file imports (e.g., './utils', 'react'). */
+    dependencies?: string[];
+    /** An array of external module imports (e.g., 'react', 'lodash'). */
+    external_dependencies?: string[];
+}
+/**
+ * Represents a class declaration extracted from a TypeScript or JavaScript file.
+ * Includes architectural metadata such as its hierarchy and complexity.
+ */
+export interface ClassData {
+    /** The name of the class, or null if it is an anonymous class. */
+    name: string | null;
+    /** True if the class has an 'export' modifier. */
+    is_exported: boolean;
+    /** True if the class has an 'export default' modifier. */
+    is_default: boolean;
+    /** True if the class is marked as abstract. */
+    is_abstract: boolean;
+    /** The name of the parent class it extends, if any. */
+    extends: string | null;
+    /** An array of interface names this class implements. */
+    implements: string[];
+    /** An array of decorator names applied to the class. */
+    decorators: string[];
+    /** The computed McCabe cyclomatic complexity of the class methods. */
+    cyclomatic_complexity?: number;
+    /** The computed Halstead maintainability index (0-100). */
+    maintainability_index?: number;
+}
+/**
+ * Represents a function declaration or arrow function extracted from a file.
+ */
+export interface FunctionData {
+    /** The name of the function, or null if anonymous. */
+    name: string | null;
+    /** True if the function is exported from the file. */
+    is_exported: boolean;
+    /** True if the function is marked as async. */
+    is_async: boolean;
+    /** True if the function is defined at the root level of the file context. */
+    is_top_level: boolean;
+    /** True if the function explicitly declares a return type. */
+    has_explicit_return_type: boolean;
+    /** The computed McCabe cyclomatic complexity of the function body. */
+    cyclomatic_complexity?: number;
+    /** The computed Halstead maintainability index (0-100). */
+    maintainability_index?: number;
+}
+/**
+ * Represents a class property or interface member extracted from the AST.
+ */
+export interface PropertyData {
+    /** The name of the property. */
+    name: string;
+    /** True if the property is marked with the 'readonly' modifier. */
+    is_readonly: boolean;
+}

package/node_modules/@archest/core/dist/files/checkDependOnExternalModule.d.ts

@@ -0,0 +1,3 @@
+import { RuleResult } from '../types';
+import { FileLocatorData } from './types';
+export declare function checkDependOnExternalModule(locator: FileLocatorData, moduleName: string | RegExp, isNot: boolean): RuleResult;

package/node_modules/@archest/core/dist/files/checkDependOnFilesInFolder.d.ts

@@ -0,0 +1,3 @@
+import { RuleResult } from '../types';
+import { FileLocatorData } from './types';
+export declare function checkDependOnFilesInFolder(locator: FileLocatorData, targetFolder: string, isNot: boolean): RuleResult;

package/node_modules/@archest/core/dist/files/fileCheckBeFreeOfCycles.d.ts

@@ -0,0 +1,3 @@
+import { RuleResult } from '../types';
+import { FileLocatorData } from './types';
+export declare function fileCheckBeFreeOfCycles(locator: FileLocatorData, isNot: boolean): RuleResult;

package/node_modules/@archest/core/dist/files/fileCheckHaveMaxCyclomaticComplexity.d.ts

@@ -0,0 +1,3 @@
+import { RuleResult } from '../types';
+import { FileLocatorData } from './types';
+export declare function fileCheckHaveMaxCyclomaticComplexity(locator: FileLocatorData, max: number, isNot: boolean): RuleResult;

package/node_modules/@archest/core/dist/files/fileCheckHaveMaxExportedFunctions.d.ts

@@ -0,0 +1,3 @@
+import { RuleResult } from '../types';
+import { FileLocatorData } from './types';
+export declare function fileCheckHaveMaxExportedFunctions(locator: FileLocatorData, max: number, isNot: boolean): RuleResult;