@thinkwise/testwise 0.2.62 → 0.2.99

package/dist/mcp/ArtifactResolver.js

@@ -0,0 +1,232 @@
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { PipelinePaths } from '../artifact-builder/helpers/PipelinePaths.js';
+/** All known screen context suffixes, ordered longest-first to avoid prefix clashes. */
+const screenContexts = ['Detail', 'Popup', 'Main', 'Zoom'];
+/**
+ * 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 class ArtifactResolver {
+    constructor(paths) {
+        this._paths = paths ?? new PipelinePaths();
+    }
+    /**
+     * Returns all subject folder names (PascalCase) that have been generated
+     * into the test-artifacts directory.
+     *
+     * @example
+     * resolver.listSubjects();
+     * // → ["CustomerOrder", "Product", "Employee"]
+     */
+    listSubjects() {
+        const subjectsDir = this._paths.subjects;
+        if (!fs.existsSync(subjectsDir))
+            return [];
+        return fs.readdirSync(subjectsDir).filter((entry) => fs.statSync(path.join(subjectsDir, entry)).isDirectory());
+    }
+    /**
+     * 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, screenContext) {
+        const subjects = subject ? [subject] : this.listSubjects();
+        const results = [];
+        for (const subjectName of subjects) {
+            const subjectDir = path.join(this._paths.subjects, subjectName);
+            if (!fs.existsSync(subjectDir))
+                continue;
+            const files = fs.readdirSync(subjectDir).filter((f) => f.endsWith('.ts') && f !== 'index.ts');
+            for (const file of files) {
+                const className = file.replace('.ts', '');
+                const context = this.inferScreenContext(className);
+                if (!context)
+                    continue;
+                if (screenContext && context !== screenContext)
+                    continue;
+                results.push({
+                    subject: subjectName,
+                    className,
+                    screenContext: context,
+                    importPath: `@thinkwise/testwise/test-artifacts/subjects/${subjectName}/${className}.js`
+                });
+            }
+        }
+        return results;
+    }
+    /**
+     * 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, screenContext) {
+        const artifacts = this.listArtifacts(subject, screenContext);
+        if (artifacts.length === 0)
+            return [];
+        const filePath = path.join(this._paths.subjects, subject, `${artifacts[0].className}.ts`);
+        if (!fs.existsSync(filePath))
+            return [];
+        return this.parseComponentProperties(fs.readFileSync(filePath, 'utf-8'));
+    }
+    /**
+     * 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, screenContext) {
+        const artifacts = this.listArtifacts(subject, screenContext);
+        if (artifacts.length === 0)
+            return [];
+        // Component files live in Components/ subfolder under the subject folder
+        const componentsDir = path.join(this._paths.subjects, subject, 'Components');
+        if (!fs.existsSync(componentsDir))
+            return [];
+        const results = [];
+        const componentFiles = fs.readdirSync(componentsDir).filter((f) => f.endsWith('.ts'));
+        for (const file of componentFiles) {
+            const content = fs.readFileSync(path.join(componentsDir, file), 'utf-8');
+            const interfaceName = file.replace('.ts', '');
+            const fields = this.parseScreenInterface(content, interfaceName);
+            results.push(...fields);
+        }
+        return results;
+    }
+    // ── Private helpers ────────────────────────────────────────────────────────
+    inferScreenContext(className) {
+        for (const ctx of screenContexts) {
+            if (className.endsWith(ctx))
+                return ctx;
+        }
+        return undefined;
+    }
+    /**
+     * Parses component properties from a generated subject class.
+     *
+     * Generated classes declare properties without `public`:
+     *   actionBarVXE6V0YT: ActionBar;
+     *   gridQT3UL7F8: EmployeeGrid;
+     */
+    parseComponentProperties(content) {
+        const results = [];
+        // Match class-body property declarations: "  name: Type;" (no public keyword)
+        // Excludes private fields (_name), constructor, and method declarations
+        const propertyRegex = /^\s{4}(\w+)\s*:\s*(\w+)\s*;/gm;
+        for (let match = propertyRegex.exec(content); match !== null; match = propertyRegex.exec(content)) {
+            const propertyName = match[1];
+            const componentType = match[2];
+            if (propertyName.startsWith('_'))
+                continue;
+            if (['string', 'number', 'boolean', 'Page', 'Locator'].includes(componentType))
+                continue;
+            results.push({ propertyName, componentType });
+        }
+        return results;
+    }
+    /**
+     * 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 { ... }
+     */
+    parseScreenInterface(content, interfaceName) {
+        const results = [];
+        // Match readonly interface members: "  readonly bioColumn: IGridColumnControl;"
+        const interfaceRegex = /^\s+readonly\s+(\w+)\s*:\s*(I?\w+Control)\s*;/gm;
+        for (let match = interfaceRegex.exec(content); match !== null; match = interfaceRegex.exec(content)) {
+            const propertyName = match[1];
+            const rawType = match[2];
+            const controlType = this.inferControlType(rawType, propertyName);
+            const componentType = interfaceName.toLowerCase().includes('grid') ? 'Grid' : 'Form';
+            results.push({ propertyName, controlType, componentType: componentType });
+        }
+        return results;
+    }
+    inferControlType(rawType, propertyName) {
+        const typeMap = {
+            IGridColumnControl: 'Column',
+            GridColumnControl: 'Column',
+            IInputFieldControl: 'Field',
+            InputFieldControl: 'Field',
+            ILookupDropdown: 'Lookup',
+            LookupDropdown: 'Lookup',
+            IFormComboBox: 'ComboBox',
+            FormComboBox: 'ComboBox',
+            IDateControl: 'DatePicker',
+            DateControl: 'DatePicker',
+            ICheckboxControl: 'Checkbox',
+            CheckboxControl: 'Checkbox',
+            ITextareaControl: 'Textarea',
+            TextareaControl: 'Textarea'
+        };
+        if (typeMap[rawType])
+            return typeMap[rawType];
+        const suffixMatch = propertyName.match(/(Field|Lookup|Dropdown|DatePicker|Checkbox|Textarea|ComboBox|Column)$/i);
+        return suffixMatch ? suffixMatch[1] : rawType;
+    }
+}
+//# sourceMappingURL=ArtifactResolver.js.map

package/dist/mcp/ArtifactResolver.js.map

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

package/dist/mcp/index.d.ts

@@ -0,0 +1,2 @@
+export type { ComponentInfo, ScreenFieldInfo, SubjectArtifactInfo } from './ArtifactResolver.js';
+export { ArtifactResolver } from './ArtifactResolver.js';

package/dist/mcp/index.js

@@ -0,0 +1,2 @@
+export { ArtifactResolver } from './ArtifactResolver.js';
+//# sourceMappingURL=index.js.map

package/dist/mcp/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../mcp/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC"}

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

@@ -1,6 +1,27 @@
 import type { Page } from '@playwright/test';
 import { ExportComponent, ListBarMenuComponent, ManagePrefilterPopup, PopUpComponent, SnackBarComponent, TopBarComponent } from '../components/index.js';
 import type { Test } from '../types/Test.js';
+/**
+ * Holds pre-constructed instances of the Thinkwise UI components that are
+ * present globally across all screens (not tied to any specific subject).
+ *
+ * Accessed via `page.components` in tests. Available properties:
+ * - `popUp` — the main overlay/modal dialog
+ * - `export` — the export panel triggered from a grid or list
+ * - `snackBar` — the toast notification bar
+ * - `topBar` — the application top bar (breadcrumbs, user menu)
+ * - `listBarMenu` — the hamburger / list-bar dropdown menu
+ * - `managePrefilterPopup` — the "Manage prefilter" popup dialog
+ *
+ * @example
+ * ```ts
+ * // Confirm a save popup:
+ * await page.components.popUp.confirm();
+ *
+ * // Check a snackbar message:
+ * await expect(page.components.snackBar.message).toHaveText('Saved successfully');
+ * ```
+ */
 declare class GlobalComponents {
     popUp: PopUpComponent;
     export: ExportComponent;
@@ -17,7 +38,16 @@ declare module '@playwright/test' {
 }
 export declare class Components {
     private _test;
+    /**
+     * Extends the Playwright `Test` fixture to attach a `GlobalComponents` instance to
+     * `page.components` before each test, providing access to shared UI components
+     * such as `popUp`, `export`, `snackBar`, `topBar`, `listBarMenu`, and `managePrefilterPopup`.
+     * @param test - The Playwright `Test` fixture to extend.
+     */
     constructor(test: Test);
+    /**
+     * Returns the extended `Test` fixture with `page.components` wired up.
+     */
     get test(): Test;
 }
 export {};

package/dist/page-extensions/GlobalComponents.js

@@ -1,4 +1,25 @@
 import { ExportComponent, ListBarMenuComponent, ManagePrefilterPopup, PopUpComponent, SnackBarComponent, TopBarComponent } from '../components/index.js';
+/**
+ * Holds pre-constructed instances of the Thinkwise UI components that are
+ * present globally across all screens (not tied to any specific subject).
+ *
+ * Accessed via `page.components` in tests. Available properties:
+ * - `popUp` — the main overlay/modal dialog
+ * - `export` — the export panel triggered from a grid or list
+ * - `snackBar` — the toast notification bar
+ * - `topBar` — the application top bar (breadcrumbs, user menu)
+ * - `listBarMenu` — the hamburger / list-bar dropdown menu
+ * - `managePrefilterPopup` — the "Manage prefilter" popup dialog
+ *
+ * @example
+ * ```ts
+ * // Confirm a save popup:
+ * await page.components.popUp.confirm();
+ *
+ * // Check a snackbar message:
+ * await expect(page.components.snackBar.message).toHaveText('Saved successfully');
+ * ```
+ */
 class GlobalComponents {
     constructor(page) {
         this.popUp = new PopUpComponent(page);
@@ -10,6 +31,12 @@ class GlobalComponents {
     }
 }
 export class Components {
+    /**
+     * Extends the Playwright `Test` fixture to attach a `GlobalComponents` instance to
+     * `page.components` before each test, providing access to shared UI components
+     * such as `popUp`, `export`, `snackBar`, `topBar`, `listBarMenu`, and `managePrefilterPopup`.
+     * @param test - The Playwright `Test` fixture to extend.
+     */
     constructor(test) {
         this._test = test.extend({
             page: async ({ page }, use) => {
@@ -18,6 +45,9 @@ export class Components {
             }
         });
     }
+    /**
+     * Returns the extended `Test` fixture with `page.components` wired up.
+     */
     get test() {
         return this._test;
     }

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

@@ -1 +1 @@
-{"version":3,"file":"GlobalComponents.js","sourceRoot":"","sources":["../../page-extensions/GlobalComponents.ts"],"names":[],"mappings":"AACA,OAAO,EACL,eAAe,EACf,oBAAoB,EACpB,oBAAoB,EACpB,cAAc,EACd,iBAAiB,EACjB,eAAe,EAChB,MAAM,wBAAwB,CAAC;AAGhC,MAAM,gBAAgB;IAQpB,YAAY,IAAU;QACpB,IAAI,CAAC,KAAK,GAAG,IAAI,cAAc,CAAC,IAAI,CAAC,CAAC;QACtC,IAAI,CAAC,MAAM,GAAG,IAAI,eAAe,CAAC,IAAI,CAAC,CAAC;QACxC,IAAI,CAAC,QAAQ,GAAG,IAAI,iBAAiB,CAAC,IAAI,CAAC,CAAC;QAC5C,IAAI,CAAC,MAAM,GAAG,IAAI,eAAe,CAAC,IAAI,CAAC,CAAC;QACxC,IAAI,CAAC,WAAW,GAAG,IAAI,oBAAoB,CAAC,IAAI,CAAC,CAAC;QAClD,IAAI,CAAC,oBAAoB,GAAG,IAAI,oBAAoB,CAAC,IAAI,CAAC,CAAC;IAC7D,CAAC;CACF;AAQD,MAAM,OAAO,UAAU;IAGrB,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,UAAU,GAAG,IAAI,gBAAgB,CAAC,IAAI,CAAC,CAAC;gBAE7C,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":"GlobalComponents.js","sourceRoot":"","sources":["../../page-extensions/GlobalComponents.ts"],"names":[],"mappings":"AACA,OAAO,EACL,eAAe,EACf,oBAAoB,EACpB,oBAAoB,EACpB,cAAc,EACd,iBAAiB,EACjB,eAAe,EAChB,MAAM,wBAAwB,CAAC;AAGhC;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,gBAAgB;IAQpB,YAAY,IAAU;QACpB,IAAI,CAAC,KAAK,GAAG,IAAI,cAAc,CAAC,IAAI,CAAC,CAAC;QACtC,IAAI,CAAC,MAAM,GAAG,IAAI,eAAe,CAAC,IAAI,CAAC,CAAC;QACxC,IAAI,CAAC,QAAQ,GAAG,IAAI,iBAAiB,CAAC,IAAI,CAAC,CAAC;QAC5C,IAAI,CAAC,MAAM,GAAG,IAAI,eAAe,CAAC,IAAI,CAAC,CAAC;QACxC,IAAI,CAAC,WAAW,GAAG,IAAI,oBAAoB,CAAC,IAAI,CAAC,CAAC;QAClD,IAAI,CAAC,oBAAoB,GAAG,IAAI,oBAAoB,CAAC,IAAI,CAAC,CAAC;IAC7D,CAAC;CACF;AAQD,MAAM,OAAO,UAAU;IAGrB;;;;;OAKG;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,UAAU,GAAG,IAAI,gBAAgB,CAAC,IAAI,CAAC,CAAC;gBAE7C,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-extensions/GoToDeepLink.d.ts

@@ -6,6 +6,15 @@ declare module '@playwright/test' {
 }
 export declare class GoToDeepLink {
     private _test;
+    /**
+     * Extends the Playwright `Test` fixture to add a `page.goToDeepLink(deepLink)` method.
+     * The method preserves the current `#application=` hash segment and appends the given
+     * deep link path before navigating to the resulting URL.
+     * @param test - The Playwright `Test` fixture to extend.
+     */
     constructor(test: Test);
+    /**
+     * Returns the extended `Test` fixture with `page.goToDeepLink` wired up.
+     */
     get test(): Test;
 }

package/dist/page-extensions/GoToDeepLink.js

@@ -1,4 +1,10 @@
 export class GoToDeepLink {
+    /**
+     * Extends the Playwright `Test` fixture to add a `page.goToDeepLink(deepLink)` method.
+     * The method preserves the current `#application=` hash segment and appends the given
+     * deep link path before navigating to the resulting URL.
+     * @param test - The Playwright `Test` fixture to extend.
+     */
     constructor(test) {
         this._test = test.extend({
             page: async ({ page }, use) => {
@@ -24,6 +30,9 @@ export class GoToDeepLink {
             }
         });
     }
+    /**
+     * Returns the extended `Test` fixture with `page.goToDeepLink` wired up.
+     */
     get test() {
         return this._test;
     }

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

@@ -1 +1 @@
-{"version":3,"file":"GoToDeepLink.js","sourceRoot":"","sources":["../../page-extensions/GoToDeepLink.ts"],"names":[],"mappings":"AAQA,MAAM,OAAO,YAAY;IAGvB,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,YAAY,GAAG,KAAK,EAAE,QAAgB,EAAuD,EAAE;oBAClG,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,MAAM,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;oBACtC,MAAM,gBAAgB,GAAG,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC;oBAE3D,IAAI,gBAAgB,KAAK,CAAC,CAAC,EAAE,CAAC;wBAC5B,MAAM,gBAAgB,GAAG,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,gBAAgB,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;wBACrG,GAAG,CAAC,IAAI,GAAG,gBAAgB,gBAAgB,EAAE,CAAC;oBAChD,CAAC;oBAED,IAAI,QAAQ,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;wBAC7B,QAAQ,GAAG,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;oBACnC,CAAC;oBAED,IAAI,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;wBAC3B,GAAG,CAAC,IAAI,IAAI,QAAQ,CAAC;oBACvB,CAAC;yBAAM,CAAC;wBACN,GAAG,CAAC,IAAI,IAAI,IAAI,QAAQ,EAAE,CAAC;oBAC7B,CAAC;oBAED,OAAO,MAAM,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC,CAAC;gBACzC,CAAC,CAAC;gBAEF,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":"GoToDeepLink.js","sourceRoot":"","sources":["../../page-extensions/GoToDeepLink.ts"],"names":[],"mappings":"AAQA,MAAM,OAAO,YAAY;IAGvB;;;;;OAKG;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,YAAY,GAAG,KAAK,EAAE,QAAgB,EAAuD,EAAE;oBAClG,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,MAAM,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;oBACtC,MAAM,gBAAgB,GAAG,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC;oBAE3D,IAAI,gBAAgB,KAAK,CAAC,CAAC,EAAE,CAAC;wBAC5B,MAAM,gBAAgB,GAAG,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,gBAAgB,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;wBACrG,GAAG,CAAC,IAAI,GAAG,gBAAgB,gBAAgB,EAAE,CAAC;oBAChD,CAAC;oBAED,IAAI,QAAQ,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;wBAC7B,QAAQ,GAAG,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;oBACnC,CAAC;oBAED,IAAI,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;wBAC3B,GAAG,CAAC,IAAI,IAAI,QAAQ,CAAC;oBACvB,CAAC;yBAAM,CAAC;wBACN,GAAG,CAAC,IAAI,IAAI,IAAI,QAAQ,EAAE,CAAC;oBAC7B,CAAC;oBAED,OAAO,MAAM,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC,CAAC;gBACzC,CAAC,CAAC;gBAEF,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-extensions/LoginFeatures.d.ts

@@ -11,7 +11,15 @@ declare module '@playwright/test' {
 export declare class LoginFeatures {
     private _loginHelper;
     private _test;
+    /**
+     * Extends the Playwright `Test` fixture to attach `logIn`, `logInWithCredentials`,
+     * `logInWithOptions`, and `logOut` methods to the page, backed by `LoginHelper`.
+     * @param test - The Playwright `Test` fixture to extend.
+     */
     constructor(test: Test);
     private get loginHelper();
+    /**
+     * Returns the extended `Test` fixture with login methods wired up on `page`.
+     */
     get test(): Test;
 }

package/dist/page-extensions/LoginFeatures.js

@@ -1,5 +1,10 @@
 import { LoginHelper } from '../helpers/LoginHelper.js';
 export class LoginFeatures {
+    /**
+     * Extends the Playwright `Test` fixture to attach `logIn`, `logInWithCredentials`,
+     * `logInWithOptions`, and `logOut` methods to the page, backed by `LoginHelper`.
+     * @param test - The Playwright `Test` fixture to extend.
+     */
     constructor(test) {
         this._test = test.extend({
             page: async ({ page }, use) => {
@@ -26,6 +31,9 @@ export class LoginFeatures {
         }
         return this._loginHelper;
     }
+    /**
+     * Returns the extended `Test` fixture with login methods wired up on `page`.
+     */
     get test() {
         return this._test;
     }

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

@@ -1 +1 @@
-{"version":3,"file":"LoginFeatures.js","sourceRoot":"","sources":["../../page-extensions/LoginFeatures.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAaxD,MAAM,OAAO,aAAa;IAIxB,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,YAAY,GAAG,IAAI,WAAW,CAAC,IAAI,CAAC,CAAC;gBAE1C,IAAI,CAAC,KAAK,GAAG,KAAK,EAAE,aAAsB,EAAE,EAAE;oBAC5C,MAAM,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;gBAC9C,CAAC,CAAC;gBAEF,IAAI,CAAC,oBAAoB,GAAG,KAAK,EAAE,QAAgB,EAAE,QAAgB,EAAE,EAAE;oBACvE,MAAM,IAAI,CAAC,WAAW,CAAC,oBAAoB,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;gBAClE,CAAC,CAAC;gBAEF,IAAI,CAAC,gBAAgB,GAAG,KAAK,EAAE,OAA8B,EAAE,EAAE;oBAC/D,MAAM,IAAI,CAAC,WAAW,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC;gBACnD,CAAC,CAAC;gBAEF,IAAI,CAAC,MAAM,GAAG,KAAK,IAAI,EAAE;oBACvB,MAAM,IAAI,CAAC,WAAW,CAAC,MAAM,EAAE,CAAC;gBAClC,CAAC,CAAC;gBAEF,MAAM,GAAG,CAAC,IAAI,CAAC,CAAC;YAClB,CAAC;SACF,CAAC,CAAC;IACL,CAAC;IAED,IAAY,WAAW;QACrB,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC;YACvB,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;QACpD,CAAC;QAED,OAAO,IAAI,CAAC,YAAY,CAAC;IAC3B,CAAC;IAED,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;CACF"}
+{"version":3,"file":"LoginFeatures.js","sourceRoot":"","sources":["../../page-extensions/LoginFeatures.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAaxD,MAAM,OAAO,aAAa;IAIxB;;;;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,YAAY,GAAG,IAAI,WAAW,CAAC,IAAI,CAAC,CAAC;gBAE1C,IAAI,CAAC,KAAK,GAAG,KAAK,EAAE,aAAsB,EAAE,EAAE;oBAC5C,MAAM,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;gBAC9C,CAAC,CAAC;gBAEF,IAAI,CAAC,oBAAoB,GAAG,KAAK,EAAE,QAAgB,EAAE,QAAgB,EAAE,EAAE;oBACvE,MAAM,IAAI,CAAC,WAAW,CAAC,oBAAoB,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;gBAClE,CAAC,CAAC;gBAEF,IAAI,CAAC,gBAAgB,GAAG,KAAK,EAAE,OAA8B,EAAE,EAAE;oBAC/D,MAAM,IAAI,CAAC,WAAW,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC;gBACnD,CAAC,CAAC;gBAEF,IAAI,CAAC,MAAM,GAAG,KAAK,IAAI,EAAE;oBACvB,MAAM,IAAI,CAAC,WAAW,CAAC,MAAM,EAAE,CAAC;gBAClC,CAAC,CAAC;gBAEF,MAAM,GAAG,CAAC,IAAI,CAAC,CAAC;YAClB,CAAC;SACF,CAAC,CAAC;IACL,CAAC;IAED,IAAY,WAAW;QACrB,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC;YACvB,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;QACpD,CAAC;QAED,OAAO,IAAI,CAAC,YAAY,CAAC;IAC3B,CAAC;IAED;;OAEG;IACH,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;CACF"}

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;
 }