@e2edev/e2e 0.2.0 → 0.4.0

package/dist/cli/index.js

@@ -2,6 +2,7 @@
 import { Command, CommanderError, InvalidArgumentError } from 'commander';
 import { run } from '../run/runner.js';
 import { init } from './init.js';
+import { SignalLadder } from './signals.js';
 /** Shape check only; the config resolver applies each flag's bounds. */
 function parseNonNegativeInt(value) {
     const parsed = Number(value);
@@ -16,7 +17,7 @@ function parseList(value) {
         .map((item) => item.trim())
         .filter((item) => item !== '');
 }
-const REPORTERS = ['list', 'json'];
+const REPORTERS = ['list', 'json', 'junit'];
 function isReporter(value) {
     return REPORTERS.includes(value);
 }
@@ -32,8 +33,8 @@ function createProgram() {
     program.exitOverride();
     program
         .command('init')
-        .description('scaffold e2e.config.ts, an example test, and .gitignore entries')
-        .option('-y, --yes', 'skip confirmation prompts')
+        .description('scaffold an ESM package, e2e.config.ts, an example test, and .gitignore entries')
+        .option('-y, --yes', 'skip prompts; enable AI without a backend or installation')
         .action(async (options) => {
         process.exitCode = await init(process.cwd(), options);
     });
@@ -48,7 +49,7 @@ function createProgram() {
         .option('--headed', 'request visible UI when the backend supports it')
         .option('--retries <n>', 'replace resolved retry count', parseNonNegativeInt)
         .option('--workers <n>', 'replace worker count', parseNonNegativeInt)
-        .option('--reporter <ids>', 'comma-separated reporters: list, json', parseList)
+        .option('--reporter <ids>', 'comma-separated reporters: list, json, junit', parseList)
         .option('--artifacts <dir>', 'artifact root, default .e2e/artifacts')
         .option('--no-cache', 'run without the trace cache, overriding the config')
         .option('--pass-with-no-tests', 'allow zero runnable ordinary test-target pairs')
@@ -67,24 +68,33 @@ function createProgram() {
             process.exitCode = 2;
             return;
         }
-        const outcome = await run({
-            files,
-            configPath: options.config,
-            targetIds: options.target,
-            tags: options.tag,
-            tagMode,
-            headed: options.headed,
-            retries: options.retries,
-            workers: options.workers,
-            // Validated above; the filter is the type narrowing, not a second check.
-            reporters: reporter?.filter(isReporter),
-            artifactsDir: options.artifacts,
-            noCache: options.cache === false,
-            passWithNoTests: options.passWithNoTests,
-            debug: options.debug,
-            aiTrace: options.aiTrace,
-        });
-        process.exitCode = outcome.exitCode;
+        const signals = new SignalLadder();
+        const release = signals.arm();
+        try {
+            const outcome = await run({
+                files,
+                configPath: options.config,
+                targetIds: options.target,
+                tags: options.tag,
+                tagMode,
+                headed: options.headed,
+                retries: options.retries,
+                workers: options.workers,
+                // Validated above; the filter is the type narrowing, not a second check.
+                reporters: reporter?.filter(isReporter),
+                artifactsDir: options.artifacts,
+                noCache: options.cache === false,
+                passWithNoTests: options.passWithNoTests,
+                debug: options.debug,
+                aiTrace: options.aiTrace,
+                interruptSignal: signals.interruptSignal,
+                forceSignal: signals.forceSignal,
+            });
+            process.exitCode = outcome.exitCode;
+        }
+        finally {
+            release();
+        }
     });
     return program;
 }

package/dist/cli/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":"AAAA,gCAAgC;AAEhC,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAC;AAC1E,OAAO,EAAE,GAAG,EAAE,MAAM,kBAAkB,CAAC;AACvC,OAAO,EAAE,IAAI,EAAoB,MAAM,WAAW,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAE5C,wEAAwE;AACxE,SAAS,mBAAmB,CAAC,KAAa;IACxC,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAC7B,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,MAAM,GAAG,CAAC,EAAE,CAAC;QAChD,MAAM,IAAI,oBAAoB,CAAC,+BAA+B,CAAC,CAAC;IAClE,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,SAAS,CAAC,KAAa;IAC9B,OAAO,KAAK;SACT,KAAK,CAAC,GAAG,CAAC;SACV,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;SAC1B,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,KAAK,EAAE,CAAC,CAAC;AACnC,CAAC;AAED,MAAM,SAAS,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAU,CAAC;AAGrD,SAAS,UAAU,CAAC,KAAa;IAC/B,OAAQ,SAA+B,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AAC1D,CAAC;AAED,SAAS,SAAS,CAAC,KAAa;IAC9B,OAAO,KAAK,KAAK,KAAK,IAAI,KAAK,KAAK,KAAK,CAAC;AAC5C,CAAC;AAED,oCAAoC;AACpC,SAAS,aAAa;IACpB,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC,KAAK,CAAC,CAAC;IACnC,OAAO,CAAC,WAAW,CAAC,2DAA2D,CAAC,CAAC;IACjF,6EAA6E;IAC7E,2EAA2E;IAC3E,OAAO,CAAC,YAAY,EAAE,CAAC;IAEvB,OAAO;SACJ,OAAO,CAAC,MAAM,CAAC;SACf,WAAW,CAAC,iFAAiF,CAAC;SAC9F,MAAM,CAAC,WAAW,EAAE,2DAA2D,CAAC;SAChF,MAAM,CAAC,KAAK,EAAE,OAAoB,EAAE,EAAE;QACrC,OAAO,CAAC,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,OAAO,CAAC,CAAC;IACxD,CAAC,CAAC,CAAC;IAEL,OAAO;SACJ,OAAO,CAAC,KAAK,CAAC;SACd,WAAW,CAAC,eAAe,CAAC;SAC5B,QAAQ,CAAC,YAAY,EAAE,yCAAyC,CAAC;SACjE,MAAM,CAAC,iBAAiB,EAAE,sBAAsB,CAAC;SACjD,MAAM,CAAC,gBAAgB,EAAE,4BAA4B,EAAE,SAAS,CAAC;SACjE,MAAM,CAAC,aAAa,EAAE,uBAAuB,EAAE,CAAC,KAAa,EAAE,QAAQ,GAAa,EAAE,EAAE,EAAE,CAAC,CAAC,GAAG,QAAQ,EAAE,KAAK,CAAC,CAAC;SAChH,MAAM,CAAC,mBAAmB,EAAE,6BAA6B,EAAE,KAAK,CAAC;SACjE,MAAM,CAAC,UAAU,EAAE,iDAAiD,CAAC;SACrE,MAAM,CAAC,eAAe,EAAE,8BAA8B,EAAE,mBAAmB,CAAC;SAC5E,MAAM,CAAC,eAAe,EAAE,sBAAsB,EAAE,mBAAmB,CAAC;SACpE,MAAM,CAAC,kBAAkB,EAAE,8CAA8C,EAAE,SAAS,CAAC;SACrF,MAAM,CAAC,mBAAmB,EAAE,uCAAuC,CAAC;SACpE,MAAM,CAAC,YAAY,EAAE,oDAAoD,CAAC;SAC1E,MAAM,CAAC,sBAAsB,EAAE,gDAAgD,CAAC;SAChF,MAAM,CAAC,SAAS,EAAE,wDAAwD,CAAC;SAC3E,MAAM,CAAC,YAAY,EAAE,iEAAiE,CAAC;SACvF,MAAM,CACL,KAAK,EACH,KAAe,EACf,OAeC,EACD,EAAE;QACF,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC;QACtC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC;YACxB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,uBAAuB,OAAO,0BAA0B,CAAC,CAAC;YAC/E,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;YACrB,OAAO;QACT,CAAC;QACD,MAAM,eAAe,GAAG,QAAQ,EAAE,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC;QACtE,IAAI,eAAe,KAAK,SAAS,EAAE,CAAC;YAClC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,qBAAqB,eAAe,KAAK,CAAC,CAAC;YAChE,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;YACrB,OAAO;QACT,CAAC;QACD,MAAM,OAAO,GAAG,IAAI,YAAY,EAAE,CAAC;QACnC,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;QAC9B,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,GAAG,CAAC;gBACxB,KAAK;gBACL,UAAU,EAAE,OAAO,CAAC,MAAM;gBAC1B,SAAS,EAAE,OAAO,CAAC,MAAM;gBACzB,IAAI,EAAE,OAAO,CAAC,GAAG;gBACjB,OAAO;gBACP,MAAM,EAAE,OAAO,CAAC,MAAM;gBACtB,OAAO,EAAE,OAAO,CAAC,OAAO;gBACxB,OAAO,EAAE,OAAO,CAAC,OAAO;gBACxB,yEAAyE;gBACzE,SAAS,EAAE,QAAQ,EAAE,MAAM,CAAC,UAAU,CAAC;gBACvC,YAAY,EAAE,OAAO,CAAC,SAAS;gBAC/B,OAAO,EAAE,OAAO,CAAC,KAAK,KAAK,KAAK;gBAChC,eAAe,EAAE,OAAO,CAAC,eAAe;gBACxC,KAAK,EAAE,OAAO,CAAC,KAAK;gBACpB,OAAO,EAAE,OAAO,CAAC,OAAO;gBACxB,eAAe,EAAE,OAAO,CAAC,eAAe;gBACxC,WAAW,EAAE,OAAO,CAAC,WAAW;aACjC,CAAC,CAAC;YACH,OAAO,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;QACtC,CAAC;gBAAS,CAAC;YACT,OAAO,EAAE,CAAC;QACZ,CAAC;IACH,CAAC,CACF,CAAC;IAEJ,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,4CAA4C;AAC5C,MAAM,CAAC,KAAK,UAAU,IAAI,CAAC,IAAuB;IAChD,MAAM,OAAO,GAAG,aAAa,EAAE,CAAC;IAChC,IAAI,CAAC;QACH,MAAM,OAAO,CAAC,UAAU,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC;IACtC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,cAAc,EAAE,CAAC;YACpC,6DAA6D;YAC7D,gEAAgE;YAChE,OAAO,CAAC,QAAQ,GAAG,KAAK,CAAC,QAAQ,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YAChD,OAAO;QACT,CAAC;QACD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACpF,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;IACvB,CAAC;AACH,CAAC"}

package/dist/cli/init/backends.d.ts

@@ -0,0 +1,75 @@
+/** CLI scaffold presets. Backend packages are referenced as generated source, never imported. */
+export interface BackendPreset {
+    readonly id: string;
+    readonly label: string;
+    readonly hint: string;
+    readonly dependencies: Readonly<Record<string, string>>;
+    readonly imports: readonly string[];
+    readonly config: string;
+    readonly example: string;
+    readonly aiExample?: string;
+    readonly runCommand: string;
+}
+/** Builds prompt choices and scaffolds with defaults for the machine running init. */
+export declare function getBackendPresets(): readonly [{
+    readonly id: 'none';
+    readonly label: 'None';
+    readonly hint: 'HTTP tests or your own backend';
+    readonly dependencies: {};
+    readonly imports: readonly [];
+    readonly config: `  app: { url: process.env.APP_URL ?? 'http://localhost:3000' },
+  // Add a backend here when your tests need to drive an app.
+  targets: [{ name: 'default', platform: 'custom' }],`;
+    readonly example: `import { test, expect } from '@e2edev/e2e';
+
+test('app responds', async () => {
+  const response = await fetch(process.env.APP_URL ?? 'http://localhost:3000');
+  expect(response.ok).toBe(true);
+});
+`;
+    readonly runCommand: 'APP_URL=http://localhost:3000 npx --no-install e2e run';
+}, {
+    readonly id: 'playwright';
+    readonly label: 'Playwright';
+    readonly hint: 'browser testing';
+    readonly dependencies: {
+        readonly '@e2edev/playwright': 'beta';
+    };
+    readonly imports: readonly ["import { playwright } from '@e2edev/playwright';"];
+    readonly config: `  app: { url: process.env.APP_URL ?? 'http://localhost:3000' },
+  targets: [{ name: 'web', platform: 'web', backend: playwright() }],`;
+    readonly example: `import { test } from '@e2edev/playwright';
+import { expect } from '@e2edev/e2e';
+
+test('app opens', async ({ app, web }) => {
+  await app.open();
+  await expect(web).toHaveURL('/');
+});
+`;
+    readonly aiExample: `
+// Runs when E2E_MODEL and E2E_MODEL_API_KEY are set:
+// test('the agent drives a flow', async ({ app, agent }) => {
+//   await app.open();
+//   await agent.act('one goal in plain language');
+//   await agent.assert('one question about the screen');
+// });
+`;
+    readonly runCommand: 'APP_URL=http://localhost:3000 npx --no-install e2e run';
+}, {
+    readonly id: 'agent-device';
+    readonly label: 'agent-device';
+    readonly hint: 'mobile testing: iOS and Android';
+    readonly dependencies: {
+        readonly '@e2edev/agent-device': 'beta';
+    };
+    readonly imports: readonly ["import { agentDevice } from '@e2edev/agent-device';"];
+    readonly config: "  // Requires Xcode and an iOS simulator. Replace Settings with your app's bundle ID.\n  targets: [{ name: 'ios', platform: 'ios', backend: agentDevice({ platform: 'ios', app: 'Settings' }) }],\n  workers: 1," | "  // Requires the Android SDK and an emulator. Replace com.android.settings with your app's package.\n  targets: [{ name: 'android', platform: 'android', backend: agentDevice({ platform: 'android', app: 'com.android.settings' }) }],\n  workers: 1,";
+    readonly example: "import { test } from '@e2edev/agent-device';\nimport { expect } from '@e2edev/e2e';\n\ntest('Settings opens', async ({ screen }) => {\n  await expect(screen.getByRole('button', { name: 'General' })).toBeVisible();\n});\n" | "import { test } from '@e2edev/agent-device';\nimport { expect } from '@e2edev/e2e';\n\ntest('Settings opens', async ({ screen }) => {\n  await expect(screen.getByText('Network & internet')).toBeVisible();\n});\n";
+    readonly aiExample: "\n// Runs when E2E_MODEL and E2E_MODEL_API_KEY are set:\n// test('the agent opens General', async ({ agent, device }) => {\n//   await agent.act('open General settings');\n//   await expect(device.locator('role=NavigationBar id=General')).toBeVisible();\n// });\n" | "\n// Runs when E2E_MODEL and E2E_MODEL_API_KEY are set:\n// test('the agent opens Network settings', async ({ agent, device }) => {\n//   await agent.act('open Network & internet settings');\n//   await expect(device.locator('id=com.android.settings:id/collapsing_toolbar')).toHaveText('Network & internet');\n// });\n";
+    readonly runCommand: 'npx --no-install e2e run';
+}];
+export type BackendId = ReturnType<typeof getBackendPresets>[number]['id'];
+export declare const DEFAULT_BACKEND_ID = "none";
+/** Resolves a preset with the common shape used by scaffold generation. */
+export declare function getBackendPreset(id: BackendId): BackendPreset;
+//# sourceMappingURL=backends.d.ts.map

package/dist/cli/init/backends.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backends.d.ts","sourceRoot":"","sources":["../../../src/cli/init/backends.ts"],"names":[],"mappings":"AAAA,iGAAiG;AAIjG,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,YAAY,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACxD,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED,sFAAsF;AACtF,wBAAgB,iBAAiB;iBAIvB,MAAM;oBACH,MAAM;mBACP,gCAAgC;;;qBAG9B;;sDAEwC;sBACvC;;;;;;CAMd;yBACiB,wDAAwD;;iBAGhE,YAAY;oBACT,YAAY;mBACb,iBAAiB;;iBACP,oBAAoB,EAAE,MAAM;;;qBAEpC;sEACwD;sBACvD;;;;;;;CAOd;wBACgB;;;;;;;CAOhB;yBACiB,wDAAwD;;iBAGhE,cAAc;oBACX,cAAc;mBACf,iCAAiC;;iBACvB,sBAAsB,EAAE,MAAM;;;;;;yBA+BlC,0BAA0B;GAG3C;AAED,MAAM,MAAM,SAAS,GAAG,UAAU,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC;AAC3E,eAAO,MAAM,kBAAkB,SAA6B,CAAC;AAE7D,2EAA2E;AAC3E,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,SAAS,GAAG,aAAa,CAI7D"}

package/dist/cli/init/backends.js

@@ -0,0 +1,98 @@
+/** CLI scaffold presets. Backend packages are referenced as generated source, never imported. */
+import os from 'node:os';
+/** Builds prompt choices and scaffolds with defaults for the machine running init. */
+export function getBackendPresets() {
+    const ios = os.platform() === 'darwin';
+    return [
+        {
+            id: 'none',
+            label: 'None',
+            hint: 'HTTP tests or your own backend',
+            dependencies: {},
+            imports: [],
+            config: `  app: { url: process.env.APP_URL ?? 'http://localhost:3000' },
+  // Add a backend here when your tests need to drive an app.
+  targets: [{ name: 'default', platform: 'custom' }],`,
+            example: `import { test, expect } from '@e2edev/e2e';
+
+test('app responds', async () => {
+  const response = await fetch(process.env.APP_URL ?? 'http://localhost:3000');
+  expect(response.ok).toBe(true);
+});
+`,
+            runCommand: 'APP_URL=http://localhost:3000 npx --no-install e2e run',
+        },
+        {
+            id: 'playwright',
+            label: 'Playwright',
+            hint: 'browser testing',
+            dependencies: { '@e2edev/playwright': 'beta' },
+            imports: ["import { playwright } from '@e2edev/playwright';"],
+            config: `  app: { url: process.env.APP_URL ?? 'http://localhost:3000' },
+  targets: [{ name: 'web', platform: 'web', backend: playwright() }],`,
+            example: `import { test } from '@e2edev/playwright';
+import { expect } from '@e2edev/e2e';
+
+test('app opens', async ({ app, web }) => {
+  await app.open();
+  await expect(web).toHaveURL('/');
+});
+`,
+            aiExample: `
+// Runs when E2E_MODEL and E2E_MODEL_API_KEY are set:
+// test('the agent drives a flow', async ({ app, agent }) => {
+//   await app.open();
+//   await agent.act('one goal in plain language');
+//   await agent.assert('one question about the screen');
+// });
+`,
+            runCommand: 'APP_URL=http://localhost:3000 npx --no-install e2e run',
+        },
+        {
+            id: 'agent-device',
+            label: 'agent-device',
+            hint: 'mobile testing: iOS and Android',
+            dependencies: { '@e2edev/agent-device': 'beta' },
+            imports: ["import { agentDevice } from '@e2edev/agent-device';"],
+            config: ios
+                ? `  // Requires Xcode and an iOS simulator. Replace Settings with your app's bundle ID.
+  targets: [{ name: 'ios', platform: 'ios', backend: agentDevice({ platform: 'ios', app: 'Settings' }) }],
+  workers: 1,`
+                : `  // Requires the Android SDK and an emulator. Replace com.android.settings with your app's package.
+  targets: [{ name: 'android', platform: 'android', backend: agentDevice({ platform: 'android', app: 'com.android.settings' }) }],
+  workers: 1,`,
+            example: `import { test } from '@e2edev/agent-device';
+import { expect } from '@e2edev/e2e';
+
+test('Settings opens', async ({ screen }) => {
+  await expect(${ios ? "screen.getByRole('button', { name: 'General' })" : "screen.getByText('Network & internet')"}).toBeVisible();
+});
+`,
+            aiExample: ios
+                ? `
+// Runs when E2E_MODEL and E2E_MODEL_API_KEY are set:
+// test('the agent opens General', async ({ agent, device }) => {
+//   await agent.act('open General settings');
+//   await expect(device.locator('role=NavigationBar id=General')).toBeVisible();
+// });
+`
+                : `
+// Runs when E2E_MODEL and E2E_MODEL_API_KEY are set:
+// test('the agent opens Network settings', async ({ agent, device }) => {
+//   await agent.act('open Network & internet settings');
+//   await expect(device.locator('id=com.android.settings:id/collapsing_toolbar')).toHaveText('Network & internet');
+// });
+`,
+            runCommand: 'npx --no-install e2e run',
+        },
+    ];
+}
+export const DEFAULT_BACKEND_ID = 'none';
+/** Resolves a preset with the common shape used by scaffold generation. */
+export function getBackendPreset(id) {
+    const preset = getBackendPresets().find((entry) => entry.id === id);
+    if (preset === undefined)
+        throw new Error(`unknown backend: ${id}`);
+    return preset;
+}
+//# sourceMappingURL=backends.js.map

package/dist/cli/init/backends.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"backends.js","sourceRoot":"","sources":["../../../src/cli/init/backends.ts"],"names":[],"mappings":"AAAA,iGAAiG;AAEjG,OAAO,EAAE,MAAM,SAAS,CAAC;AAczB,sFAAsF;AACtF,MAAM,UAAU,iBAAiB;IAC/B,MAAM,GAAG,GAAG,EAAE,CAAC,QAAQ,EAAE,KAAK,QAAQ,CAAC;IACvC,OAAO;QACL;YACE,EAAE,EAAE,MAAM;YACV,KAAK,EAAE,MAAM;YACb,IAAI,EAAE,gCAAgC;YACtC,YAAY,EAAE,EAAE;YAChB,OAAO,EAAE,EAAE;YACX,MAAM,EAAE;;sDAEwC;YAChD,OAAO,EAAE;;;;;;CAMd;YACK,UAAU,EAAE,wDAAwD;SACrE;QACD;YACE,EAAE,EAAE,YAAY;YAChB,KAAK,EAAE,YAAY;YACnB,IAAI,EAAE,iBAAiB;YACvB,YAAY,EAAE,EAAE,oBAAoB,EAAE,MAAM,EAAE;YAC9C,OAAO,EAAE,CAAC,kDAAkD,CAAC;YAC7D,MAAM,EAAE;sEACwD;YAChE,OAAO,EAAE;;;;;;;CAOd;YACK,SAAS,EAAE;;;;;;;CAOhB;YACK,UAAU,EAAE,wDAAwD;SACrE;QACD;YACE,EAAE,EAAE,cAAc;YAClB,KAAK,EAAE,cAAc;YACrB,IAAI,EAAE,iCAAiC;YACvC,YAAY,EAAE,EAAE,sBAAsB,EAAE,MAAM,EAAE;YAChD,OAAO,EAAE,CAAC,qDAAqD,CAAC;YAChE,MAAM,EAAE,GAAG;gBACT,CAAC,CAAC;;cAEI;gBACN,CAAC,CAAC;;cAEI;YACR,OAAO,EAAE;;;;iBAIE,GAAG,CAAC,CAAC,CAAC,iDAAiD,CAAC,CAAC,CAAC,wCAAwC;;CAElH;YACK,SAAS,EAAE,GAAG;gBACZ,CAAC,CAAC;;;;;;CAMT;gBACO,CAAC,CAAC;;;;;;CAMT;YACK,UAAU,EAAE,0BAA0B;SACvC;KAC0C,CAAC;AAChD,CAAC;AAGD,MAAM,CAAC,MAAM,kBAAkB,GAAG,MAA0B,CAAC;AAE7D,2EAA2E;AAC3E,MAAM,UAAU,gBAAgB,CAAC,EAAa;IAC5C,MAAM,MAAM,GAAG,iBAAiB,EAAE,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;IACpE,IAAI,MAAM,KAAK,SAAS;QAAE,MAAM,IAAI,KAAK,CAAC,oBAAoB,EAAE,EAAE,CAAC,CAAC;IACpE,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/cli/init/package.d.ts

@@ -0,0 +1,43 @@
+/** package.json reading, dependency additions, and package-manager detection for `e2e init`. */
+import { z } from 'zod';
+declare const packageSchema: z.ZodObject<{
+    dependencies: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    devDependencies: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    peerDependencies: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    optionalDependencies: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    packageManager: z.ZodOptional<z.ZodString>;
+}, z.core.$loose>;
+type PackageManifest = z.infer<typeof packageSchema>;
+/**
+ * Reads and validates the manifest, keeping its original text so edits can
+ * preserve formatting. A missing manifest starts as a private ESM package.
+ */
+export declare function readPackage(cwd: string): {
+    original: string | undefined;
+    manifest: {
+        [x: string]: unknown;
+        dependencies?: Record<string, string> | undefined;
+        devDependencies?: Record<string, string> | undefined;
+        peerDependencies?: Record<string, string> | undefined;
+        optionalDependencies?: Record<string, string> | undefined;
+        packageManager?: string | undefined;
+    };
+};
+/** Adds only missing dependencies to devDependencies and returns what was added. */
+export declare function addDependencies(manifest: PackageManifest, dependencies: Readonly<Record<string, string>>): {
+    manifest: {
+        [x: string]: unknown;
+        dependencies?: Record<string, string> | undefined;
+        devDependencies?: Record<string, string> | undefined;
+        peerDependencies?: Record<string, string> | undefined;
+        optionalDependencies?: Record<string, string> | undefined;
+        packageManager?: string | undefined;
+    };
+    additions: [string, string][];
+};
+/** The `packageManager` field wins, then a lockfile, then the manager that invoked the CLI, then npm. */
+export declare function detectPackageManager(cwd: string, manifest: PackageManifest): string;
+/** Serializes with the original manifest's indentation and newline convention. */
+export declare function serializePackage(manifest: PackageManifest, original: string | undefined): string;
+export {};
+//# sourceMappingURL=package.d.ts.map

package/dist/cli/init/package.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"package.d.ts","sourceRoot":"","sources":["../../../src/cli/init/package.ts"],"names":[],"mappings":"AAAA,gGAAgG;AAIhG,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,QAAA,MAAM,aAAa;;;;;;iBAMjB,CAAC;AACH,KAAK,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AAWrD;;;GAGG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM;;;;;;;;;;EAKtC;AAQD,oFAAoF;AACpF,wBAAgB,eAAe,CAAC,QAAQ,EAAE,eAAe,EAAE,YAAY,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;;;;;;;;;;EAOxG;AAED,yGAAyG;AACzG,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,eAAe,GAAG,MAAM,CAQnF;AAED,kFAAkF;AAClF,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAIhG"}

package/dist/cli/init/package.js

@@ -0,0 +1,64 @@
+/** package.json reading, dependency additions, and package-manager detection for `e2e init`. */
+import { existsSync, readFileSync } from 'node:fs';
+import path from 'node:path';
+import { z } from 'zod';
+const dependencyBlock = z.record(z.string(), z.string()).optional();
+const packageSchema = z.looseObject({
+    dependencies: dependencyBlock,
+    devDependencies: dependencyBlock,
+    peerDependencies: dependencyBlock,
+    optionalDependencies: dependencyBlock,
+    packageManager: z.string().optional(),
+});
+const PACKAGE_MANAGERS = new Set(['npm', 'pnpm', 'yarn', 'bun']);
+const LOCKFILES = [
+    ['pnpm-lock.yaml', 'pnpm'],
+    ['yarn.lock', 'yarn'],
+    ['bun.lock', 'bun'],
+    ['bun.lockb', 'bun'],
+    ['package-lock.json', 'npm'],
+];
+/**
+ * Reads and validates the manifest, keeping its original text so edits can
+ * preserve formatting. A missing manifest starts as a private ESM package.
+ */
+export function readPackage(cwd) {
+    const manifestPath = path.join(cwd, 'package.json');
+    const original = existsSync(manifestPath) ? readFileSync(manifestPath, 'utf8') : undefined;
+    const manifest = packageSchema.parse(original === undefined ? { private: true, type: 'module' } : JSON.parse(original));
+    return { original, manifest };
+}
+/** True when any dependency section lists `name`, so existing versions and workspace links are kept. */
+function declaresDependency(manifest, name) {
+    return [manifest.dependencies, manifest.devDependencies, manifest.peerDependencies, manifest.optionalDependencies]
+        .some((block) => block?.[name] !== undefined);
+}
+/** Adds only missing dependencies to devDependencies and returns what was added. */
+export function addDependencies(manifest, dependencies) {
+    const additions = Object.entries(dependencies).filter(([name]) => !declaresDependency(manifest, name));
+    if (additions.length === 0)
+        return { manifest, additions };
+    return {
+        manifest: { ...manifest, devDependencies: { ...manifest.devDependencies, ...Object.fromEntries(additions) } },
+        additions,
+    };
+}
+/** The `packageManager` field wins, then a lockfile, then the manager that invoked the CLI, then npm. */
+export function detectPackageManager(cwd, manifest) {
+    const configured = manifest.packageManager?.split('@')[0];
+    if (configured !== undefined && PACKAGE_MANAGERS.has(configured))
+        return configured;
+    for (const [lock, manager] of LOCKFILES) {
+        if (existsSync(path.join(cwd, lock)))
+            return manager;
+    }
+    const invoking = process.env['npm_config_user_agent']?.split('/')[0];
+    return invoking !== undefined && PACKAGE_MANAGERS.has(invoking) ? invoking : 'npm';
+}
+/** Serializes with the original manifest's indentation and newline convention. */
+export function serializePackage(manifest, original) {
+    const indent = original?.match(/\n([\t ]+)"/)?.[1] ?? '  ';
+    const newline = original?.includes('\r\n') ? '\r\n' : '\n';
+    return `${JSON.stringify(manifest, null, indent).replaceAll('\n', newline)}${newline}`;
+}
+//# sourceMappingURL=package.js.map

package/dist/cli/init/package.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"package.js","sourceRoot":"","sources":["../../../src/cli/init/package.ts"],"names":[],"mappings":"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"}

package/dist/cli/init/scaffold.d.ts

@@ -0,0 +1,12 @@
+import { type BackendId } from './backends.ts';
+/** Composes common setup, the selected backend, and optional AI support. */
+export declare function createScaffold(backendId: BackendId, ai: boolean): {
+    dependencies: {
+        '@e2edev/e2e': string;
+        ai?: string;
+    };
+    config: string;
+    example: string;
+    runCommand: string;
+};
+//# sourceMappingURL=scaffold.d.ts.map

package/dist/cli/init/scaffold.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scaffold.d.ts","sourceRoot":"","sources":["../../../src/cli/init/scaffold.ts"],"names":[],"mappings":"AACA,OAAO,EAAoB,KAAK,SAAS,EAAE,MAAM,eAAe,CAAC;AAQjE,4EAA4E;AAC5E,wBAAgB,cAAc,CAAC,SAAS,EAAE,SAAS,EAAE,EAAE,EAAE,OAAO;;;;;;;;EA2B/D"}

package/dist/cli/init/scaffold.js

@@ -0,0 +1,36 @@
+import { packageVersion } from '../../internal/package-version.js';
+import { getBackendPreset } from './backends.js';
+const AGENT_IMPORT = "import { createAgent } from '@e2edev/e2e/agent';";
+const AGENT_CONFIG = `  // The model comes from E2E_MODEL; authenticate with E2E_MODEL_API_KEY.
+  agent: createAgent({
+    system: 'You are a thorough QA agent. Verify every outcome.',
+  }),`;
+/** Composes common setup, the selected backend, and optional AI support. */
+export function createScaffold(backendId, ai) {
+    const backend = getBackendPreset(backendId);
+    const imports = [
+        "import { defineConfig } from '@e2edev/e2e';",
+        ...(ai ? [AGENT_IMPORT] : []),
+        ...backend.imports,
+    ];
+    const configFields = [
+        ...(ai ? [AGENT_CONFIG] : []),
+        backend.config,
+    ];
+    return {
+        dependencies: {
+            '@e2edev/e2e': `^${packageVersion(import.meta.url, '../../../package.json', '0.0.0')}`,
+            ...backend.dependencies,
+            ...(ai ? { ai: '^7.0.0' } : {}),
+        },
+        config: `${imports.join('\n')}
+
+export default defineConfig({
+${configFields.join('\n')}
+});
+`,
+        example: backend.example + (ai ? backend.aiExample ?? '' : ''),
+        runCommand: backend.runCommand,
+    };
+}
+//# sourceMappingURL=scaffold.js.map

package/dist/cli/init/scaffold.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scaffold.js","sourceRoot":"","sources":["../../../src/cli/init/scaffold.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AACnE,OAAO,EAAE,gBAAgB,EAAkB,MAAM,eAAe,CAAC;AAEjE,MAAM,YAAY,GAAG,kDAAkD,CAAC;AACxE,MAAM,YAAY,GAAG;;;MAGf,CAAC;AAEP,4EAA4E;AAC5E,MAAM,UAAU,cAAc,CAAC,SAAoB,EAAE,EAAW;IAC9D,MAAM,OAAO,GAAG,gBAAgB,CAAC,SAAS,CAAC,CAAC;IAC5C,MAAM,OAAO,GAAG;QACd,6CAA6C;QAC7C,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAC7B,GAAG,OAAO,CAAC,OAAO;KACnB,CAAC;IACF,MAAM,YAAY,GAAG;QACnB,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAC7B,OAAO,CAAC,MAAM;KACf,CAAC;IAEF,OAAO;QACL,YAAY,EAAE;YACZ,aAAa,EAAE,IAAI,cAAc,CAAC,OAAO,IAAI,CAAC,GAAG,EAAE,uBAAuB,EAAE,OAAO,CAAC,EAAE;YACtF,GAAG,OAAO,CAAC,YAAY;YACvB,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAChC;QACD,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC;;;EAG/B,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC;;CAExB;QACG,OAAO,EAAE,OAAO,CAAC,OAAO,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC9D,UAAU,EAAE,OAAO,CAAC,UAAU;KAC/B,CAAC;AACJ,CAAC"}

package/dist/cli/init.d.ts

@@ -1,6 +1,11 @@
 /** Non-destructive project scaffolding (spec 06-cli.md). */
-/** Runs `e2e init`. Creates only missing files and stops before any conflict. */
-export declare function init(cwd: string, options?: {
+export interface InitOptions {
     yes?: boolean;
-}): Promise<number>;
+}
+/**
+ * Runs `e2e init`. Every prompt happens before the first write, existing
+ * config and test files are never touched, and dependencies install only when
+ * the user asks.
+ */
+export declare function init(cwd: string, options?: InitOptions): Promise<number>;
 //# sourceMappingURL=init.d.ts.map

package/dist/cli/init.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/cli/init.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAsD5D,iFAAiF;AACjF,wBAAsB,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE;IAAE,GAAG,CAAC,EAAE,OAAO,CAAA;CAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CA+DxF"}
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/cli/init.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAW5D,MAAM,WAAW,WAAW;IAC1B,GAAG,CAAC,EAAE,OAAO,CAAC;CACf;AAYD;;;;GAIG;AACH,wBAAsB,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE,WAAgB,GAAG,OAAO,CAAC,MAAM,CAAC,CAsGlF"}