@vitest/browser 3.0.7 → 3.0.9

package/dist/{index-fqTesRIH.js → index-DrTP5i7N.js}

@@ -22,13 +22,13 @@ function ensureAwaited(promise) {
   return {
     then(onFulfilled, onRejected) {
       awaited = true;
-      return (promiseResult ||= promise()).then(onFulfilled, onRejected);
+      return (promiseResult ||= promise(sourceError)).then(onFulfilled, onRejected);
     },
     catch(onRejected) {
-      return (promiseResult ||= promise()).catch(onRejected);
+      return (promiseResult ||= promise(sourceError)).catch(onRejected);
     },
     finally(onFinally) {
-      return (promiseResult ||= promise()).finally(onFinally);
+      return (promiseResult ||= promise(sourceError)).finally(onFinally);
     },
     [Symbol.toStringTag]: "Promise"
   };
@@ -45,74 +45,6 @@ function getWorkerState() {
   }
   return state;
 }
-// @__NO_SIDE_EFFECTS__
-function convertElementToCssSelector(element) {
-  if (!element || !(element instanceof Element)) {
-    throw new Error(
-      `Expected DOM element to be an instance of Element, received ${typeof element}`
-    );
-  }
-  return getUniqueCssSelector(element);
-}
-function escapeIdForCSSSelector(id) {
-  return id.split("").map((char) => {
-    const code = char.charCodeAt(0);
-    if (char === " " || char === "#" || char === "." || char === ":" || char === "[" || char === "]" || char === ">" || char === "+" || char === "~" || char === "\\") {
-      return `\\${char}`;
-    } else if (code >= 65536) {
-      return `\\${code.toString(16).toUpperCase().padStart(6, "0")} `;
-    } else if (code < 32 || code === 127) {
-      return `\\${code.toString(16).toUpperCase().padStart(2, "0")} `;
-    } else if (code >= 128) {
-      return `\\${code.toString(16).toUpperCase().padStart(2, "0")} `;
-    } else {
-      return char;
-    }
-  }).join("");
-}
-function getUniqueCssSelector(el) {
-  const path = [];
-  let parent;
-  let hasShadowRoot = false;
-  while (parent = getParent(el)) {
-    if (parent.shadowRoot) {
-      hasShadowRoot = true;
-    }
-    const tag = el.tagName;
-    if (el.id) {
-      path.push(`#${escapeIdForCSSSelector(el.id)}`);
-    } else if (!el.nextElementSibling && !el.previousElementSibling) {
-      path.push(tag.toLowerCase());
-    } else {
-      let index = 0;
-      let sameTagSiblings = 0;
-      let elementIndex = 0;
-      for (const sibling of parent.children) {
-        index++;
-        if (sibling.tagName === tag) {
-          sameTagSiblings++;
-        }
-        if (sibling === el) {
-          elementIndex = index;
-        }
-      }
-      if (sameTagSiblings > 1) {
-        path.push(`${tag.toLowerCase()}:nth-child(${elementIndex})`);
-      } else {
-        path.push(tag.toLowerCase());
-      }
-    }
-    el = parent;
-  }
-  return `${(/* @__PURE__ */ getBrowserState()).provider === "webdriverio" && hasShadowRoot ? ">>>" : ""}${path.reverse().join(" > ")}`;
-}
-function getParent(el) {
-  const parent = el.parentNode;
-  if (parent instanceof ShadowRoot) {
-    return parent.host;
-  }
-  return parent;
-}
 
 const selectorEngine = Ivya.create({
   browser: ((name) => {
@@ -141,8 +73,8 @@ class Locator {
   tripleClick(options = {}) {
     return this.triggerCommand("__vitest_tripleClick", this.selector, options);
   }
-  clear() {
-    return this.triggerCommand("__vitest_clear", this.selector);
+  clear(options) {
+    return this.triggerCommand("__vitest_clear", this.selector, options);
   }
   hover(options) {
     return this.triggerCommand("__vitest_hover", this.selector, options);
@@ -153,7 +85,7 @@ class Locator {
   fill(text, options) {
     return this.triggerCommand("__vitest_fill", this.selector, text, options);
   }
-  async upload(files) {
+  async upload(files, options) {
     const filesPromise = (Array.isArray(files) ? files : [files]).map(async (file) => {
       if (typeof file === "string") {
         return file;
@@ -170,7 +102,7 @@ class Locator {
         base64: bas64String
       };
     });
-    return this.triggerCommand("__vitest_upload", this.selector, await Promise.all(filesPromise));
+    return this.triggerCommand("__vitest_upload", this.selector, await Promise.all(filesPromise), options);
   }
   dropTo(target, options = {}) {
     return this.triggerCommand(
@@ -180,7 +112,7 @@ class Locator {
       options
     );
   }
-  selectOptions(value) {
+  selectOptions(value, options) {
     const values = (Array.isArray(value) ? value : [value]).map((v) => {
       if (typeof v !== "string") {
         const selector = "element" in v ? v.selector : selectorEngine.generateSelectorSimple(v);
@@ -188,7 +120,7 @@ class Locator {
       }
       return v;
     });
-    return this.triggerCommand("__vitest_selectOptions", this.selector, values);
+    return this.triggerCommand("__vitest_selectOptions", this.selector, values, options);
   }
   screenshot(options) {
     return page.screenshot({
@@ -252,11 +184,12 @@ class Locator {
   }
   triggerCommand(command, ...args) {
     const commands = getBrowserState().commands;
-    return ensureAwaited(() => commands.triggerCommand(
+    return ensureAwaited((error) => commands.triggerCommand(
       command,
-      args
+      args,
+      error
     ));
   }
 }
 
-export { Locator as L, convertElementToCssSelector as c, selectorEngine as s };
+export { Locator as L, getWorkerState as a, getBrowserState as g, selectorEngine as s };

package/dist/index.d.ts

@@ -1,8 +1,8 @@
 import { Plugin } from 'vitest/config';
 import { CDPSession, BrowserServerState as BrowserServerState$1, ProjectBrowser as ProjectBrowser$1, TestProject, BrowserProvider, Vitest, ResolvedConfig, Vite, BrowserCommand, BrowserScript, ProcessPool } from 'vitest/node';
+import { StackTraceParserOptions } from '@vitest/utils/source-map';
 import { ViteDevServer, HtmlTagDescriptor } from 'vite';
 import { CancelReason, RunnerTestFile, AfterSuiteRunMeta, UserConsoleLog, SnapshotResult, SerializedConfig, ErrorWithDiff, ParsedStack } from 'vitest';
-import { StackTraceParserOptions } from '@vitest/utils/source-map';
 import { ServerIdResolution, ServerMockResolution } from '@vitest/mocker/node';
 import { TaskResultPack, TaskEventPack } from '@vitest/runner';
 
@@ -23,123 +23,125 @@ type BirpcReturn<RemoteFunctions, LocalFunctions = Record<string, never>> = {
 };
 
 interface WebSocketBrowserHandlers {
-    resolveSnapshotPath: (testPath: string) => string;
-    resolveSnapshotRawPath: (testPath: string, rawPath: string) => string;
-    onUnhandledError: (error: unknown, type: string) => Promise<void>;
-    onQueued: (file: RunnerTestFile) => void;
-    onCollected: (files: RunnerTestFile[]) => Promise<void>;
-    onTaskUpdate: (packs: TaskResultPack[], events: TaskEventPack[]) => void;
-    onAfterSuiteRun: (meta: AfterSuiteRunMeta) => void;
-    onCancel: (reason: CancelReason) => void;
-    getCountOfFailedTests: () => number;
-    readSnapshotFile: (id: string) => Promise<string | null>;
-    saveSnapshotFile: (id: string, content: string) => Promise<void>;
-    removeSnapshotFile: (id: string) => Promise<void>;
-    sendLog: (log: UserConsoleLog) => void;
-    finishBrowserTests: (sessionId: string) => void;
-    snapshotSaved: (snapshot: SnapshotResult) => void;
-    debug: (...args: string[]) => void;
-    resolveId: (id: string, importer?: string) => Promise<ServerIdResolution | null>;
-    triggerCommand: <T>(sessionId: string, command: string, testPath: string | undefined, payload: unknown[]) => Promise<T>;
-    resolveMock: (id: string, importer: string, options: {
-        mock: 'spy' | 'factory' | 'auto';
-    }) => Promise<ServerMockResolution>;
-    invalidate: (ids: string[]) => void;
-    getBrowserFileSourceMap: (id: string) => SourceMap | null | {
-        mappings: '';
-    } | undefined;
-    wdioSwitchContext: (direction: 'iframe' | 'parent') => void;
-    sendCdpEvent: (sessionId: string, event: string, payload?: Record<string, unknown>) => unknown;
-    trackCdpEvent: (sessionId: string, type: 'on' | 'once' | 'off', event: string, listenerId: string) => void;
+	resolveSnapshotPath: (testPath: string) => string;
+	resolveSnapshotRawPath: (testPath: string, rawPath: string) => string;
+	onUnhandledError: (error: unknown, type: string) => Promise<void>;
+	onQueued: (file: RunnerTestFile) => void;
+	onCollected: (files: RunnerTestFile[]) => Promise<void>;
+	onTaskUpdate: (packs: TaskResultPack[], events: TaskEventPack[]) => void;
+	onAfterSuiteRun: (meta: AfterSuiteRunMeta) => void;
+	onCancel: (reason: CancelReason) => void;
+	getCountOfFailedTests: () => number;
+	readSnapshotFile: (id: string) => Promise<string | null>;
+	saveSnapshotFile: (id: string, content: string) => Promise<void>;
+	removeSnapshotFile: (id: string) => Promise<void>;
+	sendLog: (log: UserConsoleLog) => void;
+	finishBrowserTests: (sessionId: string) => void;
+	snapshotSaved: (snapshot: SnapshotResult) => void;
+	debug: (...args: string[]) => void;
+	resolveId: (id: string, importer?: string) => Promise<ServerIdResolution | null>;
+	triggerCommand: <T>(sessionId: string, command: string, testPath: string | undefined, payload: unknown[]) => Promise<T>;
+	resolveMock: (id: string, importer: string, options: {
+		mock: "spy" | "factory" | "auto"
+	}) => Promise<ServerMockResolution>;
+	invalidate: (ids: string[]) => void;
+	getBrowserFileSourceMap: (id: string) => SourceMap | null | {
+		mappings: ""
+	} | undefined;
+	wdioSwitchContext: (direction: "iframe" | "parent") => void;
+	sendCdpEvent: (sessionId: string, event: string, payload?: Record<string, unknown>) => unknown;
+	trackCdpEvent: (sessionId: string, type: "on" | "once" | "off", event: string, listenerId: string) => void;
 }
 interface WebSocketBrowserEvents {
-    onCancel: (reason: CancelReason) => void;
-    createTesters: (files: string[]) => Promise<void>;
-    cdpEvent: (event: string, payload: unknown) => void;
+	onCancel: (reason: CancelReason) => void;
+	createTesters: (files: string[]) => Promise<void>;
+	cdpEvent: (event: string, payload: unknown) => void;
 }
 type WebSocketBrowserRPC = BirpcReturn<WebSocketBrowserEvents, WebSocketBrowserHandlers>;
 interface SourceMap {
-    file: string;
-    mappings: string;
-    names: string[];
-    sources: string[];
-    sourcesContent?: string[];
-    version: number;
-    toString: () => string;
-    toUrl: () => string;
+	file: string;
+	mappings: string;
+	names: string[];
+	sources: string[];
+	sourcesContent?: string[];
+	version: number;
+	toString: () => string;
+	toUrl: () => string;
 }
 
 declare class BrowserServerCDPHandler {
-    private session;
-    private tester;
-    private listenerIds;
-    private listeners;
-    constructor(session: CDPSession, tester: WebSocketBrowserRPC);
-    send(method: string, params?: Record<string, unknown>): Promise<unknown>;
-    on(event: string, id: string, once?: boolean): void;
-    off(event: string, id: string): void;
-    once(event: string, listener: string): void;
+	private session;
+	private tester;
+	private listenerIds;
+	private listeners;
+	constructor(session: CDPSession, tester: WebSocketBrowserRPC);
+	send(method: string, params?: Record<string, unknown>): Promise<unknown>;
+	on(event: string, id: string, once?: boolean): void;
+	off(event: string, id: string): void;
+	once(event: string, listener: string): void;
 }
 
 declare class BrowserServerState implements BrowserServerState$1 {
-    readonly orchestrators: Map<string, WebSocketBrowserRPC>;
-    readonly testers: Map<string, WebSocketBrowserRPC>;
+	readonly orchestrators: Map<string, WebSocketBrowserRPC>;
+	readonly testers: Map<string, WebSocketBrowserRPC>;
 }
 
 declare class ProjectBrowser implements ProjectBrowser$1 {
-    project: TestProject;
-    base: string;
-    testerHtml: Promise<string> | string;
-    testerFilepath: string;
-    locatorsUrl: string | undefined;
-    provider: BrowserProvider;
-    vitest: Vitest;
-    config: ResolvedConfig;
-    children: Set<ProjectBrowser>;
-    parent: ParentBrowserProject;
-    state: BrowserServerState;
-    constructor(project: TestProject, base: string);
-    get vite(): ViteDevServer;
-    wrapSerializedConfig(): SerializedConfig;
-    initBrowserProvider(project: TestProject): Promise<void>;
-    parseErrorStacktrace(e: ErrorWithDiff, options?: StackTraceParserOptions): ParsedStack[];
-    parseStacktrace(trace: string, options?: StackTraceParserOptions): ParsedStack[];
-    close(): Promise<void>;
+	project: TestProject;
+	base: string;
+	testerHtml: Promise<string> | string;
+	testerFilepath: string;
+	locatorsUrl: string | undefined;
+	provider: BrowserProvider;
+	vitest: Vitest;
+	config: ResolvedConfig;
+	children: Set<ProjectBrowser>;
+	parent: ParentBrowserProject;
+	state: BrowserServerState;
+	constructor(project: TestProject, base: string);
+	get vite(): ViteDevServer;
+	wrapSerializedConfig(): SerializedConfig;
+	initBrowserProvider(project: TestProject): Promise<void>;
+	parseErrorStacktrace(e: ErrorWithDiff, options?: StackTraceParserOptions): ParsedStack[];
+	parseStacktrace(trace: string, options?: StackTraceParserOptions): ParsedStack[];
+	close(): Promise<void>;
 }
 
 declare class ParentBrowserProject {
-    project: TestProject;
-    base: string;
-    orchestratorScripts: string | undefined;
-    testerScripts: HtmlTagDescriptor[] | undefined;
-    faviconUrl: string;
-    prefixTesterUrl: string;
-    manifest: Promise<Vite.Manifest> | Vite.Manifest;
-    vite: Vite.ViteDevServer;
-    private stackTraceOptions;
-    orchestratorHtml: Promise<string> | string;
-    injectorJs: Promise<string> | string;
-    errorCatcherUrl: string;
-    locatorsUrl: string | undefined;
-    stateJs: Promise<string> | string;
-    commands: Record<string, BrowserCommand<any>>;
-    children: Set<ProjectBrowser>;
-    vitest: Vitest;
-    config: ResolvedConfig;
-    constructor(project: TestProject, base: string);
-    setServer(vite: Vite.ViteDevServer): void;
-    spawn(project: TestProject): ProjectBrowser;
-    parseErrorStacktrace(e: ErrorWithDiff, options?: StackTraceParserOptions): ParsedStack[];
-    parseStacktrace(trace: string, options?: StackTraceParserOptions): ParsedStack[];
-    readonly cdps: Map<string, BrowserServerCDPHandler>;
-    private cdpSessionsPromises;
-    ensureCDPHandler(sessionId: string, rpcId: string): Promise<BrowserServerCDPHandler>;
-    removeCDPHandler(sessionId: string): void;
-    formatScripts(scripts: BrowserScript[] | undefined): Promise<HtmlTagDescriptor[]>;
-    resolveTesterUrl(pathname: string): {
-        sessionId: string;
-        testFile: string;
-    };
+	project: TestProject;
+	base: string;
+	orchestratorScripts: string | undefined;
+	testerScripts: HtmlTagDescriptor[] | undefined;
+	faviconUrl: string;
+	prefixTesterUrl: string;
+	manifest: Promise<Vite.Manifest> | Vite.Manifest;
+	vite: Vite.ViteDevServer;
+	private stackTraceOptions;
+	orchestratorHtml: Promise<string> | string;
+	injectorJs: Promise<string> | string;
+	errorCatcherUrl: string;
+	locatorsUrl: string | undefined;
+	stateJs: Promise<string> | string;
+	commands: Record<string, BrowserCommand<any>>;
+	children: Set<ProjectBrowser>;
+	vitest: Vitest;
+	config: ResolvedConfig;
+	private sourceMapCache;
+	constructor(project: TestProject, base: string);
+	setServer(vite: Vite.ViteDevServer): void;
+	spawn(project: TestProject): ProjectBrowser;
+	parseErrorStacktrace(e: ErrorWithDiff, options?: StackTraceParserOptions): ParsedStack[];
+	parseStacktrace(trace: string, options?: StackTraceParserOptions): ParsedStack[];
+	readonly cdps: Map<string, BrowserServerCDPHandler>;
+	private cdpSessionsPromises;
+	ensureCDPHandler(sessionId: string, rpcId: string): Promise<BrowserServerCDPHandler>;
+	removeCDPHandler(sessionId: string): void;
+	formatScripts(scripts: BrowserScript[] | undefined): Promise<HtmlTagDescriptor[]>;
+	resolveTesterUrl(pathname: string): {
+		sessionId: string
+		testFile: string
+	};
+	private retrieveSourceMapURL;
 }
 
 declare const distRoot: string;

package/dist/index.js

@@ -16,7 +16,7 @@ import { resolve as resolve$1, dirname as dirname$1, basename as basename$1, nor
 import { WebSocketServer } from 'ws';
 import * as nodeos from 'node:os';
 
-var version = "3.0.7";
+var version = "3.0.9";
 
 const _DRIVE_LETTER_START_RE = /^[A-Za-z]:\//;
 function normalizeWindowsPath(input = "") {
@@ -1192,7 +1192,7 @@ const tripleClick = async (context, selector, options = {}) => {
     });
   } else if (provider instanceof WebdriverBrowserProvider) {
     const browser = context.browser;
-    await browser.action("pointer", { parameters: { pointerType: "mouse" } }).move({ origin: await browser.$(selector) }).down().up().pause(50).down().up().pause(50).down().up().pause(50).perform();
+    await browser.action("pointer", { parameters: { pointerType: "mouse" } }).move({ origin: browser.$(selector) }).down().up().pause(50).down().up().pause(50).down().up().pause(50).perform();
   } else {
     throw new TypeError(`Provider "${provider.name}" doesn't support tripleClick command`);
   }
@@ -1226,7 +1226,7 @@ const fill = async (context, selector, text, options = {}) => {
     const browser = context.browser;
     await browser.$(selector).setValue(text);
   } else {
-    throw new TypeError(`Provider "${context.provider.name}" does not support clearing elements`);
+    throw new TypeError(`Provider "${context.provider.name}" does not support filling inputs`);
   }
 };
 
@@ -2166,7 +2166,7 @@ function focusIframe() {
 }
 function selectAll() {
   const element = document.activeElement;
-  if (element && element.select) {
+  if (element && typeof element.select === "function") {
     element.select();
   }
 }
@@ -2312,7 +2312,7 @@ const type = async (context, selector, text, options = {}) => {
       text,
       () => browser.execute(() => {
         const element2 = document.activeElement;
-        if (element2) {
+        if (element2 && typeof element2.select === "function") {
           element2.select();
         }
       }),
@@ -2476,17 +2476,36 @@ class ParentBrowserProject {
     this.stackTraceOptions = {
       frameFilter: project.config.onStackTrace,
       getSourceMap: (id) => {
+        if (this.sourceMapCache.has(id)) {
+          return this.sourceMapCache.get(id);
+        }
         const result = this.vite.moduleGraph.getModuleById(id)?.transformResult;
+        if (result && !result.map) {
+          const sourceMapUrl = this.retrieveSourceMapURL(result.code);
+          if (!sourceMapUrl) {
+            return null;
+          }
+          const filepathDir = dirname(id);
+          const sourceMapPath = resolve(filepathDir, sourceMapUrl);
+          const map = JSON.parse(readFileSync(sourceMapPath, "utf-8"));
+          this.sourceMapCache.set(id, map);
+          return map;
+        }
         return result?.map;
       },
-      getFileName: (id) => {
+      getUrlId: (id) => {
         const mod = this.vite.moduleGraph.getModuleById(id);
-        if (mod?.file) {
-          return mod.file;
+        if (mod) {
+          return id;
         }
-        const modUrl = this.vite.moduleGraph.urlToModuleMap.get(id);
-        if (modUrl?.file) {
-          return modUrl.file;
+        const resolvedPath = resolve(project.config.root, id.slice(1));
+        const modUrl = this.vite.moduleGraph.getModuleById(resolvedPath);
+        if (modUrl) {
+          return resolvedPath;
+        }
+        const files = this.vite.moduleGraph.getModulesByFile(resolvedPath);
+        if (files && files.size) {
+          return files.values().next().value.id;
         }
         return id;
       }
@@ -2541,6 +2560,8 @@ class ParentBrowserProject {
   children = /* @__PURE__ */ new Set();
   vitest;
   config;
+  // cache for non-vite source maps
+  sourceMapCache = /* @__PURE__ */ new Map();
   setServer(vite) {
     this.vite = vite;
   }
@@ -2641,6 +2662,17 @@ class ParentBrowserProject {
     const decodedTestFile = decodeURIComponent(testFile);
     return { sessionId, testFile: decodedTestFile };
   }
+  retrieveSourceMapURL(source) {
+    const re = /\/\/[@#]\s*sourceMappingURL=([^\s'"]+)\s*$|\/\*[@#]\s*sourceMappingURL=[^\s*'"]+\s*\*\/\s*$/gm;
+    let lastMatch, match;
+    while (match = re.exec(source)) {
+      lastMatch = match;
+    }
+    if (!lastMatch) {
+      return null;
+    }
+    return lastMatch[1];
+  }
 }
 
 const DEFAULT_TIMEOUT = 6e4;

package/dist/locators/index.d.ts

@@ -1,4 +1,4 @@
-import { UserEventClickOptions, UserEventHoverOptions, UserEventFillOptions, UserEventDragAndDropOptions, LocatorScreenshotOptions, LocatorByRoleOptions, LocatorOptions } from '@vitest/browser/context';
+import { UserEventClickOptions, UserEventClearOptions, UserEventHoverOptions, UserEventFillOptions, UserEventUploadOptions, UserEventDragAndDropOptions, UserEventSelectOptions, LocatorScreenshotOptions, LocatorByRoleOptions, LocatorOptions } from '@vitest/browser/context';
 
 type ClauseCombinator = '' | '>' | '+' | '~' | '>=';
 type CSSFunctionArgument = CSSComplexSelector | number | string;
@@ -219,46 +219,46 @@ interface SelectorEngine {
 
 declare const selectorEngine: Ivya;
 declare abstract class Locator {
-    abstract selector: string;
-    private _parsedSelector;
-    protected _container?: Element | undefined;
-    protected _pwSelector?: string | undefined;
-    click(options?: UserEventClickOptions): Promise<void>;
-    dblClick(options?: UserEventClickOptions): Promise<void>;
-    tripleClick(options?: UserEventClickOptions): Promise<void>;
-    clear(): Promise<void>;
-    hover(options: UserEventHoverOptions): Promise<void>;
-    unhover(options: UserEventHoverOptions): Promise<void>;
-    fill(text: string, options?: UserEventFillOptions): Promise<void>;
-    upload(files: string | string[] | File | File[]): Promise<void>;
-    dropTo(target: Locator, options?: UserEventDragAndDropOptions): Promise<void>;
-    selectOptions(value: HTMLElement | HTMLElement[] | Locator | Locator[] | string | string[]): Promise<void>;
-    screenshot(options: Omit<LocatorScreenshotOptions, 'base64'> & {
-        base64: true;
-    }): Promise<{
-        path: string;
-        base64: string;
-    }>;
-    screenshot(options?: LocatorScreenshotOptions): Promise<string>;
-    protected abstract locator(selector: string): Locator;
-    protected abstract elementLocator(element: Element): Locator;
-    getByRole(role: string, options?: LocatorByRoleOptions): Locator;
-    getByAltText(text: string | RegExp, options?: LocatorOptions): Locator;
-    getByLabelText(text: string | RegExp, options?: LocatorOptions): Locator;
-    getByPlaceholder(text: string | RegExp, options?: LocatorOptions): Locator;
-    getByTestId(testId: string | RegExp): Locator;
-    getByText(text: string | RegExp, options?: LocatorOptions): Locator;
-    getByTitle(title: string | RegExp, options?: LocatorOptions): Locator;
-    query(): Element | null;
-    element(): Element;
-    elements(): Element[];
-    all(): Locator[];
-    nth(index: number): Locator;
-    first(): Locator;
-    last(): Locator;
-    toString(): string;
-    toJSON(): string;
-    protected triggerCommand<T>(command: string, ...args: any[]): Promise<T>;
+	abstract selector: string;
+	private _parsedSelector;
+	protected _container?: Element | undefined;
+	protected _pwSelector?: string | undefined;
+	click(options?: UserEventClickOptions): Promise<void>;
+	dblClick(options?: UserEventClickOptions): Promise<void>;
+	tripleClick(options?: UserEventClickOptions): Promise<void>;
+	clear(options?: UserEventClearOptions): Promise<void>;
+	hover(options?: UserEventHoverOptions): Promise<void>;
+	unhover(options?: UserEventHoverOptions): Promise<void>;
+	fill(text: string, options?: UserEventFillOptions): Promise<void>;
+	upload(files: string | string[] | File | File[], options?: UserEventUploadOptions): Promise<void>;
+	dropTo(target: Locator, options?: UserEventDragAndDropOptions): Promise<void>;
+	selectOptions(value: HTMLElement | HTMLElement[] | Locator | Locator[] | string | string[], options?: UserEventSelectOptions): Promise<void>;
+	screenshot(options: Omit<LocatorScreenshotOptions, "base64"> & {
+		base64: true
+	}): Promise<{
+		path: string
+		base64: string
+	}>;
+	screenshot(options?: LocatorScreenshotOptions): Promise<string>;
+	protected abstract locator(selector: string): Locator;
+	protected abstract elementLocator(element: Element): Locator;
+	getByRole(role: string, options?: LocatorByRoleOptions): Locator;
+	getByAltText(text: string | RegExp, options?: LocatorOptions): Locator;
+	getByLabelText(text: string | RegExp, options?: LocatorOptions): Locator;
+	getByPlaceholder(text: string | RegExp, options?: LocatorOptions): Locator;
+	getByTestId(testId: string | RegExp): Locator;
+	getByText(text: string | RegExp, options?: LocatorOptions): Locator;
+	getByTitle(title: string | RegExp, options?: LocatorOptions): Locator;
+	query(): Element | null;
+	element(): Element;
+	elements(): Element[];
+	all(): Locator[];
+	nth(index: number): Locator;
+	first(): Locator;
+	last(): Locator;
+	toString(): string;
+	toJSON(): string;
+	protected triggerCommand<T>(command: string, ...args: any[]): Promise<T>;
 }
 
 export { Locator, selectorEngine };

package/dist/locators/index.js

@@ -1,4 +1,4 @@
 import '@vitest/browser/context';
 import '../public-utils-J4vwTaki.js';
-export { L as Locator, s as selectorEngine } from '../index-fqTesRIH.js';
+export { L as Locator, s as selectorEngine } from '../index-DrTP5i7N.js';
 import 'vitest/utils';