create-appraisejs 0.1.10-alpha.9 → 0.2.0-alpha.1

package/dist/prompts.test.js

@@ -0,0 +1,58 @@
+import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
+import path from 'path';
+import fs from 'fs';
+import os from 'os';
+import { runPrompts } from './prompts.js';
+vi.mock('@inquirer/prompts', () => ({
+    input: vi.fn(),
+    select: vi.fn(),
+    confirm: vi.fn(),
+}));
+async function getMocks() {
+    const { input, select, confirm } = await import('@inquirer/prompts');
+    return { input: input, select: select, confirm: confirm };
+}
+describe('runPrompts', () => {
+    let cwd;
+    let tempDir;
+    beforeEach(() => {
+        cwd = process.cwd();
+        tempDir = path.join(os.tmpdir(), `create-appraisejs-prompts-${Date.now()}`);
+    });
+    afterEach(async () => {
+        if (tempDir && fs.existsSync(tempDir)) {
+            fs.rmSync(tempDir, { recursive: true, force: true });
+        }
+        vi.clearAllMocks();
+    });
+    it('returns directory, packageManager, and runInstall from mocked prompts', async () => {
+        fs.mkdirSync(tempDir, { recursive: true });
+        const { input, select, confirm } = await getMocks();
+        input.mockResolvedValue(tempDir);
+        select.mockResolvedValue('pnpm');
+        confirm.mockResolvedValue(false);
+        const result = await runPrompts(cwd);
+        expect(result.directory).toBe(path.resolve(cwd, tempDir));
+        expect(result.packageManager).toBe('pnpm');
+        expect(result.runInstall).toBe(false);
+    });
+    it('throws when target directory exists and is non-empty', async () => {
+        fs.mkdirSync(tempDir, { recursive: true });
+        fs.writeFileSync(path.join(tempDir, 'file.txt'), 'x');
+        const { input } = await getMocks();
+        input.mockResolvedValue(tempDir);
+        await expect(runPrompts(cwd)).rejects.toThrow(/Directory must be empty/);
+    });
+    it('accepts when target directory does not exist', async () => {
+        const newPath = path.join(tempDir, 'new-app');
+        const { input, select, confirm } = await getMocks();
+        input.mockResolvedValue(newPath);
+        select.mockResolvedValue('npm');
+        confirm.mockResolvedValue(true);
+        const result = await runPrompts(cwd);
+        expect(result.directory).toBe(path.resolve(cwd, newPath));
+        expect(result.packageManager).toBe('npm');
+        expect(result.runInstall).toBe(true);
+    });
+});
+//# sourceMappingURL=prompts.test.js.map

package/dist/prompts.test.js.map

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

package/dist/scaffold-gitignore.d.ts

@@ -1,4 +1,5 @@
 export declare const SEEDED_TEMPLATE_PATHS: readonly ["prisma/dev.db", "automation/config/environments/environments.json"];
 export declare function setSeededTemplateFilesTracked(content: string, tracked: boolean): string;
 export declare function getEmptyEnvironmentsFileContent(): string;
+export declare function getEmptyLocatorMapFileContent(): string;
 //# sourceMappingURL=scaffold-gitignore.d.ts.map

package/dist/scaffold-gitignore.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"scaffold-gitignore.d.ts","sourceRoot":"","sources":["../src/scaffold-gitignore.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,qBAAqB,gFAAiF,CAAA;AAUnH,wBAAgB,6BAA6B,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,MAAM,CASvF;AAED,wBAAgB,+BAA+B,IAAI,MAAM,CAExD"}
+{"version":3,"file":"scaffold-gitignore.d.ts","sourceRoot":"","sources":["../src/scaffold-gitignore.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,qBAAqB,gFAAiF,CAAA;AAUnH,wBAAgB,6BAA6B,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,MAAM,CASvF;AAED,wBAAgB,+BAA+B,IAAI,MAAM,CAExD;AAED,wBAAgB,6BAA6B,IAAI,MAAM,CAEtD"}

package/dist/scaffold-gitignore.js

@@ -17,4 +17,7 @@ export function setSeededTemplateFilesTracked(content, tracked) {
 export function getEmptyEnvironmentsFileContent() {
     return '{}\n';
 }
+export function getEmptyLocatorMapFileContent() {
+    return '[]\n';
+}
 //# sourceMappingURL=scaffold-gitignore.js.map

package/dist/scaffold-gitignore.js.map

@@ -1 +1 @@
-{"version":3,"file":"scaffold-gitignore.js","sourceRoot":"","sources":["../src/scaffold-gitignore.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,eAAe,EAAE,kDAAkD,CAAU,CAAA;AAEnH,SAAS,sBAAsB,CAAC,KAAe;IAC7C,MAAM,OAAO,GAAG,CAAC,GAAG,KAAK,CAAC,CAAA;IAC1B,OAAO,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,OAAO,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC;QAChE,OAAO,CAAC,GAAG,EAAE,CAAA;IACf,CAAC;IACD,OAAO,OAAO,CAAA;AAChB,CAAC;AAED,MAAM,UAAU,6BAA6B,CAAC,OAAe,EAAE,OAAgB;IAC7E,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC,qBAAqB,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE,IAAI,QAAQ,EAAE,CAAC,CAAC,CAAC,CAAA;IACnG,MAAM,KAAK,GAAG,sBAAsB,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAA;IAE3G,KAAK,MAAM,QAAQ,IAAI,qBAAqB,EAAE,CAAC;QAC7C,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,QAAQ,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAA;IACjD,CAAC;IAED,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAA;AAChC,CAAC;AAED,MAAM,UAAU,+BAA+B;IAC7C,OAAO,MAAM,CAAA;AACf,CAAC"}
+{"version":3,"file":"scaffold-gitignore.js","sourceRoot":"","sources":["../src/scaffold-gitignore.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,eAAe,EAAE,kDAAkD,CAAU,CAAA;AAEnH,SAAS,sBAAsB,CAAC,KAAe;IAC7C,MAAM,OAAO,GAAG,CAAC,GAAG,KAAK,CAAC,CAAA;IAC1B,OAAO,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,OAAO,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC;QAChE,OAAO,CAAC,GAAG,EAAE,CAAA;IACf,CAAC;IACD,OAAO,OAAO,CAAA;AAChB,CAAC;AAED,MAAM,UAAU,6BAA6B,CAAC,OAAe,EAAE,OAAgB;IAC7E,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC,qBAAqB,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE,IAAI,QAAQ,EAAE,CAAC,CAAC,CAAC,CAAA;IACnG,MAAM,KAAK,GAAG,sBAAsB,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAA;IAE3G,KAAK,MAAM,QAAQ,IAAI,qBAAqB,EAAE,CAAC;QAC7C,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,QAAQ,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAA;IACjD,CAAC;IAED,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAA;AAChC,CAAC;AAED,MAAM,UAAU,+BAA+B;IAC7C,OAAO,MAAM,CAAA;AACf,CAAC;AAED,MAAM,UAAU,6BAA6B;IAC3C,OAAO,MAAM,CAAA;AACf,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-appraisejs",
-  "version": "0.1.10-alpha.9",
+  "version": "0.2.0-alpha.1",
   "description": "Scaffold a new AppraiseJS app in your directory",
   "license": "Apache-2.0",
   "author": "Hasnat Jamil",
@@ -46,7 +46,8 @@
     "test:e2e": "vitest run --config vitest.e2e.config.ts",
     "publish": "npm run build && npm publish",
     "publish:alpha": "npm run build && npm publish --tag alpha",
-    "publish:beta": "npm run build && npm publish --tag beta"
+    "publish:beta": "npm run build && npm publish --tag beta",
+    "bump:alpha": "npm version prerelease --preid alpha"
   },
   "dependencies": {
     "@inquirer/prompts": "^7.2.0",

package/templates/default/.appraise-template-meta.json

@@ -1,5 +1,5 @@
 {
-  "preparedAt": "2026-03-18T19:58:09.000Z",
-  "inputHash": "bd64681031e377dbc9b3c9fbc9d0e6dedb17afc7158dc7b55a0f02aed1d45e2f",
+  "preparedAt": "2026-03-23T05:51:28.888Z",
+  "inputHash": "538288241ebcec3d1c8efa09eaaba4e5aec5611c00011ab1ec6c2c6c31341fb5",
   "databasePath": "prisma/dev.db"
 }

package/templates/default/.env.example

@@ -1,2 +1,2 @@
-# Database configuration for local development
-DATABASE_URL="file:./dev.db"
+# Database configuration for local development
+DATABASE_URL="file:./dev.db"

package/templates/default/README.md

@@ -1,53 +1,53 @@
-# Appraise Starter Template
-
-This is a production-first Appraise starter project. Copy this folder into a new directory to start a new project.
-
-## Prerequisites
-
-- Node.js 18+
-- npm, pnpm, yarn, or bun
-
-## Quick start
-
-```bash
-# 1. Install dependencies, create .env, and build the production app
-npm run setup
-
-# 2. Optional: install Playwright browsers when you need test execution
-npm run install-playwright -- chromium
-
-# 3. Start the local production server
-npm run start
-```
-
-## What you get
-
-- **URL**: Open [http://localhost:3000](http://localhost:3000) in your browser.
-- **Runtime**: A seeded local SQLite database at `prisma/dev.db`.
-- **Automation**: Starter automation assets under `automation/`, including features, locators, environments, and reusable steps.
-- **UI**: The full Appraise dashboard and UI, ready to run from a production build.
-
-## Scripts
-
-| Script | Description |
-| --- | --- |
-| `npm run setup` | Install deps, create `.env`, and build the cucumber runtime plus the local production app |
-| `npm run build:local` | Build the cucumber runtime and the local production app |
-| `npm run start` | Start the local production server |
-| `npm run dev` | Start the Next.js development server |
-| `npm run install-playwright -- <browser...>` | Install selected Playwright browsers |
-| `npm run setup:db` | Recreate the local SQLite database from migrations and rerun `sync-all` |
-| `npm run setup:full` | Reinstall dependencies, rebuild the DB, rerun `sync-all`, and rebuild the production app |
-| `npm run sync-all` | Sync all starter entities from the bundled automation workspace into the database |
-| `npm run appraisejs:sync` | Alias for `sync-all` |
-
-## Configuration
-
-- Copy `.env.example` to `.env` before running, or let `npm run setup` create it.
-- Default local database URL: `DATABASE_URL="file:./dev.db"`.
-- The database file is created at `prisma/dev.db`.
-
-## Notes
-
-- `npm run setup` does not install Playwright browsers automatically. Install them only when you need browser-based test execution.
-- `npm run dev` is still available for development workflows, but `npm run start` is the primary path for day-to-day local usage.
+# Appraise Starter Template
+
+This is a production-first Appraise starter project. Copy this folder into a new directory to start a new project.
+
+## Prerequisites
+
+- Node.js 18+
+- npm, pnpm, yarn, or bun
+
+## Quick start
+
+```bash
+# 1. Install dependencies, create .env, and build the production app
+npm run setup
+
+# 2. Optional: install Playwright browsers when you need test execution
+npm run install-playwright -- chromium
+
+# 3. Start the local production server
+npm run start
+```
+
+## What you get
+
+- **URL**: Open [http://localhost:3000](http://localhost:3000) in your browser.
+- **Runtime**: A seeded local SQLite database at `prisma/dev.db`.
+- **Automation**: Starter automation assets under `automation/`, including features, locators, environments, and reusable steps.
+- **UI**: The full Appraise dashboard and UI, ready to run from a production build.
+
+## Scripts
+
+| Script | Description |
+| --- | --- |
+| `npm run setup` | Install deps, create `.env`, and build the cucumber runtime plus the local production app |
+| `npm run build:local` | Build the cucumber runtime and the local production app |
+| `npm run start` | Start the local production server |
+| `npm run dev` | Start the Next.js development server |
+| `npm run install-playwright -- <browser...>` | Install selected Playwright browsers |
+| `npm run setup:db` | Recreate the local SQLite database from migrations and rerun `sync-all` |
+| `npm run setup:full` | Reinstall dependencies, rebuild the DB, rerun `sync-all`, and rebuild the production app |
+| `npm run sync-all` | Sync all starter entities from the bundled automation workspace into the database |
+| `npm run appraisejs:sync` | Alias for `sync-all` |
+
+## Configuration
+
+- Copy `.env.example` to `.env` before running, or let `npm run setup` create it.
+- Default local database URL: `DATABASE_URL="file:./dev.db"`.
+- The database file is created at `prisma/dev.db`.
+
+## Notes
+
+- `npm run setup` does not install Playwright browsers automatically. Install them only when you need browser-based test execution.
+- `npm run dev` is still available for development workflows, but `npm run start` is the primary path for day-to-day local usage.

package/templates/default/automation/mapping/locator-map.json

@@ -1,18 +1 @@
-[
-  {
-    "name": "login",
-    "path": "/login"
-  },
-  {
-    "name": "home",
-    "path": "/home"
-  },
-  {
-    "name": "test",
-    "path": "/test"
-  },
-  {
-    "name": "testload",
-    "path": "/login"
-  }
-]
+[]

package/templates/default/automation/steps/actions/click.step.ts

@@ -1,59 +1,59 @@
 import { When, Then, CustomWorld, expect, SelectorName, resolveLocator, getEnvironment, generateRandomData, RandomDataType } from '../../../packages/cucumber-runtime/src/index.js'
-/**
- * @name click
- * @description Template step for handling element click
- * @type ACTION
- */
-
-// This file is generated automatically. Add template steps to this group to generate content.
-
-/**
- * @name click
- * @description Template step for clicking on an element
- * @icon MOUSE
- */
-When('the user clicks on the {string} element', async function (this: CustomWorld, elementName: SelectorName) {
-  const selector = await resolveLocator(this.page, elementName)
-  if (!selector) {
-    throw new Error(`Selector ${elementName} not found. Current url: ${this.page.url()}`)
-  }
-  try {
-    await this.page.locator(selector).click()
-  } catch (error) {
-    throw new Error(`Failed to click on the ${elementName} element: ${error}`)
-  }
-})
-
-/**
- * @name double click
- * @description Template step for double clicking on an element
- * @icon MOUSE
- */
-When('the user double clicks on the {string} element', async function (this: CustomWorld, elementName: SelectorName) {
-  const selector = await resolveLocator(this.page, elementName)
-  if (!selector) {
-    throw new Error(`Selector ${elementName} not found. Current url: ${this.page.url()}`)
-  }
-  try {
-    await this.page.locator(selector).dblclick()
-  } catch (error) {
-    throw new Error(`Failed to double click on the ${elementName} element: ${error}`)
-  }
-})
-
-/**
- * @name right click
- * @description Template step for right clicking on an element
- * @icon MOUSE
- */
-When('the user right clicks on the {string} element', async function (this: CustomWorld, elementName: SelectorName) {
-  const selector = await resolveLocator(this.page, elementName)
-  if (!selector) {
-    throw new Error(`Selector ${elementName} not found. Current url: ${this.page.url()}`)
-  }
-  try {
-    await this.page.locator(selector).click({ button: 'right' })
-  } catch (error) {
-    throw new Error(`Failed to right click on the ${elementName} element: ${error}`)
-  }
-})
+/**
+ * @name click
+ * @description Template step for handling element click
+ * @type ACTION
+ */
+
+// This file is generated automatically. Add template steps to this group to generate content.
+
+/**
+ * @name click
+ * @description Template step for clicking on an element
+ * @icon MOUSE
+ */
+When('the user clicks on the {string} element', async function (this: CustomWorld, elementName: SelectorName) {
+  const selector = await resolveLocator(this.page, elementName)
+  if (!selector) {
+    throw new Error(`Selector ${elementName} not found. Current url: ${this.page.url()}`)
+  }
+  try {
+    await this.page.locator(selector).click()
+  } catch (error) {
+    throw new Error(`Failed to click on the ${elementName} element: ${error}`)
+  }
+})
+
+/**
+ * @name double click
+ * @description Template step for double clicking on an element
+ * @icon MOUSE
+ */
+When('the user double clicks on the {string} element', async function (this: CustomWorld, elementName: SelectorName) {
+  const selector = await resolveLocator(this.page, elementName)
+  if (!selector) {
+    throw new Error(`Selector ${elementName} not found. Current url: ${this.page.url()}`)
+  }
+  try {
+    await this.page.locator(selector).dblclick()
+  } catch (error) {
+    throw new Error(`Failed to double click on the ${elementName} element: ${error}`)
+  }
+})
+
+/**
+ * @name right click
+ * @description Template step for right clicking on an element
+ * @icon MOUSE
+ */
+When('the user right clicks on the {string} element', async function (this: CustomWorld, elementName: SelectorName) {
+  const selector = await resolveLocator(this.page, elementName)
+  if (!selector) {
+    throw new Error(`Selector ${elementName} not found. Current url: ${this.page.url()}`)
+  }
+  try {
+    await this.page.locator(selector).click({ button: 'right' })
+  } catch (error) {
+    throw new Error(`Failed to right click on the ${elementName} element: ${error}`)
+  }
+})

package/templates/default/automation/steps/actions/hover.step.ts

@@ -1,28 +1,28 @@
 import { When, Then, CustomWorld, expect, SelectorName, resolveLocator, getEnvironment, generateRandomData, RandomDataType } from '../../../packages/cucumber-runtime/src/index.js'
-/**
- * @name hover
- * @description Template steps that handles hover actions
- * @type ACTION
- */
-
-// This file is generated automatically. Add template steps to this group to generate content.
-
-/**
- * @name hover
- * @description Template step for hovering over an element
- * @icon MOUSE
- */
-When(
-  'the user hovers the cursor over the {string} element',
-  async function (this: CustomWorld, elementName: SelectorName) {
-    try {
-      const selector = await resolveLocator(this.page, elementName);
-      if (!selector) {
-        throw new Error(`Selector ${elementName} not found`);
-      }
-      await this.page.locator(selector).hover();
-    } catch (error) {
-      throw new Error(`Failed to hover over the ${elementName} element: ${error}`);
-    }
-  }
-);
+/**
+ * @name hover
+ * @description Template steps that handles hover actions
+ * @type ACTION
+ */
+
+// This file is generated automatically. Add template steps to this group to generate content.
+
+/**
+ * @name hover
+ * @description Template step for hovering over an element
+ * @icon MOUSE
+ */
+When(
+  'the user hovers the cursor over the {string} element',
+  async function (this: CustomWorld, elementName: SelectorName) {
+    try {
+      const selector = await resolveLocator(this.page, elementName);
+      if (!selector) {
+        throw new Error(`Selector ${elementName} not found`);
+      }
+      await this.page.locator(selector).hover();
+    } catch (error) {
+      throw new Error(`Failed to hover over the ${elementName} element: ${error}`);
+    }
+  }
+);

package/templates/default/automation/steps/actions/input.step.ts

@@ -13,20 +13,20 @@ import { When, Then, CustomWorld, expect, SelectorName, resolveLocator, getEnvir
  * @icon INPUT
  */
 When(
-  'the user fills in the {string} input field with value {string}',
-  async function (this: CustomWorld, elementName: SelectorName, value: string) {
-    const selector = await resolveLocator(this.page, elementName);
-    if (!selector) {
-      throw new Error(`Selector ${elementName} not found`);
+    'the user fills in the {string} input field with value {string}',
+    async function (this: CustomWorld, elementName: SelectorName, value: string) {
+        const selector = await resolveLocator(this.page, elementName);
+        if (!selector) {
+            throw new Error(`Selector ${elementName} not found`);
+        }
+        try {
+            await this.page.locator(selector).fill(value);
+        } catch (error) {
+            throw new Error(
+                `Failed to fill in the ${elementName} input field with value ${value}: ${error}`
+            );
+        }
     }
-    try {
-      await this.page.locator(selector).fill(value);
-    } catch (error) {
-      throw new Error(
-        `Failed to fill in the ${elementName} input field with value ${value}: ${error}`
-      );
-    }
-  }
 );
 
 /**
@@ -35,18 +35,18 @@ When(
  * @icon INPUT
  */
 When(
-  'the user clears the {string} field',
-  async function (this: CustomWorld, elementName: SelectorName) {
-    const selector = await resolveLocator(this.page, elementName);
-    if (!selector) {
-      throw new Error(`Selector ${elementName} not found`);
-    }
-    try {
-      await this.page.locator(selector).clear();
-    } catch (error) {
-      throw new Error(`Failed to clear the ${elementName} field: ${error}`);
+    'the user clears the {string} field',
+    async function (this: CustomWorld, elementName: SelectorName) {
+        const selector = await resolveLocator(this.page, elementName);
+        if (!selector) {
+            throw new Error(`Selector ${elementName} not found`);
+        }
+        try {
+            await this.page.locator(selector).clear();
+        } catch (error) {
+            throw new Error(`Failed to clear the ${elementName} field: ${error}`);
+        }
     }
-  }
 );
 
 /**
@@ -55,24 +55,24 @@ When(
  * @icon INPUT
  */
 When(
-  'the user selects the {string} option of the {string} dropdown',
-  async function (
-    this: CustomWorld,
-    optionName: string,
-    elementName: SelectorName
-  ) {
-    const selector = await resolveLocator(this.page, elementName);
-    if (!selector) {
-      throw new Error(`Selector ${elementName} not found`);
+    'the user selects the {string} option of the {string} dropdown',
+    async function (
+        this: CustomWorld,
+        optionName: string,
+        elementName: SelectorName
+    ) {
+        const selector = await resolveLocator(this.page, elementName);
+        if (!selector) {
+            throw new Error(`Selector ${elementName} not found`);
+        }
+        try {
+            await this.page.locator(selector).selectOption(optionName);
+        } catch (error) {
+            throw new Error(
+                `Failed to select the ${optionName} option of the ${elementName} dropdown: ${error}`
+            );
+        }
     }
-    try {
-      await this.page.locator(selector).selectOption(optionName);
-    } catch (error) {
-      throw new Error(
-        `Failed to select the ${optionName} option of the ${elementName} dropdown: ${error}`
-      );
-    }
-  }
 );
 
 /**
@@ -81,18 +81,18 @@ When(
  * @icon INPUT
  */
 When(
-  'the user checks the {string} checkbox',
-  async function (this: CustomWorld, elementName: SelectorName) {
-    const selector = await resolveLocator(this.page, elementName);
-    if (!selector) {
-      throw new Error(`Selector ${elementName} not found`);
-    }
-    try {
-      await this.page.locator(selector).check();
-    } catch (error) {
-      throw new Error(`Failed to check the ${elementName} checkbox: ${error}`);
+    'the user checks the {string} checkbox',
+    async function (this: CustomWorld, elementName: SelectorName) {
+        const selector = await resolveLocator(this.page, elementName);
+        if (!selector) {
+            throw new Error(`Selector ${elementName} not found`);
+        }
+        try {
+            await this.page.locator(selector).check();
+        } catch (error) {
+            throw new Error(`Failed to check the ${elementName} checkbox: ${error}`);
+        }
     }
-  }
 );
 
 /**
@@ -101,20 +101,20 @@ When(
  * @icon INPUT
  */
 When(
-  'the user unchecks the {string} checkbox',
-  async function (this: CustomWorld, elementName: SelectorName) {
-    const selector = await resolveLocator(this.page, elementName);
-    if (!selector) {
-      throw new Error(`Selector ${elementName} not found`);
+    'the user unchecks the {string} checkbox',
+    async function (this: CustomWorld, elementName: SelectorName) {
+        const selector = await resolveLocator(this.page, elementName);
+        if (!selector) {
+            throw new Error(`Selector ${elementName} not found`);
+        }
+        try {
+            await this.page.locator(selector).uncheck();
+        } catch (error) {
+            throw new Error(
+                `Failed to uncheck the ${elementName} checkbox: ${error}`
+            );
+        }
     }
-    try {
-      await this.page.locator(selector).uncheck();
-    } catch (error) {
-      throw new Error(
-        `Failed to uncheck the ${elementName} checkbox: ${error}`
-      );
-    }
-  }
 );
 
 /**
@@ -123,24 +123,24 @@ When(
  * @icon INPUT
  */
 When(
-  'the user fills in the {string} input with data from the stored variable {string}',
-  async function (
-    this: CustomWorld,
-    fieldName: SelectorName,
-    variableName: string
-  ) {
-    const value = this.getVar<string>(variableName);
-    if (!value) {
-      throw new Error(`Variable ${variableName} not found`);
-    }
-    const selector = await resolveLocator(this.page, fieldName);
-    if (!selector) {
-      throw new Error(`Selector ${fieldName} not found`);
-    }
-    try {
-      await this.page.locator(selector).fill(value);
-    } catch (error) {
-      throw new Error(`Failed to fill in the ${fieldName} input field with data from the stored variable ${variableName}: ${error}`);
+    'the user fills in the {string} input with data from the stored variable {string}',
+    async function (
+        this: CustomWorld,
+        fieldName: SelectorName,
+        variableName: string
+    ) {
+        const value = this.getVar<string>(variableName);
+        if (!value) {
+            throw new Error(`Variable ${variableName} not found`);
+        }
+        const selector = await resolveLocator(this.page, fieldName);
+        if (!selector) {
+            throw new Error(`Selector ${fieldName} not found`);
+        }
+        try {
+            await this.page.locator(selector).fill(value);
+        } catch (error) {
+            throw new Error(`Failed to fill in the ${fieldName} input field with data from the stored variable ${variableName}: ${error}`);
+        }
     }
-  }
 );