@lumx/react 4.17.0-next.1 → 4.17.0-next.3

package/index.d.ts

@@ -1,7 +1,7 @@
 import { HorizontalAlignment as HorizontalAlignment$1, Orientation as Orientation$1, Alignment as Alignment$1, Size as Size$1, AspectRatio as AspectRatio$1, ColorPalette as ColorPalette$1, Kind as Kind$1, Emphasis as Emphasis$1, Theme as Theme$1 } from '@lumx/core/js/constants';
 export * from '@lumx/core/js/constants';
 import * as _lumx_core_js_types from '@lumx/core/js/types';
-import { ValueOf as ValueOf$1, GenericProps as GenericProps$1, HasTheme as HasTheme$1, PropsToOverride, HasAriaDisabled as HasAriaDisabled$1, HasRequiredLinkHref as HasRequiredLinkHref$1, HasClassName as HasClassName$1, HasCloseMode as HasCloseMode$1, JSXElement as JSXElement$1, CommonRef as CommonRef$1, Falsy, HeadingElement as HeadingElement$1, NamedProps, HasAriaLabelOrLabelledBy as HasAriaLabelOrLabelledBy$1 } from '@lumx/core/js/types';
+import { ValueOf as ValueOf$1, GenericProps as GenericProps$1, HasTheme as HasTheme$1, PropsToOverride, HasAriaDisabled as HasAriaDisabled$1, HasRequiredLinkHref as HasRequiredLinkHref$1, HasClassName as HasClassName$1, HasCloseMode as HasCloseMode$1, JSXElement as JSXElement$1, CommonRef as CommonRef$1, Falsy, HeadingElement as HeadingElement$1, HasAriaLabelOrLabelledBy as HasAriaLabelOrLabelledBy$1, NamedProps } from '@lumx/core/js/types';
 export * from '@lumx/core/js/types';
 import * as React$1 from 'react';
 import React__default, { Ref, ReactElement, ReactNode, SyntheticEvent, MouseEventHandler, KeyboardEventHandler, RefObject, SetStateAction, Key, CSSProperties, ElementType as ElementType$1, HTMLInputTypeAttribute, ComponentProps, ImgHTMLAttributes } from 'react';
@@ -3472,7 +3472,26 @@ interface LinkPreviewProps extends GenericProps$1, ReactToJSX<LinkPreviewProps$1
  */
 declare const LinkPreview: Comp<LinkPreviewProps, HTMLDivElement>;
 
+type MenuButtonVariant = 'button' | 'icon-button' | 'chip' | 'link';
+/** ARIA keys set by MenuButton on the trigger — omitted from variant component props. */
+type MenuButtonAriaKeys = 'aria-haspopup' | 'aria-controls' | 'aria-expanded';
+/** Per-variant keys internally managed by MenuButton — omitted from variant component props. */
+type MenuButtonVariantsInternalKeys = {
+    button: MenuButtonAriaKeys;
+    'icon-button': MenuButtonAriaKeys;
+    chip: MenuButtonAriaKeys | 'isClickable';
+    link: MenuButtonAriaKeys | 'href' | 'linkAs';
+};
+/** Discriminated union of MenuButton props across all trigger variants. */
+type MenuButtonVariantsProps<TBase, TVariantProps extends Record<MenuButtonVariant, any>> = {
+    [V in MenuButtonVariant]: TBase & (V extends 'button' ? {
+        variant?: V;
+    } : {
+        variant: V;
+    }) & Omit<TVariantProps[V], MenuButtonVariantsInternalKeys[V] | keyof TBase>;
+}[MenuButtonVariant];
 interface MenuButtonProps$1 {
+    variant?: MenuButtonVariant;
     label?: JSXElement;
     children?: JSXElement;
     triggerProps?: Record<string, any>;
@@ -3481,25 +3500,9 @@ interface MenuButtonProps$1 {
 }
 
 /** MenuPopover props. */
-interface MenuPopoverProps$1 extends HasClassName {
+interface MenuPopoverProps$1 extends HasClassName, Pick<PopoverProps$1, 'placement' | 'anchorRef' | 'isOpen' | 'handleClose'> {
     /** Popover content (a `Menu`). */
     children?: JSXElement;
-    /** Whether the popover is open. */
-    isOpen?: boolean;
-    /** Placement relative to the anchor. Defaults to `'bottom-start'`. */
-    placement?: Placement;
-    /** Reference to the anchor element. */
-    anchorRef?: CommonRef;
-    /** Callback invoked when the popover requests to close (click away, escape). */
-    handleClose?(): void;
-    /** Whether the popover should close when clicking outside. Default: true. */
-    closeOnClickAway?: boolean;
-    /** Whether the popover should close on Escape. Default: true. */
-    closeOnEscape?: boolean;
-    /** Whether to render in a portal. Default: false (avoid stacking-context surprises). */
-    usePortal?: boolean;
-    /** Whether to focus the anchor on close. Default: true. */
-    focusAnchorOnClose?: boolean;
 }
 
 /** Popover props forwarded to the inner Popover (minus managed props). */
@@ -3509,35 +3512,27 @@ interface MenuPopoverProps extends ReactToJSX<MenuPopoverProps$1, 'isOpen' | 'an
     children: ReactNode;
 }
 
-/** Keys managed by MenuButton — omitted from the polymorphic trigger props. */
-type OmittedTriggerKeys = 'aria-haspopup' | 'aria-controls' | 'aria-expanded' | 'label' | 'children' | 'ref';
-/** Polymorphic trigger props with index signature stripped and managed keys removed. */
-type TriggerProps$1<E extends ElementType$1> = Omit<NamedProps<React__default.ComponentProps<E>>, OmittedTriggerKeys>;
-/** Menu button props */
-type MenuButtonProps<E extends ElementType$1 = typeof Button> = TriggerProps$1<E> & ReactToJSX<MenuButtonProps$1, 'triggerProps'> & {
-    /** Customize the rendered trigger component. */
-    as?: E;
+/** Props that MenuButton explicitly declares. */
+type MenuButtonBase = ReactToJSX<MenuButtonProps$1, 'triggerProps' | 'variant'> & {
     children?: React__default.ReactNode;
     popoverProps?: MenuPopoverProps;
     onOpen?: (isOpen: boolean) => void;
+    label: string;
 };
+/** MenuButton props — discriminated union over the variant to inherit the target component's props. */
+type MenuButtonProps = MenuButtonVariantsProps<MenuButtonBase, {
+    button: ButtonProps;
+    'icon-button': IconButtonProps;
+    chip: ChipProps;
+    link: LinkProps;
+}>;
 /**
  * MenuButton component.
  *
  * @param  props Component props.
  * @return React element.
  */
-declare const MenuButton: (<E extends ElementType$1 = Comp<ButtonProps, HTMLButtonElement | HTMLAnchorElement>>(props: TriggerProps$1<E> & ReactToJSX<MenuButtonProps$1, "triggerProps"> & {
-    /** Customize the rendered trigger component. */
-    as?: E | undefined;
-    children?: React__default.ReactNode;
-    popoverProps?: MenuPopoverProps;
-    onOpen?: (isOpen: boolean) => void;
-} & React__default.ComponentProps<E> & {
-    ref?: ComponentRef<E> | undefined;
-}) => React__default.JSX.Element) & {
-    displayName: string;
-};
+declare const MenuButton: Comp<MenuButtonProps, HTMLElement>;
 
 /** MenuItem props. */
 interface MenuItemProps$1 extends HasClassName {
@@ -3573,6 +3568,8 @@ interface MenuItemProps<E extends ElementType$1 = 'button'> extends GenericProps
     onClick?(event: SyntheticEvent): void;
     /** MDI icon rendered as `<Icon size="xs" />` prepended to the `before` slot. */
     icon?: string;
+    /** MDI icon rendered as `<Icon size="xs" />` appended to the `after` slot. */
+    afterIcon?: string;
     /** Foreground color applied to the icon and label text. */
     color?: ColorPalette$1;
     /** Content rendered before the label (rendered AFTER `icon` if both are provided). */