Migrate Document element properties (#2343)

Co-authored-by: saschanaz <[email protected]>

Author: Bashamega

inputfiles/overridingTypes.jsonc

@@ -536,60 +536,6 @@
                             ]
                         }
                     }
-                },
-                "properties": {
-                    "property": {
-                        "defaultView": {
-                            "name": "defaultView",
-                            "overrideType": "WindowProxy & typeof globalThis"
-                        },
-                        "documentElement": {
-                            "name": "documentElement",
-                            "overrideType": "HTMLElement",
-                            "nullable": false
-                        },
-                        "head": {
-                            "nullable": false
-                        },
-                        "anchors": {
-                            "name": "anchors",
-                            "overrideType": "HTMLCollectionOf<HTMLAnchorElement>"
-                        },
-                        "embeds": {
-                            "name": "embeds",
-                            "overrideType": "HTMLCollectionOf<HTMLEmbedElement>"
-                        },
-                        "forms": {
-                            "name": "forms",
-                            "overrideType": "HTMLCollectionOf<HTMLFormElement>"
-                        },
-                        "images": {
-                            "name": "images",
-                            "overrideType": "HTMLCollectionOf<HTMLImageElement>"
-                        },
-                        "links": {
-                            "name": "links",
-                            "overrideType": "HTMLCollectionOf<HTMLAnchorElement | HTMLAreaElement>"
-                        },
-                        "plugins": {
-                            "name": "plugins",
-                            "overrideType": "HTMLCollectionOf<HTMLEmbedElement>"
-                        },
-                        "scripts": {
-                            "name": "scripts",
-                            "overrideType": "HTMLCollectionOf<HTMLScriptElement>"
-                        },
-                        "location": {
-                            // Pre-TS-5.1 hack to make document.location assignable
-                            "readonly": false,
-                            // Technically this can be null for a detached iframe.
-                            // But that's an edge case and flipping this also breaks compatibility.
-                            "nullable": false
-                        },
-                        "body": {
-                            "nullable": false
-                       }
-                    }
                 }
             },
             "DocumentFragment": {

inputfiles/patches/dom.kdl

@@ -11,6 +11,12 @@ interface EventListenerObject noInterfaceObject=#true {
   }
 }
 
+interface Document {
+  property documentElement {
+    type HTMLElement nullable=#false
+  }
+}
+
 enum InsertPosition {
   beforebegin
   beforeend

inputfiles/patches/events.kdl

@@ -1,3 +1,5 @@
+// Events should ideally be autogenerated.
+
 interface-mixin AbstractWorker {
   event error type=ErrorEvent
 }

inputfiles/patches/globals.kdl

@@ -0,0 +1,5 @@
+// Emitter should ideally add globalThis automatically.
+
+interface Document {
+  property defaultView overrideType="WindowProxy & typeof globalThis"
+}

inputfiles/patches/html.kdl

@@ -79,6 +79,64 @@ dictionary StructuredSerializeOptions {
   }
 }
 
+// https://html.spec.whatwg.org/multipage/dom.html#the-document-object
+interface Document {
+  // Pre-TS-5.1 hack to make document.location assignable
+  property location readonly=#false {
+    // Technically this can be null for a detached iframe.
+    // But that's an edge case and flipping this also breaks compatibility.
+    type nullable=#false
+  }
+
+  // Similarly body and head are mostly non-null for HTML documents.
+  // body can frequently be null when executing scripts in head, but flipping
+  // it also breaks compatibiliity.
+  property body {
+    type nullable=#false
+  }
+  property head {
+    type nullable=#false
+  }
+
+  // More specific types for HTMLCollection properties
+  property anchors {
+    type HTMLCollectionOf {
+      type HTMLAnchorElement
+    }
+  }
+  property embeds {
+    type HTMLCollectionOf {
+      type HTMLEmbedElement
+    }
+  }
+  property forms {
+    type HTMLCollectionOf {
+      type HTMLFormElement
+    }
+  }
+  property images {
+    type HTMLCollectionOf {
+      type HTMLImageElement
+    }
+  }
+  property links {
+    type HTMLCollectionOf {
+      type HTMLAnchorElement
+      type HTMLAreaElement
+    }
+  }
+  property plugins {
+    type HTMLCollectionOf {
+      type HTMLEmbedElement
+    }
+  }
+  property scripts {
+    type HTMLCollectionOf {
+      type HTMLScriptElement
+    }
+  }
+}
+
 removals {
   dictionary CanvasRenderingContext2DSettings {
     member colorType // Blink-only as of 2025-12, being tested in WebKit