update after @lucacasonato comments

ext/cache/lib.deno_cache.d.ts

@@ -30,8 +30,7 @@ declare interface CacheStorage {
 }
 
 /** 
- * Provides a persistent storage mechanism for Request / Response object pairs 
- * that are cached in long lived memory.
+ * Provides a storage mechanism for Request / Response object pairs
  * 
  * @category Cache
  */

ext/web/lib.deno_web.d.ts

@@ -40,7 +40,7 @@ declare interface DOMException extends Error {
 /** @category Platform */
 declare var DOMException: {
   readonly prototype: DOMException;
-  new (message?: string, name?: string): DOMException;
+  new(message?: string, name?: string): DOMException;
   readonly INDEX_SIZE_ERR: 1;
   readonly DOMSTRING_SIZE_ERR: 2;
   readonly HIERARCHY_REQUEST_ERR: 3;
@@ -145,7 +145,7 @@ declare interface Event {
  */
 declare var Event: {
   readonly prototype: Event;
-  new (type: string, eventInitDict?: EventInit): Event;
+  new(type: string, eventInitDict?: EventInit): Event;
   readonly AT_TARGET: number;
   readonly BUBBLING_PHASE: number;
   readonly CAPTURING_PHASE: number;
@@ -208,7 +208,7 @@ declare interface EventTarget {
  */
 declare var EventTarget: {
   readonly prototype: EventTarget;
-  new (): EventTarget;
+  new(): EventTarget;
 };
 
 /** Represents a function type that can be used as an event listener in various
@@ -231,10 +231,7 @@ declare type EventListenerOrEventListenerObject =
   | EventListener
   | EventListenerObject;
 
-/**  adds three more optional properties to those inherited from
- * EventListenerOptions.
- *
- * @category Events */
+/** @category Events */
 declare interface AddEventListenerOptions extends EventListenerOptions {
   /** When set to true, indicates that the event listener should be automatically removed after its first invocation. */
   passive?: boolean;
@@ -288,7 +285,7 @@ declare interface ProgressEvent<T extends EventTarget = EventTarget>
  */
 declare var ProgressEvent: {
   readonly prototype: ProgressEvent;
-  new (type: string, eventInitDict?: ProgressEventInit): ProgressEvent;
+  new(type: string, eventInitDict?: ProgressEventInit): ProgressEvent;
 };
 
 /** Decodes a string of data which has been encoded using base-64 encoding.
@@ -348,7 +345,7 @@ declare interface TextDecoder {
  * @category Encoding */
 declare var TextDecoder: {
   readonly prototype: TextDecoder;
-  new (label?: string, options?: TextDecoderOptions): TextDecoder;
+  new(label?: string, options?: TextDecoderOptions): TextDecoder;
 };
 
 /** Represents the result of an encoding operation performed by a TextEncoder.
@@ -376,7 +373,7 @@ declare interface TextEncoder {
 /** @category Encoding */
 declare var TextEncoder: {
   readonly prototype: TextEncoder;
-  new (): TextEncoder;
+  new(): TextEncoder;
 };
 
 /** A stream-based text decoder for efficient processing of large or
@@ -398,7 +395,7 @@ declare interface TextDecoderStream {
 /** @category Encoding */
 declare var TextDecoderStream: {
   readonly prototype: TextDecoderStream;
-  new (label?: string, options?: TextDecoderOptions): TextDecoderStream;
+  new(label?: string, options?: TextDecoderOptions): TextDecoderStream;
 };
 
 /** Stream-based mechanism for encoding text into a stream of UTF-8 encoded data
@@ -415,7 +412,7 @@ declare interface TextEncoderStream {
 /** @category Encoding */
 declare var TextEncoderStream: {
   readonly prototype: TextEncoderStream;
-  new (): TextEncoderStream;
+  new(): TextEncoderStream;
 };
 
 /** A controller object that allows you to abort one or more DOM requests as and
@@ -438,7 +435,7 @@ declare interface AbortController {
  */
 declare var AbortController: {
   readonly prototype: AbortController;
-  new (): AbortController;
+  new(): AbortController;
 };
 
 /** @category Platform */
@@ -486,7 +483,7 @@ declare interface AbortSignal extends EventTarget {
 /** @category Platform */
 declare var AbortSignal: {
   readonly prototype: AbortSignal;
-  new (): never;
+  new(): never;
   abort(reason?: any): AbortSignal;
   any(signals: AbortSignal[]): AbortSignal;
   timeout(milliseconds: number): AbortSignal;
@@ -515,8 +512,8 @@ declare interface FileReader extends EventTarget {
   onload: ((this: FileReader, ev: ProgressEvent<FileReader>) => any) | null;
   onloadend: ((this: FileReader, ev: ProgressEvent<FileReader>) => any) | null;
   onloadstart:
-    | ((this: FileReader, ev: ProgressEvent<FileReader>) => any)
-    | null;
+  | ((this: FileReader, ev: ProgressEvent<FileReader>) => any)
+  | null;
   onprogress: ((this: FileReader, ev: ProgressEvent<FileReader>) => any) | null;
   readonly readyState: number;
   readonly result: string | ArrayBuffer | null;
@@ -553,7 +550,7 @@ declare interface FileReader extends EventTarget {
 /** @category File */
 declare var FileReader: {
   readonly prototype: FileReader;
-  new (): FileReader;
+  new(): FileReader;
   readonly DONE: number;
   readonly EMPTY: number;
   readonly LOADING: number;
@@ -593,7 +590,7 @@ declare interface Blob {
  */
 declare var Blob: {
   readonly prototype: Blob;
-  new (blobParts?: BlobPart[], options?: BlobPropertyBag): Blob;
+  new(blobParts?: BlobPart[], options?: BlobPropertyBag): Blob;
 };
 
 /** @category File */
@@ -618,7 +615,7 @@ declare interface File extends Blob {
  */
 declare var File: {
   readonly prototype: File;
-  new (fileBits: BlobPart[], fileName: string, options?: FilePropertyBag): File;
+  new(fileBits: BlobPart[], fileName: string, options?: FilePropertyBag): File;
 };
 
 /**  The result object from reading a stream when the stream has been fully
@@ -701,7 +698,7 @@ declare interface ReadableStreamBYOBReader {
 /** @category Streams */
 declare var ReadableStreamBYOBReader: {
   readonly prototype: ReadableStreamBYOBReader;
-  new (stream: ReadableStream<Uint8Array>): ReadableStreamBYOBReader;
+  new(stream: ReadableStream<Uint8Array>): ReadableStreamBYOBReader;
 };
 
 /** Notify the stream about the amount of data processed and to supply new buffers as needed.
@@ -716,7 +713,7 @@ declare interface ReadableStreamBYOBRequest {
 /** @category Streams */
 declare var ReadableStreamBYOBRequest: {
   readonly prototype: ReadableStreamBYOBRequest;
-  new (): never;
+  new(): never;
 };
 
 /** A callback function type for managing a readable byte stream.
@@ -785,7 +782,7 @@ declare interface ReadableStreamDefaultController<R = any> {
 /** @category Streams */
 declare var ReadableStreamDefaultController: {
   readonly prototype: ReadableStreamDefaultController;
-  new (): never;
+  new(): never;
 };
 
 /** Manage the flow of byte data in a stream, including buffering, closing the stream, and handling errors.
@@ -802,7 +799,7 @@ declare interface ReadableByteStreamController {
 /** @category Streams */
 declare var ReadableByteStreamController: {
   readonly prototype: ReadableByteStreamController;
-  new (): never;
+  new(): never;
 };
 
 /** Fine grained control over {@linkcode ReadableStream.pipeTo} operations, allowing for the prevention of stream closing, cancellation, or aborting.
@@ -839,7 +836,7 @@ declare interface CountQueuingStrategy extends QueuingStrategy {
 /** @category Streams */
 declare var CountQueuingStrategy: {
   readonly prototype: CountQueuingStrategy;
-  new (options: { highWaterMark: number }): CountQueuingStrategy;
+  new(options: { highWaterMark: number }): CountQueuingStrategy;
 };
 
 /** @category Streams */
@@ -852,7 +849,7 @@ declare interface ByteLengthQueuingStrategy
 /** @category Streams */
 declare var ByteLengthQueuingStrategy: {
   readonly prototype: ByteLengthQueuingStrategy;
-  new (options: { highWaterMark: number }): ByteLengthQueuingStrategy;
+  new(options: { highWaterMark: number }): ByteLengthQueuingStrategy;
 };
 
 /** This Streams API interface represents a readable stream of byte data. The
@@ -883,7 +880,7 @@ declare interface ReadableStream<R = any> {
 /** @category Streams */
 declare var ReadableStream: {
   readonly prototype: ReadableStream;
-  new (
+  new(
     underlyingSource: UnderlyingByteSource,
     strategy?: { highWaterMark?: number; size?: undefined },
   ): ReadableStream<Uint8Array>;
@@ -957,7 +954,7 @@ declare interface WritableStreamDefaultController {
 /** @category Streams */
 declare var WritableStreamDefaultController: {
   readonly prototype: WritableStreamDefaultController;
-  new (): never;
+  new(): never;
 };
 
 /** This Streams API interface is the object returned by
@@ -1010,7 +1007,7 @@ declare interface TransformStreamDefaultController<O = any> {
 /** @category Streams */
 declare var TransformStreamDefaultController: {
   readonly prototype: TransformStreamDefaultController;
-  new (): never;
+  new(): never;
 };
 
 /** Define custom behavior for transforming data in streams
@@ -1108,7 +1105,7 @@ declare interface MessageChannel {
  */
 declare var MessageChannel: {
   readonly prototype: MessageChannel;
-  new (): MessageChannel;
+  new(): MessageChannel;
 };
 
 /** @category Messaging */
@@ -1175,7 +1172,7 @@ declare interface MessagePort extends EventTarget {
  */
 declare var MessagePort: {
   readonly prototype: MessagePort;
-  new (): never;
+  new(): never;
 };
 
 /**
@@ -1248,7 +1245,7 @@ declare var CompressionStream: {
    * Throws a `TypeError` if the format passed to the constructor is not
    * supported.
    */
-  new (format: string): CompressionStream;
+  new(format: string): CompressionStream;
 };
 
 /**
@@ -1295,7 +1292,7 @@ declare var DecompressionStream: {
    * Throws a `TypeError` if the format passed to the constructor is not
    * supported.
    */
-  new (format: string): DecompressionStream;
+  new(format: string): DecompressionStream;
 };
 
 /** Dispatch an uncaught exception. Similar to a synchronous version of:
@@ -1339,14 +1336,11 @@ declare interface ImageData {
   readonly width: number;
 }
 
-/** Work with image data, create new image data objects or manipulate existing
- * pixel data.
- *
- * @category Platform */
+/** @category Platform */
 declare var ImageData: {
   prototype: ImageData;
-  new (sw: number, sh: number, settings?: ImageDataSettings): ImageData;
-  new (
+  new(sw: number, sh: number, settings?: ImageDataSettings): ImageData;
+  new(
     data: Uint8ClampedArray,
     sw: number,
     sh?: number,