@thinkwise/testwise 0.2.67 → 0.2.99

package/dist/components/tab/Tab.js.map

@@ -1 +1 @@
-{"version":3,"file":"Tab.js","sourceRoot":"","sources":["../../../components/tab/Tab.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE7C,MAAM,OAAO,GAAI,SAAQ,OAAO;IAG9B,YAAY,OAAgB;QAC1B,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,QAAQ,GAAG,IAAI,UAAU,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,OAAO,CAAC,CAAC;IAC1D,CAAC;IAED,qCAAqC;IAErC,4EAA4E;IAC5E,wFAAwF;IACjF,KAAK,CAAC,WAAW,CAAC,WAAmB,IAAI;QAC9C,MAAM,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,KAAK,EAAE,CAAC;IAChD,CAAC;IAED,2CAA2C;IACpC,UAAU,CAAC,WAAmB,IAAI;QACvC,OAAO,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACzC,CAAC;IAED,kDAAkD;IAC3C,KAAK,CAAC,WAAW;QACtB,MAAM,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,CAAC;IACxC,CAAC;IAED,2CAA2C;IACpC,UAAU;QACf,OAAO,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;IACjC,CAAC;IAED,6DAA6D;IACtD,KAAK,CAAC,WAAW,CAAC,KAAa;QACpC,MAAM,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,CAAC;IACzC,CAAC;CACF"}
+{"version":3,"file":"Tab.js","sourceRoot":"","sources":["../../../components/tab/Tab.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE7C;;;;;;;;;GASG;AACH,MAAM,OAAO,GAAI,SAAQ,OAAO;IAG9B,YAAY,OAAgB;QAC1B,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,QAAQ,GAAG,IAAI,UAAU,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,OAAO,CAAC,CAAC;IAC1D,CAAC;IAED,qCAAqC;IAErC,4EAA4E;IAC5E,wFAAwF;IACjF,KAAK,CAAC,WAAW,CAAC,WAAmB,IAAI;QAC9C,MAAM,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,KAAK,EAAE,CAAC;IAChD,CAAC;IAED,2CAA2C;IACpC,UAAU,CAAC,WAAmB,IAAI;QACvC,OAAO,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACzC,CAAC;IAED,kDAAkD;IAC3C,KAAK,CAAC,WAAW;QACtB,MAAM,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,CAAC;IACxC,CAAC;IAED,2CAA2C;IACpC,UAAU;QACf,OAAO,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;IACjC,CAAC;IAED,6DAA6D;IACtD,KAAK,CAAC,WAAW,CAAC,KAAa;QACpC,MAAM,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,CAAC;IACzC,CAAC;CACF"}

package/dist/components/task/TaskBar.d.ts

@@ -1,10 +1,20 @@
 import type { Locator } from '@playwright/test';
+/**
+ * Wraps the Thinkwise task-bar component that shows process/workflow task
+ * buttons in a horizontal bar at the bottom or top of a subject screen.
+ *
+ * In generated subject classes this is exposed as a typed `taskBar` property.
+ *
+ * @example
+ * await subject.taskBar.getTaskById('approve').click();
+ * const label = await subject.taskBar.getTaskByLabel('Approve').textContent();
+ */
 export declare class TaskBar {
     private _taskBarObjects;
     /**
-     * @param taskBarContext the taskbar container element (same idea as Grid's context)
+     * @param context the taskbar container element (same idea as Grid's context)
      */
-    constructor(taskBarContext: Locator);
+    constructor(context: Locator);
     /** returns all task buttons */
     tasks: () => Locator;
     /** returns a task button by its data-testid key */

package/dist/components/task/TaskBar.js

@@ -1,9 +1,19 @@
 import { TaskBarObjects } from './TaskBarObjects.js';
+/**
+ * Wraps the Thinkwise task-bar component that shows process/workflow task
+ * buttons in a horizontal bar at the bottom or top of a subject screen.
+ *
+ * In generated subject classes this is exposed as a typed `taskBar` property.
+ *
+ * @example
+ * await subject.taskBar.getTaskById('approve').click();
+ * const label = await subject.taskBar.getTaskByLabel('Approve').textContent();
+ */
 export class TaskBar {
     /**
-     * @param taskBarContext the taskbar container element (same idea as Grid's context)
+     * @param context the taskbar container element (same idea as Grid's context)
      */
-    constructor(taskBarContext) {
+    constructor(context) {
         /** returns all task buttons */
         this.tasks = () => this._taskBarObjects.tasks(); // matches Grid's "rows()" noun-style
         /** returns a task button by its data-testid key */
@@ -17,7 +27,7 @@ export class TaskBar {
         this.clickByLabel = async (label) => {
             await this.getTaskByLabel(label).click();
         };
-        this._taskBarObjects = new TaskBarObjects(taskBarContext.page(), taskBarContext);
+        this._taskBarObjects = new TaskBarObjects(context.page(), context);
     }
 }
 //# sourceMappingURL=TaskBar.js.map

package/dist/components/task/TaskBar.js.map

@@ -1 +1 @@
-{"version":3,"file":"TaskBar.js","sourceRoot":"","sources":["../../../components/task/TaskBar.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAErD,MAAM,OAAO,OAAO;IAGlB;;OAEG;IACH,YAAY,cAAuB;QAInC,+BAA+B;QACxB,UAAK,GAAG,GAAY,EAAE,CAAC,IAAI,CAAC,eAAe,CAAC,KAAK,EAAE,CAAC,CAAC,qCAAqC;QAEjG,mDAAmD;QAC5C,gBAAW,GAAG,CAAC,GAAW,EAAW,EAAE,CAAC,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;QAElF,iDAAiD;QAC1C,mBAAc,GAAG,CAAC,KAAa,EAAW,EAAE,CAAC,IAAI,CAAC,eAAe,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;QAE5F,oDAAoD;QAC7C,cAAS,GAAG,KAAK,EAAE,GAAW,EAAiB,EAAE;YACtD,MAAM,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,CAAC;QACtC,CAAC,CAAC;QAEK,iBAAY,GAAG,KAAK,EAAE,KAAa,EAAiB,EAAE;YAC3D,MAAM,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,CAAC;QAC3C,CAAC,CAAC;QAnBA,IAAI,CAAC,eAAe,GAAG,IAAI,cAAc,CAAC,cAAc,CAAC,IAAI,EAAE,EAAE,cAAc,CAAC,CAAC;IACnF,CAAC;CAmBF"}
+{"version":3,"file":"TaskBar.js","sourceRoot":"","sources":["../../../components/task/TaskBar.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAErD;;;;;;;;;GASG;AACH,MAAM,OAAO,OAAO;IAGlB;;OAEG;IACH,YAAY,OAAgB;QAI5B,+BAA+B;QACxB,UAAK,GAAG,GAAY,EAAE,CAAC,IAAI,CAAC,eAAe,CAAC,KAAK,EAAE,CAAC,CAAC,qCAAqC;QAEjG,mDAAmD;QAC5C,gBAAW,GAAG,CAAC,GAAW,EAAW,EAAE,CAAC,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;QAElF,iDAAiD;QAC1C,mBAAc,GAAG,CAAC,KAAa,EAAW,EAAE,CAAC,IAAI,CAAC,eAAe,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;QAE5F,oDAAoD;QAC7C,cAAS,GAAG,KAAK,EAAE,GAAW,EAAiB,EAAE;YACtD,MAAM,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,CAAC;QACtC,CAAC,CAAC;QAEK,iBAAY,GAAG,KAAK,EAAE,KAAa,EAAiB,EAAE;YAC3D,MAAM,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,CAAC;QAC3C,CAAC,CAAC;QAnBA,IAAI,CAAC,eAAe,GAAG,IAAI,cAAc,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,OAAO,CAAC,CAAC;IACrE,CAAC;CAmBF"}

package/dist/components/task/TaskTiles.d.ts

@@ -1,10 +1,19 @@
 import type { Locator } from '@playwright/test';
+/**
+ * Wraps the Thinkwise task-tiles component that displays tasks as clickable
+ * tile buttons on a dashboard or process-flow screen.
+ *
+ * In generated subject classes this is exposed as a typed `taskTiles` property.
+ *
+ * @example
+ * await subject.taskTiles.getTileByLabel('Approve').click();
+ */
 export declare class TaskTiles {
     private _taskTilesObjects;
     /**
-     * @param taskTilesContext the taskTiles container element
+     * @param context the taskTiles container element
      */
-    constructor(taskTilesContext: Locator);
+    constructor(context: Locator);
     /** returns all task tile buttons */
     tasks: () => Locator;
     getTaskById: (key: string) => Locator;

package/dist/components/task/TaskTiles.js

@@ -1,9 +1,18 @@
 import { TaskTilesObjects } from './TaskTilesObjects.js';
+/**
+ * Wraps the Thinkwise task-tiles component that displays tasks as clickable
+ * tile buttons on a dashboard or process-flow screen.
+ *
+ * In generated subject classes this is exposed as a typed `taskTiles` property.
+ *
+ * @example
+ * await subject.taskTiles.getTileByLabel('Approve').click();
+ */
 export class TaskTiles {
     /**
-     * @param taskTilesContext the taskTiles container element
+     * @param context the taskTiles container element
      */
-    constructor(taskTilesContext) {
+    constructor(context) {
         /** returns all task tile buttons */
         this.tasks = () => this._taskTilesObjects.tasks();
         this.getTaskById = (key) => this._taskTilesObjects.taskById(key);
@@ -14,7 +23,7 @@ export class TaskTiles {
         this.clickByLabel = async (label) => {
             await this.getTaskByLabel(label).click();
         };
-        this._taskTilesObjects = new TaskTilesObjects(taskTilesContext.page(), taskTilesContext);
+        this._taskTilesObjects = new TaskTilesObjects(context.page(), context);
     }
 }
 //# sourceMappingURL=TaskTiles.js.map

package/dist/components/task/TaskTiles.js.map

@@ -1 +1 @@
-{"version":3,"file":"TaskTiles.js","sourceRoot":"","sources":["../../../components/task/TaskTiles.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAEzD,MAAM,OAAO,SAAS;IAGpB;;OAEG;IACH,YAAY,gBAAyB;QAIrC,oCAAoC;QAC7B,UAAK,GAAG,GAAY,EAAE,CAAC,IAAI,CAAC,iBAAiB,CAAC,KAAK,EAAE,CAAC;QAEtD,gBAAW,GAAG,CAAC,GAAW,EAAW,EAAE,CAAC,IAAI,CAAC,iBAAiB,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;QAE7E,mBAAc,GAAG,CAAC,KAAa,EAAW,EAAE,CAAC,IAAI,CAAC,iBAAiB,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;QAEvF,cAAS,GAAG,KAAK,EAAE,GAAW,EAAiB,EAAE;YACtD,MAAM,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,CAAC;QACtC,CAAC,CAAC;QAEK,iBAAY,GAAG,KAAK,EAAE,KAAa,EAAiB,EAAE;YAC3D,MAAM,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,CAAC;QAC3C,CAAC,CAAC;QAhBA,IAAI,CAAC,iBAAiB,GAAG,IAAI,gBAAgB,CAAC,gBAAgB,CAAC,IAAI,EAAE,EAAE,gBAAgB,CAAC,CAAC;IAC3F,CAAC;CAgBF"}
+{"version":3,"file":"TaskTiles.js","sourceRoot":"","sources":["../../../components/task/TaskTiles.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAEzD;;;;;;;;GAQG;AACH,MAAM,OAAO,SAAS;IAGpB;;OAEG;IACH,YAAY,OAAgB;QAI5B,oCAAoC;QAC7B,UAAK,GAAG,GAAY,EAAE,CAAC,IAAI,CAAC,iBAAiB,CAAC,KAAK,EAAE,CAAC;QAEtD,gBAAW,GAAG,CAAC,GAAW,EAAW,EAAE,CAAC,IAAI,CAAC,iBAAiB,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;QAE7E,mBAAc,GAAG,CAAC,KAAa,EAAW,EAAE,CAAC,IAAI,CAAC,iBAAiB,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;QAEvF,cAAS,GAAG,KAAK,EAAE,GAAW,EAAiB,EAAE;YACtD,MAAM,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,CAAC;QACtC,CAAC,CAAC;QAEK,iBAAY,GAAG,KAAK,EAAE,KAAa,EAAiB,EAAE;YAC3D,MAAM,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,CAAC;QAC3C,CAAC,CAAC;QAhBA,IAAI,CAAC,iBAAiB,GAAG,IAAI,gBAAgB,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,OAAO,CAAC,CAAC;IACzE,CAAC;CAgBF"}

package/dist/components/topbar/TopBar.d.ts

@@ -1,4 +1,14 @@
 import type { Locator, Page } from '@playwright/test';
+/**
+ * Wraps the Thinkwise application top bar that shows the page title,
+ * breadcrumb trail, and the user/application menu.
+ *
+ * Access via `page.components.topBar` — no need to construct this yourself.
+ *
+ * @example
+ * const title = await page.components.topBar.getTopBarTitle().textContent();
+ * const breadcrumb = await page.components.topBar.getTopBarBreadcrumb().textContent();
+ */
 export declare class TopBarComponent {
     private _objects;
     constructor(page: Page, topbarContext?: Locator | null);

package/dist/components/topbar/TopBar.js

@@ -1,4 +1,14 @@
 import { TopBarObjects } from './TopBarObjects.js';
+/**
+ * Wraps the Thinkwise application top bar that shows the page title,
+ * breadcrumb trail, and the user/application menu.
+ *
+ * Access via `page.components.topBar` — no need to construct this yourself.
+ *
+ * @example
+ * const title = await page.components.topBar.getTopBarTitle().textContent();
+ * const breadcrumb = await page.components.topBar.getTopBarBreadcrumb().textContent();
+ */
 export class TopBarComponent {
     constructor(page, topbarContext = null) {
         this.getTopBarTitle = () => this._objects.topBarTitle();

package/dist/components/topbar/TopBar.js.map

@@ -1 +1 @@
-{"version":3,"file":"TopBar.js","sourceRoot":"","sources":["../../../components/topbar/TopBar.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD,MAAM,OAAO,eAAe;IAG1B,YAAY,IAAU,EAAE,gBAAgC,IAAI;QAIrD,mBAAc,GAAG,GAAG,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC;QAEnD,wBAAmB,GAAG,GAAG,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,gBAAgB,EAAE,CAAC;QAE7D,kBAAa,GAAG,GAAG,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC;QAPpD,IAAI,CAAC,QAAQ,GAAG,IAAI,aAAa,CAAC,IAAI,EAAE,aAAa,CAAC,CAAC;IACzD,CAAC;CAOF"}
+{"version":3,"file":"TopBar.js","sourceRoot":"","sources":["../../../components/topbar/TopBar.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD;;;;;;;;;GASG;AACH,MAAM,OAAO,eAAe;IAG1B,YAAY,IAAU,EAAE,gBAAgC,IAAI;QAIrD,mBAAc,GAAG,GAAG,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC;QAEnD,wBAAmB,GAAG,GAAG,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,gBAAgB,EAAE,CAAC;QAE7D,kBAAa,GAAG,GAAG,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC;QAPpD,IAAI,CAAC,QAAQ,GAAG,IAAI,aAAa,CAAC,IAAI,EAAE,aAAa,CAAC,CAAC;IACzD,CAAC;CAOF"}

package/dist/components/tree-view/TreeView.d.ts

@@ -1,5 +1,14 @@
 import type { Locator } from '@playwright/test';
 import { TreeViewObjects } from './TreeViewObjects.js';
+/**
+ * Wraps the Thinkwise tree-view navigation component used to display
+ * hierarchical data structures (e.g. organisational trees, folder structures).
+ *
+ * In generated subject classes this is exposed as a typed `treeView` property.
+ *
+ * @example
+ * await subject.treeView.context.getByText('Europe').click();
+ */
 export declare class TreeView {
     treeViewObjects: TreeViewObjects;
     constructor(context: Locator);

package/dist/components/tree-view/TreeView.js

@@ -1,4 +1,13 @@
 import { TreeViewObjects } from './TreeViewObjects.js';
+/**
+ * Wraps the Thinkwise tree-view navigation component used to display
+ * hierarchical data structures (e.g. organisational trees, folder structures).
+ *
+ * In generated subject classes this is exposed as a typed `treeView` property.
+ *
+ * @example
+ * await subject.treeView.context.getByText('Europe').click();
+ */
 export class TreeView {
     constructor(context) {
         this.treeViewObjects = new TreeViewObjects(context.page(), context);

package/dist/components/tree-view/TreeView.js.map

@@ -1 +1 @@
-{"version":3,"file":"TreeView.js","sourceRoot":"","sources":["../../../components/tree-view/TreeView.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAEvD,MAAM,OAAO,QAAQ;IAGnB,YAAY,OAAgB;QAC1B,IAAI,CAAC,eAAe,GAAG,IAAI,eAAe,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,OAAO,CAAC,CAAC;IACtE,CAAC;IAED,IAAW,OAAO;QAChB,OAAO,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC;IACtC,CAAC;CACF"}
+{"version":3,"file":"TreeView.js","sourceRoot":"","sources":["../../../components/tree-view/TreeView.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAEvD;;;;;;;;GAQG;AACH,MAAM,OAAO,QAAQ;IAGnB,YAAY,OAAgB;QAC1B,IAAI,CAAC,eAAe,GAAG,IAAI,eAAe,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,OAAO,CAAC,CAAC;IACtE,CAAC;IAED,IAAW,OAAO;QAChB,OAAO,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC;IACtC,CAAC;CACF"}

package/dist/controls/DateControl.d.ts

@@ -1,4 +1,26 @@
 import type { Locator } from '@playwright/test';
+/**
+ * Typed proxy for a date-picker field (`control_type: "date_picker"`) on a
+ * Thinkwise form screen.
+ *
+ * **How to use:** You never construct this directly. Generated subject
+ * component classes expose properties of type `IDateControl` for each date
+ * field on the form:
+ *
+ * ```ts
+ * // Fill accepts any common date format — numbers are extracted and entered
+ * // sequentially so the date picker can apply its own formatting:
+ * await subject.form.hireDateField.fill('15-03-2025');
+ * await subject.form.hireDateField.fill('03/15/2025');
+ * await subject.form.hireDateField.fill('20250315');  // also works
+ *
+ * const raw = await subject.form.hireDateField.inputValue();
+ * await subject.form.hireDateField.clear();
+ * ```
+ *
+ * The returned value is a **Proxy** — it works as both a Playwright `Locator`
+ * and a typed date control.
+ */
 export type IDateControl = Locator & IDateControlCore;
 export type IDateControlCore = {
     fill(value: string): Promise<void>;
@@ -17,8 +39,25 @@ export declare class DateControl implements IDateControlCore {
      * @param value
      */
     fill(value: string): Promise<void>;
+    /**
+     * Clears the date input by filling it with an empty string.
+     */
     clear(): Promise<void>;
+    /**
+     * Returns the current raw string value from the underlying date input element.
+     */
     inputValue(): Promise<string>;
+    /**
+     * Returns the Playwright `Locator` for the underlying `<input>` element of the date field.
+     */
     inputElement(): Locator;
 }
+/**
+ * Creates an `IDateControl` proxy that merges `DateControl` interaction methods with
+ * the underlying Playwright `Locator` for the `form-field__<id>` test ID.
+ * Use the returned value as both a typed date control and a regular Playwright locator.
+ * @param context - The parent locator to scope the control within.
+ * @param id - The field identifier used to locate `[data-testid="form-field__<id>"]`.
+ * @returns A proxy combining `IDateControlCore` methods and `Locator` capabilities.
+ */
 export declare function createDateControl(context: Locator, id: string): IDateControl;

package/dist/controls/DateControl.js

@@ -12,19 +12,36 @@ export class DateControl {
      */
     async fill(value) {
         const numbersOnlyValue = value.replace(/\D/g, '');
-        await this._objects.fieldInput().focus();
+        await this._objects.fieldInput().click();
         await this._objects.fieldInput().pressSequentially(numbersOnlyValue);
     }
+    /**
+     * Clears the date input by filling it with an empty string.
+     */
     async clear() {
         await this._objects.fieldInput().fill('');
     }
+    /**
+     * Returns the current raw string value from the underlying date input element.
+     */
     async inputValue() {
         return await this._objects.fieldInput().inputValue();
     }
+    /**
+     * Returns the Playwright `Locator` for the underlying `<input>` element of the date field.
+     */
     inputElement() {
         return this._objects.fieldInput();
     }
 }
+/**
+ * Creates an `IDateControl` proxy that merges `DateControl` interaction methods with
+ * the underlying Playwright `Locator` for the `form-field__<id>` test ID.
+ * Use the returned value as both a typed date control and a regular Playwright locator.
+ * @param context - The parent locator to scope the control within.
+ * @param id - The field identifier used to locate `[data-testid="form-field__<id>"]`.
+ * @returns A proxy combining `IDateControlCore` methods and `Locator` capabilities.
+ */
 export function createDateControl(context, id) {
     const inputFieldControl = new DateControl(context, id);
     const locator = context.getByTestId(`form-field__${id}`);

package/dist/controls/DateControl.js.map

@@ -1 +1 @@
-{"version":3,"file":"DateControl.js","sourceRoot":"","sources":["../../controls/DateControl.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAW7D,MAAM,OAAO,WAAW;IAGtB,YAAY,OAAgB,EAAE,EAAU;QACtC,IAAI,CAAC,QAAQ,GAAG,IAAI,kBAAkB,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IACtD,CAAC;IAED;;;;;;OAMG;IACI,KAAK,CAAC,IAAI,CAAC,KAAa;QAC7B,MAAM,gBAAgB,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QAElD,MAAM,IAAI,CAAC,QAAQ,CAAC,UAAU,EAAE,CAAC,KAAK,EAAE,CAAC;QACzC,MAAM,IAAI,CAAC,QAAQ,CAAC,UAAU,EAAE,CAAC,iBAAiB,CAAC,gBAAgB,CAAC,CAAC;IACvE,CAAC;IAEM,KAAK,CAAC,KAAK;QAChB,MAAM,IAAI,CAAC,QAAQ,CAAC,UAAU,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC5C,CAAC;IAEM,KAAK,CAAC,UAAU;QACrB,OAAO,MAAM,IAAI,CAAC,QAAQ,CAAC,UAAU,EAAE,CAAC,UAAU,EAAE,CAAC;IACvD,CAAC;IAEM,YAAY;QACjB,OAAO,IAAI,CAAC,QAAQ,CAAC,UAAU,EAAE,CAAC;IACpC,CAAC;CACF;AAED,MAAM,UAAU,iBAAiB,CAAC,OAAgB,EAAE,EAAU;IAC5D,MAAM,iBAAiB,GAAG,IAAI,WAAW,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IACvD,MAAM,OAAO,GAAG,OAAO,CAAC,WAAW,CAAC,eAAe,EAAE,EAAE,CAAC,CAAC;IAEzD,OAAO,IAAI,KAAK,CAAC,iBAAiB,EAAE;QAClC,GAAG,CAAC,MAAM,EAAE,IAAI,EAAE,QAAQ;YACxB,IAAI,IAAI,IAAI,MAAM,EAAE,CAAC;gBACnB,OAAO,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC;YAC7C,CAAC;YACD,MAAM,KAAK,GAAI,OAAe,CAAC,IAAI,CAAC,CAAC;YAErC,IAAI,OAAO,KAAK,KAAK,UAAU,EAAE,CAAC;gBAChC,OAAO,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YAC7B,CAAC;YACD,OAAO,KAAK,CAAC;QACf,CAAC;KACF,CAA4B,CAAC;AAChC,CAAC"}
+{"version":3,"file":"DateControl.js","sourceRoot":"","sources":["../../controls/DateControl.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAiC7D,MAAM,OAAO,WAAW;IAGtB,YAAY,OAAgB,EAAE,EAAU;QACtC,IAAI,CAAC,QAAQ,GAAG,IAAI,kBAAkB,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IACtD,CAAC;IAED;;;;;;OAMG;IACI,KAAK,CAAC,IAAI,CAAC,KAAa;QAC7B,MAAM,gBAAgB,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QAElD,MAAM,IAAI,CAAC,QAAQ,CAAC,UAAU,EAAE,CAAC,KAAK,EAAE,CAAC;QACzC,MAAM,IAAI,CAAC,QAAQ,CAAC,UAAU,EAAE,CAAC,iBAAiB,CAAC,gBAAgB,CAAC,CAAC;IACvE,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,KAAK;QAChB,MAAM,IAAI,CAAC,QAAQ,CAAC,UAAU,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC5C,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,UAAU;QACrB,OAAO,MAAM,IAAI,CAAC,QAAQ,CAAC,UAAU,EAAE,CAAC,UAAU,EAAE,CAAC;IACvD,CAAC;IAED;;OAEG;IACI,YAAY;QACjB,OAAO,IAAI,CAAC,QAAQ,CAAC,UAAU,EAAE,CAAC;IACpC,CAAC;CACF;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,iBAAiB,CAAC,OAAgB,EAAE,EAAU;IAC5D,MAAM,iBAAiB,GAAG,IAAI,WAAW,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IACvD,MAAM,OAAO,GAAG,OAAO,CAAC,WAAW,CAAC,eAAe,EAAE,EAAE,CAAC,CAAC;IAEzD,OAAO,IAAI,KAAK,CAAC,iBAAiB,EAAE;QAClC,GAAG,CAAC,MAAM,EAAE,IAAI,EAAE,QAAQ;YACxB,IAAI,IAAI,IAAI,MAAM,EAAE,CAAC;gBACnB,OAAO,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC;YAC7C,CAAC;YACD,MAAM,KAAK,GAAI,OAAe,CAAC,IAAI,CAAC,CAAC;YAErC,IAAI,OAAO,KAAK,KAAK,UAAU,EAAE,CAAC;gBAChC,OAAO,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YAC7B,CAAC;YACD,OAAO,KAAK,CAAC;QACf,CAAC;KACF,CAA4B,CAAC;AAChC,CAAC"}

package/dist/controls/FormComboBox.d.ts

@@ -1,4 +1,26 @@
 import type { Locator } from '@playwright/test';
+/**
+ * Typed proxy for a combo-box field (`control_type: "combo_box"`) on a
+ * Thinkwise form screen.
+ *
+ * **How to use:** You never construct this directly. Generated subject
+ * component classes expose properties of type `IFormComboBox` for each
+ * combo-box on the form:
+ *
+ * ```ts
+ * // Select an option by typing a prefix and picking from auto-complete:
+ * await subject.form.statusCombo.lookupSelect('Act');
+ *
+ * // Click to open the full list and select:
+ * await subject.form.statusCombo.selectOption('Active');
+ *
+ * // Clear the current selection:
+ * await subject.form.statusCombo.clearByClick();
+ * ```
+ *
+ * The returned value is a **Proxy** that acts as both a Playwright `Locator`
+ * and a typed combo-box control.
+ */
 export type IFormComboBox = Locator & IFormComboBoxCore;
 export type IFormComboBoxCore = {
     lookupSelect(optionToSelect: string): Promise<void>;
@@ -6,4 +28,12 @@ export type IFormComboBoxCore = {
     getValidationMessage(): Promise<string>;
     clearByClick(): Promise<void>;
 };
+/**
+ * Creates an `IFormComboBox` proxy that merges `FormComboBox` interaction methods with
+ * the underlying Playwright `Locator` for the `form-field__<id>` test ID.
+ * Use the returned value as both a typed combo-box control and a regular Playwright locator.
+ * @param context - The parent locator to scope the control within.
+ * @param id - The field identifier used to locate `[data-testid="form-field__<id>"]`.
+ * @returns A proxy combining `IFormComboBoxCore` methods and `Locator` capabilities.
+ */
 export declare function createFormComboBox(context: Locator, id: string): IFormComboBox;

package/dist/controls/FormComboBox.js

@@ -21,6 +21,14 @@ class FormComboBox {
         await this._objects.option(optionToSelect).click();
     }
 }
+/**
+ * Creates an `IFormComboBox` proxy that merges `FormComboBox` interaction methods with
+ * the underlying Playwright `Locator` for the `form-field__<id>` test ID.
+ * Use the returned value as both a typed combo-box control and a regular Playwright locator.
+ * @param context - The parent locator to scope the control within.
+ * @param id - The field identifier used to locate `[data-testid="form-field__<id>"]`.
+ * @returns A proxy combining `IFormComboBoxCore` methods and `Locator` capabilities.
+ */
 export function createFormComboBox(context, id) {
     const comboBox = new FormComboBox(context, id);
     const locator = context.getByTestId(`form-field__${id}`);

package/dist/controls/FormComboBox.js.map

@@ -1 +1 @@
-{"version":3,"file":"FormComboBox.js","sourceRoot":"","sources":["../../controls/FormComboBox.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAW/D,MAAM,YAAY;IAGhB,YAAY,OAAgB,EAAE,EAAU;QACtC,IAAI,CAAC,QAAQ,GAAG,IAAI,mBAAmB,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IACvD,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,UAAkB;QACnC,MAAM,IAAI,CAAC,QAAQ,CAAC,UAAU,EAAE,CAAC,KAAK,EAAE,CAAC;QACzC,MAAM,IAAI,CAAC,QAAQ,CAAC,gBAAgB,EAAE,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;QACrE,MAAM,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,KAAK,EAAE,CAAC;IACjD,CAAC;IAED,KAAK,CAAC,oBAAoB;QACxB,MAAM,IAAI,CAAC,QAAQ,CAAC,iBAAiB,EAAE,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;QACtE,OAAO,MAAM,IAAI,CAAC,QAAQ,CAAC,iBAAiB,EAAE,CAAC,SAAS,EAAE,CAAC;IAC7D,CAAC;IACD,KAAK,CAAC,YAAY;QAChB,MAAM,IAAI,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC,KAAK,EAAE,CAAC;IAC5C,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,cAAsB;QACvC,MAAM,IAAI,CAAC,QAAQ,CAAC,UAAU,EAAE,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QACtD,MAAM,IAAI,CAAC,QAAQ,CAAC,gBAAgB,EAAE,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;QACrE,MAAM,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC,KAAK,EAAE,CAAC;IACrD,CAAC;CACF;AAED,MAAM,UAAU,kBAAkB,CAAC,OAAgB,EAAE,EAAU;IAC7D,MAAM,QAAQ,GAAG,IAAI,YAAY,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IAC/C,MAAM,OAAO,GAAG,OAAO,CAAC,WAAW,CAAC,eAAe,EAAE,EAAE,CAAC,CAAC;IAEzD,OAAO,IAAI,KAAK,CAAC,QAAQ,EAAE;QACzB,GAAG,CAAC,MAAM,EAAE,IAAI,EAAE,QAAQ;YACxB,IAAI,IAAI,IAAI,MAAM,EAAE,CAAC;gBACnB,OAAO,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC;YAC7C,CAAC;YAED,MAAM,KAAK,GAAI,OAAe,CAAC,IAAI,CAAC,CAAC;YAErC,IAAI,OAAO,KAAK,KAAK,UAAU,EAAE,CAAC;gBAChC,OAAO,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YAC7B,CAAC;YACD,OAAO,KAAK,CAAC;QACf,CAAC;KACF,CAA6B,CAAC;AACjC,CAAC"}
+{"version":3,"file":"FormComboBox.js","sourceRoot":"","sources":["../../controls/FormComboBox.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAiC/D,MAAM,YAAY;IAGhB,YAAY,OAAgB,EAAE,EAAU;QACtC,IAAI,CAAC,QAAQ,GAAG,IAAI,mBAAmB,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IACvD,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,UAAkB;QACnC,MAAM,IAAI,CAAC,QAAQ,CAAC,UAAU,EAAE,CAAC,KAAK,EAAE,CAAC;QACzC,MAAM,IAAI,CAAC,QAAQ,CAAC,gBAAgB,EAAE,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;QACrE,MAAM,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,KAAK,EAAE,CAAC;IACjD,CAAC;IAED,KAAK,CAAC,oBAAoB;QACxB,MAAM,IAAI,CAAC,QAAQ,CAAC,iBAAiB,EAAE,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;QACtE,OAAO,MAAM,IAAI,CAAC,QAAQ,CAAC,iBAAiB,EAAE,CAAC,SAAS,EAAE,CAAC;IAC7D,CAAC;IACD,KAAK,CAAC,YAAY;QAChB,MAAM,IAAI,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC,KAAK,EAAE,CAAC;IAC5C,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,cAAsB;QACvC,MAAM,IAAI,CAAC,QAAQ,CAAC,UAAU,EAAE,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QACtD,MAAM,IAAI,CAAC,QAAQ,CAAC,gBAAgB,EAAE,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;QACrE,MAAM,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC,KAAK,EAAE,CAAC;IACrD,CAAC;CACF;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,kBAAkB,CAAC,OAAgB,EAAE,EAAU;IAC7D,MAAM,QAAQ,GAAG,IAAI,YAAY,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IAC/C,MAAM,OAAO,GAAG,OAAO,CAAC,WAAW,CAAC,eAAe,EAAE,EAAE,CAAC,CAAC;IAEzD,OAAO,IAAI,KAAK,CAAC,QAAQ,EAAE;QACzB,GAAG,CAAC,MAAM,EAAE,IAAI,EAAE,QAAQ;YACxB,IAAI,IAAI,IAAI,MAAM,EAAE,CAAC;gBACnB,OAAO,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC;YAC7C,CAAC;YAED,MAAM,KAAK,GAAI,OAAe,CAAC,IAAI,CAAC,CAAC;YAErC,IAAI,OAAO,KAAK,KAAK,UAAU,EAAE,CAAC;gBAChC,OAAO,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YAC7B,CAAC;YACD,OAAO,KAAK,CAAC;QACf,CAAC;KACF,CAA6B,CAAC;AACjC,CAAC"}

package/dist/controls/GridColumnControl.d.ts

@@ -1,4 +1,26 @@
 import type { Locator } from '@playwright/test';
+/**
+ * Typed proxy for a single column in a Thinkwise `Grid` component.
+ *
+ * **How to use:** You never construct this directly. Generated subject
+ * component classes expose properties of type `IGridColumnControl` for each
+ * column in a grid:
+ *
+ * ```ts
+ * // Get all visible cell values in the column:
+ * const names = await subject.grid.employeeNameColumn.getCellValues();
+ *
+ * // Find a specific cell by its exact text:
+ * const cell = subject.grid.employeeNameColumn.getCellByExactValue('Jane Doe');
+ * await cell.click();
+ *
+ * // Filter the grid using the Excel-style filter popup:
+ * await subject.grid.statusColumn.filterByColumnValueExcelStyle('Active');
+ * ```
+ *
+ * The returned value is a **Proxy** — it works as both a Playwright `Locator`
+ * (pointing at the column header) and a typed column control.
+ */
 export type IGridColumnControl = Locator & IGridColumnControlCore;
 export type IGridColumnControlCore = {
     getColumnHeader(): Promise<Locator>;
@@ -7,4 +29,12 @@ export type IGridColumnControlCore = {
     filterByColumnValueExcelStyle(value: string, deselectAll?: boolean): Promise<void>;
     openExcelStyleFilterPopup(): Promise<void>;
 };
+/**
+ * Creates an `IGridColumnControl` proxy for a specific grid column.
+ * Normalises the column `id` (replacing `-` with `_`), then returns a proxy that merges
+ * `GridColumnControl` interaction methods with the `[col-id="<id>"]` locator.
+ * @param gridContext - The parent `Locator` representing the grid element.
+ * @param id - The column identifier (hyphens are automatically converted to underscores).
+ * @returns A proxy combining `IGridColumnControlCore` methods and `Locator` capabilities.
+ */
 export declare function createGridColumnControl(gridContext: Locator, id: string): IGridColumnControl;

package/dist/controls/GridColumnControl.js

@@ -3,7 +3,7 @@ import { escapeRegex } from '../index.js';
 import { GridColumnControlObjects } from './GridColumnControlObjects.js';
 class GridColumnControl {
     constructor(gridContext, id) {
-        this._id = id.replace(/-/g, '_');
+        this._id = id;
         this._objects = new GridColumnControlObjects(gridContext, this._id);
         this._grid = new Grid(gridContext);
     }
@@ -24,9 +24,18 @@ class GridColumnControl {
         await this._grid.filterByColumnValueExcelStyle(this._objects.columnHeader(), value, deselectAll);
     }
 }
+/**
+ * Creates an `IGridColumnControl` proxy for a specific grid column.
+ * Normalises the column `id` (replacing `-` with `_`), then returns a proxy that merges
+ * `GridColumnControl` interaction methods with the `[col-id="<id>"]` locator.
+ * @param gridContext - The parent `Locator` representing the grid element.
+ * @param id - The column identifier (hyphens are automatically converted to underscores).
+ * @returns A proxy combining `IGridColumnControlCore` methods and `Locator` capabilities.
+ */
 export function createGridColumnControl(gridContext, id) {
-    const columnControl = new GridColumnControl(gridContext, id);
-    const locator = gridContext.locator(`[col-id="${id}"]`);
+    const processedId = id.replace(/-/g, '_');
+    const columnControl = new GridColumnControl(gridContext, processedId);
+    const locator = gridContext.locator(`[col-id="${processedId}"]`);
     return new Proxy(columnControl, {
         get(target, prop, receiver) {
             if (prop in target) {

package/dist/controls/GridColumnControl.js.map

@@ -1 +1 @@
-{"version":3,"file":"GridColumnControl.js","sourceRoot":"","sources":["../../controls/GridColumnControl.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,IAAI,EAAE,MAAM,4BAA4B,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AAYzE,MAAM,iBAAiB;IAKrB,YAAY,WAAoB,EAAE,EAAU;QAC1C,IAAI,CAAC,GAAG,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;QACjC,IAAI,CAAC,QAAQ,GAAG,IAAI,wBAAwB,CAAC,WAAW,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC;QACpE,IAAI,CAAC,KAAK,GAAG,IAAI,IAAI,CAAC,WAAW,CAAC,CAAC;IACrC,CAAC;IAEM,KAAK,CAAC,yBAAyB;QACpC,MAAM,IAAI,CAAC,KAAK,CAAC,yBAAyB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACvD,CAAC;IAEM,KAAK,CAAC,eAAe;QAC1B,OAAO,MAAM,IAAI,CAAC,QAAQ,CAAC,YAAY,EAAE,CAAC;IAC5C,CAAC;IAEM,mBAAmB,CAAC,KAAa;QACtC,MAAM,gBAAgB,GAAG,IAAI,MAAM,CAAC,IAAI,WAAW,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC/D,OAAO,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,gBAAgB,CAAC,CAAC;IACrD,CAAC;IAEM,KAAK,CAAC,aAAa;QACxB,OAAO,MAAM,IAAI,CAAC,KAAK,CAAC,oBAAoB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACzD,CAAC;IAEM,KAAK,CAAC,6BAA6B,CAAC,KAAa,EAAE,WAAqB;QAC7E,MAAM,IAAI,CAAC,KAAK,CAAC,6BAA6B,CAAC,IAAI,CAAC,QAAQ,CAAC,YAAY,EAAE,EAAE,KAAK,EAAE,WAAW,CAAC,CAAC;IACnG,CAAC;CACF;AAED,MAAM,UAAU,uBAAuB,CAAC,WAAoB,EAAE,EAAU;IACtE,MAAM,aAAa,GAAG,IAAI,iBAAiB,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;IAC7D,MAAM,OAAO,GAAG,WAAW,CAAC,OAAO,CAAC,YAAY,EAAE,IAAI,CAAC,CAAC;IAExD,OAAO,IAAI,KAAK,CAAC,aAAa,EAAE;QAC9B,GAAG,CAAC,MAAM,EAAE,IAAI,EAAE,QAAQ;YACxB,IAAI,IAAI,IAAI,MAAM,EAAE,CAAC;gBACnB,OAAO,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC;YAC7C,CAAC;YAED,MAAM,KAAK,GAAI,OAAe,CAAC,IAAI,CAAC,CAAC;YACrC,IAAI,OAAO,KAAK,KAAK,UAAU,EAAE,CAAC;gBAChC,OAAO,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YAC7B,CAAC;YACD,OAAO,KAAK,CAAC;QACf,CAAC;KACF,CAAkC,CAAC;AACtC,CAAC"}
+{"version":3,"file":"GridColumnControl.js","sourceRoot":"","sources":["../../controls/GridColumnControl.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,IAAI,EAAE,MAAM,4BAA4B,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AAkCzE,MAAM,iBAAiB;IAKrB,YAAY,WAAoB,EAAE,EAAU;QAC1C,IAAI,CAAC,GAAG,GAAG,EAAE,CAAC;QACd,IAAI,CAAC,QAAQ,GAAG,IAAI,wBAAwB,CAAC,WAAW,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC;QACpE,IAAI,CAAC,KAAK,GAAG,IAAI,IAAI,CAAC,WAAW,CAAC,CAAC;IACrC,CAAC;IAEM,KAAK,CAAC,yBAAyB;QACpC,MAAM,IAAI,CAAC,KAAK,CAAC,yBAAyB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACvD,CAAC;IAEM,KAAK,CAAC,eAAe;QAC1B,OAAO,MAAM,IAAI,CAAC,QAAQ,CAAC,YAAY,EAAE,CAAC;IAC5C,CAAC;IAEM,mBAAmB,CAAC,KAAa;QACtC,MAAM,gBAAgB,GAAG,IAAI,MAAM,CAAC,IAAI,WAAW,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC/D,OAAO,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,gBAAgB,CAAC,CAAC;IACrD,CAAC;IAEM,KAAK,CAAC,aAAa;QACxB,OAAO,MAAM,IAAI,CAAC,KAAK,CAAC,oBAAoB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACzD,CAAC;IAEM,KAAK,CAAC,6BAA6B,CAAC,KAAa,EAAE,WAAqB;QAC7E,MAAM,IAAI,CAAC,KAAK,CAAC,6BAA6B,CAAC,IAAI,CAAC,QAAQ,CAAC,YAAY,EAAE,EAAE,KAAK,EAAE,WAAW,CAAC,CAAC;IACnG,CAAC;CACF;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,uBAAuB,CAAC,WAAoB,EAAE,EAAU;IACtE,MAAM,WAAW,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IAC1C,MAAM,aAAa,GAAG,IAAI,iBAAiB,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC;IACtE,MAAM,OAAO,GAAG,WAAW,CAAC,OAAO,CAAC,YAAY,WAAW,IAAI,CAAC,CAAC;IAEjE,OAAO,IAAI,KAAK,CAAC,aAAa,EAAE;QAC9B,GAAG,CAAC,MAAM,EAAE,IAAI,EAAE,QAAQ;YACxB,IAAI,IAAI,IAAI,MAAM,EAAE,CAAC;gBACnB,OAAO,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC;YAC7C,CAAC;YAED,MAAM,KAAK,GAAI,OAAe,CAAC,IAAI,CAAC,CAAC;YACrC,IAAI,OAAO,KAAK,KAAK,UAAU,EAAE,CAAC;gBAChC,OAAO,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YAC7B,CAAC;YACD,OAAO,KAAK,CAAC;QACf,CAAC;KACF,CAAkC,CAAC;AACtC,CAAC"}

package/dist/controls/InputFieldControl.d.ts

@@ -1,5 +1,24 @@
 /** biome-ignore-all lint/suspicious/noExplicitAny: reason42 */
 import type { Locator } from '@playwright/test';
+/**
+ * Typed proxy for a plain text input field (`control_type: "field"`) on a
+ * Thinkwise form screen.
+ *
+ * **How to use:** You never construct this directly. The generated subject
+ * component class exposes properties of type `IInputFieldControl` — one per
+ * field on the form. Use those properties in your test:
+ *
+ * ```ts
+ * // Generated subject exposes:
+ * //   employeeName: IInputFieldControl;
+ * await subject.form.employeeName.fill('Jane Doe');
+ * const val = await subject.form.employeeName.inputValue();
+ * ```
+ *
+ * The returned value is a **Proxy** — it acts as both a Playwright `Locator`
+ * (so you can call `.waitFor()`, `.isVisible()`, etc.) and as a typed control
+ * with named interaction methods.
+ */
 export type IInputFieldControl = Locator & ICoreInputFieldControl;
 export type ICoreInputFieldControl = {
     getValidationMessage(): Promise<string>;
@@ -13,12 +32,42 @@ export type ICoreInputFieldControl = {
 export declare class InputFieldControl implements ICoreInputFieldControl {
     private _objects;
     constructor(context: Locator, id: string);
+    /**
+     * Waits for the field's validation message element to become visible, then returns its text.
+     */
     getValidationMessage(): Promise<string>;
+    /**
+     * Fills the input element with the given value.
+     * @param value - The string to enter into the field.
+     */
     fill(value: string): Promise<void>;
+    /**
+     * Clicks the underlying input element.
+     */
     click(): Promise<void>;
+    /**
+     * Clears the input field by filling it with an empty string.
+     */
     clear(): Promise<void>;
+    /**
+     * Returns the current string value from the underlying input element.
+     */
     inputValue(): Promise<string>;
+    /**
+     * Returns the Playwright `Locator` for the underlying `<input>` element of the field.
+     */
     inputElement(): Locator;
+    /**
+     * Returns the trimmed, whitespace-normalised text content of the field's label element.
+     */
     getLabelText(): Promise<string>;
 }
+/**
+ * Creates an `IInputFieldControl` proxy that merges `InputFieldControl` interaction methods
+ * with the underlying Playwright `Locator` for the `form-field__<id>` test ID.
+ * Use the returned value as both a typed input control and a regular Playwright locator.
+ * @param context - The parent locator to scope the control within.
+ * @param id - The field identifier used to locate `[data-testid="form-field__<id>"]`.
+ * @returns A proxy combining `ICoreInputFieldControl` methods and `Locator` capabilities.
+ */
 export declare function createInputFieldControl(context: Locator, id: string): IInputFieldControl;

package/dist/controls/InputFieldControl.js

@@ -3,31 +3,61 @@ export class InputFieldControl {
     constructor(context, id) {
         this._objects = new InputFieldControlObjects(context, id);
     }
+    /**
+     * Waits for the field's validation message element to become visible, then returns its text.
+     */
     async getValidationMessage() {
         await this._objects.validationMessage().waitFor({ state: 'visible' });
         return await this._objects.validationMessage().innerText();
     }
+    /**
+     * Fills the input element with the given value.
+     * @param value - The string to enter into the field.
+     */
     async fill(value) {
         await this._objects.fieldInput().fill(value);
     }
+    /**
+     * Clicks the underlying input element.
+     */
     async click() {
         await this._objects.fieldInput().click();
     }
+    /**
+     * Clears the input field by filling it with an empty string.
+     */
     async clear() {
         await this._objects.fieldInput().fill('');
     }
+    /**
+     * Returns the current string value from the underlying input element.
+     */
     async inputValue() {
         return await this._objects.fieldInput().inputValue();
     }
+    /**
+     * Returns the Playwright `Locator` for the underlying `<input>` element of the field.
+     */
     inputElement() {
         return this._objects.fieldInput();
     }
+    /**
+     * Returns the trimmed, whitespace-normalised text content of the field's label element.
+     */
     async getLabelText() {
         let returnText = (await this._objects.fieldLabel().textContent()) || '';
         returnText = returnText.replace(/\s+/g, ' ').trim();
         return returnText;
     }
 }
+/**
+ * Creates an `IInputFieldControl` proxy that merges `InputFieldControl` interaction methods
+ * with the underlying Playwright `Locator` for the `form-field__<id>` test ID.
+ * Use the returned value as both a typed input control and a regular Playwright locator.
+ * @param context - The parent locator to scope the control within.
+ * @param id - The field identifier used to locate `[data-testid="form-field__<id>"]`.
+ * @returns A proxy combining `ICoreInputFieldControl` methods and `Locator` capabilities.
+ */
 export function createInputFieldControl(context, id) {
     const inputFieldControl = new InputFieldControl(context, id);
     const locator = context.getByTestId(`form-field__${id}`);

package/dist/controls/InputFieldControl.js.map

@@ -1 +1 @@
-{"version":3,"file":"InputFieldControl.js","sourceRoot":"","sources":["../../controls/InputFieldControl.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AAczE,MAAM,OAAO,iBAAiB;IAG5B,YAAY,OAAgB,EAAE,EAAU;QACtC,IAAI,CAAC,QAAQ,GAAG,IAAI,wBAAwB,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IAC5D,CAAC;IAEM,KAAK,CAAC,oBAAoB;QAC/B,MAAM,IAAI,CAAC,QAAQ,CAAC,iBAAiB,EAAE,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;QACtE,OAAO,MAAM,IAAI,CAAC,QAAQ,CAAC,iBAAiB,EAAE,CAAC,SAAS,EAAE,CAAC;IAC7D,CAAC;IAEM,KAAK,CAAC,IAAI,CAAC,KAAa;QAC7B,MAAM,IAAI,CAAC,QAAQ,CAAC,UAAU,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC/C,CAAC;IAEM,KAAK,CAAC,KAAK;QAChB,MAAM,IAAI,CAAC,QAAQ,CAAC,UAAU,EAAE,CAAC,KAAK,EAAE,CAAC;IAC3C,CAAC;IAEM,KAAK,CAAC,KAAK;QAChB,MAAM,IAAI,CAAC,QAAQ,CAAC,UAAU,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC5C,CAAC;IAEM,KAAK,CAAC,UAAU;QACrB,OAAO,MAAM,IAAI,CAAC,QAAQ,CAAC,UAAU,EAAE,CAAC,UAAU,EAAE,CAAC;IACvD,CAAC;IAEM,YAAY;QACjB,OAAO,IAAI,CAAC,QAAQ,CAAC,UAAU,EAAE,CAAC;IACpC,CAAC;IAEM,KAAK,CAAC,YAAY;QACvB,IAAI,UAAU,GAAG,CAAC,MAAM,IAAI,CAAC,QAAQ,CAAC,UAAU,EAAE,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,CAAC;QAExE,UAAU,GAAG,UAAU,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;QAEpD,OAAO,UAAU,CAAC;IACpB,CAAC;CACF;AAED,MAAM,UAAU,uBAAuB,CAAC,OAAgB,EAAE,EAAU;IAClE,MAAM,iBAAiB,GAAG,IAAI,iBAAiB,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IAC7D,MAAM,OAAO,GAAG,OAAO,CAAC,WAAW,CAAC,eAAe,EAAE,EAAE,CAAC,CAAC;IAEzD,OAAO,IAAI,KAAK,CAAC,iBAAiB,EAAE;QAClC,GAAG,CAAC,MAAM,EAAE,IAAI,EAAE,QAAQ;YACxB,IAAI,IAAI,IAAI,MAAM,EAAE,CAAC;gBACnB,OAAO,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC;YAC7C,CAAC;YACD,MAAM,KAAK,GAAI,OAAe,CAAC,IAAI,CAAC,CAAC;YAErC,IAAI,OAAO,KAAK,KAAK,UAAU,EAAE,CAAC;gBAChC,OAAO,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YAC7B,CAAC;YACD,OAAO,KAAK,CAAC;QACf,CAAC;KACF,CAAkC,CAAC;AACtC,CAAC"}
+{"version":3,"file":"InputFieldControl.js","sourceRoot":"","sources":["../../controls/InputFieldControl.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AAiCzE,MAAM,OAAO,iBAAiB;IAG5B,YAAY,OAAgB,EAAE,EAAU;QACtC,IAAI,CAAC,QAAQ,GAAG,IAAI,wBAAwB,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IAC5D,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,oBAAoB;QAC/B,MAAM,IAAI,CAAC,QAAQ,CAAC,iBAAiB,EAAE,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;QACtE,OAAO,MAAM,IAAI,CAAC,QAAQ,CAAC,iBAAiB,EAAE,CAAC,SAAS,EAAE,CAAC;IAC7D,CAAC;IAED;;;OAGG;IACI,KAAK,CAAC,IAAI,CAAC,KAAa;QAC7B,MAAM,IAAI,CAAC,QAAQ,CAAC,UAAU,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC/C,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,KAAK;QAChB,MAAM,IAAI,CAAC,QAAQ,CAAC,UAAU,EAAE,CAAC,KAAK,EAAE,CAAC;IAC3C,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,KAAK;QAChB,MAAM,IAAI,CAAC,QAAQ,CAAC,UAAU,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC5C,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,UAAU;QACrB,OAAO,MAAM,IAAI,CAAC,QAAQ,CAAC,UAAU,EAAE,CAAC,UAAU,EAAE,CAAC;IACvD,CAAC;IAED;;OAEG;IACI,YAAY;QACjB,OAAO,IAAI,CAAC,QAAQ,CAAC,UAAU,EAAE,CAAC;IACpC,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,YAAY;QACvB,IAAI,UAAU,GAAG,CAAC,MAAM,IAAI,CAAC,QAAQ,CAAC,UAAU,EAAE,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,CAAC;QAExE,UAAU,GAAG,UAAU,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;QAEpD,OAAO,UAAU,CAAC;IACpB,CAAC;CACF;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,uBAAuB,CAAC,OAAgB,EAAE,EAAU;IAClE,MAAM,iBAAiB,GAAG,IAAI,iBAAiB,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IAC7D,MAAM,OAAO,GAAG,OAAO,CAAC,WAAW,CAAC,eAAe,EAAE,EAAE,CAAC,CAAC;IAEzD,OAAO,IAAI,KAAK,CAAC,iBAAiB,EAAE;QAClC,GAAG,CAAC,MAAM,EAAE,IAAI,EAAE,QAAQ;YACxB,IAAI,IAAI,IAAI,MAAM,EAAE,CAAC;gBACnB,OAAO,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC;YAC7C,CAAC;YACD,MAAM,KAAK,GAAI,OAAe,CAAC,IAAI,CAAC,CAAC;YAErC,IAAI,OAAO,KAAK,KAAK,UAAU,EAAE,CAAC;gBAChC,OAAO,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YAC7B,CAAC;YACD,OAAO,KAAK,CAAC;QACf,CAAC;KACF,CAAkC,CAAC;AACtC,CAAC"}

package/dist/controls/LookupDropdown.d.ts

@@ -1,5 +1,26 @@
 /** biome-ignore-all lint/suspicious/noExplicitAny: needed flexibility */
 import type { Locator } from '@playwright/test';
+/**
+ * Typed proxy for a lookup or dropdown field (`control_type: "lookup"` or
+ * `"dropdown"`) on a Thinkwise form screen.
+ *
+ * **How to use:** You never construct this directly. The generated subject
+ * component class exposes properties of type `ILookupDropdown` for each
+ * lookup/dropdown on the form:
+ *
+ * ```ts
+ * // Two interaction styles:
+ *
+ * // 1. Type + pick from the auto-complete list:
+ * await subject.form.countryLookup.lookupSelect('Netherlands');
+ *
+ * // 2. Click to open the dropdown then pick:
+ * await subject.form.statusDropdown.selectOption('Active');
+ * ```
+ *
+ * The returned value is a **Proxy** — it works as both a Playwright `Locator`
+ * and a typed control with named helper methods.
+ */
 export type ILookupDropdown = Locator & ILookupDropdownCore;
 export type ILookupDropdownCore = {
     lookupSelect(optionToSelect: string): Promise<void>;
@@ -10,4 +31,12 @@ export type ILookupDropdownCore = {
     inputValue(): Promise<string>;
     clear(): Promise<void>;
 };
+/**
+ * Creates an `ILookupDropdown` proxy that intercepts named `LookupDropdown` methods from
+ * the class prototype and falls back to the base `Locator` for everything else, effectively
+ * merging the typed dropdown interface with standard Playwright locator capabilities.
+ * @param context - The parent locator to scope the control within.
+ * @param id - The field identifier used to build the scoped locator.
+ * @returns A proxy combining `ILookupDropdownCore` methods and `Locator` capabilities.
+ */
 export declare function createLookupDropdown(context: Locator, id: string): ILookupDropdown;