@nielspeter/eess-ts 0.2.1 → 0.5.0

package/dist/graphql/graphql-rule-builder.d.ts

@@ -0,0 +1,95 @@
+import type { Condition, Predicate, RuleDescription } from '@nielspeter/eess';
+import type { CollectResult } from '../core/terminal-builder.js';
+import { TerminalBuilder } from '../core/terminal-builder.js';
+/**
+ * What `SchemaRuleBuilder` and `ResolverRuleBuilder` both are.
+ *
+ * The two were one class written twice: identical `_predicates`/`_conditions`
+ * fields, identical `that`/`and`/`should`/`andShould`, `copy`,
+ * `assertsSomething`, `describeRule`, `selected`, `examinedUnits` and
+ * `collectViolations` — `no-copy-paste` reported the last pair as literally the
+ * same text. Extracting the shared body into a free function only shortened the
+ * copy; the honest reading of the finding is that the class is the duplicate.
+ *
+ * Neither extends `RuleBuilder`, because a GraphQL element is not a ts-morph
+ * node and the predicate/condition surfaces are the schema's own. What they do
+ * share is every piece of the ADR-010 evidence path, which is precisely where
+ * two copies have already cost this repo something: they once derived their
+ * `examined` count separately and disagreed, so a chain whose `.that()`
+ * selected nothing reported 14 units examined, handed its conditions 0, and
+ * passed green with `diagnose()` silent (plan 0096). One class is what makes
+ * "the preview derives from the same computation the gate uses" structural.
+ *
+ * Subclasses supply the four things that genuinely differ: where elements come
+ * from, the noun this family counts, the subject its description opens with,
+ * and the conditions its assertion-less remedy should name.
+ */
+export declare abstract class GraphqlRuleBuilder<T> extends TerminalBuilder {
+    protected _predicates: Predicate<T>[];
+    protected _conditions: Condition<T>[];
+    /**
+     * Per-instance rather than per-module, which is what a generic class allows:
+     * a single module-level `selectionMemo<T>()` cannot be typed for two element
+     * types. Keying is still by builder identity, and `copy()` hands the clone
+     * the same map, so the caching behaviour is the one the two modules had.
+     */
+    private readonly selectionOf;
+    /** Every candidate, before any predicate runs. */
+    protected abstract getElements(): T[];
+    /** The conditions this builder's assertion-less remedy should name, e.g. `'haveFields(...)'`. */
+    protected abstract conditionExamples(): string;
+    /** The noun the rule description opens with — `schema that …`, `resolvers that …`. */
+    protected abstract descriptionSubject(): string;
+    /** Begin the predicate phase. Purely a readability marker. */
+    that(): this;
+    /** Add another predicate (AND). */
+    and(): this;
+    /** Begin the condition phase. */
+    should(): this;
+    /** Add another condition (AND). */
+    andShould(): this;
+    /**
+     * An independent copy, carrying both lists.
+     *
+     * These builders do not extend `RuleBuilder`, so they do not inherit that
+     * class's override — and neither `that()` nor `should()` forked here at all,
+     * which made the bug 0016 leak worse on this hierarchy than on the main one:
+     * a held `schema()` selection accumulated every predicate and condition of
+     * every rule derived from it. `docs/graphql.md` teaches exactly that shape.
+     */
+    protected copy(): this;
+    /**
+     * Whether this rule states an assertion at all — the assertion gate's question.
+     *
+     * True once a condition has been added.
+     *
+     * Overrides the `TerminalBuilder` default (`true`), whose JSDoc carries the
+     * contract and the reason this is public rather than protected.
+     */
+    assertsSomething(): boolean;
+    /**
+     * The remedy for this builder's assertion-less state, as one string.
+     *
+     * One channel, so `diagnose()`'s advice and the finding's own message cannot
+     * disagree. Overrides `TerminalBuilder`'s generic text with wording specific to
+     * what this builder is missing.
+     */
+    assertionAdvice(): string;
+    /** Named by id or description, not 'unnamed' (plan 0070 §4). */
+    describeRule(): RuleDescription;
+    /**
+     * The set the conditions receive — plan 0096, and the ONE method every reader
+     * calls: `collectViolations()`, `examinedUnits()` and `diagnose()`'s preview
+     * all come through here, so none of them can answer "what did this rule look
+     * at" differently from the others.
+     */
+    protected selected(): T[];
+    /**
+     * How many units this rule actually examined — ADR-010's evidence that a pass
+     * was constructed rather than defaulted. The selection, not what precedes it.
+     */
+    examinedUnits(): number;
+    protected collectViolations(): CollectResult;
+    protected buildRuleDescription(): string;
+}
+//# sourceMappingURL=graphql-rule-builder.d.ts.map

package/dist/graphql/graphql-rule-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graphql-rule-builder.d.ts","sourceRoot":"","sources":["../../src/graphql/graphql-rule-builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AAQ7E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAA;AAChE,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAA;AAE7D;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,8BAAsB,kBAAkB,CAAC,CAAC,CAAE,SAAQ,eAAe;IACjE,SAAS,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC,CAAC,EAAE,CAAK;IAC1C,SAAS,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC,CAAC,EAAE,CAAK;IAE1C;;;;;OAKG;IACH,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAqB;IAEjD,kDAAkD;IAClD,SAAS,CAAC,QAAQ,CAAC,WAAW,IAAI,CAAC,EAAE;IAErC,iGAAiG;IACjG,SAAS,CAAC,QAAQ,CAAC,iBAAiB,IAAI,MAAM;IAE9C,sFAAsF;IACtF,SAAS,CAAC,QAAQ,CAAC,kBAAkB,IAAI,MAAM;IAI/C,8DAA8D;IAC9D,IAAI,IAAI,IAAI;IAIZ,mCAAmC;IACnC,GAAG,IAAI,IAAI;IAIX,iCAAiC;IACjC,MAAM,IAAI,IAAI;IAId,mCAAmC;IACnC,SAAS,IAAI,IAAI;IAMjB;;;;;;;;OAQG;cACgB,IAAI,IAAI,IAAI;IAO/B;;;;;;;OAOG;IACM,gBAAgB,IAAI,OAAO;IAIpC;;;;;;OAMG;IACM,eAAe,IAAI,MAAM;IAOlC,gEAAgE;IACvD,YAAY,IAAI,eAAe;IAOxC;;;;;OAKG;IACH,SAAS,CAAC,QAAQ,IAAI,CAAC,EAAE;IAIzB;;;OAGG;IACH,aAAa,IAAI,MAAM;IAIvB,SAAS,CAAC,iBAAiB,IAAI,aAAa;IAc5C,SAAS,CAAC,oBAAoB,IAAI,MAAM;CAGzC"}

package/dist/graphql/graphql-rule-builder.js

@@ -0,0 +1,127 @@
+import { conditionContextFrom, evaluateConditions, matchingElements, ruleDescriptionOf, selectionMemo, } from '@nielspeter/eess/internal';
+import { TerminalBuilder } from '../core/terminal-builder.js';
+/**
+ * What `SchemaRuleBuilder` and `ResolverRuleBuilder` both are.
+ *
+ * The two were one class written twice: identical `_predicates`/`_conditions`
+ * fields, identical `that`/`and`/`should`/`andShould`, `copy`,
+ * `assertsSomething`, `describeRule`, `selected`, `examinedUnits` and
+ * `collectViolations` — `no-copy-paste` reported the last pair as literally the
+ * same text. Extracting the shared body into a free function only shortened the
+ * copy; the honest reading of the finding is that the class is the duplicate.
+ *
+ * Neither extends `RuleBuilder`, because a GraphQL element is not a ts-morph
+ * node and the predicate/condition surfaces are the schema's own. What they do
+ * share is every piece of the ADR-010 evidence path, which is precisely where
+ * two copies have already cost this repo something: they once derived their
+ * `examined` count separately and disagreed, so a chain whose `.that()`
+ * selected nothing reported 14 units examined, handed its conditions 0, and
+ * passed green with `diagnose()` silent (plan 0096). One class is what makes
+ * "the preview derives from the same computation the gate uses" structural.
+ *
+ * Subclasses supply the four things that genuinely differ: where elements come
+ * from, the noun this family counts, the subject its description opens with,
+ * and the conditions its assertion-less remedy should name.
+ */
+export class GraphqlRuleBuilder extends TerminalBuilder {
+    _predicates = [];
+    _conditions = [];
+    /**
+     * Per-instance rather than per-module, which is what a generic class allows:
+     * a single module-level `selectionMemo<T>()` cannot be typed for two element
+     * types. Keying is still by builder identity, and `copy()` hands the clone
+     * the same map, so the caching behaviour is the one the two modules had.
+     */
+    selectionOf = selectionMemo();
+    // --- Chain methods (readability markers; the phase is implicit) ---
+    /** Begin the predicate phase. Purely a readability marker. */
+    that() {
+        return this;
+    }
+    /** Add another predicate (AND). */
+    and() {
+        return this;
+    }
+    /** Begin the condition phase. */
+    should() {
+        return this;
+    }
+    /** Add another condition (AND). */
+    andShould() {
+        return this;
+    }
+    // --- Evaluation ---
+    /**
+     * An independent copy, carrying both lists.
+     *
+     * These builders do not extend `RuleBuilder`, so they do not inherit that
+     * class's override — and neither `that()` nor `should()` forked here at all,
+     * which made the bug 0016 leak worse on this hierarchy than on the main one:
+     * a held `schema()` selection accumulated every predicate and condition of
+     * every rule derived from it. `docs/graphql.md` teaches exactly that shape.
+     */
+    copy() {
+        const clone = super.copy();
+        clone._predicates = [...this._predicates];
+        clone._conditions = [...this._conditions];
+        return clone;
+    }
+    /**
+     * Whether this rule states an assertion at all — the assertion gate's question.
+     *
+     * True once a condition has been added.
+     *
+     * Overrides the `TerminalBuilder` default (`true`), whose JSDoc carries the
+     * contract and the reason this is public rather than protected.
+     */
+    assertsSomething() {
+        return this._conditions.length > 0;
+    }
+    /**
+     * The remedy for this builder's assertion-less state, as one string.
+     *
+     * One channel, so `diagnose()`'s advice and the finding's own message cannot
+     * disagree. Overrides `TerminalBuilder`'s generic text with wording specific to
+     * what this builder is missing.
+     */
+    assertionAdvice() {
+        return ('this rule has no condition, so it asserts nothing and can never fail. Add a ' +
+            `condition after .should(), e.g. ${this.conditionExamples()}.`);
+    }
+    /** Named by id or description, not 'unnamed' (plan 0070 §4). */
+    describeRule() {
+        return {
+            ...super.describeRule(),
+            rule: this._metadata?.id ?? this.buildRuleDescription(),
+        };
+    }
+    /**
+     * The set the conditions receive — plan 0096, and the ONE method every reader
+     * calls: `collectViolations()`, `examinedUnits()` and `diagnose()`'s preview
+     * all come through here, so none of them can answer "what did this rule look
+     * at" differently from the others.
+     */
+    selected() {
+        return this.selectionOf(this, () => matchingElements(this.getElements(), this._predicates));
+    }
+    /**
+     * How many units this rule actually examined — ADR-010's evidence that a pass
+     * was constructed rather than defaulted. The selection, not what precedes it.
+     */
+    examinedUnits() {
+        return this.selected().length;
+    }
+    collectViolations() {
+        // The kernel's. The zero-evidence early exit and the `examined` count travel
+        // with it, so they cannot be derived apart.
+        return evaluateConditions(this.selected(), this._conditions, conditionContextFrom({
+            metadata: this._metadata,
+            reason: this._reason,
+            rule: this.buildRuleDescription(),
+        }));
+    }
+    buildRuleDescription() {
+        return ruleDescriptionOf(this._predicates, this._conditions, this.descriptionSubject());
+    }
+}
+//# sourceMappingURL=graphql-rule-builder.js.map

package/dist/graphql/graphql-rule-builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"graphql-rule-builder.js","sourceRoot":"","sources":["../../src/graphql/graphql-rule-builder.ts"],"names":[],"mappings":"AACA,OAAO,EACL,oBAAoB,EACpB,kBAAkB,EAClB,gBAAgB,EAChB,iBAAiB,EACjB,aAAa,GACd,MAAM,2BAA2B,CAAA;AAElC,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAA;AAE7D;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,OAAgB,kBAAsB,SAAQ,eAAe;IACvD,WAAW,GAAmB,EAAE,CAAA;IAChC,WAAW,GAAmB,EAAE,CAAA;IAE1C;;;;;OAKG;IACc,WAAW,GAAG,aAAa,EAAK,CAAA;IAWjD,qEAAqE;IAErE,8DAA8D;IAC9D,IAAI;QACF,OAAO,IAAI,CAAA;IACb,CAAC;IAED,mCAAmC;IACnC,GAAG;QACD,OAAO,IAAI,CAAA;IACb,CAAC;IAED,iCAAiC;IACjC,MAAM;QACJ,OAAO,IAAI,CAAA;IACb,CAAC;IAED,mCAAmC;IACnC,SAAS;QACP,OAAO,IAAI,CAAA;IACb,CAAC;IAED,qBAAqB;IAErB;;;;;;;;OAQG;IACgB,IAAI;QACrB,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,EAAE,CAAA;QAC1B,KAAK,CAAC,WAAW,GAAG,CAAC,GAAG,IAAI,CAAC,WAAW,CAAC,CAAA;QACzC,KAAK,CAAC,WAAW,GAAG,CAAC,GAAG,IAAI,CAAC,WAAW,CAAC,CAAA;QACzC,OAAO,KAAK,CAAA;IACd,CAAC;IAED;;;;;;;OAOG;IACM,gBAAgB;QACvB,OAAO,IAAI,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,CAAA;IACpC,CAAC;IAED;;;;;;OAMG;IACM,eAAe;QACtB,OAAO,CACL,8EAA8E;YAC9E,mCAAmC,IAAI,CAAC,iBAAiB,EAAE,GAAG,CAC/D,CAAA;IACH,CAAC;IAED,gEAAgE;IACvD,YAAY;QACnB,OAAO;YACL,GAAG,KAAK,CAAC,YAAY,EAAE;YACvB,IAAI,EAAE,IAAI,CAAC,SAAS,EAAE,EAAE,IAAI,IAAI,CAAC,oBAAoB,EAAE;SACxD,CAAA;IACH,CAAC;IAED;;;;;OAKG;IACO,QAAQ;QAChB,OAAO,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,GAAG,EAAE,CAAC,gBAAgB,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC,CAAA;IAC7F,CAAC;IAED;;;OAGG;IACH,aAAa;QACX,OAAO,IAAI,CAAC,QAAQ,EAAE,CAAC,MAAM,CAAA;IAC/B,CAAC;IAES,iBAAiB;QACzB,6EAA6E;QAC7E,4CAA4C;QAC5C,OAAO,kBAAkB,CACvB,IAAI,CAAC,QAAQ,EAAE,EACf,IAAI,CAAC,WAAW,EAChB,oBAAoB,CAAC;YACnB,QAAQ,EAAE,IAAI,CAAC,SAAS;YACxB,MAAM,EAAE,IAAI,CAAC,OAAO;YACpB,IAAI,EAAE,IAAI,CAAC,oBAAoB,EAAE;SAClC,CAAC,CACH,CAAA;IACH,CAAC;IAES,oBAAoB;QAC5B,OAAO,iBAAiB,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,kBAAkB,EAAE,CAAC,CAAA;IACzF,CAAC;CACF"}

package/dist/graphql/index.d.ts

@@ -65,6 +65,7 @@ export declare function schemaFromSDL(sdl: string, sourcePath?: string): SchemaR
  * ```
  */
 export declare function resolvers(p: ArchProject, glob: string): ResolverRuleBuilder;
+export { GraphqlRuleBuilder } from './graphql-rule-builder.js';
 export { SchemaRuleBuilder } from './schema-rule-builder.js';
 export { ResolverRuleBuilder } from './resolver-rule-builder.js';
 export { resolveFieldReturning } from './resolver-rule-builder.js';

package/dist/graphql/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/graphql/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAErD,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAA;AAC5D,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAA;AAIhE;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,MAAM,CAAC,aAAa,EAAE,WAAW,GAAG,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,iBAAiB,CAK3F;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,iBAAiB,CAGjF;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,GAAG,mBAAmB,CAM3E;AAID,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAA;AAC5D,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAA;AAChE,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAA;AAGlE,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAA;AACrF,YAAY,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAA;AAG3D,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAA;AAGrF,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAA;AAC9F,YAAY,EACV,YAAY,EACZ,iBAAiB,EACjB,qBAAqB,EACrB,gBAAgB,EAChB,mBAAmB,EACnB,eAAe,GAChB,MAAM,oBAAoB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/graphql/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAErD,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAA;AAC5D,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAA;AAIhE;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,MAAM,CAAC,aAAa,EAAE,WAAW,GAAG,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,iBAAiB,CAK3F;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,iBAAiB,CAGjF;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,GAAG,mBAAmB,CAM3E;AAID,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAA;AAC9D,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAA;AAC5D,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAA;AAChE,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAA;AAGlE,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAA;AACrF,YAAY,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAA;AAG3D,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAA;AAGrF,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAA;AAC9F,YAAY,EACV,YAAY,EACZ,iBAAiB,EACjB,qBAAqB,EACrB,gBAAgB,EAChB,mBAAmB,EACnB,eAAe,GAChB,MAAM,oBAAoB,CAAA"}

package/dist/graphql/index.js

@@ -77,9 +77,10 @@ export function resolvers(p, glob) {
         const filePath = sf.getFilePath();
         return picomatchFilter(filePath, glob, extractRootDir(p.tsConfigPath));
     });
-    return new ResolverRuleBuilder(sourceFiles);
+    return new ResolverRuleBuilder(sourceFiles, glob, p);
 }
 // --- Re-exports ---
+export { GraphqlRuleBuilder } from './graphql-rule-builder.js';
 export { SchemaRuleBuilder } from './schema-rule-builder.js';
 export { ResolverRuleBuilder } from './resolver-rule-builder.js';
 export { resolveFieldReturning } from './resolver-rule-builder.js';

package/dist/graphql/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/graphql/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAA;AAC1E,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAA;AAC5D,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAA;AAEhE,uBAAuB;AAEvB;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,MAAM,CAAC,aAAmC,EAAE,IAAY;IACtE,MAAM,OAAO,GACX,OAAO,aAAa,KAAK,QAAQ,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,cAAc,CAAC,aAAa,CAAC,YAAY,CAAC,CAAA;IAChG,MAAM,MAAM,GAAG,kBAAkB,CAAC,OAAO,EAAE,IAAI,CAAC,CAAA;IAChD,OAAO,IAAI,iBAAiB,CAAC,MAAM,CAAC,CAAA;AACtC,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,aAAa,CAAC,GAAW,EAAE,UAAmB;IAC5D,MAAM,MAAM,GAAG,iBAAiB,CAAC,GAAG,EAAE,UAAU,CAAC,CAAA;IACjD,OAAO,IAAI,iBAAiB,CAAC,MAAM,CAAC,CAAA;AACtC,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,UAAU,SAAS,CAAC,CAAc,EAAE,IAAY;IACpD,MAAM,WAAW,GAAG,CAAC,CAAC,cAAc,EAAE,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE;QACnD,MAAM,QAAQ,GAAG,EAAE,CAAC,WAAW,EAAE,CAAA;QACjC,OAAO,eAAe,CAAC,QAAQ,EAAE,IAAI,EAAE,cAAc,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAA;IACxE,CAAC,CAAC,CAAA;IACF,OAAO,IAAI,mBAAmB,CAAC,WAAW,CAAC,CAAA;AAC7C,CAAC;AAED,qBAAqB;AAErB,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAA;AAC5D,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAA;AAChE,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAA;AAElE,iCAAiC;AACjC,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAA;AAGrF,iCAAiC;AACjC,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAA;AAErF,0BAA0B;AAC1B,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAA;AAU9F,2BAA2B;AAE3B,OAAO,IAAI,MAAM,WAAW,CAAA;AAC5B,OAAO,SAAS,MAAM,WAAW,CAAA;AAEjC,SAAS,cAAc,CAAC,YAAoB;IAC1C,OAAO,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,CAAA;AACnC,CAAC;AAED,MAAM,YAAY,GAAG,IAAI,GAAG,EAA6B,CAAA;AAEzD,SAAS,eAAe,CAAC,QAAgB,EAAE,IAAY,EAAE,OAAe;IACtE,MAAM,YAAY,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAA;IACrD,IAAI,OAAO,GAAG,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;IACpC,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,GAAG,SAAS,CAAC,IAAI,CAAC,CAAA;QACzB,YAAY,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,CAAA;IACjC,CAAC;IACD,OAAO,OAAO,CAAC,YAAY,CAAC,CAAA;AAC9B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/graphql/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAA;AAC1E,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAA;AAC5D,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAA;AAEhE,uBAAuB;AAEvB;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,MAAM,CAAC,aAAmC,EAAE,IAAY;IACtE,MAAM,OAAO,GACX,OAAO,aAAa,KAAK,QAAQ,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,cAAc,CAAC,aAAa,CAAC,YAAY,CAAC,CAAA;IAChG,MAAM,MAAM,GAAG,kBAAkB,CAAC,OAAO,EAAE,IAAI,CAAC,CAAA;IAChD,OAAO,IAAI,iBAAiB,CAAC,MAAM,CAAC,CAAA;AACtC,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,aAAa,CAAC,GAAW,EAAE,UAAmB;IAC5D,MAAM,MAAM,GAAG,iBAAiB,CAAC,GAAG,EAAE,UAAU,CAAC,CAAA;IACjD,OAAO,IAAI,iBAAiB,CAAC,MAAM,CAAC,CAAA;AACtC,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,UAAU,SAAS,CAAC,CAAc,EAAE,IAAY;IACpD,MAAM,WAAW,GAAG,CAAC,CAAC,cAAc,EAAE,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE;QACnD,MAAM,QAAQ,GAAG,EAAE,CAAC,WAAW,EAAE,CAAA;QACjC,OAAO,eAAe,CAAC,QAAQ,EAAE,IAAI,EAAE,cAAc,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAA;IACxE,CAAC,CAAC,CAAA;IACF,OAAO,IAAI,mBAAmB,CAAC,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC,CAAA;AACtD,CAAC;AAED,qBAAqB;AAErB,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAA;AAC9D,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAA;AAC5D,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAA;AAChE,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAA;AAElE,iCAAiC;AACjC,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAA;AAGrF,iCAAiC;AACjC,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAA;AAErF,0BAA0B;AAC1B,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAA;AAU9F,2BAA2B;AAE3B,OAAO,IAAI,MAAM,WAAW,CAAA;AAC5B,OAAO,SAAS,MAAM,WAAW,CAAA;AAEjC,SAAS,cAAc,CAAC,YAAoB;IAC1C,OAAO,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,CAAA;AACnC,CAAC;AAED,MAAM,YAAY,GAAG,IAAI,GAAG,EAA6B,CAAA;AAEzD,SAAS,eAAe,CAAC,QAAgB,EAAE,IAAY,EAAE,OAAe;IACtE,MAAM,YAAY,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAA;IACrD,IAAI,OAAO,GAAG,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;IACpC,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,GAAG,SAAS,CAAC,IAAI,CAAC,CAAA;QACzB,YAAY,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,CAAA;IACjC,CAAC;IACD,OAAO,OAAO,CAAC,YAAY,CAAC,CAAA;AAC9B,CAAC"}

package/dist/graphql/resolver-rule-builder.d.ts

@@ -1,9 +1,10 @@
 import type { SourceFile } from 'ts-morph';
-import type { ArchViolation } from '../core/violation.js';
 import type { Predicate } from '@nielspeter/eess';
-import { TerminalBuilder } from '@nielspeter/eess';
+import type { ArchProject } from '../core/project.js';
+import type { GlobNode } from '@nielspeter/eess';
 import type { ExpressionMatcher } from '../helpers/matchers.js';
 import type { ArchFunction } from '../models/arch-function.js';
+import { GraphqlRuleBuilder } from './graphql-rule-builder.js';
 /**
  * Predicate: filter to resolver functions for fields returning types matching the pattern.
  *
@@ -31,31 +32,42 @@ export declare function resolveFieldReturning(pattern: RegExp | string): Predica
  *   .check()
  * ```
  */
-export declare class ResolverRuleBuilder extends TerminalBuilder {
+export declare class ResolverRuleBuilder extends GraphqlRuleBuilder<ArchFunction> {
     private readonly sourceFiles;
-    private readonly _predicates;
-    private readonly _conditions;
-    constructor(sourceFiles: SourceFile[]);
+    private readonly glob?;
+    private readonly project?;
     /**
-     * Filter to resolver functions for fields returning types matching the pattern.
-     */
-    resolveFieldReturning(pattern: RegExp | string): this;
-    /**
-     * Begin the predicate phase. Purely a readability marker.
-     */
-    that(): this;
-    /**
-     * Add another predicate (AND).
+     * @param sourceFiles - The resolver files, already filtered by `resolvers()`.
+     * @param glob - The glob they were filtered by, for diagnostics only.
+     *
+     * `glob` is **optional** because this class is re-exported from the public
+     * `./graphql` subpath, so its constructor is public API and a required
+     * second parameter would break anyone constructing it directly — which
+     * would make R2a a breaking release, and R2a is the one people install in
+     * order to measure before R3. `resolvers()` always passes it.
+     *
+     * Threading it at all is the point: `resolvers()` filters eagerly and hands
+     * this builder only the surviving files, so without the glob string no
+     * `globs()` could ever report `resolvers(p, 'src/reslvers/**')` — the rule
+     * would silently examine zero resolvers and pass.
      */
-    and(): this;
+    constructor(sourceFiles: SourceFile[], glob?: string | undefined, project?: ArchProject | undefined);
+    /** The project this rule was built against. See `RuleBuilder.getProject`. */
+    getProject(): ArchProject | undefined;
     /**
-     * Begin the condition phase.
+     * The discovery glob, if `resolvers()` supplied it.
+     *
+     * `tsconfig-relative` is load-bearing, not cosmetic: it is what exempts this
+     * glob from the anchor check, because `resolvers(p, 'src/resolvers/**')` — the
+     * spelling in this class's own example — is correct as written. Declared
+     * `'absolute'` it would be reported unanchored, telling the author to break a
+     * working rule.
      */
-    should(): this;
+    globs(): readonly GlobNode[];
     /**
-     * Add another condition (AND).
+     * Filter to resolver functions for fields returning types matching the pattern.
      */
-    andShould(): this;
+    resolveFieldReturning(pattern: RegExp | string): this;
     /**
      * Assert that the resolver body contains at least one match.
      */
@@ -68,8 +80,17 @@ export declare class ResolverRuleBuilder extends TerminalBuilder {
      * Assert: must NOT contain 'bad' AND must contain 'good'.
      */
     useInsteadOf(bad: ExpressionMatcher, good: ExpressionMatcher): this;
-    protected collectViolations(): ArchViolation[];
-    private getElements;
-    private buildRuleDescription;
+    /**
+     * This family counts resolvers — the resolver functions it selected.
+     *
+     * Plan 0099: `CollectResult.examined` is unit-typed per family (ADR-009 part
+     * 1), and the zero-examined message prints the noun. Inheriting the base
+     * `'subjects'` is a category error in a sentence whose whole job is naming what
+     * was and was not looked at.
+     */
+    protected examinedUnitNoun(): string;
+    protected descriptionSubject(): string;
+    protected conditionExamples(): string;
+    protected getElements(): ArchFunction[];
 }
 //# sourceMappingURL=resolver-rule-builder.d.ts.map

package/dist/graphql/resolver-rule-builder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resolver-rule-builder.d.ts","sourceRoot":"","sources":["../../src/graphql/resolver-rule-builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAA;AAC1C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AAEzD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AAClD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAA;AAC/D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAA;AAQ9D;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC,YAAY,CAAC,CAYvF;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,mBAAoB,SAAQ,eAAe;IAI1C,OAAO,CAAC,QAAQ,CAAC,WAAW;IAHxC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAgC;IAC5D,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAgC;gBAE/B,WAAW,EAAE,UAAU,EAAE;IAMtD;;OAEG;IACH,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAOrD;;OAEG;IACH,IAAI,IAAI,IAAI;IAIZ;;OAEG;IACH,GAAG,IAAI,IAAI;IAIX;;OAEG;IACH,MAAM,IAAI,IAAI;IAId;;OAEG;IACH,SAAS,IAAI,IAAI;IAMjB;;OAEG;IACH,OAAO,CAAC,OAAO,EAAE,iBAAiB,GAAG,IAAI;IAKzC;;OAEG;IACH,UAAU,CAAC,OAAO,EAAE,iBAAiB,GAAG,IAAI;IAK5C;;OAEG;IACH,YAAY,CAAC,GAAG,EAAE,iBAAiB,EAAE,IAAI,EAAE,iBAAiB,GAAG,IAAI;IAOnE,SAAS,CAAC,iBAAiB,IAAI,aAAa,EAAE;IAmC9C,OAAO,CAAC,WAAW;IAInB,OAAO,CAAC,oBAAoB;CAQ7B"}
+{"version":3,"file":"resolver-rule-builder.d.ts","sourceRoot":"","sources":["../../src/graphql/resolver-rule-builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAA;AAC1C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AACjD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AACrD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAA;AAGhD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAA;AAC/D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAA;AAO9D,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAA;AAE9D;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC,YAAY,CAAC,CAYvF;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,mBAAoB,SAAQ,kBAAkB,CAAC,YAAY,CAAC;IAiBrE,OAAO,CAAC,QAAQ,CAAC,WAAW;IAC5B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC;IACtB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC;IAlB3B;;;;;;;;;;;;;;OAcG;gBAEgB,WAAW,EAAE,UAAU,EAAE,EACzB,IAAI,CAAC,EAAE,MAAM,YAAA,EACb,OAAO,CAAC,EAAE,WAAW,YAAA;IAKxC,6EAA6E;IAC7E,UAAU,IAAI,WAAW,GAAG,SAAS;IAIrC;;;;;;;;OAQG;IACM,KAAK,IAAI,SAAS,QAAQ,EAAE;IAarC;;OAEG;IACH,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAQrD;;OAEG;IACH,OAAO,CAAC,OAAO,EAAE,iBAAiB,GAAG,IAAI;IAMzC;;OAEG;IACH,UAAU,CAAC,OAAO,EAAE,iBAAiB,GAAG,IAAI;IAM5C;;OAEG;IACH,YAAY,CAAC,GAAG,EAAE,iBAAiB,EAAE,IAAI,EAAE,iBAAiB,GAAG,IAAI;IAQnE;;;;;;;OAOG;cACgB,gBAAgB,IAAI,MAAM;cAI1B,kBAAkB,IAAI,MAAM;cAI5B,iBAAiB,IAAI,MAAM;cAI3B,WAAW,IAAI,YAAY,EAAE;CAajD"}

package/dist/graphql/resolver-rule-builder.js

@@ -1,6 +1,8 @@
-import { TerminalBuilder } from '@nielspeter/eess';
+import { stampGlobs } from '@nielspeter/eess/internal';
+import { globAnyOf } from '@nielspeter/eess';
 import { collectFunctions } from '../models/arch-function.js';
 import { functionContain, functionNotContain, functionUseInsteadOf, } from '../conditions/body-analysis-function.js';
+import { GraphqlRuleBuilder } from './graphql-rule-builder.js';
 /**
  * Predicate: filter to resolver functions for fields returning types matching the pattern.
  *
@@ -40,107 +42,113 @@ export function resolveFieldReturning(pattern) {
  *   .check()
  * ```
  */
-export class ResolverRuleBuilder extends TerminalBuilder {
+export class ResolverRuleBuilder extends GraphqlRuleBuilder {
     sourceFiles;
-    _predicates = [];
-    _conditions = [];
-    constructor(sourceFiles) {
-        super();
-        this.sourceFiles = sourceFiles;
-    }
-    // --- Predicate methods ---
-    /**
-     * Filter to resolver functions for fields returning types matching the pattern.
-     */
-    resolveFieldReturning(pattern) {
-        this._predicates.push(resolveFieldReturning(pattern));
-        return this;
-    }
-    // --- Chain methods ---
+    glob;
+    project;
     /**
-     * Begin the predicate phase. Purely a readability marker.
+     * @param sourceFiles - The resolver files, already filtered by `resolvers()`.
+     * @param glob - The glob they were filtered by, for diagnostics only.
+     *
+     * `glob` is **optional** because this class is re-exported from the public
+     * `./graphql` subpath, so its constructor is public API and a required
+     * second parameter would break anyone constructing it directly — which
+     * would make R2a a breaking release, and R2a is the one people install in
+     * order to measure before R3. `resolvers()` always passes it.
+     *
+     * Threading it at all is the point: `resolvers()` filters eagerly and hands
+     * this builder only the surviving files, so without the glob string no
+     * `globs()` could ever report `resolvers(p, 'src/reslvers/**')` — the rule
+     * would silently examine zero resolvers and pass.
      */
-    that() {
-        return this;
+    constructor(sourceFiles, glob, project) {
+        super();
+        this.sourceFiles = sourceFiles;
+        this.glob = glob;
+        this.project = project;
     }
-    /**
-     * Add another predicate (AND).
-     */
-    and() {
-        return this;
+    /** The project this rule was built against. See `RuleBuilder.getProject`. */
+    getProject() {
+        return this.project;
     }
     /**
-     * Begin the condition phase.
+     * The discovery glob, if `resolvers()` supplied it.
+     *
+     * `tsconfig-relative` is load-bearing, not cosmetic: it is what exempts this
+     * glob from the anchor check, because `resolvers(p, 'src/resolvers/**')` — the
+     * spelling in this class's own example — is correct as written. Declared
+     * `'absolute'` it would be reported unanchored, telling the author to break a
+     * working rule.
      */
-    should() {
-        return this;
+    globs() {
+        if (this.glob === undefined)
+            return [];
+        return [
+            stampGlobs(globAnyOf([this.glob], 'file-path', 'tsconfig-relative'), 'discovery', (g) => `resolvers(p, "${g.glob}")`),
+        ];
     }
+    // --- Predicate methods ---
     /**
-     * Add another condition (AND).
+     * Filter to resolver functions for fields returning types matching the pattern.
      */
-    andShould() {
-        return this;
+    resolveFieldReturning(pattern) {
+        const next = this.copy();
+        next._predicates.push(resolveFieldReturning(pattern));
+        return next;
     }
     // --- Condition methods (reuse body analysis) ---
     /**
      * Assert that the resolver body contains at least one match.
      */
     contain(matcher) {
-        this._conditions.push(functionContain(matcher));
-        return this;
+        const next = this.copy();
+        next._conditions.push(functionContain(matcher));
+        return next;
     }
     /**
      * Assert that the resolver body does NOT contain any match.
      */
     notContain(matcher) {
-        this._conditions.push(functionNotContain(matcher));
-        return this;
+        const next = this.copy();
+        next._conditions.push(functionNotContain(matcher));
+        return next;
     }
     /**
      * Assert: must NOT contain 'bad' AND must contain 'good'.
      */
     useInsteadOf(bad, good) {
-        this._conditions.push(functionUseInsteadOf(bad, good));
-        return this;
+        const next = this.copy();
+        next._conditions.push(functionUseInsteadOf(bad, good));
+        return next;
     }
     // --- Evaluation ---
-    collectViolations() {
-        const allElements = this.getElements();
-        const filtered = allElements.filter((element) => this._predicates.every((predicate) => predicate.test(element)));
-        if (filtered.length === 0) {
-            return [];
-        }
-        if (this._conditions.length === 0) {
-            const ruleId = this._metadata?.id ?? 'unnamed';
-            console.warn(`[eess] Resolver rule '${ruleId}' has predicates but no conditions. ` +
-                `Did you forget to add a condition after .should()?`);
-            return [];
-        }
-        const context = {
-            rule: this.buildRuleDescription(),
-            because: this._reason,
-            ruleId: this._metadata?.id,
-            suggestion: this._metadata?.suggestion,
-            docs: this._metadata?.docs,
-        };
-        const violations = [];
-        for (const condition of this._conditions) {
-            violations.push(...condition.evaluate(filtered, context));
-        }
-        return violations;
+    /**
+     * This family counts resolvers — the resolver functions it selected.
+     *
+     * Plan 0099: `CollectResult.examined` is unit-typed per family (ADR-009 part
+     * 1), and the zero-examined message prints the noun. Inheriting the base
+     * `'subjects'` is a category error in a sentence whose whole job is naming what
+     * was and was not looked at.
+     */
+    examinedUnitNoun() {
+        return 'resolvers';
     }
-    getElements() {
-        return this.sourceFiles.flatMap((sf) => collectFunctions(sf));
+    descriptionSubject() {
+        return 'resolvers';
+    }
+    conditionExamples() {
+        return 'contain(...), notContain(...) or useInsteadOf(...)';
     }
-    buildRuleDescription() {
-        const predicateDesc = this._predicates.map((p) => p.description).join(' and ');
-        const conditionDesc = this._conditions.map((c) => c.description).join(' and ');
-        const parts = ['resolvers'];
-        if (predicateDesc)
-            parts.push(`that ${predicateDesc}`);
-        if (conditionDesc)
-            parts.push(`should ${conditionDesc}`);
-        return parts.join(' ');
+    getElements() {
+        // Object-literal collection is opt-in for `functions()`, where turning it on
+        // by default would flood every rule with inline callbacks. Here it is the
+        // opposite: a GraphQL resolver map IS an object literal
+        // (`{ Query: { assetCollection: async () => {} } }`), so without this the
+        // builder named `resolvers()` selects the helper functions that happen to
+        // sit beside the resolvers and none of the resolvers themselves — measured
+        // on a real schema as 60 subjects, 0 of them resolvers. Every rule written
+        // against it then passes on the wrong subjects (ADR-008).
+        return this.sourceFiles.flatMap((sf) => collectFunctions(sf, { includeObjectLiteralFunctions: true }));
     }
 }
 //# sourceMappingURL=resolver-rule-builder.js.map

package/dist/graphql/resolver-rule-builder.js.map

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

package/dist/graphql/schema-loader.d.ts

@@ -50,6 +50,12 @@ export interface GraphQLArgumentLike {
 export interface GraphQLTypeLike {
     readonly toString: () => string;
 }
+/**
+ * GraphQL package interface — the subset of functions we use.
+ */
+interface GraphQLPackage {
+    buildSchema: (sdl: string) => GraphQLSchemaLike;
+}
 /**
  * Load and parse .graphql files matching a glob pattern relative to a root directory.
  *
@@ -72,4 +78,19 @@ export declare function loadSchemaFromSDL(sdl: string, sourcePath?: string): Loa
  * Used by the runtime guard in the barrel export.
  */
 export declare function isGraphQLAvailable(): boolean;
+/**
+ * Replace how `graphql` is loaded. **Tests only** —
+ * [ts-archunit bug 0080](https://github.com/nielspeter/ts-archunit/blob/main/bugs/fixed/0080-a-node-module-mock-does-not-isolate-under-full-suite-concurrency.md):
+ * `vi.doMock('node:module', ...)` intercepts a Node builtin, which is not
+ * reliably isolated per-file under Vitest's worker-reuse defaults and failed
+ * intermittently under full-suite load. This seam replaces only this
+ * module's own loading step — nothing shared with any other file to race on.
+ */
+export declare function setGraphQLLoaderForTests(loader: () => GraphQLPackage): void;
+/**
+ * Restore the real loader and clear the cached package. **Tests only** — see
+ * {@link setGraphQLLoaderForTests}.
+ */
+export declare function resetGraphQLLoaderForTests(): void;
+export {};
 //# sourceMappingURL=schema-loader.d.ts.map