@mirror-physics/fractal-ui 0.2.0-next.10 → 0.2.0-next.14

package/dist/index.d.cts

@@ -157,6 +157,12 @@ interface ChipProps extends React.HTMLAttributes<HTMLSpanElement> {
 }
 declare const Chip: React.ForwardRefExoticComponent<ChipProps & React.RefAttributes<HTMLSpanElement>>;
 
+interface CheckboxProps extends Omit<React.ButtonHTMLAttributes<HTMLButtonElement>, 'onChange'> {
+    checked: boolean;
+    onCheckedChange: (checked: boolean) => void;
+}
+declare function Checkbox({ checked, onCheckedChange, className, disabled, onClick, onKeyDown, ...props }: CheckboxProps): React.JSX.Element;
+
 type SortDirection = 'asc' | 'desc' | null;
 interface SortableTableColumn<T> {
     key: string;
@@ -167,12 +173,18 @@ interface SortableTableColumn<T> {
     render: (row: T, index: number) => ReactNode;
     align?: 'left' | 'right';
 }
+interface SortableTableRowAction<T> {
+    label: (row: T, index: number) => string;
+    icon: (row: T, index: number) => ReactNode;
+}
 interface SortableTableProps<T> {
     columns: SortableTableColumn<T>[];
     data: T[];
     emptyMessage?: string;
     header?: ReactNode;
     size?: 'sm' | 'md' | 'lg';
+    /** Removes the table's outer border and radius for use inside another framed surface. */
+    embedded?: boolean;
     className?: string;
     defaultSortKey?: string;
     defaultSortDirection?: SortDirection;
@@ -182,8 +194,10 @@ interface SortableTableProps<T> {
     highlightRow?: (row: T, index: number) => boolean;
     /** Invoked when a row is selected. Enables pointer and keyboard row activation. */
     onRowClick?: (row: T, index: number) => void;
+    /** Directional affordance displayed over the right edge of an interactive row. */
+    rowAction?: SortableTableRowAction<T>;
 }
-declare function SortableTable<T>({ columns, data, emptyMessage, header, size, className, defaultSortKey, defaultSortDirection, sortKey: controlledKey, sortDirection: controlledDirection, onSortChange, highlightRow, onRowClick, }: SortableTableProps<T>): React.JSX.Element;
+declare function SortableTable<T>({ columns, data, emptyMessage, header, size, embedded, className, defaultSortKey, defaultSortDirection, sortKey: controlledKey, sortDirection: controlledDirection, onSortChange, highlightRow, onRowClick, rowAction, }: SortableTableProps<T>): React.JSX.Element;
 
 interface TabItem {
     id: string;
@@ -201,6 +215,21 @@ interface TabsProps {
 }
 declare function Tabs({ items, defaultValue, value: controlledValue, onValueChange, className, ariaLabel, }: TabsProps): React.JSX.Element;
 
+interface ContentSwitcherItem {
+    value: string;
+    label: React.ReactNode;
+    disabled?: boolean;
+}
+interface ContentSwitcherProps {
+    items: ContentSwitcherItem[];
+    value: string;
+    onValueChange: (value: string) => void;
+    ariaLabel: string;
+    fullWidth?: boolean;
+    className?: string;
+}
+declare function ContentSwitcher({ items, value, onValueChange, ariaLabel, fullWidth, className }: ContentSwitcherProps): React.JSX.Element;
+
 interface DisclosureProps {
     title: ReactNode;
     meta?: ReactNode;
@@ -208,10 +237,11 @@ interface DisclosureProps {
     defaultOpen?: boolean;
     open?: boolean;
     onOpenChange?: (open: boolean) => void;
+    disabled?: boolean;
     className?: string;
     variant?: 'card' | 'plain';
 }
-declare function Disclosure({ title, meta, children, defaultOpen, open: controlledOpen, onOpenChange, className, variant, }: DisclosureProps): React.JSX.Element;
+declare function Disclosure({ title, meta, children, defaultOpen, open: controlledOpen, onOpenChange, disabled, className, variant, }: DisclosureProps): React.JSX.Element;
 
 interface SidebarProps extends React.HTMLAttributes<HTMLElement> {
     /** Fixed sidebar width. Defaults to the standard application width. */
@@ -240,8 +270,8 @@ interface SidePanelProps {
     description?: React.ReactNode;
     children: React.ReactNode;
     footer?: React.ReactNode;
-    /** Panel width: sm (420px), md (540px), or lg (680px). */
-    size?: 'sm' | 'md' | 'lg';
+    /** Panel width: sm (420px), md (540px), lg (680px), or xl (960px). */
+    size?: 'sm' | 'md' | 'lg' | 'xl';
     className?: string;
 }
 declare function SidePanel({ open, onClose, title, description, children, footer, size, className }: SidePanelProps): React.ReactPortal | null;
@@ -250,6 +280,17 @@ interface TextareaProps extends React.TextareaHTMLAttributes<HTMLTextAreaElement
 }
 declare const Textarea: React.ForwardRefExoticComponent<TextareaProps & React.RefAttributes<HTMLTextAreaElement>>;
 
+type TextButtonSize = 'sm' | 'md';
+type TextButtonIconPosition = 'start' | 'end';
+type TextButtonTone = 'primary' | 'secondary';
+interface TextButtonProps extends React.ButtonHTMLAttributes<HTMLButtonElement> {
+    icon?: React.ReactNode;
+    iconPosition?: TextButtonIconPosition;
+    size?: TextButtonSize;
+    tone?: TextButtonTone;
+}
+declare const TextButton: React.ForwardRefExoticComponent<TextButtonProps & React.RefAttributes<HTMLButtonElement>>;
+
 interface FileDropzoneProps {
     files: File[];
     onFilesChange: (files: File[]) => void;
@@ -262,6 +303,20 @@ interface FileDropzoneProps {
 }
 declare function FileDropzone({ files, onFilesChange, accept, multiple, disabled, title, description, className, }: FileDropzoneProps): React.JSX.Element;
 
+interface PaginationProps {
+    /** One-based active page. */
+    page: number;
+    pageSize: number;
+    totalItems: number;
+    onPageChange: (page: number) => void;
+    /** Optional page sizes, rendered as an unframed selector in the pagination footer. */
+    pageSizeOptions?: number[];
+    onPageSizeChange?: (pageSize: number) => void;
+    ariaLabel?: string;
+    className?: string;
+}
+declare function Pagination({ page, pageSize, totalItems, onPageChange, pageSizeOptions, onPageSizeChange, ariaLabel, className, }: PaginationProps): React.JSX.Element;
+
 /**
  * Register an Escape-key dismiss handler with the global priority stack.
  *
@@ -273,4 +328,4 @@ declare function useEscapeDismiss(priority: number, handler: () => void, enabled
 
 declare function cn(...inputs: ClassValue[]): string;
 
-export { Alert, AlertDescription, AlertTitle, Button, type ButtonColor, type ButtonProps, type ButtonSize, type ButtonType, Card, CardContent, CardDescription, CardFooter, CardHeader, CardTitle, Chip, type ChipProps, type ChipTone, DataTable, type DataTableColumn, type DataTableProps, Disclosure, type DisclosureProps, Dropdown, type DropdownItem, type DropdownProps, FeatureCard, type FeatureCardProps, FileDropzone, type FileDropzoneProps, FolderCard, type FolderCardProps, Input, type InputProps, Label, type LabelProps, Link, type LinkProps, type LinkSize, type LinkTheme, Modal, type ModalProps, PromptCard, type PromptCardProps, type PromptCardTone, PromptGrid, type PromptGridProps, SidePanel, type SidePanelProps, Sidebar, SidebarBrand, SidebarFooter, SidebarHeader, SidebarNav, SidebarNavItem, type SidebarNavItemProps, type SidebarProps, SidebarSection, type SortDirection, SortableTable, type SortableTableColumn, type SortableTableProps, type TabItem, Tabs, type TabsProps, Textarea, type TextareaProps, Toggle, type ToggleProps, cn, useEscapeDismiss };
+export { Alert, AlertDescription, AlertTitle, Button, type ButtonColor, type ButtonProps, type ButtonSize, type ButtonType, Card, CardContent, CardDescription, CardFooter, CardHeader, CardTitle, Checkbox, type CheckboxProps, Chip, type ChipProps, type ChipTone, ContentSwitcher, type ContentSwitcherItem, type ContentSwitcherProps, DataTable, type DataTableColumn, type DataTableProps, Disclosure, type DisclosureProps, Dropdown, type DropdownItem, type DropdownProps, FeatureCard, type FeatureCardProps, FileDropzone, type FileDropzoneProps, FolderCard, type FolderCardProps, Input, type InputProps, Label, type LabelProps, Link, type LinkProps, type LinkSize, type LinkTheme, Modal, type ModalProps, Pagination, type PaginationProps, PromptCard, type PromptCardProps, type PromptCardTone, PromptGrid, type PromptGridProps, SidePanel, type SidePanelProps, Sidebar, SidebarBrand, SidebarFooter, SidebarHeader, SidebarNav, SidebarNavItem, type SidebarNavItemProps, type SidebarProps, SidebarSection, type SortDirection, SortableTable, type SortableTableColumn, type SortableTableProps, type SortableTableRowAction, type TabItem, Tabs, type TabsProps, TextButton, type TextButtonIconPosition, type TextButtonProps, type TextButtonSize, type TextButtonTone, Textarea, type TextareaProps, Toggle, type ToggleProps, cn, useEscapeDismiss };

package/dist/index.d.ts

@@ -157,6 +157,12 @@ interface ChipProps extends React.HTMLAttributes<HTMLSpanElement> {
 }
 declare const Chip: React.ForwardRefExoticComponent<ChipProps & React.RefAttributes<HTMLSpanElement>>;
 
+interface CheckboxProps extends Omit<React.ButtonHTMLAttributes<HTMLButtonElement>, 'onChange'> {
+    checked: boolean;
+    onCheckedChange: (checked: boolean) => void;
+}
+declare function Checkbox({ checked, onCheckedChange, className, disabled, onClick, onKeyDown, ...props }: CheckboxProps): React.JSX.Element;
+
 type SortDirection = 'asc' | 'desc' | null;
 interface SortableTableColumn<T> {
     key: string;
@@ -167,12 +173,18 @@ interface SortableTableColumn<T> {
     render: (row: T, index: number) => ReactNode;
     align?: 'left' | 'right';
 }
+interface SortableTableRowAction<T> {
+    label: (row: T, index: number) => string;
+    icon: (row: T, index: number) => ReactNode;
+}
 interface SortableTableProps<T> {
     columns: SortableTableColumn<T>[];
     data: T[];
     emptyMessage?: string;
     header?: ReactNode;
     size?: 'sm' | 'md' | 'lg';
+    /** Removes the table's outer border and radius for use inside another framed surface. */
+    embedded?: boolean;
     className?: string;
     defaultSortKey?: string;
     defaultSortDirection?: SortDirection;
@@ -182,8 +194,10 @@ interface SortableTableProps<T> {
     highlightRow?: (row: T, index: number) => boolean;
     /** Invoked when a row is selected. Enables pointer and keyboard row activation. */
     onRowClick?: (row: T, index: number) => void;
+    /** Directional affordance displayed over the right edge of an interactive row. */
+    rowAction?: SortableTableRowAction<T>;
 }
-declare function SortableTable<T>({ columns, data, emptyMessage, header, size, className, defaultSortKey, defaultSortDirection, sortKey: controlledKey, sortDirection: controlledDirection, onSortChange, highlightRow, onRowClick, }: SortableTableProps<T>): React.JSX.Element;
+declare function SortableTable<T>({ columns, data, emptyMessage, header, size, embedded, className, defaultSortKey, defaultSortDirection, sortKey: controlledKey, sortDirection: controlledDirection, onSortChange, highlightRow, onRowClick, rowAction, }: SortableTableProps<T>): React.JSX.Element;
 
 interface TabItem {
     id: string;
@@ -201,6 +215,21 @@ interface TabsProps {
 }
 declare function Tabs({ items, defaultValue, value: controlledValue, onValueChange, className, ariaLabel, }: TabsProps): React.JSX.Element;
 
+interface ContentSwitcherItem {
+    value: string;
+    label: React.ReactNode;
+    disabled?: boolean;
+}
+interface ContentSwitcherProps {
+    items: ContentSwitcherItem[];
+    value: string;
+    onValueChange: (value: string) => void;
+    ariaLabel: string;
+    fullWidth?: boolean;
+    className?: string;
+}
+declare function ContentSwitcher({ items, value, onValueChange, ariaLabel, fullWidth, className }: ContentSwitcherProps): React.JSX.Element;
+
 interface DisclosureProps {
     title: ReactNode;
     meta?: ReactNode;
@@ -208,10 +237,11 @@ interface DisclosureProps {
     defaultOpen?: boolean;
     open?: boolean;
     onOpenChange?: (open: boolean) => void;
+    disabled?: boolean;
     className?: string;
     variant?: 'card' | 'plain';
 }
-declare function Disclosure({ title, meta, children, defaultOpen, open: controlledOpen, onOpenChange, className, variant, }: DisclosureProps): React.JSX.Element;
+declare function Disclosure({ title, meta, children, defaultOpen, open: controlledOpen, onOpenChange, disabled, className, variant, }: DisclosureProps): React.JSX.Element;
 
 interface SidebarProps extends React.HTMLAttributes<HTMLElement> {
     /** Fixed sidebar width. Defaults to the standard application width. */
@@ -240,8 +270,8 @@ interface SidePanelProps {
     description?: React.ReactNode;
     children: React.ReactNode;
     footer?: React.ReactNode;
-    /** Panel width: sm (420px), md (540px), or lg (680px). */
-    size?: 'sm' | 'md' | 'lg';
+    /** Panel width: sm (420px), md (540px), lg (680px), or xl (960px). */
+    size?: 'sm' | 'md' | 'lg' | 'xl';
     className?: string;
 }
 declare function SidePanel({ open, onClose, title, description, children, footer, size, className }: SidePanelProps): React.ReactPortal | null;
@@ -250,6 +280,17 @@ interface TextareaProps extends React.TextareaHTMLAttributes<HTMLTextAreaElement
 }
 declare const Textarea: React.ForwardRefExoticComponent<TextareaProps & React.RefAttributes<HTMLTextAreaElement>>;
 
+type TextButtonSize = 'sm' | 'md';
+type TextButtonIconPosition = 'start' | 'end';
+type TextButtonTone = 'primary' | 'secondary';
+interface TextButtonProps extends React.ButtonHTMLAttributes<HTMLButtonElement> {
+    icon?: React.ReactNode;
+    iconPosition?: TextButtonIconPosition;
+    size?: TextButtonSize;
+    tone?: TextButtonTone;
+}
+declare const TextButton: React.ForwardRefExoticComponent<TextButtonProps & React.RefAttributes<HTMLButtonElement>>;
+
 interface FileDropzoneProps {
     files: File[];
     onFilesChange: (files: File[]) => void;
@@ -262,6 +303,20 @@ interface FileDropzoneProps {
 }
 declare function FileDropzone({ files, onFilesChange, accept, multiple, disabled, title, description, className, }: FileDropzoneProps): React.JSX.Element;
 
+interface PaginationProps {
+    /** One-based active page. */
+    page: number;
+    pageSize: number;
+    totalItems: number;
+    onPageChange: (page: number) => void;
+    /** Optional page sizes, rendered as an unframed selector in the pagination footer. */
+    pageSizeOptions?: number[];
+    onPageSizeChange?: (pageSize: number) => void;
+    ariaLabel?: string;
+    className?: string;
+}
+declare function Pagination({ page, pageSize, totalItems, onPageChange, pageSizeOptions, onPageSizeChange, ariaLabel, className, }: PaginationProps): React.JSX.Element;
+
 /**
  * Register an Escape-key dismiss handler with the global priority stack.
  *
@@ -273,4 +328,4 @@ declare function useEscapeDismiss(priority: number, handler: () => void, enabled
 
 declare function cn(...inputs: ClassValue[]): string;
 
-export { Alert, AlertDescription, AlertTitle, Button, type ButtonColor, type ButtonProps, type ButtonSize, type ButtonType, Card, CardContent, CardDescription, CardFooter, CardHeader, CardTitle, Chip, type ChipProps, type ChipTone, DataTable, type DataTableColumn, type DataTableProps, Disclosure, type DisclosureProps, Dropdown, type DropdownItem, type DropdownProps, FeatureCard, type FeatureCardProps, FileDropzone, type FileDropzoneProps, FolderCard, type FolderCardProps, Input, type InputProps, Label, type LabelProps, Link, type LinkProps, type LinkSize, type LinkTheme, Modal, type ModalProps, PromptCard, type PromptCardProps, type PromptCardTone, PromptGrid, type PromptGridProps, SidePanel, type SidePanelProps, Sidebar, SidebarBrand, SidebarFooter, SidebarHeader, SidebarNav, SidebarNavItem, type SidebarNavItemProps, type SidebarProps, SidebarSection, type SortDirection, SortableTable, type SortableTableColumn, type SortableTableProps, type TabItem, Tabs, type TabsProps, Textarea, type TextareaProps, Toggle, type ToggleProps, cn, useEscapeDismiss };
+export { Alert, AlertDescription, AlertTitle, Button, type ButtonColor, type ButtonProps, type ButtonSize, type ButtonType, Card, CardContent, CardDescription, CardFooter, CardHeader, CardTitle, Checkbox, type CheckboxProps, Chip, type ChipProps, type ChipTone, ContentSwitcher, type ContentSwitcherItem, type ContentSwitcherProps, DataTable, type DataTableColumn, type DataTableProps, Disclosure, type DisclosureProps, Dropdown, type DropdownItem, type DropdownProps, FeatureCard, type FeatureCardProps, FileDropzone, type FileDropzoneProps, FolderCard, type FolderCardProps, Input, type InputProps, Label, type LabelProps, Link, type LinkProps, type LinkSize, type LinkTheme, Modal, type ModalProps, Pagination, type PaginationProps, PromptCard, type PromptCardProps, type PromptCardTone, PromptGrid, type PromptGridProps, SidePanel, type SidePanelProps, Sidebar, SidebarBrand, SidebarFooter, SidebarHeader, SidebarNav, SidebarNavItem, type SidebarNavItemProps, type SidebarProps, SidebarSection, type SortDirection, SortableTable, type SortableTableColumn, type SortableTableProps, type SortableTableRowAction, type TabItem, Tabs, type TabsProps, TextButton, type TextButtonIconPosition, type TextButtonProps, type TextButtonSize, type TextButtonTone, Textarea, type TextareaProps, Toggle, type ToggleProps, cn, useEscapeDismiss };