@dragunio/fe-libs 0.1.5 → 0.1.7

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import * as react from 'react';
-import { ButtonHTMLAttributes, ReactNode, TableHTMLAttributes, HTMLAttributes, InputHTMLAttributes, TextareaHTMLAttributes, KeyboardEventHandler, ReactElement } from 'react';
-export { ChevronDownIcon, CloseIcon, IconProps, PlusIcon, SearchIcon, arrow_left, check_square_fill, chevron_down, chevron_left, chevron_right, chevron_up, copy, key, lock, lock_unlocked, log_out, minus_square, plus, plus_square, search, trash, x_close } from './icons.js';
+import { ButtonHTMLAttributes, ReactNode, HTMLAttributes, TableHTMLAttributes, InputHTMLAttributes, TextareaHTMLAttributes, KeyboardEventHandler, ChangeEvent, ReactElement } from 'react';
+export { ChevronDownIcon, ChevronUpIcon, CloseIcon, IconProps, MoreHorizontalIcon, MoreVerticalIcon, PlusIcon, SearchIcon, arrow_left, check_square_fill, chevron_down, chevron_left, chevron_right, chevron_up, copy, key, lock, lock_unlocked, log_out, minus_square, plus, plus_square, search, trash, x_close } from './icons.js';
 
 type ButtonHierarchy = 'primary' | 'secondary-gray' | 'secondary-color' | 'tertiary-gray' | 'tertiary-color';
 type ButtonSize = '24' | '32' | '40';
@@ -44,6 +44,22 @@ declare const Button: react.ForwardRefExoticComponent<Omit<ButtonHTMLAttributes<
     variant?: ButtonVariant;
 } & react.RefAttributes<HTMLButtonElement>>;
 
+/** A Button action with a stable identifier for use in ButtonBar. */
+type ButtonBarAction = ButtonProps & {
+    id: string;
+};
+type ButtonBarProps = Omit<HTMLAttributes<HTMLDivElement>, 'children'> & {
+    /** Actions render in this order, both in the bar and the More menu. */
+    actions: ButtonBarAction[];
+    /** Number of actions to keep visible before overflowing the remainder. */
+    maxVisible?: number;
+    /** Overrides for the icon-only More trigger. */
+    moreButtonProps?: ButtonProps;
+    /** Accessible label for the More trigger and its action list. */
+    moreLabel?: string;
+};
+declare function ButtonBar({ actions, maxVisible, moreButtonProps, moreLabel, className, ...props }: ButtonBarProps): react.JSX.Element;
+
 type TableData = readonly (readonly ReactNode[])[];
 type ColumnResizeHandler = (columnSizes: number[], columnIndex: number) => void;
 type TablePaginationPosition = 'top-right' | 'bottom-right' | 'bottom-center' | 'middle-bottom';
@@ -92,12 +108,16 @@ type ToggleProps = Omit<InputHTMLAttributes<HTMLInputElement>, 'color' | 'type'>
     color?: string;
     /** Optional text displayed next to the switch. */
     label?: ReactNode;
+    /** Places the label above or to the right of the switch. Defaults to `right`. */
+    labelPosition?: 'top' | 'right';
 };
 declare const Toggle: react.ForwardRefExoticComponent<Omit<InputHTMLAttributes<HTMLInputElement>, "color" | "type"> & {
     /** Active track color. Accepts any valid CSS color, for example `#16a34a`. */
     color?: string;
     /** Optional text displayed next to the switch. */
     label?: ReactNode;
+    /** Places the label above or to the right of the switch. Defaults to `right`. */
+    labelPosition?: "top" | "right";
 } & react.RefAttributes<HTMLInputElement>>;
 
 type DrawerProps = Omit<HTMLAttributes<HTMLElement>, 'title'> & {
@@ -175,11 +195,14 @@ declare const TextArea: react.ForwardRefExoticComponent<Omit<react.TextareaHTMLA
     onValueChange?: (value: string) => void;
     clearLabel?: string;
 } & {
+    autosize?: boolean;
     value?: string;
     defaultValue?: string;
 } & react.RefAttributes<HTMLTextAreaElement>>;
 
 type TextAreaProps = Omit<TextareaHTMLAttributes<HTMLTextAreaElement>, 'value' | 'defaultValue'> & TextFieldBaseProps & {
+    /** Expands the textarea to fit its content. */
+    autosize?: boolean;
     value?: string;
     defaultValue?: string;
 };
@@ -241,7 +264,7 @@ declare const Selection: react.ForwardRefExoticComponent<Omit<react.HTMLAttribut
 
 declare function formatNumber(value: number, decimals?: number, thousandSeparator?: string, decimalSeparator?: string): string;
 /** A text input that displays numbers as 1,000.05 by default. */
-declare const NumberInput: react.ForwardRefExoticComponent<Omit<react.InputHTMLAttributes<HTMLInputElement>, "type" | "value" | "defaultValue" | "onChange" | "max" | "min"> & {
+declare const NumberInput: react.ForwardRefExoticComponent<Omit<react.InputHTMLAttributes<HTMLInputElement>, "type" | "value" | "defaultValue" | "onChange" | "step" | "max" | "min"> & {
     value?: number | null;
     defaultValue?: number | null;
     onValueChange?: (value: number | null) => void;
@@ -251,10 +274,18 @@ declare const NumberInput: react.ForwardRefExoticComponent<Omit<react.InputHTMLA
     max?: number;
     decimalSeparator?: string;
     thousandSeparator?: string;
+    prefix?: react.ReactNode;
+    suffix?: react.ReactNode;
+    Prefix?: react.ReactNode;
+    Suffix?: react.ReactNode;
     endAdornment?: react.ReactNode;
+    step?: number;
+    showStepper?: boolean;
+    incrementLabel?: string;
+    decrementLabel?: string;
 } & FieldBaseProps & react.RefAttributes<HTMLInputElement>>;
 
-type NumberInputProps = Omit<InputHTMLAttributes<HTMLInputElement>, 'type' | 'value' | 'defaultValue' | 'onChange' | 'min' | 'max'> & {
+type NumberInputProps = Omit<InputHTMLAttributes<HTMLInputElement>, 'type' | 'value' | 'defaultValue' | 'onChange' | 'min' | 'max' | 'step'> & {
     value?: number | null;
     defaultValue?: number | null;
     onValueChange?: (value: number | null) => void;
@@ -267,8 +298,24 @@ type NumberInputProps = Omit<InputHTMLAttributes<HTMLInputElement>, 'type' | 'va
     max?: number;
     decimalSeparator?: string;
     thousandSeparator?: string;
+    /** Content rendered inside the control before the numeric value. */
+    prefix?: ReactNode;
+    /** Content rendered inside the control after the numeric value. */
+    suffix?: ReactNode;
+    /** Alias for prefix. */
+    Prefix?: ReactNode;
+    /** Alias for suffix. */
+    Suffix?: ReactNode;
     /** Content rendered inside the control after the numeric value. */
     endAdornment?: ReactNode;
+    /** Amount added or subtracted by the increment and decrement controls. Defaults to 1. */
+    step?: number;
+    /** Shows the increment and decrement controls. Defaults to true. */
+    showStepper?: boolean;
+    /** Accessible label for the increment control. */
+    incrementLabel?: string;
+    /** Accessible label for the decrement control. */
+    decrementLabel?: string;
 } & FieldBaseProps;
 
 type Currency = {
@@ -311,6 +358,68 @@ type DateTimePickerProps = DateTimePickerSingleProps | DateTimePickerRangeProps;
 /** Calendar and time picker. Supports a single Date or [start, end] range. */
 declare function DateTimePicker(props: DateTimePickerProps): react.JSX.Element;
 
+type ControlLabelPosition = 'top' | 'right';
+type CheckboxProps = Omit<InputHTMLAttributes<HTMLInputElement>, 'type'> & {
+    /** Optional text associated with the checkbox. */
+    label?: ReactNode;
+    /** Places the label above or to the right of the checkbox. Defaults to `right`. */
+    labelPosition?: ControlLabelPosition;
+};
+
+/** A native checkbox with an accessible, custom visual control. */
+declare const Checkbox: react.ForwardRefExoticComponent<Omit<react.InputHTMLAttributes<HTMLInputElement>, "type"> & {
+    label?: react.ReactNode;
+    labelPosition?: ControlLabelPosition;
+} & react.RefAttributes<HTMLInputElement>>;
+
+/** A native radio input with an accessible, custom visual control. */
+declare const RadioButton: react.ForwardRefExoticComponent<Omit<react.InputHTMLAttributes<HTMLInputElement>, "type"> & {
+    label?: react.ReactNode;
+    labelPosition?: ControlLabelPosition;
+} & react.RefAttributes<HTMLInputElement>>;
+
+type RadioButtonProps = Omit<InputHTMLAttributes<HTMLInputElement>, 'type'> & {
+    /** Optional text associated with the radio button. */
+    label?: ReactNode;
+    /** Places the label above or to the right of the radio button. Defaults to `right`. */
+    labelPosition?: ControlLabelPosition;
+};
+
+type RadioValue = string | number;
+type RadioGroupOption = {
+    label: ReactNode;
+    value: RadioValue;
+    disabled?: boolean;
+};
+type RadioGroupProps = Omit<HTMLAttributes<HTMLDivElement>, 'onChange' | 'defaultValue' | 'value'> & {
+    /** Optional text that names the radio group. */
+    label?: ReactNode;
+    /** Places the group label above or to the right of its options. Defaults to `top`. */
+    labelPosition?: ControlLabelPosition;
+    options: RadioGroupOption[];
+    name?: string;
+    value?: RadioValue;
+    defaultValue?: RadioValue;
+    onChange?: (value: RadioValue, option: RadioGroupOption, event: ChangeEvent<HTMLInputElement>) => void;
+    disabled?: boolean;
+    direction?: 'horizontal' | 'vertical';
+    isRequired?: boolean;
+};
+
+/** A named collection of native radio buttons with controlled and uncontrolled values. */
+declare const RadioGroup: react.ForwardRefExoticComponent<Omit<react.HTMLAttributes<HTMLDivElement>, "value" | "defaultValue" | "onChange"> & {
+    label?: react.ReactNode;
+    labelPosition?: ControlLabelPosition;
+    options: RadioGroupOption[];
+    name?: string;
+    value?: RadioValue;
+    defaultValue?: RadioValue;
+    onChange?: (value: RadioValue, option: RadioGroupOption, event: ChangeEvent<HTMLInputElement>) => void;
+    disabled?: boolean;
+    direction?: "horizontal" | "vertical";
+    isRequired?: boolean;
+} & react.RefAttributes<HTMLDivElement>>;
+
 type TooltipProps = Omit<HTMLAttributes<HTMLSpanElement>, 'content'> & {
     content: ReactNode;
     children: ReactElement;
@@ -513,4 +622,37 @@ type SnackbarProps = Omit<HTMLAttributes<HTMLDivElement>, 'onClose'> & {
 /** A controlled, temporary notification surface. */
 declare function Snackbar({ open, message, autoHideDuration, onClose, action, anchorOrigin, closeLabel, className, ...props }: SnackbarProps): react.JSX.Element | null;
 
-export { Button, type ButtonColor, type ButtonHierarchy, type ButtonProps, type ButtonSize, type ButtonVariant, Chip, type ChipProps, type ChipStatus, type ChipVariant, type ColumnResizeHandler, type Currency, CurrencyInput, type CurrencyInputProps, type DateRange, DateTimePicker, type DateTimePickerProps, type DateTimePickerRangeProps, type DateTimePickerSingleProps, type DescriptionDisplay, Drawer, type DrawerProps, ExpandableSection, type ExpandableSectionProps, type FieldError, Loading, type LoadingProps, type LoadingSize, Message, type MessageOptions, type MessageProps, type MessageSeverity, Modal, type ModalAction, type ModalProps, type ModalSize, NumberInput, type NumberInputProps, Pagination, type PaginationProps, ProgressBar, type ProgressBarProps, type ProgressBarSize, Selection, type SelectionOption, type SelectionProps, type SelectionValue, Skeleton, SkeletonBox, type SkeletonBoxProps, SkeletonCircle, SkeletonLine, type SkeletonProps, type SkeletonSizeProps, SkeletonSquare, type SkeletonVariant, Snackbar, type SnackbarAnchorOrigin, type SnackbarProps, Table, TableBody, TableCaption, TableCell, type TableData, TableHead, TableHeader, type TablePaginationPosition, type TableProps, TableRow, TextArea, type TextAreaProps, TextInput, type TextInputProps, Toggle, type ToggleProps, Tooltip, type TooltipProps, formatNumber, getIconSize, message };
+type AvatarShape = 'circle' | 'rounded';
+type AvatarSize = number | string;
+type AvatarProps = Omit<HTMLAttributes<HTMLSpanElement>, 'content'> & {
+    /** Image URL. A successfully loaded image takes priority over all fallbacks. */
+    src?: string | null;
+    /** Name or label used to derive initials when no image is available. */
+    content?: string | null;
+    /** Accessible description for the image or fallback avatar. Defaults to content. */
+    alt?: string;
+    /** Avatar width and height. Numbers are interpreted as pixels. */
+    size?: AvatarSize;
+    /** Circle is the default; rounded uses a square with rounded corners. */
+    shape?: AvatarShape;
+    /** Chooses a specific illustration from the fallback collection. */
+    fallbackIndex?: number;
+};
+type AvatarGroupProps = Omit<HTMLAttributes<HTMLDivElement>, 'children'> & {
+    /** Avatar elements to show in the group. */
+    children: ReactNode;
+    /** Maximum total items to show, including the final +n overflow item. */
+    maxCount?: number;
+};
+/**
+ * A compact avatar that shows an image, name initials, or one of 32 fallback
+ * illustrations in that order.
+ */
+declare function Avatar({ src, content, alt, size, shape, fallbackIndex, className, style, role, 'aria-label': ariaLabel, ...props }: AvatarProps): react.JSX.Element;
+/**
+ * A compact overlapping set of Avatar elements. When it contains one Avatar
+ * with content, the full content is shown beside it.
+ */
+declare function AvatarGroup({ children, maxCount, className, style, role, ...props }: AvatarGroupProps): react.JSX.Element;
+
+export { Avatar, AvatarGroup, type AvatarGroupProps, type AvatarProps, type AvatarShape, type AvatarSize, Button, ButtonBar, type ButtonBarAction, type ButtonBarProps, type ButtonColor, type ButtonHierarchy, type ButtonProps, type ButtonSize, type ButtonVariant, Checkbox, type CheckboxProps, Chip, type ChipProps, type ChipStatus, type ChipVariant, type ColumnResizeHandler, type ControlLabelPosition, type Currency, CurrencyInput, type CurrencyInputProps, type DateRange, DateTimePicker, type DateTimePickerProps, type DateTimePickerRangeProps, type DateTimePickerSingleProps, type DescriptionDisplay, Drawer, type DrawerProps, ExpandableSection, type ExpandableSectionProps, type FieldError, Loading, type LoadingProps, type LoadingSize, Message, type MessageOptions, type MessageProps, type MessageSeverity, Modal, type ModalAction, type ModalProps, type ModalSize, NumberInput, type NumberInputProps, Pagination, type PaginationProps, ProgressBar, type ProgressBarProps, type ProgressBarSize, RadioButton, type RadioButtonProps, RadioGroup, type RadioGroupOption, type RadioGroupProps, type RadioValue, Selection, type SelectionOption, type SelectionProps, type SelectionValue, Skeleton, SkeletonBox, type SkeletonBoxProps, SkeletonCircle, SkeletonLine, type SkeletonProps, type SkeletonSizeProps, SkeletonSquare, type SkeletonVariant, Snackbar, type SnackbarAnchorOrigin, type SnackbarProps, Table, TableBody, TableCaption, TableCell, type TableData, TableHead, TableHeader, type TablePaginationPosition, type TableProps, TableRow, TextArea, type TextAreaProps, TextInput, type TextInputProps, Toggle, type ToggleProps, Tooltip, type TooltipProps, formatNumber, getIconSize, message };