@warp-ds/elements 2.10.0-next.13 → 2.10.0-next.15

package/dist/custom-elements.json

@@ -4006,6 +4006,18 @@
                 "text": "HTMLTableCellElement"
               }
             },
+            {
+              "kind": "field",
+              "name": "#inputLocale",
+              "privacy": "private",
+              "readonly": true
+            },
+            {
+              "kind": "field",
+              "name": "#inputValue",
+              "privacy": "private",
+              "readonly": true
+            },
             {
               "kind": "method",
               "name": "resetFormControl",
@@ -7434,6 +7446,378 @@
         }
       ]
     },
+    {
+      "kind": "javascript-module",
+      "path": "packages/snackbar-item/snackbar-item.ts",
+      "declarations": [
+        {
+          "kind": "class",
+          "description": "An item to show in a `w-snackbar`.\n\nSee the `create` function on `w-snackbar` for a convenience API which helps you make snackbar items.",
+          "name": "WarpSnackbarItem",
+          "cssProperties": [
+            {
+              "name": "--w-c-snackbar-item-radius"
+            },
+            {
+              "name": "--w-c-snackbar-item-max-width"
+            },
+            {
+              "name": "--w-c-snackbar-item-min-width"
+            },
+            {
+              "name": "--w-c-snackbar-item-padding"
+            },
+            {
+              "name": "--w-c-snackbar-item-bg"
+            },
+            {
+              "name": "--w-c-snackbar-item-action-bg-active"
+            },
+            {
+              "name": "--w-c-snackbar-item-action-bg-hover"
+            },
+            {
+              "name": "--w-c-snackbar-item-color"
+            },
+            {
+              "name": "--w-c-snackbar-item-action-color-active"
+            },
+            {
+              "name": "--w-c-snackbar-item-action-color-hover"
+            },
+            {
+              "name": "--w-c-snackbar-item-box-shadow"
+            }
+          ],
+          "cssParts": [
+            {
+              "description": "the container wrapping the message, icon and actions.",
+              "name": "item"
+            },
+            {
+              "description": "the icon for the variant.",
+              "name": "icon"
+            },
+            {
+              "description": "the default slot, body of the snackbar item.",
+              "name": "message"
+            },
+            {
+              "description": "close and action button.",
+              "name": "action"
+            }
+          ],
+          "slots": [
+            {
+              "description": "the snackbar message.",
+              "name": "default"
+            },
+            {
+              "description": "icon preceeding the message.",
+              "name": "icon"
+            },
+            {
+              "description": "action following the message.",
+              "name": "action"
+            }
+          ],
+          "members": [
+            {
+              "kind": "field",
+              "name": "actionPlacement",
+              "type": {
+                "text": "SnackbarActionPlacement"
+              },
+              "default": "'inline'",
+              "description": "The placement of the action and close buttons.",
+              "attribute": "action-placement",
+              "reflects": true,
+              "parsedType": {
+                "text": "'inline' | 'block'"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "duration",
+              "type": {
+                "text": "number"
+              },
+              "description": "How long the message should stay in the document before removing itself.",
+              "attribute": "duration",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "root",
+              "type": {
+                "text": "HTMLDivElement | null"
+              },
+              "privacy": "private"
+            },
+            {
+              "kind": "field",
+              "name": "hasAction",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "default": "false"
+            },
+            {
+              "kind": "field",
+              "name": "#expanded",
+              "privacy": "private",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false"
+            },
+            {
+              "kind": "field",
+              "name": "#durationLeft",
+              "privacy": "private",
+              "type": {
+                "text": "number"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "#lastFocused",
+              "privacy": "private",
+              "type": {
+                "text": "HTMLElement | null"
+              },
+              "default": "null"
+            },
+            {
+              "kind": "field",
+              "name": "#timer",
+              "privacy": "private",
+              "type": {
+                "text": "ReturnType<typeof setTimeout> | null"
+              },
+              "default": "null"
+            },
+            {
+              "kind": "field",
+              "name": "#timerPaused",
+              "privacy": "private",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false"
+            },
+            {
+              "kind": "method",
+              "name": "close",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "description": "Remove the snackbar item from the document.\n\nMoves focus to the last focused element outside of the snackbar item, if available.",
+              "type": {
+                "text": "close() => void"
+              }
+            },
+            {
+              "kind": "method",
+              "name": "#onFocusIn",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "e",
+                  "type": {
+                    "text": "FocusEvent"
+                  }
+                }
+              ],
+              "description": "Listen to focusin, not focus, as focus does not bubble.\n\nWe're interested in running code when an action button gets focus,\nsuch as pausing the countdown and storing the last focused element\noutside of the snackbar so we can return there when it closes.\n\nOnly save the first instance of `relatedTarget` so we don't overwrite\nit when focus moves from an action button to the close button."
+            },
+            {
+              "kind": "method",
+              "name": "#onFocusOut",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "e",
+                  "type": {
+                    "text": "FocusEvent"
+                  }
+                }
+              ],
+              "description": "Listen to focusout, not blur, as blur does not bubble.\n\nUnpause the countdown by clearing this.#lastFocused\nif the focus is moving outside of the snackbar item."
+            },
+            {
+              "kind": "method",
+              "name": "#onMouseEnter",
+              "privacy": "private"
+            },
+            {
+              "kind": "method",
+              "name": "#onMouseLeave",
+              "privacy": "private"
+            },
+            {
+              "kind": "method",
+              "name": "#hasAction",
+              "privacy": "private"
+            }
+          ],
+          "attributes": [
+            {
+              "name": "action-placement",
+              "type": {
+                "text": "SnackbarActionPlacement"
+              },
+              "default": "'inline'",
+              "description": "The placement of the action and close buttons.",
+              "fieldName": "actionPlacement",
+              "parsedType": {
+                "text": "'inline' | 'block'"
+              }
+            },
+            {
+              "name": "duration",
+              "type": {
+                "text": "number"
+              },
+              "description": "How long the message should stay in the document before removing itself.",
+              "fieldName": "duration"
+            }
+          ],
+          "superclass": {
+            "name": "LitElement",
+            "package": "lit"
+          },
+          "parent": {
+            "name": "w-snackbar",
+            "description": ""
+          },
+          "tagName": "w-snackbar-item",
+          "customElement": true,
+          "modulePath": "packages/snackbar-item/snackbar-item.ts",
+          "definitionPath": "packages/snackbar-item/snackbar-item.ts"
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "WarpSnackbarItem",
+          "declaration": {
+            "name": "WarpSnackbarItem",
+            "module": "packages/snackbar-item/snackbar-item.ts"
+          }
+        },
+        {
+          "kind": "custom-element-definition",
+          "name": "w-snackbar-item",
+          "declaration": {
+            "name": "WarpSnackbarItem",
+            "module": "packages/snackbar-item/snackbar-item.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "packages/snackbar/snackbar.ts",
+      "declarations": [
+        {
+          "kind": "class",
+          "description": "A Snackbar shows brief user feedback messages that overlay content, with an optional action such as Undo.\n\nInclude one `<w-snackbar></w-snackbar>` in the document `<body>`. Use the `create` function to create messages.",
+          "name": "WarpSnackbar",
+          "cssProperties": [
+            {
+              "name": "--w-c-snackbar-container-gap"
+            },
+            {
+              "name": "--w-c-snackbar-position-bottom"
+            },
+            {
+              "name": "--w-c-snackbar-position-left"
+            },
+            {
+              "name": "--w-c-snackbar-position-right"
+            },
+            {
+              "name": "--w-c-snackbar-position-top"
+            },
+            {
+              "name": "--w-c-snackbar-z-index"
+            }
+          ],
+          "cssParts": [
+            {
+              "description": "the live region that positions messages on the screen.",
+              "name": "container"
+            }
+          ],
+          "slots": [
+            {
+              "description": "`w-snackbar-item` gets placed inside the default slot by the `create` function.",
+              "name": "default"
+            }
+          ],
+          "members": [
+            {
+              "kind": "method",
+              "name": "create",
+              "return": {
+                "type": {
+                  "text": ""
+                }
+              },
+              "parameters": [
+                {
+                  "name": "message",
+                  "type": {
+                    "text": "string"
+                  }
+                },
+                {
+                  "name": "options",
+                  "default": "{}",
+                  "type": {
+                    "text": "CreateSnackbarOptions"
+                  }
+                }
+              ],
+              "description": "Creates a snackbar item and immediately adds it to the snackbar.\n\nBy default the snackbar item automatically closes after 4 seconds (`SnackbarDuration.Short`).\n\nIf you include an `action` in the options the default `duration` is\nset to 10 seconds (`SnackbarDuration.Long`) and can not be made shorter. \n\nA `duration` of 10 seconds or longer forces the close button to be visible.\n\nThe default `variant` is `neutral` which does not have an icon.\n\nSet `duration` to `SnackbarDuration.Infinite` if you want a persistent message.",
+              "type": {
+                "text": "create(message: string, options: CreateSnackbarOptions = {}) => void"
+              }
+            }
+          ],
+          "superclass": {
+            "name": "LitElement",
+            "package": "lit"
+          },
+          "tagName": "w-snackbar",
+          "customElement": true,
+          "modulePath": "packages/snackbar/snackbar.ts",
+          "definitionPath": "packages/snackbar/snackbar.ts"
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "WarpSnackbar",
+          "declaration": {
+            "name": "WarpSnackbar",
+            "module": "packages/snackbar/snackbar.ts"
+          }
+        },
+        {
+          "kind": "custom-element-definition",
+          "name": "w-snackbar",
+          "declaration": {
+            "name": "WarpSnackbar",
+            "module": "packages/snackbar/snackbar.ts"
+          }
+        }
+      ]
+    },
     {
       "kind": "javascript-module",
       "path": "packages/step/step.ts",

package/dist/docs/attention/api.md

@@ -8,15 +8,21 @@ Unless otherwise noted all properties are HTML attributes (as opposed to JavaScr
 |-|-|-|-|
 | _actualDirection (JS only) | `unknown` | `-` | - |
 | _initialPlacement (JS only) | `unknown` | `-` | - |
+| activeAttentionType (JS only) | `activeAttentionType() => void` | `-` | - |
 | callout | `boolean` | `false` | Renders the component as an inline callout. |
 | can-close | `boolean` | `false` | Shows a close button inside the attention component. |
+| close (JS only) | `close() => void` | `-` | - |
 | cross-axis | `boolean` | `false` | Allows overflow checks on the cross axis when flipping. |
+| defaultAriaLabel (JS only) | `defaultAriaLabel() => void` | `-` | - |
 | distance | `number` | `8` | Distance offset between trigger and attention panel. |
 | fallback-placements | `Directions[]` | `[]` | Ordered list of fallback placements. |
 | flip | `boolean` | `false` | Enables automatic flipping when placement has no space. |
+| handleDone (JS only) | `handleDone() => void` | `-` | - |
 | highlight | `boolean` | `false` | Renders the component with highlight styling. |
+| keypressed (JS only) | `keypressed(e: KeyboardEvent) => void` | `-` | - |
 | no-arrow | `boolean` | `false` | Hides the directional arrow of the attention component. |
 | placement | [`Directions`](#directions) | `'bottom'` | Preferred placement relative to the trigger element. |
+| pointingAtDirection (JS only) | `pointingAtDirection() => void` | `-` | - |
 | popover | `boolean` | `false` | Enables native popover behavior for the attention element. |
 | show | `boolean` | `false` | Controls whether the attention panel is visible. |
 | skidding | `number` | `0` | Cross-axis offset for fine-grained positioning. |
@@ -38,6 +44,13 @@ Unless otherwise noted all properties are HTML attributes (as opposed to JavaScr
 - Type: `unknown`
 - Default: `-`
 
+#### activeAttentionType (JS only)
+
+
+
+- Type: `activeAttentionType() => void`
+- Default: `-`
+
 #### callout
 
 Renders the component as an inline callout.
@@ -54,6 +67,13 @@ Adds an internal dismiss action that lets users close the attention panel.
 - Type: `boolean`
 - Default: `false`
 
+#### close (JS only)
+
+
+
+- Type: `close() => void`
+- Default: `-`
+
 #### cross-axis
 
 Allows overflow checks on the cross axis when flipping.
@@ -62,6 +82,13 @@ Use with `flip` to improve collision handling when space is constrained horizont
 - Type: `boolean`
 - Default: `false`
 
+#### defaultAriaLabel (JS only)
+
+
+
+- Type: `defaultAriaLabel() => void`
+- Default: `-`
+
 #### distance
 
 Distance offset between trigger and attention panel.
@@ -86,6 +113,13 @@ Allows the component to choose an alternative side if the preferred placement wo
 - Type: `boolean`
 - Default: `false`
 
+#### handleDone (JS only)
+
+
+
+- Type: `handleDone() => void`
+- Default: `-`
+
 #### highlight
 
 Renders the component with highlight styling.
@@ -94,6 +128,13 @@ Use highlight mode to visually emphasize important contextual information.
 - Type: `boolean`
 - Default: `false`
 
+#### keypressed (JS only)
+
+
+
+- Type: `keypressed(e: KeyboardEvent) => void`
+- Default: `-`
+
 #### no-arrow
 
 Hides the directional arrow of the attention component.
@@ -110,6 +151,13 @@ Sets the initial direction for positioning, for example `top`, `right`, `bottom`
 - Type: [`Directions`](#directions)
 - Default: `'bottom'`
 
+#### pointingAtDirection (JS only)
+
+
+
+- Type: `pointingAtDirection() => void`
+- Default: `-`
+
 #### popover
 
 Enables native popover behavior for the attention element.

package/dist/docs/attention/attention.md

@@ -258,15 +258,21 @@ Unless otherwise noted all properties are HTML attributes (as opposed to JavaScr
 |-|-|-|-|
 | _actualDirection (JS only) | `unknown` | `-` | - |
 | _initialPlacement (JS only) | `unknown` | `-` | - |
+| activeAttentionType (JS only) | `activeAttentionType() => void` | `-` | - |
 | callout | `boolean` | `false` | Renders the component as an inline callout. |
 | can-close | `boolean` | `false` | Shows a close button inside the attention component. |
+| close (JS only) | `close() => void` | `-` | - |
 | cross-axis | `boolean` | `false` | Allows overflow checks on the cross axis when flipping. |
+| defaultAriaLabel (JS only) | `defaultAriaLabel() => void` | `-` | - |
 | distance | `number` | `8` | Distance offset between trigger and attention panel. |
 | fallback-placements | `Directions[]` | `[]` | Ordered list of fallback placements. |
 | flip | `boolean` | `false` | Enables automatic flipping when placement has no space. |
+| handleDone (JS only) | `handleDone() => void` | `-` | - |
 | highlight | `boolean` | `false` | Renders the component with highlight styling. |
+| keypressed (JS only) | `keypressed(e: KeyboardEvent) => void` | `-` | - |
 | no-arrow | `boolean` | `false` | Hides the directional arrow of the attention component. |
 | placement | [`Directions`](#directions) | `'bottom'` | Preferred placement relative to the trigger element. |
+| pointingAtDirection (JS only) | `pointingAtDirection() => void` | `-` | - |
 | popover | `boolean` | `false` | Enables native popover behavior for the attention element. |
 | show | `boolean` | `false` | Controls whether the attention panel is visible. |
 | skidding | `number` | `0` | Cross-axis offset for fine-grained positioning. |
@@ -288,6 +294,13 @@ Unless otherwise noted all properties are HTML attributes (as opposed to JavaScr
 - Type: `unknown`
 - Default: `-`
 
+#### activeAttentionType (JS only)
+
+
+
+- Type: `activeAttentionType() => void`
+- Default: `-`
+
 #### callout
 
 Renders the component as an inline callout.
@@ -304,6 +317,13 @@ Adds an internal dismiss action that lets users close the attention panel.
 - Type: `boolean`
 - Default: `false`
 
+#### close (JS only)
+
+
+
+- Type: `close() => void`
+- Default: `-`
+
 #### cross-axis
 
 Allows overflow checks on the cross axis when flipping.
@@ -312,6 +332,13 @@ Use with `flip` to improve collision handling when space is constrained horizont
 - Type: `boolean`
 - Default: `false`
 
+#### defaultAriaLabel (JS only)
+
+
+
+- Type: `defaultAriaLabel() => void`
+- Default: `-`
+
 #### distance
 
 Distance offset between trigger and attention panel.
@@ -336,6 +363,13 @@ Allows the component to choose an alternative side if the preferred placement wo
 - Type: `boolean`
 - Default: `false`
 
+#### handleDone (JS only)
+
+
+
+- Type: `handleDone() => void`
+- Default: `-`
+
 #### highlight
 
 Renders the component with highlight styling.
@@ -344,6 +378,13 @@ Use highlight mode to visually emphasize important contextual information.
 - Type: `boolean`
 - Default: `false`
 
+#### keypressed (JS only)
+
+
+
+- Type: `keypressed(e: KeyboardEvent) => void`
+- Default: `-`
+
 #### no-arrow
 
 Hides the directional arrow of the attention component.
@@ -360,6 +401,13 @@ Sets the initial direction for positioning, for example `top`, `right`, `bottom`
 - Type: [`Directions`](#directions)
 - Default: `'bottom'`
 
+#### pointingAtDirection (JS only)
+
+
+
+- Type: `pointingAtDirection() => void`
+- Default: `-`
+
 #### popover
 
 Enables native popover behavior for the attention element.

package/dist/docs/button/api.md

@@ -18,6 +18,7 @@ Unless otherwise noted all properties are HTML attributes (as opposed to JavaScr
 | name | `string \| undefined` | `-` | Form control name. |
 | quiet | `boolean` | `false` | Deprecated quiet visual treatment flag. **Deprecated**: Use `variant="quiet"` instead |
 | rel | `string \| undefined` | `-` | Link relationship. |
+| resetFormControl (JS only) | `resetFormControl() => void` | `-` | - |
 | shadowRootOptions (JS only) | `object` | `{ ...LitElement.shadowRootOptions, delegatesFocus: true, }` | Shadow root configuration. |
 | small | `boolean` | `false` | Renders the compact button size. |
 | target | `string \| undefined` | `-` | Link browsing context. |
@@ -125,6 +126,13 @@ Passed to the rendered link when `href` is set. If `target="_blank"` is set and
 - Type: `string | undefined`
 - Default: `-`
 
+#### resetFormControl (JS only)
+
+
+
+- Type: `resetFormControl() => void`
+- Default: `-`
+
 #### shadowRootOptions (JS only)
 
 Shadow root configuration.

package/dist/docs/button/button.md

@@ -361,6 +361,7 @@ Unless otherwise noted all properties are HTML attributes (as opposed to JavaScr
 | name | `string \| undefined` | `-` | Form control name. |
 | quiet | `boolean` | `false` | Deprecated quiet visual treatment flag. **Deprecated**: Use `variant="quiet"` instead |
 | rel | `string \| undefined` | `-` | Link relationship. |
+| resetFormControl (JS only) | `resetFormControl() => void` | `-` | - |
 | shadowRootOptions (JS only) | `object` | `{ ...LitElement.shadowRootOptions, delegatesFocus: true, }` | Shadow root configuration. |
 | small | `boolean` | `false` | Renders the compact button size. |
 | target | `string \| undefined` | `-` | Link browsing context. |
@@ -468,6 +469,13 @@ Passed to the rendered link when `href` is set. If `target="_blank"` is set and
 - Type: `string | undefined`
 - Default: `-`
 
+#### resetFormControl (JS only)
+
+
+
+- Type: `resetFormControl() => void`
+- Default: `-`
+
 #### shadowRootOptions (JS only)
 
 Shadow root configuration.

package/dist/docs/card/api.md

@@ -9,6 +9,7 @@ Unless otherwise noted all properties are HTML attributes (as opposed to JavaScr
 | buttonText (JS only) | `unknown` | `-` | - |
 | clickable | `boolean` | `false` | Whether the whole card is interactive. |
 | flat | `boolean` | `false` | Whether the card uses the flat visual treatment. |
+| keypressed (JS only) | `keypressed(e: KeyboardEvent) => void` | `-` | - |
 | selected | `boolean` | `false` | Whether the card is visually selected. |
 
 ### Property Details
@@ -38,6 +39,13 @@ Flat cards use a bordered surface instead of the default elevated surface. Use t
 - Type: `boolean`
 - Default: `false`
 
+#### keypressed (JS only)
+
+
+
+- Type: `keypressed(e: KeyboardEvent) => void`
+- Default: `-`
+
 #### selected
 
 Whether the card is visually selected.

package/dist/docs/card/card.md

@@ -248,6 +248,7 @@ Unless otherwise noted all properties are HTML attributes (as opposed to JavaScr
 | buttonText (JS only) | `unknown` | `-` | - |
 | clickable | `boolean` | `false` | Whether the whole card is interactive. |
 | flat | `boolean` | `false` | Whether the card uses the flat visual treatment. |
+| keypressed (JS only) | `keypressed(e: KeyboardEvent) => void` | `-` | - |
 | selected | `boolean` | `false` | Whether the card is visually selected. |
 
 ### Property Details
@@ -277,6 +278,13 @@ Flat cards use a bordered surface instead of the default elevated surface. Use t
 - Type: `boolean`
 - Default: `false`
 
+#### keypressed (JS only)
+
+
+
+- Type: `keypressed(e: KeyboardEvent) => void`
+- Default: `-`
+
 #### selected
 
 Whether the card is visually selected.