@pine-ds/core 4.11.0 → 4.12.0

package/dist/vscode.html-data.json

@@ -34,7 +34,7 @@
       "name": "pds-alert",
       "description": {
         "kind": "markdown",
-        "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."
+        "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- `(default)` - The alert's description text.\n- `actions` - Slot for alert actions.\n\n**CSS Parts:**\n- `dismiss` - Exposes the dismiss button for styling. Appears only when `dismissible` is set.\n\n**Events:**\n- `pdsAlertDismissClick` - Event emitted when the dismiss button is clicked."
       },
       "attributes": [
         {
@@ -122,7 +122,7 @@
       "name": "pds-avatar",
       "description": {
         "kind": "markdown",
-        "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.\n- `initials` - The text element that renders the avatar's initials, for restyling their color.\n- `status` - No description"
+        "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), [Status](https://pine-design-system.netlify.app/?path=/docs/components-avatar--docs#status), [Sizes](https://pine-design-system.netlify.app/?path=/docs/components-avatar--docs#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` - Exposes the sized wrapper around the avatar's image, initials or icon, badge and status dot for styling.\n- `button` - Exposes the dropdown trigger button for styling. Appears only when `dropdown` is set.\n- `initials` - The text element that renders the avatar's initials, for restyling their color.\n- `status` - Exposes the status dot for styling, such as a custom color. Appears only when `status` is set."
       },
       "attributes": [
         {
@@ -178,7 +178,7 @@
           "name": "size",
           "description": {
             "kind": "markdown",
-            "value": "Size of the avatar. Value can be preset or custom.\n\n**Default:** `'lg'`"
+            "value": "Sets the size of the avatar: `xs` (24px), `sm` (32px), `md` (40px), `lg` (56px), `xl` (64px),\nor a custom CSS length such as `128px`.\n\n**Default:** `'lg'`"
           }
         },
         {
@@ -656,6 +656,21 @@
             }
           ]
         },
+        {
+          "name": "container",
+          "description": {
+            "kind": "markdown",
+            "value": "Makes the box a size container by setting `container-type`. `inline-size` stops the box's\ncontent from setting its width, so long unwrapped text truncates instead of widening it, and\nlets children use container query units. `size` does the same for both axes, so the box needs\na height from somewhere else. Either way the box still needs its width from its parent, such as\nthe default `flex-grow`, `flex=\"grow\"` or `fit`; with `flex=\"none\"` or `flex=\"shrink\"`, or the\n`auto` prop, it collapses.\n\n**Type:** `\"inline-size\" | \"size\"`"
+          },
+          "values": [
+            {
+              "name": "inline-size"
+            },
+            {
+              "name": "size"
+            }
+          ]
+        },
         {
           "name": "direction",
           "description": {
@@ -696,49 +711,49 @@
           "name": "fit",
           "description": {
             "kind": "markdown",
-            "value": "If `true`, sets the box `max-width` to `100%`."
+            "value": "If `true`, sets the box `width`, `min-width` and `max-width` to `100%`, so it fills its parent's width.\nA box in a `direction=\"column\"` parent needs it when the parent sets `align-items`, and a box that isn't a flex item needs it to fill its container."
           }
         },
         {
           "name": "fit-lg",
           "description": {
             "kind": "markdown",
-            "value": "If `true`, sets the box `max-width` to `100%` at the LG breakpoint."
+            "value": "If `true`, sets the box `width`, `min-width` and `max-width` to `100%` at the LG breakpoint."
           }
         },
         {
           "name": "fit-md",
           "description": {
             "kind": "markdown",
-            "value": "If `true`, sets the box `max-width` to `100%` at the MD breakpoint."
+            "value": "If `true`, sets the box `width`, `min-width` and `max-width` to `100%` at the MD breakpoint."
           }
         },
         {
           "name": "fit-sm",
           "description": {
             "kind": "markdown",
-            "value": "If `true`, sets the box `max-width` to `100%` at the SM breakpoint."
+            "value": "If `true`, sets the box `width`, `min-width` and `max-width` to `100%` at the SM breakpoint."
           }
         },
         {
           "name": "fit-xl",
           "description": {
             "kind": "markdown",
-            "value": "If `true`, sets the box `max-width` to `100%` at the XL breakpoint."
+            "value": "If `true`, sets the box `width`, `min-width` and `max-width` to `100%` at the XL breakpoint."
           }
         },
         {
           "name": "fit-xs",
           "description": {
             "kind": "markdown",
-            "value": "If `true`, sets the box `max-width` to `100%` at the XS breakpoint."
+            "value": "If `true`, sets the box `width`, `min-width` and `max-width` to `100%` at the XS breakpoint."
           }
         },
         {
           "name": "flex",
           "description": {
             "kind": "markdown",
-            "value": "Defines how a box will grow or shrink to fit the space available in its container.\nCan be a predefined value ('none', 'grow', 'shrink') or a custom flex value (e.g., '1', '0 1 auto')."
+            "value": "Defines how a box will grow or shrink to fit the space available in its container.\nCan be a predefined value or a custom flex value (e.g., '1', '0 1 auto'). The predefined values are\n`none` (`flex: 0 0 auto`), `grow` (`flex: 1 1 auto`) and `shrink` (`flex: 0 1 auto`).\nWithout it, a box grows to share its row with its siblings (`flex-grow: 1; flex-basis: 0`)."
           }
         },
         {
@@ -1429,7 +1444,7 @@
           "name": "margin-block-end",
           "description": {
             "kind": "markdown",
-            "value": "Defines the box's outer bottom spacing.\n\n**Type:** `\"025\" | \"050\" | \"100\" | \"125\" | \"150\" | \"200\" | \"250\" | \"300\" | \"350\" | \"400\" | \"450\" | \"500\" | \"550\" | \"600\" | \"650\" | \"700\" | \"750\" | \"800\" | \"lg\" | \"md\" | \"none\" | \"sm\" | \"xl\" | \"xs\" | \"xxl\" | \"xxs\"`"
+            "value": "Defines the box's outer bottom spacing. Accepts a spacing token or `auto`.\n\n**Type:** `\"025\" | \"050\" | \"100\" | \"125\" | \"150\" | \"200\" | \"250\" | \"300\" | \"350\" | \"400\" | \"450\" | \"500\" | \"550\" | \"600\" | \"650\" | \"700\" | \"750\" | \"800\" | \"auto\" | \"lg\" | \"md\" | \"none\" | \"sm\" | \"xl\" | \"xs\" | \"xxl\" | \"xxs\"`"
           },
           "values": [
             {
@@ -1486,6 +1501,9 @@
             {
               "name": "800"
             },
+            {
+              "name": "auto"
+            },
             {
               "name": "lg"
             },
@@ -1516,7 +1534,7 @@
           "name": "margin-block-end-lg",
           "description": {
             "kind": "markdown",
-            "value": "Defines the box's outer bottom spacing at the LG breakpoint.\n\n**Type:** `\"025\" | \"050\" | \"100\" | \"125\" | \"150\" | \"200\" | \"250\" | \"300\" | \"350\" | \"400\" | \"450\" | \"500\" | \"550\" | \"600\" | \"650\" | \"700\" | \"750\" | \"800\" | \"lg\" | \"md\" | \"none\" | \"sm\" | \"xl\" | \"xs\" | \"xxl\" | \"xxs\"`"
+            "value": "Defines the box's outer bottom spacing at the LG breakpoint. Accepts a spacing token or `auto`.\n\n**Type:** `\"025\" | \"050\" | \"100\" | \"125\" | \"150\" | \"200\" | \"250\" | \"300\" | \"350\" | \"400\" | \"450\" | \"500\" | \"550\" | \"600\" | \"650\" | \"700\" | \"750\" | \"800\" | \"auto\" | \"lg\" | \"md\" | \"none\" | \"sm\" | \"xl\" | \"xs\" | \"xxl\" | \"xxs\"`"
           },
           "values": [
             {
@@ -1573,6 +1591,9 @@
             {
               "name": "800"
             },
+            {
+              "name": "auto"
+            },
             {
               "name": "lg"
             },
@@ -1603,7 +1624,7 @@
           "name": "margin-block-end-md",
           "description": {
             "kind": "markdown",
-            "value": "Defines the box's outer bottom spacing at the MD breakpoint.\n\n**Type:** `\"025\" | \"050\" | \"100\" | \"125\" | \"150\" | \"200\" | \"250\" | \"300\" | \"350\" | \"400\" | \"450\" | \"500\" | \"550\" | \"600\" | \"650\" | \"700\" | \"750\" | \"800\" | \"lg\" | \"md\" | \"none\" | \"sm\" | \"xl\" | \"xs\" | \"xxl\" | \"xxs\"`"
+            "value": "Defines the box's outer bottom spacing at the MD breakpoint. Accepts a spacing token or `auto`.\n\n**Type:** `\"025\" | \"050\" | \"100\" | \"125\" | \"150\" | \"200\" | \"250\" | \"300\" | \"350\" | \"400\" | \"450\" | \"500\" | \"550\" | \"600\" | \"650\" | \"700\" | \"750\" | \"800\" | \"auto\" | \"lg\" | \"md\" | \"none\" | \"sm\" | \"xl\" | \"xs\" | \"xxl\" | \"xxs\"`"
           },
           "values": [
             {
@@ -1660,6 +1681,9 @@
             {
               "name": "800"
             },
+            {
+              "name": "auto"
+            },
             {
               "name": "lg"
             },
@@ -1690,7 +1714,7 @@
           "name": "margin-block-end-sm",
           "description": {
             "kind": "markdown",
-            "value": "Defines the box's outer bottom spacing at the SM breakpoint.\n\n**Type:** `\"025\" | \"050\" | \"100\" | \"125\" | \"150\" | \"200\" | \"250\" | \"300\" | \"350\" | \"400\" | \"450\" | \"500\" | \"550\" | \"600\" | \"650\" | \"700\" | \"750\" | \"800\" | \"lg\" | \"md\" | \"none\" | \"sm\" | \"xl\" | \"xs\" | \"xxl\" | \"xxs\"`"
+            "value": "Defines the box's outer bottom spacing at the SM breakpoint. Accepts a spacing token or `auto`.\n\n**Type:** `\"025\" | \"050\" | \"100\" | \"125\" | \"150\" | \"200\" | \"250\" | \"300\" | \"350\" | \"400\" | \"450\" | \"500\" | \"550\" | \"600\" | \"650\" | \"700\" | \"750\" | \"800\" | \"auto\" | \"lg\" | \"md\" | \"none\" | \"sm\" | \"xl\" | \"xs\" | \"xxl\" | \"xxs\"`"
           },
           "values": [
             {
@@ -1747,6 +1771,9 @@
             {
               "name": "800"
             },
+            {
+              "name": "auto"
+            },
             {
               "name": "lg"
             },
@@ -1777,7 +1804,7 @@
           "name": "margin-block-end-xl",
           "description": {
             "kind": "markdown",
-            "value": "Defines the box's outer bottom spacing at the XL breakpoint.\n\n**Type:** `\"025\" | \"050\" | \"100\" | \"125\" | \"150\" | \"200\" | \"250\" | \"300\" | \"350\" | \"400\" | \"450\" | \"500\" | \"550\" | \"600\" | \"650\" | \"700\" | \"750\" | \"800\" | \"lg\" | \"md\" | \"none\" | \"sm\" | \"xl\" | \"xs\" | \"xxl\" | \"xxs\"`"
+            "value": "Defines the box's outer bottom spacing at the XL breakpoint. Accepts a spacing token or `auto`.\n\n**Type:** `\"025\" | \"050\" | \"100\" | \"125\" | \"150\" | \"200\" | \"250\" | \"300\" | \"350\" | \"400\" | \"450\" | \"500\" | \"550\" | \"600\" | \"650\" | \"700\" | \"750\" | \"800\" | \"auto\" | \"lg\" | \"md\" | \"none\" | \"sm\" | \"xl\" | \"xs\" | \"xxl\" | \"xxs\"`"
           },
           "values": [
             {
@@ -1834,6 +1861,9 @@
             {
               "name": "800"
             },
+            {
+              "name": "auto"
+            },
             {
               "name": "lg"
             },
@@ -1864,7 +1894,7 @@
           "name": "margin-block-end-xs",
           "description": {
             "kind": "markdown",
-            "value": "Defines the box's outer bottom spacing at the XS breakpoint.\n\n**Type:** `\"025\" | \"050\" | \"100\" | \"125\" | \"150\" | \"200\" | \"250\" | \"300\" | \"350\" | \"400\" | \"450\" | \"500\" | \"550\" | \"600\" | \"650\" | \"700\" | \"750\" | \"800\" | \"lg\" | \"md\" | \"none\" | \"sm\" | \"xl\" | \"xs\" | \"xxl\" | \"xxs\"`"
+            "value": "Defines the box's outer bottom spacing at the XS breakpoint. Accepts a spacing token or `auto`.\n\n**Type:** `\"025\" | \"050\" | \"100\" | \"125\" | \"150\" | \"200\" | \"250\" | \"300\" | \"350\" | \"400\" | \"450\" | \"500\" | \"550\" | \"600\" | \"650\" | \"700\" | \"750\" | \"800\" | \"auto\" | \"lg\" | \"md\" | \"none\" | \"sm\" | \"xl\" | \"xs\" | \"xxl\" | \"xxs\"`"
           },
           "values": [
             {
@@ -1921,6 +1951,9 @@
             {
               "name": "800"
             },
+            {
+              "name": "auto"
+            },
             {
               "name": "lg"
             },
@@ -1951,7 +1984,7 @@
           "name": "margin-block-start",
           "description": {
             "kind": "markdown",
-            "value": "Defines the box's outer top spacing.\n\n**Type:** `\"025\" | \"050\" | \"100\" | \"125\" | \"150\" | \"200\" | \"250\" | \"300\" | \"350\" | \"400\" | \"450\" | \"500\" | \"550\" | \"600\" | \"650\" | \"700\" | \"750\" | \"800\" | \"lg\" | \"md\" | \"none\" | \"sm\" | \"xl\" | \"xs\" | \"xxl\" | \"xxs\"`"
+            "value": "Defines the box's outer top spacing. Accepts a spacing token or `auto`.\n\n**Type:** `\"025\" | \"050\" | \"100\" | \"125\" | \"150\" | \"200\" | \"250\" | \"300\" | \"350\" | \"400\" | \"450\" | \"500\" | \"550\" | \"600\" | \"650\" | \"700\" | \"750\" | \"800\" | \"auto\" | \"lg\" | \"md\" | \"none\" | \"sm\" | \"xl\" | \"xs\" | \"xxl\" | \"xxs\"`"
           },
           "values": [
             {
@@ -2008,6 +2041,9 @@
             {
               "name": "800"
             },
+            {
+              "name": "auto"
+            },
             {
               "name": "lg"
             },
@@ -2038,7 +2074,7 @@
           "name": "margin-block-start-lg",
           "description": {
             "kind": "markdown",
-            "value": "Defines the box's outer top spacing at the LG breakpoint.\n\n**Type:** `\"025\" | \"050\" | \"100\" | \"125\" | \"150\" | \"200\" | \"250\" | \"300\" | \"350\" | \"400\" | \"450\" | \"500\" | \"550\" | \"600\" | \"650\" | \"700\" | \"750\" | \"800\" | \"lg\" | \"md\" | \"none\" | \"sm\" | \"xl\" | \"xs\" | \"xxl\" | \"xxs\"`"
+            "value": "Defines the box's outer top spacing at the LG breakpoint. Accepts a spacing token or `auto`.\n\n**Type:** `\"025\" | \"050\" | \"100\" | \"125\" | \"150\" | \"200\" | \"250\" | \"300\" | \"350\" | \"400\" | \"450\" | \"500\" | \"550\" | \"600\" | \"650\" | \"700\" | \"750\" | \"800\" | \"auto\" | \"lg\" | \"md\" | \"none\" | \"sm\" | \"xl\" | \"xs\" | \"xxl\" | \"xxs\"`"
           },
           "values": [
             {
@@ -2095,6 +2131,9 @@
             {
               "name": "800"
             },
+            {
+              "name": "auto"
+            },
             {
               "name": "lg"
             },
@@ -2125,7 +2164,7 @@
           "name": "margin-block-start-md",
           "description": {
             "kind": "markdown",
-            "value": "Defines the box's outer top spacing at the MD breakpoint.\n\n**Type:** `\"025\" | \"050\" | \"100\" | \"125\" | \"150\" | \"200\" | \"250\" | \"300\" | \"350\" | \"400\" | \"450\" | \"500\" | \"550\" | \"600\" | \"650\" | \"700\" | \"750\" | \"800\" | \"lg\" | \"md\" | \"none\" | \"sm\" | \"xl\" | \"xs\" | \"xxl\" | \"xxs\"`"
+            "value": "Defines the box's outer top spacing at the MD breakpoint. Accepts a spacing token or `auto`.\n\n**Type:** `\"025\" | \"050\" | \"100\" | \"125\" | \"150\" | \"200\" | \"250\" | \"300\" | \"350\" | \"400\" | \"450\" | \"500\" | \"550\" | \"600\" | \"650\" | \"700\" | \"750\" | \"800\" | \"auto\" | \"lg\" | \"md\" | \"none\" | \"sm\" | \"xl\" | \"xs\" | \"xxl\" | \"xxs\"`"
           },
           "values": [
             {
@@ -2182,6 +2221,9 @@
             {
               "name": "800"
             },
+            {
+              "name": "auto"
+            },
             {
               "name": "lg"
             },
@@ -2212,7 +2254,7 @@
           "name": "margin-block-start-sm",
           "description": {
             "kind": "markdown",
-            "value": "Defines the box's outer top spacing at the SM breakpoint.\n\n**Type:** `\"025\" | \"050\" | \"100\" | \"125\" | \"150\" | \"200\" | \"250\" | \"300\" | \"350\" | \"400\" | \"450\" | \"500\" | \"550\" | \"600\" | \"650\" | \"700\" | \"750\" | \"800\" | \"lg\" | \"md\" | \"none\" | \"sm\" | \"xl\" | \"xs\" | \"xxl\" | \"xxs\"`"
+            "value": "Defines the box's outer top spacing at the SM breakpoint. Accepts a spacing token or `auto`.\n\n**Type:** `\"025\" | \"050\" | \"100\" | \"125\" | \"150\" | \"200\" | \"250\" | \"300\" | \"350\" | \"400\" | \"450\" | \"500\" | \"550\" | \"600\" | \"650\" | \"700\" | \"750\" | \"800\" | \"auto\" | \"lg\" | \"md\" | \"none\" | \"sm\" | \"xl\" | \"xs\" | \"xxl\" | \"xxs\"`"
           },
           "values": [
             {
@@ -2269,6 +2311,9 @@
             {
               "name": "800"
             },
+            {
+              "name": "auto"
+            },
             {
               "name": "lg"
             },
@@ -2299,7 +2344,7 @@
           "name": "margin-block-start-xl",
           "description": {
             "kind": "markdown",
-            "value": "Defines the box's outer top spacing at the XL breakpoint.\n\n**Type:** `\"025\" | \"050\" | \"100\" | \"125\" | \"150\" | \"200\" | \"250\" | \"300\" | \"350\" | \"400\" | \"450\" | \"500\" | \"550\" | \"600\" | \"650\" | \"700\" | \"750\" | \"800\" | \"lg\" | \"md\" | \"none\" | \"sm\" | \"xl\" | \"xs\" | \"xxl\" | \"xxs\"`"
+            "value": "Defines the box's outer top spacing at the XL breakpoint. Accepts a spacing token or `auto`.\n\n**Type:** `\"025\" | \"050\" | \"100\" | \"125\" | \"150\" | \"200\" | \"250\" | \"300\" | \"350\" | \"400\" | \"450\" | \"500\" | \"550\" | \"600\" | \"650\" | \"700\" | \"750\" | \"800\" | \"auto\" | \"lg\" | \"md\" | \"none\" | \"sm\" | \"xl\" | \"xs\" | \"xxl\" | \"xxs\"`"
           },
           "values": [
             {
@@ -2356,6 +2401,9 @@
             {
               "name": "800"
             },
+            {
+              "name": "auto"
+            },
             {
               "name": "lg"
             },
@@ -2386,7 +2434,7 @@
           "name": "margin-block-start-xs",
           "description": {
             "kind": "markdown",
-            "value": "Defines the box's outer top spacing at the XS breakpoint.\n\n**Type:** `\"025\" | \"050\" | \"100\" | \"125\" | \"150\" | \"200\" | \"250\" | \"300\" | \"350\" | \"400\" | \"450\" | \"500\" | \"550\" | \"600\" | \"650\" | \"700\" | \"750\" | \"800\" | \"lg\" | \"md\" | \"none\" | \"sm\" | \"xl\" | \"xs\" | \"xxl\" | \"xxs\"`"
+            "value": "Defines the box's outer top spacing at the XS breakpoint. Accepts a spacing token or `auto`.\n\n**Type:** `\"025\" | \"050\" | \"100\" | \"125\" | \"150\" | \"200\" | \"250\" | \"300\" | \"350\" | \"400\" | \"450\" | \"500\" | \"550\" | \"600\" | \"650\" | \"700\" | \"750\" | \"800\" | \"auto\" | \"lg\" | \"md\" | \"none\" | \"sm\" | \"xl\" | \"xs\" | \"xxl\" | \"xxs\"`"
           },
           "values": [
             {
@@ -2443,6 +2491,9 @@
             {
               "name": "800"
             },
+            {
+              "name": "auto"
+            },
             {
               "name": "lg"
             },
@@ -2473,7 +2524,7 @@
           "name": "margin-inline-end",
           "description": {
             "kind": "markdown",
-            "value": "Defines the box's outer right spacing.\n\n**Type:** `\"025\" | \"050\" | \"100\" | \"125\" | \"150\" | \"200\" | \"250\" | \"300\" | \"350\" | \"400\" | \"450\" | \"500\" | \"550\" | \"600\" | \"650\" | \"700\" | \"750\" | \"800\" | \"lg\" | \"md\" | \"none\" | \"sm\" | \"xl\" | \"xs\" | \"xxl\" | \"xxs\"`"
+            "value": "Defines the box's outer right spacing. Accepts a spacing token or `auto`.\n\n**Type:** `\"025\" | \"050\" | \"100\" | \"125\" | \"150\" | \"200\" | \"250\" | \"300\" | \"350\" | \"400\" | \"450\" | \"500\" | \"550\" | \"600\" | \"650\" | \"700\" | \"750\" | \"800\" | \"auto\" | \"lg\" | \"md\" | \"none\" | \"sm\" | \"xl\" | \"xs\" | \"xxl\" | \"xxs\"`"
           },
           "values": [
             {
@@ -2530,6 +2581,9 @@
             {
               "name": "800"
             },
+            {
+              "name": "auto"
+            },
             {
               "name": "lg"
             },
@@ -2560,7 +2614,7 @@
           "name": "margin-inline-end-lg",
           "description": {
             "kind": "markdown",
-            "value": "Defines the box's outer right spacing at the LG breakpoint.\n\n**Type:** `\"025\" | \"050\" | \"100\" | \"125\" | \"150\" | \"200\" | \"250\" | \"300\" | \"350\" | \"400\" | \"450\" | \"500\" | \"550\" | \"600\" | \"650\" | \"700\" | \"750\" | \"800\" | \"lg\" | \"md\" | \"none\" | \"sm\" | \"xl\" | \"xs\" | \"xxl\" | \"xxs\"`"
+            "value": "Defines the box's outer right spacing at the LG breakpoint. Accepts a spacing token or `auto`.\n\n**Type:** `\"025\" | \"050\" | \"100\" | \"125\" | \"150\" | \"200\" | \"250\" | \"300\" | \"350\" | \"400\" | \"450\" | \"500\" | \"550\" | \"600\" | \"650\" | \"700\" | \"750\" | \"800\" | \"auto\" | \"lg\" | \"md\" | \"none\" | \"sm\" | \"xl\" | \"xs\" | \"xxl\" | \"xxs\"`"
           },
           "values": [
             {
@@ -2617,6 +2671,9 @@
             {
               "name": "800"
             },
+            {
+              "name": "auto"
+            },
             {
               "name": "lg"
             },
@@ -2647,7 +2704,7 @@
           "name": "margin-inline-end-md",
           "description": {
             "kind": "markdown",
-            "value": "Defines the box's outer right spacing at the MD breakpoint.\n\n**Type:** `\"025\" | \"050\" | \"100\" | \"125\" | \"150\" | \"200\" | \"250\" | \"300\" | \"350\" | \"400\" | \"450\" | \"500\" | \"550\" | \"600\" | \"650\" | \"700\" | \"750\" | \"800\" | \"lg\" | \"md\" | \"none\" | \"sm\" | \"xl\" | \"xs\" | \"xxl\" | \"xxs\"`"
+            "value": "Defines the box's outer right spacing at the MD breakpoint. Accepts a spacing token or `auto`.\n\n**Type:** `\"025\" | \"050\" | \"100\" | \"125\" | \"150\" | \"200\" | \"250\" | \"300\" | \"350\" | \"400\" | \"450\" | \"500\" | \"550\" | \"600\" | \"650\" | \"700\" | \"750\" | \"800\" | \"auto\" | \"lg\" | \"md\" | \"none\" | \"sm\" | \"xl\" | \"xs\" | \"xxl\" | \"xxs\"`"
           },
           "values": [
             {
@@ -2704,6 +2761,9 @@
             {
               "name": "800"
             },
+            {
+              "name": "auto"
+            },
             {
               "name": "lg"
             },
@@ -2734,7 +2794,7 @@
           "name": "margin-inline-end-sm",
           "description": {
             "kind": "markdown",
-            "value": "Defines the box's outer right spacing at the SM breakpoint.\n\n**Type:** `\"025\" | \"050\" | \"100\" | \"125\" | \"150\" | \"200\" | \"250\" | \"300\" | \"350\" | \"400\" | \"450\" | \"500\" | \"550\" | \"600\" | \"650\" | \"700\" | \"750\" | \"800\" | \"lg\" | \"md\" | \"none\" | \"sm\" | \"xl\" | \"xs\" | \"xxl\" | \"xxs\"`"
+            "value": "Defines the box's outer right spacing at the SM breakpoint. Accepts a spacing token or `auto`.\n\n**Type:** `\"025\" | \"050\" | \"100\" | \"125\" | \"150\" | \"200\" | \"250\" | \"300\" | \"350\" | \"400\" | \"450\" | \"500\" | \"550\" | \"600\" | \"650\" | \"700\" | \"750\" | \"800\" | \"auto\" | \"lg\" | \"md\" | \"none\" | \"sm\" | \"xl\" | \"xs\" | \"xxl\" | \"xxs\"`"
           },
           "values": [
             {
@@ -2791,6 +2851,9 @@
             {
               "name": "800"
             },
+            {
+              "name": "auto"
+            },
             {
               "name": "lg"
             },
@@ -2821,7 +2884,7 @@
           "name": "margin-inline-end-xl",
           "description": {
             "kind": "markdown",
-            "value": "Defines the box's outer right spacing at the XL breakpoint.\n\n**Type:** `\"025\" | \"050\" | \"100\" | \"125\" | \"150\" | \"200\" | \"250\" | \"300\" | \"350\" | \"400\" | \"450\" | \"500\" | \"550\" | \"600\" | \"650\" | \"700\" | \"750\" | \"800\" | \"lg\" | \"md\" | \"none\" | \"sm\" | \"xl\" | \"xs\" | \"xxl\" | \"xxs\"`"
+            "value": "Defines the box's outer right spacing at the XL breakpoint. Accepts a spacing token or `auto`.\n\n**Type:** `\"025\" | \"050\" | \"100\" | \"125\" | \"150\" | \"200\" | \"250\" | \"300\" | \"350\" | \"400\" | \"450\" | \"500\" | \"550\" | \"600\" | \"650\" | \"700\" | \"750\" | \"800\" | \"auto\" | \"lg\" | \"md\" | \"none\" | \"sm\" | \"xl\" | \"xs\" | \"xxl\" | \"xxs\"`"
           },
           "values": [
             {
@@ -2878,6 +2941,9 @@
             {
               "name": "800"
             },
+            {
+              "name": "auto"
+            },
             {
               "name": "lg"
             },
@@ -2908,7 +2974,7 @@
           "name": "margin-inline-end-xs",
           "description": {
             "kind": "markdown",
-            "value": "Defines the box's outer right spacing at the XS breakpoint.\n\n**Type:** `\"025\" | \"050\" | \"100\" | \"125\" | \"150\" | \"200\" | \"250\" | \"300\" | \"350\" | \"400\" | \"450\" | \"500\" | \"550\" | \"600\" | \"650\" | \"700\" | \"750\" | \"800\" | \"lg\" | \"md\" | \"none\" | \"sm\" | \"xl\" | \"xs\" | \"xxl\" | \"xxs\"`"
+            "value": "Defines the box's outer right spacing at the XS breakpoint. Accepts a spacing token or `auto`.\n\n**Type:** `\"025\" | \"050\" | \"100\" | \"125\" | \"150\" | \"200\" | \"250\" | \"300\" | \"350\" | \"400\" | \"450\" | \"500\" | \"550\" | \"600\" | \"650\" | \"700\" | \"750\" | \"800\" | \"auto\" | \"lg\" | \"md\" | \"none\" | \"sm\" | \"xl\" | \"xs\" | \"xxl\" | \"xxs\"`"
           },
           "values": [
             {
@@ -2965,6 +3031,9 @@
             {
               "name": "800"
             },
+            {
+              "name": "auto"
+            },
             {
               "name": "lg"
             },
@@ -2995,7 +3064,7 @@
           "name": "margin-inline-start",
           "description": {
             "kind": "markdown",
-            "value": "Defines the box's outer left spacing.\n\n**Type:** `\"025\" | \"050\" | \"100\" | \"125\" | \"150\" | \"200\" | \"250\" | \"300\" | \"350\" | \"400\" | \"450\" | \"500\" | \"550\" | \"600\" | \"650\" | \"700\" | \"750\" | \"800\" | \"lg\" | \"md\" | \"none\" | \"sm\" | \"xl\" | \"xs\" | \"xxl\" | \"xxs\"`"
+            "value": "Defines the box's outer left spacing. Accepts a spacing token or `auto`.\n\n**Type:** `\"025\" | \"050\" | \"100\" | \"125\" | \"150\" | \"200\" | \"250\" | \"300\" | \"350\" | \"400\" | \"450\" | \"500\" | \"550\" | \"600\" | \"650\" | \"700\" | \"750\" | \"800\" | \"auto\" | \"lg\" | \"md\" | \"none\" | \"sm\" | \"xl\" | \"xs\" | \"xxl\" | \"xxs\"`"
           },
           "values": [
             {
@@ -3052,6 +3121,9 @@
             {
               "name": "800"
             },
+            {
+              "name": "auto"
+            },
             {
               "name": "lg"
             },
@@ -3082,7 +3154,7 @@
           "name": "margin-inline-start-lg",
           "description": {
             "kind": "markdown",
-            "value": "Defines the box's outer left spacing at the LG breakpoint.\n\n**Type:** `\"025\" | \"050\" | \"100\" | \"125\" | \"150\" | \"200\" | \"250\" | \"300\" | \"350\" | \"400\" | \"450\" | \"500\" | \"550\" | \"600\" | \"650\" | \"700\" | \"750\" | \"800\" | \"lg\" | \"md\" | \"none\" | \"sm\" | \"xl\" | \"xs\" | \"xxl\" | \"xxs\"`"
+            "value": "Defines the box's outer left spacing at the LG breakpoint. Accepts a spacing token or `auto`.\n\n**Type:** `\"025\" | \"050\" | \"100\" | \"125\" | \"150\" | \"200\" | \"250\" | \"300\" | \"350\" | \"400\" | \"450\" | \"500\" | \"550\" | \"600\" | \"650\" | \"700\" | \"750\" | \"800\" | \"auto\" | \"lg\" | \"md\" | \"none\" | \"sm\" | \"xl\" | \"xs\" | \"xxl\" | \"xxs\"`"
           },
           "values": [
             {
@@ -3139,6 +3211,9 @@
             {
               "name": "800"
             },
+            {
+              "name": "auto"
+            },
             {
               "name": "lg"
             },
@@ -3169,7 +3244,7 @@
           "name": "margin-inline-start-md",
           "description": {
             "kind": "markdown",
-            "value": "Defines the box's outer left spacing at the MD breakpoint.\n\n**Type:** `\"025\" | \"050\" | \"100\" | \"125\" | \"150\" | \"200\" | \"250\" | \"300\" | \"350\" | \"400\" | \"450\" | \"500\" | \"550\" | \"600\" | \"650\" | \"700\" | \"750\" | \"800\" | \"lg\" | \"md\" | \"none\" | \"sm\" | \"xl\" | \"xs\" | \"xxl\" | \"xxs\"`"
+            "value": "Defines the box's outer left spacing at the MD breakpoint. Accepts a spacing token or `auto`.\n\n**Type:** `\"025\" | \"050\" | \"100\" | \"125\" | \"150\" | \"200\" | \"250\" | \"300\" | \"350\" | \"400\" | \"450\" | \"500\" | \"550\" | \"600\" | \"650\" | \"700\" | \"750\" | \"800\" | \"auto\" | \"lg\" | \"md\" | \"none\" | \"sm\" | \"xl\" | \"xs\" | \"xxl\" | \"xxs\"`"
           },
           "values": [
             {
@@ -3226,6 +3301,9 @@
             {
               "name": "800"
             },
+            {
+              "name": "auto"
+            },
             {
               "name": "lg"
             },
@@ -3256,7 +3334,7 @@
           "name": "margin-inline-start-sm",
           "description": {
             "kind": "markdown",
-            "value": "Defines the box's outer left spacing at the SM breakpoint.\n\n**Type:** `\"025\" | \"050\" | \"100\" | \"125\" | \"150\" | \"200\" | \"250\" | \"300\" | \"350\" | \"400\" | \"450\" | \"500\" | \"550\" | \"600\" | \"650\" | \"700\" | \"750\" | \"800\" | \"lg\" | \"md\" | \"none\" | \"sm\" | \"xl\" | \"xs\" | \"xxl\" | \"xxs\"`"
+            "value": "Defines the box's outer left spacing at the SM breakpoint. Accepts a spacing token or `auto`.\n\n**Type:** `\"025\" | \"050\" | \"100\" | \"125\" | \"150\" | \"200\" | \"250\" | \"300\" | \"350\" | \"400\" | \"450\" | \"500\" | \"550\" | \"600\" | \"650\" | \"700\" | \"750\" | \"800\" | \"auto\" | \"lg\" | \"md\" | \"none\" | \"sm\" | \"xl\" | \"xs\" | \"xxl\" | \"xxs\"`"
           },
           "values": [
             {
@@ -3313,6 +3391,9 @@
             {
               "name": "800"
             },
+            {
+              "name": "auto"
+            },
             {
               "name": "lg"
             },
@@ -3343,7 +3424,7 @@
           "name": "margin-inline-start-xl",
           "description": {
             "kind": "markdown",
-            "value": "Defines the box's outer left spacing at the XL breakpoint.\n\n**Type:** `\"025\" | \"050\" | \"100\" | \"125\" | \"150\" | \"200\" | \"250\" | \"300\" | \"350\" | \"400\" | \"450\" | \"500\" | \"550\" | \"600\" | \"650\" | \"700\" | \"750\" | \"800\" | \"lg\" | \"md\" | \"none\" | \"sm\" | \"xl\" | \"xs\" | \"xxl\" | \"xxs\"`"
+            "value": "Defines the box's outer left spacing at the XL breakpoint. Accepts a spacing token or `auto`.\n\n**Type:** `\"025\" | \"050\" | \"100\" | \"125\" | \"150\" | \"200\" | \"250\" | \"300\" | \"350\" | \"400\" | \"450\" | \"500\" | \"550\" | \"600\" | \"650\" | \"700\" | \"750\" | \"800\" | \"auto\" | \"lg\" | \"md\" | \"none\" | \"sm\" | \"xl\" | \"xs\" | \"xxl\" | \"xxs\"`"
           },
           "values": [
             {
@@ -3400,6 +3481,9 @@
             {
               "name": "800"
             },
+            {
+              "name": "auto"
+            },
             {
               "name": "lg"
             },
@@ -3430,7 +3514,7 @@
           "name": "margin-inline-start-xs",
           "description": {
             "kind": "markdown",
-            "value": "Defines the box's outer left spacing at the XS breakpoint.\n\n**Type:** `\"025\" | \"050\" | \"100\" | \"125\" | \"150\" | \"200\" | \"250\" | \"300\" | \"350\" | \"400\" | \"450\" | \"500\" | \"550\" | \"600\" | \"650\" | \"700\" | \"750\" | \"800\" | \"lg\" | \"md\" | \"none\" | \"sm\" | \"xl\" | \"xs\" | \"xxl\" | \"xxs\"`"
+            "value": "Defines the box's outer left spacing at the XS breakpoint. Accepts a spacing token or `auto`.\n\n**Type:** `\"025\" | \"050\" | \"100\" | \"125\" | \"150\" | \"200\" | \"250\" | \"300\" | \"350\" | \"400\" | \"450\" | \"500\" | \"550\" | \"600\" | \"650\" | \"700\" | \"750\" | \"800\" | \"auto\" | \"lg\" | \"md\" | \"none\" | \"sm\" | \"xl\" | \"xs\" | \"xxl\" | \"xxs\"`"
           },
           "values": [
             {
@@ -3487,6 +3571,9 @@
             {
               "name": "800"
             },
+            {
+              "name": "auto"
+            },
             {
               "name": "lg"
             },
@@ -6800,7 +6887,7 @@
       "name": "pds-button",
       "description": {
         "kind": "markdown",
-        "value": "A button is an interactive element that can be clicked to perform various actions such as triggering an event, submitting data, or navigating to a different location.\n\n**Examples:**\n[Primary](https://pine-design-system.netlify.app/?path=/docs/components-button--docs#primary), [Secondary](https://pine-design-system.netlify.app/?path=/docs/components-button--docs#secondary), [Tertiary](https://pine-design-system.netlify.app/?path=/docs/components-button--docs#tertiary), [Accent](https://pine-design-system.netlify.app/?path=/docs/components-button--docs#accent), [Destructive](https://pine-design-system.netlify.app/?path=/docs/components-button--docs#destructive), [Disclosure](https://pine-design-system.netlify.app/?path=/docs/components-button--docs#disclosure), [Filter](https://pine-design-system.netlify.app/?path=/docs/components-button--docs#filter), [Full Width](https://pine-design-system.netlify.app/?path=/docs/components-button--docs#full-width), [Loading](https://pine-design-system.netlify.app/?path=/docs/components-button--docs#loading), [Icon Only](https://pine-design-system.netlify.app/?path=/docs/components-button--docs#icon-only), [Sizes](https://pine-design-system.netlify.app/?path=/docs/components-button--docs#sizes), [Compact / custom-surface icon buttons](https://pine-design-system.netlify.app/?path=/docs/components-button--docs#compact-/-custom-surface-icon-buttons), [Button Link](https://pine-design-system.netlify.app/?path=/docs/components-button--docs#button-link), [Type](https://pine-design-system.netlify.app/?path=/docs/components-button--docs#type)\n\n**Slots:**\n- `(default)` - Button text.\n- `end` - Content to display after the button text.\n- `start` - Content to display before the button text.\n\n**CSS Parts:**\n- `button` - Exposes the underlying button (or anchor) element for styling, including custom size, shape, or surface on icon-only placements (e.g. a compact square or inverse icon button).\n- `button-content` - Exposes the button content for styling.\n- `button-text` - Exposes the button text for styling.\n- `caret` - Exposes the caret icon component for styling. Appears only on the disclosure variant.\n- `icon` - Exposes the icon component for styling.\n- `loader-svg` - Exposes the loader SVG element for color customization. Appears only when loading.\n\n**Events:**\n- `pdsClick` - No description"
+        "value": "A button is an interactive element that can be clicked to perform various actions such as triggering an event, submitting data, or navigating to a different location.\n\n**Examples:**\n[Primary](https://pine-design-system.netlify.app/?path=/docs/components-button--docs#primary), [Secondary](https://pine-design-system.netlify.app/?path=/docs/components-button--docs#secondary), [Tertiary](https://pine-design-system.netlify.app/?path=/docs/components-button--docs#tertiary), [Accent](https://pine-design-system.netlify.app/?path=/docs/components-button--docs#accent), [Destructive](https://pine-design-system.netlify.app/?path=/docs/components-button--docs#destructive), [Disclosure](https://pine-design-system.netlify.app/?path=/docs/components-button--docs#disclosure), [Filter](https://pine-design-system.netlify.app/?path=/docs/components-button--docs#filter), [Unstyled](https://pine-design-system.netlify.app/?path=/docs/components-button--docs#unstyled), [Full Width](https://pine-design-system.netlify.app/?path=/docs/components-button--docs#full-width), [Loading](https://pine-design-system.netlify.app/?path=/docs/components-button--docs#loading), [Icons](https://pine-design-system.netlify.app/?path=/docs/components-button--docs#icons), [Icon Only](https://pine-design-system.netlify.app/?path=/docs/components-button--docs#icon-only), [Sizes](https://pine-design-system.netlify.app/?path=/docs/components-button--docs#sizes), [Compact / custom-surface icon buttons](https://pine-design-system.netlify.app/?path=/docs/components-button--docs#compact-/-custom-surface-icon-buttons), [Button Link](https://pine-design-system.netlify.app/?path=/docs/components-button--docs#button-link), [Type](https://pine-design-system.netlify.app/?path=/docs/components-button--docs#type)\n\n**Slots:**\n- `(default)` - Button text.\n- `end` - Content to display after the button text.\n- `start` - Content to display before the button text.\n\n**CSS Parts:**\n- `button` - Exposes the underlying button (or anchor) element for styling, including custom size, shape, or surface on icon-only placements (e.g. a compact square or inverse icon button).\n- `button-content` - Exposes the button content for styling.\n- `button-text` - Exposes the button text for styling.\n- `caret` - Exposes the caret icon component for styling. Appears only on the disclosure variant.\n- `icon` - Exposes the icon component for styling.\n- `loader-svg` - Exposes the loader SVG element for color customization. Appears only when loading.\n\n**Events:**\n- `pdsClick` - Emitted when the button is clicked, including from the keyboard, carrying the native click event.\nNot emitted while the button is `disabled` or `loading`. In a form, a `submit` or `reset` button's `submit` or `reset` event fires\nbefore this one. A form that fails validation fires no `submit` event."
       },
       "attributes": [
         {
@@ -6835,7 +6922,7 @@
           "name": "href",
           "description": {
             "kind": "markdown",
-            "value": "If provided, renders the component as an anchor (`<a>`) element instead of a button.\nWhen using href, button-specific props (type, name, value, loading) will be ignored."
+            "value": "If provided, renders the component as an anchor (`<a>`) element instead of a button.\nWhen using href, `type`, `name` and `value` are ignored, `loading` blocks navigation, and `disabled` removes the link's `href`."
           }
         },
         {
@@ -6863,7 +6950,7 @@
           "name": "name",
           "description": {
             "kind": "markdown",
-            "value": "Provides the button with a submittable name."
+            "value": "Sets the `name` attribute of the inner button. Not included in submitted form data,\nbecause the form is submitted through a hidden button that carries only the `type`."
           }
         },
         {
@@ -6927,7 +7014,7 @@
           "name": "value",
           "description": {
             "kind": "markdown",
-            "value": "Provides button with a submittable value"
+            "value": "Sets the `value` attribute of the inner button. Not included in submitted form data,\nbecause the form is submitted through a hidden button that carries only the `type`."
           }
         },
         {
@@ -6975,7 +7062,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), [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"
+        "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` - Emitted when the user toggles the checkbox, by a click or `Space`, carrying the `value` and the new `checked` state.\n\nThis event will not emit when programmatically setting the `checked` property.\n- `pdsCheckboxInput` - Emitted when the user toggles the checkbox, just before `pdsCheckboxChange`, carrying the `value` and `checked`.\n`checked` is still the state from before the toggle, so read the new state from `pdsCheckboxChange`.\n\nThis event will not emit when programmatically setting the `checked` property."
       },
       "attributes": [
         {
@@ -7003,14 +7090,14 @@
           "name": "error-message",
           "description": {
             "kind": "markdown",
-            "value": "Displays message text describing an invalid state."
+            "value": "Displays an error message below the checkbox. It becomes the checkbox's accessible description only while `invalid` is set."
           }
         },
         {
           "name": "helper-message",
           "description": {
             "kind": "markdown",
-            "value": "String used for helper message below checkbox."
+            "value": "Displays a message or hint below the checkbox."
           }
         },
         {
@@ -7024,21 +7111,21 @@
           "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).\nHas no visual style when `variant` is `pill`."
+            "value": "Shows the checkbox as indeterminate, for a checkbox whose group is only partly selected. It's exposed to screen readers as mixed.\nChanging `checked` clears it. Has no visual style when `variant` is `pill`."
           }
         },
         {
           "name": "invalid",
           "description": {
             "kind": "markdown",
-            "value": "It determines whether or not the checkbox is invalid."
+            "value": "Determines whether or not the checkbox is invalid."
           }
         },
         {
           "name": "label",
           "description": {
             "kind": "markdown",
-            "value": "String used for label text next to checkbox."
+            "value": "Text to be displayed as the checkbox label."
           }
         },
         {
@@ -7089,7 +7176,7 @@
       "name": "pds-chip",
       "description": {
         "kind": "markdown",
-        "value": "Chips are used to inform users about the status of an object or to associate properties with a parent. Commonly used in tabular data to indicate status.\n\n**Examples:**\n[Default](https://pine-design-system.netlify.app/?path=/docs/components-chip--docs#default), [Sentiment](https://pine-design-system.netlify.app/?path=/docs/components-chip--docs#sentiment), [Dot](https://pine-design-system.netlify.app/?path=/docs/components-chip--docs#dot), [Icon](https://pine-design-system.netlify.app/?path=/docs/components-chip--docs#icon), [Dropdown](https://pine-design-system.netlify.app/?path=/docs/components-chip--docs#dropdown), [Tag](https://pine-design-system.netlify.app/?path=/docs/components-chip--docs#tag), [Sizes](https://pine-design-system.netlify.app/?path=/docs/components-chip--docs#sizes), [Truncating a long label](https://pine-design-system.netlify.app/?path=/docs/components-chip--docs#truncating-a-long-label)\n\n**Slots:**\n- `(default)` - The chip's label text.\n\n**CSS Parts:**\n- `button` - No description\n- `dot` - Exposes the dot for styling, such as a custom color. Appears only when `dot` is set.\n- `icon` - Exposes the icon component for styling, such as a custom color. Appears only when `icon` is set.\n\n**Events:**\n- `pdsTagCloseClick` - Event emitted when the close button is clicked on a tag variant chip."
+        "value": "Chips are used to inform users about the status of an object or to associate properties with a parent. Commonly used in tabular data to indicate status.\n\n**Examples:**\n[Default](https://pine-design-system.netlify.app/?path=/docs/components-chip--docs#default), [Sentiment](https://pine-design-system.netlify.app/?path=/docs/components-chip--docs#sentiment), [Dot](https://pine-design-system.netlify.app/?path=/docs/components-chip--docs#dot), [Icon](https://pine-design-system.netlify.app/?path=/docs/components-chip--docs#icon), [Dropdown](https://pine-design-system.netlify.app/?path=/docs/components-chip--docs#dropdown), [Tag](https://pine-design-system.netlify.app/?path=/docs/components-chip--docs#tag), [Sizes](https://pine-design-system.netlify.app/?path=/docs/components-chip--docs#sizes), [Truncating a long label](https://pine-design-system.netlify.app/?path=/docs/components-chip--docs#truncating-a-long-label)\n\n**Slots:**\n- `(default)` - The chip's label text.\n\n**CSS Parts:**\n- `button` - Exposes the trigger button for styling. Appears only on the dropdown variant.\n- `dot` - Exposes the dot for styling, such as a custom color. Appears only when `dot` is set.\n- `icon` - Exposes the icon component for styling, such as a custom color. Appears only when `icon` is set.\n\n**Events:**\n- `pdsTagCloseClick` - Event emitted when the close button is clicked on a tag variant chip."
       },
       "attributes": [
         {
@@ -7145,7 +7232,7 @@
           "name": "remove-http-method",
           "description": {
             "kind": "markdown",
-            "value": "HTTP method to use for the remove action.\nAdds data-method and data-turbo-method attributes for Rails/Turbo compatibility.\nOnly applies when removeUrl is provided.\n\n**Type:** `\"delete\" | \"get\" | \"patch\" | \"post\" | \"put\"`"
+            "value": "HTTP method to use for the remove action.\nMaps to the `data-method` and `data-turbo-method` attributes on the remove link, for frameworks that read link methods from them.\nOnly applies when removeUrl is provided.\n\n**Type:** `\"delete\" | \"get\" | \"patch\" | \"post\" | \"put\"`"
           },
           "values": [
             {
@@ -7277,7 +7364,7 @@
       "name": "pds-combobox",
       "description": {
         "kind": "markdown",
-        "value": "A combobox is a text input with a dropdown list of options, allowing users to filter and select from a list. It is useful for searchable selects and autocomplete scenarios.\n\n**Slots:**\n- `empty` - Custom empty state message when no options match\n- `loading` - Custom loading indicator\n- `option` - Option elements for the combobox dropdown\n- `trigger-content` - Custom content for the button trigger when customTriggerContent is true\n\n**CSS Parts:**\n- `button-trigger` - No description\n- `chip-trigger` - No description\n- `combobox` - No description\n- `input` - No description\n\n**Events:**\n- `pdsComboboxChange` - Emitted when the value changes.\n- `pdsComboboxLoadOptions` - Emitted to request more options (pagination).\n- `pdsComboboxSearch` - Emitted on search input (for consumer-managed async)."
+        "value": "A combobox is a text input with a dropdown list of options, allowing users to filter and select from a list. It is useful for searchable selects and autocomplete scenarios.\n\n**Slots:**\n- `empty` - Custom empty state message when no options match\n- `loading` - Custom loading indicator\n- `option` - Option elements for the combobox dropdown\n- `trigger-content` - Custom content for the button trigger when customTriggerContent is true\n\n**CSS Parts:**\n- `button-trigger` - Exposes the button trigger for styling. Appears only when `trigger` is `button`.\n- `chip-trigger` - Exposes the chip trigger for styling. Appears only when `trigger` is `chip`.\n- `combobox` - Exposes the outer container around the label, trigger and messages for styling.\n- `input` - Exposes the native `input` element for styling. Appears only when `trigger` is `input`, the default.\n\n**Events:**\n- `pdsComboboxChange` - Emitted when the value changes.\n- `pdsComboboxLoadOptions` - Emitted to request more options (pagination).\n- `pdsComboboxSearch` - Emitted on search input (for consumer-managed async)."
       },
       "attributes": [
         {
@@ -7441,7 +7528,7 @@
           "name": "dropdown-width",
           "description": {
             "kind": "markdown",
-            "value": "Width of the dropdown. Any valid CSS width value.\n\n**Default:** `'236px'`"
+            "value": "Width of the dropdown, including its padding. Any valid CSS width value.\nWithout it, the dropdown is 252px wide, 244px with grouped options and 236px with a panel search."
           }
         },
         {
@@ -7462,14 +7549,14 @@
           "name": "flyout-max-width",
           "description": {
             "kind": "markdown",
-            "value": "Maximum width of a group's flyout when `group-display` is `flyout`. Any valid CSS width value.\n\n**Default:** `'380px'`"
+            "value": "Maximum width of a group's flyout when `group-display` is `flyout`. Any valid CSS width\nvalue, including its padding.\n\n**Default:** `'388px'`"
           }
         },
         {
           "name": "flyout-min-width",
           "description": {
             "kind": "markdown",
-            "value": "Minimum width of a group's flyout when `group-display` is `flyout`. Any valid CSS width value.\nThe flyout is as wide as its options, between this and `flyout-max-width`.\n\n**Default:** `'280px'`"
+            "value": "Minimum width of a group's flyout when `group-display` is `flyout`. Any valid CSS width\nvalue, including its padding. The flyout is as wide as its options, between this and\n`flyout-max-width`.\n\n**Default:** `'288px'`"
           }
         },
         {
@@ -7661,7 +7748,7 @@
           "name": "value",
           "description": {
             "kind": "markdown",
-            "value": "The value of the combobox input.\n\n**Default:** `''`"
+            "value": "The `value` of the selected option.\n\n**Default:** `''`"
           }
         }
       ],
@@ -7726,7 +7813,7 @@
       "name": "pds-copytext",
       "description": {
         "kind": "markdown",
-        "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."
+        "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), [Copy result](https://pine-design-system.netlify.app/?path=/docs/components-copy-text--docs#copy-result)\n\n**Events:**\n- `pdsCopyTextClick` - Emitted after a click, once the copy to the clipboard succeeds or fails.\n`detail` is `Copied to clipboard` on success, or `Error writing text to clipboard: ` followed by the error on failure.\nNot emitted when `navigator.clipboard` is undefined, as it is outside a secure context."
       },
       "attributes": [
         {
@@ -7776,7 +7863,7 @@
       "name": "pds-datepicker",
       "description": {
         "kind": "markdown",
-        "value": "Datepicker captures a single date, or in range mode a start and an end date. For a single date, people can type it as `YYYY-MM-DD` or pick it from a calendar that opens from the button in the field. The value is always a `YYYY-MM-DD` string (`YYYY-MM-DD/YYYY-MM-DD` for a range), so it never shifts by a day with the viewer's time zone. With `month-day`, for a date that comes round every year such as a birthday, it's a month and day with no year, `--MM-DD`.\n\n**Examples:**\n[Default](https://pine-design-system.netlify.app/?path=/docs/components-datepicker--docs#default), [Min and max](https://pine-design-system.netlify.app/?path=/docs/components-datepicker--docs#min-and-max), [Locale and first day of the week](https://pine-design-system.netlify.app/?path=/docs/components-datepicker--docs#locale-and-first-day-of-the-week), [Format](https://pine-design-system.netlify.app/?path=/docs/components-datepicker--docs#format), [Range](https://pine-design-system.netlify.app/?path=/docs/components-datepicker--docs#range), [Range with presets](https://pine-design-system.netlify.app/?path=/docs/components-datepicker--docs#range-with-presets), [Range that applies on pick](https://pine-design-system.netlify.app/?path=/docs/components-datepicker--docs#range-that-applies-on-pick), [Range with times](https://pine-design-system.netlify.app/?path=/docs/components-datepicker--docs#range-with-times), [Month and year dropdowns](https://pine-design-system.netlify.app/?path=/docs/components-datepicker--docs#month-and-year-dropdowns), [Month and day, without a year](https://pine-design-system.netlify.app/?path=/docs/components-datepicker--docs#month-and-day,-without-a-year), [Initially empty, with Clear](https://pine-design-system.netlify.app/?path=/docs/components-datepicker--docs#initially-empty,-with-clear), [Placement](https://pine-design-system.netlify.app/?path=/docs/components-datepicker--docs#placement), [Invalid](https://pine-design-system.netlify.app/?path=/docs/components-datepicker--docs#invalid), [Disabled](https://pine-design-system.netlify.app/?path=/docs/components-datepicker--docs#disabled)\n\n**CSS Parts:**\n- `calendar` - The open calendar. It's portaled out of the datepicker, so style it with `.pds-datepicker-calendar-portal::part(calendar)`.\n- `presets` - The list of preset ranges in the calendar, styled with `.pds-datepicker-calendar-portal::part(presets)`.\n\n**Events:**\n- `pdsBlur` - Emitted when the datepicker loses focus: when focus leaves the field and the calendar.\n- `pdsDatepickerChange` - Emitted when the value changes.\n\nThis event will not emit when programmatically setting the `value` property.\n- `pdsFocus` - Emitted when the datepicker gains focus: when focus moves into the field or the calendar from outside."
+        "value": "Datepicker captures a date, or with `range` a start and end date, as an ISO `YYYY-MM-DD` value that never shifts by a day with the viewer's time zone. People type it or pick it from a calendar that opens from the button in the field. A range is `YYYY-MM-DD/YYYY-MM-DD`, and with `time-picker` each date carries a time, as `YYYY-MM-DDTHH:mm`. With `month-day`, for a date that comes round every year such as a birthday, it's a month and day with no year, `--MM-DD`.\n\n**Examples:**\n[Default](https://pine-design-system.netlify.app/?path=/docs/components-datepicker--docs#default), [Min and max](https://pine-design-system.netlify.app/?path=/docs/components-datepicker--docs#min-and-max), [Locale and first day of the week](https://pine-design-system.netlify.app/?path=/docs/components-datepicker--docs#locale-and-first-day-of-the-week), [Format](https://pine-design-system.netlify.app/?path=/docs/components-datepicker--docs#format), [Range](https://pine-design-system.netlify.app/?path=/docs/components-datepicker--docs#range), [Range with presets](https://pine-design-system.netlify.app/?path=/docs/components-datepicker--docs#range-with-presets), [Range that applies on pick](https://pine-design-system.netlify.app/?path=/docs/components-datepicker--docs#range-that-applies-on-pick), [Range with times](https://pine-design-system.netlify.app/?path=/docs/components-datepicker--docs#range-with-times), [Month and year dropdowns](https://pine-design-system.netlify.app/?path=/docs/components-datepicker--docs#month-and-year-dropdowns), [Month and day, without a year](https://pine-design-system.netlify.app/?path=/docs/components-datepicker--docs#month-and-day,-without-a-year), [Initially empty, with Clear](https://pine-design-system.netlify.app/?path=/docs/components-datepicker--docs#initially-empty,-with-clear), [Placement](https://pine-design-system.netlify.app/?path=/docs/components-datepicker--docs#placement), [Invalid](https://pine-design-system.netlify.app/?path=/docs/components-datepicker--docs#invalid), [Disabled](https://pine-design-system.netlify.app/?path=/docs/components-datepicker--docs#disabled)\n\n**CSS Parts:**\n- `calendar` - The open calendar. It's portaled out of the datepicker, so style it with `.pds-datepicker-calendar-portal::part(calendar)`.\n- `presets` - The list of preset ranges in the calendar, styled with `.pds-datepicker-calendar-portal::part(presets)`.\n\n**Events:**\n- `pdsBlur` - Emitted when the datepicker loses focus: when focus leaves the field and the calendar.\n- `pdsDatepickerChange` - Emitted when the value changes.\n\nThis event will not emit when programmatically setting the `value` property.\n- `pdsFocus` - Emitted when the datepicker gains focus: when focus moves into the field or the calendar from outside."
       },
       "attributes": [
         {
@@ -8052,7 +8139,7 @@
           "name": "presets",
           "description": {
             "kind": "markdown",
-            "value": "Ranges listed beside the calendar in range mode. A comma-separated list of built-in keys\n(`today`, `yesterday`, `last-7-days`, `last-30-days`, `last-90-days`, `this-month`,\n`last-month`, `this-quarter`, `last-quarter`, `this-year`, `last-year`, `year-to-date`,\n`last-12-months`), or an array of `{ key, label?, start?, end? }` to relabel built-ins or add\nyour own.\n\n**Type:** `DatepickerPreset[] | string`"
+            "value": "Ranges listed beside the calendar in range mode. A comma-separated list of built-in keys\n(`today`, `yesterday`, `last-7-days`, `last-30-days`, `last-90-days`, `this-month`,\n`last-month`, `this-quarter`, `last-quarter`, `this-year`, `last-year`, `year-to-date`,\n`last-12-months`), or an array of `{ key, label?, startOffset?, endOffset?, start?, end? }` to\nrelabel built-ins or add your own: `startOffset` and `endOffset` follow today, `start` and `end`\nare fixed days.\n\n**Type:** `DatepickerPreset[] | string`"
           }
         },
         {
@@ -8217,7 +8304,7 @@
       "name": "pds-drawer",
       "description": {
         "kind": "markdown",
-        "value": "A side panel. By default it's non-modal: unlike `pds-modal`, the page stays interactive while a drawer is open — no dimming, no blur, no scroll lock, no click blocking. Add `modal` for a drawer the page should wait on (see [Modal](#modal)).\n\n**Events:**\n- `pdsDrawerClose` - Emitted when the drawer is closed\n- `pdsDrawerOpen` - Emitted when the drawer is opened"
+        "value": "Drawers are side panels that open beside the page, which stays interactive by default. Add `modal` for a drawer the page should wait on (see [Modal](#modal)).\n\n**Events:**\n- `pdsDrawerClose` - Emitted when the drawer is closed\n- `pdsDrawerOpen` - Emitted when the drawer is opened"
       },
       "attributes": [
         {
@@ -8246,7 +8333,7 @@
           "name": "light-dismiss",
           "description": {
             "kind": "markdown",
-            "value": "Whether the drawer can be dismissed with a pointerdown outside it (in a\n`modal` drawer, a click on its backdrop).\nReplaces `pds-modal`'s `backdropDismiss`.\nThis also gates Escape, matching how `backdropDismiss` gates Escape on\n`pds-modal` today: setting this to `false` means the close button is the\nonly way out.\n\nA trigger outside the drawer should only ever set `open` to `true` and\nleave closing to the drawer itself. A toggle-style trigger (`open =\n!open`) fights light dismiss: clicking it while open closes the drawer\non `pointerdown`, then the trigger's own click handler re-opens it.\n\n**Default:** `true`"
+            "value": "Whether the drawer can be dismissed with a pointerdown outside it (in a\n`modal` drawer, a click on its backdrop).\nSetting it to `false` also turns off Escape, so the close button is the\nonly way out.\n\nA trigger outside the drawer should only ever set `open` to `true` and\nleave closing to the drawer itself. A toggle-style trigger (`open =\n!open`) fights light dismiss: clicking it while open closes the drawer\non `pointerdown`, then the trigger's own click handler re-opens it.\n\n**Default:** `true`"
           }
         },
         {
@@ -8274,7 +8361,7 @@
           "name": "side",
           "description": {
             "kind": "markdown",
-            "value": "Which edge of the viewport the drawer is docked to. Logical, so this is\nfree under RTL — `end` is the inline-end edge regardless of direction.\n\n**Type:** `\"end\" | \"start\"`\n\n**Default:** `'end'`"
+            "value": "Which edge of the viewport the drawer is docked to. Logical: `end` is the\ninline-end edge, so an `end` drawer docks on the left in right-to-left layouts.\n\n**Type:** `\"end\" | \"start\"`\n\n**Default:** `'end'`"
           },
           "values": [
             {
@@ -8312,7 +8399,7 @@
       "name": "pds-drawer-content",
       "description": {
         "kind": "markdown",
-        "value": "Fills the drawer panel's height by default — unlike `pds-modal-content`,\nwhich caps itself against the viewport for a centered, possibly-shorter\nmodal, a drawer panel is already edge-to-edge, so its content can simply\nflex to fill whatever space the header and footer leave."
+        "value": "Fills the space between the drawer header and footer."
       },
       "attributes": [],
       "references": [
@@ -8326,7 +8413,7 @@
       "name": "pds-drawer-footer",
       "description": {
         "kind": "markdown",
-        "value": ""
+        "value": "Holds the drawer's actions in a padded row aligned to the end, with a divider above."
       },
       "attributes": [],
       "references": [
@@ -8340,7 +8427,7 @@
       "name": "pds-drawer-header",
       "description": {
         "kind": "markdown",
-        "value": ""
+        "value": "Holds the drawer's title and close control in a padded row, spaced apart, with a divider below."
       },
       "attributes": [],
       "references": [
@@ -8354,7 +8441,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), [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."
+        "value": "Dropdown Menus reveal a list of actions from a button trigger, based on 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), [Handling Selection](https://pine-design-system.netlify.app/?path=/docs/components-dropdown-menu--docs#handling-selection), [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- `(default)` - The menu items: `pds-dropdown-menu-item` and `pds-dropdown-menu-separator` elements, or raw `<a>` and `<button>` elements.\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- `trigger` - The trigger element for the dropdown menu. It receives `aria-expanded` and `aria-haspopup`, so slot the focusable control itself, such as a `pds-button`, not a wrapper around it.\n\n**CSS Parts:**\n- `menu-panel` - Exposes the dropdown menu container for styling."
       },
       "attributes": [
         {
@@ -8421,7 +8508,7 @@
       "name": "pds-dropdown-menu-item",
       "description": {
         "kind": "markdown",
-        "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."
+        "value": "An item inside a `pds-dropdown-menu`. Renders a button by default, or a link when `href` is set. An `informational` item renders text that can't be activated, even when `href` is set.\n\n**Slots:**\n- `(default)` - The item's label.\n- `start` - Content to display before the item's label, such as a `pds-icon`. A `pds-icon` without an `aria-label` or `aria-labelledby` is decorative; a named one is announced before the label, so leave decorative icons unnamed.\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 menu item is clicked."
       },
       "attributes": [
         {
@@ -8435,14 +8522,14 @@
           "name": "destructive",
           "description": {
             "kind": "markdown",
-            "value": "It determines whether or not the dropdown-item is destructive.\n\n**Default:** `false`"
+            "value": "Determines whether or not the dropdown menu item is destructive.\n\n**Default:** `false`"
           }
         },
         {
           "name": "disabled",
           "description": {
             "kind": "markdown",
-            "value": "It determines whether or not the dropdown-item is disabled.\n\n**Default:** `false`"
+            "value": "Determines whether or not the dropdown menu item is disabled.\n\n**Default:** `false`"
           }
         },
         {
@@ -8456,35 +8543,35 @@
           "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.\nIgnored when `informational` is set.\n\n**Default:** `false`"
+            "value": "Shows the external-link (launch) icon. Opens in a new tab unless `target` says otherwise.\nOnly applies when href is set. Ignored 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."
+            "value": "Accessible label for the icon that `external` shows, passed to the inner\n`pds-link` and appended to the item's name. It isn't announced when\n`target` is anything other than `_blank`. Pass a translated string to\nlocalize it; defaults to English. Pass an empty string to make the icon\ndecorative."
           }
         },
         {
           "name": "href",
           "description": {
             "kind": "markdown",
-            "value": "If provided, renders the dropdown-item as an anchor (`<a>`) element instead of a button.\nIgnored when `informational` is set."
+            "value": "If provided, renders the dropdown menu 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`"
+            "value": "Determines whether or not the dropdown menu 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. Ignored when `informational` is set.\n\n**Type:** `\"_blank\" | \"_parent\" | \"_self\" | \"_top\"`"
+            "value": "Specifies where to open the linked document when href is provided.\nOverrides the new-tab default of `external`; the icon still shows.\nOnly applies when href is set. Ignored when `informational` is set.\n\n**Type:** `\"_blank\" | \"_parent\" | \"_self\" | \"_top\"`"
           },
           "values": [
             {
@@ -8513,7 +8600,7 @@
       "name": "pds-dropdown-menu-separator",
       "description": {
         "kind": "markdown",
-        "value": ""
+        "value": "A divider line between groups of items in a `pds-dropdown-menu`."
       },
       "attributes": [
         {
@@ -8527,7 +8614,7 @@
           "name": "disabled",
           "description": {
             "kind": "markdown",
-            "value": "It determines whether or not the dropdown-item is disabled.\n\n**Default:** `false`"
+            "value": "Has no effect. A separator can't be focused or activated.\n\n**Default:** `false`"
           }
         }
       ],
@@ -8542,7 +8629,7 @@
       "name": "pds-filter",
       "description": {
         "kind": "markdown",
-        "value": "Individual filter component with cross-browser popover positioning.\n\nUses a hybrid approach for optimal cross-browser compatibility:\n- Modern browsers: CSS anchor positioning + JavaScript flip classes\n- Fallback browsers: JavaScript positioning with viewport boundary detection\n\n**Slots:**\n- `(default)` - Popover content that will be displayed when the filter is open.\n\n**CSS Parts:**\n- `button` - Exposes the trigger button element for styling.\n- `button-content` - Exposes the button content container for styling.\n- `button-text` - Exposes the button text for styling.\n- `icon` - Exposes the icon component for styling.\n- `popover` - Exposes the popover container for styling.\n\n**Events:**\n- `pdsFilterClear` - Event emitted when the clear variant is clicked.\n- `pdsFilterClose` - Event emitted when the filter popover is closed.\n- `pdsFilterOpen` - Event emitted when the filter popover is opened."
+        "value": "A single filter in `pds-filters`: a trigger button that opens a popover holding the filter controls.\nThe `clear` variant has no popover and emits `pdsFilterClear` instead.\n\n**Slots:**\n- `(default)` - Popover content that will be displayed when the filter is open.\n\n**CSS Parts:**\n- `button` - Exposes the trigger button element for styling.\n- `button-content` - Exposes the button content container for styling.\n- `button-text` - Exposes the button text for styling.\n- `icon` - Exposes the icon component for styling.\n- `popover` - Exposes the popover container for styling.\n\n**Events:**\n- `pdsFilterClear` - Event emitted when the clear variant is clicked.\n- `pdsFilterClose` - Event emitted when the filter popover is closed.\n- `pdsFilterOpen` - Event emitted when the filter popover is opened."
       },
       "attributes": [
         {
@@ -8563,7 +8650,7 @@
           "name": "text",
           "description": {
             "kind": "markdown",
-            "value": "The text content displayed in the trigger button."
+            "value": "The text content displayed in the trigger button.\nWhen text overflows, a tooltip showing the full text will appear on hover/focus."
           }
         },
         {
@@ -8599,7 +8686,7 @@
       "name": "pds-filters",
       "description": {
         "kind": "markdown",
-        "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."
+        "value": "Filters are a row of popover triggers for narrowing a set of data. The `pds-filters` container lays out the row, and each `pds-filter` child holds the controls for one filter.\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": [
         {
@@ -8621,14 +8708,14 @@
       "name": "pds-image",
       "description": {
         "kind": "markdown",
-        "value": "An image can be used to convey supplemental information to the user or as decoration.\n\n**Examples:**\n[Default](https://pine-design-system.netlify.app/?path=/docs/components-image--docs#default), [Sizes and Srcset](https://pine-design-system.netlify.app/?path=/docs/components-image--docs#sizes-and-srcset)"
+        "value": "An image can be used to convey supplemental information to the user or as decoration.\n\n**Examples:**\n[Default](https://pine-design-system.netlify.app/?path=/docs/components-image--docs#default), [Sizes and Srcset](https://pine-design-system.netlify.app/?path=/docs/components-image--docs#sizes-and-srcset), [Aspect Ratio](https://pine-design-system.netlify.app/?path=/docs/components-image--docs#aspect-ratio), [Fit](https://pine-design-system.netlify.app/?path=/docs/components-image--docs#fit), [Load and error events](https://pine-design-system.netlify.app/?path=/docs/components-image--docs#load-and-error-events)\n\n**Events:**\n- `pdsImageError` - Emitted when the image fails to load, such as for a broken or empty `src`. An image\nwith no `src` or `srcset` at all emits neither event, since it has nothing to load.\nEmitted again after `src` or `srcset` changes and the new image fails. Bubbles and is\ncomposed, so a listener on an ancestor gets every `pds-image`'s events — check\n`event.target` when more than one is in scope.\n- `pdsImageLoad` - Emitted when the image loads. Also emitted on first render for an image that\nfinished loading before the component could listen, such as a server-rendered\nimage. Emitted again after `src` or `srcset` changes and the new image loads, or\nwhen the browser picks a different `srcset` candidate, such as on a resize. Bubbles\nand is composed, so a listener on an ancestor gets every `pds-image`'s events —\ncheck `event.target` when more than one is in scope."
       },
       "attributes": [
         {
           "name": "alt",
           "description": {
             "kind": "markdown",
-            "value": "The image's alt tag. If none is provided,\nit will default to an empty string, which is desired for\ndecorative images.\n\n**Default:** `''`"
+            "value": "The image's alt text. Defaults to an empty string, which marks the image\nas decorative and hides it from screen readers, so set it on any image\nthat carries information.\n\n**Default:** `''`"
           }
         },
         {
@@ -8638,11 +8725,35 @@
             "value": "A unique identifier used for the underlying component `id` attribute."
           }
         },
+        {
+          "name": "fit",
+          "description": {
+            "kind": "markdown",
+            "value": "Determines how the image fills the shape set by `ratio`.\nHas no effect if `ratio` is not set.\n\n**Type:** `\"contain\" | \"cover\" | \"fill\" | \"none\" | \"scale-down\"`\n\n**Default:** `'cover'`"
+          },
+          "values": [
+            {
+              "name": "contain"
+            },
+            {
+              "name": "cover"
+            },
+            {
+              "name": "fill"
+            },
+            {
+              "name": "none"
+            },
+            {
+              "name": "scale-down"
+            }
+          ]
+        },
         {
           "name": "height",
           "description": {
             "kind": "markdown",
-            "value": "The height of the image in pixels. Setting this will\ndevote space in the layout to prevent layout\nshifts when the image is loaded.\n\n**Type:** `number`"
+            "value": "The height of the image in pixels. `height: auto` lets the loaded image's own\nproportions decide its rendered height, so unlike `width` this does not reserve\nspace before the image loads.\n\n**Type:** `number`"
           }
         },
         {
@@ -8660,6 +8771,30 @@
             }
           ]
         },
+        {
+          "name": "ratio",
+          "description": {
+            "kind": "markdown",
+            "value": "The aspect ratio the image is sized to, cropping whatever overflows the shape. A preset\n(`square` 1/1, `landscape` 4/3, `wide` 16/9, `portrait` 3/4, `tall` 9/16) or any custom\nCSS ratio, such as `21 / 9`. Use this, not `height` and `width`, to crop: those only\nreserve space, and only `width` reliably does even that.\n\n**Type:** `\"landscape\" | \"portrait\" | \"square\" | \"tall\" | \"wide\" | string & Record<never, never>`"
+          },
+          "values": [
+            {
+              "name": "landscape"
+            },
+            {
+              "name": "portrait"
+            },
+            {
+              "name": "square"
+            },
+            {
+              "name": "tall"
+            },
+            {
+              "name": "wide"
+            }
+          ]
+        },
         {
           "name": "sizes",
           "description": {
@@ -8685,7 +8820,7 @@
           "name": "width",
           "description": {
             "kind": "markdown",
-            "value": "The width of the image in pixels. Setting this will\ndevote space in the layout to prevent layout\nshifts when the image is loaded.\n\n**Type:** `number`"
+            "value": "The width of the image in pixels. This reserves the image's width before it\nloads, but not its height: to reserve the height too, set\n`--dimension-aspect-ratio` to the image's own proportions.\n\n**Type:** `number`"
           }
         }
       ],
@@ -8700,7 +8835,7 @@
       "name": "pds-input",
       "description": {
         "kind": "markdown",
-        "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."
+        "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), [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)\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` - Exposes the wrapper around the `action` slot for styling. Appears only when the `action` slot has content.\n- `append` - Exposes the wrapper around the `append` slot for styling. Appears only when the `append` slot has content.\n- `prefix` - Exposes the wrapper around the `prefix` slot for styling. Appears only when the `prefix` slot has content.\n- `prepend` - Exposes the wrapper around the `prepend` slot for styling. Appears only when the `prepend` slot has content.\n- `suffix` - Exposes the wrapper around the `suffix` slot for styling. Appears only when the `suffix` slot has content.\n\n**Events:**\n- `pdsBlur` - Emitted when the input loses focus.\n- `pdsChange` - Emitted when the user changes the value and then presses `Enter` or leaves the field.\n`detail` has `value`, as a string, and `event`, the native event behind it, usually `change`.\n\nThis event will not emit when programmatically setting the `value` property, unless the field has focus at the time;\nthen it emits when the field loses focus.\n- `pdsFocus` - Emitted when the input has focus.\n- `pdsInput` - Emitted after each `input` event, such as typing or pasting. With `debounce`, it waits until that many milliseconds have passed since the last one.\n`detail` has `value`, the current value as a string, and `event`, the native `input` event.\n\nThis event will not emit when programmatically setting the `value` property.\n- `pdsKeyDown` - Emitted when a key is pressed down in the input."
       },
       "attributes": [
         {
@@ -8721,7 +8856,7 @@
           "name": "debounce",
           "description": {
             "kind": "markdown",
-            "value": "Sets the number of milliseconds to wait before updating the value.\n\n**Type:** `number`"
+            "value": "Sets the number of milliseconds to wait after each input event before emitting `pdsInput`.\n\n**Type:** `number`"
           }
         },
         {
@@ -8735,7 +8870,7 @@
           "name": "error-message",
           "description": {
             "kind": "markdown",
-            "value": "Specifies the error message and provides an error-themed treatment to the field."
+            "value": "Displays an error message below the input and gives the field error styling. It becomes the input's accessible description only while `invalid` is set."
           }
         },
         {
@@ -8770,7 +8905,7 @@
           "name": "invalid",
           "description": {
             "kind": "markdown",
-            "value": "Determines whether or not the input field is invalid or throws an error."
+            "value": "Determines whether or not the input is invalid."
           }
         },
         {
@@ -8854,7 +8989,7 @@
           "name": "type",
           "description": {
             "kind": "markdown",
-            "value": "Determines the type of control that will be displayed\n`'email'`, `'number'`, `'password'`, `'tel'`, `'text'`, `'url'`\n\n**Default:** `'text'`"
+            "value": "Determines the type of control that will be displayed\n`'email'`, `'number'`, `'password'`, `'search'`, `'tel'`, `'text'`, `'url'`\n\n**Default:** `'text'`"
           }
         },
         {
@@ -8876,7 +9011,7 @@
       "name": "pds-link",
       "description": {
         "kind": "markdown",
-        "value": "A hyperlink is used as a navigational element to direct users to another location on the website or application.\n\n**Examples:**\n[Default](https://pine-design-system.netlify.app/?path=/docs/components-link--docs#default), [Colors](https://pine-design-system.netlify.app/?path=/docs/components-link--docs#colors), [Plain](https://pine-design-system.netlify.app/?path=/docs/components-link--docs#plain), [External](https://pine-design-system.netlify.app/?path=/docs/components-link--docs#external), [Target](https://pine-design-system.netlify.app/?path=/docs/components-link--docs#target), [Font Size](https://pine-design-system.netlify.app/?path=/docs/components-link--docs#font-size), [Custom Slot Text](https://pine-design-system.netlify.app/?path=/docs/components-link--docs#custom-slot-text), [No Custom Slot Text](https://pine-design-system.netlify.app/?path=/docs/components-link--docs#no-custom-slot-text), [Whole-row link](https://pine-design-system.netlify.app/?path=/docs/components-link--docs#whole-row-link)\n\n**Slots:**\n- `(default)` - Text content placed between the opening and closing tags. If no text is provided, the **href** will be used as a fallback.\n\n**CSS Parts:**\n- `link` - Link element styles."
+        "value": "A hyperlink is used as a navigational element to direct users to another location on the website or application.\n\n**Examples:**\n[Default](https://pine-design-system.netlify.app/?path=/docs/components-link--docs#default), [Colors](https://pine-design-system.netlify.app/?path=/docs/components-link--docs#colors), [Plain](https://pine-design-system.netlify.app/?path=/docs/components-link--docs#plain), [Active](https://pine-design-system.netlify.app/?path=/docs/components-link--docs#active), [External](https://pine-design-system.netlify.app/?path=/docs/components-link--docs#external), [External in the same tab](https://pine-design-system.netlify.app/?path=/docs/components-link--docs#external-in-the-same-tab), [Target](https://pine-design-system.netlify.app/?path=/docs/components-link--docs#target), [Download](https://pine-design-system.netlify.app/?path=/docs/components-link--docs#download), [Font Size](https://pine-design-system.netlify.app/?path=/docs/components-link--docs#font-size), [Custom Slot Text](https://pine-design-system.netlify.app/?path=/docs/components-link--docs#custom-slot-text), [No Custom Slot Text](https://pine-design-system.netlify.app/?path=/docs/components-link--docs#no-custom-slot-text), [Whole-row link](https://pine-design-system.netlify.app/?path=/docs/components-link--docs#whole-row-link)\n\n**Slots:**\n- `(default)` - Text content placed between the opening and closing tags. If the slot is empty (whitespace counts as content), the **href** will be used as a fallback.\n\n**CSS Parts:**\n- `link` - Link element styles."
       },
       "attributes": [
         {
@@ -8911,14 +9046,14 @@
           "name": "external",
           "description": {
             "kind": "markdown",
-            "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."
+            "value": "Shows the external-link (launch) icon. Opens in a new tab unless `target` says otherwise.\n\n**Default:** `false`"
           }
         },
         {
           "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."
+            "value": "Accessible label for the icon that `external` shows, appended to the\nlink's name. It isn't announced when `target` is anything other than\n`_blank`. Pass a translated string to localize it; defaults to English. Pass an\nempty string to make the icon decorative."
           }
         },
         {
@@ -8943,14 +9078,14 @@
           "name": "href",
           "description": {
             "kind": "markdown",
-            "value": "The hyperlink's destination URL. If no text is provided in the custom slot, the href will be used."
+            "value": "The hyperlink's destination URL. If the default slot is empty (whitespace counts as content), the href will be used as the link text."
           }
         },
         {
           "name": "target",
           "description": {
             "kind": "markdown",
-            "value": "Specifies where to open the linked document.\n\n**Type:** `\"_blank\" | \"_parent\" | \"_self\" | \"_top\"`"
+            "value": "Specifies where to open the linked document. Overrides the new-tab\ndefault of `external`; the icon still shows.\n\n**Type:** `\"_blank\" | \"_parent\" | \"_self\" | \"_top\"`"
           },
           "values": [
             {
@@ -9075,7 +9210,7 @@
       "name": "pds-loader",
       "description": {
         "kind": "markdown",
-        "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."
+        "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` - Label text. Defaults to \"Loading...\". Text outside this slot isn't shown or read.\n\n**CSS Parts:**\n- `loader-svg` - Exposes the spinner SVG element for color customization."
       },
       "attributes": [
         {
@@ -9096,7 +9231,7 @@
           "name": "size",
           "description": {
             "kind": "markdown",
-            "value": "Sets the size of the spinner loader. Value can be preset or custom.\n\n**Default:** `'md'`"
+            "value": "Sets the size of the spinner loader: `xs` (24px), `sm` (32px), `md` (48px), `lg` (64px), `xl` (80px),\nor a custom CSS length such as `128px`. The `typing` variant ignores it.\n\n**Default:** `'md'`"
           }
         },
         {
@@ -9126,7 +9261,7 @@
       "name": "pds-modal",
       "description": {
         "kind": "markdown",
-        "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), [Overlays Above the Modal](https://pine-design-system.netlify.app/?path=/docs/components-modal--docs#overlays-above-the-modal)\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": "By default, modals show content in a dialog that blocks interaction with the page until it closes. Use them for confirmations, focused forms, or details that need attention without leaving the page.\n\n**Examples:**\n[Default](https://pine-design-system.netlify.app/?path=/docs/components-modal--docs#default), [Opening and Closing](https://pine-design-system.netlify.app/?path=/docs/components-modal--docs#opening-and-closing), [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), [Overlays Above the Modal](https://pine-design-system.netlify.app/?path=/docs/components-modal--docs#overlays-above-the-modal)\n\n**CSS Parts:**\n- `modal` - The panel inside the dialog that holds the modal's content. `pds-modal` has no shadow root, so `::part(modal)` doesn't match it; select it with `pds-modal [part=\"modal\"]` instead.\n\n**Events:**\n- `pdsModalClose` - Emitted when the modal is closed\n- `pdsModalOpen` - Emitted when the modal is opened"
       },
       "attributes": [
         {
@@ -9147,7 +9282,7 @@
           "name": "disable-initial-focus",
           "description": {
             "kind": "markdown",
-            "value": "Whether to skip moving focus into the modal when it opens — both our own\n`setInitialFocus()` and the browser's native \"dialog focusing steps\",\nwhich move focus into the dialog as soon as `show()`/`showModal()` is\ncalled regardless of application code. Focus return on close is\nunaffected either way. For a modal opened by something other than a\ndirect user click — a redirect, a deep link, a background event —\nstealing focus on open can interrupt whatever the user was already\ndoing. Default `false` preserves today's behavior for every existing\nconsumer.\n\n**Default:** `false`"
+            "value": "Whether to skip moving focus into the modal when it opens. Set it for a\nmodal that can open from a background event while the user is mid-task\nelsewhere on the page, where moving focus would interrupt them. Pair it\nwith `disableTopLayer`: in the top layer the rest of the page is inert, so\nfocus can't stay there. On close, focus moves back only if nothing outside\nthe modal has taken it.\n\n**Default:** `false`"
           }
         },
         {
@@ -9240,7 +9375,7 @@
       "name": "pds-modal-footer",
       "description": {
         "kind": "markdown",
-        "value": ""
+        "value": "Holds the modal's actions. It adds no padding or layout, so wrap its content in a `pds-box` with `padding=\"md\"`."
       },
       "attributes": [],
       "references": [
@@ -9254,7 +9389,7 @@
       "name": "pds-modal-header",
       "description": {
         "kind": "markdown",
-        "value": ""
+        "value": "Holds the modal's title and close control. It adds no padding or layout, so wrap its content in a `pds-box` with `padding=\"md\"`."
       },
       "attributes": [],
       "references": [
@@ -9268,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 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- `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 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)."
       },
       "attributes": [
         {
@@ -9643,7 +9778,7 @@
       "name": "pds-popover",
       "description": {
         "kind": "markdown",
-        "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"
+        "value": "Popovers show contextual content, including interactive elements, from a trigger. Use a tooltip for short, non-interactive text.\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": [
         {
@@ -9657,7 +9792,7 @@
           "name": "max-width",
           "description": {
             "kind": "markdown",
-            "value": "Sets the maximum width of the popover content\n\n**Type:** `number`\n\n**Default:** `352`"
+            "value": "Sets the maximum width of the popover, in pixels, including its padding.\n\n**Type:** `number`\n\n**Default:** `400`"
           }
         },
         {
@@ -9821,7 +9956,7 @@
           "name": "percent",
           "description": {
             "kind": "markdown",
-            "value": "Sets the progress fill pecentage and visually displayed when `show-percentage=true`.\n\n**Type:** `number`\n\n**Default:** `0`"
+            "value": "Sets the progress fill percentage (0–100). Shown as text when `show-percent` is set.\n\n**Type:** `number`\n\n**Default:** `0`"
           }
         },
         {
@@ -9843,7 +9978,7 @@
       "name": "pds-property",
       "description": {
         "kind": "markdown",
-        "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."
+        "value": "Properties pair an icon with a short text value to present metadata, 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": [
         {
@@ -9872,14 +10007,14 @@
       "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), [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."
+        "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` - Emitted with `true` when the user checks the radio, by a click or an arrow key. The radio is `event.target`, so read its `value` there.\nNot emitted when picking another radio unchecks this one. Not emitted inside `pds-radio-group` either; listen for `pdsRadioGroupChange` there."
       },
       "attributes": [
         {
           "name": "checked",
           "description": {
             "kind": "markdown",
-            "value": "Determines whether or not the radio is checked.\n\n**Default:** `false`"
+            "value": "Determines whether or not the radio is checked. It keeps the value you set and doesn't change when the user picks a radio.\n\n**Default:** `false`"
           }
         },
         {
@@ -9900,7 +10035,7 @@
           "name": "error-message",
           "description": {
             "kind": "markdown",
-            "value": "Displays error message text describing an invalid state."
+            "value": "Displays an error message below the radio. It becomes the radio's accessible description only while `invalid` is set."
           }
         },
         {
@@ -9914,7 +10049,7 @@
           "name": "helper-message",
           "description": {
             "kind": "markdown",
-            "value": "Displays helper message text below radio."
+            "value": "Displays a message or hint below the radio."
           }
         },
         {
@@ -9935,7 +10070,7 @@
           "name": "label",
           "description": {
             "kind": "markdown",
-            "value": "String used for label text next to radio."
+            "value": "Text to be displayed as the radio label."
           }
         },
         {
@@ -9986,7 +10121,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), [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."
+        "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` - Emitted when the user checks a radio in the group, by a click or an arrow key. `detail` has that radio's `value`\nand `componentId`, and `checked`, which is always `true`."
       },
       "attributes": [
         {
@@ -10022,7 +10157,7 @@
           "name": "error-message",
           "description": {
             "kind": "markdown",
-            "value": "Displays error message text describing an invalid state for the entire group."
+            "value": "Displays an error message below the radio group. It's part of the group's accessible description, with or without `invalid`."
           }
         },
         {
@@ -10036,14 +10171,14 @@
           "name": "group-label",
           "description": {
             "kind": "markdown",
-            "value": "String used for group label/heading."
+            "value": "Text to be displayed as the radio group label. It also names the group, unless you set `aria-label` or `aria-labelledby` on it."
           }
         },
         {
           "name": "helper-message",
           "description": {
             "kind": "markdown",
-            "value": "Displays helper message text below the radio group."
+            "value": "Displays a message or hint below the radio group."
           }
         },
         {
@@ -10431,7 +10566,7 @@
       "name": "pds-select",
       "description": {
         "kind": "markdown",
-        "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."
+        "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- `(default)` - The `option` and `optgroup` elements to choose from. Other elements are ignored.\n- `action` - Content to be displayed in the label area, typically for help icons or links\n\n**CSS Parts:**\n- `action` - Exposes the wrapper around the `action` slot for styling. Appears only when the `action` slot has content.\n- `select` - Exposes the native `select` element for styling.\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 user changes the selection. `detail` is the native `change` event, so read the new value\nfrom the select's `value`: a string, or an array with `multiple`.\n\nThis event will not emit when programmatically setting the `value` property."
       },
       "attributes": [
         {
@@ -10459,14 +10594,14 @@
           "name": "error-message",
           "description": {
             "kind": "markdown",
-            "value": "Displays error message text describing an invalid state."
+            "value": "Displays an error message below the select and marks the select as invalid, with or without `invalid`."
           }
         },
         {
           "name": "helper-message",
           "description": {
             "kind": "markdown",
-            "value": "Displays helper message text below select."
+            "value": "Displays a message or hint below the select."
           }
         },
         {
@@ -10537,7 +10672,7 @@
       "name": "pds-sortable",
       "description": {
         "kind": "markdown",
-        "value": "Sortable is for creating containers of items that can be sorted via drag and drop functionality.\n\n**Examples:**\n[Default](https://pine-design-system.netlify.app/?path=/docs/components-sortable--docs#default), [Bordered](https://pine-design-system.netlify.app/?path=/docs/components-sortable--docs#bordered), [Dividers](https://pine-design-system.netlify.app/?path=/docs/components-sortable--docs#dividers), [Disabled](https://pine-design-system.netlify.app/?path=/docs/components-sortable--docs#disabled), [Handle](https://pine-design-system.netlify.app/?path=/docs/components-sortable--docs#handle), [Handle vs. Row `handle-type`](https://pine-design-system.netlify.app/?path=/docs/components-sortable--docs#handle-vs.-row-`handle-type`), [Actions](https://pine-design-system.netlify.app/?path=/docs/components-sortable--docs#actions), [Demo](https://pine-design-system.netlify.app/?path=/docs/components-sortable--docs#demo)\n\n**Events:**\n- `pdsSortableItemMoved` - Event emitted when a sortable item is moved."
+        "value": "Sortable is for creating containers of items that can be sorted by dragging or from the keyboard.\n\n**Examples:**\n[Default](https://pine-design-system.netlify.app/?path=/docs/components-sortable--docs#default), [Bordered](https://pine-design-system.netlify.app/?path=/docs/components-sortable--docs#bordered), [Dividers](https://pine-design-system.netlify.app/?path=/docs/components-sortable--docs#dividers), [Disabled](https://pine-design-system.netlify.app/?path=/docs/components-sortable--docs#disabled), [Handle](https://pine-design-system.netlify.app/?path=/docs/components-sortable--docs#handle), [Handle vs. Row `handle-type`](https://pine-design-system.netlify.app/?path=/docs/components-sortable--docs#handle-vs.-row-`handle-type`), [Actions](https://pine-design-system.netlify.app/?path=/docs/components-sortable--docs#actions), [Localized](https://pine-design-system.netlify.app/?path=/docs/components-sortable--docs#localized), [Demo](https://pine-design-system.netlify.app/?path=/docs/components-sortable--docs#demo)\n\n**Events:**\n- `pdsSortableItemMoved` - Event emitted when a sortable item is moved, by dragging or from the keyboard. A keyboard move\ncarries the same fields as a drag (`item`, `from`, `to`, `oldIndex`, `newIndex`,\n`oldDraggableIndex`, `newDraggableIndex`), with the event that ended the move as\n`originalEvent` -- a `KeyboardEvent` for Space or Enter, but a `FocusEvent`, `PointerEvent` or\n`MouseEvent` when the drop instead comes from focus leaving the row, a drag taking over, or a\nscreen reader's browse-mode click."
       },
       "attributes": [
         {
@@ -10568,6 +10703,13 @@
             "value": "Determines whether `sortable` items should be divided with border.\n\n**Default:** `false`"
           }
         },
+        {
+          "name": "handle-label",
+          "description": {
+            "kind": "markdown",
+            "value": "Accessible label for each item's reorder handle, the button the keyboard reorders with. Pass a translated string to localize it; `{item}` is interpolated.\n\n**Default:** `'Reorder {item}'`"
+          }
+        },
         {
           "name": "handle-type",
           "description": {
@@ -10582,6 +10724,34 @@
               "name": "row"
             }
           ]
+        },
+        {
+          "name": "item-dropped-label",
+          "description": {
+            "kind": "markdown",
+            "value": "Screen-reader announcement when a picked-up item is dropped. Pass a translated string to localize it; `{item}`, `{position}` and `{total}` are interpolated.\n\n**Default:** `'{item}, dropped at position {position} of {total}'`"
+          }
+        },
+        {
+          "name": "item-moved-label",
+          "description": {
+            "kind": "markdown",
+            "value": "Screen-reader announcement when a picked-up item is moved. Pass a translated string to localize it; `{item}`, `{position}` and `{total}` are interpolated.\n\n**Default:** `'{item}, moved to position {position} of {total}'`"
+          }
+        },
+        {
+          "name": "item-picked-up-label",
+          "description": {
+            "kind": "markdown",
+            "value": "Screen-reader announcement when an item is picked up from the keyboard. Pass a translated string to localize it; `{item}`, `{position}` and `{total}` are interpolated.\n\n**Default:** `'{item}, picked up. Position {position} of {total}. Press the arrow keys to move, Space or Enter to drop, Escape to cancel.'`"
+          }
+        },
+        {
+          "name": "reorder-canceled-label",
+          "description": {
+            "kind": "markdown",
+            "value": "Screen-reader announcement when a keyboard reorder is canceled and the item goes back. Pass a translated string to localize it; `{item}`, `{position}` and `{total}` are interpolated.\n\n**Default:** `'Reorder canceled. {item} returned to position {position} of {total}'`"
+          }
         }
       ],
       "references": [
@@ -10595,7 +10765,7 @@
       "name": "pds-sortable-item",
       "description": {
         "kind": "markdown",
-        "value": "\n\n**Slots:**\n- `sortable-item-actions` - Content is placed within the `pds-sortable-item__actions` element as children. This slot is only rendered if `actions` is set to `true`."
+        "value": "\n\n**Slots:**\n- `sortable-item-actions` - Content is placed within the `pds-sortable-item__actions` element as children. This slot is only rendered when `enable-actions` is set."
       },
       "attributes": [
         {
@@ -10612,11 +10782,18 @@
             "value": "Determines whether `sortable-item-actions` slot should be enabled.\n\n**Default:** `false`"
           }
         },
+        {
+          "name": "item-label",
+          "description": {
+            "kind": "markdown",
+            "value": "Name of the item in its reorder handle's label and in the reorder announcements. Pass a translated string to localize it; defaults to the item's text content."
+          }
+        },
         {
           "name": "show-handle",
           "description": {
             "kind": "markdown",
-            "value": "Determines whether `sortable-item` should have a handle.\n\n**Default:** `false`"
+            "value": "Determines whether the reorder handle is shown. The handle itself renders whenever the list\nis reorderable, regardless of this prop; without it, the handle is visually hidden but still\nreachable from the keyboard.\n\n**Default:** `false`"
           }
         }
       ],
@@ -10631,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), [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)\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` - Emits an event on input change."
       },
       "attributes": [
         {
@@ -10694,7 +10871,7 @@
           "name": "name",
           "description": {
             "kind": "markdown",
-            "value": "Identifies form data and unifies a group of radio inputs for toggling a single property/value."
+            "value": "Specifies the name. Submitted with the form name/value pair when checked, or with `unchecked-value` while unchecked."
           }
         },
         {
@@ -10704,6 +10881,13 @@
             "value": "Determines the 'required' state of the input.\n\n**Default:** `false`"
           }
         },
+        {
+          "name": "unchecked-value",
+          "description": {
+            "kind": "markdown",
+            "value": "Provides a string submitted in form data under `name` while the switch is unchecked.\nWhen unset, an unchecked switch submits nothing, like a native checkbox."
+          }
+        },
         {
           "name": "value",
           "description": {
@@ -10723,7 +10907,7 @@
       "name": "pds-tab",
       "description": {
         "kind": "markdown",
-        "value": ""
+        "value": "A tab inside `pds-tabs`. In panel mode, its `name` matches the `pds-tabpanel` it shows. In navigation mode (`nav` set on `pds-tabs`), it renders a link to its `href` instead."
       },
       "attributes": [
         {
@@ -10809,7 +10993,7 @@
       "name": "pds-table",
       "description": {
         "kind": "markdown",
-        "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."
+        "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), [Column Widths](https://pine-design-system.netlify.app/?path=/docs/components-table--docs#column-widths), [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` - Exposes the horizontal scroll container for styling. Appears only when `responsive` is set.\n- `responsive-table` - Set on the `pds-table` element itself when `responsive` is set, so `::part(responsive-table)` matches it only from a shadow root that contains it. Style `pds-table` directly instead.\n- `responsive-wrapper` - Exposes the wrapper inside the scroll container for styling. Appears only when `responsive` is set.\n- `scroll-shadow-left` - Exposes the scroll shadow at the inline-start edge for styling. Appears only when `responsive` is set.\n- `scroll-shadow-right` - Exposes the scroll shadow at the inline-end edge for styling. Appears only when `responsive` is set.\n- `table` - Set on the `pds-table` element itself, so `::part(table)` matches it only from a shadow root that contains it. Style `pds-table` directly instead.\n- `table-inner` - Exposes the inner table element around the slotted head and body for styling. Appears only when `responsive` is set.\n\n**Events:**\n- `pdsTableSelectAll` - Event that is emitted by `pds-table-head` when the select all checkbox is clicked, carrying the selected value.\nIt bubbles through the table; the table doesn't emit it itself."
       },
       "attributes": [
         {
@@ -10859,7 +11043,7 @@
           "name": "fixed-column",
           "description": {
             "kind": "markdown",
-            "value": "Determines if the should display a fixed first column."
+            "value": "Determines if the table displays a fixed first column."
           }
         },
         {
@@ -10882,6 +11066,21 @@
             "kind": "markdown",
             "value": "Determines if the table displays checkboxes for selectable rows."
           }
+        },
+        {
+          "name": "table-layout",
+          "description": {
+            "kind": "markdown",
+            "value": "Sets how the table sizes its columns. With `auto`, each column is sized from its content,\nso columns can change width when the rows change (for example after a sort). With `fixed`,\ncolumns take the `width` set on their `pds-table-head-cell` and ignore their content;\ncolumns without a `width` share the remaining space. Under `responsive`, that remaining\nshare keeps a 120px floor on narrow viewports where the other columns' widths already fill\nit, growing the table instead (scrollable) -- without `responsive` there's no floor, since\nthere would be nothing to scroll the overflow it would create. Content longer than its\ncolumn overflows, so add `truncate` to cells whose content may not fit.\n\n**Type:** `\"auto\" | \"fixed\"`\n\n**Default:** `'auto'`"
+          },
+          "values": [
+            {
+              "name": "auto"
+            },
+            {
+              "name": "fixed"
+            }
+          ]
         }
       ],
       "references": [
@@ -10895,7 +11094,7 @@
       "name": "pds-table-body",
       "description": {
         "kind": "markdown",
-        "value": "\n\n**CSS Parts:**\n- `body` - No description"
+        "value": "\n\n**CSS Parts:**\n- `body` - Set on the `pds-table-body` element itself, so `::part(body)` matches it only from a shadow root that contains it. Style `pds-table-body` directly instead."
       },
       "attributes": [],
       "references": [
@@ -10909,7 +11108,7 @@
       "name": "pds-table-cell",
       "description": {
         "kind": "markdown",
-        "value": "\n\n**CSS Parts:**\n- `cell` - No description"
+        "value": "\n\n**CSS Parts:**\n- `cell` - Set on the `pds-table-cell` element itself, so `::part(cell)` matches it only from a shadow root that contains it. Style `pds-table-cell` directly instead. In a `selectable` table, each row's selection cell sits in the row's shadow root: it has the `checkbox-cell` part when first rendered and `cell` after any re-render, so target both with `pds-table-row::part(checkbox-cell), pds-table-row::part(cell)`."
       },
       "attributes": [
         {
@@ -10952,7 +11151,7 @@
       "name": "pds-table-head",
       "description": {
         "kind": "markdown",
-        "value": "\n\n**CSS Parts:**\n- `head` - No description\n- `select-all-checkbox` - No description\n\n**Events:**\n- `pdsTableSelectAll` - Event that is emitted when the select all checkbox is clicked, carrying the selected value."
+        "value": "\n\n**CSS Parts:**\n- `head` - Set on the `pds-table-head` element itself, so `::part(head)` matches it only from a shadow root that contains it. Style `pds-table-head` directly instead.\n- `select-all-checkbox` - Exposes the select-all checkbox for styling. Appears only when the table is `selectable` and `disableSelectAll` isn't set.\n\n**Events:**\n- `pdsTableSelectAll` - Event that is emitted when the select all checkbox is clicked, carrying the selected value."
       },
       "attributes": [
         {
@@ -10980,7 +11179,7 @@
           "name": "is-selected",
           "description": {
             "kind": "markdown",
-            "value": "Determines if the table row is currently selected."
+            "value": "Determines if the select all checkbox is checked."
           }
         }
       ],
@@ -10995,7 +11194,7 @@
       "name": "pds-table-head-cell",
       "description": {
         "kind": "markdown",
-        "value": "\n\n**CSS Parts:**\n- `head-cell` - No description\n- `sort-icon` - No description\n\n**Events:**\n- `pdsTableSort` - Event emitted to signal that a table column header has been sorted, providing information about the sorted column's name and sorting direction."
+        "value": "\n\n**CSS Parts:**\n- `head-cell` - Set on the `pds-table-head-cell` element itself, so `::part(head-cell)` matches it only from a shadow root that contains it. Style `pds-table-head-cell` directly instead. In a `selectable` table, the select-all cell sits in `pds-table-head`'s shadow root: it has the `checkbox-cell` part when first rendered and `head-cell` after any re-render, so target both with `pds-table-head::part(checkbox-cell), pds-table-head::part(head-cell)`.\n- `sort-icon` - Exposes the sort direction icon for styling. Appears only on a `sortable` column while it's the active sort.\n\n**Events:**\n- `pdsTableSort` - Event emitted to signal that a table column header has been sorted, providing information about the sorted column's name and sorting direction."
       },
       "attributes": [
         {
@@ -11025,6 +11224,13 @@
             "kind": "markdown",
             "value": "Determines whether the table column is sortable when set to `true`."
           }
+        },
+        {
+          "name": "width",
+          "description": {
+            "kind": "markdown",
+            "value": "Sets the width of the column. Accepts any CSS length (e.g. '148px', '12rem', '20%').\nWhen the table's `tableLayout` is `fixed`, the column keeps this width whatever its content.\nOtherwise the column is at least this wide and can grow to fit its content."
+          }
         }
       ],
       "references": [
@@ -11038,7 +11244,7 @@
       "name": "pds-table-row",
       "description": {
         "kind": "markdown",
-        "value": "\n\n**CSS Parts:**\n- `row` - No description\n- `row-checkbox` - No description\n\n**Events:**\n- `pdsTableRowSelected` - Event that is emitted when the checkbox is clicked, carrying the selected value."
+        "value": "\n\n**CSS Parts:**\n- `row` - Set on the `pds-table-row` element itself, so `::part(row)` matches it only from a shadow root that contains it. Style `pds-table-row` directly instead.\n- `row-checkbox` - Exposes the row's selection checkbox for styling. Appears only when the table is `selectable`.\n\n**Events:**\n- `pdsTableRowSelected` - Event that is emitted when the checkbox is clicked, carrying the selected value."
       },
       "attributes": [
         {
@@ -11067,7 +11273,7 @@
       "name": "pds-tabpanel",
       "description": {
         "kind": "markdown",
-        "value": ""
+        "value": "The content for one tab inside `pds-tabs` in panel mode, shown when the `pds-tab` with the same `name` is active."
       },
       "attributes": [
         {
@@ -11089,7 +11295,7 @@
       "name": "pds-tabs",
       "description": {
         "kind": "markdown",
-        "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), [Divider](https://pine-design-system.netlify.app/?path=/docs/components-tabs--docs#divider), [Stretch](https://pine-design-system.netlify.app/?path=/docs/components-tabs--docs#stretch)\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[Variants](https://pine-design-system.netlify.app/?path=/docs/components-tabs--docs#variants), [Disabled](https://pine-design-system.netlify.app/?path=/docs/components-tabs--docs#disabled), [Divider](https://pine-design-system.netlify.app/?path=/docs/components-tabs--docs#divider), [Stretch](https://pine-design-system.netlify.app/?path=/docs/components-tabs--docs#stretch)\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": [
         {
@@ -11124,7 +11330,7 @@
           "name": "stretch",
           "description": {
             "kind": "markdown",
-            "value": "Stretches the component so the active tab panel fills the remaining height.\nRequires the component to have a constrained height (e.g. a flex parent).\n\n**Default:** `false`"
+            "value": "Stretches the component to fill its container's height. The active tab panel keeps the height of its content.\nRequires the component to have a constrained height (e.g. a flex parent).\n\n**Default:** `false`"
           }
         },
         {
@@ -11389,7 +11595,7 @@
       "name": "pds-textarea",
       "description": {
         "kind": "markdown",
-        "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."
+        "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` - Exposes the wrapper around the `action` slot for styling. Appears only when the `action` slot has content.\n\n**Events:**\n- `pdsBlur` - Emitted when the textarea loses focus.\n- `pdsFocus` - Emitted when the textarea has focus.\n- `pdsInput` - Emitted after each `input` event, such as typing or pasting. With `debounce`, it waits until that many milliseconds have passed since the last one.\n`detail` has `value`, the current text, and `event`, the native `input` event.\n\nThis event will not emit when programmatically setting the `value` property.\n- `pdsKeyDown` - Emitted when a key is pressed down in the textarea.\n- `pdsTextareaChange` - Emitted when the user changes the value and then leaves the textarea. `Enter` adds a new line, so it doesn't emit this event.\n`detail` has `value`, the text, and `event`, the native event behind it, usually `change`.\n\nThis event will not emit when programmatically setting the `value` property, unless the field has focus at the time;\nthen it emits when the field loses focus."
       },
       "attributes": [
         {
@@ -11417,7 +11623,7 @@
           "name": "debounce",
           "description": {
             "kind": "markdown",
-            "value": "The amount of time, in milliseconds, to wait to trigger the event after each keystroke.\n\n**Type:** `number`"
+            "value": "Sets the number of milliseconds to wait after each input event before emitting `pdsInput`.\n\n**Type:** `number`"
           }
         },
         {
@@ -11431,7 +11637,7 @@
           "name": "error-message",
           "description": {
             "kind": "markdown",
-            "value": "Displays an error message below the textarea field."
+            "value": "Displays an error message below the textarea while `invalid` is set."
           }
         },
         {
@@ -11459,7 +11665,7 @@
           "name": "invalid",
           "description": {
             "kind": "markdown",
-            "value": "Determines whether or not the textarea is invalid or throws an error.\n\n**Default:** `false`"
+            "value": "Determines whether or not the textarea is invalid. When `required` is set, the textarea sets it\nitself each time `pdsTextareaChange` fires, replacing a value you set.\n\n**Default:** `false`"
           }
         },
         {
@@ -11480,7 +11686,7 @@
           "name": "name",
           "description": {
             "kind": "markdown",
-            "value": "Specifies the name. Submitted with the form name/value pair. This value will mirror the componentId.\n\n**Default:** `this.componentId`"
+            "value": "Specifies the name. Submitted with the form name/value pair.\n\n**Default:** `this.componentId`"
           }
         },
         {
@@ -11530,7 +11736,7 @@
       "name": "pds-toast",
       "description": {
         "kind": "markdown",
-        "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."
+        "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` - Exposes the dismiss button for styling. Appears unless `dismissible` is `false`.\n\n**Events:**\n- `pdsToastDismissed` - Event emitted when the toast is dismissed, either manually or automatically."
       },
       "attributes": [
         {