@thinkwise/testwise 0.2.67 → 0.2.99

package/components/BaseComponentObjects.ts

@@ -1,6 +1,23 @@
 import type { Locator, Page } from '@playwright/test';
 import type { IComponentObjects } from '../interfaces/IComponentObjects.js';
 
+/**
+ * Abstract base class for every `*Objects` locator class in `components/` and
+ * `controls/`.
+ *
+ * **What it does:** Sets up two universal locators that every component needs:
+ * - `context` — the scoped root `Locator` passed in from the component. All
+ *   descendant locator lookups are chained from this, so the component only
+ *   sees elements within its own section of the page.
+ * - `mainHeader` — a `main header` locator used as a presence anchor to
+ *   confirm the screen is fully rendered before asserting.
+ *
+ * **For contributors:** When adding a new component, create
+ * `<Name>Objects.ts` that extends this class. Put ALL selector logic (every
+ * `getByTestId`, `locator`, `getByRole`, etc.) in the `Objects` class. The
+ * companion `<Name>.ts` should only contain interaction logic and must never
+ * contain raw locator strings.
+ */
 export abstract class BaseComponentObjects implements IComponentObjects {
   context: Locator;
   mainHeader: Locator;

package/components/action-bar/ActionBar.ts

@@ -1,6 +1,11 @@
 import type { Locator, Page } from '@playwright/test';
 import { ActionBarObjects, ActionBarOverflowableObjects } from './ActionBarObjects.js';
 
+/**
+ * Internal helper used by `ActionBar` to group and expose action button
+ * interactions. Handles overflow menus where actions are hidden behind a
+ * "more" button.
+ */
 class ActionBarActions {
   private _objects: ActionBarOverflowableObjects;
 
@@ -84,66 +89,49 @@ class ActionBarActions {
   public getCubeViewButtons = (): Locator => this._objects.cubeViewButtons();
   public getCubeViewButtonById = (id: string): Locator => this._objects.cubeViewButtonById(id);
   public getCubeViewButtonByLabel = (label: string): Locator => this._objects.cubeViewButtonByLabel(label);
+
+  // Generic item lookup for ids not covered by the typed getters above
+  public getItemByTestId = (testId: string): Locator => this._objects.itemByTestId(testId);
 }
 
+/**
+ * Wraps the Thinkwise action-bar toolbar that sits above a grid or form and
+ * contains buttons for CRUD operations (New, Edit, Save, Delete, Refresh)
+ * plus any custom task actions defined in the Thinkwise model.
+ *
+ * In generated subject classes this is exposed as a typed `actionBar` property.
+ * Overflow actions (hidden under a "more" button) are accessible via `actionBar.overflowMenu`.
+ *
+ * @example
+ * await subject.actionBar.getButtonByText('New').click();
+ * await subject.actionBar.getButtonByText('Save').click();
+ * // For overflow actions:
+ * await subject.actionBar.overflowMenu.getButtonByText('Export').click();
+ */
 export class ActionBar extends ActionBarActions {
   private _actionBarObjects: ActionBarObjects;
-  private _overflowMenu: ActionBarOverflow;
+  public overflowMenu: ActionBarActions;
 
   constructor(actionBarContext: Locator) {
     super(actionBarContext);
     this._actionBarObjects = new ActionBarObjects(actionBarContext.page(), actionBarContext);
-    this._overflowMenu = new ActionBarOverflow(actionBarContext.page());
+
+    const overflowInstance = new ActionBarOverflow(actionBarContext.page());
+    this.overflowMenu = new Proxy(overflowInstance, {
+      get: (target, prop, receiver) => {
+        const value = Reflect.get(target, prop, receiver);
+        if (typeof value === 'function') {
+          return (...args: unknown[]) =>
+            wrapWithOverflowOpen(this, () => (value as (...args: unknown[]) => Locator).apply(target, args));
+        }
+        return value;
+      }
+    }) as ActionBarActions;
   }
 
   public openOverflowMenu = async (): Promise<void> => {
     await this._actionBarObjects.overflowMenuButton().click();
   };
-
-  overflowMenu = {
-    getFilterButton: () => wrapWithOverflowOpen(this, () => this._overflowMenu.getFilterButton()),
-
-    getQuickFilterButton: () => wrapWithOverflowOpen(this, () => this._overflowMenu.getQuickFilterButton()),
-
-    getClearAllFiltersButton: () => wrapWithOverflowOpen(this, () => this._overflowMenu.getClearAllFiltersButton()),
-
-    getSortButton: () => wrapWithOverflowOpen(this, () => this._overflowMenu.getSortButton()),
-
-    getRestoreSortOrderButton: () => wrapWithOverflowOpen(this, () => this._overflowMenu.getRestoreSortOrderButton()),
-
-    getImportButton: () => wrapWithOverflowOpen(this, () => this._overflowMenu.getImportButton()),
-
-    getExportButton: () => wrapWithOverflowOpen(this, () => this._overflowMenu.getExportButton()),
-
-    getExportImmediatelyButton: () => wrapWithOverflowOpen(this, () => this._overflowMenu.getExportImmediatelyButton()),
-
-    getMassUpdateButton: () => wrapWithOverflowOpen(this, () => this._overflowMenu.getMassUpdateButton()),
-
-    getUpScreenTypeButton: () => wrapWithOverflowOpen(this, () => this._overflowMenu.getUpScreenTypeButton()),
-
-    getUpDetailSettingsButton: () => wrapWithOverflowOpen(this, () => this._overflowMenu.getUpDetailSettingsButton()),
-
-    getUpManagePrefiltersButton: () =>
-      wrapWithOverflowOpen(this, () => this._overflowMenu.getUpManagePrefiltersButton()),
-
-    getUpGridSettingsButton: () => wrapWithOverflowOpen(this, () => this._overflowMenu.getUpGridSettingsButton()),
-
-    getCubeSortButton: () => wrapWithOverflowOpen(this, () => this._overflowMenu.getCubeSortButton()),
-
-    getCubePivotSettingsButton: () => wrapWithOverflowOpen(this, () => this._overflowMenu.getCubePivotSettingsButton()),
-
-    getCubeChartSettingsButton: () => wrapWithOverflowOpen(this, () => this._overflowMenu.getCubeChartSettingsButton()),
-
-    getExportPivotButton: () => wrapWithOverflowOpen(this, () => this._overflowMenu.getExportPivotButton()),
-
-    getDeleteCubeViewButton: () => wrapWithOverflowOpen(this, () => this._overflowMenu.getDeleteCubeViewButton()),
-
-    getSaveAsCubeViewButton: () => wrapWithOverflowOpen(this, () => this._overflowMenu.getSaveAsCubeViewButton()),
-
-    getCollapseAllButton: () => wrapWithOverflowOpen(this, () => this._overflowMenu.getCollapseAllButton()),
-
-    getExpandAllButton: () => wrapWithOverflowOpen(this, () => this._overflowMenu.getExpandAllButton())
-  };
 }
 
 export class ActionBarOverflow extends ActionBarActions {

package/components/action-bar/ActionBarObjects.ts

@@ -97,6 +97,8 @@ export class ActionBarOverflowableObjects extends BaseComponentObjects {
   // Prefilter buttons: data-testid like: "prefilter-actionbar-group-other__<something>"
   public prefilterButtonById = (id: string) =>
     this.context.getByTestId(new RegExp(`^prefilter-actionbar-group-${id}$`));
+
+  public itemByTestId = (testId: string) => this.context.getByTestId(testId);
 }
 
 export class ActionBarObjects extends ActionBarOverflowableObjects {

package/components/action-bar/CustomActionBar.ts

@@ -1,5 +1,11 @@
 import { ActionBar } from './ActionBar.js';
 
+/**
+ * Extension point for a customised action bar that behaves identically to
+ * `ActionBar` but can be subclassed to add subject-specific button helpers.
+ * Used in generated subject classes when the pipeline detects a custom action
+ * bar configuration.
+ */
 export class CustomActionBar extends ActionBar {
   // What should this do differently?
 }

package/components/cardlist/Cardlist.ts

@@ -1,6 +1,12 @@
 import type { Locator } from '@playwright/test';
 import { CardlistObjects } from './CardlistObjects.js';
 
+/**
+ * Wraps the Thinkwise card-list component that displays data as a grid of
+ * visual cards instead of a traditional table.
+ *
+ * In generated subject classes this is exposed as a typed `cardlist` property.
+ */
 export class Cardlist {
   cardlistObjects: CardlistObjects;
 

package/components/chart/Chart.ts

@@ -1,6 +1,12 @@
 import type { Locator } from '@playwright/test';
 import { ChartObjects } from './ChartObjects.js';
 
+/**
+ * Wraps the Thinkwise chart component that renders data as bar, line, or pie
+ * charts within a subject screen.
+ *
+ * In generated subject classes this is exposed as a typed `chart` property.
+ */
 export class Chart {
   chartObjects: ChartObjects;
 

package/components/combined-filter/CombinedFilter.ts

@@ -1,6 +1,15 @@
 import type { Locator } from '@playwright/test';
 import { CombinedFilterObjects } from './CombinedFIlterObjects.js';
 
+/**
+ * Wraps the Thinkwise combined-filter component that merges the filter form
+ * and prefilter list into a single collapsible panel alongside a grid.
+ *
+ * In generated subject classes this is exposed as a typed `combinedFilter` property.
+ *
+ * @example
+ * await subject.combinedFilter.context.waitFor({ state: 'visible' });
+ */
 export class CombinedFilter {
   combinedFilterObjects: CombinedFilterObjects;
 

package/components/cube-view-bar/CubeViewBar.ts

@@ -1,6 +1,12 @@
 import type { Locator } from '@playwright/test';
 import { CubeViewBarObjects } from './CubeViewBarObjects.js';
 
+/**
+ * Wraps the Thinkwise cube-view-bar component that provides navigation and
+ * filter controls for OLAP cube / pivot analysis screens.
+ *
+ * In generated subject classes this is exposed as a typed `cubeViewBar` property.
+ */
 export class CubeViewBar {
   cubeViewBarObjects: CubeViewBarObjects;
 

package/components/export/ExportComponent.ts

@@ -5,6 +5,18 @@ import { ExportComponentObjects } from './ExportComponentObjects.js';
 
 // ToDo: Expand on the selectColumns to select by columnId/testId, or what makes sense to empower the end-user
 // ToDo: Make changes to  completeExport be able to parse based on the data type selected
+/**
+ * Drives the Thinkwise data-export panel: choose rows (all or selected),
+ * select columns, pick a format (CSV, XLSX, XLS), download, and optionally
+ * parse the downloaded CSV back into a JavaScript array for assertions.
+ *
+ * Access via `page.components.export` — no need to construct this yourself.
+ *
+ * @example
+ * await page.components.export.exportAllRows();
+ * await page.components.export.selectFormat(ExportFormat.XLSX);
+ * await page.components.export.completeExport();
+ */
 export class ExportComponent {
   private _page: Page;
   private _objects: ExportComponentObjects;

package/components/filter/ExcelStyleFilterPopup.ts

@@ -1,6 +1,17 @@
 import type { Locator, Page } from '@playwright/test';
 import { ExcelStyleFilterPopupObjects } from './ExcelStyleFilterPopupObjects.js';
 
+/**
+ * Wraps the Excel-style column filter popup in a Thinkwise grid.
+ * This popup opens when a user right-clicks a column header and allows
+ * filtering by selecting individual cell values, much like Excel's auto-filter.
+ *
+ * Used internally by `GridColumnControl.filterByColumnValueExcelStyle()`.
+ *
+ * @example
+ * // Via GridColumnControl (preferred):
+ * await subject.grid.statusColumn.filterByColumnValueExcelStyle('Active');
+ */
 export class ExcelStyleFilterPopup {
   private _objects: ExcelStyleFilterPopupObjects;
 
@@ -33,6 +44,26 @@ export class ExcelStyleFilterPopup {
     await this._objects.checkboxSelectAllButton(fieldTestId).click();
   }
 
+  public async deselectAll(fieldTestId: string): Promise<void> {
+    const selectAllCheckbox = await this._objects.checkboxSelectAllButton(fieldTestId);
+    await this.waitForOpen();
+
+    // Everything is already deselected
+    if ((await selectAllCheckbox.locator('[data-testid="CheckBoxOutlineBlankIcon"]').count()) > 0) {
+      return;
+    }
+
+    // Some things are selected - first click will select everything
+    if ((await selectAllCheckbox.locator('[data-testid="CheckBoxIndeterminateIcon"]').count()) > 0) {
+      await selectAllCheckbox.click();
+    }
+
+    // Everything is selected
+    if ((await selectAllCheckbox.locator('[data-testid="CheckBoxIcon"]').count()) > 0) {
+      await selectAllCheckbox.click();
+    }
+  }
+
   public async clickCheckboxItem(fieldTestId: string, value: string): Promise<void> {
     await this.waitForOpen();
 
@@ -51,11 +82,13 @@ export class ExcelStyleFilterPopup {
     return this._objects.toTimeInput(fieldTestId);
   }
 
-  public setFromTime = async (fieldTestId: string, value: string): Promise<void> => this.fillAndEnter(fieldTestId, value);
+  public setFromTime = async (fieldTestId: string, value: string): Promise<void> =>
+    this.fillAndEnter(fieldTestId, value);
 
   public setToTime = async (fieldTestId: string, value: string): Promise<void> => this.fillAndEnter(fieldTestId, value);
 
-  public setFromDate = async (fieldTestId: string, value: string): Promise<void> => this.fillAndEnter(fieldTestId, value);
+  public setFromDate = async (fieldTestId: string, value: string): Promise<void> =>
+    this.fillAndEnter(fieldTestId, value);
 
   public setToDate = async (fieldTestId: string, value: string): Promise<void> => this.fillAndEnter(fieldTestId, value);
 

package/components/filter/FilterForm.ts

@@ -1,6 +1,16 @@
 import type { Locator } from '@playwright/test';
 import { FilterFormObjects } from './FilterFormObjects.js';
 
+/**
+ * Wraps the Thinkwise filter form that appears in the filter panel alongside
+ * a grid. Provides access to the filter form's context locator for scoped
+ * assertions and interactions.
+ *
+ * In generated subject classes this is exposed as a typed component property.
+ *
+ * @example
+ * await subject.filterForm.context.waitFor({ state: 'visible' });
+ */
 export class FilterForm {
   filterFormObjects: FilterFormObjects;
 

package/components/filter/FilterPopup.ts

@@ -2,6 +2,19 @@ import type { Locator, Page } from '@playwright/test';
 import { PopUpComponent } from '../pop-up/PopUpComponent.js';
 import { FilterPopupObjects } from './FilterPopupObjects.js';
 
+/**
+ * Wraps the Thinkwise interval/range filter popup that appears when filtering
+ * date, time, or numeric columns with a "between" style filter.
+ *
+ * Extends `PopUpComponent` so all base popup actions (confirm, cancel) work
+ * here too. The `IntervalType` union type controls which date/time variant
+ * of the popup is targeted.
+ *
+ * @example
+ * // Open the filter popup, set a date range, and confirm:
+ * await subject.grid.hireDateColumn.openExcelStyleFilterPopup();
+ * // Then interact with the resulting FilterPopup instance.
+ */
 export type IntervalType =
   | 'date'
   | 'date-and-time'
@@ -93,6 +106,10 @@ export class FilterPopup {
     return this._filterPopupObjects.fieldInput(fieldId);
   }
 
+  public fieldInputChip(fieldId: string, value: string): Locator {
+    return this._filterPopupObjects.fieldInputChip(fieldId, value);
+  }
+
   public valueInput(fieldId: string, part: string): Locator {
     return this._filterPopupObjects.valueInput(fieldId, part);
   }
@@ -138,21 +155,25 @@ export class FilterPopup {
     await this._filterPopupObjects.timeOperatorControl().click();
   }
 
-  public intervalSelector(rowIndex: number, colId: string): Locator {
-    return this._filterPopupObjects.intervalSelector(rowIndex, colId);
+  public intervalSelector(colId: string): Locator {
+    return this._filterPopupObjects.intervalSelector(colId);
   }
 
-  public intervalSelectorInput(rowIndex: number, colId: string): Locator {
-    return this._filterPopupObjects.intervalSelectorInput(rowIndex, colId);
+  public intervalSelectorInput(colId: string): Locator {
+    return this._filterPopupObjects.intervalSelectorInput(colId);
   }
 
-  public async openInterval(rowIndex: number, colId: string): Promise<void> {
+  public async openInterval(colId: string, options?: { rowIndex?: number }): Promise<void> {
     await this.waitForOpen();
-    await this._filterPopupObjects.intervalSelectorInput(rowIndex, colId).click();
+    if (options?.rowIndex !== undefined) {
+      await this._filterPopupObjects.intervalSelectorInputByRowIndex(options.rowIndex, colId).click();
+    } else {
+      await this._filterPopupObjects.intervalSelectorInput(colId).click();
+    }
   }
 
-  public async setInterval(rowIndex: number, colId: string, kind: IntervalType): Promise<void> {
-    await this.openInterval(rowIndex, colId);
+  public async setInterval(colId: string, kind: IntervalType, options?: { rowIndex?: number }): Promise<void> {
+    await this.openInterval(colId, options);
     await this.pickAutocomplete(kind);
   }
 
@@ -170,7 +191,7 @@ export class FilterPopup {
     const emptyRow = this._filterPopupObjects.emptySelectFieldRow();
 
     if (await emptyRow.count()) {
-      await this._filterPopupObjects.emptySelectFieldRowButton().click();
+      await this._filterPopupObjects.emptySelectFieldRowButton().press('Enter');
     } else {
       await this._filterPopupObjects.selectFieldButton().click();
     }

package/components/filter/FilterPopupObjects.ts

@@ -23,6 +23,9 @@ export class FilterPopupObjects extends BaseComponentObjects {
 
   public fieldInput = (fieldId: string) => this.context.getByTestId(`form-field__${fieldId}__input`);
 
+  public fieldInputChip = (fieldId: string, value: string) =>
+    this.context.getByTestId(`form-field__${fieldId}__input`).getByTestId(`autocomplete-tag-${value}`);
+
   public prefilterNameInput = () => this.context.getByTestId('prefilter__name__input');
 
   public saveAsOption = () => this._page.getByRole('menuitem', { name: 'Save' });
@@ -43,11 +46,15 @@ export class FilterPopupObjects extends BaseComponentObjects {
   public timeOperatorControl = () =>
     this.context.getByTestId('form-field__event-time__operator__control').getByRole('button', { name: 'Open' });
 
-  public intervalSelector = (rowIndex: number, colId: string) =>
+  public intervalSelector = (colId: string) => this.context.locator(`[data-testid$="__${colId}__select-interval"]`);
+
+  public intervalSelectorInput = (colId: string) => this.intervalSelector(colId).getByTestId('select-interval__input');
+
+  public intervalSelectorByRowIndex = (rowIndex: number, colId: string) =>
     this.context.getByTestId(`advanced-filter-grid__row${rowIndex}__${colId}__select-interval`);
 
-  public intervalSelectorInput = (rowIndex: number, colId: string) =>
-    this.intervalSelector(rowIndex, colId).getByTestId('select-interval__input');
+  public intervalSelectorInputByRowIndex = (rowIndex: number, colId: string) =>
+    this.intervalSelectorByRowIndex(rowIndex, colId).getByTestId('select-interval__input');
 
   public autocompleteOption = (key: AutocompleteKey) => this._page.getByTestId(`autocomplete-option-${key}`);
 

package/components/filter/FindForm.ts

@@ -1,3 +1,10 @@
+/**
+ * Placeholder for the Thinkwise "Find" form — a search dialog used to
+ * quickly locate records by keyword across multiple fields.
+ *
+ * This component is under development. Check back for typed interaction
+ * helpers in a future release.
+ */
 export class FindForm {
   // do stuff
 }

package/components/filter/ManagePrefilterPopup.ts

@@ -2,6 +2,17 @@ import type { Locator, Page } from '@playwright/test';
 import { PopUpComponent } from '../pop-up/PopUpComponent.js';
 import { ManagePrefilterPopupObjects } from './ManagePrefilterPopupObjects.js';
 
+/**
+ * Wraps the Thinkwise "Manage Prefilter" popup that lets users create, edit,
+ * and delete personal prefilters from within a running test.
+ *
+ * Access via `page.components.managePrefilterPopup` — no need to construct
+ * this yourself. Extends `PopUpComponent` so all base popup methods are also
+ * available.
+ *
+ * @example
+ * await page.components.managePrefilterPopup.dialog().waitFor({ state: 'visible' });
+ */
 export class ManagePrefilterPopup extends PopUpComponent {
   private readonly _page: Page;
   private _managePrefilterPopupObjects: ManagePrefilterPopupObjects;

package/components/form/Form.ts

@@ -1,6 +1,22 @@
 import type { Locator } from '@playwright/test';
 import { FormObjects } from './FormObjects.js';
 
+/**
+ * Wraps a Thinkwise form screen component. Provides locator helpers for
+ * finding fields by value and by column ID.
+ *
+ * In generated subject classes, you interact with `Form` indirectly through
+ * the typed `Components/` class (e.g. `EmployeeFormComponent`) which exposes
+ * named, typed control properties. Use `Form` directly only when you need
+ * raw field lookups not covered by the generated accessors.
+ *
+ * @example
+ * // Via generated subject (preferred):
+ * await subject.form.firstNameField.fill('Jane');
+ *
+ * // Via raw Form helper:
+ * const field = subject.form.getFieldByColId('first_name');
+ */
 export class Form {
   private _objects: FormObjects;
 

package/components/grid/Grid.ts

@@ -4,6 +4,23 @@ import { escapeRegex } from '../../helpers/RegexHelper.js';
 import { ExcelStyleFilterPopup } from '../index.js';
 import { GridObjects } from './GridObjects.js';
 
+/**
+ * Wraps a Thinkwise grid (list view) component. Provides row/cell navigation,
+ * filtering, sorting, and value-reading helpers.
+ *
+ * In generated subject classes, you interact with `Grid` indirectly through
+ * the typed `Components/` class (e.g. `EmployeeGridComponent`) which exposes
+ * named `IGridColumnControl` properties per column. Use `Grid` directly only
+ * for low-level operations not covered by the generated accessors.
+ *
+ * @example
+ * // Via generated subject (preferred):
+ * const names = await subject.grid.employeeNameColumn.getCellValues();
+ *
+ * // Via raw Grid helper:
+ * await subject.grid.clickRow(0);
+ * const count = await subject.grid.getRowCount();
+ */
 export class Grid {
   private _gridObjects: GridObjects;
   private _page: Page;
@@ -168,7 +185,7 @@ export class Grid {
     await this._excelStyleFilterPopup.waitForOpen();
 
     if (deselectAll) {
-      await this._excelStyleFilterPopup.clickSelectAll(columnId);
+      await this._excelStyleFilterPopup.deselectAll(columnId);
     }
 
     await this._excelStyleFilterPopup.clickCheckboxItem(columnId, valueToSelect);

package/components/maps/Maps.ts

@@ -1,6 +1,12 @@
 import type { Locator } from '@playwright/test';
 import { MapsObjects } from './MapsObjects.js';
 
+/**
+ * Wraps the Thinkwise maps component that displays geographical data on an
+ * interactive map.
+ *
+ * In generated subject classes this is exposed as a typed `maps` property.
+ */
 export class Maps {
   mapsObjects: MapsObjects;
 

package/components/menu/ListBarMenuComponent.ts

@@ -1,6 +1,16 @@
 import type { Locator, Page } from '@playwright/test';
 import { ListBarMenuComponentObjects } from './ListBarMenuComponentObjects.js';
 
+/**
+ * Wraps the Thinkwise list-bar hamburger menu used to navigate between
+ * subjects and module groups.
+ *
+ * Access via `page.components.listBarMenu` — no need to construct this yourself.
+ *
+ * @example
+ * // Navigate to the Employee subject via the menu:
+ * await page.components.listBarMenu.openListBarMenuItem('HR', 'Employee');
+ */
 export class ListBarMenuComponent {
   private _objects: ListBarMenuComponentObjects;
 

package/components/pivot-grid/PivotGrid.ts

@@ -1,6 +1,12 @@
 import type { Locator } from '@playwright/test';
 import { PivotGridObjects } from './PivotGridObjects.js';
 
+/**
+ * Wraps the Thinkwise pivot-grid component that presents data in a
+ * cross-tabulated matrix view for analysis.
+ *
+ * In generated subject classes this is exposed as a typed `pivotGrid` property.
+ */
 export class PivotGrid {
   pivotGridObjects: PivotGridObjects;
 

package/components/pivot-grid/PivotGridFieldList.ts

@@ -1,6 +1,13 @@
 import type { Locator } from '@playwright/test';
 import { PivotGridFieldListObjects } from './PivotGridFieldListObjects.js';
 
+/**
+ * Wraps the Thinkwise pivot-grid field list panel that lets users drag
+ * dimensions and measures into rows, columns, and value areas of the pivot.
+ *
+ * In generated subject classes this is exposed alongside `PivotGrid` as a
+ * typed `pivotGridFieldList` property.
+ */
 export class PivotGridFieldList {
   pivotGridFieldListObjects: PivotGridFieldListObjects;
 

package/components/pop-up/AllRowsPopUp.ts

@@ -2,6 +2,18 @@ import type { Locator, Page } from '@playwright/test';
 import { pollUntil } from '../../helpers/Poll.js';
 import { AllRowsPopupObjects } from './AllRowsPopUpObjects.js';
 
+/**
+ * Handles the "Apply to all rows or selected rows?" popup that Thinkwise
+ * shows for bulk operations (mass update, mass delete).
+ *
+ * @example
+ * // Select all rows and confirm:
+ * await subject.actionBar.clickDeleteAllRows();
+ * const popup = new AllRowsPopup(page);
+ * await popup.waitForOpen();
+ * await popup.allRowsRadioButton().click();
+ * await popup.confirmButton().click();
+ */
 export class AllRowsPopup {
   private readonly deletePopup: boolean;
   private _allRowsPopupObjects: AllRowsPopupObjects;

package/components/pop-up/PopUpComponent.ts

@@ -1,6 +1,17 @@
 import type { Locator, Page } from '@playwright/test';
 import { PopUpComponentObjects } from './PopUpComponentObjects.js';
 
+/**
+ * Wraps the Thinkwise modal/popup dialog that appears for confirmations,
+ * warnings, and input prompts (e.g. "Are you sure?" dialogs, save conflicts).
+ *
+ * Access via `page.components.popUp` — no need to construct this yourself.
+ *
+ * @example
+ * // Confirm a delete prompt:
+ * await page.components.popUp.getActionButtonByText('Yes').click();
+ * const msg = await page.components.popUp.getContentText();
+ */
 export class PopUpComponent {
   private _objects: PopUpComponentObjects;
 

package/components/prefilter-list/PrefilterList.ts

@@ -1,6 +1,15 @@
 import type { Locator } from '@playwright/test';
 import { PrefilterListObjects } from './PrefilterListObjects.js';
 
+/**
+ * Wraps the Thinkwise prefilter-list panel that shows available prefilters
+ * for a subject. Enables selecting and activating prefilters in tests.
+ *
+ * In generated subject classes this is exposed as a typed `prefilterList` property.
+ *
+ * @example
+ * await subject.prefilterList.context.getByText('Active employees').click();
+ */
 export class PrefilterList {
   prefilterListObjects: PrefilterListObjects;
 

package/components/preview/Preview.ts

@@ -1,6 +1,12 @@
 import type { Locator } from '@playwright/test';
 import { PreviewObjects } from './PreviewObjects.js';
 
+/**
+ * Wraps the Thinkwise preview component that shows a read-only rendered
+ * preview of a report or document within a subject screen.
+ *
+ * In generated subject classes this is exposed as a typed `preview` property.
+ */
 export class Preview {
   previewObjects: PreviewObjects;
 

package/components/report-bar/ReportBar.ts

@@ -1,6 +1,12 @@
 import type { Locator } from '@playwright/test';
 import { ReportBarObjects } from './ReportBarObjects.js';
 
+/**
+ * Wraps the Thinkwise report-bar component that provides controls for
+ * selecting and generating reports tied to a subject.
+ *
+ * In generated subject classes this is exposed as a typed `reportBar` property.
+ */
 export class ReportBar {
   reportBarObjects: ReportBarObjects;
 

package/components/report-tiles/ReportTiles.ts

@@ -1,6 +1,12 @@
 import type { Locator } from '@playwright/test';
 import { ReportTilesObjects } from './ReportTilesObjects.js';
 
+/**
+ * Wraps the Thinkwise report-tiles component that displays available reports
+ * as clickable tiles on a dashboard-style screen.
+ *
+ * In generated subject classes this is exposed as a typed `reportTiles` property.
+ */
 export class ReportTiles {
   reportTilesObjects: ReportTilesObjects;