create-wdio 9.32.0 → 10.0.0-alpha.149

package/build/constants.d.ts

@@ -262,6 +262,13 @@ export declare const QUESTIONNAIRE: ({
     default: (answers: Questionnair) => Promise<string>;
     when: (answers: Questionnair) => boolean | undefined;
     choices?: undefined;
+} | {
+    type: string;
+    name: string;
+    message: string;
+    default: boolean;
+    choices?: undefined;
+    when?: undefined;
 } | {
     type: string;
     name: string;

package/build/constants.d.ts.map

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

package/build/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAK7C,wBAAsB,GAAG,CAAC,SAAS,2BAAoB,iBAkCtD;AAkBD,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,WAAW,iBAqCxD"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAK7C,wBAAsB,GAAG,CAAC,SAAS,2BAAoB,iBAuDtD;AAkBD,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,WAAW,iBAmDxD"}

package/build/index.js

@@ -5,7 +5,7 @@ import { pathToFileURL } from "node:url";
 import { execSync as execSync2 } from "node:child_process";
 import chalk3 from "chalk";
 import semver from "semver";
-import { Command } from "commander";
+import { Command, Option } from "commander";
 import { resolve } from "import-meta-resolve";
 
 // src/utils.ts
@@ -14,7 +14,6 @@ import path2 from "node:path";
 import util, { promisify } from "node:util";
 import fs2 from "node:fs/promises";
 import { execSync } from "node:child_process";
-import readDir from "recursive-readdir";
 import { $ } from "execa";
 import { readPackageUp } from "read-pkg-up";
 import inquirer from "inquirer";
@@ -24,7 +23,7 @@ import spawn from "cross-spawn";
 // package.json
 var package_default = {
   name: "create-wdio",
-  version: "9.31.6",
+  version: "9.32.0",
   description: "Install and setup a WebdriverIO project with all its dependencies in a single run",
   author: "WebdriverIO Team <mail@webdriver.io>",
   homepage: "https://github.com/webdriverio/webdriverio/tree/main/packages/create-wdio",
@@ -53,9 +52,9 @@ var package_default = {
     }
   },
   types: "./build/index.d.ts",
-  typeScriptVersion: "3.8.3",
+  typeScriptVersion: "6.0.3",
   engines: {
-    node: ">=18.20.0"
+    node: ">=22.19.0"
   },
   repository: {
     type: "git",
@@ -85,10 +84,9 @@ var package_default = {
     inquirer: "^12.7.0",
     "normalize-package-data": "^7.0.0",
     "read-pkg-up": "^10.1.0",
-    "recursive-readdir": "^2.2.3",
     semver: "^7.6.3",
     "type-fest": "^4.41.0",
-    yargs: "^17.7.2"
+    yargs: "^18.2.0"
   },
   devDependencies: {
     "@types/cross-spawn": "^6.0.6",
@@ -158,7 +156,7 @@ var PROGRAM_TITLE = `
 `;
 var UNSUPPORTED_NODE_VERSION = `\u26A0\uFE0F  Unsupported Node.js Version Error \u26A0\uFE0F
 You are using Node.js ${process.version} which is too old to be used with WebdriverIO.
-Please update to Node.js v20 to continue.
+Please update to Node.js v22.19.0 to continue.
 `;
 var INSTALL_COMMAND = {
   npm: "install",
@@ -233,6 +231,7 @@ var SUPPORTED_PACKAGES = {
   service: [
     // internal or community driver services
     { name: "visual", value: "@wdio/visual-service$--$visual" },
+    { name: "ai", value: "@wdio/ai-service$--$ai" },
     { name: "vite", value: "wdio-vite-service$--$vite" },
     { name: "nuxt", value: "wdio-nuxt-service$--$nuxt" },
     { name: "firefox-profile", value: "@wdio/firefox-profile-service$--$firefox-profile" },
@@ -824,6 +823,11 @@ var QUESTIONNAIRE = [{
     /* istanbul ignore next */
     (answers) => answers.generateTestFiles && usesSerenity(answers)
   )
+}, {
+  type: "confirm",
+  name: "agentSupport",
+  message: "Set up coding agent support (AGENTS.md section and wdio-session skill)?",
+  default: true
 }, {
   type: "checkbox",
   name: "reporters",
@@ -954,17 +958,352 @@ import chalk2 from "chalk";
 // src/install.ts
 import { execa } from "execa";
 
+// src/answerFlags.ts
+var AnswerFlagError = class extends Error {
+  name = "AnswerFlagError";
+};
+var HASH = "$--$";
+function packageChoices(packages, key = (short) => short) {
+  return () => Object.fromEntries(packages().map(({ value }) => {
+    const [pkg, short, purpose] = value.split(HASH);
+    return [key(short, purpose, pkg), value];
+  }));
+}
+var ANSWER_FLAGS = [{
+  name: "runner",
+  answer: "runner",
+  type: "string",
+  desc: "Type of testing",
+  choices: packageChoices(() => SUPPORTED_PACKAGES.runner, (_, purpose) => purpose)
+}, {
+  name: "preset",
+  answer: "preset",
+  type: "string",
+  desc: "UI framework of your components (with --runner component)",
+  choices: () => Object.fromEntries(SUPPORTED_BROWSER_RUNNER_PRESETS.map(({ name, value }) => [
+    value === null ? "other" : value.split(HASH)[1] || name.split(" ")[0].toLowerCase(),
+    value
+  ]))
+}, {
+  name: "testingLibrary",
+  answer: "installTestingLibrary",
+  type: "boolean",
+  desc: "Install Testing Library (with --preset vue, svelte, solid, react or preact)"
+}, {
+  name: "desktopFramework",
+  answer: "desktopFramework",
+  type: "string",
+  desc: "Desktop app framework (with --runner desktop)",
+  choices: () => ({
+    electron: "Electron (https://www.electronjs.org/)" /* Electron */,
+    tauri: "Tauri (https://tauri.app/)" /* Tauri */,
+    dioxus: "Dioxus (https://dioxuslabs.com/)" /* Dioxus */,
+    macos: "Native macOS app" /* MacOS */
+  })
+}, {
+  name: "electronBuildTool",
+  answer: "electronBuildTool",
+  type: "string",
+  desc: "Tool that builds your Electron app (with --desktop-framework electron)",
+  choices: () => ({
+    forge: "Electron Forge (https://www.electronforge.io/)" /* ElectronForge */,
+    builder: "electron-builder (https://www.electron.build/)" /* ElectronBuilder */,
+    other: "Something else" /* SomethingElse */
+  })
+}, {
+  name: "electronAppBinaryPath",
+  answer: "electronAppBinaryPath",
+  type: "string",
+  desc: "Path to the built Electron app (with --electron-build-tool other)"
+}, {
+  name: "tauriDriverProvider",
+  answer: "tauriDriverProvider",
+  type: "string",
+  desc: "WebDriver provider for Tauri (with --desktop-framework tauri)",
+  choices: () => ({
+    official: "Official tauri-driver (cross-platform, Cargo-installed)" /* Official */,
+    crabnebula: "CrabNebula tauri-driver (managed cloud / drop-in)" /* CrabNebula */,
+    embedded: "Embedded driver via tauri-plugin-wdio-webdriver crate" /* Embedded */
+  })
+}, {
+  name: "tauriFrontendPlugin",
+  answer: "tauriUseFrontendPlugin",
+  type: "boolean",
+  desc: "Install @wdio/tauri-plugin (with --desktop-framework tauri)"
+}, {
+  name: "tauriAppBinaryPath",
+  answer: "tauriAppBinaryPath",
+  type: "string",
+  desc: "Path to the built Tauri binary (with --desktop-framework tauri)"
+}, {
+  name: "dioxusDriverProvider",
+  answer: "dioxusDriverProvider",
+  type: "string",
+  desc: "WebDriver provider for Dioxus (with --desktop-framework dioxus)",
+  choices: () => ({
+    embedded: "Embedded in-process driver (recommended \u2014 no external driver, all platforms)" /* Embedded */,
+    external: "External driver via wdio-dioxus-driver (Windows only)" /* External */
+  })
+}, {
+  name: "dioxusAppBinaryPath",
+  answer: "dioxusAppBinaryPath",
+  type: "string",
+  desc: "Path to the Dioxus debug binary (with --desktop-framework dioxus)"
+}, {
+  name: "backend",
+  answer: "backend",
+  type: "string",
+  desc: "Where the automation backend runs (with --runner e2e)",
+  choices: () => ({
+    local: "On my local machine" /* Local */,
+    experitest: "In the cloud using Experitest" /* Experitest */,
+    saucelabs: "In the cloud using Sauce Labs" /* Saucelabs */,
+    browserstack: "In the cloud using BrowserStack" /* Browserstack */,
+    other: "In the cloud using Testingbot or LambdaTest or a different service" /* OtherVendors */,
+    grid: "I have my own Selenium cloud" /* Grid */
+  })
+}, {
+  name: "environment",
+  answer: "e2eEnvironment",
+  type: "string",
+  desc: "What to automate (with --runner e2e). Implied by --browsers or --mobile-environment",
+  choices: () => ({ web: "web", mobile: "mobile" })
+}, {
+  name: "mobileEnvironment",
+  answer: "mobileEnvironment",
+  type: "string",
+  desc: "Mobile platform (with --environment mobile)",
+  choices: () => ({ android: "android", ios: "ios" })
+}, {
+  name: "browsers",
+  answer: "browserEnvironment",
+  type: "array",
+  desc: "Comma-separated browsers to start with (with --environment web)",
+  choices: () => ({ chrome: "chrome", firefox: "firefox", safari: "safari", edge: "MicrosoftEdge" })
+}, {
+  name: "hostname",
+  answer: "hostname",
+  type: "string",
+  desc: "Host of the cloud service or Selenium server (with --backend other or grid)"
+}, {
+  name: "port",
+  answer: "port",
+  type: "string",
+  desc: "Port of the cloud service or Selenium server (with --backend other or grid)"
+}, {
+  name: "path",
+  answer: "path",
+  type: "string",
+  desc: "Path of the Selenium server (with --backend grid)"
+}, {
+  name: "envUser",
+  answer: "env_user",
+  type: "string",
+  desc: "Environment variable for the cloud username (with --backend saucelabs or browserstack, or other with a lambdatest.com --hostname)"
+}, {
+  name: "envKey",
+  answer: "env_key",
+  type: "string",
+  desc: "Environment variable for the cloud access key (with --backend saucelabs or browserstack, or other with a lambdatest.com --hostname)"
+}, {
+  name: "region",
+  answer: "region",
+  type: "string",
+  desc: "Sauce Labs region (with --backend saucelabs)",
+  choices: () => Object.fromEntries(Object.values(RegionOptions).map((region) => [region, region]))
+}, {
+  name: "sauceConnect",
+  answer: "useSauceConnect",
+  type: "boolean",
+  desc: "Set up Sauce Connect for a local app (with --backend saucelabs)"
+}, {
+  name: "expAccessKey",
+  answer: "expEnvAccessKey",
+  type: "string",
+  desc: "Experitest access key (with --backend experitest)"
+}, {
+  name: "expHostname",
+  answer: "expEnvHostname",
+  type: "string",
+  desc: "Experitest cloud host (with --backend experitest)"
+}, {
+  name: "expPort",
+  answer: "expEnvPort",
+  type: "string",
+  desc: "Experitest cloud port (with --backend experitest)"
+}, {
+  name: "expProtocol",
+  answer: "expEnvProtocol",
+  type: "string",
+  desc: "Experitest protocol (with --backend experitest and a port other than 80 or 443)",
+  choices: () => ({ http: "http", https: "https" })
+}, {
+  name: "framework",
+  answer: "framework",
+  type: "string",
+  desc: "Test framework",
+  choices: packageChoices(() => SUPPORTED_PACKAGES.framework, (short, purpose, pkg) => pkg.startsWith("@serenity-js") ? `serenity-${purpose}` : short)
+}, {
+  name: "typescript",
+  answer: "isUsingTypeScript",
+  type: "boolean",
+  desc: "Write tests in TypeScript"
+}, {
+  name: "generateTestFiles",
+  answer: "generateTestFiles",
+  type: "boolean",
+  desc: "Generate example test files"
+}, {
+  name: "specs",
+  answer: "specs",
+  type: "string",
+  desc: "Location of spec or feature files (with --generate-test-files)"
+}, {
+  name: "stepDefinitions",
+  answer: "stepDefinitions",
+  type: "string",
+  desc: "Location of step definitions (with --framework cucumber)"
+}, {
+  name: "pageObjects",
+  answer: "usePageObjects",
+  type: "boolean",
+  desc: "Generate page objects (with --runner e2e and --generate-test-files)"
+}, {
+  name: "pages",
+  answer: "pages",
+  type: "string",
+  desc: "Location of page objects (with --page-objects)"
+}, {
+  name: "serenityLibPath",
+  answer: "serenityLibPath",
+  type: "string",
+  desc: "Location of the Serenity/JS Screenplay library (with --framework serenity-*)"
+}, {
+  name: "agentSupport",
+  answer: "agentSupport",
+  type: "boolean",
+  desc: "Write the AGENTS.md section and the wdio-session skill"
+}, {
+  name: "reporters",
+  answer: "reporters",
+  type: "array",
+  desc: "Comma-separated reporters",
+  choices: packageChoices(() => SUPPORTED_PACKAGES.reporter)
+}, {
+  name: "plugins",
+  answer: "plugins",
+  type: "array",
+  desc: "Comma-separated plugins",
+  choices: packageChoices(() => SUPPORTED_PACKAGES.plugin)
+}, {
+  name: "visualTesting",
+  answer: "includeVisualTesting",
+  type: "boolean",
+  desc: "Add visual testing (with --runner e2e or component)"
+}, {
+  name: "services",
+  answer: "services",
+  type: "array",
+  desc: "Comma-separated services, replaces the ones the wizard picks for your setup",
+  choices: packageChoices(() => SUPPORTED_PACKAGES.service)
+}, {
+  name: "npmInstall",
+  answer: "npmInstall",
+  type: "boolean",
+  desc: "Install the dependencies"
+}];
+function toKebabCase(name) {
+  return name.replace(/[A-Z]/g, (char) => `-${char.toLowerCase()}`);
+}
+function describeChoices(flag) {
+  return Object.keys(flag.choices()).join(", ");
+}
+function describeAnswerFlag(flag) {
+  return flag.choices ? `${flag.desc}: ${describeChoices(flag)}` : flag.desc;
+}
+var ANSWER_FLAGS_HELP = [
+  "Every wizard question has a flag. A flag answers its question and the wizard",
+  "asks the rest, or uses the defaults for the rest with --yes. Boolean flags",
+  "take a --no- prefix, e.g. --no-typescript. A flag for a question the wizard",
+  "does not ask for your setup is an error, and so is a value it does not offer."
+].join("\n");
+function answerFlagUsage(flag) {
+  const kebab = toKebabCase(flag.name);
+  return flag.type === "boolean" ? `--${kebab}` : `--${kebab} <${flag.type === "array" ? "list" : "value"}>`;
+}
+function lastValue(raw) {
+  return Array.isArray(raw) ? raw[raw.length - 1] : raw;
+}
+function toAnswerValue(flag, value) {
+  if (!flag.choices) {
+    return value;
+  }
+  const choices = flag.choices();
+  const key = value.toLowerCase();
+  if (!Object.prototype.hasOwnProperty.call(choices, key)) {
+    throw new AnswerFlagError(
+      `Invalid value "${value}" for --${toKebabCase(flag.name)}. Use one of: ${describeChoices(flag)}`
+    );
+  }
+  return choices[key];
+}
+function parseAnswerFlags(argv) {
+  const answers = {};
+  for (const flag of ANSWER_FLAGS) {
+    const raw = argv[flag.name];
+    if (typeof raw === "undefined") {
+      continue;
+    }
+    if (flag.type === "boolean") {
+      answers[flag.answer] = raw === true || raw === "true";
+    } else if (flag.type === "array") {
+      const values = [raw].flat().flatMap((value) => String(value).split(",")).map((value) => value.trim()).filter(Boolean).map((value) => toAnswerValue(flag, value));
+      answers[flag.answer] = [...new Set(values)];
+    } else {
+      answers[flag.answer] = toAnswerValue(flag, String(lastValue(raw)));
+    }
+  }
+  if (!answers.e2eEnvironment) {
+    if (answers.mobileEnvironment) {
+      answers.e2eEnvironment = "mobile";
+    } else if (answers.browserEnvironment) {
+      answers.e2eEnvironment = "web";
+    }
+  }
+  return answers;
+}
+function answerFlagsToArgs(argv) {
+  const args = [];
+  for (const flag of ANSWER_FLAGS) {
+    const raw = argv[flag.name];
+    if (typeof raw === "undefined") {
+      continue;
+    }
+    const kebab = toKebabCase(flag.name);
+    if (flag.type === "boolean") {
+      args.push(raw === true || raw === "true" ? `--${kebab}` : `--no-${kebab}`);
+    } else {
+      args.push(`--${kebab}`, [raw].flat().join(","));
+    }
+  }
+  return args;
+}
+
 // src/utils.ts
 var NPM_COMMAND = /^win/.test(process.platform) ? "npm.cmd" : "npm";
 var __dirname = path2.dirname(url.fileURLToPath(import.meta.url));
 process.on("SIGINT", () => printAndExit(void 0, "SIGINT"));
 var TEMPLATE_ROOT_DIR = process.env.WDIO_UNIT_TESTS ? path2.join(__dirname, "templates", "exampleFiles") : path2.join(__dirname, "..", "templates", "exampleFiles");
-function runProgram(command, args, options) {
+function runProgram(command, args, options, passUsageError = false) {
   const child = spawn(command, args, { stdio: "inherit", ...options });
   return new Promise((resolve2, rejects) => {
     let error;
     child.on("error", (e) => error = e);
     child.on("close", (code, signal) => {
+      if (passUsageError && code === 2) {
+        process.exit(2);
+        return rejects(`Usage error calling: ${command} ${args.join(" ")}`);
+      }
       if (code !== 0) {
         const errorMessage = error && error.message || `Error calling: ${command} ${args.join(" ")}`;
         printAndExit(errorMessage, signal);
@@ -1056,12 +1395,29 @@ async function run(operation = createWebdriverIO) {
   if (!(process.argv.includes("--version") || process.argv.includes("-v"))) {
     console.log(ASCII_ROBOT, PROGRAM_TITLE);
   }
-  const unsupportedNodeVersion = !semver.satisfies(process.version, ">=18.18.0");
+  const unsupportedNodeVersion = !semver.satisfies(process.version, ">=22.19.0");
   if (unsupportedNodeVersion) {
     console.log(chalk3.yellow(UNSUPPORTED_NODE_VERSION));
     return;
   }
-  const program = new Command(WDIO_COMMAND).version(version, "-v, --version").arguments("[project-path]").usage(`${chalk3.green("[project-path]")} [options]`).action((name) => projectDir = name).option("-t, --npm-tag <tag>", "Which NPM version you like to install, e.g. @next", DEFAULT_NPM_TAG).option("-y, --yes", "will fill in all config defaults without prompting", false).option("-d, --dev", "Install all packages as into devDependencies", true).allowUnknownOption().on("--help", () => console.log()).parse(process.argv);
+  const program = new Command(WDIO_COMMAND).version(version, "-v, --version").arguments("[project-path]").usage(`${chalk3.green("[project-path]")} [options]`).action((name) => projectDir = name).option("-t, --npm-tag <tag>", "Which NPM version you like to install, e.g. @next", DEFAULT_NPM_TAG).option("-y, --yes", "will fill in all config defaults without prompting", false).option("-d, --dev", "Install all packages as into devDependencies", true);
+  for (const flag of ANSWER_FLAGS) {
+    program.option(answerFlagUsage(flag), describeAnswerFlag(flag));
+    if (flag.type === "boolean") {
+      program.addOption(new Option(answerFlagUsage(flag).replace("--", "--no-")).hideHelp());
+    }
+  }
+  program.allowUnknownOption().addHelpText("after", [
+    "",
+    ANSWER_FLAGS_HELP,
+    "",
+    "Examples:",
+    "  npm init wdio@latest . -- --yes",
+    "  npm init wdio@latest ./e2e -- --yes --framework cucumber --no-typescript",
+    "  npm init wdio@latest . -- --yes --environment mobile --mobile-environment android",
+    "  npm init wdio@latest . -- --runner component --preset react",
+    ""
+  ].join("\n")).parse(process.argv);
   return operation(program.opts());
 }
 function detectPackageManager2() {
@@ -1073,6 +1429,16 @@ function detectPackageManager2() {
   return matchedPM || "npm";
 }
 async function createWebdriverIO(opts) {
+  try {
+    parseAnswerFlags(opts);
+  } catch (err) {
+    if (!(err instanceof AnswerFlagError)) {
+      throw err;
+    }
+    console.error(`Error: ${err.message}
+Run "npm init wdio -- --help" for all flags.`);
+    return process.exit(2);
+  }
   const npmTag = opts.npmTag.startsWith("@") ? opts.npmTag : `@${opts.npmTag}`;
   const root = path3.resolve(process.cwd(), projectDir || "");
   const pm = detectPackageManager2();
@@ -1101,8 +1467,9 @@ Installing ${chalk3.bold("@wdio/cli")} to initialize project...`);
     WDIO_COMMAND,
     "config",
     ...opts.yes ? ["--yes"] : [],
-    ...opts.npmTag ? ["--npm-tag", opts.npmTag] : []
-  ].filter((i) => !!i), { cwd: root });
+    ...opts.npmTag ? ["--npm-tag", opts.npmTag] : [],
+    ...answerFlagsToArgs(opts)
+  ].filter((i) => !!i), { cwd: root }, true);
 }
 async function isCLIInstalled(path4) {
   try {