create-wdio 9.32.0 → 10.0.0-alpha.149

package/build/templates/snippets/cucumber.ejs

@@ -20,7 +20,7 @@
         // <boolean> fail if there are any undefined or pending steps
         strict: false,
         // <string> (expression) only execute the features or scenarios with tags matching the expression
-        tagExpression: '',
+        tags: '',
         // <number> timeout for step definitions
         timeout: 60000,
         // <boolean> Enable this config to treat undefined definitions as warnings.

package/build/templates/snippets/services.ejs

@@ -33,6 +33,15 @@ services: [<%- answers.services.map((service) => {
             // see https://webdriver.io/docs/desktop-testing/dioxus/configuration for all options
         }
     ]`
+    } else if (service === 'ai') {
+        return /*js*/`[
+        'ai',
+        {
+            // "provider:model", e.g. 'anthropic:claude-sonnet-5-5' with @langchain/anthropic installed,
+            // or set WDIO_AI_MODEL. See https://webdriver.io/docs/ai-steps
+            model: process.env.WDIO_AI_MODEL
+        }
+    ]`
     } else if (service === 'sauce' && answers.useSauceConnect) {
         return /*js*/`[
         'sauce',

package/build/types.d.ts

@@ -3,7 +3,11 @@ import type { PackageJson as typeFestPackageJson } from 'type-fest';
 import type { Package as normalizePackage } from 'normalize-package-data';
 export type NormalizedPackageJson = PackageJson & normalizePackage;
 export type PackageJson = typeFestPackageJson;
-export interface ProgramOpts {
+/**
+ * Wizard answers passed as flags, see `ANSWER_FLAGS`
+ */
+export type AnswerFlagArguments = Record<string, string | string[] | boolean | number | undefined>;
+export interface ProgramOpts extends AnswerFlagArguments {
     info: boolean;
     dev: boolean;
     yes: boolean;
@@ -44,6 +48,10 @@ export interface Questionnair {
     reporters: string[];
     services: string[];
     serenityLibPath?: string;
+    /**
+     * Write AGENTS.md rules, the wdio-session skill and a gitignore entry.
+     */
+    agentSupport?: boolean;
     plugins: string[];
     outputDir?: string;
     includeVisualTesting: boolean;
@@ -82,7 +90,7 @@ export interface ParsedAnswers extends Omit<Questionnair, 'runner' | 'framework'
     tsProject: string;
     wdioConfigPath: string;
 }
-export interface ConfigCommandArguments {
+export interface ConfigCommandArguments extends AnswerFlagArguments {
     yarn: boolean;
     yes: boolean;
     npmTag: string;

package/build/types.d.ts.map

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

package/build/utils/index.js

@@ -4,7 +4,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";
 import inquirer from "inquirer";
@@ -15,6 +14,264 @@ import chalk from "chalk";
 // src/install.ts
 import { execa } from "execa";
 
+// src/answerFlags.ts
+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"
+}];
+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");
+
 // src/utils.ts
 var NPM_COMMAND = /^win/.test(process.platform) ? "npm.cmd" : "npm";
 var __dirname = path.dirname(url.fileURLToPath(import.meta.url));
@@ -88,7 +345,7 @@ async function detectCompiler(answers) {
 // 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",
@@ -117,9 +374,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",
@@ -149,10 +406,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",
@@ -180,7 +436,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",
@@ -237,6 +493,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" },
@@ -828,6 +1085,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",

package/build/utils.d.ts

@@ -1,9 +1,18 @@
 import type { SpawnOptions } from 'node:child_process';
 import type { ParsedAnswers, ProjectProps, Questionnair, SupportedPackage } from './types.js';
-export declare function runProgram(command: string, args: string[], options: SpawnOptions): Promise<void>;
+/**
+ * @param passUsageError  exit with the child's code 2 (a usage error the child
+ *                        already explained, e.g. `wdio config` rejecting a flag)
+ *                        instead of reporting a generic failure
+ */
+export declare function runProgram(command: string, args: string[], options: SpawnOptions, passUsageError?: boolean): Promise<void>;
 export declare function getPackageVersion(): Promise<string>;
 export declare function convertPackageHashToObject(pkg: string, hash?: string): SupportedPackage;
-export declare function getAnswers(yes: boolean): Promise<Questionnair>;
+/**
+ * @param yes            fill in defaults instead of prompting
+ * @param flagAnswers    answers given as command line flags, these questions are not asked
+ */
+export declare function getAnswers(yes: boolean, flagAnswers?: Partial<Questionnair>): Promise<Questionnair>;
 /**
  * Receive project properties
  * @returns {@type ProjectProps} if a package.json can be found in cwd or parent directories, otherwise undefined
@@ -27,7 +36,7 @@ export declare function getProjectRoot(parsedAnswers?: Questionnair): Promise<st
 /**
  * create package.json if not already existing
  */
-export declare function createPackageJSON(parsedAnswers: ParsedAnswers): Promise<false | undefined>;
+export declare function createPackageJSON(parsedAnswers: ParsedAnswers): Promise<void>;
 /**
  * set up TypeScript if it is desired but not installed
  */
@@ -37,7 +46,10 @@ export declare function addServiceDeps(names: SupportedPackage[], packages: stri
 export declare function createWDIOConfig(parsedAnswers: ParsedAnswers): Promise<void>;
 export declare const renderFile: (path: string, data: Record<string, unknown>) => Promise<string>;
 export declare function createWDIOScript(parsedAnswers: ParsedAnswers): Promise<boolean>;
-export declare function runAppiumInstaller(parsedAnswers: ParsedAnswers): Promise<void | import("execa").Result<{
+/**
+ * @param yes  `--yes` was passed, so don't prompt
+ */
+export declare function runAppiumInstaller(parsedAnswers: ParsedAnswers, yes?: boolean): Promise<void | import("execa").Result<{
     stdio: "inherit";
 }>>;
 export declare function getSerenityPackages(answers: Questionnair): string[];

package/build/utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAKtD,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAA;AAkB7F,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,YAAY,iBAchF;AAED,wBAAsB,iBAAiB,oBAStC;AAYD,wBAAgB,0BAA0B,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,SAAS,GAAG,gBAAgB,CAGvF;AAED,wBAAsB,UAAU,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,YAAY,CAAC,CAmFpE;AAED;;;;GAIG;AACH,wBAAsB,eAAe,CAAC,GAAG,SAAgB,GAAG,OAAO,CAAC,YAAY,GAAG,SAAS,CAAC,CAkB5F;AAED,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM;;;;;;EA0BrF;AAaD;;;;;GAKG;AACH,wBAAsB,cAAc,CAAC,aAAa,CAAC,EAAE,YAAY,mBAahE;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,aAAa,EAAE,aAAa,8BAgCnE;AAED;;GAEG;AACH,wBAAsB,eAAe,CAAC,aAAa,EAAE,aAAa,iBAwKjE;AAMD,wBAAsB,UAAU,CAAC,aAAa,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,iBA0G5E;AAMD,wBAAgB,cAAc,CAAC,KAAK,EAAE,gBAAgB,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,MAAM,UAAQ,QAmB3F;AAED,wBAAsB,gBAAgB,CAAC,aAAa,EAAE,aAAa,iBAmBlE;AAED,eAAO,MAAM,UAAU,EAAgC,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,MAAM,CAAC,CAAA;AAGvH,wBAAsB,gBAAgB,CAAC,aAAa,EAAE,aAAa,oBA8BlE;AAGD,wBAAsB,kBAAkB,CAAC,aAAa,EAAE,aAAa;;IAoBpE;AACD,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,YAAY,GAAG,MAAM,EAAE,CAwCnE;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,6CASnC;AAED,wBAAsB,eAAe,CAAC,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,mBAU3E;AAID;;GAEG;AACH,wBAAsB,cAAc,CAAC,OAAO,EAAE,YAAY,oBASzD;AAGD;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,iBAAiB,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,YAelG;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,aAAa,iBAU7D;AA6DD,wBAAsB,8BAA8B,CAAC,OAAO,EAAE,aAAa,iBAiC1E;AAED;;;;GAIG;AACH,wBAAsB,qBAAqB,CAAC,MAAM,EAAE,MAAM;;;GAMzD;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,2BASxD;AAoBD,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,sBAYvE"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAKtD,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAA;AAmB7F;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,YAAY,EAAE,cAAc,UAAQ,iBAkBxG;AAED,wBAAsB,iBAAiB,oBAStC;AAYD,wBAAgB,0BAA0B,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,SAAS,GAAG,gBAAgB,CAGvF;AAED;;;GAGG;AACH,wBAAsB,UAAU,CAAC,GAAG,EAAE,OAAO,EAAE,WAAW,GAAE,OAAO,CAAC,YAAY,CAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAM7G;AAsGD;;;;GAIG;AACH,wBAAsB,eAAe,CAAC,GAAG,SAAgB,GAAG,OAAO,CAAC,YAAY,GAAG,SAAS,CAAC,CAkB5F;AAED,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM;;;;;;EA0BrF;AAaD;;;;;GAKG;AACH,wBAAsB,cAAc,CAAC,aAAa,CAAC,EAAE,YAAY,mBAahE;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,aAAa,EAAE,aAAa,iBA4BnE;AAED;;GAEG;AACH,wBAAsB,eAAe,CAAC,aAAa,EAAE,aAAa,iBA2KjE;AAMD,wBAAsB,UAAU,CAAC,aAAa,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,iBA0G5E;AAMD,wBAAgB,cAAc,CAAC,KAAK,EAAE,gBAAgB,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,MAAM,UAAQ,QAqB3F;AAED,wBAAsB,gBAAgB,CAAC,aAAa,EAAE,aAAa,iBAmBlE;AAED,eAAO,MAAM,UAAU,EAAgC,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,MAAM,CAAC,CAAA;AAGvH,wBAAsB,gBAAgB,CAAC,aAAa,EAAE,aAAa,oBA8BlE;AAGD;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,aAAa,EAAE,aAAa,EAAE,GAAG,UAAQ;;IA+BjF;AACD,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,YAAY,GAAG,MAAM,EAAE,CAwCnE;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,6CASnC;AAED,wBAAsB,eAAe,CAAC,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,mBAU3E;AAID;;GAEG;AACH,wBAAsB,cAAc,CAAC,OAAO,EAAE,YAAY,oBASzD;AAGD;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,iBAAiB,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,YAelG;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,aAAa,iBAU7D;AAoED,wBAAsB,8BAA8B,CAAC,OAAO,EAAE,aAAa,iBAiC1E;AAED;;;;GAIG;AACH,wBAAsB,qBAAqB,CAAC,MAAM,EAAE,MAAM;;;GAMzD;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,2BASxD;AAoBD,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,sBAYvE"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-wdio",
-  "version": "9.32.0",
+  "version": "10.0.0-alpha.149+ce13bea83",
   "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",
@@ -29,9 +29,9 @@
     }
   },
   "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",
@@ -61,10 +61,9 @@
     "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",
@@ -77,5 +76,5 @@
   "publishConfig": {
     "access": "public"
   },
-  "gitHead": "5c2a318d9a5e8424a2f2de95df9374b89bda7936"
+  "gitHead": "ce13bea839fb037eceda429dbf94cd387b7c3584"
 }

package/templates/wdio-session/SKILL.md

@@ -0,0 +1,96 @@
+---
+name: wdio-session
+description: Drive browsers, mobile apps and desktop apps with WebdriverIO from the shell to explore UI, verify changes and write tests.
+---
+
+# wdio session
+
+`wdio session` keeps a WebdriverIO session alive between short shell commands. Use it to explore a UI, check a change, and turn the steps that worked into a test.
+
+Use it when you need to see or drive a real browser, mobile app, or desktop app. Use `curl` or `fetch` instead when the question is only about an HTTP API.
+
+## 1. Discover commands with `--help`
+
+This file covers the core loop only. The CLI documents itself, and its help always matches the installed version:
+
+```sh
+npx wdio session --help            # the workflow, every action by group, global flags, exit codes
+npx wdio session <action> --help   # arguments, flags, platforms, examples and related actions
+```
+
+Run `<action> --help` before you use an action for the first time in a task. Don't guess flags: an unknown flag fails with exit code 2.
+
+## 2. The loop
+
+```sh
+npx wdio session open chrome http://localhost:3000
+npx wdio session snapshot -i
+npx wdio session click e3 && npx wdio session wait --text "Cart (1)" && npx wdio session snapshot -i
+npx wdio session export --out test/specs/cart.e2e.ts
+npx wdio session close
+```
+
+- **Open once.** Reuse the `default` session. Pass `-s <name>` only when you need two sessions at once. `open --help` lists every target: browsers, Android, iOS, macOS, Windows, Electron, Tauri, Dioxus, a wdio config, and cloud providers.
+- **Observe before acting.** `snapshot -i` lists interactive elements with refs like `button "Add to cart" [ref=e3]`. Use `find <text>` on large pages. Take a screenshot only when the question is about layout.
+- **Act on refs.** Refs stay valid while the element exists. After navigation, take a fresh snapshot.
+- **Chain steps with `&&`.** One shell call per act-wait-observe step is faster than separate calls, and a failing step stops the chain.
+- **Wait for a condition, not a time.** Use `wait <ref>`, `wait --text`, `wait --url` or `wait --load networkidle` instead of `sleep`.
+- **Read before you assert.** `get text e1`, `get url` and `is visible e1` print values. Put assertions in `exec`.
+
+## 3. Code
+
+Use `exec` for loops, conditions and assertions. Pipe longer code on stdin:
+
+```sh
+npx wdio session exec -e 'await expect($("h1")).toHaveText("Cart")'
+npx wdio session <<'JS'
+await $('aria/Sign in').click()
+await expect(browser).toHaveUrl(expect.stringContaining('/dashboard'))
+JS
+```
+
+WebdriverIO v10 rules:
+
+- Always `await` commands.
+- `$` returns exactly one element. More than one match throws `StrictSelectorError`. A missing element stays unresolved until a command uses it.
+- There is no sync mode and no `browser.element`.
+- In the shell, wrap code in single quotes so `$(…)` is not run as command substitution.
+
+Add a helper under `.wdio/helpers/` instead of a long `exec` script. Helpers become custom commands in the exported test.
+
+## 4. Turn it into a test
+
+Every action prints the WebdriverIO code it ran (`→ …`). `export` writes those steps as a spec:
+
+```sh
+npx wdio session export --out test/specs/cart.e2e.ts
+npx wdio run wdio.conf.ts --spec test/specs/cart.e2e.ts
+```
+
+No `wdio.conf.ts` yet? Create the project without prompts. Every wizard question has a flag, `npm init wdio@latest -- --help` lists them:
+
+```sh
+npm init wdio@latest . -- --yes --typescript --framework mocha --browsers chrome --reporters spec
+```
+
+## 5. Debug a failing test
+
+```sh
+npx wdio run wdio.conf.ts --debug=agent
+npx wdio session -s debug-0-0 snapshot -i
+npx wdio session -s debug-0-0 resume
+```
+
+`close` on that session fails the paused test.
+
+## 6. Errors
+
+| Exit | Meaning |
+| --- | --- |
+| 0 | Success |
+| 1 | The action or your code failed |
+| 2 | Usage error: check `<action> --help` |
+| 3 | Missing dependency or credentials |
+| 4 | No session with that name |
+
+Errors print a hint on the next line. `npx wdio session doctor` checks the machine; `doctor <target>` checks one target.