import React from "react"; import { XmSnackbar as XmSnackbarElement } from "../lit/components/snackbar/index.js"; /** * A generic type for strongly typing custom events with their targets * @template T - The type of the event target (extends EventTarget) * @template D - The type of the detail payload for the custom event */ type TypedEvent = E & { target: T; }; /** `XmSnackbar` component event */ export type XmSnackbarElementEvent = TypedEvent< XmSnackbarElement, E >; export type { XmSnackbarElement }; export interface XmSnackbarProps extends Pick< React.AllHTMLAttributes, | "children" | "dir" | "hidden" | "id" | "lang" | "slot" | "style" | "title" | "translate" | "onClick" | "onFocus" | "onBlur" > { /** undefined */ showDismiss?: boolean; /** undefined */ static?: boolean; /** undefined */ kind?: XmSnackbarElement["kind"]; /** undefined */ code?: XmSnackbarElement["code"]; /** undefined */ title?: XmSnackbarElement["title"]; /** undefined */ message?: XmSnackbarElement["message"]; /** undefined */ primaryLabel?: XmSnackbarElement["primaryLabel"]; /** undefined */ secondaryLabel?: XmSnackbarElement["secondaryLabel"]; /** A space-separated list of the classes of the element. Classes allows CSS and JavaScript to select and access specific elements via the class selectors or functions like the method `Document.getElementsByClassName()`. */ className?: string; /** Contains a space-separated list of the part names of the element that should be exposed on the host element. */ exportparts?: string; /** Used for labels to link them with their inputs (using input id). */ htmlFor?: string; /** Used to help React identify which items have changed, are added, or are removed within a list. */ key?: number | string; /** Contains a space-separated list of the part names of the element. Part names allows CSS to select and style specific elements in a shadow tree via the ::part pseudo-element. */ part?: string; /** A mutable ref object whose `.current` property is initialized to the passed argument (`initialValue`). The returned object will persist for the full lifetime of the component. */ ref?: React.Ref; /** Allows developers to make HTML elements focusable, allow or prevent them from being sequentially focusable (usually with the `Tab` key, hence the name) and determine their relative ordering for sequential focus navigation. */ tabIndex?: number; /** Fired when the snackbar is dismissed. */ onSnackbarDismiss?: (event: XmSnackbarElementEvent) => void; /** Fired when the snackbar's primary action is activated. */ onSnackbarPrimary?: (event: XmSnackbarElementEvent) => void; } /** * * * ## Attributes & Properties * * Component attributes and properties that can be applied to the element or by using JavaScript. * * - `kind`: undefined * - `code`: undefined * - `title`: undefined * - `message`: undefined * - `primary-label`/`primaryLabel`: undefined * - `secondary-label`/`secondaryLabel`: undefined * - `show-dismiss`/`showDismiss`: undefined * - `static`: undefined * * ## Events * * Events that will be emitted by the component. * * - `snackbar-dismiss`: Fired when the snackbar is dismissed. * - `snackbar-primary`: Fired when the snackbar's primary action is activated. */ export const XmSnackbar: React.ForwardRefExoticComponent;