feat(src): add MDN documentation.

Author: bikallem

src/README.mbt.md

@@ -33,6 +33,7 @@ moon add bikallem/webapi
 A simple counter application demonstrating DOM manipulation and event handling:
 
 ```moonbit
+///|
 fn main {
   // Create mutable counter state
   let mut count = 0
@@ -75,19 +76,15 @@ fn main {
 Demonstrates the Canvas 2D API with gradients, shapes, and text:
 
 ```moonbit
+///|
 fn main {
   // Create canvas element
   let canvas : @webapi.HTMLCanvasElement = @webapi.document
     .create_element("canvas")
     .into()
-  canvas
-  ..set_width(800)
-  ..set_height(500)
-
-  @webapi.document
-    .get_element_by_id("app")
-    .unwrap()
-    .append_child(canvas) |> ignore
+  canvas..set_width(800)..set_height(500)
+  @webapi.document.get_element_by_id("app").unwrap().append_child(canvas)
+  |> ignore
 
   // Get 2D rendering context
   let ctx : @webapi.CanvasRenderingContext2D = canvas
@@ -97,14 +94,10 @@ fn main {
 
   // Create gradient
   let gradient = ctx.create_linear_gradient(0.0, 0.0, 0.0, 300.0)
-  gradient
-  ..add_color_stop(0.0, "#1e3c72")
-  ..add_color_stop(1.0, "#87CEEB")
+  gradient..add_color_stop(0.0, "#1e3c72")..add_color_stop(1.0, "#87CEEB")
 
   // Draw with gradient
-  ctx
-  ..set_fill_style(gradient)
-  ..fill_rect(0.0, 0.0, 800.0, 300.0)
+  ctx..set_fill_style(gradient)..fill_rect(0.0, 0.0, 800.0, 300.0)
 
   // Draw shapes (arc uses radians: 2π for full circle)
   ctx
@@ -144,11 +137,15 @@ DOM elements are returned as generic `Element` types. Use `into()` to cast to sp
 
 ```moonbit
 // Create an element and cast to specific type
+
+///|
 let canvas : @webapi.HTMLCanvasElement = @webapi.document
   .create_element("canvas")
   .into()
 
 // Cast to access type-specific methods
+
+///|
 let ctx : @webapi.CanvasRenderingContext2D = canvas
   .get_context("2d")
   .unwrap()
@@ -227,10 +224,14 @@ interface Element : Node {
 **Generated MoonBit:**
 ```moonbit
 // External type wrapping JavaScript object
+
+///|
 #external
 pub type Element
 
 // Trait defining interface methods
+
+///|
 pub trait TElement: TNode {
   id(self : Self) -> String = _
   set_id(self : Self, id : String) -> Unit = _
@@ -239,11 +240,19 @@ pub trait TElement: TNode {
 }
 
 // Implementation using FFI
-extern "js" fn element_get_attribute_ffi(obj : JsValue, name : JsValue) -> JsValue = 
-  "(obj, name) => obj.getAttribute(name)"
 
+///|
+extern "js" fn element_get_attribute_ffi(
+  obj : JsValue,
+  name : JsValue,
+) -> JsValue = "(obj, name) => obj.getAttribute(name)"
+
+///|
 impl TElement with get_attribute(self : Self, name : String) -> String? {
-  let result = element_get_attribute_ffi(TJsValue::to_js(self), TJsValue::to_js(name))
+  let result = element_get_attribute_ffi(
+    TJsValue::to_js(self),
+    TJsValue::to_js(name),
+  )
   if JsValue::is_null(result) {
     None
   } else {
@@ -263,18 +272,21 @@ enum ShadowRootMode { "open", "closed" };
 
 **Generated MoonBit:**
 ```moonbit
+///|
 pub(all) enum ShadowRootMode {
   Open
   Closed
 } derive(Eq, Show)
 
+///|
 pub impl TJsValue for ShadowRootMode with to_js(self : ShadowRootMode) -> JsValue {
   match self {
     ShadowRootMode::Open => TJsValue::to_js("open")
     ShadowRootMode::Closed => TJsValue::to_js("closed")
   }
 }
 
+///|
 pub fn ShadowRootMode::from(value : String) -> ShadowRootMode? {
   match value {
     "open" => Some(ShadowRootMode::Open)
@@ -298,9 +310,11 @@ dictionary EventInit {
 
 **Generated MoonBit:**
 ```moonbit
+///|
 #external
 pub type EventInit
 
+///|
 pub fn EventInit::new(bubbles? : Bool, cancelable? : Bool) -> EventInit {
   event_init_ffi(opt_to_js(bubbles), opt_to_js(cancelable))
 }

src/abort_controller_interface.mbt

@@ -3,6 +3,7 @@
 // Specifications: dom.idl
 
 ///|
+/// [AbortController](https://developer.mozilla.org/en-US/docs/Web/API/AbortController)
 #external
 pub type AbortController
 
@@ -24,6 +25,7 @@ pub fn AbortController::new() -> AbortController {
 }
 
 ///|
+/// [AbortController](https://developer.mozilla.org/en-US/docs/Web/API/AbortController) interface.
 pub trait TAbortController: TJsValue {
   signal(self : Self) -> AbortSignal = _
   abort(self : Self, reason? : JsValue) -> Unit = _
@@ -33,6 +35,7 @@ pub trait TAbortController: TJsValue {
 extern "js" fn abort_controller_signal_ffi(obj : JsValue) -> AbortSignal = "(obj) => obj.signal"
 
 ///|
+/// [AbortController.signal](https://developer.mozilla.org/en-US/docs/Web/API/AbortController/signal)
 impl TAbortController with signal(self : Self) -> AbortSignal {
   abort_controller_signal_ffi(TJsValue::to_js(self))
 }
@@ -44,6 +47,7 @@ extern "js" fn abort_controller_abort_ffi(
 ) -> Unit = "(obj, reason) => obj.abort(reason)"
 
 ///|
+/// [AbortController.abort](https://developer.mozilla.org/en-US/docs/Web/API/AbortController/abort)
 impl TAbortController with abort(self : Self, reason? : JsValue) -> Unit {
   abort_controller_abort_ffi(TJsValue::to_js(self), opt_to_js(reason))
 }

src/abort_signal_interface.mbt

@@ -3,6 +3,7 @@
 // Specifications: dom.idl
 
 ///|
+/// [AbortSignal](https://developer.mozilla.org/en-US/docs/Web/API/AbortSignal)
 #external
 pub type AbortSignal
 
@@ -19,6 +20,7 @@ pub impl TAbortSignal for AbortSignal
 pub impl TEventTarget for AbortSignal
 
 ///|
+/// [AbortSignal](https://developer.mozilla.org/en-US/docs/Web/API/AbortSignal) interface.
 pub trait TAbortSignal: TEventTarget {
   aborted(self : Self) -> Bool = _
   reason(self : Self) -> JsValue = _
@@ -31,6 +33,7 @@ pub trait TAbortSignal: TEventTarget {
 extern "js" fn abort_signal_abort_ffi(reason : JsValue) -> AbortSignal = "(reason) => AbortSignal.abort(reason)"
 
 ///|
+/// [AbortSignal.abort](https://developer.mozilla.org/en-US/docs/Web/API/AbortSignal/abort)
 pub fn AbortSignal::abort(reason? : JsValue) -> AbortSignal {
   abort_signal_abort_ffi(opt_to_js(reason))
 }
@@ -39,6 +42,7 @@ pub fn AbortSignal::abort(reason? : JsValue) -> AbortSignal {
 extern "js" fn abort_signal_timeout_ffi(milliseconds : JsValue) -> AbortSignal = "(milliseconds) => AbortSignal.timeout(milliseconds)"
 
 ///|
+/// [AbortSignal.timeout](https://developer.mozilla.org/en-US/docs/Web/API/AbortSignal/timeout)
 pub fn AbortSignal::timeout(milliseconds : UInt64) -> AbortSignal {
   abort_signal_timeout_ffi(TJsValue::to_js(milliseconds))
 }
@@ -47,6 +51,7 @@ pub fn AbortSignal::timeout(milliseconds : UInt64) -> AbortSignal {
 extern "js" fn abort_signal_any_ffi(signals : JsValue) -> AbortSignal = "(signals) => AbortSignal.any(signals)"
 
 ///|
+/// [AbortSignal.any](https://developer.mozilla.org/en-US/docs/Web/API/AbortSignal/any)
 pub fn AbortSignal::any(signals : Array[AbortSignal]) -> AbortSignal {
   abort_signal_any_ffi(TJsValue::to_js(signals))
 }
@@ -55,6 +60,7 @@ pub fn AbortSignal::any(signals : Array[AbortSignal]) -> AbortSignal {
 extern "js" fn abort_signal_aborted_ffi(obj : JsValue) -> Bool = "(obj) => obj.aborted"
 
 ///|
+/// [AbortSignal.aborted](https://developer.mozilla.org/en-US/docs/Web/API/AbortSignal/aborted)
 impl TAbortSignal with aborted(self : Self) -> Bool {
   abort_signal_aborted_ffi(TJsValue::to_js(self))
 }
@@ -63,6 +69,7 @@ impl TAbortSignal with aborted(self : Self) -> Bool {
 extern "js" fn abort_signal_reason_ffi(obj : JsValue) -> JsValue = "(obj) => obj.reason"
 
 ///|
+/// [AbortSignal.reason](https://developer.mozilla.org/en-US/docs/Web/API/AbortSignal/reason)
 impl TAbortSignal with reason(self : Self) -> JsValue {
   abort_signal_reason_ffi(TJsValue::to_js(self))
 }
@@ -71,6 +78,7 @@ impl TAbortSignal with reason(self : Self) -> JsValue {
 extern "js" fn abort_signal_throw_if_aborted_ffi(obj : JsValue) -> Unit = "(obj) => obj.throwIfAborted()"
 
 ///|
+/// [AbortSignal.throwIfAborted](https://developer.mozilla.org/en-US/docs/Web/API/AbortSignal/throwIfAborted)
 impl TAbortSignal with throw_if_aborted(self : Self) -> Unit {
   abort_signal_throw_if_aborted_ffi(TJsValue::to_js(self))
 }
@@ -79,6 +87,7 @@ impl TAbortSignal with throw_if_aborted(self : Self) -> Unit {
 extern "js" fn abort_signal_onabort_ffi(obj : JsValue) -> EventHandler = "(obj) => obj.onabort"
 
 ///|
+/// [AbortSignal.onabort](https://developer.mozilla.org/en-US/docs/Web/API/AbortSignal/onabort)
 impl TAbortSignal with onabort(self : Self) -> EventHandler {
   abort_signal_onabort_ffi(TJsValue::to_js(self))
 }
@@ -90,6 +99,7 @@ extern "js" fn abort_signal_set_onabort_ffi(
 ) -> Unit = "(obj, onabort) => { obj.onabort = onabort; }"
 
 ///|
+/// [AbortSignal.onabort](https://developer.mozilla.org/en-US/docs/Web/API/AbortSignal/onabort)
 impl TAbortSignal with set_onabort(self : Self, onabort : EventHandler) -> Unit {
   abort_signal_set_onabort_ffi(TJsValue::to_js(self), TJsValue::to_js(onabort))
 }

src/abstract_range_interface.mbt

@@ -3,6 +3,7 @@
 // Specifications: dom.idl
 
 ///|
+/// [AbstractRange](https://developer.mozilla.org/en-US/docs/Web/API/AbstractRange)
 #external
 pub type AbstractRange
 
@@ -16,6 +17,7 @@ pub fn[T : TAbstractRange] AbstractRange::into(self : AbstractRange) -> T = "%id
 pub impl TAbstractRange for AbstractRange
 
 ///|
+/// [AbstractRange](https://developer.mozilla.org/en-US/docs/Web/API/AbstractRange) interface.
 pub trait TAbstractRange: TJsValue {
   start_container(self : Self) -> Node = _
   start_offset(self : Self) -> UInt = _
@@ -28,6 +30,7 @@ pub trait TAbstractRange: TJsValue {
 extern "js" fn abstract_range_start_container_ffi(obj : JsValue) -> Node = "(obj) => obj.startContainer"
 
 ///|
+/// [AbstractRange.startContainer](https://developer.mozilla.org/en-US/docs/Web/API/AbstractRange/startContainer)
 impl TAbstractRange with start_container(self : Self) -> Node {
   abstract_range_start_container_ffi(TJsValue::to_js(self))
 }
@@ -36,6 +39,7 @@ impl TAbstractRange with start_container(self : Self) -> Node {
 extern "js" fn abstract_range_start_offset_ffi(obj : JsValue) -> UInt = "(obj) => obj.startOffset"
 
 ///|
+/// [AbstractRange.startOffset](https://developer.mozilla.org/en-US/docs/Web/API/AbstractRange/startOffset)
 impl TAbstractRange with start_offset(self : Self) -> UInt {
   abstract_range_start_offset_ffi(TJsValue::to_js(self))
 }
@@ -44,6 +48,7 @@ impl TAbstractRange with start_offset(self : Self) -> UInt {
 extern "js" fn abstract_range_end_container_ffi(obj : JsValue) -> Node = "(obj) => obj.endContainer"
 
 ///|
+/// [AbstractRange.endContainer](https://developer.mozilla.org/en-US/docs/Web/API/AbstractRange/endContainer)
 impl TAbstractRange with end_container(self : Self) -> Node {
   abstract_range_end_container_ffi(TJsValue::to_js(self))
 }
@@ -52,6 +57,7 @@ impl TAbstractRange with end_container(self : Self) -> Node {
 extern "js" fn abstract_range_end_offset_ffi(obj : JsValue) -> UInt = "(obj) => obj.endOffset"
 
 ///|
+/// [AbstractRange.endOffset](https://developer.mozilla.org/en-US/docs/Web/API/AbstractRange/endOffset)
 impl TAbstractRange with end_offset(self : Self) -> UInt {
   abstract_range_end_offset_ffi(TJsValue::to_js(self))
 }
@@ -60,6 +66,7 @@ impl TAbstractRange with end_offset(self : Self) -> UInt {
 extern "js" fn abstract_range_collapsed_ffi(obj : JsValue) -> Bool = "(obj) => obj.collapsed"
 
 ///|
+/// [AbstractRange.collapsed](https://developer.mozilla.org/en-US/docs/Web/API/AbstractRange/collapsed)
 impl TAbstractRange with collapsed(self : Self) -> Bool {
   abstract_range_collapsed_ffi(TJsValue::to_js(self))
 }

src/add_event_listener_options_dictionary.mbt

@@ -3,6 +3,7 @@
 // Specifications: dom.idl
 
 ///|
+/// [AddEventListenerOptions](https://developer.mozilla.org/en-US/docs/Web/API/AddEventListenerOptions)
 #external
 pub type AddEventListenerOptions
 

src/allow_shared_buffer_source_typedef.mbt

@@ -3,6 +3,7 @@
 // Specifications: webidl.idl
 
 ///|
+/// [AllowSharedBufferSource](https://developer.mozilla.org/en-US/docs/Web/API/AllowSharedBufferSource)
 #external
 pub type AllowSharedBufferSource
 

src/array_buffer_view_typedef.mbt

@@ -3,6 +3,7 @@
 // Specifications: webidl.idl
 
 ///|
+/// [ArrayBufferView](https://developer.mozilla.org/en-US/docs/Web/API/ArrayBufferView)
 #external
 pub type ArrayBufferView
 

src/assigned_nodes_options_dictionary.mbt

@@ -3,6 +3,7 @@
 // Specifications: html.idl
 
 ///|
+/// [AssignedNodesOptions](https://developer.mozilla.org/en-US/docs/Web/API/AssignedNodesOptions)
 #external
 pub type AssignedNodesOptions