@thinkwise/testwise 0.2.67 → 0.2.99

package/dist/helpers/LoginHelper.js

@@ -5,10 +5,22 @@ import { testwiseConfig } from '../services/ConfigBuilder.js';
 import { pollUntil } from './Poll.js';
 const dirname = path.dirname(fileURLToPath(import.meta.url));
 const configFixture = JSON.parse(fs.readFileSync(path.resolve(dirname, '../../config.json'), 'utf-8'));
+/**
+ * Handles authentication against the Thinkwise Indicium API and the
+ * web application login screen.
+ *
+ * Exposed on the page fixture via `LoginFeatures` as `page.logIn()`,
+ * `page.logInWithCredentials()`, `page.logInWithOptions()`, and `page.logOut()`.
+ * You do not instantiate `LoginHelper` directly in tests.
+ *
+ * Credentials are read from `Testwise.json` (`environmentSettings.username`
+ * and `environmentSettings.password`) by default, and can be overridden
+ * per-call via `logInWithCredentials()` or `logInWithOptions()`.
+ */
 export class LoginHelper {
     constructor(page) {
-        this.serviceUrl = String(testwiseConfig().get('environmentSettings.serviceUrl'));
-        this.metaEndpoint = String(testwiseConfig().get('environmentSettings.metaEndpoint'));
+        this.serviceUrl = String(testwiseConfig().get('environmentSettings.serviceUrl')).replace(/\/+$/, '');
+        this.metaEndpoint = String(testwiseConfig().get('environmentSettings.metaEndpoint')).replace(/\/+$/, '');
         if (!this.serviceUrl || this.serviceUrl === 'undefined')
             throw new Error('Service URL not found');
         if (!this.metaEndpoint || this.metaEndpoint === 'undefined')
@@ -46,18 +58,19 @@ export class LoginHelper {
         await this.logInAndConfigureApplication(options);
     }
     /**
-     * Navigate to the home page and wait for the menu to load
+     * Navigate to the home page and wait for the menu to load.
      */
     async navigateHomeAndWaitForMenuToLoad() {
-        const baseUrl = testwiseConfig().get('environmentSettings.baseUrl');
+        const baseUrl = testwiseConfig().get('environmentSettings.baseUrl')?.replace(/\/+$/, '');
+        const minimumTimeout = 60000;
         if (!baseUrl) {
             throw new Error('Base URL is not defined in the configuration.');
         }
+        let timeout = Number(testwiseConfig().get('featureSettings.other.loginTimeout') ?? minimumTimeout);
+        if (Number.isNaN(timeout) || timeout < minimumTimeout) {
+            timeout = minimumTimeout;
+        }
         await this._page.goto(baseUrl);
-        await this._page.route('**/i_ui_menu?**', (route) => {
-            route.continue();
-        });
-        const timeout = Number(testwiseConfig().get('featureSettings.other.loginTimeout') ?? 30000);
         await pollUntil(async () => this._page.url().includes('#application='), {
             timeout,
             interval: 200,
@@ -76,8 +89,8 @@ export class LoginHelper {
             throw new Error('Username and password are required for login.');
         }
         if (serviceUrl && metaEndpoint) {
-            this.serviceUrl = serviceUrl;
-            this.metaEndpoint = metaEndpoint;
+            this.serviceUrl = serviceUrl.replace(/\/+$/, '');
+            this.metaEndpoint = metaEndpoint.replace(/\/+$/, '');
         }
         const response = await this._page.request.post(`${this.serviceUrl}/account/api/login`, {
             form: {
@@ -137,6 +150,10 @@ export class LoginHelper {
             });
         });
     }
+    /**
+     * Logs out the current session by POSTing to the logout endpoint (accepts 204 or 401
+     * as valid responses), then clears all browser cookies.
+     */
     async logOut() {
         const response = await this._page.request.post(`${this.serviceUrl}/account/api/logout`);
         if (![204, 401].includes(response.status())) {
@@ -146,6 +163,14 @@ export class LoginHelper {
     }
 }
 export class UserPreferences {
+    /**
+     * Initialises the `UserPreferences` service, resolving the service URL, meta endpoint,
+     * and GUI application alias from config (overridable via optional parameters) and
+     * constructing the full Indicium endpoint URL.
+     * @param requestContext - The Playwright `Page` used to make API requests.
+     * @param serviceUrl - Optional override for the service URL from config.
+     * @param metaEndpoint - Optional override for the meta endpoint from config.
+     */
     constructor(requestContext, serviceUrl, metaEndpoint) {
         this.guiApplAlias = String(testwiseConfig().get('environmentSettings.guiApplAlias'));
         this._page = requestContext;
@@ -157,8 +182,13 @@ export class UserPreferences {
             throw new Error('Meta endpoint not found or is empty');
         if (!this.guiApplAlias)
             throw new Error('GUI application alias not found or is empty');
-        this.url = `${serviceUrl}/${metaEndpoint}/${this.guiApplAlias}`;
+        this.url = `${serviceUrl.replace(/\/+$/, '')}/${metaEndpoint.replace(/\/+$/, '')}/${this.guiApplAlias}`;
     }
+    /**
+     * Activates a specific user preference configuration for the current session by POSTing
+     * to the `set_up_configuration` endpoint with the given configuration ID.
+     * @param upConfigurationId - The ID of the user preference configuration to activate.
+     */
     async run(upConfigurationId) {
         const fullUrl = `${this.url}/set_up_configuration`;
         const data = {
@@ -166,6 +196,11 @@ export class UserPreferences {
         };
         await this._page.request.post(fullUrl, { headers: { 'Content-Type': 'application/json; charset=utf-8' }, data });
     }
+    /**
+     * Disables all active user preferences for the current session by POSTing to the
+     * `disable_up` endpoint.
+     * @returns The raw Playwright `APIResponse`.
+     */
     async disable() {
         const fullUrl = `${this.url}/disable_up`;
         return await this._page.request.post(fullUrl, { headers: { 'Content-Type': 'application/json; charset=utf-8' } });

package/dist/helpers/LoginHelper.js.map

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

package/dist/helpers/PathResolver.d.ts

@@ -1,3 +1,25 @@
+/**
+ * Locates the root directory of the **consumer project** (the project that has
+ * `@thinkwise/testwise` installed as a dependency) at runtime.
+ *
+ * **Why this exists:** Testwise runs from inside `node_modules` but needs to
+ * read and write files that belong to the consuming project (e.g.
+ * `registeredSubjects.json`, `Testwise.json`). Simply using `process.cwd()`
+ * is unreliable when scripts are invoked from sub-directories. This class
+ * walks up the directory tree looking for the first `package.json` whose
+ * `name` is NOT `@thinkwise/testwise`, which is guaranteed to be the consumer
+ * project root.
+ *
+ * **How to use it:** Inject it into any pipeline helper that needs to write
+ * to the consumer project. `PipelinePaths` already does this — you rarely
+ * need to instantiate `PathResolver` directly.
+ */
 export declare class PathResolver {
+    /**
+     * Walks up the directory tree from `process.cwd()` to find the nearest `package.json`
+     * whose `name` is not `@thinkwise/testwise`, returning that directory as the consumer
+     * project root. Falls back to `process.cwd()` if no such package is found.
+     * @returns Absolute path to the consumer project's root directory.
+     */
     getConsumerRootDirectory(): string;
 }

package/dist/helpers/PathResolver.js

@@ -1,6 +1,28 @@
 import fs from 'node:fs';
 import path from 'node:path';
+/**
+ * Locates the root directory of the **consumer project** (the project that has
+ * `@thinkwise/testwise` installed as a dependency) at runtime.
+ *
+ * **Why this exists:** Testwise runs from inside `node_modules` but needs to
+ * read and write files that belong to the consuming project (e.g.
+ * `registeredSubjects.json`, `Testwise.json`). Simply using `process.cwd()`
+ * is unreliable when scripts are invoked from sub-directories. This class
+ * walks up the directory tree looking for the first `package.json` whose
+ * `name` is NOT `@thinkwise/testwise`, which is guaranteed to be the consumer
+ * project root.
+ *
+ * **How to use it:** Inject it into any pipeline helper that needs to write
+ * to the consumer project. `PipelinePaths` already does this — you rarely
+ * need to instantiate `PathResolver` directly.
+ */
 export class PathResolver {
+    /**
+     * Walks up the directory tree from `process.cwd()` to find the nearest `package.json`
+     * whose `name` is not `@thinkwise/testwise`, returning that directory as the consumer
+     * project root. Falls back to `process.cwd()` if no such package is found.
+     * @returns Absolute path to the consumer project's root directory.
+     */
     getConsumerRootDirectory() {
         let directory = process.cwd();
         let lastDir = '';

package/dist/helpers/PathResolver.js.map

@@ -1 +1 @@
-{"version":3,"file":"PathResolver.js","sourceRoot":"","sources":["../../helpers/PathResolver.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,MAAM,OAAO,YAAY;IAChB,wBAAwB;QAC7B,IAAI,SAAS,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;QAC9B,IAAI,OAAO,GAAG,EAAE,CAAC;QACjB,IAAI,KAAK,GAAG,KAAK,CAAC;QAElB,OAAO,SAAS,KAAK,OAAO,EAAE,CAAC;YAC7B,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,cAAc,CAAC,CAAC;YAErD,IAAI,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;gBAC3B,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;gBAC1D,IAAI,GAAG,CAAC,IAAI,KAAK,qBAAqB,EAAE,CAAC;oBACvC,KAAK,GAAG,IAAI,CAAC;oBACb,MAAM;gBACR,CAAC;YACH,CAAC;YAED,OAAO,GAAG,SAAS,CAAC;YACpB,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QACtC,CAAC;QACD,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,SAAS,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;QAC5B,CAAC;QAED,OAAO,SAAS,CAAC;IACnB,CAAC;CACF"}
+{"version":3,"file":"PathResolver.js","sourceRoot":"","sources":["../../helpers/PathResolver.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B;;;;;;;;;;;;;;;GAeG;AACH,MAAM,OAAO,YAAY;IACvB;;;;;OAKG;IACI,wBAAwB;QAC7B,IAAI,SAAS,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;QAC9B,IAAI,OAAO,GAAG,EAAE,CAAC;QACjB,IAAI,KAAK,GAAG,KAAK,CAAC;QAElB,OAAO,SAAS,KAAK,OAAO,EAAE,CAAC;YAC7B,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,cAAc,CAAC,CAAC;YAErD,IAAI,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;gBAC3B,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;gBAC1D,IAAI,GAAG,CAAC,IAAI,KAAK,qBAAqB,EAAE,CAAC;oBACvC,KAAK,GAAG,IAAI,CAAC;oBACb,MAAM;gBACR,CAAC;YACH,CAAC;YAED,OAAO,GAAG,SAAS,CAAC;YACpB,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QACtC,CAAC;QACD,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,SAAS,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;QAC5B,CAAC;QAED,OAAO,SAAS,CAAC;IACnB,CAAC;CACF"}

package/dist/helpers/Poll.d.ts

@@ -1,2 +1,14 @@
-import type { PollOptions } from '../types/PollTypes.ts';
+import type { PollOptions } from '../types/PollTypes.js';
+/**
+ * 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 declare function pollUntil<T>(fn: () => Promise<T> | T, opts?: PollOptions<T>): Promise<T>;

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":""}