@cplieger/deadset-ts 8.0.0-dev.2 → 8.0.0-dev.21

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.
@@ -140,14 +181,16 @@ export interface ConventionRow {
   readonly manifestEntries?: readonly ManifestEntryKey[];
   /** The settings that make the tool's output import a runtime helper package. */
   readonly helpers?: readonly HelperReading[];
+  /** Whether the tool bundles the package's modules, so it resolves them as a bundler does. */
+  readonly bundles?: true;
 }
 
 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 that hold JSON or a CommonJS module. */
-const ESLINTRC = [".eslintrc", ".eslintrc.json", ".eslintrc.{js,cjs}"];
+/** The legacy configuration files of ESLint: JSON, YAML or a CommonJS module. */
+const ESLINTRC = [".eslintrc", ".eslintrc.json", ".eslintrc.{yml,yaml}", ".eslintrc.{js,cjs}"];
 
 const SVELTEKIT_ROUTE_FILES = "+{page,layout,server,page.server,layout.server,error}";
 
@@ -193,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",
@@ -209,6 +310,35 @@ const ANGULAR_PACKAGE_KEYS: readonly PackageKey[] = [
   "scripts",
 ].map((key) => ({ key, files: ["angular.json"] }));
 
+/**
+ * The row of a code generator that writes its output below one directory its
+ * configuration's `property` sets, `fallback` where no configuration file sets it, so
+ * every file there is a generated file.
+ */
+function outputDirectoryRow(row: {
+  readonly name: string;
+  readonly package: string;
+  readonly range: string;
+  readonly files: readonly string[];
+  readonly property: string;
+  readonly fallback: string;
+}): ConventionRow {
+  return {
+    name: row.name,
+    package: row.package,
+    range: row.range,
+    entries: [],
+    generated: ["<output>"],
+    moves: [
+      {
+        id: "output",
+        defaults: [row.fallback],
+        readings: [{ property: row.property, files: row.files }],
+      },
+    ],
+  };
+}
+
 /**
  * The test runners and the assertion, mock and runner libraries whose import is test
  * evidence beside each runner a row reads test files for. Each applies whether or not a
@@ -254,6 +384,7 @@ export const CONVENTION_ROWS: readonly ConventionRow[] = [
   },
   {
     name: "astro",
+    bundles: true,
     package: "astro",
     range: ">=5.0.0 <8.0.0",
     entries: [
@@ -273,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",
@@ -299,6 +446,7 @@ export const CONVENTION_ROWS: readonly ConventionRow[] = [
     range: ">=4.0.0 <10.0.0",
     entries: [],
     moves: [],
+    packageKeys: [{ key: "parser", files: ESLINTRC }],
     prefixedNames: [
       { property: "plugins", files: ESLINTRC, prefix: "eslint-plugin" },
       { property: "extends", files: ESLINTRC, prefix: "eslint-plugin", marker: "plugin:" },
@@ -322,12 +470,45 @@ export const CONVENTION_ROWS: readonly ConventionRow[] = [
   {
     name: "expo-router",
     package: "expo-router",
-    range: ">=3.0.0 <58.0.0",
+    range: ">=3.0.0 <59.0.0",
     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,
     package: "next",
     range: ">=13.4.0 <17.0.0",
     generated: [".next"],
@@ -345,6 +526,7 @@ export const CONVENTION_ROWS: readonly ConventionRow[] = [
   },
   {
     name: "nuxt",
+    bundles: true,
     package: "nuxt",
     range: ">=3.0.0 <5.0.0",
     generated: [".nuxt"],
@@ -414,8 +596,17 @@ export const CONVENTION_ROWS: readonly ConventionRow[] = [
       { key: "oclif.hooks", directory: false },
     ],
   },
+  outputDirectoryRow({
+    name: "panda",
+    package: "@pandacss/dev",
+    range: ">=0.1.0 <2.0.0",
+    files: [`panda.config.${ANY_MODULE}`],
+    property: "outdir",
+    fallback: "styled-system",
+  }),
   {
     name: "parcel",
+    bundles: true,
     package: "parcel",
     range: ">=2.0.0 <3.0.0",
     entries: [],
@@ -425,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",
@@ -481,6 +688,13 @@ export const CONVENTION_ROWS: readonly ConventionRow[] = [
       },
     ],
   },
+  {
+    name: "react-scripts",
+    package: "react-scripts",
+    range: ">=1.0.0 <6.0.0",
+    entries: [`src/index.${SCRIPT}`, "src/setupProxy.js", `src/setupTests.${SCRIPT}`],
+    moves: [],
+  },
   {
     name: "remix",
     package: "@remix-run/dev",
@@ -508,6 +722,7 @@ export const CONVENTION_ROWS: readonly ConventionRow[] = [
   },
   {
     name: "rolldown",
+    bundles: true,
     package: "rolldown",
     range: ">=1.0.0 <2.0.0",
     entries: [],
@@ -553,6 +768,7 @@ export const CONVENTION_ROWS: readonly ConventionRow[] = [
   },
   {
     name: "storybook",
+    bundles: true,
     package: "storybook",
     range: ">=7.0.0 <11.0.0",
     entries: [
@@ -586,6 +802,7 @@ export const CONVENTION_ROWS: readonly ConventionRow[] = [
   },
   {
     name: "sveltekit",
+    bundles: true,
     package: "@sveltejs/kit",
     range: ">=2.0.0 <3.0.0",
     entries: [...SVELTEKIT_ENTRIES, "<params>/*.{js,ts}"],
@@ -651,6 +868,7 @@ export const CONVENTION_ROWS: readonly ConventionRow[] = [
   },
   {
     name: "sveltekit",
+    bundles: true,
     package: "@sveltejs/kit",
     range: ">=3.0.0 <4.0.0",
     entries: [...SVELTEKIT_ENTRIES, "<params>.{js,ts}"],
@@ -743,6 +961,7 @@ export const CONVENTION_ROWS: readonly ConventionRow[] = [
   },
   {
     name: "vite",
+    bundles: true,
     package: "vite",
     range: ">=8.0.0 <9.0.0",
     entries: [],
@@ -758,6 +977,7 @@ export const CONVENTION_ROWS: readonly ConventionRow[] = [
   },
   {
     name: "vitepress",
+    bundles: true,
     package: "vitepress",
     range: ">=1.0.0 <2.0.0-0 || >=2.0.0-alpha.0 <3.0.0",
     entries: [
@@ -768,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),
 ];