@remotion/renderer 4.0.0-preload.17 → 4.0.0-skia.20

package/dist/browser/Target.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Copyright 2019 Google Inc. All rights reserved.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import type { Browser, BrowserContext } from './Browser';
+import { Page } from './BrowserPage';
+import type { CDPSession } from './Connection';
+import type { TargetInfo } from './devtools-types';
+import type { Viewport } from './PuppeteerViewport';
+export declare class Target {
+    #private;
+    _initializedPromise: Promise<boolean>;
+    _initializedCallback: (x: boolean) => void;
+    _isClosedPromise: Promise<void>;
+    _closedCallback: () => void;
+    _isInitialized: boolean;
+    _targetId: string;
+    constructor(targetInfo: TargetInfo, browserContext: BrowserContext, sessionFactory: () => Promise<CDPSession>, defaultViewport: Viewport);
+    /**
+     * Creates a Chrome Devtools Protocol session attached to the target.
+     */
+    createCDPSession(): Promise<CDPSession>;
+    _getTargetInfo(): TargetInfo;
+    /**
+     * If the target is not of type `"page"` or `"background_page"`, returns `null`.
+     */
+    page(): Promise<Page | null>;
+    url(): string;
+    /**
+     * Identifies what kind of target this is.
+     *
+     * @remarks
+     *
+     * See {@link https://developer.chrome.com/extensions/background_pages | docs} for more info about background pages.
+     */
+    type(): 'page' | 'background_page' | 'service_worker' | 'shared_worker' | 'other' | 'browser' | 'webview';
+    /**
+     * Get the browser the target belongs to.
+     */
+    browser(): Browser;
+    /**
+     * Get the browser context the target belongs to.
+     */
+    browserContext(): BrowserContext;
+    /**
+     * Get the target that opened this target. Top-level targets return `null`.
+     */
+    opener(): Target | undefined;
+    _targetInfoChanged(targetInfo: TargetInfo): void;
+}

package/dist/browser/Target.js

@@ -0,0 +1,146 @@
+"use strict";
+/**
+ * Copyright 2019 Google Inc. All rights reserved.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
+    if (kind === "m") throw new TypeError("Private method is not writable");
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
+    return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
+};
+var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
+    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
+};
+var _Target_browserContext, _Target_targetInfo, _Target_sessionFactory, _Target_defaultViewport, _Target_pagePromise;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Target = void 0;
+const BrowserPage_1 = require("./BrowserPage");
+const isPagetTarget = (target) => {
+    return (target.type === 'page' ||
+        target.type === 'background_page' ||
+        target.type === 'webview');
+};
+class Target {
+    constructor(targetInfo, browserContext, sessionFactory, defaultViewport) {
+        _Target_browserContext.set(this, void 0);
+        _Target_targetInfo.set(this, void 0);
+        _Target_sessionFactory.set(this, void 0);
+        _Target_defaultViewport.set(this, void 0);
+        _Target_pagePromise.set(this, void 0);
+        __classPrivateFieldSet(this, _Target_targetInfo, targetInfo, "f");
+        __classPrivateFieldSet(this, _Target_browserContext, browserContext, "f");
+        this._targetId = targetInfo.targetId;
+        __classPrivateFieldSet(this, _Target_sessionFactory, sessionFactory, "f");
+        __classPrivateFieldSet(this, _Target_defaultViewport, defaultViewport, "f");
+        this._initializedPromise = new Promise((fulfill) => {
+            this._initializedCallback = fulfill;
+        }).then((success) => {
+            if (!success) {
+                return false;
+            }
+            const opener = this.opener();
+            if (!opener || !__classPrivateFieldGet(opener, _Target_pagePromise, "f") || this.type() !== 'page') {
+                return true;
+            }
+            return true;
+        });
+        this._isClosedPromise = new Promise((fulfill) => {
+            this._closedCallback = fulfill;
+        });
+        this._isInitialized =
+            !isPagetTarget(__classPrivateFieldGet(this, _Target_targetInfo, "f")) || __classPrivateFieldGet(this, _Target_targetInfo, "f").url !== '';
+        if (this._isInitialized) {
+            this._initializedCallback(true);
+        }
+    }
+    /**
+     * Creates a Chrome Devtools Protocol session attached to the target.
+     */
+    createCDPSession() {
+        return __classPrivateFieldGet(this, _Target_sessionFactory, "f").call(this);
+    }
+    _getTargetInfo() {
+        return __classPrivateFieldGet(this, _Target_targetInfo, "f");
+    }
+    /**
+     * If the target is not of type `"page"` or `"background_page"`, returns `null`.
+     */
+    async page() {
+        var _a;
+        if (isPagetTarget(__classPrivateFieldGet(this, _Target_targetInfo, "f")) && !__classPrivateFieldGet(this, _Target_pagePromise, "f")) {
+            __classPrivateFieldSet(this, _Target_pagePromise, __classPrivateFieldGet(this, _Target_sessionFactory, "f").call(this).then((client) => {
+                var _a;
+                return BrowserPage_1.Page._create(client, this, (_a = __classPrivateFieldGet(this, _Target_defaultViewport, "f")) !== null && _a !== void 0 ? _a : null, this.browser());
+            }), "f");
+        }
+        return (_a = (await __classPrivateFieldGet(this, _Target_pagePromise, "f"))) !== null && _a !== void 0 ? _a : null;
+    }
+    url() {
+        return __classPrivateFieldGet(this, _Target_targetInfo, "f").url;
+    }
+    /**
+     * Identifies what kind of target this is.
+     *
+     * @remarks
+     *
+     * See {@link https://developer.chrome.com/extensions/background_pages | docs} for more info about background pages.
+     */
+    type() {
+        const { type } = __classPrivateFieldGet(this, _Target_targetInfo, "f");
+        if (type === 'page' ||
+            type === 'background_page' ||
+            type === 'service_worker' ||
+            type === 'shared_worker' ||
+            type === 'browser' ||
+            type === 'webview') {
+            return type;
+        }
+        return 'other';
+    }
+    /**
+     * Get the browser the target belongs to.
+     */
+    browser() {
+        return __classPrivateFieldGet(this, _Target_browserContext, "f").browser();
+    }
+    /**
+     * Get the browser context the target belongs to.
+     */
+    browserContext() {
+        return __classPrivateFieldGet(this, _Target_browserContext, "f");
+    }
+    /**
+     * Get the target that opened this target. Top-level targets return `null`.
+     */
+    opener() {
+        const { openerId } = __classPrivateFieldGet(this, _Target_targetInfo, "f");
+        if (!openerId) {
+            return;
+        }
+        return this.browser()._targets.get(openerId);
+    }
+    _targetInfoChanged(targetInfo) {
+        __classPrivateFieldSet(this, _Target_targetInfo, targetInfo, "f");
+        if (!this._isInitialized &&
+            (!isPagetTarget(__classPrivateFieldGet(this, _Target_targetInfo, "f")) || __classPrivateFieldGet(this, _Target_targetInfo, "f").url !== '')) {
+            this._isInitialized = true;
+            this._initializedCallback(true);
+        }
+    }
+}
+exports.Target = Target;
+_Target_browserContext = new WeakMap(), _Target_targetInfo = new WeakMap(), _Target_sessionFactory = new WeakMap(), _Target_defaultViewport = new WeakMap(), _Target_pagePromise = new WeakMap();

package/dist/browser/TaskQueue.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Copyright 2020 Google Inc. All rights reserved.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+export declare class TaskQueue {
+    #private;
+    constructor();
+    postTask<T>(task: () => Promise<T>): Promise<T>;
+}

package/dist/browser/TaskQueue.js

@@ -0,0 +1,47 @@
+"use strict";
+/**
+ * Copyright 2020 Google Inc. All rights reserved.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
+    if (kind === "m") throw new TypeError("Private method is not writable");
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
+    return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
+};
+var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
+    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
+};
+var _TaskQueue_chain;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TaskQueue = void 0;
+class TaskQueue {
+    constructor() {
+        _TaskQueue_chain.set(this, void 0);
+        __classPrivateFieldSet(this, _TaskQueue_chain, Promise.resolve(), "f");
+    }
+    postTask(task) {
+        const result = __classPrivateFieldGet(this, _TaskQueue_chain, "f").then(task);
+        __classPrivateFieldSet(this, _TaskQueue_chain, result.then(() => {
+            return undefined;
+        }, () => {
+            return undefined;
+        }), "f");
+        return result;
+    }
+}
+exports.TaskQueue = TaskQueue;
+_TaskQueue_chain = new WeakMap();

package/dist/browser/TimeoutSettings.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Copyright 2019 Google Inc. All rights reserved.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+export declare class TimeoutSettings {
+    #private;
+    constructor();
+    setDefaultTimeout(timeout: number): void;
+    setDefaultNavigationTimeout(timeout: number): void;
+    navigationTimeout(): number;
+    timeout(): number;
+}

package/dist/browser/TimeoutSettings.js

@@ -0,0 +1,62 @@
+"use strict";
+/**
+ * Copyright 2019 Google Inc. All rights reserved.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
+    if (kind === "m") throw new TypeError("Private method is not writable");
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
+    return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
+};
+var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
+    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
+};
+var _TimeoutSettings_defaultTimeout, _TimeoutSettings_defaultNavigationTimeout;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TimeoutSettings = void 0;
+const DEFAULT_TIMEOUT = 30000;
+class TimeoutSettings {
+    constructor() {
+        _TimeoutSettings_defaultTimeout.set(this, void 0);
+        _TimeoutSettings_defaultNavigationTimeout.set(this, void 0);
+        __classPrivateFieldSet(this, _TimeoutSettings_defaultTimeout, null, "f");
+        __classPrivateFieldSet(this, _TimeoutSettings_defaultNavigationTimeout, null, "f");
+    }
+    setDefaultTimeout(timeout) {
+        __classPrivateFieldSet(this, _TimeoutSettings_defaultTimeout, timeout, "f");
+    }
+    setDefaultNavigationTimeout(timeout) {
+        __classPrivateFieldSet(this, _TimeoutSettings_defaultNavigationTimeout, timeout, "f");
+    }
+    navigationTimeout() {
+        if (__classPrivateFieldGet(this, _TimeoutSettings_defaultNavigationTimeout, "f") !== null) {
+            return __classPrivateFieldGet(this, _TimeoutSettings_defaultNavigationTimeout, "f");
+        }
+        if (__classPrivateFieldGet(this, _TimeoutSettings_defaultTimeout, "f") !== null) {
+            return __classPrivateFieldGet(this, _TimeoutSettings_defaultTimeout, "f");
+        }
+        return DEFAULT_TIMEOUT;
+    }
+    timeout() {
+        if (__classPrivateFieldGet(this, _TimeoutSettings_defaultTimeout, "f") !== null) {
+            return __classPrivateFieldGet(this, _TimeoutSettings_defaultTimeout, "f");
+        }
+        return DEFAULT_TIMEOUT;
+    }
+}
+exports.TimeoutSettings = TimeoutSettings;
+_TimeoutSettings_defaultTimeout = new WeakMap(), _TimeoutSettings_defaultNavigationTimeout = new WeakMap();

package/dist/browser/Tracing.d.ts

@@ -0,0 +1,45 @@
+/// <reference types="node" />
+import { CDPSession } from './Connection';
+/**
+ * @public
+ */
+export interface TracingOptions {
+    path?: string;
+    screenshots?: boolean;
+    categories?: string[];
+}
+/**
+ * The Tracing class exposes the tracing audit interface.
+ * @remarks
+ * You can use `tracing.start` and `tracing.stop` to create a trace file
+ * which can be opened in Chrome DevTools or {@link https://chromedevtools.github.io/timeline-viewer/ | timeline viewer}.
+ *
+ * @example
+ * ```js
+ * await page.tracing.start({path: 'trace.json'});
+ * await page.goto('https://www.google.com');
+ * await page.tracing.stop();
+ * ```
+ *
+ * @public
+ */
+export declare class Tracing {
+    #private;
+    /**
+     * @internal
+     */
+    constructor(client: CDPSession);
+    /**
+     * Starts a trace for the current page.
+     * @remarks
+     * Only one trace can be active at a time per browser.
+     *
+     * @param options - Optional `TracingOptions`.
+     */
+    start(options?: TracingOptions): Promise<void>;
+    /**
+     * Stops a trace started with the `start` method.
+     * @returns Promise which resolves to buffer with trace data.
+     */
+    stop(): Promise<Buffer | undefined>;
+}

package/dist/browser/Tracing.js

@@ -0,0 +1,136 @@
+"use strict";
+var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
+    if (kind === "m") throw new TypeError("Private method is not writable");
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
+    return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
+};
+var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
+    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
+};
+var _Tracing_client, _Tracing_recording, _Tracing_path;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Tracing = void 0;
+/**
+ * Copyright 2017 Google Inc. All rights reserved.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+const assert_1 = require("./assert");
+const util_1 = require("./util");
+/**
+ * The Tracing class exposes the tracing audit interface.
+ * @remarks
+ * You can use `tracing.start` and `tracing.stop` to create a trace file
+ * which can be opened in Chrome DevTools or {@link https://chromedevtools.github.io/timeline-viewer/ | timeline viewer}.
+ *
+ * @example
+ * ```js
+ * await page.tracing.start({path: 'trace.json'});
+ * await page.goto('https://www.google.com');
+ * await page.tracing.stop();
+ * ```
+ *
+ * @public
+ */
+class Tracing {
+    /**
+     * @internal
+     */
+    constructor(client) {
+        _Tracing_client.set(this, void 0);
+        _Tracing_recording.set(this, false);
+        _Tracing_path.set(this, void 0);
+        __classPrivateFieldSet(this, _Tracing_client, client, "f");
+    }
+    /**
+     * Starts a trace for the current page.
+     * @remarks
+     * Only one trace can be active at a time per browser.
+     *
+     * @param options - Optional `TracingOptions`.
+     */
+    async start(options = {}) {
+        (0, assert_1.assert)(!__classPrivateFieldGet(this, _Tracing_recording, "f"), 'Cannot start recording trace while already recording trace.');
+        const defaultCategories = [
+            '-*',
+            'devtools.timeline',
+            'v8.execute',
+            'disabled-by-default-devtools.timeline',
+            'disabled-by-default-devtools.timeline.frame',
+            'toplevel',
+            'blink.console',
+            'blink.user_timing',
+            'latencyInfo',
+            'disabled-by-default-devtools.timeline.stack',
+            'disabled-by-default-v8.cpu_profiler',
+        ];
+        const { path, screenshots = false, categories = defaultCategories } = options;
+        if (screenshots) {
+            categories.push('disabled-by-default-devtools.screenshot');
+        }
+        const excludedCategories = categories
+            .filter((cat) => {
+            return cat.startsWith('-');
+        })
+            .map((cat) => {
+            return cat.slice(1);
+        });
+        const includedCategories = categories.filter((cat) => {
+            return !cat.startsWith('-');
+        });
+        __classPrivateFieldSet(this, _Tracing_path, path, "f");
+        __classPrivateFieldSet(this, _Tracing_recording, true, "f");
+        await __classPrivateFieldGet(this, _Tracing_client, "f").send('Tracing.start', {
+            transferMode: 'ReturnAsStream',
+            traceConfig: {
+                excludedCategories,
+                includedCategories,
+            },
+        });
+    }
+    /**
+     * Stops a trace started with the `start` method.
+     * @returns Promise which resolves to buffer with trace data.
+     */
+    async stop() {
+        let resolve;
+        let reject;
+        const contentPromise = new Promise((x, y) => {
+            resolve = x;
+            reject = y;
+        });
+        __classPrivateFieldGet(this, _Tracing_client, "f").once('Tracing.tracingComplete', async (event) => {
+            try {
+                const readable = await (0, util_1.getReadableFromProtocolStream)(__classPrivateFieldGet(this, _Tracing_client, "f"), event.stream);
+                const buffer = await (0, util_1.getReadableAsBuffer)(readable, __classPrivateFieldGet(this, _Tracing_path, "f"));
+                resolve(buffer !== null && buffer !== void 0 ? buffer : undefined);
+            }
+            catch (error) {
+                if ((0, util_1.isErrorLike)(error)) {
+                    reject(error);
+                }
+                else {
+                    reject(new Error(`Unknown error: ${error}`));
+                }
+            }
+        });
+        await __classPrivateFieldGet(this, _Tracing_client, "f").send('Tracing.end');
+        __classPrivateFieldSet(this, _Tracing_recording, false, "f");
+        return contentPromise;
+    }
+}
+exports.Tracing = Tracing;
+_Tracing_client = new WeakMap(), _Tracing_recording = new WeakMap(), _Tracing_path = new WeakMap();

package/dist/browser/USKeyboardLayout.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Copyright 2017 Google Inc. All rights reserved.
+ *
+ * Licensed under the Apache License, Version 2.0 (the 'License');
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an 'AS IS' BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * @internal
+ */
+export interface KeyDefinition {
+    keyCode?: number;
+    shiftKeyCode?: number;
+    key?: string;
+    shiftKey?: string;
+    code?: string;
+    text?: string;
+    shiftText?: string;
+    location?: number;
+}
+/**
+ * All the valid keys that can be passed to functions that take user input, such
+ * as {@link Keyboard.press | keyboard.press }
+ *
+ * @public
+ */
+export declare type KeyInput = '0' | '1' | '2' | '3' | '4' | '5' | '6' | '7' | '8' | '9' | 'Power' | 'Eject' | 'Abort' | 'Help' | 'Backspace' | 'Tab' | 'Numpad5' | 'NumpadEnter' | 'Enter' | '\r' | '\n' | 'ShiftLeft' | 'ShiftRight' | 'ControlLeft' | 'ControlRight' | 'AltLeft' | 'AltRight' | 'Pause' | 'CapsLock' | 'Escape' | 'Convert' | 'NonConvert' | 'Space' | 'Numpad9' | 'PageUp' | 'Numpad3' | 'PageDown' | 'End' | 'Numpad1' | 'Home' | 'Numpad7' | 'ArrowLeft' | 'Numpad4' | 'Numpad8' | 'ArrowUp' | 'ArrowRight' | 'Numpad6' | 'Numpad2' | 'ArrowDown' | 'Select' | 'Open' | 'PrintScreen' | 'Insert' | 'Numpad0' | 'Delete' | 'NumpadDecimal' | 'Digit0' | 'Digit1' | 'Digit2' | 'Digit3' | 'Digit4' | 'Digit5' | 'Digit6' | 'Digit7' | 'Digit8' | 'Digit9' | 'KeyA' | 'KeyB' | 'KeyC' | 'KeyD' | 'KeyE' | 'KeyF' | 'KeyG' | 'KeyH' | 'KeyI' | 'KeyJ' | 'KeyK' | 'KeyL' | 'KeyM' | 'KeyN' | 'KeyO' | 'KeyP' | 'KeyQ' | 'KeyR' | 'KeyS' | 'KeyT' | 'KeyU' | 'KeyV' | 'KeyW' | 'KeyX' | 'KeyY' | 'KeyZ' | 'MetaLeft' | 'MetaRight' | 'ContextMenu' | 'NumpadMultiply' | 'NumpadAdd' | 'NumpadSubtract' | 'NumpadDivide' | 'F1' | 'F2' | 'F3' | 'F4' | 'F5' | 'F6' | 'F7' | 'F8' | 'F9' | 'F10' | 'F11' | 'F12' | 'F13' | 'F14' | 'F15' | 'F16' | 'F17' | 'F18' | 'F19' | 'F20' | 'F21' | 'F22' | 'F23' | 'F24' | 'NumLock' | 'ScrollLock' | 'AudioVolumeMute' | 'AudioVolumeDown' | 'AudioVolumeUp' | 'MediaTrackNext' | 'MediaTrackPrevious' | 'MediaStop' | 'MediaPlayPause' | 'Semicolon' | 'Equal' | 'NumpadEqual' | 'Comma' | 'Minus' | 'Period' | 'Slash' | 'Backquote' | 'BracketLeft' | 'Backslash' | 'BracketRight' | 'Quote' | 'AltGraph' | 'Props' | 'Cancel' | 'Clear' | 'Shift' | 'Control' | 'Alt' | 'Accept' | 'ModeChange' | ' ' | 'Print' | 'Execute' | '\u0000' | 'a' | 'b' | 'c' | 'd' | 'e' | 'f' | 'g' | 'h' | 'i' | 'j' | 'k' | 'l' | 'm' | 'n' | 'o' | 'p' | 'q' | 'r' | 's' | 't' | 'u' | 'v' | 'w' | 'x' | 'y' | 'z' | 'Meta' | '*' | '+' | '-' | '/' | ';' | '=' | ',' | '.' | '`' | '[' | '\\' | ']' | "'" | 'Attn' | 'CrSel' | 'ExSel' | 'EraseEof' | 'Play' | 'ZoomOut' | ')' | '!' | '@' | '#' | '$' | '%' | '^' | '&' | '(' | 'A' | 'B' | 'C' | 'D' | 'E' | 'F' | 'G' | 'H' | 'I' | 'J' | 'K' | 'L' | 'M' | 'N' | 'O' | 'P' | 'Q' | 'R' | 'S' | 'T' | 'U' | 'V' | 'W' | 'X' | 'Y' | 'Z' | ':' | '<' | '_' | '>' | '?' | '~' | '{' | '|' | '}' | '"' | 'SoftLeft' | 'SoftRight' | 'Camera' | 'Call' | 'EndCall' | 'VolumeDown' | 'VolumeUp';
+/**
+ * @internal
+ */
+export declare const _keyDefinitions: Readonly<Record<KeyInput, KeyDefinition>>;