@ui5/webcomponents 2.20.0-rc.0 → 2.20.0-rc.2

package/dist/custom-elements-internal.json

@@ -26,7 +26,7 @@
       "declarations": [
         {
           "kind": "class",
-          "description": "### Overview\n\nAn image-like component that has different display options for representing images and icons\nin different shapes and sizes, depending on the use case.\n\nThe shape can be circular or square. There are several predefined sizes, as well as an option to\nset a custom size.\n\n### Keyboard Handling\n\n- [Space] / [Enter] or [Return] - Fires the `click` event if the `interactive` property is set to true.\n- [Shift] - If [Space] is pressed, pressing [Shift] releases the component without triggering the click event.\n\n### ES6 Module Import\n`import \"@ui5/webcomponents/dist/Avatar.js\";`",
+          "description": "### Overview\n\nAn image-like component that has different display options for representing images and icons\nin different shapes and sizes, depending on the use case.\n\nThe shape can be circular or square. There are several predefined sizes, as well as an option to\nset a custom size.\n\n### Keyboard Handling\n\n- [Space] / [Enter] or [Return] - Fires the `click` event if the `mode` is set to `Interactive` or the deprecated `interactive` property is set to true.\n- [Shift] - If [Space] is pressed, pressing [Shift] releases the component without triggering the click event.\n\n### ES6 Module Import\n`import \"@ui5/webcomponents/dist/Avatar.js\";`",
           "name": "Avatar",
           "slots": [
             {
@@ -67,8 +67,27 @@
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Defines if the avatar is interactive (focusable and pressable).\n\n**Note:** This property won't have effect if the `disabled`\nproperty is set to `true`.",
-              "privacy": "public"
+              "description": "Defines if the avatar is interactive (focusable and pressable).\n\n**Note:** When set to `true`, this property takes precedence over the `mode` property,\nand the avatar will be rendered as interactive (role=\"button\", focusable) regardless of the `mode` value.\n\n**Note:** This property won't have effect if the `disabled`\nproperty is set to `true`.",
+              "privacy": "public",
+              "deprecated": "Set `mode=\"Interactive\"` instead for the same functionality with proper accessibility."
+            },
+            {
+              "kind": "field",
+              "name": "mode",
+              "type": {
+                "text": "AvatarMode",
+                "references": [
+                  {
+                    "name": "AvatarMode",
+                    "package": "@ui5/webcomponents",
+                    "module": "dist/types/AvatarMode.js"
+                  }
+                ]
+              },
+              "default": "\"Image\"",
+              "description": "Defines the mode of the component.\n\n**Note:**\n- `Image` (default) - renders with role=\"img\"\n- `Decorative` - renders with role=\"presentation\" and aria-hidden=\"true\", making it purely decorative\n- `Interactive` - renders with role=\"button\", focusable (tabindex=\"0\"), and supports keyboard interaction\n\n**Note:** This property is ignored when the `interactive` property is set to `true`.\nIn that case, the avatar will always be rendered as interactive.",
+              "privacy": "public",
+              "_ui5since": "2.20"
             },
             {
               "kind": "field",
@@ -206,12 +225,22 @@
               }
             },
             {
-              "description": "Defines if the avatar is interactive (focusable and pressable).\n\n**Note:** This property won't have effect if the `disabled`\nproperty is set to `true`.",
+              "description": "Defines if the avatar is interactive (focusable and pressable).\n\n**Note:** When set to `true`, this property takes precedence over the `mode` property,\nand the avatar will be rendered as interactive (role=\"button\", focusable) regardless of the `mode` value.\n\n**Note:** This property won't have effect if the `disabled`\nproperty is set to `true`.",
               "name": "interactive",
               "default": "false",
               "fieldName": "interactive",
               "type": {
                 "text": "boolean"
+              },
+              "deprecated": "Set `mode=\"Interactive\"` instead for the same functionality with proper accessibility."
+            },
+            {
+              "description": "Defines the mode of the component.\n\n**Note:**\n- `Image` (default) - renders with role=\"img\"\n- `Decorative` - renders with role=\"presentation\" and aria-hidden=\"true\", making it purely decorative\n- `Interactive` - renders with role=\"button\", focusable (tabindex=\"0\"), and supports keyboard interaction\n\n**Note:** This property is ignored when the `interactive` property is set to `true`.\nIn that case, the avatar will always be rendered as interactive.",
+              "name": "mode",
+              "default": "\"Image\"",
+              "fieldName": "mode",
+              "type": {
+                "text": "\"Image\" | \"Decorative\" | \"Interactive\""
               }
             },
             {
@@ -4820,6 +4849,17 @@
               "_ui5formProperty": true,
               "_ui5formEvents": "change,input"
             },
+            {
+              "kind": "field",
+              "name": "selectedValue",
+              "type": {
+                "text": "string | undefined"
+              },
+              "description": "Defines the selected item's value.\n\nUse this property together with the `value` property on `ui5-cb-item` to:\n- Select an item programmatically by its unique identifier\n- Handle items with identical display text but different underlying values\n- Submit machine-readable values in forms (the `value` property is submitted instead of the display text)\n\nWhen set, the ComboBox finds and selects the item whose `value` matches this property\nand whose `text` matches the ComboBox's `value` (display text).\n\n**Note:** This replaces the deprecated `selected` property on `ui5-cb-item`.",
+              "default": "undefined",
+              "privacy": "public",
+              "_ui5since": "2.19.0"
+            },
             {
               "kind": "field",
               "name": "name",
@@ -5064,6 +5104,15 @@
                 "text": "string"
               }
             },
+            {
+              "description": "Defines the selected item's value.\n\nUse this property together with the `value` property on `ui5-cb-item` to:\n- Select an item programmatically by its unique identifier\n- Handle items with identical display text but different underlying values\n- Submit machine-readable values in forms (the `value` property is submitted instead of the display text)\n\nWhen set, the ComboBox finds and selects the item whose `value` matches this property\nand whose `text` matches the ComboBox's `value` (display text).\n\n**Note:** This replaces the deprecated `selected` property on `ui5-cb-item`.",
+              "name": "selected-value",
+              "default": "undefined",
+              "fieldName": "selectedValue",
+              "type": {
+                "text": "string | undefined"
+              }
+            },
             {
               "description": "Determines the name by which the component will be identified upon submission in an HTML form.\n\n**Note:** This property is only applicable within the context of an HTML Form element.",
               "name": "name",
@@ -5241,6 +5290,17 @@
               "default": "undefined",
               "privacy": "public",
               "_ui5since": "1.0.0-rc.11"
+            },
+            {
+              "kind": "field",
+              "name": "value",
+              "type": {
+                "text": "string | undefined"
+              },
+              "description": "Defines the value of the `ui5-cb-item`.\n\nUse this property to associate a unique identifier or machine-readable value with the item,\nseparate from the display text. This enables:\n- Selecting items programmatically via `selectedValue` on the ComboBox\n- Submitting machine-readable values in forms\n- Distinguishing between items with identical display text\n\n**Example:**\n```html\n<ui5-combobox selected-value=\"DE\">\n  <ui5-cb-item text=\"Germany\" value=\"DE\"></ui5-cb-item>\n  <ui5-cb-item text=\"France\" value=\"FR\"></ui5-cb-item>\n</ui5-combobox>\n```",
+              "default": "undefined",
+              "privacy": "public",
+              "_ui5since": "2.19.0"
             }
           ],
           "attributes": [
@@ -5261,6 +5321,15 @@
               "type": {
                 "text": "string | undefined"
               }
+            },
+            {
+              "description": "Defines the value of the `ui5-cb-item`.\n\nUse this property to associate a unique identifier or machine-readable value with the item,\nseparate from the display text. This enables:\n- Selecting items programmatically via `selectedValue` on the ComboBox\n- Submitting machine-readable values in forms\n- Distinguishing between items with identical display text\n\n**Example:**\n```html\n<ui5-combobox selected-value=\"DE\">\n  <ui5-cb-item text=\"Germany\" value=\"DE\"></ui5-cb-item>\n  <ui5-cb-item text=\"France\" value=\"FR\"></ui5-cb-item>\n</ui5-combobox>\n```",
+              "name": "value",
+              "default": "undefined",
+              "fieldName": "value",
+              "type": {
+                "text": "string | undefined"
+              }
             }
           ],
           "superclass": {
@@ -5425,6 +5494,14 @@
                 "name": "ListItemGroup",
                 "module": "dist/ListItemGroup.js"
               }
+            },
+            {
+              "description": "Used to style the title of the group header",
+              "name": "title",
+              "inheritedFrom": {
+                "name": "ListItemGroup",
+                "module": "dist/ListItemGroup.js"
+              }
             }
           ],
           "attributes": [
@@ -13252,6 +13329,10 @@
             {
               "description": "Used to style the header item of the group",
               "name": "header"
+            },
+            {
+              "description": "Used to style the title of the group header",
+              "name": "title"
             }
           ],
           "slots": [
@@ -15773,6 +15854,7 @@
               "default": "false",
               "description": "Defines the selected state of the component.",
               "privacy": "public",
+              "deprecated": "use value property of the item and selectedValue property of the ComboBox instead",
               "inheritedFrom": {
                 "name": "ListItemBase",
                 "module": "dist/ListItemBase.js"
@@ -15806,6 +15888,21 @@
                 "name": "ComboBoxItem",
                 "module": "dist/ComboBoxItem.js"
               }
+            },
+            {
+              "kind": "field",
+              "name": "value",
+              "type": {
+                "text": "string | undefined"
+              },
+              "description": "Defines the value of the `ui5-cb-item`.\n\nUse this property to associate a unique identifier or machine-readable value with the item,\nseparate from the display text. This enables:\n- Selecting items programmatically via `selectedValue` on the ComboBox\n- Submitting machine-readable values in forms\n- Distinguishing between items with identical display text\n\n**Example:**\n```html\n<ui5-combobox selected-value=\"DE\">\n  <ui5-cb-item text=\"Germany\" value=\"DE\"></ui5-cb-item>\n  <ui5-cb-item text=\"France\" value=\"FR\"></ui5-cb-item>\n</ui5-combobox>\n```",
+              "default": "undefined",
+              "privacy": "public",
+              "_ui5since": "2.19.0",
+              "inheritedFrom": {
+                "name": "ComboBoxItem",
+                "module": "dist/ComboBoxItem.js"
+              }
             }
           ],
           "attributes": [
@@ -15843,6 +15940,19 @@
                 "name": "ComboBoxItem",
                 "module": "dist/ComboBoxItem.js"
               }
+            },
+            {
+              "description": "Defines the value of the `ui5-cb-item`.\n\nUse this property to associate a unique identifier or machine-readable value with the item,\nseparate from the display text. This enables:\n- Selecting items programmatically via `selectedValue` on the ComboBox\n- Submitting machine-readable values in forms\n- Distinguishing between items with identical display text\n\n**Example:**\n```html\n<ui5-combobox selected-value=\"DE\">\n  <ui5-cb-item text=\"Germany\" value=\"DE\"></ui5-cb-item>\n  <ui5-cb-item text=\"France\" value=\"FR\"></ui5-cb-item>\n</ui5-combobox>\n```",
+              "name": "value",
+              "default": "undefined",
+              "fieldName": "value",
+              "type": {
+                "text": "string | undefined"
+              },
+              "inheritedFrom": {
+                "name": "ComboBoxItem",
+                "module": "dist/ComboBoxItem.js"
+              }
             }
           ],
           "superclass": {
@@ -16006,6 +16116,14 @@
                 "name": "ListItemGroup",
                 "module": "dist/ListItemGroup.js"
               }
+            },
+            {
+              "description": "Used to style the title of the group header",
+              "name": "title",
+              "inheritedFrom": {
+                "name": "ListItemGroup",
+                "module": "dist/ListItemGroup.js"
+              }
             }
           ],
           "attributes": [
@@ -21340,6 +21458,20 @@
                 "module": "dist/SliderBase.js"
               }
             },
+            {
+              "kind": "field",
+              "name": "step",
+              "type": {
+                "text": "number"
+              },
+              "default": "1",
+              "description": "Defines the size of the slider's selection intervals (e.g. min = 0, max = 10, step = 5 would result in possible selection of the values 0, 5, 10).\n\n**Note:** If set to 0 the slider handle movement is disabled.",
+              "privacy": "public",
+              "inheritedFrom": {
+                "name": "SliderBase",
+                "module": "dist/SliderBase.js"
+              }
+            },
             {
               "kind": "field",
               "name": "min",
@@ -21383,20 +21515,6 @@
                 "module": "dist/SliderBase.js"
               }
             },
-            {
-              "kind": "field",
-              "name": "step",
-              "type": {
-                "text": "number"
-              },
-              "default": "1",
-              "description": "Defines the size of the slider's selection intervals (e.g. min = 0, max = 10, step = 5 would result in possible selection of the values 0, 5, 10).\n\n**Note:** If set to 0 the slider handle movement is disabled. When negative number or value other than a number, the component fallbacks to its default value.",
-              "privacy": "public",
-              "inheritedFrom": {
-                "name": "SliderBase",
-                "module": "dist/SliderBase.js"
-              }
-            },
             {
               "kind": "field",
               "name": "labelInterval",
@@ -21487,12 +21605,25 @@
             {
               "description": "Current value of the slider",
               "name": "value",
-              "default": "undefined",
+              "default": "0",
               "fieldName": "value",
               "type": {
                 "text": "number"
               }
             },
+            {
+              "description": "Defines the size of the slider's selection intervals (e.g. min = 0, max = 10, step = 5 would result in possible selection of the values 0, 5, 10).\n\n**Note:** If set to 0 the slider handle movement is disabled.",
+              "name": "step",
+              "default": "1",
+              "fieldName": "step",
+              "type": {
+                "text": "number"
+              },
+              "inheritedFrom": {
+                "name": "SliderBase",
+                "module": "dist/SliderBase.js"
+              }
+            },
             {
               "description": "Defines the minimum value of the slider.",
               "name": "min",
@@ -21532,19 +21663,6 @@
                 "module": "dist/SliderBase.js"
               }
             },
-            {
-              "description": "Defines the size of the slider's selection intervals (e.g. min = 0, max = 10, step = 5 would result in possible selection of the values 0, 5, 10).\n\n**Note:** If set to 0 the slider handle movement is disabled. When negative number or value other than a number, the component fallbacks to its default value.",
-              "name": "step",
-              "default": "1",
-              "fieldName": "step",
-              "type": {
-                "text": "number"
-              },
-              "inheritedFrom": {
-                "name": "SliderBase",
-                "module": "dist/SliderBase.js"
-              }
-            },
             {
               "description": "Displays a label with a value on every N-th step.\n\n**Note:** The step and tickmarks properties must be enabled.\nExample - if the step value is set to 2 and the label interval is also specified to 2 - then every second\ntickmark will be labelled, which means every 4th value number.",
               "name": "label-interval",
@@ -21934,6 +22052,36 @@
         }
       ]
     },
+    {
+      "kind": "javascript-module",
+      "path": "dist/SliderHandle.js",
+      "declarations": [],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "default",
+          "declaration": {
+            "name": "SliderHandle",
+            "module": "dist/SliderHandle.js"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "dist/SliderScale.js",
+      "declarations": [],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "default",
+          "declaration": {
+            "name": "SliderScale",
+            "module": "dist/SliderScale.js"
+          }
+        }
+      ]
+    },
     {
       "kind": "javascript-module",
       "path": "dist/SliderTooltip.js",
@@ -22861,6 +23009,14 @@
                 "name": "ListItemGroup",
                 "module": "dist/ListItemGroup.js"
               }
+            },
+            {
+              "description": "Used to style the title of the group header",
+              "name": "title",
+              "inheritedFrom": {
+                "name": "ListItemGroup",
+                "module": "dist/ListItemGroup.js"
+              }
             }
           ],
           "attributes": [
@@ -33160,6 +33316,60 @@
         }
       ]
     },
+    {
+      "kind": "javascript-module",
+      "path": "dist/types/AvatarMode.js",
+      "declarations": [
+        {
+          "kind": "enum",
+          "name": "AvatarMode",
+          "description": "Different Avatar modes.",
+          "_ui5privacy": "public",
+          "members": [
+            {
+              "kind": "field",
+              "static": true,
+              "privacy": "public",
+              "_ui5since": "2.20",
+              "description": "Image mode (by default).\nConfigures the component to internally render role=\"img\".",
+              "default": "Image",
+              "name": "Image",
+              "readonly": true
+            },
+            {
+              "kind": "field",
+              "static": true,
+              "privacy": "public",
+              "_ui5since": "2.20",
+              "description": "Decorative mode.\nConfigures the component to internally render role=\"presentation\" and aria-hidden=\"true\",\nmaking it purely decorative without semantic content or interactivity.",
+              "default": "Decorative",
+              "name": "Decorative",
+              "readonly": true
+            },
+            {
+              "kind": "field",
+              "static": true,
+              "privacy": "public",
+              "_ui5since": "2.20",
+              "description": "Interactive mode.\nConfigures the component to internally render role=\"button\".\nThis mode also supports focus and enables keyboard interaction.",
+              "default": "Interactive",
+              "name": "Interactive",
+              "readonly": true
+            }
+          ]
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "default",
+          "declaration": {
+            "name": "AvatarMode",
+            "module": "dist/types/AvatarMode.js"
+          }
+        }
+      ]
+    },
     {
       "kind": "javascript-module",
       "path": "dist/types/AvatarShape.js",