@pine-ds/core 3.23.0 → 3.24.1

package/dist/types/components.d.ts

@@ -1017,6 +1017,22 @@ export namespace Components {
          */
         "value": string;
     }
+    interface PdsContainer {
+        /**
+          * If `true`, the container is centered horizontally using `margin-inline: auto`.
+          * @default true
+         */
+        "centered": boolean;
+        /**
+          * Sets the maximum width of the container. Accepts a named size token (`'sm'` | `'md'` | `'lg'` | `'xl'` | `'full'`) or any valid CSS length value (e.g. `'640px'`, `'50rem'`). When omitted, no max-width is applied.
+         */
+        "size"?: string;
+        /**
+          * Sets the semantic HTML tag rendered as the inner container element.
+          * @default 'div'
+         */
+        "tag": 'div' | 'main' | 'section' | 'article';
+    }
     interface PdsCopytext {
         /**
           * Determines whether `copytext` should have a visible border.
@@ -2547,6 +2563,12 @@ declare global {
         prototype: HTMLPdsComboboxElement;
         new (): HTMLPdsComboboxElement;
     };
+    interface HTMLPdsContainerElement extends Components.PdsContainer, HTMLStencilElement {
+    }
+    var HTMLPdsContainerElement: {
+        prototype: HTMLPdsContainerElement;
+        new (): HTMLPdsContainerElement;
+    };
     interface HTMLPdsCopytextElementEventMap {
         "pdsCopyTextClick": string;
     }
@@ -3025,6 +3047,7 @@ declare global {
         "pds-checkbox": HTMLPdsCheckboxElement;
         "pds-chip": HTMLPdsChipElement;
         "pds-combobox": HTMLPdsComboboxElement;
+        "pds-container": HTMLPdsContainerElement;
         "pds-copytext": HTMLPdsCopytextElement;
         "pds-divider": HTMLPdsDividerElement;
         "pds-dropdown-menu": HTMLPdsDropdownMenuElement;
@@ -4080,6 +4103,22 @@ declare namespace LocalJSX {
          */
         "value"?: string;
     }
+    interface PdsContainer {
+        /**
+          * If `true`, the container is centered horizontally using `margin-inline: auto`.
+          * @default true
+         */
+        "centered"?: boolean;
+        /**
+          * Sets the maximum width of the container. Accepts a named size token (`'sm'` | `'md'` | `'lg'` | `'xl'` | `'full'`) or any valid CSS length value (e.g. `'640px'`, `'50rem'`). When omitted, no max-width is applied.
+         */
+        "size"?: string;
+        /**
+          * Sets the semantic HTML tag rendered as the inner container element.
+          * @default 'div'
+         */
+        "tag"?: 'div' | 'main' | 'section' | 'article';
+    }
     interface PdsCopytext {
         /**
           * Determines whether `copytext` should have a visible border.
@@ -5442,6 +5481,7 @@ declare namespace LocalJSX {
         "pds-checkbox": PdsCheckbox;
         "pds-chip": PdsChip;
         "pds-combobox": PdsCombobox;
+        "pds-container": PdsContainer;
         "pds-copytext": PdsCopytext;
         "pds-divider": PdsDivider;
         "pds-dropdown-menu": PdsDropdownMenu;
@@ -5500,6 +5540,7 @@ declare module "@stencil/core" {
             "pds-checkbox": LocalJSX.PdsCheckbox & JSXBase.HTMLAttributes<HTMLPdsCheckboxElement>;
             "pds-chip": LocalJSX.PdsChip & JSXBase.HTMLAttributes<HTMLPdsChipElement>;
             "pds-combobox": LocalJSX.PdsCombobox & JSXBase.HTMLAttributes<HTMLPdsComboboxElement>;
+            "pds-container": LocalJSX.PdsContainer & JSXBase.HTMLAttributes<HTMLPdsContainerElement>;
             "pds-copytext": LocalJSX.PdsCopytext & JSXBase.HTMLAttributes<HTMLPdsCopytextElement>;
             "pds-divider": LocalJSX.PdsDivider & JSXBase.HTMLAttributes<HTMLPdsDividerElement>;
             "pds-dropdown-menu": LocalJSX.PdsDropdownMenu & JSXBase.HTMLAttributes<HTMLPdsDropdownMenuElement>;

package/dist/vscode.html-data.json

@@ -34,7 +34,7 @@
       "name": "pds-alert",
       "description": {
         "kind": "markdown",
-        "value": "The alert component is used to display a message to the user. It can be used to display important information, success messages, warnings, or errors.\n\n**Examples:**\n[Variants](https://pine-design-system.netlify.app/?path=/docs/components-alert--docs#variants), [Default](https://pine-design-system.netlify.app/?path=/docs/components-alert--docs#default), [Small](https://pine-design-system.netlify.app/?path=/docs/components-alert--docs#small), [Actions](https://pine-design-system.netlify.app/?path=/docs/components-alert--docs#actions), [Small with actions](https://pine-design-system.netlify.app/?path=/docs/components-alert--docs#small-with-actions), [Dismissible](https://pine-design-system.netlify.app/?path=/docs/components-alert--docs#dismissible), [Small dismissible](https://pine-design-system.netlify.app/?path=/docs/components-alert--docs#small-dismissible)\n\n**Slots:**\n- `actions` - Slot for alert actions.\n\n**CSS Parts:**\n- `dismiss` - No description\n\n**Events:**\n- `pdsAlertDismissClick` - Event emitted when the dismiss button is clicked."
+        "value": "Alerts display inline messages with distinct variants for information, success, warnings, errors, and other states. They can be dismissible and include an actions slot for related buttons.\n\n**Examples:**\n[Variants](https://pine-design-system.netlify.app/?path=/docs/components-alert--docs#variants), [Default](https://pine-design-system.netlify.app/?path=/docs/components-alert--docs#default), [Small](https://pine-design-system.netlify.app/?path=/docs/components-alert--docs#small), [Actions](https://pine-design-system.netlify.app/?path=/docs/components-alert--docs#actions), [Small with actions](https://pine-design-system.netlify.app/?path=/docs/components-alert--docs#small-with-actions), [Dismissible](https://pine-design-system.netlify.app/?path=/docs/components-alert--docs#dismissible), [Small dismissible](https://pine-design-system.netlify.app/?path=/docs/components-alert--docs#small-dismissible)\n\n**Slots:**\n- `actions` - Slot for alert actions.\n\n**CSS Parts:**\n- `dismiss` - No description\n\n**Events:**\n- `pdsAlertDismissClick` - Event emitted when the dismiss button is clicked."
       },
       "attributes": [
         {
@@ -101,7 +101,7 @@
       "name": "pds-avatar",
       "description": {
         "kind": "markdown",
-        "value": "The avatar component is used to display a thumbnail representation of an admin, customer, or business.\n\n**Examples:**\n[Default](https://pine-design-system.netlify.app/?path=/docs/components-avatar--docs#default), [Admin](https://pine-design-system.netlify.app/?path=/docs/components-avatar--docs#admin), [Badge](https://pine-design-system.netlify.app/?path=/docs/components-avatar--docs#badge), [Custom Sizes](https://pine-design-system.netlify.app/?path=/docs/components-avatar--docs#custom-sizes), [Dropdown](https://pine-design-system.netlify.app/?path=/docs/components-avatar--docs#dropdown), [Image](https://pine-design-system.netlify.app/?path=/docs/components-avatar--docs#image), [Initials](https://pine-design-system.netlify.app/?path=/docs/components-avatar--docs#initials), [Initials with Badge](https://pine-design-system.netlify.app/?path=/docs/components-avatar--docs#initials-with-badge)\n\n**CSS Parts:**\n- `asset-wrapper` - No description\n- `button` - No description\n- `image` - The main image element that represents the avatar component."
+        "value": "Avatars display a thumbnail representation of a person or organization, supporting an image, an initials fallback, and an optional badge. They can also function as a dropdown trigger.\n\n**Examples:**\n[Default](https://pine-design-system.netlify.app/?path=/docs/components-avatar--docs#default), [Admin](https://pine-design-system.netlify.app/?path=/docs/components-avatar--docs#admin), [Badge](https://pine-design-system.netlify.app/?path=/docs/components-avatar--docs#badge), [Custom Sizes](https://pine-design-system.netlify.app/?path=/docs/components-avatar--docs#custom-sizes), [Dropdown](https://pine-design-system.netlify.app/?path=/docs/components-avatar--docs#dropdown), [Image](https://pine-design-system.netlify.app/?path=/docs/components-avatar--docs#image), [Initials](https://pine-design-system.netlify.app/?path=/docs/components-avatar--docs#initials), [Initials with Badge](https://pine-design-system.netlify.app/?path=/docs/components-avatar--docs#initials-with-badge)\n\n**CSS Parts:**\n- `asset-wrapper` - No description\n- `button` - No description\n- `image` - The main image element that represents the avatar component."
       },
       "attributes": [
         {
@@ -7419,11 +7419,61 @@
         }
       ]
     },
+    {
+      "name": "pds-container",
+      "description": {
+        "kind": "markdown",
+        "value": "Container constrains its children to a semantic max-width, centering them within the available space. Use it to wrap form panels, settings pages, and full-page flows.\n\n**Examples:**\n[Default](https://pine-design-system.netlify.app/?path=/docs/components-layout-container--docs#default), [Named Sizes](https://pine-design-system.netlify.app/?path=/docs/components-layout-container--docs#named-sizes), [Arbitrary Size](https://pine-design-system.netlify.app/?path=/docs/components-layout-container--docs#arbitrary-size), [Not Centered](https://pine-design-system.netlify.app/?path=/docs/components-layout-container--docs#not-centered), [Semantic Tag](https://pine-design-system.netlify.app/?path=/docs/components-layout-container--docs#semantic-tag)\n\n**CSS Parts:**\n- `container` - The inner semantic container element"
+      },
+      "attributes": [
+        {
+          "name": "centered",
+          "description": {
+            "kind": "markdown",
+            "value": "If `true`, the container is centered horizontally using `margin-inline: auto`.\n\n**Default:** `true`"
+          }
+        },
+        {
+          "name": "size",
+          "description": {
+            "kind": "markdown",
+            "value": "Sets the maximum width of the container. Accepts a named size token\n(`'sm'` | `'md'` | `'lg'` | `'xl'` | `'full'`) or any valid CSS length value (e.g. `'640px'`, `'50rem'`).\nWhen omitted, no max-width is applied."
+          }
+        },
+        {
+          "name": "tag",
+          "description": {
+            "kind": "markdown",
+            "value": "Sets the semantic HTML tag rendered as the inner container element.\n\n**Type:** `\"article\" | \"div\" | \"main\" | \"section\"`\n\n**Default:** `'div'`"
+          },
+          "values": [
+            {
+              "name": "article"
+            },
+            {
+              "name": "div"
+            },
+            {
+              "name": "main"
+            },
+            {
+              "name": "section"
+            }
+          ]
+        }
+      ],
+      "references": [
+        {
+          "name": "Documentation",
+          "url": "https://pine-design-system.netlify.app/?path=/docs/components-layout-container--docs"
+        }
+      ]
+    },
     {
       "name": "pds-copytext",
       "description": {
         "kind": "markdown",
-        "value": "The Copy Text component is a button that enables users to copy text to their clipboard upon interaction.\n\n**Examples:**\n[Default](https://pine-design-system.netlify.app/?path=/docs/components-copy-text--docs#default), [Borderless](https://pine-design-system.netlify.app/?path=/docs/components-copy-text--docs#borderless), [Full width](https://pine-design-system.netlify.app/?path=/docs/components-copy-text--docs#full-width), [Truncate](https://pine-design-system.netlify.app/?path=/docs/components-copy-text--docs#truncate)\n\n**Events:**\n- `pdsCopyTextClick` - Event fired when copyText button is clicked."
+        "value": "Copy Text displays a value alongside a copy button, letting users copy codes, IDs, or short strings to their clipboard in a single click. It supports truncation with a hover tooltip for long values.\n\n**Examples:**\n[Default](https://pine-design-system.netlify.app/?path=/docs/components-copy-text--docs#default), [Borderless](https://pine-design-system.netlify.app/?path=/docs/components-copy-text--docs#borderless), [Full width](https://pine-design-system.netlify.app/?path=/docs/components-copy-text--docs#full-width), [Truncate](https://pine-design-system.netlify.app/?path=/docs/components-copy-text--docs#truncate)\n\n**Events:**\n- `pdsCopyTextClick` - Event fired when copyText button is clicked."
       },
       "attributes": [
         {
@@ -7532,7 +7582,7 @@
       "name": "pds-dropdown-menu",
       "description": {
         "kind": "markdown",
-        "value": "\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 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**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 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**CSS Parts:**\n- `menu-panel` - Exposes the dropdown menu container for styling."
       },
       "attributes": [
         {
@@ -7763,7 +7813,7 @@
       "name": "pds-filters",
       "description": {
         "kind": "markdown",
-        "value": "The filters component provides a flexible system for creating filter interfaces with popover content. It consists of a parent `pds-filters` container that manages layout and a child `pds-filter` component for individual filters.\n\n**Examples:**\n[Default](https://pine-design-system.netlify.app/?path=/docs/components-filters--docs#default), [Selected](https://pine-design-system.netlify.app/?path=/docs/components-filters--docs#selected), [More](https://pine-design-system.netlify.app/?path=/docs/components-filters--docs#more), [Clear](https://pine-design-system.netlify.app/?path=/docs/components-filters--docs#clear)\n\n**Slots:**\n- `(default)` - Container for pds-filter components."
+        "value": "Filters provide a flexible system for building filter interfaces from a row of popover triggers. A parent pds-filters container manages layout while individual pds-filter children hold the popover content for each facet.\n\n**Examples:**\n[Default](https://pine-design-system.netlify.app/?path=/docs/components-filters--docs#default), [Selected](https://pine-design-system.netlify.app/?path=/docs/components-filters--docs#selected), [More](https://pine-design-system.netlify.app/?path=/docs/components-filters--docs#more), [Clear](https://pine-design-system.netlify.app/?path=/docs/components-filters--docs#clear)\n\n**Slots:**\n- `(default)` - Container for pds-filter components."
       },
       "attributes": [
         {
@@ -7864,7 +7914,7 @@
       "name": "pds-input",
       "description": {
         "kind": "markdown",
-        "value": "An input field coupled with a label and supplemental helper text that aids in user input and feedback.\n\n**Examples:**\n[Default](https://pine-design-system.netlify.app/?path=/docs/components-input--docs#default), [Input Types](https://pine-design-system.netlify.app/?path=/docs/components-input--docs#input-types), [Required](https://pine-design-system.netlify.app/?path=/docs/components-input--docs#required), [Placeholder](https://pine-design-system.netlify.app/?path=/docs/components-input--docs#placeholder), [Disabled](https://pine-design-system.netlify.app/?path=/docs/components-input--docs#disabled), [Readonly](https://pine-design-system.netlify.app/?path=/docs/components-input--docs#readonly), [Highlight](https://pine-design-system.netlify.app/?path=/docs/components-input--docs#highlight), [Full Width](https://pine-design-system.netlify.app/?path=/docs/components-input--docs#full-width), [Helper Message](https://pine-design-system.netlify.app/?path=/docs/components-input--docs#helper-message), [Invalid](https://pine-design-system.netlify.app/?path=/docs/components-input--docs#invalid), [Prefix and Suffix](https://pine-design-system.netlify.app/?path=/docs/components-input--docs#prefix-and-suffix), [Action Slot](https://pine-design-system.netlify.app/?path=/docs/components-input--docs#action-slot), [Prepend and Append](https://pine-design-system.netlify.app/?path=/docs/components-input--docs#prepend-and-append), [Usage Guidelines](https://pine-design-system.netlify.app/?path=/docs/components-input--docs#usage-guidelines)\n\n**Slots:**\n- `action` - Content to be displayed in the label area, typically for help icons or links\n- `append` - Content to be displayed after the input field\n- `prefix` - Content that is displayed visually within the input field before the input field\n- `prepend` - Content to be displayed before the input field\n- `suffix` - Content that is displayed visually within the input field after the input field\n\n**CSS Parts:**\n- `action` - No description\n- `append` - No description\n- `prefix` - No description\n- `prepend` - No description\n- `suffix` - No description\n\n**Events:**\n- `pdsBlur` - Emitted when the input loses focus.\n- `pdsChange` - Emitted when the value has changed.\n\nThis event will not emit when programmatically setting the `value` property.\n- `pdsFocus` - Emitted when the input has focus.\n- `pdsInput` - Emitted when a keyboard input occurs.\n- `pdsKeyDown` - Emitted when a key is pressed down in the input."
+        "value": "Input captures a single line of text from the user, paired with a label and optional helper or error message. Use it for names, emails, IDs, and other short freeform values.\n\n**Examples:**\n[Default](https://pine-design-system.netlify.app/?path=/docs/components-input--docs#default), [Input Types](https://pine-design-system.netlify.app/?path=/docs/components-input--docs#input-types), [Required](https://pine-design-system.netlify.app/?path=/docs/components-input--docs#required), [Placeholder](https://pine-design-system.netlify.app/?path=/docs/components-input--docs#placeholder), [Disabled](https://pine-design-system.netlify.app/?path=/docs/components-input--docs#disabled), [Readonly](https://pine-design-system.netlify.app/?path=/docs/components-input--docs#readonly), [Highlight](https://pine-design-system.netlify.app/?path=/docs/components-input--docs#highlight), [Full Width](https://pine-design-system.netlify.app/?path=/docs/components-input--docs#full-width), [Helper Message](https://pine-design-system.netlify.app/?path=/docs/components-input--docs#helper-message), [Invalid](https://pine-design-system.netlify.app/?path=/docs/components-input--docs#invalid), [Prefix and Suffix](https://pine-design-system.netlify.app/?path=/docs/components-input--docs#prefix-and-suffix), [Action Slot](https://pine-design-system.netlify.app/?path=/docs/components-input--docs#action-slot), [Prepend and Append](https://pine-design-system.netlify.app/?path=/docs/components-input--docs#prepend-and-append), [Usage Guidelines](https://pine-design-system.netlify.app/?path=/docs/components-input--docs#usage-guidelines)\n\n**Slots:**\n- `action` - Content to be displayed in the label area, typically for help icons or links\n- `append` - Content to be displayed after the input field\n- `prefix` - Content that is displayed visually within the input field before the input field\n- `prepend` - Content to be displayed before the input field\n- `suffix` - Content that is displayed visually within the input field after the input field\n\n**CSS Parts:**\n- `action` - No description\n- `append` - No description\n- `prefix` - No description\n- `prepend` - No description\n- `suffix` - No description\n\n**Events:**\n- `pdsBlur` - Emitted when the input loses focus.\n- `pdsChange` - Emitted when the value has changed.\n\nThis event will not emit when programmatically setting the `value` property.\n- `pdsFocus` - Emitted when the input has focus.\n- `pdsInput` - Emitted when a keyboard input occurs.\n- `pdsKeyDown` - Emitted when a key is pressed down in the input."
       },
       "attributes": [
         {
@@ -8144,7 +8194,7 @@
       "name": "pds-loader",
       "description": {
         "kind": "markdown",
-        "value": "The Loader component is a visual indicator that informs users an operation is in progress, enhancing the user experience by providing feedback during potentially time-consuming tasks.\n\n**Examples:**\n[Default](https://pine-design-system.netlify.app/?path=/docs/components-loader--docs#default), [Visible Label](https://pine-design-system.netlify.app/?path=/docs/components-loader--docs#visible-label), [Loader Size](https://pine-design-system.netlify.app/?path=/docs/components-loader--docs#loader-size), [Typing](https://pine-design-system.netlify.app/?path=/docs/components-loader--docs#typing)\n\n**Slots:**\n- `label` - Default slot for Loader label text.\n\n**CSS Parts:**\n- `loader-svg` - Exposes the spinner SVG element for color customization."
+        "value": "Loaders signal that an operation is in progress via an animated spinner or typing indicator. Use them during time-consuming tasks to reassure users that the system is working.\n\n**Examples:**\n[Default](https://pine-design-system.netlify.app/?path=/docs/components-loader--docs#default), [Visible Label](https://pine-design-system.netlify.app/?path=/docs/components-loader--docs#visible-label), [Loader Size](https://pine-design-system.netlify.app/?path=/docs/components-loader--docs#loader-size), [Typing](https://pine-design-system.netlify.app/?path=/docs/components-loader--docs#typing)\n\n**Slots:**\n- `label` - Default slot for Loader label text.\n\n**CSS Parts:**\n- `loader-svg` - Exposes the spinner SVG element for color customization."
       },
       "attributes": [
         {
@@ -8195,7 +8245,7 @@
       "name": "pds-modal",
       "description": {
         "kind": "markdown",
-        "value": "\n\n**Examples:**\n[Variants](https://pine-design-system.netlify.app/?path=/docs/components-modal--docs#variants), [Default](https://pine-design-system.netlify.app/?path=/docs/components-modal--docs#default), [Sizes](https://pine-design-system.netlify.app/?path=/docs/components-modal--docs#sizes), [Destructive Actions](https://pine-design-system.netlify.app/?path=/docs/components-modal--docs#destructive-actions), [Scrollable Content](https://pine-design-system.netlify.app/?path=/docs/components-modal--docs#scrollable-content), [Nested Modals](https://pine-design-system.netlify.app/?path=/docs/components-modal--docs#nested-modals)\n\n**CSS Parts:**\n- `modal` - No description\n\n**Events:**\n- `pdsModalClose` - Emitted when the modal is closed\n- `pdsModalOpen` - Emitted when the modal is opened"
+        "value": "Modals display content in a dialog that temporarily blocks interaction with the underlying page. Use them for confirmations, focused forms, or detailed information that demands attention without navigating away.\n\n**Examples:**\n[Variants](https://pine-design-system.netlify.app/?path=/docs/components-modal--docs#variants), [Default](https://pine-design-system.netlify.app/?path=/docs/components-modal--docs#default), [Sizes](https://pine-design-system.netlify.app/?path=/docs/components-modal--docs#sizes), [Destructive Actions](https://pine-design-system.netlify.app/?path=/docs/components-modal--docs#destructive-actions), [Scrollable Content](https://pine-design-system.netlify.app/?path=/docs/components-modal--docs#scrollable-content), [Nested Modals](https://pine-design-system.netlify.app/?path=/docs/components-modal--docs#nested-modals)\n\n**CSS Parts:**\n- `modal` - No description\n\n**Events:**\n- `pdsModalClose` - Emitted when the modal is closed\n- `pdsModalOpen` - Emitted when the modal is opened"
       },
       "attributes": [
         {
@@ -8323,7 +8373,7 @@
       "name": "pds-multiselect",
       "description": {
         "kind": "markdown",
-        "value": "The multiselect component allows users to select multiple options from a searchable dropdown list. It displays the selected count in the trigger and shows a searchable list of options in a dropdown panel.\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), [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- `loading` - Custom loading indicator\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 via Escape key or click outside.\n\nThis event fires only when the user explicitly dismisses the panel without making a selection:\n- ✅ Fires: Pressing Escape key while dropdown is open\n- ✅ Fires: Clicking outside the component while dropdown is open\n- ❌ Does NOT fire: When panel closes due to selection (including when `closePanelOnSelect` is true)\n- ❌ Does NOT fire: When panel closes programmatically via `closeDropdown()`\n\nEquivalent to Sage's `onEscapeHook`. Use this to restore parent UI state or run cleanup when the user cancels their interaction.\n- `pdsMultiselectLoadOptions` - Emitted to request more options (pagination).\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 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), [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- `loading` - Custom loading indicator\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 via Escape key or click outside.\n\nThis event fires only when the user explicitly dismisses the panel without making a selection:\n- ✅ Fires: Pressing Escape key while dropdown is open\n- ✅ Fires: Clicking outside the component while dropdown is open\n- ❌ Does NOT fire: When panel closes due to selection (including when `closePanelOnSelect` is true)\n- ❌ Does NOT fire: When panel closes programmatically via `closeDropdown()`\n\nEquivalent to Sage's `onEscapeHook`. Use this to restore parent UI state or run cleanup when the user cancels their interaction.\n- `pdsMultiselectLoadOptions` - Emitted to request more options (pagination).\n- `pdsMultiselectSearch` - Emitted on search input (for consumer-managed async)."
       },
       "attributes": [
         {
@@ -8672,7 +8722,7 @@
       "name": "pds-progress",
       "description": {
         "kind": "markdown",
-        "value": "The Progress component shows the progress of a task or process. It's great for helping users understand what’s happening and how much longer they might have to wait.\n\n**Examples:**\n[Default](https://pine-design-system.netlify.app/?path=/docs/components-progress--docs#default), [Percent](https://pine-design-system.netlify.app/?path=/docs/components-progress--docs#percent), [Show Percent](https://pine-design-system.netlify.app/?path=/docs/components-progress--docs#show-percent), [Animated](https://pine-design-system.netlify.app/?path=/docs/components-progress--docs#animated), [Fill Color](https://pine-design-system.netlify.app/?path=/docs/components-progress--docs#fill-color), [Fill Color with Gradient](https://pine-design-system.netlify.app/?path=/docs/components-progress--docs#fill-color-with-gradient), [Tooltip](https://pine-design-system.netlify.app/?path=/docs/components-progress--docs#tooltip)"
+        "value": "Progress bars visualize how far a task has advanced toward completion. They help users gauge wait time during uploads, downloads, or other long-running operations.\n\n**Examples:**\n[Default](https://pine-design-system.netlify.app/?path=/docs/components-progress--docs#default), [Percent](https://pine-design-system.netlify.app/?path=/docs/components-progress--docs#percent), [Show Percent](https://pine-design-system.netlify.app/?path=/docs/components-progress--docs#show-percent), [Animated](https://pine-design-system.netlify.app/?path=/docs/components-progress--docs#animated), [Fill Color](https://pine-design-system.netlify.app/?path=/docs/components-progress--docs#fill-color), [Fill Color with Gradient](https://pine-design-system.netlify.app/?path=/docs/components-progress--docs#fill-color-with-gradient), [Tooltip](https://pine-design-system.netlify.app/?path=/docs/components-progress--docs#tooltip)"
       },
       "attributes": [
         {
@@ -8729,7 +8779,7 @@
       "name": "pds-property",
       "description": {
         "kind": "markdown",
-        "value": "The Property component displays an icon and text together in a horizontal layout. It's useful for showing key-value pairs, status indicators, or labeled information. The component always displays an icon - if no icon is specified, it defaults to a star icon.\n\n**Examples:**\n[Default](https://pine-design-system.netlify.app/?path=/docs/components-property--docs#default), [With Custom Icon](https://pine-design-system.netlify.app/?path=/docs/components-property--docs#with-custom-icon), [Various Icons](https://pine-design-system.netlify.app/?path=/docs/components-property--docs#various-icons)\n\n**Slots:**\n- `(default)` - The property text content."
+        "value": "Properties pair an icon with a short label to present key-value pairs, status indicators, or tagged information in a compact horizontal layout. An icon is always shown; unspecified icons default to a star.\n\n**Examples:**\n[Default](https://pine-design-system.netlify.app/?path=/docs/components-property--docs#default), [With Custom Icon](https://pine-design-system.netlify.app/?path=/docs/components-property--docs#with-custom-icon), [Various Icons](https://pine-design-system.netlify.app/?path=/docs/components-property--docs#various-icons)\n\n**Slots:**\n- `(default)` - The property text content."
       },
       "attributes": [
         {
@@ -8857,7 +8907,7 @@
       "name": "pds-radio-group",
       "description": {
         "kind": "markdown",
-        "value": "Radio Group components wrap multiple `pds-radio` components and display a single error message for the entire group, providing a cleaner interface for grouped radio selections.\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), [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": [
         {
@@ -8950,7 +9000,7 @@
       "name": "pds-row",
       "description": {
         "kind": "markdown",
-        "value": "`pds-row` is a flexbox-based grid system that allows you to create complex layouts with rows and columns. It is based on the 12 column grid system and is used to create horizontal rows that contain a set of columns."
+        "value": "Row is a flexbox-based grid container that arranges content into responsive columns. It uses a 12-column system for laying out horizontal rows."
       },
       "attributes": [
         {
@@ -9302,7 +9352,7 @@
       "name": "pds-select",
       "description": {
         "kind": "markdown",
-        "value": "The select component provides a dropdown list of options, allowing users to make a selection from a predefined set.\n\n**Examples:**\n[Default](https://pine-design-system.netlify.app/?path=/docs/components-select--docs#default), [Disabled](https://pine-design-system.netlify.app/?path=/docs/components-select--docs#disabled), [Highlight](https://pine-design-system.netlify.app/?path=/docs/components-select--docs#highlight), [With Message](https://pine-design-system.netlify.app/?path=/docs/components-select--docs#with-message), [Invalid](https://pine-design-system.netlify.app/?path=/docs/components-select--docs#invalid), [Autocomplete](https://pine-design-system.netlify.app/?path=/docs/components-select--docs#autocomplete), [Multiple](https://pine-design-system.netlify.app/?path=/docs/components-select--docs#multiple), [With Optgroup](https://pine-design-system.netlify.app/?path=/docs/components-select--docs#with-optgroup), [Action Slot](https://pine-design-system.netlify.app/?path=/docs/components-select--docs#action-slot)\n\n**Slots:**\n- `action` - Content to be displayed in the label area, typically for help icons or links\n\n**CSS Parts:**\n- `action` - No description\n- `select` - No description\n\n**Events:**\n- `pdsBlur` - Emitted when the select loses focus.\n- `pdsFocus` - Emitted when the select gains focus.\n- `pdsKeyDown` - Emitted when a key is pressed down in the select.\n- `pdsSelectChange` - Emitted when the select value changes."
+        "value": "Selects present a single-choice dropdown, letting users pick one value from a predefined set of options.\n\n**Examples:**\n[Default](https://pine-design-system.netlify.app/?path=/docs/components-select--docs#default), [Disabled](https://pine-design-system.netlify.app/?path=/docs/components-select--docs#disabled), [Highlight](https://pine-design-system.netlify.app/?path=/docs/components-select--docs#highlight), [With Message](https://pine-design-system.netlify.app/?path=/docs/components-select--docs#with-message), [Invalid](https://pine-design-system.netlify.app/?path=/docs/components-select--docs#invalid), [Autocomplete](https://pine-design-system.netlify.app/?path=/docs/components-select--docs#autocomplete), [Multiple](https://pine-design-system.netlify.app/?path=/docs/components-select--docs#multiple), [With Optgroup](https://pine-design-system.netlify.app/?path=/docs/components-select--docs#with-optgroup), [Action Slot](https://pine-design-system.netlify.app/?path=/docs/components-select--docs#action-slot)\n\n**Slots:**\n- `action` - Content to be displayed in the label area, typically for help icons or links\n\n**CSS Parts:**\n- `action` - No description\n- `select` - No description\n\n**Events:**\n- `pdsBlur` - Emitted when the select loses focus.\n- `pdsFocus` - Emitted when the select gains focus.\n- `pdsKeyDown` - Emitted when a key is pressed down in the select.\n- `pdsSelectChange` - Emitted when the select value changes."
       },
       "attributes": [
         {
@@ -9502,7 +9552,7 @@
       "name": "pds-switch",
       "description": {
         "kind": "markdown",
-        "value": "A styled checkbox component that functions as a toggle.\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), [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)\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), [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)\n\n**Events:**\n- `pdsSwitchChange` - Emits an event on input change."
       },
       "attributes": [
         {
@@ -9623,7 +9673,7 @@
       "name": "pds-table",
       "description": {
         "kind": "markdown",
-        "value": "The table (`pds-table`), consisting of rows and columns, is used to display and organize tabular data.\n\n**Examples:**\n[Default](https://pine-design-system.netlify.app/?path=/docs/components-table--docs#default), [Compact](https://pine-design-system.netlify.app/?path=/docs/components-table--docs#compact), [Head Background and Row Dividers](https://pine-design-system.netlify.app/?path=/docs/components-table--docs#head-background-and-row-dividers), [Selectable](https://pine-design-system.netlify.app/?path=/docs/components-table--docs#selectable), [Selectable without Select All](https://pine-design-system.netlify.app/?path=/docs/components-table--docs#selectable-without-select-all), [Responsive](https://pine-design-system.netlify.app/?path=/docs/components-table--docs#responsive), [Fixed Column](https://pine-design-system.netlify.app/?path=/docs/components-table--docs#fixed-column), [Fixed w/ Checkbox](https://pine-design-system.netlify.app/?path=/docs/components-table--docs#fixed-w/-checkbox), [Cell Truncation](https://pine-design-system.netlify.app/?path=/docs/components-table--docs#cell-truncation), [Cell Alignment](https://pine-design-system.netlify.app/?path=/docs/components-table--docs#cell-alignment), [Sorting](https://pine-design-system.netlify.app/?path=/docs/components-table--docs#sorting), [Event payload](https://pine-design-system.netlify.app/?path=/docs/components-table--docs#event-payload), [Preventing built-in sorting](https://pine-design-system.netlify.app/?path=/docs/components-table--docs#preventing-built-in-sorting), [Default Sort](https://pine-design-system.netlify.app/?path=/docs/components-table--docs#default-sort)\n\n**CSS Parts:**\n- `responsive-container` - No description\n- `responsive-table` - No description\n- `responsive-wrapper` - No description\n- `scroll-shadow-left` - No description\n- `scroll-shadow-right` - No description\n- `table` - No description\n- `table-inner` - No description\n\n**Events:**\n- `pdsTableSelectAll` - Event that is emitted when the select all checkbox is clicked, carrying the selected value."
+        "value": "Tables display tabular data using semantic subcomponents for head, head-cell, body, row, and cell roles. Use pds-table-head, pds-table-head-cell, pds-table-body, pds-table-row, and pds-table-cell to compose rows and columns accessibly.\n\n**Examples:**\n[Default](https://pine-design-system.netlify.app/?path=/docs/components-table--docs#default), [Compact](https://pine-design-system.netlify.app/?path=/docs/components-table--docs#compact), [Head Background and Row Dividers](https://pine-design-system.netlify.app/?path=/docs/components-table--docs#head-background-and-row-dividers), [Selectable](https://pine-design-system.netlify.app/?path=/docs/components-table--docs#selectable), [Selectable without Select All](https://pine-design-system.netlify.app/?path=/docs/components-table--docs#selectable-without-select-all), [Responsive](https://pine-design-system.netlify.app/?path=/docs/components-table--docs#responsive), [Fixed Column](https://pine-design-system.netlify.app/?path=/docs/components-table--docs#fixed-column), [Fixed w/ Checkbox](https://pine-design-system.netlify.app/?path=/docs/components-table--docs#fixed-w/-checkbox), [Cell Truncation](https://pine-design-system.netlify.app/?path=/docs/components-table--docs#cell-truncation), [Cell Alignment](https://pine-design-system.netlify.app/?path=/docs/components-table--docs#cell-alignment), [Sorting](https://pine-design-system.netlify.app/?path=/docs/components-table--docs#sorting), [Event payload](https://pine-design-system.netlify.app/?path=/docs/components-table--docs#event-payload), [Preventing built-in sorting](https://pine-design-system.netlify.app/?path=/docs/components-table--docs#preventing-built-in-sorting), [Default Sort](https://pine-design-system.netlify.app/?path=/docs/components-table--docs#default-sort)\n\n**CSS Parts:**\n- `responsive-container` - No description\n- `responsive-table` - No description\n- `responsive-wrapper` - No description\n- `scroll-shadow-left` - No description\n- `scroll-shadow-right` - No description\n- `table` - No description\n- `table-inner` - No description\n\n**Events:**\n- `pdsTableSelectAll` - Event that is emitted when the select all checkbox is clicked, carrying the selected value."
       },
       "attributes": [
         {
@@ -9903,7 +9953,7 @@
       "name": "pds-tabs",
       "description": {
         "kind": "markdown",
-        "value": "The Tabs component is used to separate and display different panels of related content activated by tab buttons.\n\n**Examples:**\n[Variant](https://pine-design-system.netlify.app/?path=/docs/components-tabs--docs#variant), [Primary](https://pine-design-system.netlify.app/?path=/docs/components-tabs--docs#primary), [Pill](https://pine-design-system.netlify.app/?path=/docs/components-tabs--docs#pill), [Availability](https://pine-design-system.netlify.app/?path=/docs/components-tabs--docs#availability), [Filter](https://pine-design-system.netlify.app/?path=/docs/components-tabs--docs#filter), [Disabled](https://pine-design-system.netlify.app/?path=/docs/components-tabs--docs#disabled)\n\n**Slots:**\n- `tabpanels` - Content is placed directly after the `div[role=\"tablist\"]` element as siblings\n- `tabs` - Content is placed within the `div[role=\"tablist\"]` element as children\n\n**CSS Parts:**\n- `tab-list` - Exposes the container element that holds all the tab buttons for styling."
+        "value": "Tabs organize related content into separate panels that users switch between using a horizontal button bar, keeping only one panel visible at a time.\n\n**Examples:**\n[Variant](https://pine-design-system.netlify.app/?path=/docs/components-tabs--docs#variant), [Primary](https://pine-design-system.netlify.app/?path=/docs/components-tabs--docs#primary), [Pill](https://pine-design-system.netlify.app/?path=/docs/components-tabs--docs#pill), [Availability](https://pine-design-system.netlify.app/?path=/docs/components-tabs--docs#availability), [Filter](https://pine-design-system.netlify.app/?path=/docs/components-tabs--docs#filter), [Disabled](https://pine-design-system.netlify.app/?path=/docs/components-tabs--docs#disabled)\n\n**Slots:**\n- `tabpanels` - Content is placed directly after the `div[role=\"tablist\"]` element as siblings\n- `tabs` - Content is placed within the `div[role=\"tablist\"]` element as children\n\n**CSS Parts:**\n- `tab-list` - Exposes the container element that holds all the tab buttons for styling."
       },
       "attributes": [
         {
@@ -9960,7 +10010,7 @@
       "name": "pds-text",
       "description": {
         "kind": "markdown",
-        "value": "The Text component allows for a choice of common semantic tags used for headings or body text. This tag can be nested to allow use of `em` and `strong`.\n\n**Examples:**\n[Default](https://pine-design-system.netlify.app/?path=/docs/components-text--docs#default), [Alignment](https://pine-design-system.netlify.app/?path=/docs/components-text--docs#alignment), [Color](https://pine-design-system.netlify.app/?path=/docs/components-text--docs#color), [Decoration](https://pine-design-system.netlify.app/?path=/docs/components-text--docs#decoration), [Font Size](https://pine-design-system.netlify.app/?path=/docs/components-text--docs#font-size), [Font Weight](https://pine-design-system.netlify.app/?path=/docs/components-text--docs#font-weight), [Gutters](https://pine-design-system.netlify.app/?path=/docs/components-text--docs#gutters), [Italics](https://pine-design-system.netlify.app/?path=/docs/components-text--docs#italics), [Truncation](https://pine-design-system.netlify.app/?path=/docs/components-text--docs#truncation)\n\n**CSS Parts:**\n- `content` - The text content container"
+        "value": "Text renders content using configurable semantic HTML tags for headings or body copy, applying Pine's typography tokens consistently across the interface.\n\n**Examples:**\n[Default](https://pine-design-system.netlify.app/?path=/docs/components-text--docs#default), [Alignment](https://pine-design-system.netlify.app/?path=/docs/components-text--docs#alignment), [Color](https://pine-design-system.netlify.app/?path=/docs/components-text--docs#color), [Decoration](https://pine-design-system.netlify.app/?path=/docs/components-text--docs#decoration), [Font Size](https://pine-design-system.netlify.app/?path=/docs/components-text--docs#font-size), [Font Weight](https://pine-design-system.netlify.app/?path=/docs/components-text--docs#font-weight), [Gutters](https://pine-design-system.netlify.app/?path=/docs/components-text--docs#gutters), [Italics](https://pine-design-system.netlify.app/?path=/docs/components-text--docs#italics), [Truncation](https://pine-design-system.netlify.app/?path=/docs/components-text--docs#truncation)\n\n**CSS Parts:**\n- `content` - The text content container"
       },
       "attributes": [
         {
@@ -10182,7 +10232,7 @@
       "name": "pds-textarea",
       "description": {
         "kind": "markdown",
-        "value": "A textarea field coupled with a label and supplemental helper text that aids in user input and feedback.\n\n**Examples:**\n[Default](https://pine-design-system.netlify.app/?path=/docs/components-textarea--docs#default), [Disabled](https://pine-design-system.netlify.app/?path=/docs/components-textarea--docs#disabled), [Error Message](https://pine-design-system.netlify.app/?path=/docs/components-textarea--docs#error-message), [Helper Message](https://pine-design-system.netlify.app/?path=/docs/components-textarea--docs#helper-message), [Placeholder](https://pine-design-system.netlify.app/?path=/docs/components-textarea--docs#placeholder), [Readonly](https://pine-design-system.netlify.app/?path=/docs/components-textarea--docs#readonly), [Highlight](https://pine-design-system.netlify.app/?path=/docs/components-textarea--docs#highlight), [Required](https://pine-design-system.netlify.app/?path=/docs/components-textarea--docs#required), [Rows](https://pine-design-system.netlify.app/?path=/docs/components-textarea--docs#rows), [Max Length](https://pine-design-system.netlify.app/?path=/docs/components-textarea--docs#max-length), [Action Slot](https://pine-design-system.netlify.app/?path=/docs/components-textarea--docs#action-slot)\n\n**Slots:**\n- `action` - Content to be displayed in the label area, typically for help icons or links\n\n**CSS Parts:**\n- `action` - No description\n\n**Events:**\n- `pdsBlur` - Emitted when the input loses focus.\n- `pdsFocus` - Emitted when the input has focus.\n- `pdsInput` - Emitted when a keyboard input occurs.\n\nFor elements that accept text input (`type=text`, `type=tel`, etc.), the interface\nis [`InputEvent`](https://developer.mozilla.org/en-US/docs/Web/API/InputEvent); for others,\nthe interface is [`Event`](https://developer.mozilla.org/en-US/docs/Web/API/Event). If\nthe input is cleared on edit, the type is `null`.\n- `pdsKeyDown` - Emitted when a key is pressed down in the textarea.\n- `pdsTextareaChange` - Event emitted whenever the value of the textarea changes.\n\nThis event will not emit when programmatically setting the `value` property."
+        "value": "Textarea captures multi-line text from the user, paired with a label and optional helper or error message. Use it for freeform content like comments, descriptions, or messages.\n\n**Examples:**\n[Default](https://pine-design-system.netlify.app/?path=/docs/components-textarea--docs#default), [Disabled](https://pine-design-system.netlify.app/?path=/docs/components-textarea--docs#disabled), [Error Message](https://pine-design-system.netlify.app/?path=/docs/components-textarea--docs#error-message), [Helper Message](https://pine-design-system.netlify.app/?path=/docs/components-textarea--docs#helper-message), [Placeholder](https://pine-design-system.netlify.app/?path=/docs/components-textarea--docs#placeholder), [Readonly](https://pine-design-system.netlify.app/?path=/docs/components-textarea--docs#readonly), [Highlight](https://pine-design-system.netlify.app/?path=/docs/components-textarea--docs#highlight), [Required](https://pine-design-system.netlify.app/?path=/docs/components-textarea--docs#required), [Rows](https://pine-design-system.netlify.app/?path=/docs/components-textarea--docs#rows), [Max Length](https://pine-design-system.netlify.app/?path=/docs/components-textarea--docs#max-length), [Action Slot](https://pine-design-system.netlify.app/?path=/docs/components-textarea--docs#action-slot)\n\n**Slots:**\n- `action` - Content to be displayed in the label area, typically for help icons or links\n\n**CSS Parts:**\n- `action` - No description\n\n**Events:**\n- `pdsBlur` - Emitted when the input loses focus.\n- `pdsFocus` - Emitted when the input has focus.\n- `pdsInput` - Emitted when a keyboard input occurs.\n\nFor elements that accept text input (`type=text`, `type=tel`, etc.), the interface\nis [`InputEvent`](https://developer.mozilla.org/en-US/docs/Web/API/InputEvent); for others,\nthe interface is [`Event`](https://developer.mozilla.org/en-US/docs/Web/API/Event). If\nthe input is cleared on edit, the type is `null`.\n- `pdsKeyDown` - Emitted when a key is pressed down in the textarea.\n- `pdsTextareaChange` - Event emitted whenever the value of the textarea changes.\n\nThis event will not emit when programmatically setting the `value` property."
       },
       "attributes": [
         {
@@ -10316,7 +10366,7 @@
       "name": "pds-toast",
       "description": {
         "kind": "markdown",
-        "value": "A toast notification component that displays temporary messages to users.\n\n**Examples:**\n[Default](https://pine-design-system.netlify.app/?path=/docs/components-toast--docs#default), [Danger](https://pine-design-system.netlify.app/?path=/docs/components-toast--docs#danger), [Loading](https://pine-design-system.netlify.app/?path=/docs/components-toast--docs#loading), [With Icon](https://pine-design-system.netlify.app/?path=/docs/components-toast--docs#with-icon), [With Link](https://pine-design-system.netlify.app/?path=/docs/components-toast--docs#with-link), [Complex Content](https://pine-design-system.netlify.app/?path=/docs/components-toast--docs#complex-content), [Non-dismissing Toast](https://pine-design-system.netlify.app/?path=/docs/components-toast--docs#non-dismissing-toast)\n\n**CSS Parts:**\n- `dismiss` - No description\n\n**Events:**\n- `pdsToastDismissed` - Event emitted when the toast is dismissed, either manually or automatically."
+        "value": "Toasts briefly surface feedback messages as non-blocking notifications that auto-dismiss after a short delay. They're used to confirm actions or report status without interrupting the user's flow.\n\n**Examples:**\n[Default](https://pine-design-system.netlify.app/?path=/docs/components-toast--docs#default), [Danger](https://pine-design-system.netlify.app/?path=/docs/components-toast--docs#danger), [Loading](https://pine-design-system.netlify.app/?path=/docs/components-toast--docs#loading), [With Icon](https://pine-design-system.netlify.app/?path=/docs/components-toast--docs#with-icon), [With Link](https://pine-design-system.netlify.app/?path=/docs/components-toast--docs#with-link), [Complex Content](https://pine-design-system.netlify.app/?path=/docs/components-toast--docs#complex-content), [Non-dismissing Toast](https://pine-design-system.netlify.app/?path=/docs/components-toast--docs#non-dismissing-toast)\n\n**CSS Parts:**\n- `dismiss` - No description\n\n**Events:**\n- `pdsToastDismissed` - Event emitted when the toast is dismissed, either manually or automatically."
       },
       "attributes": [
         {