@sarj/eslint-plugin 16.14.2 → 16.14.4

package/dist/index.cjs

@@ -52,7 +52,7 @@ module.exports = __toCommonJS(src_exports);
 // package.json
 var package_default = {
   name: "@sarj/eslint-plugin",
-  version: "16.14.2",
+  version: "16.14.4",
   packageManager: "npm@12.2.0",
   description: "Custom ESLint rules for hypermodern TypeScript / React / Next.js projects",
   type: "module",
@@ -382,6 +382,7 @@ function deepFreeze(value) {
 }
 
 // src/rules/_paths.ts
+var import_node_path = require("path");
 var LINE_TERMINATOR_RE = /[\n\r\u2028\u2029]/u;
 var SCRIPT_FILE_RE = /(?:^|[\\/])scripts[\\/]|\.mjs$/;
 var STORY_FILE_RE = /\.stories\.[cm]?[jt]sx?$/i;
@@ -465,6 +466,10 @@ function leadingCommentBodies(sourceText) {
 function isScriptFile(filename) {
   return SCRIPT_FILE_RE.test(filename);
 }
+function matchesAnyPattern(filename, patterns) {
+  const normalized = filename.replaceAll("\\", "/");
+  return patterns.some((pattern) => import_node_path.posix.matchesGlob(normalized, pattern.replaceAll("\\", "/")));
+}
 function commentLineEnd(sourceText, start) {
   const end = sourceText.slice(start).search(LINE_TERMINATOR_RE);
   return end === -1 ? sourceText.length : start + end;
@@ -5842,15 +5847,6 @@ var NO_ENUM_DOCUMENTATION = {
     { id: "generated-header", scenarioId: "native-header-boundary", title: "Respect a native generated banner", outcome: "no-match", files: [{ path: "src/status.ts", source: '// auto-generated file\u2028const marker="auto-generated file"; enum Mode {Start} console.log(Mode.Start, marker);' }], focusPath: "src/status.ts", expectedCount: 0, public: true }
   ]
 };
-function matchesAnyPattern(filename, patterns) {
-  for (const pattern of patterns) {
-    const regexSource = pattern.replace(/[.+^${}()|[\]\\]/g, "\\$&").replace(/\*\*/g, "::DOUBLESTAR::").replace(/\*/g, "[^/\\\\]*").replace(/::DOUBLESTAR::/g, ".*");
-    if (new RegExp(`^${regexSource}$`).test(filename)) {
-      return true;
-    }
-  }
-  return false;
-}
 var no_enum_default = createRule({
   name: "no-enum",
   documentation: NO_ENUM_DOCUMENTATION,
@@ -6515,15 +6511,6 @@ var GLOBAL_OBJECTS = /* @__PURE__ */ new Set([
 ]);
 var CLIENT_ONLY_MODULES = /^(react|react-dom|react-native|svelte|vue|preact|solid-js)(\/|$)|^next\/(navigation|router|link|image)$/;
 var RACE_METHODS = /* @__PURE__ */ new Set(["race", "any"]);
-function matchesAnyPattern2(filename, patterns) {
-  for (const pattern of patterns) {
-    const regexSource = pattern.replace(/[.+^${}()|[\]\\]/g, "\\$&").replace(/\*\*/g, "::DOUBLESTAR::").replace(/\*/g, "[^/\\\\]*").replace(/::DOUBLESTAR::/g, ".*");
-    if (new RegExp(`^${regexSource}$`).test(filename)) {
-      return true;
-    }
-  }
-  return false;
-}
 function isSetTimeoutCallee(callee) {
   callee = unwrapExpression(callee);
   if (callee.type === import_utils37.AST_NODE_TYPES.Identifier) {
@@ -6629,7 +6616,7 @@ var no_hand_rolled_sleep_default = createRule({
       return {};
     }
     const allowIn = optionsArg?.allowIn ?? [];
-    if (allowIn.length > 0 && matchesAnyPattern2(filename, allowIn)) {
+    if (allowIn.length > 0 && matchesAnyPattern(filename, allowIn)) {
       return {};
     }
     const checkClientModules = optionsArg?.checkClientModules ?? false;
@@ -16398,7 +16385,7 @@ function unwrapTransparentExport(node) {
 var import_utils95 = require("@typescript-eslint/utils");
 var import_typescript_estree = require("@typescript-eslint/typescript-estree");
 var import_node_fs = require("fs");
-var import_node_path = require("path");
+var import_node_path2 = require("path");
 var import_jsonc_parser = require("jsonc-parser");
 var PREFER_SHADCN_PRIMITIVES_DOCUMENTATION = {
   summary: "Require visible raw JSX controls to use the corresponding shared shadcn primitive.",
@@ -16460,9 +16447,9 @@ var AMBIGUOUS_INPUT_TYPES = /* @__PURE__ */ new Set([
 var MAX_PROJECT_FILE_BYTES = 1048576;
 var PROJECT_PRIMITIVES_CACHE = /* @__PURE__ */ new Map();
 function detectProjectPrimitives(filename, requested) {
-  const packageRoot = findPackageRoot((0, import_node_path.dirname)(filename));
+  const packageRoot = findPackageRoot((0, import_node_path2.dirname)(filename));
   if (packageRoot === null) return { available: /* @__PURE__ */ new Set(), uiRoot: null };
-  const manifest = readJsonc((0, import_node_path.join)(packageRoot, "components.json"));
+  const manifest = readJsonc((0, import_node_path2.join)(packageRoot, "components.json"));
   const alias = stringProperty(manifest, "aliases", "ui");
   const unresolvedUiRoot = alias === null ? null : resolveAlias(packageRoot, alias);
   if (unresolvedUiRoot === null) return { available: /* @__PURE__ */ new Set(), uiRoot: null };
@@ -16474,14 +16461,14 @@ function detectProjectPrimitives(filename, requested) {
   for (const [capability, moduleName] of Object.entries(CAPABILITIES)) {
     if (!requested.has(capability)) continue;
     moduleCandidates.set(capability, ["tsx", "ts", "jsx", "js"].flatMap((extension) => [
-      (0, import_node_path.join)(uiRoot, `${moduleName}.${extension}`),
-      (0, import_node_path.join)(uiRoot, moduleName, `index.${extension}`)
+      (0, import_node_path2.join)(uiRoot, `${moduleName}.${extension}`),
+      (0, import_node_path2.join)(uiRoot, moduleName, `index.${extension}`)
     ]));
   }
   const fingerprint = [
-    (0, import_node_path.join)(packageRoot, "components.json"),
-    (0, import_node_path.join)(packageRoot, "tsconfig.json"),
-    (0, import_node_path.join)(packageRoot, "jsconfig.json"),
+    (0, import_node_path2.join)(packageRoot, "components.json"),
+    (0, import_node_path2.join)(packageRoot, "tsconfig.json"),
+    (0, import_node_path2.join)(packageRoot, "jsconfig.json"),
     ...[...moduleCandidates.values()].flat()
   ].map(fileFingerprint).join("|");
   const cacheKey = `${packageRoot}:${[...requested].sort().join(",")}`;
@@ -16508,8 +16495,8 @@ function fileFingerprint(path) {
   }
 }
 function isWithin2(root, candidate2) {
-  const path = (0, import_node_path.relative)(root, candidate2);
-  return path === "" || !path.startsWith(`..${import_node_path.sep}`) && path !== ".." && !(0, import_node_path.isAbsolute)(path);
+  const path = (0, import_node_path2.relative)(root, candidate2);
+  return path === "" || !path.startsWith(`..${import_node_path2.sep}`) && path !== ".." && !(0, import_node_path2.isAbsolute)(path);
 }
 function safeContainedDirectory(root, candidate2) {
   try {
@@ -16523,10 +16510,10 @@ function safeContainedDirectory(root, candidate2) {
 }
 function findPackageRoot(startDir) {
   let dir = startDir;
-  const filesystemRoot = (0, import_node_path.parse)(dir).root;
+  const filesystemRoot = (0, import_node_path2.parse)(dir).root;
   for (; ; ) {
-    if ((0, import_node_fs.existsSync)((0, import_node_path.join)(dir, "package.json"))) return dir;
-    const parent = (0, import_node_path.dirname)(dir);
+    if ((0, import_node_fs.existsSync)((0, import_node_path2.join)(dir, "package.json"))) return dir;
+    const parent = (0, import_node_path2.dirname)(dir);
     if (dir === filesystemRoot || parent === dir) return null;
     dir = parent;
   }
@@ -16563,9 +16550,9 @@ function stringProperty(value, ...keys) {
   return typeof current === "string" && current.trim() !== "" ? current : null;
 }
 function resolveAlias(packageRoot, alias) {
-  if ((0, import_node_path.isAbsolute)(alias)) return null;
-  if (alias.startsWith(".")) return (0, import_node_path.resolve)(packageRoot, alias);
-  const configPath = ["tsconfig.json", "jsconfig.json"].map((name) => (0, import_node_path.join)(packageRoot, name)).find(import_node_fs.existsSync);
+  if ((0, import_node_path2.isAbsolute)(alias)) return null;
+  if (alias.startsWith(".")) return (0, import_node_path2.resolve)(packageRoot, alias);
+  const configPath = ["tsconfig.json", "jsconfig.json"].map((name) => (0, import_node_path2.join)(packageRoot, name)).find(import_node_fs.existsSync);
   if (configPath === void 0) return null;
   const config = readJsonc(configPath);
   if (typeof config !== "object" || config === null) return null;
@@ -16578,7 +16565,7 @@ function resolveAlias(packageRoot, alias) {
   const matches = matchingAliasTargets(paths, alias);
   const [match] = matches;
   if (matches.length !== 1 || match === void 0) return null;
-  return (0, import_node_path.resolve)(packageRoot, baseUrl, match);
+  return (0, import_node_path2.resolve)(packageRoot, baseUrl, match);
 }
 function exportsPrimitive(path, exportName) {
   try {
@@ -18119,8 +18106,7 @@ function isNullish(node) {
 }
 function referenceCarrier(node, context, depth) {
   if (node.typeName.type !== import_utils100.AST_NODE_TYPES.Identifier) return void 0;
-  const variable = import_utils100.ASTUtils.findVariable(context.sourceCode.getScope(node), node.typeName.name);
-  const definitions = variable?.defs ?? [];
+  const definitions = typeDefinitions(node, context);
   const args = node.typeArguments?.params;
   if (definitions.length === 0 && ["Array", "ReadonlyArray"].includes(node.typeName.name) && args?.length === 1) {
     return arrayCarrier(rawCarrier(args[0], context, depth + 1));
@@ -18130,6 +18116,17 @@ function referenceCarrier(node, context, depth) {
   if (declaration?.type !== import_utils100.AST_NODE_TYPES.TSTypeAliasDeclaration || declaration.typeParameters !== void 0) return void 0;
   return rawCarrier(declaration.typeAnnotation, context, depth + 1);
 }
+function typeDefinitions(node, context) {
+  if (node.typeName.type !== import_utils100.AST_NODE_TYPES.Identifier) return [];
+  let scope = context.sourceCode.getScope(node);
+  while (scope !== null) {
+    const variable = scope.set.get(node.typeName.name);
+    const definitions = variable?.defs.filter((definition) => definition.isTypeDefinition) ?? [];
+    if (definitions.length > 0 || variable?.isTypeVariable === true) return definitions;
+    scope = scope.upper;
+  }
+  return [];
+}
 function rawCarrier(node, context, depth = 0) {
   if (node === void 0 || depth >= MAX_ALIAS_DEPTH) return void 0;
   switch (node.type) {
@@ -18200,6 +18197,9 @@ var prefer_nominal_id_types_default = createRule({
       FunctionExpression: (node) => checkBoundary(node, context),
       TSDeclareFunction: (node) => checkBoundary(node, context),
       TSEmptyBodyFunctionExpression: (node) => checkBoundary(node, context),
+      TSCallSignatureDeclaration: (node) => checkBoundary(node, context),
+      TSConstructSignatureDeclaration: (node) => checkBoundary(node, context),
+      TSConstructorType: (node) => checkBoundary(node, context),
       TSFunctionType: (node) => checkBoundary(node, context),
       TSMethodSignature: (node) => checkBoundary(node, context)
     };
@@ -22666,15 +22666,6 @@ var REQUIRE_FETCH_TIMEOUT_DOCUMENTATION = {
     }
   ]
 };
-function matchesAnyPattern3(filename, patterns) {
-  for (const pattern of patterns) {
-    const regexSource = pattern.replace(/[.+^${}()|[\]\\]/g, "\\$&").replace(/\*\*/g, "::DOUBLESTAR::").replace(/\*/g, "[^/\\\\]*").replace(/::DOUBLESTAR::/g, ".*");
-    if (new RegExp(`^${regexSource}$`).test(filename)) {
-      return true;
-    }
-  }
-  return false;
-}
 function emptySignal(expression, resolvesToGlobal) {
   const value = unwrapExpression(expression);
   if (value.type === import_utils121.AST_NODE_TYPES.Literal && value.value === null)
@@ -22755,7 +22746,7 @@ var require_fetch_timeout_default = createRule({
       return {};
     }
     const allowIn = optionsArg?.allowIn ?? [];
-    if (allowIn.length > 0 && matchesAnyPattern3(context.filename, allowIn)) {
+    if (allowIn.length > 0 && matchesAnyPattern(context.filename, allowIn)) {
       return {};
     }
     function resolvesToGlobal(identifier) {
@@ -24871,7 +24862,7 @@ var import_utils131 = require("@typescript-eslint/utils");
 
 // src/rules/_is-framework-entrypoint.ts
 var import_node_fs2 = require("fs");
-var import_node_path2 = require("path");
+var import_node_path3 = require("path");
 var HTTP_METHODS = /* @__PURE__ */ new Set(["GET", "HEAD", "POST", "PUT", "DELETE", "PATCH", "OPTIONS"]);
 var NEXT_COMPONENT = /^(?:src\/)?app\/(?:.*\/)?(?:page|layout|loading|not-found|template|error|global-error|default|forbidden|unauthorized)\.[jt]sx?$/u;
 var NEXT_METADATA = /^(?:src\/)?app\/(?:.*\/)?(?:(?:opengraph-image|twitter-image|icon|apple-icon)\.[jt]sx?|(?:robots|sitemap|manifest)\.[jt]s)$/u;
@@ -24881,7 +24872,7 @@ function isFrameworkEntrypoint(filename, exportKey) {
   if (!/(?:^|\/)(?:app|pages)\/|(?:^|\/)(?:middleware|proxy|instrumentation)\.[jt]s$/u.test(normalized)) return false;
   const owner = packageOwner(normalized);
   if (owner === null) return false;
-  const path = (0, import_node_path2.relative)(owner.root, normalized).replaceAll("\\", "/");
+  const path = (0, import_node_path3.relative)(owner.root, normalized).replaceAll("\\", "/");
   if (declaresFramework(owner.metadata, "next") && isNextEntrypoint(path, exportKey)) return true;
   return declaresFramework(owner.metadata, "astro") && isAstroEntrypoint(path, exportKey);
 }
@@ -24903,14 +24894,14 @@ function isAstroEntrypoint(path, exportKey) {
   );
 }
 function packageOwner(filename) {
-  let root = (0, import_node_path2.dirname)(filename);
+  let root = (0, import_node_path3.dirname)(filename);
   while (true) {
     try {
-      return { root, metadata: JSON.parse((0, import_node_fs2.readFileSync)((0, import_node_path2.join)(root, "package.json"), "utf8")) };
+      return { root, metadata: JSON.parse((0, import_node_fs2.readFileSync)((0, import_node_path3.join)(root, "package.json"), "utf8")) };
     } catch (error) {
       if (typeof error !== "object" || error === null || !("code" in error) || error.code !== "ENOENT") return null;
     }
-    const parent = (0, import_node_path2.dirname)(root);
+    const parent = (0, import_node_path3.dirname)(root);
     if (parent === root) return null;
     root = parent;
   }