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

package/dist/packages/pill/pill.react.stories.d.ts

@@ -3,7 +3,7 @@ import React from 'react';
 import { Pill } from './react';
 declare const _default: {
     title: string;
-    render(args: Omit<Omit<Omit<React.HTMLAttributes<import("./pill").WarpPill>, "renderRoot" | "isUpdatePending" | "hasUpdated" | "addController" | "removeController" | "connectedCallback" | "disconnectedCallback" | "attributeChangedCallback" | "requestUpdate" | "updateComplete" | "onclick" | "onclose" | "render" | "renderOptions" | "onClick" | "canClose" | "onClose" | "suggestion" | "openSrLabel" | "openAriaLabel" | "closeSrLabel" | "closeAriaLabel" | "openFilterSrText" | "removeFilterSrText" | "_labelClasses" | "_closeClasses" | "_onClick" | "_onClose"> & {
+    render(args: Omit<Omit<Omit<React.HTMLAttributes<import("./pill").WarpPill>, "renderRoot" | "isUpdatePending" | "hasUpdated" | "addController" | "removeController" | "connectedCallback" | "disconnectedCallback" | "attributeChangedCallback" | "requestUpdate" | "updateComplete" | "onclick" | "onclose" | "render" | "renderOptions" | "onClick" | "canClose" | "onClose" | "suggestion" | "openSrLabel" | "openAriaLabel" | "closeSrLabel" | "closeAriaLabel"> & {
         onClick?: (e: Event) => void;
         onclick?: (e: Event) => void;
         onClose?: (e: Event) => void;
@@ -15,7 +15,7 @@ declare const _default: {
         closeSrLabel?: string;
         closeAriaLabel?: string;
     } & React.RefAttributes<import("./pill").WarpPill>): React.JSX.Element;
-    component: React.ForwardRefExoticComponent<Omit<Omit<Omit<React.HTMLAttributes<import("./pill").WarpPill>, "renderRoot" | "isUpdatePending" | "hasUpdated" | "addController" | "removeController" | "connectedCallback" | "disconnectedCallback" | "attributeChangedCallback" | "requestUpdate" | "updateComplete" | "onclick" | "onclose" | "render" | "renderOptions" | "onClick" | "canClose" | "onClose" | "suggestion" | "openSrLabel" | "openAriaLabel" | "closeSrLabel" | "closeAriaLabel" | "openFilterSrText" | "removeFilterSrText" | "_labelClasses" | "_closeClasses" | "_onClick" | "_onClose"> & {
+    component: React.ForwardRefExoticComponent<Omit<Omit<Omit<React.HTMLAttributes<import("./pill").WarpPill>, "renderRoot" | "isUpdatePending" | "hasUpdated" | "addController" | "removeController" | "connectedCallback" | "disconnectedCallback" | "attributeChangedCallback" | "requestUpdate" | "updateComplete" | "onclick" | "onclose" | "render" | "renderOptions" | "onClick" | "canClose" | "onClose" | "suggestion" | "openSrLabel" | "openAriaLabel" | "closeSrLabel" | "closeAriaLabel"> & {
         onClick?: (e: Event) => void;
         onclick?: (e: Event) => void;
         onClose?: (e: Event) => void;

package/dist/packages/pill/react.d.ts

@@ -1,6 +1,6 @@
 import React from 'react';
 import { WarpPill } from './pill.js';
-export declare const Pill: React.ForwardRefExoticComponent<Omit<Omit<Omit<React.HTMLAttributes<WarpPill>, "renderRoot" | "isUpdatePending" | "hasUpdated" | "addController" | "removeController" | "connectedCallback" | "disconnectedCallback" | "attributeChangedCallback" | "requestUpdate" | "updateComplete" | "onclick" | "onclose" | "render" | "renderOptions" | "onClick" | "canClose" | "onClose" | "suggestion" | "openSrLabel" | "openAriaLabel" | "closeSrLabel" | "closeAriaLabel" | "openFilterSrText" | "removeFilterSrText" | "_labelClasses" | "_closeClasses" | "_onClick" | "_onClose"> & {
+export declare const Pill: React.ForwardRefExoticComponent<Omit<Omit<Omit<React.HTMLAttributes<WarpPill>, "renderRoot" | "isUpdatePending" | "hasUpdated" | "addController" | "removeController" | "connectedCallback" | "disconnectedCallback" | "attributeChangedCallback" | "requestUpdate" | "updateComplete" | "onclick" | "onclose" | "render" | "renderOptions" | "onClick" | "canClose" | "onClose" | "suggestion" | "openSrLabel" | "openAriaLabel" | "closeSrLabel" | "closeAriaLabel"> & {
     onClick?: (e: Event) => void;
     onclick?: (e: Event) => void;
     onClose?: (e: Event) => void;

package/dist/web-types.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://raw.githubusercontent.com/JetBrains/web-types/master/schema/web-types.json",
   "name": "@warp-ds/elements",
-  "version": "2.9.1",
+  "version": "2.9.2-next.1",
   "description-markup": "markdown",
   "contributions": {
     "html": {
@@ -397,76 +397,185 @@
         },
         {
           "name": "w-button",
-          "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)\n---\n",
+          "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)\n---\n",
           "doc-url": "",
           "attributes": [
             {
               "name": "type",
+              "description": "Native button type.\nControls whether the internal button behaves as a regular button, submits a form, or resets a form. Defaults to `button`.",
               "value": { "type": "'button' | 'submit' | 'reset'" }
             },
             {
               "name": "autofocus",
+              "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.",
               "value": { "type": "boolean", "default": "false" }
             },
             {
               "name": "variant",
+              "description": "Visual style of the button.\nDefaults to `secondary`. Use the variant that matches the action priority, risk, and placement.",
               "value": {
                 "type": "'negative' | 'primary' | 'secondary' | 'negativeQuiet' | 'utility' | 'quiet' | 'utilityQuiet' | 'overlay' | 'overlayInverted' | 'overlayQuiet' | 'overlayInvertedQuiet' | 'pill' | 'link'"
               }
             },
             {
               "name": "quiet",
+              "description": "Deprecated quiet visual treatment flag\nUse `variant=\"quiet\"` instead.",
               "value": { "type": "boolean", "default": "false" }
             },
             {
               "name": "icon-only",
+              "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.",
               "value": { "type": "boolean", "default": "false" }
             },
             {
               "name": "small",
+              "description": "Renders the compact button size.\nUse this in dense layouts where the default button size is too large.",
               "value": { "type": "boolean", "default": "false" }
             },
             {
               "name": "loading",
+              "description": "Shows the loading state.\nUse after the user has triggered an action and the action is in progress.",
               "value": { "type": "boolean", "default": "false" }
             },
-            { "name": "href", "value": { "type": "string" } },
-            { "name": "target", "value": { "type": "string" } },
+            {
+              "name": "href",
+              "description": "URL for rendering the button as a link.\nWhen set, the component renders `w-link` instead of a native `button`.",
+              "value": { "type": "string" }
+            },
+            {
+              "name": "target",
+              "description": "Link browsing context.\nPassed to the rendered link when `href` is set.",
+              "value": { "type": "string" }
+            },
             {
               "name": "disabled",
+              "description": "Visually disables the button.\nDisabled buttons are discouraged because they can hide the reason an action is unavailable.",
               "value": { "type": "boolean", "default": "false" }
             },
-            { "name": "rel", "value": { "type": "string" } },
+            {
+              "name": "rel",
+              "description": "Link relationship.\nPassed to the rendered link when `href` is set. If `target=\"_blank\"` is set and `rel` is omitted, `noopener` is used.",
+              "value": { "type": "string" }
+            },
             {
               "name": "full-width",
+              "description": "Makes the button fill its parent width.\nUseful in narrow layouts where the button should span the available inline space.",
               "value": { "type": "boolean", "default": "false" }
             },
-            { "name": "button-class", "value": { "type": "string" } },
-            { "name": "name", "value": { "type": "string" } },
-            { "name": "value", "value": { "type": "string" } }
+            {
+              "name": "button-class",
+              "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.",
+              "value": { "type": "string" }
+            },
+            {
+              "name": "name",
+              "description": "Form control name.\nUsed when the button participates in form handling.",
+              "value": { "type": "string" }
+            },
+            {
+              "name": "value",
+              "description": "Form control value.\nUsed with `name` when the button participates in form handling. Resets to its initial value when the form is reset.",
+              "value": { "type": "string" }
+            },
+            {
+              "name": "commandfor",
+              "description": "The [commandfor HTML attribute](https://developer.mozilla.org/en-US/docs/Web/API/Invoker_Commands_API#html_attributes) for Invoker Commands.",
+              "value": { "type": "string" }
+            },
+            {
+              "name": "command",
+              "description": "The [command HTML attribute](https://developer.mozilla.org/en-US/docs/Web/API/Invoker_Commands_API#html_attributes) for Invoker Commands.",
+              "value": { "type": "string" }
+            }
           ],
           "events": [],
           "js": {
             "properties": [
-              { "name": "type", "type": "'button' | 'submit' | 'reset'" },
-              { "name": "autofocus", "type": "boolean" },
+              {
+                "name": "type",
+                "description": "Native button type.\nControls whether the internal button behaves as a regular button, submits a form, or resets a form. Defaults to `button`.",
+                "type": "'button' | 'submit' | 'reset'"
+              },
+              {
+                "name": "autofocus",
+                "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.",
+                "type": "boolean"
+              },
               {
                 "name": "variant",
+                "description": "Visual style of the button.\nDefaults to `secondary`. Use the variant that matches the action priority, risk, and placement.",
                 "type": "'negative' | 'primary' | 'secondary' | 'negativeQuiet' | 'utility' | 'quiet' | 'utilityQuiet' | 'overlay' | 'overlayInverted' | 'overlayQuiet' | 'overlayInvertedQuiet' | 'pill' | 'link'"
               },
-              { "name": "quiet", "type": "boolean" },
-              { "name": "iconOnly", "type": "boolean" },
-              { "name": "small", "type": "boolean" },
-              { "name": "loading", "type": "boolean" },
-              { "name": "href", "type": "string" },
-              { "name": "target", "type": "string" },
-              { "name": "disabled", "type": "boolean" },
-              { "name": "rel", "type": "string" },
-              { "name": "fullWidth", "type": "boolean" },
-              { "name": "buttonClass", "type": "string" },
-              { "name": "name", "type": "string" },
-              { "name": "value", "type": "string" },
-              { "name": "ariaValueTextLoading" }
+              {
+                "name": "quiet",
+                "description": "Deprecated quiet visual treatment flag\nUse `variant=\"quiet\"` instead.",
+                "type": "boolean"
+              },
+              {
+                "name": "iconOnly",
+                "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.",
+                "type": "boolean"
+              },
+              {
+                "name": "small",
+                "description": "Renders the compact button size.\nUse this in dense layouts where the default button size is too large.",
+                "type": "boolean"
+              },
+              {
+                "name": "loading",
+                "description": "Shows the loading state.\nUse after the user has triggered an action and the action is in progress.",
+                "type": "boolean"
+              },
+              {
+                "name": "href",
+                "description": "URL for rendering the button as a link.\nWhen set, the component renders `w-link` instead of a native `button`.",
+                "type": "string"
+              },
+              {
+                "name": "target",
+                "description": "Link browsing context.\nPassed to the rendered link when `href` is set.",
+                "type": "string"
+              },
+              {
+                "name": "disabled",
+                "description": "Visually disables the button.\nDisabled buttons are discouraged because they can hide the reason an action is unavailable.",
+                "type": "boolean"
+              },
+              {
+                "name": "rel",
+                "description": "Link relationship.\nPassed to the rendered link when `href` is set. If `target=\"_blank\"` is set and `rel` is omitted, `noopener` is used.",
+                "type": "string"
+              },
+              {
+                "name": "fullWidth",
+                "description": "Makes the button fill its parent width.\nUseful in narrow layouts where the button should span the available inline space.",
+                "type": "boolean"
+              },
+              {
+                "name": "buttonClass",
+                "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.",
+                "type": "string"
+              },
+              {
+                "name": "name",
+                "description": "Form control name.\nUsed when the button participates in form handling.",
+                "type": "string"
+              },
+              {
+                "name": "value",
+                "description": "Form control value.\nUsed with `name` when the button participates in form handling. Resets to its initial value when the form is reset.",
+                "type": "string"
+              },
+              {
+                "name": "commandfor",
+                "description": "The [commandfor HTML attribute](https://developer.mozilla.org/en-US/docs/Web/API/Invoker_Commands_API#html_attributes) for Invoker Commands.",
+                "type": "string"
+              },
+              {
+                "name": "command",
+                "description": "The [command HTML attribute](https://developer.mozilla.org/en-US/docs/Web/API/Invoker_Commands_API#html_attributes) for Invoker Commands.",
+                "type": "string"
+              }
             ],
             "events": []
           }
@@ -1242,16 +1351,18 @@
         },
         {
           "name": "w-modal",
-          "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)\n---\n\n\n### **Events:**\n - **shown**\n- **hidden**\n\n### **Slots:**\n - **header** - Typically where you would use the `w-modal-header` component.\n- **content** - The main content of the modal.\n- **footer** - Typically where you would use the `w-modal-footer` component, for things like actions.",
+          "description": "Modals (or dialogs) display important information that users need to acknowledge.\n---\n\n\n### **Events:**\n - **shown**\n- **hidden**\n\n### **Slots:**\n - **header** - Typically where you would use the `w-modal-header` component.\n- **content** - The main content of the modal.\n- **footer** - Typically where you would use the `w-modal-footer` component, for things like actions.",
           "doc-url": "",
           "attributes": [
             {
               "name": "show",
+              "description": "Controls if the modal should show or hide.\n\nYou can also call the `open()` and `close()` methods.",
               "value": { "type": "boolean", "default": "false" }
             },
             { "name": "content-id", "value": { "type": "string" } },
             {
               "name": "ignore-backdrop-clicks",
+              "description": "Ignores clicks to the backdrop when set",
               "value": { "type": "boolean", "default": "false" }
             }
           ],
@@ -1275,12 +1386,17 @@
           ],
           "js": {
             "properties": [
-              { "name": "show", "type": "boolean" },
+              {
+                "name": "show",
+                "description": "Controls if the modal should show or hide.\n\nYou can also call the `open()` and `close()` methods.",
+                "type": "boolean"
+              },
               { "name": "contentId", "type": "string" },
-              { "name": "ignoreBackdropClicks", "type": "boolean" },
-              { "name": "dialogEl", "type": "HTMLDialogElement" },
-              { "name": "dialogInnerEl", "type": "HTMLElement" },
-              { "name": "contentEl", "type": "HTMLElement" }
+              {
+                "name": "ignoreBackdropClicks",
+                "description": "Ignores clicks to the backdrop when set",
+                "type": "boolean"
+              }
             ],
             "events": [
               { "name": "shown", "type": "CustomEvent" },
@@ -1290,7 +1406,7 @@
         },
         {
           "name": "w-modal-footer",
-          "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)\n---\n",
+          "description": "The footer section of a modal, typically where you place actions.\n---\n",
           "doc-url": "",
           "attributes": [],
           "events": [],
@@ -1298,16 +1414,22 @@
         },
         {
           "name": "w-modal-header",
-          "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)\n---\n\n\n### **Events:**\n - **backClicked**\n\n### **Slots:**\n - **top** - 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.",
+          "description": "The header section of a modal, typically where you place the title and a close button.\n---\n\n\n### **Events:**\n - **backClicked**\n\n### **Slots:**\n - **top** - 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.",
           "doc-url": "",
           "attributes": [
-            { "name": "title", "value": { "type": "string" } },
+            {
+              "name": "title",
+              "description": "A short but descriptive title for the modal",
+              "value": { "type": "string" }
+            },
             {
               "name": "back",
+              "description": "Whether the modal header should have a back button",
               "value": { "type": "boolean", "default": "false" }
             },
             {
               "name": "no-close",
+              "description": "Lets you hide the close button in the header",
               "value": { "type": "boolean", "default": "false" }
             }
           ],
@@ -1320,31 +1442,39 @@
           "events": [{ "name": "backClicked", "type": "CustomEvent" }],
           "js": {
             "properties": [
-              { "name": "title", "type": "string" },
-              { "name": "back", "type": "boolean" },
-              { "name": "noClose", "type": "boolean" },
-              { "name": "titleEl", "type": "HTMLElement" },
-              { "name": "titleClasses" },
-              { "name": "backButton" },
-              { "name": "closeButton" }
+              {
+                "name": "title",
+                "description": "A short but descriptive title for the modal",
+                "type": "string"
+              },
+              {
+                "name": "back",
+                "description": "Whether the modal header should have a back button",
+                "type": "boolean"
+              },
+              {
+                "name": "noClose",
+                "description": "Lets you hide the close button in the header",
+                "type": "boolean"
+              }
             ],
             "events": [{ "name": "backClicked", "type": "CustomEvent" }]
           }
         },
         {
           "name": "w-page-indicator",
-          "description": "A page indicator component that displays a series of dots representing pages.\nOne dot is highlighted to indicate the currently selected page.\n---\n",
+          "description": "A page indicator component that displays a series of dots representing pages.\n\nOne dot is highlighted to indicate the currently selected page.\n---\n",
           "doc-url": "",
           "attributes": [
             {
               "name": "selected-page",
-              "description": "Currently selected page (1-based index, clamped to valid range)",
-              "value": { "type": "number" }
+              "description": "Currently selected page (1-based index)",
+              "value": { "type": "number", "default": "1" }
             },
             {
               "name": "page-count",
-              "description": "Total number of pages (minimum 1)",
-              "value": { "type": "number" }
+              "description": "Total number of pages",
+              "value": { "type": "number", "default": "1" }
             }
           ],
           "events": [],
@@ -1352,12 +1482,12 @@
             "properties": [
               {
                 "name": "selectedPage",
-                "description": "Currently selected page (1-based index, clamped to valid range)",
+                "description": "Currently selected page (1-based index)",
                 "type": "number"
               },
               {
                 "name": "pageCount",
-                "description": "Total number of pages (minimum 1)",
+                "description": "Total number of pages",
                 "type": "number"
               }
             ],
@@ -1366,73 +1496,145 @@
         },
         {
           "name": "w-pagination",
-          "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)\n---\n\n\n### **Events:**\n - **page-click** - Triggered when a link button in the pagination is clicked. Contains the page number in `string` form.",
+          "description": "Pagination allows users to navigate through multiple pages of content by providing navigation controls with page numbers and directional arrows.\n---\n\n\n### **Events:**\n - **page-click** - Triggered when a link in the pagination is clicked. Contains the page number in `string` form.",
           "doc-url": "",
           "attributes": [
-            { "name": "base-url", "value": { "type": "string" } },
-            { "name": "pages", "value": { "type": "number" } },
-            { "name": "current-page", "value": { "type": "number" } },
-            { "name": "visible-pages", "value": { "type": "number" } }
+            {
+              "name": "base-url",
+              "description": "The base URL used to construct page links, for example `/search?page=`.\n\nThe page number is appended to this URL.",
+              "value": { "type": "string" }
+            },
+            {
+              "name": "pages",
+              "description": "The total number of pages.",
+              "value": { "type": "number" }
+            },
+            {
+              "name": "current-page",
+              "description": "The currently active page number.",
+              "value": { "type": "number", "default": "1" }
+            },
+            {
+              "name": "visible-pages",
+              "description": "The maximum number of page numbers visible.",
+              "value": { "type": "number", "default": "7" }
+            }
           ],
           "events": [
             {
               "name": "page-click",
               "type": "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."
             }
           ],
           "js": {
             "properties": [
-              { "name": "baseUrl", "type": "string" },
-              { "name": "pages", "type": "number" },
-              { "name": "currentPageNumber", "type": "number" },
-              { "name": "visiblePages", "type": "number" }
+              {
+                "name": "baseUrl",
+                "description": "The base URL used to construct page links, for example `/search?page=`.\n\nThe page number is appended to this URL.",
+                "type": "string"
+              },
+              {
+                "name": "pages",
+                "description": "The total number of pages.",
+                "type": "number"
+              },
+              {
+                "name": "currentPageNumber",
+                "description": "The currently active page number.",
+                "type": "number"
+              },
+              {
+                "name": "visiblePages",
+                "description": "The maximum number of page numbers visible.",
+                "type": "number"
+              }
             ],
             "events": [
               {
                 "name": "page-click",
                 "type": "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."
               }
             ]
           }
         },
         {
           "name": "w-pill",
-          "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)\n---\n\n\n### **Events:**\n - **w-pill-click**\n- **w-pill-close**",
+          "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\n\n### **Events:**\n - **w-pill-click** - Fires when the pill itself is clicked.\n- **w-pill-close** - Fires when the pill's close button is clicked.",
           "doc-url": "",
           "attributes": [
             {
               "name": "can-close",
+              "description": "Whether the pill should be removable via a close button.",
               "value": { "type": "boolean", "default": "false" }
             },
             {
               "name": "suggestion",
+              "description": "Whether the pill should be rendered as a suggestion.",
               "value": { "type": "boolean", "default": "false" }
             },
             { "name": "open-sr-label", "value": { "type": "string" } },
-            { "name": "open-aria-label", "value": { "type": "string" } },
+            {
+              "name": "open-aria-label",
+              "description": "Label read by screen readers when targeting the pill.",
+              "value": { "type": "string" }
+            },
             { "name": "close-sr-label", "value": { "type": "string" } },
-            { "name": "close-aria-label", "value": { "type": "string" } }
+            {
+              "name": "close-aria-label",
+              "description": "Label read by screen readers when targeting the close button.",
+              "value": { "type": "string" }
+            }
           ],
           "events": [
-            { "name": "w-pill-click", "type": "CustomEvent" },
-            { "name": "w-pill-close", "type": "CustomEvent" }
+            {
+              "name": "w-pill-click",
+              "type": "CustomEvent",
+              "description": "Fires when the pill itself is clicked."
+            },
+            {
+              "name": "w-pill-close",
+              "type": "CustomEvent",
+              "description": "Fires when the pill's close button is clicked."
+            }
           ],
           "js": {
             "properties": [
-              { "name": "canClose", "type": "boolean" },
-              { "name": "suggestion", "type": "boolean" },
+              {
+                "name": "canClose",
+                "description": "Whether the pill should be removable via a close button.",
+                "type": "boolean"
+              },
+              {
+                "name": "suggestion",
+                "description": "Whether the pill should be rendered as a suggestion.",
+                "type": "boolean"
+              },
               { "name": "openSrLabel", "type": "string" },
-              { "name": "openAriaLabel", "type": "string" },
+              {
+                "name": "openAriaLabel",
+                "description": "Label read by screen readers when targeting the pill.",
+                "type": "string"
+              },
               { "name": "closeSrLabel", "type": "string" },
-              { "name": "closeAriaLabel", "type": "string" },
-              { "name": "openFilterSrText" },
-              { "name": "removeFilterSrText" }
+              {
+                "name": "closeAriaLabel",
+                "description": "Label read by screen readers when targeting the close button.",
+                "type": "string"
+              }
             ],
             "events": [
-              { "name": "w-pill-click", "type": "CustomEvent" },
-              { "name": "w-pill-close", "type": "CustomEvent" }
+              {
+                "name": "w-pill-click",
+                "type": "CustomEvent",
+                "description": "Fires when the pill itself is clicked."
+              },
+              {
+                "name": "w-pill-close",
+                "type": "CustomEvent",
+                "description": "Fires when the pill's close button is clicked."
+              }
             ]
           }
         },

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@warp-ds/elements",
   "type": "module",
-  "version": "2.9.2-next.1",
-  "packageManager": "pnpm@10.33.2",
+  "version": "2.10.0-next.1",
+  "packageManager": "pnpm@10.33.4",
   "description": "Custom elements for Warp",
   "exports": {
     ".": {
@@ -307,7 +307,7 @@
   },
   "license": "Apache-2.0",
   "devDependencies": {
-    "@biomejs/biome": "2.4.14",
+    "@biomejs/biome": "2.4.15",
     "@chbphone55/classnames": "2.0.0",
     "@custom-elements-manifest/analyzer": "^0.11.0",
     "@eik/cli": "2.0.39",
@@ -333,7 +333,7 @@
     "@storybook/react-vite": "^10.3.5",
     "@storybook/web-components": "^10.3.5",
     "@storybook/web-components-vite": "^10.3.5",
-    "@types/node": "24.12.2",
+    "@types/node": "24.12.4",
     "@types/react": "^19.2.0",
     "@types/react-dom": "^19.2.0",
     "@vitejs/plugin-react": "^6.0.1",
@@ -354,7 +354,7 @@
     "date-fns": "^4.1.0",
     "element-collapse": "1.1.0",
     "esbuild": "0.28.0",
-    "express": "4.22.1",
+    "express": "4.22.2",
     "glob": "13.0.6",
     "globals": "17.6.0",
     "html-format": "1.1.7",