@elastic/eui-test-helpers 1.2.0 → 1.3.0

package/lib/cjs/selectors.js

@@ -9,4 +9,25 @@ Object.defineProperty(exports, "EuiComboBoxSelectors", {
     return _selectors.EuiComboBoxSelectors;
   }
 });
-var _selectors = require("./components/combo_box/selectors");
+Object.defineProperty(exports, "EuiDataGridSelectors", {
+  enumerable: true,
+  get: function () {
+    return _selectors2.EuiDataGridSelectors;
+  }
+});
+Object.defineProperty(exports, "EuiGlobalToastListSelectors", {
+  enumerable: true,
+  get: function () {
+    return _selectors4.EuiGlobalToastListSelectors;
+  }
+});
+Object.defineProperty(exports, "EuiSuperSelectSelectors", {
+  enumerable: true,
+  get: function () {
+    return _selectors3.EuiSuperSelectSelectors;
+  }
+});
+var _selectors = require("./components/combo_box/selectors");
+var _selectors2 = require("./components/datagrid/selectors");
+var _selectors3 = require("./components/form/super_select/selectors");
+var _selectors4 = require("./components/toast/selectors");

package/lib/esm/components/datagrid/selectors.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Stable selectors for
+ * {@link https://eui.elastic.co/docs/components/data-grid|EuiDataGrid}.
+ * `*_SELECTOR` values are CSS; `*_TEST_SUBJ` values are `data-test-subj` names.
+ */
+export declare const EuiDataGridSelectors: {
+    /** Root element (the `.euiDataGrid` div carrying the consumer's `data-test-subj`). */
+    ROOT_SELECTOR: string;
+    /** Root element only while fullscreen mode is active (state class set synchronously). */
+    FULL_SCREEN_ROOT_SELECTOR: string;
+    /** A rendered data row. Rows are virtualized — only a window is mounted. */
+    ROW_SELECTOR: string;
+    /**
+     * A rendered data cell. Cells carry `data-gridcell-column-id` (stable column
+     * id, unaffected by column order) and `data-gridcell-row-index`. Header cells
+     * carry `data-gridcell-column-id` too, so cell queries must include this
+     * class to exclude them.
+     */
+    ROW_CELL_SELECTOR: string;
+    /** A column header cell (also carries `data-gridcell-column-id`). */
+    HEADER_CELL_SELECTOR: string;
+    /** The header cell's actions button, interactable on focus/hover. */
+    HEADER_ACTIONS_BUTTON_SELECTOR: string;
+    FULL_SCREEN_BUTTON_TEST_SUBJ: string;
+    /**
+     * A column's header actions menu. It renders in a portal, but EUI names it
+     * per column id, which keeps lookups safe when several grids coexist.
+     */
+    headerActionsMenuFor: (columnId: string) => string;
+    /** A rendered data cell addressed by column id and row index. */
+    cellFor: (columnId: string, rowIndex: number) => string;
+    /** All rendered data cells of a column. */
+    columnCellsFor: (columnId: string) => string;
+    /** A column's header cell. */
+    headerCellFor: (columnId: string) => string;
+};

package/lib/esm/components/datagrid/selectors.js

@@ -0,0 +1,44 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License
+ * 2.0 and the Server Side Public License, v 1; you may not use this file except
+ * in compliance with, at your election, the Elastic License 2.0 or the Server
+ * Side Public License, v 1.
+ */
+/**
+ * Stable selectors for
+ * {@link https://eui.elastic.co/docs/components/data-grid|EuiDataGrid}.
+ * `*_SELECTOR` values are CSS; `*_TEST_SUBJ` values are `data-test-subj` names.
+ */
+export const EuiDataGridSelectors = {
+    /** Root element (the `.euiDataGrid` div carrying the consumer's `data-test-subj`). */
+    ROOT_SELECTOR: '.euiDataGrid',
+    /** Root element only while fullscreen mode is active (state class set synchronously). */
+    FULL_SCREEN_ROOT_SELECTOR: '.euiDataGrid--fullScreen',
+    /** A rendered data row. Rows are virtualized — only a window is mounted. */
+    ROW_SELECTOR: '.euiDataGridRow',
+    /**
+     * A rendered data cell. Cells carry `data-gridcell-column-id` (stable column
+     * id, unaffected by column order) and `data-gridcell-row-index`. Header cells
+     * carry `data-gridcell-column-id` too, so cell queries must include this
+     * class to exclude them.
+     */
+    ROW_CELL_SELECTOR: '.euiDataGridRowCell',
+    /** A column header cell (also carries `data-gridcell-column-id`). */
+    HEADER_CELL_SELECTOR: '.euiDataGridHeaderCell',
+    /** The header cell's actions button, interactable on focus/hover. */
+    HEADER_ACTIONS_BUTTON_SELECTOR: '.euiDataGridHeaderCell__button',
+    FULL_SCREEN_BUTTON_TEST_SUBJ: 'dataGridFullScreenButton',
+    /**
+     * A column's header actions menu. It renders in a portal, but EUI names it
+     * per column id, which keeps lookups safe when several grids coexist.
+     */
+    headerActionsMenuFor: (columnId) => `[data-test-subj="dataGridHeaderCellActionGroup-${columnId}"]`,
+    /** A rendered data cell addressed by column id and row index. */
+    cellFor: (columnId, rowIndex) => `.euiDataGridRowCell[data-gridcell-column-id="${columnId}"][data-gridcell-row-index="${rowIndex}"]`,
+    /** All rendered data cells of a column. */
+    columnCellsFor: (columnId) => `.euiDataGridRowCell[data-gridcell-column-id="${columnId}"]`,
+    /** A column's header cell. */
+    headerCellFor: (columnId) => `.euiDataGridHeaderCell[data-gridcell-column-id="${columnId}"]`,
+};
+//# sourceMappingURL=selectors.js.map

package/lib/esm/components/datagrid/selectors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"selectors.js","sourceRoot":"","sources":["../../../../src/components/datagrid/selectors.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;GAIG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,sFAAsF;IACtF,aAAa,EAAE,cAAc;IAE7B,yFAAyF;IACzF,yBAAyB,EAAE,0BAA0B;IAErD,4EAA4E;IAC5E,YAAY,EAAE,iBAAiB;IAE/B;;;;;OAKG;IACH,iBAAiB,EAAE,qBAAqB;IAExC,qEAAqE;IACrE,oBAAoB,EAAE,wBAAwB;IAE9C,qEAAqE;IACrE,8BAA8B,EAAE,gCAAgC;IAEhE,4BAA4B,EAAE,0BAA0B;IAExD;;;OAGG;IACH,oBAAoB,EAAE,CAAC,QAAgB,EAAU,EAAE,CACjD,kDAAkD,QAAQ,IAAI;IAEhE,iEAAiE;IACjE,OAAO,EAAE,CAAC,QAAgB,EAAE,QAAgB,EAAU,EAAE,CACtD,gDAAgD,QAAQ,+BAA+B,QAAQ,IAAI;IAErG,2CAA2C;IAC3C,cAAc,EAAE,CAAC,QAAgB,EAAU,EAAE,CAC3C,gDAAgD,QAAQ,IAAI;IAE9D,8BAA8B;IAC9B,aAAa,EAAE,CAAC,QAAgB,EAAU,EAAE,CAC1C,mDAAmD,QAAQ,IAAI;CAClE,CAAC"}

package/lib/esm/components/form/super_select/selectors.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Stable selectors for
+ * {@link https://eui.elastic.co/docs/components/forms/selection/super-select/|EuiSuperSelect}.
+ * `*_SELECTOR` values are CSS.
+ */
+export declare const EuiSuperSelectSelectors: {
+    /**
+     * Root element (the control `<button>` carrying the consumer's
+     * `data-test-subj` — EUI spreads rest props onto it).
+     */
+    ROOT_SELECTOR: string;
+    /**
+     * The popover wrapper around the control. The hidden form input holding the
+     * committed value is a sibling of the button inside it.
+     */
+    WRAPPER_SELECTOR: string;
+    /**
+     * The options listbox. It renders in a popover portal, but EUI keeps at most
+     * one super-select dropdown open at a time, so a page-level lookup is safe.
+     */
+    LISTBOX_SELECTOR: string;
+    /**
+     * The hidden form input holding the committed `value` — a direct child of
+     * the popover wrapper, scoped as such so hidden inputs a consumer might
+     * render inside prepend/append content are never matched.
+     */
+    HIDDEN_INPUT_SELECTOR: string;
+    /**
+     * An option addressed by its `value` — EUI renders every option with
+     * `id={String(value)}`.
+     */
+    optionByValue: (value: string) => string;
+};

package/lib/esm/components/form/super_select/selectors.js

@@ -0,0 +1,41 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License
+ * 2.0 and the Server Side Public License, v 1; you may not use this file except
+ * in compliance with, at your election, the Elastic License 2.0 or the Server
+ * Side Public License, v 1.
+ */
+/**
+ * Stable selectors for
+ * {@link https://eui.elastic.co/docs/components/forms/selection/super-select/|EuiSuperSelect}.
+ * `*_SELECTOR` values are CSS.
+ */
+export const EuiSuperSelectSelectors = {
+    /**
+     * Root element (the control `<button>` carrying the consumer's
+     * `data-test-subj` — EUI spreads rest props onto it).
+     */
+    ROOT_SELECTOR: '.euiSuperSelectControl',
+    /**
+     * The popover wrapper around the control. The hidden form input holding the
+     * committed value is a sibling of the button inside it.
+     */
+    WRAPPER_SELECTOR: '.euiSuperSelect',
+    /**
+     * The options listbox. It renders in a popover portal, but EUI keeps at most
+     * one super-select dropdown open at a time, so a page-level lookup is safe.
+     */
+    LISTBOX_SELECTOR: '.euiSuperSelect__listbox[role="listbox"]',
+    /**
+     * The hidden form input holding the committed `value` — a direct child of
+     * the popover wrapper, scoped as such so hidden inputs a consumer might
+     * render inside prepend/append content are never matched.
+     */
+    HIDDEN_INPUT_SELECTOR: ':scope > input[type="hidden"]',
+    /**
+     * An option addressed by its `value` — EUI renders every option with
+     * `id={String(value)}`.
+     */
+    optionByValue: (value) => `[role="option"][id="${value}"]`,
+};
+//# sourceMappingURL=selectors.js.map

package/lib/esm/components/form/super_select/selectors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"selectors.js","sourceRoot":"","sources":["../../../../../src/components/form/super_select/selectors.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;GAIG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACrC;;;OAGG;IACH,aAAa,EAAE,wBAAwB;IAEvC;;;OAGG;IACH,gBAAgB,EAAE,iBAAiB;IAEnC;;;OAGG;IACH,gBAAgB,EAAE,0CAA0C;IAE5D;;;;OAIG;IACH,qBAAqB,EAAE,+BAA+B;IAEtD;;;OAGG;IACH,aAAa,EAAE,CAAC,KAAa,EAAU,EAAE,CAAC,uBAAuB,KAAK,IAAI;CAC3E,CAAC"}

package/lib/esm/components/toast/selectors.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Stable selectors for
+ * {@link https://eui.elastic.co/docs/components/display/toast/|EuiGlobalToastList}.
+ * `*_SELECTOR` values are CSS; `*_TEST_SUBJ` values are `data-test-subj` names.
+ */
+export declare const EuiGlobalToastListSelectors: {
+    /** Root element (the list carrying the consumer's `data-test-subj`). */
+    ROOT_SELECTOR: string;
+    /** A toast inside the list. */
+    TOAST_SELECTOR: string;
+    CLOSE_BUTTON_TEST_SUBJ: string;
+};

package/lib/esm/components/toast/selectors.js

@@ -0,0 +1,20 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License
+ * 2.0 and the Server Side Public License, v 1; you may not use this file except
+ * in compliance with, at your election, the Elastic License 2.0 or the Server
+ * Side Public License, v 1.
+ */
+/**
+ * Stable selectors for
+ * {@link https://eui.elastic.co/docs/components/display/toast/|EuiGlobalToastList}.
+ * `*_SELECTOR` values are CSS; `*_TEST_SUBJ` values are `data-test-subj` names.
+ */
+export const EuiGlobalToastListSelectors = {
+    /** Root element (the list carrying the consumer's `data-test-subj`). */
+    ROOT_SELECTOR: '.euiGlobalToastList',
+    /** A toast inside the list. */
+    TOAST_SELECTOR: '.euiToast',
+    CLOSE_BUTTON_TEST_SUBJ: 'toastCloseButton',
+};
+//# sourceMappingURL=selectors.js.map

package/lib/esm/components/toast/selectors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"selectors.js","sourceRoot":"","sources":["../../../../src/components/toast/selectors.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;GAIG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAG;IACzC,wEAAwE;IACxE,aAAa,EAAE,qBAAqB;IAEpC,+BAA+B;IAC/B,cAAc,EAAE,WAAW;IAE3B,sBAAsB,EAAE,kBAAkB;CAC3C,CAAC"}

package/lib/esm/index.d.ts

@@ -1,2 +1,5 @@
 export { BaseObject, type ObjectScope } from './playwright/base_object';
 export { EuiComboBoxObject } from './playwright/components/combo_box/object';
+export { EuiDataGridObject } from './playwright/components/datagrid/object';
+export { EuiSuperSelectObject } from './playwright/components/form/super_select/object';
+export { EuiGlobalToastListObject } from './playwright/components/toast/object';

package/lib/esm/index.js

@@ -7,4 +7,7 @@
  */
 export { BaseObject } from './playwright/base_object';
 export { EuiComboBoxObject } from './playwright/components/combo_box/object';
+export { EuiDataGridObject } from './playwright/components/datagrid/object';
+export { EuiSuperSelectObject } from './playwright/components/form/super_select/object';
+export { EuiGlobalToastListObject } from './playwright/components/toast/object';
 //# sourceMappingURL=index.js.map

package/lib/esm/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,UAAU,EAAoB,MAAM,0BAA0B,CAAC;AACxE,OAAO,EAAE,iBAAiB,EAAE,MAAM,0CAA0C,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,UAAU,EAAoB,MAAM,0BAA0B,CAAC;AACxE,OAAO,EAAE,iBAAiB,EAAE,MAAM,0CAA0C,CAAC;AAC7E,OAAO,EAAE,iBAAiB,EAAE,MAAM,yCAAyC,CAAC;AAC5E,OAAO,EAAE,oBAAoB,EAAE,MAAM,kDAAkD,CAAC;AACxF,OAAO,EAAE,wBAAwB,EAAE,MAAM,sCAAsC,CAAC"}

package/lib/esm/playwright/components/datagrid/object.d.ts

@@ -0,0 +1,51 @@
+import type { Locator } from '@playwright/test';
+import { BaseObject, type ObjectScope } from '../../base_object';
+/**
+ * Playwright Component Object for {@link
+ * https://eui.elastic.co/docs/components/data-grid EuiDataGrid}.
+ *
+ * `testSubj` must match the `data-test-subj` set by the consumer on the
+ * `EuiDataGrid` itself (the component-type guard enforces it) — EUI toggles
+ * state classes (fullscreen) on that element. When the subj is not unique on
+ * the page (e.g. portal-rendered duplicates), narrow with the `scope`
+ * parameter instead of pointing the subj at a wrapper.
+ */
+export declare class EuiDataGridObject extends BaseObject {
+    constructor(scope: ObjectScope, testSubj: string);
+    /**
+     * The rows currently mounted in the DOM, as a `Locator` so callers keep
+     * Playwright auto-retry for count and content assertions
+     * (e.g. `expect(rows).toHaveCount(pageSize)`, `expect(rows).not.toHaveCount(0)`).
+     * For a paginated grid this is the current page's rows. Rows are virtualized,
+     * so on a grid too tall for its container this is only the visible window —
+     * never treat it as the full data set.
+     */
+    get rows(): Locator;
+    /**
+     * A single data cell, addressed by row index and column id. Column order and
+     * virtualized horizontal scrolling do not affect the column id.
+     */
+    cell(rowIndex: number, columnId: string): Locator;
+    /**
+     * All currently rendered data cells of a column. Rows are virtualized, so
+     * this is the rendered window, not necessarily every row.
+     */
+    cells(columnId: string): Locator;
+    /**
+     * Opens the header actions of a column and clicks the given action.
+     * `columnId` is the grid column id (matched verbatim), `actionLabel` is the
+     * visible action label (e.g. 'Hide column', 'Sort A-Z').
+     */
+    doActionOnColumn(columnId: string, actionLabel: string): Promise<void>;
+    /** Enters fullscreen mode via the toolbar button. */
+    openFullScreenMode(): Promise<void>;
+    /** Exits fullscreen mode via the toolbar button. */
+    closeFullScreenMode(): Promise<void>;
+    /** The grid element only while it carries the fullscreen state class. */
+    private get fullScreenGrid();
+    /**
+     * The fullscreen button sits in a tooltip wrapper and keeps focus after the
+     * click, which keeps the tooltip open over the grid — blur it right away.
+     */
+    private clickFullScreenButton;
+}

package/lib/esm/playwright/components/datagrid/object.js

@@ -0,0 +1,99 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License
+ * 2.0 and the Server Side Public License, v 1; you may not use this file except
+ * in compliance with, at your election, the Elastic License 2.0 or the Server
+ * Side Public License, v 1.
+ */
+import { BaseObject } from '../../base_object';
+import { EuiDataGridSelectors } from '../../../components/datagrid/selectors';
+/**
+ * Playwright Component Object for {@link
+ * https://eui.elastic.co/docs/components/data-grid EuiDataGrid}.
+ *
+ * `testSubj` must match the `data-test-subj` set by the consumer on the
+ * `EuiDataGrid` itself (the component-type guard enforces it) — EUI toggles
+ * state classes (fullscreen) on that element. When the subj is not unique on
+ * the page (e.g. portal-rendered duplicates), narrow with the `scope`
+ * parameter instead of pointing the subj at a wrapper.
+ */
+export class EuiDataGridObject extends BaseObject {
+    constructor(scope, testSubj) {
+        super(scope, testSubj, EuiDataGridSelectors.ROOT_SELECTOR);
+    }
+    /**
+     * The rows currently mounted in the DOM, as a `Locator` so callers keep
+     * Playwright auto-retry for count and content assertions
+     * (e.g. `expect(rows).toHaveCount(pageSize)`, `expect(rows).not.toHaveCount(0)`).
+     * For a paginated grid this is the current page's rows. Rows are virtualized,
+     * so on a grid too tall for its container this is only the visible window —
+     * never treat it as the full data set.
+     */
+    get rows() {
+        return this.root.locator(EuiDataGridSelectors.ROW_SELECTOR);
+    }
+    /**
+     * A single data cell, addressed by row index and column id. Column order and
+     * virtualized horizontal scrolling do not affect the column id.
+     */
+    cell(rowIndex, columnId) {
+        return this.root.locator(EuiDataGridSelectors.cellFor(columnId, rowIndex));
+    }
+    /**
+     * All currently rendered data cells of a column. Rows are virtualized, so
+     * this is the rendered window, not necessarily every row.
+     */
+    cells(columnId) {
+        return this.root.locator(EuiDataGridSelectors.columnCellsFor(columnId));
+    }
+    /**
+     * Opens the header actions of a column and clicks the given action.
+     * `columnId` is the grid column id (matched verbatim), `actionLabel` is the
+     * visible action label (e.g. 'Hide column', 'Sort A-Z').
+     */
+    async doActionOnColumn(columnId, actionLabel) {
+        const headerCell = this.root.locator(EuiDataGridSelectors.headerCellFor(columnId));
+        // The actions button only becomes interactable when the header cell is
+        // focused/hovered and inside the viewport.
+        await headerCell.scrollIntoViewIfNeeded();
+        await headerCell.focus();
+        await headerCell.hover();
+        await headerCell
+            .locator(EuiDataGridSelectors.HEADER_ACTIONS_BUTTON_SELECTOR)
+            .click();
+        const actionsMenu = this.root
+            .page()
+            .locator(EuiDataGridSelectors.headerActionsMenuFor(columnId));
+        await actionsMenu.waitFor({ state: 'visible' });
+        // Role+name query auto-escapes the label and matches the accessible name
+        // (Kibana's lint also forbids getByTitle in favor of role queries).
+        await actionsMenu
+            .getByRole('button', { name: actionLabel, exact: true })
+            .click();
+        await actionsMenu.waitFor({ state: 'hidden' });
+    }
+    /** Enters fullscreen mode via the toolbar button. */
+    async openFullScreenMode() {
+        await this.clickFullScreenButton();
+        await this.fullScreenGrid.waitFor({ state: 'visible' });
+    }
+    /** Exits fullscreen mode via the toolbar button. */
+    async closeFullScreenMode() {
+        await this.clickFullScreenButton();
+        await this.fullScreenGrid.waitFor({ state: 'detached' });
+    }
+    /** The grid element only while it carries the fullscreen state class. */
+    get fullScreenGrid() {
+        return this.root.and(this.root.page().locator(EuiDataGridSelectors.FULL_SCREEN_ROOT_SELECTOR));
+    }
+    /**
+     * The fullscreen button sits in a tooltip wrapper and keeps focus after the
+     * click, which keeps the tooltip open over the grid — blur it right away.
+     */
+    async clickFullScreenButton() {
+        const button = this.root.getByTestId(EuiDataGridSelectors.FULL_SCREEN_BUTTON_TEST_SUBJ);
+        await button.click();
+        await button.blur();
+    }
+}
+//# sourceMappingURL=object.js.map

package/lib/esm/playwright/components/datagrid/object.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"object.js","sourceRoot":"","sources":["../../../../../src/playwright/components/datagrid/object.ts"],"names":[],"mappings":"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"}

package/lib/esm/playwright/components/form/super_select/object.d.ts

@@ -0,0 +1,40 @@
+import { BaseObject, type ObjectScope } from '../../../base_object';
+/**
+ * Playwright Component Object for {@link
+ * https://eui.elastic.co/docs/components/forms/selection/super-select/ EuiSuperSelect}.
+ *
+ * `testSubj` must match the `data-test-subj` set by the consumer on the
+ * `<EuiSuperSelect>` — EUI spreads it onto the control `<button>`
+ * (`.euiSuperSelectControl`).
+ */
+export declare class EuiSuperSelectObject extends BaseObject {
+    constructor(scope: ObjectScope, testSubj: string);
+    /**
+     * Selects an option by its `value`. EUI renders every option with
+     * `id={String(value)}`, so this works for any EuiSuperSelect without extra
+     * test hooks and is the preferred method when the value is a stable code
+     * constant.
+     */
+    selectOptionByValue(value: string): Promise<void>;
+    /**
+     * Selects an option by its visible label. Use for dynamic, data-driven
+     * option content where the value is not known to the test. Note the dropdown
+     * shows `dropdownDisplay` when the consumer provides it, which can differ
+     * from the committed `inputDisplay` text.
+     */
+    selectOptionByLabel(label: string): Promise<void>;
+    /**
+     * The committed selection's `value`, read from the hidden form input EUI
+     * renders next to the control (the visible button text shows the label, not
+     * the value).
+     */
+    getSelectedValue(): Promise<string>;
+    /** Opens the dropdown if it is not already open. */
+    private open;
+    private get listbox();
+    /**
+     * The hidden input is a sibling of the control button; reach it through the
+     * `.euiSuperSelect` popover wrapper that contains this instance's button.
+     */
+    private get hiddenInput();
+}

package/lib/esm/playwright/components/form/super_select/object.js

@@ -0,0 +1,76 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License
+ * 2.0 and the Server Side Public License, v 1; you may not use this file except
+ * in compliance with, at your election, the Elastic License 2.0 or the Server
+ * Side Public License, v 1.
+ */
+import { BaseObject } from '../../../base_object';
+import { EuiSuperSelectSelectors } from '../../../../components/form/super_select/selectors';
+/**
+ * Playwright Component Object for {@link
+ * https://eui.elastic.co/docs/components/forms/selection/super-select/ EuiSuperSelect}.
+ *
+ * `testSubj` must match the `data-test-subj` set by the consumer on the
+ * `<EuiSuperSelect>` — EUI spreads it onto the control `<button>`
+ * (`.euiSuperSelectControl`).
+ */
+export class EuiSuperSelectObject extends BaseObject {
+    constructor(scope, testSubj) {
+        super(scope, testSubj, EuiSuperSelectSelectors.ROOT_SELECTOR);
+    }
+    /**
+     * Selects an option by its `value`. EUI renders every option with
+     * `id={String(value)}`, so this works for any EuiSuperSelect without extra
+     * test hooks and is the preferred method when the value is a stable code
+     * constant.
+     */
+    async selectOptionByValue(value) {
+        await this.open();
+        await this.listbox
+            .locator(EuiSuperSelectSelectors.optionByValue(value))
+            .click();
+        await this.listbox.waitFor({ state: 'detached' });
+    }
+    /**
+     * Selects an option by its visible label. Use for dynamic, data-driven
+     * option content where the value is not known to the test. Note the dropdown
+     * shows `dropdownDisplay` when the consumer provides it, which can differ
+     * from the committed `inputDisplay` text.
+     */
+    async selectOptionByLabel(label) {
+        await this.open();
+        await this.listbox.getByRole('option', { name: label }).click();
+        await this.listbox.waitFor({ state: 'detached' });
+    }
+    /**
+     * The committed selection's `value`, read from the hidden form input EUI
+     * renders next to the control (the visible button text shows the label, not
+     * the value).
+     */
+    async getSelectedValue() {
+        return this.hiddenInput.inputValue();
+    }
+    /** Opens the dropdown if it is not already open. */
+    async open() {
+        if (await this.listbox.isVisible()) {
+            return;
+        }
+        await this.root.click();
+        await this.listbox.waitFor({ state: 'visible' });
+    }
+    get listbox() {
+        return this.root.page().locator(EuiSuperSelectSelectors.LISTBOX_SELECTOR);
+    }
+    /**
+     * The hidden input is a sibling of the control button; reach it through the
+     * `.euiSuperSelect` popover wrapper that contains this instance's button.
+     */
+    get hiddenInput() {
+        return this.scope
+            .locator(EuiSuperSelectSelectors.WRAPPER_SELECTOR)
+            .filter({ has: this.root })
+            .locator(EuiSuperSelectSelectors.HIDDEN_INPUT_SELECTOR);
+    }
+}
+//# sourceMappingURL=object.js.map

package/lib/esm/playwright/components/form/super_select/object.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"object.js","sourceRoot":"","sources":["../../../../../../src/playwright/components/form/super_select/object.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,EAAE,UAAU,EAAoB,MAAM,sBAAsB,CAAC;AACpE,OAAO,EAAE,uBAAuB,EAAE,MAAM,oDAAoD,CAAC;AAE7F;;;;;;;GAOG;AACH,MAAM,OAAO,oBAAqB,SAAQ,UAAU;IAClD,YAAY,KAAkB,EAAE,QAAgB;QAC9C,KAAK,CAAC,KAAK,EAAE,QAAQ,EAAE,uBAAuB,CAAC,aAAa,CAAC,CAAC;IAChE,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,mBAAmB,CAAC,KAAa;QACrC,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;QAClB,MAAM,IAAI,CAAC,OAAO;aACf,OAAO,CAAC,uBAAuB,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;aACrD,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC,CAAC;IACpD,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,mBAAmB,CAAC,KAAa;QACrC,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;QAClB,MAAM,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,QAAQ,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC;QAChE,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC,CAAC;IACpD,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,gBAAgB;QACpB,OAAO,IAAI,CAAC,WAAW,CAAC,UAAU,EAAE,CAAC;IACvC,CAAC;IAED,oDAAoD;IAC5C,KAAK,CAAC,IAAI;QAChB,IAAI,MAAM,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC;YACnC,OAAO;QACT,CAAC;QACD,MAAM,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;QACxB,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;IACnD,CAAC;IAED,IAAY,OAAO;QACjB,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,uBAAuB,CAAC,gBAAgB,CAAC,CAAC;IAC5E,CAAC;IAED;;;OAGG;IACH,IAAY,WAAW;QACrB,OAAO,IAAI,CAAC,KAAK;aACd,OAAO,CAAC,uBAAuB,CAAC,gBAAgB,CAAC;aACjD,MAAM,CAAC,EAAE,GAAG,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC;aAC1B,OAAO,CAAC,uBAAuB,CAAC,qBAAqB,CAAC,CAAC;IAC5D,CAAC;CACF"}

package/lib/esm/playwright/components/toast/object.d.ts

@@ -0,0 +1,24 @@
+import { type Locator } from '@playwright/test';
+import { BaseObject, type ObjectScope } from '../../base_object';
+/**
+ * Playwright Component Object for {@link
+ * https://eui.elastic.co/docs/components/display/toast/ EuiGlobalToastList}.
+ *
+ * `testSubj` must match the `data-test-subj` set by the consumer on the
+ * `<EuiGlobalToastList>` (the `.euiGlobalToastList` element). Toasts rendered
+ * outside the list (inline `EuiToast`) are not covered.
+ */
+export declare class EuiGlobalToastListObject extends BaseObject {
+    constructor(scope: ObjectScope, testSubj: string);
+    /**
+     * The toasts currently in the list. Exposed as a `Locator` so callers keep
+     * Playwright auto-retry for count and content assertions
+     * (e.g. `expect(toasts).toHaveCount(1)`).
+     */
+    get toasts(): Locator;
+    /**
+     * Closes every toast in the list and waits until none remain. No-op when the
+     * list is empty (dismissing "if present" is a common teardown need).
+     */
+    closeAll(): Promise<void>;
+}

package/lib/esm/playwright/components/toast/object.js

@@ -0,0 +1,46 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License
+ * 2.0 and the Server Side Public License, v 1; you may not use this file except
+ * in compliance with, at your election, the Elastic License 2.0 or the Server
+ * Side Public License, v 1.
+ */
+import { expect } from '@playwright/test';
+import { BaseObject } from '../../base_object';
+import { EuiGlobalToastListSelectors } from '../../../components/toast/selectors';
+/**
+ * Playwright Component Object for {@link
+ * https://eui.elastic.co/docs/components/display/toast/ EuiGlobalToastList}.
+ *
+ * `testSubj` must match the `data-test-subj` set by the consumer on the
+ * `<EuiGlobalToastList>` (the `.euiGlobalToastList` element). Toasts rendered
+ * outside the list (inline `EuiToast`) are not covered.
+ */
+export class EuiGlobalToastListObject extends BaseObject {
+    constructor(scope, testSubj) {
+        super(scope, testSubj, EuiGlobalToastListSelectors.ROOT_SELECTOR);
+    }
+    /**
+     * The toasts currently in the list. Exposed as a `Locator` so callers keep
+     * Playwright auto-retry for count and content assertions
+     * (e.g. `expect(toasts).toHaveCount(1)`).
+     */
+    get toasts() {
+        return this.root.locator(EuiGlobalToastListSelectors.TOAST_SELECTOR);
+    }
+    /**
+     * Closes every toast in the list and waits until none remain. No-op when the
+     * list is empty (dismissing "if present" is a common teardown need).
+     */
+    async closeAll() {
+        const closeButtons = await this.root
+            .getByTestId(EuiGlobalToastListSelectors.CLOSE_BUTTON_TEST_SUBJ)
+            .all();
+        for (const closeButton of closeButtons) {
+            // A toast may auto-dismiss while iterating; ignore clicks that miss.
+            await closeButton.click({ timeout: 5000 }).catch(() => { });
+        }
+        await expect(this.toasts).toHaveCount(0);
+    }
+}
+//# sourceMappingURL=object.js.map

package/lib/esm/playwright/components/toast/object.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"object.js","sourceRoot":"","sources":["../../../../../src/playwright/components/toast/object.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,MAAM,EAAgB,MAAM,kBAAkB,CAAC;AAExD,OAAO,EAAE,UAAU,EAAoB,MAAM,mBAAmB,CAAC;AACjE,OAAO,EAAE,2BAA2B,EAAE,MAAM,qCAAqC,CAAC;AAElF;;;;;;;GAOG;AACH,MAAM,OAAO,wBAAyB,SAAQ,UAAU;IACtD,YAAY,KAAkB,EAAE,QAAgB;QAC9C,KAAK,CAAC,KAAK,EAAE,QAAQ,EAAE,2BAA2B,CAAC,aAAa,CAAC,CAAC;IACpE,CAAC;IAED;;;;OAIG;IACH,IAAW,MAAM;QACf,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,2BAA2B,CAAC,cAAc,CAAC,CAAC;IACvE,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,QAAQ;QACZ,MAAM,YAAY,GAAG,MAAM,IAAI,CAAC,IAAI;aACjC,WAAW,CAAC,2BAA2B,CAAC,sBAAsB,CAAC;aAC/D,GAAG,EAAE,CAAC;QACT,KAAK,MAAM,WAAW,IAAI,YAAY,EAAE,CAAC;YACvC,qEAAqE;YACrE,MAAM,WAAW,CAAC,KAAK,CAAC,EAAE,OAAO,EAAE,IAAK,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QAC9D,CAAC;QACD,MAAM,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;IAC3C,CAAC;CACF"}

package/lib/esm/selectors.d.ts

@@ -1 +1,4 @@
 export { EuiComboBoxSelectors } from './components/combo_box/selectors';
+export { EuiDataGridSelectors } from './components/datagrid/selectors';
+export { EuiSuperSelectSelectors } from './components/form/super_select/selectors';
+export { EuiGlobalToastListSelectors } from './components/toast/selectors';

package/lib/esm/selectors.js

@@ -6,4 +6,7 @@
  * Side Public License, v 1.
  */
 export { EuiComboBoxSelectors } from './components/combo_box/selectors';
+export { EuiDataGridSelectors } from './components/datagrid/selectors';
+export { EuiSuperSelectSelectors } from './components/form/super_select/selectors';
+export { EuiGlobalToastListSelectors } from './components/toast/selectors';
 //# sourceMappingURL=selectors.js.map

package/lib/esm/selectors.js.map

@@ -1 +1 @@
-{"version":3,"file":"selectors.js","sourceRoot":"","sources":["../../src/selectors.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,kCAAkC,CAAC"}
+{"version":3,"file":"selectors.js","sourceRoot":"","sources":["../../src/selectors.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,kCAAkC,CAAC;AACxE,OAAO,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAC;AACvE,OAAO,EAAE,uBAAuB,EAAE,MAAM,0CAA0C,CAAC;AACnF,OAAO,EAAE,2BAA2B,EAAE,MAAM,8BAA8B,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@elastic/eui-test-helpers",
-  "version": "1.2.0",
+  "version": "1.3.0",
   "description": "A library of EUI test helpers for RTL, Cypress and Scout",
   "license": "SEE LICENSE IN LICENSE.txt",
   "repository": {