@sbb-esta/lyne-elements 3.11.0 → 3.12.1

package/custom-elements.json

@@ -2493,6 +2493,17 @@
               "description": "Whether the user is required to make a selection when they're interacting with the\nautocomplete. If the user moves away from the autocomplete without selecting an option from\nthe list, the value will be reset. If the user opens the panel and closes it without\ninteracting or selecting a value, the initial value will be kept.",
               "attribute": "require-selection"
             },
+            {
+              "kind": "field",
+              "name": "position",
+              "type": {
+                "text": "'auto' | 'above' | 'below'"
+              },
+              "privacy": "public",
+              "default": "'auto'",
+              "description": "The position of the autocomplete panel relative to the trigger.",
+              "attribute": "position"
+            },
             {
               "kind": "field",
               "name": "originElement",
@@ -3259,6 +3270,15 @@
               "description": "Whether the user is required to make a selection when they're interacting with the\nautocomplete. If the user moves away from the autocomplete without selecting an option from\nthe list, the value will be reset. If the user opens the panel and closes it without\ninteracting or selecting a value, the initial value will be kept.",
               "fieldName": "requireSelection"
             },
+            {
+              "name": "position",
+              "type": {
+                "text": "'auto' | 'above' | 'below'"
+              },
+              "default": "'auto'",
+              "description": "The position of the autocomplete panel relative to the trigger.",
+              "fieldName": "position"
+            },
             {
               "name": "negative",
               "type": {
@@ -3719,6 +3739,21 @@
                 "module": "autocomplete/autocomplete-base-element.js"
               }
             },
+            {
+              "kind": "field",
+              "name": "position",
+              "type": {
+                "text": "'auto' | 'above' | 'below'"
+              },
+              "privacy": "public",
+              "default": "'auto'",
+              "description": "The position of the autocomplete panel relative to the trigger.",
+              "attribute": "position",
+              "inheritedFrom": {
+                "name": "SbbAutocompleteBaseElement",
+                "module": "autocomplete/autocomplete-base-element.js"
+              }
+            },
             {
               "kind": "field",
               "name": "originElement",
@@ -4476,6 +4511,19 @@
                 "name": "SbbAutocompleteBaseElement",
                 "module": "autocomplete/autocomplete-base-element.js"
               }
+            },
+            {
+              "name": "position",
+              "type": {
+                "text": "'auto' | 'above' | 'below'"
+              },
+              "default": "'auto'",
+              "description": "The position of the autocomplete panel relative to the trigger.",
+              "fieldName": "position",
+              "inheritedFrom": {
+                "name": "SbbAutocompleteBaseElement",
+                "module": "autocomplete/autocomplete-base-element.js"
+              }
             }
           ],
           "events": [
@@ -8729,6 +8777,64 @@
                 "module": "core/mixins/form-associated-input-mixin.js"
               }
             },
+            {
+              "kind": "method",
+              "name": "_requiresEmptyPatch",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "boolean"
+                }
+              },
+              "inheritedFrom": {
+                "name": "SbbFormAssociatedInputMixin",
+                "module": "core/mixins/form-associated-input-mixin.js"
+              }
+            },
+            {
+              "kind": "method",
+              "name": "_assignValue",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "value",
+                  "type": {
+                    "text": "string"
+                  }
+                }
+              ],
+              "inheritedFrom": {
+                "name": "SbbFormAssociatedInputMixin",
+                "module": "core/mixins/form-associated-input-mixin.js"
+              }
+            },
+            {
+              "kind": "method",
+              "name": "_setCursorAt",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "position",
+                  "type": {
+                    "text": "number"
+                  }
+                }
+              ],
+              "inheritedFrom": {
+                "name": "SbbFormAssociatedInputMixin",
+                "module": "core/mixins/form-associated-input-mixin.js"
+              }
+            },
             {
               "kind": "method",
               "name": "_cleanText",
@@ -14681,13 +14787,22 @@
                 "text": "(T = string | string[]) | null"
               },
               "privacy": "public",
-              "default": "null",
               "description": "Value of the form element.",
               "attribute": "value",
               "inheritedFrom": {
                 "name": "SbbFormAssociatedMixin",
                 "module": "core/mixins/form-associated-mixin.js"
-              }
+              },
+              "default": "null"
+            },
+            {
+              "kind": "field",
+              "name": "_value",
+              "type": {
+                "text": "T | T[] | null"
+              },
+              "privacy": "private",
+              "default": "null"
             },
             {
               "kind": "field",
@@ -14832,21 +14947,21 @@
             },
             {
               "kind": "field",
-              "name": "_options",
+              "name": "_isValueManuallyAssigned",
               "type": {
-                "text": "SbbOptionElement<T>[]"
+                "text": "boolean"
               },
               "privacy": "private",
-              "description": "Gets all the SbbOptionElement projected in the select.",
-              "readonly": true
+              "default": "false"
             },
             {
               "kind": "field",
-              "name": "_filteredOptions",
+              "name": "options",
               "type": {
                 "text": "SbbOptionElement<T>[]"
               },
-              "privacy": "private",
+              "privacy": "public",
+              "description": "Returns all SbbOptionElements from this sbb-select instance.",
               "readonly": true
             },
             {
@@ -14910,6 +15025,16 @@
               },
               "description": "Gets the current displayed value."
             },
+            {
+              "kind": "method",
+              "name": "_selectableOptions",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "SbbOptionElement<T>[]"
+                }
+              }
+            },
             {
               "kind": "method",
               "name": "_onOptionChanged",
@@ -14956,15 +15081,7 @@
                 "type": {
                   "text": "void"
                 }
-              },
-              "parameters": [
-                {
-                  "name": "selected",
-                  "type": {
-                    "text": "SbbOptionElement<T> | SbbOptionElement<T>[] | null"
-                  }
-                }
-              ]
+              }
             },
             {
               "kind": "method",
@@ -15006,40 +15123,17 @@
             },
             {
               "kind": "method",
-              "name": "_onValueChanged",
-              "privacy": "private",
-              "return": {
-                "type": {
-                  "text": "void"
-                }
-              },
-              "parameters": [
-                {
-                  "name": "newValue",
-                  "type": {
-                    "text": "T | T[]"
-                  }
-                }
-              ],
-              "description": "Sets the _displayValue by checking the internal sbb-options and setting the correct `selected` value on them."
-            },
-            {
-              "kind": "method",
-              "name": "_readFormData",
-              "privacy": "private",
+              "name": "formState",
+              "privacy": "protected",
               "return": {
                 "type": {
-                  "text": "Promise<T[]>"
+                  "text": "FormRestoreState"
                 }
               },
-              "parameters": [
-                {
-                  "name": "formData",
-                  "type": {
-                    "text": "FormData"
-                  }
-                }
-              ]
+              "inheritedFrom": {
+                "name": "SbbFormAssociatedMixin",
+                "module": "core/mixins/form-associated-mixin.js"
+              }
             },
             {
               "kind": "method",
@@ -15180,7 +15274,7 @@
               },
               "parameters": [
                 {
-                  "name": "optionSelectionChange",
+                  "name": "option",
                   "type": {
                     "text": "SbbOptionElement<T>"
                   }
@@ -15427,7 +15521,27 @@
             },
             {
               "kind": "method",
-              "name": "_setValueFromSelected",
+              "name": "_updateOptionsFromValue",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "_updateValueFromOptions",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "_onSlotChange",
               "privacy": "private",
               "return": {
                 "type": {
@@ -15907,20 +16021,6 @@
                 "module": "core/mixins/form-associated-mixin.js"
               }
             },
-            {
-              "kind": "method",
-              "name": "formState",
-              "privacy": "protected",
-              "return": {
-                "type": {
-                  "text": "FormRestoreState"
-                }
-              },
-              "inheritedFrom": {
-                "name": "SbbFormAssociatedMixin",
-                "module": "core/mixins/form-associated-mixin.js"
-              }
-            },
             {
               "kind": "method",
               "name": "setValidityFlag",
@@ -16216,11 +16316,10 @@
             },
             {
               "name": "value",
+              "description": "Value of the form element.",
               "type": {
-                "text": "T | T[] | null"
+                "text": "T[] | T | null"
               },
-              "default": "null",
-              "description": "Value of the form element.",
               "fieldName": "value"
             },
             {
@@ -20172,6 +20271,64 @@
                 "module": "core/mixins/form-associated-input-mixin.js"
               }
             },
+            {
+              "kind": "method",
+              "name": "_requiresEmptyPatch",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "boolean"
+                }
+              },
+              "inheritedFrom": {
+                "name": "SbbFormAssociatedInputMixin",
+                "module": "core/mixins/form-associated-input-mixin.js"
+              }
+            },
+            {
+              "kind": "method",
+              "name": "_assignValue",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "value",
+                  "type": {
+                    "text": "string"
+                  }
+                }
+              ],
+              "inheritedFrom": {
+                "name": "SbbFormAssociatedInputMixin",
+                "module": "core/mixins/form-associated-input-mixin.js"
+              }
+            },
+            {
+              "kind": "method",
+              "name": "_setCursorAt",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "position",
+                  "type": {
+                    "text": "number"
+                  }
+                }
+              ],
+              "inheritedFrom": {
+                "name": "SbbFormAssociatedInputMixin",
+                "module": "core/mixins/form-associated-input-mixin.js"
+              }
+            },
             {
               "kind": "method",
               "name": "_cleanText",
@@ -25167,6 +25324,21 @@
                 "module": "autocomplete/autocomplete-base-element.js"
               }
             },
+            {
+              "kind": "field",
+              "name": "position",
+              "type": {
+                "text": "'auto' | 'above' | 'below'"
+              },
+              "privacy": "public",
+              "default": "'auto'",
+              "description": "The position of the autocomplete panel relative to the trigger.",
+              "attribute": "position",
+              "inheritedFrom": {
+                "name": "SbbAutocompleteBaseElement",
+                "module": "autocomplete/autocomplete-base-element.js"
+              }
+            },
             {
               "kind": "field",
               "name": "originElement",
@@ -25924,6 +26096,19 @@
                 "name": "SbbAutocompleteBaseElement",
                 "module": "autocomplete/autocomplete-base-element.js"
               }
+            },
+            {
+              "name": "position",
+              "type": {
+                "text": "'auto' | 'above' | 'below'"
+              },
+              "default": "'auto'",
+              "description": "The position of the autocomplete panel relative to the trigger.",
+              "fieldName": "position",
+              "inheritedFrom": {
+                "name": "SbbAutocompleteBaseElement",
+                "module": "autocomplete/autocomplete-base-element.js"
+              }
             }
           ],
           "events": [
@@ -39262,17 +39447,32 @@
               "privacy": "private",
               "default": "new SbbLanguageController(this)"
             },
+            {
+              "kind": "field",
+              "name": "_observedCarouselItems",
+              "type": {
+                "text": "SbbCarouselItemElement[]"
+              },
+              "privacy": "private",
+              "default": "[]"
+            },
             {
               "kind": "field",
               "name": "_beforeShowObserver",
               "privacy": "private",
-              "default": "new IntersectionController(this, { callback: (entry) => { const item = entry.filter((e) => e.isIntersecting && e.target !== this); item.forEach((e) => { const target = e.target as SbbCarouselItemElement; target.dispatchEvent( new CustomEvent<SbbCarouselItemEventDetail>('beforeshow', { detail: { index: this._carouselItems().findIndex((e) => e === target) }, bubbles: true, composed: true, }), ); }); }, config: { threshold: 0.01, root: this, rootMargin: '100% 0% 100% 0%' }, })"
+              "default": "new IntersectionController(this, { target: null, callback: (entry) => { const item = entry.filter((e) => e.isIntersecting && e.target !== this); item.forEach((e) => { const target = e.target as SbbCarouselItemElement; target.dispatchEvent( new CustomEvent<SbbCarouselItemEventDetail>('beforeshow', { detail: { index: this._carouselItems().findIndex((e) => e === target) }, bubbles: true, composed: true, }), ); }); }, config: { threshold: 0.01, root: this, rootMargin: '100% 0% 100% 0%' }, })"
             },
             {
               "kind": "field",
               "name": "_showObserver",
               "privacy": "private",
-              "default": "new IntersectionController(this, { callback: (entryArr) => { for (const entry of entryArr) { if (entry.target === this) { continue; } const target = entry.target as SbbCarouselItemElement; if (entry.isIntersecting) { target.ariaHidden = null; this._currentIndex = this._carouselItems().findIndex((el) => el === target); target.dispatchEvent( new CustomEvent<SbbCarouselItemEventDetail>('show', { detail: { index: this._currentIndex }, bubbles: true, composed: true, }), ); } else { target.ariaHidden = 'true'; } } }, config: { threshold: 0.99, root: this, rootMargin: '100% 0% 100% 0%' }, })"
+              "default": "new IntersectionController(this, { target: null, callback: (entryArr) => { for (const entry of entryArr) { if (entry.target === this) { continue; } const target = entry.target as SbbCarouselItemElement; if (entry.isIntersecting) { target.ariaHidden = null; this._currentIndex = this._carouselItems().findIndex((el) => el === target); target.dispatchEvent( new CustomEvent<SbbCarouselItemEventDetail>('show', { detail: { index: this._currentIndex }, bubbles: true, composed: true, }), ); } else { target.ariaHidden = 'true'; } } }, config: { threshold: 0.99, root: this, rootMargin: '100% 0% 100% 0%' }, })"
+            },
+            {
+              "kind": "field",
+              "name": "_firstVisibleIntersectionController",
+              "privacy": "private",
+              "default": "new IntersectionController(this, { callback: (entries) => { entries.forEach((entry) => { if (entry.intersectionRatio > 0) { this._readDimensions(); this._firstVisibleIntersectionController.unobserve(this); } }); }, config: { root: !isServer ? document?.documentElement : null, }, })"
             },
             {
               "kind": "method",
@@ -39295,6 +39495,17 @@
                 }
               }
             },
+            {
+              "kind": "method",
+              "name": "_readDimensions",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "description": "Reads the dimensions of the first carousel item and sets the CSS properties accordingly.\nShould set the dimensions only once, when the first item becomes visible and if the value is non-zero."
+            },
             {
               "kind": "method",
               "name": "_onKeyDown",
@@ -55048,6 +55259,52 @@
                 }
               ]
             },
+            {
+              "kind": "method",
+              "name": "_requiresEmptyPatch",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "boolean"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "_assignValue",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "value",
+                  "type": {
+                    "text": "string"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "_setCursorAt",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "position",
+                  "type": {
+                    "text": "number"
+                  }
+                }
+              ]
+            },
             {
               "kind": "method",
               "name": "_cleanText",
@@ -58799,6 +59056,14 @@
                 "text": "HTMLElement"
               },
               "description": "The reference to the component."
+            },
+            {
+              "name": "position",
+              "default": "'auto'",
+              "type": {
+                "text": "'auto' | 'above' | 'below'"
+              },
+              "description": "The allowed position of the overlay relative to the origin."
             }
           ],
           "description": "Places the overlay in the correct position."
@@ -59196,7 +59461,7 @@
               "name": "properties",
               "optional": true,
               "type": {
-                "text": "{\n    verticalOffset?: number;\n    horizontalOffset?: number;\n    centered?: boolean;\n    responsiveHeight?: boolean;\n  }"
+                "text": "{\n    verticalOffset?: number;\n    horizontalOffset?: number;\n    centered?: boolean;\n    responsiveHeight?: boolean;\n    forceAbove?: boolean;\n    forceBelow?: boolean;\n  }"
               },
               "description": "Properties to take into account in calculations (optional)."
             },
@@ -90663,6 +90928,24 @@
               },
               "privacy": "protected"
             },
+            {
+              "kind": "method",
+              "name": "changeAndEmitPage",
+              "privacy": "protected",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "pageIndex",
+                  "type": {
+                    "text": "number"
+                  }
+                }
+              ]
+            },
             {
               "kind": "method",
               "name": "emitPageEvent",
@@ -90678,6 +90961,13 @@
                   "type": {
                     "text": "number"
                   }
+                },
+                {
+                  "name": "pageIndex",
+                  "optional": true,
+                  "type": {
+                    "text": "number"
+                  }
                 }
               ]
             },
@@ -90853,74 +91143,39 @@
               "static": true,
               "default": "'group'"
             },
-            {
-              "kind": "field",
-              "name": "events",
-              "type": {
-                "text": "{\n      page: 'page',\n    }"
-              },
-              "privacy": "public",
-              "static": true,
-              "readonly": true,
-              "default": "{ page: 'page', }"
-            },
             {
               "kind": "field",
               "name": "length",
-              "privacy": "public",
-              "description": "Total number of items.",
               "type": {
                 "text": "number"
               },
+              "privacy": "public",
+              "default": "0",
+              "description": "Total number of items.",
               "attribute": "length"
             },
             {
               "kind": "field",
-              "name": "_length",
+              "name": "pageSize",
               "type": {
                 "text": "number"
               },
-              "privacy": "private",
-              "default": "0"
-            },
-            {
-              "kind": "field",
-              "name": "pageSize",
               "privacy": "public",
+              "default": "10",
               "description": "Number of items per page.",
-              "type": {
-                "text": "number"
-              },
               "attribute": "page-size"
             },
             {
               "kind": "field",
-              "name": "_pageSize",
+              "name": "pageIndex",
               "type": {
                 "text": "number"
               },
-              "privacy": "private",
-              "default": "10"
-            },
-            {
-              "kind": "field",
-              "name": "pageIndex",
               "privacy": "public",
+              "default": "0",
               "description": "Current page index.",
-              "type": {
-                "text": "number"
-              },
               "attribute": "page-index"
             },
-            {
-              "kind": "field",
-              "name": "_pageIndex",
-              "type": {
-                "text": "number"
-              },
-              "privacy": "private",
-              "default": "0"
-            },
             {
               "kind": "field",
               "name": "pagerPosition",
@@ -90984,14 +91239,6 @@
               "privacy": "protected",
               "default": "new SbbLanguageController(this)"
             },
-            {
-              "kind": "field",
-              "name": "_previousPageSize",
-              "type": {
-                "text": "number"
-              },
-              "privacy": "private"
-            },
             {
               "kind": "method",
               "name": "renderPaginator",
@@ -91031,6 +91278,24 @@
                 }
               }
             },
+            {
+              "kind": "method",
+              "name": "changeAndEmitPage",
+              "privacy": "protected",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "pageIndex",
+                  "type": {
+                    "text": "number"
+                  }
+                }
+              ]
+            },
             {
               "kind": "method",
               "name": "nextPage",
@@ -91136,6 +91401,31 @@
                   "text": "void"
                 }
               },
+              "parameters": [
+                {
+                  "name": "previousPageIndex",
+                  "type": {
+                    "text": "number"
+                  }
+                },
+                {
+                  "name": "pageIndex",
+                  "optional": true,
+                  "type": {
+                    "text": "number"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "_emitPrivatePageEvent",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
               "parameters": [
                 {
                   "name": "previousPageIndex",
@@ -91251,32 +91541,35 @@
               "type": {
                 "text": "CustomEvent<SbbPaginatorPageEventDetails>"
               },
-              "description": "The page event is dispatched when the page index changes."
+              "description": "The page event is dispatched whenever the user changes the page."
             }
           ],
           "attributes": [
             {
               "name": "length",
-              "description": "Total number of items.",
               "type": {
                 "text": "number"
               },
+              "default": "0",
+              "description": "Total number of items.",
               "fieldName": "length"
             },
             {
               "name": "page-size",
-              "description": "Number of items per page.",
               "type": {
                 "text": "number"
               },
+              "default": "10",
+              "description": "Number of items per page.",
               "fieldName": "pageSize"
             },
             {
               "name": "page-index",
-              "description": "Current page index.",
               "type": {
                 "text": "number"
               },
+              "default": "0",
+              "description": "Current page index.",
               "fieldName": "pageIndex"
             },
             {
@@ -91407,16 +91700,12 @@
               "kind": "field",
               "name": "events",
               "type": {
-                "text": "{\n    page: 'page',\n  }"
+                "text": "{\n    page: 'page',\n    ɵpage: 'ɵpage',\n  }"
               },
               "privacy": "public",
               "static": true,
               "readonly": true,
-              "default": "{ page: 'page', }",
-              "inheritedFrom": {
-                "name": "SbbPaginatorCommonElementMixin",
-                "module": "paginator/common/paginator-common.js"
-              }
+              "default": "{ page: 'page', ɵpage: 'ɵpage', }"
             },
             {
               "kind": "method",
@@ -91459,26 +91748,13 @@
             {
               "kind": "field",
               "name": "length",
-              "privacy": "public",
-              "description": "Total number of items.",
-              "type": {
-                "text": "number"
-              },
-              "attribute": "length",
-              "inheritedFrom": {
-                "name": "SbbPaginatorCommonElementMixin",
-                "module": "paginator/common/paginator-common.js"
-              },
-              "default": "0"
-            },
-            {
-              "kind": "field",
-              "name": "_length",
               "type": {
                 "text": "number"
               },
-              "privacy": "private",
+              "privacy": "public",
               "default": "0",
+              "description": "Total number of items.",
+              "attribute": "length",
               "inheritedFrom": {
                 "name": "SbbPaginatorCommonElementMixin",
                 "module": "paginator/common/paginator-common.js"
@@ -91487,26 +91763,13 @@
             {
               "kind": "field",
               "name": "pageSize",
-              "privacy": "public",
-              "description": "Number of items per page.",
-              "type": {
-                "text": "number"
-              },
-              "attribute": "page-size",
-              "inheritedFrom": {
-                "name": "SbbPaginatorCommonElementMixin",
-                "module": "paginator/common/paginator-common.js"
-              },
-              "default": "10"
-            },
-            {
-              "kind": "field",
-              "name": "_pageSize",
               "type": {
                 "text": "number"
               },
-              "privacy": "private",
+              "privacy": "public",
               "default": "10",
+              "description": "Number of items per page.",
+              "attribute": "page-size",
               "inheritedFrom": {
                 "name": "SbbPaginatorCommonElementMixin",
                 "module": "paginator/common/paginator-common.js"
@@ -91515,26 +91778,13 @@
             {
               "kind": "field",
               "name": "pageIndex",
-              "privacy": "public",
-              "description": "Current page index.",
               "type": {
                 "text": "number"
               },
-              "attribute": "page-index",
-              "inheritedFrom": {
-                "name": "SbbPaginatorCommonElementMixin",
-                "module": "paginator/common/paginator-common.js"
-              },
-              "default": "0"
-            },
-            {
-              "kind": "field",
-              "name": "_pageIndex",
-              "type": {
-                "text": "number"
-              },
-              "privacy": "private",
+              "privacy": "public",
               "default": "0",
+              "description": "Current page index.",
+              "attribute": "page-index",
               "inheritedFrom": {
                 "name": "SbbPaginatorCommonElementMixin",
                 "module": "paginator/common/paginator-common.js"
@@ -91627,18 +91877,6 @@
                 "module": "paginator/common/paginator-common.js"
               }
             },
-            {
-              "kind": "field",
-              "name": "_previousPageSize",
-              "type": {
-                "text": "number"
-              },
-              "privacy": "private",
-              "inheritedFrom": {
-                "name": "SbbPaginatorCommonElementMixin",
-                "module": "paginator/common/paginator-common.js"
-              }
-            },
             {
               "kind": "method",
               "name": "_coercePageIndexInRange",
@@ -91676,6 +91914,28 @@
                 "module": "paginator/common/paginator-common.js"
               }
             },
+            {
+              "kind": "method",
+              "name": "changeAndEmitPage",
+              "privacy": "protected",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "pageIndex",
+                  "type": {
+                    "text": "number"
+                  }
+                }
+              ],
+              "inheritedFrom": {
+                "name": "SbbPaginatorCommonElementMixin",
+                "module": "paginator/common/paginator-common.js"
+              }
+            },
             {
               "kind": "method",
               "name": "nextPage",
@@ -91813,6 +92073,35 @@
                   "text": "void"
                 }
               },
+              "parameters": [
+                {
+                  "name": "previousPageIndex",
+                  "type": {
+                    "text": "number"
+                  }
+                },
+                {
+                  "name": "pageIndex",
+                  "optional": true,
+                  "type": {
+                    "text": "number"
+                  }
+                }
+              ],
+              "inheritedFrom": {
+                "name": "SbbPaginatorCommonElementMixin",
+                "module": "paginator/common/paginator-common.js"
+              }
+            },
+            {
+              "kind": "method",
+              "name": "_emitPrivatePageEvent",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
               "parameters": [
                 {
                   "name": "previousPageIndex",
@@ -91945,10 +92234,11 @@
           "attributes": [
             {
               "name": "length",
-              "description": "Total number of items.",
               "type": {
                 "text": "number"
               },
+              "default": "0",
+              "description": "Total number of items.",
               "fieldName": "length",
               "inheritedFrom": {
                 "name": "SbbPaginatorCommonElementMixin",
@@ -91957,10 +92247,11 @@
             },
             {
               "name": "page-size",
-              "description": "Number of items per page.",
               "type": {
                 "text": "number"
               },
+              "default": "10",
+              "description": "Number of items per page.",
               "fieldName": "pageSize",
               "inheritedFrom": {
                 "name": "SbbPaginatorCommonElementMixin",
@@ -91969,10 +92260,11 @@
             },
             {
               "name": "page-index",
-              "description": "Current page index.",
               "type": {
                 "text": "number"
               },
+              "default": "0",
+              "description": "Current page index.",
               "fieldName": "pageIndex",
               "inheritedFrom": {
                 "name": "SbbPaginatorCommonElementMixin",
@@ -92077,7 +92369,7 @@
               "type": {
                 "text": "CustomEvent<SbbPaginatorPageEventDetails>"
               },
-              "description": "The page event is dispatched when the page index changes.",
+              "description": "The page event is dispatched whenever the user changes the page.",
               "inheritedFrom": {
                 "name": "SbbPaginatorCommonElementMixin",
                 "module": "paginator/common/paginator-common.js"
@@ -92118,16 +92410,12 @@
               "kind": "field",
               "name": "events",
               "type": {
-                "text": "{\n    page: 'page',\n  }"
+                "text": "{\n    page: 'page',\n    ɵpage: 'ɵpage',\n  }"
               },
               "privacy": "public",
               "static": true,
               "readonly": true,
-              "default": "{ page: 'page', }",
-              "inheritedFrom": {
-                "name": "SbbPaginatorCommonElementMixin",
-                "module": "paginator/common/paginator-common.js"
-              }
+              "default": "{ page: 'page', ɵpage: 'ɵpage', }"
             },
             {
               "kind": "field",
@@ -92242,6 +92530,25 @@
                 }
               ]
             },
+            {
+              "kind": "method",
+              "name": "_setPageSizeFromSizeOptionsSelect",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "value",
+                  "type": {
+                    "text": "number"
+                  }
+                }
+              ],
+              "description": "A `pageSize` change would trigger a `pageIndex` change via `willUpdate`;\nthis triggers a `ɵpage` event, but it's late for the `page` event,\nso the checks on the `pageIndex` changes are done here, and possibly the event is emitted."
+            },
             {
               "kind": "method",
               "name": "_renderItemPerPageTemplate",
@@ -92293,26 +92600,13 @@
             {
               "kind": "field",
               "name": "length",
-              "privacy": "public",
-              "description": "Total number of items.",
-              "type": {
-                "text": "number"
-              },
-              "attribute": "length",
-              "inheritedFrom": {
-                "name": "SbbPaginatorCommonElementMixin",
-                "module": "paginator/common/paginator-common.js"
-              },
-              "default": "0"
-            },
-            {
-              "kind": "field",
-              "name": "_length",
               "type": {
                 "text": "number"
               },
-              "privacy": "private",
+              "privacy": "public",
               "default": "0",
+              "description": "Total number of items.",
+              "attribute": "length",
               "inheritedFrom": {
                 "name": "SbbPaginatorCommonElementMixin",
                 "module": "paginator/common/paginator-common.js"
@@ -92321,26 +92615,13 @@
             {
               "kind": "field",
               "name": "pageSize",
-              "privacy": "public",
-              "description": "Number of items per page.",
-              "type": {
-                "text": "number"
-              },
-              "attribute": "page-size",
-              "inheritedFrom": {
-                "name": "SbbPaginatorCommonElementMixin",
-                "module": "paginator/common/paginator-common.js"
-              },
-              "default": "10"
-            },
-            {
-              "kind": "field",
-              "name": "_pageSize",
               "type": {
                 "text": "number"
               },
-              "privacy": "private",
+              "privacy": "public",
               "default": "10",
+              "description": "Number of items per page.",
+              "attribute": "page-size",
               "inheritedFrom": {
                 "name": "SbbPaginatorCommonElementMixin",
                 "module": "paginator/common/paginator-common.js"
@@ -92349,26 +92630,13 @@
             {
               "kind": "field",
               "name": "pageIndex",
-              "privacy": "public",
-              "description": "Current page index.",
-              "type": {
-                "text": "number"
-              },
-              "attribute": "page-index",
-              "inheritedFrom": {
-                "name": "SbbPaginatorCommonElementMixin",
-                "module": "paginator/common/paginator-common.js"
-              },
-              "default": "0"
-            },
-            {
-              "kind": "field",
-              "name": "_pageIndex",
               "type": {
                 "text": "number"
               },
-              "privacy": "private",
+              "privacy": "public",
               "default": "0",
+              "description": "Current page index.",
+              "attribute": "page-index",
               "inheritedFrom": {
                 "name": "SbbPaginatorCommonElementMixin",
                 "module": "paginator/common/paginator-common.js"
@@ -92445,18 +92713,6 @@
                 "module": "paginator/common/paginator-common.js"
               }
             },
-            {
-              "kind": "field",
-              "name": "_previousPageSize",
-              "type": {
-                "text": "number"
-              },
-              "privacy": "private",
-              "inheritedFrom": {
-                "name": "SbbPaginatorCommonElementMixin",
-                "module": "paginator/common/paginator-common.js"
-              }
-            },
             {
               "kind": "method",
               "name": "_coercePageIndexInRange",
@@ -92494,6 +92750,28 @@
                 "module": "paginator/common/paginator-common.js"
               }
             },
+            {
+              "kind": "method",
+              "name": "changeAndEmitPage",
+              "privacy": "protected",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "pageIndex",
+                  "type": {
+                    "text": "number"
+                  }
+                }
+              ],
+              "inheritedFrom": {
+                "name": "SbbPaginatorCommonElementMixin",
+                "module": "paginator/common/paginator-common.js"
+              }
+            },
             {
               "kind": "method",
               "name": "nextPage",
@@ -92631,6 +92909,35 @@
                   "text": "void"
                 }
               },
+              "parameters": [
+                {
+                  "name": "previousPageIndex",
+                  "type": {
+                    "text": "number"
+                  }
+                },
+                {
+                  "name": "pageIndex",
+                  "optional": true,
+                  "type": {
+                    "text": "number"
+                  }
+                }
+              ],
+              "inheritedFrom": {
+                "name": "SbbPaginatorCommonElementMixin",
+                "module": "paginator/common/paginator-common.js"
+              }
+            },
+            {
+              "kind": "method",
+              "name": "_emitPrivatePageEvent",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
               "parameters": [
                 {
                   "name": "previousPageIndex",
@@ -92782,10 +93089,11 @@
             },
             {
               "name": "length",
-              "description": "Total number of items.",
               "type": {
                 "text": "number"
               },
+              "default": "0",
+              "description": "Total number of items.",
               "fieldName": "length",
               "inheritedFrom": {
                 "name": "SbbPaginatorCommonElementMixin",
@@ -92794,10 +93102,11 @@
             },
             {
               "name": "page-size",
-              "description": "Number of items per page.",
               "type": {
                 "text": "number"
               },
+              "default": "10",
+              "description": "Number of items per page.",
               "fieldName": "pageSize",
               "inheritedFrom": {
                 "name": "SbbPaginatorCommonElementMixin",
@@ -92806,10 +93115,11 @@
             },
             {
               "name": "page-index",
-              "description": "Current page index.",
               "type": {
                 "text": "number"
               },
+              "default": "0",
+              "description": "Current page index.",
               "fieldName": "pageIndex",
               "inheritedFrom": {
                 "name": "SbbPaginatorCommonElementMixin",
@@ -92913,7 +93223,7 @@
               "type": {
                 "text": "CustomEvent<SbbPaginatorPageEventDetails>"
               },
-              "description": "The page event is dispatched when the page index changes.",
+              "description": "The page event is dispatched whenever the user changes the page.",
               "inheritedFrom": {
                 "name": "SbbPaginatorCommonElementMixin",
                 "module": "paginator/common/paginator-common.js"