General IDL updates (#865)

* General IDL updates

* restore Option

Co-authored-by: Nathan Shively-Sanders <[email protected]>

Author: saschanaz

baselines/dom.generated.d.ts

@@ -3926,7 +3926,7 @@ interface DOMParser {
     /**
      * Parses string using either the HTML or XML parser, according to type, and returns the resulting Document. type can be "text/html" (which will invoke the HTML parser), or any of "text/xml", "application/xml", "application/xhtml+xml", or "image/svg+xml" (which will invoke the XML parser).
      * 
-     * For the XML parser, if string can be parsed, then the returned Document will contain elements describing the resulting error.
+     * For the XML parser, if string cannot be parsed, then the returned Document will contain elements describing the resulting error.
      * 
      * Note that script elements are not evaluated during parsing, and the resulting document's encoding will always be UTF-8.
      * 

inputfiles/idl/Clipboard.widl

@@ -2,8 +2,9 @@ dictionary ClipboardEventInit : EventInit {
   DataTransfer? clipboardData = null;
 };
 
-[Constructor(DOMString type, optional ClipboardEventInit eventInitDict), Exposed=Window]
+[Exposed=Window]
 interface ClipboardEvent : Event {
+  constructor(DOMString type, optional ClipboardEventInit eventInitDict = {});
   readonly attribute DataTransfer? clipboardData;
 };
 
@@ -25,12 +26,12 @@ typedef Promise<ClipboardItemDataType> ClipboardItemData;
 
 callback ClipboardItemDelayedCallback = ClipboardItemData ();
 
-[Constructor(record<DOMString, ClipboardItemData> items,
-    optional ClipboardItemOptions options),
- Exposed=Window] interface ClipboardItem {
+[Exposed=Window] interface ClipboardItem {
+  constructor(record<DOMString, ClipboardItemData> items,
+    optional ClipboardItemOptions options = {});
   static ClipboardItem createDelayed(
       record<DOMString, ClipboardItemDelayedCallback> items,
-      optional ClipboardItemOptions options);
+      optional ClipboardItemOptions options = {});
 
   readonly attribute PresentationStyle presentationStyle;
   readonly attribute long long lastModified;

inputfiles/idl/Fullscreen.widl

@@ -16,8 +16,8 @@ partial interface Element {
 };
 
 partial interface Document {
-  [LenientSetter] readonly attribute boolean fullscreenEnabled;
-  [LenientSetter, Unscopable] readonly attribute boolean fullscreen; // historical
+  [LegacyLenientSetter] readonly attribute boolean fullscreenEnabled;
+  [LegacyLenientSetter, Unscopable] readonly attribute boolean fullscreen; // historical
 
   Promise<void> exitFullscreen();
 
@@ -26,5 +26,5 @@ partial interface Document {
 };
 
 partial interface mixin DocumentOrShadowRoot {
-  [LenientSetter] readonly attribute Element? fullscreenElement;
+  [LegacyLenientSetter] readonly attribute Element? fullscreenElement;
 };

inputfiles/idl/Gamepad Extensions.widl

@@ -4,6 +4,7 @@ enum GamepadHand {
   "right"
 };
 
+[Exposed=Window]
 interface GamepadHapticActuator {
   readonly attribute GamepadHapticActuatorType type;
   Promise<boolean> pulse(double value, double duration);
@@ -13,6 +14,7 @@ enum GamepadHapticActuatorType {
   "vibration"
 };
 
+[Exposed=Window]
 interface GamepadPose {
   readonly attribute boolean hasOrientation;
   readonly attribute boolean hasPosition;

inputfiles/idl/HTML - Browsing the Web.widl

@@ -1,16 +1,18 @@
-[Exposed=Window,
- Constructor(DOMString type, optional PopStateEventInit eventInitDict = {})]
+[Exposed=Window]
 interface PopStateEvent : Event {
+  constructor(DOMString type, optional PopStateEventInit eventInitDict = {});
+
   readonly attribute any state;
 };
 
 dictionary PopStateEventInit : EventInit {
   any state = null;
 };
 
-[Exposed=Window,
- Constructor(DOMString type, optional HashChangeEventInit eventInitDict = {})]
+[Exposed=Window]
 interface HashChangeEvent : Event {
+  constructor(DOMString type, optional HashChangeEventInit eventInitDict = {});
+
   readonly attribute USVString oldURL;
   readonly attribute USVString newURL;
 };
@@ -20,9 +22,10 @@ dictionary HashChangeEventInit : EventInit {
   USVString newURL = "";
 };
 
-[Exposed=Window,
- Constructor(DOMString type, optional PageTransitionEventInit eventInitDict = {})]
+[Exposed=Window]
 interface PageTransitionEvent : Event {
+  constructor(DOMString type, optional PageTransitionEventInit eventInitDict = {});
+
   readonly attribute boolean persisted;
 };
 

inputfiles/idl/HTML - Drag and drop.widl

@@ -36,9 +36,10 @@ interface DataTransferItem {
 
 callback FunctionStringCallback = void (DOMString data);
 
-[Exposed=Window,
- Constructor(DOMString type, optional DragEventInit eventInitDict = {})]
+[Exposed=Window]
 interface DragEvent : MouseEvent {
+  constructor(DOMString type, optional DragEventInit eventInitDict = {});
+
   readonly attribute DataTransfer? dataTransfer;
 };
 

inputfiles/idl/HTML - Dynamic markup insertion.commentmap.json

@@ -4,5 +4,5 @@
     "document-write": "In general, adds the given string(s) to the Document's input stream.\n\nThis method has very idiosyncratic behavior. In some cases, this method can affect the state of the HTML parser while the parser is running, resulting in a DOM that does not correspond to the source of the document (e.g. if the string written is the string \"<plaintext>\" or \"<!--\"). In other cases, the call can clear the current page first, as if document.open() had been called. In yet more cases, the method is simply ignored, or throws an exception. Users agents are explicitly allowed to avoid executing script elements inserted via this method. And to make matters even worse, the exact behavior of this method can in some cases be dependent on network latency, which can lead to failures that are very hard to debug. For all these reasons, use of this method is strongly discouraged.\n\nThrows an \"InvalidStateError\" DOMException when invoked on XML documents.\n\nThrows an \"InvalidStateError\" DOMException if the parser is currently executing a custom element constructor.",
     "document-writeln": "Adds the given string(s) to the Document's input stream, followed by a newline character. If necessary, calls the open() method implicitly first.\n\nThrows an \"InvalidStateError\" DOMException when invoked on XML documents.\n\nThrows an \"InvalidStateError\" DOMException if the parser is currently executing a custom element constructor.",
     "domparser-constructor": "Constructs a new DOMParser object.",
-    "domparser-parsefromstring": "Parses string using either the HTML or XML parser, according to type, and returns the resulting Document. type can be \"text/html\" (which will invoke the HTML parser), or any of \"text/xml\", \"application/xml\", \"application/xhtml+xml\", or \"image/svg+xml\" (which will invoke the XML parser).\n\nFor the XML parser, if string can be parsed, then the returned Document will contain elements describing the resulting error.\n\nNote that script elements are not evaluated during parsing, and the resulting document's encoding will always be UTF-8.\n\nValues other than the above for type will cause a TypeError exception to be thrown."
+    "domparser-parsefromstring": "Parses string using either the HTML or XML parser, according to type, and returns the resulting Document. type can be \"text/html\" (which will invoke the HTML parser), or any of \"text/xml\", \"application/xml\", \"application/xhtml+xml\", or \"image/svg+xml\" (which will invoke the XML parser).\n\nFor the XML parser, if string cannot be parsed, then the returned Document will contain elements describing the resulting error.\n\nNote that script elements are not evaluated during parsing, and the resulting document's encoding will always be UTF-8.\n\nValues other than the above for type will cause a TypeError exception to be thrown."
 }

inputfiles/idl/HTML - Forms.widl

@@ -1,5 +1,5 @@
 [Exposed=Window,
- OverrideBuiltins,
+ LegacyOverrideBuiltIns,
  LegacyUnenumerableNamedProperties]
 interface HTMLFormElement : HTMLElement {
   [HTMLConstructor] constructor();

inputfiles/idl/HTML - Session history and navigation.widl

@@ -14,19 +14,19 @@ interface History {
 
 [Exposed=Window]
 interface Location { // but see also additional creation steps and overridden internal methods
-  [Unforgeable] stringifier attribute USVString href;
-  [Unforgeable] readonly attribute USVString origin;
-  [Unforgeable] attribute USVString protocol;
-  [Unforgeable] attribute USVString host;
-  [Unforgeable] attribute USVString hostname;
-  [Unforgeable] attribute USVString port;
-  [Unforgeable] attribute USVString pathname;
-  [Unforgeable] attribute USVString search;
-  [Unforgeable] attribute USVString hash;
+  [LegacyUnforgeable] stringifier attribute USVString href;
+  [LegacyUnforgeable] readonly attribute USVString origin;
+  [LegacyUnforgeable] attribute USVString protocol;
+  [LegacyUnforgeable] attribute USVString host;
+  [LegacyUnforgeable] attribute USVString hostname;
+  [LegacyUnforgeable] attribute USVString port;
+  [LegacyUnforgeable] attribute USVString pathname;
+  [LegacyUnforgeable] attribute USVString search;
+  [LegacyUnforgeable] attribute USVString hash;
 
-  [Unforgeable] void assign(USVString url);
-  [Unforgeable] void replace(USVString url);
-  [Unforgeable] void reload();
+  [LegacyUnforgeable] void assign(USVString url);
+  [LegacyUnforgeable] void replace(USVString url);
+  [LegacyUnforgeable] void reload();
 
-  [Unforgeable, SameObject] readonly attribute DOMStringList ancestorOrigins;
+  [LegacyUnforgeable, SameObject] readonly attribute DOMStringList ancestorOrigins;
 };

inputfiles/idl/HTML - Web storage.widl

@@ -18,9 +18,10 @@ interface mixin WindowLocalStorage {
 };
 Window includes WindowLocalStorage;
 
-[Exposed=Window,
- Constructor(DOMString type, optional StorageEventInit eventInitDict = {})]
+[Exposed=Window]
 interface StorageEvent : Event {
+  constructor(DOMString type, optional StorageEventInit eventInitDict = {});
+
   readonly attribute DOMString? key;
   readonly attribute DOMString? oldValue;
   readonly attribute DOMString? newValue;

inputfiles/idl/High Resolution Time.widl

@@ -2,7 +2,7 @@ typedef double DOMHighResTimeStamp;
 
 [Exposed=(Window,Worker)]
 interface Performance : EventTarget {
-    DOMHighResTimeStamp now ();
+    DOMHighResTimeStamp now();
     readonly attribute DOMHighResTimeStamp timeOrigin;
     [Default] object toJSON();
 };