@thinkwise/testwise 0.2.67 → 0.2.103

package/dist/page-extensions/SubjectRegistry.d.ts

@@ -1,6 +1,37 @@
 import type { Test } from '../types/Test.js';
+/**
+ * Playwright page-extension that makes every generated subject class available
+ * on the `page.subject` proxy during tests.
+ *
+ * **What it does:** At test startup it reads the registered subject list and
+ * wires up a `page.subject` property. Accessing `page.subject.EmployeeMain`
+ * returns an instance of the generated `EmployeeMain` class, which exposes
+ * typed component properties (`form`, `grid`, `actionBar`, etc.) and a
+ * `goTo()` method that navigates to that screen.
+ *
+ * **Important — do not edit this file directly.** The real implementation is
+ * generated from `templates/SubjectRegistry.template.ts` by the
+ * `SubjectRegistration` pipeline step. Any changes made here will be
+ * overwritten on the next `testwise sync`. Edit the template instead.
+ *
+ * @example
+ * ```ts
+ * // In a test:
+ * const employee = await page.subject.EmployeeEditable1Main.goTo();
+ * await employee.form.firstNameField.fill('Jane');
+ * await employee.actionBar.save();
+ * ```
+ */
 export declare class SubjectRegistry {
     private _test;
+    /**
+     * Stores the provided `Test` instance. The full implementation of this class is
+     * generated from the template in the templates folder — do not edit here directly.
+     * @param test - The Playwright `Test` fixture.
+     */
     constructor(test: Test);
+    /**
+     * Returns the stored `Test` fixture.
+     */
     get test(): Test;
 }

package/dist/page-extensions/SubjectRegistry.js

@@ -1,8 +1,39 @@
+/**
+ * Playwright page-extension that makes every generated subject class available
+ * on the `page.subject` proxy during tests.
+ *
+ * **What it does:** At test startup it reads the registered subject list and
+ * wires up a `page.subject` property. Accessing `page.subject.EmployeeMain`
+ * returns an instance of the generated `EmployeeMain` class, which exposes
+ * typed component properties (`form`, `grid`, `actionBar`, etc.) and a
+ * `goTo()` method that navigates to that screen.
+ *
+ * **Important — do not edit this file directly.** The real implementation is
+ * generated from `templates/SubjectRegistry.template.ts` by the
+ * `SubjectRegistration` pipeline step. Any changes made here will be
+ * overwritten on the next `testwise sync`. Edit the template instead.
+ *
+ * @example
+ * ```ts
+ * // In a test:
+ * const employee = await page.subject.EmployeeEditable1Main.goTo();
+ * await employee.form.firstNameField.fill('Jane');
+ * await employee.actionBar.save();
+ * ```
+ */
 export class SubjectRegistry {
+    /**
+     * Stores the provided `Test` instance. The full implementation of this class is
+     * generated from the template in the templates folder — do not edit here directly.
+     * @param test - The Playwright `Test` fixture.
+     */
     constructor(test) {
         // Implementation of this class is in the templates folder, don't edit here
         this._test = test;
     }
+    /**
+     * Returns the stored `Test` fixture.
+     */
     get test() {
         return this._test;
     }

package/dist/page-extensions/SubjectRegistry.js.map

@@ -1 +1 @@
-{"version":3,"file":"SubjectRegistry.js","sourceRoot":"","sources":["../../page-extensions/SubjectRegistry.ts"],"names":[],"mappings":"AACA,MAAM,OAAO,eAAe;IAG1B,YAAY,IAAU;QACpB,2EAA2E;QAC3E,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;IACpB,CAAC;IAED,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;CACF"}
+{"version":3,"file":"SubjectRegistry.js","sourceRoot":"","sources":["../../page-extensions/SubjectRegistry.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,OAAO,eAAe;IAG1B;;;;OAIG;IACH,YAAY,IAAU;QACpB,2EAA2E;QAC3E,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;IACpB,CAAC;IAED;;OAEG;IACH,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;CACF"}

package/dist/page-extensions/UserSimulation.d.ts

@@ -6,10 +6,31 @@ declare module '@playwright/test' {
         stopSimulation(): Promise<void>;
     }
 }
+/**
+ * Playwright fixture layer that adds user-simulation methods to the page:
+ * `page.simulateUser(username)`, `page.getSimulatedUser()`, and
+ * `page.stopSimulation()`.
+ *
+ * These methods switch the active identity inside the running Thinkwise
+ * application without a full logout/login cycle, enabling RBAC tests.
+ *
+ * @example
+ * await page.simulateUser('manager@example.com');
+ * // assert manager-only visibility ...
+ * await page.stopSimulation();
+ */
 export declare class UserSimulation {
     private _userSimulationHelper;
     private _test;
+    /**
+     * Extends the Playwright `Test` fixture to attach `simulateUser`, `getSimulatedUser`,
+     * and `stopSimulation` methods to the page, backed by `UserSimulationHelper`.
+     * @param test - The Playwright `Test` fixture to extend.
+     */
     constructor(test: Test);
     private get userSimulationHelper();
+    /**
+     * Returns the extended `Test` fixture with user simulation methods wired up on `page`.
+     */
     get test(): Test;
 }

package/dist/page-extensions/UserSimulation.js

@@ -1,5 +1,23 @@
 import { UserSimulationHelper } from '../helpers/UserSimulationHelper.js';
+/**
+ * Playwright fixture layer that adds user-simulation methods to the page:
+ * `page.simulateUser(username)`, `page.getSimulatedUser()`, and
+ * `page.stopSimulation()`.
+ *
+ * These methods switch the active identity inside the running Thinkwise
+ * application without a full logout/login cycle, enabling RBAC tests.
+ *
+ * @example
+ * await page.simulateUser('manager@example.com');
+ * // assert manager-only visibility ...
+ * await page.stopSimulation();
+ */
 export class UserSimulation {
+    /**
+     * Extends the Playwright `Test` fixture to attach `simulateUser`, `getSimulatedUser`,
+     * and `stopSimulation` methods to the page, backed by `UserSimulationHelper`.
+     * @param test - The Playwright `Test` fixture to extend.
+     */
     constructor(test) {
         this._test = test.extend({
             page: async ({ page }, use) => {
@@ -23,6 +41,9 @@ export class UserSimulation {
         }
         return this._userSimulationHelper;
     }
+    /**
+     * Returns the extended `Test` fixture with user simulation methods wired up on `page`.
+     */
     get test() {
         return this._test;
     }

package/dist/page-extensions/UserSimulation.js.map

@@ -1 +1 @@
-{"version":3,"file":"UserSimulation.js","sourceRoot":"","sources":["../../page-extensions/UserSimulation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,oCAAoC,CAAC;AAW1E,MAAM,OAAO,cAAc;IAIzB,YAAY,IAAU;QACpB,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC;YACvB,IAAI,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,EAAE,GAAG,EAAE,EAAE;gBAC5B,IAAI,CAAC,qBAAqB,GAAG,IAAI,oBAAoB,CAAC,IAAI,CAAC,CAAC;gBAE5D,IAAI,CAAC,YAAY,GAAG,KAAK,EAAE,QAAgB,EAAE,EAAE;oBAC7C,MAAM,IAAI,CAAC,oBAAoB,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC;gBACzD,CAAC,CAAC;gBAEF,IAAI,CAAC,gBAAgB,GAAG,KAAK,IAAI,EAAE;oBACjC,OAAO,MAAM,IAAI,CAAC,oBAAoB,CAAC,gBAAgB,EAAE,CAAC;gBAC5D,CAAC,CAAC;gBAEF,IAAI,CAAC,cAAc,GAAG,KAAK,IAAI,EAAE;oBAC/B,MAAM,IAAI,CAAC,oBAAoB,CAAC,cAAc,EAAE,CAAC;gBACnD,CAAC,CAAC;gBAEF,MAAM,GAAG,CAAC,IAAI,CAAC,CAAC;YAClB,CAAC;SACF,CAAC,CAAC;IACL,CAAC;IAED,IAAY,oBAAoB;QAC9B,IAAI,CAAC,IAAI,CAAC,qBAAqB,EAAE,CAAC;YAChC,MAAM,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAC;QAC7D,CAAC;QAED,OAAO,IAAI,CAAC,qBAAqB,CAAC;IACpC,CAAC;IAED,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;CACF"}
+{"version":3,"file":"UserSimulation.js","sourceRoot":"","sources":["../../page-extensions/UserSimulation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,oCAAoC,CAAC;AAW1E;;;;;;;;;;;;GAYG;AACH,MAAM,OAAO,cAAc;IAIzB;;;;OAIG;IACH,YAAY,IAAU;QACpB,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC;YACvB,IAAI,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,EAAE,GAAG,EAAE,EAAE;gBAC5B,IAAI,CAAC,qBAAqB,GAAG,IAAI,oBAAoB,CAAC,IAAI,CAAC,CAAC;gBAE5D,IAAI,CAAC,YAAY,GAAG,KAAK,EAAE,QAAgB,EAAE,EAAE;oBAC7C,MAAM,IAAI,CAAC,oBAAoB,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC;gBACzD,CAAC,CAAC;gBAEF,IAAI,CAAC,gBAAgB,GAAG,KAAK,IAAI,EAAE;oBACjC,OAAO,MAAM,IAAI,CAAC,oBAAoB,CAAC,gBAAgB,EAAE,CAAC;gBAC5D,CAAC,CAAC;gBAEF,IAAI,CAAC,cAAc,GAAG,KAAK,IAAI,EAAE;oBAC/B,MAAM,IAAI,CAAC,oBAAoB,CAAC,cAAc,EAAE,CAAC;gBACnD,CAAC,CAAC;gBAEF,MAAM,GAAG,CAAC,IAAI,CAAC,CAAC;YAClB,CAAC;SACF,CAAC,CAAC;IACL,CAAC;IAED,IAAY,oBAAoB;QAC9B,IAAI,CAAC,IAAI,CAAC,qBAAqB,EAAE,CAAC;YAChC,MAAM,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAC;QAC7D,CAAC;QAED,OAAO,IAAI,CAAC,qBAAqB,CAAC;IACpC,CAAC;IAED;;OAEG;IACH,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;CACF"}

package/dist/page-extensions/WaitEventHandler.d.ts

@@ -5,8 +5,28 @@ declare module '@playwright/test' {
         waitEventHandler: GlobalWaitEventHandler;
     }
 }
+/**
+ * Playwright fixture layer that attaches a `GlobalWaitEventHandler` instance
+ * to `page.waitEventHandler` before each test.
+ *
+ * Use `page.waitEventHandler` when you need to block test execution until a
+ * specific URL pattern has been responded to — for example, waiting for a
+ * background data-load endpoint before asserting on results.
+ *
+ * @example
+ * await page.waitEventHandler.waitForUrl('/api/employees/load');
+ * await expect(subject.grid.rows()).toHaveCount(10);
+ */
 export declare class WaitEventHandler {
     private _test;
+    /**
+     * Extends the Playwright `Test` fixture to attach a `GlobalWaitEventHandler` instance
+     * to `page.waitEventHandler` before each test.
+     * @param test - The Playwright `Test` fixture to extend.
+     */
     constructor(test: Test);
+    /**
+     * Returns the extended `Test` fixture with `page.waitEventHandler` wired up.
+     */
     get test(): Test;
 }

package/dist/page-extensions/WaitEventHandler.js

@@ -1,5 +1,22 @@
 import { GlobalWaitEventHandler } from '../helpers/GlobalWaitEventHandler.js';
+/**
+ * Playwright fixture layer that attaches a `GlobalWaitEventHandler` instance
+ * to `page.waitEventHandler` before each test.
+ *
+ * Use `page.waitEventHandler` when you need to block test execution until a
+ * specific URL pattern has been responded to — for example, waiting for a
+ * background data-load endpoint before asserting on results.
+ *
+ * @example
+ * await page.waitEventHandler.waitForUrl('/api/employees/load');
+ * await expect(subject.grid.rows()).toHaveCount(10);
+ */
 export class WaitEventHandler {
+    /**
+     * Extends the Playwright `Test` fixture to attach a `GlobalWaitEventHandler` instance
+     * to `page.waitEventHandler` before each test.
+     * @param test - The Playwright `Test` fixture to extend.
+     */
     constructor(test) {
         this._test = test.extend({
             page: async ({ page }, use) => {
@@ -8,6 +25,9 @@ export class WaitEventHandler {
             }
         });
     }
+    /**
+     * Returns the extended `Test` fixture with `page.waitEventHandler` wired up.
+     */
     get test() {
         return this._test;
     }

package/dist/page-extensions/WaitEventHandler.js.map

@@ -1 +1 @@
-{"version":3,"file":"WaitEventHandler.js","sourceRoot":"","sources":["../../page-extensions/WaitEventHandler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,sCAAsC,CAAC;AAS9E,MAAM,OAAO,gBAAgB;IAG3B,YAAY,IAAU;QACpB,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC;YACvB,IAAI,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,EAAE,GAAG,EAAE,EAAE;gBAC5B,IAAI,CAAC,gBAAgB,GAAG,IAAI,sBAAsB,CAAC,IAAI,CAAC,CAAC;gBAEzD,MAAM,GAAG,CAAC,IAAI,CAAC,CAAC;YAClB,CAAC;SACF,CAAC,CAAC;IACL,CAAC;IAED,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;CACF"}
+{"version":3,"file":"WaitEventHandler.js","sourceRoot":"","sources":["../../page-extensions/WaitEventHandler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,sCAAsC,CAAC;AAS9E;;;;;;;;;;;GAWG;AACH,MAAM,OAAO,gBAAgB;IAG3B;;;;OAIG;IACH,YAAY,IAAU;QACpB,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC;YACvB,IAAI,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,EAAE,GAAG,EAAE,EAAE;gBAC5B,IAAI,CAAC,gBAAgB,GAAG,IAAI,sBAAsB,CAAC,IAAI,CAAC,CAAC;gBAEzD,MAAM,GAAG,CAAC,IAAI,CAAC,CAAC;YAClB,CAAC;SACF,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;CACF"}

package/dist/page-overrides/ClickOverride.d.ts

@@ -1,8 +1,29 @@
 import type { Test } from '../types/Test.js';
+/**
+ * Playwright fixture layer that wraps every Locator `click()` call to wait
+ * for in-flight XHR requests to settle before returning control to the test.
+ *
+ * **Why this exists:** The Thinkwise application fires XHR calls immediately
+ * after a click (save, navigation, data load). Without this override a test
+ * that clicks a button and then immediately reads a value races against the
+ * server response. `ClickOverride` uses `FlightTracker` under the hood to
+ * block until all relevant requests finish.
+ *
+ * **How to disable** (if a specific test must opt out):
+ * Set `featureSettings.InflightRequests.waitForRequestsToComplete: false` in
+ * `Testwise.json` — but this is rarely needed.
+ */
 export declare class ClickOverride {
     private _test;
-    private _page;
-    private flightTracker;
+    /**
+     * Extends the Playwright `Test` fixture to wrap every locator's `click` method with
+     * in-flight XHR tracking via `FlightTracker`, waiting for all relevant requests to
+     * settle after each click. Behaviour is configurable via `featureSettings.InflightRequests`.
+     * @param test - The Playwright `Test` fixture to extend.
+     */
     constructor(test: Test);
+    /**
+     * Returns the extended `Test` fixture with the click override active.
+     */
     get test(): Test;
 }

package/dist/page-overrides/ClickOverride.js

@@ -1,65 +1,46 @@
 import { FlightTracker } from '../helpers/FlightTracker.js';
 import { testwiseConfig } from '../services/ConfigBuilder.js';
 const waitForRequestsToComplete = testwiseConfig().get('featureSettings.InflightRequests.waitForRequestsToComplete') ?? true;
-const continueOnError = testwiseConfig().get('featureSettings.InflightRequests.continueOnError') ?? true;
+/**
+ * Playwright fixture layer that wraps every Locator `click()` call to wait
+ * for in-flight XHR requests to settle before returning control to the test.
+ *
+ * **Why this exists:** The Thinkwise application fires XHR calls immediately
+ * after a click (save, navigation, data load). Without this override a test
+ * that clicks a button and then immediately reads a value races against the
+ * server response. `ClickOverride` uses `FlightTracker` under the hood to
+ * block until all relevant requests finish.
+ *
+ * **How to disable** (if a specific test must opt out):
+ * Set `featureSettings.InflightRequests.waitForRequestsToComplete: false` in
+ * `Testwise.json` — but this is rarely needed.
+ */
 export class ClickOverride {
+    /**
+     * Extends the Playwright `Test` fixture to wrap every locator's `click` method with
+     * in-flight XHR tracking via `FlightTracker`, waiting for all relevant requests to
+     * settle after each click. Behaviour is configurable via `featureSettings.InflightRequests`.
+     * @param test - The Playwright `Test` fixture to extend.
+     */
     constructor(test) {
-        this._page = null;
-        this.flightTracker = new FlightTracker();
         this._test = test.extend({
             page: async ({ page }, use) => {
-                this._page = page;
-                const isTrackable = (url, resourceType) => {
-                    const lowerUrl = url.toLowerCase();
-                    return (resourceType === 'xhr' &&
-                        !lowerUrl.includes('/detect_change(') &&
-                        !lowerUrl.includes('/set_gui_start_use_log_session') &&
-                        !lowerUrl.includes('download_icon') &&
-                        !lowerUrl.includes('download_list_bar_grp_icon') &&
-                        !lowerUrl.includes('/badge()'));
-                };
+                const flightTracker = new FlightTracker();
+                page.on('request', (request) => {
+                    flightTracker.handleRequestStarted(request.url(), request.resourceType());
+                });
+                page.on('response', (response) => {
+                    flightTracker.handleRequestFinished(response.request().url());
+                });
+                page.on('requestfailed', (request) => {
+                    flightTracker.handleRequestFailed(request.url());
+                });
                 const overrideClickMethod = (locator) => {
                     const originalClickMethod = locator.click.bind(locator);
-                    page.on('request', (request) => {
-                        if (isTrackable(request.url(), request.resourceType())) {
-                            this.flightTracker.requestsInFlight++;
-                        }
-                    });
-                    page.on('response', (response) => {
-                        if (isTrackable(response.request().url(), response.request().resourceType())) {
-                            if (this.flightTracker.requestsInFlight > 0) {
-                                this.flightTracker.requestsInFlight--;
-                            }
-                            if (this.flightTracker.requestsInFlight === 0) {
-                                this.flightTracker.eventEmitter.emit('idle');
-                            }
-                        }
-                    });
                     locator.click = async (options) => {
                         await originalClickMethod(options);
                         if (waitForRequestsToComplete) {
-                            try {
-                                await this.flightTracker.waitToContinue();
-                            }
-                            catch (error) {
-                                console.warn('Exception while waiting for inflight requests to finish:', error);
-                                if (this._page) {
-                                    const inflightRequests = await this._page.evaluate(() => {
-                                        return performance
-                                            .getEntriesByType('resource')
-                                            .filter((entry) => {
-                                            const res = entry;
-                                            return (res.initiatorType === 'xmlhttprequest' &&
-                                                !res.name.includes('/detect_change(') &&
-                                                !res.name.includes('/set_gui_start_use_log_session'));
-                                        })
-                                            .map((entry) => entry.name);
-                                    });
-                                    console.debug('Current inflight XHR requests:', inflightRequests);
-                                }
-                                if (!continueOnError)
-                                    throw error;
-                            }
+                            await flightTracker.waitToContinue();
                         }
                         return;
                     };
@@ -98,6 +79,9 @@ export class ClickOverride {
             }
         });
     }
+    /**
+     * Returns the extended `Test` fixture with the click override active.
+     */
     get test() {
         return this._test;
     }

package/dist/page-overrides/ClickOverride.js.map

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

package/dist/page-overrides/FillOverride.d.ts

@@ -1,7 +1,30 @@
 import type { Test } from '../types/Test.js';
+/**
+ * Playwright fixture layer that wraps every Locator `fill()` call to wait
+ * for in-flight XHR requests to settle before returning control to the test.
+ *
+ * **Why this exists:** After filling a lookup or auto-complete field the
+ * Thinkwise application fires XHR calls to search/resolve the typed value.
+ * Without this override, subsequent assertions or interactions race against
+ * those server responses. `FillOverride` uses `FlightTracker` to block until
+ * all relevant requests on the watchlist finish.
+ *
+ * The `featureSettings.InflightRequests.paths` list in `Testwise.json`
+ * controls which API endpoints are watched during fill operations.
+ */
 export declare class FillOverride {
     private _test;
     private flightTracker;
+    /**
+     * Extends the Playwright `Test` fixture to wrap every locator's `fill` method:
+     * waits for watched in-flight requests to settle, fills the element, and — for
+     * qualifying form fields — triggers a `/staged` response wait and blurs the element
+     * if the value changed. Watchlist and behaviour are configurable via `featureSettings`.
+     * @param test - The Playwright `Test` fixture to extend.
+     */
     constructor(test: Test);
+    /**
+     * Returns the extended `Test` fixture with the fill override active.
+     */
     get test(): Test;
 }

package/dist/page-overrides/FillOverride.js

@@ -2,7 +2,37 @@ import { FlightTracker } from '../helpers/FlightTracker.js';
 import { testwiseConfig } from '../services/ConfigBuilder.js';
 const requestWatchlist = testwiseConfig().get('featureSettings.InflightRequests.paths') ?? [];
 const waitForRequestsToComplete = testwiseConfig().get('featureSettings.InflightRequests.waitForRequestsToComplete') ?? true;
+const locatorMethods = [
+    'locator',
+    'getByText',
+    'getByTestId',
+    'getByAltText',
+    'getByLabel',
+    'getByRole',
+    'getByPlaceholder',
+    'getByTitle'
+];
+/**
+ * Playwright fixture layer that wraps every Locator `fill()` call to wait
+ * for in-flight XHR requests to settle before returning control to the test.
+ *
+ * **Why this exists:** After filling a lookup or auto-complete field the
+ * Thinkwise application fires XHR calls to search/resolve the typed value.
+ * Without this override, subsequent assertions or interactions race against
+ * those server responses. `FillOverride` uses `FlightTracker` to block until
+ * all relevant requests on the watchlist finish.
+ *
+ * The `featureSettings.InflightRequests.paths` list in `Testwise.json`
+ * controls which API endpoints are watched during fill operations.
+ */
 export class FillOverride {
+    /**
+     * Extends the Playwright `Test` fixture to wrap every locator's `fill` method:
+     * waits for watched in-flight requests to settle, fills the element, and — for
+     * qualifying form fields — triggers a `/staged` response wait and blurs the element
+     * if the value changed. Watchlist and behaviour are configurable via `featureSettings`.
+     * @param test - The Playwright `Test` fixture to extend.
+     */
     constructor(test) {
         this.flightTracker = new FlightTracker();
         this._test = test.extend({
@@ -26,80 +56,45 @@ export class FillOverride {
                     });
                 }
                 const overrideFillMethod = (locator) => {
-                    const originalFillMethod = locator.fill.bind(locator);
+                    const originalFill = locator.fill.bind(locator);
                     locator.fill = async (value, options) => {
-                        try {
-                            if (waitForRequestsToComplete)
-                                await this.flightTracker.waitToContinue();
-                        }
-                        catch (e) {
-                            console.warn('Exception:', e);
-                            this.flightTracker.requestsInFlight = 0;
-                        }
-                        const currentValue = await locator.inputValue();
-                        const valueIsDifferent = currentValue !== value;
-                        const formFieldTestIdPrefix = 'form-field__';
-                        const isQualifyingFormField = await locator.evaluate((el, formFieldTestIdPrefix) => {
-                            const elementTestId = el.getAttribute('data-testid');
-                            const parentWithFormSectionTestId = el.closest('[data-testid^="form-section__"]');
-                            if (elementTestId) {
-                                return elementTestId.includes(formFieldTestIdPrefix) && parentWithFormSectionTestId !== null;
-                            }
-                            return false;
-                        }, formFieldTestIdPrefix);
-                        if (valueIsDifferent && isQualifyingFormField) {
-                            await page.waitEventHandler.waitForCanContinue();
-                            page.waitEventHandler.waitForResponse('/staged');
-                        }
-                        await originalFillMethod(value, options);
+                        if (waitForRequestsToComplete)
+                            await this.flightTracker.waitToContinue();
+                        const [valueIsDifferent, isQualifyingFormField] = await Promise.all([
+                            locator.inputValue().then((v) => v !== value),
+                            locator.evaluate((el) => {
+                                const testId = el.getAttribute('data-testid');
+                                return (!!testId && testId.includes('form-field__') && el.closest('[data-testid^="form-section__"]') !== null);
+                            })
+                        ]);
+                        await page.waitEventHandler.waitForCanContinue();
+                        await originalFill(value, options);
                         if (isQualifyingFormField) {
+                            if (valueIsDifferent)
+                                page.waitEventHandler.waitForResponse('/staged');
                             await locator.evaluate((el) => {
-                                const ariaExpanded = el.getAttribute('aria-expanded');
-                                if (!ariaExpanded)
+                                if (!el.getAttribute('aria-expanded'))
                                     el.blur();
                             });
                         }
                     };
-                    const originalLocatorMethod = locator.locator.bind(locator);
-                    locator.locator = (...args) => overrideFillMethod(originalLocatorMethod(...args));
-                    const originalGetByTextMethod = locator.getByText.bind(locator);
-                    locator.getByText = (...args) => overrideFillMethod(originalGetByTextMethod(...args));
-                    const originalGetByTestIdMethod = locator.getByTestId.bind(locator);
-                    locator.getByTestId = (...args) => overrideFillMethod(originalGetByTestIdMethod(...args));
-                    const originalGetByAltTextMethod = locator.getByAltText.bind(locator);
-                    locator.getByAltText = (...args) => overrideFillMethod(originalGetByAltTextMethod(...args));
-                    const originalGetByLabelMethod = locator.getByLabel.bind(locator);
-                    locator.getByLabel = (...args) => overrideFillMethod(originalGetByLabelMethod(...args));
-                    const originalGetByRoleMethod = locator.getByRole.bind(locator);
-                    locator.getByRole = (...args) => overrideFillMethod(originalGetByRoleMethod(...args));
-                    const originalGetByPlaceholderMethod = locator.getByPlaceholder.bind(locator);
-                    locator.getByPlaceholder = (...args) => overrideFillMethod(originalGetByPlaceholderMethod(...args));
-                    const originalGetByTitleMethod = locator.getByTitle.bind(locator);
-                    locator.getByTitle = (...args) => overrideFillMethod(originalGetByTitleMethod(...args));
+                    for (const method of locatorMethods) {
+                        const original = locator[method].bind(locator);
+                        locator[method] = (...args) => overrideFillMethod(original(...args));
+                    }
                     return locator;
                 };
-                // Override the locator method on the page object
-                const originalLocator = page.locator.bind(page);
-                page.locator = (...args) => overrideFillMethod(originalLocator(...args));
-                const originalGetByTestId = page.getByTestId.bind(page);
-                const originalGetByAltText = page.getByAltText.bind(page);
-                const originalGetByLabel = page.getByLabel.bind(page);
-                const originalGetByRole = page.getByRole.bind(page);
-                const originalGetByPlaceholder = page.getByPlaceholder.bind(page);
-                const originalGetByText = page.getByText.bind(page);
-                const originalGetByTitle = page.getByTitle.bind(page);
-                // Override other top-level methods as before
-                page.getByTestId = (...args) => overrideFillMethod(originalGetByTestId(...args));
-                page.getByAltText = (...args) => overrideFillMethod(originalGetByAltText(...args));
-                page.getByLabel = (...args) => overrideFillMethod(originalGetByLabel(...args));
-                page.getByRole = (...args) => overrideFillMethod(originalGetByRole(...args));
-                page.getByPlaceholder = (...args) => overrideFillMethod(originalGetByPlaceholder(...args));
-                page.getByText = (...args) => overrideFillMethod(originalGetByText(...args));
-                page.getByTitle = (...args) => overrideFillMethod(originalGetByTitle(...args));
+                for (const method of locatorMethods) {
+                    const original = page[method].bind(page);
+                    page[method] = (...args) => overrideFillMethod(original(...args));
+                }
                 await use(page);
             }
         });
     }
+    /**
+     * Returns the extended `Test` fixture with the fill override active.
+     */
     get test() {
         return this._test;
     }

package/dist/page-overrides/FillOverride.js.map

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

package/dist/services/ConfigBuilder.d.ts

@@ -1,3 +1,27 @@
+/**
+ * Reads and exposes the consumer project's `Testwise.json` configuration file
+ * and any `.env` files found in the project root.
+ *
+ * **What it does:**
+ * - Locates `Testwise.json` relative to `process.env.INIT_CWD` (the directory
+ *   from which `npm run` was invoked — i.e. the consumer project root).
+ * - Parses and applies every `.env` file found in that directory into
+ *   `process.env` so environment variables are available to all pipeline steps
+ *   and helpers before they construct.
+ * - Exposes a dot-notation `get<T>(key)` accessor to retrieve deeply nested
+ *   config values without needing to cast or navigate the raw JSON.
+ *
+ * **How to use it in tests or helpers:**
+ * ```ts
+ * import { testwiseConfig } from '../services/ConfigBuilder.js';
+ *
+ * const baseUrl = testwiseConfig().get<string>('application.baseUrl');
+ * const timeout  = testwiseConfig().get<number>('featureSettings.InflightRequests.waitTimeout');
+ * ```
+ *
+ * The exported `testwiseConfig()` function returns a singleton—the file is
+ * only read once per process.
+ */
 declare class ConfigBuilder {
     private config;
     constructor();