@elastic/eui-test-helpers 1.3.0 → 1.4.0-snapshot.1787665877015

package/README.md

@@ -50,6 +50,8 @@ their own version at runtime.
 | `EuiDataGridObject` | [src/components/datagrid/README.md](src/components/datagrid/README.md) |
 | `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) |
+| `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/selectable/selectors.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Stable selectors for
+ * {@link https://eui.elastic.co/docs/components/forms/selection/selectable/|EuiSelectable}.
+ * `*_SELECTOR` values are CSS.
+ */
+export declare const EuiSelectableSelectors: {
+    /** Root element (the `.euiSelectable` container carrying the consumer's `data-test-subj`). */
+    ROOT_SELECTOR: string;
+    /** The search box, present only when the selectable is `searchable`. */
+    SEARCH_SELECTOR: string;
+};

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

@@ -0,0 +1,25 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.EuiSelectableSelectors = 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/selection/selectable/|EuiSelectable}.
+ * `*_SELECTOR` values are CSS.
+ */
+const EuiSelectableSelectors = exports.EuiSelectableSelectors = {
+  /** Root element (the `.euiSelectable` container carrying the consumer's `data-test-subj`). */
+  ROOT_SELECTOR: '.euiSelectable',
+  /** The search box, present only when the selectable is `searchable`. */
+  SEARCH_SELECTOR: '.euiSelectableSearch'
+};

package/lib/cjs/index.d.ts

@@ -3,3 +3,5 @@ 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';
+export { EuiSelectableObject } from './playwright/components/selectable/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 _object6.EuiBasicTableObject;
+  }
+});
 Object.defineProperty(exports, "EuiComboBoxObject", {
   enumerable: true,
   get: function () {
@@ -27,6 +33,12 @@ Object.defineProperty(exports, "EuiGlobalToastListObject", {
     return _object4.EuiGlobalToastListObject;
   }
 });
+Object.defineProperty(exports, "EuiSelectableObject", {
+  enumerable: true,
+  get: function () {
+    return _object5.EuiSelectableObject;
+  }
+});
 Object.defineProperty(exports, "EuiSuperSelectObject", {
   enumerable: true,
   get: function () {
@@ -37,4 +49,6 @@ var _base_object = require("./playwright/base_object");
 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 _object4 = require("./playwright/components/toast/object");
+var _object5 = require("./playwright/components/selectable/object");
+var _object6 = 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/selectable/object.d.ts

@@ -0,0 +1,53 @@
+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/selection/selectable/ EuiSelectable}.
+ *
+ * `testSubj` must match the `data-test-subj` set by the consumer on the
+ * `<EuiSelectable>` (EUI spreads it onto the `.euiSelectable` root). When the
+ * selectable renders inside a popover the consumer opens, pass that popover as
+ * `scope` and drive the open/close from the test — the popover is not this
+ * component's concern.
+ */
+export declare class EuiSelectableObject extends BaseObject {
+    constructor(scope: ObjectScope, testSubj: string);
+    /**
+     * The options currently mounted in the list, as a `Locator` so callers keep
+     * Playwright auto-retry for count and content assertions
+     * (e.g. `expect(options).toHaveCount(3)`). The list is virtualized, so this is
+     * the rendered window — `search()` first to filter the target into view
+     * rather than scanning a long list.
+     */
+    get options(): Locator;
+    /**
+     * Selects the option with the given label. A no-op if it is already selected.
+     * EUI reports that as `aria-checked` for a multi-selection list, or
+     * `aria-selected` for a single-selection one, so both are checked.
+     *
+     * Matches on the option's label element (`.euiSelectableListItem__text`), not
+     * its accessible name. `append`/`prepend` badges render in a sibling element,
+     * so they are excluded. EUI appends screen-reader state text inside the label
+     * element (a checked option reads `"<label> . Checked option."`), which always
+     * starts with a `.`, so the match allows an optional `.`-prefixed suffix. That
+     * boundary is what keeps `selectOption('New York')` from also matching
+     * `New York City`: a real longer label continues with a word, not a `.`.
+     *
+     * This is for lists in their default state. Once you call `search()`, EUI
+     * wraps the matched text in `<mark>` and injects highlight markers, so a label
+     * match no longer resolves. On a searched list, select via the option's own
+     * `data-test-subj`, or drive it through {@link options} directly.
+     *
+     * Only matches the plain label. A consumer using a custom `renderOption` to
+     * add its own content (e.g. a description) inside the option renders that
+     * content in the same label element, which breaks the anchored match. Select
+     * those options via {@link options} instead (e.g.
+     * `options.filter({ hasText: label })`).
+     */
+    selectOption(label: string): Promise<void>;
+    /**
+     * Type into the selectable's search box to filter the options. Throws if the
+     * selectable is not searchable (no search box rendered).
+     */
+    search(term: string): Promise<void>;
+}

package/lib/cjs/playwright/components/selectable/object.js

@@ -0,0 +1,92 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.EuiSelectableObject = void 0;
+var _base_object = require("../../base_object");
+var _selectors = require("../../../components/selectable/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/selection/selectable/ EuiSelectable}.
+ *
+ * `testSubj` must match the `data-test-subj` set by the consumer on the
+ * `<EuiSelectable>` (EUI spreads it onto the `.euiSelectable` root). When the
+ * selectable renders inside a popover the consumer opens, pass that popover as
+ * `scope` and drive the open/close from the test — the popover is not this
+ * component's concern.
+ */
+class EuiSelectableObject extends _base_object.BaseObject {
+  constructor(scope, testSubj) {
+    super(scope, testSubj, _selectors.EuiSelectableSelectors.ROOT_SELECTOR);
+  }
+
+  /**
+   * The options currently mounted in the list, as a `Locator` so callers keep
+   * Playwright auto-retry for count and content assertions
+   * (e.g. `expect(options).toHaveCount(3)`). The list is virtualized, so this is
+   * the rendered window — `search()` first to filter the target into view
+   * rather than scanning a long list.
+   */
+  get options() {
+    return this.root.getByRole('option');
+  }
+
+  /**
+   * Selects the option with the given label. A no-op if it is already selected.
+   * EUI reports that as `aria-checked` for a multi-selection list, or
+   * `aria-selected` for a single-selection one, so both are checked.
+   *
+   * Matches on the option's label element (`.euiSelectableListItem__text`), not
+   * its accessible name. `append`/`prepend` badges render in a sibling element,
+   * so they are excluded. EUI appends screen-reader state text inside the label
+   * element (a checked option reads `"<label> . Checked option."`), which always
+   * starts with a `.`, so the match allows an optional `.`-prefixed suffix. That
+   * boundary is what keeps `selectOption('New York')` from also matching
+   * `New York City`: a real longer label continues with a word, not a `.`.
+   *
+   * This is for lists in their default state. Once you call `search()`, EUI
+   * wraps the matched text in `<mark>` and injects highlight markers, so a label
+   * match no longer resolves. On a searched list, select via the option's own
+   * `data-test-subj`, or drive it through {@link options} directly.
+   *
+   * Only matches the plain label. A consumer using a custom `renderOption` to
+   * add its own content (e.g. a description) inside the option renders that
+   * content in the same label element, which breaks the anchored match. Select
+   * those options via {@link options} instead (e.g.
+   * `options.filter({ hasText: label })`).
+   */
+  async selectOption(label) {
+    const escaped = label.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+    const labelText = new RegExp(`^${escaped}(\\s*\\..*)?$`);
+    const option = this.root.getByRole('option').filter({
+      has: this.root.page().locator('.euiSelectableListItem__text', {
+        hasText: labelText
+      })
+    });
+    const [ariaChecked, ariaSelected] = await Promise.all([option.getAttribute('aria-checked'), option.getAttribute('aria-selected')]);
+    if (ariaChecked === 'true' || ariaSelected === 'true') {
+      return;
+    }
+    await option.click();
+  }
+
+  /**
+   * Type into the selectable's search box to filter the options. Throws if the
+   * selectable is not searchable (no search box rendered).
+   */
+  async search(term) {
+    // `fill()` auto-waits for the search box; if the selectable is not
+    // searchable it surfaces a clear locator-timeout on its own.
+    await this.root.locator(_selectors.EuiSelectableSelectors.SEARCH_SELECTOR).fill(term);
+  }
+}
+exports.EuiSelectableObject = EuiSelectableObject;

package/lib/cjs/selectors.d.ts

@@ -2,3 +2,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';
+export { EuiSelectableSelectors } from './components/selectable/selectors';

package/lib/cjs/selectors.js

@@ -21,6 +21,12 @@ Object.defineProperty(exports, "EuiGlobalToastListSelectors", {
     return _selectors4.EuiGlobalToastListSelectors;
   }
 });
+Object.defineProperty(exports, "EuiSelectableSelectors", {
+  enumerable: true,
+  get: function () {
+    return _selectors5.EuiSelectableSelectors;
+  }
+});
 Object.defineProperty(exports, "EuiSuperSelectSelectors", {
   enumerable: true,
   get: function () {
@@ -30,4 +36,5 @@ Object.defineProperty(exports, "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");
+var _selectors4 = require("./components/toast/selectors");
+var _selectors5 = require("./components/selectable/selectors");

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

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/selectable/selectors.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Stable selectors for
+ * {@link https://eui.elastic.co/docs/components/forms/selection/selectable/|EuiSelectable}.
+ * `*_SELECTOR` values are CSS.
+ */
+export declare const EuiSelectableSelectors: {
+    /** Root element (the `.euiSelectable` container carrying the consumer's `data-test-subj`). */
+    ROOT_SELECTOR: string;
+    /** The search box, present only when the selectable is `searchable`. */
+    SEARCH_SELECTOR: string;
+};

package/lib/esm/components/selectable/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/selection/selectable/|EuiSelectable}.
+ * `*_SELECTOR` values are CSS.
+ */
+export const EuiSelectableSelectors = {
+    /** Root element (the `.euiSelectable` container carrying the consumer's `data-test-subj`). */
+    ROOT_SELECTOR: '.euiSelectable',
+    /** The search box, present only when the selectable is `searchable`. */
+    SEARCH_SELECTOR: '.euiSelectableSearch',
+};
+//# sourceMappingURL=selectors.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"selectors.js","sourceRoot":"","sources":["../../../../src/components/selectable/selectors.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;GAIG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC,8FAA8F;IAC9F,aAAa,EAAE,gBAAgB;IAE/B,wEAAwE;IACxE,eAAe,EAAE,sBAAsB;CACxC,CAAC"}

package/lib/esm/index.d.ts

@@ -3,3 +3,5 @@ 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';
+export { EuiSelectableObject } from './playwright/components/selectable/object';
+export { EuiBasicTableObject } from './playwright/components/basic_table/object';

package/lib/esm/index.js

@@ -10,4 +10,6 @@ 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';
+export { EuiSelectableObject } from './playwright/components/selectable/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"}
+{"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,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/selectable/object.d.ts

@@ -0,0 +1,53 @@
+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/selection/selectable/ EuiSelectable}.
+ *
+ * `testSubj` must match the `data-test-subj` set by the consumer on the
+ * `<EuiSelectable>` (EUI spreads it onto the `.euiSelectable` root). When the
+ * selectable renders inside a popover the consumer opens, pass that popover as
+ * `scope` and drive the open/close from the test — the popover is not this
+ * component's concern.
+ */
+export declare class EuiSelectableObject extends BaseObject {
+    constructor(scope: ObjectScope, testSubj: string);
+    /**
+     * The options currently mounted in the list, as a `Locator` so callers keep
+     * Playwright auto-retry for count and content assertions
+     * (e.g. `expect(options).toHaveCount(3)`). The list is virtualized, so this is
+     * the rendered window — `search()` first to filter the target into view
+     * rather than scanning a long list.
+     */
+    get options(): Locator;
+    /**
+     * Selects the option with the given label. A no-op if it is already selected.
+     * EUI reports that as `aria-checked` for a multi-selection list, or
+     * `aria-selected` for a single-selection one, so both are checked.
+     *
+     * Matches on the option's label element (`.euiSelectableListItem__text`), not
+     * its accessible name. `append`/`prepend` badges render in a sibling element,
+     * so they are excluded. EUI appends screen-reader state text inside the label
+     * element (a checked option reads `"<label> . Checked option."`), which always
+     * starts with a `.`, so the match allows an optional `.`-prefixed suffix. That
+     * boundary is what keeps `selectOption('New York')` from also matching
+     * `New York City`: a real longer label continues with a word, not a `.`.
+     *
+     * This is for lists in their default state. Once you call `search()`, EUI
+     * wraps the matched text in `<mark>` and injects highlight markers, so a label
+     * match no longer resolves. On a searched list, select via the option's own
+     * `data-test-subj`, or drive it through {@link options} directly.
+     *
+     * Only matches the plain label. A consumer using a custom `renderOption` to
+     * add its own content (e.g. a description) inside the option renders that
+     * content in the same label element, which breaks the anchored match. Select
+     * those options via {@link options} instead (e.g.
+     * `options.filter({ hasText: label })`).
+     */
+    selectOption(label: string): Promise<void>;
+    /**
+     * Type into the selectable's search box to filter the options. Throws if the
+     * selectable is not searchable (no search box rendered).
+     */
+    search(term: string): Promise<void>;
+}

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

@@ -0,0 +1,83 @@
+/*
+ * 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 { EuiSelectableSelectors } from '../../../components/selectable/selectors';
+/**
+ * Playwright Component Object for {@link
+ * https://eui.elastic.co/docs/components/forms/selection/selectable/ EuiSelectable}.
+ *
+ * `testSubj` must match the `data-test-subj` set by the consumer on the
+ * `<EuiSelectable>` (EUI spreads it onto the `.euiSelectable` root). When the
+ * selectable renders inside a popover the consumer opens, pass that popover as
+ * `scope` and drive the open/close from the test — the popover is not this
+ * component's concern.
+ */
+export class EuiSelectableObject extends BaseObject {
+    constructor(scope, testSubj) {
+        super(scope, testSubj, EuiSelectableSelectors.ROOT_SELECTOR);
+    }
+    /**
+     * The options currently mounted in the list, as a `Locator` so callers keep
+     * Playwright auto-retry for count and content assertions
+     * (e.g. `expect(options).toHaveCount(3)`). The list is virtualized, so this is
+     * the rendered window — `search()` first to filter the target into view
+     * rather than scanning a long list.
+     */
+    get options() {
+        return this.root.getByRole('option');
+    }
+    /**
+     * Selects the option with the given label. A no-op if it is already selected.
+     * EUI reports that as `aria-checked` for a multi-selection list, or
+     * `aria-selected` for a single-selection one, so both are checked.
+     *
+     * Matches on the option's label element (`.euiSelectableListItem__text`), not
+     * its accessible name. `append`/`prepend` badges render in a sibling element,
+     * so they are excluded. EUI appends screen-reader state text inside the label
+     * element (a checked option reads `"<label> . Checked option."`), which always
+     * starts with a `.`, so the match allows an optional `.`-prefixed suffix. That
+     * boundary is what keeps `selectOption('New York')` from also matching
+     * `New York City`: a real longer label continues with a word, not a `.`.
+     *
+     * This is for lists in their default state. Once you call `search()`, EUI
+     * wraps the matched text in `<mark>` and injects highlight markers, so a label
+     * match no longer resolves. On a searched list, select via the option's own
+     * `data-test-subj`, or drive it through {@link options} directly.
+     *
+     * Only matches the plain label. A consumer using a custom `renderOption` to
+     * add its own content (e.g. a description) inside the option renders that
+     * content in the same label element, which breaks the anchored match. Select
+     * those options via {@link options} instead (e.g.
+     * `options.filter({ hasText: label })`).
+     */
+    async selectOption(label) {
+        const escaped = label.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+        const labelText = new RegExp(`^${escaped}(\\s*\\..*)?$`);
+        const option = this.root
+            .getByRole('option')
+            .filter({ has: this.root.page().locator('.euiSelectableListItem__text', { hasText: labelText }) });
+        const [ariaChecked, ariaSelected] = await Promise.all([
+            option.getAttribute('aria-checked'),
+            option.getAttribute('aria-selected'),
+        ]);
+        if (ariaChecked === 'true' || ariaSelected === 'true') {
+            return;
+        }
+        await option.click();
+    }
+    /**
+     * Type into the selectable's search box to filter the options. Throws if the
+     * selectable is not searchable (no search box rendered).
+     */
+    async search(term) {
+        // `fill()` auto-waits for the search box; if the selectable is not
+        // searchable it surfaces a clear locator-timeout on its own.
+        await this.root.locator(EuiSelectableSelectors.SEARCH_SELECTOR).fill(term);
+    }
+}
+//# sourceMappingURL=object.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"object.js","sourceRoot":"","sources":["../../../../../src/playwright/components/selectable/object.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,EAAE,UAAU,EAAoB,MAAM,mBAAmB,CAAC;AACjE,OAAO,EAAE,sBAAsB,EAAE,MAAM,0CAA0C,CAAC;AAElF;;;;;;;;;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;;;;;;OAMG;IACH,IAAW,OAAO;QAChB,OAAO,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;IACvC,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACH,KAAK,CAAC,YAAY,CAAC,KAAa;QAC9B,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAC;QAC7D,MAAM,SAAS,GAAG,IAAI,MAAM,CAAC,IAAI,OAAO,eAAe,CAAC,CAAC;QACzD,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI;aACrB,SAAS,CAAC,QAAQ,CAAC;aACnB,MAAM,CAAC,EAAE,GAAG,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,8BAA8B,EAAE,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC,CAAC;QACrG,MAAM,CAAC,WAAW,EAAE,YAAY,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;YACpD,MAAM,CAAC,YAAY,CAAC,cAAc,CAAC;YACnC,MAAM,CAAC,YAAY,CAAC,eAAe,CAAC;SACrC,CAAC,CAAC;QACH,IAAI,WAAW,KAAK,MAAM,IAAI,YAAY,KAAK,MAAM,EAAE,CAAC;YACtD,OAAO;QACT,CAAC;QACD,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;IACvB,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,MAAM,CAAC,IAAY;QACvB,mEAAmE;QACnE,6DAA6D;QAC7D,MAAM,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,sBAAsB,CAAC,eAAe,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC7E,CAAC;CACF"}

package/lib/esm/selectors.d.ts

@@ -2,3 +2,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';
+export { EuiSelectableSelectors } from './components/selectable/selectors';

package/lib/esm/selectors.js

@@ -9,4 +9,5 @@ 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';
+export { EuiSelectableSelectors } from './components/selectable/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;AACxE,OAAO,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAC;AACvE,OAAO,EAAE,uBAAuB,EAAE,MAAM,0CAA0C,CAAC;AACnF,OAAO,EAAE,2BAA2B,EAAE,MAAM,8BAA8B,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;AAC3E,OAAO,EAAE,sBAAsB,EAAE,MAAM,mCAAmC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@elastic/eui-test-helpers",
-  "version": "1.3.0",
+  "version": "1.4.0-snapshot.1787665877015",
   "description": "A library of EUI test helpers for RTL, Cypress and Scout",
   "license": "SEE LICENSE IN LICENSE.txt",
   "repository": {
@@ -57,5 +57,6 @@
     "!**/*.spec.js.map",
     "README.md",
     "licenses"
-  ]
+  ],
+  "stableVersion": "1.4.0"
 }

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/selectable/README.md

@@ -0,0 +1,27 @@
+# EuiSelectableObject
+
+Playwright Component Object for [EuiSelectable](https://eui.elastic.co/docs/components/forms/selection/selectable/).
+
+## Usage
+
+```ts
+import { EuiSelectableObject } from '@elastic/eui-test-helpers';
+
+const selectable = new EuiSelectableObject(page, 'mySelectable');
+await selectable.search('logs');
+await selectable.selectOption('logs-*');
+```
+
+Set `data-test-subj` on the `<EuiSelectable>` (EUI spreads it onto the `.euiSelectable` root, which the component-type guard verifies). When the selectable renders inside a popover, pass the popover as the `scope` and open or close it from your test. The popover is not this component's concern.
+
+## API
+
+| Member | Description |
+|---|---|
+| `options` | `Locator` for the rendered options, keeping Playwright auto-retry for count and content assertions. The list is virtualized, so `search()` first rather than scanning a long list. |
+| `selectOption(label)` | Selects the option with the given label. A no-op if it is already checked. |
+| `search(term)` | Types into the search box. Throws if the selectable is not searchable. |
+
+`selectOption(label)` matches the label element and suits lists in their default state. It tolerates the screen-reader state text EUI appends (a checked option reads `<label> . Checked option.`) and `append` badges, and it will not match a different option whose label merely starts with the same text. Once you call `search()`, EUI injects highlight markers into the option's label, so a label match no longer resolves. On a searched list, select via the option's own `data-test-subj` or drive it through `options` directly.
+
+It also only matches the plain label. A consumer using a custom `renderOption` to add its own content (e.g. a description) inside the option renders that content in the same label element, which breaks the anchored match. Select those options via `options` instead (e.g. `options.filter({ hasText: label })`).