@sarj/eslint-plugin 16.35.1 → 16.36.0

package/dist/index.js

@@ -108,7 +108,9 @@ function nativeSpec(config, documentation) {
     throw new TypeError("rule references must use https");
   }
   const examples = [...documentation.examples ?? []];
-  examples.forEach(validateExample);
+  const messageIds = Object.keys(meta2.messages).sort();
+  const knownMessages = new Set(messageIds);
+  examples.forEach((example) => validateExample(example, knownMessages));
   assertUnique(examples.map((example) => example.id), "rule example IDs");
   const publicExamples = examples.filter((example) => example.public === true);
   const scenarios = new Set(publicExamples.map((example) => example.scenarioId ?? "primary"));
@@ -119,7 +121,6 @@ function nativeSpec(config, documentation) {
       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);
   const spec = {
     engine: "eslint",
@@ -155,7 +156,7 @@ function optionsSchema(value) {
 function isObject(value) {
   return value !== null && typeof value === "object";
 }
-function validateExample(example) {
+function validateExample(example, messageIds) {
   if (!KEBAB_CASE.test(example.id)) {
     throw new TypeError("example ID must be lowercase kebab-case");
   }
@@ -190,6 +191,58 @@ function validateExample(example) {
     throw new TypeError("example focus path must name one example file");
   }
   assertUnique((example.fixedFiles ?? []).map((file) => file.path), "fixed example file paths");
+  if (example.expectedDiagnostics !== void 0) {
+    validateExpectedDiagnostics(example.expectedDiagnostics, example, messageIds);
+  }
+}
+function validateExpectedDiagnostics(value, example, messageIds) {
+  if (!Array.isArray(value) || value.length !== example.expectedCount) {
+    throw new TypeError(`${example.id}: expectedDiagnostics must be an array matching expectedCount`);
+  }
+  const diagnostics = value;
+  for (const diagnostic of diagnostics) {
+    validateExpectedDiagnostic(diagnostic, example.id, messageIds);
+  }
+}
+function validateExpectedDiagnostic(value, exampleId, messageIds) {
+  if (!isObject(value) || !("messageId" in value) || typeof value.messageId !== "string" || !messageIds.has(value.messageId) || !("message" in value) || typeof value.message !== "string" || !("location" in value) || !("automaticFix" in value) || typeof value.automaticFix !== "boolean" || !("suggestions" in value) || !Array.isArray(value.suggestions)) {
+    throw new TypeError(`${exampleId}: invalid expected diagnostic identity, message or delivery`);
+  }
+  assertFields(value, ["messageId", "message", "location", "automaticFix", "suggestions"], exampleId);
+  validateExpectedLocation(value.location, exampleId);
+  const suggestions = value.suggestions;
+  for (const suggestion of suggestions) {
+    validateExpectedSuggestion(suggestion, exampleId, messageIds);
+  }
+}
+function validateExpectedSuggestion(value, exampleId, messageIds) {
+  if (!isObject(value) || !("messageId" in value) || typeof value.messageId !== "string" || !messageIds.has(value.messageId) || !("output" in value) || typeof value.output !== "string") {
+    throw new TypeError(`${exampleId}: invalid expected suggestion identity or output`);
+  }
+  assertFields(value, ["messageId", "output"], exampleId);
+}
+function validateExpectedLocation(value, exampleId) {
+  if (!isObject(value) || !("line" in value) || !positiveCoordinate(value.line) || !("column" in value) || !positiveCoordinate(value.column)) {
+    throw new TypeError(`${exampleId}: expected diagnostic location requires positive integer coordinates`);
+  }
+  if (!("end" in value)) {
+    assertFields(value, ["line", "column"], exampleId);
+    return;
+  }
+  if (!isObject(value.end) || !("line" in value.end) || !positiveCoordinate(value.end.line) || !("column" in value.end) || !positiveCoordinate(value.end.column) || value.end.line < value.line || value.end.line === value.line && value.end.column < value.column) {
+    throw new TypeError(`${exampleId}: expected diagnostic end point must be complete and ordered`);
+  }
+  assertFields(value.end, ["line", "column"], exampleId);
+  assertFields(value, ["line", "column", "end"], exampleId);
+}
+function positiveCoordinate(value) {
+  return typeof value === "number" && Number.isSafeInteger(value) && value >= 1;
+}
+function assertFields(value, expected, exampleId) {
+  const fields2 = Object.keys(value);
+  if (fields2.length !== expected.length || fields2.some((field) => !expected.includes(field))) {
+    throw new TypeError(`${exampleId}: unexpected or missing diagnostic expectation fields`);
+  }
 }
 function assertSafeRelativePath(path, label) {
   if (path.length === 0 || path.startsWith("/") || path.startsWith("\\") || /^[A-Za-z]:[\\/]/u.test(path) || path.split(/[\\/]/u).includes("..")) {
@@ -3853,7 +3906,7 @@ function isSearchParamReceiver(call, services) {
 // package.json
 var package_default = {
   name: "@sarj/eslint-plugin",
-  version: "16.35.1",
+  version: "16.36.0",
   packageManager: "npm@12.2.1",
   description: "Custom ESLint rules for hypermodern TypeScript / React / Next.js projects",
   type: "module",
@@ -17934,7 +17987,23 @@ var NO_RESTRICTED_LIBRARY_LOAD_DOCUMENTATION = {
   examples: [
     { 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" }] }] }
+    { 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" }] }] },
+    {
+      id: "checked-runtime-load",
+      title: "Identify the exact restricted runtime argument",
+      outcome: "match",
+      files: [{ path: "src/client.ts", source: "const client = require('axios');" }],
+      focusPath: "src/client.ts",
+      expectedCount: 1,
+      ruleOptions: [{ libraries: [{ id: "LIB101", module: "axios", replacement: "Ky" }] }],
+      expectedDiagnostics: [{
+        messageId: "restrictedLibraryLoad",
+        message: "LIB101: Replace this runtime dependency reference to axios with Ky.",
+        location: { line: 1, column: 24, end: { line: 1, column: 31 } },
+        automaticFix: false,
+        suggestions: []
+      }]
+    }
   ]
 };
 function staticModule(node) {
@@ -27341,6 +27410,16 @@ var PREFER_NATIVE_RANDOM_UUID_DOCUMENTATION = {
       ],
       focusPath: "src/ids.ts",
       expectedCount: 1,
+      expectedDiagnostics: [{
+        messageId: "preferNative",
+        message: "Where supported by the deployment runtime, prefer native `globalThis.crypto.randomUUID()` over the `uuid` package for UUID v4.",
+        location: { line: 1, column: 175, end: { line: 1, column: 179 } },
+        automaticFix: true,
+        suggestions: [{
+          messageId: "replaceWithNative",
+          output: "import { v4, NIL } from 'uuid'; const nativeUuid = crypto.randomUUID.bind(crypto); function nativeId(): string { return nativeUuid(); } function packageId(): string { return globalThis.crypto.randomUUID(); } export function ids(): string[] { return [nativeId(), packageId(), NIL]; }"
+        }]
+      }],
       fixedFiles: [
         {
           path: "src/ids.ts",
@@ -27348,6 +27427,24 @@ var PREFER_NATIVE_RANDOM_UUID_DOCUMENTATION = {
         }
       ],
       public: false
+    },
+    {
+      id: "uuid-v4-suggestion-only",
+      title: "Keep the unproven native replacement as a suggestion",
+      outcome: "match",
+      files: [{ path: "src/id.ts", source: "import { v4 } from 'uuid'; const id = v4();" }],
+      focusPath: "src/id.ts",
+      expectedCount: 1,
+      expectedDiagnostics: [{
+        messageId: "preferNative",
+        message: "Where supported by the deployment runtime, prefer native `globalThis.crypto.randomUUID()` over the `uuid` package for UUID v4.",
+        location: { line: 1, column: 39, end: { line: 1, column: 43 } },
+        automaticFix: false,
+        suggestions: [{
+          messageId: "replaceWithNative",
+          output: "import { v4 } from 'uuid'; const id = globalThis.crypto.randomUUID();"
+        }]
+      }]
     }
   ]
 };
@@ -28400,7 +28497,35 @@ var PREFER_NULLISH_FILTER_PREDICATE_DOCUMENTATION = {
       files: [{ path: "src/autofix-example.ts", source: "const present = [{ id: 'kept' }, null].filter(Boolean);" }],
       fixedFiles: [{ path: "src/autofix-example.ts", source: "const present = [{ id: 'kept' }, null].filter((value) => value !== null && value !== undefined);" }],
       focusPath: "src/autofix-example.ts",
-      expectedCount: 1
+      expectedCount: 1,
+      expectedDiagnostics: [{
+        messageId: "preferNullishPredicate",
+        message: "This built-in array contains only nullish or provably truthy values, so `filter(Boolean)` preserves runtime values but loses nullish narrowing. Use an explicit nullish predicate.",
+        location: { line: 1, column: 47, end: { line: 1, column: 54 } },
+        automaticFix: true,
+        suggestions: [{
+          messageId: "replaceBoolean",
+          output: "const present = [{ id: 'kept' }, null].filter((value) => value !== null && value !== undefined);"
+        }]
+      }]
+    },
+    {
+      id: "nonfresh-suggestion-only",
+      title: "Suggest a nullish predicate without assuming a fresh receiver",
+      outcome: "match",
+      files: [{ path: "src/users.ts", source: "declare const users: readonly ({ id: string } | null)[];\nconst present = users.filter(Boolean);" }],
+      focusPath: "src/users.ts",
+      expectedCount: 1,
+      expectedDiagnostics: [{
+        messageId: "preferNullishPredicate",
+        message: "This built-in array contains only nullish or provably truthy values, so `filter(Boolean)` preserves runtime values but loses nullish narrowing. Use an explicit nullish predicate.",
+        location: { line: 2, column: 30, end: { line: 2, column: 37 } },
+        automaticFix: false,
+        suggestions: [{
+          messageId: "replaceBoolean",
+          output: "declare const users: readonly ({ id: string } | null)[];\nconst present = users.filter((value) => value !== null && value !== undefined);"
+        }]
+      }]
     }
   ]
 };
@@ -35972,335 +36097,214 @@ var LIBRARY_IMPORT_POLICY = ["error", {
   paths: LIBRARY_POLICY.map(({ module, note }) => ({ name: module, message: note })),
   patterns: LIBRARY_POLICY.map(({ module, note }) => ({ group: [`${module}/*`], message: note }))
 }];
-var ADVISORY_RULES = [
-  "@sarj/excessive-commentary",
-  "@sarj/no-bespoke-api-case-conversion",
-  "@sarj/no-boolean-selector-parameter",
-  "@sarj/no-cors-wildcard-with-credentials",
-  "@sarj/no-credential-in-browser-storage",
-  "@sarj/no-discarded-validation-result",
-  "@sarj/no-exception-text-in-5xx-response",
-  "@sarj/no-excess-jsx-props",
-  "@sarj/no-generic-json-parser",
-  "@sarj/no-mutating-container-transform",
-  "@sarj/no-mutating-input-with-result",
-  "@sarj/no-negative-only-http-status-assertion",
-  "@sarj/no-numeric-search-param-coercion",
-  "@sarj/no-redundant-consumer-union",
-  "@sarj/no-redundant-local-alias",
-  "@sarj/no-restated-comment",
-  "@sarj/no-restated-jsdoc",
-  "@sarj/no-return-disposed-resource",
-  "@sarj/no-test-comments",
-  "@sarj/prefer-dependency-interface",
-  "@sarj/prefer-discriminated-union",
-  "@sarj/prefer-millisecond-control-duration-schema",
-  "@sarj/prefer-minimal-parameter-contract",
-  "@sarj/prefer-module-level-refined-schema",
-  "@sarj/prefer-native-fetch-in-server-actions",
-  "@sarj/prefer-node-crypto-hash",
-  "@sarj/prefer-node-fs-promises",
-  "@sarj/prefer-shared-zod-enum",
-  "@sarj/prefer-test-fixture-reuse",
-  "@sarj/prefer-whole-object-assertion",
-  "@sarj/prefer-zod-parse-output-type",
-  "@sarj/production-derived-test-cases",
-  "@sarj/require-constrained-schema-integer",
-  "@sarj/require-jwt-lifetime",
-  "@sarj/require-sql-access-class"
-];
-var RECOMMENDED_RULES = {
-  "@sarj/no-excess-jsx-props": "warn",
-  "@sarj/no-redundant-consumer-union": "warn",
-  "@sarj/prefer-minimal-parameter-contract": "warn",
-  "@sarj/named-child-schema-type": "error",
-  "@sarj/no-conditional-empty-object-spread": "error",
-  "@sarj/prefer-typed-reflection": "error",
-  "@sarj/no-broad-return-type": "error",
-  "@sarj/no-reduce-accumulator-copy": "error",
-  "@sarj/no-known-value-widening": "error",
-  "@sarj/no-invalid-typed-mutation": "error",
-  "@sarj/no-contradictory-type-predicate": "error",
-  "@sarj/no-partial-type-predicate": "error",
-  "@sarj/no-boolean-selector-parameter": "warn",
-  "@sarj/no-invalid-zod-custom-parse": "error",
-  "@sarj/no-contradictory-overload-return": "error",
-  "@sarj/require-button-accessible-name": "error",
-  "@sarj/require-camelcase-properties": "error",
-  "@sarj/require-svg-accessible-name": "error",
-  "@sarj/prefer-logical-tailwind-utilities": ["error", { enabled: false }],
-  "@sarj/no-unlocalized-toast": ["error", { enabled: false }],
-  "@sarj/no-unlocalized-jsx-attributes": ["error", { enabled: false }],
-  "@sarj/no-unlocalized-jsx-text": ["error", { enabled: false }],
-  "no-restricted-imports": LIBRARY_IMPORT_POLICY,
-  "@sarj/no-restricted-library-load": ["error", { libraries: LIBRARY_POLICY }],
-  "@sarj/no-redundant-local-alias": "warn",
-  "@sarj/prefer-test-fixture-reuse": "warn",
-  "@sarj/no-negative-only-http-status-assertion": "warn",
-  "@sarj/no-mutating-input-with-result": "warn",
-  "@sarj/no-return-disposed-resource": "warn",
-  "@sarj/no-discarded-validation-result": "warn",
-  "@sarj/require-jwt-lifetime": "warn",
-  "@sarj/prefer-dependency-interface": "warn",
-  "@sarj/no-generic-json-parser": "warn",
-  "@sarj/require-constrained-schema-integer": "warn",
-  "@sarj/production-derived-test-cases": "warn",
-  "@sarj/no-test-comments": "warn",
-  "@sarj/no-mutating-container-transform": "warn",
-  "@sarj/prefer-native-random-uuid": "error",
-  "@sarj/prefer-shadcn-primitives": "error",
-  "@sarj/excessive-commentary": "warn",
-  "@sarj/no-excessive-cognitive-complexity": "error",
-  "@sarj/interface-contract-members-private": "error",
-  "@sarj/iac-source-coupled-test": "error",
-  "@sarj/duplicate-test-body": "error",
-  "@sarj/enforce-file-structure": "error",
-  "@sarj/no-client-side-data-fetching": "error",
-  "@sarj/no-comment-cruft": "error",
-  "@sarj/no-cors-wildcard-with-credentials": "warn",
-  "@sarj/no-dynamic-sql": "error",
-  "@sarj/no-fat-try-blocks": ["error", { max: 5 }],
-  "@sarj/no-hand-rolled-sleep": "error",
-  "@sarj/no-hand-rolled-spinner": "error",
-  "@sarj/no-insecure-random-id": "error",
-  "@sarj/no-exception-text-in-5xx-response": "warn",
-  "@sarj/no-json-stringify-error": "error",
-  "@sarj/no-impossible-zod-literal-bounds": "error",
-  "@sarj/no-in-operator-on-built-in-collections": "error",
-  "@sarj/no-log-only-catch": "error",
-  "@sarj/no-bare-return-from-test-catch": "error",
-  "@sarj/no-bespoke-api-case-conversion": "warn",
-  "@sarj/no-detached-global-fetch": "error",
-  "@sarj/no-json-stringify-object-equality": "error",
-  "@sarj/no-dangerously-allow-svg": "error",
-  "@sarj/no-credential-in-browser-storage": "warn",
-  "@sarj/no-numeric-search-param-coercion": "warn",
-  "@sarj/prefer-native-fetch-in-server-actions": "warn",
-  "@sarj/no-duplicate-lifecycle-refresh-listeners": "error",
-  "@sarj/no-long-comment": "error",
-  "@sarj/no-vague-suppression-description": "error",
-  "@sarj/no-generic-single-export-module": "error",
-  "@sarj/no-offset-pagination": "error",
-  "@sarj/no-positional-tuple-return": "error",
-  "@sarj/no-production-browser-source-maps": "error",
-  "@sarj/no-repeated-string-literal": "error",
-  "@sarj/no-redundant-optional-array-default": "error",
-  "@sarj/no-router-refresh-polling": "error",
-  "@sarj/no-restated-comment": "warn",
-  "@sarj/no-restated-jsdoc": "warn",
-  "@sarj/no-secret-in-log": "error",
-  "@sarj/no-server-env-in-client-component": "error",
-  "@sarj/no-select-star": "error",
-  "@sarj/no-sentinel-return-on-catch": "error",
-  "@sarj/no-silent-promise-catch": "error",
-  "@sarj/no-sleep-in-test-body": "error",
-  "@sarj/no-string-concat-in-loop": "error",
-  "@sarj/no-tautological-expect": "error",
-  "@sarj/no-duplicate-test-case": "error",
-  "@sarj/no-typed-doc-sections": "error",
-  "@sarj/no-trailing-value-narration": "error",
-  "@sarj/no-declaration-comment-wall": "error",
-  "@sarj/no-union-in-comment": "error",
-  "@sarj/no-type-member-comment-wall": "error",
-  "@sarj/no-unnecessary-use-client": "error",
-  "@sarj/no-unsafe-mock-casting": "error",
-  "@sarj/no-unsafe-test-double-cast": "error",
-  "@sarj/no-first-party-module-mock": "error",
-  "@sarj/no-zod-native-enum": "error",
-  "@sarj/test-loops-over-literal-cases": "error",
-  "@sarj/prefer-constant-time-secret-compare": "error",
-  "@sarj/prefer-ecmascript-private-members": "error",
-  "@sarj/prefer-discriminated-union": "warn",
-  "@sarj/prefer-input-group-search": "error",
-  "@sarj/prefer-millisecond-control-duration-schema": "warn",
-  "@sarj/prefer-immutable-module-constant": "error",
-  "@sarj/prefer-module-level-constant": "error",
-  "@sarj/prefer-module-level-schema": "error",
-  "@sarj/prefer-module-level-refined-schema": "warn",
-  "@sarj/prefer-multi-value-zod-literal": ["error", { zodMajorVersion: 4 }],
-  "@sarj/prefer-named-callback-domain": "error",
-  "@sarj/prefer-nominal-id-types": "error",
-  "@sarj/prefer-named-complex-return-type": "error",
-  "@sarj/prefer-node-crypto-hash": "warn",
-  "@sarj/prefer-node-fs-promises": "warn",
-  "@sarj/prefer-non-nullable-collection": "error",
-  "@sarj/prefer-nullish-filter-predicate": "error",
-  "@sarj/prefer-await-in-async-return": "error",
-  "@sarj/prefer-schema-for-api-payload": "error",
-  "@sarj/prefer-shared-zod-enum": "warn",
-  "@sarj/prefer-switch-for-repeated-equality": "error",
-  "@sarj/prefer-semantic-colors": ["error", { requireSemanticTokens: true }],
-  "@sarj/prefer-server-actions": "error",
-  "@sarj/prefer-whole-object-assertion": "warn",
-  "@sarj/repeated-static-call-cases": "error",
-  "@sarj/prefer-zod-infer": "error",
-  "@sarj/prefer-zod-parse-output-type": "warn",
-  "@sarj/require-assert-never": "error",
-  "@sarj/require-fetch-timeout": "error",
-  "@sarj/require-explicit-contract-implementation": "error",
-  "@sarj/require-explicit-service-contract": "error",
-  "@sarj/require-interface-for-exported-class": "error",
-  "@sarj/require-port-for-service": "error",
-  "@sarj/require-sql-access-class": "warn",
-  "@sarj/require-static-next-matcher": "error",
-  "@sarj/require-use-form-default-values": "error",
-  "@sarj/require-use-server-in-actions-file": "error",
-  "@sarj/require-zod-form-validation": "error",
-  "@sarj/store-insert-requires-on-conflict": "error",
-  "@sarj/stepdown": "error",
-  "@sarj/source-coupled-test": "error",
-  "@sarj/sole-export-matches-filename": "error",
-  "@sarj/test-phase-label-comment": "error",
-  "@sarj/require-pascal-case-zod-schema-name": "error"
-};
-var STRICT_RULES = {
-  "@sarj/no-discarded-validation-result": "warn",
-  "@sarj/no-generic-json-parser": "warn",
-  "@sarj/no-mutating-container-transform": "warn",
-  "@sarj/no-mutating-input-with-result": "warn",
-  "@sarj/no-negative-only-http-status-assertion": "warn",
-  "@sarj/no-redundant-local-alias": "warn",
-  "@sarj/no-return-disposed-resource": "warn",
-  "@sarj/no-test-comments": "warn",
-  "@sarj/prefer-dependency-interface": "warn",
-  "@sarj/prefer-test-fixture-reuse": "warn",
-  "@sarj/production-derived-test-cases": "warn",
-  "@sarj/require-constrained-schema-integer": "warn",
-  "@sarj/require-jwt-lifetime": "warn",
-  "@sarj/no-excess-jsx-props": "warn",
-  "@sarj/no-redundant-consumer-union": "warn",
-  "@sarj/prefer-minimal-parameter-contract": "warn",
-  "@sarj/named-child-schema-type": "error",
-  "@sarj/no-conditional-empty-object-spread": "error",
-  "@sarj/prefer-typed-reflection": "error",
-  "@sarj/no-broad-return-type": "error",
-  "@sarj/no-reduce-accumulator-copy": "error",
-  "@sarj/no-known-value-widening": "error",
-  "@sarj/no-invalid-typed-mutation": "error",
-  "@sarj/no-contradictory-type-predicate": "error",
-  "@sarj/no-partial-type-predicate": "error",
-  "@sarj/no-boolean-selector-parameter": "warn",
-  "@sarj/no-invalid-zod-custom-parse": "error",
-  "@sarj/no-contradictory-overload-return": "error",
-  "@sarj/require-button-accessible-name": "error",
-  "@sarj/require-camelcase-properties": "error",
-  "@sarj/require-svg-accessible-name": "error",
-  "@sarj/prefer-logical-tailwind-utilities": ["error", { enabled: false }],
-  "@sarj/no-unlocalized-toast": ["error", { enabled: false }],
-  "@sarj/no-unlocalized-jsx-attributes": ["error", { enabled: false }],
-  "@sarj/no-unlocalized-jsx-text": ["error", { enabled: false }],
-  "no-restricted-imports": LIBRARY_IMPORT_POLICY,
-  "@sarj/no-restricted-library-load": ["error", { libraries: LIBRARY_POLICY }],
-  "@sarj/prefer-native-random-uuid": "error",
-  "@sarj/prefer-shadcn-primitives": "error",
-  "@sarj/excessive-commentary": "warn",
-  "@sarj/no-excessive-cognitive-complexity": "error",
-  "@sarj/interface-contract-members-private": "error",
-  "@sarj/iac-source-coupled-test": "error",
-  "@sarj/duplicate-test-body": "error",
-  "@sarj/enforce-file-structure": "error",
-  "@sarj/no-client-side-data-fetching": "error",
-  "@sarj/no-comment-cruft": "error",
-  "@sarj/no-cors-wildcard-with-credentials": "warn",
-  "@sarj/no-dynamic-sql": "error",
-  "@sarj/no-enum": "error",
-  "@sarj/no-fat-try-blocks": ["error", { max: 5 }],
-  "@sarj/no-hand-rolled-sleep": "error",
-  "@sarj/no-hand-rolled-spinner": "error",
-  "@sarj/no-insecure-random-id": "error",
-  "@sarj/no-exception-text-in-5xx-response": "warn",
-  "@sarj/no-json-stringify-error": "error",
-  "@sarj/no-impossible-zod-literal-bounds": "error",
-  "@sarj/no-in-operator-on-built-in-collections": "error",
-  "@sarj/no-log-only-catch": "error",
-  "@sarj/no-bare-return-from-test-catch": "error",
-  "@sarj/no-bespoke-api-case-conversion": "warn",
-  "@sarj/no-detached-global-fetch": "error",
-  "@sarj/no-json-stringify-object-equality": "error",
-  "@sarj/no-dangerously-allow-svg": "error",
-  "@sarj/no-credential-in-browser-storage": "warn",
-  "@sarj/no-numeric-search-param-coercion": "warn",
-  "@sarj/prefer-native-fetch-in-server-actions": "warn",
-  "@sarj/no-duplicate-lifecycle-refresh-listeners": "error",
-  "@sarj/no-long-comment": "error",
-  "@sarj/no-vague-suppression-description": "error",
-  "@sarj/no-generic-single-export-module": "error",
-  "@sarj/no-offset-pagination": "error",
-  "@sarj/no-positional-tuple-return": "error",
-  "@sarj/no-production-browser-source-maps": "error",
-  "@sarj/no-raw-env": "error",
-  "@sarj/no-raw-fetch-outside-clients": "error",
-  "@sarj/no-repeated-string-literal": "error",
-  "@sarj/no-redundant-optional-array-default": "error",
-  "@sarj/no-router-refresh-polling": "error",
-  "@sarj/no-restated-comment": "warn",
-  "@sarj/no-restated-jsdoc": "warn",
-  "@sarj/no-secret-in-log": "error",
-  "@sarj/no-server-env-in-client-component": "error",
-  "@sarj/no-select-star": "error",
-  "@sarj/no-sentinel-return-on-catch": "error",
-  "@sarj/no-silent-promise-catch": "error",
-  "@sarj/no-sleep-in-test-body": "error",
-  "@sarj/no-storage-in-stateless-modules": "error",
-  "@sarj/no-string-concat-in-loop": "error",
-  "@sarj/no-tautological-expect": "error",
-  "@sarj/no-duplicate-test-case": "error",
-  "@sarj/no-typed-doc-sections": "error",
-  "@sarj/no-trailing-value-narration": "error",
-  "@sarj/no-declaration-comment-wall": "error",
-  "@sarj/no-union-in-comment": "error",
-  "@sarj/no-type-member-comment-wall": "error",
-  "@sarj/no-unnecessary-use-client": "error",
-  "@sarj/no-unsafe-mock-casting": "error",
-  "@sarj/no-unsafe-test-double-cast": "error",
-  "@sarj/no-first-party-module-mock": "error",
-  "@sarj/no-zod-native-enum": "error",
-  "@sarj/test-loops-over-literal-cases": "error",
-  "@sarj/prefer-constant-time-secret-compare": "error",
-  "@sarj/prefer-ecmascript-private-members": "error",
-  "@sarj/prefer-discriminated-union": "warn",
-  "@sarj/prefer-input-group-search": "error",
-  "@sarj/prefer-millisecond-control-duration-schema": "warn",
-  "@sarj/prefer-immutable-module-constant": "error",
-  "@sarj/prefer-module-level-constant": "error",
-  "@sarj/prefer-module-level-schema": "error",
-  "@sarj/prefer-module-level-refined-schema": "warn",
-  "@sarj/prefer-multi-value-zod-literal": ["error", { zodMajorVersion: 4 }],
-  "@sarj/prefer-named-callback-domain": "error",
-  "@sarj/prefer-nominal-id-types": "error",
-  "@sarj/prefer-named-complex-return-type": "error",
-  "@sarj/prefer-node-crypto-hash": "warn",
-  "@sarj/prefer-node-fs-promises": "warn",
-  "@sarj/prefer-non-nullable-collection": "error",
-  "@sarj/prefer-nullish-filter-predicate": "error",
-  "@sarj/prefer-await-in-async-return": "error",
-  "@sarj/prefer-schema-for-api-payload": "error",
-  "@sarj/prefer-shared-zod-enum": "warn",
-  "@sarj/prefer-switch-for-repeated-equality": "error",
-  "@sarj/prefer-semantic-colors": ["error", { requireSemanticTokens: true }],
-  "@sarj/prefer-server-actions": "error",
-  "@sarj/prefer-whole-object-assertion": "warn",
-  "@sarj/repeated-static-call-cases": "error",
-  "@sarj/prefer-zod-infer": "error",
-  "@sarj/prefer-zod-parse-output-type": "warn",
-  "@sarj/require-assert-never": "error",
-  "@sarj/require-fetch-timeout": "error",
-  "@sarj/require-explicit-contract-implementation": "error",
-  "@sarj/require-explicit-service-contract": "error",
-  "@sarj/require-interface-for-exported-class": "error",
-  "@sarj/require-port-for-service": "error",
-  "@sarj/require-sql-access-class": "warn",
-  "@sarj/require-static-next-matcher": "error",
-  "@sarj/require-use-form-default-values": "error",
-  "@sarj/require-use-server-in-actions-file": "error",
-  "@sarj/require-zod-form-validation": "error",
-  "@sarj/store-insert-requires-on-conflict": "error",
-  "@sarj/stepdown": "error",
-  "@sarj/source-coupled-test": "error",
-  "@sarj/sole-export-matches-filename": "error",
-  "@sarj/test-phase-label-comment": "error",
-  "@sarj/require-pascal-case-zod-schema-name": "error"
+var RULE_POLICY = {
+  "@sarj/no-excess-jsx-props": ["warn", "both"],
+  "@sarj/no-redundant-consumer-union": ["warn", "both"],
+  "@sarj/prefer-minimal-parameter-contract": ["warn", "both"],
+  "@sarj/named-child-schema-type": ["error", "both"],
+  "@sarj/no-conditional-empty-object-spread": ["error", "both"],
+  "@sarj/prefer-typed-reflection": ["error", "both"],
+  "@sarj/no-broad-return-type": ["error", "both"],
+  "@sarj/no-reduce-accumulator-copy": ["error", "both"],
+  "@sarj/no-known-value-widening": ["error", "both"],
+  "@sarj/no-invalid-typed-mutation": ["error", "both"],
+  "@sarj/no-contradictory-type-predicate": ["error", "both"],
+  "@sarj/no-partial-type-predicate": ["error", "both"],
+  "@sarj/no-boolean-selector-parameter": ["warn", "both"],
+  "@sarj/no-invalid-zod-custom-parse": ["error", "both"],
+  "@sarj/no-contradictory-overload-return": ["error", "both"],
+  "@sarj/require-button-accessible-name": ["error", "both"],
+  "@sarj/require-camelcase-properties": ["error", "both"],
+  "@sarj/require-svg-accessible-name": ["error", "both"],
+  "@sarj/prefer-logical-tailwind-utilities": [
+    "error",
+    "both",
+    () => [{ enabled: false }]
+  ],
+  "@sarj/no-unlocalized-toast": [
+    "error",
+    "both",
+    () => [{ enabled: false }]
+  ],
+  "@sarj/no-unlocalized-jsx-attributes": [
+    "error",
+    "both",
+    () => [{ enabled: false }]
+  ],
+  "@sarj/no-unlocalized-jsx-text": [
+    "error",
+    "both",
+    () => [{ enabled: false }]
+  ],
+  "no-restricted-imports": ["shared", "both", LIBRARY_IMPORT_POLICY],
+  "@sarj/no-restricted-library-load": [
+    "error",
+    "both",
+    () => [{ libraries: LIBRARY_POLICY }]
+  ],
+  "@sarj/no-redundant-local-alias": ["warn", "both", "strict-order", 5],
+  "@sarj/prefer-test-fixture-reuse": ["warn", "both", "strict-order", 9],
+  "@sarj/no-negative-only-http-status-assertion": ["warn", "both", "strict-order", 4],
+  "@sarj/no-mutating-input-with-result": ["warn", "both", "strict-order", 3],
+  "@sarj/no-return-disposed-resource": ["warn", "both", "strict-order", 6],
+  "@sarj/no-discarded-validation-result": ["warn", "both", "strict-order", 0],
+  "@sarj/require-jwt-lifetime": ["warn", "both", "strict-order", 12],
+  "@sarj/prefer-dependency-interface": ["warn", "both", "strict-order", 8],
+  "@sarj/no-generic-json-parser": ["warn", "both", "strict-order", 1],
+  "@sarj/require-constrained-schema-integer": ["warn", "both", "strict-order", 11],
+  "@sarj/production-derived-test-cases": ["warn", "both", "strict-order", 10],
+  "@sarj/no-test-comments": ["warn", "both", "strict-order", 7],
+  "@sarj/no-mutating-container-transform": ["warn", "both", "strict-order", 2],
+  "@sarj/prefer-native-random-uuid": ["error", "both"],
+  "@sarj/prefer-shadcn-primitives": ["error", "both"],
+  "@sarj/excessive-commentary": ["warn", "both"],
+  "@sarj/no-excessive-cognitive-complexity": ["error", "both"],
+  "@sarj/interface-contract-members-private": ["error", "both"],
+  "@sarj/iac-source-coupled-test": ["error", "both"],
+  "@sarj/duplicate-test-body": ["error", "both"],
+  "@sarj/enforce-file-structure": ["error", "both"],
+  "@sarj/no-client-side-data-fetching": ["error", "both"],
+  "@sarj/no-comment-cruft": ["error", "both"],
+  "@sarj/no-cors-wildcard-with-credentials": ["warn", "both"],
+  "@sarj/no-dynamic-sql": ["error", "both"],
+  "@sarj/no-enum": ["error", "strict"],
+  "@sarj/no-fat-try-blocks": [
+    "error",
+    "both",
+    () => [{ max: 5 }]
+  ],
+  "@sarj/no-hand-rolled-sleep": ["error", "both"],
+  "@sarj/no-hand-rolled-spinner": ["error", "both"],
+  "@sarj/no-insecure-random-id": ["error", "both"],
+  "@sarj/no-exception-text-in-5xx-response": ["warn", "both"],
+  "@sarj/no-json-stringify-error": ["error", "both"],
+  "@sarj/no-impossible-zod-literal-bounds": ["error", "both"],
+  "@sarj/no-in-operator-on-built-in-collections": ["error", "both"],
+  "@sarj/no-log-only-catch": ["error", "both"],
+  "@sarj/no-bare-return-from-test-catch": ["error", "both"],
+  "@sarj/no-bespoke-api-case-conversion": ["warn", "both"],
+  "@sarj/no-detached-global-fetch": ["error", "both"],
+  "@sarj/no-json-stringify-object-equality": ["error", "both"],
+  "@sarj/no-dangerously-allow-svg": ["error", "both"],
+  "@sarj/no-credential-in-browser-storage": ["warn", "both"],
+  "@sarj/no-numeric-search-param-coercion": ["warn", "both"],
+  "@sarj/prefer-native-fetch-in-server-actions": ["warn", "both"],
+  "@sarj/no-duplicate-lifecycle-refresh-listeners": ["error", "both"],
+  "@sarj/no-long-comment": ["error", "both"],
+  "@sarj/no-vague-suppression-description": ["error", "both"],
+  "@sarj/no-generic-single-export-module": ["error", "both"],
+  "@sarj/no-offset-pagination": ["error", "both"],
+  "@sarj/no-positional-tuple-return": ["error", "both"],
+  "@sarj/no-production-browser-source-maps": ["error", "both"],
+  "@sarj/no-raw-env": ["error", "strict"],
+  "@sarj/no-raw-fetch-outside-clients": ["error", "strict"],
+  "@sarj/no-repeated-string-literal": ["error", "both"],
+  "@sarj/no-redundant-optional-array-default": ["error", "both"],
+  "@sarj/no-router-refresh-polling": ["error", "both"],
+  "@sarj/no-restated-comment": ["warn", "both"],
+  "@sarj/no-restated-jsdoc": ["warn", "both"],
+  "@sarj/no-secret-in-log": ["error", "both"],
+  "@sarj/no-server-env-in-client-component": ["error", "both"],
+  "@sarj/no-select-star": ["error", "both"],
+  "@sarj/no-sentinel-return-on-catch": ["error", "both"],
+  "@sarj/no-silent-promise-catch": ["error", "both"],
+  "@sarj/no-sleep-in-test-body": ["error", "both"],
+  "@sarj/no-storage-in-stateless-modules": ["error", "strict"],
+  "@sarj/no-string-concat-in-loop": ["error", "both"],
+  "@sarj/no-tautological-expect": ["error", "both"],
+  "@sarj/no-duplicate-test-case": ["error", "both"],
+  "@sarj/no-typed-doc-sections": ["error", "both"],
+  "@sarj/no-trailing-value-narration": ["error", "both"],
+  "@sarj/no-declaration-comment-wall": ["error", "both"],
+  "@sarj/no-union-in-comment": ["error", "both"],
+  "@sarj/no-type-member-comment-wall": ["error", "both"],
+  "@sarj/no-unnecessary-use-client": ["error", "both"],
+  "@sarj/no-unsafe-mock-casting": ["error", "both"],
+  "@sarj/no-unsafe-test-double-cast": ["error", "both"],
+  "@sarj/no-first-party-module-mock": ["error", "both"],
+  "@sarj/no-zod-native-enum": ["error", "both"],
+  "@sarj/test-loops-over-literal-cases": ["error", "both"],
+  "@sarj/prefer-constant-time-secret-compare": ["error", "both"],
+  "@sarj/prefer-ecmascript-private-members": ["error", "both"],
+  "@sarj/prefer-discriminated-union": ["warn", "both"],
+  "@sarj/prefer-input-group-search": ["error", "both"],
+  "@sarj/prefer-millisecond-control-duration-schema": ["warn", "both"],
+  "@sarj/prefer-immutable-module-constant": ["error", "both"],
+  "@sarj/prefer-module-level-constant": ["error", "both"],
+  "@sarj/prefer-module-level-schema": ["error", "both"],
+  "@sarj/prefer-module-level-refined-schema": ["warn", "both"],
+  "@sarj/prefer-multi-value-zod-literal": [
+    "error",
+    "both",
+    () => [{ zodMajorVersion: 4 }]
+  ],
+  "@sarj/prefer-named-callback-domain": ["error", "both"],
+  "@sarj/prefer-nominal-id-types": ["error", "both"],
+  "@sarj/prefer-named-complex-return-type": ["error", "both"],
+  "@sarj/prefer-node-crypto-hash": ["warn", "both"],
+  "@sarj/prefer-node-fs-promises": ["warn", "both"],
+  "@sarj/prefer-non-nullable-collection": ["error", "both"],
+  "@sarj/prefer-nullish-filter-predicate": ["error", "both"],
+  "@sarj/prefer-await-in-async-return": ["error", "both"],
+  "@sarj/prefer-schema-for-api-payload": ["error", "both"],
+  "@sarj/prefer-shared-zod-enum": ["warn", "both"],
+  "@sarj/prefer-switch-for-repeated-equality": ["error", "both"],
+  "@sarj/prefer-semantic-colors": [
+    "error",
+    "both",
+    () => [{ requireSemanticTokens: true }]
+  ],
+  "@sarj/prefer-server-actions": ["error", "both"],
+  "@sarj/prefer-whole-object-assertion": ["warn", "both"],
+  "@sarj/repeated-static-call-cases": ["error", "both"],
+  "@sarj/prefer-zod-infer": ["error", "both"],
+  "@sarj/prefer-zod-parse-output-type": ["warn", "both"],
+  "@sarj/require-assert-never": ["error", "both"],
+  "@sarj/require-fetch-timeout": ["error", "both"],
+  "@sarj/require-explicit-contract-implementation": ["error", "both"],
+  "@sarj/require-explicit-service-contract": ["error", "both"],
+  "@sarj/require-interface-for-exported-class": ["error", "both"],
+  "@sarj/require-port-for-service": ["error", "both"],
+  "@sarj/require-sql-access-class": ["warn", "both"],
+  "@sarj/require-static-next-matcher": ["error", "both"],
+  "@sarj/require-use-form-default-values": ["error", "both"],
+  "@sarj/require-use-server-in-actions-file": ["error", "both"],
+  "@sarj/require-zod-form-validation": ["error", "both"],
+  "@sarj/store-insert-requires-on-conflict": ["error", "both"],
+  "@sarj/stepdown": ["error", "both"],
+  "@sarj/source-coupled-test": ["error", "both"],
+  "@sarj/sole-export-matches-filename": ["error", "both"],
+  "@sarj/test-phase-label-comment": ["error", "both"],
+  "@sarj/require-pascal-case-zod-schema-name": ["error", "both"]
 };
+var ADVISORY_RULES = Object.keys(RULE_POLICY).filter(isAdvisoryRuleName).toSorted();
+var RECOMMENDED_RULES = presetRules("recommended");
+var STRICT_RULES = presetRules("strict");
+function isAdvisoryRuleName(name) {
+  return isPolicyName(name) && RULE_POLICY[name][0] === "warn";
+}
+function isPolicyName(name) {
+  return Object.hasOwn(RULE_POLICY, name);
+}
+function presetRules(preset) {
+  const rows = Object.entries(RULE_POLICY).filter(([, row]) => preset === "strict" || row[1] === "both");
+  if (preset === "strict") rows.sort((left, right) => strictOrder(left[1]) - strictOrder(right[1]));
+  const entries = rows.map(([name, row]) => [name, policySetting(row)]);
+  const result = Object.fromEntries(entries);
+  const names = Object.keys(result);
+  if (names.length !== entries.length || names.some((name, index) => name !== entries[index]?.[0])) {
+    throw new Error("Preset projection changed its closed policy key order.");
+  }
+  return result;
+}
+function strictOrder(row) {
+  return row.length === 4 ? row[3] : Number.MAX_SAFE_INTEGER;
+}
+function policySetting(row) {
+  if (row[0] === "shared") return row[2];
+  if (row.length !== 3) return row[0];
+  return [row[0], ...row[2]()];
+}
 var PLUGIN = {
   meta,
   rules: RULES,