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

package/src/{configuration-files.ts → entries/configuration-files.ts}

@@ -8,37 +8,40 @@
  */
 
 import {
-  isCallExpression,
-  isExportDeclaration,
-  isIdentifier,
-  isImportDeclaration,
   isNoSubstitutionTemplateLiteral,
   isStringLiteral,
-  SyntaxKind,
   type Node,
   type SourceFile,
 } from "@typescript/native/ast";
-import type { Host } from "./host.ts";
-import { ancestors, dirnamePath, joinPath, relativePath, resolvePath } from "./paths.ts";
-import type { SourceFiles } from "./source-files.ts";
-import { bytewise } from "./text/compare.ts";
-import { isRecord } from "./json-document.ts";
-import { filesIn } from "./fs/tree.ts";
+import { relativeSpecifiers } from "./static-module.ts";
+import type { Host } from "../host.ts";
+import { ancestors, dirnamePath, joinPath, relativePath, resolvePath } from "../paths.ts";
+import type { SourceFiles } from "../source-files.ts";
+import { bytewise } from "../text/compare.ts";
+import { isRecord } from "../json-document.ts";
+import { filesIn } from "../fs/tree.ts";
 import {
   DEPENDENCY_SECTIONS,
   holdsManifest,
   inInstalledPackages,
   manifestAt,
   readJSON,
-} from "./fs/manifest.ts";
-import { readCommands } from "./commands/read.ts";
-import { manifestCommands } from "./manifest.ts";
+} from "../fs/manifest.ts";
+import { readCommands } from "../commands/read.ts";
+import { manifestCommands } from "../roots/manifest.ts";
+import { APPENDED_EXTENSIONS, extensionOf, MODULE_EXTENSIONS } from "../extensions.ts";
+
+/** The extensions of a configuration module, as an expression's alternatives. */
+const MODULE_NAME = MODULE_EXTENSIONS.map((one) => one.slice(1)).join("|");
 
 /** A configuration module's name, each form with the spelling a root reports it by. */
 const MODULE_FORMS: readonly { readonly name: RegExp; readonly form: string }[] = [
-  { name: /^[\w-]+\.config\.(?:js|mjs|cjs|ts|mts|cts)$/u, form: "<stem>.config.<ext>" },
   {
-    name: /^[\w-]+\.[\w-]+\.config\.(?:js|mjs|cjs|ts|mts|cts)$/u,
+    name: new RegExp(String.raw`^[\w-]+\.config\.(?:${MODULE_NAME})$`, "u"),
+    form: "<stem>.config.<ext>",
+  },
+  {
+    name: new RegExp(String.raw`^[\w-]+\.[\w-]+\.config\.(?:${MODULE_NAME})$`, "u"),
     form: "<stem>.<qualifier>.config.<ext>",
   },
   { name: /^\.[\w-]+rc\.(?:js|mjs|cjs)$/u, form: ".<stem>rc.<ext>" },
@@ -58,9 +61,6 @@ const COUNTERPARTS: readonly (readonly [string, readonly string[]])[] = [
   [".cjs", [".cts"]],
 ];
 
-/** The extensions appended to a relative specifier from a configuration file, in order. */
-const APPENDED = [".ts", ".tsx", ".mts", ".cts", ".js", ".jsx", ".mjs", ".cjs"] as const;
-
 /** The extensions the program's module resolution appends to a specifier written without one. */
 export const RESOLVED_EXTENSIONS = [
   ".ts",
@@ -116,9 +116,6 @@ export interface OutsideModule {
   readonly manifestDirs: readonly string[];
 }
 
-/** The extensions of a module a configuration flag may name. */
-const MODULE_EXTENSIONS = [".js", ".mjs", ".cjs", ".ts", ".mts", ".cts"] as const;
-
 /**
  * The files the command strings of the manifest in one directory name after a configuration
  * flag, as `commands/read.ts` reads them against the directory each command runs in, each a
@@ -143,7 +140,7 @@ function scriptConfigurations(host: Host, root: string, dir: string): readonly s
 }
 
 /** The configuration files one project holds and sits beside. */
-interface ConfigurationFiles {
+export interface ConfigurationFiles {
   /**
    * Every own file that is a configuration module, with the form its name has and the
    * directory of the manifest whose dependencies its strings are read against.
@@ -295,55 +292,6 @@ export function configurationFiles(
   };
 }
 
-/** The literal module specifier one `require(...)` or `import(...)` call names, if any. */
-function calledSpecifier(node: Node): Node | undefined {
-  if (!isCallExpression(node) || node.arguments.length !== 1) {
-    return undefined;
-  }
-  const callee = node.expression;
-  const loads =
-    callee.kind === SyntaxKind.ImportKeyword || (isIdentifier(callee) && callee.text === "require");
-  return loads ? node.arguments[0] : undefined;
-}
-
-/**
- * The relative specifiers one file's imports and re-exports name, and those its
- * `require(...)` and `import(...)` calls name by a literal.
- */
-export function relativeSpecifiers(file: SourceFile): readonly string[] {
-  const known = specifiersOf.get(file);
-  if (known !== undefined) {
-    return known;
-  }
-  const found: string[] = [];
-  const named = (specifier: Node | undefined): void => {
-    if (
-      specifier !== undefined &&
-      (isStringLiteral(specifier) || isNoSubstitutionTemplateLiteral(specifier)) &&
-      RELATIVE_PREFIXES.some((prefix) => specifier.text.startsWith(prefix))
-    ) {
-      found.push(specifier.text);
-    }
-  };
-  const visit = (node: Node): void => {
-    named(calledSpecifier(node));
-    node.forEachChild(visit);
-  };
-  for (const statement of file.statements) {
-    named(
-      isImportDeclaration(statement) || isExportDeclaration(statement)
-        ? statement.moduleSpecifier
-        : undefined,
-    );
-    visit(statement);
-  }
-  specifiersOf.set(file, found);
-  return found;
-}
-
-/** What {@link relativeSpecifiers} found in each file, which every project of a run reads alike. */
-const specifiersOf = new WeakMap<SourceFile, readonly string[]>();
-
 /**
  * The files no program holds that a chain from `seeds` reads: each seed, and each file
  * below the target root one imports, re-exports or loads by a relative specifier that no
@@ -371,7 +319,7 @@ export function outsideChain(
 export function specifierCandidates(dir: string, specifier: string): readonly string[] {
   const path = resolvePath(dir, specifier);
   const candidates: string[] = [];
-  if (APPENDED.some((extension) => path.endsWith(extension))) {
+  if (extensionOf(path, APPENDED_EXTENSIONS) !== undefined) {
     candidates.push(path);
   }
   for (const [extension, counterparts] of COUNTERPARTS) {
@@ -380,8 +328,8 @@ export function specifierCandidates(dir: string, specifier: string): readonly st
       candidates.push(...counterparts.map((one) => stem + one));
     }
   }
-  candidates.push(...APPENDED.map((extension) => path + extension));
-  candidates.push(...APPENDED.map((extension) => joinPath(path, `index${extension}`)));
+  candidates.push(...APPENDED_EXTENSIONS.map((extension) => path + extension));
+  candidates.push(...APPENDED_EXTENSIONS.map((extension) => joinPath(path, `index${extension}`)));
   return candidates;
 }
 

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),
 ];