@nielspeter/eess-ts 0.1.0

package/dist/rules/hygiene.js

@@ -0,0 +1,62 @@
+import { comment, STUB_PATTERNS } from '../helpers/matchers.js';
+import { beImported, haveNoUnusedExports } from '../conditions/reverse-dependency.js';
+import { functionNotContain, functionNotHaveEmptyBody, } from '../conditions/body-analysis-function.js';
+/**
+ * Module must be imported by at least one other module.
+ * Detects dead/orphaned files that nobody references.
+ *
+ * Exclude entry points (index.ts, main.ts) via .excluding().
+ *
+ * @example
+ * modules(p)
+ *   .that().resideInFolder('src/**')
+ *   .should().satisfy(noDeadModules())
+ *   .excluding('index.ts', 'main.ts')
+ *   .check()
+ */
+export function noDeadModules() {
+    return beImported();
+}
+/**
+ * Every exported symbol must be referenced by at least one other file.
+ * Detects exports that bloat the public API without consumers.
+ *
+ * @example
+ * modules(p)
+ *   .that().resideInFolder('src/**')
+ *   .should().satisfy(noUnusedExports())
+ *   .check()
+ */
+export function noUnusedExports() {
+    return haveNoUnusedExports();
+}
+/**
+ * No stub or deferred-work comments in function bodies.
+ * Catches common markers (see STUB_PATTERNS) and phrases like
+ * "not implemented" or "coming soon".
+ *
+ * Pass a custom pattern to override the defaults.
+ *
+ * @example
+ * functions(p)
+ *   .that().resideInFolder('src/**')
+ *   .should().satisfy(noStubComments())
+ *   .check()
+ */
+export function noStubComments(pattern = STUB_PATTERNS) {
+    return functionNotContain(comment(pattern));
+}
+/**
+ * Functions must not have empty bodies.
+ * An empty function compiles and passes type checks but does nothing.
+ *
+ * @example
+ * functions(p)
+ *   .that().resideInFolder('src/**')
+ *   .should().satisfy(noEmptyBodies())
+ *   .check()
+ */
+export function noEmptyBodies() {
+    return functionNotHaveEmptyBody();
+}
+//# sourceMappingURL=hygiene.js.map

package/dist/rules/hygiene.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hygiene.js","sourceRoot":"","sources":["../../src/rules/hygiene.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAA;AAC/D,OAAO,EAAE,UAAU,EAAE,mBAAmB,EAAE,MAAM,qCAAqC,CAAA;AACrF,OAAO,EACL,kBAAkB,EAClB,wBAAwB,GACzB,MAAM,yCAAyC,CAAA;AAEhD;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,aAAa;IAC3B,OAAO,UAAU,EAAE,CAAA;AACrB,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,eAAe;IAC7B,OAAO,mBAAmB,EAAE,CAAA;AAC9B,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,cAAc,CAAC,UAAkB,aAAa;IAC5D,OAAO,kBAAkB,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAA;AAC7C,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,aAAa;IAC3B,OAAO,wBAAwB,EAAE,CAAA;AACnC,CAAC"}

package/dist/rules/metrics-function.d.ts

@@ -0,0 +1,45 @@
+import type { ArchFunction } from '../models/arch-function.js';
+import type { Condition } from '@nielspeter/eess';
+/**
+ * Function must not exceed the given cyclomatic complexity.
+ *
+ * Uses fn.getBody() which returns the body Node for all function
+ * kinds (declarations, arrow functions, methods).
+ *
+ * @example
+ * ```ts
+ * import { maxFunctionComplexity } from '@nielspeter/eess-ts/rules/metrics'
+ *
+ * functions(p).that().resideInFolder('src/**')
+ *   .should().satisfy(maxFunctionComplexity(15))
+ *   .check()
+ * ```
+ */
+export declare function maxFunctionComplexity(threshold: number): Condition<ArchFunction>;
+/**
+ * Function must not exceed the given number of lines (span lines).
+ *
+ * @example
+ * ```ts
+ * import { maxFunctionLines } from '@nielspeter/eess-ts/rules/metrics'
+ *
+ * functions(p).should().satisfy(maxFunctionLines(40)).warn()
+ * ```
+ */
+export declare function maxFunctionLines(threshold: number): Condition<ArchFunction>;
+/**
+ * Function must not have more than the given number of parameters.
+ *
+ * Uses fn.getParameters() from the ArchFunction interface.
+ *
+ * @example
+ * ```ts
+ * import { maxFunctionParameters } from '@nielspeter/eess-ts/rules/metrics'
+ *
+ * functions(p).that().areExported()
+ *   .should().satisfy(maxFunctionParameters(4))
+ *   .check()
+ * ```
+ */
+export declare function maxFunctionParameters(threshold: number): Condition<ArchFunction>;
+//# sourceMappingURL=metrics-function.d.ts.map

package/dist/rules/metrics-function.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics-function.d.ts","sourceRoot":"","sources":["../../src/rules/metrics-function.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAA;AAC9D,OAAO,KAAK,EAAE,SAAS,EAAoB,MAAM,kBAAkB,CAAA;AAKnE;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC,YAAY,CAAC,CAoBhF;AAED;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC,YAAY,CAAC,CAoB3E;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC,YAAY,CAAC,CAoBhF"}

package/dist/rules/metrics-function.js

@@ -0,0 +1,87 @@
+import { createViolation } from '../core/violation.js';
+import { cyclomaticComplexity, linesOfCode } from '../helpers/complexity.js';
+/**
+ * Function must not exceed the given cyclomatic complexity.
+ *
+ * Uses fn.getBody() which returns the body Node for all function
+ * kinds (declarations, arrow functions, methods).
+ *
+ * @example
+ * ```ts
+ * import { maxFunctionComplexity } from '@nielspeter/eess-ts/rules/metrics'
+ *
+ * functions(p).that().resideInFolder('src/**')
+ *   .should().satisfy(maxFunctionComplexity(15))
+ *   .check()
+ * ```
+ */
+export function maxFunctionComplexity(threshold) {
+    return {
+        description: `have cyclomatic complexity <= ${String(threshold)}`,
+        evaluate(elements, context) {
+            const violations = [];
+            for (const fn of elements) {
+                const cc = cyclomaticComplexity(fn.getBody());
+                if (cc > threshold) {
+                    violations.push(createViolation(fn.getNode(), `${fn.getName() ?? '<anonymous>'} has cyclomatic complexity ${String(cc)} (max: ${String(threshold)})`, context));
+                }
+            }
+            return violations;
+        },
+    };
+}
+/**
+ * Function must not exceed the given number of lines (span lines).
+ *
+ * @example
+ * ```ts
+ * import { maxFunctionLines } from '@nielspeter/eess-ts/rules/metrics'
+ *
+ * functions(p).should().satisfy(maxFunctionLines(40)).warn()
+ * ```
+ */
+export function maxFunctionLines(threshold) {
+    return {
+        description: `have no more than ${String(threshold)} lines`,
+        evaluate(elements, context) {
+            const violations = [];
+            for (const fn of elements) {
+                const loc = linesOfCode(fn.getNode());
+                if (loc > threshold) {
+                    violations.push(createViolation(fn.getNode(), `${fn.getName() ?? '<anonymous>'} has ${String(loc)} lines (max: ${String(threshold)})`, context));
+                }
+            }
+            return violations;
+        },
+    };
+}
+/**
+ * Function must not have more than the given number of parameters.
+ *
+ * Uses fn.getParameters() from the ArchFunction interface.
+ *
+ * @example
+ * ```ts
+ * import { maxFunctionParameters } from '@nielspeter/eess-ts/rules/metrics'
+ *
+ * functions(p).that().areExported()
+ *   .should().satisfy(maxFunctionParameters(4))
+ *   .check()
+ * ```
+ */
+export function maxFunctionParameters(threshold) {
+    return {
+        description: `have no more than ${String(threshold)} parameters`,
+        evaluate(elements, context) {
+            const violations = [];
+            for (const fn of elements) {
+                const params = fn.getParameters().length;
+                if (params > threshold) {
+                    violations.push(createViolation(fn.getNode(), `${fn.getName() ?? '<anonymous>'} has ${String(params)} parameters (max: ${String(threshold)}) — use an options object`, context));
+                }
+            }
+            return violations;
+        },
+    };
+}
+//# sourceMappingURL=metrics-function.js.map

package/dist/rules/metrics-function.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics-function.js","sourceRoot":"","sources":["../../src/rules/metrics-function.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA;AACtD,OAAO,EAAE,oBAAoB,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAA;AAE5E;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,qBAAqB,CAAC,SAAiB;IACrD,OAAO;QACL,WAAW,EAAE,iCAAiC,MAAM,CAAC,SAAS,CAAC,EAAE;QACjE,QAAQ,CAAC,QAAwB,EAAE,OAAyB;YAC1D,MAAM,UAAU,GAAoB,EAAE,CAAA;YACtC,KAAK,MAAM,EAAE,IAAI,QAAQ,EAAE,CAAC;gBAC1B,MAAM,EAAE,GAAG,oBAAoB,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,CAAA;gBAC7C,IAAI,EAAE,GAAG,SAAS,EAAE,CAAC;oBACnB,UAAU,CAAC,IAAI,CACb,eAAe,CACb,EAAE,CAAC,OAAO,EAAE,EACZ,GAAG,EAAE,CAAC,OAAO,EAAE,IAAI,aAAa,8BAA8B,MAAM,CAAC,EAAE,CAAC,UAAU,MAAM,CAAC,SAAS,CAAC,GAAG,EACtG,OAAO,CACR,CACF,CAAA;gBACH,CAAC;YACH,CAAC;YACD,OAAO,UAAU,CAAA;QACnB,CAAC;KACF,CAAA;AACH,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,gBAAgB,CAAC,SAAiB;IAChD,OAAO;QACL,WAAW,EAAE,qBAAqB,MAAM,CAAC,SAAS,CAAC,QAAQ;QAC3D,QAAQ,CAAC,QAAwB,EAAE,OAAyB;YAC1D,MAAM,UAAU,GAAoB,EAAE,CAAA;YACtC,KAAK,MAAM,EAAE,IAAI,QAAQ,EAAE,CAAC;gBAC1B,MAAM,GAAG,GAAG,WAAW,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,CAAA;gBACrC,IAAI,GAAG,GAAG,SAAS,EAAE,CAAC;oBACpB,UAAU,CAAC,IAAI,CACb,eAAe,CACb,EAAE,CAAC,OAAO,EAAE,EACZ,GAAG,EAAE,CAAC,OAAO,EAAE,IAAI,aAAa,QAAQ,MAAM,CAAC,GAAG,CAAC,gBAAgB,MAAM,CAAC,SAAS,CAAC,GAAG,EACvF,OAAO,CACR,CACF,CAAA;gBACH,CAAC;YACH,CAAC;YACD,OAAO,UAAU,CAAA;QACnB,CAAC;KACF,CAAA;AACH,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,qBAAqB,CAAC,SAAiB;IACrD,OAAO;QACL,WAAW,EAAE,qBAAqB,MAAM,CAAC,SAAS,CAAC,aAAa;QAChE,QAAQ,CAAC,QAAwB,EAAE,OAAyB;YAC1D,MAAM,UAAU,GAAoB,EAAE,CAAA;YACtC,KAAK,MAAM,EAAE,IAAI,QAAQ,EAAE,CAAC;gBAC1B,MAAM,MAAM,GAAG,EAAE,CAAC,aAAa,EAAE,CAAC,MAAM,CAAA;gBACxC,IAAI,MAAM,GAAG,SAAS,EAAE,CAAC;oBACvB,UAAU,CAAC,IAAI,CACb,eAAe,CACb,EAAE,CAAC,OAAO,EAAE,EACZ,GAAG,EAAE,CAAC,OAAO,EAAE,IAAI,aAAa,QAAQ,MAAM,CAAC,MAAM,CAAC,qBAAqB,MAAM,CAAC,SAAS,CAAC,2BAA2B,EACvH,OAAO,CACR,CACF,CAAA;gBACH,CAAC;YACH,CAAC;YACD,OAAO,UAAU,CAAA;QACnB,CAAC;KACF,CAAA;AACH,CAAC"}

package/dist/rules/metrics.d.ts

@@ -0,0 +1,64 @@
+import type { ClassDeclaration } from 'ts-morph';
+import type { Condition } from '@nielspeter/eess';
+/**
+ * No method/constructor/getter/setter in the class may exceed the given
+ * cyclomatic complexity.
+ *
+ * @example
+ * ```ts
+ * import { maxCyclomaticComplexity } from '@nielspeter/eess-ts/rules/metrics'
+ *
+ * classes(p).should().satisfy(maxCyclomaticComplexity(15)).check()
+ * ```
+ */
+export declare function maxCyclomaticComplexity(threshold: number): Condition<ClassDeclaration>;
+/**
+ * No class may exceed the given number of lines (span lines).
+ *
+ * @example
+ * ```ts
+ * import { maxClassLines } from '@nielspeter/eess-ts/rules/metrics'
+ *
+ * classes(p).should().satisfy(maxClassLines(300)).warn()
+ * ```
+ */
+export declare function maxClassLines(threshold: number): Condition<ClassDeclaration>;
+/**
+ * No method/constructor/getter/setter may exceed the given number of lines.
+ *
+ * @example
+ * ```ts
+ * import { maxMethodLines } from '@nielspeter/eess-ts/rules/metrics'
+ *
+ * classes(p).should().satisfy(maxMethodLines(50)).warn()
+ * ```
+ */
+export declare function maxMethodLines(threshold: number): Condition<ClassDeclaration>;
+/**
+ * No class may have more than the given number of methods.
+ *
+ * Counts methods only (not constructors/getters/setters).
+ *
+ * @example
+ * ```ts
+ * import { maxMethods } from '@nielspeter/eess-ts/rules/metrics'
+ *
+ * classes(p).should().satisfy(maxMethods(15)).warn()
+ * ```
+ */
+export declare function maxMethods(threshold: number): Condition<ClassDeclaration>;
+/**
+ * No method/constructor may have more than the given number of parameters.
+ *
+ * @example
+ * ```ts
+ * import { maxParameters } from '@nielspeter/eess-ts/rules/metrics'
+ *
+ * classes(p).should().satisfy(maxParameters(4))
+ *   .because('use an options object for >4 parameters')
+ *   .check()
+ * ```
+ */
+export declare function maxParameters(threshold: number): Condition<ClassDeclaration>;
+export { maxFunctionComplexity, maxFunctionLines, maxFunctionParameters, } from './metrics-function.js';
+//# sourceMappingURL=metrics.d.ts.map

package/dist/rules/metrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.d.ts","sourceRoot":"","sources":["../../src/rules/metrics.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,gBAAgB,EAKjB,MAAM,UAAU,CAAA;AACjB,OAAO,KAAK,EAAE,SAAS,EAAoB,MAAM,kBAAkB,CAAA;AA8BnE;;;;;;;;;;GAUG;AACH,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC,gBAAgB,CAAC,CAsBtF;AAED;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC,gBAAgB,CAAC,CAoB5E;AAED;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC,gBAAgB,CAAC,CAsB7E;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC,gBAAgB,CAAC,CAoBzE;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC,gBAAgB,CAAC,CAsB5E;AAGD,OAAO,EACL,qBAAqB,EACrB,gBAAgB,EAChB,qBAAqB,GACtB,MAAM,uBAAuB,CAAA"}

package/dist/rules/metrics.js

@@ -0,0 +1,157 @@
+import { createViolation } from '../core/violation.js';
+import { cyclomaticComplexity, linesOfCode } from '../helpers/complexity.js';
+function getClassMembers(cls) {
+    return [
+        ...cls.getMethods(),
+        ...cls.getConstructors(),
+        ...cls.getGetAccessors(),
+        ...cls.getSetAccessors(),
+    ];
+}
+function getMemberName(cls, member) {
+    const clsName = cls.getName() ?? '<anonymous>';
+    if ('getName' in member && typeof member.getName === 'function') {
+        const memberName = String(member.getName());
+        return `${clsName}.${memberName}`;
+    }
+    return `${clsName}.constructor`;
+}
+/**
+ * No method/constructor/getter/setter in the class may exceed the given
+ * cyclomatic complexity.
+ *
+ * @example
+ * ```ts
+ * import { maxCyclomaticComplexity } from '@nielspeter/eess-ts/rules/metrics'
+ *
+ * classes(p).should().satisfy(maxCyclomaticComplexity(15)).check()
+ * ```
+ */
+export function maxCyclomaticComplexity(threshold) {
+    return {
+        description: `have no method with cyclomatic complexity > ${String(threshold)}`,
+        evaluate(elements, context) {
+            const violations = [];
+            for (const cls of elements) {
+                for (const member of getClassMembers(cls)) {
+                    const cc = cyclomaticComplexity(member.getBody());
+                    if (cc > threshold) {
+                        violations.push(createViolation(member, `${getMemberName(cls, member)} has cyclomatic complexity ${String(cc)} (max: ${String(threshold)}) — split into smaller methods`, context));
+                    }
+                }
+            }
+            return violations;
+        },
+    };
+}
+/**
+ * No class may exceed the given number of lines (span lines).
+ *
+ * @example
+ * ```ts
+ * import { maxClassLines } from '@nielspeter/eess-ts/rules/metrics'
+ *
+ * classes(p).should().satisfy(maxClassLines(300)).warn()
+ * ```
+ */
+export function maxClassLines(threshold) {
+    return {
+        description: `have no more than ${String(threshold)} lines`,
+        evaluate(elements, context) {
+            const violations = [];
+            for (const cls of elements) {
+                const loc = linesOfCode(cls);
+                if (loc > threshold) {
+                    violations.push(createViolation(cls, `${cls.getName() ?? '<anonymous>'} has ${String(loc)} lines (max: ${String(threshold)}) — consider splitting into focused classes`, context));
+                }
+            }
+            return violations;
+        },
+    };
+}
+/**
+ * No method/constructor/getter/setter may exceed the given number of lines.
+ *
+ * @example
+ * ```ts
+ * import { maxMethodLines } from '@nielspeter/eess-ts/rules/metrics'
+ *
+ * classes(p).should().satisfy(maxMethodLines(50)).warn()
+ * ```
+ */
+export function maxMethodLines(threshold) {
+    return {
+        description: `have no method longer than ${String(threshold)} lines`,
+        evaluate(elements, context) {
+            const violations = [];
+            for (const cls of elements) {
+                for (const member of getClassMembers(cls)) {
+                    const loc = linesOfCode(member);
+                    if (loc > threshold) {
+                        violations.push(createViolation(member, `${getMemberName(cls, member)} has ${String(loc)} lines (max: ${String(threshold)})`, context));
+                    }
+                }
+            }
+            return violations;
+        },
+    };
+}
+/**
+ * No class may have more than the given number of methods.
+ *
+ * Counts methods only (not constructors/getters/setters).
+ *
+ * @example
+ * ```ts
+ * import { maxMethods } from '@nielspeter/eess-ts/rules/metrics'
+ *
+ * classes(p).should().satisfy(maxMethods(15)).warn()
+ * ```
+ */
+export function maxMethods(threshold) {
+    return {
+        description: `have no more than ${String(threshold)} methods`,
+        evaluate(elements, context) {
+            const violations = [];
+            for (const cls of elements) {
+                const count = cls.getMethods().length;
+                if (count > threshold) {
+                    violations.push(createViolation(cls, `${cls.getName() ?? '<anonymous>'} has ${String(count)} methods (max: ${String(threshold)}) — consider splitting into focused classes`, context));
+                }
+            }
+            return violations;
+        },
+    };
+}
+/**
+ * No method/constructor may have more than the given number of parameters.
+ *
+ * @example
+ * ```ts
+ * import { maxParameters } from '@nielspeter/eess-ts/rules/metrics'
+ *
+ * classes(p).should().satisfy(maxParameters(4))
+ *   .because('use an options object for >4 parameters')
+ *   .check()
+ * ```
+ */
+export function maxParameters(threshold) {
+    return {
+        description: `have no method with more than ${String(threshold)} parameters`,
+        evaluate(elements, context) {
+            const violations = [];
+            for (const cls of elements) {
+                for (const member of getClassMembers(cls)) {
+                    const params = member.getParameters().length;
+                    if (params > threshold) {
+                        violations.push(createViolation(member, `${getMemberName(cls, member)} has ${String(params)} parameters (max: ${String(threshold)}) — use an options object`, context));
+                    }
+                }
+            }
+            return violations;
+        },
+    };
+}
+// Re-export function-level metric conditions from the same sub-path
+export { maxFunctionComplexity, maxFunctionLines, maxFunctionParameters, } from './metrics-function.js';
+//# sourceMappingURL=metrics.js.map

package/dist/rules/metrics.js.map

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

package/dist/rules/naming.d.ts

@@ -0,0 +1,24 @@
+import type { ClassDeclaration } from 'ts-morph';
+import type { Condition } from '@nielspeter/eess';
+/**
+ * Class name must match a regex pattern.
+ *
+ * This is the condition version of the `haveNameMatching` predicate.
+ * Use when you want to assert naming, not filter by it.
+ *
+ * @example
+ * classes(p).that().resideInFolder('** /controllers/** ')
+ *   .should().satisfy(mustMatchName(/Controller$/))
+ *   .check()
+ */
+export declare function mustMatchName(pattern: RegExp): Condition<ClassDeclaration>;
+/**
+ * Class must not have a specific suffix (anti-pattern detection).
+ *
+ * @example
+ * classes(p).that().resideInFolder('** /domain/** ')
+ *   .should().satisfy(mustNotEndWith('Entity'))
+ *   .check()
+ */
+export declare function mustNotEndWith(suffix: string): Condition<ClassDeclaration>;
+//# sourceMappingURL=naming.d.ts.map

package/dist/rules/naming.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"naming.d.ts","sourceRoot":"","sources":["../../src/rules/naming.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAA;AAChD,OAAO,KAAK,EAAE,SAAS,EAAoB,MAAM,kBAAkB,CAAA;AAInE;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC,gBAAgB,CAAC,CAoB1E;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,gBAAgB,CAAC,CAc1E"}

package/dist/rules/naming.js

@@ -0,0 +1,51 @@
+import { createViolation } from '../core/violation.js';
+/**
+ * Class name must match a regex pattern.
+ *
+ * This is the condition version of the `haveNameMatching` predicate.
+ * Use when you want to assert naming, not filter by it.
+ *
+ * @example
+ * classes(p).that().resideInFolder('** /controllers/** ')
+ *   .should().satisfy(mustMatchName(/Controller$/))
+ *   .check()
+ */
+export function mustMatchName(pattern) {
+    return {
+        description: `have name matching ${String(pattern)}`,
+        evaluate(elements, context) {
+            const violations = [];
+            for (const cls of elements) {
+                const name = cls.getName() ?? '<anonymous>';
+                if (!pattern.test(name)) {
+                    violations.push(createViolation(cls, `${name} does not match naming convention ${String(pattern)}`, context));
+                }
+            }
+            return violations;
+        },
+    };
+}
+/**
+ * Class must not have a specific suffix (anti-pattern detection).
+ *
+ * @example
+ * classes(p).that().resideInFolder('** /domain/** ')
+ *   .should().satisfy(mustNotEndWith('Entity'))
+ *   .check()
+ */
+export function mustNotEndWith(suffix) {
+    return {
+        description: `not have name ending with "${suffix}"`,
+        evaluate(elements, context) {
+            const violations = [];
+            for (const cls of elements) {
+                const name = cls.getName() ?? '<anonymous>';
+                if (name.endsWith(suffix)) {
+                    violations.push(createViolation(cls, `${name} should not end with "${suffix}"`, context));
+                }
+            }
+            return violations;
+        },
+    };
+}
+//# sourceMappingURL=naming.js.map

package/dist/rules/naming.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"naming.js","sourceRoot":"","sources":["../../src/rules/naming.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA;AAEtD;;;;;;;;;;GAUG;AACH,MAAM,UAAU,aAAa,CAAC,OAAe;IAC3C,OAAO;QACL,WAAW,EAAE,sBAAsB,MAAM,CAAC,OAAO,CAAC,EAAE;QACpD,QAAQ,CAAC,QAA4B,EAAE,OAAyB;YAC9D,MAAM,UAAU,GAAoB,EAAE,CAAA;YACtC,KAAK,MAAM,GAAG,IAAI,QAAQ,EAAE,CAAC;gBAC3B,MAAM,IAAI,GAAG,GAAG,CAAC,OAAO,EAAE,IAAI,aAAa,CAAA;gBAC3C,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;oBACxB,UAAU,CAAC,IAAI,CACb,eAAe,CACb,GAAG,EACH,GAAG,IAAI,qCAAqC,MAAM,CAAC,OAAO,CAAC,EAAE,EAC7D,OAAO,CACR,CACF,CAAA;gBACH,CAAC;YACH,CAAC;YACD,OAAO,UAAU,CAAA;QACnB,CAAC;KACF,CAAA;AACH,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,cAAc,CAAC,MAAc;IAC3C,OAAO;QACL,WAAW,EAAE,8BAA8B,MAAM,GAAG;QACpD,QAAQ,CAAC,QAA4B,EAAE,OAAyB;YAC9D,MAAM,UAAU,GAAoB,EAAE,CAAA;YACtC,KAAK,MAAM,GAAG,IAAI,QAAQ,EAAE,CAAC;gBAC3B,MAAM,IAAI,GAAG,GAAG,CAAC,OAAO,EAAE,IAAI,aAAa,CAAA;gBAC3C,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;oBAC1B,UAAU,CAAC,IAAI,CAAC,eAAe,CAAC,GAAG,EAAE,GAAG,IAAI,yBAAyB,MAAM,GAAG,EAAE,OAAO,CAAC,CAAC,CAAA;gBAC3F,CAAC;YACH,CAAC;YACD,OAAO,UAAU,CAAA;QACnB,CAAC;KACF,CAAA;AACH,CAAC"}

package/dist/rules/security.d.ts

@@ -0,0 +1,59 @@
+import type { ClassDeclaration, SourceFile } from 'ts-morph';
+import type { Condition } from '@nielspeter/eess';
+import type { ArchFunction } from '../models/arch-function.js';
+/**
+ * No eval() calls in class methods.
+ *
+ * @example
+ * classes(p).should().satisfy(noEval()).check()
+ */
+export declare function noEval(): Condition<ClassDeclaration>;
+/**
+ * No new Function() constructor (equivalent to eval).
+ *
+ * @example
+ * classes(p).should().satisfy(noFunctionConstructor()).check()
+ */
+export declare function noFunctionConstructor(): Condition<ClassDeclaration>;
+/**
+ * No direct process.env access in class methods.
+ *
+ * Use dependency injection for configuration instead.
+ *
+ * @example
+ * classes(p).that().resideInFolder('** /domain/** ')
+ *   .should().satisfy(noProcessEnv())
+ *   .because('use Config injection instead')
+ *   .check()
+ */
+export declare function noProcessEnv(): Condition<ClassDeclaration>;
+/**
+ * No console.log calls in class methods.
+ *
+ * Use a logger abstraction instead.
+ *
+ * @example
+ * classes(p).that().resideInFolder('** /src/** ')
+ *   .should().satisfy(noConsoleLog())
+ *   .check()
+ */
+export declare function noConsoleLog(): Condition<ClassDeclaration>;
+/**
+ * No direct console access (any method: log, warn, error, debug, info).
+ * Stricter than noConsoleLog — catches all console methods.
+ */
+export declare function noConsole(): Condition<ClassDeclaration>;
+/**
+ * No JSON.parse calls — centralize deserialization.
+ */
+export declare function noJsonParse(): Condition<ClassDeclaration>;
+export declare function functionNoEval(): Condition<ArchFunction>;
+export declare function functionNoFunctionConstructor(): Condition<ArchFunction>;
+export declare function functionNoProcessEnv(): Condition<ArchFunction>;
+export declare function functionNoConsoleLog(): Condition<ArchFunction>;
+export declare function functionNoConsole(): Condition<ArchFunction>;
+export declare function functionNoJsonParse(): Condition<ArchFunction>;
+export declare function moduleNoEval(): Condition<SourceFile>;
+export declare function moduleNoProcessEnv(): Condition<SourceFile>;
+export declare function moduleNoConsoleLog(): Condition<SourceFile>;
+//# sourceMappingURL=security.d.ts.map

package/dist/rules/security.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"security.d.ts","sourceRoot":"","sources":["../../src/rules/security.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,UAAU,CAAA;AAC5D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AACjD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAA;AAM9D;;;;;GAKG;AACH,wBAAgB,MAAM,IAAI,SAAS,CAAC,gBAAgB,CAAC,CAEpD;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,IAAI,SAAS,CAAC,gBAAgB,CAAC,CAEnE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,IAAI,SAAS,CAAC,gBAAgB,CAAC,CAE1D;AAED;;;;;;;;;GASG;AACH,wBAAgB,YAAY,IAAI,SAAS,CAAC,gBAAgB,CAAC,CAE1D;AAED;;;GAGG;AACH,wBAAgB,SAAS,IAAI,SAAS,CAAC,gBAAgB,CAAC,CAEvD;AAED;;GAEG;AACH,wBAAgB,WAAW,IAAI,SAAS,CAAC,gBAAgB,CAAC,CAEzD;AAID,wBAAgB,cAAc,IAAI,SAAS,CAAC,YAAY,CAAC,CAExD;AAED,wBAAgB,6BAA6B,IAAI,SAAS,CAAC,YAAY,CAAC,CAEvE;AAED,wBAAgB,oBAAoB,IAAI,SAAS,CAAC,YAAY,CAAC,CAE9D;AAED,wBAAgB,oBAAoB,IAAI,SAAS,CAAC,YAAY,CAAC,CAE9D;AAED,wBAAgB,iBAAiB,IAAI,SAAS,CAAC,YAAY,CAAC,CAE3D;AAED,wBAAgB,mBAAmB,IAAI,SAAS,CAAC,YAAY,CAAC,CAE7D;AAID,wBAAgB,YAAY,IAAI,SAAS,CAAC,UAAU,CAAC,CAEpD;AAED,wBAAgB,kBAAkB,IAAI,SAAS,CAAC,UAAU,CAAC,CAE1D;AAED,wBAAgB,kBAAkB,IAAI,SAAS,CAAC,UAAU,CAAC,CAE1D"}