@pine-ds/core 4.12.0 → 5.0.0

package/dist/vscode.html-data.json

@@ -12,7 +12,7 @@
           "name": "component-id",
           "description": {
             "kind": "markdown",
-            "value": "A unique identifier used for the underlying component `id` attribute."
+            "value": "A unique identifier for this component instance. Does not set the host element's `id` attribute — set `id` directly if you need one."
           }
         },
         {
@@ -41,7 +41,7 @@
           "name": "component-id",
           "description": {
             "kind": "markdown",
-            "value": "A unique identifier used for the underlying component `id` attribute."
+            "value": "A unique identifier for this component instance. Does not set the host element's `id` attribute — set `id` directly if you need one."
           }
         },
         {
@@ -150,7 +150,7 @@
           "name": "component-id",
           "description": {
             "kind": "markdown",
-            "value": "A unique identifier used for the underlying component `id` attribute."
+            "value": "A unique identifier for this component instance. Does not set the host element's `id` attribute — set `id` directly if you need one."
           }
         },
         {
@@ -6894,7 +6894,7 @@
           "name": "component-id",
           "description": {
             "kind": "markdown",
-            "value": "A unique identifier used for the underlying component `id` attribute."
+            "value": "A unique identifier for this component instance. Does not set the host element's `id` attribute — set `id` directly if you need one."
           }
         },
         {
@@ -7183,7 +7183,7 @@
           "name": "component-id",
           "description": {
             "kind": "markdown",
-            "value": "A unique identifier used for the underlying component `id` attribute."
+            "value": "A unique identifier for this component instance. Does not set the host element's `id` attribute — set `id` directly if you need one."
           }
         },
         {
@@ -7827,7 +7827,7 @@
           "name": "component-id",
           "description": {
             "kind": "markdown",
-            "value": "A unique identifier used for the underlying component `id` attribute."
+            "value": "A unique identifier for this component instance. Does not set the host element's `id` attribute — set `id` directly if you need one."
           }
         },
         {
@@ -8245,7 +8245,7 @@
           "name": "component-id",
           "description": {
             "kind": "markdown",
-            "value": "A unique identifier used for the underlying component `id` attribute."
+            "value": "A unique identifier for this component instance. Does not set the host element's `id` attribute — set `id` directly if you need one."
           }
         },
         {
@@ -8448,7 +8448,7 @@
           "name": "component-id",
           "description": {
             "kind": "markdown",
-            "value": "A unique identifier used for the underlying component `id` attribute."
+            "value": "A unique identifier for this component instance. Does not set the host element's `id` attribute — set `id` directly if you need one."
           }
         },
         {
@@ -8515,7 +8515,7 @@
           "name": "component-id",
           "description": {
             "kind": "markdown",
-            "value": "A unique identifier used for the underlying component `id` attribute."
+            "value": "A unique identifier for this component instance. Does not set the host element's `id` attribute — set `id` directly if you need one."
           }
         },
         {
@@ -8607,7 +8607,7 @@
           "name": "component-id",
           "description": {
             "kind": "markdown",
-            "value": "A unique identifier used for the underlying component `id` attribute."
+            "value": "A unique identifier for this component instance. Does not set the host element's `id` attribute — set `id` directly if you need one."
           }
         },
         {
@@ -8636,7 +8636,7 @@
           "name": "component-id",
           "description": {
             "kind": "markdown",
-            "value": "A unique identifier used for the underlying component `id` attribute."
+            "value": "A unique identifier for this component instance, used to build its internal popover's `id`.\nDoes not set the host element's `id` attribute — set `id` directly if you need one."
           }
         },
         {
@@ -8693,7 +8693,7 @@
           "name": "component-id",
           "description": {
             "kind": "markdown",
-            "value": "A unique identifier used for the underlying component `id` attribute."
+            "value": "A unique identifier for this component instance. Does not set the host element's `id` attribute — set `id` directly if you need one."
           }
         }
       ],
@@ -8722,7 +8722,7 @@
           "name": "component-id",
           "description": {
             "kind": "markdown",
-            "value": "A unique identifier used for the underlying component `id` attribute."
+            "value": "A unique identifier for this component instance. Does not set the host element's `id` attribute — set `id` directly if you need one."
           }
         },
         {
@@ -9403,7 +9403,7 @@
       "name": "pds-multiselect",
       "description": {
         "kind": "markdown",
-        "value": "Multiselects let users pick several options from a searchable dropdown list. The trigger displays the selected count while the panel surfaces a filterable list of choices.\n\n**Examples:**\n[Default](https://pine-design-system.netlify.app/?path=/docs/components-multiselect--docs#default), [With Preselected Values](https://pine-design-system.netlify.app/?path=/docs/components-multiselect--docs#with-preselected-values), [Hidden Selected Items](https://pine-design-system.netlify.app/?path=/docs/components-multiselect--docs#hidden-selected-items), [Max Selections](https://pine-design-system.netlify.app/?path=/docs/components-multiselect--docs#max-selections), [Custom Widths](https://pine-design-system.netlify.app/?path=/docs/components-multiselect--docs#custom-widths), [Async with URL](https://pine-design-system.netlify.app/?path=/docs/components-multiselect--docs#async-with-url), [Refreshing Options](https://pine-design-system.netlify.app/?path=/docs/components-multiselect--docs#refreshing-options), [Consumer-Managed Async](https://pine-design-system.netlify.app/?path=/docs/components-multiselect--docs#consumer-managed-async), [With Error State](https://pine-design-system.netlify.app/?path=/docs/components-multiselect--docs#with-error-state), [With Create Option](https://pine-design-system.netlify.app/?path=/docs/components-multiselect--docs#with-create-option)\n\n**Slots:**\n- `(default)` - Static option elements for the multiselect\n- `empty` - Custom empty state message when no options match\n- `footer` - Links or buttons displayed below the options inside the dropdown panel\n- `loading` - Custom loading indicator\n- `trigger` - Custom trigger element that replaces the built-in trigger. It opens the dropdown panel and receives `aria-expanded` and `aria-haspopup`; it supplies its own accessible name. Slot the focusable control itself, not a wrapper around it.\n\n**CSS Parts:**\n- `pill-toggle` - The chevron button inside the inline pill trigger\n- `trigger` - The trigger surface that opens the dropdown panel\n\n**Events:**\n- `pdsMultiselectChange` - Emitted when selection changes.\n- `pdsMultiselectCreate` - Emitted when a new option is created.\n- `pdsMultiselectDismiss` - Emitted when the dropdown is dismissed with the Escape key, or by focus moving outside the\ncomponent, such as with a click elsewhere on the page.\n\nIt doesn't fire when the panel closes any other way: from a selection (including with\n`closePanelOnSelect`) or an option action, a click on the trigger, Tab, or the multiselect\nbecoming disabled. Safari doesn't focus a clicked button, so there a click on the trigger while\nthe panel is open fires this event, and the panel opens again.\nUse it to restore parent UI state or run cleanup when the user cancels.\n- `pdsMultiselectLoadOptions` - Emitted to request more options (pagination).\n- `pdsMultiselectOptionAction` - Emitted when an option's action runs, from a click on its icon or Right Arrow on the highlighted option.\nThe panel closes and focus returns to the trigger first, so a modal opened from the handler restores focus to the trigger.\n- `pdsMultiselectSearch` - Emitted on search input (for consumer-managed async)."
+        "value": "Multiselects let users pick several options from a searchable dropdown list. The trigger displays the selected item's name, or a count when several are selected, while the panel surfaces a filterable list of choices.\n\n**Examples:**\n[Default](https://pine-design-system.netlify.app/?path=/docs/components-multiselect--docs#default), [With Preselected Values](https://pine-design-system.netlify.app/?path=/docs/components-multiselect--docs#with-preselected-values), [Hidden Selected Items](https://pine-design-system.netlify.app/?path=/docs/components-multiselect--docs#hidden-selected-items), [Max Selections](https://pine-design-system.netlify.app/?path=/docs/components-multiselect--docs#max-selections), [Custom Widths](https://pine-design-system.netlify.app/?path=/docs/components-multiselect--docs#custom-widths), [Async with URL](https://pine-design-system.netlify.app/?path=/docs/components-multiselect--docs#async-with-url), [Refreshing Options](https://pine-design-system.netlify.app/?path=/docs/components-multiselect--docs#refreshing-options), [Consumer-Managed Async](https://pine-design-system.netlify.app/?path=/docs/components-multiselect--docs#consumer-managed-async), [With Error State](https://pine-design-system.netlify.app/?path=/docs/components-multiselect--docs#with-error-state), [With Create Option](https://pine-design-system.netlify.app/?path=/docs/components-multiselect--docs#with-create-option)\n\n**Slots:**\n- `(default)` - Static option elements for the multiselect\n- `empty` - Custom empty state message when no options match\n- `footer` - Links or buttons displayed below the options inside the dropdown panel\n- `loading` - Custom loading indicator\n- `trigger` - Custom trigger element that replaces the built-in trigger. It opens the dropdown panel and receives `aria-expanded` and `aria-haspopup`; it supplies its own accessible name. Slot the focusable control itself, not a wrapper around it.\n\n**CSS Parts:**\n- `pill-toggle` - The chevron button inside the inline pill trigger\n- `trigger` - The trigger surface that opens the dropdown panel\n\n**Events:**\n- `pdsMultiselectChange` - Emitted when selection changes.\n- `pdsMultiselectCreate` - Emitted when a new option is created.\n- `pdsMultiselectDismiss` - Emitted when the dropdown is dismissed with the Escape key, or by focus moving outside the\ncomponent, such as with a click elsewhere on the page.\n\nIt doesn't fire when the panel closes any other way: from a selection (including with\n`closePanelOnSelect`) or an option action, a click on the trigger, Tab, or the multiselect\nbecoming disabled. Safari doesn't focus a clicked button, so there a click on the trigger while\nthe panel is open fires this event, and the panel opens again.\nUse it to restore parent UI state or run cleanup when the user cancels.\n- `pdsMultiselectLoadOptions` - Emitted to request more options (pagination).\n- `pdsMultiselectOptionAction` - Emitted when an option's action runs, from a click on its icon or Right Arrow on the highlighted option.\nThe panel closes and focus returns to the trigger first, so a modal opened from the handler restores focus to the trigger.\n- `pdsMultiselectSearch` - Emitted on search input (for consumer-managed async)."
       },
       "attributes": [
         {
@@ -9700,7 +9700,7 @@
           "name": "selected-count-label-one",
           "description": {
             "kind": "markdown",
-            "value": "Singular form of the selected-count trigger text. Pass a translated string to localize it; `{count}` is interpolated.\n\n**Default:** `'{count} item'`"
+            "value": "Singular form of the selected-count trigger text. Pass a translated string to localize it; `{count}` is interpolated.\nA single selection shows the item's name instead, so this applies to other counts that a locale's plural rules treat as singular, and to a single selection whose item has no text.\n\n**Default:** `'{count} item'`"
           }
         },
         {
@@ -9714,7 +9714,7 @@
           "name": "selected-count-labels",
           "description": {
             "kind": "markdown",
-            "value": "Full CLDR plural forms for the selected-count trigger text, for locales with more than the English `one`/`other` categories (e.g. Polish `few`/`many`, Arabic `zero`/`two`). Accepts an object property or a JSON string attribute keyed by CLDR category — `{ one, other, few, many, two, zero }`. Any form omitted here falls back to `selectedCountLabelOne`/`selectedCountLabelOther`. `{count}` is interpolated.\n\n**Type:** `\"few\" | \"many\" | \"one\" | \"other\" | \"two\" | \"zero\" | string`"
+            "value": "Full CLDR plural forms for the selected-count trigger text, for locales with more than the English `one`/`other` categories (e.g. Polish `few`/`many`, Arabic `zero`/`two`). Accepts an object property or a JSON string attribute keyed by CLDR category — `{ one, other, few, many, two, zero }`. Any form omitted here falls back to `selectedCountLabelOne`/`selectedCountLabelOther`. `{count}` is interpolated. A single selection shows the item's name instead of any form, unless the item has no text.\n\n**Type:** `\"few\" | \"many\" | \"one\" | \"other\" | \"two\" | \"zero\" | string`"
           },
           "values": [
             {
@@ -9741,7 +9741,7 @@
           "name": "selected-display",
           "description": {
             "kind": "markdown",
-            "value": "Display mode for selected items outside the dropdown panel.\n`'count'` shows \"N item(s)\" text in the trigger (default). `'pill'` renders\nselected items as dismissible pds-chip tags.\n\n**Type:** `\"count\" | \"pill\"`\n\n**Default:** `'count'`"
+            "value": "Display mode for selected items outside the dropdown panel.\n`'count'` shows the item's name in the trigger when one is selected and\n\"N items\" text otherwise (default). `'pill'` renders selected items as\ndismissible pds-chip tags.\n\n**Type:** `\"count\" | \"pill\"`\n\n**Default:** `'count'`"
           },
           "values": [
             {
@@ -9785,7 +9785,7 @@
           "name": "component-id",
           "description": {
             "kind": "markdown",
-            "value": "A unique identifier used for the underlying component `id` attribute."
+            "value": "A unique identifier for this component instance, used to build its portal element's `id`.\nDoes not set the host element's `id` attribute — set `id` directly if you need one."
           }
         },
         {
@@ -9985,7 +9985,7 @@
           "name": "component-id",
           "description": {
             "kind": "markdown",
-            "value": "A unique identifier used for the underlying component `id` attribute."
+            "value": "A unique identifier for this component instance. Does not set the host element's `id` attribute — set `id` directly if you need one."
           }
         },
         {
@@ -10128,7 +10128,7 @@
           "name": "component-id",
           "description": {
             "kind": "markdown",
-            "value": "A unique identifier used for the underlying component `id` attribute."
+            "value": "A unique identifier for this component instance, used to build its helper and error message `id`s.\nDoes not set the host element's `id` attribute — set `id` directly if you need one."
           }
         },
         {
@@ -10686,7 +10686,7 @@
           "name": "component-id",
           "description": {
             "kind": "markdown",
-            "value": "A unique identifier used for the sortable container `id` attribute."
+            "value": "A unique identifier for this component instance. Does not set the host element's `id` attribute — set `id` directly if you need one."
           }
         },
         {
@@ -10772,7 +10772,7 @@
           "name": "component-id",
           "description": {
             "kind": "markdown",
-            "value": "A unique identifier used for the sortable item `id` attribute."
+            "value": "A unique identifier for this component instance. Does not set the host element's `id` attribute — set `id` directly if you need one."
           }
         },
         {
@@ -10808,7 +10808,7 @@
       "name": "pds-switch",
       "description": {
         "kind": "markdown",
-        "value": "Switches toggle a single setting between on and off, rendered as a sliding thumb inside a track. They work as form-associated inputs whose checked state submits with the surrounding form.\n\n**Examples:**\n[Default](https://pine-design-system.netlify.app/?path=/docs/components-switch--docs#default), [Disabled](https://pine-design-system.netlify.app/?path=/docs/components-switch--docs#disabled), [Disabled with a reason](https://pine-design-system.netlify.app/?path=/docs/components-switch--docs#disabled-with-a-reason), [Helper Message](https://pine-design-system.netlify.app/?path=/docs/components-switch--docs#helper-message), [Invalid](https://pine-design-system.netlify.app/?path=/docs/components-switch--docs#invalid), [Label slot](https://pine-design-system.netlify.app/?path=/docs/components-switch--docs#label-slot), [Described by text outside it](https://pine-design-system.netlify.app/?path=/docs/components-switch--docs#described-by-text-outside-it)\n\n**Slots:**\n- `label` - Content displayed as the switch label in place of the `label` text. Clicking it toggles the switch.\n\n**Events:**\n- `pdsSwitchChange` - Emits an event on input change."
+        "value": "Switches toggle a single setting between on and off, rendered as a sliding thumb inside a track. They work as form-associated inputs whose checked state submits with the surrounding form.\n\n**Examples:**\n[Default](https://pine-design-system.netlify.app/?path=/docs/components-switch--docs#default), [Disabled](https://pine-design-system.netlify.app/?path=/docs/components-switch--docs#disabled), [Disabled with a reason](https://pine-design-system.netlify.app/?path=/docs/components-switch--docs#disabled-with-a-reason), [Helper Message](https://pine-design-system.netlify.app/?path=/docs/components-switch--docs#helper-message), [Invalid](https://pine-design-system.netlify.app/?path=/docs/components-switch--docs#invalid), [Label slot](https://pine-design-system.netlify.app/?path=/docs/components-switch--docs#label-slot), [Described by text outside it](https://pine-design-system.netlify.app/?path=/docs/components-switch--docs#described-by-text-outside-it)\n\n**Slots:**\n- `label` - Content displayed as the switch label in place of the `label` text. Clicking it toggles the switch.\n\n**Events:**\n- `pdsSwitchChange` - Emitted when the user toggles the switch, by a click or `Space`. `detail` is the native `change` event, so read\nthe new state from the switch's `checked`.\n\nThis event will not emit when programmatically setting the `checked` property."
       },
       "attributes": [
         {
@@ -10836,14 +10836,14 @@
           "name": "error-message",
           "description": {
             "kind": "markdown",
-            "value": "Displays message text describing an invalid state."
+            "value": "Displays an error message below the switch. It becomes the switch's accessible description only while `invalid` is set."
           }
         },
         {
           "name": "helper-message",
           "description": {
             "kind": "markdown",
-            "value": "Displays help text for additional description of an input."
+            "value": "Displays a message or hint below the switch."
           }
         },
         {
@@ -10857,14 +10857,14 @@
           "name": "invalid",
           "description": {
             "kind": "markdown",
-            "value": "Determines the input 'invalid' state, signifying an error is present.\n\n**Default:** `false`"
+            "value": "Determines whether or not the switch is invalid.\n\n**Default:** `false`"
           }
         },
         {
           "name": "label",
           "description": {
             "kind": "markdown",
-            "value": "Displays text to describe the input."
+            "value": "Text to be displayed as the switch label."
           }
         },
         {
@@ -11007,7 +11007,7 @@
           "name": "component-id",
           "description": {
             "kind": "markdown",
-            "value": "A unique identifier used for the table `id` attribute."
+            "value": "A unique identifier for this component instance. Does not set the host element's `id` attribute — set `id` directly if you need one."
           }
         },
         {
@@ -11309,7 +11309,7 @@
           "name": "component-id",
           "description": {
             "kind": "markdown",
-            "value": "A unique identifier used for the underlying component `id` attribute."
+            "value": "A unique identifier for this component instance, passed down to its tabs and panels.\nDoes not set the host element's `id` attribute — set `id` directly if you need one."
           }
         },
         {
@@ -11818,7 +11818,7 @@
           "name": "component-id",
           "description": {
             "kind": "markdown",
-            "value": "A unique identifier used for the underlying component `id` attribute."
+            "value": "A unique identifier for this component instance, used to build its portal element's `id`.\nDoes not set the host element's `id` attribute — set `id` directly if you need one."
           }
         },
         {