Apply insignificant IDL updates (#800)

* Support new constructor() syntax

* Apply insignificant IDL updates

* Fix bad merge

* fix further typo

* Minor fixes

1. Fix recurring formatting cut-paste error.
2. Update baseline from bad merge (I think?).

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

Author: saschanaz

baselines/dom.generated.d.ts

@@ -4345,7 +4345,7 @@ interface DataTransferItem {
      */
     getAsFile(): File | null;
     /**
-     * Invokes the callback with the string data as the argument, if the drag data item kind is Plain Unicode string.
+     * Invokes the callback with the string data as the argument, if the drag data item kind is text.
      */
     getAsString(callback: FunctionStringCallback | null): void;
     webkitGetAsEntry(): any;
@@ -5756,7 +5756,7 @@ interface GenericTransformStream {
      */
     readonly readable: ReadableStream;
     /**
-     * Returns a writable stream which accepts BufferSource chunks and runs them through encoding's decoder before making them available to readable.
+     * Returns a writable stream which accepts [AllowShared] BufferSource chunks and runs them through encoding's decoder before making them available to readable.
      * 
      * Typically this will be used via the pipeThrough() method on a ReadableStream source.
      * 
@@ -19199,7 +19199,7 @@ interface BlobCallback {
 }
 
 interface CustomElementConstructor {
-    (): any;
+    (): HTMLElement;
 }
 
 interface DecodeErrorCallback {

baselines/webworker.generated.d.ts

@@ -1629,7 +1629,7 @@ interface GenericTransformStream {
      */
     readonly readable: ReadableStream;
     /**
-     * Returns a writable stream which accepts BufferSource chunks and runs them through encoding's decoder before making them available to readable.
+     * Returns a writable stream which accepts [AllowShared] BufferSource chunks and runs them through encoding's decoder before making them available to readable.
      * 
      * Typically this will be used via the pipeThrough() method on a ReadableStream source.
      * 

inputfiles/idl/CSS Masking.widl

@@ -1,8 +1,10 @@
+[Exposed=Window]
 interface SVGClipPathElement : SVGElement {
   readonly attribute SVGAnimatedEnumeration clipPathUnits;
   readonly attribute SVGAnimatedTransformList transform;
 };
 
+[Exposed=Window]
 interface SVGMaskElement : SVGElement {
   readonly attribute SVGAnimatedEnumeration maskUnits;
   readonly attribute SVGAnimatedEnumeration maskContentUnits;

inputfiles/idl/CSS Multi-column Layout.widl

@@ -2,7 +2,6 @@ partial interface CSSStyleDeclaration {
   [CEReactions] attribute [TreatNullAs=EmptyString] CSSOMString columnWidth;
   [CEReactions] attribute [TreatNullAs=EmptyString] CSSOMString columnCount;
   [CEReactions] attribute [TreatNullAs=EmptyString] CSSOMString columns;
-  [CEReactions] attribute [TreatNullAs=EmptyString] CSSOMString columnGap;
   [CEReactions] attribute [TreatNullAs=EmptyString] CSSOMString columnRuleColor;
   [CEReactions] attribute [TreatNullAs=EmptyString] CSSOMString columnRuleStyle;
   [CEReactions] attribute [TreatNullAs=EmptyString] CSSOMString columnRuleWidth;

inputfiles/idl/CSSOM View.widl

@@ -27,11 +27,11 @@ partial interface Window {
     [Replaceable] readonly attribute double pageXOffset;
     [Replaceable] readonly attribute double scrollY;
     [Replaceable] readonly attribute double pageYOffset;
-    void scroll(optional ScrollToOptions options);
+    void scroll(optional ScrollToOptions options = {});
     void scroll(unrestricted double x, unrestricted double y);
-    void scrollTo(optional ScrollToOptions options);
+    void scrollTo(optional ScrollToOptions options = {});
     void scrollTo(unrestricted double x, unrestricted double y);
-    void scrollBy(optional ScrollToOptions options);
+    void scrollBy(optional ScrollToOptions options = {});
     void scrollBy(unrestricted double x, unrestricted double y);
 
     // client
@@ -48,13 +48,13 @@ partial interface Window {
 interface MediaQueryList : EventTarget {
   readonly attribute CSSOMString media;
   readonly attribute boolean matches;
-  void addListener(EventListener? listener);
-  void removeListener(EventListener? listener);
+  void addListener(EventListener? callback);
+  void removeListener(EventListener? callback);
            attribute EventHandler onchange;
 };
 
 [Exposed=Window,
- Constructor(CSSOMString type, optional MediaQueryListEventInit eventInitDict)]
+ Constructor(CSSOMString type, optional MediaQueryListEventInit eventInitDict = {})]
 interface MediaQueryListEvent : Event {
   readonly attribute CSSOMString media;
   readonly attribute boolean matches;
@@ -98,12 +98,12 @@ dictionary ScrollIntoViewOptions : ScrollOptions {
 partial interface Element {
   DOMRectList getClientRects();
   [NewObject] DOMRect getBoundingClientRect();
-  void scrollIntoView(optional (boolean or ScrollIntoViewOptions) arg);
-  void scroll(optional ScrollToOptions options);
+  void scrollIntoView(optional (boolean or ScrollIntoViewOptions) arg = {});
+  void scroll(optional ScrollToOptions options = {});
   void scroll(unrestricted double x, unrestricted double y);
-  void scrollTo(optional ScrollToOptions options);
+  void scrollTo(optional ScrollToOptions options = {});
   void scrollTo(unrestricted double x, unrestricted double y);
-  void scrollBy(optional ScrollToOptions options);
+  void scrollBy(optional ScrollToOptions options = {});
   void scrollBy(unrestricted double x, unrestricted double y);
   attribute unrestricted double scrollTop;
   attribute unrestricted double scrollLeft;

inputfiles/idl/Clipboard.widl

@@ -11,13 +11,42 @@ partial interface Navigator {
   [SecureContext, SameObject] readonly attribute Clipboard clipboard;
 };
 
+typedef sequence<ClipboardItem> ClipboardItems;
+
 [SecureContext, Exposed=Window] interface Clipboard : EventTarget {
-  Promise<DataTransfer> read();
+  Promise<ClipboardItems> read();
   Promise<DOMString> readText();
-  Promise<void> write(DataTransfer data);
+  Promise<void> write(ClipboardItems data);
   Promise<void> writeText(DOMString data);
 };
 
+typedef (DOMString or Blob) ClipboardItemDataType;
+typedef Promise<ClipboardItemDataType> ClipboardItemData;
+
+callback ClipboardItemDelayedCallback = ClipboardItemData ();
+
+[Constructor(record<DOMString, ClipboardItemData> items,
+    optional ClipboardItemOptions options),
+ Exposed=Window] interface ClipboardItem {
+  static ClipboardItem createDelayed(
+      record<DOMString, ClipboardItemDelayedCallback> items,
+      optional ClipboardItemOptions options);
+
+  readonly attribute PresentationStyle presentationStyle;
+  readonly attribute long long lastModified;
+  readonly attribute boolean delayed;
+
+  readonly attribute FrozenArray<DOMString> types;
+
+  Promise<Blob> getType(DOMString type);
+};
+
+enum PresentationStyle { "unspecified", "inline", "attachment" };
+
+dictionary ClipboardItemOptions {
+  PresentationStyle presentationStyle = "unspecified";
+};
+
 dictionary ClipboardPermissionDescriptor : PermissionDescriptor {
   boolean allowWithoutGesture = false;
 };

inputfiles/idl/DOM Parsing and Serialization.widl

@@ -1,5 +1,6 @@
-[Constructor, Exposed=Window]
+[Exposed=Window]
 interface DOMParser {
+  constructor();
   [NewObject] Document parseFromString(DOMString str, SupportedType type);
 };
 
@@ -11,20 +12,21 @@ enum SupportedType {
   "image/svg+xml"
 };
 
-[Constructor, Exposed=Window] 
+[Exposed=Window]
 interface XMLSerializer {
+  constructor();
   DOMString serializeToString(Node root);
 };
 
 interface mixin InnerHTML {
-  [CEReactions, TreatNullAs=EmptyString] attribute DOMString innerHTML;
+  [CEReactions] attribute [TreatNullAs=EmptyString] DOMString innerHTML;
 };
 
 Element includes InnerHTML;
 ShadowRoot includes InnerHTML;
 
 partial interface Element {
-  [CEReactions, TreatNullAs=EmptyString] attribute DOMString outerHTML;
+  [CEReactions] attribute [TreatNullAs=EmptyString] DOMString outerHTML;
   [CEReactions] void insertAdjacentHTML(DOMString position, DOMString text);
 };
 

inputfiles/idl/DeviceOrientation Event.widl

@@ -2,8 +2,9 @@ partial interface Window {
     [SecureContext] attribute EventHandler ondeviceorientation;
 };
 
-[Constructor(DOMString type, optional DeviceOrientationEventInit eventInitDict), Exposed=Window, SecureContext]
+[Exposed=Window, SecureContext]
 interface DeviceOrientationEvent : Event {
+    constructor(DOMString type, optional DeviceOrientationEventInit eventInitDict = {});
     readonly attribute double? alpha;
     readonly attribute double? beta;
     readonly attribute double? gamma;
@@ -36,22 +37,23 @@ partial interface Window {
     [SecureContext] attribute EventHandler ondevicemotion;
 };
 
-[SecureContext]
+[Exposed=Window, SecureContext]
 interface DeviceMotionEventAcceleration {
     readonly attribute double? x;
     readonly attribute double? y;
     readonly attribute double? z;
 };
 
-[SecureContext]
+[Exposed=Window, SecureContext]
 interface DeviceMotionEventRotationRate {
     readonly attribute double? alpha;
     readonly attribute double? beta;
     readonly attribute double? gamma;
 };
 
-[Constructor(DOMString type, optional DeviceMotionEventInit eventInitDict), Exposed=Window, SecureContext]
+[Exposed=Window, SecureContext]
 interface DeviceMotionEvent : Event {
+    constructor(DOMString type, optional DeviceMotionEventInit eventInitDict = {});
     readonly attribute DeviceMotionEventAcceleration? acceleration;
     readonly attribute DeviceMotionEventAcceleration? accelerationIncludingGravity;
     readonly attribute DeviceMotionEventRotationRate? rotationRate;

inputfiles/idl/Encoding.commentmap.json

@@ -10,6 +10,6 @@
     "textencoder-encodeinto": "Runs the UTF-8 encoder on source, stores the result of that operation into destination, and returns the progress made as a dictionary whereby read is the number of converted code units of source and written is the number of bytes modified in destination.",
     "textdecoderstream": "Returns a new TextDecoderStream object.\n\nIf label is either not a label or is a label for replacement, throws a RangeError.",
     "generictransformstream-readable": "Returns a readable stream whose chunks are strings resulting from running encoding's decoder on the chunks written to writable.",
-    "generictransformstream-writable": "Returns a writable stream which accepts BufferSource chunks and runs them through encoding's decoder before making them available to readable.\n\nTypically this will be used via the pipeThrough() method on a ReadableStream source.\n\n```\nvar decoder = new TextDecoderStream(encoding);\nbyteReadable\n  .pipeThrough(decoder)\n  .pipeTo(textWritable);\n```\n\nIf the error mode is \"fatal\" and encoding's decoder returns error, both readable and writable will be errored with a TypeError.",
+    "generictransformstream-writable": "Returns a writable stream which accepts [AllowShared] BufferSource chunks and runs them through encoding's decoder before making them available to readable.\n\nTypically this will be used via the pipeThrough() method on a ReadableStream source.\n\n```\nvar decoder = new TextDecoderStream(encoding);\nbyteReadable\n  .pipeThrough(decoder)\n  .pipeTo(textWritable);\n```\n\nIf the error mode is \"fatal\" and encoding's decoder returns error, both readable and writable will be errored with a TypeError.",
     "textencoderstream": "Returns a new TextEncoderStream object."
 }

inputfiles/idl/Encoding.widl

@@ -13,10 +13,11 @@ dictionary TextDecodeOptions {
   boolean stream = false;
 };
 
-[Constructor(optional DOMString label = "utf-8", optional TextDecoderOptions options),
- Exposed=(Window,Worker)]
+[Exposed=(Window,Worker)]
 interface TextDecoder {
-  USVString decode(optional BufferSource input, optional TextDecodeOptions options);
+  constructor(optional DOMString label = "utf-8", optional TextDecoderOptions options = {});
+
+  USVString decode(optional [AllowShared] BufferSource input, optional TextDecodeOptions options = {});
 };
 TextDecoder includes TextDecoderCommon;
 
@@ -29,11 +30,12 @@ dictionary TextEncoderEncodeIntoResult {
   unsigned long long written;
 };
 
-[Constructor,
- Exposed=(Window,Worker)]
+[Exposed=(Window,Worker)]
 interface TextEncoder {
+  constructor();
+
   [NewObject] Uint8Array encode(optional USVString input = "");
-  TextEncoderEncodeIntoResult encodeInto(USVString source, Uint8Array destination);
+  TextEncoderEncodeIntoResult encodeInto(USVString source, [AllowShared] Uint8Array destination);
 };
 TextEncoder includes TextEncoderCommon;
 
@@ -42,16 +44,16 @@ interface mixin GenericTransformStream {
   readonly attribute WritableStream writable;
 };
 
-[Constructor(optional DOMString label = "utf-8", optional TextDecoderOptions options),
- Exposed=(Window,Worker)]
+[Exposed=(Window,Worker)]
 interface TextDecoderStream {
+  constructor(optional DOMString label = "utf-8", optional TextDecoderOptions options = {});
 };
 TextDecoderStream includes TextDecoderCommon;
 TextDecoderStream includes GenericTransformStream;
 
-[Constructor,
- Exposed=(Window,Worker)]
+[Exposed=(Window,Worker)]
 interface TextEncoderStream {
+  constructor();
 };
 TextEncoderStream includes TextEncoderCommon;
 TextEncoderStream includes GenericTransformStream;