@emesoft_company/playwright-core 2.1.0

package/dist/ui/index.d.ts

@@ -0,0 +1,190 @@
+import { Page, Response, Locator } from '@playwright/test';
+import { Logger } from 'pino';
+
+interface BasePageOptions {
+    page: Page;
+    baseUrl?: string;
+    logger?: Logger;
+}
+interface GotoOptions {
+    /** Appended as query string, e.g. `{ tab: "open" }` -> `?tab=open`. */
+    query?: Record<string, string | number | boolean | undefined>;
+    /** Path to navigate to instead of the page's own `path` (e.g. a detail page by id). */
+    path?: string;
+    waitUntil?: "load" | "domcontentloaded" | "networkidle" | "commit";
+}
+/**
+ * Generic Page Object base. Subclasses declare `path` and their own selectors/actions —
+ * this base only provides framework-level plumbing (navigation, safe interactions, waits),
+ * never project-specific selectors or business logic.
+ */
+declare abstract class BasePage {
+    protected readonly page: Page;
+    protected readonly baseUrl?: string;
+    protected readonly logger?: Logger;
+    abstract readonly path: string;
+    constructor(options: BasePageOptions);
+    /** Absolute URL for this page, with optional path override and query string. */
+    url(options?: Pick<GotoOptions, "path" | "query">): string;
+    goto(options?: GotoOptions): Promise<Response | null>;
+    reload(): Promise<void>;
+    currentUrl(): string;
+    waitForUrl(url: string | RegExp, timeoutMs?: number): Promise<void>;
+    waitForLoadState(state?: "load" | "domcontentloaded" | "networkidle"): Promise<void>;
+    /**
+     * Waits for network activity to settle. Prefer waiting on a specific element when you can —
+     * `networkidle` is discouraged by Playwright for apps that poll or hold sockets open.
+     */
+    waitForNetworkIdle(timeoutMs?: number): Promise<void>;
+    pressKey(key: string): Promise<void>;
+    /**
+     * Screenshot as a buffer. Pair with `attachScreenshot()` from
+     * `@emesoft_company/playwright-core/reporting` to put it in the HTML/Allure report.
+     */
+    screenshot(fullPage?: boolean): Promise<Buffer>;
+    protected waitForVisible(locator: Locator, timeoutMs?: number): Promise<void>;
+    safeClick(locator: Locator, timeoutMs?: number): Promise<void>;
+    safeFill(locator: Locator, value: string): Promise<void>;
+    safeType(locator: Locator, value: string, delayMs?: number): Promise<void>;
+    safeSelect(locator: Locator, value: string | string[]): Promise<void>;
+    safeCheck(locator: Locator, checked?: boolean): Promise<void>;
+    uploadFile(locator: Locator, files: string | string[]): Promise<void>;
+    scrollIntoView(locator: Locator): Promise<void>;
+    getText(locator: Locator): Promise<string>;
+    getAllTexts(locator: Locator): Promise<string[]>;
+    /** Fills a form from a `{ selector: value }` map. Booleans check/uncheck. */
+    fillFields(fields: Record<string, string | number | boolean>): Promise<void>;
+}
+
+interface BaseComponentOptions {
+    page: Page;
+    /** Locator scoping this component to its root element (e.g. a modal, a nav bar). */
+    root: Locator;
+}
+/**
+ * Generic, reusable wrapper for a UI component scoped to a root locator.
+ * Intentionally contains no selectors or business logic — projects extend
+ * this for their own components (e.g. `class LoginFormComponent extends BaseComponent`).
+ *
+ * Every lookup here is scoped to `root`, which is what keeps two instances of the same
+ * component on one page (two rows, two modals) from matching each other's elements.
+ */
+declare class BaseComponent {
+    protected readonly page: Page;
+    readonly root: Locator;
+    constructor(options: BaseComponentOptions);
+    byTestId(testId: string): Locator;
+    byRole(...args: Parameters<Locator["getByRole"]>): Locator;
+    byText(...args: Parameters<Locator["getByText"]>): Locator;
+    byLabel(...args: Parameters<Locator["getByLabel"]>): Locator;
+    locator(selector: string): Locator;
+    isVisible(): Promise<boolean>;
+    exists(): Promise<boolean>;
+    text(): Promise<string>;
+    waitForStable(timeoutMs?: number): Promise<void>;
+    waitForHidden(timeoutMs?: number): Promise<void>;
+    safeClick(locator: Locator, timeoutMs?: number): Promise<void>;
+    safeFill(locator: Locator, value: string): Promise<void>;
+    safeSelect(locator: Locator, value: string | string[]): Promise<void>;
+    safeCheck(locator: Locator, checked?: boolean): Promise<void>;
+    scrollIntoView(locator?: Locator): Promise<void>;
+    getText(locator: Locator): Promise<string>;
+    getAllTexts(locator: Locator): Promise<string[]>;
+    /** Fills fields *within this component*, so selectors don't collide with the rest of the page. */
+    fillFields(fields: Record<string, string | number | boolean>): Promise<void>;
+}
+
+interface TableComponentOptions extends BaseComponentOptions {
+    /** Selector for header cells, relative to the table root. Default: `"thead th"`. */
+    headerSelector?: string;
+    /** Selector for data rows, relative to the table root. Default: `"tbody tr"`. */
+    rowSelector?: string;
+    /** Selector for cells, relative to a row. Default: `"td"`. */
+    cellSelector?: string;
+}
+/**
+ * Generic data-table/grid wrapper: row counts, cell lookup by column *name* rather than
+ * brittle index, and whole-table extraction for assertions.
+ *
+ * Defaults target a standard `<table><thead><th>/<tbody><tr><td>` layout. For div-based grids
+ * pass the three selectors, e.g.
+ * `{ headerSelector: '[role=columnheader]', rowSelector: '[role=row]', cellSelector: '[role=gridcell]' }`.
+ *
+ * Contains no project selectors itself — a project subclasses it (or just constructs it with
+ * its own root locator) per grid.
+ */
+declare class TableComponent extends BaseComponent {
+    private readonly headerSelector;
+    private readonly rowSelector;
+    private readonly cellSelector;
+    constructor(options: TableComponentOptions);
+    /** All data rows. A live locator — safe to use with auto-retrying assertions. */
+    get rows(): Locator;
+    get headerCells(): Locator;
+    row(index: number): Locator;
+    cells(rowIndex: number): Locator;
+    rowCount(): Promise<number>;
+    isEmpty(): Promise<boolean>;
+    /** Trimmed header labels, in order. */
+    headers(): Promise<string[]>;
+    /**
+     * Zero-based index of a column by its header label (exact match after trimming, falling back
+     * to a case-insensitive contains match). Throws listing the available headers when not found —
+     * a renamed column is otherwise a confusing "cell is empty" failure.
+     */
+    columnIndex(header: string): Promise<number>;
+    /** A cell by row index and either a column index or a header label. */
+    cell(rowIndex: number, column: string | number): Promise<Locator>;
+    cellText(rowIndex: number, column: string | number): Promise<string>;
+    /** Every cell value of one row, in column order. */
+    rowValues(rowIndex: number): Promise<string[]>;
+    /**
+     * The whole table as `{ header: cellText }` objects — the most convenient shape for
+     * assertions (`expect(await table.records()).toContainEqual({ Status: "Approved", ... })`).
+     */
+    records(): Promise<Record<string, string>[]>;
+    /** Rows containing `text` anywhere. Still a locator, so assertions on it auto-retry. */
+    rowsContaining(text: string | RegExp): Locator;
+    /**
+     * Rows whose cell in a given column matches `value`. Returns a locator (auto-retrying);
+     * only the header lookup is awaited up front.
+     */
+    rowsByColumn(column: string | number, value: string | RegExp): Promise<Locator>;
+    /** Waits until the table has at least `min` rows (default 1) — e.g. after a search or load. */
+    waitForRows(min?: number, timeoutMs?: number): Promise<void>;
+}
+
+/**
+ * Locator-level helpers shared by `BasePage` and `BaseComponent` (and usable standalone on any
+ * locator). Each one waits for the element to be actionable first, so callers don't sprinkle
+ * `waitFor` everywhere — Playwright auto-waits for most of this already, but being explicit
+ * gives far better failure messages than a bare `click()` timing out mid-action.
+ */
+declare function waitForVisible(locator: Locator, timeoutMs?: number): Promise<void>;
+declare function safeClick(locator: Locator, timeoutMs?: number): Promise<void>;
+declare function safeDoubleClick(locator: Locator, timeoutMs?: number): Promise<void>;
+declare function safeFill(locator: Locator, value: string, timeoutMs?: number): Promise<void>;
+/** Clears then types character by character — for inputs with keystroke-driven behavior (autocomplete, masks). */
+declare function safeType(locator: Locator, value: string, delayMs?: number): Promise<void>;
+declare function safeSelect(locator: Locator, value: string | string[]): Promise<void>;
+declare function safeCheck(locator: Locator, checked?: boolean): Promise<void>;
+declare function uploadFile(locator: Locator, files: string | string[]): Promise<void>;
+declare function scrollIntoView(locator: Locator): Promise<void>;
+/** Trimmed visible text of an element (`""` when it has none). */
+declare function getText(locator: Locator): Promise<string>;
+/** Trimmed text of every element the locator matches. */
+declare function getAllTexts(locator: Locator): Promise<string[]>;
+declare function getInputValue(locator: Locator): Promise<string>;
+/** True when the element exists in the DOM at all (regardless of visibility). */
+declare function exists(locator: Locator): Promise<boolean>;
+interface FillFieldsOptions {
+    /** Resolve each key into a locator. Defaults to `page.locator(key)`. */
+    resolve?: (selector: string) => Locator;
+}
+/**
+ * Fills a whole form from a `{ selector: value }` map — the single most repeated block in UI
+ * tests. Booleans check/uncheck, everything else is filled as text.
+ */
+declare function fillFields(page: Page, fields: Record<string, string | number | boolean>, options?: FillFieldsOptions): Promise<void>;
+
+export { BaseComponent, type BaseComponentOptions, BasePage, type BasePageOptions, type FillFieldsOptions, type GotoOptions, TableComponent, type TableComponentOptions, exists, fillFields, getAllTexts, getInputValue, getText, safeCheck, safeClick, safeDoubleClick, safeFill, safeSelect, safeType, scrollIntoView, uploadFile, waitForVisible };

package/dist/ui/index.js

@@ -0,0 +1,348 @@
+// src/ui/actions.ts
+async function waitForVisible(locator, timeoutMs) {
+  await locator.waitFor({ state: "visible", timeout: timeoutMs });
+}
+async function safeClick(locator, timeoutMs) {
+  await waitForVisible(locator, timeoutMs);
+  await locator.click();
+}
+async function safeDoubleClick(locator, timeoutMs) {
+  await waitForVisible(locator, timeoutMs);
+  await locator.dblclick();
+}
+async function safeFill(locator, value, timeoutMs) {
+  await waitForVisible(locator, timeoutMs);
+  await locator.fill(value);
+}
+async function safeType(locator, value, delayMs = 0) {
+  await waitForVisible(locator);
+  await locator.fill("");
+  await locator.pressSequentially(value, { delay: delayMs });
+}
+async function safeSelect(locator, value) {
+  await waitForVisible(locator);
+  await locator.selectOption(value);
+}
+async function safeCheck(locator, checked = true) {
+  await waitForVisible(locator);
+  if (checked) await locator.check();
+  else await locator.uncheck();
+}
+async function uploadFile(locator, files) {
+  await locator.setInputFiles(files);
+}
+async function scrollIntoView(locator) {
+  await locator.scrollIntoViewIfNeeded();
+}
+async function getText(locator) {
+  return (await locator.textContent())?.trim() ?? "";
+}
+async function getAllTexts(locator) {
+  const texts = await locator.allTextContents();
+  return texts.map((text) => text.trim());
+}
+async function getInputValue(locator) {
+  return locator.inputValue();
+}
+async function exists(locator) {
+  return await locator.count() > 0;
+}
+async function fillFields(page, fields, options = {}) {
+  const resolve = options.resolve ?? ((selector) => page.locator(selector));
+  for (const [selector, value] of Object.entries(fields)) {
+    const locator = resolve(selector);
+    if (typeof value === "boolean") {
+      await safeCheck(locator, value);
+    } else {
+      await safeFill(locator, String(value));
+    }
+  }
+}
+
+// src/ui/components/base-page.ts
+var BasePage = class {
+  page;
+  baseUrl;
+  logger;
+  constructor(options) {
+    this.page = options.page;
+    this.baseUrl = options.baseUrl;
+    this.logger = options.logger;
+  }
+  /** Absolute URL for this page, with optional path override and query string. */
+  url(options = {}) {
+    const path = options.path ?? this.path;
+    const url = this.baseUrl ? new URL(path, this.baseUrl) : new URL(path, "http://localhost");
+    if (options.query) {
+      for (const [key, value] of Object.entries(options.query)) {
+        if (value !== void 0) url.searchParams.set(key, String(value));
+      }
+    }
+    return this.baseUrl ? url.toString() : `${url.pathname}${url.search}`;
+  }
+  async goto(options = {}) {
+    const url = this.url(options);
+    this.logger?.debug({ url }, "navigating");
+    return this.page.goto(url, options.waitUntil ? { waitUntil: options.waitUntil } : void 0);
+  }
+  async reload() {
+    await this.page.reload();
+  }
+  currentUrl() {
+    return this.page.url();
+  }
+  async waitForUrl(url, timeoutMs) {
+    await this.page.waitForURL(url, timeoutMs ? { timeout: timeoutMs } : void 0);
+  }
+  async waitForLoadState(state = "load") {
+    await this.page.waitForLoadState(state);
+  }
+  /**
+   * Waits for network activity to settle. Prefer waiting on a specific element when you can —
+   * `networkidle` is discouraged by Playwright for apps that poll or hold sockets open.
+   */
+  async waitForNetworkIdle(timeoutMs) {
+    await this.page.waitForLoadState("networkidle", timeoutMs ? { timeout: timeoutMs } : void 0);
+  }
+  async pressKey(key) {
+    await this.page.keyboard.press(key);
+  }
+  /**
+   * Screenshot as a buffer. Pair with `attachScreenshot()` from
+   * `@emesoft_company/playwright-core/reporting` to put it in the HTML/Allure report.
+   */
+  async screenshot(fullPage = false) {
+    return this.page.screenshot({ fullPage, caret: "hide" });
+  }
+  // --- locator helpers, delegated to the shared actions so components behave identically ---
+  waitForVisible(locator, timeoutMs) {
+    return waitForVisible(locator, timeoutMs);
+  }
+  async safeClick(locator, timeoutMs) {
+    await safeClick(locator, timeoutMs);
+  }
+  async safeFill(locator, value) {
+    await safeFill(locator, value);
+  }
+  async safeType(locator, value, delayMs) {
+    await safeType(locator, value, delayMs);
+  }
+  async safeSelect(locator, value) {
+    await safeSelect(locator, value);
+  }
+  async safeCheck(locator, checked = true) {
+    await safeCheck(locator, checked);
+  }
+  async uploadFile(locator, files) {
+    await uploadFile(locator, files);
+  }
+  async scrollIntoView(locator) {
+    await scrollIntoView(locator);
+  }
+  async getText(locator) {
+    return getText(locator);
+  }
+  async getAllTexts(locator) {
+    return getAllTexts(locator);
+  }
+  /** Fills a form from a `{ selector: value }` map. Booleans check/uncheck. */
+  async fillFields(fields) {
+    await fillFields(this.page, fields);
+  }
+};
+
+// src/ui/components/base-component.ts
+var BaseComponent = class {
+  page;
+  root;
+  constructor(options) {
+    this.page = options.page;
+    this.root = options.root;
+  }
+  // --- scoped lookups ---
+  byTestId(testId) {
+    return this.root.getByTestId(testId);
+  }
+  byRole(...args) {
+    return this.root.getByRole(...args);
+  }
+  byText(...args) {
+    return this.root.getByText(...args);
+  }
+  byLabel(...args) {
+    return this.root.getByLabel(...args);
+  }
+  locator(selector) {
+    return this.root.locator(selector);
+  }
+  // --- state ---
+  async isVisible() {
+    return this.root.isVisible();
+  }
+  async exists() {
+    return exists(this.root);
+  }
+  async text() {
+    return getText(this.root);
+  }
+  async waitForStable(timeoutMs) {
+    await waitForVisible(this.root, timeoutMs);
+  }
+  async waitForHidden(timeoutMs) {
+    await this.root.waitFor({ state: "hidden", timeout: timeoutMs });
+  }
+  // --- actions, same implementations BasePage uses ---
+  async safeClick(locator, timeoutMs) {
+    await safeClick(locator, timeoutMs);
+  }
+  async safeFill(locator, value) {
+    await safeFill(locator, value);
+  }
+  async safeSelect(locator, value) {
+    await safeSelect(locator, value);
+  }
+  async safeCheck(locator, checked = true) {
+    await safeCheck(locator, checked);
+  }
+  async scrollIntoView(locator = this.root) {
+    await scrollIntoView(locator);
+  }
+  async getText(locator) {
+    return getText(locator);
+  }
+  async getAllTexts(locator) {
+    return getAllTexts(locator);
+  }
+  /** Fills fields *within this component*, so selectors don't collide with the rest of the page. */
+  async fillFields(fields) {
+    await fillFields(this.page, fields, { resolve: (selector) => this.root.locator(selector) });
+  }
+};
+
+// src/errors/app-error.ts
+var AppError = class extends Error {
+  code;
+  context;
+  constructor(message, options) {
+    super(message, { cause: options.cause });
+    this.name = new.target.name;
+    this.code = options.code;
+    this.context = options.context;
+    Object.setPrototypeOf(this, new.target.prototype);
+  }
+};
+
+// src/ui/components/table.component.ts
+var TableComponent = class extends BaseComponent {
+  headerSelector;
+  rowSelector;
+  cellSelector;
+  constructor(options) {
+    super(options);
+    this.headerSelector = options.headerSelector ?? "thead th";
+    this.rowSelector = options.rowSelector ?? "tbody tr";
+    this.cellSelector = options.cellSelector ?? "td";
+  }
+  /** All data rows. A live locator — safe to use with auto-retrying assertions. */
+  get rows() {
+    return this.root.locator(this.rowSelector);
+  }
+  get headerCells() {
+    return this.root.locator(this.headerSelector);
+  }
+  row(index) {
+    return this.rows.nth(index);
+  }
+  cells(rowIndex) {
+    return this.row(rowIndex).locator(this.cellSelector);
+  }
+  async rowCount() {
+    return this.rows.count();
+  }
+  async isEmpty() {
+    return await this.rowCount() === 0;
+  }
+  /** Trimmed header labels, in order. */
+  async headers() {
+    return getAllTexts(this.headerCells);
+  }
+  /**
+   * Zero-based index of a column by its header label (exact match after trimming, falling back
+   * to a case-insensitive contains match). Throws listing the available headers when not found —
+   * a renamed column is otherwise a confusing "cell is empty" failure.
+   */
+  async columnIndex(header) {
+    const headers = await this.headers();
+    const exact = headers.indexOf(header.trim());
+    if (exact !== -1) return exact;
+    const needle = header.trim().toLowerCase();
+    const loose = headers.findIndex((candidate) => candidate.toLowerCase().includes(needle));
+    if (loose !== -1) return loose;
+    throw new AppError(`Column "${header}" not found in table`, {
+      code: "TABLE_COLUMN_NOT_FOUND",
+      context: { requested: header, available: headers }
+    });
+  }
+  /** A cell by row index and either a column index or a header label. */
+  async cell(rowIndex, column) {
+    const index = typeof column === "number" ? column : await this.columnIndex(column);
+    return this.cells(rowIndex).nth(index);
+  }
+  async cellText(rowIndex, column) {
+    return getText(await this.cell(rowIndex, column));
+  }
+  /** Every cell value of one row, in column order. */
+  async rowValues(rowIndex) {
+    return getAllTexts(this.cells(rowIndex));
+  }
+  /**
+   * The whole table as `{ header: cellText }` objects — the most convenient shape for
+   * assertions (`expect(await table.records()).toContainEqual({ Status: "Approved", ... })`).
+   */
+  async records() {
+    const headers = await this.headers();
+    const count = await this.rowCount();
+    const records = [];
+    for (let rowIndex = 0; rowIndex < count; rowIndex++) {
+      const values = await this.rowValues(rowIndex);
+      const record = {};
+      values.forEach((value, columnIndex) => {
+        record[headers[columnIndex] ?? `column${columnIndex}`] = value;
+      });
+      records.push(record);
+    }
+    return records;
+  }
+  /** Rows containing `text` anywhere. Still a locator, so assertions on it auto-retry. */
+  rowsContaining(text) {
+    return this.rows.filter({ hasText: text });
+  }
+  /**
+   * Rows whose cell in a given column matches `value`. Returns a locator (auto-retrying);
+   * only the header lookup is awaited up front.
+   */
+  async rowsByColumn(column, value) {
+    const index = typeof column === "number" ? column : await this.columnIndex(column);
+    return this.rows.filter({
+      has: this.page.locator(`${this.cellSelector}:nth-child(${index + 1})`).filter({ hasText: value })
+    });
+  }
+  /** Waits until the table has at least `min` rows (default 1) — e.g. after a search or load. */
+  async waitForRows(min = 1, timeoutMs = 15e3) {
+    const deadline = Date.now() + timeoutMs;
+    for (; ; ) {
+      if (await this.rowCount() >= min) return;
+      if (Date.now() >= deadline) {
+        throw new AppError(`Table did not reach ${min} row(s) within ${timeoutMs}ms`, {
+          code: "TABLE_ROWS_TIMEOUT",
+          context: { min, timeoutMs, actual: await this.rowCount() }
+        });
+      }
+      await this.page.waitForTimeout(200);
+    }
+  }
+};
+
+export { BaseComponent, BasePage, TableComponent, exists, fillFields, getAllTexts, getInputValue, getText, safeCheck, safeClick, safeDoubleClick, safeFill, safeSelect, safeType, scrollIntoView, uploadFile, waitForVisible };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/ui/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/ui/actions.ts","../../src/ui/components/base-page.ts","../../src/ui/components/base-component.ts","../../src/errors/app-error.ts","../../src/ui/components/table.component.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["import type { Locator, Page } from \"@playwright/test\";\n\n/**\n * Locator-level helpers shared by `BasePage` and `BaseComponent` (and usable standalone on any\n * locator). Each one waits for the element to be actionable first, so callers don't sprinkle\n * `waitFor` everywhere — Playwright auto-waits for most of this already, but being explicit\n * gives far better failure messages than a bare `click()` timing out mid-action.\n */\n\nexport async function waitForVisible(locator: Locator, timeoutMs?: number): Promise<void> {\n  await locator.waitFor({ state: \"visible\", timeout: timeoutMs });\n}\n\nexport async function safeClick(locator: Locator, timeoutMs?: number): Promise<void> {\n  await waitForVisible(locator, timeoutMs);\n  await locator.click();\n}\n\nexport async function safeDoubleClick(locator: Locator, timeoutMs?: number): Promise<void> {\n  await waitForVisible(locator, timeoutMs);\n  await locator.dblclick();\n}\n\nexport async function safeFill(locator: Locator, value: string, timeoutMs?: number): Promise<void> {\n  await waitForVisible(locator, timeoutMs);\n  await locator.fill(value);\n}\n\n/** Clears then types character by character — for inputs with keystroke-driven behavior (autocomplete, masks). */\nexport async function safeType(locator: Locator, value: string, delayMs = 0): Promise<void> {\n  await waitForVisible(locator);\n  await locator.fill(\"\");\n  await locator.pressSequentially(value, { delay: delayMs });\n}\n\nexport async function safeSelect(locator: Locator, value: string | string[]): Promise<void> {\n  await waitForVisible(locator);\n  await locator.selectOption(value);\n}\n\nexport async function safeCheck(locator: Locator, checked = true): Promise<void> {\n  await waitForVisible(locator);\n  if (checked) await locator.check();\n  else await locator.uncheck();\n}\n\nexport async function uploadFile(locator: Locator, files: string | string[]): Promise<void> {\n  await locator.setInputFiles(files);\n}\n\nexport async function scrollIntoView(locator: Locator): Promise<void> {\n  await locator.scrollIntoViewIfNeeded();\n}\n\n/** Trimmed visible text of an element (`\"\"` when it has none). */\nexport async function getText(locator: Locator): Promise<string> {\n  return (await locator.textContent())?.trim() ?? \"\";\n}\n\n/** Trimmed text of every element the locator matches. */\nexport async function getAllTexts(locator: Locator): Promise<string[]> {\n  const texts = await locator.allTextContents();\n  return texts.map((text) => text.trim());\n}\n\nexport async function getInputValue(locator: Locator): Promise<string> {\n  return locator.inputValue();\n}\n\n/** True when the element exists in the DOM at all (regardless of visibility). */\nexport async function exists(locator: Locator): Promise<boolean> {\n  return (await locator.count()) > 0;\n}\n\nexport interface FillFieldsOptions {\n  /** Resolve each key into a locator. Defaults to `page.locator(key)`. */\n  resolve?: (selector: string) => Locator;\n}\n\n/**\n * Fills a whole form from a `{ selector: value }` map — the single most repeated block in UI\n * tests. Booleans check/uncheck, everything else is filled as text.\n */\nexport async function fillFields(\n  page: Page,\n  fields: Record<string, string | number | boolean>,\n  options: FillFieldsOptions = {},\n): Promise<void> {\n  const resolve = options.resolve ?? ((selector: string) => page.locator(selector));\n  for (const [selector, value] of Object.entries(fields)) {\n    const locator = resolve(selector);\n    if (typeof value === \"boolean\") {\n      await safeCheck(locator, value);\n    } else {\n      await safeFill(locator, String(value));\n    }\n  }\n}\n","import type { Locator, Page, Response } from \"@playwright/test\";\nimport type { Logger } from \"../../logging/logger.js\";\nimport {\n  fillFields,\n  getAllTexts,\n  getText,\n  safeCheck,\n  safeClick,\n  safeFill,\n  safeSelect,\n  safeType,\n  scrollIntoView,\n  uploadFile,\n  waitForVisible,\n} from \"../actions.js\";\n\nexport interface BasePageOptions {\n  page: Page;\n  baseUrl?: string;\n  logger?: Logger;\n}\n\nexport interface GotoOptions {\n  /** Appended as query string, e.g. `{ tab: \"open\" }` -> `?tab=open`. */\n  query?: Record<string, string | number | boolean | undefined>;\n  /** Path to navigate to instead of the page's own `path` (e.g. a detail page by id). */\n  path?: string;\n  waitUntil?: \"load\" | \"domcontentloaded\" | \"networkidle\" | \"commit\";\n}\n\n/**\n * Generic Page Object base. Subclasses declare `path` and their own selectors/actions —\n * this base only provides framework-level plumbing (navigation, safe interactions, waits),\n * never project-specific selectors or business logic.\n */\nexport abstract class BasePage {\n  protected readonly page: Page;\n  protected readonly baseUrl?: string;\n  protected readonly logger?: Logger;\n\n  abstract readonly path: string;\n\n  constructor(options: BasePageOptions) {\n    this.page = options.page;\n    this.baseUrl = options.baseUrl;\n    this.logger = options.logger;\n  }\n\n  /** Absolute URL for this page, with optional path override and query string. */\n  url(options: Pick<GotoOptions, \"path\" | \"query\"> = {}): string {\n    const path = options.path ?? this.path;\n    const url = this.baseUrl ? new URL(path, this.baseUrl) : new URL(path, \"http://localhost\");\n    if (options.query) {\n      for (const [key, value] of Object.entries(options.query)) {\n        if (value !== undefined) url.searchParams.set(key, String(value));\n      }\n    }\n    return this.baseUrl ? url.toString() : `${url.pathname}${url.search}`;\n  }\n\n  async goto(options: GotoOptions = {}): Promise<Response | null> {\n    const url = this.url(options);\n    this.logger?.debug({ url }, \"navigating\");\n    return this.page.goto(url, options.waitUntil ? { waitUntil: options.waitUntil } : undefined);\n  }\n\n  async reload(): Promise<void> {\n    await this.page.reload();\n  }\n\n  currentUrl(): string {\n    return this.page.url();\n  }\n\n  async waitForUrl(url: string | RegExp, timeoutMs?: number): Promise<void> {\n    await this.page.waitForURL(url, timeoutMs ? { timeout: timeoutMs } : undefined);\n  }\n\n  async waitForLoadState(state: \"load\" | \"domcontentloaded\" | \"networkidle\" = \"load\"): Promise<void> {\n    await this.page.waitForLoadState(state);\n  }\n\n  /**\n   * Waits for network activity to settle. Prefer waiting on a specific element when you can —\n   * `networkidle` is discouraged by Playwright for apps that poll or hold sockets open.\n   */\n  async waitForNetworkIdle(timeoutMs?: number): Promise<void> {\n    await this.page.waitForLoadState(\"networkidle\", timeoutMs ? { timeout: timeoutMs } : undefined);\n  }\n\n  async pressKey(key: string): Promise<void> {\n    await this.page.keyboard.press(key);\n  }\n\n  /**\n   * Screenshot as a buffer. Pair with `attachScreenshot()` from\n   * `@emesoft_company/playwright-core/reporting` to put it in the HTML/Allure report.\n   */\n  async screenshot(fullPage = false): Promise<Buffer> {\n    return this.page.screenshot({ fullPage, caret: \"hide\" });\n  }\n\n  // --- locator helpers, delegated to the shared actions so components behave identically ---\n\n  protected waitForVisible(locator: Locator, timeoutMs?: number): Promise<void> {\n    return waitForVisible(locator, timeoutMs);\n  }\n\n  async safeClick(locator: Locator, timeoutMs?: number): Promise<void> {\n    await safeClick(locator, timeoutMs);\n  }\n\n  async safeFill(locator: Locator, value: string): Promise<void> {\n    await safeFill(locator, value);\n  }\n\n  async safeType(locator: Locator, value: string, delayMs?: number): Promise<void> {\n    await safeType(locator, value, delayMs);\n  }\n\n  async safeSelect(locator: Locator, value: string | string[]): Promise<void> {\n    await safeSelect(locator, value);\n  }\n\n  async safeCheck(locator: Locator, checked = true): Promise<void> {\n    await safeCheck(locator, checked);\n  }\n\n  async uploadFile(locator: Locator, files: string | string[]): Promise<void> {\n    await uploadFile(locator, files);\n  }\n\n  async scrollIntoView(locator: Locator): Promise<void> {\n    await scrollIntoView(locator);\n  }\n\n  async getText(locator: Locator): Promise<string> {\n    return getText(locator);\n  }\n\n  async getAllTexts(locator: Locator): Promise<string[]> {\n    return getAllTexts(locator);\n  }\n\n  /** Fills a form from a `{ selector: value }` map. Booleans check/uncheck. */\n  async fillFields(fields: Record<string, string | number | boolean>): Promise<void> {\n    await fillFields(this.page, fields);\n  }\n}\n","import type { Locator, Page } from \"@playwright/test\";\nimport {\n  exists,\n  fillFields,\n  getAllTexts,\n  getText,\n  safeCheck,\n  safeClick,\n  safeFill,\n  safeSelect,\n  scrollIntoView,\n  waitForVisible,\n} from \"../actions.js\";\n\nexport interface BaseComponentOptions {\n  page: Page;\n  /** Locator scoping this component to its root element (e.g. a modal, a nav bar). */\n  root: Locator;\n}\n\n/**\n * Generic, reusable wrapper for a UI component scoped to a root locator.\n * Intentionally contains no selectors or business logic — projects extend\n * this for their own components (e.g. `class LoginFormComponent extends BaseComponent`).\n *\n * Every lookup here is scoped to `root`, which is what keeps two instances of the same\n * component on one page (two rows, two modals) from matching each other's elements.\n */\nexport class BaseComponent {\n  protected readonly page: Page;\n  readonly root: Locator;\n\n  constructor(options: BaseComponentOptions) {\n    this.page = options.page;\n    this.root = options.root;\n  }\n\n  // --- scoped lookups ---\n\n  byTestId(testId: string): Locator {\n    return this.root.getByTestId(testId);\n  }\n\n  byRole(...args: Parameters<Locator[\"getByRole\"]>): Locator {\n    return this.root.getByRole(...args);\n  }\n\n  byText(...args: Parameters<Locator[\"getByText\"]>): Locator {\n    return this.root.getByText(...args);\n  }\n\n  byLabel(...args: Parameters<Locator[\"getByLabel\"]>): Locator {\n    return this.root.getByLabel(...args);\n  }\n\n  locator(selector: string): Locator {\n    return this.root.locator(selector);\n  }\n\n  // --- state ---\n\n  async isVisible(): Promise<boolean> {\n    return this.root.isVisible();\n  }\n\n  async exists(): Promise<boolean> {\n    return exists(this.root);\n  }\n\n  async text(): Promise<string> {\n    return getText(this.root);\n  }\n\n  async waitForStable(timeoutMs?: number): Promise<void> {\n    await waitForVisible(this.root, timeoutMs);\n  }\n\n  async waitForHidden(timeoutMs?: number): Promise<void> {\n    await this.root.waitFor({ state: \"hidden\", timeout: timeoutMs });\n  }\n\n  // --- actions, same implementations BasePage uses ---\n\n  async safeClick(locator: Locator, timeoutMs?: number): Promise<void> {\n    await safeClick(locator, timeoutMs);\n  }\n\n  async safeFill(locator: Locator, value: string): Promise<void> {\n    await safeFill(locator, value);\n  }\n\n  async safeSelect(locator: Locator, value: string | string[]): Promise<void> {\n    await safeSelect(locator, value);\n  }\n\n  async safeCheck(locator: Locator, checked = true): Promise<void> {\n    await safeCheck(locator, checked);\n  }\n\n  async scrollIntoView(locator: Locator = this.root): Promise<void> {\n    await scrollIntoView(locator);\n  }\n\n  async getText(locator: Locator): Promise<string> {\n    return getText(locator);\n  }\n\n  async getAllTexts(locator: Locator): Promise<string[]> {\n    return getAllTexts(locator);\n  }\n\n  /** Fills fields *within this component*, so selectors don't collide with the rest of the page. */\n  async fillFields(fields: Record<string, string | number | boolean>): Promise<void> {\n    await fillFields(this.page, fields, { resolve: (selector) => this.root.locator(selector) });\n  }\n}\n","export interface AppErrorOptions {\n  code: string;\n  cause?: unknown;\n  context?: Record<string, unknown>;\n}\n\n/**\n * Base error class for the framework. Every error thrown by core carries a\n * machine-readable `code` and optional `context`, so callers can branch on\n * `error.code` instead of parsing messages.\n */\nexport class AppError extends Error {\n  readonly code: string;\n  readonly context?: Record<string, unknown>;\n\n  constructor(message: string, options: AppErrorOptions) {\n    super(message, { cause: options.cause });\n    this.name = new.target.name;\n    this.code = options.code;\n    this.context = options.context;\n    Object.setPrototypeOf(this, new.target.prototype);\n  }\n}\n\nexport class ConfigValidationError extends AppError {\n  constructor(message: string, issues: unknown, context?: Record<string, unknown>) {\n    super(message, { code: \"CONFIG_VALIDATION_ERROR\", context: { issues, ...context } });\n  }\n}\n\nexport class ApiError extends AppError {\n  readonly status?: number;\n  readonly method?: string;\n  readonly url?: string;\n\n  constructor(\n    message: string,\n    options: AppErrorOptions & { status?: number; method?: string; url?: string },\n  ) {\n    super(message, options);\n    this.status = options.status;\n    this.method = options.method;\n    this.url = options.url;\n  }\n}\n\nexport class AuthError extends AppError {\n  constructor(message: string, options: Omit<AppErrorOptions, \"code\"> = {}) {\n    super(message, { code: \"AUTH_ERROR\", ...options });\n  }\n}\n\nexport class ConfigMissingError extends AppError {\n  constructor(name: string) {\n    super(`Required environment variable \"${name}\" is not set`, {\n      code: \"ENV_VAR_MISSING\",\n      context: { name },\n    });\n  }\n}\n","import type { Locator } from \"@playwright/test\";\nimport { AppError } from \"../../errors/app-error.js\";\nimport { getAllTexts, getText } from \"../actions.js\";\nimport { BaseComponent, type BaseComponentOptions } from \"./base-component.js\";\n\nexport interface TableComponentOptions extends BaseComponentOptions {\n  /** Selector for header cells, relative to the table root. Default: `\"thead th\"`. */\n  headerSelector?: string;\n  /** Selector for data rows, relative to the table root. Default: `\"tbody tr\"`. */\n  rowSelector?: string;\n  /** Selector for cells, relative to a row. Default: `\"td\"`. */\n  cellSelector?: string;\n}\n\n/**\n * Generic data-table/grid wrapper: row counts, cell lookup by column *name* rather than\n * brittle index, and whole-table extraction for assertions.\n *\n * Defaults target a standard `<table><thead><th>/<tbody><tr><td>` layout. For div-based grids\n * pass the three selectors, e.g.\n * `{ headerSelector: '[role=columnheader]', rowSelector: '[role=row]', cellSelector: '[role=gridcell]' }`.\n *\n * Contains no project selectors itself — a project subclasses it (or just constructs it with\n * its own root locator) per grid.\n */\nexport class TableComponent extends BaseComponent {\n  private readonly headerSelector: string;\n  private readonly rowSelector: string;\n  private readonly cellSelector: string;\n\n  constructor(options: TableComponentOptions) {\n    super(options);\n    this.headerSelector = options.headerSelector ?? \"thead th\";\n    this.rowSelector = options.rowSelector ?? \"tbody tr\";\n    this.cellSelector = options.cellSelector ?? \"td\";\n  }\n\n  /** All data rows. A live locator — safe to use with auto-retrying assertions. */\n  get rows(): Locator {\n    return this.root.locator(this.rowSelector);\n  }\n\n  get headerCells(): Locator {\n    return this.root.locator(this.headerSelector);\n  }\n\n  row(index: number): Locator {\n    return this.rows.nth(index);\n  }\n\n  cells(rowIndex: number): Locator {\n    return this.row(rowIndex).locator(this.cellSelector);\n  }\n\n  async rowCount(): Promise<number> {\n    return this.rows.count();\n  }\n\n  async isEmpty(): Promise<boolean> {\n    return (await this.rowCount()) === 0;\n  }\n\n  /** Trimmed header labels, in order. */\n  async headers(): Promise<string[]> {\n    return getAllTexts(this.headerCells);\n  }\n\n  /**\n   * Zero-based index of a column by its header label (exact match after trimming, falling back\n   * to a case-insensitive contains match). Throws listing the available headers when not found —\n   * a renamed column is otherwise a confusing \"cell is empty\" failure.\n   */\n  async columnIndex(header: string): Promise<number> {\n    const headers = await this.headers();\n    const exact = headers.indexOf(header.trim());\n    if (exact !== -1) return exact;\n\n    const needle = header.trim().toLowerCase();\n    const loose = headers.findIndex((candidate) => candidate.toLowerCase().includes(needle));\n    if (loose !== -1) return loose;\n\n    throw new AppError(`Column \"${header}\" not found in table`, {\n      code: \"TABLE_COLUMN_NOT_FOUND\",\n      context: { requested: header, available: headers },\n    });\n  }\n\n  /** A cell by row index and either a column index or a header label. */\n  async cell(rowIndex: number, column: string | number): Promise<Locator> {\n    const index = typeof column === \"number\" ? column : await this.columnIndex(column);\n    return this.cells(rowIndex).nth(index);\n  }\n\n  async cellText(rowIndex: number, column: string | number): Promise<string> {\n    return getText(await this.cell(rowIndex, column));\n  }\n\n  /** Every cell value of one row, in column order. */\n  async rowValues(rowIndex: number): Promise<string[]> {\n    return getAllTexts(this.cells(rowIndex));\n  }\n\n  /**\n   * The whole table as `{ header: cellText }` objects — the most convenient shape for\n   * assertions (`expect(await table.records()).toContainEqual({ Status: \"Approved\", ... })`).\n   */\n  async records(): Promise<Record<string, string>[]> {\n    const headers = await this.headers();\n    const count = await this.rowCount();\n    const records: Record<string, string>[] = [];\n\n    for (let rowIndex = 0; rowIndex < count; rowIndex++) {\n      const values = await this.rowValues(rowIndex);\n      const record: Record<string, string> = {};\n      values.forEach((value, columnIndex) => {\n        record[headers[columnIndex] ?? `column${columnIndex}`] = value;\n      });\n      records.push(record);\n    }\n    return records;\n  }\n\n  /** Rows containing `text` anywhere. Still a locator, so assertions on it auto-retry. */\n  rowsContaining(text: string | RegExp): Locator {\n    return this.rows.filter({ hasText: text });\n  }\n\n  /**\n   * Rows whose cell in a given column matches `value`. Returns a locator (auto-retrying);\n   * only the header lookup is awaited up front.\n   */\n  async rowsByColumn(column: string | number, value: string | RegExp): Promise<Locator> {\n    const index = typeof column === \"number\" ? column : await this.columnIndex(column);\n    return this.rows.filter({\n      has: this.page.locator(`${this.cellSelector}:nth-child(${index + 1})`).filter({ hasText: value }),\n    });\n  }\n\n  /** Waits until the table has at least `min` rows (default 1) — e.g. after a search or load. */\n  async waitForRows(min = 1, timeoutMs = 15_000): Promise<void> {\n    const deadline = Date.now() + timeoutMs;\n    for (;;) {\n      if ((await this.rowCount()) >= min) return;\n      if (Date.now() >= deadline) {\n        throw new AppError(`Table did not reach ${min} row(s) within ${timeoutMs}ms`, {\n          code: \"TABLE_ROWS_TIMEOUT\",\n          context: { min, timeoutMs, actual: await this.rowCount() },\n        });\n      }\n      await this.page.waitForTimeout(200);\n    }\n  }\n}\n"]}