@sarj/eslint-plugin 11.0.1 → 11.2.0

package/dist/index.js

@@ -827,6 +827,7 @@ var BANNER_RUN_RE = /={4,}|-{4,}|#{4,}|\*{4,}|~{4,}|[\u2500-\u257f]{4,}/;
 var REGION_MARKER_RE = /^#?(?:end)?region\b(.*)$/i;
 var REGION_TITLE_RE = /^[\s:\-\u2013\u2014]*\w[\w \-/&+]*$/;
 var REGION_TITLE_MAX_WORDS = 5;
+var REGION_PROSE_VERB_RE = /^(?:is|are|was|were|comes?|defaults?|derives?|inherits?|depends?|uses?|maps?|resolves?)\b/i;
 function stripCommentMarker(line) {
   return line.replace(/^\s*\/{1,2}/, "").replace(/^\s*\*+/, "").trim();
 }
@@ -888,7 +889,9 @@ var CALL_RE = /^[A-Za-z_$][\w.$]*\([^)]*\)\s*;?\s*$/;
 var ASSERTION_CODE_RE = /^(?:await\s+)?(?:expect(?:TypeOf)?|assert(?:\.\w+)?)\s*\(/;
 var HTTP_CONTRACT_RE = /\b(?:GET|HEAD|OPTIONS|PATCH|POST|PUT|DELETE)\s+(?:https?:\/\/|\/|\{[A-Za-z_$])/;
 var PROSE_ASSIGNMENT_RE = /^[A-Za-z_$][\w.$[\]]*\s*=\s*[A-Za-z][A-Za-z '-]{2,}\s+\((?:how|what|when|where|which|who|why)\b[^)]*\)[.!]?$/i;
-var PSEUDOCODE_RE = /%\w+%|\[opt\]|(?:^|\s)<[A-Za-z]\w*>|…|\.\.\./;
+var PSEUDOCODE_RE = /%\w+%|\[opt\]|(?:^|\s)<[A-Za-z]\w*>|\b[A-Za-z_$][\w$]*\s+x\d+\b|…|\.\.\./;
+var CALL_LABEL_RE = /^([A-Za-z_$][\w$]*(?:\.[A-Za-z_$][\w$]*)*)\([^;{}]*\)$/;
+var MULTIPLIER_PSEUDOCODE_RE = /\b[A-Za-z_$][\w$]*\s+x\d+\b/;
 function isBanner(text) {
   const t = text.trim();
   if (!t) return false;
@@ -900,6 +903,7 @@ function isRegionMarker(text) {
   if (match === null) return false;
   const title = (match[1] ?? "").trim();
   if (title.length === 0) return true;
+  if (REGION_PROSE_VERB_RE.test(title)) return false;
   if (!REGION_TITLE_RE.test(title)) return false;
   return title.split(/\s+/).length <= REGION_TITLE_MAX_WORDS;
 }
@@ -915,6 +919,15 @@ function looksLikeCode(text, allowCall = true) {
 function hasPseudocode(text) {
   return PSEUDOCODE_RE.test(text);
 }
+function testCallMatrixStems(comments) {
+  const stems = /* @__PURE__ */ new Set();
+  for (const comment of comments) {
+    const body2 = stripCommentMarker(comment.value);
+    const stem3 = CALL_LABEL_RE.exec(body2)?.[1];
+    if (stem3 !== void 0 && MULTIPLIER_PSEUDOCODE_RE.test(body2)) stems.add(stem3);
+  }
+  return stems;
+}
 function isEnumeratedProseItem(text) {
   const t = text.trim();
   return ENUMERATED_ITEM_RE.test(t) && t.split(/\s+/).length >= ENUMERATED_ITEM_MIN_WORDS;
@@ -1203,6 +1216,7 @@ var no_comment_cruft_default = createRule({
     return {
       Program() {
         const comments = sourceCode.getAllComments();
+        const callMatrixStems = isTestFile(context.filename) ? testCallMatrixStems(comments) : /* @__PURE__ */ new Set();
         const walls = findCommentWalls(comments);
         const wallByLeader = new Map(walls.map((wall) => [wall.leader, wall]));
         const wallMembers = new Set(walls.flatMap((wall) => [...wall.members]));
@@ -1240,6 +1254,8 @@ var no_comment_cruft_default = createRule({
             continue;
           }
           const firstText = texts[0];
+          const firstTextStem = firstText === void 0 ? void 0 : CALL_LABEL_RE.exec(firstText)?.[1];
+          if (firstTextStem !== void 0 && texts.length === 1 && callMatrixStems.has(firstTextStem)) continue;
           if (firstText !== void 0 && /^(?:todo|fixme)\b/i.test(firstText)) {
             if (!runCitesAReference(comments, i)) {
               context.report({
@@ -2169,6 +2185,20 @@ var PURE_METHODS = /* @__PURE__ */ new Set([
   "startsWith",
   "endsWith"
 ]);
+var SYNC_CALLBACK_METHODS = /* @__PURE__ */ new Set([
+  "every",
+  "filter",
+  "findIndex",
+  "findLast",
+  "findLastIndex",
+  "flatMap",
+  "forEach",
+  "map",
+  "reduce",
+  "reduceRight",
+  "some",
+  "sort"
+]);
 var PURE_NAMESPACES = /* @__PURE__ */ new Set([
   "Object",
   "Array",
@@ -2218,7 +2248,17 @@ function isPureCall(node) {
   if (callee.object.type === AST_NODE_TYPES10.Identifier && PURE_NAMESPACES.has(callee.object.name)) {
     return !IMPURE_NAMESPACE_METHODS.has(`${callee.object.name}.${property.name}`);
   }
-  return PURE_METHODS.has(property.name);
+  return PURE_METHODS.has(property.name) && (!SYNC_CALLBACK_METHODS.has(property.name) || !synchronousCallbackCanThrow(node));
+}
+function synchronousCallbackCanThrow(node) {
+  return node.arguments.some((argument) => {
+    if (argument.type !== AST_NODE_TYPES10.ArrowFunctionExpression && argument.type !== AST_NODE_TYPES10.FunctionExpression) return false;
+    if (argument.async) return false;
+    return subtreeMatches2(
+      argument.body,
+      (current) => current.type === AST_NODE_TYPES10.ThrowStatement || current.type === AST_NODE_TYPES10.CallExpression && current.callee.type === AST_NODE_TYPES10.MemberExpression && !current.callee.computed && current.callee.object.type === AST_NODE_TYPES10.Identifier && current.callee.object.name === "JSON" && current.callee.property.type === AST_NODE_TYPES10.Identifier && current.callee.property.name === "parse"
+    );
+  });
 }
 function isPureNew(node) {
   return node.callee.type === AST_NODE_TYPES10.Identifier && PURE_CONSTRUCTORS.has(node.callee.name);
@@ -2899,6 +2939,16 @@ var PAYLOAD_PROPS = /* @__PURE__ */ new Set([
   "metadata",
   "context"
 ]);
+var BUILTIN_ERROR_CONSTRUCTORS = /* @__PURE__ */ new Set([
+  "AggregateError",
+  "Error",
+  "EvalError",
+  "RangeError",
+  "ReferenceError",
+  "SyntaxError",
+  "TypeError",
+  "URIError"
+]);
 function isCatchBinding(scope, name) {
   let current = scope;
   while (current) {
@@ -3013,6 +3063,48 @@ function nodeWithin(node, container) {
 function isJsonStringify(callee) {
   return callee.type === "MemberExpression" && !callee.computed && callee.object.type === "Identifier" && callee.object.name === "JSON" && callee.property.type === "Identifier" && callee.property.name === "stringify";
 }
+function directLiteralValues(argument) {
+  if (argument.type === "ObjectExpression") {
+    return argument.properties.flatMap((property) => {
+      if (property.type !== "Property" || property.computed) return [];
+      const value = property.value;
+      if (value.type === "AssignmentPattern" || value.type === "ArrayPattern" || value.type === "ObjectPattern" || value.type === "TSEmptyBodyFunctionExpression") {
+        return [];
+      }
+      return [value];
+    });
+  }
+  if (argument.type === "ArrayExpression") {
+    return argument.elements.flatMap(
+      (element) => element !== null && element.type !== "SpreadElement" ? [element] : []
+    );
+  }
+  return argument.type === "SpreadElement" ? [] : [argument];
+}
+function expressionSuggestsError(expression, scope) {
+  if (expression.type === "Identifier") {
+    return ERROR_NAME_PATTERN.test(expression.name) || isCatchBinding(scope, expression.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
+    );
+  }
+  return expression.type === "MemberExpression" && memberSuggestsError(expression, scope);
+}
 var no_json_stringify_error_default = createRule({
   name: "no-json-stringify-error",
   meta: {
@@ -3037,18 +3129,11 @@ var no_json_stringify_error_default = createRule({
           return;
         }
         const scope = context.sourceCode.getScope(firstArg);
-        let suggestsError;
-        if (firstArg.type === "Identifier") {
-          suggestsError = ERROR_NAME_PATTERN.test(firstArg.name) || isCatchBinding(scope, firstArg.name);
-        } else if (firstArg.type === "MemberExpression") {
-          suggestsError = memberSuggestsError(firstArg, scope);
-        } else {
-          return;
-        }
-        if (!suggestsError) {
-          return;
-        }
-        if (isGuardedByInstanceofError(node, firstArg, context.sourceCode) || isNarrowedByEarlyReturn(node, firstArg, context.sourceCode)) {
+        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)
+        );
+        if (unsafeValue === void 0) {
           return;
         }
         context.report({
@@ -3435,6 +3520,8 @@ function typedFunction(node) {
 
 // src/rules/no-long-comment.ts
 var EXCESSIVE_SENTENCE_COUNT = 8;
+var EXCESSIVE_WORD_COUNT = 120;
+var PROSE_WORD_RE = /[\p{L}\p{N}][\p{L}\p{N}'’-]*/gu;
 var VERSIONED_DEPENDENCY_TREE_RE = /(?:^|\/)lib\/[^/]*-?v?\d+\.\d+(?:\.\d+)?[^/]*\//iu;
 function documentsTypeOrMember(sourceCode, comment) {
   const token = sourceCode.getTokenAfter(comment, { includeComments: false });
@@ -3446,6 +3533,9 @@ function documentsTypeOrMember(sourceCode, comment) {
   }
   return false;
 }
+function wordUnits(text) {
+  return text.match(PROSE_WORD_RE)?.length ?? 0;
+}
 var no_long_comment_default = createRule({
   name: "no-long-comment",
   meta: {
@@ -3463,7 +3553,7 @@ var no_long_comment_default = createRule({
     return {
       Program() {
         for (const group of proseGroups(context.filename, context.sourceCode)) {
-          if (group.comment.type !== "Block" || !group.comment.value.startsWith("*") || group.hasTypedTags || hasDocumentationStructure(group.text) || hasTechnicalAnchor(group.text) || documentsTypedFunction(context.sourceCode, group.comment) || documentsTypeOrMember(context.sourceCode, group.comment) || sentenceUnits(group.text) < EXCESSIVE_SENTENCE_COUNT) continue;
+          if (group.comment.type !== "Block" || !group.comment.value.startsWith("*") || group.hasTypedTags || hasDocumentationStructure(group.text) || hasTechnicalAnchor(group.text) || documentsTypedFunction(context.sourceCode, group.comment) || documentsTypeOrMember(context.sourceCode, group.comment) || sentenceUnits(group.text) < EXCESSIVE_SENTENCE_COUNT && wordUnits(group.text) < EXCESSIVE_WORD_COUNT) continue;
           context.report({ node: group.comment, messageId: "tooLong" });
         }
       }
@@ -5118,50 +5208,59 @@ var no_select_star_default = createRule({
 
 // src/rules/no-sentinel-return-on-catch.ts
 import { AST_NODE_TYPES as AST_NODE_TYPES23 } from "@typescript-eslint/utils";
+function unwrapSentinelExpression(arg) {
+  let current = arg;
+  while (current?.type === AST_NODE_TYPES23.TSAsExpression || current?.type === AST_NODE_TYPES23.TSTypeAssertion || current?.type === AST_NODE_TYPES23.TSSatisfiesExpression) {
+    current = current.expression;
+  }
+  return current;
+}
 function sentinelKind(arg) {
-  if (arg === null) {
+  const value = unwrapSentinelExpression(arg);
+  if (value === null) {
     return null;
   }
-  if (arg.type === AST_NODE_TYPES23.Literal) {
-    if (arg.value === null) {
+  if (value.type === AST_NODE_TYPES23.Literal) {
+    if (value.value === null) {
       return "nullish";
     }
-    if (typeof arg.value === "boolean") {
+    if (typeof value.value === "boolean") {
       return "boolean";
     }
-    if (typeof arg.value === "string") {
+    if (typeof value.value === "string") {
       return "string";
     }
     return null;
   }
-  if (arg.type === AST_NODE_TYPES23.Identifier && arg.name === "undefined") {
+  if (value.type === AST_NODE_TYPES23.Identifier && value.name === "undefined") {
     return "nullish";
   }
-  if (arg.type === AST_NODE_TYPES23.ArrayExpression) {
+  if (value.type === AST_NODE_TYPES23.ArrayExpression) {
     return "array";
   }
-  if (arg.type === AST_NODE_TYPES23.ObjectExpression) {
+  if (value.type === AST_NODE_TYPES23.ObjectExpression) {
     return "object";
   }
   return null;
 }
 function isSentinelArgument(arg) {
-  if (arg === null) {
+  const value = unwrapSentinelExpression(arg);
+  if (value === null) {
     return false;
   }
-  if (arg.type === AST_NODE_TYPES23.Literal && arg.value === null) {
+  if (value.type === AST_NODE_TYPES23.Literal && value.value === null) {
     return true;
   }
-  if (arg.type === AST_NODE_TYPES23.Literal && arg.value === false) {
+  if (value.type === AST_NODE_TYPES23.Literal && value.value === false) {
     return true;
   }
-  if (arg.type === AST_NODE_TYPES23.Identifier && arg.name === "undefined") {
+  if (value.type === AST_NODE_TYPES23.Identifier && value.name === "undefined") {
     return true;
   }
-  if (arg.type === AST_NODE_TYPES23.ArrayExpression && arg.elements.length === 0) {
+  if (value.type === AST_NODE_TYPES23.ArrayExpression && value.elements.length === 0) {
     return true;
   }
-  if (arg.type === AST_NODE_TYPES23.ObjectExpression && arg.properties.length === 0) {
+  if (value.type === AST_NODE_TYPES23.ObjectExpression && value.properties.length === 0) {
     return true;
   }
   return false;
@@ -5359,6 +5458,16 @@ function tryReturnsSafeParse(catchNode) {
   const only = tryBlock.body.length === 1 ? tryBlock.body[0] : void 0;
   return only !== void 0 && returnsMatching(only, isBodyDecodeNode);
 }
+function isIntentionalStackCapture(catchNode, caughtName) {
+  if (caughtName === null) return false;
+  const tryBody = tryBlockOf(catchNode).body;
+  const only = tryBody.length === 1 ? tryBody[0] : void 0;
+  if (only?.type !== AST_NODE_TYPES23.ThrowStatement) return false;
+  const thrown = unwrapSentinelExpression(only.argument);
+  const constructsError = (thrown?.type === AST_NODE_TYPES23.CallExpression || thrown?.type === AST_NODE_TYPES23.NewExpression) && thrown.callee.type === AST_NODE_TYPES23.Identifier && thrown.callee.name === "Error";
+  if (!constructsError) return false;
+  return catchNode.body.body.slice(0, -1).some((statement) => subtreeReadsName(statement, caughtName));
+}
 function tryBlockOf(catchNode) {
   return catchNode.parent.block;
 }
@@ -5479,6 +5588,9 @@ var no_sentinel_return_on_catch_default = createRule({
         if (tryReturnsSafeParse(node)) {
           return;
         }
+        if (isIntentionalStackCapture(node, caughtName)) {
+          return;
+        }
         const kind = sentinelKind(last.argument);
         if (kind !== null && isNamedBooleanPredicate(node, kind)) {
           return;
@@ -5557,11 +5669,11 @@ var no_silent_promise_catch_default = createRule({
   meta: {
     type: "problem",
     docs: {
-      description: "Disallow `.catch()` handlers that silently swallow the rejection (e.g. `.catch(() => null)`); log, rethrow, or handle the error."
+      description: "Disallow `.catch()` and second-argument `.then()` handlers that silently swallow a rejection; log, rethrow, or handle the error."
     },
     schema: [],
     messages: {
-      silentCatch: "This `.catch()` swallows the rejection without logging, rethrowing, or handling it \u2014 failures become invisible and callers get an indistinguishable sentinel. Log the error (and only then map to a fallback), or let it propagate."
+      silentCatch: "This rejection handler swallows the error without logging, rethrowing, or handling it \u2014 failures become invisible and callers get an indistinguishable sentinel. Log the error (and only then map to a fallback), or let it propagate."
     }
   },
   defaultOptions: [],
@@ -5587,9 +5699,12 @@ var no_silent_promise_catch_default = createRule({
     };
     return {
       CallExpression(node) {
-        if (node.callee.type !== AST_NODE_TYPES24.MemberExpression || node.callee.computed || node.callee.property.type !== AST_NODE_TYPES24.Identifier || node.callee.property.name !== "catch") {
+        if (node.callee.type !== AST_NODE_TYPES24.MemberExpression || node.callee.computed || node.callee.property.type !== AST_NODE_TYPES24.Identifier) {
           return;
         }
+        const method = node.callee.property.name;
+        const handlerIndex = method === "catch" ? 0 : method === "then" ? 1 : null;
+        if (handlerIndex === null) return;
         if (isBodyParseCall(node.callee.object)) {
           return;
         }
@@ -5599,10 +5714,11 @@ var no_silent_promise_catch_default = createRule({
         if (node.parent.type === AST_NODE_TYPES24.MemberExpression && node.parent.object === node) {
           return;
         }
-        if (node.arguments.length !== 1) {
+        const expectedArguments = method === "catch" ? 1 : 2;
+        if (node.arguments.length !== expectedArguments) {
           return;
         }
-        const handler = node.arguments[0];
+        const handler = node.arguments[handlerIndex];
         if (handler === void 0 || handler.type !== AST_NODE_TYPES24.ArrowFunctionExpression && handler.type !== AST_NODE_TYPES24.FunctionExpression) {
           return;
         }
@@ -5865,6 +5981,11 @@ function isStringLiteralInit(node) {
   return false;
 }
 function isConcatOntoTarget(rhs, target) {
+  if (rhs.type === "TemplateLiteral") {
+    return rhs.expressions.some(
+      (expression) => expression.type === "Identifier" && expression.name === target
+    );
+  }
   if (rhs.type !== "BinaryExpression" || rhs.operator !== "+") {
     return false;
   }
@@ -7420,6 +7541,15 @@ var SUCCESS_PAYLOAD_MEMBER_NAMES = /* @__PURE__ */ new Set([
   "value"
 ]);
 var REQUIRED_STATUS_MEMBER_COUNT = 1;
+var FUNCTION_RETURN_OWNER_TYPES = /* @__PURE__ */ new Set([
+  AST_NODE_TYPES37.ArrowFunctionExpression,
+  AST_NODE_TYPES37.FunctionDeclaration,
+  AST_NODE_TYPES37.FunctionExpression,
+  AST_NODE_TYPES37.TSDeclareFunction,
+  AST_NODE_TYPES37.TSEmptyBodyFunctionExpression,
+  AST_NODE_TYPES37.TSFunctionType,
+  AST_NODE_TYPES37.TSMethodSignature
+]);
 function looksLikeMutuallyExclusiveState(typeLiteral) {
   let statusMemberCount = 0;
   let hasFailurePayload = false;
@@ -7460,6 +7590,17 @@ function getMemberName(member) {
 function isBooleanTyped(member) {
   return member.typeAnnotation?.typeAnnotation.type === AST_NODE_TYPES37.TSBooleanKeyword;
 }
+function inlineReturnTypeLiteral(node) {
+  let annotation = null;
+  if (node.parent.type === AST_NODE_TYPES37.TSTypeAnnotation) {
+    annotation = node.parent;
+  } else if (node.parent.type === AST_NODE_TYPES37.TSTypeParameterInstantiation && node.parent.params.length === 1 && node.parent.params[0] === node && node.parent.parent.type === AST_NODE_TYPES37.TSTypeReference && node.parent.parent.typeName.type === AST_NODE_TYPES37.Identifier && node.parent.parent.typeName.name === "Promise" && node.parent.parent.parent.type === AST_NODE_TYPES37.TSTypeAnnotation) {
+    annotation = node.parent.parent.parent;
+  }
+  if (annotation === null) return null;
+  const owner = annotation.parent;
+  return FUNCTION_RETURN_OWNER_TYPES.has(owner.type) && "returnType" in owner && owner.returnType === annotation ? annotation : null;
+}
 var prefer_discriminated_union_default = createRule({
   name: "prefer-discriminated-union",
   meta: {
@@ -7499,6 +7640,10 @@ var prefer_discriminated_union_default = createRule({
       },
       "TSTypeAliasDeclaration > TSTypeLiteral"(node) {
         checkTypeLiteral(node, node.parent);
+      },
+      TSTypeLiteral(node) {
+        const annotation = inlineReturnTypeLiteral(node);
+        if (annotation !== null) checkTypeLiteral(node, annotation);
       }
     };
   }
@@ -8415,6 +8560,11 @@ var prefer_module_level_schema_default = createRule({
             type: "boolean",
             description: "Skip test files, where a fixture schema belongs next to its assertion."
           },
+          memoCallees: {
+            type: "array",
+            items: { type: "string" },
+            description: "Wrappers that construct their callback at most once. Defaults to lazy, memo, once, and useMemo."
+          },
           minProperties: {
             type: "number",
             minimum: 0,
@@ -8432,6 +8582,7 @@ var prefer_module_level_schema_default = createRule({
   create(context, [options]) {
     const factories = new Set(options?.factories ?? DEFAULT_FACTORIES);
     const ignoreTestFiles = options?.ignoreTestFiles ?? true;
+    const memoCallees = new Set(options?.memoCallees ?? MEMO_CALLEES);
     const minProperties = options?.minProperties ?? DEFAULT_MIN_PROPERTIES;
     const sourceCode = context.sourceCode;
     const filename = context.filename;
@@ -8451,7 +8602,7 @@ var prefer_module_level_schema_default = createRule({
         if (current !== node && isZodCall(current) && current.callee.type === AST_NODE_TYPES42.MemberExpression && current.callee.property.type === AST_NODE_TYPES42.Identifier && factories.has(current.callee.property.name)) {
           return true;
         }
-        if (current.type === AST_NODE_TYPES42.CallExpression && (current.callee.type === AST_NODE_TYPES42.Identifier && MEMO_CALLEES.has(current.callee.name) || current.callee.type === AST_NODE_TYPES42.MemberExpression && !current.callee.computed && current.callee.property.type === AST_NODE_TYPES42.Identifier && MEMO_CALLEES.has(current.callee.property.name))) {
+        if (current.type === AST_NODE_TYPES42.CallExpression && (current.callee.type === AST_NODE_TYPES42.Identifier && memoCallees.has(current.callee.name) || current.callee.type === AST_NODE_TYPES42.MemberExpression && !current.callee.computed && current.callee.property.type === AST_NODE_TYPES42.Identifier && memoCallees.has(current.callee.property.name))) {
           return true;
         }
         current = current.parent ?? void 0;
@@ -8501,6 +8652,9 @@ var prefer_module_level_schema_default = createRule({
           if (definition.type === "ImportBinding") {
             continue;
           }
+          if (definition.node.type === AST_NODE_TYPES42.VariableDeclarator && definition.node.parent.type === AST_NODE_TYPES42.VariableDeclaration && definition.node.parent.kind !== "const") {
+            return false;
+          }
           const [defStart, defEnd] = definition.node.range;
           if (defStart >= schemaStart && defEnd <= schemaEnd) {
             continue;
@@ -8735,7 +8889,7 @@ function sameAccess(node, access) {
   return node.type === AST_NODE_TYPES44.MemberExpression && !node.computed && node.object.type === AST_NODE_TYPES44.Identifier && node.object.name === access.object && node.property.type === AST_NODE_TYPES44.Identifier && node.property.name === access.property;
 }
 function isNullGuard(node, access) {
-  if (node.type === AST_NODE_TYPES44.UnaryExpression && node.operator === "!" && sameAccess(node.argument, access)) return true;
+  if (node.type === AST_NODE_TYPES44.UnaryExpression && node.operator === "!" && (sameAccess(node.argument, access) || optionalMemberLengthOf(node.argument, access))) return true;
   if (node.type !== AST_NODE_TYPES44.BinaryExpression || !["==", "==="].includes(node.operator)) {
     return false;
   }
@@ -8751,7 +8905,11 @@ function isEmptyGuard(node, access) {
   return memberLengthOf(node.left, access) && zero(node.right) || memberLengthOf(node.right, access) && zero(node.left);
 }
 function memberLengthOf(node, access) {
-  return node.type === AST_NODE_TYPES44.MemberExpression && !node.computed && node.property.type === AST_NODE_TYPES44.Identifier && node.property.name === "length" && sameAccess(node.object, access);
+  const target = node.type === AST_NODE_TYPES44.ChainExpression ? node.expression : node;
+  return target.type === AST_NODE_TYPES44.MemberExpression && !target.computed && target.property.type === AST_NODE_TYPES44.Identifier && target.property.name === "length" && sameAccess(target.object, access);
+}
+function optionalMemberLengthOf(node, access) {
+  return node.type === AST_NODE_TYPES44.ChainExpression && node.expression.type === AST_NODE_TYPES44.MemberExpression && node.expression.optional && memberLengthOf(node, access);
 }
 function hasEquivalentLeadingGuard(fn, access, visitorKeys) {
   if (fn.body.type !== AST_NODE_TYPES44.BlockStatement) return false;
@@ -8759,6 +8917,7 @@ function hasEquivalentLeadingGuard(fn, access, visitorKeys) {
   if (first?.type !== AST_NODE_TYPES44.IfStatement) return false;
   const terminating = first.consequent.type === AST_NODE_TYPES44.ReturnStatement || first.consequent.type === AST_NODE_TYPES44.ThrowStatement || first.consequent.type === AST_NODE_TYPES44.BlockStatement && first.consequent.body.length === 1 && (first.consequent.body[0]?.type === AST_NODE_TYPES44.ReturnStatement || first.consequent.body[0]?.type === AST_NODE_TYPES44.ThrowStatement);
   if (!terminating) return false;
+  if (contains(first.consequent, visitorKeys, (node) => sameAccess(node, access))) return false;
   return contains(first.test, visitorKeys, (node) => isNullGuard(node, access)) && contains(first.test, visitorKeys, (node) => isEmptyGuard(node, access));
 }
 function contains(node, visitorKeys, predicate) {
@@ -8921,7 +9080,7 @@ var isSchemaParseReference = (node) => {
   const inner = unwrap4(node);
   return inner !== null && inner.type === AST_NODE_TYPES45.MemberExpression && !inner.computed && inner.property.type === AST_NODE_TYPES45.Identifier && (inner.property.name === "parse" || inner.property.name === "safeParse");
 };
-var isRawPayloadSource = (node) => {
+var isRawPayloadSource = (node, isKnownLocalText) => {
   let current = unwrap4(node);
   if (current === null) return false;
   if (current.type === AST_NODE_TYPES45.AwaitExpression) {
@@ -8945,20 +9104,26 @@ var isRawPayloadSource = (node) => {
     return !current.arguments.some(isSchemaParseReference) && isRawPayloadSource(callee.object);
   }
   const object = unwrap4(callee.object);
-  return property.name === "parse" && object !== null && object.type === AST_NODE_TYPES45.Identifier && object.name === "JSON" && !isLocalFileRead(current.arguments[0]);
+  return property.name === "parse" && object !== null && object.type === AST_NODE_TYPES45.Identifier && object.name === "JSON" && !isLocalFileRead(current.arguments[0]) && isKnownLocalText?.(current.arguments[0]) !== true;
 };
 var FILE_READ_RE = /^(readFile|readFileSync|readJson|readJsonSync|readJSON)$/;
+var isDirectLocalFileRead = (node) => {
+  let current = unwrap4(node);
+  if (current?.type === AST_NODE_TYPES45.AwaitExpression) {
+    current = unwrap4(current.argument);
+  }
+  if (current?.type !== AST_NODE_TYPES45.CallExpression) return false;
+  const callee = unwrap4(current.callee);
+  const name = callee?.type === AST_NODE_TYPES45.Identifier ? callee.name : callee?.type === AST_NODE_TYPES45.MemberExpression && !callee.computed && callee.property.type === AST_NODE_TYPES45.Identifier ? callee.property.name : null;
+  return name !== null && FILE_READ_RE.test(name);
+};
 var isLocalFileRead = (node) => {
   let found = false;
   const visit = (current) => {
     if (found || current === null || current === void 0) return;
-    if (current.type === AST_NODE_TYPES45.CallExpression) {
-      const callee = unwrap4(current.callee);
-      const name = callee?.type === AST_NODE_TYPES45.Identifier ? callee.name : callee?.type === AST_NODE_TYPES45.MemberExpression && !callee.computed && callee.property.type === AST_NODE_TYPES45.Identifier ? callee.property.name : null;
-      if (name !== null && FILE_READ_RE.test(name)) {
-        found = true;
-        return;
-      }
+    if (isDirectLocalFileRead(current)) {
+      found = true;
+      return;
     }
     for (const key of Object.keys(current)) {
       if (key === "parent") continue;
@@ -9020,6 +9185,87 @@ var isValidationRead = (node) => {
   }
   return callee.type === AST_NODE_TYPES45.Identifier && GUARD_NAME_RE.test(callee.name);
 };
+var PRIMITIVE_TYPEOF_RESULTS = /* @__PURE__ */ new Set([
+  "bigint",
+  "boolean",
+  "number",
+  "string",
+  "symbol",
+  "undefined"
+]);
+var bindingValidationPolarity = (test, bindingName) => {
+  if (test.type === AST_NODE_TYPES45.UnaryExpression && test.operator === "!") {
+    const inner = bindingValidationPolarity(test.argument, bindingName);
+    return inner === "valid-when-true" ? "valid-when-false" : inner === "valid-when-false" ? "valid-when-true" : null;
+  }
+  if (test.type === AST_NODE_TYPES45.BinaryExpression) {
+    const typeofName = (node) => node.type === AST_NODE_TYPES45.UnaryExpression && node.operator === "typeof" && node.argument.type === AST_NODE_TYPES45.Identifier ? node.argument.name : null;
+    const literalType = (node) => node.type === AST_NODE_TYPES45.Literal && typeof node.value === "string" && PRIMITIVE_TYPEOF_RESULTS.has(node.value) ? node.value : null;
+    const matches = typeofName(test.left) === bindingName && literalType(test.right) !== null || typeofName(test.right) === bindingName && literalType(test.left) !== null;
+    if (!matches) 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]?.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 nodeWithin2 = (node, container) => node.range[0] >= container.range[0] && node.range[1] <= container.range[1];
+var isFullyValidatedExtractedBinding = (member, source, context) => {
+  const isValidationReference = (identifier) => {
+    for (let current = identifier.parent; current !== void 0 && current !== null; current = current.parent) {
+      if ((current.type === AST_NODE_TYPES45.BinaryExpression || current.type === AST_NODE_TYPES45.CallExpression || current.type === AST_NODE_TYPES45.UnaryExpression) && bindingValidationPolarity(current, identifier.name) !== null) {
+        return true;
+      }
+      if (current.type !== AST_NODE_TYPES45.UnaryExpression && current.type !== AST_NODE_TYPES45.MemberExpression && current.type !== AST_NODE_TYPES45.CallExpression) {
+        return false;
+      }
+    }
+    return false;
+  };
+  const isGuardedUse = (identifier) => {
+    for (let current = identifier.parent; current !== void 0 && current !== null; current = current.parent) {
+      if (current.type === AST_NODE_TYPES45.ConditionalExpression) {
+        const polarity = bindingValidationPolarity(current.test, identifier.name);
+        if (polarity === "valid-when-true" && nodeWithin2(identifier, current.consequent)) {
+          return true;
+        }
+        if (polarity === "valid-when-false" && nodeWithin2(identifier, current.alternate)) {
+          return true;
+        }
+      }
+      if (current.type === AST_NODE_TYPES45.IfStatement) {
+        const polarity = bindingValidationPolarity(current.test, identifier.name);
+        if (polarity === "valid-when-true" && nodeWithin2(identifier, current.consequent)) {
+          return true;
+        }
+        if (polarity === "valid-when-false" && current.alternate !== null && nodeWithin2(identifier, 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;
+  };
+  const declarator = member.parent;
+  if (declarator.type !== AST_NODE_TYPES45.VariableDeclarator || declarator.init !== member || declarator.id.type !== AST_NODE_TYPES45.Identifier || declarator.parent.type !== AST_NODE_TYPES45.VariableDeclaration || declarator.parent.kind !== "const") {
+    return false;
+  }
+  const extracted = context.sourceCode.getDeclaredVariables(declarator)[0];
+  if (extracted === void 0 || extracted.scope !== source.scope) return false;
+  let hasValueUse = false;
+  for (const reference of extracted.references) {
+    const identifier = reference.identifier;
+    if (identifier.type !== AST_NODE_TYPES45.Identifier) return false;
+    if (nodeWithin2(identifier, declarator)) continue;
+    if (isValidationReference(identifier)) continue;
+    hasValueUse = true;
+    if (!isGuardedUse(identifier)) return false;
+  }
+  return hasValueUse;
+};
 var isGuardTestPosition = (node) => {
   let current = node;
   let parent = current.parent;
@@ -9043,13 +9289,13 @@ var isGuardTestPosition = (node) => {
   }
   return false;
 };
-var isUnvalidatedVariableRef = (node, scope, tracked) => {
+var unvalidatedVariableRef = (node, scope, tracked) => {
   const unwrapped = unwrap4(node);
   if (unwrapped === null || unwrapped.type !== AST_NODE_TYPES45.Identifier) {
-    return false;
+    return null;
   }
   const variable = findVariable2(scope, unwrapped.name);
-  return variable !== null && tracked.has(variable);
+  return variable !== null && tracked.has(variable) ? variable : null;
 };
 var prefer_schema_for_api_payload_default = createRule({
   name: "prefer-schema-for-api-payload",
@@ -9069,6 +9315,56 @@ var prefer_schema_for_api_payload_default = createRule({
       return {};
     }
     const unvalidatedVariables = /* @__PURE__ */ new Set();
+    const aliasGroups = /* @__PURE__ */ new Map();
+    const localFileTextVariables = /* @__PURE__ */ new Set();
+    const localFileTextRef = (node, scope) => {
+      const unwrapped = unwrap4(node);
+      if (unwrapped?.type !== AST_NODE_TYPES45.Identifier) return null;
+      const variable = findVariable2(scope, unwrapped.name);
+      return variable !== null && localFileTextVariables.has(variable) ? variable : null;
+    };
+    const updateLocalFileText = (target, value, scope) => {
+      const source = localFileTextRef(value, scope);
+      if (isDirectLocalFileRead(value) || source !== null && source.scope === target.scope) {
+        localFileTextVariables.add(target);
+      } else {
+        localFileTextVariables.delete(target);
+      }
+    };
+    const clearBinding = (variable) => {
+      unvalidatedVariables.delete(variable);
+      const group = aliasGroups.get(variable);
+      aliasGroups.delete(variable);
+      group?.delete(variable);
+    };
+    const clearAliasGroup = (variable) => {
+      const group = aliasGroups.get(variable);
+      if (group === void 0) {
+        unvalidatedVariables.delete(variable);
+        return;
+      }
+      for (const alias of group) {
+        unvalidatedVariables.delete(alias);
+        aliasGroups.delete(alias);
+      }
+      group.clear();
+    };
+    const trackRawBinding = (variable) => {
+      clearBinding(variable);
+      const group = /* @__PURE__ */ new Set([variable]);
+      unvalidatedVariables.add(variable);
+      aliasGroups.set(variable, group);
+    };
+    const trackAlias = (target, source) => {
+      if (target === source) return;
+      const group = aliasGroups.get(source) ?? /* @__PURE__ */ new Set([source]);
+      if (aliasGroups.get(target) === group) return;
+      clearBinding(target);
+      unvalidatedVariables.add(target);
+      group.add(target);
+      aliasGroups.set(source, group);
+      aliasGroups.set(target, group);
+    };
     const isFullyNarrowedPattern = (declarator) => {
       const declared = context.sourceCode.getDeclaredVariables(declarator);
       return declared.length > 0 && declared.every(
@@ -9077,29 +9373,40 @@ var prefer_schema_for_api_payload_default = createRule({
         )
       );
     };
-    const trackInitializer = (declarator) => {
-      if (!isRawPayloadSource(declarator.init)) return;
+    const trackInitializer = (declarator, scope) => {
       const declaredVars = context.sourceCode.getDeclaredVariables(declarator);
       const variable = declaredVars[0];
-      if (variable !== void 0) {
-        unvalidatedVariables.add(variable);
+      if (variable === void 0) return;
+      const localText = (candidate) => localFileTextRef(candidate, scope) !== null;
+      if (isRawPayloadSource(declarator.init, localText)) {
+        trackRawBinding(variable);
+        return;
       }
+      const source = unvalidatedVariableRef(declarator.init, scope, unvalidatedVariables);
+      if (source !== null) trackAlias(variable, source);
     };
     return {
       VariableDeclarator(node) {
         const scope = context.sourceCode.getScope(node);
         if (node.id.type === AST_NODE_TYPES45.Identifier) {
-          trackInitializer(node);
+          const variable = context.sourceCode.getDeclaredVariables(node)[0];
+          if (variable !== void 0) {
+            updateLocalFileText(variable, node.init, scope);
+          }
+          trackInitializer(node, scope);
           return;
         }
         if (node.id.type === AST_NODE_TYPES45.ObjectPattern || node.id.type === AST_NODE_TYPES45.ArrayPattern) {
-          if (isRawPayloadSource(node.init)) {
+          if (isRawPayloadSource(
+            node.init,
+            (candidate) => localFileTextRef(candidate, scope) !== null
+          )) {
             if (!isFullyNarrowedPattern(node)) {
               context.report({ node: node.id, messageId: "unparsedJsonAccess" });
             }
             return;
           }
-          if (isUnvalidatedVariableRef(node.init, scope, unvalidatedVariables)) {
+          if (unvalidatedVariableRef(node.init, scope, unvalidatedVariables) !== null) {
             context.report({ node: node.id, messageId: "unparsedJsonAccess" });
           }
         }
@@ -9109,22 +9416,29 @@ var prefer_schema_for_api_payload_default = createRule({
         if (node.left.type === AST_NODE_TYPES45.Identifier) {
           const variable = findVariable2(scope, node.left.name);
           if (variable === null) return;
-          if (isRawPayloadSource(node.right)) {
-            unvalidatedVariables.add(variable);
+          const isLocalText = (candidate) => localFileTextRef(candidate, scope) !== null;
+          updateLocalFileText(variable, node.right, scope);
+          if (isRawPayloadSource(node.right, isLocalText)) {
+            trackRawBinding(variable);
           } else {
-            unvalidatedVariables.delete(variable);
+            const source = unvalidatedVariableRef(node.right, scope, unvalidatedVariables);
+            if (source === null) clearBinding(variable);
+            else trackAlias(variable, source);
           }
           return;
         }
         if (node.left.type === AST_NODE_TYPES45.ObjectPattern || node.left.type === AST_NODE_TYPES45.ArrayPattern) {
-          if (isRawPayloadSource(node.right)) {
+          if (isRawPayloadSource(
+            node.right,
+            (candidate) => localFileTextRef(candidate, scope) !== null
+          )) {
             context.report({
               node: node.left,
               messageId: "unparsedJsonAccess"
             });
             return;
           }
-          if (isUnvalidatedVariableRef(node.right, scope, unvalidatedVariables)) {
+          if (unvalidatedVariableRef(node.right, scope, unvalidatedVariables) !== null) {
             context.report({
               node: node.left,
               messageId: "unparsedJsonAccess"
@@ -9145,7 +9459,7 @@ var prefer_schema_for_api_payload_default = createRule({
             continue;
           }
           const variable = findVariable2(scope, unwrapped.name);
-          if (variable !== null) unvalidatedVariables.delete(variable);
+          if (variable !== null) clearAliasGroup(variable);
         }
       },
       MemberExpression(node) {
@@ -9153,7 +9467,10 @@ var prefer_schema_for_api_payload_default = createRule({
         if (isValidationRead(node)) return;
         const scope = context.sourceCode.getScope(node);
         const obj = unwrap4(node.object);
-        if (isRawPayloadSource(obj)) {
+        if (isRawPayloadSource(
+          obj,
+          (candidate) => localFileTextRef(candidate, scope) !== null
+        )) {
           const parent = node.parent;
           if (parent.type === AST_NODE_TYPES45.CallExpression && parent.callee === node && node.property.type === AST_NODE_TYPES45.Identifier && (node.property.name === "parse" || node.property.name === "safeParse" || PROMISE_CHAIN_METHODS.has(node.property.name))) {
             return;
@@ -9161,12 +9478,13 @@ var prefer_schema_for_api_payload_default = createRule({
           context.report({ node, messageId: "unparsedJsonAccess" });
           return;
         }
-        if (obj !== null && obj.type === AST_NODE_TYPES45.Identifier && isUnvalidatedVariableRef(obj, scope, unvalidatedVariables)) {
-          context.report({ node, messageId: "unparsedJsonAccess" });
-          const variable = findVariable2(scope, obj.name);
-          if (variable !== null) {
-            unvalidatedVariables.delete(variable);
+        const variable = obj?.type === AST_NODE_TYPES45.Identifier ? unvalidatedVariableRef(obj, scope, unvalidatedVariables) : null;
+        if (variable !== null) {
+          if (isFullyValidatedExtractedBinding(node, variable, context)) {
+            return;
           }
+          context.report({ node, messageId: "unparsedJsonAccess" });
+          clearAliasGroup(variable);
         }
       }
     };
@@ -10933,8 +11251,8 @@ function initProvablyLacksSignal(init) {
   }
   return true;
 }
-function isStringish(node) {
-  return node.type === AST_NODE_TYPES52.Literal && typeof node.value === "string" || node.type === AST_NODE_TYPES52.TemplateLiteral;
+function isInlineUrl(node, resolvesToGlobal) {
+  return node.type === AST_NODE_TYPES52.Literal && typeof node.value === "string" || node.type === AST_NODE_TYPES52.TemplateLiteral || node.type === AST_NODE_TYPES52.NewExpression && node.callee.type === AST_NODE_TYPES52.Identifier && node.callee.name === "URL" && resolvesToGlobal(node.callee);
 }
 var require_fetch_timeout_default = createRule({
   name: "require-fetch-timeout",
@@ -10986,7 +11304,7 @@ var require_fetch_timeout_default = createRule({
           return;
         }
         const [first, init] = node.arguments;
-        if (node.arguments.length === 1 && first !== void 0 && !isStringish(first)) {
+        if (node.arguments.length === 1 && first !== void 0 && !isInlineUrl(first, resolvesToGlobal)) {
           return;
         }
         if (init === void 0 || initProvablyLacksSignal(init)) {
@@ -11003,7 +11321,7 @@ var CONFIGISH_TYPE_RE = /(?:Options|Opts|Config|Configuration|Settings|Params|Pr
 var CONFIGISH_NAME_RE = /^(?:options|opts|config|configuration|settings|params|props|args|env|environment|callbacks|flags|logger|log|clock)$/i;
 var HTTP_TRANSPORT_TYPE_RE = /^(?:KyInstance|AxiosInstance|Session)$/;
 var BUILTIN_CONTAINER_TYPE_RE = /^(?:Record|Map|WeakMap|Set|WeakSet|Array|ReadonlyArray|ReadonlyMap|ReadonlySet|Promise|Partial|Required|Readonly|Pick|Omit|Exclude|Extract|NonNullable|Awaited|Parameters|ReturnType|InstanceType)$/;
-var VALUE_TYPE_RE = /^(?:ArrayBuffer|Blob|Buffer|Date|RegExp|URL|URLSearchParams)$/;
+var VALUE_TYPE_RE = /^(?:ArrayBuffer|Blob|Buffer|Date|NodePath|RegExp|URL|URLSearchParams)$/;
 var TRANSPORT_WRAPPER_NAME_RE = /(?:Client$|^Http[A-Z])/;
 var ERROR_VALUE_NAME_RE = /Error$/;
 var FLUENT_BUILDER_NAME_RE = /Builder$/;
@@ -11467,7 +11785,7 @@ var require_interface_for_injected_service_default = createRule({
         if (node.abstract === true) return;
         if (node.decorators.length > 0) return;
         const ctor = node.body.body.find(
-          (member) => member.type === AST_NODE_TYPES53.MethodDefinition && member.kind === "constructor"
+          (member) => member.type === AST_NODE_TYPES53.MethodDefinition && member.kind === "constructor" && member.value.body !== null && member.value.body !== void 0
         );
         if (ctor === void 0) return;
         const constructorFacts = readConstructor(
@@ -12346,7 +12664,7 @@ var rules = {
 };
 var meta = {
   name: "@sarj/eslint-plugin",
-  version: "11.0.1"
+  version: "11.2.0"
 };
 var applicationOnlyRules = [
   "no-restricted-library-load",