@testspectra/matchers 1.2.8 → 1.2.10

package/dist/types.d.ts

@@ -11,13 +11,20 @@ export type AssertionKey = 'elementDisplayed' | 'elementNotDisplayed' | 'element
 /**
  * Supported keyboard key names for `Spectra.pressKey(key)`.
  *
+ * Named special keys are emulated for real on every platform (Backspace deletes, Enter submits):
+ * natively on Android via keycodes, via user-event in component tests, via CDP
+ * `Input.dispatchKeyEvent` in web E2E. Single characters (including Space) keep the legacy
+ * synthetic keydown/keyup — several components consume characters through custom keydown
+ * handlers that would double-enter under genuine text insertion. Anything else (chords like
+ * `Control+a`, raw numbers) is a web-only best effort and must not be relied on cross-platform.
+ *
  * @example
  * ```ts
  * await Spectra.pressKey("Enter");
  * await Spectra.pressKey("Tab");
  * ```
  */
-export type KeyOption = 'Enter' | 'Tab' | 'Escape' | 'Backspace' | 'Delete' | 'ArrowUp' | 'ArrowDown' | 'ArrowLeft' | 'ArrowRight' | 'Space';
+export type KeyOption = 'Enter' | 'Tab' | 'Escape' | 'Backspace' | 'Delete' | 'ArrowUp' | 'ArrowDown' | 'ArrowLeft' | 'ArrowRight' | 'Space' | 'Home' | 'End' | 'PageUp' | 'PageDown';
 /**
  * Cardinal directions for gestures such as swipe and scroll.
  */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@testspectra/matchers",
-  "version": "1.2.8",
+  "version": "1.2.10",
   "description": "Canonical TypeScript contracts and ambient type definitions for TestSpectra",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/src/types.ts

@@ -73,6 +73,13 @@ export type AssertionKey =
 /**
  * Supported keyboard key names for `Spectra.pressKey(key)`.
  *
+ * Named special keys are emulated for real on every platform (Backspace deletes, Enter submits):
+ * natively on Android via keycodes, via user-event in component tests, via CDP
+ * `Input.dispatchKeyEvent` in web E2E. Single characters (including Space) keep the legacy
+ * synthetic keydown/keyup — several components consume characters through custom keydown
+ * handlers that would double-enter under genuine text insertion. Anything else (chords like
+ * `Control+a`, raw numbers) is a web-only best effort and must not be relied on cross-platform.
+ *
  * @example
  * ```ts
  * await Spectra.pressKey("Enter");
@@ -89,7 +96,11 @@ export type KeyOption =
   | 'ArrowDown'
   | 'ArrowLeft'
   | 'ArrowRight'
-  | 'Space';
+  | 'Space'
+  | 'Home'
+  | 'End'
+  | 'PageUp'
+  | 'PageDown';
 
 /**
  * Cardinal directions for gestures such as swipe and scroll.