@cplieger/deadset-ts 7.2.0-dev.4 → 8.0.0-dev.10

package/src/convention-rows.ts

@@ -31,6 +31,22 @@ export interface ShortNameReading extends MoveReading {
   readonly package: string;
 }
 
+/**
+ * One configuration property whose values name packages by the tool's prefix convention:
+ * `x` stands for `<prefix>-x`, `@s` for `@s/<prefix>` and `@s/x` for `@s/<prefix>-x`, and
+ * a name already holding the prefix for itself.
+ */
+export interface PrefixedNameReading extends MoveReading {
+  /** The prefix the convention puts before a short name. */
+  readonly prefix: string;
+  /**
+   * The text a value starts with to name a package, the name ending at its last `/`.
+   * Absent, every value without a `:` names one, the name ending at its first `/` past
+   * a scope.
+   */
+  readonly marker?: string;
+}
+
 /**
  * One configuration property whose value makes the tool's output import a runtime helper
  * package, so the package is used where the property holds that value.
@@ -63,6 +79,14 @@ export interface TestFileReading extends MoveReading {
   readonly roots: readonly 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. */
+  readonly key: string;
+  /** Whether each string names a directory of entries, or one entry, its extension optional. */
+  readonly directory: boolean;
+}
+
 /** One directory a row's globs name that a configuration property moves. */
 export interface DirectoryMove {
   /** The placeholder the row's globs and later moves write as `<id>`. */
@@ -96,6 +120,8 @@ export interface ConventionRow {
   readonly moves: readonly DirectoryMove[];
   /** The properties that name a package the configuration uses by a short name. */
   readonly shortNames?: readonly ShortNameReading[];
+  /** The properties that name a package the configuration uses by its prefix convention. */
+  readonly prefixedNames?: readonly PrefixedNameReading[];
   /**
    * The properties whose value only selects files to test, mutate, cover or ignore, so a
    * string there names no file the tool runs or loads.
@@ -110,14 +136,20 @@ export interface ConventionRow {
   readonly packageKeys?: readonly PackageKey[];
   /** The members of a `package.json` the tool reads its configuration from. */
   readonly manifestKeys?: readonly string[];
+  /** The members of the declaring `package.json` whose strings name entries, as an entry glob does. */
+  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 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}"];
 
 const SVELTEKIT_ROUTE_FILES = "+{page,layout,server,page.server,layout.server,error}";
 
@@ -179,6 +211,60 @@ 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
+ * manifest declares it, so none is a row.
+ */
+export const TEST_LIBRARIES: readonly string[] = [
+  "@jest/globals",
+  "@playwright/test",
+  "ava",
+  "chai",
+  "expect",
+  "jasmine",
+  "jest",
+  "mocha",
+  "msw",
+  "nock",
+  "node:test",
+  "sinon",
+  "tap",
+  "uvu",
+];
+
+/** The scopes every package of which is a test library. */
+export const TEST_LIBRARY_SCOPES: readonly string[] = ["@testing-library/"];
+
 /** Every row, ordered by name and then by range. */
 export const CONVENTION_ROWS: readonly ConventionRow[] = [
   {
@@ -199,6 +285,7 @@ export const CONVENTION_ROWS: readonly ConventionRow[] = [
   },
   {
     name: "astro",
+    bundles: true,
     package: "astro",
     range: ">=5.0.0 <8.0.0",
     entries: [
@@ -231,6 +318,26 @@ export const CONVENTION_ROWS: readonly ConventionRow[] = [
       package: "@babel/runtime",
     })),
   },
+  {
+    name: "docusaurus",
+    package: "@docusaurus/core",
+    range: ">=2.0.0 <4.0.0",
+    entries: [`src/pages/**/*.${SCRIPT}`, `src/theme/**/*.${SCRIPT}`],
+    moves: [],
+  },
+  {
+    name: "eslint",
+    package: "eslint",
+    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:" },
+      { property: "extends", files: ESLINTRC, prefix: "eslint-config" },
+    ],
+  },
   {
     name: "eslint",
     package: "eslint",
@@ -238,15 +345,23 @@ export const CONVENTION_ROWS: readonly ConventionRow[] = [
     entries: [`**/eslint.config.${ANY_MODULE}`],
     moves: [],
   },
+  {
+    name: "expo",
+    package: "expo",
+    range: ">=44.0.0 <60.0.0",
+    entries: [`{index,App}.${SCRIPT}`],
+    moves: [],
+  },
   {
     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: "next",
+    bundles: true,
     package: "next",
     range: ">=13.4.0 <17.0.0",
     generated: [".next"],
@@ -264,6 +379,7 @@ export const CONVENTION_ROWS: readonly ConventionRow[] = [
   },
   {
     name: "nuxt",
+    bundles: true,
     package: "nuxt",
     range: ">=3.0.0 <5.0.0",
     generated: [".nuxt"],
@@ -322,6 +438,37 @@ export const CONVENTION_ROWS: readonly ConventionRow[] = [
       },
     ],
   },
+  {
+    name: "oclif",
+    package: "@oclif/core",
+    range: ">=1.0.0 <5.0.0",
+    entries: [`src/{commands,hooks}/**/*.${SCRIPT}`],
+    moves: [],
+    manifestEntries: [
+      { key: "oclif.commands", directory: true },
+      { 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: [],
+    moves: [],
+    manifestEntries: [
+      { key: "source", directory: false },
+      { key: "targets.*.source", directory: false },
+    ],
+  },
   {
     name: "prettier",
     package: "prettier",
@@ -378,6 +525,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",
@@ -405,6 +559,7 @@ export const CONVENTION_ROWS: readonly ConventionRow[] = [
   },
   {
     name: "rolldown",
+    bundles: true,
     package: "rolldown",
     range: ">=1.0.0 <2.0.0",
     entries: [],
@@ -450,6 +605,7 @@ export const CONVENTION_ROWS: readonly ConventionRow[] = [
   },
   {
     name: "storybook",
+    bundles: true,
     package: "storybook",
     range: ">=7.0.0 <11.0.0",
     entries: [
@@ -483,6 +639,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}"],
@@ -548,6 +705,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}"],
@@ -613,8 +771,34 @@ export const CONVENTION_ROWS: readonly ConventionRow[] = [
       },
     ],
   },
+  {
+    name: "tanstack-router",
+    package: "@tanstack/router-plugin",
+    range: ">=1.0.0 <2.0.0",
+    entries: [`<routes>/**/*.${SCRIPT}`],
+    moves: [
+      {
+        id: "routes",
+        defaults: ["src/routes"],
+        readings: [
+          { property: "routesDirectory", files: ["tsr.config.json"] },
+          {
+            property: "routesDirectory",
+            files: [VITE_CONFIG],
+            call: { module: "@tanstack/router-plugin/vite", export: "tanstackRouter" },
+          },
+          {
+            property: "routesDirectory",
+            files: [VITE_CONFIG],
+            call: { module: "@tanstack/router-plugin/vite", export: "TanStackRouterVite" },
+          },
+        ],
+      },
+    ],
+  },
   {
     name: "vite",
+    bundles: true,
     package: "vite",
     range: ">=8.0.0 <9.0.0",
     entries: [],
@@ -630,6 +814,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: [