@sarj/eslint-plugin 15.1.0 → 15.3.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) {
@@ -3207,14 +3224,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",
@@ -3242,6 +3257,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) {
@@ -3257,22 +3287,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);
 }
@@ -3376,27 +3390,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",
@@ -3423,9 +3435,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;
@@ -3994,7 +4005,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();
 }
@@ -4886,6 +4897,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") {
@@ -5001,6 +5013,13 @@ var no_raw_fetch_outside_clients_default = createRule({
     const nonReactFramework = context.sourceCode.ast.body.some(
       (statement) => statement.type === AST_NODE_TYPES18.ImportDeclaration && typeof statement.source.value === "string" && NON_REACT_FRAMEWORK_RE.test(statement.source.value)
     );
+    const hasUseClientDirective = context.sourceCode.ast.body.some(
+      (statement) => statement.type === AST_NODE_TYPES18.ExpressionStatement && statement.expression.type === AST_NODE_TYPES18.Literal && statement.expression.value === "use client"
+    );
+    const hasNextImport = context.sourceCode.ast.body.some(
+      (statement) => statement.type === AST_NODE_TYPES18.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 = ASTUtils5.findVariable(
         context.sourceCode.getScope(identifier),
@@ -5061,7 +5080,7 @@ var no_raw_fetch_outside_clients_default = createRule({
       return resolved?.type === AST_NODE_TYPES18.LogicalExpression && resolved.operator === "||" && (isMutationMethod2(resolved.left) || isMutationMethod2(resolved.right));
     }
     function serverActionOwns(node) {
-      if (node.callee.type !== AST_NODE_TYPES18.Identifier || SERVER_ACTION_SKIP_FILE_RE.test(filename) || nonReactFramework) {
+      if (node.callee.type !== AST_NODE_TYPES18.Identifier || !hasNextEvidence || SERVER_ACTION_SKIP_FILE_RE.test(filename) || nonReactFramework) {
         return false;
       }
       const url = node.arguments[0];
@@ -6280,6 +6299,20 @@ var SAFE_PARSE_CONSTRUCTORS = /* @__PURE__ */ new Set([
 function isBodyDecodeNode(node) {
   return node.type === AST_NODE_TYPES23.CallExpression && node.callee.type === AST_NODE_TYPES23.MemberExpression && !node.callee.computed && node.callee.property.type === AST_NODE_TYPES23.Identifier && BODY_DECODE_METHODS.has(node.callee.property.name);
 }
+function isSafeParseSupportCall(node) {
+  const callee = node.callee;
+  if (callee.type !== AST_NODE_TYPES23.MemberExpression || callee.computed || callee.property.type !== AST_NODE_TYPES23.Identifier) {
+    return false;
+  }
+  if (callee.property.name === "isArray" && callee.object.type === AST_NODE_TYPES23.Identifier && callee.object.name === "Array") {
+    return true;
+  }
+  if (callee.property.name !== "getItem") return false;
+  if (callee.object.type === AST_NODE_TYPES23.Identifier && (callee.object.name === "localStorage" || callee.object.name === "sessionStorage")) {
+    return true;
+  }
+  return callee.object.type === AST_NODE_TYPES23.MemberExpression && !callee.object.computed && callee.object.object.type === AST_NODE_TYPES23.Identifier && (callee.object.object.name === "window" || callee.object.object.name === "globalThis") && callee.object.property.type === AST_NODE_TYPES23.Identifier && (callee.object.property.name === "localStorage" || callee.object.property.name === "sessionStorage");
+}
 var BODY_DECODE_METHODS = /* @__PURE__ */ new Set([
   "json",
   "text",
@@ -6348,6 +6381,7 @@ function tryReturnsSafeParse(catchNode) {
     if (current.type === AST_NODE_TYPES23.CallExpression || current.type === AST_NODE_TYPES23.NewExpression) {
       if (isParseShapedNode(current) || isBodyDecodeNode(current)) {
         sawSafeParse = true;
+      } else if (current.type === AST_NODE_TYPES23.CallExpression && isSafeParseSupportCall(current)) {
       } else {
         sawUnsafeOperation = true;
         return;
@@ -6810,22 +6844,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 +6875,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 +7301,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 +7418,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 +7519,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 +7555,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 +7588,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 +8509,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 +8639,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 +8690,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 +8734,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 +8897,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 +9334,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 +9487,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 +10404,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 +10440,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 +10503,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 +10633,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];
@@ -10757,7 +10912,70 @@ var bindingValidationPolarity = (test, bindingName) => {
   }
   return test.type === AST_NODE_TYPES45.CallExpression && test.arguments.length === 1 && test.arguments[0]?.type === AST_NODE_TYPES45.Identifier && test.arguments[0].name === bindingName && test.callee.type === AST_NODE_TYPES45.MemberExpression && !test.callee.computed && test.callee.object.type === AST_NODE_TYPES45.Identifier && test.callee.object.name === "Array" && test.callee.property.type === AST_NODE_TYPES45.Identifier && test.callee.property.name === "isArray" ? "valid-when-true" : null;
 };
+var plainMemberAccess = (node) => node.type === AST_NODE_TYPES45.MemberExpression && !node.computed && node.object.type === AST_NODE_TYPES45.Identifier && node.property.type === AST_NODE_TYPES45.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 === AST_NODE_TYPES45.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 === AST_NODE_TYPES45.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 === AST_NODE_TYPES45.FunctionDeclaration || current.type === AST_NODE_TYPES45.FunctionExpression || current.type === AST_NODE_TYPES45.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 === AST_NODE_TYPES45.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 === AST_NODE_TYPES45.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 === AST_NODE_TYPES45.FunctionDeclaration || current.type === AST_NODE_TYPES45.FunctionExpression || current.type === AST_NODE_TYPES45.ArrowFunctionExpression) {
+      return false;
+    }
+  }
+  return false;
+};
+var memberValidationPolarity = (test, access) => {
+  if (test.type === AST_NODE_TYPES45.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 === AST_NODE_TYPES45.BinaryExpression) {
+    const isMatchingTypeof = (node) => node.type === AST_NODE_TYPES45.UnaryExpression && node.operator === "typeof" && isSamePlainMember(node.argument, access);
+    const isPrimitiveType = (node) => node.type === AST_NODE_TYPES45.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 === AST_NODE_TYPES45.CallExpression && test.arguments.length === 1 && test.arguments[0] !== void 0 && test.arguments[0].type !== AST_NODE_TYPES45.SpreadElement && isSamePlainMember(test.arguments[0], access) && test.callee.type === AST_NODE_TYPES45.MemberExpression && !test.callee.computed && test.callee.object.type === AST_NODE_TYPES45.Identifier && test.callee.object.name === "Array" && test.callee.property.type === AST_NODE_TYPES45.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) {
@@ -11027,7 +11245,14 @@ var prefer_schema_for_api_payload_default = createRule({
           return;
         }
         const variable = obj?.type === AST_NODE_TYPES45.Identifier ? unvalidatedVariableRef(obj, scope, unvalidatedVariables) : null;
-        if (variable !== null) {
+        if (variable !== null && obj?.type === AST_NODE_TYPES45.Identifier) {
+          if (isUseWithinValidatedBranch(node, obj.name)) {
+            return;
+          }
+          const access = plainMemberAccess(node);
+          if (access !== null && isMemberUseWithinValidatedBranch(node, access)) {
+            return;
+          }
           if (isFullyValidatedExtractedBinding(node, variable, context)) {
             return;
           }
@@ -11479,16 +11704,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);
 }
@@ -11602,6 +11828,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;
@@ -12327,6 +12563,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 +12595,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 +12668,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 +12749,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 +12759,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 +13401,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 +13439,7 @@ var looksLikeZodSchema = (node) => {
       current = current.object;
       continue;
     }
-    return false;
+    return null;
   }
 };
 var isFormDataMethodCall = (node) => {
@@ -13224,6 +13469,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 +13522,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 +13547,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 +13731,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 +13924,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 +13977,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 +14017,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 +14047,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 +14131,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 +14218,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 +14414,7 @@ var rules = {
 };
 var meta = {
   name: "@sarj/eslint-plugin",
-  version: "15.1.0"
+  version: "15.3.0"
 };
 var applicationOnlyRules = [
   "no-restricted-library-load",