google-closure-compiler 20250412.0.0-nightly → 20250413.0.0

package/externs/browser/w3c_pointer_events.js

@@ -0,0 +1,163 @@
+/*
+ * 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 Definitions for W3C's Pointer Events specification.
+ *  Created from
+ *   http://www.w3.org/TR/pointerevents/
+ *
+ * @externs
+ */
+
+
+/**
+ * @type {string}
+ * @see http://www.w3.org/TR/pointerevents/#the-touch-action-css-property
+ */
+CSSProperties.prototype.touchAction;
+
+/**
+ * @type {boolean}
+ * @see http://www.w3.org/TR/pointerevents/#widl-Navigator-pointerEnabled
+ */
+Navigator.prototype.pointerEnabled;
+
+/**
+ * @type {number}
+ * @see http://www.w3.org/TR/pointerevents/#widl-Navigator-maxTouchPoints
+ */
+Navigator.prototype.maxTouchPoints;
+
+
+/**
+ * @param {number} pointerId
+ * @see https://www.w3.org/TR/pointerevents/#widl-Element-setPointerCapture-void-long-pointerId
+ */
+Element.prototype.setPointerCapture = function(pointerId) {};
+
+/**
+ * @param {number} pointerId
+ * @see https://www.w3.org/TR/pointerevents/#widl-Element-releasePointerCapture-void-long-pointerId
+ */
+Element.prototype.releasePointerCapture = function(pointerId) {};
+
+/**
+ * @param {number} pointerId
+ * @see https://www.w3.org/TR/pointerevents/#dom-element-haspointercapture
+ * @return {boolean}
+ */
+Element.prototype.hasPointerCapture = function(pointerId) {};
+
+
+/**
+ * @record
+ * @extends {MouseEventInit}
+ * @see https://www.w3.org/TR/pointerevents/#idl-def-PointerEventInit
+ */
+function PointerEventInit() {}
+
+/** @type {undefined|number} */
+PointerEventInit.prototype.pointerId;
+
+/** @type {undefined|number} */
+PointerEventInit.prototype.width;
+
+/** @type {undefined|number} */
+PointerEventInit.prototype.height;
+
+/** @type {undefined|number} */
+PointerEventInit.prototype.pressure;
+
+/** @type {undefined|number} */
+PointerEventInit.prototype.tiltX;
+
+/** @type {undefined|number} */
+PointerEventInit.prototype.tiltY;
+
+/** @type {undefined|string} */
+PointerEventInit.prototype.pointerType;
+
+/** @type {undefined|boolean} */
+PointerEventInit.prototype.isPrimary;
+
+/** @type {undefined|number} */
+PointerEventInit.prototype.altitudeAngle;
+
+/** @type {undefined|number} */
+PointerEventInit.prototype.azimuthAngle;
+
+/** @type {undefined|number} */
+PointerEventInit.prototype.tangentialPressure;
+
+/** @type {undefined|number} */
+PointerEventInit.prototype.twist;
+
+/** @type {undefined|!Array<!PointerEvent>} */
+PointerEventInit.prototype.coalescedEvents;
+
+/** @type {undefined|!Array<!PointerEvent>} */
+PointerEventInit.prototype.predictedEvents;
+
+
+/**
+ * @constructor
+ * @extends {MouseEvent}
+ * @param {string} type
+ * @param {PointerEventInit=} opt_eventInitDict
+ * @see http://www.w3.org/TR/pointerevents/#pointerevent-interface
+ */
+function PointerEvent(type, opt_eventInitDict) {}
+
+/** @type {number} */
+PointerEvent.prototype.pointerId;
+
+/** @type {number} */
+PointerEvent.prototype.width;
+
+/** @type {number} */
+PointerEvent.prototype.height;
+
+/** @type {number} */
+PointerEvent.prototype.pressure;
+
+/** @type {number} */
+PointerEvent.prototype.tiltX;
+
+/** @type {number} */
+PointerEvent.prototype.tiltY;
+
+/** @type {string} */
+PointerEvent.prototype.pointerType;
+
+/** @type {boolean} */
+PointerEvent.prototype.isPrimary;
+
+// Microsoft pointerType values
+/** @const {string} */
+PointerEvent.prototype.MSPOINTER_TYPE_TOUCH;
+
+/** @const {string} */
+PointerEvent.prototype.MSPOINTER_TYPE_PEN;
+
+/** @const {string} */
+PointerEvent.prototype.MSPOINTER_TYPE_MOUSE;
+
+/**
+ * @see https://w3c.github.io/pointerevents/extension.html
+ * @return {!Array<!PointerEvent>}
+ */
+PointerEvent.prototype.getCoalescedEvents = function() {};
+

package/externs/browser/w3c_pointerlock.js

@@ -0,0 +1,63 @@
+/*
+ * Copyright 2015 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 Pointer Lock API.
+ * @see https://w3c.github.io/pointerlock/
+ *
+ * @externs
+ */
+
+/**
+ * TODO(bradfordcsmith): update the link when PR is merged
+ * @see https://github.com/w3c/pointerlock/pull/49/
+ * @record
+ */
+function PointerLockOptions() {}
+
+/** @type {undefined|boolean} */
+PointerLockOptions.prototype.unadjustedMovement;
+
+/**
+ * @see https://w3c.github.io/pointerlock/#widl-Element-requestPointerLock-void
+ * @param {!PointerLockOptions=} options
+ * @return {void|!Promise<void>}
+ */
+Element.prototype.requestPointerLock = function(options) {};
+
+/**
+ * @see https://w3c.github.io/pointerlock/#widl-Document-pointerLockElement
+ * @type {?Element}
+ */
+Document.prototype.pointerLockElement;
+
+/**
+ * @see https://w3c.github.io/pointerlock/#widl-Document-exitPointerLock-void
+ * @return {void}
+ */
+Document.prototype.exitPointerLock = function() {};
+
+/**
+ * @see https://w3c.github.io/pointerlock/#widl-MouseEvent-movementX
+ * @type {number}
+ */
+MouseEvent.prototype.movementX;
+
+/**
+ * @see https://w3c.github.io/pointerlock/#widl-MouseEvent-movementY
+ * @type {number}
+ */
+MouseEvent.prototype.movementY;

package/externs/browser/w3c_range.js

@@ -0,0 +1,284 @@
+/*
+ * 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 Definitions for W3C's range specification.
+ *  This file depends on w3c_dom2.js.
+ *  The whole file has been fully type annotated.
+ *  Created from
+ *   http://www.w3.org/TR/DOM-Level-2-Traversal-Range/ranges.html
+ *
+ * @externs
+ * @author stevey@google.com (Steve Yegge)
+ */
+
+
+/**
+ * @constructor
+ * @see http://www.w3.org/TR/DOM-Level-2-Traversal-Range/ranges.html#Level-2-Range-Interface
+ */
+function Range() {}
+
+// constants on the constructor
+
+/**
+ * @const {number}
+ * @see http://www.w3.org/TR/DOM-Level-2-Traversal-Range/ranges.html#Level2-Range-compareHow
+ */
+Range.START_TO_START;
+
+/**
+ * @const {number}
+ * @see http://www.w3.org/TR/DOM-Level-2-Traversal-Range/ranges.html#Level2-Range-compareHow
+ */
+Range.START_TO_END;
+
+/**
+ * @const {number}
+ * @see http://www.w3.org/TR/DOM-Level-2-Traversal-Range/ranges.html#Level2-Range-compareHow
+ */
+Range.END_TO_END;
+
+/**
+ * @const {number}
+ * @see http://www.w3.org/TR/DOM-Level-2-Traversal-Range/ranges.html#Level2-Range-compareHow
+ */
+Range.END_TO_START;
+
+// constants repeated on the prototype
+
+/**
+ * @const {number}
+ * @see http://www.w3.org/TR/DOM-Level-2-Traversal-Range/ranges.html#Level2-Range-compareHow
+ */
+Range.prototype.START_TO_START;
+
+/**
+ * @const {number}
+ * @see http://www.w3.org/TR/DOM-Level-2-Traversal-Range/ranges.html#Level2-Range-compareHow
+ */
+Range.prototype.START_TO_END;
+
+/**
+ * @const {number}
+ * @see http://www.w3.org/TR/DOM-Level-2-Traversal-Range/ranges.html#Level2-Range-compareHow
+ */
+Range.prototype.END_TO_END;
+
+/**
+ * @const {number}
+ * @see http://www.w3.org/TR/DOM-Level-2-Traversal-Range/ranges.html#Level2-Range-compareHow
+ */
+Range.prototype.END_TO_START;
+
+/**
+ * @type {Node}
+ * @see http://www.w3.org/TR/DOM-Level-2-Traversal-Range/ranges.html#Level-2-Range-attr-startParent
+ */
+Range.prototype.startContainer;
+
+/**
+ * @type {number}
+ * @see http://www.w3.org/TR/DOM-Level-2-Traversal-Range/ranges.html#Level-2-Range-attr-startOffset
+ */
+Range.prototype.startOffset;
+
+/**
+ * @type {Node}
+ * @see http://www.w3.org/TR/DOM-Level-2-Traversal-Range/ranges.html#Level-2-Range-attr-endParent
+ */
+Range.prototype.endContainer;
+
+/**
+ * @type {number}
+ * @see http://www.w3.org/TR/DOM-Level-2-Traversal-Range/ranges.html#Level-2-Range-attr-endOffset
+ */
+Range.prototype.endOffset;
+
+/**
+ * @type {boolean}
+ * @see http://www.w3.org/TR/DOM-Level-2-Traversal-Range/ranges.html#Level-2-Range-attr-collapsed
+ */
+Range.prototype.collapsed;
+
+/**
+ * @type {Node}
+ * @see http://www.w3.org/TR/DOM-Level-2-Traversal-Range/ranges.html#Level-2-Range-attr-commonParent
+ */
+Range.prototype.commonAncestorContainer;
+
+/**
+ * @param {Node} refNode
+ * @param {number} offset
+ * @return {undefined}
+ * @see http://www.w3.org/TR/DOM-Level-2-Traversal-Range/ranges.html#Level2-Range-method-setStart
+ */
+Range.prototype.setStart = function(refNode, offset) {};
+
+/**
+ * @param {Node} refNode
+ * @param {number} offset
+ * @return {undefined}
+ * @see http://www.w3.org/TR/DOM-Level-2-Traversal-Range/ranges.html#Level2-Range-method-setEnd
+ */
+Range.prototype.setEnd = function(refNode, offset) {};
+
+/**
+ * @param {Node} refNode
+ * @return {undefined}
+ * @see http://www.w3.org/TR/DOM-Level-2-Traversal-Range/ranges.html#Level2-Range-setStartBefore
+ */
+Range.prototype.setStartBefore = function(refNode) {};
+
+/**
+ * @param {Node} refNode
+ * @return {undefined}
+ * @see http://www.w3.org/TR/DOM-Level-2-Traversal-Range/ranges.html#Level2-Range-method-setStartAfter
+ */
+Range.prototype.setStartAfter = function(refNode) {};
+
+/**
+ * @param {Node} refNode
+ * @return {undefined}
+ * @see http://www.w3.org/TR/DOM-Level-2-Traversal-Range/ranges.html#Level2-Range-method-setEndBefore
+ */
+Range.prototype.setEndBefore = function(refNode) {};
+
+/**
+ * @param {Node} refNode
+ * @return {undefined}
+ * @see http://www.w3.org/TR/DOM-Level-2-Traversal-Range/ranges.html#Level2-Range-method-setEndAfter
+ */
+Range.prototype.setEndAfter = function(refNode) {};
+
+/**
+ * @param {boolean} toStart
+ * @return {undefined}
+ * @see http://www.w3.org/TR/DOM-Level-2-Traversal-Range/ranges.html#Level2-Range-method-collapse
+ */
+Range.prototype.collapse = function(toStart) {};
+
+/**
+ * @param {Node} refNode
+ * @return {undefined}
+ * @see http://www.w3.org/TR/DOM-Level-2-Traversal-Range/ranges.html#Level2-Range-method-selectNode
+ */
+Range.prototype.selectNode = function(refNode) {};
+
+/**
+ * @param {Node} refNode
+ * @return {undefined}
+ * @see http://www.w3.org/TR/DOM-Level-2-Traversal-Range/ranges.html#Level2-Range-method-selectNodeContents
+ */
+Range.prototype.selectNodeContents = function(refNode) {};
+
+/**
+ * @param {number} how
+ * @param {Range} sourceRange
+ * @return {number}
+ * @see http://www.w3.org/TR/DOM-Level-2-Traversal-Range/ranges.html#Level2-Range-method-compareBoundaryPoints
+ */
+Range.prototype.compareBoundaryPoints = function(how, sourceRange) {};
+
+/**
+ * @return {number}
+ * @see http://www.w3.org/TR/DOM-Level-2-Traversal-Range/ranges.html#Level2-Range-method-deleteContents
+ */
+Range.prototype.deleteContents = function() {};
+
+/**
+ * @return {DocumentFragment}
+ * @see http://www.w3.org/TR/DOM-Level-2-Traversal-Range/ranges.html#Level2-Range-method-extractContents
+ */
+Range.prototype.extractContents = function() {};
+
+/**
+ * @return {DocumentFragment}
+ * @see http://www.w3.org/TR/DOM-Level-2-Traversal-Range/ranges.html#Level2-Range-method-cloneContents
+ */
+Range.prototype.cloneContents = function() {};
+
+/**
+ * @param {Node} newNode
+ * @return {DocumentFragment}
+ * @see http://www.w3.org/TR/DOM-Level-2-Traversal-Range/ranges.html#Level2-Range-method-insertNode
+ */
+Range.prototype.insertNode = function(newNode) {};
+
+/**
+ * @param {Node} newParent
+ * @return {undefined}
+ * @see http://www.w3.org/TR/DOM-Level-2-Traversal-Range/ranges.html#Level2-Range-method-surroundContents
+ */
+Range.prototype.surroundContents = function(newParent) {};
+
+/**
+ * @return {Range}
+ * @see http://www.w3.org/TR/DOM-Level-2-Traversal-Range/ranges.html#Level2-Range-method-clone
+ */
+Range.prototype.cloneRange = function() {};
+
+/**
+ * @param {Node} parent
+ * @param {number} offset
+ * @return {number}
+ * @nosideeffects
+ * @see https://dom.spec.whatwg.org/#ref-for-dom-range-comparepoint%E2%91%A0
+ */
+Range.prototype.comparePoint;
+
+/**
+ * @return {undefined}
+ * @see http://www.w3.org/TR/DOM-Level-2-Traversal-Range/ranges.html#Level2-Range-method-detach
+ */
+Range.prototype.detach = function() {};
+
+/**
+ * @param {!TrustedHTML|string} tag
+ * @return {DocumentFragment}
+ * @see https://w3c.github.io/DOM-Parsing/#ref-for-dom-range-createcontextualfragment-2
+ */
+Range.prototype.createContextualFragment;
+
+/**
+ * @param {Node} n
+ * @return {boolean}
+ * @nosideeffects
+ * @see https://dom.spec.whatwg.org/#ref-for-dom-range-intersectsnode%E2%91%A0
+ */
+Range.prototype.intersectsNode;
+
+/**
+ * @param {Node} parent
+ * @param {number} offset
+ * @return {boolean}
+ * @nosideeffects
+ * @see https://dom.spec.whatwg.org/#dom-range-ispointinrange
+ */
+Range.prototype.isPointInRange;
+
+// Introduced in DOM Level 2:
+/**
+ * @interface
+ * @see http://www.w3.org/TR/DOM-Level-2-Traversal-Range/ranges.html#Level-2-DocumentRange-idl
+ */
+function DocumentRange() {}
+
+/**
+ * @return {Range}
+ * @see http://www.w3.org/TR/DOM-Level-2-Traversal-Range/ranges.html#Level2-DocumentRange-method-createRange
+ */
+DocumentRange.prototype.createRange = function() {};

package/externs/browser/w3c_referrer_policy.js

@@ -0,0 +1,36 @@
+/*
+ * Copyright 2018 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 referrer policy specification.
+ * @see https://w3c.github.io/webappsec-referrer-policy/#referrer-policy-delivery
+ * @externs
+ */
+
+/** @type {string} */
+HTMLAnchorElement.prototype.referrerPolicy;
+
+/** @type {string} */
+HTMLAreaElement.prototype.referrerPolicy;
+
+/** @type {string} */
+HTMLImageElement.prototype.referrerPolicy;
+
+/** @type {string} */
+HTMLIFrameElement.prototype.referrerPolicy;
+
+/** @type {string} */
+HTMLLinkElement.prototype.referrerPolicy;

package/externs/browser/w3c_requestidlecallback.js

@@ -0,0 +1,76 @@
+/*
+ * Copyright 2015 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 cooperative scheduling of background tasks in
+ * the browser. This spec is still very likely to change.
+ *
+ * @see https://w3c.github.io/requestidlecallback/
+ * @see https://developers.google.com/web/updates/2015/08/27/using-requestidlecallback?hl=en
+ * @externs
+ */
+
+
+/**
+ * @typedef {{
+ *   timeout: (number|undefined)
+ * }}
+ */
+var IdleCallbackOptions;
+
+
+/**
+ * Schedules a callback to run when the browser is idle.
+ * @param {function(!IdleDeadline): void} callback Called when the browser is idle.
+ * @param {number|IdleCallbackOptions=} opt_options If set, gives the browser a time in ms by which
+ *     it must execute the callback. No timeout enforced otherwise.
+ * @return {number} A handle that can be used to cancel the scheduled callback.
+ */
+function requestIdleCallback(callback, opt_options) {}
+
+
+/**
+ * Cancels a callback scheduled to run when the browser is idle.
+ * @param {number} handle The handle returned by `requestIdleCallback` for
+ *     the scheduled callback to cancel.
+ * @return {undefined}
+ */
+function cancelIdleCallback(handle) {}
+
+
+
+/**
+ * An interface for an object passed into the callback for
+ * `requestIdleCallback` that remains up-to-date on the amount of idle
+ * time left in the current time slice.
+ * @interface
+ */
+function IdleDeadline() {}
+
+
+/**
+ * @return {number} The amount of idle time (milliseconds) remaining in the
+ *     current time slice. Will always be positive or 0.
+ */
+IdleDeadline.prototype.timeRemaining = function() {};
+
+
+/**
+ * Whether the callback was forced to run due to a timeout. Specifically,
+ * whether the callback was invoked by the idle callback timeout algorithm:
+ * https://w3c.github.io/requestidlecallback/#dfn-invoke-idle-callback-timeout-algorithm
+ * @type {boolean}
+ */
+IdleDeadline.prototype.didTimeout;