letsrunit 0.0.1 → 0.3.3

package/dist/bin.js

@@ -0,0 +1,315 @@
+#!/usr/bin/env node
+
+// src/init.ts
+import { confirm, intro, log, note, outro, spinner } from "@clack/prompts";
+
+// src/detect.ts
+import { execSync } from "child_process";
+import { existsSync } from "fs";
+import { join } from "path";
+function detectEnvironment() {
+  const cwd = process.cwd();
+  const isInteractive = Boolean(process.stdout.isTTY && process.stdin.isTTY);
+  let packageManager = "npm";
+  if (existsSync(join(cwd, "yarn.lock"))) packageManager = "yarn";
+  else if (existsSync(join(cwd, "pnpm-lock.yaml"))) packageManager = "pnpm";
+  else if (existsSync(join(cwd, "bun.lockb")) || existsSync(join(cwd, "bun.lock"))) packageManager = "bun";
+  const nodeVersion = parseInt(process.version.slice(1), 10);
+  const hasCucumber = existsSync(join(cwd, "node_modules", "@cucumber", "cucumber", "package.json"));
+  return { isInteractive, packageManager, nodeVersion, hasCucumber, cwd };
+}
+function pmCmd(pm, args2) {
+  if (pm === "yarn") return `yarn ${args2.yarn}`;
+  if (pm === "pnpm") return `pnpm ${args2.pnpm}`;
+  if (pm === "bun") return `bun ${args2.bun}`;
+  return `npm ${args2.npm}`;
+}
+function execPm(env, args2) {
+  const cmd = pmCmd(env.packageManager, args2);
+  return execSync(cmd, { stdio: "inherit", cwd: env.cwd });
+}
+
+// src/setup/cli.ts
+import { existsSync as existsSync2, readFileSync } from "fs";
+import { join as join2 } from "path";
+function isCliInstalled({ cwd }) {
+  const pkgPath = join2(cwd, "package.json");
+  if (!existsSync2(pkgPath)) return false;
+  const pkg = JSON.parse(readFileSync(pkgPath, "utf-8"));
+  return "@letsrunit/cli" in (pkg.devDependencies ?? {}) || "@letsrunit/cli" in (pkg.dependencies ?? {});
+}
+function installCli(env) {
+  execPm(env, {
+    npm: "install --save-dev @letsrunit/cli",
+    yarn: "add --dev @letsrunit/cli",
+    pnpm: "add -D @letsrunit/cli",
+    bun: "add -d @letsrunit/cli"
+  });
+}
+
+// src/setup/cucumber.ts
+import { existsSync as existsSync3, mkdirSync, readdirSync, readFileSync as readFileSync2, writeFileSync } from "fs";
+import { join as join3 } from "path";
+var BDD_IMPORT = "@letsrunit/bdd/define";
+var CUCUMBER_CONFIG = `export default {
+  worldParameters: {
+    baseURL: 'http://localhost:3000',
+  },
+};
+`;
+var SUPPORT_FILE = `import { setDefaultTimeout } from '@cucumber/cucumber';
+import '${BDD_IMPORT}';
+
+setDefaultTimeout(30_000);
+`;
+var EXAMPLE_FEATURE = `Feature: Example
+  Scenario: Homepage loads
+    Given I'm on the homepage
+    Then The page contains heading "Welcome"
+`;
+function installCucumber(env) {
+  execPm(env, {
+    npm: "install --save-dev @cucumber/cucumber",
+    yarn: "add --dev @cucumber/cucumber",
+    pnpm: "add -D @cucumber/cucumber",
+    bun: "add -d @cucumber/cucumber"
+  });
+}
+function installBdd(env) {
+  const pkgPath = join3(env.cwd, "package.json");
+  if (!existsSync3(pkgPath)) return false;
+  const pkg = JSON.parse(readFileSync2(pkgPath, "utf-8"));
+  const alreadyInstalled = "@letsrunit/bdd" in (pkg.devDependencies ?? {}) || "@letsrunit/bdd" in (pkg.dependencies ?? {});
+  if (alreadyInstalled) return false;
+  execPm(env, {
+    npm: "install --save-dev @letsrunit/bdd",
+    yarn: "add --dev @letsrunit/bdd",
+    pnpm: "add -D @letsrunit/bdd",
+    bun: "add -d @letsrunit/bdd"
+  });
+  return true;
+}
+function setupCucumberConfig({ cwd }) {
+  const supportDir = join3(cwd, "features", "support");
+  const supportPath = join3(supportDir, "world.js");
+  if (existsSync3(supportPath)) {
+    const content = readFileSync2(supportPath, "utf-8");
+    if (content.includes(BDD_IMPORT)) return "skipped";
+    return "needs-manual-update";
+  }
+  const configPath = join3(cwd, "cucumber.js");
+  if (!existsSync3(configPath)) {
+    writeFileSync(configPath, CUCUMBER_CONFIG, "utf-8");
+  }
+  mkdirSync(supportDir, { recursive: true });
+  writeFileSync(supportPath, SUPPORT_FILE, "utf-8");
+  return "created";
+}
+function setupFeaturesDir({ cwd }) {
+  if (existsSync3(join3(cwd, "features"))) {
+    try {
+      const hasFeatureFiles = readdirSync(join3(cwd, "features")).some((f) => f.endsWith(".feature"));
+      if (hasFeatureFiles) return false;
+    } catch {
+      return false;
+    }
+  }
+  try {
+    const hasFeatureAtRoot = readdirSync(cwd).some((f) => f.endsWith(".feature"));
+    if (hasFeatureAtRoot) return false;
+  } catch {
+    return false;
+  }
+  mkdirSync(join3(cwd, "features"), { recursive: true });
+  writeFileSync(join3(cwd, "features", "example.feature"), EXAMPLE_FEATURE, "utf-8");
+  return true;
+}
+function setupCucumber(env) {
+  const bddInstalled = installBdd(env);
+  const configResult = setupCucumberConfig(env);
+  const featuresCreated = setupFeaturesDir(env);
+  return { bddInstalled, configResult, featuresCreated };
+}
+
+// src/setup/github-actions.ts
+import { existsSync as existsSync4, mkdirSync as mkdirSync2, writeFileSync as writeFileSync2 } from "fs";
+import { join as join4 } from "path";
+function setupStepsFor({ packageManager, nodeVersion }) {
+  if (packageManager === "yarn") return `      - name: Enable Corepack
+        run: corepack enable
+      - uses: actions/setup-node@v4
+        with:
+          node-version: ${nodeVersion}
+          cache: yarn
+      - name: Install dependencies
+        run: yarn install --immutable`;
+  if (packageManager === "pnpm") return `      - uses: pnpm/action-setup@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: ${nodeVersion}
+          cache: pnpm
+      - name: Install dependencies
+        run: pnpm install --frozen-lockfile`;
+  if (packageManager === "bun") return `      - uses: oven-sh/setup-bun@v2
+      - name: Install dependencies
+        run: bun install --frozen-lockfile`;
+  return `      - uses: actions/setup-node@v4
+        with:
+          node-version: ${nodeVersion}
+          cache: npm
+      - name: Install dependencies
+        run: npm ci`;
+}
+function workflowYaml(env) {
+  const setupSteps = setupStepsFor(env);
+  return `name: Features
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+jobs:
+  features:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+${setupSteps}
+      - name: Install Playwright browsers
+        run: npx playwright install chromium --with-deps
+      - name: Run features
+        run: npx cucumber-js
+`;
+}
+function installGithubAction(env) {
+  const workflowDir = join4(env.cwd, ".github", "workflows");
+  const workflowPath = join4(workflowDir, "letsrunit.yml");
+  if (existsSync4(workflowPath)) return "skipped";
+  mkdirSync2(workflowDir, { recursive: true });
+  writeFileSync2(workflowPath, workflowYaml(env), "utf-8");
+  return "created";
+}
+
+// src/setup/playwright.ts
+import { execSync as execSync2 } from "child_process";
+import { existsSync as existsSync5 } from "fs";
+import { join as join5 } from "path";
+function hasPlaywrightBrowsers({ cwd }) {
+  if (!existsSync5(join5(cwd, "node_modules", "playwright-core", "package.json"))) {
+    return false;
+  }
+  try {
+    const execPath = execSync2(
+      `node -e "console.log(require('playwright-core').chromium.executablePath())"`,
+      { cwd, stdio: "pipe", encoding: "utf-8" }
+    ).trim();
+    return existsSync5(execPath);
+  } catch {
+    return false;
+  }
+}
+function installPlaywrightBrowsers(env) {
+  execPm(env, {
+    npm: "exec playwright install chromium",
+    yarn: "exec playwright install chromium",
+    pnpm: "exec playwright install chromium",
+    bun: "x playwright install chromium"
+  });
+}
+
+// src/init.ts
+var BDD_IMPORT2 = "@letsrunit/bdd/define";
+async function stepInstallCli(env) {
+  if (isCliInstalled(env)) {
+    log.success("@letsrunit/cli already installed");
+    return;
+  }
+  const s = spinner();
+  s.start("Installing @letsrunit/cli\u2026");
+  installCli(env);
+  s.stop("@letsrunit/cli installed");
+}
+async function stepEnsureCucumber(env, { yes: yes2 }) {
+  if (env.hasCucumber) return true;
+  if (!yes2 && !env.isInteractive) {
+    log.warn("@cucumber/cucumber not found. Install it to use letsrunit with Cucumber:");
+    note("npm install --save-dev @cucumber/cucumber\nThen run: npx letsrunit init", "Setup Cucumber");
+    return false;
+  }
+  if (!yes2) {
+    const install = await confirm({ message: "@cucumber/cucumber not found. Install it now?" });
+    if (install !== true) return false;
+  }
+  const s = spinner();
+  s.start("Installing @cucumber/cucumber\u2026");
+  installCucumber(env);
+  s.stop("@cucumber/cucumber installed");
+  return true;
+}
+function stepSetupCucumber(env) {
+  const result = setupCucumber(env);
+  if (result.bddInstalled) log.success("@letsrunit/bdd installed");
+  if (result.configResult === "created") {
+    log.success("features/support/world.js created");
+  } else if (result.configResult === "needs-manual-update") {
+    log.warn("features/support/world.js exists but does not import @letsrunit/bdd.");
+    note(`Add "import '${BDD_IMPORT2}';" to features/support/world.js`, "Action required");
+  }
+  if (result.featuresCreated) log.success("features/ directory created with example.feature");
+}
+async function stepCheckPlaywrightBrowsers(env, { yes: yes2 }) {
+  if (hasPlaywrightBrowsers(env)) return;
+  if (!yes2 && !env.isInteractive) {
+    log.warn("Playwright Chromium browser not found.");
+    note("npx playwright install chromium", "Run to install browsers");
+    return;
+  }
+  if (!yes2) {
+    const install = await confirm({ message: "Playwright Chromium browser not found. Install it now?" });
+    if (install !== true) return;
+  }
+  const s = spinner();
+  s.start("Installing Playwright Chromium\u2026");
+  installPlaywrightBrowsers(env);
+  s.stop("Playwright Chromium installed");
+}
+async function stepAddGithubAction(env, { yes: yes2 }) {
+  if (!yes2 && !env.isInteractive) return;
+  if (!yes2) {
+    const addAction = await confirm({ message: "Add a GitHub Action to run features on push?" });
+    if (addAction !== true) return;
+  }
+  const result = installGithubAction(env);
+  if (result === "created") {
+    log.success(".github/workflows/letsrunit.yml created");
+  } else {
+    log.info(".github/workflows/letsrunit.yml already exists, skipped");
+  }
+}
+async function init(options = {}) {
+  intro("letsrunit init");
+  const env = detectEnvironment();
+  await stepInstallCli(env);
+  const hasCucumber = await stepEnsureCucumber(env, options);
+  if (hasCucumber) {
+    stepSetupCucumber(env);
+    await stepCheckPlaywrightBrowsers(env, options);
+    await stepAddGithubAction(env, options);
+  }
+  outro("All done! Run npx letsrunit --help to get started.");
+}
+
+// src/bin.ts
+var args = process.argv.slice(2);
+var command = args.find((a) => !a.startsWith("-")) ?? "init";
+var yes = args.includes("--yes") || args.includes("-y");
+if (command === "init") {
+  init({ yes }).catch((err) => {
+    console.error(err instanceof Error ? err.message : String(err));
+    process.exit(1);
+  });
+} else {
+  console.error(`Unknown command: ${command}`);
+  console.error("Usage: letsrunit init [--yes]");
+  process.exit(1);
+}
+//# sourceMappingURL=bin.js.map

package/dist/bin.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/init.ts","../src/detect.ts","../src/setup/cli.ts","../src/setup/cucumber.ts","../src/setup/github-actions.ts","../src/setup/playwright.ts","../src/bin.ts"],"sourcesContent":["import { confirm, intro, log, note, outro, spinner } from '@clack/prompts';\nimport { detectEnvironment, type Environment } from './detect.js';\nimport { installCli, isCliInstalled } from './setup/cli.js';\nimport { installCucumber, setupCucumber } from './setup/cucumber.js';\nimport { installGithubAction } from './setup/github-actions.js';\nimport { hasPlaywrightBrowsers, installPlaywrightBrowsers } from './setup/playwright.js';\n\nconst BDD_IMPORT = '@letsrunit/bdd/define';\n\nexport interface InitOptions {\n  yes?: boolean;\n}\n\nasync function stepInstallCli(env: Environment): Promise<void> {\n  if (isCliInstalled(env)) {\n    log.success('@letsrunit/cli already installed');\n    return;\n  }\n\n  const s = spinner();\n  s.start('Installing @letsrunit/cli…');\n  installCli(env);\n  s.stop('@letsrunit/cli installed');\n}\n\nasync function stepEnsureCucumber(env: Environment, { yes }: InitOptions): Promise<boolean> {\n  if (env.hasCucumber) return true;\n\n  if (!yes && !env.isInteractive) {\n    log.warn('@cucumber/cucumber not found. Install it to use letsrunit with Cucumber:');\n    note('npm install --save-dev @cucumber/cucumber\\nThen run: npx letsrunit init', 'Setup Cucumber');\n    return false;\n  }\n\n  if (!yes) {\n    const install = await confirm({ message: '@cucumber/cucumber not found. Install it now?' });\n    if (install !== true) return false;\n  }\n\n  const s = spinner();\n  s.start('Installing @cucumber/cucumber…');\n  installCucumber(env);\n  s.stop('@cucumber/cucumber installed');\n  return true;\n}\n\nfunction stepSetupCucumber(env: Environment): void {\n  const result = setupCucumber(env);\n\n  if (result.bddInstalled) log.success('@letsrunit/bdd installed');\n\n  if (result.configResult === 'created') {\n    log.success('features/support/world.js created');\n  } else if (result.configResult === 'needs-manual-update') {\n    log.warn('features/support/world.js exists but does not import @letsrunit/bdd.');\n    note(`Add \"import '${BDD_IMPORT}';\" to features/support/world.js`, 'Action required');\n  }\n\n  if (result.featuresCreated) log.success('features/ directory created with example.feature');\n}\n\nasync function stepCheckPlaywrightBrowsers(env: Environment, { yes }: InitOptions): Promise<void> {\n  if (hasPlaywrightBrowsers(env)) return;\n\n  if (!yes && !env.isInteractive) {\n    log.warn('Playwright Chromium browser not found.');\n    note('npx playwright install chromium', 'Run to install browsers');\n    return;\n  }\n\n  if (!yes) {\n    const install = await confirm({ message: 'Playwright Chromium browser not found. Install it now?' });\n    if (install !== true) return;\n  }\n\n  const s = spinner();\n  s.start('Installing Playwright Chromium…');\n  installPlaywrightBrowsers(env);\n  s.stop('Playwright Chromium installed');\n}\n\nasync function stepAddGithubAction(env: Environment, { yes }: InitOptions): Promise<void> {\n  if (!yes && !env.isInteractive) return;\n\n  if (!yes) {\n    const addAction = await confirm({ message: 'Add a GitHub Action to run features on push?' });\n    if (addAction !== true) return;\n  }\n\n  const result = installGithubAction(env);\n  if (result === 'created') {\n    log.success('.github/workflows/letsrunit.yml created');\n  } else {\n    log.info('.github/workflows/letsrunit.yml already exists, skipped');\n  }\n}\n\nexport async function init(options: InitOptions = {}): Promise<void> {\n  intro('letsrunit init');\n\n  const env = detectEnvironment();\n\n  await stepInstallCli(env);\n\n  const hasCucumber = await stepEnsureCucumber(env, options);\n  if (hasCucumber) {\n    stepSetupCucumber(env);\n    await stepCheckPlaywrightBrowsers(env, options);\n    await stepAddGithubAction(env, options);\n  }\n\n  outro('All done! Run npx letsrunit --help to get started.');\n}\n","import { execSync } from 'node:child_process';\nimport { existsSync } from 'node:fs';\nimport { join } from 'node:path';\n\nexport type PackageManager = 'yarn' | 'pnpm' | 'bun' | 'npm';\n\nexport interface Environment {\n  isInteractive: boolean;\n  packageManager: PackageManager;\n  nodeVersion: number;\n  hasCucumber: boolean;\n  cwd: string;\n}\n\nexport interface PackageManagerArgs {\n  npm: string;\n  yarn: string;\n  pnpm: string;\n  bun: string;\n}\n\nexport function detectEnvironment(): Environment {\n  const cwd = process.cwd();\n  const isInteractive = Boolean(process.stdout.isTTY && process.stdin.isTTY);\n\n  let packageManager: PackageManager = 'npm';\n  if (existsSync(join(cwd, 'yarn.lock'))) packageManager = 'yarn';\n  else if (existsSync(join(cwd, 'pnpm-lock.yaml'))) packageManager = 'pnpm';\n  else if (existsSync(join(cwd, 'bun.lockb')) || existsSync(join(cwd, 'bun.lock'))) packageManager = 'bun';\n\n  const nodeVersion = parseInt(process.version.slice(1), 10);\n  const hasCucumber = existsSync(join(cwd, 'node_modules', '@cucumber', 'cucumber', 'package.json'));\n\n  return { isInteractive, packageManager, nodeVersion, hasCucumber, cwd };\n}\n\nfunction pmCmd(pm: string, args: PackageManagerArgs): string {\n  if (pm === 'yarn') return `yarn ${args.yarn}`;\n  if (pm === 'pnpm') return `pnpm ${args.pnpm}`;\n  if (pm === 'bun') return `bun ${args.bun}`;\n  return `npm ${args.npm}`;\n}\n\nexport function execPm(env: Pick<Environment, 'packageManager' | 'cwd'>, args: PackageManagerArgs) {\n  const cmd = pmCmd(env.packageManager, args);\n  return execSync(cmd, { stdio: 'inherit', cwd: env.cwd });\n}\n","import { existsSync, readFileSync } from 'node:fs';\nimport { join } from 'node:path';\nimport { type Environment, execPm } from '../detect.js';\n\nexport function isCliInstalled({ cwd }: Pick<Environment, 'cwd'>): boolean {\n  const pkgPath = join(cwd, 'package.json');\n  if (!existsSync(pkgPath)) return false;\n\n  const pkg = JSON.parse(readFileSync(pkgPath, 'utf-8')) as {\n    devDependencies?: Record<string, string>;\n    dependencies?: Record<string, string>;\n  };\n\n  return '@letsrunit/cli' in (pkg.devDependencies ?? {}) || '@letsrunit/cli' in (pkg.dependencies ?? {});\n}\n\nexport function installCli(env: Pick<Environment, 'packageManager' | 'cwd'>): void {\n  execPm(env, {\n    npm: 'install --save-dev @letsrunit/cli',\n    yarn: 'add --dev @letsrunit/cli',\n    pnpm: 'add -D @letsrunit/cli',\n    bun: 'add -d @letsrunit/cli',\n  });\n}\n","import { existsSync, mkdirSync, readdirSync, readFileSync, writeFileSync } from 'node:fs';\nimport { join } from 'node:path';\nimport { type Environment, execPm } from '../detect.js';\n\nconst BDD_IMPORT = '@letsrunit/bdd/define';\n\nconst CUCUMBER_CONFIG = `export default {\n  worldParameters: {\n    baseURL: 'http://localhost:3000',\n  },\n};\n`;\n\nconst SUPPORT_FILE = `import { setDefaultTimeout } from '@cucumber/cucumber';\nimport '${BDD_IMPORT}';\n\nsetDefaultTimeout(30_000);\n`;\n\nconst EXAMPLE_FEATURE = `Feature: Example\n  Scenario: Homepage loads\n    Given I'm on the homepage\n    Then The page contains heading \"Welcome\"\n`;\n\nexport type CucumberConfigResult = 'created' | 'skipped' | 'needs-manual-update';\n\nexport interface CucumberSetupResult {\n  bddInstalled: boolean;\n  configResult: CucumberConfigResult;\n  featuresCreated: boolean;\n}\n\nexport function installCucumber(env: Pick<Environment, 'packageManager' | 'cwd'>): void {\n  execPm(env, {\n    npm: 'install --save-dev @cucumber/cucumber',\n    yarn: 'add --dev @cucumber/cucumber',\n    pnpm: 'add -D @cucumber/cucumber',\n    bun: 'add -d @cucumber/cucumber',\n  });\n}\n\nfunction installBdd(env: Pick<Environment, 'packageManager' | 'cwd'>): boolean {\n  const pkgPath = join(env.cwd, 'package.json');\n  if (!existsSync(pkgPath)) return false;\n\n  const pkg = JSON.parse(readFileSync(pkgPath, 'utf-8')) as {\n    devDependencies?: Record<string, string>;\n    dependencies?: Record<string, string>;\n  };\n\n  const alreadyInstalled =\n    '@letsrunit/bdd' in (pkg.devDependencies ?? {}) || '@letsrunit/bdd' in (pkg.dependencies ?? {});\n\n  if (alreadyInstalled) return false;\n\n  execPm(env, {\n    npm: 'install --save-dev @letsrunit/bdd',\n    yarn: 'add --dev @letsrunit/bdd',\n    pnpm: 'add -D @letsrunit/bdd',\n    bun: 'add -d @letsrunit/bdd',\n  });\n\n  return true;\n}\n\nfunction setupCucumberConfig({ cwd }: Pick<Environment, 'cwd'>): CucumberConfigResult {\n  const supportDir = join(cwd, 'features', 'support');\n  const supportPath = join(supportDir, 'world.js');\n\n  if (existsSync(supportPath)) {\n    const content = readFileSync(supportPath, 'utf-8');\n    if (content.includes(BDD_IMPORT)) return 'skipped';\n    return 'needs-manual-update';\n  }\n\n  const configPath = join(cwd, 'cucumber.js');\n  if (!existsSync(configPath)) {\n    writeFileSync(configPath, CUCUMBER_CONFIG, 'utf-8');\n  }\n\n  mkdirSync(supportDir, { recursive: true });\n  writeFileSync(supportPath, SUPPORT_FILE, 'utf-8');\n  return 'created';\n}\n\nfunction setupFeaturesDir({ cwd }: Pick<Environment, 'cwd'>): boolean {\n  if (existsSync(join(cwd, 'features'))) {\n    try {\n      const hasFeatureFiles = readdirSync(join(cwd, 'features')).some((f) => f.endsWith('.feature'));\n      if (hasFeatureFiles) return false;\n    } catch {\n      return false;\n    }\n  }\n\n  try {\n    const hasFeatureAtRoot = readdirSync(cwd).some((f) => f.endsWith('.feature'));\n    if (hasFeatureAtRoot) return false;\n  } catch {\n    return false;\n  }\n\n  mkdirSync(join(cwd, 'features'), { recursive: true });\n  writeFileSync(join(cwd, 'features', 'example.feature'), EXAMPLE_FEATURE, 'utf-8');\n  return true;\n}\n\nexport function setupCucumber(env: Pick<Environment, 'packageManager' | 'cwd'>): CucumberSetupResult {\n  const bddInstalled = installBdd(env);\n  const configResult = setupCucumberConfig(env);\n  const featuresCreated = setupFeaturesDir(env);\n  return { bddInstalled, configResult, featuresCreated };\n}\n","import { existsSync, mkdirSync, writeFileSync } from 'node:fs';\nimport { join } from 'node:path';\nimport type { Environment } from '../detect.js';\n\nexport type GithubActionsResult = 'created' | 'skipped';\n\nfunction setupStepsFor({ packageManager, nodeVersion }: Pick<Environment, 'packageManager' | 'nodeVersion'>): string {\n  if (packageManager === 'yarn') return `\\\n      - name: Enable Corepack\n        run: corepack enable\n      - uses: actions/setup-node@v4\n        with:\n          node-version: ${nodeVersion}\n          cache: yarn\n      - name: Install dependencies\n        run: yarn install --immutable`;\n  if (packageManager === 'pnpm') return `\\\n      - uses: pnpm/action-setup@v4\n      - uses: actions/setup-node@v4\n        with:\n          node-version: ${nodeVersion}\n          cache: pnpm\n      - name: Install dependencies\n        run: pnpm install --frozen-lockfile`;\n  if (packageManager === 'bun') return `\\\n      - uses: oven-sh/setup-bun@v2\n      - name: Install dependencies\n        run: bun install --frozen-lockfile`;\n  return `\\\n      - uses: actions/setup-node@v4\n        with:\n          node-version: ${nodeVersion}\n          cache: npm\n      - name: Install dependencies\n        run: npm ci`;\n}\n\nfunction workflowYaml(env: Pick<Environment, 'packageManager' | 'nodeVersion'>): string {\n  const setupSteps = setupStepsFor(env);\n\n  return `name: Features\non:\n  push:\n    branches: [main]\n  pull_request:\n    branches: [main]\njobs:\n  features:\n    runs-on: ubuntu-latest\n    steps:\n      - uses: actions/checkout@v4\n${setupSteps}\n      - name: Install Playwright browsers\n        run: npx playwright install chromium --with-deps\n      - name: Run features\n        run: npx cucumber-js\n`;\n}\n\nexport function installGithubAction(env: Pick<Environment, 'packageManager' | 'nodeVersion' | 'cwd'>): GithubActionsResult {\n  const workflowDir = join(env.cwd, '.github', 'workflows');\n  const workflowPath = join(workflowDir, 'letsrunit.yml');\n\n  if (existsSync(workflowPath)) return 'skipped';\n\n  mkdirSync(workflowDir, { recursive: true });\n  writeFileSync(workflowPath, workflowYaml(env), 'utf-8');\n  return 'created';\n}\n","import { execSync } from 'node:child_process';\nimport { existsSync } from 'node:fs';\nimport { join } from 'node:path';\nimport { type Environment, execPm } from '../detect.js';\n\nexport function hasPlaywrightBrowsers({ cwd }: Pick<Environment, 'cwd'>): boolean {\n  if (!existsSync(join(cwd, 'node_modules', 'playwright-core', 'package.json'))) {\n    return false;\n  }\n  try {\n    const execPath = execSync(\n      `node -e \"console.log(require('playwright-core').chromium.executablePath())\"`,\n      { cwd, stdio: 'pipe', encoding: 'utf-8' },\n    ).trim();\n    return existsSync(execPath);\n  } catch {\n    return false;\n  }\n}\n\nexport function installPlaywrightBrowsers(env: Pick<Environment, 'packageManager' | 'cwd'>): void {\n  execPm(env, {\n    npm: 'exec playwright install chromium',\n    yarn: 'exec playwright install chromium',\n    pnpm: 'exec playwright install chromium',\n    bun: 'x playwright install chromium',\n  });\n}\n","import { init } from './init.js';\n\nconst args = process.argv.slice(2);\nconst command = args.find((a) => !a.startsWith('-')) ?? 'init';\nconst yes = args.includes('--yes') || args.includes('-y');\n\nif (command === 'init') {\n  init({ yes }).catch((err: unknown) => {\n    console.error(err instanceof Error ? err.message : String(err));\n    process.exit(1);\n  });\n} else {\n  console.error(`Unknown command: ${command}`);\n  console.error('Usage: letsrunit init [--yes]');\n  process.exit(1);\n}\n"],"mappings":"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","names":["args","existsSync","join","join","existsSync","existsSync","readFileSync","join","join","existsSync","readFileSync","existsSync","mkdirSync","writeFileSync","join","execSync","existsSync","join","existsSync","join","execSync","BDD_IMPORT","yes"]}

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+interface InitOptions {
+    yes?: boolean;
+}
+declare function init(options?: InitOptions): Promise<void>;
+
+export { type InitOptions, init };

package/dist/index.js

@@ -0,0 +1,301 @@
+// src/init.ts
+import { confirm, intro, log, note, outro, spinner } from "@clack/prompts";
+
+// src/detect.ts
+import { execSync } from "child_process";
+import { existsSync } from "fs";
+import { join } from "path";
+function detectEnvironment() {
+  const cwd = process.cwd();
+  const isInteractive = Boolean(process.stdout.isTTY && process.stdin.isTTY);
+  let packageManager = "npm";
+  if (existsSync(join(cwd, "yarn.lock"))) packageManager = "yarn";
+  else if (existsSync(join(cwd, "pnpm-lock.yaml"))) packageManager = "pnpm";
+  else if (existsSync(join(cwd, "bun.lockb")) || existsSync(join(cwd, "bun.lock"))) packageManager = "bun";
+  const nodeVersion = parseInt(process.version.slice(1), 10);
+  const hasCucumber = existsSync(join(cwd, "node_modules", "@cucumber", "cucumber", "package.json"));
+  return { isInteractive, packageManager, nodeVersion, hasCucumber, cwd };
+}
+function pmCmd(pm, args) {
+  if (pm === "yarn") return `yarn ${args.yarn}`;
+  if (pm === "pnpm") return `pnpm ${args.pnpm}`;
+  if (pm === "bun") return `bun ${args.bun}`;
+  return `npm ${args.npm}`;
+}
+function execPm(env, args) {
+  const cmd = pmCmd(env.packageManager, args);
+  return execSync(cmd, { stdio: "inherit", cwd: env.cwd });
+}
+
+// src/setup/cli.ts
+import { existsSync as existsSync2, readFileSync } from "fs";
+import { join as join2 } from "path";
+function isCliInstalled({ cwd }) {
+  const pkgPath = join2(cwd, "package.json");
+  if (!existsSync2(pkgPath)) return false;
+  const pkg = JSON.parse(readFileSync(pkgPath, "utf-8"));
+  return "@letsrunit/cli" in (pkg.devDependencies ?? {}) || "@letsrunit/cli" in (pkg.dependencies ?? {});
+}
+function installCli(env) {
+  execPm(env, {
+    npm: "install --save-dev @letsrunit/cli",
+    yarn: "add --dev @letsrunit/cli",
+    pnpm: "add -D @letsrunit/cli",
+    bun: "add -d @letsrunit/cli"
+  });
+}
+
+// src/setup/cucumber.ts
+import { existsSync as existsSync3, mkdirSync, readdirSync, readFileSync as readFileSync2, writeFileSync } from "fs";
+import { join as join3 } from "path";
+var BDD_IMPORT = "@letsrunit/bdd/define";
+var CUCUMBER_CONFIG = `export default {
+  worldParameters: {
+    baseURL: 'http://localhost:3000',
+  },
+};
+`;
+var SUPPORT_FILE = `import { setDefaultTimeout } from '@cucumber/cucumber';
+import '${BDD_IMPORT}';
+
+setDefaultTimeout(30_000);
+`;
+var EXAMPLE_FEATURE = `Feature: Example
+  Scenario: Homepage loads
+    Given I'm on the homepage
+    Then The page contains heading "Welcome"
+`;
+function installCucumber(env) {
+  execPm(env, {
+    npm: "install --save-dev @cucumber/cucumber",
+    yarn: "add --dev @cucumber/cucumber",
+    pnpm: "add -D @cucumber/cucumber",
+    bun: "add -d @cucumber/cucumber"
+  });
+}
+function installBdd(env) {
+  const pkgPath = join3(env.cwd, "package.json");
+  if (!existsSync3(pkgPath)) return false;
+  const pkg = JSON.parse(readFileSync2(pkgPath, "utf-8"));
+  const alreadyInstalled = "@letsrunit/bdd" in (pkg.devDependencies ?? {}) || "@letsrunit/bdd" in (pkg.dependencies ?? {});
+  if (alreadyInstalled) return false;
+  execPm(env, {
+    npm: "install --save-dev @letsrunit/bdd",
+    yarn: "add --dev @letsrunit/bdd",
+    pnpm: "add -D @letsrunit/bdd",
+    bun: "add -d @letsrunit/bdd"
+  });
+  return true;
+}
+function setupCucumberConfig({ cwd }) {
+  const supportDir = join3(cwd, "features", "support");
+  const supportPath = join3(supportDir, "world.js");
+  if (existsSync3(supportPath)) {
+    const content = readFileSync2(supportPath, "utf-8");
+    if (content.includes(BDD_IMPORT)) return "skipped";
+    return "needs-manual-update";
+  }
+  const configPath = join3(cwd, "cucumber.js");
+  if (!existsSync3(configPath)) {
+    writeFileSync(configPath, CUCUMBER_CONFIG, "utf-8");
+  }
+  mkdirSync(supportDir, { recursive: true });
+  writeFileSync(supportPath, SUPPORT_FILE, "utf-8");
+  return "created";
+}
+function setupFeaturesDir({ cwd }) {
+  if (existsSync3(join3(cwd, "features"))) {
+    try {
+      const hasFeatureFiles = readdirSync(join3(cwd, "features")).some((f) => f.endsWith(".feature"));
+      if (hasFeatureFiles) return false;
+    } catch {
+      return false;
+    }
+  }
+  try {
+    const hasFeatureAtRoot = readdirSync(cwd).some((f) => f.endsWith(".feature"));
+    if (hasFeatureAtRoot) return false;
+  } catch {
+    return false;
+  }
+  mkdirSync(join3(cwd, "features"), { recursive: true });
+  writeFileSync(join3(cwd, "features", "example.feature"), EXAMPLE_FEATURE, "utf-8");
+  return true;
+}
+function setupCucumber(env) {
+  const bddInstalled = installBdd(env);
+  const configResult = setupCucumberConfig(env);
+  const featuresCreated = setupFeaturesDir(env);
+  return { bddInstalled, configResult, featuresCreated };
+}
+
+// src/setup/github-actions.ts
+import { existsSync as existsSync4, mkdirSync as mkdirSync2, writeFileSync as writeFileSync2 } from "fs";
+import { join as join4 } from "path";
+function setupStepsFor({ packageManager, nodeVersion }) {
+  if (packageManager === "yarn") return `      - name: Enable Corepack
+        run: corepack enable
+      - uses: actions/setup-node@v4
+        with:
+          node-version: ${nodeVersion}
+          cache: yarn
+      - name: Install dependencies
+        run: yarn install --immutable`;
+  if (packageManager === "pnpm") return `      - uses: pnpm/action-setup@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: ${nodeVersion}
+          cache: pnpm
+      - name: Install dependencies
+        run: pnpm install --frozen-lockfile`;
+  if (packageManager === "bun") return `      - uses: oven-sh/setup-bun@v2
+      - name: Install dependencies
+        run: bun install --frozen-lockfile`;
+  return `      - uses: actions/setup-node@v4
+        with:
+          node-version: ${nodeVersion}
+          cache: npm
+      - name: Install dependencies
+        run: npm ci`;
+}
+function workflowYaml(env) {
+  const setupSteps = setupStepsFor(env);
+  return `name: Features
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+jobs:
+  features:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+${setupSteps}
+      - name: Install Playwright browsers
+        run: npx playwright install chromium --with-deps
+      - name: Run features
+        run: npx cucumber-js
+`;
+}
+function installGithubAction(env) {
+  const workflowDir = join4(env.cwd, ".github", "workflows");
+  const workflowPath = join4(workflowDir, "letsrunit.yml");
+  if (existsSync4(workflowPath)) return "skipped";
+  mkdirSync2(workflowDir, { recursive: true });
+  writeFileSync2(workflowPath, workflowYaml(env), "utf-8");
+  return "created";
+}
+
+// src/setup/playwright.ts
+import { execSync as execSync2 } from "child_process";
+import { existsSync as existsSync5 } from "fs";
+import { join as join5 } from "path";
+function hasPlaywrightBrowsers({ cwd }) {
+  if (!existsSync5(join5(cwd, "node_modules", "playwright-core", "package.json"))) {
+    return false;
+  }
+  try {
+    const execPath = execSync2(
+      `node -e "console.log(require('playwright-core').chromium.executablePath())"`,
+      { cwd, stdio: "pipe", encoding: "utf-8" }
+    ).trim();
+    return existsSync5(execPath);
+  } catch {
+    return false;
+  }
+}
+function installPlaywrightBrowsers(env) {
+  execPm(env, {
+    npm: "exec playwright install chromium",
+    yarn: "exec playwright install chromium",
+    pnpm: "exec playwright install chromium",
+    bun: "x playwright install chromium"
+  });
+}
+
+// src/init.ts
+var BDD_IMPORT2 = "@letsrunit/bdd/define";
+async function stepInstallCli(env) {
+  if (isCliInstalled(env)) {
+    log.success("@letsrunit/cli already installed");
+    return;
+  }
+  const s = spinner();
+  s.start("Installing @letsrunit/cli\u2026");
+  installCli(env);
+  s.stop("@letsrunit/cli installed");
+}
+async function stepEnsureCucumber(env, { yes }) {
+  if (env.hasCucumber) return true;
+  if (!yes && !env.isInteractive) {
+    log.warn("@cucumber/cucumber not found. Install it to use letsrunit with Cucumber:");
+    note("npm install --save-dev @cucumber/cucumber\nThen run: npx letsrunit init", "Setup Cucumber");
+    return false;
+  }
+  if (!yes) {
+    const install = await confirm({ message: "@cucumber/cucumber not found. Install it now?" });
+    if (install !== true) return false;
+  }
+  const s = spinner();
+  s.start("Installing @cucumber/cucumber\u2026");
+  installCucumber(env);
+  s.stop("@cucumber/cucumber installed");
+  return true;
+}
+function stepSetupCucumber(env) {
+  const result = setupCucumber(env);
+  if (result.bddInstalled) log.success("@letsrunit/bdd installed");
+  if (result.configResult === "created") {
+    log.success("features/support/world.js created");
+  } else if (result.configResult === "needs-manual-update") {
+    log.warn("features/support/world.js exists but does not import @letsrunit/bdd.");
+    note(`Add "import '${BDD_IMPORT2}';" to features/support/world.js`, "Action required");
+  }
+  if (result.featuresCreated) log.success("features/ directory created with example.feature");
+}
+async function stepCheckPlaywrightBrowsers(env, { yes }) {
+  if (hasPlaywrightBrowsers(env)) return;
+  if (!yes && !env.isInteractive) {
+    log.warn("Playwright Chromium browser not found.");
+    note("npx playwright install chromium", "Run to install browsers");
+    return;
+  }
+  if (!yes) {
+    const install = await confirm({ message: "Playwright Chromium browser not found. Install it now?" });
+    if (install !== true) return;
+  }
+  const s = spinner();
+  s.start("Installing Playwright Chromium\u2026");
+  installPlaywrightBrowsers(env);
+  s.stop("Playwright Chromium installed");
+}
+async function stepAddGithubAction(env, { yes }) {
+  if (!yes && !env.isInteractive) return;
+  if (!yes) {
+    const addAction = await confirm({ message: "Add a GitHub Action to run features on push?" });
+    if (addAction !== true) return;
+  }
+  const result = installGithubAction(env);
+  if (result === "created") {
+    log.success(".github/workflows/letsrunit.yml created");
+  } else {
+    log.info(".github/workflows/letsrunit.yml already exists, skipped");
+  }
+}
+async function init(options = {}) {
+  intro("letsrunit init");
+  const env = detectEnvironment();
+  await stepInstallCli(env);
+  const hasCucumber = await stepEnsureCucumber(env, options);
+  if (hasCucumber) {
+    stepSetupCucumber(env);
+    await stepCheckPlaywrightBrowsers(env, options);
+    await stepAddGithubAction(env, options);
+  }
+  outro("All done! Run npx letsrunit --help to get started.");
+}
+export {
+  init
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/init.ts","../src/detect.ts","../src/setup/cli.ts","../src/setup/cucumber.ts","../src/setup/github-actions.ts","../src/setup/playwright.ts"],"sourcesContent":["import { confirm, intro, log, note, outro, spinner } from '@clack/prompts';\nimport { detectEnvironment, type Environment } from './detect.js';\nimport { installCli, isCliInstalled } from './setup/cli.js';\nimport { installCucumber, setupCucumber } from './setup/cucumber.js';\nimport { installGithubAction } from './setup/github-actions.js';\nimport { hasPlaywrightBrowsers, installPlaywrightBrowsers } from './setup/playwright.js';\n\nconst BDD_IMPORT = '@letsrunit/bdd/define';\n\nexport interface InitOptions {\n  yes?: boolean;\n}\n\nasync function stepInstallCli(env: Environment): Promise<void> {\n  if (isCliInstalled(env)) {\n    log.success('@letsrunit/cli already installed');\n    return;\n  }\n\n  const s = spinner();\n  s.start('Installing @letsrunit/cli…');\n  installCli(env);\n  s.stop('@letsrunit/cli installed');\n}\n\nasync function stepEnsureCucumber(env: Environment, { yes }: InitOptions): Promise<boolean> {\n  if (env.hasCucumber) return true;\n\n  if (!yes && !env.isInteractive) {\n    log.warn('@cucumber/cucumber not found. Install it to use letsrunit with Cucumber:');\n    note('npm install --save-dev @cucumber/cucumber\\nThen run: npx letsrunit init', 'Setup Cucumber');\n    return false;\n  }\n\n  if (!yes) {\n    const install = await confirm({ message: '@cucumber/cucumber not found. Install it now?' });\n    if (install !== true) return false;\n  }\n\n  const s = spinner();\n  s.start('Installing @cucumber/cucumber…');\n  installCucumber(env);\n  s.stop('@cucumber/cucumber installed');\n  return true;\n}\n\nfunction stepSetupCucumber(env: Environment): void {\n  const result = setupCucumber(env);\n\n  if (result.bddInstalled) log.success('@letsrunit/bdd installed');\n\n  if (result.configResult === 'created') {\n    log.success('features/support/world.js created');\n  } else if (result.configResult === 'needs-manual-update') {\n    log.warn('features/support/world.js exists but does not import @letsrunit/bdd.');\n    note(`Add \"import '${BDD_IMPORT}';\" to features/support/world.js`, 'Action required');\n  }\n\n  if (result.featuresCreated) log.success('features/ directory created with example.feature');\n}\n\nasync function stepCheckPlaywrightBrowsers(env: Environment, { yes }: InitOptions): Promise<void> {\n  if (hasPlaywrightBrowsers(env)) return;\n\n  if (!yes && !env.isInteractive) {\n    log.warn('Playwright Chromium browser not found.');\n    note('npx playwright install chromium', 'Run to install browsers');\n    return;\n  }\n\n  if (!yes) {\n    const install = await confirm({ message: 'Playwright Chromium browser not found. Install it now?' });\n    if (install !== true) return;\n  }\n\n  const s = spinner();\n  s.start('Installing Playwright Chromium…');\n  installPlaywrightBrowsers(env);\n  s.stop('Playwright Chromium installed');\n}\n\nasync function stepAddGithubAction(env: Environment, { yes }: InitOptions): Promise<void> {\n  if (!yes && !env.isInteractive) return;\n\n  if (!yes) {\n    const addAction = await confirm({ message: 'Add a GitHub Action to run features on push?' });\n    if (addAction !== true) return;\n  }\n\n  const result = installGithubAction(env);\n  if (result === 'created') {\n    log.success('.github/workflows/letsrunit.yml created');\n  } else {\n    log.info('.github/workflows/letsrunit.yml already exists, skipped');\n  }\n}\n\nexport async function init(options: InitOptions = {}): Promise<void> {\n  intro('letsrunit init');\n\n  const env = detectEnvironment();\n\n  await stepInstallCli(env);\n\n  const hasCucumber = await stepEnsureCucumber(env, options);\n  if (hasCucumber) {\n    stepSetupCucumber(env);\n    await stepCheckPlaywrightBrowsers(env, options);\n    await stepAddGithubAction(env, options);\n  }\n\n  outro('All done! Run npx letsrunit --help to get started.');\n}\n","import { execSync } from 'node:child_process';\nimport { existsSync } from 'node:fs';\nimport { join } from 'node:path';\n\nexport type PackageManager = 'yarn' | 'pnpm' | 'bun' | 'npm';\n\nexport interface Environment {\n  isInteractive: boolean;\n  packageManager: PackageManager;\n  nodeVersion: number;\n  hasCucumber: boolean;\n  cwd: string;\n}\n\nexport interface PackageManagerArgs {\n  npm: string;\n  yarn: string;\n  pnpm: string;\n  bun: string;\n}\n\nexport function detectEnvironment(): Environment {\n  const cwd = process.cwd();\n  const isInteractive = Boolean(process.stdout.isTTY && process.stdin.isTTY);\n\n  let packageManager: PackageManager = 'npm';\n  if (existsSync(join(cwd, 'yarn.lock'))) packageManager = 'yarn';\n  else if (existsSync(join(cwd, 'pnpm-lock.yaml'))) packageManager = 'pnpm';\n  else if (existsSync(join(cwd, 'bun.lockb')) || existsSync(join(cwd, 'bun.lock'))) packageManager = 'bun';\n\n  const nodeVersion = parseInt(process.version.slice(1), 10);\n  const hasCucumber = existsSync(join(cwd, 'node_modules', '@cucumber', 'cucumber', 'package.json'));\n\n  return { isInteractive, packageManager, nodeVersion, hasCucumber, cwd };\n}\n\nfunction pmCmd(pm: string, args: PackageManagerArgs): string {\n  if (pm === 'yarn') return `yarn ${args.yarn}`;\n  if (pm === 'pnpm') return `pnpm ${args.pnpm}`;\n  if (pm === 'bun') return `bun ${args.bun}`;\n  return `npm ${args.npm}`;\n}\n\nexport function execPm(env: Pick<Environment, 'packageManager' | 'cwd'>, args: PackageManagerArgs) {\n  const cmd = pmCmd(env.packageManager, args);\n  return execSync(cmd, { stdio: 'inherit', cwd: env.cwd });\n}\n","import { existsSync, readFileSync } from 'node:fs';\nimport { join } from 'node:path';\nimport { type Environment, execPm } from '../detect.js';\n\nexport function isCliInstalled({ cwd }: Pick<Environment, 'cwd'>): boolean {\n  const pkgPath = join(cwd, 'package.json');\n  if (!existsSync(pkgPath)) return false;\n\n  const pkg = JSON.parse(readFileSync(pkgPath, 'utf-8')) as {\n    devDependencies?: Record<string, string>;\n    dependencies?: Record<string, string>;\n  };\n\n  return '@letsrunit/cli' in (pkg.devDependencies ?? {}) || '@letsrunit/cli' in (pkg.dependencies ?? {});\n}\n\nexport function installCli(env: Pick<Environment, 'packageManager' | 'cwd'>): void {\n  execPm(env, {\n    npm: 'install --save-dev @letsrunit/cli',\n    yarn: 'add --dev @letsrunit/cli',\n    pnpm: 'add -D @letsrunit/cli',\n    bun: 'add -d @letsrunit/cli',\n  });\n}\n","import { existsSync, mkdirSync, readdirSync, readFileSync, writeFileSync } from 'node:fs';\nimport { join } from 'node:path';\nimport { type Environment, execPm } from '../detect.js';\n\nconst BDD_IMPORT = '@letsrunit/bdd/define';\n\nconst CUCUMBER_CONFIG = `export default {\n  worldParameters: {\n    baseURL: 'http://localhost:3000',\n  },\n};\n`;\n\nconst SUPPORT_FILE = `import { setDefaultTimeout } from '@cucumber/cucumber';\nimport '${BDD_IMPORT}';\n\nsetDefaultTimeout(30_000);\n`;\n\nconst EXAMPLE_FEATURE = `Feature: Example\n  Scenario: Homepage loads\n    Given I'm on the homepage\n    Then The page contains heading \"Welcome\"\n`;\n\nexport type CucumberConfigResult = 'created' | 'skipped' | 'needs-manual-update';\n\nexport interface CucumberSetupResult {\n  bddInstalled: boolean;\n  configResult: CucumberConfigResult;\n  featuresCreated: boolean;\n}\n\nexport function installCucumber(env: Pick<Environment, 'packageManager' | 'cwd'>): void {\n  execPm(env, {\n    npm: 'install --save-dev @cucumber/cucumber',\n    yarn: 'add --dev @cucumber/cucumber',\n    pnpm: 'add -D @cucumber/cucumber',\n    bun: 'add -d @cucumber/cucumber',\n  });\n}\n\nfunction installBdd(env: Pick<Environment, 'packageManager' | 'cwd'>): boolean {\n  const pkgPath = join(env.cwd, 'package.json');\n  if (!existsSync(pkgPath)) return false;\n\n  const pkg = JSON.parse(readFileSync(pkgPath, 'utf-8')) as {\n    devDependencies?: Record<string, string>;\n    dependencies?: Record<string, string>;\n  };\n\n  const alreadyInstalled =\n    '@letsrunit/bdd' in (pkg.devDependencies ?? {}) || '@letsrunit/bdd' in (pkg.dependencies ?? {});\n\n  if (alreadyInstalled) return false;\n\n  execPm(env, {\n    npm: 'install --save-dev @letsrunit/bdd',\n    yarn: 'add --dev @letsrunit/bdd',\n    pnpm: 'add -D @letsrunit/bdd',\n    bun: 'add -d @letsrunit/bdd',\n  });\n\n  return true;\n}\n\nfunction setupCucumberConfig({ cwd }: Pick<Environment, 'cwd'>): CucumberConfigResult {\n  const supportDir = join(cwd, 'features', 'support');\n  const supportPath = join(supportDir, 'world.js');\n\n  if (existsSync(supportPath)) {\n    const content = readFileSync(supportPath, 'utf-8');\n    if (content.includes(BDD_IMPORT)) return 'skipped';\n    return 'needs-manual-update';\n  }\n\n  const configPath = join(cwd, 'cucumber.js');\n  if (!existsSync(configPath)) {\n    writeFileSync(configPath, CUCUMBER_CONFIG, 'utf-8');\n  }\n\n  mkdirSync(supportDir, { recursive: true });\n  writeFileSync(supportPath, SUPPORT_FILE, 'utf-8');\n  return 'created';\n}\n\nfunction setupFeaturesDir({ cwd }: Pick<Environment, 'cwd'>): boolean {\n  if (existsSync(join(cwd, 'features'))) {\n    try {\n      const hasFeatureFiles = readdirSync(join(cwd, 'features')).some((f) => f.endsWith('.feature'));\n      if (hasFeatureFiles) return false;\n    } catch {\n      return false;\n    }\n  }\n\n  try {\n    const hasFeatureAtRoot = readdirSync(cwd).some((f) => f.endsWith('.feature'));\n    if (hasFeatureAtRoot) return false;\n  } catch {\n    return false;\n  }\n\n  mkdirSync(join(cwd, 'features'), { recursive: true });\n  writeFileSync(join(cwd, 'features', 'example.feature'), EXAMPLE_FEATURE, 'utf-8');\n  return true;\n}\n\nexport function setupCucumber(env: Pick<Environment, 'packageManager' | 'cwd'>): CucumberSetupResult {\n  const bddInstalled = installBdd(env);\n  const configResult = setupCucumberConfig(env);\n  const featuresCreated = setupFeaturesDir(env);\n  return { bddInstalled, configResult, featuresCreated };\n}\n","import { existsSync, mkdirSync, writeFileSync } from 'node:fs';\nimport { join } from 'node:path';\nimport type { Environment } from '../detect.js';\n\nexport type GithubActionsResult = 'created' | 'skipped';\n\nfunction setupStepsFor({ packageManager, nodeVersion }: Pick<Environment, 'packageManager' | 'nodeVersion'>): string {\n  if (packageManager === 'yarn') return `\\\n      - name: Enable Corepack\n        run: corepack enable\n      - uses: actions/setup-node@v4\n        with:\n          node-version: ${nodeVersion}\n          cache: yarn\n      - name: Install dependencies\n        run: yarn install --immutable`;\n  if (packageManager === 'pnpm') return `\\\n      - uses: pnpm/action-setup@v4\n      - uses: actions/setup-node@v4\n        with:\n          node-version: ${nodeVersion}\n          cache: pnpm\n      - name: Install dependencies\n        run: pnpm install --frozen-lockfile`;\n  if (packageManager === 'bun') return `\\\n      - uses: oven-sh/setup-bun@v2\n      - name: Install dependencies\n        run: bun install --frozen-lockfile`;\n  return `\\\n      - uses: actions/setup-node@v4\n        with:\n          node-version: ${nodeVersion}\n          cache: npm\n      - name: Install dependencies\n        run: npm ci`;\n}\n\nfunction workflowYaml(env: Pick<Environment, 'packageManager' | 'nodeVersion'>): string {\n  const setupSteps = setupStepsFor(env);\n\n  return `name: Features\non:\n  push:\n    branches: [main]\n  pull_request:\n    branches: [main]\njobs:\n  features:\n    runs-on: ubuntu-latest\n    steps:\n      - uses: actions/checkout@v4\n${setupSteps}\n      - name: Install Playwright browsers\n        run: npx playwright install chromium --with-deps\n      - name: Run features\n        run: npx cucumber-js\n`;\n}\n\nexport function installGithubAction(env: Pick<Environment, 'packageManager' | 'nodeVersion' | 'cwd'>): GithubActionsResult {\n  const workflowDir = join(env.cwd, '.github', 'workflows');\n  const workflowPath = join(workflowDir, 'letsrunit.yml');\n\n  if (existsSync(workflowPath)) return 'skipped';\n\n  mkdirSync(workflowDir, { recursive: true });\n  writeFileSync(workflowPath, workflowYaml(env), 'utf-8');\n  return 'created';\n}\n","import { execSync } from 'node:child_process';\nimport { existsSync } from 'node:fs';\nimport { join } from 'node:path';\nimport { type Environment, execPm } from '../detect.js';\n\nexport function hasPlaywrightBrowsers({ cwd }: Pick<Environment, 'cwd'>): boolean {\n  if (!existsSync(join(cwd, 'node_modules', 'playwright-core', 'package.json'))) {\n    return false;\n  }\n  try {\n    const execPath = execSync(\n      `node -e \"console.log(require('playwright-core').chromium.executablePath())\"`,\n      { cwd, stdio: 'pipe', encoding: 'utf-8' },\n    ).trim();\n    return existsSync(execPath);\n  } catch {\n    return false;\n  }\n}\n\nexport function installPlaywrightBrowsers(env: Pick<Environment, 'packageManager' | 'cwd'>): void {\n  execPm(env, {\n    npm: 'exec playwright install chromium',\n    yarn: 'exec playwright install chromium',\n    pnpm: 'exec playwright install chromium',\n    bun: 'x playwright install chromium',\n  });\n}\n"],"mappings":"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","names":["existsSync","join","join","existsSync","existsSync","readFileSync","join","join","existsSync","readFileSync","existsSync","mkdirSync","writeFileSync","join","execSync","existsSync","join","existsSync","join","execSync","BDD_IMPORT"]}

package/package.json

@@ -1,5 +1,43 @@
 {
   "name": "letsrunit",
-  "version": "0.0.1",
-  "packageManager": "yarn@4.9.2"
-}
+  "version": "0.3.3",
+  "description": "Onboarding tool for letsrunit — run npx letsrunit init to get started",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/letsrunit-hq/letsrunit.git",
+    "directory": "packages/letsrunit"
+  },
+  "bugs": "https://github.com/letsrunit-hq/letsrunit/issues",
+  "homepage": "https://github.com/letsrunit-hq/letsrunit#readme",
+  "type": "module",
+  "bin": {
+    "letsrunit": "./dist/bin.js"
+  },
+  "main": "./dist/index.js",
+  "publishConfig": {
+    "main": "./dist/index.js",
+    "bin": {
+      "letsrunit": "./dist/bin.js"
+    }
+  },
+  "files": [
+    "dist",
+    "src"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "scripts": {
+    "build": "../../node_modules/.bin/tsup",
+    "test": "echo \"No tests yet\""
+  },
+  "packageManager": "yarn@4.10.3",
+  "dependencies": {
+    "@clack/prompts": "^0.10.0"
+  },
+  "devDependencies": {
+    "@types/node": "^25.0.9",
+    "typescript": "^5.9.3"
+  }
+}

package/src/bin.ts

@@ -0,0 +1,16 @@
+import { init } from './init.js';
+
+const args = process.argv.slice(2);
+const command = args.find((a) => !a.startsWith('-')) ?? 'init';
+const yes = args.includes('--yes') || args.includes('-y');
+
+if (command === 'init') {
+  init({ yes }).catch((err: unknown) => {
+    console.error(err instanceof Error ? err.message : String(err));
+    process.exit(1);
+  });
+} else {
+  console.error(`Unknown command: ${command}`);
+  console.error('Usage: letsrunit init [--yes]');
+  process.exit(1);
+}

package/src/detect.ts

@@ -0,0 +1,47 @@
+import { execSync } from 'node:child_process';
+import { existsSync } from 'node:fs';
+import { join } from 'node:path';
+
+export type PackageManager = 'yarn' | 'pnpm' | 'bun' | 'npm';
+
+export interface Environment {
+  isInteractive: boolean;
+  packageManager: PackageManager;
+  nodeVersion: number;
+  hasCucumber: boolean;
+  cwd: string;
+}
+
+export interface PackageManagerArgs {
+  npm: string;
+  yarn: string;
+  pnpm: string;
+  bun: string;
+}
+
+export function detectEnvironment(): Environment {
+  const cwd = process.cwd();
+  const isInteractive = Boolean(process.stdout.isTTY && process.stdin.isTTY);
+
+  let packageManager: PackageManager = 'npm';
+  if (existsSync(join(cwd, 'yarn.lock'))) packageManager = 'yarn';
+  else if (existsSync(join(cwd, 'pnpm-lock.yaml'))) packageManager = 'pnpm';
+  else if (existsSync(join(cwd, 'bun.lockb')) || existsSync(join(cwd, 'bun.lock'))) packageManager = 'bun';
+
+  const nodeVersion = parseInt(process.version.slice(1), 10);
+  const hasCucumber = existsSync(join(cwd, 'node_modules', '@cucumber', 'cucumber', 'package.json'));
+
+  return { isInteractive, packageManager, nodeVersion, hasCucumber, cwd };
+}
+
+function pmCmd(pm: string, args: PackageManagerArgs): string {
+  if (pm === 'yarn') return `yarn ${args.yarn}`;
+  if (pm === 'pnpm') return `pnpm ${args.pnpm}`;
+  if (pm === 'bun') return `bun ${args.bun}`;
+  return `npm ${args.npm}`;
+}
+
+export function execPm(env: Pick<Environment, 'packageManager' | 'cwd'>, args: PackageManagerArgs) {
+  const cmd = pmCmd(env.packageManager, args);
+  return execSync(cmd, { stdio: 'inherit', cwd: env.cwd });
+}

package/src/index.ts

@@ -0,0 +1,2 @@
+export { init } from './init.js';
+export type { InitOptions } from './init.js';

package/src/init.ts

@@ -0,0 +1,113 @@
+import { confirm, intro, log, note, outro, spinner } from '@clack/prompts';
+import { detectEnvironment, type Environment } from './detect.js';
+import { installCli, isCliInstalled } from './setup/cli.js';
+import { installCucumber, setupCucumber } from './setup/cucumber.js';
+import { installGithubAction } from './setup/github-actions.js';
+import { hasPlaywrightBrowsers, installPlaywrightBrowsers } from './setup/playwright.js';
+
+const BDD_IMPORT = '@letsrunit/bdd/define';
+
+export interface InitOptions {
+  yes?: boolean;
+}
+
+async function stepInstallCli(env: Environment): Promise<void> {
+  if (isCliInstalled(env)) {
+    log.success('@letsrunit/cli already installed');
+    return;
+  }
+
+  const s = spinner();
+  s.start('Installing @letsrunit/cli…');
+  installCli(env);
+  s.stop('@letsrunit/cli installed');
+}
+
+async function stepEnsureCucumber(env: Environment, { yes }: InitOptions): Promise<boolean> {
+  if (env.hasCucumber) return true;
+
+  if (!yes && !env.isInteractive) {
+    log.warn('@cucumber/cucumber not found. Install it to use letsrunit with Cucumber:');
+    note('npm install --save-dev @cucumber/cucumber\nThen run: npx letsrunit init', 'Setup Cucumber');
+    return false;
+  }
+
+  if (!yes) {
+    const install = await confirm({ message: '@cucumber/cucumber not found. Install it now?' });
+    if (install !== true) return false;
+  }
+
+  const s = spinner();
+  s.start('Installing @cucumber/cucumber…');
+  installCucumber(env);
+  s.stop('@cucumber/cucumber installed');
+  return true;
+}
+
+function stepSetupCucumber(env: Environment): void {
+  const result = setupCucumber(env);
+
+  if (result.bddInstalled) log.success('@letsrunit/bdd installed');
+
+  if (result.configResult === 'created') {
+    log.success('features/support/world.js created');
+  } else if (result.configResult === 'needs-manual-update') {
+    log.warn('features/support/world.js exists but does not import @letsrunit/bdd.');
+    note(`Add "import '${BDD_IMPORT}';" to features/support/world.js`, 'Action required');
+  }
+
+  if (result.featuresCreated) log.success('features/ directory created with example.feature');
+}
+
+async function stepCheckPlaywrightBrowsers(env: Environment, { yes }: InitOptions): Promise<void> {
+  if (hasPlaywrightBrowsers(env)) return;
+
+  if (!yes && !env.isInteractive) {
+    log.warn('Playwright Chromium browser not found.');
+    note('npx playwright install chromium', 'Run to install browsers');
+    return;
+  }
+
+  if (!yes) {
+    const install = await confirm({ message: 'Playwright Chromium browser not found. Install it now?' });
+    if (install !== true) return;
+  }
+
+  const s = spinner();
+  s.start('Installing Playwright Chromium…');
+  installPlaywrightBrowsers(env);
+  s.stop('Playwright Chromium installed');
+}
+
+async function stepAddGithubAction(env: Environment, { yes }: InitOptions): Promise<void> {
+  if (!yes && !env.isInteractive) return;
+
+  if (!yes) {
+    const addAction = await confirm({ message: 'Add a GitHub Action to run features on push?' });
+    if (addAction !== true) return;
+  }
+
+  const result = installGithubAction(env);
+  if (result === 'created') {
+    log.success('.github/workflows/letsrunit.yml created');
+  } else {
+    log.info('.github/workflows/letsrunit.yml already exists, skipped');
+  }
+}
+
+export async function init(options: InitOptions = {}): Promise<void> {
+  intro('letsrunit init');
+
+  const env = detectEnvironment();
+
+  await stepInstallCli(env);
+
+  const hasCucumber = await stepEnsureCucumber(env, options);
+  if (hasCucumber) {
+    stepSetupCucumber(env);
+    await stepCheckPlaywrightBrowsers(env, options);
+    await stepAddGithubAction(env, options);
+  }
+
+  outro('All done! Run npx letsrunit --help to get started.');
+}

package/src/setup/cli.ts

@@ -0,0 +1,24 @@
+import { existsSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { type Environment, execPm } from '../detect.js';
+
+export function isCliInstalled({ cwd }: Pick<Environment, 'cwd'>): boolean {
+  const pkgPath = join(cwd, 'package.json');
+  if (!existsSync(pkgPath)) return false;
+
+  const pkg = JSON.parse(readFileSync(pkgPath, 'utf-8')) as {
+    devDependencies?: Record<string, string>;
+    dependencies?: Record<string, string>;
+  };
+
+  return '@letsrunit/cli' in (pkg.devDependencies ?? {}) || '@letsrunit/cli' in (pkg.dependencies ?? {});
+}
+
+export function installCli(env: Pick<Environment, 'packageManager' | 'cwd'>): void {
+  execPm(env, {
+    npm: 'install --save-dev @letsrunit/cli',
+    yarn: 'add --dev @letsrunit/cli',
+    pnpm: 'add -D @letsrunit/cli',
+    bun: 'add -d @letsrunit/cli',
+  });
+}

package/src/setup/cucumber.ts

@@ -0,0 +1,114 @@
+import { existsSync, mkdirSync, readdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { type Environment, execPm } from '../detect.js';
+
+const BDD_IMPORT = '@letsrunit/bdd/define';
+
+const CUCUMBER_CONFIG = `export default {
+  worldParameters: {
+    baseURL: 'http://localhost:3000',
+  },
+};
+`;
+
+const SUPPORT_FILE = `import { setDefaultTimeout } from '@cucumber/cucumber';
+import '${BDD_IMPORT}';
+
+setDefaultTimeout(30_000);
+`;
+
+const EXAMPLE_FEATURE = `Feature: Example
+  Scenario: Homepage loads
+    Given I'm on the homepage
+    Then The page contains heading "Welcome"
+`;
+
+export type CucumberConfigResult = 'created' | 'skipped' | 'needs-manual-update';
+
+export interface CucumberSetupResult {
+  bddInstalled: boolean;
+  configResult: CucumberConfigResult;
+  featuresCreated: boolean;
+}
+
+export function installCucumber(env: Pick<Environment, 'packageManager' | 'cwd'>): void {
+  execPm(env, {
+    npm: 'install --save-dev @cucumber/cucumber',
+    yarn: 'add --dev @cucumber/cucumber',
+    pnpm: 'add -D @cucumber/cucumber',
+    bun: 'add -d @cucumber/cucumber',
+  });
+}
+
+function installBdd(env: Pick<Environment, 'packageManager' | 'cwd'>): boolean {
+  const pkgPath = join(env.cwd, 'package.json');
+  if (!existsSync(pkgPath)) return false;
+
+  const pkg = JSON.parse(readFileSync(pkgPath, 'utf-8')) as {
+    devDependencies?: Record<string, string>;
+    dependencies?: Record<string, string>;
+  };
+
+  const alreadyInstalled =
+    '@letsrunit/bdd' in (pkg.devDependencies ?? {}) || '@letsrunit/bdd' in (pkg.dependencies ?? {});
+
+  if (alreadyInstalled) return false;
+
+  execPm(env, {
+    npm: 'install --save-dev @letsrunit/bdd',
+    yarn: 'add --dev @letsrunit/bdd',
+    pnpm: 'add -D @letsrunit/bdd',
+    bun: 'add -d @letsrunit/bdd',
+  });
+
+  return true;
+}
+
+function setupCucumberConfig({ cwd }: Pick<Environment, 'cwd'>): CucumberConfigResult {
+  const supportDir = join(cwd, 'features', 'support');
+  const supportPath = join(supportDir, 'world.js');
+
+  if (existsSync(supportPath)) {
+    const content = readFileSync(supportPath, 'utf-8');
+    if (content.includes(BDD_IMPORT)) return 'skipped';
+    return 'needs-manual-update';
+  }
+
+  const configPath = join(cwd, 'cucumber.js');
+  if (!existsSync(configPath)) {
+    writeFileSync(configPath, CUCUMBER_CONFIG, 'utf-8');
+  }
+
+  mkdirSync(supportDir, { recursive: true });
+  writeFileSync(supportPath, SUPPORT_FILE, 'utf-8');
+  return 'created';
+}
+
+function setupFeaturesDir({ cwd }: Pick<Environment, 'cwd'>): boolean {
+  if (existsSync(join(cwd, 'features'))) {
+    try {
+      const hasFeatureFiles = readdirSync(join(cwd, 'features')).some((f) => f.endsWith('.feature'));
+      if (hasFeatureFiles) return false;
+    } catch {
+      return false;
+    }
+  }
+
+  try {
+    const hasFeatureAtRoot = readdirSync(cwd).some((f) => f.endsWith('.feature'));
+    if (hasFeatureAtRoot) return false;
+  } catch {
+    return false;
+  }
+
+  mkdirSync(join(cwd, 'features'), { recursive: true });
+  writeFileSync(join(cwd, 'features', 'example.feature'), EXAMPLE_FEATURE, 'utf-8');
+  return true;
+}
+
+export function setupCucumber(env: Pick<Environment, 'packageManager' | 'cwd'>): CucumberSetupResult {
+  const bddInstalled = installBdd(env);
+  const configResult = setupCucumberConfig(env);
+  const featuresCreated = setupFeaturesDir(env);
+  return { bddInstalled, configResult, featuresCreated };
+}

package/src/setup/github-actions.ts

@@ -0,0 +1,69 @@
+import { existsSync, mkdirSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+import type { Environment } from '../detect.js';
+
+export type GithubActionsResult = 'created' | 'skipped';
+
+function setupStepsFor({ packageManager, nodeVersion }: Pick<Environment, 'packageManager' | 'nodeVersion'>): string {
+  if (packageManager === 'yarn') return `\
+      - name: Enable Corepack
+        run: corepack enable
+      - uses: actions/setup-node@v4
+        with:
+          node-version: ${nodeVersion}
+          cache: yarn
+      - name: Install dependencies
+        run: yarn install --immutable`;
+  if (packageManager === 'pnpm') return `\
+      - uses: pnpm/action-setup@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: ${nodeVersion}
+          cache: pnpm
+      - name: Install dependencies
+        run: pnpm install --frozen-lockfile`;
+  if (packageManager === 'bun') return `\
+      - uses: oven-sh/setup-bun@v2
+      - name: Install dependencies
+        run: bun install --frozen-lockfile`;
+  return `\
+      - uses: actions/setup-node@v4
+        with:
+          node-version: ${nodeVersion}
+          cache: npm
+      - name: Install dependencies
+        run: npm ci`;
+}
+
+function workflowYaml(env: Pick<Environment, 'packageManager' | 'nodeVersion'>): string {
+  const setupSteps = setupStepsFor(env);
+
+  return `name: Features
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+jobs:
+  features:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+${setupSteps}
+      - name: Install Playwright browsers
+        run: npx playwright install chromium --with-deps
+      - name: Run features
+        run: npx cucumber-js
+`;
+}
+
+export function installGithubAction(env: Pick<Environment, 'packageManager' | 'nodeVersion' | 'cwd'>): GithubActionsResult {
+  const workflowDir = join(env.cwd, '.github', 'workflows');
+  const workflowPath = join(workflowDir, 'letsrunit.yml');
+
+  if (existsSync(workflowPath)) return 'skipped';
+
+  mkdirSync(workflowDir, { recursive: true });
+  writeFileSync(workflowPath, workflowYaml(env), 'utf-8');
+  return 'created';
+}

package/src/setup/playwright.ts

@@ -0,0 +1,28 @@
+import { execSync } from 'node:child_process';
+import { existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { type Environment, execPm } from '../detect.js';
+
+export function hasPlaywrightBrowsers({ cwd }: Pick<Environment, 'cwd'>): boolean {
+  if (!existsSync(join(cwd, 'node_modules', 'playwright-core', 'package.json'))) {
+    return false;
+  }
+  try {
+    const execPath = execSync(
+      `node -e "console.log(require('playwright-core').chromium.executablePath())"`,
+      { cwd, stdio: 'pipe', encoding: 'utf-8' },
+    ).trim();
+    return existsSync(execPath);
+  } catch {
+    return false;
+  }
+}
+
+export function installPlaywrightBrowsers(env: Pick<Environment, 'packageManager' | 'cwd'>): void {
+  execPm(env, {
+    npm: 'exec playwright install chromium',
+    yarn: 'exec playwright install chromium',
+    pnpm: 'exec playwright install chromium',
+    bun: 'x playwright install chromium',
+  });
+}

package/.editorconfig

@@ -1,8 +0,0 @@
-root = true
-
-[*]
-charset = utf-8
-end_of_line = lf
-indent_size = 2
-indent_style = space
-insert_final_newline = true

package/.gitattributes

@@ -1,4 +0,0 @@
-/.yarn/**            linguist-vendored
-/.yarn/releases/*    binary
-/.yarn/plugins/**/*  binary
-/.pnp.*              binary linguist-generated

package/README.md

@@ -1 +0,0 @@
-# letsrunit