@axinom/mosaic-e2e-ui-selectors 0.16.9 → 0.16.10-rc.3

package/dist/{helpers → cjs/helpers}/read-page-errors.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.readPageErrors = readPageErrors;
-const component_models_1 = require("../component-models");
+const index_js_1 = require("../component-models/index.js");
 /**
  * Inspect the page for error messages.
  * Returns an enumerated list of errors found from these components:
@@ -11,7 +11,7 @@ const component_models_1 = require("../component-models");
 async function readPageErrors(root) {
     const errors = [];
     try {
-        const errorMessageBar = new component_models_1.MessageBar(root).asTypeError();
+        const errorMessageBar = new index_js_1.MessageBar(root).asTypeError();
         if (await errorMessageBar.getLocator().first().isVisible()) {
             await errorMessageBar.detailsButton.first().click();
             const title = await errorMessageBar.title.first().innerText();
@@ -27,7 +27,7 @@ async function readPageErrors(root) {
         console.error(e);
     }
     try {
-        const formField = new component_models_1.Form(root).getFieldWithValidationError(1);
+        const formField = new index_js_1.Form(root).getFieldWithValidationError(1);
         if (await formField.getLocator().isVisible()) {
             const label = await formField.label.innerText();
             errors.push({

package/dist/cjs/helpers/read-page-errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-page-errors.js","sourceRoot":"","sources":["../../../src/helpers/read-page-errors.ts"],"names":[],"mappings":";;AAiBA,wCAuCC;AAtDD,2DAAgE;AAShE;;;;;GAKG;AACI,KAAK,UAAU,cAAc,CAClC,IAAyB;IAEzB,MAAM,MAAM,GAAgB,EAAE,CAAC;IAE/B,IAAI,CAAC;QACH,MAAM,eAAe,GAAG,IAAI,qBAAU,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC;QAC3D,IAAI,MAAM,eAAe,CAAC,UAAU,EAAE,CAAC,KAAK,EAAE,CAAC,SAAS,EAAE,EAAE,CAAC;YAC3D,MAAM,eAAe,CAAC,aAAa,CAAC,KAAK,EAAE,CAAC,KAAK,EAAE,CAAC;YACpD,MAAM,KAAK,GAAG,MAAM,eAAe,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC,SAAS,EAAE,CAAC;YAC9D,MAAM,CAAC,IAAI,CAAC;gBACV,OAAO,EACL,mDAAmD,KAAK,KAAK;oBAC7D,gEAAgE;oBAChE,GAAG,MAAM,eAAe,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC,SAAS,EAAE,IAAI;oBACxD,8DAA8D;aACjE,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACnB,CAAC;IAED,IAAI,CAAC;QACH,MAAM,SAAS,GAAG,IAAI,eAAI,CAAC,IAAI,CAAC,CAAC,2BAA2B,CAAC,CAAC,CAAC,CAAC;QAChE,IAAI,MAAM,SAAS,CAAC,UAAU,EAAE,CAAC,SAAS,EAAE,EAAE,CAAC;YAC7C,MAAM,KAAK,GAAG,MAAM,SAAS,CAAC,KAAK,CAAC,SAAS,EAAE,CAAC;YAChD,MAAM,CAAC,IAAI,CAAC;gBACV,OAAO,EACL,+DAA+D,KAAK,MAAM;oBAC1E,gEAAgE;oBAChE,GAAG,MAAM,SAAS,CAAC,KAAK,CAAC,SAAS,EAAE,IAAI;oBACxC,8DAA8D;aACjE,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACnB,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/{helpers → cjs/helpers}/wait-for-loader.d.ts

@@ -1,5 +1,5 @@
-import { FrameLocator, Page } from '@playwright/test';
-import { ComponentModel } from '../component-model';
+import { type FrameLocator, type Page } from '@playwright/test';
+import { ComponentModel } from '../component-model.js';
 /**
  * This method waits while any Loader components are visible.
  *

package/dist/cjs/helpers/wait-for-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wait-for-loader.d.ts","sourceRoot":"","sources":["../../../src/helpers/wait-for-loader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,YAAY,EAAE,KAAK,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAChE,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAGvD;;;;GAIG;AACH,wBAAsB,aAAa,CACjC,MAAM,EAAE,IAAI,GAAG,YAAY,GAAG,cAAc,GAC3C,OAAO,CAAC,IAAI,CAAC,CAEf"}

package/dist/{helpers → cjs/helpers}/wait-for-loader.js

@@ -1,13 +1,13 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.waitForLoader = waitForLoader;
-const component_models_1 = require("../component-models");
+const index_js_1 = require("../component-models/index.js");
 /**
  * This method waits while any Loader components are visible.
  *
  * @param parent A playwright Page, Frame or ComponentModel which contains the loader
  */
 async function waitForLoader(parent) {
-    await new component_models_1.Loader(parent).waitFor();
+    await new index_js_1.Loader(parent).waitFor();
 }
 //# sourceMappingURL=wait-for-loader.js.map

package/dist/cjs/helpers/wait-for-loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wait-for-loader.js","sourceRoot":"","sources":["../../../src/helpers/wait-for-loader.ts"],"names":[],"mappings":";;AASA,sCAIC;AAXD,2DAAsD;AAEtD;;;;GAIG;AACI,KAAK,UAAU,aAAa,CACjC,MAA4C;IAE5C,MAAM,IAAI,iBAAM,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,CAAC;AACrC,CAAC"}

package/dist/cjs/index.d.ts

@@ -0,0 +1,6 @@
+export * from './component-model.js';
+export * from './component-models/index.js';
+export * from './constants/index.js';
+export * from './helpers/index.js';
+export * from './ui-workflows-model.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/cjs/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC;AACrC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AACnC,cAAc,yBAAyB,CAAC"}

package/dist/{index.js → cjs/index.js}

@@ -14,9 +14,9 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-__exportStar(require("./component-model"), exports);
-__exportStar(require("./component-models"), exports);
-__exportStar(require("./constants"), exports);
-__exportStar(require("./helpers"), exports);
-__exportStar(require("./ui-workflows-model"), exports);
+__exportStar(require("./component-model.js"), exports);
+__exportStar(require("./component-models/index.js"), exports);
+__exportStar(require("./constants/index.js"), exports);
+__exportStar(require("./helpers/index.js"), exports);
+__exportStar(require("./ui-workflows-model.js"), exports);
 //# sourceMappingURL=index.js.map

package/dist/cjs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,uDAAqC;AACrC,8DAA4C;AAC5C,uDAAqC;AACrC,qDAAmC;AACnC,0DAAwC"}

package/dist/cjs/package.json

@@ -0,0 +1 @@
+{"type":"commonjs"}

package/dist/{ui-workflows-model.d.ts → cjs/ui-workflows-model.d.ts}

@@ -1,5 +1,5 @@
-import { Page } from '@playwright/test';
-import { Accordion, Actions, Button, Filters, Form, Hub, InfoPanel, List, MessageBar, Modal, PageHeader, Tab } from './component-models';
+import { type Page } from '@playwright/test';
+import { Accordion, Actions, Button, Filters, Form, Hub, InfoPanel, List, MessageBar, Modal, PageHeader, Tab } from './component-models/index.js';
 /** A model representing the Mosaic UI. */
 export declare class UiWorkflowsModel {
     /** The playwright page object. */

package/dist/cjs/ui-workflows-model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui-workflows-model.d.ts","sourceRoot":"","sources":["../../src/ui-workflows-model.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EACL,SAAS,EACT,OAAO,EACP,MAAM,EACN,OAAO,EACP,IAAI,EACJ,GAAG,EACH,SAAS,EACT,IAAI,EACJ,UAAU,EACV,KAAK,EACL,UAAU,EACV,GAAG,EACJ,MAAM,6BAA6B,CAAC;AAErC,0CAA0C;AAC1C,qBAAa,gBAAgB;IAEzB,kCAAkC;IAClC,SAAS,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI;;IAD7B,kCAAkC;IACf,IAAI,EAAE,IAAI;IAG/B,oCAAoC;IACpC,QAAQ,CAAC,UAAU,aAA6B;IAEhD,kEAAkE;IAClE,QAAQ,CAAC,UAAU,aAA6B;IAEhD,0BAA0B;IAC1B,QAAQ,CAAC,IAAI,OAAuB;IAEpC,2EAA2E;IAC3E,QAAQ,CAAC,SAAS,YAA4B;IAE9C,qCAAqC;IACrC,QAAQ,CAAC,OAAO,UAA0B;IAE1C,sEAAsE;IACtE,QAAQ,CAAC,OAAO,UAA0B;IAE1C,8CAA8C;IAC9C,QAAQ,CAAC,IAAI,OAAuB;IAEpC,iCAAiC;IACjC,QAAQ,CAAC,SAAS,YAA4B;IAE9C,oCAAoC;IACpC,QAAQ,CAAC,GAAG,MAAsB;IAElC,4BAA4B;IAC5B,QAAQ,CAAC,MAAM,SAAyB;IAExC,yBAAyB;IACzB,QAAQ,CAAC,GAAG,MAAsB;IAElC,QAAQ,CAAC,KAAK,QAAwB;CACvC"}

package/dist/{ui-workflows-model.js → cjs/ui-workflows-model.js}

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.UiWorkflowsModel = void 0;
-const component_models_1 = require("./component-models");
+const index_js_1 = require("./component-models/index.js");
 /** A model representing the Mosaic UI. */
 class UiWorkflowsModel {
     constructor(
@@ -9,28 +9,28 @@ class UiWorkflowsModel {
     page) {
         this.page = page;
         /** A model for a station header. */
-        this.pageHeader = new component_models_1.PageHeader(this.page);
+        this.pageHeader = new index_js_1.PageHeader(this.page);
         /** A  model for the page message bar (error / warning / info). */
-        this.messageBar = new component_models_1.MessageBar(this.page);
+        this.messageBar = new index_js_1.MessageBar(this.page);
         /** A model for a form. */
-        this.form = new component_models_1.Form(this.page);
+        this.form = new index_js_1.Form(this.page);
         /** A model for the info panel which shows on details and form stations. */
-        this.infoPanel = new component_models_1.InfoPanel(this.page);
+        this.infoPanel = new index_js_1.InfoPanel(this.page);
         /** A model for the actions panel. */
-        this.actions = new component_models_1.Actions(this.page);
+        this.actions = new index_js_1.Actions(this.page);
         /** A model for the filters panel which shows on explorer stations. */
-        this.filters = new component_models_1.Filters(this.page);
+        this.filters = new index_js_1.Filters(this.page);
         /** A model for a list of explorer results. */
-        this.list = new component_models_1.List(this.page);
+        this.list = new index_js_1.List(this.page);
         /** A generic accordion model. */
-        this.accordion = new component_models_1.Accordion(this.page);
+        this.accordion = new index_js_1.Accordion(this.page);
         /** A model for a navigation hub. */
-        this.hub = new component_models_1.Hub(this.page);
+        this.hub = new index_js_1.Hub(this.page);
         /** A model for a button. */
-        this.button = new component_models_1.Button(this.page);
+        this.button = new index_js_1.Button(this.page);
         /** A model for a tab. */
-        this.tab = new component_models_1.Tab(this.page);
-        this.modal = new component_models_1.Modal(this.page);
+        this.tab = new index_js_1.Tab(this.page);
+        this.modal = new index_js_1.Modal(this.page);
     }
 }
 exports.UiWorkflowsModel = UiWorkflowsModel;

package/dist/cjs/ui-workflows-model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui-workflows-model.js","sourceRoot":"","sources":["../../src/ui-workflows-model.ts"],"names":[],"mappings":";;;AACA,0DAaqC;AAErC,0CAA0C;AAC1C,MAAa,gBAAgB;IAC3B;IACE,kCAAkC;IACf,IAAU;QAAV,SAAI,GAAJ,IAAI,CAAM;QAG/B,oCAAoC;QAC3B,eAAU,GAAG,IAAI,qBAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAEhD,kEAAkE;QACzD,eAAU,GAAG,IAAI,qBAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAEhD,0BAA0B;QACjB,SAAI,GAAG,IAAI,eAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAEpC,2EAA2E;QAClE,cAAS,GAAG,IAAI,oBAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAE9C,qCAAqC;QAC5B,YAAO,GAAG,IAAI,kBAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAE1C,sEAAsE;QAC7D,YAAO,GAAG,IAAI,kBAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAE1C,8CAA8C;QACrC,SAAI,GAAG,IAAI,eAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAEpC,iCAAiC;QACxB,cAAS,GAAG,IAAI,oBAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAE9C,oCAAoC;QAC3B,QAAG,GAAG,IAAI,cAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAElC,4BAA4B;QACnB,WAAM,GAAG,IAAI,iBAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAExC,yBAAyB;QAChB,QAAG,GAAG,IAAI,cAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAEzB,UAAK,GAAG,IAAI,gBAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAnCnC,CAAC;CAoCL;AAxCD,4CAwCC"}

package/dist/esm/component-model.d.ts

@@ -0,0 +1,60 @@
+import { type FrameLocator, type Locator, type Page } from '@playwright/test';
+/** Interface for a ComponentModel constructor. */
+interface ComponentModelType<TModel extends ComponentModel> {
+    new (parent: Page | FrameLocator | ComponentModel, xpath?: string, nth?: number): TModel;
+}
+/**
+ * Base class for UI component models. A component model is an abstraction of
+ * a playwright locator. Specific UI components can be modelled by extending
+ * this class and a UI structure can be represented through composition.
+ *
+ * A component model is initiated with a parent object and an xpath. The DOM
+ * element which is represented by the model is found by applying the xpath
+ * relative to the parent.
+ *
+ * The `getLocator` method exposes a playwright locator. This method can be
+ * used with 0 arguments to get a locator directly to the DOM element the model
+ * represents, or it  can be used with an xpath argument to get a relative
+ * element.
+ *
+ * Only XPATH selectors can be used. This is because xpaths are combined
+ * through string concatenation so that the selector for a component model is
+ * always absolute. An absolute xpath is convenient when debugging failed
+ * matches as it can be copied and analyzed with browser dev tools. This
+ * approach was preferred over using Playwright relative locators because
+ * relative locators are logged in test output as a series of selectors,
+ * possibly using mixed technologies.
+ */
+export declare class ComponentModel {
+    /**
+     * A model which represents a DOM element.
+     * @param parent  The playwright page object, frame or component model to be used as the parent of this component.
+     * @param xpath  A relative xpath to this component from the parent.
+     * @param nth  Optional position of this component among xpath matches. Position is 1 indexed. Negative numbers count from the end.
+     */
+    constructor(parent: Page | FrameLocator | ComponentModel, xpath: string, nth?: number);
+    /** The root playwright entity from which to resolve this component model's xpath. */
+    protected root: Page | FrameLocator;
+    /** An absolute xpath to the DOM element that this component model represents. */
+    readonly xpath: string;
+    /** This method gets a locator to the DOM element represented by this component model. */
+    getLocator(): Locator;
+    /**
+     * This method gets a locator to a DOM element relative to the element represented by this component model.
+     * @param xpath  An xpath relative to this component.
+     * @param nth  Optional position among matches. Position is 1 indexed. Negative numbers count from the end.
+     */
+    getLocator(xpath: string, nth?: number): Locator;
+    /**
+     * This method gets a child component model with a provided type. This is useful
+     * for modelling a page where the UI is composed in a custom manner.
+     * @param model  A ComponentModel type. e.g. `ToggleButton` / `Modal`
+     * @param xpath  An optional xpath relative to this component. If not provided, the model's default xpath will be used.
+     * @param nth  Optional position among matches. Position is 1 indexed. Negative numbers count from the end.
+     */
+    getChildOfType<TModel extends ComponentModel>(model: ComponentModelType<TModel>, xpath?: string, nth?: number): TModel;
+    /** A helper method to create global locators - This helps with locating globally across the entire DOM, rather than being scoped to the form */
+    protected getGlobalLocator(selector: string): Locator;
+}
+export {};
+//# sourceMappingURL=component-model.d.ts.map

package/dist/esm/component-model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"component-model.d.ts","sourceRoot":"","sources":["../../src/component-model.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,YAAY,EAAE,KAAK,OAAO,EAAE,KAAK,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAE9E,kDAAkD;AAClD,UAAU,kBAAkB,CAAC,MAAM,SAAS,cAAc;IACxD,KACE,MAAM,EAAE,IAAI,GAAG,YAAY,GAAG,cAAc,EAC5C,KAAK,CAAC,EAAE,MAAM,EACd,GAAG,CAAC,EAAE,MAAM,GACX,MAAM,CAAC;CACX;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,qBAAa,cAAc;IACzB;;;;;OAKG;gBAED,MAAM,EAAE,IAAI,GAAG,YAAY,GAAG,cAAc,EAC5C,KAAK,EAAE,MAAM,EACb,GAAG,CAAC,EAAE,MAAM;IAgBd,qFAAqF;IACrF,SAAS,CAAC,IAAI,EAAE,IAAI,GAAG,YAAY,CAAC;IAEpC,iFAAiF;IACjF,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAEvB,yFAAyF;IACzF,UAAU,IAAI,OAAO;IACrB;;;;OAIG;IACH,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO;IAWhD;;;;;;OAMG;IACH,cAAc,CAAC,MAAM,SAAS,cAAc,EAC1C,KAAK,EAAE,kBAAkB,CAAC,MAAM,CAAC,EACjC,KAAK,CAAC,EAAE,MAAM,EACd,GAAG,CAAC,EAAE,MAAM,GACX,MAAM;IAIT,gJAAgJ;IAChJ,SAAS,CAAC,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;CAGtD"}

package/dist/esm/component-model.js

@@ -0,0 +1,90 @@
+import {} from '@playwright/test';
+/**
+ * Base class for UI component models. A component model is an abstraction of
+ * a playwright locator. Specific UI components can be modelled by extending
+ * this class and a UI structure can be represented through composition.
+ *
+ * A component model is initiated with a parent object and an xpath. The DOM
+ * element which is represented by the model is found by applying the xpath
+ * relative to the parent.
+ *
+ * The `getLocator` method exposes a playwright locator. This method can be
+ * used with 0 arguments to get a locator directly to the DOM element the model
+ * represents, or it  can be used with an xpath argument to get a relative
+ * element.
+ *
+ * Only XPATH selectors can be used. This is because xpaths are combined
+ * through string concatenation so that the selector for a component model is
+ * always absolute. An absolute xpath is convenient when debugging failed
+ * matches as it can be copied and analyzed with browser dev tools. This
+ * approach was preferred over using Playwright relative locators because
+ * relative locators are logged in test output as a series of selectors,
+ * possibly using mixed technologies.
+ */
+export class ComponentModel {
+    /**
+     * A model which represents a DOM element.
+     * @param parent  The playwright page object, frame or component model to be used as the parent of this component.
+     * @param xpath  A relative xpath to this component from the parent.
+     * @param nth  Optional position of this component among xpath matches. Position is 1 indexed. Negative numbers count from the end.
+     */
+    constructor(parent, xpath, nth) {
+        // If the parent is a ComponentModel, copy it's root and combine the xpaths
+        if (parent instanceof ComponentModel) {
+            this.root = parent.root;
+            xpath = parent.xpath + xpath;
+        }
+        else {
+            this.root = parent;
+        }
+        // Apply position argument
+        if (nth !== undefined) {
+            xpath = applyPositionToXpath(xpath, nth);
+        }
+        this.xpath = xpath;
+    }
+    getLocator(xpath = '', nth) {
+        // Combine xpaths
+        xpath = this.xpath + xpath;
+        // Apply position argument
+        if (nth !== undefined) {
+            xpath = applyPositionToXpath(xpath, nth);
+        }
+        return this.root.locator(xpath);
+    }
+    /**
+     * This method gets a child component model with a provided type. This is useful
+     * for modelling a page where the UI is composed in a custom manner.
+     * @param model  A ComponentModel type. e.g. `ToggleButton` / `Modal`
+     * @param xpath  An optional xpath relative to this component. If not provided, the model's default xpath will be used.
+     * @param nth  Optional position among matches. Position is 1 indexed. Negative numbers count from the end.
+     */
+    getChildOfType(model, xpath, nth) {
+        return new model(this, xpath, nth);
+    }
+    /** A helper method to create global locators - This helps with locating globally across the entire DOM, rather than being scoped to the form */
+    getGlobalLocator(selector) {
+        return this.root.locator(selector);
+    }
+}
+/**
+ * This method applies a position to an xpath to match single DOM element.
+ * Position is 1 indexed. Negative numbers count from the end (1 is the first match, -1 is the last).
+ */
+function applyPositionToXpath(xpath, position) {
+    if (position === 0) {
+        throw new Error('Unexpected value 0 for 1-indexed position argument.');
+    }
+    if (position !== Math.floor(position)) {
+        throw new Error('Unexpected non-integer value for position argument.');
+    }
+    if (position === -1) {
+        return `(${xpath})[last()]`;
+    }
+    if (position < -1) {
+        // The negative symbol on the number becomes an operator:
+        return `(${xpath})[position() = (last()${position + 1})]`;
+    }
+    return `(${xpath})[${position}]`;
+}
+//# sourceMappingURL=component-model.js.map

package/dist/esm/component-model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"component-model.js","sourceRoot":"","sources":["../../src/component-model.ts"],"names":[],"mappings":"AAAA,OAAO,EAA8C,MAAM,kBAAkB,CAAC;AAW9E;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,OAAO,cAAc;IACzB;;;;;OAKG;IACH,YACE,MAA4C,EAC5C,KAAa,EACb,GAAY;QAEZ,2EAA2E;QAC3E,IAAI,MAAM,YAAY,cAAc,EAAE,CAAC;YACrC,IAAI,CAAC,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;YACxB,KAAK,GAAG,MAAM,CAAC,KAAK,GAAG,KAAK,CAAC;QAC/B,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,IAAI,GAAG,MAAM,CAAC;QACrB,CAAC;QACD,0BAA0B;QAC1B,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;YACtB,KAAK,GAAG,oBAAoB,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;QAC3C,CAAC;QACD,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;IAgBD,UAAU,CAAC,KAAK,GAAG,EAAE,EAAE,GAAY;QACjC,iBAAiB;QACjB,KAAK,GAAG,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QAC3B,0BAA0B;QAC1B,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;YACtB,KAAK,GAAG,oBAAoB,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;QAC3C,CAAC;QACD,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IAClC,CAAC;IAED;;;;;;OAMG;IACH,cAAc,CACZ,KAAiC,EACjC,KAAc,EACd,GAAY;QAEZ,OAAO,IAAI,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,GAAG,CAAC,CAAC;IACrC,CAAC;IAED,gJAAgJ;IACtI,gBAAgB,CAAC,QAAgB;QACzC,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACrC,CAAC;CACF;AAED;;;GAGG;AACH,SAAS,oBAAoB,CAAC,KAAa,EAAE,QAAgB;IAC3D,IAAI,QAAQ,KAAK,CAAC,EAAE,CAAC;QACnB,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;IACzE,CAAC;IACD,IAAI,QAAQ,KAAK,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC;QACtC,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;IACzE,CAAC;IACD,IAAI,QAAQ,KAAK,CAAC,CAAC,EAAE,CAAC;QACpB,OAAO,IAAI,KAAK,WAAW,CAAC;IAC9B,CAAC;IACD,IAAI,QAAQ,GAAG,CAAC,CAAC,EAAE,CAAC;QAClB,yDAAyD;QACzD,OAAO,IAAI,KAAK,yBAAyB,QAAQ,GAAG,CAAC,IAAI,CAAC;IAC5D,CAAC;IACD,OAAO,IAAI,KAAK,KAAK,QAAQ,GAAG,CAAC;AACnC,CAAC"}

package/dist/esm/component-models/accordion.d.ts

@@ -0,0 +1,44 @@
+import { type FrameLocator, type Page } from '@playwright/test';
+import { ComponentModel } from '../component-model.js';
+/**
+ * A model for an AccordionItem component.
+ */
+export declare class AccordionItem extends ComponentModel {
+    /** A locator to the row for this accordion item that is always displayed. */
+    readonly row: import("playwright-core").Locator;
+    /** A locator to the content for this accordion item that is only shown when expanded. */
+    readonly content: import("playwright-core").Locator;
+    /**
+     * This method expands the accordion item.
+     * If it is already expanded then it does nothing.
+     */
+    expand(): Promise<void>;
+    /**
+     * This method contracts the accordion item.
+     * If it is not expanded then it does nothing.
+     */
+    contract(): Promise<void>;
+}
+/**
+ * A model for an Accordion component with methods to get models for the
+ * header and individual items.
+ */
+export declare class Accordion extends ComponentModel {
+    /**
+     * A model for an accordion component.
+     * @param parent  The parent playwright page, frame or component model.
+     * @param xpath  A relative xpath selector to this element from the parent.
+     */
+    constructor(parent: Page | FrameLocator | ComponentModel, xpath?: string);
+    /** A locator to the header row. */
+    readonly header: import("playwright-core").Locator;
+    /** This method gets a visible accordion item by position. Position is 1 indexed. Negative numbers count from the end. */
+    getItem(position: number): AccordionItem;
+    /**
+     * This method gets a visible accordion item by matching text in the accordion
+     * row. If multiple items match the text, the 'nth' parameter can be used to
+     * select which is returned (the first by default).
+     */
+    getItemContainingText(text: string, nth?: number): AccordionItem;
+}
+//# sourceMappingURL=accordion.d.ts.map

package/dist/esm/component-models/accordion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"accordion.d.ts","sourceRoot":"","sources":["../../../src/component-models/accordion.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,YAAY,EAAE,KAAK,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAChE,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEvD;;GAEG;AACH,qBAAa,aAAc,SAAQ,cAAc;IAC/C,6EAA6E;IAC7E,QAAQ,CAAC,GAAG,oCAA8D;IAE1E,yFAAyF;IACzF,QAAQ,CAAC,OAAO,oCAEd;IAEF;;;OAGG;IACG,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAQ7B;;;OAGG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAOhC;AAED;;;GAGG;AACH,qBAAa,SAAU,SAAQ,cAAc;IAC3C;;;;OAIG;gBAED,MAAM,EAAE,IAAI,GAAG,YAAY,GAAG,cAAc,EAC5C,KAAK,SAAmC;IAK1C,mCAAmC;IACnC,QAAQ,CAAC,MAAM,oCAA4D;IAE3E,yHAAyH;IACzH,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,aAAa;IAQxC;;;;OAIG;IACH,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,SAAI,GAAG,aAAa;CAO5D"}

package/dist/esm/component-models/accordion.js

@@ -0,0 +1,65 @@
+import {} from '@playwright/test';
+import { ComponentModel } from '../component-model.js';
+/**
+ * A model for an AccordionItem component.
+ */
+export class AccordionItem extends ComponentModel {
+    constructor() {
+        super(...arguments);
+        /** A locator to the row for this accordion item that is always displayed. */
+        this.row = this.getLocator('//*[@data-test-id="accordion-item-row"]');
+        /** A locator to the content for this accordion item that is only shown when expanded. */
+        this.content = this.getLocator('//*[@data-test-id="accordion-item-content"]');
+    }
+    /**
+     * This method expands the accordion item.
+     * If it is already expanded then it does nothing.
+     */
+    async expand() {
+        if (await this.content.isVisible()) {
+            return;
+        }
+        await this.row.click();
+        await this.content.waitFor({ state: 'visible' });
+    }
+    /**
+     * This method contracts the accordion item.
+     * If it is not expanded then it does nothing.
+     */
+    async contract() {
+        if (!(await this.content.isVisible())) {
+            return;
+        }
+        await this.row.click();
+        await this.content.waitFor({ state: 'hidden' });
+    }
+}
+/**
+ * A model for an Accordion component with methods to get models for the
+ * header and individual items.
+ */
+export class Accordion extends ComponentModel {
+    /**
+     * A model for an accordion component.
+     * @param parent  The parent playwright page, frame or component model.
+     * @param xpath  A relative xpath selector to this element from the parent.
+     */
+    constructor(parent, xpath = '//*[@data-test-id="accordion"]') {
+        super(parent, xpath);
+        /** A locator to the header row. */
+        this.header = this.getLocator('//*[@data-test-id="accordion-header"]');
+    }
+    /** This method gets a visible accordion item by position. Position is 1 indexed. Negative numbers count from the end. */
+    getItem(position) {
+        return new AccordionItem(this, '//*[@data-test-id="accordion-item"]', position);
+    }
+    /**
+     * This method gets a visible accordion item by matching text in the accordion
+     * row. If multiple items match the text, the 'nth' parameter can be used to
+     * select which is returned (the first by default).
+     */
+    getItemContainingText(text, nth = 1) {
+        return new AccordionItem(this, `//*[@data-test-id="accordion-item" and .//*[@data-test-id="accordion-item-row" and contains(., "${text}")]]`, nth);
+    }
+}
+//# sourceMappingURL=accordion.js.map

package/dist/esm/component-models/accordion.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"accordion.js","sourceRoot":"","sources":["../../../src/component-models/accordion.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgC,MAAM,kBAAkB,CAAC;AAChE,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEvD;;GAEG;AACH,MAAM,OAAO,aAAc,SAAQ,cAAc;IAAjD;;QACE,6EAA6E;QACpE,QAAG,GAAG,IAAI,CAAC,UAAU,CAAC,yCAAyC,CAAC,CAAC;QAE1E,yFAAyF;QAChF,YAAO,GAAG,IAAI,CAAC,UAAU,CAChC,6CAA6C,CAC9C,CAAC;IAyBJ,CAAC;IAvBC;;;OAGG;IACH,KAAK,CAAC,MAAM;QACV,IAAI,MAAM,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC;YACnC,OAAO;QACT,CAAC;QACD,MAAM,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC;QACvB,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;IACnD,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,QAAQ;QACZ,IAAI,CAAC,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC,EAAE,CAAC;YACtC,OAAO;QACT,CAAC;QACD,MAAM,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC;QACvB,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;IAClD,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,OAAO,SAAU,SAAQ,cAAc;IAC3C;;;;OAIG;IACH,YACE,MAA4C,EAC5C,KAAK,GAAG,gCAAgC;QAExC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;QAGvB,mCAAmC;QAC1B,WAAM,GAAG,IAAI,CAAC,UAAU,CAAC,uCAAuC,CAAC,CAAC;IAH3E,CAAC;IAKD,yHAAyH;IACzH,OAAO,CAAC,QAAgB;QACtB,OAAO,IAAI,aAAa,CACtB,IAAI,EACJ,qCAAqC,EACrC,QAAQ,CACT,CAAC;IACJ,CAAC;IAED;;;;OAIG;IACH,qBAAqB,CAAC,IAAY,EAAE,GAAG,GAAG,CAAC;QACzC,OAAO,IAAI,aAAa,CACtB,IAAI,EACJ,mGAAmG,IAAI,MAAM,EAC7G,GAAG,CACJ,CAAC;IACJ,CAAC;CACF"}

package/dist/esm/component-models/actions.d.ts

@@ -0,0 +1,22 @@
+import { type FrameLocator, type Locator, type Page } from '@playwright/test';
+import { ComponentModel } from '../component-model.js';
+/**
+ * An model for an Actions component with methods to retrieve individual actions.
+ */
+export declare class Actions extends ComponentModel {
+    /**
+     * An model for an Actions component with methods to retrieve individual actions.
+     * @param parent  The parent playwright page, frame or component model.
+     * @param xpath  A relative xpath selector to this element from the parent.
+     */
+    constructor(parent: Page | FrameLocator | ComponentModel, xpath?: string);
+    /** A locator to the confirm button which may show after clicking an action. */
+    readonly confirmButton: Locator;
+    /** A locator to the confirm button which may show after clicking an action. */
+    readonly quickViewButton: Locator;
+    /** This method finds an action button by position. Position is 1 indexed. Negative numbers count from the end. */
+    getAction(position: number): Locator;
+    /** This method finds an action button by label. The label must match exactly. */
+    getActionByLabel(label: string): Locator;
+}
+//# sourceMappingURL=actions.d.ts.map

package/dist/esm/component-models/actions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"actions.d.ts","sourceRoot":"","sources":["../../../src/component-models/actions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,YAAY,EAAE,KAAK,OAAO,EAAE,KAAK,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAC9E,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEvD;;GAEG;AACH,qBAAa,OAAQ,SAAQ,cAAc;IACzC;;;;OAIG;gBAED,MAAM,EAAE,IAAI,GAAG,YAAY,GAAG,cAAc,EAC5C,KAAK,SAAiC;IAKxC,+EAA+E;IAC/E,QAAQ,CAAC,aAAa,UAEpB;IAEF,+EAA+E;IAC/E,QAAQ,CAAC,eAAe,UAEf;IAET,kHAAkH;IAClH,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAIpC,iFAAiF;IACjF,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;CAKzC"}

package/dist/esm/component-models/actions.js

@@ -0,0 +1,28 @@
+import {} from '@playwright/test';
+import { ComponentModel } from '../component-model.js';
+/**
+ * An model for an Actions component with methods to retrieve individual actions.
+ */
+export class Actions extends ComponentModel {
+    /**
+     * An model for an Actions component with methods to retrieve individual actions.
+     * @param parent  The parent playwright page, frame or component model.
+     * @param xpath  A relative xpath selector to this element from the parent.
+     */
+    constructor(parent, xpath = '//*[@data-test-id="actions"]') {
+        super(parent, xpath);
+        /** A locator to the confirm button which may show after clicking an action. */
+        this.confirmButton = this.getGlobalLocator(`//*[@data-test-id="action"]//*[@data-test-id="confirm"]`);
+        /** A locator to the confirm button which may show after clicking an action. */
+        this.quickViewButton = this.getGlobalLocator(`//*[@data-test-id="action" and .//span[text()="Quick View"]]`).nth(0);
+    }
+    /** This method finds an action button by position. Position is 1 indexed. Negative numbers count from the end. */
+    getAction(position) {
+        return this.getGlobalLocator('//*[@data-test-id="action"]').nth(position);
+    }
+    /** This method finds an action button by label. The label must match exactly. */
+    getActionByLabel(label) {
+        return this.getGlobalLocator(`//*[@data-test-id="action" and .//*[@data-test-id="label" and text()="${label}"]]`);
+    }
+}
+//# sourceMappingURL=actions.js.map

package/dist/esm/component-models/actions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"actions.js","sourceRoot":"","sources":["../../../src/component-models/actions.ts"],"names":[],"mappings":"AAAA,OAAO,EAA8C,MAAM,kBAAkB,CAAC;AAC9E,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEvD;;GAEG;AACH,MAAM,OAAO,OAAQ,SAAQ,cAAc;IACzC;;;;OAIG;IACH,YACE,MAA4C,EAC5C,KAAK,GAAG,8BAA8B;QAEtC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;QAGvB,+EAA+E;QACtE,kBAAa,GAAG,IAAI,CAAC,gBAAgB,CAC5C,yDAAyD,CAC1D,CAAC;QAEF,+EAA+E;QACtE,oBAAe,GAAG,IAAI,CAAC,gBAAgB,CAC9C,8DAA8D,CAC/D,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IAVT,CAAC;IAYD,kHAAkH;IAClH,SAAS,CAAC,QAAgB;QACxB,OAAO,IAAI,CAAC,gBAAgB,CAAC,6BAA6B,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IAC5E,CAAC;IAED,iFAAiF;IACjF,gBAAgB,CAAC,KAAa;QAC5B,OAAO,IAAI,CAAC,gBAAgB,CAC1B,yEAAyE,KAAK,KAAK,CACpF,CAAC;IACJ,CAAC;CACF"}

package/dist/esm/component-models/button.d.ts

@@ -0,0 +1,16 @@
+import { type FrameLocator, type Page } from '@playwright/test';
+import { ComponentModel } from '../component-model.js';
+/**
+ * A model for a Button.
+ */
+export declare class Button extends ComponentModel {
+    /**
+     * A model for a Button.
+     * @param parent  The parent playwright page, frame or component.
+     * @param xpath  A relative xpath selector to this element from the parent.
+     */
+    constructor(parent: Page | FrameLocator | ComponentModel, xpath?: string);
+    /** A locator for an inline menu button. */
+    readonly inlineMenuButton: import("playwright-core").Locator;
+}
+//# sourceMappingURL=button.d.ts.map

package/dist/esm/component-models/button.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"button.d.ts","sourceRoot":"","sources":["../../../src/component-models/button.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,YAAY,EAAE,KAAK,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAChE,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEvD;;GAEG;AACH,qBAAa,MAAO,SAAQ,cAAc;IACxC;;;;OAIG;gBACS,MAAM,EAAE,IAAI,GAAG,YAAY,GAAG,cAAc,EAAE,KAAK,SAAK;IAIpE,2CAA2C;IAC3C,QAAQ,CAAC,gBAAgB,oCAEvB;CACH"}

package/dist/esm/component-models/button.js

@@ -0,0 +1,18 @@
+import {} from '@playwright/test';
+import { ComponentModel } from '../component-model.js';
+/**
+ * A model for a Button.
+ */
+export class Button extends ComponentModel {
+    /**
+     * A model for a Button.
+     * @param parent  The parent playwright page, frame or component.
+     * @param xpath  A relative xpath selector to this element from the parent.
+     */
+    constructor(parent, xpath = '') {
+        super(parent, xpath);
+        /** A locator for an inline menu button. */
+        this.inlineMenuButton = this.getLocator('//*[@data-test-id="inline-menu-button"]');
+    }
+}
+//# sourceMappingURL=button.js.map

package/dist/esm/component-models/button.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"button.js","sourceRoot":"","sources":["../../../src/component-models/button.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgC,MAAM,kBAAkB,CAAC;AAChE,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEvD;;GAEG;AACH,MAAM,OAAO,MAAO,SAAQ,cAAc;IACxC;;;;OAIG;IACH,YAAY,MAA4C,EAAE,KAAK,GAAG,EAAE;QAClE,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;QAGvB,2CAA2C;QAClC,qBAAgB,GAAG,IAAI,CAAC,UAAU,CACzC,yCAAyC,CAC1C,CAAC;IALF,CAAC;CAMF"}