@pine-ds/core 4.7.2 → 4.9.0

package/dist/vscode.html-data.json

@@ -72,6 +72,13 @@
             "value": "If true, the leading icon is hidden.\n\n**Default:** `false`"
           }
         },
+        {
+          "name": "severity-label",
+          "description": {
+            "kind": "markdown",
+            "value": "Accessible label announcing the alert's severity, read before the heading\nand message. Pass a translated string to localize it; defaults to English\nfor each variant (`Error`, `Info`, `Success`, `Warning`). The `default`\nvariant has no severity and announces none unless this is set; pass an\nempty string to announce none for any variant."
+          }
+        },
         {
           "name": "small",
           "description": {
@@ -132,6 +139,13 @@
             "value": "Determines whether the badge is visible or not.\n\n**Default:** `false`"
           }
         },
+        {
+          "name": "badge-label",
+          "description": {
+            "kind": "markdown",
+            "value": "Accessible label for the badge icon. Pass a translated string to localize\nit; defaults to English. Pass an empty string to make the badge\ndecorative. Has no effect on dropdown avatars, where the trigger's\n`triggerLabel` owns the accessible name."
+          }
+        },
         {
           "name": "component-id",
           "description": {
@@ -6961,7 +6975,7 @@
       "name": "pds-checkbox",
       "description": {
         "kind": "markdown",
-        "value": "Checkboxes provide users with selectable options like toggling a single setting or selecting multiple options from a list.\n\n**Examples:**\n[Default](https://pine-design-system.netlify.app/?path=/docs/components-checkbox--docs#default), [Checked](https://pine-design-system.netlify.app/?path=/docs/components-checkbox--docs#checked), [Indeterminate](https://pine-design-system.netlify.app/?path=/docs/components-checkbox--docs#indeterminate), [Disabled](https://pine-design-system.netlify.app/?path=/docs/components-checkbox--docs#disabled), [Message](https://pine-design-system.netlify.app/?path=/docs/components-checkbox--docs#message), [Invalid](https://pine-design-system.netlify.app/?path=/docs/components-checkbox--docs#invalid), [Label slot](https://pine-design-system.netlify.app/?path=/docs/components-checkbox--docs#label-slot)\n\n**Slots:**\n- `label` - Content displayed as the checkbox label in place of the `label` text. Clicking it toggles the checkbox.\n\n**Events:**\n- `pdsCheckboxChange` - Event emitted that contains the `value` and `checked`.\n- `pdsCheckboxInput` - No description"
+        "value": "Checkboxes provide users with selectable options like toggling a single setting or selecting multiple options from a list.\n\n**Examples:**\n[Default](https://pine-design-system.netlify.app/?path=/docs/components-checkbox--docs#default), [Checked](https://pine-design-system.netlify.app/?path=/docs/components-checkbox--docs#checked), [Indeterminate](https://pine-design-system.netlify.app/?path=/docs/components-checkbox--docs#indeterminate), [Disabled](https://pine-design-system.netlify.app/?path=/docs/components-checkbox--docs#disabled), [Message](https://pine-design-system.netlify.app/?path=/docs/components-checkbox--docs#message), [Invalid](https://pine-design-system.netlify.app/?path=/docs/components-checkbox--docs#invalid), [Label slot](https://pine-design-system.netlify.app/?path=/docs/components-checkbox--docs#label-slot), [Pill](https://pine-design-system.netlify.app/?path=/docs/components-checkbox--docs#pill)\n\n**Slots:**\n- `label` - Content displayed as the checkbox label in place of the `label` text. Clicking it toggles the checkbox.\n\n**Events:**\n- `pdsCheckboxChange` - Event emitted that contains the `value` and `checked`.\n- `pdsCheckboxInput` - No description"
       },
       "attributes": [
         {
@@ -7003,14 +7017,14 @@
           "name": "hide-label",
           "description": {
             "kind": "markdown",
-            "value": "Visually hides the label text for instances where only the checkbox should be displayed. Label remains accessible to assistive technology such as screen readers."
+            "value": "Visually hides the label text for instances where only the checkbox should be displayed. Label remains accessible to assistive technology such as screen readers. Ignored when `variant` is `pill`."
           }
         },
         {
           "name": "indeterminate",
           "description": {
             "kind": "markdown",
-            "value": "If `true`, the checkbox will visually appear as indeterminate.\nOnly JavaScript can set the objects `indeterminate` property. See [MDN Web Docs](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input/checkbox#indeterminate_state_checkboxes)."
+            "value": "If `true`, the checkbox will visually appear as indeterminate.\nOnly JavaScript can set the objects `indeterminate` property. See [MDN Web Docs](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input/checkbox#indeterminate_state_checkboxes).\nHas no visual style when `variant` is `pill`."
           }
         },
         {
@@ -7047,6 +7061,21 @@
             "kind": "markdown",
             "value": "The value of the checkbox that is submitted with a form."
           }
+        },
+        {
+          "name": "variant",
+          "description": {
+            "kind": "markdown",
+            "value": "Sets the style variant of the checkbox. `pill` renders the label as a pill-shaped choice; the native input still handles keyboard, form, and screen reader behavior.\n\n**Type:** `\"default\" | \"pill\"`\n\n**Default:** `'default'`"
+          },
+          "values": [
+            {
+              "name": "default"
+            },
+            {
+              "name": "pill"
+            }
+          ]
         }
       ],
       "references": [
@@ -7621,6 +7650,13 @@
             "value": "Width of the trigger (button or input). Any valid CSS width value.\n\n**Default:** `'fit-content'`"
           }
         },
+        {
+          "name": "truncate",
+          "description": {
+            "kind": "markdown",
+            "value": "Determines whether the button trigger's label and the option labels should truncate and display with an ellipsis.\nWhen a label overflows, a `title` showing the full label will appear on hover.\nChip options, custom layouts and group rows aren't affected.\n\n**Default:** `false`"
+          }
+        },
         {
           "name": "value",
           "description": {
@@ -8311,7 +8347,7 @@
       "name": "pds-dropdown-menu",
       "description": {
         "kind": "markdown",
-        "value": "Dropdown Menus reveal a list of actions from a button trigger, implementing the WAI-ARIA Menu Button pattern. Use them to conserve space when options do not need to be visible at all times.\n\n**Examples:**\n[Default](https://pine-design-system.netlify.app/?path=/docs/components-dropdown-menu--docs#default), [With Separator](https://pine-design-system.netlify.app/?path=/docs/components-dropdown-menu--docs#with-separator), [With Icons](https://pine-design-system.netlify.app/?path=/docs/components-dropdown-menu--docs#with-icons), [With Header](https://pine-design-system.netlify.app/?path=/docs/components-dropdown-menu--docs#with-header), [With Links](https://pine-design-system.netlify.app/?path=/docs/components-dropdown-menu--docs#with-links), [With External Links](https://pine-design-system.netlify.app/?path=/docs/components-dropdown-menu--docs#with-external-links), [Mixing Menu Items with Raw Elements](https://pine-design-system.netlify.app/?path=/docs/components-dropdown-menu--docs#mixing-menu-items-with-raw-elements), [With Disabled Items](https://pine-design-system.netlify.app/?path=/docs/components-dropdown-menu--docs#with-disabled-items), [With Custom Placement](https://pine-design-system.netlify.app/?path=/docs/components-dropdown-menu--docs#with-custom-placement), [Scrollable Menu](https://pine-design-system.netlify.app/?path=/docs/components-dropdown-menu--docs#scrollable-menu)\n\n**Slots:**\n- `header` - Non-interactive content displayed above the menu items inside the dropdown panel. It renders outside the menu role, so assistive tech reads it as plain content rather than as a menu item.\n\n**CSS Parts:**\n- `menu-panel` - Exposes the dropdown menu container for styling."
+        "value": "Dropdown Menus reveal a list of actions from a button trigger, implementing the WAI-ARIA Menu Button pattern. Use them to conserve space when options do not need to be visible at all times.\n\n**Examples:**\n[Default](https://pine-design-system.netlify.app/?path=/docs/components-dropdown-menu--docs#default), [With Separator](https://pine-design-system.netlify.app/?path=/docs/components-dropdown-menu--docs#with-separator), [With Icons](https://pine-design-system.netlify.app/?path=/docs/components-dropdown-menu--docs#with-icons), [With Header](https://pine-design-system.netlify.app/?path=/docs/components-dropdown-menu--docs#with-header), [With Links](https://pine-design-system.netlify.app/?path=/docs/components-dropdown-menu--docs#with-links), [With External Links](https://pine-design-system.netlify.app/?path=/docs/components-dropdown-menu--docs#with-external-links), [With Informational Items](https://pine-design-system.netlify.app/?path=/docs/components-dropdown-menu--docs#with-informational-items), [Mixing Menu Items with Raw Elements](https://pine-design-system.netlify.app/?path=/docs/components-dropdown-menu--docs#mixing-menu-items-with-raw-elements), [With Disabled Items](https://pine-design-system.netlify.app/?path=/docs/components-dropdown-menu--docs#with-disabled-items), [With Custom Placement](https://pine-design-system.netlify.app/?path=/docs/components-dropdown-menu--docs#with-custom-placement), [Scrollable Menu](https://pine-design-system.netlify.app/?path=/docs/components-dropdown-menu--docs#scrollable-menu)\n\n**Slots:**\n- `header` - Non-interactive content displayed above the menu items inside the dropdown panel. It renders outside the menu role, so assistive tech reads it as plain content rather than as a menu item.\n\n**CSS Parts:**\n- `menu-panel` - Exposes the dropdown menu container for styling."
       },
       "attributes": [
         {
@@ -8378,7 +8414,7 @@
       "name": "pds-dropdown-menu-item",
       "description": {
         "kind": "markdown",
-        "value": "\n\n**CSS Parts:**\n- `button` - No description\n\n**Events:**\n- `pdsClick` - Emitted when the dropdown-item is clicked."
+        "value": "\n\n**CSS Parts:**\n- `button` - Exposes the item's inner element for styling. Appears on button and informational items, not on links.\n\n**Events:**\n- `pdsClick` - Emitted when the dropdown-item is clicked."
       },
       "attributes": [
         {
@@ -8406,28 +8442,42 @@
           "name": "download",
           "description": {
             "kind": "markdown",
-            "value": "Prompts the user to save the linked URL instead of navigating to it.\nIt can be used without a value to download with the default filename,\nor with a string value to suggest a specific filename for the download.\nOnly applies when href is set."
+            "value": "Prompts the user to save the linked URL instead of navigating to it.\nIt can be used without a value to download with the default filename,\nor with a string value to suggest a specific filename for the download.\nOnly applies when href is set. Ignored when `informational` is set."
           }
         },
         {
           "name": "external",
           "description": {
             "kind": "markdown",
-            "value": "Determines whether the link should open in a new tab and display an external icon.\nThis is a simpler alternative to using `target=\"_blank\"` for the common case.\n\n**Default:** `false`"
+            "value": "Determines whether the link should open in a new tab and display an external icon.\nThis is a simpler alternative to using `target=\"_blank\"` for the common case.\nIgnored when `informational` is set.\n\n**Default:** `false`"
+          }
+        },
+        {
+          "name": "external-label",
+          "description": {
+            "kind": "markdown",
+            "value": "Accessible label for the external-link icon, passed to the inner\n`pds-link`. Pass a translated string to localize it; defaults to English.\nPass an empty string to make the icon decorative."
           }
         },
         {
           "name": "href",
           "description": {
             "kind": "markdown",
-            "value": "If provided, renders the dropdown-item as an anchor (`<a>`) element instead of a button."
+            "value": "If provided, renders the dropdown-item as an anchor (`<a>`) element instead of a button.\nIgnored when `informational` is set."
+          }
+        },
+        {
+          "name": "informational",
+          "description": {
+            "kind": "markdown",
+            "value": "It determines whether or not the dropdown-item is informational: text that the arrow keys\nreach but that can't be activated. Takes precedence over `href` and `destructive`.\nScreen readers announce it as dimmed or unavailable, the same way as a disabled item.\n\n**Default:** `false`"
           }
         },
         {
           "name": "target",
           "description": {
             "kind": "markdown",
-            "value": "Specifies where to open the linked document when href is provided.\nTakes precedence over the `external` prop if both are set.\nOnly applies when href is set.\n\n**Type:** `\"_blank\" | \"_parent\" | \"_self\" | \"_top\"`"
+            "value": "Specifies where to open the linked document when href is provided.\nTakes precedence over the `external` prop if both are set.\nOnly applies when href is set. Ignored when `informational` is set.\n\n**Type:** `\"_blank\" | \"_parent\" | \"_self\" | \"_top\"`"
           },
           "values": [
             {
@@ -8857,6 +8907,13 @@
             "value": "Determines whether the link should open in a new tab.\n\n**Default:** `false`\n\n⚠️ **Deprecated:** Consider using the `target` prop for more control. This prop will be maintained for backward compatibility."
           }
         },
+        {
+          "name": "external-label",
+          "description": {
+            "kind": "markdown",
+            "value": "Accessible label for the icon that `external` shows, appended to the\nlink's name. It isn't announced when `target` keeps the link in the same\ntab. Pass a translated string to localize it; defaults to English. Pass an\nempty string to make the icon decorative."
+          }
+        },
         {
           "name": "font-size",
           "description": {
@@ -9579,7 +9636,7 @@
       "name": "pds-popover",
       "description": {
         "kind": "markdown",
-        "value": "Popovers display contextual information when users click or initiates a keyboard event on an element. They typically contain more information than tooltips and can include interactive elements.\n\n**Examples:**\n[Trigger Slot](https://pine-design-system.netlify.app/?path=/docs/components-popover--docs#trigger-slot), [Behavior Types](https://pine-design-system.netlify.app/?path=/docs/components-popover--docs#behavior-types), [Target Actions](https://pine-design-system.netlify.app/?path=/docs/components-popover--docs#target-actions), [Width/Sizing](https://pine-design-system.netlify.app/?path=/docs/components-popover--docs#width/sizing)\n\n**Slots:**\n- `(default)` - The content to display inside the popover\n- `trigger` - The trigger element for the popover\n\n**Events:**\n- `pdsPopoverClose` - Emitted when the popover is closed\n- `pdsPopoverOpen` - Emitted when the popover is opened"
+        "value": "Popovers display contextual information when users click an element or activate it with the keyboard, and can also open when users hover over it. They typically contain more information than tooltips and can include interactive elements.\n\n**Examples:**\n[Trigger Slot](https://pine-design-system.netlify.app/?path=/docs/components-popover--docs#trigger-slot), [Behavior Types](https://pine-design-system.netlify.app/?path=/docs/components-popover--docs#behavior-types), [Target Actions](https://pine-design-system.netlify.app/?path=/docs/components-popover--docs#target-actions), [Open on hover](https://pine-design-system.netlify.app/?path=/docs/components-popover--docs#open-on-hover), [Width/Sizing](https://pine-design-system.netlify.app/?path=/docs/components-popover--docs#width/sizing), [Padding](https://pine-design-system.netlify.app/?path=/docs/components-popover--docs#padding)\n\n**Slots:**\n- `(default)` - The content to display inside the popover\n- `trigger` - The trigger element for the popover\n\n**Events:**\n- `pdsPopoverClose` - Emitted when the popover is closed\n- `pdsPopoverOpen` - Emitted when the popover is opened"
       },
       "attributes": [
         {
@@ -9596,6 +9653,42 @@
             "value": "Sets the maximum width of the popover content\n\n**Type:** `number`\n\n**Default:** `352`"
           }
         },
+        {
+          "name": "open-on",
+          "description": {
+            "kind": "markdown",
+            "value": "Determines how the popover opens. With `hover`, it also opens when the pointer rests on the trigger and closes\nwhen the pointer leaves, until a click on the trigger keeps it open. Enter or Space on the trigger opens it either way.\n\n**Type:** `\"click\" | \"hover\"`\n\n**Default:** `'click'`"
+          },
+          "values": [
+            {
+              "name": "click"
+            },
+            {
+              "name": "hover"
+            }
+          ]
+        },
+        {
+          "name": "padding",
+          "description": {
+            "kind": "markdown",
+            "value": "Sets the padding of the popover content\n\n**Type:** `\"md\" | \"none\" | \"sm\" | \"xs\"`\n\n**Default:** `'md'`"
+          },
+          "values": [
+            {
+              "name": "md"
+            },
+            {
+              "name": "none"
+            },
+            {
+              "name": "sm"
+            },
+            {
+              "name": "xs"
+            }
+          ]
+        },
         {
           "name": "placement",
           "description": {
@@ -9772,7 +9865,7 @@
       "name": "pds-radio",
       "description": {
         "kind": "markdown",
-        "value": "Radio components allow users to select one option from a group of two or more choices.\n\n**Examples:**\n[Default](https://pine-design-system.netlify.app/?path=/docs/components-radio-group-radio--docs#default), [Checked](https://pine-design-system.netlify.app/?path=/docs/components-radio-group-radio--docs#checked), [Disabled](https://pine-design-system.netlify.app/?path=/docs/components-radio-group-radio--docs#disabled), [Message](https://pine-design-system.netlify.app/?path=/docs/components-radio-group-radio--docs#message), [Invalid](https://pine-design-system.netlify.app/?path=/docs/components-radio-group-radio--docs#invalid), [With Border](https://pine-design-system.netlify.app/?path=/docs/components-radio-group-radio--docs#with-border), [Group](https://pine-design-system.netlify.app/?path=/docs/components-radio-group-radio--docs#group), [With Image](https://pine-design-system.netlify.app/?path=/docs/components-radio-group-radio--docs#with-image)\n\n**Slots:**\n- `image` - Custom image content to display instead of the default radio input\n\n**CSS Parts:**\n- `image-container` - The container for the image\n\n**Events:**\n- `pdsRadioChange` - Emits a boolean indicating whether the radio is currently checked or unchecked."
+        "value": "Radio components allow users to select one option from a group of two or more choices.\n\n**Examples:**\n[Default](https://pine-design-system.netlify.app/?path=/docs/components-radio-group-radio--docs#default), [Checked](https://pine-design-system.netlify.app/?path=/docs/components-radio-group-radio--docs#checked), [Disabled](https://pine-design-system.netlify.app/?path=/docs/components-radio-group-radio--docs#disabled), [Message](https://pine-design-system.netlify.app/?path=/docs/components-radio-group-radio--docs#message), [Invalid](https://pine-design-system.netlify.app/?path=/docs/components-radio-group-radio--docs#invalid), [With Border](https://pine-design-system.netlify.app/?path=/docs/components-radio-group-radio--docs#with-border), [Pill](https://pine-design-system.netlify.app/?path=/docs/components-radio-group-radio--docs#pill), [Group](https://pine-design-system.netlify.app/?path=/docs/components-radio-group-radio--docs#group), [With Image](https://pine-design-system.netlify.app/?path=/docs/components-radio-group-radio--docs#with-image)\n\n**Slots:**\n- `image` - Custom image content to display instead of the default radio input. Ignored when `variant` is `pill`.\n\n**CSS Parts:**\n- `image-container` - The container for the image\n\n**Events:**\n- `pdsRadioChange` - Emits a boolean indicating whether the radio is currently checked or unchecked."
       },
       "attributes": [
         {
@@ -9807,7 +9900,7 @@
           "name": "has-border",
           "description": {
             "kind": "markdown",
-            "value": "Adds a border around the radio component for better visual separation.\n\n**Default:** `false`"
+            "value": "Adds a border around the radio component for better visual separation. Ignored when `variant` is `pill`.\n\n**Default:** `false`"
           }
         },
         {
@@ -9821,7 +9914,7 @@
           "name": "hide-label",
           "description": {
             "kind": "markdown",
-            "value": "Visually hides the label text for instances where only the radio should be displayed. Label remains accessible to assistive technology such as screen readers."
+            "value": "Visually hides the label text for instances where only the radio should be displayed. Label remains accessible to assistive technology such as screen readers. Ignored when `variant` is `pill`."
           }
         },
         {
@@ -9858,6 +9951,21 @@
             "kind": "markdown",
             "value": "The value of the radio that is submitted with a form."
           }
+        },
+        {
+          "name": "variant",
+          "description": {
+            "kind": "markdown",
+            "value": "Sets the style variant of the radio. `pill` renders the label as a pill-shaped choice; the native input still handles keyboard, form, and screen reader behavior.\n\n**Type:** `\"default\" | \"pill\"`\n\n**Default:** `'default'`"
+          },
+          "values": [
+            {
+              "name": "default"
+            },
+            {
+              "name": "pill"
+            }
+          ]
         }
       ],
       "references": [
@@ -9871,7 +9979,7 @@
       "name": "pds-radio-group",
       "description": {
         "kind": "markdown",
-        "value": "Radio Groups wrap a set of related radio inputs, displaying a single error message and helper message for the whole group. Use them whenever users must pick exactly one option from a set.\n\n**Examples:**\n[Default](https://pine-design-system.netlify.app/?path=/docs/components-radio-group--docs#default), [With Label](https://pine-design-system.netlify.app/?path=/docs/components-radio-group--docs#with-label), [With Helper Messages on Child Radios](https://pine-design-system.netlify.app/?path=/docs/components-radio-group--docs#with-helper-messages-on-child-radios), [Invalid](https://pine-design-system.netlify.app/?path=/docs/components-radio-group--docs#invalid), [With Helper Message](https://pine-design-system.netlify.app/?path=/docs/components-radio-group--docs#with-helper-message), [Disabled](https://pine-design-system.netlify.app/?path=/docs/components-radio-group--docs#disabled), [Horizontal Layout](https://pine-design-system.netlify.app/?path=/docs/components-radio-group--docs#horizontal-layout), [With Images](https://pine-design-system.netlify.app/?path=/docs/components-radio-group--docs#with-images)\n\n**Slots:**\n- `(default)` - Child pds-radio components\n\n**Events:**\n- `pdsRadioGroupChange` - Emits when a radio in the group is selected, providing the selected value and component ID."
+        "value": "Radio Groups wrap a set of related radio inputs, displaying a single error message and helper message for the whole group. Use them whenever users must pick exactly one option from a set.\n\n**Examples:**\n[Default](https://pine-design-system.netlify.app/?path=/docs/components-radio-group--docs#default), [With Label](https://pine-design-system.netlify.app/?path=/docs/components-radio-group--docs#with-label), [With Helper Messages on Child Radios](https://pine-design-system.netlify.app/?path=/docs/components-radio-group--docs#with-helper-messages-on-child-radios), [Invalid](https://pine-design-system.netlify.app/?path=/docs/components-radio-group--docs#invalid), [With Helper Message](https://pine-design-system.netlify.app/?path=/docs/components-radio-group--docs#with-helper-message), [Disabled](https://pine-design-system.netlify.app/?path=/docs/components-radio-group--docs#disabled), [Horizontal Layout](https://pine-design-system.netlify.app/?path=/docs/components-radio-group--docs#horizontal-layout), [Pill](https://pine-design-system.netlify.app/?path=/docs/components-radio-group--docs#pill), [With Images](https://pine-design-system.netlify.app/?path=/docs/components-radio-group--docs#with-images)\n\n**Slots:**\n- `(default)` - Child pds-radio components\n\n**Events:**\n- `pdsRadioGroupChange` - Emits when a radio in the group is selected, providing the selected value and component ID."
       },
       "attributes": [
         {
@@ -11453,6 +11561,13 @@
             "value": "The name of the icon to display in the toast."
           }
         },
+        {
+          "name": "severity-label",
+          "description": {
+            "kind": "markdown",
+            "value": "Accessible label announcing the toast's severity, read before the message.\nPass a translated string to localize it; defaults to English (`Error`) for\nthe `danger` type. Other types announce none unless this is set; pass an\nempty string to announce none."
+          }
+        },
         {
           "name": "type",
           "description": {