@nielspeter/eess-ts 0.1.0

package/dist/cli/watch.js

@@ -0,0 +1,138 @@
+import { watch } from 'node:fs/promises';
+import path from 'node:path';
+import { ArchRuleError } from '@nielspeter/eess';
+// eess-exclude eess/no-unused-exports: consumed by the test suite (tests are outside the build project)
+export const TS_FILE_RE = /\.[cm]?tsx?$/;
+/**
+ * Scheduling logic for watch mode — extracted for testability.
+ *
+ * Debounces rapid triggers. If a trigger arrives while the callback
+ * is running, it queues a re-run after the current run completes.
+ */
+// eess-exclude eess/no-unused-exports: consumed by the test suite (tests are outside the build project)
+export class RunScheduler {
+    debounceTimer;
+    running = false;
+    _pendingRerun = false;
+    debounceMs;
+    onRun;
+    #runCount = 0;
+    constructor(onRun, debounceMs = 250) {
+        this.onRun = onRun;
+        this.debounceMs = debounceMs;
+    }
+    get runCount() {
+        return this.#runCount;
+    }
+    get pendingRerun() {
+        return this._pendingRerun;
+    }
+    get isRunning() {
+        return this.running;
+    }
+    /**
+     * Queue a run for the given trigger, resetting the debounce window.
+     * If a run is already in progress, marks a pending re-run instead.
+     */
+    schedule(trigger) {
+        if (this.debounceTimer)
+            clearTimeout(this.debounceTimer);
+        this.debounceTimer = setTimeout(() => {
+            if (this.running) {
+                this._pendingRerun = true;
+                return;
+            }
+            this.executeRun(trigger);
+        }, this.debounceMs);
+    }
+    executeRun(trigger) {
+        this.running = true;
+        this._pendingRerun = false;
+        this.#runCount++;
+        process.stdout.write('\x1B[2J\x1B[H'); // clear screen, preserve scrollback
+        process.stdout.write(`Change detected: ${trigger}\n\n`);
+        this.onRun(trigger)
+            .catch((err) => {
+            // Rule failures are expected — swallow ArchRuleError, print others
+            if (!(err instanceof ArchRuleError)) {
+                if (err instanceof Error) {
+                    console.error(err.message);
+                }
+            }
+        })
+            .finally(() => {
+            this.running = false;
+            if (this._pendingRerun) {
+                this.executeRun('(queued change)');
+            }
+            else {
+                process.stdout.write('\nWatching for changes...\n');
+            }
+        });
+    }
+}
+/**
+ * Watch for file changes and re-run the callback.
+ *
+ * Uses Node.js `fs.watch` with `recursive: true` (Node 24+).
+ * Debounces rapid filesystem events. If a change arrives while
+ * a run is in progress, it is queued and executed after the
+ * current run completes.
+ *
+ * Known limitation: each re-run loads rule files with a fresh (cache-busting)
+ * jiti instance. Over long sessions, memory grows — restart the watcher
+ * periodically for long sessions.
+ */
+export function watchAndRerun(options) {
+    const { watchDirs, watchFiles, onChangeDetected, debounceMs = 250 } = options;
+    const scheduler = new RunScheduler(onChangeDetected, debounceMs);
+    const watchers = [];
+    // Watch directories recursively
+    for (const dir of watchDirs) {
+        const resolved = path.resolve(dir);
+        const watcher = watch(resolved, { recursive: true });
+        watchers.push(watcher);
+        void (async () => {
+            try {
+                for await (const event of watcher) {
+                    if (event.filename && TS_FILE_RE.test(event.filename)) {
+                        scheduler.schedule(event.filename);
+                    }
+                }
+            }
+            catch (err) {
+                if (err instanceof Error && err.message !== 'The operation was aborted') {
+                    console.error(`Watcher error on ${dir}: ${err.message}`);
+                }
+            }
+        })();
+    }
+    // Watch individual rule files
+    for (const file of watchFiles) {
+        const resolved = path.resolve(file);
+        const watcher = watch(resolved);
+        watchers.push(watcher);
+        void (async () => {
+            try {
+                // eslint-disable-next-line @typescript-eslint/no-unused-vars -- must consume async iterator
+                for await (const _event of watcher) {
+                    scheduler.schedule(path.basename(file));
+                }
+            }
+            catch (err) {
+                if (err instanceof Error && err.message !== 'The operation was aborted') {
+                    console.error(`Watcher error on ${file}: ${err.message}`);
+                }
+            }
+        })();
+    }
+    // Graceful shutdown — close all watchers on SIGINT
+    process.on('SIGINT', () => {
+        for (const w of watchers) {
+            // Ask each async iterator to release its underlying fs.watch handle.
+            void w[Symbol.asyncIterator]().return?.();
+        }
+        process.exit(0);
+    });
+}
+//# sourceMappingURL=watch.js.map

package/dist/cli/watch.js.map

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

package/dist/conditions/body-analysis-function.d.ts

@@ -0,0 +1,23 @@
+import type { Condition } from '@nielspeter/eess';
+import type { ExpressionMatcher } from '../helpers/matchers.js';
+import type { ArchFunction } from '../models/arch-function.js';
+/**
+ * Function body must contain at least one node matching the matcher.
+ */
+export declare function functionContain(matcher: ExpressionMatcher): Condition<ArchFunction>;
+/**
+ * Function body must NOT contain any node matching the matcher.
+ */
+export declare function functionNotContain(matcher: ExpressionMatcher): Condition<ArchFunction>;
+/**
+ * Function body must use the 'good' pattern instead of the 'bad' pattern.
+ */
+export declare function functionUseInsteadOf(bad: ExpressionMatcher, good: ExpressionMatcher): Condition<ArchFunction>;
+/**
+ * Function must not have an empty body (zero statements).
+ *
+ * Expression-bodied arrows (`() => expr`) always pass — they have no block body.
+ * A function with only comments is still considered empty (comments are not statements).
+ */
+export declare function functionNotHaveEmptyBody(): Condition<ArchFunction>;
+//# sourceMappingURL=body-analysis-function.d.ts.map

package/dist/conditions/body-analysis-function.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"body-analysis-function.d.ts","sourceRoot":"","sources":["../../src/conditions/body-analysis-function.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAoB,MAAM,kBAAkB,CAAA;AAEnE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAA;AAC/D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAA;AAwB9D;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,iBAAiB,GAAG,SAAS,CAAC,YAAY,CAAC,CAoBnF;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,iBAAiB,GAAG,SAAS,CAAC,YAAY,CAAC,CAoBtF;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,GAAG,EAAE,iBAAiB,EACtB,IAAI,EAAE,iBAAiB,GACtB,SAAS,CAAC,YAAY,CAAC,CAgCzB;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,IAAI,SAAS,CAAC,YAAY,CAAC,CAyBlE"}

package/dist/conditions/body-analysis-function.js

@@ -0,0 +1,103 @@
+import { Node } from 'ts-morph';
+import { searchFunctionBody } from '../helpers/body-traversal.js';
+/**
+ * Create an ArchViolation from an ArchFunction (not a Node).
+ *
+ * ArchFunction is not a Node, so we can't use createViolation directly.
+ * This helper bridges the gap.
+ */
+function createFunctionViolation(fn, message, context) {
+    return {
+        rule: context.rule,
+        element: fn.getName() ?? '<anonymous>',
+        file: fn.getSourceFile().getFilePath(),
+        line: fn.getStartLineNumber(),
+        message,
+        because: context.because,
+    };
+}
+/**
+ * Function body must contain at least one node matching the matcher.
+ */
+export function functionContain(matcher) {
+    return {
+        description: `contain ${matcher.description}`,
+        evaluate(elements, context) {
+            const violations = [];
+            for (const fn of elements) {
+                const result = searchFunctionBody(fn, matcher);
+                if (!result.found) {
+                    violations.push(createFunctionViolation(fn, `${fn.getName() ?? '<anonymous>'} does not contain ${matcher.description}`, context));
+                }
+            }
+            return violations;
+        },
+    };
+}
+/**
+ * Function body must NOT contain any node matching the matcher.
+ */
+export function functionNotContain(matcher) {
+    return {
+        description: `not contain ${matcher.description}`,
+        evaluate(elements, context) {
+            const violations = [];
+            for (const fn of elements) {
+                const result = searchFunctionBody(fn, matcher);
+                for (const node of result.matchingNodes) {
+                    violations.push(createFunctionViolation(fn, `${fn.getName() ?? '<anonymous>'} contains ${matcher.description} at line ${String(node.getStartLineNumber())}`, context));
+                }
+            }
+            return violations;
+        },
+    };
+}
+/**
+ * Function body must use the 'good' pattern instead of the 'bad' pattern.
+ */
+export function functionUseInsteadOf(bad, good) {
+    return {
+        description: `use ${good.description} instead of ${bad.description}`,
+        evaluate(elements, context) {
+            const violations = [];
+            for (const fn of elements) {
+                const badResult = searchFunctionBody(fn, bad);
+                const goodResult = searchFunctionBody(fn, good);
+                for (const node of badResult.matchingNodes) {
+                    violations.push(createFunctionViolation(fn, `${fn.getName() ?? '<anonymous>'} contains ${bad.description} at line ${String(node.getStartLineNumber())} — use ${good.description} instead`, context));
+                }
+                if (!goodResult.found) {
+                    violations.push(createFunctionViolation(fn, `${fn.getName() ?? '<anonymous>'} does not contain ${good.description}`, context));
+                }
+            }
+            return violations;
+        },
+    };
+}
+/**
+ * Function must not have an empty body (zero statements).
+ *
+ * Expression-bodied arrows (`() => expr`) always pass — they have no block body.
+ * A function with only comments is still considered empty (comments are not statements).
+ */
+export function functionNotHaveEmptyBody() {
+    return {
+        description: 'not have an empty body',
+        evaluate(elements, context) {
+            const violations = [];
+            for (const fn of elements) {
+                const body = fn.getBody();
+                if (!body)
+                    continue; // no body = declaration only, skip
+                // Expression-bodied arrows return the expression, not a Block
+                if (!Node.isBlock(body))
+                    continue; // expression body — always has content
+                if (body.getStatements().length === 0) {
+                    violations.push(createFunctionViolation(fn, `${fn.getName() ?? '<anonymous>'} has an empty body`, context));
+                }
+            }
+            return violations;
+        },
+    };
+}
+//# sourceMappingURL=body-analysis-function.js.map

package/dist/conditions/body-analysis-function.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"body-analysis-function.js","sourceRoot":"","sources":["../../src/conditions/body-analysis-function.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,UAAU,CAAA;AAK/B,OAAO,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAA;AAEjE;;;;;GAKG;AACH,SAAS,uBAAuB,CAC9B,EAAgB,EAChB,OAAe,EACf,OAAyB;IAEzB,OAAO;QACL,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,OAAO,EAAE,EAAE,CAAC,OAAO,EAAE,IAAI,aAAa;QACtC,IAAI,EAAE,EAAE,CAAC,aAAa,EAAE,CAAC,WAAW,EAAE;QACtC,IAAI,EAAE,EAAE,CAAC,kBAAkB,EAAE;QAC7B,OAAO;QACP,OAAO,EAAE,OAAO,CAAC,OAAO;KACzB,CAAA;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,OAA0B;IACxD,OAAO;QACL,WAAW,EAAE,WAAW,OAAO,CAAC,WAAW,EAAE;QAC7C,QAAQ,CAAC,QAAwB,EAAE,OAAyB;YAC1D,MAAM,UAAU,GAAoB,EAAE,CAAA;YACtC,KAAK,MAAM,EAAE,IAAI,QAAQ,EAAE,CAAC;gBAC1B,MAAM,MAAM,GAAG,kBAAkB,CAAC,EAAE,EAAE,OAAO,CAAC,CAAA;gBAC9C,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;oBAClB,UAAU,CAAC,IAAI,CACb,uBAAuB,CACrB,EAAE,EACF,GAAG,EAAE,CAAC,OAAO,EAAE,IAAI,aAAa,qBAAqB,OAAO,CAAC,WAAW,EAAE,EAC1E,OAAO,CACR,CACF,CAAA;gBACH,CAAC;YACH,CAAC;YACD,OAAO,UAAU,CAAA;QACnB,CAAC;KACF,CAAA;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,OAA0B;IAC3D,OAAO;QACL,WAAW,EAAE,eAAe,OAAO,CAAC,WAAW,EAAE;QACjD,QAAQ,CAAC,QAAwB,EAAE,OAAyB;YAC1D,MAAM,UAAU,GAAoB,EAAE,CAAA;YACtC,KAAK,MAAM,EAAE,IAAI,QAAQ,EAAE,CAAC;gBAC1B,MAAM,MAAM,GAAG,kBAAkB,CAAC,EAAE,EAAE,OAAO,CAAC,CAAA;gBAC9C,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,aAAa,EAAE,CAAC;oBACxC,UAAU,CAAC,IAAI,CACb,uBAAuB,CACrB,EAAE,EACF,GAAG,EAAE,CAAC,OAAO,EAAE,IAAI,aAAa,aAAa,OAAO,CAAC,WAAW,YAAY,MAAM,CAAC,IAAI,CAAC,kBAAkB,EAAE,CAAC,EAAE,EAC/G,OAAO,CACR,CACF,CAAA;gBACH,CAAC;YACH,CAAC;YACD,OAAO,UAAU,CAAA;QACnB,CAAC;KACF,CAAA;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAClC,GAAsB,EACtB,IAAuB;IAEvB,OAAO;QACL,WAAW,EAAE,OAAO,IAAI,CAAC,WAAW,eAAe,GAAG,CAAC,WAAW,EAAE;QACpE,QAAQ,CAAC,QAAwB,EAAE,OAAyB;YAC1D,MAAM,UAAU,GAAoB,EAAE,CAAA;YACtC,KAAK,MAAM,EAAE,IAAI,QAAQ,EAAE,CAAC;gBAC1B,MAAM,SAAS,GAAG,kBAAkB,CAAC,EAAE,EAAE,GAAG,CAAC,CAAA;gBAC7C,MAAM,UAAU,GAAG,kBAAkB,CAAC,EAAE,EAAE,IAAI,CAAC,CAAA;gBAE/C,KAAK,MAAM,IAAI,IAAI,SAAS,CAAC,aAAa,EAAE,CAAC;oBAC3C,UAAU,CAAC,IAAI,CACb,uBAAuB,CACrB,EAAE,EACF,GAAG,EAAE,CAAC,OAAO,EAAE,IAAI,aAAa,aAAa,GAAG,CAAC,WAAW,YAAY,MAAM,CAAC,IAAI,CAAC,kBAAkB,EAAE,CAAC,UAAU,IAAI,CAAC,WAAW,UAAU,EAC7I,OAAO,CACR,CACF,CAAA;gBACH,CAAC;gBAED,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;oBACtB,UAAU,CAAC,IAAI,CACb,uBAAuB,CACrB,EAAE,EACF,GAAG,EAAE,CAAC,OAAO,EAAE,IAAI,aAAa,qBAAqB,IAAI,CAAC,WAAW,EAAE,EACvE,OAAO,CACR,CACF,CAAA;gBACH,CAAC;YACH,CAAC;YACD,OAAO,UAAU,CAAA;QACnB,CAAC;KACF,CAAA;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,wBAAwB;IACtC,OAAO;QACL,WAAW,EAAE,wBAAwB;QACrC,QAAQ,CAAC,QAAwB,EAAE,OAAyB;YAC1D,MAAM,UAAU,GAAoB,EAAE,CAAA;YACtC,KAAK,MAAM,EAAE,IAAI,QAAQ,EAAE,CAAC;gBAC1B,MAAM,IAAI,GAAG,EAAE,CAAC,OAAO,EAAE,CAAA;gBACzB,IAAI,CAAC,IAAI;oBAAE,SAAQ,CAAC,mCAAmC;gBAEvD,8DAA8D;gBAC9D,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC;oBAAE,SAAQ,CAAC,uCAAuC;gBAEzE,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;oBACtC,UAAU,CAAC,IAAI,CACb,uBAAuB,CACrB,EAAE,EACF,GAAG,EAAE,CAAC,OAAO,EAAE,IAAI,aAAa,oBAAoB,EACpD,OAAO,CACR,CACF,CAAA;gBACH,CAAC;YACH,CAAC;YACD,OAAO,UAAU,CAAA;QACnB,CAAC;KACF,CAAA;AACH,CAAC"}

package/dist/conditions/body-analysis-module.d.ts

@@ -0,0 +1,27 @@
+import type { SourceFile } from 'ts-morph';
+import type { Condition } from '@nielspeter/eess';
+import type { ExpressionMatcher } from '../helpers/matchers.js';
+import { type ModuleBodyOptions } from '../helpers/body-traversal.js';
+/**
+ * Module must contain at least one node matching the matcher.
+ *
+ * Default: searches the entire file. With `{ scopeToModule: true }`,
+ * only searches top-level statements (skips class/function bodies).
+ */
+export declare function moduleContain(matcher: ExpressionMatcher, options?: ModuleBodyOptions): Condition<SourceFile>;
+/**
+ * Module must NOT contain any node matching the matcher.
+ *
+ * Produces one violation per matching node found.
+ * Default: searches the entire file. With `{ scopeToModule: true }`,
+ * only searches top-level statements (skips class/function bodies).
+ */
+export declare function moduleNotContain(matcher: ExpressionMatcher, options?: ModuleBodyOptions): Condition<SourceFile>;
+/**
+ * Module must use the 'good' pattern instead of the 'bad' pattern.
+ *
+ * Combines notContain(bad) and contain(good) into a single condition
+ * with better violation messages.
+ */
+export declare function moduleUseInsteadOf(bad: ExpressionMatcher, good: ExpressionMatcher, options?: ModuleBodyOptions): Condition<SourceFile>;
+//# sourceMappingURL=body-analysis-module.d.ts.map

package/dist/conditions/body-analysis-module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"body-analysis-module.d.ts","sourceRoot":"","sources":["../../src/conditions/body-analysis-module.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAA;AAC1C,OAAO,KAAK,EAAE,SAAS,EAAoB,MAAM,kBAAkB,CAAA;AAEnE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAA;AAC/D,OAAO,EAAoB,KAAK,iBAAiB,EAAE,MAAM,8BAA8B,CAAA;AAIvF;;;;;GAKG;AACH,wBAAgB,aAAa,CAC3B,OAAO,EAAE,iBAAiB,EAC1B,OAAO,CAAC,EAAE,iBAAiB,GAC1B,SAAS,CAAC,UAAU,CAAC,CAqBvB;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,iBAAiB,EAC1B,OAAO,CAAC,EAAE,iBAAiB,GAC1B,SAAS,CAAC,UAAU,CAAC,CAqBvB;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,iBAAiB,EACtB,IAAI,EAAE,iBAAiB,EACvB,OAAO,CAAC,EAAE,iBAAiB,GAC1B,SAAS,CAAC,UAAU,CAAC,CAkCvB"}

package/dist/conditions/body-analysis-module.js

@@ -0,0 +1,99 @@
+import { searchModuleBody } from '../helpers/body-traversal.js';
+// ─── Module body conditions ────────────────────────────────────────
+/**
+ * Module must contain at least one node matching the matcher.
+ *
+ * Default: searches the entire file. With `{ scopeToModule: true }`,
+ * only searches top-level statements (skips class/function bodies).
+ */
+export function moduleContain(matcher, options) {
+    return {
+        description: `contain ${matcher.description}`,
+        evaluate(elements, context) {
+            const violations = [];
+            for (const sf of elements) {
+                const result = searchModuleBody(sf, matcher, options);
+                if (!result.found) {
+                    violations.push({
+                        rule: context.rule,
+                        element: sf.getBaseName(),
+                        file: sf.getFilePath(),
+                        line: 1,
+                        message: `${sf.getBaseName()} does not contain ${matcher.description}`,
+                        because: context.because,
+                    });
+                }
+            }
+            return violations;
+        },
+    };
+}
+/**
+ * Module must NOT contain any node matching the matcher.
+ *
+ * Produces one violation per matching node found.
+ * Default: searches the entire file. With `{ scopeToModule: true }`,
+ * only searches top-level statements (skips class/function bodies).
+ */
+export function moduleNotContain(matcher, options) {
+    return {
+        description: `not contain ${matcher.description}`,
+        evaluate(elements, context) {
+            const violations = [];
+            for (const sf of elements) {
+                const result = searchModuleBody(sf, matcher, options);
+                for (const node of result.matchingNodes) {
+                    violations.push({
+                        rule: context.rule,
+                        element: sf.getBaseName(),
+                        file: sf.getFilePath(),
+                        line: node.getStartLineNumber(),
+                        message: `${sf.getBaseName()} contains ${matcher.description} at line ${String(node.getStartLineNumber())}`,
+                        because: context.because,
+                    });
+                }
+            }
+            return violations;
+        },
+    };
+}
+/**
+ * Module must use the 'good' pattern instead of the 'bad' pattern.
+ *
+ * Combines notContain(bad) and contain(good) into a single condition
+ * with better violation messages.
+ */
+export function moduleUseInsteadOf(bad, good, options) {
+    return {
+        description: `use ${good.description} instead of ${bad.description}`,
+        evaluate(elements, context) {
+            const violations = [];
+            for (const sf of elements) {
+                const badResult = searchModuleBody(sf, bad, options);
+                const goodResult = searchModuleBody(sf, good, options);
+                for (const node of badResult.matchingNodes) {
+                    violations.push({
+                        rule: context.rule,
+                        element: sf.getBaseName(),
+                        file: sf.getFilePath(),
+                        line: node.getStartLineNumber(),
+                        message: `${sf.getBaseName()} contains ${bad.description} at line ${String(node.getStartLineNumber())} — use ${good.description} instead`,
+                        because: context.because,
+                    });
+                }
+                if (!goodResult.found) {
+                    violations.push({
+                        rule: context.rule,
+                        element: sf.getBaseName(),
+                        file: sf.getFilePath(),
+                        line: 1,
+                        message: `${sf.getBaseName()} does not contain ${good.description}`,
+                        because: context.because,
+                    });
+                }
+            }
+            return violations;
+        },
+    };
+}
+//# sourceMappingURL=body-analysis-module.js.map

package/dist/conditions/body-analysis-module.js.map

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

package/dist/conditions/body-analysis.d.ts

@@ -0,0 +1,34 @@
+import type { ClassDeclaration } from 'ts-morph';
+import type { Condition } from '@nielspeter/eess';
+import type { ExpressionMatcher } from '../helpers/matchers.js';
+/**
+ * Class body must contain at least one node matching the matcher.
+ *
+ * Violation if NO method in the class contains a match.
+ */
+export declare function classContain(matcher: ExpressionMatcher): Condition<ClassDeclaration>;
+/**
+ * Class body must NOT contain any node matching the matcher.
+ *
+ * Violation for EACH matching node found in any method.
+ * Reports the specific line where the violation occurs.
+ */
+export declare function classNotContain(matcher: ExpressionMatcher): Condition<ClassDeclaration>;
+/**
+ * Class body must use the 'good' pattern instead of the 'bad' pattern.
+ *
+ * Combines notContain(bad) and contain(good) into a single condition
+ * with better violation messages.
+ *
+ * Two types of violations:
+ * 1. Class contains the 'bad' pattern — "use X instead of Y at line N"
+ * 2. Class does not contain the 'good' pattern — "expected X but not found"
+ */
+export declare function classUseInsteadOf(bad: ExpressionMatcher, good: ExpressionMatcher): Condition<ClassDeclaration>;
+/**
+ * Class must not have an empty body (zero members).
+ *
+ * A class with only comments is still considered empty.
+ */
+export declare function classNotHaveEmptyBody(): Condition<ClassDeclaration>;
+//# sourceMappingURL=body-analysis.d.ts.map

package/dist/conditions/body-analysis.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"body-analysis.d.ts","sourceRoot":"","sources":["../../src/conditions/body-analysis.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAA;AAChD,OAAO,KAAK,EAAE,SAAS,EAAoB,MAAM,kBAAkB,CAAA;AAGnE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAA;AAK/D;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,iBAAiB,GAAG,SAAS,CAAC,gBAAgB,CAAC,CAoBpF;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,iBAAiB,GAAG,SAAS,CAAC,gBAAgB,CAAC,CAoBvF;AAED;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,iBAAiB,EACtB,IAAI,EAAE,iBAAiB,GACtB,SAAS,CAAC,gBAAgB,CAAC,CAkC7B;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,IAAI,SAAS,CAAC,gBAAgB,CAAC,CAmBnE"}

package/dist/conditions/body-analysis.js

@@ -0,0 +1,95 @@
+import { createViolation, getElementName } from '../core/violation.js';
+import { searchClassBody } from '../helpers/body-traversal.js';
+// ─── Class body conditions ──────────────────────────────────────────
+/**
+ * Class body must contain at least one node matching the matcher.
+ *
+ * Violation if NO method in the class contains a match.
+ */
+export function classContain(matcher) {
+    return {
+        description: `contain ${matcher.description}`,
+        evaluate(elements, context) {
+            const violations = [];
+            for (const cls of elements) {
+                const result = searchClassBody(cls, matcher);
+                if (!result.found) {
+                    violations.push(createViolation(cls, `${getElementName(cls)} does not contain ${matcher.description}`, context));
+                }
+            }
+            return violations;
+        },
+    };
+}
+/**
+ * Class body must NOT contain any node matching the matcher.
+ *
+ * Violation for EACH matching node found in any method.
+ * Reports the specific line where the violation occurs.
+ */
+export function classNotContain(matcher) {
+    return {
+        description: `not contain ${matcher.description}`,
+        evaluate(elements, context) {
+            const violations = [];
+            for (const cls of elements) {
+                const result = searchClassBody(cls, matcher);
+                for (const node of result.matchingNodes) {
+                    violations.push(createViolation(cls, `${getElementName(cls)} contains ${matcher.description} at line ${String(node.getStartLineNumber())}`, context));
+                }
+            }
+            return violations;
+        },
+    };
+}
+/**
+ * Class body must use the 'good' pattern instead of the 'bad' pattern.
+ *
+ * Combines notContain(bad) and contain(good) into a single condition
+ * with better violation messages.
+ *
+ * Two types of violations:
+ * 1. Class contains the 'bad' pattern — "use X instead of Y at line N"
+ * 2. Class does not contain the 'good' pattern — "expected X but not found"
+ */
+export function classUseInsteadOf(bad, good) {
+    return {
+        description: `use ${good.description} instead of ${bad.description}`,
+        evaluate(elements, context) {
+            const violations = [];
+            for (const cls of elements) {
+                const badResult = searchClassBody(cls, bad);
+                const goodResult = searchClassBody(cls, good);
+                // Report each occurrence of the bad pattern
+                for (const node of badResult.matchingNodes) {
+                    violations.push(createViolation(cls, `${getElementName(cls)} contains ${bad.description} at line ${String(node.getStartLineNumber())} — use ${good.description} instead`, context));
+                }
+                // If the good pattern is missing entirely, report that too
+                if (!goodResult.found) {
+                    violations.push(createViolation(cls, `${getElementName(cls)} does not contain ${good.description}`, context));
+                }
+            }
+            return violations;
+        },
+    };
+}
+/**
+ * Class must not have an empty body (zero members).
+ *
+ * A class with only comments is still considered empty.
+ */
+export function classNotHaveEmptyBody() {
+    return {
+        description: 'not have an empty body',
+        evaluate(elements, context) {
+            const violations = [];
+            for (const cls of elements) {
+                if (cls.getMembers().length === 0) {
+                    violations.push(createViolation(cls, `${getElementName(cls)} has an empty body (zero members)`, context));
+                }
+            }
+            return violations;
+        },
+    };
+}
+//# sourceMappingURL=body-analysis.js.map

package/dist/conditions/body-analysis.js.map

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

package/dist/conditions/call.d.ts

@@ -0,0 +1,62 @@
+import type { Condition } from '@nielspeter/eess';
+import type { ExpressionMatcher } from '../helpers/matchers.js';
+import type { ArchCall } from '../models/arch-call.js';
+/**
+ * The filtered call set must be empty --- no calls should match the predicates.
+ */
+export declare function notExist(): Condition<ArchCall>;
+/**
+ * Assert that at least one callback argument contains a match.
+ *
+ * Searches all function-like arguments (ArrowFunction, FunctionExpression)
+ * for a node matching the given ExpressionMatcher.
+ */
+export declare function haveCallbackContaining(matcher: ExpressionMatcher): Condition<ArchCall>;
+/**
+ * Assert that NO callback argument contains a match.
+ *
+ * Produces one violation per matching node found in any callback.
+ */
+export declare function notHaveCallbackContaining(matcher: ExpressionMatcher): Condition<ArchCall>;
+/**
+ * Assert that at least one object literal argument has ALL named properties.
+ *
+ * Scans all arguments of each call for ObjectLiteralExpression nodes.
+ * Passes if at least one object literal argument contains every
+ * specified property name.
+ *
+ * @throws {Error} if called with zero property names
+ */
+export declare function haveArgumentWithProperty(...names: string[]): Condition<ArchCall>;
+/**
+ * Assert that NO object literal argument has ANY of the named properties.
+ *
+ * Scans all arguments of each call for ObjectLiteralExpression nodes.
+ * Reports one violation per forbidden property found in any argument.
+ *
+ * @throws {Error} if called with zero property names
+ */
+export declare function notHaveArgumentWithProperty(...names: string[]): Condition<ArchCall>;
+/**
+ * Assert that at least one argument subtree contains a match.
+ *
+ * Searches ALL arguments of each call recursively using `findMatchesInNode`.
+ * This is a superset of `haveCallbackContaining` — it searches the entire
+ * subtree of every argument (object literals, callbacks, nested expressions),
+ * not just function-like arguments. Use `haveCallbackContaining` when you
+ * only want to search callback bodies.
+ */
+export declare function haveArgumentContaining(matcher: ExpressionMatcher): Condition<ArchCall>;
+/**
+ * Assert that NO argument subtree contains a match.
+ *
+ * Searches ALL arguments of each call recursively using `findMatchesInNode`.
+ * Produces one violation per matching node found in any argument.
+ *
+ * This is a superset of `notHaveCallbackContaining` — it searches the entire
+ * subtree of every argument (object literals, callbacks, nested expressions),
+ * not just function-like arguments. Use `notHaveCallbackContaining` when you
+ * only want to search callback bodies.
+ */
+export declare function notHaveArgumentContaining(matcher: ExpressionMatcher): Condition<ArchCall>;
+//# sourceMappingURL=call.d.ts.map

package/dist/conditions/call.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"call.d.ts","sourceRoot":"","sources":["../../src/conditions/call.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAoB,MAAM,kBAAkB,CAAA;AAEnE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAA;AAC/D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAA;AAqCtD;;GAEG;AACH,wBAAgB,QAAQ,IAAI,SAAS,CAAC,QAAQ,CAAC,CAa9C;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,iBAAiB,GAAG,SAAS,CAAC,QAAQ,CAAC,CAoBtF;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,iBAAiB,GAAG,SAAS,CAAC,QAAQ,CAAC,CA6BzF;AAiCD;;;;;;;;GAQG;AACH,wBAAgB,wBAAwB,CAAC,GAAG,KAAK,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC,QAAQ,CAAC,CAsChF;AAED;;;;;;;GAOG;AACH,wBAAgB,2BAA2B,CAAC,GAAG,KAAK,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC,QAAQ,CAAC,CAqCnF;AAED;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,iBAAiB,GAAG,SAAS,CAAC,QAAQ,CAAC,CA4BtF;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,iBAAiB,GAAG,SAAS,CAAC,QAAQ,CAAC,CA0BzF"}