@lumx/react 4.5.0 → 4.5.2-alpha.0

package/index.d.ts

@@ -594,8 +594,10 @@ type ReactToJSX<Props, OmitProps extends keyof Props = never> = Omit<Props, Prop
 interface AvatarProps extends GenericProps$1, ReactToJSX<AvatarProps$1, 'actions' | 'badge' | 'image'> {
     /** Action toolbar content. */
     actions?: ReactNode;
+    /** Image URL. */
+    image: string;
     /** Props to pass to the link wrapping the thumbnail. */
-    linkProps?: React.DetailedHTMLProps<React.AnchorHTMLAttributes<HTMLAnchorElement>, HTMLAnchorElement>;
+    linkProps?: React__default.DetailedHTMLProps<React__default.AnchorHTMLAttributes<HTMLAnchorElement>, HTMLAnchorElement>;
     /** Custom react component for the link (can be used to inject react router Link). */
     linkAs?: 'a' | any;
     /** On click callback. */
@@ -1239,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.
  */
@@ -1261,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. */
@@ -1291,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. */
@@ -1300,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.
@@ -1574,7 +1605,7 @@ declare const GenericBlockGapSize: Pick<{
     readonly medium: "medium";
     readonly big: "big";
     readonly huge: "huge";
-}, "tiny" | "regular" | "medium" | "big" | "huge">;
+}, "medium" | "tiny" | "regular" | "big" | "huge">;
 type GenericBlockGapSize = ValueOf$1<typeof GenericBlockGapSize>;
 
 interface GenericBlockProps extends FlexBoxProps {
@@ -2366,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.
  *