@dragunio/fe-libs 0.1.10 → 0.1.12

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import * as react from 'react';
 import { ButtonHTMLAttributes, ReactNode, HTMLAttributes, MouseEvent, KeyboardEvent, TableHTMLAttributes, InputHTMLAttributes, RefObject, TextareaHTMLAttributes, KeyboardEventHandler, ChangeEvent, ReactElement } from 'react';
-export { ChevronDownIcon, ChevronUpIcon, CloseIcon, EyeIcon, EyeOffIcon, IconProps, MailboxIcon, MoreHorizontalIcon, MoreVerticalIcon, PhoneIcon, 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';
+export { ChevronDownIcon, ChevronUpIcon, CloseIcon, EyeIcon, EyeOffIcon, IconProps, MailboxIcon, MoreHorizontalIcon, MoreVerticalIcon, PhoneIcon, PlusIcon, SearchIcon, arrow_left, check_square_fill, chevron_down, chevron_left, chevron_right, chevron_up, copy, key, lock, lock_unlocked, log_out, minus_square, pin_02, plus, plus_square, search, settings, trash, unpin_02, x_close } from './icons.js';
 
 type ButtonHierarchy = 'primary' | 'secondary-gray' | 'secondary-color' | 'tertiary-gray' | 'tertiary-color';
 type ButtonSize = '24' | '32' | '40';
@@ -126,7 +126,21 @@ declare const Tabs: react.ForwardRefExoticComponent<Omit<HTMLAttributes<HTMLDivE
 type TableData = readonly (readonly ReactNode[])[];
 type ColumnResizeHandler = (columnSizes: number[], columnIndex: number) => void;
 type TablePaginationPosition = 'top-right' | 'bottom-right' | 'bottom-center' | 'middle-bottom';
-type TableProps = TableHTMLAttributes<HTMLTableElement> & {
+type TableColumn = {
+    /** Stable identifier shared by a TableHeader and its TableCell values. */
+    id: string;
+    /** Starting width in pixels when columnWidths does not provide an override. */
+    width?: number;
+    /** Overrides the table-level minimum width for this column. */
+    minWidth?: number;
+    /** Overrides the table-level maximum width for this column. */
+    maxWidth?: number;
+    /** Set false to suppress the resize handle for this column. */
+    resizable?: boolean;
+};
+type TableColumnWidths = Readonly<Record<string, number>>;
+type TableResizeHandler = (columnId: string, width: number, columnWidths: TableColumnWidths) => void;
+type TableProps = Omit<TableHTMLAttributes<HTMLTableElement>, 'onResize'> & {
     /** Enables alternating background colors for body rows. */
     striped?: boolean;
     /** Column labels. Passing headers or data enables the data-driven table API. */
@@ -153,17 +167,41 @@ type TableProps = TableHTMLAttributes<HTMLTableElement> & {
     onPageChange?: (page: number) => void;
     /** Location of the built-in Pagination. Defaults to bottom-right. */
     paginationPosition?: TablePaginationPosition;
+    /**
+     * Ordered columns for the composable Table API. Each TableHeader and
+     * TableCell should receive a matching columnId. This also renders colgroup
+     * widths so frozen columns remain aligned while scrolling.
+     */
+    columns?: readonly TableColumn[];
+    /** Controlled widths for columns from columns, keyed by column id. */
+    columnWidths?: TableColumnWidths;
+    /** IDs to freeze at the leading edge of a horizontal scroll container. */
+    fixedColumnIds?: readonly string[];
+    /** Called whenever a composable table column changes width. */
+    onResize?: TableResizeHandler;
+    /** Called when pointer resizing finishes, or immediately after keyboard resizing. */
+    onResizeEnd?: TableResizeHandler;
+    /** Largest width for composable table columns. Defaults to 1200. */
+    maxColumnWidth?: number;
+};
+type TableHeaderProps = HTMLAttributes<HTMLTableCellElement> & {
+    /** Matches a TableColumn id to enable sizing, resizing and freezing. */
+    columnId?: string;
+};
+type TableCellProps = HTMLAttributes<HTMLTableCellElement> & {
+    /** Matches a TableColumn id to enable frozen-column positioning. */
+    columnId?: string;
 };
 /**
- * A semantic table. Use its child primitives for custom markup, or pass headers
- * and data for an automatically sized, striped and resizable table.
+ * A semantic table. Use its child primitives for custom markup, or pass
+ * headers and data for an automatically sized, striped and resizable table.
  */
-declare function Table({ headers, data, striped, children, pagination, pageSize, page, defaultPage, onPageChange, paginationPosition, ...props }: TableProps): react.JSX.Element;
+declare function Table({ headers, data, ...props }: TableProps): react.JSX.Element;
 declare function TableHead(props: HTMLAttributes<HTMLTableSectionElement>): react.JSX.Element;
 declare function TableBody(props: HTMLAttributes<HTMLTableSectionElement>): react.JSX.Element;
 declare function TableRow({ children, ...props }: HTMLAttributes<HTMLTableRowElement>): react.JSX.Element;
-declare function TableCell({ children, ...props }: HTMLAttributes<HTMLTableCellElement>): react.JSX.Element;
-declare function TableHeader({ children, ...props }: HTMLAttributes<HTMLTableCellElement>): react.JSX.Element;
+declare function TableCell({ children, columnId, className, style, ...props }: TableCellProps): react.JSX.Element;
+declare function TableHeader({ children, columnId, className, style, ...props }: TableHeaderProps): react.JSX.Element;
 declare function TableCaption(props: HTMLAttributes<HTMLTableCaptionElement>): react.JSX.Element;
 
 type ToggleProps = Omit<InputHTMLAttributes<HTMLInputElement>, 'color' | 'type'> & {
@@ -373,7 +411,21 @@ type SelectionProps = Omit<HTMLAttributes<HTMLDivElement>, 'onChange' | 'default
     disabled?: boolean;
     name?: string;
     onKeyDown?: KeyboardEventHandler<HTMLButtonElement>;
+    /**
+     * Caps the field width. Numbers are pixels (`240` → `240px`); strings are
+     * any CSS length (`'16rem'`, `'50%'`). The field still shrinks inside
+     * narrower containers.
+     */
+    maxWidth?: number | string;
+    /**
+     * How a selected label longer than the field is shown:
+     * - `'ellipsis'` (default): one line ending in `…`; the full text appears
+     *   in a tooltip on hover or focus.
+     * - `'wrap'`: the label wraps onto more lines and the field grows taller.
+     */
+    overflow?: SelectionOverflow;
 };
+type SelectionOverflow = 'ellipsis' | 'wrap';
 
 /** A rounded, searchable custom dropdown with single, multiple, and tag modes. */
 declare const Selection: react.ForwardRefExoticComponent<Omit<react.HTMLAttributes<HTMLDivElement>, "value" | "defaultValue" | "onChange" | "onKeyDown"> & {
@@ -397,6 +449,8 @@ declare const Selection: react.ForwardRefExoticComponent<Omit<react.HTMLAttribut
     disabled?: boolean;
     name?: string;
     onKeyDown?: react.KeyboardEventHandler<HTMLButtonElement>;
+    maxWidth?: number | string;
+    overflow?: SelectionOverflow;
 } & react.RefAttributes<HTMLDivElement>>;
 
 declare function formatNumber(value: number, decimals?: number, thousandSeparator?: string, decimalSeparator?: string): string;
@@ -963,4 +1017,4 @@ declare function NotFoundLost(props: NotFoundSceneProps): react.JSX.Element;
 /** A 404 page with a stable random design, or an explicitly selected variant. */
 declare function NotFound({ variant, ...props }: NotFoundProps): react.JSX.Element;
 
-export { Avatar, AvatarGroup, type AvatarGroupProps, type AvatarProps, type AvatarShape, type AvatarSize, Button, ButtonBar, type ButtonBarAction, type ButtonBarItem, 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, type DrawerSide, type DrawerWidth, type DrawerWidthPreset, DrawerWidths, EmailInput, type EmailInputProps, ExpandableSection, type ExpandableSectionProps, FILE_UPLOAD_ACCEPTS, type FieldError, FilePreview, type FilePreviewActionHandler, type FilePreviewCloseReason, type FilePreviewKind, type FilePreviewProps, FileUpload, type FileUploadAccept, type FileUploadFileType, type FileUploadProps, type FileUploadRejection, type FileUploadRejectionCode, type InputValidator, Loading, type LoadingProps, type LoadingSize, Message, type MessageOptions, type MessageProps, type MessageSeverity, Modal, type ModalAction, type ModalProps, type ModalSize, NotFound, NotFoundCaveman, NotFoundLost, type NotFoundProps, type NotFoundSceneProps, type NotFoundVariant, NotFoundYeti, NumberInput, type NumberInputProps, Pagination, type PaginationProps, PasswordInput, type PasswordInputProps, PhoneNumberInput, type PhoneNumberInputProps, 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, type TabChangeEvent, type TabItem, Table, TableBody, TableCaption, TableCell, type TableData, TableHead, TableHeader, type TablePaginationPosition, type TableProps, TableRow, Tabs, type TabsProps, type TabsScrollButtons, type TabsVariant, TextArea, type TextAreaProps, TextInput, type TextInputProps, Toggle, type ToggleProps, Tooltip, type TooltipProps, type ValidatedTextInputProps, type ValidationTiming, formatFileSize, formatNumber, getFilePreviewKind, getIconSize, message, normalizePhoneNumber, validateEmail, validatePassword, validatePhoneNumber };
+export { Avatar, AvatarGroup, type AvatarGroupProps, type AvatarProps, type AvatarShape, type AvatarSize, Button, ButtonBar, type ButtonBarAction, type ButtonBarItem, 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, type DrawerSide, type DrawerWidth, type DrawerWidthPreset, DrawerWidths, EmailInput, type EmailInputProps, ExpandableSection, type ExpandableSectionProps, FILE_UPLOAD_ACCEPTS, type FieldError, FilePreview, type FilePreviewActionHandler, type FilePreviewCloseReason, type FilePreviewKind, type FilePreviewProps, FileUpload, type FileUploadAccept, type FileUploadFileType, type FileUploadProps, type FileUploadRejection, type FileUploadRejectionCode, type InputValidator, Loading, type LoadingProps, type LoadingSize, Message, type MessageOptions, type MessageProps, type MessageSeverity, Modal, type ModalAction, type ModalProps, type ModalSize, NotFound, NotFoundCaveman, NotFoundLost, type NotFoundProps, type NotFoundSceneProps, type NotFoundVariant, NotFoundYeti, NumberInput, type NumberInputProps, Pagination, type PaginationProps, PasswordInput, type PasswordInputProps, PhoneNumberInput, type PhoneNumberInputProps, ProgressBar, type ProgressBarProps, type ProgressBarSize, RadioButton, type RadioButtonProps, RadioGroup, type RadioGroupOption, type RadioGroupProps, type RadioValue, Selection, type SelectionOption, type SelectionOverflow, type SelectionProps, type SelectionValue, Skeleton, SkeletonBox, type SkeletonBoxProps, SkeletonCircle, SkeletonLine, type SkeletonProps, type SkeletonSizeProps, SkeletonSquare, type SkeletonVariant, Snackbar, type SnackbarAnchorOrigin, type SnackbarProps, type TabChangeEvent, type TabItem, Table, TableBody, TableCaption, TableCell, type TableCellProps, type TableColumn, type TableColumnWidths, type TableData, TableHead, TableHeader, type TableHeaderProps, type TablePaginationPosition, type TableProps, type TableResizeHandler, TableRow, Tabs, type TabsProps, type TabsScrollButtons, type TabsVariant, TextArea, type TextAreaProps, TextInput, type TextInputProps, Toggle, type ToggleProps, Tooltip, type TooltipProps, type ValidatedTextInputProps, type ValidationTiming, formatFileSize, formatNumber, getFilePreviewKind, getIconSize, message, normalizePhoneNumber, validateEmail, validatePassword, validatePhoneNumber };