@electron-forge/test-utils 8.0.0-alpha.9 → 8.0.0

package/dist/index.d.ts

@@ -10,6 +10,11 @@ export declare function ensureModulesInstalled(dir: string, deps: string[], devD
 export declare function ensureTestDirIsNonexistent(): Promise<string>;
 export declare function expectLintToPass(dir: string): Promise<void>;
 export declare function expectTypecheckToPass(dir: string): Promise<void>;
+/**
+ * Runs the `typecheck` script and expects it to fail.
+ * Returns the script's stdout, where `tsc` reports its diagnostics.
+ */
+export declare function expectTypecheckToFail(dir: string): Promise<string>;
 /**
  * Mutates the `package.json` file in a directory.
  * Use the return value to later restore the original `package.json` value
@@ -20,4 +25,5 @@ export declare function expectTypecheckToPass(dir: string): Promise<void>;
  * @returns The original `package.json` prior to mutation
  */
 export declare function updatePackageJSON(dir: string, callback: (packageJSON: PackageJSON) => Promise<PackageJSON>): Promise<any>;
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uL3NyYy9pbmRleC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFNQSxNQUFNLE1BQU0sV0FBVyxHQUFHLE1BQU0sQ0FBQyxNQUFNLEVBQUUsT0FBTyxDQUFDLEdBQUc7SUFDbEQsTUFBTSxDQUFDLEVBQUU7UUFDUCxLQUFLLENBQUMsRUFBRSxNQUFNLENBQUMsTUFBTSxFQUFFLE9BQU8sQ0FBQyxDQUFDO0tBQ2pDLENBQUM7SUFDRixZQUFZLENBQUMsRUFBRSxNQUFNLENBQUMsTUFBTSxFQUFFLE1BQU0sQ0FBQyxDQUFDO0lBQ3RDLGVBQWUsQ0FBQyxFQUFFLE1BQU0sQ0FBQyxNQUFNLEVBQUUsTUFBTSxDQUFDLENBQUM7Q0FDMUMsQ0FBQztBQU1GLHdCQUFzQixhQUFhLENBQUMsR0FBRyxFQUFFLE1BQU0sRUFBRSxHQUFHLElBQUksRUFBRSxNQUFNLEVBQUUsaUJBRWpFO0FBRUQsd0JBQXNCLHNCQUFzQixDQUMxQyxHQUFHLEVBQUUsTUFBTSxFQUNYLElBQUksRUFBRSxNQUFNLEVBQUUsRUFDZCxPQUFPLEVBQUUsTUFBTSxFQUFFLEdBQ2hCLE9BQU8sQ0FBQyxJQUFJLENBQUMsQ0FHZjtBQUlELHdCQUFzQiwwQkFBMEIsSUFBSSxPQUFPLENBQUMsTUFBTSxDQUFDLENBTWxFO0FBRUQsd0JBQXNCLGdCQUFnQixDQUFDLEdBQUcsRUFBRSxNQUFNLEdBQUcsT0FBTyxDQUFDLElBQUksQ0FBQyxDQVVqRTtBQUVELHdCQUFzQixxQkFBcUIsQ0FBQyxHQUFHLEVBQUUsTUFBTSxHQUFHLE9BQU8sQ0FBQyxJQUFJLENBQUMsQ0FVdEU7QUFFRDs7Ozs7Ozs7R0FRRztBQUNILHdCQUFzQixpQkFBaUIsQ0FDckMsR0FBRyxFQUFFLE1BQU0sRUFDWCxRQUFRLEVBQUUsQ0FBQyxXQUFXLEVBQUUsV0FBVyxLQUFLLE9BQU8sQ0FBQyxXQUFXLENBQUMsZ0JBVTdEIn0=
+export * from './template-tests.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAMA,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG;IAClD,MAAM,CAAC,EAAE;QACP,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACjC,CAAC;IACF,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC1C,CAAC;AAMF,wBAAsB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,MAAM,EAAE,iBAEjE;AAED,wBAAsB,sBAAsB,CAC1C,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,EAAE,MAAM,EAAE,GAChB,OAAO,CAAC,IAAI,CAAC,CAGf;AAID,wBAAsB,0BAA0B,IAAI,OAAO,CAAC,MAAM,CAAC,CAMlE;AAED,wBAAsB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAUjE;AAED,wBAAsB,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAUtE;AAED;;;;;;;;GAQG;AACH,wBAAsB,iBAAiB,CACrC,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,CAAC,WAAW,EAAE,WAAW,KAAK,OAAO,CAAC,WAAW,CAAC,gBAU7D"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAMA,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG;IAClD,MAAM,CAAC,EAAE;QACP,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACjC,CAAC;IACF,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC1C,CAAC;AAMF,wBAAsB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,MAAM,EAAE,iBAEjE;AAED,wBAAsB,sBAAsB,CAC1C,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,EAAE,MAAM,EAAE,GAChB,OAAO,CAAC,IAAI,CAAC,CAGf;AAID,wBAAsB,0BAA0B,IAAI,OAAO,CAAC,MAAM,CAAC,CAMlE;AAED,wBAAsB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAUjE;AAED,wBAAsB,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAUtE;AAED;;;GAGG;AACH,wBAAsB,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAUxE;AAED;;;;;;;;GAQG;AACH,wBAAsB,iBAAiB,CACrC,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,CAAC,WAAW,EAAE,WAAW,KAAK,OAAO,CAAC,WAAW,CAAC,gBAY7D;AAED,cAAc,qBAAqB,CAAC"}

package/dist/index.js

@@ -1,7 +1,7 @@
+import fs from 'node:fs/promises';
 import os from 'node:os';
 import path from 'node:path';
 import { ExitError, spawn } from '@malept/cross-spawn-promise';
-import fs from 'fs-extra';
 async function runNPM(dir, ...args) {
     await spawn('npm', args, { cwd: dir });
 }
@@ -16,7 +16,7 @@ let dirID = Date.now();
 export async function ensureTestDirIsNonexistent() {
     const dir = path.resolve(os.tmpdir(), `electron-forge-test-${dirID}`);
     dirID += 1;
-    await fs.promises.rm(dir, { recursive: true, force: true });
+    await fs.rm(dir, { recursive: true, force: true });
     return dir;
 }
 export async function expectLintToPass(dir) {
@@ -43,6 +43,22 @@ export async function expectTypecheckToPass(dir) {
         throw err;
     }
 }
+/**
+ * Runs the `typecheck` script and expects it to fail.
+ * Returns the script's stdout, where `tsc` reports its diagnostics.
+ */
+export async function expectTypecheckToFail(dir) {
+    try {
+        await runNPM(dir, 'run', 'typecheck');
+    }
+    catch (err) {
+        if (err instanceof ExitError) {
+            return err.stdout.toString();
+        }
+        throw err;
+    }
+    throw new Error('Expected typecheck to fail, but it passed');
+}
 /**
  * Mutates the `package.json` file in a directory.
  * Use the return value to later restore the original `package.json` value
@@ -53,9 +69,10 @@ export async function expectTypecheckToPass(dir) {
  * @returns The original `package.json` prior to mutation
  */
 export async function updatePackageJSON(dir, callback) {
-    const packageJSON = await fs.readJson(path.resolve(dir, 'package.json'));
+    const packageJSON = JSON.parse(await fs.readFile(path.resolve(dir, 'package.json'), 'utf8'));
     const mutated = await callback(JSON.parse(JSON.stringify(packageJSON)));
-    await fs.promises.writeFile(path.resolve(dir, 'package.json'), JSON.stringify(mutated, null, 2), 'utf-8');
+    await fs.writeFile(path.resolve(dir, 'package.json'), JSON.stringify(mutated, null, 2), 'utf-8');
     return packageJSON;
 }
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi9zcmMvaW5kZXgudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsT0FBTyxFQUFFLE1BQU0sU0FBUyxDQUFDO0FBQ3pCLE9BQU8sSUFBSSxNQUFNLFdBQVcsQ0FBQztBQUU3QixPQUFPLEVBQUUsU0FBUyxFQUFFLEtBQUssRUFBRSxNQUFNLDZCQUE2QixDQUFDO0FBQy9ELE9BQU8sRUFBRSxNQUFNLFVBQVUsQ0FBQztBQVUxQixLQUFLLFVBQVUsTUFBTSxDQUFDLEdBQVcsRUFBRSxHQUFHLElBQWM7SUFDbEQsTUFBTSxLQUFLLENBQUMsS0FBSyxFQUFFLElBQUksRUFBRSxFQUFFLEdBQUcsRUFBRSxHQUFHLEVBQUUsQ0FBQyxDQUFDO0FBQ3pDLENBQUM7QUFFRCxNQUFNLENBQUMsS0FBSyxVQUFVLGFBQWEsQ0FBQyxHQUFXLEVBQUUsR0FBRyxJQUFjO0lBQ2hFLE1BQU0sTUFBTSxDQUFDLEdBQUcsRUFBRSxTQUFTLEVBQUUsR0FBRyxJQUFJLENBQUMsQ0FBQztBQUN4QyxDQUFDO0FBRUQsTUFBTSxDQUFDLEtBQUssVUFBVSxzQkFBc0IsQ0FDMUMsR0FBVyxFQUNYLElBQWMsRUFDZCxPQUFpQjtJQUVqQixNQUFNLGFBQWEsQ0FBQyxHQUFHLEVBQUUsR0FBRyxJQUFJLENBQUMsQ0FBQztJQUNsQyxNQUFNLGFBQWEsQ0FBQyxHQUFHLEVBQUUsWUFBWSxFQUFFLEdBQUcsT0FBTyxDQUFDLENBQUM7QUFDckQsQ0FBQztBQUVELElBQUksS0FBSyxHQUFHLElBQUksQ0FBQyxHQUFHLEVBQUUsQ0FBQztBQUV2QixNQUFNLENBQUMsS0FBSyxVQUFVLDBCQUEwQjtJQUM5QyxNQUFNLEdBQUcsR0FBRyxJQUFJLENBQUMsT0FBTyxDQUFDLEVBQUUsQ0FBQyxNQUFNLEVBQUUsRUFBRSx1QkFBdUIsS0FBSyxFQUFFLENBQUMsQ0FBQztJQUN0RSxLQUFLLElBQUksQ0FBQyxDQUFDO0lBQ1gsTUFBTSxFQUFFLENBQUMsUUFBUSxDQUFDLEVBQUUsQ0FBQyxHQUFHLEVBQUUsRUFBRSxTQUFTLEVBQUUsSUFBSSxFQUFFLEtBQUssRUFBRSxJQUFJLEVBQUUsQ0FBQyxDQUFDO0lBRTVELE9BQU8sR0FBRyxDQUFDO0FBQ2IsQ0FBQztBQUVELE1BQU0sQ0FBQyxLQUFLLFVBQVUsZ0JBQWdCLENBQUMsR0FBVztJQUNoRCxJQUFJLENBQUM7UUFDSCxNQUFNLE1BQU0sQ0FBQyxHQUFHLEVBQUUsS0FBSyxFQUFFLE1BQU0sQ0FBQyxDQUFDO0lBQ25DLENBQUM7SUFBQyxPQUFPLEdBQUcsRUFBRSxDQUFDO1FBQ2IsSUFBSSxHQUFHLFlBQVksU0FBUyxFQUFFLENBQUM7WUFDN0IsT0FBTyxDQUFDLEtBQUssQ0FBQyxTQUFTLEVBQUUsR0FBRyxDQUFDLE1BQU0sQ0FBQyxRQUFRLEVBQUUsQ0FBQyxDQUFDO1lBQ2hELE9BQU8sQ0FBQyxLQUFLLENBQUMsU0FBUyxFQUFFLEdBQUcsQ0FBQyxNQUFNLENBQUMsUUFBUSxFQUFFLENBQUMsQ0FBQztRQUNsRCxDQUFDO1FBQ0QsTUFBTSxHQUFHLENBQUM7SUFDWixDQUFDO0FBQ0gsQ0FBQztBQUVELE1BQU0sQ0FBQyxLQUFLLFVBQVUscUJBQXFCLENBQUMsR0FBVztJQUNyRCxJQUFJLENBQUM7UUFDSCxNQUFNLE1BQU0sQ0FBQyxHQUFHLEVBQUUsS0FBSyxFQUFFLFdBQVcsQ0FBQyxDQUFDO0lBQ3hDLENBQUM7SUFBQyxPQUFPLEdBQUcsRUFBRSxDQUFDO1FBQ2IsSUFBSSxHQUFHLFlBQVksU0FBUyxFQUFFLENBQUM7WUFDN0IsT0FBTyxDQUFDLEtBQUssQ0FBQyxTQUFTLEVBQUUsR0FBRyxDQUFDLE1BQU0sQ0FBQyxRQUFRLEVBQUUsQ0FBQyxDQUFDO1lBQ2hELE9BQU8sQ0FBQyxLQUFLLENBQUMsU0FBUyxFQUFFLEdBQUcsQ0FBQyxNQUFNLENBQUMsUUFBUSxFQUFFLENBQUMsQ0FBQztRQUNsRCxDQUFDO1FBQ0QsTUFBTSxHQUFHLENBQUM7SUFDWixDQUFDO0FBQ0gsQ0FBQztBQUVEOzs7Ozs7OztHQVFHO0FBQ0gsTUFBTSxDQUFDLEtBQUssVUFBVSxpQkFBaUIsQ0FDckMsR0FBVyxFQUNYLFFBQTREO0lBRTVELE1BQU0sV0FBVyxHQUFHLE1BQU0sRUFBRSxDQUFDLFFBQVEsQ0FBQyxJQUFJLENBQUMsT0FBTyxDQUFDLEdBQUcsRUFBRSxjQUFjLENBQUMsQ0FBQyxDQUFDO0lBQ3pFLE1BQU0sT0FBTyxHQUFHLE1BQU0sUUFBUSxDQUFDLElBQUksQ0FBQyxLQUFLLENBQUMsSUFBSSxDQUFDLFNBQVMsQ0FBQyxXQUFXLENBQUMsQ0FBQyxDQUFDLENBQUM7SUFDeEUsTUFBTSxFQUFFLENBQUMsUUFBUSxDQUFDLFNBQVMsQ0FDekIsSUFBSSxDQUFDLE9BQU8sQ0FBQyxHQUFHLEVBQUUsY0FBYyxDQUFDLEVBQ2pDLElBQUksQ0FBQyxTQUFTLENBQUMsT0FBTyxFQUFFLElBQUksRUFBRSxDQUFDLENBQUMsRUFDaEMsT0FBTyxDQUNSLENBQUM7SUFDRixPQUFPLFdBQVcsQ0FBQztBQUNyQixDQUFDIn0=
+export * from './template-tests.js';
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi9zcmMvaW5kZXgudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsT0FBTyxFQUFFLE1BQU0sa0JBQWtCLENBQUM7QUFDbEMsT0FBTyxFQUFFLE1BQU0sU0FBUyxDQUFDO0FBQ3pCLE9BQU8sSUFBSSxNQUFNLFdBQVcsQ0FBQztBQUU3QixPQUFPLEVBQUUsU0FBUyxFQUFFLEtBQUssRUFBRSxNQUFNLDZCQUE2QixDQUFDO0FBVS9ELEtBQUssVUFBVSxNQUFNLENBQUMsR0FBVyxFQUFFLEdBQUcsSUFBYztJQUNsRCxNQUFNLEtBQUssQ0FBQyxLQUFLLEVBQUUsSUFBSSxFQUFFLEVBQUUsR0FBRyxFQUFFLEdBQUcsRUFBRSxDQUFDLENBQUM7QUFDekMsQ0FBQztBQUVELE1BQU0sQ0FBQyxLQUFLLFVBQVUsYUFBYSxDQUFDLEdBQVcsRUFBRSxHQUFHLElBQWM7SUFDaEUsTUFBTSxNQUFNLENBQUMsR0FBRyxFQUFFLFNBQVMsRUFBRSxHQUFHLElBQUksQ0FBQyxDQUFDO0FBQ3hDLENBQUM7QUFFRCxNQUFNLENBQUMsS0FBSyxVQUFVLHNCQUFzQixDQUMxQyxHQUFXLEVBQ1gsSUFBYyxFQUNkLE9BQWlCO0lBRWpCLE1BQU0sYUFBYSxDQUFDLEdBQUcsRUFBRSxHQUFHLElBQUksQ0FBQyxDQUFDO0lBQ2xDLE1BQU0sYUFBYSxDQUFDLEdBQUcsRUFBRSxZQUFZLEVBQUUsR0FBRyxPQUFPLENBQUMsQ0FBQztBQUNyRCxDQUFDO0FBRUQsSUFBSSxLQUFLLEdBQUcsSUFBSSxDQUFDLEdBQUcsRUFBRSxDQUFDO0FBRXZCLE1BQU0sQ0FBQyxLQUFLLFVBQVUsMEJBQTBCO0lBQzlDLE1BQU0sR0FBRyxHQUFHLElBQUksQ0FBQyxPQUFPLENBQUMsRUFBRSxDQUFDLE1BQU0sRUFBRSxFQUFFLHVCQUF1QixLQUFLLEVBQUUsQ0FBQyxDQUFDO0lBQ3RFLEtBQUssSUFBSSxDQUFDLENBQUM7SUFDWCxNQUFN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

package/dist/template-tests.d.ts

@@ -0,0 +1,42 @@
+declare const supportedTemplates: readonly ['base', 'vite', 'webpack'];
+type ModuleFormat = 'es' | 'cjs';
+declare const supportedModuleFormats: ModuleFormat[];
+type SupportedModuleFormats = typeof supportedModuleFormats;
+export type TestForgeTemplateOptions = {
+    /**
+     * Note: `create-electron-app` always creates CommonJS projects; this option
+     * is only here to allow us to test projects that have been manually changed
+     * to ESM (either by programmatically updating the relevant project files in
+     * the temporary test directory or by manually updating them in the Forge
+     * checkout for local testing).
+     */
+    moduleFormats: SupportedModuleFormats;
+    templateName: (typeof supportedTemplates)[number];
+};
+/**
+ * Runs the local version of `create-electron-app` to create a project based on
+ * a given Forge template using all supported package managers. Because this
+ * test suite runs under Verdaccio, all ´@electron-forge/*` packages installed
+ * by the templates are served from the file system and rebuilt before every
+ * test run, which makes it easy to test local changes in the templates.
+ *
+ * At a high level, for each different package manager, this test suite:
+ *
+ * - creates a project with `create-electron-app`;
+ *
+ * - modifies the project's preload file so that it sends a "preload file ok"
+ * IPC message to the main process once it has successfully loaded;
+ *
+ * - modifies the project's main process entrypoint so that it logs a "main
+ * process ok" message. It also sets up a listener for the IPC message sent by
+ * the preload file that logs a "preload file ok" when that message is received;
+ *
+ * - runs the project's `start` script and checks whether its output contains
+ * the expected log messages;
+ *
+ * - checks whether the project includes a lock file that is consistent with the
+ * package-manager used by `create-electron-app`.
+ */
+export declare function testForgeTemplate({ moduleFormats, templateName, }: TestForgeTemplateOptions): void;
+export {};
+//# sourceMappingURL=template-tests.d.ts.map

package/dist/template-tests.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"template-tests.d.ts","sourceRoot":"","sources":["../src/template-tests.ts"],"names":[],"mappings":"AAUA,QAAA,MAAM,kBAAkB,YAAI,MAAM,EAAE,MAAM,EAAE,SAAS,CAAU,CAAC;AAEhE,KAAK,YAAY,GAAG,IAAI,GAAG,KAAK,CAAC;AAEjC,QAAA,MAAM,sBAAsB,EAAE,YAAY,EAAkB,CAAC;AAC7D,KAAK,sBAAsB,GAAG,OAAO,sBAAsB,CAAC;AAE5D,MAAM,MAAM,wBAAwB,GAAG;IACrC;;;;;;OAMG;IACH,aAAa,EAAE,sBAAsB,CAAC;IAEtC,YAAY,EAAE,CAAC,OAAO,kBAAkB,CAAC,CAAC,MAAM,CAAC,CAAC;CACnD,CAAC;AAyDF;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,iBAAiB,CAAC,EAChC,aAAa,EACb,YAAY,GACb,EAAE,wBAAwB,QA6P1B"}

package/dist/template-tests.js

@@ -0,0 +1,265 @@
+import { spawn } from '@malept/cross-spawn-promise';
+import path from 'node:path';
+import { pathToFileURL } from 'node:url';
+import fs from 'node:fs';
+import debug from 'debug';
+import { afterEach, beforeEach, describe, expect, test } from 'vitest';
+import os from 'node:os';
+const supportedTemplates = ['base', 'vite', 'webpack'];
+const supportedModuleFormats = ['cjs', 'es'];
+const d = debug('electron-forge:testForgeTemplate');
+/**
+ * Summarizes the layout a package manager installed into a project, which is
+ * what tells a flat `node_modules` (npm, Yarn, pnpm with `nodeLinker: hoisted`)
+ * apart from one where every package is a link into a store, and shows which
+ * packages a failing app could have resolved.
+ */
+function describeDependencyTree(projectDir) {
+    const nodeModules = path.join(projectDir, 'node_modules');
+    let entries;
+    try {
+        entries = fs.readdirSync(nodeModules, { withFileTypes: true });
+    }
+    catch (error) {
+        return `no readable \`node_modules\` in ${projectDir} (${error})`;
+    }
+    const names = entries
+        .flatMap((entry) => 
+    // Scopes hold the packages we care about rather than being one themselves.
+    entry.name.startsWith('@')
+        ? fs
+            .readdirSync(path.join(nodeModules, entry.name))
+            .map((scoped) => `${entry.name}/${scoped}`)
+        : [entry.name])
+        .sort();
+    return `${names.length} packages into ${nodeModules}: ${names.join(' ')}`;
+}
+/**
+ * Everything the Verdaccio harness' pnpm shim recorded about the installs into
+ * one project, which is the only account there is of them: pnpm's own output.
+ */
+function describePnpmInstalls(projectDir) {
+    const invocationLog = process.env.FORGE_PNPM_INVOCATION_LOG;
+    if (!invocationLog)
+        return 'no record of the pnpm runs was kept';
+    let records;
+    try {
+        records = fs.readFileSync(invocationLog, 'utf8').split(/^(?==== pnpm )/m);
+    }
+    catch (error) {
+        return `no readable record of the pnpm runs in ${invocationLog} (${error})`;
+    }
+    const forThisProject = records.filter((record) => record.includes(`in ${projectDir}`));
+    return forThisProject.length
+        ? forThisProject.join('')
+        : `nothing in ${invocationLog} mentions ${projectDir}`;
+}
+/**
+ * Runs the local version of `create-electron-app` to create a project based on
+ * a given Forge template using all supported package managers. Because this
+ * test suite runs under Verdaccio, all ´@electron-forge/*` packages installed
+ * by the templates are served from the file system and rebuilt before every
+ * test run, which makes it easy to test local changes in the templates.
+ *
+ * At a high level, for each different package manager, this test suite:
+ *
+ * - creates a project with `create-electron-app`;
+ *
+ * - modifies the project's preload file so that it sends a "preload file ok"
+ * IPC message to the main process once it has successfully loaded;
+ *
+ * - modifies the project's main process entrypoint so that it logs a "main
+ * process ok" message. It also sets up a listener for the IPC message sent by
+ * the preload file that logs a "preload file ok" when that message is received;
+ *
+ * - runs the project's `start` script and checks whether its output contains
+ * the expected log messages;
+ *
+ * - checks whether the project includes a lock file that is consistent with the
+ * package-manager used by `create-electron-app`.
+ */
+export function testForgeTemplate({ moduleFormats, templateName, }) {
+    describe(`${templateName} template`, () => {
+        if (!moduleFormats.length) {
+            d('`moduleFormats` is empty, defaulting to `cjs` only');
+            moduleFormats = moduleFormats.concat('cjs');
+        }
+        let tmpDir;
+        beforeEach(async () => {
+            tmpDir = await fs.promises.mkdtemp(path.join(os.tmpdir(), 'electron-forge-test-'));
+        });
+        const testCases = moduleFormats.reduce((acc, moduleFormat) => {
+            const packageManagers = [
+                'npm',
+                'pnpm',
+                'yarn',
+            ];
+            packageManagers.forEach((packageManager) => {
+                acc.push([moduleFormat, packageManager]);
+            });
+            return acc;
+        }, []);
+        test.each(testCases)(`can launch a \`%s\` project created from \`template-${templateName}\` with \`%s\``, async (moduleFormat, packageManager) => {
+            if (!supportedTemplates.includes(templateName)) {
+                throw new Error(`unknown template ${templateName}`);
+            }
+            const createOutput = await spawn('node', [
+                path.resolve(__dirname, '../../../external/create-electron-app/dist/create-electron-app.js'),
+                tmpDir,
+                `--template=${templateName}`,
+                `--package-manager=${packageManager}`,
+                // Electron 41 is the last version that downloads its binary from a
+                // `postinstall` script. Yarn 4.18 disables install scripts by
+                // default (`enableScripts`), so on 41 the binary never gets
+                // downloaded and `electron-forge start` fails with "Electron failed
+                // to install correctly". Electron 42+ downloads the binary on demand
+                // the first time it's needed instead, so no install script is
+                // involved.
+                `--electron-version=43.4.0`,
+            ]);
+            d('tmpdir: ', pathToFileURL(tmpDir).toString());
+            const possiblePreloadFiles = ['preload.ts', 'preload.js'].map((item) => path.resolve(tmpDir, `src/${item}`));
+            const possibleMainProcessEntrypoints = [
+                'main.ts',
+                'main.js',
+                'index.ts',
+                'index.js',
+            ].map((item) => path.resolve(tmpDir, `src/${item}`));
+            const preloadPath = possiblePreloadFiles.find((item) => fs.existsSync(item));
+            const mainProcessEntrypoint = possibleMainProcessEntrypoints.find((item) => fs.existsSync(item));
+            let missingPreloadFileError = null;
+            let missingMainProcessEntrypointError = null;
+            if (!preloadPath) {
+                missingPreloadFileError = new Error(`"preload file not found in the following locations: ${JSON.stringify(possiblePreloadFiles, null, 2)}`);
+            }
+            if (!mainProcessEntrypoint) {
+                missingMainProcessEntrypointError = new Error(`"main process entrypoint not found in the following locations: ${JSON.stringify(possibleMainProcessEntrypoints, null, 2)}`);
+            }
+            if (missingPreloadFileError || missingMainProcessEntrypointError) {
+                throw new AggregateError([missingPreloadFileError, missingMainProcessEntrypointError], 'one or more files are missing');
+            }
+            const preloadOkMessage = '__FORGE_INTERNAL_PRELOAD_PROCESS_OK__';
+            const mainProcessOkMessage = '__FORGE_INTERNAL_MAIN_PROCESS_OK__';
+            await fs.promises.appendFile(preloadPath, [
+                '\n',
+                moduleFormat === 'es'
+                    ? `import { ipcRenderer } from 'electron';`
+                    : `const { ipcRenderer } = require('electron');`,
+                // If the preload file loads correctly, it will send this message to
+                // the main process, which will in turn log it. Once the app exits
+                // (either by calling `app.exit()` in our injected code upon
+                // receiving this message or after the test times out), we check if
+                // `electronForgeStartOutput` includes this string; if it doesn't,
+                // it means the preload file failed to load for some reason.
+                `ipcRenderer.send('${preloadOkMessage}')`,
+            ].join('\n'));
+            await fs.promises.appendFile(mainProcessEntrypoint, [
+                '\n',
+                moduleFormat === 'es'
+                    ? `import { ipcMain } from 'electron';`
+                    : `const { ipcMain } =  require('electron');`,
+                // This runs at the top-level and below all other template code, so
+                // its presence in `electronForgeStartOutput` indicates that the
+                // main process entrypoint must have been correctly parsed /
+                // transpiled.
+                `console.log('${mainProcessOkMessage}');`,
+                // Logs the message that indicates that the preload file has been
+                // correctly loaded.
+                `
+        ipcMain.on('${preloadOkMessage}', () => {
+          console.log('${preloadOkMessage}');
+          app.exit(0);
+        });
+        `,
+            ].join('\n'));
+            const startApp = () => spawn(packageManager, ['run', 'start'], {
+                cwd: tmpDir,
+                env: {
+                    PATH: process.env.PATH,
+                    /**
+                     * `start` makes the package manager check the lockfile it just
+                     * wrote, and `XDG_CONFIG_HOME` is where the Verdaccio test harness
+                     * puts the config that tells pnpm which registry to use, how old a
+                     * release has to be, which packages are exempt, and to warn rather
+                     * than fail when the check finds a difference. Dropping it would
+                     * leave the check looking at the public registry under a policy
+                     * the install never ran under.
+                     */
+                    XDG_CONFIG_HOME: process.env.XDG_CONFIG_HOME,
+                    ...(process.platform === 'linux' && {
+                        DISPLAY: process.env.DISPLAY,
+                        XAUTHORITY: process.env.XAUTHORITY,
+                    }),
+                    ...(packageManager !== 'yarn' && {
+                        /**
+                         * HACK: when running the test script with Yarn on a npm/pnpm
+                         * project created by `create-electron-app`,
+                         * `process.env.npm_config_user_agent` can be something like
+                         * `yarn/4.10.3 npm/? node/v24.14.1 win32 x64`, and Forge's
+                         * `checkPackageManager` function takes this value to mean that
+                         * the project _also_ uses Yarn, so `electron-forge start` ends
+                         * up failing because there's no `yarn.lock` ([relevant
+                         * code](https://github.com/electron/forge/blob/001f41befe2c049b6f54ce7d6c55e83435141055/packages/api/cli/src/util/check-system.ts#L108-L135)).
+                         *
+                         * Removing the `yarn/4.10.3` user agent causes Forge to
+                         * correctly identify the project's package manager, but since
+                         * the version information can be missing for npm in `npm/?`, it
+                         * fails semver validation and Forge treats it like an
+                         * unsupported npm version, so we also have to spoof a supported
+                         * npm version number to work around that behavior.
+                         */
+                        npm_config_user_agent: process.env
+                            .npm_config_user_agent.replace(/^yarn\/\d+\.\d+\.\d+ /i, '')
+                            .replace(/\bnpm\/\?/, 'npm/99.99.99'),
+                    }),
+                },
+            });
+            let electronForgeStartOutput;
+            try {
+                electronForgeStartOutput = await startApp();
+            }
+            catch (error) {
+                /**
+                 * When `start` fails, it is usually because the package manager
+                 * installed a dependency tree the app cannot resolve its own
+                 * configuration from, and the failure alone doesn't say which tree it
+                 * ended up with. `create-electron-app` runs its steps with listr2's
+                 * `exitOnError: false`, so a failed install leaves a broken project
+                 * behind and still exits 0; its output is the only place that failure
+                 * is reported at all.
+                 */
+                console.error([
+                    `[template-tests] ${packageManager} installed ${describeDependencyTree(tmpDir)}`,
+                    `[template-tests] from this package.json:\n${fs.readFileSync(path.join(tmpDir, 'package.json'), 'utf8')}`,
+                    ...(packageManager === 'pnpm'
+                        ? [
+                            `[template-tests] pnpm was run like this:\n${describePnpmInstalls(tmpDir)}`,
+                        ]
+                        : []),
+                    `[template-tests] create-electron-app said:\n${createOutput}`,
+                ].join('\n'));
+                throw error;
+            }
+            d({ electronForgeStartOutput });
+            const mainProcessOk = electronForgeStartOutput.includes(mainProcessOkMessage);
+            const preloadProcessOk = electronForgeStartOutput.includes(preloadOkMessage);
+            expect(mainProcessOk).toBe(true);
+            expect(preloadProcessOk).toBe(true);
+            const lockFile = {
+                npm: 'package-lock.json',
+                pnpm: 'pnpm-lock.yaml',
+                yarn: 'yarn.lock',
+            }[packageManager];
+            expect(fs.existsSync(path.resolve(tmpDir, lockFile))).toBe(true);
+        });
+        afterEach(async () => {
+            await fs.promises.rm(tmpDir, {
+                recursive: true,
+                force: true,
+                maxRetries: 5,
+                retryDelay: 500,
+            });
+        });
+    });
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidGVtcGxhdGUtdGVzdHMuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi9zcmMvdGVtcGxhdGUtdGVzdHMudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsT0FBTyxFQUFFLEtBQUssRUFBRSxNQUFNLDZCQUE2QixDQUFDO0FBQ3BELE9BQU8sSUFBSSxNQUFNLFdBQVcsQ0FBQztBQUM3QixPQUFPLEVBQUUsYUFBYSxFQUFFLE1BQU0sVUFBVSxDQUFDO0FBQ3pDLE9BQU8sRUFBRSxNQUFNLFNBQVMsQ0FBQztBQUN6QixPQUFPLEtBQUssTUFBTSxPQUFPLENBQUM7QUFDMUIsT0FBTyxFQUFFLFNBQVMsRUFBRSxVQUFVLEVBQUUsUUFBUSxFQUFFLE1BQU0sRUFBRSxJQUFJLEVBQUUsTUFBTSxRQUFRLENBQUM7QUFDdkUsT0FBTyxFQUFFLE1BQU0sU0FBUyxDQUFDO0FBSXpCLE1BQU0sa0JBQWtCLEdBQUcsQ0FBQyxNQUFNLEVBQUUsTUFBTSxFQUFFLFNBQVMsQ0FBVSxDQUFDO0FBSWhFLE1BQU0sc0JBQXNCLEdBQW1CLENBQUMsS0FBSyxFQUFFLElBQUksQ0FBQyxDQUFDO0FBZ0I3RCxNQUFNLENBQUMsR0FBRyxLQUFLLENBQUMsa0NBQWtDLENBQUMsQ0FBQztBQUVwRDs7Ozs7R0FLRztBQUNILFNBQVMsc0JBQXNCLENBQUMsVUFBa0I7SUFDaEQsTUFBTSxXQUFXLEdBQUcsSUFBSSxDQUFDLElBQUksQ0FBQyxVQUFVLEVBQUUsY0FBYyxDQUFDLENBQUM7SUFFMUQsSUFBSSxPQUFPLENBQUM7SUFDWixJQUFJLENBQUM7UUFDSCxPQUFPLEdBQUcsRUFBRSxDQUFDLFdBQVcsQ0FBQyxXQUFXLEVBQUUsRUFBRSxhQUFhLEVBQUUsSUFBSSxFQUFFLENBQUMsQ0FBQztJQUNqRSxDQUFDO0lBQUMsT0FBTyxLQUFLLEVBQUUsQ0FBQztRQUNmLE9BQU8sbUNBQW1DLFVBQVUsS0FBSyxLQUFLLEdBQUcsQ0FBQztJQUNwRSxDQUFDO0lBRUQsTUFBTSxLQUFL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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@electron-forge/test-utils",
-  "version": "8.0.0-alpha.9",
+  "version": "8.0.0",
   "type": "module",
   "description": "Helper utilities for the Electron Forge testsuite",
   "repository": "https://github.com/electron/forge",
@@ -9,11 +9,10 @@
   "exports": "./dist/index.js",
   "typings": "dist/index.d.ts",
   "dependencies": {
-    "@malept/cross-spawn-promise": "^2.0.0",
-    "fs-extra": "^10.0.0"
+    "@malept/cross-spawn-promise": "^2.0.0"
   },
   "engines": {
-    "node": ">= 22.12.0"
+    "node": ">= 22.13.0"
   },
   "publishConfig": {
     "access": "public"
@@ -22,5 +21,5 @@
     "dist",
     "src"
   ],
-  "gitHead": "8d048358c5e5f0b5a09e03740687aa7f0c63d027"
+  "gitHead": "40b4adf8ebbbb09d4349079c65a0b7682bbb8565"
 }

package/src/index.ts

@@ -1,8 +1,8 @@
+import fs from 'node:fs/promises';
 import os from 'node:os';
 import path from 'node:path';
 
 import { ExitError, spawn } from '@malept/cross-spawn-promise';
-import fs from 'fs-extra';
 
 export type PackageJSON = Record<string, unknown> & {
   config?: {
@@ -34,7 +34,7 @@ let dirID = Date.now();
 export async function ensureTestDirIsNonexistent(): Promise<string> {
   const dir = path.resolve(os.tmpdir(), `electron-forge-test-${dirID}`);
   dirID += 1;
-  await fs.promises.rm(dir, { recursive: true, force: true });
+  await fs.rm(dir, { recursive: true, force: true });
 
   return dir;
 }
@@ -63,6 +63,22 @@ export async function expectTypecheckToPass(dir: string): Promise<void> {
   }
 }
 
+/**
+ * Runs the `typecheck` script and expects it to fail.
+ * Returns the script's stdout, where `tsc` reports its diagnostics.
+ */
+export async function expectTypecheckToFail(dir: string): Promise<string> {
+  try {
+    await runNPM(dir, 'run', 'typecheck');
+  } catch (err) {
+    if (err instanceof ExitError) {
+      return err.stdout.toString();
+    }
+    throw err;
+  }
+  throw new Error('Expected typecheck to fail, but it passed');
+}
+
 /**
  * Mutates the `package.json` file in a directory.
  * Use the return value to later restore the original `package.json` value
@@ -76,12 +92,16 @@ export async function updatePackageJSON(
   dir: string,
   callback: (packageJSON: PackageJSON) => Promise<PackageJSON>,
 ) {
-  const packageJSON = await fs.readJson(path.resolve(dir, 'package.json'));
+  const packageJSON = JSON.parse(
+    await fs.readFile(path.resolve(dir, 'package.json'), 'utf8'),
+  );
   const mutated = await callback(JSON.parse(JSON.stringify(packageJSON)));
-  await fs.promises.writeFile(
+  await fs.writeFile(
     path.resolve(dir, 'package.json'),
     JSON.stringify(mutated, null, 2),
     'utf-8',
   );
   return packageJSON;
 }
+
+export * from './template-tests.js';

package/src/template-tests.ts

@@ -0,0 +1,366 @@
+import { spawn } from '@malept/cross-spawn-promise';
+import path from 'node:path';
+import { pathToFileURL } from 'node:url';
+import fs from 'node:fs';
+import debug from 'debug';
+import { afterEach, beforeEach, describe, expect, test } from 'vitest';
+import os from 'node:os';
+
+type SupportedPackageManager = 'npm' | 'pnpm' | 'yarn';
+
+const supportedTemplates = ['base', 'vite', 'webpack'] as const;
+
+type ModuleFormat = 'es' | 'cjs';
+
+const supportedModuleFormats: ModuleFormat[] = ['cjs', 'es'];
+type SupportedModuleFormats = typeof supportedModuleFormats;
+
+export type TestForgeTemplateOptions = {
+  /**
+   * Note: `create-electron-app` always creates CommonJS projects; this option
+   * is only here to allow us to test projects that have been manually changed
+   * to ESM (either by programmatically updating the relevant project files in
+   * the temporary test directory or by manually updating them in the Forge
+   * checkout for local testing).
+   */
+  moduleFormats: SupportedModuleFormats;
+
+  templateName: (typeof supportedTemplates)[number];
+};
+
+const d = debug('electron-forge:testForgeTemplate');
+
+/**
+ * Summarizes the layout a package manager installed into a project, which is
+ * what tells a flat `node_modules` (npm, Yarn, pnpm with `nodeLinker: hoisted`)
+ * apart from one where every package is a link into a store, and shows which
+ * packages a failing app could have resolved.
+ */
+function describeDependencyTree(projectDir: string) {
+  const nodeModules = path.join(projectDir, 'node_modules');
+
+  let entries;
+  try {
+    entries = fs.readdirSync(nodeModules, { withFileTypes: true });
+  } catch (error) {
+    return `no readable \`node_modules\` in ${projectDir} (${error})`;
+  }
+
+  const names = entries
+    .flatMap((entry) =>
+      // Scopes hold the packages we care about rather than being one themselves.
+      entry.name.startsWith('@')
+        ? fs
+            .readdirSync(path.join(nodeModules, entry.name))
+            .map((scoped) => `${entry.name}/${scoped}`)
+        : [entry.name],
+    )
+    .sort();
+
+  return `${names.length} packages into ${nodeModules}: ${names.join(' ')}`;
+}
+
+/**
+ * Everything the Verdaccio harness' pnpm shim recorded about the installs into
+ * one project, which is the only account there is of them: pnpm's own output.
+ */
+function describePnpmInstalls(projectDir: string) {
+  const invocationLog = process.env.FORGE_PNPM_INVOCATION_LOG;
+  if (!invocationLog) return 'no record of the pnpm runs was kept';
+
+  let records;
+  try {
+    records = fs.readFileSync(invocationLog, 'utf8').split(/^(?==== pnpm )/m);
+  } catch (error) {
+    return `no readable record of the pnpm runs in ${invocationLog} (${error})`;
+  }
+
+  const forThisProject = records.filter((record) =>
+    record.includes(`in ${projectDir}`),
+  );
+  return forThisProject.length
+    ? forThisProject.join('')
+    : `nothing in ${invocationLog} mentions ${projectDir}`;
+}
+
+/**
+ * Runs the local version of `create-electron-app` to create a project based on
+ * a given Forge template using all supported package managers. Because this
+ * test suite runs under Verdaccio, all ´@electron-forge/*` packages installed
+ * by the templates are served from the file system and rebuilt before every
+ * test run, which makes it easy to test local changes in the templates.
+ *
+ * At a high level, for each different package manager, this test suite:
+ *
+ * - creates a project with `create-electron-app`;
+ *
+ * - modifies the project's preload file so that it sends a "preload file ok"
+ * IPC message to the main process once it has successfully loaded;
+ *
+ * - modifies the project's main process entrypoint so that it logs a "main
+ * process ok" message. It also sets up a listener for the IPC message sent by
+ * the preload file that logs a "preload file ok" when that message is received;
+ *
+ * - runs the project's `start` script and checks whether its output contains
+ * the expected log messages;
+ *
+ * - checks whether the project includes a lock file that is consistent with the
+ * package-manager used by `create-electron-app`.
+ */
+export function testForgeTemplate({
+  moduleFormats,
+  templateName,
+}: TestForgeTemplateOptions) {
+  describe(`${templateName} template`, () => {
+    if (!moduleFormats.length) {
+      d('`moduleFormats` is empty, defaulting to `cjs` only');
+
+      moduleFormats = moduleFormats.concat('cjs');
+    }
+
+    let tmpDir: string;
+
+    beforeEach(async () => {
+      tmpDir = await fs.promises.mkdtemp(
+        path.join(os.tmpdir(), 'electron-forge-test-'),
+      );
+    });
+
+    const testCases: Array<
+      [SupportedModuleFormats[number], SupportedPackageManager]
+    > = moduleFormats.reduce(
+      (acc, moduleFormat) => {
+        const packageManagers: SupportedPackageManager[] = [
+          'npm',
+          'pnpm',
+          'yarn',
+        ];
+
+        packageManagers.forEach((packageManager) => {
+          acc.push([moduleFormat, packageManager]);
+        });
+
+        return acc;
+      },
+      [] as typeof testCases,
+    );
+
+    test.each(testCases)(
+      `can launch a \`%s\` project created from \`template-${templateName}\` with \`%s\``,
+      async (moduleFormat, packageManager) => {
+        if (!supportedTemplates.includes(templateName)) {
+          throw new Error(`unknown template ${templateName}`);
+        }
+
+        const createOutput = await spawn('node', [
+          path.resolve(
+            __dirname,
+            '../../../external/create-electron-app/dist/create-electron-app.js',
+          ),
+          tmpDir,
+          `--template=${templateName}`,
+          `--package-manager=${packageManager}`,
+
+          // Electron 41 is the last version that downloads its binary from a
+          // `postinstall` script. Yarn 4.18 disables install scripts by
+          // default (`enableScripts`), so on 41 the binary never gets
+          // downloaded and `electron-forge start` fails with "Electron failed
+          // to install correctly". Electron 42+ downloads the binary on demand
+          // the first time it's needed instead, so no install script is
+          // involved.
+          `--electron-version=43.4.0`,
+        ]);
+
+        d('tmpdir: ', pathToFileURL(tmpDir).toString());
+
+        const possiblePreloadFiles = ['preload.ts', 'preload.js'].map((item) =>
+          path.resolve(tmpDir, `src/${item}`),
+        );
+
+        const possibleMainProcessEntrypoints = [
+          'main.ts',
+          'main.js',
+          'index.ts',
+          'index.js',
+        ].map((item) => path.resolve(tmpDir, `src/${item}`));
+
+        const preloadPath = possiblePreloadFiles.find((item) =>
+          fs.existsSync(item),
+        )!;
+        const mainProcessEntrypoint = possibleMainProcessEntrypoints.find(
+          (item) => fs.existsSync(item),
+        )!;
+
+        let missingPreloadFileError: Error | null = null;
+        let missingMainProcessEntrypointError: Error | null = null;
+
+        if (!preloadPath) {
+          missingPreloadFileError = new Error(
+            `"preload file not found in the following locations: ${JSON.stringify(possiblePreloadFiles, null, 2)}`,
+          );
+        }
+
+        if (!mainProcessEntrypoint) {
+          missingMainProcessEntrypointError = new Error(
+            `"main process entrypoint not found in the following locations: ${JSON.stringify(possibleMainProcessEntrypoints, null, 2)}`,
+          );
+        }
+
+        if (missingPreloadFileError || missingMainProcessEntrypointError) {
+          throw new AggregateError(
+            [missingPreloadFileError, missingMainProcessEntrypointError],
+            'one or more files are missing',
+          );
+        }
+
+        const preloadOkMessage = '__FORGE_INTERNAL_PRELOAD_PROCESS_OK__';
+        const mainProcessOkMessage = '__FORGE_INTERNAL_MAIN_PROCESS_OK__';
+
+        await fs.promises.appendFile(
+          preloadPath,
+          [
+            '\n',
+            moduleFormat === 'es'
+              ? `import { ipcRenderer } from 'electron';`
+              : `const { ipcRenderer } = require('electron');`,
+
+            // If the preload file loads correctly, it will send this message to
+            // the main process, which will in turn log it. Once the app exits
+            // (either by calling `app.exit()` in our injected code upon
+            // receiving this message or after the test times out), we check if
+            // `electronForgeStartOutput` includes this string; if it doesn't,
+            // it means the preload file failed to load for some reason.
+            `ipcRenderer.send('${preloadOkMessage}')`,
+          ].join('\n'),
+        );
+
+        await fs.promises.appendFile(
+          mainProcessEntrypoint,
+          [
+            '\n',
+            moduleFormat === 'es'
+              ? `import { ipcMain } from 'electron';`
+              : `const { ipcMain } =  require('electron');`,
+
+            // This runs at the top-level and below all other template code, so
+            // its presence in `electronForgeStartOutput` indicates that the
+            // main process entrypoint must have been correctly parsed /
+            // transpiled.
+            `console.log('${mainProcessOkMessage}');`,
+
+            // Logs the message that indicates that the preload file has been
+            // correctly loaded.
+            `
+        ipcMain.on('${preloadOkMessage}', () => {
+          console.log('${preloadOkMessage}');
+          app.exit(0);
+        });
+        `,
+          ].join('\n'),
+        );
+
+        const startApp = () =>
+          spawn(packageManager, ['run', 'start'], {
+            cwd: tmpDir,
+            env: {
+              PATH: process.env.PATH,
+              /**
+               * `start` makes the package manager check the lockfile it just
+               * wrote, and `XDG_CONFIG_HOME` is where the Verdaccio test harness
+               * puts the config that tells pnpm which registry to use, how old a
+               * release has to be, which packages are exempt, and to warn rather
+               * than fail when the check finds a difference. Dropping it would
+               * leave the check looking at the public registry under a policy
+               * the install never ran under.
+               */
+              XDG_CONFIG_HOME: process.env.XDG_CONFIG_HOME,
+              ...(process.platform === 'linux' && {
+                DISPLAY: process.env.DISPLAY,
+                XAUTHORITY: process.env.XAUTHORITY,
+              }),
+              ...(packageManager !== 'yarn' && {
+                /**
+                 * HACK: when running the test script with Yarn on a npm/pnpm
+                 * project created by `create-electron-app`,
+                 * `process.env.npm_config_user_agent` can be something like
+                 * `yarn/4.10.3 npm/? node/v24.14.1 win32 x64`, and Forge's
+                 * `checkPackageManager` function takes this value to mean that
+                 * the project _also_ uses Yarn, so `electron-forge start` ends
+                 * up failing because there's no `yarn.lock` ([relevant
+                 * code](https://github.com/electron/forge/blob/001f41befe2c049b6f54ce7d6c55e83435141055/packages/api/cli/src/util/check-system.ts#L108-L135)).
+                 *
+                 * Removing the `yarn/4.10.3` user agent causes Forge to
+                 * correctly identify the project's package manager, but since
+                 * the version information can be missing for npm in `npm/?`, it
+                 * fails semver validation and Forge treats it like an
+                 * unsupported npm version, so we also have to spoof a supported
+                 * npm version number to work around that behavior.
+                 */
+                npm_config_user_agent: process.env
+                  .npm_config_user_agent!.replace(/^yarn\/\d+\.\d+\.\d+ /i, '')
+                  .replace(/\bnpm\/\?/, 'npm/99.99.99'),
+              }),
+            },
+          });
+
+        let electronForgeStartOutput: string;
+        try {
+          electronForgeStartOutput = await startApp();
+        } catch (error) {
+          /**
+           * When `start` fails, it is usually because the package manager
+           * installed a dependency tree the app cannot resolve its own
+           * configuration from, and the failure alone doesn't say which tree it
+           * ended up with. `create-electron-app` runs its steps with listr2's
+           * `exitOnError: false`, so a failed install leaves a broken project
+           * behind and still exits 0; its output is the only place that failure
+           * is reported at all.
+           */
+          console.error(
+            [
+              `[template-tests] ${packageManager} installed ${describeDependencyTree(tmpDir)}`,
+              `[template-tests] from this package.json:\n${fs.readFileSync(path.join(tmpDir, 'package.json'), 'utf8')}`,
+              ...(packageManager === 'pnpm'
+                ? [
+                    `[template-tests] pnpm was run like this:\n${describePnpmInstalls(tmpDir)}`,
+                  ]
+                : []),
+              `[template-tests] create-electron-app said:\n${createOutput}`,
+            ].join('\n'),
+          );
+
+          throw error;
+        }
+
+        d({ electronForgeStartOutput });
+
+        const mainProcessOk =
+          electronForgeStartOutput.includes(mainProcessOkMessage);
+        const preloadProcessOk =
+          electronForgeStartOutput.includes(preloadOkMessage);
+
+        expect(mainProcessOk).toBe(true);
+        expect(preloadProcessOk).toBe(true);
+
+        const lockFile = (
+          {
+            npm: 'package-lock.json',
+            pnpm: 'pnpm-lock.yaml',
+            yarn: 'yarn.lock',
+          } as Record<SupportedPackageManager, string>
+        )[packageManager];
+
+        expect(fs.existsSync(path.resolve(tmpDir, lockFile))).toBe(true);
+      },
+    );
+
+    afterEach(async () => {
+      await fs.promises.rm(tmpDir, {
+        recursive: true,
+        force: true,
+        maxRetries: 5,
+        retryDelay: 500,
+      });
+    });
+  });
+}