@warp-ds/elements 2.2.0 → 2.3.0-next.2

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.2.0-next.32",
+  "version": "2.3.0-next.1",
   "description-markup": "markdown",
   "contributions": {
     "html": {
@@ -77,6 +77,51 @@
             "events": []
           }
         },
+        {
+          "name": "w-link",
+          "description": "Buttons are used to perform actions, with different visuals for different needs.\n\n[See Storybook for usage examples](https://warp-ds.github.io/elements/?path=/docs/buttons-link--docs)\n---\n",
+          "doc-url": "",
+          "attributes": [
+            { "name": "autofocus", "value": { "type": "boolean" } },
+            {
+              "name": "variant",
+              "value": {
+                "type": "'negative' | 'primary' | 'secondary' | 'negativeQuiet' | 'utility' | 'pill' | 'link' | 'quiet' | 'utilityQuiet'",
+                "default": "'secondary'"
+              }
+            },
+            { "name": "quiet", "value": { "type": "boolean" } },
+            { "name": "small", "value": { "type": "boolean" } },
+            { "name": "href", "value": { "type": "string" } },
+            { "name": "disabled", "value": { "type": "boolean" } },
+            { "name": "target", "value": { "type": "string" } },
+            { "name": "rel", "value": { "type": "string" } },
+            { "name": "full-width", "value": { "type": "boolean" } },
+            { "name": "button-class", "value": { "type": "string" } },
+            { "name": "name", "value": { "type": "string" } }
+          ],
+          "events": [],
+          "js": {
+            "properties": [
+              { "name": "autofocus", "type": "boolean" },
+              {
+                "name": "variant",
+                "type": "'negative' | 'primary' | 'secondary' | 'negativeQuiet' | 'utility' | 'pill' | 'link' | 'quiet' | 'utilityQuiet'"
+              },
+              { "name": "quiet", "type": "boolean" },
+              { "name": "small", "type": "boolean" },
+              { "name": "href", "type": "string" },
+              { "name": "disabled", "type": "boolean" },
+              { "name": "target", "type": "string" },
+              { "name": "rel", "type": "string" },
+              { "name": "fullWidth", "type": "boolean" },
+              { "name": "buttonClass", "type": "string" },
+              { "name": "name", "type": "string" },
+              { "name": "classes", "type": "string" }
+            ],
+            "events": []
+          }
+        },
         {
           "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",
@@ -650,6 +695,653 @@
           "attributes": [],
           "events": [],
           "js": { "properties": [], "events": [] }
+        },
+        {
+          "name": "w-combobox",
+          "description": "A combobox element for text input with selectable options.\n\n[See Storybook for usage examples](https://warp-ds.github.io/elements/?path=/docs/forms-combobox--docs)\n---\n",
+          "doc-url": "",
+          "attributes": [
+            {
+              "name": "options",
+              "description": "The available options to select from",
+              "value": { "type": "ComboboxOption[]", "default": "[]" }
+            },
+            {
+              "name": "label",
+              "description": "Label above input",
+              "value": { "type": "string | undefined" }
+            },
+            {
+              "name": "placeholder",
+              "description": "Input placeholder",
+              "value": { "type": "string | undefined" }
+            },
+            {
+              "name": "value",
+              "description": "The input value",
+              "value": { "type": "string", "default": "''" }
+            },
+            {
+              "name": "open-on-focus",
+              "description": "Whether the popover opens when focus is on the text field",
+              "value": { "type": "boolean", "default": "false" }
+            },
+            {
+              "name": "select-on-blur",
+              "description": "Select active option on blur",
+              "value": { "type": "boolean", "default": "true" }
+            },
+            {
+              "name": "match-text-segments",
+              "description": "Whether the matching text segments in the options should be highlighted",
+              "value": { "type": "boolean", "default": "false" }
+            },
+            {
+              "name": "disable-static-filtering",
+              "description": "Disable client-side static filtering",
+              "value": { "type": "boolean", "default": "false" }
+            },
+            {
+              "name": "invalid",
+              "description": "Renders the input field in an invalid state",
+              "value": { "type": "boolean", "default": "false" }
+            },
+            {
+              "name": "help-text",
+              "description": "The content to display as the help text",
+              "value": { "type": "string | undefined" }
+            },
+            {
+              "name": "disabled",
+              "description": "Whether the element is disabled",
+              "value": { "type": "boolean", "default": "false" }
+            },
+            {
+              "name": "required",
+              "description": "Whether the element is required",
+              "value": { "type": "boolean", "default": "false" }
+            },
+            {
+              "name": "optional",
+              "description": "Whether to show optional text",
+              "value": { "type": "boolean", "default": "false" }
+            },
+            {
+              "name": "class-name",
+              "description": "Additional container styling",
+              "value": { "type": "string | undefined" }
+            },
+            {
+              "name": "list-class-name",
+              "description": "Additional list styling",
+              "value": { "type": "string | undefined" }
+            },
+            {
+              "name": "name",
+              "description": "Name attribute for form submission",
+              "value": { "type": "string | undefined" }
+            }
+          ],
+          "events": [],
+          "js": {
+            "properties": [
+              {
+                "name": "options",
+                "description": "The available options to select from",
+                "type": "ComboboxOption[]"
+              },
+              {
+                "name": "label",
+                "description": "Label above input",
+                "type": "string | undefined"
+              },
+              {
+                "name": "placeholder",
+                "description": "Input placeholder",
+                "type": "string | undefined"
+              },
+              {
+                "name": "value",
+                "description": "The input value",
+                "type": "string"
+              },
+              {
+                "name": "openOnFocus",
+                "description": "Whether the popover opens when focus is on the text field",
+                "type": "boolean"
+              },
+              {
+                "name": "selectOnBlur",
+                "description": "Select active option on blur",
+                "type": "boolean"
+              },
+              {
+                "name": "matchTextSegments",
+                "description": "Whether the matching text segments in the options should be highlighted",
+                "type": "boolean"
+              },
+              {
+                "name": "disableStaticFiltering",
+                "description": "Disable client-side static filtering",
+                "type": "boolean"
+              },
+              {
+                "name": "invalid",
+                "description": "Renders the input field in an invalid state",
+                "type": "boolean"
+              },
+              {
+                "name": "helpText",
+                "description": "The content to display as the help text",
+                "type": "string | undefined"
+              },
+              {
+                "name": "disabled",
+                "description": "Whether the element is disabled",
+                "type": "boolean"
+              },
+              {
+                "name": "required",
+                "description": "Whether the element is required",
+                "type": "boolean"
+              },
+              {
+                "name": "optional",
+                "description": "Whether to show optional text",
+                "type": "boolean"
+              },
+              {
+                "name": "containerClassName",
+                "description": "Additional container styling",
+                "type": "string | undefined"
+              },
+              {
+                "name": "listClassName",
+                "description": "Additional list styling",
+                "type": "string | undefined"
+              },
+              {
+                "name": "name",
+                "description": "Name attribute for form submission",
+                "type": "string | undefined"
+              }
+            ],
+            "events": []
+          }
+        },
+        {
+          "name": "w-datepicker",
+          "description": "An input for dates.\n\nUses the `lang` attribute on either the element or on `<html>` to determine the locale options.\n\n[See Storybook for usage examples](https://warp-ds.github.io/elements/?path=/docs/forms-datepicker--docs)\n---\n",
+          "doc-url": "",
+          "attributes": [
+            { "name": "label", "value": { "type": "string" } },
+            {
+              "name": "lang",
+              "description": "Takes precedence over the `<html>` lang attribute.",
+              "value": { "type": "string" }
+            },
+            { "name": "name", "value": { "type": "string" } },
+            { "name": "value", "value": { "type": "string" } },
+            {
+              "name": "header-format",
+              "description": "Decides the format of the date as shown in the calendar header.\n\nThe syntax is defined by [date-fns/format](https://date-fns.org/v4.1.0/docs/format).",
+              "value": { "type": "string", "default": "'MMMM yyyy'" }
+            },
+            {
+              "name": "weekday-format",
+              "description": "Decides the format of the weekday as shown above the grid of dates in the calendar.\n\nThe syntax is defined by [date-fns/format](https://date-fns.org/v4.1.0/docs/format).",
+              "value": { "type": "string", "default": "'EEEEEE'" }
+            },
+            {
+              "name": "day-format",
+              "description": "Decides the format of the day in the calendar as read to screen readers.\n\nThe syntax is defined by [date-fns/format](https://date-fns.org/v4.1.0/docs/format).",
+              "value": { "type": "string", "default": "'PPPP'" }
+            }
+          ],
+          "events": [],
+          "js": {
+            "properties": [
+              { "name": "label", "type": "string" },
+              {
+                "name": "lang",
+                "description": "Takes precedence over the `<html>` lang attribute.",
+                "type": "string"
+              },
+              { "name": "name", "type": "string" },
+              { "name": "value", "type": "string" },
+              {
+                "name": "headerFormat",
+                "description": "Decides the format of the date as shown in the calendar header.\n\nThe syntax is defined by [date-fns/format](https://date-fns.org/v4.1.0/docs/format).",
+                "type": "string"
+              },
+              {
+                "name": "weekdayFormat",
+                "description": "Decides the format of the weekday as shown above the grid of dates in the calendar.\n\nThe syntax is defined by [date-fns/format](https://date-fns.org/v4.1.0/docs/format).",
+                "type": "string"
+              },
+              {
+                "name": "isDayDisabled",
+                "description": "Lets you control if a date in the calendar should be disabled.\n\nThis needs to be set on the element instance in JavaScript, not as an HTML attribute.",
+                "type": "(day: Date) => boolean"
+              },
+              {
+                "name": "dayFormat",
+                "description": "Decides the format of the day in the calendar as read to screen readers.\n\nThe syntax is defined by [date-fns/format](https://date-fns.org/v4.1.0/docs/format).",
+                "type": "string"
+              },
+              { "name": "isCalendarOpen", "type": "boolean" },
+              { "name": "navigationDate", "type": "Date" },
+              { "name": "selectedDate", "type": "Date | null" },
+              { "name": "month" },
+              { "name": "weeks" },
+              { "name": "calendar", "type": "HTMLDivElement" },
+              { "name": "input", "type": "HTMLInputElement" },
+              { "name": "toggleButton", "type": "HTMLButtonElement" },
+              { "name": "wrapper", "type": "HTMLDivElement" },
+              {
+                "name": "previousMonthButton",
+                "description": "This is the first focusable element, needed for the modal focus trap.\n\nDon't cache this and other `@query` fields from inside the calendar modal.\nThey work the first time, but once the calendar is closed and reopened\nthe query will point to an element that doesn't exist anymore.",
+                "type": "HTMLButtonElement"
+              },
+              { "name": "todayCell", "type": "HTMLTableCellElement" },
+              { "name": "selectedCell", "type": "HTMLTableCellElement" }
+            ],
+            "events": []
+          }
+        },
+        {
+          "name": "w-dead-toggle",
+          "description": "Dead toggle can be used where the appearance of a checkbox or radio is needed - but for accessibility purposes an actual input element should not be present.\n\n[See Storybook for usage examples](https://warp-ds.github.io/elements/?path=/docs/forms-dead-toggle--docs)\n---\n",
+          "doc-url": "",
+          "attributes": [
+            {
+              "name": "type",
+              "value": { "type": "'radio' | 'checkbox'", "default": "'radio'" }
+            },
+            {
+              "name": "checked",
+              "value": { "type": "boolean", "default": "false" }
+            },
+            {
+              "name": "indeterminate",
+              "value": { "type": "boolean", "default": "false" }
+            },
+            {
+              "name": "invalid",
+              "value": { "type": "boolean", "default": "false" }
+            },
+            {
+              "name": "disabled",
+              "value": { "type": "boolean", "default": "false" }
+            }
+          ],
+          "events": [],
+          "js": {
+            "properties": [
+              { "name": "type", "type": "'radio' | 'checkbox'" },
+              { "name": "checked", "type": "boolean" },
+              { "name": "indeterminate", "type": "boolean" },
+              { "name": "invalid", "type": "boolean" },
+              { "name": "disabled", "type": "boolean" }
+            ],
+            "events": []
+          }
+        },
+        {
+          "name": "w-pageindicator",
+          "description": "\n---\n",
+          "doc-url": "",
+          "attributes": [
+            {
+              "name": "selected-page",
+              "description": "Currently selected page (1-based index)",
+              "value": { "type": "number", "default": "1" }
+            },
+            {
+              "name": "page-count",
+              "description": "Total number of pages",
+              "value": { "type": "number", "default": "1" }
+            }
+          ],
+          "events": [],
+          "js": {
+            "properties": [
+              {
+                "name": "selectedPage",
+                "description": "Currently selected page (1-based index)",
+                "type": "number"
+              },
+              {
+                "name": "pageCount",
+                "description": "Total number of pages",
+                "type": "number"
+              }
+            ],
+            "events": []
+          }
+        },
+        {
+          "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.",
+          "doc-url": "",
+          "attributes": [
+            { "name": "base-url", "value": { "type": "string" } },
+            { "name": "pages", "value": { "type": "number" } },
+            {
+              "name": "current-page",
+              "value": { "type": "number", "default": "1" }
+            },
+            {
+              "name": "visible-pages",
+              "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."
+            }
+          ],
+          "js": {
+            "properties": [
+              { "name": "baseUrl", "type": "string" },
+              { "name": "pages", "type": "number" },
+              { "name": "currentPageNumber", "type": "number" },
+              { "name": "visiblePages", "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."
+              }
+            ]
+          }
+        },
+        {
+          "name": "w-slider-thumb",
+          "description": "Component to place inside a `<w-slider>`.\n\n[See Storybook for usage examples](https://warp-ds.github.io/elements/?path=/docs/forms-slider-and-range-slider--docs)\n---\n\n\n### **Events:**\n - **slidervalidity**",
+          "doc-url": "",
+          "attributes": [
+            { "name": "aria-label", "value": { "type": "string" } },
+            { "name": "aria-description", "value": { "type": "string" } },
+            { "name": "label", "value": { "type": "string" } },
+            { "name": "name", "value": { "type": "string" } },
+            { "name": "value", "value": { "type": "string" } },
+            { "name": "disabled", "value": { "type": "boolean" } }
+          ],
+          "events": [{ "name": "slidervalidity", "type": "CustomEvent" }],
+          "js": {
+            "properties": [
+              { "name": "ariaLabel", "type": "string" },
+              { "name": "ariaDescription", "type": "string" },
+              { "name": "label", "type": "string" },
+              { "name": "name", "type": "string" },
+              { "name": "value", "type": "string" },
+              { "name": "disabled", "type": "boolean" },
+              {
+                "name": "markers",
+                "description": "Set by `<w-slider>`",
+                "type": "string"
+              },
+              {
+                "name": "required",
+                "description": "Set by `<w-slider>`",
+                "type": "boolean"
+              },
+              {
+                "name": "step",
+                "description": "Set by `<w-slider>`",
+                "type": "number"
+              },
+              {
+                "name": "min",
+                "description": "Set by `<w-slider>`",
+                "type": "string"
+              },
+              {
+                "name": "max",
+                "description": "Set by `<w-slider>`",
+                "type": "string"
+              },
+              {
+                "name": "suffix",
+                "description": "Set by `<w-slider>`",
+                "type": "string"
+              },
+              {
+                "name": "formatter",
+                "description": "JS hook to help you format the numeric value how you want.",
+                "type": "(value: string) => string"
+              },
+              { "name": "range", "type": "HTMLInputElement" },
+              { "name": "textfield", "type": "WarpTextField" }
+            ],
+            "events": [{ "name": "slidervalidity", "type": "CustomEvent" }]
+          }
+        },
+        {
+          "name": "w-slider",
+          "description": "Parent component for sliders (both single and range sliders). Used in combination with a `<w-slider-thumb>`.\n\n[See Storybook for usage examples](https://warp-ds.github.io/elements/?path=/docs/forms-slider-and-range-slider--docs)\n---\n\n\n### **Slots:**\n - _default_ - For single sliders place a `<w-slider-thumb>` in the default slot.\n- **label** - Label for the slider or range slider as a whole.\n- **description** - Optional description between the label and slider.\n- **from** - Range sliders need to place a `<w-slider-thumb>` in the from and to slots.\n- **to** - Range sliders need to place a `<w-slider-thumb>` in the from and to slots.",
+          "doc-url": "",
+          "attributes": [
+            {
+              "name": "label",
+              "description": "The slider fieldset label. Required for proper accessibility.\n\nIf you need to display HTML, use the `label` slot instead.",
+              "value": { "type": "string" }
+            },
+            {
+              "name": "disabled",
+              "value": { "type": "boolean", "default": "false" }
+            },
+            {
+              "name": "invalid",
+              "value": { "type": "boolean", "default": "false" }
+            },
+            {
+              "name": "required",
+              "description": "Ensures a child slider thumb has a value before allowing the containing form to submit.",
+              "value": { "type": "boolean", "default": "false" }
+            },
+            { "name": "min", "value": { "type": "string" } },
+            { "name": "max", "value": { "type": "string" } },
+            {
+              "name": "markers",
+              "description": "Pass a value similar to step to create visual markers at that interval",
+              "value": { "type": "number" }
+            },
+            { "name": "step", "value": { "type": "number" } },
+            {
+              "name": "suffix",
+              "description": "Suffix used in text input fields and for the min and max values of the slider.",
+              "value": { "type": "string" }
+            }
+          ],
+          "slots": [
+            {
+              "name": "",
+              "description": "For single sliders place a `<w-slider-thumb>` in the default slot."
+            },
+            {
+              "name": "label",
+              "description": "Label for the slider or range slider as a whole."
+            },
+            {
+              "name": "description",
+              "description": "Optional description between the label and slider."
+            },
+            {
+              "name": "from",
+              "description": "Range sliders need to place a `<w-slider-thumb>` in the from and to slots."
+            },
+            {
+              "name": "to",
+              "description": "Range sliders need to place a `<w-slider-thumb>` in the from and to slots."
+            }
+          ],
+          "events": [],
+          "js": {
+            "properties": [
+              {
+                "name": "label",
+                "description": "The slider fieldset label. Required for proper accessibility.\n\nIf you need to display HTML, use the `label` slot instead.",
+                "type": "string"
+              },
+              { "name": "disabled", "type": "boolean" },
+              { "name": "invalid", "type": "boolean" },
+              {
+                "name": "required",
+                "description": "Ensures a child slider thumb has a value before allowing the containing form to submit.",
+                "type": "boolean"
+              },
+              { "name": "min", "type": "string" },
+              { "name": "max", "type": "string" },
+              {
+                "name": "markers",
+                "description": "Pass a value similar to step to create visual markers at that interval",
+                "type": "number"
+              },
+              { "name": "step", "type": "number" },
+              {
+                "name": "suffix",
+                "description": "Suffix used in text input fields and for the min and max values of the slider.",
+                "type": "string"
+              },
+              {
+                "name": "formatter",
+                "description": "Function to format the to- and from labels and value in the slider thumb tooltip.",
+                "type": "(value: string) => string"
+              }
+            ],
+            "events": []
+          }
+        },
+        {
+          "name": "w-steps",
+          "description": "Steps are used to show progress through a process or to guide users through a multi-step task.\n\n[See Storybook for usage examples](https://warp-ds.github.io/elements/?path=/docs/components-steps--docs)\n---\n",
+          "doc-url": "",
+          "attributes": [
+            {
+              "name": "horizontal",
+              "value": { "type": "boolean", "default": "false" }
+            },
+            {
+              "name": "right",
+              "value": { "type": "boolean", "default": "false" }
+            }
+          ],
+          "events": [],
+          "js": {
+            "properties": [
+              { "name": "horizontal", "type": "boolean" },
+              { "name": "right", "type": "boolean" }
+            ],
+            "events": []
+          }
+        },
+        {
+          "name": "w-step",
+          "description": "Individual step component that shows a single step in a process\n---\n",
+          "doc-url": "",
+          "attributes": [
+            {
+              "name": "active",
+              "value": { "type": "boolean", "default": "false" }
+            },
+            {
+              "name": "completed",
+              "value": { "type": "boolean", "default": "false" }
+            }
+          ],
+          "events": [],
+          "js": {
+            "properties": [
+              { "name": "active", "type": "boolean" },
+              { "name": "completed", "type": "boolean" }
+            ],
+            "events": []
+          }
+        },
+        {
+          "name": "w-switch",
+          "description": "\n---\n\n\n### **Events:**\n - **change**",
+          "doc-url": "",
+          "attributes": [
+            {
+              "name": "value",
+              "value": { "type": "boolean", "default": "false" }
+            },
+            {
+              "name": "disabled",
+              "value": { "type": "boolean", "default": "false" }
+            }
+          ],
+          "events": [{ "name": "change", "type": "CustomEvent" }],
+          "js": {
+            "properties": [
+              { "name": "value", "type": "boolean" },
+              { "name": "disabled", "type": "boolean" }
+            ],
+            "events": [{ "name": "change", "type": "CustomEvent" }]
+          }
+        },
+        {
+          "name": "w-tab",
+          "description": "Individual tab component used within w-tabs container.\n\n[See Storybook for usage examples](https://warp-ds.github.io/elements/?path=/docs/tabs--docs)\n---\n",
+          "doc-url": "",
+          "attributes": [
+            { "name": "name", "value": { "type": "string" } },
+            { "name": "label", "value": { "type": "string", "default": "''" } },
+            {
+              "name": "active",
+              "value": { "type": "boolean", "default": "false" }
+            },
+            {
+              "name": "over",
+              "value": { "type": "boolean", "default": "false" }
+            },
+            {
+              "name": "tab-class",
+              "value": { "type": "string", "default": "''" }
+            }
+          ],
+          "events": [],
+          "js": {
+            "properties": [
+              { "name": "name", "type": "string" },
+              { "name": "label", "type": "string" },
+              { "name": "active", "type": "boolean" },
+              { "name": "over", "type": "boolean" },
+              { "name": "tabClass", "type": "string" }
+            ],
+            "events": []
+          }
+        },
+        {
+          "name": "w-tabs",
+          "description": "Tabs are used to organize content by grouping similar information on the same page.\n\n[See Storybook for usage examples](https://warp-ds.github.io/elements/?path=/docs/tabs--docs)\n---\n\n\n### **Events:**\n - **change**",
+          "doc-url": "",
+          "attributes": [
+            {
+              "name": "active",
+              "value": { "type": "string", "default": "''" }
+            },
+            {
+              "name": "tab-class",
+              "value": { "type": "string", "default": "''" }
+            }
+          ],
+          "events": [{ "name": "change", "type": "CustomEvent" }],
+          "js": {
+            "properties": [
+              { "name": "active", "type": "string" },
+              { "name": "tabClass", "type": "string" },
+              { "name": "tabs" },
+              { "name": "activeTab" }
+            ],
+            "events": [{ "name": "change", "type": "CustomEvent" }]
+          }
         }
       ]
     },