@nielspeter/eess-ts 0.2.1 → 0.5.0

package/dist/builders/function-rule-builder.js

@@ -1,10 +1,29 @@
-import { RuleBuilder } from '@nielspeter/eess';
+import { RuleBuilder } from '../core/rule-builder.js';
 import { functionContain, functionNotContain, functionUseInsteadOf, functionNotHaveEmptyBody, } from '../conditions/body-analysis-function.js';
+import { createElementCache, SOLE_POPULATION } from '../core/element-cache.js';
 import { collectFunctions } from '../models/arch-function.js';
 import { followPattern as followPatternCondition } from '../conditions/pattern.js';
 import { notExist as fnNotExist, beExported as fnBeExported, beAsync as fnBeAsync, haveNameMatching as fnConditionHaveNameMatching, acceptParameterOfType as fnAcceptParameterOfType, notAcceptParameterOfType as fnNotAcceptParameterOfType, haveReturnTypeMatching as fnHaveReturnTypeMatching, resideInFile as fnConditionResideInFile, resideInFolder as fnConditionResideInFolder, } from '../conditions/function.js';
 import { haveNameMatching as identityHaveNameMatching, haveNameStartingWith as identityHaveNameStartingWith, haveNameEndingWith as identityHaveNameEndingWith, resideInFile as identityResideInFile, resideInFolder as identityResideInFolder, areExported as identityAreExported, areNotExported as identityAreNotExported, } from '../predicates/identity.js';
 import { arePublic as fnArePublic, areProtected as fnAreProtected, arePrivate as fnArePrivate, areAsync as fnAreAsync, areNotAsync as fnAreNotAsync, haveParameterCount as fnHaveParameterCount, haveParameterCountGreaterThan as fnHaveParameterCountGreaterThan, haveParameterCountLessThan as fnHaveParameterCountLessThan, haveParameterNamed as fnHaveParameterNamed, haveReturnType as fnHaveReturnType, haveRestParameter as fnHaveRestParameter, haveOptionalParameter as fnHaveOptionalParameter, haveParameterOfType as fnHaveParameterOfType, haveParameterNameMatching as fnHaveParameterNameMatching, } from '../predicates/function.js';
+/** One collection per (project, collection options), shared by every rule (plan 0075). */
+const cache = createElementCache();
+/**
+ * A canonical key for a collection-options object.
+ *
+ * Derived from the object's own entries, sorted — **not** `JSON.stringify`,
+ * which is key-order dependent, and not a hand-written list of the two fields,
+ * which would silently drop a third field added later and serve the wrong
+ * population under a colliding key.
+ */
+function optionsKey(options) {
+    if (options === undefined)
+        return SOLE_POPULATION;
+    return Object.entries(options)
+        .sort(([a], [b]) => a.localeCompare(b))
+        .map(([name, value]) => `${name}=${String(value)}`)
+        .join('|');
+}
 /**
  * Rule builder for function-level architecture rules.
  *
@@ -36,8 +55,20 @@ import { arePublic as fnArePublic, areProtected as fnAreProtected, arePrivate as
  * ```
  */
 export class FunctionRuleBuilder extends RuleBuilder {
+    _collectionOptions;
+    constructor(project, _collectionOptions) {
+        super(project);
+        this._collectionOptions = _collectionOptions;
+    }
     getElements() {
-        return this.project.getSourceFiles().flatMap((sf) => collectFunctions(sf));
+        // _collectionOptions survives `.should()` forks via RuleBuilder.fork()'s
+        // shallowClone in TerminalBuilder.copy — verified by the named-selection test.
+        //
+        // The options are part of the cache key, not just the collection call:
+        // `functions(p)` and `functions(p, COLLECT_ALL)` are DIFFERENT populations
+        // of the same project, so a project-only key would serve one the other's
+        // elements (plan 0075).
+        return cache.get(this.project, optionsKey(this._collectionOptions), () => this.project.getSourceFiles().flatMap((sf) => collectFunctions(sf, this._collectionOptions)));
     }
     // --- Identity predicates (delegated to plan 0003 generics) ---
     /**
@@ -45,17 +76,28 @@ export class FunctionRuleBuilder extends RuleBuilder {
      * After `.should()`: assert matched functions have names matching the pattern.
      */
     haveNameMatching(pattern) {
-        if (this._phase === 'condition') {
-            const regex = typeof pattern === 'string' ? new RegExp(pattern) : pattern;
-            return this.addCondition(fnConditionHaveNameMatching(regex));
-        }
-        return this.addPredicate(identityHaveNameMatching(pattern));
+        const regex = typeof pattern === 'string' ? new RegExp(pattern) : pattern;
+        return this.dualUse(fnConditionHaveNameMatching(regex), identityHaveNameMatching(pattern));
     }
-    /** Filter to functions whose name starts with the given prefix. */
+    /**
+     * Narrows the selection to functions that have a name starting with `prefix`.
+     *
+     * **Predicate only**, unlike the dual-use methods on this builder: it never
+     * becomes an assertion. Written after `.should()` it still filters, and the
+     * assertion gate reports it as a misplaced predicate rather than letting the
+     * rule pass having asserted nothing.
+     */
     haveNameStartingWith(prefix) {
         return this.addPredicate(identityHaveNameStartingWith(prefix));
     }
-    /** Filter to functions whose name ends with the given suffix. */
+    /**
+     * Narrows the selection to functions that have a name ending with `suffix`.
+     *
+     * **Predicate only**, unlike the dual-use methods on this builder: it never
+     * becomes an assertion. Written after `.should()` it still filters, and the
+     * assertion gate reports it as a misplaced predicate rather than letting the
+     * rule pass having asserted nothing.
+     */
     haveNameEndingWith(suffix) {
         return this.addPredicate(identityHaveNameEndingWith(suffix));
     }
@@ -64,94 +106,190 @@ export class FunctionRuleBuilder extends RuleBuilder {
      * After `.should()`: assert functions reside in a file matching the glob.
      */
     resideInFile(glob) {
-        if (this._phase === 'condition') {
-            return this.addCondition(fnConditionResideInFile(glob));
-        }
-        return this.addPredicate(identityResideInFile(glob));
+        return this.dualUse(fnConditionResideInFile(glob), identityResideInFile(glob));
     }
     /**
      * After `.that()`: filter functions in a folder matching the glob.
      * After `.should()`: assert functions reside in a folder matching the glob.
      */
     resideInFolder(glob) {
-        if (this._phase === 'condition') {
-            return this.addCondition(fnConditionResideInFolder(glob));
-        }
-        return this.addPredicate(identityResideInFolder(glob));
+        return this.dualUse(fnConditionResideInFolder(glob), identityResideInFolder(glob));
     }
-    /** Filter to functions that are exported from their module. */
+    /**
+     * Narrows the selection to functions that are exported.
+     *
+     * **Predicate only**, unlike the dual-use methods on this builder: it never
+     * becomes an assertion. Written after `.should()` it still filters, and the
+     * assertion gate reports it as a misplaced predicate rather than letting the
+     * rule pass having asserted nothing.
+     */
     areExported() {
         return this.addPredicate(identityAreExported());
     }
-    /** Filter to functions that are NOT exported from their module. */
+    /**
+     * Narrows the selection to functions that are not exported.
+     *
+     * **Predicate only**, unlike the dual-use methods on this builder: it never
+     * becomes an assertion. Written after `.should()` it still filters, and the
+     * assertion gate reports it as a misplaced predicate rather than letting the
+     * rule pass having asserted nothing.
+     */
     areNotExported() {
         return this.addPredicate(identityAreNotExported());
     }
     // --- Visibility predicates (plan 0032) ---
     /**
-     * Filter to public functions. Class methods match when `public` or
-     * unmarked; standalone and arrow functions are always public.
+     * Narrows the selection to functions that are public.
+     *
+     * **Predicate only**, unlike the dual-use methods on this builder: it never
+     * becomes an assertion. Written after `.should()` it still filters, and the
+     * assertion gate reports it as a misplaced predicate rather than letting the
+     * rule pass having asserted nothing.
      */
     arePublic() {
         return this.addPredicate(fnArePublic());
     }
-    /** Filter to `protected` class methods (standalone functions never match). */
+    /**
+     * Narrows the selection to functions that are protected.
+     *
+     * **Predicate only**, unlike the dual-use methods on this builder: it never
+     * becomes an assertion. Written after `.should()` it still filters, and the
+     * assertion gate reports it as a misplaced predicate rather than letting the
+     * rule pass having asserted nothing.
+     */
     areProtected() {
         return this.addPredicate(fnAreProtected());
     }
-    /** Filter to `private` class methods (standalone functions never match). */
+    /**
+     * Narrows the selection to functions that are private.
+     *
+     * **Predicate only**, unlike the dual-use methods on this builder: it never
+     * becomes an assertion. Written after `.should()` it still filters, and the
+     * assertion gate reports it as a misplaced predicate rather than letting the
+     * rule pass having asserted nothing.
+     */
     arePrivate() {
         return this.addPredicate(fnArePrivate());
     }
     // --- Function-specific predicates ---
-    /** Filter to functions declared with the `async` keyword. */
+    /**
+     * Narrows the selection to functions that are async.
+     *
+     * **Predicate only**, unlike the dual-use methods on this builder: it never
+     * becomes an assertion. Written after `.should()` it still filters, and the
+     * assertion gate reports it as a misplaced predicate rather than letting the
+     * rule pass having asserted nothing.
+     */
     areAsync() {
         return this.addPredicate(fnAreAsync());
     }
-    /** Filter to functions NOT declared `async`. */
+    /**
+     * Narrows the selection to functions that are not async.
+     *
+     * **Predicate only**, unlike the dual-use methods on this builder: it never
+     * becomes an assertion. Written after `.should()` it still filters, and the
+     * assertion gate reports it as a misplaced predicate rather than letting the
+     * rule pass having asserted nothing.
+     */
     areNotAsync() {
         return this.addPredicate(fnAreNotAsync());
     }
-    /** Filter to functions that declare exactly `n` parameters. */
+    /**
+     * Narrows the selection to functions that have exactly `n` parameters.
+     *
+     * **Predicate only**, unlike the dual-use methods on this builder: it never
+     * becomes an assertion. Written after `.should()` it still filters, and the
+     * assertion gate reports it as a misplaced predicate rather than letting the
+     * rule pass having asserted nothing.
+     */
     haveParameterCount(n) {
         return this.addPredicate(fnHaveParameterCount(n));
     }
-    /** Filter to functions that declare more than `n` parameters. */
+    /**
+     * Narrows the selection to functions that have more than `n` parameters.
+     *
+     * **Predicate only**, unlike the dual-use methods on this builder: it never
+     * becomes an assertion. Written after `.should()` it still filters, and the
+     * assertion gate reports it as a misplaced predicate rather than letting the
+     * rule pass having asserted nothing.
+     */
     haveParameterCountGreaterThan(n) {
         return this.addPredicate(fnHaveParameterCountGreaterThan(n));
     }
-    /** Filter to functions that declare fewer than `n` parameters. */
+    /**
+     * Narrows the selection to functions that have fewer than `n` parameters.
+     *
+     * **Predicate only**, unlike the dual-use methods on this builder: it never
+     * becomes an assertion. Written after `.should()` it still filters, and the
+     * assertion gate reports it as a misplaced predicate rather than letting the
+     * rule pass having asserted nothing.
+     */
     haveParameterCountLessThan(n) {
         return this.addPredicate(fnHaveParameterCountLessThan(n));
     }
-    /** Filter to functions that declare a parameter with the given exact name. */
+    /**
+     * Narrows the selection to functions that have a parameter named `name`.
+     *
+     * **Predicate only**, unlike the dual-use methods on this builder: it never
+     * becomes an assertion. Written after `.should()` it still filters, and the
+     * assertion gate reports it as a misplaced predicate rather than letting the
+     * rule pass having asserted nothing.
+     */
     haveParameterNamed(name) {
         return this.addPredicate(fnHaveParameterNamed(name));
     }
     /**
-     * Filter to functions whose return type text matches the pattern
-     * (e.g. `/Promise</`, `'void'`). A string is compiled to a RegExp.
+     * Narrows the selection to functions that have a return type matching `pattern`.
+     *
+     * **Predicate only**, unlike the dual-use methods on this builder: it never
+     * becomes an assertion. Written after `.should()` it still filters, and the
+     * assertion gate reports it as a misplaced predicate rather than letting the
+     * rule pass having asserted nothing.
      */
     haveReturnType(pattern) {
         return this.addPredicate(fnHaveReturnType(pattern));
     }
-    /** Filter to functions that declare a rest parameter (`...args`). */
+    /**
+     * Narrows the selection to functions that have a rest parameter.
+     *
+     * **Predicate only**, unlike the dual-use methods on this builder: it never
+     * becomes an assertion. Written after `.should()` it still filters, and the
+     * assertion gate reports it as a misplaced predicate rather than letting the
+     * rule pass having asserted nothing.
+     */
     haveRestParameter() {
         return this.addPredicate(fnHaveRestParameter());
     }
-    /** Filter to functions with at least one optional (`x?`) or default-valued parameter. */
+    /**
+     * Narrows the selection to functions that have an optional parameter.
+     *
+     * **Predicate only**, unlike the dual-use methods on this builder: it never
+     * becomes an assertion. Written after `.should()` it still filters, and the
+     * assertion gate reports it as a misplaced predicate rather than letting the
+     * rule pass having asserted nothing.
+     */
     haveOptionalParameter() {
         return this.addPredicate(fnHaveOptionalParameter());
     }
     /**
-     * Filter to functions whose parameter at `index` has a type satisfying
-     * the matcher. Out-of-bounds indices never match; for a rest parameter
-     * the type is the array type (e.g. `string[]`).
+     * Narrows the selection to functions that have parameter `index` of a type matching `matcher`.
+     *
+     * **Predicate only**, unlike the dual-use methods on this builder: it never
+     * becomes an assertion. Written after `.should()` it still filters, and the
+     * assertion gate reports it as a misplaced predicate rather than letting the
+     * rule pass having asserted nothing.
      */
     haveParameterOfType(index, matcher) {
         return this.addPredicate(fnHaveParameterOfType(index, matcher));
     }
-    /** Filter to functions with at least one parameter whose name matches the regex. */
+    /**
+     * Narrows the selection to functions that have a parameter name matching `pattern`.
+     *
+     * **Predicate only**, unlike the dual-use methods on this builder: it never
+     * becomes an assertion. Written after `.should()` it still filters, and the
+     * assertion gate reports it as a misplaced predicate rather than letting the
+     * rule pass having asserted nothing.
+     */
     haveParameterNameMatching(pattern) {
         return this.addPredicate(fnHaveParameterNameMatching(pattern));
     }
@@ -281,7 +419,7 @@ export class FunctionRuleBuilder extends RuleBuilder {
  *   .check()
  * ```
  */
-export function functions(p) {
-    return new FunctionRuleBuilder(p);
+export function functions(p, options) {
+    return new FunctionRuleBuilder(p, options);
 }
 //# sourceMappingURL=function-rule-builder.js.map

package/dist/builders/function-rule-builder.js.map

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

package/dist/builders/jsx-rule-builder.d.ts

@@ -1,5 +1,5 @@
 import type { ArchProject } from '../core/project.js';
-import { RuleBuilder } from '@nielspeter/eess';
+import { RuleBuilder } from '../core/rule-builder.js';
 import type { ArchJsxElement } from '../models/arch-jsx-element.js';
 /**
  * Rule builder for JSX element architecture rules.
@@ -35,32 +35,88 @@ import type { ArchJsxElement } from '../models/arch-jsx-element.js';
  *   .check()
  * ```
  */
-export declare class JsxRuleBuilder extends RuleBuilder<ArchJsxElement, ArchProject> {
+export declare class JsxRuleBuilder extends RuleBuilder<ArchJsxElement> {
     protected getElements(): ArchJsxElement[];
-    /** Filter to JSX elements whose tag/component name matches the pattern. */
+    /**
+     * Narrows the selection to JSX elements that have a name matching `pattern`.
+     *
+     * **Predicate only**, unlike the dual-use methods on this builder: it never
+     * becomes an assertion. Written after `.should()` it still filters, and the
+     * assertion gate reports it as a misplaced predicate rather than letting the
+     * rule pass having asserted nothing.
+     */
     haveNameMatching(pattern: RegExp | string): this;
-    /** Filter to JSX elements whose tag/component name starts with the prefix. */
+    /**
+     * Narrows the selection to JSX elements that have a name starting with `prefix`.
+     *
+     * **Predicate only**, unlike the dual-use methods on this builder: it never
+     * becomes an assertion. Written after `.should()` it still filters, and the
+     * assertion gate reports it as a misplaced predicate rather than letting the
+     * rule pass having asserted nothing.
+     */
     haveNameStartingWith(prefix: string): this;
-    /** Filter to JSX elements whose tag/component name ends with the suffix. */
+    /**
+     * Narrows the selection to JSX elements that have a name ending with `suffix`.
+     *
+     * **Predicate only**, unlike the dual-use methods on this builder: it never
+     * becomes an assertion. Written after `.should()` it still filters, and the
+     * assertion gate reports it as a misplaced predicate rather than letting the
+     * rule pass having asserted nothing.
+     */
     haveNameEndingWith(suffix: string): this;
-    /** Filter to JSX elements in a file whose absolute path matches the glob. */
+    /**
+     * Narrows the selection to JSX elements that reside in a file matching `glob`.
+     *
+     * **Predicate only**, unlike the dual-use methods on this builder: it never
+     * becomes an assertion. Written after `.should()` it still filters, and the
+     * assertion gate reports it as a misplaced predicate rather than letting the
+     * rule pass having asserted nothing.
+     */
     resideInFile(glob: string): this;
-    /** Filter to JSX elements in a folder whose path matches the glob. */
+    /**
+     * Narrows the selection to JSX elements that reside in a folder matching `glob`.
+     *
+     * **Predicate only**, unlike the dual-use methods on this builder: it never
+     * becomes an assertion. Written after `.should()` it still filters, and the
+     * assertion gate reports it as a misplaced predicate rather than letting the
+     * rule pass having asserted nothing.
+     */
     resideInFolder(glob: string): this;
     /**
-     * Filter to intrinsic HTML elements with any of the given lowercase tags
-     * (e.g. `areHtmlElements('button', 'input')`). Requires at least one tag.
+     * Narrows the selection to JSX elements that are the HTML elements named in `tags`.
+     *
+     * **Predicate only**, unlike the dual-use methods on this builder: it never
+     * becomes an assertion. Written after `.should()` it still filters, and the
+     * assertion gate reports it as a misplaced predicate rather than letting the
+     * rule pass having asserted nothing.
      */
     areHtmlElements(...tags: string[]): this;
     /**
-     * Filter to component elements (uppercase or dotted names). With no
-     * arguments matches all components; with names, only those (use the full
-     * dotted name for namespaced components, e.g. `'Icons.Check'`).
+     * Narrows the selection to JSX elements that are the components named in `names`.
+     *
+     * **Predicate only**, unlike the dual-use methods on this builder: it never
+     * becomes an assertion. Written after `.should()` it still filters, and the
+     * assertion gate reports it as a misplaced predicate rather than letting the
+     * rule pass having asserted nothing.
      */
     areComponents(...names: string[]): this;
-    /** Filter to elements that have the named attribute, regardless of value. */
+    /**
+     * Narrows the selection to JSX elements that have the attribute `name`.
+     *
+     * **Predicate only**, unlike the dual-use methods on this builder: it never
+     * becomes an assertion. Written after `.should()` it still filters, and the
+     * assertion gate reports it as a misplaced predicate rather than letting the
+     * rule pass having asserted nothing.
+     */
     withAttribute(name: string): this;
-    /** Filter to elements whose named attribute value equals the string or matches the regex. */
+    /**
+     * Narrows the selection to JSX elements that have attribute `name` with a value matching `value`.
+     *
+     * **Predicate only**, unlike the dual-use methods on this builder: it never
+     * becomes an assertion. Written after `.should()` it still filters, and the
+     * assertion gate reports it as a misplaced predicate rather than letting the
+     * rule pass having asserted nothing.
+     */
     withAttributeMatching(name: string, value: string | RegExp): this;
     /**
      * The filtered JSX element set must be empty.

package/dist/builders/jsx-rule-builder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"jsx-rule-builder.d.ts","sourceRoot":"","sources":["../../src/builders/jsx-rule-builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAC9C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAA;AAuBnE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,qBAAa,cAAe,SAAQ,WAAW,CAAC,cAAc,EAAE,WAAW,CAAC;IAC1E,SAAS,CAAC,WAAW,IAAI,cAAc,EAAE;IAMzC,2EAA2E;IAC3E,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAIhD,8EAA8E;IAC9E,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAI1C,4EAA4E;IAC5E,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAIxC,6EAA6E;IAC7E,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAIhC,sEAAsE;IACtE,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAMlC;;;OAGG;IACH,eAAe,CAAC,GAAG,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI;IAIxC;;;;OAIG;IACH,aAAa,CAAC,GAAG,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI;IAIvC,6EAA6E;IAC7E,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAIjC,6FAA6F;IAC7F,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAMjE;;OAEG;IACH,QAAQ,IAAI,IAAI;IAIhB;;OAEG;IACH,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAIjC;;OAEG;IACH,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAIpC;;OAEG;IACH,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAIjE;;OAEG;IACH,wBAAwB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;CAGrE;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,WAAW,GAAG,cAAc,CAE1D"}
+{"version":3,"file":"jsx-rule-builder.d.ts","sourceRoot":"","sources":["../../src/builders/jsx-rule-builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAA;AACrD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAA;AA2BnE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,qBAAa,cAAe,SAAQ,WAAW,CAAC,cAAc,CAAC;IAC7D,SAAS,CAAC,WAAW,IAAI,cAAc,EAAE;IAQzC;;;;;;;OAOG;IACH,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAIhD;;;;;;;OAOG;IACH,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAI1C;;;;;;;OAOG;IACH,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAIxC;;;;;;;OAOG;IACH,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAIhC;;;;;;;OAOG;IACH,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAMlC;;;;;;;OAOG;IACH,eAAe,CAAC,GAAG,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI;IAIxC;;;;;;;OAOG;IACH,aAAa,CAAC,GAAG,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI;IAIvC;;;;;;;OAOG;IACH,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAIjC;;;;;;;OAOG;IACH,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAMjE;;OAEG;IACH,QAAQ,IAAI,IAAI;IAIhB;;OAEG;IACH,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAIjC;;OAEG;IACH,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAIpC;;OAEG;IACH,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAIjE;;OAEG;IACH,wBAAwB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;CAGrE;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,WAAW,GAAG,cAAc,CAE1D"}

package/dist/builders/jsx-rule-builder.js

@@ -1,8 +1,11 @@
-import { RuleBuilder } from '@nielspeter/eess';
+import { RuleBuilder } from '../core/rule-builder.js';
+import { createElementCache, SOLE_POPULATION } from '../core/element-cache.js';
 import { collectJsxElements } from '../models/arch-jsx-element.js';
 import { haveNameMatching as identityHaveNameMatching, haveNameStartingWith as identityHaveNameStartingWith, haveNameEndingWith as identityHaveNameEndingWith, resideInFile as identityResideInFile, resideInFolder as identityResideInFolder, } from '../predicates/identity.js';
 import { areHtmlElements as jsxAreHtmlElements, areComponents as jsxAreComponents, withAttribute as jsxWithAttribute, withAttributeMatching as jsxWithAttributeMatching, } from '../predicates/jsx.js';
 import { notExist as jsxNotExist, haveAttribute as conditionHaveAttribute, notHaveAttribute as conditionNotHaveAttribute, haveAttributeMatching as conditionHaveAttributeMatching, notHaveAttributeMatching as conditionNotHaveAttributeMatching, } from '../conditions/jsx.js';
+/** One collection per project, shared by every rule built from it (plan 0075). */
+const cache = createElementCache();
 /**
  * Rule builder for JSX element architecture rules.
  *
@@ -39,50 +42,106 @@ import { notExist as jsxNotExist, haveAttribute as conditionHaveAttribute, notHa
  */
 export class JsxRuleBuilder extends RuleBuilder {
     getElements() {
-        return this.project.getSourceFiles().flatMap(collectJsxElements);
+        return cache.get(this.project, SOLE_POPULATION, () => this.project.getSourceFiles().flatMap(collectJsxElements));
     }
     // --- Identity predicates (predicate-only, following CallRuleBuilder pattern) ---
-    /** Filter to JSX elements whose tag/component name matches the pattern. */
+    /**
+     * Narrows the selection to JSX elements that have a name matching `pattern`.
+     *
+     * **Predicate only**, unlike the dual-use methods on this builder: it never
+     * becomes an assertion. Written after `.should()` it still filters, and the
+     * assertion gate reports it as a misplaced predicate rather than letting the
+     * rule pass having asserted nothing.
+     */
     haveNameMatching(pattern) {
         return this.addPredicate(identityHaveNameMatching(pattern));
     }
-    /** Filter to JSX elements whose tag/component name starts with the prefix. */
+    /**
+     * Narrows the selection to JSX elements that have a name starting with `prefix`.
+     *
+     * **Predicate only**, unlike the dual-use methods on this builder: it never
+     * becomes an assertion. Written after `.should()` it still filters, and the
+     * assertion gate reports it as a misplaced predicate rather than letting the
+     * rule pass having asserted nothing.
+     */
     haveNameStartingWith(prefix) {
         return this.addPredicate(identityHaveNameStartingWith(prefix));
     }
-    /** Filter to JSX elements whose tag/component name ends with the suffix. */
+    /**
+     * Narrows the selection to JSX elements that have a name ending with `suffix`.
+     *
+     * **Predicate only**, unlike the dual-use methods on this builder: it never
+     * becomes an assertion. Written after `.should()` it still filters, and the
+     * assertion gate reports it as a misplaced predicate rather than letting the
+     * rule pass having asserted nothing.
+     */
     haveNameEndingWith(suffix) {
         return this.addPredicate(identityHaveNameEndingWith(suffix));
     }
-    /** Filter to JSX elements in a file whose absolute path matches the glob. */
+    /**
+     * Narrows the selection to JSX elements that reside in a file matching `glob`.
+     *
+     * **Predicate only**, unlike the dual-use methods on this builder: it never
+     * becomes an assertion. Written after `.should()` it still filters, and the
+     * assertion gate reports it as a misplaced predicate rather than letting the
+     * rule pass having asserted nothing.
+     */
     resideInFile(glob) {
         return this.addPredicate(identityResideInFile(glob));
     }
-    /** Filter to JSX elements in a folder whose path matches the glob. */
+    /**
+     * Narrows the selection to JSX elements that reside in a folder matching `glob`.
+     *
+     * **Predicate only**, unlike the dual-use methods on this builder: it never
+     * becomes an assertion. Written after `.should()` it still filters, and the
+     * assertion gate reports it as a misplaced predicate rather than letting the
+     * rule pass having asserted nothing.
+     */
     resideInFolder(glob) {
         return this.addPredicate(identityResideInFolder(glob));
     }
     // --- JSX-specific predicates ---
     /**
-     * Filter to intrinsic HTML elements with any of the given lowercase tags
-     * (e.g. `areHtmlElements('button', 'input')`). Requires at least one tag.
+     * Narrows the selection to JSX elements that are the HTML elements named in `tags`.
+     *
+     * **Predicate only**, unlike the dual-use methods on this builder: it never
+     * becomes an assertion. Written after `.should()` it still filters, and the
+     * assertion gate reports it as a misplaced predicate rather than letting the
+     * rule pass having asserted nothing.
      */
     areHtmlElements(...tags) {
         return this.addPredicate(jsxAreHtmlElements(...tags));
     }
     /**
-     * Filter to component elements (uppercase or dotted names). With no
-     * arguments matches all components; with names, only those (use the full
-     * dotted name for namespaced components, e.g. `'Icons.Check'`).
+     * Narrows the selection to JSX elements that are the components named in `names`.
+     *
+     * **Predicate only**, unlike the dual-use methods on this builder: it never
+     * becomes an assertion. Written after `.should()` it still filters, and the
+     * assertion gate reports it as a misplaced predicate rather than letting the
+     * rule pass having asserted nothing.
      */
     areComponents(...names) {
         return this.addPredicate(jsxAreComponents(...names));
     }
-    /** Filter to elements that have the named attribute, regardless of value. */
+    /**
+     * Narrows the selection to JSX elements that have the attribute `name`.
+     *
+     * **Predicate only**, unlike the dual-use methods on this builder: it never
+     * becomes an assertion. Written after `.should()` it still filters, and the
+     * assertion gate reports it as a misplaced predicate rather than letting the
+     * rule pass having asserted nothing.
+     */
     withAttribute(name) {
         return this.addPredicate(jsxWithAttribute(name));
     }
-    /** Filter to elements whose named attribute value equals the string or matches the regex. */
+    /**
+     * Narrows the selection to JSX elements that have attribute `name` with a value matching `value`.
+     *
+     * **Predicate only**, unlike the dual-use methods on this builder: it never
+     * becomes an assertion. Written after `.should()` it still filters, and the
+     * assertion gate reports it as a misplaced predicate rather than letting the
+     * rule pass having asserted nothing.
+     */
     withAttributeMatching(name, value) {
         return this.addPredicate(jsxWithAttributeMatching(name, value));
     }

package/dist/builders/jsx-rule-builder.js.map

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

package/dist/builders/module-rule-builder.d.ts

@@ -1,5 +1,5 @@
 import type { SourceFile } from 'ts-morph';
-import { RuleBuilder } from '@nielspeter/eess';
+import { RuleBuilder } from '../core/rule-builder.js';
 import type { ArchProject } from '../core/project.js';
 import type { ImportOptions } from '../core/import-options.js';
 import type { ExpressionMatcher } from '../helpers/matchers.js';
@@ -17,7 +17,7 @@ import type { ModuleBodyOptions } from '../helpers/body-traversal.js';
  *   .because('domain must not depend on infrastructure')
  *   .check()
  */
-export declare class ModuleRuleBuilder extends RuleBuilder<SourceFile, ArchProject> {
+export declare class ModuleRuleBuilder extends RuleBuilder<SourceFile> {
     protected getElements(): SourceFile[];
     /**
      * Filter modules whose file name matches the given regex.