@sarj/eslint-plugin 15.1.0 → 15.2.0

package/dist/index.js

@@ -967,11 +967,11 @@ function isTrivialInitializer(node) {
 }
 function restatesStatementHead(body2, statement) {
   if (statement === null) return false;
-  const words = body2.match(/[A-Za-z][\w$]*/g) ?? [];
-  const opener = words[0];
-  if (opener === void 0 || words.length > NARRATION_MAX_WORDS) return false;
+  const words2 = body2.match(/[A-Za-z][\w$]*/g) ?? [];
+  const opener = words2[0];
+  if (opener === void 0 || words2.length > NARRATION_MAX_WORDS) return false;
   if (!NARRATION_VERB_RE.test(opener)) return false;
-  const content = words.slice(1).map(normalizeToken).filter((word) => !NARRATION_STOPWORDS.has(word));
+  const content = words2.slice(1).map(normalizeToken).filter((word) => !NARRATION_STOPWORDS.has(word));
   if (content.length < NARRATION_MIN_CONTENT) return false;
   const head = statement.split("(")[0] ?? statement;
   const code = headTokens(head);
@@ -1239,8 +1239,8 @@ function isRedundantNarration(body2, statementBelow, standalone, isolatedEnumera
     if (META_COMMENTARY_RE.test(t) && !justified) return true;
     if (isBareDeferral(t) && !justified) return true;
     if (HELPER_OPENER_RE.test(t) || LETS_RE.test(t)) return true;
-    const words = t.split(/\s+/);
-    if (words.length > 1 && words.length <= 4 && DUMMY_TRANSLATION_RE.test(t) && !/[():=]/.test(t)) {
+    const words2 = t.split(/\s+/);
+    if (words2.length > 1 && words2.length <= 4 && DUMMY_TRANSLATION_RE.test(t) && !/[():=]/.test(t)) {
       const lowerT = t.toLowerCase();
       if (!RATIONALE_WORDS.some((word) => lowerT.includes(word)) && restatesWholeStatement(t, statementBelow)) {
         return true;
@@ -1322,8 +1322,8 @@ function isWeakWalkthroughComment(body2, statement) {
   if (normalized.length === 0 || normalized.endsWith("?") || normalized.split(/\s+/).length > WALL_MAX_WORDS || isDirective(normalized) || isProtected(normalized) || !WALL_NARRATION_RE.test(normalized)) {
     return false;
   }
-  const words = contentTokens(normalized);
-  const described = words.slice(1);
+  const words2 = contentTokens(normalized);
+  const described = words2.slice(1);
   if (described.length === 0) return false;
   const code = codeTokens(statement);
   const matched = described.filter((word) => restates([word], code)).length;
@@ -2670,7 +2670,7 @@ var no_fat_try_blocks_default = createRule({
     const sourceCode = context.sourceCode;
     return {
       TryStatement(node) {
-        if (node.finalizer !== null) {
+        if (node.finalizer !== null && node.handler === null) {
           return;
         }
         if (handlerRethrows(node.handler)) {
@@ -2910,15 +2910,32 @@ var noHandRolledSpinnerDocumentation = {
   rationale: "One-off loading indicators duplicate a shared primitive and let accessibility and styling diverge.",
   remediation: "Render the design-system Spinner component instead.",
   category: "maintainability",
-  limitations: ["Only static className values on div and span elements are inspected."],
+  limitations: ["Only static className values on div and span elements are inspected; tests, stories, generated files, and the design-system implementation are excluded."],
   examples: [
     { id: "design-system-spinner", title: "Use the shared spinner", outcome: "no-match", files: [{ path: "src/loading-state.tsx", source: '<Spinner className="size-4" />' }], focusPath: "src/loading-state.tsx", expectedCount: 0, public: true },
     { id: "border-ring-spinner", title: "Do not rebuild a spinner", outcome: "match", files: [{ path: "src/loading-state.tsx", source: '<div className="size-4 animate-spin rounded-full border-2 border-t-transparent" />' }], focusPath: "src/loading-state.tsx", expectedCount: 1, public: true }
   ]
 };
 var DESIGN_SYSTEM_PATH = /(?:^|[/\\])components[/\\]ui[/\\]/u;
-var BORDER_WIDTH = /^border(?:-[0-9]+)?$/u;
-var CONTRASTING_EDGE = /^border-[trbl]-(?!0$|[0-9]+$).+/u;
+var DIRECTIONAL_BORDER = /^border-([trblsexy])-(.+)$/u;
+var CSS_LENGTH = /^-?(?:\d+(?:\.\d+)?|\.\d+)(?:cap|ch|cm|dvh|dvw|em|ex|ic|in|lh|lvh|lvw|mm|pc|pt|px|q|rcap|rch|rem|rex|ric|rlh|svh|svw|vb|vh|vi|vmax|vmin|vw|%)$/u;
+var ARBITRARY_LENGTH_FUNCTION = /^(?:calc|clamp|max|min)\(.+\)$/u;
+function isBorderWidthValue(value) {
+  if (/^\d+$/u.test(value)) return true;
+  if (value.startsWith("[") && value.endsWith("]")) {
+    const arbitrary = value.slice(1, -1);
+    const length = arbitrary.startsWith("length:") ? arbitrary.slice("length:".length) : arbitrary;
+    return CSS_LENGTH.test(length) || ARBITRARY_LENGTH_FUNCTION.test(length) || arbitrary.startsWith("length:") && /^var\(.+\)$/u.test(length);
+  }
+  return value.startsWith("(length:") && value.endsWith(")") && value.length > "(length:)".length;
+}
+function isBorderWidth(token) {
+  return token === "border" || token.startsWith("border-") && isBorderWidthValue(token.slice("border-".length));
+}
+function isContrastingEdge(token) {
+  const match = DIRECTIONAL_BORDER.exec(token);
+  return match?.[2] !== void 0 && !isBorderWidthValue(match[2]);
+}
 function staticClassName(attribute) {
   const value = attribute.value;
   if (value?.type === AST_NODE_TYPES11.Literal && typeof value.value === "string") {
@@ -2947,7 +2964,7 @@ var no_hand_rolled_spinner_default = createRule({
   },
   defaultOptions: [],
   create(context) {
-    if (DESIGN_SYSTEM_PATH.test(context.filename)) {
+    if (DESIGN_SYSTEM_PATH.test(context.filename) || isTestFile(context.filename) || isStoryFile(context.filename) || isGeneratedFile(context.filename, context.sourceCode.text)) {
       return {};
     }
     return {
@@ -2962,7 +2979,7 @@ var no_hand_rolled_spinner_default = createRule({
         const className = staticClassName(classNameAttribute);
         if (className === null) return;
         const classes = className.split(/\s+/u);
-        if (classes.includes("animate-spin") && classes.includes("rounded-full") && classes.some((token) => BORDER_WIDTH.test(token)) && classes.some((token) => CONTRASTING_EDGE.test(token))) {
+        if (classes.includes("animate-spin") && classes.includes("rounded-full") && classes.some(isBorderWidth) && classes.some(isContrastingEdge)) {
           context.report({ node, messageId: "handRolledSpinner" });
         }
       }
@@ -3028,9 +3045,9 @@ function nameWords(name) {
   return name.replaceAll(/([a-z0-9])([A-Z])/gu, "$1 $2").split(/[^A-Za-z0-9]+/u).filter(Boolean).map((word) => word.toLowerCase());
 }
 function isStrongSecurityName(name) {
-  const words = nameWords(name);
-  return words.some((word) => STRONG_SECURITY_WORDS.has(word)) || words.some(
-    (word, index) => word === "api" && words[index + 1] === "key" || word === "auth" && words[index + 1] === "id" || word === "verification" && words[index + 1] === "code"
+  const words2 = nameWords(name);
+  return words2.some((word) => STRONG_SECURITY_WORDS.has(word)) || words2.some(
+    (word, index) => word === "api" && words2[index + 1] === "key" || word === "auth" && words2[index + 1] === "id" || word === "verification" && words2[index + 1] === "code"
   );
 }
 function isNonSecurityName(name) {
@@ -3994,7 +4011,7 @@ var VALUE_TAG_RE = /@(example|deprecated|see|remarks|throws|internal|public|alph
 var BOUNDARY_RE = /(?<=[.!?])["'`)\]]*\s+(?=[A-Z0-9`])/;
 var BULLET_RE = /^\s*(?:[-*+] |\d+[.)] )/;
 var HEADING_RE = /^[A-Za-z][A-Za-z ]+:$/;
-var TECHNICAL_ANCHOR_RE = /https?:\/\/|`[^`\n]+`|:[a-z][a-z0-9_-]*:|(["'])[^"'\n]+\1|\d|\b[a-z][a-z0-9]*[A-Z][A-Za-z0-9]*\b|\b[A-Za-z][A-Za-z0-9]*_[A-Za-z0-9_]+\b|(?:^|\s)(?:[\w.-]+\/)+[\w.-]+|\b[\w.-]+\.(?:py|pyi|js|jsx|ts|tsx|json|ya?ml|toml|csv|parquet|md)\b|->|=>|==|!=|<=|>=|\|/mu;
+var TECHNICAL_ANCHOR_RE = /https?:\/\/|`[^`\n]+`|:[a-z][a-z0-9_-]*:|(["'])[^"'\n]+\1|\bv?\d+\.\d+(?:\.\d+)?\b|\b\d+(?:\.\d+)?\s?(?:ns|us|ms|s|sec|secs|seconds?|mins?|minutes?|hours?|days?|bytes?|kib|mib|gib|kb|mb|gb|hz|khz|mhz|px|%)\b|\b[a-z][a-z0-9]*[A-Z][A-Za-z0-9]*\b|\b[A-Za-z][A-Za-z0-9]*_[A-Za-z0-9_]+\b|(?:^|\s)(?:[\w.-]+\/)+[\w.-]+|\b[\w.-]+\.(?:py|pyi|js|jsx|ts|tsx|json|ya?ml|toml|csv|parquet|md)\b|->|=>|==|!=|<=|>=|\|/mu;
 function body(comment) {
   return comment.value.replace(/^\*/, "").split("\n").map((line) => line.replace(/^\s*\*?\s?/, "")).join("\n").trim();
 }
@@ -6810,22 +6827,25 @@ var noStorageInStatelessModulesDocumentation = {
   rationale: "Private storage in a stateless workflow creates another source of truth that can silently diverge.",
   remediation: "Read from the system of record or derive state from an artifact the workflow already produces.",
   category: "architecture",
-  limitations: ["The rule is disabled until module path patterns are configured and recognizes only configured storage method names."],
+  limitations: ["The rule is disabled until module path patterns are configured, recognizes only configured storage method names, and requires storage-like receiver evidence for the overloaded `put` method."],
   examples: [
     { id: "system-of-record", title: "Read from the system of record", outcome: "no-match", files: [{ path: "src/engineer-digest/post.ts", source: "const issues = await linear.listIssues();" }], focusPath: "src/engineer-digest/post.ts", expectedCount: 0, public: true },
     { id: "private-storage", title: "Do not write private state in a stateless module", outcome: "match", files: [{ path: "src/engineer-digest/post.ts", source: "await kv.put('digest:last', timestamp);" }], focusPath: "src/engineer-digest/post.ts", expectedCount: 1, public: true }
   ]
 };
 function compile2(patterns) {
-  const compiled = [];
-  for (const pattern of patterns) {
-    try {
-      compiled.push(new RegExp(pattern));
-    } catch {
-    }
-  }
-  return compiled;
+  return patterns.map((pattern) => new RegExp(pattern));
 }
+var STORAGE_RECEIVER_WORDS = /* @__PURE__ */ new Set([
+  "bucket",
+  "cache",
+  "kv",
+  "namespace",
+  "r2",
+  "redis",
+  "storage",
+  "store"
+]);
 function storageMethodName(node, methods) {
   const callee = node.callee;
   if (callee.type !== AST_NODE_TYPES26.MemberExpression || callee.computed || callee.property.type !== AST_NODE_TYPES26.Identifier) {
@@ -6838,8 +6858,31 @@ function storageMethodName(node, methods) {
   if (node.arguments.length < (MIN_ARGUMENTS.get(name) ?? 1)) {
     return null;
   }
+  if (name === "put" && !isStorageLikeReceiver(callee.object)) {
+    return null;
+  }
   return name;
 }
+function isStorageLikeReceiver(node) {
+  if (node.type === AST_NODE_TYPES26.Identifier) {
+    return isStorageIdentifier(node.name);
+  }
+  if (node.type !== AST_NODE_TYPES26.MemberExpression) {
+    return false;
+  }
+  if (!node.computed && node.property.type === AST_NODE_TYPES26.Identifier && isStorageIdentifier(node.property.name)) {
+    return true;
+  }
+  return isStorageLikeReceiver(node.object);
+}
+function isStorageIdentifier(name) {
+  return identifierWords(name).some(
+    (word) => STORAGE_RECEIVER_WORDS.has(word.toLowerCase())
+  );
+}
+function identifierWords(name) {
+  return name.match(/[A-Z]?[a-z]+|[A-Z]+(?=[A-Z]|$)|\d+/gu) ?? [name];
+}
 var no_storage_in_stateless_modules_default = createRule({
   name: "no-storage-in-stateless-modules",
   documentation: noStorageInStatelessModulesDocumentation,
@@ -7241,12 +7284,86 @@ var no_tautological_expect_default = createRule({
 });
 
 // src/rules/no-typed-doc-sections.ts
+var TYPED_TAG_RE2 = /^\s*@(arg|argument|param|return|returns|yield|yields)\b(.*)$/iu;
+var PARAM_TAGS2 = /* @__PURE__ */ new Set(["arg", "argument", "param"]);
+var PARAMETER_FILLER = /* @__PURE__ */ new Set([
+  "a",
+  "an",
+  "argument",
+  "given",
+  "input",
+  "parameter",
+  "passed",
+  "provided",
+  "the",
+  "value"
+]);
+var RESULT_FILLER = /* @__PURE__ */ new Set([
+  "a",
+  "an",
+  "array",
+  "boolean",
+  "generator",
+  "number",
+  "object",
+  "output",
+  "promise",
+  "result",
+  "return",
+  "returned",
+  "returns",
+  "string",
+  "the",
+  "value"
+]);
+function hasVacuousTypedTag(text) {
+  const tags = typedTags(text);
+  return tags.length > 0 && tags.some(isVacuousTag);
+}
+function typedTags(text) {
+  const tags = [];
+  for (const raw of text.split("\n")) {
+    const match = TYPED_TAG_RE2.exec(raw);
+    if (match !== null) {
+      tags.push({ kind: (match[1] ?? "").toLowerCase(), payload: (match[2] ?? "").trim() });
+    } else if (tags.length > 0 && raw.trim().length > 0 && !raw.trim().startsWith("@")) {
+      const last = tags.at(-1);
+      last.payload = `${last.payload} ${raw.trim()}`.trim();
+    }
+  }
+  return tags.map(({ kind, payload }) => {
+    let rest = payload.replace(/^\{[^}\n]+\}\s*/u, "").trim();
+    if (!PARAM_TAGS2.has(kind)) {
+      return { kind, name: null, description: rest.replace(/^-\s*/u, "").trim() };
+    }
+    const match = /^(\[[^\]]+\]|[A-Za-z_$][\w$.[\]-]*)(?:\s+-\s*|\s+)?(.*)$/u.exec(rest);
+    if (match === null) return { kind, name: null, description: "" };
+    const rawName = (match[1] ?? "").replace(/^\[/u, "").replace(/\]$/u, "").split("=")[0] ?? "";
+    rest = (match[2] ?? "").trim();
+    return { kind, name: rawName, description: rest };
+  });
+}
+function isVacuousTag(tag) {
+  const description = words(tag.description).map(canonicalWord);
+  if (description.length === 0) return true;
+  if (tag.name === null) return description.every((word) => RESULT_FILLER.has(word));
+  const nameWords2 = new Set(words(tag.name).map(canonicalWord));
+  return description.every((word) => PARAMETER_FILLER.has(word) || nameWords2.has(word));
+}
+function words(text) {
+  return text.replaceAll(/([a-z0-9])([A-Z])/gu, "$1 $2").toLowerCase().match(/[a-z][a-z0-9]*/gu) ?? [];
+}
+function canonicalWord(word) {
+  if (["identifier", "identifiers", "ids"].includes(word)) return "id";
+  if (word.endsWith("s") && word.length > 3) return word.slice(0, -1);
+  return word;
+}
 var noTypedDocSectionsDocumentation = {
   summary: "Reject typed-signature repetition while preserving behavior that types cannot express.",
   rationale: "Parameter and return tags repeat typed signatures and can drift without adding runtime behavior or constraints.",
   remediation: "Remove repeated parameter and return tags; retain documentation for behavior, failures, and external contracts.",
   category: "maintainability",
-  limitations: ["Parameter and return tags are reported only when the documented function has corresponding explicit TypeScript types."],
+  limitations: ["Description-free or name-restating parameter and return tags are reported only when the documented function has corresponding explicit TypeScript types."],
   examples: [
     {
       id: "behavioral-documentation",
@@ -7284,7 +7401,7 @@ var no_typed_doc_sections_default = createRule({
     return {
       Program() {
         for (const group of proseGroups(context.filename, context.sourceCode, true)) {
-          if (group.hasTypedTags && documentsTypedFunction(context.sourceCode, group.comment)) {
+          if (group.hasTypedTags && hasVacuousTypedTag(group.text) && documentsTypedFunction(context.sourceCode, group.comment)) {
             context.report({ node: group.comment, messageId: "typedSection" });
           }
         }
@@ -7385,28 +7502,32 @@ var STOPWORDS3 = /* @__PURE__ */ new Set([
   "with"
 ]);
 var DIRECTIVE_RE5 = /^\s*(?:eslint\b|eslint-|sarj-noqa\b|@ts-|prettier|biome-|c8\b|v8\b|istanbul\b|todo\b|fixme\b|hack\b|xxx\b)/i;
+var UNIT_NAME_SUFFIX_RE = /(?:_(?:NS|US|MS|S|SEC|SECS|SECOND|SECONDS|MIN|MINS|MINUTE|MINUTES|HOUR|HOURS|DAY|DAYS|BYTE|BYTES|KB|MB|GB|HZ|KHZ|MHZ|PX)|(?:Ns|Us|Ms|Sec|Secs|Second|Seconds|Min|Mins|Minute|Minutes|Hour|Hours|Day|Days|Byte|Bytes|Kb|Mb|Gb|Hz|Khz|Mhz|Px))$/u;
 function narratesValue(body2, code) {
   if (body2.length === 0 || DIRECTIVE_RE5.test(body2) || hasExternalReference(body2)) return false;
   const codeNumbers = numbersIn(code);
   if (codeNumbers.size === 0) return false;
-  const words = (body2.match(WORD_RE3) ?? []).map((word) => word.toLowerCase());
-  if (words.length === 0) return false;
+  const words2 = (body2.match(WORD_RE3) ?? []).map((word) => word.toLowerCase());
+  if (words2.length === 0) return false;
   const commentNumbers = numbersIn(body2);
   if (commentNumbers.size === 0) return false;
   for (const number of commentNumbers) {
     if (!codeNumbers.has(number)) return false;
   }
-  if (!words.some((word) => UNIT_WORDS.has(word))) return false;
+  if (!words2.some((word) => UNIT_WORDS.has(word))) return false;
   const identifiers = codeTokens(code);
   const stems = /* @__PURE__ */ new Set();
   for (const token of identifiers) stems.add(stem(token));
-  return words.every(
+  return words2.every(
     (word) => STOPWORDS3.has(word) || UNIT_WORDS.has(word) || commentNumbers.has(word) || identifiers.has(word) || stems.has(stem(word))
   );
 }
 function numbersIn(text) {
   return new Set(text.match(NUMBER_RE) ?? []);
 }
+function nameAlreadyCarriesUnit(code) {
+  return (code.match(/[A-Za-z_$][\w$]*/gu) ?? []).some((identifier) => UNIT_NAME_SUFFIX_RE.test(identifier));
+}
 var no_trailing_value_narration_default = createRule({
   name: "no-trailing-value-narration",
   documentation: noTrailingValueNarrationDocumentation,
@@ -7417,6 +7538,7 @@ var no_trailing_value_narration_default = createRule({
     },
     schema: [],
     messages: {
+      deleteNarration: "Trailing comment restates the literal and the identifier already names its unit \u2014 delete the comment so it cannot drift.",
       narratesValue: "Trailing comment restates the literal on this line \u2014 put the unit in the name (STALE_TIME_MS) so it cannot drift."
     }
   },
@@ -7449,7 +7571,10 @@ var no_trailing_value_narration_default = createRule({
           const code = line.slice(0, comment.loc.start.column);
           const body2 = comment.value.replace(/^\*+/, "").replace(/\*+$/, "").trim();
           if (narratesValue(body2, code)) {
-            context.report({ node: comment, messageId: "narratesValue" });
+            context.report({
+              node: comment,
+              messageId: nameAlreadyCarriesUnit(code) ? "deleteNarration" : "narratesValue"
+            });
           }
         }
       }
@@ -8367,7 +8492,8 @@ var no_unsafe_mock_casting_default = createRule({
 // src/rules/no-zod-native-enum.ts
 import {
   ESLintUtils as ESLintUtils2,
-  AST_NODE_TYPES as AST_NODE_TYPES34
+  AST_NODE_TYPES as AST_NODE_TYPES34,
+  ASTUtils as ASTUtils8
 } from "@typescript-eslint/utils";
 import * as ts from "typescript";
 var noZodNativeEnumDocumentation = {
@@ -8496,15 +8622,23 @@ var no_zod_native_enum_default = createRule({
     } catch {
       services = null;
     }
-    const zodImportedNames = /* @__PURE__ */ new Map();
-    const zodNamespaces = /* @__PURE__ */ new Set();
+    const zodImportedBindings = /* @__PURE__ */ new Map();
+    const zodNamespaceBindings = /* @__PURE__ */ new Set();
+    function resolvedBinding(identifier) {
+      return ASTUtils8.findVariable(
+        sourceCode.getScope(identifier),
+        identifier.name
+      );
+    }
     function isZodMemberCall(node, api) {
       const callee = node.callee;
-      if (callee.type === AST_NODE_TYPES34.MemberExpression && !callee.computed && callee.object.type === AST_NODE_TYPES34.Identifier && zodNamespaces.has(callee.object.name) && callee.property.type === AST_NODE_TYPES34.Identifier) {
-        return callee.property.name === api;
+      if (callee.type === AST_NODE_TYPES34.MemberExpression && !callee.computed && callee.object.type === AST_NODE_TYPES34.Identifier && callee.property.type === AST_NODE_TYPES34.Identifier) {
+        const binding = resolvedBinding(callee.object);
+        return binding !== null && zodNamespaceBindings.has(binding) && callee.property.name === api;
       }
       if (callee.type === AST_NODE_TYPES34.Identifier) {
-        return zodImportedNames.get(callee.name) === api;
+        const binding = resolvedBinding(callee);
+        return binding !== null && zodImportedBindings.get(binding) === api;
       }
       return false;
     }
@@ -8539,10 +8673,14 @@ var no_zod_native_enum_default = createRule({
         }
         for (const spec of node.specifiers) {
           if (spec.type === AST_NODE_TYPES34.ImportNamespaceSpecifier || spec.type === AST_NODE_TYPES34.ImportDefaultSpecifier || spec.type === AST_NODE_TYPES34.ImportSpecifier && (spec.imported.type === AST_NODE_TYPES34.Identifier ? spec.imported.name === "z" : spec.imported.value === "z")) {
-            zodNamespaces.add(spec.local.name);
+            const binding = resolvedBinding(spec.local);
+            if (binding !== null) zodNamespaceBindings.add(binding);
           }
           if (spec.type === AST_NODE_TYPES34.ImportSpecifier && spec.imported.type === AST_NODE_TYPES34.Identifier) {
-            zodImportedNames.set(spec.local.name, spec.imported.name);
+            const binding = resolvedBinding(spec.local);
+            if (binding !== null) {
+              zodImportedBindings.set(binding, spec.imported.name);
+            }
           }
         }
       },
@@ -8579,7 +8717,7 @@ var no_zod_native_enum_default = createRule({
 });
 
 // src/rules/test-loops-over-literal-cases.ts
-import { AST_NODE_TYPES as AST_NODE_TYPES35, ASTUtils as ASTUtils8 } from "@typescript-eslint/utils";
+import { AST_NODE_TYPES as AST_NODE_TYPES35, ASTUtils as ASTUtils9 } from "@typescript-eslint/utils";
 var testLoopsOverLiteralCasesDocumentation = {
   summary: "Disallow assertions over an inline literal case loop in a test; parameterization reports and names every case independently.",
   rationale: "A loop is reported as one test, so failures hide the individual case name and may stop later cases from running.",
@@ -8742,7 +8880,7 @@ var test_loops_over_literal_cases_default = createRule({
       return {};
     }
     const isFrameworkIdentifier = (identifier, modules) => {
-      const variable = ASTUtils8.findVariable(context.sourceCode.getScope(identifier), identifier.name);
+      const variable = ASTUtils9.findVariable(context.sourceCode.getScope(identifier), identifier.name);
       if (variable === null || variable.defs.length === 0) return true;
       return variable.defs.some((definition) => {
         let current = definition.node;
@@ -9179,7 +9317,7 @@ var prefer_input_group_search_default = createRule({
 });
 
 // src/rules/prefer-immutable-module-constant.ts
-import { AST_NODE_TYPES as AST_NODE_TYPES39, ASTUtils as ASTUtils9 } from "@typescript-eslint/utils";
+import { AST_NODE_TYPES as AST_NODE_TYPES39, ASTUtils as ASTUtils10 } from "@typescript-eslint/utils";
 var preferImmutableModuleConstantDocumentation = {
   summary: "Require module-level constant collections to expose readonly state.",
   rationale: "A const binding prevents reassignment but does not stop callers from mutating its array, object, Set, or Map contents.",
@@ -9332,7 +9470,7 @@ var prefer_immutable_module_constant_default = createRule({
   create(context) {
     const sourceCode = context.sourceCode;
     const isUnshadowedGlobal = (identifier) => {
-      const variable = ASTUtils9.findVariable(sourceCode.getScope(identifier), identifier.name);
+      const variable = ASTUtils10.findVariable(sourceCode.getScope(identifier), identifier.name);
       return variable === null || variable.defs.length === 0;
     };
     if (JAVASCRIPT_FILE_RE.test(context.filename) || isTestFile(context.filename) || isGeneratedFile(context.filename, sourceCode.getText())) {
@@ -10249,7 +10387,7 @@ var prefer_module_level_schema_default = createRule({
 });
 
 // src/rules/prefer-native-random-uuid.ts
-import { AST_NODE_TYPES as AST_NODE_TYPES43, ASTUtils as ASTUtils10 } from "@typescript-eslint/utils";
+import { AST_NODE_TYPES as AST_NODE_TYPES43, ASTUtils as ASTUtils11 } from "@typescript-eslint/utils";
 var preferNativeRandomUuidDocumentation = {
   summary: "Prefer `globalThis.crypto.randomUUID()` over resolved zero-argument UUID v4 bindings from the `uuid` package.",
   rationale: "The platform implementation avoids an unnecessary dependency for standard random UUID generation.",
@@ -10285,7 +10423,7 @@ var prefer_native_random_uuid_default = createRule({
     const directBindings = /* @__PURE__ */ new Set();
     const namespaceBindings = /* @__PURE__ */ new Set();
     function resolve(identifier) {
-      return ASTUtils10.findVariable(context.sourceCode.getScope(identifier), identifier.name);
+      return ASTUtils11.findVariable(context.sourceCode.getScope(identifier), identifier.name);
     }
     function record(identifier, destination) {
       const variable = resolve(identifier);
@@ -10348,7 +10486,7 @@ var prefer_native_random_uuid_default = createRule({
 });
 
 // src/rules/prefer-non-nullable-collection.ts
-import { AST_NODE_TYPES as AST_NODE_TYPES44, ASTUtils as ASTUtils11 } from "@typescript-eslint/utils";
+import { AST_NODE_TYPES as AST_NODE_TYPES44, ASTUtils as ASTUtils12 } from "@typescript-eslint/utils";
 var preferNonNullableCollectionDocumentation = {
   summary: "Suggest non-null arrays only when local control flow proves the nullish state is equivalent to an empty collection.",
   rationale: "A redundant nullish collection state spreads defaults and guards through consumers without carrying information.",
@@ -10478,14 +10616,14 @@ function directlyCoalesced(node) {
   return parent?.type === AST_NODE_TYPES44.LogicalExpression && parent.left === node && (parent.operator === "??" || parent.operator === "||") && emptyArray(parent.right);
 }
 function identifierIsOnlyCoalesced(context, binding, fn) {
-  const variable = ASTUtils11.findVariable(context.sourceCode.getScope(binding), binding.name);
+  const variable = ASTUtils12.findVariable(context.sourceCode.getScope(binding), binding.name);
   if (variable === null || variable.references.length === 0) return false;
   return variable.references.every(
     (reference) => belongsToFunction(reference.identifier, fn) && directlyCoalesced(reference.identifier)
   );
 }
 function memberIsOnlyCoalesced(context, object, property, fn) {
-  const variable = ASTUtils11.findVariable(context.sourceCode.getScope(object), object.name);
+  const variable = ASTUtils12.findVariable(context.sourceCode.getScope(object), object.name);
   if (variable === null) return false;
   const accesses = variable.references.flatMap((reference) => {
     if (!belongsToFunction(reference.identifier, fn)) return [null];
@@ -12327,6 +12465,9 @@ var requireAssertNeverDocumentation = {
 };
 var isRuntimeHandlingStatement = (statement) => {
   if (statement.type === AST_NODE_TYPES49.EmptyStatement) return false;
+  if (statement.type === AST_NODE_TYPES49.BreakStatement) {
+    return statement.label !== null;
+  }
   if (statement.type === AST_NODE_TYPES49.TSTypeAliasDeclaration || statement.type === AST_NODE_TYPES49.TSInterfaceDeclaration) {
     return false;
   }
@@ -12356,7 +12497,12 @@ function isExhaustiveFiniteSwitch(node, services) {
   const discriminant = services.esTreeNodeToTSNodeMap.get(node.discriminant);
   const discriminantType = checker.getTypeAtLocation(discriminant);
   const constituents = discriminantType.isUnion() ? discriminantType.types : [discriminantType];
-  if (constituents.length === 0) return false;
+  if (!discriminantType.isUnion() || constituents.length < 2) return false;
+  if (constituents.every(
+    (constituent) => (constituent.flags & ts2.TypeFlags.BooleanLiteral) !== 0
+  )) {
+    return false;
+  }
   const expected = /* @__PURE__ */ new Set();
   for (const constituent of constituents) {
     const key = finiteTypeKey(constituent, checker);
@@ -12424,7 +12570,7 @@ var require_assert_never_default = createRule({
 });
 
 // src/rules/require-fetch-timeout.ts
-import { AST_NODE_TYPES as AST_NODE_TYPES50, ASTUtils as ASTUtils12 } from "@typescript-eslint/utils";
+import { AST_NODE_TYPES as AST_NODE_TYPES50, ASTUtils as ASTUtils13 } from "@typescript-eslint/utils";
 var requireFetchTimeoutDocumentation = {
   summary: "Require an abort `signal` (e.g. `AbortSignal.timeout(ms)`) on global `fetch()` calls so stalled upstreams cannot hang the caller forever.",
   rationale: "An unbounded request can occupy work indefinitely when an upstream stalls.",
@@ -12505,7 +12651,7 @@ var require_fetch_timeout_default = createRule({
     }
     function resolvesToGlobal(identifier) {
       const scope = context.sourceCode.getScope(identifier);
-      const variable = ASTUtils12.findVariable(scope, identifier.name);
+      const variable = ASTUtils13.findVariable(scope, identifier.name);
       return variable === null || variable.defs.length === 0;
     }
     function isGlobalFetchCall2(callee) {
@@ -12515,7 +12661,7 @@ var require_fetch_timeout_default = createRule({
       return callee.type === AST_NODE_TYPES50.MemberExpression && !callee.computed && callee.property.type === AST_NODE_TYPES50.Identifier && callee.property.name === "fetch" && callee.object.type === AST_NODE_TYPES50.Identifier && GLOBAL_OBJECTS2.has(callee.object.name) && resolvesToGlobal(callee.object);
     }
     function localConstInitProvablyLacksSignal(identifier) {
-      const variable = ASTUtils12.findVariable(
+      const variable = ASTUtils13.findVariable(
         context.sourceCode.getScope(identifier),
         identifier.name
       );
@@ -13157,34 +13303,35 @@ var require_static_next_matcher_default = createRule({
 });
 
 // src/rules/require-zod-form-validation.ts
-import { AST_NODE_TYPES as AST_NODE_TYPES53 } from "@typescript-eslint/utils";
+import {
+  AST_NODE_TYPES as AST_NODE_TYPES53,
+  ASTUtils as ASTUtils14
+} from "@typescript-eslint/utils";
 var requireZodFormValidationDocumentation = {
   summary: "Require Zod validation (`Schema.parse(...)` / `Schema.safeParse(...)`) when reading values out of a `FormData` object.",
   rationale: "FormData values are untrusted strings or files and need runtime validation before use.",
   remediation: "Read the value inside a Zod schema's `parse` or `safeParse` input.",
   category: "security",
+  limitations: [
+    "Tests are excluded; imported schema-shaped names are trusted when their implementation is outside the linted file.",
+    "Delayed raw-value use is accepted only after an unconditional successful parse in the same block; safeParse remains valid when the raw binding has no unvalidated consumer."
+  ],
   examples: [
     { id: "validated-form-value", title: "Validate the form value", outcome: "no-match", files: [{ path: "src/action.ts", source: "const input = UserSchema.parse({ name: formData.get('name') });" }], focusPath: "src/action.ts", expectedCount: 0, public: true },
     { id: "raw-form-value", title: "Do not use a raw form value", outcome: "match", files: [{ path: "src/action.ts", source: "const name = formData.get('name');" }], focusPath: "src/action.ts", expectedCount: 1, public: true }
   ]
 };
-var isZodParseCall = (node) => {
-  if (node.type !== AST_NODE_TYPES53.CallExpression) return false;
-  const callee = node.callee;
-  if (callee.type !== AST_NODE_TYPES53.MemberExpression) return false;
-  if (callee.computed) return false;
-  if (callee.property.type !== AST_NODE_TYPES53.Identifier) return false;
-  const method = callee.property.name;
-  if (method !== "parse" && method !== "safeParse" && method !== "parseAsync" && method !== "safeParseAsync") {
-    return false;
-  }
-  return looksLikeZodSchema(callee.object);
-};
-var looksLikeZodSchema = (node) => {
+var ZOD_PARSE_METHODS = /* @__PURE__ */ new Set([
+  "parse",
+  "safeParse",
+  "parseAsync",
+  "safeParseAsync"
+]);
+var zodReceiverRoot = (node) => {
   let current = node;
   while (true) {
     if (current.type === AST_NODE_TYPES53.Identifier) {
-      return current.name === "z" || ZOD_SCHEMA_NAME_RE.test(current.name);
+      return current;
     }
     if (current.type === AST_NODE_TYPES53.CallExpression) {
       current = current.callee;
@@ -13194,7 +13341,7 @@ var looksLikeZodSchema = (node) => {
       current = current.object;
       continue;
     }
-    return false;
+    return null;
   }
 };
 var isFormDataMethodCall = (node) => {
@@ -13224,6 +13371,34 @@ var require_zod_form_validation_default = createRule({
     if (isTestFile(context.filename)) {
       return {};
     }
+    const zodBindings = /* @__PURE__ */ new Set();
+    const resolvedBinding = (identifier) => ASTUtils14.findVariable(
+      context.sourceCode.getScope(identifier),
+      identifier.name
+    );
+    const isProvablyNonZodLocal = (identifier) => {
+      const binding = resolvedBinding(identifier);
+      if (binding === null || zodBindings.has(binding) || binding.defs.length !== 1) {
+        return false;
+      }
+      const definition = binding.defs[0];
+      if (definition?.type !== "Variable" || definition.node.type !== AST_NODE_TYPES53.VariableDeclarator) {
+        return false;
+      }
+      const init = definition.node.init;
+      return init?.type === AST_NODE_TYPES53.ObjectExpression || init?.type === AST_NODE_TYPES53.ArrayExpression || init?.type === AST_NODE_TYPES53.Literal || init?.type === AST_NODE_TYPES53.ArrowFunctionExpression || init?.type === AST_NODE_TYPES53.FunctionExpression;
+    };
+    const isZodParseCall = (node) => {
+      if (node.type !== AST_NODE_TYPES53.CallExpression) return false;
+      const callee = node.callee;
+      if (callee.type !== AST_NODE_TYPES53.MemberExpression || callee.computed || callee.property.type !== AST_NODE_TYPES53.Identifier || !ZOD_PARSE_METHODS.has(callee.property.name)) {
+        return false;
+      }
+      const root = zodReceiverRoot(callee.object);
+      if (root === null) return false;
+      const binding = resolvedBinding(root);
+      return binding !== null && zodBindings.has(binding) || (root.name === "z" || ZOD_SCHEMA_NAME_RE.test(root.name)) && !isProvablyNonZodLocal(root);
+    };
     const isFormSourceIdentifier = (node) => {
       if (node.type !== AST_NODE_TYPES53.Identifier) return false;
       if (/formdata/i.test(node.name)) return true;
@@ -13249,14 +13424,15 @@ var require_zod_form_validation_default = createRule({
       }
       return isFormSourceIdentifier(callee.object);
     };
-    const hasZodParseAncestor = (node) => {
+    const zodParseAncestor = (node) => {
       let parent = node.parent;
       while (parent !== null && parent !== void 0) {
-        if (isZodParseCall(parent)) return true;
+        if (isZodParseCall(parent)) return parent;
         parent = parent.parent;
       }
-      return false;
+      return null;
     };
+    const hasZodParseAncestor = (node) => zodParseAncestor(node) !== null;
     const isInstanceofNarrowing = (node) => {
       const parent = node.parent;
       return parent !== null && parent !== void 0 && parent.type === AST_NODE_TYPES53.BinaryExpression && parent.operator === "instanceof" && parent.left === node && parent.right.type === AST_NODE_TYPES53.Identifier && (parent.right.name === "File" || parent.right.name === "Blob");
@@ -13273,14 +13449,111 @@ var require_zod_form_validation_default = createRule({
       }
       return null;
     };
+    const containingStatement = (node) => {
+      let current = node;
+      while (current.parent !== void 0) {
+        const parent = current.parent;
+        if (parent.type === AST_NODE_TYPES53.BlockStatement || parent.type === AST_NODE_TYPES53.Program) {
+          return current;
+        }
+        current = parent;
+      }
+      return null;
+    };
+    const zodParseMethod = (call) => {
+      const callee = call.callee;
+      return callee.type === AST_NODE_TYPES53.MemberExpression && !callee.computed && callee.property.type === AST_NODE_TYPES53.Identifier ? callee.property.name : null;
+    };
+    const hasConditionalAncestorBeforeStatement = (node, statement) => {
+      let current = node.parent;
+      while (current !== void 0 && current !== statement) {
+        if (current.type === AST_NODE_TYPES53.LogicalExpression || current.type === AST_NODE_TYPES53.ConditionalExpression) {
+          return true;
+        }
+        current = current.parent;
+      }
+      return false;
+    };
+    const isAwaitedBeforeStatement = (node, statement) => {
+      let current = node.parent;
+      while (current !== void 0 && current !== statement) {
+        if (current.type === AST_NODE_TYPES53.AwaitExpression) return true;
+        current = current.parent;
+      }
+      return false;
+    };
+    const guaranteedValidationStatement = (declarator, reference) => {
+      const parse2 = zodParseAncestor(reference);
+      if (parse2 === null) return null;
+      const declarationStatement = containingStatement(declarator);
+      const validationStatement = containingStatement(parse2);
+      if (declarationStatement === null || validationStatement === null || declarationStatement.parent !== validationStatement.parent || validationStatement.range[0] <= declarationStatement.range[1] || hasConditionalAncestorBeforeStatement(parse2, validationStatement)) {
+        return null;
+      }
+      if (validationStatement.type !== AST_NODE_TYPES53.VariableDeclaration && validationStatement.type !== AST_NODE_TYPES53.ExpressionStatement) {
+        return null;
+      }
+      const method = zodParseMethod(parse2);
+      if (method === "parse") return validationStatement;
+      if (method === "parseAsync" && isAwaitedBeforeStatement(parse2, validationStatement)) {
+        return validationStatement;
+      }
+      return null;
+    };
+    const isSafePrevalidationInspection = (identifier) => {
+      const parent = identifier.parent;
+      if (parent.type === AST_NODE_TYPES53.UnaryExpression && parent.operator === "typeof") {
+        return true;
+      }
+      if (parent.type !== AST_NODE_TYPES53.BinaryExpression || parent.left !== identifier) {
+        return false;
+      }
+      if (parent.operator === "instanceof") {
+        return parent.right.type === AST_NODE_TYPES53.Identifier && (parent.right.name === "File" || parent.right.name === "Blob");
+      }
+      return ["===", "!==", "==", "!="].includes(parent.operator) && (parent.right.type === AST_NODE_TYPES53.Literal && parent.right.value === null || parent.right.type === AST_NODE_TYPES53.Identifier && parent.right.name === "undefined");
+    };
+    const statementWithinBlock = (node, block) => {
+      let current = node;
+      while (current.parent !== void 0 && current.parent !== block) {
+        current = current.parent;
+      }
+      return current.parent === block ? current : null;
+    };
     const bindingIsValidated = (declarator) => {
       const variable = context.sourceCode.getDeclaredVariables(declarator)[0];
       if (variable === void 0) return false;
-      return variable.references.some(
-        (ref) => hasZodParseAncestor(ref.identifier) || isInstanceofNarrowing(ref.identifier)
+      const references = variable.references.filter((reference) => !reference.isWriteOnly()).map((reference) => reference.identifier).filter(
+        (identifier) => identifier.type === AST_NODE_TYPES53.Identifier
       );
+      if (references.length === 0) return false;
+      if (references.some(isInstanceofNarrowing)) return true;
+      const validationStatements = references.map((reference) => guaranteedValidationStatement(declarator, reference)).filter(
+        (statement) => statement !== null
+      );
+      const declarationStatement = containingStatement(declarator);
+      const declarationBlock = declarationStatement?.parent;
+      return references.every((reference) => {
+        if (zodParseAncestor(reference) !== null || isSafePrevalidationInspection(reference)) {
+          return true;
+        }
+        if (declarationBlock === void 0) return false;
+        const useStatement = statementWithinBlock(reference, declarationBlock);
+        return useStatement !== null && validationStatements.some(
+          (statement) => statement.range[1] < useStatement.range[0]
+        );
+      });
     };
     return {
+      ImportDeclaration(node) {
+        if (!isZodModule(node.source.value)) return;
+        for (const specifier of node.specifiers) {
+          if (specifier.type === AST_NODE_TYPES53.ImportNamespaceSpecifier || specifier.type === AST_NODE_TYPES53.ImportDefaultSpecifier || specifier.type === AST_NODE_TYPES53.ImportSpecifier && (specifier.imported.type === AST_NODE_TYPES53.Identifier ? specifier.imported.name === "z" : specifier.imported.value === "z")) {
+            const binding = resolvedBinding(specifier.local);
+            if (binding !== null) zodBindings.add(binding);
+          }
+        }
+      },
       CallExpression(node) {
         if (!isFormDataGetCall(node)) return;
         if (hasZodParseAncestor(node) || isInstanceofNarrowing(node)) return;
@@ -13360,7 +13633,7 @@ var store_insert_requires_on_conflict_default = createRule({
 });
 
 // src/rules/stepdown.ts
-import { AST_NODE_TYPES as AST_NODE_TYPES54, ASTUtils as ASTUtils13 } from "@typescript-eslint/utils";
+import { AST_NODE_TYPES as AST_NODE_TYPES54, ASTUtils as ASTUtils15 } from "@typescript-eslint/utils";
 var stepdownDocumentation = {
   summary: "Place a private helper below its sole direct same-scope caller.",
   rationale: "Caller-first ordering lets a reader follow the main flow before descending into implementation details.",
@@ -13553,7 +13826,7 @@ function methodName(node) {
   return !node.computed && node.key.type === AST_NODE_TYPES54.Identifier ? node.key.name : null;
 }
 function referencedMethod(context, node, classVariables) {
-  const objectVariable = node.object.type === AST_NODE_TYPES54.Identifier ? ASTUtils13.findVariable(context.sourceCode.getScope(node.object), node.object.name) : null;
+  const objectVariable = node.object.type === AST_NODE_TYPES54.Identifier ? ASTUtils15.findVariable(context.sourceCode.getScope(node.object), node.object.name) : null;
   const isClassReference = objectVariable !== null && classVariables.has(objectVariable);
   if (node.object.type !== AST_NODE_TYPES54.ThisExpression && !isClassReference) return null;
   if (node.property.type === AST_NODE_TYPES54.PrivateIdentifier) return `#${node.property.name}`;
@@ -13606,11 +13879,11 @@ function classScope(context, node, computedReferenceNames) {
   const pinned = /* @__PURE__ */ new Set();
   const classVariables = /* @__PURE__ */ new Set();
   if (node.id !== null) {
-    const internal = ASTUtils13.findVariable(context.sourceCode.getScope(node), node.id.name);
+    const internal = ASTUtils15.findVariable(context.sourceCode.getScope(node), node.id.name);
     if (internal !== null) classVariables.add(internal);
   }
   if (node.type === AST_NODE_TYPES54.ClassExpression && node.parent.type === AST_NODE_TYPES54.VariableDeclarator && node.parent.id.type === AST_NODE_TYPES54.Identifier) {
-    const outer = ASTUtils13.findVariable(context.sourceCode.getScope(node.parent), node.parent.id.name);
+    const outer = ASTUtils15.findVariable(context.sourceCode.getScope(node.parent), node.parent.id.name);
     if (outer !== null) classVariables.add(outer);
   }
   for (const method of methods) {
@@ -13646,7 +13919,7 @@ function classScope(context, node, computedReferenceNames) {
         return;
       }
       if (binding.type !== AST_NODE_TYPES54.Identifier) return;
-      const variable = ASTUtils13.findVariable(context.sourceCode.getScope(binding), binding.name);
+      const variable = ASTUtils15.findVariable(context.sourceCode.getScope(binding), binding.name);
       if (variable !== null) {
         methodClassVariables.add(variable);
         methodAliases.add(variable);
@@ -13676,7 +13949,7 @@ function classScope(context, node, computedReferenceNames) {
         return;
       }
       if (!privateNames.has(target)) return;
-      const objectVariable = current.object.type === AST_NODE_TYPES54.Identifier ? ASTUtils13.findVariable(context.sourceCode.getScope(current.object), current.object.name) : null;
+      const objectVariable = current.object.type === AST_NODE_TYPES54.Identifier ? ASTUtils15.findVariable(context.sourceCode.getScope(current.object), current.object.name) : null;
       if (objectVariable !== null && methodAliases.has(objectVariable)) {
         pinned.add(target);
         return;
@@ -13760,7 +14033,7 @@ var stepdown_default = createRule({
 // src/rules/zod-naming-convention.ts
 import {
   AST_NODE_TYPES as AST_NODE_TYPES55,
-  ASTUtils as ASTUtils14
+  ASTUtils as ASTUtils16
 } from "@typescript-eslint/utils";
 var zodNamingConventionDocumentation = {
   summary: "Enforce a consistent Zod schema naming convention \u2014 a `Z` prefix (`ZUser`) or a `Schema` suffix (`userSchema`); both are accepted by default.",
@@ -13847,7 +14120,7 @@ var zod_naming_convention_default = createRule({
     const acceptsSchemaWord = convention !== "prefix";
     const zodBindings = /* @__PURE__ */ new Set();
     function resolvedBinding(identifier) {
-      return ASTUtils14.findVariable(
+      return ASTUtils16.findVariable(
         context.sourceCode.getScope(identifier),
         identifier.name
       );
@@ -14043,7 +14316,7 @@ var rules = {
 };
 var meta = {
   name: "@sarj/eslint-plugin",
-  version: "15.1.0"
+  version: "15.2.0"
 };
 var applicationOnlyRules = [
   "no-restricted-library-load",