@slip-stream-kit/eslint-plugin 0.11.12 → 0.11.16

package/dist/index.js

@@ -513,6 +513,408 @@ var componentFileOrder = {
   }
 };
 
+// src/utils/package-root.ts
+import fs from "node:fs";
+import path from "node:path";
+var CONFIG_FILENAME = "infra-kit.config.ts";
+var PACKAGE_MARKERS = [CONFIG_FILENAME, "package.json"];
+var REPO_MARKERS = ["pnpm-workspace.yaml"];
+var hasAnyMarker = (dir, markers) => {
+  return markers.some((marker) => {
+    return fs.existsSync(path.posix.join(dir, marker));
+  });
+};
+var rootCache = /* @__PURE__ */ new Map();
+var findUp = (startDir, markers) => {
+  let current = startDir;
+  while (!hasAnyMarker(current, markers)) {
+    const parent = path.posix.dirname(current);
+    if (parent === current) {
+      return null;
+    }
+    current = parent;
+  }
+  return current;
+};
+var findPackageRoot = (filename) => {
+  if (!path.posix.isAbsolute(filename)) {
+    return null;
+  }
+  const dir = path.posix.dirname(filename);
+  const cached = rootCache.get(dir);
+  if (cached !== void 0) {
+    return cached;
+  }
+  const root = findUp(dir, PACKAGE_MARKERS);
+  rootCache.set(dir, root);
+  return root;
+};
+var dirsUnderSrc = (packageRoot, filename) => {
+  const srcPrefix = `${packageRoot}/src/`;
+  if (!filename.startsWith(srcPrefix)) {
+    return null;
+  }
+  return filename.slice(srcPrefix.length).split("/").slice(0, -1);
+};
+var findRepoRoot = (packageRoot) => {
+  return findUp(packageRoot, REPO_MARKERS);
+};
+
+// ../config/dist/package-type.js
+import path2 from "node:path";
+var PACKAGE_TYPES = ["frontend", "backend", "lib", "e2e", "mobile"];
+var APP_DIRECTORY_TYPES = {
+  ui: "frontend",
+  api: "backend",
+  tests: "e2e"
+};
+var MOBILE_BASENAME = "mobile-app";
+var DEPENDENCY_SIGNALS = [
+  { type: "e2e", packages: ["@playwright/test"] },
+  { type: "mobile", packages: ["@capacitor/core", "@capacitor/cli"] },
+  // `aws-lambda` / `@types/aws-lambda` are deliberately NOT signals: every consumer backend already
+  // lives at `apps/<app>/api` (row 2), while the only packages those two deps would catch are
+  // libraries (`packages/lib-core` in both consumers, the infra-kit CLI itself) — a lambda types
+  // dependency alone never means backend, exactly as `react` alone never means frontend.
+  { type: "backend", packages: ["serverless"] }
+];
+var fromDirectory = (packageDir, repoRoot) => {
+  const segments = path2.relative(repoRoot, packageDir).split(path2.sep).filter((segment) => {
+    return segment !== "" && segment !== ".";
+  });
+  const [first, , third] = segments;
+  if (segments.length === 3 && first === "apps" && third !== void 0) {
+    const appType = APP_DIRECTORY_TYPES[third];
+    if (appType) return appType;
+  }
+  return segments.at(-1) === MOBILE_BASENAME ? "mobile" : null;
+};
+var fromDependencies = (pkgJson) => {
+  const deps = /* @__PURE__ */ new Set([
+    ...Object.keys(pkgJson.dependencies ?? {}),
+    ...Object.keys(pkgJson.devDependencies ?? {}),
+    ...Object.keys(pkgJson.peerDependencies ?? {})
+  ]);
+  for (const signal of DEPENDENCY_SIGNALS) {
+    if (signal.packages.some((name) => {
+      return deps.has(name);
+    }))
+      return signal.type;
+  }
+  const isViteReactApp = deps.has("vite") && deps.has("react") && Boolean(pkgJson.scripts?.dev);
+  return isViteReactApp ? "frontend" : null;
+};
+var detectPackageType = ({
+  packageDir,
+  repoRoot,
+  pkgJson,
+  declaredType
+}) => {
+  return declaredType ?? fromDirectory(packageDir, repoRoot) ?? fromDependencies(pkgJson) ?? "lib";
+};
+
+// src/utils/package-type-reader.ts
+import fs2 from "node:fs";
+import path3 from "node:path";
+var BLOCK_COMMENT = /\/\*[\s\S]*?\*\//g;
+var FULL_LINE_COMMENT = /^[ \t]*\/\/.*$/gm;
+var DECLARED_TYPE = new RegExp(`(?:^|[\\s{,])type:\\s*['"](${PACKAGE_TYPES.join("|")})['"]`, "m");
+var readDeclaredType = (text) => {
+  const stripped = text.replace(BLOCK_COMMENT, "").replace(FULL_LINE_COMMENT, "");
+  const literal = DECLARED_TYPE.exec(stripped)?.[1];
+  return PACKAGE_TYPES.find((candidate) => {
+    return candidate === literal;
+  });
+};
+var typeCache = /* @__PURE__ */ new Map();
+var configMtimeMs = (configPath) => {
+  try {
+    return fs2.statSync(configPath).mtimeMs;
+  } catch {
+    return -1;
+  }
+};
+var readManifest = (manifestPath) => {
+  try {
+    return JSON.parse(fs2.readFileSync(manifestPath, "utf8"));
+  } catch {
+    return {};
+  }
+};
+var resolvePackageType = (packageRoot) => {
+  const configPath = path3.posix.join(packageRoot, CONFIG_FILENAME);
+  const mtimeMs = configMtimeMs(configPath);
+  const hit = typeCache.get(packageRoot);
+  if (hit !== void 0 && hit.mtimeMs === mtimeMs) {
+    return hit.type;
+  }
+  const declaredType = mtimeMs >= 0 ? readDeclaredType(fs2.readFileSync(configPath, "utf8")) : void 0;
+  const type = detectPackageType({
+    packageDir: packageRoot,
+    repoRoot: findRepoRoot(packageRoot) ?? packageRoot,
+    pkgJson: readManifest(path3.posix.join(packageRoot, "package.json")),
+    declaredType
+  });
+  typeCache.set(packageRoot, { mtimeMs, type });
+  return type;
+};
+
+// src/rules/e2e-file-layout/e2e-file-layout.ts
+var TEST_FILE = /\.(?:test|spec)\.[cm]?[jt]sx?$/;
+var LEGACY_TEST_SUFFIX = /\.test(\.[cm]?[jt]sx?)$/;
+var SPEC_LAYERS = /* @__PURE__ */ new Set(["tests", "visual"]);
+var SUBFOLDER_BY_SUFFIX = [
+  [/\.(?:page|component)\.[cm]?[jt]sx?$/, "pages"],
+  [/\.fixture\.[cm]?[jt]sx?$/, "fixtures"],
+  [/\.mock\.[cm]?[jt]sx?$/, "mocks"],
+  [/\.data\.[cm]?[jt]sx?$/, "data"]
+];
+var subfolderFor = (basename) => {
+  const match = SUBFOLDER_BY_SUFFIX.find(([pattern]) => {
+    return pattern.test(basename);
+  });
+  return match ? match[1] : "lib";
+};
+var specViolation = (dirs, basename) => {
+  if (LEGACY_TEST_SUFFIX.test(basename)) {
+    return {
+      messageId: "legacyTestSuffix",
+      data: { basename, target: basename.replace(LEGACY_TEST_SUFFIX, ".spec$1") }
+    };
+  }
+  const [layer, domain] = dirs;
+  if (layer === void 0 || !SPEC_LAYERS.has(layer) || domain === void 0) {
+    return { messageId: "specOutsideDomain", data: { basename, path: ["src", ...dirs, basename].join("/") } };
+  }
+  if (dirs.length > 2) {
+    return {
+      messageId: "nestedSpec",
+      data: { basename, path: ["src", ...dirs, basename].join("/"), target: `src/${layer}/${domain}/${basename}` }
+    };
+  }
+  return null;
+};
+var supportViolation = (dirs, basename) => {
+  const [layer, domain] = dirs;
+  if (dirs.length !== 2 || layer === void 0 || !SPEC_LAYERS.has(layer) || domain === void 0) {
+    return null;
+  }
+  const subfolder = subfolderFor(basename);
+  return {
+    messageId: "supportInDomainRoot",
+    data: { basename, domain, subfolder, target: `src/${layer}/${domain}/${subfolder}/${basename}` }
+  };
+};
+var findViolation = (filename, ignore) => {
+  if (ignore.length > 0 && matchesAnyGlob(filename, ignore)) {
+    return null;
+  }
+  const packageRoot = findPackageRoot(filename);
+  if (packageRoot === null || resolvePackageType(packageRoot) !== "e2e") {
+    return null;
+  }
+  const dirs = dirsUnderSrc(packageRoot, filename);
+  if (dirs === null) {
+    return null;
+  }
+  const basename = filename.slice(filename.lastIndexOf("/") + 1);
+  return TEST_FILE.test(basename) ? specViolation(dirs, basename) : supportViolation(dirs, basename);
+};
+var e2eFileLayout = {
+  meta: {
+    type: "problem",
+    docs: {
+      description: "Require e2e packages to keep `*.spec.ts` files at the root of `src/tests/<domain>/` and every other file in a domain subfolder.",
+      recommended: true,
+      url: "https://github.com/ArthurSaenz/infra-kit/tree/main/apps/infra-kit/eslint-plugin#e2e-file-layout"
+    },
+    schema: [
+      {
+        type: "object",
+        properties: {
+          ignore: {
+            type: "array",
+            items: { type: "string" },
+            description: "Optional globs; the rule is skipped for matching files."
+          }
+        },
+        additionalProperties: false
+      }
+    ],
+    messages: {
+      legacyTestSuffix: "`{{basename}}` uses `.test`. Rename it to `{{target}}` \u2014 every Playwright spec in an e2e package is `*.spec.ts`.",
+      specOutsideDomain: "`{{path}}` is a spec outside a domain folder. Move it into `src/tests/<domain>/`, where `<domain>` is the business domain it covers.",
+      nestedSpec: "`{{path}}` nests a spec below its domain folder. Move it to `{{target}}`, or split the domain into two sibling domains if it holds too many specs.",
+      supportInDomainRoot: "`{{basename}}` sits in the root of domain `{{domain}}`, which holds only `*.spec.ts`. Move it to `{{target}}`."
+    }
+  },
+  create(context) {
+    const options = context.options[0] ?? {};
+    const violation = findViolation(context.filename.split("\\").join("/"), options.ignore ?? []);
+    if (violation === null) {
+      return {};
+    }
+    return {
+      // Reported on Program: the violation is the file's location, not any node inside it.
+      Program(program) {
+        context.report({ node: program, messageId: violation.messageId, data: violation.data });
+      }
+    };
+  }
+};
+
+// src/utils/playwright-call.ts
+var TEST_MODIFIERS = /* @__PURE__ */ new Set(["only", "skip", "fixme", "fail"]);
+var DESCRIBE_MODIFIERS = /* @__PURE__ */ new Set(["only", "skip", "fixme", "serial", "parallel"]);
+var calleeNames = (callee) => {
+  if (callee.type === "Identifier") {
+    return [callee.name];
+  }
+  if (callee.type !== "MemberExpression" || callee.computed || callee.property.type !== "Identifier") {
+    return null;
+  }
+  const head = calleeNames(callee.object);
+  return head === null ? null : [...head, callee.property.name];
+};
+var playwrightCallKind = (node) => {
+  const names = calleeNames(node.callee);
+  if (names === null || names[0] !== "test") {
+    return null;
+  }
+  const [, second, ...rest] = names;
+  if (second === void 0) {
+    return "test";
+  }
+  if (second === "describe") {
+    const isDescribe = rest.every((name) => {
+      return DESCRIBE_MODIFIERS.has(name);
+    });
+    return isDescribe ? "describe" : null;
+  }
+  return rest.length === 0 && TEST_MODIFIERS.has(second) ? "test" : null;
+};
+var detailsArgument = (node) => {
+  const details = node.arguments[1];
+  return node.arguments.length >= 3 && details?.type === "ObjectExpression" ? details : null;
+};
+var staticTitle = (node) => {
+  const title = node.arguments[0];
+  if (title?.type === "Literal" && typeof title.value === "string") {
+    return title.value;
+  }
+  if (title?.type === "TemplateLiteral" && title.expressions.length === 0) {
+    return title.quasis[0]?.value.cooked ?? null;
+  }
+  return null;
+};
+var isInE2ePackage = (context) => {
+  const packageRoot = findPackageRoot(context.filename.split("\\").join("/"));
+  return packageRoot !== null && resolvePackageType(packageRoot) === "e2e";
+};
+
+// src/rules/e2e-test-tags/e2e-test-tags.ts
+var DEFAULT_ALLOWED_TAGS = ["@smoke", "@readonly", "@mocked", "@slow"];
+var tagValue = (details) => {
+  for (const property of details.properties) {
+    if (property.type === "Property" && !property.computed && property.key.type === "Identifier" && property.key.name === "tag") {
+      return property.value;
+    }
+  }
+  return null;
+};
+var literalTags = (value) => {
+  const entries = value.type === "ArrayExpression" ? value.elements : [value];
+  return entries.flatMap((entry) => {
+    return entry?.type === "Literal" && typeof entry.value === "string" ? [{ tag: entry.value, node: entry }] : [];
+  });
+};
+var e2eTestTags = {
+  meta: {
+    type: "problem",
+    docs: {
+      description: "Restrict Playwright test and describe tags in e2e packages to an allowed set.",
+      recommended: true,
+      url: "https://github.com/ArthurSaenz/infra-kit/tree/main/apps/infra-kit/eslint-plugin#e2e-test-tags"
+    },
+    schema: [
+      {
+        type: "object",
+        properties: {
+          allowed: {
+            type: "array",
+            items: { type: "string", pattern: "^@" },
+            uniqueItems: true,
+            description: "The only tags allowed; defaults to @smoke, @readonly, @mocked, @slow."
+          }
+        },
+        additionalProperties: false
+      }
+    ],
+    messages: {
+      unknownTag: "Tag `{{tag}}` is not an allowed e2e tag. Use one of {{allowed}}; browsers, devices and environments are Playwright projects, not tags."
+    }
+  },
+  create(context) {
+    if (!isInE2ePackage(context)) {
+      return {};
+    }
+    const options = context.options[0] ?? {};
+    const allowed = new Set(options.allowed ?? DEFAULT_ALLOWED_TAGS);
+    const allowedList = [...allowed].map((tag) => {
+      return `\`${tag}\``;
+    }).join(", ");
+    return {
+      CallExpression(node) {
+        const details = playwrightCallKind(node) === null ? null : detailsArgument(node);
+        const value = details === null ? null : tagValue(details);
+        if (value === null) {
+          return;
+        }
+        for (const { tag, node: tagNode } of literalTags(value)) {
+          if (!allowed.has(tag)) {
+            context.report({ node: tagNode, messageId: "unknownTag", data: { tag, allowed: allowedList } });
+          }
+        }
+      }
+    };
+  }
+};
+
+// src/rules/e2e-test-title/e2e-test-title.ts
+var SHOULD_PREFIX = /^should\s+/i;
+var e2eTestTitle = {
+  meta: {
+    type: "suggestion",
+    docs: {
+      description: "Require e2e test titles to state the behaviour directly, without a leading `should`.",
+      recommended: true,
+      url: "https://github.com/ArthurSaenz/infra-kit/tree/main/apps/infra-kit/eslint-plugin#e2e-test-title"
+    },
+    schema: [],
+    messages: {
+      shouldPrefix: 'Test title "{{title}}" starts with `should`. State the behaviour and its observable outcome directly: "{{suggested}}".'
+    }
+  },
+  create(context) {
+    if (!isInE2ePackage(context)) {
+      return {};
+    }
+    return {
+      CallExpression(node) {
+        const title = playwrightCallKind(node) === "test" ? staticTitle(node) : null;
+        if (title === null || !SHOULD_PREFIX.test(title)) {
+          return;
+        }
+        context.report({
+          node: node.arguments[0] ?? node,
+          messageId: "shouldPrefix",
+          data: { title, suggested: title.replace(SHOULD_PREFIX, "") }
+        });
+      }
+    };
+  }
+};
+
 // src/rules/max-components-per-file/max-components-per-file.ts
 var DEFAULT_MAX_COMPONENTS = 4;
 var ANONYMOUS_NAME2 = "component";
@@ -1001,163 +1403,18 @@ var maxJsxReturnSize = {
   }
 };
 
-// src/utils/package-root.ts
-import fs from "node:fs";
-import path from "node:path";
-var CONFIG_FILENAME = "infra-kit.config.ts";
-var PACKAGE_MARKERS = [CONFIG_FILENAME, "package.json"];
-var REPO_MARKERS = ["pnpm-workspace.yaml"];
-var hasAnyMarker = (dir, markers) => {
-  return markers.some((marker) => {
-    return fs.existsSync(path.posix.join(dir, marker));
-  });
-};
-var rootCache = /* @__PURE__ */ new Map();
-var findUp = (startDir, markers) => {
-  let current = startDir;
-  while (!hasAnyMarker(current, markers)) {
-    const parent = path.posix.dirname(current);
-    if (parent === current) {
-      return null;
-    }
-    current = parent;
-  }
-  return current;
-};
-var findPackageRoot = (filename) => {
-  if (!path.posix.isAbsolute(filename)) {
-    return null;
-  }
-  const dir = path.posix.dirname(filename);
-  const cached = rootCache.get(dir);
-  if (cached !== void 0) {
-    return cached;
-  }
-  const root = findUp(dir, PACKAGE_MARKERS);
-  rootCache.set(dir, root);
-  return root;
-};
-var dirsUnderSrc = (packageRoot, filename) => {
-  const srcPrefix = `${packageRoot}/src/`;
-  if (!filename.startsWith(srcPrefix)) {
-    return null;
-  }
-  return filename.slice(srcPrefix.length).split("/").slice(0, -1);
-};
-var findRepoRoot = (packageRoot) => {
-  return findUp(packageRoot, REPO_MARKERS);
-};
-
-// ../config/dist/package-type.js
-import path2 from "node:path";
-var PACKAGE_TYPES = ["frontend", "backend", "lib", "e2e", "mobile"];
-var APP_DIRECTORY_TYPES = {
-  ui: "frontend",
-  api: "backend",
-  tests: "e2e"
-};
-var MOBILE_BASENAME = "mobile-app";
-var DEPENDENCY_SIGNALS = [
-  { type: "e2e", packages: ["@playwright/test"] },
-  { type: "mobile", packages: ["@capacitor/core", "@capacitor/cli"] },
-  // `aws-lambda` / `@types/aws-lambda` are deliberately NOT signals: every consumer backend already
-  // lives at `apps/<app>/api` (row 2), while the only packages those two deps would catch are
-  // libraries (`packages/lib-core` in both consumers, the infra-kit CLI itself) — a lambda types
-  // dependency alone never means backend, exactly as `react` alone never means frontend.
-  { type: "backend", packages: ["serverless"] }
-];
-var fromDirectory = (packageDir, repoRoot) => {
-  const segments = path2.relative(repoRoot, packageDir).split(path2.sep).filter((segment) => {
-    return segment !== "" && segment !== ".";
-  });
-  const [first, , third] = segments;
-  if (segments.length === 3 && first === "apps" && third !== void 0) {
-    const appType = APP_DIRECTORY_TYPES[third];
-    if (appType) return appType;
-  }
-  return segments.at(-1) === MOBILE_BASENAME ? "mobile" : null;
-};
-var fromDependencies = (pkgJson) => {
-  const deps = /* @__PURE__ */ new Set([
-    ...Object.keys(pkgJson.dependencies ?? {}),
-    ...Object.keys(pkgJson.devDependencies ?? {}),
-    ...Object.keys(pkgJson.peerDependencies ?? {})
-  ]);
-  for (const signal of DEPENDENCY_SIGNALS) {
-    if (signal.packages.some((name) => {
-      return deps.has(name);
-    }))
-      return signal.type;
-  }
-  const isViteReactApp = deps.has("vite") && deps.has("react") && Boolean(pkgJson.scripts?.dev);
-  return isViteReactApp ? "frontend" : null;
-};
-var detectPackageType = ({
-  packageDir,
-  repoRoot,
-  pkgJson,
-  declaredType
-}) => {
-  return declaredType ?? fromDirectory(packageDir, repoRoot) ?? fromDependencies(pkgJson) ?? "lib";
-};
-
-// src/utils/package-type-reader.ts
-import fs2 from "node:fs";
-import path3 from "node:path";
-var BLOCK_COMMENT = /\/\*[\s\S]*?\*\//g;
-var FULL_LINE_COMMENT = /^[ \t]*\/\/.*$/gm;
-var DECLARED_TYPE = new RegExp(`(?:^|[\\s{,])type:\\s*['"](${PACKAGE_TYPES.join("|")})['"]`, "m");
-var readDeclaredType = (text) => {
-  const stripped = text.replace(BLOCK_COMMENT, "").replace(FULL_LINE_COMMENT, "");
-  const literal = DECLARED_TYPE.exec(stripped)?.[1];
-  return PACKAGE_TYPES.find((candidate) => {
-    return candidate === literal;
-  });
-};
-var typeCache = /* @__PURE__ */ new Map();
-var configMtimeMs = (configPath) => {
-  try {
-    return fs2.statSync(configPath).mtimeMs;
-  } catch {
-    return -1;
-  }
-};
-var readManifest = (manifestPath) => {
-  try {
-    return JSON.parse(fs2.readFileSync(manifestPath, "utf8"));
-  } catch {
-    return {};
-  }
-};
-var resolvePackageType = (packageRoot) => {
-  const configPath = path3.posix.join(packageRoot, CONFIG_FILENAME);
-  const mtimeMs = configMtimeMs(configPath);
-  const hit = typeCache.get(packageRoot);
-  if (hit !== void 0 && hit.mtimeMs === mtimeMs) {
-    return hit.type;
-  }
-  const declaredType = mtimeMs >= 0 ? readDeclaredType(fs2.readFileSync(configPath, "utf8")) : void 0;
-  const type = detectPackageType({
-    packageDir: packageRoot,
-    repoRoot: findRepoRoot(packageRoot) ?? packageRoot,
-    pkgJson: readManifest(path3.posix.join(packageRoot, "package.json")),
-    declaredType
-  });
-  typeCache.set(packageRoot, { mtimeMs, type });
-  return type;
-};
-
 // src/rules/package-structure/package-structure.ts
 var DEFAULT_ENTRIES = {
   frontend: {
-    layers: ["app", "features", "lib", "components", "pages", "routes"],
+    // `__tests__` holds the tests of files that sit directly in `src/` (see `test-location`).
+    layers: ["app", "features", "lib", "components", "pages", "routes", "__tests__"],
     segments: {
       "features/*": ["containers", "components", "services", "__stories__", "__tests__"]
     },
     skill: "/infra-kit:fe-architect"
   },
   backend: {
-    layers: ["controllers", "services", "lib", "config"],
+    layers: ["controllers", "services", "lib", "config", "__tests__"],
     segments: {
       "services/*": ["__tests__"]
     },
@@ -1166,9 +1423,11 @@ var DEFAULT_ENTRIES = {
     skill: "/infra-kit:be-architect"
   },
   e2e: {
-    layers: ["tests", "pages", "config", "lib", "components", "mocks", "fixtures"],
+    layers: ["tests", "visual", "setup", "pages", "config", "lib", "components", "mocks", "fixtures"],
+    // A domain folder's root holds only specs; its support files always sit in one of these.
     segments: {
-      "tests/*": ["fixtures", "data", "mocks"]
+      "tests/*": ["pages", "fixtures", "mocks", "data", "lib"],
+      "visual/*": ["pages", "fixtures", "mocks", "data", "lib"]
     },
     skill: "/infra-kit:e2e-architect"
   }
@@ -1227,7 +1486,7 @@ var findSegmentViolation = (dirs, entry) => {
   }
   return null;
 };
-var findViolation = (dirs, entry) => {
+var findViolation2 = (dirs, entry) => {
   const layer = dirs[0];
   if (!entry.layers.includes(layer)) {
     return { messageId: "unknownLayer", name: layer, scope: "src", allowed: entry.layers };
@@ -1249,7 +1508,7 @@ var inspect = (filename, options) => {
     return null;
   }
   assertSegmentKeysNameLayers(type, entry);
-  const violation = findViolation(dirs, entry);
+  const violation = findViolation2(dirs, entry);
   return violation === null ? null : { violation, type, entry };
 };
 var packageStructure = {
@@ -2104,6 +2363,99 @@ var requireJsdocExample = {
   }
 };
 
+// src/rules/test-location/test-location.ts
+var TEST_FILE2 = /\.(?:test|spec)\.[cm]?[jt]sx?$/;
+var SPEC_SUFFIX = /\.spec(\.[cm]?[jt]sx?)$/;
+var TESTS_DIR = "__tests__";
+var FEATURES_DIR = "features";
+var fromSrc = (dirs) => {
+  const srcIndex = dirs.lastIndexOf("src");
+  return srcIndex >= 0 ? dirs.slice(srcIndex) : dirs.slice(-1);
+};
+var featureRoot = (dirs) => {
+  const srcIndex = dirs.lastIndexOf("src");
+  const featuresIndex = dirs.lastIndexOf(FEATURES_DIR);
+  return srcIndex >= 0 && featuresIndex > srcIndex && featuresIndex + 1 < dirs.length ? dirs.slice(0, featuresIndex + 2) : null;
+};
+var locationViolation = (dirs, basename) => {
+  const feature = featureRoot(dirs);
+  if (feature !== null) {
+    if (dirs[feature.length] === TESTS_DIR) {
+      return null;
+    }
+    return {
+      messageId: "outsideFeatureTestsDir",
+      data: { basename, target: [...fromSrc(feature), TESTS_DIR, basename].join("/") }
+    };
+  }
+  if (dirs.includes(TESTS_DIR)) {
+    return null;
+  }
+  return {
+    messageId: "outsideTestsDir",
+    data: { basename, target: [...fromSrc(dirs), TESTS_DIR, basename].join("/") }
+  };
+};
+var findViolations = (filename, ignore) => {
+  if (!TEST_FILE2.test(filename) || ignore.length > 0 && matchesAnyGlob(filename, ignore)) {
+    return [];
+  }
+  const packageRoot = findPackageRoot(filename);
+  if (packageRoot !== null && resolvePackageType(packageRoot) === "e2e") {
+    return [];
+  }
+  const dirs = filename.split("/");
+  const basename = dirs.pop();
+  const location = locationViolation(dirs, basename);
+  const suffix = SPEC_SUFFIX.test(basename) ? { messageId: "specSuffix", data: { basename, target: basename.replace(SPEC_SUFFIX, ".test$1") } } : null;
+  return [location, suffix].filter((violation) => {
+    return violation !== null;
+  });
+};
+var testLocation = {
+  meta: {
+    type: "problem",
+    docs: {
+      description: "Require unit tests to be `*.test.*` files in a `__tests__/` folder beside the code they test \u2014 the feature root\u2019s inside a frontend feature.",
+      recommended: true,
+      url: "https://github.com/ArthurSaenz/infra-kit/tree/main/apps/infra-kit/eslint-plugin#test-location"
+    },
+    schema: [
+      {
+        type: "object",
+        properties: {
+          ignore: {
+            type: "array",
+            items: { type: "string" },
+            description: "Optional globs; the rule is skipped for matching files."
+          }
+        },
+        additionalProperties: false
+      }
+    ],
+    messages: {
+      outsideTestsDir: "`{{basename}}` sits next to its source. Move it to `{{target}}` \u2014 tests live in a `__tests__/` folder beside the code they test.",
+      outsideFeatureTestsDir: "`{{basename}}` is a feature test outside the feature root. Move it to `{{target}}` \u2014 a feature keeps all its tests in one `__tests__/` at its root.",
+      specSuffix: "`{{basename}}` uses `.spec`. Rename it to `{{target}}` \u2014 unit tests are `*.test.*`; `.spec` belongs to Playwright specs in an e2e package."
+    }
+  },
+  create(context) {
+    const options = context.options[0] ?? {};
+    const violations = findViolations(context.filename.split("\\").join("/"), options.ignore ?? []);
+    if (violations.length === 0) {
+      return {};
+    }
+    return {
+      // Reported on Program: the violation is the file's location, not any node inside it.
+      Program(program) {
+        for (const violation of violations) {
+          context.report({ node: program, messageId: violation.messageId, data: violation.data });
+        }
+      }
+    };
+  }
+};
+
 // src/rules/index.ts
 var rules = {
   "props-destructuring-newline": propsDestructuringNewline,
@@ -2118,7 +2470,11 @@ var rules = {
   "max-jsdoc-summary-lines": maxJsdocSummaryLines,
   "require-component-stories": requireComponentStories,
   "require-jsdoc-example": requireJsdocExample,
-  "package-structure": packageStructure
+  "package-structure": packageStructure,
+  "test-location": testLocation,
+  "e2e-file-layout": e2eFileLayout,
+  "e2e-test-tags": e2eTestTags,
+  "e2e-test-title": e2eTestTitle
 };
 
 // src/index.ts
@@ -2126,7 +2482,7 @@ var PLUGIN_NAME = "@wl";
 var plugin = {
   meta: {
     name: "@wl/eslint-plugin",
-    version: "0.11.12"
+    version: "0.11.16"
   },
   rules,
   configs: {}
@@ -2215,6 +2571,30 @@ plugin.configs.recommended = [
     rules: {
       [`${PLUGIN_NAME}/package-structure`]: "error"
     }
+  },
+  // Scoped by filename, so it never runs on non-test files. e2e packages are exempt inside the rule
+  // (by package type); `*.e2e.test.*` covers e2e suites that sit in a package of another type.
+  {
+    files: ["**/*.{test,spec}.{ts,tsx,js,jsx,mts,cts,mjs,cjs}"],
+    plugins: {
+      [PLUGIN_NAME]: plugin
+    },
+    rules: {
+      [`${PLUGIN_NAME}/test-location`]: ["error", { ignore: ["**/*.e2e.test.*"] }]
+    }
+  },
+  // The e2e rules gate themselves on the package type, so a repo-wide glob costs one cached type
+  // lookup per file elsewhere.
+  {
+    files: ["**/*.{ts,tsx,js,jsx,mts,cts,mjs,cjs}"],
+    plugins: {
+      [PLUGIN_NAME]: plugin
+    },
+    rules: {
+      [`${PLUGIN_NAME}/e2e-file-layout`]: "error",
+      [`${PLUGIN_NAME}/e2e-test-tags`]: "error",
+      [`${PLUGIN_NAME}/e2e-test-title`]: "error"
+    }
   }
 ];
 var meta = plugin.meta;