@elastic/eui-test-helpers 1.5.0 → 1.6.0

package/README.md

@@ -54,6 +54,10 @@ their own version at runtime.
 | `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) |
+| `EuiPopoverObject` | [src/components/popover/README.md](src/components/popover/README.md) |
+| `EuiFlyoutObject` | [src/components/flyout/README.md](src/components/flyout/README.md) |
+| `EuiAccordionObject` | [src/components/accordion/README.md](src/components/accordion/README.md) |
+| `EuiModalObject` | [src/components/modal/README.md](src/components/modal/README.md) |
 | `EuiBasicTableObject` | [src/components/basic_table/README.md](src/components/basic_table/README.md) |
 
 ## Contributing

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

@@ -0,0 +1,15 @@
+/**
+ * Stable selectors for
+ * {@link https://eui.elastic.co/docs/components/containers/accordion/|EuiAccordion}.
+ * `*_SELECTOR` values are CSS, scoped to direct children (`>`) so a nested
+ * accordion inside `content` never matches these instead of this instance's
+ * own elements.
+ */
+export declare const EuiAccordionSelectors: {
+    /** Root element carrying the consumer's `data-test-subj`. */
+    ROOT_SELECTOR: string;
+    /** The trigger button. `aria-expanded` on it reflects open state synchronously. */
+    TRIGGER_SELECTOR: string;
+    /** The children wrapper. `height: 0` and `opacity: 0` while closed, so Playwright treats its contents as not visible. */
+    CONTENT_SELECTOR: string;
+};

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

@@ -0,0 +1,29 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.EuiAccordionSelectors = 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/containers/accordion/|EuiAccordion}.
+ * `*_SELECTOR` values are CSS, scoped to direct children (`>`) so a nested
+ * accordion inside `content` never matches these instead of this instance's
+ * own elements.
+ */
+const EuiAccordionSelectors = exports.EuiAccordionSelectors = {
+  /** Root element carrying the consumer's `data-test-subj`. */
+  ROOT_SELECTOR: '.euiAccordion',
+  /** The trigger button. `aria-expanded` on it reflects open state synchronously. */
+  TRIGGER_SELECTOR: '> .euiAccordion__triggerWrapper > .euiAccordion__button',
+  /** The children wrapper. `height: 0` and `opacity: 0` while closed, so Playwright treats its contents as not visible. */
+  CONTENT_SELECTOR: '> .euiAccordion__childWrapper'
+};

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

@@ -0,0 +1,10 @@
+/**
+ * Stable selectors for
+ * {@link https://eui.elastic.co/docs/components/containers/flyout/|EuiFlyout}.
+ */
+export declare const EuiFlyoutSelectors: {
+    /** Root element carrying the consumer's `data-test-subj`. CSS. */
+    ROOT_SELECTOR: string;
+    /** `data-test-subj` EUI sets on its own close button. Absent with `hideCloseButton` or a rendered flyout menu. */
+    CLOSE_BUTTON_TEST_SUBJ: string;
+};

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

@@ -0,0 +1,24 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.EuiFlyoutSelectors = 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/containers/flyout/|EuiFlyout}.
+ */
+const EuiFlyoutSelectors = exports.EuiFlyoutSelectors = {
+  /** Root element carrying the consumer's `data-test-subj`. CSS. */
+  ROOT_SELECTOR: '.euiFlyout',
+  /** `data-test-subj` EUI sets on its own close button. Absent with `hideCloseButton` or a rendered flyout menu. */
+  CLOSE_BUTTON_TEST_SUBJ: 'euiFlyoutCloseButton'
+};

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

@@ -0,0 +1,11 @@
+/**
+ * Stable selectors for
+ * {@link https://eui.elastic.co/docs/components/containers/modal/|EuiModal}
+ * and `EuiConfirmModal`. `*_SELECTOR` values are CSS.
+ */
+export declare const EuiModalSelectors: {
+    /** Root element carrying the consumer's `data-test-subj`. Matches `EuiConfirmModal` too, which renders `EuiModal` underneath. */
+    ROOT_SELECTOR: string;
+    /** The close button. No `data-test-subj`, only an i18n `aria-label`, so read by this stable class instead. */
+    CLOSE_BUTTON_SELECTOR: string;
+};

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

@@ -0,0 +1,25 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.EuiModalSelectors = 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/containers/modal/|EuiModal}
+ * and `EuiConfirmModal`. `*_SELECTOR` values are CSS.
+ */
+const EuiModalSelectors = exports.EuiModalSelectors = {
+  /** Root element carrying the consumer's `data-test-subj`. Matches `EuiConfirmModal` too, which renders `EuiModal` underneath. */
+  ROOT_SELECTOR: '.euiModal',
+  /** The close button. No `data-test-subj`, only an i18n `aria-label`, so read by this stable class instead. */
+  CLOSE_BUTTON_SELECTOR: '.euiModal__closeIcon'
+};

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

@@ -0,0 +1,11 @@
+/**
+ * Stable selectors for
+ * {@link https://eui.elastic.co/docs/components/containers/popover/|EuiPopover}.
+ * `*_SELECTOR` values are CSS.
+ */
+export declare const EuiPopoverSelectors: {
+    /** `EuiPopover` sets this on a button-like toggle from mount, regardless of open state. */
+    TOGGLE_SELECTOR: string;
+    /** The portal panel, matched by the id the toggle's `aria-controls` points at. Present while open or closing. */
+    panelFor: (id: string) => string;
+};

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

@@ -0,0 +1,25 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.EuiPopoverSelectors = 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/containers/popover/|EuiPopover}.
+ * `*_SELECTOR` values are CSS.
+ */
+const EuiPopoverSelectors = exports.EuiPopoverSelectors = {
+  /** `EuiPopover` sets this on a button-like toggle from mount, regardless of open state. */
+  TOGGLE_SELECTOR: '[aria-expanded]',
+  /** The portal panel, matched by the id the toggle's `aria-controls` points at. Present while open or closing. */
+  panelFor: id => `[data-popover-panel][id="${id}"]`
+};

package/lib/cjs/index.d.ts

@@ -7,4 +7,8 @@ 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 { EuiPopoverObject } from './playwright/components/popover/object';
+export { EuiFlyoutObject } from './playwright/components/flyout/object';
+export { EuiAccordionObject } from './playwright/components/accordion/object';
+export { EuiModalObject } from './playwright/components/modal/object';
 export { EuiBasicTableObject } from './playwright/components/basic_table/object';

package/lib/cjs/index.js

@@ -9,10 +9,16 @@ Object.defineProperty(exports, "BaseObject", {
     return _base_object.BaseObject;
   }
 });
+Object.defineProperty(exports, "EuiAccordionObject", {
+  enumerable: true,
+  get: function () {
+    return _object11.EuiAccordionObject;
+  }
+});
 Object.defineProperty(exports, "EuiBasicTableObject", {
   enumerable: true,
   get: function () {
-    return _object9.EuiBasicTableObject;
+    return _object13.EuiBasicTableObject;
   }
 });
 Object.defineProperty(exports, "EuiComboBoxObject", {
@@ -39,12 +45,30 @@ Object.defineProperty(exports, "EuiFilterButtonObject", {
     return _object7.EuiFilterButtonObject;
   }
 });
+Object.defineProperty(exports, "EuiFlyoutObject", {
+  enumerable: true,
+  get: function () {
+    return _object10.EuiFlyoutObject;
+  }
+});
 Object.defineProperty(exports, "EuiGlobalToastListObject", {
   enumerable: true,
   get: function () {
     return _object4.EuiGlobalToastListObject;
   }
 });
+Object.defineProperty(exports, "EuiModalObject", {
+  enumerable: true,
+  get: function () {
+    return _object12.EuiModalObject;
+  }
+});
+Object.defineProperty(exports, "EuiPopoverObject", {
+  enumerable: true,
+  get: function () {
+    return _object9.EuiPopoverObject;
+  }
+});
 Object.defineProperty(exports, "EuiRangeObject", {
   enumerable: true,
   get: function () {
@@ -72,4 +96,8 @@ 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");
+var _object9 = require("./playwright/components/popover/object");
+var _object10 = require("./playwright/components/flyout/object");
+var _object11 = require("./playwright/components/accordion/object");
+var _object12 = require("./playwright/components/modal/object");
+var _object13 = require("./playwright/components/basic_table/object");

package/lib/cjs/playwright/components/accordion/object.d.ts

@@ -0,0 +1,16 @@
+import type { Locator } from '@playwright/test';
+import { BaseObject, type ObjectScope } from '../../base_object';
+/**
+ * Playwright Component Object for {@link
+ * https://eui.elastic.co/docs/components/containers/accordion/ EuiAccordion}.
+ *
+ * `testSubj` must be set on the `<EuiAccordion>` itself. See the package
+ * README for what this does not cover.
+ */
+export declare class EuiAccordionObject extends BaseObject {
+    constructor(scope: ObjectScope, testSubj: string);
+    /** The trigger button. Assert `aria-expanded` on it for open state, e.g. `toHaveAttribute('aria-expanded', 'true')`. */
+    get trigger(): Locator;
+    /** The children wrapper, scoped to this instance. */
+    get content(): Locator;
+}

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

@@ -0,0 +1,39 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.EuiAccordionObject = void 0;
+var _base_object = require("../../base_object");
+var _selectors = require("../../../components/accordion/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/containers/accordion/ EuiAccordion}.
+ *
+ * `testSubj` must be set on the `<EuiAccordion>` itself. See the package
+ * README for what this does not cover.
+ */
+class EuiAccordionObject extends _base_object.BaseObject {
+  constructor(scope, testSubj) {
+    super(scope, testSubj, _selectors.EuiAccordionSelectors.ROOT_SELECTOR);
+  }
+
+  /** The trigger button. Assert `aria-expanded` on it for open state, e.g. `toHaveAttribute('aria-expanded', 'true')`. */
+  get trigger() {
+    return this.root.locator(_selectors.EuiAccordionSelectors.TRIGGER_SELECTOR);
+  }
+
+  /** The children wrapper, scoped to this instance. */
+  get content() {
+    return this.root.locator(_selectors.EuiAccordionSelectors.CONTENT_SELECTOR);
+  }
+}
+exports.EuiAccordionObject = EuiAccordionObject;

package/lib/cjs/playwright/components/combo_box/object.d.ts

@@ -43,7 +43,8 @@ export declare class EuiComboBoxObject extends BaseObject {
      * Clear all selected options. No-op if nothing is selected.
      *
      * Auto-detects the combo box configuration and uses the appropriate strategy:
-     * - Pills present → {@link clickPillClearButtons}
+     * - Pills with a close button → {@link clickPillClearButtons}
+     * - Pills without a close button (`singleSelection`) → {@link clearPillWithoutCloseButton}
      * - `asPlainText` with a confirmed input selection → {@link deleteSearchInput}
      * - Otherwise → {@link deselectAllFromDropdown}
      *
@@ -62,12 +63,18 @@ export declare class EuiComboBoxObject extends BaseObject {
      */
     getSelectedOptions(): Promise<string[]>;
     private hasPills;
+    private hasPillCloseButtons;
     /**
      * Clicks the `×` button on each selected pill individually.
-     * Works regardless of `isClearable` — pill close buttons are always present.
      * No-op if no pills are rendered.
      */
     private clickPillClearButtons;
+    /**
+     * `singleSelection` pills render without a close button, whatever
+     * `isClearable` is. Backspace on an empty search input removes the
+     * selection instead.
+     */
+    private clearPillWithoutCloseButton;
     /**
      * Opens the dropdown and clicks each `aria-selected="true"` option to
      * deselect it. Works for all `isClearable` and `singleSelection`

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

@@ -125,7 +125,8 @@ class EuiComboBoxObject extends _base_object.BaseObject {
    * Clear all selected options. No-op if nothing is selected.
    *
    * Auto-detects the combo box configuration and uses the appropriate strategy:
-   * - Pills present → {@link clickPillClearButtons}
+   * - Pills with a close button → {@link clickPillClearButtons}
+   * - Pills without a close button (`singleSelection`) → {@link clearPillWithoutCloseButton}
    * - `asPlainText` with a confirmed input selection → {@link deleteSearchInput}
    * - Otherwise → {@link deselectAllFromDropdown}
    *
@@ -138,7 +139,11 @@ class EuiComboBoxObject extends _base_object.BaseObject {
       return;
     }
     if (await this.hasPills()) {
-      await this.clickPillClearButtons();
+      if (await this.hasPillCloseButtons()) {
+        await this.clickPillClearButtons();
+      } else {
+        await this.clearPillWithoutCloseButton();
+      }
       return;
     }
     if (await this.hasConfirmedInputSelection()) {
@@ -168,10 +173,12 @@ class EuiComboBoxObject extends _base_object.BaseObject {
   async hasPills() {
     return (await this.pills.count()) > 0;
   }
+  async hasPillCloseButtons() {
+    return (await this.pills.first().locator('button').count()) > 0;
+  }
 
   /**
    * Clicks the `×` button on each selected pill individually.
-   * Works regardless of `isClearable` — pill close buttons are always present.
    * No-op if no pills are rendered.
    */
   async clickPillClearButtons() {
@@ -182,6 +189,19 @@ class EuiComboBoxObject extends _base_object.BaseObject {
     }
   }
 
+  /**
+   * `singleSelection` pills render without a close button, whatever
+   * `isClearable` is. Backspace on an empty search input removes the
+   * selection instead.
+   */
+  async clearPillWithoutCloseButton() {
+    while (await this.hasPills()) {
+      const countBefore = await this.pills.count();
+      await this.searchInput.press('Backspace');
+      await (0, _test.expect)(this.pills).not.toHaveCount(countBefore);
+    }
+  }
+
   /**
    * Opens the dropdown and clicks each `aria-selected="true"` option to
    * deselect it. Works for all `isClearable` and `singleSelection`

package/lib/cjs/playwright/components/flyout/object.d.ts

@@ -0,0 +1,17 @@
+import type { Locator } from '@playwright/test';
+import { BaseObject, type ObjectScope } from '../../base_object';
+/**
+ * Playwright Component Object for {@link
+ * https://eui.elastic.co/docs/components/containers/flyout/ EuiFlyout}.
+ *
+ * `testSubj` must be set on the `<EuiFlyout>` itself. See the package README
+ * for what this does not cover.
+ */
+export declare class EuiFlyoutObject extends BaseObject {
+    constructor(scope: ObjectScope, testSubj: string);
+    /**
+     * This flyout's own close button, scoped to this instance. Absent with
+     * `hideCloseButton` or a rendered flyout menu.
+     */
+    get closeButton(): Locator;
+}

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

@@ -0,0 +1,37 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.EuiFlyoutObject = void 0;
+var _base_object = require("../../base_object");
+var _selectors = require("../../../components/flyout/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/containers/flyout/ EuiFlyout}.
+ *
+ * `testSubj` must be set on the `<EuiFlyout>` itself. See the package README
+ * for what this does not cover.
+ */
+class EuiFlyoutObject extends _base_object.BaseObject {
+  constructor(scope, testSubj) {
+    super(scope, testSubj, _selectors.EuiFlyoutSelectors.ROOT_SELECTOR);
+  }
+
+  /**
+   * This flyout's own close button, scoped to this instance. Absent with
+   * `hideCloseButton` or a rendered flyout menu.
+   */
+  get closeButton() {
+    return this.root.getByTestId(_selectors.EuiFlyoutSelectors.CLOSE_BUTTON_TEST_SUBJ);
+  }
+}
+exports.EuiFlyoutObject = EuiFlyoutObject;

package/lib/cjs/playwright/components/modal/object.d.ts

@@ -0,0 +1,15 @@
+import type { Locator } from '@playwright/test';
+import { BaseObject, type ObjectScope } from '../../base_object';
+/**
+ * Playwright Component Object for {@link
+ * https://eui.elastic.co/docs/components/containers/modal/ EuiModal} and
+ * `EuiConfirmModal`, which renders `EuiModal` underneath.
+ *
+ * `testSubj` must be set on the `<EuiModal>`/`<EuiConfirmModal>` itself. See
+ * the package README for what this does not cover.
+ */
+export declare class EuiModalObject extends BaseObject {
+    constructor(scope: ObjectScope, testSubj: string);
+    /** This modal's own close button, scoped to this instance. */
+    get closeButton(): Locator;
+}

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

@@ -0,0 +1,35 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.EuiModalObject = void 0;
+var _base_object = require("../../base_object");
+var _selectors = require("../../../components/modal/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/containers/modal/ EuiModal} and
+ * `EuiConfirmModal`, which renders `EuiModal` underneath.
+ *
+ * `testSubj` must be set on the `<EuiModal>`/`<EuiConfirmModal>` itself. See
+ * the package README for what this does not cover.
+ */
+class EuiModalObject extends _base_object.BaseObject {
+  constructor(scope, testSubj) {
+    super(scope, testSubj, _selectors.EuiModalSelectors.ROOT_SELECTOR);
+  }
+
+  /** This modal's own close button, scoped to this instance. */
+  get closeButton() {
+    return this.root.locator(_selectors.EuiModalSelectors.CLOSE_BUTTON_SELECTOR);
+  }
+}
+exports.EuiModalObject = EuiModalObject;

package/lib/cjs/playwright/components/popover/object.d.ts

@@ -0,0 +1,26 @@
+import { BaseObject, type ObjectScope } from '../../base_object';
+/**
+ * Playwright Component Object for {@link
+ * https://eui.elastic.co/docs/components/containers/popover/ EuiPopover}.
+ *
+ * `testSubj` must be set on the toggle button, not the panel. See the
+ * package README for the component-type guard and what this does not cover.
+ */
+export declare class EuiPopoverObject extends BaseObject {
+    constructor(scope: ObjectScope, testSubj: string);
+    /**
+     * Opens the popover and waits for the panel to be open. A no-op if it is
+     * already open.
+     */
+    open(): Promise<void>;
+    /**
+     * Closes the popover and waits for the panel to be removed. A no-op if it
+     * is already closed.
+     */
+    close(): Promise<void>;
+    /**
+     * The panel the toggle's `aria-controls` points at. EUI sets that attribute
+     * synchronously with the open state, before the panel's own transition.
+     */
+    private panel;
+}

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

@@ -0,0 +1,72 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.EuiPopoverObject = void 0;
+var _test = require("@playwright/test");
+var _base_object = require("../../base_object");
+var _selectors = require("../../../components/popover/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/containers/popover/ EuiPopover}.
+ *
+ * `testSubj` must be set on the toggle button, not the panel. See the
+ * package README for the component-type guard and what this does not cover.
+ */
+class EuiPopoverObject extends _base_object.BaseObject {
+  constructor(scope, testSubj) {
+    super(scope, testSubj, _selectors.EuiPopoverSelectors.TOGGLE_SELECTOR);
+  }
+
+  /**
+   * Opens the popover and waits for the panel to be open. A no-op if it is
+   * already open.
+   */
+  async open() {
+    if ((await this.root.getAttribute('aria-expanded')) === 'true') {
+      return;
+    }
+    await this.root.click();
+    const panel = await this.panel();
+    await panel.waitFor({
+      state: 'visible'
+    });
+    await (0, _test.expect)(panel).toHaveAttribute('data-popover-open', 'true');
+  }
+
+  /**
+   * Closes the popover and waits for the panel to be removed. A no-op if it
+   * is already closed.
+   */
+  async close() {
+    if ((await this.root.getAttribute('aria-expanded')) !== 'true') {
+      return;
+    }
+    // `aria-controls` is removed on close, so resolve the panel first.
+    const panel = await this.panel();
+    await this.root.click();
+    await panel.waitFor({
+      state: 'detached'
+    });
+  }
+
+  /**
+   * The panel the toggle's `aria-controls` points at. EUI sets that attribute
+   * synchronously with the open state, before the panel's own transition.
+   */
+  async panel() {
+    await (0, _test.expect)(this.root).toHaveAttribute('aria-controls', /.+/);
+    const id = await this.root.getAttribute('aria-controls');
+    return this.root.page().locator(_selectors.EuiPopoverSelectors.panelFor(id));
+  }
+}
+exports.EuiPopoverObject = EuiPopoverObject;

package/lib/cjs/storybook.d.ts

@@ -2,6 +2,6 @@
  * Returns the Storybook iframe URL for a given story ID and optional args.
  *
  * @param id - The Storybook story ID (e.g. `'forms-euicombobox--playground'`)
- * @param args - Optional semicolon-separated Storybook args string (e.g. `'data-test-subj:myCombo;singleSelection:true'`)
+ * @param args - Optional semicolon-separated Storybook args string (e.g. `'data-test-subj:myCombo;singleSelection:!true'`)
  */
 export declare const storyUrl: (id: string, args?: string) => string;

package/lib/cjs/storybook.js

@@ -16,7 +16,7 @@ exports.storyUrl = void 0;
  * Returns the Storybook iframe URL for a given story ID and optional args.
  *
  * @param id - The Storybook story ID (e.g. `'forms-euicombobox--playground'`)
- * @param args - Optional semicolon-separated Storybook args string (e.g. `'data-test-subj:myCombo;singleSelection:true'`)
+ * @param args - Optional semicolon-separated Storybook args string (e.g. `'data-test-subj:myCombo;singleSelection:!true'`)
  */
 const storyUrl = (id, args) => `/iframe.html?id=${id}&viewMode=story${args ? `&args=${args}` : ''}`;
 exports.storyUrl = storyUrl;

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

@@ -0,0 +1,15 @@
+/**
+ * Stable selectors for
+ * {@link https://eui.elastic.co/docs/components/containers/accordion/|EuiAccordion}.
+ * `*_SELECTOR` values are CSS, scoped to direct children (`>`) so a nested
+ * accordion inside `content` never matches these instead of this instance's
+ * own elements.
+ */
+export declare const EuiAccordionSelectors: {
+    /** Root element carrying the consumer's `data-test-subj`. */
+    ROOT_SELECTOR: string;
+    /** The trigger button. `aria-expanded` on it reflects open state synchronously. */
+    TRIGGER_SELECTOR: string;
+    /** The children wrapper. `height: 0` and `opacity: 0` while closed, so Playwright treats its contents as not visible. */
+    CONTENT_SELECTOR: string;
+};

package/lib/esm/components/accordion/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/containers/accordion/|EuiAccordion}.
+ * `*_SELECTOR` values are CSS, scoped to direct children (`>`) so a nested
+ * accordion inside `content` never matches these instead of this instance's
+ * own elements.
+ */
+export const EuiAccordionSelectors = {
+    /** Root element carrying the consumer's `data-test-subj`. */
+    ROOT_SELECTOR: '.euiAccordion',
+    /** The trigger button. `aria-expanded` on it reflects open state synchronously. */
+    TRIGGER_SELECTOR: '> .euiAccordion__triggerWrapper > .euiAccordion__button',
+    /** The children wrapper. `height: 0` and `opacity: 0` while closed, so Playwright treats its contents as not visible. */
+    CONTENT_SELECTOR: '> .euiAccordion__childWrapper',
+};
+//# sourceMappingURL=selectors.js.map