@nielspeter/eess-mermaid 0.3.0 → 0.4.0

package/dist/cli/commands/check.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"check.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/check.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAgB,YAAY,EAAE,MAAM,kBAAkB,CAAA;AAGlE,MAAM,WAAW,SAAS;IACxB,SAAS,EAAE,MAAM,EAAE,CAAA;IACnB,MAAM,EAAE,YAAY,GAAG,MAAM,CAAA;IAC7B,KAAK,CAAC,EAAE,OAAO,CAAA;CAChB;AASD,wBAAsB,QAAQ,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,CAqC/D"}
+{"version":3,"file":"check.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/check.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAA+B,YAAY,EAAE,MAAM,kBAAkB,CAAA;AAIjF,MAAM,WAAW,SAAS;IACxB,SAAS,EAAE,MAAM,EAAE,CAAA;IACnB,MAAM,EAAE,YAAY,GAAG,MAAM,CAAA;IAC7B,KAAK,CAAC,EAAE,OAAO,CAAA;CAChB;AA4ED,wBAAsB,QAAQ,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,CAqG/D"}

package/dist/cli/commands/check.js

@@ -1,4 +1,5 @@
-import { detectFormat } from '@nielspeter/eess';
+import { collectResult, detectFormat, finishPreset, isArchConfigError, reportViolations, } from '@nielspeter/eess';
+import { basename } from 'node:path';
 import { loadRuleFiles } from '../load-rules.js';
 function isArchRuleError(value) {
     if (value === null || typeof value !== 'object')
@@ -7,23 +8,142 @@ function isArchRuleError(value) {
     // because the rule file may load its own copy of the kernel. Match by name.
     return 'name' in value && typeof value.name === 'string' && value.name === 'ArchRuleError';
 }
+/**
+ * A rule file the loader refused — bug 0269.
+ *
+ * Its message is the loader's own, verbatim: that text names the offending entry
+ * by index and says what a builder must be, which is exactly what the reader
+ * needs and is not this function's to paraphrase.
+ */
+function reportRuleFileMisconfigured(file, detail, options) {
+    const violation = {
+        rule: 'rule file: misconfigured',
+        ruleId: 'cli/rule-file-misconfigured',
+        // BASENAME: with the full path here the terminal rendered `<path>:1 — <path>`,
+        // the same string twice on one line. `eess-ts` uses the basename for the
+        // same reason, recorded in its own finding module.
+        element: basename(file),
+        file,
+        line: 1,
+        message: `${basename(file)} could not be loaded, so its rules enforced nothing in this run.`,
+        because: 'a rule file that cannot be loaded enforces nothing, and a silent skip is a green gate over an absent rule',
+        // The loader's own text names the offending entry by index and says what a
+        // builder must be. That IS the fix, so it is the suggestion rather than a
+        // paraphrase of it.
+        suggestion: detail,
+        bypassFilters: true,
+    };
+    reportViolations(collectResult([violation], { examined: 0 }), options);
+}
+/**
+ * A rule file that loaded and contributed no rules — bug 0269.
+ *
+ * `eess-ts` has `ruleFileContributedNoRules` for this; the mermaid dialect had
+ * no equivalent and simply counted zero. Unsuppressable, because a file that
+ * enforces nothing is a configuration fault rather than a finding about a
+ * diagram.
+ */
+function reportContributedNoRules(file, options) {
+    const violation = {
+        rule: 'rule file: contributed no rules',
+        ruleId: 'cli/rule-file-contributed-no-rules',
+        element: basename(file),
+        file,
+        line: 1,
+        message: `${basename(file)} loaded but contributed no rules, so this run enforced nothing from it.`,
+        because: 'a rule file that contributes no rules cannot fail, and a gate that cannot fail is worth less than no gate',
+        // `message` says what happened, `because` why it matters, `suggestion` what
+        // to do — the split `eess-ts` uses and `CLAUDE.md` promises ("every violation
+        // surfaces its rationale, a `Fix:` line, and a `Docs:` link where present").
+        // The first cut put the whole remedy in `message` and left `suggestion`
+        // unset, so the terminal printed no `Fix:` and a JSON consumer keying on
+        // `suggestion` got null.
+        suggestion: 'Export the builders you meant to check: `export default [ …builders ]`, or a ' +
+            'function returning that array. A single un-arrayed builder is not accepted. ' +
+            'If the file is deliberately empty, delete it rather than leaving a rule file ' +
+            'that enforces nothing.',
+        bypassFilters: true,
+    };
+    // No try/catch: `reportViolations` escalates to a throw only for the emitter's
+    // own ids (ADR-014 §5), and this is not one of them. Swallowing a throw here
+    // would hide a real defect, and the repo's own `every discarded error carries a
+    // written reason` rule is right to refuse it.
+    reportViolations(collectResult([violation], { examined: 0 }), options);
+}
 export async function runCheck(args) {
     const started = Date.now();
     const format = args.format === 'auto' ? detectFormat() : args.format;
     const options = { format };
     const loadOptions = { fresh: args.fresh };
-    const builders = await loadRuleFiles(args.ruleFiles, loadOptions);
+    // **Per rule file, and through the receipt** — bug 0269. This loop used to
+    // call `builder.check(options)` and count the throws, which never looks at
+    // what the rule examined: a hand-rolled `{ check: () => {} }` was a counted
+    // rule and a green tick. It now reads `violations()` — the receipt every
+    // builder already carries — and hands it to the kernel's gate, which is the
+    // wiring `eess-ts` gained in plan 0263 Phase 2.
+    //
+    // Per file rather than over one flat array, so the finding can name the rule
+    // file it came from. An emitter finding carries `file: ''` by construction (the
+    // fault is the verdict, not a place in anyone's code), and "which rule file"
+    // is the first thing the reader needs — bug 0026's seam, in the dialect that
+    // had not learned it yet.
+    // Rules that failed, and findings about a rule FILE, counted apart. A
+    // file-level finding is not a failing rule, and folding them together printed
+    // `1 of 0 rules failing` — the same nonsense `eess-ts` printed as `2 of 1 rule
+    // failing` when it double-counted, caught there in review.
     let failures = 0;
-    for (const builder of builders) {
+    let fileFindings = 0;
+    let ruleCount = 0;
+    for (const file of args.ruleFiles) {
+        let builders;
         try {
-            builder.check(options);
+            builders = await loadRuleFiles([file], loadOptions);
         }
         catch (error) {
-            if (isArchRuleError(error)) {
-                failures++;
-            }
-            else {
+            // A misconfigured rule file is a FINDING, not a stack trace. The loader
+            // now rejects a non-builder loudly (it used to drop it silently, turning a
+            // rule that ran and failed into a green run), and without this catch that
+            // loudness reached the adopter as an uncaught `ArchConfigError` with a
+            // Node stack frame — and abandoned every remaining rule file. `eess-ts`
+            // reports the same class as `ruleFileMisconfigured`; this is its
+            // counterpart.
+            if (!isArchConfigError(error))
                 throw error;
+            fileFindings++;
+            reportRuleFileMisconfigured(file, error.message, options);
+            continue;
+        }
+        // A rule file that loads cleanly and contributes nothing enforces nothing.
+        // Measured before this: `export default []` printed
+        // `✓ eess-mermaid — 0 rules across 1 file · 0 failing` and exited 0 — the
+        // zero denominator under a tick that `CLAUDE.md` calls a red flag.
+        if (builders.length === 0) {
+            fileFindings++;
+            reportContributedNoRules(file, options);
+            continue;
+        }
+        ruleCount += builders.length;
+        for (const builder of builders) {
+            const receipt = builder.violations();
+            const gated = finishPreset(receipt, { report: 'return' });
+            if (gated.length === 0)
+                continue;
+            failures++;
+            const attributed = gated.map((v) => v.file === '' ? { ...v, file, line: v.line === 0 ? 1 : v.line } : v);
+            try {
+                // `gated.examined`, not `receipt.examined`. A bare array has no
+                // `examined` at all, so re-wrapping with the RAW receipt's value hands
+                // `reportViolations` a receipt that claims no evidence — and its gate
+                // appends a SECOND `emitter/no-receipt`, printing the same finding twice.
+                // Measured: `[1 of 2]` and `[2 of 2]`, one attributed and one not. The
+                // gated receipt already carries the corrected count.
+                reportViolations(collectResult(attributed, { examined: gated.examined }), options);
+            }
+            catch (error) {
+                // The gate's own finding escalates to a throw inside `reportViolations`
+                // (ADR-014 §5). It is already counted and already printed.
+                if (!isArchRuleError(error))
+                    throw error;
             }
         }
     }
@@ -32,13 +152,21 @@ export async function runCheck(args) {
     if (format === 'terminal') {
         const ms = Date.now() - started;
         const time = ms < 1000 ? `${ms}ms` : `${(ms / 1000).toFixed(2)}s`;
-        const rules = builders.length;
+        const rules = ruleCount;
         const files = args.ruleFiles.length;
         const scope = `${rules} rule${rules === 1 ? '' : 's'} across ${files} file${files === 1 ? '' : 's'}`;
-        process.stderr.write(failures === 0
-            ? `\n✓ eess-mermaid — ${scope} · 0 failing (${time})\n`
-            : `\n✗ eess-mermaid — ${failures} of ${scope} failing (${time})\n`);
+        const fileNote = fileFindings === 0
+            ? ''
+            : ` · ${fileFindings} rule-file finding${fileFindings === 1 ? '' : 's'}`;
+        // "0 of 0 rules failing" is noise: when nothing loaded, the finding IS the
+        // denominator, so say that instead of dressing a zero as a ratio.
+        const line = failures === 0 && fileFindings === 0
+            ? `✓ eess-mermaid — ${scope} · 0 failing (${time})`
+            : rules === 0
+                ? `✗ eess-mermaid — ${scope}${fileNote} (${time})`
+                : `✗ eess-mermaid — ${failures} of ${scope} failing${fileNote} (${time})`;
+        process.stderr.write(`\n${line}\n`);
     }
-    return failures;
+    return failures + fileFindings;
 }
 //# sourceMappingURL=check.js.map

package/dist/cli/commands/check.js.map

@@ -1 +1 @@
-{"version":3,"file":"check.js","sourceRoot":"","sources":["../../../src/cli/commands/check.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAA;AAE/C,OAAO,EAAE,aAAa,EAA0C,MAAM,kBAAkB,CAAA;AAQxF,SAAS,eAAe,CAAC,KAAc;IACrC,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAA;IAC7D,+EAA+E;IAC/E,4EAA4E;IAC5E,OAAO,MAAM,IAAI,KAAK,IAAI,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,KAAK,eAAe,CAAA;AAC5F,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,IAAe;IAC5C,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;IAC1B,MAAM,MAAM,GAAiB,IAAI,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAA;IAClF,MAAM,OAAO,GAAiB,EAAE,MAAM,EAAE,CAAA;IAExC,MAAM,WAAW,GAAgB,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAA;IACtD,MAAM,QAAQ,GAAsB,MAAM,aAAa,CAAC,IAAI,CAAC,SAAS,EAAE,WAAW,CAAC,CAAA;IAEpF,IAAI,QAAQ,GAAG,CAAC,CAAA;IAChB,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,IAAI,CAAC;YACH,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAA;QACxB,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACxB,IAAI,eAAe,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC3B,QAAQ,EAAE,CAAA;YACZ,CAAC;iBAAM,CAAC;gBACN,MAAM,KAAK,CAAA;YACb,CAAC;QACH,CAAC;IACH,CAAC;IAED,+EAA+E;IAC/E,+EAA+E;IAC/E,IAAI,MAAM,KAAK,UAAU,EAAE,CAAC;QAC1B,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO,CAAA;QAC/B,MAAM,IAAI,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAA;QACjE,MAAM,KAAK,GAAG,QAAQ,CAAC,MAAM,CAAA;QAC7B,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAA;QACnC,MAAM,KAAK,GAAG,GAAG,KAAK,QAAQ,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,WAAW,KAAK,QAAQ,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,EAAE,CAAA;QACpG,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,QAAQ,KAAK,CAAC;YACZ,CAAC,CAAC,sBAAsB,KAAK,iBAAiB,IAAI,KAAK;YACvD,CAAC,CAAC,sBAAsB,QAAQ,OAAO,KAAK,aAAa,IAAI,KAAK,CACrE,CAAA;IACH,CAAC;IAED,OAAO,QAAQ,CAAA;AACjB,CAAC"}
+{"version":3,"file":"check.js","sourceRoot":"","sources":["../../../src/cli/commands/check.ts"],"names":[],"mappings":"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"}

package/dist/cli/commands/explain.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"explain.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/explain.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,MAAM,EAAE,CAAA;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB;AAcD,wBAAsB,UAAU,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAcjE"}
+{"version":3,"file":"explain.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/explain.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,MAAM,EAAE,CAAA;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB;AAcD,wBAAsB,UAAU,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAmBjE"}

package/dist/cli/commands/explain.js

@@ -1,3 +1,4 @@
+import { isDescribable } from '@nielspeter/eess/internal';
 import { loadRuleFiles } from '../load-rules.js';
 function isRuleDescription(value) {
     return value !== null && typeof value === 'object';
@@ -6,7 +7,12 @@ export async function runExplain(args) {
     const builders = await loadRuleFiles(args.ruleFiles);
     const rules = [];
     for (const builder of builders) {
-        if (typeof builder.describeRule !== 'function')
+        // `isDescribable` from the kernel, not a `describeRule` member on the
+        // dialect's own builder type — bug 0269's review. The local
+        // `RuleBuilderLike` copy carried `describeRule?` solely for this loop, and
+        // keeping the copy is what made ADR-014's Tier-1 mechanism untrue of this
+        // dialect. `eess-ts`'s `explain` already reads it this way.
+        if (!isDescribable(builder))
             continue;
         const desc = builder.describeRule();
         if (isRuleDescription(desc))

package/dist/cli/commands/explain.js.map

@@ -1 +1 @@
-{"version":3,"file":"explain.js","sourceRoot":"","sources":["../../../src/cli/commands/explain.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AAehD,SAAS,iBAAiB,CAAC,KAAc;IACvC,OAAO,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,CAAA;AACpD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,IAAiB;IAChD,MAAM,QAAQ,GAAG,MAAM,aAAa,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;IACpD,MAAM,KAAK,GAA0B,EAAE,CAAA;IACvC,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,IAAI,OAAO,OAAO,CAAC,YAAY,KAAK,UAAU;YAAE,SAAQ;QACxD,MAAM,IAAI,GAAG,OAAO,CAAC,YAAY,EAAE,CAAA;QACnC,IAAI,iBAAiB,CAAC,IAAI,CAAC;YAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IAC/C,CAAC;IAED,IAAI,IAAI,CAAC,QAAQ,KAAK,IAAI,EAAE,CAAC;QAC3B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC,CAAA;IAC7C,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAA;IACjE,CAAC;AACH,CAAC;AAED,SAAS,cAAc,CAAC,KAA4B;IAClD,MAAM,MAAM,GAAG,2DAA2D,CAAA;IAC1E,MAAM,IAAI,GAAG,KAAK;SACf,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC,IAAI,IAAI,EAAE,MAAM,CAAC,CAAC,OAAO,IAAI,EAAE,MAAM,CAAC,CAAC,UAAU,IAAI,EAAE,IAAI,CAAC;SAC9F,IAAI,CAAC,IAAI,CAAC,CAAA;IACb,OAAO,MAAM,GAAG,IAAI,GAAG,IAAI,CAAA;AAC7B,CAAC"}
+{"version":3,"file":"explain.js","sourceRoot":"","sources":["../../../src/cli/commands/explain.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAA;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AAehD,SAAS,iBAAiB,CAAC,KAAc;IACvC,OAAO,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,CAAA;AACpD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,IAAiB;IAChD,MAAM,QAAQ,GAAG,MAAM,aAAa,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;IACpD,MAAM,KAAK,GAA0B,EAAE,CAAA;IACvC,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,sEAAsE;QACtE,4DAA4D;QAC5D,2EAA2E;QAC3E,0EAA0E;QAC1E,4DAA4D;QAC5D,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC;YAAE,SAAQ;QACrC,MAAM,IAAI,GAAG,OAAO,CAAC,YAAY,EAAE,CAAA;QACnC,IAAI,iBAAiB,CAAC,IAAI,CAAC;YAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IAC/C,CAAC;IAED,IAAI,IAAI,CAAC,QAAQ,KAAK,IAAI,EAAE,CAAC;QAC3B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC,CAAA;IAC7C,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAA;IACjE,CAAC;AACH,CAAC;AAED,SAAS,cAAc,CAAC,KAA4B;IAClD,MAAM,MAAM,GAAG,2DAA2D,CAAA;IAC1E,MAAM,IAAI,GAAG,KAAK;SACf,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC,IAAI,IAAI,EAAE,MAAM,CAAC,CAAC,OAAO,IAAI,EAAE,MAAM,CAAC,CAAC,UAAU,IAAI,EAAE,IAAI,CAAC;SAC9F,IAAI,CAAC,IAAI,CAAC,CAAA;IACb,OAAO,MAAM,GAAG,IAAI,GAAG,IAAI,CAAA;AAC7B,CAAC"}

package/dist/cli/import-config.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Load a config or rule module — natively when Node can, via jiti when it cannot.
+ *
+ * **This closes a live bug, not just a duplication.** `resolve-config.ts` used a
+ * bare `await import()`, and `CONFIG_FILENAMES` lists `.ts` files — so an
+ * `eess-mermaid.config.ts` in a `"type": "commonjs"` project (what `npm init -y`
+ * writes) was refused by Node and the config silently did not load. `eess-ts`
+ * has handled that since bug 0074; this package had `jiti` as a dependency the
+ * whole time and never used it.
+ *
+ * Native first, and that ordering is the design: a module loaded through jiti
+ * gets jiti's own registry, so the copy of the kernel it imports is a different
+ * instance from the CLI's. `isModuleFormatRefusal` keeps the fallback narrow —
+ * a broad catch would re-execute a file that had already run.
+ */
+export declare function importConfigModule(file: string): Promise<unknown>;
+//# sourceMappingURL=import-config.d.ts.map

package/dist/cli/import-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"import-config.d.ts","sourceRoot":"","sources":["../../src/cli/import-config.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAOvE"}

package/dist/cli/import-config.js

@@ -0,0 +1,28 @@
+import { createJiti } from 'jiti';
+import { isModuleFormatRefusal } from '@nielspeter/eess/internal';
+/**
+ * Load a config or rule module — natively when Node can, via jiti when it cannot.
+ *
+ * **This closes a live bug, not just a duplication.** `resolve-config.ts` used a
+ * bare `await import()`, and `CONFIG_FILENAMES` lists `.ts` files — so an
+ * `eess-mermaid.config.ts` in a `"type": "commonjs"` project (what `npm init -y`
+ * writes) was refused by Node and the config silently did not load. `eess-ts`
+ * has handled that since bug 0074; this package had `jiti` as a dependency the
+ * whole time and never used it.
+ *
+ * Native first, and that ordering is the design: a module loaded through jiti
+ * gets jiti's own registry, so the copy of the kernel it imports is a different
+ * instance from the CLI's. `isModuleFormatRefusal` keeps the fallback narrow —
+ * a broad catch would re-execute a file that had already run.
+ */
+export async function importConfigModule(file) {
+    try {
+        return await import(file);
+    }
+    catch (error) {
+        if (!isModuleFormatRefusal(error))
+            throw error;
+        return createJiti(import.meta.url).import(file);
+    }
+}
+//# sourceMappingURL=import-config.js.map

package/dist/cli/import-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"import-config.js","sourceRoot":"","sources":["../../src/cli/import-config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,MAAM,CAAA;AACjC,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAA;AAEjE;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,IAAY;IACnD,IAAI,CAAC;QACH,OAAO,MAAM,MAAM,CAAC,IAAI,CAAC,CAAA;IAC3B,CAAC;IAAC,OAAO,KAAc,EAAE,CAAC;QACxB,IAAI,CAAC,qBAAqB,CAAC,KAAK,CAAC;YAAE,MAAM,KAAK,CAAA;QAC9C,OAAO,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;IACjD,CAAC;AACH,CAAC"}

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":"AAmHA,wBAAsB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CA+CvD"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":"AA2GA,wBAAsB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CA+CvD"}

package/dist/cli/index.js

@@ -1,3 +1,4 @@
+import { requireRuleFiles } from '@nielspeter/eess/internal';
 import { parseArgs } from 'node:util';
 import { readFileSync } from 'node:fs';
 import { fileURLToPath } from 'node:url';
@@ -47,15 +48,8 @@ function parseCliArgs(args) {
         strict: true,
     });
 }
-function requireRuleFiles(ruleFiles) {
-    if (ruleFiles.length > 0)
-        return true;
-    console.error('Error: No rule files specified. Pass rule files as arguments or set them in eess-mermaid.config.ts.');
-    process.exitCode = 1;
-    return false;
-}
 async function handleCheck(ruleFiles, values, config, format) {
-    if (!requireRuleFiles(ruleFiles))
+    if (!requireRuleFiles(ruleFiles, 'eess-mermaid.config.ts'))
         return;
     if (values.watch === true) {
         const watchDirs = config.watchDirs ?? ['src'];
@@ -80,7 +74,7 @@ async function handleCheck(ruleFiles, values, config, format) {
     }
 }
 async function handleExplain(ruleFiles, markdown) {
-    if (!requireRuleFiles(ruleFiles))
+    if (!requireRuleFiles(ruleFiles, 'eess-mermaid.config.ts'))
         return;
     const explainArgs = { ruleFiles, markdown };
     await runExplain(explainArgs);

package/dist/cli/index.js.map

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

package/dist/cli/load-rules.d.ts

@@ -1,8 +1,27 @@
-import type { CheckOptions } from '@nielspeter/eess';
-export interface RuleBuilderLike {
-    check: (opts?: CheckOptions) => void;
-    describeRule?: () => unknown;
-}
+import type { RuleBuilderLike } from '@nielspeter/eess';
+/**
+ * **The kernel's shape, re-exported rather than re-declared** — bug 0269's
+ * review.
+ *
+ * This dialect kept a local copy, and the first cut of the fix edited that copy
+ * to require `violations`. That left ADR-014's Tier-1 mechanism
+ * ("`RuleBuilderLike`'s single member; `npm run typecheck` across all six
+ * packages") untrue of the dialect the ADR had just named, because the type this
+ * package typechecks against was its own three-member one.
+ *
+ * The receipt is what the CLI now keys on: the loader used to accept anything
+ * with a `check` method, which any hand-rolled object satisfies, so
+ * `export default [{ check: () => {} }]` was counted as a rule and the run
+ * printed `✓ eess-mermaid — 1 rule across 1 file · 0 failing`. Every real
+ * builder already had the receipt — `ClassRuleBuilder` extends the kernel's
+ * `TerminalBuilder` — which is why this was a wiring fix and not the
+ * dialect-wide contract change the bug record first supposed.
+ *
+ * `describeRule` was the only reason for a local shape; `isDescribable` in
+ * `@nielspeter/eess/internal` answers it, which is what `eess-ts`'s `explain`
+ * already uses.
+ */
+export type { RuleBuilderLike } from '@nielspeter/eess';
 export interface LoadOptions {
     fresh?: boolean;
 }

package/dist/cli/load-rules.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"load-rules.d.ts","sourceRoot":"","sources":["../../src/cli/load-rules.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAA;AAEpD,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,CAAC,IAAI,CAAC,EAAE,YAAY,KAAK,IAAI,CAAA;IACpC,YAAY,CAAC,EAAE,MAAM,OAAO,CAAA;CAC7B;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,CAAC,EAAE,OAAO,CAAA;CAChB;AAUD,wBAAsB,aAAa,CACjC,KAAK,EAAE,MAAM,EAAE,EACf,OAAO,CAAC,EAAE,WAAW,GACpB,OAAO,CAAC,eAAe,EAAE,CAAC,CAkB5B"}
+{"version":3,"file":"load-rules.d.ts","sourceRoot":"","sources":["../../src/cli/load-rules.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AAEvD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,YAAY,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AAEvD,MAAM,WAAW,WAAW;IAC1B,KAAK,CAAC,EAAE,OAAO,CAAA;CAChB;AAUD,wBAAsB,aAAa,CACjC,KAAK,EAAE,MAAM,EAAE,EACf,OAAO,CAAC,EAAE,WAAW,GACpB,OAAO,CAAC,eAAe,EAAE,CAAC,CAmC5B"}

package/dist/cli/load-rules.js

@@ -1,5 +1,6 @@
 import path from 'node:path';
 import { createJiti } from 'jiti';
+import { ArchConfigError } from '@nielspeter/eess';
 let cachedJiti;
 function getJiti(fresh) {
     if (fresh)
@@ -15,12 +16,26 @@ export async function loadRuleFiles(files, options) {
         const resolved = path.resolve(file);
         const mod = await jiti.import(resolved);
         const exported = extractDefault(mod);
-        const items = resolveExported(exported);
-        for (const item of items) {
-            if (isRuleBuilderLike(item)) {
-                builders.push(item);
+        const items = resolveExported(exported, resolved);
+        // A non-builder in the default-export array is a LOUD ERROR, never a silent
+        // skip — the rule `eess-ts`'s loader states and this one did not have.
+        //
+        // Measured on the branch that tightened the guard without porting the
+        // loudness: a rule file holding one real builder and one hand-rolled
+        // `{ check() { throw … } }` went from **exit 1** (the hand-rolled rule ran
+        // and threw) to `✓ eess-mermaid — 1 rule across 1 file · 0 failing`, exit 0.
+        // A rule that ran and failed simply stopped existing, under a denominator
+        // that still said one rule was there. A silently-dropped rule is a
+        // green-but-empty gate, which is the defect this tool exists to forbid.
+        items.forEach((item, index) => {
+            if (!isRuleBuilderLike(item)) {
+                throw new ArchConfigError('loadRuleFiles', `Rule file "${resolved}": default export entry [${index}] is not a rule builder ` +
+                    `(got ${describeValue(item)}). Every entry must be a builder that can report what ` +
+                    `it examined — e.g. \`classes(diagram(…)).should()…\`. An object with only a ` +
+                    `\`check()\` method cannot say what it examined, so it cannot be gated.`);
             }
-        }
+            builders.push(item);
+        });
     }
     return builders;
 }
@@ -28,7 +43,7 @@ export async function loadRuleFiles(files, options) {
  * Resolve the exported value to an array of unknowns.
  * Supports: direct arrays, or factory functions returning arrays.
  */
-function resolveExported(exported) {
+function resolveExported(exported, file) {
     if (Array.isArray(exported)) {
         return exported;
     }
@@ -40,7 +55,20 @@ function resolveExported(exported) {
             return result;
         }
     }
-    return [];
+    // Loud, for the same reason as the entry check above: a default export of the
+    // wrong shape used to make the file contribute zero rules silently.
+    throw new ArchConfigError('loadRuleFiles', `Rule file "${file}": default export must be an array of rule builders, or a ` +
+        `function returning one (got ${describeValue(exported)}). Add ` +
+        '`export default [ …builders ]`.');
+}
+function describeValue(value) {
+    if (value === null)
+        return 'null';
+    if (value === undefined)
+        return 'undefined';
+    if (Array.isArray(value))
+        return 'an array';
+    return typeof value;
 }
 function extractDefault(mod) {
     if (mod === null || mod === undefined || typeof mod !== 'object') {
@@ -56,7 +84,9 @@ function isRuleBuilderLike(value) {
     if (value === null || value === undefined || typeof value !== 'object') {
         return false;
     }
-    // Structural type check: must have a 'check' method
-    return 'check' in value && typeof value.check === 'function';
+    // Structural, and keyed on the RECEIPT rather than on `check` — bug 0269. A
+    // builder that cannot say what it examined cannot be gated, and counting it as
+    // a rule is how a hand-rolled no-op earned a green tick and a denominator.
+    return 'violations' in value && typeof value.violations === 'function';
 }
 //# sourceMappingURL=load-rules.js.map

package/dist/cli/load-rules.js.map

@@ -1 +1 @@
-{"version":3,"file":"load-rules.js","sourceRoot":"","sources":["../../src/cli/load-rules.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAA;AAC5B,OAAO,EAAE,UAAU,EAAE,MAAM,MAAM,CAAA;AAYjC,IAAI,UAAqD,CAAA;AAEzD,SAAS,OAAO,CAAC,KAAc;IAC7B,IAAI,KAAK;QAAE,OAAO,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC,CAAA;IACrF,IAAI,CAAC,UAAU;QAAE,UAAU,GAAG,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;IACzD,OAAO,UAAU,CAAA;AACnB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,KAAe,EACf,OAAqB;IAErB,MAAM,QAAQ,GAAsB,EAAE,CAAA;IACtC,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,EAAE,KAAK,KAAK,IAAI,CAAC,CAAA;IAE7C,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;QACnC,MAAM,GAAG,GAAY,MAAM,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAA;QAEhD,MAAM,QAAQ,GAAG,cAAc,CAAC,GAAG,CAAC,CAAA;QACpC,MAAM,KAAK,GAAG,eAAe,CAAC,QAAQ,CAAC,CAAA;QACvC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,IAAI,iBAAiB,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC5B,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;YACrB,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,QAAQ,CAAA;AACjB,CAAC;AAED;;;GAGG;AACH,SAAS,eAAe,CAAC,QAAiB;IACxC,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC5B,OAAO,QAAQ,CAAA;IACjB,CAAC;IACD,IAAI,OAAO,QAAQ,KAAK,UAAU,EAAE,CAAC;QACnC,gFAAgF;QAChF,6EAA6E;QAC7E,MAAM,MAAM,GAAY,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;QAChD,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YAC1B,OAAO,MAAM,CAAA;QACf,CAAC;IACH,CAAC;IACD,OAAO,EAAE,CAAA;AACX,CAAC;AAED,SAAS,cAAc,CAAC,GAAY;IAClC,IAAI,GAAG,KAAK,IAAI,IAAI,GAAG,KAAK,SAAS,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;QACjE,OAAO,SAAS,CAAA;IAClB,CAAC;IACD,yEAAyE;IACzE,IAAI,SAAS,IAAI,GAAG,EAAE,CAAC;QACrB,OAAO,GAAG,CAAC,OAAO,CAAA;IACpB,CAAC;IACD,OAAO,SAAS,CAAA;AAClB,CAAC;AAED,SAAS,iBAAiB,CAAC,KAAc;IACvC,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACvE,OAAO,KAAK,CAAA;IACd,CAAC;IACD,oDAAoD;IACpD,OAAO,OAAO,IAAI,KAAK,IAAI,OAAO,KAAK,CAAC,KAAK,KAAK,UAAU,CAAA;AAC9D,CAAC"}
+{"version":3,"file":"load-rules.js","sourceRoot":"","sources":["../../src/cli/load-rules.ts"],"names":[],"mappings":"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"}

package/dist/cli/resolve-config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resolve-config.d.ts","sourceRoot":"","sources":["../../src/cli/resolve-config.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAS5C,wBAAsB,aAAa,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,CAM7E"}
+{"version":3,"file":"resolve-config.d.ts","sourceRoot":"","sources":["../../src/cli/resolve-config.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAgB5C,wBAAsB,aAAa,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,CAK7E"}

package/dist/cli/resolve-config.js

@@ -1,5 +1,13 @@
 import path from 'node:path';
-import fs from 'node:fs';
+import { findConfigFile, extractSharedConfig } from '@nielspeter/eess/internal';
+import { importConfigModule } from './import-config.js';
+/**
+ * Resolve CLI configuration from an explicit path or by searching for one.
+ *
+ * Finding the file and validating the loaded module are the kernel's — they were
+ * duplicated with `eess-ts` (`findConfigFile` scored 100%). What is this
+ * dialect's is which filenames to look for.
+ */
 const CONFIG_FILENAMES = [
     'eess-mermaid.config.ts',
     'eess-mermaid.config.js',
@@ -7,44 +15,10 @@ const CONFIG_FILENAMES = [
     'mermaidunit.config.js',
 ];
 export async function resolveConfig(explicitPath) {
-    const configPath = explicitPath ?? findConfigFile();
+    const configPath = explicitPath ?? findConfigFile(CONFIG_FILENAMES);
     if (configPath === undefined)
         return {};
-    const mod = await import(path.resolve(configPath));
-    return extractDefault(mod);
-}
-function findConfigFile() {
-    const cwd = process.cwd();
-    for (const name of CONFIG_FILENAMES) {
-        const candidate = path.join(cwd, name);
-        if (fs.existsSync(candidate))
-            return candidate;
-    }
-    return undefined;
-}
-function isRecord(value) {
-    return value !== null && typeof value === 'object';
-}
-function extractDefault(mod) {
-    if (!isRecord(mod))
-        return {};
-    if (!('default' in mod))
-        return {};
-    const defaultExport = mod.default;
-    if (!isRecord(defaultExport))
-        return {};
-    const obj = defaultExport;
-    const config = {};
-    const format = obj['format'];
-    if (format === 'terminal' || format === 'json' || format === 'github' || format === 'auto') {
-        config.format = format;
-    }
-    if (Array.isArray(obj['rules'])) {
-        config.rules = obj['rules'].filter((r) => typeof r === 'string');
-    }
-    if (Array.isArray(obj['watchDirs'])) {
-        config.watchDirs = obj['watchDirs'].filter((r) => typeof r === 'string');
-    }
-    return config;
+    const mod = await importConfigModule(path.resolve(configPath));
+    return extractSharedConfig(mod);
 }
 //# sourceMappingURL=resolve-config.js.map

package/dist/cli/resolve-config.js.map

@@ -1 +1 @@
-{"version":3,"file":"resolve-config.js","sourceRoot":"","sources":["../../src/cli/resolve-config.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAA;AAC5B,OAAO,EAAE,MAAM,SAAS,CAAA;AAGxB,MAAM,gBAAgB,GAAG;IACvB,wBAAwB;IACxB,wBAAwB;IACxB,uBAAuB;IACvB,uBAAuB;CACxB,CAAA;AAED,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,YAAqB;IACvD,MAAM,UAAU,GAAG,YAAY,IAAI,cAAc,EAAE,CAAA;IACnD,IAAI,UAAU,KAAK,SAAS;QAAE,OAAO,EAAE,CAAA;IAEvC,MAAM,GAAG,GAAY,MAAM,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAA;IAC3D,OAAO,cAAc,CAAC,GAAG,CAAC,CAAA;AAC5B,CAAC;AAED,SAAS,cAAc;IACrB,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE,CAAA;IACzB,KAAK,MAAM,IAAI,IAAI,gBAAgB,EAAE,CAAC;QACpC,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAA;QACtC,IAAI,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC;YAAE,OAAO,SAAS,CAAA;IAChD,CAAC;IACD,OAAO,SAAS,CAAA;AAClB,CAAC;AAED,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,CAAA;AACpD,CAAC;AAED,SAAS,cAAc,CAAC,GAAY;IAClC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC;QAAE,OAAO,EAAE,CAAA;IAC7B,IAAI,CAAC,CAAC,SAAS,IAAI,GAAG,CAAC;QAAE,OAAO,EAAE,CAAA;IAClC,MAAM,aAAa,GAAG,GAAG,CAAC,OAAO,CAAA;IACjC,IAAI,CAAC,QAAQ,CAAC,aAAa,CAAC;QAAE,OAAO,EAAE,CAAA;IACvC,MAAM,GAAG,GAAG,aAAa,CAAA;IACzB,MAAM,MAAM,GAAc,EAAE,CAAA;IAC5B,MAAM,MAAM,GAAG,GAAG,CAAC,QAAQ,CAAC,CAAA;IAC5B,IAAI,MAAM,KAAK,UAAU,IAAI,MAAM,KAAK,MAAM,IAAI,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,MAAM,EAAE,CAAC;QAC3F,MAAM,CAAC,MAAM,GAAG,MAAM,CAAA;IACxB,CAAC;IACD,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC;QAChC,MAAM,CAAC,KAAK,GAAG,GAAG,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAe,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAA;IAC/E,CAAC;IACD,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,EAAE,CAAC;QACpC,MAAM,CAAC,SAAS,GAAG,GAAG,CAAC,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAe,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAA;IACvF,CAAC;IACD,OAAO,MAAM,CAAA;AACf,CAAC"}
+{"version":3,"file":"resolve-config.js","sourceRoot":"","sources":["../../src/cli/resolve-config.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAA;AAC5B,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAA;AAC/E,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAA;AAGvD;;;;;;GAMG;AACH,MAAM,gBAAgB,GAAG;IACvB,wBAAwB;IACxB,wBAAwB;IACxB,uBAAuB;IACvB,uBAAuB;CACxB,CAAA;AAED,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,YAAqB;IACvD,MAAM,UAAU,GAAG,YAAY,IAAI,cAAc,CAAC,gBAAgB,CAAC,CAAA;IACnE,IAAI,UAAU,KAAK,SAAS;QAAE,OAAO,EAAE,CAAA;IACvC,MAAM,GAAG,GAAY,MAAM,kBAAkB,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAA;IACvE,OAAO,mBAAmB,CAAC,GAAG,CAAC,CAAA;AACjC,CAAC"}

package/dist/cli/watch.d.ts

@@ -1,3 +1,11 @@
+/**
+ * Watch mode for `eess-mermaid`.
+ *
+ * The scheduling and the watch loop live in the kernel — they were duplicated
+ * with `eess-ts` and the copies drifted, one of them keeping an `instanceof`
+ * check the other had already replaced (see `@nielspeter/eess`'s `watch.ts`).
+ * What is dialect-specific is only which filenames count as a change.
+ */
 export interface WatchOptions {
     watchDirs: string[];
     watchFiles: string[];

package/dist/cli/watch.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"watch.d.ts","sourceRoot":"","sources":["../../src/cli/watch.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,MAAM,EAAE,CAAA;IACnB,UAAU,EAAE,MAAM,EAAE,CAAA;IACpB,gBAAgB,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;IACrC,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAkED,wBAAgB,aAAa,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI,CAoDzD"}
+{"version":3,"file":"watch.d.ts","sourceRoot":"","sources":["../../src/cli/watch.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AACH,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,MAAM,EAAE,CAAA;IACnB,UAAU,EAAE,MAAM,EAAE,CAAA;IACpB,gBAAgB,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;IACrC,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAKD,wBAAgB,aAAa,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI,CAEzD"}