@warp-ds/elements 2.9.0-next.2 → 2.9.0-next.4

package/dist/custom-elements.json

@@ -161,7 +161,6 @@
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Add this property to render a clickable Warp close icon.\n\nSet an `aria-label` that explains the action when using this.",
               "attribute": "clear"
             },
             {
@@ -171,7 +170,6 @@
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Add this property to render a clickable Warp search icon.\n\nSet an `aria-label` that explains the action when using this.",
               "attribute": "search"
             },
             {
@@ -269,11 +267,14 @@
               "type": {
                 "text": "AlertVariants"
               },
+              "default": "'info'",
+              "summary": "Visual style of the alert.",
               "attribute": "variant",
               "reflects": true,
               "parsedType": {
                 "text": "'negative' | 'positive' | 'warning' | 'info'"
-              }
+              },
+              "description": "Controls both the color treatment and icon used by the component. Accepted values are `info`, `warning`, `positive`, and `negative`. Use the variant that matches the message severity so users can quickly distinguish informative messages from warnings, errors, and confirmations."
             },
             {
               "kind": "field",
@@ -281,8 +282,11 @@
               "type": {
                 "text": "boolean"
               },
+              "default": "false",
+              "summary": "Whether the alert is visible.",
               "attribute": "show",
-              "reflects": true
+              "reflects": true,
+              "description": "Alerts are hidden by default (`false`). Set this to `true` to render and expand the content. This is reflected as an attribute, so visibility can be controlled from markup (`show`) or from JavaScript (`element.show = true`)."
             },
             {
               "kind": "field",
@@ -291,7 +295,10 @@
                 "text": "string"
               },
               "default": "'alert'",
-              "attribute": "role"
+              "summary": "ARIA role announced to assistive technology.",
+              "attribute": "role",
+              "reflects": true,
+              "description": "Defaults to `alert` so urgent changes are announced by screen readers. Override this only when your use case requires a different announcement behavior, for example a less assertive live region strategy."
             }
           ],
           "attributes": [
@@ -300,6 +307,8 @@
               "type": {
                 "text": "AlertVariants"
               },
+              "default": "'info'",
+              "summary": "Visual style of the alert.",
               "fieldName": "variant",
               "parsedType": {
                 "text": "'negative' | 'positive' | 'warning' | 'info'"
@@ -310,6 +319,8 @@
               "type": {
                 "text": "boolean"
               },
+              "default": "false",
+              "summary": "Whether the alert is visible.",
               "fieldName": "show"
             },
             {
@@ -318,6 +329,7 @@
                 "text": "string"
               },
               "default": "'alert'",
+              "summary": "ARIA role announced to assistive technology.",
               "fieldName": "role"
             }
           ],
@@ -2375,7 +2387,6 @@
                 "text": "ComboboxOption[]"
               },
               "default": "[]",
-              "description": "The available options to select from",
               "attribute": "options"
             },
             {
@@ -2385,7 +2396,6 @@
                 "text": "string | undefined"
               },
               "default": "''",
-              "description": "Label above input",
               "attribute": "label",
               "reflects": true
             },
@@ -2396,7 +2406,6 @@
                 "text": "string | undefined"
               },
               "default": "''",
-              "description": "Input placeholder",
               "attribute": "placeholder",
               "reflects": true
             },
@@ -2407,7 +2416,6 @@
                 "text": "string"
               },
               "default": "''",
-              "description": "The input value",
               "attribute": "value",
               "reflects": true
             },
@@ -2418,7 +2426,6 @@
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Whether the popover opens when focus is on the text field",
               "attribute": "open-on-focus",
               "reflects": true
             },
@@ -2429,7 +2436,6 @@
                 "text": "boolean"
               },
               "default": "true",
-              "description": "Select active option on blur",
               "attribute": "select-on-blur",
               "reflects": true
             },
@@ -2440,7 +2446,6 @@
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Whether the matching text segments in the options should be highlighted",
               "attribute": "match-text-segments",
               "reflects": true
             },
@@ -2451,7 +2456,6 @@
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Disable client-side static filtering",
               "attribute": "disable-static-filtering",
               "reflects": true
             },
@@ -2462,7 +2466,6 @@
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Renders the input field in an invalid state",
               "attribute": "invalid",
               "reflects": true
             },
@@ -2473,7 +2476,6 @@
                 "text": "string | undefined"
               },
               "default": "''",
-              "description": "The content to display as the help text",
               "attribute": "help-text",
               "reflects": true
             },
@@ -2484,7 +2486,6 @@
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Whether the element is disabled",
               "attribute": "disabled",
               "reflects": true
             },
@@ -2495,7 +2496,6 @@
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Whether the element is required",
               "attribute": "required",
               "reflects": true
             },
@@ -2506,7 +2506,6 @@
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Whether to show optional text",
               "attribute": "optional",
               "reflects": true
             },
@@ -2517,7 +2516,6 @@
                 "text": "string | undefined"
               },
               "default": "''",
-              "description": "Name attribute for form submission",
               "attribute": "name",
               "reflects": true
             },
@@ -2528,7 +2526,6 @@
                 "text": "string | undefined"
               },
               "default": "'off'",
-              "description": "Autocomplete attribute for the input field",
               "attribute": "autocomplete",
               "reflects": true
             },
@@ -2986,7 +2983,6 @@
               "type": {
                 "text": "string"
               },
-              "description": "Takes precedence over the `<html>` lang attribute.",
               "attribute": "lang",
               "reflects": true
             },
@@ -3015,7 +3011,6 @@
                 "text": "string"
               },
               "default": "'MMMM yyyy'",
-              "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).",
               "attribute": "header-format"
             },
             {
@@ -3025,7 +3020,6 @@
                 "text": "string"
               },
               "default": "'EEEEEE'",
-              "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).",
               "attribute": "weekday-format"
             },
             {
@@ -3033,8 +3027,7 @@
               "name": "isDayDisabled",
               "type": {
                 "text": "(day: Date) => boolean"
-              },
-              "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."
+              }
             },
             {
               "kind": "field",
@@ -3043,7 +3036,6 @@
                 "text": "string"
               },
               "default": "'PPPP'",
-              "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).",
               "attribute": "day-format"
             },
             {
@@ -4038,7 +4030,6 @@
               "type": {
                 "text": "number"
               },
-              "description": "Currently selected page (1-based index, clamped to valid range)",
               "attribute": "selected-page",
               "reflects": true
             },
@@ -4048,7 +4039,6 @@
               "type": {
                 "text": "number"
               },
-              "description": "Total number of pages (minimum 1)",
               "attribute": "page-count",
               "reflects": true
             },
@@ -5342,7 +5332,6 @@
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Whether the element should receive focus on render.",
               "deprecated": "Use the native `autofocus` attribute instead.",
               "attribute": "auto-focus",
               "reflects": true
@@ -5354,7 +5343,6 @@
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Whether the element should receive focus on render",
               "attribute": "autofocus",
               "reflects": true
             },
@@ -5364,7 +5352,6 @@
               "type": {
                 "text": "string"
               },
-              "description": "The content displayed as the help text. Paired with `invalid` to show the text as a validation error.",
               "attribute": "help-text",
               "reflects": true
             },
@@ -5375,7 +5362,6 @@
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Renders the field in an invalid state. Paired with `help-text` to provide feedback about the error.",
               "attribute": "invalid",
               "reflects": true
             },
@@ -5386,7 +5372,6 @@
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Whether to always show a hint.",
               "deprecated": "Use `help-text` instead and only set it if you want to display the help text.",
               "attribute": "always",
               "reflects": true
@@ -5397,7 +5382,6 @@
               "type": {
                 "text": "string"
               },
-              "description": "The content displayed as the help text.",
               "deprecated": "Use `help-text` instead.",
               "attribute": "hint",
               "reflects": true
@@ -5408,7 +5392,6 @@
               "type": {
                 "text": "string"
               },
-              "description": "The content to disply as the label",
               "attribute": "label",
               "reflects": true
             },
@@ -5419,7 +5402,6 @@
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Whether to show optional text",
               "attribute": "optional",
               "reflects": true
             },
@@ -5430,7 +5412,6 @@
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Renders the field in a disabled state.",
               "attribute": "disabled",
               "reflects": true
             },
@@ -5441,7 +5422,6 @@
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Renders the field in a readonly state.",
               "deprecated": "Use the native readonly attribute instead.",
               "attribute": "read-only",
               "reflects": true
@@ -5453,7 +5433,6 @@
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Renders the field in a readonly state.",
               "attribute": "readonly",
               "reflects": true
             },
@@ -5645,6 +5624,10 @@
               "type": {
                 "text": "onChange(event: Event) => void"
               }
+            },
+            {
+              "name": "_options",
+              "kind": "field"
             }
           ],
           "events": [
@@ -6015,8 +5998,7 @@
               "name": "formatter",
               "type": {
                 "text": "(value: string) => string"
-              },
-              "description": "Function to format value when the input field.\n\nOnly active when the input field does not have focus,\nsimilar to the accessible input masking example from Filament Group\n\nhttps://css-tricks.com/input-masking/\nhttps://filamentgroup.github.io/politespace/demo/demo.html"
+              }
             },
             {
               "kind": "field",
@@ -6067,6 +6049,14 @@
               "type": {
                 "text": "suffixSlotChange() => void"
               }
+            },
+            {
+              "name": "_hasPrefix",
+              "kind": "field"
+            },
+            {
+              "name": "_hasSuffix",
+              "kind": "field"
             }
           ],
           "attributes": [
@@ -6465,6 +6455,24 @@
                 }
               ]
             },
+            {
+              "kind": "method",
+              "name": "#onInputFieldKeyDown",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "Promise<void>"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "e",
+                  "type": {
+                    "text": "KeyboardEvent"
+                  }
+                }
+              ]
+            },
             {
               "kind": "field",
               "name": "boundaryValue",
@@ -6492,6 +6500,30 @@
               "kind": "field",
               "name": "ariaDescriptionText",
               "readonly": true
+            },
+            {
+              "name": "disabled",
+              "kind": "field"
+            },
+            {
+              "name": "invalid",
+              "kind": "field"
+            },
+            {
+              "name": "openEnded",
+              "kind": "field"
+            },
+            {
+              "name": "valueFormatter",
+              "kind": "field"
+            },
+            {
+              "name": "tooltipFormatter",
+              "kind": "field"
+            },
+            {
+              "name": "labelFormatter",
+              "kind": "field"
             }
           ],
           "events": [
@@ -6626,7 +6658,6 @@
               "type": {
                 "text": "string"
               },
-              "description": "The slider fieldset label. Required for proper accessibility.\n\nIf you need to display HTML, use the `label` slot instead (f. ex. `<legend class=\"sr-only\" slot=\"label\">Production year</legend>`)",
               "attribute": "label",
               "reflects": true
             },
@@ -6647,7 +6678,6 @@
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Whether or not to allow values outside the range such as \"Before 1950\" and \"2025+\".",
               "attribute": "open-ended"
             },
             {
@@ -6685,7 +6715,6 @@
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Ensures a child slider thumb has a value before allowing the containing form to submit.",
               "attribute": "required",
               "reflects": true
             },
@@ -6713,7 +6742,6 @@
               "type": {
                 "text": "number"
               },
-              "description": "Pass a value similar to step to create visual markers at that interval",
               "attribute": "markers",
               "reflects": true
             },
@@ -6732,7 +6760,6 @@
               "type": {
                 "text": "string"
               },
-              "description": "Suffix used in text input fields and for the min and max values of the slider.",
               "attribute": "suffix",
               "reflects": true
             },
@@ -6751,24 +6778,28 @@
               "name": "valueFormatter",
               "type": {
                 "text": "(value: string, slot: SliderSlot) => string"
-              },
-              "description": "Formatter for the tooltip and input mask values."
+              }
             },
             {
               "kind": "field",
               "name": "tooltipFormatter",
               "type": {
                 "text": "(value: string, slot: SliderSlot) => string"
-              },
-              "description": "Replaces valueFormatter for the tooltip. Use in open-ended sliders to show for example \"300+ hk\" instead of \"Max\" in the tooltip."
+              }
             },
             {
               "kind": "field",
               "name": "labelFormatter",
               "type": {
                 "text": "(slot: SliderSlot) => string"
-              },
-              "description": "Formatter for the min and max labels below the range."
+              }
+            },
+            {
+              "kind": "field",
+              "name": "fieldset",
+              "type": {
+                "text": "HTMLFieldSetElement"
+              }
             },
             {
               "kind": "field",
@@ -7561,6 +7592,14 @@
               "kind": "method",
               "name": "syncAriaControls",
               "privacy": "private"
+            },
+            {
+              "name": "_parentTabIndex",
+              "kind": "field"
+            },
+            {
+              "name": "_parentAriaSelected",
+              "kind": "field"
             }
           ],
           "attributes": [
@@ -7677,6 +7716,14 @@
               "kind": "method",
               "name": "syncA11yState",
               "privacy": "private"
+            },
+            {
+              "name": "_parentActive",
+              "kind": "field"
+            },
+            {
+              "name": "_parentAriaLabelledBy",
+              "kind": "field"
             }
           ],
           "attributes": [
@@ -8327,127 +8374,8 @@
     {
       "kind": "javascript-module",
       "path": "packages/toast-container/toast-container.ts",
-      "declarations": [
-        {
-          "kind": "class",
-          "description": "",
-          "name": "WarpToastContainer",
-          "members": [
-            {
-              "kind": "field",
-              "name": "_toasts",
-              "type": {
-                "text": "Map<string | number, ToastInternal>"
-              },
-              "privacy": "private",
-              "default": "new Map()"
-            },
-            {
-              "kind": "field",
-              "name": "_interval",
-              "type": {
-                "text": "NodeJS.Timeout | undefined"
-              },
-              "privacy": "private"
-            },
-            {
-              "kind": "method",
-              "name": "init",
-              "privacy": "public",
-              "static": true,
-              "type": {
-                "text": "init() => void"
-              }
-            },
-            {
-              "kind": "method",
-              "name": "get",
-              "return": {
-                "type": {
-                  "text": "ToastInternal | undefined"
-                }
-              },
-              "parameters": [
-                {
-                  "name": "id",
-                  "type": {
-                    "text": "string | number"
-                  }
-                }
-              ],
-              "type": {
-                "text": "get(id: string | number) => ToastInternal | undefined"
-              }
-            },
-            {
-              "kind": "method",
-              "name": "set",
-              "return": {
-                "type": {
-                  "text": "Map<string | number, ToastInternal>"
-                }
-              },
-              "parameters": [
-                {
-                  "name": "toast",
-                  "type": {
-                    "text": "ToastOptions"
-                  }
-                }
-              ],
-              "type": {
-                "text": "set(toast: ToastOptions) => Map<string | number, ToastInternal>"
-              }
-            },
-            {
-              "kind": "method",
-              "name": "del",
-              "return": {
-                "type": {
-                  "text": "Promise<boolean>"
-                }
-              },
-              "parameters": [
-                {
-                  "name": "id",
-                  "type": {
-                    "text": "string | number"
-                  }
-                }
-              ],
-              "type": {
-                "text": "del(id: string | number) => Promise<boolean>"
-              }
-            }
-          ],
-          "superclass": {
-            "name": "LitElement",
-            "package": "lit"
-          },
-          "tagName": "w-toast-container",
-          "customElement": true,
-          "modulePath": "packages/toast-container/toast-container.ts",
-          "definitionPath": "packages/toast-container/toast-container.ts"
-        }
-      ],
-      "exports": [
-        {
-          "kind": "js",
-          "name": "WarpToastContainer",
-          "declaration": {
-            "name": "WarpToastContainer",
-            "module": "packages/toast-container/toast-container.ts"
-          }
-        },
-        {
-          "kind": "custom-element-definition",
-          "name": "w-toast-container",
-          "declaration": {
-            "name": "WarpToastContainer",
-            "module": "packages/toast-container/toast-container.ts"
-          }
-        }
-      ]
+      "declarations": [],
+      "exports": []
     },
     {
       "kind": "javascript-module",

package/dist/docs/affix/accessibility.md

@@ -0,0 +1 @@
+## Accessibility