craftdriver 1.7.0 → 1.9.0

package/dist/lib/locator.d.ts

@@ -1,119 +1,86 @@
 import { By } from './by.js';
 import type { Driver } from './driver.js';
-import { ElementHandle, type ContextSwitcher } from './elementHandle.js';
+import { ElementHandle } from './elementHandle.js';
 import type { ExpectApi } from './expect.js';
 import { A11y } from './a11y.js';
+import { QueryEnvironment, type ContextSwitcher, type LocatorPlan, type QueryBiDiProvider } from './query.js';
+import { ShadowRootLocator } from './shadowRootLocator.js';
 export interface ActionOptions {
     timeout?: number;
 }
 export declare class Locator {
     private driver;
-    private by;
     private getDefaultTimeout;
-    private _index;
-    private _filterText;
-    private _filterHas;
-    private _parent;
-    private _contextSwitcher?;
-    constructor(driver: Driver, by: By, getDefaultTimeout?: () => number);
-    /** Bind this locator to a browsing context (iframe/tab) for frame-scoped element resolution. */
+    private plan;
+    private environment;
+    constructor(driver: Driver, by: By, getDefaultTimeout?: () => number, environment?: QueryEnvironment, plan?: LocatorPlan);
+    /** Internal factory used by root-aware search contexts. */
+    static fromPlan(driver: Driver, plan: LocatorPlan, getDefaultTimeout: () => number, environment: QueryEnvironment): Locator;
+    /** Internal immutable snapshot for child/root/filter composition. */
+    _queryPlan(): LocatorPlan;
+    /** Internal shared query environment for child/root composition. */
+    _queryEnvironment(): QueryEnvironment;
+    /** Bind this locator to a browsing context (iframe/tab). */
     withContext(switcher: ContextSwitcher): this;
+    /** Bind this locator to a live BiDi context provider. */
+    withBiDi(provider: QueryBiDiProvider): this;
     private _withContext;
-    /** Return a new child Locator whose search is scoped within this locator's first match. */
+    /** Return a new child Locator scoped within this locator's first match. */
     locator(selector: string | By): Locator;
-    /** Return a child Locator matching a descendant by ARIA role, scoped within this locator's first match. */
+    /** Cross the explicit open Shadow DOM boundary exposed by the current host. */
+    shadowRoot(): ShadowRootLocator;
     getByRole(role: string, opts?: {
         name?: string;
         exact?: boolean;
         includeHidden?: boolean;
     }): Locator;
-    /** Return a child Locator matching a descendant by visible text, scoped within this locator's first match. */
     getByText(text: string, opts?: {
         exact?: boolean;
     }): Locator;
-    /** Return a child Locator matching a descendant by associated label, scoped within this locator's first match. */
     getByLabel(text: string, opts?: {
         exact?: boolean;
     }): Locator;
-    /** Return a child Locator matching a descendant by placeholder text, scoped within this locator's first match. */
     getByPlaceholder(text: string, opts?: {
         exact?: boolean;
     }): Locator;
-    /** Return a child Locator matching a descendant by alt text, scoped within this locator's first match. */
     getByAltText(text: string, opts?: {
         exact?: boolean;
     }): Locator;
-    /** Return a child Locator matching a descendant by title attribute, scoped within this locator's first match. */
     getByTitle(text: string, opts?: {
         exact?: boolean;
     }): Locator;
-    /** Return a child Locator matching a descendant by data-testid, scoped within this locator's first match. */
     getByTestId(id: string): Locator;
-    /** Return a new Locator targeting the element at position `index` (0-based). */
     nth(index: number): Locator;
-    /** Return a new Locator targeting the first match. */
     first(): Locator;
-    /** Return a new Locator targeting the last match. */
     last(): Locator;
-    /** Return a new Locator that narrows matches by text or child-locator presence. */
     filter(opts: {
         hasText?: string | RegExp;
         has?: Locator;
     }): Locator;
     private _clone;
-    /** Resolve all raw WebElements for this.by, scoped to the parent if set. */
-    private _findRaw;
-    /** Apply text / has filters to the raw result set. */
-    private _findFiltered;
-    /** Apply index on top of the filtered result set. */
+    private _target;
     private _findFinal;
-    /** Poll until a visible element is available in the final result set. */
+    private _selectorDetail;
     private _waitForVisible;
-    /** Poll until any element is present in the final result set (need not be visible). */
     private _waitForAny;
     private _resolve;
-    /** Resolve the current final match once without waiting. */
     private _resolveOnce;
     private _resolveExisting;
-    /**
-     * Resolve to a visible element WITHOUT applying context switching (used inside _withContext blocks).
-     * The caller is responsible for switching context before calling this.
-     */
-    private _waitForVisibleOrSimple;
-    /**
-     * Resolve to an existing element WITHOUT applying context switching (used inside _withContext blocks).
-     * The caller is responsible for switching context before calling this.
-     */
-    private _waitForAnyOrSimple;
     click(options?: ActionOptions): Promise<void>;
     fill(text: string, options?: ActionOptions): Promise<void>;
     text(options?: ActionOptions): Promise<string>;
-    /** Alias for text(). */
     textContent(options?: ActionOptions): Promise<string>;
     isVisible(options?: ActionOptions): Promise<boolean>;
-    /**
-     * Returns the number of currently matching elements in the DOM (no auto-wait).
-     * Use `waitFor` if you need to wait for a specific count.
-     */
     count(): Promise<number>;
-    /**
-     * Returns snapshot `ElementHandle`s for all currently matching elements.
-     * Each handle is bound to the element resolved at call time.
-     */
     all(): Promise<ElementHandle[]>;
     waitFor(options: {
         state: 'attached' | 'detached' | 'visible' | 'hidden';
         timeout?: number;
     }): Promise<unknown>;
-    /** Poll until the element is detached from DOM (`detached`) or no longer visible (`hidden`). */
     private _waitForNegativeState;
-    /** Returns an assertion API scoped to this locator's selector. */
     expect(): ExpectApi;
     private _a11y?;
-    /**
-     * Accessibility audit scoped to the resolved element. Re-resolves the
-     * locator on every audit/check call.
-     */
     get a11y(): A11y;
 }
+export type { ContextSwitcher } from './query.js';
 //# sourceMappingURL=locator.d.ts.map

package/dist/lib/locator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"locator.d.ts","sourceRoot":"","sources":["../../src/lib/locator.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"locator.d.ts","sourceRoot":"","sources":["../../src/lib/locator.ts"],"names":[],"mappings":"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"}