@sarj/eslint-plugin 16.15.0 → 16.15.1

package/dist/index.cjs

@@ -52,7 +52,7 @@ module.exports = __toCommonJS(src_exports);
 // package.json
 var package_default = {
   name: "@sarj/eslint-plugin",
-  version: "16.15.0",
+  version: "16.15.1",
   packageManager: "npm@12.2.0",
   description: "Custom ESLint rules for hypermodern TypeScript / React / Next.js projects",
   type: "module",
@@ -3906,10 +3906,13 @@ var NO_CLIENT_SIDE_DATA_FETCHING_DOCUMENTATION = {
   examples: [
     {
       id: "effect-without-fetch",
-      title: "An effect performs no data request",
+      title: "Load data while rendering on the server",
       outcome: "no-match",
-      files: [{ path: "src/users.tsx", source: "import { useEffect } from 'react'; useEffect(() => { console.log('mounted'); }, []);" }],
-      focusPath: "src/users.tsx",
+      files: [
+        { path: "app/users/page.tsx", source: "import { loadUsers } from './users-client';\nexport default async function Users() { const users = await loadUsers(); return <pre>{JSON.stringify(users)}</pre>; }" },
+        { path: "app/users/users-client.ts", source: "export async function loadUsers(): Promise<unknown> { const response = await fetch('https://api.example.com/users'); return response.json(); }" }
+      ],
+      focusPath: "app/users/page.tsx",
       expectedCount: 0,
       public: true
     },
@@ -3917,7 +3920,7 @@ var NO_CLIENT_SIDE_DATA_FETCHING_DOCUMENTATION = {
       id: "fetch-inside-effect",
       title: "An effect starts a data request",
       outcome: "match",
-      files: [{ path: "src/users.tsx", source: "useEffect(() => { fetch('/api/users'); }, []);" }],
+      files: [{ path: "src/users.tsx", source: "'use client'; import { useEffect } from 'react';\nexport function Users() { useEffect(() => { fetch('/api/users'); }, []); return null; }" }],
       focusPath: "src/users.tsx",
       expectedCount: 1,
       public: true
@@ -6058,11 +6061,11 @@ var NO_FAT_TRY_BLOCKS_DOCUMENTATION = {
   examples: [
     {
       id: "focused-try-block",
-      title: "Three selected operations stay within the default threshold",
+      title: "Keep only operations with the same recovery policy in the try block",
       outcome: "no-match",
       files: [{
         path: "src/load.ts",
-        source: "function f() { try { const a = one(); const b = two(); const c = three(); } catch (error) { handle(error); } finish(); }"
+        source: "function f() { try { const a = one(); const b = two(); const c = three(); } catch (error) { handle(error); } const d = four(); finish(); }"
       }],
       focusPath: "src/load.ts",
       expectedCount: 0,
@@ -7850,7 +7853,7 @@ var NO_JSON_STRINGIFY_OBJECT_EQUALITY_DOCUMENTATION = {
       id: "domain-comparator",
       title: "Use an explicit structural comparator",
       outcome: "no-match",
-      files: [{ path: "src/compare.ts", source: "const same = sameRecord(actual, expected);" }],
+      files: [{ path: "src/compare.ts", source: "type RecordState = { id: string; state: string };\nfunction sameRecord(actual: RecordState, expected: RecordState): boolean { return actual.id === expected.id && actual.state === expected.state; }\nconst same = sameRecord({ id: '1', state: 'ready' }, { state: 'ready', id: '1' });" }],
       focusPath: "src/compare.ts",
       expectedCount: 0,
       public: true
@@ -10578,8 +10581,9 @@ var NO_RESTRICTED_LIBRARY_LOAD_DOCUMENTATION = {
   category: "architecture",
   limitations: ["Only literal dynamic imports, unshadowed CommonJS loads/resolution calls, and runtime TypeScript import-equals declarations are checked; erased type imports are excluded. A configured restriction list is required."],
   examples: [
-    { id: "static-import", title: "Static imports remain the static-import rule's responsibility", outcome: "no-match", files: [{ path: "src/client.ts", source: "import axios from 'axios';" }], focusPath: "src/client.ts", expectedCount: 0, public: true, ruleOptions: [{ libraries: [{ id: "LIB101", module: "axios", replacement: "Ky" }] }] },
-    { id: "runtime-load", title: "Do not load a restricted library at runtime", outcome: "match", files: [{ path: "src/client.ts", source: "const client = require('axios');" }], focusPath: "src/client.ts", expectedCount: 1, public: true, ruleOptions: [{ libraries: [{ id: "LIB101", module: "axios", replacement: "Ky" }] }] }
+    { id: "configured-replacement", title: "Use the configured library replacement", outcome: "no-match", files: [{ path: "src/client.ts", source: "import ky from 'ky'; const client = ky;" }], focusPath: "src/client.ts", expectedCount: 0, public: true, ruleOptions: [{ libraries: [{ id: "LIB101", module: "axios", replacement: "Ky" }] }] },
+    { id: "runtime-load", title: "Do not load a restricted library at runtime", outcome: "match", files: [{ path: "src/client.ts", source: "const client = require('axios');" }], focusPath: "src/client.ts", expectedCount: 1, public: true, ruleOptions: [{ libraries: [{ id: "LIB101", module: "axios", replacement: "Ky" }] }] },
+    { id: "static-import-owned-upstream", title: "Leave static restrictions to the owning import rule", outcome: "no-match", files: [{ path: "src/client.ts", source: "import axios from 'axios';" }], focusPath: "src/client.ts", expectedCount: 0, ruleOptions: [{ libraries: [{ id: "LIB101", module: "axios", replacement: "Ky" }] }] }
   ]
 };
 function staticModule(node) {
@@ -14084,7 +14088,7 @@ var NO_DECLARATION_COMMENT_WALL_DOCUMENTATION = {
       id: "uncommented-members",
       title: "Let clear member names stand alone",
       outcome: "no-match",
-      files: [{ path: "src/status.ts", source: "enum Status { Pending = 'pending', Done = 'done', Failed = 'failed' }" }],
+      files: [{ path: "src/status.ts", source: "enum Status { Pending = 'pending', Finished = 'finished', Failed = 'failed' }" }],
       focusPath: "src/status.ts",
       expectedCount: 0,
       public: true
@@ -14375,7 +14379,7 @@ var NO_TYPE_MEMBER_COMMENT_WALL_DOCUMENTATION = {
       id: "uncommented-members",
       title: "Let clear member names and types stand alone",
       outcome: "no-match",
-      files: [{ path: "src/credentials.ts", source: "interface Credentials { host: string; port: number; username: string; }" }],
+      files: [{ path: "src/credentials.ts", source: "interface Credentials { host?: string; port?: number; username?: string; password?: string; }" }],
       focusPath: "src/credentials.ts",
       expectedCount: 0,
       public: true
@@ -14964,12 +14968,37 @@ var NO_ZOD_NATIVE_ENUM_DOCUMENTATION = {
     },
     {
       id: "zod-native-enum",
-      title: "Do not wrap a TypeScript enum",
+      title: "Declare literal values instead of an enum-like object",
       outcome: "match",
       files: [{ path: "src/status.ts", source: 'import { z } from "zod"; const S = z.nativeEnum({ Active: "active", Inactive: "inactive" });' }],
       focusPath: "src/status.ts",
       expectedCount: 1,
       public: true
+    },
+    {
+      id: "imported-typescript-enum",
+      scenarioId: "imported-enum",
+      title: "Do not hide an imported TypeScript enum behind z.enum",
+      outcome: "match",
+      files: [
+        { path: "src/status-values.ts", source: "export enum Status { Active = 'active', Inactive = 'inactive' }" },
+        { path: "src/status.ts", source: "import { z } from 'zod'; import { Status } from './status-values.js';\nexport const StatusSchema = z.enum(Status);" }
+      ],
+      installedDependencies: [{ module: "zod", version: "4.6.7" }],
+      focusPath: "src/status.ts",
+      expectedCount: 1,
+      public: true
+    },
+    {
+      id: "schema-owned-string-values",
+      scenarioId: "imported-enum",
+      title: "Let the schema own its literal value domain",
+      outcome: "no-match",
+      files: [{ path: "src/status.ts", source: "import { z } from 'zod';\nexport const StatusSchema = z.enum(['active', 'inactive']);" }],
+      installedDependencies: [{ module: "zod", version: "4.6.7" }],
+      focusPath: "src/status.ts",
+      expectedCount: 0,
+      public: true
     }
   ]
 };
@@ -17882,7 +17911,7 @@ var PREFER_MODULE_LEVEL_REFINED_SCHEMA_DOCUMENTATION = {
       outcome: "no-match",
       files: [{
         path: "src/options.ts",
-        source: "import { z } from 'zod'; const BatchSizeSchema = z.number().int().min(1).max(1000); export function parse(value: unknown) { return BatchSizeSchema.parse(value); }"
+        source: "import { z } from 'zod'; const NameSchema = z.string().trim().min(1).max(128); export function parse(value: unknown) { return NameSchema.parse(value); }"
       }],
       focusPath: "src/options.ts",
       expectedCount: 0,
@@ -19517,7 +19546,7 @@ var PREFER_SCHEMA_FOR_API_PAYLOAD_DOCUMENTATION = {
     "Test fixtures, generated clients and recognized local-file reads are excluded. This is bounded local analysis, not a general control-flow or mutation proof."
   ],
   examples: [
-    { id: "validated-payload", title: "Validate before property access", outcome: "no-match", files: [{ path: "src/client.ts", source: "async function load(response: Response) { const body = UserSchema.parse(await response.json()); return body.id; }" }], focusPath: "src/client.ts", expectedCount: 0, public: true },
+    { id: "validated-payload", title: "Validate before property access", outcome: "no-match", files: [{ path: "src/client.ts", source: "import { z } from 'zod';\nconst UserSchema = z.object({ id: z.string() });\nasync function load(response: Response) { const body = UserSchema.parse(await response.json()); return body.id; }" }], installedDependencies: [{ module: "zod", version: "4.6.7" }], focusPath: "src/client.ts", expectedCount: 0, public: true },
     { id: "unvalidated-payload", title: "Do not trust response JSON directly", outcome: "match", files: [{ path: "src/client.ts", source: "async function load(response: Response) { const body = await response.json(); return body.id; }" }], focusPath: "src/client.ts", expectedCount: 1, public: true }
   ]
 };
@@ -20193,8 +20222,8 @@ var PREFER_SWITCH_FOR_REPEATED_EQUALITY_DOCUMENTATION = {
     "The rule deliberately ignores compound predicates, loose equality, ranges, and chains that compare different discriminants."
   ],
   examples: [
-    { id: "switch-dispatch", title: "Make finite dispatch explicit", outcome: "no-match", files: [{ path: "src/render.ts", source: "switch (kind) { case 'a': return a(); case 'b': return b(); case 'c': return c(); default: return fallback(); }" }], focusPath: "src/render.ts", expectedCount: 0, public: true },
-    { id: "repeated-equality", title: "Avoid repeating the discriminant", outcome: "match", files: [{ path: "src/render.ts", source: "function render(kind: string) { if (kind === 'a') return a(); else if (kind === 'b') return b(); else if (kind === 'c') return c(); }" }], focusPath: "src/render.ts", expectedCount: 1, public: true },
+    { id: "switch-dispatch", title: "Make finite dispatch explicit", outcome: "no-match", files: [{ path: "src/render.ts", source: "function render(kind: string) { switch (kind) { case 'a': return 'alpha'; case 'b': return 'beta'; case 'c': return 'gamma'; default: return 'unknown'; } }" }], focusPath: "src/render.ts", expectedCount: 0, public: true },
+    { id: "repeated-equality", title: "Avoid repeating the discriminant", outcome: "match", files: [{ path: "src/render.ts", source: "function render(kind: string) { if (kind === 'a') return 'alpha'; else if (kind === 'b') return 'beta'; else if (kind === 'c') return 'gamma'; return 'unknown'; }" }], focusPath: "src/render.ts", expectedCount: 1, public: true },
     { id: "escaped-middle", scenarioId: "native-discriminant", title: "Use native identifier identity", outcome: "match", files: [{ path: "src/dispatch.ts", source: `function probe(kind){if(kind==='a')return 1;else if(\\u006bind==='b')return 2;else if(kind==='c')return 3;return 0;}
 console.log(JSON.stringify(["a","b","c","d"].map(probe)));` }], focusPath: "src/dispatch.ts", expectedCount: 1, public: true },
     { id: "different-discriminants", scenarioId: "native-discriminant", title: "Use native identifier identity", outcome: "no-match", files: [{ path: "src/dispatch.ts", source: `function probe(kind){const other="other";if(kind==='a')return 1;else if(other==='b')return 2;else if(kind==='c')return 3;return 0;}
@@ -22732,7 +22761,7 @@ var REQUIRE_ASSERT_NEVER_DOCUMENTATION = {
   category: "correctness",
   limitations: ["Requires type information and singleton case values covering the current union. The helper must accept never to provide a compile-time check; its spelling alone is not a proof of that contract. Review the desired runtime behavior for unexpected external values."],
   examples: [
-    { id: "assert-never-default", title: "Make the default exhaustive", outcome: "no-match", files: [{ path: "src/render.ts", source: "declare const kind: 'a' | 'b';\nswitch (kind) { case 'a': break; case 'b': break; default: assertNever(kind); }" }], focusPath: "src/render.ts", expectedCount: 0, public: true },
+    { id: "assert-never-default", title: "Make the default exhaustive", outcome: "no-match", files: [{ path: "src/render.ts", source: "function assertNever(value: never): never { throw new Error(`Unexpected kind: ${String(value)}`); }\ndeclare const kind: 'a' | 'b';\nswitch (kind) { case 'a': break; case 'b': break; default: assertNever(kind); }" }], focusPath: "src/render.ts", expectedCount: 0, public: true },
     { id: "empty-default", title: "Do not leave an exhaustive default empty", outcome: "match", files: [{ path: "src/render.ts", source: "declare const kind: 'a' | 'b';\nswitch (kind) { case 'a': break; case 'b': break; default: }" }], focusPath: "src/render.ts", expectedCount: 1, public: true }
   ]
 };

package/dist/index.js

@@ -1,7 +1,7 @@
 // package.json
 var package_default = {
   name: "@sarj/eslint-plugin",
-  version: "16.15.0",
+  version: "16.15.1",
   packageManager: "npm@12.2.0",
   description: "Custom ESLint rules for hypermodern TypeScript / React / Next.js projects",
   type: "module",
@@ -3867,10 +3867,13 @@ var NO_CLIENT_SIDE_DATA_FETCHING_DOCUMENTATION = {
   examples: [
     {
       id: "effect-without-fetch",
-      title: "An effect performs no data request",
+      title: "Load data while rendering on the server",
       outcome: "no-match",
-      files: [{ path: "src/users.tsx", source: "import { useEffect } from 'react'; useEffect(() => { console.log('mounted'); }, []);" }],
-      focusPath: "src/users.tsx",
+      files: [
+        { path: "app/users/page.tsx", source: "import { loadUsers } from './users-client';\nexport default async function Users() { const users = await loadUsers(); return <pre>{JSON.stringify(users)}</pre>; }" },
+        { path: "app/users/users-client.ts", source: "export async function loadUsers(): Promise<unknown> { const response = await fetch('https://api.example.com/users'); return response.json(); }" }
+      ],
+      focusPath: "app/users/page.tsx",
       expectedCount: 0,
       public: true
     },
@@ -3878,7 +3881,7 @@ var NO_CLIENT_SIDE_DATA_FETCHING_DOCUMENTATION = {
       id: "fetch-inside-effect",
       title: "An effect starts a data request",
       outcome: "match",
-      files: [{ path: "src/users.tsx", source: "useEffect(() => { fetch('/api/users'); }, []);" }],
+      files: [{ path: "src/users.tsx", source: "'use client'; import { useEffect } from 'react';\nexport function Users() { useEffect(() => { fetch('/api/users'); }, []); return null; }" }],
       focusPath: "src/users.tsx",
       expectedCount: 1,
       public: true
@@ -6019,11 +6022,11 @@ var NO_FAT_TRY_BLOCKS_DOCUMENTATION = {
   examples: [
     {
       id: "focused-try-block",
-      title: "Three selected operations stay within the default threshold",
+      title: "Keep only operations with the same recovery policy in the try block",
       outcome: "no-match",
       files: [{
         path: "src/load.ts",
-        source: "function f() { try { const a = one(); const b = two(); const c = three(); } catch (error) { handle(error); } finish(); }"
+        source: "function f() { try { const a = one(); const b = two(); const c = three(); } catch (error) { handle(error); } const d = four(); finish(); }"
       }],
       focusPath: "src/load.ts",
       expectedCount: 0,
@@ -7818,7 +7821,7 @@ var NO_JSON_STRINGIFY_OBJECT_EQUALITY_DOCUMENTATION = {
       id: "domain-comparator",
       title: "Use an explicit structural comparator",
       outcome: "no-match",
-      files: [{ path: "src/compare.ts", source: "const same = sameRecord(actual, expected);" }],
+      files: [{ path: "src/compare.ts", source: "type RecordState = { id: string; state: string };\nfunction sameRecord(actual: RecordState, expected: RecordState): boolean { return actual.id === expected.id && actual.state === expected.state; }\nconst same = sameRecord({ id: '1', state: 'ready' }, { state: 'ready', id: '1' });" }],
       focusPath: "src/compare.ts",
       expectedCount: 0,
       public: true
@@ -10559,8 +10562,9 @@ var NO_RESTRICTED_LIBRARY_LOAD_DOCUMENTATION = {
   category: "architecture",
   limitations: ["Only literal dynamic imports, unshadowed CommonJS loads/resolution calls, and runtime TypeScript import-equals declarations are checked; erased type imports are excluded. A configured restriction list is required."],
   examples: [
-    { id: "static-import", title: "Static imports remain the static-import rule's responsibility", outcome: "no-match", files: [{ path: "src/client.ts", source: "import axios from 'axios';" }], focusPath: "src/client.ts", expectedCount: 0, public: true, ruleOptions: [{ libraries: [{ id: "LIB101", module: "axios", replacement: "Ky" }] }] },
-    { id: "runtime-load", title: "Do not load a restricted library at runtime", outcome: "match", files: [{ path: "src/client.ts", source: "const client = require('axios');" }], focusPath: "src/client.ts", expectedCount: 1, public: true, ruleOptions: [{ libraries: [{ id: "LIB101", module: "axios", replacement: "Ky" }] }] }
+    { id: "configured-replacement", title: "Use the configured library replacement", outcome: "no-match", files: [{ path: "src/client.ts", source: "import ky from 'ky'; const client = ky;" }], focusPath: "src/client.ts", expectedCount: 0, public: true, ruleOptions: [{ libraries: [{ id: "LIB101", module: "axios", replacement: "Ky" }] }] },
+    { id: "runtime-load", title: "Do not load a restricted library at runtime", outcome: "match", files: [{ path: "src/client.ts", source: "const client = require('axios');" }], focusPath: "src/client.ts", expectedCount: 1, public: true, ruleOptions: [{ libraries: [{ id: "LIB101", module: "axios", replacement: "Ky" }] }] },
+    { id: "static-import-owned-upstream", title: "Leave static restrictions to the owning import rule", outcome: "no-match", files: [{ path: "src/client.ts", source: "import axios from 'axios';" }], focusPath: "src/client.ts", expectedCount: 0, ruleOptions: [{ libraries: [{ id: "LIB101", module: "axios", replacement: "Ky" }] }] }
   ]
 };
 function staticModule(node) {
@@ -14065,7 +14069,7 @@ var NO_DECLARATION_COMMENT_WALL_DOCUMENTATION = {
       id: "uncommented-members",
       title: "Let clear member names stand alone",
       outcome: "no-match",
-      files: [{ path: "src/status.ts", source: "enum Status { Pending = 'pending', Done = 'done', Failed = 'failed' }" }],
+      files: [{ path: "src/status.ts", source: "enum Status { Pending = 'pending', Finished = 'finished', Failed = 'failed' }" }],
       focusPath: "src/status.ts",
       expectedCount: 0,
       public: true
@@ -14356,7 +14360,7 @@ var NO_TYPE_MEMBER_COMMENT_WALL_DOCUMENTATION = {
       id: "uncommented-members",
       title: "Let clear member names and types stand alone",
       outcome: "no-match",
-      files: [{ path: "src/credentials.ts", source: "interface Credentials { host: string; port: number; username: string; }" }],
+      files: [{ path: "src/credentials.ts", source: "interface Credentials { host?: string; port?: number; username?: string; password?: string; }" }],
       focusPath: "src/credentials.ts",
       expectedCount: 0,
       public: true
@@ -14952,12 +14956,37 @@ var NO_ZOD_NATIVE_ENUM_DOCUMENTATION = {
     },
     {
       id: "zod-native-enum",
-      title: "Do not wrap a TypeScript enum",
+      title: "Declare literal values instead of an enum-like object",
       outcome: "match",
       files: [{ path: "src/status.ts", source: 'import { z } from "zod"; const S = z.nativeEnum({ Active: "active", Inactive: "inactive" });' }],
       focusPath: "src/status.ts",
       expectedCount: 1,
       public: true
+    },
+    {
+      id: "imported-typescript-enum",
+      scenarioId: "imported-enum",
+      title: "Do not hide an imported TypeScript enum behind z.enum",
+      outcome: "match",
+      files: [
+        { path: "src/status-values.ts", source: "export enum Status { Active = 'active', Inactive = 'inactive' }" },
+        { path: "src/status.ts", source: "import { z } from 'zod'; import { Status } from './status-values.js';\nexport const StatusSchema = z.enum(Status);" }
+      ],
+      installedDependencies: [{ module: "zod", version: "4.6.7" }],
+      focusPath: "src/status.ts",
+      expectedCount: 1,
+      public: true
+    },
+    {
+      id: "schema-owned-string-values",
+      scenarioId: "imported-enum",
+      title: "Let the schema own its literal value domain",
+      outcome: "no-match",
+      files: [{ path: "src/status.ts", source: "import { z } from 'zod';\nexport const StatusSchema = z.enum(['active', 'inactive']);" }],
+      installedDependencies: [{ module: "zod", version: "4.6.7" }],
+      focusPath: "src/status.ts",
+      expectedCount: 0,
+      public: true
     }
   ]
 };
@@ -17879,7 +17908,7 @@ var PREFER_MODULE_LEVEL_REFINED_SCHEMA_DOCUMENTATION = {
       outcome: "no-match",
       files: [{
         path: "src/options.ts",
-        source: "import { z } from 'zod'; const BatchSizeSchema = z.number().int().min(1).max(1000); export function parse(value: unknown) { return BatchSizeSchema.parse(value); }"
+        source: "import { z } from 'zod'; const NameSchema = z.string().trim().min(1).max(128); export function parse(value: unknown) { return NameSchema.parse(value); }"
       }],
       focusPath: "src/options.ts",
       expectedCount: 0,
@@ -19525,7 +19554,7 @@ var PREFER_SCHEMA_FOR_API_PAYLOAD_DOCUMENTATION = {
     "Test fixtures, generated clients and recognized local-file reads are excluded. This is bounded local analysis, not a general control-flow or mutation proof."
   ],
   examples: [
-    { id: "validated-payload", title: "Validate before property access", outcome: "no-match", files: [{ path: "src/client.ts", source: "async function load(response: Response) { const body = UserSchema.parse(await response.json()); return body.id; }" }], focusPath: "src/client.ts", expectedCount: 0, public: true },
+    { id: "validated-payload", title: "Validate before property access", outcome: "no-match", files: [{ path: "src/client.ts", source: "import { z } from 'zod';\nconst UserSchema = z.object({ id: z.string() });\nasync function load(response: Response) { const body = UserSchema.parse(await response.json()); return body.id; }" }], installedDependencies: [{ module: "zod", version: "4.6.7" }], focusPath: "src/client.ts", expectedCount: 0, public: true },
     { id: "unvalidated-payload", title: "Do not trust response JSON directly", outcome: "match", files: [{ path: "src/client.ts", source: "async function load(response: Response) { const body = await response.json(); return body.id; }" }], focusPath: "src/client.ts", expectedCount: 1, public: true }
   ]
 };
@@ -20201,8 +20230,8 @@ var PREFER_SWITCH_FOR_REPEATED_EQUALITY_DOCUMENTATION = {
     "The rule deliberately ignores compound predicates, loose equality, ranges, and chains that compare different discriminants."
   ],
   examples: [
-    { id: "switch-dispatch", title: "Make finite dispatch explicit", outcome: "no-match", files: [{ path: "src/render.ts", source: "switch (kind) { case 'a': return a(); case 'b': return b(); case 'c': return c(); default: return fallback(); }" }], focusPath: "src/render.ts", expectedCount: 0, public: true },
-    { id: "repeated-equality", title: "Avoid repeating the discriminant", outcome: "match", files: [{ path: "src/render.ts", source: "function render(kind: string) { if (kind === 'a') return a(); else if (kind === 'b') return b(); else if (kind === 'c') return c(); }" }], focusPath: "src/render.ts", expectedCount: 1, public: true },
+    { id: "switch-dispatch", title: "Make finite dispatch explicit", outcome: "no-match", files: [{ path: "src/render.ts", source: "function render(kind: string) { switch (kind) { case 'a': return 'alpha'; case 'b': return 'beta'; case 'c': return 'gamma'; default: return 'unknown'; } }" }], focusPath: "src/render.ts", expectedCount: 0, public: true },
+    { id: "repeated-equality", title: "Avoid repeating the discriminant", outcome: "match", files: [{ path: "src/render.ts", source: "function render(kind: string) { if (kind === 'a') return 'alpha'; else if (kind === 'b') return 'beta'; else if (kind === 'c') return 'gamma'; return 'unknown'; }" }], focusPath: "src/render.ts", expectedCount: 1, public: true },
     { id: "escaped-middle", scenarioId: "native-discriminant", title: "Use native identifier identity", outcome: "match", files: [{ path: "src/dispatch.ts", source: `function probe(kind){if(kind==='a')return 1;else if(\\u006bind==='b')return 2;else if(kind==='c')return 3;return 0;}
 console.log(JSON.stringify(["a","b","c","d"].map(probe)));` }], focusPath: "src/dispatch.ts", expectedCount: 1, public: true },
     { id: "different-discriminants", scenarioId: "native-discriminant", title: "Use native identifier identity", outcome: "no-match", files: [{ path: "src/dispatch.ts", source: `function probe(kind){const other="other";if(kind==='a')return 1;else if(other==='b')return 2;else if(kind==='c')return 3;return 0;}
@@ -22747,7 +22776,7 @@ var REQUIRE_ASSERT_NEVER_DOCUMENTATION = {
   category: "correctness",
   limitations: ["Requires type information and singleton case values covering the current union. The helper must accept never to provide a compile-time check; its spelling alone is not a proof of that contract. Review the desired runtime behavior for unexpected external values."],
   examples: [
-    { id: "assert-never-default", title: "Make the default exhaustive", outcome: "no-match", files: [{ path: "src/render.ts", source: "declare const kind: 'a' | 'b';\nswitch (kind) { case 'a': break; case 'b': break; default: assertNever(kind); }" }], focusPath: "src/render.ts", expectedCount: 0, public: true },
+    { id: "assert-never-default", title: "Make the default exhaustive", outcome: "no-match", files: [{ path: "src/render.ts", source: "function assertNever(value: never): never { throw new Error(`Unexpected kind: ${String(value)}`); }\ndeclare const kind: 'a' | 'b';\nswitch (kind) { case 'a': break; case 'b': break; default: assertNever(kind); }" }], focusPath: "src/render.ts", expectedCount: 0, public: true },
     { id: "empty-default", title: "Do not leave an exhaustive default empty", outcome: "match", files: [{ path: "src/render.ts", source: "declare const kind: 'a' | 'b';\nswitch (kind) { case 'a': break; case 'b': break; default: }" }], focusPath: "src/render.ts", expectedCount: 1, public: true }
   ]
 };

package/dist/rule-examples.cjs

@@ -48,6 +48,7 @@ async function verifyRuleExamples(rule, setup = {}) {
     try {
       for (const file of example.files) {
         const path = fixturePath(root, file.path);
+        validateFixtureSyntax(example.id, file, path);
         await (0, import_promises.mkdir)((0, import_node_path.dirname)(path), { recursive: true });
         await (0, import_promises.writeFile)(path, file.source);
       }
@@ -92,6 +93,14 @@ function fixturePath(root, path) {
   if (!resolved.startsWith(root + import_node_path.sep)) throw new Error(`unsafe example path: ${path}`);
   return resolved;
 }
+function validateFixtureSyntax(exampleId, file, path) {
+  if (!/\.[cm]?[jt]sx?$/u.test(file.path)) return;
+  try {
+    parser.parse(file.source, { filePath: path });
+  } catch (error) {
+    throw new Error(`${exampleId}: invalid fixture ${file.path}`, { cause: error });
+  }
+}
 async function verifyExample(linter, config, example, root, ruleId) {
   const focus = example.files.find((file) => file.path === example.focusPath);
   if (focus === void 0) throw new Error(`${example.id}: focus file is missing`);
@@ -100,6 +109,19 @@ async function verifyExample(linter, config, example, root, ruleId) {
   if (messages.some((message) => message.fatal || message.ruleId !== ruleId)) {
     throw new Error(`${example.id}: invalid fixture: ${messages.map((message) => message.message).join("; ")}`);
   }
+  const lines = linter.getSourceCode().lines;
+  if (messages.some((message) => !physicalDiagnosticLocation(message, lines))) {
+    throw new Error(`${example.id}: invalid diagnostic location`);
+  }
+  const locations = messages.map((message) => JSON.stringify([
+    message.ruleId,
+    message.messageId ?? message.message,
+    message.line,
+    message.column,
+    message.endLine,
+    message.endColumn
+  ]));
+  if (new Set(locations).size !== locations.length) throw new Error(`${example.id}: duplicate diagnostic`);
   if (messages.length !== example.expectedCount) {
     throw new Error(`${example.id}: expected ${example.expectedCount} findings, received ${messages.length}`);
   }
@@ -116,6 +138,17 @@ async function verifyExample(linter, config, example, root, ruleId) {
     }
   }
 }
+function physicalDiagnosticLocation(message, lines) {
+  if (!physicalPosition(lines, message.line, message.column)) return false;
+  if (message.endLine === void 0 && message.endColumn === void 0) return true;
+  if (!physicalPosition(lines, message.endLine, message.endColumn)) return false;
+  return message.endLine !== void 0 && message.endColumn !== void 0 && (message.endLine > message.line || message.endLine === message.line && message.endColumn >= message.column);
+}
+function physicalPosition(lines, line, column) {
+  if (line === void 0 || column === void 0 || !Number.isInteger(line) || !Number.isInteger(column)) return false;
+  const text = lines[line - 1];
+  return text !== void 0 && column >= 1 && column <= text.length + 1;
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   verifyRuleExamples

package/dist/rule-examples.js

@@ -14,6 +14,7 @@ async function verifyRuleExamples(rule, setup = {}) {
     try {
       for (const file of example.files) {
         const path = fixturePath(root, file.path);
+        validateFixtureSyntax(example.id, file, path);
         await mkdir(dirname(path), { recursive: true });
         await writeFile(path, file.source);
       }
@@ -58,6 +59,14 @@ function fixturePath(root, path) {
   if (!resolved.startsWith(root + sep)) throw new Error(`unsafe example path: ${path}`);
   return resolved;
 }
+function validateFixtureSyntax(exampleId, file, path) {
+  if (!/\.[cm]?[jt]sx?$/u.test(file.path)) return;
+  try {
+    parser.parse(file.source, { filePath: path });
+  } catch (error) {
+    throw new Error(`${exampleId}: invalid fixture ${file.path}`, { cause: error });
+  }
+}
 async function verifyExample(linter, config, example, root, ruleId) {
   const focus = example.files.find((file) => file.path === example.focusPath);
   if (focus === void 0) throw new Error(`${example.id}: focus file is missing`);
@@ -66,6 +75,19 @@ async function verifyExample(linter, config, example, root, ruleId) {
   if (messages.some((message) => message.fatal || message.ruleId !== ruleId)) {
     throw new Error(`${example.id}: invalid fixture: ${messages.map((message) => message.message).join("; ")}`);
   }
+  const lines = linter.getSourceCode().lines;
+  if (messages.some((message) => !physicalDiagnosticLocation(message, lines))) {
+    throw new Error(`${example.id}: invalid diagnostic location`);
+  }
+  const locations = messages.map((message) => JSON.stringify([
+    message.ruleId,
+    message.messageId ?? message.message,
+    message.line,
+    message.column,
+    message.endLine,
+    message.endColumn
+  ]));
+  if (new Set(locations).size !== locations.length) throw new Error(`${example.id}: duplicate diagnostic`);
   if (messages.length !== example.expectedCount) {
     throw new Error(`${example.id}: expected ${example.expectedCount} findings, received ${messages.length}`);
   }
@@ -82,6 +104,17 @@ async function verifyExample(linter, config, example, root, ruleId) {
     }
   }
 }
+function physicalDiagnosticLocation(message, lines) {
+  if (!physicalPosition(lines, message.line, message.column)) return false;
+  if (message.endLine === void 0 && message.endColumn === void 0) return true;
+  if (!physicalPosition(lines, message.endLine, message.endColumn)) return false;
+  return message.endLine !== void 0 && message.endColumn !== void 0 && (message.endLine > message.line || message.endLine === message.line && message.endColumn >= message.column);
+}
+function physicalPosition(lines, line, column) {
+  if (line === void 0 || column === void 0 || !Number.isInteger(line) || !Number.isInteger(column)) return false;
+  const text = lines[line - 1];
+  return text !== void 0 && column >= 1 && column <= text.length + 1;
+}
 export {
   verifyRuleExamples
 };

package/package.json

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