@elastic/eui-test-helpers 1.4.0 → 1.5.0

package/README.md

@@ -51,6 +51,10 @@ their own version at runtime.
 | `EuiSuperSelectObject` | [src/components/form/super_select/README.md](src/components/form/super_select/README.md) |
 | `EuiGlobalToastListObject` | [src/components/toast/README.md](src/components/toast/README.md) |
 | `EuiSelectableObject` | [src/components/selectable/README.md](src/components/selectable/README.md) |
+| `EuiDraggableObject` | [src/components/drag_and_drop/README.md](src/components/drag_and_drop/README.md) |
+| `EuiFilterButtonObject` | [src/components/filter_button/README.md](src/components/filter_button/README.md) |
+| `EuiRangeObject` | [src/components/form/range/README.md](src/components/form/range/README.md) |
+| `EuiBasicTableObject` | [src/components/basic_table/README.md](src/components/basic_table/README.md) |
 
 ## Contributing
 

package/lib/cjs/components/basic_table/selectors.d.ts

@@ -0,0 +1,17 @@
+/**
+ * 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 declare const EuiBasicTableSelectors: {
+    /** Root element (the `.euiBasicTable` container carrying the consumer's `data-test-subj`). */
+    ROOT_SELECTOR: string;
+    /** A data row. Also matches EUI's own empty/error message row — callers must exclude those. */
+    ROW_SELECTOR: string;
+    /**
+     * 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: string;
+};

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

@@ -0,0 +1,31 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.EuiBasicTableSelectors = void 0;
+/*
+ * 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.
+ */
+const EuiBasicTableSelectors = exports.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_'
+};

package/lib/cjs/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/cjs/components/drag_and_drop/selectors.js

@@ -0,0 +1,29 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.EuiDraggableSelectors = void 0;
+/*
+ * 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.
+ */
+const EuiDraggableSelectors = exports.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]'
+};

package/lib/cjs/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/cjs/components/filter_button/selectors.js

@@ -0,0 +1,30 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.EuiFilterButtonSelectors = void 0;
+/*
+ * 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`).
+ */
+const EuiFilterButtonSelectors = exports.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'
+};

package/lib/cjs/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/cjs/components/form/range/selectors.js

@@ -0,0 +1,25 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.EuiRangeSelectors = void 0;
+/*
+ * 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.
+ */
+const EuiRangeSelectors = exports.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'
+};

package/lib/cjs/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/cjs/index.js

@@ -9,6 +9,12 @@ Object.defineProperty(exports, "BaseObject", {
     return _base_object.BaseObject;
   }
 });
+Object.defineProperty(exports, "EuiBasicTableObject", {
+  enumerable: true,
+  get: function () {
+    return _object9.EuiBasicTableObject;
+  }
+});
 Object.defineProperty(exports, "EuiComboBoxObject", {
   enumerable: true,
   get: function () {
@@ -21,12 +27,30 @@ Object.defineProperty(exports, "EuiDataGridObject", {
     return _object2.EuiDataGridObject;
   }
 });
+Object.defineProperty(exports, "EuiDraggableObject", {
+  enumerable: true,
+  get: function () {
+    return _object6.EuiDraggableObject;
+  }
+});
+Object.defineProperty(exports, "EuiFilterButtonObject", {
+  enumerable: true,
+  get: function () {
+    return _object7.EuiFilterButtonObject;
+  }
+});
 Object.defineProperty(exports, "EuiGlobalToastListObject", {
   enumerable: true,
   get: function () {
     return _object4.EuiGlobalToastListObject;
   }
 });
+Object.defineProperty(exports, "EuiRangeObject", {
+  enumerable: true,
+  get: function () {
+    return _object8.EuiRangeObject;
+  }
+});
 Object.defineProperty(exports, "EuiSelectableObject", {
   enumerable: true,
   get: function () {
@@ -44,4 +68,8 @@ var _object = require("./playwright/components/combo_box/object");
 var _object2 = require("./playwright/components/datagrid/object");
 var _object3 = require("./playwright/components/form/super_select/object");
 var _object4 = require("./playwright/components/toast/object");
-var _object5 = require("./playwright/components/selectable/object");
+var _object5 = require("./playwright/components/selectable/object");
+var _object6 = require("./playwright/components/drag_and_drop/object");
+var _object7 = require("./playwright/components/filter_button/object");
+var _object8 = require("./playwright/components/form/range/object");
+var _object9 = require("./playwright/components/basic_table/object");

package/lib/cjs/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/cjs/playwright/components/basic_table/object.js

@@ -0,0 +1,93 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.EuiBasicTableObject = void 0;
+var _base_object = require("../../base_object");
+var _selectors = require("../../../components/basic_table/selectors");
+/*
+ * 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.
+ */
+
+/**
+ * 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.
+ */
+class EuiBasicTableObject extends _base_object.BaseObject {
+  constructor(scope, testSubj) {
+    super(scope, testSubj, _selectors.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(_selectors.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: _selectors.EuiBasicTableSelectors.HEADER_CELL_SELECTOR_PREFIX,
+      pattern: escaped,
+      field
+    });
+    return this.rows.locator(`:is(td, th):nth-child(${cellIndex + 1})`);
+  }
+}
+exports.EuiBasicTableObject = EuiBasicTableObject;

package/lib/cjs/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/cjs/playwright/components/drag_and_drop/object.js

@@ -0,0 +1,48 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.EuiDraggableObject = void 0;
+var _base_object = require("../../base_object");
+var _selectors = require("../../../components/drag_and_drop/selectors");
+/*
+ * 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.
+ */
+
+/**
+ * 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.
+ */
+class EuiDraggableObject extends _base_object.BaseObject {
+  constructor(scope, testSubj) {
+    super(scope, testSubj, _selectors.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');
+  }
+}
+exports.EuiDraggableObject = EuiDraggableObject;

package/lib/cjs/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/cjs/playwright/components/filter_button/object.js

@@ -0,0 +1,51 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.EuiFilterButtonObject = void 0;
+var _base_object = require("../../base_object");
+var _selectors = require("../../../components/filter_button/selectors");
+/*
+ * 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.
+ */
+
+/**
+ * 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.
+ */
+class EuiFilterButtonObject extends _base_object.BaseObject {
+  constructor(scope, testSubj) {
+    super(scope, testSubj, _selectors.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(_selectors.EuiFilterButtonSelectors.NOTIFICATION_SELECTOR);
+  }
+}
+exports.EuiFilterButtonObject = EuiFilterButtonObject;

package/lib/cjs/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/cjs/playwright/components/form/range/object.js

@@ -0,0 +1,48 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.EuiRangeObject = void 0;
+var _base_object = require("../../../base_object");
+var _selectors = require("../../../../components/form/range/selectors");
+/*
+ * 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.
+ */
+
+/**
+ * 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.
+ */
+class EuiRangeObject extends _base_object.BaseObject {
+  constructor(scope, testSubj) {
+    super(scope, testSubj, _selectors.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(_selectors.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(_selectors.EuiRangeSelectors.NUMBER_INPUT_SELECTOR));
+  }
+}
+exports.EuiRangeObject = EuiRangeObject;

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

@@ -0,0 +1,17 @@
+/**
+ * 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 declare const EuiBasicTableSelectors: {
+    /** Root element (the `.euiBasicTable` container carrying the consumer's `data-test-subj`). */
+    ROOT_SELECTOR: string;
+    /** A data row. Also matches EUI's own empty/error message row — callers must exclude those. */
+    ROW_SELECTOR: string;
+    /**
+     * 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: string;
+};