Merge branch 'scala-js:main' into add/scala-js#621

Author: zetashift

.github/workflows/ghpages.yml

@@ -19,7 +19,7 @@ jobs:
         run: sbt readme/run
 
       - name: Deploy
-        uses: JamesIves/[email protected].0
+        uses: JamesIves/[email protected].1
         with:
           token: ${{ secrets.GITHUB_TOKEN }}
           branch: gh-pages

.scalafmt.conf

@@ -1,4 +1,4 @@
-version = 3.5.9
+version = 3.6.1
 runner.dialect = scala213source3
 project.git = true
 style = Scala.js

api-reports/2_12.txt

@@ -0,0 +1,16 @@
+package org.scalajs.dom
+
+import scala.scalajs.js
+
+/**
+  * Helps distinguish whether apps "pasting" a clipboard item should insert the contents of an appropriate representation inline at the point of paste or if it should be treated as an attachment.
+  * See [[https://w3c.github.io/clipboard-apis/#enumdef-presentationstyle PresentationStyle enum]]
+  */
+@js.native
+sealed trait PresentationStyle extends js.Any
+
+object PresentationStyle{
+  val unspecified: PresentationStyle = "unspecified".asInstanceOf[PresentationStyle]
+  val inline: PresentationStyle = "inline".asInstanceOf[PresentationStyle]
+  val attachment: PresentationStyle = "attachment".asInstanceOf[PresentationStyle]
+}

api-reports/2_13.txt

@@ -0,0 +1,15 @@
+package org.scalajs.dom
+
+import scala.scalajs.js
+
+/**
+  * Helps distinguish whether apps "pasting" a clipboard item should insert the contents of an appropriate representation inline at the point of paste or if it should be treated as an attachment.
+  * See [[https://w3c.github.io/clipboard-apis/#enumdef-presentationstyle PresentationStyle enum]]
+  */
+opaque type PresentationStyle <: String = String
+
+object PresentationStyle {
+  val unspecified: PresentationStyle = "unspecified"
+  val inline: PresentationStyle = "inline"
+  val attachment: PresentationStyle = "attachment"
+}

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

@@ -22,9 +22,7 @@ trait Body extends js.Object {
   /** Takes a Response stream and reads it to completion. It returns a promise that resolves with a FormData object. */
   def formData(): js.Promise[FormData] = js.native
 
-  /** Takes a Response stream and reads it to completion. It returns a promise that resolves with a JSON object. //todo:
-    * define the JSON type, and return a Promise[JSON] as per spec
-    */
+  /** Takes a Response stream and reads it to completion. It returns a promise that resolves with a JSON object. */
   def json(): js.Promise[js.Any] = js.native
 
   /** Takes a Response stream and reads it to completion. It returns a promise that resolves with a USVString (text). */

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

@@ -25,7 +25,7 @@ trait Clipboard extends EventTarget {
     *
     * To read from the clipboard, you must first have the "clipboard-read" permission.
     */
-  def read(): js.Promise[DataTransfer] = js.native
+  def read(): js.Promise[js.Array[ClipboardItem]] = js.native
 
   /** The readText() method returns a Promise which resolves with a copy of the textual contents of the system
     * clipboard.
@@ -38,7 +38,7 @@ trait Clipboard extends EventTarget {
     * Before you can write to the clipboard, you need to use the Permissions API to get the "clipboard-write"
     * permission.
     */
-  def write(data: DataTransfer): js.Promise[Unit] = js.native
+  def write(data: js.Array[ClipboardItem]): js.Promise[Unit] = js.native
 
   /** The writeText() method writes the specified text string to the system clipboard. */
   def writeText(newClipText: String): js.Promise[Unit] = js.native

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

@@ -0,0 +1,28 @@
+/** All documentation for facades is thanks to Mozilla Contributors at https://developer.mozilla.org/en-US/docs/Web/API
+  * and available under the Creative Commons Attribution-ShareAlike v2.5 or later.
+  * http://creativecommons.org/licenses/by-sa/2.5/
+  *
+  * Everything else is under the MIT License http://opensource.org/licenses/MIT
+  */
+package org.scalajs.dom
+
+import scala.scalajs.js
+import scala.scalajs.js.annotation._
+
+/** A clipboard item is conceptually data that the user has expressed a desire to make shareable by invoking a "cut" or
+  * "copy" command
+  */
+@js.native
+@JSGlobal
+class ClipboardItem(items: js.Dictionary[ClipboardItemData], options: ClipboardItemOptions = js.native)
+    extends js.Object {
+  def presentationStyle: PresentationStyle = js.native
+
+  /** Returns an Array of MIME types available within the ClipboardItem. */
+  def types: FrozenArray[String] = js.native
+
+  /** Returns a Promise that resolves with a Blob of the requested MIME type, or an error if the MIME type is not found.
+    */
+  def getType(`type`: String): js.Promise[Blob] = js.native
+
+}

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

@@ -0,0 +1,13 @@
+/** All documentation for facades is thanks to Mozilla Contributors at https://developer.mozilla.org/en-US/docs/Web/API
+  * and available under the Creative Commons Attribution-ShareAlike v2.5 or later.
+  * http://creativecommons.org/licenses/by-sa/2.5/
+  *
+  * Everything else is under the MIT License http://opensource.org/licenses/MIT
+  */
+package org.scalajs.dom
+
+import scala.scalajs.js
+
+trait ClipboardItemOptions extends js.Object {
+  def presentationStyle: js.UndefOr[PresentationStyle] = js.undefined
+}

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

@@ -270,4 +270,9 @@ abstract class Element extends Node with NodeSelector with ParentNode with NonDo
     * inserted as equivalent Text nodes.
     */
   def replaceWith(nodes: (Node | String)*): Unit = js.native
+
+  /** Traverses the element and its parents (heading toward the document root) until it finds a node that matches the
+    * specified CSS selector.
+    */
+  def closest(selector: String): Element = js.native
 }

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

@@ -66,6 +66,9 @@ class Event(typeArg: String, init: js.UndefOr[EventInit] = js.undefined) extends
 
   /** Cancels the event if it is cancelable, without stopping further propagation of the event. */
   def preventDefault(): Unit = js.native
+
+  /** Indicates whether or not the event will propagate across the shadow DOM boundary into the standard DOM. */
+  def composed: Boolean = js.native
 }
 
 @js.native

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

@@ -0,0 +1,23 @@
+/** All documentation for facades is thanks to Mozilla Contributors at https://developer.mozilla.org/en-US/docs/Web/API
+  * and available under the Creative Commons Attribution-ShareAlike v2.5 or later.
+  * http://creativecommons.org/licenses/by-sa/2.5/
+  *
+  * Everything else is under the MIT License http://opensource.org/licenses/MIT
+  */
+package org.scalajs.dom
+
+import scala.scalajs.js
+
+/** A frozen array type is a parameterized type whose values are references to objects that hold a fixed length array of
+  * unmodifiable values. The values in the array are of type T.
+  *
+  * Since FrozenArray<T> values are references, they are unlike sequence types, which are lists of values that are
+  * passed by value.
+  */
+@js.native
+trait FrozenArray[+T] extends js.Iterable[T] {
+  val length: Int = js.native
+
+  @js.annotation.JSBracketAccess
+  def apply(index: Int): T = js.native
+}

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

@@ -54,6 +54,9 @@ class KeyboardEvent(typeArg: String, init: js.UndefOr[KeyboardEventInit])
 
   /** Returns the current state of the specified modifier key. */
   def getModifierState(keyArg: String): Boolean = js.native
+
+  /** Returns a string with the code value of the physical key represented by the event. */
+  def code: String = js.native
 }
 
 @js.native

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

@@ -27,4 +27,7 @@ trait KeyboardEventInit extends UIEventInit with ModifierKeyEventInit {
 
   /** Sets value of KeyboardEvent.repeat. Defaults to false. */
   var repeat: js.UndefOr[Boolean] = js.undefined
+
+  /** Sets value of KeyboardEvent.code. Defaults to empty string. */
+  var code: js.UndefOr[String] = js.undefined;
 }

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

@@ -8,23 +8,36 @@ package org.scalajs.dom
 
 import scala.scalajs.js
 
-/** A MediaQueryList object maintains a list of media queries on a document, and handles sending notifications to
-  * listeners when the media queries on the document change.
+/** A MediaQueryList object stores information on a media query applied to a document, with support for both immediate
+  * and event-driven matching against the state of the document.
   */
 @js.native
-trait MediaQueryList extends js.Object {
+trait MediaQueryList extends EventTarget {
 
-  /** true if the document currently matches the media query list; otherwise false. Read only. */
+  /** A boolean value that returns true if the document currently matches the media query list, or false if not. */
   def matches: Boolean = js.native
 
-  /** The serialized media query list */
-  var media: String = js.native
+  /** A string representing a serialized media query. */
+  def media: String = js.native
 
-  /** Adds a new listener to the media query list. If the specified listener is already in the list, this method has no
-    * effect.
+  /** Adds to the MediaQueryList a callback which is invoked whenever the media query status—whether or not the document
+    * matches the media queries in the list—changes.
+    *
+    * This method exists primarily for backward compatibility; if possible, you should instead use addEventListener() to
+    * watch for the change event.
+    * @deprecated
     */
+  @deprecated("Use addEventListener() instead", "2.4.0")
   def addListener(listener: MediaQueryListListener): Unit = js.native
 
-  /** Removes a listener from the media query list. Does nothing if the specified listener isn't already in the list. */
+  /** Removes the specified listener callback from the callbacks to be invoked when the MediaQueryList changes media
+    * query status, which happens any time the document switches between matching and not matching the media queries
+    * listed in the MediaQueryList.
+    *
+    * This method has been kept for backward compatibility; if possible, you should generally use removeEventListener()
+    * to remove change notification callbacks (which should have previously been added using addEventListener()).
+    * @deprecated
+    */
+  @deprecated("Use removeEventListener() instead", "2.4.0")
   def removeListener(listener: MediaQueryListListener): Unit = js.native
 }

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

@@ -8,10 +8,8 @@ package org.scalajs.dom
 
 import scala.scalajs.js
 
-/** A MediaQueryList object maintains a list of media queries on a document, and handles sending notifications to
-  * listeners when the media queries on the document change.
-  */
 @js.native
+@deprecated("See MediaQueryList for more info", "2.4.0")
 trait MediaQueryListListener extends js.Object {
   def apply(mql: MediaQueryList): Unit = js.native
 }

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

@@ -16,7 +16,7 @@ import scala.scalajs.js.annotation._
 @js.native
 @JSGlobal
 class Storage extends js.Object {
-  var length: Int = js.native
+  def length: Int = js.native
 
   def getItem(key: String): String = js.native
 

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

@@ -1,6 +1,7 @@
 package org.scalajs.dom
 
 import scala.scalajs.js
+import scala.scalajs.js.typedarray.ArrayBuffer
 
 /** [[http://www.w3.org/TR/WebCryptoAPI/#subtlecrypto-interface w3c ¶14 Subtle Crytpo interface]]
   *
@@ -72,7 +73,8 @@ trait SubtleCrypto extends js.Object {
     *
     * Defined at [[http://www.w3.org/TR/WebCryptoAPI/#SubtleCrypto-method-deriveBits ¶14.3.8 The deriveBits method]]
     */
-  def deriveBits(algorithm: AlgorithmIdentifier, baseKey: CryptoKey, length: Double): js.Promise[js.Any] = js.native
+  def deriveBits(algorithm: AlgorithmIdentifier, baseKey: CryptoKey,
+      length: Double): js.Promise[ArrayBuffer] = js.native
 
   /** Returns a Promise of a CryptoKey corresponding to the format, the algorithm, the raw key data, the usages and the
     * extractability given as parameters.

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

@@ -13,6 +13,7 @@ object html {
   type Collection[+E] = HTMLCollection[E]
   type DataList = HTMLDataListElement
   type Div = HTMLDivElement
+  type Dialog = HTMLDialogElement
   type DList = HTMLDListElement
   type Document = HTMLDocument
   type Element = HTMLElement

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

@@ -114,4 +114,6 @@ package object dom {
   val webcrypto: Crypto = js.native
 
   type BlobPart = BufferSource | Blob | String
+
+  type ClipboardItemData = js.Promise[String | Blob]
 }

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

@@ -1 +1 @@
-sbt.version=1.7.1
+sbt.version=1.8.2

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

@@ -1,9 +1,9 @@
 libraryDependencies += "org.scala-js" %% "scalajs-env-jsdom-nodejs" % "1.1.0"
 libraryDependencies += "org.scala-js" %% "scalajs-env-selenium"     % "1.1.1"
 
-addSbtPlugin("ch.epfl.scala" % "sbt-scalafix"        % "0.10.1")
+addSbtPlugin("ch.epfl.scala" % "sbt-scalafix"        % "0.10.4")
 addSbtPlugin("com.eed3si9n"  % "sbt-buildinfo"       % "0.11.0")
-addSbtPlugin("com.github.sbt"  % "sbt-ci-release"      % "1.5.10")
+addSbtPlugin("com.github.sbt"  % "sbt-ci-release"      % "1.5.11")
 addSbtPlugin("com.lihaoyi"   % "scalatex-sbt-plugin" % "0.3.11")
 addSbtPlugin("org.scala-js"  % "sbt-scalajs"         % "1.7.1")
-addSbtPlugin("org.scalameta" % "sbt-scalafmt"        % "2.4.6")
+addSbtPlugin("org.scalameta" % "sbt-scalafmt"        % "2.5.0")