@elastic/eui-test-helpers 1.1.0

package/lib/cjs/storybook.js

@@ -0,0 +1,22 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.storyUrl = 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.
+ */
+
+/**
+ * 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'`)
+ */
+const storyUrl = (id, args) => `/iframe.html?id=${id}&viewMode=story${args ? `&args=${args}` : ''}`;
+exports.storyUrl = storyUrl;

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

@@ -0,0 +1,72 @@
+/**
+ * List of available stable selectors for
+ * {@link https://eui.elastic.co/docs/components/forms/selection/combo-box/|EuiComboBox}
+ */
+export declare const EuiComboBoxSelectors: {
+    /**
+     * `data-test-subj` identifier of the inner input wrapper element
+     */
+    INPUT_WRAPPER_TEST_SUBJ: string;
+    /**
+     * `data-test-subj` identifier of the search input field
+     */
+    SEARCH_INPUT_TEST_SUBJ: string;
+    /**
+     * `data-test-subj` identifier of the options list
+     */
+    OPTIONS_LIST_TEST_SUBJ: string;
+    /**
+     * `data-test-subj` identifier of the options list toggle button
+     */
+    OPTIONS_LIST_TOGGLE_BUTTON_TEST_SUBJ: string;
+    /**
+     * `data-test-subj` identifier of the clear button
+     */
+    CLEAR_BUTTON_TEST_SUBJ: string;
+    /**
+     * CSS selector for the input wrapper in `singleSelection={{ asPlainText: true }}` mode.
+     * Present when the combo renders the selection inside the input instead of as pills.
+     */
+    PLAIN_TEXT_INPUT_WRAP_SELECTOR: string;
+    /**
+     * `data-test-subj` identifier of selected option pills.
+     * Only present in non-`asPlainText` mode — in `asPlainText` mode the
+     * selection is shown inside the input, not as pills.
+     */
+    PILL_TEST_SUBJ: string;
+    /**
+     * CSS selector for all options in a specific combo box's dropdown.
+     *
+     * `testSubj` is the consumer's `data-test-subj` on `<EuiComboBox>`. EUI
+     * propagates this to the options list as `${testSubj}-optionsList`,
+     * letting us disambiguate when multiple combo boxes coexist on one page.
+     *
+     * To target a specific option by label, compose with Playwright's
+     * `getByTitle` to avoid CSS-injection issues with labels that contain
+     * special characters (`"`, `]`, `\`):
+     *
+     * ```ts
+     * page
+     *   .locator(EuiComboBoxSelectors.optionFor(testSubj))
+     *   .and(page.getByTitle(label, { exact: true }))
+     * ```
+     *
+     * Note: the list may be virtualized — type the search string into the
+     * input before asserting on a specific option to ensure it is in DOM.
+     */
+    optionFor: (testSubj: string) => string;
+    /**
+     * CSS selector for all selected options in a specific combo box's dropdown.
+     * See `optionFor` for `testSubj` rationale and label-targeting guidance.
+     */
+    selectedOptionFor: (testSubj: string) => string;
+    /**
+     * CSS selector for a specific combo box's options list container (the
+     * dropdown portal). Matches whether the list has regular options or an
+     * empty-state entry (e.g. "Add X as a custom option" for `onCreateOption`).
+     *
+     * Use this when you only need to wait for the dropdown to open, not when
+     * you need to target a specific option inside it.
+     */
+    optionsListFor: (testSubj: string) => string;
+};

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

@@ -0,0 +1,80 @@
+/*
+ * 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.
+ */
+/**
+ * List of available stable selectors for
+ * {@link https://eui.elastic.co/docs/components/forms/selection/combo-box/|EuiComboBox}
+ */
+export const EuiComboBoxSelectors = {
+    /**
+     * `data-test-subj` identifier of the inner input wrapper element
+     */
+    INPUT_WRAPPER_TEST_SUBJ: 'comboBoxInput',
+    /**
+     * `data-test-subj` identifier of the search input field
+     */
+    SEARCH_INPUT_TEST_SUBJ: 'comboBoxSearchInput',
+    /**
+     * `data-test-subj` identifier of the options list
+     */
+    OPTIONS_LIST_TEST_SUBJ: 'comboBoxOptionsList',
+    /**
+     * `data-test-subj` identifier of the options list toggle button
+     */
+    OPTIONS_LIST_TOGGLE_BUTTON_TEST_SUBJ: 'comboBoxToggleListButton',
+    /**
+     * `data-test-subj` identifier of the clear button
+     */
+    CLEAR_BUTTON_TEST_SUBJ: 'comboBoxClearButton',
+    /**
+     * CSS selector for the input wrapper in `singleSelection={{ asPlainText: true }}` mode.
+     * Present when the combo renders the selection inside the input instead of as pills.
+     */
+    PLAIN_TEXT_INPUT_WRAP_SELECTOR: '.euiComboBox__inputWrap--plainText',
+    /**
+     * `data-test-subj` identifier of selected option pills.
+     * Only present in non-`asPlainText` mode — in `asPlainText` mode the
+     * selection is shown inside the input, not as pills.
+     */
+    PILL_TEST_SUBJ: 'euiComboBoxPill',
+    /**
+     * CSS selector for all options in a specific combo box's dropdown.
+     *
+     * `testSubj` is the consumer's `data-test-subj` on `<EuiComboBox>`. EUI
+     * propagates this to the options list as `${testSubj}-optionsList`,
+     * letting us disambiguate when multiple combo boxes coexist on one page.
+     *
+     * To target a specific option by label, compose with Playwright's
+     * `getByTitle` to avoid CSS-injection issues with labels that contain
+     * special characters (`"`, `]`, `\`):
+     *
+     * ```ts
+     * page
+     *   .locator(EuiComboBoxSelectors.optionFor(testSubj))
+     *   .and(page.getByTitle(label, { exact: true }))
+     * ```
+     *
+     * Note: the list may be virtualized — type the search string into the
+     * input before asserting on a specific option to ensure it is in DOM.
+     */
+    optionFor: (testSubj) => `[data-test-subj~="${testSubj}-optionsList"] [role="option"]`,
+    /**
+     * CSS selector for all selected options in a specific combo box's dropdown.
+     * See `optionFor` for `testSubj` rationale and label-targeting guidance.
+     */
+    selectedOptionFor: (testSubj) => `[data-test-subj~="${testSubj}-optionsList"] [role="option"][aria-selected="true"]`,
+    /**
+     * CSS selector for a specific combo box's options list container (the
+     * dropdown portal). Matches whether the list has regular options or an
+     * empty-state entry (e.g. "Add X as a custom option" for `onCreateOption`).
+     *
+     * Use this when you only need to wait for the dropdown to open, not when
+     * you need to target a specific option inside it.
+     */
+    optionsListFor: (testSubj) => `[data-test-subj~="${testSubj}-optionsList"]`,
+};
+//# sourceMappingURL=selectors.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"selectors.js","sourceRoot":"","sources":["../../../../src/components/combo_box/selectors.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;GAGG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC;;OAEG;IACH,uBAAuB,EAAE,eAAe;IAExC;;OAEG;IACH,sBAAsB,EAAE,qBAAqB;IAE7C;;OAEG;IACH,sBAAsB,EAAE,qBAAqB;IAE7C;;OAEG;IACH,oCAAoC,EAAE,0BAA0B;IAEhE;;OAEG;IACH,sBAAsB,EAAE,qBAAqB;IAE7C;;;OAGG;IACH,8BAA8B,EAAE,oCAAoC;IAEpE;;;;OAIG;IACH,cAAc,EAAE,iBAAiB;IAEjC;;;;;;;;;;;;;;;;;;;OAmBG;IACH,SAAS,EAAE,CAAC,QAAgB,EAAU,EAAE,CACtC,qBAAqB,QAAQ,gCAAgC;IAE/D;;;OAGG;IACH,iBAAiB,EAAE,CAAC,QAAgB,EAAU,EAAE,CAC9C,qBAAqB,QAAQ,sDAAsD;IAErF;;;;;;;OAOG;IACH,cAAc,EAAE,CAAC,QAAgB,EAAU,EAAE,CAC3C,qBAAqB,QAAQ,gBAAgB;CAChD,CAAC"}

package/lib/esm/index.d.ts

@@ -0,0 +1,2 @@
+export { BaseObject, type ObjectScope } from './playwright/base_object';
+export { EuiComboBoxObject } from './playwright/components/combo_box/object';

package/lib/esm/index.js

@@ -0,0 +1,10 @@
+/*
+ * 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.
+ */
+export { BaseObject } from './playwright/base_object';
+export { EuiComboBoxObject } from './playwright/components/combo_box/object';
+//# sourceMappingURL=index.js.map

package/lib/esm/index.js.map

@@ -0,0 +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"}

package/lib/esm/playwright/base_object.d.ts

@@ -0,0 +1,31 @@
+import type { Locator, Page } from '@playwright/test';
+export type ObjectScope = Page | Locator | BaseObject;
+/**
+ * Base class for Playwright Component Objects — semantic wrappers around a
+ * single root `Locator` resolved from a `data-test-subj` inside the given
+ * scope. Subclasses compose: pass another Component Object as `scope` to
+ * nest one inside the other's DOM subtree.
+ *
+ * Requires `testIdAttribute: 'data-test-subj'` in the Playwright config.
+ */
+export declare abstract class BaseObject {
+    /**
+     * Available to subclasses for queries outside `root`'s subtree but within
+     * the original scope (e.g. siblings, related controls).
+     */
+    protected readonly scope: Page | Locator;
+    protected readonly root: Locator;
+    /**
+     * Retained so subclasses can disambiguate portal-rendered content per
+     * instance — e.g. EUI propagates this as `${testSubj}-optionsList` to a
+     * combo box's options list, letting us scope queries to the right combo
+     * when several exist on a page.
+     */
+    protected readonly testSubj: string;
+    constructor(scope: ObjectScope, testSubj: string);
+    /**
+     * Underlying `Locator` — escape hatch for assertions or scoping the
+     * Component Object's API doesn't cover.
+     */
+    get locator(): Locator;
+}

package/lib/esm/playwright/base_object.js

@@ -0,0 +1,30 @@
+/*
+ * 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.
+ */
+/**
+ * Base class for Playwright Component Objects — semantic wrappers around a
+ * single root `Locator` resolved from a `data-test-subj` inside the given
+ * scope. Subclasses compose: pass another Component Object as `scope` to
+ * nest one inside the other's DOM subtree.
+ *
+ * Requires `testIdAttribute: 'data-test-subj'` in the Playwright config.
+ */
+export class BaseObject {
+    constructor(scope, testSubj) {
+        this.scope = scope instanceof BaseObject ? scope.locator : scope;
+        this.root = this.scope.getByTestId(testSubj);
+        this.testSubj = testSubj;
+    }
+    /**
+     * Underlying `Locator` — escape hatch for assertions or scoping the
+     * Component Object's API doesn't cover.
+     */
+    get locator() {
+        return this.root;
+    }
+}
+//# sourceMappingURL=base_object.js.map

package/lib/esm/playwright/base_object.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base_object.js","sourceRoot":"","sources":["../../../src/playwright/base_object.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH;;;;;;;GAOG;AACH,MAAM,OAAgB,UAAU;IAiB9B,YAAY,KAAkB,EAAE,QAAgB;QAC9C,IAAI,CAAC,KAAK,GAAG,KAAK,YAAY,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC;QACjE,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;QAC7C,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;IAED;;;OAGG;IACH,IAAI,OAAO;QACT,OAAO,IAAI,CAAC,IAAI,CAAC;IACnB,CAAC;CACF"}

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

@@ -0,0 +1,88 @@
+import { BaseObject } from '../../base_object';
+/**
+ * Playwright Component Object for {@link
+ * https://eui.elastic.co/docs/components/forms/selection/combo-box/ EuiComboBox}.
+ *
+ * `testSubj` must match the `data-test-subj` set by the consumer on the
+ * `<EuiComboBox>` element (the outer `.euiComboBox` wrapper, not the inner
+ * `comboBoxInput`).
+ */
+export declare class EuiComboBoxObject extends BaseObject {
+    /**
+     * Replace the current selection with `labels`. Set-semantics: order-
+     * independent — already-selected labels are kept, missing ones are added,
+     * extras are removed. No-op if the current selection already matches.
+     *
+     * Throws with a descriptive message if any label never appears in the
+     * dropdown (catches test/data drift early).
+     */
+    setSelectedOptions(labels: string[]): Promise<void>;
+    /**
+     * 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}
+     * - `asPlainText` with a confirmed input selection → {@link deleteSearchInput}
+     * - Otherwise → {@link deselectAllFromDropdown}
+     *
+     * Use the explicit methods directly when you need full control over the
+     * clearing strategy (e.g. `onCreateOption` with selections not in the
+     * options list).
+     */
+    clear(): Promise<void>;
+    /**
+     * Currently selected option labels.
+     *
+     * - Multi-select / `singleSelection=true` → pill texts.
+     * - `singleSelection={{ asPlainText: true }}` → the input value. EUI
+     *   renders no pills in this mode; the input IS the selection display.
+     *   Works correctly with both `isClearable=true` (default) and
+     *   `isClearable=false`.
+     * - Nothing selected → `[]`.
+     */
+    getSelectedOptions(): Promise<string[]>;
+    private hasPills;
+    /**
+     * 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;
+    /**
+     * Opens the dropdown and clicks each `aria-selected="true"` option to
+     * deselect it. Works for all `isClearable` and `singleSelection`
+     * configurations when the selected options are present in the options list.
+     *
+     * Does not work when the selection was created via `onCreateOption` and the
+     * created option was not added back to the `options` array — use
+     * {@link clickPillClearButtons} instead.
+     */
+    private deselectAllFromDropdown;
+    private addOption;
+    /**
+     * Focuses the search input and presses Backspace to clear the selection.
+     * Only valid in `singleSelection={{ asPlainText: true }}` mode where
+     * {@link hasConfirmedInputSelection} is true — EUI's `onKeyDown` handler
+     * fires `onRemoveOption` when Backspace is pressed with an empty `searchValue`.
+     */
+    private deleteSearchInput;
+    /**
+     * Returns true when the combo is in `asPlainText` mode and the input
+     * contains a *confirmed* selection (not unconfirmed typed text).
+     *
+     * In `asPlainText` mode the input IS the selection display: EUI renders
+     * the selected option's label directly in the input (no pills). An empty
+     * input means nothing is selected.
+     *
+     * When the user types text that matches no option and blurs (without
+     * `onCreateOption`), EUI marks the combo box invalid by adding
+     * `euiComboBox-isInvalid` to the root element. An invalid combo with a
+     * non-empty input has unconfirmed text, not a confirmed selection.
+     */
+    private hasConfirmedInputSelection;
+    private isMarkedInvalid;
+    private get input();
+    private get searchInput();
+    private get pills();
+    private isPlainText;
+}

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

@@ -0,0 +1,210 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License
+ * 2.0 and the Server Side Public License, v 1; you may not use this file except
+ * in compliance with, at your election, the Elastic License 2.0 or the Server
+ * Side Public License, v 1.
+ */
+import { expect } from '@playwright/test';
+import { BaseObject } from '../../base_object';
+import { EuiComboBoxSelectors } from '../../../components/combo_box/selectors';
+/**
+ * Playwright Component Object for {@link
+ * https://eui.elastic.co/docs/components/forms/selection/combo-box/ EuiComboBox}.
+ *
+ * `testSubj` must match the `data-test-subj` set by the consumer on the
+ * `<EuiComboBox>` element (the outer `.euiComboBox` wrapper, not the inner
+ * `comboBoxInput`).
+ */
+export class EuiComboBoxObject extends BaseObject {
+    /**
+     * Replace the current selection with `labels`. Set-semantics: order-
+     * independent — already-selected labels are kept, missing ones are added,
+     * extras are removed. No-op if the current selection already matches.
+     *
+     * Throws with a descriptive message if any label never appears in the
+     * dropdown (catches test/data drift early).
+     */
+    async setSelectedOptions(labels) {
+        // Dedupe while preserving order.
+        const targetLabels = [...new Set(labels)];
+        // `[...arr].sort()` (not `arr.sort()`) — sort mutates in place; the copy
+        // avoids mutating either the consumer's input or our internal state.
+        const sortedTarget = [...targetLabels].sort();
+        const sortedCurrent = [...(await this.getSelectedOptions())].sort();
+        // Set-equality short-circuit (any order).
+        if (sortedCurrent.length === sortedTarget.length &&
+            sortedCurrent.every((label, i) => label === sortedTarget[i])) {
+            return;
+        }
+        // Naive replace — clear, then add each. A diff-based approach would do
+        // less DOM work but require a per-pill remove primitive we don't ship yet.
+        await this.clear();
+        for (const label of targetLabels) {
+            await this.addOption(label);
+        }
+        if (targetLabels.length > 0) {
+            // Blur the input to close the dropdown. Using blur() rather than a
+            // keyboard event avoids bubbling Escape to page-level handlers
+            // (modal/flyout close listeners) on the consumer page.
+            await this.searchInput.blur();
+        }
+        expect([...(await this.getSelectedOptions())].sort()).toEqual(sortedTarget);
+    }
+    /**
+     * 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}
+     * - `asPlainText` with a confirmed input selection → {@link deleteSearchInput}
+     * - Otherwise → {@link deselectAllFromDropdown}
+     *
+     * Use the explicit methods directly when you need full control over the
+     * clearing strategy (e.g. `onCreateOption` with selections not in the
+     * options list).
+     */
+    async clear() {
+        if ((await this.getSelectedOptions()).length === 0) {
+            return;
+        }
+        if (await this.hasPills()) {
+            await this.clickPillClearButtons();
+            return;
+        }
+        if (await this.hasConfirmedInputSelection()) {
+            await this.deleteSearchInput();
+            return;
+        }
+        await this.deselectAllFromDropdown();
+    }
+    /**
+     * Currently selected option labels.
+     *
+     * - Multi-select / `singleSelection=true` → pill texts.
+     * - `singleSelection={{ asPlainText: true }}` → the input value. EUI
+     *   renders no pills in this mode; the input IS the selection display.
+     *   Works correctly with both `isClearable=true` (default) and
+     *   `isClearable=false`.
+     * - Nothing selected → `[]`.
+     */
+    async getSelectedOptions() {
+        if (await this.hasPills()) {
+            return this.pills.allInnerTexts();
+        }
+        if (await this.hasConfirmedInputSelection()) {
+            return [await this.searchInput.inputValue()];
+        }
+        return [];
+    }
+    async hasPills() {
+        return (await this.pills.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() {
+        while (await this.hasPills()) {
+            const countBefore = await this.pills.count();
+            await this.pills.first().locator('button').click();
+            await 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`
+     * configurations when the selected options are present in the options list.
+     *
+     * Does not work when the selection was created via `onCreateOption` and the
+     * created option was not added back to the `options` array — use
+     * {@link clickPillClearButtons} instead.
+     */
+    async deselectAllFromDropdown() {
+        await this.input.click();
+        const selected = this.root
+            .page()
+            .locator(EuiComboBoxSelectors.selectedOptionFor(this.testSubj));
+        while ((await selected.count()) > 0) {
+            const countBefore = await selected.count();
+            await selected.first().click();
+            await expect(selected).not.toHaveCount(countBefore);
+        }
+        await this.searchInput.blur();
+    }
+    async addOption(label) {
+        // Clicking the outer wrapper does not reliably open the dropdown; the
+        // inner `comboBoxInput` element does.
+        await this.input.click();
+        // Don't type to filter: EUI only sets an option's `title` while the input
+        // is empty, and the getByTitle match below relies on it. setSelectedOptions
+        // clears the selection first, so the list is unfiltered and every option
+        // renders its title.
+        //
+        // Options list is rendered in a portal outside `this.root`, so locate
+        // from page level. Use .and(getByTitle) rather than embedding the label
+        // in the CSS string — CSS attribute selectors break on labels containing
+        // quotes, brackets, or backslashes. getByTitle alone would search
+        // descendants; .and() intersects so it matches the option element itself.
+        const option = this.root
+            .page()
+            .locator(EuiComboBoxSelectors.optionFor(this.testSubj))
+            .and(this.root.page().getByTitle(label, { exact: true }));
+        await option.waitFor({ state: 'visible' });
+        await option.click();
+    }
+    /**
+     * Focuses the search input and presses Backspace to clear the selection.
+     * Only valid in `singleSelection={{ asPlainText: true }}` mode where
+     * {@link hasConfirmedInputSelection} is true — EUI's `onKeyDown` handler
+     * fires `onRemoveOption` when Backspace is pressed with an empty `searchValue`.
+     */
+    async deleteSearchInput() {
+        await this.searchInput.press('Backspace');
+        // Backspace triggers onRemoveOption (removes the selection) but the
+        // browser also fires a native input event that sets searchValue to a
+        // partial label string. fill('') cleans that up without restoring the
+        // selection (selectedOptions is already empty at this point).
+        await this.searchInput.fill('');
+        await expect(this.searchInput).toHaveValue('');
+    }
+    /**
+     * Returns true when the combo is in `asPlainText` mode and the input
+     * contains a *confirmed* selection (not unconfirmed typed text).
+     *
+     * In `asPlainText` mode the input IS the selection display: EUI renders
+     * the selected option's label directly in the input (no pills). An empty
+     * input means nothing is selected.
+     *
+     * When the user types text that matches no option and blurs (without
+     * `onCreateOption`), EUI marks the combo box invalid by adding
+     * `euiComboBox-isInvalid` to the root element. An invalid combo with a
+     * non-empty input has unconfirmed text, not a confirmed selection.
+     */
+    async hasConfirmedInputSelection() {
+        if (!(await this.isPlainText()))
+            return false;
+        if (!(await this.searchInput.inputValue()))
+            return false;
+        return !(await this.isMarkedInvalid());
+    }
+    async isMarkedInvalid() {
+        const classes = await this.root.getAttribute('class');
+        return classes?.includes('euiComboBox-isInvalid') ?? false;
+    }
+    get input() {
+        return this.root.getByTestId(EuiComboBoxSelectors.INPUT_WRAPPER_TEST_SUBJ);
+    }
+    get searchInput() {
+        return this.root.getByTestId(EuiComboBoxSelectors.SEARCH_INPUT_TEST_SUBJ);
+    }
+    get pills() {
+        return this.root.getByTestId(EuiComboBoxSelectors.PILL_TEST_SUBJ);
+    }
+    async isPlainText() {
+        return ((await this.root
+            .locator(EuiComboBoxSelectors.PLAIN_TEXT_INPUT_WRAP_SELECTOR)
+            .count()) > 0);
+    }
+}
+//# sourceMappingURL=object.js.map

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

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

package/lib/esm/selectors.d.ts

@@ -0,0 +1 @@
+export { EuiComboBoxSelectors } from './components/combo_box/selectors';

package/lib/esm/selectors.js

@@ -0,0 +1,9 @@
+/*
+ * 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.
+ */
+export { EuiComboBoxSelectors } from './components/combo_box/selectors';
+//# sourceMappingURL=selectors.js.map

package/lib/esm/selectors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"selectors.js","sourceRoot":"","sources":["../../src/selectors.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,kCAAkC,CAAC"}

package/lib/esm/storybook.d.ts

@@ -0,0 +1,7 @@
+/**
+ * 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'`)
+ */
+export declare const storyUrl: (id: string, args?: string) => string;

package/lib/esm/storybook.js

@@ -0,0 +1,15 @@
+/*
+ * 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.
+ */
+/**
+ * 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'`)
+ */
+export const storyUrl = (id, args) => `/iframe.html?id=${id}&viewMode=story${args ? `&args=${args}` : ''}`;
+//# sourceMappingURL=storybook.js.map

package/lib/esm/storybook.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storybook.js","sourceRoot":"","sources":["../../src/storybook.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;;GAKG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,EAAU,EAAE,IAAa,EAAU,EAAE,CAC5D,mBAAmB,EAAE,kBAAkB,IAAI,CAAC,CAAC,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC"}