Generate links to MDN docs

baselines/audioworklet.iterable.generated.d.ts

@@ -3,7 +3,11 @@
 /////////////////////////////
 
 interface MessageEvent<T = any> {
-    /** @deprecated */
+    /**
+     * @deprecated
+     *
+     * [MDN Reference](https://developer.mozilla.org/docs/Web/API/MessageEvent/initMessageEvent)
+     */
     initMessageEvent(type: string, bubbles?: boolean, cancelable?: boolean, data?: any, origin?: string, lastEventId?: string, source?: MessageEventSource | null, ports?: Iterable<MessagePort>): void;
 }
 

src/build.ts

@@ -4,7 +4,11 @@ import { merge, resolveExposure, arrayToMap } from "./build/helpers.js";
 import { emitWebIdl } from "./build/emitter.js";
 import { convert } from "./build/widlprocess.js";
 import { getExposedTypes } from "./build/expose.js";
-import { getDeprecationData, getRemovalData } from "./build/bcd.js";
+import {
+  getDeprecationData,
+  getDocsData,
+  getRemovalData,
+} from "./build/bcd.js";
 import { getInterfaceElementMergeData } from "./build/webref/elements.js";
 import { getWebidls } from "./build/webref/idl.js";
 import jsonc from "jsonc-parser";
@@ -253,6 +257,7 @@ async function emitDom() {
 
   webidl = merge(webidl, getDeprecationData(webidl));
   webidl = merge(webidl, getRemovalData(webidl));
+  webidl = merge(webidl, getDocsData(webidl));
   webidl = prune(webidl, removedItems);
   webidl = mergeApiDescriptions(webidl, documentationFromMDN);
   webidl = merge(webidl, addedItems);

src/build/bcd.ts

@@ -76,3 +76,11 @@ export function getDeprecationData(webidl: Browser.WebIdl): Browser.WebIdl {
     }
   }) as Browser.WebIdl;
 }
+
+export function getDocsData(webidl: Browser.WebIdl): Browser.WebIdl {
+  return mapToBcdCompat(webidl, ({ compat }) => {
+    if (compat?.mdn_url) {
+      return { mdnUrl: compat.mdn_url };
+    }
+  }) as Browser.WebIdl;
+}

src/build/emitter.ts

@@ -841,6 +841,7 @@ export function emitWebIdl(
       comment?: string;
       deprecated?: boolean | string;
       secureContext?: boolean;
+      mdnUrl?: string;
     },
     print: (s: string) => void
   ) {
@@ -857,6 +858,10 @@ export function emitWebIdl(
     if (entity.secureContext) {
       comments.push("Available only in secure contexts.");
     }
+    if (entity.mdnUrl) {
+      if (comments.length > 0) comments.push("");
+      comments.push(`[MDN Reference](${entity.mdnUrl})`);
+    }
 
     if (comments.length > 1) {
       print("/**");

src/build/types.d.ts

@@ -59,6 +59,7 @@ export interface Property extends Typed {
   deprecated?: boolean;
   exposed?: string;
   secureContext?: boolean;
+  mdnUrl?: string;
 }
 
 export interface Event {
@@ -88,6 +89,7 @@ export interface AnonymousMethod {
   deprecated?: boolean;
   signature: Signature[];
   secureContext?: boolean;
+  mdnUrl?: string;
 }
 
 export interface Method extends AnonymousMethod {
@@ -194,6 +196,7 @@ export interface Interface {
   };
   deprecated?: boolean | string;
   secureContext?: boolean;
+  mdnUrl?: string;
   transferable?: boolean;
 }