google-closure-compiler 20250412.0.0-nightly → 20250413.0.0

package/externs/browser/w3c_keyboardlock.js

@@ -0,0 +1,47 @@
+/*
+ * Copyright 2020 The Closure Compiler Authors
+ *
+ * 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.
+ */
+
+/**
+ * @fileoverview Definitions for the W3C Keyboard Lock API.
+ * @see https://wicg.github.io/keyboard-lock/
+ * @externs
+ */
+
+/**
+ * Keyboard API object.
+ * @constructor
+ * @see https://w3c.github.io/keyboard-lock/#keyboard-interface
+ */
+function Keyboard() {}
+
+/**
+ * Lock the specified keys for this page, or all keys if keyCodes is omitted.
+ * @param {?Array<string>=} keyCodes
+ * @return {!Promise<undefined>}
+ */
+Keyboard.prototype.lock = function(keyCodes) {};
+
+/**
+ * Unlock any locked keys.
+ */
+Keyboard.prototype.unlock = function() {};
+
+
+/**
+ * @type {!Keyboard}
+ * @see https://w3c.github.io/keyboard-lock/#API
+ */
+Navigator.prototype.keyboard;

package/externs/browser/w3c_mediacapabilities.js

@@ -0,0 +1,206 @@
+/*
+ * Copyright 2019 The Closure Compiler Authors.
+ *
+ * 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.
+ */
+/**
+ * @fileoverview MediaCapabilities externs.
+ * Based on {@link https://w3c.github.io/media-capabilities/ MC draft 6 November
+ * 2019}.
+ * @externs
+ */
+
+/**
+ * @typedef {string}
+ * @see https://w3c.github.io/media-capabilities/#enumdef-hdrmetadatatype
+ */
+var HdrMetadataType;
+
+/**
+ * @typedef {string}
+ * @see https://w3c.github.io/media-capabilities/#enumdef-colorgamut
+ */
+var ColorGamut;
+
+/**
+ * @typedef {string}
+ * @see https://w3c.github.io/media-capabilities/#enumdef-transferfunction
+ */
+var TransferFunction;
+
+/**
+ * @typedef {string}
+ * @see https://w3c.github.io/media-capabilities/#enumdef-mediadecodingtype
+ */
+var MediaDecodingType;
+
+/**
+ * @typedef {string}
+ * @see https://w3c.github.io/media-capabilities/#enumdef-mediaencodingtype
+ */
+var MediaEncodingType;
+
+/**
+ * @typedef {{
+ *   contentType: string,
+ *   width: number,
+ *   height: number,
+ *   bitrate: number,
+ *   framerate: number,
+ *   hasAlphaChannel: (boolean|undefined),
+ *   hdrMetadataType: (!HdrMetadataType|undefined),
+ *   colorGamut: (!ColorGamut|undefined),
+ *   transferFunction: (!TransferFunction|undefined)
+ * }}
+ * @see https://w3c.github.io/media-capabilities/#dictdef-videoconfiguration
+ */
+var VideoConfiguration;
+
+// NOTE: channels definition below is not yet stable in the spec as of Dec 2019.
+// "The channels needs to be defined as a double (2.1, 4.1, 5.1, ...), an
+// unsigned short (number of channels) or as an enum value. The current
+// definition is a placeholder."
+/**
+ * @typedef {{
+ *   contentType: string,
+ *   channels: (*|undefined),
+ *   bitrate: (number|undefined),
+ *   samplerate: (number|undefined),
+ *   spatialRendering: (boolean|undefined)
+ * }}
+ * @see https://w3c.github.io/media-capabilities/#dictdef-audioconfiguration
+ */
+var AudioConfiguration;
+
+// NOTE: encryptionScheme is not yet in the MC spec as of Dec 2019, but has
+// already landed in EME and should be in MC soon.
+// https://github.com/w3c/media-capabilities/issues/100
+/**
+ * @typedef {{
+ *   robustness: (string|undefined),
+ *   encryptionScheme: (string|undefined)
+ * }}
+ * @see https://w3c.github.io/media-capabilities/#dictdef-keysystemtrackconfiguration
+ */
+var KeySystemTrackConfiguration;
+
+/**
+ * @typedef {{
+ *   keySystem: string,
+ *   initDataType: (string|undefined),
+ *   distinctiveIdentifier: (string|undefined),
+ *   persistentState: (string|undefined),
+ *   sessionTypes: (!Array<string>|undefined),
+ *   audio: (!KeySystemTrackConfiguration|undefined),
+ *   video: (!KeySystemTrackConfiguration|undefined)
+ * }}
+ * @see https://w3c.github.io/media-capabilities/#dictdef-mediacapabilitieskeysystemconfiguration
+ */
+var MediaCapabilitiesKeySystemConfiguration;
+
+/**
+ * @record
+ * @see https://w3c.github.io/media-capabilities/#dictdef-mediaconfiguration
+ */
+function MediaConfiguration() {}
+
+/** @type {!VideoConfiguration|undefined} */
+MediaConfiguration.prototype.video;
+
+/** @type {!AudioConfiguration|undefined} */
+MediaConfiguration.prototype.audio;
+
+/**
+ * @record
+ * @extends {MediaConfiguration}
+ * @see https://w3c.github.io/media-capabilities/#dictdef-mediadecodingconfiguration
+ */
+function MediaDecodingConfiguration() {}
+
+/** @type {!MediaDecodingType} */
+MediaDecodingConfiguration.prototype.type;
+
+/** @type {!MediaCapabilitiesKeySystemConfiguration|undefined} */
+MediaDecodingConfiguration.prototype.keySystemConfiguration;
+
+/**
+ * @record
+ * @extends {MediaConfiguration}
+ * @see https://w3c.github.io/media-capabilities/#dictdef-mediaencodingconfiguration
+ */
+function MediaEncodingConfiguration() {}
+
+/** @type {!MediaEncodingType} */
+MediaEncodingConfiguration.prototype.type;
+
+/**
+ * @record
+ * @see https://w3c.github.io/media-capabilities/#dictdef-mediacapabilitiesinfo
+ */
+function MediaCapabilitiesInfo() {}
+
+/** @type {boolean} */
+MediaCapabilitiesInfo.prototype.supported;
+
+/** @type {boolean} */
+MediaCapabilitiesInfo.prototype.smooth;
+
+/** @type {boolean} */
+MediaCapabilitiesInfo.prototype.powerEfficient;
+
+/**
+ * @record
+ * @extends {MediaCapabilitiesInfo}
+ * @see https://w3c.github.io/media-capabilities/#dictdef-mediacapabilitiesdecodinginfo
+ */
+function MediaCapabilitiesDecodingInfo() {}
+
+/** @type {?MediaKeySystemAccess} */
+MediaCapabilitiesDecodingInfo.prototype.keySystemAccess;
+
+/** @type {!MediaDecodingConfiguration} */
+MediaCapabilitiesDecodingInfo.prototype.configuration;
+
+/**
+ * @record
+ * @extends {MediaCapabilitiesInfo}
+ * @see https://w3c.github.io/media-capabilities/#dictdef-mediacapabilitiesencodinginfo
+ */
+function MediaCapabilitiesEncodingInfo() {}
+
+/** @type {!MediaEncodingConfiguration} */
+MediaCapabilitiesEncodingInfo.prototype.configuration;
+
+/**
+ * @interface
+ * @see https://w3c.github.io/media-capabilities/#mediacapabilities
+ */
+function MediaCapabilities() {}
+
+/**
+ * @param {!MediaDecodingConfiguration} configuration
+ * @return {!Promise<!MediaCapabilitiesDecodingInfo>}
+ */
+MediaCapabilities.prototype.decodingInfo = function(configuration) {};
+
+/**
+ * @param {!MediaEncodingConfiguration} configuration
+ * @return {!Promise<!MediaCapabilitiesEncodingInfo>}
+ */
+MediaCapabilities.prototype.encodingInfo = function(configuration) {};
+
+/** @const {?MediaCapabilities} */
+Navigator.prototype.mediaCapabilities;
+
+/** @const {?MediaCapabilities} */
+WorkerNavigator.prototype.mediaCapabilities;

package/externs/browser/w3c_midi.js

@@ -0,0 +1,301 @@
+/*
+ * Copyright 2014 The Closure Compiler Authors.
+ *
+ * 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.
+ */
+
+/**
+ * @fileoverview W3C Web MIDI specification.
+ * @see http://www.w3.org/TR/webmidi/
+ *
+ * @externs
+ */
+
+
+/**
+ * @param {!MIDIOptions=} opt_options
+ * @return {!Promise.<!MIDIAccess>}
+ */
+navigator.requestMIDIAccess = function(opt_options) {};
+
+
+/**
+ * @typedef {{
+ *   sysex: boolean
+ * }}
+ */
+var MIDIOptions;
+
+
+
+/**
+ * @interface
+ */
+var MIDIInputMap = function() {};
+
+
+/**
+ * @const {number}
+ */
+MIDIInputMap.prototype.size;
+
+
+/**
+ * @param {function(string)} iterator
+ */
+MIDIInputMap.prototype.keys = function(iterator) {};
+
+
+/**
+ * @param {function(!Array.<*>)} iterator
+ */
+MIDIInputMap.prototype.entries = function(iterator) {};
+
+
+/**
+ * @param {function(!MIDIInput)} iterator
+ */
+MIDIInputMap.prototype.values = function(iterator) {};
+
+
+/**
+ * @param {string} key
+ * @return {!MIDIInput}
+ */
+MIDIInputMap.prototype.get = function(key) {};
+
+
+/**
+ * @param {string} key
+ * @return {boolean}
+ */
+MIDIInputMap.prototype.has = function(key) {};
+
+
+
+/**
+ * @interface
+ */
+var MIDIOutputMap = function() {};
+
+
+/**
+ * @const {number}
+ */
+MIDIOutputMap.prototype.size;
+
+
+/**
+ * @param {function(string)} iterator
+ */
+MIDIOutputMap.prototype.keys = function(iterator) {};
+
+
+/**
+ * @param {function(!Array.<*>)} iterator
+ */
+MIDIOutputMap.prototype.entries = function(iterator) {};
+
+
+/**
+ * @param {function(!MIDIOutput)} iterator
+ */
+MIDIOutputMap.prototype.values = function(iterator) {};
+
+
+/**
+ * @param {string} key
+ * @return {!MIDIOutput}
+ */
+MIDIOutputMap.prototype.get = function(key) {};
+
+
+/**
+ * @param {string} key
+ * @return {boolean}
+ */
+MIDIOutputMap.prototype.has = function(key) {};
+
+
+
+/**
+ * @interface
+ * @extends {EventTarget}
+ */
+var MIDIAccess = function() {};
+
+
+/**
+ * @const {!MIDIInputMap}
+ */
+MIDIAccess.prototype.inputs;
+
+
+/**
+ * @const {!MIDIOutputMap}
+ */
+MIDIAccess.prototype.outputs;
+
+
+/**
+ * @const {function(!MIDIConnectionEvent)}
+ */
+MIDIAccess.prototype.onconnect;
+
+
+/**
+ * @type {function(!MIDIConnectionEvent)}
+ */
+MIDIAccess.prototype.ondisconnect;
+
+
+/**
+ * @const {boolean}
+ */
+MIDIAccess.prototype.sysexEnabled;
+
+
+
+/**
+ * @interface
+ * @extends {EventTarget}
+ */
+var MIDIPort = function() {};
+
+
+/**
+ * @const {string}
+ */
+MIDIPort.prototype.id;
+
+
+/**
+ * @const {string}
+ */
+MIDIPort.prototype.manufacturer;
+
+
+/**
+ * @const {string}
+ */
+MIDIPort.prototype.name;
+
+
+/**
+ * @const {string}
+ */
+MIDIPort.prototype.type;
+
+
+/**
+ * @const {string}
+ */
+MIDIPort.prototype.version;
+
+
+/**
+ * @type {function(!MIDIConnectionEvent)}
+ */
+MIDIPort.prototype.ondisconnect;
+
+
+
+/**
+ * @interface
+ * @extends {MIDIPort}
+ */
+var MIDIInput = function() {};
+
+
+/**
+ * @type {function(!MIDIMessageEvent)}
+ */
+MIDIInput.prototype.onmidimessage;
+
+
+
+/**
+ * @interface
+ * @extends {MIDIPort}
+ */
+var MIDIOutput = function() {};
+
+
+/**
+ * @param {!Uint8Array} data
+ * @param {number=} opt_timestamp
+ */
+MIDIOutput.prototype.send = function(data, opt_timestamp) {};
+
+
+
+/**
+ * @constructor
+ * @extends {Event}
+ * @param {string} type
+ * @param {!MIDIMessageEventInit=} opt_init
+ */
+var MIDIMessageEvent = function(type, opt_init) {};
+
+
+/**
+ * @const {number}
+ */
+MIDIMessageEvent.prototype.receivedTime;
+
+
+/**
+ * @const {!Uint8Array}
+ */
+MIDIMessageEvent.prototype.data;
+
+
+/**
+ * @record
+ * @extends {EventInit}
+ * @see https://www.w3.org/TR/webmidi/#midimessageeventinit-interface
+ */
+function MIDIMessageEventInit() {}
+
+/** @type {undefined|number} */
+MIDIMessageEventInit.prototype.receivedTime;
+
+/** @type {undefined|!Uint8Array} */
+MIDIMessageEventInit.prototype.data;
+
+
+
+/**
+ * @constructor
+ * @extends {Event}
+ * @param {string} type
+ * @param {!MIDIConnectionEventInit=} opt_init
+ */
+var MIDIConnectionEvent = function(type, opt_init) {};
+
+
+/**
+ * @const {MIDIPort}
+ */
+MIDIConnectionEvent.prototype.port;
+
+
+/**
+ * @record
+ * @extends {EventInit}
+ * @see https://www.w3.org/TR/webmidi/#idl-def-MIDIConnectionEventInit
+ */
+function MIDIConnectionEventInit() {}
+
+/** @type {undefined|!MIDIPort} */
+MIDIConnectionEventInit.prototype.port;

package/externs/browser/w3c_navigation.js

@@ -0,0 +1,72 @@
+/*
+ * Copyright 2025 The Closure Compiler Authors
+ *
+ * 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.
+ */
+
+/**
+ * @fileoverview Definitions for HTML Navigation History APIs.
+ * @see https://developer.mozilla.org/en-US/docs/Web/API/Navigation_API
+ * @externs
+ */
+
+// NavigationHistoryEntry
+
+/**
+ * @constructor
+ * @implements {EventTarget}
+ * @see https://html.spec.whatwg.org/multipage/nav-history-apis.html#navigationhistoryentry
+ */
+function NavigationHistoryEntry() {}
+
+/**
+ * @type {string}
+ * @see https://html.spec.whatwg.org/multipage/nav-history-apis.html#dom-navigationhistoryentry-id
+ */
+NavigationHistoryEntry.prototype.id;
+
+/**
+ * @type {number}
+ * @see https://html.spec.whatwg.org/multipage/nav-history-apis.html#dom-navigationhistoryentry-index
+ */
+NavigationHistoryEntry.prototype.index;
+
+/**
+ * @type {string}
+ * @see https://html.spec.whatwg.org/multipage/nav-history-apis.html#dom-navigationhistoryentry-key
+ */
+NavigationHistoryEntry.prototype.key;
+
+/**
+ * @type {string|null}
+ * @see https://html.spec.whatwg.org/multipage/nav-history-apis.html#dom-navigationhistoryentry-url
+ */
+NavigationHistoryEntry.prototype.url;
+
+/**
+ * @type {boolean}
+ * @see https://html.spec.whatwg.org/multipage/nav-history-apis.html#dom-navigationhistoryentry-samedocument
+ */
+NavigationHistoryEntry.prototype.sameDocument;
+
+/**
+ * @return {?}
+ * @see https://html.spec.whatwg.org/multipage/nav-history-apis.html#dom-navigationhistoryentry-getstate
+*/
+NavigationHistoryEntry.prototype.getState = function() {};
+
+/**
+ * @type {function(!Event)|undefined|null}
+ * @see https://html.spec.whatwg.org/multipage/nav-history-apis.html#dom-navigationhistoryentry-ondispose
+ */
+NavigationHistoryEntry.prototype.ondispose;