@nielspeter/eess-ts 0.4.0 → 0.5.1

package/dist/core/disk-set.js.map

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

package/dist/core/element-cache.js

@@ -1,4 +1,4 @@
-import { registerCacheReset } from '@nielspeter/eess';
+import { registerCacheReset } from '@nielspeter/eess/internal';
 /** A cache private to one builder module, typed to that builder's element. */
 export function createElementCache() {
     let perProject = new WeakMap();

package/dist/core/element-cache.js.map

@@ -1 +1 @@
-{"version":3,"file":"element-cache.js","sourceRoot":"","sources":["../../src/core/element-cache.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAA;AAuErD,8EAA8E;AAC9E,MAAM,UAAU,kBAAkB;IAChC,IAAI,UAAU,GAAG,IAAI,OAAO,EAAiC,CAAA;IAC7D,8EAA8E;IAC9E,gFAAgF;IAChF,kEAAkE;IAClE,kBAAkB,CAAC,GAAG,EAAE;QACtB,UAAU,GAAG,IAAI,OAAO,EAAiC,CAAA;IAC3D,CAAC,CAAC,CAAA;IAEF,OAAO;QACL,GAAG,CAAC,OAAoB,EAAE,GAAW,EAAE,OAAkB;YACvD,IAAI,KAAK,GAAG,UAAU,CAAC,GAAG,CAAC,OAAO,CAAC,CAAA;YACnC,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;gBACxB,KAAK,GAAG,IAAI,GAAG,EAAe,CAAA;gBAC9B,UAAU,CAAC,GAAG,CAAC,OAAO,EAAE,KAAK,CAAC,CAAA;YAChC,CAAC;YACD,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;YAC1B,sEAAsE;YACtE,kEAAkE;YAClE,mEAAmE;YACnE,IAAI,GAAG,KAAK,SAAS;gBAAE,OAAO,GAAG,CAAA;YACjC,MAAM,KAAK,GAAG,OAAO,EAAE,CAAA;YACvB,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAA;YACrB,OAAO,KAAK,CAAA;QACd,CAAC;KACF,CAAA;AACH,CAAC;AAED,gFAAgF;AAChF,MAAM,CAAC,MAAM,eAAe,GAAG,SAAS,CAAA"}
+{"version":3,"file":"element-cache.js","sourceRoot":"","sources":["../../src/core/element-cache.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAA;AAuE9D,8EAA8E;AAC9E,MAAM,UAAU,kBAAkB;IAChC,IAAI,UAAU,GAAG,IAAI,OAAO,EAAiC,CAAA;IAC7D,8EAA8E;IAC9E,gFAAgF;IAChF,kEAAkE;IAClE,kBAAkB,CAAC,GAAG,EAAE;QACtB,UAAU,GAAG,IAAI,OAAO,EAAiC,CAAA;IAC3D,CAAC,CAAC,CAAA;IAEF,OAAO;QACL,GAAG,CAAC,OAAoB,EAAE,GAAW,EAAE,OAAkB;YACvD,IAAI,KAAK,GAAG,UAAU,CAAC,GAAG,CAAC,OAAO,CAAC,CAAA;YACnC,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;gBACxB,KAAK,GAAG,IAAI,GAAG,EAAe,CAAA;gBAC9B,UAAU,CAAC,GAAG,CAAC,OAAO,EAAE,KAAK,CAAC,CAAA;YAChC,CAAC;YACD,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;YAC1B,sEAAsE;YACtE,kEAAkE;YAClE,mEAAmE;YACnE,IAAI,GAAG,KAAK,SAAS;gBAAE,OAAO,GAAG,CAAA;YACjC,MAAM,KAAK,GAAG,OAAO,EAAE,CAAA;YACvB,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAA;YACrB,OAAO,KAAK,CAAA;QACd,CAAC;KACF,CAAA;AACH,CAAC;AAED,gFAAgF;AAChF,MAAM,CAAC,MAAM,eAAe,GAAG,SAAS,CAAA"}

package/dist/core/exclusion-comments.d.ts

@@ -1,54 +1,19 @@
-import type { ArchViolation } from '@nielspeter/eess';
+import { isExcludedByComment as isExcludedShared } from '@nielspeter/eess';
+import type { ExclusionComment, ExclusionWarning, ParseResult } from '@nielspeter/eess';
 /**
- * Exclusion comment parsed from source code.
+ * Exclusion comments for `eess-ts` — the kernel's parser, with this dialect's
+ * lexer.
+ *
+ * **This file used to be a second parser** (426 lines), and it drifted: bug
+ * 0158's fix landed on the kernel copy and never reached here, so a bare
+ * `eess-exclude-start` was silent in `eess-ts` and blamed the `-end` line when it
+ * did speak. That is bug 0227, and it is why ADR-012 exists.
+ *
+ * What was ever this package's own is the masker — knowing which spans of a
+ * `.ts` file are string literals needs a TypeScript parser, and the kernel
+ * cannot have one. That is now the only thing passed across.
  */
-export interface ExclusionComment {
-    /** Rule ID being excluded */
-    ruleId: string;
-    /** Required reason for the exclusion */
-    reason: string;
-    /** File path where the comment was found */
-    file: string;
-    /** Line number of the comment */
-    line: number;
-    /** Whether this is a block exclusion (start/end) */
-    isBlock: boolean;
-    /** End line for block exclusions */
-    endLine?: number;
-}
-/**
- * Validation warning for exclusion comments.
- */
-export interface ExclusionWarning {
-    /** Warning message */
-    message: string;
-    /** File path */
-    file: string;
-    /** Line number */
-    line: number;
-    /**
-     * What kind of fault this is, so a caller can act on it differently.
-     *
-     * `'undocumented'` — the directive is well-formed and **applied**; it just
-     * states no reason. Since v0.38.0 this fails the build ([ts-archunit bug 0039](https://github.com/nielspeter/ts-archunit/blob/main/bugs/fixed/0039-an-undocumented-exclusion-comment-suppresses-and-only-warns.md)),
-     * because a suppression nobody justified is the marker ADR-009 rule 3's
-     * corollary warns about.
-     *
-     * `'malformed'` — the directive is broken syntax and was **not** applied. Two
-     * of the three malformed shapes therefore leave the original violation firing,
-     * so the build is already red and a stderr line is the right weight.
-     */
-    kind: 'undocumented' | 'malformed';
-}
-/**
- * Result of parsing exclusion comments from a source file.
- */
-export interface ParseResult {
-    /** Successfully parsed exclusion comments */
-    exclusions: ExclusionComment[];
-    /** Warnings about malformed comments */
-    warnings: ExclusionWarning[];
-}
+export type { ExclusionComment, ExclusionWarning, ParseResult };
 export declare function parseExclusionComments(sourceText: string, filePath: string): ParseResult;
-export declare function isExcludedByComment(violation: ArchViolation, comments: ExclusionComment[]): boolean;
+export declare const isExcludedByComment: typeof isExcludedShared;
 //# sourceMappingURL=exclusion-comments.d.ts.map

package/dist/core/exclusion-comments.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"exclusion-comments.d.ts","sourceRoot":"","sources":["../../src/core/exclusion-comments.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AAErD;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,6BAA6B;IAC7B,MAAM,EAAE,MAAM,CAAA;IACd,wCAAwC;IACxC,MAAM,EAAE,MAAM,CAAA;IACd,4CAA4C;IAC5C,IAAI,EAAE,MAAM,CAAA;IACZ,iCAAiC;IACjC,IAAI,EAAE,MAAM,CAAA;IACZ,oDAAoD;IACpD,OAAO,EAAE,OAAO,CAAA;IAChB,oCAAoC;IACpC,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,sBAAsB;IACtB,OAAO,EAAE,MAAM,CAAA;IACf,gBAAgB;IAChB,IAAI,EAAE,MAAM,CAAA;IACZ,kBAAkB;IAClB,IAAI,EAAE,MAAM,CAAA;IACZ;;;;;;;;;;;OAWG;IACH,IAAI,EAAE,cAAc,GAAG,WAAW,CAAA;CACnC;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,6CAA6C;IAC7C,UAAU,EAAE,gBAAgB,EAAE,CAAA;IAC9B,wCAAwC;IACxC,QAAQ,EAAE,gBAAgB,EAAE,CAAA;CAC7B;AAwRD,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,WAAW,CAsDxF;AAuBD,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,aAAa,EACxB,QAAQ,EAAE,gBAAgB,EAAE,GAC3B,OAAO,CAUT"}
+{"version":3,"file":"exclusion-comments.d.ts","sourceRoot":"","sources":["../../src/core/exclusion-comments.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,mBAAmB,IAAI,gBAAgB,EACxC,MAAM,kBAAkB,CAAA;AACzB,OAAO,KAAK,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAGvF;;;;;;;;;;;;GAYG;AACH,YAAY,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,WAAW,EAAE,CAAA;AAE/D,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,WAAW,CAExF;AAED,eAAO,MAAM,mBAAmB,yBAAmB,CAAA"}

package/dist/core/exclusion-comments.js

@@ -1,310 +1,7 @@
-import path from 'node:path';
-import { Project, SyntaxKind } from 'ts-morph';
-// A directive must BEGIN its comment. The regexes are anchored at `^` and the
-// caller slices each line from its first `//`, so they see the comment and
-// nothing before it — which keeps the documented TRAILING form working
-// (`const a = 1 // <directive>`), where the comment starts mid-line. Anchoring
-// to the start of the LINE instead was the first attempt and broke exactly
-// that; the guard's trailing rows caught it.
-//
-// It used to match anywhere in the line, which made any comment *mentioning*
-// the syntax a live directive. This file's own grammar documentation was one:
-// a line reading "Single-line without reason: <the directive>" declared a
-// real, reason-less exclusion against whatever rule was being evaluated, and
-// this repo's preset fan-out test caught it the moment comments started being
-// read correctly. Every user documenting the feature in a code comment would
-// have hit the same thing.
-//
-// A trailing directive still works — `const a = 1 // <directive>` — because
-// there the comment itself begins with it.
-const SINGLE_LINE_RE = /^\/\/\s*eess-exclude\s+(.+)/;
-// Block start: // eess-exclude-start <rule-id>[, <rule-id>]: <reason>
-const BLOCK_START_RE = /^\/\/\s*eess-exclude-start\s+(.+)/;
-// Block end: // eess-exclude-end
-const BLOCK_END_RE = /^\/\/\s*eess-exclude-end\b/;
-/**
- * Parse rule IDs and reason from the content after the directive keyword.
- *
- * Format: `rule-a, rule-b: reason text`
- * If no colon is present, all content is treated as rule IDs and reason is empty.
- */
-function parseRuleIdsAndReason(content) {
-    const colonIndex = content.indexOf(':');
-    if (colonIndex < 0) {
-        // No colon — all content is rule IDs, no reason
-        const ruleIds = content
-            .split(',')
-            .map((s) => s.trim())
-            .filter((s) => s.length > 0);
-        return { ruleIds, reason: '' };
-    }
-    const idsPart = content.slice(0, colonIndex);
-    const reason = content.slice(colonIndex + 1).trim();
-    const ruleIds = idsPart
-        .split(',')
-        .map((s) => s.trim())
-        .filter((s) => s.length > 0);
-    return { ruleIds, reason };
-}
-/** Handle a block-end directive line. */
-function handleBlockEnd(frames, exclusions, warnings, filePath, lineNum) {
-    const innermost = frames.pop();
-    if (innermost === undefined) {
-        warnings.push({
-            message: `eess-exclude-end without matching start`,
-            file: filePath,
-            line: lineNum,
-            kind: 'malformed',
-        });
-        return;
-    }
-    // Close the innermost frame only. This used to close **every** open block,
-    // which is how a nested region silently ended its parent early (bug 0039):
-    // the inner `-end` closed the outer, and everything after it was unexcluded
-    // while looking excluded in the source.
-    for (const comment of innermost) {
-        comment.endLine = lineNum;
-        exclusions.push(comment);
-    }
-}
-/** Emit undocumented-exclusion warnings for each rule ID when no reason is given. */
-function warnUndocumented(warnings, ruleIds, directive, filePath, lineNum) {
-    for (const ruleId of ruleIds) {
-        warnings.push({
-            message: `Undocumented exclusion at ${filePath}:${String(lineNum)} — ` +
-                `// ${directive} ${ruleId}\n` +
-                `  Fix: Add a reason — // ${directive} ${ruleId}: <why>`,
-            file: filePath,
-            line: lineNum,
-            kind: 'undocumented',
-        });
-    }
-}
-/** Handle a block-start directive line. */
-function handleBlockStart(content, frames, warnings, filePath, lineNum) {
-    const { ruleIds, reason } = parseRuleIdsAndReason(content);
-    if (reason === '') {
-        warnUndocumented(warnings, ruleIds, 'eess-exclude-start', filePath, lineNum);
-    }
-    // Nesting a DIFFERENT rule is legitimate and used to be refused outright —
-    // exempting `arch/no-cycles` across a module and `arch/no-any` across one
-    // function inside it is an ordinary thing to want. The old code warned and
-    // dropped the inner directive, then let the inner `-end` close the outer
-    // block, so both exemptions were wrong: the inner never applied and the outer
-    // stopped early. Frames make both work.
-    //
-    // Re-opening a rule that is ALREADY open is different — it is redundant, and
-    // the likeliest cause is a missing `-end`. Warned, but still pushed: refusing
-    // it is what produced the early-close bug.
-    const alreadyOpen = new Set(frames.flat().map((c) => c.ruleId));
-    for (const ruleId of ruleIds) {
-        if (alreadyOpen.has(ruleId)) {
-            warnings.push({
-                message: `eess-exclude-start for '${ruleId}' is already open — ` +
-                    `the enclosing block covers this region. Fix: remove this directive, ` +
-                    `or close the enclosing block first if the nesting was unintended.`,
-                file: filePath,
-                line: lineNum,
-                kind: 'malformed',
-            });
-        }
-    }
-    frames.push(ruleIds.map((ruleId) => ({
-        ruleId,
-        reason,
-        file: filePath,
-        line: lineNum,
-        isBlock: true,
-    })));
-}
-/** Handle a single-line exclude directive. */
-function handleSingleLine(content, exclusions, warnings, filePath, lineNum) {
-    // Skip if this was a block start or end (already handled above, but guard)
-    if (content.startsWith('-start') || content.startsWith('-end'))
-        return;
-    const { ruleIds, reason } = parseRuleIdsAndReason(content);
-    if (reason === '') {
-        warnUndocumented(warnings, ruleIds, 'eess-exclude', filePath, lineNum);
-    }
-    for (const ruleId of ruleIds) {
-        exclusions.push({
-            ruleId,
-            reason,
-            file: filePath,
-            line: lineNum,
-            isBlock: false,
-        });
-    }
-}
-/**
- * Scan a source file for eess-ts exclusion comments.
- *
- * Supported formats:
- *   // eess-exclude <rule-id>: <reason>
- *   // eess-exclude-start <rule-id>: <reason>
- *   // eess-exclude-end
- *   // eess-exclude <rule-a>, <rule-b>: <reason>
- */
-/**
- * Every string-like literal, blanked — [ts-archunit bug 0043](https://github.com/nielspeter/ts-archunit/blob/main/bugs/fixed/0043-an-exclusion-directive-inside-a-string-literal-suppresses.md).
- *
- * The scan below is line-based, and a line-based scan cannot tell a directive
- * from the same characters inside a string. Measured before this existed: all
- * three of `"…"`, `'…'` and `` `…` `` containing the directive text produced a
- * **live exclusion** that silenced a real finding — silently, because a
- * directive carrying a reason never triggers the undocumented-exclusion warning.
- *
- * **Newlines are preserved**, and that is the load-bearing part: the scan below
- * is line-based and reports `line` on every exclusion, so a mask that dropped a
- * newline would misreport every directive after it.
- *
- * Characters are replaced with spaces rather than removed, which keeps
- * intra-line offsets stable too — but nothing downstream consumes a column, so
- * that half is defence in depth rather than a guarded property. Measured:
- * collapsing the blanks to `''`, and masking one character short, both leave the
- * suite green. Recorded rather than dressed up — a sabotage row that survives
- * for a real reason is a different thing from a missing guard.
- *
- * ## Why a parse, and not a scan
- *
- * The first attempt used `ts.createScanner`, which is the real lexer and fixed
- * the three plain cases. It left two: `` `${x} // …` `` and JSX text. A bare
- * scanner has no parser context, so it cannot know when to re-scan a template
- * middle or JSX children, and both were classified as code — meaning the `//`
- * inside them became a comment. Measured, not predicted.
- *
- * So: parse, and blank the literals. Everything remaining is code, where `//`
- * genuinely does start a comment.
- *
- * A **ts-morph** project rather than the raw compiler API, per
- * [ADR-002](../../../../adr/002-ts-morph-ast-engine.md), reusing one in-memory project
- * across calls so the cost is a parse rather than a project construction. The
- * whole scan is gated on a rule having already produced a violation in the file,
- * so nothing is parsed for a clean run.
- *
- * A `TemplateExpression` is blanked **whole**, including its `${…}`
- * substitutions. A comment is legal inside a substitution, so this can miss a
- * real directive there — it errs toward *not* suppressing, which is the safe
- * direction for a mechanism whose failure mode is a silent green.
- */
-const LITERAL_KINDS = [
-    SyntaxKind.StringLiteral,
-    SyntaxKind.NoSubstitutionTemplateLiteral,
-    SyntaxKind.TemplateExpression,
-    SyntaxKind.RegularExpressionLiteral,
-    SyntaxKind.JsxText,
-];
-let scratch;
-function withoutLiterals(sourceText, filePath) {
-    scratch ??= new Project({ useInMemoryFileSystem: true });
-    // `.tsx` so JSX parses; a `.ts` parse reads `<div>` as a type assertion and
-    // the JsxText case silently stops being covered.
-    const sourceFile = scratch.createSourceFile(`/scan/${path.basename(filePath)}.tsx`, sourceText, {
-        overwrite: true,
-    });
-    const out = sourceText.split('');
-    for (const kind of LITERAL_KINDS) {
-        for (const node of sourceFile.getDescendantsOfKind(kind)) {
-            for (let i = node.getStart(); i < node.getEnd(); i++) {
-                if (out[i] !== undefined && out[i] !== '\n')
-                    out[i] = ' ';
-            }
-        }
-    }
-    const withoutLiteralText = out.join('');
-    // Block comments too, and this is not tidying — it is the difference between
-    // documenting the feature and invoking it.
-    //
-    // The grammar is `//`-only and always has been (a `/* … */` directive produced
-    // no exclusion before this fix and still produces none). But a JSDoc block
-    // that *mentions* the directive in prose puts the characters on a line, and
-    // the line scan below cannot tell prose from a directive.
-    //
-    // Found the hard way: this very file's docstring explains the bug, contains
-    // the directive text, and the moment comments started being read correctly it
-    // declared a live exclusion against `preset/boundaries/no-cross-boundary` —
-    // caught by this repo's own preset fan-out test. Any user writing a code
-    // comment about the feature would hit the same thing.
-    //
-    // Safe to do with a regex here, and only here: every string, template and
-    // regex literal has already been blanked, so a surviving `/*` is a real
-    // block-comment start.
-    return withoutLiteralText.replace(/\/\*[\s\S]*?\*\//g, (m) => m.replace(/[^\n]/g, ' '));
-}
+import { parseExclusionComments as parseShared, isExcludedByComment as isExcludedShared, } from '@nielspeter/eess';
+import { maskTsLiterals } from './ts-comment-mask.js';
 export function parseExclusionComments(sourceText, filePath) {
-    // A directive inside a string is not a directive (bug 0043).
-    const lines = withoutLiterals(sourceText, filePath).split('\n');
-    const exclusions = [];
-    const warnings = [];
-    // A STACK of frames, one per `-start` line, each holding that line's rule ids.
-    // One `-end` closes one frame. A single-level block behaves exactly as before;
-    // nesting now works instead of silently mangling both regions.
-    const frames = [];
-    for (let i = 0; i < lines.length; i++) {
-        const line = lines[i];
-        if (line === undefined)
-            continue;
-        const lineNum = i + 1;
-        // Slice from the comment start. Literals are already blanked, so the first
-        // `//` on the line is a real comment opener — and anything before it is
-        // code, which cannot contain a directive.
-        const commentStart = line.indexOf('//');
-        if (commentStart === -1)
-            continue;
-        const comment = line.slice(commentStart);
-        // Check block end first (before start/single so we don't match -start as single)
-        if (BLOCK_END_RE.test(comment)) {
-            handleBlockEnd(frames, exclusions, warnings, filePath, lineNum);
-            continue;
-        }
-        // Check block start
-        const startMatch = BLOCK_START_RE.exec(comment);
-        if (startMatch?.[1]) {
-            handleBlockStart(startMatch[1], frames, warnings, filePath, lineNum);
-            continue;
-        }
-        // Check single-line exclude (must not match block directives)
-        const singleMatch = SINGLE_LINE_RE.exec(comment);
-        if (singleMatch?.[1]) {
-            handleSingleLine(singleMatch[1], exclusions, warnings, filePath, lineNum);
-        }
-    }
-    // Any unclosed frame is an error, and pushes no exclusion — so an unterminated
-    // block fails closed: the violation it meant to cover still fires.
-    for (const comment of frames.flat()) {
-        warnings.push({
-            message: `eess-exclude-start without matching end for rule '${comment.ruleId}'`,
-            file: filePath,
-            line: comment.line,
-            kind: 'malformed',
-        });
-    }
-    return { exclusions, warnings };
-}
-/**
- * Check if a violation is covered by an exclusion comment.
- *
- * For single-line comments: the violation must be in the same file and
- * on the line immediately after the comment.
- *
- * For block comments: the violation must be in the same file and
- * within the line range (start line, end line) inclusive.
- */
-/** Check if a single comment covers the given violation. */
-function commentCoversViolation(comment, violationLine) {
-    if (comment.isBlock) {
-        return (comment.endLine !== undefined &&
-            violationLine >= comment.line &&
-            violationLine <= comment.endLine);
-    }
-    return violationLine === comment.line + 1;
-}
-export function isExcludedByComment(violation, comments) {
-    const ruleId = violation.ruleId;
-    if (!ruleId)
-        return false;
-    return comments.some((comment) => comment.ruleId === ruleId &&
-        comment.file === violation.file &&
-        commentCoversViolation(comment, violation.line));
+    return parseShared(sourceText, filePath, { mask: maskTsLiterals });
 }
+export const isExcludedByComment = isExcludedShared;
 //# sourceMappingURL=exclusion-comments.js.map

package/dist/core/exclusion-comments.js.map

@@ -1 +1 @@
-{"version":3,"file":"exclusion-comments.js","sourceRoot":"","sources":["../../src/core/exclusion-comments.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"exclusion-comments.js","sourceRoot":"","sources":["../../src/core/exclusion-comments.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,sBAAsB,IAAI,WAAW,EACrC,mBAAmB,IAAI,gBAAgB,GACxC,MAAM,kBAAkB,CAAA;AAEzB,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAiBrD,MAAM,UAAU,sBAAsB,CAAC,UAAkB,EAAE,QAAgB;IACzE,OAAO,WAAW,CAAC,UAAU,EAAE,QAAQ,EAAE,EAAE,IAAI,EAAE,cAAc,EAAE,CAAC,CAAA;AACpE,CAAC;AAED,MAAM,CAAC,MAAM,mBAAmB,GAAG,gBAAgB,CAAA"}

package/dist/core/execute-rule.d.ts

@@ -9,6 +9,14 @@ import type { EdgeCoverage } from '@nielspeter/eess';
  */
 interface ExecuteRuleContext {
     reason?: string;
+    /**
+     * This rule's own sentence, deferred (bug 0258).
+     *
+     * A thunk rather than a string because `filterContext()` runs on every
+     * terminal call and this is only read when an id-less rule turns out to have
+     * an exclusion comment it cannot honour.
+     */
+    describe?: () => string;
     metadata?: RuleMetadata;
     exclusions?: (string | RegExp)[];
     silentIndices?: Set<number>;

package/dist/core/execute-rule.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"execute-rule.d.ts","sourceRoot":"","sources":["../../src/core/execute-rule.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AAOrD,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAA;AAClE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAA;AAWpD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAA;AAEpD;;;;GAIG;AACH,UAAU,kBAAkB;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,QAAQ,CAAC,EAAE,YAAY,CAAA;IACvB,UAAU,CAAC,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,CAAA;IAChC,aAAa,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAA;CAC5B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,YAAY,CAC1B,UAAU,EAAE,aAAa,EAAE,EAC3B,GAAG,EAAE,kBAAkB,GACtB,aAAa,EAAE,CAgSjB;AAeD;;;;;;;;;;;;GAYG;AACH,wBAAgB,WAAW,CACzB,UAAU,EAAE,aAAa,EAAE,EAC3B,MAAM,CAAC,EAAE,YAAY,EACrB,MAAM,CAAC,EAAE,MAAM;AACf,8EAA8E;AAC9E,QAAQ,GAAE,SAAS,YAAY,EAAO,GACrC,IAAI,CAoBN;AAwBD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,qBAAqB,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAQ/E;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,IAAI,OAAO,CAE1C;AAED,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C;AAED;;GAEG;AACH,wBAAgB,YAAY,CAC1B,UAAU,EAAE,aAAa,EAAE,EAC3B,GAAG,EAAE,kBAAkB,EACvB,OAAO,CAAC,EAAE,YAAY,GACrB,IAAI,CAqCN;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,WAAW,CACzB,UAAU,EAAE,aAAa,EAAE,EAC3B,GAAG,EAAE,kBAAkB,EACvB,OAAO,CAAC,EAAE,YAAY,GACrB,IAAI,CA+DN"}
+{"version":3,"file":"execute-rule.d.ts","sourceRoot":"","sources":["../../src/core/execute-rule.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AAOrD,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAA;AAClE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAA;AAYpD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAA;AAEpD;;;;GAIG;AACH,UAAU,kBAAkB;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAA;IACf;;;;;;OAMG;IACH,QAAQ,CAAC,EAAE,MAAM,MAAM,CAAA;IACvB,QAAQ,CAAC,EAAE,YAAY,CAAA;IACvB,UAAU,CAAC,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,CAAA;IAChC,aAAa,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAA;CAC5B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,YAAY,CAC1B,UAAU,EAAE,aAAa,EAAE,EAC3B,GAAG,EAAE,kBAAkB,GACtB,aAAa,EAAE,CAqXjB;AAeD;;;;;;;;;;;;GAYG;AACH,wBAAgB,WAAW,CACzB,UAAU,EAAE,aAAa,EAAE,EAC3B,MAAM,CAAC,EAAE,YAAY,EACrB,MAAM,CAAC,EAAE,MAAM;AACf,8EAA8E;AAC9E,QAAQ,GAAE,SAAS,YAAY,EAAO,GACrC,IAAI,CAoBN;AAwBD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,qBAAqB,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAQ/E;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,IAAI,OAAO,CAE1C;AAED,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C;AAED;;GAEG;AACH,wBAAgB,YAAY,CAC1B,UAAU,EAAE,aAAa,EAAE,EAC3B,GAAG,EAAE,kBAAkB,EACvB,OAAO,CAAC,EAAE,YAAY,GACrB,IAAI,CAqCN;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,WAAW,CACzB,UAAU,EAAE,aAAa,EAAE,EAC3B,GAAG,EAAE,kBAAkB,EACvB,OAAO,CAAC,EAAE,YAAY,GACrB,IAAI,CA+DN"}

package/dist/core/execute-rule.js

@@ -1,14 +1,14 @@
 import fs from 'node:fs';
-import { severityFor, disambiguateIdentities, byCodepoint, violationsEmittedCount, } from '@nielspeter/eess';
+import { severityFor, disambiguateIdentities, byCodepoint, violationsEmittedCount, } from '@nielspeter/eess/internal';
 import { ArchRuleError } from '@nielspeter/eess';
 import { formatViolations } from '@nielspeter/eess';
 import { formatViolationsJson } from '@nielspeter/eess';
-import { activeNotice } from '@nielspeter/eess';
+import { activeNotice } from '@nielspeter/eess/internal';
 import { formatViolationsGitHub } from '@nielspeter/eess';
 import { parseExclusionComments, isExcludedByComment } from './exclusion-comments.js';
-import { UNSUPPRESSABLE } from '@nielspeter/eess';
-import { recordCommentSuppression } from '@nielspeter/eess';
-import { writeStderr } from '@nielspeter/eess';
+import { UNSUPPRESSABLE } from '@nielspeter/eess/internal';
+import { recordCommentSuppression } from '@nielspeter/eess/internal';
+import { writeStderr } from '@nielspeter/eess/internal';
 /**
  * Complete each violation's identity, then apply `.excluding()` patterns and
  * inline exclusion comments.
@@ -201,8 +201,17 @@ export function applyFilters(violations, ctx) {
             }
         });
     }
-    // Scan source files for inline exclusion comments (when rule has an ID)
-    if (ctx.metadata?.id && result.length > 0) {
+    // Scan source files for inline exclusion comments.
+    //
+    // **Not gated on `ctx.metadata?.id` (bug 0255).** A comment matches by rule
+    // id, so a chain without `.rule({ id })` can never honour one — and while the
+    // scan was gated on the id, the file was not even parsed, so nothing could
+    // say so. This is the second of the two copies: the kernel's got the same
+    // change, and review caught that landing it in one and claiming "eess now
+    // prints…" was a false green for the dialect adopters actually install
+    // (plan 0188 tracks the duplication itself; this is not the commit that
+    // fixes it, but it is not the commit that widens it either).
+    if (result.length > 0) {
         const undocumented = [];
         const filePaths = new Set(result.map((v) => v.file));
         const allComments = [...filePaths].flatMap((filePath) => {
@@ -233,7 +242,10 @@ export function applyFilters(violations, ctx) {
                     // The malformed shapes are different — two of the three decline to
                     // create the exclusion at all, so the original violation still fires
                     // and the build is already red. A line on stderr is right for those.
-                    if (warning.kind === 'undocumented') {
+                    if (warning.kind === 'undocumented' && ctx.metadata?.id !== undefined) {
+                        // The promotion below is keyed on the rule id; without one there is
+                        // nothing to key it on, and the directive is inert anyway — which
+                        // the inert report states, with a remedy. So it falls to stderr.
                         undocumented.push(warning);
                         continue;
                     }
@@ -254,7 +266,8 @@ export function applyFilters(violations, ctx) {
                 return [];
             }
         });
-        if (allComments.length > 0) {
+        const ruleIdForComments = ctx.metadata?.id;
+        if (allComments.length > 0 && ruleIdForComments !== undefined) {
             // `v.bypassFilters` explicitly, not by accident. These findings are
             // immune today only because they carry `file: ''`, which the guard above
             // returns no exclusions for, so `comment.file === ''` can never hold.
@@ -264,6 +277,10 @@ export function applyFilters(violations, ctx) {
             // `// eess-exclude` comments ARE parsed. Without the first clause
             // a comment in a rule file would silence the finding that says the rule
             // enforces nothing. Pinned by tests/helpers/exclusion-comments.ts.
+            // Which comments actually did something, so the ones that did nothing can
+            // be named. Reuses `isExcludedByComment` one comment at a time rather than
+            // re-deriving the match, so it cannot drift from the real rule.
+            const spent = new Set();
             result = result.filter((v) => {
                 if (v.bypassFilters === true)
                     return true;
@@ -272,8 +289,70 @@ export function applyFilters(violations, ctx) {
                 // Disclose it. Silently dropping is what made this the only filter in
                 // the pipeline a reader could not see — see `comment-suppression.ts`.
                 recordCommentSuppression(v.ruleId ?? ctx.metadata?.id ?? '(unnamed rule)', v.file);
+                for (const c of allComments)
+                    if (isExcludedByComment(v, [c]))
+                        spent.add(c);
                 return false;
             });
+            // A directive naming THIS rule that suppressed nothing — the same shape
+            // and weight as the `.excluding()` "Unused exclusion" line above.
+            for (const c of allComments) {
+                if (c.ruleId !== ruleIdForComments || spent.has(c))
+                    continue;
+                writeStderr(`[eess] Exclusion comment for '${ruleIdForComments}' at ${c.file}:${String(c.line)} ` +
+                    `suppressed nothing. It may be stale, or out of reach: a single-line ` +
+                    `directive covers only the NEXT line. eess-exclude-start/-end covers a ` +
+                    `region instead.`);
+            }
+        }
+        else if (allComments.length > 0) {
+            // No rule id, so nothing here can match. It states the fact and names no
+            // id: a directive in this file may belong to another, working rule, and
+            // from inside one rule's run there is no way to tell (review reproduced
+            // the harm of guessing — it produced advice to collide two rules on one
+            // id). One line per file, not per comment.
+            const byFile = new Map();
+            for (const c of allComments) {
+                const lines = byFile.get(c.file);
+                if (lines)
+                    lines.push(c.line);
+                else
+                    byFile.set(c.file, [c.line]);
+            }
+            // Name the rule, preferring its own sentence over its reason (bug 0258).
+            //
+            // The first version used `.because()` alone, on the premise that no rule
+            // description was reachable here. Review measured that false: every
+            // builder implements `describeRule()`, `filterContext()` is a method on
+            // the class that has it, and the kernel already names an id-less rule this
+            // way for its assertion-less finding. `.because()` is optional prose — the
+            // chains this diagnostic targets often have neither an id nor a reason —
+            // so leaning on it alone was a weaker floor for the same cost.
+            //
+            // `'unnamed'` is `TerminalBuilder`'s own fallback for a rule with no id;
+            // naming a rule "unnamed" tells the reader nothing, so it counts as absent
+            // and the reason takes over. Whitespace is collapsed either way: both are
+            // prose that may wrap, and this report is one line per file.
+            // Collapse to one line, and escape the delimiter. A `.because()` reason is
+            // arbitrary prose, so one containing a quoted term rendered as
+            // `("ignore the "legacy" path")` — three quotes before the paren, and no
+            // way for a reader to see where the label ends. Escaping keeps the
+            // author's words exact where replacing them would not.
+            const oneLine = (t) => t.replace(/\s+/g, ' ').trim().replace(/"/g, '\\"');
+            const described = ctx.describe?.();
+            const label = described !== undefined && described !== 'unnamed' && described !== ''
+                ? oneLine(described)
+                : ctx.reason === undefined
+                    ? undefined
+                    : oneLine(ctx.reason);
+            const named = label === undefined || label === '' ? '' : ` ("${label}")`;
+            for (const [file, lines] of byFile) {
+                const where = lines.length === 1 ? `line ${String(lines[0])}` : `lines ${lines.join(', ')}`;
+                writeStderr(`[eess] This rule${named} declares no id, so no exclusion comment can apply to it — ` +
+                    `a comment matches a violation by rule id. ${file} has a directive at ${where}. ` +
+                    `If one was meant for this rule, give the rule an id with .rule({ id: '<your-id>' }); ` +
+                    `directives naming other rules are not this rule's to honour.`);
+            }
         }
         // The exemption stands; what fails is the missing justification. That is
         // deliberate and it is what makes the remedy remediable: add a reason and
@@ -284,16 +363,23 @@ export function applyFilters(violations, ctx) {
         //
         // Unsuppressable, because a suppression mechanism that can suppress the
         // complaint about itself is not a mechanism.
+        //
+        // `undocumented` is only populated when the rule HAS an id (the push above
+        // is guarded on it), so this loop is unreachable without one — the local
+        // re-binding is what tells the compiler that, after bug 0255 removed the
+        // outer `ctx.metadata?.id` gate.
         for (const warning of undocumented) {
+            if (ruleIdForComments === undefined)
+                continue;
             result.push({
-                rule: ctx.metadata.id,
-                ruleId: ctx.metadata.id,
-                element: `${ctx.metadata.id}@${warning.file}:${String(warning.line)}`,
+                rule: ruleIdForComments,
+                ruleId: ruleIdForComments,
+                element: `${ruleIdForComments}@${warning.file}:${String(warning.line)}`,
                 file: warning.file,
                 line: warning.line,
                 message: `This exclusion states no reason, so nothing records why the rule is ` +
                     `waived here — and it is silently suppressing a real finding.`,
-                suggestion: `Add a reason: // eess-exclude ${ctx.metadata.id}: <why>. ` +
+                suggestion: `Add a reason: // eess-exclude ${ruleIdForComments}: <why>. ` +
                     `A reason is prose and nothing verifies it, so this raises the cost of a ` +
                     `suppression rather than preventing one — the audience is the reviewer ` +
                     `reading the diff. If the exemption is not justifiable, delete it and fix ` +