diff --git a/baselines/audioworklet.generated.d.ts b/baselines/audioworklet.generated.d.ts index dc7ea4402..840aea7b3 100644 --- a/baselines/audioworklet.generated.d.ts +++ b/baselines/audioworklet.generated.d.ts @@ -962,6 +962,12 @@ declare var ReadableStream: { new(underlyingSource: UnderlyingByteSource, strategy?: { highWaterMark?: number }): ReadableStream>; new(underlyingSource: UnderlyingDefaultSource, strategy?: QueuingStrategy): ReadableStream; new(underlyingSource?: UnderlyingSource, strategy?: QueuingStrategy): ReadableStream; + /** + * The **`ReadableStream.from()`** static method returns a ReadableStream from a provided iterable or async iterable object. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStream/from_static) + */ + from(asyncIterable: never): ReadableStream; }; /** @@ -990,7 +996,7 @@ declare var ReadableStreamBYOBReader: { }; /** - * The **`ReadableStreamBYOBRequest`** interface of the Streams API represents a "pull request" for data from an underlying source that will made as a zero-copy transfer to a consumer (bypassing the stream's internal queues). + * The **`ReadableStreamBYOBRequest`** interface of the Streams API represents a "pull request" for data from an underlying source that will be made as a zero-copy transfer to a consumer (bypassing the stream's internal queues). * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStreamBYOBRequest) */ @@ -1569,25 +1575,25 @@ declare namespace WebAssembly { }; /** - * The **`WebAssembly.Exception`** object represents a runtime exception thrown from WebAssembly to JavaScript, or thrown from JavaScript to a WebAssembly exception handler. + * The **`WebAssembly.Exception`** object represents a runtime exception thrown in a Wasm module. * * [MDN Reference](https://developer.mozilla.org/docs/WebAssembly/Reference/JavaScript_interface/Exception) */ interface Exception { /** - * The read-only **`stack`** property of an object instance of type WebAssembly.Exception may contain a stack trace. + * The **`stack`** read-only property of the WebAssembly.Exception object may contain a stack trace. * * [MDN Reference](https://developer.mozilla.org/docs/WebAssembly/Reference/JavaScript_interface/Exception/stack) */ readonly stack: string | undefined; /** - * The **`getArg()`** prototype method of the Exception object can be used to get the value of a specified item in the exception's data arguments. + * The **`getArg()`** method of the Exception object can be used to get the value of a specified item in the exception's data arguments. * * [MDN Reference](https://developer.mozilla.org/docs/WebAssembly/Reference/JavaScript_interface/Exception/getArg) */ getArg(exceptionTag: Tag, index: number): any; /** - * The **`is()`** prototype method of the Exception object can be used to test if the Exception matches a given tag. + * The **`is()`** method of the Exception object can be used to test if the Exception matches a given tag. * * [MDN Reference](https://developer.mozilla.org/docs/WebAssembly/Reference/JavaScript_interface/Exception/is) */ @@ -1755,7 +1761,7 @@ declare namespace WebAssembly { }; /** - * The **`WebAssembly.Tag`** object defines a type of a WebAssembly exception that can be thrown to/from WebAssembly code. + * The **`WebAssembly.Tag`** object represents a WebAssembly exception type that can be thrown in a Wasm module. * * [MDN Reference](https://developer.mozilla.org/docs/WebAssembly/Reference/JavaScript_interface/Tag) */ diff --git a/baselines/dom.generated.d.ts b/baselines/dom.generated.d.ts index dfcfcd2cf..87c46b833 100644 --- a/baselines/dom.generated.d.ts +++ b/baselines/dom.generated.d.ts @@ -336,6 +336,11 @@ interface BlobPropertyBag { type?: string; } +interface CSSContainerCondition { + name: string; + query: string; +} + interface CSSMatrixComponentOptions { is2D?: boolean; } @@ -623,6 +628,7 @@ interface DeviceOrientationEventInit extends EventInit { interface DisplayMediaStreamOptions { audio?: boolean | MediaTrackConstraints; + audioSelection?: AudioSelectionPreferenceEnum; video?: boolean | MediaTrackConstraints; } @@ -1264,6 +1270,12 @@ interface IDBDatabaseInfo { version?: number; } +interface IDBGetAllOptions { + count?: number; + direction?: IDBCursorDirection; + query?: any; +} + interface IDBIndexParameters { multiEntry?: boolean; unique?: boolean; @@ -1570,6 +1582,7 @@ interface MediaStreamConstraints { audio?: boolean | MediaTrackConstraints; peerIdentity?: string; preferCurrentTab?: boolean; + semantics?: GetUserMediaSemantics; video?: boolean | MediaTrackConstraints; } @@ -1581,17 +1594,25 @@ interface MediaTrackCapabilities { aspectRatio?: DoubleRange; autoGainControl?: boolean[]; backgroundBlur?: boolean[]; + backgroundSegmentationMask?: boolean[]; channelCount?: ULongRange; deviceId?: string; displaySurface?: string; echoCancellation?: (boolean | string)[]; + eyeGazeCorrection?: boolean[]; + faceFraming?: boolean[]; facingMode?: string[]; frameRate?: DoubleRange; + gestureReactions?: boolean[]; groupId?: string; height?: ULongRange; + humanFaceDetectionMode?: string[]; noiseSuppression?: boolean[]; + powerEfficient?: boolean[]; + powerEfficientPixelFormat?: boolean[]; sampleRate?: ULongRange; sampleSize?: ULongRange; + voiceIsolation?: boolean[]; width?: ULongRange; } @@ -1599,17 +1620,23 @@ interface MediaTrackConstraintSet { aspectRatio?: ConstrainDouble; autoGainControl?: ConstrainBoolean; backgroundBlur?: ConstrainBoolean; + backgroundSegmentationMask?: ConstrainBoolean; channelCount?: ConstrainULong; deviceId?: ConstrainDOMString; displaySurface?: ConstrainDOMString; echoCancellation?: ConstrainBooleanOrDOMString; + eyeGazeCorrection?: ConstrainBoolean; + faceFraming?: ConstrainBoolean; facingMode?: ConstrainDOMString; frameRate?: ConstrainDouble; + gestureReactions?: ConstrainBoolean; groupId?: ConstrainDOMString; height?: ConstrainULong; + humanFaceDetectionMode?: ConstrainDOMString; noiseSuppression?: ConstrainBoolean; sampleRate?: ConstrainULong; sampleSize?: ConstrainULong; + voiceIsolation?: ConstrainBoolean; width?: ConstrainULong; } @@ -1621,18 +1648,26 @@ interface MediaTrackSettings { aspectRatio?: number; autoGainControl?: boolean; backgroundBlur?: boolean; + backgroundSegmentationMask?: boolean; channelCount?: number; deviceId?: string; displaySurface?: string; echoCancellation?: boolean | string; + eyeGazeCorrection?: boolean; + faceFraming?: boolean; facingMode?: string; frameRate?: number; + gestureReactions?: boolean; groupId?: string; height?: number; + humanFaceDetectionMode?: string; noiseSuppression?: boolean; + powerEfficient?: boolean; + powerEfficientPixelFormat?: boolean; sampleRate?: number; sampleSize?: number; torch?: boolean; + voiceIsolation?: boolean; whiteBalanceMode?: string; width?: number; zoom?: number; @@ -1642,17 +1677,25 @@ interface MediaTrackSupportedConstraints { aspectRatio?: boolean; autoGainControl?: boolean; backgroundBlur?: boolean; + backgroundSegmentationMask?: boolean; channelCount?: boolean; deviceId?: boolean; displaySurface?: boolean; echoCancellation?: boolean; + eyeGazeCorrection?: boolean; + faceFraming?: boolean; facingMode?: boolean; frameRate?: boolean; + gestureReactions?: boolean; groupId?: boolean; height?: boolean; + humanFaceDetectionMode?: boolean; noiseSuppression?: boolean; + powerEfficient?: boolean; + powerEfficientPixelFormat?: boolean; sampleRate?: boolean; sampleSize?: boolean; + voiceIsolation?: boolean; width?: boolean; } @@ -2019,7 +2062,7 @@ interface PromiseRejectionEventInit extends EventInit { } interface PropertyDefinition { - inherits: boolean; + inherits?: boolean; initialValue?: string; name: string; syntax?: string; @@ -3249,6 +3292,7 @@ interface WebTransportReceiveStreamStats { } interface WebTransportSendOptions { + sendGroup?: WebTransportSendGroup | null; sendOrder?: number; } @@ -3266,6 +3310,7 @@ interface WheelEventInit extends MouseEventInit { deltaX?: number; deltaY?: number; deltaZ?: number; + momentum?: boolean; } interface WindowPostMessageOptions extends StructuredSerializeOptions { @@ -3313,7 +3358,7 @@ declare var NodeFilter: { type XPathNSResolver = ((prefix: string | null) => string | null) | { lookupNamespaceURI(prefix: string | null): string | null; }; /** - * The **`ANGLE_instanced_arrays`** extension is part of the WebGL API and allows to draw the same object, or groups of similar objects multiple times, if they share the same vertex data, primitive count and type. + * The **`ANGLE_instanced_arrays`** extension is part of the WebGL API and allows you to draw the same object, or groups of similar objects multiple times, if they share the same vertex data, primitive count and type. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ANGLE_instanced_arrays) */ @@ -4054,6 +4099,12 @@ declare var AnimationEffect: { * [MDN Reference](https://developer.mozilla.org/docs/Web/API/AnimationEvent) */ interface AnimationEvent extends Event { + /** + * The **`animation`** read-only property of the AnimationEvent interface represents the animation associated with the event. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/AnimationEvent/animation) + */ + readonly animation: CSSAnimation | null; /** * The **`AnimationEvent.animationName`** read-only property is a string containing the value of the animation-name CSS property associated with the transition. * @@ -4093,7 +4144,7 @@ interface AnimationFrameProvider { */ interface AnimationPlaybackEvent extends Event { /** - * The **`currentTime`** read-only property of the AnimationPlaybackEvent interface represents the current time of the animation that generated the event at the moment the event is queued. This will be unresolved if the animation was idle at the time the event was generated. + * The **`currentTime`** read-only property of the AnimationPlaybackEvent interface represents the current time of the animation that generated the event at the moment the event is queued. For browser-generated cancel events, the value is null. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/AnimationPlaybackEvent/currentTime) */ @@ -5114,7 +5165,7 @@ interface BaseAudioContext extends EventTarget { */ readonly audioWorklet: AudioWorklet; /** - * The **`currentTime`** read-only property of the BaseAudioContext interface returns a double representing an ever-increasing hardware timestamp in seconds that can be used for scheduling audio playback, visualizing timelines, etc. It starts at 0. + * The **`currentTime`** read-only property of the BaseAudioContext interface returns a double representing the elapsed time in the context's audio timeline in seconds that can be used for scheduling audio playback, visualizing timelines, etc. It starts at 0. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/BaseAudioContext/currentTime) */ @@ -5598,13 +5649,19 @@ declare var CSSConditionRule: { */ interface CSSContainerRule extends CSSConditionRule { /** - * The read-only **`containerName`** property of the CSSContainerRule interface represents the container name of the associated CSS @container at-rule. + * The read-only **`conditions`** property of the CSSContainerRule interface represents an associated CSS @container at-rule as an array of objects, where each object represents a single container condition. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSContainerRule/conditions) + */ + readonly conditions: ReadonlyArray; + /** + * The read-only **`containerName`** property of the CSSContainerRule interface represents the name of the container condition for a container rule that only defines one container condition. If there are multiple container conditions, the value is set to the empty string. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSContainerRule/containerName) */ readonly containerName: string; /** - * The read-only **`containerQuery`** property of the CSSContainerRule interface returns a string representing the container conditions that are evaluated when the container changes size in order to determine if the styles in the associated @container are applied. + * The read-only **`containerQuery`** property of the CSSContainerRule interface represents the query part of the container condition for a container rule that only defines one container condition. If there are multiple container conditions, the value is set to the empty string. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSContainerRule/containerQuery) */ @@ -5707,12 +5764,14 @@ interface CSSFontFaceDescriptors extends CSSStyleDeclarationBase { "font-stretch": string; "font-style": string; "font-weight": string; + "font-width": string; fontDisplay: string; fontFamily: string; fontFeatureSettings: string; fontStretch: string; fontStyle: string; fontWeight: string; + fontWidth: string; "size-adjust": string; sizeAdjust: string; src: string; @@ -5833,7 +5892,7 @@ declare var CSSGroupingRule: { }; /** - * The **`CSSImageValue`** interface of the CSS Typed Object Model API represents values for properties that take an image, for example background-image, list-style-image, or border-image-source. + * The **`CSSImageValue`** interface of the CSS Typed Object Model API represents values for CSS properties that take an value, such as background-image, list-style-image, or border-image-source. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSImageValue) */ @@ -5966,13 +6025,13 @@ declare var CSSKeyframesRule: { }; /** - * The **`CSSKeywordValue`** interface of the CSS Typed Object Model API creates an object to represent CSS keywords and other identifiers. + * The **`CSSKeywordValue`** interface of the CSS Typed Object Model API represents the value of a CSS keyword or other identifier. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSKeywordValue) */ interface CSSKeywordValue extends CSSStyleValue { /** - * The **`value`** property of the CSSKeywordValue interface returns or sets the value of the CSSKeywordValue. + * The **`value`** property of the CSSKeywordValue interface represents the keyword as a string. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSKeywordValue/value) */ @@ -6010,7 +6069,7 @@ declare var CSSLayerBlockRule: { */ interface CSSLayerStatementRule extends CSSRule { /** - * The read-only **`nameList`** property of the CSSLayerStatementRule interface return the list of associated cascade layer names. The names can't be modified. + * The read-only **`nameList`** property of the CSSLayerStatementRule interface returns the list of associated cascade layer names. The names can't be modified. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSLayerStatementRule/nameList) */ @@ -6023,25 +6082,25 @@ declare var CSSLayerStatementRule: { }; /** - * The **`CSSMathClamp`** interface of the CSS Typed Object Model API represents the CSS clamp() function. It inherits properties and methods from its parent CSSNumericValue. + * The **`CSSMathClamp`** interface of the CSS Typed Object Model API represents the CSS clamp() function. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSMathClamp) */ interface CSSMathClamp extends CSSMathValue { /** - * The **`lower`** read-only property of the CSSMathClamp interface returns a CSSNumericValue object containing the minimum value of a CSSMathClamp object. + * The **`lower`** read-only property of the CSSMathClamp interface returns a CSSNumericValue object representing its minimum value. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSMathClamp/lower) */ readonly lower: CSSNumericValue; /** - * The **`upper`** read-only property of the CSSMathClamp interface returns a CSSNumericValue object containing the maximum value of a CSSMathClamp object. + * The **`upper`** read-only property of the CSSMathClamp interface returns a CSSNumericValue object representing its maximum value. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSMathClamp/upper) */ readonly upper: CSSNumericValue; /** - * The **`value`** read-only property of the CSSMathClamp interface returns a CSSNumericValue object containing the preferred value of a CSSMathClamp object. + * The **`value`** read-only property of the CSSMathClamp interface returns a CSSNumericValue instance representing its preferred value. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSMathClamp/value) */ @@ -6054,13 +6113,13 @@ declare var CSSMathClamp: { }; /** - * The **`CSSMathInvert`** interface of the CSS Typed Object Model API represents a CSS calc() used as calc(1 / ). It inherits properties and methods from its parent CSSNumericValue. + * The **`CSSMathInvert`** interface of the CSS Typed Object Model API represents the inverse (reciprocal) of a CSSNumericValue. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSMathInvert) */ interface CSSMathInvert extends CSSMathValue { /** - * The **`CSSMathInvert.value`** read-only property of the CSSMathInvert interface returns a CSSNumericValue object. + * The **`value`** read-only property of the CSSMathInvert interface returns the CSSNumericValue that is being inverted. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSMathInvert/value) */ @@ -6073,13 +6132,13 @@ declare var CSSMathInvert: { }; /** - * The **`CSSMathMax`** interface of the CSS Typed Object Model API represents the CSS max() function. It inherits properties and methods from its parent CSSNumericValue. + * The **`CSSMathMax`** interface of the CSS Typed Object Model API represents the CSS max() function. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSMathMax) */ interface CSSMathMax extends CSSMathValue { /** - * The **`CSSMathMax.values`** read-only property of the CSSMathMax interface returns a CSSNumericArray object which contains one or more CSSNumericValue objects. + * The **`values`** read-only property of the CSSMathMax interface returns a CSSNumericArray containing the CSSNumericValue objects being compared to find the maximum. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSMathMax/values) */ @@ -6092,13 +6151,13 @@ declare var CSSMathMax: { }; /** - * The **`CSSMathMin`** interface of the CSS Typed Object Model API represents the CSS min() function. It inherits properties and methods from its parent CSSNumericValue. + * The **`CSSMathMin`** interface of the CSS Typed Object Model API represents the CSS min() function. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSMathMin) */ interface CSSMathMin extends CSSMathValue { /** - * The **`CSSMathMin.values`** read-only property of the CSSMathMin interface returns a CSSNumericArray object which contains one or more CSSNumericValue objects. + * The **`values`** read-only property of the CSSMathMin interface returns a CSSNumericArray containing the CSSNumericValue objects being compared to find the minimum. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSMathMin/values) */ @@ -6111,13 +6170,13 @@ declare var CSSMathMin: { }; /** - * The **`CSSMathNegate`** interface of the CSS Typed Object Model API negates the value passed into it. It inherits properties and methods from its parent CSSNumericValue. + * The **`CSSMathNegate`** interface of the CSS Typed Object Model API represents the negation of a CSSNumericValue. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSMathNegate) */ interface CSSMathNegate extends CSSMathValue { /** - * The **`CSSMathNegate.value`** read-only property of the CSSMathNegate interface returns a CSSNumericValue object. + * The **`value`** read-only property of the CSSMathNegate interface returns the CSSNumericValue that is being negated. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSMathNegate/value) */ @@ -6130,13 +6189,13 @@ declare var CSSMathNegate: { }; /** - * The **`CSSMathProduct`** interface of the CSS Typed Object Model API represents the result obtained by calling add(), sub(), or toSum() on CSSNumericValue. It inherits properties and methods from its parent CSSNumericValue. + * The **`CSSMathProduct`** interface of the CSS Typed Object Model API represents the product of two or more CSSNumericValue values — in cases where the result can't be represented as a single value. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSMathProduct) */ interface CSSMathProduct extends CSSMathValue { /** - * The **`CSSMathProduct.values`** read-only property of the CSSMathProduct interface returns a CSSNumericArray object which contains one or more CSSNumericValue objects. + * The **`values`** read-only property of the CSSMathProduct interface returns a CSSNumericArray containing the CSSNumericValue objects being multiplied together. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSMathProduct/values) */ @@ -6149,13 +6208,13 @@ declare var CSSMathProduct: { }; /** - * The **`CSSMathSum`** interface of the CSS Typed Object Model API represents the result obtained by calling add(), sub(), or toSum() on CSSNumericValue. + * The **`CSSMathSum`** interface of the CSS Typed Object Model API represents the sum of two or more CSSNumericValue values — in cases where the result can't be represented as a single value. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSMathSum) */ interface CSSMathSum extends CSSMathValue { /** - * The **`CSSMathSum.values`** read-only property of the CSSMathSum interface returns a CSSNumericArray object which contains one or more CSSNumericValue objects. + * The **`values`** read-only property of the CSSMathSum interface returns a CSSNumericArray containing the CSSNumericValue objects being summed together. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSMathSum/values) */ @@ -6168,13 +6227,13 @@ declare var CSSMathSum: { }; /** - * The **`CSSMathValue`** interface of the CSS Typed Object Model API a base class for classes representing complex numeric values. + * The **`CSSMathValue`** interface of the CSS Typed Object Model API is the base interface for objects representing complex numeric values produced by the CSS calc(), min(), max(), and clamp() functions. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSMathValue) */ interface CSSMathValue extends CSSNumericValue { /** - * The **`CSSMathValue.operator`** read-only property of the CSSMathValue interface indicates the operator that the current subtype represents. For example, if the current CSSMathValue subtype is CSSMathSum, this property will return the string "sum". + * The **`operator`** read-only property of the CSSMathValue interface returns the operator that the current subtype represents. For example, if the current CSSMathValue subtype is CSSMathSum, this property will return the string "sum". * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSMathValue/operator) */ @@ -6187,13 +6246,13 @@ declare var CSSMathValue: { }; /** - * The **`CSSMatrixComponent`** interface of the CSS Typed Object Model API represents the matrix() and matrix3d() values of the individual transform property in CSS. It inherits properties and methods from its parent CSSTransformValue. + * The **`CSSMatrixComponent`** interface of the CSS Typed Object Model API represents the matrix() and matrix3d() values of the individual transform property in CSS. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSMatrixComponent) */ interface CSSMatrixComponent extends CSSTransformComponent { /** - * The **`matrix`** property of the CSSMatrixComponent interface gets and sets a 2d or 3d matrix. + * The **`matrix`** property of the CSSMatrixComponent interface represents a DOMMatrix object containing a 2D or 3D matrix. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSMatrixComponent/matrix) */ @@ -6271,13 +6330,13 @@ declare var CSSNestedDeclarations: { }; /** - * The **`CSSNumericArray`** interface of the CSS Typed Object Model API contains a list of CSSNumericValue objects. + * The **`CSSNumericArray`** interface of the CSS Typed Object Model API represents an iterable of CSSNumericValue-based objects. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSNumericArray) */ interface CSSNumericArray { /** - * The read-only **`length`** property of the CSSNumericArray interface returns the number of CSSNumericValue objects in the list. + * The **`length`** read-only property of the CSSNumericArray interface returns the number of items in the object. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSNumericArray/length) */ @@ -6310,7 +6369,7 @@ interface CSSNumericValue extends CSSStyleValue { */ div(...values: CSSNumberish[]): CSSNumericValue; /** - * The **`equals()`** method of the CSSNumericValue interface returns a boolean indicating whether the passed value are strictly equal. To return a value of true, all passed values must be of the same type and value and must be in the same order. This allows structural equality to be tested quickly. + * The **`equals()`** method of the CSSNumericValue interface returns a boolean indicating whether the passed values are strictly equal. To return a value of true, all passed values must be of the same type and value and must be in the same order. This allows structural equality to be tested quickly. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSNumericValue/equals) */ @@ -6328,7 +6387,7 @@ interface CSSNumericValue extends CSSStyleValue { */ min(...values: CSSNumberish[]): CSSNumericValue; /** - * The **`mul()`** method of the CSSNumericValue interface multiplies the CSSNumericValue by the supplied value. + * The **`mul()`** method of the CSSNumericValue interface multiplies the CSSNumericValue by the supplied values. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSNumericValue/mul) */ @@ -6346,7 +6405,7 @@ interface CSSNumericValue extends CSSStyleValue { */ to(unit: string): CSSUnitValue; /** - * The **`toSum()`** method of the CSSNumericValue interface converts the object's value to a CSSMathSum object to values of the specified unit. + * The **`toSum()`** method of the CSSNumericValue interface converts the object's value to a CSSMathSum of CSSUnitValues using only the specified units, if possible. If called with no units, it simplifies the value into a minimal sum of CSSUnitValues instead. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSNumericValue/toSum) */ @@ -6430,13 +6489,13 @@ declare var CSSPageRule: { }; /** - * The **`CSSPerspective`** interface of the CSS Typed Object Model API represents the perspective() value of the individual transform property in CSS. It inherits properties and methods from its parent CSSTransformValue. + * The **`CSSPerspective`** interface of the CSS Typed Object Model API represents the perspective() value of the individual transform property in CSS. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSPerspective) */ interface CSSPerspective extends CSSTransformComponent { /** - * The **`length`** property of the CSSPerspective interface sets the distance from z=0. + * The **`length`** property of the CSSPerspective interface represents the distance from z=0. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSPerspective/length) */ @@ -6665,7 +6724,7 @@ declare var CSSPropertyRule: { }; /** - * The **`CSSRotate`** interface of the CSS Typed Object Model API represents the rotate value of the individual transform property in CSS. It inherits properties and methods from its parent CSSTransformValue. + * The **`CSSRotate`** interface of the CSS Typed Object Model API represents the rotate value of the individual transform property in CSS. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSRotate) */ @@ -6689,7 +6748,7 @@ interface CSSRotate extends CSSTransformComponent { */ y: CSSNumberish; /** - * The **`z`** property of the CSSRotate interface representing the z-component of the translating vector. A positive value moves the element towards the viewer, and a negative value farther away. + * The **`z`** property of the CSSRotate interface represents the z-component of the translating vector. A positive value moves the element towards the viewer and a negative value farther away. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSRotate/z) */ @@ -6793,7 +6852,7 @@ declare var CSSRuleList: { }; /** - * The **`CSSScale`** interface of the CSS Typed Object Model API represents the scale() and scale3d() values of the individual transform property in CSS. It inherits properties and methods from its parent CSSTransformValue. + * The **`CSSScale`** interface of the CSS Typed Object Model API represents the scale() and scale3d() values of the individual transform property in CSS. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSScale) */ @@ -6811,7 +6870,7 @@ interface CSSScale extends CSSTransformComponent { */ y: CSSNumberish; /** - * The **`z`** property of the CSSScale interface representing the z-component of the translating vector. A positive value moves the element towards the viewer, and a negative value farther away. + * The **`z`** property of the CSSScale interface represents the z-component of the translating vector. A positive value moves the element towards the viewer, and a negative value farther away. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSScale/z) */ @@ -6849,7 +6908,7 @@ declare var CSSScopeRule: { }; /** - * The **`CSSSkew`** interface of the CSS Typed Object Model API is part of the CSSTransformValue interface. It represents the skew() value of the individual transform property in CSS. + * The **`CSSSkew`** interface of the CSS Typed Object Model API represents the skew() value of the individual transform property in CSS. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSSkew) */ @@ -6874,7 +6933,7 @@ declare var CSSSkew: { }; /** - * The **`CSSSkewX`** interface of the CSS Typed Object Model API represents the skewX() value of the individual transform property in CSS. It inherits properties and methods from its parent CSSTransformValue. + * The **`CSSSkewX`** interface of the CSS Typed Object Model API represents the skewX() value of the individual transform property in CSS. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSSkewX) */ @@ -6893,7 +6952,7 @@ declare var CSSSkewX: { }; /** - * The **`CSSSkewY`** interface of the CSS Typed Object Model API represents the skewY() value of the individual transform property in CSS. It inherits properties and methods from its parent CSSTransformValue. + * The **`CSSSkewY`** interface of the CSS Typed Object Model API represents the skewY() value of the individual transform property in CSS. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSSkewY) */ @@ -7026,7 +7085,7 @@ interface CSSStyleProperties extends CSSStyleDeclarationBase { */ alignmentBaseline: string; /** - * The **`all`** shorthand CSS property resets all of an element's properties except unicode-bidi, direction, and CSS Custom Properties. It can set properties to their initial or inherited values, or to the values specified in another cascade layer or stylesheet origin. + * The **`all`** CSSshorthand property resets all of an element's properties except unicode-bidi, direction, and CSS Custom Properties. It can set properties to their initial or inherited values, or to the values specified in another cascade layer or stylesheet origin. * * [MDN Reference](https://developer.mozilla.org/docs/Web/CSS/Reference/Properties/all) */ @@ -7044,7 +7103,7 @@ interface CSSStyleProperties extends CSSStyleDeclarationBase { */ anchorScope: string; /** - * The **`animation`** shorthand CSS property applies an animation between styles. It is a shorthand for animation-name, animation-duration, animation-timing-function, animation-delay, animation-iteration-count, animation-direction, animation-fill-mode, animation-play-state, and animation-timeline. + * The **`animation`** CSS shorthand property applies an animation between styles. It is a shorthand for animation-name, animation-duration, animation-timing-function, animation-delay, animation-iteration-count, animation-direction, animation-fill-mode, animation-play-state, and animation-timeline. * * [MDN Reference](https://developer.mozilla.org/docs/Web/CSS/Reference/Properties/animation) */ @@ -7134,7 +7193,7 @@ interface CSSStyleProperties extends CSSStyleDeclarationBase { */ appearance: string; /** - * The aspect-ratio CSS property allows you to define the desired width-to-height ratio of an element's box. This means that even if the parent container or viewport size changes, the browser will adjust the element's dimensions to maintain the specified width-to-height ratio. The specified aspect ratio is used in the calculation of auto sizes and some other layout functions. + * The aspect-ratio CSS property allows you to define the desired width-to-height ratio of an element's box. * * [MDN Reference](https://developer.mozilla.org/docs/Web/CSS/Reference/Properties/aspect-ratio) */ @@ -7152,7 +7211,7 @@ interface CSSStyleProperties extends CSSStyleDeclarationBase { */ backfaceVisibility: string; /** - * The **`background`** shorthand CSS property sets all background style properties at once, such as color, image, origin, size, and repeat method. + * The **`background`** CSS shorthand property sets all background style properties at once, such as color, image, origin, size, and repeat method. * * [MDN Reference](https://developer.mozilla.org/docs/Web/CSS/Reference/Properties/background) */ @@ -7194,7 +7253,7 @@ interface CSSStyleProperties extends CSSStyleDeclarationBase { */ backgroundOrigin: string; /** - * The background-position CSS property sets the initial position for each background image. The position is relative to the position layer set by background-origin. + * The background-position CSS property sets the initial position for each background image. * * [MDN Reference](https://developer.mozilla.org/docs/Web/CSS/Reference/Properties/background-position) */ @@ -7212,7 +7271,7 @@ interface CSSStyleProperties extends CSSStyleDeclarationBase { */ backgroundPositionY: string; /** - * The background-repeat CSS property sets how background images are repeated. A background image can be repeated along the horizontal and vertical axes, or not repeated at all. + * The background-repeat CSS shorthand property sets how background images are repeated. A background image can be repeated along the horizontal and vertical axes, or not repeated at all. * * [MDN Reference](https://developer.mozilla.org/docs/Web/CSS/Reference/Properties/background-repeat) */ @@ -7242,13 +7301,13 @@ interface CSSStyleProperties extends CSSStyleDeclarationBase { */ blockSize: string; /** - * The **`border`** shorthand CSS property sets an element's border. It sets the values of border-width, border-style, and border-color. + * The **`border`** CSS shorthand property sets an element's border. It sets the values of border-width, border-style, and border-color. * * [MDN Reference](https://developer.mozilla.org/docs/Web/CSS/Reference/Properties/border) */ border: string; /** - * The border-block CSS property is a shorthand property for setting the individual logical block border property values in a single place in the style sheet. + * The border-block CSS shorthand property sets the individual logical block border property values in a single place in the style sheet. * * [MDN Reference](https://developer.mozilla.org/docs/Web/CSS/Reference/Properties/border-block) */ @@ -7260,7 +7319,7 @@ interface CSSStyleProperties extends CSSStyleDeclarationBase { */ borderBlockColor: string; /** - * The border-block-end CSS property is a shorthand property for setting the individual logical block-end border property values in a single place in the style sheet. + * The border-block-end CSS shorthand property sets the individual logical block-end border property values in a single place in the style sheet. * * [MDN Reference](https://developer.mozilla.org/docs/Web/CSS/Reference/Properties/border-block-end) */ @@ -7284,7 +7343,7 @@ interface CSSStyleProperties extends CSSStyleDeclarationBase { */ borderBlockEndWidth: string; /** - * The border-block-start CSS property is a shorthand property for setting the individual logical block-start border property values in a single place in the style sheet. + * The border-block-start CSS shorthand property sets the individual logical block-start border property values in a single place in the style sheet. * * [MDN Reference](https://developer.mozilla.org/docs/Web/CSS/Reference/Properties/border-block-start) */ @@ -7320,7 +7379,7 @@ interface CSSStyleProperties extends CSSStyleDeclarationBase { */ borderBlockWidth: string; /** - * The border-bottom shorthand CSS property sets an element's bottom border. It sets the values of border-bottom-width, border-bottom-style and border-bottom-color. + * The border-bottom CSS shorthand property sets an element's bottom border. It sets the values of border-bottom-width, border-bottom-style and border-bottom-color. * * [MDN Reference](https://developer.mozilla.org/docs/Web/CSS/Reference/Properties/border-bottom) */ @@ -7362,7 +7421,7 @@ interface CSSStyleProperties extends CSSStyleDeclarationBase { */ borderCollapse: string; /** - * The border-color shorthand CSS property sets the color of an element's border. + * The border-color CSS shorthand property sets the color of an element's border. * * [MDN Reference](https://developer.mozilla.org/docs/Web/CSS/Reference/Properties/border-color) */ @@ -7380,7 +7439,7 @@ interface CSSStyleProperties extends CSSStyleDeclarationBase { */ borderEndStartRadius: string; /** - * The border-image CSS property draws an image around a given element. It replaces the element's regular border. + * The border-image CSS shorthand property draws an image around a given element. It replaces the element's regular border. * * [MDN Reference](https://developer.mozilla.org/docs/Web/CSS/Reference/Properties/border-image) */ @@ -7416,7 +7475,7 @@ interface CSSStyleProperties extends CSSStyleDeclarationBase { */ borderImageWidth: string; /** - * The border-inline CSS property is a shorthand property for setting the individual logical inline border property values in a single place in the style sheet. + * The border-inline CSS shorthand property sets the individual logical inline border property values in a single place in the style sheet. * * [MDN Reference](https://developer.mozilla.org/docs/Web/CSS/Reference/Properties/border-inline) */ @@ -7428,7 +7487,7 @@ interface CSSStyleProperties extends CSSStyleDeclarationBase { */ borderInlineColor: string; /** - * The border-inline-end CSS property is a shorthand property for setting the individual logical inline-end border property values in a single place in the style sheet. + * The border-inline-end CSS shorthand property sets the individual logical inline-end border property values in a single place in the style sheet. * * [MDN Reference](https://developer.mozilla.org/docs/Web/CSS/Reference/Properties/border-inline-end) */ @@ -7452,7 +7511,7 @@ interface CSSStyleProperties extends CSSStyleDeclarationBase { */ borderInlineEndWidth: string; /** - * The border-inline-start CSS property is a shorthand property for setting the individual logical inline-start border property values in a single place in the style sheet. + * The border-inline-start CSS shorthand property sets the individual logical inline-start border property values in a single place in the style sheet. * * [MDN Reference](https://developer.mozilla.org/docs/Web/CSS/Reference/Properties/border-inline-start) */ @@ -7488,7 +7547,7 @@ interface CSSStyleProperties extends CSSStyleDeclarationBase { */ borderInlineWidth: string; /** - * The border-left shorthand CSS property sets all the properties of an element's left border. + * The border-left CSS shorthand property sets all the properties of an element's left border. * * [MDN Reference](https://developer.mozilla.org/docs/Web/CSS/Reference/Properties/border-left) */ @@ -7512,13 +7571,13 @@ interface CSSStyleProperties extends CSSStyleDeclarationBase { */ borderLeftWidth: string; /** - * The border-radius CSS property rounds the corners of an element's outer border edge. You can set a single radius to make circular corners, or two radii to make elliptical corners. + * The border-radius CSS shorthand property rounds the corners of an element's outer border edge. You can set a single radius to make circular corners, or two radii to make elliptical corners. * * [MDN Reference](https://developer.mozilla.org/docs/Web/CSS/Reference/Properties/border-radius) */ borderRadius: string; /** - * The border-right shorthand CSS property sets all the properties of an element's right border. + * The border-right CSS shorthand property sets all the properties of an element's right border. * * [MDN Reference](https://developer.mozilla.org/docs/Web/CSS/Reference/Properties/border-right) */ @@ -7560,13 +7619,13 @@ interface CSSStyleProperties extends CSSStyleDeclarationBase { */ borderStartStartRadius: string; /** - * The border-style shorthand CSS property sets the line style for all four sides of an element's border. + * The border-style CSS shorthand property sets the line style for all four sides of an element's border. * * [MDN Reference](https://developer.mozilla.org/docs/Web/CSS/Reference/Properties/border-style) */ borderStyle: string; /** - * The border-top shorthand CSS property sets all the properties of an element's top border. + * The border-top CSS shorthand property sets all the properties of an element's top border. * * [MDN Reference](https://developer.mozilla.org/docs/Web/CSS/Reference/Properties/border-top) */ @@ -7602,7 +7661,7 @@ interface CSSStyleProperties extends CSSStyleDeclarationBase { */ borderTopWidth: string; /** - * The border-width shorthand CSS property sets the width of an element's border. + * The border-width CSS shorthand property sets the width of an element's border. * * [MDN Reference](https://developer.mozilla.org/docs/Web/CSS/Reference/Properties/border-width) */ @@ -7723,31 +7782,31 @@ interface CSSStyleProperties extends CSSStyleDeclarationBase { */ columnFill: string; /** - * The column-gap CSS property sets the size of the gap (gutter) between an element's columns. + * The column-gap CSS property sets the size of the gap (gutter) between an element's columns in multi-column, flexible box, and grid layouts. * * [MDN Reference](https://developer.mozilla.org/docs/Web/CSS/Reference/Properties/column-gap) */ columnGap: string; /** - * The column-rule shorthand CSS property sets the width, style, and color of the line drawn between columns in a multi-column layout. + * The column-rule CSS shorthand property sets the width, style, and color of the lines drawn between columns in multi-column grid, flex, and multi-col layouts. * * [MDN Reference](https://developer.mozilla.org/docs/Web/CSS/Reference/Properties/column-rule) */ columnRule: string; /** - * The column-rule-color CSS property sets the color of the line drawn between columns in a multi-column layout. + * The column-rule-color CSS property defines the colors of the lines drawn between columns in multi-column grid, flex, and multi-col layouts. * * [MDN Reference](https://developer.mozilla.org/docs/Web/CSS/Reference/Properties/column-rule-color) */ columnRuleColor: string; /** - * The column-rule-style CSS property sets the style of the line drawn between columns in a multi-column layout. + * The column-rule-style CSS property defines the line style of the lines drawn between columns in multi-column grid, flex, and multi-col layouts. * * [MDN Reference](https://developer.mozilla.org/docs/Web/CSS/Reference/Properties/column-rule-style) */ columnRuleStyle: string; /** - * The column-rule-width CSS property sets the width of the line drawn between columns in a multi-column layout. + * The column-rule-width CSS property defines the widths of the lines drawn between columns in multi-column grid, flex, and multi-col layouts. * * [MDN Reference](https://developer.mozilla.org/docs/Web/CSS/Reference/Properties/column-rule-width) */ @@ -7813,13 +7872,13 @@ interface CSSStyleProperties extends CSSStyleDeclarationBase { */ container: string; /** - * The container-name CSS property specifies a list of query container names used by the @container at-rule in a container query. A container query will apply styles to elements based on the size or scroll-state of the nearest ancestor with a containment context. When a containment context is given a name, it can be specifically targeted using the @container at-rule instead of the nearest ancestor with containment. + * The container-name CSS property specifies a list of query container names used by the @container at-rule in a container query. * * [MDN Reference](https://developer.mozilla.org/docs/Web/CSS/Reference/Properties/container-name) */ containerName: string; /** - * An element can be established as a query container using the container-type CSS property. container-type is used to define the type of container context used in a container query. The available container contexts are: + * The container-type CSS property specifies the type of container context used in a container query. * * [MDN Reference](https://developer.mozilla.org/docs/Web/CSS/Reference/Properties/container-type) */ @@ -8049,7 +8108,7 @@ interface CSSStyleProperties extends CSSStyleDeclarationBase { */ fontSize: string; /** - * The font-size-adjust CSS property provides a way to modify the size of lowercase letters relative to the size of uppercase letters, which defines the overall font-size. This property is useful for situations where font fallback can occur. + * The font-size-adjust CSS property adjusts the size of a font to match a chosen font metric, such as the height of lowercase letters, to a specified proportion of the font-size. This property is intended for adjusting fallback fonts to have similar metrics as the first-choice font. * * [MDN Reference](https://developer.mozilla.org/docs/Web/CSS/Reference/Properties/font-size-adjust) */ @@ -8067,7 +8126,7 @@ interface CSSStyleProperties extends CSSStyleDeclarationBase { */ fontStyle: string; /** - * The font-synthesis shorthand CSS property lets you specify whether or not the browser may synthesize the bold, italic, small-caps, and/or subscript and superscript typefaces when they are missing in the specified font-family. + * The font-synthesis CSS shorthand property lets you specify whether or not the browser may synthesize the bold, italic, small-caps, and/or subscript and superscript typefaces when they are missing in the specified font-family. * * [MDN Reference](https://developer.mozilla.org/docs/Web/CSS/Reference/Properties/font-synthesis) */ @@ -8150,6 +8209,12 @@ interface CSSStyleProperties extends CSSStyleDeclarationBase { * [MDN Reference](https://developer.mozilla.org/docs/Web/CSS/Reference/Properties/font-weight) */ fontWeight: string; + /** + * The font-width CSS property selects a normal, condensed, or expanded face from a font. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/CSS/Reference/Properties/font-width) + */ + fontWidth: string; /** * The forced-color-adjust CSS property allows authors to opt certain elements out of forced colors mode. This then restores the control of those values to CSS. * @@ -8157,13 +8222,13 @@ interface CSSStyleProperties extends CSSStyleDeclarationBase { */ forcedColorAdjust: string; /** - * The **`gap`** CSS shorthand property sets the gaps (also called gutters) between rows and columns. This property applies to multi-column, flex, and grid containers. + * The **`gap`** CSS shorthand property sets the gaps (also called gutters) between rows and columns on multi-column, flex, and grid containers. * * [MDN Reference](https://developer.mozilla.org/docs/Web/CSS/Reference/Properties/gap) */ gap: string; /** - * The **`grid`** CSS property is a shorthand property that sets all of the explicit and implicit grid properties in a single declaration. + * The **`grid`** CSS shorthand property sets all of the explicit and implicit grid properties in a single declaration. * * [MDN Reference](https://developer.mozilla.org/docs/Web/CSS/Reference/Properties/grid) */ @@ -8235,7 +8300,7 @@ interface CSSStyleProperties extends CSSStyleDeclarationBase { */ gridRowStart: string; /** - * The grid-template CSS property is a shorthand property for defining grid columns, grid rows, and grid areas. + * The grid-template CSS shorthand property specifies the grid columns, grid rows, and grid areas. * * [MDN Reference](https://developer.mozilla.org/docs/Web/CSS/Reference/Properties/grid-template) */ @@ -8277,7 +8342,7 @@ interface CSSStyleProperties extends CSSStyleDeclarationBase { */ hyphenateLimitChars: string; /** - * The **`hyphens`** CSS property specifies how words should be hyphenated when text wraps across multiple lines. It can prevent hyphenation entirely, hyphenate at manually-specified points within the text, or let the browser automatically insert hyphens where appropriate. + * The **`hyphens`** CSS property specifies how words should be hyphenated when text wraps across multiple lines. * * [MDN Reference](https://developer.mozilla.org/docs/Web/CSS/Reference/Properties/hyphens) */ @@ -8301,13 +8366,13 @@ interface CSSStyleProperties extends CSSStyleDeclarationBase { */ inlineSize: string; /** - * The **`inset`** CSS property is a shorthand that corresponds to the top, right, bottom, and/or left properties. It has the same multi-value syntax of the margin shorthand. + * The **`inset`** CSS shorthand property corresponds to the top, right, bottom, and/or left properties. It has the same multi-value syntax of the margin shorthand. * * [MDN Reference](https://developer.mozilla.org/docs/Web/CSS/Reference/Properties/inset) */ inset: string; /** - * The inset-block CSS property defines the logical block start and end offsets of an element, which maps to physical offsets depending on the element's writing mode, directionality, and text orientation. It corresponds to the top and bottom, or right and left properties depending on the values defined for writing-mode, direction, and text-orientation. + * The inset-block CSS shorthand property defines the logical block start and end offsets of an element, which maps to physical offsets depending on the element's writing mode, directionality, and text orientation. It corresponds to the top and bottom, or right and left properties depending on the values defined for writing-mode, direction, and text-orientation. * * [MDN Reference](https://developer.mozilla.org/docs/Web/CSS/Reference/Properties/inset-block) */ @@ -8325,7 +8390,7 @@ interface CSSStyleProperties extends CSSStyleDeclarationBase { */ insetBlockStart: string; /** - * The inset-inline CSS property defines the logical start and end offsets of an element in the inline direction, which maps to physical offsets depending on the element's writing mode, directionality, and text orientation. It corresponds to the top and bottom, or right and left properties depending on the values defined for writing-mode, direction, and text-orientation. + * The inset-inline CSS shorthand property defines the logical start and end offsets of an element in the inline direction, which maps to physical offsets depending on the element's writing mode, directionality, and text orientation. It corresponds to the top and bottom, or right and left properties depending on the values defined for writing-mode, direction, and text-orientation. * * [MDN Reference](https://developer.mozilla.org/docs/Web/CSS/Reference/Properties/inset-inline) */ @@ -8637,7 +8702,7 @@ interface CSSStyleProperties extends CSSStyleDeclarationBase { */ minWidth: string; /** - * The mix-blend-mode CSS property sets how an element's content should blend with the content of the element's parent and the element's background. + * The mix-blend-mode CSS property sets how an element's content should blend with its backdrop — the content rendered behind the element within the same stacking context. * * [MDN Reference](https://developer.mozilla.org/docs/Web/CSS/Reference/Properties/mix-blend-mode) */ @@ -8934,7 +8999,7 @@ interface CSSStyleProperties extends CSSStyleDeclarationBase { */ placeContent: string; /** - * The CSS place-items shorthand property aligns items along both the block and inline directions at once. It sets the values of the align-items and justify-items properties. If the second value is not set, the first value is also used for it. + * The place-items CSS shorthand property aligns items along both the block and inline directions at once. It sets the values of the align-items and justify-items properties. If the second value is not set, the first value is also used for it. * * [MDN Reference](https://developer.mozilla.org/docs/Web/CSS/Reference/Properties/place-items) */ @@ -8958,7 +9023,7 @@ interface CSSStyleProperties extends CSSStyleDeclarationBase { */ position: string; /** - * The position-anchor CSS property specifies the anchor name of the anchor element (i.e., an element that has an anchor name set on it via the anchor-name property) a positioned element is associated with. + * The position-anchor CSS property specifies the default anchor element for a positioned element. This default is used by position-area and position-try, and by anchor functions (anchor() and anchor-size()) when no argument is provided to those functions. * * [MDN Reference](https://developer.mozilla.org/docs/Web/CSS/Reference/Properties/position-anchor) */ @@ -8970,7 +9035,7 @@ interface CSSStyleProperties extends CSSStyleDeclarationBase { */ positionArea: string; /** - * The position-try CSS property is a shorthand that corresponds to the position-try-order and position-try-fallbacks properties. + * The position-try CSS shorthand property corresponds to the position-try-order and position-try-fallbacks properties. * * [MDN Reference](https://developer.mozilla.org/docs/Web/CSS/Reference/Properties/position-try) */ @@ -9042,7 +9107,13 @@ interface CSSStyleProperties extends CSSStyleDeclarationBase { */ rubyAlign: string; /** - * The ruby-position CSS property defines the position of a ruby element relative to its base element. It can be positioned over the element (over), under it (under), or between the characters on their right side (inter-character). + * The ruby-overhang CSS property specifies whether or not a annotation overhangs any surrounding text. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/CSS/Reference/Properties/ruby-overhang) + */ + rubyOverhang: string; + /** + * The ruby-position CSS property defines the position of a ruby element relative to its base element. It can be positioned over the element (over), under it (under), or to the right (inter-character). * * [MDN Reference](https://developer.mozilla.org/docs/Web/CSS/Reference/Properties/ruby-position) */ @@ -9072,13 +9143,13 @@ interface CSSStyleProperties extends CSSStyleDeclarationBase { */ scrollBehavior: string; /** - * The scroll-margin shorthand property sets all of the scroll margins of an element at once, assigning values much like the margin property does for margins of an element. + * The scroll-margin CSS shorthand property sets all of the scroll margins of an element at once, assigning values much like the margin property does for margins of an element. * * [MDN Reference](https://developer.mozilla.org/docs/Web/CSS/Reference/Properties/scroll-margin) */ scrollMargin: string; /** - * The scroll-margin-block shorthand property sets the scroll margins of an element in the block dimension. + * The scroll-margin-block CSS shorthand property sets the scroll margins of an element in the block dimension. * * [MDN Reference](https://developer.mozilla.org/docs/Web/CSS/Reference/Properties/scroll-margin-block) */ @@ -9102,7 +9173,7 @@ interface CSSStyleProperties extends CSSStyleDeclarationBase { */ scrollMarginBottom: string; /** - * The scroll-margin-inline shorthand property sets the scroll margins of an element in the inline dimension. + * The scroll-margin-inline CSS shorthand property sets the scroll margins of an element in the inline dimension. * * [MDN Reference](https://developer.mozilla.org/docs/Web/CSS/Reference/Properties/scroll-margin-inline) */ @@ -9138,13 +9209,13 @@ interface CSSStyleProperties extends CSSStyleDeclarationBase { */ scrollMarginTop: string; /** - * The scroll-padding shorthand property sets scroll padding on all sides of an element at once. It specifies offsets that define the optimal viewing region of a scrollport within a scroll container. + * The scroll-padding CSS shorthand property sets scroll padding on all sides of an element at once. It specifies offsets that define the optimal viewing region of a scrollport within a scroll container. * * [MDN Reference](https://developer.mozilla.org/docs/Web/CSS/Reference/Properties/scroll-padding) */ scrollPadding: string; /** - * The scroll-padding-block shorthand property sets the scroll padding of an element in the block dimension. + * The scroll-padding-block CSS shorthand property sets the scroll padding of an element in the block dimension. * * [MDN Reference](https://developer.mozilla.org/docs/Web/CSS/Reference/Properties/scroll-padding-block) */ @@ -9168,7 +9239,7 @@ interface CSSStyleProperties extends CSSStyleDeclarationBase { */ scrollPaddingBottom: string; /** - * The scroll-padding-inline shorthand property sets the scroll padding of an element in the inline dimension. + * The scroll-padding-inline CSS shorthand property sets the scroll padding of an element in the inline dimension. * * [MDN Reference](https://developer.mozilla.org/docs/Web/CSS/Reference/Properties/scroll-padding-inline) */ @@ -9378,7 +9449,7 @@ interface CSSStyleProperties extends CSSStyleDeclarationBase { */ textAutospace: string; /** - * The text-box CSS property is a shorthand that corresponds to the text-box-trim and text-box-edge properties, which together specify the amount of space to trim from the block-start edge and block-end edge of a text element's block container. + * The text-box CSS shorthand property corresponds to the text-box-trim and text-box-edge properties, which together specify the amount of space to trim from the block-start edge and block-end edge of a text element's block container. * * [MDN Reference](https://developer.mozilla.org/docs/Web/CSS/Reference/Properties/text-box) */ @@ -9402,7 +9473,7 @@ interface CSSStyleProperties extends CSSStyleDeclarationBase { */ textCombineUpright: string; /** - * The text-decoration shorthand CSS property sets the appearance of decorative lines on text. It is a shorthand for text-decoration-line, text-decoration-color, text-decoration-style, and the newer text-decoration-thickness property. + * The text-decoration CSS shorthand property sets the appearance of decorative lines on text. It is a shorthand for text-decoration-line, text-decoration-color, text-decoration-style, and the newer text-decoration-thickness property. * * [MDN Reference](https://developer.mozilla.org/docs/Web/CSS/Reference/Properties/text-decoration) */ @@ -9438,7 +9509,7 @@ interface CSSStyleProperties extends CSSStyleDeclarationBase { */ textDecorationThickness: string; /** - * The text-emphasis CSS property applies emphasis marks to text (except spaces and control characters). It is a shorthand for text-emphasis-style and text-emphasis-color. + * The text-emphasis CSS shorthand property applies emphasis marks to text (except spaces and control characters). * * [MDN Reference](https://developer.mozilla.org/docs/Web/CSS/Reference/Properties/text-emphasis) */ @@ -9480,7 +9551,7 @@ interface CSSStyleProperties extends CSSStyleDeclarationBase { */ textOrientation: string; /** - * The text-overflow CSS property sets how hidden overflow content is signaled to users. It can be clipped, display an ellipsis (…), or display a custom string. + * The text-overflow CSS property sets how hidden overflow content is signaled to users. * * [MDN Reference](https://developer.mozilla.org/docs/Web/CSS/Reference/Properties/text-overflow) */ @@ -9522,13 +9593,13 @@ interface CSSStyleProperties extends CSSStyleDeclarationBase { */ textWrap: string; /** - * The text-wrap-mode CSS property controls whether the text inside an element is wrapped. The different values provide alternate ways of wrapping the content of a block element. It can also be set, and reset, using the text-wrap shorthand or the white-space shorthand. + * The text-wrap-mode CSS property controls whether the text inside an element is wrapped. * * [MDN Reference](https://developer.mozilla.org/docs/Web/CSS/Reference/Properties/text-wrap-mode) */ textWrapMode: string; /** - * The text-wrap-style CSS property controls how text inside an element is wrapped. The different values provide alternate ways of wrapping the content of a block element. It can also be set, and reset, using the text-wrap shorthand. + * The text-wrap-style CSS property controls how text inside an element is wrapped, providing alternate ways of determining where to create line breaks in order to fit the content within a block element. * * [MDN Reference](https://developer.mozilla.org/docs/Web/CSS/Reference/Properties/text-wrap-style) */ @@ -9576,7 +9647,7 @@ interface CSSStyleProperties extends CSSStyleDeclarationBase { */ transformStyle: string; /** - * The **`transition`** CSS property is a shorthand property for transition-property, transition-duration, transition-timing-function, transition-delay, and transition-behavior. + * The **`transition`** CSS shorthand property for transition-property, transition-duration, transition-timing-function, transition-delay, and transition-behavior. * * [MDN Reference](https://developer.mozilla.org/docs/Web/CSS/Reference/Properties/transition) */ @@ -9666,7 +9737,7 @@ interface CSSStyleProperties extends CSSStyleDeclarationBase { */ viewTimelineName: string; /** - * The view-transition-class CSS property provides the selected elements with an identifying class (a ), providing an additional method of styling the view transitions for those elements. + * The view-transition-class CSS property provides the selected elements with one or more identifying classes (s), providing an additional method of styling the view transitions for those elements. * * [MDN Reference](https://developer.mozilla.org/docs/Web/CSS/Reference/Properties/view-transition-class) */ @@ -9920,7 +9991,7 @@ interface CSSStyleProperties extends CSSStyleDeclarationBase { */ webkitMask: string; /** - * The non-standard prefixed -webkit-mask-box-image shorthand property sets the mask image for an element's border box. + * The non-standard prefixed -webkit-mask-box-image CSS shorthand property sets the mask image for an element's border box. * @deprecated This is a legacy alias of `maskBorder`. * * [MDN Reference](https://developer.mozilla.org/docs/Web/CSS/Reference/Properties/mask-border) @@ -10030,7 +10101,7 @@ interface CSSStyleProperties extends CSSStyleDeclarationBase { */ webkitTextSizeAdjust: string; /** - * The -webkit-text-stroke CSS property specifies the width and color of strokes for text characters. This is a shorthand property for the longhand properties -webkit-text-stroke-width and -webkit-text-stroke-color. + * The -webkit-text-stroke CSS shorthand property specifies the width and color of strokes for text characters. * * [MDN Reference](https://developer.mozilla.org/docs/Web/CSS/Reference/Properties/-webkit-text-stroke) */ @@ -10102,7 +10173,7 @@ interface CSSStyleProperties extends CSSStyleDeclarationBase { */ webkitUserSelect: string; /** - * The white-space CSS property sets how white space inside an element is handled. + * The white-space CSS shorthand property sets how white space inside an element is handled. * * [MDN Reference](https://developer.mozilla.org/docs/Web/CSS/Reference/Properties/white-space) */ @@ -10126,7 +10197,7 @@ interface CSSStyleProperties extends CSSStyleDeclarationBase { */ width: string; /** - * The will-change CSS property hints to browsers how an element is expected to change. Browsers may set up optimizations before an element is actually changed. These kinds of optimizations can increase the responsiveness of a page by doing potentially expensive work before they are actually required. + * The will-change CSS property enables optimizing animations by providing a rendering hint to a browser about how an element is expected to change. * * [MDN Reference](https://developer.mozilla.org/docs/Web/CSS/Reference/Properties/will-change) */ @@ -10150,7 +10221,7 @@ interface CSSStyleProperties extends CSSStyleDeclarationBase { */ wordWrap: string; /** - * The writing-mode CSS property sets whether lines of text are laid out horizontally or vertically, as well as the direction in which blocks progress. When set for an entire document, it should be set on the root element (html element for HTML documents). + * The writing-mode CSS property sets whether lines of text are laid out horizontally or vertically, as well as the direction in which text flows. * * [MDN Reference](https://developer.mozilla.org/docs/Web/CSS/Reference/Properties/writing-mode) */ @@ -10334,7 +10405,7 @@ declare var CSSSupportsRule: { */ interface CSSTransformComponent { /** - * The **`is2D`** read-only property of the CSSTransformComponent interface indicates where the transform is 2D or 3D. + * The **`is2D`** property of the CSSTransformComponent interface indicates whether the transform is 2D or 3D. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSTransformComponent/is2D) */ @@ -10360,13 +10431,13 @@ declare var CSSTransformComponent: { */ interface CSSTransformValue extends CSSStyleValue { /** - * The read-only **`is2D`** property of the CSSTransformValue interface returns whether the transform is 2D or 3D. + * The **`is2D`** read-only property of the CSSTransformValue interface returns whether the transform is 2D or 3D. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSTransformValue/is2D) */ readonly is2D: boolean; /** - * The read-only **`length`** property of the CSSTransformValue interface returns the number of transform components in the list. + * The **`length`** read-only property of the CSSTransformValue interface returns the number of transform components in the list. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSTransformValue/length) */ @@ -10410,7 +10481,7 @@ declare var CSSTransition: { }; /** - * The **`CSSTranslate`** interface of the CSS Typed Object Model API represents the translate() value of the individual transform property in CSS. It inherits properties and methods from its parent CSSTransformValue. + * The **`CSSTranslate`** interface of the CSS Typed Object Model API represents the translate() value of the individual transform property in CSS. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSTranslate) */ @@ -10428,7 +10499,7 @@ interface CSSTranslate extends CSSTransformComponent { */ y: CSSNumericValue; /** - * The **`z`** property of the CSSTranslate interface representing the z-component of the translating vector. A positive value moves the element towards the viewer, and a negative value farther away. + * The **`z`** property of the CSSTranslate interface represents the z-component of the translating vector. A positive value moves the element towards the viewer, and a negative value farther away. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSTranslate/z) */ @@ -10447,13 +10518,13 @@ declare var CSSTranslate: { */ interface CSSUnitValue extends CSSNumericValue { /** - * The **`CSSUnitValue.unit`** read-only property of the CSSUnitValue interface returns a string indicating the unit type. + * The **`unit`** read-only property of the CSSUnitValue interface returns a string indicating the unit type. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSUnitValue/unit) */ readonly unit: string; /** - * The **`CSSUnitValue.value`** property of the CSSUnitValue interface returns a double indicating the number of units. + * The **`value`** property of the CSSUnitValue interface represents the number of units. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSUnitValue/value) */ @@ -10466,7 +10537,7 @@ declare var CSSUnitValue: { }; /** - * The **`CSSUnparsedValue`** interface of the CSS Typed Object Model API represents property values that reference custom properties. It consists of a list of string fragments and variable references. + * The **`CSSUnparsedValue`** interface of the CSS Typed Object Model API represents a property value that can't be parsed into a more specific type — typically the value of a custom property. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSUnparsedValue) */ @@ -10992,7 +11063,7 @@ declare var ChannelSplitterNode: { */ interface CharacterData extends Node, ChildNode, NonDocumentTypeChildNode { /** - * The **`data`** property of the CharacterData interface represent the value of the current object's data. + * The **`data`** property of the CharacterData interface represents the value of the current object's data. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CharacterData/data) */ @@ -12674,49 +12745,49 @@ interface DataTransfer { */ dropEffect: "none" | "copy" | "link" | "move"; /** - * The **`DataTransfer.effectAllowed`** property specifies the effect that is allowed for a drag operation. The copy operation is used to indicate that the data being dragged will be copied from its present location to the drop location. The move operation is used to indicate that the data being dragged will be moved, and the link operation is used to indicate that some form of relationship or connection will be created between the source and drop locations. + * The **`effectAllowed`** property of the DataTransfer interface specifies the effect that is allowed for a drag operation. The copy operation is used to indicate that the data being dragged will be copied from its present location to the drop location. The move operation is used to indicate that the data being dragged will be moved, and the link operation is used to indicate that some form of relationship or connection will be created between the source and drop locations. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/DataTransfer/effectAllowed) */ effectAllowed: "none" | "copy" | "copyLink" | "copyMove" | "link" | "linkMove" | "move" | "all" | "uninitialized"; /** - * The **`files`** read-only property of DataTransfer objects is a list of the files in the drag operation. If the operation includes no files, the list is empty. + * The **`files`** read-only property of the DataTransfer interface is a list of the files in the drag operation. If the operation includes no files, the list is empty. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/DataTransfer/files) */ readonly files: FileList; /** - * The read-only **`items`** property of the DataTransfer interface is a list of the data transfer items in a drag operation. The list includes one item for each item in the operation and if the operation had no items, the list is empty. + * The **`items`** read-only property of the DataTransfer interface is a DataTransferItemList of the DataTransferItem objects in a drag operation. The list includes one item for each item in the operation, and if the operation had no items, the list is empty. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/DataTransfer/items) */ readonly items: DataTransferItemList; /** - * The **`DataTransfer.types`** read-only property returns the available types that exist in the items. + * The **`types`** read-only property of the DataTransfer interface returns the available types that exist in the items. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/DataTransfer/types) */ readonly types: ReadonlyArray; /** - * The **`DataTransfer.clearData()`** method removes the drag operation's drag data for the given type. If data for the given type does not exist, this method does nothing. + * The **`clearData()`** method of the DataTransfer interface removes the drag operation's drag data for the given type. If data for the given type does not exist, this method does nothing. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/DataTransfer/clearData) */ clearData(format?: string): void; /** - * The **`DataTransfer.getData()`** method retrieves drag data (as a string) for the specified type. If the drag operation does not include data, this method returns an empty string. + * The **`getData()`** method of the DataTransfer interface retrieves drag data (as a string) for the specified type. If the drag operation does not include data, this method returns an empty string. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/DataTransfer/getData) */ getData(format: string): string; /** - * The **`DataTransfer.setData()`** method sets the drag operation's drag data to the specified data and type. If data for the given type does not exist, it is added at the end of the drag data store, such that the last item in the types list will be the new type. If data for the given type already exists, the existing data is replaced in the same position. That is, the order of the types list is not changed when replacing data of the same type. + * The **`setData()`** method of the DataTransfer interface sets the drag operation's drag data to the specified data and type. If data for the given type does not exist, it is added at the end of the drag data store, such that the last item in the types list will be the new type. If data for the given type already exists, the existing data is replaced in the same position. That is, the order of the types list is not changed when replacing data of the same type. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/DataTransfer/setData) */ setData(format: string, data: string): void; /** - * When a drag occurs, a translucent image is generated from the drag target (the element the dragstart event is fired at), and follows the mouse pointer during the drag. This image is created automatically, so you do not need to create it yourself. However, if a custom image is desired, the **`DataTransfer.setDragImage()`** method can be used to set the custom image to be used. The image will typically be an element but it can also be a or any other visible element. + * The **`setDragImage()`** method of the DataTransfer interface sets a custom image to use as drag feedback. The image will typically be an element but it can also be a or any other visible element. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/DataTransfer/setDragImage) */ @@ -12735,31 +12806,31 @@ declare var DataTransfer: { */ interface DataTransferItem { /** - * The read-only **`DataTransferItem.kind`** property returns the kind–a string or a file–of the DataTransferItem object representing the drag data item. + * The **`kind`** read-only property of the DataTransferItem interface returns the kind–a string or a file–of the object representing the drag data item. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/DataTransferItem/kind) */ readonly kind: string; /** - * The read-only **`DataTransferItem.type`** property returns the type (format) of the DataTransferItem object representing the drag data item. The type is a Unicode string generally given by a MIME type, although a MIME type is not required. + * The **`type`** read-only property of the DataTransferItem interface returns the type (format) of the object representing the drag data item. The type is a Unicode string generally given by a MIME type, although a MIME type is not required. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/DataTransferItem/type) */ readonly type: string; /** - * If the item is a file, the **`DataTransferItem.getAsFile()`** method returns the drag data item's File object. If the item is not a file, this method returns null. + * The **`getAsFile()`** method of the DataTransferItem interface returns the drag data item's File object if the item is a file. If the item is not a file, this method returns null. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/DataTransferItem/getAsFile) */ getAsFile(): File | null; /** - * The **`DataTransferItem.getAsString()`** method invokes the given callback with the drag data item's string data as the argument if the item's kind is a Plain unicode string (i.e., kind is string). + * The **`getAsString()`** method of the DataTransferItem interface invokes the given callback with the drag data item's string data as the argument if the item's kind is a Plain unicode string (i.e., kind is string). * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/DataTransferItem/getAsString) */ getAsString(callback: FunctionStringCallback | null): void; /** - * If the item described by the DataTransferItem is a file, **`webkitGetAsEntry()`** returns a FileSystemFileEntry or FileSystemDirectoryEntry representing it. If the item isn't a file, null is returned. + * The **`webkitGetAsEntry()`** method of the DataTransferItem interface returns a FileSystemFileEntry or FileSystemDirectoryEntry representing the item if it is a file. If the item isn't a file, null is returned. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/DataTransferItem/webkitGetAsEntry) */ @@ -12778,26 +12849,26 @@ declare var DataTransferItem: { */ interface DataTransferItemList { /** - * The read-only **`length`** property of the DataTransferItemList interface returns the number of items currently in the drag item list. + * The **`length`** read-only property of the DataTransferItemList interface returns the number of items currently in the drag item list. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/DataTransferItemList/length) */ readonly length: number; /** - * The **`DataTransferItemList.add()`** method creates a new DataTransferItem using the specified data and adds it to the drag data list. The item may be a File or a string of a given type. If the item is successfully added to the list, the newly-created DataTransferItem object is returned. + * The **`add()`** method of the DataTransferItemList interface creates a new DataTransferItem using the specified data and adds it to the drag data list. The item may be a File or a string of a given type. If the item is successfully added to the list, the newly-created DataTransferItem object is returned. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/DataTransferItemList/add) */ add(data: string, type: string): DataTransferItem | null; add(data: File): DataTransferItem | null; /** - * The DataTransferItemList method **`clear()`** removes all DataTransferItem objects from the drag data items list, leaving the list empty. + * The **`clear()`** method of the DataTransferItemList interface removes all DataTransferItem objects from the drag data items list, leaving the list empty. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/DataTransferItemList/clear) */ clear(): void; /** - * The **`DataTransferItemList.remove()`** method removes the DataTransferItem at the specified index from the list. If the index is less than zero or greater than one less than the length of the list, the list will not be changed. + * The **`remove()`** method of the DataTransferItemList interface removes the DataTransferItem at the specified index from the list. If the index is less than zero or greater than one less than the length of the list, the list will not be changed. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/DataTransferItemList/remove) */ @@ -12882,6 +12953,12 @@ interface DeviceMotionEvent extends Event { declare var DeviceMotionEvent: { prototype: DeviceMotionEvent; new(type: string, eventInitDict?: DeviceMotionEventInit): DeviceMotionEvent; + /** + * The **`requestPermission()`** static method of the DeviceMotionEvent interface requests the user's permission to access device motion data from the accelerometer and gyroscope sensors. This method requires transient activation, meaning that it must be triggered by a UI event such as a button click. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/DeviceMotionEvent/requestPermission_static) + */ + requestPermission(): Promise; }; /** @@ -12974,6 +13051,12 @@ interface DeviceOrientationEvent extends Event { declare var DeviceOrientationEvent: { prototype: DeviceOrientationEvent; new(type: string, eventInitDict?: DeviceOrientationEventInit): DeviceOrientationEvent; + /** + * The **`requestPermission()`** static method of the DeviceOrientationEvent interface requests the user's permission to access device orientation data from the accelerometer and gyroscope sensors. It can also request permission to access magnetometer data when absolute orientation is needed. This method requires transient activation, meaning that it must be triggered by a UI event such as a button click. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/DeviceOrientationEvent/requestPermission_static) + */ + requestPermission(absolute?: boolean): Promise; }; /** Available only in secure contexts. */ @@ -13182,7 +13265,7 @@ interface Document extends Node, DocumentOrShadowRoot, FontFaceSource, GlobalEve */ readonly head: HTMLHeadElement; /** - * The **`Document.hidden`** read-only property returns a Boolean value indicating if the page is considered hidden or not. + * The **`Document.hidden`** read-only property returns a Boolean value indicating if the page is considered hidden or not. This can be used to check whether the document is in the background or in a minimized window, or is otherwise not visible to the user. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Document/hidden) */ @@ -13245,7 +13328,7 @@ interface Document extends Node, DocumentOrShadowRoot, FontFaceSource, GlobalEve onvisibilitychange: ((this: Document, ev: Event) => any) | null; readonly ownerDocument: null; /** - * The read-only **`pictureInPictureEnabled`** property of the Document interface indicates whether or not picture-in-picture mode is available. + * The **`pictureInPictureEnabled`** read-only property of the Document interface indicates whether or not picture-in-picture mode is available. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Document/pictureInPictureEnabled) */ @@ -13482,7 +13565,7 @@ interface Document extends Node, DocumentOrShadowRoot, FontFaceSource, GlobalEve */ createNodeIterator(root: Node, whatToShow?: number, filter?: NodeFilter | null): NodeIterator; /** - * **`createProcessingInstruction()`** generates a new processing instruction node and returns it. + * The **`createProcessingInstruction()`** method of the Document interface creates a new ProcessingInstruction object and returns it. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Document/createProcessingInstruction) */ @@ -13519,7 +13602,7 @@ interface Document extends Node, DocumentOrShadowRoot, FontFaceSource, GlobalEve */ exitFullscreen(): Promise; /** - * The **`exitPictureInPicture()`** method of the Document interface requests that a video contained in this document, which is currently floating, be taken out of picture-in-picture mode, restoring the previous state of the screen. This usually reverses the effects of a previous call to HTMLVideoElement.requestPictureInPicture(). + * The **`exitPictureInPicture()`** method of the Document interface requests that a video contained in this document, which is currently floating, be taken out of picture-in-picture mode. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Document/exitPictureInPicture) */ @@ -13629,7 +13712,7 @@ interface Document extends Node, DocumentOrShadowRoot, FontFaceSource, GlobalEve */ requestStorageAccess(): Promise; /** - * The **`startViewTransition()`** method of the Document interface starts a new same-document (SPA) view transition and returns a ViewTransition object to represent it. + * The **`startViewTransition()`** method of the Document interface starts a new same-document (SPA), document-scoped view transition and returns a ViewTransition object to represent it. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Document/startViewTransition) */ @@ -13659,6 +13742,12 @@ interface Document extends Node, DocumentOrShadowRoot, FontFaceSource, GlobalEve declare var Document: { prototype: Document; new(): Document; + /** + * The **`parseHTML()`** static method of the Document object provides an XSS-safe method to parse and sanitize a string of HTML in order to create a new Document instance. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Document/parseHTML_static) + */ + parseHTML(html: string, options?: SetHTMLOptions): Document; /** * The **`parseHTMLUnsafe()`** static method of the Document object is used to parse HTML input, optionally filtering unwanted HTML elements and attributes, in order to create a new Document instance. * @@ -13712,7 +13801,7 @@ interface DocumentOrShadowRoot { */ readonly fullscreenElement: Element | null; /** - * The read-only **`pictureInPictureElement`** property of the Document interface returns the Element that is currently being presented in picture-in-picture mode in this document, or null if picture-in-picture mode is not currently in use. + * The **`pictureInPictureElement`** read-only property of the Document interface returns the Element that is currently being presented in picture-in-picture mode in this document, or null if picture-in-picture mode is not currently in use. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Document/pictureInPictureElement) */ @@ -13864,7 +13953,7 @@ declare var DragEvent: { }; /** - * The **`DynamicsCompressorNode`** interface provides a compression effect, which lowers the volume of the loudest parts of the signal in order to help prevent clipping and distortion that can occur when multiple sounds are played and multiplexed together at once. This is often used in musical production and game audio. DynamicsCompressorNode is an AudioNode that has exactly one input and one output. + * The **`DynamicsCompressorNode`** interface provides a compression effect, which lowers the volume of the loudest parts of a signal. Compression can help prevent clipping and distortion when multiple sounds are combined, and it is also used in music production and game audio for dynamic control, tone shaping, and creative effects. DynamicsCompressorNode is an AudioNode that has exactly one input and one output. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/DynamicsCompressorNode) */ @@ -13951,7 +14040,7 @@ interface EXT_float_blend { } /** - * The **`EXT_frag_depth`** extension is part of the WebGL API and enables to set a depth value of a fragment from within the fragment shader. + * The **`EXT_frag_depth`** extension is part of the WebGL API and enables you to set a depth value of a fragment from within the fragment shader. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/EXT_frag_depth) */ @@ -14185,13 +14274,13 @@ interface Element extends Node, ARIAMixin, Animatable, ChildNode, NonDocumentTyp */ readonly tagName: string; /** - * The **`Element.attachShadow()`** method attaches a shadow DOM tree to the specified element and returns a reference to its ShadowRoot. + * The **`attachShadow()`** method of the Element interface attaches a shadow DOM tree to the specified element and returns a reference to its ShadowRoot. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/attachShadow) */ attachShadow(init: ShadowRootInit): ShadowRoot; /** - * The **`checkVisibility()`** method of the Element interface checks whether the element is visible. + * The **`checkVisibility()`** method of the Element interface checks whether the element is potentially visible. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/checkVisibility) */ @@ -14212,13 +14301,13 @@ interface Element extends Node, ARIAMixin, Animatable, ChildNode, NonDocumentTyp */ computedStyleMap(): StylePropertyMapReadOnly; /** - * The **`getAttribute()`** method of the Element interface returns the value of a specified attribute on the element. + * The **`getAttribute()`** method of the Element interface returns the string value of the specified attribute of the specified element. It returns null if the element doesn't have an attribute with the given name. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/getAttribute) */ getAttribute(qualifiedName: string): string | null; /** - * The **`getAttributeNS()`** method of the Element interface returns the string value of the attribute with the specified namespace and name. If the named attribute does not exist, the value returned will either be null or "" (the empty string); see Notes for details. + * The **`getAttributeNS()`** method of the Element interface returns the string value of the specified namespaced attribute of the specified element. It returns null if the element doesn't have an attribute with the given name in the namespace. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/getAttributeNS) */ @@ -14230,13 +14319,13 @@ interface Element extends Node, ARIAMixin, Animatable, ChildNode, NonDocumentTyp */ getAttributeNames(): string[]; /** - * Returns the specified attribute of the specified element, as an Attr node. + * The **`getAttributeNode()`** method of the Element interface returns the specified attribute of the specified element, as an Attr node. It returns null if the element doesn't have an attribute with the given name. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/getAttributeNode) */ getAttributeNode(qualifiedName: string): Attr | null; /** - * The **`getAttributeNodeNS()`** method of the Element interface returns the namespaced Attr node of an element. + * The **`getAttributeNodeNS()`** method of the Element interface returns the specified namespaced attribute of the specified element, as an Attr node. It returns null if the element doesn't have an attribute with the given name in the namespace. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/getAttributeNodeNS) */ @@ -14361,7 +14450,7 @@ interface Element extends Node, ARIAMixin, Animatable, ChildNode, NonDocumentTyp */ removeAttributeNode(attr: Attr): Attr; /** - * The **`Element.requestFullscreen()`** method issues an asynchronous request to make the element be displayed in fullscreen mode. + * The **`requestFullscreen()`** method of the Element interface issues an asynchronous request to display the element in fullscreen mode. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/requestFullscreen) */ @@ -14373,7 +14462,7 @@ interface Element extends Node, ARIAMixin, Animatable, ChildNode, NonDocumentTyp */ requestPointerLock(options?: PointerLockOptions): Promise; /** - * The **`scroll()`** method of the Element interface scrolls the element to a particular set of coordinates inside a given element. + * The **`scroll()`** method of the Element interface scrolls to a particular set of coordinates inside a given element. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/scroll) */ @@ -14387,7 +14476,7 @@ interface Element extends Node, ARIAMixin, Animatable, ChildNode, NonDocumentTyp scrollBy(options?: ScrollToOptions): void; scrollBy(x: number, y: number): void; /** - * The Element interface's **`scrollIntoView()`** method scrolls the element's ancestor containers such that the element on which scrollIntoView() is called is visible to the user. + * The **`scrollIntoView()`** method of the Element interface scrolls the element's ancestor containers such that the element on which scrollIntoView() is called is visible to the user. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/scrollIntoView) */ @@ -17770,6 +17859,7 @@ declare var HTMLBaseElement: { }; interface HTMLBodyElementEventMap extends HTMLElementEventMap, WindowEventHandlersEventMap { + "orientationchange": Event; } /** @@ -17787,6 +17877,8 @@ interface HTMLBodyElement extends HTMLElement, WindowEventHandlers { /** @deprecated */ link: string; /** @deprecated */ + onorientationchange: ((this: HTMLBodyElement, ev: Event) => any) | null; + /** @deprecated */ text: string; /** @deprecated */ vLink: string; @@ -18114,7 +18206,7 @@ declare var HTMLDataListElement: { */ interface HTMLDetailsElement extends HTMLElement { /** - * The **`name`** property of the HTMLDetailsElement interface reflects the name attribute of
elements. It enables multiple
elements to be connected together, where only one for the
elements can be open at once. This allows developers to easily create UI features such as accordions without scripting. + * The **`name`** property of the HTMLDetailsElement interface reflects the name attribute of
elements. It enables multiple
elements to be connected together, where only one of the
elements can be open at once. This allows developers to easily create UI features such as accordions without scripting. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLDetailsElement/name) */ @@ -19393,13 +19485,13 @@ interface HTMLInputElement extends HTMLElement, PopoverTargetAttributes { */ selectionDirection: SelectionDirection | null; /** - * The **`selectionEnd`** property of the HTMLInputElement interface is a number that represents the end index of the selected text. That is, it represents the index of the character immediately following the selection. Likewise, when there is no selection, this returns the offset of the character immediately following the current text input cursor position. + * The **`selectionEnd`** property of the HTMLInputElement interface specifies the end position of the current text selection in an element. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLInputElement/selectionEnd) */ selectionEnd: number | null; /** - * The **`selectionStart`** property of the HTMLInputElement interface is a number that represents the beginning index of the selected text. When nothing is selected, then returns the position of the text input cursor (caret) inside of the element. + * The **`selectionStart`** property of the HTMLInputElement interface specifies the start position of the current text selection in an element. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLInputElement/selectionStart) */ @@ -19594,7 +19686,7 @@ interface HTMLLabelElement extends HTMLElement { */ readonly form: HTMLFormElement | null; /** - * The **`HTMLLabelElement.htmlFor`** property reflects the value of the for content property. That means that this script-accessible property is used to set and read the value of the content property for, which is the ID of the label's associated control element. + * The **`htmlFor`** property of the HTMLLabelElement interface is the ID of the associated label's control element. It reflects the value of, and is used to set and get the for content attribute. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLLabelElement/htmlFor) */ @@ -19611,7 +19703,7 @@ declare var HTMLLabelElement: { }; /** - * The **`HTMLLegendElement`** is an interface allowing to access properties of the elements. It inherits properties and methods from the HTMLElement interface. + * The **`HTMLLegendElement`** is an interface allowing you to access properties of the elements. It inherits properties and methods from the HTMLElement interface. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLLegendElement) */ @@ -19693,7 +19785,7 @@ interface HTMLLinkElement extends HTMLElement, LinkStyle { */ imageSizes: string; /** - * The **`imageSrcset`** property of the HTMLLinkElement interface is a string which identifies one or more comma-separated image candidate strings. This property reflects the value of the element's imagesrcset attribute. This property can retrieved or set the imagesrcset attribute value. + * The **`imageSrcset`** property of the HTMLLinkElement interface is a string which identifies one or more comma-separated image candidate strings. This property reflects the value of the element's imagesrcset attribute. This property can retrieve or set the imagesrcset attribute value. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLLinkElement/imageSrcset) */ @@ -21105,6 +21197,23 @@ declare var HTMLSelectElement: { new(): HTMLSelectElement; }; +/** + * The **`HTMLSelectedContentElement`** interface represents a element in the DOM. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLSelectedContentElement) + */ +interface HTMLSelectedContentElement extends HTMLElement { + addEventListener(type: K, listener: (this: HTMLSelectedContentElement, ev: HTMLElementEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void; + addEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | AddEventListenerOptions): void; + removeEventListener(type: K, listener: (this: HTMLSelectedContentElement, ev: HTMLElementEventMap[K]) => any, options?: boolean | EventListenerOptions): void; + removeEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | EventListenerOptions): void; +} + +declare var HTMLSelectedContentElement: { + prototype: HTMLSelectedContentElement; + new(): HTMLSelectedContentElement; +}; + /** * The **`HTMLSlotElement`** interface of the Shadow DOM API enables access to the name and assigned nodes of an HTML element. * @@ -21479,7 +21588,7 @@ interface HTMLTableElement extends HTMLElement { */ border: string; /** - * The **`HTMLTableElement.caption`** property represents the table caption. If no caption element is associated with the table, this property is null. + * The **`caption`** property of the HTMLTableElement interface represents the first element child of the given , or null if no such element exists. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLTableElement/caption) */ @@ -21506,7 +21615,7 @@ interface HTMLTableElement extends HTMLElement { */ frame: string; /** - * The read-only HTMLTableElement property **`rows`** returns a live HTMLCollection of all the rows in the table, including the rows contained within any , , and elements. + * The **`rows`** read-only property of the HTMLTableElement interface returns a live HTMLCollection of all elements that are a child of the given
element, or a child of one of the table's , , and children. The members of the appear first, followed by members of the and the table itself, and members of the come last, sorted by tree order within each group. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLTableElement/rows) */ @@ -21526,19 +21635,19 @@ interface HTMLTableElement extends HTMLElement { */ summary: string; /** - * The **`HTMLTableElement.tBodies`** read-only property returns a live HTMLCollection of the bodies in a
. + * The **`tBodies`** read-only property of the HTMLTableElement interface returns a live HTMLCollection of all element children of the given
. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLTableElement/tBodies) */ readonly tBodies: HTMLCollectionOf; /** - * The **`HTMLTableElement.tFoot`** property represents the element of a
. Its value will be null if there is no such element. + * The **`tFoot`** property of the HTMLTableElement interface represents the first element child of the given
, or null if no such element exists. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLTableElement/tFoot) */ tFoot: HTMLTableSectionElement | null; /** - * The **`HTMLTableElement.tHead`** represents the element of a
. Its value will be null if there is no such element. + * The **`tHead`** property of the HTMLTableElement interface represents the first element child of the given
, or null if no such element exists. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLTableElement/tHead) */ @@ -21551,55 +21660,55 @@ interface HTMLTableElement extends HTMLElement { */ width: string; /** - * The **`HTMLTableElement.createCaption()`** method returns the
element associated with a given . If no
element exists on the table, this method creates it, and then returns it. + * The **`createCaption()`** method of the HTMLTableElement interface creates a element, inserts it as the first child of the given , and returns it. If the table already has a element associated with a given
element child, this method returns the first such child without creating one. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLTableElement/createCaption) */ createCaption(): HTMLTableCaptionElement; /** - * The **`createTBody()`** method of HTMLTableElement objects creates and returns a new
. + * The **`createTBody()`** method of the HTMLTableElement interface creates a element, inserts it immediately after the last element child of the given
, or as the last child if there is no such element, and returns it. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLTableElement/createTBody) */ createTBody(): HTMLTableSectionElement; /** - * The **`createTFoot()`** method of HTMLTableElement objects returns the element associated with a given
. If no footer exists in the table, this method creates it, and then returns it. + * The **`createTFoot()`** method of the HTMLTableElement interface creates a element, inserts it as the last child of the given
, and returns it. If the table already has a element child, this method returns the first such child without creating one. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLTableElement/createTFoot) */ createTFoot(): HTMLTableSectionElement; /** - * The **`createTHead()`** method of HTMLTableElement objects returns the element associated with a given
. If no header exists in the table, this method creates it, and then returns it. + * The **`createTHead()`** method of the HTMLTableElement interface creates a element, inserts it before the first element child of the given
that's neither a , or as the last child if no such insertion location is found, and returns it. If the table already has a element child, this method returns the first such child without creating one. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLTableElement/createTHead) */ createTHead(): HTMLTableSectionElement; /** - * The **`HTMLTableElement.deleteCaption()`** method removes the
nor a element from a given . If there is no
element associated with the table, this method does nothing. + * The **`deleteCaption()`** method of the HTMLTableElement interface removes the first element child from a given , if any. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLTableElement/deleteCaption) */ deleteCaption(): void; /** - * The **`HTMLTableElement.deleteRow()`** method removes a specific row () from a given
. + * The **`deleteRow()`** method of the HTMLTableElement interface removes a specific row () from a given
. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLTableElement/deleteRow) */ deleteRow(index: number): void; /** - * The **`HTMLTableElement.deleteTFoot()`** method removes the element from a given
. + * The **`deleteTFoot()`** method of the HTMLTableElement interface removes the first element child from a given
, if any. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLTableElement/deleteTFoot) */ deleteTFoot(): void; /** - * The **`HTMLTableElement.deleteTHead()`** removes the element from a given
. + * The **`deleteTHead()`** method of the HTMLTableElement interface removes the first element child from a given
, if any. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLTableElement/deleteTHead) */ deleteTHead(): void; /** - * The **`insertRow()`** method of the HTMLTableElement interface inserts a new row () in a given
, and returns a reference to the new row. + * The **`insertRow()`** method of the HTMLTableElement interface creates a element, inserts it at the specified position in the rows collection, and returns it. If the rows collection is empty and the table also has no elements, a element is first created and inserted. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLTableElement/insertRow) */ @@ -21689,7 +21798,7 @@ interface HTMLTableRowElement extends HTMLElement { */ deleteCell(index: number): void; /** - * The **`insertCell()`** method of the HTMLTableRowElement interface inserts a new cell () and returns a reference to the cell. + * The **`insertCell()`** method of the HTMLTableRowElement interface creates a element, and returns it. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLTableRowElement/insertCell) */ @@ -21746,13 +21855,13 @@ interface HTMLTableSectionElement extends HTMLElement { */ vAlign: string; /** - * The **`deleteRow()`** method of the HTMLTableSectionElement interface removes a specific row () from a given
. + * The **`deleteRow()`** method of the HTMLTableSectionElement interface removes a specific row (
) from the given table sectioning element (, , or ). * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLTableSectionElement/deleteRow) */ deleteRow(index: number): void; /** - * The **`insertRow()`** method of the HTMLTableSectionElement interface inserts a new row () in the given table sectioning element (, , or ), then returns a reference to this new row. + * The **`insertRow()`** method of the HTMLTableSectionElement interface creates a element, inserts it at the specified position in the given table sectioning element (, , or ), and returns it. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLTableSectionElement/insertRow) */ @@ -21810,6 +21919,12 @@ interface HTMLTemplateElement extends HTMLElement { * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLTemplateElement/shadowRootSerializable) */ shadowRootSerializable: boolean; + /** + * The **`shadowRootSlotAssignment`** property of the HTMLTemplateElement interface indicates whether the element has been configured to use named or unnamed slot assignment. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLTemplateElement/shadowRootSlotAssignment) + */ + shadowRootSlotAssignment: string; addEventListener(type: K, listener: (this: HTMLTemplateElement, ev: HTMLElementEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void; addEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | AddEventListenerOptions): void; removeEventListener(type: K, listener: (this: HTMLTemplateElement, ev: HTMLElementEventMap[K]) => any, options?: boolean | EventListenerOptions): void; @@ -21918,13 +22033,13 @@ interface HTMLTextAreaElement extends HTMLElement { */ selectionDirection: SelectionDirection; /** - * The **`selectionEnd`** property of the HTMLTextAreaElement interface specifies the end position of the current text selection in a
) into a table row (
element, inserts it at the specified position in the given