google-closure-compiler 20250412.0.0-nightly → 20250413.0.0

package/externs/browser/wicg_entries.js

@@ -0,0 +1,169 @@
+/*
+ * Copyright 2021 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 APIs used for file/directory upload by drag-and-drop
+ * @see https://wicg.github.io/entries-api
+ * @see https://github.com/WICG/entries-api/blob/main/EXPLAINER.md
+ * @externs
+ */
+
+/**
+ * @see https://wicg.github.io/entries-api/#filesystementry
+ * @constructor
+ */
+function FileSystemEntry() {}
+
+/**
+ * @see https://wicg.github.io/entries-api/#dom-filesystementry-isfile
+ * @type {boolean}
+ */
+FileSystemEntry.prototype.isFile;
+
+/**
+ * @see https://wicg.github.io/entries-api/#dom-filesystementry-isdirectory
+ * @type {boolean}
+ */
+FileSystemEntry.prototype.isDirectory;
+
+/**
+ * @see https://wicg.github.io/entries-api/#dom-filesystementry-name
+ * @type {string}
+ */
+FileSystemEntry.prototype.name;
+
+/**
+ * @see https://wicg.github.io/entries-api/#dom-filesystementry-fullpath
+ * @type {string}
+ */
+FileSystemEntry.prototype.fullPath;
+
+/**
+ * @see https://wicg.github.io/entries-api/#dom-filesystementry-filesystem
+ * @type {!FileSystem}
+ */
+FileSystemEntry.prototype.filesystem;
+
+/**
+ * @see https://wicg.github.io/entries-api/#dom-filesystementry-getparent
+ * @param {function(!FileSystemEntry)=} successCallback
+ * @param {function(!DOMException)=} errorCallback
+ * @return {undefined}
+ */
+FileSystemEntry.prototype.getParent = function(
+    successCallback, errorCallback) {};
+
+/**
+ * @see https://wicg.github.io/entries-api/#filesystemdirectoryentry
+ * @constructor
+ * @extends {FileSystemEntry}
+ */
+function FileSystemDirectoryEntry() {}
+
+/**
+ * @see https://wicg.github.io/entries-api/#dom-filesystemdirectoryentry-createreader
+ * @return {!FileSystemDirectoryReader}
+ */
+FileSystemDirectoryEntry.prototype.createReader = function() {};
+
+/**
+ * @see https://wicg.github.io/entries-api/#dom-filesystemdirectoryentry-getfile
+ * @param {string|null=} path
+ * @param {!FileSystemFlags=} options
+ * @param {function(!FileSystemFileEntry)=} successCallback
+ * @param {function(!DOMException)=} errorCallback
+ * @return {undefined}
+ */
+FileSystemDirectoryEntry.prototype.getFile = function(
+    path, options, successCallback, errorCallback) {};
+
+/**
+ * @see https://wicg.github.io/entries-api/#dom-filesystemdirectoryentry-getdirectory
+ * @param {string|null=} path
+ * @param {!FileSystemFlags=} options
+ * @param {function(!FileSystemDirectoryEntry)=} successCallback
+ * @param {function(!DOMException)=} errorCallback
+ * @return {undefined}
+ */
+FileSystemDirectoryEntry.prototype.getDirectory = function(
+    path, options, successCallback, errorCallback) {};
+
+/**
+ * @see https://wicg.github.io/entries-api/#dictdef-filesystemflags
+ * @record
+ */
+function FileSystemFlags() {}
+
+/**
+ * @see https://wicg.github.io/entries-api/#dom-filesystemflags-create
+ * @type {(undefined|boolean)}
+ */
+FileSystemFlags.prototype.create;
+
+/**
+ * @see https://wicg.github.io/entries-api/#dom-filesystemflags-exclusive
+ * @type {(undefined|boolean)}
+ */
+FileSystemFlags.prototype.exclusive;
+
+/**
+ * @see https://wicg.github.io/entries-api/#filesystemdirectoryreader
+ * @constructor
+ */
+function FileSystemDirectoryReader() {}
+
+/**
+ * @see https://wicg.github.io/entries-api/#dom-filesystemdirectoryentry-readentries
+ * @param {function(!Array<FileSystemEntry>)} successCallback
+ * @param {function(!DOMException)=} errorCallback
+ * @return {undefined}
+ */
+FileSystemDirectoryReader.prototype.readEntries = function(
+    successCallback, errorCallback) {};
+
+/**
+ * @see https://wicg.github.io/entries-api/#filesystemfileentry
+ * @constructor
+ * @extends {FileSystemEntry}
+ */
+function FileSystemFileEntry() {}
+
+/**
+ * @see https://wicg.github.io/entries-api/#dom-filesystemfileentry-file
+ * @param {function(!File)} successCallback
+ * @param {function(!DOMException)=} errorCallback
+ * @return {undefined}
+ */
+FileSystemFileEntry.prototype.file = function(
+    successCallback, errorCallback) {};
+
+/**
+ * @see https://wicg.github.io/entries-api/#filesystem
+ * @constructor
+ */
+function FileSystem() {}
+
+/**
+ * @see https://wicg.github.io/entries-api/#dom-filesystem-name
+ * @type {string}
+ */
+FileSystem.prototype.name;
+
+/**
+ * @see https://wicg.github.io/entries-api/#dom-filesystem-root
+ * @type {!FileSystemDirectoryEntry}
+ */
+FileSystem.prototype.root;

package/externs/browser/wicg_file_handling.js

@@ -0,0 +1,41 @@
+/*
+ * Copyright 2021 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 @externs
+ * Externs for interfaces in //third_party/blink/renderer/modules/launch/*
+ *
+ * FileHandling Explainer:
+ * https://github.com/WICG/file-handling/blob/main/explainer.md
+ */
+
+/** @interface */
+var LaunchParams = function() {};
+
+/** @type {!Array<!FileSystemHandle>} */
+LaunchParams.prototype.files;
+
+/** @typedef {function(!LaunchParams)} */
+var LaunchConsumer;
+
+/** @interface */
+var LaunchQueue = function() {};
+
+/** @param {!LaunchConsumer} consumer */
+LaunchQueue.prototype.setConsumer = function(consumer) {};
+
+/** @type {!LaunchQueue} */
+window.launchQueue;

package/externs/browser/wicg_file_system_access.js

@@ -0,0 +1,191 @@
+/*
+ * 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.
+ */
+
+/**
+ * File System Access
+ * Draft Community Group Report, 12 January 2023
+ * @see https://wicg.github.io/file-system-access/
+ * @externs
+ */
+
+
+
+/**
+ * @typedef {string}
+ * @see https://wicg.github.io/file-system-access/#enumdef-filesystempermissionmode
+ */
+var FileSystemPermissionMode;
+
+
+/**
+ * @record
+ * @struct
+ * @extends {PermissionDescriptor}
+ * @see https://wicg.github.io/file-system-access/#dictdef-filesystempermissiondescriptor
+ */
+var FileSystemPermissionDescriptor = function() {};
+
+/** @type {!FileSystemHandle} */
+FileSystemPermissionDescriptor.prototype.handle;
+
+/** @type {undefined|!FileSystemPermissionMode} */
+FileSystemPermissionDescriptor.prototype.mode;
+
+
+/**
+ * @record
+ * @struct
+ * @see https://wicg.github.io/file-system-access/#dictdef-filesystemhandlepermissiondescriptor
+ */
+var FileSystemHandlePermissionDescriptor = function() {};
+
+/** @type {undefined|!FileSystemPermissionMode} */
+FileSystemHandlePermissionDescriptor.prototype.mode;
+
+
+/**
+ * @param {!FileSystemHandlePermissionDescriptor=} opt_descriptor
+ * @return {!Promise<!PermissionState>}
+ * @see https://wicg.github.io/file-system-access/#api-filesystemhandle
+ */
+FileSystemHandle.prototype.queryPermission = function(opt_descriptor) {};
+
+/**
+ * @param {!FileSystemHandlePermissionDescriptor=} opt_descriptor
+ * @return {!Promise<!PermissionState>}
+ * @see https://wicg.github.io/file-system-access/#api-filesystemhandle
+ */
+FileSystemHandle.prototype.requestPermission = function(opt_descriptor) {};
+
+
+/**
+ * @typedef {string}
+ * @see https://wicg.github.io/file-system-access/#local-filesystem
+ */
+var WellKnownDirectory;
+
+
+/**
+ * @typedef {!WellKnownDirectory|!FileSystemHandle}
+ * @see https://wicg.github.io/file-system-access/#local-filesystem
+ */
+var StartInDirectory;
+
+
+/**
+ * @record
+ * @struct
+ * @see https://wicg.github.io/file-system-access/#dictdef-filepickeraccepttype
+ */
+var FilePickerAcceptType = function() {};
+
+/** @type {undefined|string} */
+FilePickerAcceptType.prototype.description;
+
+/** @type {undefined|!Object<string,(string|!Array<string>)>} */
+FilePickerAcceptType.prototype.accept;
+
+
+/**
+ * @record
+ * @struct
+ * @see https://wicg.github.io/file-system-access/#dictdef-filepickeroptions
+ */
+var FilePickerOptions = function() {};
+
+/** @type {undefined|!Array<!FilePickerAcceptType>} */
+FilePickerOptions.prototype.types;
+
+/** @type {undefined|boolean} */
+FilePickerOptions.prototype.excludeAcceptAllOption;
+
+/** @type {undefined|string} */
+FilePickerOptions.prototype.id;
+
+/** @type {undefined|!StartInDirectory} */
+FilePickerOptions.prototype.startIn;
+
+
+/**
+ * @record
+ * @struct
+ * @extends {FilePickerOptions}
+ * @see https://wicg.github.io/file-system-access/#dictdef-openfilepickeroptions
+ */
+var OpenFilePickerOptions = function() {};
+
+/** @type {undefined|boolean} */
+OpenFilePickerOptions.prototype.multiple;
+
+
+/**
+ * @record
+ * @struct
+ * @extends {FilePickerOptions}
+ * @see https://wicg.github.io/file-system-access/#dictdef-savefilepickeroptions
+ */
+var SaveFilePickerOptions = function() {};
+
+/** @type {undefined|?string} */
+SaveFilePickerOptions.prototype.suggestedName;
+
+
+/**
+ * @record
+ * @struct
+ * @see https://wicg.github.io/file-system-access/#dictdef-directorypickeroptions
+ */
+var DirectoryPickerOptions = function() {};
+
+/** @type {undefined|string} */
+DirectoryPickerOptions.prototype.id;
+
+/** @type {undefined|!StartInDirectory} */
+DirectoryPickerOptions.prototype.startIn;
+
+/** @type {undefined|!FileSystemPermissionMode} */
+DirectoryPickerOptions.prototype.mode;
+
+
+/**
+ * @param {!OpenFilePickerOptions=} opt_options
+ * @return {!Promise<!Array<!FileSystemFileHandle>>}
+ * @see https://wicg.github.io/file-system-access/#local-filesystem
+ */
+Window.prototype.showOpenFilePicker = function(opt_options) {};
+
+
+/**
+ * @param {!SaveFilePickerOptions=} opt_options
+ * @return {!Promise<!FileSystemFileHandle>}
+ * @see https://wicg.github.io/file-system-access/#local-filesystem
+ */
+Window.prototype.showSaveFilePicker = function(opt_options) {};
+
+
+/**
+ * @param {!DirectoryPickerOptions=} opt_options
+ * @return {!Promise<!FileSystemDirectoryHandle>}
+ * @see https://wicg.github.io/file-system-access/#local-filesystem
+ */
+Window.prototype.showDirectoryPicker = function(opt_options) {};
+
+
+/**
+ * @return {!Promise<?FileSystemHandle>}
+ * @see https://wicg.github.io/file-system-access/#drag-and-drop
+ */
+DataTransferItem.prototype.getAsFileSystemHandle = function() {};

package/externs/browser/wicg_floc.js

@@ -0,0 +1,41 @@
+/*
+ * 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 FLoC interface.
+ * @see https://github.com/WICG/floc
+ * @externs
+ */
+
+/**
+ * @see https://wicg.github.io/floc/#interest-cohort-section
+ * @record
+ * @struct
+ */
+function InterestCohort() {}
+
+/** @type {string} */
+InterestCohort.prototype.id;
+
+/** @type {string} */
+InterestCohort.prototype.version;
+
+
+/**
+ * @return {!Promise<!InterestCohort>}
+ * @see https://wicg.github.io/floc/#the-api
+ */
+Document.prototype.interestCohort = function() {};

package/externs/browser/wicg_ink.js

@@ -0,0 +1,89 @@
+/*
+ * Copyright 2022 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 Ink API.
+ * @see https://wicg.github.io/ink-enhancement/
+ * @externs
+ */
+
+/**
+ * @see https://wicg.github.io/ink-enhancement/#ink-presenter-param
+ * @record
+ * @struct
+ */
+function InkPresenterParam() {}
+
+/** @type {?Element} */
+InkPresenterParam.prototype.presentationArea;
+
+/**
+ * The Ink API provides the InkPresenter interface to expose the underlying
+ * operating system API to achieve this and keeps the extensibility open in
+ * order to support additional presenters in the future.
+ * @see https://wicg.github.io/ink-enhancement/#ink-interface
+ * @interface
+ * @struct
+ */
+function Ink() {}
+
+/**
+ * @param {?InkPresenterParam=} param
+ * @return {!Promise<!InkPresenter>}
+ */
+Ink.prototype.requestPresenter = function(param) {};
+
+
+/**
+ * @see https://wicg.github.io/ink-enhancement/#ink-presenter
+ * @interface
+ * @struct
+ */
+function InkPresenter() {}
+
+/** @type {?Element} */
+InkPresenter.prototype.presentationArea;
+
+/** @type {number} */
+InkPresenter.prototype.expectedImprovement;
+
+/**
+ * @param {!PointerEvent} event
+ * @param {!InkTrailStyle} style
+ * @return {void}
+ */
+InkPresenter.prototype.updateInkTrailStartPoint = function(event, style) {};
+
+
+/**
+ * @see https://wicg.github.io/ink-enhancement/#ink-trail-style
+ * @record
+ * @struct
+ */
+function InkTrailStyle() {}
+
+/** @type {string} */
+InkTrailStyle.prototype.color;
+
+/** @type {number} */
+InkTrailStyle.prototype.diameter;
+
+
+/**
+ * @see https://wicg.github.io/ink-enhancement/#navigator-interface-extensions
+ * @type {!Ink}
+ */
+Navigator.prototype.ink;

package/externs/browser/wicg_resizeobserver.js

@@ -0,0 +1,100 @@
+/*
+ * 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 The current draft spec of ResizeObserver.
+ * @see https://wicg.github.io/ResizeObserver/
+ * @see https://developer.mozilla.org/en-US/docs/Web/API/ResizeObserver
+ * @externs
+ */
+
+/**
+ * @typedef {function(!Array<!ResizeObserverEntry>, !ResizeObserver)}
+ */
+var ResizeObserverCallback;
+
+/**
+ * @typedef {{box: string}}
+ */
+var ResizeObserverOptions;
+
+/**
+ * @typedef {{blockSize: number, inlineSize: number}}
+ */
+var ResizeObserverSize;
+
+/**
+ * @constructor
+ * @param {!ResizeObserverCallback} callback
+ * @see https://developer.mozilla.org/en-US/docs/Web/API/ResizeObserver/ResizeObserver
+ */
+function ResizeObserver(callback) {}
+
+/**
+ * @param {!Element} target
+ * @param {!ResizeObserverOptions=} opt_options
+ * @return {void}
+ * @see https://developer.mozilla.org/en-US/docs/Web/API/ResizeObserver/observe
+ */
+ResizeObserver.prototype.observe = function(target, opt_options) {};
+
+/**
+ * @param {!Element} target
+ * @return {void}
+ * @see https://developer.mozilla.org/en-US/docs/Web/API/ResizeObserver/unobserve
+ */
+ResizeObserver.prototype.unobserve = function(target) {};
+
+/**
+ * @return {void}
+ * @see https://developer.mozilla.org/en-US/docs/Web/API/ResizeObserver/disconnect
+ */
+ResizeObserver.prototype.disconnect = function() {};
+
+/**
+ * @interface
+ * @see https://developer.mozilla.org/en-US/docs/Web/API/ResizeObserverEntry
+ */
+function ResizeObserverEntry() {}
+
+/**
+ * @const {!Array<!ResizeObserverSize>}
+ * @see https://developer.mozilla.org/en-US/docs/Web/API/ResizeObserverEntry/borderBoxSize
+ */
+ResizeObserverEntry.prototype.borderBoxSize;
+
+/**
+ * @const {!Array<!ResizeObserverSize>}
+ * @see https://developer.mozilla.org/en-US/docs/Web/API/ResizeObserverEntry/contentBoxSize
+ */
+ResizeObserverEntry.prototype.contentBoxSize;
+
+/**
+ * @const {!DOMRectReadOnly}
+ * @see https://developer.mozilla.org/en-US/docs/Web/API/ResizeObserverEntry/contentRect
+ */
+ResizeObserverEntry.prototype.contentRect;
+
+/**
+ * @const {!Array<!ResizeObserverSize>}
+ * @see https://developer.mozilla.org/docs/Web/API/ResizeObserverEntry/devicePixelContentBoxSize
+ */
+ResizeObserverEntry.prototype.devicePixelContentBoxSize;
+
+/**
+ * @const {!Element}
+ * @see https://developer.mozilla.org/en-US/docs/Web/API/ResizeObserverEntry/target
+ */
+ResizeObserverEntry.prototype.target;

package/externs/browser/wicg_scheduler.js

@@ -0,0 +1,62 @@
+/*
+ * Copyright 2023 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 Prioritized Task Scheduling API.
+ * @see https://wicg.github.io/scheduling-apis/
+ * @externs
+ */
+
+/**
+ * @typedef {string}
+ * @see https://wicg.github.io/scheduling-apis/#enumdef-taskpriority
+ */
+var TaskPriority;
+
+/**
+ * @typedef {function()}
+ * @see https://wicg.github.io/scheduling-apis/#callbackdef-schedulerposttaskcallback
+ */
+var SchedulerPostTaskCallback;
+
+/**
+ * @typedef {{
+ *   signal: (!AbortSignal|undefined),
+ *   priority: (!TaskPriority|undefined),
+ *   delay: (number|undefined)
+ * }}
+ * @see https://wicg.github.io/scheduling-apis/#dictdef-schedulerposttaskoptions
+ */
+var SchedulerPostTaskOptions;
+
+/**
+ * @see https://wicg.github.io/scheduling-apis/#sec-scheduler
+ * @interface
+ */
+function Scheduler() {}
+
+/**
+ * @param {!SchedulerPostTaskCallback} callback
+ * @param {!SchedulerPostTaskOptions=} options
+ * @see https://developer.mozilla.org/en-US/docs/Web/API/Scheduler/postTask
+ */
+Scheduler.prototype.postTask = function(callback, options) {};
+
+/** @type {!Scheduler} */
+Window.prototype.scheduler;
+
+/** @type {!Scheduler} */
+WorkerGlobalScope.prototype.scheduler;