@thinkwise/testwise 0.2.62 → 0.2.99

package/dist/helpers/Poll.js

@@ -1,3 +1,15 @@
+/**
+ * Repeatedly calls `fn` at a configurable interval until the optional `predicate` returns
+ * truthy or the `timeout` is exceeded, at which point it throws.
+ * `onTick` is called with the last value and elapsed time after each failing attempt.
+ * @param fn - The async or sync function to poll.
+ * @param opts.timeout - Maximum wait time in milliseconds (default `10 000`).
+ * @param opts.interval - Polling interval in milliseconds (default `200`).
+ * @param opts.predicate - Returns `true` when the result is acceptable (default: truthy check).
+ * @param opts.onTick - Called after each failing attempt with the last value and elapsed ms.
+ * @returns The first value for which `predicate` returns `true`.
+ * @throws If `timeout` is exceeded before `predicate` returns `true`.
+ */
 export async function pollUntil(fn, opts = {}) {
     const timeout = opts.timeout ?? 10000;
     const interval = opts.interval ?? 200;

package/dist/helpers/Poll.js.map

@@ -1 +1 @@
-{"version":3,"file":"Poll.js","sourceRoot":"","sources":["../../helpers/Poll.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,KAAK,UAAU,SAAS,CAAI,EAAwB,EAAE,OAAuB,EAAE;IACpF,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,IAAI,KAAM,CAAC;IACvC,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,IAAI,GAAG,CAAC;IACtC,MAAM,EAAE,GAAG,IAAI,CAAC,SAAS,IAAI,CAAC,CAAC,CAAI,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;IACpD,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAEzB,OAAO,IAAI,EAAE,CAAC;QACZ,MAAM,GAAG,GAAG,MAAM,EAAE,EAAE,CAAC;QACvB,IAAI,EAAE,CAAC,GAAG,CAAC;YAAE,OAAO,GAAG,CAAC;QAExB,IAAI,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,CAAC;QACvC,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,IAAI,OAAO,EAAE,CAAC;YAClC,MAAM,IAAI,KAAK,CAAC,2BAA2B,OAAO,IAAI,CAAC,CAAC;QAC1D,CAAC;QACD,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC;IACpD,CAAC;AACH,CAAC"}
+{"version":3,"file":"Poll.js","sourceRoot":"","sources":["../../helpers/Poll.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAAI,EAAwB,EAAE,OAAuB,EAAE;IACpF,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,IAAI,KAAM,CAAC;IACvC,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,IAAI,GAAG,CAAC;IACtC,MAAM,EAAE,GAAG,IAAI,CAAC,SAAS,IAAI,CAAC,CAAC,CAAI,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;IACpD,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAEzB,OAAO,IAAI,EAAE,CAAC;QACZ,MAAM,GAAG,GAAG,MAAM,EAAE,EAAE,CAAC;QACvB,IAAI,EAAE,CAAC,GAAG,CAAC;YAAE,OAAO,GAAG,CAAC;QAExB,IAAI,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,CAAC;QACvC,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,IAAI,OAAO,EAAE,CAAC;YAClC,MAAM,IAAI,KAAK,CAAC,2BAA2B,OAAO,IAAI,CAAC,CAAC;QAC1D,CAAC;QACD,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC;IACpD,CAAC;AACH,CAAC"}

package/dist/helpers/RegexHelper.d.ts

@@ -1,4 +1,19 @@
+/**
+ * Escapes all characters with special meaning in regular expressions so that `input`
+ * can be safely embedded inside a `RegExp` constructor without unintended pattern matching.
+ * @param input - The raw string to escape.
+ * @returns The escaped string.
+ */
 export declare function escapeRegex(input: string): string;
+/**
+ * Builds a case-insensitive, Unicode-safe `RegExp` that exactly matches `input`.
+ * Optionally trims leading/trailing whitespace and collapses internal whitespace runs
+ * to a single space to match typical UI text normalization.
+ * @param input - The text to match exactly.
+ * @param opts.trim - Trim leading/trailing whitespace before matching (default `true`).
+ * @param opts.collapseWhitespace - Collapse runs of whitespace to a single space (default `false`).
+ * @returns A case-insensitive `RegExp` anchored with `^` and `$`.
+ */
 export declare function exactTextRegex(input: string, opts?: {
     trim?: boolean;
     collapseWhitespace?: boolean;

package/dist/helpers/RegexHelper.js

@@ -1,9 +1,21 @@
-// Escapes characters with special meaning in regexes.
+/**
+ * Escapes all characters with special meaning in regular expressions so that `input`
+ * can be safely embedded inside a `RegExp` constructor without unintended pattern matching.
+ * @param input - The raw string to escape.
+ * @returns The escaped string.
+ */
 export function escapeRegex(input) {
     return input.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
 }
-// Exact match, case-insensitive, Unicode-safe.
-// By default trims the input; set trim=false for truly literal.
+/**
+ * Builds a case-insensitive, Unicode-safe `RegExp` that exactly matches `input`.
+ * Optionally trims leading/trailing whitespace and collapses internal whitespace runs
+ * to a single space to match typical UI text normalization.
+ * @param input - The text to match exactly.
+ * @param opts.trim - Trim leading/trailing whitespace before matching (default `true`).
+ * @param opts.collapseWhitespace - Collapse runs of whitespace to a single space (default `false`).
+ * @returns A case-insensitive `RegExp` anchored with `^` and `$`.
+ */
 export function exactTextRegex(input, opts) {
     const { trim = true, collapseWhitespace = false } = opts ?? {};
     let s = trim ? input.trim() : input;

package/dist/helpers/RegexHelper.js.map

@@ -1 +1 @@
-{"version":3,"file":"RegexHelper.js","sourceRoot":"","sources":["../../helpers/RegexHelper.ts"],"names":[],"mappings":"AAAA,sDAAsD;AACtD,MAAM,UAAU,WAAW,CAAC,KAAa;IACvC,OAAO,KAAK,CAAC,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAC;AACtD,CAAC;AAED,+CAA+C;AAC/C,gEAAgE;AAChE,MAAM,UAAU,cAAc,CAAC,KAAa,EAAE,IAAuD;IACnG,MAAM,EAAE,IAAI,GAAG,IAAI,EAAE,kBAAkB,GAAG,KAAK,EAAE,GAAG,IAAI,IAAI,EAAE,CAAC;IAC/D,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC;IAEpC,IAAI,kBAAkB,EAAE,CAAC;QACvB,wEAAwE;QACxE,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC7B,CAAC;IACD,OAAO,IAAI,MAAM,CAAC,IAAI,WAAW,CAAC,CAAC,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,CAAC,oCAAoC;AACtF,CAAC"}
+{"version":3,"file":"RegexHelper.js","sourceRoot":"","sources":["../../helpers/RegexHelper.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,UAAU,WAAW,CAAC,KAAa;IACvC,OAAO,KAAK,CAAC,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAC;AACtD,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,cAAc,CAAC,KAAa,EAAE,IAAuD;IACnG,MAAM,EAAE,IAAI,GAAG,IAAI,EAAE,kBAAkB,GAAG,KAAK,EAAE,GAAG,IAAI,IAAI,EAAE,CAAC;IAC/D,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC;IAEpC,IAAI,kBAAkB,EAAE,CAAC;QACvB,wEAAwE;QACxE,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC7B,CAAC;IACD,OAAO,IAAI,MAAM,CAAC,IAAI,WAAW,CAAC,CAAC,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,CAAC,oCAAoC;AACtF,CAAC"}

package/dist/helpers/SubjectNavigator.d.ts

@@ -0,0 +1,26 @@
+import type { Page } from '@playwright/test';
+/**
+ * Navigates the browser to a Thinkwise subject deep-link URL and waits for
+ * the application to fully settle before returning control to the test.
+ *
+ * **Why this exists:** Calling `page.goto()` directly does not account for
+ * the asynchronous XHR requests that the Thinkwise app fires after a navigation
+ * event. Tests that act immediately after a bare `goto` frequently encounter
+ * loading spinners, empty grids, or incomplete form data. `SubjectNavigator`
+ * wraps navigation in a `FlightTracker` session so the test only continues
+ * once the network is truly idle.
+ *
+ * **How to use it:** You typically don't call this directly — it is used
+ * internally by the generated subject class `goTo()` methods. If you need
+ * to navigate imperatively in a test, prefer `page.subject.MySubjectClass.goTo()`.
+ *
+ * @example
+ * // Inside a generated subject class:
+ * const navigator = new SubjectNavigator(page);
+ * await navigator.navigateTo('subjects/Employee/Editable1/Main');
+ */
+export declare class SubjectNavigator {
+    private readonly _page;
+    constructor(page: Page);
+    navigateTo(url: string): Promise<void>;
+}

package/dist/helpers/SubjectNavigator.js

@@ -0,0 +1,51 @@
+import { FlightTracker } from './FlightTracker.js';
+/**
+ * Navigates the browser to a Thinkwise subject deep-link URL and waits for
+ * the application to fully settle before returning control to the test.
+ *
+ * **Why this exists:** Calling `page.goto()` directly does not account for
+ * the asynchronous XHR requests that the Thinkwise app fires after a navigation
+ * event. Tests that act immediately after a bare `goto` frequently encounter
+ * loading spinners, empty grids, or incomplete form data. `SubjectNavigator`
+ * wraps navigation in a `FlightTracker` session so the test only continues
+ * once the network is truly idle.
+ *
+ * **How to use it:** You typically don't call this directly — it is used
+ * internally by the generated subject class `goTo()` methods. If you need
+ * to navigate imperatively in a test, prefer `page.subject.MySubjectClass.goTo()`.
+ *
+ * @example
+ * // Inside a generated subject class:
+ * const navigator = new SubjectNavigator(page);
+ * await navigator.navigateTo('subjects/Employee/Editable1/Main');
+ */
+export class SubjectNavigator {
+    constructor(page) {
+        this._page = page;
+    }
+    async navigateTo(url) {
+        const flightTracker = new FlightTracker();
+        const onRequest = (request) => {
+            flightTracker.handleRequestStarted(request.url(), request.resourceType());
+        };
+        const onResponse = (response) => {
+            flightTracker.handleRequestFinished(response.request().url());
+        };
+        const onRequestFailed = (request) => {
+            flightTracker.handleRequestFailed(request.url());
+        };
+        this._page.on('request', onRequest);
+        this._page.on('response', onResponse);
+        this._page.on('requestfailed', onRequestFailed);
+        try {
+            await this._page.goToDeepLink(url);
+            await flightTracker.waitForNavigationToSettle();
+        }
+        finally {
+            this._page.off('request', onRequest);
+            this._page.off('response', onResponse);
+            this._page.off('requestfailed', onRequestFailed);
+        }
+    }
+}
+//# sourceMappingURL=SubjectNavigator.js.map

package/dist/helpers/SubjectNavigator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SubjectNavigator.js","sourceRoot":"","sources":["../../helpers/SubjectNavigator.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,OAAO,gBAAgB;IAG3B,YAAY,IAAU;QACpB,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;IACpB,CAAC;IAEM,KAAK,CAAC,UAAU,CAAC,GAAW;QACjC,MAAM,aAAa,GAAG,IAAI,aAAa,EAAE,CAAC;QAE1C,MAAM,SAAS,GAAG,CAAC,OAA2C,EAAE,EAAE;YAChE,aAAa,CAAC,oBAAoB,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;QAC5E,CAAC,CAAC;QACF,MAAM,UAAU,GAAG,CAAC,QAA6C,EAAE,EAAE;YACnE,aAAa,CAAC,qBAAqB,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC;QAChE,CAAC,CAAC;QACF,MAAM,eAAe,GAAG,CAAC,OAA2C,EAAE,EAAE;YACtE,aAAa,CAAC,mBAAmB,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;QACnD,CAAC,CAAC;QAEF,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;QACpC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;QACtC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,eAAe,EAAE,eAAe,CAAC,CAAC;QAEhD,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC;YACnC,MAAM,aAAa,CAAC,yBAAyB,EAAE,CAAC;QAClD,CAAC;gBAAS,CAAC;YACT,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;YACrC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;YACvC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,eAAe,EAAE,eAAe,CAAC,CAAC;QACnD,CAAC;IACH,CAAC;CACF"}

package/dist/helpers/UserSimulationHelper.d.ts

@@ -1,4 +1,18 @@
 import type { Page } from '@playwright/test';
+/**
+ * Simulates switching the active user identity in the Thinkwise application
+ * at runtime, without logging out and back in. Useful for testing
+ * role-based access control (RBAC) and user-specific workflows.
+ *
+ * Exposed on the page fixture via `UserSimulation` as `page.simulateUser()`,
+ * `page.getSimulatedUser()`, and `page.stopSimulation()`. You do not
+ * instantiate `UserSimulationHelper` directly in tests.
+ *
+ * @example
+ * await page.simulateUser('john.doe@example.com');
+ * // ... assert behaviour for this user ...
+ * await page.stopSimulation();
+ */
 export declare class UserSimulationHelper {
     private _page;
     private _serviceUrl;

package/dist/helpers/UserSimulationHelper.js

@@ -1,5 +1,19 @@
 import { testwiseConfig } from '../services/ConfigBuilder.js';
 import { pollUntil } from './Poll.js';
+/**
+ * Simulates switching the active user identity in the Thinkwise application
+ * at runtime, without logging out and back in. Useful for testing
+ * role-based access control (RBAC) and user-specific workflows.
+ *
+ * Exposed on the page fixture via `UserSimulation` as `page.simulateUser()`,
+ * `page.getSimulatedUser()`, and `page.stopSimulation()`. You do not
+ * instantiate `UserSimulationHelper` directly in tests.
+ *
+ * @example
+ * await page.simulateUser('john.doe@example.com');
+ * // ... assert behaviour for this user ...
+ * await page.stopSimulation();
+ */
 export class UserSimulationHelper {
     constructor(page) {
         this._page = page;

package/dist/helpers/UserSimulationHelper.js.map

@@ -1 +1 @@
-{"version":3,"file":"UserSimulationHelper.js","sourceRoot":"","sources":["../../helpers/UserSimulationHelper.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEtC,MAAM,OAAO,oBAAoB;IAI/B,YAAY,IAAU;QACpB,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;QAElB,MAAM,UAAU,GAAG,cAAc,EAAE,CAAC,GAAG,CAAS,gCAAgC,CAAC,CAAC;QAElF,IAAI,CAAC,UAAU;YAAE,MAAM,IAAI,KAAK,CAAC,qEAAqE,CAAC,CAAC;QAExG,IAAI,CAAC,WAAW,GAAG,UAAU,CAAC;IAChC,CAAC;IAED;;;OAGG;IACI,KAAK,CAAC,gBAAgB;QAC3B,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,WAAW,6BAA6B,CAAC,CAAC;QAEhG,QAAQ,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAC;YAC1B,KAAK,GAAG;gBACN,OAAO,CAAC,IAAI,CAAC,4BAA4B,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;gBAC9D,OAAO,EAAE,CAAC;YACZ,KAAK,GAAG;gBACN,OAAO,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,cAAc,CAAC;YAChD;gBACE,MAAM,IAAI,KAAK,CAAC,kDAAkD,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QAC3F,CAAC;IACH,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,cAAc;QACzB,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,WAAW,6BAA6B,CAAC,CAAC;QAEnG,IAAI,QAAQ,CAAC,MAAM,EAAE,KAAK,GAAG,EAAE,CAAC;YAC9B,OAAO,CAAC,IAAI,CAAC,4CAA4C,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;QAChF,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,KAAK,CAAC,+CAA+C,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QACtF,CAAC;QAED,MAAM,SAAS,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,gBAAgB,EAAE,EAAE;YAC7C,OAAO,EAAE,IAAK;YACd,QAAQ,EAAE,GAAG;YACb,SAAS,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,KAAK,EAAE;SAC/B,CAAC,CAAC;IACL,CAAC;IAED;;;OAGG;IACI,KAAK,CAAC,YAAY,CAAC,QAAgB;QACxC,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,WAAW,6BAA6B,EAAE;YAChG,OAAO,EAAE;gBACP,cAAc,EAAE,kBAAkB;gBAClC,MAAM,EAAE,kBAAkB;aAC3B;YACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;gBACnB,cAAc,EAAE,QAAQ;aACzB,CAAC;SACH,CAAC,CAAC;QAEH,IAAI,QAAQ,CAAC,MAAM,EAAE,KAAK,GAAG,EAAE,CAAC;YAC9B,OAAO,CAAC,IAAI,CAAC,uCAAuC,EAAE,MAAM,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;QACjF,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,KAAK,CAAC,0CAA0C,MAAM,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QACvF,CAAC;IACH,CAAC;CACF"}
+{"version":3,"file":"UserSimulationHelper.js","sourceRoot":"","sources":["../../helpers/UserSimulationHelper.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEtC;;;;;;;;;;;;;GAaG;AACH,MAAM,OAAO,oBAAoB;IAI/B,YAAY,IAAU;QACpB,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;QAElB,MAAM,UAAU,GAAG,cAAc,EAAE,CAAC,GAAG,CAAS,gCAAgC,CAAC,CAAC;QAElF,IAAI,CAAC,UAAU;YAAE,MAAM,IAAI,KAAK,CAAC,qEAAqE,CAAC,CAAC;QAExG,IAAI,CAAC,WAAW,GAAG,UAAU,CAAC;IAChC,CAAC;IAED;;;OAGG;IACI,KAAK,CAAC,gBAAgB;QAC3B,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,WAAW,6BAA6B,CAAC,CAAC;QAEhG,QAAQ,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAC;YAC1B,KAAK,GAAG;gBACN,OAAO,CAAC,IAAI,CAAC,4BAA4B,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;gBAC9D,OAAO,EAAE,CAAC;YACZ,KAAK,GAAG;gBACN,OAAO,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,cAAc,CAAC;YAChD;gBACE,MAAM,IAAI,KAAK,CAAC,kDAAkD,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QAC3F,CAAC;IACH,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,cAAc;QACzB,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,WAAW,6BAA6B,CAAC,CAAC;QAEnG,IAAI,QAAQ,CAAC,MAAM,EAAE,KAAK,GAAG,EAAE,CAAC;YAC9B,OAAO,CAAC,IAAI,CAAC,4CAA4C,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;QAChF,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,KAAK,CAAC,+CAA+C,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QACtF,CAAC;QAED,MAAM,SAAS,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,gBAAgB,EAAE,EAAE;YAC7C,OAAO,EAAE,IAAK;YACd,QAAQ,EAAE,GAAG;YACb,SAAS,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,KAAK,EAAE;SAC/B,CAAC,CAAC;IACL,CAAC;IAED;;;OAGG;IACI,KAAK,CAAC,YAAY,CAAC,QAAgB;QACxC,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,WAAW,6BAA6B,EAAE;YAChG,OAAO,EAAE;gBACP,cAAc,EAAE,kBAAkB;gBAClC,MAAM,EAAE,kBAAkB;aAC3B;YACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;gBACnB,cAAc,EAAE,QAAQ;aACzB,CAAC;SACH,CAAC,CAAC;QAEH,IAAI,QAAQ,CAAC,MAAM,EAAE,KAAK,GAAG,EAAE,CAAC;YAC9B,OAAO,CAAC,IAAI,CAAC,uCAAuC,EAAE,MAAM,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;QACjF,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,KAAK,CAAC,0CAA0C,MAAM,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QACvF,CAAC;IACH,CAAC;CACF"}

package/dist/helpers/index.d.ts

@@ -1,3 +1,4 @@
 export * from './LoginHelper.js';
 export * from './PathResolver.js';
 export * from './RegexHelper.js';
+export * from './SubjectNavigator.js';

package/dist/helpers/index.js

@@ -1,4 +1,5 @@
 export * from './LoginHelper.js';
 export * from './PathResolver.js';
 export * from './RegexHelper.js';
+export * from './SubjectNavigator.js';
 //# sourceMappingURL=index.js.map

package/dist/helpers/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../helpers/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../helpers/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,uBAAuB,CAAC"}

package/dist/index.d.ts

@@ -1,28 +1,14 @@
-declare const originalLog: {
-    (...data: any[]): void;
-    (message?: any, ...optionalParams: any[]): void;
-};
-declare const originalInfo: {
-    (...data: any[]): void;
-    (message?: any, ...optionalParams: any[]): void;
-};
-declare const originalWarn: {
-    (...data: any[]): void;
-    (message?: any, ...optionalParams: any[]): void;
-};
-declare const originalError: {
-    (...data: any[]): void;
-    (message?: any, ...optionalParams: any[]): void;
-};
-declare const originalDebug: {
-    (...data: any[]): void;
-    (message?: any, ...optionalParams: any[]): void;
-};
+declare const originalLog: (...data: any[]) => void;
+declare const originalInfo: (...data: any[]) => void;
+declare const originalWarn: (...data: any[]) => void;
+declare const originalError: (...data: any[]) => void;
+declare const originalDebug: (...data: any[]) => void;
 export * from './artifact-builder/index.js';
 export * from './components/index.js';
 export * from './controls/index.js';
 export * from './enums/index.js';
 export * from './helpers/index.js';
+export * from './mcp/index.js';
 export * from './page-extensions/index.js';
 export * from './page-overrides/index.js';
 export * from './services/index.js';

package/dist/index.js

@@ -14,6 +14,7 @@ export * from './components/index.js';
 export * from './controls/index.js';
 export * from './enums/index.js';
 export * from './helpers/index.js';
+export * from './mcp/index.js';
 export * from './page-extensions/index.js';
 export * from './page-overrides/index.js';
 export * from './services/index.js';

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAE9C,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC;AAChC,MAAM,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;AAClC,MAAM,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;AAClC,MAAM,aAAa,GAAG,OAAO,CAAC,KAAK,CAAC;AACpC,MAAM,aAAa,GAAG,OAAO,CAAC,KAAK,CAAC;AAEpC,OAAO,CAAC,GAAG,GAAG,CAAC,GAAG,IAAe,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AACjE,OAAO,CAAC,IAAI,GAAG,CAAC,GAAG,IAAe,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AACnE,OAAO,CAAC,IAAI,GAAG,CAAC,GAAG,IAAe,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AACnE,OAAO,CAAC,KAAK,GAAG,CAAC,GAAG,IAAe,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AACrE,OAAO,CAAC,KAAK,GAAG,CAAC,GAAG,IAAe,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAErE,cAAc,6BAA6B,CAAC;AAC5C,cAAc,uBAAuB,CAAC;AACtC,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,qBAAqB,CAAC;AACpC,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC;AACjC,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAE9C,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC;AAChC,MAAM,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;AAClC,MAAM,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;AAClC,MAAM,aAAa,GAAG,OAAO,CAAC,KAAK,CAAC;AACpC,MAAM,aAAa,GAAG,OAAO,CAAC,KAAK,CAAC;AAEpC,OAAO,CAAC,GAAG,GAAG,CAAC,GAAG,IAAe,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AACjE,OAAO,CAAC,IAAI,GAAG,CAAC,GAAG,IAAe,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AACnE,OAAO,CAAC,IAAI,GAAG,CAAC,GAAG,IAAe,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AACnE,OAAO,CAAC,KAAK,GAAG,CAAC,GAAG,IAAe,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AACrE,OAAO,CAAC,KAAK,GAAG,CAAC,GAAG,IAAe,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAErE,cAAc,6BAA6B,CAAC;AAC5C,cAAc,uBAAuB,CAAC;AACtC,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,4BAA4B,CAAC;AAC3C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,qBAAqB,CAAC;AACpC,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC;AACjC,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,CAAC"}

package/dist/interfaces/IComponentObjects.d.ts

@@ -1,5 +1,17 @@
 import type { Locator } from '@playwright/test';
+/**
+ * Base contract that every `*Objects` class in `components/` and `controls/`
+ * must implement.
+ *
+ * **Why this exists:** Each component is split into two files — a `<Name>.ts`
+ * (public API with interaction methods) and a `<Name>Objects.ts` (raw locator
+ * accessors). `IComponentObjects` enforces that every `Objects` class exposes
+ * the two locators that all Thinkwise screens share: the scoped `context`
+ * locator and the page-level `mainHeader` locator used for presence checks.
+ */
 export interface IComponentObjects {
+    /** The scoped Playwright `Locator` that roots all locator lookups for this component instance. */
     context: Locator;
+    /** Locator for `main header` — used as a presence anchor to confirm the screen has rendered. */
     mainHeader: Locator;
 }

package/dist/interfaces/IComponentSchemaMeta.d.ts

@@ -0,0 +1,15 @@
+import type { SubjectComponents } from '../types/Components.js';
+/** Metadata for a single property within a generated component schema. */
+export interface IComponentPropertyMeta {
+    colId: string;
+    elementType: string;
+}
+/**
+ * The full meta file that SchemaGenerator writes alongside each `.json`
+ * schema file, and that SubjectComponentGenerator reads back to drive code
+ * generation.
+ */
+export interface IComponentSchemaMeta {
+    componentType: SubjectComponents;
+    properties: Record<string, IComponentPropertyMeta>;
+}

package/dist/interfaces/IComponentSchemaMeta.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=IComponentSchemaMeta.js.map

package/dist/interfaces/IComponentSchemaMeta.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IComponentSchemaMeta.js","sourceRoot":"","sources":["../../interfaces/IComponentSchemaMeta.ts"],"names":[],"mappings":""}

package/dist/interfaces/IProperty.d.ts

@@ -1,4 +1,17 @@
+/**
+ * Describes a single field or column on a Thinkwise screen, as returned by
+ * the Indicium API and stored in `seed-data/subjects.json`.
+ *
+ * The `control_type` drives which Testwise control helper gets generated for
+ * the property (e.g. `"field"` → `InputFieldControl`, `"lookup"` → `LookupDropdown`).
+ */
 export interface IProperty {
+    /** The field or column identifier as defined in the Thinkwise model (e.g. `"employee_id"`). */
     col: string;
+    /**
+     * The Thinkwise UI control type for this property.
+     * Drives the control class suffix appended in generated subject components.
+     * Common values: `"field"`, `"lookup"`, `"dropdown"`, `"checkbox"`, `"date_picker"`, `"combo_box"`.
+     */
     control_type: string;
 }

package/dist/interfaces/IRegisteredSubjects.d.ts

@@ -1,5 +1,17 @@
+/**
+ * Describes a subject that has been registered in the consumer project's
+ * `registeredSubjects.json` file.
+ *
+ * The `SubjectRegistration` pipeline step reads generated subject classes and
+ * writes an entry here for each one. The `SubjectRegistry` page-extension
+ * reads this file at test startup to make all subjects available on
+ * `page.subject.<ClassName>`.
+ */
 export interface IRegisteredSubjects {
+    /** Thinkwise subject identifier (e.g. `"Employee"`). */
     subject: string;
+    /** Optional variant discriminator when the same subject has multiple variants (e.g. `"Editable1"`). */
     variant?: string;
+    /** Screen type context — `"Main"`, `"Popup"`, `"Zoom"`, or `"Detail"`. */
     screen_type: string;
 }

package/dist/interfaces/ISeedSubjectDraft.d.ts

@@ -0,0 +1,16 @@
+import type { IProperty } from './IProperty.js';
+/**
+ * Represents a subject as it is built from the Indicium API before properties
+ * are fully populated. `properties` is optional here because it is assigned
+ * after the initial object is constructed during the build phase.
+ *
+ * Once written to `subjects.json` and read back via `DataRetriever`, the data
+ * is typed as the narrower `ISubject` (which requires `properties`).
+ */
+export interface ISeedSubjectDraft {
+    subject: string;
+    variant: string;
+    screentype_context: string;
+    screentype_id: string;
+    properties?: IProperty[];
+}

package/dist/interfaces/ISeedSubjectDraft.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=ISeedSubjectDraft.js.map

package/dist/interfaces/ISeedSubjectDraft.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ISeedSubjectDraft.js","sourceRoot":"","sources":["../../interfaces/ISeedSubjectDraft.ts"],"names":[],"mappings":""}

package/dist/interfaces/ISubject.d.ts

@@ -1,8 +1,21 @@
 import type { IProperty } from './IProperty.js';
+/**
+ * Represents a single Thinkwise subject as stored in `seed-data/subjects.json`
+ * after the `ModelDataBuilder` pipeline step fetches it from the Indicium API.
+ *
+ * Each subject maps to one screen variant in the Thinkwise application. The
+ * `SubjectClassModelBuilder` reads these records and turns them into generated
+ * TypeScript subject classes under `test-artifacts/subjects/`.
+ */
 export interface ISubject {
+    /** Internal Thinkwise subject identifier (e.g. `"Employee"`). */
     subject: string;
+    /** Subject variant, used to distinguish multiple configurations of the same subject (e.g. `"Editable1"`). */
     variant: string;
+    /** Human-readable screen context: `"Main"`, `"Popup"`, `"Zoom"`, or `"Detail"`. */
     screentype_context: string;
+    /** Thinkwise screen type identifier used to look up the correct screen schema file. */
     screentype_id: string;
+    /** All field/column properties available on this screen. */
     properties: IProperty[];
 }

package/dist/interfaces/ISubjectDetail.d.ts

@@ -0,0 +1,11 @@
+/** Screen context variants produced by the artifact-builder pipeline. */
+export type ScreenContext = 'Main' | 'Popup' | 'Zoom' | 'Detail';
+/**
+ * Describes a single generated subject class that the SubjectRegistration
+ * step registers in the SubjectRegistry.
+ */
+export interface ISubjectDetail {
+    subject: string;
+    variant?: string;
+    screen: ScreenContext;
+}

package/dist/interfaces/ISubjectDetail.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=ISubjectDetail.js.map

package/dist/interfaces/ISubjectDetail.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ISubjectDetail.js","sourceRoot":"","sources":["../../interfaces/ISubjectDetail.ts"],"names":[],"mappings":""}

package/dist/mcp/ArtifactResolver.d.ts

@@ -0,0 +1,152 @@
+import { PipelinePaths } from '../artifact-builder/helpers/PipelinePaths.js';
+import type { ScreenContext } from '../interfaces/ISubjectDetail.js';
+/** Describes a single generated subject class discovered in the test-artifacts directory. */
+export interface SubjectArtifactInfo {
+    /** PascalCase subject folder name (e.g. `"CustomerOrder"`). */
+    subject: string;
+    /** Exact generated class name (e.g. `"CustomerOrderMain"`). */
+    className: string;
+    /** Screen context encoded in the class name. */
+    screenContext: ScreenContext;
+    /**
+     * Module specifier that importing code should use, relative to the consumer
+     * project root (e.g. `"@thinkwise/testwise/test-artifacts/subjects/CustomerOrder/CustomerOrderMain.js"`).
+     */
+    importPath: string;
+}
+/** Describes a single field or column on a screen interface. */
+export interface ScreenFieldInfo {
+    /** camelCase property name as it appears on the screen interface (e.g. `"customerName"`, `"orderDate"`). */
+    propertyName: string;
+    /**
+     * Testwise control type suffix indicating which control helper to use
+     * (e.g. `"Field"`, `"Lookup"`, `"Dropdown"`, `"DatePicker"`, `"Checkbox"`, `"Textarea"`, `"ComboBox"`).
+     * Derived from the property name suffix in the generated interface.
+     */
+    controlType: string;
+    /** The component this field belongs to — `"Form"` or `"Grid"`. */
+    componentType: 'Form' | 'Grid';
+}
+/** Describes a single typed component property on a generated subject class. */
+export interface ComponentInfo {
+    /** camelCase property name as declared on the subject class (e.g. `"grid"`, `"actionBar"`). */
+    propertyName: string;
+    /** Testwise component class name (e.g. `"Grid"`, `"ActionBar"`, `"Form"`). */
+    componentType: string;
+}
+/**
+ * Runtime service that reads the generated test-artifact files to answer
+ * questions about available subjects, their screen-context variants, and the
+ * components exposed on each subject class.
+ *
+ * Intended to be used by the `@thinkwise/testwise-mcp` server so that AI
+ * tooling can discover the correct class names and component properties before
+ * generating test code — without having to guess or hallucinate names.
+ */
+/**
+ * Runtime service that reads the generated test-artifact files to answer
+ * questions about available subjects, their screen-context variants, and the
+ * components exposed on each subject class.
+ *
+ * **What it does:** The `@thinkwise/testwise-mcp` MCP server calls these
+ * methods to surface information to AI tooling (e.g. GitHub Copilot agents)
+ * so the AI can write correct Testwise tests without guessing class names,
+ * property names, or field names.
+ *
+ * **How to use it (as a consumer of the MCP server):** You don't call this
+ * class directly — use the MCP tools:
+ * - `list_subjects()` — all available subject folder names
+ * - `list_artifacts(subject?, screenContext?)` — exact class names + import paths
+ * - `get_components(subject, screenContext)` — component properties on a class
+ * - `get_screen_interface(subject, screenContext)` — field/column names + control types
+ *
+ * **For contributors:** This class is intentionally side-effect-free — it
+ * only reads files and never writes anything. Do not add browser-interaction
+ * logic here.
+ *
+ * @example
+ * // Used internally by the MCP server:
+ * const resolver = new ArtifactResolver();
+ * const subjects = resolver.listSubjects();
+ * const artifacts = resolver.listArtifacts('Employee', 'Main');
+ */
+export declare class ArtifactResolver {
+    private readonly _paths;
+    constructor(paths?: PipelinePaths);
+    /**
+     * Returns all subject folder names (PascalCase) that have been generated
+     * into the test-artifacts directory.
+     *
+     * @example
+     * resolver.listSubjects();
+     * // → ["CustomerOrder", "Product", "Employee"]
+     */
+    listSubjects(): string[];
+    /**
+     * Returns all artifacts for the given subject, optionally filtered to a
+     * specific screen context.
+     *
+     * When `subject` is omitted every generated artifact is returned.
+     *
+     * @example
+     * // All screen contexts for one subject
+     * resolver.listArtifacts('CustomerOrder');
+     * // → [{ className: "CustomerOrderMain", screenContext: "Main", ... }, ...]
+     *
+     * @example
+     * // One specific artifact
+     * resolver.listArtifacts('CustomerOrder', 'Main');
+     * // → [{ className: "CustomerOrderMain", screenContext: "Main", ... }]
+     */
+    listArtifacts(subject?: string, screenContext?: ScreenContext): SubjectArtifactInfo[];
+    /**
+     * Returns the typed component properties declared on the generated subject
+     * class for the given subject + screen context combination.
+     *
+     * @example
+     * resolver.getComponents('CustomerOrder', 'Main');
+     * // → [
+     * //   { propertyName: "grid",      componentType: "Grid"      },
+     * //   { propertyName: "actionBar", componentType: "ActionBar" },
+     * //   { propertyName: "filterForm",componentType: "FilterForm"},
+     * // ]
+     */
+    getComponents(subject: string, screenContext: ScreenContext): ComponentInfo[];
+    /**
+     * Returns all fields and columns declared on the generated screen interface
+     * for the given subject + screen context combination.
+     *
+     * The interface lives in `test-artifacts/screens/` and contains every field
+     * name, column name, and control type for the screen — enough for an AI to
+     * write a complete, accurate test without inspecting a live browser.
+     *
+     * @example
+     * resolver.getScreenInterface('CustomerOrder', 'Main');
+     * // → [
+     * //   { propertyName: "customerName", controlType: "Field",      componentType: "Form" },
+     * //   { propertyName: "orderDate",    controlType: "DatePicker",  componentType: "Form" },
+     * //   { propertyName: "status",       controlType: "Lookup",      componentType: "Form" },
+     * //   { propertyName: "orderId",      controlType: "Column",      componentType: "Grid" },
+     * // ]
+     */
+    getScreenInterface(subject: string, screenContext: ScreenContext): ScreenFieldInfo[];
+    private inferScreenContext;
+    /**
+     * Parses component properties from a generated subject class.
+     *
+     * Generated classes declare properties without `public`:
+     *   actionBarVXE6V0YT: ActionBar;
+     *   gridQT3UL7F8: EmployeeGrid;
+     */
+    private parseComponentProperties;
+    /**
+     * Parses fields/columns from the Components/ subfolder files for a subject.
+     *
+     * Generated component files (e.g. EmployeeGrid.ts, EmployeeForm.ts) declare
+     * getters like:
+     *   public get firstNameColumn(): IGridColumnControl { ... }
+     *   public get firstNameField(): IInputFieldControl { ... }
+     */
+    private parseScreenInterface;
+    private inferControlType;
+}