@thinkwise/testwise 0.2.62 → 0.2.99

package/controls/FormComboBox.ts

@@ -1,7 +1,30 @@
 /* eslint-disable @typescript-eslint/no-explicit-any */
 /* biome-ignore-all lint/suspicious/noExplicitAny: Reason42 */
 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 = {
@@ -12,47 +35,41 @@ export type IFormComboBoxCore = {
 };
 
 class FormComboBox implements IFormComboBoxCore {
-  private _formFieldLocator: Locator;
-  private _autoCompleteMenu: Locator;
-  private _id: string;
+  private _objects: FormComboBoxObjects;
 
   constructor(context: Locator, id: string) {
-    this._id = id;
-    this._formFieldLocator = context.getByTestId(`form-field__${id}`);
-    this._autoCompleteMenu = context.getByTestId(`form-field__${id}__select__options-list`);
+    this._objects = new FormComboBoxObjects(context, id);
   }
 
   async selectOption(optionText: string): Promise<void> {
-    await this._formFieldLocator.locator('input').click();
-
-    await this._autoCompleteMenu.waitFor({ state: 'visible' });
-
-    const optionTextLowercase = optionText.toLowerCase();
-
-    await this._autoCompleteMenu.getByTestId(`form-field__${this._id}__select__${optionTextLowercase}__text`).click();
+    await this._objects.fieldInput().click();
+    await this._objects.autoCompleteMenu().waitFor({ state: 'visible' });
+    await this._objects.option(optionText).click();
   }
 
   async getValidationMessage(): Promise<string> {
-    await this._formFieldLocator.locator('.TooltipContainer p').waitFor({ state: 'visible' });
-    return await this._formFieldLocator.locator('.TooltipContainer p').innerText();
+    await this._objects.validationMessage().waitFor({ state: 'visible' });
+    return await this._objects.validationMessage().innerText();
   }
   async clearByClick(): Promise<void> {
-    await this._formFieldLocator.locator('Button[aria-label="Clear"]').click();
+    await this._objects.clearButton().click();
   }
 
   async lookupSelect(optionToSelect: string): Promise<void> {
-    await this._formFieldLocator.locator('input').fill(optionToSelect);
-
-    await this._autoCompleteMenu.waitFor({ state: 'visible' });
-
-    const optionToSelectLowercase = optionToSelect.toLowerCase();
-
-    await this._autoCompleteMenu
-      .getByTestId(`form-field__${this._id}__select__${optionToSelectLowercase}__text`)
-      .click();
+    await this._objects.fieldInput().fill(optionToSelect);
+    await this._objects.autoCompleteMenu().waitFor({ state: 'visible' });
+    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: Locator, id: string): IFormComboBox {
   const comboBox = new FormComboBox(context, id);
   const locator = context.getByTestId(`form-field__${id}`);

package/controls/FormComboBoxObjects.ts

@@ -0,0 +1,27 @@
+import type { Locator } from '@playwright/test';
+
+export class FormComboBoxObjects {
+  private _context: Locator;
+  private _id: string;
+
+  constructor(context: Locator, id: string) {
+    this._context = context;
+    this._id = id;
+  }
+
+  public field = (): Locator => this._context.getByTestId(`form-field__${this._id}`);
+
+  public autoCompleteMenu = (): Locator =>
+    this._context.page().getByTestId(`form-field__${this._id}__select__options-list`);
+
+  public option = (optionText: string): Locator => {
+    const optionTextLowercase = optionText.toLowerCase();
+    return this.autoCompleteMenu().getByTestId(`form-field__${this._id}__select__${optionTextLowercase}__text`);
+  };
+
+  public clearButton = (): Locator => this.field().locator('Button[aria-label="Clear"]');
+
+  public validationMessage = (): Locator => this.field().locator('.TooltipContainer p');
+
+  public fieldInput = (): Locator => this.field().locator('input');
+}

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);
   }
@@ -44,13 +66,22 @@ class GridColumnControl implements IGridColumnControlCore {
   }
 
   public async filterByColumnValueExcelStyle(value: string, deselectAll?: boolean): Promise<void> {
-    await this._grid.filterByColumnValueExcelStyle(this._id, value, deselectAll);
+    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: 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/GridColumnControlObjects.ts

@@ -11,7 +11,7 @@ export class GridColumnControlObjects extends BaseComponentObjects {
 
   public column = () => this.context.locator(`[col-id="${this._id}"]`);
 
-  public columnHeader = () => this.column().getByRole('columnheader');
+  public columnHeader = () => this.context.locator(`[col-id="${this._id}"][role="columnheader"]`);
 
   public cellByValue = (value: RegExp) =>
     this.column().locator('[role="button"]', {

package/controls/InputFieldControl.ts

@@ -1,7 +1,27 @@
 /* eslint-disable @typescript-eslint/no-explicit-any */
 /** biome-ignore-all lint/suspicious/noExplicitAny: reason42 */
 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 = {
@@ -15,43 +35,61 @@ export type ICoreInputFieldControl = {
 };
 
 export class InputFieldControl implements ICoreInputFieldControl {
-  private _formFieldLocator: Locator;
-  private _inputLocator: Locator;
-  private _id: string;
+  private _objects: InputFieldControlObjects;
 
   constructor(context: Locator, id: string) {
-    this._id = id;
-    this._formFieldLocator = context.getByTestId(`form-field__${id}`);
-    this._inputLocator = this._formFieldLocator.locator('input');
+    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._formFieldLocator.locator('.TooltipContainer p').waitFor({ state: 'visible' });
-    return await this._formFieldLocator.locator('.TooltipContainer p').innerText();
+    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._inputLocator.fill(value);
+    await this._objects.fieldInput().fill(value);
   }
 
+  /**
+   * Clicks the underlying input element.
+   */
   public async click(): Promise<void> {
-    await this._inputLocator.click();
+    await this._objects.fieldInput().click();
   }
 
+  /**
+   * Clears the input field by filling it with an empty string.
+   */
   public async clear(): Promise<void> {
-    await this._inputLocator.fill('');
+    await this._objects.fieldInput().fill('');
   }
 
+  /**
+   * Returns the current string value from the underlying input element.
+   */
   public async inputValue(): Promise<string> {
-    return await this._inputLocator.inputValue();
+    return await this._objects.fieldInput().inputValue();
   }
 
+  /**
+   * Returns the Playwright `Locator` for the underlying `<input>` element of the field.
+   */
   public inputElement(): Locator {
-    return this._inputLocator;
+    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._formFieldLocator.getByTestId(`form-field__${this._id}__label`).textContent()) || '';
+    let returnText = (await this._objects.fieldLabel().textContent()) || '';
 
     returnText = returnText.replace(/\s+/g, ' ').trim();
 
@@ -59,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/InputFieldControlObjects.ts

@@ -0,0 +1,19 @@
+import type { Locator } from '@playwright/test';
+
+export class InputFieldControlObjects {
+  private _context: Locator;
+  private _id: string;
+
+  constructor(context: Locator, id: string) {
+    this._context = context;
+    this._id = id;
+  }
+
+  public formField = (): Locator => this._context.getByTestId(`form-field__${this._id}`);
+
+  public fieldInput = (): Locator => this.formField().locator('input');
+
+  public fieldLabel = (): Locator => this.formField().getByTestId(`form-field__${this._id}__label`);
+
+  public validationMessage = (): Locator => this.formField().locator('.TooltipContainer p');
+}

package/controls/LookupDropdown.ts

@@ -2,7 +2,29 @@
 /** biome-ignore-all lint/suspicious/noExplicitAny: needed flexibility */
 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 = {
@@ -16,18 +38,14 @@ export type ILookupDropdownCore = {
 };
 
 class LookupDropdown implements ILookupDropdownCore {
-  private _id: string;
-  private _formFieldLocator: Locator;
-  private _inputLocator: Locator;
+  private _objects: LookupDropdownObjects;
 
   constructor(context: Locator, id: string) {
-    this._id = id;
-    this._formFieldLocator = context.getByTestId(`form-field__${this._id}`);
-    this._inputLocator = this._formFieldLocator.locator('input');
+    this._objects = new LookupDropdownObjects(context, id);
   }
 
   public async getLabelText(): Promise<string> {
-    let returnText = (await this._formFieldLocator.getByTestId(`form-field__${this._id}__label`).textContent()) || '';
+    let returnText = (await this._objects.label().textContent()) || '';
 
     returnText = returnText.replace(/\s+/g, ' ').trim();
 
@@ -35,69 +53,79 @@ class LookupDropdown implements ILookupDropdownCore {
   }
 
   public async lookupSelect(optionToSelect: string): Promise<void> {
-    await this._inputLocator.fill(optionToSelect);
+    await this._objects.input().fill(optionToSelect);
     await this.select(optionToSelect);
   }
 
   public async inputValue(): Promise<string> {
-    return await this._inputLocator.inputValue();
+    return await this._objects.input().inputValue();
   }
 
   public async clear(): Promise<void> {
-    await this._inputLocator.fill('');
+    await this._objects.input().fill('');
   }
 
   public async selectOption(optionText: string): Promise<void> {
-    await this._inputLocator.click();
+    await this._objects.input().click();
     await this.select(optionText);
   }
 
   public async getValidationMessage(): Promise<string> {
-    await this._formFieldLocator.locator('.TooltipContainer p').waitFor({ state: 'visible' });
-    return await this._formFieldLocator.locator('.TooltipContainer p').innerText();
+    await this._objects.validationMessage().waitFor({ state: 'visible' });
+    return await this._objects.validationMessage().innerText();
   }
 
   public async fill(value: string): Promise<void> {
     await Promise.all([
-      this._formFieldLocator
+      this._objects
+        .input()
         .page()
         .waitForResponse((response) => response.url().includes('/list_') && response.request().method() === 'GET'),
-      this._inputLocator.click()
+      this._objects.input().click()
     ]);
 
     await Promise.all([
-      this._formFieldLocator
+      this._objects
+        .input()
         .page()
         .waitForResponse((response) => response.url().includes('/list_') && response.request().method() === 'GET'),
-      this._inputLocator.fill(value)
+      this._objects.input().fill(value)
     ]);
   }
 
   private async select(optionToSelect: string) {
     const optionsToSelectRegex = new RegExp(`^${escapeRegex(optionToSelect)}$`, 'i');
 
-    await this._formFieldLocator.page().getByTestId('autocomplete__menu').getByText(optionsToSelectRegex).click();
-    await this._formFieldLocator
+    await this._objects.input().page().getByTestId('autocomplete__menu').getByText(optionsToSelectRegex).click();
+    await this._objects
+      .input()
       .page()
-      .waitForFunction((el) => document.activeElement === el, await this._inputLocator.elementHandle());
+      .waitForFunction((el) => document.activeElement === el, await this._objects.input().elementHandle());
   }
 }
 
+/**
+ * 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'));
 
-  return new Proxy(dropdown, {
+  return new Proxy(context, {
     get(target, prop, receiver) {
-      if (prop in target) {
-        return Reflect.get(target, prop, receiver);
-      }
-
-      const value = (dropdown as any)[prop];
-
-      if (typeof value === 'function') {
-        return value.bind(dropdown);
+      if (customProps.has(prop as string)) {
+        const value = (dropdown as any)[prop];
+        if (typeof value === 'function') {
+          return value.bind(dropdown);
+        }
+        return value;
       }
-      return value;
+      return Reflect.get(target, prop, receiver);
     }
   }) as unknown as ILookupDropdown;
 }

package/controls/LookupDropdownObjects.ts

@@ -0,0 +1,19 @@
+import type { Locator } from '@playwright/test';
+
+export class LookupDropdownObjects {
+  private _id: string;
+  private _context: Locator;
+
+  constructor(context: Locator, id: string) {
+    this._context = context;
+    this._id = id;
+  }
+
+  public formField = (): Locator => this._context.getByTestId(`form-field__${this._id}`);
+
+  public label = (): Locator => this.formField().getByTestId(`form-field__${this._id}__label`);
+
+  public input = (): Locator => this.formField().locator('input');
+
+  public validationMessage = (): Locator => this.formField().locator('.TooltipContainer p');
+}

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