@pine-ds/core 4.11.0 → 4.12.0

package/dist/docs.json

@@ -1,5 +1,5 @@
 {
-  "timestamp": "2026-11-09T22:28:16",
+  "timestamp": "2026-11-13T13:33:46",
   "compiler": {
     "name": "@stencil/core",
     "version": "4.43.5",
@@ -421,13 +421,17 @@
       "readme": "# pds-alert\n\n\n",
       "docs": "",
       "docsTags": [
+        {
+          "name": "slot",
+          "text": "(default) - The alert's description text."
+        },
         {
           "name": "slot",
           "text": "actions - Slot for alert actions."
         },
         {
           "name": "part",
-          "text": "dismiss"
+          "text": "dismiss - Exposes the dismiss button for styling. Appears only when `dismissible` is set."
         }
       ],
       "usage": {},
@@ -689,6 +693,10 @@
       "listeners": [],
       "styles": [],
       "slots": [
+        {
+          "name": "(default)",
+          "docs": "The alert's description text."
+        },
         {
           "name": "actions",
           "docs": "Slot for alert actions."
@@ -697,7 +705,7 @@
       "parts": [
         {
           "name": "dismiss",
-          "docs": ""
+          "docs": "Exposes the dismiss button for styling. Appears only when `dismissible` is set."
         }
       ],
       "states": [],
@@ -724,19 +732,19 @@
       "docsTags": [
         {
           "name": "part",
-          "text": "asset-wrapper"
+          "text": "asset-wrapper - Exposes the sized wrapper around the avatar's image, initials or icon, badge and status dot for styling."
         },
         {
           "name": "part",
-          "text": "button"
+          "text": "button - Exposes the dropdown trigger button for styling. Appears only when `dropdown` is set."
         },
         {
           "name": "part",
-          "text": "image - The main image element that represents the avatar component."
+          "text": "initials - The text element that renders the avatar's initials, for restyling their color."
         },
         {
           "name": "part",
-          "text": "initials - The text element that renders the avatar's initials, for restyling their color."
+          "text": "status - Exposes the status dot for styling, such as a custom color. Appears only when `status` is set."
         }
       ],
       "usage": {},
@@ -948,7 +956,7 @@
           "mutable": true,
           "attr": "size",
           "reflectToAttr": true,
-          "docs": "Size of the avatar. Value can be preset or custom.",
+          "docs": "Sets the size of the avatar: `xs` (24px), `sm` (32px), `md` (40px), `lg` (56px), `xl` (64px),\nor a custom CSS length such as `128px`.",
           "docsTags": [
             {
               "name": "defaultValue",
@@ -1133,15 +1141,11 @@
       "parts": [
         {
           "name": "asset-wrapper",
-          "docs": ""
+          "docs": "Exposes the sized wrapper around the avatar's image, initials or icon, badge and status dot for styling."
         },
         {
           "name": "button",
-          "docs": ""
-        },
-        {
-          "name": "image",
-          "docs": "The main image element that represents the avatar component."
+          "docs": "Exposes the dropdown trigger button for styling. Appears only when `dropdown` is set."
         },
         {
           "name": "initials",
@@ -1149,7 +1153,7 @@
         },
         {
           "name": "status",
-          "docs": ""
+          "docs": "Exposes the status dot for styling, such as a custom color. Appears only when `status` is set."
         }
       ],
       "states": [],
@@ -2046,6 +2050,41 @@
           "getter": false,
           "setter": false
         },
+        {
+          "name": "container",
+          "type": "\"inline-size\" | \"size\"",
+          "complexType": {
+            "original": "BoxContainerType",
+            "resolved": "\"inline-size\" | \"size\"",
+            "references": {
+              "BoxContainerType": {
+                "location": "import",
+                "path": "../../utils/types",
+                "id": "src/utils/types.ts::BoxContainerType",
+                "referenceLocation": "BoxContainerType"
+              }
+            }
+          },
+          "mutable": false,
+          "attr": "container",
+          "reflectToAttr": false,
+          "docs": "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.",
+          "docsTags": [],
+          "values": [
+            {
+              "value": "inline-size",
+              "type": "string"
+            },
+            {
+              "value": "size",
+              "type": "string"
+            }
+          ],
+          "optional": true,
+          "required": false,
+          "getter": false,
+          "setter": false
+        },
         {
           "name": "direction",
           "type": "\"column\" | \"row\"",
@@ -2131,7 +2170,7 @@
           "mutable": false,
           "attr": "fit",
           "reflectToAttr": false,
-          "docs": "If `true`, sets the box `max-width` to `100%`.",
+          "docs": "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.",
           "docsTags": [],
           "values": [
             {
@@ -2154,7 +2193,7 @@
           "mutable": false,
           "attr": "fit-lg",
           "reflectToAttr": false,
-          "docs": "If `true`, sets the box `max-width` to `100%` at the LG breakpoint.",
+          "docs": "If `true`, sets the box `width`, `min-width` and `max-width` to `100%` at the LG breakpoint.",
           "docsTags": [],
           "values": [
             {
@@ -2177,7 +2216,7 @@
           "mutable": false,
           "attr": "fit-md",
           "reflectToAttr": false,
-          "docs": "If `true`, sets the box `max-width` to `100%` at the MD breakpoint.",
+          "docs": "If `true`, sets the box `width`, `min-width` and `max-width` to `100%` at the MD breakpoint.",
           "docsTags": [],
           "values": [
             {
@@ -2200,7 +2239,7 @@
           "mutable": false,
           "attr": "fit-sm",
           "reflectToAttr": false,
-          "docs": "If `true`, sets the box `max-width` to `100%` at the SM breakpoint.",
+          "docs": "If `true`, sets the box `width`, `min-width` and `max-width` to `100%` at the SM breakpoint.",
           "docsTags": [],
           "values": [
             {
@@ -2223,7 +2262,7 @@
           "mutable": false,
           "attr": "fit-xl",
           "reflectToAttr": false,
-          "docs": "If `true`, sets the box `max-width` to `100%` at the XL breakpoint.",
+          "docs": "If `true`, sets the box `width`, `min-width` and `max-width` to `100%` at the XL breakpoint.",
           "docsTags": [],
           "values": [
             {
@@ -2246,7 +2285,7 @@
           "mutable": false,
           "attr": "fit-xs",
           "reflectToAttr": false,
-          "docs": "If `true`, sets the box `max-width` to `100%` at the XS breakpoint.",
+          "docs": "If `true`, sets the box `width`, `min-width` and `max-width` to `100%` at the XS breakpoint.",
           "docsTags": [],
           "values": [
             {
@@ -2269,13 +2308,8 @@
           "mutable": false,
           "attr": "flex",
           "reflectToAttr": false,
-          "docs": "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').",
-          "docsTags": [
-            {
-              "name": "defaultValue",
-              "text": "none"
-            }
-          ],
+          "docs": "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`).",
+          "docsTags": [],
           "values": [
             {
               "type": "string"
@@ -3398,23 +3432,23 @@
         },
         {
           "name": "marginBlockEnd",
-          "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\"",
+          "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\"",
           "complexType": {
-            "original": "BoxSpacingType",
-            "resolved": "\"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\"",
+            "original": "BoxMarginType",
+            "resolved": "\"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\"",
             "references": {
-              "BoxSpacingType": {
+              "BoxMarginType": {
                 "location": "import",
                 "path": "../../utils/types",
-                "id": "src/utils/types.ts::BoxSpacingType",
-                "referenceLocation": "BoxSpacingType"
+                "id": "src/utils/types.ts::BoxMarginType",
+                "referenceLocation": "BoxMarginType"
               }
             }
           },
           "mutable": false,
           "attr": "margin-block-end",
           "reflectToAttr": false,
-          "docs": "Defines the box's outer bottom spacing.",
+          "docs": "Defines the box's outer bottom spacing. Accepts a spacing token or `auto`.",
           "docsTags": [
             {
               "name": "defaultValue",
@@ -3494,6 +3528,10 @@
               "value": "800",
               "type": "string"
             },
+            {
+              "value": "auto",
+              "type": "string"
+            },
             {
               "value": "lg",
               "type": "string"
@@ -3534,23 +3572,23 @@
         },
         {
           "name": "marginBlockEndLg",
-          "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\"",
+          "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\"",
           "complexType": {
-            "original": "BoxSpacingType",
-            "resolved": "\"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\"",
+            "original": "BoxMarginType",
+            "resolved": "\"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\"",
             "references": {
-              "BoxSpacingType": {
+              "BoxMarginType": {
                 "location": "import",
                 "path": "../../utils/types",
-                "id": "src/utils/types.ts::BoxSpacingType",
-                "referenceLocation": "BoxSpacingType"
+                "id": "src/utils/types.ts::BoxMarginType",
+                "referenceLocation": "BoxMarginType"
               }
             }
           },
           "mutable": false,
           "attr": "margin-block-end-lg",
           "reflectToAttr": false,
-          "docs": "Defines the box's outer bottom spacing at the LG breakpoint.",
+          "docs": "Defines the box's outer bottom spacing at the LG breakpoint. Accepts a spacing token or `auto`.",
           "docsTags": [
             {
               "name": "defaultValue",
@@ -3630,6 +3668,10 @@
               "value": "800",
               "type": "string"
             },
+            {
+              "value": "auto",
+              "type": "string"
+            },
             {
               "value": "lg",
               "type": "string"
@@ -3670,23 +3712,23 @@
         },
         {
           "name": "marginBlockEndMd",
-          "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\"",
+          "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\"",
           "complexType": {
-            "original": "BoxSpacingType",
-            "resolved": "\"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\"",
+            "original": "BoxMarginType",
+            "resolved": "\"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\"",
             "references": {
-              "BoxSpacingType": {
+              "BoxMarginType": {
                 "location": "import",
                 "path": "../../utils/types",
-                "id": "src/utils/types.ts::BoxSpacingType",
-                "referenceLocation": "BoxSpacingType"
+                "id": "src/utils/types.ts::BoxMarginType",
+                "referenceLocation": "BoxMarginType"
               }
             }
           },
           "mutable": false,
           "attr": "margin-block-end-md",
           "reflectToAttr": false,
-          "docs": "Defines the box's outer bottom spacing at the MD breakpoint.",
+          "docs": "Defines the box's outer bottom spacing at the MD breakpoint. Accepts a spacing token or `auto`.",
           "docsTags": [
             {
               "name": "defaultValue",
@@ -3766,6 +3808,10 @@
               "value": "800",
               "type": "string"
             },
+            {
+              "value": "auto",
+              "type": "string"
+            },
             {
               "value": "lg",
               "type": "string"
@@ -3806,23 +3852,23 @@
         },
         {
           "name": "marginBlockEndSm",
-          "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\"",
+          "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\"",
           "complexType": {
-            "original": "BoxSpacingType",
-            "resolved": "\"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\"",
+            "original": "BoxMarginType",
+            "resolved": "\"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\"",
             "references": {
-              "BoxSpacingType": {
+              "BoxMarginType": {
                 "location": "import",
                 "path": "../../utils/types",
-                "id": "src/utils/types.ts::BoxSpacingType",
-                "referenceLocation": "BoxSpacingType"
+                "id": "src/utils/types.ts::BoxMarginType",
+                "referenceLocation": "BoxMarginType"
               }
             }
           },
           "mutable": false,
           "attr": "margin-block-end-sm",
           "reflectToAttr": false,
-          "docs": "Defines the box's outer bottom spacing at the SM breakpoint.",
+          "docs": "Defines the box's outer bottom spacing at the SM breakpoint. Accepts a spacing token or `auto`.",
           "docsTags": [
             {
               "name": "defaultValue",
@@ -3902,6 +3948,10 @@
               "value": "800",
               "type": "string"
             },
+            {
+              "value": "auto",
+              "type": "string"
+            },
             {
               "value": "lg",
               "type": "string"
@@ -3942,23 +3992,23 @@
         },
         {
           "name": "marginBlockEndXl",
-          "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\"",
+          "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\"",
           "complexType": {
-            "original": "BoxSpacingType",
-            "resolved": "\"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\"",
+            "original": "BoxMarginType",
+            "resolved": "\"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\"",
             "references": {
-              "BoxSpacingType": {
+              "BoxMarginType": {
                 "location": "import",
                 "path": "../../utils/types",
-                "id": "src/utils/types.ts::BoxSpacingType",
-                "referenceLocation": "BoxSpacingType"
+                "id": "src/utils/types.ts::BoxMarginType",
+                "referenceLocation": "BoxMarginType"
               }
             }
           },
           "mutable": false,
           "attr": "margin-block-end-xl",
           "reflectToAttr": false,
-          "docs": "Defines the box's outer bottom spacing at the XL breakpoint.",
+          "docs": "Defines the box's outer bottom spacing at the XL breakpoint. Accepts a spacing token or `auto`.",
           "docsTags": [
             {
               "name": "defaultValue",
@@ -4038,6 +4088,10 @@
               "value": "800",
               "type": "string"
             },
+            {
+              "value": "auto",
+              "type": "string"
+            },
             {
               "value": "lg",
               "type": "string"
@@ -4078,23 +4132,23 @@
         },
         {
           "name": "marginBlockEndXs",
-          "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\"",
+          "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\"",
           "complexType": {
-            "original": "BoxSpacingType",
-            "resolved": "\"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\"",
+            "original": "BoxMarginType",
+            "resolved": "\"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\"",
             "references": {
-              "BoxSpacingType": {
+              "BoxMarginType": {
                 "location": "import",
                 "path": "../../utils/types",
-                "id": "src/utils/types.ts::BoxSpacingType",
-                "referenceLocation": "BoxSpacingType"
+                "id": "src/utils/types.ts::BoxMarginType",
+                "referenceLocation": "BoxMarginType"
               }
             }
           },
           "mutable": false,
           "attr": "margin-block-end-xs",
           "reflectToAttr": false,
-          "docs": "Defines the box's outer bottom spacing at the XS breakpoint.",
+          "docs": "Defines the box's outer bottom spacing at the XS breakpoint. Accepts a spacing token or `auto`.",
           "docsTags": [
             {
               "name": "defaultValue",
@@ -4174,6 +4228,10 @@
               "value": "800",
               "type": "string"
             },
+            {
+              "value": "auto",
+              "type": "string"
+            },
             {
               "value": "lg",
               "type": "string"
@@ -4214,23 +4272,23 @@
         },
         {
           "name": "marginBlockStart",
-          "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\"",
+          "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\"",
           "complexType": {
-            "original": "BoxSpacingType",
-            "resolved": "\"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\"",
+            "original": "BoxMarginType",
+            "resolved": "\"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\"",
             "references": {
-              "BoxSpacingType": {
+              "BoxMarginType": {
                 "location": "import",
                 "path": "../../utils/types",
-                "id": "src/utils/types.ts::BoxSpacingType",
-                "referenceLocation": "BoxSpacingType"
+                "id": "src/utils/types.ts::BoxMarginType",
+                "referenceLocation": "BoxMarginType"
               }
             }
           },
           "mutable": false,
           "attr": "margin-block-start",
           "reflectToAttr": false,
-          "docs": "Defines the box's outer top spacing.",
+          "docs": "Defines the box's outer top spacing. Accepts a spacing token or `auto`.",
           "docsTags": [
             {
               "name": "defaultValue",
@@ -4310,6 +4368,10 @@
               "value": "800",
               "type": "string"
             },
+            {
+              "value": "auto",
+              "type": "string"
+            },
             {
               "value": "lg",
               "type": "string"
@@ -4350,23 +4412,23 @@
         },
         {
           "name": "marginBlockStartLg",
-          "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\"",
+          "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\"",
           "complexType": {
-            "original": "BoxSpacingType",
-            "resolved": "\"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\"",
+            "original": "BoxMarginType",
+            "resolved": "\"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\"",
             "references": {
-              "BoxSpacingType": {
+              "BoxMarginType": {
                 "location": "import",
                 "path": "../../utils/types",
-                "id": "src/utils/types.ts::BoxSpacingType",
-                "referenceLocation": "BoxSpacingType"
+                "id": "src/utils/types.ts::BoxMarginType",
+                "referenceLocation": "BoxMarginType"
               }
             }
           },
           "mutable": false,
           "attr": "margin-block-start-lg",
           "reflectToAttr": false,
-          "docs": "Defines the box's outer top spacing at the LG breakpoint.",
+          "docs": "Defines the box's outer top spacing at the LG breakpoint. Accepts a spacing token or `auto`.",
           "docsTags": [
             {
               "name": "defaultValue",
@@ -4446,6 +4508,10 @@
               "value": "800",
               "type": "string"
             },
+            {
+              "value": "auto",
+              "type": "string"
+            },
             {
               "value": "lg",
               "type": "string"
@@ -4486,23 +4552,23 @@
         },
         {
           "name": "marginBlockStartMd",
-          "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\"",
+          "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\"",
           "complexType": {
-            "original": "BoxSpacingType",
-            "resolved": "\"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\"",
+            "original": "BoxMarginType",
+            "resolved": "\"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\"",
             "references": {
-              "BoxSpacingType": {
+              "BoxMarginType": {
                 "location": "import",
                 "path": "../../utils/types",
-                "id": "src/utils/types.ts::BoxSpacingType",
-                "referenceLocation": "BoxSpacingType"
+                "id": "src/utils/types.ts::BoxMarginType",
+                "referenceLocation": "BoxMarginType"
               }
             }
           },
           "mutable": false,
           "attr": "margin-block-start-md",
           "reflectToAttr": false,
-          "docs": "Defines the box's outer top spacing at the MD breakpoint.",
+          "docs": "Defines the box's outer top spacing at the MD breakpoint. Accepts a spacing token or `auto`.",
           "docsTags": [
             {
               "name": "defaultValue",
@@ -4582,6 +4648,10 @@
               "value": "800",
               "type": "string"
             },
+            {
+              "value": "auto",
+              "type": "string"
+            },
             {
               "value": "lg",
               "type": "string"
@@ -4622,23 +4692,23 @@
         },
         {
           "name": "marginBlockStartSm",
-          "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\"",
+          "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\"",
           "complexType": {
-            "original": "BoxSpacingType",
-            "resolved": "\"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\"",
+            "original": "BoxMarginType",
+            "resolved": "\"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\"",
             "references": {
-              "BoxSpacingType": {
+              "BoxMarginType": {
                 "location": "import",
                 "path": "../../utils/types",
-                "id": "src/utils/types.ts::BoxSpacingType",
-                "referenceLocation": "BoxSpacingType"
+                "id": "src/utils/types.ts::BoxMarginType",
+                "referenceLocation": "BoxMarginType"
               }
             }
           },
           "mutable": false,
           "attr": "margin-block-start-sm",
           "reflectToAttr": false,
-          "docs": "Defines the box's outer top spacing at the SM breakpoint.",
+          "docs": "Defines the box's outer top spacing at the SM breakpoint. Accepts a spacing token or `auto`.",
           "docsTags": [
             {
               "name": "defaultValue",
@@ -4718,6 +4788,10 @@
               "value": "800",
               "type": "string"
             },
+            {
+              "value": "auto",
+              "type": "string"
+            },
             {
               "value": "lg",
               "type": "string"
@@ -4758,23 +4832,23 @@
         },
         {
           "name": "marginBlockStartXl",
-          "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\"",
+          "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\"",
           "complexType": {
-            "original": "BoxSpacingType",
-            "resolved": "\"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\"",
+            "original": "BoxMarginType",
+            "resolved": "\"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\"",
             "references": {
-              "BoxSpacingType": {
+              "BoxMarginType": {
                 "location": "import",
                 "path": "../../utils/types",
-                "id": "src/utils/types.ts::BoxSpacingType",
-                "referenceLocation": "BoxSpacingType"
+                "id": "src/utils/types.ts::BoxMarginType",
+                "referenceLocation": "BoxMarginType"
               }
             }
           },
           "mutable": false,
           "attr": "margin-block-start-xl",
           "reflectToAttr": false,
-          "docs": "Defines the box's outer top spacing at the XL breakpoint.",
+          "docs": "Defines the box's outer top spacing at the XL breakpoint. Accepts a spacing token or `auto`.",
           "docsTags": [
             {
               "name": "defaultValue",
@@ -4854,6 +4928,10 @@
               "value": "800",
               "type": "string"
             },
+            {
+              "value": "auto",
+              "type": "string"
+            },
             {
               "value": "lg",
               "type": "string"
@@ -4894,23 +4972,23 @@
         },
         {
           "name": "marginBlockStartXs",
-          "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\"",
+          "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\"",
           "complexType": {
-            "original": "BoxSpacingType",
-            "resolved": "\"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\"",
+            "original": "BoxMarginType",
+            "resolved": "\"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\"",
             "references": {
-              "BoxSpacingType": {
+              "BoxMarginType": {
                 "location": "import",
                 "path": "../../utils/types",
-                "id": "src/utils/types.ts::BoxSpacingType",
-                "referenceLocation": "BoxSpacingType"
+                "id": "src/utils/types.ts::BoxMarginType",
+                "referenceLocation": "BoxMarginType"
               }
             }
           },
           "mutable": false,
           "attr": "margin-block-start-xs",
           "reflectToAttr": false,
-          "docs": "Defines the box's outer top spacing at the XS breakpoint.",
+          "docs": "Defines the box's outer top spacing at the XS breakpoint. Accepts a spacing token or `auto`.",
           "docsTags": [
             {
               "name": "defaultValue",
@@ -4990,6 +5068,10 @@
               "value": "800",
               "type": "string"
             },
+            {
+              "value": "auto",
+              "type": "string"
+            },
             {
               "value": "lg",
               "type": "string"
@@ -5030,23 +5112,23 @@
         },
         {
           "name": "marginInlineEnd",
-          "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\"",
+          "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\"",
           "complexType": {
-            "original": "BoxSpacingType",
-            "resolved": "\"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\"",
+            "original": "BoxMarginType",
+            "resolved": "\"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\"",
             "references": {
-              "BoxSpacingType": {
+              "BoxMarginType": {
                 "location": "import",
                 "path": "../../utils/types",
-                "id": "src/utils/types.ts::BoxSpacingType",
-                "referenceLocation": "BoxSpacingType"
+                "id": "src/utils/types.ts::BoxMarginType",
+                "referenceLocation": "BoxMarginType"
               }
             }
           },
           "mutable": false,
           "attr": "margin-inline-end",
           "reflectToAttr": false,
-          "docs": "Defines the box's outer right spacing.",
+          "docs": "Defines the box's outer right spacing. Accepts a spacing token or `auto`.",
           "docsTags": [
             {
               "name": "defaultValue",
@@ -5126,6 +5208,10 @@
               "value": "800",
               "type": "string"
             },
+            {
+              "value": "auto",
+              "type": "string"
+            },
             {
               "value": "lg",
               "type": "string"
@@ -5166,23 +5252,23 @@
         },
         {
           "name": "marginInlineEndLg",
-          "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\"",
+          "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\"",
           "complexType": {
-            "original": "BoxSpacingType",
-            "resolved": "\"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\"",
+            "original": "BoxMarginType",
+            "resolved": "\"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\"",
             "references": {
-              "BoxSpacingType": {
+              "BoxMarginType": {
                 "location": "import",
                 "path": "../../utils/types",
-                "id": "src/utils/types.ts::BoxSpacingType",
-                "referenceLocation": "BoxSpacingType"
+                "id": "src/utils/types.ts::BoxMarginType",
+                "referenceLocation": "BoxMarginType"
               }
             }
           },
           "mutable": false,
           "attr": "margin-inline-end-lg",
           "reflectToAttr": false,
-          "docs": "Defines the box's outer right spacing at the LG breakpoint.",
+          "docs": "Defines the box's outer right spacing at the LG breakpoint. Accepts a spacing token or `auto`.",
           "docsTags": [
             {
               "name": "defaultValue",
@@ -5262,6 +5348,10 @@
               "value": "800",
               "type": "string"
             },
+            {
+              "value": "auto",
+              "type": "string"
+            },
             {
               "value": "lg",
               "type": "string"
@@ -5302,23 +5392,23 @@
         },
         {
           "name": "marginInlineEndMd",
-          "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\"",
+          "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\"",
           "complexType": {
-            "original": "BoxSpacingType",
-            "resolved": "\"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\"",
+            "original": "BoxMarginType",
+            "resolved": "\"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\"",
             "references": {
-              "BoxSpacingType": {
+              "BoxMarginType": {
                 "location": "import",
                 "path": "../../utils/types",
-                "id": "src/utils/types.ts::BoxSpacingType",
-                "referenceLocation": "BoxSpacingType"
+                "id": "src/utils/types.ts::BoxMarginType",
+                "referenceLocation": "BoxMarginType"
               }
             }
           },
           "mutable": false,
           "attr": "margin-inline-end-md",
           "reflectToAttr": false,
-          "docs": "Defines the box's outer right spacing at the MD breakpoint.",
+          "docs": "Defines the box's outer right spacing at the MD breakpoint. Accepts a spacing token or `auto`.",
           "docsTags": [
             {
               "name": "defaultValue",
@@ -5398,6 +5488,10 @@
               "value": "800",
               "type": "string"
             },
+            {
+              "value": "auto",
+              "type": "string"
+            },
             {
               "value": "lg",
               "type": "string"
@@ -5438,23 +5532,23 @@
         },
         {
           "name": "marginInlineEndSm",
-          "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\"",
+          "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\"",
           "complexType": {
-            "original": "BoxSpacingType",
-            "resolved": "\"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\"",
+            "original": "BoxMarginType",
+            "resolved": "\"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\"",
             "references": {
-              "BoxSpacingType": {
+              "BoxMarginType": {
                 "location": "import",
                 "path": "../../utils/types",
-                "id": "src/utils/types.ts::BoxSpacingType",
-                "referenceLocation": "BoxSpacingType"
+                "id": "src/utils/types.ts::BoxMarginType",
+                "referenceLocation": "BoxMarginType"
               }
             }
           },
           "mutable": false,
           "attr": "margin-inline-end-sm",
           "reflectToAttr": false,
-          "docs": "Defines the box's outer right spacing at the SM breakpoint.",
+          "docs": "Defines the box's outer right spacing at the SM breakpoint. Accepts a spacing token or `auto`.",
           "docsTags": [
             {
               "name": "defaultValue",
@@ -5534,6 +5628,10 @@
               "value": "800",
               "type": "string"
             },
+            {
+              "value": "auto",
+              "type": "string"
+            },
             {
               "value": "lg",
               "type": "string"
@@ -5574,23 +5672,23 @@
         },
         {
           "name": "marginInlineEndXl",
-          "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\"",
+          "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\"",
           "complexType": {
-            "original": "BoxSpacingType",
-            "resolved": "\"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\"",
+            "original": "BoxMarginType",
+            "resolved": "\"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\"",
             "references": {
-              "BoxSpacingType": {
+              "BoxMarginType": {
                 "location": "import",
                 "path": "../../utils/types",
-                "id": "src/utils/types.ts::BoxSpacingType",
-                "referenceLocation": "BoxSpacingType"
+                "id": "src/utils/types.ts::BoxMarginType",
+                "referenceLocation": "BoxMarginType"
               }
             }
           },
           "mutable": false,
           "attr": "margin-inline-end-xl",
           "reflectToAttr": false,
-          "docs": "Defines the box's outer right spacing at the XL breakpoint.",
+          "docs": "Defines the box's outer right spacing at the XL breakpoint. Accepts a spacing token or `auto`.",
           "docsTags": [
             {
               "name": "defaultValue",
@@ -5670,6 +5768,10 @@
               "value": "800",
               "type": "string"
             },
+            {
+              "value": "auto",
+              "type": "string"
+            },
             {
               "value": "lg",
               "type": "string"
@@ -5710,23 +5812,23 @@
         },
         {
           "name": "marginInlineEndXs",
-          "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\"",
+          "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\"",
           "complexType": {
-            "original": "BoxSpacingType",
-            "resolved": "\"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\"",
+            "original": "BoxMarginType",
+            "resolved": "\"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\"",
             "references": {
-              "BoxSpacingType": {
+              "BoxMarginType": {
                 "location": "import",
                 "path": "../../utils/types",
-                "id": "src/utils/types.ts::BoxSpacingType",
-                "referenceLocation": "BoxSpacingType"
+                "id": "src/utils/types.ts::BoxMarginType",
+                "referenceLocation": "BoxMarginType"
               }
             }
           },
           "mutable": false,
           "attr": "margin-inline-end-xs",
           "reflectToAttr": false,
-          "docs": "Defines the box's outer right spacing at the XS breakpoint.",
+          "docs": "Defines the box's outer right spacing at the XS breakpoint. Accepts a spacing token or `auto`.",
           "docsTags": [
             {
               "name": "defaultValue",
@@ -5806,6 +5908,10 @@
               "value": "800",
               "type": "string"
             },
+            {
+              "value": "auto",
+              "type": "string"
+            },
             {
               "value": "lg",
               "type": "string"
@@ -5846,23 +5952,23 @@
         },
         {
           "name": "marginInlineStart",
-          "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\"",
+          "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\"",
           "complexType": {
-            "original": "BoxSpacingType",
-            "resolved": "\"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\"",
+            "original": "BoxMarginType",
+            "resolved": "\"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\"",
             "references": {
-              "BoxSpacingType": {
+              "BoxMarginType": {
                 "location": "import",
                 "path": "../../utils/types",
-                "id": "src/utils/types.ts::BoxSpacingType",
-                "referenceLocation": "BoxSpacingType"
+                "id": "src/utils/types.ts::BoxMarginType",
+                "referenceLocation": "BoxMarginType"
               }
             }
           },
           "mutable": false,
           "attr": "margin-inline-start",
           "reflectToAttr": false,
-          "docs": "Defines the box's outer left spacing.",
+          "docs": "Defines the box's outer left spacing. Accepts a spacing token or `auto`.",
           "docsTags": [
             {
               "name": "defaultValue",
@@ -5942,6 +6048,10 @@
               "value": "800",
               "type": "string"
             },
+            {
+              "value": "auto",
+              "type": "string"
+            },
             {
               "value": "lg",
               "type": "string"
@@ -5982,23 +6092,23 @@
         },
         {
           "name": "marginInlineStartLg",
-          "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\"",
+          "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\"",
           "complexType": {
-            "original": "BoxSpacingType",
-            "resolved": "\"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\"",
+            "original": "BoxMarginType",
+            "resolved": "\"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\"",
             "references": {
-              "BoxSpacingType": {
+              "BoxMarginType": {
                 "location": "import",
                 "path": "../../utils/types",
-                "id": "src/utils/types.ts::BoxSpacingType",
-                "referenceLocation": "BoxSpacingType"
+                "id": "src/utils/types.ts::BoxMarginType",
+                "referenceLocation": "BoxMarginType"
               }
             }
           },
           "mutable": false,
           "attr": "margin-inline-start-lg",
           "reflectToAttr": false,
-          "docs": "Defines the box's outer left spacing at the LG breakpoint.",
+          "docs": "Defines the box's outer left spacing at the LG breakpoint. Accepts a spacing token or `auto`.",
           "docsTags": [
             {
               "name": "defaultValue",
@@ -6078,6 +6188,10 @@
               "value": "800",
               "type": "string"
             },
+            {
+              "value": "auto",
+              "type": "string"
+            },
             {
               "value": "lg",
               "type": "string"
@@ -6118,23 +6232,23 @@
         },
         {
           "name": "marginInlineStartMd",
-          "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\"",
+          "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\"",
           "complexType": {
-            "original": "BoxSpacingType",
-            "resolved": "\"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\"",
+            "original": "BoxMarginType",
+            "resolved": "\"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\"",
             "references": {
-              "BoxSpacingType": {
+              "BoxMarginType": {
                 "location": "import",
                 "path": "../../utils/types",
-                "id": "src/utils/types.ts::BoxSpacingType",
-                "referenceLocation": "BoxSpacingType"
+                "id": "src/utils/types.ts::BoxMarginType",
+                "referenceLocation": "BoxMarginType"
               }
             }
           },
           "mutable": false,
           "attr": "margin-inline-start-md",
           "reflectToAttr": false,
-          "docs": "Defines the box's outer left spacing at the MD breakpoint.",
+          "docs": "Defines the box's outer left spacing at the MD breakpoint. Accepts a spacing token or `auto`.",
           "docsTags": [
             {
               "name": "defaultValue",
@@ -6215,11 +6329,15 @@
               "type": "string"
             },
             {
-              "value": "lg",
+              "value": "auto",
               "type": "string"
             },
             {
-              "value": "md",
+              "value": "lg",
+              "type": "string"
+            },
+            {
+              "value": "md",
               "type": "string"
             },
             {
@@ -6254,23 +6372,23 @@
         },
         {
           "name": "marginInlineStartSm",
-          "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\"",
+          "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\"",
           "complexType": {
-            "original": "BoxSpacingType",
-            "resolved": "\"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\"",
+            "original": "BoxMarginType",
+            "resolved": "\"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\"",
             "references": {
-              "BoxSpacingType": {
+              "BoxMarginType": {
                 "location": "import",
                 "path": "../../utils/types",
-                "id": "src/utils/types.ts::BoxSpacingType",
-                "referenceLocation": "BoxSpacingType"
+                "id": "src/utils/types.ts::BoxMarginType",
+                "referenceLocation": "BoxMarginType"
               }
             }
           },
           "mutable": false,
           "attr": "margin-inline-start-sm",
           "reflectToAttr": false,
-          "docs": "Defines the box's outer left spacing at the SM breakpoint.",
+          "docs": "Defines the box's outer left spacing at the SM breakpoint. Accepts a spacing token or `auto`.",
           "docsTags": [
             {
               "name": "defaultValue",
@@ -6350,6 +6468,10 @@
               "value": "800",
               "type": "string"
             },
+            {
+              "value": "auto",
+              "type": "string"
+            },
             {
               "value": "lg",
               "type": "string"
@@ -6390,23 +6512,23 @@
         },
         {
           "name": "marginInlineStartXl",
-          "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\"",
+          "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\"",
           "complexType": {
-            "original": "BoxSpacingType",
-            "resolved": "\"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\"",
+            "original": "BoxMarginType",
+            "resolved": "\"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\"",
             "references": {
-              "BoxSpacingType": {
+              "BoxMarginType": {
                 "location": "import",
                 "path": "../../utils/types",
-                "id": "src/utils/types.ts::BoxSpacingType",
-                "referenceLocation": "BoxSpacingType"
+                "id": "src/utils/types.ts::BoxMarginType",
+                "referenceLocation": "BoxMarginType"
               }
             }
           },
           "mutable": false,
           "attr": "margin-inline-start-xl",
           "reflectToAttr": false,
-          "docs": "Defines the box's outer left spacing at the XL breakpoint.",
+          "docs": "Defines the box's outer left spacing at the XL breakpoint. Accepts a spacing token or `auto`.",
           "docsTags": [
             {
               "name": "defaultValue",
@@ -6486,6 +6608,10 @@
               "value": "800",
               "type": "string"
             },
+            {
+              "value": "auto",
+              "type": "string"
+            },
             {
               "value": "lg",
               "type": "string"
@@ -6526,23 +6652,23 @@
         },
         {
           "name": "marginInlineStartXs",
-          "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\"",
+          "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\"",
           "complexType": {
-            "original": "BoxSpacingType",
-            "resolved": "\"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\"",
+            "original": "BoxMarginType",
+            "resolved": "\"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\"",
             "references": {
-              "BoxSpacingType": {
+              "BoxMarginType": {
                 "location": "import",
                 "path": "../../utils/types",
-                "id": "src/utils/types.ts::BoxSpacingType",
-                "referenceLocation": "BoxSpacingType"
+                "id": "src/utils/types.ts::BoxMarginType",
+                "referenceLocation": "BoxMarginType"
               }
             }
           },
           "mutable": false,
           "attr": "margin-inline-start-xs",
           "reflectToAttr": false,
-          "docs": "Defines the box's outer left spacing at the XS breakpoint.",
+          "docs": "Defines the box's outer left spacing at the XS breakpoint. Accepts a spacing token or `auto`.",
           "docsTags": [
             {
               "name": "defaultValue",
@@ -6622,6 +6748,10 @@
               "value": "800",
               "type": "string"
             },
+            {
+              "value": "auto",
+              "type": "string"
+            },
             {
               "value": "lg",
               "type": "string"
@@ -12161,7 +12291,7 @@
           "mutable": false,
           "attr": "href",
           "reflectToAttr": false,
-          "docs": "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.",
+          "docs": "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`.",
           "docsTags": [],
           "values": [
             {
@@ -12276,7 +12406,7 @@
           "mutable": false,
           "attr": "name",
           "reflectToAttr": false,
-          "docs": "Provides the button with a submittable name.",
+          "docs": "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`.",
           "docsTags": [],
           "values": [
             {
@@ -12411,7 +12541,7 @@
           "mutable": false,
           "attr": "value",
           "reflectToAttr": false,
-          "docs": "Provides button with a submittable value",
+          "docs": "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`.",
           "docsTags": [],
           "values": [
             {
@@ -12502,7 +12632,7 @@
           },
           "cancelable": true,
           "composed": true,
-          "docs": "",
+          "docs": "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.",
           "docsTags": []
         }
       ],
@@ -12673,7 +12803,7 @@
           "mutable": false,
           "attr": "error-message",
           "reflectToAttr": false,
-          "docs": "Displays message text describing an invalid state.",
+          "docs": "Displays an error message below the checkbox. It becomes the checkbox's accessible description only while `invalid` is set.",
           "docsTags": [],
           "values": [
             {
@@ -12696,7 +12826,7 @@
           "mutable": false,
           "attr": "helper-message",
           "reflectToAttr": false,
-          "docs": "String used for helper message below checkbox.",
+          "docs": "Displays a message or hint below the checkbox.",
           "docsTags": [],
           "values": [
             {
@@ -12742,7 +12872,7 @@
           "mutable": true,
           "attr": "indeterminate",
           "reflectToAttr": false,
-          "docs": "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`.",
+          "docs": "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`.",
           "docsTags": [],
           "values": [
             {
@@ -12765,7 +12895,7 @@
           "mutable": false,
           "attr": "invalid",
           "reflectToAttr": false,
-          "docs": "It determines whether or not the checkbox is invalid.",
+          "docs": "Determines whether or not the checkbox is invalid.",
           "docsTags": [],
           "values": [
             {
@@ -12788,7 +12918,7 @@
           "mutable": false,
           "attr": "label",
           "reflectToAttr": false,
-          "docs": "String used for label text next to checkbox.",
+          "docs": "Text to be displayed as the checkbox label.",
           "docsTags": [],
           "values": [
             {
@@ -12924,7 +13054,7 @@
           },
           "cancelable": true,
           "composed": true,
-          "docs": "Event emitted that contains the `value` and `checked`.",
+          "docs": "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.",
           "docsTags": []
         },
         {
@@ -12945,7 +13075,7 @@
           },
           "cancelable": true,
           "composed": true,
-          "docs": "",
+          "docs": "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.",
           "docsTags": []
         }
       ],
@@ -12995,7 +13125,7 @@
         },
         {
           "name": "part",
-          "text": "button"
+          "text": "button - Exposes the trigger button for styling. Appears only on the dropdown variant."
         },
         {
           "name": "part",
@@ -13192,7 +13322,7 @@
           "mutable": false,
           "attr": "remove-http-method",
           "reflectToAttr": false,
-          "docs": "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.",
+          "docs": "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.",
           "docsTags": [],
           "values": [
             {
@@ -13467,7 +13597,7 @@
       "parts": [
         {
           "name": "button",
-          "docs": ""
+          "docs": "Exposes the trigger button for styling. Appears only on the dropdown variant."
         },
         {
           "name": "dot",
@@ -13520,6 +13650,22 @@
         {
           "name": "slot",
           "text": "loading - Custom loading indicator"
+        },
+        {
+          "name": "part",
+          "text": "button-trigger - Exposes the button trigger for styling. Appears only when `trigger` is `button`."
+        },
+        {
+          "name": "part",
+          "text": "chip-trigger - Exposes the chip trigger for styling. Appears only when `trigger` is `chip`."
+        },
+        {
+          "name": "part",
+          "text": "combobox - Exposes the outer container around the label, trigger and messages for styling."
+        },
+        {
+          "name": "part",
+          "text": "input - Exposes the native `input` element for styling. Appears only when `trigger` is `input`, the default."
         }
       ],
       "usage": {},
@@ -13986,20 +14132,14 @@
           "mutable": false,
           "attr": "dropdown-width",
           "reflectToAttr": false,
-          "docs": "Width of the dropdown. Any valid CSS width value.",
-          "docsTags": [
-            {
-              "name": "default",
-              "text": "'236px'"
-            }
-          ],
-          "default": "'236px'",
+          "docs": "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.",
+          "docsTags": [],
           "values": [
             {
               "type": "string"
             }
           ],
-          "optional": false,
+          "optional": true,
           "required": false,
           "getter": false,
           "setter": false
@@ -14067,14 +14207,14 @@
           "mutable": false,
           "attr": "flyout-max-width",
           "reflectToAttr": false,
-          "docs": "Maximum width of a group's flyout when `group-display` is `flyout`. Any valid CSS width value.",
+          "docs": "Maximum width of a group's flyout when `group-display` is `flyout`. Any valid CSS width\nvalue, including its padding.",
           "docsTags": [
             {
               "name": "default",
-              "text": "'380px'"
+              "text": "'388px'"
             }
           ],
-          "default": "'380px'",
+          "default": "'388px'",
           "values": [
             {
               "type": "string"
@@ -14096,14 +14236,14 @@
           "mutable": false,
           "attr": "flyout-min-width",
           "reflectToAttr": false,
-          "docs": "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`.",
+          "docs": "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`.",
           "docsTags": [
             {
               "name": "default",
-              "text": "'280px'"
+              "text": "'288px'"
             }
           ],
-          "default": "'280px'",
+          "default": "'288px'",
           "values": [
             {
               "type": "string"
@@ -14739,7 +14879,7 @@
           "mutable": true,
           "attr": "value",
           "reflectToAttr": false,
-          "docs": "The value of the combobox input.",
+          "docs": "The `value` of the selected option.",
           "docsTags": [
             {
               "name": "default",
@@ -14907,19 +15047,19 @@
       "parts": [
         {
           "name": "button-trigger",
-          "docs": ""
+          "docs": "Exposes the button trigger for styling. Appears only when `trigger` is `button`."
         },
         {
           "name": "chip-trigger",
-          "docs": ""
+          "docs": "Exposes the chip trigger for styling. Appears only when `trigger` is `chip`."
         },
         {
           "name": "combobox",
-          "docs": ""
+          "docs": "Exposes the outer container around the label, trigger and messages for styling."
         },
         {
           "name": "input",
-          "docs": ""
+          "docs": "Exposes the native `input` element for styling. Appears only when `trigger` is `input`, the default."
         }
       ],
       "states": [],
@@ -15223,7 +15363,7 @@
           },
           "cancelable": true,
           "composed": true,
-          "docs": "Event fired when copyText button is clicked.",
+          "docs": "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.",
           "docsTags": []
         }
       ],
@@ -16209,7 +16349,7 @@
           "mutable": false,
           "attr": "presets",
           "reflectToAttr": false,
-          "docs": "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.",
+          "docs": "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.",
           "docsTags": [],
           "values": [
             {
@@ -16878,7 +17018,7 @@
       "encapsulation": "none",
       "tag": "pds-drawer",
       "readme": "# pds-drawer\n\n\n",
-      "docs": "A side panel composed from `pds-modal`, non-modal by default.\n\nBy default, unlike `pds-modal`, the page stays interactive while a drawer\nis open: no dimming, no blur, no scroll lock, no click blocking.\n`pds-drawer` renders a `pds-modal` internally with `disableTopLayer` on and\nits backdrop suppressed, and adds the edge, width and dismiss behavior a\nside panel needs on top. With `modal`, it opens that `pds-modal` in the top\nlayer instead and keeps its backdrop. It does not reimplement focus, Escape or dialog semantics —\nthose come from `pds-modal` unchanged.",
+      "docs": "A side panel composed from `pds-modal`, non-modal by default.\n\nBy default, unlike `pds-modal`, the page stays interactive while a drawer\nis open: no dimming, no blur, no click blocking.\n`pds-drawer` renders a `pds-modal` internally with `disableTopLayer` on and\nits backdrop suppressed, and adds the edge, width and dismiss behavior a\nside panel needs on top. With `modal`, it opens that `pds-modal` in the top\nlayer instead and keeps its backdrop. It does not reimplement focus, Escape or dialog semantics —\nthose come from `pds-modal` unchanged.",
       "docsTags": [
         {
           "name": "lightDom",
@@ -16955,7 +17095,7 @@
           "mutable": false,
           "attr": "light-dismiss",
           "reflectToAttr": false,
-          "docs": "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.",
+          "docs": "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.",
           "docsTags": [
             {
               "name": "default",
@@ -17071,7 +17211,7 @@
           "mutable": false,
           "attr": "side",
           "reflectToAttr": false,
-          "docs": "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.",
+          "docs": "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.",
           "docsTags": [
             {
               "name": "default",
@@ -17197,7 +17337,7 @@
       "encapsulation": "none",
       "tag": "pds-drawer-content",
       "readme": "# pds-drawer-content\n\n\n",
-      "docs": "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.",
+      "docs": "Fills the space between the drawer header and footer.",
       "docsTags": [
         {
           "name": "lightDom",
@@ -17222,7 +17362,7 @@
       "encapsulation": "none",
       "tag": "pds-drawer-footer",
       "readme": "# pds-drawer-footer\n\n\n",
-      "docs": "",
+      "docs": "Holds the drawer's actions in a padded row aligned to the end, with a divider above.",
       "docsTags": [
         {
           "name": "lightDom",
@@ -17247,7 +17387,7 @@
       "encapsulation": "none",
       "tag": "pds-drawer-header",
       "readme": "# pds-drawer-header\n\n\n",
-      "docs": "",
+      "docs": "Holds the drawer's title and close control in a padded row, spaced apart, with a divider below.",
       "docsTags": [
         {
           "name": "lightDom",
@@ -17271,9 +17411,17 @@
       "filePath": "src/components/pds-dropdown-menu/pds-dropdown-menu.tsx",
       "encapsulation": "shadow",
       "tag": "pds-dropdown-menu",
-      "readme": "# pds-dropdown\n\n\n",
-      "docs": "",
+      "readme": "# pds-dropdown-menu\n\nReveals a list of actions from a button trigger, based on the WAI-ARIA Menu Button pattern.\n\n",
+      "docs": "Reveals a list of actions from a button trigger, based on the WAI-ARIA Menu Button pattern.",
       "docsTags": [
+        {
+          "name": "slot",
+          "text": "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."
+        },
+        {
+          "name": "slot",
+          "text": "(default) - The menu items: `pds-dropdown-menu-item` and `pds-dropdown-menu-separator` elements, or raw `<a>` and `<button>` elements."
+        },
         {
           "name": "slot",
           "text": "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."
@@ -17420,9 +17568,17 @@
       ],
       "styles": [],
       "slots": [
+        {
+          "name": "(default)",
+          "docs": "The menu items: `pds-dropdown-menu-item` and `pds-dropdown-menu-separator` elements, or raw `<a>` and `<button>` elements."
+        },
         {
           "name": "header",
           "docs": "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."
+        },
+        {
+          "name": "trigger",
+          "docs": "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."
         }
       ],
       "parts": [
@@ -17446,9 +17602,17 @@
       "filePath": "src/components/pds-dropdown-menu/pds-dropdown-menu-item/pds-dropdown-menu-item.tsx",
       "encapsulation": "shadow",
       "tag": "pds-dropdown-menu-item",
-      "readme": "# pds-dropdown-item\n\n\n",
-      "docs": "",
+      "readme": "# pds-dropdown-menu-item\n\nAn 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",
+      "docs": "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.",
       "docsTags": [
+        {
+          "name": "slot",
+          "text": "(default) - The item's label."
+        },
+        {
+          "name": "slot",
+          "text": "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."
+        },
         {
           "name": "part",
           "text": "button - Exposes the item's inner element for styling. Appears on button and informational items, not on links."
@@ -17490,7 +17654,7 @@
           "mutable": false,
           "attr": "destructive",
           "reflectToAttr": false,
-          "docs": "It determines whether or not the dropdown-item is destructive.",
+          "docs": "Determines whether or not the dropdown menu item is destructive.",
           "docsTags": [
             {
               "name": "defaultValue",
@@ -17519,7 +17683,7 @@
           "mutable": false,
           "attr": "disabled",
           "reflectToAttr": true,
-          "docs": "It determines whether or not the dropdown-item is disabled.",
+          "docs": "Determines whether or not the dropdown menu item is disabled.",
           "docsTags": [
             {
               "name": "defaultValue",
@@ -17571,7 +17735,7 @@
           "mutable": false,
           "attr": "external",
           "reflectToAttr": true,
-          "docs": "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.",
+          "docs": "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.",
           "docsTags": [
             {
               "name": "defaultValue",
@@ -17600,7 +17764,7 @@
           "mutable": false,
           "attr": "external-label",
           "reflectToAttr": false,
-          "docs": "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.",
+          "docs": "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.",
           "docsTags": [
             {
               "name": "defaultValue",
@@ -17628,7 +17792,7 @@
           "mutable": false,
           "attr": "href",
           "reflectToAttr": false,
-          "docs": "If provided, renders the dropdown-item as an anchor (`<a>`) element instead of a button.\nIgnored when `informational` is set.",
+          "docs": "If provided, renders the dropdown menu item as an anchor (`<a>`) element instead of a button.\nIgnored when `informational` is set.",
           "docsTags": [],
           "values": [
             {
@@ -17651,7 +17815,7 @@
           "mutable": false,
           "attr": "informational",
           "reflectToAttr": true,
-          "docs": "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.",
+          "docs": "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.",
           "docsTags": [
             {
               "name": "defaultValue",
@@ -17680,7 +17844,7 @@
           "mutable": false,
           "attr": "target",
           "reflectToAttr": true,
-          "docs": "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.",
+          "docs": "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.",
           "docsTags": [
             {
               "name": "defaultValue",
@@ -17731,7 +17895,7 @@
           },
           "signature": "clickItem() => Promise<void>",
           "parameters": [],
-          "docs": "Trigger the click event",
+          "docs": "Trigger the click event. Does nothing when the item is disabled or informational.",
           "docsTags": []
         }
       ],
@@ -17752,13 +17916,22 @@
           },
           "cancelable": true,
           "composed": true,
-          "docs": "Emitted when the dropdown-item is clicked.",
+          "docs": "Emitted when the dropdown menu item is clicked.",
           "docsTags": []
         }
       ],
       "listeners": [],
       "styles": [],
-      "slots": [],
+      "slots": [
+        {
+          "name": "(default)",
+          "docs": "The item's label."
+        },
+        {
+          "name": "start",
+          "docs": "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."
+        }
+      ],
       "parts": [
         {
           "name": "button",
@@ -17783,8 +17956,8 @@
       "filePath": "src/components/pds-dropdown-menu/pds-dropdown-menu-separator/pds-dropdown-menu-separator.tsx",
       "encapsulation": "shadow",
       "tag": "pds-dropdown-menu-separator",
-      "readme": "# pds-dropdown-item\n\n\n",
-      "docs": "",
+      "readme": "# pds-dropdown-menu-separator\n\nA divider line between groups of items in a `pds-dropdown-menu`.\n\n",
+      "docs": "A divider line between groups of items in a `pds-dropdown-menu`.",
       "docsTags": [],
       "usage": {},
       "props": [
@@ -17822,7 +17995,7 @@
           "mutable": false,
           "attr": "disabled",
           "reflectToAttr": false,
-          "docs": "It determines whether or not the dropdown-item is disabled.",
+          "docs": "Has no effect. A separator can't be focused or activated.",
           "docsTags": [
             {
               "name": "defaultValue",
@@ -17857,7 +18030,7 @@
       "encapsulation": "shadow",
       "tag": "pds-filter",
       "readme": "# pds-filter\n\n\n",
-      "docs": "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",
+      "docs": "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.",
       "docsTags": [
         {
           "name": "part",
@@ -17943,7 +18116,7 @@
           "mutable": false,
           "attr": "text",
           "reflectToAttr": false,
-          "docs": "The text content displayed in the trigger button.",
+          "docs": "The text content displayed in the trigger button.\nWhen text overflows, a tooltip showing the full text will appear on hover/focus.",
           "docsTags": [],
           "values": [
             {
@@ -18262,7 +18435,7 @@
           "mutable": false,
           "attr": "alt",
           "reflectToAttr": false,
-          "docs": "The image's alt tag. If none is provided,\nit will default to an empty string, which is desired for\ndecorative images.",
+          "docs": "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.",
           "docsTags": [
             {
               "name": "defaultValue",
@@ -18303,6 +18476,52 @@
           "getter": false,
           "setter": false
         },
+        {
+          "name": "fit",
+          "type": "\"contain\" | \"cover\" | \"fill\" | \"none\" | \"scale-down\"",
+          "complexType": {
+            "original": "'contain' | 'cover' | 'fill' | 'none' | 'scale-down'",
+            "resolved": "\"contain\" | \"cover\" | \"fill\" | \"none\" | \"scale-down\"",
+            "references": {}
+          },
+          "mutable": false,
+          "attr": "fit",
+          "reflectToAttr": false,
+          "docs": "Determines how the image fills the shape set by `ratio`.\nHas no effect if `ratio` is not set.",
+          "docsTags": [
+            {
+              "name": "defaultValue",
+              "text": "cover"
+            }
+          ],
+          "default": "'cover'",
+          "values": [
+            {
+              "value": "contain",
+              "type": "string"
+            },
+            {
+              "value": "cover",
+              "type": "string"
+            },
+            {
+              "value": "fill",
+              "type": "string"
+            },
+            {
+              "value": "none",
+              "type": "string"
+            },
+            {
+              "value": "scale-down",
+              "type": "string"
+            }
+          ],
+          "optional": true,
+          "required": false,
+          "getter": false,
+          "setter": false
+        },
         {
           "name": "height",
           "type": "number",
@@ -18314,7 +18533,7 @@
           "mutable": false,
           "attr": "height",
           "reflectToAttr": false,
-          "docs": "The height of the image in pixels. Setting this will\ndevote space in the layout to prevent layout\nshifts when the image is loaded.",
+          "docs": "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.",
           "docsTags": [],
           "values": [
             {
@@ -18360,6 +18579,60 @@
           "getter": false,
           "setter": false
         },
+        {
+          "name": "ratio",
+          "type": "\"landscape\" | \"portrait\" | \"square\" | \"tall\" | \"wide\" | string & Record<never, never>",
+          "complexType": {
+            "original": "ImageRatioType | (string & Record<never, never>)",
+            "resolved": "\"landscape\" | \"portrait\" | \"square\" | \"tall\" | \"wide\" | string & Record<never, never>",
+            "references": {
+              "ImageRatioType": {
+                "location": "import",
+                "path": "@utils/types",
+                "id": "src/utils/types.ts::ImageRatioType",
+                "referenceLocation": "ImageRatioType"
+              },
+              "Record": {
+                "location": "global",
+                "id": "global::Record"
+              }
+            }
+          },
+          "mutable": false,
+          "attr": "ratio",
+          "reflectToAttr": false,
+          "docs": "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.",
+          "docsTags": [],
+          "values": [
+            {
+              "value": "landscape",
+              "type": "string"
+            },
+            {
+              "value": "portrait",
+              "type": "string"
+            },
+            {
+              "value": "square",
+              "type": "string"
+            },
+            {
+              "value": "tall",
+              "type": "string"
+            },
+            {
+              "value": "wide",
+              "type": "string"
+            },
+            {
+              "type": "string & Record<never, never>"
+            }
+          ],
+          "optional": true,
+          "required": false,
+          "getter": false,
+          "setter": false
+        },
         {
           "name": "sizes",
           "type": "string",
@@ -18440,7 +18713,7 @@
           "mutable": false,
           "attr": "width",
           "reflectToAttr": false,
-          "docs": "The width of the image in pixels. Setting this will\ndevote space in the layout to prevent layout\nshifts when the image is loaded.",
+          "docs": "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.",
           "docsTags": [],
           "values": [
             {
@@ -18454,13 +18727,61 @@
         }
       ],
       "methods": [],
-      "events": [],
+      "events": [
+        {
+          "event": "pdsImageError",
+          "detail": "ImageErrorEventDetail",
+          "bubbles": true,
+          "complexType": {
+            "original": "ImageErrorEventDetail",
+            "resolved": "ImageErrorEventDetail",
+            "references": {
+              "ImageErrorEventDetail": {
+                "location": "import",
+                "path": "./image-interface",
+                "id": "src/components/pds-image/image-interface.ts::ImageErrorEventDetail",
+                "referenceLocation": "ImageErrorEventDetail"
+              }
+            }
+          },
+          "cancelable": true,
+          "composed": true,
+          "docs": "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.",
+          "docsTags": []
+        },
+        {
+          "event": "pdsImageLoad",
+          "detail": "ImageLoadEventDetail",
+          "bubbles": true,
+          "complexType": {
+            "original": "ImageLoadEventDetail",
+            "resolved": "ImageLoadEventDetail",
+            "references": {
+              "ImageLoadEventDetail": {
+                "location": "import",
+                "path": "./image-interface",
+                "id": "src/components/pds-image/image-interface.ts::ImageLoadEventDetail",
+                "referenceLocation": "ImageLoadEventDetail"
+              }
+            }
+          },
+          "cancelable": true,
+          "composed": true,
+          "docs": "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.",
+          "docsTags": []
+        }
+      ],
       "listeners": [],
       "styles": [
         {
           "name": "--dimension-aspect-ratio",
           "annotation": "prop",
           "docs": "The image's aspect ratio."
+        },
+        {
+          "name": "--dimension-object-fit",
+          "annotation": "prop",
+          "docs": "How the image fills the shape its aspect ratio gives it."
         }
       ],
       "slots": [],
@@ -18496,6 +18817,26 @@
         {
           "name": "slot",
           "text": "action - Content to be displayed in the label area, typically for help icons or links"
+        },
+        {
+          "name": "part",
+          "text": "action - Exposes the wrapper around the `action` slot for styling. Appears only when the `action` slot has content."
+        },
+        {
+          "name": "part",
+          "text": "append - Exposes the wrapper around the `append` slot for styling. Appears only when the `append` slot has content."
+        },
+        {
+          "name": "part",
+          "text": "prefix - Exposes the wrapper around the `prefix` slot for styling. Appears only when the `prefix` slot has content."
+        },
+        {
+          "name": "part",
+          "text": "prepend - Exposes the wrapper around the `prepend` slot for styling. Appears only when the `prepend` slot has content."
+        },
+        {
+          "name": "part",
+          "text": "suffix - Exposes the wrapper around the `suffix` slot for styling. Appears only when the `suffix` slot has content."
         }
       ],
       "usage": {},
@@ -18557,7 +18898,7 @@
           "mutable": false,
           "attr": "debounce",
           "reflectToAttr": false,
-          "docs": "Sets the number of milliseconds to wait before updating the value.",
+          "docs": "Sets the number of milliseconds to wait after each input event before emitting `pdsInput`.",
           "docsTags": [],
           "values": [
             {
@@ -18603,7 +18944,7 @@
           "mutable": false,
           "attr": "error-message",
           "reflectToAttr": false,
-          "docs": "Specifies the error message and provides an error-themed treatment to the field.",
+          "docs": "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.",
           "docsTags": [],
           "values": [
             {
@@ -18718,7 +19059,7 @@
           "mutable": false,
           "attr": "invalid",
           "reflectToAttr": false,
-          "docs": "Determines whether or not the input field is invalid or throws an error.",
+          "docs": "Determines whether or not the input is invalid.",
           "docsTags": [],
           "values": [
             {
@@ -18994,7 +19335,7 @@
           "mutable": false,
           "attr": "type",
           "reflectToAttr": false,
-          "docs": "Determines the type of control that will be displayed\n`'email'`, `'number'`, `'password'`, `'tel'`, `'text'`, `'url'`",
+          "docs": "Determines the type of control that will be displayed\n`'email'`, `'number'`, `'password'`, `'search'`, `'tel'`, `'text'`, `'url'`",
           "docsTags": [
             {
               "name": "defaultValue",
@@ -19107,7 +19448,7 @@
           },
           "cancelable": true,
           "composed": true,
-          "docs": "Emitted when the value has changed.\n\nThis event will not emit when programmatically setting the `value` property.",
+          "docs": "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.",
           "docsTags": []
         },
         {
@@ -19147,7 +19488,7 @@
           },
           "cancelable": true,
           "composed": true,
-          "docs": "Emitted when a keyboard input occurs.",
+          "docs": "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.",
           "docsTags": []
         },
         {
@@ -19197,23 +19538,23 @@
       "parts": [
         {
           "name": "action",
-          "docs": ""
+          "docs": "Exposes the wrapper around the `action` slot for styling. Appears only when the `action` slot has content."
         },
         {
           "name": "append",
-          "docs": ""
+          "docs": "Exposes the wrapper around the `append` slot for styling. Appears only when the `append` slot has content."
         },
         {
           "name": "prefix",
-          "docs": ""
+          "docs": "Exposes the wrapper around the `prefix` slot for styling. Appears only when the `prefix` slot has content."
         },
         {
           "name": "prepend",
-          "docs": ""
+          "docs": "Exposes the wrapper around the `prepend` slot for styling. Appears only when the `prepend` slot has content."
         },
         {
           "name": "suffix",
-          "docs": ""
+          "docs": "Exposes the wrapper around the `suffix` slot for styling. Appears only when the `suffix` slot has content."
         }
       ],
       "states": [],
@@ -19245,7 +19586,7 @@
         },
         {
           "name": "slot",
-          "text": "(default) - Text content placed between the opening and closing tags. If no text is provided, the **href** will be used as a fallback."
+          "text": "(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."
         }
       ],
       "usage": {},
@@ -19359,19 +19700,14 @@
           "mutable": false,
           "attr": "external",
           "reflectToAttr": false,
-          "docs": "Determines whether the link should open in a new tab.",
+          "docs": "Shows the external-link (launch) icon. Opens in a new tab unless `target` says otherwise.",
           "docsTags": [
             {
               "name": "defaultValue",
               "text": "false"
-            },
-            {
-              "name": "deprecated",
-              "text": "Consider using the `target` prop for more control. This prop will be maintained for backward compatibility."
             }
           ],
           "default": "false",
-          "deprecation": "Consider using the `target` prop for more control. This prop will be maintained for backward compatibility.",
           "values": [
             {
               "type": "boolean"
@@ -19393,7 +19729,7 @@
           "mutable": false,
           "attr": "external-label",
           "reflectToAttr": false,
-          "docs": "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.",
+          "docs": "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.",
           "docsTags": [
             {
               "name": "defaultValue",
@@ -19459,7 +19795,7 @@
           "mutable": false,
           "attr": "href",
           "reflectToAttr": false,
-          "docs": "The hyperlink's destination URL. If no text is provided in the custom slot, the href will be used.",
+          "docs": "The hyperlink's destination URL. If the default slot is empty (whitespace counts as content), the href will be used as the link text.",
           "docsTags": [],
           "values": [
             {
@@ -19482,7 +19818,7 @@
           "mutable": false,
           "attr": "target",
           "reflectToAttr": false,
-          "docs": "Specifies where to open the linked document.",
+          "docs": "Specifies where to open the linked document. Overrides the new-tab\ndefault of `external`; the icon still shows.",
           "docsTags": [
             {
               "name": "defaultValue",
@@ -19490,7 +19826,7 @@
             },
             {
               "name": "example",
-              "text": "<pds-link href=\"https://example.com\" target=\"_blank\">Opens in new tab</pds-link>"
+              "text": "<pds-link href=\"/dashboard\" target=\"_top\">Opens in the top-level frame</pds-link>"
             }
           ],
           "values": [
@@ -19764,7 +20100,7 @@
       "slots": [
         {
           "name": "(default)",
-          "docs": "Text content placed between the opening and closing tags. If no text is provided, the **href** will be used as a fallback."
+          "docs": "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."
         }
       ],
       "parts": [
@@ -19802,7 +20138,7 @@
         },
         {
           "name": "slot",
-          "text": "label - Default slot for Loader label text."
+          "text": "label - Label text. Defaults to \"Loading...\". Text outside this slot isn't shown or read."
         }
       ],
       "usage": {},
@@ -19876,7 +20212,7 @@
           "mutable": true,
           "attr": "size",
           "reflectToAttr": true,
-          "docs": "Sets the size of the spinner loader. Value can be preset or custom.",
+          "docs": "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.",
           "docsTags": [
             {
               "name": "default",
@@ -19936,7 +20272,7 @@
       "slots": [
         {
           "name": "label",
-          "docs": "Default slot for Loader label text."
+          "docs": "Label text. Defaults to \"Loading...\". Text outside this slot isn't shown or read."
         }
       ],
       "parts": [
@@ -19974,6 +20310,10 @@
         {
           "name": "lightDom",
           "text": "renders-markup"
+        },
+        {
+          "name": "part",
+          "text": "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."
         }
       ],
       "usage": {},
@@ -20041,7 +20381,7 @@
           "mutable": false,
           "attr": "disable-initial-focus",
           "reflectToAttr": false,
-          "docs": "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.",
+          "docs": "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.",
           "docsTags": [
             {
               "name": "default",
@@ -20293,7 +20633,7 @@
       "parts": [
         {
           "name": "modal",
-          "docs": ""
+          "docs": "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."
         }
       ],
       "states": [],
@@ -20380,7 +20720,7 @@
       "encapsulation": "none",
       "tag": "pds-modal-footer",
       "readme": "# pds-modal-footer\n\n\n",
-      "docs": "",
+      "docs": "Holds the modal's actions. It adds no padding or layout, so wrap its content in a `pds-box` with `padding=\"md\"`.",
       "docsTags": [
         {
           "name": "lightDom",
@@ -20405,7 +20745,7 @@
       "encapsulation": "none",
       "tag": "pds-modal-header",
       "readme": "# pds-modal-header\n\n\n",
-      "docs": "",
+      "docs": "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\"`.",
       "docsTags": [
         {
           "name": "lightDom",
@@ -20429,8 +20769,8 @@
       "filePath": "src/components/pds-multiselect/pds-multiselect.tsx",
       "encapsulation": "shadow",
       "tag": "pds-multiselect",
-      "readme": "# pds-multiselect\n\nA multiselect component that allows users to select multiple options from a searchable dropdown list. Selected items are displayed as removable chips in a Select2-style pillbox interface.\n\n## Features\n\n- **Pillbox UI**: Selected items appear as removable chips inside the input container\n- **Typeahead Search**: Filter options as you type\n- **Checkbox Options**: Clear selection state with real checkboxes in the dropdown\n- **Async Support**: Fetch options from a URL endpoint or manage data externally\n- **Infinite Scroll**: Automatic pagination when scrolling to the bottom\n- **Keyboard Navigation**: Full keyboard support for accessibility\n- **Form Integration**: Works with native forms and FormData\n",
-      "docs": "A multiselect component that allows users to select multiple options from a searchable dropdown list. Selected items are displayed as removable chips in a Select2-style pillbox interface.",
+      "readme": "# pds-multiselect\n\nA multiselect component that allows users to select multiple options from a searchable dropdown list. By default the trigger shows how many items are selected; set `selected-display=\"pill\"` to show them as removable pills instead.\n\n## Features\n\n- **Selected Display**: A count in the trigger by default, or removable pills with `selected-display=\"pill\"`\n- **Typeahead Search**: Filter options as you type\n- **Checkbox Options**: Clear selection state with real checkboxes in the dropdown\n- **Async Support**: Fetch options from a URL endpoint or manage data externally\n- **Infinite Scroll**: Automatic pagination when scrolling to the bottom\n- **Keyboard Navigation**: Full keyboard support for accessibility\n- **Form Integration**: Works with native forms and FormData\n",
+      "docs": "A multiselect component that allows users to select multiple options from a searchable dropdown list. By default the trigger shows how many items are selected; set `selected-display=\"pill\"` to show them as removable pills instead.",
       "docsTags": [
         {
           "name": "slot",
@@ -21932,7 +22272,7 @@
           },
           "cancelable": true,
           "composed": true,
-          "docs": "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.",
+          "docs": "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.",
           "docsTags": []
         },
         {
@@ -22119,14 +22459,14 @@
           "mutable": false,
           "attr": "max-width",
           "reflectToAttr": false,
-          "docs": "Sets the maximum width of the popover content",
+          "docs": "Sets the maximum width of the popover, in pixels, including its padding.",
           "docsTags": [
             {
               "name": "defaultValue",
-              "text": "352"
+              "text": "400"
             }
           ],
-          "default": "352",
+          "default": "400",
           "values": [
             {
               "type": "number"
@@ -22580,7 +22920,7 @@
           "docsTags": [
             {
               "name": "defaultValue",
-              "text": "'var(--pine-color-blue-300)'"
+              "text": "'var(--pine-color-primary)'"
             }
           ],
           "values": [
@@ -22627,7 +22967,7 @@
           "mutable": false,
           "attr": "percent",
           "reflectToAttr": false,
-          "docs": "Sets the progress fill pecentage and visually displayed when `show-percentage=true`.",
+          "docs": "Sets the progress fill percentage (0–100). Shown as text when `show-percent` is set.",
           "docsTags": [
             {
               "name": "defaultValue",
@@ -22810,7 +23150,7 @@
           "mutable": false,
           "attr": "checked",
           "reflectToAttr": false,
-          "docs": "Determines whether or not the radio is checked.",
+          "docs": "Determines whether or not the radio is checked. It keeps the value you set and doesn't change when the user picks a radio.",
           "docsTags": [
             {
               "name": "defaultValue",
@@ -22891,7 +23231,7 @@
           "mutable": false,
           "attr": "error-message",
           "reflectToAttr": false,
-          "docs": "Displays error message text describing an invalid state.",
+          "docs": "Displays an error message below the radio. It becomes the radio's accessible description only while `invalid` is set.",
           "docsTags": [],
           "values": [
             {
@@ -22943,7 +23283,7 @@
           "mutable": false,
           "attr": "helper-message",
           "reflectToAttr": false,
-          "docs": "Displays helper message text below radio.",
+          "docs": "Displays a message or hint below the radio.",
           "docsTags": [],
           "values": [
             {
@@ -23018,7 +23358,7 @@
           "mutable": false,
           "attr": "label",
           "reflectToAttr": false,
-          "docs": "String used for label text next to radio.",
+          "docs": "Text to be displayed as the radio label.",
           "docsTags": [],
           "values": [
             {
@@ -23153,7 +23493,7 @@
           },
           "cancelable": true,
           "composed": true,
-          "docs": "Emits a boolean indicating whether the radio is currently checked or unchecked.",
+          "docs": "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.",
           "docsTags": []
         }
       ],
@@ -23297,7 +23637,7 @@
           "mutable": false,
           "attr": "error-message",
           "reflectToAttr": false,
-          "docs": "Displays error message text describing an invalid state for the entire group.",
+          "docs": "Displays an error message below the radio group. It's part of the group's accessible description, with or without `invalid`.",
           "docsTags": [],
           "values": [
             {
@@ -23349,7 +23689,7 @@
           "mutable": false,
           "attr": "group-label",
           "reflectToAttr": false,
-          "docs": "String used for group label/heading.",
+          "docs": "Text to be displayed as the radio group label. It also names the group, unless you set `aria-label` or `aria-labelledby` on it.",
           "docsTags": [],
           "values": [
             {
@@ -23372,7 +23712,7 @@
           "mutable": false,
           "attr": "helper-message",
           "reflectToAttr": false,
-          "docs": "Displays helper message text below the radio group.",
+          "docs": "Displays a message or hint below the radio group.",
           "docsTags": [],
           "values": [
             {
@@ -23486,7 +23826,7 @@
           },
           "cancelable": true,
           "composed": true,
-          "docs": "Emits when a radio in the group is selected, providing the selected value and component ID.",
+          "docs": "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`.",
           "docsTags": []
         }
       ],
@@ -24136,9 +24476,21 @@
       "readme": "# pds-select\n\n\n",
       "docs": "",
       "docsTags": [
+        {
+          "name": "slot",
+          "text": "(default) - The `option` and `optgroup` elements to choose from. Other elements are ignored."
+        },
         {
           "name": "slot",
           "text": "action - Content to be displayed in the label area, typically for help icons or links"
+        },
+        {
+          "name": "part",
+          "text": "action - Exposes the wrapper around the `action` slot for styling. Appears only when the `action` slot has content."
+        },
+        {
+          "name": "part",
+          "text": "select - Exposes the native `select` element for styling."
         }
       ],
       "usage": {},
@@ -24229,7 +24581,7 @@
           "mutable": false,
           "attr": "error-message",
           "reflectToAttr": false,
-          "docs": "Displays error message text describing an invalid state.",
+          "docs": "Displays an error message below the select and marks the select as invalid, with or without `invalid`.",
           "docsTags": [],
           "values": [
             {
@@ -24252,7 +24604,7 @@
           "mutable": false,
           "attr": "helper-message",
           "reflectToAttr": false,
-          "docs": "Displays helper message text below select.",
+          "docs": "Displays a message or hint below the select.",
           "docsTags": [],
           "values": [
             {
@@ -24539,13 +24891,17 @@
           },
           "cancelable": true,
           "composed": true,
-          "docs": "Emitted when the select value changes.",
+          "docs": "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.",
           "docsTags": []
         }
       ],
       "listeners": [],
       "styles": [],
       "slots": [
+        {
+          "name": "(default)",
+          "docs": "The `option` and `optgroup` elements to choose from. Other elements are ignored."
+        },
         {
           "name": "action",
           "docs": "Content to be displayed in the label area, typically for help icons or links"
@@ -24554,11 +24910,11 @@
       "parts": [
         {
           "name": "action",
-          "docs": ""
+          "docs": "Exposes the wrapper around the `action` slot for styling. Appears only when the `action` slot has content."
         },
         {
           "name": "select",
-          "docs": ""
+          "docs": "Exposes the native `select` element for styling."
         }
       ],
       "states": [],
@@ -24697,24 +25053,53 @@
           "setter": false
         },
         {
-          "name": "handleType",
-          "type": "\"handle\" | \"row\"",
+          "name": "handleLabel",
+          "type": "string",
           "complexType": {
-            "original": "'handle' | 'row'",
-            "resolved": "\"handle\" | \"row\"",
+            "original": "string",
+            "resolved": "string",
             "references": {}
           },
           "mutable": false,
-          "attr": "handle-type",
+          "attr": "handle-label",
           "reflectToAttr": false,
-          "docs": "Determines the grabbable area for the `pds-sortable-item`.",
+          "docs": "Accessible label for each item's reorder handle, the button the keyboard reorders with. Pass a translated string to localize it; `{item}` is interpolated.",
           "docsTags": [
             {
-              "name": "default",
-              "text": "'row'"
+              "name": "defaultValue",
+              "text": "'Reorder {item}'"
             }
           ],
-          "default": "'row'",
+          "default": "'Reorder {item}'",
+          "values": [
+            {
+              "type": "string"
+            }
+          ],
+          "optional": false,
+          "required": false,
+          "getter": false,
+          "setter": false
+        },
+        {
+          "name": "handleType",
+          "type": "\"handle\" | \"row\"",
+          "complexType": {
+            "original": "'handle' | 'row'",
+            "resolved": "\"handle\" | \"row\"",
+            "references": {}
+          },
+          "mutable": false,
+          "attr": "handle-type",
+          "reflectToAttr": false,
+          "docs": "Determines the grabbable area for the `pds-sortable-item`.",
+          "docsTags": [
+            {
+              "name": "default",
+              "text": "'row'"
+            }
+          ],
+          "default": "'row'",
           "values": [
             {
               "value": "handle",
@@ -24729,6 +25114,122 @@
           "required": false,
           "getter": false,
           "setter": false
+        },
+        {
+          "name": "itemDroppedLabel",
+          "type": "string",
+          "complexType": {
+            "original": "string",
+            "resolved": "string",
+            "references": {}
+          },
+          "mutable": false,
+          "attr": "item-dropped-label",
+          "reflectToAttr": false,
+          "docs": "Screen-reader announcement when a picked-up item is dropped. Pass a translated string to localize it; `{item}`, `{position}` and `{total}` are interpolated.",
+          "docsTags": [
+            {
+              "name": "defaultValue",
+              "text": "'{item}, dropped at position {position} of {total}'"
+            }
+          ],
+          "default": "'{item}, dropped at position {position} of {total}'",
+          "values": [
+            {
+              "type": "string"
+            }
+          ],
+          "optional": false,
+          "required": false,
+          "getter": false,
+          "setter": false
+        },
+        {
+          "name": "itemMovedLabel",
+          "type": "string",
+          "complexType": {
+            "original": "string",
+            "resolved": "string",
+            "references": {}
+          },
+          "mutable": false,
+          "attr": "item-moved-label",
+          "reflectToAttr": false,
+          "docs": "Screen-reader announcement when a picked-up item is moved. Pass a translated string to localize it; `{item}`, `{position}` and `{total}` are interpolated.",
+          "docsTags": [
+            {
+              "name": "defaultValue",
+              "text": "'{item}, moved to position {position} of {total}'"
+            }
+          ],
+          "default": "'{item}, moved to position {position} of {total}'",
+          "values": [
+            {
+              "type": "string"
+            }
+          ],
+          "optional": false,
+          "required": false,
+          "getter": false,
+          "setter": false
+        },
+        {
+          "name": "itemPickedUpLabel",
+          "type": "string",
+          "complexType": {
+            "original": "string",
+            "resolved": "string",
+            "references": {}
+          },
+          "mutable": false,
+          "attr": "item-picked-up-label",
+          "reflectToAttr": false,
+          "docs": "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.",
+          "docsTags": [
+            {
+              "name": "defaultValue",
+              "text": "'{item}, picked up. Position {position} of {total}. Press the arrow keys to move, Space or Enter to drop, Escape to cancel.'"
+            }
+          ],
+          "default": "'{item}, picked up. Position {position} of {total}. Press the arrow keys to move, Space or Enter to drop, Escape to cancel.'",
+          "values": [
+            {
+              "type": "string"
+            }
+          ],
+          "optional": false,
+          "required": false,
+          "getter": false,
+          "setter": false
+        },
+        {
+          "name": "reorderCanceledLabel",
+          "type": "string",
+          "complexType": {
+            "original": "string",
+            "resolved": "string",
+            "references": {}
+          },
+          "mutable": false,
+          "attr": "reorder-canceled-label",
+          "reflectToAttr": false,
+          "docs": "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.",
+          "docsTags": [
+            {
+              "name": "defaultValue",
+              "text": "'Reorder canceled. {item} returned to position {position} of {total}'"
+            }
+          ],
+          "default": "'Reorder canceled. {item} returned to position {position} of {total}'",
+          "values": [
+            {
+              "type": "string"
+            }
+          ],
+          "optional": false,
+          "required": false,
+          "getter": false,
+          "setter": false
         }
       ],
       "methods": [],
@@ -24751,11 +25252,17 @@
           },
           "cancelable": true,
           "composed": true,
-          "docs": "Event emitted when a sortable item is moved.",
+          "docs": "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.",
           "docsTags": []
         }
       ],
-      "listeners": [],
+      "listeners": [
+        {
+          "event": "pointerdown",
+          "capture": true,
+          "passive": true
+        }
+      ],
       "styles": [],
       "slots": [],
       "parts": [],
@@ -24773,7 +25280,7 @@
       "docsTags": [
         {
           "name": "slot",
-          "text": "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`."
+          "text": "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."
         },
         {
           "name": "lightDom",
@@ -24834,6 +25341,29 @@
           "getter": false,
           "setter": false
         },
+        {
+          "name": "itemLabel",
+          "type": "string",
+          "complexType": {
+            "original": "string",
+            "resolved": "string",
+            "references": {}
+          },
+          "mutable": false,
+          "attr": "item-label",
+          "reflectToAttr": false,
+          "docs": "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.",
+          "docsTags": [],
+          "values": [
+            {
+              "type": "string"
+            }
+          ],
+          "optional": true,
+          "required": false,
+          "getter": false,
+          "setter": false
+        },
         {
           "name": "showHandle",
           "type": "boolean",
@@ -24845,7 +25375,7 @@
           "mutable": true,
           "attr": "show-handle",
           "reflectToAttr": false,
-          "docs": "Determines whether `sortable-item` should have a handle.",
+          "docs": "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.",
           "docsTags": [
             {
               "name": "defaultValue",
@@ -24871,7 +25401,7 @@
       "slots": [
         {
           "name": "sortable-item-actions",
-          "docs": "Content is placed within the `pds-sortable-item__actions` element as children. This slot is only rendered if `actions` is set to `true`."
+          "docs": "Content is placed within the `pds-sortable-item__actions` element as children. This slot is only rendered when `enable-actions` is set."
         }
       ],
       "parts": [],
@@ -25112,8 +25642,8 @@
           },
           "mutable": false,
           "attr": "name",
-          "reflectToAttr": false,
-          "docs": "Identifies form data and unifies a group of radio inputs for toggling a single property/value.",
+          "reflectToAttr": true,
+          "docs": "Specifies the name. Submitted with the form name/value pair when checked, or with `unchecked-value` while unchecked.",
           "docsTags": [],
           "values": [
             {
@@ -25154,6 +25684,29 @@
           "getter": false,
           "setter": false
         },
+        {
+          "name": "uncheckedValue",
+          "type": "string",
+          "complexType": {
+            "original": "string",
+            "resolved": "string",
+            "references": {}
+          },
+          "mutable": false,
+          "attr": "unchecked-value",
+          "reflectToAttr": false,
+          "docs": "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.",
+          "docsTags": [],
+          "values": [
+            {
+              "type": "string"
+            }
+          ],
+          "optional": true,
+          "required": false,
+          "getter": false,
+          "setter": false
+        },
         {
           "name": "value",
           "type": "string",
@@ -25224,8 +25777,8 @@
       "filePath": "src/components/pds-tabs/pds-tab/pds-tab.tsx",
       "encapsulation": "none",
       "tag": "pds-tab",
-      "readme": "# pds-tabs\n\n\n",
-      "docs": "",
+      "readme": "# pds-tab\n\nA 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.\n\n",
+      "docs": "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.",
       "docsTags": [
         {
           "name": "lightDom",
@@ -25443,7 +25996,36 @@
       "tag": "pds-table",
       "readme": "# pds-table\n\n\n",
       "docs": "",
-      "docsTags": [],
+      "docsTags": [
+        {
+          "name": "part",
+          "text": "responsive-container - Exposes the horizontal scroll container for styling. Appears only when `responsive` is set."
+        },
+        {
+          "name": "part",
+          "text": "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."
+        },
+        {
+          "name": "part",
+          "text": "responsive-wrapper - Exposes the wrapper inside the scroll container for styling. Appears only when `responsive` is set."
+        },
+        {
+          "name": "part",
+          "text": "scroll-shadow-left - Exposes the scroll shadow at the inline-start edge for styling. Appears only when `responsive` is set."
+        },
+        {
+          "name": "part",
+          "text": "scroll-shadow-right - Exposes the scroll shadow at the inline-end edge for styling. Appears only when `responsive` is set."
+        },
+        {
+          "name": "part",
+          "text": "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."
+        },
+        {
+          "name": "part",
+          "text": "table-inner - Exposes the inner table element around the slotted head and body for styling. Appears only when `responsive` is set."
+        }
+      ],
       "usage": {},
       "props": [
         {
@@ -25589,7 +26171,7 @@
           "mutable": false,
           "attr": "fixed-column",
           "reflectToAttr": false,
-          "docs": "Determines if the should display a fixed first column.",
+          "docs": "Determines if the table displays a fixed first column.",
           "docsTags": [],
           "values": [
             {
@@ -25675,6 +26257,40 @@
           "required": false,
           "getter": false,
           "setter": false
+        },
+        {
+          "name": "tableLayout",
+          "type": "\"auto\" | \"fixed\"",
+          "complexType": {
+            "original": "'auto' | 'fixed'",
+            "resolved": "\"auto\" | \"fixed\"",
+            "references": {}
+          },
+          "mutable": false,
+          "attr": "table-layout",
+          "reflectToAttr": false,
+          "docs": "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.",
+          "docsTags": [
+            {
+              "name": "defaultValue",
+              "text": "'auto'"
+            }
+          ],
+          "default": "'auto'",
+          "values": [
+            {
+              "value": "auto",
+              "type": "string"
+            },
+            {
+              "value": "fixed",
+              "type": "string"
+            }
+          ],
+          "optional": false,
+          "required": false,
+          "getter": false,
+          "setter": false
         }
       ],
       "methods": [],
@@ -25690,7 +26306,7 @@
           },
           "cancelable": true,
           "composed": true,
-          "docs": "Event that is emitted when the select all checkbox is clicked, carrying the selected value.",
+          "docs": "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.",
           "docsTags": []
         }
       ],
@@ -25716,31 +26332,31 @@
       "parts": [
         {
           "name": "responsive-container",
-          "docs": ""
+          "docs": "Exposes the horizontal scroll container for styling. Appears only when `responsive` is set."
         },
         {
           "name": "responsive-table",
-          "docs": ""
+          "docs": "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."
         },
         {
           "name": "responsive-wrapper",
-          "docs": ""
+          "docs": "Exposes the wrapper inside the scroll container for styling. Appears only when `responsive` is set."
         },
         {
           "name": "scroll-shadow-left",
-          "docs": ""
+          "docs": "Exposes the scroll shadow at the inline-start edge for styling. Appears only when `responsive` is set."
         },
         {
           "name": "scroll-shadow-right",
-          "docs": ""
+          "docs": "Exposes the scroll shadow at the inline-end edge for styling. Appears only when `responsive` is set."
         },
         {
           "name": "table",
-          "docs": ""
+          "docs": "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."
         },
         {
           "name": "table-inner",
-          "docs": ""
+          "docs": "Exposes the inner table element around the slotted head and body for styling. Appears only when `responsive` is set."
         }
       ],
       "states": [],
@@ -25754,7 +26370,12 @@
       "tag": "pds-table-body",
       "readme": "# pds-table-body\n\n\n",
       "docs": "",
-      "docsTags": [],
+      "docsTags": [
+        {
+          "name": "part",
+          "text": "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."
+        }
+      ],
       "usage": {},
       "props": [],
       "methods": [],
@@ -25765,7 +26386,7 @@
       "parts": [
         {
           "name": "body",
-          "docs": ""
+          "docs": "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."
         }
       ],
       "states": [],
@@ -25779,7 +26400,12 @@
       "tag": "pds-table-cell",
       "readme": "# pds-table-cell\n\n\n",
       "docs": "",
-      "docsTags": [],
+      "docsTags": [
+        {
+          "name": "part",
+          "text": "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)`."
+        }
+      ],
       "usage": {},
       "props": [
         {
@@ -25842,7 +26468,30 @@
           "setter": false
         }
       ],
-      "methods": [],
+      "methods": [
+        {
+          "name": "rebindScrollListener",
+          "returns": {
+            "type": "Promise<void>",
+            "docs": ""
+          },
+          "complexType": {
+            "signature": "() => Promise<void>",
+            "parameters": [],
+            "references": {
+              "Promise": {
+                "location": "global",
+                "id": "global::Promise"
+              }
+            },
+            "return": "Promise<void>"
+          },
+          "signature": "rebindScrollListener() => Promise<void>",
+          "parameters": [],
+          "docs": "Re-binds the scroll listener to the table's current responsive container. Called by\n`pds-table` after a live `responsive` toggle: the cell stays in light DOM across that change,\nso it never reconnects on its own and would otherwise keep listening to a container the\ntable already replaced or removed.",
+          "docsTags": []
+        }
+      ],
       "events": [],
       "listeners": [],
       "styles": [],
@@ -25850,7 +26499,7 @@
       "parts": [
         {
           "name": "cell",
-          "docs": ""
+          "docs": "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)`."
         }
       ],
       "states": [],
@@ -25870,7 +26519,16 @@
       "tag": "pds-table-head",
       "readme": "# pds-table-head\n\n\n",
       "docs": "",
-      "docsTags": [],
+      "docsTags": [
+        {
+          "name": "part",
+          "text": "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."
+        },
+        {
+          "name": "part",
+          "text": "select-all-checkbox - Exposes the select-all checkbox for styling. Appears only when the table is `selectable` and `disableSelectAll` isn't set."
+        }
+      ],
       "usage": {},
       "props": [
         {
@@ -25965,7 +26623,7 @@
           "mutable": true,
           "attr": "is-selected",
           "reflectToAttr": false,
-          "docs": "Determines if the table row is currently selected.",
+          "docs": "Determines if the select all checkbox is checked.",
           "docsTags": [
             {
               "name": "defaultValue",
@@ -26006,11 +26664,11 @@
       "parts": [
         {
           "name": "head",
-          "docs": ""
+          "docs": "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."
         },
         {
           "name": "select-all-checkbox",
-          "docs": ""
+          "docs": "Exposes the select-all checkbox for styling. Appears only when the table is `selectable` and `disableSelectAll` isn't set."
         }
       ],
       "states": [],
@@ -26038,7 +26696,16 @@
       "tag": "pds-table-head-cell",
       "readme": "# pds-table-head-cell\n\n\n",
       "docs": "",
-      "docsTags": [],
+      "docsTags": [
+        {
+          "name": "part",
+          "text": "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)`."
+        },
+        {
+          "name": "part",
+          "text": "sort-icon - Exposes the sort direction icon for styling. Appears only on a `sortable` column while it's the active sort."
+        }
+      ],
       "usage": {},
       "props": [
         {
@@ -26099,6 +26766,29 @@
           "required": false,
           "getter": false,
           "setter": false
+        },
+        {
+          "name": "width",
+          "type": "string",
+          "complexType": {
+            "original": "string",
+            "resolved": "string",
+            "references": {}
+          },
+          "mutable": false,
+          "attr": "width",
+          "reflectToAttr": true,
+          "docs": "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.",
+          "docsTags": [],
+          "values": [
+            {
+              "type": "string"
+            }
+          ],
+          "optional": true,
+          "required": false,
+          "getter": false,
+          "setter": false
         }
       ],
       "methods": [
@@ -26124,6 +26814,28 @@
           "docs": "Clears the active sort state from this column.\nUsed internally when another column becomes active.",
           "docsTags": []
         },
+        {
+          "name": "rebindScrollListener",
+          "returns": {
+            "type": "Promise<void>",
+            "docs": ""
+          },
+          "complexType": {
+            "signature": "() => Promise<void>",
+            "parameters": [],
+            "references": {
+              "Promise": {
+                "location": "global",
+                "id": "global::Promise"
+              }
+            },
+            "return": "Promise<void>"
+          },
+          "signature": "rebindScrollListener() => Promise<void>",
+          "parameters": [],
+          "docs": "Re-binds the scroll listener to the table's current responsive container. Called by\n`pds-table` after a live `responsive` toggle: the cell stays in light DOM across that\nchange, so it never reconnects on its own and would otherwise keep listening to a container\nthe table already replaced or removed.",
+          "docsTags": []
+        },
         {
           "name": "setActiveSort",
           "returns": {
@@ -26186,11 +26898,11 @@
       "parts": [
         {
           "name": "head-cell",
-          "docs": ""
+          "docs": "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)`."
         },
         {
           "name": "sort-icon",
-          "docs": ""
+          "docs": "Exposes the sort direction icon for styling. Appears only on a `sortable` column while it's the active sort."
         }
       ],
       "states": [],
@@ -26215,7 +26927,16 @@
       "tag": "pds-table-row",
       "readme": "# pds-table-row\n\n\n",
       "docs": "",
-      "docsTags": [],
+      "docsTags": [
+        {
+          "name": "part",
+          "text": "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."
+        },
+        {
+          "name": "part",
+          "text": "row-checkbox - Exposes the row's selection checkbox for styling. Appears only when the table is `selectable`."
+        }
+      ],
       "usage": {},
       "props": [
         {
@@ -26288,11 +27009,11 @@
       "parts": [
         {
           "name": "row",
-          "docs": ""
+          "docs": "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."
         },
         {
           "name": "row-checkbox",
-          "docs": ""
+          "docs": "Exposes the row's selection checkbox for styling. Appears only when the table is `selectable`."
         }
       ],
       "states": [],
@@ -26315,8 +27036,8 @@
       "filePath": "src/components/pds-tabs/pds-tabpanel/pds-tabpanel.tsx",
       "encapsulation": "none",
       "tag": "pds-tabpanel",
-      "readme": "# pds-tabs\n\n\n",
-      "docs": "",
+      "readme": "# pds-tabpanel\n\nThe content for one tab inside `pds-tabs` in panel mode, shown when the `pds-tab` with the same `name` is active.\n\n",
+      "docs": "The content for one tab inside `pds-tabs` in panel mode, shown when the `pds-tab` with the same `name` is active.",
       "docsTags": [
         {
           "name": "lightDom",
@@ -26497,7 +27218,7 @@
           "mutable": false,
           "attr": "stretch",
           "reflectToAttr": false,
-          "docs": "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).",
+          "docs": "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).",
           "docsTags": [
             {
               "name": "defaultValue",
@@ -27052,6 +27773,10 @@
         {
           "name": "slot",
           "text": "action - Content to be displayed in the label area, typically for help icons or links"
+        },
+        {
+          "name": "part",
+          "text": "action - Exposes the wrapper around the `action` slot for styling. Appears only when the `action` slot has content."
         }
       ],
       "usage": {},
@@ -27142,7 +27867,7 @@
           "mutable": false,
           "attr": "debounce",
           "reflectToAttr": false,
-          "docs": "The amount of time, in milliseconds, to wait to trigger the event after each keystroke.",
+          "docs": "Sets the number of milliseconds to wait after each input event before emitting `pdsInput`.",
           "docsTags": [],
           "values": [
             {
@@ -27194,7 +27919,7 @@
           "mutable": false,
           "attr": "error-message",
           "reflectToAttr": false,
-          "docs": "Displays an error message below the textarea field.",
+          "docs": "Displays an error message below the textarea while `invalid` is set.",
           "docsTags": [],
           "values": [
             {
@@ -27286,7 +28011,7 @@
           "mutable": true,
           "attr": "invalid",
           "reflectToAttr": false,
-          "docs": "Determines whether or not the textarea is invalid or throws an error.",
+          "docs": "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.",
           "docsTags": [
             {
               "name": "defaultValue",
@@ -27361,7 +28086,7 @@
           "mutable": false,
           "attr": "name",
           "reflectToAttr": false,
-          "docs": "Specifies the name. Submitted with the form name/value pair. This value will mirror the componentId.",
+          "docs": "Specifies the name. Submitted with the form name/value pair.",
           "docsTags": [
             {
               "name": "default",
@@ -27554,7 +28279,7 @@
           },
           "cancelable": true,
           "composed": true,
-          "docs": "Emitted when the input loses focus.",
+          "docs": "Emitted when the textarea loses focus.",
           "docsTags": []
         },
         {
@@ -27573,7 +28298,7 @@
           },
           "cancelable": true,
           "composed": true,
-          "docs": "Emitted when the input has focus.",
+          "docs": "Emitted when the textarea has focus.",
           "docsTags": []
         },
         {
@@ -27594,7 +28319,7 @@
           },
           "cancelable": true,
           "composed": true,
-          "docs": "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`.",
+          "docs": "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.",
           "docsTags": []
         },
         {
@@ -27634,7 +28359,7 @@
           },
           "cancelable": true,
           "composed": true,
-          "docs": "Event emitted whenever the value of the textarea changes.\n\nThis event will not emit when programmatically setting the `value` property.",
+          "docs": "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.",
           "docsTags": []
         }
       ],
@@ -27649,7 +28374,7 @@
       "parts": [
         {
           "name": "action",
-          "docs": ""
+          "docs": "Exposes the wrapper around the `action` slot for styling. Appears only when the `action` slot has content."
         }
       ],
       "states": [],
@@ -27672,7 +28397,7 @@
       "docsTags": [
         {
           "name": "part",
-          "text": "dismiss"
+          "text": "dismiss - Exposes the dismiss button for styling. Appears unless `dismissible` is `false`."
         }
       ],
       "usage": {},
@@ -27897,7 +28622,7 @@
           },
           "signature": "dismiss() => Promise<void>",
           "parameters": [],
-          "docs": "",
+          "docs": "Dismisses the toast, as the dismiss button and `duration` do: plays the exit animation and emits `pdsToastDismissed`, and the toast\ngets `hidden` on the next render, after the event. Works even when `dismissible` is `false`. The toast stays in the DOM.",
           "docsTags": []
         }
       ],
@@ -27923,7 +28648,7 @@
       "parts": [
         {
           "name": "dismiss",
-          "docs": ""
+          "docs": "Exposes the dismiss button for styling. Appears unless `dismissible` is `false`."
         }
       ],
       "states": [],
@@ -28270,11 +28995,21 @@
     }
   ],
   "typeLibrary": {
+    "src/utils/types.ts::BoxContainerType": {
+      "declaration": "export type BoxContainerType = 'inline-size' | 'size';",
+      "docstring": "",
+      "path": "src/utils/types.ts"
+    },
     "src/utils/types.ts::BoxSpacingType": {
       "declaration": "export type BoxSpacingType =\n  'none'\n  | 'xxs'\n  | 'xs'\n  | 'sm'\n  | 'md'\n  | 'lg'\n  | 'xl'\n  | 'xxl'\n  | '025'\n  | '050'\n  | '100'\n  | '125'\n  | '150'\n  | '200'\n  | '250'\n  | '300'\n  | '350'\n  | '400'\n  | '450'\n  | '500'\n  | '550'\n  | '600'\n  | '650'\n  | '700'\n  | '750'\n  | '800';",
       "docstring": "",
       "path": "src/utils/types.ts"
     },
+    "src/utils/types.ts::BoxMarginType": {
+      "declaration": "export type BoxMarginType = BoxSpacingType | 'auto';",
+      "docstring": "",
+      "path": "src/utils/types.ts"
+    },
     "src/utils/types.ts::BoxColumnType": {
       "declaration": "export type BoxColumnType =\n  '0'\n  | '1'\n  | '2'\n  | '3'\n  | '4'\n  | '5'\n  | '6'\n  | '7'\n  | '8'\n  | '9'\n  | '10'\n  | '11'\n  | '12';",
       "docstring": "",
@@ -28326,7 +29061,7 @@
       "path": "src/utils/types.ts"
     },
     "src/components/pds-datepicker/datepicker-interface.ts::DatepickerPreset": {
-      "declaration": "export interface DatepickerPreset {\n  /**\n   * A built-in key (`today`, `yesterday`, `last-7-days`, `last-30-days`, `last-90-days`,\n   * `this-month`, `last-month`, `this-quarter`, `last-quarter`, `this-year`, `last-year`,\n   * `year-to-date`, `last-12-months`), or your own key when `start` and `end` are set.\n   */\n  key: string;\n  /** The text shown in the list. Built-in keys have English defaults; set it to translate them. */\n  label?: string;\n  /** For a preset of your own: its first day, `YYYY-MM-DD`. */\n  start?: string;\n  /** For a preset of your own: its last day, `YYYY-MM-DD`. */\n  end?: string;\n}",
+      "declaration": "export interface DatepickerPreset {\n  /**\n   * A built-in key (`today`, `yesterday`, `last-7-days`, `last-30-days`, `last-90-days`,\n   * `this-month`, `last-month`, `this-quarter`, `last-quarter`, `this-year`, `last-year`,\n   * `year-to-date`, `last-12-months`), or your own key when it has `startOffset` or `endOffset`,\n   * or both `start` and `end`.\n   */\n  key: string;\n  /**\n   * The text shown in the list. Built-in keys have English defaults; set it to translate them. A key\n   * of your own needs one, or it is left out of the list.\n   */\n  label?: string;\n  /**\n   * For a preset of your own that follows today: its first day, in whole days from today, so `-6`\n   * is six days ago and `0` is today. Resolved against today every time the list is read, as a\n   * built-in is, so the range stays relative however long the page stays open. Set one offset and\n   * the other is today.\n   */\n  startOffset?: number;\n  /** For a preset of your own that follows today: its last day, in whole days from today. */\n  endOffset?: number;\n  /**\n   * For a preset of your own on fixed days: its first day, `YYYY-MM-DD`. Fixed days do not follow\n   * today, so prefer `startOffset` and `endOffset` for a range meant to stay relative.\n   */\n  start?: string;\n  /** For a preset of your own on fixed days: its last day, `YYYY-MM-DD`. */\n  end?: string;\n}",
       "docstring": "",
       "path": "src/components/pds-datepicker/datepicker-interface.ts"
     },
@@ -28355,6 +29090,21 @@
       "docstring": "",
       "path": "src/components/pds-filters/pds-filter/filter-interface.ts"
     },
+    "src/utils/types.ts::ImageRatioType": {
+      "declaration": "export type ImageRatioType = 'square' | 'landscape' | 'wide' | 'portrait' | 'tall';",
+      "docstring": "",
+      "path": "src/utils/types.ts"
+    },
+    "src/components/pds-image/image-interface.ts::ImageLoadEventDetail": {
+      "declaration": "export interface ImageLoadEventDetail {\n  /** The URL the browser loaded, which can be a `srcset` candidate rather than `src`. */\n  currentSrc: string;\n  /** The loaded image's intrinsic height in pixels. */\n  naturalHeight: number;\n  /** The loaded image's intrinsic width in pixels. */\n  naturalWidth: number;\n}",
+      "docstring": "",
+      "path": "src/components/pds-image/image-interface.ts"
+    },
+    "src/components/pds-image/image-interface.ts::ImageErrorEventDetail": {
+      "declaration": "export interface ImageErrorEventDetail {\n  /** The URL that failed to load, which can be a `srcset` candidate rather than `src`. */\n  currentSrc: string;\n}",
+      "docstring": "",
+      "path": "src/components/pds-image/image-interface.ts"
+    },
     "src/components/pds-input/input-interface.ts::InputChangeEventDetail": {
       "declaration": "export interface InputChangeEventDetail {\n  value?: string | number | null;\n  event?: Event;\n}",
       "docstring": "",