@iress-oss/ids-components 5.20.2 → 5.20.3

package/dist/src/components/Toaster/Toaster.types.d.ts

@@ -0,0 +1,37 @@
+import { DetailedHTMLProps, HTMLAttributes, PropsWithChildren } from 'react';
+import { IressToastProps, ToastAnimation } from './Toast/Toast.types';
+import { FloatingUIContainer } from '../../types';
+export type ToastItem = IressToastProps & {
+    id: string;
+    content?: React.ReactNode;
+};
+export interface IressToasterOptions {
+    /**
+     * The position on the screen where the toast will appear.
+     * @default bottom-end
+     */
+    position?: ToasterPosition | ToasterPositions;
+    /**
+     * The container element to render the toaster into.
+     * By default, the toaster will render at the end of the document body.
+     */
+    container?: FloatingUIContainer;
+}
+export interface IressToasterProps extends React.HTMLAttributes<HTMLDivElement>, IressToasterOptions {
+    toasts?: ToastItem[];
+}
+export interface IressToasterProviderProps extends PropsWithChildren, IressToasterOptions {
+}
+/** @deprecated IressToaster.Position is now deprecated and will be removed in a future version. Please use the value directly. **/
+export declare enum ToasterPosition {
+    BottomStart = "bottom-start",
+    BottomCenter = "bottom-center",
+    BottomEnd = "bottom-end",
+    TopStart = "top-start",
+    TopCenter = "top-center",
+    TopEnd = "top-end"
+}
+export declare const TOASTER_POSITION: readonly ["bottom-center", "bottom-end", "bottom-start", "top-center", "top-end", "top-start"];
+export type ToasterPositions = (typeof TOASTER_POSITION)[number];
+export declare const TOAST_POSITION_ANIMATION_MATRIX: Record<ToasterPosition, ToastAnimation>;
+export declare const TOASTER_ARIA_ATTRIBUTES: DetailedHTMLProps<HTMLAttributes<HTMLDivElement>, HTMLDivElement>;

package/dist/src/components/Toaster/ToasterProvider.d.ts

@@ -0,0 +1,14 @@
+import { MouseEvent } from 'react';
+import { IressToasterOptions, IressToasterProviderProps } from './Toaster.types';
+import { IressToastProps } from './Toast/Toast.types';
+import { ButtonRef } from '../Button';
+interface ToasterContextValue {
+    animateOut: (id: string) => void;
+    show: (toast: IressToastProps) => string;
+    close: (id: string, e?: MouseEvent<ButtonRef>) => void;
+    options: IressToasterOptions;
+    setOptions: (options: IressToasterOptions) => void;
+}
+export declare const ToasterContext: import('react').Context<ToasterContextValue | undefined>;
+export declare const IressToasterProvider: ({ children, ...defaultOptions }: IressToasterProviderProps) => import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/src/components/Toaster/hooks/useToaster.d.ts

@@ -0,0 +1,9 @@
+import { NewToast } from '../Toast/Toast.types';
+import { ToasterPositions } from '../Toaster.types';
+export declare const useToaster: (position?: ToasterPositions) => {
+    success: (toast: NewToast) => string;
+    error: (toast: NewToast) => string;
+    info: (toast: NewToast) => string;
+    close: (id: string) => void;
+    options: import('..').IressToasterOptions;
+};

package/dist/src/components/Toaster/index.d.ts

@@ -0,0 +1,5 @@
+export * from './Toast/Toast.types';
+export * from './Toaster.types';
+export * from './Toast/Toast';
+export * from './ToasterProvider';
+export * from './hooks/useToaster';

package/dist/src/components/Toggle/Toggle.d.ts

@@ -0,0 +1,2 @@
+import { ToggleWithEnums } from './Toggle.types';
+export declare const IressToggle: ToggleWithEnums;

package/dist/src/components/Toggle/Toggle.types.d.ts

@@ -0,0 +1,45 @@
+import { ReactNode } from 'react';
+import { IressHTMLAttributes } from '../../interfaces';
+export interface ToggleProps extends Omit<IressHTMLAttributes, 'onChange'> {
+    /**
+     * Sets the checked state of the Toggle.
+     */
+    checked?: boolean;
+    /**
+     * 	Provides the label for the Toggle.
+     */
+    children: ReactNode;
+    /**
+     * Hides the label if true (label will still be read out by screen readers).
+     */
+    hiddenLabel?: boolean;
+    /**
+     * Determines the layout of the label with respect to the control.
+     */
+    layout?: ToggleLayout | ToggleLayouts;
+    /**
+     * Emitted when the checked state changes.
+     */
+    onChange?: (checked: boolean, event: React.MouseEvent<HTMLButtonElement, MouseEvent>) => void;
+}
+export interface ToggleLabelProps extends IressHTMLAttributes {
+    /**
+     * Hides the label if true (label will still be read out by screen readers)
+     */
+    hiddenLabel?: boolean;
+}
+/**
+ * @deprecated The ToggleLayout enum will be removed in future versions of IDS. Please use the ToggleLayouts type instead.
+ */
+export declare enum ToggleLayout {
+    Inline = "inline",
+    InlineBetween = "inline-between",
+    InlineReverse = "inline-reverse",
+    Stack = "stack"
+}
+export declare const TOGGLE_LAYOUTS: readonly ["inline", "inline-between", "inline-reverse", "stack"];
+export type ToggleLayouts = (typeof TOGGLE_LAYOUTS)[number];
+export interface ToggleWithEnums extends React.ForwardRefExoticComponent<ToggleProps & React.RefAttributes<HTMLDivElement>> {
+    /** @deprecated The IressToggle.Layout enum will be removed in future versions of IDS. Please use the value directly instead. */
+    Layout: typeof ToggleLayout;
+}

package/dist/src/components/Toggle/index.d.ts

@@ -0,0 +1,2 @@
+export * from './Toggle.types';
+export * from './Toggle';

package/dist/src/components/Tooltip/Tooltip.d.ts

@@ -0,0 +1,2 @@
+import { TooltipWithEnums } from './Tooltip.types';
+export declare const IressTooltip: TooltipWithEnums;

package/dist/src/components/Tooltip/Tooltip.types.d.ts

@@ -0,0 +1,33 @@
+import { FloatingUIAligns } from '../../main';
+import { FloatingUIAlign } from '../../enums';
+import { IressHTMLAttributes } from '../../interfaces';
+import { ReactNode } from 'react';
+export interface IressTooltipProps extends IressHTMLAttributes {
+    /**
+     * Sets the alignment of the popover relative to the activator element.
+     * @default top
+     */
+    align?: FloatingUIAlign | FloatingUIAligns;
+    /**
+     * The element to add a tooltip to.
+     */
+    children: ReactNode;
+    /**
+     * Sets the tooltip display delay in milliseconds.
+     * @default 500
+     */
+    delay?: number;
+    /**
+     * Only used for internal testing.
+     * @default false
+     */
+    open?: boolean;
+    /**
+     * Sets the tooltip text. Can accept a string or an array of strings - if given an array, will output each string on a new line.
+     */
+    tooltipText: string | string[];
+}
+export interface TooltipWithEnums extends React.FC<IressTooltipProps> {
+    /** @deprecated IressTooltip.Align is now deprecated and will be removed in a future version. Please use the GutterSizes type instead. */
+    Align: typeof FloatingUIAlign;
+}

package/dist/src/components/Tooltip/index.d.ts

@@ -0,0 +1,2 @@
+export * from './Tooltip.types';
+export * from './Tooltip';

package/dist/src/components/ValidationMessage/ValidationBase/ValidationBase.d.ts

@@ -0,0 +1,2 @@
+import { ValidationBaseProps } from './ValidationBase.types';
+export declare const ValidationBase: ({ as: BaseTag, children, className, prefix, status, visiblePrefix, ...restProps }: ValidationBaseProps) => import("react/jsx-runtime").JSX.Element;

package/dist/src/components/ValidationMessage/ValidationBase/ValidationBase.types.d.ts

@@ -0,0 +1,27 @@
+import { IressAnchorHTMLAttributes, SystemValidationStatus, SystemValidationStatuses } from '../../../main';
+import { ElementType, ReactNode } from 'react';
+export type ValidationBaseProps<T = ElementType, U = IressAnchorHTMLAttributes<T>> = Omit<U, 'prefix'> & {
+    /**
+     * The base tag of the label.
+     * @default label
+     */
+    as?: T;
+    /**
+     * Validation content (what went wrong, what went right).
+     */
+    children?: ReactNode;
+    /**
+     * Prefix to the validation message. Will be `status` prop if nothing is provided.
+     */
+    prefix?: ReactNode;
+    /**
+     * Whether message is danger, warning, success or info.
+     * **Note**: danger is translated to Error when used as the prefix.
+     * @default danger
+     **/
+    status?: SystemValidationStatus | SystemValidationStatuses;
+    /**
+     * If set to true, the prefix will be visually displayed (default is only available to screen readers)
+     */
+    visiblePrefix?: boolean;
+};

package/dist/src/components/ValidationMessage/ValidationLink/ValidationLink.d.ts

@@ -0,0 +1,2 @@
+import { IressValidationLinkProps } from './ValidationLink.types';
+export declare const IressValidationLink: ({ linkToTarget, ...props }: IressValidationLinkProps) => import("react/jsx-runtime").JSX.Element;

package/dist/src/components/ValidationMessage/ValidationLink/ValidationLink.types.d.ts

@@ -0,0 +1,12 @@
+import { ReactNode } from 'react';
+import { ValidationBaseProps } from '../ValidationBase/ValidationBase.types';
+export interface IressValidationLinkProps extends Omit<ValidationBaseProps<'a'>, 'as'> {
+    /**
+     * Validation content (what went wrong, what went right).
+     */
+    children?: ReactNode;
+    /**
+     * ID of element the message is describing. If nothing is supplied a link will not render.
+     */
+    linkToTarget: string;
+}

package/dist/src/components/ValidationMessage/ValidationMessage.d.ts

@@ -0,0 +1,2 @@
+import { ValidationMessageWithEnums } from './ValidationMessage.types';
+export declare const IressValidationMessage: ValidationMessageWithEnums;

package/dist/src/components/ValidationMessage/ValidationMessage.types.d.ts

@@ -0,0 +1,13 @@
+import { ReactNode } from 'react';
+import { ValidationBaseProps } from './ValidationBase/ValidationBase.types';
+import { IressHTMLAttributes, SystemValidationStatus } from '../../main';
+export interface IressValidationMessageProps extends Omit<ValidationBaseProps<'div', IressHTMLAttributes<'div'>>, 'as'> {
+    /**
+     * Validation content (what went wrong, what went right).
+     */
+    children?: ReactNode;
+}
+export interface ValidationMessageWithEnums extends React.FC<IressValidationMessageProps> {
+    /** @deprecated IressValidationMessage.Status enum is now deprecated and will be removed in a future version. Please use the SystemValidationStatuses type instead. **/
+    Status: typeof SystemValidationStatus;
+}

package/dist/src/components/ValidationMessage/ValidationSummary/ValidationSummary.d.ts

@@ -0,0 +1,2 @@
+import { IressValidationSummaryProps } from './ValidationSummary.types';
+export declare const IressValidationSummary: ({ messages, linkToTarget, prefix, visiblePrefix, status, className, "data-testid": dataTestId, ...restProps }: IressValidationSummaryProps) => import("react/jsx-runtime").JSX.Element | null;

package/dist/src/components/ValidationMessage/ValidationSummary/ValidationSummary.types.d.ts

@@ -0,0 +1,27 @@
+import { ReactNode } from 'react';
+import { IressHTMLAttributes, ValidationMessageObj } from '../../../interfaces';
+import { SystemValidationStatus } from '../../../enums';
+import { SystemValidationStatuses } from '../../../main';
+export interface IressValidationSummaryProps extends Omit<IressHTMLAttributes<HTMLUListElement>, 'prefix'> {
+    /**
+     * ValidationMessage Array containing the `id` of the field and the validation message
+     **/
+    messages: ValidationMessageObj[];
+    /**
+     * Renders validation messages as links pointing at the field it relates to, specified as a string
+     * Only works when used with the `messages` prop.
+     */
+    linkToTarget?: string;
+    /**
+     * Prefix to all validation messages. Will be `status` prop if nothing is provided.
+     */
+    prefix?: ReactNode;
+    /**
+     * Status for all child ValidationMessage components
+     */
+    status?: SystemValidationStatus | SystemValidationStatuses;
+    /**
+     * If set to true, the prefix will be visually displayed (default is only available to screen readers)
+     */
+    visiblePrefix?: boolean;
+}

package/dist/src/components/ValidationMessage/index.d.ts

@@ -0,0 +1,6 @@
+export * from './ValidationMessage';
+export * from './ValidationMessage.types';
+export * from './ValidationLink/ValidationLink';
+export * from './ValidationLink/ValidationLink.types';
+export * from './ValidationSummary/ValidationSummary';
+export * from './ValidationSummary/ValidationSummary.types';

package/dist/src/constants.d.ts

@@ -0,0 +1,123 @@
+/**
+ * Breakpoints are the points at which the layout of a page will change in response to the size of the viewport.
+ */
+export declare const BREAKPOINT_DETAILS: {
+    /**
+     * Extra small breakpoint, for mobile devices
+     */
+    xs: {
+        mediaQuery: string;
+        screenWidthRange: string;
+        minScreenWidth: string;
+        maxScreenWidth: string;
+        containerMaxWidth: string;
+        viewportWidth: number;
+    };
+    /**
+     * Small breakpoint, for larger mobile devices and tablets
+     */
+    sm: {
+        mediaQuery: string;
+        screenWidthRange: string;
+        minScreenWidth: string;
+        maxScreenWidth: string;
+        containerMaxWidth: string;
+        viewportWidth: number;
+    };
+    /**
+     * Medium breakpoint for tablets and small desktops
+     */
+    md: {
+        mediaQuery: string;
+        screenWidthRange: string;
+        minScreenWidth: string;
+        maxScreenWidth: string;
+        containerMaxWidth: string;
+        viewportWidth: number;
+    };
+    /**
+     * Large breakpoint for desktops
+     */
+    lg: {
+        mediaQuery: string;
+        screenWidthRange: string;
+        minScreenWidth: string;
+        maxScreenWidth: string;
+        containerMaxWidth: string;
+        viewportWidth: number;
+    };
+    /**
+     * Extra large breakpoint for large desktops
+     */
+    xl: {
+        mediaQuery: string;
+        screenWidthRange: string;
+        minScreenWidth: string;
+        maxScreenWidth: string;
+        containerMaxWidth: string;
+        viewportWidth: number;
+    };
+    /**
+     * Extra extra large breakpoint for extra large desktops (32inch)
+     */
+    xxl: {
+        mediaQuery: string;
+        screenWidthRange: string;
+        minScreenWidth: string;
+        containerMaxWidth: string;
+        viewportWidth: number;
+    };
+};
+export declare const BREAKPOINTS: (keyof typeof BREAKPOINT_DETAILS)[];
+export declare const CSS_IDS_VERSION: string;
+export declare const DISPLAY_MODES: readonly ["inline", "overlay"];
+export declare const FLOATING_UI_ALIGNS: readonly ["auto", "bottom-start", "bottom", "bottom-end", "top-start", "top", "top-end", "left-start", "left", "left-end", "right-start", "right", "right-end"];
+export declare const FOCUSABLE_QUERY_SELECTOR = "button, a[href], input, select, textarea, [tabindex]:not([tabindex=\"-1\"])";
+export declare const FORM_ELEMENT_WIDTHS: readonly ["2", "4", "6", "8", "10", "12", "16", "25perc", "50perc", "75perc", "100perc"];
+/**
+ * The grid size is the base unit of the grid system.
+ */
+export declare const GRID_SIZE = 12;
+export declare const GUTTER_SIZES: readonly ["none", "xs", "sm", "md", "lg", "xl"];
+export declare const HEADING_LEVELS: readonly ["h2", "h3", "h4", "h5", "h6"];
+export declare const HORIZONTAL_ALIGNS: readonly ["around", "between", "center", "evenly", "left", "right"];
+export declare const LOGGER_LEVELS: readonly ["log", "warn", "error"];
+export declare const PADDING_SIZES: readonly ["none", "sm", "md", "lg"];
+export declare const SYSTEM_VALIDATION_STATUSES: readonly ["danger", "info", "success", "warning"];
+export declare const TEXT_ALIGNS: readonly ["inherit", "left", "center", "right", "justify"];
+export declare const TEXT_MODES: readonly ["danger", "info", "muted", "primary", "success", "warning", "positive", "negative"];
+export declare const TEXT_VARIANTS: readonly ["blockquote", "body", "bold", "code", "display", "display1", "display2", "display3", "display4", "h1", "h2", "h3", "h4", "h5", "h6", "italic", "lead", "small", "cite", "caption"];
+export declare const VERTICAL_ALIGNS: readonly ["top", "middle", "bottom", "stretch"];
+/**
+ * The z-index determines the stacking order of elements. Elements with a higher z-index always sit in front of elements with a lower z-index. Each index has been mapped to the appropriate elevation(s).
+ */
+export declare const Z_INDEX: {
+    /**
+     * The default z-index used for most elements. Can be combined with raised and floating elevations.
+     */
+    DEFAULT: number;
+    /**
+     * Used for IressNavbar. Can be combined with overflow elevation.
+     */
+    NAVBAR: number;
+    /**
+     * Used for IressPopover. Can be combined with floating elevation.
+     */
+    POPOVER: number;
+    /**
+     * Used for IressSlideout. Can be combined with floating elevation.
+     */
+    SLIDEOUT: number;
+    /**
+     * Used for IressModal. Can be combined with floating elevation.
+     */
+    MODAL: number;
+    /**
+     * Used for IressToast. Can be combined with floating elevation.
+     */
+    TOAST: number;
+    /**
+     * Used for IressTooltip. Can be combined with floating elevation.
+     */
+    TOOLTIP: number;
+};

package/dist/src/enums.d.ts

@@ -0,0 +1,215 @@
+export declare enum GlobalCSSClass {
+    FormElement = "iress-form-element",
+    FormElementInner = "iress-form-element__inner",
+    FormElementInvalid = "iress-form-element--invalid",
+    FormLabel = "iress-form-label",
+    SROnly = "iress-sr-only",
+    NoScroll = "iress-no-scroll",
+    Hidden = "iress-hidden",
+    IgnoreStack = "iress-u-stack--ignore",
+    TextAlignBase = "iress--text-align",
+    HiddenMobile = "iress-hidden--mobile",
+    Width = "iress-width",
+    Display = "iress-display",
+    Padding = "iress-p"
+}
+/** @deprecated Breakpoint enum is now deprecated and will be removed in a future version. Please use the Breakpoints type instead. **/
+export declare enum Breakpoint {
+    Xs = "xs",
+    Sm = "sm",
+    Md = "md",
+    Lg = "lg",
+    Xl = "xl",
+    Xxl = "xxl"
+}
+/** @deprecated DisplayMode enum is now deprecated and will be removed in a future version. Please use the DisplayModes type instead. **/
+export declare enum DisplayMode {
+    Inline = "inline",
+    Overlay = "overlay"
+}
+/** @deprecated HeadingLevel enum is now deprecated and will be removed in a future version. Please use the HeadingLevels type instead. */
+export declare enum HeadingLevel {
+    H2 = "h2",
+    H3 = "h3",
+    H4 = "h4",
+    H5 = "h5",
+    H6 = "h6"
+}
+/** @deprecated LoggerLevels enum is now deprecated and will be removed in a future version. Please use the LoggerLevels type instead. **/
+export declare enum LoggerLevels {
+    Log = "log",
+    Warn = "warn",
+    Error = "error"
+}
+/** @deprecated TextFieldType enum is now deprecated and will be removed in a future version. Please use the value directly instead. **/
+export declare enum TextFieldType {
+    Date = "date",
+    Email = "email",
+    Number = "number",
+    Password = "password",
+    Search = "search",
+    Tel = "tel",
+    Text = "text",
+    Url = "url",
+    Time = "time",
+    Color = "color",
+    File = "file",
+    DateTimeLocal = "datetime-local"
+}
+/** @deprecated FormElementType enum is now deprecated and will be removed in a future version. Please use the FormElementTypes type instead. **/
+export declare enum FormElementType {
+    Date = "date",
+    Email = "email",
+    Number = "number",
+    Password = "password",
+    Search = "search",
+    Tel = "tel",
+    Text = "text",
+    Url = "url",
+    Time = "time",
+    File = "file",
+    Color = "color",
+    Checkbox = "checkbox",
+    Radio = "radio",
+    Select = "select",
+    CheckboxGroup = "checkbox-group",
+    RadioGroup = "radio-group",
+    Combobox = "combobox",
+    DateTimeLocal = "datetime-local"
+}
+/** @deprecated FormElementWidth enum is now deprecated and will be removed in a future version. Please use the FormElementWidths type instead. **/
+export declare enum FormElementWidth {
+    Two = "2",
+    Four = "4",
+    Six = "6",
+    Eight = "8",
+    Ten = "10",
+    Twelve = "12",
+    Sixteen = "16",
+    TwentyFivePercent = "25perc",
+    FiftyPercent = "50perc",
+    SeventyFivePercent = "75perc"
+}
+/** @deprecated FloatingUIAlign enum is now deprecated and will be removed in a future version. Please use the FloatingUIAligns type instead. **/
+export declare enum FloatingUIAlign {
+    Auto = "auto",
+    BottomStart = "bottom-start",
+    BottomCenter = "bottom",
+    BottomEnd = "bottom-end",
+    TopStart = "top-start",
+    TopCenter = "top",
+    TopEnd = "top-end",
+    LeftStart = "left-start",
+    LeftCenter = "left",
+    LeftEnd = "left-end",
+    RightStart = "right-start",
+    RightCenter = "right",
+    RightEnd = "right-end"
+}
+/** @deprecated SystemValidationStatus enum is now deprecated and will be removed in a future version. Please use the SystemValidationStatuses type instead. **/
+export declare enum SystemValidationStatus {
+    Danger = "danger",
+    Info = "info",
+    Success = "success",
+    Warning = "warning"
+}
+/** @deprecated TextAlign enum is now deprecated and will be removed in a future version. Please use the TextAligns type instead. **/
+export declare enum TextAlign {
+    Inherit = "inherit",
+    Left = "left",
+    Center = "center",
+    Right = "right",
+    Justify = "justify"
+}
+/** @deprecated TextElement enum is now deprecated and will be removed in a future version. Please use the TextElements type instead. **/
+export declare enum TextElement {
+    P = "p",
+    Div = "div",
+    Span = "span",
+    H1 = "h1",
+    H2 = "h2",
+    H3 = "h3",
+    H4 = "h4",
+    H5 = "h5",
+    H6 = "h6",
+    Code = "code",
+    Blockquote = "blockquote",
+    Caption = "caption",
+    Cite = "cite",
+    Small = "small"
+}
+/** @deprecated TextMode enum is now deprecated and will be removed in a future version. Please use the TextModes type instead. **/
+export declare enum TextMode {
+    /** @deprecated TextMode.Body enum is deprecated and will be removed in a future version. Please use the variant prop instead. **/
+    Body = "body",
+    Danger = "danger",
+    Info = "info",
+    Muted = "muted",
+    Primary = "primary",
+    Success = "success",
+    Warning = "warning",
+    Positive = "positive",
+    Negative = "negative"
+}
+/** @deprecated TextVariant enum is now deprecated and will be removed in a future version. Please use the TextVariants type instead. **/
+export declare enum TextVariant {
+    Blockquote = "blockquote",
+    Bold = "bold",
+    Body = "body",
+    Code = "code",
+    Display = "display",
+    Display1 = "display1",
+    Display2 = "display2",
+    Display3 = "display3",
+    Display4 = "display4",
+    Heading1 = "h1",
+    Heading2 = "h2",
+    Heading3 = "h3",
+    Heading4 = "h4",
+    Heading5 = "h5",
+    Heading6 = "h6",
+    Italic = "italic",
+    Lead = "lead",
+    Small = "small",
+    Cite = "cite",
+    Caption = "caption"
+}
+/** @deprecated PaddingSize enum is now deprecated and will be removed in a future version. Please use the PaddingSizes type instead. **/
+export declare enum PaddingSize {
+    None = "none",
+    Sm = "sm",
+    Md = "md",
+    Lg = "lg"
+}
+/** @deprecated ModalSize enum is now deprecated and will be removed in a future version. Please use the ModalSizes type instead. **/
+export declare enum ModalSize {
+    Sm = "sm",
+    Md = "md",
+    Lg = "lg",
+    FullPage = "fullpage"
+}
+/** @deprecated GutterSize enum is now deprecated and will be removed in a future version. Please use the GutterSizes type instead. **/
+export declare enum GutterSize {
+    None = "none",
+    Xs = "xs",
+    Sm = "sm",
+    Md = "md",
+    Lg = "lg",
+    Xl = "xl"
+}
+/** @deprecated HorizontalAlign is now deprecated and will be removed in a future version. Please use the HorizontalAligns type instead. */
+export declare enum HorizontalAlign {
+    Around = "around",
+    Between = "between",
+    Center = "center",
+    Evenly = "evenly",
+    Left = "left",
+    Right = "right"
+}
+/** @deprecated VerticalAlign is now deprecated and will be removed in a future version. Please use the VerticalAligns type instead. */
+export declare enum VerticalAlign {
+    Bottom = "bottom",
+    Middle = "middle",
+    Stretch = "stretch",
+    Top = "top"
+}

package/dist/src/helpers/dom/closestCrossShadow.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Finds the closest ancestor element that matches the selector, traversing across shadow DOM boundaries.
+ * Similar to native Element.closest() but works across shadow DOM.
+ *
+ * @param element - The starting element
+ * @param selector - CSS selector to match against
+ * @returns The closest ancestor element matching the selector, or null if not found
+ */
+export declare const closestCrossShadow: (element: Element | null, selector: string) => Element | null;

package/dist/src/helpers/dom/domUtils.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Safely calls the closest method on an element, handling cases where the element
+ * might not have the closest method (e.g., in jsdom environments)
+ */
+export declare const safeClosest: (element: Element | null, selector: string) => Element | null;

package/dist/src/helpers/dom/focusableElements.d.ts

@@ -0,0 +1 @@
+export declare const focusableElements: (el: HTMLElement) => HTMLElement[];

package/dist/src/helpers/dom/getActiveElement.d.ts

@@ -0,0 +1 @@
+export declare const getActiveElement: () => HTMLElement;

package/dist/src/helpers/dom/hasShadowDom.d.ts

@@ -0,0 +1 @@
+export declare const hasShadowDom: (el: HTMLElement) => boolean;

package/dist/src/helpers/form/getFormControlValueAsString.d.ts

@@ -0,0 +1,2 @@
+import { FormControlValue } from '../../types';
+export declare const getFormControlValueAsString: (value?: FormControlValue) => string;

package/dist/src/helpers/form/getFormControlValueAsStringIfDefined.d.ts

@@ -0,0 +1,2 @@
+import { FormControlValue } from '../../types';
+export declare const getFormControlValueAsStringIfDefined: (value?: FormControlValue) => string | undefined;