ember.nvp 0.7.0 → 1.1.0

package/src/cli/generator.js

@@ -1,6 +1,7 @@
 import { mkdir, rm } from "node:fs/promises";
 
 import baseApp from "#bases/minimal-app";
+import baseExtension from "#bases/minimal-extension";
 import baseLibrary from "#bases/minimal-library";
 import { consolidateLintingScripts } from "../consolidators/linting.js";
 import { hasGit } from "#utils/git.js";
@@ -24,6 +25,9 @@ export async function generateProject(project, replaceOrUpdate) {
     case "library":
       await baseLibrary.run(project);
       break;
+    case "extension":
+      await baseExtension.run(project);
+      break;
   }
 
   /**

package/src/cli/questions/project-type.js

@@ -3,12 +3,13 @@ import { answers, printArgInUse } from "#args";
 
 /**
  * addon is alias for library
+ * web-extension is alias for extension
  */
-const SUPPORTED = new Set(["app", "library", "addon"]);
+const SUPPORTED = new Set(["app", "library", "addon", "extension", "web-extension"]);
 
 /**
  * @param {string | undefined} selected
- * @returns {selected is "app" | "library" | "addon"}
+ * @returns {selected is "app" | "library" | "addon" | "extension" | "web-extension"}
  */
 function isValid(selected) {
   if (!selected) return false;
@@ -25,6 +26,7 @@ export async function askProjectType() {
     printArgInUse("type", answers.type);
 
     if (answers.type === "addon") return "library";
+    if (answers.type === "web-extension") return "extension";
 
     return answers.type;
   }
@@ -38,6 +40,11 @@ export async function askProjectType() {
         label: "library",
         hint: "sharable code, usable by other libraries and apps alike",
       },
+      {
+        value: "extension",
+        label: "browser extension",
+        hint: "Manifest V3 extension whose popup is an Ember app",
+      },
     ],
   });
 

package/src/layers/renovate/index.js

@@ -14,10 +14,11 @@ export default {
       return;
     }
 
+    // extensions aren't published to npm either, so they follow the app config
     let source =
-      project.type === "app"
-        ? join(import.meta.dirname, "files/app.json5")
-        : join(import.meta.dirname, "files/library.json5");
+      project.type === "library"
+        ? join(import.meta.dirname, "files/library.json5")
+        : join(import.meta.dirname, "files/app.json5");
 
     let destination = join(project.directory, ".github/renovate.json5");
 

package/src/layers/typescript/index.js

@@ -7,6 +7,7 @@ import { getLatest } from "#utils/npm.js";
 
 const bases = join(import.meta.dirname, "../../bases");
 const appBase = join(bases, "minimal-app/files");
+const extensionBase = join(bases, "minimal-extension/files");
 const libraryBase = join(bases, "minimal-library/files");
 
 const sharedDeps = {
@@ -149,6 +150,11 @@ async function addTSConfig(project) {
     return;
   }
 
+  if (project.type === "extension") {
+    await cp(join(extensionBase, "tsconfig.json"), project.path("tsconfig.json"));
+    return;
+  }
+
   if (project.type === "library") {
     await cp(join(libraryBase, "tsconfig.json"), project.path("tsconfig.json"));
   }

package/src/utils/types.ts

@@ -1,6 +1,6 @@
 import { Project } from "./project.js";
 export type PackageManager = "pnpm" | "npm";
-export type ProjectType = "app" | "library";
+export type ProjectType = "app" | "library" | "extension";
 
 export interface Layer {
   /**

package/test/ember.nvp/base-library.test.ts

@@ -1,9 +1,9 @@
 import { describe, it, beforeAll, afterAll, expect } from "vitest";
-import { generate, mktemp } from "#test-helpers";
+import { generate, listFiles, mktemp } from "#test-helpers";
 import { writeLibrarySource } from "./library-src-fixtures.ts";
 import { execa } from "execa";
-import { mkdir, readdir, readFile, rm, writeFile } from "node:fs/promises";
-import { join, relative, sep } from "node:path";
+import { mkdir, readFile, rm, writeFile } from "node:fs/promises";
+import { join } from "node:path";
 
 import type { Project } from "ember.nvp";
 
@@ -14,20 +14,6 @@ import type { Project } from "ember.nvp";
  * them.
  */
 
-async function listFiles(directory: string): Promise<string[]> {
-  const entries = await readdir(directory, { withFileTypes: true, recursive: true });
-
-  return entries
-    .filter((entry) => entry.isFile())
-    .map((entry) => relative(directory, join(entry.parentPath, entry.name)))
-    .filter((path) => !path.split(sep).includes("node_modules"))
-    .sort();
-}
-
-async function read(project: Project, filePath: string): Promise<string> {
-  return readFile(join(project.directory, filePath), "utf-8");
-}
-
 async function installAndBuild(project: Project) {
   let install = await execa("pnpm install", { cwd: project.directory, shell: true });
   expect(install.exitCode).toBe(0);
@@ -66,11 +52,11 @@ describe("base: minimal-library", () => {
         ]
       `);
 
-      expect(await read(project, "src/index.js")).toBe("");
+      expect(await project.read("src/index.js")).toBe("");
     });
 
     it("is publishable", async () => {
-      let manifest = JSON.parse(await read(project, "package.json"));
+      let manifest = JSON.parse((await project.read("package.json"))!);
 
       // The template is private (it lives in a workspace); the generated
       // library must not be
@@ -78,15 +64,16 @@ describe("base: minimal-library", () => {
     });
 
     it("has no TypeScript leftovers", async () => {
-      let manifest = JSON.parse(await read(project, "package.json"));
+      let manifest = JSON.parse((await project.read("package.json"))!);
 
       expect(manifest.devDependencies).not.toHaveProperty("typescript");
       expect(manifest.devDependencies).not.toHaveProperty("@ember/library-tsconfig");
       // No declarations are emitted without types
       expect(JSON.stringify(manifest.exports)).not.toContain("types");
 
-      expect(await read(project, "tsdown.config.js")).toMatchInlineSnapshot(`
-        "import { defineConfig, ember } from "@nullvoxpopuli/ember-rolldown";
+      expect(await project.read("tsdown.config.js")).toMatchInlineSnapshot(`
+        "import { defineConfig } from "tsdown";
+        import { ember } from "@nullvoxpopuli/ember-rolldown";
 
         export default defineConfig({
           entry: ["./src/index.js"],
@@ -128,7 +115,7 @@ describe("base: minimal-library", () => {
       await writeLibrarySource(project, "javascript");
       await installAndBuild(project);
 
-      let output = await read(project, "dist/index.js");
+      let output = await project.read("dist/index.js");
 
       // Published libraries ship precompileTemplate (the consuming app does
       // the final compile), never wire format
@@ -164,7 +151,7 @@ describe("base: minimal-library", () => {
         ]
       `);
 
-      expect(await read(project, "src/index.ts")).toBe("");
+      expect(await project.read("src/index.ts")).toBe("");
     });
 
     it("type checks", async () => {
@@ -180,16 +167,40 @@ describe("base: minimal-library", () => {
     it("builds, including declarations", async () => {
       await installAndBuild(project);
 
-      let output = await read(project, "dist/index.js");
+      let output = await project.read("dist/index.js");
 
       expect(output).toContain("precompileTemplate");
       expect(output).not.toContain("createTemplateFactory");
 
-      let declarations = await read(project, "dist/index.d.ts");
-
-      expect(declarations).toContain("declare class Greeting extends Component<GreetingSignature>");
-      expect(declarations).toContain("declare const Badge: TOC<BadgeSignature>");
-      expect(declarations).toContain("declare function add(a: number, b: number): number");
+      let declarations = await project.read("dist/index.d.ts");
+
+      expect(declarations).toMatchInlineSnapshot(`
+        "import { TOC } from "@ember/component/template-only";
+        import Component from "@glimmer/component";
+        //#region src/components/badge.d.ts
+        interface BadgeSignature {
+          Element: HTMLSpanElement;
+          Blocks: {
+            default: [];
+          };
+        }
+        declare const Badge: TOC<BadgeSignature>;
+        //#endregion
+        //#region src/components/greeting.d.ts
+        interface GreetingSignature {
+          Element: HTMLParagraphElement;
+          Args: {
+            name: string;
+          };
+        }
+        declare class Greeting extends Component<GreetingSignature> {}
+        //#endregion
+        //#region src/utils/math.d.ts
+        declare function add(a: number, b: number): number;
+        //#endregion
+        export { Badge, type BadgeSignature, Greeting, type GreetingSignature, add };
+        //# sourceMappingURL=index.d.ts.map"
+      `);
 
       expect(await listFiles(join(project.directory, "dist"))).toMatchInlineSnapshot(`
         [

package/test/ember.nvp/layer-publish-checks.test.ts

@@ -1,8 +1,7 @@
 import { describe, it, beforeAll, afterAll, expect } from "vitest";
 import { generate } from "#test-helpers";
 import { execa } from "execa";
-import { readFile, rm } from "node:fs/promises";
-import { join } from "node:path";
+import { rm } from "node:fs/promises";
 
 import type { Project } from "ember.nvp";
 
@@ -12,10 +11,6 @@ import type { Project } from "ember.nvp";
  * output.
  */
 
-async function read(project: Project, filePath: string): Promise<string> {
-  return readFile(join(project.directory, filePath), "utf-8");
-}
-
 describe("layers: publint + are-the-types-wrong", () => {
   const dirs: string[] = [];
 
@@ -40,8 +35,9 @@ describe("layers: publint + are-the-types-wrong", () => {
     });
 
     it("wires both checks into the build", async () => {
-      expect(await read(project, "tsdown.config.js")).toMatchInlineSnapshot(`
-        "import { defineConfig, ember } from "@nullvoxpopuli/ember-rolldown";
+      expect(await project.read("tsdown.config.js")).toMatchInlineSnapshot(`
+        "import { defineConfig } from "tsdown";
+        import { ember } from "@nullvoxpopuli/ember-rolldown";
         export default defineConfig({ entry: ["./src/index.ts"], plugins: [ember()], attw: { profile: "esm-only" }, publint: true })"
       `);
     });
@@ -77,8 +73,9 @@ describe("layers: publint + are-the-types-wrong", () => {
     });
 
     it("wires publint only (no declarations to check)", async () => {
-      expect(await read(project, "tsdown.config.js")).toMatchInlineSnapshot(`
-        "import { defineConfig, ember } from "@nullvoxpopuli/ember-rolldown";
+      expect(await project.read("tsdown.config.js")).toMatchInlineSnapshot(`
+        "import { defineConfig } from "tsdown";
+        import { ember } from "@nullvoxpopuli/ember-rolldown";
         export default defineConfig({ entry: ["./src/index.js"], dts: false, plugins: [ember()], publint: true })"
       `);
     });

package/test/ember.nvp/layer-qunit.test.ts

@@ -1,27 +1,12 @@
 import { describe, it, beforeAll, afterAll, expect } from "vitest";
-import { generate } from "#test-helpers";
+import { generate, listFiles } from "#test-helpers";
 import { writeLibrarySource } from "./library-src-fixtures.ts";
 import { execa } from "execa";
-import { mkdir, readdir, readFile, rm, writeFile } from "node:fs/promises";
-import { dirname, join, relative, sep } from "node:path";
+import { mkdir, rm, writeFile } from "node:fs/promises";
+import { dirname, join } from "node:path";
 
 import type { Project } from "ember.nvp";
 
-async function listFiles(directory: string): Promise<string[]> {
-  const entries = await readdir(directory, { withFileTypes: true, recursive: true });
-
-  return entries
-    .filter((entry) => entry.isFile())
-    .map((entry) => relative(directory, join(entry.parentPath, entry.name)))
-    .filter((path) => !path.split(sep).includes("node_modules"))
-    .filter((path) => !path.startsWith(`dist${sep}`))
-    .sort();
-}
-
-async function read(project: Project, filePath: string): Promise<string> {
-  return readFile(join(project.directory, filePath), "utf-8");
-}
-
 async function installAndTest(project: Project) {
   let install = await execa("pnpm install", { cwd: project.directory, shell: true });
   expect(install.exitCode).toBe(0);
@@ -167,7 +152,7 @@ describe("layer: qunit", () => {
     });
 
     it("generates the expected files, without any index.html", async () => {
-      let files = await listFiles(project.directory);
+      let files = await listFiles(project.directory, { includeDist: false });
 
       expect(files.some((file) => file.endsWith("index.html"))).toBe(false);
       expect(files).toMatchInlineSnapshot(`
@@ -189,7 +174,7 @@ describe("layer: qunit", () => {
     });
 
     it("generates the test build config", async () => {
-      expect(await read(project, "vite.config.mjs")).toMatchInlineSnapshot(`
+      expect(await project.read("vite.config.mjs")).toMatchInlineSnapshot(`
         "import { defineConfig } from "vite";
         import { ember } from "@nullvoxpopuli/ember-vite";
 
@@ -198,7 +183,7 @@ describe("layer: qunit", () => {
         });
         "
       `);
-      expect(await read(project, "config/test/babel.config.js")).toMatchInlineSnapshot(`
+      expect(await project.read("config/test/babel.config.js")).toMatchInlineSnapshot(`
         "import { buildMacros } from "@embroider/macros/babel";
 
         const macros = buildMacros({
@@ -242,7 +227,7 @@ describe("layer: qunit", () => {
         };
         "
       `);
-      expect(await read(project, "config/test/testem.cjs")).toMatchInlineSnapshot(`
+      expect(await project.read("config/test/testem.cjs")).toMatchInlineSnapshot(`
         ""use strict";
 
         if (typeof module !== "undefined") {
@@ -274,8 +259,9 @@ describe("layer: qunit", () => {
     });
 
     it("leaves the publish build config alone", async () => {
-      expect(await read(project, "tsdown.config.js")).toMatchInlineSnapshot(`
-        "import { defineConfig, ember } from "@nullvoxpopuli/ember-rolldown";
+      expect(await project.read("tsdown.config.js")).toMatchInlineSnapshot(`
+        "import { defineConfig } from "tsdown";
+        import { ember } from "@nullvoxpopuli/ember-rolldown";
 
         export default defineConfig({
           entry: ["./src/index.ts"],
@@ -295,7 +281,7 @@ describe("layer: qunit", () => {
       let build = await execa("pnpm build", { cwd: project.directory, shell: true });
       expect(build.exitCode).toBe(0);
 
-      let output = await read(project, "dist/index.js");
+      let output = await project.read("dist/index.js");
 
       expect(output).toContain("precompileTemplate");
       expect(output).not.toContain("createTemplateFactory");
@@ -311,7 +297,7 @@ describe("layer: qunit", () => {
     });
 
     it("generates the expected files, without any index.html", async () => {
-      let files = await listFiles(project.directory);
+      let files = await listFiles(project.directory, { includeDist: false });
 
       expect(files.some((file) => file.endsWith("index.html"))).toBe(false);
       expect(files).toMatchInlineSnapshot(`
@@ -332,7 +318,7 @@ describe("layer: qunit", () => {
     });
 
     it("has no TypeScript leftovers in the test build config", async () => {
-      expect(await read(project, "config/test/babel.config.js")).toMatchInlineSnapshot(`
+      expect(await project.read("config/test/babel.config.js")).toMatchInlineSnapshot(`
         "import { buildMacros } from "@embroider/macros/babel";
 
         const macros = buildMacros({
@@ -364,8 +350,9 @@ describe("layer: qunit", () => {
         };
         "
       `);
-      expect(await read(project, "tsdown.config.js")).toMatchInlineSnapshot(`
-        "import { defineConfig, ember } from "@nullvoxpopuli/ember-rolldown";
+      expect(await project.read("tsdown.config.js")).toMatchInlineSnapshot(`
+        "import { defineConfig } from "tsdown";
+        import { ember } from "@nullvoxpopuli/ember-rolldown";
 
         export default defineConfig({
           entry: ["./src/index.js"],
@@ -386,7 +373,7 @@ describe("layer: qunit", () => {
       let build = await execa("pnpm build", { cwd: project.directory, shell: true });
       expect(build.exitCode).toBe(0);
 
-      let output = await read(project, "dist/index.js");
+      let output = await project.read("dist/index.js");
 
       expect(output).toContain("precompileTemplate");
       expect(output).not.toContain("createTemplateFactory");

package/test/ember.nvp/layer-vitest.test.ts

@@ -1,9 +1,9 @@
 import { describe, it, beforeAll, afterAll, expect } from "vitest";
-import { generate } from "#test-helpers";
+import { generate, listFiles } from "#test-helpers";
 import { writeLibrarySource } from "./library-src-fixtures.ts";
 import { execa } from "execa";
-import { mkdir, readdir, readFile, rm, writeFile } from "node:fs/promises";
-import { dirname, join, relative, sep } from "node:path";
+import { mkdir, rm, writeFile } from "node:fs/promises";
+import { dirname, join } from "node:path";
 
 import type { Project } from "ember.nvp";
 
@@ -14,20 +14,6 @@ import type { Project } from "ember.nvp";
  * headless-browser mode), asserting the specs genuinely run and pass.
  */
 
-async function listFiles(directory: string): Promise<string[]> {
-  const entries = await readdir(directory, { withFileTypes: true, recursive: true });
-
-  return entries
-    .filter((entry) => entry.isFile())
-    .map((entry) => relative(directory, join(entry.parentPath, entry.name)))
-    .filter((path) => !path.split(sep).includes("node_modules"))
-    .sort();
-}
-
-async function read(project: Project, filePath: string): Promise<string> {
-  return readFile(join(project.directory, filePath), "utf-8");
-}
-
 async function emit(project: Project, files: Record<string, string>) {
   for (let [path, contents] of Object.entries(files)) {
     let filePath = join(project.directory, path);
@@ -200,7 +186,7 @@ describe("layer: vitest", () => {
     });
 
     it("generates the vitest config", async () => {
-      expect(await read(project, "vitest.config.mjs")).toMatchInlineSnapshot(`
+      expect(await project.read("vitest.config.mjs")).toMatchInlineSnapshot(`
         "import { ember } from "@nullvoxpopuli/ember-vite";
         import { webdriverio } from "@vitest/browser-webdriverio";
         import { defineConfig } from "vitest/config";

package/test/ember.nvp/permutations/app-checks.test.ts

@@ -0,0 +1,3 @@
+import { testPermutations } from "./shared.ts";
+
+testPermutations("minimal-app", { group: "checks" });

package/test/ember.nvp/permutations/extension-1.test.ts

@@ -0,0 +1,3 @@
+import { testPermutations } from "./shared.ts";
+
+testPermutations("minimal-extension", { index: 0, total: 2 });

package/test/ember.nvp/permutations/extension-2.test.ts

@@ -0,0 +1,3 @@
+import { testPermutations } from "./shared.ts";
+
+testPermutations("minimal-extension", { index: 1, total: 2 });

package/test/ember.nvp/permutations/extension-checks.test.ts

@@ -0,0 +1,3 @@
+import { testPermutations } from "./shared.ts";
+
+testPermutations("minimal-extension", { group: "checks" });

package/test/ember.nvp/permutations/library-checks.test.ts

@@ -0,0 +1,3 @@
+import { testPermutations } from "./shared.ts";
+
+testPermutations("minimal-library", { group: "checks" });

package/test/ember.nvp/permutations/shared.ts

@@ -30,30 +30,73 @@ const NOT_YET_SUPPORTED: Record<ProjectType, Set<string>> = {
   app: new Set(["publint", "are-the-types-wrong"]),
   // libraries have no Application to wire inspector support into
   library: new Set(["inspector-support"]),
+  // publish checks: extensions aren't published (to npm)
+  extension: new Set(["publint", "are-the-types-wrong"]),
 };
 
+const TYPE_FOR_BASE: Record<(typeof bases)[number], ProjectType> = {
+  "minimal-app": "app",
+  "minimal-library": "library",
+  "minimal-extension": "extension",
+};
+
+/**
+ * Layers that only add lint / format / publish checks. They don't affect
+ * the runtime shape of a project, so they permutate among themselves in a
+ * small "checks" matrix instead of multiplying the main one. ("apply anew"
+ * still applies each of them on top of every main permutation, so linear
+ * cross-group coverage remains.)
+ */
+const CHECK_LAYERS = new Set<string>([
+  "eslint-bundled-ember",
+  "eslint-bundled-nvp",
+  "eslint-ejected",
+  "prettier",
+  "publint",
+  "are-the-types-wrong",
+]);
+
+type PermutationGroup = "main" | "checks";
+
 const eachBase = bases.map((base) => {
-  const type: ProjectType = base === "minimal-app" ? "app" : "library";
+  const type = TYPE_FOR_BASE[base]!;
 
   const applicableLayers = layers.filter((layer) => !NOT_YET_SUPPORTED[type].has(layer.name));
 
-  const permutations = permutate(applicableLayers.map((layer) => layer.name));
-  permutations.push([baseline]);
+  const toPermutations = (layerNames: string[], withBaseline: boolean) => {
+    const permutations = permutate(layerNames);
+
+    if (withBaseline) {
+      permutations.push([baseline]);
+    }
 
-  const eachPermutation = permutations
-    .filter((permutation) => {
-      if (INITIAL_ONLY.size > 0 && !permutation.some((x) => INITIAL_ONLY.has(x))) {
-        return;
-      }
+    return permutations
+      .filter((permutation) => {
+        if (INITIAL_ONLY.size > 0 && !permutation.some((x) => INITIAL_ONLY.has(x))) {
+          return;
+        }
 
-      // Not implemented yet
-      if (permutation.some((x) => TODO.has(x))) {
-        return;
-      }
+        // Not implemented yet
+        if (permutation.some((x) => TODO.has(x))) {
+          return;
+        }
 
-      return true;
-    })
-    .map((permutation) => ({ permutation, name: permutation.join(", ") }));
+        return true;
+      })
+      .map((permutation) => ({ permutation, name: permutation.join(", ") }));
+  };
+
+  const applicableNames = applicableLayers.map((layer) => layer.name);
+  const eachPermutation: Record<PermutationGroup, ReturnType<typeof toPermutations>> = {
+    main: toPermutations(
+      applicableNames.filter((name) => !CHECK_LAYERS.has(name)),
+      true,
+    ),
+    checks: toPermutations(
+      applicableNames.filter((name) => CHECK_LAYERS.has(name)),
+      false,
+    ),
+  };
 
   return { name: base, type, applicableLayers, eachPermutation };
 });
@@ -62,14 +105,20 @@ const eachBase = bases.map((base) => {
  * The permutation matrix grows exponentially with the layer count, so
  * each base runs from its own test file(s) -- CI runs them as separate,
  * parallel jobs. A base whose matrix outgrows one job's budget runs from
- * several files, each taking a deterministic 1-of-N slice.
+ * several files, each taking a deterministic 1-of-N slice. The "checks"
+ * group (CHECK_LAYERS) runs from its own file(s) the same way.
  *
  * @param base which base's permutations this file runs
- * @param slice which 1-of-N slice of the permutations this file runs
+ * @param options.index / options.total which 1-of-N slice of the permutations this file runs
+ * @param options.group which permutation group this file runs
  */
 export function testPermutations(
   base: (typeof bases)[number],
-  slice: { index: number; total: number } = { index: 0, total: 1 },
+  {
+    index = 0,
+    total = 1,
+    group = "main",
+  }: { index?: number; total?: number; group?: PermutationGroup } = {},
 ) {
   const {
     type,
@@ -77,7 +126,7 @@ export function testPermutations(
     eachPermutation: allPermutations,
   } = eachBase.find((b) => b.name === base)!;
 
-  const eachPermutation = allPermutations.filter((_, i) => i % slice.total === slice.index);
+  const eachPermutation = allPermutations[group].filter((_, i) => i % total === index);
 
   describe(base, () => {
     describe.each(eachPermutation)("layers: $name", ({ permutation }) => {

package/test/test-helpers.ts

@@ -1,18 +1,19 @@
 import { execa } from "execa";
-import { join } from "node:path";
+import { join, relative, sep } from "node:path";
 import { styleText } from "node:util";
 import { Readable, Writable } from "node:stream";
-import { mkdtemp } from "node:fs/promises";
+import { mkdtemp, readdir } from "node:fs/promises";
 import { tmpdir } from "node:os";
 import { generateProject, Project } from "ember.nvp";
 import { discoverLayers } from "#layers";
-import type { DiscoveredLayer } from "#types";
+import type { DiscoveredLayer, ProjectType } from "#types";
 import { expect } from "vitest";
 
 const minimalApp = "minimal-app";
 const minimalAddon = "minimal-library";
+const minimalExtension = "minimal-extension";
 
-export const bases = [minimalApp, minimalAddon];
+export const bases = [minimalApp, minimalAddon, minimalExtension];
 
 export const layers = await discoverLayers();
 
@@ -87,7 +88,7 @@ export async function generate({
   directory?: string;
   layers?: string[];
   name?: string;
-  type?: "app" | "library";
+  type?: ProjectType;
   packageManager?: "pnpm" | "npm";
 }): Promise<Project> {
   const tempDir = directory ?? (await mktemp(name));
@@ -186,3 +187,22 @@ export async function expectIsSetup(project: Project, layer: DiscoveredLayer) {
 
   expect(result, `${layer.name} is setup`).toBe(true);
 }
+
+/**
+ * List every file under `directory` (recursively) as sorted paths relative
+ * to `directory`. `node_modules` is always excluded; pass
+ * `{ includeDist: false }` to also exclude the `dist/` build output.
+ */
+export async function listFiles(
+  directory: string,
+  { includeDist = true }: { includeDist?: boolean } = {},
+): Promise<string[]> {
+  const entries = await readdir(directory, { withFileTypes: true, recursive: true });
+
+  return entries
+    .filter((entry) => entry.isFile())
+    .map((entry) => relative(directory, join(entry.parentPath, entry.name)))
+    .filter((path) => !path.split(sep).includes("node_modules"))
+    .filter((path) => includeDist || !path.startsWith(`dist${sep}`))
+    .sort();
+}

package/vitest.config.js

@@ -4,6 +4,6 @@ export default defineConfig({
   test: {
     testTimeout: 60_000,
     hookTimeout: 60_000,
-    include: ["test/**/*.test.ts", "src/**/*.test.ts"],
+    include: ["test/**/*.test.ts", "src/**/*.test.ts", "packages/*/src/**/*.test.ts"],
   },
 });