Code review change

Author: peter-jerry-ye

api-reports/2_12.txt

@@ -0,0 +1,11 @@
+package org.scalajs.dom
+
+import scala.scalajs.js
+
+@js.native
+sealed trait EncapsulationMode extends js.Any
+
+object EncapsulationMode {
+  val open: EncapsulationMode = "open".asInstanceOf[EncapsulationMode]
+  val closed: EncapsulationMode = "closed".asInstanceOf[EncapsulationMode]
+}

api-reports/2_13.txt

@@ -0,0 +1,8 @@
+package org.scalajs.dom
+
+opaque type EncapsulationMode <: String = String
+
+object EncapsulationMode {
+  val open: EncapsulationMode = "open"
+  val closed: EncapsulationMode = "closed"
+}

dom/src/main/scala-2/org/scalajs/dom/EncapsulationMode.scala

@@ -17,5 +17,5 @@ import scala.scalajs.js.annotation._
 abstract class CustomElementRegistry extends js.Object {
 
   /** Defines a new custom element. */
-  def define(name: String, constructor: js.Dynamic, options: CustomElementDefineOptions = js.native): Unit
+  def define(name: String, constructor: js.Dynamic, options: ElementDefinitionOptions = js.native): Unit
 }

dom/src/main/scala-3/org/scalajs/dom/EncapsulationMode.scala

@@ -261,7 +261,7 @@ abstract class Element extends Node with NodeSelector with ParentNode with NonDo
   def requestPointerLock(): Unit = js.native
 
   /** Attaches a shadow DOM tree to the specified element and returns a reference to its ShadowRoot. */
-  def attachShadow(init: AttachShadowRootOptions): ShadowRoot = js.native
+  def attachShadow(init: ShadowRootInit): ShadowRoot = js.native
 
   /** Returns the open shadow root that is hosted by the element, or null if no open shadow root is present. */
   def shadowRoot: ShadowRoot = js.native

dom/src/main/scala/org/scalajs/dom/AttachShadowRootOptions.scala

@@ -0,0 +1,10 @@
+package org.scalajs.dom
+
+import scala.scalajs.js
+
+/** An ElementDefinitionOptions object represents additional options associated with CustomElementRegsitry.define. */
+trait ElementDefinitionOptions extends js.Object {
+
+  /** String specifying the name of a built-in element to extend. Used to create a customized built-in element. */
+  var `extends`: js.UndefOr[String] = js.undefined
+}

dom/src/main/scala/org/scalajs/dom/CustomElementDefineOptions.scala

@@ -0,0 +1,23 @@
+package org.scalajs.dom
+
+import scala.scalajs.js
+
+/** A ShadowRootInit object represents additional options associated with Element.attachShadow. */
+trait ShadowRootInit extends js.Object {
+
+  /** A string specifying the encapsulation mode for the shadow DOM tree. This can be one of:
+    *
+    * open: Elements of the shadow root are accessible from JavaScript outside the root, for example using
+    * Element.shadowRoot: element.shadowRoot; // Returns a ShadowRoot obj
+    *
+    * closed: Denies access to the node(s) of a closed shadow root from JavaScript outside it: element.shadowRoot; //
+    * Returns null
+    */
+  var mode: EncapsulationMode
+
+  /** A boolean that, when set to true, specifies behavior that mitigates custom element issues around focusability.
+    * When a non-focusable part of the shadow DOM is clicked, the first focusable part is given focus, and the shadow
+    * host is given any available :focus styling.
+    */
+  var delegatesFocus: js.UndefOr[Boolean] = js.undefined
+}