@webref/idl 3.45.2 → 3.45.3

package/compute-pressure.idl

@@ -33,5 +33,5 @@ interface PressureRecord {
 };
 
 dictionary PressureObserverOptions {
-  double sampleRate = 1.0;
+  [EnforceRange] unsigned long sampleInterval = 0;
 };

package/css-animations.idl

@@ -24,7 +24,7 @@ partial interface CSSRule {
 [Exposed=Window]
 interface CSSKeyframeRule : CSSRule {
   attribute CSSOMString keyText;
-  [SameObject, PutForwards=cssText] readonly attribute CSSStyleDeclaration style;
+  [SameObject, PutForwards=cssText] readonly attribute CSSStyleProperties style;
 };
 
 [Exposed=Window]

package/css-fonts.idl

@@ -3,9 +3,42 @@
 // (https://github.com/w3c/webref)
 // Source: CSS Fonts Module Level 4 (https://drafts.csswg.org/css-fonts-4/)
 
+[Exposed=Window]
+interface CSSFontFaceDescriptors : CSSStyleDeclaration {
+  attribute [LegacyNullToEmptyString] CSSOMString src;
+  attribute [LegacyNullToEmptyString] CSSOMString fontFamily;
+  attribute [LegacyNullToEmptyString] CSSOMString font-family;
+  attribute [LegacyNullToEmptyString] CSSOMString fontStyle;
+  attribute [LegacyNullToEmptyString] CSSOMString font-style;
+  attribute [LegacyNullToEmptyString] CSSOMString fontWeight;
+  attribute [LegacyNullToEmptyString] CSSOMString font-weight;
+  attribute [LegacyNullToEmptyString] CSSOMString fontStretch;
+  attribute [LegacyNullToEmptyString] CSSOMString font-stretch;
+  attribute [LegacyNullToEmptyString] CSSOMString fontWidth;
+  attribute [LegacyNullToEmptyString] CSSOMString font-width;
+  attribute [LegacyNullToEmptyString] CSSOMString unicodeRange;
+  attribute [LegacyNullToEmptyString] CSSOMString unicode-range;
+  attribute [LegacyNullToEmptyString] CSSOMString fontFeatureSettings;
+  attribute [LegacyNullToEmptyString] CSSOMString font-feature-settings;
+  attribute [LegacyNullToEmptyString] CSSOMString fontVariationSettings;
+  attribute [LegacyNullToEmptyString] CSSOMString font-variation-settings;
+  attribute [LegacyNullToEmptyString] CSSOMString fontNamedInstance;
+  attribute [LegacyNullToEmptyString] CSSOMString font-named-instance;
+  attribute [LegacyNullToEmptyString] CSSOMString fontDisplay;
+  attribute [LegacyNullToEmptyString] CSSOMString font-display;
+  attribute [LegacyNullToEmptyString] CSSOMString fontLanguageOverride;
+  attribute [LegacyNullToEmptyString] CSSOMString font-language-override;
+  attribute [LegacyNullToEmptyString] CSSOMString ascentOverride;
+  attribute [LegacyNullToEmptyString] CSSOMString ascent-override;
+  attribute [LegacyNullToEmptyString] CSSOMString descentOverride;
+  attribute [LegacyNullToEmptyString] CSSOMString descent-override;
+  attribute [LegacyNullToEmptyString] CSSOMString lineGapOverride;
+  attribute [LegacyNullToEmptyString] CSSOMString line-gap-override;
+};
+
 [Exposed=Window]
 interface CSSFontFaceRule : CSSRule {
-  readonly attribute CSSStyleDeclaration style;
+  readonly attribute CSSFontFaceDescriptors style;
 };
 
 partial interface CSSRule {  const unsigned short FONT_FEATURE_VALUES_RULE = 14;

package/css-scroll-snap-2.idl

@@ -3,31 +3,14 @@
 // (https://github.com/w3c/webref)
 // Source: CSS Scroll Snap Module Level 2 (https://drafts.csswg.org/css-scroll-snap-2/)
 
-[Exposed=Window]
-interface SnapEvent : Event {
-  constructor(DOMString type, optional SnapEventInit eventInitDict = {});
-  readonly attribute EventTarget? target;
-  readonly attribute SnapTargetList snappedTargets;
-  readonly attribute SnapTargetList snapTargets;
-  readonly attribute boolean invokedProgrammatically;
-  readonly attribute boolean smoothlyScrolled;
-};
-
-[Exposed=Window]
-interface SnapTargetList {
-    readonly attribute SnapTargetArray x;
-    readonly attribute SnapTargetArray y;
+dictionary SnapEventInit : EventInit {
+  Node? snapTargetBlock;
+  Node? snapTargetInline;
 };
 
 [Exposed=Window]
-interface SnapTargetArray {
-    readonly attribute unsigned long length;
-    getter EventTarget? item (unsigned long index);
-};
-
-dictionary SnapEventInit : EventModifierInit {
-    sequence<EventTarget> snappedTargetsX = [];
-    sequence<EventTarget> snappedTargetsY = [];
-    sequence<EventTarget> snapTargetsListX = [];
-    sequence<EventTarget> snapTargetsListY = [];
+interface SnapEvent : Event {
+  constructor(DOMString type, optional SnapEventInit eventInitDict = {});
+  readonly attribute Node? snapTargetBlock;
+  readonly attribute Node? snapTargetInline;
 };

package/css-view-transitions-2.idl

@@ -3,27 +3,39 @@
 // (https://github.com/w3c/webref)
 // Source: CSS View Transitions Module Level 2 (https://drafts.csswg.org/css-view-transitions-2/)
 
-dictionary StartViewTransitionOptions {
-  UpdateCallback? update = null;
-  sequence<DOMString>? type = null;
+partial interface CSSRule {
+  const unsigned short VIEW_TRANSITION_RULE = 15;
 };
 
-partial interface Document {
+enum ViewTransitionNavigation { "auto", "none" };
 
-  ViewTransition startViewTransition(optional (UpdateCallback or StartViewTransitionOptions) callbackOptions = {});
+[Exposed=Window]
+interface CSSViewTransitionTypeSet {
+  readonly setlike<CSSOMString>;
 };
 
-partial interface CSSRule {
-  const unsigned short VIEW_TRANSITION_RULE = 15;
+[Exposed=Window]
+interface CSSViewTransitionRule : CSSRule {
+  readonly attribute ViewTransitionNavigation navigation;
+  readonly attribute CSSViewTransitionTypeSet types;
 };
 
-enum ViewTransitionNavigation { "auto", "none" };
 [Exposed=Window]
-interface CSSViewTransitionRule : CSSRule {
-  attribute ViewTransitionNavigation navigation;
-  attribute DOMTokenList typeList;
+interface ViewTransitionTypeSet {
+  setlike<DOMString>;
 };
 
+[Exposed=Window]
 partial interface ViewTransition {
-  readonly attribute DOMTokenList typeList;
+  attribute ViewTransitionTypeSet types;
+};
+
+dictionary StartViewTransitionOptions {
+  UpdateCallback? update = null;
+  sequence<DOMString>? types = null;
+};
+
+partial interface Document {
+
+  ViewTransition startViewTransition(optional (UpdateCallback or StartViewTransitionOptions) callbackOptions = {});
 };

package/cssom-view.idl

@@ -130,6 +130,7 @@ partial interface Element {
   readonly attribute long clientLeft;
   readonly attribute long clientWidth;
   readonly attribute long clientHeight;
+  readonly attribute double currentCSSZoom;
 };
 
 partial interface HTMLElement {

package/cssom.idl

@@ -91,7 +91,7 @@ interface CSSRule {
 [Exposed=Window]
 interface CSSStyleRule : CSSGroupingRule {
   attribute CSSOMString selectorText;
-  [SameObject, PutForwards=cssText] readonly attribute CSSStyleDeclaration style;
+  [SameObject, PutForwards=cssText] readonly attribute CSSStyleProperties style;
 };
 
 [Exposed=Window]
@@ -110,10 +110,26 @@ interface CSSGroupingRule : CSSRule {
   undefined deleteRule(unsigned long index);
 };
 
+[Exposed=Window]
+interface CSSPageDescriptors : CSSStyleDeclaration {
+  attribute [LegacyNullToEmptyString] CSSOMString margin;
+  attribute [LegacyNullToEmptyString] CSSOMString marginTop;
+  attribute [LegacyNullToEmptyString] CSSOMString marginRight;
+  attribute [LegacyNullToEmptyString] CSSOMString marginBottom;
+  attribute [LegacyNullToEmptyString] CSSOMString marginLeft;
+  attribute [LegacyNullToEmptyString] CSSOMString margin-top;
+  attribute [LegacyNullToEmptyString] CSSOMString margin-right;
+  attribute [LegacyNullToEmptyString] CSSOMString margin-bottom;
+  attribute [LegacyNullToEmptyString] CSSOMString margin-left;
+  attribute [LegacyNullToEmptyString] CSSOMString size;
+  attribute [LegacyNullToEmptyString] CSSOMString marks;
+  attribute [LegacyNullToEmptyString] CSSOMString bleed;
+};
+
 [Exposed=Window]
 interface CSSPageRule : CSSGroupingRule {
            attribute CSSOMString selectorText;
-  [SameObject, PutForwards=cssText] readonly attribute CSSStyleDeclaration style;
+  [SameObject, PutForwards=cssText] readonly attribute CSSPageDescriptors style;
 };
 
 [Exposed=Window]
@@ -138,6 +154,10 @@ interface CSSStyleDeclaration {
   [CEReactions] undefined setProperty(CSSOMString property, [LegacyNullToEmptyString] CSSOMString value, optional [LegacyNullToEmptyString] CSSOMString priority = "");
   [CEReactions] CSSOMString removeProperty(CSSOMString property);
   readonly attribute CSSRule? parentRule;
+};
+
+[Exposed=Window]
+interface CSSStyleProperties : CSSStyleDeclaration {
   [CEReactions] attribute [LegacyNullToEmptyString] CSSOMString cssFloat;
 };
 

package/html.idl

@@ -48,7 +48,7 @@ typedef (HTMLScriptElement or SVGScriptElement) HTMLOrSVGScriptElement;
 
 [LegacyOverrideBuiltIns]
 partial interface Document {
-  static Document parseHTMLUnsafe(DOMString html);
+  static Document parseHTMLUnsafe(HTMLString html);
 
   // resource metadata management
   [PutForwards=href, LegacyUnforgeable] readonly attribute Location? location;
@@ -77,8 +77,8 @@ partial interface Document {
   [CEReactions] Document open(optional DOMString unused1, optional DOMString unused2); // both arguments are ignored
   WindowProxy? open(USVString url, DOMString name, DOMString features);
   [CEReactions] undefined close();
-  [CEReactions] undefined write(DOMString... text);
-  [CEReactions] undefined writeln(DOMString... text);
+  [CEReactions] undefined write(HTMLString... text);
+  [CEReactions] undefined writeln(HTMLString... text);
 
   // user interaction
   readonly attribute WindowProxy? defaultView;
@@ -452,7 +452,7 @@ interface HTMLIFrameElement : HTMLElement {
   [HTMLConstructor] constructor();
 
   [CEReactions] attribute USVString src;
-  [CEReactions] attribute DOMString srcdoc;
+  [CEReactions] attribute HTMLString srcdoc;
   [CEReactions] attribute DOMString name;
   [SameObject, PutForwards=value] readonly attribute DOMTokenList sandbox;
   [CEReactions] attribute DOMString allow;
@@ -2296,7 +2296,7 @@ WorkerGlobalScope includes WindowOrWorkerGlobalScope;
 interface DOMParser {
   constructor();
 
-  [NewObject] Document parseFromString(DOMString string, DOMParserSupportedType type);
+  [NewObject] Document parseFromString(HTMLString string, DOMParserSupportedType type);
 };
 
 enum DOMParserSupportedType {
@@ -2308,11 +2308,11 @@ enum DOMParserSupportedType {
 };
 
 partial interface Element {
-  [CEReactions] undefined setHTMLUnsafe(DOMString html);
+  [CEReactions] undefined setHTMLUnsafe(HTMLString html);
 };
 
 partial interface ShadowRoot {
-  [CEReactions] undefined setHTMLUnsafe(DOMString html);
+  [CEReactions] undefined setHTMLUnsafe(HTMLString html);
 };
 
 [Exposed=Window]
@@ -2527,7 +2527,7 @@ interface WorkerGlobalScope : EventTarget {
   readonly attribute WorkerGlobalScope self;
   readonly attribute WorkerLocation location;
   readonly attribute WorkerNavigator navigator;
-  undefined importScripts(USVString... urls);
+  undefined importScripts(ScriptURLString... urls);
 
   attribute OnErrorEventHandler onerror;
   attribute EventHandler onlanguagechange;
@@ -2565,7 +2565,7 @@ interface mixin AbstractWorker {
 
 [Exposed=(Window,DedicatedWorker,SharedWorker)]
 interface Worker : EventTarget {
-  constructor(USVString scriptURL, optional WorkerOptions options = {});
+  constructor(ScriptURLString scriptURL, optional WorkerOptions options = {});
 
   undefined terminate();
 
@@ -2587,7 +2587,7 @@ Worker includes AbstractWorker;
 
 [Exposed=Window]
 interface SharedWorker : EventTarget {
-  constructor(USVString scriptURL, optional (DOMString or WorkerOptions) options = {});
+  constructor(ScriptURLString scriptURL, optional (DOMString or WorkerOptions) options = {});
 
   readonly attribute MessagePort port;
 };

package/media-source.idl

@@ -18,23 +18,25 @@ enum EndOfStreamError {
 interface MediaSource : EventTarget {
     constructor();
 
-    [ SameObject, Exposed=DedicatedWorker ]
-    readonly              attribute MediaSourceHandle   handle;
-
-    readonly              attribute SourceBufferList    sourceBuffers;
-    readonly              attribute SourceBufferList    activeSourceBuffers;
-    readonly              attribute ReadyState          readyState;
-                          attribute unrestricted double duration;
-                          attribute EventHandler        onsourceopen;
-                          attribute EventHandler        onsourceended;
-                          attribute EventHandler        onsourceclose;
-    static readonly       attribute boolean canConstructInDedicatedWorker;
-    SourceBuffer          addSourceBuffer (DOMString type);
-    undefined             removeSourceBuffer (SourceBuffer sourceBuffer);
-    undefined             endOfStream (optional EndOfStreamError error);
-    undefined             setLiveSeekableRange (double start, double end);
-    undefined             clearLiveSeekableRange ();
-    static boolean        isTypeSupported (DOMString type);
+    [SameObject, Exposed=DedicatedWorker]
+    readonly  attribute MediaSourceHandle handle;
+    readonly  attribute SourceBufferList sourceBuffers;
+    readonly  attribute SourceBufferList activeSourceBuffers;
+    readonly  attribute ReadyState readyState;
+
+    attribute unrestricted double duration;
+    attribute EventHandler onsourceopen;
+    attribute EventHandler onsourceended;
+    attribute EventHandler onsourceclose;
+
+    static readonly attribute boolean canConstructInDedicatedWorker;
+
+    SourceBuffer addSourceBuffer(DOMString type);
+    undefined removeSourceBuffer(SourceBuffer sourceBuffer);
+    undefined endOfStream(optional EndOfStreamError error);
+    undefined setLiveSeekableRange(double start, double end);
+    undefined clearLiveSeekableRange();
+    static boolean isTypeSupported(DOMString type);
 };
 
 [Transferable, Exposed=(Window,DedicatedWorker)]
@@ -47,32 +49,36 @@ enum AppendMode {
 
 [Exposed=(Window,DedicatedWorker)]
 interface SourceBuffer : EventTarget {
-                    attribute AppendMode          mode;
-    readonly        attribute boolean             updating;
-    readonly        attribute TimeRanges          buffered;
-                    attribute double              timestampOffset;
-    readonly        attribute AudioTrackList      audioTracks;
-    readonly        attribute VideoTrackList      videoTracks;
-    readonly        attribute TextTrackList       textTracks;
-                    attribute double              appendWindowStart;
-                    attribute unrestricted double appendWindowEnd;
-                    attribute EventHandler        onupdatestart;
-                    attribute EventHandler        onupdate;
-                    attribute EventHandler        onupdateend;
-                    attribute EventHandler        onerror;
-                    attribute EventHandler        onabort;
-    undefined appendBuffer (BufferSource data);
-    undefined abort ();
-    undefined changeType (DOMString type);
-    undefined remove (double start, unrestricted double end);
+  attribute AppendMode mode;
+  readonly  attribute boolean updating;
+  readonly  attribute TimeRanges buffered;
+  attribute double timestampOffset;
+  readonly  attribute AudioTrackList audioTracks;
+  readonly  attribute VideoTrackList videoTracks;
+  readonly  attribute TextTrackList textTracks;
+  attribute double appendWindowStart;
+  attribute unrestricted double appendWindowEnd;
+
+  attribute EventHandler onupdatestart;
+  attribute EventHandler onupdate;
+  attribute EventHandler onupdateend;
+  attribute EventHandler onerror;
+  attribute EventHandler onabort;
+
+  undefined appendBuffer(BufferSource data);
+  undefined abort();
+  undefined changeType(DOMString type);
+  undefined remove(double start, unrestricted double end);
 };
 
 [Exposed=(Window,DedicatedWorker)]
 interface SourceBufferList : EventTarget {
-    readonly        attribute unsigned long length;
-                    attribute EventHandler  onaddsourcebuffer;
-                    attribute EventHandler  onremovesourcebuffer;
-    getter SourceBuffer (unsigned long index);
+  readonly attribute unsigned long length;
+
+  attribute EventHandler onaddsourcebuffer;
+  attribute EventHandler onremovesourcebuffer;
+
+  getter SourceBuffer (unsigned long index);
 };
 
 [Exposed=(Window,DedicatedWorker)]
@@ -103,15 +109,15 @@ interface ManagedSourceBuffer : SourceBuffer {
 
 [Exposed=(Window,DedicatedWorker)]
 partial interface AudioTrack {
-    readonly        attribute SourceBuffer? sourceBuffer;
+  readonly attribute SourceBuffer? sourceBuffer;
 };
 
 [Exposed=(Window,DedicatedWorker)]
 partial interface VideoTrack {
-    readonly        attribute SourceBuffer? sourceBuffer;
+  readonly attribute SourceBuffer? sourceBuffer;
 };
 
 [Exposed=(Window,DedicatedWorker)]
 partial interface TextTrack {
-    readonly        attribute SourceBuffer? sourceBuffer;
+  readonly attribute SourceBuffer? sourceBuffer;
 };

package/package.json

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

package/sanitizer-api.idl

@@ -3,36 +3,49 @@
 // (https://github.com/w3c/webref)
 // Source: HTML Sanitizer API (https://wicg.github.io/sanitizer-api/)
 
-[
-  Exposed=(Window),
-  SecureContext
-] interface Sanitizer {
-  constructor(optional SanitizerConfig config = {});
+partial interface Element {
+  [CEReactions] undefined setHTMLUnsafe__TO_BE_MERGED(DOMString html, optional SanitizerConfig config = {});
+  [CEReactions] undefined setHTML(DOMString html, optional SanitizerConfig config = {});
+};
 
-  DocumentFragment sanitize((Document or DocumentFragment) input);
-  Element? sanitizeFor(DOMString element, DOMString input);
+partial interface ShadowRoot {
+  [CEReactions] undefined setHTMLUnsafe__TO_BE_MERGED(DOMString html, optional SanitizerConfig config = {});
+  [CEReactions] undefined setHTML(DOMString html, optional SanitizerConfig config = {});
+};
 
-  SanitizerConfig getConfiguration();
-  static SanitizerConfig getDefaultConfiguration();
+partial interface Document {
+  static Document parseHTMLUnsafe__TO_BE_MERGED(DOMString html, optional SanitizerConfig config = {});
+  static Document parseHTML(DOMString html, optional SanitizerConfig config = {});
 };
 
-dictionary SetHTMLOptions {
-  Sanitizer sanitizer;
+dictionary SanitizerElementNamespace {
+  required DOMString name;
+  DOMString? _namespace = "http://www.w3.org/1999/xhtml";
 };
-[SecureContext]
-partial interface Element {
-  undefined setHTML(DOMString input, optional SetHTMLOptions options = {});
+
+// Used by "elements"
+dictionary SanitizerElementNamespaceWithAttributes : SanitizerElementNamespace {
+  sequence<SanitizerAttribute> attributes;
+  sequence<SanitizerAttribute> removeAttributes;
 };
 
-dictionary SanitizerConfig {
-  sequence<DOMString> allowElements;
-  sequence<DOMString> blockElements;
-  sequence<DOMString> dropElements;
-  AttributeMatchList allowAttributes;
-  AttributeMatchList dropAttributes;
-  boolean allowCustomElements;
-  boolean allowUnknownMarkup;
-  boolean allowComments;
+typedef (DOMString or SanitizerElementNamespace) SanitizerElement;
+typedef (DOMString or SanitizerElementNamespaceWithAttributes) SanitizerElementWithAttributes;
+
+dictionary SanitizerAttributeNamespace {
+  required DOMString name;
+  DOMString? _namespace = null;
 };
+typedef (DOMString or SanitizerAttributeNamespace) SanitizerAttribute;
+
+dictionary SanitizerConfig {
+  sequence<SanitizerElementWithAttributes> elements;
+  sequence<SanitizerElement> removeElements;
+  sequence<SanitizerElement> replaceWithChildrenElements;
 
-typedef record<DOMString, sequence<DOMString>> AttributeMatchList;
+  sequence<SanitizerAttribute> attributes;
+  sequence<SanitizerAttribute> removeAttributes;
+
+  boolean comments;
+  boolean dataAttributes;
+};

package/url.idl

@@ -8,6 +8,7 @@
 interface URL {
   constructor(USVString url, optional USVString base);
 
+  static URL? parse(USVString url, optional USVString base);
   static boolean canParse(USVString url, optional USVString base);
 
   stringifier attribute USVString href;

package/webcodecs-opus-codec-registration.idl

@@ -9,6 +9,8 @@ partial dictionary AudioEncoderConfig {
 
 dictionary OpusEncoderConfig {
   OpusBitstreamFormat format = "opus";
+  OpusSignal signal = "auto";
+  OpusApplication application = "audio";
   [EnforceRange] unsigned long long frameDuration = 20000;
   [EnforceRange] unsigned long complexity;
   [EnforceRange] unsigned long packetlossperc = 0;
@@ -20,3 +22,15 @@ enum OpusBitstreamFormat {
   "opus",
   "ogg",
 };
+
+enum OpusSignal {
+  "auto",
+  "music",
+  "voice",
+};
+
+enum OpusApplication {
+  "voip",
+  "audio",
+  "lowdelay",
+};

package/webcodecs.idl

@@ -158,8 +158,8 @@ dictionary VideoDecoderConfig {
 
 dictionary AudioEncoderConfig {
   required DOMString codec;
-  [EnforceRange] unsigned long sampleRate;
-  [EnforceRange] unsigned long numberOfChannels;
+  [EnforceRange] required unsigned long sampleRate;
+  [EnforceRange] required unsigned long numberOfChannels;
   [EnforceRange] unsigned long long bitrate;
   BitrateMode bitrateMode = "variable";
 };