google-closure-compiler 20250412.0.0-nightly → 20250413.0.0

package/externs/browser/wicg_trust_token.js

@@ -0,0 +1,89 @@
+/*
+ * Copyright 2008 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 The spec of Trust Token interface.
+ * @see https://github.com/WICG/trust-token-api
+ * @externs
+ */
+
+/**
+ * Trust Tokens operation (issuance, signing, and redemption) is specified via
+ * an instance of the following parameters struct, provided via Fetch, XHR, or
+ * the iframe tag
+ * TODO(b/161890603): Trust Token: Remove the 'issuer' fields after Chrome 86
+ * hits stable.
+ * @record
+ * @see https://docs.google.com/document/d/1qUjtKgA7nMv9YGMhi0xWKEojkSITKzGLdIcZgoz6ZkI
+ */
+
+function TrustTokenAttributeType() {}
+
+/**
+ * Possible values: 'token-request', 'send-srr', 'srr-token-redemption'
+ * @type {string}
+ */
+TrustTokenAttributeType.prototype.type;
+
+/** @type {string|undefined} */
+TrustTokenAttributeType.prototype.issuer;
+
+/** @type {!Array<string>|undefined} */
+TrustTokenAttributeType.prototype.issuers;
+
+/**
+ * Possible values: 'none', 'refresh'
+ * @type {string|undefined}
+ */
+TrustTokenAttributeType.prototype.refreshPolicy;
+
+/**
+ * Possible values: 'omit', 'include', 'headers-only'
+ * @type {string|undefined}
+ */
+TrustTokenAttributeType.prototype.signRequestData;
+
+/** @type {boolean|undefined} */
+TrustTokenAttributeType.prototype.includeTimestampHeader;
+
+/** @type {!Array<string>|undefined} */
+TrustTokenAttributeType.prototype.additionalSignedHeaders;
+
+/** @type {string|undefined} */
+TrustTokenAttributeType.prototype.additionalSigningData;
+
+/**
+ * @type {?function(!TrustTokenAttributeType): void}
+ * @see https://docs.google.com/document/d/1qUjtKgA7nMv9YGMhi0xWKEojkSITKzGLdIcZgoz6ZkI.
+ */
+XMLHttpRequest.prototype.setTrustToken;
+
+/**
+ * @param {!string} issuer The trust token issuer, e.g.
+ *     https://adservice.google.com
+ * @return {!Promise<boolean>}
+ * @see https://docs.google.com/document/d/1TNnya6B8pyomDK2F1R9CL3dY10OAmqWlnCxsWyOBDVQ/edit
+ */
+Document.prototype.hasTrustToken = function(issuer) {};
+
+/** @type {undefined|!TrustTokenAttributeType} */
+RequestInit.prototype.trustToken;
+
+/**
+ * @type {undefined|!TrustTokenAttributeType}
+ * @see https://github.com/WICG/trust-token-api#extension-iframe-activation
+ */
+HTMLIFrameElement.prototype.trustToken;

package/externs/browser/wicg_uach.js

@@ -0,0 +1,100 @@
+/*
+ * Copyright 2008 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 The current draft spec of User Agent Client Hint interface.
+ * @see https://wicg.github.io/ua-client-hints/#interface
+ * @externs
+ */
+
+/**
+ * @see https://wicg.github.io/ua-client-hints/#dictdef-navigatoruabrandversion
+ * @record
+ * @struct
+ */
+function NavigatorUABrandVersion() {}
+
+/** @type {string} */
+NavigatorUABrandVersion.prototype.brand;
+
+/** @type {string} */
+NavigatorUABrandVersion.prototype.version;
+
+
+/**
+ * @see https://wicg.github.io/ua-client-hints/#dictdef-uadatavalues
+ * @record
+ * @struct
+ */
+function UADataValues() {}
+
+/** @type {string} */
+UADataValues.prototype.platform;
+
+/** @type {string} */
+UADataValues.prototype.platformVersion;
+
+/** @type {string} */
+UADataValues.prototype.architecture;
+
+/** @type {string} */
+UADataValues.prototype.model;
+
+/** @type {string} */
+UADataValues.prototype.uaFullVersion;
+
+/** @type {string} */
+UADataValues.prototype.bitness;
+
+/** @type {boolean|undefined} */
+UADataValues.prototype.wow64;
+
+/** @type {!Array<!NavigatorUABrandVersion>|undefined} */
+UADataValues.prototype.fullVersionList;
+
+/**
+ * @see https://wicg.github.io/ua-client-hints/#navigatoruadata
+ * @record
+ * @struct
+ */
+function NavigatorUAData() {}
+
+/** @type {!Array<!NavigatorUABrandVersion>} */
+NavigatorUAData.prototype.brands;
+
+/** @type {boolean} */
+NavigatorUAData.prototype.mobile;
+
+/** @type {string} */
+NavigatorUAData.prototype.platform;
+
+/**
+ * @param {!Array<string>} hints
+ * @return {!Promise<!UADataValues>}
+ */
+NavigatorUAData.prototype.getHighEntropyValues = function(hints) {};
+
+/**
+ * @type {?NavigatorUAData}
+ * @see https://wicg.github.io/ua-client-hints/#interface
+ */
+Navigator.prototype.userAgentData;
+
+/**
+ * @type {?NavigatorUAData}
+ * @see https://wicg.github.io/ua-client-hints/#interface
+ */
+WorkerNavigator.prototype.userAgentData;

package/externs/browser/window.js

@@ -0,0 +1,190 @@
+/*
+ * Copyright 2008 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 JavaScript Built-Ins for windows properties.
+ *
+ * @externs
+ * @author stevey@google.com (Steve Yegge)
+ */
+
+// Window properties
+// Only common properties are here.  Others such as open()
+// should be used with an explicit Window object.
+
+/**
+ * @const {!Window}
+ * @see https://developer.mozilla.org/en/DOM/window.top
+ */
+var top;
+
+/**
+ * @const {!Navigator}
+ * @see https://developer.mozilla.org/en/DOM/window.navigator
+ */
+var navigator;
+
+/**
+ * @const {!HTMLDocument}
+ * @see https://developer.mozilla.org/en/DOM/window.document
+ */
+var document;
+
+/**
+ * @const {!Location}
+ * @see https://developer.mozilla.org/en/DOM/window.location
+ * @suppress {duplicate}
+ * @implicitCast
+ */
+var location;
+
+/**
+ * @const {!Screen}
+ * @see https://developer.mozilla.org/En/DOM/window.screen
+ */
+var screen;
+
+/**
+ * @const {!Window}
+ * @see https://developer.mozilla.org/En/DOM/Window.self
+ */
+var self;
+
+/**
+ * @type {!Window}
+ * @see https://developer.mozilla.org/en/DOM/window
+ */
+var window;
+
+/**
+ * @const {boolean}
+ * @see https://developer.mozilla.org/en-US/docs/Web/API/Window/isSecureContext
+ */
+var isSecureContext;
+
+/**
+ * @const {!VisualViewport}
+ * @see https://developer.mozilla.org/en-US/docs/Web/API/Window/visualViewport
+ */
+var visualViewport;
+
+/**
+ * @param {*} message
+ * @see https://developer.mozilla.org/en/DOM/window.alert
+ * @return {undefined}
+ */
+function alert(message) {}
+
+/**
+ * @param {number=} immediateID
+ * @see https://developer.mozilla.org/en-US/docs/DOM/window.clearImmediate
+ * @see http://msdn.microsoft.com/en-us/library/ie/hh924825(v=vs.85).aspx
+ * @return {undefined}
+ */
+function clearImmediate(immediateID) {}
+
+/**
+ * @param {?number|undefined} intervalID
+ * @see https://developer.mozilla.org/en/DOM/window.clearInterval
+ * @suppress {duplicate}
+ * @return {undefined}
+ */
+function clearInterval(intervalID) {}
+
+/**
+ * @param {?number|undefined} timeoutID
+ * @see https://developer.mozilla.org/en/DOM/window.clearTimeout
+ * @suppress {duplicate}
+ * @return {undefined}
+ */
+function clearTimeout(timeoutID) {}
+
+/**
+ * @param {*} message
+ * @return {boolean}
+ * @see https://developer.mozilla.org/en/DOM/window.confirm
+ */
+function confirm(message) {}
+
+/**
+ * @see https://developer.mozilla.org/en/DOM/window.dump
+ * @param {*} x
+ * @return {undefined}
+ */
+function dump(x) {}
+
+/**
+ * @param {string} message
+ * @param {string=} opt_value
+ * @return {?string}
+ * @see https://developer.mozilla.org/en/DOM/window.prompt
+ */
+function prompt(message, opt_value) {}
+
+/**
+ * @param {function()} callback
+ * @param {...?} callbackParams
+ * @return {number}
+ * @see https://developer.mozilla.org/en-US/docs/DOM/window.setImmediate
+ * @see http://msdn.microsoft.com/en-us/library/ie/hh773176(v=vs.85).aspx
+ */
+function setImmediate(callback, callbackParams) {}
+
+/**
+ * @param {Function|!TrustedScript|string} callback
+ * @param {number=} opt_delay
+ * @param {...?} callbackParams
+ * @return {number}
+ * @see https://developer.mozilla.org/en/DOM/window.setInterval
+ * @see https://html.spec.whatwg.org/multipage/webappapis.html#timers
+ */
+function setInterval(callback, opt_delay, callbackParams) {}
+
+/**
+ * @param {Function|!TrustedScript|string} callback
+ * @param {number=} opt_delay
+ * @param {...*} callbackParams
+ * @return {number}
+ * @see https://developer.mozilla.org/en/DOM/window.setTimeout
+ * @see https://html.spec.whatwg.org/multipage/webappapis.html#timers
+ */
+function setTimeout(callback, opt_delay, callbackParams) {}
+
+/**
+ * Returns whether the object has a property with the specified name.
+ *
+ * @param {*} propertyName Implicitly cast to a string.
+ * @return {boolean}
+ * @nosideeffects
+ * @see http://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object/hasOwnProperty
+ */
+function hasOwnProperty (propertyName) {}
+
+/**
+ * @param {function():void} callback
+ * @return {undefined}
+ * @see https://developer.mozilla.org/en-US/docs/Web/API/WindowOrWorkerGlobalScope/queueMicrotask
+ * @see https://html.spec.whatwg.org/multipage/timers-and-user-prompts.html#microtask-queuing
+ */
+function queueMicrotask(callback) {}
+
+/**
+ * @param {*} error
+ * @return {undefined}
+ * @see https://developer.mozilla.org/en-US/docs/Web/API/reportError
+ * @see https://html.spec.whatwg.org/multipage/webappapis.html#runtime-script-errors
+ */
+function reportError(error) {}