@types/web 0.0.317 → 0.0.319

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -47,4 +47,4 @@ Prior to `@types/web` the web APIs were deployed with a version of TypeScript, a
47
47
 
48
48
  ## Deploy Metadata
49
49
 
50
- You can read what changed in version 0.0.317 at https://github.com/microsoft/TypeScript-DOM-lib-generator/releases/tag/%40types%2Fweb%400.0.317.
50
+ You can read what changed in version 0.0.319 at https://github.com/microsoft/TypeScript-DOM-lib-generator/releases/tag/%40types%2Fweb%400.0.319.
package/index.d.ts CHANGED
@@ -2279,6 +2279,31 @@ interface SVGBoundingBoxOptions {
2279
2279
  stroke?: boolean;
2280
2280
  }
2281
2281
 
2282
+ interface SanitizerAttributeNamespace {
2283
+ name: string;
2284
+ namespace?: string | null;
2285
+ }
2286
+
2287
+ interface SanitizerConfig {
2288
+ attributes?: SanitizerAttribute[];
2289
+ comments?: boolean;
2290
+ dataAttributes?: boolean;
2291
+ elements?: SanitizerElementWithAttributes[];
2292
+ removeAttributes?: SanitizerAttribute[];
2293
+ removeElements?: SanitizerElement[];
2294
+ replaceWithChildrenElements?: SanitizerElement[];
2295
+ }
2296
+
2297
+ interface SanitizerElementNamespace {
2298
+ name: string;
2299
+ namespace?: string | null;
2300
+ }
2301
+
2302
+ interface SanitizerElementNamespaceWithAttributes extends SanitizerElementNamespace {
2303
+ attributes?: SanitizerAttribute[];
2304
+ removeAttributes?: SanitizerAttribute[];
2305
+ }
2306
+
2282
2307
  interface SchedulerPostTaskOptions {
2283
2308
  delay?: number;
2284
2309
  priority?: TaskPriority;
@@ -6267,7 +6292,11 @@ interface CSSStyleProperties extends CSSStyleDeclarationBase {
6267
6292
  * [MDN Reference](https://developer.mozilla.org/docs/Web/CSS/Reference/Properties/anchor-name)
6268
6293
  */
6269
6294
  anchorName: string;
6270
- /** The anchor-scope CSS property can be used to limit the scope in which a positioned element can be associated with anchor elements to a particular subtree. */
6295
+ /**
6296
+ * The anchor-scope CSS property can be used to limit the scope in which a positioned element can be associated with anchor elements to a particular subtree.
6297
+ *
6298
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/CSS/Reference/Properties/anchor-scope)
6299
+ */
6271
6300
  anchorScope: string;
6272
6301
  /**
6273
6302
  * 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.
@@ -7277,7 +7306,6 @@ interface CSSStyleProperties extends CSSStyleDeclarationBase {
7277
7306
  fontSizeAdjust: string;
7278
7307
  /**
7279
7308
  * The font-stretch CSS property selects a normal, condensed, or expanded face from a font.
7280
- * @deprecated
7281
7309
  *
7282
7310
  * [MDN Reference](https://developer.mozilla.org/docs/Web/CSS/Reference/Properties/font-stretch)
7283
7311
  */
@@ -8689,6 +8717,12 @@ interface CSSStyleProperties extends CSSStyleDeclarationBase {
8689
8717
  * [MDN Reference](https://developer.mozilla.org/docs/Web/CSS/Reference/Properties/text-indent)
8690
8718
  */
8691
8719
  textIndent: string;
8720
+ /**
8721
+ * The text-justify CSS property sets what type of justification should be applied to text when text-align: justify; is set on an element.
8722
+ *
8723
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/CSS/Reference/Properties/text-justify)
8724
+ */
8725
+ textJustify: string;
8692
8726
  /**
8693
8727
  * The text-orientation CSS property sets the orientation of the text characters in a line. It only affects text in vertical mode (when writing-mode is not horizontal-tb). It is useful for controlling the display of languages that use vertical script, and also for making vertical table headers.
8694
8728
  *
@@ -26402,11 +26436,16 @@ interface PerformanceEventMap {
26402
26436
  */
26403
26437
  interface Performance extends EventTarget {
26404
26438
  /**
26405
- * The read-only **`performance.eventCounts`** property is an EventCounts map containing the number of events which have been dispatched per event type.
26439
+ * The read-only **`performance.eventCounts`** property is an EventCounts map containing the number of events which have been dispatched per event type since the page was loaded.
26406
26440
  *
26407
26441
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Performance/eventCounts)
26408
26442
  */
26409
26443
  readonly eventCounts: EventCounts;
26444
+ /**
26445
+ * The read-only **`performance.interactionCount`** property represents the number of real-user interactions that have occurred on the page since it was loaded.
26446
+ *
26447
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Performance/interactionCount)
26448
+ */
26410
26449
  readonly interactionCount: number;
26411
26450
  /**
26412
26451
  * The legacy **`Performance.navigation`** read-only property returns a PerformanceNavigation object representing the type of navigation that occurs in the given browsing context, such as the number of redirections needed to fetch the resource.
@@ -28034,6 +28073,7 @@ interface RTCDtlsTransport extends EventTarget {
28034
28073
  readonly iceTransport: RTCIceTransport;
28035
28074
  /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/RTCDtlsTransport/error_event) */
28036
28075
  onerror: ((this: RTCDtlsTransport, ev: RTCErrorEvent) => any) | null;
28076
+ /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/RTCDtlsTransport/statechange_event) */
28037
28077
  onstatechange: ((this: RTCDtlsTransport, ev: Event) => any) | null;
28038
28078
  /**
28039
28079
  * The **`state`** read-only property of the RTCDtlsTransport interface provides information which describes a Datagram Transport Layer Security (DTLS) transport state.
@@ -33519,6 +33559,69 @@ declare var SVGViewElement: {
33519
33559
  new(): SVGViewElement;
33520
33560
  };
33521
33561
 
33562
+ /** The **`Sanitizer`** interface of the HTML Sanitizer API defines a configuration object that specifies what elements, attributes and comments are allowed or should be removed when inserting strings of HTML into an Element or ShadowRoot, or when parsing an HTML string into a Document. */
33563
+ interface Sanitizer {
33564
+ /**
33565
+ * The **`allowAttribute()`** method of the Sanitizer interface sets an attribute to be allowed on all elements when the sanitizer is used.
33566
+ *
33567
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Sanitizer/allowAttribute)
33568
+ */
33569
+ allowAttribute(attribute: SanitizerAttribute): boolean;
33570
+ /**
33571
+ * The **`allowElement()`** method of the Sanitizer interface sets that the specified element is allowed in the output when the sanitizer is used.
33572
+ *
33573
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Sanitizer/allowElement)
33574
+ */
33575
+ allowElement(element: SanitizerElementWithAttributes): boolean;
33576
+ /**
33577
+ * The **`get()`** method of the Sanitizer interface returns a SanitizerConfig dictionary instance that represents the current Sanitizer configuration.
33578
+ *
33579
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Sanitizer/get)
33580
+ */
33581
+ get(): SanitizerConfig;
33582
+ /**
33583
+ * The **`removeAttribute()`** method of the Sanitizer interface sets an attribute to be removed from all elements when the sanitizer is used.
33584
+ *
33585
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Sanitizer/removeAttribute)
33586
+ */
33587
+ removeAttribute(attribute: SanitizerAttribute): boolean;
33588
+ /**
33589
+ * The **`removeElement()`** method of the Sanitizer interface sets the specified element be removed from the output when the sanitizer is used.
33590
+ *
33591
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Sanitizer/removeElement)
33592
+ */
33593
+ removeElement(element: SanitizerElement): boolean;
33594
+ /**
33595
+ * The **`removeUnsafe()`** method of the Sanitizer interface configures the sanitizer configuration so that it will remove all elements, attributes, and event handler content attributes that are considered XSS-unsafe by the browser.
33596
+ *
33597
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Sanitizer/removeUnsafe)
33598
+ */
33599
+ removeUnsafe(): boolean;
33600
+ /**
33601
+ * The **`replaceElementWithChildren()`** method of the Sanitizer interface sets an element to be replaced by its child HTML elements when the sanitizer is used. This is primarily used for stripping styles from text.
33602
+ *
33603
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Sanitizer/replaceElementWithChildren)
33604
+ */
33605
+ replaceElementWithChildren(element: SanitizerElement): boolean;
33606
+ /**
33607
+ * The **`setComments()`** method of the Sanitizer interface sets whether comments will be allowed or removed by the sanitizer.
33608
+ *
33609
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Sanitizer/setComments)
33610
+ */
33611
+ setComments(allow: boolean): boolean;
33612
+ /**
33613
+ * The **`setDataAttributes()`** method of the Sanitizer interface sets whether all data-* attributes will be allowed by the sanitizer, or if they must be individually specified.
33614
+ *
33615
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Sanitizer/setDataAttributes)
33616
+ */
33617
+ setDataAttributes(allow: boolean): boolean;
33618
+ }
33619
+
33620
+ declare var Sanitizer: {
33621
+ prototype: Sanitizer;
33622
+ new(configuration?: SanitizerConfig | SanitizerPresets): Sanitizer;
33623
+ };
33624
+
33522
33625
  /**
33523
33626
  * The **`Scheduler`** interface of the Prioritized Task Scheduling API provides methods for scheduling prioritized tasks.
33524
33627
  *
@@ -41483,6 +41586,8 @@ declare namespace WebAssembly {
41483
41586
  * [MDN Reference](https://developer.mozilla.org/docs/WebAssembly/Reference/JavaScript_interface/Memory/grow)
41484
41587
  */
41485
41588
  grow(delta: AddressValue): AddressValue;
41589
+ toFixedLengthBuffer(): ArrayBuffer;
41590
+ toResizableBuffer(): ArrayBuffer;
41486
41591
  }
41487
41592
 
41488
41593
  var Memory: {
@@ -43093,6 +43198,9 @@ type ReadableStreamReader<T> = ReadableStreamDefaultReader<T> | ReadableStreamBY
43093
43198
  type RenderingContext = CanvasRenderingContext2D | ImageBitmapRenderingContext | WebGLRenderingContext | WebGL2RenderingContext;
43094
43199
  type ReportList = Report[];
43095
43200
  type RequestInfo = Request | string;
43201
+ type SanitizerAttribute = string | SanitizerAttributeNamespace;
43202
+ type SanitizerElement = string | SanitizerElementNamespace;
43203
+ type SanitizerElementWithAttributes = string | SanitizerElementNamespaceWithAttributes;
43096
43204
  type SelectionDirection = "forward" | "backward" | "none";
43097
43205
  type TexImageSource = ImageBitmap | ImageData | HTMLImageElement | HTMLCanvasElement | HTMLVideoElement | OffscreenCanvas | VideoFrame;
43098
43206
  type TimerHandler = string | Function;
@@ -43280,6 +43388,7 @@ type ResidentKeyRequirement = "discouraged" | "preferred" | "required";
43280
43388
  type ResizeObserverBoxOptions = "border-box" | "content-box" | "device-pixel-content-box";
43281
43389
  type ResizeQuality = "high" | "low" | "medium" | "pixelated";
43282
43390
  type ResponseType = "basic" | "cors" | "default" | "error" | "opaque" | "opaqueredirect";
43391
+ type SanitizerPresets = "default";
43283
43392
  type ScrollAxis = "block" | "inline" | "x" | "y";
43284
43393
  type ScrollBehavior = "auto" | "instant" | "smooth";
43285
43394
  type ScrollLogicalPosition = "center" | "end" | "nearest" | "start";
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@types/web",
3
- "version": "0.0.317",
3
+ "version": "0.0.319",
4
4
  "description": "Types for the DOM, and other web technologies in browsers",
5
5
  "license": "Apache-2.0",
6
6
  "contributors": [],
package/ts5.5/index.d.ts CHANGED
@@ -2276,6 +2276,31 @@ interface SVGBoundingBoxOptions {
2276
2276
  stroke?: boolean;
2277
2277
  }
2278
2278
 
2279
+ interface SanitizerAttributeNamespace {
2280
+ name: string;
2281
+ namespace?: string | null;
2282
+ }
2283
+
2284
+ interface SanitizerConfig {
2285
+ attributes?: SanitizerAttribute[];
2286
+ comments?: boolean;
2287
+ dataAttributes?: boolean;
2288
+ elements?: SanitizerElementWithAttributes[];
2289
+ removeAttributes?: SanitizerAttribute[];
2290
+ removeElements?: SanitizerElement[];
2291
+ replaceWithChildrenElements?: SanitizerElement[];
2292
+ }
2293
+
2294
+ interface SanitizerElementNamespace {
2295
+ name: string;
2296
+ namespace?: string | null;
2297
+ }
2298
+
2299
+ interface SanitizerElementNamespaceWithAttributes extends SanitizerElementNamespace {
2300
+ attributes?: SanitizerAttribute[];
2301
+ removeAttributes?: SanitizerAttribute[];
2302
+ }
2303
+
2279
2304
  interface SchedulerPostTaskOptions {
2280
2305
  delay?: number;
2281
2306
  priority?: TaskPriority;
@@ -6257,7 +6282,11 @@ interface CSSStyleProperties extends CSSStyleDeclarationBase {
6257
6282
  * [MDN Reference](https://developer.mozilla.org/docs/Web/CSS/Reference/Properties/anchor-name)
6258
6283
  */
6259
6284
  anchorName: string;
6260
- /** The anchor-scope CSS property can be used to limit the scope in which a positioned element can be associated with anchor elements to a particular subtree. */
6285
+ /**
6286
+ * The anchor-scope CSS property can be used to limit the scope in which a positioned element can be associated with anchor elements to a particular subtree.
6287
+ *
6288
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/CSS/Reference/Properties/anchor-scope)
6289
+ */
6261
6290
  anchorScope: string;
6262
6291
  /**
6263
6292
  * 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.
@@ -7267,7 +7296,6 @@ interface CSSStyleProperties extends CSSStyleDeclarationBase {
7267
7296
  fontSizeAdjust: string;
7268
7297
  /**
7269
7298
  * The font-stretch CSS property selects a normal, condensed, or expanded face from a font.
7270
- * @deprecated
7271
7299
  *
7272
7300
  * [MDN Reference](https://developer.mozilla.org/docs/Web/CSS/Reference/Properties/font-stretch)
7273
7301
  */
@@ -8679,6 +8707,12 @@ interface CSSStyleProperties extends CSSStyleDeclarationBase {
8679
8707
  * [MDN Reference](https://developer.mozilla.org/docs/Web/CSS/Reference/Properties/text-indent)
8680
8708
  */
8681
8709
  textIndent: string;
8710
+ /**
8711
+ * The text-justify CSS property sets what type of justification should be applied to text when text-align: justify; is set on an element.
8712
+ *
8713
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/CSS/Reference/Properties/text-justify)
8714
+ */
8715
+ textJustify: string;
8682
8716
  /**
8683
8717
  * The text-orientation CSS property sets the orientation of the text characters in a line. It only affects text in vertical mode (when writing-mode is not horizontal-tb). It is useful for controlling the display of languages that use vertical script, and also for making vertical table headers.
8684
8718
  *
@@ -26378,11 +26412,16 @@ interface PerformanceEventMap {
26378
26412
  */
26379
26413
  interface Performance extends EventTarget {
26380
26414
  /**
26381
- * The read-only **`performance.eventCounts`** property is an EventCounts map containing the number of events which have been dispatched per event type.
26415
+ * The read-only **`performance.eventCounts`** property is an EventCounts map containing the number of events which have been dispatched per event type since the page was loaded.
26382
26416
  *
26383
26417
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Performance/eventCounts)
26384
26418
  */
26385
26419
  readonly eventCounts: EventCounts;
26420
+ /**
26421
+ * The read-only **`performance.interactionCount`** property represents the number of real-user interactions that have occurred on the page since it was loaded.
26422
+ *
26423
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Performance/interactionCount)
26424
+ */
26386
26425
  readonly interactionCount: number;
26387
26426
  /**
26388
26427
  * The legacy **`Performance.navigation`** read-only property returns a PerformanceNavigation object representing the type of navigation that occurs in the given browsing context, such as the number of redirections needed to fetch the resource.
@@ -28010,6 +28049,7 @@ interface RTCDtlsTransport extends EventTarget {
28010
28049
  readonly iceTransport: RTCIceTransport;
28011
28050
  /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/RTCDtlsTransport/error_event) */
28012
28051
  onerror: ((this: RTCDtlsTransport, ev: RTCErrorEvent) => any) | null;
28052
+ /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/RTCDtlsTransport/statechange_event) */
28013
28053
  onstatechange: ((this: RTCDtlsTransport, ev: Event) => any) | null;
28014
28054
  /**
28015
28055
  * The **`state`** read-only property of the RTCDtlsTransport interface provides information which describes a Datagram Transport Layer Security (DTLS) transport state.
@@ -33494,6 +33534,69 @@ declare var SVGViewElement: {
33494
33534
  new(): SVGViewElement;
33495
33535
  };
33496
33536
 
33537
+ /** The **`Sanitizer`** interface of the HTML Sanitizer API defines a configuration object that specifies what elements, attributes and comments are allowed or should be removed when inserting strings of HTML into an Element or ShadowRoot, or when parsing an HTML string into a Document. */
33538
+ interface Sanitizer {
33539
+ /**
33540
+ * The **`allowAttribute()`** method of the Sanitizer interface sets an attribute to be allowed on all elements when the sanitizer is used.
33541
+ *
33542
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Sanitizer/allowAttribute)
33543
+ */
33544
+ allowAttribute(attribute: SanitizerAttribute): boolean;
33545
+ /**
33546
+ * The **`allowElement()`** method of the Sanitizer interface sets that the specified element is allowed in the output when the sanitizer is used.
33547
+ *
33548
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Sanitizer/allowElement)
33549
+ */
33550
+ allowElement(element: SanitizerElementWithAttributes): boolean;
33551
+ /**
33552
+ * The **`get()`** method of the Sanitizer interface returns a SanitizerConfig dictionary instance that represents the current Sanitizer configuration.
33553
+ *
33554
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Sanitizer/get)
33555
+ */
33556
+ get(): SanitizerConfig;
33557
+ /**
33558
+ * The **`removeAttribute()`** method of the Sanitizer interface sets an attribute to be removed from all elements when the sanitizer is used.
33559
+ *
33560
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Sanitizer/removeAttribute)
33561
+ */
33562
+ removeAttribute(attribute: SanitizerAttribute): boolean;
33563
+ /**
33564
+ * The **`removeElement()`** method of the Sanitizer interface sets the specified element be removed from the output when the sanitizer is used.
33565
+ *
33566
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Sanitizer/removeElement)
33567
+ */
33568
+ removeElement(element: SanitizerElement): boolean;
33569
+ /**
33570
+ * The **`removeUnsafe()`** method of the Sanitizer interface configures the sanitizer configuration so that it will remove all elements, attributes, and event handler content attributes that are considered XSS-unsafe by the browser.
33571
+ *
33572
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Sanitizer/removeUnsafe)
33573
+ */
33574
+ removeUnsafe(): boolean;
33575
+ /**
33576
+ * The **`replaceElementWithChildren()`** method of the Sanitizer interface sets an element to be replaced by its child HTML elements when the sanitizer is used. This is primarily used for stripping styles from text.
33577
+ *
33578
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Sanitizer/replaceElementWithChildren)
33579
+ */
33580
+ replaceElementWithChildren(element: SanitizerElement): boolean;
33581
+ /**
33582
+ * The **`setComments()`** method of the Sanitizer interface sets whether comments will be allowed or removed by the sanitizer.
33583
+ *
33584
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Sanitizer/setComments)
33585
+ */
33586
+ setComments(allow: boolean): boolean;
33587
+ /**
33588
+ * The **`setDataAttributes()`** method of the Sanitizer interface sets whether all data-* attributes will be allowed by the sanitizer, or if they must be individually specified.
33589
+ *
33590
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Sanitizer/setDataAttributes)
33591
+ */
33592
+ setDataAttributes(allow: boolean): boolean;
33593
+ }
33594
+
33595
+ declare var Sanitizer: {
33596
+ prototype: Sanitizer;
33597
+ new(configuration?: SanitizerConfig | SanitizerPresets): Sanitizer;
33598
+ };
33599
+
33497
33600
  /**
33498
33601
  * The **`Scheduler`** interface of the Prioritized Task Scheduling API provides methods for scheduling prioritized tasks.
33499
33602
  *
@@ -41457,6 +41560,8 @@ declare namespace WebAssembly {
41457
41560
  * [MDN Reference](https://developer.mozilla.org/docs/WebAssembly/Reference/JavaScript_interface/Memory/grow)
41458
41561
  */
41459
41562
  grow(delta: AddressValue): AddressValue;
41563
+ toFixedLengthBuffer(): ArrayBuffer;
41564
+ toResizableBuffer(): ArrayBuffer;
41460
41565
  }
41461
41566
 
41462
41567
  var Memory: {
@@ -43067,6 +43172,9 @@ type ReadableStreamReader<T> = ReadableStreamDefaultReader<T> | ReadableStreamBY
43067
43172
  type RenderingContext = CanvasRenderingContext2D | ImageBitmapRenderingContext | WebGLRenderingContext | WebGL2RenderingContext;
43068
43173
  type ReportList = Report[];
43069
43174
  type RequestInfo = Request | string;
43175
+ type SanitizerAttribute = string | SanitizerAttributeNamespace;
43176
+ type SanitizerElement = string | SanitizerElementNamespace;
43177
+ type SanitizerElementWithAttributes = string | SanitizerElementNamespaceWithAttributes;
43070
43178
  type SelectionDirection = "forward" | "backward" | "none";
43071
43179
  type TexImageSource = ImageBitmap | ImageData | HTMLImageElement | HTMLCanvasElement | HTMLVideoElement | OffscreenCanvas | VideoFrame;
43072
43180
  type TimerHandler = string | Function;
@@ -43254,6 +43362,7 @@ type ResidentKeyRequirement = "discouraged" | "preferred" | "required";
43254
43362
  type ResizeObserverBoxOptions = "border-box" | "content-box" | "device-pixel-content-box";
43255
43363
  type ResizeQuality = "high" | "low" | "medium" | "pixelated";
43256
43364
  type ResponseType = "basic" | "cors" | "default" | "error" | "opaque" | "opaqueredirect";
43365
+ type SanitizerPresets = "default";
43257
43366
  type ScrollAxis = "block" | "inline" | "x" | "y";
43258
43367
  type ScrollBehavior = "auto" | "instant" | "smooth";
43259
43368
  type ScrollLogicalPosition = "center" | "end" | "nearest" | "start";
package/ts5.6/index.d.ts CHANGED
@@ -2276,6 +2276,31 @@ interface SVGBoundingBoxOptions {
2276
2276
  stroke?: boolean;
2277
2277
  }
2278
2278
 
2279
+ interface SanitizerAttributeNamespace {
2280
+ name: string;
2281
+ namespace?: string | null;
2282
+ }
2283
+
2284
+ interface SanitizerConfig {
2285
+ attributes?: SanitizerAttribute[];
2286
+ comments?: boolean;
2287
+ dataAttributes?: boolean;
2288
+ elements?: SanitizerElementWithAttributes[];
2289
+ removeAttributes?: SanitizerAttribute[];
2290
+ removeElements?: SanitizerElement[];
2291
+ replaceWithChildrenElements?: SanitizerElement[];
2292
+ }
2293
+
2294
+ interface SanitizerElementNamespace {
2295
+ name: string;
2296
+ namespace?: string | null;
2297
+ }
2298
+
2299
+ interface SanitizerElementNamespaceWithAttributes extends SanitizerElementNamespace {
2300
+ attributes?: SanitizerAttribute[];
2301
+ removeAttributes?: SanitizerAttribute[];
2302
+ }
2303
+
2279
2304
  interface SchedulerPostTaskOptions {
2280
2305
  delay?: number;
2281
2306
  priority?: TaskPriority;
@@ -6264,7 +6289,11 @@ interface CSSStyleProperties extends CSSStyleDeclarationBase {
6264
6289
  * [MDN Reference](https://developer.mozilla.org/docs/Web/CSS/Reference/Properties/anchor-name)
6265
6290
  */
6266
6291
  anchorName: string;
6267
- /** The anchor-scope CSS property can be used to limit the scope in which a positioned element can be associated with anchor elements to a particular subtree. */
6292
+ /**
6293
+ * The anchor-scope CSS property can be used to limit the scope in which a positioned element can be associated with anchor elements to a particular subtree.
6294
+ *
6295
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/CSS/Reference/Properties/anchor-scope)
6296
+ */
6268
6297
  anchorScope: string;
6269
6298
  /**
6270
6299
  * 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.
@@ -7274,7 +7303,6 @@ interface CSSStyleProperties extends CSSStyleDeclarationBase {
7274
7303
  fontSizeAdjust: string;
7275
7304
  /**
7276
7305
  * The font-stretch CSS property selects a normal, condensed, or expanded face from a font.
7277
- * @deprecated
7278
7306
  *
7279
7307
  * [MDN Reference](https://developer.mozilla.org/docs/Web/CSS/Reference/Properties/font-stretch)
7280
7308
  */
@@ -8686,6 +8714,12 @@ interface CSSStyleProperties extends CSSStyleDeclarationBase {
8686
8714
  * [MDN Reference](https://developer.mozilla.org/docs/Web/CSS/Reference/Properties/text-indent)
8687
8715
  */
8688
8716
  textIndent: string;
8717
+ /**
8718
+ * The text-justify CSS property sets what type of justification should be applied to text when text-align: justify; is set on an element.
8719
+ *
8720
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/CSS/Reference/Properties/text-justify)
8721
+ */
8722
+ textJustify: string;
8689
8723
  /**
8690
8724
  * The text-orientation CSS property sets the orientation of the text characters in a line. It only affects text in vertical mode (when writing-mode is not horizontal-tb). It is useful for controlling the display of languages that use vertical script, and also for making vertical table headers.
8691
8725
  *
@@ -26399,11 +26433,16 @@ interface PerformanceEventMap {
26399
26433
  */
26400
26434
  interface Performance extends EventTarget {
26401
26435
  /**
26402
- * The read-only **`performance.eventCounts`** property is an EventCounts map containing the number of events which have been dispatched per event type.
26436
+ * The read-only **`performance.eventCounts`** property is an EventCounts map containing the number of events which have been dispatched per event type since the page was loaded.
26403
26437
  *
26404
26438
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Performance/eventCounts)
26405
26439
  */
26406
26440
  readonly eventCounts: EventCounts;
26441
+ /**
26442
+ * The read-only **`performance.interactionCount`** property represents the number of real-user interactions that have occurred on the page since it was loaded.
26443
+ *
26444
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Performance/interactionCount)
26445
+ */
26407
26446
  readonly interactionCount: number;
26408
26447
  /**
26409
26448
  * The legacy **`Performance.navigation`** read-only property returns a PerformanceNavigation object representing the type of navigation that occurs in the given browsing context, such as the number of redirections needed to fetch the resource.
@@ -28031,6 +28070,7 @@ interface RTCDtlsTransport extends EventTarget {
28031
28070
  readonly iceTransport: RTCIceTransport;
28032
28071
  /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/RTCDtlsTransport/error_event) */
28033
28072
  onerror: ((this: RTCDtlsTransport, ev: RTCErrorEvent) => any) | null;
28073
+ /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/RTCDtlsTransport/statechange_event) */
28034
28074
  onstatechange: ((this: RTCDtlsTransport, ev: Event) => any) | null;
28035
28075
  /**
28036
28076
  * The **`state`** read-only property of the RTCDtlsTransport interface provides information which describes a Datagram Transport Layer Security (DTLS) transport state.
@@ -33516,6 +33556,69 @@ declare var SVGViewElement: {
33516
33556
  new(): SVGViewElement;
33517
33557
  };
33518
33558
 
33559
+ /** The **`Sanitizer`** interface of the HTML Sanitizer API defines a configuration object that specifies what elements, attributes and comments are allowed or should be removed when inserting strings of HTML into an Element or ShadowRoot, or when parsing an HTML string into a Document. */
33560
+ interface Sanitizer {
33561
+ /**
33562
+ * The **`allowAttribute()`** method of the Sanitizer interface sets an attribute to be allowed on all elements when the sanitizer is used.
33563
+ *
33564
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Sanitizer/allowAttribute)
33565
+ */
33566
+ allowAttribute(attribute: SanitizerAttribute): boolean;
33567
+ /**
33568
+ * The **`allowElement()`** method of the Sanitizer interface sets that the specified element is allowed in the output when the sanitizer is used.
33569
+ *
33570
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Sanitizer/allowElement)
33571
+ */
33572
+ allowElement(element: SanitizerElementWithAttributes): boolean;
33573
+ /**
33574
+ * The **`get()`** method of the Sanitizer interface returns a SanitizerConfig dictionary instance that represents the current Sanitizer configuration.
33575
+ *
33576
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Sanitizer/get)
33577
+ */
33578
+ get(): SanitizerConfig;
33579
+ /**
33580
+ * The **`removeAttribute()`** method of the Sanitizer interface sets an attribute to be removed from all elements when the sanitizer is used.
33581
+ *
33582
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Sanitizer/removeAttribute)
33583
+ */
33584
+ removeAttribute(attribute: SanitizerAttribute): boolean;
33585
+ /**
33586
+ * The **`removeElement()`** method of the Sanitizer interface sets the specified element be removed from the output when the sanitizer is used.
33587
+ *
33588
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Sanitizer/removeElement)
33589
+ */
33590
+ removeElement(element: SanitizerElement): boolean;
33591
+ /**
33592
+ * The **`removeUnsafe()`** method of the Sanitizer interface configures the sanitizer configuration so that it will remove all elements, attributes, and event handler content attributes that are considered XSS-unsafe by the browser.
33593
+ *
33594
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Sanitizer/removeUnsafe)
33595
+ */
33596
+ removeUnsafe(): boolean;
33597
+ /**
33598
+ * The **`replaceElementWithChildren()`** method of the Sanitizer interface sets an element to be replaced by its child HTML elements when the sanitizer is used. This is primarily used for stripping styles from text.
33599
+ *
33600
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Sanitizer/replaceElementWithChildren)
33601
+ */
33602
+ replaceElementWithChildren(element: SanitizerElement): boolean;
33603
+ /**
33604
+ * The **`setComments()`** method of the Sanitizer interface sets whether comments will be allowed or removed by the sanitizer.
33605
+ *
33606
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Sanitizer/setComments)
33607
+ */
33608
+ setComments(allow: boolean): boolean;
33609
+ /**
33610
+ * The **`setDataAttributes()`** method of the Sanitizer interface sets whether all data-* attributes will be allowed by the sanitizer, or if they must be individually specified.
33611
+ *
33612
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Sanitizer/setDataAttributes)
33613
+ */
33614
+ setDataAttributes(allow: boolean): boolean;
33615
+ }
33616
+
33617
+ declare var Sanitizer: {
33618
+ prototype: Sanitizer;
33619
+ new(configuration?: SanitizerConfig | SanitizerPresets): Sanitizer;
33620
+ };
33621
+
33519
33622
  /**
33520
33623
  * The **`Scheduler`** interface of the Prioritized Task Scheduling API provides methods for scheduling prioritized tasks.
33521
33624
  *
@@ -41480,6 +41583,8 @@ declare namespace WebAssembly {
41480
41583
  * [MDN Reference](https://developer.mozilla.org/docs/WebAssembly/Reference/JavaScript_interface/Memory/grow)
41481
41584
  */
41482
41585
  grow(delta: AddressValue): AddressValue;
41586
+ toFixedLengthBuffer(): ArrayBuffer;
41587
+ toResizableBuffer(): ArrayBuffer;
41483
41588
  }
41484
41589
 
41485
41590
  var Memory: {
@@ -43090,6 +43195,9 @@ type ReadableStreamReader<T> = ReadableStreamDefaultReader<T> | ReadableStreamBY
43090
43195
  type RenderingContext = CanvasRenderingContext2D | ImageBitmapRenderingContext | WebGLRenderingContext | WebGL2RenderingContext;
43091
43196
  type ReportList = Report[];
43092
43197
  type RequestInfo = Request | string;
43198
+ type SanitizerAttribute = string | SanitizerAttributeNamespace;
43199
+ type SanitizerElement = string | SanitizerElementNamespace;
43200
+ type SanitizerElementWithAttributes = string | SanitizerElementNamespaceWithAttributes;
43093
43201
  type SelectionDirection = "forward" | "backward" | "none";
43094
43202
  type TexImageSource = ImageBitmap | ImageData | HTMLImageElement | HTMLCanvasElement | HTMLVideoElement | OffscreenCanvas | VideoFrame;
43095
43203
  type TimerHandler = string | Function;
@@ -43277,6 +43385,7 @@ type ResidentKeyRequirement = "discouraged" | "preferred" | "required";
43277
43385
  type ResizeObserverBoxOptions = "border-box" | "content-box" | "device-pixel-content-box";
43278
43386
  type ResizeQuality = "high" | "low" | "medium" | "pixelated";
43279
43387
  type ResponseType = "basic" | "cors" | "default" | "error" | "opaque" | "opaqueredirect";
43388
+ type SanitizerPresets = "default";
43280
43389
  type ScrollAxis = "block" | "inline" | "x" | "y";
43281
43390
  type ScrollBehavior = "auto" | "instant" | "smooth";
43282
43391
  type ScrollLogicalPosition = "center" | "end" | "nearest" | "start";
package/ts5.9/index.d.ts CHANGED
@@ -2276,6 +2276,31 @@ interface SVGBoundingBoxOptions {
2276
2276
  stroke?: boolean;
2277
2277
  }
2278
2278
 
2279
+ interface SanitizerAttributeNamespace {
2280
+ name: string;
2281
+ namespace?: string | null;
2282
+ }
2283
+
2284
+ interface SanitizerConfig {
2285
+ attributes?: SanitizerAttribute[];
2286
+ comments?: boolean;
2287
+ dataAttributes?: boolean;
2288
+ elements?: SanitizerElementWithAttributes[];
2289
+ removeAttributes?: SanitizerAttribute[];
2290
+ removeElements?: SanitizerElement[];
2291
+ replaceWithChildrenElements?: SanitizerElement[];
2292
+ }
2293
+
2294
+ interface SanitizerElementNamespace {
2295
+ name: string;
2296
+ namespace?: string | null;
2297
+ }
2298
+
2299
+ interface SanitizerElementNamespaceWithAttributes extends SanitizerElementNamespace {
2300
+ attributes?: SanitizerAttribute[];
2301
+ removeAttributes?: SanitizerAttribute[];
2302
+ }
2303
+
2279
2304
  interface SchedulerPostTaskOptions {
2280
2305
  delay?: number;
2281
2306
  priority?: TaskPriority;
@@ -6264,7 +6289,11 @@ interface CSSStyleProperties extends CSSStyleDeclarationBase {
6264
6289
  * [MDN Reference](https://developer.mozilla.org/docs/Web/CSS/Reference/Properties/anchor-name)
6265
6290
  */
6266
6291
  anchorName: string;
6267
- /** The anchor-scope CSS property can be used to limit the scope in which a positioned element can be associated with anchor elements to a particular subtree. */
6292
+ /**
6293
+ * The anchor-scope CSS property can be used to limit the scope in which a positioned element can be associated with anchor elements to a particular subtree.
6294
+ *
6295
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/CSS/Reference/Properties/anchor-scope)
6296
+ */
6268
6297
  anchorScope: string;
6269
6298
  /**
6270
6299
  * 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.
@@ -7274,7 +7303,6 @@ interface CSSStyleProperties extends CSSStyleDeclarationBase {
7274
7303
  fontSizeAdjust: string;
7275
7304
  /**
7276
7305
  * The font-stretch CSS property selects a normal, condensed, or expanded face from a font.
7277
- * @deprecated
7278
7306
  *
7279
7307
  * [MDN Reference](https://developer.mozilla.org/docs/Web/CSS/Reference/Properties/font-stretch)
7280
7308
  */
@@ -8686,6 +8714,12 @@ interface CSSStyleProperties extends CSSStyleDeclarationBase {
8686
8714
  * [MDN Reference](https://developer.mozilla.org/docs/Web/CSS/Reference/Properties/text-indent)
8687
8715
  */
8688
8716
  textIndent: string;
8717
+ /**
8718
+ * The text-justify CSS property sets what type of justification should be applied to text when text-align: justify; is set on an element.
8719
+ *
8720
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/CSS/Reference/Properties/text-justify)
8721
+ */
8722
+ textJustify: string;
8689
8723
  /**
8690
8724
  * The text-orientation CSS property sets the orientation of the text characters in a line. It only affects text in vertical mode (when writing-mode is not horizontal-tb). It is useful for controlling the display of languages that use vertical script, and also for making vertical table headers.
8691
8725
  *
@@ -26399,11 +26433,16 @@ interface PerformanceEventMap {
26399
26433
  */
26400
26434
  interface Performance extends EventTarget {
26401
26435
  /**
26402
- * The read-only **`performance.eventCounts`** property is an EventCounts map containing the number of events which have been dispatched per event type.
26436
+ * The read-only **`performance.eventCounts`** property is an EventCounts map containing the number of events which have been dispatched per event type since the page was loaded.
26403
26437
  *
26404
26438
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Performance/eventCounts)
26405
26439
  */
26406
26440
  readonly eventCounts: EventCounts;
26441
+ /**
26442
+ * The read-only **`performance.interactionCount`** property represents the number of real-user interactions that have occurred on the page since it was loaded.
26443
+ *
26444
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Performance/interactionCount)
26445
+ */
26407
26446
  readonly interactionCount: number;
26408
26447
  /**
26409
26448
  * The legacy **`Performance.navigation`** read-only property returns a PerformanceNavigation object representing the type of navigation that occurs in the given browsing context, such as the number of redirections needed to fetch the resource.
@@ -28031,6 +28070,7 @@ interface RTCDtlsTransport extends EventTarget {
28031
28070
  readonly iceTransport: RTCIceTransport;
28032
28071
  /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/RTCDtlsTransport/error_event) */
28033
28072
  onerror: ((this: RTCDtlsTransport, ev: RTCErrorEvent) => any) | null;
28073
+ /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/RTCDtlsTransport/statechange_event) */
28034
28074
  onstatechange: ((this: RTCDtlsTransport, ev: Event) => any) | null;
28035
28075
  /**
28036
28076
  * The **`state`** read-only property of the RTCDtlsTransport interface provides information which describes a Datagram Transport Layer Security (DTLS) transport state.
@@ -33516,6 +33556,69 @@ declare var SVGViewElement: {
33516
33556
  new(): SVGViewElement;
33517
33557
  };
33518
33558
 
33559
+ /** The **`Sanitizer`** interface of the HTML Sanitizer API defines a configuration object that specifies what elements, attributes and comments are allowed or should be removed when inserting strings of HTML into an Element or ShadowRoot, or when parsing an HTML string into a Document. */
33560
+ interface Sanitizer {
33561
+ /**
33562
+ * The **`allowAttribute()`** method of the Sanitizer interface sets an attribute to be allowed on all elements when the sanitizer is used.
33563
+ *
33564
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Sanitizer/allowAttribute)
33565
+ */
33566
+ allowAttribute(attribute: SanitizerAttribute): boolean;
33567
+ /**
33568
+ * The **`allowElement()`** method of the Sanitizer interface sets that the specified element is allowed in the output when the sanitizer is used.
33569
+ *
33570
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Sanitizer/allowElement)
33571
+ */
33572
+ allowElement(element: SanitizerElementWithAttributes): boolean;
33573
+ /**
33574
+ * The **`get()`** method of the Sanitizer interface returns a SanitizerConfig dictionary instance that represents the current Sanitizer configuration.
33575
+ *
33576
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Sanitizer/get)
33577
+ */
33578
+ get(): SanitizerConfig;
33579
+ /**
33580
+ * The **`removeAttribute()`** method of the Sanitizer interface sets an attribute to be removed from all elements when the sanitizer is used.
33581
+ *
33582
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Sanitizer/removeAttribute)
33583
+ */
33584
+ removeAttribute(attribute: SanitizerAttribute): boolean;
33585
+ /**
33586
+ * The **`removeElement()`** method of the Sanitizer interface sets the specified element be removed from the output when the sanitizer is used.
33587
+ *
33588
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Sanitizer/removeElement)
33589
+ */
33590
+ removeElement(element: SanitizerElement): boolean;
33591
+ /**
33592
+ * The **`removeUnsafe()`** method of the Sanitizer interface configures the sanitizer configuration so that it will remove all elements, attributes, and event handler content attributes that are considered XSS-unsafe by the browser.
33593
+ *
33594
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Sanitizer/removeUnsafe)
33595
+ */
33596
+ removeUnsafe(): boolean;
33597
+ /**
33598
+ * The **`replaceElementWithChildren()`** method of the Sanitizer interface sets an element to be replaced by its child HTML elements when the sanitizer is used. This is primarily used for stripping styles from text.
33599
+ *
33600
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Sanitizer/replaceElementWithChildren)
33601
+ */
33602
+ replaceElementWithChildren(element: SanitizerElement): boolean;
33603
+ /**
33604
+ * The **`setComments()`** method of the Sanitizer interface sets whether comments will be allowed or removed by the sanitizer.
33605
+ *
33606
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Sanitizer/setComments)
33607
+ */
33608
+ setComments(allow: boolean): boolean;
33609
+ /**
33610
+ * The **`setDataAttributes()`** method of the Sanitizer interface sets whether all data-* attributes will be allowed by the sanitizer, or if they must be individually specified.
33611
+ *
33612
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Sanitizer/setDataAttributes)
33613
+ */
33614
+ setDataAttributes(allow: boolean): boolean;
33615
+ }
33616
+
33617
+ declare var Sanitizer: {
33618
+ prototype: Sanitizer;
33619
+ new(configuration?: SanitizerConfig | SanitizerPresets): Sanitizer;
33620
+ };
33621
+
33519
33622
  /**
33520
33623
  * The **`Scheduler`** interface of the Prioritized Task Scheduling API provides methods for scheduling prioritized tasks.
33521
33624
  *
@@ -41480,6 +41583,8 @@ declare namespace WebAssembly {
41480
41583
  * [MDN Reference](https://developer.mozilla.org/docs/WebAssembly/Reference/JavaScript_interface/Memory/grow)
41481
41584
  */
41482
41585
  grow(delta: AddressValue): AddressValue;
41586
+ toFixedLengthBuffer(): ArrayBuffer;
41587
+ toResizableBuffer(): ArrayBuffer;
41483
41588
  }
41484
41589
 
41485
41590
  var Memory: {
@@ -43090,6 +43195,9 @@ type ReadableStreamReader<T> = ReadableStreamDefaultReader<T> | ReadableStreamBY
43090
43195
  type RenderingContext = CanvasRenderingContext2D | ImageBitmapRenderingContext | WebGLRenderingContext | WebGL2RenderingContext;
43091
43196
  type ReportList = Report[];
43092
43197
  type RequestInfo = Request | string;
43198
+ type SanitizerAttribute = string | SanitizerAttributeNamespace;
43199
+ type SanitizerElement = string | SanitizerElementNamespace;
43200
+ type SanitizerElementWithAttributes = string | SanitizerElementNamespaceWithAttributes;
43093
43201
  type SelectionDirection = "forward" | "backward" | "none";
43094
43202
  type TexImageSource = ImageBitmap | ImageData | HTMLImageElement | HTMLCanvasElement | HTMLVideoElement | OffscreenCanvas | VideoFrame;
43095
43203
  type TimerHandler = string | Function;
@@ -43277,6 +43385,7 @@ type ResidentKeyRequirement = "discouraged" | "preferred" | "required";
43277
43385
  type ResizeObserverBoxOptions = "border-box" | "content-box" | "device-pixel-content-box";
43278
43386
  type ResizeQuality = "high" | "low" | "medium" | "pixelated";
43279
43387
  type ResponseType = "basic" | "cors" | "default" | "error" | "opaque" | "opaqueredirect";
43388
+ type SanitizerPresets = "default";
43280
43389
  type ScrollAxis = "block" | "inline" | "x" | "y";
43281
43390
  type ScrollBehavior = "auto" | "instant" | "smooth";
43282
43391
  type ScrollLogicalPosition = "center" | "end" | "nearest" | "start";