@banzamel/mineralui 2.4.2 → 2.5.1

package/dist/components/layout/MDivider/MDivider.d.ts

@@ -1,2 +1,2 @@
 import { MDividerProps } from './MDivider.types';
-export declare function MDivider({ orientation, variant, hidden, spacing, padding, fsize, mt, mb, ml, mr, mx, my, pt, pb, pl, pr, px, py, fullWidth, className, style, ...rest }: MDividerProps): import("react/jsx-runtime").JSX.Element;
+export declare function MDivider({ orientation, variant, hidden, hiddenAbove, spacing, padding, fsize, mt, mb, ml, mr, mx, my, pt, pb, pl, pr, px, py, fullWidth, className, style, ...rest }: MDividerProps): import("react/jsx-runtime").JSX.Element;

package/dist/components/layout/MFooter/MFooter.d.ts

@@ -1,2 +1,2 @@
 import { MFooterProps } from './MFooter.types';
-export declare function MFooter({ container, padded, bordered, tone, hidden, spacing, padding, fsize, mt, mb, ml, mr, mx, my, pt, pb, pl, pr, px, py, fullWidth, className, style, children, ...rest }: MFooterProps): import("react/jsx-runtime").JSX.Element;
+export declare function MFooter({ container, padded, bordered, tone, hidden, hiddenAbove, spacing, padding, fsize, mt, mb, ml, mr, mx, my, pt, pb, pl, pr, px, py, fullWidth, className, style, children, ...rest }: MFooterProps): import("react/jsx-runtime").JSX.Element;

package/dist/components/layout/MHeader/MHeader.d.ts

@@ -1,2 +1,2 @@
 import { MHeaderProps } from './MHeader.types';
-export declare function MHeader({ container, padded, bordered, sticky, tone, layout, hidden, className, children, ...rest }: MHeaderProps): import("react/jsx-runtime").JSX.Element;
+export declare function MHeader({ container, padded, bordered, sticky, tone, layout, hidden, hiddenAbove, className, children, ...rest }: MHeaderProps): import("react/jsx-runtime").JSX.Element;

package/dist/components/layout/MInline/MInline.d.ts

@@ -1,2 +1,2 @@
 import { MInlineProps } from './MInline.types';
-export declare function MInline({ align, justify, wrap, hidden, padding, fsize, mt, mb, ml, mr, mx, my, pt, pb, pl, pr, px, py, fullWidth, className, style, children, ...rest }: MInlineProps): import("react/jsx-runtime").JSX.Element;
+export declare function MInline({ align, justify, wrap, hidden, hiddenAbove, padding, fsize, mt, mb, ml, mr, mx, my, pt, pb, pl, pr, px, py, fullWidth, className, style, children, ...rest }: MInlineProps): import("react/jsx-runtime").JSX.Element;

package/dist/components/layout/MNavbar/MNavbar.d.ts

@@ -1,2 +1,2 @@
 import { MNavbarProps } from './MNavbar.types';
-export declare function MNavbar({ container, padded, bordered, sticky, tone, justify, wrap, mobileMenu, mobileMenuContent, mobileMenuFooter, collapseActions, mobileMenuLabel, mobileBreakpoint, hidden, className, children, ...rest }: MNavbarProps): import("react/jsx-runtime").JSX.Element;
+export declare function MNavbar({ container, padded, bordered, sticky, tone, justify, wrap, mobileMenu, mobileMenuContent, mobileMenuFooter, collapseActions, mobileMenuLabel, mobileBreakpoint, hidden, hiddenAbove, className, children, ...rest }: MNavbarProps): import("react/jsx-runtime").JSX.Element;

package/dist/components/layout/MNavbar/MNavbar.types.d.ts

@@ -33,6 +33,8 @@ export interface MNavbarProps extends Omit<HTMLAttributes<HTMLElement>, 'hidden'
      * backward compatibility.
      */
     collapseActions?: boolean;
+    /** Accessible name of the burger toggle. Defaults to the `mineralui.navbar.menu`
+     *  i18n key ('Open navigation'). */
     mobileMenuLabel?: string;
     mobileBreakpoint?: number;
     children?: ReactNode;

package/dist/components/layout/MSection/MSection.d.ts

@@ -1,2 +1,2 @@
 import { MSectionProps } from './MSection.types';
-export declare function MSection({ as, spacing, tone, hidden, className, style, children, ...rest }: MSectionProps): import("react/jsx-runtime").JSX.Element;
+export declare function MSection({ as, spacing, tone, hidden, hiddenAbove, className, style, children, ...rest }: MSectionProps): import("react/jsx-runtime").JSX.Element;

package/dist/components/layout/MStack/MStack.d.ts

@@ -1,2 +1,2 @@
 import { MStackProps } from './MStack.types';
-export declare function MStack({ align, hidden, spacing, padding, fsize, mt, mb, ml, mr, mx, my, pt, pb, pl, pr, px, py, fullWidth, className, style, children, ...rest }: MStackProps): import("react/jsx-runtime").JSX.Element;
+export declare function MStack({ align, hidden, hiddenAbove, spacing, padding, fsize, mt, mb, ml, mr, mx, my, pt, pb, pl, pr, px, py, fullWidth, className, style, children, ...rest }: MStackProps): import("react/jsx-runtime").JSX.Element;

package/dist/components/layout/MStickyPanel/MStickyPanel.types.d.ts

@@ -14,6 +14,10 @@ export interface MStickyPanelProps extends Omit<HTMLAttributes<HTMLDivElement>,
      *  interactive descendant (matches `button, a, [role="button"]`) so
      *  action buttons remain clickable. Default true. */
     draggable?: boolean;
+    /** Accessible name. When set, the panel is exposed as a named `region`
+     *  landmark. The panel is always keyboard-focusable (`tabIndex={0}`) so its
+     *  content can be scrolled from the keyboard; pass `tabIndex={-1}` to opt out. */
+    label?: string;
     className?: string;
     style?: CSSProperties;
 }

package/dist/components/layout/MSurface/MSurface.d.ts

@@ -1,2 +1,2 @@
 import { MSurfaceProps } from './MSurface.types';
-export declare function MSurface({ component, to, href, target, rel, tone, outlined, padded, hidden, spacing, padding, fsize, mt, mb, ml, mr, mx, my, pt, pb, pl, pr, px, py, fullWidth, className, style, children, ...rest }: MSurfaceProps): import("react/jsx-runtime").JSX.Element;
+export declare function MSurface({ component, to, href, target, rel, tone, outlined, padded, hidden, hiddenAbove, spacing, padding, fsize, mt, mb, ml, mr, mx, my, pt, pb, pl, pr, px, py, fullWidth, className, style, children, ...rest }: MSurfaceProps): import("react/jsx-runtime").JSX.Element;

package/dist/components/media/MAvatar/MAvatar.d.ts

@@ -1,2 +1,2 @@
 import { MAvatarProps } from './MAvatar.types';
-export declare function MAvatar({ src, alt, name, initials, size, shape, hidden, color, badge, badgeColor, badgePulsing, presence, backgroundColor, clickEffect, rippleColor, skeleton, className, style, onPointerDown, ...rest }: MAvatarProps): import("react/jsx-runtime").JSX.Element;
+export declare function MAvatar({ src, alt, name, initials, size, shape, hidden, hiddenAbove, color, badge, badgeColor, badgePulsing, presence, backgroundColor, clickEffect, rippleColor, skeleton, className, style, onPointerDown, href, target, rel, ...rest }: MAvatarProps): import("react/jsx-runtime").JSX.Element;

package/dist/components/media/MAvatar/MAvatar.types.d.ts

@@ -28,5 +28,15 @@ export interface MAvatarProps extends Omit<HTMLAttributes<HTMLSpanElement>, 'col
     rippleColor?: string;
     /** Show skeleton placeholder instead of content */
     skeleton?: boolean;
+    /**
+     * Render the avatar as a real link (`<a href>`). Without `href`, an `onClick` handler renders a
+     * native `<button type="button">` (unless `role` / `tabIndex` are set by hand, which keeps the
+     * legacy `<span>`).
+     */
+    href?: string;
+    /** Link target, used together with `href`. */
+    target?: string;
+    /** Link relation, used together with `href`. Defaults to `noopener noreferrer` for `target="_blank"`. */
+    rel?: string;
     style?: CSSProperties;
 }

package/dist/components/media/MCarousel/MCarousel.d.ts

@@ -1,2 +1,2 @@
 import { MCarouselProps } from './MCarousel.types';
-export declare function MCarousel({ autoPlay, interval, showDots, showArrows, loop, draggable, transition, className, children, ...rest }: MCarouselProps): import("react/jsx-runtime").JSX.Element | null;
+export declare function MCarousel({ autoPlay, interval, showDots, showArrows, loop, draggable, transition, className, children, onMouseEnter, onMouseLeave, onFocus, onBlur, onKeyDown, ...rest }: MCarouselProps): import("react/jsx-runtime").JSX.Element | null;

package/dist/components/media/MImage/MImage.d.ts

@@ -1,2 +1,2 @@
 import { MImageProps } from './MImage.types';
-export declare function MImage({ src, fit, ratio, width, height, hidden, rounded, bordered, shadow, preview, previewGroup, hoverEffect, clickEffect, fallback, skeleton, className, style, alt, onError, ...rest }: MImageProps): import("react/jsx-runtime").JSX.Element;
+export declare function MImage({ src, fit, ratio, width, height, hidden, hiddenAbove, rounded, bordered, shadow, preview, previewGroup, hoverEffect, clickEffect, fallback, skeleton, className, style, alt, onError, ...rest }: MImageProps): import("react/jsx-runtime").JSX.Element;

package/dist/components/media/carouselA11y.d.ts

@@ -0,0 +1,9 @@
+import { KeyboardEvent } from 'react';
+/**
+ * Slide step for an arrow key pressed inside a carousel: -1 (previous), 1 (next) or `null`
+ * when the key is not a carousel key or belongs to a widget that uses arrows itself.
+ * Left / Right are flipped in right-to-left layouts.
+ */
+export declare function getCarouselKeyStep(event: KeyboardEvent<HTMLElement>): -1 | 1 | null;
+/** Live `prefers-reduced-motion: reduce` flag (false on the server). */
+export declare function usePrefersReducedMotion(): boolean;

package/dist/components/overlays/MCommandPalette/MCommandPalette.d.ts

@@ -1,2 +1,2 @@
 import { MCommandPaletteProps } from './MCommandPalette.types';
-export declare function MCommandPalette({ items, featuredItems, open, defaultOpen, onOpenChange, onSelect, title, description, trigger, shortcut, placeholder, emptyLabel, footer, size, closeOnSelect, }: MCommandPaletteProps): import("react/jsx-runtime").JSX.Element;
+export declare function MCommandPalette({ items, featuredItems, open, defaultOpen, onOpenChange, onSelect, title: titleProp, description, trigger, shortcut, placeholder: placeholderProp, emptyLabel: emptyLabelProp, footer, size, closeOnSelect, }: MCommandPaletteProps): import("react/jsx-runtime").JSX.Element;

package/dist/components/overlays/MDropdownMenu/MDropdownMenu.d.ts

@@ -1,9 +1,11 @@
+import { UseKeyboardNavItemProps } from '../../../utils/useKeyboardNav';
 import { MDropdownMenuProps, MDropdownItemProps, MDropdownGroupProps, MDropdownDividerProps } from './MDropdownMenu.types';
 export declare function MDropdownMenu({ trigger, placement, closeOnSelect, openOn, onOpenChange, isolateClick, className, style, popoverClassName, popoverStyle, children, }: MDropdownMenuProps): import("react/jsx-runtime").JSX.Element;
-export declare function MDropdownItem({ icon, label, description, role, checked, href, to, onClick, color, disabled, active, component, className, _active, _onHover, _onClick, }: MDropdownItemProps & {
+export declare function MDropdownItem({ icon, label, description, role, checked, href, to, onClick, color, disabled, active, component, className, _active, _onHover, _onClick, _navProps, }: MDropdownItemProps & {
     _active?: boolean;
     _onHover?: () => void;
     _onClick?: () => void;
+    _navProps?: UseKeyboardNavItemProps;
 }): import("react/jsx-runtime").JSX.Element;
-export declare function MDropdownGroup({ label, children }: MDropdownGroupProps): import("react/jsx-runtime").JSX.Element;
+export declare function MDropdownGroup({ label, className, children }: MDropdownGroupProps): import("react/jsx-runtime").JSX.Element;
 export declare function MDropdownDivider({ className }: MDropdownDividerProps): import("react/jsx-runtime").JSX.Element;

package/dist/components/overlays/MDropdownMenu/MDropdownMenu.types.d.ts

@@ -37,7 +37,9 @@ export interface MDropdownItemProps {
     className?: string;
 }
 export interface MDropdownGroupProps {
-    label: string;
+    /** Visible group heading; it also names the `role="group"` for assistive technology. */
+    label: ReactNode;
+    className?: string;
     children: ReactNode;
 }
 export interface MDropdownDividerProps {

package/dist/components/overlays/MPopconfirm/MPopconfirm.d.ts

@@ -1,2 +1,2 @@
 import { MPopconfirmProps } from './MPopconfirm.types';
-export declare function MPopconfirm({ title, description, onConfirm, onCancel, confirmText, cancelText, color, icon, placement, open, onOpenChange, anchorRef, className, }: MPopconfirmProps): import("react/jsx-runtime").JSX.Element;
+export declare function MPopconfirm({ title, description, onConfirm, onCancel, confirmText: confirmTextProp, cancelText: cancelTextProp, color, icon, placement, open, onOpenChange, anchorRef, className, }: MPopconfirmProps): import("react/jsx-runtime").JSX.Element;

package/dist/components/overlays/scrollLock.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Reference-counted body scroll lock shared by blocking overlays (MModal, MDrawer, MSheet).
+ *
+ * Each overlay used to save `body.style.overflow`, set it to `hidden` and restore the
+ * saved value on close. With nested overlays closed in the "wrong" order (the outer one
+ * first) the inner one restored `hidden` after the outer one had already unlocked, or the
+ * outer one unlocked while the inner one was still open. A shared counter keeps the page
+ * locked while ANY overlay holds a lock and restores the original value once the last
+ * one releases it.
+ */
+/** Locks body scrolling and returns an idempotent release function. */
+export declare function lockBodyScroll(): () => void;
+/** Test-only helper — the counter is module state that outlives a render. */
+export declare function __resetBodyScrollLock(): void;

package/dist/components/primitives/MPopover/MPopover.d.ts

@@ -1,2 +1,2 @@
 import { MPopoverProps } from './MPopover.types';
-export declare function MPopover({ open, anchorRef, onClose, placement, matchWidth, offset, zIndex, children, className, style, }: MPopoverProps): import("react/jsx-runtime").JSX.Element | null;
+export declare function MPopover({ open, anchorRef, onClose, placement, matchWidth, offset, zIndex, children, className, style, role, 'aria-label': ariaLabel, 'aria-labelledby': ariaLabelledBy, 'aria-describedby': ariaDescribedBy, id, initialFocus, restoreFocus, closeOnTabOut, }: MPopoverProps): import("react/jsx-runtime").JSX.Element | null;

package/dist/components/primitives/MPopover/MPopover.types.d.ts

@@ -1,4 +1,4 @@
-import { ReactNode, CSSProperties, RefObject } from 'react';
+import { AriaRole, ReactNode, CSSProperties, RefObject } from 'react';
 export type MPopoverPlacement = 'bottom-start' | 'bottom-end' | 'top-start' | 'top-end' | 'right-start' | 'right-end' | 'left-start' | 'left-end';
 export interface MPopoverProps {
     open: boolean;
@@ -11,4 +11,35 @@ export interface MPopoverProps {
     children: ReactNode;
     className?: string;
     style?: CSSProperties;
+    /**
+     * ARIA role of the floating layer. Defaults to `'listbox'` for backward compatibility;
+     * pass `'dialog'` for forms / confirmations, `'menu'` for menus, or `null` when the
+     * content brings its own role (e.g. an inner `role="listbox"`).
+     */
+    role?: AriaRole | null;
+    /** Accessible name of the layer (useful with `role="dialog"`). */
+    'aria-label'?: string;
+    /** Id(s) of the element(s) naming the layer. */
+    'aria-labelledby'?: string;
+    /** Id(s) of the element(s) describing the layer. */
+    'aria-describedby'?: string;
+    /** Id of the layer element (e.g. for `aria-controls` on the anchor). */
+    id?: string;
+    /**
+     * Where focus goes once the popover is open and positioned:
+     * `'first'` — the first tabbable element inside (falls back to the layer itself),
+     * `'container'` — the layer itself, or a ref to a specific element.
+     * Omit to leave focus where it is (the default).
+     */
+    initialFocus?: 'first' | 'container' | RefObject<HTMLElement | null>;
+    /**
+     * When the popover closes while focus is inside it, move focus back to the anchor
+     * (or the first focusable element inside the anchor). Defaults to `true`.
+     */
+    restoreFocus?: boolean;
+    /**
+     * Close the popover when Tab / Shift+Tab moves focus out of it. Focus returns to the
+     * anchor first, so Tab continues from there in document order. Defaults to `false`.
+     */
+    closeOnTabOut?: boolean;
 }

package/dist/components/primitives/MPopover/popoverStack.d.ts

@@ -22,11 +22,19 @@ export interface PopoverRegistration {
 }
 export declare function nextPopoverId(): number;
 export declare function registerPopover(registration: PopoverRegistration): () => void;
+/** True while any popover is open — modal layers leave Escape to it. */
+export declare function hasOpenPopovers(): boolean;
 /**
  * True when `target` lies inside a popover that is nested (at any depth) within
  * the popover identified by `id`. Callers use it to keep a parent open while
  * the interaction belongs to one of its descendants.
  */
 export declare function isInsideDescendantPopover(id: number, target: Node | null): boolean;
+/**
+ * True when the popover identified by `id` is the top layer: the most recently
+ * opened popover that has no open popover nested inside it. Only the top layer
+ * reacts to Escape, so one key press peels off exactly one layer.
+ */
+export declare function isTopPopover(id: number): boolean;
 /** Test-only helper — the registry is module state that outlives a render. */
 export declare function __resetPopoverStack(): void;

package/dist/components/typography/MHeading/MHeading.d.ts

@@ -1,6 +1,6 @@
 import { CSSProperties } from 'react';
 import { MHeadingProps } from './MHeading.types';
-export declare function MHeading({ level, tone, hidden, color, truncate, className, style, children, ...rest }: MHeadingProps): import('react').DetailedReactHTMLElement<{
+export declare function MHeading({ level, tone, hidden, hiddenAbove, color, truncate, className, style, children, ...rest }: MHeadingProps): import('react').DetailedReactHTMLElement<{
     suppressHydrationWarning?: boolean | undefined | undefined;
     id?: string | undefined | undefined;
     lang?: string | undefined | undefined;
@@ -235,6 +235,7 @@ export declare function MHeading({ level, tone, hidden, color, truncate, classNa
     onTransitionStartCapture?: import('react').TransitionEventHandler<HTMLHeadingElement> | undefined;
     title?: string | undefined | undefined;
     content?: string | undefined | undefined;
+    dir?: string | undefined | undefined;
     popover?: "" | "auto" | "manual" | "hint" | undefined | undefined;
     defaultChecked?: boolean | undefined | undefined;
     defaultValue?: string | number | readonly string[] | undefined;
@@ -244,7 +245,6 @@ export declare function MHeading({ level, tone, hidden, color, truncate, classNa
     autoFocus?: boolean | undefined | undefined;
     contentEditable?: "inherit" | (boolean | "true" | "false") | "plaintext-only" | undefined;
     contextMenu?: string | undefined | undefined;
-    dir?: string | undefined | undefined;
     draggable?: (boolean | "true" | "false") | undefined;
     enterKeyHint?: "enter" | "done" | "go" | "next" | "previous" | "search" | "send" | undefined | undefined;
     spellCheck?: (boolean | "true" | "false") | undefined;
@@ -276,7 +276,6 @@ export declare function MHeading({ level, tone, hidden, color, truncate, classNa
     inputMode?: "none" | "text" | "tel" | "url" | "email" | "numeric" | "decimal" | "search" | undefined | undefined;
     is?: string | undefined | undefined;
     exportparts?: string | undefined | undefined;
-    hiddenAbove?: import('../../..').MHidden;
     className: string;
     style: CSSProperties | undefined;
 }, HTMLElement>;

package/dist/components/typography/MSubText/MSubText.d.ts

@@ -1,2 +1,2 @@
 import { MSubTextProps } from './MSubText.types';
-export declare function MSubText({ as, size, tone, hidden, color, className, children, ...rest }: MSubTextProps): import("react/jsx-runtime").JSX.Element;
+export declare function MSubText({ as, size, tone, hidden, hiddenAbove, color, className, children, ...rest }: MSubTextProps): import("react/jsx-runtime").JSX.Element;

package/dist/components/typography/MText/MText.d.ts

@@ -1,2 +1,2 @@
 import { MTextProps } from './MText.types';
-export declare function MText({ as, tone, size, align, hidden, color, weight, truncate, spacing, padding, fsize, mt, mb, ml, mr, mx, my, pt, pb, pl, pr, px, py, fullWidth, className, style, children, ...rest }: MTextProps): import("react/jsx-runtime").JSX.Element;
+export declare function MText({ as, tone, size, align, hidden, hiddenAbove, color, weight, truncate, spacing, padding, fsize, mt, mb, ml, mr, mx, my, pt, pb, pl, pr, px, py, fullWidth, className, style, children, ...rest }: MTextProps): import("react/jsx-runtime").JSX.Element;