@warp-ds/elements 2.9.2-next.1 → 2.10.0-next.2

package/dist/custom-elements.json

@@ -1131,7 +1131,7 @@
       "declarations": [
         {
           "kind": "class",
-          "description": "Buttons are used to perform actions, widh different visuals for different needs.\n\n[See Storybook for usage examples](https://warp-ds.github.io/elements/?path=/docs/buttons-button--docs)",
+          "description": "Performs an action or renders a link with button styling.\nUse button variants to match action priority, risk, and context.\n\n[See Storybook for usage examples](https://warp-ds.github.io/elements/?path=/docs/buttons-button--docs)",
           "name": "WarpButton",
           "members": [
             {
@@ -1141,7 +1141,8 @@
                 "text": "object"
               },
               "static": true,
-              "default": "{ ...LitElement.shadowRootOptions, delegatesFocus: true, }"
+              "default": "{ ...LitElement.shadowRootOptions, delegatesFocus: true, }",
+              "description": "Shadow root configuration.\nDelegates focus from the host to the internal control."
             },
             {
               "kind": "field",
@@ -1149,6 +1150,7 @@
               "type": {
                 "text": "ButtonType"
               },
+              "description": "Native button type.\nControls whether the internal button behaves as a regular button, submits a form, or resets a form. Defaults to `button`.",
               "attribute": "type",
               "reflects": true,
               "parsedType": {
@@ -1162,6 +1164,7 @@
                 "text": "boolean"
               },
               "default": "false",
+              "description": "Focuses the button when it is first rendered.\nApplies only when the component renders a native button. Link buttons with `href` do not autofocus through this component.",
               "attribute": "autofocus",
               "reflects": true
             },
@@ -1171,6 +1174,7 @@
               "type": {
                 "text": "ButtonVariant"
               },
+              "description": "Visual style of the button.\nDefaults to `secondary`. Use the variant that matches the action priority, risk, and placement.",
               "attribute": "variant",
               "reflects": true,
               "parsedType": {
@@ -1184,6 +1188,7 @@
                 "text": "boolean"
               },
               "default": "false",
+              "description": "Deprecated quiet visual treatment flag\nUse `variant=\"quiet\"` instead.",
               "deprecated": "Use `variant=\"quiet\"` instead",
               "attribute": "quiet",
               "reflects": true
@@ -1195,6 +1200,7 @@
                 "text": "boolean"
               },
               "default": "false",
+              "description": "Marks the button as icon-only.\nUse this when the button has no visible text. Include accessible text in the slotted content so the internal button has a name.",
               "attribute": "icon-only",
               "reflects": true
             },
@@ -1205,6 +1211,7 @@
                 "text": "boolean"
               },
               "default": "false",
+              "description": "Renders the compact button size.\nUse this in dense layouts where the default button size is too large.",
               "attribute": "small",
               "reflects": true
             },
@@ -1215,6 +1222,7 @@
                 "text": "boolean"
               },
               "default": "false",
+              "description": "Shows the loading state.\nUse after the user has triggered an action and the action is in progress.",
               "attribute": "loading",
               "reflects": true
             },
@@ -1224,6 +1232,7 @@
               "type": {
                 "text": "string"
               },
+              "description": "URL for rendering the button as a link.\nWhen set, the component renders `w-link` instead of a native `button`.",
               "attribute": "href",
               "reflects": true
             },
@@ -1233,6 +1242,7 @@
               "type": {
                 "text": "string"
               },
+              "description": "Link browsing context.\nPassed to the rendered link when `href` is set.",
               "attribute": "target",
               "reflects": true
             },
@@ -1243,6 +1253,7 @@
                 "text": "boolean"
               },
               "default": "false",
+              "description": "Visually disables the button.\nDisabled buttons are discouraged because they can hide the reason an action is unavailable.",
               "attribute": "disabled",
               "reflects": true
             },
@@ -1252,6 +1263,7 @@
               "type": {
                 "text": "string"
               },
+              "description": "Link relationship.\nPassed to the rendered link when `href` is set. If `target=\"_blank\"` is set and `rel` is omitted, `noopener` is used.",
               "attribute": "rel",
               "reflects": true
             },
@@ -1262,6 +1274,7 @@
                 "text": "boolean"
               },
               "default": "false",
+              "description": "Makes the button fill its parent width.\nUseful in narrow layouts where the button should span the available inline space.",
               "attribute": "full-width",
               "reflects": true
             },
@@ -1271,6 +1284,7 @@
               "type": {
                 "text": "string"
               },
+              "description": "Deprecated class applied to the internal control\nThis class is applied inside the shadow DOM and is unlikely to have the desired effect. Use attributes or CSS variables to customize the button appearance.",
               "deprecated": "This class is applied inside the shadow DOM and is unlikely to have the desired effect. Use attributes or CSS variables to customize the appearance of the button.",
               "attribute": "button-class",
               "reflects": true
@@ -1281,6 +1295,7 @@
               "type": {
                 "text": "string"
               },
+              "description": "Form control name.\nUsed when the button participates in form handling.",
               "attribute": "name",
               "reflects": true
             },
@@ -1290,9 +1305,44 @@
               "type": {
                 "text": "string"
               },
+              "description": "Form control value.\nUsed with `name` when the button participates in form handling. Resets to its initial value when the form is reset.",
               "attribute": "value",
               "reflects": true
             },
+            {
+              "kind": "field",
+              "name": "commandfor",
+              "type": {
+                "text": "string"
+              },
+              "description": "The [commandfor HTML attribute](https://developer.mozilla.org/en-US/docs/Web/API/Invoker_Commands_API#html_attributes) for Invoker Commands.",
+              "attribute": "commandfor"
+            },
+            {
+              "kind": "field",
+              "name": "command",
+              "type": {
+                "text": "string"
+              },
+              "description": "The [command HTML attribute](https://developer.mozilla.org/en-US/docs/Web/API/Invoker_Commands_API#html_attributes) for Invoker Commands.",
+              "attribute": "command"
+            },
+            {
+              "kind": "field",
+              "name": "buttonEl",
+              "type": {
+                "text": "HTMLButtonElement | null"
+              },
+              "privacy": "private"
+            },
+            {
+              "kind": "field",
+              "name": "ariaValueTextLoading",
+              "type": {
+                "text": "string"
+              },
+              "privacy": "private"
+            },
             {
               "kind": "field",
               "name": "#initialValue",
@@ -1302,6 +1352,25 @@
               },
               "default": "null"
             },
+            {
+              "kind": "method",
+              "name": "closestWithId",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "HTMLElement | null"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "id",
+                  "type": {
+                    "text": "string"
+                  }
+                }
+              ],
+              "description": "Traverse up the shadow roots looking for the ID to support use inside other Lit components."
+            },
             {
               "kind": "method",
               "name": "resetFormControl",
@@ -1313,10 +1382,6 @@
               "type": {
                 "text": "resetFormControl() => void"
               }
-            },
-            {
-              "kind": "field",
-              "name": "ariaValueTextLoading"
             }
           ],
           "attributes": [
@@ -1325,6 +1390,7 @@
               "type": {
                 "text": "ButtonType"
               },
+              "description": "Native button type.\nControls whether the internal button behaves as a regular button, submits a form, or resets a form. Defaults to `button`.",
               "fieldName": "type",
               "parsedType": {
                 "text": "'button' | 'submit' | 'reset'"
@@ -1336,6 +1402,7 @@
                 "text": "boolean"
               },
               "default": "false",
+              "description": "Focuses the button when it is first rendered.\nApplies only when the component renders a native button. Link buttons with `href` do not autofocus through this component.",
               "fieldName": "autofocus"
             },
             {
@@ -1343,6 +1410,7 @@
               "type": {
                 "text": "ButtonVariant"
               },
+              "description": "Visual style of the button.\nDefaults to `secondary`. Use the variant that matches the action priority, risk, and placement.",
               "fieldName": "variant",
               "parsedType": {
                 "text": "'negative' | 'primary' | 'secondary' | 'negativeQuiet' | 'utility' | 'quiet' | 'utilityQuiet' | 'overlay' | 'overlayInverted' | 'overlayQuiet' | 'overlayInvertedQuiet' | 'pill' | 'link'"
@@ -1354,6 +1422,7 @@
                 "text": "boolean"
               },
               "default": "false",
+              "description": "Deprecated quiet visual treatment flag\nUse `variant=\"quiet\"` instead.",
               "deprecated": "Use `variant=\"quiet\"` instead",
               "fieldName": "quiet"
             },
@@ -1363,6 +1432,7 @@
                 "text": "boolean"
               },
               "default": "false",
+              "description": "Marks the button as icon-only.\nUse this when the button has no visible text. Include accessible text in the slotted content so the internal button has a name.",
               "fieldName": "iconOnly"
             },
             {
@@ -1371,6 +1441,7 @@
                 "text": "boolean"
               },
               "default": "false",
+              "description": "Renders the compact button size.\nUse this in dense layouts where the default button size is too large.",
               "fieldName": "small"
             },
             {
@@ -1379,6 +1450,7 @@
                 "text": "boolean"
               },
               "default": "false",
+              "description": "Shows the loading state.\nUse after the user has triggered an action and the action is in progress.",
               "fieldName": "loading"
             },
             {
@@ -1386,6 +1458,7 @@
               "type": {
                 "text": "string"
               },
+              "description": "URL for rendering the button as a link.\nWhen set, the component renders `w-link` instead of a native `button`.",
               "fieldName": "href"
             },
             {
@@ -1393,6 +1466,7 @@
               "type": {
                 "text": "string"
               },
+              "description": "Link browsing context.\nPassed to the rendered link when `href` is set.",
               "fieldName": "target"
             },
             {
@@ -1401,6 +1475,7 @@
                 "text": "boolean"
               },
               "default": "false",
+              "description": "Visually disables the button.\nDisabled buttons are discouraged because they can hide the reason an action is unavailable.",
               "fieldName": "disabled"
             },
             {
@@ -1408,6 +1483,7 @@
               "type": {
                 "text": "string"
               },
+              "description": "Link relationship.\nPassed to the rendered link when `href` is set. If `target=\"_blank\"` is set and `rel` is omitted, `noopener` is used.",
               "fieldName": "rel"
             },
             {
@@ -1416,6 +1492,7 @@
                 "text": "boolean"
               },
               "default": "false",
+              "description": "Makes the button fill its parent width.\nUseful in narrow layouts where the button should span the available inline space.",
               "fieldName": "fullWidth"
             },
             {
@@ -1423,6 +1500,7 @@
               "type": {
                 "text": "string"
               },
+              "description": "Deprecated class applied to the internal control\nThis class is applied inside the shadow DOM and is unlikely to have the desired effect. Use attributes or CSS variables to customize the button appearance.",
               "deprecated": "This class is applied inside the shadow DOM and is unlikely to have the desired effect. Use attributes or CSS variables to customize the appearance of the button.",
               "fieldName": "buttonClass"
             },
@@ -1431,6 +1509,7 @@
               "type": {
                 "text": "string"
               },
+              "description": "Form control name.\nUsed when the button participates in form handling.",
               "fieldName": "name"
             },
             {
@@ -1438,7 +1517,24 @@
               "type": {
                 "text": "string"
               },
+              "description": "Form control value.\nUsed with `name` when the button participates in form handling. Resets to its initial value when the form is reset.",
               "fieldName": "value"
+            },
+            {
+              "name": "commandfor",
+              "type": {
+                "text": "string"
+              },
+              "description": "The [commandfor HTML attribute](https://developer.mozilla.org/en-US/docs/Web/API/Invoker_Commands_API#html_attributes) for Invoker Commands.",
+              "fieldName": "commandfor"
+            },
+            {
+              "name": "command",
+              "type": {
+                "text": "string"
+              },
+              "description": "The [command HTML attribute](https://developer.mozilla.org/en-US/docs/Web/API/Invoker_Commands_API#html_attributes) for Invoker Commands.",
+              "fieldName": "command"
             }
           ],
           "mixins": [
@@ -2139,6 +2235,7 @@
                 "text": "boolean"
               },
               "default": "false",
+              "description": "Whether the card is visually selected.\n\nUse this when the card represents a selected item or choice. This only controls the visual selected state; update it from your application state when the selection changes.",
               "attribute": "selected",
               "reflects": true
             },
@@ -2149,6 +2246,7 @@
                 "text": "boolean"
               },
               "default": "false",
+              "description": "Whether the card uses the flat visual treatment.\n\nFlat cards use a bordered surface instead of the default elevated surface. Use this for denser layouts or when the card sits inside another surface.",
               "attribute": "flat"
             },
             {
@@ -2158,6 +2256,7 @@
                 "text": "boolean"
               },
               "default": "false",
+              "description": "Whether the whole card is interactive.\n\nWhen set, the card becomes keyboard focusable and Enter or Space triggers a click on the card. Use this only when the whole card has one action or represents one selectable choice.",
               "attribute": "clickable"
             },
             {
@@ -2187,6 +2286,7 @@
                 "text": "boolean"
               },
               "default": "false",
+              "description": "Whether the card is visually selected.\n\nUse this when the card represents a selected item or choice. This only controls the visual selected state; update it from your application state when the selection changes.",
               "fieldName": "selected"
             },
             {
@@ -2195,6 +2295,7 @@
                 "text": "boolean"
               },
               "default": "false",
+              "description": "Whether the card uses the flat visual treatment.\n\nFlat cards use a bordered surface instead of the default elevated surface. Use this for denser layouts or when the card sits inside another surface.",
               "fieldName": "flat"
             },
             {
@@ -2203,6 +2304,7 @@
                 "text": "boolean"
               },
               "default": "false",
+              "description": "Whether the whole card is interactive.\n\nWhen set, the card becomes keyboard focusable and Enter or Space triggers a click on the card. Use this only when the whole card has one action or represents one selectable choice.",
               "fieldName": "clickable"
             }
           ],
@@ -4255,8 +4357,8 @@
       "declarations": [
         {
           "kind": "class",
-          "description": "Modals (or dialogs) display important information that users need to acknowledge.\n\n[See Storybook for usage examples](https://warp-ds.github.io/elements/?path=/docs/overlays-modal--docs)",
-          "name": "ModalMain",
+          "description": "Modals (or dialogs) display important information that users need to acknowledge.",
+          "name": "WarpModal",
           "slots": [
             {
               "description": "Typically where you would use the `w-modal-header` component.",
@@ -4279,6 +4381,7 @@
                 "text": "boolean"
               },
               "default": "false",
+              "description": "Controls if the modal should show or hide.\n\nYou can also call the `open()` and `close()` methods.",
               "attribute": "show"
             },
             {
@@ -4296,6 +4399,7 @@
                 "text": "boolean"
               },
               "default": "false",
+              "description": "Ignores clicks to the backdrop when set",
               "attribute": "ignore-backdrop-clicks"
             },
             {
@@ -4303,21 +4407,24 @@
               "name": "dialogEl",
               "type": {
                 "text": "HTMLDialogElement"
-              }
+              },
+              "privacy": "private"
             },
             {
               "kind": "field",
               "name": "dialogInnerEl",
               "type": {
                 "text": "HTMLElement"
-              }
+              },
+              "privacy": "private"
             },
             {
               "kind": "field",
               "name": "contentEl",
               "type": {
                 "text": "HTMLElement"
-              }
+              },
+              "privacy": "private"
             },
             {
               "kind": "method",
@@ -4336,19 +4443,18 @@
             {
               "kind": "method",
               "name": "handleListeners",
+              "privacy": "private",
               "parameters": [
                 {
                   "name": "verb",
                   "default": "'addEventListener'"
                 }
-              ],
-              "type": {
-                "text": "handleListeners(verb = 'addEventListener') => void"
-              }
+              ]
             },
             {
               "kind": "method",
               "name": "eventPreventer",
+              "privacy": "private",
               "parameters": [
                 {
                   "name": "evt",
@@ -4356,14 +4462,12 @@
                     "text": "Event"
                   }
                 }
-              ],
-              "type": {
-                "text": "eventPreventer(evt: Event) => void"
-              }
+              ]
             },
             {
               "kind": "method",
               "name": "closeOnBackdropClick",
+              "privacy": "private",
               "parameters": [
                 {
                   "name": "evt",
@@ -4371,14 +4475,12 @@
                     "text": "MouseEvent"
                   }
                 }
-              ],
-              "type": {
-                "text": "closeOnBackdropClick(evt: MouseEvent) => void"
-              }
+              ]
             },
             {
               "kind": "method",
               "name": "interceptEscape",
+              "privacy": "private",
               "parameters": [
                 {
                   "name": "evt",
@@ -4386,17 +4488,12 @@
                     "text": "KeyboardEvent"
                   }
                 }
-              ],
-              "type": {
-                "text": "interceptEscape(evt: KeyboardEvent) => void"
-              }
+              ]
             },
             {
               "kind": "method",
               "name": "modifyBorderRadius",
-              "type": {
-                "text": "modifyBorderRadius() => void"
-              }
+              "privacy": "private"
             }
           ],
           "events": [
@@ -4420,6 +4517,7 @@
                 "text": "boolean"
               },
               "default": "false",
+              "description": "Controls if the modal should show or hide.\n\nYou can also call the `open()` and `close()` methods.",
               "fieldName": "show"
             },
             {
@@ -4435,6 +4533,7 @@
                 "text": "boolean"
               },
               "default": "false",
+              "description": "Ignores clicks to the backdrop when set",
               "fieldName": "ignoreBackdropClicks"
             }
           ],
@@ -4452,9 +4551,23 @@
           "customElement": true,
           "modulePath": "packages/modal/modal.ts",
           "definitionPath": "packages/modal/modal.ts"
+        },
+        {
+          "kind": "variable",
+          "name": "ModalMain",
+          "default": "WarpModal",
+          "deprecated": "Exported for backwards compatibility. Use WarpModal."
         }
       ],
       "exports": [
+        {
+          "kind": "js",
+          "name": "WarpModal",
+          "declaration": {
+            "name": "WarpModal",
+            "module": "packages/modal/modal.ts"
+          }
+        },
         {
           "kind": "js",
           "name": "ModalMain",
@@ -4467,7 +4580,7 @@
           "kind": "custom-element-definition",
           "name": "w-modal",
           "declaration": {
-            "name": "ModalMain",
+            "name": "WarpModal",
             "module": "packages/modal/modal.ts"
           }
         }
@@ -4479,8 +4592,8 @@
       "declarations": [
         {
           "kind": "class",
-          "description": "The footer section of a modal, typically where you place actions.\n\n[See Storybook for usage examples](https://warp-ds.github.io/elements/?path=/docs/overlays-modal--docs)",
-          "name": "ModalFooter",
+          "description": "The footer section of a modal, typically where you place actions.",
+          "name": "WarpModalFooter",
           "members": [],
           "mixins": [
             {
@@ -4496,13 +4609,31 @@
             "name": "LitElement",
             "package": "lit"
           },
+          "parent": {
+            "name": "w-modal",
+            "description": ""
+          },
           "tagName": "w-modal-footer",
           "customElement": true,
           "modulePath": "packages/modal-footer/modal-footer.ts",
           "definitionPath": "packages/modal-footer/modal-footer.ts"
+        },
+        {
+          "kind": "variable",
+          "name": "ModalFooter",
+          "default": "WarpModalFooter",
+          "deprecated": "Exported for backwards compatibility. Use WarpModalFooter."
         }
       ],
       "exports": [
+        {
+          "kind": "js",
+          "name": "WarpModalFooter",
+          "declaration": {
+            "name": "WarpModalFooter",
+            "module": "packages/modal-footer/modal-footer.ts"
+          }
+        },
         {
           "kind": "js",
           "name": "ModalFooter",
@@ -4515,7 +4646,7 @@
           "kind": "custom-element-definition",
           "name": "w-modal-footer",
           "declaration": {
-            "name": "ModalFooter",
+            "name": "WarpModalFooter",
             "module": "packages/modal-footer/modal-footer.ts"
           }
         }
@@ -4527,8 +4658,8 @@
       "declarations": [
         {
           "kind": "class",
-          "description": "The header section of a modal, typically where you place the title and a close button.\n\n[See Storybook for usage examples](https://warp-ds.github.io/elements/?path=/docs/overlays-modal--docs)",
-          "name": "ModalHeader",
+          "description": "The header section of a modal, typically where you place the title and a close button.",
+          "name": "WarpModalHeader",
           "slots": [
             {
               "description": "Customize the title bar, for example to have a header image that reaches the modal's edges. See the With Image story for an example.",
@@ -4542,6 +4673,7 @@
               "type": {
                 "text": "string"
               },
+              "description": "A short but descriptive title for the modal",
               "attribute": "title"
             },
             {
@@ -4551,6 +4683,7 @@
                 "text": "boolean"
               },
               "default": "false",
+              "description": "Whether the modal header should have a back button",
               "attribute": "back"
             },
             {
@@ -4560,48 +4693,61 @@
                 "text": "boolean"
               },
               "default": "false",
+              "description": "Lets you hide the close button in the header",
               "attribute": "no-close"
             },
+            {
+              "kind": "field",
+              "name": "_hasTopContent",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "default": "false"
+            },
             {
               "kind": "field",
               "name": "titleEl",
               "type": {
                 "text": "HTMLElement"
-              }
+              },
+              "privacy": "private"
             },
             {
               "kind": "field",
               "name": "titleClasses",
+              "privacy": "private",
               "readonly": true
             },
             {
               "kind": "field",
               "name": "backButton",
+              "privacy": "private",
               "readonly": true
             },
             {
               "kind": "field",
               "name": "closeButton",
+              "privacy": "private",
               "readonly": true
             },
             {
               "kind": "method",
               "name": "emitBack",
-              "type": {
-                "text": "emitBack() => void"
-              }
+              "privacy": "private"
             },
             {
               "kind": "method",
               "name": "handleTopSlotChange",
+              "privacy": "private",
               "parameters": [
                 {
-                  "name": "slotEvent"
+                  "name": "slotEvent",
+                  "type": {
+                    "text": "Event"
+                  }
                 }
-              ],
-              "type": {
-                "text": "handleTopSlotChange(slotEvent) => void"
-              }
+              ]
             }
           ],
           "events": [
@@ -4618,6 +4764,7 @@
               "type": {
                 "text": "string"
               },
+              "description": "A short but descriptive title for the modal",
               "fieldName": "title"
             },
             {
@@ -4626,6 +4773,7 @@
                 "text": "boolean"
               },
               "default": "false",
+              "description": "Whether the modal header should have a back button",
               "fieldName": "back"
             },
             {
@@ -4634,6 +4782,7 @@
                 "text": "boolean"
               },
               "default": "false",
+              "description": "Lets you hide the close button in the header",
               "fieldName": "noClose"
             }
           ],
@@ -4647,13 +4796,31 @@
             "name": "LitElement",
             "package": "lit"
           },
+          "parent": {
+            "name": "w-modal",
+            "description": ""
+          },
           "tagName": "w-modal-header",
           "customElement": true,
           "modulePath": "packages/modal-header/modal-header.ts",
           "definitionPath": "packages/modal-header/modal-header.ts"
+        },
+        {
+          "kind": "variable",
+          "name": "ModalHeader",
+          "default": "WarpModalHeader",
+          "deprecated": "Exported for backwards compatibility. Use WarpModalHeader."
         }
       ],
       "exports": [
+        {
+          "kind": "js",
+          "name": "WarpModalHeader",
+          "declaration": {
+            "name": "WarpModalHeader",
+            "module": "packages/modal-header/modal-header.ts"
+          }
+        },
         {
           "kind": "js",
           "name": "ModalHeader",
@@ -4666,7 +4833,7 @@
           "kind": "custom-element-definition",
           "name": "w-modal-header",
           "declaration": {
-            "name": "ModalHeader",
+            "name": "WarpModalHeader",
             "module": "packages/modal-header/modal-header.ts"
           }
         }
@@ -4678,7 +4845,7 @@
       "declarations": [
         {
           "kind": "class",
-          "description": "A page indicator component that displays a series of dots representing pages.\nOne dot is highlighted to indicate the currently selected page.",
+          "description": "A page indicator component that displays a series of dots representing pages.\n\nOne dot is highlighted to indicate the currently selected page.",
           "name": "WarpPageIndicator",
           "members": [
             {
@@ -4687,7 +4854,8 @@
               "type": {
                 "text": "number"
               },
-              "description": "Currently selected page (1-based index, clamped to valid range)",
+              "description": "Currently selected page (1-based index)",
+              "default": "1",
               "attribute": "selected-page",
               "reflects": true
             },
@@ -4697,7 +4865,8 @@
               "type": {
                 "text": "number"
               },
-              "description": "Total number of pages (minimum 1)",
+              "description": "Total number of pages",
+              "default": "1",
               "attribute": "page-count",
               "reflects": true
             },
@@ -4728,7 +4897,8 @@
               "type": {
                 "text": "number"
               },
-              "description": "Currently selected page (1-based index, clamped to valid range)",
+              "description": "Currently selected page (1-based index)",
+              "default": "1",
               "fieldName": "selectedPage"
             },
             {
@@ -4736,7 +4906,8 @@
               "type": {
                 "text": "number"
               },
-              "description": "Total number of pages (minimum 1)",
+              "description": "Total number of pages",
+              "default": "1",
               "fieldName": "pageCount"
             }
           ],
@@ -4775,7 +4946,7 @@
       "declarations": [
         {
           "kind": "class",
-          "description": "Pagination allows users to navigate through multiple pages of content by providing navigation controls with page numbers and directional arrows.\n\n[See Storybook for usage examples](https://warp-ds.github.io/elements/?path=/docs/navigation-pagination--docs)",
+          "description": "Pagination allows users to navigate through multiple pages of content by providing navigation controls with page numbers and directional arrows.",
           "name": "WarpPagination",
           "members": [
             {
@@ -4784,6 +4955,7 @@
               "type": {
                 "text": "string"
               },
+              "description": "The base URL used to construct page links, for example `/search?page=`.\n\nThe page number is appended to this URL.",
               "attribute": "base-url",
               "reflects": true
             },
@@ -4793,6 +4965,7 @@
               "type": {
                 "text": "number"
               },
+              "description": "The total number of pages.",
               "attribute": "pages",
               "reflects": true
             },
@@ -4802,6 +4975,8 @@
               "type": {
                 "text": "number"
               },
+              "description": "The currently active page number.",
+              "default": "1",
               "attribute": "current-page",
               "reflects": true
             },
@@ -4811,6 +4986,8 @@
               "type": {
                 "text": "number"
               },
+              "description": "The maximum number of page numbers visible.",
+              "default": "7",
               "attribute": "visible-pages",
               "reflects": true
             },
@@ -4834,7 +5011,7 @@
               "type": {
                 "text": "CustomEvent"
               },
-              "description": "Triggered when a link button in the pagination is clicked. Contains the page number in `string` form."
+              "description": "Triggered when a link in the pagination is clicked. Contains the page number in `string` form."
             }
           ],
           "attributes": [
@@ -4843,6 +5020,7 @@
               "type": {
                 "text": "string"
               },
+              "description": "The base URL used to construct page links, for example `/search?page=`.\n\nThe page number is appended to this URL.",
               "fieldName": "baseUrl"
             },
             {
@@ -4850,6 +5028,7 @@
               "type": {
                 "text": "number"
               },
+              "description": "The total number of pages.",
               "fieldName": "pages"
             },
             {
@@ -4857,6 +5036,8 @@
               "type": {
                 "text": "number"
               },
+              "description": "The currently active page number.",
+              "default": "1",
               "fieldName": "currentPageNumber"
             },
             {
@@ -4864,6 +5045,8 @@
               "type": {
                 "text": "number"
               },
+              "description": "The maximum number of page numbers visible.",
+              "default": "7",
               "fieldName": "visiblePages"
             }
           ],
@@ -4902,7 +5085,7 @@
       "declarations": [
         {
           "kind": "class",
-          "description": "Pill is a type of button that is often used as a filter, but can also be used as a rounded button for overlays, etc.\n\n[See Storybook for usage examples](https://warp-ds.github.io/elements/?path=/docs/buttons-pill--docs)",
+          "description": "Pill is a type of button that is often used as a filter, but can also be used as a rounded button for overlays, etc.",
           "name": "WarpPill",
           "members": [
             {
@@ -4912,6 +5095,7 @@
                 "text": "boolean"
               },
               "default": "false",
+              "description": "Whether the pill should be removable via a close button.",
               "attribute": "can-close"
             },
             {
@@ -4921,6 +5105,7 @@
                 "text": "boolean"
               },
               "default": "false",
+              "description": "Whether the pill should be rendered as a suggestion.",
               "attribute": "suggestion"
             },
             {
@@ -4938,6 +5123,7 @@
               "type": {
                 "text": "string"
               },
+              "description": "Label read by screen readers when targeting the pill.",
               "attribute": "open-aria-label"
             },
             {
@@ -4955,15 +5141,46 @@
               "type": {
                 "text": "string"
               },
+              "description": "Label read by screen readers when targeting the close button.",
               "attribute": "close-aria-label"
             },
             {
               "kind": "field",
-              "name": "openFilterSrText"
+              "name": "openFilterSrText",
+              "type": {
+                "text": "string"
+              },
+              "privacy": "private"
             },
             {
               "kind": "field",
-              "name": "removeFilterSrText"
+              "name": "removeFilterSrText",
+              "type": {
+                "text": "string"
+              },
+              "privacy": "private"
+            },
+            {
+              "kind": "field",
+              "name": "_labelClasses",
+              "privacy": "private",
+              "readonly": true
+            },
+            {
+              "kind": "field",
+              "name": "_closeClasses",
+              "privacy": "private",
+              "readonly": true
+            },
+            {
+              "kind": "method",
+              "name": "_onClick",
+              "privacy": "private"
+            },
+            {
+              "kind": "method",
+              "name": "_onClose",
+              "privacy": "private"
             }
           ],
           "events": [
@@ -4971,13 +5188,15 @@
               "name": "w-pill-click",
               "type": {
                 "text": "CustomEvent"
-              }
+              },
+              "description": "Fires when the pill itself is clicked."
             },
             {
               "name": "w-pill-close",
               "type": {
                 "text": "CustomEvent"
-              }
+              },
+              "description": "Fires when the pill's close button is clicked."
             }
           ],
           "attributes": [
@@ -4987,6 +5206,7 @@
                 "text": "boolean"
               },
               "default": "false",
+              "description": "Whether the pill should be removable via a close button.",
               "fieldName": "canClose"
             },
             {
@@ -4995,6 +5215,7 @@
                 "text": "boolean"
               },
               "default": "false",
+              "description": "Whether the pill should be rendered as a suggestion.",
               "fieldName": "suggestion"
             },
             {
@@ -5010,6 +5231,7 @@
               "type": {
                 "text": "string"
               },
+              "description": "Label read by screen readers when targeting the pill.",
               "fieldName": "openAriaLabel"
             },
             {
@@ -5025,6 +5247,7 @@
               "type": {
                 "text": "string"
               },
+              "description": "Label read by screen readers when targeting the close button.",
               "fieldName": "closeAriaLabel"
             }
           ],