@cplieger/deadset-ts 8.0.0-dev.15 → 8.0.0-dev.16

package/src/{convention-rows.ts → entries/convention-rows.ts}

@@ -7,6 +7,17 @@
  * directory one of the row's moves resolves to.
  */
 
+import { braced, MODULE_EXTENSIONS } from "../extensions.ts";
+import {
+  AVA_6,
+  AVA_8,
+  JEST_29,
+  JEST_30,
+  MOCHA_10,
+  MOCHA_12,
+  type TestRunner,
+} from "./test-runners.ts";
+
 /** A call whose first argument is the object a property is read from. */
 export interface OptionsCall {
   /** The module specifier the configuration file imports the callee from. */
@@ -17,7 +28,11 @@ export interface OptionsCall {
 
 /** One configuration property, and the configuration files it is read from. */
 export interface MoveReading {
-  /** The property's path through nested object literals, its keys joined by `.`. */
+  /**
+   * The property's path through nested object literals, its keys joined by `.`; in a
+   * test-file property a `*` key stands for every element of an array and every member of
+   * an object, each read as an object of its own.
+   */
   readonly property: string;
   /** Globs naming the configuration files, matched in the manifest's directory alone. */
   readonly files: readonly string[];
@@ -79,6 +94,28 @@ export interface TestFileReading extends MoveReading {
   readonly roots: readonly string[];
 }
 
+/**
+ * One configuration's test directory and test-file patterns, whose matching files the
+ * runner runs as tests. Each element of the projects property is read the same way, a
+ * member it does not write taken from the configuration's own.
+ */
+export interface TestDirectoryReading {
+  /** Globs naming the configuration files, matched in the manifest's directory alone. */
+  readonly files: readonly string[];
+  /** The property naming the directory, read against the configuration file's directory. */
+  readonly directory: string;
+  /**
+   * The property naming the patterns, each matched as Playwright matches one: anywhere
+   * below the directory, so a pattern gains a leading `**` segment unless it starts with
+   * one, and without regard to case.
+   */
+  readonly match: string;
+  /** The pattern that holds where no object names one. */
+  readonly defaultMatch: string;
+  /** The property listing the projects. */
+  readonly projects: string;
+}
+
 /** One member of the declaring `package.json` whose strings name the tool's entries. */
 export interface ManifestEntryKey {
   /** The member's path through nested objects, its keys joined by `.`, a `*` key standing for every member. */
@@ -129,6 +166,10 @@ export interface ConventionRow {
   readonly selections?: readonly MoveReading[];
   /** The properties whose strings name a file the test runner loads beside the tests, a test file. */
   readonly testFiles?: readonly TestFileReading[];
+  /** The configurations whose test directory and patterns name the test files the runner runs. */
+  readonly testDirectories?: readonly TestDirectoryReading[];
+  /** The reader of the files the row's test runner runs, from its configuration and the manifest's scripts. */
+  readonly testRunner?: TestRunner;
   /**
    * The members whose strings name a package the tool loads: the package itself, a
    * subpath of it, or the package followed by `:` and a name.
@@ -146,7 +187,7 @@ export interface ConventionRow {
 
 const SCRIPT = "{js,jsx,ts,tsx}";
 const MODULE = "{js,mjs,ts,mts}";
-const ANY_MODULE = "{js,mjs,cjs,ts,mts,cts}";
+const ANY_MODULE = braced(MODULE_EXTENSIONS);
 const VITE_CONFIG = `vite.config.${ANY_MODULE}`;
 /** The legacy configuration files of ESLint: JSON, YAML or a CommonJS module. */
 const ESLINTRC = [".eslintrc", ".eslintrc.json", ".eslintrc.{yml,yaml}", ".eslintrc.{js,cjs}"];
@@ -195,6 +236,64 @@ const VITEST_CONFIG = `{vitest,vite}.config.${ANY_MODULE}`;
  */
 const VITEST_ROOTS = ["test.root", "root"] as const;
 
+/** The members of a Vitest configuration's `test` object that name setup files. */
+const VITEST_SETUP = ["setupFiles", "globalSetup"] as const;
+
+/** Vitest's workspace files, which Vitest 4 no longer reads (https://vitest.dev/guide/workspace). */
+const VITEST_WORKSPACE = `{vitest.workspace,vitest.projects}.${ANY_MODULE}`;
+
+/**
+ * The Vitest row over one range: its configuration's setup files, those of each inline
+ * project of `test.projects`, and, where `workspace`, the workspace file with the setup
+ * files of each inline project it lists.
+ */
+function vitestRow(range: string, workspace: boolean): ConventionRow {
+  const inline = (each: string, files: string): readonly TestFileReading[] =>
+    VITEST_SETUP.map((member) => ({
+      property: `${each}.test.${member}`,
+      files: [files],
+      roots: VITEST_ROOTS,
+    }));
+  return {
+    name: "vitest",
+    package: "vitest",
+    range,
+    entries: [
+      `**/{vitest,vite}.config.${ANY_MODULE}`,
+      `**/{vitest,vite}.config.*.${ANY_MODULE}`,
+      `**/{vitest,vite}.*.config.${ANY_MODULE}`,
+      ...(workspace ? [VITEST_WORKSPACE] : []),
+    ],
+    moves: [],
+    shortNames: [
+      {
+        property: "test.coverage.provider",
+        files: [VITEST_CONFIG],
+        package: "@vitest/coverage-{}",
+      },
+    ],
+    selections: [
+      { property: "test.coverage.include", files: [VITEST_CONFIG] },
+      { property: "test.coverage.exclude", files: [VITEST_CONFIG] },
+    ],
+    testFiles: [
+      ...VITEST_SETUP.map((member) => ({
+        property: `test.${member}`,
+        files: [VITEST_CONFIG],
+        roots: VITEST_ROOTS,
+      })),
+      ...inline("test.projects.*", VITEST_CONFIG),
+      ...(workspace ? inline("*", VITEST_WORKSPACE) : []),
+    ],
+  };
+}
+
+const PLAYWRIGHT_CONFIG = `playwright.config.${ANY_MODULE}`;
+
+/** Playwright's own test-file pattern (https://playwright.dev/docs/api/class-testconfig#test-config-test-match). */
+const PLAYWRIGHT_TEST_MATCH =
+  "**/*.{spec,test}.{js,ts,jsx,tsx,cjs,cts,cjsx,ctsx,mjs,mts,mjsx,mtsx}";
+
 /** The entry files of an Angular CLI project, at the workspace root or below `projects`. */
 const ANGULAR_ENTRIES = [
   "src/{main,main.server,server,polyfills,test}.ts",
@@ -305,6 +404,22 @@ export const CONVENTION_ROWS: readonly ConventionRow[] = [
       },
     ],
   },
+  {
+    name: "ava",
+    package: "ava",
+    range: ">=6.0.0 <8.0.0",
+    entries: [],
+    moves: [],
+    testRunner: AVA_6,
+  },
+  {
+    name: "ava",
+    package: "ava",
+    range: ">=8.0.0 <9.0.0",
+    entries: [],
+    moves: [],
+    testRunner: AVA_8,
+  },
   {
     name: "babel",
     package: "@babel/core",
@@ -359,6 +474,38 @@ export const CONVENTION_ROWS: readonly ConventionRow[] = [
     entries: [`{,src/}app/**/*.${SCRIPT}`],
     moves: [],
   },
+  {
+    name: "jest",
+    package: "jest",
+    range: ">=29.0.0 <30.0.0",
+    entries: [],
+    moves: [],
+    testRunner: JEST_29,
+  },
+  {
+    name: "jest",
+    package: "jest",
+    range: ">=30.0.0 <31.0.0",
+    entries: [],
+    moves: [],
+    testRunner: JEST_30,
+  },
+  {
+    name: "mocha",
+    package: "mocha",
+    range: ">=10.0.0 <12.0.0",
+    entries: [],
+    moves: [],
+    testRunner: MOCHA_10,
+  },
+  {
+    name: "mocha",
+    package: "mocha",
+    range: ">=12.0.0 <13.0.0",
+    entries: [],
+    moves: [],
+    testRunner: MOCHA_12,
+  },
   {
     name: "next",
     bundles: true,
@@ -469,6 +616,22 @@ export const CONVENTION_ROWS: readonly ConventionRow[] = [
       { key: "targets.*.source", directory: false },
     ],
   },
+  {
+    name: "playwright",
+    package: "@playwright/test",
+    range: ">=1.0.0 <2.0.0",
+    entries: [PLAYWRIGHT_CONFIG],
+    moves: [],
+    testDirectories: [
+      {
+        files: [PLAYWRIGHT_CONFIG],
+        directory: "testDir",
+        match: "testMatch",
+        defaultMatch: PLAYWRIGHT_TEST_MATCH,
+        projects: "projects",
+      },
+    ],
+  },
   {
     name: "prettier",
     package: "prettier",
@@ -825,30 +988,6 @@ export const CONVENTION_ROWS: readonly ConventionRow[] = [
     ],
     moves: [],
   },
-  {
-    name: "vitest",
-    package: "vitest",
-    range: ">=3.2.0 <6.0.0",
-    entries: [
-      `**/{vitest,vite}.config.${ANY_MODULE}`,
-      `**/{vitest,vite}.config.*.${ANY_MODULE}`,
-      `**/{vitest,vite}.*.config.${ANY_MODULE}`,
-    ],
-    moves: [],
-    shortNames: [
-      {
-        property: "test.coverage.provider",
-        files: [VITEST_CONFIG],
-        package: "@vitest/coverage-{}",
-      },
-    ],
-    selections: [
-      { property: "test.coverage.include", files: [VITEST_CONFIG] },
-      { property: "test.coverage.exclude", files: [VITEST_CONFIG] },
-    ],
-    testFiles: [
-      { property: "test.setupFiles", files: [VITEST_CONFIG], roots: VITEST_ROOTS },
-      { property: "test.globalSetup", files: [VITEST_CONFIG], roots: VITEST_ROOTS },
-    ],
-  },
+  vitestRow(">=3.2.0 <4.0.0", true),
+  vitestRow(">=4.0.0 <6.0.0", false),
 ];