@dragunio/fe-libs 0.1.5 → 0.1.7

package/README.md

@@ -19,7 +19,8 @@ packages/            # Internal component source folders
 ├── skeleton/
 ├── modal/
 ├── progress/
-└── chip/
+├── chip/
+└── avatar/
 apps/playground/     # Local component storybook
 ```
 
@@ -59,6 +60,7 @@ Available review routes:
 - `http://127.0.0.1:3000/#/modal` — Modal
 - `http://127.0.0.1:3000/#/progress` — ProgressBar
 - `http://127.0.0.1:3000/#/chip` — Chip
+- `http://127.0.0.1:3000/#/avatar` — Avatar
 - `http://127.0.0.1:3000/#/text-input` — TextInput & TextArea
 - `http://127.0.0.1:3000/#/pagination` — Pagination
 - `http://127.0.0.1:3000/#/message` — Message
@@ -88,6 +90,9 @@ import {
   PlusIcon,
   Table,
   Toggle,
+  Checkbox,
+  RadioButton,
+  RadioGroup,
   Selection,
   DateTimePicker,
 } from '@dragunio/fe-libs';
@@ -96,7 +101,7 @@ import '@dragunio/fe-libs/styles.css';
 
 ### Toggle
 
-`Toggle` is a native checkbox styled as a switch. It supports controlled and uncontrolled usage, including the standard `onChange`, `onClick`, and `disabled` props. The active color is green by default and accepts any CSS color.
+`Toggle` is a native checkbox styled as a switch. It supports controlled and uncontrolled usage, including the standard `onChange`, `onClick`, and `disabled` props. The active color is green by default and accepts any CSS color. Use `labelPosition="top"` to render its label above the switch; `right` is the default.
 
 ```tsx
 <Toggle
@@ -107,6 +112,28 @@ import '@dragunio/fe-libs/styles.css';
 />
 ```
 
+### Checkbox and radio controls
+
+`Checkbox` and `RadioButton` keep native input behaviour while adding a styled control. They accept `label` and `labelPosition="top" | "right"` (`right` by default).
+
+`RadioGroup` renders a named, accessible group from `options`. It is controlled with `value` or uncontrolled with `defaultValue`; `onChange` receives `(value, option, event)`. Its group label defaults to `top` and can also use `labelPosition="right"`.
+
+```tsx
+<Checkbox label="Send me product updates" defaultChecked />
+
+<RadioButton name="delivery" value="standard" label="Standard delivery" />
+
+<RadioGroup
+  label="Notification frequency"
+  value={frequency}
+  onChange={(value) => setFrequency(value)}
+  options={[
+    { label: 'Daily', value: 'daily' },
+    { label: 'Weekly', value: 'weekly' },
+  ]}
+/>
+```
+
 ### Resizable data table
 
 Pass `headers` and `data` to have `Table` derive the maximum column count and an initial width for each column. The resize callback emits pixel widths, ready to persist in user preferences.
@@ -138,14 +165,15 @@ The library exposes ESM, CommonJS, TypeScript declarations, and keeps React as a
 - `Drawer` is a portal-based modal panel with `left`, `right`, `top`, and `bottom` slide-in animations. Use `fullScreen` for a full-viewport panel and `footer` for fixed actions below the scrollable body.
 - `Selection` is a rounded custom dropdown inspired by DropdownCustom, with single/multiple modes, optional search, clear action, tags, form-field values, and keyboard navigation.
 - `DateTimePicker` supports `mode="single"` and `mode="range"`; its default format is `dd/MM/yyyy HH:mm`.
-- `NumberInput` and `CurrencyInput` format values immediately while typing (`1000` → `1,000`) and keep up to two fractional digits by default. Use `allowDecimal`, `decimals`, `min`, and `max` to control decimal input and numeric limits. Both support `error` and `errorMessage` with the same red border/message treatment as `TextInput`. `CurrencyInput` adds a `VND` suffix by default, or a currency dropdown through `currencies`.
+- `NumberInput` and `CurrencyInput` format values immediately while typing (`1000` → `1,000`) and keep up to two fractional digits by default. Both include accessible up/down controls (and arrow-key support); use `step` or `showStepper` to configure them. `NumberInput` also accepts `prefix`/`suffix` adornments. Use `allowDecimal`, `decimals`, `min`, and `max` to control decimal input and numeric limits. Both support `error` and `errorMessage` with the same red border/message treatment as `TextInput`. `CurrencyInput` adds a `VND` suffix by default, or a currency dropdown through `currencies`.
 - `Tooltip` shows accessible content on hover and focus.
 - `ExpandableSection` provides controlled and uncontrolled expand/collapse behavior.
-- `TextInput` and `TextArea` support `error`/`errorMessage`, `helperText`, `clearable`, `onClear`, and `onValueChange`. `TextInput` also accepts `label`, `isRequired`, and `prefix`/`suffix` adornments. Passing a string to `error` shows it below the field and applies the error border.
+- `TextInput` and `TextArea` support `error`/`errorMessage`, `helperText`, `clearable`, `onClear`, and `onValueChange`. `TextArea` also accepts `autosize` (default `false`) to grow with its content. `TextInput` also accepts `label`, `isRequired`, and `prefix`/`suffix` adornments. Passing a string to `error` shows it below the field and applies the error border.
 - `Modal` is a centered portal dialog in `small`, `medium`, `large`, `xlarge`, and `full` sizes. Its close control and `actions` are library `Button` instances.
 - `Loading` provides `small`, `medium`, and `large` circular indicators (or a custom pixel `size`); use `Skeleton.Circle` and `Skeleton.Square` with `size`, or `Skeleton.Box` and `Skeleton.Line` with `width` and `height`.
 - `ProgressBar` is determinate when `value` is supplied and renders an indeterminate back-and-forth animation when it is omitted.
 - `Chip` supports the standard `default`, `success`, `error`, `info`, and `warning` palettes, plus `color` for any CSS color and `subtle`, `solid`, or `outline` variants.
+- `Avatar` prioritises `src`, then derives initials from the final two words of `content` (`Nguyễn Minh Anh` → `MA`), and otherwise shows one of 32 built-in illustrated fallbacks. `AvatarGroup` overlaps its Avatar children and turns the final displayed item into `+n` when `maxCount` is exceeded; a single Avatar with `content` shows its content beside the Avatar.
 - `Pagination` supports controlled (`page`) and uncontrolled (`defaultPage`) navigation, compact ellipses, and accessible previous/next controls.
 - Mount `Message` once near the app root and trigger top-right alert notifications with `Message.success`, `Message.info`, `Message.warning`, or `Message.error`. `Snackbar` is a controlled temporary notification with actions, auto-hide, and configurable placement.
 
@@ -165,4 +193,11 @@ The library exposes ESM, CommonJS, TypeScript declarations, and keeps React as a
 <ProgressBar label="Upload" value={72} />
 <ProgressBar label="Synchronising" />
 <Chip status="success" dot>Complete</Chip>
+<Avatar content="Nguyễn Minh Anh" size={48} />
+<AvatarGroup maxCount={3}>
+  <Avatar content="Nguyễn Minh Anh" />
+  <Avatar content="Lê Hoàng Nam" />
+  <Avatar content="Trần Thu Hà" />
+  <Avatar content="Phạm Quốc Bảo" />
+</AvatarGroup>
 ```

package/dist/{chunk-3TCR34LS.mjs → chunk-GT4546FD.mjs}

@@ -118,6 +118,18 @@ function ChevronDownIcon(props) {
     }
   ) });
 }
+function ChevronUpIcon(props) {
+  return /* @__PURE__ */ jsx4("svg", { ...iconProps4(props), children: /* @__PURE__ */ jsx4(
+    "path",
+    {
+      d: "m6 15 6-6 6 6",
+      stroke: "currentColor",
+      strokeWidth: "2",
+      strokeLinecap: "round",
+      strokeLinejoin: "round"
+    }
+  ) });
+}
 function CloseIcon(props) {
   return /* @__PURE__ */ jsx4("svg", { ...iconProps4(props), children: /* @__PURE__ */ jsx4(
     "path",
@@ -129,6 +141,20 @@ function CloseIcon(props) {
     }
   ) });
 }
+function MoreHorizontalIcon(props) {
+  return /* @__PURE__ */ jsxs("svg", { ...iconProps4(props), children: [
+    /* @__PURE__ */ jsx4("circle", { cx: "5", cy: "12", r: "1.75", fill: "currentColor" }),
+    /* @__PURE__ */ jsx4("circle", { cx: "12", cy: "12", r: "1.75", fill: "currentColor" }),
+    /* @__PURE__ */ jsx4("circle", { cx: "19", cy: "12", r: "1.75", fill: "currentColor" })
+  ] });
+}
+function MoreVerticalIcon(props) {
+  return /* @__PURE__ */ jsxs("svg", { ...iconProps4(props), children: [
+    /* @__PURE__ */ jsx4("circle", { cx: "12", cy: "5", r: "1.75", fill: "currentColor" }),
+    /* @__PURE__ */ jsx4("circle", { cx: "12", cy: "12", r: "1.75", fill: "currentColor" }),
+    /* @__PURE__ */ jsx4("circle", { cx: "12", cy: "19", r: "1.75", fill: "currentColor" })
+  ] });
+}
 function SearchIcon(props) {
   return /* @__PURE__ */ jsxs("svg", { ...iconProps4(props), children: [
     /* @__PURE__ */ jsx4("circle", { cx: "11", cy: "11", r: "6.5", stroke: "currentColor", strokeWidth: "2" }),
@@ -164,6 +190,9 @@ export {
   lock_unlocked,
   PlusIcon,
   ChevronDownIcon,
+  ChevronUpIcon,
   CloseIcon,
+  MoreHorizontalIcon,
+  MoreVerticalIcon,
   SearchIcon
 };

package/dist/icons.d.mts

@@ -26,7 +26,10 @@ type IconProps = SVGProps<SVGSVGElement> & {
 };
 declare function PlusIcon(props: IconProps): react.JSX.Element;
 declare function ChevronDownIcon(props: IconProps): react.JSX.Element;
+declare function ChevronUpIcon(props: IconProps): react.JSX.Element;
 declare function CloseIcon(props: IconProps): react.JSX.Element;
+declare function MoreHorizontalIcon(props: IconProps): react.JSX.Element;
+declare function MoreVerticalIcon(props: IconProps): react.JSX.Element;
 declare function SearchIcon(props: IconProps): react.JSX.Element;
 
-export { ChevronDownIcon, CloseIcon, type 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 };
+export { ChevronDownIcon, ChevronUpIcon, CloseIcon, type 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 };

package/dist/icons.d.ts

@@ -26,7 +26,10 @@ type IconProps = SVGProps<SVGSVGElement> & {
 };
 declare function PlusIcon(props: IconProps): react.JSX.Element;
 declare function ChevronDownIcon(props: IconProps): react.JSX.Element;
+declare function ChevronUpIcon(props: IconProps): react.JSX.Element;
 declare function CloseIcon(props: IconProps): react.JSX.Element;
+declare function MoreHorizontalIcon(props: IconProps): react.JSX.Element;
+declare function MoreVerticalIcon(props: IconProps): react.JSX.Element;
 declare function SearchIcon(props: IconProps): react.JSX.Element;
 
-export { ChevronDownIcon, CloseIcon, type 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 };
+export { ChevronDownIcon, ChevronUpIcon, CloseIcon, type 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 };

package/dist/icons.js

@@ -21,7 +21,10 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var icons_exports = {};
 __export(icons_exports, {
   ChevronDownIcon: () => ChevronDownIcon,
+  ChevronUpIcon: () => ChevronUpIcon,
   CloseIcon: () => CloseIcon,
+  MoreHorizontalIcon: () => MoreHorizontalIcon,
+  MoreVerticalIcon: () => MoreVerticalIcon,
   PlusIcon: () => PlusIcon,
   SearchIcon: () => SearchIcon,
   arrow_left: () => arrow_left,
@@ -164,6 +167,18 @@ function ChevronDownIcon(props) {
     }
   ) });
 }
+function ChevronUpIcon(props) {
+  return /* @__PURE__ */ (0, import_jsx_runtime4.jsx)("svg", { ...iconProps4(props), children: /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(
+    "path",
+    {
+      d: "m6 15 6-6 6 6",
+      stroke: "currentColor",
+      strokeWidth: "2",
+      strokeLinecap: "round",
+      strokeLinejoin: "round"
+    }
+  ) });
+}
 function CloseIcon(props) {
   return /* @__PURE__ */ (0, import_jsx_runtime4.jsx)("svg", { ...iconProps4(props), children: /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(
     "path",
@@ -175,6 +190,20 @@ function CloseIcon(props) {
     }
   ) });
 }
+function MoreHorizontalIcon(props) {
+  return /* @__PURE__ */ (0, import_jsx_runtime4.jsxs)("svg", { ...iconProps4(props), children: [
+    /* @__PURE__ */ (0, import_jsx_runtime4.jsx)("circle", { cx: "5", cy: "12", r: "1.75", fill: "currentColor" }),
+    /* @__PURE__ */ (0, import_jsx_runtime4.jsx)("circle", { cx: "12", cy: "12", r: "1.75", fill: "currentColor" }),
+    /* @__PURE__ */ (0, import_jsx_runtime4.jsx)("circle", { cx: "19", cy: "12", r: "1.75", fill: "currentColor" })
+  ] });
+}
+function MoreVerticalIcon(props) {
+  return /* @__PURE__ */ (0, import_jsx_runtime4.jsxs)("svg", { ...iconProps4(props), children: [
+    /* @__PURE__ */ (0, import_jsx_runtime4.jsx)("circle", { cx: "12", cy: "5", r: "1.75", fill: "currentColor" }),
+    /* @__PURE__ */ (0, import_jsx_runtime4.jsx)("circle", { cx: "12", cy: "12", r: "1.75", fill: "currentColor" }),
+    /* @__PURE__ */ (0, import_jsx_runtime4.jsx)("circle", { cx: "12", cy: "19", r: "1.75", fill: "currentColor" })
+  ] });
+}
 function SearchIcon(props) {
   return /* @__PURE__ */ (0, import_jsx_runtime4.jsxs)("svg", { ...iconProps4(props), children: [
     /* @__PURE__ */ (0, import_jsx_runtime4.jsx)("circle", { cx: "11", cy: "11", r: "6.5", stroke: "currentColor", strokeWidth: "2" }),
@@ -192,7 +221,10 @@ function SearchIcon(props) {
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   ChevronDownIcon,
+  ChevronUpIcon,
   CloseIcon,
+  MoreHorizontalIcon,
+  MoreVerticalIcon,
   PlusIcon,
   SearchIcon,
   arrow_left,

package/dist/icons.mjs

@@ -1,6 +1,9 @@
 import {
   ChevronDownIcon,
+  ChevronUpIcon,
   CloseIcon,
+  MoreHorizontalIcon,
+  MoreVerticalIcon,
   PlusIcon,
   SearchIcon,
   arrow_left,
@@ -20,10 +23,13 @@ import {
   search,
   trash,
   x_close
-} from "./chunk-3TCR34LS.mjs";
+} from "./chunk-GT4546FD.mjs";
 export {
   ChevronDownIcon,
+  ChevronUpIcon,
   CloseIcon,
+  MoreHorizontalIcon,
+  MoreVerticalIcon,
   PlusIcon,
   SearchIcon,
   arrow_left,

package/dist/index.d.mts

@@ -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.mjs';
+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.mjs';
 
 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 };