@testspectra/matchers 1.2.4 → 1.2.5

package/dist/types.d.ts

@@ -867,6 +867,46 @@ export interface SingleElementProxy extends ElementReceiverAssertions<Promise<vo
      * @returns Promise resolving to the closest matching ancestor, or null if none found.
      */
     closest(selector: string): Promise<SingleElementProxy | null>;
+    /**
+     * Returns the direct children of this element as a collection, optionally filtered by selector.
+     *
+     * Cross-platform: uses the DOM `children` on web and the accessibility-tree child links on
+     * Android, so the same chained call works on both targets (the filter selector is expressed in
+     * each platform's own language — CSS on web, `~id`/class on Android).
+     *
+     * @param selector Optional selector each child must match to be included.
+     * @returns A collection proxy over the matching children.
+     *
+     * @example
+     * ```ts
+     * await Spectra.get('ul').children('li').shouldHaveLength(3);
+     * ```
+     */
+    children(selector?: string): CollectionProxy;
+    /**
+     * Returns the siblings of this element (same parent, excluding the element itself) as a
+     * collection, optionally filtered by selector.
+     *
+     * Cross-platform: parent's children on web, accessibility-tree siblings on Android.
+     *
+     * @param selector Optional selector each sibling must match to be included.
+     * @returns A collection proxy over the matching siblings.
+     *
+     * @example
+     * ```ts
+     * await Spectra.get('label').siblings('[data-ui-section~="field.error"]').first().shouldBeVisible();
+     * ```
+     */
+    siblings(selector?: string): CollectionProxy;
+    /**
+     * Returns the element's next sibling — or the first following sibling matching `selector` when
+     * a selector is supplied. Cross-platform: `nextElementSibling` on web, tree sibling order on
+     * Android.
+     *
+     * @param selector Optional selector the following sibling must match.
+     * @returns A proxy for the resolved sibling (fails on use when none exists).
+     */
+    next(selector?: string): SingleElementProxy;
     /**
      * Returns the inner text content of the element.
      *

package/package.json

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

package/src/types.ts

@@ -1057,6 +1057,49 @@ export interface SingleElementProxy extends ElementReceiverAssertions<Promise<vo
    */
   closest(selector: string): Promise<SingleElementProxy | null>;
 
+  /**
+   * Returns the direct children of this element as a collection, optionally filtered by selector.
+   *
+   * Cross-platform: uses the DOM `children` on web and the accessibility-tree child links on
+   * Android, so the same chained call works on both targets (the filter selector is expressed in
+   * each platform's own language — CSS on web, `~id`/class on Android).
+   *
+   * @param selector Optional selector each child must match to be included.
+   * @returns A collection proxy over the matching children.
+   *
+   * @example
+   * ```ts
+   * await Spectra.get('ul').children('li').shouldHaveLength(3);
+   * ```
+   */
+  children(selector?: string): CollectionProxy;
+
+  /**
+   * Returns the siblings of this element (same parent, excluding the element itself) as a
+   * collection, optionally filtered by selector.
+   *
+   * Cross-platform: parent's children on web, accessibility-tree siblings on Android.
+   *
+   * @param selector Optional selector each sibling must match to be included.
+   * @returns A collection proxy over the matching siblings.
+   *
+   * @example
+   * ```ts
+   * await Spectra.get('label').siblings('[data-ui-section~="field.error"]').first().shouldBeVisible();
+   * ```
+   */
+  siblings(selector?: string): CollectionProxy;
+
+  /**
+   * Returns the element's next sibling — or the first following sibling matching `selector` when
+   * a selector is supplied. Cross-platform: `nextElementSibling` on web, tree sibling order on
+   * Android.
+   *
+   * @param selector Optional selector the following sibling must match.
+   * @returns A proxy for the resolved sibling (fails on use when none exists).
+   */
+  next(selector?: string): SingleElementProxy;
+
   /**
    * Returns the inner text content of the element.
    *