@soroush.tech/design-system 0.1.0

package/dist/index-C0xMvDjL.d.mts

@@ -0,0 +1,49 @@
+import { l as index_d_exports, o as Theme } from "./index-Dm9HfgV6.mjs";
+import { l as PaletteColor, n as ButtonVariants } from "./themes-D1SAp3SL.mjs";
+import { ButtonHTMLAttributes, ReactNode } from "react";
+//#region src/Button/Button.d.ts
+/** Augmentable via the `ButtonVariants` interface — style new values through `theme.components.Button.variants`. */
+type ButtonVariant = keyof ButtonVariants;
+type ButtonColor = PaletteColor;
+type ButtonSize = keyof Theme['sizes'];
+type ButtonShape = 'square' | 'rounded' | 'pill';
+type ButtonLoadingPosition = 'start' | 'end' | 'center';
+/** Valid values for the gap prop — resolves against theme.space. */
+type GapToken = keyof Theme['space'];
+interface ButtonProps extends Omit<ButtonHTMLAttributes<HTMLButtonElement>, 'color'>, index_d_exports.SpaceProps<Theme>, index_d_exports.LayoutProps<Theme>, index_d_exports.BorderProps<Theme>, index_d_exports.TypographyProps<Theme> {
+  /** Visual style — filled, stroked, or ghost. Default: `'contained'`, overridable via `theme.defaults.buttonVariant`. */
+  variant?: ButtonVariant;
+  /** Color palette — maps to `theme.palette[color]`. Default: `'primary'`, overridable via `theme.defaults.color`. */
+  color?: ButtonColor;
+  /** Size token — controls padding and font size. Default: `'md'`, overridable via `theme.defaults.size`. */
+  size?: ButtonSize;
+  /** Gap between icon and label — resolves against theme.space. Default: `1` (8px). */
+  gap?: GapToken;
+  /** Icon rendered before the label. */
+  startIcon?: ReactNode;
+  /** Icon rendered after the label. */
+  endIcon?: ReactNode;
+  /** Stretch button to full container width. */
+  fullWidth?: boolean;
+  /** Shows loading indicator and disables the button. */
+  loading?: boolean;
+  /** Custom loading element. Default: animated spinner. */
+  loadingIndicator?: ReactNode;
+  /**
+   * Corner shape — sets the default `borderRadius`.
+   * `"square"` → 0 · `"rounded"` → `theme.radii.md` (default) · `"pill"` → 9999px
+   * The `borderRadius` prop always overrides this.
+   */
+  shape?: ButtonShape;
+  /** Where the loading indicator appears. Default: `"center"`. */
+  loadingPosition?: ButtonLoadingPosition;
+  /** The URL to link to when the button is clicked. If defined, an `a` element will be used as the root node. */
+  href?: string;
+  /** Anchor `target` — only meaningful when `href` is set. */
+  target?: string;
+  /** Anchor `rel` — only meaningful when `href` is set. */
+  rel?: string;
+}
+declare function Button({ variant, color, size, shape, gap, fontWeight, letterSpacing, startIcon, endIcon, fullWidth, loading, loadingIndicator, loadingPosition, children, disabled, href, ...rest }: Readonly<ButtonProps>): import("react").JSX.Element;
+//#endregion
+export { ButtonShape as a, GapToken as c, ButtonProps as i, ButtonColor as n, ButtonSize as o, ButtonLoadingPosition as r, ButtonVariant as s, Button as t };

package/dist/index-C5_ciaeo.d.cts

@@ -0,0 +1,79 @@
+import { l as index_d_exports, o as Theme } from "./index-Bihpwn75.cjs";
+import { ChangeEventHandler, ElementType, InputHTMLAttributes, TextareaHTMLAttributes } from "react";
+//#region src/TextInput/TextInput.d.ts
+type TextInputColor = keyof Theme['palette'];
+type TextInputTextColor = keyof Theme['text'];
+type TextInputVariant = 'default' | 'outlined' | 'text' | 'underline';
+type TextInputSize = keyof Theme['sizes'];
+interface TextInputClasses {
+  root?: string;
+  input?: string;
+}
+interface TextInputProps extends index_d_exports.SpaceProps<Theme>, Pick<index_d_exports.LayoutProps<Theme>, 'width' | 'minWidth' | 'maxWidth'> {
+  /** Corner radius — applies only to `default` and `outlined` variants. Resolves against `theme.radii`. */
+  borderRadius?: keyof Theme['radii'];
+  autoComplete?: string;
+  autoFocus?: boolean;
+  /** Class names applied to inner elements. `root` targets the wrapper; `input` targets the native element. */
+  classes?: TextInputClasses;
+  /** Override components for the Root and Input slots. */
+  components?: {
+    Input?: ElementType;
+    Root?: ElementType;
+  };
+  /** Focus/active border color — resolves to `theme.palette[color].main`. Default: 'primary', overridable via `theme.defaults.color`. */
+  color?: TextInputColor;
+  /** Text color of the typed value — resolves against `theme.text`. Default: 'primary', overridable via `theme.defaults.accentTextColor`. */
+  textColor?: TextInputTextColor;
+  /** Disables the input. */
+  disabled?: boolean;
+  /** Marks the field as invalid — applies error border color. */
+  error?: boolean;
+  /** Stretches the root to fill its container. */
+  fullWidth?: boolean;
+  id?: string;
+  /** Custom component for the input element. Takes priority over `components.Input`. Default: `'input'`. */
+  inputComponent?: ElementType;
+  /** Native HTML `size` attribute — visible width in character widths. Has no effect with `multiline` or `resize`. */
+  inputSize?: number;
+  /** Extra props spread onto the native element. Explicit top-level props take priority. */
+  inputProps?: InputHTMLAttributes<HTMLInputElement> & TextareaHTMLAttributes<HTMLTextAreaElement>;
+  /** Maximum rows before the auto-grow textarea starts scrolling. Only applies when `resize` is set. */
+  maxRows?: number | string;
+  /** Minimum rows for the auto-grow textarea. Only applies when `resize` is set. */
+  minRows?: number | string;
+  /**
+   * Renders a `<textarea>` that grows with its content.
+   * Combine with `rows` to fix the height instead of auto-growing.
+   */
+  multiline?: boolean;
+  name?: string;
+  onChange?: ChangeEventHandler<HTMLInputElement | HTMLTextAreaElement>;
+  placeholder?: string;
+  readOnly?: boolean;
+  required?: boolean;
+  /** Auto-grows the textarea as content increases. Requires `multiline`. */
+  resize?: boolean;
+  /** Controls padding and font size. Default: 'md', overridable via `theme.defaults.size`. */
+  size?: TextInputSize;
+  /**
+   * Fixes the textarea height to this many rows. Also enables `multiline`
+   * when value is greater than 1. Disables resize.
+   */
+  rows?: number | string;
+  /** HTML input type. Ignored when multiline. Default: `'text'`. */
+  type?: string;
+  /**
+   * Visual style of the input.
+   * - `outlined` / `default` — full border box (default)
+   * - `underline` — border on bottom only
+   * - `text` — no border, transparent background
+   */
+  variant?: TextInputVariant;
+  value?: string | number | readonly string[];
+  className?: string;
+  'data-testid'?: string;
+}
+declare function TextInput({ autoComplete, autoFocus, borderRadius, classes, components, color: colorProp, textColor: textColorProp, disabled: disabledProp, error: errorProp, fullWidth: fullWidthProp, id: idProp, inputComponent, inputProps, inputSize, maxRows, minRows, multiline, name, onChange, placeholder, readOnly, required: requiredProp, resize, rows, size: sizeProp, type, value, variant: variantProp, className, 'data-testid': dataTestid, ...spaceProps }: Readonly<TextInputProps>): import("react").JSX.Element;
+//#endregion
+export { TextInputSize as a, TextInputProps as i, TextInputClasses as n, TextInputTextColor as o, TextInputColor as r, TextInputVariant as s, TextInput as t };

package/dist/index-CDVnvjIE.d.cts

@@ -0,0 +1,27 @@
+import { l as index_d_exports, o as Theme } from "./index-Bihpwn75.cjs";
+import { F as TypographyVariant } from "./themes-D81JYbqm.cjs";
+import { CSSProperties, ElementType, HTMLAttributes } from "react";
+//#region src/Typography/Typography.d.ts
+type TypographyAlign = 'left' | 'right' | 'center' | 'justify' | 'inherit';
+/** Valid values for the color prop — derived from theme.text keys. */
+type TextColorToken = keyof Theme['text'];
+/** Valid values for the bg prop — derived from theme.background keys. */
+type BackgroundToken = keyof Theme['background'];
+interface TypographyProps extends Omit<HTMLAttributes<HTMLElement>, 'color'>, index_d_exports.SpaceProps<Theme>, index_d_exports.LayoutProps<Theme>, index_d_exports.TypographyProps<Theme>, index_d_exports.FlexboxProps<Theme>, index_d_exports.BorderProps<Theme>, index_d_exports.PositionProps<Theme> {
+  /** Resolves against theme.text — inherit · initial · primary · secondary · error · success */
+  color?: TextColorToken;
+  /** Resolves against theme.background */
+  bg?: BackgroundToken;
+  opacity?: number;
+  textTransform?: CSSProperties['textTransform'];
+  variant?: TypographyVariant;
+  align?: TypographyAlign;
+  gutterBottom?: boolean;
+  noWrap?: boolean;
+  /** Machine-readable timestamp — forwarded when rendering as `<time>` (`as="time"`). */
+  dateTime?: string;
+  as?: ElementType;
+}
+declare function Typography({ variant, as, ...rest }: Readonly<TypographyProps>): import("react").JSX.Element;
+//#endregion
+export { TypographyProps as a, TypographyAlign as i, TextColorToken as n, Typography as r, BackgroundToken as t };

package/dist/index-CDcGTGR4.d.cts

@@ -0,0 +1,21 @@
+import { l as index_d_exports, o as Theme } from "./index-Bihpwn75.cjs";
+import { ElementType, HTMLAttributes } from "react";
+//#region src/Table/TableFooter/TableFooter.d.ts
+/** Valid values for the color prop — derived from theme.text keys. */
+type TableFooterColorToken = keyof Theme['text'];
+/** Valid values for the bg prop — derived from theme.background keys. */
+type TableFooterBackgroundToken = keyof Theme['background'];
+/** Valid values for the borderColor prop — derived from theme.border keys. */
+type TableFooterBorderColorToken = keyof Theme['border'];
+interface TableFooterProps extends Omit<HTMLAttributes<HTMLTableSectionElement>, 'color'>, index_d_exports.SpaceProps<Theme>, Omit<index_d_exports.BorderProps<Theme>, 'borderColor' | 'borderRadius'> {
+  /** Resolves against theme.text */
+  color?: TableFooterColorToken;
+  /** Resolves against theme.background */
+  bg?: TableFooterBackgroundToken;
+  /** Resolves against theme.border — light · primary · dark */
+  borderColor?: TableFooterBorderColorToken;
+  as?: ElementType;
+}
+declare function TableFooter({ as, children, ...rest }: Readonly<TableFooterProps>): import("react").JSX.Element;
+//#endregion
+export { TableFooterProps as a, TableFooterColorToken as i, TableFooterBackgroundToken as n, TableFooterBorderColorToken as r, TableFooter as t };

package/dist/index-CEOZI-6L.d.mts

@@ -0,0 +1,48 @@
+import { l as index_d_exports, o as Theme } from "./index-Dm9HfgV6.mjs";
+import { l as PaletteColor } from "./themes-D1SAp3SL.mjs";
+import { t as TableCellPadding } from "./TableContext-2qH7XYJB.mjs";
+import { ElementType, TableHTMLAttributes } from "react";
+//#region src/Table/Table/Table.d.ts
+/** Valid values for the bg prop — derived from theme.background keys. */
+type TableBackgroundToken = keyof Theme['background'];
+/** Valid values for the size prop — derived from theme.sizes keys. */
+type TableSize = keyof Theme['sizes'];
+/** Valid values for the borderColor prop — derived from theme.border keys. */
+type TableBorderColorToken = keyof Theme['border'];
+interface TableProps extends Omit<TableHTMLAttributes<HTMLTableElement>, 'color' | 'cellPadding' | 'align' | 'width' | 'border'>, index_d_exports.SpaceProps<Theme>, index_d_exports.LayoutProps<Theme>, Omit<index_d_exports.BorderProps<Theme>, 'borderColor'> {
+  /**
+   * Palette color for descendant rows' hover/selected shading — broadcast to
+   * `TableRow`s via `TableContext`; a row's own `color` wins.
+   */
+  color?: PaletteColor;
+  /** Resolves against theme.background */
+  bg?: TableBackgroundToken;
+  /** Resolves against theme.border — light · primary · dark */
+  borderColor?: TableBorderColorToken;
+  /** Cell density — broadcast to descendant `TableCell`s via `TableContext`. Default: 'md', overridable via `theme.defaults.size`. */
+  size?: TableSize;
+  /** Cell padding mode — broadcast to descendant `TableCell`s. `'none'` zeroes cell padding. Default: `'normal'`. */
+  cellPadding?: TableCellPadding;
+  /** Makes header cells stick to the top of a scrolling `TableContainer`. Default: `false`. */
+  hasStickyHeader?: boolean;
+  /**
+   * Hides inactive sort icons (revealed on hover/focus) — broadcast to
+   * descendant `TableSortLabel`s via `TableContext`. Set `false` to keep them
+   * always visible (dimmed). Default: `true`.
+   */
+  shouldHideSortIcon?: boolean;
+  /**
+   * Truncates overflowing cell text with an ellipsis — broadcast to descendant
+   * `TableCell`s via `TableContext`. Cells need a constrained width (e.g.
+   * `maxWidth`) for the truncation to kick in. Default: `false`.
+   */
+  hasEllipsis?: boolean;
+  /** Default text alignment for every cell — cells with `align="inherit"` (the default) follow it. */
+  align?: TableAlign;
+  as?: ElementType;
+}
+/** Table-wide text alignment — inherited by head, body, and footer cells alike. */
+type TableAlign = 'left' | 'right' | 'center' | 'justify';
+declare function Table({ size, cellPadding, hasStickyHeader, shouldHideSortIcon, hasEllipsis, color, align, as, children, ...rest }: Readonly<TableProps>): import("react").JSX.Element;
+//#endregion
+export { TableProps as a, TableBorderColorToken as i, TableAlign as n, TableSize as o, TableBackgroundToken as r, Table as t };

package/dist/index-CLU39rUS2.d.mts

@@ -0,0 +1,30 @@
+import { l as index_d_exports, o as Theme } from "./index-Dm9HfgV6.mjs";
+import { l as PaletteColor } from "./themes-D1SAp3SL.mjs";
+import { ElementType, HTMLAttributes } from "react";
+//#region src/Table/TableRow/TableRow.d.ts
+/** Palette color driving the hover/selected shading — a `theme.palette` key. */
+type TableRowColor = PaletteColor;
+/** Valid values for the bg prop — derived from theme.background keys. */
+type TableRowBackgroundToken = keyof Theme['background'];
+/** Valid values for the borderColor prop — derived from theme.border keys. */
+type TableRowBorderColorToken = keyof Theme['border'];
+interface TableRowProps extends Omit<HTMLAttributes<HTMLTableRowElement>, 'color'>, index_d_exports.SpaceProps<Theme>, Omit<index_d_exports.BorderProps<Theme>, 'borderColor' | 'borderRadius'> {
+  /**
+   * Palette color for the hover/selected shading — maps to `theme.palette[color]`
+   * (hover → `.light`, selected → `.dark`, both with `contrastText`). Falls back
+   * to the enclosing `Table`'s `color`. Default: 'primary', overridable via `theme.defaults.color`.
+   */
+  color?: TableRowColor;
+  as?: ElementType;
+  /** Resolves against theme.background */
+  bg?: TableRowBackgroundToken;
+  /** Resolves against theme.border — light · primary · dark */
+  borderColor?: TableRowBorderColorToken;
+  /** Shades the row on hover with `theme.palette[color].light`. Default: `false`. */
+  isHoverable?: boolean;
+  /** Fills the row with `theme.palette[color].dark` + contrast text. Default: `false`. */
+  isSelected?: boolean;
+}
+declare function TableRow({ color, ...rest }: Readonly<TableRowProps>): import("react").JSX.Element;
+//#endregion
+export { TableRowProps as a, TableRowColor as i, TableRowBackgroundToken as n, TableRowBorderColorToken as r, TableRow as t };

package/dist/index-CM_KCTee.d.cts

@@ -0,0 +1,48 @@
+import { l as index_d_exports, o as Theme } from "./index-Bihpwn75.cjs";
+import { l as PaletteColor } from "./themes-D81JYbqm.cjs";
+import { t as TableCellPadding } from "./TableContext-2qH7XYJB.cjs";
+import { ElementType, TableHTMLAttributes } from "react";
+//#region src/Table/Table/Table.d.ts
+/** Valid values for the bg prop — derived from theme.background keys. */
+type TableBackgroundToken = keyof Theme['background'];
+/** Valid values for the size prop — derived from theme.sizes keys. */
+type TableSize = keyof Theme['sizes'];
+/** Valid values for the borderColor prop — derived from theme.border keys. */
+type TableBorderColorToken = keyof Theme['border'];
+interface TableProps extends Omit<TableHTMLAttributes<HTMLTableElement>, 'color' | 'cellPadding' | 'align' | 'width' | 'border'>, index_d_exports.SpaceProps<Theme>, index_d_exports.LayoutProps<Theme>, Omit<index_d_exports.BorderProps<Theme>, 'borderColor'> {
+  /**
+   * Palette color for descendant rows' hover/selected shading — broadcast to
+   * `TableRow`s via `TableContext`; a row's own `color` wins.
+   */
+  color?: PaletteColor;
+  /** Resolves against theme.background */
+  bg?: TableBackgroundToken;
+  /** Resolves against theme.border — light · primary · dark */
+  borderColor?: TableBorderColorToken;
+  /** Cell density — broadcast to descendant `TableCell`s via `TableContext`. Default: 'md', overridable via `theme.defaults.size`. */
+  size?: TableSize;
+  /** Cell padding mode — broadcast to descendant `TableCell`s. `'none'` zeroes cell padding. Default: `'normal'`. */
+  cellPadding?: TableCellPadding;
+  /** Makes header cells stick to the top of a scrolling `TableContainer`. Default: `false`. */
+  hasStickyHeader?: boolean;
+  /**
+   * Hides inactive sort icons (revealed on hover/focus) — broadcast to
+   * descendant `TableSortLabel`s via `TableContext`. Set `false` to keep them
+   * always visible (dimmed). Default: `true`.
+   */
+  shouldHideSortIcon?: boolean;
+  /**
+   * Truncates overflowing cell text with an ellipsis — broadcast to descendant
+   * `TableCell`s via `TableContext`. Cells need a constrained width (e.g.
+   * `maxWidth`) for the truncation to kick in. Default: `false`.
+   */
+  hasEllipsis?: boolean;
+  /** Default text alignment for every cell — cells with `align="inherit"` (the default) follow it. */
+  align?: TableAlign;
+  as?: ElementType;
+}
+/** Table-wide text alignment — inherited by head, body, and footer cells alike. */
+type TableAlign = 'left' | 'right' | 'center' | 'justify';
+declare function Table({ size, cellPadding, hasStickyHeader, shouldHideSortIcon, hasEllipsis, color, align, as, children, ...rest }: Readonly<TableProps>): import("react").JSX.Element;
+//#endregion
+export { TableProps as a, TableBorderColorToken as i, TableAlign as n, TableSize as o, TableBackgroundToken as r, Table as t };

package/dist/index-CT9uGKrs.d.cts

@@ -0,0 +1,30 @@
+import { l as index_d_exports, o as Theme } from "./index-Bihpwn75.cjs";
+import { l as PaletteColor } from "./themes-D81JYbqm.cjs";
+import { ElementType, HTMLAttributes } from "react";
+//#region src/Table/TableRow/TableRow.d.ts
+/** Palette color driving the hover/selected shading — a `theme.palette` key. */
+type TableRowColor = PaletteColor;
+/** Valid values for the bg prop — derived from theme.background keys. */
+type TableRowBackgroundToken = keyof Theme['background'];
+/** Valid values for the borderColor prop — derived from theme.border keys. */
+type TableRowBorderColorToken = keyof Theme['border'];
+interface TableRowProps extends Omit<HTMLAttributes<HTMLTableRowElement>, 'color'>, index_d_exports.SpaceProps<Theme>, Omit<index_d_exports.BorderProps<Theme>, 'borderColor' | 'borderRadius'> {
+  /**
+   * Palette color for the hover/selected shading — maps to `theme.palette[color]`
+   * (hover → `.light`, selected → `.dark`, both with `contrastText`). Falls back
+   * to the enclosing `Table`'s `color`. Default: 'primary', overridable via `theme.defaults.color`.
+   */
+  color?: TableRowColor;
+  as?: ElementType;
+  /** Resolves against theme.background */
+  bg?: TableRowBackgroundToken;
+  /** Resolves against theme.border — light · primary · dark */
+  borderColor?: TableRowBorderColorToken;
+  /** Shades the row on hover with `theme.palette[color].light`. Default: `false`. */
+  isHoverable?: boolean;
+  /** Fills the row with `theme.palette[color].dark` + contrast text. Default: `false`. */
+  isSelected?: boolean;
+}
+declare function TableRow({ color, ...rest }: Readonly<TableRowProps>): import("react").JSX.Element;
+//#endregion
+export { TableRowProps as a, TableRowColor as i, TableRowBackgroundToken as n, TableRowBorderColorToken as r, TableRow as t };

package/dist/index-CcYSvIJi.d.cts

@@ -0,0 +1,21 @@
+import { l as index_d_exports, o as Theme } from "./index-Bihpwn75.cjs";
+import { ElementType, HTMLAttributes } from "react";
+//#region src/Table/TableHead/TableHead.d.ts
+/** Valid values for the color prop — derived from theme.text keys. */
+type TableHeadColorToken = keyof Theme['text'];
+/** Valid values for the bg prop — derived from theme.background keys. */
+type TableHeadBackgroundToken = keyof Theme['background'];
+/** Valid values for the borderColor prop — derived from theme.border keys. */
+type TableHeadBorderColorToken = keyof Theme['border'];
+interface TableHeadProps extends Omit<HTMLAttributes<HTMLTableSectionElement>, 'color'>, index_d_exports.SpaceProps<Theme>, Omit<index_d_exports.BorderProps<Theme>, 'borderColor' | 'borderRadius'> {
+  /** Resolves against theme.text */
+  color?: TableHeadColorToken;
+  /** Resolves against theme.background */
+  bg?: TableHeadBackgroundToken;
+  /** Resolves against theme.border — light · primary · dark */
+  borderColor?: TableHeadBorderColorToken;
+  as?: ElementType;
+}
+declare function TableHead({ as, children, ...rest }: Readonly<TableHeadProps>): import("react").JSX.Element;
+//#endregion
+export { TableHeadProps as a, TableHeadColorToken as i, TableHeadBackgroundToken as n, TableHeadBorderColorToken as r, TableHead as t };

package/dist/index-CdF_4ckE.d.mts

@@ -0,0 +1,11 @@
+import { a as TypographyProps } from "./index-DE5PtzPn.mjs";
+import { AnchorHTMLAttributes } from "react";
+//#region src/Link/Link.d.ts
+type LinkUnderline = 'always' | 'hover' | 'none';
+interface LinkProps extends Omit<TypographyProps, 'as'>, Omit<AnchorHTMLAttributes<HTMLAnchorElement>, keyof Omit<TypographyProps, 'as'>> {
+  underline?: LinkUnderline;
+  gap?: number | string;
+}
+declare function Link({ underline: underlineProp, color, variant, target, rel, ...rest }: Readonly<LinkProps>): import("react").JSX.Element;
+//#endregion
+export { LinkProps as n, LinkUnderline as r, Link as t };

package/dist/index-CeYkEXU2.d.cts

@@ -0,0 +1,68 @@
+import { l as index_d_exports, o as Theme } from "./index-Bihpwn75.cjs";
+import { l as PaletteColor } from "./themes-D81JYbqm.cjs";
+import { ButtonHTMLAttributes, ElementType, ReactNode } from "react";
+//#region src/Pagination/hooks/usePagination.d.ts
+type PaginationItemType = 'page' | 'first' | 'previous' | 'next' | 'last' | 'start-ellipsis' | 'end-ellipsis';
+/** One renderable pagination item — `Pagination` maps these onto `PaginationItem`s. */
+interface UsePaginationItem {
+  type: PaginationItemType;
+  /** Target page for actionable items; `null` for ellipses. */
+  page: number | null;
+  isSelected: boolean;
+  isDisabled: boolean;
+  onClick?: () => void;
+}
+interface UsePaginationProps {
+  /** Total number of pages. */
+  count: number;
+  /** Controlled current page (1-based). */
+  page?: number;
+  /** Uncontrolled initial page. Default: `1`. */
+  defaultPage?: number;
+  /** Pages always visible either side of the current page. Default: `1`. */
+  siblingCount?: number;
+  /** Pages always visible at the start and end. Default: `1`. */
+  boundaryCount?: number;
+  /** Disables every item. Default: `false`. */
+  disabled?: boolean;
+  shouldShowFirstButton?: boolean;
+  shouldShowLastButton?: boolean;
+  shouldHidePrevButton?: boolean;
+  shouldHideNextButton?: boolean;
+  /** Fired with the target page (1-based). */
+  onChange?: (page: number) => void;
+}
+/**
+ * Headless pagination model — computes the item list (nav buttons, page numbers,
+ * ellipses) with selection, boundary disabling, and controlled/uncontrolled paging.
+ */
+declare function usePagination({ count, page: pageProp, defaultPage, siblingCount, boundaryCount, disabled, shouldShowFirstButton, shouldShowLastButton, shouldHidePrevButton, shouldHideNextButton, onChange }: UsePaginationProps): {
+  items: UsePaginationItem[];
+};
+//#endregion
+//#region src/Pagination/PaginationItem/PaginationItem.d.ts
+type PaginationItemColor = PaletteColor;
+type PaginationItemVariant = 'text' | 'outlined';
+type PaginationItemShape = 'circular' | 'rounded';
+type PaginationItemSize = keyof Theme['sizes'];
+interface PaginationItemProps extends Omit<ButtonHTMLAttributes<HTMLButtonElement>, 'color' | 'type'>, index_d_exports.SpaceProps<Theme> {
+  /** What the item renders — a page number, a nav control, or a non-interactive ellipsis. */
+  type?: PaginationItemType;
+  /** The page number/content for `type="page"`. */
+  page?: ReactNode;
+  /** Active styling for the current page. Default: `false`. */
+  isSelected?: boolean;
+  /** Selected-state color — resolves against `theme.palette`. Default: 'primary', overridable via `theme.defaults.color`. */
+  color?: PaginationItemColor;
+  /** `text` — no border · `outlined` — stroked. Default: `'text'`. */
+  variant?: PaginationItemVariant;
+  /** Corner shape. Default: `'circular'`. */
+  shape?: PaginationItemShape;
+  /** Item dimensions and font size — resolves against `theme.sizes`. Default: 'md', overridable via `theme.defaults.size`. */
+  size?: PaginationItemSize;
+  disabled?: boolean;
+  as?: ElementType;
+}
+declare function PaginationItem({ type, page, isSelected, color, variant, shape, size, as, ...rest }: Readonly<PaginationItemProps>): import("react").JSX.Element;
+//#endregion
+export { PaginationItemSize as a, UsePaginationItem as c, PaginationItemShape as i, UsePaginationProps as l, PaginationItemColor as n, PaginationItemVariant as o, PaginationItemProps as r, PaginationItemType as s, PaginationItem as t, usePagination as u };

package/dist/index-Cl_yBpzW2.d.mts

@@ -0,0 +1,13 @@
+import "./index-DCQ2fsDu.mjs";
+import "./index-DmJIuQJj.mjs";
+import "./TableContext-2qH7XYJB.mjs";
+import "./index-CEOZI-6L.mjs";
+import "./index-C-P_hipv.mjs";
+import "./index-BH8jQOdF.mjs";
+import "./index-DBGE6yKw.mjs";
+import "./index-u57CbuAU2.mjs";
+import "./index-g9EThkSg.mjs";
+import "./index-DvW2eETV.mjs";
+import "./index-BnzUumAC2.mjs";
+import "./index-kpk9e3xM2.mjs";
+import "./index-CLU39rUS2.mjs";

package/dist/index-Cv_UOfYx.d.mts

@@ -0,0 +1,18 @@
+import { a as TypographyProps } from "./index-DE5PtzPn.mjs";
+import { ReactNode } from "react";
+//#region src/FormLabel/FormLabel.d.ts
+interface FormLabelProps extends TypographyProps {
+  children: ReactNode;
+  /** Appends a `*` indicator. Falls back to the FormControl `required` value. */
+  required?: boolean;
+  /** Target control id. Falls back to the FormControl id. */
+  htmlFor?: string;
+}
+/**
+ * Renders a `<label>` linked to the control via `htmlFor`, reading the id and
+ * `required` flag from FormControl context. All Typography props pass through,
+ * so callers can restyle freely while keeping the wiring automatic.
+ */
+declare function FormLabel({ children, required, htmlFor, color, ...rest }: Readonly<FormLabelProps>): import("react").JSX.Element;
+//#endregion
+export { FormLabelProps as n, FormLabel as t };

package/dist/index-CxSNNzBT2.d.mts

@@ -0,0 +1,68 @@
+import { l as index_d_exports, o as Theme } from "./index-Dm9HfgV6.mjs";
+import { l as PaletteColor } from "./themes-D1SAp3SL.mjs";
+import { ButtonHTMLAttributes, ElementType, ReactNode } from "react";
+//#region src/Pagination/hooks/usePagination.d.ts
+type PaginationItemType = 'page' | 'first' | 'previous' | 'next' | 'last' | 'start-ellipsis' | 'end-ellipsis';
+/** One renderable pagination item — `Pagination` maps these onto `PaginationItem`s. */
+interface UsePaginationItem {
+  type: PaginationItemType;
+  /** Target page for actionable items; `null` for ellipses. */
+  page: number | null;
+  isSelected: boolean;
+  isDisabled: boolean;
+  onClick?: () => void;
+}
+interface UsePaginationProps {
+  /** Total number of pages. */
+  count: number;
+  /** Controlled current page (1-based). */
+  page?: number;
+  /** Uncontrolled initial page. Default: `1`. */
+  defaultPage?: number;
+  /** Pages always visible either side of the current page. Default: `1`. */
+  siblingCount?: number;
+  /** Pages always visible at the start and end. Default: `1`. */
+  boundaryCount?: number;
+  /** Disables every item. Default: `false`. */
+  disabled?: boolean;
+  shouldShowFirstButton?: boolean;
+  shouldShowLastButton?: boolean;
+  shouldHidePrevButton?: boolean;
+  shouldHideNextButton?: boolean;
+  /** Fired with the target page (1-based). */
+  onChange?: (page: number) => void;
+}
+/**
+ * Headless pagination model — computes the item list (nav buttons, page numbers,
+ * ellipses) with selection, boundary disabling, and controlled/uncontrolled paging.
+ */
+declare function usePagination({ count, page: pageProp, defaultPage, siblingCount, boundaryCount, disabled, shouldShowFirstButton, shouldShowLastButton, shouldHidePrevButton, shouldHideNextButton, onChange }: UsePaginationProps): {
+  items: UsePaginationItem[];
+};
+//#endregion
+//#region src/Pagination/PaginationItem/PaginationItem.d.ts
+type PaginationItemColor = PaletteColor;
+type PaginationItemVariant = 'text' | 'outlined';
+type PaginationItemShape = 'circular' | 'rounded';
+type PaginationItemSize = keyof Theme['sizes'];
+interface PaginationItemProps extends Omit<ButtonHTMLAttributes<HTMLButtonElement>, 'color' | 'type'>, index_d_exports.SpaceProps<Theme> {
+  /** What the item renders — a page number, a nav control, or a non-interactive ellipsis. */
+  type?: PaginationItemType;
+  /** The page number/content for `type="page"`. */
+  page?: ReactNode;
+  /** Active styling for the current page. Default: `false`. */
+  isSelected?: boolean;
+  /** Selected-state color — resolves against `theme.palette`. Default: 'primary', overridable via `theme.defaults.color`. */
+  color?: PaginationItemColor;
+  /** `text` — no border · `outlined` — stroked. Default: `'text'`. */
+  variant?: PaginationItemVariant;
+  /** Corner shape. Default: `'circular'`. */
+  shape?: PaginationItemShape;
+  /** Item dimensions and font size — resolves against `theme.sizes`. Default: 'md', overridable via `theme.defaults.size`. */
+  size?: PaginationItemSize;
+  disabled?: boolean;
+  as?: ElementType;
+}
+declare function PaginationItem({ type, page, isSelected, color, variant, shape, size, as, ...rest }: Readonly<PaginationItemProps>): import("react").JSX.Element;
+//#endregion
+export { PaginationItemSize as a, UsePaginationItem as c, PaginationItemShape as i, UsePaginationProps as l, PaginationItemColor as n, PaginationItemVariant as o, PaginationItemProps as r, PaginationItemType as s, PaginationItem as t, usePagination as u };

package/dist/index-CyZYXDn0.d.cts

@@ -0,0 +1,42 @@
+import { l as index_d_exports, o as Theme } from "./index-Bihpwn75.cjs";
+import { n as ButtonColor, o as ButtonSize, s as ButtonVariant } from "./index-DASvoACZ.cjs";
+import { ElementType, HTMLAttributes } from "react";
+//#region src/ButtonGroup/ButtonGroup.d.ts
+type ButtonGroupOrientation = 'horizontal' | 'vertical';
+type ButtonGroupRadius = keyof Theme['radii'];
+interface ButtonGroupProps extends Omit<HTMLAttributes<HTMLDivElement>, 'color'>, index_d_exports.SpaceProps<Theme> {
+  /** Visual style for all child buttons. Default: `'outlined'`. */
+  variant?: ButtonVariant;
+  /** Color palette for all child buttons — resolves against `theme.palette`. Default: 'primary', overridable via `theme.defaults.color`. */
+  color?: ButtonColor;
+  /** Density for all child buttons — resolves against `theme.sizes`. Default: 'md', overridable via `theme.defaults.size`. */
+  size?: ButtonSize;
+  /** Layout flow direction. Default: `'horizontal'`. */
+  orientation?: ButtonGroupOrientation;
+  /** Group corner radius — rounds the group's outer corners only. Resolves against `theme.radii`. Default: 'md', overridable via `theme.defaults.borderRadius`. */
+  borderRadius?: ButtonGroupRadius;
+  /** Disables all child buttons. Default: `false`. */
+  disabled?: boolean;
+  /** Group fills its container; children share the width. Default: `false`. */
+  fullWidth?: boolean;
+  as?: ElementType;
+}
+/**
+ * Groups related `Button` immediate children into a visually joined cluster and
+ * broadcasts `variant` / `color` / `size` / `disabled` / `fullWidth` to them via
+ * `ButtonGroupContext` (explicit props on a child win).
+ */
+declare function ButtonGroup({ variant, color, size, orientation, borderRadius, disabled, fullWidth, as, children, ...rest }: Readonly<ButtonGroupProps>): import("react").JSX.Element;
+//#endregion
+//#region src/ButtonGroup/ButtonGroupContext.d.ts
+/** Group-wide defaults provided by `ButtonGroup` and consumed by `Button` (explicit props win). */
+interface ButtonGroupContextValue {
+  variant?: ButtonVariant;
+  color?: ButtonColor;
+  size?: ButtonSize;
+  disabled?: boolean;
+  fullWidth?: boolean;
+}
+declare const ButtonGroupContext: import("react").Context<ButtonGroupContextValue>;
+//#endregion
+export { ButtonGroupProps as a, ButtonGroupOrientation as i, ButtonGroupContextValue as n, ButtonGroupRadius as o, ButtonGroup as r, ButtonGroupContext as t };

package/dist/index-DASvoACZ.d.cts

@@ -0,0 +1,49 @@
+import { l as index_d_exports, o as Theme } from "./index-Bihpwn75.cjs";
+import { l as PaletteColor, n as ButtonVariants } from "./themes-D81JYbqm.cjs";
+import { ButtonHTMLAttributes, ReactNode } from "react";
+//#region src/Button/Button.d.ts
+/** Augmentable via the `ButtonVariants` interface — style new values through `theme.components.Button.variants`. */
+type ButtonVariant = keyof ButtonVariants;
+type ButtonColor = PaletteColor;
+type ButtonSize = keyof Theme['sizes'];
+type ButtonShape = 'square' | 'rounded' | 'pill';
+type ButtonLoadingPosition = 'start' | 'end' | 'center';
+/** Valid values for the gap prop — resolves against theme.space. */
+type GapToken = keyof Theme['space'];
+interface ButtonProps extends Omit<ButtonHTMLAttributes<HTMLButtonElement>, 'color'>, index_d_exports.SpaceProps<Theme>, index_d_exports.LayoutProps<Theme>, index_d_exports.BorderProps<Theme>, index_d_exports.TypographyProps<Theme> {
+  /** Visual style — filled, stroked, or ghost. Default: `'contained'`, overridable via `theme.defaults.buttonVariant`. */
+  variant?: ButtonVariant;
+  /** Color palette — maps to `theme.palette[color]`. Default: `'primary'`, overridable via `theme.defaults.color`. */
+  color?: ButtonColor;
+  /** Size token — controls padding and font size. Default: `'md'`, overridable via `theme.defaults.size`. */
+  size?: ButtonSize;
+  /** Gap between icon and label — resolves against theme.space. Default: `1` (8px). */
+  gap?: GapToken;
+  /** Icon rendered before the label. */
+  startIcon?: ReactNode;
+  /** Icon rendered after the label. */
+  endIcon?: ReactNode;
+  /** Stretch button to full container width. */
+  fullWidth?: boolean;
+  /** Shows loading indicator and disables the button. */
+  loading?: boolean;
+  /** Custom loading element. Default: animated spinner. */
+  loadingIndicator?: ReactNode;
+  /**
+   * Corner shape — sets the default `borderRadius`.
+   * `"square"` → 0 · `"rounded"` → `theme.radii.md` (default) · `"pill"` → 9999px
+   * The `borderRadius` prop always overrides this.
+   */
+  shape?: ButtonShape;
+  /** Where the loading indicator appears. Default: `"center"`. */
+  loadingPosition?: ButtonLoadingPosition;
+  /** The URL to link to when the button is clicked. If defined, an `a` element will be used as the root node. */
+  href?: string;
+  /** Anchor `target` — only meaningful when `href` is set. */
+  target?: string;
+  /** Anchor `rel` — only meaningful when `href` is set. */
+  rel?: string;
+}
+declare function Button({ variant, color, size, shape, gap, fontWeight, letterSpacing, startIcon, endIcon, fullWidth, loading, loadingIndicator, loadingPosition, children, disabled, href, ...rest }: Readonly<ButtonProps>): import("react").JSX.Element;
+//#endregion
+export { ButtonShape as a, GapToken as c, ButtonProps as i, ButtonColor as n, ButtonSize as o, ButtonLoadingPosition as r, ButtonVariant as s, Button as t };