@sarj/eslint-plugin 15.1.0 → 15.3.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) {
@@ -3247,14 +3264,12 @@ var noJsonStringifyErrorDocumentation = {
   rationale: "Native Error details are non-enumerable, so generic JSON serialization discards diagnostic information.",
   remediation: "Serialize explicit error fields or use an error-aware serializer.",
   category: "correctness",
-  limitations: ["The rule uses local syntax and naming evidence rather than type information."],
+  limitations: ["The rule uses local catch-binding and constructor provenance rather than type information."],
   examples: [
     { id: "explicit-error-message", title: "Serialize an enumerable error field", outcome: "no-match", files: [{ path: "src/report.ts", source: "try { f(); } catch (err) { JSON.stringify({ error: err.message }); }" }], focusPath: "src/report.ts", expectedCount: 0, public: true },
     { id: "stringified-error", title: "Do not stringify an Error object", outcome: "match", files: [{ path: "src/report.ts", source: "try { f(); } catch (err) { JSON.stringify({ error: err }); }" }], focusPath: "src/report.ts", expectedCount: 1, public: true }
   ]
 };
-var ERROR_NAME_PATTERN = /^(e|err|error|ex|exc)$/i;
-var ERROR_PROP_PATTERN = /^(cause|lastError|error|err|exception|originalError|innerError)$/i;
 var SAFE_STRING_PROPS = /* @__PURE__ */ new Set(["message", "stack", "name"]);
 var PAYLOAD_PROPS = /* @__PURE__ */ new Set([
   "data",
@@ -3282,6 +3297,21 @@ var BUILTIN_ERROR_CONSTRUCTORS = /* @__PURE__ */ new Set([
   "TypeError",
   "URIError"
 ]);
+function identifierIsProvenError(identifier, scope) {
+  if (isCatchBinding(scope, identifier.name)) return true;
+  let current = scope;
+  while (current !== null && !current.set.has(identifier.name)) {
+    current = current.upper;
+  }
+  const variable = current?.set.get(identifier.name);
+  if (variable === void 0 || variable.defs.length !== 1) return false;
+  const definition = variable.defs[0];
+  if (definition?.type !== "Variable") return false;
+  const initializer = definition.node.init;
+  return initializer?.type === "NewExpression" && initializer.callee.type === "Identifier" && BUILTIN_ERROR_CONSTRUCTORS.has(initializer.callee.name) && variable.references.every(
+    (reference) => !reference.isWrite() || reference.init === true
+  );
+}
 function isCatchBinding(scope, name) {
   let current = scope;
   while (current) {
@@ -3297,22 +3327,6 @@ function isCatchBinding(scope, name) {
   }
   return false;
 }
-function memberSuggestsError(member, scope) {
-  const propName2 = !member.computed && member.property.type === "Identifier" ? member.property.name : null;
-  if (propName2 !== null && ERROR_PROP_PATTERN.test(propName2)) {
-    return true;
-  }
-  const base = member.object;
-  const baseSuggestsError = base.type === "Identifier" && (ERROR_NAME_PATTERN.test(base.name) || isCatchBinding(scope, base.name));
-  if (baseSuggestsError) {
-    if (propName2 === null) {
-      return true;
-    }
-    const lowered = propName2.toLowerCase();
-    return !SAFE_STRING_PROPS.has(lowered) && !PAYLOAD_PROPS.has(lowered);
-  }
-  return false;
-}
 function positiveErrorSubject(test) {
   return instanceofErrorSubject(test) ?? typeGuardSubject(test);
 }
@@ -3416,27 +3430,25 @@ function directLiteralValues(argument) {
 }
 function expressionSuggestsError(expression, scope) {
   if (expression.type === "Identifier") {
-    return ERROR_NAME_PATTERN.test(expression.name) || isCatchBinding(scope, expression.name);
+    return identifierIsProvenError(expression, scope);
+  }
+  if (expression.type === "NewExpression" && expression.callee.type === "Identifier") {
+    return BUILTIN_ERROR_CONSTRUCTORS.has(expression.callee.name);
   }
   return expression.type === "MemberExpression" && memberSuggestsError(expression, scope);
 }
-function nestedExpressionSuggestsError(expression, scope) {
-  if (expression.type === "Identifier") {
-    if (isCatchBinding(scope, expression.name)) return true;
-    let current = scope;
-    while (current !== null && !current.set.has(expression.name)) {
-      current = current.upper;
-    }
-    const variable = current?.set.get(expression.name);
-    if (variable === void 0 || variable.defs.length !== 1) return false;
-    const definition = variable.defs[0];
-    if (definition?.type !== "Variable") return false;
-    const initializer = definition.node.init;
-    return initializer?.type === "NewExpression" && initializer.callee.type === "Identifier" && BUILTIN_ERROR_CONSTRUCTORS.has(initializer.callee.name) && variable.references.every(
-      (reference) => !reference.isWrite() || reference.init === true
-    );
+function memberSuggestsError(member, scope) {
+  const propName2 = !member.computed && member.property.type === "Identifier" ? member.property.name : null;
+  const base = member.object;
+  const baseSuggestsError = base.type === "Identifier" && identifierIsProvenError(base, scope);
+  if (baseSuggestsError) {
+    if (propName2 === null) {
+      return true;
+    }
+    const lowered = propName2.toLowerCase();
+    return !SAFE_STRING_PROPS.has(lowered) && !PAYLOAD_PROPS.has(lowered);
   }
-  return expression.type === "MemberExpression" && memberSuggestsError(expression, scope);
+  return false;
 }
 var no_json_stringify_error_default = createRule({
   name: "no-json-stringify-error",
@@ -3463,9 +3475,8 @@ var no_json_stringify_error_default = createRule({
           return;
         }
         const scope = context.sourceCode.getScope(firstArg);
-        const isNestedLiteral = firstArg.type === "ObjectExpression" || firstArg.type === "ArrayExpression";
         const unsafeValue = directLiteralValues(firstArg).find(
-          (value) => (isNestedLiteral ? nestedExpressionSuggestsError(value, scope) : expressionSuggestsError(value, scope)) && !isGuardedByInstanceofError(node, value, context.sourceCode) && !isNarrowedByEarlyReturn(node, value, context.sourceCode)
+          (value) => expressionSuggestsError(value, scope) && !isGuardedByInstanceofError(node, value, context.sourceCode) && !isNarrowedByEarlyReturn(node, value, context.sourceCode)
         );
         if (unsafeValue === void 0) {
           return;
@@ -4032,7 +4043,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();
 }
@@ -4924,6 +4935,7 @@ var ANALYTICS_SEGMENTS2 = /* @__PURE__ */ new Set([
 ]);
 var SERVER_ACTION_SKIP_FILE_RE = /(?:\.test\.[jt]sx?$|\.spec\.[jt]sx?$|-(?:test|spec)\.[jt]sx?$|\/tests?\/|\/__tests__\/|\/__testfixtures__\/|\/scripts?\/|\/app\/api\/.*\/route\.[jt]sx?$|\/pages\/api\/)/;
 var NON_REACT_FRAMEWORK_RE = /^(?:@angular\/|@nestjs\/|vue$|vue\/|svelte$|svelte\/|solid-js$|solid-js\/|@ember\/|rxjs$|rxjs\/)/;
+var NEXT_MODULE_PATH_RE = /(?:^|[/\\])(?:app|pages)[/\\]/u;
 function isGlobalFetchCall(node, resolvesToGlobal) {
   const callee = node.callee;
   if (callee.type === "Identifier") {
@@ -5039,6 +5051,13 @@ var no_raw_fetch_outside_clients_default = createRule({
     const nonReactFramework = context.sourceCode.ast.body.some(
       (statement) => statement.type === import_utils25.AST_NODE_TYPES.ImportDeclaration && typeof statement.source.value === "string" && NON_REACT_FRAMEWORK_RE.test(statement.source.value)
     );
+    const hasUseClientDirective = context.sourceCode.ast.body.some(
+      (statement) => statement.type === import_utils25.AST_NODE_TYPES.ExpressionStatement && statement.expression.type === import_utils25.AST_NODE_TYPES.Literal && statement.expression.value === "use client"
+    );
+    const hasNextImport = context.sourceCode.ast.body.some(
+      (statement) => statement.type === import_utils25.AST_NODE_TYPES.ImportDeclaration && typeof statement.source.value === "string" && (statement.source.value === "next" || statement.source.value.startsWith("next/"))
+    );
+    const hasNextEvidence = hasNextImport || hasUseClientDirective && NEXT_MODULE_PATH_RE.test(filename);
     function resolvesToGlobal(identifier) {
       const variable = import_utils25.ASTUtils.findVariable(
         context.sourceCode.getScope(identifier),
@@ -5099,7 +5118,7 @@ var no_raw_fetch_outside_clients_default = createRule({
       return resolved?.type === import_utils25.AST_NODE_TYPES.LogicalExpression && resolved.operator === "||" && (isMutationMethod2(resolved.left) || isMutationMethod2(resolved.right));
     }
     function serverActionOwns(node) {
-      if (node.callee.type !== import_utils25.AST_NODE_TYPES.Identifier || SERVER_ACTION_SKIP_FILE_RE.test(filename) || nonReactFramework) {
+      if (node.callee.type !== import_utils25.AST_NODE_TYPES.Identifier || !hasNextEvidence || SERVER_ACTION_SKIP_FILE_RE.test(filename) || nonReactFramework) {
         return false;
       }
       const url = node.arguments[0];
@@ -6318,6 +6337,20 @@ var SAFE_PARSE_CONSTRUCTORS = /* @__PURE__ */ new Set([
 function isBodyDecodeNode(node) {
   return node.type === import_utils32.AST_NODE_TYPES.CallExpression && node.callee.type === import_utils32.AST_NODE_TYPES.MemberExpression && !node.callee.computed && node.callee.property.type === import_utils32.AST_NODE_TYPES.Identifier && BODY_DECODE_METHODS.has(node.callee.property.name);
 }
+function isSafeParseSupportCall(node) {
+  const callee = node.callee;
+  if (callee.type !== import_utils32.AST_NODE_TYPES.MemberExpression || callee.computed || callee.property.type !== import_utils32.AST_NODE_TYPES.Identifier) {
+    return false;
+  }
+  if (callee.property.name === "isArray" && callee.object.type === import_utils32.AST_NODE_TYPES.Identifier && callee.object.name === "Array") {
+    return true;
+  }
+  if (callee.property.name !== "getItem") return false;
+  if (callee.object.type === import_utils32.AST_NODE_TYPES.Identifier && (callee.object.name === "localStorage" || callee.object.name === "sessionStorage")) {
+    return true;
+  }
+  return callee.object.type === import_utils32.AST_NODE_TYPES.MemberExpression && !callee.object.computed && callee.object.object.type === import_utils32.AST_NODE_TYPES.Identifier && (callee.object.object.name === "window" || callee.object.object.name === "globalThis") && callee.object.property.type === import_utils32.AST_NODE_TYPES.Identifier && (callee.object.property.name === "localStorage" || callee.object.property.name === "sessionStorage");
+}
 var BODY_DECODE_METHODS = /* @__PURE__ */ new Set([
   "json",
   "text",
@@ -6386,6 +6419,7 @@ function tryReturnsSafeParse(catchNode) {
     if (current.type === import_utils32.AST_NODE_TYPES.CallExpression || current.type === import_utils32.AST_NODE_TYPES.NewExpression) {
       if (isParseShapedNode(current) || isBodyDecodeNode(current)) {
         sawSafeParse = true;
+      } else if (current.type === import_utils32.AST_NODE_TYPES.CallExpression && isSafeParseSupportCall(current)) {
       } else {
         sawUnsafeOperation = true;
         return;
@@ -6848,22 +6882,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 +6913,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 +7339,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 +7456,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 +7557,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 +7593,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 +7626,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 +8670,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 +8721,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);
+            }
           }
         }
       },
@@ -10789,7 +10943,70 @@ var bindingValidationPolarity = (test, bindingName) => {
   }
   return test.type === import_utils57.AST_NODE_TYPES.CallExpression && test.arguments.length === 1 && test.arguments[0]?.type === import_utils57.AST_NODE_TYPES.Identifier && test.arguments[0].name === bindingName && test.callee.type === import_utils57.AST_NODE_TYPES.MemberExpression && !test.callee.computed && test.callee.object.type === import_utils57.AST_NODE_TYPES.Identifier && test.callee.object.name === "Array" && test.callee.property.type === import_utils57.AST_NODE_TYPES.Identifier && test.callee.property.name === "isArray" ? "valid-when-true" : null;
 };
+var plainMemberAccess = (node) => node.type === import_utils57.AST_NODE_TYPES.MemberExpression && !node.computed && node.object.type === import_utils57.AST_NODE_TYPES.Identifier && node.property.type === import_utils57.AST_NODE_TYPES.Identifier ? { object: node.object.name, property: node.property.name } : null;
+var isSamePlainMember = (node, access) => {
+  const candidate = plainMemberAccess(node);
+  return candidate !== null && candidate.object === access.object && candidate.property === access.property;
+};
 var nodeWithin2 = (node, container) => node.range[0] >= container.range[0] && node.range[1] <= container.range[1];
+var isUseWithinValidatedBranch = (node, bindingName) => {
+  for (let current = node.parent; current !== void 0 && current !== null; current = current.parent) {
+    if (current.type === import_utils57.AST_NODE_TYPES.ConditionalExpression) {
+      const polarity = bindingValidationPolarity(current.test, bindingName);
+      if (polarity === "valid-when-true" && nodeWithin2(node, current.consequent) || polarity === "valid-when-false" && nodeWithin2(node, current.alternate)) {
+        return true;
+      }
+    }
+    if (current.type === import_utils57.AST_NODE_TYPES.IfStatement) {
+      const polarity = bindingValidationPolarity(current.test, bindingName);
+      if (polarity === "valid-when-true" && nodeWithin2(node, current.consequent) || polarity === "valid-when-false" && current.alternate !== null && nodeWithin2(node, current.alternate)) {
+        return true;
+      }
+    }
+    if (current.type === import_utils57.AST_NODE_TYPES.FunctionDeclaration || current.type === import_utils57.AST_NODE_TYPES.FunctionExpression || current.type === import_utils57.AST_NODE_TYPES.ArrowFunctionExpression) {
+      return false;
+    }
+  }
+  return false;
+};
+var isMemberUseWithinValidatedBranch = (node, access) => {
+  for (let current = node.parent; current !== void 0 && current !== null; current = current.parent) {
+    if (current.type === import_utils57.AST_NODE_TYPES.ConditionalExpression) {
+      const polarity = memberValidationPolarity(current.test, access);
+      if (polarity === "valid-when-true" && nodeWithin2(node, current.consequent) || polarity === "valid-when-false" && nodeWithin2(node, current.alternate)) {
+        return true;
+      }
+    }
+    if (current.type === import_utils57.AST_NODE_TYPES.IfStatement) {
+      const polarity = memberValidationPolarity(current.test, access);
+      if (polarity === "valid-when-true" && nodeWithin2(node, current.consequent) || polarity === "valid-when-false" && current.alternate !== null && nodeWithin2(node, current.alternate)) {
+        return true;
+      }
+    }
+    if (current.type === import_utils57.AST_NODE_TYPES.FunctionDeclaration || current.type === import_utils57.AST_NODE_TYPES.FunctionExpression || current.type === import_utils57.AST_NODE_TYPES.ArrowFunctionExpression) {
+      return false;
+    }
+  }
+  return false;
+};
+var memberValidationPolarity = (test, access) => {
+  if (test.type === import_utils57.AST_NODE_TYPES.UnaryExpression && test.operator === "!") {
+    const inner = memberValidationPolarity(test.argument, access);
+    return inner === "valid-when-true" ? "valid-when-false" : inner === "valid-when-false" ? "valid-when-true" : null;
+  }
+  if (test.type === import_utils57.AST_NODE_TYPES.BinaryExpression) {
+    const isMatchingTypeof = (node) => node.type === import_utils57.AST_NODE_TYPES.UnaryExpression && node.operator === "typeof" && isSamePlainMember(node.argument, access);
+    const isPrimitiveType = (node) => node.type === import_utils57.AST_NODE_TYPES.Literal && typeof node.value === "string" && PRIMITIVE_TYPEOF_RESULTS.has(node.value);
+    if (!(isMatchingTypeof(test.left) && isPrimitiveType(test.right) || isMatchingTypeof(test.right) && isPrimitiveType(test.left))) {
+      return null;
+    }
+    if (test.operator === "===" || test.operator === "==") {
+      return "valid-when-true";
+    }
+    return test.operator === "!==" || test.operator === "!=" ? "valid-when-false" : null;
+  }
+  return test.type === import_utils57.AST_NODE_TYPES.CallExpression && test.arguments.length === 1 && test.arguments[0] !== void 0 && test.arguments[0].type !== import_utils57.AST_NODE_TYPES.SpreadElement && isSamePlainMember(test.arguments[0], access) && test.callee.type === import_utils57.AST_NODE_TYPES.MemberExpression && !test.callee.computed && test.callee.object.type === import_utils57.AST_NODE_TYPES.Identifier && test.callee.object.name === "Array" && test.callee.property.type === import_utils57.AST_NODE_TYPES.Identifier && test.callee.property.name === "isArray" ? "valid-when-true" : null;
+};
 var isFullyValidatedExtractedBinding = (member, source, context) => {
   const isValidationReference = (identifier) => {
     for (let current = identifier.parent; current !== void 0 && current !== null; current = current.parent) {
@@ -11059,7 +11276,14 @@ var prefer_schema_for_api_payload_default = createRule({
           return;
         }
         const variable = obj?.type === import_utils57.AST_NODE_TYPES.Identifier ? unvalidatedVariableRef(obj, scope, unvalidatedVariables) : null;
-        if (variable !== null) {
+        if (variable !== null && obj?.type === import_utils57.AST_NODE_TYPES.Identifier) {
+          if (isUseWithinValidatedBranch(node, obj.name)) {
+            return;
+          }
+          const access = plainMemberAccess(node);
+          if (access !== null && isMemberUseWithinValidatedBranch(node, access)) {
+            return;
+          }
           if (isFullyValidatedExtractedBinding(node, variable, context)) {
             return;
           }
@@ -11511,16 +11735,17 @@ var preferServerActionsDocumentation = {
   rationale: "Server Actions preserve typed application calls and avoid an internal JSON request-response boundary.",
   remediation: "Move the mutation into a Server Action and invoke that action from the React client.",
   category: "architecture",
-  limitations: ["Only statically recognizable /api/ mutations in applicable React modules are reported."],
+  limitations: ["Only statically recognizable /api/ mutations in modules with positive Next.js evidence are reported: an explicit next import, or an app/pages path with a top-level use-client directive."],
   examples: [
     { id: "server-action-call", title: "Call a Server Action", outcome: "no-match", files: [{ path: "app/tasks/page.tsx", source: "import { createTask } from './actions'; await createTask(input);" }], focusPath: "app/tasks/page.tsx", expectedCount: 0, public: true },
-    { id: "api-mutation", title: "Do not mutate through an API route", outcome: "match", files: [{ path: "app/tasks/page.tsx", source: "await fetch('/api/tasks', { method: 'POST', body });" }], focusPath: "app/tasks/page.tsx", expectedCount: 1, public: true }
+    { id: "api-mutation", title: "Do not mutate through an API route", outcome: "match", files: [{ path: "app/tasks/page.tsx", source: "'use client'; await fetch('/api/tasks', { method: 'POST', body });" }], focusPath: "app/tasks/page.tsx", expectedCount: 1, public: true }
   ]
 };
 var MUTATION_METHODS = /* @__PURE__ */ new Set(["POST", "PUT", "DELETE", "PATCH"]);
 var AXIOS_MUTATION_METHODS = /* @__PURE__ */ new Set(["post", "put", "delete", "patch"]);
 var SKIP_FILE_REGEX = /(?:\.test\.[jt]sx?$|\.spec\.[jt]sx?$|-(?:test|spec)\.[jt]sx?$|\/tests?\/|\/__tests__\/|\/__testfixtures__\/|\/scripts?\/|\/app\/api\/.*\/route\.[jt]sx?$|\/pages\/api\/)/;
 var NON_REACT_FRAMEWORK_RE2 = /^(?:@angular\/|@nestjs\/|vue$|vue\/|svelte$|svelte\/|solid-js$|solid-js\/|@ember\/|rxjs$|rxjs\/)/;
+var NEXT_MODULE_PATH_RE2 = /(?:^|[/\\])(?:app|pages)[/\\]/u;
 function getScope(context, node) {
   return context.sourceCode.getScope(node);
 }
@@ -11634,6 +11859,16 @@ var prefer_server_actions_default = createRule({
     const isNonReactFramework = context.sourceCode.ast.body.some(
       (node) => node.type === "ImportDeclaration" && typeof node.source.value === "string" && NON_REACT_FRAMEWORK_RE2.test(node.source.value)
     );
+    const hasUseClientDirective = context.sourceCode.ast.body.some(
+      (node) => node.type === "ExpressionStatement" && node.expression.type === "Literal" && node.expression.value === "use client"
+    );
+    const hasNextImport = context.sourceCode.ast.body.some(
+      (node) => node.type === "ImportDeclaration" && typeof node.source.value === "string" && (node.source.value === "next" || node.source.value.startsWith("next/"))
+    );
+    const hasNextEvidence = hasNextImport || hasUseClientDirective && NEXT_MODULE_PATH_RE2.test(filename);
+    if (!hasNextEvidence) {
+      return {};
+    }
     return {
       CallExpression(node) {
         if (isNonReactFramework) return;
@@ -12356,6 +12591,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 +12623,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 +13435,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 +13464,7 @@ var looksLikeZodSchema = (node) => {
       current = current.object;
       continue;
     }
-    return false;
+    return null;
   }
 };
 var isFormDataMethodCall = (node) => {
@@ -13253,6 +13494,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 +13547,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 +13572,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 +14436,7 @@ var rules = {
 };
 var meta = {
   name: "@sarj/eslint-plugin",
-  version: "15.1.0"
+  version: "15.3.0"
 };
 var applicationOnlyRules = [
   "no-restricted-library-load",