Audio API changes

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

@@ -0,0 +1,30 @@
+/** Documentation 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
+
+@js.native
+/** Represents an enumerated value describing the way channels must be matched between the AudioNode's inputs and
+  * outputs.
+  */
+sealed trait AudioNodeChannelCountMode extends js.Any
+
+object AudioNodeChannelCountMode {
+
+  /** The number of channels is equal to the maximum number of channels of all connections. In this case, channelCount
+    * is ignored and only up-mixing happens.
+    */
+  val max: AudioNodeChannelCountMode = "max".asInstanceOf[AudioNodeChannelCountMode]
+
+  /** The number of channels is equal to the maximum number of channels of all connections, clamped to the value of
+    * channelCount.
+    */
+  val `clamped-max`: AudioNodeChannelCountMode = "clamped-max".asInstanceOf[AudioNodeChannelCountMode]
+
+  /** The number of channels is defined by the value of channelCount. */
+  val explicit: AudioNodeChannelCountMode = "explicit".asInstanceOf[AudioNodeChannelCountMode]
+}

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

@@ -0,0 +1,28 @@
+/** Documentation 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
+
+@js.native
+/** Represents an enumerated value describing how input channels are mapped to output channels when the number of
+  * inputs/outputs is different. For example, this setting defines how a mono input will be up-mixed to a stereo or 5.1
+  * channel output, or how a quad channel input will be down-mixed to a stereo or mono output.
+  */
+sealed trait AudioNodeChannelInterpretation extends js.Any
+
+object AudioNodeChannelInterpretation {
+
+  /** Use set of "standard" mappings for combinations of common speaker input and outputs setups (mono, stereo, quad,
+    * 5.1). For example, with this setting a mono channel input will output to both channels of a stereo output.
+    */
+  val speakers: AudioNodeChannelInterpretation = "speakers".asInstanceOf[AudioNodeChannelInterpretation]
+
+  /** Input channels are mapped to output channels in order. If there are more inputs that outputs the additional inputs
+    * are dropped; if there are fewer than the unused outputs are silent.
+    */
+  val discrete: AudioNodeChannelInterpretation = "discrete".asInstanceOf[AudioNodeChannelInterpretation]
+}

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

@@ -0,0 +1,22 @@
+/** Documentation 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
+
+@js.native
+sealed trait AudioParamAutomationRate extends js.Any
+
+object AudioParamAutomationRate {
+
+  /** An a-rate [[AudioParam]] takes the current audio parameter value for each sample frame of the audio signal. */
+  val `a-rate`: AudioParamAutomationRate = "a-rate".asInstanceOf[AudioParamAutomationRate]
+
+  /** A k-rate [[AudioParam]] uses the same initial audio parameter value for the whole block processed; that is, 128
+    * sample frames. In other words, the same value applies to every frame in the audio as it's processed by the node.
+    */
+  val `k-rate`: AudioParamAutomationRate = "k-rate".asInstanceOf[AudioParamAutomationRate]
+}

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

@@ -0,0 +1,31 @@
+/** Documentation 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
+
+@js.native
+sealed trait OscillatorNodeType extends js.Any
+
+object OscillatorNodeType {
+
+  /** A sine wave. This is the default value. */
+  val sine: OscillatorNodeType = "sine".asInstanceOf[OscillatorNodeType]
+
+  /** A square wave with a duty cycle of 0.5; that is, the signal is "high" for half of each period. */
+  val square: OscillatorNodeType = "square".asInstanceOf[OscillatorNodeType]
+
+  /** A sawtooth wave. */
+  val sawtooth: OscillatorNodeType = "sawtooth".asInstanceOf[OscillatorNodeType]
+
+  /** A triangle wave. */
+  val triangle: OscillatorNodeType = "triangle".asInstanceOf[OscillatorNodeType]
+
+  /** A custom waveform. You never set type to custom manually; instead, use the setPeriodicWave() method to provide the
+    * data representing the waveform. Doing so automatically sets the type to custom.
+    */
+  val custom: OscillatorNodeType = "custom".asInstanceOf[OscillatorNodeType]
+}

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

@@ -0,0 +1,29 @@
+/** Documentation 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
+
+/** Represents an enumerated value describing the way channels must be matched between the AudioNode's inputs and
+  * outputs.
+  */
+opaque type AudioNodeChannelCountMode <: String = String
+
+object AudioNodeChannelCountMode {
+
+  /** The number of channels is equal to the maximum number of channels of all connections. In this case, channelCount
+    * is ignored and only up-mixing happens.
+    */
+  val max: AudioNodeChannelCountMode = "max"
+
+  /** The number of channels is equal to the maximum number of channels of all connections, clamped to the value of
+    * channelCount.
+    */
+  val `clamped-max`: AudioNodeChannelCountMode = "clamped-max"
+
+  /** The number of channels is defined by the value of channelCount. */
+  val explicit: AudioNodeChannelCountMode = "explicit"
+}

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

@@ -0,0 +1,27 @@
+/** Documentation 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
+
+/** Represents an enumerated value describing how input channels are mapped to output channels when the number of
+  * inputs/outputs is different. For example, this setting defines how a mono input will be up-mixed to a stereo or 5.1
+  * channel output, or how a quad channel input will be down-mixed to a stereo or mono output.
+  */
+opaque type AudioNodeChannelInterpretation <: String = String
+
+object AudioNodeChannelInterpretation {
+
+  /** Use set of "standard" mappings for combinations of common speaker input and outputs setups (mono, stereo, quad,
+    * 5.1). For example, with this setting a mono channel input will output to both channels of a stereo output.
+    */
+  val speakers: AudioNodeChannelInterpretation = "speakers"
+
+  /** Input channels are mapped to output channels in order. If there are more inputs that outputs the additional inputs
+    * are dropped; if there are fewer than the unused outputs are silent.
+    */
+  val discrete: AudioNodeChannelInterpretation = "discrete"
+}

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

@@ -0,0 +1,21 @@
+/** Documentation 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
+
+opaque type AudioParamAutomationRate <: String = String
+
+object AudioParamAutomationRate {
+
+  /** An a-rate [[AudioParam]] takes the current audio parameter value for each sample frame of the audio signal. */
+  val `a-rate`: AudioParamAutomationRate = "a-rate"
+
+  /** A k-rate [[AudioParam]] uses the same initial audio parameter value for the whole block processed; that is, 128
+    * sample frames. In other words, the same value applies to every frame in the audio as it's processed by the node.
+    */
+  val `k-rate`: AudioParamAutomationRate = "k-rate"
+}

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

@@ -0,0 +1,30 @@
+/** Documentation 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
+
+opaque type OscillatorNodeType <: String = String
+
+object OscillatorNodeType {
+
+  /** A sine wave. This is the default value. */
+  val sine: OscillatorNodeType = "sine"
+
+  /** A square wave with a duty cycle of 0.5; that is, the signal is "high" for half of each period. */
+  val square: OscillatorNodeType = "square"
+
+  /** A sawtooth wave. */
+  val sawtooth: OscillatorNodeType = "sawtooth"
+
+  /** A triangle wave. */
+  val triangle: OscillatorNodeType = "triangle"
+
+  /** A custom waveform. You never set type to custom manually; instead, use the setPeriodicWave() method to provide the
+    * data representing the waveform. Doing so automatically sets the type to custom.
+    */
+  val custom: OscillatorNodeType = "custom"
+}

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

@@ -24,7 +24,7 @@ import scala.scalajs.js
   *   - Channel count: defined by the associated AudioBuffer
   */
 @js.native
-trait AudioBufferSourceNode extends AudioNode {
+trait AudioBufferSourceNode extends AudioScheduledSourceNode {
 
   /** Is an AudioBuffer that defines the audio asset to be played, or when set to the value null, defines a single
     * channel of silence.
@@ -63,16 +63,20 @@ trait AudioBufferSourceNode extends AudioNode {
     *   The duration parameter, which defaults to the length of the asset minus the value of offset, defines the length
     *   of the portion of the asset to be played.
     */
-  def start(when: Double = js.native, offset: Double = js.native, duration: Double = js.native): Unit = js.native
+  def start(when: Double, offset: Double, duration: Double): Unit = js.native
 
-  /** Schedules the end of the playback of an audio asset.
-    *
-    * @param when
-    *   The when parameter defines when the playback will stop. If it represents a time in the past, the playback will
-    *   end immediately. If this method is called twice or more, an exception is raised.
-    */
-  def stop(when: Double = js.native): Unit = js.native
+  def start(when: Double, offset: Double): Unit = js.native
+
+}
+
+object AudioBufferSourceNode {
+
+  import js.`|`.undefOr2jsAny
 
-  /** Is an EventHandler containing the callback associated with the ended event. */
-  var onended: js.Function1[Event, _] = js.native
+  def apply(context: BaseAudioContext,
+      options: js.UndefOr[AudioBufferSourceNodeOptions] = js.undefined): AudioBufferSourceNode = {
+    js.Dynamic
+      .newInstance(js.Dynamic.global.AudioBufferSourceNode)(context, options)
+      .asInstanceOf[AudioBufferSourceNode]
+  }
 }

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

@@ -0,0 +1,48 @@
+/** Documentation 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 AudioBufferSourceNodeOptions extends js.Object {
+
+  /** An instance of [[AudioBuffer]] to be played. */
+  var buffer: js.UndefOr[AudioBuffer] = js.undefined
+
+  /** Indicates whether the audio should play in a loop. The default is false. If the loop is dynamically modified
+    * during playback, the new value will take effect on the next processing block of audio.
+    */
+  var loop: js.UndefOr[Boolean] = js.undefined
+
+  /** An optional value in seconds, where looping should begin if the loop attribute is true. The default is 0. It's
+    * sensible to set this to a value between 0 and the duration of the buffer. If loopStart is less than 0, looping
+    * will begin at 0. If loopStart is greater than the duration of the buffer, looping will begin at the end of the
+    * buffer. This attribute is converted to an exact sample frame offset within the buffer, by multiplying by the
+    * buffer's sample rate and rounding to the nearest integer value. Thus, its behavior is independent of the value of
+    * the playbackRate parameter.
+    */
+  var loopStart: js.UndefOr[Double] = js.undefined
+
+  /** An optional value, in seconds, where looping should end if the loop attribute is true. The default is 0. Its value
+    * is exclusive to the content of the loop. The sample frames, comprising the loop, run from the values loopStart to
+    * loopEnd-(1/sampleRate). It's sensible to set this to a value between 0 and the duration of the buffer. If loopEnd
+    * is less than 0, looping will end at 0. If loopEnd is greater than the duration of the buffer, looping will end at
+    * the end of the buffer. This attribute is converted to an exact sample frame offset within the buffer, by
+    * multiplying by the buffer's sample rate and rounding to the nearest integer value. Thus, its behavior is
+    * independent of the value of the playbackRate parameter.
+    */
+  var loopEnd: js.UndefOr[Double] = js.undefined
+
+  /** A value in cents to modulate the speed of audio stream rendering. Its nominal range is (-∞ to +∞). The default is
+    * 0.
+    */
+  var detune: js.UndefOr[Double] = js.undefined
+
+  /** The speed at which to render the audio stream. Its default value is 1. This parameter is k-rate. This is a
+    * compound parameter with detune. Its nominal range is (-∞ to +∞).
+    */
+  var playbackRate: js.UndefOr[Double] = js.undefined
+}