@sarj/eslint-plugin 17.1.2 → 17.1.3

package/dist/index.cjs

@@ -1076,13 +1076,13 @@ var no_test_comments_default = createRule({
   name: "no-test-comments",
   documentation: NO_TEST_COMMENTS_DOCUMENTATION,
   meta: {
+    defaultOptions: [{}],
     type: "suggestion",
     fixable: "code",
     docs: { description: NO_TEST_COMMENTS_DOCUMENTATION.summary },
-    schema: [{ type: "object", properties: { allFiles: { type: "boolean" } }, additionalProperties: false }],
+    schema: [{ type: "object", properties: { allFiles: { description: "Check every eligible test file without requiring frontend framework ownership.", type: "boolean" } }, additionalProperties: false }],
     messages: { testComment: "Express this explanation in the test name, fixture or assertion, then remove the comment." }
   },
-  defaultOptions: [{}],
   create(context, [options]) {
     if (!isTestFile(context) || isGeneratedFile(context, context.sourceCode.text)) return {};
     if (!ownsTestComments(context)) return {};
@@ -1171,13 +1171,13 @@ var no_frontend_comments_default = createRule({
   name: "no-frontend-comments",
   documentation: NO_FRONTEND_COMMENTS_DOCUMENTATION,
   meta: {
+    defaultOptions: [{}],
     type: "suggestion",
     fixable: "code",
     docs: { description: NO_FRONTEND_COMMENTS_DOCUMENTATION.summary },
-    schema: [{ type: "object", properties: { allFiles: { type: "boolean" } }, additionalProperties: false }],
+    schema: [{ type: "object", properties: { allFiles: { description: "Check comments without requiring frontend framework ownership.", type: "boolean" } }, additionalProperties: false }],
     messages: { noFrontendComments: "Frontend comments are prohibited; express the behavior in names, types or code and review any directive or legal contract before removing it." }
   },
-  defaultOptions: [{}],
   create(context, [options]) {
     if (isGeneratedFile(context, context.sourceCode.text) || ownsTestComments(context)) return {};
     const jsxRanges = [];
@@ -4832,7 +4832,7 @@ function isSearchParamReceiver(call, services) {
 // package.json
 var package_default = {
   name: "@sarj/eslint-plugin",
-  version: "17.1.2",
+  version: "17.1.3",
   packageManager: "npm@12.2.1",
   description: "Custom ESLint rules for hypermodern TypeScript / React / Next.js projects",
   type: "module",
@@ -4906,6 +4906,7 @@ var package_default = {
     "@vitest/eslint-plugin": "1.6.28",
     eslint: "10.13.0",
     "eslint-node-test": "1.0.1",
+    "eslint-plugin-eslint-plugin": "7.6.2",
     "eslint-plugin-better-tailwindcss": "^4.10.0",
     "eslint-plugin-jest": "29.17.0",
     "eslint-plugin-jsdoc": "65.4.2",
@@ -4926,6 +4927,7 @@ var package_default = {
     jiti: "2.7.0",
     prettier: "3.9.10",
     tsup: "9.0.0",
+    syncpack: "15.3.3",
     typescript: "npm:@typescript/typescript6@6.0.2",
     "typescript-eslint": "^8.72.0",
     uuid: "13.0.0",
@@ -9170,6 +9172,7 @@ var require_button_accessible_name_default = createRule({
   name: "require-button-accessible-name",
   documentation: REQUIRE_BUTTON_ACCESSIBLE_NAME_DOCUMENTATION,
   meta: {
+    defaultOptions: [{}],
     type: "problem",
     docs: { description: REQUIRE_BUTTON_ACCESSIBLE_NAME_DOCUMENTATION.summary },
     schema: [
@@ -9178,6 +9181,7 @@ var require_button_accessible_name_default = createRule({
         properties: {
           components: COMPONENT_IMPORT_SCHEMA,
           iconModules: {
+            description: "Module names whose imported components count as icons.",
             type: "array",
             items: { type: "string", minLength: 1 },
             uniqueItems: true
@@ -9190,7 +9194,6 @@ var require_button_accessible_name_default = createRule({
       missingName: "This button has no statically identifiable accessible name. Add action text, aria-label, or aria-labelledby."
     }
   },
-  defaultOptions: [{}],
   create(context, [options]) {
     if (isGeneratedFile(context, context.sourceCode.text) || isTestFile(context) || isStoryFile(context))
       return {};
@@ -9509,6 +9512,7 @@ var prefer_logical_tailwind_utilities_default = createRule({
   name: "prefer-logical-tailwind-utilities",
   documentation: PREFER_LOGICAL_TAILWIND_UTILITIES_DOCUMENTATION,
   meta: {
+    defaultOptions: [{ enabled: true, checkInsets: false, allowUtilities: [] }],
     type: "suggestion",
     docs: {
       description: PREFER_LOGICAL_TAILWIND_UTILITIES_DOCUMENTATION.summary
@@ -9517,9 +9521,10 @@ var prefer_logical_tailwind_utilities_default = createRule({
       {
         type: "object",
         properties: {
-          enabled: { type: "boolean" },
-          checkInsets: { type: "boolean" },
+          enabled: { description: "Enable replacement of physical direction utilities with logical equivalents.", type: "boolean" },
+          checkInsets: { description: "Include physical inset utilities in direction checks.", type: "boolean" },
           allowUtilities: {
+            description: "Physical utility names allowed without a logical replacement.",
             type: "array",
             items: { type: "string" },
             uniqueItems: true
@@ -9532,7 +9537,6 @@ var prefer_logical_tailwind_utilities_default = createRule({
       physicalUtility: "Use '{{replacement}}' instead of '{{utility}}' in this bidirectional UI, or explicitly allow intentional physical placement."
     }
   },
-  defaultOptions: [{ enabled: true, checkInsets: false, allowUtilities: [] }],
   create(context, [options]) {
     if (options?.enabled === false || isGeneratedFile(context, context.sourceCode.text) || isTestFile(context) || isStoryFile(context))
       return {};
@@ -9660,6 +9664,7 @@ var no_unlocalized_toast_default = createRule({
   name: "no-unlocalized-toast",
   documentation: NO_UNLOCALIZED_TOAST_DOCUMENTATION,
   meta: {
+    defaultOptions: [{ enabled: true }],
     type: "suggestion",
     docs: { description: NO_UNLOCALIZED_TOAST_DOCUMENTATION.summary },
     schema: [
@@ -9669,6 +9674,7 @@ var no_unlocalized_toast_default = createRule({
           ...LOCALIZATION_PROPERTIES,
           functions: COMPONENT_IMPORT_SCHEMA,
           methods: {
+            description: "Toast method names whose user-visible messages require localization.",
             type: "array",
             items: { type: "string", minLength: 1 },
             uniqueItems: true
@@ -9681,7 +9687,6 @@ var no_unlocalized_toast_default = createRule({
       unlocalized: "Translate this user-facing literal or add an explicit localization exception."
     }
   },
-  defaultOptions: [{ enabled: true }],
   create(context, [options]) {
     if (localizationExcluded(context, context.sourceCode.text, options))
       return {};
@@ -9773,6 +9778,7 @@ var no_unlocalized_jsx_attributes_default = createRule({
   name: "no-unlocalized-jsx-attributes",
   documentation: NO_UNLOCALIZED_JSX_ATTRIBUTES_DOCUMENTATION,
   meta: {
+    defaultOptions: [{ enabled: true }],
     type: "suggestion",
     docs: { description: NO_UNLOCALIZED_JSX_ATTRIBUTES_DOCUMENTATION.summary },
     schema: [
@@ -9781,6 +9787,7 @@ var no_unlocalized_jsx_attributes_default = createRule({
         properties: {
           ...LOCALIZATION_PROPERTIES,
           attributes: {
+            description: "JSX attributes whose user-visible text requires localization.",
             type: "array",
             items: { type: "string", minLength: 1 },
             uniqueItems: true
@@ -9793,7 +9800,6 @@ var no_unlocalized_jsx_attributes_default = createRule({
       unlocalized: "Translate this user-facing literal or add an explicit localization exception."
     }
   },
-  defaultOptions: [{ enabled: true }],
   create(context, [options]) {
     if (localizationExcluded(context, context.sourceCode.text, options))
       return {};
@@ -9858,6 +9864,7 @@ var no_unlocalized_jsx_text_default = createRule({
   name: "no-unlocalized-jsx-text",
   documentation: NO_UNLOCALIZED_JSX_TEXT_DOCUMENTATION,
   meta: {
+    defaultOptions: [{ enabled: true }],
     type: "suggestion",
     docs: { description: NO_UNLOCALIZED_JSX_TEXT_DOCUMENTATION.summary },
     schema: [
@@ -9871,7 +9878,6 @@ var no_unlocalized_jsx_text_default = createRule({
       unlocalized: "Translate this user-facing literal or add an explicit localization exception."
     }
   },
-  defaultOptions: [{ enabled: true }],
   create(context, [options]) {
     if (localizationExcluded(context, context.sourceCode.text, options))
       return {};
@@ -12655,6 +12661,7 @@ var no_dynamic_sql_default = createRule({
   name: "no-dynamic-sql",
   documentation: NO_DYNAMIC_SQL_DOCUMENTATION,
   meta: {
+    defaultOptions: [{}],
     type: "problem",
     docs: {
       description: NO_DYNAMIC_SQL_DOCUMENTATION.summary
@@ -12677,7 +12684,6 @@ var no_dynamic_sql_default = createRule({
       dynamicFragment: "Runtime fragment interpolated into SQL passed to `{{method}}()`. Bind data values; select non-bindable SQL fragments from fixed, reviewed alternatives."
     }
   },
-  defaultOptions: [{}],
   create(context, [options]) {
     const methods = new Set(options?.methods ?? DEFAULT_METHODS);
     return {
@@ -12749,6 +12755,7 @@ var no_enum_default = createRule({
   name: "no-enum",
   documentation: NO_ENUM_DOCUMENTATION,
   meta: {
+    defaultOptions: [{}],
     type: "suggestion",
     fixable: "code",
     docs: {
@@ -12771,7 +12778,6 @@ var no_enum_default = createRule({
       noEnum: 'Enums are discouraged. Use a string-literal union (e.g. `type Status = "active" | "inactive"`) or an `as const` object instead.'
     }
   },
-  defaultOptions: [{}],
   create(context, [optionsArg]) {
     const options = optionsArg ?? {};
     const ignoreFiles = options.ignoreFiles ?? [];
@@ -13318,6 +13324,7 @@ var no_fat_try_blocks_default = createRule({
   name: "no-fat-try-blocks",
   documentation: NO_FAT_TRY_BLOCKS_DOCUMENTATION,
   meta: {
+    defaultOptions: [{ max: MAX_TRY_BODY_STATEMENTS }],
     type: "problem",
     docs: {
       description: "Review try blocks exceeding the configured count of syntactically selected operations."
@@ -13326,7 +13333,7 @@ var no_fat_try_blocks_default = createRule({
       {
         type: "object",
         properties: {
-          max: { type: "integer", minimum: 1 }
+          max: { description: "Maximum number of statements allowed in one try body.", type: "integer", minimum: 1 }
         },
         additionalProperties: false
       }
@@ -13335,7 +13342,6 @@ var no_fat_try_blocks_default = createRule({
       fatTryBlock: "This `try` block has {{count}} syntactically selected operations (max {{max}}). Review whether they share one recovery policy; move unrelated work outside the boundary."
     }
   },
-  defaultOptions: [{ max: MAX_TRY_BODY_STATEMENTS }],
   create(context, [options]) {
     if (isGeneratedFile(context, context.sourceCode.text)) {
       return {};
@@ -13486,6 +13492,7 @@ var no_hand_rolled_sleep_default = createRule({
   name: "no-hand-rolled-sleep",
   documentation: NO_HAND_ROLLED_SLEEP_DOCUMENTATION,
   meta: {
+    defaultOptions: [{}],
     type: "problem",
     docs: {
       description: "Disallow uncancellable promisified timers and timeout arms."
@@ -13512,7 +13519,6 @@ var no_hand_rolled_sleep_default = createRule({
       handRolledTimeoutRace: "Hand-rolled timeout arm: when the other promise wins, this timer is never cleared and keeps the event loop alive until it fires. Use `AbortSignal.timeout(ms)` and pass the signal to the operation."
     }
   },
-  defaultOptions: [{}],
   create(context, [optionsArg]) {
     const { filename, sourceCode } = context;
     if (isTestFile(context) || isScriptFile(context) || isGeneratedFile(context, sourceCode.getText())) {
@@ -15788,6 +15794,7 @@ var no_impossible_zod_literal_bounds_default = createRule({
   name: "no-impossible-zod-literal-bounds",
   documentation: NO_IMPOSSIBLE_ZOD_LITERAL_BOUNDS_DOCUMENTATION,
   meta: {
+    defaultOptions: [{}],
     type: "problem",
     docs: {
       description: "Disallow same-chain literal Zod bounds whose accepted set is mathematically empty."
@@ -15808,7 +15815,6 @@ var no_impossible_zod_literal_bounds_default = createRule({
       impossibleBounds: "This Zod {{kind}} schema accepts no values: {{lower}} conflicts with {{upper}}."
     }
   },
-  defaultOptions: [{}],
   create(context, [options]) {
     const sourceCode = context.sourceCode;
     if (isTestFile(context) || isGeneratedFile(context, sourceCode.getText())) {
@@ -16851,6 +16857,7 @@ var no_log_only_catch_default = createRule({
   name: "no-log-only-catch",
   documentation: NO_LOG_ONLY_CATCH_DOCUMENTATION,
   meta: {
+    defaultOptions: [{}],
     type: "problem",
     docs: {
       description: "Disallow `catch` clauses that only log (or silently do nothing) and then swallow the error; rethrow or handle it instead."
@@ -16867,7 +16874,6 @@ var no_log_only_catch_default = createRule({
       emptyCatch: "Empty catch silently swallows the error. Rethrow it, handle it, or add a comment explaining why it is safe to ignore."
     }
   },
-  defaultOptions: [{}],
   create(context, [loggingOptions]) {
     const matcher = createLogMatcher(loggingOptions);
     const filename = context.filename;
@@ -18652,6 +18658,7 @@ var no_raw_fetch_outside_clients_default = createRule({
   name: "no-raw-fetch-outside-clients",
   documentation: NO_RAW_FETCH_OUTSIDE_CLIENTS_DOCUMENTATION,
   meta: {
+    defaultOptions: [{}],
     type: "problem",
     docs: {
       description: "Disallow calling the global `fetch` outside the client layer; route outbound HTTP through a client module that owns retry, timeout and status handling."
@@ -18666,6 +18673,7 @@ var no_raw_fetch_outside_clients_default = createRule({
             description: "Regular-expression sources matched against the filename. Replaces the defaults."
           },
           basePath: {
+            description: "Static application URL base path without query strings, fragments or parent segments.",
             type: "string",
             pattern: "^/(?!$)(?!.*[?#])(?!(?:.*/)?\\.\\.?(?:/|$))(?:[^/]+/)*[^/]+$"
           }
@@ -18677,7 +18685,6 @@ var no_raw_fetch_outside_clients_default = createRule({
       rawFetch: "Raw `fetch()` outside a client module. Route the call through a client (e.g. `clients/*-client.ts`) so it inherits retry, timeout and status handling and stays stubbable in tests."
     }
   },
-  defaultOptions: [{}],
   create(context, [options]) {
     const filename = context.filename;
     if (isTestFile(context) || isScriptFile(context) || NON_PRODUCTION_TREE_RE.test(filename)) {
@@ -18843,6 +18850,7 @@ var no_restricted_library_load_default = createRule({
   name: "no-restricted-library-load",
   documentation: NO_RESTRICTED_LIBRARY_LOAD_DOCUMENTATION,
   meta: {
+    defaultOptions: [{ libraries: [] }],
     type: "problem",
     docs: {
       description: NO_RESTRICTED_LIBRARY_LOAD_DOCUMENTATION.summary
@@ -18854,6 +18862,7 @@ var no_restricted_library_load_default = createRule({
         required: ["libraries"],
         properties: {
           libraries: {
+            description: "Library import and module-load restrictions.",
             type: "array",
             items: {
               type: "object",
@@ -18874,7 +18883,6 @@ var no_restricted_library_load_default = createRule({
       restrictedLibraryLoad: "{{id}}: Replace this runtime dependency reference to {{module}} with {{replacement}}.{{note}}"
     }
   },
-  defaultOptions: [{ libraries: [] }],
   create(context, [options]) {
     const restrictions = options.libraries;
     function report2(node, source) {
@@ -19852,6 +19860,7 @@ var no_secret_in_log_default = createRule({
   name: "no-secret-in-log",
   documentation: NO_SECRET_IN_LOG_DOCUMENTATION,
   meta: {
+    defaultOptions: [{}],
     type: "problem",
     docs: {
       description: "Disallow passing a secret-named value or a raw request/response blob to a logging call; both leak to log sinks. Redact or omit."
@@ -19868,7 +19877,6 @@ var no_secret_in_log_default = createRule({
       noRawBodyInLog: "Raw `{{name}}` passed to a logging call. Request/response bodies can contain personal data or credentials. Log allowlisted non-sensitive context or use an approved redactor."
     }
   },
-  defaultOptions: [{}],
   create(context, [loggingOptions]) {
     const matcher = createLogMatcher(loggingOptions);
     const blobArmApplies = !isTestFile(context);
@@ -20899,6 +20907,7 @@ var no_sentinel_return_on_catch_default = createRule({
   name: "no-sentinel-return-on-catch",
   documentation: NO_SENTINEL_RETURN_ON_CATCH_DOCUMENTATION,
   meta: {
+    defaultOptions: [{}],
     type: "problem",
     docs: {
       description: "Disallow swallowing a caught error by returning an empty sentinel unless the error is handled or the sentinel is part of the function contract."
@@ -20914,7 +20923,6 @@ var no_sentinel_return_on_catch_default = createRule({
       noSentinelReturn: "This `catch` block swallows the error by returning an empty sentinel without logging it. Rethrow it, log/report it, or return a typed Result."
     }
   },
-  defaultOptions: [{}],
   create(context, [loggingOptions]) {
     if (isGeneratedFile(context, context.sourceCode.text)) {
       return {};
@@ -21461,6 +21469,7 @@ var no_storage_in_stateless_modules_default = createRule({
   name: "no-storage-in-stateless-modules",
   documentation: NO_STORAGE_IN_STATELESS_MODULES_DOCUMENTATION,
   meta: {
+    defaultOptions: [{}],
     type: "problem",
     docs: {
       description: "Disallow SQL or key/value access inside configured stateless modules; derive state from a system of record instead."
@@ -21487,7 +21496,6 @@ var no_storage_in_stateless_modules_default = createRule({
       storageInStatelessModule: "`{{method}}()` reaches for private storage inside a module declared stateless. Derive the state from a read against the system of record, or from a marker in the artefact this feature already produces."
     }
   },
-  defaultOptions: [{}],
   create(context, [options]) {
     if (isTestFile(context)) {
       return {};
@@ -23080,6 +23088,7 @@ var no_declaration_comment_wall_default = createRule({
   name: "no-declaration-comment-wall",
   documentation: NO_DECLARATION_COMMENT_WALL_DOCUMENTATION,
   meta: {
+    defaultOptions: [WALL_DEFAULTS],
     type: "suggestion",
     fixable: "code",
     docs: {
@@ -23090,7 +23099,6 @@ var no_declaration_comment_wall_default = createRule({
       commentWall: "{{restated}} of this declaration's {{commented}} member comments only re-spell member names \u2014 delete them; if a row still needs narration, give the member a clearer name. Keep constraints, lifecycle, and rationale."
     }
   },
-  defaultOptions: [WALL_DEFAULTS],
   create(context, [provided]) {
     const options = { ...WALL_DEFAULTS, ...provided };
     const sourceCode = context.sourceCode;
@@ -23442,6 +23450,7 @@ var no_type_member_comment_wall_default = createRule({
   name: "no-type-member-comment-wall",
   documentation: NO_TYPE_MEMBER_COMMENT_WALL_DOCUMENTATION,
   meta: {
+    defaultOptions: [WALL_DEFAULTS],
     type: "suggestion",
     fixable: "code",
     docs: {
@@ -23452,7 +23461,6 @@ var no_type_member_comment_wall_default = createRule({
       commentWall: "{{restated}} of this type's {{commented}} member comments appear to repeat names and types \u2014 review them for removal or clearer naming. Keep constraints and rationale."
     }
   },
-  defaultOptions: [WALL_DEFAULTS],
   create(context, [provided]) {
     const options = { ...WALL_DEFAULTS, ...provided };
     const sourceCode = context.sourceCode;
@@ -24011,12 +24019,12 @@ var no_first_party_module_mock_default = createRule({
   name: "no-first-party-module-mock",
   documentation: NO_FIRST_PARTY_MODULE_MOCK_DOCUMENTATION,
   meta: {
+    defaultOptions: [{ additionalModulePrefixes: [] }],
     type: "problem",
     docs: { description: NO_FIRST_PARTY_MODULE_MOCK_DOCUMENTATION.summary },
-    schema: [{ type: "object", additionalProperties: false, properties: { additionalModulePrefixes: { type: "array", items: { type: "string", minLength: 1 }, uniqueItems: true } } }],
+    schema: [{ type: "object", additionalProperties: false, properties: { additionalModulePrefixes: { description: "Additional maintained module prefixes that tests must not mock.", type: "array", items: { type: "string", minLength: 1 }, uniqueItems: true } } }],
     messages: { noFirstPartyModuleMock: "This test replaces the maintained module `{{module}}`. Inject a narrow collaborator or test the real module; suppress locally only when module lookup or bootstrap behavior is the contract." }
   },
-  defaultOptions: [{ additionalModulePrefixes: [] }],
   create(context, [options]) {
     if (!isTestFile(context) || isGeneratedFile(context, context.sourceCode.text)) return {};
     return {
@@ -26227,6 +26235,7 @@ var prefer_shadcn_primitives_default = createRule({
   name: "prefer-shadcn-primitives",
   documentation: PREFER_SHADCN_PRIMITIVES_DOCUMENTATION,
   meta: {
+    defaultOptions: [{}],
     type: "suggestion",
     docs: {
       description: "Require visible raw JSX controls to use the corresponding shared shadcn primitive."
@@ -26235,8 +26244,8 @@ var prefer_shadcn_primitives_default = createRule({
       {
         type: "object",
         properties: {
-          assumeAvailable: { type: "boolean" },
-          detectProjectPrimitives: { type: "boolean" }
+          assumeAvailable: { description: "Assume supported shared UI primitives are available in this project.", type: "boolean" },
+          detectProjectPrimitives: { description: "Resolve project-owned UI primitives before recommending replacements.", type: "boolean" }
         },
         additionalProperties: false
       }
@@ -26245,7 +26254,6 @@ var prefer_shadcn_primitives_default = createRule({
       preferShadcnPrimitive: "Use the shared {{ replacement }} shadcn primitive instead of raw <{{ element }}> markup."
     }
   },
-  defaultOptions: [{}],
   create(context, [options]) {
     const filename = context.filename.replaceAll("\\", "/");
     if (isTestFile(context) || isStoryFile(context) || isGeneratedFile(context, context.sourceCode.text) || SHARED_PRIMITIVE_IMPLEMENTATION_RE.test(filename)) {
@@ -26622,6 +26630,7 @@ var prefer_module_level_constant_default = createRule({
   name: "prefer-module-level-constant",
   documentation: PREFER_MODULE_LEVEL_CONSTANT_DOCUMENTATION,
   meta: {
+    defaultOptions: [{}],
     type: "suggestion",
     fixable: "code",
     docs: {
@@ -26632,9 +26641,9 @@ var prefer_module_level_constant_default = createRule({
         type: "object",
         additionalProperties: false,
         properties: {
-          minElements: { type: "number", minimum: 1 },
-          checkRegex: { type: "boolean" },
-          ignoreTestFiles: { type: "boolean" }
+          minElements: { description: "Minimum collection size before recommending a module-level constant.", type: "number", minimum: 1 },
+          checkRegex: { description: "Include reusable regular expression literals in hoisting checks.", type: "boolean" },
+          ignoreTestFiles: { description: "Skip test files when recommending module-level constants.", type: "boolean" }
         }
       }
     ],
@@ -26643,7 +26652,6 @@ var prefer_module_level_constant_default = createRule({
       hoistRegex: "`{{name}}` is a constant regex recompiled on every call. Hoist it to module scope."
     }
   },
-  defaultOptions: [{}],
   create(context, [optionsArg]) {
     const options = optionsArg ?? {};
     const minElements = options.minElements ?? DEFAULT_MIN_ELEMENTS;
@@ -26952,6 +26960,7 @@ var prefer_module_level_schema_default = createRule({
   name: "prefer-module-level-schema",
   documentation: PREFER_MODULE_LEVEL_SCHEMA_DOCUMENTATION,
   meta: {
+    defaultOptions: [{}],
     type: "problem",
     docs: {
       description: "Declare a Zod schema at module scope when it closes over nothing in the enclosing function"
@@ -26987,7 +26996,6 @@ var prefer_module_level_schema_default = createRule({
       hoistSchema: "Move this `{{factory}}` schema to module scope. It uses nothing from `{{owner}}`, so it is rebuilt on every call for no benefit and cannot be exported, reused, or `z.infer`-ed from where it is."
     }
   },
-  defaultOptions: [{}],
   create(context, [options]) {
     const factories = new Set(options?.factories ?? DEFAULT_FACTORIES);
     const ignoreTestFiles = options?.ignoreTestFiles ?? true;
@@ -27640,6 +27648,7 @@ var prefer_multi_value_zod_literal_default = createRule({
   name: "prefer-multi-value-zod-literal",
   documentation: PREFER_MULTI_VALUE_ZOD_LITERAL_DOCUMENTATION,
   meta: {
+    defaultOptions: [{}],
     type: "suggestion",
     docs: {
       description: "Use the Zod 4 multi-value literal API instead of a union of literal schemas."
@@ -27649,7 +27658,7 @@ var prefer_multi_value_zod_literal_default = createRule({
         type: "object",
         additionalProperties: false,
         properties: {
-          zodMajorVersion: { type: "integer", minimum: 4, maximum: 4 }
+          zodMajorVersion: { description: "Installed Zod major version used to validate multi-value literal support.", type: "integer", minimum: 4, maximum: 4 }
         }
       }
     ],
@@ -27657,7 +27666,6 @@ var prefer_multi_value_zod_literal_default = createRule({
       useMultiValueLiteral: "Replace this literal-schema union with {{zod}}.literal([\u2026])."
     }
   },
-  defaultOptions: [{}],
   create(context, [options]) {
     if (isTestFile(context) || isGeneratedFile(context, context.sourceCode.text))
       return {};
@@ -29732,13 +29740,14 @@ var prefer_await_in_async_return_default = createRule({
   name: "prefer-await-in-async-return",
   documentation: PREFER_AWAIT_IN_ASYNC_RETURN_DOCUMENTATION,
   meta: {
+    defaultOptions: [{ scope: "async-return" }],
     type: "suggestion",
     docs: {
       description: "Prefer explicit `await` for proven Promise `.then` calls; the default scope checks direct async returns."
     },
     schema: [{
       type: "object",
-      properties: { scope: { type: "string", enum: ["async-return", "all-promise-calls"] } },
+      properties: { scope: { description: "Check async return statements or every promise-valued call.", type: "string", enum: ["async-return", "all-promise-calls"] } },
       additionalProperties: false
     }],
     messages: {
@@ -29746,7 +29755,6 @@ var prefer_await_in_async_return_default = createRule({
       preferAwaitCall: "This call uses built-in Promise.then(). Use async/await, preserving rejection handling and observable scheduling when rewriting."
     }
   },
-  defaultOptions: [{ scope: "async-return" }],
   create(context, [options]) {
     let services;
     try {
@@ -30960,6 +30968,7 @@ var prefer_semantic_colors_default = createRule({
   name: "prefer-semantic-colors",
   documentation: PREFER_SEMANTIC_COLORS_DOCUMENTATION,
   meta: {
+    defaultOptions: [{}],
     type: "suggestion",
     docs: {
       description: "Enforce semantic color tokens over raw Tailwind palette classes, arbitrary color values, and inline color literals."
@@ -30969,8 +30978,8 @@ var prefer_semantic_colors_default = createRule({
         type: "object",
         additionalProperties: false,
         properties: {
-          requireSemanticTokens: { type: "boolean" },
-          opaqueForegroundPairs: { type: "boolean" }
+          requireSemanticTokens: { description: "Restrict checks to projects with an existing semantic token system.", type: "boolean" },
+          opaqueForegroundPairs: { description: "Use the project semantic foreground roles to check opaque foreground and background pairs.", type: "boolean" }
         }
       }
     ],
@@ -30981,7 +30990,6 @@ var prefer_semantic_colors_default = createRule({
       opaqueForegroundPair: "'{{class}}' bypasses the declared '{{replacement}}' token paired with '{{background}}'."
     }
   },
-  defaultOptions: [{}],
   create(context, [options]) {
     if (STORIES_FILE_RE.test(context.filename)) return {};
     if (staticallyImportsExternalRenderer(context.sourceCode.ast)) return {};
@@ -31283,6 +31291,7 @@ var prefer_server_actions_default = createRule({
   name: "prefer-server-actions",
   documentation: PREFER_SERVER_ACTIONS_DOCUMENTATION,
   meta: {
+    defaultOptions: [{}],
     type: "suggestion",
     docs: {
       description: "Prefer Next.js Server Actions over same-origin API mutations."
@@ -31293,6 +31302,7 @@ var prefer_server_actions_default = createRule({
         additionalProperties: false,
         properties: {
           basePath: {
+            description: "Static application URL base path without query strings, fragments or parent segments.",
             type: "string",
             pattern: "^/(?!$)(?!.*[?#])(?!(?:.*/)?\\.\\.?(?:/|$))(?:[^/]+/)*[^/]+$"
           }
@@ -31303,7 +31313,6 @@ var prefer_server_actions_default = createRule({
       preferServerAction: "This client mutation targets a same-origin API route. Consider a Server Action to remove the hand-written API wrapper; retain authorization and validation, since the call still crosses a network boundary."
     }
   },
-  defaultOptions: [{}],
   create(context, [options]) {
     const filename = context.filename.replaceAll("\\", "/");
     if (SKIP_FILE_REGEX.test(filename)) {
@@ -32317,6 +32326,7 @@ var prefer_zod_infer_default = createRule({
   name: "prefer-zod-infer",
   documentation: PREFER_ZOD_INFER_DOCUMENTATION,
   meta: {
+    defaultOptions: [{}],
     type: "problem",
     fixable: "code",
     docs: {
@@ -32328,10 +32338,11 @@ var prefer_zod_infer_default = createRule({
         additionalProperties: false,
         properties: {
           ignoreTypeNames: {
+            description: "Regular expression patterns for type names to leave unchanged.",
             type: "array",
             items: { type: "string" }
           },
-          requireIdenticalShape: { type: "boolean" }
+          requireIdenticalShape: { description: "Require the schema output and declared type to have identical property shapes.", type: "boolean" }
         }
       }
     ],
@@ -32340,7 +32351,6 @@ var prefer_zod_infer_default = createRule({
       repeatedEnumUnion: "`{{propertyName}}` repeats the literal domain already named by `{{typeName}}` and `{{schemaName}}` in multiple object types. Reuse `{{typeName}}` so the accepted values have one source of truth."
     }
   },
-  defaultOptions: [{}],
   create(context, [optionsArg]) {
     const ignorePatterns = (optionsArg?.ignoreTypeNames ?? []).map(
       (source) => new RegExp(source, "u")
@@ -33679,6 +33689,7 @@ var require_fetch_timeout_default = createRule({
   name: "require-fetch-timeout",
   documentation: REQUIRE_FETCH_TIMEOUT_DOCUMENTATION,
   meta: {
+    defaultOptions: [{}],
     type: "problem",
     docs: {
       description: "Require an explicit abort signal on locally analyzable global fetch calls."
@@ -33700,7 +33711,6 @@ var require_fetch_timeout_default = createRule({
       missingSignal: "This `fetch()` has no explicit abort signal. Pass `AbortSignal.timeout(ms)` for a deadline, or an owner-managed signal for cancellation."
     }
   },
-  defaultOptions: [{}],
   create(context, [optionsArg]) {
     if (isTestFile(context) || isScriptFile(context)) {
       return {};
@@ -35802,6 +35812,7 @@ var stepdown_default = createRule({
   name: "stepdown",
   documentation: STEPDOWN_DOCUMENTATION,
   meta: {
+    defaultOptions: [{}],
     type: "suggestion",
     fixable: "code",
     docs: {
@@ -35823,7 +35834,6 @@ var stepdown_default = createRule({
       helperAboveOnlyCaller: "Private helper `{{helper}}` is defined above its only caller `{{caller}}`; move it below the caller."
     }
   },
-  defaultOptions: [{}],
   create(context, [options]) {
     if (isTestFile(context) || isGeneratedFile(context, context.sourceCode.text))
       return {};

package/dist/index.js

@@ -1025,13 +1025,13 @@ var no_test_comments_default = createRule({
   name: "no-test-comments",
   documentation: NO_TEST_COMMENTS_DOCUMENTATION,
   meta: {
+    defaultOptions: [{}],
     type: "suggestion",
     fixable: "code",
     docs: { description: NO_TEST_COMMENTS_DOCUMENTATION.summary },
-    schema: [{ type: "object", properties: { allFiles: { type: "boolean" } }, additionalProperties: false }],
+    schema: [{ type: "object", properties: { allFiles: { description: "Check every eligible test file without requiring frontend framework ownership.", type: "boolean" } }, additionalProperties: false }],
     messages: { testComment: "Express this explanation in the test name, fixture or assertion, then remove the comment." }
   },
-  defaultOptions: [{}],
   create(context, [options]) {
     if (!isTestFile(context) || isGeneratedFile(context, context.sourceCode.text)) return {};
     if (!ownsTestComments(context)) return {};
@@ -1120,13 +1120,13 @@ var no_frontend_comments_default = createRule({
   name: "no-frontend-comments",
   documentation: NO_FRONTEND_COMMENTS_DOCUMENTATION,
   meta: {
+    defaultOptions: [{}],
     type: "suggestion",
     fixable: "code",
     docs: { description: NO_FRONTEND_COMMENTS_DOCUMENTATION.summary },
-    schema: [{ type: "object", properties: { allFiles: { type: "boolean" } }, additionalProperties: false }],
+    schema: [{ type: "object", properties: { allFiles: { description: "Check comments without requiring frontend framework ownership.", type: "boolean" } }, additionalProperties: false }],
     messages: { noFrontendComments: "Frontend comments are prohibited; express the behavior in names, types or code and review any directive or legal contract before removing it." }
   },
-  defaultOptions: [{}],
   create(context, [options]) {
     if (isGeneratedFile(context, context.sourceCode.text) || ownsTestComments(context)) return {};
     const jsxRanges = [];
@@ -4781,7 +4781,7 @@ function isSearchParamReceiver(call, services) {
 // package.json
 var package_default = {
   name: "@sarj/eslint-plugin",
-  version: "17.1.2",
+  version: "17.1.3",
   packageManager: "npm@12.2.1",
   description: "Custom ESLint rules for hypermodern TypeScript / React / Next.js projects",
   type: "module",
@@ -4855,6 +4855,7 @@ var package_default = {
     "@vitest/eslint-plugin": "1.6.28",
     eslint: "10.13.0",
     "eslint-node-test": "1.0.1",
+    "eslint-plugin-eslint-plugin": "7.6.2",
     "eslint-plugin-better-tailwindcss": "^4.10.0",
     "eslint-plugin-jest": "29.17.0",
     "eslint-plugin-jsdoc": "65.4.2",
@@ -4875,6 +4876,7 @@ var package_default = {
     jiti: "2.7.0",
     prettier: "3.9.10",
     tsup: "9.0.0",
+    syncpack: "15.3.3",
     typescript: "npm:@typescript/typescript6@6.0.2",
     "typescript-eslint": "^8.72.0",
     uuid: "13.0.0",
@@ -9122,6 +9124,7 @@ var require_button_accessible_name_default = createRule({
   name: "require-button-accessible-name",
   documentation: REQUIRE_BUTTON_ACCESSIBLE_NAME_DOCUMENTATION,
   meta: {
+    defaultOptions: [{}],
     type: "problem",
     docs: { description: REQUIRE_BUTTON_ACCESSIBLE_NAME_DOCUMENTATION.summary },
     schema: [
@@ -9130,6 +9133,7 @@ var require_button_accessible_name_default = createRule({
         properties: {
           components: COMPONENT_IMPORT_SCHEMA,
           iconModules: {
+            description: "Module names whose imported components count as icons.",
             type: "array",
             items: { type: "string", minLength: 1 },
             uniqueItems: true
@@ -9142,7 +9146,6 @@ var require_button_accessible_name_default = createRule({
       missingName: "This button has no statically identifiable accessible name. Add action text, aria-label, or aria-labelledby."
     }
   },
-  defaultOptions: [{}],
   create(context, [options]) {
     if (isGeneratedFile(context, context.sourceCode.text) || isTestFile(context) || isStoryFile(context))
       return {};
@@ -9461,6 +9464,7 @@ var prefer_logical_tailwind_utilities_default = createRule({
   name: "prefer-logical-tailwind-utilities",
   documentation: PREFER_LOGICAL_TAILWIND_UTILITIES_DOCUMENTATION,
   meta: {
+    defaultOptions: [{ enabled: true, checkInsets: false, allowUtilities: [] }],
     type: "suggestion",
     docs: {
       description: PREFER_LOGICAL_TAILWIND_UTILITIES_DOCUMENTATION.summary
@@ -9469,9 +9473,10 @@ var prefer_logical_tailwind_utilities_default = createRule({
       {
         type: "object",
         properties: {
-          enabled: { type: "boolean" },
-          checkInsets: { type: "boolean" },
+          enabled: { description: "Enable replacement of physical direction utilities with logical equivalents.", type: "boolean" },
+          checkInsets: { description: "Include physical inset utilities in direction checks.", type: "boolean" },
           allowUtilities: {
+            description: "Physical utility names allowed without a logical replacement.",
             type: "array",
             items: { type: "string" },
             uniqueItems: true
@@ -9484,7 +9489,6 @@ var prefer_logical_tailwind_utilities_default = createRule({
       physicalUtility: "Use '{{replacement}}' instead of '{{utility}}' in this bidirectional UI, or explicitly allow intentional physical placement."
     }
   },
-  defaultOptions: [{ enabled: true, checkInsets: false, allowUtilities: [] }],
   create(context, [options]) {
     if (options?.enabled === false || isGeneratedFile(context, context.sourceCode.text) || isTestFile(context) || isStoryFile(context))
       return {};
@@ -9612,6 +9616,7 @@ var no_unlocalized_toast_default = createRule({
   name: "no-unlocalized-toast",
   documentation: NO_UNLOCALIZED_TOAST_DOCUMENTATION,
   meta: {
+    defaultOptions: [{ enabled: true }],
     type: "suggestion",
     docs: { description: NO_UNLOCALIZED_TOAST_DOCUMENTATION.summary },
     schema: [
@@ -9621,6 +9626,7 @@ var no_unlocalized_toast_default = createRule({
           ...LOCALIZATION_PROPERTIES,
           functions: COMPONENT_IMPORT_SCHEMA,
           methods: {
+            description: "Toast method names whose user-visible messages require localization.",
             type: "array",
             items: { type: "string", minLength: 1 },
             uniqueItems: true
@@ -9633,7 +9639,6 @@ var no_unlocalized_toast_default = createRule({
       unlocalized: "Translate this user-facing literal or add an explicit localization exception."
     }
   },
-  defaultOptions: [{ enabled: true }],
   create(context, [options]) {
     if (localizationExcluded(context, context.sourceCode.text, options))
       return {};
@@ -9725,6 +9730,7 @@ var no_unlocalized_jsx_attributes_default = createRule({
   name: "no-unlocalized-jsx-attributes",
   documentation: NO_UNLOCALIZED_JSX_ATTRIBUTES_DOCUMENTATION,
   meta: {
+    defaultOptions: [{ enabled: true }],
     type: "suggestion",
     docs: { description: NO_UNLOCALIZED_JSX_ATTRIBUTES_DOCUMENTATION.summary },
     schema: [
@@ -9733,6 +9739,7 @@ var no_unlocalized_jsx_attributes_default = createRule({
         properties: {
           ...LOCALIZATION_PROPERTIES,
           attributes: {
+            description: "JSX attributes whose user-visible text requires localization.",
             type: "array",
             items: { type: "string", minLength: 1 },
             uniqueItems: true
@@ -9745,7 +9752,6 @@ var no_unlocalized_jsx_attributes_default = createRule({
       unlocalized: "Translate this user-facing literal or add an explicit localization exception."
     }
   },
-  defaultOptions: [{ enabled: true }],
   create(context, [options]) {
     if (localizationExcluded(context, context.sourceCode.text, options))
       return {};
@@ -9810,6 +9816,7 @@ var no_unlocalized_jsx_text_default = createRule({
   name: "no-unlocalized-jsx-text",
   documentation: NO_UNLOCALIZED_JSX_TEXT_DOCUMENTATION,
   meta: {
+    defaultOptions: [{ enabled: true }],
     type: "suggestion",
     docs: { description: NO_UNLOCALIZED_JSX_TEXT_DOCUMENTATION.summary },
     schema: [
@@ -9823,7 +9830,6 @@ var no_unlocalized_jsx_text_default = createRule({
       unlocalized: "Translate this user-facing literal or add an explicit localization exception."
     }
   },
-  defaultOptions: [{ enabled: true }],
   create(context, [options]) {
     if (localizationExcluded(context, context.sourceCode.text, options))
       return {};
@@ -12607,6 +12613,7 @@ var no_dynamic_sql_default = createRule({
   name: "no-dynamic-sql",
   documentation: NO_DYNAMIC_SQL_DOCUMENTATION,
   meta: {
+    defaultOptions: [{}],
     type: "problem",
     docs: {
       description: NO_DYNAMIC_SQL_DOCUMENTATION.summary
@@ -12629,7 +12636,6 @@ var no_dynamic_sql_default = createRule({
       dynamicFragment: "Runtime fragment interpolated into SQL passed to `{{method}}()`. Bind data values; select non-bindable SQL fragments from fixed, reviewed alternatives."
     }
   },
-  defaultOptions: [{}],
   create(context, [options]) {
     const methods = new Set(options?.methods ?? DEFAULT_METHODS);
     return {
@@ -12701,6 +12707,7 @@ var no_enum_default = createRule({
   name: "no-enum",
   documentation: NO_ENUM_DOCUMENTATION,
   meta: {
+    defaultOptions: [{}],
     type: "suggestion",
     fixable: "code",
     docs: {
@@ -12723,7 +12730,6 @@ var no_enum_default = createRule({
       noEnum: 'Enums are discouraged. Use a string-literal union (e.g. `type Status = "active" | "inactive"`) or an `as const` object instead.'
     }
   },
-  defaultOptions: [{}],
   create(context, [optionsArg]) {
     const options = optionsArg ?? {};
     const ignoreFiles = options.ignoreFiles ?? [];
@@ -13270,6 +13276,7 @@ var no_fat_try_blocks_default = createRule({
   name: "no-fat-try-blocks",
   documentation: NO_FAT_TRY_BLOCKS_DOCUMENTATION,
   meta: {
+    defaultOptions: [{ max: MAX_TRY_BODY_STATEMENTS }],
     type: "problem",
     docs: {
       description: "Review try blocks exceeding the configured count of syntactically selected operations."
@@ -13278,7 +13285,7 @@ var no_fat_try_blocks_default = createRule({
       {
         type: "object",
         properties: {
-          max: { type: "integer", minimum: 1 }
+          max: { description: "Maximum number of statements allowed in one try body.", type: "integer", minimum: 1 }
         },
         additionalProperties: false
       }
@@ -13287,7 +13294,6 @@ var no_fat_try_blocks_default = createRule({
       fatTryBlock: "This `try` block has {{count}} syntactically selected operations (max {{max}}). Review whether they share one recovery policy; move unrelated work outside the boundary."
     }
   },
-  defaultOptions: [{ max: MAX_TRY_BODY_STATEMENTS }],
   create(context, [options]) {
     if (isGeneratedFile(context, context.sourceCode.text)) {
       return {};
@@ -13438,6 +13444,7 @@ var no_hand_rolled_sleep_default = createRule({
   name: "no-hand-rolled-sleep",
   documentation: NO_HAND_ROLLED_SLEEP_DOCUMENTATION,
   meta: {
+    defaultOptions: [{}],
     type: "problem",
     docs: {
       description: "Disallow uncancellable promisified timers and timeout arms."
@@ -13464,7 +13471,6 @@ var no_hand_rolled_sleep_default = createRule({
       handRolledTimeoutRace: "Hand-rolled timeout arm: when the other promise wins, this timer is never cleared and keeps the event loop alive until it fires. Use `AbortSignal.timeout(ms)` and pass the signal to the operation."
     }
   },
-  defaultOptions: [{}],
   create(context, [optionsArg]) {
     const { filename, sourceCode } = context;
     if (isTestFile(context) || isScriptFile(context) || isGeneratedFile(context, sourceCode.getText())) {
@@ -15746,6 +15752,7 @@ var no_impossible_zod_literal_bounds_default = createRule({
   name: "no-impossible-zod-literal-bounds",
   documentation: NO_IMPOSSIBLE_ZOD_LITERAL_BOUNDS_DOCUMENTATION,
   meta: {
+    defaultOptions: [{}],
     type: "problem",
     docs: {
       description: "Disallow same-chain literal Zod bounds whose accepted set is mathematically empty."
@@ -15766,7 +15773,6 @@ var no_impossible_zod_literal_bounds_default = createRule({
       impossibleBounds: "This Zod {{kind}} schema accepts no values: {{lower}} conflicts with {{upper}}."
     }
   },
-  defaultOptions: [{}],
   create(context, [options]) {
     const sourceCode = context.sourceCode;
     if (isTestFile(context) || isGeneratedFile(context, sourceCode.getText())) {
@@ -16812,6 +16818,7 @@ var no_log_only_catch_default = createRule({
   name: "no-log-only-catch",
   documentation: NO_LOG_ONLY_CATCH_DOCUMENTATION,
   meta: {
+    defaultOptions: [{}],
     type: "problem",
     docs: {
       description: "Disallow `catch` clauses that only log (or silently do nothing) and then swallow the error; rethrow or handle it instead."
@@ -16828,7 +16835,6 @@ var no_log_only_catch_default = createRule({
       emptyCatch: "Empty catch silently swallows the error. Rethrow it, handle it, or add a comment explaining why it is safe to ignore."
     }
   },
-  defaultOptions: [{}],
   create(context, [loggingOptions]) {
     const matcher = createLogMatcher(loggingOptions);
     const filename = context.filename;
@@ -18613,6 +18619,7 @@ var no_raw_fetch_outside_clients_default = createRule({
   name: "no-raw-fetch-outside-clients",
   documentation: NO_RAW_FETCH_OUTSIDE_CLIENTS_DOCUMENTATION,
   meta: {
+    defaultOptions: [{}],
     type: "problem",
     docs: {
       description: "Disallow calling the global `fetch` outside the client layer; route outbound HTTP through a client module that owns retry, timeout and status handling."
@@ -18627,6 +18634,7 @@ var no_raw_fetch_outside_clients_default = createRule({
             description: "Regular-expression sources matched against the filename. Replaces the defaults."
           },
           basePath: {
+            description: "Static application URL base path without query strings, fragments or parent segments.",
             type: "string",
             pattern: "^/(?!$)(?!.*[?#])(?!(?:.*/)?\\.\\.?(?:/|$))(?:[^/]+/)*[^/]+$"
           }
@@ -18638,7 +18646,6 @@ var no_raw_fetch_outside_clients_default = createRule({
       rawFetch: "Raw `fetch()` outside a client module. Route the call through a client (e.g. `clients/*-client.ts`) so it inherits retry, timeout and status handling and stays stubbable in tests."
     }
   },
-  defaultOptions: [{}],
   create(context, [options]) {
     const filename = context.filename;
     if (isTestFile(context) || isScriptFile(context) || NON_PRODUCTION_TREE_RE.test(filename)) {
@@ -18804,6 +18811,7 @@ var no_restricted_library_load_default = createRule({
   name: "no-restricted-library-load",
   documentation: NO_RESTRICTED_LIBRARY_LOAD_DOCUMENTATION,
   meta: {
+    defaultOptions: [{ libraries: [] }],
     type: "problem",
     docs: {
       description: NO_RESTRICTED_LIBRARY_LOAD_DOCUMENTATION.summary
@@ -18815,6 +18823,7 @@ var no_restricted_library_load_default = createRule({
         required: ["libraries"],
         properties: {
           libraries: {
+            description: "Library import and module-load restrictions.",
             type: "array",
             items: {
               type: "object",
@@ -18835,7 +18844,6 @@ var no_restricted_library_load_default = createRule({
       restrictedLibraryLoad: "{{id}}: Replace this runtime dependency reference to {{module}} with {{replacement}}.{{note}}"
     }
   },
-  defaultOptions: [{ libraries: [] }],
   create(context, [options]) {
     const restrictions = options.libraries;
     function report2(node, source) {
@@ -19816,6 +19824,7 @@ var no_secret_in_log_default = createRule({
   name: "no-secret-in-log",
   documentation: NO_SECRET_IN_LOG_DOCUMENTATION,
   meta: {
+    defaultOptions: [{}],
     type: "problem",
     docs: {
       description: "Disallow passing a secret-named value or a raw request/response blob to a logging call; both leak to log sinks. Redact or omit."
@@ -19832,7 +19841,6 @@ var no_secret_in_log_default = createRule({
       noRawBodyInLog: "Raw `{{name}}` passed to a logging call. Request/response bodies can contain personal data or credentials. Log allowlisted non-sensitive context or use an approved redactor."
     }
   },
-  defaultOptions: [{}],
   create(context, [loggingOptions]) {
     const matcher = createLogMatcher(loggingOptions);
     const blobArmApplies = !isTestFile(context);
@@ -20863,6 +20871,7 @@ var no_sentinel_return_on_catch_default = createRule({
   name: "no-sentinel-return-on-catch",
   documentation: NO_SENTINEL_RETURN_ON_CATCH_DOCUMENTATION,
   meta: {
+    defaultOptions: [{}],
     type: "problem",
     docs: {
       description: "Disallow swallowing a caught error by returning an empty sentinel unless the error is handled or the sentinel is part of the function contract."
@@ -20878,7 +20887,6 @@ var no_sentinel_return_on_catch_default = createRule({
       noSentinelReturn: "This `catch` block swallows the error by returning an empty sentinel without logging it. Rethrow it, log/report it, or return a typed Result."
     }
   },
-  defaultOptions: [{}],
   create(context, [loggingOptions]) {
     if (isGeneratedFile(context, context.sourceCode.text)) {
       return {};
@@ -21425,6 +21433,7 @@ var no_storage_in_stateless_modules_default = createRule({
   name: "no-storage-in-stateless-modules",
   documentation: NO_STORAGE_IN_STATELESS_MODULES_DOCUMENTATION,
   meta: {
+    defaultOptions: [{}],
     type: "problem",
     docs: {
       description: "Disallow SQL or key/value access inside configured stateless modules; derive state from a system of record instead."
@@ -21451,7 +21460,6 @@ var no_storage_in_stateless_modules_default = createRule({
       storageInStatelessModule: "`{{method}}()` reaches for private storage inside a module declared stateless. Derive the state from a read against the system of record, or from a marker in the artefact this feature already produces."
     }
   },
-  defaultOptions: [{}],
   create(context, [options]) {
     if (isTestFile(context)) {
       return {};
@@ -23044,6 +23052,7 @@ var no_declaration_comment_wall_default = createRule({
   name: "no-declaration-comment-wall",
   documentation: NO_DECLARATION_COMMENT_WALL_DOCUMENTATION,
   meta: {
+    defaultOptions: [WALL_DEFAULTS],
     type: "suggestion",
     fixable: "code",
     docs: {
@@ -23054,7 +23063,6 @@ var no_declaration_comment_wall_default = createRule({
       commentWall: "{{restated}} of this declaration's {{commented}} member comments only re-spell member names \u2014 delete them; if a row still needs narration, give the member a clearer name. Keep constraints, lifecycle, and rationale."
     }
   },
-  defaultOptions: [WALL_DEFAULTS],
   create(context, [provided]) {
     const options = { ...WALL_DEFAULTS, ...provided };
     const sourceCode = context.sourceCode;
@@ -23406,6 +23414,7 @@ var no_type_member_comment_wall_default = createRule({
   name: "no-type-member-comment-wall",
   documentation: NO_TYPE_MEMBER_COMMENT_WALL_DOCUMENTATION,
   meta: {
+    defaultOptions: [WALL_DEFAULTS],
     type: "suggestion",
     fixable: "code",
     docs: {
@@ -23416,7 +23425,6 @@ var no_type_member_comment_wall_default = createRule({
       commentWall: "{{restated}} of this type's {{commented}} member comments appear to repeat names and types \u2014 review them for removal or clearer naming. Keep constraints and rationale."
     }
   },
-  defaultOptions: [WALL_DEFAULTS],
   create(context, [provided]) {
     const options = { ...WALL_DEFAULTS, ...provided };
     const sourceCode = context.sourceCode;
@@ -23977,12 +23985,12 @@ var no_first_party_module_mock_default = createRule({
   name: "no-first-party-module-mock",
   documentation: NO_FIRST_PARTY_MODULE_MOCK_DOCUMENTATION,
   meta: {
+    defaultOptions: [{ additionalModulePrefixes: [] }],
     type: "problem",
     docs: { description: NO_FIRST_PARTY_MODULE_MOCK_DOCUMENTATION.summary },
-    schema: [{ type: "object", additionalProperties: false, properties: { additionalModulePrefixes: { type: "array", items: { type: "string", minLength: 1 }, uniqueItems: true } } }],
+    schema: [{ type: "object", additionalProperties: false, properties: { additionalModulePrefixes: { description: "Additional maintained module prefixes that tests must not mock.", type: "array", items: { type: "string", minLength: 1 }, uniqueItems: true } } }],
     messages: { noFirstPartyModuleMock: "This test replaces the maintained module `{{module}}`. Inject a narrow collaborator or test the real module; suppress locally only when module lookup or bootstrap behavior is the contract." }
   },
-  defaultOptions: [{ additionalModulePrefixes: [] }],
   create(context, [options]) {
     if (!isTestFile(context) || isGeneratedFile(context, context.sourceCode.text)) return {};
     return {
@@ -26196,6 +26204,7 @@ var prefer_shadcn_primitives_default = createRule({
   name: "prefer-shadcn-primitives",
   documentation: PREFER_SHADCN_PRIMITIVES_DOCUMENTATION,
   meta: {
+    defaultOptions: [{}],
     type: "suggestion",
     docs: {
       description: "Require visible raw JSX controls to use the corresponding shared shadcn primitive."
@@ -26204,8 +26213,8 @@ var prefer_shadcn_primitives_default = createRule({
       {
         type: "object",
         properties: {
-          assumeAvailable: { type: "boolean" },
-          detectProjectPrimitives: { type: "boolean" }
+          assumeAvailable: { description: "Assume supported shared UI primitives are available in this project.", type: "boolean" },
+          detectProjectPrimitives: { description: "Resolve project-owned UI primitives before recommending replacements.", type: "boolean" }
         },
         additionalProperties: false
       }
@@ -26214,7 +26223,6 @@ var prefer_shadcn_primitives_default = createRule({
       preferShadcnPrimitive: "Use the shared {{ replacement }} shadcn primitive instead of raw <{{ element }}> markup."
     }
   },
-  defaultOptions: [{}],
   create(context, [options]) {
     const filename = context.filename.replaceAll("\\", "/");
     if (isTestFile(context) || isStoryFile(context) || isGeneratedFile(context, context.sourceCode.text) || SHARED_PRIMITIVE_IMPLEMENTATION_RE.test(filename)) {
@@ -26591,6 +26599,7 @@ var prefer_module_level_constant_default = createRule({
   name: "prefer-module-level-constant",
   documentation: PREFER_MODULE_LEVEL_CONSTANT_DOCUMENTATION,
   meta: {
+    defaultOptions: [{}],
     type: "suggestion",
     fixable: "code",
     docs: {
@@ -26601,9 +26610,9 @@ var prefer_module_level_constant_default = createRule({
         type: "object",
         additionalProperties: false,
         properties: {
-          minElements: { type: "number", minimum: 1 },
-          checkRegex: { type: "boolean" },
-          ignoreTestFiles: { type: "boolean" }
+          minElements: { description: "Minimum collection size before recommending a module-level constant.", type: "number", minimum: 1 },
+          checkRegex: { description: "Include reusable regular expression literals in hoisting checks.", type: "boolean" },
+          ignoreTestFiles: { description: "Skip test files when recommending module-level constants.", type: "boolean" }
         }
       }
     ],
@@ -26612,7 +26621,6 @@ var prefer_module_level_constant_default = createRule({
       hoistRegex: "`{{name}}` is a constant regex recompiled on every call. Hoist it to module scope."
     }
   },
-  defaultOptions: [{}],
   create(context, [optionsArg]) {
     const options = optionsArg ?? {};
     const minElements = options.minElements ?? DEFAULT_MIN_ELEMENTS;
@@ -26921,6 +26929,7 @@ var prefer_module_level_schema_default = createRule({
   name: "prefer-module-level-schema",
   documentation: PREFER_MODULE_LEVEL_SCHEMA_DOCUMENTATION,
   meta: {
+    defaultOptions: [{}],
     type: "problem",
     docs: {
       description: "Declare a Zod schema at module scope when it closes over nothing in the enclosing function"
@@ -26956,7 +26965,6 @@ var prefer_module_level_schema_default = createRule({
       hoistSchema: "Move this `{{factory}}` schema to module scope. It uses nothing from `{{owner}}`, so it is rebuilt on every call for no benefit and cannot be exported, reused, or `z.infer`-ed from where it is."
     }
   },
-  defaultOptions: [{}],
   create(context, [options]) {
     const factories = new Set(options?.factories ?? DEFAULT_FACTORIES);
     const ignoreTestFiles = options?.ignoreTestFiles ?? true;
@@ -27615,6 +27623,7 @@ var prefer_multi_value_zod_literal_default = createRule({
   name: "prefer-multi-value-zod-literal",
   documentation: PREFER_MULTI_VALUE_ZOD_LITERAL_DOCUMENTATION,
   meta: {
+    defaultOptions: [{}],
     type: "suggestion",
     docs: {
       description: "Use the Zod 4 multi-value literal API instead of a union of literal schemas."
@@ -27624,7 +27633,7 @@ var prefer_multi_value_zod_literal_default = createRule({
         type: "object",
         additionalProperties: false,
         properties: {
-          zodMajorVersion: { type: "integer", minimum: 4, maximum: 4 }
+          zodMajorVersion: { description: "Installed Zod major version used to validate multi-value literal support.", type: "integer", minimum: 4, maximum: 4 }
         }
       }
     ],
@@ -27632,7 +27641,6 @@ var prefer_multi_value_zod_literal_default = createRule({
       useMultiValueLiteral: "Replace this literal-schema union with {{zod}}.literal([\u2026])."
     }
   },
-  defaultOptions: [{}],
   create(context, [options]) {
     if (isTestFile(context) || isGeneratedFile(context, context.sourceCode.text))
       return {};
@@ -29715,13 +29723,14 @@ var prefer_await_in_async_return_default = createRule({
   name: "prefer-await-in-async-return",
   documentation: PREFER_AWAIT_IN_ASYNC_RETURN_DOCUMENTATION,
   meta: {
+    defaultOptions: [{ scope: "async-return" }],
     type: "suggestion",
     docs: {
       description: "Prefer explicit `await` for proven Promise `.then` calls; the default scope checks direct async returns."
     },
     schema: [{
       type: "object",
-      properties: { scope: { type: "string", enum: ["async-return", "all-promise-calls"] } },
+      properties: { scope: { description: "Check async return statements or every promise-valued call.", type: "string", enum: ["async-return", "all-promise-calls"] } },
       additionalProperties: false
     }],
     messages: {
@@ -29729,7 +29738,6 @@ var prefer_await_in_async_return_default = createRule({
       preferAwaitCall: "This call uses built-in Promise.then(). Use async/await, preserving rejection handling and observable scheduling when rewriting."
     }
   },
-  defaultOptions: [{ scope: "async-return" }],
   create(context, [options]) {
     let services;
     try {
@@ -30943,6 +30951,7 @@ var prefer_semantic_colors_default = createRule({
   name: "prefer-semantic-colors",
   documentation: PREFER_SEMANTIC_COLORS_DOCUMENTATION,
   meta: {
+    defaultOptions: [{}],
     type: "suggestion",
     docs: {
       description: "Enforce semantic color tokens over raw Tailwind palette classes, arbitrary color values, and inline color literals."
@@ -30952,8 +30961,8 @@ var prefer_semantic_colors_default = createRule({
         type: "object",
         additionalProperties: false,
         properties: {
-          requireSemanticTokens: { type: "boolean" },
-          opaqueForegroundPairs: { type: "boolean" }
+          requireSemanticTokens: { description: "Restrict checks to projects with an existing semantic token system.", type: "boolean" },
+          opaqueForegroundPairs: { description: "Use the project semantic foreground roles to check opaque foreground and background pairs.", type: "boolean" }
         }
       }
     ],
@@ -30964,7 +30973,6 @@ var prefer_semantic_colors_default = createRule({
       opaqueForegroundPair: "'{{class}}' bypasses the declared '{{replacement}}' token paired with '{{background}}'."
     }
   },
-  defaultOptions: [{}],
   create(context, [options]) {
     if (STORIES_FILE_RE.test(context.filename)) return {};
     if (staticallyImportsExternalRenderer(context.sourceCode.ast)) return {};
@@ -31266,6 +31274,7 @@ var prefer_server_actions_default = createRule({
   name: "prefer-server-actions",
   documentation: PREFER_SERVER_ACTIONS_DOCUMENTATION,
   meta: {
+    defaultOptions: [{}],
     type: "suggestion",
     docs: {
       description: "Prefer Next.js Server Actions over same-origin API mutations."
@@ -31276,6 +31285,7 @@ var prefer_server_actions_default = createRule({
         additionalProperties: false,
         properties: {
           basePath: {
+            description: "Static application URL base path without query strings, fragments or parent segments.",
             type: "string",
             pattern: "^/(?!$)(?!.*[?#])(?!(?:.*/)?\\.\\.?(?:/|$))(?:[^/]+/)*[^/]+$"
           }
@@ -31286,7 +31296,6 @@ var prefer_server_actions_default = createRule({
       preferServerAction: "This client mutation targets a same-origin API route. Consider a Server Action to remove the hand-written API wrapper; retain authorization and validation, since the call still crosses a network boundary."
     }
   },
-  defaultOptions: [{}],
   create(context, [options]) {
     const filename = context.filename.replaceAll("\\", "/");
     if (SKIP_FILE_REGEX.test(filename)) {
@@ -32300,6 +32309,7 @@ var prefer_zod_infer_default = createRule({
   name: "prefer-zod-infer",
   documentation: PREFER_ZOD_INFER_DOCUMENTATION,
   meta: {
+    defaultOptions: [{}],
     type: "problem",
     fixable: "code",
     docs: {
@@ -32311,10 +32321,11 @@ var prefer_zod_infer_default = createRule({
         additionalProperties: false,
         properties: {
           ignoreTypeNames: {
+            description: "Regular expression patterns for type names to leave unchanged.",
             type: "array",
             items: { type: "string" }
           },
-          requireIdenticalShape: { type: "boolean" }
+          requireIdenticalShape: { description: "Require the schema output and declared type to have identical property shapes.", type: "boolean" }
         }
       }
     ],
@@ -32323,7 +32334,6 @@ var prefer_zod_infer_default = createRule({
       repeatedEnumUnion: "`{{propertyName}}` repeats the literal domain already named by `{{typeName}}` and `{{schemaName}}` in multiple object types. Reuse `{{typeName}}` so the accepted values have one source of truth."
     }
   },
-  defaultOptions: [{}],
   create(context, [optionsArg]) {
     const ignorePatterns = (optionsArg?.ignoreTypeNames ?? []).map(
       (source) => new RegExp(source, "u")
@@ -33662,6 +33672,7 @@ var require_fetch_timeout_default = createRule({
   name: "require-fetch-timeout",
   documentation: REQUIRE_FETCH_TIMEOUT_DOCUMENTATION,
   meta: {
+    defaultOptions: [{}],
     type: "problem",
     docs: {
       description: "Require an explicit abort signal on locally analyzable global fetch calls."
@@ -33683,7 +33694,6 @@ var require_fetch_timeout_default = createRule({
       missingSignal: "This `fetch()` has no explicit abort signal. Pass `AbortSignal.timeout(ms)` for a deadline, or an owner-managed signal for cancellation."
     }
   },
-  defaultOptions: [{}],
   create(context, [optionsArg]) {
     if (isTestFile(context) || isScriptFile(context)) {
       return {};
@@ -35791,6 +35801,7 @@ var stepdown_default = createRule({
   name: "stepdown",
   documentation: STEPDOWN_DOCUMENTATION,
   meta: {
+    defaultOptions: [{}],
     type: "suggestion",
     fixable: "code",
     docs: {
@@ -35812,7 +35823,6 @@ var stepdown_default = createRule({
       helperAboveOnlyCaller: "Private helper `{{helper}}` is defined above its only caller `{{caller}}`; move it below the caller."
     }
   },
-  defaultOptions: [{}],
   create(context, [options]) {
     if (isTestFile(context) || isGeneratedFile(context, context.sourceCode.text))
       return {};

package/dist/rule-examples.cjs

@@ -199,7 +199,7 @@ async function verifyRuleExamples(rule, setup = {}) {
           files: ["**/*.{ts,tsx,js,jsx,mts,cts,mjs,cjs}"],
           languageOptions: { parser: exampleParser, parserOptions: { project: tsconfig, tsconfigRootDir: root, disallowAutomaticSingleRunInference: true } },
           plugins: { "@sarj": { rules: { [spec.ruleId]: rule } } },
-          rules: { [ruleId]: ["error", ...example.ruleOptions ?? rule.defaultOptions ?? []] }
+          rules: { [ruleId]: ["error", ...example.ruleOptions ?? rule.meta.defaultOptions ?? rule.defaultOptions ?? []] }
         };
         await verifyExample(new import_eslint.Linter({ cwd: root }), config, example, root, ruleId, setup.formatFixedSource);
       } finally {

package/dist/rule-examples.js

@@ -165,7 +165,7 @@ async function verifyRuleExamples(rule, setup = {}) {
           files: ["**/*.{ts,tsx,js,jsx,mts,cts,mjs,cjs}"],
           languageOptions: { parser: exampleParser, parserOptions: { project: tsconfig, tsconfigRootDir: root, disallowAutomaticSingleRunInference: true } },
           plugins: { "@sarj": { rules: { [spec.ruleId]: rule } } },
-          rules: { [ruleId]: ["error", ...example.ruleOptions ?? rule.defaultOptions ?? []] }
+          rules: { [ruleId]: ["error", ...example.ruleOptions ?? rule.meta.defaultOptions ?? rule.defaultOptions ?? []] }
         };
         await verifyExample(new Linter({ cwd: root }), config, example, root, ruleId, setup.formatFixedSource);
       } finally {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sarj/eslint-plugin",
-  "version": "17.1.2",
+  "version": "17.1.3",
   "packageManager": "npm@12.2.1",
   "description": "Custom ESLint rules for hypermodern TypeScript / React / Next.js projects",
   "type": "module",
@@ -74,6 +74,7 @@
     "@vitest/eslint-plugin": "1.6.28",
     "eslint": "10.13.0",
     "eslint-node-test": "1.0.1",
+    "eslint-plugin-eslint-plugin": "7.6.2",
     "eslint-plugin-better-tailwindcss": "^4.10.0",
     "eslint-plugin-jest": "29.17.0",
     "eslint-plugin-jsdoc": "65.4.2",
@@ -94,6 +95,7 @@
     "jiti": "2.7.0",
     "prettier": "3.9.10",
     "tsup": "9.0.0",
+    "syncpack": "15.3.3",
     "typescript": "npm:@typescript/typescript6@6.0.2",
     "typescript-eslint": "^8.72.0",
     "uuid": "13.0.0",