@thinkwise/testwise 0.2.67 → 0.2.103

package/components/scheduler/Scheduler.ts

@@ -1,6 +1,12 @@
 import type { Locator } from '@playwright/test';
 import { SchedulerObjects } from './SchedulerObjects.js';
 
+/**
+ * Wraps the Thinkwise scheduler component that renders time-based data as a
+ * calendar / appointment view.
+ *
+ * In generated subject classes this is exposed as a typed `scheduler` property.
+ */
 export class Scheduler {
   treeViewObjects: SchedulerObjects;
 

package/components/snackbar/SnackBar.ts

@@ -1,6 +1,18 @@
 import type { Locator, Page } from '@playwright/test';
 import { SnackBarObjects } from './SnackBarObjects.js';
 
+/**
+ * Wraps the Thinkwise snackbar / toast notification bar shown at the bottom
+ * of the screen after saves, errors, and background operations.
+ *
+ * Access via `page.components.snackBar` — no need to construct this yourself.
+ *
+ * @example
+ * await employee.actionBar.save();
+ * const msg = await page.components.snackBar.getSnackbarText();
+ * // or check visibility:
+ * await expect(page.components.snackBar.getSnackbar()).toBeVisible();
+ */
 export class SnackBarComponent {
   private _objects: SnackBarObjects;
 

package/components/splitter/Splitter.ts

@@ -1,6 +1,12 @@
 import type { Locator } from '@playwright/test';
 import { SplitterObjects } from './SplitterObjects.js';
 
+/**
+ * Wraps the Thinkwise splitter component that divides the screen into
+ * resizable panels (e.g. master/detail split, filter panel divider).
+ *
+ * In generated subject classes this is exposed as a typed `splitter` property.
+ */
 export class Splitter {
   splitterObjects: SplitterObjects;
 

package/components/tab/BaseTab.ts

@@ -1,6 +1,11 @@
 import type { Locator } from '@playwright/test';
 import { BaseTabObjects } from './BaseTabObjects.js';
 
+/**
+ * Shared base class for `Tab` and `DetailTabPage` containing the common
+ * tab-strip interaction methods (open by label, open by index, get active tab).
+ * Do not use this directly — use `Tab` or `DetailTabPage` in tests.
+ */
 export class BaseTab {
   protected _objects: BaseTabObjects;
 

package/components/tab/DetailTabPage.ts

@@ -2,6 +2,17 @@ import type { Locator } from '@playwright/test';
 import { BaseTab } from './BaseTab.js';
 import { DetailTabPageObjects } from './DetailTabPageObjects.js';
 
+/**
+ * Wraps a Thinkwise detail-tab page — a full sub-screen that loads inside a
+ * tab panel, typically showing related data for the selected master record.
+ *
+ * In generated subject classes this is exposed as a typed `detailTabPage`
+ * property. Switch to a detail tab first, then interact with its content.
+ *
+ * @example
+ * await subject.tab.openDetailTabByLabel('Addresses');
+ * await subject.detailTabPage.context.waitFor({ state: 'visible' });
+ */
 export class DetailTabPage extends BaseTab {
   protected _objects: DetailTabPageObjects;
 

package/components/tab/Tab.ts

@@ -2,6 +2,16 @@ import type { Locator } from '@playwright/test';
 import { BaseTab } from './BaseTab.js';
 import { TabObjects } from './TabObjects.js';
 
+/**
+ * Wraps a Thinkwise tab-strip component used to switch between related screens
+ * (e.g. detail tabs, sub-screens within a subject).
+ *
+ * In generated subject classes this is exposed as a typed `tab` property.
+ *
+ * @example
+ * // Navigate to the "Addresses" detail tab:
+ * await subject.tab.openDetailTabByLabel('Addresses');
+ */
 export class Tab extends BaseTab {
   protected _objects: TabObjects;
 

package/components/task/TaskBar.ts

@@ -1,14 +1,24 @@
 import type { Locator } from '@playwright/test';
 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 {
   private _taskBarObjects: 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) {
-    this._taskBarObjects = new TaskBarObjects(taskBarContext.page(), taskBarContext);
+  constructor(context: Locator) {
+    this._taskBarObjects = new TaskBarObjects(context.page(), context);
   }
 
   /** returns all task buttons */

package/components/task/TaskTiles.ts

@@ -1,14 +1,23 @@
 import type { Locator } from '@playwright/test';
 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 {
   private _taskTilesObjects: TaskTilesObjects;
 
   /**
-   * @param taskTilesContext the taskTiles container element
+   * @param context the taskTiles container element
    */
-  constructor(taskTilesContext: Locator) {
-    this._taskTilesObjects = new TaskTilesObjects(taskTilesContext.page(), taskTilesContext);
+  constructor(context: Locator) {
+    this._taskTilesObjects = new TaskTilesObjects(context.page(), context);
   }
 
   /** returns all task tile buttons */

package/components/topbar/TopBar.ts

@@ -1,6 +1,16 @@
 import type { Locator, Page } from '@playwright/test';
 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 {
   private _objects: TopBarObjects;
 

package/components/tree-view/TreeView.ts

@@ -1,6 +1,15 @@
 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 class TreeView {
   treeViewObjects: TreeViewObjects;
 

package/controls/DateControl.ts

@@ -3,6 +3,28 @@
 import type { Locator } from '@playwright/test';
 import { DateControlObjects } from './DateControlObjects.js';
 
+/**
+ * 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 = {
@@ -29,23 +51,40 @@ export class DateControl implements IDateControlCore {
   public async fill(value: string): Promise<void> {
     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.
+   */
   public async clear(): Promise<void> {
     await this._objects.fieldInput().fill('');
   }
 
+  /**
+   * Returns the current raw string value from the underlying date input element.
+   */
   public async inputValue(): Promise<string> {
     return await this._objects.fieldInput().inputValue();
   }
 
+  /**
+   * Returns the Playwright `Locator` for the underlying `<input>` element of the date field.
+   */
   public inputElement(): Locator {
     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: Locator, id: string): IDateControl {
   const inputFieldControl = new DateControl(context, id);
   const locator = context.getByTestId(`form-field__${id}`);

package/controls/FormComboBox.ts

@@ -3,6 +3,28 @@
 import type { Locator } from '@playwright/test';
 import { FormComboBoxObjects } from './FormComboBoxObjects.js';
 
+/**
+ * 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 = {
@@ -40,6 +62,14 @@ class FormComboBox implements IFormComboBoxCore {
   }
 }
 
+/**
+ * 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: Locator, id: string): IFormComboBox {
   const comboBox = new FormComboBox(context, id);
   const locator = context.getByTestId(`form-field__${id}`);

package/controls/GridColumnControl.ts

@@ -5,6 +5,28 @@ import { Grid } from '../components/grid/Grid.js';
 import { escapeRegex } from '../index.js';
 import { GridColumnControlObjects } from './GridColumnControlObjects.js';
 
+/**
+ * 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 = {
@@ -21,7 +43,7 @@ class GridColumnControl implements IGridColumnControlCore {
   private _objects: GridColumnControlObjects;
 
   constructor(gridContext: Locator, id: string) {
-    this._id = id.replace(/-/g, '_');
+    this._id = id;
     this._objects = new GridColumnControlObjects(gridContext, this._id);
     this._grid = new Grid(gridContext);
   }
@@ -48,9 +70,18 @@ class GridColumnControl implements IGridColumnControlCore {
   }
 }
 
+/**
+ * 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: Locator, id: string): IGridColumnControl {
-  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) {

package/controls/InputFieldControl.ts

@@ -3,6 +3,25 @@
 import type { Locator } from '@playwright/test';
 import { InputFieldControlObjects } from './InputFieldControlObjects.js';
 
+/**
+ * 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 = {
@@ -22,31 +41,53 @@ export class InputFieldControl implements ICoreInputFieldControl {
     this._objects = new InputFieldControlObjects(context, id);
   }
 
+  /**
+   * Waits for the field's validation message element to become visible, then returns its text.
+   */
   public async getValidationMessage(): Promise<string> {
     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.
+   */
   public async fill(value: string): Promise<void> {
     await this._objects.fieldInput().fill(value);
   }
 
+  /**
+   * Clicks the underlying input element.
+   */
   public async click(): Promise<void> {
     await this._objects.fieldInput().click();
   }
 
+  /**
+   * Clears the input field by filling it with an empty string.
+   */
   public async clear(): Promise<void> {
     await this._objects.fieldInput().fill('');
   }
 
+  /**
+   * Returns the current string value from the underlying input element.
+   */
   public async inputValue(): Promise<string> {
     return await this._objects.fieldInput().inputValue();
   }
 
+  /**
+   * Returns the Playwright `Locator` for the underlying `<input>` element of the field.
+   */
   public inputElement(): Locator {
     return this._objects.fieldInput();
   }
 
+  /**
+   * Returns the trimmed, whitespace-normalised text content of the field's label element.
+   */
   public async getLabelText(): Promise<string> {
     let returnText = (await this._objects.fieldLabel().textContent()) || '';
 
@@ -56,6 +97,14 @@ export class InputFieldControl implements ICoreInputFieldControl {
   }
 }
 
+/**
+ * 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: Locator, id: string): IInputFieldControl {
   const inputFieldControl = new InputFieldControl(context, id);
   const locator = context.getByTestId(`form-field__${id}`);

package/controls/LookupDropdown.ts

@@ -4,6 +4,27 @@ import type { Locator } from '@playwright/test';
 import { escapeRegex } from '../helpers/RegexHelper.js';
 import { LookupDropdownObjects } from './LookupDropdownObjects.js';
 
+/**
+ * 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 = {
@@ -83,6 +104,14 @@ class LookupDropdown implements ILookupDropdownCore {
   }
 }
 
+/**
+ * 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 function createLookupDropdown(context: Locator, id: string): ILookupDropdown {
   const dropdown = new LookupDropdown(context, id);
   const customProps = new Set(Object.getOwnPropertyNames(LookupDropdown.prototype).filter((p) => p !== 'constructor'));

package/dist/Testwise.js

@@ -6,6 +6,41 @@ import { WaitEventHandler } from './page-extensions/WaitEventHandler.js';
 import { ClickOverride } from './page-overrides/ClickOverride.js';
 import { FillOverride } from './page-overrides/FillOverride.js';
 export * from '@playwright/test';
+/**
+ * The main entry point for the Testwise library.
+ *
+ * **What to import:** Consumer projects import `test` (and optionally
+ * `bddTest`) from `@thinkwise/testwise` instead of from `@playwright/test`.
+ * This gives you a fully-extended fixture with all Testwise capabilities
+ * already wired up:
+ *
+ * ```ts
+ * import { test, expect } from '@thinkwise/testwise';
+ *
+ * test('create employee', async ({ page }) => {
+ *   await page.logIn();
+ *   const emp = await page.subject.EmployeeEditable1Main.goTo();
+ *   await emp.form.firstNameField.fill('Jane');
+ *   await emp.actionBar.save();
+ *   await expect(page.components.snackBar.message).toBeVisible();
+ * });
+ * ```
+ *
+ * **What `test` adds on top of Playwright base:**
+ *
+ * | Layer | What it adds |
+ * |---|---|
+ * | `ClickOverride` / `FillOverride` | Patches `page.click` and `page.fill` to wait for XHR idle after each action |
+ * | `Components` | `page.components` — global Thinkwise UI component instances |
+ * | `GoToDeepLink` | `page.goToDeepLink(path)` — deep-link navigation |
+ * | `LoginFeatures` | `page.logIn()` / `page.logOut()` etc. |
+ * | `UserSimulation` | `page.simulate.*` — keyboard/mouse helpers |
+ * | `WaitEventHandler` | `page.waitEvent(url)` — waits for specific response URLs |
+ * | `SubjectRegistry` | `page.subject.*` — access to all generated subject classes |
+ *
+ * Use `bddTest` instead of `test` when combining Testwise with `playwright-bdd`
+ * step definitions.
+ */
 function combineExtensions(baseTest, ...extensions) {
     return extensions.reduce((test, Extension) => new Extension(test).test, baseTest);
 }

package/dist/Testwise.js.map

@@ -1 +1 @@
-{"version":3,"file":"Testwise.js","sourceRoot":"","sources":["../Testwise.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,IAAI,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,IAAI,IAAI,OAAO,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AACrG,OAAO,EAAE,eAAe,EAAE,MAAM,sCAAsC,CAAC;AACvE,OAAO,EAAE,gBAAgB,EAAE,MAAM,uCAAuC,CAAC;AACzE,OAAO,EAAE,aAAa,EAAE,MAAM,mCAAmC,CAAC;AAClE,OAAO,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AAGhE,cAAc,kBAAkB,CAAC;AAEjC,SAAS,iBAAiB,CAAC,QAAc,EAAE,GAAG,UAAkD;IAC9F,OAAO,UAAU,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,SAAS,EAAE,EAAE,CAAC,IAAI,SAAS,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;AACpF,CAAC;AAED,MAAM,UAAU,GAAG;IACjB,mBAAmB;IACnB,aAAa;IACb,YAAY;IAEZ,iBAAiB;IACjB,UAAU;IACV,YAAY;IACZ,aAAa;IACb,cAAc;IACd,gBAAgB;IAChB,eAAe;CAChB,CAAC;AAEF,MAAM,CAAC,MAAM,IAAI,GAAS,iBAAiB,CAAC,IAAI,EAAE,GAAG,UAAU,CAAC,CAAC;AAEjE,MAAM,CAAC,MAAM,OAAO,GAAS,iBAAiB,CAAC,OAAO,EAAE,GAAG,UAAU,CAAC,CAAC"}
+{"version":3,"file":"Testwise.js","sourceRoot":"","sources":["../Testwise.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,IAAI,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,IAAI,IAAI,OAAO,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AACrG,OAAO,EAAE,eAAe,EAAE,MAAM,sCAAsC,CAAC;AACvE,OAAO,EAAE,gBAAgB,EAAE,MAAM,uCAAuC,CAAC;AACzE,OAAO,EAAE,aAAa,EAAE,MAAM,mCAAmC,CAAC;AAClE,OAAO,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AAGhE,cAAc,kBAAkB,CAAC;AAEjC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,SAAS,iBAAiB,CAAC,QAAc,EAAE,GAAG,UAAkD;IAC9F,OAAO,UAAU,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,SAAS,EAAE,EAAE,CAAC,IAAI,SAAS,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;AACpF,CAAC;AAED,MAAM,UAAU,GAAG;IACjB,mBAAmB;IACnB,aAAa;IACb,YAAY;IAEZ,iBAAiB;IACjB,UAAU;IACV,YAAY;IACZ,aAAa;IACb,cAAc;IACd,gBAAgB;IAChB,eAAe;CAChB,CAAC;AAEF,MAAM,CAAC,MAAM,IAAI,GAAS,iBAAiB,CAAC,IAAI,EAAE,GAAG,UAAU,CAAC,CAAC;AAEjE,MAAM,CAAC,MAAM,OAAO,GAAS,iBAAiB,CAAC,OAAO,EAAE,GAAG,UAAU,CAAC,CAAC"}

package/dist/artifact-builder/ArtifactManager.d.ts

@@ -1,7 +1,24 @@
+import { PipelinePaths } from './helpers/PipelinePaths.js';
+/**
+ * Manages backup and restore of the `test-artifacts/` directory to protect
+ * against failed or partial pipeline runs.
+ *
+ * **What it does:**
+ * - Before the pipeline writes any new files it calls `performBackup()` to
+ *   copy the existing `test-artifacts/` folder into a sibling
+ *   `@thinkwise/backups/test-artifacts/` package that survives `node_modules`
+ *   reinstalls.
+ * - If the pipeline fails, the caller invokes `restoreBackup()` to reinstate
+ *   the last known-good artifacts so the consumer project's tests remain
+ *   runnable while the issue is investigated.
+ *
+ * **When it is called:** Automatically by `sync.js` at the start and on
+ * failure of every `testwise sync` run. You do not need to call it manually.
+ */
 export declare class ArtifactManager {
     private _backupPath;
     private _artifactPath;
-    constructor();
+    constructor(paths?: PipelinePaths);
     performBackup(): void;
     backupExists(): boolean;
     restoreBackup(): void;

package/dist/artifact-builder/ArtifactManager.js

@@ -1,12 +1,34 @@
 import * as fs from 'node:fs';
 import * as path from 'node:path';
 import { fileURLToPath } from 'node:url';
+import { PipelinePaths } from './helpers/PipelinePaths.js';
+/**
+ * Manages backup and restore of the `test-artifacts/` directory to protect
+ * against failed or partial pipeline runs.
+ *
+ * **What it does:**
+ * - Before the pipeline writes any new files it calls `performBackup()` to
+ *   copy the existing `test-artifacts/` folder into a sibling
+ *   `@thinkwise/backups/test-artifacts/` package that survives `node_modules`
+ *   reinstalls.
+ * - If the pipeline fails, the caller invokes `restoreBackup()` to reinstate
+ *   the last known-good artifacts so the consumer project's tests remain
+ *   runnable while the issue is investigated.
+ *
+ * **When it is called:** Automatically by `sync.js` at the start and on
+ * failure of every `testwise sync` run. You do not need to call it manually.
+ */
 export class ArtifactManager {
-    constructor() {
+    constructor(paths) {
+        const p = paths ?? new PipelinePaths();
+        this._artifactPath = p.testArtifacts;
+        // The backup is stored in the sibling @thinkwise/backups package so it
+        // survives reinstalls of this package. Three levels up from
+        // dist/artifact-builder/ lands at node_modules/@thinkwise/ (the org scope
+        // folder), and from there we descend into the backups package.
         const _filename = fileURLToPath(import.meta.url);
         const _dirname = path.dirname(_filename);
         this._backupPath = path.resolve(_dirname, '..', '..', '..', 'backups', 'test-artifacts');
-        this._artifactPath = path.resolve(_dirname, '..', '..', 'test-artifacts');
     }
     performBackup() {
         if (fs.existsSync(this._artifactPath)) {

package/dist/artifact-builder/ArtifactManager.js.map

@@ -1 +1 @@
-{"version":3,"file":"ArtifactManager.js","sourceRoot":"","sources":["../../artifact-builder/ArtifactManager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,MAAM,OAAO,eAAe;IAI1B;QACE,MAAM,SAAS,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACjD,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QACzC,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,gBAAgB,CAAC,CAAC;QACzF,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAE,gBAAgB,CAAC,CAAC;IAC5E,CAAC;IAED,aAAa;QACX,IAAI,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,aAAa,CAAC,EAAE,CAAC;YACtC,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;YAC9D,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,aAAa,EAAE,IAAI,CAAC,WAAW,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACvE,CAAC;IACH,CAAC;IAED,YAAY;QACV,OAAO,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IACzC,CAAC;IAED,aAAa;QACX,IAAI,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC;YACpC,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,aAAa,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;YAChE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,aAAa,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACvE,CAAC;IACH,CAAC;CACF"}
+{"version":3,"file":"ArtifactManager.js","sourceRoot":"","sources":["../../artifact-builder/ArtifactManager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAE3D;;;;;;;;;;;;;;;GAeG;AACH,MAAM,OAAO,eAAe;IAI1B,YAAY,KAAqB;QAC/B,MAAM,CAAC,GAAG,KAAK,IAAI,IAAI,aAAa,EAAE,CAAC;QACvC,IAAI,CAAC,aAAa,GAAG,CAAC,CAAC,aAAa,CAAC;QAErC,uEAAuE;QACvE,4DAA4D;QAC5D,0EAA0E;QAC1E,+DAA+D;QAC/D,MAAM,SAAS,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACjD,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QACzC,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,gBAAgB,CAAC,CAAC;IAC3F,CAAC;IAED,aAAa;QACX,IAAI,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,aAAa,CAAC,EAAE,CAAC;YACtC,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;YAC9D,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,aAAa,EAAE,IAAI,CAAC,WAAW,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACvE,CAAC;IACH,CAAC;IAED,YAAY;QACV,OAAO,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IACzC,CAAC;IAED,aAAa;QACX,IAAI,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC;YACpC,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,aAAa,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;YAChE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,aAAa,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACvE,CAAC;IACH,CAAC;CACF"}

package/dist/artifact-builder/ComponentClassModelBuilder.d.ts

@@ -0,0 +1,22 @@
+import type { IComponentSchemaMeta } from '../interfaces/IComponentSchemaMeta.js';
+import type { SubjectComponents } from '../types/Components.js';
+import type { NamingHandler } from './helpers/NamingHandler.js';
+import type { SelectorBuilder } from './SelectorBuilder.js';
+import type { ComponentAssignmentModel, ComponentClassModel, ComponentGetterModel, ComponentPropertyModel } from './TsFileModel.js';
+/**
+ * **Pipeline sub-step** — Builds a pure in-memory model (`ComponentClassModel`)
+ * for the typed component class appended to a generated screen interface file
+ * (e.g. `EmployeeForm`, `EmployeeGrid`). Contains no file I/O — fully unit-testable.
+ */
+export declare class ComponentClassModelBuilder {
+    private readonly _namingHandler;
+    private readonly _selectorBuilder;
+    constructor(namingHandler: NamingHandler, selectorBuilder: SelectorBuilder);
+    build(interfaceName: string, componentType: SubjectComponents, propertyLines: string[], meta: IComponentSchemaMeta): ComponentClassModel;
+    buildGetters(propertyLines: string[], meta: IComponentSchemaMeta): ComponentGetterModel[];
+    buildProperties(propertyLines: string[], meta: IComponentSchemaMeta): ComponentPropertyModel[];
+    buildAssignments(propertyLines: string[], meta: IComponentSchemaMeta): ComponentAssignmentModel[];
+    private resolvePropertyType;
+    private getElementTypeFromPropertyName;
+    private getColIdFromPropertyName;
+}