@lumx/react 4.5.1 → 4.5.2-alpha.1

package/index.d.ts

@@ -755,7 +755,7 @@ interface ButtonProps extends GenericProps$1, ReactToJSX<ButtonProps$1> {
  * @param  ref   Component ref.
  * @return React element.
  */
-declare const Button: Comp<ButtonProps, HTMLButtonElement | HTMLAnchorElement>;
+declare const Button: Comp<ButtonProps, HTMLAnchorElement | HTMLButtonElement>;
 
 interface IconButtonProps$1 extends BaseButtonProps {
     /**
@@ -1241,7 +1241,7 @@ declare const Placement: {
     readonly LEFT_END: "left-end";
     readonly LEFT_START: "left-start";
 };
-type Placement = ValueOf$1<typeof Placement>;
+type Placement = ValueOf<typeof Placement>;
 /**
  * Offset of the popover.
  */
@@ -1263,20 +1263,23 @@ declare const FitAnchorWidth: {
     readonly MIN_WIDTH: "minWidth";
     readonly WIDTH: "width";
 };
-type FitAnchorWidth = ValueOf$1<typeof FitAnchorWidth>;
+type FitAnchorWidth = ValueOf<typeof FitAnchorWidth>;
 
 /**
- * Defines the props of the component.
+ * Shared popover props used by both React and Vue wrappers.
+ *
+ * Framework-specific props (ref types, children, callbacks) are added by each wrapper.
+ * The `anchorRef`, `boundaryRef`, `focusElement`, `parentElement`, `focusTrapZoneElement`
+ * are typed as `any` here because React uses `RefObject<HTMLElement>` while Vue uses
+ * raw `HTMLElement` — each framework narrows the type in its own props definition.
  */
-interface PopoverProps extends GenericProps$1, HasTheme$1 {
+interface PopoverProps$1 extends HasClassName, HasTheme {
     /** Reference to the DOM element used to set the position of the popover. */
-    anchorRef: React.RefObject<HTMLElement>;
-    /** Customize the root element. (Must accept ref forwarding and props forwarding!). */
-    as?: React.ElementType;
+    anchorRef?: CommonRef;
+    /** Customize the root element tag. */
+    as?: string;
     /** Element which will act as boundary when opening the popover. */
-    boundaryRef?: RefObject<HTMLElement>;
-    /** Content. */
-    children: ReactNode;
+    boundaryRef?: CommonRef;
     /** Whether a click anywhere out of the popover would close it. */
     closeOnClickAway?: boolean;
     /** Whether an escape key press would close the popover. */
@@ -1293,7 +1296,7 @@ interface PopoverProps extends GenericProps$1, HasTheme$1 {
     /** Shrink popover if even after flipping there is not enough space. */
     fitWithinViewportHeight?: boolean;
     /** Element to focus when opening the popover. */
-    focusElement?: RefObject<HTMLElement>;
+    focusElement?: CommonRef;
     /** Whether the focus should go back on the anchor when popover closes and focus is within. */
     focusAnchorOnClose?: boolean;
     /** Whether we put an arrow or not. */
@@ -1302,20 +1305,46 @@ interface PopoverProps extends GenericProps$1, HasTheme$1 {
     isOpen: boolean;
     /** Offset placement relative to anchor. */
     offset?: Offset;
-    /** Reference to the parent element that triggered the popover (will get back focus on close or else fallback on the anchor element). */
-    parentElement?: RefObject<HTMLElement>;
+    /** Reference to the parent element that triggered the popover. */
+    parentElement?: CommonRef;
     /** Placement relative to anchor. */
     placement?: Placement;
-    /** Whether the popover should be rendered into a DOM node that exists outside the DOM hierarchy of the parent component. */
+    /** Whether the popover should be rendered into a portal. */
     usePortal?: boolean;
     /** The element in which the focus trap should be set. Default to popover. */
-    focusTrapZoneElement?: RefObject<HTMLElement>;
+    focusTrapZoneElement?: CommonRef;
     /** Z-axis position. */
     zIndex?: number;
+    /** Whether the popover should trap the focus within itself. */
+    withFocusTrap?: boolean;
+    /** On close callback (on click away or Escape pressed). Framework wrappers provide their own type. */
+    handleClose?(): void;
+}
+
+/**
+ * Defines the props of the component.
+ * Extends core PopoverProps, overriding ref-typed props with React-specific `RefObject` types
+ * and replacing `handleClose` with the React-idiomatic `onClose` callback.
+ */
+interface PopoverProps extends GenericProps$1, ReactToJSX<PopoverProps$1, 'anchorRef' | 'as' | 'boundaryRef' | 'focusElement' | 'parentElement' | 'focusTrapZoneElement' | 'className'> {
+    /** Reference to the DOM element used to set the position of the popover. */
+    anchorRef: RefObject<HTMLElement>;
+    /** Customize the root element. (Must accept ref forwarding and props forwarding!). */
+    as?: React.ElementType;
+    /** Element which will act as boundary when opening the popover. */
+    boundaryRef?: RefObject<HTMLElement>;
+    /** Content. */
+    children: ReactNode;
+    /** Element to focus when opening the popover. */
+    focusElement?: RefObject<HTMLElement>;
+    /** Reference to the parent element that triggered the popover (will get back focus on close or else fallback on the anchor element). */
+    parentElement?: RefObject<HTMLElement>;
+    /** Whether the popover should be rendered into a DOM node that exists outside the DOM hierarchy of the parent component. */
+    usePortal?: boolean;
+    /** The element in which the focus trap should be set. Default to popover. */
+    focusTrapZoneElement?: RefObject<HTMLElement>;
     /** On close callback (on click away or Escape pressed). */
     onClose?(): void;
-    /** Whether the popover should trap the focus within itself. Default to false. */
-    withFocusTrap?: boolean;
 }
 /**
  * Popover component.
@@ -2261,7 +2290,7 @@ interface LinkProps extends GenericProps$1, ReactToJSX<LinkProps$1> {
  * @param  ref   Component ref.
  * @return React element.
  */
-declare const Link: Comp<LinkProps, HTMLButtonElement | HTMLAnchorElement>;
+declare const Link: Comp<LinkProps, HTMLAnchorElement | HTMLButtonElement>;
 
 /**
  * Defines the props of the component.
@@ -2368,7 +2397,7 @@ interface ListItemProps extends GenericProps$1, HasAriaDisabled$1 {
  * Check if the list item is clickable.
  * @return `true` if the list item is clickable; `false` otherwise.
  */
-declare function isClickable({ linkProps, onItemSelected }: Partial<ListItemProps>): boolean;
+declare function isClickable({ linkAs, linkProps, onItemSelected }: Partial<ListItemProps>): boolean;
 /**
  * ListItem component.
  *