@sarj/eslint-plugin 3.0.0 → 4.1.0

package/dist/index.d.cts

@@ -280,9 +280,6 @@ declare const rules: {
     "prefer-zod-enum": _typescript_eslint_utils_ts_eslint.RuleModule<"preferEnum", readonly [], unknown, _typescript_eslint_utils_ts_eslint.RuleListener> & {
         name: string;
     };
-    "primary-export-file-name": _typescript_eslint_utils_ts_eslint.RuleModule<"primaryExportMismatch", readonly [], unknown, _typescript_eslint_utils_ts_eslint.RuleListener> & {
-        name: string;
-    };
     "no-silent-promise-catch": _typescript_eslint_utils_ts_eslint.RuleModule<"silentCatch", readonly [], unknown, _typescript_eslint_utils_ts_eslint.RuleListener> & {
         name: string;
     };
@@ -306,6 +303,12 @@ declare const rules: {
     "no-sleep-in-test-body": _typescript_eslint_utils_ts_eslint.RuleModule<"noSleepInTestBody", readonly [], unknown, _typescript_eslint_utils_ts_eslint.RuleListener> & {
         name: string;
     };
+    "no-hand-rolled-sleep": _typescript_eslint_utils_ts_eslint.RuleModule<"handRolledSleep" | "handRolledTimeoutRace", readonly [{
+        allowIn?: readonly string[];
+        checkClientModules?: boolean;
+    }?], unknown, _typescript_eslint_utils_ts_eslint.RuleListener> & {
+        name: string;
+    };
     "no-conditional-in-test": _typescript_eslint_utils_ts_eslint.RuleModule<"noConditionalInTest", readonly [], unknown, _typescript_eslint_utils_ts_eslint.RuleListener> & {
         name: string;
     };
@@ -452,9 +455,6 @@ declare const plugin: {
         "prefer-zod-enum": _typescript_eslint_utils_ts_eslint.RuleModule<"preferEnum", readonly [], unknown, _typescript_eslint_utils_ts_eslint.RuleListener> & {
             name: string;
         };
-        "primary-export-file-name": _typescript_eslint_utils_ts_eslint.RuleModule<"primaryExportMismatch", readonly [], unknown, _typescript_eslint_utils_ts_eslint.RuleListener> & {
-            name: string;
-        };
         "no-silent-promise-catch": _typescript_eslint_utils_ts_eslint.RuleModule<"silentCatch", readonly [], unknown, _typescript_eslint_utils_ts_eslint.RuleListener> & {
             name: string;
         };
@@ -478,6 +478,12 @@ declare const plugin: {
         "no-sleep-in-test-body": _typescript_eslint_utils_ts_eslint.RuleModule<"noSleepInTestBody", readonly [], unknown, _typescript_eslint_utils_ts_eslint.RuleListener> & {
             name: string;
         };
+        "no-hand-rolled-sleep": _typescript_eslint_utils_ts_eslint.RuleModule<"handRolledSleep" | "handRolledTimeoutRace", readonly [{
+            allowIn?: readonly string[];
+            checkClientModules?: boolean;
+        }?], unknown, _typescript_eslint_utils_ts_eslint.RuleListener> & {
+            name: string;
+        };
         "no-conditional-in-test": _typescript_eslint_utils_ts_eslint.RuleModule<"noConditionalInTest", readonly [], unknown, _typescript_eslint_utils_ts_eslint.RuleListener> & {
             name: string;
         };
@@ -562,7 +568,6 @@ declare const plugin: {
                 "@sarj/no-cors-wildcard-with-credentials": string;
                 "@sarj/no-secret-in-log": string;
                 "@sarj/no-unsafe-mock-casting": string;
-                "@sarj/primary-export-file-name": string;
                 "@sarj/prefer-string-literal-union": string;
                 "@sarj/prefer-zod-enum": string;
                 "@sarj/require-fetch-timeout": string;
@@ -571,6 +576,7 @@ declare const plugin: {
                 "@sarj/store-insert-requires-on-conflict": string;
                 "@sarj/no-offset-pagination": string;
                 "@sarj/no-select-star": string;
+                "@sarj/no-hand-rolled-sleep": string;
                 "@sarj/no-sleep-in-test-body": string;
                 "@sarj/no-conditional-in-test": string;
                 "@sarj/no-repeated-string-literal": string;
@@ -617,7 +623,6 @@ declare const plugin: {
                 "@sarj/no-cors-wildcard-with-credentials": string;
                 "@sarj/no-secret-in-log": string;
                 "@sarj/no-unsafe-mock-casting": string;
-                "@sarj/primary-export-file-name": string;
                 "@sarj/prefer-string-literal-union": string;
                 "@sarj/prefer-zod-enum": string;
                 "@sarj/require-fetch-timeout": string;
@@ -626,6 +631,7 @@ declare const plugin: {
                 "@sarj/store-insert-requires-on-conflict": string;
                 "@sarj/no-offset-pagination": string;
                 "@sarj/no-select-star": string;
+                "@sarj/no-hand-rolled-sleep": string;
                 "@sarj/no-sleep-in-test-body": string;
                 "@sarj/no-conditional-in-test": string;
                 "@sarj/no-repeated-string-literal": string;

package/dist/index.d.ts

@@ -280,9 +280,6 @@ declare const rules: {
     "prefer-zod-enum": _typescript_eslint_utils_ts_eslint.RuleModule<"preferEnum", readonly [], unknown, _typescript_eslint_utils_ts_eslint.RuleListener> & {
         name: string;
     };
-    "primary-export-file-name": _typescript_eslint_utils_ts_eslint.RuleModule<"primaryExportMismatch", readonly [], unknown, _typescript_eslint_utils_ts_eslint.RuleListener> & {
-        name: string;
-    };
     "no-silent-promise-catch": _typescript_eslint_utils_ts_eslint.RuleModule<"silentCatch", readonly [], unknown, _typescript_eslint_utils_ts_eslint.RuleListener> & {
         name: string;
     };
@@ -306,6 +303,12 @@ declare const rules: {
     "no-sleep-in-test-body": _typescript_eslint_utils_ts_eslint.RuleModule<"noSleepInTestBody", readonly [], unknown, _typescript_eslint_utils_ts_eslint.RuleListener> & {
         name: string;
     };
+    "no-hand-rolled-sleep": _typescript_eslint_utils_ts_eslint.RuleModule<"handRolledSleep" | "handRolledTimeoutRace", readonly [{
+        allowIn?: readonly string[];
+        checkClientModules?: boolean;
+    }?], unknown, _typescript_eslint_utils_ts_eslint.RuleListener> & {
+        name: string;
+    };
     "no-conditional-in-test": _typescript_eslint_utils_ts_eslint.RuleModule<"noConditionalInTest", readonly [], unknown, _typescript_eslint_utils_ts_eslint.RuleListener> & {
         name: string;
     };
@@ -452,9 +455,6 @@ declare const plugin: {
         "prefer-zod-enum": _typescript_eslint_utils_ts_eslint.RuleModule<"preferEnum", readonly [], unknown, _typescript_eslint_utils_ts_eslint.RuleListener> & {
             name: string;
         };
-        "primary-export-file-name": _typescript_eslint_utils_ts_eslint.RuleModule<"primaryExportMismatch", readonly [], unknown, _typescript_eslint_utils_ts_eslint.RuleListener> & {
-            name: string;
-        };
         "no-silent-promise-catch": _typescript_eslint_utils_ts_eslint.RuleModule<"silentCatch", readonly [], unknown, _typescript_eslint_utils_ts_eslint.RuleListener> & {
             name: string;
         };
@@ -478,6 +478,12 @@ declare const plugin: {
         "no-sleep-in-test-body": _typescript_eslint_utils_ts_eslint.RuleModule<"noSleepInTestBody", readonly [], unknown, _typescript_eslint_utils_ts_eslint.RuleListener> & {
             name: string;
         };
+        "no-hand-rolled-sleep": _typescript_eslint_utils_ts_eslint.RuleModule<"handRolledSleep" | "handRolledTimeoutRace", readonly [{
+            allowIn?: readonly string[];
+            checkClientModules?: boolean;
+        }?], unknown, _typescript_eslint_utils_ts_eslint.RuleListener> & {
+            name: string;
+        };
         "no-conditional-in-test": _typescript_eslint_utils_ts_eslint.RuleModule<"noConditionalInTest", readonly [], unknown, _typescript_eslint_utils_ts_eslint.RuleListener> & {
             name: string;
         };
@@ -562,7 +568,6 @@ declare const plugin: {
                 "@sarj/no-cors-wildcard-with-credentials": string;
                 "@sarj/no-secret-in-log": string;
                 "@sarj/no-unsafe-mock-casting": string;
-                "@sarj/primary-export-file-name": string;
                 "@sarj/prefer-string-literal-union": string;
                 "@sarj/prefer-zod-enum": string;
                 "@sarj/require-fetch-timeout": string;
@@ -571,6 +576,7 @@ declare const plugin: {
                 "@sarj/store-insert-requires-on-conflict": string;
                 "@sarj/no-offset-pagination": string;
                 "@sarj/no-select-star": string;
+                "@sarj/no-hand-rolled-sleep": string;
                 "@sarj/no-sleep-in-test-body": string;
                 "@sarj/no-conditional-in-test": string;
                 "@sarj/no-repeated-string-literal": string;
@@ -617,7 +623,6 @@ declare const plugin: {
                 "@sarj/no-cors-wildcard-with-credentials": string;
                 "@sarj/no-secret-in-log": string;
                 "@sarj/no-unsafe-mock-casting": string;
-                "@sarj/primary-export-file-name": string;
                 "@sarj/prefer-string-literal-union": string;
                 "@sarj/prefer-zod-enum": string;
                 "@sarj/require-fetch-timeout": string;
@@ -626,6 +631,7 @@ declare const plugin: {
                 "@sarj/store-insert-requires-on-conflict": string;
                 "@sarj/no-offset-pagination": string;
                 "@sarj/no-select-star": string;
+                "@sarj/no-hand-rolled-sleep": string;
                 "@sarj/no-sleep-in-test-body": string;
                 "@sarj/no-conditional-in-test": string;
                 "@sarj/no-repeated-string-literal": string;

package/dist/index.js

@@ -7174,126 +7174,8 @@ var prefer_non_nullable_collection_default = ESLintUtils46.RuleCreator(
   }
 });
 
-// src/rules/primary-export-file-name.ts
-import { AST_NODE_TYPES as AST_NODE_TYPES34, ESLintUtils as ESLintUtils47 } from "@typescript-eslint/utils";
-var CONVENTIONAL_BUCKET_EXPORTS = /* @__PURE__ */ new Set(["cn"]);
-var GENERIC_ENTRYPOINTS = /* @__PURE__ */ new Set(["main", "run", "cli", "setup", "teardown", "execute"]);
-var ACRONYM_OVERRIDES = [
-  [/OAuth/g, "Oauth"],
-  [/GraphQL/g, "Graphql"],
-  [/gRPC/g, "Grpc"]
-];
-var CAMEL_BOUNDARY_RE = /(?<=[a-z0-9])(?=[A-Z])|(?<=[A-Z])(?=[A-Z][a-z])/g;
-var basename = (filename) => filename.split(/[/\\]/).pop() ?? filename;
-var stemOf = (base) => base.replace(/\.(test|spec|config|d|stories)\.[cm]?[jt]sx?$/i, "").replace(/\.[cm]?[jt]sx?$/i, "");
-var kebabCase = (name) => {
-  let normalized = name;
-  for (const [pattern, replacement] of ACRONYM_OVERRIDES) {
-    normalized = normalized.replace(pattern, replacement);
-  }
-  return normalized.replace(CAMEL_BOUNDARY_RE, "-").toLowerCase();
-};
-var isFunctionOrClass = (node) => node.type === AST_NODE_TYPES34.ArrowFunctionExpression || node.type === AST_NODE_TYPES34.FunctionExpression;
-var findPrimaryExport = (body) => {
-  let exportCount = 0;
-  let primaryCandidate = null;
-  for (const statement of body) {
-    if (statement.type === AST_NODE_TYPES34.ExportAllDeclaration) {
-      return null;
-    }
-    if (statement.type === AST_NODE_TYPES34.ExportDefaultDeclaration) {
-      exportCount += 1;
-      const decl = statement.declaration;
-      if ((decl.type === AST_NODE_TYPES34.FunctionDeclaration || decl.type === AST_NODE_TYPES34.ClassDeclaration) && decl.id !== null) {
-        primaryCandidate = { name: decl.id.name, node: statement, isDefault: true };
-      } else if (decl.type === AST_NODE_TYPES34.Identifier) {
-        primaryCandidate = { name: decl.name, node: statement, isDefault: true };
-      }
-    } else if (statement.type === AST_NODE_TYPES34.ExportNamedDeclaration) {
-      if (statement.source !== null) {
-        return null;
-      }
-      const decl = statement.declaration;
-      if (decl === null) {
-        exportCount += statement.specifiers.length;
-        if (statement.specifiers.length === 1 && primaryCandidate === null) {
-          const spec = statement.specifiers[0];
-          if (spec && spec.exported.type === AST_NODE_TYPES34.Identifier) {
-            primaryCandidate = { name: spec.exported.name, node: statement, isDefault: false };
-          }
-        }
-      } else if (decl.type === AST_NODE_TYPES34.FunctionDeclaration || decl.type === AST_NODE_TYPES34.ClassDeclaration) {
-        if (decl.id !== null) {
-          exportCount += 1;
-          if (primaryCandidate === null) {
-            primaryCandidate = { name: decl.id.name, node: statement, isDefault: false };
-          }
-        }
-      } else if (decl.type === AST_NODE_TYPES34.VariableDeclaration) {
-        for (const declarator of decl.declarations) {
-          if (declarator.id.type === AST_NODE_TYPES34.Identifier) {
-            exportCount += 1;
-            if (primaryCandidate === null && declarator.init && isFunctionOrClass(declarator.init)) {
-              primaryCandidate = { name: declarator.id.name, node: statement, isDefault: false };
-            }
-          }
-        }
-      } else if (decl.type === AST_NODE_TYPES34.TSTypeAliasDeclaration || decl.type === AST_NODE_TYPES34.TSInterfaceDeclaration) {
-        exportCount += 1;
-        if (primaryCandidate === null) {
-          primaryCandidate = { name: decl.id.name, node: statement, isDefault: false };
-        }
-      }
-    }
-  }
-  if (primaryCandidate === null || exportCount > 2) {
-    return null;
-  }
-  return { ...primaryCandidate, count: exportCount };
-};
-var primary_export_file_name_default = ESLintUtils47.RuleCreator(
-  (name) => `https://github.com/sarj-ai/standards/blob/main/packages/typescript/src/rules/${name}.ts`
-)({
-  name: "primary-export-file-name",
-  meta: {
-    type: "suggestion",
-    docs: {
-      description: "Enforce semantic naming alignment: a file with a single primary export must be named after that export."
-    },
-    schema: [],
-    messages: {
-      primaryExportMismatch: "Module stem '{{stem}}' does not match its primary export '{{name}}' \u2014 rename the file to '{{expected}}{{ext}}' to describe its responsibility."
-    }
-  },
-  defaultOptions: [],
-  create(context) {
-    const base = basename(context.filename);
-    if (base.endsWith(".d.ts") || base.startsWith("index.") || base.startsWith("_")) return {};
-    if (isTestFile(context.filename) || isGeneratedFile(context.filename, context.sourceCode.text)) return {};
-    const stem3 = stemOf(base);
-    if (stem3 === "page" || stem3 === "layout" || stem3 === "loading" || stem3 === "error" || stem3 === "not-found" || stem3 === "route" || stem3 === "__root" || stem3 === "config" || stem3 === "constants" || stem3 === "types" || stem3.startsWith("$") || stem3.startsWith("[")) {
-      return {};
-    }
-    return {
-      Program(node) {
-        const primary = findPrimaryExport(node.body);
-        if (primary === null) return;
-        if (CONVENTIONAL_BUCKET_EXPORTS.has(primary.name) || GENERIC_ENTRYPOINTS.has(primary.name)) return;
-        const expectedStem = kebabCase(primary.name);
-        if (stem3 === expectedStem) return;
-        const ext = base.endsWith(".tsx") ? ".tsx" : ".ts";
-        context.report({
-          node: primary.node,
-          messageId: "primaryExportMismatch",
-          data: { stem: stem3, name: primary.name, expected: expectedStem, ext }
-        });
-      }
-    };
-  }
-});
-
 // src/rules/no-implicit-attribute-access.ts
-import { AST_NODE_TYPES as AST_NODE_TYPES35, ESLintUtils as ESLintUtils48 } from "@typescript-eslint/utils";
+import { AST_NODE_TYPES as AST_NODE_TYPES34, ESLintUtils as ESLintUtils47 } from "@typescript-eslint/utils";
 var EXCLUDED_BASES = /* @__PURE__ */ new Set([
   "environ",
   "headers",
@@ -7309,15 +7191,15 @@ var EXCLUDED_BASES = /* @__PURE__ */ new Set([
   "sessionStorage"
 ]);
 function getBaseName(node) {
-  if (node.type === AST_NODE_TYPES35.Identifier) {
+  if (node.type === AST_NODE_TYPES34.Identifier) {
     return node.name;
   }
-  if (node.type === AST_NODE_TYPES35.MemberExpression && node.property.type === AST_NODE_TYPES35.Identifier) {
+  if (node.type === AST_NODE_TYPES34.MemberExpression && node.property.type === AST_NODE_TYPES34.Identifier) {
     return node.property.name;
   }
   return null;
 }
-var no_implicit_attribute_access_default = ESLintUtils48.RuleCreator(
+var no_implicit_attribute_access_default = ESLintUtils47.RuleCreator(
   (name) => `https://github.com/sarj-ai/standards/blob/main/packages/typescript/src/rules/${name}.ts`
 )({
   name: "no-implicit-attribute-access",
@@ -7338,7 +7220,7 @@ var no_implicit_attribute_access_default = ESLintUtils48.RuleCreator(
         if (!node.computed) {
           return;
         }
-        if (node.property.type === AST_NODE_TYPES35.Literal && typeof node.property.value === "string") {
+        if (node.property.type === AST_NODE_TYPES34.Literal && typeof node.property.value === "string") {
           const baseName = getBaseName(node.object);
           if (!baseName || !EXCLUDED_BASES.has(baseName)) {
             context.report({
@@ -7351,11 +7233,11 @@ var no_implicit_attribute_access_default = ESLintUtils48.RuleCreator(
       },
       CallExpression(node) {
         const callee = node.callee;
-        if (callee.type === AST_NODE_TYPES35.MemberExpression) {
-          const method = callee.property.type === AST_NODE_TYPES35.Identifier ? callee.property.name : null;
+        if (callee.type === AST_NODE_TYPES34.MemberExpression) {
+          const method = callee.property.type === AST_NODE_TYPES34.Identifier ? callee.property.name : null;
           if (method === "get") {
             const arg = node.arguments[0];
-            if (arg && arg.type === AST_NODE_TYPES35.Literal && typeof arg.value === "string") {
+            if (arg && arg.type === AST_NODE_TYPES34.Literal && typeof arg.value === "string") {
               const baseName = getBaseName(callee.object);
               if (!baseName || !EXCLUDED_BASES.has(baseName)) {
                 context.report({
@@ -7373,8 +7255,8 @@ var no_implicit_attribute_access_default = ESLintUtils48.RuleCreator(
 });
 
 // src/rules/strict-test-assertions.ts
-import { AST_NODE_TYPES as AST_NODE_TYPES36, ESLintUtils as ESLintUtils49 } from "@typescript-eslint/utils";
-var strict_test_assertions_default = ESLintUtils49.RuleCreator.withoutDocs({
+import { AST_NODE_TYPES as AST_NODE_TYPES35, ESLintUtils as ESLintUtils48 } from "@typescript-eslint/utils";
+var strict_test_assertions_default = ESLintUtils48.RuleCreator.withoutDocs({
   meta: {
     type: "suggestion",
     docs: {
@@ -7392,9 +7274,9 @@ var strict_test_assertions_default = ESLintUtils49.RuleCreator.withoutDocs({
       let currentObject = null;
       let sequence = [];
       function getExpectObject(expr) {
-        if (expr.type === AST_NODE_TYPES36.CallExpression && expr.callee.type === AST_NODE_TYPES36.MemberExpression && expr.callee.object.type === AST_NODE_TYPES36.CallExpression && expr.callee.object.callee.type === AST_NODE_TYPES36.Identifier && expr.callee.object.callee.name === "expect" && expr.callee.object.arguments.length === 1) {
+        if (expr.type === AST_NODE_TYPES35.CallExpression && expr.callee.type === AST_NODE_TYPES35.MemberExpression && expr.callee.object.type === AST_NODE_TYPES35.CallExpression && expr.callee.object.callee.type === AST_NODE_TYPES35.Identifier && expr.callee.object.callee.name === "expect" && expr.callee.object.arguments.length === 1) {
           const arg = expr.callee.object.arguments.at(0);
-          if (arg?.type === AST_NODE_TYPES36.MemberExpression) {
+          if (arg?.type === AST_NODE_TYPES35.MemberExpression) {
             return arg.object;
           }
         }
@@ -7410,12 +7292,12 @@ var strict_test_assertions_default = ESLintUtils49.RuleCreator.withoutDocs({
               if (!currentObject) return null;
               const objectText = context.sourceCode.getText(currentObject);
               const props = sequence.map((stmt) => {
-                if (stmt.expression.type !== AST_NODE_TYPES36.CallExpression || stmt.expression.callee.type !== AST_NODE_TYPES36.MemberExpression || stmt.expression.callee.object.type !== AST_NODE_TYPES36.CallExpression) {
+                if (stmt.expression.type !== AST_NODE_TYPES35.CallExpression || stmt.expression.callee.type !== AST_NODE_TYPES35.MemberExpression || stmt.expression.callee.object.type !== AST_NODE_TYPES35.CallExpression) {
                   return null;
                 }
                 const actual = stmt.expression.callee.object.arguments.at(0);
                 const expected = stmt.expression.arguments.at(0);
-                if (actual?.type === AST_NODE_TYPES36.MemberExpression && actual.property.type === AST_NODE_TYPES36.Identifier && expected) {
+                if (actual?.type === AST_NODE_TYPES35.MemberExpression && actual.property.type === AST_NODE_TYPES35.Identifier && expected) {
                   const propName2 = actual.property.name;
                   const valText = context.sourceCode.getText(expected);
                   return `${propName2}: ${valText}`;
@@ -7433,7 +7315,7 @@ var strict_test_assertions_default = ESLintUtils49.RuleCreator.withoutDocs({
         }
       }
       for (const statement of body) {
-        if (statement.type === AST_NODE_TYPES36.ExpressionStatement) {
+        if (statement.type === AST_NODE_TYPES35.ExpressionStatement) {
           const obj = getExpectObject(statement.expression);
           if (obj && currentObject && context.sourceCode.getText(obj) === context.sourceCode.getText(currentObject)) {
             sequence.push(statement);
@@ -7467,8 +7349,8 @@ var strict_test_assertions_default = ESLintUtils49.RuleCreator.withoutDocs({
 });
 
 // src/rules/no-async-callback-in-waitfor.ts
-import { AST_NODE_TYPES as AST_NODE_TYPES37, ESLintUtils as ESLintUtils50 } from "@typescript-eslint/utils";
-var no_async_callback_in_waitfor_default = ESLintUtils50.RuleCreator(
+import { AST_NODE_TYPES as AST_NODE_TYPES36, ESLintUtils as ESLintUtils49 } from "@typescript-eslint/utils";
+var no_async_callback_in_waitfor_default = ESLintUtils49.RuleCreator(
   (name) => `https://github.com/sarj-ai/standards/blob/main/packages/typescript/src/rules/${name}.ts`
 )({
   name: "no-async-callback-in-waitfor",
@@ -7489,9 +7371,9 @@ var no_async_callback_in_waitfor_default = ESLintUtils50.RuleCreator(
     }
     return {
       CallExpression(node) {
-        if (node.callee.type === AST_NODE_TYPES37.Identifier && node.callee.name === "waitFor") {
+        if (node.callee.type === AST_NODE_TYPES36.Identifier && node.callee.name === "waitFor") {
           const callback = node.arguments[0];
-          if (callback && (callback.type === AST_NODE_TYPES37.ArrowFunctionExpression || callback.type === AST_NODE_TYPES37.FunctionExpression) && callback.async) {
+          if (callback && (callback.type === AST_NODE_TYPES36.ArrowFunctionExpression || callback.type === AST_NODE_TYPES36.FunctionExpression) && callback.async) {
             context.report({
               node: callback,
               messageId: "noAsyncCallbackInWaitFor"
@@ -7503,6 +7385,183 @@ var no_async_callback_in_waitfor_default = ESLintUtils50.RuleCreator(
   }
 });
 
+// src/rules/no-hand-rolled-sleep.ts
+import { AST_NODE_TYPES as AST_NODE_TYPES37, ESLintUtils as ESLintUtils50 } from "@typescript-eslint/utils";
+var GLOBAL_OBJECTS2 = /* @__PURE__ */ new Set([
+  "globalThis",
+  "window",
+  "self",
+  "global"
+]);
+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 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 isSetTimeoutCallee(callee) {
+  if (callee.type === AST_NODE_TYPES37.Identifier) {
+    return callee.name === "setTimeout";
+  }
+  return callee.type === AST_NODE_TYPES37.MemberExpression && !callee.computed && callee.property.type === AST_NODE_TYPES37.Identifier && callee.property.name === "setTimeout" && callee.object.type === AST_NODE_TYPES37.Identifier && GLOBAL_OBJECTS2.has(callee.object.name);
+}
+function soleCall(fn) {
+  if (fn.body.type !== AST_NODE_TYPES37.BlockStatement) {
+    return fn.body.type === AST_NODE_TYPES37.CallExpression ? fn.body : null;
+  }
+  if (fn.body.body.length !== 1) {
+    return null;
+  }
+  const [only] = fn.body.body;
+  if (only?.type !== AST_NODE_TYPES37.ExpressionStatement) {
+    return null;
+  }
+  return only.expression.type === AST_NODE_TYPES37.CallExpression ? only.expression : null;
+}
+function isTimedDelay(delay) {
+  if (delay === void 0) {
+    return false;
+  }
+  if (delay.type === AST_NODE_TYPES37.Literal && typeof delay.value === "number") {
+    return delay.value !== 0;
+  }
+  return true;
+}
+function settlesWithoutValue(callback, name) {
+  if (callback.type === AST_NODE_TYPES37.Identifier) {
+    return callback.name === name;
+  }
+  if (callback.type !== AST_NODE_TYPES37.ArrowFunctionExpression && callback.type !== AST_NODE_TYPES37.FunctionExpression) {
+    return false;
+  }
+  const call = soleCall(callback);
+  return call !== null && call.arguments.length === 0 && call.callee.type === AST_NODE_TYPES37.Identifier && call.callee.name === name;
+}
+function rejectsInCallback(callback, name) {
+  if (callback.type === AST_NODE_TYPES37.Identifier) {
+    return callback.name === name;
+  }
+  if (callback.type !== AST_NODE_TYPES37.ArrowFunctionExpression && callback.type !== AST_NODE_TYPES37.FunctionExpression) {
+    return false;
+  }
+  const call = soleCall(callback);
+  return call !== null && call.callee.type === AST_NODE_TYPES37.Identifier && call.callee.name === name;
+}
+function parameterName(fn, index) {
+  const parameter = fn.params[index];
+  return parameter?.type === AST_NODE_TYPES37.Identifier ? parameter.name : null;
+}
+function isRaceArm(node) {
+  const array = node.parent;
+  if (array?.type !== AST_NODE_TYPES37.ArrayExpression) {
+    return false;
+  }
+  const call = array.parent;
+  return call?.type === AST_NODE_TYPES37.CallExpression && call.arguments[0] === array && call.callee.type === AST_NODE_TYPES37.MemberExpression && !call.callee.computed && call.callee.object.type === AST_NODE_TYPES37.Identifier && call.callee.object.name === "Promise" && call.callee.property.type === AST_NODE_TYPES37.Identifier && RACE_METHODS.has(call.callee.property.name);
+}
+var no_hand_rolled_sleep_default = ESLintUtils50.RuleCreator(
+  (name) => `https://github.com/sarj-ai/standards/blob/main/packages/typescript/src/rules/${name}.ts`
+)({
+  name: "no-hand-rolled-sleep",
+  meta: {
+    type: "problem",
+    docs: {
+      description: "Disallow hand-rolled promisified timers (`new Promise((r) => setTimeout(r, ms))`) and hand-rolled `Promise.race` timeout arms; the stdlib forms are cancellable, these are not."
+    },
+    schema: [
+      {
+        type: "object",
+        additionalProperties: false,
+        properties: {
+          allowIn: {
+            description: "Glob patterns for modules exempt from the rule (e.g. a single sanctioned `sleep` utility). Matched against the ABSOLUTE file path, so anchor with a `**/` prefix (e.g. `**/lib/sleep.ts`).",
+            type: "array",
+            items: { type: "string" }
+          },
+          checkClientModules: {
+            description: "Also report the sleep form in browser/React Native modules. Off by default: those bundles cannot import `node:timers/promises` and the web platform has no equivalent, so the fix is impossible to follow. Turn on only where every file can resolve `node:` builtins.",
+            type: "boolean"
+          }
+        }
+      }
+    ],
+    messages: {
+      handRolledSleep: 'Hand-rolled sleep: `new Promise((resolve) => setTimeout(resolve, ms))` cannot be cancelled, so an aborted request or a lost race still waits out the full delay. Use `import { setTimeout as sleep } from "node:timers/promises"` and pass `{ signal }`.',
+      handRolledTimeoutRace: "Hand-rolled timeout arm: when the other promise wins, this timer is never cleared and keeps the event loop alive until it fires. Use `AbortSignal.timeout(ms)` and pass the signal to the operation."
+    }
+  },
+  defaultOptions: [{}],
+  create(context, [optionsArg]) {
+    const { filename, sourceCode } = context;
+    if (isTestFile(filename) || isScriptFile(filename) || isGeneratedFile(filename, sourceCode.getText())) {
+      return {};
+    }
+    const allowIn = optionsArg?.allowIn ?? [];
+    if (allowIn.length > 0 && matchesAnyPattern3(filename, allowIn)) {
+      return {};
+    }
+    const checkClientModules = optionsArg?.checkClientModules ?? false;
+    function isClientModule() {
+      if (/\.[cm]?[jt]sx$/.test(filename)) {
+        return true;
+      }
+      const program = sourceCode.ast;
+      for (const statement of program.body) {
+        if (statement.type === AST_NODE_TYPES37.ExpressionStatement && statement.expression.type === AST_NODE_TYPES37.Literal && statement.expression.value === "use client") {
+          return true;
+        }
+        if (statement.type === AST_NODE_TYPES37.ImportDeclaration && typeof statement.source.value === "string" && CLIENT_ONLY_MODULES.test(statement.source.value)) {
+          return true;
+        }
+      }
+      return false;
+    }
+    let clientModule = null;
+    const reportsSleepHere = () => {
+      if (checkClientModules) {
+        return true;
+      }
+      clientModule ??= isClientModule();
+      return !clientModule;
+    };
+    return {
+      NewExpression(node) {
+        if (node.callee.type !== AST_NODE_TYPES37.Identifier || node.callee.name !== "Promise") {
+          return;
+        }
+        const executor = node.arguments[0];
+        if (executor?.type !== AST_NODE_TYPES37.ArrowFunctionExpression && executor?.type !== AST_NODE_TYPES37.FunctionExpression) {
+          return;
+        }
+        const call = soleCall(executor);
+        if (call === null || !isSetTimeoutCallee(call.callee)) {
+          return;
+        }
+        const [callback, delay] = call.arguments;
+        if (callback === void 0 || !isTimedDelay(delay)) {
+          return;
+        }
+        const resolveName = parameterName(executor, 0);
+        if (resolveName !== null && settlesWithoutValue(callback, resolveName)) {
+          if (reportsSleepHere()) {
+            context.report({ node, messageId: "handRolledSleep" });
+          }
+          return;
+        }
+        const rejectName = parameterName(executor, 1);
+        if (rejectName !== null && isRaceArm(node) && rejectsInCallback(callback, rejectName)) {
+          context.report({ node, messageId: "handRolledTimeoutRace" });
+        }
+      }
+    };
+  }
+});
+
 // src/rules/prefer-setup-file-mocks.ts
 import { AST_NODE_TYPES as AST_NODE_TYPES38, ESLintUtils as ESLintUtils51 } from "@typescript-eslint/utils";
 var prefer_setup_file_mocks_default = ESLintUtils51.RuleCreator(
@@ -7564,7 +7623,6 @@ var rules = {
   "no-unsafe-mock-casting": no_unsafe_mock_casting_default,
   "prefer-string-literal-union": prefer_string_literal_union_default,
   "prefer-zod-enum": prefer_zod_enum_default,
-  "primary-export-file-name": primary_export_file_name_default,
   "no-silent-promise-catch": no_silent_promise_catch_default,
   "require-fetch-timeout": require_fetch_timeout_default,
   "no-offset-pagination": no_offset_pagination_default,
@@ -7572,6 +7630,7 @@ var rules = {
   "no-repeated-string-literal": no_repeated_string_literal_default,
   "no-select-star": no_select_star_default,
   "no-sleep-in-test-body": no_sleep_in_test_body_default,
+  "no-hand-rolled-sleep": no_hand_rolled_sleep_default,
   "no-conditional-in-test": no_conditional_in_test_default,
   "prefer-constant-time-secret-compare": prefer_constant_time_secret_compare_default,
   "store-insert-requires-on-conflict": store_insert_requires_on_conflict_default,
@@ -7594,7 +7653,7 @@ var rules = {
 var plugin = {
   meta: {
     name: "@sarj/eslint-plugin",
-    version: "3.0.0"
+    version: "4.1.0"
   },
   rules,
   configs: {
@@ -7628,7 +7687,6 @@ var plugin = {
         "@sarj/no-cors-wildcard-with-credentials": "warn",
         "@sarj/no-secret-in-log": "warn",
         "@sarj/no-unsafe-mock-casting": "warn",
-        "@sarj/primary-export-file-name": "warn",
         "@sarj/prefer-string-literal-union": "warn",
         "@sarj/prefer-zod-enum": "warn",
         // Mined from 2y of PR review feedback + 5-repo code-smell audit (2026-07).
@@ -7642,6 +7700,10 @@ var plugin = {
         "@sarj/store-insert-requires-on-conflict": "warn",
         "@sarj/no-offset-pagination": "warn",
         "@sarj/no-select-star": "warn",
+        // Uncancellable hand-rolled timers. Verified against the shipped
+        // strict config (205 enabled rules) that nothing already reports this
+        // position; `unicorn` 72 has no promisified-timer rule at all.
+        "@sarj/no-hand-rolled-sleep": "warn",
         "@sarj/no-sleep-in-test-body": "warn",
         "@sarj/no-conditional-in-test": "warn",
         "@sarj/no-repeated-string-literal": "warn",
@@ -7658,7 +7720,8 @@ var plugin = {
         // Anti-comment-verbosity family (2026-07), from a 37,918-comment,
         // nine-repo measurement study. Each is a deletion-class finding, so each
         // was validated against pydantic / trio / attrs as well as the maintained
-        // repos: `no-restated-comment` 0 hits in bulbul and 4 in the three famous
+        // repos: `no-restated-comment` 0 hits in the flagship first-party
+        // repo and 4 in the three famous
         // corpora combined; `trailing-value-narration` 18 hits, 18 true
         // positives; `jsdoc-restates-signature` 36 hits, 0 measured false
         // positives, and it offers a suggestion rather than a `--fix` because a
@@ -7669,7 +7732,7 @@ var plugin = {
         // The TS half of SARJ057 (2026-07). Python has caught the
         // assertion-FREE test since 0.15.0 (SARJ043) and had no TS
         // counterpart, which is how `expect(true).toBe(true); // placeholder`
-        // survived in internal-automations: the file HAS an assertion.
+        // survived in a first-party repo: the file HAS an assertion.
         // Measured across 5,819 .ts/.tsx files (1,003 of them test files) in
         // six internal repos plus got / hono / swr / trpc: 3 hits, 3 true
         // positives, 0 false positives.
@@ -7718,7 +7781,6 @@ var plugin = {
         "@sarj/no-cors-wildcard-with-credentials": "error",
         "@sarj/no-secret-in-log": "error",
         "@sarj/no-unsafe-mock-casting": "error",
-        "@sarj/primary-export-file-name": "error",
         // Promoted to error 2026-07-25 — strict means strict (user directive).
         "@sarj/prefer-string-literal-union": "error",
         "@sarj/prefer-zod-enum": "error",
@@ -7730,6 +7792,10 @@ var plugin = {
         "@sarj/store-insert-requires-on-conflict": "error",
         "@sarj/no-offset-pagination": "error",
         "@sarj/no-select-star": "error",
+        // Uncancellable hand-rolled timers. Verified against the shipped
+        // strict config (205 enabled rules) that nothing already reports this
+        // position; `unicorn` 72 has no promisified-timer rule at all.
+        "@sarj/no-hand-rolled-sleep": "error",
         "@sarj/no-sleep-in-test-body": "error",
         "@sarj/no-conditional-in-test": "error",
         "@sarj/no-repeated-string-literal": "error",