@lumx/react 4.9.0-next.9 → 4.10.0-alpha.0

package/index.d.ts

@@ -1579,6 +1579,12 @@ interface ComboboxOptionSkeletonProps$1 extends HasClassName {
     children?: JSXElement;
     /** ref to the root <li> element. */
     ref?: CommonRef;
+    /**
+     * Number of skeleton `<li>` elements to render.
+     * Each is an independent element with `:nth-child` width cycling applied by SCSS.
+     * @default 1
+     */
+    count?: number;
 }
 /**
  * Props that React/Vue wrappers need to re-declare with framework-specific types.
@@ -1596,12 +1602,6 @@ interface ComboboxOptionSkeletonProps extends GenericProps$1, ReactToJSX<Combobo
     after?: ReactNode;
     /** Override the default SkeletonTypography content entirely. */
     children?: ReactNode;
-    /**
-     * Number of skeleton `<li>` elements to render.
-     * Each is an independent element with `:nth-child` width cycling applied by SCSS.
-     * @default 1
-     */
-    count?: number;
 }
 
 /**
@@ -1889,6 +1889,7 @@ interface RawInputTextProps$1 extends HasTheme, HasClassName {
     name?: string | undefined;
     ref?: CommonRef;
     handleChange?: (value: string, name?: string, event?: any) => void;
+    handleInput?: (value: string, name?: string, event?: any) => void;
 }
 
 type NativeInputProps = Omit<ComponentProps<'input'>, 'value' | 'onChange'>;
@@ -1914,6 +1915,7 @@ interface RawInputTextareaProps$1 extends HasTheme, HasClassName {
     name?: string | undefined;
     ref?: CommonRef;
     handleChange?: (value: string, name?: string, event?: any) => void;
+    handleInput?: (value: string, name?: string, event?: any) => void;
 }
 
 type NativeTextareaProps = Omit<ComponentProps<'textarea'>, 'value' | 'onChange'>;
@@ -2107,7 +2109,7 @@ declare const Combobox: {
     };
     /** Loading placeholder skeleton(s) that auto-register loading state with the combobox handle. */
     OptionSkeleton: {
-        (props: ComboboxOptionSkeletonProps): react_jsx_runtime.JSX.Element[];
+        (props: ComboboxOptionSkeletonProps): react_jsx_runtime.JSX.Element;
         displayName: string;
         className: "lumx-combobox-option-skeleton";
     };
@@ -2458,7 +2460,7 @@ declare const Dropdown: Comp<DropdownProps, HTMLDivElement>;
 /**
  * Defines the props of the component.
  */
-interface ExpansionPanelProps extends GenericProps$1, HasCloseMode$1, HasTheme$1 {
+interface ExpansionPanelProps$1 extends HasClassName, HasCloseMode, HasTheme {
     /** Whether the expansion panel has a background. */
     hasBackground?: boolean;
     /** Whether the header has a divider. */
@@ -2467,6 +2469,41 @@ interface ExpansionPanelProps extends GenericProps$1, HasCloseMode$1, HasTheme$1
     isOpen?: boolean;
     /** Label text (overwritten if a `<header>` is provided in the children). */
     label?: string;
+    /** On open callback. */
+    handleOpen?: (event: any) => void;
+    /** On close callback. */
+    handleClose?: (event: any) => void;
+    /** Props to pass to the toggle button (minus those already set by the ExpansionPanel props). */
+    toggleButtonProps: any;
+    /** On toggle open or close callback. */
+    handleToggleOpen?(shouldOpen: boolean, event: any): void;
+    /** Children */
+    children?: JSXElement;
+    /** Ref forwarded to the root `<section>` element. */
+    ref?: CommonRef;
+    /** Ref forwarded to the collapsible wrapper `<div>`. */
+    wrapperRef?: CommonRef;
+    /** Props spread onto the header content `<div>` (e.g. `aria-*`, `data-*`). */
+    headerProps: GenericProps;
+    /** Content rendered inside the header content area. */
+    headerContent?: JSXElement;
+    /** Optional drag handle element rendered at the start of the header. */
+    dragHandle?: JSXElement;
+    /** Content rendered inside the collapsible content area. */
+    content?: JSXElement;
+    /** Optional footer element rendered below the content. */
+    footer?: JSXElement;
+    /** IconButton component injected by the framework wrapper (React or Vue). */
+    IconButton: any;
+    /** Whether the children should remain mounted (visible in the DOM) while the panel is closed. */
+    isChildrenVisible?: boolean;
+}
+type ExpansionPanelPropsToOverride = 'handleOpen' | 'handleClose' | 'toggleButtonProps' | 'handleToggleOpen' | 'wrapperRef' | 'headerProps' | 'headerContent' | 'dragHandle' | 'content' | 'IconButton' | 'isChildrenVisible' | 'footer';
+
+/**
+ * Defines the props of the component.
+ */
+interface ExpansionPanelProps extends GenericProps$1, ReactToJSX<ExpansionPanelProps$1, ExpansionPanelPropsToOverride> {
     /** On open callback. */
     onOpen?: (event: React__default.MouseEvent) => void;
     /** On close callback. */
@@ -2475,8 +2512,6 @@ interface ExpansionPanelProps extends GenericProps$1, HasCloseMode$1, HasTheme$1
     toggleButtonProps: Pick<IconButtonProps, 'label'> & Omit<IconButtonProps, 'label' | 'onClick' | 'icon' | 'emphasis' | 'color'>;
     /** On toggle open or close callback. */
     onToggleOpen?(shouldOpen: boolean, event: React__default.MouseEvent): void;
-    /** Children */
-    children?: React__default.ReactNode;
 }
 /**
  * ExpansionPanel component.
@@ -2848,6 +2883,71 @@ interface IconProps extends ReactToJSX<IconProps$1>, GenericProps$1 {
  */
 declare const Icon: Comp<IconProps, HTMLElement>;
 
+type ImageCaptionMetadata$1 = {
+    /** Image title to display in the caption. */
+    title?: string;
+    /** Props to pass to the title. */
+    titleProps?: GenericProps;
+    /** Image description. Can be either a string, ReactNode, or sanitized html object. */
+    description?: JSXElement | {
+        __html: string;
+    };
+    /** Props to pass to the description. */
+    descriptionProps?: GenericProps;
+    /** Tag content. */
+    tags?: JSXElement;
+    /** Caption custom CSS style. */
+    captionStyle?: GenericProps;
+    /** Props to pass to the wrapper FlexBox element. */
+    wrapperProps?: GenericProps;
+    /** FlexBox component injected by the framework wrapper (React or Vue). */
+    FlexBox: any;
+    /** Text component injected by the framework wrapper (React or Vue). */
+    Text: any;
+};
+type ImageCaptionPropsToOverride = 'FlexBox' | 'Text' | 'wrapperProps';
+
+/**
+ * Image block variants.
+ */
+declare const ImageBlockCaptionPosition: {
+    readonly below: "below";
+    readonly over: "over";
+};
+type ImageBlockCaptionPosition = ValueOf<typeof ImageBlockCaptionPosition>;
+/**
+ *  Image block sizes.
+ */
+type ImageBlockSize$1 = Extract<Size, 'xl' | 'xxl'>;
+/**
+ * Defines the props of the component.
+ */
+interface ImageBlockProps$1 extends HasClassName, HasTheme, Omit<ImageCaptionMetadata$1, ImageCaptionPropsToOverride> {
+    /** Action toolbar content. */
+    actions?: JSXElement;
+    /** Alignment. */
+    align?: HorizontalAlignment;
+    /** Image alternative text. */
+    alt: string;
+    /** Caption position. */
+    captionPosition?: ImageBlockCaptionPosition;
+    /** Whether the image has to fill its container height or not. */
+    fillHeight?: boolean;
+    /** Image URL. */
+    image: string;
+    /** Size variant. */
+    size?: ImageBlockSize$1;
+    /** Props to pass to the thumbnail (minus those already set by the ImageBlock props). */
+    thumbnailProps?: GenericProps;
+    /** reference to the root element */
+    ref?: CommonRef;
+    /** component for rendering the thumbnail */
+    Thumbnail: any;
+    /** component for rendering the image caption */
+    ImageCaption: any;
+}
+type ImageBlockPropsToOverride = 'Thumbnail' | 'ImageCaption' | 'thumbnailProps';
+
 /**
  * Loading attribute is not yet supported in typescript, so we need
  * to add it in order to avoid a ts error.
@@ -2997,32 +3097,6 @@ interface ThumbnailProps extends GenericProps$1, ReactToJSX<ThumbnailProps$1, 'l
  */
 declare const Thumbnail: Comp<ThumbnailProps, HTMLElement>;
 
-type ForwardedTextProps = Omit<TextProps, 'as' | 'typography' | 'color' | 'colorVariant'>;
-type ImageCaptionMetadata = {
-    /** Image title to display in the caption. */
-    title?: string;
-    /** Props to pass to the title. */
-    titleProps?: ForwardedTextProps;
-    /** Image description. Can be either a string, or sanitized html. */
-    description?: string | {
-        __html: string;
-    };
-    /** Props to pass to the title. */
-    descriptionProps?: ForwardedTextProps;
-    /** Tag content. */
-    tags?: ReactNode;
-    /** Caption custom CSS style. */
-    captionStyle?: CSSProperties;
-};
-
-/**
- * Image block variants.
- */
-declare const ImageBlockCaptionPosition: {
-    readonly below: "below";
-    readonly over: "over";
-};
-type ImageBlockCaptionPosition = ValueOf$1<typeof ImageBlockCaptionPosition>;
 /**
  *  Image block sizes.
  */
@@ -3030,21 +3104,7 @@ type ImageBlockSize = Extract<Size$1, 'xl' | 'xxl'>;
 /**
  * Defines the props of the component.
  */
-interface ImageBlockProps extends GenericProps$1, HasTheme$1, ImageCaptionMetadata {
-    /** Action toolbar content. */
-    actions?: ReactNode;
-    /** Alignment. */
-    align?: HorizontalAlignment$1;
-    /** Image alternative text. */
-    alt: string;
-    /** Caption position. */
-    captionPosition?: ImageBlockCaptionPosition;
-    /** Whether the image has to fill its container height or not. */
-    fillHeight?: boolean;
-    /** Image URL. */
-    image: string;
-    /** Size variant. */
-    size?: ImageBlockSize;
+interface ImageBlockProps extends GenericProps$1, ReactToJSX<ImageBlockProps$1, ImageBlockPropsToOverride> {
     /** Props to pass to the thumbnail (minus those already set by the ImageBlock props). */
     thumbnailProps?: Omit<ThumbnailProps, 'image' | 'size' | 'theme' | 'align' | 'fillHeight'>;
 }
@@ -3057,6 +3117,16 @@ interface ImageBlockProps extends GenericProps$1, HasTheme$1, ImageCaptionMetada
  */
 declare const ImageBlock: Comp<ImageBlockProps, HTMLDivElement>;
 
+type ForwardedTextProps = Omit<TextProps, 'as' | 'typography' | 'color' | 'colorVariant'>;
+type ImageCaptionMetadata = Omit<ImageCaptionMetadata$1, ImageCaptionPropsToOverride> & {
+    /** Props to pass to the title. */
+    titleProps?: ForwardedTextProps;
+    /** Props to pass to the title. */
+    descriptionProps?: ForwardedTextProps;
+    /** Caption custom CSS style. */
+    captionStyle?: CSSProperties;
+};
+
 type InheritedSlideShowProps = Pick<SlideshowProps, 'slideshowControlsProps' | 'slideGroupLabel'>;
 interface ZoomButtonProps {
     /** Zoom in button props */
@@ -3288,21 +3358,38 @@ declare const Link: Comp<LinkProps, HTMLButtonElement | HTMLAnchorElement>;
 /**
  * Defines the props of the component.
  */
-interface LinkPreviewProps extends GenericProps$1, HasTheme$1 {
+interface LinkPreviewProps$1 extends HasClassName, HasTheme {
     /** Description. */
     description?: string;
     /** Link URL. */
     link: string;
-    /** Custom react component for the link (can be used to inject react router Link). */
+    /** Custom component for the link (can be used to inject a router Link). */
     linkAs?: 'a' | any;
     /** Props to pass to the link (minus those already set by the LinkPreview props). */
-    linkProps?: Omit<LinkProps, 'color' | 'colorVariant' | 'href' | 'target'>;
+    linkProps?: GenericProps;
     /** Size variant. */
-    size?: Extract<Size$1, 'regular' | 'big'>;
+    size?: Extract<Size, 'regular' | 'big'>;
     /** Thumbnail for the link preview. */
-    thumbnailProps?: ThumbnailProps;
+    thumbnailProps?: GenericProps;
     /** Title. */
     title?: string;
+    /** Ref forwarded to the root article element. */
+    ref?: CommonRef;
+    /** Heading element used to wrap the title. */
+    TitleHeading: any;
+    /** Link component injected by the framework wrapper. */
+    Link: any;
+    /** Thumbnail component injected by the framework wrapper. */
+    Thumbnail: any;
+}
+type LinkPreviewPropsToOverride = 'linkProps' | 'TitleHeading' | 'Link' | 'Thumbnail' | 'thumbnailProps';
+
+/**
+ * Defines the props of the component.
+ */
+interface LinkPreviewProps extends GenericProps$1, ReactToJSX<LinkPreviewProps$1, LinkPreviewPropsToOverride> {
+    /** Props to pass to the link (minus those already set by the LinkPreview props). */
+    linkProps?: Omit<LinkProps, 'color' | 'colorVariant' | 'href' | 'target'>;
     /** Customize the title heading tag. */
     titleHeading?: HeadingElement$1;
 }
@@ -3356,7 +3443,20 @@ declare const Message: Comp<MessageProps, HTMLDivElement>;
 /**
  * Defines the props of the component.
  */
-interface MosaicProps extends GenericProps$1, HasTheme$1 {
+interface MosaicProps$1 extends HasClassName, HasTheme {
+    /** Thumbnails. */
+    thumbnails: any[];
+    /** On image click callback. */
+    handleClick?(index: number): void;
+    Thumbnail: any;
+    ref?: CommonRef;
+}
+type MosaicPropsToOverride = 'Thumbnail' | 'thumbnails';
+
+/**
+ * Defines the props of the component.
+ */
+interface MosaicProps extends GenericProps$1, ReactToJSX<MosaicProps$1, MosaicPropsToOverride> {
     /** Thumbnails. */
     thumbnails: ThumbnailProps[];
     /** On image click callback. */