@nielspeter/eess 0.2.2 → 0.5.0

package/dist/format-json.js

@@ -1,28 +1,113 @@
+import { hasEvidence } from './collect-result.js';
+import { commentSuppressions } from './comment-suppression.js';
+export function formatViolationsJson(violations, reason, 
 /**
- * Format violations as a JSON string.
+ * Allowlist rules that tested no edges (bug 0015).
  *
- * Useful for CI pipelines, custom dashboards, or piping to other tools.
- *
- * @example
- * const violations = collectViolations(rule1, rule2)
- * console.log(formatViolationsJson(violations))
+ * **Passed in, not read from module state.** The first cut called
+ * `untestedRules()` here, which made a documented pure formatter impure: a
+ * per-rule JSON document in a vitest suite named rules from every earlier
+ * rule in the process, because nothing resets between them. Same input,
+ * different output depending on history.
  */
-export function formatViolationsJson(violations, reason) {
+untested = []) {
+    const errors = violations.filter((v) => (v.severity ?? 'error') === 'error').length;
     const output = {
         summary: {
             total: violations.length,
+            errors,
+            warnings: violations.length - errors,
             reason: reason ?? null,
+            /**
+             * The denominator, carried by hand — plan 0235.
+             *
+             * `JSON.stringify` DROPS an array's own properties: an `ArchViolation[]`
+             * carrying `examined` serialises as a bare `[…]` and the evidence is
+             * simply gone. Measured: `JSON.stringify(Object.assign([1,2],{examined:7}))`
+             * is `[1,2]`.
+             *
+             * Without this line `--format json` would carry violations and no
+             * denominator, which forecloses the machine-readable half of
+             * [bug 0174](../../../work/bugs/0174-eess-ts-reports-a-clean-gate-with-no-denominator.md)
+             * — a green with no way for a consumer to tell a clean run from one that
+             * examined nothing. `null` when the caller handed over a bare array, which
+             * is itself the honest answer: no evidence was supplied.
+             */
+            examined: hasEvidence(violations) ? violations.examined : null,
         },
+        // Bug 0015: an allowlist constrains edges, so a subject with none passes
+        // whatever the allowlist says. Reported rather than failed — for the `only*`
+        // family zero edges is maximal compliance, and only the reader can tell a
+        // dependency-free module from a rule that certified nothing. Always present
+        // (an empty array, not omitted) so a consumer can distinguish "none" from
+        // "this version does not report it".
+        untestedAllowlists: untested.map((c) => ({
+            rule: c.rule,
+            subjects: c.subjects,
+            edges: c.edges,
+        })),
+        // What inline `// eess-exclude` comments removed from this report.
+        // Structural rather than prose, for the same reason `untestedAllowlists` is:
+        // the agent reading this document needs identities it can act on, not a
+        // sentence to grep. Always present — an empty array, not omitted — so a
+        // consumer can tell "nothing was suppressed" from "this version does not
+        // report it".
+        //
+        // Every other filter in the pipeline discloses itself; this one did not,
+        // which after bug 0041 made it the widest silent filter we ship.
+        commentSuppressed: commentSuppressions().map((c) => ({
+            ruleId: c.ruleId,
+            file: c.file,
+        })),
         violations: violations.map((v) => ({
             rule: v.rule,
             ruleId: v.ruleId ?? null,
+            severity: v.severity ?? 'error',
             element: v.element,
-            file: v.file,
-            line: v.line,
+            // `null`, not `''`/`1`, when there is no source location. A configuration
+            // finding reports that a RULE enforces nothing; it has no line, and saying
+            // `"file": "", "line": 1` states one that looks real (bug 0047). A human
+            // skims past it; an agent may open it or anchor an edit to it.
+            //
+            // `null` rather than omission, and consistent with the rest of this
+            // document — `ruleId`, `because`, `suggestion`, `docs` and `measured` all
+            // null when absent, so a consumer already handles the idiom here.
+            file: v.file === '' ? null : v.file,
+            line: v.file === '' ? null : v.line,
+            // What kind of finding this is, which drives what the reader should DO:
+            // `'violation'` — the code is wrong, edit the named file;
+            // `'configuration'` — the RULE enforces nothing, so editing the code
+            // cannot clear it. This distinction was absent from the payload entirely,
+            // so an agent could not tell them apart by any field.
+            //
+            // A string rather than a boolean, decided deliberately. There are twelve
+            // configuration-finding producers with materially different causes — an
+            // empty selector, a dead glob, a rule with no condition, a preset that
+            // discovered nothing — and someone will want to distinguish them. A
+            // boolean leaves nowhere to put that; adding a second overlapping field
+            // later is worse than one field with room in it. This is the agent
+            // contract, so the cost of the wrong shape is permanent.
+            //
+            // Not named after `bypassFilters`: the consumer cares what the finding
+            // IS, not which of our filters it happens to survive.
+            kind: v.bypassFilters === true ? 'configuration' : 'violation',
             message: v.message,
             because: v.because ?? null,
             suggestion: v.suggestion ?? null,
             docs: v.docs ?? null,
+            codeFrame: v.codeFrame ?? null,
+            // Bug 0012's measurement, on the wire. Without it the ratchet is
+            // machine-readable only inside the baseline file, and a dashboard wanting
+            // the number has to regex it back out of the message — which is the
+            // fragility bug 0012 was filed about.
+            measured: v.measured ?? null,
+            // Bug 0239. A finding about a relationship concerns several files and is
+            // reported at one of them; a consumer that filters by `file` needs the
+            // rest or it reproduces the very bug this field was added to fix. This is
+            // the documented agent-actionable stream, so omitting it would make the
+            // changeset's own advice — "read `relatedFiles` too" — impossible to
+            // follow through the interface CLAUDE.md points agents at.
+            relatedFiles: v.relatedFiles ?? null,
         })),
     };
     return JSON.stringify(output, null, 2);

package/dist/format-json.js.map

@@ -1 +1 @@
-{"version":3,"file":"format-json.js","sourceRoot":"","sources":["../src/format-json.ts"],"names":[],"mappings":"AAEA;;;;;;;;GAQG;AACH,MAAM,UAAU,oBAAoB,CAAC,UAA2B,EAAE,MAAe;IAC/E,MAAM,MAAM,GAAG;QACb,OAAO,EAAE;YACP,KAAK,EAAE,UAAU,CAAC,MAAM;YACxB,MAAM,EAAE,MAAM,IAAI,IAAI;SACvB;QACD,UAAU,EAAE,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACjC,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,MAAM,EAAE,CAAC,CAAC,MAAM,IAAI,IAAI;YACxB,OAAO,EAAE,CAAC,CAAC,OAAO;YAClB,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,OAAO,EAAE,CAAC,CAAC,OAAO;YAClB,OAAO,EAAE,CAAC,CAAC,OAAO,IAAI,IAAI;YAC1B,UAAU,EAAE,CAAC,CAAC,UAAU,IAAI,IAAI;YAChC,IAAI,EAAE,CAAC,CAAC,IAAI,IAAI,IAAI;SACrB,CAAC,CAAC;KACJ,CAAA;IACD,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAA;AACxC,CAAC"}
+{"version":3,"file":"format-json.js","sourceRoot":"","sources":["../src/format-json.ts"],"names":[],"mappings":"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"}

package/dist/format.d.ts

@@ -18,8 +18,10 @@ export declare function formatViolations(violations: ArchViolation[], reason?: s
 /**
  * Format violations into a plain-text string (no ANSI codes).
  *
- * Used by ArchRuleError.message — error messages should be plain text
- * since they may be captured by test runners, serialized, or logged to files.
+ * Public export, for callers that aggregate violations themselves and need
+ * output free of ANSI codes — serialized, logged to a file, or embedded in
+ * another tool's report. `ArchRuleError.message` is a one-line summary and does
+ * not use this; the run's detail is written by `writeReport`.
  */
 export declare function formatViolationsPlain(violations: ArchViolation[], reason?: string): string;
 //# sourceMappingURL=format.d.ts.map

package/dist/format.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../src/format.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAA;AAInD;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,0EAA0E;IAC1E,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,8DAA8D;IAC9D,UAAU,CAAC,EAAE,OAAO,CAAA;CACrB;AA0CD;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC9B,UAAU,EAAE,aAAa,EAAE,EAC3B,MAAM,CAAC,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,aAAa,GACtB,MAAM,CAYR;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,aAAa,EAAE,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAkB1F"}
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../src/format.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAA;AAKnD;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,0EAA0E;IAC1E,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,8DAA8D;IAC9D,UAAU,CAAC,EAAE,OAAO,CAAA;CACrB;AAoDD;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC9B,UAAU,EAAE,aAAa,EAAE,EAC3B,MAAM,CAAC,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,aAAa,GACtB,MAAM,CAYR;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,aAAa,EAAE,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CA2B1F"}

package/dist/format.js

@@ -1,28 +1,39 @@
+import { remedyRepeatsMessage } from './violation.js';
 import { bold, red, cyan, dim } from './ansi.js';
 import path from 'node:path';
 /** Format a single violation into a rich terminal section. */
 function formatSingleViolation(v, index, total, cwd, showCodeFrames, reason) {
     const counter = bold(red(`Architecture Violation [${String(index + 1)} of ${String(total)}]`));
     const ruleLine = `  ${dim('Rule:')} ${v.rule}`;
-    const relativePath = path.relative(cwd, v.file);
-    const locationRef = cyan(relativePath + ':' + String(v.line));
-    const location = `  ${locationRef} ${dim('—')} ${v.element}`;
+    // `message` is printed for BOTH shapes, and it used to be printed for neither
+    // — a located violation rendered only `file:line — element`, so the one
+    // sentence saying what is actually wrong was dropped from the default surface
+    // for every ordinary violation. Nothing failed when this was fixed, because
+    // nothing pinned it either way; `formatViolationsPlain` had always printed it,
+    // so the two formatters disagreed about what a violation IS.
+    //
+    // A config-level finding has no source location: `path.relative(cwd, '')`
+    // renders as the cwd and ':0' is noise, so it gets the message alone.
+    const location = v.file
+        ? `  ${v.message}\n  ${cyan(path.relative(cwd, v.file) + ':' + String(v.line))} ${dim('—')} ${v.element}`
+        : `  ${v.message}`;
     const codeLine = showCodeFrames && v.codeFrame ? `\n${v.codeFrame}` : '';
     const whyText = v.because ?? reason;
     const whyLine = whyText ? `  ${dim('Why:')} ${whyText}` : '';
-    const fixLine = v.suggestion ? `  ${dim('Fix:')} ${v.suggestion}` : '';
+    // Suppressed whenever the `location` slot above already printed this exact
+    // text, which is now BOTH shapes — see the note there. It used to be
+    // `!v.file && remedyRepeatsMessage(v)`, and that asymmetry was load-bearing
+    // and pinned, because a located violation did not render `message` at all: its
+    // `Fix:` line was the remedy's only appearance. Rendering `message` for both
+    // shapes removed the premise, and the `!v.file` half became a defect —
+    // measured, two occurrences of the remedy for a located finding whose
+    // suggestion is its message.
+    //
+    // So do not "restore" the asymmetry from the old comment: check whether this
+    // formatter still prints `message` for a located violation first.
+    const fixLine = v.suggestion && !remedyRepeatsMessage(v) ? `  ${dim('Fix:')} ${v.suggestion}` : '';
     const docsLine = v.docs ? `  ${dim('Docs:')} ${v.docs}` : '';
-    // The message is the finding itself. It was omitted here for years, which is
-    // survivable for a one-sided rule — `element` plus the rule description plus a
-    // code frame usually carry the meaning — and not survivable for a two-sided
-    // one, where `message` is the ONLY place the correspondence states which side
-    // drifted. Measured before adding: `check:spec` rendered a ghost ADR row as
-    // `Rule: correspondence / CLAUDE.md:24 — 099 / Why: …` and never said what was
-    // wrong. Rendered in full, not just the first line: `correspondence()` folds
-    // its per-side `suggest` remedy onto a continuation line, so truncating here
-    // is what made that remedy invisible.
-    const messageLine = `  ${dim('What:')} ${v.message.split('\n').join('\n  ')}`;
-    const parts = [counter, '', ruleLine, '', location, messageLine];
+    const parts = [counter, '', ruleLine, '', location];
     if (codeLine)
         parts.push(codeLine);
     if (whyLine)
@@ -51,8 +62,10 @@ export function formatViolations(violations, reason, options) {
 /**
  * Format violations into a plain-text string (no ANSI codes).
  *
- * Used by ArchRuleError.message — error messages should be plain text
- * since they may be captured by test runners, serialized, or logged to files.
+ * Public export, for callers that aggregate violations themselves and need
+ * output free of ANSI codes — serialized, logged to a file, or embedded in
+ * another tool's report. `ArchRuleError.message` is a one-line summary and does
+ * not use this; the run's detail is written by `writeReport`.
  */
 export function formatViolationsPlain(violations, reason) {
     if (violations.length === 0)
@@ -61,12 +74,21 @@ export function formatViolationsPlain(violations, reason) {
     const reasonLine = reason ? `\nReason: ${reason}` : '';
     const details = violations
         .map((v, i) => {
+        // A configuration finding has no source location — it reports that a RULE
+        // enforces nothing, not that a line is wrong — so it carries `file: ''`
+        // and a `line` that means nothing. Rendering it produced a bare `(:1)`
+        // (bug 0047). The rich formatter and the GitHub formatter
+        // (`format-github.ts:58`) both already special-case this; plain and JSON
+        // were the two that did not.
+        const where = v.file === '' ? '' : ` (${v.file}:${String(v.line)})`;
         const parts = [
-            `  [${String(i + 1)}/${String(violations.length)}] ${v.element}: ${v.message} (${v.file}:${String(v.line)})`,
+            `  [${String(i + 1)}/${String(violations.length)}] ${v.element}: ${v.message}${where}`,
         ];
         if (v.codeFrame)
             parts.push(v.codeFrame);
-        if (v.suggestion)
+        // This format always renders `message`, so a remedy identical to it is
+        // already shown — see `remedyRepeatsMessage`.
+        if (v.suggestion && !remedyRepeatsMessage(v))
             parts.push(`  Fix: ${v.suggestion}`);
         return parts.join('\n');
     })

package/dist/format.js.map

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

package/dist/glob-site.d.ts

@@ -0,0 +1,232 @@
+/**
+ * The declaration side of plan 0069: what a glob is, and how a set of globs
+ * combines, so that "this rule can never match anything" is answerable without
+ * running the rule.
+ *
+ * Nothing here evaluates. Evaluation lives in `glob-diagnosis.ts`, against the
+ * path universe; this module only describes.
+ */
+/**
+ * Which string a glob is matched against.
+ *
+ * This names **the target**, never the API. `SmellBuilder.inFolder()` matches
+ * the full file path despite its name (`src/smells/duplicate-bodies.ts`), and
+ * exactly one selector in `src/` — `resideInFolder` — matches a directory.
+ * Two revisions of the plan's own census got this wrong by reading the method
+ * name, and each time reported a vacuous rule as satisfiable.
+ *
+ * - `file-path`   — the whole absolute path of the file
+ * - `parent-dir`  — the immediate parent directory of the file, and only the
+ *                   immediate parent: `resideInFolder` tests
+ *                   `filePath.substring(0, filePath.lastIndexOf('/'))`
+ * - `import-target` — a resolved module path or a bare specifier. Never
+ *                   checked against the path universe: `node_modules` is
+ *                   outside the project by construction, so checking it would
+ *                   fail every correct dependency rule in existence
+ * - `specifier`   — a raw module specifier
+ * - `literal`     — matched against source text, not a path
+ */
+export type GlobKind = 'file-path' | 'parent-dir' | 'import-target' | 'specifier' | 'literal';
+/**
+ * Where in a rule the glob was written, which decides whether being
+ * unsatisfiable is a fault.
+ *
+ * - `selector`  — narrows the subject set. Unsatisfiable ⇒ the rule can never
+ *                 have subjects
+ * - `discovery` — defines a population (slices, layers, boundary folders).
+ *                 Unsatisfiable ⇒ nothing to check
+ * - `condition` — asserts something about subjects. Unsatisfiable is
+ *                 indistinguishable from an armed tripwire that has not fired
+ * - `exclusion` — subtracts. An exclusion matching zero is remedy-optional
+ *                 (proposal 006) and never a fault
+ */
+export type GlobPosition = 'selector' | 'discovery' | 'condition' | 'exclusion';
+/**
+ * Is a dead glob at this position a **fault**?
+ *
+ * One owner for a decision that was written twice, inversely, and disagreed —
+ * [ts-archunit plan 0080](https://github.com/nielspeter/ts-archunit/blob/main/plans/completed/0080-admit-discovery-globs-to-the-dead-glob-gate.md).
+ *
+ * | site | said | i.e. |
+ * | --- | --- | --- |
+ * | `diagnose.ts` | skip `exclusion` and `condition` | selector **and discovery** are faults |
+ * | `terminal-builder.ts` | skip anything but `selector` | only selector is |
+ *
+ * So `doctor` reported a dead `discovery` glob and the check that gates the build
+ * did not — the divergence bug 0040's silence half is made of. Two hand-maintained
+ * inverse lists that must agree is the shape ADR-009 rule 5 keeps charging this
+ * project for; a shared predicate is the whole fix.
+ *
+ * **`selector` and `discovery` are faults.** Both name what a rule will judge, so
+ * a dead one means the rule judges nothing.
+ *
+ * **`condition` and `exclusion` are not.** A condition glob is an assertion
+ * *about* the subjects — `onlyImportFrom('**\/domain/**')` matching nothing is a
+ * satisfied rule, not a broken one (bug 0014) — and an exclusion glob matching
+ * nothing is an unused exemption, which `.excluding()` reports on its own terms.
+ *
+ * ## A `switch`, not an `||`, and that is the point
+ *
+ * It shipped as `position === 'selector' || position === 'discovery'` — an
+ * allow-list with no exhaustiveness check. Review measured the consequence: a
+ * **fifth** `GlobPosition` added to the union above compiles clean and leaves the
+ * whole suite green, silently a non-fault in all three consumers. A dead glob
+ * written at it would be invisible in `doctor` *and* in the build — which is the
+ * original divergence's failure direction, one level up, in the predicate that
+ * exists to remove it.
+ *
+ * The predicate's own test enumerates the four known values, which is a
+ * restatement of the implementation and structurally cannot cover a fifth. The
+ * `never` assignment below can, and it fails at compile time rather than at
+ * review time.
+ */
+export declare function isFaultPosition(position: GlobPosition): boolean;
+/**
+ * Which set of paths the glob is written against.
+ *
+ * **This affects the verdict**, and the earlier claim here that it was
+ * message-only is withdrawn. Satisfiability is still taken against the union
+ * of the views for the glob's `kind`, but the ANCHOR check consults `base`:
+ * an unanchored glob can never match an absolute path, so for
+ * `base: 'absolute'` it is dead however the project is shaped — while for a
+ * base whose entry point rewrites or relativises the glob, an unanchored
+ * spelling is correct and telling the author to anchor it would break a
+ * working rule.
+ *
+ * The union alone was tried and was a false green on the commonest real
+ * mistake: the tsconfig-relative view accepts `'src/domain/**'`, which
+ * `resideInFolder` can never match. Unanchored globs are the entire subject of
+ * the 0.18.1 release, so a design that quietly calls them satisfiable defeats
+ * its own purpose.
+ *
+ * So a mis-declared `base` CAN cause a red build. It is set beside `kind` by
+ * the same code, from what the entry point does rather than from intent, and
+ * `tests/core/glob-declaration.test.ts` asserts the equivalent spellings agree.
+ */
+export type GlobBase = 'absolute' | 'tsconfig-relative' | 'normalized';
+/**
+ * A glob as a predicate, condition or builder declares it.
+ *
+ * This is the author-facing half. `position` and `origin` are deliberately
+ * absent: the code that mints a site — inside `resideInFolder()`, several
+ * frames below any builder — cannot know either, and the builder stamps them
+ * on. Exposing them here would also let a rule author write
+ * `position: 'exclusion'` and permanently exempt their own predicate from the
+ * check, with no signal that they had.
+ */
+export interface DeclaredGlob {
+    readonly glob: string;
+    readonly kind: GlobKind;
+    /** Defaults to `'positive'`. A negative site can never be dead — see `GlobNode`. */
+    readonly polarity?: 'positive' | 'negative';
+    /**
+     * Defaults to `'absolute'`. **Affects the verdict** — see `GlobBase`. An
+     * unanchored glob is dead for `'absolute'` and correct for a base whose
+     * entry point rewrites or relativises it.
+     */
+    readonly base?: GlobBase;
+}
+/** A declared glob after a builder has stamped on what only it knows. */
+export type GlobSite = DeclaredGlob & {
+    readonly position: GlobPosition;
+    /** For the message: `resideInFolder("**\/src/x/**") in rule "adr005/no-any"`. */
+    readonly origin: string;
+};
+/**
+ * A predicate or condition that declares no globs.
+ *
+ * Retained in the tree rather than dropped, and never dead. Dropping is safe
+ * under `all` — `some(dead)` is monotone — but `not()` turns an `all` into an
+ * `any`, and under `any` dropping an opaque child is what makes
+ * `or(deadGlob, exportSymbolNamed('Foo'))` red a working rule. Since most
+ * predicates declare no globs, that would have been the commonest failure of
+ * the whole mechanism.
+ *
+ * Retaining it costs no detection, removes the need for a separate `or()`
+ * propagation rule, and makes an empty node unreachable — which matters
+ * because `[].every()` is `true` and would otherwise fault a rule containing
+ * no globs at all. Verified exhaustively by
+ * `spikes/0069-tree-model-check.mjs`: 0 false reds and 0 missed emptiness
+ * across every expression of at most three combinator nodes.
+ */
+export interface OpaqueGlob {
+    readonly opaque: true;
+}
+/** A leaf of a glob tree: a declaration of some kind, or an opaque input. */
+export type GlobLeaf<L> = L | OpaqueGlob;
+/**
+ * How a set of globs combines.
+ *
+ * - `all` — every child must match for the whole to match, so the whole is
+ *   dead if **any** child is dead. `and()`.
+ * - `any` — one child matching is enough, so the whole is dead only if
+ *   **every** child is dead. `or()`, a variadic predicate
+ *   (`importFrom(...globs)` is `matchers.some`), repeated `.inFolder()` calls.
+ *
+ * A preset's option list is **not** an `any` node: both shipped presets fan
+ * out one rule per glob (`src/presets/layered.ts`, `src/presets/boundaries.ts`),
+ * so one dead layer glob is one vacuous rule, and `any` would say "no fault
+ * unless every layer is dead" — a false green inside a preset. Each generated
+ * builder declares its own root instead.
+ */
+export interface GlobTree<L> {
+    readonly op: 'any' | 'all';
+    readonly children: readonly (GlobTree<L> | GlobLeaf<L>)[];
+}
+/**
+ * What a predicate, condition or builder method declares.
+ *
+ * Its leaves are `DeclaredGlob`, which has no `position` and no `origin`, so
+ * a rule author **cannot** express "this is an exclusion" and thereby exempt
+ * their own predicate from the check. That is a type-level guarantee rather
+ * than a convention.
+ */
+export type DeclaredGlobs = GlobTree<DeclaredGlob>;
+/** A declared tree after a builder has stamped position and origin onto it. */
+export type GlobNode = GlobTree<GlobSite>;
+/** How many real declarations a tree holds. Opaque leaves do not count. */
+export declare function countDeclaredGlobs<L extends object>(tree: GlobTree<L>): number;
+/** Narrow a tree position to an interior node. */
+export declare function isGlobNode<L extends object>(value: GlobTree<L> | GlobLeaf<L>): value is GlobTree<L>;
+/** Narrow a leaf to the opaque case. */
+export declare function isOpaqueGlob<L extends object>(value: GlobTree<L> | GlobLeaf<L>): value is OpaqueGlob;
+/**
+ * A variadic declaration: any one of these globs matching is enough.
+ *
+ * `importFrom(...globs)` is `matchers.some`, so the set is dead only when
+ * every glob in it is — which is exactly `any`. Getting this wrong in the
+ * other direction is what the 0.18.1 withdrawal was.
+ */
+export declare function globAnyOf(globs: readonly string[], kind: GlobKind, base?: GlobBase): DeclaredGlobs;
+/** A single declaration as a one-element `any` tree. */
+export declare function globNode<L extends object>(leaf: L): GlobTree<L>;
+/**
+ * Stamp a declared tree with what only the builder knows.
+ *
+ * `origin` is a function of the declaration so each site can name itself —
+ * `resideInFolder("**\/src/x/**")` — rather than every site in one predicate
+ * sharing a single label.
+ */
+export declare function stampGlobs(declared: DeclaredGlobs, position: GlobPosition, origin: (glob: DeclaredGlob) => string): GlobNode;
+/**
+ * Negate a glob tree: invert `op` at every node **and** flip `polarity` at
+ * every site.
+ *
+ * A polarity flip alone is not enough, and the shortfall is not exotic — it is
+ * reachable through public exports, since `and()` returns a `Predicate<T>` and
+ * `not()` takes one. `not(and(live, not(dead)))` selects a non-empty set and
+ * would be reported dead; `not(or(live, not(dead)))` selects nothing and would
+ * be missed. Inverting `op` as well is the standard negation-normal-form
+ * push-down and fixes both directions, leaving every simpler case unchanged:
+ * `not(not(dead))` still faults, `not(and(a, b))` still does not.
+ */
+export declare function negateGlobs<L extends DeclaredGlob>(tree: GlobTree<L>): GlobTree<L>;
+/**
+ * Combine inputs into one node, treating a missing declaration as opaque.
+ *
+ * Every input contributes exactly one child, so the arity of the node always
+ * matches the arity of the combinator — which is what keeps `negateGlobs`
+ * sound and empty nodes unreachable.
+ */
+export declare function combineGlobs<L extends object>(op: 'any' | 'all', inputs: readonly (GlobTree<L> | undefined)[]): GlobTree<L>;
+//# sourceMappingURL=glob-site.d.ts.map

package/dist/glob-site.d.ts.map

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