@warp-ds/elements 2.9.1-next.3 → 2.9.1-next.5

package/dist/index.d.ts

@@ -657,12 +657,14 @@ Defaults to a role of `region`. Set `role="none"` to override this behaviour for
 };
 
 export type WarpBreadcrumbsProps = {
-  /**  */
+  /** Accessible label for the breadcrumb navigation.
+Defaults to the localized "You are here" label. Set `aria-label` when the default label is not specific enough for the page. */
   ariaLabel?: WarpBreadcrumbs["ariaLabel"];
 };
 
 export type WarpBreadcrumbsSolidJsProps = {
-  /**  */
+  /** Accessible label for the breadcrumb navigation.
+Defaults to the localized "You are here" label. Set `aria-label` when the default label is not specific enough for the page. */
   "prop:ariaLabel"?: WarpBreadcrumbs["ariaLabel"];
 
   /** Set the innerHTML of the element */
@@ -1489,45 +1491,45 @@ export type WarpSelectSolidJsProps = {
 };
 
 export type WarpSliderThumbProps = {
-  /**  */
+  /** Label for the range input. */
   "aria-label"?: WarpSliderThumb["ariaLabel"];
-  /**  */
+  /** Label for the range input. */
   ariaLabel?: WarpSliderThumb["ariaLabel"];
-  /**  */
+  /** Contextual information for assistive technology, should it be needed */
   "aria-description"?: WarpSliderThumb["ariaDescription"];
-  /**  */
+  /** Contextual information for assistive technology, should it be needed */
   ariaDescription?: WarpSliderThumb["ariaDescription"];
-  /**  */
+  /** The name of this input field in the form. The canonical source of the value is the text field. */
   name?: WarpSliderThumb["name"];
-  /**  */
+  /** The initial value, if any */
   value?: WarpSliderThumb["value"];
-  /**  */
+  /** Placeholder in empty text fields */
   placeholder?: WarpSliderThumb["placeholder"];
 
-  /**  */
+  /** Internal event used by (and stopped by) `w-slider`. */
   onthumbreset?: (e: CustomEvent) => void;
-  /**  */
+  /** Internal event used by (and stopped by) `w-slider`. */
   onslidervalidity?: (e: CustomEvent) => void;
 };
 
 export type WarpSliderThumbSolidJsProps = {
-  /**  */
+  /** Label for the range input. */
   "attr:aria-label"?: WarpSliderThumb["ariaLabel"];
-  /**  */
+  /** Label for the range input. */
   "prop:ariaLabel"?: WarpSliderThumb["ariaLabel"];
-  /**  */
+  /** Contextual information for assistive technology, should it be needed */
   "attr:aria-description"?: WarpSliderThumb["ariaDescription"];
-  /**  */
+  /** Contextual information for assistive technology, should it be needed */
   "prop:ariaDescription"?: WarpSliderThumb["ariaDescription"];
-  /**  */
+  /** The name of this input field in the form. The canonical source of the value is the text field. */
   "prop:name"?: WarpSliderThumb["name"];
-  /**  */
+  /** The initial value, if any */
   "prop:value"?: WarpSliderThumb["value"];
-  /**  */
+  /** Placeholder in empty text fields */
   "prop:placeholder"?: WarpSliderThumb["placeholder"];
-  /**  */
+  /** Internal event used by (and stopped by) `w-slider`. */
   "on:thumbreset"?: (e: CustomEvent) => void;
-  /**  */
+  /** Internal event used by (and stopped by) `w-slider`. */
   "on:slidervalidity"?: (e: CustomEvent) => void;
 
   /** Set the innerHTML of the element */
@@ -1547,46 +1549,38 @@ If you need to display HTML, use the `label` slot instead (f. ex. `<legend class
   "open-ended"?: WarpSlider["openEnded"];
   /** Whether or not to allow values outside the range such as "Before 1950" and "2025+". */
   openEnded?: WarpSlider["openEnded"];
-  /**  */
+  /** Validation error text, if any */
   error?: WarpSlider["error"];
-  /**  */
+  /** Additional description to show below the fieldset */
   "help-text"?: WarpSlider["helpText"];
-  /**  */
+  /** Additional description to show below the fieldset */
   helpText?: WarpSlider["helpText"];
-  /**  */
+  /** Sets the form fields and fieldset in an invalid state */
   invalid?: WarpSlider["invalid"];
-  /** Ensures a child slider thumb has a value before allowing the containing form to submit. */
+  /** Ensures a child slider thumb has a value before allowing the containing form to submit */
   required?: WarpSlider["required"];
-  /**  */
+  /** The minimum allowed value in the range inputs */
   min?: WarpSlider["min"];
-  /**  */
+  /** The maximum allowed value in the range inputs */
   max?: WarpSlider["max"];
   /** Pass a value similar to step to create visual markers at that interval */
   markers?: WarpSlider["markers"];
-  /**  */
+  /** ets step on the range input to jump between values when dragging */
   step?: WarpSlider["step"];
-  /** Suffix used in text input fields and for the min and max values of the slider. */
+  /** Suffix used in text input fields and for the min and max values of the slider */
   suffix?: WarpSlider["suffix"];
-  /**  */
+  /** Should only be used in special cases */
   "hidden-textfield"?: WarpSlider["hiddenTextfield"];
-  /**  */
+  /** Should only be used in special cases */
   hiddenTextfield?: WarpSlider["hiddenTextfield"];
-  /** Formatter for the tooltip and input mask values. */
+  /** Formatter for the tooltip and input mask values */
   valueFormatter?: WarpSlider["valueFormatter"];
-  /** Replaces valueFormatter for the tooltip. Use in open-ended sliders to show for example "300+ hk" instead of "Max" in the tooltip. */
+  /** Overrides valueFormatter for the tooltip.
+
+Use in open-ended sliders to show for example "300+ hk" instead of "Max" in the tooltip. */
   tooltipFormatter?: WarpSlider["tooltipFormatter"];
   /** Formatter for the min and max labels below the range. */
   labelFormatter?: WarpSlider["labelFormatter"];
-  /**  */
-  fieldset?: WarpSlider["fieldset"];
-  /**  */
-  _invalidMessage?: WarpSlider["_invalidMessage"];
-  /**  */
-  _hasInternalError?: WarpSlider["_hasInternalError"];
-  /**  */
-  _showError?: WarpSlider["_showError"];
-  /**  */
-  _tabbableElements?: WarpSlider["_tabbableElements"];
 };
 
 export type WarpSliderSolidJsProps = {
@@ -1600,46 +1594,38 @@ If you need to display HTML, use the `label` slot instead (f. ex. `<legend class
   "bool:open-ended"?: WarpSlider["openEnded"];
   /** Whether or not to allow values outside the range such as "Before 1950" and "2025+". */
   "prop:openEnded"?: WarpSlider["openEnded"];
-  /**  */
+  /** Validation error text, if any */
   "prop:error"?: WarpSlider["error"];
-  /**  */
+  /** Additional description to show below the fieldset */
   "attr:help-text"?: WarpSlider["helpText"];
-  /**  */
+  /** Additional description to show below the fieldset */
   "prop:helpText"?: WarpSlider["helpText"];
-  /**  */
+  /** Sets the form fields and fieldset in an invalid state */
   "prop:invalid"?: WarpSlider["invalid"];
-  /** Ensures a child slider thumb has a value before allowing the containing form to submit. */
+  /** Ensures a child slider thumb has a value before allowing the containing form to submit */
   "prop:required"?: WarpSlider["required"];
-  /**  */
+  /** The minimum allowed value in the range inputs */
   "prop:min"?: WarpSlider["min"];
-  /**  */
+  /** The maximum allowed value in the range inputs */
   "prop:max"?: WarpSlider["max"];
   /** Pass a value similar to step to create visual markers at that interval */
   "prop:markers"?: WarpSlider["markers"];
-  /**  */
+  /** ets step on the range input to jump between values when dragging */
   "prop:step"?: WarpSlider["step"];
-  /** Suffix used in text input fields and for the min and max values of the slider. */
+  /** Suffix used in text input fields and for the min and max values of the slider */
   "prop:suffix"?: WarpSlider["suffix"];
-  /**  */
+  /** Should only be used in special cases */
   "bool:hidden-textfield"?: WarpSlider["hiddenTextfield"];
-  /**  */
+  /** Should only be used in special cases */
   "prop:hiddenTextfield"?: WarpSlider["hiddenTextfield"];
-  /** Formatter for the tooltip and input mask values. */
+  /** Formatter for the tooltip and input mask values */
   "prop:valueFormatter"?: WarpSlider["valueFormatter"];
-  /** Replaces valueFormatter for the tooltip. Use in open-ended sliders to show for example "300+ hk" instead of "Max" in the tooltip. */
+  /** Overrides valueFormatter for the tooltip.
+
+Use in open-ended sliders to show for example "300+ hk" instead of "Max" in the tooltip. */
   "prop:tooltipFormatter"?: WarpSlider["tooltipFormatter"];
   /** Formatter for the min and max labels below the range. */
   "prop:labelFormatter"?: WarpSlider["labelFormatter"];
-  /**  */
-  "prop:fieldset"?: WarpSlider["fieldset"];
-  /**  */
-  "prop:_invalidMessage"?: WarpSlider["_invalidMessage"];
-  /**  */
-  "prop:_hasInternalError"?: WarpSlider["_hasInternalError"];
-  /**  */
-  "prop:_showError"?: WarpSlider["_showError"];
-  /**  */
-  "prop:_tabbableElements"?: WarpSlider["_tabbableElements"];
 
   /** Set the innerHTML of the element */
   innerHTML?: string;
@@ -1718,45 +1704,17 @@ export type WarpSwitchSolidJsProps = {
 };
 
 export type WarpTabProps = {
-  /**  */
-  id?: WarpTab["id"];
-  /**  */
+  /** The `id` of the `<w-tab-panel>` this tab controls. */
   for?: WarpTab["for"];
-  /**  */
-  "aria-controls"?: WarpTab["_ariaControlsAttr"];
-  /**  */
-  _ariaControlsAttr?: WarpTab["_ariaControlsAttr"];
-  /**  */
-  "aria-selected"?: WarpTab["ariaSelected"];
-  /**  */
-  ariaSelected?: WarpTab["ariaSelected"];
-  /** @deprecated Use `aria-selected="true"` instead  */
-  active?: WarpTab["active"];
-  /**  */
+  /** Whether to show the `icon` slot over the tab title instead of inline. */
   over?: WarpTab["over"];
-  /** Override tabIndex setter to set _parentTabIndex (for backwards compatibility). */
-  tabIndex?: WarpTab["tabIndex"];
 };
 
 export type WarpTabSolidJsProps = {
-  /**  */
-  "prop:id"?: WarpTab["id"];
-  /**  */
+  /** The `id` of the `<w-tab-panel>` this tab controls. */
   "prop:for"?: WarpTab["for"];
-  /**  */
-  "attr:aria-controls"?: WarpTab["_ariaControlsAttr"];
-  /**  */
-  "prop:_ariaControlsAttr"?: WarpTab["_ariaControlsAttr"];
-  /**  */
-  "attr:aria-selected"?: WarpTab["ariaSelected"];
-  /**  */
-  "prop:ariaSelected"?: WarpTab["ariaSelected"];
-  /** @deprecated Use `aria-selected="true"` instead  */
-  "prop:active"?: WarpTab["active"];
-  /**  */
+  /** Whether to show the `icon` slot over the tab title instead of inline. */
   "prop:over"?: WarpTab["over"];
-  /** Override tabIndex setter to set _parentTabIndex (for backwards compatibility). */
-  "prop:tabIndex"?: WarpTab["tabIndex"];
 
   /** Set the innerHTML of the element */
   innerHTML?: string;
@@ -1765,15 +1723,13 @@ export type WarpTabSolidJsProps = {
 };
 
 export type WarpTabPanelProps = {
-  /** Whether this panel is active (visible).
-Set by parent w-tabs via the _parentActive property. */
-  active?: WarpTabPanel["active"];
+  /** Required so `<w-tab>` has something to target. */
+  id?: WarpTabPanel["id"];
 };
 
 export type WarpTabPanelSolidJsProps = {
-  /** Whether this panel is active (visible).
-Set by parent w-tabs via the _parentActive property. */
-  "prop:active"?: WarpTabPanel["active"];
+  /** Required so `<w-tab>` has something to target. */
+  "prop:id"?: WarpTabPanel["id"];
 
   /** Set the innerHTML of the element */
   innerHTML?: string;
@@ -1782,18 +1738,18 @@ Set by parent w-tabs via the _parentActive property. */
 };
 
 export type WarpTabsProps = {
-  /**  */
+  /** The `id` of the panel that should be active. */
   active?: WarpTabs["active"];
 
-  /**  */
-  onchange?: (e: CustomEvent) => void;
+  /** Includes `details.panelId` with the now active tab's ID */
+  onchange?: (e: WarpTabsChangeEvent) => void;
 };
 
 export type WarpTabsSolidJsProps = {
-  /**  */
+  /** The `id` of the panel that should be active. */
   "prop:active"?: WarpTabs["active"];
-  /**  */
-  "on:change"?: (e: CustomEvent) => void;
+  /** Includes `details.panelId` with the now active tab's ID */
+  "on:change"?: (e: WarpTabsChangeEvent) => void;
 
   /** Set the innerHTML of the element */
   innerHTML?: string;
@@ -2168,7 +2124,8 @@ export type CustomElements = {
   "w-box": Partial<WarpBoxProps & BaseProps<WarpBox> & BaseEvents>;
 
   /**
-   * Breadcrumbs show the navigation structure for the current location.
+   * Shows the navigation structure for the current page.
+   * Renders direct child links and non-link elements as a breadcrumb trail, inserts separators between items, and exposes the trail as navigation.
    *
    * [See Storybook for usage examples](https://warp-ds.github.io/elements/?path=/docs/navigation-breadcrumbs--docs)
    *
@@ -2176,7 +2133,8 @@ export type CustomElements = {
    *
    * Component attributes and properties that can be applied to the element or by using JavaScript.
    *
-   * - `ariaLabel`: undefined (property only)
+   * - `ariaLabel`: Accessible label for the breadcrumb navigation.
+   * Defaults to the localized "You are here" label. Set `aria-label` when the default label is not specific enough for the page. (property only)
    */
   "w-breadcrumbs": Partial<
     WarpBreadcrumbsProps & BaseProps<WarpBreadcrumbs> & BaseEvents
@@ -2658,28 +2616,22 @@ export type CustomElements = {
   /**
    * Component to place inside a `<w-slider>`.
    *
-   * [See Storybook for usage examples](https://warp-ds.github.io/elements/?path=/docs/forms-slider-and-range-slider--docs)
-   *
    * ## Attributes & Properties
    *
    * Component attributes and properties that can be applied to the element or by using JavaScript.
    *
-   * - `aria-label`/`ariaLabel`: undefined
-   * - `aria-description`/`ariaDescription`: undefined
-   * - `name`: undefined
-   * - `value`: undefined
-   * - `placeholder`: undefined
-   * - `boundaryValue`: undefined (property only) (readonly)
-   * - `textFieldDisplayValue`: Value to display in the textfield (shows boundary when focused on empty value) (property only) (readonly)
-   * - `tooltipDisplayValue`: Value to display in the tooltip (property only) (readonly)
-   * - `ariaDescriptionText`: undefined (property only) (readonly)
+   * - `aria-label`/`ariaLabel`: Label for the range input.
+   * - `aria-description`/`ariaDescription`: Contextual information for assistive technology, should it be needed
+   * - `name`: The name of this input field in the form. The canonical source of the value is the text field.
+   * - `value`: The initial value, if any
+   * - `placeholder`: Placeholder in empty text fields
    *
    * ## Events
    *
    * Events that will be emitted by the component.
    *
-   * - `thumbreset`: undefined
-   * - `slidervalidity`: undefined
+   * - `thumbreset`: Internal event used by (and stopped by) `w-slider`.
+   * - `slidervalidity`: Internal event used by (and stopped by) `w-slider`.
    *
    * ## Methods
    *
@@ -2695,8 +2647,6 @@ export type CustomElements = {
   /**
    * Parent component for sliders (both single and range sliders). Used in combination with a `<w-slider-thumb>`.
    *
-   * [See Storybook for usage examples](https://warp-ds.github.io/elements/?path=/docs/forms-slider-and-range-slider--docs)
-   *
    * ## Attributes & Properties
    *
    * Component attributes and properties that can be applied to the element or by using JavaScript.
@@ -2706,28 +2656,21 @@ export type CustomElements = {
    * If you need to display HTML, use the `label` slot instead (f. ex. `<legend class="sr-only" slot="label">Production year</legend>`)
    * - `disabled`: undefined
    * - `open-ended`/`openEnded`: Whether or not to allow values outside the range such as "Before 1950" and "2025+".
-   * - `error`: undefined
-   * - `help-text`/`helpText`: undefined
-   * - `invalid`: undefined
-   * - `required`: Ensures a child slider thumb has a value before allowing the containing form to submit.
-   * - `min`: undefined
-   * - `max`: undefined
+   * - `error`: Validation error text, if any
+   * - `help-text`/`helpText`: Additional description to show below the fieldset
+   * - `invalid`: Sets the form fields and fieldset in an invalid state
+   * - `required`: Ensures a child slider thumb has a value before allowing the containing form to submit
+   * - `min`: The minimum allowed value in the range inputs
+   * - `max`: The maximum allowed value in the range inputs
    * - `markers`: Pass a value similar to step to create visual markers at that interval
-   * - `step`: undefined
-   * - `suffix`: Suffix used in text input fields and for the min and max values of the slider.
-   * - `hidden-textfield`/`hiddenTextfield`: undefined
-   * - `valueFormatter`: Formatter for the tooltip and input mask values. (property only)
-   * - `tooltipFormatter`: Replaces valueFormatter for the tooltip. Use in open-ended sliders to show for example "300+ hk" instead of "Max" in the tooltip. (property only)
+   * - `step`: ets step on the range input to jump between values when dragging
+   * - `suffix`: Suffix used in text input fields and for the min and max values of the slider
+   * - `hidden-textfield`/`hiddenTextfield`: Should only be used in special cases
+   * - `valueFormatter`: Formatter for the tooltip and input mask values (property only)
+   * - `tooltipFormatter`: Overrides valueFormatter for the tooltip.
+   *
+   * Use in open-ended sliders to show for example "300+ hk" instead of "Max" in the tooltip. (property only)
    * - `labelFormatter`: Formatter for the min and max labels below the range. (property only)
-   * - `fieldset`: undefined (property only)
-   * - `_invalidMessage`: undefined (property only)
-   * - `_hasInternalError`: undefined (property only)
-   * - `_showError`: undefined (property only)
-   * - `_tabbableElements`: undefined (property only)
-   * - `edgeMin`: undefined (property only) (readonly)
-   * - `edgeMax`: undefined (property only) (readonly)
-   * - `componentHasError`: undefined (property only) (readonly)
-   * - `errorText`: undefined (property only) (readonly)
    *
    * ## Slots
    *
@@ -2811,20 +2754,12 @@ export type CustomElements = {
   /**
    * Individual tab component used within w-tabs container.
    *
-   * [See Storybook for usage examples](https://warp-ds.github.io/elements/?path=/docs/tabs--docs)
-   *
    * ## Attributes & Properties
    *
    * Component attributes and properties that can be applied to the element or by using JavaScript.
    *
-   * - `id`: undefined
-   * - `for`: undefined
-   * - `aria-controls`/`_ariaControlsAttr`: undefined
-   * - `aria-selected`/`ariaSelected`: undefined
-   * - `active`: undefined
-   * - `over`: undefined
-   * - `tabIndex`: Override tabIndex setter to set _parentTabIndex (for backwards compatibility). (property only)
-   * - `_computedAriaSelected`: Computed aria-selected: prefers parent-managed, falls back to own property (property only) (readonly)
+   * - `for`: The `id` of the `<w-tab-panel>` this tab controls.
+   * - `over`: Whether to show the `icon` slot over the tab title instead of inline.
    */
   "w-tab": Partial<WarpTabProps & BaseProps<WarpTab> & BaseEvents>;
 
@@ -2832,14 +2767,11 @@ export type CustomElements = {
    * Tab panel component that holds content for individual tabs.
    * Each tab panel should have a name that matches a corresponding tab.
    *
-   * [See Storybook for usage examples](https://warp-ds.github.io/elements/?path=/docs/tabs--docs)
-   *
    * ## Attributes & Properties
    *
    * Component attributes and properties that can be applied to the element or by using JavaScript.
    *
-   * - `active`: Whether this panel is active (visible).
-   * Set by parent w-tabs via the _parentActive property.
+   * - `id`: Required so `<w-tab>` has something to target.
    */
   "w-tab-panel": Partial<
     WarpTabPanelProps & BaseProps<WarpTabPanel> & BaseEvents
@@ -2848,21 +2780,17 @@ export type CustomElements = {
   /**
    * Tabs are used to organize content by grouping similar information on the same page.
    *
-   * [See Storybook for usage examples](https://warp-ds.github.io/elements/?path=/docs/tabs--docs)
-   *
    * ## Attributes & Properties
    *
    * Component attributes and properties that can be applied to the element or by using JavaScript.
    *
-   * - `active`: undefined
-   * - `tabs`: undefined (property only) (readonly)
-   * - `activeTab`: undefined (property only) (readonly)
+   * - `active`: The `id` of the panel that should be active.
    *
    * ## Events
    *
    * Events that will be emitted by the component.
    *
-   * - `change`: undefined
+   * - `change`: Includes `details.panelId` with the now active tab's ID
    */
   "w-tabs": Partial<WarpTabsProps & BaseProps<WarpTabs> & BaseEvents>;
 
@@ -3210,7 +3138,8 @@ export type CustomElementsSolidJs = {
   >;
 
   /**
-   * Breadcrumbs show the navigation structure for the current location.
+   * Shows the navigation structure for the current page.
+   * Renders direct child links and non-link elements as a breadcrumb trail, inserts separators between items, and exposes the trail as navigation.
    *
    * [See Storybook for usage examples](https://warp-ds.github.io/elements/?path=/docs/navigation-breadcrumbs--docs)
    *
@@ -3218,7 +3147,8 @@ export type CustomElementsSolidJs = {
    *
    * Component attributes and properties that can be applied to the element or by using JavaScript.
    *
-   * - `ariaLabel`: undefined (property only)
+   * - `ariaLabel`: Accessible label for the breadcrumb navigation.
+   * Defaults to the localized "You are here" label. Set `aria-label` when the default label is not specific enough for the page. (property only)
    */
   "w-breadcrumbs": Partial<
     WarpBreadcrumbsProps &
@@ -3745,28 +3675,22 @@ export type CustomElementsSolidJs = {
   /**
    * Component to place inside a `<w-slider>`.
    *
-   * [See Storybook for usage examples](https://warp-ds.github.io/elements/?path=/docs/forms-slider-and-range-slider--docs)
-   *
    * ## Attributes & Properties
    *
    * Component attributes and properties that can be applied to the element or by using JavaScript.
    *
-   * - `aria-label`/`ariaLabel`: undefined
-   * - `aria-description`/`ariaDescription`: undefined
-   * - `name`: undefined
-   * - `value`: undefined
-   * - `placeholder`: undefined
-   * - `boundaryValue`: undefined (property only) (readonly)
-   * - `textFieldDisplayValue`: Value to display in the textfield (shows boundary when focused on empty value) (property only) (readonly)
-   * - `tooltipDisplayValue`: Value to display in the tooltip (property only) (readonly)
-   * - `ariaDescriptionText`: undefined (property only) (readonly)
+   * - `aria-label`/`ariaLabel`: Label for the range input.
+   * - `aria-description`/`ariaDescription`: Contextual information for assistive technology, should it be needed
+   * - `name`: The name of this input field in the form. The canonical source of the value is the text field.
+   * - `value`: The initial value, if any
+   * - `placeholder`: Placeholder in empty text fields
    *
    * ## Events
    *
    * Events that will be emitted by the component.
    *
-   * - `thumbreset`: undefined
-   * - `slidervalidity`: undefined
+   * - `thumbreset`: Internal event used by (and stopped by) `w-slider`.
+   * - `slidervalidity`: Internal event used by (and stopped by) `w-slider`.
    *
    * ## Methods
    *
@@ -3785,8 +3709,6 @@ export type CustomElementsSolidJs = {
   /**
    * Parent component for sliders (both single and range sliders). Used in combination with a `<w-slider-thumb>`.
    *
-   * [See Storybook for usage examples](https://warp-ds.github.io/elements/?path=/docs/forms-slider-and-range-slider--docs)
-   *
    * ## Attributes & Properties
    *
    * Component attributes and properties that can be applied to the element or by using JavaScript.
@@ -3796,28 +3718,21 @@ export type CustomElementsSolidJs = {
    * If you need to display HTML, use the `label` slot instead (f. ex. `<legend class="sr-only" slot="label">Production year</legend>`)
    * - `disabled`: undefined
    * - `open-ended`/`openEnded`: Whether or not to allow values outside the range such as "Before 1950" and "2025+".
-   * - `error`: undefined
-   * - `help-text`/`helpText`: undefined
-   * - `invalid`: undefined
-   * - `required`: Ensures a child slider thumb has a value before allowing the containing form to submit.
-   * - `min`: undefined
-   * - `max`: undefined
+   * - `error`: Validation error text, if any
+   * - `help-text`/`helpText`: Additional description to show below the fieldset
+   * - `invalid`: Sets the form fields and fieldset in an invalid state
+   * - `required`: Ensures a child slider thumb has a value before allowing the containing form to submit
+   * - `min`: The minimum allowed value in the range inputs
+   * - `max`: The maximum allowed value in the range inputs
    * - `markers`: Pass a value similar to step to create visual markers at that interval
-   * - `step`: undefined
-   * - `suffix`: Suffix used in text input fields and for the min and max values of the slider.
-   * - `hidden-textfield`/`hiddenTextfield`: undefined
-   * - `valueFormatter`: Formatter for the tooltip and input mask values. (property only)
-   * - `tooltipFormatter`: Replaces valueFormatter for the tooltip. Use in open-ended sliders to show for example "300+ hk" instead of "Max" in the tooltip. (property only)
+   * - `step`: ets step on the range input to jump between values when dragging
+   * - `suffix`: Suffix used in text input fields and for the min and max values of the slider
+   * - `hidden-textfield`/`hiddenTextfield`: Should only be used in special cases
+   * - `valueFormatter`: Formatter for the tooltip and input mask values (property only)
+   * - `tooltipFormatter`: Overrides valueFormatter for the tooltip.
+   *
+   * Use in open-ended sliders to show for example "300+ hk" instead of "Max" in the tooltip. (property only)
    * - `labelFormatter`: Formatter for the min and max labels below the range. (property only)
-   * - `fieldset`: undefined (property only)
-   * - `_invalidMessage`: undefined (property only)
-   * - `_hasInternalError`: undefined (property only)
-   * - `_showError`: undefined (property only)
-   * - `_tabbableElements`: undefined (property only)
-   * - `edgeMin`: undefined (property only) (readonly)
-   * - `edgeMax`: undefined (property only) (readonly)
-   * - `componentHasError`: undefined (property only) (readonly)
-   * - `errorText`: undefined (property only) (readonly)
    *
    * ## Slots
    *
@@ -3916,20 +3831,12 @@ export type CustomElementsSolidJs = {
   /**
    * Individual tab component used within w-tabs container.
    *
-   * [See Storybook for usage examples](https://warp-ds.github.io/elements/?path=/docs/tabs--docs)
-   *
    * ## Attributes & Properties
    *
    * Component attributes and properties that can be applied to the element or by using JavaScript.
    *
-   * - `id`: undefined
-   * - `for`: undefined
-   * - `aria-controls`/`_ariaControlsAttr`: undefined
-   * - `aria-selected`/`ariaSelected`: undefined
-   * - `active`: undefined
-   * - `over`: undefined
-   * - `tabIndex`: Override tabIndex setter to set _parentTabIndex (for backwards compatibility). (property only)
-   * - `_computedAriaSelected`: Computed aria-selected: prefers parent-managed, falls back to own property (property only) (readonly)
+   * - `for`: The `id` of the `<w-tab-panel>` this tab controls.
+   * - `over`: Whether to show the `icon` slot over the tab title instead of inline.
    */
   "w-tab": Partial<
     WarpTabProps & WarpTabSolidJsProps & BaseProps<WarpTab> & BaseEvents
@@ -3939,14 +3846,11 @@ export type CustomElementsSolidJs = {
    * Tab panel component that holds content for individual tabs.
    * Each tab panel should have a name that matches a corresponding tab.
    *
-   * [See Storybook for usage examples](https://warp-ds.github.io/elements/?path=/docs/tabs--docs)
-   *
    * ## Attributes & Properties
    *
    * Component attributes and properties that can be applied to the element or by using JavaScript.
    *
-   * - `active`: Whether this panel is active (visible).
-   * Set by parent w-tabs via the _parentActive property.
+   * - `id`: Required so `<w-tab>` has something to target.
    */
   "w-tab-panel": Partial<
     WarpTabPanelProps &
@@ -3958,21 +3862,17 @@ export type CustomElementsSolidJs = {
   /**
    * Tabs are used to organize content by grouping similar information on the same page.
    *
-   * [See Storybook for usage examples](https://warp-ds.github.io/elements/?path=/docs/tabs--docs)
-   *
    * ## Attributes & Properties
    *
    * Component attributes and properties that can be applied to the element or by using JavaScript.
    *
-   * - `active`: undefined
-   * - `tabs`: undefined (property only) (readonly)
-   * - `activeTab`: undefined (property only) (readonly)
+   * - `active`: The `id` of the panel that should be active.
    *
    * ## Events
    *
    * Events that will be emitted by the component.
    *
-   * - `change`: undefined
+   * - `change`: Includes `details.panelId` with the now active tab's ID
    */
   "w-tabs": Partial<
     WarpTabsProps & WarpTabsSolidJsProps & BaseProps<WarpTabs> & BaseEvents

package/dist/packages/breadcrumbs/breadcrumbs.d.ts

@@ -1,11 +1,17 @@
 import { LitElement, TemplateResult } from 'lit';
 /**
- * Breadcrumbs show the navigation structure for the current location.
+ * Shows the navigation structure for the current page.
+ * Renders direct child links and non-link elements as a breadcrumb trail, inserts separators between items, and exposes the trail as navigation.
  *
  * [See Storybook for usage examples](https://warp-ds.github.io/elements/?path=/docs/navigation-breadcrumbs--docs)
  */
 declare class WarpBreadcrumbs extends LitElement {
     private _internals;
+    /**
+     * Accessible label for the breadcrumb navigation.
+     * Defaults to the localized "You are here" label. Set `aria-label` when the default label is not specific enough for the page.
+     */
+    ariaLabel: string | null;
     static styles: import("lit").CSSResult[];
     constructor();
     /** @internal */