@webref/idl 3.18.2 → 3.20.0

package/compute-pressure.idl

@@ -28,11 +28,12 @@ interface PressureObserver {
   [Exposed=Window] static Promise<PermissionState> requestPermission();
 };
 
-dictionary PressureRecord {
-  PressureSource source;
-  PressureState state;
-  sequence<PressureFactor> factors;
-  DOMHighResTimeStamp time;
+[Exposed=(DedicatedWorker,SharedWorker,Window), SecureContext]
+interface PressureRecord {
+  readonly attribute PressureSource source;
+  readonly attribute PressureState state;
+  readonly attribute FrozenArray<PressureFactor> factors;
+  readonly attribute DOMHighResTimeStamp time;
 };
 
 dictionary PressureObserverOptions {

package/{css-shared-element-transitions.idl → css-view-transitions.idl}

@@ -1,20 +1,20 @@
 // GENERATED CONTENT - DO NOT EDIT
 // Content was automatically extracted by Reffy into webref
 // (https://github.com/w3c/webref)
-// Source: CSS Shared Element Transitions Module Level 1 (https://drafts.csswg.org/css-shared-element-transitions-1/)
+// Source: CSS View Transitions Module Level 1 (https://drafts.csswg.org/css-view-transitions-1/)
 
 partial interface Document {
-    DOMTransition createTransition(DOMTransitionInit init);
+    ViewTransition createTransition(ViewTransitionInit init);
 };
 
-dictionary DOMTransitionInit {
+dictionary ViewTransitionInit {
     required UpdateDOMCallback updateDOM;
 };
 
 callback UpdateDOMCallback = Promise<any> ();
 
 [Exposed=Window]
-interface DOMTransition {
+interface ViewTransition {
     undefined skipTransition();
     readonly attribute Promise<undefined> finished;
     readonly attribute Promise<undefined> ready;

package/fs.idl

@@ -75,7 +75,7 @@ interface FileSystemWritableFileStream : WritableStream {
 };
 
 dictionary FileSystemReadWriteOptions {
-  [EnforceRange] required unsigned long long at;
+  [EnforceRange] unsigned long long at = 0;
 };
 
 [Exposed=DedicatedWorker, SecureContext]

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@webref/idl",
   "description": "Web IDL definitions of the web platform",
-  "version": "3.18.2",
+  "version": "3.20.0",
   "repository": {
     "type": "git",
     "url": "https://github.com/w3c/webref.git"

package/screen-capture.idl

@@ -7,10 +7,15 @@ partial interface MediaDevices {
   Promise<MediaStream> getDisplayMedia(optional DisplayMediaStreamOptions options = {});
 };
 
+enum CaptureStartFocusBehavior {
+  "focus-captured-surface",
+  "no-focus-change"
+};
+
 [Exposed=Window, SecureContext]
 interface CaptureController {
   constructor();
-  // TODO: Add setFocusBehavior() in a separate PR.
+  undefined setFocusBehavior(CaptureStartFocusBehavior focusBehavior);
 };
 
 enum SelfCapturePreferenceEnum {
@@ -31,7 +36,7 @@ enum SurfaceSwitchingPreferenceEnum {
 dictionary DisplayMediaStreamOptions {
   (boolean or MediaTrackConstraints) video = true;
   (boolean or MediaTrackConstraints) audio = false;
-  CaptureController controller = null;
+  CaptureController controller;
   SelfCapturePreferenceEnum selfBrowserSurface;
   SystemAudioPreferenceEnum systemAudio;
   SurfaceSwitchingPreferenceEnum surfaceSwitching;

package/webaudio.idl

@@ -64,16 +64,23 @@ enum AudioContextLatencyCategory {
     "playback"
 };
 
+enum AudioSinkType {
+  "none"
+};
+
 [Exposed=Window]
 interface AudioContext : BaseAudioContext {
   constructor (optional AudioContextOptions contextOptions = {});
   readonly attribute double baseLatency;
   readonly attribute double outputLatency;
+  [SecureContext] readonly attribute (DOMString or AudioSinkInfo) sinkId;
   [SecureContext] readonly attribute AudioRenderCapacity renderCapacity;
+  attribute EventHandler onsinkchange;
   AudioTimestamp getOutputTimestamp ();
   Promise<undefined> resume ();
   Promise<undefined> suspend ();
   Promise<undefined> close ();
+  [SecureContext] Promise<undefined> setSinkId ((DOMString or AudioSinkOptions) sinkId);
   MediaElementAudioSourceNode createMediaElementSource (HTMLMediaElement mediaElement);
   MediaStreamAudioSourceNode createMediaStreamSource (MediaStream mediaStream);
   MediaStreamTrackAudioSourceNode createMediaStreamTrackSource (
@@ -84,6 +91,16 @@ interface AudioContext : BaseAudioContext {
 dictionary AudioContextOptions {
   (AudioContextLatencyCategory or double) latencyHint = "interactive";
   float sampleRate;
+  (DOMString or AudioSinkOptions) sinkId;
+};
+
+dictionary AudioSinkOptions {
+  required AudioSinkType type;
+};
+
+[Exposed=Window]
+interface AudioSinkInfo {
+  readonly attribute AudioSinkType type;
 };
 
 dictionary AudioTimestamp {

package/webauthn.idl

@@ -125,6 +125,7 @@ interface AuthenticatorAssertionResponse : AuthenticatorResponse {
     [SameObject] readonly attribute ArrayBuffer      authenticatorData;
     [SameObject] readonly attribute ArrayBuffer      signature;
     [SameObject] readonly attribute ArrayBuffer?     userHandle;
+    [SameObject] readonly attribute ArrayBuffer?     attestationObject;
 };
 
 dictionary PublicKeyCredentialParameters {
@@ -143,6 +144,7 @@ dictionary PublicKeyCredentialCreationOptions {
     sequence<PublicKeyCredentialDescriptor>      excludeCredentials = [];
     AuthenticatorSelectionCriteria               authenticatorSelection;
     DOMString                                    attestation = "none";
+    sequence<DOMString>                          attestationFormats = [];
     AuthenticationExtensionsClientInputs         extensions;
 };
 
@@ -190,6 +192,8 @@ dictionary PublicKeyCredentialRequestOptions {
     USVString                            rpId;
     sequence<PublicKeyCredentialDescriptor> allowCredentials = [];
     DOMString                            userVerification = "preferred";
+    DOMString                            attestation = "none";
+    sequence<DOMString>                  attestationFormats = [];
     AuthenticationExtensionsClientInputs extensions;
 };
 
@@ -325,3 +329,21 @@ typedef sequence<UvmEntry> UvmEntries;
 partial dictionary AuthenticationExtensionsClientOutputs {
   UvmEntries uvm;
 };
+
+dictionary AuthenticationExtensionsDevicePublicKeyInputs {
+    DOMString attestation = "none";
+    sequence<DOMString> attestationFormats = [];
+};
+
+partial dictionary AuthenticationExtensionsClientInputs {
+    AuthenticationExtensionsDevicePublicKeyInputs devicePubKey;
+};
+
+dictionary AuthenticationExtensionsDevicePublicKeyOutputs {
+    ArrayBuffer authenticatorOutput;
+    ArrayBuffer signature;
+};
+
+partial dictionary AuthenticationExtensionsClientOutputs {
+    AuthenticationExtensionsDevicePublicKeyOutputs devicePubKey;
+};

package/webcodecs-aac-codec-registration.idl

@@ -0,0 +1,17 @@
+// GENERATED CONTENT - DO NOT EDIT
+// Content was automatically extracted by Reffy into webref
+// (https://github.com/w3c/webref)
+// Source: AAC WebCodecs Registration (https://w3c.github.io/webcodecs/aac_codec_registration.html)
+
+partial dictionary AudioEncoderConfig {
+  AacEncoderConfig aac;
+};
+
+dictionary AacEncoderConfig {
+  AacBitstreamFormat format = "aac";
+};
+
+enum AacBitstreamFormat {
+  "aac",
+  "adts",
+};

package/webcodecs-avc-codec-registration.idl

@@ -0,0 +1,17 @@
+// GENERATED CONTENT - DO NOT EDIT
+// Content was automatically extracted by Reffy into webref
+// (https://github.com/w3c/webref)
+// Source: AVC (H.264) WebCodecs Registration (https://w3c.github.io/webcodecs/avc_codec_registration.html)
+
+partial dictionary VideoEncoderConfig {
+  AvcEncoderConfig avc;
+};
+
+dictionary AvcEncoderConfig {
+  AvcBitstreamFormat format = "avc";
+};
+
+enum AvcBitstreamFormat {
+  "annexb",
+  "avc",
+};

package/webcodecs-hevc-codec-registration.idl

@@ -0,0 +1,17 @@
+// GENERATED CONTENT - DO NOT EDIT
+// Content was automatically extracted by Reffy into webref
+// (https://github.com/w3c/webref)
+// Source: HEVC (H.265) WebCodecs Registration (https://w3c.github.io/webcodecs/hevc_codec_registration.html)
+
+partial dictionary VideoEncoderConfig {
+  HevcEncoderConfig hevc;
+};
+
+dictionary HevcEncoderConfig {
+  HevcBitstreamFormat format = "hevc";
+};
+
+enum HevcBitstreamFormat {
+  "annexb",
+  "hevc",
+};

package/webcodecs-opus-codec-registration.idl

@@ -0,0 +1,18 @@
+// GENERATED CONTENT - DO NOT EDIT
+// Content was automatically extracted by Reffy into webref
+// (https://github.com/w3c/webref)
+// Source: Opus WebCodecs Registration (https://w3c.github.io/webcodecs/opus_codec_registration.html)
+
+partial dictionary AudioEncoderConfig {
+  OpusEncoderConfig opus;
+};
+
+dictionary OpusEncoderConfig {
+  OpusBitstreamFormat format = "opus";
+  [EnforceRange] unsigned long frameDuration;
+};
+
+enum OpusBitstreamFormat {
+  "opus",
+  "ogg",
+};

package/webcodecs.idl

@@ -146,7 +146,7 @@ dictionary AudioDecoderConfig {
 
 dictionary VideoDecoderConfig {
   required DOMString codec;
-  BufferSource description;
+  [AllowShared] BufferSource description;
   [EnforceRange] unsigned long codedWidth;
   [EnforceRange] unsigned long codedHeight;
   [EnforceRange] unsigned long displayAspectWidth;
@@ -206,7 +206,7 @@ enum CodecState {
 
 callback WebCodecsErrorCallback = undefined(DOMException error);
 
-[Exposed=(Window,DedicatedWorker)]
+[Exposed=(Window,DedicatedWorker), Serializable]
 interface EncodedAudioChunk {
   constructor(EncodedAudioChunkInit init);
   readonly attribute EncodedAudioChunkType type;
@@ -229,7 +229,7 @@ enum EncodedAudioChunkType {
     "delta",
 };
 
-[Exposed=(Window,DedicatedWorker)]
+[Exposed=(Window,DedicatedWorker), Serializable]
 interface EncodedVideoChunk {
   constructor(EncodedVideoChunkInit init);
   readonly attribute EncodedVideoChunkType type;
@@ -244,7 +244,7 @@ dictionary EncodedVideoChunkInit {
   required EncodedVideoChunkType type;
   [EnforceRange] required long long timestamp;        // microseconds
   [EnforceRange] unsigned long long duration;         // microseconds
-  required BufferSource data;
+  required [AllowShared] BufferSource data;
 };
 
 enum EncodedVideoChunkType {
@@ -400,29 +400,35 @@ interface VideoColorSpace {
 };
 
 dictionary VideoColorSpaceInit {
-  VideoColorPrimaries primaries;
-  VideoTransferCharacteristics transfer;
-  VideoMatrixCoefficients matrix;
-  boolean fullRange;
+  VideoColorPrimaries? primaries;
+  VideoTransferCharacteristics? transfer;
+  VideoMatrixCoefficients? matrix;
+  boolean? fullRange;
 };
 
 enum VideoColorPrimaries {
-  "bt709",      // BT.709, sRGB
-  "bt470bg",    // BT.601 PAL
-  "smpte170m",  // BT.601 NTSC
+  "bt709",
+  "bt470bg",
+  "smpte170m",
+  "bt2020",
+  "smpte432",
 };
 
 enum VideoTransferCharacteristics {
-  "bt709",         // BT.709
-  "smpte170m",     // BT.601 (functionally the same as bt709)
-  "iec61966-2-1",  // sRGB
+  "bt709",
+  "smpte170m",
+  "iec61966-2-1",
+  "linear",
+  "pq",
+  "hlg",
 };
 
 enum VideoMatrixCoefficients {
-  "rgb",        // sRGB
-  "bt709",      // BT.709
-  "bt470bg",    // BT.601 PAL
-  "smpte170m",  // BT.601 NTSC (functionally the same as bt470bg)
+  "rgb",
+  "bt709",
+  "bt470bg",
+  "smpte170m",
+  "bt2020-ncl",
 };
 
 [Exposed=(Window,DedicatedWorker), SecureContext]

package/webrtc-stats.idl

@@ -42,7 +42,6 @@ dictionary RTCReceivedRtpStreamStats : RTCRtpStreamStats {
              unsigned long long   packetsReceived;
              long long            packetsLost;
              double               jitter;
-             unsigned long        framesDropped;
 };
 
 dictionary RTCInboundRtpStreamStats : RTCReceivedRtpStreamStats {
@@ -52,6 +51,7 @@ dictionary RTCInboundRtpStreamStats : RTCReceivedRtpStreamStats {
  DOMString            remoteId;
  unsigned long        framesDecoded;
  unsigned long        keyFramesDecoded;
+ unsigned long        framesDropped;
  unsigned long        frameWidth;
  unsigned long        frameHeight;
  double               framesPerSecond;
@@ -59,6 +59,10 @@ dictionary RTCInboundRtpStreamStats : RTCReceivedRtpStreamStats {
  double               totalDecodeTime;
  double               totalInterFrameDelay;
  double               totalSquaredInterFrameDelay;
+ unsigned long        pauseCount;
+ double               totalPausesDuration;
+ unsigned long        freezeCount;
+ double               totalFreezesDuration;
  DOMHighResTimeStamp  lastPacketReceivedTimestamp;
  unsigned long long   headerBytesReceived;
  unsigned long long   packetsDiscarded;
@@ -87,6 +91,8 @@ dictionary RTCInboundRtpStreamStats : RTCReceivedRtpStreamStats {
  DOMString            decoderImplementation;
  DOMString            playoutId;
  boolean              powerEfficientDecoder;
+ unsigned long        framesAssembledFromMultiplePackets;
+ double               totalAssemblyTime;
 };
 
 dictionary RTCRemoteInboundRtpStreamStats : RTCReceivedRtpStreamStats {
@@ -231,6 +237,11 @@ dictionary RTCIceCandidateStats : RTCStats {
              long                     priority;
              DOMString                url;
              RTCIceServerTransportProtocol relayProtocol;
+             DOMString                foundation;
+             DOMString                relatedAddress;
+             long                     relatedPort;
+             DOMString                usernameFragment;
+             RTCIceTcpCandidateType   tcpType;
 };
 
 dictionary RTCIceCandidatePairStats : RTCStats {

package/webrtc.idl

@@ -316,6 +316,7 @@ dictionary RTCRtpCodingParameters {
 dictionary RTCRtpEncodingParameters : RTCRtpCodingParameters {
   boolean active = true;
   unsigned long maxBitrate;
+  double maxFramerate;
   double scaleResolutionDownBy;
 };
 

package/webtransport.idl

@@ -113,8 +113,8 @@ dictionary WebTransportReceiveStreamStats {
 
 [Exposed=(Window,Worker), SecureContext]
 interface WebTransportBidirectionalStream {
-  readonly attribute ReadableStream readable;
-  readonly attribute WritableStream writable;
+  readonly attribute WebTransportReceiveStream readable;
+  readonly attribute WebTransportSendStream writable;
 };
 
 [Exposed=(Window,Worker), SecureContext]