@sarj/eslint-plugin 2.11.0 → 2.12.1

package/dist/index.js

@@ -1,5 +1,29 @@
 // src/rules/enforce-file-structure.ts
 import { ESLintUtils, AST_NODE_TYPES } from "@typescript-eslint/utils";
+
+// src/rules/_paths.ts
+var SCRIPT_FILE_RE = /([\\/]scripts[\\/])|(\.mjs$)/;
+var STORY_FILE_RE = /\.stories\.[cm]?[jt]sx?$/i;
+var GENERATED_FILE_RE = /([\\/]generated[\\/])|(\.gen\.[cm]?[jt]sx?$)|(\.generated\.[cm]?[jt]sx?$)|(\.d\.[cm]?ts$)/;
+function isTestFile(filename) {
+  const normalized = filename.replaceAll("\\", "/");
+  const base = normalized.slice(normalized.lastIndexOf("/") + 1);
+  if (/\.(test|spec|e2e|integration)\.[cm]?[jt]sx?$/.test(base)) {
+    return true;
+  }
+  return /(^|\/)(tests?|__tests__|__mocks__|fixtures|e2e|integration)\//.test(normalized);
+}
+function isStoryFile(filename) {
+  return STORY_FILE_RE.test(filename);
+}
+function isGeneratedFile(filename, sourceText = "") {
+  return GENERATED_FILE_RE.test(filename.replaceAll("\\", "/")) || /@generated\b/.test(sourceText.slice(0, 1024));
+}
+function isScriptFile(filename) {
+  return SCRIPT_FILE_RE.test(filename);
+}
+
+// src/rules/enforce-file-structure.ts
 var classifyStatement = (statement) => {
   switch (statement.type) {
     case AST_NODE_TYPES.ImportDeclaration:
@@ -36,6 +60,9 @@ var enforce_file_structure_default = ESLintUtils.RuleCreator(
   },
   defaultOptions: [],
   create(context) {
+    if (isTestFile(context.filename)) {
+      return {};
+    }
     return {
       Program(node) {
         const body = node.body;
@@ -49,6 +76,7 @@ var enforce_file_structure_default = ESLintUtils.RuleCreator(
           });
         }
         let seenBody = false;
+        let inMisplacedRun = false;
         for (const statement of body) {
           if (isStringDirective(statement)) continue;
           switch (classifyStatement(statement)) {
@@ -56,9 +84,11 @@ var enforce_file_structure_default = ESLintUtils.RuleCreator(
               continue;
             case "body":
               seenBody = true;
+              inMisplacedRun = false;
               continue;
             case "import":
-              if (seenBody) {
+              if (seenBody && !inMisplacedRun) {
+                inMisplacedRun = true;
                 context.report({
                   node: statement,
                   messageId: "importsFirst"
@@ -217,9 +247,13 @@ var STEP_NARRATION_RE = /^(?:first(?:ly)?|second(?:ly)?|third(?:ly)?|then|next|a
 var META_COMMENTARY_RE = /\b(?:for now|keeping (?:it|this) simple|could be (?:refactored|improved|cleaned up|simplified)|refactor(?:ed|ing)? (?:later|this)|not sure (?:if|whether|why|how)|quick[- ](?:and[- ]dirty|fix)|(?:a |bit of a )?hacky|is a hack|temporary (?:solution|workaround|fix|hack)|revisit (?:this|later|below)|clean (?:this|it) up|not ideal|placeholder for now)\b/i;
 var DIRECTIVE_RE = /^(eslint\b|eslint-|@ts-|prettier-ignore|prettier\b|biome-|c8\b|v8\b|istanbul\b|@type\b|@vite|webpack|<reference|<amd|global\b|noinspection|todo\b|fixme\b|hack\b|xxx\b)/i;
 var LICENSE_RE = /copyright|licen[cs]ed?|spdx|permission is hereby granted|all rights reserved/i;
+var ENUMERATED_ITEM_RE = /^(?:\d+[.):]|[-*•])\s+\S/;
+var ENUMERATED_ITEM_MIN_WORDS = 3;
+var ENUMERATED_PREAMBLE_MIN_ITEMS = 2;
 var BANNER_FULL_RE = /^[\s\-=*#~_+.]{4,}$/;
 var BANNER_RUN_RE = /={4,}|-{4,}|#{4,}|\*{4,}|~{4,}/;
 var REGION_RE = /^#?(?:end)?region\b/i;
+var DIAGRAM_ARROW_RE = /[-=~]{2,}>|<[-=~]{2,}/;
 var CODE_KEYWORD_RE = /^(import |export |const |let |var |function\b|class |interface |type \w|enum |return\b|throw |await |async |if\s*\(|for\s*\(|while\s*\(|switch\s*\(|new |console\.)/;
 var CODE_TAIL_RE = /[;{}()]\s*$|=>\s*$|,\s*$/;
 var CALL_OR_ASSIGN_RE = /^[A-Za-z_$][\w.$[\]]*\s*(?:=(?![=>])|\+=|-=|\*=)\s*\S.*[;)}\]]\s*$|^[A-Za-z_$][\w.$]*\([^)]*\)\s*;?\s*$/;
@@ -233,7 +267,8 @@ function isDirective(text) {
 function isBanner(text) {
   const t = text.trim();
   if (!t) return false;
-  return BANNER_FULL_RE.test(t) || BANNER_RUN_RE.test(t) || REGION_RE.test(t);
+  if (BANNER_FULL_RE.test(t) || REGION_RE.test(t)) return true;
+  return BANNER_RUN_RE.test(t) && !DIAGRAM_ARROW_RE.test(t);
 }
 function looksLikeCode(text) {
   const t = text.trim();
@@ -244,6 +279,10 @@ function looksLikeCode(text) {
 function hasPseudocode(text) {
   return PSEUDOCODE_RE.test(text);
 }
+function isEnumeratedProseItem(text) {
+  const t = text.trim();
+  return ENUMERATED_ITEM_RE.test(t) && t.split(/\s+/).length >= ENUMERATED_ITEM_MIN_WORDS;
+}
 function isProse(text) {
   const t = text.trim();
   if (!t) return false;
@@ -356,13 +395,32 @@ function restatesNextLine(body, statement) {
   const code = codeTokens(head);
   return content.every((word) => code.has(word));
 }
-function isRedundantNarration(body, statementBelow) {
+var JUSTIFICATION_RE = /\b(?:because|since|until|due to|so that|otherwise|which is why|in order to|to avoid|to work around|to prevent)\b/i;
+function isRedundantNarration(body, statementBelow, standalone) {
   const t = body.trim();
   if (!t || looksLikeCode(t) || hasPseudocode(t)) return false;
-  if (STEP_NARRATION_RE.test(t)) return true;
-  if (META_COMMENTARY_RE.test(t)) return true;
+  if (standalone) {
+    if (STEP_NARRATION_RE.test(t)) return true;
+    if (META_COMMENTARY_RE.test(t) && !JUSTIFICATION_RE.test(t)) return true;
+  }
   return restatesNextLine(t, statementBelow);
 }
+function areAdjacentLineComments(a, b) {
+  return a !== void 0 && b !== void 0 && a.type === "Line" && b.type === "Line" && b.loc.start.line === a.loc.end.line + 1;
+}
+function isInsideCommentRun(comments, index) {
+  const comment = comments[index];
+  return areAdjacentLineComments(comments[index - 1], comment) || areAdjacentLineComments(comment, comments[index + 1]);
+}
+var LEAD_IN_SCAN_LIMIT = 24;
+function hasIllustrationLeadInAbove(comments, index) {
+  for (let i = index - 1; i >= 0 && index - i <= LEAD_IN_SCAN_LIMIT; i--) {
+    if (!areAdjacentLineComments(comments[i], comments[i + 1])) return false;
+    const body = stripCommentMarker(comments[i]?.value ?? "");
+    if (body.length > 0 && body.endsWith(":")) return true;
+  }
+  return false;
+}
 function hasCommentedOutCode(texts, precedingProse) {
   for (let i = 0; i < texts.length; i++) {
     const line = texts[i];
@@ -422,6 +480,9 @@ var no_comment_cruft_default = ESLintUtils3.RuleCreator(
       const bodies = leading.map((c) => stripCommentMarker(c.value));
       if (bodies.some((body) => LICENSE_RE.test(body))) return;
       if (bodies.some((body) => isProse(body))) return;
+      if (bodies.filter(isEnumeratedProseItem).length >= ENUMERATED_PREAMBLE_MIN_ITEMS) {
+        return;
+      }
       context.report({ node: first, messageId: "fileHeaderPreamble" });
     }
     return {
@@ -440,14 +501,15 @@ var no_comment_cruft_default = ESLintUtils3.RuleCreator(
           }
           const prev = comments[i - 1];
           const precedingProse = prev !== void 0 && prev.type === "Line" && prev.loc.end.line === comment.loc.start.line - 1 && isProse(stripCommentMarker(prev.value));
-          if (hasCommentedOutCode(texts, precedingProse)) {
+          if (hasCommentedOutCode(texts, precedingProse) && !hasIllustrationLeadInAbove(comments, i)) {
             context.report({ node: comment, messageId: "commentedOutCode" });
             continue;
           }
           if (comment.type === "Line" && texts.length === 1) {
             const body = texts[0];
             const statement = restatableStatementBelow(comment, sourceCode);
-            if (body !== void 0 && isRedundantNarration(body, statement)) {
+            const standalone = !isInsideCommentRun(comments, i);
+            if (body !== void 0 && isRedundantNarration(body, statement, standalone)) {
               context.report({ node: comment, messageId: "redundantNarration" });
             }
           }
@@ -686,6 +748,9 @@ var no_insecure_random_id_default = ESLintUtils5.RuleCreator(
   },
   defaultOptions: [],
   create(context) {
+    if (isTestFile(context.filename)) {
+      return {};
+    }
     return {
       CallExpression(node) {
         if (!isMathRandomCall(node)) {
@@ -715,6 +780,22 @@ import { ESLintUtils as ESLintUtils6 } from "@typescript-eslint/utils";
 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",
+  "status",
+  "statuscode",
+  "statustext",
+  "code",
+  "issues",
+  "details",
+  "body",
+  "payload",
+  "response",
+  "info",
+  "meta",
+  "metadata",
+  "context"
+]);
 function isCatchBinding(scope, name) {
   let current = scope;
   while (current) {
@@ -738,7 +819,11 @@ function memberSuggestsError(member, scope) {
   const base = member.object;
   const baseSuggestsError = base.type === "Identifier" && (ERROR_NAME_PATTERN.test(base.name) || isCatchBinding(scope, base.name));
   if (baseSuggestsError) {
-    return propName2 === null || !SAFE_STRING_PROPS.has(propName2.toLowerCase());
+    if (propName2 === null) {
+      return true;
+    }
+    const lowered = propName2.toLowerCase();
+    return !SAFE_STRING_PROPS.has(lowered) && !PAYLOAD_PROPS.has(lowered);
   }
   return false;
 }
@@ -1025,13 +1110,17 @@ var no_log_only_catch_default = ESLintUtils7.RuleCreator(
     return {
       CatchClause(node) {
         const statements = node.body.body;
+        const isDocumented = context.sourceCode.getCommentsInside(node.body).length > 0;
         if (statements.length === 0) {
-          if (context.sourceCode.getCommentsInside(node.body).length > 0) {
+          if (isDocumented) {
             return;
           }
           context.report({ node, messageId: "emptyCatch" });
           return;
         }
+        if (isDocumented) {
+          return;
+        }
         const everyStatementIsLogging = statements.every(
           (statement) => isLoggingCallStatement(statement)
         );
@@ -1045,6 +1134,11 @@ var no_log_only_catch_default = ESLintUtils7.RuleCreator(
 
 // src/rules/no-raw-env.ts
 import { ESLintUtils as ESLintUtils8 } from "@typescript-eslint/utils";
+var CONFIG_FILE_RE = /(^|[\\/])[\w.-]+\.config\.[cm]?[jt]sx?$/;
+var ENV_BOUNDARY_FILE_RE = /(^|[\\/])(?:env|client-env|server-env|client-settings|server-settings)\.[cm]?[jt]sx?$/;
+function isValidatedEnvBoundary(filename, sourceText) {
+  return ENV_BOUNDARY_FILE_RE.test(filename.replaceAll("\\", "/")) && /\bz\.object\s*\(/.test(sourceText) && /\.parse\s*\(/.test(sourceText);
+}
 function isProcessEnv(node) {
   return !node.computed && node.object.type === "Identifier" && node.object.name === "process" && node.property.type === "Identifier" && node.property.name === "env";
 }
@@ -1062,6 +1156,21 @@ function isBuildTimeConstantAccess(node) {
   const parent = node.parent;
   return parent.type === "MemberExpression" && parent.object === node && !parent.computed && parent.property.type === "Identifier" && BUILD_TIME_CONSTANTS.has(parent.property.name);
 }
+function isWriteTarget(node) {
+  const access = node.parent.type === "MemberExpression" && node.parent.object === node ? node.parent : node;
+  const parent = access.parent;
+  if (parent.type === "AssignmentExpression") {
+    return parent.left === access;
+  }
+  if (parent.type === "UnaryExpression") {
+    return parent.operator === "delete";
+  }
+  return false;
+}
+function isWholeEnvSpread(node) {
+  const parent = node.parent;
+  return parent.type === "SpreadElement" && parent.argument === node;
+}
 var no_raw_env_default = ESLintUtils8.RuleCreator(
   (name) => `https://github.com/sarj-ai/linting/blob/main/packages/typescript/src/rules/${name}.ts`
 )({
@@ -1078,9 +1187,13 @@ var no_raw_env_default = ESLintUtils8.RuleCreator(
   },
   defaultOptions: [],
   create(context) {
+    const filename = context.filename;
+    if (isTestFile(filename) || isScriptFile(filename) || CONFIG_FILE_RE.test(filename.replaceAll("\\", "/")) || isValidatedEnvBoundary(filename, context.sourceCode.text)) {
+      return {};
+    }
     return {
       MemberExpression(node) {
-        if ((isProcessEnv(node) || isImportMetaEnv(node)) && !isBuildTimeConstantAccess(node)) {
+        if ((isProcessEnv(node) || isImportMetaEnv(node)) && !isBuildTimeConstantAccess(node) && !isWriteTarget(node) && !isWholeEnvSpread(node)) {
           context.report({
             node,
             messageId: "noRawEnv"
@@ -1293,6 +1406,32 @@ function enclosingReturnTypeNode(node) {
   }
   return null;
 }
+var PREDICATE_NAME_RE = /^(is|has|can|should|must|does|did|was|were|are)[A-Z]/;
+var PREDICATE_SUFFIX_RE = /(Exists?|Available|Enabled|Disabled)$/;
+function enclosingFunctionName(node) {
+  let current = node.parent;
+  while (current !== void 0 && current !== null) {
+    if (isFunctionNode(current)) {
+      if ("id" in current && isNode(current.id) && current.id.type === AST_NODE_TYPES4.Identifier) {
+        return current.id.name;
+      }
+      const parent = current.parent;
+      if (parent?.type === AST_NODE_TYPES4.VariableDeclarator && parent.id.type === AST_NODE_TYPES4.Identifier) {
+        return parent.id.name;
+      }
+      return null;
+    }
+    current = current.parent;
+  }
+  return null;
+}
+function isNamedBooleanPredicate(catchNode, kind) {
+  if (kind !== "boolean") {
+    return false;
+  }
+  const name = enclosingFunctionName(catchNode);
+  return name !== null && (PREDICATE_NAME_RE.test(name) || PREDICATE_SUFFIX_RE.test(name));
+}
 function isDeclaredBooleanPredicate(catchNode, kind) {
   if (kind !== "boolean") {
     return false;
@@ -1336,9 +1475,32 @@ function functionReturnsSameSentinelKindElsewhere(catchNode, kind) {
     if (isWithin(current, catchNode.body)) {
       return false;
     }
-    return sentinelKind(current.argument) === kind;
+    return returnedSentinelKinds(current.argument).has(kind);
   });
 }
+function returnedSentinelKinds(arg) {
+  const kinds = /* @__PURE__ */ new Set();
+  if (arg === null) {
+    return kinds;
+  }
+  const direct = sentinelKind(arg);
+  if (direct !== null) {
+    kinds.add(direct);
+    return kinds;
+  }
+  if (arg.type === AST_NODE_TYPES4.ConditionalExpression) {
+    for (const branch of [arg.consequent, arg.alternate]) {
+      for (const nested of returnedSentinelKinds(branch)) {
+        kinds.add(nested);
+      }
+    }
+  } else if (arg.type === AST_NODE_TYPES4.LogicalExpression && (arg.operator === "??" || arg.operator === "||")) {
+    for (const nested of returnedSentinelKinds(arg.right)) {
+      kinds.add(nested);
+    }
+  }
+  return kinds;
+}
 function isWithin(node, ancestor) {
   let current = node;
   while (current !== void 0 && current !== null) {
@@ -1408,6 +1570,9 @@ var no_sentinel_return_on_catch_default = ESLintUtils9.RuleCreator(
           return;
         }
         const kind = sentinelKind(last.argument);
+        if (kind !== null && isNamedBooleanPredicate(node, kind)) {
+          return;
+        }
         if (kind !== null && isDeclaredBooleanPredicate(node, kind)) {
           return;
         }
@@ -1426,7 +1591,8 @@ var no_sentinel_return_on_catch_default = ESLintUtils9.RuleCreator(
 // src/rules/no-sequential-await.ts
 import { ESLintUtils as ESLintUtils10 } from "@typescript-eslint/utils";
 var ARRAY_ITERATION_METHODS = /* @__PURE__ */ new Set(["forEach", "map", "filter"]);
-var SEQUENTIAL_ITERABLE_HINT = /sort|reverse|ordered|sequence|hook|middleware|pipeline|\bstage|\bstep|\bphase|migration|chain|buffer|stream|teleport|chunk|\bqueue|drain/i;
+var SEQUENTIAL_ITERABLE_HINT = /sort|reverse|ordered|sequence|hook|middleware|pipeline|preset|plugin|extension|\bstage|\bstep|\bphase|migration|chain|buffer|stream|teleport|chunk|\bqueue|drain/i;
+var BENCH_FILE_RE = /(^|[\\/])bench(marks?)?[\\/]|\.bench\.[cm]?[jt]sx?$/i;
 function isFunctionLike(node) {
   return node.type === "FunctionDeclaration" || node.type === "FunctionExpression" || node.type === "ArrowFunctionExpression";
 }
@@ -1460,6 +1626,7 @@ function collectAwaits(root) {
   });
   return awaits;
 }
+var ASSERTION_CALLEE_RE = /^(expect|assert|should|invariant)$/;
 function hasEarlyExit(root) {
   let found = false;
   visitScope(root, (node) => {
@@ -1483,6 +1650,9 @@ function isTimerYield(node) {
     return true;
   }
   if (arg.type === "CallExpression") {
+    if (arg.callee.type === "MemberExpression" && !arg.callee.computed && arg.callee.object.type === "Identifier" && arg.callee.object.name === "Promise" && arg.callee.property.type === "Identifier" && (arg.callee.property.name === "resolve" || arg.callee.property.name === "reject")) {
+      return true;
+    }
     const name = calleeName2(arg.callee);
     return name !== null && TIMER_HELPER_RE.test(name);
   }
@@ -1493,6 +1663,25 @@ function isQueueDrain(node) {
   const arg = node.argument;
   return arg.type === "CallExpression" && arg.callee.type === "MemberExpression" && !arg.callee.computed && arg.callee.property.type === "Identifier" && QUEUE_DRAIN_METHODS.test(arg.callee.property.name);
 }
+function hasAssertion(root) {
+  let found = false;
+  visitScope(root, (node) => {
+    if (node.type !== "CallExpression") {
+      return;
+    }
+    let callee = node.callee;
+    while (callee.type === "MemberExpression") {
+      callee = callee.object;
+    }
+    if (callee.type === "CallExpression") {
+      callee = callee.callee;
+    }
+    if (callee.type === "Identifier" && ASSERTION_CALLEE_RE.test(callee.name)) {
+      found = true;
+    }
+  });
+  return found;
+}
 function referencesName(root, name) {
   let found = false;
   visitScope(root, (node) => {
@@ -1537,13 +1726,16 @@ function testStateIsAssignedInBody(test, body) {
   });
   return found;
 }
-function shouldReport(awaits, earlyExit, iterableText) {
+function shouldReport(awaits, earlyExit, iterableText, asserts = false) {
   if (awaits.length === 0) {
     return false;
   }
   if (earlyExit) {
     return false;
   }
+  if (asserts) {
+    return false;
+  }
   if (iterableText !== null && SEQUENTIAL_ITERABLE_HINT.test(iterableText)) {
     return false;
   }
@@ -1567,6 +1759,9 @@ var no_sequential_await_default = ESLintUtils10.RuleCreator(
   },
   defaultOptions: [],
   create(context) {
+    if (isTestFile(context.filename) || BENCH_FILE_RE.test(context.filename)) {
+      return {};
+    }
     function loopParts(node) {
       if (node.type === "ForStatement") {
         return [node.body, node.test, node.update];
@@ -1588,6 +1783,7 @@ var no_sequential_await_default = ESLintUtils10.RuleCreator(
       }
       const awaits = [];
       let earlyExit = false;
+      let asserts = false;
       for (const part of loopParts(node)) {
         if (part === null || isLoop(part)) {
           continue;
@@ -1596,8 +1792,11 @@ var no_sequential_await_default = ESLintUtils10.RuleCreator(
         if (!earlyExit && hasEarlyExit(part)) {
           earlyExit = true;
         }
+        if (!asserts && hasAssertion(part)) {
+          asserts = true;
+        }
       }
-      if (shouldReport(awaits, earlyExit, iterableTextOf(node))) {
+      if (shouldReport(awaits, earlyExit, iterableTextOf(node), asserts)) {
         context.report({ node, messageId: "noSequentialAwait" });
       }
     }
@@ -1630,7 +1829,7 @@ var no_sequential_await_default = ESLintUtils10.RuleCreator(
         const awaits = collectAwaits(callback.body);
         const earlyExit = hasEarlyExit(callback.body);
         const iterableText = context.sourceCode.getText(callee.object);
-        if (shouldReport(awaits, earlyExit, iterableText)) {
+        if (shouldReport(awaits, earlyExit, iterableText, hasAssertion(callback.body))) {
           context.report({ node, messageId: "noSequentialAwait" });
         }
       }
@@ -1699,20 +1898,30 @@ function isConcatOntoTarget(rhs, target) {
   }
   return isConcatOperand(rhs.left, target) || isConcatOperand(rhs.right, target);
 }
-function isInsideLoopBody(node) {
+function isDeclaredInsideLoop(variable, loop) {
+  const def = variable.defs[0];
+  if (def === void 0) {
+    return false;
+  }
+  const body = loop.body;
+  const [declStart, declEnd] = def.node.range;
+  const [bodyStart, bodyEnd] = body.range;
+  return declStart >= bodyStart && declEnd <= bodyEnd;
+}
+function enclosingLoop(node) {
   let child = node;
   let parent = node.parent;
   while (parent !== void 0 && parent !== null) {
     if (LOOP_NODE_TYPES.has(parent.type)) {
       const loop = parent;
       if (loop.body === child) {
-        return true;
+        return loop;
       }
     }
     child = parent;
     parent = parent.parent;
   }
-  return false;
+  return null;
 }
 var no_string_concat_in_loop_default = ESLintUtils11.RuleCreator(
   (name) => `https://github.com/sarj-ai/linting/blob/main/packages/typescript/src/rules/${name}.ts`
@@ -1730,6 +1939,7 @@ var no_string_concat_in_loop_default = ESLintUtils11.RuleCreator(
   },
   defaultOptions: [],
   create(context) {
+    const reported = /* @__PURE__ */ new WeakMap();
     return {
       AssignmentExpression(node) {
         if (node.left.type !== "Identifier") {
@@ -1739,7 +1949,8 @@ var no_string_concat_in_loop_default = ESLintUtils11.RuleCreator(
         if (!isAccumulation) {
           return;
         }
-        if (!isInsideLoopBody(node)) {
+        const loop = enclosingLoop(node);
+        if (loop === null) {
           return;
         }
         const scope = context.sourceCode.getScope(node);
@@ -1750,6 +1961,18 @@ var no_string_concat_in_loop_default = ESLintUtils11.RuleCreator(
         if (!isStringInitializedVariable(variable)) {
           return;
         }
+        if (isDeclaredInsideLoop(variable, loop)) {
+          return;
+        }
+        let seen = reported.get(loop);
+        if (seen === void 0) {
+          seen = /* @__PURE__ */ new Set();
+          reported.set(loop, seen);
+        }
+        if (seen.has(node.left.name)) {
+          return;
+        }
+        seen.add(node.left.name);
         context.report({
           node,
           messageId: "noStringConcatInLoop"
@@ -1784,7 +2007,31 @@ var BROWSER_GLOBALS = /* @__PURE__ */ new Set([
   "KeyboardEvent",
   "TouchEvent"
 ]);
+var CLIENT_REQUIRED_MODULES = /* @__PURE__ */ new Set(["next/dynamic"]);
 var CLIENT_ONLY_PACKAGES_REGEX = /^(?:@radix-ui\/|framer-motion|react-dom|react-day-picker|@floating-ui\/|react-select|react-toastify|react-hook-form|recharts|react-dropzone|react-slick|react-swipeable|react-resizable|react-draggable|react-beautiful-dnd|@hello-pangea\/dnd|react-virtualized|react-window|@tanstack\/react-table|@tanstack\/react-query|react-redux|recoil|jotai|zustand|@tippyjs\/react|react-color|react-datepicker|next-themes|react-helmet|react-helmet-async|styled-components|@emotion\/)/;
+var isBareSpecifier = (source) => !source.startsWith(".") && !source.startsWith("/") && !source.startsWith("@/") && !source.startsWith("~");
+var jsxRootName = (name) => {
+  let current = name;
+  while (current.type === AST_NODE_TYPES5.JSXMemberExpression) {
+    current = current.object;
+  }
+  return current.type === AST_NODE_TYPES5.JSXIdentifier ? current.name : "";
+};
+var subtreeReadsImportedBinding = (node, imported) => {
+  if (node.type === AST_NODE_TYPES5.Identifier) {
+    return imported.has(node.name);
+  }
+  for (const key of Object.keys(node)) {
+    if (key === "parent") continue;
+    const value = node[key];
+    for (const child of Array.isArray(value) ? value : [value]) {
+      if (child !== null && typeof child === "object" && typeof child.type === "string" && subtreeReadsImportedBinding(child, imported)) {
+        return true;
+      }
+    }
+  }
+  return false;
+};
 var isUseClientDirective = (node) => {
   return node.type === AST_NODE_TYPES5.ExpressionStatement && node.expression.type === AST_NODE_TYPES5.Literal && node.expression.value === "use client";
 };
@@ -1834,6 +2081,8 @@ var no_unnecessary_use_client_default = ESLintUtils12.RuleCreator(
     }
     let directiveNode = null;
     let hasClientIndicator = false;
+    const importedLocals = /* @__PURE__ */ new Set();
+    const externalLocals = /* @__PURE__ */ new Set();
     const markIfHookOrContext = (callee) => {
       if (callee.type === AST_NODE_TYPES5.Identifier) {
         if (HOOK_REGEX.test(callee.name) || callee.name === "createContext") {
@@ -1870,7 +2119,21 @@ var no_unnecessary_use_client_default = ESLintUtils12.RuleCreator(
       },
       ImportDeclaration(node) {
         if (directiveNode === null) return;
-        if (typeof node.source.value === "string" && CLIENT_ONLY_PACKAGES_REGEX.test(node.source.value)) {
+        if (typeof node.source.value !== "string") return;
+        const source = node.source.value;
+        if (CLIENT_ONLY_PACKAGES_REGEX.test(source) || CLIENT_REQUIRED_MODULES.has(source)) {
+          hasClientIndicator = true;
+        }
+        for (const specifier of node.specifiers) {
+          importedLocals.add(specifier.local.name);
+          if (isBareSpecifier(source)) {
+            externalLocals.add(specifier.local.name);
+          }
+        }
+      },
+      JSXOpeningElement(node) {
+        if (directiveNode === null) return;
+        if (externalLocals.has(jsxRootName(node.name))) {
           hasClientIndicator = true;
         }
       },
@@ -1878,6 +2141,10 @@ var no_unnecessary_use_client_default = ESLintUtils12.RuleCreator(
         if (directiveNode === null) return;
         if (node.source !== null) {
           hasClientIndicator = true;
+          return;
+        }
+        if (node.declaration !== null && subtreeReadsImportedBinding(node.declaration, importedLocals)) {
+          hasClientIndicator = true;
         }
       },
       ExportAllDeclaration(node) {
@@ -1942,19 +2209,23 @@ function isBooleanTyped(member) {
 function looksLikeMutuallyExclusiveState(typeLiteral) {
   let hasStatusBoolean = false;
   let optionalCount = 0;
+  let optionalPayloadCount = 0;
   for (const member of typeLiteral.members) {
     if (member.type !== AST_NODE_TYPES6.TSPropertySignature) {
       continue;
     }
     if (member.optional) {
       optionalCount += 1;
+      if (!isBooleanTyped(member)) {
+        optionalPayloadCount += 1;
+      }
     }
     const name = getMemberName(member);
     if (name !== null && STATUS_MEMBER_NAMES.has(name) && isBooleanTyped(member)) {
       hasStatusBoolean = true;
     }
   }
-  return hasStatusBoolean && optionalCount >= MIN_OPTIONAL_MEMBERS;
+  return hasStatusBoolean && optionalCount >= MIN_OPTIONAL_MEMBERS && optionalPayloadCount >= 1;
 }
 var prefer_discriminated_union_default = ESLintUtils13.RuleCreator(
   (name) => `https://github.com/sarj-ai/linting/blob/main/packages/typescript/src/rules/${name}.ts`
@@ -2035,7 +2306,51 @@ var isRawPayloadSource = (node) => {
     return true;
   }
   const object = unwrap(callee.object);
-  return property.name === "parse" && object !== null && object.type === AST_NODE_TYPES7.Identifier && object.name === "JSON";
+  return property.name === "parse" && object !== null && object.type === AST_NODE_TYPES7.Identifier && object.name === "JSON" && // ...but not `JSON.parse(readFileSync(p, "utf8"))` — see isLocalFileRead.
+  !isLocalFileRead(current.arguments[0]);
+};
+var FILE_READ_RE = /^(readFile|readFileSync|readJson|readJsonSync|readJSON)$/;
+var isLocalFileRead = (node) => {
+  let found = false;
+  const visit = (current) => {
+    if (found || current === null || current === void 0) return;
+    if (current.type === AST_NODE_TYPES7.CallExpression) {
+      const callee = unwrap(current.callee);
+      const name = callee?.type === AST_NODE_TYPES7.Identifier ? callee.name : callee?.type === AST_NODE_TYPES7.MemberExpression && !callee.computed && callee.property.type === AST_NODE_TYPES7.Identifier ? callee.property.name : null;
+      if (name !== null && FILE_READ_RE.test(name)) {
+        found = true;
+        return;
+      }
+    }
+    for (const key of Object.keys(current)) {
+      if (key === "parent") continue;
+      const value = current[key];
+      for (const child of Array.isArray(value) ? value : [value]) {
+        if (child !== null && typeof child === "object" && typeof child.type === "string") {
+          visit(child);
+        }
+      }
+    }
+  };
+  visit(node);
+  return found;
+};
+var ASSERTION_CALLEE_RE2 = /^(expect|assert|should|invariant)$/;
+var isInsideAssertion = (node) => {
+  for (let current = node.parent; current !== void 0 && current !== null; current = current.parent) {
+    if (current.type !== AST_NODE_TYPES7.CallExpression) continue;
+    let callee = current.callee;
+    while (callee.type === AST_NODE_TYPES7.MemberExpression) {
+      callee = callee.object;
+    }
+    if (callee.type === AST_NODE_TYPES7.CallExpression) {
+      callee = callee.callee;
+    }
+    if (callee.type === AST_NODE_TYPES7.Identifier && ASSERTION_CALLEE_RE2.test(callee.name)) {
+      return true;
+    }
+  }
+  return false;
 };
 var findVariable2 = (scope, name) => {
   let current = scope;
@@ -2094,6 +2409,9 @@ var prefer_schema_for_api_payload_default = ESLintUtils14.RuleCreator(
   },
   defaultOptions: [],
   create(context) {
+    if (isTestFile(context.filename)) {
+      return {};
+    }
     const unvalidatedVariables = /* @__PURE__ */ new Set();
     const trackInitializer = (declarator) => {
       if (!isRawPayloadSource(declarator.init)) return;
@@ -2165,6 +2483,7 @@ var prefer_schema_for_api_payload_default = ESLintUtils14.RuleCreator(
         }
       },
       MemberExpression(node) {
+        if (isInsideAssertion(node)) return;
         const scope = context.sourceCode.getScope(node);
         const obj = unwrap(node.object);
         if (isRawPayloadSource(obj)) {
@@ -2189,6 +2508,8 @@ var prefer_schema_for_api_payload_default = ESLintUtils14.RuleCreator(
 
 // src/rules/prefer-semantic-colors.ts
 import { AST_NODE_TYPES as AST_NODE_TYPES8, ESLintUtils as ESLintUtils15 } from "@typescript-eslint/utils";
+import { existsSync, readFileSync } from "fs";
+import { dirname, join, parse } from "path";
 
 // src/rules/_tailwind.ts
 var tailwindBase = (token) => token.replace(/^(?:[a-z0-9-]+:)+/i, "").replace(/^!/, "");
@@ -2226,6 +2547,20 @@ var STYLE_COLOR_PROPS = /* @__PURE__ */ new Set([
 ]);
 var RAW_COLOR_VALUE_RE = new RegExp(`#[0-9a-fA-F]{3,8}\\b|\\b(?:${COLOR_FN})\\s*\\(`, "i");
 var STORIES_FILE_RE = /\.stories\.[cm]?[jt]sx?$/i;
+var SEMANTIC_TOKEN_RE = /--(?:background|foreground|primary|secondary|muted|accent|destructive|border|card|popover)\b|(?:bg|text|border)-(?:background|foreground|primary|secondary|muted|accent|destructive|border|card|popover)\b/;
+var DETECTION_FILES = [
+  "components.json",
+  "tailwind.config.js",
+  "tailwind.config.cjs",
+  "tailwind.config.mjs",
+  "tailwind.config.ts",
+  "app/globals.css",
+  "src/app/globals.css",
+  "src/index.css",
+  "src/styles/globals.css",
+  "styles/globals.css"
+];
+var semanticTokenCache = /* @__PURE__ */ new Map();
 var SVG_DEFS_CONTAINERS = /* @__PURE__ */ new Set([
   "mask",
   "clipPath",
@@ -2254,6 +2589,34 @@ var isInsideSvg = (node) => {
   }
   return false;
 };
+var hasSemanticTokenSystem = (filename) => {
+  let dir = dirname(filename);
+  const root = parse(dir).root;
+  for (let depth = 0; depth < 8; depth += 1) {
+    const cached = semanticTokenCache.get(dir);
+    if (cached !== void 0) return cached;
+    let found = false;
+    for (const rel of DETECTION_FILES) {
+      const candidate = join(dir, rel);
+      if (!existsSync(candidate)) continue;
+      if (rel === "components.json") {
+        found = true;
+        break;
+      }
+      try {
+        if (SEMANTIC_TOKEN_RE.test(readFileSync(candidate, "utf8"))) {
+          found = true;
+          break;
+        }
+      } catch {
+      }
+    }
+    semanticTokenCache.set(dir, found);
+    if (found || dir === root) return found;
+    dir = dirname(dir);
+  }
+  return false;
+};
 var propName = (key) => {
   if (key.type === AST_NODE_TYPES8.Identifier) return key.name;
   if (key.type === AST_NODE_TYPES8.Literal && typeof key.value === "string") return key.value;
@@ -2268,16 +2631,27 @@ var prefer_semantic_colors_default = ESLintUtils15.RuleCreator(
     docs: {
       description: "Enforce design-system semantic color tokens (bg-primary, text-destructive, \u2026) over raw Tailwind palette classes (text-red-500), arbitrary color values (bg-[#fff]), and inline color literals."
     },
-    schema: [],
+    schema: [
+      {
+        type: "object",
+        additionalProperties: false,
+        properties: {
+          requireSemanticTokens: { type: "boolean" }
+        }
+      }
+    ],
     messages: {
       rawPalette: "Raw palette class '{{class}}' \u2014 use a semantic token (e.g. text-foreground, bg-primary, text-destructive, bg-muted).",
       arbitraryColor: "Hardcoded color '{{class}}' \u2014 use a semantic token, or var(--\u2026). For charts/brand add an eslint-disable with a reason.",
       inlineColor: "Hardcoded color '{{value}}' \u2014 use a semantic token / CSS variable. For charts/standalone pages add an eslint-disable with a reason."
     }
   },
-  defaultOptions: [],
-  create(context) {
+  defaultOptions: [{}],
+  create(context, [options]) {
     if (STORIES_FILE_RE.test(context.filename)) return {};
+    if (options?.requireSemanticTokens === true && !hasSemanticTokenSystem(context.filename)) {
+      return {};
+    }
     const reportClasses = (value, node) => {
       for (const token of classTokens(value)) {
         const base = tailwindBase(token);
@@ -2373,7 +2747,8 @@ var prefer_semantic_colors_default = ESLintUtils15.RuleCreator(
 import { ESLintUtils as ESLintUtils16 } from "@typescript-eslint/utils";
 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?$|\/tests?\/|\/__tests__\/|\/scripts?\/|\/app\/api\/.*\/route\.[jt]sx?$|\/pages\/api\/)/;
+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_RE = /^(?:@angular\/|@nestjs\/|vue$|vue\/|svelte$|svelte\/|solid-js$|solid-js\/|@ember\/|rxjs$|rxjs\/)/;
 function getScope(context, node) {
   return context.sourceCode.getScope(node);
 }
@@ -2469,8 +2844,15 @@ var prefer_server_actions_default = ESLintUtils16.RuleCreator(
     if (SKIP_FILE_REGEX.test(filename)) {
       return {};
     }
+    let isNonReactFramework = false;
     return {
+      ImportDeclaration(node) {
+        if (typeof node.source.value === "string" && NON_REACT_FRAMEWORK_RE.test(node.source.value)) {
+          isNonReactFramework = true;
+        }
+      },
       CallExpression(node) {
+        if (isNonReactFramework) return;
         let isMutation = false;
         if (node.callee.type === "Identifier" && node.callee.name === "fetch") {
           const urlArg = node.arguments[0];
@@ -2531,7 +2913,7 @@ var INPUT_TYPE_REPLACEMENTS = {
   radio: "RadioGroup",
   range: "Slider"
 };
-var SKIPPED_INPUT_TYPES = /* @__PURE__ */ new Set(["hidden"]);
+var SKIPPED_INPUT_TYPES = /* @__PURE__ */ new Set(["file", "hidden"]);
 var kebabCase = (component) => component.replace(/([a-z0-9])([A-Z])/g, "$1-$2").toLowerCase();
 var literalTypeAttr = (node) => {
   for (const attribute of node.attributes) {
@@ -2545,8 +2927,12 @@ var literalTypeAttr = (node) => {
   }
   return null;
 };
+var hasFileAcceptAttr = (node) => node.attributes.some(
+  (attribute) => attribute.type === AST_NODE_TYPES9.JSXAttribute && attribute.name.type === AST_NODE_TYPES9.JSXIdentifier && attribute.name.name === "accept"
+);
 var resolveInputReplacement = (node) => {
   const typeAttr = literalTypeAttr(node);
+  if (hasFileAcceptAttr(node)) return null;
   if (typeAttr === null || typeAttr.kind === "dynamic") return "Input";
   if (SKIPPED_INPUT_TYPES.has(typeAttr.value)) return null;
   return INPUT_TYPE_REPLACEMENTS[typeAttr.value] ?? "Input";
@@ -2567,6 +2953,9 @@ var prefer_shadcn_default = ESLintUtils17.RuleCreator(
   },
   defaultOptions: [],
   create(context) {
+    if (isTestFile(context.filename) || isStoryFile(context.filename)) {
+      return {};
+    }
     return {
       JSXOpeningElement(node) {
         if (node.name.type !== "JSXIdentifier") {
@@ -2743,6 +3132,9 @@ var require_zod_form_validation_default = ESLintUtils19.RuleCreator(
   },
   defaultOptions: [],
   create(context) {
+    if (isTestFile(context.filename)) {
+      return {};
+    }
     const isFormSourceIdentifier = (node) => {
       if (node.type !== AST_NODE_TYPES11.Identifier) return false;
       if (/formdata/i.test(node.name)) return true;
@@ -2816,6 +3208,25 @@ var CONVENTIONS = {
   suffix: { test: ZOD_SUFFIX_RE, messageId: "schemaSuffix" },
   either: { test: ZOD_SCHEMA_NAME_RE, messageId: "zodSchemaName" }
 };
+var CONTAINS_SCHEMA_RE = /schema/i;
+var NON_SCHEMA_TERMINALS = /* @__PURE__ */ new Set([
+  "parse",
+  "parseAsync",
+  "safeParse",
+  "safeParseAsync",
+  "encode",
+  "decode",
+  "encodeAsync",
+  "decodeAsync",
+  "safeEncode",
+  "safeDecode",
+  "safeEncodeAsync",
+  "safeDecodeAsync",
+  "toJSONSchema",
+  "registry",
+  "implement"
+]);
+var terminalMethodName = (callee) => !callee.computed && callee.property.type === AST_NODE_TYPES12.Identifier ? callee.property.name : null;
 var calleeChainStartsWithZ = (node) => {
   let current = node;
   while (current.type === AST_NODE_TYPES12.MemberExpression) {
@@ -2860,7 +3271,12 @@ var zod_naming_convention_default = ESLintUtils20.RuleCreator(
   },
   defaultOptions: [{}],
   create(context, [optionsArg]) {
-    const { test, messageId } = CONVENTIONS[optionsArg?.convention ?? "either"];
+    const convention = optionsArg?.convention ?? "either";
+    const { test, messageId } = CONVENTIONS[convention];
+    const acceptsSchemaWord = convention !== "prefix";
+    if (isTestFile(context.filename) || isGeneratedFile(context.filename, context.sourceCode.text)) {
+      return {};
+    }
     return {
       VariableDeclarator(node) {
         const init = node.init;
@@ -2869,8 +3285,11 @@ var zod_naming_convention_default = ESLintUtils20.RuleCreator(
         const callee = init.callee;
         if (callee.type !== AST_NODE_TYPES12.MemberExpression) return;
         if (!calleeChainStartsWithZ(callee)) return;
+        const terminal = terminalMethodName(callee);
+        if (terminal !== null && NON_SCHEMA_TERMINALS.has(terminal)) return;
         if (node.id.type !== AST_NODE_TYPES12.Identifier) return;
         if (test.test(node.id.name)) return;
+        if (acceptsSchemaWord && CONTAINS_SCHEMA_RE.test(node.id.name)) return;
         context.report({
           node: node.id,
           messageId
@@ -3092,25 +3511,24 @@ var no_cors_wildcard_with_credentials_default = ESLintUtils21.RuleCreator(
 
 // src/rules/no-silent-promise-catch.ts
 import { AST_NODE_TYPES as AST_NODE_TYPES13, ESLintUtils as ESLintUtils22 } from "@typescript-eslint/utils";
-
-// src/rules/_paths.ts
-var SCRIPT_FILE_RE = /([\\/]scripts[\\/])|(\.mjs$)/;
-function isTestFile(filename) {
-  const normalized = filename.replaceAll("\\", "/");
-  const base = normalized.slice(normalized.lastIndexOf("/") + 1);
-  if (/\.(test|spec)\.[cm]?[jt]sx?$/.test(base)) {
-    return true;
-  }
-  return /(^|\/)(tests?|__tests__|__mocks__|fixtures)\//.test(normalized);
-}
-function isScriptFile(filename) {
-  return SCRIPT_FILE_RE.test(filename);
-}
-
-// src/rules/no-silent-promise-catch.ts
 function isBodyParseCall(node) {
   return node.type === AST_NODE_TYPES13.CallExpression && node.arguments.length === 0 && node.callee.type === AST_NODE_TYPES13.MemberExpression && !node.callee.computed && node.callee.property.type === AST_NODE_TYPES13.Identifier && (node.callee.property.name === "json" || node.callee.property.name === "text");
 }
+var TEARDOWN_METHODS = /* @__PURE__ */ new Set([
+  "cancel",
+  "close",
+  "abort",
+  "destroy",
+  "dispose",
+  "release",
+  "unlock",
+  "disconnect"
+]);
+var DIRECTIVE_COMMENT_RE = /^\s*(eslint-|@ts-|prettier-ignore|biome-ignore|c8 |v8 |istanbul )/;
+var isExplanatory = (comment) => !DIRECTIVE_COMMENT_RE.test(comment.value);
+function isTeardownCall(node) {
+  return node.type === AST_NODE_TYPES13.CallExpression && node.callee.type === AST_NODE_TYPES13.MemberExpression && !node.callee.computed && node.callee.property.type === AST_NODE_TYPES13.Identifier && TEARDOWN_METHODS.has(node.callee.property.name);
+}
 function isSilentExpression(node) {
   switch (node.type) {
     case AST_NODE_TYPES13.Literal:
@@ -3164,6 +3582,22 @@ var no_silent_promise_catch_default = ESLintUtils22.RuleCreator(
     if (isTestFile(context.filename)) {
       return {};
     }
+    const hasExplanatoryComment = (call, handler) => {
+      const sourceCode = context.sourceCode;
+      if (sourceCode.getCommentsInside(handler).some(isExplanatory)) {
+        return true;
+      }
+      let statement = call;
+      while (statement.parent !== void 0 && statement.parent !== null && !statement.type.endsWith("Statement") && statement.type !== AST_NODE_TYPES13.VariableDeclaration) {
+        statement = statement.parent;
+      }
+      if (sourceCode.getCommentsBefore(statement).some(isExplanatory)) {
+        return true;
+      }
+      return sourceCode.getCommentsAfter(statement).some(
+        (c) => isExplanatory(c) && c.loc.start.line === statement.loc.end.line
+      );
+    };
     return {
       CallExpression(node) {
         if (node.callee.type !== AST_NODE_TYPES13.MemberExpression || node.callee.computed || node.callee.property.type !== AST_NODE_TYPES13.Identifier || node.callee.property.name !== "catch") {
@@ -3172,6 +3606,12 @@ var no_silent_promise_catch_default = ESLintUtils22.RuleCreator(
         if (isBodyParseCall(node.callee.object)) {
           return;
         }
+        if (isTeardownCall(node.callee.object)) {
+          return;
+        }
+        if (node.parent.type === AST_NODE_TYPES13.MemberExpression && node.parent.object === node) {
+          return;
+        }
         if (node.arguments.length !== 1) {
           return;
         }
@@ -3179,6 +3619,9 @@ var no_silent_promise_catch_default = ESLintUtils22.RuleCreator(
         if (handler === void 0 || handler.type !== AST_NODE_TYPES13.ArrowFunctionExpression && handler.type !== AST_NODE_TYPES13.FunctionExpression) {
           return;
         }
+        if (hasExplanatoryComment(node, handler)) {
+          return;
+        }
         if (isSilentHandler(handler)) {
           context.report({ node, messageId: "silentCatch" });
         }
@@ -3193,6 +3636,7 @@ import {
   ASTUtils,
   ESLintUtils as ESLintUtils23
 } from "@typescript-eslint/utils";
+var CODEMOD_FIXTURE_RE = /[\\/]__testfixtures__[\\/]/;
 var GLOBAL_OBJECTS = /* @__PURE__ */ new Set([
   "globalThis",
   "window",
@@ -3255,7 +3699,7 @@ var require_fetch_timeout_default = ESLintUtils23.RuleCreator(
   },
   defaultOptions: [{}],
   create(context, [optionsArg]) {
-    if (isTestFile(context.filename) || isScriptFile(context.filename)) {
+    if (isTestFile(context.filename) || isScriptFile(context.filename) || CODEMOD_FIXTURE_RE.test(context.filename)) {
       return {};
     }
     const allowIn = optionsArg?.allowIn ?? [];
@@ -3977,6 +4421,9 @@ var no_unsafe_cast_default = ESLintUtils27.RuleCreator(
   },
   defaultOptions: [],
   create(context) {
+    if (isTestFile(context.filename)) {
+      return {};
+    }
     function checkAssertion(node) {
       if (isConstAssertion(node.typeAnnotation)) {
         return;
@@ -4477,6 +4924,7 @@ var single_public_export_default = ESLintUtils29.RuleCreator(
     const base = basename(context.filename);
     if (base.endsWith(".d.ts")) return {};
     if (TEST_FILE_RE.test(base)) return {};
+    if (isTestFile(context.filename)) return {};
     const stem = stemOf(base);
     if (!JUNK_DRAWER_STEMS.has(stem.toLowerCase())) return {};
     return {
@@ -4677,6 +5125,7 @@ var no_offset_pagination_default = ESLintUtils30.RuleCreator(
 // src/rules/no-positional-tuple-return.ts
 import { AST_NODE_TYPES as AST_NODE_TYPES21, ESLintUtils as ESLintUtils31 } from "@typescript-eslint/utils";
 var MIN_ELEMENTS = 2;
+var ACCESSOR_PAIR_LENGTH = 2;
 var AWAITABLE_TYPES = /* @__PURE__ */ new Set(["Promise", "PromiseLike", "Awaited"]);
 function tupleReturnType(node) {
   if (node.type === AST_NODE_TYPES21.TSTupleType) {
@@ -4705,6 +5154,9 @@ function isPermittedTuple(tuple, sourceCode) {
   if (elements[0]?.type === AST_NODE_TYPES21.TSLiteralType) {
     return true;
   }
+  if (elements.length === ACCESSOR_PAIR_LENGTH && elements.some((element) => element.type === AST_NODE_TYPES21.TSFunctionType)) {
+    return true;
+  }
   const texts = new Set(elements.map((element) => normalizedText(sourceCode, element)));
   return texts.size === 1;
 }
@@ -4904,6 +5356,9 @@ var no_repeated_string_literal_default = ESLintUtils32.RuleCreator(
         }
       },
       TemplateLiteral(node) {
+        if (node.parent.type === AST_NODE_TYPES22.TaggedTemplateExpression) {
+          return;
+        }
         const [only] = node.quasis;
         if (node.expressions.length === 0 && only !== void 0) {
           record(only.value.cooked ?? only.value.raw, node);
@@ -5127,7 +5582,10 @@ import { AST_NODE_TYPES as AST_NODE_TYPES24, ESLintUtils as ESLintUtils35 } from
 var EQUALITY_OPERATORS = /* @__PURE__ */ new Set(["===", "!==", "==", "!="]);
 var SENTINEL_IDENTIFIERS = /* @__PURE__ */ new Set(["undefined", "NaN"]);
 var SENTINEL_WORDS = /(^|_)(SENTINEL|EMPTY|NONE|NULL|UNSET|MISSING|PLACEHOLDER|DUMMY|FAKE|EXAMPLE)(_|$)/;
+var SENTINEL_PREFIX_RE = /^(skip|sentinel|empty|none|missing|unset|placeholder|dummy|fake|example|noop)[A-Z]/;
+var AST_NODE_TYPE_RE = /^(?:TS|JSX)?[A-Z][A-Za-z]*(?:Signature|Keyword|Expression|Declaration|Element|Literal|Identifier)$/;
 function isConstantReference(identifier) {
+  if (AST_NODE_TYPE_RE.test(identifier)) return true;
   if (isAuthSecretName(identifier) && !SENTINEL_WORDS.test(identifier)) return false;
   return identifier === identifier.toUpperCase() && /[A-Za-z]/.test(identifier);
 }
@@ -5138,9 +5596,9 @@ function isExcludedOperand(node) {
     case AST_NODE_TYPES24.TemplateLiteral:
       return node.expressions.length === 0;
     case AST_NODE_TYPES24.Identifier:
-      return SENTINEL_IDENTIFIERS.has(node.name) || isConstantReference(node.name);
+      return SENTINEL_IDENTIFIERS.has(node.name) || SENTINEL_PREFIX_RE.test(node.name) || isConstantReference(node.name);
     case AST_NODE_TYPES24.MemberExpression:
-      return !node.computed && node.property.type === AST_NODE_TYPES24.Identifier && isConstantReference(node.property.name);
+      return !node.computed && node.property.type === AST_NODE_TYPES24.Identifier && (SENTINEL_PREFIX_RE.test(node.property.name) || isConstantReference(node.property.name));
     default:
       return false;
   }
@@ -5290,6 +5748,23 @@ function runtimeConcatOperands(node) {
     (operand) => operand.type !== AST_NODE_TYPES25.Literal && !isStaticFragment(operand)
   );
 }
+var SQL_STATEMENT_RE = /\b(?:select\s|insert\s+into\b|insert\s+or\b|update\s+\w|delete\s+from\b|replace\s+into\b|merge\s+into\b|upsert\s+into\b|create\s+(?:temp(?:orary)?\s+)?(?:table|index|view|trigger|schema|database)\b|alter\s+table\b|drop\s+(?:table|index|view|trigger)\b|truncate\s+table\b|pragma\s+\w|with\s+\w+\s+as\s*\(|from\s+\w+\s+where\b)/i;
+var RUNTIME_MARKER = " ? ";
+function staticStatementText(node) {
+  if (node.type === AST_NODE_TYPES25.TemplateLiteral) {
+    return node.quasis.map((quasi) => quasi.value.cooked ?? quasi.value.raw).join(RUNTIME_MARKER);
+  }
+  if (node.type === AST_NODE_TYPES25.Literal) {
+    return typeof node.value === "string" ? node.value : RUNTIME_MARKER;
+  }
+  if (node.type === AST_NODE_TYPES25.BinaryExpression && node.operator === "+") {
+    return staticStatementText(node.left) + staticStatementText(node.right);
+  }
+  return RUNTIME_MARKER;
+}
+function looksLikeSql(node) {
+  return SQL_STATEMENT_RE.test(stripSqlNoise(staticStatementText(node)));
+}
 function statementMethodName(node, methods) {
   const callee = node.callee;
   if (callee.type !== AST_NODE_TYPES25.MemberExpression || callee.computed || callee.property.type !== AST_NODE_TYPES25.Identifier) {
@@ -5334,7 +5809,7 @@ var no_dynamic_sql_default = ESLintUtils37.RuleCreator(
           return;
         }
         const statement = node.arguments[0];
-        if (statement === void 0) {
+        if (statement === void 0 || !looksLikeSql(statement)) {
           return;
         }
         const offenders = statement.type === AST_NODE_TYPES25.TemplateLiteral ? runtimeInterpolations(statement) : runtimeConcatOperands(statement);
@@ -5356,16 +5831,28 @@ var DEFAULT_ALLOW = [
   "[\\\\/]clients?[\\\\/]",
   "-client\\.[cm]?[jt]sx?$",
   "[\\\\/]http-client\\.[cm]?[jt]sx?$",
+  // The `api` spelling of the same client-layer convention: an `api/` directory,
+  // a bare `api.ts`, or a `*-api.ts` / `*.api.ts` module.
+  "[\\\\/]api[\\\\/]",
+  "[\\\\/]api\\.[cm]?[jt]sx?$",
+  "[-.]api\\.[cm]?[jt]sx?$",
   "\\.test\\.",
   "\\.spec\\.",
+  // `*.test-d.ts` type tests, and react-router's `single-fetch-test.ts` spelling.
+  "\\.(test|spec)-d\\.[cm]?[jt]sx?$",
+  "-(test|spec)\\.[cm]?[jt]sx?$",
   "[\\\\/]__tests__[\\\\/]",
-  "[\\\\/]__mocks__[\\\\/]"
+  "[\\\\/]__mocks__[\\\\/]",
+  "[\\\\/]tests?[\\\\/]",
+  // jscodeshift input/output fixtures — text a codemod transforms, not code.
+  "[\\\\/]__testfixtures__[\\\\/]"
 ];
 var GLOBAL_RECEIVERS = /* @__PURE__ */ new Set([
   "globalThis",
   "window",
   "self"
 ]);
+var PRESIGNED_URL_NAME_RE = /(?:pre-?signed|signed|upload|download)Url$/i;
 function isGlobalFetchCall(node) {
   const callee = node.callee;
   if (callee.type === "Identifier") {
@@ -5376,6 +5863,23 @@ function isGlobalFetchCall(node) {
   }
   return false;
 }
+function identifierLikeName(node) {
+  if (node.type === "Identifier") {
+    return node.name;
+  }
+  if (node.type === "MemberExpression" && !node.computed && node.property.type === "Identifier") {
+    return node.property.name;
+  }
+  return null;
+}
+function isPresignedUrlTransfer(node) {
+  const first = node.arguments[0];
+  if (first === void 0) {
+    return false;
+  }
+  const name = identifierLikeName(first);
+  return name !== null && PRESIGNED_URL_NAME_RE.test(name);
+}
 function compile(patterns) {
   const compiled = [];
   for (const pattern of patterns) {
@@ -5422,6 +5926,9 @@ var no_raw_fetch_outside_clients_default = ESLintUtils38.RuleCreator(
     }
     return {
       CallExpression(node) {
+        if (isPresignedUrlTransfer(node)) {
+          return;
+        }
         if (isGlobalFetchCall(node)) {
           context.report({ node, messageId: "rawFetch" });
         }
@@ -5614,6 +6121,9 @@ var no_zod_native_enum_default = ESLintUtils40.RuleCreator(
     if (isIgnoredFile2(context.filename, sourceCode.getText())) {
       return {};
     }
+    if (isTestFile(context.filename)) {
+      return {};
+    }
     let services;
     try {
       services = ESLintUtils40.getParserServices(context);
@@ -6050,7 +6560,7 @@ var rules = {
 var plugin = {
   meta: {
     name: "@sarj/eslint-plugin",
-    version: "2.11.0"
+    version: "2.12.1"
   },
   rules,
   configs: {
@@ -6075,7 +6585,7 @@ var plugin = {
         "@sarj/prefer-discriminated-union": "warn",
         "@sarj/no-comment-cruft": "warn",
         // Frontend / styling — distilled from frontend PR-review mining.
-        "@sarj/prefer-semantic-colors": "warn",
+        "@sarj/prefer-semantic-colors": ["warn", { requireSemanticTokens: true }],
         // Ported from sarj-python-lint (SARJ), corpus-validated FP~0.
         "@sarj/no-fat-try-blocks": "warn",
         "@sarj/no-cors-wildcard-with-credentials": "warn",
@@ -6134,7 +6644,7 @@ var plugin = {
         "@sarj/no-comment-cruft": "error",
         // Frontend / styling — distilled from frontend PR-review mining. Stylistic,
         // no autofix → warn (rollout should prove the FP rate before raising it).
-        "@sarj/prefer-semantic-colors": "error",
+        "@sarj/prefer-semantic-colors": ["error", { requireSemanticTokens: true }],
         // Ported from sarj-python-lint (SARJ), corpus-validated FP~0.
         "@sarj/no-fat-try-blocks": "error",
         "@sarj/no-cors-wildcard-with-credentials": "error",