@sarj/eslint-plugin 15.1.0 → 15.2.0

package/dist/index.cjs

@@ -1010,11 +1010,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);
@@ -1282,8 +1282,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;
@@ -1365,8 +1365,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;
@@ -2710,7 +2710,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)) {
@@ -2950,15 +2950,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 === import_utils13.AST_NODE_TYPES.Literal && typeof value.value === "string") {
@@ -2987,7 +3004,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 {
@@ -3002,7 +3019,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" });
         }
       }
@@ -3068,9 +3085,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) {
@@ -4032,7 +4049,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();
 }
@@ -6848,22 +6865,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 !== import_utils35.AST_NODE_TYPES.MemberExpression || callee.computed || callee.property.type !== import_utils35.AST_NODE_TYPES.Identifier) {
@@ -6876,8 +6896,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 === import_utils35.AST_NODE_TYPES.Identifier) {
+    return isStorageIdentifier(node.name);
+  }
+  if (node.type !== import_utils35.AST_NODE_TYPES.MemberExpression) {
+    return false;
+  }
+  if (!node.computed && node.property.type === import_utils35.AST_NODE_TYPES.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,
@@ -7279,12 +7322,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",
@@ -7322,7 +7439,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" });
           }
         }
@@ -7423,28 +7540,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,
@@ -7455,6 +7576,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."
     }
   },
@@ -7487,7 +7609,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"
+            });
           }
         }
       }
@@ -8528,15 +8653,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 import_utils45.ASTUtils.findVariable(
+        sourceCode.getScope(identifier),
+        identifier.name
+      );
+    }
     function isZodMemberCall(node, api) {
       const callee = node.callee;
-      if (callee.type === import_utils45.AST_NODE_TYPES.MemberExpression && !callee.computed && callee.object.type === import_utils45.AST_NODE_TYPES.Identifier && zodNamespaces.has(callee.object.name) && callee.property.type === import_utils45.AST_NODE_TYPES.Identifier) {
-        return callee.property.name === api;
+      if (callee.type === import_utils45.AST_NODE_TYPES.MemberExpression && !callee.computed && callee.object.type === import_utils45.AST_NODE_TYPES.Identifier && callee.property.type === import_utils45.AST_NODE_TYPES.Identifier) {
+        const binding = resolvedBinding(callee.object);
+        return binding !== null && zodNamespaceBindings.has(binding) && callee.property.name === api;
       }
       if (callee.type === import_utils45.AST_NODE_TYPES.Identifier) {
-        return zodImportedNames.get(callee.name) === api;
+        const binding = resolvedBinding(callee);
+        return binding !== null && zodImportedBindings.get(binding) === api;
       }
       return false;
     }
@@ -8571,10 +8704,14 @@ var no_zod_native_enum_default = createRule({
         }
         for (const spec of node.specifiers) {
           if (spec.type === import_utils45.AST_NODE_TYPES.ImportNamespaceSpecifier || spec.type === import_utils45.AST_NODE_TYPES.ImportDefaultSpecifier || spec.type === import_utils45.AST_NODE_TYPES.ImportSpecifier && (spec.imported.type === import_utils45.AST_NODE_TYPES.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 === import_utils45.AST_NODE_TYPES.ImportSpecifier && spec.imported.type === import_utils45.AST_NODE_TYPES.Identifier) {
-            zodImportedNames.set(spec.local.name, spec.imported.name);
+            const binding = resolvedBinding(spec.local);
+            if (binding !== null) {
+              zodImportedBindings.set(binding, spec.imported.name);
+            }
           }
         }
       },
@@ -12356,6 +12493,9 @@ var requireAssertNeverDocumentation = {
 };
 var isRuntimeHandlingStatement = (statement) => {
   if (statement.type === import_utils62.AST_NODE_TYPES.EmptyStatement) return false;
+  if (statement.type === import_utils62.AST_NODE_TYPES.BreakStatement) {
+    return statement.label !== null;
+  }
   if (statement.type === import_utils62.AST_NODE_TYPES.TSTypeAliasDeclaration || statement.type === import_utils62.AST_NODE_TYPES.TSInterfaceDeclaration) {
     return false;
   }
@@ -12385,7 +12525,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 & import_typescript.default.TypeFlags.BooleanLiteral) !== 0
+  )) {
+    return false;
+  }
   const expected = /* @__PURE__ */ new Set();
   for (const constituent of constituents) {
     const key = finiteTypeKey(constituent, checker);
@@ -13192,28 +13337,26 @@ var requireZodFormValidationDocumentation = {
   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 !== import_utils66.AST_NODE_TYPES.CallExpression) return false;
-  const callee = node.callee;
-  if (callee.type !== import_utils66.AST_NODE_TYPES.MemberExpression) return false;
-  if (callee.computed) return false;
-  if (callee.property.type !== import_utils66.AST_NODE_TYPES.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 === import_utils66.AST_NODE_TYPES.Identifier) {
-      return current.name === "z" || ZOD_SCHEMA_NAME_RE.test(current.name);
+      return current;
     }
     if (current.type === import_utils66.AST_NODE_TYPES.CallExpression) {
       current = current.callee;
@@ -13223,7 +13366,7 @@ var looksLikeZodSchema = (node) => {
       current = current.object;
       continue;
     }
-    return false;
+    return null;
   }
 };
 var isFormDataMethodCall = (node) => {
@@ -13253,6 +13396,34 @@ var require_zod_form_validation_default = createRule({
     if (isTestFile(context.filename)) {
       return {};
     }
+    const zodBindings = /* @__PURE__ */ new Set();
+    const resolvedBinding = (identifier) => import_utils66.ASTUtils.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 !== import_utils66.AST_NODE_TYPES.VariableDeclarator) {
+        return false;
+      }
+      const init = definition.node.init;
+      return init?.type === import_utils66.AST_NODE_TYPES.ObjectExpression || init?.type === import_utils66.AST_NODE_TYPES.ArrayExpression || init?.type === import_utils66.AST_NODE_TYPES.Literal || init?.type === import_utils66.AST_NODE_TYPES.ArrowFunctionExpression || init?.type === import_utils66.AST_NODE_TYPES.FunctionExpression;
+    };
+    const isZodParseCall = (node) => {
+      if (node.type !== import_utils66.AST_NODE_TYPES.CallExpression) return false;
+      const callee = node.callee;
+      if (callee.type !== import_utils66.AST_NODE_TYPES.MemberExpression || callee.computed || callee.property.type !== import_utils66.AST_NODE_TYPES.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 !== import_utils66.AST_NODE_TYPES.Identifier) return false;
       if (/formdata/i.test(node.name)) return true;
@@ -13278,14 +13449,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 === import_utils66.AST_NODE_TYPES.BinaryExpression && parent.operator === "instanceof" && parent.left === node && parent.right.type === import_utils66.AST_NODE_TYPES.Identifier && (parent.right.name === "File" || parent.right.name === "Blob");
@@ -13302,14 +13474,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 === import_utils66.AST_NODE_TYPES.BlockStatement || parent.type === import_utils66.AST_NODE_TYPES.Program) {
+          return current;
+        }
+        current = parent;
+      }
+      return null;
+    };
+    const zodParseMethod = (call) => {
+      const callee = call.callee;
+      return callee.type === import_utils66.AST_NODE_TYPES.MemberExpression && !callee.computed && callee.property.type === import_utils66.AST_NODE_TYPES.Identifier ? callee.property.name : null;
+    };
+    const hasConditionalAncestorBeforeStatement = (node, statement) => {
+      let current = node.parent;
+      while (current !== void 0 && current !== statement) {
+        if (current.type === import_utils66.AST_NODE_TYPES.LogicalExpression || current.type === import_utils66.AST_NODE_TYPES.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 === import_utils66.AST_NODE_TYPES.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 !== import_utils66.AST_NODE_TYPES.VariableDeclaration && validationStatement.type !== import_utils66.AST_NODE_TYPES.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 === import_utils66.AST_NODE_TYPES.UnaryExpression && parent.operator === "typeof") {
+        return true;
+      }
+      if (parent.type !== import_utils66.AST_NODE_TYPES.BinaryExpression || parent.left !== identifier) {
+        return false;
+      }
+      if (parent.operator === "instanceof") {
+        return parent.right.type === import_utils66.AST_NODE_TYPES.Identifier && (parent.right.name === "File" || parent.right.name === "Blob");
+      }
+      return ["===", "!==", "==", "!="].includes(parent.operator) && (parent.right.type === import_utils66.AST_NODE_TYPES.Literal && parent.right.value === null || parent.right.type === import_utils66.AST_NODE_TYPES.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 === import_utils66.AST_NODE_TYPES.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 === import_utils66.AST_NODE_TYPES.ImportNamespaceSpecifier || specifier.type === import_utils66.AST_NODE_TYPES.ImportDefaultSpecifier || specifier.type === import_utils66.AST_NODE_TYPES.ImportSpecifier && (specifier.imported.type === import_utils66.AST_NODE_TYPES.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;
@@ -14069,7 +14338,7 @@ var rules = {
 };
 var meta = {
   name: "@sarj/eslint-plugin",
-  version: "15.1.0"
+  version: "15.2.0"
 };
 var applicationOnlyRules = [
   "no-restricted-library-load",