import React from "react";
import { XmStat as XmStatElement } from "../lit/components/stat/index.js";

export type { XmStatElement };

export interface XmStatProps extends Pick<
  React.AllHTMLAttributes<HTMLElement>,
  | "children"
  | "dir"
  | "hidden"
  | "id"
  | "lang"
  | "slot"
  | "style"
  | "title"
  | "translate"
  | "onClick"
  | "onFocus"
  | "onBlur"
> {
  /** Caption above the figure, in the mono label typescale. Sentence case. */
  label?: XmStatElement["label"];

  /** The figure itself, pre-formatted by the caller (grouping, units, currency). */
  value?: XmStatElement["value"];

  /** Change beside the figure, sign included (`"+18%"`, `"-4"`). Rendered in the
coral accent whatever the direction — direction is carried by the sign and
the note, never by a red/green hue (POLICIES rule 3a). */
  delta?: XmStatElement["delta"];

  /** What the delta is measured against (`"vs 7-day avg"`). */
  deltaNote?: XmStatElement["deltaNote"];

  /** `hero` for the one figure a screen is about, `md` (default) for the strip
beside it, `sm` for a figure inside dense chrome. */
  size?: XmStatElement["size"];

  /** 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?: React.Ref<XmStatElement>;

  /** 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;
}

/**
 *
 *
 * ## Attributes & Properties
 *
 * Component attributes and properties that can be applied to the element or by using JavaScript.
 *
 * - `label`: Caption above the figure, in the mono label typescale. Sentence case.
 * - `value`: The figure itself, pre-formatted by the caller (grouping, units, currency).
 * - `delta`: Change beside the figure, sign included (`"+18%"`, `"-4"`). Rendered in the
 * coral accent whatever the direction — direction is carried by the sign and
 * the note, never by a red/green hue (POLICIES rule 3a).
 * - `delta-note`/`deltaNote`: What the delta is measured against (`"vs 7-day avg"`).
 * - `size`: `hero` for the one figure a screen is about, `md` (default) for the strip
 * beside it, `sm` for a figure inside dense chrome.
 */
export const XmStat: React.ForwardRefExoticComponent<XmStatProps>;