@nielspeter/eess 0.2.2 → 0.5.0

package/dist/internal.js

@@ -0,0 +1,92 @@
+// @nielspeter/eess/internal — family plumbing (ADR-011).
+//
+// NOT public API. These symbols exist so the sibling dialects can share the
+// kernel's engine without each reimplementing it; a consumer writing rules never
+// names them, and nothing here is taught by `docs/` or a package README.
+//
+// The boundary is enforced on this side of the line only: a dialect may import
+// from here, and its barrel must never re-export what it finds. It cannot be
+// enforced on the consumer's side — a subpath export is published and resolvable
+// by anyone, which ADR-011's Enforcement table records as `manual` rather than
+// pretending otherwise.
+//
+// Moving a symbol OUT of here and onto the root is additive. Moving one IN is a
+// breaking change and needs a changeset that says so.
+export { DECLARE_INSTEAD } from './unsuppressable.js';
+export { UNSUPPRESSABLE } from './unsuppressable.js';
+export { UNSUPPRESSABLE_MECHANISMS } from './unsuppressable.js';
+export { applyFilters } from './execute-rule.js';
+export { applyFixes } from './apply-fixes.js';
+export { assertionLessViolation } from './terminal-builder.js';
+export { bold, red, dim, yellow, cyan, gray } from './ansi.js';
+export { byCodepoint, severityFor, remedyRepeatsMessage } from './violation.js';
+export { dedupeConfigFindings } from './dedupe-config-findings.js';
+// The emitter's own findings, for a dialect door that must tell "this receipt
+// carried no evidence" apart from "this rule matched nothing". They are
+// different faults with different remedies, and a door that refuses on the
+// second is a false positive — measured: one dead preset glob blocked every fix
+// in a run. Internal, not root: an adopter has no reason to mint or classify an
+// emitter finding, which is proposal 009's subject.
+export { isEmitterFinding, EMITTER_IDS } from './emitter-findings.js';
+export { disambiguateIdentities } from './violation.js';
+export { discoverIdentityRoot, normalizeIdentityText } from './identity-root.js';
+export { escapeGitHub } from './format-github.js';
+export { hashViolation } from './baseline.js';
+export { identityCollisions } from './violation.js';
+export { isAnchored, isProjectRelative } from './project-relative.js';
+export { isDescribable } from './rule-description.js';
+export { isFaultPosition, countDeclaredGlobs, isGlobNode, isOpaqueGlob, stampGlobs, negateGlobs, combineGlobs, } from './glob-site.js';
+export { isRecord, isNullaryCallable } from './type-guards.js';
+export { isSilent } from './silent-exclusion.js';
+export { marksAssertsCardinality } from './cardinality.js';
+export { marksOwnEmptyDiscovery, ownsEmptyDiscovery } from './owns-empty-discovery.js';
+export { matchSelections } from './matching.js';
+export { recordEdgeCoverage, untestedRules, edgeCoverageNotice, resetEdgeCoverage, } from './edge-coverage.js';
+export { registerCacheReset, clearRegisteredCaches } from './cache-registry.js';
+export { resetCommentSuppression, recordCommentSuppression, commentSuppressions, commentSuppressionNotice, } from './comment-suppression.js';
+export { resetIdentityCollisions } from './violation.js';
+export { resetStderrGuardForTests } from './stderr.js';
+export { selectionMemo } from './selection-memo.js';
+export { shallowClone } from './shallow-clone.js';
+export { subjectOf } from './violation.js';
+export { suppressionNotice, activeNotice, resetDiffDisclosureForTests } from './diff-disclosure.js';
+export { toPortablePath } from './identity-root.js';
+export { viewsFor } from './path-universe.js';
+// Bug 0257: one suffix resolver, called by eess-md and eess-crossvalidate.
+export { pathSuffixIndex } from './path-suffix.js';
+export { violationsEmittedCount } from './report.js';
+export { writeStderr } from './stderr.js';
+// Watch-mode scheduling and the watch loop, shared by every dialect CLI. Family
+// plumbing rather than public API (ADR-011): a consumer writing rules never
+// calls this; a dialect's `--watch` does. Unified here because the two copies
+// drifted and one of them kept a bug the other had fixed — see `watch.ts`.
+export { RunScheduler, watchAndRerun } from './watch.js';
+// The dialect-independent halves of CLI config handling — finding the file,
+// validating what a loaded module claims, and classifying Node's module-format
+// refusal. Family plumbing (ADR-011): a consumer writing rules never calls
+// these; every dialect's CLI does, and did so from its own copy until now.
+export { findConfigFile, extractSharedConfig, isModuleFormatRefusal, requireRuleFiles, } from './cli-config.js';
+// Recursive file discovery for the dialects that read a directory tree rather
+// than a TypeScript project (`eess-md`, `eess-crossvalidate`). Each carried its
+// own copy at 99% similarity.
+export { walkFiles, toPosix } from './file-walk.js';
+// The globs a rule declares, stamped with their origin. Family plumbing — a
+// dialect's own rule-declaration layer calls it; a consumer writing rules does not.
+export { declaredGlobsOf } from './rule-builder.js';
+// Recording exclusion patterns into a builder's state. Family plumbing: the
+// dialects' builders call it, a consumer writing rules does not.
+export { recordExclusions } from './silent-exclusion.js';
+// Applying a rule's predicates to its elements. Family plumbing: the dialects'
+// builders call it, a consumer writing rules does not.
+export { selectMatching, matchingElements } from './correspondence.js';
+// Recording a predicate on a builder, diagnosing one that arrived after
+// `.should()`. Family plumbing.
+export { recordPredicate } from './predicate.js';
+// Running a rule's conditions over its selected elements, carrying the evidence
+// count ADR-010 requires. Family plumbing: dialect builders call it.
+export { evaluateConditions, conditionContextFrom } from './condition.js';
+// Assembling a rule's English description from what it declared. Family
+// plumbing: every dialect builder renders one, a consumer does not.
+export { ruleDescriptionOf, ruleDescriptionFrom } from './rule-description.js';
+export { assertHomogeneous } from './combinators.js';
+//# sourceMappingURL=internal.js.map

package/dist/internal.js.map

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

package/dist/mask-non-comment.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Blank every span a directive must NOT be read from, preserving length and
+ * lines so reported positions are unchanged.
+ *
+ * Bug 0154: `parseExclusionComments` scanned raw source line by line with a bare
+ * regex, so text that merely LOOKED like `// eess-exclude …` — inside a string,
+ * a template literal, or a block comment describing the grammar — was parsed as
+ * a real waiver and silently suppressed a genuine finding on the next line. That
+ * is a suppression nobody wrote, which is the worst direction a suppression
+ * system can fail in.
+ *
+ * **Text-only, deliberately.** The kernel cannot import ts-morph (ADR-002/007
+ * confine it to `eess-ts`), so this is a hand-rolled single-pass scanner rather
+ * than an AST walk. The failure direction is what makes that acceptable: a
+ * mis-lex can only ever *hide* a directive — a waiver stops working, loudly, and
+ * the violation it was hiding comes back — never invent one.
+ *
+ * Line comments are deliberately NOT blanked: they are the thing being looked
+ * for. Everything else that can contain `//` is.
+ */
+/**
+ * Blank strings, template literals, regex literals and block comments.
+ *
+ * @param sourceText the raw file text
+ * @returns text of identical length and line structure, with those spans spaced out
+ */
+export declare function maskNonCommentSpans(sourceText: string): string;
+/**
+ * The markdown answer to the question `maskNonCommentSpans` asks of code.
+ *
+ * A `.md` file has no string or template literals, so running the JS/TS lexer
+ * over one is a category error — and a costly one, because markdown is
+ * backtick-dense: a single unbalanced backtick in prose opened a "template
+ * literal" that swallowed the rest of the file, silencing every real directive
+ * after it. Fail-closed, so no invented suppression, but a waiver that stops
+ * working for a reason nobody can see is its own defect.
+ *
+ * What markdown DOES have is code spans, and they mean the same thing a string
+ * literal means in code: this is an example of the grammar, not an instance of
+ * it. Fenced blocks (``` or ~~~) and inline spans are blanked; prose is left
+ * alone. Length- and line-preserving, so reported positions do not move.
+ *
+ * An unterminated fence blanks to end-of-file. That is the fail-closed
+ * direction: text under a fence that was opened and never closed is more likely
+ * an example than a waiver, and the cost is a directive that does not apply
+ * rather than one that applies where nobody asked.
+ */
+export declare function maskMarkdownCodeSpans(sourceText: string): string;
+//# sourceMappingURL=mask-non-comment.d.ts.map

package/dist/mask-non-comment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mask-non-comment.d.ts","sourceRoot":"","sources":["../src/mask-non-comment.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAkCH;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAyF9D;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAyChE"}

package/dist/mask-non-comment.js

@@ -0,0 +1,261 @@
+/**
+ * Blank every span a directive must NOT be read from, preserving length and
+ * lines so reported positions are unchanged.
+ *
+ * Bug 0154: `parseExclusionComments` scanned raw source line by line with a bare
+ * regex, so text that merely LOOKED like `// eess-exclude …` — inside a string,
+ * a template literal, or a block comment describing the grammar — was parsed as
+ * a real waiver and silently suppressed a genuine finding on the next line. That
+ * is a suppression nobody wrote, which is the worst direction a suppression
+ * system can fail in.
+ *
+ * **Text-only, deliberately.** The kernel cannot import ts-morph (ADR-002/007
+ * confine it to `eess-ts`), so this is a hand-rolled single-pass scanner rather
+ * than an AST walk. The failure direction is what makes that acceptable: a
+ * mis-lex can only ever *hide* a directive — a waiver stops working, loudly, and
+ * the violation it was hiding comes back — never invent one.
+ *
+ * Line comments are deliberately NOT blanked: they are the thing being looked
+ * for. Everything else that can contain `//` is.
+ */
+/** Replace a span with spaces, keeping newlines so line numbers do not move. */
+function blank(text, start, end) {
+    let out = '';
+    for (let i = start; i < end; i++) {
+        out += text[i] === '\n' ? '\n' : ' ';
+    }
+    return out;
+}
+/**
+ * A `/` here starts a regex literal rather than dividing.
+ *
+ * Decided by the previous significant character: after a value (identifier,
+ * literal, `)`, `]`) a `/` divides; after an operator, `(`, `,`, `=` or nothing
+ * it opens a regex. Getting this wrong is safe in one direction only — treating
+ * a division as a regex blanks source that could then hide a directive, so the
+ * bias is toward NOT opening a regex when unsure.
+ */
+function opensRegex(text, at) {
+    let i = at - 1;
+    while (i >= 0) {
+        const c = text[i];
+        if (c === undefined)
+            return true;
+        if (c === ' ' || c === '\t' || c === '\r' || c === '\n') {
+            i -= 1;
+            continue;
+        }
+        return !/[A-Za-z0-9_$)\]]/.test(c);
+    }
+    return true;
+}
+/**
+ * Blank strings, template literals, regex literals and block comments.
+ *
+ * @param sourceText the raw file text
+ * @returns text of identical length and line structure, with those spans spaced out
+ */
+export function maskNonCommentSpans(sourceText) {
+    let out = '';
+    let i = 0;
+    const n = sourceText.length;
+    while (i < n) {
+        const c = sourceText[i];
+        const next = sourceText[i + 1];
+        // Line comment — left intact; this is what the directive parser reads.
+        if (c === '/' && next === '/') {
+            const end = sourceText.indexOf('\n', i);
+            const stop = end === -1 ? n : end;
+            out += sourceText.slice(i, stop);
+            i = stop;
+            continue;
+        }
+        // Block comment — blanked. A grammar description inside JSDoc is prose.
+        if (c === '/' && next === '*') {
+            const close = sourceText.indexOf('*/', i + 2);
+            const stop = close === -1 ? n : close + 2;
+            out += blank(sourceText, i, stop);
+            i = stop;
+            continue;
+        }
+        // String or template literal — blanked whole, interpolations included. A
+        // `${…}` may itself contain a quote, so scanning it as code would need a
+        // nesting stack for no benefit: nothing inside a template is a directive.
+        if (c === '"' || c === "'" || c === '`') {
+            const quote = c;
+            let j = i + 1;
+            while (j < n) {
+                const d = sourceText[j];
+                if (d === '\\') {
+                    j += 2;
+                    continue;
+                }
+                if (d === quote) {
+                    j += 1;
+                    break;
+                }
+                // An unterminated single- or double-quoted string ends at the newline;
+                // a template legitimately spans lines.
+                if (d === '\n' && quote !== '`')
+                    break;
+                j += 1;
+            }
+            out += blank(sourceText, i, j);
+            i = j;
+            continue;
+        }
+        // Regex literal — blanked. `/…\/…/` can contain `//`.
+        if (c === '/' && opensRegex(sourceText, i)) {
+            let j = i + 1;
+            let inClass = false;
+            let closed = false;
+            while (j < n) {
+                const d = sourceText[j];
+                if (d === '\\') {
+                    j += 2;
+                    continue;
+                }
+                if (d === '\n')
+                    break;
+                if (d === '[')
+                    inClass = true;
+                else if (d === ']')
+                    inClass = false;
+                else if (d === '/' && !inClass) {
+                    j += 1;
+                    closed = true;
+                    break;
+                }
+                j += 1;
+            }
+            // Only blank when it really closed on the same line; an unterminated
+            // `/` was division after all, and blanking to end-of-line could hide a
+            // trailing directive.
+            if (closed) {
+                out += blank(sourceText, i, j);
+                i = j;
+                continue;
+            }
+        }
+        out += c;
+        i += 1;
+    }
+    return out;
+}
+/**
+ * The markdown answer to the question `maskNonCommentSpans` asks of code.
+ *
+ * A `.md` file has no string or template literals, so running the JS/TS lexer
+ * over one is a category error — and a costly one, because markdown is
+ * backtick-dense: a single unbalanced backtick in prose opened a "template
+ * literal" that swallowed the rest of the file, silencing every real directive
+ * after it. Fail-closed, so no invented suppression, but a waiver that stops
+ * working for a reason nobody can see is its own defect.
+ *
+ * What markdown DOES have is code spans, and they mean the same thing a string
+ * literal means in code: this is an example of the grammar, not an instance of
+ * it. Fenced blocks (``` or ~~~) and inline spans are blanked; prose is left
+ * alone. Length- and line-preserving, so reported positions do not move.
+ *
+ * An unterminated fence blanks to end-of-file. That is the fail-closed
+ * direction: text under a fence that was opened and never closed is more likely
+ * an example than a waiver, and the cost is a directive that does not apply
+ * rather than one that applies where nobody asked.
+ */
+export function maskMarkdownCodeSpans(sourceText) {
+    const lines = sourceText.split('\n');
+    const out = [];
+    let fenceChar;
+    let fenceLength = 0;
+    for (const line of lines) {
+        const opener = /^\s*(`{3,}|~{3,})/.exec(line);
+        const marker = opener === null ? undefined : opener[1];
+        if (fenceChar !== undefined) {
+            // Inside a fence: blank everything, the closing marker line included.
+            out.push(' '.repeat(line.length));
+            if (marker !== undefined && marker.charAt(0) === fenceChar && marker.length >= fenceLength) {
+                fenceChar = undefined;
+                fenceLength = 0;
+            }
+            continue;
+        }
+        if (marker !== undefined) {
+            fenceChar = marker.charAt(0);
+            fenceLength = marker.length;
+            out.push(' '.repeat(line.length));
+            continue;
+        }
+        // Markdown's THIRD code construct: a 4-space (or tab) indented block. Missed
+        // by the first version, which handled fences and inline spans only — so an
+        // indented example of a directive was read as a live waiver. Deliberately
+        // over-broad (a wrapped list item indents too): over-masking hides a
+        // directive, which is loud; under-masking invents one, which is silent.
+        if (/^(?: {4}|\t)/.test(line)) {
+            out.push(' '.repeat(line.length));
+            continue;
+        }
+        // Outside a fence: blank BALANCED inline spans only. An odd backtick is
+        // prose, and treating it as an opener is exactly the bug this replaces.
+        out.push(blankInlineCodeSpans(line));
+    }
+    return out.join('\n');
+}
+/**
+ * Blank code spans on one line, matching backtick RUNS the way CommonMark does:
+ * an opening run of N backticks is closed by the next run of exactly N.
+ *
+ * The first version paired backticks one at a time, which left the contents of
+ * any run of two or more exposed — so a directive inside ``…`` survived masking
+ * and was read as a live waiver. That is a suppression nobody wrote, the one
+ * direction this whole module exists to prevent (bug 0154), reintroduced by the
+ * fix for it. Multi-tick runs are not exotic here: they are the repo's own
+ * convention for code containing a backtick.
+ *
+ * An unclosed run is left as ordinary text, so a stray tick in prose still
+ * cannot swallow the rest of the line.
+ */
+function blankInlineCodeSpans(line) {
+    const runs = [];
+    let i = 0;
+    while (i < line.length) {
+        if (line.charAt(i) !== '`') {
+            i += 1;
+            continue;
+        }
+        const start = i;
+        while (i < line.length && line.charAt(i) === '`')
+            i += 1;
+        runs.push({ start, length: i - start });
+    }
+    if (runs.length < 2)
+        return line;
+    let out = line;
+    let openIndex = 0;
+    while (openIndex < runs.length) {
+        const open = runs[openIndex];
+        if (open === undefined)
+            break;
+        let closeIndex = -1;
+        for (let j = openIndex + 1; j < runs.length; j++) {
+            const candidate = runs[j];
+            if (candidate !== undefined && candidate.length === open.length) {
+                closeIndex = j;
+                break;
+            }
+        }
+        if (closeIndex === -1) {
+            // No matching close: this run is prose, not a delimiter.
+            openIndex += 1;
+            continue;
+        }
+        const close = runs[closeIndex];
+        if (close === undefined)
+            break;
+        const from = open.start;
+        const to = close.start + close.length;
+        out = out.slice(0, from) + ' '.repeat(to - from) + out.slice(to);
+        openIndex = closeIndex + 1;
+    }
+    return out;
+}
+//# sourceMappingURL=mask-non-comment.js.map

package/dist/mask-non-comment.js.map

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

package/dist/owns-empty-discovery.d.ts

@@ -0,0 +1,5 @@
+/** Declare that this condition reports an empty discovery population itself. */
+export declare function marksOwnEmptyDiscovery<T extends object>(condition: T): T;
+/** Does this condition report an empty discovery population itself? */
+export declare function ownsEmptyDiscovery(condition: object): boolean;
+//# sourceMappingURL=owns-empty-discovery.d.ts.map

package/dist/owns-empty-discovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"owns-empty-discovery.d.ts","sourceRoot":"","sources":["../src/owns-empty-discovery.ts"],"names":[],"mappings":"AAoEA,gFAAgF;AAChF,wBAAgB,sBAAsB,CAAC,CAAC,SAAS,MAAM,EAAE,SAAS,EAAE,CAAC,GAAG,CAAC,CAGxE;AAED,uEAAuE;AACvE,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAE7D"}

package/dist/owns-empty-discovery.js

@@ -0,0 +1,85 @@
+/**
+ * A condition that diagnoses its own empty discovery population.
+ *
+ * [ts-archunit Plan 0081](https://github.com/nielspeter/ts-archunit/blob/main/plans/completed/0081-a-condition-declares-discovery-ownership.md). The
+ * dead-glob gate can see that a `.layer()` or `.inFolder()` glob matched nothing,
+ * but it short-circuits **before** the condition runs, so where a condition
+ * produces a better finding — one that names the dead layer, with a remedy
+ * pointing at the call the reader must edit — the gate would replace it with a
+ * generic message. This symbol is how a condition says "leave it to me".
+ *
+ * ## Why per condition, and not per builder
+ *
+ * It was per builder, and the granularity was load-bearing rather than cosmetic.
+ * At v0.45.0 `PairFinalBuilder` returned `true` unconditionally while its own
+ * docstring claimed *"All three now produce a finding naming the layer"* — and
+ * that claim was false: `haveMatchingCounterpart` checked for empty layers inside
+ * its pair loop, so a dead **final** layer produced no configuration finding at
+ * all. The coarse declaration suppressed the gate for exactly the case its
+ * declared owner did not handle, and the result was silence where the truth was
+ * one dead glob
+ * ([ts-archunit bug 0040](https://github.com/nielspeter/ts-archunit/blob/main/bugs/fixed/0040-a-crosslayer-rule-reports-nothing-when-its-layer-resolves-nothing.md)).
+ *
+ * v0.45.1 fixed the condition, so the blanket claim became true again. It would
+ * have gone false again the moment a fourth condition reached that builder,
+ * because nothing forced the new condition to say anything. Now the claim is not
+ * a claim: the builder reads the tag off the condition it was given.
+ *
+ * **An untagged condition does not own it, so the gate covers it.** That default
+ * is the load-bearing half — under it, v0.45.0's hole would have degraded to a
+ * generic message rather than silence, and a generic message is recoverable. An
+ * agent reading "this glob matched nothing" fixes the glob; silence sends it to
+ * write files into a layer that will never match.
+ *
+ * ## Unreachable by construction — a registry, not a property
+ *
+ * The first version was a `unique symbol` keyed onto the condition object, copying
+ * `ASSERTS_CARDINALITY`. Review broke it in two lines:
+ *
+ * ```ts
+ * const stolen = Object.getOwnPropertySymbols(haveMatchingCounterpart())[0]
+ * const mine: PairCondition = { description: 'x', evaluate: () => [], [stolen]: true }
+ * ```
+ *
+ * Measured: **0 configuration findings** on a dead layer. `PairCondition` is a
+ * public type and all three condition factories are public exports, so the symbol
+ * was readable off any shipped condition — the one-line silent opt-out this file
+ * claimed could not exist, reachable through documented API.
+ *
+ * The `ASSERTS_CARDINALITY` precedent is stronger than the copy was, and that is
+ * why copying it was not enough: `defineCondition` is its *sanctioned constructor*,
+ * and a test asserts that constructor emits no own symbols. `PairCondition` has no
+ * sanctioned constructor, so there is nothing to make the analogous guarantee.
+ *
+ * A module-level `WeakSet` closes that hole for the KEY: membership is not a
+ * property of the object, so it cannot be read off one, copied, or forged.
+ *
+ * It does not close it for the CALL, and the clause that used to say so — "a
+ * caller would need this module's binding, and it is not exported" — was already
+ * false when it was written: `marksOwnEmptyDiscovery` was exported from the
+ * kernel root. It now sits behind `@nielspeter/eess/internal`, which is narrower
+ * and still reachable. See `cardinality.ts` for the same limitation stated in
+ * full; the two markers share it.
+ *
+ * `WeakSet` rather than `Set` so a condition is not retained after its rule is
+ * discarded.
+ */
+const OWNERS = new WeakSet();
+/** Declare that this condition reports an empty discovery population itself. */
+export function marksOwnEmptyDiscovery(condition) {
+    OWNERS.add(condition);
+    return condition;
+}
+/** Does this condition report an empty discovery population itself? */
+export function ownsEmptyDiscovery(condition) {
+    return OWNERS.has(condition);
+}
+/*
+ * Not every builder needs this. `SliceRuleBuilder` declares ownership at the
+ * BUILDER level and correctly so: its reason — `assignedFrom` fanning out one glob
+ * tree per entry, where a single dead entry among populated siblings is a
+ * legitimate project shape — is identical for every condition reachable through
+ * it. Registry membership is for the case where ownership varies by condition,
+ * which is what made a blanket declaration wrong for cross-layer.
+ */
+//# sourceMappingURL=owns-empty-discovery.js.map

package/dist/owns-empty-discovery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"owns-empty-discovery.js","sourceRoot":"","sources":["../src/owns-empty-discovery.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiEG;AACH,MAAM,MAAM,GAAG,IAAI,OAAO,EAAU,CAAA;AAEpC,gFAAgF;AAChF,MAAM,UAAU,sBAAsB,CAAmB,SAAY;IACnE,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,CAAA;IACrB,OAAO,SAAS,CAAA;AAClB,CAAC;AAED,uEAAuE;AACvE,MAAM,UAAU,kBAAkB,CAAC,SAAiB;IAClD,OAAO,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,CAAA;AAC9B,CAAC;AAED;;;;;;;GAOG"}

package/dist/path-suffix.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Resolve a cited path against a set of repo-relative paths.
+ *
+ * Two dialects had written this independently — `eess-md`'s `uniqueSuffix()`
+ * for `path:line` code pointers, and `eess-crossvalidate`'s `resolveFeature`
+ * for `.feature` citations. Same algorithm, same three-way answer, and after
+ * bug 0254 the same remedy text; bug 0257 is that duplication.
+ *
+ * **Why the kernel.** It is pure string work over a list of paths: no
+ * `ArchProject`, no ts-morph, nothing dialect-shaped. That is exactly
+ * `path-universe.ts`'s argument for living here, and
+ * [ADR-013](../../../adr/013-the-kernel-takes-the-fact-not-the-project.md)'s
+ * test is satisfied — the kernel takes the *fact* (a list of paths), not the
+ * project that produced it. It is family plumbing rather than public API, so it
+ * is exported from `internal.ts` (ADR-011).
+ *
+ * **What it deliberately does not decide.** Whether a `none` is broken, whether
+ * an `ambiguous` fails or warns, whether to consult external roots, what the
+ * message says — all of that is the caller's policy and differs between the two
+ * dialects for good reasons. This answers one question: *which path did they
+ * mean?*
+ */
+/** How a cited path resolves against a set of repo-relative paths. */
+export type PathSuffixMatch = 
+/** The citation IS a repo-relative path. Wins outright, even if the same tail also matches elsewhere. */
+{
+    readonly kind: 'exact';
+    readonly file: string;
+}
+/** Exactly one path ends with the citation on a `/` boundary. */
+ | {
+    readonly kind: 'unique';
+    readonly file: string;
+}
+/** Several do, so the citation names none of them. Candidates in index order. */
+ | {
+    readonly kind: 'ambiguous';
+    readonly files: readonly string[];
+}
+/** Nothing matches. */
+ | {
+    readonly kind: 'none';
+};
+/** A prepared path set. Build once, resolve many. Duplicate inputs collapse. */
+export interface PathSuffixIndex {
+    resolve(wanted: string): PathSuffixMatch;
+}
+/**
+ * Prepare a path set for repeated suffix lookups.
+ *
+ * Indexed by last segment, because the corpora this runs over resolve hundreds
+ * of citations against thousands of paths and a linear scan per citation was
+ * measurable in `eess-md`. The index is the reason this takes the whole set up
+ * front rather than being a plain two-argument function.
+ */
+export declare function pathSuffixIndex(paths: Iterable<string>): PathSuffixIndex;
+//# sourceMappingURL=path-suffix.d.ts.map

package/dist/path-suffix.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"path-suffix.d.ts","sourceRoot":"","sources":["../src/path-suffix.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,sEAAsE;AACtE,MAAM,MAAM,eAAe;AACzB,yGAAyG;AACvG;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE;AACnD,iEAAiE;GAC/D;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE;AACpD,iFAAiF;GAC/E;IAAE,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAA;CAAE;AACnE,uBAAuB;GACrB;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAA;AAE7B,gFAAgF;AAChF,MAAM,WAAW,eAAe;IAC9B,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,eAAe,CAAA;CACzC;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,eAAe,CAsCxE"}