effect-playwright 0.3.0 → 0.4.1

package/dist/experimental/index.d.mts

@@ -1,4 +1,4 @@
-import { A as PlaywrightError, D as PlaywrightFrameService, d as PlaywrightPageService, o as PlaywrightBrowser, s as PlaywrightBrowserService } from "../index-CA1jsZ4o.mjs";
+import { A as PlaywrightError, D as PlaywrightFrameService, d as PlaywrightPageService, o as PlaywrightBrowser, s as PlaywrightBrowserService } from "../index-COItPgGw.mjs";
 import { Context, Effect, Layer, Stream } from "effect";
 import { BrowserType, LaunchOptions } from "playwright-core";
 import { Scope as Scope$1 } from "effect/Scope";

package/dist/experimental/index.mjs

@@ -1,5 +1,5 @@
 import { t as __exportAll } from "../chunk-CfYAbeIz.mjs";
-import { n as PlaywrightBrowser, t as Playwright } from "../src-DxTog178.mjs";
+import { n as PlaywrightBrowser, t as Playwright } from "../src-BdVoZgVR.mjs";
 import { Array, Context, Effect, Layer, Stream, pipe } from "effect";
 //#region src/experimental/browser-utils.ts
 var browser_utils_exports = /* @__PURE__ */ __exportAll({
@@ -11,7 +11,7 @@ var browser_utils_exports = /* @__PURE__ */ __exportAll({
 * Returns all pages in the browser from all contexts.
 * @category util
 */
-const allPages = (browser) => Effect.all(browser.contexts().map((context) => context.pages)).pipe(Effect.map(Array.flatten));
+const allPages = (browser) => Effect.sync(() => Array.flatten(browser.contexts().map((context) => context.pages())));
 /**
 * Returns all frames in the browser from all pages in all contexts.
 * @category util
@@ -24,7 +24,7 @@ const allFrames = (browser) => allPages(browser).pipe(Effect.flatMap((pages) =>
 */
 const allFrameNavigatedEventStream = (browser) => Effect.gen(function* () {
 	const contexts = browser.contexts();
-	const currentPages = (yield* Effect.all(contexts.map((c) => c.pages)).pipe(Effect.map(Array.flatten))).map((page) => page.eventStream("framenavigated"));
+	const currentPages = Array.flatten(contexts.map((c) => c.pages())).map((page) => page.eventStream("framenavigated"));
 	const newPages = pipe(contexts.map((c) => c.eventStream("page")), Stream.mergeAll({ concurrency: "unbounded" }), Stream.flatMap((page) => page.eventStream("framenavigated"), { concurrency: "unbounded" }));
 	return Stream.mergeAll([newPages, ...currentPages], { concurrency: "unbounded" });
 }).pipe(Stream.unwrap);

package/dist/{index-CA1jsZ4o.d.mts → index-COItPgGw.d.mts}

@@ -1,8 +1,8 @@
 import { Context, Effect, Layer, Option, Scope, Stream } from "effect";
-import { Browser, BrowserContext, BrowserType, Clock, ConnectOverCDPOptions, ConsoleMessage, Dialog, Download, ElementHandle, FileChooser, Frame, JSHandle, Keyboard, Locator, Mouse, Page, Request, Response, Touchscreen, WebError, WebSocket, Worker, chromium } from "playwright-core";
+import { Browser, BrowserContext, BrowserType, Clock, ConnectOverCDPOptions, ConsoleMessage, Dialog, Download, ElementHandle, FileChooser, Frame, FrameLocator, JSHandle, Keyboard, Locator, Mouse, Page, Request, Response, Touchscreen, WebError, WebSocket, Worker, chromium } from "playwright-core";
 import { Scope as Scope$1 } from "effect/Scope";
-import * as effect_Types0 from "effect/Types";
-import * as effect_Cause0 from "effect/Cause";
+import * as _$effect_Types0 from "effect/Types";
+import * as _$effect_Cause0 from "effect/Cause";
 
 //#region src/errors.d.ts
 /**
@@ -13,7 +13,7 @@ import * as effect_Cause0 from "effect/Cause";
  * @since 0.1.0
  */
 type PlaywrightErrorReason = "Timeout" | "Unknown";
-declare const PlaywrightError_base: new <A extends Record<string, any> = {}>(args: effect_Types0.Equals<A, {}> extends true ? void : { readonly [P in keyof A as P extends "_tag" ? never : P]: A[P] }) => effect_Cause0.YieldableError & {
+declare const PlaywrightError_base: new <A extends Record<string, any> = {}>(args: _$effect_Types0.VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P] }>) => _$effect_Cause0.YieldableError & {
   readonly _tag: "PlaywrightError";
 } & Readonly<A>;
 /**
@@ -31,6 +31,111 @@ declare class PlaywrightError extends PlaywrightError_base<{
   cause: unknown;
 }> {}
 //#endregion
+//#region src/frame-locator.d.ts
+/**
+ * Interface for a Playwright frame locator.
+ * @category model
+ */
+interface PlaywrightFrameLocatorService {
+  /**
+   * The underlying Playwright FrameLocator instance.
+   * @internal
+   */
+  readonly _raw: FrameLocator;
+  /**
+   * Returns locator to the first matching frame.
+   *
+   * @see {@link FrameLocator.first}
+   * @since 0.1.0
+   */
+  readonly first: () => PlaywrightFrameLocatorService;
+  /**
+   * When working with iframes, you can create a frame locator that will enter the iframe and allow selecting elements
+   * in that iframe.
+   *
+   * @see {@link FrameLocator.frameLocator}
+   * @since 0.1.0
+   */
+  readonly frameLocator: (selector: string) => PlaywrightFrameLocatorService;
+  /**
+   * Returns locator to the last matching frame.
+   *
+   * @see {@link FrameLocator.last}
+   * @since 0.1.0
+   */
+  readonly last: () => PlaywrightFrameLocatorService;
+  /**
+   * Returns locator to the n-th matching frame.
+   *
+   * @see {@link FrameLocator.nth}
+   * @since 0.1.0
+   */
+  readonly nth: (index: number) => PlaywrightFrameLocatorService;
+  /**
+   * Returns a `Locator` object pointing to the same `iframe` as this frame locator.
+   *
+   * @see {@link FrameLocator.owner}
+   * @since 0.1.0
+   */
+  readonly owner: () => PlaywrightLocatorService;
+  /**
+   * Finds an element matching the specified selector in the locator's subtree.
+   *
+   * @see {@link FrameLocator.locator}
+   * @since 0.1.0
+   */
+  readonly locator: (selectorOrLocator: string | Locator | PlaywrightLocatorService, options?: Parameters<FrameLocator["locator"]>[1]) => PlaywrightLocatorService;
+  /**
+   * Allows locating elements by their ARIA role.
+   *
+   * @see {@link FrameLocator.getByRole}
+   * @since 0.1.0
+   */
+  readonly getByRole: (role: Parameters<FrameLocator["getByRole"]>[0], options?: Parameters<FrameLocator["getByRole"]>[1]) => PlaywrightLocatorService;
+  /**
+   * Allows locating elements that contain given text.
+   *
+   * @see {@link FrameLocator.getByText}
+   * @since 0.1.0
+   */
+  readonly getByText: (text: Parameters<FrameLocator["getByText"]>[0], options?: Parameters<FrameLocator["getByText"]>[1]) => PlaywrightLocatorService;
+  /**
+   * Allows locating elements by their label text.
+   *
+   * @see {@link FrameLocator.getByLabel}
+   * @since 0.1.0
+   */
+  readonly getByLabel: (text: Parameters<FrameLocator["getByLabel"]>[0], options?: Parameters<FrameLocator["getByLabel"]>[1]) => PlaywrightLocatorService;
+  /**
+   * Allows locating elements by their placeholder text.
+   *
+   * @see {@link FrameLocator.getByPlaceholder}
+   * @since 0.1.0
+   */
+  readonly getByPlaceholder: (text: Parameters<FrameLocator["getByPlaceholder"]>[0], options?: Parameters<FrameLocator["getByPlaceholder"]>[1]) => PlaywrightLocatorService;
+  /**
+   * Allows locating elements by their alt text.
+   *
+   * @see {@link FrameLocator.getByAltText}
+   * @since 0.1.0
+   */
+  readonly getByAltText: (text: Parameters<FrameLocator["getByAltText"]>[0], options?: Parameters<FrameLocator["getByAltText"]>[1]) => PlaywrightLocatorService;
+  /**
+   * Allows locating elements by their title attribute.
+   *
+   * @see {@link FrameLocator.getByTitle}
+   * @since 0.1.0
+   */
+  readonly getByTitle: (text: Parameters<FrameLocator["getByTitle"]>[0], options?: Parameters<FrameLocator["getByTitle"]>[1]) => PlaywrightLocatorService;
+  /**
+   * Allows locating elements by their test id.
+   *
+   * @see {@link FrameLocator.getByTestId}
+   * @since 0.1.0
+   */
+  readonly getByTestId: (testId: Parameters<FrameLocator["getByTestId"]>[0]) => PlaywrightLocatorService;
+}
+//#endregion
 //#region src/playwright-types.d.ts
 /**
  * Extracted from `playwright-core/types/structs.d.ts` because it is not exported over the package boundary.
@@ -60,6 +165,11 @@ type PatchedEvents<Original, Events> = Original & {
  * @category model
  */
 interface PlaywrightLocatorService {
+  /**
+   * The underlying Playwright Locator instance.
+   * @internal
+   */
+  readonly _raw: Locator;
   /**
    * Clicks the element.
    *
@@ -67,6 +177,13 @@ interface PlaywrightLocatorService {
    * @since 0.1.0
    */
   readonly click: (options?: Parameters<Locator["click"]>[0]) => Effect.Effect<void, PlaywrightError>;
+  /**
+   * Checks the element.
+   *
+   * @see {@link Locator.check}
+   * @since 0.1.0
+   */
+  readonly check: (options?: Parameters<Locator["check"]>[0]) => Effect.Effect<void, PlaywrightError>;
   /**
    * Fills the input field.
    *
@@ -109,6 +226,53 @@ interface PlaywrightLocatorService {
    * @since 0.1.0
    */
   readonly textContent: (options?: Parameters<Locator["textContent"]>[0]) => Effect.Effect<string | null, PlaywrightError>;
+  /**
+   * Gets all inner texts.
+   *
+   * @see {@link Locator.allInnerTexts}
+   * @since 0.1.0
+   */
+  readonly allInnerTexts: () => Effect.Effect<ReadonlyArray<string>, PlaywrightError>;
+  /**
+   * Gets all text contents.
+   *
+   * @see {@link Locator.allTextContents}
+   * @since 0.1.0
+   */
+  readonly allTextContents: () => Effect.Effect<ReadonlyArray<string>, PlaywrightError>;
+  /**
+   * Returns the accessibility tree snapshot.
+   *
+   * @see {@link Locator.ariaSnapshot}
+   * @since 0.1.0
+   */
+  readonly ariaSnapshot: (options?: Parameters<Locator["ariaSnapshot"]>[0]) => Effect.Effect<string, PlaywrightError>;
+  /**
+   * Returns the bounding box of the element.
+   *
+   * @see {@link Locator.boundingBox}
+   * @since 0.1.0
+   */
+  readonly boundingBox: (options?: Parameters<Locator["boundingBox"]>[0]) => Effect.Effect<Option.Option<{
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+  }>, PlaywrightError>;
+  /**
+   * Describes the locator.
+   *
+   * @see {@link Locator.describe}
+   * @since 0.1.0
+   */
+  readonly describe: (description: string) => PlaywrightLocatorService;
+  /**
+   * Returns the description of the locator.
+   *
+   * @see {@link Locator.description}
+   * @since 0.1.0
+   */
+  readonly description: () => Option.Option<string>;
   /**
    * Counts the number of matched elements.
    *
@@ -136,6 +300,111 @@ interface PlaywrightLocatorService {
    * @since 0.1.0
    */
   readonly nth: (index: number) => PlaywrightLocatorService;
+  /**
+   * Returns a locator that points to a matched element.
+   *
+   * @see {@link Locator.locator}
+   * @since 0.1.0
+   */
+  readonly locator: (selectorOrLocator: string | Locator | PlaywrightLocatorService, options?: Parameters<Locator["locator"]>[1]) => PlaywrightLocatorService;
+  /**
+   * Allows locating elements by their ARIA role, ARIA attributes and accessible name.
+   *
+   * @see {@link Locator.getByRole}
+   * @since 0.1.0
+   */
+  readonly getByRole: (role: Parameters<Locator["getByRole"]>[0], options?: Parameters<Locator["getByRole"]>[1]) => PlaywrightLocatorService;
+  /**
+   * Allows locating elements that contain given text.
+   *
+   * @see {@link Locator.getByText}
+   * @since 0.1.0
+   */
+  readonly getByText: (text: Parameters<Locator["getByText"]>[0], options?: Parameters<Locator["getByText"]>[1]) => PlaywrightLocatorService;
+  /**
+   * Allows locating elements by their label text.
+   *
+   * @see {@link Locator.getByLabel}
+   * @since 0.1.0
+   */
+  readonly getByLabel: (text: Parameters<Locator["getByLabel"]>[0], options?: Parameters<Locator["getByLabel"]>[1]) => PlaywrightLocatorService;
+  /**
+   * Allows locating elements by their placeholder text.
+   *
+   * @see {@link Locator.getByPlaceholder}
+   * @since 0.1.0
+   */
+  readonly getByPlaceholder: (text: Parameters<Locator["getByPlaceholder"]>[0], options?: Parameters<Locator["getByPlaceholder"]>[1]) => PlaywrightLocatorService;
+  /**
+   * Allows locating elements by their alt text.
+   *
+   * @see {@link Locator.getByAltText}
+   * @since 0.1.0
+   */
+  readonly getByAltText: (text: Parameters<Locator["getByAltText"]>[0], options?: Parameters<Locator["getByAltText"]>[1]) => PlaywrightLocatorService;
+  /**
+   * Allows locating elements by their title attribute.
+   *
+   * @see {@link Locator.getByTitle}
+   * @since 0.1.0
+   */
+  readonly getByTitle: (text: Parameters<Locator["getByTitle"]>[0], options?: Parameters<Locator["getByTitle"]>[1]) => PlaywrightLocatorService;
+  /**
+   * Allows locating elements by their test id.
+   *
+   * @see {@link Locator.getByTestId}
+   * @since 0.1.0
+   */
+  readonly getByTestId: (testId: Parameters<Locator["getByTestId"]>[0]) => PlaywrightLocatorService;
+  /**
+   * Returns whether the element is checked.
+   *
+   * @see {@link Locator.isChecked}
+   * @since 0.4.1
+   */
+  readonly isChecked: (options?: Parameters<Locator["isChecked"]>[0]) => Effect.Effect<boolean, PlaywrightError>;
+  /**
+   * Returns whether the element is disabled.
+   *
+   * @see {@link Locator.isDisabled}
+   * @since 0.4.1
+   */
+  readonly isDisabled: (options?: Parameters<Locator["isDisabled"]>[0]) => Effect.Effect<boolean, PlaywrightError>;
+  /**
+   * Returns whether the element is editable.
+   *
+   * @see {@link Locator.isEditable}
+   * @since 0.4.1
+   */
+  readonly isEditable: (options?: Parameters<Locator["isEditable"]>[0]) => Effect.Effect<boolean, PlaywrightError>;
+  /**
+   * Returns whether the element is enabled.
+   *
+   * @see {@link Locator.isEnabled}
+   * @since 0.4.1
+   */
+  readonly isEnabled: (options?: Parameters<Locator["isEnabled"]>[0]) => Effect.Effect<boolean, PlaywrightError>;
+  /**
+   * Returns whether the element is hidden.
+   *
+   * @see {@link Locator.isHidden}
+   * @since 0.4.1
+   */
+  readonly isHidden: (options?: Parameters<Locator["isHidden"]>[0]) => Effect.Effect<boolean, PlaywrightError>;
+  /**
+   * Returns whether the element is visible.
+   *
+   * @see {@link Locator.isVisible}
+   * @since 0.4.1
+   */
+  readonly isVisible: (options?: Parameters<Locator["isVisible"]>[0]) => Effect.Effect<boolean, PlaywrightError>;
+  /**
+   * Returns when element specified by locator satisfies the `state` option.
+   *
+   * @see {@link Locator.waitFor}
+   * @since 0.1.0
+   */
+  readonly waitFor: (options?: Parameters<Locator["waitFor"]>[0]) => Effect.Effect<void, PlaywrightError>;
   /**
    * Evaluates a function on the matched element.
    *
@@ -160,6 +429,216 @@ interface PlaywrightLocatorService {
   readonly evaluate: <R, Arg = void, E extends SVGElement | HTMLElement = SVGElement | HTMLElement>(pageFunction: (element: E, arg: Unboxed<Arg>) => R | Promise<R>, arg?: Arg, options?: {
     timeout?: number;
   }) => Effect.Effect<R, PlaywrightError>;
+  /**
+   * Highlights the corresponding element(s) on the screen.
+   *
+   * @see {@link Locator.highlight}
+   * @since 0.4.1
+   */
+  readonly highlight: () => Effect.Effect<void, PlaywrightError>;
+  /**
+   * Captures a screenshot of the element.
+   *
+   * @see {@link Locator.screenshot}
+   * @since 0.4.1
+   */
+  readonly screenshot: (options?: Parameters<Locator["screenshot"]>[0]) => Effect.Effect<Buffer, PlaywrightError>;
+  /**
+   * Returns the string representation of the locator.
+   *
+   * @see {@link Locator.toString}
+   * @since 0.4.1
+   */
+  readonly toString: () => string;
+  /**
+   * Evaluates a function on all matched elements.
+   *
+   * @see {@link Locator.evaluateAll}
+   * @since 0.3.0
+   */
+  readonly evaluateAll: <R, Arg = void, E extends SVGElement | HTMLElement = SVGElement | HTMLElement>(pageFunction: (elements: E[], arg: Unboxed<Arg>) => R | Promise<R>, arg?: Arg) => Effect.Effect<R, PlaywrightError>;
+  /**
+   * Evaluates a function on the matched element and returns the result as a handle.
+   *
+   * @see {@link Locator.evaluateHandle}
+   * @since 0.3.0
+   */
+  readonly evaluateHandle: <R, Arg = void, E extends SVGElement | HTMLElement = SVGElement | HTMLElement>(pageFunction: (element: E, arg: Unboxed<Arg>) => R | Promise<R>, arg?: Arg) => Effect.Effect<JSHandle<R>, PlaywrightError>;
+  /**
+   * Resolves given locator to the first matching DOM element.
+   *
+   * @see {@link Locator.elementHandle}
+   * @since 0.3.0
+   */
+  readonly elementHandle: (options?: Parameters<Locator["elementHandle"]>[0]) => Effect.Effect<Option.Option<ElementHandle<SVGElement | HTMLElement>>, PlaywrightError>;
+  /**
+   * Resolves given locator to all matching DOM elements.
+   *
+   * @see {@link Locator.elementHandles}
+   * @since 0.3.0
+   */
+  readonly elementHandles: () => Effect.Effect<ReadonlyArray<ElementHandle<SVGElement | HTMLElement>>, PlaywrightError>;
+  /**
+   * Returns an array of locators pointing to the matched elements.
+   *
+   * @see {@link Locator.all}
+   * @since 0.4.1
+   */
+  readonly all: () => Effect.Effect<ReadonlyArray<PlaywrightLocatorService>, PlaywrightError>;
+  /**
+   * Creates a locator that matches both this locator and the argument locator.
+   *
+   * @see {@link Locator.and}
+   * @since 0.4.1
+   */
+  readonly and: (locator: PlaywrightLocatorService | Locator) => PlaywrightLocatorService;
+  /**
+   * Returns a FrameLocator object pointing to the same iframe as this locator.
+   *
+   * @see {@link Locator.contentFrame}
+   * @since 0.4.1
+   */
+  readonly contentFrame: () => PlaywrightFrameLocatorService;
+  /**
+   * Narrows existing locator according to the options.
+   *
+   * @see {@link Locator.filter}
+   * @since 0.4.1
+   */
+  readonly filter: (options?: Parameters<Locator["filter"]>[0]) => PlaywrightLocatorService;
+  /**
+   * Creates a frame locator that will enter the iframe and allow selecting elements in that iframe.
+   *
+   * @see {@link Locator.frameLocator}
+   * @since 0.4.1
+   */
+  readonly frameLocator: (selector: string) => PlaywrightFrameLocatorService;
+  /**
+   * Creates a locator that matches either this locator or the argument locator.
+   *
+   * @see {@link Locator.or}
+   * @since 0.4.1
+   */
+  readonly or: (locator: PlaywrightLocatorService | Locator) => PlaywrightLocatorService;
+  /**
+   * A page this locator belongs to.
+   *
+   * @see {@link Locator.page}
+   * @since 0.4.1
+   */
+  readonly page: () => typeof PlaywrightPage.Service;
+  /**
+   * Removes keyboard focus from the current element.
+   *
+   * @see {@link Locator.blur}
+   * @since 0.4.2
+   */
+  readonly blur: (options?: Parameters<Locator["blur"]>[0]) => Effect.Effect<void, PlaywrightError>;
+  /**
+   * Clear the input field.
+   *
+   * @see {@link Locator.clear}
+   * @since 0.4.2
+   */
+  readonly clear: (options?: Parameters<Locator["clear"]>[0]) => Effect.Effect<void, PlaywrightError>;
+  /**
+   * Double-clicks the element.
+   *
+   * @see {@link Locator.dblclick}
+   * @since 0.4.2
+   */
+  readonly dblclick: (options?: Parameters<Locator["dblclick"]>[0]) => Effect.Effect<void, PlaywrightError>;
+  /**
+   * Dispatches an event.
+   *
+   * @see {@link Locator.dispatchEvent}
+   * @since 0.4.2
+   */
+  readonly dispatchEvent: (type: Parameters<Locator["dispatchEvent"]>[0], eventInit?: Parameters<Locator["dispatchEvent"]>[1], options?: Parameters<Locator["dispatchEvent"]>[2]) => Effect.Effect<void, PlaywrightError>;
+  /**
+   * Drags the locator to another target locator.
+   *
+   * @see {@link Locator.dragTo}
+   * @since 0.4.2
+   */
+  readonly dragTo: (target: PlaywrightLocatorService | Locator, options?: Parameters<Locator["dragTo"]>[1]) => Effect.Effect<void, PlaywrightError>;
+  /**
+   * Focuses the element.
+   *
+   * @see {@link Locator.focus}
+   * @since 0.4.2
+   */
+  readonly focus: (options?: Parameters<Locator["focus"]>[0]) => Effect.Effect<void, PlaywrightError>;
+  /**
+   * Hovers over the element.
+   *
+   * @see {@link Locator.hover}
+   * @since 0.4.2
+   */
+  readonly hover: (options?: Parameters<Locator["hover"]>[0]) => Effect.Effect<void, PlaywrightError>;
+  /**
+   * Focuses the element, and then uses `keyboard.down` and `keyboard.up`.
+   *
+   * @see {@link Locator.press}
+   * @since 0.4.2
+   */
+  readonly press: (key: Parameters<Locator["press"]>[0], options?: Parameters<Locator["press"]>[1]) => Effect.Effect<void, PlaywrightError>;
+  /**
+   * Focuses the element, and then sends a `keydown`, `keypress`/`input`, and `keyup` event for each character in the text.
+   *
+   * @see {@link Locator.pressSequentially}
+   * @since 0.4.2
+   */
+  readonly pressSequentially: (text: Parameters<Locator["pressSequentially"]>[0], options?: Parameters<Locator["pressSequentially"]>[1]) => Effect.Effect<void, PlaywrightError>;
+  /**
+   * Scrolls the element into view if needed.
+   *
+   * @see {@link Locator.scrollIntoViewIfNeeded}
+   * @since 0.4.2
+   */
+  readonly scrollIntoViewIfNeeded: (options?: Parameters<Locator["scrollIntoViewIfNeeded"]>[0]) => Effect.Effect<void, PlaywrightError>;
+  /**
+   * Selects an option in a `<select>` element.
+   *
+   * @see {@link Locator.selectOption}
+   * @since 0.4.2
+   */
+  readonly selectOption: (values: Parameters<Locator["selectOption"]>[0], options?: Parameters<Locator["selectOption"]>[1]) => Effect.Effect<ReadonlyArray<string>, PlaywrightError>;
+  /**
+   * Selects text.
+   *
+   * @see {@link Locator.selectText}
+   * @since 0.4.2
+   */
+  readonly selectText: (options?: Parameters<Locator["selectText"]>[0]) => Effect.Effect<void, PlaywrightError>;
+  /**
+   * Checks the element if not already checked.
+   *
+   * @see {@link Locator.setChecked}
+   * @since 0.4.2
+   */
+  readonly setChecked: (checked: Parameters<Locator["setChecked"]>[0], options?: Parameters<Locator["setChecked"]>[1]) => Effect.Effect<void, PlaywrightError>;
+  /**
+   * Sets the value of the file input.
+   *
+   * @see {@link Locator.setInputFiles}
+   * @since 0.4.2
+   */
+  readonly setInputFiles: (files: Parameters<Locator["setInputFiles"]>[0], options?: Parameters<Locator["setInputFiles"]>[1]) => Effect.Effect<void, PlaywrightError>;
+  /**
+   * Taps the element.
+   *
+   * @see {@link Locator.tap}
+   * @since 0.4.2
+   */
+  readonly tap: (options?: Parameters<Locator["tap"]>[0]) => Effect.Effect<void, PlaywrightError>;
+  /**
+   * Unchecks the element.
+   *
+   * @see {@link Locator.uncheck}
+   * @since 0.4.2
+   */
+  readonly uncheck: (options?: Parameters<Locator["uncheck"]>[0]) => Effect.Effect<void, PlaywrightError>;
   /**
    * A generic utility to execute any promise-based method on the underlying Playwright `Locator`.
    * Can be used to access any Locator functionality not directly exposed by this service.
@@ -287,6 +766,69 @@ interface PlaywrightFrameService {
    * @since 0.1.3
    */
   readonly getByTestId: (testId: Parameters<Frame["getByTestId"]>[0]) => typeof PlaywrightLocator.Service;
+  /**
+   * Returns a locator that matches the given placeholder.
+   *
+   * @see {@link Frame.getByPlaceholder}
+   * @since 0.4.1
+   */
+  readonly getByPlaceholder: (text: Parameters<Frame["getByPlaceholder"]>[0], options?: Parameters<Frame["getByPlaceholder"]>[1]) => typeof PlaywrightLocator.Service;
+  /**
+   * Returns a locator that matches the given alt text.
+   *
+   * @see {@link Frame.getByAltText}
+   * @since 0.4.1
+   */
+  readonly getByAltText: (text: Parameters<Frame["getByAltText"]>[0], options?: Parameters<Frame["getByAltText"]>[1]) => typeof PlaywrightLocator.Service;
+  /**
+   * Returns a locator that matches the given title.
+   *
+   * @see {@link Frame.getByTitle}
+   * @since 0.4.1
+   */
+  readonly getByTitle: (text: Parameters<Frame["getByTitle"]>[0], options?: Parameters<Frame["getByTitle"]>[1]) => typeof PlaywrightLocator.Service;
+  /**
+   * Returns the page that the frame belongs to.
+   *
+   * @see {@link Frame.page}
+   * @since 0.4.1
+   */
+  readonly page: () => PlaywrightPageService;
+  /**
+   * Returns the parent frame, if any.
+   *
+   * @see {@link Frame.parentFrame}
+   * @since 0.4.1
+   */
+  readonly parentFrame: () => Option.Option<PlaywrightFrameService>;
+  /**
+   * Returns an array of child frames.
+   *
+   * @see {@link Frame.childFrames}
+   * @since 0.4.1
+   */
+  readonly childFrames: () => ReadonlyArray<PlaywrightFrameService>;
+  /**
+   * Returns whether the frame is detached.
+   *
+   * @see {@link Frame.isDetached}
+   * @since 0.4.1
+   */
+  readonly isDetached: () => boolean;
+  /**
+   * Waits for the given timeout in milliseconds.
+   *
+   * @see {@link Frame.waitForTimeout}
+   * @since 0.4.1
+   */
+  readonly waitForTimeout: (timeout: number) => Effect.Effect<void, PlaywrightError>;
+  /**
+   * Sets the HTML content of the frame.
+   *
+   * @see {@link Frame.setContent}
+   * @since 0.4.1
+   */
+  readonly setContent: (html: string, options?: Parameters<Frame["setContent"]>[1]) => Effect.Effect<void, PlaywrightError>;
   /**
    * Returns the current URL of the frame.
    *
@@ -421,7 +963,7 @@ declare class PlaywrightClock extends PlaywrightClock_base {
 }
 //#endregion
 //#region src/common.d.ts
-declare const PlaywrightRequest_base: new <A extends Record<string, any> = {}>(args: effect_Types0.Equals<A, {}> extends true ? void : { readonly [P in keyof A as P extends "_tag" ? never : P]: A[P] }) => Readonly<A> & {
+declare const PlaywrightRequest_base: new <A extends Record<string, any> = {}>(args: _$effect_Types0.VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P] }>) => Readonly<A> & {
   readonly _tag: "PlaywrightRequest";
 };
 /**
@@ -443,7 +985,7 @@ declare class PlaywrightRequest extends PlaywrightRequest_base<{
    * Returns the Frame that initiated this request.
    * @see {@link Request.frame}
    */
-  frame: Effect.Effect<PlaywrightFrameService>;
+  frame: Effect.Effect<PlaywrightFrameService, PlaywrightError>;
   /**
    * Returns the value of the header matching the name. The name is case insensitive.
    * @see {@link Request.headerValue}
@@ -527,7 +1069,7 @@ declare class PlaywrightRequest extends PlaywrightRequest_base<{
 }> {
   static make(request: Request): PlaywrightRequest;
 }
-declare const PlaywrightResponse_base: new <A extends Record<string, any> = {}>(args: effect_Types0.Equals<A, {}> extends true ? void : { readonly [P in keyof A as P extends "_tag" ? never : P]: A[P] }) => Readonly<A> & {
+declare const PlaywrightResponse_base: new <A extends Record<string, any> = {}>(args: _$effect_Types0.VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P] }>) => Readonly<A> & {
   readonly _tag: "PlaywrightResponse";
 };
 /**
@@ -538,7 +1080,7 @@ declare class PlaywrightResponse extends PlaywrightResponse_base<{
   allHeaders: Effect.Effect<Awaited<ReturnType<Response["allHeaders"]>>, PlaywrightError>;
   body: Effect.Effect<Awaited<ReturnType<Response["body"]>>, PlaywrightError>;
   finished: Effect.Effect<Awaited<ReturnType<Response["finished"]>>, PlaywrightError>;
-  frame: Effect.Effect<PlaywrightFrameService>;
+  frame: Effect.Effect<PlaywrightFrameService, PlaywrightError>;
   fromServiceWorker: () => boolean;
   headers: () => ReturnType<Response["headers"]>;
   headersArray: Effect.Effect<Awaited<ReturnType<Response["headersArray"]>>, PlaywrightError>;
@@ -556,7 +1098,7 @@ declare class PlaywrightResponse extends PlaywrightResponse_base<{
 }> {
   static make(response: Response): PlaywrightResponse;
 }
-declare const PlaywrightWorker_base: new <A extends Record<string, any> = {}>(args: effect_Types0.Equals<A, {}> extends true ? void : { readonly [P in keyof A as P extends "_tag" ? never : P]: A[P] }) => Readonly<A> & {
+declare const PlaywrightWorker_base: new <A extends Record<string, any> = {}>(args: _$effect_Types0.VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P] }>) => Readonly<A> & {
   readonly _tag: "PlaywrightWorker";
 };
 /**
@@ -569,7 +1111,7 @@ declare class PlaywrightWorker extends PlaywrightWorker_base<{
 }> {
   static make(worker: Worker): PlaywrightWorker;
 }
-declare const PlaywrightDialog_base: new <A extends Record<string, any> = {}>(args: effect_Types0.Equals<A, {}> extends true ? void : { readonly [P in keyof A as P extends "_tag" ? never : P]: A[P] }) => Readonly<A> & {
+declare const PlaywrightDialog_base: new <A extends Record<string, any> = {}>(args: _$effect_Types0.VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P] }>) => Readonly<A> & {
   readonly _tag: "PlaywrightDialog";
 };
 /**
@@ -586,7 +1128,7 @@ declare class PlaywrightDialog extends PlaywrightDialog_base<{
 }> {
   static make(dialog: Dialog): PlaywrightDialog;
 }
-declare const PlaywrightFileChooser_base: new <A extends Record<string, any> = {}>(args: effect_Types0.Equals<A, {}> extends true ? void : { readonly [P in keyof A as P extends "_tag" ? never : P]: A[P] }) => Readonly<A> & {
+declare const PlaywrightFileChooser_base: new <A extends Record<string, any> = {}>(args: _$effect_Types0.VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P] }>) => Readonly<A> & {
   readonly _tag: "PlaywrightFileChooser";
 };
 /**
@@ -601,7 +1143,7 @@ declare class PlaywrightFileChooser extends PlaywrightFileChooser_base<{
 }> {
   static make(fileChooser: FileChooser): PlaywrightFileChooser;
 }
-declare const PlaywrightDownload_base: new <A extends Record<string, any> = {}>(args: effect_Types0.Equals<A, {}> extends true ? void : { readonly [P in keyof A as P extends "_tag" ? never : P]: A[P] }) => Readonly<A> & {
+declare const PlaywrightDownload_base: new <A extends Record<string, any> = {}>(args: _$effect_Types0.VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P] }>) => Readonly<A> & {
   readonly _tag: "PlaywrightDownload";
 };
 /**
@@ -870,6 +1412,13 @@ interface PlaywrightPageService {
    * @since 0.3.0
    */
   readonly setContent: (html: string, options?: Parameters<Page["setContent"]>[1]) => Effect.Effect<void, PlaywrightError>;
+  /**
+   * Waits for the given timeout in milliseconds.
+   *
+   * @see {@link Page.waitForTimeout}
+   * @since 0.4.0
+   */
+  readonly waitForTimeout: (timeout: number) => Effect.Effect<void, PlaywrightError>;
   /**
    * This setting will change the default maximum navigation time for the following methods:
    * - {@link PlaywrightPageService.goBack}
@@ -882,14 +1431,14 @@ interface PlaywrightPageService {
    * @see {@link Page.setDefaultNavigationTimeout}
    * @since 0.3.0
    */
-  readonly setDefaultNavigationTimeout: (timeout: Parameters<Page["setDefaultNavigationTimeout"]>[0]) => Effect.Effect<void>;
+  readonly setDefaultNavigationTimeout: (timeout: Parameters<Page["setDefaultNavigationTimeout"]>[0]) => void;
   /**
    * This setting will change the default maximum time for all the methods accepting `timeout` option.
    *
    * @see {@link Page.setDefaultTimeout}
    * @since 0.3.0
    */
-  readonly setDefaultTimeout: (timeout: Parameters<Page["setDefaultTimeout"]>[0]) => Effect.Effect<void>;
+  readonly setDefaultTimeout: (timeout: Parameters<Page["setDefaultTimeout"]>[0]) => void;
   /**
    * The extra HTTP headers will be sent with every request the page initiates.
    *
@@ -1458,7 +2007,7 @@ interface PlaywrightBrowserContextService {
    * @see {@link BrowserContext.pages}
    * @since 0.1.0
    */
-  readonly pages: Effect.Effect<Array<typeof PlaywrightPage.Service>>;
+  readonly pages: () => Array<typeof PlaywrightPage.Service>;
   /**
    * Opens a new page in the browser context.
    *
@@ -1487,6 +2036,87 @@ interface PlaywrightBrowserContextService {
    * @since 0.2.0
    */
   readonly addInitScript: (script: Parameters<BrowserContext["addInitScript"]>[0], arg?: Parameters<BrowserContext["addInitScript"]>[1]) => Effect.Effect<void, PlaywrightError>;
+  /**
+   * Returns the browser that the context belongs to.
+   *
+   * @see {@link BrowserContext.browser}
+   * @since 0.4.0
+   */
+  readonly browser: () => Option.Option<PlaywrightBrowserService>;
+  /**
+   * Clears the cookies from the browser context.
+   *
+   * @see {@link BrowserContext.clearCookies}
+   * @since 0.4.0
+   */
+  readonly clearCookies: (options?: {
+    name?: string | RegExp;
+    domain?: string | RegExp;
+    path?: string | RegExp;
+  }) => Effect.Effect<void, PlaywrightError>;
+  /**
+   * Clears the permissions from the browser context.
+   *
+   * @see {@link BrowserContext.clearPermissions}
+   * @since 0.4.0
+   */
+  readonly clearPermissions: Effect.Effect<void, PlaywrightError>;
+  /**
+   * Returns the cookies for the browser context.
+   *
+   * @see {@link BrowserContext.cookies}
+   * @since 0.4.0
+   */
+  readonly cookies: (urls?: string | string[]) => Effect.Effect<Awaited<ReturnType<BrowserContext["cookies"]>>, PlaywrightError>;
+  /**
+   * Sets the cookies for the browser context.
+   *
+   * @see {@link BrowserContext.addCookies}
+   * @since 0.4.0
+   */
+  readonly addCookies: (cookies: Parameters<BrowserContext["addCookies"]>[0]) => Effect.Effect<void, PlaywrightError>;
+  /**
+   * Grants permissions to the browser context.
+   *
+   * @see {@link BrowserContext.grantPermissions}
+   * @since 0.4.0
+   */
+  readonly grantPermissions: (permissions: Parameters<BrowserContext["grantPermissions"]>[0], options?: Parameters<BrowserContext["grantPermissions"]>[1]) => Effect.Effect<void, PlaywrightError>;
+  /**
+   * Sets the extra HTTP headers for the browser context.
+   *
+   * @see {@link BrowserContext.setExtraHTTPHeaders}
+   * @since 0.4.0
+   */
+  readonly setExtraHTTPHeaders: (headers: Parameters<BrowserContext["setExtraHTTPHeaders"]>[0]) => Effect.Effect<void, PlaywrightError>;
+  /**
+   * Sets the geolocation for the browser context.
+   *
+   * @see {@link BrowserContext.setGeolocation}
+   * @since 0.4.0
+   */
+  readonly setGeolocation: (geolocation: Parameters<BrowserContext["setGeolocation"]>[0]) => Effect.Effect<void, PlaywrightError>;
+  /**
+   * Sets the offline state for the browser context.
+   *
+   * @see {@link BrowserContext.setOffline}
+   * @since 0.4.0
+   */
+  readonly setOffline: (offline: boolean) => Effect.Effect<void, PlaywrightError>;
+  /**
+   * Sets the default navigation timeout for the browser context.
+   *
+   * @see {@link BrowserContext.setDefaultNavigationTimeout}
+   * @since 0.4.0
+   */
+  readonly setDefaultNavigationTimeout: (timeout: number) => void;
+  /**
+   * Sets the default timeout for the browser context.
+   *
+   * @see {@link BrowserContext.setDefaultTimeout}
+   * @since 0.4.0
+   */
+  readonly setDefaultTimeout: (timeout: number) => void;
   /**
    * Creates a stream of the given event from the browser context.
    *

package/dist/index.d.mts

@@ -1,2 +1,2 @@
-import { A as PlaywrightError, C as PlaywrightWorker, D as PlaywrightFrameService, E as PlaywrightFrame, O as PlaywrightLocator, S as PlaywrightResponse, T as PlaywrightClockService, _ as PlaywrightKeyboardService, a as NewPageOptions, b as PlaywrightFileChooser, c as PlaywrightBrowserContext, d as PlaywrightPageService, f as PlaywrightTouchscreen, g as PlaywrightKeyboard, h as PlaywrightMouseService, i as NewContextOptions, j as PlaywrightErrorReason, k as PlaywrightLocatorService, l as PlaywrightBrowserContextService, m as PlaywrightMouse, n as PlaywrightService, o as PlaywrightBrowser, p as PlaywrightTouchscreenService, r as LaunchOptions, s as PlaywrightBrowserService, t as Playwright, u as PlaywrightPage, v as PlaywrightDialog, w as PlaywrightClock, x as PlaywrightRequest, y as PlaywrightDownload } from "./index-CA1jsZ4o.mjs";
+import { A as PlaywrightError, C as PlaywrightWorker, D as PlaywrightFrameService, E as PlaywrightFrame, O as PlaywrightLocator, S as PlaywrightResponse, T as PlaywrightClockService, _ as PlaywrightKeyboardService, a as NewPageOptions, b as PlaywrightFileChooser, c as PlaywrightBrowserContext, d as PlaywrightPageService, f as PlaywrightTouchscreen, g as PlaywrightKeyboard, h as PlaywrightMouseService, i as NewContextOptions, j as PlaywrightErrorReason, k as PlaywrightLocatorService, l as PlaywrightBrowserContextService, m as PlaywrightMouse, n as PlaywrightService, o as PlaywrightBrowser, p as PlaywrightTouchscreenService, r as LaunchOptions, s as PlaywrightBrowserService, t as Playwright, u as PlaywrightPage, v as PlaywrightDialog, w as PlaywrightClock, x as PlaywrightRequest, y as PlaywrightDownload } from "./index-COItPgGw.mjs";
 export { LaunchOptions, NewContextOptions, NewPageOptions, Playwright, PlaywrightBrowser, PlaywrightBrowserContext, PlaywrightBrowserContextService, PlaywrightBrowserService, PlaywrightClock, PlaywrightClockService, PlaywrightDialog, PlaywrightDownload, PlaywrightError, PlaywrightErrorReason, PlaywrightFileChooser, PlaywrightFrame, PlaywrightFrameService, PlaywrightKeyboard, PlaywrightKeyboardService, PlaywrightLocator, PlaywrightLocatorService, PlaywrightMouse, PlaywrightMouseService, PlaywrightPage, PlaywrightPageService, PlaywrightRequest, PlaywrightResponse, PlaywrightService, PlaywrightTouchscreen, PlaywrightTouchscreenService, PlaywrightWorker };

package/dist/index.mjs

@@ -1,2 +1,2 @@
-import { _ as PlaywrightError, a as PlaywrightDownload, c as PlaywrightResponse, d as PlaywrightTouchscreen, f as PlaywrightMouse, g as PlaywrightClock, h as PlaywrightLocator, i as PlaywrightDialog, l as PlaywrightWorker, m as PlaywrightFrame, n as PlaywrightBrowser, o as PlaywrightFileChooser, p as PlaywrightKeyboard, r as PlaywrightBrowserContext, s as PlaywrightRequest, t as Playwright, u as PlaywrightPage } from "./src-DxTog178.mjs";
+import { _ as PlaywrightError, a as PlaywrightDownload, c as PlaywrightResponse, d as PlaywrightLocator, f as PlaywrightPage, g as PlaywrightClock, h as PlaywrightKeyboard, i as PlaywrightDialog, l as PlaywrightWorker, m as PlaywrightMouse, n as PlaywrightBrowser, o as PlaywrightFileChooser, p as PlaywrightTouchscreen, r as PlaywrightBrowserContext, s as PlaywrightRequest, t as Playwright, u as PlaywrightFrame } from "./src-BdVoZgVR.mjs";
 export { Playwright, PlaywrightBrowser, PlaywrightBrowserContext, PlaywrightClock, PlaywrightDialog, PlaywrightDownload, PlaywrightError, PlaywrightFileChooser, PlaywrightFrame, PlaywrightKeyboard, PlaywrightLocator, PlaywrightMouse, PlaywrightPage, PlaywrightRequest, PlaywrightResponse, PlaywrightTouchscreen, PlaywrightWorker };

package/dist/{src-DxTog178.mjs → src-BdVoZgVR.mjs}

@@ -1,4 +1,4 @@
-import { Context, Data, Effect, Layer, Option, Runtime, Stream, identity } from "effect";
+import { Array, Context, Data, Effect, Layer, Match, Option, Predicate, Runtime, Stream, identity } from "effect";
 import { chromium, errors } from "playwright-core";
 import { Readable } from "node:stream";
 //#region src/errors.ts
@@ -58,78 +58,38 @@ var PlaywrightClock = class PlaywrightClock extends Context.Tag("effect-playwrig
 	}
 };
 //#endregion
-//#region src/locator.ts
+//#region src/frame-locator.ts
 /**
-* A service that provides a `PlaywrightLocator` instance.
+* A service that provides a `PlaywrightFrameLocator` instance.
 *
 * @since 0.1.0
 * @category tag
 */
-var PlaywrightLocator = class PlaywrightLocator extends Context.Tag("effect-playwright/PlaywrightLocator")() {
+var PlaywrightFrameLocator = class PlaywrightFrameLocator extends Context.Tag("effect-playwright/PlaywrightFrameLocator")() {
 	/**
-	* Creates a `PlaywrightLocator` from a Playwright `Locator` instance. This is mostly for internal use.
-	* But you could use this if you have used `use` or similar to wrap the locator.
-	*
-	* @example
-	* ```ts
-	* const playwrightNativeLocator = yield* page.use((p) => p.locator("button"));
-	* const locator = PlaywrightLocator.make(playwrightNativeLocator);
-	* ```
+	* Creates a `PlaywrightFrameLocator` from a Playwright `FrameLocator` instance.
 	*
-	* @param locator - The Playwright `Locator` instance to wrap.
+	* @param frameLocator - The Playwright `FrameLocator` instance to wrap.
 	* @since 0.1.0
 	* @category constructor
 	*/
-	static make(locator) {
-		const use = useHelper(locator);
-		return PlaywrightLocator.of({
-			click: (options) => use((l) => l.click(options)),
-			fill: (value, options) => use((l) => l.fill(value, options)),
-			getAttribute: (name, options) => use((l) => l.getAttribute(name, options)),
-			innerText: (options) => use((l) => l.innerText(options)),
-			innerHTML: (options) => use((l) => l.innerHTML(options)),
-			inputValue: (options) => use((l) => l.inputValue(options)),
-			textContent: (options) => use((l) => l.textContent(options)),
-			count: use((l) => l.count()),
-			first: () => PlaywrightLocator.make(locator.first()),
-			last: () => PlaywrightLocator.make(locator.last()),
-			nth: (index) => PlaywrightLocator.make(locator.nth(index)),
-			evaluate: (pageFunction, arg, options) => use((l) => l.evaluate(pageFunction, arg, options)),
-			use
-		});
-	}
-};
-//#endregion
-//#region src/frame.ts
-/**
-* @category tag
-* @since 0.1.2
-*/
-var PlaywrightFrame = class PlaywrightFrame extends Context.Tag("effect-playwright/PlaywrightFrame")() {
-	/**
-	* Creates a `PlaywrightFrame` from a Playwright `Frame` instance.
-	*
-	* @param frame - The Playwright `Frame` instance to wrap.
-	* @since 0.1.2
-	*/
-	static make(frame) {
-		const use = useHelper(frame);
-		return PlaywrightFrame.of({
-			goto: (url, options) => use((f) => f.goto(url, options)),
-			waitForURL: (url, options) => use((f) => f.waitForURL(url, options)),
-			waitForLoadState: (state, options) => use((f) => f.waitForLoadState(state, options)),
-			evaluate: (f, arg) => use((frame) => frame.evaluate(f, arg)),
-			title: use((f) => f.title()),
-			use,
-			locator: (selector, options) => PlaywrightLocator.make(frame.locator(selector, options)),
-			getByRole: (role, options) => PlaywrightLocator.make(frame.getByRole(role, options)),
-			getByText: (text, options) => PlaywrightLocator.make(frame.getByText(text, options)),
-			getByLabel: (label, options) => PlaywrightLocator.make(frame.getByLabel(label, options)),
-			getByTestId: (testId) => PlaywrightLocator.make(frame.getByTestId(testId)),
-			url: () => frame.url(),
-			content: use((f) => f.content()),
-			name: () => frame.name(),
-			click: (selector, options) => use((f) => f.click(selector, options))
+	static make(frameLocator) {
+		const unwrap = Match.type().pipe(Match.when(Predicate.hasProperty("_raw"), (l) => l._raw), Match.orElse((l) => l));
+		return PlaywrightFrameLocator.of({
+			_raw: frameLocator,
+			first: () => PlaywrightFrameLocator.make(frameLocator.first()),
+			frameLocator: (selector) => PlaywrightFrameLocator.make(frameLocator.frameLocator(selector)),
+			last: () => PlaywrightFrameLocator.make(frameLocator.last()),
+			nth: (index) => PlaywrightFrameLocator.make(frameLocator.nth(index)),
+			owner: () => PlaywrightLocator.make(frameLocator.owner()),
+			locator: (selectorOrLocator, options) => PlaywrightLocator.make(frameLocator.locator(unwrap(selectorOrLocator), options)),
+			getByRole: (role, options) => PlaywrightLocator.make(frameLocator.getByRole(role, options)),
+			getByText: (text, options) => PlaywrightLocator.make(frameLocator.getByText(text, options)),
+			getByLabel: (text, options) => PlaywrightLocator.make(frameLocator.getByLabel(text, options)),
+			getByPlaceholder: (text, options) => PlaywrightLocator.make(frameLocator.getByPlaceholder(text, options)),
+			getByAltText: (text, options) => PlaywrightLocator.make(frameLocator.getByAltText(text, options)),
+			getByTitle: (text, options) => PlaywrightLocator.make(frameLocator.getByTitle(text, options)),
+			getByTestId: (testId) => PlaywrightLocator.make(frameLocator.getByTestId(testId))
 		});
 	}
 };
@@ -240,8 +200,9 @@ var PlaywrightPage = class PlaywrightPage extends Context.Tag("effect-playwright
 			touchscreen: PlaywrightTouchscreen.make(page.touchscreen),
 			goto: (url, options) => use((p) => p.goto(url, options)),
 			setContent: (html, options) => use((p) => p.setContent(html, options)),
-			setDefaultNavigationTimeout: (timeout) => Effect.sync(() => page.setDefaultNavigationTimeout(timeout)),
-			setDefaultTimeout: (timeout) => Effect.sync(() => page.setDefaultTimeout(timeout)),
+			waitForTimeout: (timeout) => use((p) => p.waitForTimeout(timeout)),
+			setDefaultNavigationTimeout: (timeout) => page.setDefaultNavigationTimeout(timeout),
+			setDefaultTimeout: (timeout) => page.setDefaultTimeout(timeout),
 			setExtraHTTPHeaders: (headers) => use((p) => p.setExtraHTTPHeaders(headers)),
 			setViewportSize: (viewportSize) => use((p) => p.setViewportSize(viewportSize)),
 			viewportSize: () => Option.fromNullable(page.viewportSize()),
@@ -300,6 +261,145 @@ var PlaywrightPage = class PlaywrightPage extends Context.Tag("effect-playwright
 	}
 };
 //#endregion
+//#region src/locator.ts
+/**
+* A service that provides a `PlaywrightLocator` instance.
+*
+* @since 0.1.0
+* @category tag
+*/
+var PlaywrightLocator = class PlaywrightLocator extends Context.Tag("effect-playwright/PlaywrightLocator")() {
+	/**
+	* Creates a `PlaywrightLocator` from a Playwright `Locator` instance. This is mostly for internal use.
+	* But you could use this if you have used `use` or similar to wrap the locator.
+	*
+	* @example
+	* ```ts
+	* const playwrightNativeLocator = yield* page.use((p) => p.locator("button"));
+	* const locator = PlaywrightLocator.make(playwrightNativeLocator);
+	* ```
+	*
+	* @param locator - The Playwright `Locator` instance to wrap.
+	* @since 0.1.0
+	* @category constructor
+	*/
+	static make(locator) {
+		const use = useHelper(locator);
+		const unwrap = Match.type().pipe(Match.when(Predicate.hasProperty("_raw"), (l) => l._raw), Match.orElse((l) => l));
+		return PlaywrightLocator.of({
+			_raw: locator,
+			click: (options) => use((l) => l.click(options)),
+			check: (options) => use((l) => l.check(options)),
+			fill: (value, options) => use((l) => l.fill(value, options)),
+			getAttribute: (name, options) => use((l) => l.getAttribute(name, options)),
+			innerText: (options) => use((l) => l.innerText(options)),
+			innerHTML: (options) => use((l) => l.innerHTML(options)),
+			inputValue: (options) => use((l) => l.inputValue(options)),
+			textContent: (options) => use((l) => l.textContent(options)),
+			allInnerTexts: () => use((l) => l.allInnerTexts()),
+			allTextContents: () => use((l) => l.allTextContents()),
+			ariaSnapshot: (options) => use((l) => l.ariaSnapshot(options)),
+			boundingBox: (options) => use((l) => l.boundingBox(options)).pipe(Effect.map(Option.fromNullable)),
+			describe: (description) => PlaywrightLocator.make(locator.describe(description)),
+			description: () => Option.fromNullable(locator.description()),
+			count: use((l) => l.count()),
+			first: () => PlaywrightLocator.make(locator.first()),
+			last: () => PlaywrightLocator.make(locator.last()),
+			nth: (index) => PlaywrightLocator.make(locator.nth(index)),
+			all: () => use((l) => l.all()).pipe(Effect.map(Array.map(PlaywrightLocator.make))),
+			and: (locatorOrService) => PlaywrightLocator.make(locator.and(unwrap(locatorOrService))),
+			contentFrame: () => PlaywrightFrameLocator.make(locator.contentFrame()),
+			filter: (options) => PlaywrightLocator.make(locator.filter(options)),
+			frameLocator: (selector) => PlaywrightFrameLocator.make(locator.frameLocator(selector)),
+			or: (locatorOrService) => PlaywrightLocator.make(locator.or(unwrap(locatorOrService))),
+			page: () => PlaywrightPage.make(locator.page()),
+			locator: (selectorOrLocator, options) => PlaywrightLocator.make(typeof selectorOrLocator === "string" ? locator.locator(selectorOrLocator, options) : locator.locator(unwrap(selectorOrLocator), options)),
+			getByRole: (role, options) => PlaywrightLocator.make(locator.getByRole(role, options)),
+			getByText: (text, options) => PlaywrightLocator.make(locator.getByText(text, options)),
+			getByLabel: (text, options) => PlaywrightLocator.make(locator.getByLabel(text, options)),
+			getByPlaceholder: (text, options) => PlaywrightLocator.make(locator.getByPlaceholder(text, options)),
+			getByAltText: (text, options) => PlaywrightLocator.make(locator.getByAltText(text, options)),
+			getByTitle: (text, options) => PlaywrightLocator.make(locator.getByTitle(text, options)),
+			getByTestId: (testId) => PlaywrightLocator.make(locator.getByTestId(testId)),
+			isChecked: (options) => use((l) => l.isChecked(options)),
+			isDisabled: (options) => use((l) => l.isDisabled(options)),
+			isEditable: (options) => use((l) => l.isEditable(options)),
+			isEnabled: (options) => use((l) => l.isEnabled(options)),
+			isHidden: (options) => use((l) => l.isHidden(options)),
+			isVisible: (options) => use((l) => l.isVisible(options)),
+			waitFor: (options) => use((l) => l.waitFor(options)),
+			evaluate: (pageFunction, arg, options) => use((l) => l.evaluate(pageFunction, arg, options)),
+			evaluateAll: (pageFunction, arg) => use((l) => l.evaluateAll(pageFunction, arg)),
+			evaluateHandle: (pageFunction, arg) => use((l) => l.evaluateHandle(pageFunction, arg)),
+			elementHandle: (options) => use((l) => l.elementHandle(options)).pipe(Effect.map(Option.fromNullable)),
+			elementHandles: () => use((l) => l.elementHandles()),
+			highlight: () => use((l) => l.highlight()),
+			screenshot: (options) => use((l) => l.screenshot(options)),
+			blur: (options) => use((l) => l.blur(options)),
+			clear: (options) => use((l) => l.clear(options)),
+			dblclick: (options) => use((l) => l.dblclick(options)),
+			dispatchEvent: (type, eventInit, options) => use((l) => l.dispatchEvent(type, eventInit, options)),
+			dragTo: (target, options) => use((l) => l.dragTo(unwrap(target), options)),
+			focus: (options) => use((l) => l.focus(options)),
+			hover: (options) => use((l) => l.hover(options)),
+			press: (key, options) => use((l) => l.press(key, options)),
+			pressSequentially: (text, options) => use((l) => l.pressSequentially(text, options)),
+			scrollIntoViewIfNeeded: (options) => use((l) => l.scrollIntoViewIfNeeded(options)),
+			selectOption: (values, options) => use((l) => l.selectOption(values, options)),
+			selectText: (options) => use((l) => l.selectText(options)),
+			setChecked: (checked, options) => use((l) => l.setChecked(checked, options)),
+			setInputFiles: (files, options) => use((l) => l.setInputFiles(files, options)),
+			tap: (options) => use((l) => l.tap(options)),
+			uncheck: (options) => use((l) => l.uncheck(options)),
+			toString: () => locator.toString(),
+			use
+		});
+	}
+};
+//#endregion
+//#region src/frame.ts
+/**
+* @category tag
+* @since 0.1.2
+*/
+var PlaywrightFrame = class PlaywrightFrame extends Context.Tag("effect-playwright/PlaywrightFrame")() {
+	/**
+	* Creates a `PlaywrightFrame` from a Playwright `Frame` instance.
+	*
+	* @param frame - The Playwright `Frame` instance to wrap.
+	* @since 0.1.2
+	*/
+	static make(frame) {
+		const use = useHelper(frame);
+		return PlaywrightFrame.of({
+			goto: (url, options) => use((f) => f.goto(url, options)),
+			waitForURL: (url, options) => use((f) => f.waitForURL(url, options)),
+			waitForLoadState: (state, options) => use((f) => f.waitForLoadState(state, options)),
+			evaluate: (f, arg) => use((frame) => frame.evaluate(f, arg)),
+			title: use((f) => f.title()),
+			use,
+			locator: (selector, options) => PlaywrightLocator.make(frame.locator(selector, options)),
+			getByRole: (role, options) => PlaywrightLocator.make(frame.getByRole(role, options)),
+			getByText: (text, options) => PlaywrightLocator.make(frame.getByText(text, options)),
+			getByLabel: (label, options) => PlaywrightLocator.make(frame.getByLabel(label, options)),
+			getByTestId: (testId) => PlaywrightLocator.make(frame.getByTestId(testId)),
+			getByPlaceholder: (text, options) => PlaywrightLocator.make(frame.getByPlaceholder(text, options)),
+			getByAltText: (text, options) => PlaywrightLocator.make(frame.getByAltText(text, options)),
+			getByTitle: (text, options) => PlaywrightLocator.make(frame.getByTitle(text, options)),
+			page: () => PlaywrightPage.make(frame.page()),
+			parentFrame: () => Option.fromNullable(frame.parentFrame()).pipe(Option.map(PlaywrightFrame.make)),
+			childFrames: () => Array.map(frame.childFrames(), (f) => PlaywrightFrame.make(f)),
+			isDetached: () => frame.isDetached(),
+			waitForTimeout: (timeout) => use((f) => f.waitForTimeout(timeout)),
+			setContent: (html, options) => use((f) => f.setContent(html, options)),
+			url: () => frame.url(),
+			content: use((f) => f.content()),
+			name: () => frame.name(),
+			click: (selector, options) => use((f) => f.click(selector, options))
+		});
+	}
+};
+//#endregion
 //#region src/common.ts
 /**
 * @category model
@@ -311,7 +411,10 @@ var PlaywrightRequest = class PlaywrightRequest extends Data.TaggedClass("Playwr
 		return new PlaywrightRequest({
 			allHeaders: use(() => request.allHeaders()),
 			failure: Option.liftNullable(request.failure),
-			frame: Effect.sync(() => PlaywrightFrame.make(request.frame())),
+			frame: Effect.try({
+				try: () => PlaywrightFrame.make(request.frame()),
+				catch: wrapError
+			}),
 			headerValue: (name) => use(() => request.headerValue(name)).pipe(Effect.map(Option.fromNullable)),
 			headers: () => request.headers(),
 			headersArray: use(() => request.headersArray()),
@@ -342,7 +445,10 @@ var PlaywrightResponse = class PlaywrightResponse extends Data.TaggedClass("Play
 			allHeaders: use(() => response.allHeaders()),
 			body: use(() => response.body()),
 			finished: use(() => response.finished()),
-			frame: Effect.sync(() => PlaywrightFrame.make(response.frame())),
+			frame: Effect.try({
+				try: () => PlaywrightFrame.make(response.frame()),
+				catch: wrapError
+			}),
 			fromServiceWorker: () => response.fromServiceWorker(),
 			headers: () => response.headers(),
 			headersArray: use(() => response.headersArray()),
@@ -455,10 +561,21 @@ var PlaywrightBrowserContext = class PlaywrightBrowserContext extends Context.Ta
 		const use = useHelper(context);
 		return PlaywrightBrowserContext.of({
 			clock: PlaywrightClock.make(context.clock),
-			pages: Effect.sync(() => context.pages().map(PlaywrightPage.make)),
+			pages: () => context.pages().map(PlaywrightPage.make),
 			newPage: use((c) => c.newPage().then(PlaywrightPage.make)),
 			close: use((c) => c.close()),
 			addInitScript: (script, arg) => use((c) => c.addInitScript(script, arg)),
+			browser: () => Option.fromNullable(context.browser()).pipe(Option.map(PlaywrightBrowser.make)),
+			clearCookies: (options) => use((c) => c.clearCookies(options)),
+			clearPermissions: use((c) => c.clearPermissions()),
+			cookies: (urls) => use((c) => c.cookies(urls)),
+			addCookies: (cookies) => use((c) => c.addCookies(cookies)),
+			grantPermissions: (permissions, options) => use((c) => c.grantPermissions(permissions, options)),
+			setExtraHTTPHeaders: (headers) => use((c) => c.setExtraHTTPHeaders(headers)),
+			setGeolocation: (geolocation) => use((c) => c.setGeolocation(geolocation)),
+			setOffline: (offline) => use((c) => c.setOffline(offline)),
+			setDefaultNavigationTimeout: (timeout) => context.setDefaultNavigationTimeout(timeout),
+			setDefaultTimeout: (timeout) => context.setDefaultTimeout(timeout),
 			eventStream: (event) => Stream.asyncPush((emit) => Effect.acquireRelease(Effect.sync(() => {
 				context.on(event, emit.single);
 				context.once("close", emit.end);
@@ -547,4 +664,4 @@ var Playwright = class Playwright extends Context.Tag("effect-playwright/index/P
 	});
 };
 //#endregion
-export { PlaywrightError as _, PlaywrightDownload as a, PlaywrightResponse as c, PlaywrightTouchscreen as d, PlaywrightMouse as f, PlaywrightClock as g, PlaywrightLocator as h, PlaywrightDialog as i, PlaywrightWorker as l, PlaywrightFrame as m, PlaywrightBrowser as n, PlaywrightFileChooser as o, PlaywrightKeyboard as p, PlaywrightBrowserContext as r, PlaywrightRequest as s, Playwright as t, PlaywrightPage as u };
+export { PlaywrightError as _, PlaywrightDownload as a, PlaywrightResponse as c, PlaywrightLocator as d, PlaywrightPage as f, PlaywrightClock as g, PlaywrightKeyboard as h, PlaywrightDialog as i, PlaywrightWorker as l, PlaywrightMouse as m, PlaywrightBrowser as n, PlaywrightFileChooser as o, PlaywrightTouchscreen as p, PlaywrightBrowserContext as r, PlaywrightRequest as s, Playwright as t, PlaywrightFrame as u };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "effect-playwright",
   "type": "module",
-  "version": "0.3.0",
+  "version": "0.4.1",
   "description": "An Effect-based Playwright library.",
   "author": "Jobflow GmbH",
   "license": "ISC",
@@ -36,21 +36,21 @@
     "effect": "^3.19.6"
   },
   "devDependencies": {
-    "@biomejs/biome": "2.4.6",
-    "@effect/cli": "^0.73.2",
-    "@effect/language-service": "0.77.0",
-    "@effect/platform": "^0.94.5",
-    "@effect/platform-node": "^0.104.1",
-    "@effect/vitest": "^0.27.0",
-    "@types/node": "^25.3.3",
-    "effect": "^3.19.19",
+    "@biomejs/biome": "2.4.9",
+    "@effect/cli": "^0.75.0",
+    "@effect/language-service": "0.84.2",
+    "@effect/platform": "^0.96.0",
+    "@effect/platform-node": "^0.106.0",
+    "@effect/vitest": "^0.29.0",
+    "@types/node": "^25.5.0",
+    "effect": "^3.21.0",
     "playwright": "^1.58.2",
     "ts-morph": "^27.0.2",
-    "tsdown": "0.21.0",
+    "tsdown": "0.21.7",
     "tsx": "^4.21.0",
-    "typedoc": "^0.28.17",
-    "typescript": "^5.9.3",
-    "vitest": "^4.0.18"
+    "typedoc": "^0.28.18",
+    "typescript": "^6.0.2",
+    "vitest": "^4.1.2"
   },
   "types": "./dist/index.d.mts",
   "scripts": {