@webref/idl 3.1.2 → 3.2.1

package/compute-pressure.idl

@@ -3,30 +3,34 @@
 // (https://github.com/w3c/webref)
 // Source: Compute Pressure API (https://wicg.github.io/compute-pressure/)
 
+enum PressureState { "nominal", "fair", "serious", "critical" };
+
 callback ComputePressureUpdateCallback = undefined (
-  ComputePressureEntry update,
+  sequence<ComputePressureRecord> changes,
   ComputePressureObserver observer
 );
 
 enum ComputePressureTarget { "cpu" };
 
-[Exposed=Window]
+[Exposed=(DedicatedWorker,SharedWorker,Window), SecureContext]
 interface ComputePressureObserver {
   constructor(ComputePressureUpdateCallback callback);
+
   undefined observe(ComputePressureTarget target, optional ComputePressureObserverOptions options = {});
   undefined unobserve(ComputePressureTarget target);
   undefined disconnect();
-  sequence<ComputePressureEntry> takeRecords();
+  sequence<ComputePressureRecord> takeRecords();
+
   [SameObject] static readonly attribute FrozenArray<DOMString> supportedTargetTypes;
+
+  [Exposed=Window] static Promise<PermissionState> requestPermission();
 };
 
-dictionary ComputePressureEntry {
-  double cpuSpeed;
-  double cpuUtilization;
+dictionary ComputePressureRecord {
+  PressureState state;
   ComputePressureObserverOptions options;
 };
 
 dictionary ComputePressureObserverOptions {
-  sequence<double> cpuUtilizationThresholds = [];
-  sequence<double> cpuSpeedThresholds = [];
+  // For future-proofing - expect things to be added here later.
 };

package/css-contain-3.idl

@@ -0,0 +1,8 @@
+// GENERATED CONTENT - DO NOT EDIT
+// Content was automatically extracted by Reffy into webref
+// (https://github.com/w3c/webref)
+// Source: CSS Containment Module Level 3 (https://drafts.csswg.org/css-contain-3/)
+
+[Exposed=Window]
+interface CSSContainerRule : CSSConditionRule {
+};

package/html.idl

@@ -201,6 +201,7 @@ interface HTMLLinkElement : HTMLElement {
   [CEReactions] attribute USVString imageSrcset;
   [CEReactions] attribute DOMString imageSizes;
   [CEReactions] attribute DOMString referrerPolicy;
+  [SameObject, PutForwards=value] readonly attribute DOMTokenList blocking;
   [CEReactions] attribute boolean disabled;
 
   // also has obsolete members
@@ -224,6 +225,7 @@ interface HTMLStyleElement : HTMLElement {
   [HTMLConstructor] constructor();
 
   [CEReactions] attribute DOMString media;
+  [SameObject, PutForwards=value] readonly attribute DOMTokenList blocking;
 
   // also has obsolete members
 };
@@ -1221,6 +1223,7 @@ interface HTMLScriptElement : HTMLElement {
   [CEReactions] attribute DOMString text;
   [CEReactions] attribute DOMString integrity;
   [CEReactions] attribute DOMString referrerPolicy;
+  [SameObject, PutForwards=value] readonly attribute DOMTokenList blocking;
 
   static boolean supports(DOMString type);
 
@@ -1338,7 +1341,7 @@ interface mixin CanvasTransform {
 interface mixin CanvasCompositing {
   // compositing
   attribute unrestricted double globalAlpha; // (default 1.0)
-  attribute DOMString globalCompositeOperation; // (default source-over)
+  attribute DOMString globalCompositeOperation; // (default "source-over")
 };
 
 interface mixin CanvasImageSmoothing {
@@ -1477,7 +1480,7 @@ interface mixin CanvasPath {
   undefined bezierCurveTo(unrestricted double cp1x, unrestricted double cp1y, unrestricted double cp2x, unrestricted double cp2y, unrestricted double x, unrestricted double y);
   undefined arcTo(unrestricted double x1, unrestricted double y1, unrestricted double x2, unrestricted double y2, unrestricted double radius);
   undefined rect(unrestricted double x, unrestricted double y, unrestricted double w, unrestricted double h);
-  undefined roundRect(unrestricted double x, unrestricted double y, unrestricted double w, unrestricted double h, sequence<(unrestricted double or DOMPointInit)> radii);
+  undefined roundRect(unrestricted double x, unrestricted double y, unrestricted double w, unrestricted double h, optional (unrestricted double or DOMPointInit or sequence<(unrestricted double or DOMPointInit)>) radii = {});
   undefined arc(unrestricted double x, unrestricted double y, unrestricted double radius, unrestricted double startAngle, unrestricted double endAngle, optional boolean counterclockwise = false);
   undefined ellipse(unrestricted double x, unrestricted double y, unrestricted double radiusX, unrestricted double radiusY, unrestricted double rotation, unrestricted double startAngle, unrestricted double endAngle, optional boolean counterclockwise = false);
 };
@@ -2205,53 +2208,6 @@ dictionary EventSourceInit {
   boolean withCredentials = false;
 };
 
-enum BinaryType { "blob", "arraybuffer" };
-[Exposed=(Window,Worker)]
-interface WebSocket : EventTarget {
-  constructor(USVString url, optional (DOMString or sequence<DOMString>) protocols = []);
-
-  readonly attribute USVString url;
-
-  // ready state
-  const unsigned short CONNECTING = 0;
-  const unsigned short OPEN = 1;
-  const unsigned short CLOSING = 2;
-  const unsigned short CLOSED = 3;
-  readonly attribute unsigned short readyState;
-  readonly attribute unsigned long long bufferedAmount;
-
-  // networking
-  attribute EventHandler onopen;
-  attribute EventHandler onerror;
-  attribute EventHandler onclose;
-  readonly attribute DOMString extensions;
-  readonly attribute DOMString protocol;
-  undefined close(optional [Clamp] unsigned short code, optional USVString reason);
-
-  // messaging
-  attribute EventHandler onmessage;
-  attribute BinaryType binaryType;
-  undefined send(USVString data);
-  undefined send(Blob data);
-  undefined send(ArrayBuffer data);
-  undefined send(ArrayBufferView data);
-};
-
-[Exposed=(Window,Worker)]
-interface CloseEvent : Event {
-  constructor(DOMString type, optional CloseEventInit eventInitDict = {});
-
-  readonly attribute boolean wasClean;
-  readonly attribute unsigned short code;
-  readonly attribute USVString reason;
-};
-
-dictionary CloseEventInit : EventInit {
-  boolean wasClean = false;
-  unsigned short code = 0;
-  USVString reason = "";
-};
-
 [Exposed=(Window,Worker)]
 interface MessageChannel {
   constructor();

package/package.json

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

package/permissions.idl

@@ -19,13 +19,13 @@ interface Permissions {
 };
 
 dictionary PermissionDescriptor {
-  required PermissionName name;
+  required DOMString name;
 };
 
 [Exposed=(Window,Worker)]
 interface PermissionStatus : EventTarget {
   readonly attribute PermissionState state;
-  readonly attribute PermissionName name;
+  readonly attribute DOMString name;
   attribute EventHandler onchange;
 };
 
@@ -35,24 +35,8 @@ enum PermissionState {
   "prompt",
 };
 
-enum PermissionName {
-  "accelerometer",
-  "ambient-light-sensor",
-  "background-fetch",
-  "background-sync",
-  "bluetooth",
-  "camera",
-  "display-capture",
-  "geolocation",
-  "gyroscope",
-  "magnetometer",
-  "microphone",
-  "midi",
-  "nfc",
-  "notifications",
-  "persistent-storage",
-  "push",
-  "screen-wake-lock",
-  "speaker-selection",
-  "xr-spatial-tracking",
+dictionary PermissionSetParameters {
+  required PermissionDescriptor descriptor;
+  required PermissionState state;
+  boolean oneRealm = false;
 };

package/priority-hints.idl

@@ -3,28 +3,28 @@
 // (https://github.com/w3c/webref)
 // Source: Priority Hints (https://wicg.github.io/priority-hints/)
 
-enum Importance { "high", "low", "auto" };
+enum FetchPriority { "high", "low", "auto" };
 
 partial interface Request {
-  readonly attribute Importance importance;
+  readonly attribute FetchPriority priority;
 };
 
 partial dictionary RequestInit {
-  Importance importance;
+  FetchPriority priority;
 };
 
 partial interface HTMLImageElement {
-    [CEReactions] attribute DOMString importance;
+    [CEReactions] attribute DOMString fetchpriority;
 };
 
 partial interface HTMLLinkElement {
-    [CEReactions] attribute DOMString importance;
+    [CEReactions] attribute DOMString fetchpriority;
 };
 
 partial interface HTMLScriptElement {
-    [CEReactions] attribute DOMString importance;
+    [CEReactions] attribute DOMString fetchpriority;
 };
 
 partial interface HTMLIFrameElement {
-    [CEReactions] attribute DOMString importance;
+    [CEReactions] attribute DOMString fetchpriority;
 };

package/secure-payment-confirmation.idl

@@ -5,6 +5,7 @@
 
 dictionary SecurePaymentConfirmationRequest {
     required BufferSource challenge;
+    required USVString rpId;
     required FrozenArray<BufferSource> credentialIds;
     required PaymentCredentialInstrument instrument;
     unsigned long timeout;

package/webgpu.idl

@@ -355,6 +355,7 @@ enum GPUTextureFormat {
 
 [Exposed=(Window, DedicatedWorker), SecureContext]
 interface GPUExternalTexture {
+    readonly attribute boolean expired;
 };
 GPUExternalTexture includes GPUObjectBase;
 

package/webnn.idl

@@ -16,33 +16,20 @@ enum MLDevicePreference {
 };
 
 enum MLPowerPreference {
-  // Let the user agent select the most suitable behavior.
   "default",
-
-  // Prioritizes execution speed over power consumption.
   "high-performance",
-
-  // Prioritizes power consumption over other considerations such as execution speed.
   "low-power"
 };
 
 dictionary MLContextOptions {
-  // Preferred kind of device used
   MLDevicePreference devicePreference = "default";
-
-  // Preference as related to power consumption
   MLPowerPreference powerPreference = "default";
 };
 
 [SecureContext, Exposed=(Window, DedicatedWorker)]
 interface ML {
-  // Create a context with options
   MLContext createContext(optional MLContextOptions options = {});
-
-  // Create a context from WebGL rendering context
   MLContext createContext(WebGLRenderingContext glContext);
-
-  // Create a context from WebGPU device
   MLContext createContext(GPUDevice gpuDevice);
 };
 

package/websockets.idl

@@ -0,0 +1,48 @@
+// GENERATED CONTENT - DO NOT EDIT
+// Content was automatically extracted by Reffy into webref
+// (https://github.com/w3c/webref)
+// Source: WebSockets Standard (https://websockets.spec.whatwg.org/)
+
+enum BinaryType { "blob", "arraybuffer" };
+
+[Exposed=(Window,Worker)]
+interface WebSocket : EventTarget {
+  constructor(USVString url, optional (DOMString or sequence<DOMString>) protocols = []);
+  readonly attribute USVString url;
+
+  // ready state
+  const unsigned short CONNECTING = 0;
+  const unsigned short OPEN = 1;
+  const unsigned short CLOSING = 2;
+  const unsigned short CLOSED = 3;
+  readonly attribute unsigned short readyState;
+  readonly attribute unsigned long long bufferedAmount;
+
+  // networking
+  attribute EventHandler onopen;
+  attribute EventHandler onerror;
+  attribute EventHandler onclose;
+  readonly attribute DOMString extensions;
+  readonly attribute DOMString protocol;
+  undefined close(optional [Clamp] unsigned short code, optional USVString reason);
+
+  // messaging
+  attribute EventHandler onmessage;
+  attribute BinaryType binaryType;
+  undefined send((BufferSource or Blob or USVString) data);
+};
+
+[Exposed=(Window,Worker)]
+interface CloseEvent : Event {
+  constructor(DOMString type, optional CloseEventInit eventInitDict = {});
+
+  readonly attribute boolean wasClean;
+  readonly attribute unsigned short code;
+  readonly attribute USVString reason;
+};
+
+dictionary CloseEventInit : EventInit {
+  boolean wasClean = false;
+  unsigned short code = 0;
+  USVString reason = "";
+};

package/webtransport.idl

@@ -54,6 +54,7 @@ dictionary WebTransportStats {
   DOMHighResTimeStamp timestamp;
   unsigned long long bytesSent;
   unsigned long long packetsSent;
+  unsigned long long packetsLost;
   unsigned long numOutgoingStreamsCreated;
   unsigned long numIncomingStreamsCreated;
   unsigned long long bytesReceived;

package/webusb.idl

@@ -47,68 +47,12 @@ interface USBConnectionEvent : Event {
   [SameObject] readonly attribute USBDevice device;
 };
 
-[Exposed=(DedicatedWorker,SharedWorker,Window), SecureContext]
-interface USBDevice {
-  readonly attribute octet usbVersionMajor;
-  readonly attribute octet usbVersionMinor;
-  readonly attribute octet usbVersionSubminor;
-  readonly attribute octet deviceClass;
-  readonly attribute octet deviceSubclass;
-  readonly attribute octet deviceProtocol;
-  readonly attribute unsigned short vendorId;
-  readonly attribute unsigned short productId;
-  readonly attribute octet deviceVersionMajor;
-  readonly attribute octet deviceVersionMinor;
-  readonly attribute octet deviceVersionSubminor;
-  readonly attribute DOMString? manufacturerName;
-  readonly attribute DOMString? productName;
-  readonly attribute DOMString? serialNumber;
-  readonly attribute USBConfiguration? configuration;
-  readonly attribute FrozenArray<USBConfiguration> configurations;
-  readonly attribute boolean opened;
-  Promise<undefined> open();
-  Promise<undefined> close();
-  Promise<undefined> selectConfiguration(octet configurationValue);
-  Promise<undefined> claimInterface(octet interfaceNumber);
-  Promise<undefined> releaseInterface(octet interfaceNumber);
-  Promise<undefined> selectAlternateInterface(octet interfaceNumber, octet alternateSetting);
-  Promise<USBInTransferResult> controlTransferIn(USBControlTransferParameters setup, unsigned short length);
-  Promise<USBOutTransferResult> controlTransferOut(USBControlTransferParameters setup, optional BufferSource data);
-  Promise<undefined> clearHalt(USBDirection direction, octet endpointNumber);
-  Promise<USBInTransferResult> transferIn(octet endpointNumber, unsigned long length);
-  Promise<USBOutTransferResult> transferOut(octet endpointNumber, BufferSource data);
-  Promise<USBIsochronousInTransferResult> isochronousTransferIn(octet endpointNumber, sequence<unsigned long> packetLengths);
-  Promise<USBIsochronousOutTransferResult> isochronousTransferOut(octet endpointNumber, BufferSource data, sequence<unsigned long> packetLengths);
-  Promise<undefined> reset();
-};
-
-enum USBRequestType {
-  "standard",
-  "class",
-  "vendor"
-};
-
-enum USBRecipient {
-  "device",
-  "interface",
-  "endpoint",
-  "other"
-};
-
 enum USBTransferStatus {
   "ok",
   "stall",
   "babble"
 };
 
-dictionary USBControlTransferParameters {
-  required USBRequestType requestType;
-  required USBRecipient recipient;
-  required octet request;
-  required unsigned short value;
-  required unsigned short index;
-};
-
 [
   Exposed=(DedicatedWorker,SharedWorker,Window),
   SecureContext
@@ -168,6 +112,63 @@ interface USBIsochronousOutTransferResult {
   readonly attribute FrozenArray<USBIsochronousOutTransferPacket> packets;
 };
 
+[Exposed=(DedicatedWorker,SharedWorker,Window), SecureContext]
+interface USBDevice {
+  readonly attribute octet usbVersionMajor;
+  readonly attribute octet usbVersionMinor;
+  readonly attribute octet usbVersionSubminor;
+  readonly attribute octet deviceClass;
+  readonly attribute octet deviceSubclass;
+  readonly attribute octet deviceProtocol;
+  readonly attribute unsigned short vendorId;
+  readonly attribute unsigned short productId;
+  readonly attribute octet deviceVersionMajor;
+  readonly attribute octet deviceVersionMinor;
+  readonly attribute octet deviceVersionSubminor;
+  readonly attribute DOMString? manufacturerName;
+  readonly attribute DOMString? productName;
+  readonly attribute DOMString? serialNumber;
+  readonly attribute USBConfiguration? configuration;
+  readonly attribute FrozenArray<USBConfiguration> configurations;
+  readonly attribute boolean opened;
+  Promise<undefined> open();
+  Promise<undefined> close();
+  Promise<undefined> forget();
+  Promise<undefined> selectConfiguration(octet configurationValue);
+  Promise<undefined> claimInterface(octet interfaceNumber);
+  Promise<undefined> releaseInterface(octet interfaceNumber);
+  Promise<undefined> selectAlternateInterface(octet interfaceNumber, octet alternateSetting);
+  Promise<USBInTransferResult> controlTransferIn(USBControlTransferParameters setup, unsigned short length);
+  Promise<USBOutTransferResult> controlTransferOut(USBControlTransferParameters setup, optional BufferSource data);
+  Promise<undefined> clearHalt(USBDirection direction, octet endpointNumber);
+  Promise<USBInTransferResult> transferIn(octet endpointNumber, unsigned long length);
+  Promise<USBOutTransferResult> transferOut(octet endpointNumber, BufferSource data);
+  Promise<USBIsochronousInTransferResult> isochronousTransferIn(octet endpointNumber, sequence<unsigned long> packetLengths);
+  Promise<USBIsochronousOutTransferResult> isochronousTransferOut(octet endpointNumber, BufferSource data, sequence<unsigned long> packetLengths);
+  Promise<undefined> reset();
+};
+
+enum USBRequestType {
+  "standard",
+  "class",
+  "vendor"
+};
+
+enum USBRecipient {
+  "device",
+  "interface",
+  "endpoint",
+  "other"
+};
+
+dictionary USBControlTransferParameters {
+  required USBRequestType requestType;
+  required USBRecipient recipient;
+  required octet request;
+  required unsigned short value;
+  required unsigned short index;
+};
+
 [
   Exposed=(DedicatedWorker,SharedWorker,Window),
   SecureContext