@sarj/eslint-plugin 15.3.0 → 15.4.0

package/dist/index.cjs

@@ -104,6 +104,7 @@ ${missing.join("\n")}`);
 function publicExample(example) {
   return {
     id: example.id,
+    scenarioId: example.scenarioId ?? "primary",
     title: example.title,
     outcome: example.outcome,
     files: example.files.map(publicFile),
@@ -148,9 +149,14 @@ function nativeSpec(config, documentation) {
   const examples = [...documentation.examples ?? []];
   examples.forEach(validateExample);
   assertUnique(examples.map((example) => example.id), "rule example IDs");
-  const publicOutcomes = new Set(examples.filter((example) => example.public === true).map((example) => example.outcome));
-  if (publicOutcomes.size > 0 && !(publicOutcomes.has("match") && publicOutcomes.has("no-match"))) {
-    throw new TypeError("published rule examples must include matching and non-matching cases");
+  const publicExamples = examples.filter((example) => example.public === true);
+  const scenarios = new Set(publicExamples.map((example) => example.scenarioId ?? "primary"));
+  for (const scenario of scenarios) {
+    const pair = publicExamples.filter((example) => (example.scenarioId ?? "primary") === scenario);
+    const outcomes = new Set(pair.map((example) => example.outcome));
+    if (pair.length !== 2 || !outcomes.has("match") || !outcomes.has("no-match")) {
+      throw new TypeError(`published example scenario ${scenario} must contain both matching and non-matching cases exactly once`);
+    }
   }
   const messageIds = Object.keys(meta2.messages).sort();
   const schema = optionsSchema(meta2.schema);
@@ -171,7 +177,7 @@ function nativeSpec(config, documentation) {
     references,
     since: documentation.since ?? null,
     examples,
-    publicExamples: examples.filter((example) => example.public === true),
+    publicExamples,
     messageIds,
     optionsSchema: schema
   };
@@ -191,6 +197,9 @@ function validateExample(example) {
   if (!KEBAB_CASE.test(example.id)) {
     throw new TypeError("example ID must be lowercase kebab-case");
   }
+  if (!KEBAB_CASE.test(example.scenarioId ?? "primary")) {
+    throw new TypeError("example scenario must be lowercase kebab-case");
+  }
   if (example.title.trim().length === 0) {
     throw new TypeError("example title must not be empty");
   }
@@ -14436,7 +14445,7 @@ var rules = {
 };
 var meta = {
   name: "@sarj/eslint-plugin",
-  version: "15.3.0"
+  version: "15.4.0"
 };
 var applicationOnlyRules = [
   "no-restricted-library-load",

package/dist/index.d.cts

@@ -25,6 +25,7 @@ interface ExampleFile {
 /** A reviewed example. It remains private unless `public: true` is explicit. */
 interface RuleExample {
     readonly id: string;
+    readonly scenarioId?: string;
     readonly title: string;
     readonly outcome: ExampleOutcome;
     readonly files: readonly ExampleFile[];
@@ -414,7 +415,7 @@ type FlatPreset = {
 declare const plugin: {
     readonly meta: {
         readonly name: "@sarj/eslint-plugin";
-        readonly version: "15.3.0";
+        readonly version: "15.4.0";
     };
     readonly rules: {
         readonly "duplicate-test-body": DocumentedRule<readonly [], "duplicateTestBody">;

package/dist/index.d.ts

@@ -25,6 +25,7 @@ interface ExampleFile {
 /** A reviewed example. It remains private unless `public: true` is explicit. */
 interface RuleExample {
     readonly id: string;
+    readonly scenarioId?: string;
     readonly title: string;
     readonly outcome: ExampleOutcome;
     readonly files: readonly ExampleFile[];
@@ -414,7 +415,7 @@ type FlatPreset = {
 declare const plugin: {
     readonly meta: {
         readonly name: "@sarj/eslint-plugin";
-        readonly version: "15.3.0";
+        readonly version: "15.4.0";
     };
     readonly rules: {
         readonly "duplicate-test-body": DocumentedRule<readonly [], "duplicateTestBody">;

package/dist/index.js

@@ -61,6 +61,7 @@ ${missing.join("\n")}`);
 function publicExample(example) {
   return {
     id: example.id,
+    scenarioId: example.scenarioId ?? "primary",
     title: example.title,
     outcome: example.outcome,
     files: example.files.map(publicFile),
@@ -105,9 +106,14 @@ function nativeSpec(config, documentation) {
   const examples = [...documentation.examples ?? []];
   examples.forEach(validateExample);
   assertUnique(examples.map((example) => example.id), "rule example IDs");
-  const publicOutcomes = new Set(examples.filter((example) => example.public === true).map((example) => example.outcome));
-  if (publicOutcomes.size > 0 && !(publicOutcomes.has("match") && publicOutcomes.has("no-match"))) {
-    throw new TypeError("published rule examples must include matching and non-matching cases");
+  const publicExamples = examples.filter((example) => example.public === true);
+  const scenarios = new Set(publicExamples.map((example) => example.scenarioId ?? "primary"));
+  for (const scenario of scenarios) {
+    const pair = publicExamples.filter((example) => (example.scenarioId ?? "primary") === scenario);
+    const outcomes = new Set(pair.map((example) => example.outcome));
+    if (pair.length !== 2 || !outcomes.has("match") || !outcomes.has("no-match")) {
+      throw new TypeError(`published example scenario ${scenario} must contain both matching and non-matching cases exactly once`);
+    }
   }
   const messageIds = Object.keys(meta2.messages).sort();
   const schema = optionsSchema(meta2.schema);
@@ -128,7 +134,7 @@ function nativeSpec(config, documentation) {
     references,
     since: documentation.since ?? null,
     examples,
-    publicExamples: examples.filter((example) => example.public === true),
+    publicExamples,
     messageIds,
     optionsSchema: schema
   };
@@ -148,6 +154,9 @@ function validateExample(example) {
   if (!KEBAB_CASE.test(example.id)) {
     throw new TypeError("example ID must be lowercase kebab-case");
   }
+  if (!KEBAB_CASE.test(example.scenarioId ?? "primary")) {
+    throw new TypeError("example scenario must be lowercase kebab-case");
+  }
   if (example.title.trim().length === 0) {
     throw new TypeError("example title must not be empty");
   }
@@ -14414,7 +14423,7 @@ var rules = {
 };
 var meta = {
   name: "@sarj/eslint-plugin",
-  version: "15.3.0"
+  version: "15.4.0"
 };
 var applicationOnlyRules = [
   "no-restricted-library-load",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sarj/eslint-plugin",
-  "version": "15.3.0",
+  "version": "15.4.0",
   "packageManager": "npm@11.19.0",
   "description": "Custom ESLint rules for hypermodern TypeScript / React / Next.js projects",
   "type": "module",