import React from "react";
import { PlusBreadcrumbItem as PlusBreadcrumbItemElement } from "../dist/components/breadcrumb-item/index.js";

export type { PlusBreadcrumbItemElement };

export interface PlusBreadcrumbItemProps
  extends Pick<
    React.AllHTMLAttributes<HTMLElement>,
    | "children"
    | "dir"
    | "hidden"
    | "id"
    | "lang"
    | "slot"
    | "style"
    | "title"
    | "translate"
    | "onClick"
    | "onFocus"
    | "onBlur"
  > {
  /** The URL to navigate to when the item is clicked. If omitted, the item is rendered as text. */
  href?: PlusBreadcrumbItemElement["href"];

  /** Name of the optional icon to display before the label. Used only if the `prefix` slot is empty. */
  prefixIcon?: PlusBreadcrumbItemElement["prefixIcon"];

  /** Name of the optional icon to display after the label. Used only if the `suffix` slot is empty. */
  suffixIcon?: PlusBreadcrumbItemElement["suffixIcon"];

  /** A space-separated list of the classes of the element. Classes allows CSS and JavaScript to select and access specific elements via the class selectors or functions like the method `Document.getElementsByClassName()`. */
  className?: string;

  /** Contains a space-separated list of the part names of the element that should be exposed on the host element. */
  exportparts?: string;

  /** Used for labels to link them with their inputs (using input id). */
  htmlFor?: string;

  /** Used to help React identify which items have changed, are added, or are removed within a list. */
  key?: number | string;

  /** Contains a space-separated list of the part names of the element. Part names allows CSS to select and style specific elements in a shadow tree via the ::part pseudo-element. */
  part?: string;

  /** A mutable ref object whose `.current` property is initialized to the passed argument (`initialValue`). The returned object will persist for the full lifetime of the component. */
  ref?: any;

  /** Allows developers to make HTML elements focusable, allow or prevent them from being sequentially focusable (usually with the `Tab` key, hence the name) and determine their relative ordering for sequential focus navigation. */
  tabIndex?: number;
}

/**
 *
 * ---
 *
 *
 * ### **Slots:**
 *  - _default_ - The default slot for the item's label content.
 * - **prefix** - Optional slot for content/icon to display before the label. Overrides `prefix-icon` property.
 * - **suffix** - Optional slot for content/icon to display after the label. Overrides `suffix-icon` property.
 *
 * ### **CSS Parts:**
 *  - **base** - The component's base wrapper element.
 * - **link** - The `plus-link` element (if `href` is provided).
 * - **text** - The `span` element (if `href` is not provided).
 * - **prefix** - The prefix container (slot or icon).
 * - **suffix** - The suffix container (slot or icon).
 * - **separator** - The separator element.
 */
export const PlusBreadcrumbItem: React.ForwardRefExoticComponent<PlusBreadcrumbItemProps>;