google-closure-compiler 20250412.0.0-nightly → 20250413.0.0

package/externs/browser/w3c_eventsource.js

@@ -0,0 +1,110 @@
+/*
+ * Copyright 2012 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 W3C's EventSource API.
+ * @see https://html.spec.whatwg.org/multipage/server-sent-events.html#server-sent-events
+ *
+ * @externs
+ */
+
+/** @record */
+function EventSourceInit() {};
+
+/** @type {(boolean|undefined)} */
+EventSourceInit.prototype.withCredentials;
+
+/**
+ * @constructor
+ * @implements {EventTarget}
+ * @param {!URL|string} url
+ * @param {EventSourceInit=} opt_eventSourceInitDict
+ */
+function EventSource(url, opt_eventSourceInitDict) {}
+
+/** @override */
+EventSource.prototype.addEventListener = function(type, listener, opt_options) {
+};
+
+/** @override */
+EventSource.prototype.removeEventListener = function(
+    type, listener, opt_options) {};
+
+/** @override */
+EventSource.prototype.dispatchEvent = function(evt) {};
+
+/**
+ * @const {string}
+ */
+EventSource.prototype.url;
+
+/** @const {boolean} */
+EventSource.prototype.withCredentials;
+
+/**
+ * @const {number}
+ */
+EventSource.prototype.CONNECTING;
+
+/**
+ * @const {number}
+ */
+EventSource.CONNECTING;
+
+/**
+ * @const {number}
+ */
+EventSource.prototype.OPEN;
+
+/**
+ * @const {number}
+ */
+EventSource.OPEN;
+
+/**
+ * @const {number}
+ */
+EventSource.prototype.CLOSED;
+
+/**
+ * @const {number}
+ */
+EventSource.CLOSED;
+
+/**
+ * @const {number}
+ */
+EventSource.prototype.readyState;
+
+/**
+ * @type {?function(!Event): void}
+ */
+EventSource.prototype.onopen = function(e) {};
+
+/**
+ * @type {?function(!MessageEvent<string>): void}
+ */
+EventSource.prototype.onmessage = function(e) {};
+
+/**
+ * @type {?function(!Event): void}
+ */
+EventSource.prototype.onerror = function(e) {};
+
+/**
+ * @return {undefined}
+ */
+EventSource.prototype.close = function() {};

package/externs/browser/w3c_fileapi.js

@@ -0,0 +1,302 @@
+/*
+ * Copyright 2010 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 objects in the File API, File Writer API, and
+ * File System API. Details of the API are at:
+ * http://www.w3.org/TR/FileAPI/
+ *
+ * @externs
+ */
+
+/** @record */
+function BlobPropertyBag() {};
+
+/** @type {(string|undefined)} */
+BlobPropertyBag.prototype.type;
+
+/**
+ * @see http://dev.w3.org/2006/webapi/FileAPI/#dfn-Blob
+ * @param {Array<ArrayBuffer|ArrayBufferView|Blob|string>=} opt_blobParts
+ * @param {BlobPropertyBag=} opt_options
+ * @constructor
+ * @nosideeffects
+ */
+function Blob(opt_blobParts, opt_options) {}
+
+/**
+ * @see http://www.w3.org/TR/FileAPI/#dfn-size
+ * @type {number}
+ */
+Blob.prototype.size;
+
+/**
+ * @see http://www.w3.org/TR/FileAPI/#dfn-type
+ * @type {string}
+ */
+Blob.prototype.type;
+
+/**
+ * @see http://www.w3.org/TR/FileAPI/#dfn-slice
+ * @param {number=} start
+ * @param {number=} length
+ * @param {string=} opt_contentType
+ * @return {!Blob}
+ * @nosideeffects
+ */
+Blob.prototype.slice = function(start, length, opt_contentType) {};
+
+/**
+ * @see http://www.w3.org/TR/FileAPI/#arraybuffer-method-algo
+ * @return {!Promise<!ArrayBuffer>}
+ * @nosideeffects
+ */
+Blob.prototype.arrayBuffer = function() {};
+
+/**
+ * @see https://www.w3.org/TR/FileAPI/#bytes-method-algo
+ * @return {!Promise<!Uint8Array>}
+ * @nosideeffects
+ */
+Blob.prototype.bytes = function() {};
+
+/**
+ * @see https://www.w3.org/TR/FileAPI/#dom-blob-text
+ * @return {!Promise<string>}
+ * @nosideeffects
+ */
+Blob.prototype.text = function() {};
+
+
+/**
+ * @record
+ * @extends {BlobPropertyBag}
+ **/
+function FilePropertyBag() {};
+
+/** @type {(number|undefined)} */
+FilePropertyBag.prototype.lastModified;
+
+/**
+ * @see http://www.w3.org/TR/FileAPI/#dfn-file
+ * @param {!Array<string|!Blob|!ArrayBuffer>=} contents
+ * @param {string=} name
+ * @param {FilePropertyBag=} properties
+ * @constructor
+ * @extends {Blob}
+ */
+function File(contents, name, properties) {}
+
+/**
+ * Chrome uses this instead of name.
+ * @deprecated Use name instead.
+ * @type {string}
+ */
+File.prototype.fileName;
+
+/**
+ * Chrome uses this instead of size.
+ * @deprecated Use size instead.
+ * @type {string}
+ */
+File.prototype.fileSize;
+
+/**
+ * @see http://www.w3.org/TR/FileAPI/#dfn-name
+ * @type {string}
+ */
+File.prototype.name;
+
+/**
+ * @see http://www.w3.org/TR/FileAPI/#dfn-lastModifiedDate
+ * @type {Date}
+ */
+File.prototype.lastModifiedDate;
+
+/**
+ * @see http://www.w3.org/TR/FileAPI/#dfn-lastModified
+ * @type {number}
+ */
+File.prototype.lastModified;
+
+/**
+ * @see http://www.w3.org/TR/FileAPI/#dfn-filereader
+ * @constructor
+ * @implements {EventTarget}
+ */
+function FileReader() {}
+
+/** @override */
+FileReader.prototype.addEventListener = function(type, listener, opt_options) {
+};
+
+/** @override */
+FileReader.prototype.removeEventListener = function(
+    type, listener, opt_options) {};
+
+/** @override */
+FileReader.prototype.dispatchEvent = function(evt) {};
+
+/**
+ * @see http://www.w3.org/TR/FileAPI/#dfn-readAsArrayBuffer
+ * @param {!Blob} blob
+ * @return {undefined}
+ */
+FileReader.prototype.readAsArrayBuffer = function(blob) {};
+
+/**
+ * @see http://www.w3.org/TR/FileAPI/#dfn-readAsBinaryStringAsync
+ * @param {!Blob} blob
+ * @return {undefined}
+ */
+FileReader.prototype.readAsBinaryString = function(blob) {};
+
+/**
+ * @see http://www.w3.org/TR/FileAPI/#dfn-readAsText
+ * @param {!Blob} blob
+ * @param {string=} encoding
+ * @return {undefined}
+ */
+FileReader.prototype.readAsText = function(blob, encoding) {};
+
+/**
+ * @see http://www.w3.org/TR/FileAPI/#dfn-readAsDataURL
+ * @param {!Blob} blob
+ * @return {undefined}
+ */
+FileReader.prototype.readAsDataURL = function(blob) {};
+
+/**
+ * @see http://www.w3.org/TR/FileAPI/#dfn-abort
+ * @return {undefined}
+ */
+FileReader.prototype.abort = function() {};
+
+/**
+ * @see http://www.w3.org/TR/FileAPI/#dfn-empty
+ * @const {number}
+ */
+FileReader.prototype.EMPTY;
+
+/** @const {number} */
+FileReader.EMPTY;
+
+/**
+ * @see http://www.w3.org/TR/FileAPI/#dfn-loading
+ * @const {number}
+ */
+FileReader.prototype.LOADING;
+
+/** @const {number} */
+FileReader.LOADING;
+
+/**
+ * @see http://www.w3.org/TR/FileAPI/#dfn-done
+ * @const {number}
+ */
+FileReader.prototype.DONE;
+
+/** @const {number} */
+FileReader.DONE;
+
+/**
+ * @see http://www.w3.org/TR/FileAPI/#dfn-readystate
+ * @type {number}
+ */
+FileReader.prototype.readyState;
+
+/**
+ * @see http://www.w3.org/TR/FileAPI/#dfn-result
+ * @type {string|Blob|ArrayBuffer}
+ */
+FileReader.prototype.result;
+
+/**
+ * @see http://www.w3.org/TR/FileAPI/#dfn-error
+ * @type {DOMError}
+ */
+FileReader.prototype.error;
+
+/**
+ * @see http://www.w3.org/TR/FileAPI/#dfn-onloadstart
+ * @type {?function(!ProgressEvent<!FileReader>)}
+ */
+FileReader.prototype.onloadstart;
+
+/**
+ * @see http://www.w3.org/TR/FileAPI/#dfn-onprogress
+ * @type {?function(!ProgressEvent<!FileReader>)}
+ */
+FileReader.prototype.onprogress;
+
+/**
+ * @see http://www.w3.org/TR/FileAPI/#dfn-onload
+ * @type {?function(!ProgressEvent<!FileReader>)}
+ */
+FileReader.prototype.onload;
+
+/**
+ * @see http://www.w3.org/TR/FileAPI/#dfn-onabort
+ * @type {?function(!ProgressEvent<!FileReader>)}
+ */
+FileReader.prototype.onabort;
+
+/**
+ * @see http://www.w3.org/TR/FileAPI/#dfn-onerror
+ * @type {?function(!ProgressEvent<!FileReader>)}
+ */
+FileReader.prototype.onerror;
+
+/**
+ * @see http://www.w3.org/TR/FileAPI/#dfn-onloadend
+ * @type {?function(!ProgressEvent<!FileReader>)}
+ */
+FileReader.prototype.onloadend;
+
+
+/**
+ * @see http://www.w3.org/TR/FileAPI/#FileReaderSyncSync
+ * @constructor
+ */
+function FileReaderSync() {}
+
+/**
+ * @see http://www.w3.org/TR/FileAPI/#dfn-readAsArrayBufferSync
+ * @param {!Blob} blob
+ * @return {!ArrayBuffer}
+ */
+FileReaderSync.prototype.readAsArrayBuffer = function(blob) {};
+
+/**
+ * @see http://www.w3.org/TR/FileAPI/#dfn-readAsBinaryStringSync
+ * @param {!Blob} blob
+ * @return {string}
+ */
+FileReaderSync.prototype.readAsBinaryString = function(blob) {};
+
+/**
+ * @see http://www.w3.org/TR/FileAPI/#dfn-readAsTextSync
+ * @param {!Blob} blob
+ * @param {string=} encoding
+ * @return {string}
+ */
+FileReaderSync.prototype.readAsText = function(blob, encoding) {};
+
+/**
+ * @see http://www.w3.org/TR/FileAPI/#dfn-readAsDataURLSync
+ * @param {!Blob} blob
+ * @return {string}
+ */
+FileReaderSync.prototype.readAsDataURL = function(blob) {};

package/externs/browser/w3c_gamepad.js

@@ -0,0 +1,113 @@
+/*
+ * Copyright 2013 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 W3C's Gamepad specification.
+ * @see http://www.w3.org/TR/gamepad/
+ * @externs
+ */
+
+/**
+ * @return {!Array.<!Gamepad>}
+ */
+navigator.getGamepads = function() {};
+
+/**
+ * @return {!Array.<!Gamepad>}
+ */
+navigator.webkitGetGamepads = function() {};
+
+
+/**
+ * @interface
+ */
+var Gamepad = function() {};
+
+/**
+ * @type {string}
+ */
+Gamepad.prototype.id;  // read-only
+
+/**
+ * @type {number}
+ */
+Gamepad.prototype.index;  // read-only
+
+/**
+ * @type {boolean}
+ */
+Gamepad.prototype.connected;  // read-only
+
+/**
+ * @type {number}
+ */
+Gamepad.prototype.timestamp;  // read-only
+
+/**
+ * @type {string}
+ */
+Gamepad.prototype.mapping;  // read-only
+
+/**
+ * @type {!Array.<number>}
+ */
+Gamepad.prototype.axes;  // read-only
+
+/**
+ * Note: The W3C spec changed, this property now returns an array of
+ * GamepadButton objects.
+ *
+ * @type {(!Array.<!GamepadButton>|!Array.<number>)}
+ */
+Gamepad.prototype.buttons;
+
+
+/**
+ * @interface
+ */
+var GamepadButton = function() {};
+
+/**
+ * @type {boolean}
+ */
+GamepadButton.prototype.pressed;  // read-only
+
+/**
+ * @type {number}
+ */
+GamepadButton.prototype.value;  // read-only
+
+/**
+ * @record
+ * @extends {EventInit}
+ * @see https://w3c.github.io/gamepad/#gamepadeventinit-dictionary
+ */
+function GamepadEventInit() {}
+
+/** @const {Gamepad} */
+GamepadEventInit.prototype.gamepad;
+
+/**
+ * @constructor
+ * @param {string} type
+ * @param {GamepadEventInit=} gamepadEventInit
+ * @extends {Event}
+ * @see https://w3c.github.io/gamepad/#gamepadevent-interface
+ */
+function GamepadEvent(type, gamepadEventInit) {}
+
+/** @const {Gamepad} */
+GamepadEvent.prototype.gamepad;

package/externs/browser/w3c_geolocation.js

@@ -0,0 +1,130 @@
+/*
+ * Copyright 2009 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 W3C's Geolocation specification
+ *     http://www.w3.org/TR/geolocation-API/
+ * @externs
+ */
+
+/**
+ * @constructor
+ * @see http://www.w3.org/TR/geolocation-API/#geolocation
+ */
+function Geolocation() {}
+
+/**
+ * @typedef {function(!GeolocationPosition): void}
+ */
+var PositionCallback;
+
+/**
+ * @typedef {function(!GeolocationPositionError): void}
+ */
+var PositionErrorCallback;
+
+/**
+ * @param {PositionCallback} successCallback
+ * @param {PositionErrorCallback=} opt_errorCallback
+ * @param {GeolocationPositionOptions=} opt_options
+ * @return {undefined}
+ */
+Geolocation.prototype.getCurrentPosition = function(successCallback,
+                                                       opt_errorCallback,
+                                                       opt_options) {};
+
+/**
+ * @param {PositionCallback} successCallback
+ * @param {PositionErrorCallback=} opt_errorCallback
+ * @param {GeolocationPositionOptions=} opt_options
+ * @return {number}
+ */
+Geolocation.prototype.watchPosition = function(successCallback,
+                                                  opt_errorCallback,
+                                                  opt_options) {};
+
+/**
+ * @param {number} watchId
+ * @return {undefined}
+ */
+Geolocation.prototype.clearWatch = function(watchId) {};
+
+
+/**
+ * @record
+ * @see http://www.w3.org/TR/geolocation-API/#coordinates
+ */
+function GeolocationCoordinates() {}
+/** @type {number} */
+GeolocationCoordinates.prototype.latitude;
+/** @type {number} */
+GeolocationCoordinates.prototype.longitude;
+/** @type {number} */
+GeolocationCoordinates.prototype.accuracy;
+/** @type {number|null} */
+GeolocationCoordinates.prototype.altitude;
+/** @type {number|null} */
+GeolocationCoordinates.prototype.altitudeAccuracy;
+/** @type {number|null} */
+GeolocationCoordinates.prototype.heading;
+/** @type {number|null} */
+GeolocationCoordinates.prototype.speed;
+
+
+/**
+ * @record
+ * @see http://www.w3.org/TR/geolocation-API/#position
+ */
+function GeolocationPosition() {}
+/** @type {GeolocationCoordinates} */
+GeolocationPosition.prototype.coords;
+/** @type {number} */
+GeolocationPosition.prototype.timestamp;
+
+
+/**
+ * @record
+ * @see http://www.w3.org/TR/geolocation-API/#position-options
+ */
+function GeolocationPositionOptions() {}
+/** @type {boolean|undefined} */
+GeolocationPositionOptions.prototype.enableHighAccuracy;
+/** @type {number|undefined} */
+GeolocationPositionOptions.prototype.maximumAge;
+/** @type {number|undefined} */
+GeolocationPositionOptions.prototype.timeout;
+
+
+/**
+ * @record
+ * @see http://www.w3.org/TR/geolocation-API/#position-error
+ */
+function GeolocationPositionError() {}
+/** @type {number} */
+GeolocationPositionError.prototype.code;
+/** @type {string} */
+GeolocationPositionError.prototype.message;
+/** @const {number} */
+GeolocationPositionError.prototype.UNKNOWN_ERROR;
+/** @const {number} */
+GeolocationPositionError.prototype.PERMISSION_DENIED;
+/** @const {number} */
+GeolocationPositionError.prototype.POSITION_UNAVAILABLE;
+/** @const {number} */
+GeolocationPositionError.prototype.TIMEOUT;
+
+/** @type {Geolocation} */
+Navigator.prototype.geolocation;