@olib-ai/owl-browser-sdk 2.0.5 → 2.0.7

package/dist/playwright/index.js

@@ -0,0 +1,313 @@
+/**
+ * Playwright-compatible API for Owl Browser.
+ *
+ * This module provides a drop-in Playwright-style API that translates
+ * Playwright method calls into Owl Browser tool executions. Import
+ * `chromium` (or `firefox`/`webkit` aliases) and use `.connect()` to
+ * establish a connection to a running Owl Browser server.
+ *
+ * @example
+ * ```typescript
+ * import { chromium } from '@olib-ai/owl-browser-sdk/playwright';
+ *
+ * const browser = await chromium.connect({
+ *   wsEndpoint: 'http://localhost:8080',
+ *   token: 'test-token',
+ * });
+ *
+ * const context = await browser.newContext({
+ *   viewport: { width: 1280, height: 720 },
+ *   locale: 'en-US',
+ * });
+ * const page = await context.newPage();
+ *
+ * await page.goto('https://example.com');
+ * await page.click('#submit');
+ * await page.fill('#email', 'user@example.com');
+ *
+ * // Network interception
+ * await page.route('**\/api/**', async route => {
+ *   await route.fulfill({ status: 200, body: '{"mock": true}' });
+ * });
+ *
+ * // Locators
+ * await page.getByRole('button', { name: 'Submit' }).click();
+ * await page.getByText('Welcome').isVisible();
+ *
+ * const title = await page.title();
+ * console.log('Page title:', title);
+ *
+ * await page.screenshot({ path: 'screenshot.png' });
+ *
+ * await context.close();
+ * await browser.close();
+ * ```
+ *
+ * @packageDocumentation
+ */
+// ==================== Classes ====================
+export { Browser } from './browser.js';
+export { BrowserContext } from './context.js';
+export { Page } from './page.js';
+export { queryAll, queryFirst, extractTable, extractMeta, extractStructuredData, countElements, } from './extractor.js';
+export { Locator, NthLocator } from './locator.js';
+export { Frame, FrameLocator, FrameScopedLocator } from './frame.js';
+export { Keyboard } from './keyboard.js';
+export { Mouse } from './mouse.js';
+export { Response, Request } from './response.js';
+export { BrowserType } from './browser-type.js';
+// Page helper classes
+export { Route, RouteRequest, Dialog, ConsoleMessage, Download, Video, } from './page-helpers.js';
+// ==================== Browser Type Instances ====================
+import { BrowserType } from './browser-type.js';
+/**
+ * Chromium browser type.
+ *
+ * Primary entry point for connecting to Owl Browser.
+ *
+ * @example
+ * ```typescript
+ * const browser = await chromium.connect({
+ *   wsEndpoint: 'http://localhost:8080',
+ *   token: 'test-token',
+ * });
+ * ```
+ */
+export const chromium = new BrowserType('chromium');
+/**
+ * Firefox browser type (alias for chromium).
+ *
+ * Owl Browser uses its own Chromium-based engine regardless of
+ * which browser type is used. This alias exists for Playwright
+ * code compatibility.
+ */
+export const firefox = new BrowserType('firefox');
+/**
+ * WebKit browser type (alias for chromium).
+ *
+ * Owl Browser uses its own Chromium-based engine regardless of
+ * which browser type is used. This alias exists for Playwright
+ * code compatibility.
+ */
+export const webkit = new BrowserType('webkit');
+/**
+ * Device descriptors for device emulation.
+ *
+ * Matches Playwright's `devices` dictionary for common mobile and
+ * tablet devices. Use with browser.newContext() to emulate a device.
+ *
+ * @example
+ * ```typescript
+ * import { chromium, devices } from '@olib-ai/owl-browser-sdk/playwright';
+ *
+ * const browser = await chromium.connect({ wsEndpoint: '...', token: '...' });
+ * const context = await browser.newContext({
+ *   ...devices['iPhone 14'],
+ * });
+ * ```
+ */
+export const devices = {
+    'Desktop Chrome': {
+        viewport: { width: 1280, height: 720 },
+        userAgent: 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36',
+        deviceScaleFactor: 1,
+        isMobile: false,
+        hasTouch: false,
+        defaultBrowserType: 'chromium',
+    },
+    'Desktop Firefox': {
+        viewport: { width: 1280, height: 720 },
+        userAgent: 'Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:121.0) Gecko/20100101 Firefox/121.0',
+        deviceScaleFactor: 1,
+        isMobile: false,
+        hasTouch: false,
+        defaultBrowserType: 'firefox',
+    },
+    'Desktop Safari': {
+        viewport: { width: 1280, height: 720 },
+        userAgent: 'Mozilla/5.0 (Macintosh; Intel Mac OS X 14_2) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/17.2 Safari/605.1.15',
+        deviceScaleFactor: 1,
+        isMobile: false,
+        hasTouch: false,
+        defaultBrowserType: 'webkit',
+    },
+    'iPhone 14': {
+        viewport: { width: 390, height: 844 },
+        userAgent: 'Mozilla/5.0 (iPhone; CPU iPhone OS 17_2 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/17.2 Mobile/15E148 Safari/604.1',
+        deviceScaleFactor: 3,
+        isMobile: true,
+        hasTouch: true,
+        defaultBrowserType: 'webkit',
+        screen: { width: 390, height: 844 },
+    },
+    'iPhone 14 Pro': {
+        viewport: { width: 393, height: 852 },
+        userAgent: 'Mozilla/5.0 (iPhone; CPU iPhone OS 17_2 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/17.2 Mobile/15E148 Safari/604.1',
+        deviceScaleFactor: 3,
+        isMobile: true,
+        hasTouch: true,
+        defaultBrowserType: 'webkit',
+        screen: { width: 393, height: 852 },
+    },
+    'iPhone 14 Pro Max': {
+        viewport: { width: 430, height: 932 },
+        userAgent: 'Mozilla/5.0 (iPhone; CPU iPhone OS 17_2 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/17.2 Mobile/15E148 Safari/604.1',
+        deviceScaleFactor: 3,
+        isMobile: true,
+        hasTouch: true,
+        defaultBrowserType: 'webkit',
+        screen: { width: 430, height: 932 },
+    },
+    'iPhone 15': {
+        viewport: { width: 393, height: 852 },
+        userAgent: 'Mozilla/5.0 (iPhone; CPU iPhone OS 17_2 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/17.2 Mobile/15E148 Safari/604.1',
+        deviceScaleFactor: 3,
+        isMobile: true,
+        hasTouch: true,
+        defaultBrowserType: 'webkit',
+        screen: { width: 393, height: 852 },
+    },
+    'iPhone 15 Pro': {
+        viewport: { width: 393, height: 852 },
+        userAgent: 'Mozilla/5.0 (iPhone; CPU iPhone OS 17_2 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/17.2 Mobile/15E148 Safari/604.1',
+        deviceScaleFactor: 3,
+        isMobile: true,
+        hasTouch: true,
+        defaultBrowserType: 'webkit',
+        screen: { width: 393, height: 852 },
+    },
+    'iPhone 13': {
+        viewport: { width: 390, height: 844 },
+        userAgent: 'Mozilla/5.0 (iPhone; CPU iPhone OS 16_0 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/16.0 Mobile/15E148 Safari/604.1',
+        deviceScaleFactor: 3,
+        isMobile: true,
+        hasTouch: true,
+        defaultBrowserType: 'webkit',
+        screen: { width: 390, height: 844 },
+    },
+    'iPhone 12': {
+        viewport: { width: 390, height: 844 },
+        userAgent: 'Mozilla/5.0 (iPhone; CPU iPhone OS 15_0 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/15.0 Mobile/15E148 Safari/604.1',
+        deviceScaleFactor: 3,
+        isMobile: true,
+        hasTouch: true,
+        defaultBrowserType: 'webkit',
+        screen: { width: 390, height: 844 },
+    },
+    'iPhone SE': {
+        viewport: { width: 375, height: 667 },
+        userAgent: 'Mozilla/5.0 (iPhone; CPU iPhone OS 17_2 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/17.2 Mobile/15E148 Safari/604.1',
+        deviceScaleFactor: 2,
+        isMobile: true,
+        hasTouch: true,
+        defaultBrowserType: 'webkit',
+        screen: { width: 375, height: 667 },
+    },
+    'iPad (gen 7)': {
+        viewport: { width: 810, height: 1080 },
+        userAgent: 'Mozilla/5.0 (iPad; CPU OS 17_2 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/17.2 Mobile/15E148 Safari/604.1',
+        deviceScaleFactor: 2,
+        isMobile: true,
+        hasTouch: true,
+        defaultBrowserType: 'webkit',
+        screen: { width: 810, height: 1080 },
+    },
+    'iPad Pro 11': {
+        viewport: { width: 834, height: 1194 },
+        userAgent: 'Mozilla/5.0 (iPad; CPU OS 17_2 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/17.2 Mobile/15E148 Safari/604.1',
+        deviceScaleFactor: 2,
+        isMobile: true,
+        hasTouch: true,
+        defaultBrowserType: 'webkit',
+        screen: { width: 834, height: 1194 },
+    },
+    'iPad Mini': {
+        viewport: { width: 768, height: 1024 },
+        userAgent: 'Mozilla/5.0 (iPad; CPU OS 17_2 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/17.2 Mobile/15E148 Safari/604.1',
+        deviceScaleFactor: 2,
+        isMobile: true,
+        hasTouch: true,
+        defaultBrowserType: 'webkit',
+        screen: { width: 768, height: 1024 },
+    },
+    'Pixel 7': {
+        viewport: { width: 412, height: 915 },
+        userAgent: 'Mozilla/5.0 (Linux; Android 14; Pixel 7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Mobile Safari/537.36',
+        deviceScaleFactor: 2.625,
+        isMobile: true,
+        hasTouch: true,
+        defaultBrowserType: 'chromium',
+        screen: { width: 412, height: 915 },
+    },
+    'Pixel 5': {
+        viewport: { width: 393, height: 851 },
+        userAgent: 'Mozilla/5.0 (Linux; Android 13; Pixel 5) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Mobile Safari/537.36',
+        deviceScaleFactor: 2.75,
+        isMobile: true,
+        hasTouch: true,
+        defaultBrowserType: 'chromium',
+        screen: { width: 393, height: 851 },
+    },
+    'Galaxy S21': {
+        viewport: { width: 360, height: 800 },
+        userAgent: 'Mozilla/5.0 (Linux; Android 13; SM-G991B) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Mobile Safari/537.36',
+        deviceScaleFactor: 3,
+        isMobile: true,
+        hasTouch: true,
+        defaultBrowserType: 'chromium',
+        screen: { width: 360, height: 800 },
+    },
+    'Galaxy S23': {
+        viewport: { width: 360, height: 780 },
+        userAgent: 'Mozilla/5.0 (Linux; Android 14; SM-S911B) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Mobile Safari/537.36',
+        deviceScaleFactor: 3,
+        isMobile: true,
+        hasTouch: true,
+        defaultBrowserType: 'chromium',
+        screen: { width: 360, height: 780 },
+    },
+    'Galaxy Tab S8': {
+        viewport: { width: 800, height: 1280 },
+        userAgent: 'Mozilla/5.0 (Linux; Android 13; SM-X700) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36',
+        deviceScaleFactor: 1.5,
+        isMobile: true,
+        hasTouch: true,
+        defaultBrowserType: 'chromium',
+        screen: { width: 800, height: 1280 },
+    },
+};
+// ==================== Selectors ====================
+/**
+ * Selectors utility for registering custom selector engines.
+ *
+ * Provides a Playwright-compatible API for selector engine management.
+ * In Owl Browser, selectors are handled natively by the semantic matcher.
+ */
+export const selectors = {
+    /**
+     * Register a custom selector engine.
+     *
+     * Stub: Owl Browser uses its own semantic matching engine.
+     *
+     * @param name - Engine name
+     * @param script - Engine implementation
+     */
+    async register(name, script) {
+        void name;
+        void script;
+    },
+};
+// ==================== Errors ====================
+export { OwlBrowserError, ConnectionError, AuthenticationError, ToolExecutionError, TimeoutError, } from '../errors.js';
+// ==================== Default Export ====================
+/**
+ * Default export matching Playwright's module structure.
+ *
+ * @example
+ * ```typescript
+ * import playwright from '@olib-ai/owl-browser-sdk/playwright';
+ * const browser = await playwright.chromium.connect({ ... });
+ * ```
+ */
+export default { chromium, firefox, webkit, devices, selectors };
+//# sourceMappingURL=index.js.map

package/dist/playwright/index.js.map

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

package/dist/playwright/keyboard.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Playwright-compatible Keyboard class for Owl Browser.
+ *
+ * Maps Playwright keyboard operations to Owl Browser tool executions.
+ * Supports key combinations via browser_keyboard_combo and single key
+ * presses via browser_press_key, with proper Playwright key name mapping.
+ */
+import type { OwlBrowser } from '../client.js';
+/**
+ * Keyboard provides methods for simulating keyboard input.
+ *
+ * Mirrors the Playwright Keyboard API. Key names follow the
+ * Playwright/CDP key naming convention (e.g., 'Enter', 'Tab', 'ArrowDown').
+ */
+export declare class Keyboard {
+    private readonly _client;
+    private readonly _contextId;
+    private readonly _pressedModifiers;
+    constructor(client: OwlBrowser, contextId: string);
+    /**
+     * Press a key combination and release immediately.
+     *
+     * Supports key combinations with '+' separator (e.g., 'Control+a', 'Meta+Shift+p').
+     * Single keys are dispatched via browser_press_key.
+     * Combinations with modifiers use browser_keyboard_combo.
+     *
+     * @param key - Key name or combination (e.g., 'Enter', 'Control+c')
+     * @param options - Optional delay between keyDown and keyUp in ms
+     */
+    press(key: string, options?: {
+        delay?: number;
+    }): Promise<void>;
+    /**
+     * Type text character by character with human-like keystroke simulation.
+     *
+     * Unlike press(), this dispatches individual character input events.
+     * For typing into a specific element, use page.type(selector, text) instead.
+     *
+     * @param text - Text to type
+     * @param options - Optional delay between keystrokes in ms
+     */
+    type(text: string, options?: {
+        delay?: number;
+    }): Promise<void>;
+    /**
+     * Insert text directly without dispatching individual key events.
+     *
+     * Faster than type() but does not trigger keydown/keyup events.
+     *
+     * @param text - Text to insert
+     */
+    insertText(text: string): Promise<void>;
+    /**
+     * Press and hold a key (dispatches keydown event).
+     *
+     * Must be followed by a corresponding up() call.
+     * Primarily used for modifier keys (Shift, Control, Alt, Meta).
+     *
+     * @param key - Key name to press down
+     */
+    down(key: string): Promise<void>;
+    /**
+     * Release a previously held key (dispatches keyup event).
+     *
+     * @param key - Key name to release
+     */
+    up(key: string): Promise<void>;
+    /**
+     * Normalize Playwright modifier names to Owl combo format.
+     * Playwright uses 'Control', Owl expects 'Ctrl'.
+     */
+    private _normalizeModifier;
+}
+//# sourceMappingURL=keyboard.d.ts.map

package/dist/playwright/keyboard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"keyboard.d.ts","sourceRoot":"","sources":["../../src/playwright/keyboard.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAqC/C;;;;;GAKG;AACH,qBAAa,QAAQ;IACnB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAa;IACrC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAA0B;gBAEhD,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM;IAKjD;;;;;;;;;OASG;IACG,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IA+BrE;;;;;;;;OAQG;IACG,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAUrE;;;;;;OAMG;IACG,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAS7C;;;;;;;OAOG;IACG,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAYtC;;;;OAIG;IACG,EAAE,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAMpC;;;OAGG;IACH,OAAO,CAAC,kBAAkB;CAsB3B"}

package/dist/playwright/keyboard.js

@@ -0,0 +1,187 @@
+/**
+ * Playwright-compatible Keyboard class for Owl Browser.
+ *
+ * Maps Playwright keyboard operations to Owl Browser tool executions.
+ * Supports key combinations via browser_keyboard_combo and single key
+ * presses via browser_press_key, with proper Playwright key name mapping.
+ */
+/**
+ * Map of Playwright key names to Owl Browser key names.
+ * Owl Browser accepts CDP-compatible key names, but some Playwright
+ * shortcuts differ in casing or naming.
+ */
+const KEY_MAP = {
+    'ArrowUp': 'ArrowUp',
+    'ArrowDown': 'ArrowDown',
+    'ArrowLeft': 'ArrowLeft',
+    'ArrowRight': 'ArrowRight',
+    'Backspace': 'Backspace',
+    'Delete': 'Delete',
+    'End': 'End',
+    'Enter': 'Enter',
+    'Escape': 'Escape',
+    'Home': 'Home',
+    'Insert': 'Insert',
+    'PageDown': 'PageDown',
+    'PageUp': 'PageUp',
+    'Space': 'Space',
+    'Tab': 'Tab',
+    'F1': 'F1', 'F2': 'F2', 'F3': 'F3', 'F4': 'F4',
+    'F5': 'F5', 'F6': 'F6', 'F7': 'F7', 'F8': 'F8',
+    'F9': 'F9', 'F10': 'F10', 'F11': 'F11', 'F12': 'F12',
+};
+/** Modifier key names recognized by Playwright. */
+const MODIFIER_KEYS = new Set([
+    'Shift', 'Control', 'Alt', 'Meta',
+    'ShiftLeft', 'ShiftRight',
+    'ControlLeft', 'ControlRight',
+    'AltLeft', 'AltRight',
+    'MetaLeft', 'MetaRight',
+]);
+/**
+ * Keyboard provides methods for simulating keyboard input.
+ *
+ * Mirrors the Playwright Keyboard API. Key names follow the
+ * Playwright/CDP key naming convention (e.g., 'Enter', 'Tab', 'ArrowDown').
+ */
+export class Keyboard {
+    _client;
+    _contextId;
+    _pressedModifiers = new Set();
+    constructor(client, contextId) {
+        this._client = client;
+        this._contextId = contextId;
+    }
+    /**
+     * Press a key combination and release immediately.
+     *
+     * Supports key combinations with '+' separator (e.g., 'Control+a', 'Meta+Shift+p').
+     * Single keys are dispatched via browser_press_key.
+     * Combinations with modifiers use browser_keyboard_combo.
+     *
+     * @param key - Key name or combination (e.g., 'Enter', 'Control+c')
+     * @param options - Optional delay between keyDown and keyUp in ms
+     */
+    async press(key, options) {
+        void options;
+        const parts = key.split('+');
+        if (parts.length > 1) {
+            // Key combination: map to browser_keyboard_combo
+            const combo = parts.map(p => this._normalizeModifier(p.trim())).join('+');
+            await this._client.execute('browser_keyboard_combo', {
+                context_id: this._contextId,
+                combo,
+            });
+        }
+        else if (KEY_MAP[key] !== undefined) {
+            // Known special key — use browser_press_key
+            await this._client.execute('browser_press_key', {
+                context_id: this._contextId,
+                key: KEY_MAP[key],
+            });
+        }
+        else if (key.length === 1) {
+            // Single character (a-z, 0-9, punctuation) — use native browser_press_key
+            await this._client.execute('browser_press_key', {
+                context_id: this._contextId,
+                key,
+            });
+        }
+        else {
+            // Unknown key name — try browser_press_key and let the server validate
+            await this._client.execute('browser_press_key', {
+                context_id: this._contextId,
+                key,
+            });
+        }
+    }
+    /**
+     * Type text character by character with human-like keystroke simulation.
+     *
+     * Unlike press(), this dispatches individual character input events.
+     * For typing into a specific element, use page.type(selector, text) instead.
+     *
+     * @param text - Text to type
+     * @param options - Optional delay between keystrokes in ms
+     */
+    async type(text, options) {
+        void options;
+        // Use browser_type with empty selector to type into the currently focused element.
+        await this._client.execute('browser_type', {
+            context_id: this._contextId,
+            selector: '',
+            text,
+        });
+    }
+    /**
+     * Insert text directly without dispatching individual key events.
+     *
+     * Faster than type() but does not trigger keydown/keyup events.
+     *
+     * @param text - Text to insert
+     */
+    async insertText(text) {
+        // Use browser_type with empty selector to insert into the currently focused element.
+        await this._client.execute('browser_type', {
+            context_id: this._contextId,
+            selector: '',
+            text,
+        });
+    }
+    /**
+     * Press and hold a key (dispatches keydown event).
+     *
+     * Must be followed by a corresponding up() call.
+     * Primarily used for modifier keys (Shift, Control, Alt, Meta).
+     *
+     * @param key - Key name to press down
+     */
+    async down(key) {
+        this._pressedModifiers.add(key);
+        if (!MODIFIER_KEYS.has(key)) {
+            // For non-modifier keys, dispatch as a press since Owl Browser
+            // does not have separate down/up semantics.
+            await this._client.execute('browser_press_key', {
+                context_id: this._contextId,
+                key: KEY_MAP[key] ?? key,
+            });
+        }
+    }
+    /**
+     * Release a previously held key (dispatches keyup event).
+     *
+     * @param key - Key name to release
+     */
+    async up(key) {
+        this._pressedModifiers.delete(key);
+        // Owl Browser handles key release automatically with press_key.
+        // This method maintains state for API compatibility.
+    }
+    /**
+     * Normalize Playwright modifier names to Owl combo format.
+     * Playwright uses 'Control', Owl expects 'Ctrl'.
+     */
+    _normalizeModifier(key) {
+        switch (key) {
+            case 'Control':
+            case 'ControlLeft':
+            case 'ControlRight':
+                return 'Ctrl';
+            case 'Meta':
+            case 'MetaLeft':
+            case 'MetaRight':
+                return 'Meta';
+            case 'Shift':
+            case 'ShiftLeft':
+            case 'ShiftRight':
+                return 'Shift';
+            case 'Alt':
+            case 'AltLeft':
+            case 'AltRight':
+                return 'Alt';
+            default:
+                return key;
+        }
+    }
+}
+//# sourceMappingURL=keyboard.js.map

package/dist/playwright/keyboard.js.map

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