gurkencheck 0.0.6 → 0.0.9

package/dist/rules/no-dupe-file-names.js

@@ -1,27 +1,42 @@
 import path from 'node:path';
 const name = 'no-dupe-file-names';
-/**
- * Two feature files with the same name in different folders are easy to
- * confuse, and tools that write one report per feature - naming it after the
- * file - quietly overwrite one with the other.
- */
-/** File name without its extension -> the paths it has already been seen at. */
-const seen = new Map();
 const rule = {
     name,
-    reset() {
-        seen.clear();
-    },
-    run(_feature, file) {
+    run(_feature, file, _configuration, context) {
+        const seen = context.state(() => new Map());
         const fileName = path.basename(file.relativePath, path.extname(file.relativePath));
-        const previous = seen.get(fileName);
-        if (previous === undefined) {
+        const paths = seen.get(fileName);
+        if (paths === undefined) {
             seen.set(fileName, [file.relativePath]);
-            return [];
         }
-        const message = `File name is already used in: ${previous.join(', ')}`;
-        previous.push(file.relativePath);
-        return [{ message, rule: name, line: 0 }];
+        else if (!paths.includes(file.relativePath)) {
+            // A file handed to the linter twice is the caller repeating itself, not
+            // two files sharing a name.
+            paths.push(file.relativePath);
+        }
+        return [];
+    },
+    onRunEnd(_configuration, context) {
+        const seen = context.state(() => new Map());
+        const findings = [];
+        for (const paths of seen.values()) {
+            if (paths.length < 2) {
+                continue;
+            }
+            // Every file involved hears about every other. Which of them was read
+            // first is an accident of the order the files came in, so blaming that
+            // one alone says more about the run than about the files.
+            for (const filePath of paths) {
+                const others = paths.filter((other) => other !== filePath);
+                findings.push({
+                    message: `File name is also used in: ${others.join(', ')}`,
+                    rule: name,
+                    line: 0,
+                    filePath,
+                });
+            }
+        }
+        return findings;
     },
 };
 export default rule;

package/dist/rules/no-dupe-file-names.js.map

@@ -1 +1 @@
-{"version":3,"file":"no-dupe-file-names.js","sourceRoot":"","sources":["../../src/rules/no-dupe-file-names.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAG7B,MAAM,IAAI,GAAG,oBAAoB,CAAC;AAElC;;;;GAIG;AAEH,gFAAgF;AAChF,MAAM,IAAI,GAAG,IAAI,GAAG,EAAoB,CAAC;AAEzC,MAAM,IAAI,GAAa;IACrB,IAAI;IACJ,KAAK;QACH,IAAI,CAAC,KAAK,EAAE,CAAC;IACf,CAAC;IACD,GAAG,CAAC,QAAQ,EAAE,IAAI;QAChB,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,YAAY,EAAE,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC;QACnF,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAEpC,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;YAC3B,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC;YACxC,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,MAAM,OAAO,GAAG,iCAAiC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QACvE,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QACjC,OAAO,CAAC,EAAC,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,EAAC,CAAC,CAAC;IAC1C,CAAC;CACF,CAAC;AAEF,eAAe,IAAI,CAAC"}
+{"version":3,"file":"no-dupe-file-names.js","sourceRoot":"","sources":["../../src/rules/no-dupe-file-names.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAG7B,MAAM,IAAI,GAAG,oBAAoB,CAAC;AAWlC,MAAM,IAAI,GAAa;IACrB,IAAI;IACJ,GAAG,CAAC,QAAQ,EAAE,IAAI,EAAE,cAAc,EAAE,OAAO;QACzC,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,CAAO,GAAG,EAAE,CAAC,IAAI,GAAG,EAAE,CAAC,CAAC;QAClD,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,YAAY,EAAE,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC;QACnF,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAEjC,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC;QAC1C,CAAC;aAAM,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,YAAY,CAAC,EAAE,CAAC;YAC9C,wEAAwE;YACxE,4BAA4B;YAC5B,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QAChC,CAAC;QAED,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,QAAQ,CAAC,cAAc,EAAE,OAAO;QAC9B,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,CAAO,GAAG,EAAE,CAAC,IAAI,GAAG,EAAE,CAAC,CAAC;QAClD,MAAM,QAAQ,GAAiB,EAAE,CAAC;QAElC,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC;YAClC,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACrB,SAAS;YACX,CAAC;YACD,sEAAsE;YACtE,uEAAuE;YACvE,0DAA0D;YAC1D,KAAK,MAAM,QAAQ,IAAI,KAAK,EAAE,CAAC;gBAC7B,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC;gBAC3D,QAAQ,CAAC,IAAI,CAAC;oBACZ,OAAO,EAAE,8BAA8B,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;oBAC1D,IAAI,EAAE,IAAI;oBACV,IAAI,EAAE,CAAC;oBACP,QAAQ;iBACT,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAED,OAAO,QAAQ,CAAC;IAClB,CAAC;CACF,CAAC;AAEF,eAAe,IAAI,CAAC"}

package/dist/rules/no-dupe-scenario-names.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"no-dupe-scenario-names.d.ts","sourceRoot":"","sources":["../../src/rules/no-dupe-scenario-names.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAC,QAAQ,EAAY,MAAM,aAAa,CAAC;AAgBrD,QAAA,MAAM,IAAI,EAAE,QAoCX,CAAC;eAEa,IAAI"}
+{"version":3,"file":"no-dupe-scenario-names.d.ts","sourceRoot":"","sources":["../../src/rules/no-dupe-scenario-names.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAC,QAAQ,EAAa,MAAM,aAAa,CAAC;AAiBtD,QAAA,MAAM,IAAI,EAAE,QAkDX,CAAC;eAEa,IAAI"}

package/dist/rules/no-dupe-scenario-names.js

@@ -3,38 +3,50 @@ import { at } from '../util/location.js';
 const name = 'no-dupe-scenario-names';
 /** Whether duplicates are looked for across all files or within each file. */
 const availableConfigs = ['anywhere', 'in-feature'];
-/** Scenario name -> everywhere it has already been seen. */
-const seen = new Map();
 const rule = {
     name,
     availableConfigs,
-    reset() {
-        seen.clear();
-    },
-    run(feature, file, configuration) {
+    run(feature, file, configuration, context) {
         if (feature === undefined) {
             return [];
         }
-        if (configuration === 'in-feature') {
-            seen.clear();
-        }
-        const errors = [];
+        const seen = context.state(() => new Map());
+        const withinOneFile = configuration === 'in-feature';
         for (const { scenario } of scenariosOf(feature)) {
-            const sighting = { file: file.relativePath, line: scenario.location.line };
-            const previous = seen.get(scenario.name);
-            if (previous === undefined) {
-                seen.set(scenario.name, [sighting]);
+            // Told to look within each file, a name only clashes with the same name
+            // in the same file - so which file it is in is part of what makes a
+            // name that name. A newline cannot appear in either half, so the two
+            // cannot run together into a key that means something else.
+            const key = withinOneFile ? `${file.relativePath}\n${scenario.name}` : scenario.name;
+            const sightings = seen.get(key) ?? [];
+            sightings.push({ filePath: file.relativePath, at: at(scenario.location) });
+            seen.set(key, sightings);
+        }
+        return [];
+    },
+    onRunEnd(_configuration, context) {
+        const seen = context.state(() => new Map());
+        const findings = [];
+        for (const sightings of seen.values()) {
+            if (sightings.length < 2) {
                 continue;
             }
-            const where = previous.map((seenAt) => `${seenAt.file}:${seenAt.line}`).join(', ');
-            previous.push(sighting);
-            errors.push({
-                message: `Scenario name is already used in: ${where}`,
-                rule: name,
-                ...at(scenario.location),
-            });
+            // Every scenario in the group hears about the others, so renaming can
+            // start from whichever one is easiest to change.
+            for (const sighting of sightings) {
+                const others = sightings.filter((other) => other !== sighting);
+                const where = others
+                    .map((other) => `${other.filePath}:${other.at.line}`)
+                    .join(', ');
+                findings.push({
+                    message: `Scenario name is also used in: ${where}`,
+                    rule: name,
+                    ...sighting.at,
+                    filePath: sighting.filePath,
+                });
+            }
         }
-        return errors;
+        return findings;
     },
 };
 export default rule;

package/dist/rules/no-dupe-scenario-names.js.map

@@ -1 +1 @@
-{"version":3,"file":"no-dupe-scenario-names.js","sourceRoot":"","sources":["../../src/rules/no-dupe-scenario-names.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,WAAW,EAAC,MAAM,wBAAwB,CAAC;AAEnD,OAAO,EAAC,EAAE,EAAC,MAAM,qBAAqB,CAAC;AAEvC,MAAM,IAAI,GAAG,wBAAwB,CAAC;AAEtC,8EAA8E;AAC9E,MAAM,gBAAgB,GAAG,CAAC,UAAU,EAAE,YAAY,CAAU,CAAC;AAO7D,4DAA4D;AAC5D,MAAM,IAAI,GAAG,IAAI,GAAG,EAAsB,CAAC;AAE3C,MAAM,IAAI,GAAa;IACrB,IAAI;IACJ,gBAAgB;IAChB,KAAK;QACH,IAAI,CAAC,KAAK,EAAE,CAAC;IACf,CAAC;IACD,GAAG,CAAC,OAAO,EAAE,IAAI,EAAE,aAAa;QAC9B,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;YAC1B,OAAO,EAAE,CAAC;QACZ,CAAC;QACD,IAAI,aAAa,KAAK,YAAY,EAAE,CAAC;YACnC,IAAI,CAAC,KAAK,EAAE,CAAC;QACf,CAAC;QAED,MAAM,MAAM,GAAgB,EAAE,CAAC;QAE/B,KAAK,MAAM,EAAC,QAAQ,EAAC,IAAI,WAAW,CAAC,OAAO,CAAC,EAAE,CAAC;YAC9C,MAAM,QAAQ,GAAa,EAAC,IAAI,EAAE,IAAI,CAAC,YAAY,EAAE,IAAI,EAAE,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAC,CAAC;YACnF,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;YAEzC,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;gBAC3B,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC;gBACpC,SAAS;YACX,CAAC;YAED,MAAM,KAAK,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,GAAG,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACnF,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YACxB,MAAM,CAAC,IAAI,CAAC;gBACV,OAAO,EAAE,qCAAqC,KAAK,EAAE;gBACrD,IAAI,EAAE,IAAI;gBACV,GAAG,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC;aACzB,CAAC,CAAC;QACL,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;CACF,CAAC;AAEF,eAAe,IAAI,CAAC"}
+{"version":3,"file":"no-dupe-scenario-names.js","sourceRoot":"","sources":["../../src/rules/no-dupe-scenario-names.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,WAAW,EAAC,MAAM,wBAAwB,CAAC;AAEnD,OAAO,EAAC,EAAE,EAAC,MAAM,qBAAqB,CAAC;AAEvC,MAAM,IAAI,GAAG,wBAAwB,CAAC;AAEtC,8EAA8E;AAC9E,MAAM,gBAAgB,GAAG,CAAC,UAAU,EAAE,YAAY,CAAU,CAAC;AAW7D,MAAM,IAAI,GAAa;IACrB,IAAI;IACJ,gBAAgB;IAChB,GAAG,CAAC,OAAO,EAAE,IAAI,EAAE,aAAa,EAAE,OAAO;QACvC,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;YAC1B,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,CAAO,GAAG,EAAE,CAAC,IAAI,GAAG,EAAE,CAAC,CAAC;QAClD,MAAM,aAAa,GAAG,aAAa,KAAK,YAAY,CAAC;QAErD,KAAK,MAAM,EAAC,QAAQ,EAAC,IAAI,WAAW,CAAC,OAAO,CAAC,EAAE,CAAC;YAC9C,wEAAwE;YACxE,oEAAoE;YACpE,qEAAqE;YACrE,4DAA4D;YAC5D,MAAM,GAAG,GAAG,aAAa,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,YAAY,KAAK,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC;YACrF,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;YACtC,SAAS,CAAC,IAAI,CAAC,EAAC,QAAQ,EAAE,IAAI,CAAC,YAAY,EAAE,EAAE,EAAE,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAC,CAAC,CAAC;YACzE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;QAC3B,CAAC;QAED,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,QAAQ,CAAC,cAAc,EAAE,OAAO;QAC9B,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,CAAO,GAAG,EAAE,CAAC,IAAI,GAAG,EAAE,CAAC,CAAC;QAClD,MAAM,QAAQ,GAAiB,EAAE,CAAC;QAElC,KAAK,MAAM,SAAS,IAAI,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC;YACtC,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACzB,SAAS;YACX,CAAC;YACD,sEAAsE;YACtE,iDAAiD;YACjD,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;gBACjC,MAAM,MAAM,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC;gBAC/D,MAAM,KAAK,GAAG,MAAM;qBACjB,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,KAAK,CAAC,QAAQ,IAAI,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC;qBACpD,IAAI,CAAC,IAAI,CAAC,CAAC;gBACd,QAAQ,CAAC,IAAI,CAAC;oBACZ,OAAO,EAAE,kCAAkC,KAAK,EAAE;oBAClD,IAAI,EAAE,IAAI;oBACV,GAAG,QAAQ,CAAC,EAAE;oBACd,QAAQ,EAAE,QAAQ,CAAC,QAAQ;iBAC5B,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAED,OAAO,QAAQ,CAAC;IAClB,CAAC;CACF,CAAC;AAEF,eAAe,IAAI,CAAC"}

package/dist/rules.d.ts

@@ -1,4 +1,4 @@
-import type { Configuration, FeatureFile, RuleConfig, RuleError, RuleRegistry, Severity } from './types.ts';
+import type { Configuration, FeatureFile, RuleConfig, RuleError, RuleRegistry, RunContext, RunFinding, Severity } from './types.ts';
 import type { Feature } from '@cucumber/messages';
 /**
  * The built-in rules, plus any found in the given directories. A custom rule
@@ -11,14 +11,52 @@ export declare function isRuleEnabled(config: RuleConfig | undefined): boolean;
 export declare function getRuleSeverity(config: RuleConfig | undefined): Severity;
 /** The rule's own settings, or `undefined` when only a state was given. */
 export declare function getRuleSettings(config: RuleConfig | undefined): unknown;
-/** Clears the state kept by rules that look for duplicates across files. */
+/**
+ * Clears the state kept by rules that look for duplicates across files.
+ *
+ * @deprecated Use `beginRun`, which does this and hands each rule a context
+ * of its own besides.
+ */
 export declare function resetRules(rules: RuleRegistry): void;
+/**
+ * One rule's state for one run, made the first time the rule asks for it.
+ *
+ * Exported because testing a rule on its own means handing it one of these.
+ */
+export declare function newRunContext(): RunContext;
+/**
+ * What one run of the rules keeps for itself.
+ *
+ * Two runs in the same process have two of these, so a rule remembering what
+ * it has seen cannot see what another run has seen.
+ */
+export interface Run {
+    /** The context for one rule, made the first time it is asked for. */
+    contextFor(ruleName: string): RunContext;
+}
+/** Starts a run, telling every enabled rule that one is beginning. */
+export declare function beginRun(rules: RuleRegistry, configuration: Configuration): Run;
+/**
+ * Ends a run, collecting what could only be worked out once every file had
+ * been seen.
+ *
+ * As while checking a file, a rule that throws costs you its own findings
+ * rather than everyone else's.
+ */
+export declare function finishRun(rules: RuleRegistry, configuration: Configuration, run: Run): Promise<RunFinding[]>;
 /**
  * Runs every enabled rule against one feature file.
  *
  * Rules are awaited one at a time. Most return an array outright, in which
  * case awaiting costs nothing; a rule that needs to wait for something can
  * return a promise instead.
+ *
+ * A rule that throws is reported as an `unexpected-error` finding naming it,
+ * and the remaining rules still run.
+ *
+ * `run` carries the state the rules keep between the files of one run. Left
+ * out, a run of this one file alone is started, which is what a caller
+ * checking a single file wants.
  */
-export declare function runEnabledRules(feature: Feature | undefined, file: FeatureFile, configuration: Configuration, rules: RuleRegistry): Promise<RuleError[]>;
+export declare function runEnabledRules(feature: Feature | undefined, file: FeatureFile, configuration: Configuration, rules: RuleRegistry, run?: Run): Promise<RuleError[]>;
 //# sourceMappingURL=rules.d.ts.map

package/dist/rules.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"rules.d.ts","sourceRoot":"","sources":["../src/rules.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EACV,aAAa,EACb,WAAW,EAEX,UAAU,EACV,SAAS,EACT,YAAY,EACZ,QAAQ,EACT,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAC,OAAO,EAAC,MAAM,oBAAoB,CAAC;AA4ChD;;;GAGG;AACH,wBAAsB,SAAS,CAC7B,mBAAmB,GAAE,SAAS,MAAM,EAAO,GAC1C,OAAO,CAAC,YAAY,CAAC,CAavB;AAOD,6EAA6E;AAC7E,wBAAgB,aAAa,CAAC,MAAM,EAAE,UAAU,GAAG,SAAS,GAAG,OAAO,CAGrE;AAED,iFAAiF;AACjF,wBAAgB,eAAe,CAAC,MAAM,EAAE,UAAU,GAAG,SAAS,GAAG,QAAQ,CAExE;AAED,2EAA2E;AAC3E,wBAAgB,eAAe,CAAC,MAAM,EAAE,UAAU,GAAG,SAAS,GAAG,OAAO,CAEvE;AAED,4EAA4E;AAC5E,wBAAgB,UAAU,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI,CAIpD;AAED;;;;;;GAMG;AACH,wBAAsB,eAAe,CACnC,OAAO,EAAE,OAAO,GAAG,SAAS,EAC5B,IAAI,EAAE,WAAW,EACjB,aAAa,EAAE,aAAa,EAC5B,KAAK,EAAE,YAAY,GAClB,OAAO,CAAC,SAAS,EAAE,CAAC,CAiBtB"}
+{"version":3,"file":"rules.d.ts","sourceRoot":"","sources":["../src/rules.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EACV,aAAa,EACb,WAAW,EAEX,UAAU,EACV,SAAS,EACT,YAAY,EACZ,UAAU,EACV,UAAU,EACV,QAAQ,EACT,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAC,OAAO,EAAC,MAAM,oBAAoB,CAAC;AAmDhD;;;GAGG;AACH,wBAAsB,SAAS,CAC7B,mBAAmB,GAAE,SAAS,MAAM,EAAO,GAC1C,OAAO,CAAC,YAAY,CAAC,CAavB;AAOD,6EAA6E;AAC7E,wBAAgB,aAAa,CAAC,MAAM,EAAE,UAAU,GAAG,SAAS,GAAG,OAAO,CAGrE;AAED,iFAAiF;AACjF,wBAAgB,eAAe,CAAC,MAAM,EAAE,UAAU,GAAG,SAAS,GAAG,QAAQ,CAExE;AAED,2EAA2E;AAC3E,wBAAgB,eAAe,CAAC,MAAM,EAAE,UAAU,GAAG,SAAS,GAAG,OAAO,CAEvE;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI,CAIpD;AAED;;;;GAIG;AACH,wBAAgB,aAAa,IAAI,UAAU,CAY1C;AAED;;;;;GAKG;AACH,MAAM,WAAW,GAAG;IAClB,qEAAqE;IACrE,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,UAAU,CAAC;CAC1C;AAED,sEAAsE;AACtE,wBAAgB,QAAQ,CAAC,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,aAAa,GAAG,GAAG,CAyB/E;AAED;;;;;;GAMG;AACH,wBAAsB,SAAS,CAC7B,KAAK,EAAE,YAAY,EACnB,aAAa,EAAE,aAAa,EAC5B,GAAG,EAAE,GAAG,GACP,OAAO,CAAC,UAAU,EAAE,CAAC,CA0BvB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,eAAe,CACnC,OAAO,EAAE,OAAO,GAAG,SAAS,EAC5B,IAAI,EAAE,WAAW,EACjB,aAAa,EAAE,aAAa,EAC5B,KAAK,EAAE,YAAY,EACnB,GAAG,GAAE,GAAoC,GACxC,OAAO,CAAC,SAAS,EAAE,CAAC,CAuCtB"}

package/dist/rules.js

@@ -39,7 +39,13 @@ async function loadRulesFrom(directory) {
     const loaded = [];
     for (const file of files) {
         const absolute = path.join(resolved, file);
-        const module = (await import(__rewriteRelativeImportExtension(pathToFileURL(absolute).href)));
+        let module;
+        try {
+            module = (await import(__rewriteRelativeImportExtension(pathToFileURL(absolute).href)));
+        }
+        catch (thrown) {
+            throw new Error(`Could not load the rule "${absolute}": ${thrown instanceof Error ? thrown.message : String(thrown)}`);
+        }
         loaded.push(extractRule(module, absolute));
     }
     return loaded;
@@ -77,20 +83,106 @@ export function getRuleSeverity(config) {
 export function getRuleSettings(config) {
     return Array.isArray(config) ? config[1] : undefined;
 }
-/** Clears the state kept by rules that look for duplicates across files. */
+/**
+ * Clears the state kept by rules that look for duplicates across files.
+ *
+ * @deprecated Use `beginRun`, which does this and hands each rule a context
+ * of its own besides.
+ */
 export function resetRules(rules) {
     for (const rule of rules.values()) {
         rule.reset?.();
     }
 }
+/**
+ * One rule's state for one run, made the first time the rule asks for it.
+ *
+ * Exported because testing a rule on its own means handing it one of these.
+ */
+export function newRunContext() {
+    let state;
+    let made = false;
+    return {
+        state(create) {
+            if (!made) {
+                state = create();
+                made = true;
+            }
+            return state;
+        },
+    };
+}
+/** Starts a run, telling every enabled rule that one is beginning. */
+export function beginRun(rules, configuration) {
+    // Rules written before contexts existed keep their state in the module and
+    // clear it here. Deprecated, but still honoured.
+    resetRules(rules);
+    const contexts = new Map();
+    const run = {
+        contextFor(ruleName) {
+            let context = contexts.get(ruleName);
+            if (context === undefined) {
+                context = newRunContext();
+                contexts.set(ruleName, context);
+            }
+            return context;
+        },
+    };
+    for (const rule of rules.values()) {
+        const config = configuration[rule.name];
+        if (isRuleEnabled(config)) {
+            rule.onRunStart?.(getRuleSettings(config), run.contextFor(rule.name));
+        }
+    }
+    return run;
+}
+/**
+ * Ends a run, collecting what could only be worked out once every file had
+ * been seen.
+ *
+ * As while checking a file, a rule that throws costs you its own findings
+ * rather than everyone else's.
+ */
+export async function finishRun(rules, configuration, run) {
+    const findings = [];
+    for (const rule of rules.values()) {
+        const config = configuration[rule.name];
+        if (!isRuleEnabled(config) || rule.onRunEnd === undefined) {
+            continue;
+        }
+        const severity = getRuleSeverity(config);
+        try {
+            const found = await rule.onRunEnd(getRuleSettings(config), run.contextFor(rule.name));
+            for (const finding of found) {
+                findings.push({ severity, ...finding });
+            }
+        }
+        catch (thrown) {
+            // No file to blame: what failed was the look back over all of them.
+            findings.push({
+                message: `Rule "${rule.name}" failed at the end of the run: ${thrown instanceof Error ? thrown.message : String(thrown)}`,
+                rule: 'unexpected-error',
+                line: 0,
+            });
+        }
+    }
+    return findings;
+}
 /**
  * Runs every enabled rule against one feature file.
  *
  * Rules are awaited one at a time. Most return an array outright, in which
  * case awaiting costs nothing; a rule that needs to wait for something can
  * return a promise instead.
+ *
+ * A rule that throws is reported as an `unexpected-error` finding naming it,
+ * and the remaining rules still run.
+ *
+ * `run` carries the state the rules keep between the files of one run. Left
+ * out, a run of this one file alone is started, which is what a caller
+ * checking a single file wants.
  */
-export async function runEnabledRules(feature, file, configuration, rules) {
+export async function runEnabledRules(feature, file, configuration, rules, run = beginRun(rules, configuration)) {
     const errors = [];
     for (const rule of rules.values()) {
         const config = configuration[rule.name];
@@ -98,7 +190,23 @@ export async function runEnabledRules(feature, file, configuration, rules) {
             continue;
         }
         const severity = getRuleSeverity(config);
-        for (const error of await rule.run(feature, file, getRuleSettings(config))) {
+        let found;
+        try {
+            found = await rule.run(feature, file, getRuleSettings(config), run.contextFor(rule.name));
+        }
+        catch (thrown) {
+            // A rule that throws - one of your own from --rulesdir, or a built-in
+            // one meeting a file it did not expect - costs you that rule's findings
+            // for this file, not every other rule's. The failure is reported in
+            // their place so that it cannot pass unnoticed.
+            errors.push({
+                message: `Rule "${rule.name}" failed: ${thrown instanceof Error ? thrown.message : String(thrown)}`,
+                rule: 'unexpected-error',
+                line: 0,
+            });
+            continue;
+        }
+        for (const error of found) {
             // The configuration decides how loudly a rule reports, so a custom rule
             // needs no say in it - but one that sets a severity itself is respected.
             errors.push({ severity, ...error });

package/dist/rules.js.map

@@ -1 +1 @@
-{"version":3,"file":"rules.js","sourceRoot":"","sources":["../src/rules.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"rules.js","sourceRoot":"","sources":["../src/rules.ts"],"names":[],"mappings":";;;;;;;;AAAA;;GAEG;AACH,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAC,aAAa,EAAC,MAAM,UAAU,CAAC;AACvC,OAAO,EAAC,cAAc,EAAC,MAAM,kBAAkB,CAAC;AAahD,OAAO,EAAC,QAAQ,EAAC,MAAM,gBAAgB,CAAC;AAExC,uDAAuD;AACvD,MAAM,eAAe,GAAG,iBAAiB,CAAC;AAE1C,SAAS,MAAM,CAAC,SAAkB;IAChC,OAAO,CACL,OAAO,SAAS,KAAK,QAAQ;QAC7B,SAAS,KAAK,IAAI;QAClB,OAAQ,SAAsB,CAAC,IAAI,KAAK,QAAQ;QAChD,OAAQ,SAAsB,CAAC,GAAG,KAAK,UAAU,CAClD,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,SAAS,WAAW,CAAC,MAA+B,EAAE,MAAc;IAClE,KAAK,MAAM,SAAS,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,EAAE,CAAC;QACpE,IAAI,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC;YACtB,OAAO,SAAS,CAAC;QACnB,CAAC;IACH,CAAC;IACD,MAAM,IAAI,KAAK,CACb,GAAG,MAAM,kGAAkG,CAC5G,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,aAAa,CAAC,SAAiB;IAC5C,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IACzC,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,eAAe,EAAE,EAAE,EAAC,GAAG,EAAE,QAAQ,EAAC,CAAC,CAAC;IAChE,MAAM,MAAM,GAAe,EAAE,CAAC;IAE9B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;QAC3C,IAAI,MAA+B,CAAC;QACpC,IAAI,CAAC;YACH,MAAM,GAAG,CAAC,MAAM,MAAM,kCAAC,aAAa,CAAC,QAAQ,CAAC,CAAC,IAAI,EAAC,CAA4B,CAAC;QACnF,CAAC;QAAC,OAAO,MAAM,EAAE,CAAC;YAChB,MAAM,IAAI,KAAK,CACb,4BAA4B,QAAQ,MAAM,MAAM,YAAY,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CACtG,CAAC;QACJ,CAAC;QACD,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC;IAC7C,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,mBAAmB,GAAsB,EAAE;IAE3C,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAoB,CAAC;IAE7C,KAAK,MAAM,IAAI,IAAI,cAAc,EAAE,CAAC;QAClC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAChC,CAAC;IACD,KAAK,MAAM,SAAS,IAAI,mBAAmB,EAAE,CAAC;QAC5C,KAAK,MAAM,IAAI,IAAI,MAAM,aAAa,CAAC,SAAS,CAAC,EAAE,CAAC;YAClD,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAChC,CAAC;IACH,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,gDAAgD;AAChD,SAAS,OAAO,CAAC,MAA8B;IAC7C,OAAO,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;AAC7F,CAAC;AAED,6EAA6E;AAC7E,MAAM,UAAU,aAAa,CAAC,MAA8B;IAC1D,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC9B,OAAO,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,MAAM,CAAC;AAC5C,CAAC;AAED,iFAAiF;AACjF,MAAM,UAAU,eAAe,CAAC,MAA8B;IAC5D,OAAO,OAAO,CAAC,MAAM,CAAC,KAAK,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC;AAC1D,CAAC;AAED,2EAA2E;AAC3E,MAAM,UAAU,eAAe,CAAC,MAA8B;IAC5D,OAAO,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AACvD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,UAAU,CAAC,KAAmB;IAC5C,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC;QAClC,IAAI,CAAC,KAAK,EAAE,EAAE,CAAC;IACjB,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,aAAa;IAC3B,IAAI,KAAc,CAAC;IACnB,IAAI,IAAI,GAAG,KAAK,CAAC;IACjB,OAAO;QACL,KAAK,CAAI,MAAe;YACtB,IAAI,CAAC,IAAI,EAAE,CAAC;gBACV,KAAK,GAAG,MAAM,EAAE,CAAC;gBACjB,IAAI,GAAG,IAAI,CAAC;YACd,CAAC;YACD,OAAO,KAAU,CAAC;QACpB,CAAC;KACF,CAAC;AACJ,CAAC;AAaD,sEAAsE;AACtE,MAAM,UAAU,QAAQ,CAAC,KAAmB,EAAE,aAA4B;IACxE,2EAA2E;IAC3E,iDAAiD;IACjD,UAAU,CAAC,KAAK,CAAC,CAAC;IAElB,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAsB,CAAC;IAC/C,MAAM,GAAG,GAAQ;QACf,UAAU,CAAC,QAAgB;YACzB,IAAI,OAAO,GAAG,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;YACrC,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;gBAC1B,OAAO,GAAG,aAAa,EAAE,CAAC;gBAC1B,QAAQ,CAAC,GAAG,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;YAClC,CAAC;YACD,OAAO,OAAO,CAAC;QACjB,CAAC;KACF,CAAC;IAEF,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC;QAClC,MAAM,MAAM,GAAG,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACxC,IAAI,aAAa,CAAC,MAAM,CAAC,EAAE,CAAC;YAC1B,IAAI,CAAC,UAAU,EAAE,CAAC,eAAe,CAAC,MAAM,CAAC,EAAE,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QACxE,CAAC;IACH,CAAC;IAED,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,KAAmB,EACnB,aAA4B,EAC5B,GAAQ;IAER,MAAM,QAAQ,GAAiB,EAAE,CAAC;IAElC,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC;QAClC,MAAM,MAAM,GAAG,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACxC,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;YAC1D,SAAS;QACX,CAAC;QACD,MAAM,QAAQ,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC;QAEzC,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,eAAe,CAAC,MAAM,CAAC,EAAE,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;YACtF,KAAK,MAAM,OAAO,IAAI,KAAK,EAAE,CAAC;gBAC5B,QAAQ,CAAC,IAAI,CAAC,EAAC,QAAQ,EAAE,GAAG,OAAO,EAAC,CAAC,CAAC;YACxC,CAAC;QACH,CAAC;QAAC,OAAO,MAAM,EAAE,CAAC;YAChB,oEAAoE;YACpE,QAAQ,CAAC,IAAI,CAAC;gBACZ,OAAO,EAAE,SAAS,IAAI,CAAC,IAAI,mCAAmC,MAAM,YAAY,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE;gBACzH,IAAI,EAAE,kBAAkB;gBACxB,IAAI,EAAE,CAAC;aACR,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,OAA4B,EAC5B,IAAiB,EACjB,aAA4B,EAC5B,KAAmB,EACnB,GAAG,GAAQ,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;IAEzC,MAAM,MAAM,GAAgB,EAAE,CAAC;IAE/B,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC;QAClC,MAAM,MAAM,GAAG,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACxC,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,EAAE,CAAC;YAC3B,SAAS;QACX,CAAC;QACD,MAAM,QAAQ,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC;QAEzC,IAAI,KAAkB,CAAC;QACvB,IAAI,CAAC;YACH,KAAK,GAAG,MAAM,IAAI,CAAC,GAAG,CACpB,OAAO,EACP,IAAI,EACJ,eAAe,CAAC,MAAM,CAAC,EACvB,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAC1B,CAAC;QACJ,CAAC;QAAC,OAAO,MAAM,EAAE,CAAC;YAChB,sEAAsE;YACtE,wEAAwE;YACxE,oEAAoE;YACpE,gDAAgD;YAChD,MAAM,CAAC,IAAI,CAAC;gBACV,OAAO,EAAE,SAAS,IAAI,CAAC,IAAI,aAAa,MAAM,YAAY,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE;gBACnG,IAAI,EAAE,kBAAkB;gBACxB,IAAI,EAAE,CAAC;aACR,CAAC,CAAC;YACH,SAAS;QACX,CAAC;QAED,KAAK,MAAM,KAAK,IAAI,KAAK,EAAE,CAAC;YAC1B,wEAAwE;YACxE,yEAAyE;YACzE,MAAM,CAAC,IAAI,CAAC,EAAC,QAAQ,EAAE,GAAG,KAAK,EAAC,CAAC,CAAC;QACpC,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/stats/collect.d.ts

@@ -0,0 +1,31 @@
+import type { ParseResult } from '../gherkin/parse.ts';
+import type { SimilarityOptions } from './similar.ts';
+import type { Sequence } from '../util/stream.ts';
+import type { Distribution, Statistics } from './types.ts';
+export interface CollectOptions {
+    /** How alike two steps have to be to be reported as nearly the same. */
+    similarity?: SimilarityOptions;
+}
+/**
+ * A summary of a set of counts.
+ *
+ * The quantiles are nearest-rank: the median of an even set is the lower of
+ * the two middle values rather than the average of them, so every number in
+ * the summary is a number some scenario actually has.
+ */
+export declare function distribution(values: readonly number[]): Distribution;
+/**
+ * Counts a set of parsed feature files.
+ *
+ * Files the parser refused are listed rather than counted: half a broken file
+ * is worse than none of it, because the numbers would quietly be wrong.
+ */
+export declare function collectStatistics(parsed: readonly ParseResult[], options?: CollectOptions): Statistics;
+/**
+ * The same count, over files arriving one at a time.
+ *
+ * Nothing here holds on to a parsed document once it has been counted, so a
+ * suite of any size costs the same as the report it produces.
+ */
+export declare function collectStatisticsFrom(parsed: Sequence<ParseResult>, options?: CollectOptions): Promise<Statistics>;
+//# sourceMappingURL=collect.d.ts.map

package/dist/stats/collect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"collect.d.ts","sourceRoot":"","sources":["../../src/stats/collect.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAC,WAAW,EAAC,MAAM,qBAAqB,CAAC;AAWrD,OAAO,KAAK,EAAC,iBAAiB,EAAC,MAAM,cAAc,CAAC;AACpD,OAAO,KAAK,EAAC,QAAQ,EAAC,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,EACV,YAAY,EAMZ,UAAU,EAGX,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,cAAc;IAC7B,wEAAwE;IACxE,UAAU,CAAC,EAAE,iBAAiB,CAAC;CAChC;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,GAAG,YAAY,CAkBpE;AAgRD;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,SAAS,WAAW,EAAE,EAC9B,OAAO,GAAE,cAAmB,GAC3B,UAAU,CAMZ;AAED;;;;;GAKG;AACH,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,QAAQ,CAAC,WAAW,CAAC,EAC7B,OAAO,GAAE,cAAmB,GAC3B,OAAO,CAAC,UAAU,CAAC,CAMrB"}