@elastic/eui-test-helpers 1.1.0-snapshot.1783939453438

package/package.json

@@ -0,0 +1,62 @@
+{
+  "name": "@elastic/eui-test-helpers",
+  "version": "1.1.0-snapshot.1783939453438",
+  "description": "A library of EUI test helpers for RTL, Cypress and Scout",
+  "license": "SEE LICENSE IN LICENSE.txt",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/elastic/eui.git",
+    "directory": "packages/test-helpers"
+  },
+  "homepage": "https://github.com/elastic/eui/blob/main/packages/test-helpers",
+  "main": "lib/cjs/index.js",
+  "module": "lib/esm/index.js",
+  "types": "lib/cjs/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/cjs/index.d.ts",
+      "import": "./lib/esm/index.js",
+      "require": "./lib/cjs/index.js",
+      "default": "./lib/cjs/index.js"
+    }
+  },
+  "scripts": {
+    "lint": "tsc --noEmit",
+    "test": "yarn lint && yarn test-e2e",
+    "test-e2e": "playwright test",
+    "show-report": "playwright show-report",
+    "build": "yarn build:clean && yarn build:compile && yarn build:compile:esm && yarn build:types",
+    "build:clean": "rimraf lib/",
+    "build:compile": "NODE_ENV=production babel src --out-dir=lib/cjs --extensions .ts --ignore \"**/*.spec.ts\"",
+    "build:compile:esm": "tsc --project ./tsconfig.esm.json",
+    "build:types": "NODE_ENV=production tsc --project tsconfig.types.json"
+  },
+  "peerDependencies": {
+    "@playwright/test": "^1.50.0"
+  },
+  "peerDependenciesMeta": {
+    "@playwright/test": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@babel/cli": "^7.26.4",
+    "@babel/core": "^7.26.9",
+    "@babel/preset-env": "^7.26.9",
+    "@babel/preset-typescript": "^7.26.0",
+    "@playwright/test": "1.59.1",
+    "http-server": "^14.1.1",
+    "rimraf": "^6.0.1",
+    "typescript": "^5.7.3"
+  },
+  "files": [
+    "lib",
+    "!**/*.tsbuildinfo",
+    "!**/*.spec.js",
+    "!**/*.spec.d.ts",
+    "!**/*.spec.js.map",
+    "README.md",
+    "licenses"
+  ],
+  "stableVersion": "1.1.0"
+}

package/src/components/combo_box/README.md

@@ -0,0 +1,29 @@
+# EuiComboBoxObject
+
+Playwright Component Object for [EuiComboBox](https://eui.elastic.co/docs/components/forms/selection/combo-box/).
+
+## Usage
+
+```ts
+import { EuiComboBoxObject } from '@elastic/eui-test-helpers';
+
+const comboBox = new EuiComboBoxObject(page, 'myComboBox');
+await comboBox.setSelectedOptions(['Option A', 'Option B']);
+expect(await comboBox.getSelectedOptions()).toEqual(['Option A', 'Option B']);
+```
+
+Set `data-test-subj` on the outer `<EuiComboBox>` wrapper (`.euiComboBox`), not on the inner `comboBoxInput`.
+
+## API
+
+EuiComboBox has two selection modes that affect how the methods behave:
+
+- **Pill mode** — `singleSelection={false}` (default) or `singleSelection={true}`: selected options render as pill elements.
+- **Plain-text mode** — `singleSelection={{ asPlainText: true }}`: the selected option's label appears directly in the search input.
+
+| Method | Description |
+|---|---|
+| `getSelectedOptions()` | Returns selected options as `string[]` of labels. |
+| `setSelectedOptions(labels)` | Accepts an array of label strings. Replaces any existing selection. No-op if already matching. |
+| `clear()` | Clears all selected options. No-op if nothing is selected. |
+