@sarj/eslint-plugin 16.38.55 → 16.39.0

package/dist/index.d.cts

@@ -1,17 +1,7 @@
-import { D as DocumentedRule } from './_docs-IZjowAEc.cjs';
-export { p as publicDocumentation } from './_docs-IZjowAEc.cjs';
+import { D as DocumentedRule } from './_docs-_eXGTNOq.cjs';
+export { p as publicDocumentation } from './_docs-_eXGTNOq.cjs';
 import '@typescript-eslint/utils';
 
-/** @fileoverview _retired-rules — burned rule names and their migration action. */
-/** Why a name was withdrawn, and in which release. */
-interface RetiredRule {
-    /** The plugin version whose release removed the rule. */
-    readonly removedIn: string;
-    /** One line a consumer can act on: why it went, and what (if anything) replaced it. */
-    readonly reason: string;
-}
-declare const RETIRED_RULES: Readonly<Record<string, RetiredRule>>;
-
 interface RuleOptions$5 {
     readonly basePath?: string;
 }
@@ -125,6 +115,16 @@ declare const RENAMED_RULES: {
     readonly "trailing-value-narration": "no-trailing-value-narration";
 };
 
+/** @fileoverview _retired-rules — burned rule names and their migration action. */
+/** Why a name was withdrawn, and in which release. */
+interface RetiredRule {
+    /** The plugin version whose release removed the rule. */
+    readonly removedIn: string;
+    /** One line a consumer can act on: why it went, and what (if anything) replaced it. */
+    readonly reason: string;
+}
+declare const RETIRED_RULES: Readonly<Record<string, RetiredRule>>;
+
 declare const RULES: {
     readonly "no-mutating-input-with-result": DocumentedRule<[], "inputWrite">;
     readonly "no-negative-only-http-status-assertion": DocumentedRule<[], "expectedStatus">;
@@ -318,6 +318,10 @@ declare const RULES: {
     readonly "sole-export-matches-filename": DocumentedRule<[], "matchSoleExport">;
     readonly "require-pascal-case-zod-schema-name": DocumentedRule<readonly [], "requirePascalSchema">;
 };
+declare const meta: {
+    readonly name: "@sarj/eslint-plugin";
+    readonly version: string;
+};
 /** @deprecated All repositories use one policy; retained for import compatibility. */
 declare const APPLICATION_ONLY_RULES: readonly [];
 type PresetMembership = "both" | "strict";
@@ -670,222 +674,37 @@ type RuleSetting<Row extends PolicyRow> = Row extends readonly ["shared", "both"
 type PresetRules<Preset extends "recommended" | "strict"> = {
     readonly [Name in PolicyName as Preset extends "recommended" ? (typeof RULE_POLICY)[Name][1] extends "both" ? Name : never : Name]: RuleSetting<(typeof RULE_POLICY)[Name]>;
 };
+type FlatRuleSetting<Setting> = Setting extends readonly unknown[] ? [...Setting] : Setting;
+type FlatPresetRules<Preset extends "recommended" | "strict"> = {
+    readonly [Name in keyof PresetRules<Preset>]: FlatRuleSetting<PresetRules<Preset>[Name]>;
+};
 type AdvisoryRuleName = {
     [Name in PolicyName]: (typeof RULE_POLICY)[Name][0] extends "warn" ? Name : never;
 }[PolicyName];
 /** Rules staged as non-blocking warnings while corpus adoption evidence accumulates. */
 declare const ADVISORY_RULES: readonly AdvisoryRuleName[];
+declare const FLAT_RECOMMENDED_RULES: FlatPresetRules<"recommended">;
+declare const FLAT_STRICT_RULES: FlatPresetRules<"strict">;
 declare const RECOMMENDED_RULES: PresetRules<"recommended">;
 declare const STRICT_RULES: PresetRules<"strict">;
 type FlatPreset<Settings> = {
     readonly name: string;
-    readonly plugins: Record<string, unknown>;
+    readonly plugins: {
+        readonly "@sarj": PluginDefinition;
+    };
     readonly rules: Settings;
 };
-declare const PLUGIN: {
-    readonly meta: {
-        readonly name: "@sarj/eslint-plugin";
-        readonly version: string;
-    };
-    readonly rules: {
-        readonly "no-mutating-input-with-result": DocumentedRule<[], "inputWrite">;
-        readonly "no-negative-only-http-status-assertion": DocumentedRule<[], "expectedStatus">;
-        readonly "production-derived-test-cases": DocumentedRule<[], "independentCases">;
-        readonly "prefer-test-fixture-reuse": DocumentedRule<[], "reuseFixture">;
-        readonly "no-return-disposed-resource": DocumentedRule<[], "disposedReturn">;
-        readonly "require-constrained-schema-integer": DocumentedRule<[], "constrainInteger">;
-        readonly "no-discarded-validation-result": DocumentedRule<[], "discarded">;
-        readonly "require-jwt-lifetime": DocumentedRule<[], "lifetime">;
-        readonly "prefer-dependency-interface": DocumentedRule<[], "interface">;
-        readonly "no-generic-json-parser": DocumentedRule<[], "genericParser">;
-        readonly "no-redundant-local-alias": DocumentedRule<[], "redundantAlias">;
-        readonly "no-test-comments": DocumentedRule<[], "testComment">;
-        readonly "no-mutating-container-transform": DocumentedRule<[], "borrowedMutation">;
-        readonly "no-redundant-consumer-union": DocumentedRule<[], "redundant">;
-        readonly "prefer-minimal-parameter-contract": DocumentedRule<[], "minimal">;
-        readonly "no-excess-jsx-props": DocumentedRule<[], "excess">;
-        readonly "prefer-native-fetch-in-server-actions": DocumentedRule<readonly [], "preferNativeFetchInServerActions">;
-        readonly "no-credential-in-browser-storage": DocumentedRule<readonly [], "noCredentialInBrowserStorage">;
-        readonly "no-numeric-search-param-coercion": DocumentedRule<readonly [], "noNumericSearchParamCoercion">;
-        readonly "require-explicit-contract-implementation": DocumentedRule<readonly [], "declareActualContract">;
-        readonly "require-explicit-service-contract": DocumentedRule<readonly [], "requireExplicitServiceContract">;
-        readonly "no-conditional-empty-object-spread": DocumentedRule<[], "avoid">;
-        readonly "prefer-typed-reflection": DocumentedRule<[], "avoid">;
-        readonly "no-broad-return-type": DocumentedRule<[], "avoid">;
-        readonly "no-reduce-accumulator-copy": DocumentedRule<[], "copy">;
-        readonly "no-known-value-widening": DocumentedRule<[], "widening">;
-        readonly "no-invalid-typed-mutation": DocumentedRule<readonly [], "incompatibleWrite">;
-        readonly "no-contradictory-type-predicate": DocumentedRule<readonly [], "contradictoryPredicate" | "closedLiteralPredicate" | "nullAccepted" | "uncheckedArrayElements" | "uncheckedRecordFields">;
-        readonly "no-partial-type-predicate": DocumentedRule<readonly [], "partialPredicate">;
-        readonly "no-boolean-selector-parameter": DocumentedRule<readonly [], "booleanSelector">;
-        readonly "no-invalid-zod-custom-parse": DocumentedRule<[], "incompatibleCustomParse">;
-        readonly "no-contradictory-overload-return": DocumentedRule<readonly [], "contradictoryReturn">;
-        readonly "require-button-accessible-name": DocumentedRule<readonly [{
-            readonly components?: readonly ComponentImport[];
-            readonly iconModules?: readonly string[];
-        }?], "missingName">;
-        readonly "require-camelcase-properties": DocumentedRule<readonly [], "requireCamelcaseProperty">;
-        readonly "require-svg-accessible-name": DocumentedRule<readonly [], "missingName">;
-        readonly "prefer-logical-tailwind-utilities": DocumentedRule<readonly [{
-            readonly enabled?: boolean;
-            readonly checkInsets?: boolean;
-            readonly allowUtilities?: readonly string[];
-        }?], "physicalUtility">;
-        readonly "no-unlocalized-toast": DocumentedRule<readonly [(LocalizationOptions & {
-            readonly functions?: readonly ComponentImport[];
-            readonly methods?: readonly string[];
-        })?], "unlocalized">;
-        readonly "no-unlocalized-jsx-attributes": DocumentedRule<readonly [(LocalizationOptions & {
-            readonly attributes?: readonly string[];
-        })?], "unlocalized">;
-        readonly "no-unlocalized-jsx-text": DocumentedRule<readonly [LocalizationOptions?], "unlocalized">;
-        readonly "excessive-commentary": DocumentedRule<readonly [], "excessive">;
-        readonly "iac-source-coupled-test": DocumentedRule<readonly [], "rawSourceOracle">;
-        readonly "duplicate-test-body": DocumentedRule<readonly [], "duplicateTestBody">;
-        readonly "enforce-file-structure": DocumentedRule<readonly [], "importsFirst" | "useServerDirective">;
-        readonly "no-client-side-data-fetching": DocumentedRule<readonly [], "noClientFetch">;
-        readonly "no-comment-cruft": DocumentedRule<readonly [], "commentedOutCode" | "sectionBanner" | "fileHeaderPreamble" | "commentWall" | "redundantNarration" | "placeholderImplementation" | "untrackedTodo">;
-        readonly "no-cors-wildcard-with-credentials": DocumentedRule<readonly [], "corsWildcardWithCredentials">;
-        readonly "no-duplicate-lifecycle-refresh-listeners": DocumentedRule<readonly [], "duplicateLifecycleRefresh">;
-        readonly "no-dangerously-allow-svg": DocumentedRule<readonly [], "noDangerouslyAllowSvg">;
-        readonly "no-dynamic-sql": DocumentedRule<readonly [RuleOptions?], "dynamicSql" | "dynamicFragment">;
-        readonly "no-enum": DocumentedRule<readonly [{
-            ignoreFiles?: readonly string[];
-        }?], "noEnum">;
-        readonly "no-excessive-cognitive-complexity": DocumentedRule<[], "excessiveComplexity">;
-        readonly "no-fat-try-blocks": DocumentedRule<readonly [RuleOptions$1?], "fatTryBlock">;
-        readonly "no-hand-rolled-sleep": DocumentedRule<readonly [{
-            allowIn?: readonly string[];
-            checkClientModules?: boolean;
-        }?], "handRolledSleep" | "handRolledTimeoutRace">;
-        readonly "no-hand-rolled-spinner": DocumentedRule<readonly [], "handRolledSpinner">;
-        readonly "no-insecure-random-id": DocumentedRule<readonly [], "insecureRandomId">;
-        readonly "no-detached-global-fetch": DocumentedRule<readonly [], "detachedGlobalFetch">;
-        readonly "no-exception-text-in-5xx-response": DocumentedRule<readonly [], "exceptionText" | "serverActionExceptionText">;
-        readonly "no-json-stringify-error": DocumentedRule<readonly [], "noJsonStringifyError">;
-        readonly "no-json-stringify-object-equality": DocumentedRule<readonly [], "serializedObjectEquality">;
-        readonly "no-impossible-zod-literal-bounds": DocumentedRule<readonly [{
-            readonly delegateRealContradictions?: boolean;
-        }?], "impossibleBounds">;
-        readonly "no-in-operator-on-built-in-collections": DocumentedRule<readonly [], "ambiguousCollectionIn">;
-        readonly "no-redundant-optional-array-default": DocumentedRule<readonly [], "redundantOptionalArrayDefault">;
-        readonly "interface-contract-members-private": DocumentedRule<readonly [], "nonContractMemberMustBePrivate">;
-        readonly "no-log-only-catch": DocumentedRule<readonly [LoggingOptions?], "noLogOnlyCatch" | "emptyCatch">;
-        readonly "no-bare-return-from-test-catch": DocumentedRule<readonly [], "bareReturnFromTestCatch">;
-        readonly "no-bespoke-api-case-conversion": DocumentedRule<readonly [], "noBespokeApiCaseConversion">;
-        readonly "no-long-comment": DocumentedRule<readonly [], "tooLong">;
-        readonly "no-vague-suppression-description": DocumentedRule<readonly [], "vagueDescription">;
-        readonly "no-generic-single-export-module": DocumentedRule<[], "genericSingleExport">;
-        readonly "no-offset-pagination": DocumentedRule<readonly [], "noOffsetPagination">;
-        readonly "no-positional-tuple-return": DocumentedRule<readonly [], "noPositionalTupleReturn">;
-        readonly "no-production-browser-source-maps": DocumentedRule<readonly [], "noProductionBrowserSourceMaps">;
-        readonly "no-raw-env": DocumentedRule<readonly [], "noRawEnv">;
-        readonly "no-raw-fetch-outside-clients": DocumentedRule<readonly [RuleOptions$2?], "rawFetch">;
-        readonly "no-restricted-library-load": DocumentedRule<readonly [{
-            libraries: readonly RestrictedLibrary[];
-        }], "restrictedLibraryLoad">;
-        readonly "no-router-refresh-polling": DocumentedRule<readonly [], "routerRefreshPolling">;
-        readonly "no-repeated-string-literal": DocumentedRule<readonly [], "noRepeatedStringLiteral">;
-        readonly "no-restated-comment": DocumentedRule<readonly [], "deleteComment" | "restatesLineBelow">;
-        readonly "no-restated-jsdoc": DocumentedRule<readonly [], "restatesSignature" | "deleteBlock">;
-        readonly "no-secret-in-log": DocumentedRule<readonly [LoggingOptions?], "noSecretInLog" | "noRawBodyInLog">;
-        readonly "no-server-env-in-client-component": DocumentedRule<readonly [], "noServerEnvInClientComponent">;
-        readonly "no-select-star": DocumentedRule<readonly [], "noSelectStar">;
-        readonly "no-sentinel-return-on-catch": DocumentedRule<readonly [LoggingOptions?], "noSentinelReturn">;
-        readonly "no-silent-promise-catch": DocumentedRule<readonly [], "silentCatch">;
-        readonly "no-sleep-in-test-body": DocumentedRule<readonly [], "noSleepInTestBody">;
-        readonly "no-storage-in-stateless-modules": DocumentedRule<readonly [RuleOptions$3?], "storageInStatelessModule">;
-        readonly "no-string-concat-in-loop": DocumentedRule<readonly [], "noStringConcatInLoop" | "noStringReduce">;
-        readonly "no-tautological-expect": DocumentedRule<readonly [], "tautologicalComparison" | "tautologicalMatcher">;
-        readonly "no-duplicate-test-case": DocumentedRule<readonly [], "duplicateCase">;
-        readonly "no-typed-doc-sections": DocumentedRule<readonly [], "typedSection">;
-        readonly "no-trailing-value-narration": DocumentedRule<readonly [], "deleteNarration" | "narratesValue" | "removeNarration">;
-        readonly "no-declaration-comment-wall": DocumentedRule<readonly [Partial<WallOptions>?], "commentWall">;
-        readonly "no-union-in-comment": DocumentedRule<readonly [], "unionInComment">;
-        readonly "no-type-member-comment-wall": DocumentedRule<readonly [Partial<WallOptions>?], "commentWall">;
-        readonly "no-unnecessary-use-client": DocumentedRule<readonly [], "unnecessaryUseClient">;
-        readonly "no-unsafe-mock-casting": DocumentedRule<[], "unsafeMockCast">;
-        readonly "no-unsafe-test-double-cast": DocumentedRule<[], "noUnsafeTestDoubleCast">;
-        readonly "no-first-party-module-mock": DocumentedRule<readonly [{
-            additionalModulePrefixes?: readonly string[];
-        }], "noFirstPartyModuleMock">;
-        readonly "no-zod-native-enum": DocumentedRule<readonly [], "nativeEnum" | "enumOfTsEnum">;
-        readonly "require-use-form-default-values": DocumentedRule<readonly [], "requireUseFormDefaultValues">;
-        readonly "require-use-server-in-actions-file": DocumentedRule<readonly [], "requireUseServerInActionsFile">;
-        readonly "test-loops-over-literal-cases": DocumentedRule<readonly [], "literalCaseLoop">;
-        readonly "test-phase-label-comment": DocumentedRule<readonly [], "removeLabel">;
-        readonly "prefer-constant-time-secret-compare": DocumentedRule<readonly [], "preferConstantTimeSecretCompare">;
-        readonly "prefer-ecmascript-private-members": DocumentedRule<readonly [], "preferEcmascriptPrivate">;
-        readonly "prefer-discriminated-union": DocumentedRule<readonly [], "preferDiscriminatedUnion" | "preferProducedVariants">;
-        readonly "prefer-input-group-search": DocumentedRule<readonly [], "preferInputGroup">;
-        readonly "prefer-millisecond-control-duration-schema": DocumentedRule<readonly [], "preferMilliseconds">;
-        readonly "prefer-immutable-module-constant": DocumentedRule<readonly [], "preferAsConst" | "preferReadonlyCollection">;
-        readonly "prefer-shadcn-primitives": DocumentedRule<readonly [RuleOptions$4?], "preferShadcnPrimitive">;
-        readonly "prefer-module-level-constant": DocumentedRule<readonly [{
-            minElements?: number;
-            checkRegex?: boolean;
-            ignoreTestFiles?: boolean;
-        }?], "hoistCollection" | "hoistRegex">;
-        readonly "prefer-module-level-schema": DocumentedRule<readonly [{
-            factories?: readonly string[];
-            ignoreTestFiles?: boolean;
-            memoCallees?: readonly string[];
-            minProperties?: number;
-        }?], "hoistSchema">;
-        readonly "prefer-module-level-refined-schema": DocumentedRule<[], "hoistRefinedSchema">;
-        readonly "prefer-multi-value-zod-literal": DocumentedRule<readonly [{
-            zodMajorVersion?: 4;
-        }], "useMultiValueLiteral">;
-        readonly "prefer-named-callback-domain": DocumentedRule<[], "nameCallbackDomain">;
-        readonly "prefer-nominal-id-types": DocumentedRule<[], "preferNominalIds">;
-        readonly "prefer-named-complex-return-type": DocumentedRule<[], "nameComplexReturnType">;
-        readonly "prefer-native-random-uuid": DocumentedRule<readonly [], "preferNative" | "replaceWithNative">;
-        readonly "prefer-node-crypto-hash": DocumentedRule<readonly [], "preferNodeCryptoHash">;
-        readonly "prefer-node-fs-promises": DocumentedRule<[], "preferAsyncFs">;
-        readonly "prefer-non-nullable-collection": DocumentedRule<readonly [], "preferNonNullableCollection">;
-        readonly "prefer-nullish-filter-predicate": DocumentedRule<readonly [], "preferNullishPredicate" | "replaceBoolean">;
-        readonly "prefer-await-in-async-return": DocumentedRule<readonly [{
-            readonly scope: "async-return" | "all-promise-calls";
-        }], "preferAwait" | "preferAwaitCall">;
-        readonly "prefer-schema-for-api-payload": DocumentedRule<readonly [], "unparsedJsonAccess">;
-        readonly "prefer-shared-zod-enum": DocumentedRule<[], "shareEnumDomain">;
-        readonly "prefer-switch-for-repeated-equality": DocumentedRule<[], "preferSwitch">;
-        readonly "prefer-semantic-colors": DocumentedRule<readonly [{
-            opaqueForegroundPairs?: boolean;
-            requireSemanticTokens?: boolean;
-        }?], "rawPalette" | "arbitraryColor" | "inlineColor" | "opaqueForegroundPair">;
-        readonly "prefer-server-actions": DocumentedRule<readonly [RuleOptions$5?], "preferServerAction">;
-        readonly "prefer-whole-object-assertion": DocumentedRule<readonly [], "combineAssertions" | "assertArrayOnce">;
-        readonly "repeated-static-call-cases": DocumentedRule<readonly [], "repeatedStaticCallCases">;
-        readonly "prefer-zod-infer": DocumentedRule<readonly [{
-            ignoreTypeNames?: readonly string[];
-            requireIdenticalShape?: boolean;
-        }?], "handWrittenTwin" | "repeatedEnumUnion">;
-        readonly "named-child-schema-type": DocumentedRule<readonly [], "namedChildType">;
-        readonly "prefer-zod-parse-output-type": DocumentedRule<readonly [], "handWrittenParsedOutput">;
-        readonly "require-assert-never": DocumentedRule<readonly [], "missingAssertNever">;
-        readonly "require-fetch-timeout": DocumentedRule<readonly [{
-            allowIn?: readonly string[];
-        }?], "missingSignal">;
-        readonly "require-interface-for-exported-class": DocumentedRule<[], "requireContract">;
-        readonly "require-port-for-service": DocumentedRule<readonly [], "requireInterface">;
-        readonly "require-sql-access-class": DocumentedRule<[], "moveSqlIntoClass">;
-        readonly "require-static-next-matcher": DocumentedRule<readonly [], "dynamicMatcher">;
-        readonly "require-zod-form-validation": DocumentedRule<readonly [], "missingZodValidation">;
-        readonly "store-insert-requires-on-conflict": DocumentedRule<readonly [], "storeInsertRequiresOnConflict">;
-        readonly stepdown: DocumentedRule<[{
-            readonly privateBandOnly?: boolean;
-        }], "helperAboveOnlyCaller">;
-        readonly "source-coupled-test": DocumentedRule<readonly [], "rawSourceOracle">;
-        readonly "sole-export-matches-filename": DocumentedRule<[], "matchSoleExport">;
-        readonly "require-pascal-case-zod-schema-name": DocumentedRule<readonly [], "requirePascalSchema">;
-    };
-    readonly retiredRules: Readonly<Record<string, RetiredRule>>;
+interface PluginDefinition {
+    readonly meta: typeof meta;
+    readonly rules: typeof RULES;
+    readonly retiredRules: typeof RETIRED_RULES;
+    /** TSESLint.ESLint accepts these typed callbacks while running the native ESLint engine. */
     readonly configs: {
-        readonly recommended: FlatPreset<typeof RECOMMENDED_RULES>;
-        readonly strict: FlatPreset<typeof STRICT_RULES>;
+        readonly recommended: FlatPreset<typeof FLAT_RECOMMENDED_RULES>;
+        readonly strict: FlatPreset<typeof FLAT_STRICT_RULES>;
     };
-};
+}
+declare const PLUGIN: PluginDefinition;
 
 export { ADVISORY_RULES, APPLICATION_ONLY_RULES, DocumentedRule, RECOMMENDED_RULES, RENAMED_RULES, RETIRED_RULES, RULES, STRICT_RULES, ADVISORY_RULES as advisoryRules, APPLICATION_ONLY_RULES as applicationOnlyRules, PLUGIN as default, RECOMMENDED_RULES as recommendedRules, RENAMED_RULES as renamedRules, RETIRED_RULES as retiredRules, RULES as rules, STRICT_RULES as strictRules };
 export type { RetiredRule };

package/dist/index.d.ts

@@ -1,17 +1,7 @@
-import { D as DocumentedRule } from './_docs-IZjowAEc.js';
-export { p as publicDocumentation } from './_docs-IZjowAEc.js';
+import { D as DocumentedRule } from './_docs-_eXGTNOq.js';
+export { p as publicDocumentation } from './_docs-_eXGTNOq.js';
 import '@typescript-eslint/utils';
 
-/** @fileoverview _retired-rules — burned rule names and their migration action. */
-/** Why a name was withdrawn, and in which release. */
-interface RetiredRule {
-    /** The plugin version whose release removed the rule. */
-    readonly removedIn: string;
-    /** One line a consumer can act on: why it went, and what (if anything) replaced it. */
-    readonly reason: string;
-}
-declare const RETIRED_RULES: Readonly<Record<string, RetiredRule>>;
-
 interface RuleOptions$5 {
     readonly basePath?: string;
 }
@@ -125,6 +115,16 @@ declare const RENAMED_RULES: {
     readonly "trailing-value-narration": "no-trailing-value-narration";
 };
 
+/** @fileoverview _retired-rules — burned rule names and their migration action. */
+/** Why a name was withdrawn, and in which release. */
+interface RetiredRule {
+    /** The plugin version whose release removed the rule. */
+    readonly removedIn: string;
+    /** One line a consumer can act on: why it went, and what (if anything) replaced it. */
+    readonly reason: string;
+}
+declare const RETIRED_RULES: Readonly<Record<string, RetiredRule>>;
+
 declare const RULES: {
     readonly "no-mutating-input-with-result": DocumentedRule<[], "inputWrite">;
     readonly "no-negative-only-http-status-assertion": DocumentedRule<[], "expectedStatus">;
@@ -318,6 +318,10 @@ declare const RULES: {
     readonly "sole-export-matches-filename": DocumentedRule<[], "matchSoleExport">;
     readonly "require-pascal-case-zod-schema-name": DocumentedRule<readonly [], "requirePascalSchema">;
 };
+declare const meta: {
+    readonly name: "@sarj/eslint-plugin";
+    readonly version: string;
+};
 /** @deprecated All repositories use one policy; retained for import compatibility. */
 declare const APPLICATION_ONLY_RULES: readonly [];
 type PresetMembership = "both" | "strict";
@@ -670,222 +674,37 @@ type RuleSetting<Row extends PolicyRow> = Row extends readonly ["shared", "both"
 type PresetRules<Preset extends "recommended" | "strict"> = {
     readonly [Name in PolicyName as Preset extends "recommended" ? (typeof RULE_POLICY)[Name][1] extends "both" ? Name : never : Name]: RuleSetting<(typeof RULE_POLICY)[Name]>;
 };
+type FlatRuleSetting<Setting> = Setting extends readonly unknown[] ? [...Setting] : Setting;
+type FlatPresetRules<Preset extends "recommended" | "strict"> = {
+    readonly [Name in keyof PresetRules<Preset>]: FlatRuleSetting<PresetRules<Preset>[Name]>;
+};
 type AdvisoryRuleName = {
     [Name in PolicyName]: (typeof RULE_POLICY)[Name][0] extends "warn" ? Name : never;
 }[PolicyName];
 /** Rules staged as non-blocking warnings while corpus adoption evidence accumulates. */
 declare const ADVISORY_RULES: readonly AdvisoryRuleName[];
+declare const FLAT_RECOMMENDED_RULES: FlatPresetRules<"recommended">;
+declare const FLAT_STRICT_RULES: FlatPresetRules<"strict">;
 declare const RECOMMENDED_RULES: PresetRules<"recommended">;
 declare const STRICT_RULES: PresetRules<"strict">;
 type FlatPreset<Settings> = {
     readonly name: string;
-    readonly plugins: Record<string, unknown>;
+    readonly plugins: {
+        readonly "@sarj": PluginDefinition;
+    };
     readonly rules: Settings;
 };
-declare const PLUGIN: {
-    readonly meta: {
-        readonly name: "@sarj/eslint-plugin";
-        readonly version: string;
-    };
-    readonly rules: {
-        readonly "no-mutating-input-with-result": DocumentedRule<[], "inputWrite">;
-        readonly "no-negative-only-http-status-assertion": DocumentedRule<[], "expectedStatus">;
-        readonly "production-derived-test-cases": DocumentedRule<[], "independentCases">;
-        readonly "prefer-test-fixture-reuse": DocumentedRule<[], "reuseFixture">;
-        readonly "no-return-disposed-resource": DocumentedRule<[], "disposedReturn">;
-        readonly "require-constrained-schema-integer": DocumentedRule<[], "constrainInteger">;
-        readonly "no-discarded-validation-result": DocumentedRule<[], "discarded">;
-        readonly "require-jwt-lifetime": DocumentedRule<[], "lifetime">;
-        readonly "prefer-dependency-interface": DocumentedRule<[], "interface">;
-        readonly "no-generic-json-parser": DocumentedRule<[], "genericParser">;
-        readonly "no-redundant-local-alias": DocumentedRule<[], "redundantAlias">;
-        readonly "no-test-comments": DocumentedRule<[], "testComment">;
-        readonly "no-mutating-container-transform": DocumentedRule<[], "borrowedMutation">;
-        readonly "no-redundant-consumer-union": DocumentedRule<[], "redundant">;
-        readonly "prefer-minimal-parameter-contract": DocumentedRule<[], "minimal">;
-        readonly "no-excess-jsx-props": DocumentedRule<[], "excess">;
-        readonly "prefer-native-fetch-in-server-actions": DocumentedRule<readonly [], "preferNativeFetchInServerActions">;
-        readonly "no-credential-in-browser-storage": DocumentedRule<readonly [], "noCredentialInBrowserStorage">;
-        readonly "no-numeric-search-param-coercion": DocumentedRule<readonly [], "noNumericSearchParamCoercion">;
-        readonly "require-explicit-contract-implementation": DocumentedRule<readonly [], "declareActualContract">;
-        readonly "require-explicit-service-contract": DocumentedRule<readonly [], "requireExplicitServiceContract">;
-        readonly "no-conditional-empty-object-spread": DocumentedRule<[], "avoid">;
-        readonly "prefer-typed-reflection": DocumentedRule<[], "avoid">;
-        readonly "no-broad-return-type": DocumentedRule<[], "avoid">;
-        readonly "no-reduce-accumulator-copy": DocumentedRule<[], "copy">;
-        readonly "no-known-value-widening": DocumentedRule<[], "widening">;
-        readonly "no-invalid-typed-mutation": DocumentedRule<readonly [], "incompatibleWrite">;
-        readonly "no-contradictory-type-predicate": DocumentedRule<readonly [], "contradictoryPredicate" | "closedLiteralPredicate" | "nullAccepted" | "uncheckedArrayElements" | "uncheckedRecordFields">;
-        readonly "no-partial-type-predicate": DocumentedRule<readonly [], "partialPredicate">;
-        readonly "no-boolean-selector-parameter": DocumentedRule<readonly [], "booleanSelector">;
-        readonly "no-invalid-zod-custom-parse": DocumentedRule<[], "incompatibleCustomParse">;
-        readonly "no-contradictory-overload-return": DocumentedRule<readonly [], "contradictoryReturn">;
-        readonly "require-button-accessible-name": DocumentedRule<readonly [{
-            readonly components?: readonly ComponentImport[];
-            readonly iconModules?: readonly string[];
-        }?], "missingName">;
-        readonly "require-camelcase-properties": DocumentedRule<readonly [], "requireCamelcaseProperty">;
-        readonly "require-svg-accessible-name": DocumentedRule<readonly [], "missingName">;
-        readonly "prefer-logical-tailwind-utilities": DocumentedRule<readonly [{
-            readonly enabled?: boolean;
-            readonly checkInsets?: boolean;
-            readonly allowUtilities?: readonly string[];
-        }?], "physicalUtility">;
-        readonly "no-unlocalized-toast": DocumentedRule<readonly [(LocalizationOptions & {
-            readonly functions?: readonly ComponentImport[];
-            readonly methods?: readonly string[];
-        })?], "unlocalized">;
-        readonly "no-unlocalized-jsx-attributes": DocumentedRule<readonly [(LocalizationOptions & {
-            readonly attributes?: readonly string[];
-        })?], "unlocalized">;
-        readonly "no-unlocalized-jsx-text": DocumentedRule<readonly [LocalizationOptions?], "unlocalized">;
-        readonly "excessive-commentary": DocumentedRule<readonly [], "excessive">;
-        readonly "iac-source-coupled-test": DocumentedRule<readonly [], "rawSourceOracle">;
-        readonly "duplicate-test-body": DocumentedRule<readonly [], "duplicateTestBody">;
-        readonly "enforce-file-structure": DocumentedRule<readonly [], "importsFirst" | "useServerDirective">;
-        readonly "no-client-side-data-fetching": DocumentedRule<readonly [], "noClientFetch">;
-        readonly "no-comment-cruft": DocumentedRule<readonly [], "commentedOutCode" | "sectionBanner" | "fileHeaderPreamble" | "commentWall" | "redundantNarration" | "placeholderImplementation" | "untrackedTodo">;
-        readonly "no-cors-wildcard-with-credentials": DocumentedRule<readonly [], "corsWildcardWithCredentials">;
-        readonly "no-duplicate-lifecycle-refresh-listeners": DocumentedRule<readonly [], "duplicateLifecycleRefresh">;
-        readonly "no-dangerously-allow-svg": DocumentedRule<readonly [], "noDangerouslyAllowSvg">;
-        readonly "no-dynamic-sql": DocumentedRule<readonly [RuleOptions?], "dynamicSql" | "dynamicFragment">;
-        readonly "no-enum": DocumentedRule<readonly [{
-            ignoreFiles?: readonly string[];
-        }?], "noEnum">;
-        readonly "no-excessive-cognitive-complexity": DocumentedRule<[], "excessiveComplexity">;
-        readonly "no-fat-try-blocks": DocumentedRule<readonly [RuleOptions$1?], "fatTryBlock">;
-        readonly "no-hand-rolled-sleep": DocumentedRule<readonly [{
-            allowIn?: readonly string[];
-            checkClientModules?: boolean;
-        }?], "handRolledSleep" | "handRolledTimeoutRace">;
-        readonly "no-hand-rolled-spinner": DocumentedRule<readonly [], "handRolledSpinner">;
-        readonly "no-insecure-random-id": DocumentedRule<readonly [], "insecureRandomId">;
-        readonly "no-detached-global-fetch": DocumentedRule<readonly [], "detachedGlobalFetch">;
-        readonly "no-exception-text-in-5xx-response": DocumentedRule<readonly [], "exceptionText" | "serverActionExceptionText">;
-        readonly "no-json-stringify-error": DocumentedRule<readonly [], "noJsonStringifyError">;
-        readonly "no-json-stringify-object-equality": DocumentedRule<readonly [], "serializedObjectEquality">;
-        readonly "no-impossible-zod-literal-bounds": DocumentedRule<readonly [{
-            readonly delegateRealContradictions?: boolean;
-        }?], "impossibleBounds">;
-        readonly "no-in-operator-on-built-in-collections": DocumentedRule<readonly [], "ambiguousCollectionIn">;
-        readonly "no-redundant-optional-array-default": DocumentedRule<readonly [], "redundantOptionalArrayDefault">;
-        readonly "interface-contract-members-private": DocumentedRule<readonly [], "nonContractMemberMustBePrivate">;
-        readonly "no-log-only-catch": DocumentedRule<readonly [LoggingOptions?], "noLogOnlyCatch" | "emptyCatch">;
-        readonly "no-bare-return-from-test-catch": DocumentedRule<readonly [], "bareReturnFromTestCatch">;
-        readonly "no-bespoke-api-case-conversion": DocumentedRule<readonly [], "noBespokeApiCaseConversion">;
-        readonly "no-long-comment": DocumentedRule<readonly [], "tooLong">;
-        readonly "no-vague-suppression-description": DocumentedRule<readonly [], "vagueDescription">;
-        readonly "no-generic-single-export-module": DocumentedRule<[], "genericSingleExport">;
-        readonly "no-offset-pagination": DocumentedRule<readonly [], "noOffsetPagination">;
-        readonly "no-positional-tuple-return": DocumentedRule<readonly [], "noPositionalTupleReturn">;
-        readonly "no-production-browser-source-maps": DocumentedRule<readonly [], "noProductionBrowserSourceMaps">;
-        readonly "no-raw-env": DocumentedRule<readonly [], "noRawEnv">;
-        readonly "no-raw-fetch-outside-clients": DocumentedRule<readonly [RuleOptions$2?], "rawFetch">;
-        readonly "no-restricted-library-load": DocumentedRule<readonly [{
-            libraries: readonly RestrictedLibrary[];
-        }], "restrictedLibraryLoad">;
-        readonly "no-router-refresh-polling": DocumentedRule<readonly [], "routerRefreshPolling">;
-        readonly "no-repeated-string-literal": DocumentedRule<readonly [], "noRepeatedStringLiteral">;
-        readonly "no-restated-comment": DocumentedRule<readonly [], "deleteComment" | "restatesLineBelow">;
-        readonly "no-restated-jsdoc": DocumentedRule<readonly [], "restatesSignature" | "deleteBlock">;
-        readonly "no-secret-in-log": DocumentedRule<readonly [LoggingOptions?], "noSecretInLog" | "noRawBodyInLog">;
-        readonly "no-server-env-in-client-component": DocumentedRule<readonly [], "noServerEnvInClientComponent">;
-        readonly "no-select-star": DocumentedRule<readonly [], "noSelectStar">;
-        readonly "no-sentinel-return-on-catch": DocumentedRule<readonly [LoggingOptions?], "noSentinelReturn">;
-        readonly "no-silent-promise-catch": DocumentedRule<readonly [], "silentCatch">;
-        readonly "no-sleep-in-test-body": DocumentedRule<readonly [], "noSleepInTestBody">;
-        readonly "no-storage-in-stateless-modules": DocumentedRule<readonly [RuleOptions$3?], "storageInStatelessModule">;
-        readonly "no-string-concat-in-loop": DocumentedRule<readonly [], "noStringConcatInLoop" | "noStringReduce">;
-        readonly "no-tautological-expect": DocumentedRule<readonly [], "tautologicalComparison" | "tautologicalMatcher">;
-        readonly "no-duplicate-test-case": DocumentedRule<readonly [], "duplicateCase">;
-        readonly "no-typed-doc-sections": DocumentedRule<readonly [], "typedSection">;
-        readonly "no-trailing-value-narration": DocumentedRule<readonly [], "deleteNarration" | "narratesValue" | "removeNarration">;
-        readonly "no-declaration-comment-wall": DocumentedRule<readonly [Partial<WallOptions>?], "commentWall">;
-        readonly "no-union-in-comment": DocumentedRule<readonly [], "unionInComment">;
-        readonly "no-type-member-comment-wall": DocumentedRule<readonly [Partial<WallOptions>?], "commentWall">;
-        readonly "no-unnecessary-use-client": DocumentedRule<readonly [], "unnecessaryUseClient">;
-        readonly "no-unsafe-mock-casting": DocumentedRule<[], "unsafeMockCast">;
-        readonly "no-unsafe-test-double-cast": DocumentedRule<[], "noUnsafeTestDoubleCast">;
-        readonly "no-first-party-module-mock": DocumentedRule<readonly [{
-            additionalModulePrefixes?: readonly string[];
-        }], "noFirstPartyModuleMock">;
-        readonly "no-zod-native-enum": DocumentedRule<readonly [], "nativeEnum" | "enumOfTsEnum">;
-        readonly "require-use-form-default-values": DocumentedRule<readonly [], "requireUseFormDefaultValues">;
-        readonly "require-use-server-in-actions-file": DocumentedRule<readonly [], "requireUseServerInActionsFile">;
-        readonly "test-loops-over-literal-cases": DocumentedRule<readonly [], "literalCaseLoop">;
-        readonly "test-phase-label-comment": DocumentedRule<readonly [], "removeLabel">;
-        readonly "prefer-constant-time-secret-compare": DocumentedRule<readonly [], "preferConstantTimeSecretCompare">;
-        readonly "prefer-ecmascript-private-members": DocumentedRule<readonly [], "preferEcmascriptPrivate">;
-        readonly "prefer-discriminated-union": DocumentedRule<readonly [], "preferDiscriminatedUnion" | "preferProducedVariants">;
-        readonly "prefer-input-group-search": DocumentedRule<readonly [], "preferInputGroup">;
-        readonly "prefer-millisecond-control-duration-schema": DocumentedRule<readonly [], "preferMilliseconds">;
-        readonly "prefer-immutable-module-constant": DocumentedRule<readonly [], "preferAsConst" | "preferReadonlyCollection">;
-        readonly "prefer-shadcn-primitives": DocumentedRule<readonly [RuleOptions$4?], "preferShadcnPrimitive">;
-        readonly "prefer-module-level-constant": DocumentedRule<readonly [{
-            minElements?: number;
-            checkRegex?: boolean;
-            ignoreTestFiles?: boolean;
-        }?], "hoistCollection" | "hoistRegex">;
-        readonly "prefer-module-level-schema": DocumentedRule<readonly [{
-            factories?: readonly string[];
-            ignoreTestFiles?: boolean;
-            memoCallees?: readonly string[];
-            minProperties?: number;
-        }?], "hoistSchema">;
-        readonly "prefer-module-level-refined-schema": DocumentedRule<[], "hoistRefinedSchema">;
-        readonly "prefer-multi-value-zod-literal": DocumentedRule<readonly [{
-            zodMajorVersion?: 4;
-        }], "useMultiValueLiteral">;
-        readonly "prefer-named-callback-domain": DocumentedRule<[], "nameCallbackDomain">;
-        readonly "prefer-nominal-id-types": DocumentedRule<[], "preferNominalIds">;
-        readonly "prefer-named-complex-return-type": DocumentedRule<[], "nameComplexReturnType">;
-        readonly "prefer-native-random-uuid": DocumentedRule<readonly [], "preferNative" | "replaceWithNative">;
-        readonly "prefer-node-crypto-hash": DocumentedRule<readonly [], "preferNodeCryptoHash">;
-        readonly "prefer-node-fs-promises": DocumentedRule<[], "preferAsyncFs">;
-        readonly "prefer-non-nullable-collection": DocumentedRule<readonly [], "preferNonNullableCollection">;
-        readonly "prefer-nullish-filter-predicate": DocumentedRule<readonly [], "preferNullishPredicate" | "replaceBoolean">;
-        readonly "prefer-await-in-async-return": DocumentedRule<readonly [{
-            readonly scope: "async-return" | "all-promise-calls";
-        }], "preferAwait" | "preferAwaitCall">;
-        readonly "prefer-schema-for-api-payload": DocumentedRule<readonly [], "unparsedJsonAccess">;
-        readonly "prefer-shared-zod-enum": DocumentedRule<[], "shareEnumDomain">;
-        readonly "prefer-switch-for-repeated-equality": DocumentedRule<[], "preferSwitch">;
-        readonly "prefer-semantic-colors": DocumentedRule<readonly [{
-            opaqueForegroundPairs?: boolean;
-            requireSemanticTokens?: boolean;
-        }?], "rawPalette" | "arbitraryColor" | "inlineColor" | "opaqueForegroundPair">;
-        readonly "prefer-server-actions": DocumentedRule<readonly [RuleOptions$5?], "preferServerAction">;
-        readonly "prefer-whole-object-assertion": DocumentedRule<readonly [], "combineAssertions" | "assertArrayOnce">;
-        readonly "repeated-static-call-cases": DocumentedRule<readonly [], "repeatedStaticCallCases">;
-        readonly "prefer-zod-infer": DocumentedRule<readonly [{
-            ignoreTypeNames?: readonly string[];
-            requireIdenticalShape?: boolean;
-        }?], "handWrittenTwin" | "repeatedEnumUnion">;
-        readonly "named-child-schema-type": DocumentedRule<readonly [], "namedChildType">;
-        readonly "prefer-zod-parse-output-type": DocumentedRule<readonly [], "handWrittenParsedOutput">;
-        readonly "require-assert-never": DocumentedRule<readonly [], "missingAssertNever">;
-        readonly "require-fetch-timeout": DocumentedRule<readonly [{
-            allowIn?: readonly string[];
-        }?], "missingSignal">;
-        readonly "require-interface-for-exported-class": DocumentedRule<[], "requireContract">;
-        readonly "require-port-for-service": DocumentedRule<readonly [], "requireInterface">;
-        readonly "require-sql-access-class": DocumentedRule<[], "moveSqlIntoClass">;
-        readonly "require-static-next-matcher": DocumentedRule<readonly [], "dynamicMatcher">;
-        readonly "require-zod-form-validation": DocumentedRule<readonly [], "missingZodValidation">;
-        readonly "store-insert-requires-on-conflict": DocumentedRule<readonly [], "storeInsertRequiresOnConflict">;
-        readonly stepdown: DocumentedRule<[{
-            readonly privateBandOnly?: boolean;
-        }], "helperAboveOnlyCaller">;
-        readonly "source-coupled-test": DocumentedRule<readonly [], "rawSourceOracle">;
-        readonly "sole-export-matches-filename": DocumentedRule<[], "matchSoleExport">;
-        readonly "require-pascal-case-zod-schema-name": DocumentedRule<readonly [], "requirePascalSchema">;
-    };
-    readonly retiredRules: Readonly<Record<string, RetiredRule>>;
+interface PluginDefinition {
+    readonly meta: typeof meta;
+    readonly rules: typeof RULES;
+    readonly retiredRules: typeof RETIRED_RULES;
+    /** TSESLint.ESLint accepts these typed callbacks while running the native ESLint engine. */
     readonly configs: {
-        readonly recommended: FlatPreset<typeof RECOMMENDED_RULES>;
-        readonly strict: FlatPreset<typeof STRICT_RULES>;
+        readonly recommended: FlatPreset<typeof FLAT_RECOMMENDED_RULES>;
+        readonly strict: FlatPreset<typeof FLAT_STRICT_RULES>;
     };
-};
+}
+declare const PLUGIN: PluginDefinition;
 
 export { ADVISORY_RULES, APPLICATION_ONLY_RULES, DocumentedRule, RECOMMENDED_RULES, RENAMED_RULES, RETIRED_RULES, RULES, STRICT_RULES, ADVISORY_RULES as advisoryRules, APPLICATION_ONLY_RULES as applicationOnlyRules, PLUGIN as default, RECOMMENDED_RULES as recommendedRules, RENAMED_RULES as renamedRules, RETIRED_RULES as retiredRules, RULES as rules, STRICT_RULES as strictRules };
 export type { RetiredRule };