create-wdio 9.32.0 → 10.0.0-alpha.149

package/build/config/cli.js

@@ -24,7 +24,6 @@ import path from "node:path";
 import util, { promisify } from "node:util";
 import fs from "node:fs/promises";
 import { execSync } from "node:child_process";
-import readDir from "recursive-readdir";
 import { $ } from "execa";
 import { readPackageUp } from "read-pkg-up";
 
@@ -124,17 +123,380 @@ function getInstallCommand(pm, packages, dev) {
   return `${pm} ${installCommand[pm]} ${packages.join(" ")} ${devParam}`;
 }
 
+// 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 flagFor(answer) {
+  return ANSWER_FLAGS.find((flag) => flag.answer === answer);
+}
+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 getAnswerFlagYargsOptions() {
+  return Object.fromEntries(ANSWER_FLAGS.map((flag) => [toKebabCase(flag.name), {
+    desc: describeAnswerFlag(flag),
+    type: flag.type === "boolean" ? "boolean" : "string",
+    group: "Wizard answers:"
+  }]));
+}
+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 isAsked(question, answers) {
+  const when = question.when;
+  if (typeof when === "function") {
+    return Boolean(when(answers));
+  }
+  return typeof when === "undefined" || Boolean(when);
+}
+function choiceValues(question, answers) {
+  if (!question.choices) {
+    return void 0;
+  }
+  const choices = typeof question.choices === "function" ? question.choices(answers) : question.choices;
+  return choices.filter((choice) => typeof choice !== "undefined").map((choice) => choice && typeof choice === "object" ? choice.value : choice);
+}
+function assertAnswerFlagsApply(flagAnswers, answers) {
+  for (const [answer, value] of Object.entries(flagAnswers)) {
+    const flag = flagFor(answer);
+    const usage = `--${toKebabCase(flag.name)}`;
+    const questions = QUESTIONNAIRE.filter((question) => question.name === answer && isAsked(question, answers));
+    if (questions.length === 0) {
+      throw new AnswerFlagError(`${usage} does not apply to this setup. ${flag.desc}.`);
+    }
+    const offered = questions.map((question) => choiceValues(question, answers));
+    if (offered.some((values) => typeof values === "undefined")) {
+      continue;
+    }
+    const allowed = new Set(offered.flat());
+    const rejected = [value].flat().filter((item) => !allowed.has(item));
+    if (rejected.length === 0) {
+      continue;
+    }
+    const cliValues = Object.entries(flag.choices());
+    const toCli = (item) => cliValues.find(([, v]) => v === item)?.[0] ?? String(item);
+    throw new AnswerFlagError(
+      `${usage} ${rejected.map(toCli).join(",")} is not available for this setup. Use one of: ${[...new Set([...allowed].map(toCli))].join(", ")}`
+    );
+  }
+}
+
 // src/utils.ts
 var NPM_COMMAND = /^win/.test(process.platform) ? "npm.cmd" : "npm";
 var __dirname = path.dirname(url.fileURLToPath(import.meta.url));
 process.on("SIGINT", () => printAndExit(void 0, "SIGINT"));
 var TEMPLATE_ROOT_DIR = process.env.WDIO_UNIT_TESTS ? path.join(__dirname, "templates", "exampleFiles") : path.join(__dirname, "..", "templates", "exampleFiles");
-function runProgram(command2, args, options) {
+function runProgram(command2, args, options, passUsageError = false) {
   const child = spawn(command2, args, { stdio: "inherit", ...options });
   return new Promise((resolve, 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: ${command2} ${args.join(" ")}`);
+      }
       if (code !== 0) {
         const errorMessage = error && error.message || `Error calling: ${command2} ${args.join(" ")}`;
         printAndExit(errorMessage, signal);
@@ -158,24 +520,35 @@ function convertPackageHashToObject(pkg, hash = "$--$") {
   const [p, short, purpose] = pkg.split(hash);
   return { package: p, short, purpose };
 }
-async function getAnswers(yes) {
-  if (yes) {
-    const ignoredQuestions = ["e2eEnvironment"];
-    const filteredQuestionaire = QUESTIONNAIRE.filter((question) => !ignoredQuestions.includes(question.name));
-    const answers2 = {};
-    for (const question of filteredQuestionaire) {
-      if (question.when && !question.when(answers2)) {
-        continue;
-      }
-      Object.assign(answers2, {
-        [question.name]: typeof question.default !== "undefined" ? typeof question.default === "function" ? await question.default(answers2) : question.default : question.choices && question.choices.length ? typeof question.choices === "function" ? question.choices(answers2)[0].value ? question.choices(answers2)[0].value : question.choices(answers2)[0] : question.choices[0].value ? question.type === "checkbox" ? [question.choices[0].value] : question.choices[0].value : question.choices[0] : {}
-      });
+async function getAnswers(yes, flagAnswers = {}) {
+  const answers = yes ? await getDefaultAnswers(flagAnswers) : await promptAnswers(flagAnswers);
+  assertAnswerFlagsApply(flagAnswers, answers);
+  return answers;
+}
+async function getDefaultAnswers(flagAnswers) {
+  const ignoredQuestions = ["e2eEnvironment"];
+  const filteredQuestionaire = QUESTIONNAIRE.filter((question) => !ignoredQuestions.includes(question.name));
+  const answers = { ...flagAnswers };
+  for (const question of filteredQuestionaire) {
+    if (Object.prototype.hasOwnProperty.call(flagAnswers, question.name)) {
+      continue;
+    }
+    if (question.when && !question.when(answers)) {
+      continue;
     }
-    answers2.isUsingTypeScript = await answers2.isUsingTypeScript;
-    answers2.specs = await answers2.specs;
-    answers2.pages = await answers2.pages;
-    return answers2;
+    if (typeof question.default === "undefined" && !question.choices) {
+      continue;
+    }
+    Object.assign(answers, {
+      [question.name]: typeof question.default !== "undefined" ? typeof question.default === "function" ? await question.default(answers) : question.default : question.choices && question.choices.length ? typeof question.choices === "function" ? question.choices(answers)[0].value ? question.choices(answers)[0].value : question.choices(answers)[0] : question.choices[0].value ? question.type === "checkbox" ? [question.choices[0].value] : question.choices[0].value : question.choices[0] : {}
+    });
   }
+  answers.isUsingTypeScript = await answers.isUsingTypeScript;
+  answers.specs = await answers.specs;
+  answers.pages = await answers.pages;
+  return answers;
+}
+async function promptAnswers(flagAnswers) {
   const projectProps = await getProjectProps(process.cwd());
   const isProjectExisting = Boolean(projectProps);
   const nameInPackageJsonIsNotCreateWdioDefault = projectProps?.packageJson?.name !== "my-new-project";
@@ -211,7 +584,7 @@ async function getAnswers(yes) {
   if (answers.createPackageJSON) {
     answers.projectRoot = process.cwd();
   }
-  return inquirer.prompt(QUESTIONNAIRE, answers);
+  return inquirer.prompt(QUESTIONNAIRE, { ...answers, ...flagAnswers });
 }
 async function getProjectProps(cwd = process.cwd()) {
   try {
@@ -267,11 +640,8 @@ async function createPackageJSON(parsedAnswers) {
     return;
   }
   if (parsedAnswers.createPackageJSON === false) {
-    if (!packageJsonExists) {
-      console.log(`No WebdriverIO configuration found in "${parsedAnswers.wdioConfigPath}"`);
-      return !process.env.WDIO_UNIT_TESTS && process.exit(0);
-    }
-    return;
+    console.log(`No WebdriverIO configuration found in "${parsedAnswers.wdioConfigPath}"`);
+    process.exit(0);
   }
   if (parsedAnswers.createPackageJSON) {
     console.log(`Creating a ${chalk.bold("package.json")} for the directory...`);
@@ -318,10 +688,13 @@ async function setupTypeScript(parsedAnswers) {
   const config = {
     compilerOptions: {
       // compiler
-      moduleResolution: "node",
-      module: !parsedAnswers.esmSupport ? "commonjs" : "ESNext",
-      target: "es2022",
-      lib: ["es2022", "dom"],
+      // TypeScript 6 deprecates `moduleResolution: 'node'` (node10). ESM uses
+      // `bundler`, which resolves imports as `tsx` does; CommonJS uses `NodeNext`,
+      // which follows the `type` of the project's package.json.
+      moduleResolution: parsedAnswers.esmSupport ? "bundler" : "NodeNext",
+      module: parsedAnswers.esmSupport ? "ESNext" : "NodeNext",
+      target: "es2024",
+      lib: ["es2024", "dom"],
       types,
       skipLibCheck: true,
       // bundler
@@ -466,8 +839,10 @@ function getPreset(parsedAnswers) {
 function addServiceDeps(names, packages, update = false) {
   if (names.some(({ short }) => short === "appium")) {
     const result = execSync("appium --version || echo APPIUM_MISSING", { stdio: "pipe" }).toString().trim();
-    if (result === "APPIUM_MISSING") {
-      packages.push("appium");
+    const major = Number.parseInt(result.replace(/^v/i, "").split(".")[0] || "", 10);
+    const hasAppium3 = result !== "APPIUM_MISSING" && !Number.isNaN(major) && major >= 3;
+    if (!hasAppium3) {
+      packages.push("appium@^3");
     } else if (update) {
       console.log(
         "\n=======",
@@ -527,10 +902,15 @@ async function createWDIOScript(parsedAnswers) {
   console.log(chalk.green(chalk.bold("\u2714 Success!")));
   return true;
 }
-async function runAppiumInstaller(parsedAnswers) {
+async function runAppiumInstaller(parsedAnswers, yes = false) {
   if (parsedAnswers.e2eEnvironment !== "mobile") {
     return;
   }
+  if (yes || !process.stdin.isTTY) {
+    return console.log(
+      "Skipping the interactive Appium installer. Run `npx appium-installer` later, or see https://appium.io/docs/en/latest/quickstart/"
+    );
+  }
   const answer = await inquirer.prompt({
     name: "continueWithAppiumSetup",
     message: "Continue with Appium setup using appium-installer (https://github.com/AppiumTestDistribution/appium-installer)?",
@@ -626,6 +1006,10 @@ async function generateTestFiles(answers) {
   }
   return generateBrowserRunnerTestFiles(answers);
 }
+async function readDir(dir) {
+  const entries = await fs.readdir(dir, { recursive: true, withFileTypes: true });
+  return entries.filter((entry) => entry.isFile()).map((entry) => path.join(entry.parentPath, entry.name));
+}
 async function generateSerenityExamples(answers) {
   const templateDirectories = Object.entries({
     [answers.destSpecRootPath]: path.join(TEMPLATE_ROOT_DIR, "serenity-js", answers.serenityAdapter),
@@ -650,10 +1034,7 @@ async function generateLocalRunnerTestFiles(answers) {
   if (answers.usePageObjects) {
     testFiles.push(path.join(TEMPLATE_ROOT_DIR, "pageobjects"));
   }
-  const files = (await Promise.all(testFiles.map((dirPath) => readDir(
-    dirPath,
-    [(file, stats) => !stats.isDirectory() && !(file.endsWith(".ejs") || file.endsWith(".feature"))]
-  )))).reduce((cur, acc) => [...acc, ...cur], []);
+  const files = (await Promise.all(testFiles.map(readDir))).flat().filter((file) => file.endsWith(".ejs") || file.endsWith(".feature"));
   await Promise.all(files.map(async (file) => {
     const renderedTpl = await renderFile(file, { answers });
     const isJSX = answers.preset && TSX_BASED_FRAMEWORKS.includes(answers.preset);
@@ -692,7 +1073,7 @@ async function formatConfigFilePaths(config) {
 // 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",
@@ -721,9 +1102,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",
@@ -753,10 +1134,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",
@@ -784,7 +1164,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",
@@ -846,6 +1226,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" },
@@ -1540,6 +1921,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",
@@ -1677,10 +2063,79 @@ To install dependencies, execute:
 `;
 
 // src/cli/utils.ts
-import path3 from "node:path";
-import fs3 from "node:fs/promises";
+import path4 from "node:path";
+import fs4 from "node:fs/promises";
 import inquirer2 from "inquirer";
-async function runConfigCommand(parsedAnswers, npmTag) {
+
+// src/cli/agent.ts
+import fs3 from "node:fs";
+import path3 from "node:path";
+import { fileURLToPath } from "node:url";
+var AGENT_SECTION_HEADING = "## End-to-end tests (WebdriverIO v10)";
+var AGENT_SECTION = `${AGENT_SECTION_HEADING}
+
+- Docs: https://webdriver.io/llms.txt - fetch the relevant page as Markdown (append \`.md\`) before using an API you are not sure about. Do not use APIs from WebdriverIO v8 or older.
+- Config: \`wdio.conf.ts\`. Specs: \`test/specs/**/*.e2e.ts\`. Page objects: \`test/pageobjects/\`.
+- Run all tests: \`npx wdio run wdio.conf.ts\`
+- Run a single spec: \`npx wdio run wdio.conf.ts --spec test/specs/login.e2e.ts\`
+- Tests are async: always \`await\` commands, e.g. \`await $('button').click()\`. Never use the removed sync mode.
+- Prefer user-facing selectors: accessibility name or text (\`$('aria/Submit')\`, \`$('button=Submit')\`), then \`data-testid\`. Avoid XPath and generated CSS classes.
+- Rely on auto-waiting and \`expect-webdriverio\` matchers (\`await expect($('h1')).toHaveText('Welcome')\`) instead of \`browser.pause()\`.
+- To explore the app or verify a selector, use the \`wdio-mcp\` MCP server.
+- To drive the app from the shell, follow \`.agents/skills/wdio-session/SKILL.md\` (\`npx wdio session\`).
+- When a test fails, read the DevTools trace in \`test-results/\` (see \`transcript.md\`) before changing code.
+`;
+function readIfExists(file) {
+  return fs3.existsSync(file) ? fs3.readFileSync(file, "utf-8") : void 0;
+}
+function readSessionSkill(start = path3.dirname(fileURLToPath(import.meta.url))) {
+  let dir = start;
+  for (let i = 0; i < 8; i++) {
+    const candidates = [
+      path3.join(dir, "wdio-session", "src", "skill", "SKILL.md"),
+      path3.join(dir, "packages", "wdio-session", "src", "skill", "SKILL.md"),
+      path3.join(dir, "node_modules", "@wdio", "session", "src", "skill", "SKILL.md"),
+      path3.join(dir, "templates", "wdio-session", "SKILL.md")
+    ];
+    for (const candidate of candidates) {
+      const markdown = readIfExists(candidate);
+      if (markdown) {
+        return markdown;
+      }
+    }
+    const parent = path3.dirname(dir);
+    if (parent === dir) {
+      break;
+    }
+    dir = parent;
+  }
+  throw new Error("Cannot find the wdio-session skill (src/skill/SKILL.md).");
+}
+function writeAgentSupport(root) {
+  const skillDest = path3.join(root, ".agents", "skills", "wdio-session", "SKILL.md");
+  if (!fs3.existsSync(skillDest)) {
+    const markdown = readSessionSkill();
+    fs3.mkdirSync(path3.dirname(skillDest), { recursive: true });
+    fs3.writeFileSync(skillDest, markdown);
+  }
+  const agentsPath = path3.join(root, "AGENTS.md");
+  const agents = readIfExists(agentsPath) || "";
+  if (!agents.includes(AGENT_SECTION_HEADING)) {
+    const sep = agents.length === 0 ? "" : agents.endsWith("\n") ? "\n" : "\n\n";
+    fs3.writeFileSync(agentsPath, agents + sep + AGENT_SECTION);
+  }
+  const gitignorePath = path3.join(root, ".gitignore");
+  const gitignore = readIfExists(gitignorePath) || "";
+  const hasEntry = gitignore.split("\n").some((line) => line.trim() === ".wdio/session/" || line.trim() === ".wdio/session");
+  if (!hasEntry) {
+    const sep = gitignore.length === 0 || gitignore.endsWith("\n") ? "" : "\n";
+    fs3.writeFileSync(gitignorePath, `${gitignore}${sep}.wdio/session/
+`);
+  }
+}
+
+// src/cli/utils.ts
+async function runConfigCommand(parsedAnswers, npmTag, yes = false) {
   console.log("\n");
   await createPackageJSON(parsedAnswers);
   await setupTypeScript(parsedAnswers);
@@ -1709,10 +2164,13 @@ async function runConfigCommand(parsedAnswers, npmTag) {
       extraInfo: extraInfoParts.join("\n")
     })
   );
-  await runAppiumInstaller(parsedAnswers);
+  await runAppiumInstaller(parsedAnswers, yes);
+  if (parsedAnswers.rawAnswers?.agentSupport) {
+    writeAgentSupport(parsedAnswers.projectRootDir);
+  }
 }
 async function missingConfigurationPrompt(command2, configPath, runConfigCmd = runConfigCommand) {
-  const message = `Could not execute "${command2}" due to missing configuration, file "${path3.parse(configPath).name}[.js/.ts]" not found! Would you like to create one?`;
+  const message = `Could not execute "${command2}" due to missing configuration, file "${path4.parse(configPath).name}[.js/.ts]" not found! Would you like to create one?`;
   const { config } = await inquirer2.prompt({
     type: "confirm",
     name: "config",
@@ -1721,10 +2179,7 @@ async function missingConfigurationPrompt(command2, configPath, runConfigCmd = r
   });
   if (!config) {
     console.log(`No WebdriverIO configuration found in "${process.cwd()}"`);
-    if (!process.env.WDIO_UNIT_TESTS) {
-      process.exit(0);
-    }
-    return configPath;
+    process.exit(0);
   }
   const parsedAnswers = await parseAnswers(false);
   await runConfigCmd(parsedAnswers, "latest");
@@ -1736,8 +2191,8 @@ function resolveTsConfigFilePath({
   specs,
   runnerShort
 }) {
-  const rootTsConfigPath = path3.resolve(projectRootDir, "tsconfig.json");
-  const dedicatedTsConfigPath = path3.resolve(
+  const rootTsConfigPath = path4.resolve(projectRootDir, "tsconfig.json");
+  const dedicatedTsConfigPath = path4.resolve(
     projectRootDir,
     `tsconfig.${runnerShort === "local" ? "e2e" : "wdio"}.json`
   );
@@ -1747,13 +2202,13 @@ function resolveTsConfigFilePath({
   if (!specs) {
     return dedicatedTsConfigPath;
   }
-  const specPathWithoutGlobs = specs.split(path3.sep).filter((segment) => !segment.includes("*")).join(path3.sep);
-  const candidate = path3.resolve(projectRootDir, path3.dirname(specPathWithoutGlobs), "tsconfig.json");
-  return path3.resolve(candidate) === rootTsConfigPath ? dedicatedTsConfigPath : candidate;
+  const specPathWithoutGlobs = specs.split(path4.sep).filter((segment) => !segment.includes("*")).join(path4.sep);
+  const candidate = path4.resolve(projectRootDir, path4.dirname(specPathWithoutGlobs), "tsconfig.json");
+  return path4.resolve(candidate) === rootTsConfigPath ? dedicatedTsConfigPath : candidate;
 }
-var parseAnswers = async function(yes) {
+var parseAnswers = async function(yes, flagAnswers = {}) {
   console.log(CONFIG_HELPER_INTRO);
-  const answers = await getAnswers(yes);
+  const answers = await getAnswers(yes, flagAnswers);
   const frameworkPackage = convertPackageHashToObject(answers.framework);
   const runnerPackage = convertPackageHashToObject(answers.runner || SUPPORTED_PACKAGES.runner[0].value);
   const servicePackages = answers.services.map((service) => convertPackageHashToObject(service));
@@ -1772,7 +2227,7 @@ var parseAnswers = async function(yes) {
     ...servicePackages.map((service) => service.package),
     ...serenityPackages
   ].filter(Boolean);
-  const hasRootTSConfig = await fs3.access(path3.resolve(projectRootDir, "tsconfig.json")).then(() => true, () => false);
+  const hasRootTSConfig = await fs4.access(path4.resolve(projectRootDir, "tsconfig.json")).then(() => true, () => false);
   const tsConfigFilePath = resolveTsConfigFilePath({
     projectRootDir,
     hasRootTSConfig,
@@ -1782,7 +2237,7 @@ var parseAnswers = async function(yes) {
   const parsedPaths = getPathForFileGeneration(answers, projectRootDir);
   const isUsingTypeScript = answers.isUsingTypeScript;
   const wdioConfigFilename = `wdio.conf.${isUsingTypeScript ? "ts" : "js"}`;
-  const wdioConfigPath = path3.resolve(projectRootDir, wdioConfigFilename);
+  const wdioConfigPath = path4.resolve(projectRootDir, wdioConfigFilename);
   return {
     projectName: projectProps?.packageJson.name || "Test Suite",
     // default values required in templates
@@ -1801,8 +2256,8 @@ var parseAnswers = async function(yes) {
     reporters: reporterPackages.map(({ short }) => short),
     plugins: pluginPackages.map(({ short }) => short),
     services: servicePackages.map(({ short }) => short),
-    specs: answers.specs && `./${path3.relative(projectRootDir, answers.specs).replaceAll(path3.sep, "/")}`,
-    stepDefinitions: answers.stepDefinitions && `./${path3.relative(projectRootDir, answers.stepDefinitions).replaceAll(path3.sep, "/")}`,
+    specs: answers.specs && `./${path4.relative(projectRootDir, answers.specs).replaceAll(path4.sep, "/")}`,
+    stepDefinitions: answers.stepDefinitions && `./${path4.relative(projectRootDir, answers.stepDefinitions).replaceAll(path4.sep, "/")}`,
     packagesToInstall,
     isUsingTypeScript,
     esmSupport: projectProps && !projectProps.esmSupported ? false : true,
@@ -1817,20 +2272,20 @@ var parseAnswers = async function(yes) {
     relativePath: parsedPaths.relativePath,
     hasRootTSConfig,
     tsConfigFilePath,
-    tsProject: `./${path3.relative(projectRootDir, tsConfigFilePath).replaceAll(path3.sep, "/")}`,
+    tsProject: `./${path4.relative(projectRootDir, tsConfigFilePath).replaceAll(path4.sep, "/")}`,
     wdioConfigPath
   };
 };
 async function canAccessConfigPath(configPathNoExtension, configPath) {
   return new Promise((resolve, reject) => {
     if (configPath) {
-      fs3.access(configPath).then(() => resolve(configPath), reject);
+      fs4.access(configPath).then(() => resolve(configPath), reject);
     } else {
       reject();
     }
   }).catch(() => Promise.all(SUPPORTED_CONFIG_FILE_EXTENSION.map(async (supportedExtension) => {
     const configPathWithExtension = `${configPathNoExtension}.${supportedExtension}`;
-    return fs3.access(configPathWithExtension).then(() => configPathWithExtension, () => void 0);
+    return fs4.access(configPathWithExtension).then(() => configPathWithExtension, () => void 0);
   })).then(
     (configFilePaths) => configFilePaths.find(Boolean),
     () => void 0
@@ -1867,11 +2322,23 @@ var cmdArgs = {
   }
 };
 var builder = (yargs) => {
-  return yargs.options(cmdArgs).epilogue(CLI_EPILOGUE).help();
+  return yargs.options({ ...cmdArgs, ...getAnswerFlagYargsOptions() }).example("$0 config", "Answer every question in the wizard").example("$0 config --yes", "Use the defaults: Mocha, Chrome and page objects").example("$0 config --yes --framework cucumber --no-typescript", "Use the defaults, but Cucumber in JavaScript").example("$0 config --yes --environment mobile --mobile-environment android", "Android app tests with the Appium service").example("$0 config --runner component --preset react --framework mocha", "Answer some questions, the wizard asks the rest").epilogue(`${ANSWER_FLAGS_HELP}
+
+${CLI_EPILOGUE}`).help();
 };
 async function handler(argv, runConfigCmd = runConfigCommand) {
-  const parsedAnswers = await parseAnswers(argv.yes);
-  await runConfigCmd(parsedAnswers, argv.npmTag);
+  let parsedAnswers;
+  try {
+    parsedAnswers = await parseAnswers(argv.yes, parseAnswerFlags(argv));
+  } catch (err) {
+    if (!(err instanceof AnswerFlagError)) {
+      throw err;
+    }
+    console.error(`Error: ${err.message}
+Run "wdio config --help" for all flags.`);
+    return process.exit(2);
+  }
+  await runConfigCmd(parsedAnswers, argv.npmTag, argv.yes);
   return {
     success: true,
     parsedAnswers,