@elastic/eui-test-helpers 1.4.0 → 1.5.0

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

@@ -0,0 +1,25 @@
+/*
+ * 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/tabular-content/tables/|EuiBasicTable}
+ * (also covers `EuiInMemoryTable`, which renders a `EuiBasicTable` underneath).
+ * `*_SELECTOR` values are CSS.
+ */
+export const EuiBasicTableSelectors = {
+    /** Root element (the `.euiBasicTable` container carrying the consumer's `data-test-subj`). */
+    ROOT_SELECTOR: '.euiBasicTable',
+    /** A data row. Also matches EUI's own empty/error message row — callers must exclude those. */
+    ROW_SELECTOR: '.euiTableRow',
+    /**
+     * A field-data column's header cell. `%s` is the column's `field`. EUI appends a
+     * positional index (`tableHeaderCell_<field>_<index>`), so this is a prefix match.
+     */
+    HEADER_CELL_SELECTOR_PREFIX: 'tableHeaderCell_',
+};
+//# sourceMappingURL=selectors.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"selectors.js","sourceRoot":"","sources":["../../../../src/components/basic_table/selectors.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;;GAKG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC,8FAA8F;IAC9F,aAAa,EAAE,gBAAgB;IAE/B,+FAA+F;IAC/F,YAAY,EAAE,cAAc;IAE5B;;;OAGG;IACH,2BAA2B,EAAE,kBAAkB;CAChD,CAAC"}

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

@@ -0,0 +1,15 @@
+/**
+ * Stable selectors for
+ * {@link https://eui.elastic.co/docs/components/drag-and-drop/|EuiDraggable}.
+ * `*_SELECTOR` values are CSS.
+ */
+export declare const EuiDraggableSelectors: {
+    /**
+     * Attribute `@hello-pangea/dnd` (which `EuiDraggable` wraps) spreads onto an
+     * enabled drag handle. Used to verify `testSubj` actually points at a handle,
+     * not a fixed EUI class — the handle markup itself is consumer-defined.
+     */
+    HANDLE_SELECTOR: string;
+    /** Attribute `@hello-pangea/dnd` spreads onto every draggable item wrapper, enabled or not. */
+    ITEM_SELECTOR: string;
+};

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

@@ -0,0 +1,23 @@
+/*
+ * 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/drag-and-drop/|EuiDraggable}.
+ * `*_SELECTOR` values are CSS.
+ */
+export const EuiDraggableSelectors = {
+    /**
+     * Attribute `@hello-pangea/dnd` (which `EuiDraggable` wraps) spreads onto an
+     * enabled drag handle. Used to verify `testSubj` actually points at a handle,
+     * not a fixed EUI class — the handle markup itself is consumer-defined.
+     */
+    HANDLE_SELECTOR: '[data-rfd-drag-handle-draggable-id]',
+    /** Attribute `@hello-pangea/dnd` spreads onto every draggable item wrapper, enabled or not. */
+    ITEM_SELECTOR: '[data-rfd-draggable-id]',
+};
+//# sourceMappingURL=selectors.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"selectors.js","sourceRoot":"","sources":["../../../../src/components/drag_and_drop/selectors.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;GAIG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC;;;;OAIG;IACH,eAAe,EAAE,qCAAqC;IAEtD,+FAA+F;IAC/F,aAAa,EAAE,yBAAyB;CACzC,CAAC"}

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

@@ -0,0 +1,16 @@
+/**
+ * Stable selectors for
+ * {@link https://eui.elastic.co/docs/components/forms/filter-group/|EuiFilterButton}.
+ * `*_SELECTOR` values are CSS, `*_CLASS` values are class names to check for
+ * membership (e.g. via `toHaveClass`).
+ */
+export declare const EuiFilterButtonSelectors: {
+    /** Root element (the button itself carries the consumer's `data-test-subj`). */
+    ROOT_SELECTOR: string;
+    /** The notification badge, present only when `numFilters` or `numActiveFilters` is set. */
+    NOTIFICATION_SELECTOR: string;
+    /** Set when `hasActiveFilters` is true. */
+    HAS_ACTIVE_FILTERS_CLASS: string;
+    /** Set when `isSelected` is true (e.g. a popover-toggle button while its popover is open). */
+    IS_SELECTED_CLASS: string;
+};

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

@@ -0,0 +1,24 @@
+/*
+ * 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/filter-group/|EuiFilterButton}.
+ * `*_SELECTOR` values are CSS, `*_CLASS` values are class names to check for
+ * membership (e.g. via `toHaveClass`).
+ */
+export const EuiFilterButtonSelectors = {
+    /** Root element (the button itself carries the consumer's `data-test-subj`). */
+    ROOT_SELECTOR: '.euiFilterButton',
+    /** The notification badge, present only when `numFilters` or `numActiveFilters` is set. */
+    NOTIFICATION_SELECTOR: '.euiFilterButton__notification',
+    /** Set when `hasActiveFilters` is true. */
+    HAS_ACTIVE_FILTERS_CLASS: 'euiFilterButton-hasActiveFilters',
+    /** Set when `isSelected` is true (e.g. a popover-toggle button while its popover is open). */
+    IS_SELECTED_CLASS: 'euiFilterButton-isSelected',
+};
+//# sourceMappingURL=selectors.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"selectors.js","sourceRoot":"","sources":["../../../../src/components/filter_button/selectors.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;;GAKG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACtC,gFAAgF;IAChF,aAAa,EAAE,kBAAkB;IAEjC,2FAA2F;IAC3F,qBAAqB,EAAE,gCAAgC;IAEvD,2CAA2C;IAC3C,wBAAwB,EAAE,kCAAkC;IAE5D,8FAA8F;IAC9F,iBAAiB,EAAE,4BAA4B;CAChD,CAAC"}

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

@@ -0,0 +1,11 @@
+/**
+ * Stable selectors for
+ * {@link https://eui.elastic.co/docs/components/forms/range-controls/|EuiRange}
+ * and `EuiDualRange`. `*_SELECTOR` values are CSS.
+ */
+export declare const EuiRangeSelectors: {
+    /** The native `<input type="range">` element that carries the actual value. */
+    SLIDER_SELECTOR: string;
+    /** The visible number input, rendered on a plain `EuiRange` with `showInput`. See the package README for why it can share `data-test-subj` with {@link SLIDER_SELECTOR}. */
+    NUMBER_INPUT_SELECTOR: string;
+};

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

@@ -0,0 +1,19 @@
+/*
+ * 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/range-controls/|EuiRange}
+ * and `EuiDualRange`. `*_SELECTOR` values are CSS.
+ */
+export const EuiRangeSelectors = {
+    /** The native `<input type="range">` element that carries the actual value. */
+    SLIDER_SELECTOR: '.euiRangeSlider',
+    /** The visible number input, rendered on a plain `EuiRange` with `showInput`. See the package README for why it can share `data-test-subj` with {@link SLIDER_SELECTOR}. */
+    NUMBER_INPUT_SELECTOR: '.euiRangeInput',
+};
+//# sourceMappingURL=selectors.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"selectors.js","sourceRoot":"","sources":["../../../../../src/components/form/range/selectors.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;GAIG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,+EAA+E;IAC/E,eAAe,EAAE,iBAAiB;IAElC,4KAA4K;IAC5K,qBAAqB,EAAE,gBAAgB;CACxC,CAAC"}

package/lib/esm/index.d.ts

@@ -4,3 +4,7 @@ export { EuiDataGridObject } from './playwright/components/datagrid/object';
 export { EuiSuperSelectObject } from './playwright/components/form/super_select/object';
 export { EuiGlobalToastListObject } from './playwright/components/toast/object';
 export { EuiSelectableObject } from './playwright/components/selectable/object';
+export { EuiDraggableObject } from './playwright/components/drag_and_drop/object';
+export { EuiFilterButtonObject } from './playwright/components/filter_button/object';
+export { EuiRangeObject } from './playwright/components/form/range/object';
+export { EuiBasicTableObject } from './playwright/components/basic_table/object';

package/lib/esm/index.js

@@ -11,4 +11,8 @@ export { EuiDataGridObject } from './playwright/components/datagrid/object';
 export { EuiSuperSelectObject } from './playwright/components/form/super_select/object';
 export { EuiGlobalToastListObject } from './playwright/components/toast/object';
 export { EuiSelectableObject } from './playwright/components/selectable/object';
+export { EuiDraggableObject } from './playwright/components/drag_and_drop/object';
+export { EuiFilterButtonObject } from './playwright/components/filter_button/object';
+export { EuiRangeObject } from './playwright/components/form/range/object';
+export { EuiBasicTableObject } from './playwright/components/basic_table/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;AAC7E,OAAO,EAAE,iBAAiB,EAAE,MAAM,yCAAyC,CAAC;AAC5E,OAAO,EAAE,oBAAoB,EAAE,MAAM,kDAAkD,CAAC;AACxF,OAAO,EAAE,wBAAwB,EAAE,MAAM,sCAAsC,CAAC;AAChF,OAAO,EAAE,mBAAmB,EAAE,MAAM,2CAA2C,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;AAChF,OAAO,EAAE,mBAAmB,EAAE,MAAM,2CAA2C,CAAC;AAChF,OAAO,EAAE,kBAAkB,EAAE,MAAM,8CAA8C,CAAC;AAClF,OAAO,EAAE,qBAAqB,EAAE,MAAM,8CAA8C,CAAC;AACrF,OAAO,EAAE,cAAc,EAAE,MAAM,2CAA2C,CAAC;AAC3E,OAAO,EAAE,mBAAmB,EAAE,MAAM,4CAA4C,CAAC"}

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

@@ -0,0 +1,50 @@
+import type { Locator } from '@playwright/test';
+import { BaseObject, type ObjectScope } from '../../base_object';
+/**
+ * Playwright Component Object for {@link
+ * https://eui.elastic.co/docs/components/tabular-content/tables/ EuiBasicTable}
+ * (also covers `EuiInMemoryTable`, which renders a `EuiBasicTable` underneath and
+ * passes the `data-test-subj` straight through — there is no separate object for it).
+ *
+ * `testSubj` must match the `data-test-subj` set by the consumer on the
+ * `<EuiBasicTable>`/`<EuiInMemoryTable>` (EUI spreads it onto the `.euiBasicTable`
+ * root). See the package README for what's deliberately excluded from v1.
+ */
+export declare class EuiBasicTableObject extends BaseObject {
+    constructor(scope: ObjectScope, testSubj: string);
+    /**
+     * The table's data rows, as a `Locator` so callers keep Playwright auto-retry
+     * for count and content assertions (e.g. `expect(table.rows).toHaveCount(3)`).
+     *
+     * Excludes EUI's own "no items found" (and error-message) row: when the table
+     * is empty, EUI still renders a single `.euiTableRow` whose one cell spans
+     * every column (`colSpan` on `EuiTableRowCell`, the `td[colspan]` HTML
+     * attribute). Real data rows don't set `colspan` on their cells, so filtering
+     * it out is what keeps `toHaveCount(0)` correct on an empty table instead of
+     * reading `1`.
+     */
+    get rows(): Locator;
+    /**
+     * The cells of the given field-data column, one per row, as a `Locator` for
+     * retrying content/count assertions (e.g.
+     * `expect(await table.cells('status')).toHaveText(['Running'])`).
+     *
+     * Resolves the column's position from EUI's own header cell
+     * (`tableHeaderCell_<field>_<index>`, matched exactly so a column named e.g.
+     * `status` doesn't also match a `status_detail` header) via its native
+     * `cellIndex`, then reads the cell at that position in every row — the same
+     * positional alignment EUI itself relies on, so it holds regardless of a
+     * leading selection-checkbox column. Matches both `<td>` and `<th>`: EUI
+     * renders the `rowHeader` column's body cell as a `<th scope="row">` for
+     * accessibility, not a `<td>`. Throws if no column with that `field` is
+     * rendered.
+     *
+     * EUI generates a computed column's header test-subj from its `name` using
+     * this exact same `tableHeaderCell_<name>_<index>` shape (there's no `field`
+     * to key on), so a computed column whose `name` happens to equal another
+     * column's `field` can resolve ambiguously — this method can't distinguish
+     * the two from the DOM alone. Not expected in practice; call it out if you
+     * hit it.
+     */
+    cells(field: string): Promise<Locator>;
+}

package/lib/esm/playwright/components/basic_table/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 { EuiBasicTableSelectors } from '../../../components/basic_table/selectors';
+/**
+ * Playwright Component Object for {@link
+ * https://eui.elastic.co/docs/components/tabular-content/tables/ EuiBasicTable}
+ * (also covers `EuiInMemoryTable`, which renders a `EuiBasicTable` underneath and
+ * passes the `data-test-subj` straight through — there is no separate object for it).
+ *
+ * `testSubj` must match the `data-test-subj` set by the consumer on the
+ * `<EuiBasicTable>`/`<EuiInMemoryTable>` (EUI spreads it onto the `.euiBasicTable`
+ * root). See the package README for what's deliberately excluded from v1.
+ */
+export class EuiBasicTableObject extends BaseObject {
+    constructor(scope, testSubj) {
+        super(scope, testSubj, EuiBasicTableSelectors.ROOT_SELECTOR);
+    }
+    /**
+     * The table's data rows, as a `Locator` so callers keep Playwright auto-retry
+     * for count and content assertions (e.g. `expect(table.rows).toHaveCount(3)`).
+     *
+     * Excludes EUI's own "no items found" (and error-message) row: when the table
+     * is empty, EUI still renders a single `.euiTableRow` whose one cell spans
+     * every column (`colSpan` on `EuiTableRowCell`, the `td[colspan]` HTML
+     * attribute). Real data rows don't set `colspan` on their cells, so filtering
+     * it out is what keeps `toHaveCount(0)` correct on an empty table instead of
+     * reading `1`.
+     */
+    get rows() {
+        return this.root
+            .locator(EuiBasicTableSelectors.ROW_SELECTOR)
+            .filter({ hasNot: this.root.page().locator('td[colspan]') });
+    }
+    /**
+     * The cells of the given field-data column, one per row, as a `Locator` for
+     * retrying content/count assertions (e.g.
+     * `expect(await table.cells('status')).toHaveText(['Running'])`).
+     *
+     * Resolves the column's position from EUI's own header cell
+     * (`tableHeaderCell_<field>_<index>`, matched exactly so a column named e.g.
+     * `status` doesn't also match a `status_detail` header) via its native
+     * `cellIndex`, then reads the cell at that position in every row — the same
+     * positional alignment EUI itself relies on, so it holds regardless of a
+     * leading selection-checkbox column. Matches both `<td>` and `<th>`: EUI
+     * renders the `rowHeader` column's body cell as a `<th scope="row">` for
+     * accessibility, not a `<td>`. Throws if no column with that `field` is
+     * rendered.
+     *
+     * EUI generates a computed column's header test-subj from its `name` using
+     * this exact same `tableHeaderCell_<name>_<index>` shape (there's no `field`
+     * to key on), so a computed column whose `name` happens to equal another
+     * column's `field` can resolve ambiguously — this method can't distinguish
+     * the two from the DOM alone. Not expected in practice; call it out if you
+     * hit it.
+     */
+    async cells(field) {
+        const escaped = field.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+        const cellIndex = await this.root.evaluate((tableEl, { prefix, pattern, field: originalField }) => {
+            const regex = new RegExp(`^${prefix}${pattern}_\\d+$`);
+            const headers = Array.from(tableEl.querySelectorAll('thead th, thead td'));
+            const header = headers.find((el) => regex.test(el.getAttribute('data-test-subj') ?? ''));
+            if (!header) {
+                throw new Error(`EuiBasicTableObject.cells: no column with field "${originalField}" found in this table's header.`);
+            }
+            return header.cellIndex;
+        }, { prefix: EuiBasicTableSelectors.HEADER_CELL_SELECTOR_PREFIX, pattern: escaped, field });
+        return this.rows.locator(`:is(td, th):nth-child(${cellIndex + 1})`);
+    }
+}
+//# sourceMappingURL=object.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"object.js","sourceRoot":"","sources":["../../../../../src/playwright/components/basic_table/object.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,EAAE,UAAU,EAAoB,MAAM,mBAAmB,CAAC;AACjE,OAAO,EAAE,sBAAsB,EAAE,MAAM,2CAA2C,CAAC;AAEnF;;;;;;;;;GASG;AACH,MAAM,OAAO,mBAAoB,SAAQ,UAAU;IACjD,YAAY,KAAkB,EAAE,QAAgB;QAC9C,KAAK,CAAC,KAAK,EAAE,QAAQ,EAAE,sBAAsB,CAAC,aAAa,CAAC,CAAC;IAC/D,CAAC;IAED;;;;;;;;;;OAUG;IACH,IAAW,IAAI;QACb,OAAO,IAAI,CAAC,IAAI;aACb,OAAO,CAAC,sBAAsB,CAAC,YAAY,CAAC;aAC5C,MAAM,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,aAAa,CAAC,EAAE,CAAC,CAAC;IACjE,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,KAAK,CAAC,KAAK,CAAC,KAAa;QACvB,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAC;QAC7D,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,QAAQ,CACxC,CAAC,OAAO,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,aAAa,EAAE,EAAE,EAAE;YACrD,MAAM,KAAK,GAAG,IAAI,MAAM,CAAC,IAAI,MAAM,GAAG,OAAO,QAAQ,CAAC,CAAC;YACvD,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,gBAAgB,CAAC,oBAAoB,CAAC,CAAC,CAAC;YAC3E,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,CACjC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,YAAY,CAAC,gBAAgB,CAAC,IAAI,EAAE,CAAC,CAChB,CAAC;YACtC,IAAI,CAAC,MAAM,EAAE,CAAC;gBACZ,MAAM,IAAI,KAAK,CACb,oDAAoD,aAAa,iCAAiC,CACnG,CAAC;YACJ,CAAC;YACD,OAAO,MAAM,CAAC,SAAS,CAAC;QAC1B,CAAC,EACD,EAAE,MAAM,EAAE,sBAAsB,CAAC,2BAA2B,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,CACxF,CAAC;QACF,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,yBAAyB,SAAS,GAAG,CAAC,GAAG,CAAC,CAAC;IACtE,CAAC;CACF"}

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

@@ -0,0 +1,21 @@
+import { BaseObject, type ObjectScope } from '../../base_object';
+/**
+ * Playwright Component Object for a keyboard-reorderable {@link
+ * https://eui.elastic.co/docs/components/drag-and-drop/ EuiDraggable} item.
+ *
+ * `testSubj` must be set on the item's own drag handle — with the default
+ * `customDragHandle={false}` that's the `EuiDraggable` item itself; with a
+ * custom handle it's that inner element instead. See the package README for
+ * details, the component-type guard, and why there's no settle-wait after a
+ * reorder.
+ */
+export declare class EuiDraggableObject extends BaseObject {
+    constructor(scope: ObjectScope, testSubj: string);
+    /**
+     * Reorders the item via keyboard: focus the handle, lift it (`Space`),
+     * move it `steps` positions (`ArrowDown` for positive, `ArrowUp` for
+     * negative), drop it (`Space`). Keyboard lift, not a simulated mouse drag —
+     * `@hello-pangea/dnd`'s own accessible interaction.
+     */
+    reorder(steps: number): Promise<void>;
+}

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

@@ -0,0 +1,40 @@
+/*
+ * 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 { EuiDraggableSelectors } from '../../../components/drag_and_drop/selectors';
+/**
+ * Playwright Component Object for a keyboard-reorderable {@link
+ * https://eui.elastic.co/docs/components/drag-and-drop/ EuiDraggable} item.
+ *
+ * `testSubj` must be set on the item's own drag handle — with the default
+ * `customDragHandle={false}` that's the `EuiDraggable` item itself; with a
+ * custom handle it's that inner element instead. See the package README for
+ * details, the component-type guard, and why there's no settle-wait after a
+ * reorder.
+ */
+export class EuiDraggableObject extends BaseObject {
+    constructor(scope, testSubj) {
+        super(scope, testSubj, EuiDraggableSelectors.HANDLE_SELECTOR);
+    }
+    /**
+     * Reorders the item via keyboard: focus the handle, lift it (`Space`),
+     * move it `steps` positions (`ArrowDown` for positive, `ArrowUp` for
+     * negative), drop it (`Space`). Keyboard lift, not a simulated mouse drag —
+     * `@hello-pangea/dnd`'s own accessible interaction.
+     */
+    async reorder(steps) {
+        await this.root.focus();
+        await this.root.press('Space');
+        const key = steps > 0 ? 'ArrowDown' : 'ArrowUp';
+        for (let i = 0; i < Math.abs(steps); i++) {
+            await this.root.press(key);
+        }
+        await this.root.press('Space');
+    }
+}
+//# sourceMappingURL=object.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"object.js","sourceRoot":"","sources":["../../../../../src/playwright/components/drag_and_drop/object.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,UAAU,EAAoB,MAAM,mBAAmB,CAAC;AACjE,OAAO,EAAE,qBAAqB,EAAE,MAAM,6CAA6C,CAAC;AAEpF;;;;;;;;;GASG;AACH,MAAM,OAAO,kBAAmB,SAAQ,UAAU;IAChD,YAAY,KAAkB,EAAE,QAAgB;QAC9C,KAAK,CAAC,KAAK,EAAE,QAAQ,EAAE,qBAAqB,CAAC,eAAe,CAAC,CAAC;IAChE,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,OAAO,CAAC,KAAa;QACzB,MAAM,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;QACxB,MAAM,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAC/B,MAAM,GAAG,GAAG,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC;QAChD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;YACzC,MAAM,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC7B,CAAC;QACD,MAAM,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACjC,CAAC;CACF"}

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

@@ -0,0 +1,31 @@
+import type { Locator } from '@playwright/test';
+import { BaseObject, type ObjectScope } from '../../base_object';
+/**
+ * Playwright Component Object for {@link
+ * https://eui.elastic.co/docs/components/forms/filter-group/ EuiFilterButton}.
+ *
+ * `testSubj` must match the `data-test-subj` set by the consumer on the
+ * `<EuiFilterButton>` (EUI spreads it onto the button itself). Deliberately
+ * does not own opening/closing a popover triggered by the button — `EuiPopover`
+ * already sets `aria-expanded`/`aria-controls` on its toggle synchronously
+ * itself, so drive that from the test directly. It also does not own reading
+ * or selecting options inside that popover — when the popover content is an
+ * `EuiSelectable`, use {@link EuiSelectableObject} scoped to it instead.
+ */
+export declare class EuiFilterButtonObject extends BaseObject {
+    constructor(scope: ObjectScope, testSubj: string);
+    /**
+     * The notification badge showing the available/active filter count, as a
+     * `Locator` so callers keep Playwright auto-retry for its text
+     * (e.g. `expect(filterButton.notificationBadge).toHaveText('2')`). Only
+     * present when the consumer passes `numFilters` or `numActiveFilters` —
+     * absent otherwise, so assert presence first if that is in question.
+     *
+     * For the button's own active/selected state, assert directly on
+     * {@link BaseObject.locator} rather than through a dedicated method — both
+     * are synchronous CSS classes EUI sets on the root
+     * (`euiFilterButton-hasActiveFilters`, `euiFilterButton-isSelected`), e.g.
+     * `expect(filterButton.locator).toHaveClass(/euiFilterButton-hasActiveFilters/)`.
+     */
+    get notificationBadge(): Locator;
+}

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

@@ -0,0 +1,43 @@
+/*
+ * 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 { EuiFilterButtonSelectors } from '../../../components/filter_button/selectors';
+/**
+ * Playwright Component Object for {@link
+ * https://eui.elastic.co/docs/components/forms/filter-group/ EuiFilterButton}.
+ *
+ * `testSubj` must match the `data-test-subj` set by the consumer on the
+ * `<EuiFilterButton>` (EUI spreads it onto the button itself). Deliberately
+ * does not own opening/closing a popover triggered by the button — `EuiPopover`
+ * already sets `aria-expanded`/`aria-controls` on its toggle synchronously
+ * itself, so drive that from the test directly. It also does not own reading
+ * or selecting options inside that popover — when the popover content is an
+ * `EuiSelectable`, use {@link EuiSelectableObject} scoped to it instead.
+ */
+export class EuiFilterButtonObject extends BaseObject {
+    constructor(scope, testSubj) {
+        super(scope, testSubj, EuiFilterButtonSelectors.ROOT_SELECTOR);
+    }
+    /**
+     * The notification badge showing the available/active filter count, as a
+     * `Locator` so callers keep Playwright auto-retry for its text
+     * (e.g. `expect(filterButton.notificationBadge).toHaveText('2')`). Only
+     * present when the consumer passes `numFilters` or `numActiveFilters` —
+     * absent otherwise, so assert presence first if that is in question.
+     *
+     * For the button's own active/selected state, assert directly on
+     * {@link BaseObject.locator} rather than through a dedicated method — both
+     * are synchronous CSS classes EUI sets on the root
+     * (`euiFilterButton-hasActiveFilters`, `euiFilterButton-isSelected`), e.g.
+     * `expect(filterButton.locator).toHaveClass(/euiFilterButton-hasActiveFilters/)`.
+     */
+    get notificationBadge() {
+        return this.root.locator(EuiFilterButtonSelectors.NOTIFICATION_SELECTOR);
+    }
+}
+//# sourceMappingURL=object.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"object.js","sourceRoot":"","sources":["../../../../../src/playwright/components/filter_button/object.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,EAAE,UAAU,EAAoB,MAAM,mBAAmB,CAAC;AACjE,OAAO,EAAE,wBAAwB,EAAE,MAAM,6CAA6C,CAAC;AAEvF;;;;;;;;;;;GAWG;AACH,MAAM,OAAO,qBAAsB,SAAQ,UAAU;IACnD,YAAY,KAAkB,EAAE,QAAgB;QAC9C,KAAK,CAAC,KAAK,EAAE,QAAQ,EAAE,wBAAwB,CAAC,aAAa,CAAC,CAAC;IACjE,CAAC;IAED;;;;;;;;;;;;OAYG;IACH,IAAW,iBAAiB;QAC1B,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,wBAAwB,CAAC,qBAAqB,CAAC,CAAC;IAC3E,CAAC;CACF"}

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

@@ -0,0 +1,25 @@
+import type { Locator } from '@playwright/test';
+import { BaseObject, type ObjectScope } from '../../../base_object';
+/**
+ * Playwright Component Object for {@link
+ * https://eui.elastic.co/docs/components/forms/range-controls/ EuiRange} and
+ * `EuiDualRange`.
+ *
+ * `testSubj` must match the `data-test-subj` set by the consumer on the
+ * `<EuiRange>`/`<EuiDualRange>`. See the package README for why `slider` and
+ * `numberInput` disambiguate by class, and what this does not cover.
+ */
+export declare class EuiRangeObject extends BaseObject {
+    constructor(scope: ObjectScope, testSubj: string);
+    /**
+     * The native range slider input. Resolves to exactly one element once
+     * mounted. With `showInput="inputWithPopover"`, it lives inside the
+     * popover panel and is not mounted until the popover opens.
+     */
+    get slider(): Locator;
+    /**
+     * The visible number input, present only with `showInput`. Resolves to
+     * zero elements otherwise.
+     */
+    get numberInput(): Locator;
+}

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

@@ -0,0 +1,39 @@
+/*
+ * 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 { EuiRangeSelectors } from '../../../../components/form/range/selectors';
+/**
+ * Playwright Component Object for {@link
+ * https://eui.elastic.co/docs/components/forms/range-controls/ EuiRange} and
+ * `EuiDualRange`.
+ *
+ * `testSubj` must match the `data-test-subj` set by the consumer on the
+ * `<EuiRange>`/`<EuiDualRange>`. See the package README for why `slider` and
+ * `numberInput` disambiguate by class, and what this does not cover.
+ */
+export class EuiRangeObject extends BaseObject {
+    constructor(scope, testSubj) {
+        super(scope, testSubj, EuiRangeSelectors.SLIDER_SELECTOR);
+    }
+    /**
+     * The native range slider input. Resolves to exactly one element once
+     * mounted. With `showInput="inputWithPopover"`, it lives inside the
+     * popover panel and is not mounted until the popover opens.
+     */
+    get slider() {
+        return this.root.and(this.scope.locator(EuiRangeSelectors.SLIDER_SELECTOR));
+    }
+    /**
+     * The visible number input, present only with `showInput`. Resolves to
+     * zero elements otherwise.
+     */
+    get numberInput() {
+        return this.root.and(this.scope.locator(EuiRangeSelectors.NUMBER_INPUT_SELECTOR));
+    }
+}
+//# sourceMappingURL=object.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"object.js","sourceRoot":"","sources":["../../../../../../src/playwright/components/form/range/object.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,EAAE,UAAU,EAAoB,MAAM,sBAAsB,CAAC;AACpE,OAAO,EAAE,iBAAiB,EAAE,MAAM,6CAA6C,CAAC;AAEhF;;;;;;;;GAQG;AACH,MAAM,OAAO,cAAe,SAAQ,UAAU;IAC5C,YAAY,KAAkB,EAAE,QAAgB;QAC9C,KAAK,CAAC,KAAK,EAAE,QAAQ,EAAE,iBAAiB,CAAC,eAAe,CAAC,CAAC;IAC5D,CAAC;IAED;;;;OAIG;IACH,IAAW,MAAM;QACf,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,iBAAiB,CAAC,eAAe,CAAC,CAAC,CAAC;IAC9E,CAAC;IAED;;;OAGG;IACH,IAAW,WAAW;QACpB,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,iBAAiB,CAAC,qBAAqB,CAAC,CAAC,CAAC;IACpF,CAAC;CACF"}

package/package.json

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

package/src/components/basic_table/README.md

@@ -0,0 +1,30 @@
+# EuiBasicTableObject
+
+Playwright Component Object for [EuiBasicTable](https://eui.elastic.co/docs/components/tabular-content/tables/). Also covers `EuiInMemoryTable`, which renders a `EuiBasicTable` underneath and passes the `data-test-subj` straight through — there is no separate object for it.
+
+## Usage
+
+```ts
+import { EuiBasicTableObject } from '@elastic/eui-test-helpers';
+
+const table = new EuiBasicTableObject(page, 'myTable');
+expect(await table.rows).toHaveCount(3);
+expect(await table.cells('status')).toHaveText(['Running', 'Finished', 'Archived']);
+```
+
+Set `data-test-subj` on the `<EuiBasicTable>`/`<EuiInMemoryTable>` (EUI spreads it onto the `.euiBasicTable` root, which the component-type guard verifies).
+
+## API
+
+| Member | Description |
+|---|---|
+| `rows` | `Locator` for the table's data rows, excluding EUI's own "no items found"/error-message row. |
+| `cells(field)` | `Locator` for a field-data column's cells across all rows, resolved from EUI's own header `data-test-subj`. |
+
+`rows` excludes EUI's empty/error message row by filtering out any row whose cell carries a `colspan` — real data rows don't set one, EUI's own placeholder row always does (it spans every column).
+
+`cells(field)` resolves the column's position from the header cell EUI renders as `tableHeaderCell_<field>_<index>` (matched exactly, so a column named `status` won't also match a `status_detail` header), then reads the cell at that position in every row. This holds regardless of a leading selection-checkbox column, since the checkbox column is a real cell in both the header and body rows, and it matches both `<td>` and `<th>` since EUI renders a `rowHeader` column's body cell as `<th scope="row">`. Throws if no column with that `field` is rendered.
+
+## Deliberately excluded
+
+Row actions (consumer-supplied popovers/buttons), sorting, and pagination are not covered. They are either app-specific wiring rather than EUI-internal DOM knowledge, or had no evidenced consumer need at the time this was written. Open an issue with a concrete use case if you need one of them.

package/src/components/drag_and_drop/README.md

@@ -0,0 +1,23 @@
+# EuiDraggableObject
+
+Playwright Component Object for [EuiDraggable](https://eui.elastic.co/docs/components/drag-and-drop/), keyboard-reordering items instead of simulating a mouse drag.
+
+## Usage
+
+```ts
+import { EuiDraggableObject } from '@elastic/eui-test-helpers';
+
+const item = new EuiDraggableObject(page, 'myItemDragHandle');
+await item.reorder(2); // move 2 positions later
+await item.reorder(-1); // move 1 position earlier
+```
+
+Set `data-test-subj` on the item's own drag handle — the element EUI's `provided.dragHandleProps` are spread onto. With the default `customDragHandle={false}`, that's the `<EuiDraggable>` item itself (as in the usage example above and the `Playground` story), since EUI spreads `dragHandleProps` onto the same element as `draggableProps` in that case. Only with a `customDragHandle` does the handle become a distinct inner element, and `data-test-subj` must move there instead. The component-type guard checks for the `data-rfd-drag-handle-draggable-id` attribute `@hello-pangea/dnd` spreads onto an *enabled* handle, since the handle markup itself is consumer-defined, not a fixed EUI class. A disabled draggable's handle lacks that attribute, so pointing this object at one throws the same "wrong component" error as pointing it at a non-handle element — a disabled item can't be reordered either way.
+
+## API
+
+| Member | Description |
+|---|---|
+| `reorder(steps)` | Focuses the handle, lifts it, moves it `steps` positions (`ArrowDown` for positive, `ArrowUp` for negative), drops it. |
+
+`reorder` drives `EuiDraggable` (which wraps `@hello-pangea/dnd`) via its keyboard interaction — the library's own accessible alternative to a mouse drag, and one that doesn't require simulating drag events. It does not wait for a settle signal after dropping: EUI doesn't expose a synchronous, stable one (the `euiDraggable--isDragging` class some consumers checked for hasn't existed since this styling moved to Emotion — that check was always a no-op). Assert the resulting order with a retrying `expect`, which settles on its own.