import * as React from 'react';

type SidebarItemNextSpecificProps = {
  /** Sets the item's label. */
  children?: React.ReactNode;
  /** Applied as data-hook HTML attribute that can be used in the tests. */
  dataHook?: string;
  /** Specifies a CSS class name to be appended to the component's root element.
   * @internal
   */
  className?: string;
  /** An element/array of elements to appear at the end of the text. max number of elements to pass is 2. */
  suffix?: React.ReactNode;
  /** An element to appear at the start of the text. */
  prefix?: React.ReactNode;
  /** A callback to be triggered on mouse enter. */
  onMouseEnter?: React.MouseEventHandler<HTMLButtonElement>;
  /** A callback to be triggered on mouse leave. */
  onMouseLeave?: React.MouseEventHandler<HTMLButtonElement>;
  /** Indicates whether to display the item as disabled. */
  disabled?: boolean;
  /** A callback to be triggered on click. */
  onClick?: React.MouseEventHandler<HTMLButtonElement>;
  /** Sets a unique key for the item. The item is marked as selected when it matches the `selectedKey` of `<SidebarNext/>`, and the key is passed to `onClick` as the second argument. */
  itemKey?: string;
  /** Defines one of the aria roles to provide semantic meaning to content. */
  role?: string;
  /** Content of the tooltip shown when the sidebar is minimized. */
  minimizedTooltipContent?: React.ReactNode;
  /** The skin of the item. Overrides the skin provided by the parent SidebarNext. */
  skin?: 'dark' | 'light' | 'neutral';
  /** Renders the item in its collapsed form (icon only, with `minimizedTooltipContent`).
   * Overrides the minimized state provided by the parent SidebarNext — needed when the
   * item is rendered across a bundle boundary, where the context doesn't resolve. */
  minimized?: boolean;
};

/**
 * Omit SidebarItemNext specific properties.
 */
type OmitHTMLAttributes<T> = Omit<T, keyof SidebarItemNextSpecificProps>;

export type SidebarItemNextWithAsProp<T> =
  | SidebarItemNextAsButtonProps<T>
  | SidebarItemNextAsAnchorProps<T>
  | SidebarItemNextGenericProps<T>
  | SidebarItemNextAsComponentProps<T>;

type SidebarItemNextAsButtonProps<T> = OmitHTMLAttributes<
  React.ButtonHTMLAttributes<HTMLButtonElement>
> &
  T & {
    /** Renders the item as another HTML tag or component.
     * @default 'button'
     */
    as?: 'button';
    /** A callback to be triggered on click. */
    onClick?: React.MouseEventHandler<HTMLButtonElement>;
  };

type SidebarItemNextAsAnchorProps<T> = OmitHTMLAttributes<
  React.AnchorHTMLAttributes<HTMLAnchorElement>
> &
  T & {
    /** Renders the item as another HTML tag or component. */
    as: 'a';
    /** A callback to be triggered on click. */
    onClick?: React.MouseEventHandler<HTMLAnchorElement>;
  };

type SidebarItemNextGenericProps<T> = T & {
  /** Renders the item as another HTML tag or component. */
  as: keyof Omit<HTMLElementTagNameMap, 'a' | 'button'>;
  /** A callback to be triggered on click. */
  onClick?: React.MouseEventHandler<HTMLElement>;
  [additionalProps: string]: any;
};

type SidebarItemNextAsComponentProps<T> = T & {
  /** Renders the item as another HTML tag or component. */
  as: React.ComponentType<any>;
  /** A callback to be triggered on click. */
  onClick?: React.MouseEventHandler<HTMLElement>;
  [additionalProps: string]: any;
};

export type SidebarItemNextProps =
  SidebarItemNextWithAsProp<SidebarItemNextSpecificProps>;

declare const SidebarItemNext: React.FC<SidebarItemNextProps>;

export { SidebarItemNext };