@usefragments/ui 1.0.0

package/src/index.ts

@@ -0,0 +1,728 @@
+// CSS variables and base styles are NOT auto-imported here.
+// Consumers must import styles separately with seed configuration:
+//   @use '@usefragments/ui/styles' with ($fui-brand: ..., $fui-neutral: ...);
+// Bundling globals.scss here would compile with default seeds and
+// override any consumer-configured palette.
+
+// Runtime CSS detection — warns if component styles aren't loaded
+import { checkCssLoaded } from "./utils/css-warning";
+if (typeof window !== "undefined") {
+  checkCssLoaded();
+}
+
+// Core Components
+export { Button, type ButtonProps } from "./components/Button";
+export { Input, type InputProps } from "./components/Input";
+export { Textarea, type TextareaProps } from "./components/Textarea";
+export {
+  Card,
+  CardRoot,
+  CardHeader,
+  CardTitle,
+  CardDescription,
+  CardBody,
+  CardFooter,
+  type CardProps,
+  type CardHeaderProps,
+  type CardTitleProps,
+  type CardDescriptionProps,
+  type CardBodyProps,
+  type CardFooterProps,
+} from "./components/Card";
+export { Switch, type SwitchProps } from "./components/Switch";
+export {
+  Alert,
+  AlertRoot,
+  AlertIcon,
+  AlertBody,
+  AlertTitle,
+  AlertContent,
+  AlertActions,
+  AlertAction,
+  AlertClose,
+  type AlertProps,
+  type AlertSeverity,
+  type AlertIconProps,
+  type AlertBodyProps,
+  type AlertTitleProps,
+  type AlertContentProps,
+  type AlertActionsProps,
+  type AlertActionProps,
+  type AlertCloseProps,
+} from "./components/Alert";
+export { Badge, type BadgeProps } from "./components/Badge";
+export { IconButton, type IconButtonProps } from "./components/IconButton";
+export {
+  ComponentDefaultsProvider,
+  useComponentDefaults,
+  useResolvedControlSize,
+  type ComponentDefaults,
+  type ComponentDefaultsProviderProps,
+  type ControlSize,
+} from "./components/ComponentDefaults";
+export {
+  Avatar,
+  type AvatarProps,
+  type AvatarGroupProps,
+  type AvatarSize,
+} from "./components/Avatar";
+
+// Accordion
+export {
+  Accordion,
+  type AccordionProps,
+  type AccordionItemProps,
+  type AccordionTriggerProps,
+  type AccordionContentProps,
+  type AccordionValue,
+} from "./components/Accordion";
+
+// Collapsible
+export {
+  Collapsible,
+  CollapsibleRoot,
+  CollapsibleTrigger,
+  CollapsibleContent,
+  useCollapsibleContext,
+  type CollapsibleProps,
+  type CollapsibleRootProps,
+  type CollapsibleTriggerProps,
+  type CollapsibleContentProps,
+} from "./components/Collapsible";
+
+// Dialog
+export {
+  Dialog,
+  type DialogProps,
+  type DialogContentProps,
+  type DialogTitleProps,
+  type DialogDescriptionProps,
+  type DialogHeaderProps,
+  type DialogBodyProps,
+  type DialogFooterProps,
+  type DialogTriggerProps,
+  type DialogCloseProps,
+} from "./components/Dialog";
+
+// Tabs
+export {
+  Tabs,
+  type TabsProps,
+  type TabsListProps,
+  type TabProps,
+  type TabsPanelProps,
+  type TabValue,
+} from "./components/Tabs";
+
+// Tooltip
+export {
+  Tooltip,
+  TooltipProvider,
+  type TooltipProps,
+  type TooltipProviderProps,
+  type TooltipSide,
+  type TooltipAlign,
+} from "./components/Tooltip";
+
+// Select
+export {
+  Select,
+  type SelectProps,
+  type SelectTriggerProps,
+  type SelectContentProps,
+  type SelectItemProps,
+  type SelectGroupProps,
+  type SelectGroupLabelProps,
+  type SelectValue,
+  type SelectOption,
+} from "./components/Select";
+
+// Menu
+export {
+  Menu,
+  type MenuProps,
+  type MenuTriggerProps,
+  type MenuContentProps,
+  type MenuItemProps,
+  type MenuCheckboxItemProps,
+  type MenuRadioGroupProps,
+  type MenuRadioItemProps,
+  type MenuGroupProps,
+  type MenuGroupLabelProps,
+  type MenuSeparatorProps,
+} from "./components/Menu";
+
+// Popover
+export {
+  Popover,
+  type PopoverProps,
+  type PopoverTriggerProps,
+  type PopoverContentProps,
+  type PopoverTitleProps,
+  type PopoverDescriptionProps,
+  type PopoverBodyProps,
+  type PopoverFooterProps,
+  type PopoverCloseProps,
+} from "./components/Popover";
+
+// Progress
+export {
+  Progress,
+  CircularProgress,
+  type ProgressProps,
+  type CircularProgressProps,
+} from "./components/Progress";
+
+// Checkbox
+export { Checkbox, type CheckboxProps } from "./components/Checkbox";
+
+// Combobox
+export {
+  Combobox,
+  type ComboboxProps,
+  type ComboboxInputProps,
+  type ComboboxTriggerProps,
+  type ComboboxContentProps,
+  type ComboboxItemProps,
+  type ComboboxEmptyProps,
+  type ComboboxGroupProps,
+  type ComboboxGroupLabelProps,
+} from "./components/Combobox";
+
+// RadioGroup
+export { RadioGroup, type RadioGroupProps, type RadioItemProps } from "./components/RadioGroup";
+
+// Grid
+export {
+  Grid,
+  type GridProps,
+  type GridItemProps,
+  type ResponsiveColumns,
+} from "./components/Grid";
+
+// BentoGrid
+export {
+  BentoGrid,
+  type BentoGridProps,
+  type BentoGridItemProps,
+  type ResponsiveSpan,
+} from "./components/BentoGrid";
+
+// Separator
+export { Separator, type SeparatorProps } from "./components/Separator";
+
+// Skeleton
+export {
+  Skeleton,
+  type SkeletonProps,
+  type SkeletonTextProps,
+  type SkeletonVariant,
+  type SkeletonSize,
+} from "./components/Skeleton";
+
+// Loading
+export {
+  Loading,
+  LoadingRoot,
+  LoadingInline,
+  LoadingScreen,
+  type LoadingProps,
+  type LoadingSize,
+  type LoadingVariant,
+  type LoadingInlineProps,
+  type LoadingScreenProps,
+} from "./components/Loading";
+
+// Table (simple semantic HTML table)
+export {
+  Table,
+  type TableProps,
+  type TableRowProps,
+  type TableCellProps,
+  type TableHeaderCellProps,
+  type TableCaptionProps,
+} from "./components/Table";
+
+// DataTable (TanStack-powered data table)
+export {
+  DataTable,
+  createColumns,
+  type DataTableProps,
+  type DataTableColumn,
+  type ColumnDef,
+  type ColumnAlign,
+  type DataTableDensity,
+  type SortingState,
+  type RowSelectionState,
+  type ExpandedState,
+} from "./components/DataTable";
+
+// DataTable row virtualization (opt-in; requires @tanstack/react-virtual)
+export {
+  DataTableVirtual,
+  useTableVirtualizer,
+  type DataTableVirtualProps,
+  type UseTableVirtualizerOptions,
+  type UseTableVirtualizerResult,
+  type VirtualTableRow,
+} from "./components/DataTable/DataTable.virtual";
+
+// EmptyState
+export {
+  EmptyState,
+  EmptyStateRoot,
+  EmptyStateIcon,
+  EmptyStateTitle,
+  EmptyStateDescription,
+  EmptyStateActions,
+  type EmptyStateProps,
+  type EmptyStateIconProps,
+  type EmptyStateTitleProps,
+  type EmptyStateDescriptionProps,
+  type EmptyStateActionsProps,
+} from "./components/EmptyState";
+
+// Toast
+export {
+  Toast,
+  ToastProvider,
+  useToast,
+  type ToastProps,
+  type ToastProviderProps,
+  type ToastData,
+  type ToastVariant,
+  type ToastPosition,
+} from "./components/Toast";
+
+// Field
+export {
+  Field,
+  type FieldProps,
+  type FieldLabelProps,
+  type FieldControlProps,
+  type FieldDescriptionProps,
+  type FieldErrorProps,
+  type FieldValidityProps,
+} from "./components/Field";
+
+// Fieldset
+export {
+  Fieldset,
+  type FieldsetProps,
+  type FieldsetLegendProps,
+  type FieldsetDescriptionProps,
+} from "./components/Fieldset";
+
+// Form
+export { Form, type FormProps } from "./components/Form";
+
+// Sidebar
+export {
+  Sidebar,
+  SidebarProvider,
+  useSidebar,
+  useSidebarContext, // deprecated, use useSidebar instead
+  type SidebarProviderProps,
+  type SidebarProps,
+  type SidebarHeaderProps,
+  type SidebarNavProps,
+  type SidebarSectionProps,
+  type SidebarSectionActionProps,
+  type SidebarItemProps,
+  type SidebarSubItemProps,
+  type SidebarFooterProps,
+  type SidebarTriggerProps,
+  type SidebarOverlayProps,
+  type SidebarCollapseToggleProps,
+  type SidebarRailProps,
+  type SidebarMenuSkeletonProps,
+  type SidebarCollapsible,
+} from "./components/Sidebar";
+
+// Theme
+export {
+  Theme,
+  ThemeProvider,
+  ThemeToggle,
+  useTheme,
+  configureTheme,
+  type ThemeProviderProps,
+  type ThemeToggleProps,
+  type ThemeMode,
+  type UseThemeReturn,
+  type ConfigureThemeOptions,
+  type NeutralPalette,
+  type DensityPreset,
+  type RadiusStyle,
+} from "./components/Theme";
+
+// Header
+export {
+  Header,
+  type HeaderProps,
+  type HeaderBrandProps,
+  type HeaderNavProps,
+  type HeaderNavItemProps,
+  type HeaderSearchProps,
+  type HeaderActionsProps,
+  type HeaderTriggerProps,
+  type HeaderMobileNavProps,
+} from "./components/Header";
+
+// AppShell
+export {
+  AppShell,
+  type AppShellProps,
+  type AppShellLayout,
+  type AppShellSlotVariant,
+  type AppShellHeaderProps,
+  type AppShellSidebarProps,
+  type AppShellMainProps,
+  type AppShellAsideProps,
+} from "./components/AppShell";
+
+// Stack
+export {
+  Stack,
+  type StackProps,
+  type ResponsiveDirection,
+  type ResponsiveGap,
+} from "./components/Stack";
+
+// Text
+export { Text, type TextProps } from "./components/Text";
+
+// ButtonGroup
+export { ButtonGroup, type ButtonGroupProps } from "./components/ButtonGroup";
+
+// ToggleGroup
+export {
+  ToggleGroup,
+  ToggleGroupRoot,
+  ToggleGroupItem,
+  type ToggleGroupProps,
+  type ToggleGroupItemProps,
+} from "./components/ToggleGroup";
+
+// Slider
+export { Slider, type SliderProps } from "./components/Slider";
+
+// ColorPicker
+export { ColorPicker, type ColorPickerProps } from "./components/ColorPicker";
+
+// DatePicker
+export {
+  DatePicker,
+  DatePickerRoot,
+  DatePickerTrigger,
+  DatePickerContent,
+  DatePickerCalendar,
+  DatePickerPreset,
+  type DatePickerProps,
+  type DatePickerTriggerProps,
+  type DatePickerContentProps,
+  type DatePickerCalendarProps,
+  type DatePickerPresetProps,
+  type DateRange,
+  type Matcher,
+} from "./components/DatePicker";
+
+// Prompt
+export {
+  Prompt,
+  usePromptContext,
+  type PromptProps,
+  type PromptVariant,
+  type PromptTextareaProps,
+  type PromptToolbarProps,
+  type PromptTabsProps,
+  type PromptTabProps,
+  type PromptActionsProps,
+  type PromptInfoProps,
+  type PromptActionButtonProps,
+  type PromptModeButtonProps,
+  type PromptUsageProps,
+  type PromptSubmitProps,
+} from "./components/Prompt";
+
+// CodeBlock
+export {
+  CodeBlock,
+  TabbedCodeBlock,
+  type CodeBlockProps,
+  type CodeBlockLanguage,
+  type CodeBlockTab,
+  type TabbedCodeBlockProps,
+} from "./components/CodeBlock";
+
+// Icon
+export { Icon, type IconProps } from "./components/Icon";
+
+// Image
+export { Image, type ImageProps } from "./components/Image";
+
+// Link
+export { Link, type LinkProps } from "./components/Link";
+
+// List
+export { List, ListRoot, ListItem, type ListProps, type ListItemProps } from "./components/List";
+
+// Listbox (for search results, autocomplete, command menus)
+export {
+  Listbox,
+  ListboxRoot,
+  ListboxItem,
+  ListboxGroup,
+  ListboxEmpty,
+  type ListboxProps,
+  type ListboxItemProps,
+  type ListboxGroupProps,
+  type ListboxEmptyProps,
+} from "./components/Listbox";
+
+// Breadcrumbs
+export {
+  Breadcrumbs,
+  BreadcrumbsRoot,
+  BreadcrumbsItem,
+  BreadcrumbsSeparator,
+  type BreadcrumbsProps,
+  type BreadcrumbsItemProps,
+  type BreadcrumbsSeparatorProps,
+} from "./components/Breadcrumbs";
+
+// TableOfContents
+export {
+  TableOfContents,
+  TableOfContentsRoot,
+  TableOfContentsItem,
+  TableOfContentsGroup,
+  type TableOfContentsProps,
+  type TableOfContentsItemProps,
+  type TableOfContentsGroupProps,
+} from "./components/TableOfContents";
+
+// Box
+export { Box, type BoxProps } from "./components/Box";
+
+// ScrollArea
+export { ScrollArea, type ScrollAreaProps } from "./components/ScrollArea";
+
+// Chip
+export { Chip, type ChipProps, type ChipGroupProps } from "./components/Chip";
+
+// VisuallyHidden
+export { VisuallyHidden, type VisuallyHiddenProps } from "./components/VisuallyHidden";
+
+// Markdown (AI Chat)
+export { Markdown, type MarkdownProps } from "./components/Markdown";
+
+// Message (AI Chat)
+export {
+  Message,
+  MessageRoot,
+  MessageContent,
+  MessageActions,
+  MessageTimestamp,
+  MessageAvatar,
+  useMessageContext,
+  type MessageProps,
+  type MessageRole,
+  type MessageStatus,
+  type MessageContentProps,
+  type MessageActionsProps,
+  type MessageTimestampProps,
+  type MessageAvatarProps,
+} from "./components/Message";
+
+// ConversationList (AI Chat)
+export {
+  ConversationList,
+  ConversationListRoot,
+  DateSeparator,
+  TypingIndicator,
+  useConversationList,
+  type ConversationListProps,
+  type AutoScrollBehavior,
+  type DateSeparatorProps,
+  type TypingIndicatorProps,
+} from "./components/ConversationList";
+
+// ThinkingIndicator (AI Chat)
+export {
+  ThinkingIndicator,
+  ThinkingIndicatorRoot,
+  ThinkingSteps,
+  ThinkingStep,
+  useThinkingIndicatorContext,
+  type ThinkingIndicatorProps,
+  type ThinkingVariant,
+  type ThinkingStep as ThinkingStepType,
+  type StepStatus,
+  type ThinkingStepsProps,
+  type ThinkingStepProps,
+} from "./components/ThinkingIndicator";
+
+// Chart
+export {
+  ChartContainer,
+  ChartTooltip,
+  ChartTooltipContent,
+  ChartLegend,
+  ChartLegendContent,
+  useChartConfig,
+  type ChartConfig,
+  type ChartContainerProps,
+  type ChartTooltipContentProps,
+  type ChartLegendContentProps,
+} from "./components/Chart";
+
+// Assets
+export { FragmentsLogo, fragmentsLogoSvg, type FragmentsLogoProps } from "./assets/fragments-logo";
+
+// NavigationMenu
+export {
+  NavigationMenu,
+  NavigationMenuRoot,
+  NavigationMenuList,
+  NavigationMenuItem,
+  NavigationMenuTrigger,
+  NavigationMenuContent,
+  NavigationMenuLink,
+  NavigationMenuIndicator,
+  NavigationMenuViewport,
+  NavigationMenuMobileContent,
+  NavigationMenuMobileSection,
+  type NavigationMenuProps,
+  type NavigationMenuListProps,
+  type NavigationMenuItemProps,
+  type NavigationMenuTriggerProps,
+  type NavigationMenuContentProps,
+  type NavigationMenuLinkProps,
+  type NavigationMenuIndicatorProps,
+  type NavigationMenuViewportProps,
+  type NavigationMenuMobileContentProps,
+  type NavigationMenuMobileSectionProps,
+} from "./components/NavigationMenu";
+
+// Drawer
+export {
+  Drawer,
+  type DrawerProps,
+  type DrawerContentProps,
+  type DrawerTriggerProps,
+  type DrawerHeaderProps,
+  type DrawerTitleProps,
+  type DrawerDescriptionProps,
+  type DrawerBodyProps,
+  type DrawerFooterProps,
+  type DrawerCloseProps,
+  type DrawerSwipeAreaProps,
+} from "./components/Drawer";
+
+// Pagination
+export {
+  Pagination,
+  type PaginationProps,
+  type PaginationItemProps,
+} from "./components/Pagination";
+
+// Command
+export {
+  Command,
+  type CommandProps,
+  type CommandInputProps,
+  type CommandListProps,
+  type CommandItemProps,
+  type CommandGroupProps,
+  type CommandEmptyProps,
+  type CommandSeparatorProps,
+} from "./components/Command";
+
+// Editor
+export {
+  Editor,
+  EditorRoot,
+  EditorToolbar,
+  EditorToolbarGroup,
+  EditorToolbarButton,
+  EditorSeparator,
+  EditorStatusIndicator,
+  EditorContentArea,
+  EditorStatusBar,
+  useEditorContext,
+  type EditorProps,
+  type EditorFormat,
+  type EditorSaveStatus,
+  type EditorMode,
+  type EditorSize,
+  type EditorToolbarProps,
+  type EditorToolbarGroupProps,
+  type EditorToolbarButtonProps,
+  type EditorSeparatorProps,
+  type EditorStatusIndicatorProps,
+  type EditorContentProps,
+  type EditorStatusBarProps,
+} from "./components/Editor";
+
+// Accessibility Utilities
+export {
+  useId,
+  useAnnounce,
+  usePrefersReducedMotion,
+  usePrefersContrast,
+  useFocusTrap,
+  handleArrowNavigation,
+  VisuallyHidden as A11yVisuallyHidden,
+  type VisuallyHiddenProps as A11yVisuallyHiddenProps,
+} from "./utils/a11y";
+
+// Keyboard Shortcuts
+export {
+  KEYBOARD_SHORTCUTS,
+  matchesShortcut,
+  getShortcutLabel,
+  findConflicts,
+  getShortcuts,
+  isEditableElement,
+  configureShortcuts,
+  getResolvedShortcut,
+  resetShortcutOverrides,
+  useKeyboardShortcut,
+  type KeyboardShortcut,
+  type ShortcutName,
+  type UseKeyboardShortcutOptions,
+} from "./utils/keyboard-shortcuts";
+
+// Seed Derivation
+export {
+  type SeedConfig,
+  PALETTES,
+  RADIUS_STYLES,
+  PALETTE_SEMANTIC_COLORS,
+  DEFAULT_SEEDS,
+  getSemanticColors,
+  deriveText,
+  deriveSurfaces,
+  deriveBorders,
+  deriveShadows,
+  deriveAccentHover,
+  deriveAccentActive,
+  deriveDarkAccent,
+  deriveSemanticText,
+  deriveSemanticBg,
+  deriveSemanticHover,
+} from "./utils/seed-derivation";
+
+// Theme Presets
+export {
+  PRESETS,
+  PRESET_DEFINITIONS,
+  generatePreset,
+  seedsToTheme,
+  type ThemeConfig,
+  type PresetDefinition,
+} from "./utils/theme-presets";
+
+// Legacy aliases (deprecated)
+export { Switch as Toggle, type SwitchProps as ToggleProps } from "./components/Switch";

package/src/scss.d.ts

@@ -0,0 +1,4 @@
+declare module '*.module.scss' {
+  const classes: { [key: string]: string };
+  export default classes;
+}